feat: adds the action template reference object

Signed-off-by: Vincent Biret <vincentbiret@hotmail.com>

Author: baywet

versions/1.2.0-dev.md

@@ -84,7 +84,8 @@ This is the root object of the [Overlay](#overlay).
 | <a name="overlay-version"></a>overlay | `string` | **REQUIRED**. This string MUST be the [version number](#versions) of the Overlay Specification that the Overlay document uses. The `overlay` field SHOULD be used by tooling to interpret the Overlay document. |
 | <a name="overlay-info"></a>info | [Info Object](#info-object) | **REQUIRED**. Provides metadata about the Overlay. The metadata MAY be used by tooling as required. |
 | <a name="overlay-extends"></a>extends | `string` | URI reference that identifies the target document (such as an [[OpenAPI]] document) this overlay applies to. |
-| <a name="overlay-actions"></a>actions | [[Action Object](#action-object)] | **REQUIRED** An ordered list of actions to be applied to the target document. The array MUST contain at least one value. |
+| <a name="overlay-actions"></a>actions | [[Action Object](#action-object) or [Action Template Reference Object](#action-template-reference-object)] | **REQUIRED** An ordered list of actions to be applied to the target document. The array MUST contain at least one value. |
+| <a name="overlay-components"></a>components | [Component Object](#component-object) | A set of components to reuse across the Overlay Document. Optional. |
 
 This object MAY be extended with [Specification Extensions](#specification-extensions).
 
@@ -128,6 +129,18 @@ The metadata MAY be used by the clients if needed.
 
 This object MAY be extended with [Specification Extensions](#specification-extensions).
 
+#### Component Object
+
+The object provides a set of components to be reused across the Overlay document.
+
+##### Fixed Fields
+
+| Field Name | Type | Description |
+| ---- | :----: | ---- |
+| <a name="component-action-templates"></a>actionTemplates | Map(`string`, [Action Template Object](#action-template-object)) | A key-value set of action templates to reference in the actions. Optional. |
+
+This object MAY be extended with [Specification Extensions](#specification-extensions).
+
 #### Action Object
 
 This object represents one or more changes to be applied to the target document at the locations defined by the target JSONPath expression.
@@ -176,10 +189,21 @@ This object MAY be extended with [Specification Extensions](#specification-exten
 
 | Field Name | Type | Description |
 | ---- | :----: | ---- |
-| <a name="action-template-parameter-name"></a>name | `string` | The name of the parameter, MUST match the key for the string literal replacement expression. Required. |
+| <a name="action-template-parameter-name"></a>name | `string` | **REQUIRED** The name of the parameter, MUST match the key for the string literal replacement expression. |
 | <a name="action-template-parameter-default>default | Any | A default value for the parameter to use when no value is provided by the reference. Optional. |
 
 
+This object MAY be extended with [Specification Extensions](#specification-extensions).
+
+#### Action template reference object
+
+##### Fixed fields
+
+| Field Name | Type | Description |
+| ---- | :----: | ---- |
+| <a name="action-template-reference-ref"></a>$ref | `string` | **REQUIRED** A valid reference to an action template in the components section, represented as `#/components/actionTemplates/actionTemplateKey`. |
+| <a name="action-template-parameter-values>parameterValues | `Map(string, Any)` | A set of values to use for the template parameters, the key MUST match the parameter name. Optional. |
+
 This object MAY be extended with [Specification Extensions](#specification-extensions).
 
 ### String literal replacement syntax