@speclynx/apidom-parser-adapter-json 2.13.1 → 3.0.0

package/dist/apidom-parser-adapter-json.browser.js

@@ -76,8 +76,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;
@@ -522,6 +523,53 @@ const analyze = (cst, {
 
 /***/ },
 
+/***/ 8138
+(__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 _internal_clone_js__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(8575);
+/* harmony import */ var _internal_curry1_js__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(8938);
+
+
+
+/**
+ * Creates a deep copy of the source that can be used in place of the source
+ * object without retaining any references to it.
+ * The source object may contain (nested) `Array`s and `Object`s,
+ * `Number`s, `String`s, `Boolean`s and `Date`s.
+ * `Function`s are assigned by reference rather than copied.
+ *
+ * Dispatches to a `clone` method if present.
+ *
+ * Note that if the source object has multiple nodes that share a reference,
+ * the returned object will have the same structure, but the references will
+ * be pointed to the location within the cloned value.
+ *
+ * @func
+ * @memberOf R
+ * @since v0.1.0
+ * @category Object
+ * @sig {*} -> {*}
+ * @param {*} value The object or array to clone
+ * @return {*} A deeply cloned copy of `val`
+ * @example
+ *
+ *      const objects = [{}, {}, {}];
+ *      const objectsClone = R.clone(objects);
+ *      objects === objectsClone; //=> false
+ *      objects[0] === objectsClone[0]; //=> false
+ */
+var clone = /*#__PURE__*/(0,_internal_curry1_js__WEBPACK_IMPORTED_MODULE_1__["default"])(function clone(value) {
+  return value != null && typeof value.clone === 'function' ? value.clone() : (0,_internal_clone_js__WEBPACK_IMPORTED_MODULE_0__["default"])(value, true);
+});
+/* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (clone);
+
+/***/ },
+
 /***/ 3654
 (__unused_webpack___webpack_module__, __webpack_exports__, __webpack_require__) {
 
@@ -586,6 +634,146 @@ function _arrayFromIterator(iter) {
 
 /***/ },
 
+/***/ 8575
+(__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": () => (/* binding */ _clone)
+/* harmony export */ });
+/* harmony import */ var _cloneRegExp_js__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(1254);
+/* harmony import */ var _type_js__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(963);
+
+
+
+/**
+ * Copies an object.
+ *
+ * @private
+ * @param {*} value The value to be copied
+ * @param {Boolean} deep Whether or not to perform deep cloning.
+ * @return {*} The copied value.
+ */
+function _clone(value, deep, map) {
+  map || (map = new _ObjectMap());
+
+  // this avoids the slower switch with a quick if decision removing some milliseconds in each run.
+  if (_isPrimitive(value)) {
+    return value;
+  }
+  var copy = function copy(copiedValue) {
+    // Check for circular and same references on the object graph and return its corresponding clone.
+    var cachedCopy = map.get(value);
+    if (cachedCopy) {
+      return cachedCopy;
+    }
+    map.set(value, copiedValue);
+    for (var key in value) {
+      if (Object.prototype.hasOwnProperty.call(value, key)) {
+        copiedValue[key] = deep ? _clone(value[key], true, map) : value[key];
+      }
+    }
+    return copiedValue;
+  };
+  switch ((0,_type_js__WEBPACK_IMPORTED_MODULE_1__["default"])(value)) {
+    case 'Object':
+      return copy(Object.create(Object.getPrototypeOf(value)));
+    case 'Array':
+      return copy(Array(value.length));
+    case 'Date':
+      return new Date(value.valueOf());
+    case 'RegExp':
+      return (0,_cloneRegExp_js__WEBPACK_IMPORTED_MODULE_0__["default"])(value);
+    case 'Int8Array':
+    case 'Uint8Array':
+    case 'Uint8ClampedArray':
+    case 'Int16Array':
+    case 'Uint16Array':
+    case 'Int32Array':
+    case 'Uint32Array':
+    case 'Float32Array':
+    case 'Float64Array':
+    case 'BigInt64Array':
+    case 'BigUint64Array':
+      return value.slice();
+    default:
+      return value;
+  }
+}
+function _isPrimitive(param) {
+  var type = typeof param;
+  return param == null || type != 'object' && type != 'function';
+}
+var _ObjectMap = /*#__PURE__*/function () {
+  function _ObjectMap() {
+    this.map = {};
+    this.length = 0;
+  }
+  _ObjectMap.prototype.set = function (key, value) {
+    var hashedKey = this.hash(key);
+    var bucket = this.map[hashedKey];
+    if (!bucket) {
+      this.map[hashedKey] = bucket = [];
+    }
+    bucket.push([key, value]);
+    this.length += 1;
+  };
+  _ObjectMap.prototype.hash = function (key) {
+    var hashedKey = [];
+    for (var value in key) {
+      hashedKey.push(Object.prototype.toString.call(key[value]));
+    }
+    return hashedKey.join();
+  };
+  _ObjectMap.prototype.get = function (key) {
+    /**
+     * depending on the number of objects to be cloned is faster to just iterate over the items in the map just because the hash function is so costly,
+     * on my tests this number is 180, anything above that using the hash function is faster.
+     */
+    if (this.length <= 180) {
+      for (var p in this.map) {
+        var bucket = this.map[p];
+        for (var i = 0; i < bucket.length; i += 1) {
+          var element = bucket[i];
+          if (element[0] === key) {
+            return element[1];
+          }
+        }
+      }
+      return;
+    }
+    var hashedKey = this.hash(key);
+    var bucket = this.map[hashedKey];
+    if (!bucket) {
+      return;
+    }
+    for (var i = 0; i < bucket.length; i += 1) {
+      var element = bucket[i];
+      if (element[0] === key) {
+        return element[1];
+      }
+    }
+  };
+  return _ObjectMap;
+}();
+
+/***/ },
+
+/***/ 1254
+(__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": () => (/* binding */ _cloneRegExp)
+/* harmony export */ });
+function _cloneRegExp(pattern) {
+  return new RegExp(pattern.source, pattern.flags ? pattern.flags : (pattern.global ? 'g' : '') + (pattern.ignoreCase ? 'i' : '') + (pattern.multiline ? 'm' : '') + (pattern.sticky ? 'y' : '') + (pattern.unicode ? 'u' : '') + (pattern.dotAll ? 's' : ''));
+}
+
+/***/ },
+
 /***/ 8938
 (__unused_webpack___webpack_module__, __webpack_exports__, __webpack_require__) {
 
@@ -5137,6 +5325,105 @@ class KeyValuePair {
 
 /***/ },
 
+/***/ 1844
+(__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);
+
+/***/ },
+
 /***/ 5156
 (__unused_webpack___webpack_module__, __webpack_exports__, __webpack_require__) {
 
@@ -5571,6 +5858,275 @@ class ObjectSlice {
 }
 /* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (ObjectSlice);
 
+/***/ },
+
+/***/ 3772
+(__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 _speclynx_apidom_error__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(4641);
+
+
+/**
+ * @public
+ */
+
+/**
+ * @public
+ */
+class CloneError extends _speclynx_apidom_error__WEBPACK_IMPORTED_MODULE_0__["default"] {
+  value;
+  constructor(message, structuredOptions) {
+    super(message, structuredOptions);
+    if (typeof structuredOptions !== 'undefined') {
+      this.value = structuredOptions.value;
+    }
+  }
+}
+/* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (CloneError);
+
+/***/ },
+
+/***/ 5018
+(__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 _CloneError_mjs__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(3772);
+
+/**
+ * @public
+ */
+class DeepCloneError extends _CloneError_mjs__WEBPACK_IMPORTED_MODULE_0__["default"] {}
+/* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (DeepCloneError);
+
+/***/ },
+
+/***/ 3686
+(__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 _CloneError_mjs__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(3772);
+
+/**
+ * @public
+ */
+class ShallowCloneError extends _CloneError_mjs__WEBPACK_IMPORTED_MODULE_0__["default"] {}
+/* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (ShallowCloneError);
+
+/***/ },
+
+/***/ 2111
+(__unused_webpack___webpack_module__, __webpack_exports__, __webpack_require__) {
+
+"use strict";
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   CloneError: () => (/* reexport safe */ _errors_CloneError_mjs__WEBPACK_IMPORTED_MODULE_8__["default"]),
+/* harmony export */   DeepCloneError: () => (/* reexport safe */ _errors_DeepCloneError_mjs__WEBPACK_IMPORTED_MODULE_6__["default"]),
+/* harmony export */   ShallowCloneError: () => (/* reexport safe */ _errors_ShallowCloneError_mjs__WEBPACK_IMPORTED_MODULE_7__["default"]),
+/* harmony export */   cloneDeep: () => (/* binding */ cloneDeep),
+/* harmony export */   cloneShallow: () => (/* binding */ cloneShallow)
+/* harmony export */ });
+/* harmony import */ var ramda__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(8138);
+/* harmony import */ var _ObjectSlice_mjs__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(8504);
+/* harmony import */ var _KeyValuePair_mjs__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(6663);
+/* harmony import */ var _predicates_index_mjs__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(8252);
+/* harmony import */ var _predicates_index_mjs__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(5162);
+/* harmony import */ var _elements_SourceMap_mjs__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(5810);
+/* harmony import */ var _errors_DeepCloneError_mjs__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(5018);
+/* harmony import */ var _errors_ShallowCloneError_mjs__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(3686);
+/* harmony import */ var _errors_CloneError_mjs__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(3772);
+
+
+
+
+
+
+
+/**
+ * @public
+ */
+/**
+ * @public
+ */
+const cloneDeepElement = (element, options) => {
+  const {
+    visited = new WeakMap()
+  } = options;
+  const passThroughOptions = {
+    ...options,
+    visited
+  };
+
+  // detect cycle and return memoized value
+  if (visited.has(element)) {
+    return visited.get(element);
+  }
+  const copy = cloneShallowElement(element);
+  visited.set(element, copy);
+  const {
+    content
+  } = element;
+  if (Array.isArray(content)) {
+    copy.content = content.map(el => cloneDeepElement(el, passThroughOptions));
+  } else if ((0,_predicates_index_mjs__WEBPACK_IMPORTED_MODULE_4__.isElement)(content)) {
+    copy.content = cloneDeepElement(content, passThroughOptions);
+  } else if (content instanceof _KeyValuePair_mjs__WEBPACK_IMPORTED_MODULE_2__["default"]) {
+    copy.content = cloneDeepKeyValuePair(content, passThroughOptions);
+  } else {
+    copy.content = content;
+  }
+  return copy;
+};
+const cloneDeepKeyValuePair = (kvp, options) => {
+  const {
+    visited = new WeakMap()
+  } = options;
+  const passThroughOptions = {
+    ...options,
+    visited
+  };
+  if (visited.has(kvp)) {
+    return visited.get(kvp);
+  }
+  const {
+    key,
+    value
+  } = kvp;
+  const keyCopy = key !== undefined ? cloneDeepElement(key, passThroughOptions) : undefined;
+  const valueCopy = value !== undefined ? cloneDeepElement(value, passThroughOptions) : undefined;
+  const copy = new _KeyValuePair_mjs__WEBPACK_IMPORTED_MODULE_2__["default"](keyCopy, valueCopy);
+  visited.set(kvp, copy);
+  return copy;
+};
+const cloneDeepObjectSlice = (slice, options) => {
+  const {
+    visited = new WeakMap()
+  } = options;
+  const passThroughOptions = {
+    ...options,
+    visited
+  };
+  if (visited.has(slice)) {
+    return visited.get(slice);
+  }
+  const items = [...slice].map(element => cloneDeepElement(element, passThroughOptions));
+  const copy = new _ObjectSlice_mjs__WEBPACK_IMPORTED_MODULE_1__["default"](items);
+  visited.set(slice, copy);
+  return copy;
+};
+
+/**
+ * Creates a deep clone of an ApiDOM Element, KeyValuePair, or ObjectSlice.
+ * Handles cycles by memoizing visited objects.
+ * @public
+ */
+const cloneDeep = (value, options = {}) => {
+  if (value instanceof _KeyValuePair_mjs__WEBPACK_IMPORTED_MODULE_2__["default"]) {
+    return cloneDeepKeyValuePair(value, options);
+  }
+  if (value instanceof _ObjectSlice_mjs__WEBPACK_IMPORTED_MODULE_1__["default"]) {
+    return cloneDeepObjectSlice(value, options);
+  }
+  if ((0,_predicates_index_mjs__WEBPACK_IMPORTED_MODULE_4__.isElement)(value)) {
+    return cloneDeepElement(value, options);
+  }
+  throw new _errors_DeepCloneError_mjs__WEBPACK_IMPORTED_MODULE_6__["default"]("Value provided to cloneDeep function couldn't be cloned", {
+    value
+  });
+};
+cloneDeep.safe = value => {
+  try {
+    return cloneDeep(value);
+  } catch {
+    return value;
+  }
+};
+const cloneShallowKeyValuePair = keyValuePair => {
+  const {
+    key,
+    value
+  } = keyValuePair;
+  return new _KeyValuePair_mjs__WEBPACK_IMPORTED_MODULE_2__["default"](key, value);
+};
+const cloneShallowObjectSlice = objectSlice => {
+  const items = [...objectSlice];
+  return new _ObjectSlice_mjs__WEBPACK_IMPORTED_MODULE_1__["default"](items);
+};
+const cloneShallowElement = element => {
+  const Ctor = element.constructor;
+  const copy = new Ctor();
+  copy.element = element.element;
+  if (!element.isMetaEmpty) {
+    copy.meta = element.meta.cloneDeep();
+  }
+  if (!element.isAttributesEmpty) {
+    copy.attributes = cloneDeep(element.attributes);
+  }
+  if ((0,_predicates_index_mjs__WEBPACK_IMPORTED_MODULE_3__.hasElementSourceMap)(element)) {
+    _elements_SourceMap_mjs__WEBPACK_IMPORTED_MODULE_5__["default"].transfer(element, copy);
+  }
+  if ((0,_predicates_index_mjs__WEBPACK_IMPORTED_MODULE_3__.hasElementStyle)(element)) {
+    copy.style = (0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])(element.style);
+  }
+  const {
+    content
+  } = element;
+  if ((0,_predicates_index_mjs__WEBPACK_IMPORTED_MODULE_4__.isElement)(content)) {
+    copy.content = cloneShallowElement(content);
+  } else if (Array.isArray(content)) {
+    copy.content = [...content];
+  } else if (content instanceof _KeyValuePair_mjs__WEBPACK_IMPORTED_MODULE_2__["default"]) {
+    copy.content = cloneShallowKeyValuePair(content);
+  } else {
+    copy.content = content;
+  }
+  return copy;
+};
+
+/**
+ * Creates a shallow clone of an ApiDOM Element, KeyValuePair, or ObjectSlice.
+ * The element itself is cloned, but content references are shared.
+ * Meta and attributes are deep cloned to preserve semantic information.
+ * @public
+ */
+const cloneShallow = value => {
+  if (value instanceof _KeyValuePair_mjs__WEBPACK_IMPORTED_MODULE_2__["default"]) {
+    return cloneShallowKeyValuePair(value);
+  }
+  if (value instanceof _ObjectSlice_mjs__WEBPACK_IMPORTED_MODULE_1__["default"]) {
+    return cloneShallowObjectSlice(value);
+  }
+  if ((0,_predicates_index_mjs__WEBPACK_IMPORTED_MODULE_4__.isElement)(value)) {
+    return cloneShallowElement(value);
+  }
+  throw new _errors_ShallowCloneError_mjs__WEBPACK_IMPORTED_MODULE_7__["default"]("Value provided to cloneShallow function couldn't be cloned", {
+    value
+  });
+};
+cloneShallow.safe = value => {
+  try {
+    return cloneShallow(value);
+  } catch {
+    return value;
+  }
+};
+
+
+
+
 /***/ },
 
 /***/ 4660
