@speclynx/apidom-overlay 5.2.7 → 6.0.1

package/dist/apidom-overlay.browser.js

@@ -25,9 +25,12 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var _speclynx_apidom_json_path__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(51680);
 /* harmony import */ var _speclynx_apidom_json_path__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(84637);
 /* harmony import */ var _speclynx_apidom_ns_overlay_1__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(26432);
-/* harmony import */ var _errors_OverlayError_ts__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(18436);
-/* harmony import */ var _validate_ts__WEBPACK_IMPORTED_MODULE_10__ = __webpack_require__(24338);
-/* harmony import */ var _trace_TraceBuilder_ts__WEBPACK_IMPORTED_MODULE_11__ = __webpack_require__(90563);
+/* harmony import */ var _speclynx_apidom_reference__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(29807);
+/* harmony import */ var _errors_OverlayError_ts__WEBPACK_IMPORTED_MODULE_10__ = __webpack_require__(18436);
+/* harmony import */ var _validate_ts__WEBPACK_IMPORTED_MODULE_11__ = __webpack_require__(24338);
+/* harmony import */ var _trace_TraceBuilder_ts__WEBPACK_IMPORTED_MODULE_12__ = __webpack_require__(90563);
+
+
 
 
 
@@ -35,6 +38,9 @@ __webpack_require__.r(__webpack_exports__);
 
 
 
