@speclynx/apidom-ns-openapi-3-1 2.13.1 → 3.0.0

package/dist/apidom-ns-openapi-3-1.browser.js

@@ -1353,7 +1353,8 @@ __webpack_require__.r(__webpack_exports__);
 const refract = (value, {
   element = 'openApi3_1',
   plugins = [],
-  specificationObj = _specification_ts__WEBPACK_IMPORTED_MODULE_5__["default"]
+  specificationObj = _specification_ts__WEBPACK_IMPORTED_MODULE_5__["default"],
+  consume = false
 } = {}) => {
   const genericElement = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__.refract)(value);
   const resolvedSpec = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_1__.resolveSpecification)(specificationObj);
@@ -1370,7 +1371,8 @@ const refract = (value, {
    */
   const RootVisitorClass = (0,ramda__WEBPACK_IMPORTED_MODULE_4__["default"])(specPath, resolvedSpec);
   const rootVisitor = new RootVisitorClass({
-    specObj: resolvedSpec
+    specObj: resolvedSpec,
+    consume
   });
   (0,_speclynx_apidom_traverse__WEBPACK_IMPORTED_MODULE_3__.traverse)(genericElement, rootVisitor, {
     nodeTypeGetter: _speclynx_apidom_traverse__WEBPACK_IMPORTED_MODULE_3__.getNodePrimitiveType
@@ -1929,7 +1931,7 @@ const plugin = ({
             if (typeof linkElement.operationId === 'undefined') return;
             const linkOperationId = String((0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(linkElement.operationId));
             const operationElement = normalizedOperations.find(normalizedOperationElement => {
-              const originalOperationId = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(normalizedOperationElement.meta.get('originalOperationId'));
+              const originalOperationId = normalizedOperationElement.meta.get('originalOperationId');
               return originalOperationId === linkOperationId;
             });
 
@@ -1950,7 +1952,7 @@ const plugin = ({
         enter(path) {
           const pathItemElement = path.node;
           // `path` meta may not be always available, e.g. in Callback Object or Components Object
-          const pathTemplate = (0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])('path', (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(pathItemElement.meta.get('path')));
+          const pathTemplate = (0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])('path', pathItemElement.meta.get('path'));
           pathTemplates.push(pathTemplate);
         },
         leave() {
@@ -1976,7 +1978,7 @@ const plugin = ({
           // perform operationId normalization
           const pathTemplate = (0,ramda__WEBPACK_IMPORTED_MODULE_2__["default"])(pathTemplates);
           // `http-method` meta may not be always available, e.g. in Callback Object or Components Object
-          const method = (0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])('method', (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(operationElement.meta.get('http-method')));
+          const method = (0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])('method', operationElement.meta.get('http-method'));
           const normalizedOperationId = operationIdNormalizer(originalOperationId, pathTemplate, method);
 
           // normalization is not necessary
@@ -2471,8 +2473,8 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */ });
 /* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(25162);
 /* 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__(18252);
-/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(97601);
+/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(97601);
+/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(18252);
 /* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(97071);
 /* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(25810);
 /* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(49686);
@@ -2658,7 +2660,7 @@ const schema = {
   },
   ServerVariableElement: {
     enum(...args) {
-      return new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__["default"](...args);
+      return new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__["default"](...args);
     }
   },
   PathsElement: {
@@ -2827,7 +2829,7 @@ const schema = {
   },
   SecurityRequirementElement: {
     '[key: *]': function key(...args) {
-      return new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__["default"](...args);
+      return new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__["default"](...args);
     }
   },
   TagElement: {
@@ -2847,17 +2849,17 @@ const schema = {
       return element;
     },
     allOf(...args) {
-      const element = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__["default"](...args);
+      const element = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__["default"](...args);
       element.classes.push('json-schema-allOf');
       return element;
     },
     anyOf(...args) {
-      const element = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__["default"](...args);
+      const element = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__["default"](...args);
       element.classes.push('json-schema-anyOf');
       return element;
     },
     oneOf(...args) {
-      const element = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__["default"](...args);
+      const element = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__["default"](...args);
       element.classes.push('json-schema-oneOf');
       return element;
     },
@@ -2879,7 +2881,7 @@ const schema = {
       return element;
     },
     prefixItems(...args) {
-      const element = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__["default"](...args);
+      const element = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__["default"](...args);
       element.classes.push('json-schema-prefixItems');
       return element;
     },
@@ -2912,17 +2914,17 @@ const schema = {
       return new _elements_Schema_ts__WEBPACK_IMPORTED_MODULE_50__["default"](...args);
     },
     type(...args) {
-      const element = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__["default"](...args);
+      const element = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__["default"](...args);
       element.classes.push('json-schema-type');
       return element;
     },
     enum(...args) {
-      const element = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__["default"](...args);
+      const element = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__["default"](...args);
       element.classes.push('json-schema-enum');
       return element;
     },
     required(...args) {
-      const element = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__["default"](...args);
+      const element = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__["default"](...args);
       element.classes.push('json-schema-required');
       return element;
     },
@@ -2932,7 +2934,7 @@ const schema = {
       return element;
     },
     examples(...args) {
-      const element = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__["default"](...args);
+      const element = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__["default"](...args);
       element.classes.push('json-schema-examples');
       return element;
     },
@@ -3165,7 +3167,8 @@ const schema = {
 };
 const findElementFactory = (ancestor, keyName) => {
   const elementType = (0,_speclynx_apidom_traverse__WEBPACK_IMPORTED_MODULE_8__.getNodeType)(ancestor);
-  const keyMapping = schema[elementType] || schema[(0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(ancestor.classes.first)];
+  const classType = ancestor.isMetaEmpty ? undefined : ancestor.classes.at(0);
+  const keyMapping = schema[elementType] || schema[classType];
   return typeof keyMapping === 'undefined' ? undefined : Object.hasOwn(keyMapping, '[key: *]') ? keyMapping['[key: *]'] : keyMapping[keyName];
 };
 
@@ -3173,7 +3176,7 @@ const findElementFactory = (ancestor, keyName) => {
  * @public
  */
 const plugin = () => () => {
-  const isEmptyElement = element => (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__.isStringElement)(element) && (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__.includesClasses)(element, ['yaml-e-node', 'yaml-e-scalar']);
+  const isEmptyElement = element => (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__.isStringElement)(element) && (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__.includesClasses)(element, ['yaml-e-node', 'yaml-e-scalar']);
   return {
     visitor: {
       StringElement(path) {
@@ -3195,7 +3198,7 @@ const plugin = () => () => {
         if (typeof elementFactory !== 'function') return;
         const newElement = elementFactory.call({
           context
-        }, undefined, (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.cloneDeep)(element.meta), (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.cloneDeep)(element.attributes));
+        }, undefined, element.isMetaEmpty ? undefined : element.meta.cloneDeep(), element.isAttributesEmpty ? undefined : (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.cloneDeep)(element.attributes));
         _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_5__["default"].transfer(element, newElement);
         _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_6__["default"].transfer(element, newElement);
         path.replaceWith(newElement);
@@ -4435,9 +4438,13 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   "default": () => (__WEBPACK_DEFAULT_EXPORT__)
 /* harmony export */ });
 /* harmony import */ var ramda__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(29498);
-/* harmony import */ var _speclynx_apidom_ns_openapi_3_0__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(58368);
-/* harmony import */ var _elements_OpenApi3_1_ts__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(75474);
-/* harmony import */ var _bases_ts__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(55996);
+/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(25162);
+/* harmony import */ var _speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(44673);
+/* harmony import */ var _speclynx_apidom_ns_openapi_3_0__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(58368);
+/* harmony import */ var _elements_OpenApi3_1_ts__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(75474);
+/* harmony import */ var _bases_ts__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(55996);
+
+
 
 
 
@@ -4451,18 +4458,25 @@ __webpack_require__.r(__webpack_exports__);
  * @public
  */
 
-class OpenApi3_1Visitor extends _bases_ts__WEBPACK_IMPORTED_MODULE_3__.BaseFixedFieldsVisitor {
+class OpenApi3_1Visitor extends _bases_ts__WEBPACK_IMPORTED_MODULE_5__.BaseFixedFieldsVisitor {
   constructor(options) {
     super(options);
-    this.element = new _elements_OpenApi3_1_ts__WEBPACK_IMPORTED_MODULE_2__["default"]();
+    this.element = new _elements_OpenApi3_1_ts__WEBPACK_IMPORTED_MODULE_4__["default"]();
     this.specPath = (0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])(['document', 'objects', 'OpenApi']);
     this.canSupportSpecificationExtensions = true;
+    this.consumeSafe = true;
     this.openApiSemanticElement = this.element;
   }
   ObjectElement(path) {
     const objectElement = path.node;
     this.openApiGenericElement = objectElement;
-    _speclynx_apidom_ns_openapi_3_0__WEBPACK_IMPORTED_MODULE_1__["default"].prototype.ObjectElement.call(this, path);
+    // precompute values from generic root before consume may release fields
+    if ((0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.isStringElement)(objectElement.get('jsonSchemaDialect'))) {
+      this.sourceContext = {
+        jsonSchemaDialect: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_2__["default"])(objectElement.get('jsonSchemaDialect'))
+      };
+    }
+    _speclynx_apidom_ns_openapi_3_0__WEBPACK_IMPORTED_MODULE_3__["default"].prototype.ObjectElement.call(this, path);
   }
 }
 /* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (OpenApi3_1Visitor);
@@ -5143,8 +5157,8 @@ class SchemaVisitor extends _bases_ts__WEBPACK_IMPORTED_MODULE_8__.BaseSchemaVis
     (0,_predicates_ts__WEBPACK_IMPORTED_MODULE_5__.isJsonSchemaDialectElement)(this.openApiSemanticElement.jsonSchemaDialect)) {
       // @ts-ignore
       jsonSchemaDialect = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_2__["default"])(this.openApiSemanticElement.jsonSchemaDialect);
-    } else if (this.openApiGenericElement !== undefined && (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.isStringElement)(this.openApiGenericElement.get('jsonSchemaDialect'))) {
-      jsonSchemaDialect = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_2__["default"])(this.openApiGenericElement.get('jsonSchemaDialect'));
+    } else if (this.sourceContext?.jsonSchemaDialect !== undefined) {
+      jsonSchemaDialect = this.sourceContext.jsonSchemaDialect;
     } else {
       jsonSchemaDialect = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_2__["default"])(this.jsonSchemaDefaultDialect);
     }
@@ -21622,7 +21636,7 @@ __webpack_require__.r(__webpack_exports__);
  * @public
  */
 const emptyElement = element => {
-  const meta = !element.isMetaEmpty ? (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.cloneDeep)(element.meta) : undefined;
+  const meta = !element.isMetaEmpty ? element.meta.cloneDeep() : undefined;
   const attributes = !element.isAttributesEmpty ? (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.cloneDeep)(element.attributes) : undefined;
 
   // @ts-ignore
@@ -21638,7 +21652,7 @@ const getMergeFunction = (keyElement, options) => {
 };
 const getMetaMergeFunction = options => {
   if (typeof options.customMetaMerge !== 'function') {
-    return targetMeta => (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.cloneDeep)(targetMeta);
+    return targetMeta => targetMeta.cloneDeep();
   }
   return options.customMetaMerge;
 };
@@ -21710,8 +21724,20 @@ const deepmerge = (targetElement, sourceElement, options) => {
   const mergedElement = sourceIsArrayElement && typeof mergedOptions.arrayElementMerge === 'function' ? mergedOptions.arrayElementMerge(targetElement, sourceElement, mergedOptions) : mergedOptions.objectElementMerge(targetElement, sourceElement, mergedOptions);
 
   // merging meta & attributes
-  mergedElement.meta = getMetaMergeFunction(mergedOptions)(targetElement.meta, sourceElement.meta);
-  mergedElement.attributes = getAttributesMergeFunction(mergedOptions)(targetElement.attributes, sourceElement.attributes);
+  if (!targetElement.isMetaEmpty && !sourceElement.isMetaEmpty) {
+    mergedElement.meta = getMetaMergeFunction(mergedOptions)(targetElement.meta, sourceElement.meta);
+  } else if (!targetElement.isMetaEmpty) {
+    mergedElement.meta = targetElement.meta.cloneDeep();
+  } else if (!sourceElement.isMetaEmpty) {
+    mergedElement.meta = sourceElement.meta.cloneDeep();
+  }
+  if (!targetElement.isAttributesEmpty && !sourceElement.isAttributesEmpty) {
+    mergedElement.attributes = getAttributesMergeFunction(mergedOptions)(targetElement.attributes, sourceElement.attributes);
+  } else if (!targetElement.isAttributesEmpty) {
+    mergedElement.attributes = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.cloneDeep)(targetElement.attributes);
+  } else if (!sourceElement.isAttributesEmpty) {
+    mergedElement.attributes = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.cloneDeep)(sourceElement.attributes);
+  }
   return mergedElement;
 };
 deepmerge.all = (list, options) => {
@@ -22044,6 +22070,104 @@ class KeyValuePair {
 
 /***/ },
 
+/***/ 51844
+(__unused_webpack___webpack_module__, __webpack_exports__, __webpack_require__) {
+
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   "default": () => (__WEBPACK_DEFAULT_EXPORT__)
+/* harmony export */ });
+/* harmony import */ var ramda__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(8138);
+
+/**
+ * Lightweight meta container for Element metadata.
+ *
+ * Data is stored as own properties on the instance; methods live on the prototype.
+ * `Object.keys()`, `Object.entries()`, etc. only see data properties.
+ *
+ * @public
+ */
+class Metadata {
+  // Set via prototype assignment in registration.ts to avoid circular dependency
+
+  get(name) {
+    return this[name];
+  }
+  set(name, value) {
+    this[name] = value;
+  }
+  hasKey(name) {
+    return Object.hasOwn(this, name);
+  }
+  keys() {
+    return Object.keys(this);
+  }
+  remove(name) {
+    delete this[name];
+  }
+  get isEmpty() {
+    return Object.keys(this).length === 0;
+  }
+  get isFrozen() {
+    return Object.isFrozen(this);
+  }
+  freeze() {
+    for (const value of Object.values(this)) {
+      if (value instanceof this.Element) {
+        value.freeze();
+      } else if (Array.isArray(value) || value !== null && typeof value === 'object') {
+        Object.freeze(value);
+      }
+    }
+    Object.freeze(this);
+  }
+
+  /**
+   * Creates a shallow clone. Same references, new container.
+   */
+  cloneShallow() {
+    const clone = new Metadata();
+    Object.assign(clone, this);
+    return clone;
+  }
+
+  /**
+   * Merges another Metadata into a new instance.
+   * Arrays are concatenated, all other values are overwritten by source.
+   */
+  merge(source) {
+    const result = this.cloneShallow();
+    for (const [key, value] of Object.entries(source)) {
+      const existing = result.get(key);
+      if (Array.isArray(existing) && Array.isArray(value)) {
+        result.set(key, [...existing, ...value]);
+      } else {
+        result.set(key, value);
+      }
+    }
+    return result;
+  }
+
+  /**
+   * Creates a deep clone. Elements are deep cloned,
+   * all other values are deep cloned via ramda clone.
+   */
+  cloneDeep() {
+    const copy = new Metadata();
+    for (const [key, value] of Object.entries(this)) {
+      if (value instanceof this.Element) {
+        copy.set(key, this.cloneDeepElement(value));
+      } else {
+        copy.set(key, (0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])(value));
+      }
+    }
+    return copy;
+  }
+}
+/* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (Metadata);
+
+/***/ },
+
 /***/ 55156
 (__unused_webpack___webpack_module__, __webpack_exports__, __webpack_require__) {
 
@@ -22684,7 +22808,7 @@ const cloneShallowElement = element => {
   const copy = new Ctor();
   copy.element = element.element;
   if (!element.isMetaEmpty) {
-    copy.meta = cloneDeep(element.meta);
+    copy.meta = element.meta.cloneDeep();
   }
   if (!element.isAttributesEmpty) {
     copy.attributes = cloneDeep(element.attributes);
@@ -22712,8 +22836,8 @@ const cloneShallowElement = element => {
 
 /**
  * Creates a shallow clone of an ApiDOM Element, KeyValuePair, or ObjectSlice.
- * The element itself is cloned, but content references are shared (except for
- * meta and attributes which are deep cloned to preserve semantic information).
+ * The element itself is cloned, but content references are shared.
+ * Meta and attributes are deep cloned to preserve semantic information.
  * @public
  */
 const cloneShallow = value => {
@@ -23775,7 +23899,7 @@ class CollectionElement extends _Element_mjs__WEBPACK_IMPORTED_MODULE_0__["defau
    * Search the tree recursively and find the element with the matching ID.
    */
   getById(id) {
-    return this.find(item => item.id.toValue() === id).first;
+    return this.find(item => item.id === id).first;
   }
 
   /**
@@ -23804,18 +23928,24 @@ class CollectionElement extends _Element_mjs__WEBPACK_IMPORTED_MODULE_0__["defau
 
 __webpack_require__.r(__webpack_exports__);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   Metadata: () => (/* reexport safe */ _Metadata_mjs__WEBPACK_IMPORTED_MODULE_1__["default"]),
 /* harmony export */   "default": () => (__WEBPACK_DEFAULT_EXPORT__)
 /* harmony export */ });
 /* harmony import */ var ramda__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(53654);
-/* harmony import */ var _KeyValuePair_mjs__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(36663);
-/* harmony import */ var _ObjectSlice_mjs__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(38504);
+/* harmony import */ var _Metadata_mjs__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(51844);
+/* harmony import */ var _KeyValuePair_mjs__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(36663);
+/* harmony import */ var _ObjectSlice_mjs__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(38504);
+
 
 
+ // shared singleton for frozen elements with no meta — avoids allocation on every access
+const FROZEN_EMPTY_METADATA = Object.freeze(new _Metadata_mjs__WEBPACK_IMPORTED_MODULE_1__["default"]());
 
 /**
  * Valid content types for an Element.
  * @public
  */
+
 /**
  * Base Element class that all ApiDOM elements extend.
  *
@@ -23913,7 +24043,7 @@ class Element {
   _attributes;
 
   // ============================================================
-  // Prototype-assigned properties (set in elements.ts)
+  // Prototype-assigned properties (set in registration.ts)
   // Using 'declare' allows TypeScript to know about these
   // without generating runtime code.
   // ============================================================
@@ -23974,13 +24104,13 @@ class Element {
     }
 
     // KeyValuePair
-    if (value instanceof _KeyValuePair_mjs__WEBPACK_IMPORTED_MODULE_1__["default"]) {
+    if (value instanceof _KeyValuePair_mjs__WEBPACK_IMPORTED_MODULE_2__["default"]) {
       this._content = value;
       return;
     }
 
     // ObjectSlice - extract elements array
-    if (value instanceof _ObjectSlice_mjs__WEBPACK_IMPORTED_MODULE_2__["default"]) {
+    if (value instanceof _ObjectSlice_mjs__WEBPACK_IMPORTED_MODULE_3__["default"]) {
       this._content = value.elements;
       return;
     }
@@ -24001,24 +24131,22 @@ class Element {
 
   /**
    * Metadata about this element (id, classes, title, description, links).
-   * Lazily creates an ObjectElement if not set.
+   * Lazily creates a Metadata instance if not set.
    */
   get meta() {
     if (!this._meta) {
-      if (this.isFrozen) {
-        const meta = new this.ObjectElement();
-        meta.freeze();
-        return meta;
-      }
-      this._meta = new this.ObjectElement();
+      if (this.isFrozen) return FROZEN_EMPTY_METADATA;
+      this._meta = new _Metadata_mjs__WEBPACK_IMPORTED_MODULE_1__["default"]();
     }
     return this._meta;
   }
   set meta(value) {
-    if (value instanceof Element) {
+    if (value instanceof _Metadata_mjs__WEBPACK_IMPORTED_MODULE_1__["default"]) {
       this._meta = value;
-    } else {
-      this.meta.set(value ?? {});
+    } else if (value && typeof value === 'object') {
+      const meta = new _Metadata_mjs__WEBPACK_IMPORTED_MODULE_1__["default"]();
+      Object.assign(meta, value);
+      this._meta = meta;
     }
   }
 
@@ -24051,10 +24179,8 @@ class Element {
 
   /** Unique identifier for this element. */
   get id() {
-    if (this.isFrozen) {
-      return this.getMetaProperty('id', '');
-    }
     if (!this.hasMetaProperty('id')) {
+      if (this.isFrozen) return '';
       this.setMetaProperty('id', '');
     }
     return this.meta.get('id');
@@ -24065,10 +24191,8 @@ class Element {
 
   /** CSS-like class names. */
   get classes() {
-    if (this.isFrozen) {
-      return this.getMetaProperty('classes', []);
-    }
     if (!this.hasMetaProperty('classes')) {
+      if (this.isFrozen) return [];
       this.setMetaProperty('classes', []);
     }
     return this.meta.get('classes');
@@ -24079,11 +24203,13 @@ class Element {
 
   /** Hyperlinks associated with this element. */
   get links() {
-    if (this.isFrozen) {
-      return this.getMetaProperty('links', []);
-    }
     if (!this.hasMetaProperty('links')) {
-      this.setMetaProperty('links', []);
+      if (this.isFrozen) {
+        const empty = new this.ArrayElement();
+        empty.freeze();
+        return empty;
+      }
+      this.setMetaProperty('links', new this.ArrayElement());
     }
     return this.meta.get('links');
   }
@@ -24103,7 +24229,7 @@ class Element {
     if (Array.isArray(content)) {
       return content;
     }
-    if (content instanceof _KeyValuePair_mjs__WEBPACK_IMPORTED_MODULE_1__["default"]) {
+    if (content instanceof _KeyValuePair_mjs__WEBPACK_IMPORTED_MODULE_2__["default"]) {
       const children = [];
       if (content.key) children.push(content.key);
       if (content.value) children.push(content.value);
@@ -24133,7 +24259,6 @@ class Element {
 
     // Freeze meta and attributes
     if (this._meta) {
-      this._meta.parent = this;
       this._meta.freeze();
     }
     if (this._attributes) {
@@ -24168,7 +24293,7 @@ class Element {
     if (_content instanceof Element) {
       return _content.toValue();
     }
-    if (_content instanceof _KeyValuePair_mjs__WEBPACK_IMPORTED_MODULE_1__["default"]) {
+    if (_content instanceof _KeyValuePair_mjs__WEBPACK_IMPORTED_MODULE_2__["default"]) {
       return _content.toValue();
     }
     if (Array.isArray(_content)) {
@@ -24224,7 +24349,7 @@ class Element {
    * @throws Error if this element has no ID
    */
   toRef(path) {
-    const idValue = this.id.toValue();
+    const idValue = this.id;
     if (idValue === '') {
       throw new Error('Cannot create reference to an element without an ID');
     }
@@ -24236,26 +24361,16 @@ class Element {
   }
 
   /**
-   * Gets a meta property.
+   * Gets a meta property value.
    *
    * When the property doesn't exist:
-   * - With defaultValue: returns a new refracted element instance (not cached)
+   * - With defaultValue: returns the provided default value
    * - Without defaultValue: returns undefined
-   *
-   * Note: Each call with a default creates a new instance. Use setMetaProperty
-   * first if you need reference equality across multiple accesses.
    */
 
   getMetaProperty(name, defaultValue) {
     if (!this.hasMetaProperty(name)) {
-      if (defaultValue === undefined) {
-        return undefined;
-      }
-      const element = this.refract(defaultValue);
-      if (element && this.isFrozen) {
-        element.freeze();
-      }
-      return element;
+      return defaultValue;
     }
     return this.meta.get(name);
   }
@@ -24268,20 +24383,17 @@ class Element {
   }
 
   /**
-   * Has meta property.
+   * Checks whether a meta property exists.
    */
   hasMetaProperty(name) {
-    if (!this.isMetaEmpty) {
-      return this.meta.hasKey(name);
-    }
-    return false;
+    return this._meta !== undefined && this._meta.hasKey(name);
   }
 
   /**
    * Checks if meta is empty.
    */
   get isMetaEmpty() {
-    return this._meta === undefined || this.meta.isEmpty;
+    return this._meta === undefined || this._meta.isEmpty;
   }
 
   /**
@@ -24307,7 +24419,7 @@ class Element {
   }
 
   /**
-   * Has attributes property.
+   * Checks whether an attributes property exists.
    */
   hasAttributesProperty(name) {
     if (!this.isAttributesEmpty) {
@@ -24326,6 +24438,7 @@ class Element {
 
 // Re-export types for convenience
 
+
 /* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (Element);
 
 /***/ },
@@ -24758,6 +24871,10 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var _elements_Style_mjs__WEBPACK_IMPORTED_MODULE_15__ = __webpack_require__(49686);
 /* harmony import */ var _ObjectSlice_mjs__WEBPACK_IMPORTED_MODULE_16__ = __webpack_require__(38504);
 /* harmony import */ var _KeyValuePair_mjs__WEBPACK_IMPORTED_MODULE_17__ = __webpack_require__(36663);
+/* harmony import */ var _Metadata_mjs__WEBPACK_IMPORTED_MODULE_18__ = __webpack_require__(51844);
+/* harmony import */ var _clone_index_mjs__WEBPACK_IMPORTED_MODULE_19__ = __webpack_require__(12111);
+
+
 
 
 
@@ -24817,14 +24934,16 @@ function refract(value) {
 }
 
 // Set up prototype assignments for circular dependency resolution.
-// These allow Element instances to create ObjectElement, MemberElement, RefElement
-// without importing them directly (which would cause circular imports).
+// These allow Element and Metadata instances to reference classes they can't import
+// directly (which would cause circular imports).
 // Using 'declare' in the class definitions enables type-safe access to these properties.
 _primitives_Element_mjs__WEBPACK_IMPORTED_MODULE_0__["default"].prototype.ObjectElement = _primitives_ObjectElement_mjs__WEBPACK_IMPORTED_MODULE_8__["default"];
 _primitives_Element_mjs__WEBPACK_IMPORTED_MODULE_0__["default"].prototype.ArrayElement = _primitives_ArrayElement_mjs__WEBPACK_IMPORTED_MODULE_6__["default"];
 _primitives_Element_mjs__WEBPACK_IMPORTED_MODULE_0__["default"].prototype.RefElement = _elements_RefElement_mjs__WEBPACK_IMPORTED_MODULE_10__["default"];
 _primitives_Element_mjs__WEBPACK_IMPORTED_MODULE_0__["default"].prototype.MemberElement = _primitives_MemberElement_mjs__WEBPACK_IMPORTED_MODULE_7__["default"];
 _primitives_Element_mjs__WEBPACK_IMPORTED_MODULE_0__["default"].prototype.refract = refract;
+_Metadata_mjs__WEBPACK_IMPORTED_MODULE_18__["default"].prototype.Element = _primitives_Element_mjs__WEBPACK_IMPORTED_MODULE_0__["default"];
+_Metadata_mjs__WEBPACK_IMPORTED_MODULE_18__["default"].prototype.cloneDeepElement = element => (0,_clone_index_mjs__WEBPACK_IMPORTED_MODULE_19__.cloneDeep)(element);
 
 /**
  * Contains all of the element classes, and related structures and methods
@@ -24888,7 +25007,13 @@ class JSONSerialiser {
       element: element.element
     };
     if (!element.isMetaEmpty) {
-      payload.meta = this.serialiseObject(element.meta);
+      const serialisedMeta = this.serialiseMeta(element);
+      if (serialisedMeta) {
+        payload.meta = serialisedMeta.meta;
+        if (serialisedMeta.rawKeys.length > 0) {
+          payload.__meta_raw__ = serialisedMeta.rawKeys;
+        }
+      }
     }
     if (!element.isAttributesEmpty) {
       payload.attributes = this.serialiseObject(element.attributes);
@@ -24935,7 +25060,7 @@ class JSONSerialiser {
       element.element = value.element;
     }
 
-    // Extract __mappings__ and __styles__ without mutating input, filter remaining meta
+    // Extract special meta keys without mutating input, filter remaining meta
     let mappingsDoc;
     let stylesDoc;
     let metaToDeserialize = value.meta;
@@ -24949,8 +25074,15 @@ class JSONSerialiser {
       stylesDoc = __styles__;
       metaToDeserialize = Object.keys(rest).length > 0 ? rest : undefined;
     }
+
+    // determine which meta keys were raw primitives before serialization
+    const rawKeys = value.__meta_raw__ ? new Set(value.__meta_raw__) : undefined;
     if (metaToDeserialize) {
-      this.deserialiseObject(metaToDeserialize, element.meta);
+      for (const [key, doc] of Object.entries(metaToDeserialize)) {
+        const deserialized = this.deserialise(doc);
+        // unwrap keys that were raw primitives before serialization
+        element.setMetaProperty(key, rawKeys?.has(key) ? deserialized.toValue() : deserialized);
+      }
     }
 
     // Restore source position from __mappings__
@@ -25013,6 +25145,27 @@ class JSONSerialiser {
     }
     return content;
   }
+  serialiseMeta(element) {
+    const meta = {};
+    const rawKeys = [];
+    let hasEntries = false;
+    for (const [key, value] of Object.entries(element.meta)) {
+      if (value instanceof this.namespace.elements.Element) {
+        meta[key] = this.serialise(value);
+        hasEntries = true;
+      } else if (value !== undefined) {
+        // refract primitives to maintain JSON Refract spec compatibility
+        const refracted = element.refract(value);
+        meta[key] = this.serialise(refracted);
+        rawKeys.push(key);
+        hasEntries = true;
+      }
+    }
+    return hasEntries ? {
+      meta,
+      rawKeys
+    } : undefined;
+  }
   serialiseObject(obj) {
     const result = {};
     obj.forEach((value, key) => {
@@ -27095,7 +27248,7 @@ __webpack_require__.r(__webpack_exports__);
  */
 class FallbackVisitor extends _Visitor_mjs__WEBPACK_IMPORTED_MODULE_1__["default"] {
   enter(path) {
-    this.element = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__.cloneDeep)(path.node);
+    this.element = this.consume ? path.node : (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__.cloneDeep)(path.node);
     path.stop();
   }
 }
@@ -27134,7 +27287,7 @@ __webpack_require__.r(__webpack_exports__);
  */
 class SpecificationVisitor extends _Visitor_mjs__WEBPACK_IMPORTED_MODULE_6__["default"] {
   specObj;
-  passingOptionsNames = ['specObj', 'parent'];
+  passingOptionsNames = ['specObj', 'parent', 'consume'];
   constructor({
     specObj,
     ...rest
@@ -27180,7 +27333,7 @@ class SpecificationVisitor extends _Visitor_mjs__WEBPACK_IMPORTED_MODULE_6__["de
      */
     const visitor = this.retrieveVisitorInstance(specPath, options);
     if (visitor instanceof _FallbackVisitor_mjs__WEBPACK_IMPORTED_MODULE_7__["default"] && visitor?.constructor === _FallbackVisitor_mjs__WEBPACK_IMPORTED_MODULE_7__["default"]) {
-      return (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_4__.cloneDeep)(element);
+      return this.consume ? element : (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_4__.cloneDeep)(element);
     }
     (0,_speclynx_apidom_traverse__WEBPACK_IMPORTED_MODULE_5__.traverse)(element, visitor, options);
     return visitor.element;
@@ -27198,7 +27351,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   "default": () => (__WEBPACK_DEFAULT_EXPORT__)
 /* harmony export */ });
 /* harmony import */ var _speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(28400);
-/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(97071);
+/* 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__(25810);
 /* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(49686);
 
@@ -27213,19 +27366,21 @@ __webpack_require__.r(__webpack_exports__);
  */
 class Visitor {
   element;
+  consume = false;
+  consumeSafe = false;
   constructor(options) {
     Object.assign(this, options);
   }
   copyMetaAndAttributes(from, to) {
-    if (!from.isMetaEmpty || !to.isMetaEmpty) {
-      const target = to.isMetaEmpty ? new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__["default"]() : to.meta;
-      const source = from.isMetaEmpty ? new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__["default"]() : from.meta;
-      to.meta = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_0__["default"])(target, source);
+    if (!from.isMetaEmpty && !to.isMetaEmpty) {
+      to.meta = to.meta.merge(from.meta);
+    } else if (!from.isMetaEmpty) {
+      to.meta = from.meta.cloneDeep();
     }
-    if (!from.isAttributesEmpty || !to.isAttributesEmpty) {
-      const target = to.isAttributesEmpty ? new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__["default"]() : to.attributes;
-      const source = from.isAttributesEmpty ? new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__["default"]() : from.attributes;
-      to.attributes = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_0__["default"])(target, source);
+    if (!from.isAttributesEmpty && !to.isAttributesEmpty) {
+      to.attributes = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_0__["default"])(to.attributes, from.attributes);
+    } else if (!from.isAttributesEmpty) {
+      to.attributes = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.cloneDeep)(from.attributes);
     }
     _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__["default"].transfer(from, to);
     _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__["default"].transfer(from, to);
@@ -27333,12 +27488,13 @@ class FixedFieldsVisitor extends _SpecificationVisitor_mjs__WEBPACK_IMPORTED_MOD
       const keyValue = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_3__["default"])(key);
       if ((0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__.isStringElement)(key) && fields.includes(keyValue) && !this.ignoredFields.includes(keyValue)) {
         const fixedFieldElement = this.toRefractedElement([...specPath, 'fixedFields', keyValue], value);
-        const newMemberElement = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__["default"]((0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.cloneDeep)(key), fixedFieldElement);
+        const newMemberElement = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__["default"](this.consume ? key : (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.cloneDeep)(key), fixedFieldElement);
         this.copyMetaAndAttributes(memberElement, newMemberElement);
-        newMemberElement.classes.push('fixed-field');
         this.element.content.push(newMemberElement);
+        // consume: release processed generic subtree
+        if (this.consume && this.consumeSafe && !memberElement.isFrozen) memberElement.value = undefined;
       } else if (!this.ignoredFields.includes(keyValue)) {
-        this.element.content.push((0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.cloneDeep)(memberElement));
+        this.element.content.push(this.consume ? memberElement : (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.cloneDeep)(memberElement));
       }
     });
     this.copyMetaAndAttributes(objectElement, this.element);
@@ -27425,12 +27581,14 @@ class PatternedFieldsVisitor extends _SpecificationVisitor_mjs__WEBPACK_IMPORTED
       if (!this.ignoredFields.includes(keyValue) && this.fieldPatternPredicate(keyValue)) {
         const specPath = this.specPath(value);
         const patternedFieldElement = this.toRefractedElement(specPath, value);
-        const newMemberElement = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__["default"]((0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.cloneDeep)(key), patternedFieldElement);
+        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.content.push(newMemberElement);
+        // consume: release processed generic subtree
+        if (this.consume && this.consumeSafe && !memberElement.isFrozen) memberElement.value = undefined;
       } else if (!this.ignoredFields.includes(keyValue)) {
-        this.element.content.push((0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.cloneDeep)(memberElement));
+        this.element.content.push(this.consume ? memberElement : (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.cloneDeep)(memberElement));
       }
     });
     this.copyMetaAndAttributes(objectElement, this.element);
@@ -27972,13 +28130,11 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var ramda_adjunct__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(33031);
 /* harmony import */ var ramda_adjunct__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(68894);
 /* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(25162);
-/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(12111);
-/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(97601);
-/* harmony import */ var _speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(44673);
-/* harmony import */ var _generics_FixedFieldsVisitor_mjs__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(55320);
-/* harmony import */ var _bases_mjs__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(89033);
-/* harmony import */ var _elements_JSONSchema_mjs__WEBPACK_IMPORTED_MODULE_10__ = __webpack_require__(94686);
-/* harmony import */ var _predicates_mjs__WEBPACK_IMPORTED_MODULE_11__ = __webpack_require__(86059);
+/* harmony import */ var _speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(44673);
+/* harmony import */ var _generics_FixedFieldsVisitor_mjs__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(55320);
+/* harmony import */ var _bases_mjs__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(89033);
+/* harmony import */ var _elements_JSONSchema_mjs__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(94686);
+/* harmony import */ var _predicates_mjs__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(86059);
 
 
 
@@ -27993,10 +28149,11 @@ __webpack_require__.r(__webpack_exports__);
 /**
  * @public
  */
-class JSONSchemaVisitor extends _bases_mjs__WEBPACK_IMPORTED_MODULE_9__.JSONSchemaVisitorBase {
+class JSONSchemaVisitor extends _bases_mjs__WEBPACK_IMPORTED_MODULE_7__.JSONSchemaVisitorBase {
   constructor(options) {
     super(options);
-    this.element = new _elements_JSONSchema_mjs__WEBPACK_IMPORTED_MODULE_10__["default"]();
+    this.element = new _elements_JSONSchema_mjs__WEBPACK_IMPORTED_MODULE_8__["default"]();
+    this.consumeSafe = true;
     this.specPath = (0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])(['document', 'objects', 'JSONSchema']);
   }
   get defaultDialectIdentifier() {
@@ -28009,27 +28166,27 @@ class JSONSchemaVisitor extends _bases_mjs__WEBPACK_IMPORTED_MODULE_9__.JSONSche
 
     // for further processing consider this JSONSchema Element as parent for all sub-schemas
     this.parent = this.element;
-    return _generics_FixedFieldsVisitor_mjs__WEBPACK_IMPORTED_MODULE_8__["default"].prototype.ObjectElement.call(this, path);
+    return _generics_FixedFieldsVisitor_mjs__WEBPACK_IMPORTED_MODULE_6__["default"].prototype.ObjectElement.call(this, path);
   }
   handleDialectIdentifier(objectElement) {
     // handle $schema keyword in embedded resources
     if ((0,ramda_adjunct__WEBPACK_IMPORTED_MODULE_2__["default"])(this.parent) && !(0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_4__.isStringElement)(objectElement.get('$schema'))) {
       // no parent available and no $schema is defined, set default $schema
       this.element.meta.set('inheritedDialectIdentifier', this.defaultDialectIdentifier);
-    } else if ((0,_predicates_mjs__WEBPACK_IMPORTED_MODULE_11__.isJSONSchemaElement)(this.parent) && !(0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_4__.isStringElement)(objectElement.get('$schema'))) {
+    } else if ((0,_predicates_mjs__WEBPACK_IMPORTED_MODULE_9__.isJSONSchemaElement)(this.parent) && !(0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_4__.isStringElement)(objectElement.get('$schema'))) {
       // parent is available and no $schema is defined, set parent $schema
-      const inheritedDialectIdentifier = (0,ramda__WEBPACK_IMPORTED_MODULE_1__["default"])((0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(this.parent.meta.get('inheritedDialectIdentifier')), (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(this.parent.$schema));
+      const inheritedDialectIdentifier = (0,ramda__WEBPACK_IMPORTED_MODULE_1__["default"])(this.parent.meta.get('inheritedDialectIdentifier'), (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(this.parent.$schema));
       this.element.meta.set('inheritedDialectIdentifier', inheritedDialectIdentifier);
     }
   }
   handleSchemaIdentifier(objectElement, identifierKeyword = 'id') {
     // handle schema identifier in embedded resources
-    // fetch parent's ancestorsSchemaIdentifiers
-    const ancestorsSchemaIdentifiers = this.parent !== undefined ? (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_5__.cloneDeep)(this.parent.meta.get('ancestorsSchemaIdentifiers') ?? new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_6__["default"]()) : new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_6__["default"]();
+    // fetch parent's ancestorsSchemaIdentifiers (stored as plain string[])
+    const ancestorsSchemaIdentifiers = this.parent !== undefined ? [...(this.parent.meta.get('ancestorsSchemaIdentifiers') ?? [])] : [];
     // get current schema identifier
-    const schemaIdentifier = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(objectElement.get(identifierKeyword));
+    const schemaIdentifier = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(objectElement.get(identifierKeyword));
 
-    // remember schema identifier if it's a non-empty strings
+    // remember schema identifier if it's a non-empty string
     if ((0,ramda_adjunct__WEBPACK_IMPORTED_MODULE_3__["default"])(schemaIdentifier)) {
       ancestorsSchemaIdentifiers.push(schemaIdentifier);
     }
@@ -32666,7 +32823,7 @@ __webpack_require__.r(__webpack_exports__);
  */
 class FallbackVisitor extends _Visitor_mjs__WEBPACK_IMPORTED_MODULE_1__["default"] {
   enter(path) {
-    this.element = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__.cloneDeep)(path.node);
+    this.element = this.consume ? path.node : (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__.cloneDeep)(path.node);
     path.stop();
   }
 }
@@ -32730,8 +32887,9 @@ __webpack_require__.r(__webpack_exports__);
  */
 class SpecificationVisitor extends _Visitor_mjs__WEBPACK_IMPORTED_MODULE_6__["default"] {
   specObj;
-  passingOptionsNames = ['specObj', 'openApiGenericElement', 'openApiSemanticElement'];
+  passingOptionsNames = ['specObj', 'openApiGenericElement', 'sourceContext', 'openApiSemanticElement', 'consume'];
   openApiGenericElement;
+  sourceContext;
   openApiSemanticElement;
   constructor({
     specObj,
@@ -32786,7 +32944,7 @@ class SpecificationVisitor extends _Visitor_mjs__WEBPACK_IMPORTED_MODULE_6__["de
      */
     const visitor = this.retrieveVisitorInstance(specPath, options);
     if (visitor instanceof _FallbackVisitor_mjs__WEBPACK_IMPORTED_MODULE_7__["default"] && visitor?.constructor === _FallbackVisitor_mjs__WEBPACK_IMPORTED_MODULE_7__["default"]) {
-      return (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_4__.cloneDeep)(element);
+      return this.consume ? element : (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_4__.cloneDeep)(element);
     }
     (0,_speclynx_apidom_traverse__WEBPACK_IMPORTED_MODULE_5__.traverse)(element, visitor, {
       nodeTypeGetter: _speclynx_apidom_traverse__WEBPACK_IMPORTED_MODULE_5__.getNodePrimitiveType
@@ -32806,7 +32964,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   "default": () => (__WEBPACK_DEFAULT_EXPORT__)
 /* harmony export */ });
 /* harmony import */ var _speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(28400);
-/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(97071);
+/* 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__(25810);
 /* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(49686);
 
@@ -32821,19 +32979,21 @@ __webpack_require__.r(__webpack_exports__);
  */
 class Visitor {
   element;
+  consume = false;
+  consumeSafe = false;
   constructor(options = {}) {
     Object.assign(this, options);
   }
   copyMetaAndAttributes(from, to) {
-    if (!from.isMetaEmpty || !to.isMetaEmpty) {
-      const target = to.isMetaEmpty ? new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__["default"]() : to.meta;
-      const source = from.isMetaEmpty ? new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__["default"]() : from.meta;
-      to.meta = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_0__["default"])(target, source);
+    if (!from.isMetaEmpty && !to.isMetaEmpty) {
+      to.meta = to.meta.merge(from.meta);
+    } else if (!from.isMetaEmpty) {
+      to.meta = from.meta.cloneDeep();
     }
-    if (!from.isAttributesEmpty || !to.isAttributesEmpty) {
-      const target = to.isAttributesEmpty ? new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__["default"]() : to.attributes;
-      const source = from.isAttributesEmpty ? new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__["default"]() : from.attributes;
-      to.attributes = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_0__["default"])(target, source);
+    if (!from.isAttributesEmpty && !to.isAttributesEmpty) {
+      to.attributes = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_0__["default"])(to.attributes, from.attributes);
+    } else if (!from.isAttributesEmpty) {
+      to.attributes = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.cloneDeep)(from.attributes);
     }
     _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__["default"].transfer(from, to);
     _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__["default"].transfer(from, to);
@@ -32953,15 +33113,20 @@ class FixedFieldsVisitor extends _SpecificationVisitor_mjs__WEBPACK_IMPORTED_MOD
       const keyValue = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_3__["default"])(key);
       if ((0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__.isStringElement)(key) && fields.includes(keyValue) && !this.ignoredFields.includes(keyValue)) {
         const fixedFieldElement = this.toRefractedElement([...specPath, 'fixedFields', keyValue], value);
-        const newMemberElement = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__["default"]((0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.cloneDeep)(key), fixedFieldElement);
+        const newMemberElement = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__["default"](this.consume ? key : (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.cloneDeep)(key), fixedFieldElement);
         this.copyMetaAndAttributes(memberElement, newMemberElement);
-        newMemberElement.classes.push('fixed-field');
         this.element.content.push(newMemberElement);
+        // consume: release processed generic subtree
+        if (this.consume && this.consumeSafe && !memberElement.isFrozen) memberElement.value = undefined;
       } else if (this.canSupportSpecificationExtensions && this.specificationExtensionPredicate(memberElement)) {
         const extensionElement = this.toRefractedElement(['document', 'extension'], memberElement);
         this.element.content.push(extensionElement);
+        // consume: release processed generic subtree
+        if (this.consume && this.consumeSafe && !memberElement.isFrozen) {
+          memberElement.value = undefined;
+        }
       } else if (!this.ignoredFields.includes(keyValue)) {
-        this.element.content.push((0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.cloneDeep)(memberElement));
+        this.element.content.push(this.consume ? memberElement : (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.cloneDeep)(memberElement));
       }
     });
     this.copyMetaAndAttributes(objectElement, this.element);
@@ -33140,12 +33305,14 @@ class PatternedFieldsVisitor extends _SpecificationVisitor_mjs__WEBPACK_IMPORTED
       } else if (!this.ignoredFields.includes(keyValue) && this.fieldPatternPredicate(keyValue)) {
         const specPath = this.specPath(value);
         const patternedFieldElement = this.toRefractedElement(specPath, value);
-        const newMemberElement = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__["default"]((0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.cloneDeep)(key), patternedFieldElement);
+        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.content.push(newMemberElement);
+        // consume: release processed generic subtree
+        if (this.consume && this.consumeSafe && !memberElement.isFrozen) memberElement.value = undefined;
       } else if (!this.ignoredFields.includes(keyValue)) {
-        this.element.content.push((0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.cloneDeep)(memberElement));
+        this.element.content.push(this.consume ? memberElement : (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.cloneDeep)(memberElement));
       }
     });
     this.copyMetaAndAttributes(objectElement, this.element);
@@ -33989,6 +34156,7 @@ class ComponentsVisitor extends _bases_mjs__WEBPACK_IMPORTED_MODULE_2__.BaseFixe
     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;
+    this.consumeSafe = true;
   }
 }
 /* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (ComponentsVisitor);
@@ -34414,6 +34582,7 @@ class OpenApi3_0Visitor extends _bases_mjs__WEBPACK_IMPORTED_MODULE_1__.BaseFixe
     this.element = new _elements_OpenApi3_0_mjs__WEBPACK_IMPORTED_MODULE_2__["default"]();
     this.specPath = (0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])(['document', 'objects', 'OpenApi']);
     this.canSupportSpecificationExtensions = true;
+    this.consumeSafe = true;
   }
   ObjectElement(path) {
     _bases_mjs__WEBPACK_IMPORTED_MODULE_1__.BaseFixedFieldsVisitor.prototype.ObjectElement.call(this, path);
@@ -35275,11 +35444,10 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */ });
 /* harmony import */ var ramda__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(29498);
 /* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(25162);
-/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(12111);
-/* harmony import */ var _speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(44673);
-/* harmony import */ var _elements_PathItem_mjs__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(98557);
-/* harmony import */ var _predicates_mjs__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(32131);
-/* harmony import */ var _bases_mjs__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(74367);
+/* harmony import */ var _speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(44673);
+/* harmony import */ var _elements_PathItem_mjs__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(98557);
+/* harmony import */ var _predicates_mjs__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(32131);
+/* harmony import */ var _bases_mjs__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(74367);
 
 
 
@@ -35292,22 +35460,21 @@ __webpack_require__.r(__webpack_exports__);
 /**
  * @public
  */
-class PathItemVisitor extends _bases_mjs__WEBPACK_IMPORTED_MODULE_6__.BaseFixedFieldsVisitor {
+class PathItemVisitor extends _bases_mjs__WEBPACK_IMPORTED_MODULE_5__.BaseFixedFieldsVisitor {
   constructor(options) {
     super(options);
-    this.element = new _elements_PathItem_mjs__WEBPACK_IMPORTED_MODULE_4__["default"]();
+    this.element = new _elements_PathItem_mjs__WEBPACK_IMPORTED_MODULE_3__["default"]();
     this.specPath = (0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])(['document', 'objects', 'PathItem']);
+    this.consumeSafe = true;
   }
   ObjectElement(path) {
-    _bases_mjs__WEBPACK_IMPORTED_MODULE_6__.BaseFixedFieldsVisitor.prototype.ObjectElement.call(this, path);
+    _bases_mjs__WEBPACK_IMPORTED_MODULE_5__.BaseFixedFieldsVisitor.prototype.ObjectElement.call(this, path);
 
     // decorate Operation elements with HTTP method
-    this.element.filter(_predicates_mjs__WEBPACK_IMPORTED_MODULE_5__.isOperationElement)
+    this.element.filter(_predicates_mjs__WEBPACK_IMPORTED_MODULE_4__.isOperationElement)
     // @ts-ignore
     .forEach((operationElement, httpMethodElementCI) => {
-      const httpMethodElementCS = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__.cloneDeep)(httpMethodElementCI);
-      httpMethodElementCS.content = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_3__["default"])(httpMethodElementCS).toUpperCase();
-      operationElement.meta.set('http-method', httpMethodElementCS);
+      operationElement.meta.set('http-method', (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_2__["default"])(httpMethodElementCI).toUpperCase());
     });
 
     // mark this PathItemElement with reference metadata
@@ -35329,7 +35496,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */ });
 /* harmony import */ var ramda__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(53679);
 /* harmony import */ var ramda__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(29498);
-/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(12111);
+/* harmony import */ var _speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(44673);
 /* harmony import */ var _elements_Paths_mjs__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(8535);
 /* harmony import */ var _predicates_mjs__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(32131);
 /* harmony import */ var _bases_mjs__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(74367);
@@ -35350,6 +35517,7 @@ class PathsVisitor extends _bases_mjs__WEBPACK_IMPORTED_MODULE_5__.BasePatterned
     this.element = new _elements_Paths_mjs__WEBPACK_IMPORTED_MODULE_3__["default"]();
     this.specPath = (0,ramda__WEBPACK_IMPORTED_MODULE_1__["default"])(['document', 'objects', 'PathItem']);
     this.canSupportSpecificationExtensions = true;
+    this.consumeSafe = true;
     this.fieldPatternPredicate = ramda__WEBPACK_IMPORTED_MODULE_0__["default"];
   }
   ObjectElement(path) {
@@ -35361,7 +35529,7 @@ class PathsVisitor extends _bases_mjs__WEBPACK_IMPORTED_MODULE_5__.BasePatterned
     .forEach((pathItemElement, key) => {
       key.classes.push('openapi-path-template');
       key.classes.push('path-template');
-      pathItemElement.meta.set('path', (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__.cloneDeep)(key));
+      pathItemElement.meta.set('path', (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_2__["default"])(key));
     });
   }
 }