@@ -6618,7 +7174,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;
   }
 
   /**
@@ -6648,18 +7204,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__(3654);
-/* harmony import */ var _KeyValuePair_mjs__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(6663);
-/* harmony import */ var _ObjectSlice_mjs__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(8504);
+/* harmony import */ var _Metadata_mjs__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(1844);
+/* harmony import */ var _KeyValuePair_mjs__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(6663);
+/* harmony import */ var _ObjectSlice_mjs__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(8504);
 
 
 
+ // 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.
  *
@@ -6757,7 +7319,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.
   // ============================================================
@@ -6818,13 +7380,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;
     }
@@ -6845,24 +7407,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;
     }
   }
 
@@ -6895,10 +7455,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');
@@ -6909,10 +7467,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');
@@ -6923,11 +7479,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');
   }
@@ -6947,7 +7505,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);
@@ -6977,7 +7535,6 @@ class Element {
 
     // Freeze meta and attributes
     if (this._meta) {
-      this._meta.parent = this;
       this._meta.freeze();
     }
     if (this._attributes) {
@@ -7012,7 +7569,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)) {
@@ -7068,7 +7625,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');
     }
@@ -7080,26 +7637,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);
   }
@@ -7112,20 +7659,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;
   }
 
   /**
@@ -7151,7 +7695,7 @@ class Element {
   }
 
   /**
-   * Has attributes property.
+   * Checks whether an attributes property exists.
    */
   hasAttributesProperty(name) {
     if (!this.isAttributesEmpty) {
@@ -7170,6 +7714,7 @@ class Element {
 
 // Re-export types for convenience
 
+
 /* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (Element);
 
 /***/ },
@@ -7608,6 +8153,10 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var _elements_Style_mjs__WEBPACK_IMPORTED_MODULE_15__ = __webpack_require__(9686);
 /* harmony import */ var _ObjectSlice_mjs__WEBPACK_IMPORTED_MODULE_16__ = __webpack_require__(8504);
 /* harmony import */ var _KeyValuePair_mjs__WEBPACK_IMPORTED_MODULE_17__ = __webpack_require__(6663);
+/* harmony import */ var _Metadata_mjs__WEBPACK_IMPORTED_MODULE_18__ = __webpack_require__(1844);
+/* harmony import */ var _clone_index_mjs__WEBPACK_IMPORTED_MODULE_19__ = __webpack_require__(2111);
+
+
 
 
 
@@ -7667,14 +8216,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
@@ -7739,7 +8290,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);
@@ -7786,7 +8343,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;
@@ -7800,8 +8357,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__
@@ -7864,6 +8428,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) => {
@@ -7940,6 +8525,36 @@ class ApiDOMError extends Error {
 
 /***/ },
 
+/***/ 4641
+(__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 _ApiDOMError_mjs__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(6126);
+
+/**
+ * @public
+ */
+class ApiDOMStructuredError extends _ApiDOMError_mjs__WEBPACK_IMPORTED_MODULE_0__["default"] {
+  constructor(message, structuredOptions) {
+    super(message, structuredOptions);
+    if (structuredOptions != null && typeof structuredOptions === 'object') {
+      // eslint-disable-next-line @typescript-eslint/no-unused-vars
+      const {
+        cause,
+        ...causelessOptions
+      } = structuredOptions;
+      Object.assign(this, causelessOptions);
+    }
+  }
+}
+/* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (ApiDOMStructuredError);
+
+/***/ },
+
 /***/ 8397
 (__unused_webpack___webpack_module__, __webpack_exports__, __webpack_require__) {