+/**
+ * @public
+ */
 
 /**
  * @public
@@ -72,7 +78,7 @@ const overlayCustomMerge = (_keyElement, options) => {
     const targetIsArray = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__.isArrayElement)(target);
     const sourceIsArray = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__.isArrayElement)(source);
     if (targetIsObject !== sourceIsObject || targetIsArray !== sourceIsArray) {
-      throw new _errors_OverlayError_ts__WEBPACK_IMPORTED_MODULE_9__["default"](`Incompatible types in overlay merge: cannot merge ` + `${targetIsObject ? 'object' : targetIsArray ? 'array' : 'primitive'} with ` + `${sourceIsObject ? 'object' : sourceIsArray ? 'array' : 'primitive'}`);
+      throw new _errors_OverlayError_ts__WEBPACK_IMPORTED_MODULE_10__["default"](`Incompatible types in overlay merge: cannot merge ` + `${targetIsObject ? 'object' : targetIsArray ? 'array' : 'primitive'} with ` + `${sourceIsObject ? 'object' : sourceIsArray ? 'array' : 'primitive'}`);
     }
     return (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(target, source, options);
   };
@@ -98,7 +104,7 @@ const mergeValue = (targetElement, sourceElement, options = defaultApplyOptions)
   if (!targetIsObject && !targetIsArray && !sourceIsObject && !sourceIsArray) {
     return clone ? (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.cloneDeep)(sourceElement) : sourceElement;
   }
-  throw new _errors_OverlayError_ts__WEBPACK_IMPORTED_MODULE_9__["default"](`Incompatible types in overlay merge: cannot merge ` + `${targetIsObject ? 'object' : targetIsArray ? 'array' : 'primitive'} with ` + `${sourceIsObject ? 'object' : sourceIsArray ? 'array' : 'primitive'}`);
+  throw new _errors_OverlayError_ts__WEBPACK_IMPORTED_MODULE_10__["default"](`Incompatible types in overlay merge: cannot merge ` + `${targetIsObject ? 'object' : targetIsArray ? 'array' : 'primitive'} with ` + `${sourceIsObject ? 'object' : sourceIsArray ? 'array' : 'primitive'}`);
 };
 
 /**
@@ -180,10 +186,10 @@ const applyUpdateAction = (normalizedPaths, updateValue, targetElement, options
 const applyCopyAction = (normalizedPaths, copyExpression, targetElement, options = defaultApplyOptions) => {
   const sourceMatches = (0,_speclynx_apidom_json_path__WEBPACK_IMPORTED_MODULE_6__.evaluate)(targetElement, copyExpression);
   if (sourceMatches.length === 0) {
-    throw new _errors_OverlayError_ts__WEBPACK_IMPORTED_MODULE_9__["default"](`Copy source JSONPath "${copyExpression}" selected zero nodes`);
+    throw new _errors_OverlayError_ts__WEBPACK_IMPORTED_MODULE_10__["default"](`Copy source JSONPath "${copyExpression}" selected zero nodes`);
   }
   if (sourceMatches.length > 1) {
-    throw new _errors_OverlayError_ts__WEBPACK_IMPORTED_MODULE_9__["default"](`Copy source JSONPath "${copyExpression}" must select a single node, but selected ${sourceMatches.length}`);
+    throw new _errors_OverlayError_ts__WEBPACK_IMPORTED_MODULE_10__["default"](`Copy source JSONPath "${copyExpression}" must select a single node, but selected ${sourceMatches.length}`);
   }
 
   /**
@@ -207,7 +213,7 @@ const applyRemoveAction = (normalizedPaths, targetElement, options = defaultAppl
   for (const normalizedPath of sorted) {
     const resolved = resolveParent(normalizedPath, result);
     if (resolved === null) {
-      throw new _errors_OverlayError_ts__WEBPACK_IMPORTED_MODULE_9__["default"]('Cannot remove the root node');
+      throw new _errors_OverlayError_ts__WEBPACK_IMPORTED_MODULE_10__["default"]('Cannot remove the root node');
     }
     const {
       parent,
@@ -236,8 +242,8 @@ const applyRemoveAction = (normalizedPaths, targetElement, options = defaultAppl
  */
 const applyAction = (actionElement, targetElement, options = defaultApplyOptions) => {
   const opts = withDefaults(options);
-  const tracer = opts.tracer ?? (opts.trace ? new _trace_TraceBuilder_ts__WEBPACK_IMPORTED_MODULE_11__["default"](opts.trace) : undefined);
-  const actionValidation = (0,_validate_ts__WEBPACK_IMPORTED_MODULE_10__.validateAction)(actionElement);
+  const tracer = opts.tracer ?? (opts.trace ? new _trace_TraceBuilder_ts__WEBPACK_IMPORTED_MODULE_12__["default"](opts.trace) : undefined);
+  const actionValidation = (0,_validate_ts__WEBPACK_IMPORTED_MODULE_11__.validateAction)(actionElement);
   if (!actionValidation.valid) throw actionValidation.error;
   const targetExpression = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(actionElement.target);
   const matches = [];
@@ -250,7 +256,7 @@ const applyAction = (actionElement, targetElement, options = defaultApplyOptions
   });
   if (matches.length === 0) {
     if (opts.strict) {
-      const error = new _errors_OverlayError_ts__WEBPACK_IMPORTED_MODULE_9__["default"](`Action target "${targetExpression}" matched zero nodes (strict mode)`, {
+      const error = new _errors_OverlayError_ts__WEBPACK_IMPORTED_MODULE_10__["default"](`Action target "${targetExpression}" matched zero nodes (strict mode)`, {
         action: actionElement
       });
       tracer?.action({
@@ -294,7 +300,7 @@ const applyAction = (actionElement, targetElement, options = defaultApplyOptions
 
     // update action
     if (actionElement.update !== undefined) {
-      const nodesValidation = (0,_validate_ts__WEBPACK_IMPORTED_MODULE_10__.validateTargetNodes)(matches);
+      const nodesValidation = (0,_validate_ts__WEBPACK_IMPORTED_MODULE_11__.validateTargetNodes)(matches);
       if (!nodesValidation.valid) throw nodesValidation.error;
       const result = applyUpdateAction(normalizedPaths, actionElement.update, workingElement, mutatingOptions);
       tracer?.action({
@@ -308,7 +314,7 @@ const applyAction = (actionElement, targetElement, options = defaultApplyOptions
 
     // copy action
     if (actionElement.copy !== undefined) {
-      const nodesValidation = (0,_validate_ts__WEBPACK_IMPORTED_MODULE_10__.validateTargetNodes)(matches);
+      const nodesValidation = (0,_validate_ts__WEBPACK_IMPORTED_MODULE_11__.validateTargetNodes)(matches);
       if (!nodesValidation.valid) throw nodesValidation.error;
       const copyExpression = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(actionElement.copy);
       const result = applyCopyAction(normalizedPaths, copyExpression, workingElement, mutatingOptions);
@@ -329,7 +335,7 @@ const applyAction = (actionElement, targetElement, options = defaultApplyOptions
     return workingElement;
   } catch (error) {
     // enrich OverlayError with action context, preserving original stack
-    if (error instanceof _errors_OverlayError_ts__WEBPACK_IMPORTED_MODULE_9__["default"] && !error.action) {
+    if (error instanceof _errors_OverlayError_ts__WEBPACK_IMPORTED_MODULE_10__["default"] && !error.action) {
       error.action = actionElement;
     }
     tracer?.action({
@@ -338,7 +344,7 @@ const applyAction = (actionElement, targetElement, options = defaultApplyOptions
       matchCount: matches.length,
       normalizedPaths,
       success: false,
-      error: error instanceof _errors_OverlayError_ts__WEBPACK_IMPORTED_MODULE_9__["default"] ? error : undefined
+      error: error instanceof _errors_OverlayError_ts__WEBPACK_IMPORTED_MODULE_10__["default"] ? error : undefined
     });
     throw error;
   }
@@ -363,12 +369,42 @@ const applyAction = (actionElement, targetElement, options = defaultApplyOptions
  * Under `immutable: false` the caller's parse result is updated in place
  * instead, with its result element replaced by the new tree.
  *
+ * The overlay is dereferenced first (`options.reference` configures
+ * `@speclynx/apidom-reference`), so Reusable Action References are applied as
+ * the Action Objects they resolve to. The overlay itself is never mutated.
+ *
  * @public
  */
-const applyOverlay = (overlayElement, targetElement, options = defaultApplyOptions) => {
+const applyOverlay = async (overlayElement, targetElement, options = defaultApplyOptions) => {
   const overlay = overlayElement instanceof _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__["default"] ? overlayElement.api : overlayElement;
   if (!(0,_speclynx_apidom_ns_overlay_1__WEBPACK_IMPORTED_MODULE_8__.isOverlay1Element)(overlay)) {
-    throw new _errors_OverlayError_ts__WEBPACK_IMPORTED_MODULE_9__["default"]('First argument must be an Overlay 1.x document');
+    throw new _errors_OverlayError_ts__WEBPACK_IMPORTED_MODULE_10__["default"]('First argument must be an Overlay 1.x document');
+  }
+
+  /**
+   * References (Overlay 1.2.0) are resolved by dereferencing before the target is
+   * touched, so an unresolvable reference fails the overlay without applying any action.
+   */
+  let dereferencedOverlay;
+  try {
+    // always immutable: dereferencing must never modify the caller's overlay
+    dereferencedOverlay = await (0,_speclynx_apidom_reference__WEBPACK_IMPORTED_MODULE_9__.dereferenceApiDOM)(overlay, {
+      ...options.reference,
+      dereference: {
+        ...options.reference?.dereference,
+        immutable: true
+      }
+    });
+  } catch (error) {
+    throw new _errors_OverlayError_ts__WEBPACK_IMPORTED_MODULE_10__["default"](error.message, {
+      cause: error
+    });
+  }
+
+  // references left in place (`continueOnError`, `resolve.internal: false`) cannot be applied
+  const unresolvedReference = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__.isArrayElement)(dereferencedOverlay.actions) ? dereferencedOverlay.actions.content.find(_speclynx_apidom_ns_overlay_1__WEBPACK_IMPORTED_MODULE_8__.isReusableActionReferenceElement) : undefined;
+  if ((0,_speclynx_apidom_ns_overlay_1__WEBPACK_IMPORTED_MODULE_8__.isReusableActionReferenceElement)(unresolvedReference)) {
+    throw new _errors_OverlayError_ts__WEBPACK_IMPORTED_MODULE_10__["default"](`Overlay contains unresolved Reusable Action Reference "${(0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(unresolvedReference.$ref)}"`);
   }
   const opts = withDefaults(options);
   let parseResult;
@@ -376,7 +412,7 @@ const applyOverlay = (overlayElement, targetElement, options = defaultApplyOptio
   let target;
   if (targetElement instanceof _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__["default"]) {
     if (targetElement.result === undefined) {
-      throw new _errors_OverlayError_ts__WEBPACK_IMPORTED_MODULE_9__["default"]('Target ParseResultElement contains no result element');
+      throw new _errors_OverlayError_ts__WEBPACK_IMPORTED_MODULE_10__["default"]('Target ParseResultElement contains no result element');
     }
     /**
      * Only the result element changes, so the wrapper is cloned shallowly: the
@@ -397,7 +433,7 @@ const applyOverlay = (overlayElement, targetElement, options = defaultApplyOptio
    * a success verdict into the caller's trace object, which must not survive a
    * throw from the checks above.
    */
-  const tracer = opts.trace ? new _trace_TraceBuilder_ts__WEBPACK_IMPORTED_MODULE_11__["default"](opts.trace) : undefined;
+  const tracer = opts.trace ? new _trace_TraceBuilder_ts__WEBPACK_IMPORTED_MODULE_12__["default"](opts.trace) : undefined;
   const internalOptions = tracer ? {
     ...opts,
     tracer
@@ -407,8 +443,8 @@ const applyOverlay = (overlayElement, targetElement, options = defaultApplyOptio
     ...internalOptions,
     immutable: false
   };
-  if ((0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__.isArrayElement)(overlay.actions)) {
-    for (const action of overlay.actions) {
+  if ((0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__.isArrayElement)(dereferencedOverlay.actions)) {
+    for (const action of dereferencedOverlay.actions) {
       target = applyAction(action, target, mutatingOptions);
     }
   }
@@ -486,7 +522,7 @@ const applyAction = (action, target, options) => (0,_speclynx_apidom_core__WEBPA
  *
  * @public
  */
-const applyOverlay = (overlay, target, options) => (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_1__["default"])((0,_apidom_ts__WEBPACK_IMPORTED_MODULE_3__.applyOverlay)((0,_speclynx_apidom_ns_overlay_1__WEBPACK_IMPORTED_MODULE_2__.refractOverlay1)(overlay), (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__.refract)(target), {
+const applyOverlay = async (overlay, target, options) => (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_1__["default"])(await (0,_apidom_ts__WEBPACK_IMPORTED_MODULE_3__.applyOverlay)((0,_speclynx_apidom_ns_overlay_1__WEBPACK_IMPORTED_MODULE_2__.refractOverlay1)(overlay), (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__.refract)(target), {
   ...options,
   immutable: false
 }));
@@ -513,11 +549,6 @@ __webpack_require__.r(__webpack_exports__);
 
 
 
-
-/**
- * @public
- */
-
 const defaultReferenceOptions = {
   parse: {
     parserOpts: {
@@ -588,7 +619,15 @@ const applyOverlay = async (overlayURI, targetURI, options = defaultOptions) =>
   // apply overlay actions to the target (mutable by default: targetParseResult with result replaced)
   return (0,_apidom_ts__WEBPACK_IMPORTED_MODULE_3__.applyOverlay)(overlayParseResult, targetParseResult, {
     ...options,
-    immutable: options.immutable ?? defaultOptions.immutable
+    immutable: options.immutable ?? defaultOptions.immutable,
+    reference: {
+      ...options.reference,
+      // same normalization `parse` applies, so reference errors report the parsed document's URI
+      resolve: {
+        ...options.reference?.resolve,
+        baseURI: _speclynx_apidom_reference__WEBPACK_IMPORTED_MODULE_2__.url.sanitize(_speclynx_apidom_reference__WEBPACK_IMPORTED_MODULE_2__.url.stripHash(overlayURI))
+      }
+    }
   });
 };
 /* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (applyOverlay);
@@ -678,7 +717,7 @@ __webpack_require__.r(__webpack_exports__);
  */
 
 const defaultDiffOptions = {
-  overlay: '1.1.0',
+  overlay: '1.2.0',
   info: {
     title: 'API diff',
     version: '0.0.0'
@@ -807,7 +846,7 @@ const diffArrays = (left, right, segments, actions) => {
  * Produces an {@link Overlay1Element} that, when applied to `leftElement`, yields `rightElement`.
  *
  * Known limitations:
- * - Identical documents produce an overlay with an empty `actions` array. Overlay 1.1.0 §3
+ * - Identical documents produce an overlay with an empty `actions` array. Overlay 1.x §3
  *   requires `actions` to be non-empty; callers should guard against the no-diff case.
  * - Root-level structural type change (e.g. object root → array root) throws {@link OverlayError}
  *   because Overlay has no mechanism to replace the root node.
@@ -91194,6 +91233,36 @@ class Action extends _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__["de
 /* harmony export */ ]);
 
 
+/***/ },
+
+/***/ 96264
+(__unused_webpack___webpack_module__, __webpack_exports__, __webpack_require__) {
+
+"use strict";
+__webpack_require__.r(__webpack_exports__);
+/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(97071);
+
+/**
+ * @public
+ */
+class Components extends _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__["default"] {
+  constructor(content, meta, attributes) {
+    super(content, meta, attributes);
+    this.element = 'components';
+  }
+  get actions() {
+    return this.get('actions');
+  }
+  set actions(actions) {
+    this.set('actions', actions);
+  }
+}
+/* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (Components);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, [
+/* harmony export */   "default", 0, __WEBPACK_DEFAULT_EXPORT__
+/* harmony export */ ]);
+
+
 /***/ },
 
 /***/ 41012
@@ -91289,6 +91358,12 @@ class Overlay1 extends _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__["
   set overlay(overlay) {
     this.set('overlay', overlay);
   }
+  get $self() {
+    return this.get('$self');
+  }
+  set $self($self) {
+    this.set('$self', $self);
+  }
   get info() {
     return this.get('info');
   }
@@ -91307,6 +91382,12 @@ class Overlay1 extends _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__["
   set actions(actions) {
     this.set('actions', actions);
   }
+  get components() {
+    return this.get('components');
+  }
+  set components(components) {
+    this.set('components', components);
+  }
 }
 /* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (Overlay1);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, [
@@ -91314,6 +91395,85 @@ class Overlay1 extends _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__["
 /* harmony export */ ]);
 
 
+/***/ },
+
+/***/ 93745
+(__unused_webpack___webpack_module__, __webpack_exports__, __webpack_require__) {
+
+"use strict";
+__webpack_require__.r(__webpack_exports__);
+/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(97071);
+
+/**
+ * @public
+ */
+class ReusableAction extends _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__["default"] {
+  constructor(content, meta, attributes) {
+    super(content, meta, attributes);
+    this.element = 'reusableAction';
+  }
+  get description() {
+    return this.get('description');
+  }
+  set description(description) {
+    this.set('description', description);
+  }
+  get fields() {
+    return this.get('fields');
+  }
+  set fields(fields) {
+    this.set('fields', fields);
+  }
+}
+/* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (ReusableAction);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, [
+/* harmony export */   "default", 0, __WEBPACK_DEFAULT_EXPORT__
+/* harmony export */ ]);
+
+
+/***/ },
+
+/***/ 37016
+(__unused_webpack___webpack_module__, __webpack_exports__, __webpack_require__) {
+
+"use strict";
+__webpack_require__.r(__webpack_exports__);
+/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(97071);
+
+
+/**
+ * @public
+ */
+class ReusableActionReference extends _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__["default"] {
+  constructor(content, meta, attributes) {
+    super(content, meta, attributes);
+    this.element = 'reusableActionReference';
+  }
+  get $ref() {
+    return this.get('$ref');
+  }
+  set $ref($ref) {
+    this.set('$ref', $ref);
+  }
+  get target() {
+    return this.get('target');
+  }
+  set target(target) {
+    this.set('target', target);
+  }
+  get description() {
+    return this.get('description');
+  }
+  set description(description) {
+    this.set('description', description);
+  }
+}
+/* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (ReusableActionReference);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, [
+/* harmony export */   "default", 0, __WEBPACK_DEFAULT_EXPORT__
+/* harmony export */ ]);
+
+
 /***/ },
 
 /***/ 39505
@@ -91340,6 +91500,32 @@ class Actions extends _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__["d
 /* harmony export */ ]);
 
 
+/***/ },
+
+/***/ 44405
+(__unused_webpack___webpack_module__, __webpack_exports__, __webpack_require__) {
+
+"use strict";
+__webpack_require__.r(__webpack_exports__);
+/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(97071);
+
+
+/**
+ * @public
+ */
+class ComponentsActions extends _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__["default"] {
+  static primaryClass = 'components-actions';
+  constructor(content, meta, attributes) {
+    super(content, meta, attributes);
+    this.classes.push(ComponentsActions.primaryClass);
+  }
+}
+/* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (ComponentsActions);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, [
+/* harmony export */   "default", 0, __WEBPACK_DEFAULT_EXPORT__
+/* harmony export */ ]);
+
+
 /***/ },
 
 /***/ 13786
@@ -91367,7 +91553,7 @@ class OverlayMediaTypes extends _speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_1
     const effectiveFormat = format === 'generic' ? 'overlay;version' : format;
     return this.filter(mediaType => mediaType.includes(effectiveFormat));
   }
-  findBy(version = '1.1.0', format = 'generic') {
+  findBy(version = '1.2.0', format = 'generic') {
     const search = format === 'generic' ? `vnd.oai.overlay;version=${version}` : `vnd.oai.overlay+${format};version=${version}`;
     const found = this.find(mediaType => mediaType.includes(search));
     return found || this.unknownMediaType;
@@ -91380,7 +91566,7 @@ class OverlayMediaTypes extends _speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_1
 /**
  * @public
  */
-const mediaTypes = new OverlayMediaTypes('application/vnd.oai.overlay;version=1.0.0', 'application/vnd.oai.overlay+json;version=1.0.0', 'application/vnd.oai.overlay+yaml;version=1.0.0', 'application/vnd.oai.overlay;version=1.1.0', 'application/vnd.oai.overlay+json;version=1.1.0', 'application/vnd.oai.overlay+yaml;version=1.1.0');
+const mediaTypes = new OverlayMediaTypes('application/vnd.oai.overlay;version=1.0.0', 'application/vnd.oai.overlay+json;version=1.0.0', 'application/vnd.oai.overlay+yaml;version=1.0.0', 'application/vnd.oai.overlay;version=1.1.0', 'application/vnd.oai.overlay+json;version=1.1.0', 'application/vnd.oai.overlay+yaml;version=1.1.0', 'application/vnd.oai.overlay;version=1.2.0', 'application/vnd.oai.overlay+json;version=1.2.0', 'application/vnd.oai.overlay+yaml;version=1.2.0');
 /* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (mediaTypes);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, [
 /* harmony export */   "default", 0, __WEBPACK_DEFAULT_EXPORT__
@@ -91398,6 +91584,12 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var _elements_Overlay1_mjs__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(68913);
 /* harmony import */ var _elements_Info_mjs__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(41012);
 /* harmony import */ var _elements_Action_mjs__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(19642);
+/* harmony import */ var _elements_Components_mjs__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(96264);
+/* harmony import */ var _elements_ReusableAction_mjs__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(93745);
+/* harmony import */ var _elements_ReusableActionReference_mjs__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(37016);
+
+
+
 
 
 
@@ -91414,6 +91606,9 @@ const overlay1 = {
     base.register('overlay1', _elements_Overlay1_mjs__WEBPACK_IMPORTED_MODULE_1__["default"]);
     base.register('info', _elements_Info_mjs__WEBPACK_IMPORTED_MODULE_2__["default"]);
     base.register('action', _elements_Action_mjs__WEBPACK_IMPORTED_MODULE_3__["default"]);
+    base.register('components', _elements_Components_mjs__WEBPACK_IMPORTED_MODULE_4__["default"]);
+    base.register('reusableAction', _elements_ReusableAction_mjs__WEBPACK_IMPORTED_MODULE_5__["default"]);
+    base.register('reusableActionReference', _elements_ReusableActionReference_mjs__WEBPACK_IMPORTED_MODULE_6__["default"]);
     return base;
   }
 };
@@ -91434,13 +91629,21 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var _elements_Overlay1_mjs__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(68913);
 /* harmony import */ var _elements_Info_mjs__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(41012);
 /* harmony import */ var _elements_Action_mjs__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(19642);
-/* harmony import */ var _elements_nces_Actions_mjs__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(39505);
-// Overlay 1.1.0 elements
+/* harmony import */ var _elements_Components_mjs__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(96264);
+/* harmony import */ var _elements_ReusableAction_mjs__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(93745);
+/* harmony import */ var _elements_ReusableActionReference_mjs__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(37016);
+/* harmony import */ var _elements_nces_Actions_mjs__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(39505);
+/* harmony import */ var _elements_nces_ComponentsActions_mjs__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(44405);
+// Overlay 1.x.y elements
+
+
+
 
 
 
  // NCE types
 
+
 /**
  * @public
  */
@@ -91464,13 +91667,37 @@ const isActionElement = element => element instanceof _elements_Action_mjs__WEBP
 /**
  * @public
  */
-const isActionsElement = element => element instanceof _elements_nces_Actions_mjs__WEBPACK_IMPORTED_MODULE_4__["default"];
+const isActionsElement = element => element instanceof _elements_nces_Actions_mjs__WEBPACK_IMPORTED_MODULE_7__["default"];
+
+/**
+ * @public
+ */
+const isComponentsElement = element => element instanceof _elements_Components_mjs__WEBPACK_IMPORTED_MODULE_4__["default"];
+
+/**
+ * @public
+ */
+const isReusableActionElement = element => element instanceof _elements_ReusableAction_mjs__WEBPACK_IMPORTED_MODULE_5__["default"];
+
+/**
+ * @public
+ */
+const isReusableActionReferenceElement = element => element instanceof _elements_ReusableActionReference_mjs__WEBPACK_IMPORTED_MODULE_6__["default"];
+
+/**
+ * @public
+ */
+const isComponentsActionsElement = element => element instanceof _elements_nces_ComponentsActions_mjs__WEBPACK_IMPORTED_MODULE_8__["default"];
 /* harmony export */ __webpack_require__.d(__webpack_exports__, [
 /* harmony export */   "isActionElement", 0, /* binding */ isActionElement,
 /* harmony export */   "isActionsElement", 0, /* binding */ isActionsElement,
+/* harmony export */   "isComponentsActionsElement", 0, /* binding */ isComponentsActionsElement,
+/* harmony export */   "isComponentsElement", 0, /* binding */ isComponentsElement,
 /* harmony export */   "isInfoElement", 0, /* binding */ isInfoElement,
 /* harmony export */   "isOverlay1Element", 0, /* binding */ isOverlay1Element,
-/* harmony export */   "isOverlayElement", 0, /* binding */ isOverlayElement
+/* harmony export */   "isOverlayElement", 0, /* binding */ isOverlayElement,
+/* harmony export */   "isReusableActionElement", 0, /* binding */ isReusableActionElement,
+/* harmony export */   "isReusableActionReferenceElement", 0, /* binding */ isReusableActionReferenceElement
 /* harmony export */ ]);
 
 
@@ -91568,13 +91795,40 @@ const refractAction = (value, options = {}) => refract(value, {
   ...options,
   element: 'action'
 });
+
+/**
+ * @public
+ */
+const refractComponents = (value, options = {}) => refract(value, {
+  ...options,
+  element: 'components'
+});
+
+/**
+ * @public
+ */
+const refractReusableAction = (value, options = {}) => refract(value, {
+  ...options,
+  element: 'reusableAction'
+});
+
+/**
+ * @public
+ */
+const refractReusableActionReference = (value, options = {}) => refract(value, {
+  ...options,
+  element: 'reusableActionReference'
+});
 /* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (refract);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, [
 /* harmony export */   "default", 0, __WEBPACK_DEFAULT_EXPORT__,
 /* harmony export */   "refractAction", 0, /* binding */ refractAction,
+/* harmony export */   "refractComponents", 0, /* binding */ refractComponents,
 /* harmony export */   "refractInfo", 0, /* binding */ refractInfo,
 /* harmony export */   "refractOverlay", 0, /* binding */ refractOverlay,
-/* harmony export */   "refractOverlay1", 0, /* binding */ refractOverlay1
+/* harmony export */   "refractOverlay1", 0, /* binding */ refractOverlay1,
+/* harmony export */   "refractReusableAction", 0, /* binding */ refractReusableAction,
+/* harmony export */   "refractReusableActionReference", 0, /* binding */ refractReusableActionReference
 /* harmony export */ ]);
 
 
@@ -91587,9 +91841,12 @@ const refractAction = (value, options = {}) => refract(value, {
 __webpack_require__.r(__webpack_exports__);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
 /* harmony export */   ActionElement: () => (/* reexport safe */ _elements_Action_mjs__WEBPACK_IMPORTED_MODULE_5__["default"]),
+/* harmony export */   ComponentsElement: () => (/* reexport safe */ _elements_Components_mjs__WEBPACK_IMPORTED_MODULE_6__["default"]),
 /* harmony export */   InfoElement: () => (/* reexport safe */ _elements_Info_mjs__WEBPACK_IMPORTED_MODULE_4__["default"]),
 /* harmony export */   Overlay1Element: () => (/* reexport safe */ _elements_Overlay1_mjs__WEBPACK_IMPORTED_MODULE_3__["default"]),
-/* harmony export */   OverlayElement: () => (/* reexport safe */ _elements_Overlay_mjs__WEBPACK_IMPORTED_MODULE_2__["default"])
+/* harmony export */   OverlayElement: () => (/* reexport safe */ _elements_Overlay_mjs__WEBPACK_IMPORTED_MODULE_2__["default"]),
+/* harmony export */   ReusableActionElement: () => (/* reexport safe */ _elements_ReusableAction_mjs__WEBPACK_IMPORTED_MODULE_7__["default"]),
+/* harmony export */   ReusableActionReferenceElement: () => (/* reexport safe */ _elements_ReusableActionReference_mjs__WEBPACK_IMPORTED_MODULE_8__["default"])
 /* harmony export */ });
 /* harmony import */ var _speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(60572);
 /* harmony import */ var ramda_adjunct__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(34606);
@@ -91597,7 +91854,13 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var _elements_Overlay1_mjs__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(68913);
 /* harmony import */ var _elements_Info_mjs__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(41012);
 /* harmony import */ var _elements_Action_mjs__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(19642);
-/* harmony import */ var _specification_mjs__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(18730);
+/* harmony import */ var _elements_Components_mjs__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(96264);
+/* harmony import */ var _elements_ReusableAction_mjs__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(93745);
+/* harmony import */ var _elements_ReusableActionReference_mjs__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(37016);
+/* harmony import */ var _specification_mjs__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(18730);
+
+
+
 
 
 
@@ -91608,7 +91871,7 @@ __webpack_require__.r(__webpack_exports__);
 /**
  * @public
  */
-const resolvedSpec = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_0__.resolveSpecification)(_specification_mjs__WEBPACK_IMPORTED_MODULE_6__["default"]);
+const resolvedSpec = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_0__.resolveSpecification)(_specification_mjs__WEBPACK_IMPORTED_MODULE_9__["default"]);
 const getFixedFields = fixedFieldsSpec => {
   return Object.entries(fixedFieldsSpec).map(([name, fieldSpec]) => {
     if ((0,ramda_adjunct__WEBPACK_IMPORTED_MODULE_1__["default"])(fieldSpec)) {
@@ -91635,6 +91898,18 @@ Object.defineProperty(_elements_Action_mjs__WEBPACK_IMPORTED_MODULE_5__["default
   get: () => getFixedFields(resolvedSpec.visitors.document.objects.Action.fixedFields),
   enumerable: true
 });
+Object.defineProperty(_elements_Components_mjs__WEBPACK_IMPORTED_MODULE_6__["default"], 'fixedFields', {
+  get: () => getFixedFields(resolvedSpec.visitors.document.objects.Components.fixedFields),
+  enumerable: true
+});
+Object.defineProperty(_elements_ReusableAction_mjs__WEBPACK_IMPORTED_MODULE_7__["default"], 'fixedFields', {
+  get: () => getFixedFields(resolvedSpec.visitors.document.objects.ReusableAction.fixedFields),
+  enumerable: true
+});
+Object.defineProperty(_elements_ReusableActionReference_mjs__WEBPACK_IMPORTED_MODULE_8__["default"], 'fixedFields', {
+  get: () => getFixedFields(resolvedSpec.visitors.document.objects.ReusableActionReference.fixedFields),
+  enumerable: true
+});
 
 
 /***/ },
@@ -91657,8 +91932,20 @@ __webpack_require__.r(__webpack_exports__);
 const isOverlaySpecificationExtension = element => {
   return (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.isStringElement)(element.key) && (0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])('x-', (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_2__["default"])(element.key));
 };
+
+/**
+ * @public
+ */
+
+/**
+ * @public
+ */
+const isReusableActionReferenceLikeElement = element => {
+  return (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.isObjectElement)(element) && element.hasKey('$ref');
+};
 /* harmony export */ __webpack_require__.d(__webpack_exports__, [
-/* harmony export */   "isOverlaySpecificationExtension", 0, /* binding */ isOverlaySpecificationExtension
+/* harmony export */   "isOverlaySpecificationExtension", 0, /* binding */ isOverlaySpecificationExtension,
+/* harmony export */   "isReusableActionReferenceLikeElement", 0, /* binding */ isReusableActionReferenceLikeElement
 /* harmony export */ ]);
 
 
@@ -91675,8 +91962,18 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var _visitors_overlay_1_info_index_mjs__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(29529);
 /* harmony import */ var _visitors_overlay_1_info_VersionVisitor_mjs__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(1025);
 /* harmony import */ var _visitors_overlay_1_action_index_mjs__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(39999);
-/* harmony import */ var _visitors_SpecificationExtensionVisitor_mjs__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(8023);
-/* harmony import */ var _visitors_FallbackVisitor_mjs__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(89439);
+/* harmony import */ var _visitors_overlay_1_components_index_mjs__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(55757);
+/* harmony import */ var _visitors_overlay_1_components_ActionsVisitor_mjs__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(11002);
+/* harmony import */ var _visitors_overlay_1_reusable_action_index_mjs__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(67911);
+/* harmony import */ var _visitors_overlay_1_reusable_action_reference_index_mjs__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(11011);
+/* harmony import */ var _visitors_overlay_1_reusable_action_reference_$RefVisitor_mjs__WEBPACK_IMPORTED_MODULE_10__ = __webpack_require__(54152);
+/* harmony import */ var _visitors_SpecificationExtensionVisitor_mjs__WEBPACK_IMPORTED_MODULE_11__ = __webpack_require__(8023);
+/* harmony import */ var _visitors_FallbackVisitor_mjs__WEBPACK_IMPORTED_MODULE_12__ = __webpack_require__(89439);
+
+
+
+
+
 
 
 
@@ -91698,7 +91995,7 @@ __webpack_require__.r(__webpack_exports__);
  */
 const specification = {
   visitors: {
-    value: _visitors_FallbackVisitor_mjs__WEBPACK_IMPORTED_MODULE_7__["default"],
+    value: _visitors_FallbackVisitor_mjs__WEBPACK_IMPORTED_MODULE_12__["default"],
     document: {
       objects: {
         Overlay: {
@@ -91709,13 +92006,19 @@ const specification = {
               element: 'overlay',
               $visitor: _visitors_overlay_1_OverlayVisitor_mjs__WEBPACK_IMPORTED_MODULE_1__["default"]
             },
+            $self: {
+              $ref: '#/visitors/value'
+            },
             info: {
               $ref: '#/visitors/document/objects/Info'
             },
             extends: {
               $ref: '#/visitors/value'
             },
-            actions: _visitors_overlay_1_ActionsVisitor_mjs__WEBPACK_IMPORTED_MODULE_2__["default"]
+            actions: _visitors_overlay_1_ActionsVisitor_mjs__WEBPACK_IMPORTED_MODULE_2__["default"],
+            components: {
+              $ref: '#/visitors/document/objects/Components'
+            }
           }
         },
         Info: {
@@ -91752,10 +92055,42 @@ const specification = {
               alias: 'removeField'
             }
           }
+        },
+        Components: {
+          element: 'components',
+          $visitor: _visitors_overlay_1_components_index_mjs__WEBPACK_IMPORTED_MODULE_6__["default"],
+          fixedFields: {
+            actions: _visitors_overlay_1_components_ActionsVisitor_mjs__WEBPACK_IMPORTED_MODULE_7__["default"]
+          }
+        },
+        ReusableAction: {
+          element: 'reusableAction',
+          $visitor: _visitors_overlay_1_reusable_action_index_mjs__WEBPACK_IMPORTED_MODULE_8__["default"],
+          fixedFields: {
+            description: {
+              $ref: '#/visitors/value'
+            },
+            fields: {
+              $ref: '#/visitors/document/objects/Action'
+            }
+          }
+        },
+        ReusableActionReference: {
+          element: 'reusableActionReference',
+          $visitor: _visitors_overlay_1_reusable_action_reference_index_mjs__WEBPACK_IMPORTED_MODULE_9__["default"],
+          fixedFields: {
+            $ref: _visitors_overlay_1_reusable_action_reference_$RefVisitor_mjs__WEBPACK_IMPORTED_MODULE_10__["default"],
+            target: {
+              $ref: '#/visitors/value'
+            },
+            description: {
+              $ref: '#/visitors/value'
+            }
+          }
         }
       },
       extension: {
-        $visitor: _visitors_SpecificationExtensionVisitor_mjs__WEBPACK_IMPORTED_MODULE_6__["default"]
+        $visitor: _visitors_SpecificationExtensionVisitor_mjs__WEBPACK_IMPORTED_MODULE_11__["default"]
       }
     }
   }
@@ -92085,6 +92420,118 @@ class FixedFieldsVisitor extends _SpecificationVisitor_mjs__WEBPACK_IMPORTED_MOD
 /* harmony export */ ]);
 
 
+/***/ },
+
+/***/ 14990
+(__unused_webpack___webpack_module__, __webpack_exports__, __webpack_require__) {
+
+"use strict";
+__webpack_require__.r(__webpack_exports__);
+/* harmony import */ var ramda_adjunct__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(68894);
+/* harmony import */ var _PatternedFieldsVisitor_mjs__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(47578);
+
+
+/**
+ * @public
+ */
+/**
+ * @public
+ */
+class MapVisitor extends _PatternedFieldsVisitor_mjs__WEBPACK_IMPORTED_MODULE_1__["default"] {
+  constructor(options) {
+    super(options);
+    this.fieldPatternPredicate = ramda_adjunct__WEBPACK_IMPORTED_MODULE_0__["default"];
+  }
+}
+/* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (MapVisitor);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, [
+/* harmony export */   "default", 0, __WEBPACK_DEFAULT_EXPORT__
+/* harmony export */ ]);
+
+
+/***/ },
+
+/***/ 47578
+(__unused_webpack___webpack_module__, __webpack_exports__, __webpack_require__) {
+
+"use strict";
+__webpack_require__.r(__webpack_exports__);
+/* harmony import */ var ramda__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(28833);
+/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(12111);
+/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(31770);
+/* harmony import */ var _speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(44673);
+/* harmony import */ var _SpecificationVisitor_mjs__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(75998);
+/* harmony import */ var _predicates_mjs__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(21461);
+
+
+
+
+
+/**
+ * @public
+ */
+/**
+ * @public
+ */
+class PatternedFieldsVisitor extends _SpecificationVisitor_mjs__WEBPACK_IMPORTED_MODULE_4__["default"] {
+  specPath;
+  ignoredFields;
+  fieldPatternPredicate = ramda__WEBPACK_IMPORTED_MODULE_0__["default"];
+  canSupportSpecificationExtensions = false;
+  specificationExtensionPredicate = _predicates_mjs__WEBPACK_IMPORTED_MODULE_5__.isOverlaySpecificationExtension;
+  constructor({
+    specPath,
+    ignoredFields,
+    fieldPatternPredicate,
+    canSupportSpecificationExtensions,
+    specificationExtensionPredicate,
+    ...rest
+  }) {
+    super({
+      ...rest
+    });
+    this.specPath = specPath;
+    this.ignoredFields = ignoredFields || [];
+    if (typeof fieldPatternPredicate === 'function') {
+      this.fieldPatternPredicate = fieldPatternPredicate;
+    }
+    if (typeof canSupportSpecificationExtensions === 'boolean') {
+      this.canSupportSpecificationExtensions = canSupportSpecificationExtensions;
+    }
+    if (typeof specificationExtensionPredicate === 'function') {
+      this.specificationExtensionPredicate = specificationExtensionPredicate;
+    }
+  }
+  ObjectElement(path) {
+    const objectElement = path.node;
+    // @ts-ignore
+    objectElement.forEach((value, key, memberElement) => {
+      if (this.canSupportSpecificationExtensions && this.specificationExtensionPredicate(memberElement)) {
+        const extensionElement = this.toRefractedElement(['document', 'extension'], memberElement);
+        this.element.push(extensionElement);
+      } else if (!this.ignoredFields.includes((0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_3__["default"])(key)) && this.fieldPatternPredicate((0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_3__["default"])(key))) {
+        const specPath = this.specPath(value);
+        const patternedFieldElement = this.toRefractedElement(specPath, value);
+        const newMemberElement = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__["default"](this.consume ? key : (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.cloneDeep)(key), patternedFieldElement);
+        this.copyMetaAndAttributes(memberElement, newMemberElement);
+        newMemberElement.classes.push('patterned-field');
+        this.element.push(newMemberElement);
+        // consume: release processed generic subtree
+        if (this.consume && this.consumeSafe && !memberElement.isFrozen) memberElement.value = undefined;
+      } else if (!this.ignoredFields.includes((0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_3__["default"])(key))) {
+        this.element.push(this.consume ? memberElement : (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.cloneDeep)(memberElement));
+      }
+    });
+    this.copyMetaAndAttributes(objectElement, this.element);
+    path.stop();
+  }
+}
+/* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (PatternedFieldsVisitor);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, [
+/* harmony export */   "default", 0, __WEBPACK_DEFAULT_EXPORT__
+/* harmony export */ ]);
+
+
 /***/ },
 
 /***/ 25049
@@ -92093,7 +92540,9 @@ class FixedFieldsVisitor extends _SpecificationVisitor_mjs__WEBPACK_IMPORTED_MOD
 "use strict";
 __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var _elements_nces_Actions_mjs__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(39505);
-/* harmony import */ var _bases_mjs__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(77554);
+/* harmony import */ var _predicates_mjs__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(21461);
+/* harmony import */ var _bases_mjs__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(77554);
+
 
 
 /**
@@ -92102,7 +92551,7 @@ __webpack_require__.r(__webpack_exports__);
 /**
  * @public
  */
-class ActionsVisitor extends _bases_mjs__WEBPACK_IMPORTED_MODULE_1__.BaseSpecificationFallbackVisitor {
+class ActionsVisitor extends _bases_mjs__WEBPACK_IMPORTED_MODULE_2__.BaseSpecificationFallbackVisitor {
   element;
   constructor(options) {
     super(options);
@@ -92111,7 +92560,7 @@ class ActionsVisitor extends _bases_mjs__WEBPACK_IMPORTED_MODULE_1__.BaseSpecifi
   ArrayElement(path) {
     const arrayElement = path.node;
     arrayElement.forEach(item => {
-      const specPath = ['document', 'objects', 'Action'];
+      const specPath = (0,_predicates_mjs__WEBPACK_IMPORTED_MODULE_1__.isReusableActionReferenceLikeElement)(item) ? ['document', 'objects', 'ReusableActionReference'] : ['document', 'objects', 'Action'];
       const element = this.toRefractedElement(specPath, item);
       this.element.push(element);
     });
@@ -92203,6 +92652,8 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var _SpecificationVisitor_mjs__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(75998);
 /* harmony import */ var _FallbackVisitor_mjs__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(89439);
 /* harmony import */ var _generics_FixedFieldsVisitor_mjs__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(1783);
+/* harmony import */ var _generics_MapVisitor_mjs__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(14990);
+
 
 
 
@@ -92223,15 +92674,91 @@ const BaseSpecificationFallbackVisitor = (0,ts_mixer__WEBPACK_IMPORTED_MODULE_0_
  */
 const BaseFixedFieldsFallbackVisitor = (0,ts_mixer__WEBPACK_IMPORTED_MODULE_0__.Mixin)(_generics_FixedFieldsVisitor_mjs__WEBPACK_IMPORTED_MODULE_3__["default"], _FallbackVisitor_mjs__WEBPACK_IMPORTED_MODULE_2__["default"]);
 
+/**
+ * @public
+ */
+
+/**
+ * Base class for visitors using Mixin(MapVisitor, FallbackVisitor).
+ * @public
+ */
+const BaseMapFallbackVisitor = (0,ts_mixer__WEBPACK_IMPORTED_MODULE_0__.Mixin)(_generics_MapVisitor_mjs__WEBPACK_IMPORTED_MODULE_4__["default"], _FallbackVisitor_mjs__WEBPACK_IMPORTED_MODULE_2__["default"]);
+
 /**
  * @public
  */
 /* harmony export */ __webpack_require__.d(__webpack_exports__, [
 /* harmony export */   "BaseFixedFieldsFallbackVisitor", 0, /* binding */ BaseFixedFieldsFallbackVisitor,
+/* harmony export */   "BaseMapFallbackVisitor", 0, /* binding */ BaseMapFallbackVisitor,
 /* harmony export */   "BaseSpecificationFallbackVisitor", 0, /* binding */ BaseSpecificationFallbackVisitor
 /* harmony export */ ]);
 
 
+/***/ },
+
+/***/ 11002
+(__unused_webpack___webpack_module__, __webpack_exports__, __webpack_require__) {
+
+"use strict";
+__webpack_require__.r(__webpack_exports__);
+/* harmony import */ var ramda__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(29498);
+/* harmony import */ var _elements_nces_ComponentsActions_mjs__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(44405);
+/* harmony import */ var _bases_mjs__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(77554);
+
+
+
+/**
+ * @public
+ */
+/**
+ * @public
+ */
+class ActionsVisitor extends _bases_mjs__WEBPACK_IMPORTED_MODULE_2__.BaseMapFallbackVisitor {
+  constructor(options) {
+    super(options);
+    this.element = new _elements_nces_ComponentsActions_mjs__WEBPACK_IMPORTED_MODULE_1__["default"]();
+    this.specPath = (0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])(['document', 'objects', 'ReusableAction']);
+  }
+}
+/* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (ActionsVisitor);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, [
+/* harmony export */   "default", 0, __WEBPACK_DEFAULT_EXPORT__
+/* harmony export */ ]);
+
+
+/***/ },
+
+/***/ 55757
+(__unused_webpack___webpack_module__, __webpack_exports__, __webpack_require__) {
+
+"use strict";
+__webpack_require__.r(__webpack_exports__);
+/* harmony import */ var ramda__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(29498);
+/* harmony import */ var _elements_Components_mjs__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(96264);
+/* harmony import */ var _bases_mjs__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(77554);
+
+
+
+/**
+ * @public
+ */
+/**
+ * @public
+ */
+class ComponentsVisitor extends _bases_mjs__WEBPACK_IMPORTED_MODULE_2__.BaseFixedFieldsFallbackVisitor {
+  constructor(options) {
+    super(options);
+    this.element = new _elements_Components_mjs__WEBPACK_IMPORTED_MODULE_1__["default"]();
+    this.specPath = (0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])(['document', 'objects', 'Components']);
+    this.canSupportSpecificationExtensions = true;
+  }
+}
+/* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (ComponentsVisitor);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, [
+/* harmony export */   "default", 0, __WEBPACK_DEFAULT_EXPORT__
+/* harmony export */ ]);
+
+
 /***/ },
 
 /***/ 30820
@@ -92332,6 +92859,96 @@ class InfoVisitor extends _bases_mjs__WEBPACK_IMPORTED_MODULE_2__.BaseFixedField
 /* harmony export */ ]);
 
 
+/***/ },
+
+/***/ 54152
+(__unused_webpack___webpack_module__, __webpack_exports__, __webpack_require__) {
+
+"use strict";
+__webpack_require__.r(__webpack_exports__);
+/* harmony import */ var _FallbackVisitor_mjs__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(89439);
+
+/**
+ * @public
+ */
+class $RefVisitor extends _FallbackVisitor_mjs__WEBPACK_IMPORTED_MODULE_0__["default"] {
+  StringElement(path) {
+    super.enter(path);
+    this.element.classes.push('reference-value');
+  }
+}
+/* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = ($RefVisitor);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, [
+/* harmony export */   "default", 0, __WEBPACK_DEFAULT_EXPORT__
+/* harmony export */ ]);
+
+
+/***/ },
+
+/***/ 11011
+(__unused_webpack___webpack_module__, __webpack_exports__, __webpack_require__) {
+
+"use strict";
+__webpack_require__.r(__webpack_exports__);
+/* harmony import */ var ramda__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(29498);
+/* harmony import */ var _elements_ReusableActionReference_mjs__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(37016);
+/* harmony import */ var _bases_mjs__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(77554);
+
+
+
+/**
+ * @public
+ */
+/**
+ * @public
+ */
+class ReusableActionReferenceVisitor extends _bases_mjs__WEBPACK_IMPORTED_MODULE_2__.BaseFixedFieldsFallbackVisitor {
+  constructor(options) {
+    super(options);
+    this.element = new _elements_ReusableActionReference_mjs__WEBPACK_IMPORTED_MODULE_1__["default"]();
+    this.specPath = (0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])(['document', 'objects', 'ReusableActionReference']);
+    this.canSupportSpecificationExtensions = true;
+  }
+}
+/* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (ReusableActionReferenceVisitor);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, [
+/* harmony export */   "default", 0, __WEBPACK_DEFAULT_EXPORT__
+/* harmony export */ ]);
+
+
+/***/ },
+
+/***/ 67911
+(__unused_webpack___webpack_module__, __webpack_exports__, __webpack_require__) {
+
+"use strict";
+__webpack_require__.r(__webpack_exports__);
+/* harmony import */ var ramda__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(29498);
+/* harmony import */ var _elements_ReusableAction_mjs__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(93745);
+/* harmony import */ var _bases_mjs__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(77554);
+
+
+
+/**
+ * @public
+ */
+/**
+ * @public
+ */
+class ReusableActionVisitor extends _bases_mjs__WEBPACK_IMPORTED_MODULE_2__.BaseFixedFieldsFallbackVisitor {
+  constructor(options) {
+    super(options);
+    this.element = new _elements_ReusableAction_mjs__WEBPACK_IMPORTED_MODULE_1__["default"]();
+    this.specPath = (0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])(['document', 'objects', 'ReusableAction']);
+    this.canSupportSpecificationExtensions = true;
+  }
+}
+/* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (ReusableActionVisitor);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, [
+/* harmony export */   "default", 0, __WEBPACK_DEFAULT_EXPORT__
+/* harmony export */ ]);
+
+
 /***/ },
 
 /***/ 6017
