@speclynx/apidom-parser-adapter-openapi-json-3-1 2.13.0 → 3.0.0

package/dist/apidom-parser-adapter-openapi-json-3-1.browser.js

@@ -20327,7 +20327,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
@@ -20343,7 +20343,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;
 };
@@ -20415,8 +20415,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) => {
@@ -20755,6 +20767,105 @@ class KeyValuePair {
 
 /***/ },
 
+/***/ 51844
+(__unused_webpack___webpack_module__, __webpack_exports__, __webpack_require__) {
+
+"use strict";
+__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__) {
 
@@ -21401,7 +21512,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);
@@ -21429,8 +21540,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 => {
@@ -22505,7 +22616,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;
   }
 
   /**
@@ -22535,18 +22646,24 @@ class CollectionElement extends _Element_mjs__WEBPACK_IMPORTED_MODULE_0__["defau
 "use strict";
 __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.
  *
@@ -22644,7 +22761,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.
   // ============================================================
@@ -22705,13 +22822,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;
     }
@@ -22732,24 +22849,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;
     }
   }
 
@@ -22782,10 +22897,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');
@@ -22796,10 +22909,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');
@@ -22810,11 +22921,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');
   }
@@ -22834,7 +22947,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);
@@ -22864,7 +22977,6 @@ class Element {
 
     // Freeze meta and attributes
     if (this._meta) {
-      this._meta.parent = this;
       this._meta.freeze();
     }
     if (this._attributes) {
@@ -22899,7 +23011,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)) {
@@ -22955,7 +23067,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');
     }
@@ -22967,26 +23079,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);
   }
@@ -22999,20 +23101,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;
   }
 
   /**
@@ -23038,7 +23137,7 @@ class Element {
   }
 
   /**
-   * Has attributes property.
+   * Checks whether an attributes property exists.
    */
   hasAttributesProperty(name) {
     if (!this.isAttributesEmpty) {
@@ -23057,6 +23156,7 @@ class Element {
 
 // Re-export types for convenience
 
+
 /* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (Element);
 
 /***/ },
@@ -23495,6 +23595,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);
+
+
 
 
 
@@ -23554,14 +23658,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
@@ -23626,7 +23732,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);
@@ -23673,7 +23785,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;
@@ -23687,8 +23799,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__
@@ -23751,6 +23870,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) => {
@@ -25872,7 +26012,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();
   }
 }
@@ -25912,7 +26052,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
@@ -25958,7 +26098,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;
@@ -25977,7 +26117,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);
 
@@ -25992,19 +26132,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);
@@ -26114,12 +26256,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);
@@ -26208,12 +26351,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);
@@ -26771,13 +26916,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);
 
 
 
@@ -26792,10 +26935,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() {
@@ -26808,27 +26952,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);
     }
@@ -31553,7 +31697,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();
   }
 }
@@ -31619,8 +31763,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,
@@ -31675,7 +31820,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
@@ -31696,7 +31841,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);
 
@@ -31711,19 +31856,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);
@@ -31845,15 +31992,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);
@@ -32035,12 +32187,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);
@@ -32903,6 +33057,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);
@@ -33341,6 +33496,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);
@@ -34231,11 +34387,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);
 
 
 
@@ -34248,22 +34403,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
@@ -34286,7 +34440,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);
@@ -34307,6 +34461,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) {
@@ -34318,7 +34473,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));
     });
   }
 }
@@ -36618,7 +36773,8 @@ __webpack_require__.r(__webpack_exports__);
 const refract = (value, {
   element = 'openApi3_1',
   plugins = [],
-  specificationObj = _specification_mjs__WEBPACK_IMPORTED_MODULE_5__["default"]
+  specificationObj = _specification_mjs__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);
@@ -36635,7 +36791,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
@@ -38157,9 +38314,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_mjs__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(81793);
-/* harmony import */ var _bases_mjs__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(43027);
+/* 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_mjs__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(81793);
+/* harmony import */ var _bases_mjs__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(43027);
+
+
 
 
 
@@ -38171,18 +38332,25 @@ __webpack_require__.r(__webpack_exports__);
  * @public
  */
 
-class OpenApi3_1Visitor extends _bases_mjs__WEBPACK_IMPORTED_MODULE_3__.BaseFixedFieldsVisitor {
+class OpenApi3_1Visitor extends _bases_mjs__WEBPACK_IMPORTED_MODULE_5__.BaseFixedFieldsVisitor {
   constructor(options) {
     super(options);
-    this.element = new _elements_OpenApi3_1_mjs__WEBPACK_IMPORTED_MODULE_2__["default"]();
+    this.element = new _elements_OpenApi3_1_mjs__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);
@@ -38870,8 +39038,8 @@ class SchemaVisitor extends _bases_mjs__WEBPACK_IMPORTED_MODULE_8__.BaseSchemaVi
     (0,_predicates_mjs__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);
     }
@@ -39218,8 +39386,9 @@ const parse = async source => {
   if (source.trim().length === 0) {
     return parseResult;
   }
-  const pojo = JSON.parse(source);
+  let pojo = JSON.parse(source);
   const element = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__.refract)(pojo);
+  pojo = null; // allow GC to reclaim POJO
   element.classes.push('result');
   parseResult.push(element);
   return parseResult;
@@ -41193,7 +41362,10 @@ const parse = async (source, options = {}) => {
     result
   } = parseResultElement;
   if ((0,ramda_adjunct__WEBPACK_IMPORTED_MODULE_2__["default"])(result)) {
-    const openApiElement = (0,_speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_6__.refractOpenApi3_1)(result, refractorOpts);
+    const openApiElement = (0,_speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_6__.refractOpenApi3_1)(result, {
+      consume: true,
+      ...refractorOpts
+    });
     openApiElement.classes.push('result');
     parseResultElement.replaceResult(openApiElement);
   }