@@ -107099,8 +107716,12 @@ async function dereferenceExtends(parseResult, parseResultRetrievalURI, options)
   if (!(0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__.isStringElement)(extendsElement)) {
     return;
   }
+
+  // Overlay 1.2.0: `$self` (itself resolved against the retrieval URI) is the base URI
+  const selfElement = api.get('$self');
+  const baseURI = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__.isStringElement)(selfElement) ? _util_url_mjs__WEBPACK_IMPORTED_MODULE_8__.resolve(file.uri, (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_6__["default"])(selfElement)) : file.uri;
   const extendsURI = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_6__["default"])(extendsElement);
-  const retrievalURI = _util_url_mjs__WEBPACK_IMPORTED_MODULE_8__.sanitize(_util_url_mjs__WEBPACK_IMPORTED_MODULE_8__.stripHash(_util_url_mjs__WEBPACK_IMPORTED_MODULE_8__.resolve(file.uri, extendsURI)));
+  const retrievalURI = _util_url_mjs__WEBPACK_IMPORTED_MODULE_8__.sanitize(_util_url_mjs__WEBPACK_IMPORTED_MODULE_8__.stripHash(_util_url_mjs__WEBPACK_IMPORTED_MODULE_8__.resolve(baseURI, extendsURI)));
   const extendsDereferenceResult = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_4__["default"]();
   extendsDereferenceResult.classes.push('extends');
   extendsDereferenceResult.setMetaProperty('retrievalURI', retrievalURI);
@@ -107156,13 +107777,18 @@ async function dereferenceExtends(parseResult, parseResultRetrievalURI, options)
 "use strict";
 __webpack_require__.r(__webpack_exports__);
 /* empty/unused harmony star reexport */
+/* empty/unused harmony star reexport */
 /* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(12111);
 /* harmony import */ var _speclynx_apidom_ns_overlay_1__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(13786);
 /* harmony import */ var _speclynx_apidom_ns_overlay_1__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(26432);
-/* harmony import */ var _DereferenceStrategy_mjs__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(12993);
-/* harmony import */ var _Reference_mjs__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(82302);
-/* harmony import */ var _ReferenceSet_mjs__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(88526);
-/* harmony import */ var _extends_mjs__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(51826);
+/* harmony import */ var _speclynx_apidom_traverse__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(80796);
+/* harmony import */ var _DereferenceStrategy_mjs__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(12993);
+/* harmony import */ var _Reference_mjs__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(82302);
+/* harmony import */ var _ReferenceSet_mjs__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(88526);
+/* harmony import */ var _extends_mjs__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(51826);
+/* harmony import */ var _visitor_mjs__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(64595);
+
+
 
 
 
@@ -107175,7 +107801,7 @@ __webpack_require__.r(__webpack_exports__);
 /**
  * @public
  */
-class Overlay1DereferenceStrategy extends _DereferenceStrategy_mjs__WEBPACK_IMPORTED_MODULE_3__["default"] {
+class Overlay1DereferenceStrategy extends _DereferenceStrategy_mjs__WEBPACK_IMPORTED_MODULE_4__["default"] {
   constructor(options) {
     super({
       ...(options ?? {}),
@@ -107192,11 +107818,11 @@ class Overlay1DereferenceStrategy extends _DereferenceStrategy_mjs__WEBPACK_IMPO
     return (0,_speclynx_apidom_ns_overlay_1__WEBPACK_IMPORTED_MODULE_2__.isOverlay1Element)(file.parseResult?.result);
   }
   async dereference(file, options) {
-    const immutableRefSet = options.dereference.refSet ?? new _ReferenceSet_mjs__WEBPACK_IMPORTED_MODULE_5__["default"]();
-    const mutableRefSet = new _ReferenceSet_mjs__WEBPACK_IMPORTED_MODULE_5__["default"]();
+    const immutableRefSet = options.dereference.refSet ?? new _ReferenceSet_mjs__WEBPACK_IMPORTED_MODULE_6__["default"]();
+    const mutableRefSet = new _ReferenceSet_mjs__WEBPACK_IMPORTED_MODULE_6__["default"]();
     let reference;
     if (!immutableRefSet.has(file.uri)) {
-      reference = new _Reference_mjs__WEBPACK_IMPORTED_MODULE_4__["default"]({
+      reference = new _Reference_mjs__WEBPACK_IMPORTED_MODULE_5__["default"]({
         uri: file.uri,
         value: file.parseResult
       });
@@ -107211,7 +107837,7 @@ class Overlay1DereferenceStrategy extends _DereferenceStrategy_mjs__WEBPACK_IMPO
      * We don't want to mutate the original refSet and the references.
      */
     if (options.dereference.immutable) {
-      immutableRefSet.refs.map(ref => new _Reference_mjs__WEBPACK_IMPORTED_MODULE_4__["default"]({
+      immutableRefSet.refs.map(ref => new _Reference_mjs__WEBPACK_IMPORTED_MODULE_5__["default"]({
         ...ref,
         value: (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__.cloneDeep)(ref.value)
       })).forEach(ref => mutableRefSet.add(ref));
@@ -107219,19 +107845,31 @@ class Overlay1DereferenceStrategy extends _DereferenceStrategy_mjs__WEBPACK_IMPO
     }
     const dereferencedElement = reference.value;
 
+    /**
+     * Reusable Action References only occur within `actions`, so the root element is never
+     * replaced and traversing it keeps reported locations relative to the document.
+     */
+    const visitor = new _visitor_mjs__WEBPACK_IMPORTED_MODULE_8__["default"]({
+      reference,
+      options
+    });
+    await (0,_speclynx_apidom_traverse__WEBPACK_IMPORTED_MODULE_3__.traverseAsync)(dereferencedElement.result, visitor, {
+      mutable: true
+    });
+
     /**
      * Dereference extends target if option is enabled.
      */
     const shouldDereferenceExtends = options?.dereference?.strategyOpts?.[this.name]?.extends ?? options?.dereference?.strategyOpts?.extends;
     if (shouldDereferenceExtends) {
-      await (0,_extends_mjs__WEBPACK_IMPORTED_MODULE_6__.dereferenceExtends)(dereferencedElement, reference.uri, options);
+      await (0,_extends_mjs__WEBPACK_IMPORTED_MODULE_7__.dereferenceExtends)(dereferencedElement, reference.uri, options);
     }
 
     /**
      * If immutable option is set, replay refs from the refSet.
      */
     if (options.dereference.immutable) {
-      mutableRefSet.refs.filter(ref => ref.uri.startsWith('immutable://')).map(ref => new _Reference_mjs__WEBPACK_IMPORTED_MODULE_4__["default"]({
+      mutableRefSet.refs.filter(ref => ref.uri.startsWith('immutable://')).map(ref => new _Reference_mjs__WEBPACK_IMPORTED_MODULE_5__["default"]({
         ...ref,
         uri: ref.uri.replace(/^immutable:\/\//, '')
       })).forEach(ref => immutableRefSet.add(ref));
@@ -107249,12 +107887,176 @@ class Overlay1DereferenceStrategy extends _DereferenceStrategy_mjs__WEBPACK_IMPO
   }
 }
 
+
 /* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (Overlay1DereferenceStrategy);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, [
 /* harmony export */   "default", 0, __WEBPACK_DEFAULT_EXPORT__
 /* harmony export */ ]);
 
 
+/***/ },
+
+/***/ 64595
+(__unused_webpack___webpack_module__, __webpack_exports__, __webpack_require__) {
+
+"use strict";
+__webpack_require__.r(__webpack_exports__);
+/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(12111);
+/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(18252);
+/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(25810);
+/* harmony import */ var _speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(44673);
+/* harmony import */ var _speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(16280);
+/* harmony import */ var _speclynx_apidom_error__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(44641);
+/* harmony import */ var _speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(12020);
+/* harmony import */ var _speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(61198);
+/* harmony import */ var _speclynx_apidom_ns_overlay_1__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(26432);
+/* harmony import */ var _speclynx_apidom_ns_overlay_1__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(35937);
+/* harmony import */ var _errors_UnresolvableReferenceError_mjs__WEBPACK_IMPORTED_MODULE_10__ = __webpack_require__(34968);
+
+
+
+
+
+
+/**
+ * @public
+ */
+/**
+ * @public
+ */
+class Overlay1DereferenceVisitor {
+  reference;
+  options;
+  constructor({
+    reference,
+    options
+  }) {
+    this.reference = reference;
+    this.options = options;
+  }
+  ReusableActionReferenceElement(path) {
+    const referencingElement = path.node;
+
+    // ignore if resolve.internal is false (Reusable Action References are internal references only)
+    if (!this.options.resolve.internal) {
+      path.skip();
+      return;
+    }
+    const $ref = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_3__["default"])(referencingElement.$ref);
+    const overlayElement = this.reference.value.result;
+    const actionElement = new _speclynx_apidom_ns_overlay_1__WEBPACK_IMPORTED_MODULE_9__.ActionElement();
+    try {
+      if (typeof $ref !== 'string') {
+        throw new _speclynx_apidom_error__WEBPACK_IMPORTED_MODULE_5__["default"]('Reusable Action Reference "$ref" field must be a string');
+      }
+
+      // only `target`, `description` and extensions may accompany `$ref`
+      const disallowedField = ['update', 'copy', 'remove'].find(field => referencingElement.hasKey(field));
+      if (disallowedField !== undefined) {
+        throw new _speclynx_apidom_error__WEBPACK_IMPORTED_MODULE_5__["default"](`Reusable Action Reference "${$ref}" must not define "${disallowedField}"`, {
+          $ref
+        });
+      }
+
+      // same-document reference only; external references are not supported
+      if (!$ref.startsWith('#')) {
+        throw new _speclynx_apidom_error__WEBPACK_IMPORTED_MODULE_5__["default"](`Reusable Action Reference "${$ref}" must be a same-document reference`, {
+          $ref
+        });
+      }
+
+      /**
+       * Only entries of `components.actions` are refracted as Reusable Actions,
+       * so the element type alone proves the pointer leads there.
+       */
+      let reusableAction;
+      try {
+        reusableAction = (0,_speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_6__.evaluate)(overlayElement, _speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_7__.URIFragmentIdentifier.from($ref));
+      } catch {
+        reusableAction = undefined;
+      }
+      if (!(0,_speclynx_apidom_ns_overlay_1__WEBPACK_IMPORTED_MODULE_8__.isReusableActionElement)(reusableAction)) {
+        throw new _speclynx_apidom_error__WEBPACK_IMPORTED_MODULE_5__["default"](`Reusable Action Reference "${$ref}" cannot be resolved`, {
+          $ref
+        });
+      }
+      const {
+        fields
+      } = reusableAction;
+      if (fields !== undefined && !(0,_speclynx_apidom_ns_overlay_1__WEBPACK_IMPORTED_MODULE_8__.isActionElement)(fields)) {
+        throw new _speclynx_apidom_error__WEBPACK_IMPORTED_MODULE_5__["default"](`Reusable Action "${$ref}" must define "fields" as an object`, {
+          $ref
+        });
+      }
+      if ((0,_speclynx_apidom_ns_overlay_1__WEBPACK_IMPORTED_MODULE_8__.isActionElement)(fields) && fields.hasKey('target')) {
+        throw new _speclynx_apidom_error__WEBPACK_IMPORTED_MODULE_5__["default"](`Reusable Action "${$ref}" must not define "target" in its "fields"`, {
+          $ref
+        });
+      }
+
+      // the reference supplies `target` and its `description` takes precedence over the one in `fields`
+      const {
+        target,
+        description
+      } = referencingElement;
+      if (target !== undefined) {
+        actionElement.set('target', (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__.cloneDeep)(target));
+      }
+      if ((0,_speclynx_apidom_ns_overlay_1__WEBPACK_IMPORTED_MODULE_8__.isActionElement)(fields)) {
+        fields.forEach((value, keyElement) => {
+          actionElement.set((0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_3__["default"])(keyElement), (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__.cloneDeep)(value));
+        });
+      }
+      if (description !== undefined) {
+        actionElement.set('description', (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__.cloneDeep)(description));
+      }
+    } catch (error) {
+      const {
+        continueOnError
+      } = this.options.dereference;
+      const unresolvedError = new _errors_UnresolvableReferenceError_mjs__WEBPACK_IMPORTED_MODULE_10__["default"](`Error while dereferencing Reusable Action Reference "${$ref}": ${error.message}`, {
+        cause: error,
+        type: referencingElement.element,
+        uri: this.reference.uri,
+        location: path.formatPath(),
+        codeFrame: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(referencingElement),
+        refFieldName: '$ref',
+        refFieldValue: $ref,
+        trace: []
+      });
+      if (continueOnError === false) throw unresolvedError;
+      if (typeof continueOnError === 'function') continueOnError(unresolvedError);
+      path.skip();
+      return;
+    }
+
+    // the action takes the place of the reference in `actions`, so it inherits its source position
+    if ((0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.hasElementSourceMap)(referencingElement)) {
+      _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__["default"].transfer(referencingElement, actionElement);
+    }
+
+    // annotate with info about original referencing element
+    actionElement.meta.set('ref-fields', {
+      $ref,
+      description: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_3__["default"])(referencingElement.description)
+    });
+    // annotate with info about origin
+    actionElement.meta.set('ref-origin', this.reference.uri);
+    actionElement.meta.set('ref-type', referencingElement.element);
+
+    /**
+     * Transclude referencing element with resolved Action Object.
+     */
+    path.replaceWith(actionElement);
+    path.skip();
+  }
+}
+/* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (Overlay1DereferenceVisitor);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, [
+/* harmony export */   "default", 0, __WEBPACK_DEFAULT_EXPORT__
+/* harmony export */ ]);
+
+
 /***/ },
 
 /***/ 14520
@@ -109584,8 +110386,12 @@ async function parseExtends(parseResult, parseResultRetrievalURI, options) {
   if (!(0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__.isStringElement)(extendsElement)) {
     return;
   }
+
+  // Overlay 1.2.0: `$self` (itself resolved against the retrieval URI) is the base URI
+  const selfElement = api.get('$self');
+  const baseURI = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__.isStringElement)(selfElement) ? _util_url_mjs__WEBPACK_IMPORTED_MODULE_6__.resolve(file.uri, (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(selfElement)) : file.uri;
   const extendsURI = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(extendsElement);
-  const retrievalURI = _util_url_mjs__WEBPACK_IMPORTED_MODULE_6__.sanitize(_util_url_mjs__WEBPACK_IMPORTED_MODULE_6__.stripHash(_util_url_mjs__WEBPACK_IMPORTED_MODULE_6__.resolve(file.uri, extendsURI)));
+  const retrievalURI = _util_url_mjs__WEBPACK_IMPORTED_MODULE_6__.sanitize(_util_url_mjs__WEBPACK_IMPORTED_MODULE_6__.stripHash(_util_url_mjs__WEBPACK_IMPORTED_MODULE_6__.resolve(baseURI, extendsURI)));
   const extendsParseResult = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__["default"]();
   extendsParseResult.classes.push('extends');
   extendsParseResult.setMetaProperty('retrievalURI', retrievalURI);
@@ -111015,13 +111821,14 @@ const cwd = () => {
 const resolve = (from, to) => {
   const resolvedUrl = new URL(to, new URL(from, 'resolve://'));
   if (resolvedUrl.protocol === 'resolve:') {
-    // `from` is a relative URL.
+    // `from` is a relative URL; a network-path reference (`//host/path`) keeps its authority
     const {
+      host,
       pathname,
       search,
       hash
     } = resolvedUrl;
-    return pathname + search + hash;
+    return (host ? `//${host}` : '') + pathname + search + hash;
   }
   return resolvedUrl.toString();
 };