@speclynx/apidom-core 2.10.3 → 2.12.0

package/dist/apidom-core.browser.js

@@ -28,6 +28,10 @@ __webpack_require__.r(__webpack_exports__);
  * @public
  */
 
+/**
+ * @public
+ */
+
 /**
  * Returns the fixed fields for an Element class or instance.
  *
@@ -634,6 +638,7 @@ const predicates = {
   isCommentElement: _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.isCommentElement,
   isParseResultElement: _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.isParseResultElement,
   isSourceMapElement: _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.isSourceMapElement,
+  hasElementStyle: _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__.hasElementStyle,
   hasElementSourceMap: _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__.hasElementSourceMap,
   includesSymbols: _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__.includesSymbols,
   includesClasses: _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__.includesClasses
@@ -704,7 +709,19 @@ const resolveSpecification = specification => {
       if ((0,ramda_adjunct__WEBPACK_IMPORTED_MODULE_5__["default"])(val) && (0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])('$ref', val) && (0,ramda__WEBPACK_IMPORTED_MODULE_3__["default"])(ramda_adjunct__WEBPACK_IMPORTED_MODULE_4__["default"], '$ref', val)) {
         const $ref = (0,ramda__WEBPACK_IMPORTED_MODULE_2__["default"])(['$ref'], val);
         const pointer = (0,ramda_adjunct__WEBPACK_IMPORTED_MODULE_6__["default"])('#/', $ref);
-        return (0,ramda__WEBPACK_IMPORTED_MODULE_2__["default"])(pointer.split('/'), root);
+        const resolved = (0,ramda__WEBPACK_IMPORTED_MODULE_2__["default"])(pointer.split('/'), root);
+        // merge extra properties (e.g. alias) from the $ref object into the resolved value
+        const {
+          $ref: _,
+          ...rest
+        } = val;
+        if (Object.keys(rest).length > 0 && (0,ramda_adjunct__WEBPACK_IMPORTED_MODULE_5__["default"])(resolved)) {
+          return {
+            ...resolved,
+            ...rest
+          };
+        }
+        return resolved;
       }
       if ((0,ramda_adjunct__WEBPACK_IMPORTED_MODULE_5__["default"])(val)) {
         return traverse(val, root, newPath);
@@ -938,13 +955,78 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
 /* harmony export */   "default": () => (__WEBPACK_DEFAULT_EXPORT__)
 /* harmony export */ });
-/* harmony import */ var _value_ts__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(1811);
+/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(5162);
+/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(6911);
+/* harmony import */ var _value_ts__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(1811);
+
 
+const getStyle = element => {
+  return element.style?.json ?? {};
+};
 
 /**
  * @public
  */
-const serializer = (element, replacer, space) => JSON.stringify((0,_value_ts__WEBPACK_IMPORTED_MODULE_0__["default"])(element), replacer, space);
+
+/**
+ * Builds a POJO from an ApiDOM element tree. Numbers with rawContent
+ * are replaced with sentinel strings; all other values go through toValue().
+ */
+const toPojo = (element, sentinels) => {
+  const visited = new WeakSet();
+  const convert = node => {
+    if (!(0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__.isElement)(node)) return node;
+    if (visited.has(node)) return null;
+    visited.add(node);
+    if ((0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__.isObjectElement)(node)) {
+      const obj = {};
+      node.forEach((value, key) => {
+        const k = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__.isElement)(key) ? (0,_value_ts__WEBPACK_IMPORTED_MODULE_2__["default"])(key) : key;
+        if (typeof k === 'string') obj[k] = convert(value);
+      });
+      return obj;
+    }
+    if ((0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__.isArrayElement)(node)) {
+      const arr = [];
+      node.forEach(item => arr.push(convert(item)));
+      return arr;
+    }
+    if ((0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.isRefElement)(node)) return String((0,_value_ts__WEBPACK_IMPORTED_MODULE_2__["default"])(node));
+    if ((0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.isLinkElement)(node)) return (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__.isStringElement)(node.href) ? (0,_value_ts__WEBPACK_IMPORTED_MODULE_2__["default"])(node.href) : '';
+
+    // number with rawContent — substitute with sentinel
+    if ((0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__.isNumberElement)(node)) {
+      const style = getStyle(node);
+      if (typeof style.rawContent === 'string') {
+        const sentinel = `\0RAW${sentinels.size}\0`;
+        sentinels.set(sentinel, style.rawContent);
+        return sentinel;
+      }
+    }
+    return (0,_value_ts__WEBPACK_IMPORTED_MODULE_2__["default"])(node);
+  };
+  return convert(element);
+};
+
+/**
+ * @public
+ */
+const serializer = (element, replacer, space, options) => {
+  if (options?.preserveStyle) {
+    const style = getStyle(element);
+    const indent = typeof space === 'number' ? space : typeof style.indent === 'number' ? style.indent : 0;
+    const sentinels = new Map();
+    const pojo = toPojo(element, sentinels);
+    let serialized = JSON.stringify(pojo, null, indent);
+
+    // replace quoted sentinels with raw number representations
+    for (const [sentinel, raw] of sentinels) {
+      serialized = serialized.replace(JSON.stringify(sentinel), raw);
+    }
+    return serialized;
+  }
+  return JSON.stringify((0,_value_ts__WEBPACK_IMPORTED_MODULE_2__["default"])(element), replacer, space);
+};
 /* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (serializer);
 
 /***/ },
@@ -1016,19 +1098,115 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   "default": () => (__WEBPACK_DEFAULT_EXPORT__)
 /* harmony export */ });
 /* harmony import */ var yaml__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(3291);
-/* harmony import */ var _value_ts__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(1811);
+/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(5162);
+/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(6911);
+/* harmony import */ var _value_ts__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(1811);
+
 
 
+const getStyle = element => {
+  return element.style?.yaml ?? {};
+};
+
+// map our scalarStyle strings to YAML library Scalar.Type constants
+const scalarStyleMap = {
+  Plain: yaml__WEBPACK_IMPORTED_MODULE_0__.Scalar.PLAIN,
+  SingleQuoted: yaml__WEBPACK_IMPORTED_MODULE_0__.Scalar.QUOTE_SINGLE,
+  DoubleQuoted: yaml__WEBPACK_IMPORTED_MODULE_0__.Scalar.QUOTE_DOUBLE,
+  Literal: yaml__WEBPACK_IMPORTED_MODULE_0__.Scalar.BLOCK_LITERAL,
+  Folded: yaml__WEBPACK_IMPORTED_MODULE_0__.Scalar.BLOCK_FOLDED
+};
+
+// the YAML library prefixes comments with '#' only (no space), so we add ' ' to get '# comment'
+const applyComments = (node, style) => {
+  if (style.comment) node.comment = ` ${style.comment}`;
+  if (style.commentBefore) node.commentBefore = ` ${style.commentBefore}`;
+};
 
 /**
  * @public
  */
 
+/**
+ * Converts an ApiDOM element tree to YAML library AST nodes,
+ * preserving style information from `element.style.yaml`.
+ */
+const toYAMLNode = (element, visited) => {
+  if (!(0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.isElement)(element)) return element;
+
+  // cycle detection
+  if (visited.has(element)) return undefined;
+  visited.add(element);
+  const style = getStyle(element);
+  if ((0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.isObjectElement)(element)) {
+    const map = new yaml__WEBPACK_IMPORTED_MODULE_0__.YAMLMap();
+    map.flow = style.styleGroup === 'Flow';
+    applyComments(map, style);
+    element.forEach((value, key, member) => {
+      const memberStyle = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.isMemberElement)(member) ? getStyle(member) : {};
+      const keyNode = toYAMLNode(key, visited);
+      const valueNode = toYAMLNode(value, visited);
+      const pair = new yaml__WEBPACK_IMPORTED_MODULE_0__.Pair(keyNode, valueNode);
+      if (memberStyle.commentBefore && (0,yaml__WEBPACK_IMPORTED_MODULE_0__.isNode)(keyNode)) {
+        keyNode.commentBefore = ` ${memberStyle.commentBefore}`;
+      }
+      if (memberStyle.comment && (0,yaml__WEBPACK_IMPORTED_MODULE_0__.isNode)(valueNode)) {
+        valueNode.comment = ` ${memberStyle.comment}`;
+      }
+      map.items.push(pair);
+    });
+    return map;
+  }
+  if ((0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.isArrayElement)(element)) {
+    const seq = new yaml__WEBPACK_IMPORTED_MODULE_0__.YAMLSeq();
+    seq.flow = style.styleGroup === 'Flow';
+    applyComments(seq, style);
+    element.forEach(item => {
+      seq.items.push(toYAMLNode(item, visited));
+    });
+    return seq;
+  }
+  if ((0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__.isRefElement)(element)) {
+    return new yaml__WEBPACK_IMPORTED_MODULE_0__.Scalar(String((0,_value_ts__WEBPACK_IMPORTED_MODULE_3__["default"])(element)));
+  }
+  if ((0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__.isLinkElement)(element)) {
+    return new yaml__WEBPACK_IMPORTED_MODULE_0__.Scalar((0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.isStringElement)(element.href) ? (0,_value_ts__WEBPACK_IMPORTED_MODULE_3__["default"])(element.href) : '');
+  }
+
+  // scalar element (string, number, boolean, null)
+  const scalarType = style.scalarStyle ? scalarStyleMap[style.scalarStyle] : undefined;
+  const scalar = new yaml__WEBPACK_IMPORTED_MODULE_0__.Scalar((0,_value_ts__WEBPACK_IMPORTED_MODULE_3__["default"])(element));
+  if (scalarType) {
+    scalar.type = scalarType;
+  }
+
+  // use rawContent to infer YAML library format hints for plain scalars that resolved to numbers;
+  // only applies to Plain style — quoted scalars are always strings in YAML.
+  // note: the YAML library may normalize the representation (e.g. 1.0e10 -> 1e+10, 0x1A -> 0x1a)
+  // while preserving the format category (exponential, hex, octal, fractional digits)
+  if (style.rawContent && style.scalarStyle === 'Plain' && typeof scalar.value === 'number') {
+    if (/[eE]/.test(style.rawContent)) {
+      scalar.format = 'EXP';
+    } else if (/^0x/i.test(style.rawContent)) {
+      scalar.format = 'HEX';
+    } else if (/^0o/i.test(style.rawContent)) {
+      scalar.format = 'OCT';
+    }
+    const dotMatch = style.rawContent.match(/\.(\d+)/);
+    if (dotMatch) {
+      scalar.minFractionDigits = dotMatch[1].length;
+    }
+  }
+  applyComments(scalar, style);
+  return scalar;
+};
+
 /**
  * @public
  */
 const serializer = (element, {
   directive = false,
+  preserveStyle = false,
   aliasDuplicateObjects = false,
   ...options
 } = {}) => {
@@ -1036,12 +1214,28 @@ const serializer = (element, {
     aliasDuplicateObjects,
     ...options
   };
+  if (preserveStyle) {
+    const style = getStyle(element);
+    if (options.indent === undefined && typeof style.indent === 'number') {
+      allOptions.indent = style.indent;
+    }
+    if (typeof style.flowCollectionPadding === 'boolean') {
+      allOptions.flowCollectionPadding = style.flowCollectionPadding;
+    }
+    const rootNode = toYAMLNode(element, new WeakSet());
+    const doc = new yaml__WEBPACK_IMPORTED_MODULE_0__.Document(undefined, allOptions);
+    doc.contents = rootNode;
+    if (directive) {
+      doc.directives.yaml.explicit = true;
+    }
+    return doc.toString(allOptions);
+  }
   if (directive) {
-    const doc = new yaml__WEBPACK_IMPORTED_MODULE_0__.Document((0,_value_ts__WEBPACK_IMPORTED_MODULE_1__["default"])(element), allOptions);
+    const doc = new yaml__WEBPACK_IMPORTED_MODULE_0__.Document((0,_value_ts__WEBPACK_IMPORTED_MODULE_3__["default"])(element), allOptions);
     doc.directives.yaml.explicit = true;
     return doc.toString(allOptions);
   }
-  return (0,yaml__WEBPACK_IMPORTED_MODULE_0__.stringify)((0,_value_ts__WEBPACK_IMPORTED_MODULE_1__["default"])(element), allOptions);
+  return (0,yaml__WEBPACK_IMPORTED_MODULE_0__.stringify)((0,_value_ts__WEBPACK_IMPORTED_MODULE_3__["default"])(element), allOptions);
 };
 /* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (serializer);
 
@@ -11809,6 +12003,52 @@ var both = /*#__PURE__*/(0,_internal_curry2_js__WEBPACK_IMPORTED_MODULE_0__["def
 
 /***/ },
 
+/***/ 8138
+(__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 _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);
+
+/***/ },
+
 /***/ 1323
 (__unused_webpack___webpack_module__, __webpack_exports__, __webpack_require__) {
 
@@ -12719,6 +12959,144 @@ function _checkForMethod(methodname, fn) {
 
 /***/ },
 
+/***/ 8575
+(__unused_webpack___webpack_module__, __webpack_exports__, __webpack_require__) {
+
+__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__) {
+
+__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' : ''));
+}
+
+/***/ },
+
 /***/ 7940
 (__unused_webpack___webpack_module__, __webpack_exports__, __webpack_require__) {
 
@@ -24908,20 +25286,22 @@ class ShallowCloneError extends _CloneError_mjs__WEBPACK_IMPORTED_MODULE_0__["de
 
 __webpack_require__.r(__webpack_exports__);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
-/* harmony export */   CloneError: () => (/* reexport safe */ _errors_CloneError_mjs__WEBPACK_IMPORTED_MODULE_7__["default"]),
-/* harmony export */   DeepCloneError: () => (/* reexport safe */ _errors_DeepCloneError_mjs__WEBPACK_IMPORTED_MODULE_5__["default"]),
-/* harmony export */   ShallowCloneError: () => (/* reexport safe */ _errors_ShallowCloneError_mjs__WEBPACK_IMPORTED_MODULE_6__["default"]),
+/* 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 _ObjectSlice_mjs__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(8504);
-/* harmony import */ var _KeyValuePair_mjs__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(6663);
-/* harmony import */ var _predicates_index_mjs__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(8252);
-/* harmony import */ var _predicates_index_mjs__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(5162);
-/* harmony import */ var _elements_SourceMap_mjs__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(5810);
-/* harmony import */ var _errors_DeepCloneError_mjs__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(5018);
-/* harmony import */ var _errors_ShallowCloneError_mjs__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(3686);
-/* harmony import */ var _errors_CloneError_mjs__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(3772);
+/* 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);
+
 
 
 
@@ -24954,9 +25334,9 @@ const cloneDeepElement = (element, options) => {
   } = element;
   if (Array.isArray(content)) {
     copy.content = content.map(el => cloneDeepElement(el, passThroughOptions));
-  } else if ((0,_predicates_index_mjs__WEBPACK_IMPORTED_MODULE_3__.isElement)(content)) {
+  } 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_1__["default"]) {
+  } else if (content instanceof _KeyValuePair_mjs__WEBPACK_IMPORTED_MODULE_2__["default"]) {
     copy.content = cloneDeepKeyValuePair(content, passThroughOptions);
   } else {
     copy.content = content;
@@ -24980,7 +25360,7 @@ const cloneDeepKeyValuePair = (kvp, options) => {
   } = 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_1__["default"](keyCopy, valueCopy);
+  const copy = new _KeyValuePair_mjs__WEBPACK_IMPORTED_MODULE_2__["default"](keyCopy, valueCopy);
   visited.set(kvp, copy);
   return copy;
 };
@@ -24996,7 +25376,7 @@ const cloneDeepObjectSlice = (slice, options) => {
     return visited.get(slice);
   }
   const items = [...slice].map(element => cloneDeepElement(element, passThroughOptions));
-  const copy = new _ObjectSlice_mjs__WEBPACK_IMPORTED_MODULE_0__["default"](items);
+  const copy = new _ObjectSlice_mjs__WEBPACK_IMPORTED_MODULE_1__["default"](items);
   visited.set(slice, copy);
   return copy;
 };
@@ -25007,16 +25387,16 @@ const cloneDeepObjectSlice = (slice, options) => {
  * @public
  */
 const cloneDeep = (value, options = {}) => {
-  if (value instanceof _KeyValuePair_mjs__WEBPACK_IMPORTED_MODULE_1__["default"]) {
+  if (value instanceof _KeyValuePair_mjs__WEBPACK_IMPORTED_MODULE_2__["default"]) {
     return cloneDeepKeyValuePair(value, options);
   }
-  if (value instanceof _ObjectSlice_mjs__WEBPACK_IMPORTED_MODULE_0__["default"]) {
+  if (value instanceof _ObjectSlice_mjs__WEBPACK_IMPORTED_MODULE_1__["default"]) {
     return cloneDeepObjectSlice(value, options);
   }
-  if ((0,_predicates_index_mjs__WEBPACK_IMPORTED_MODULE_3__.isElement)(value)) {
+  if ((0,_predicates_index_mjs__WEBPACK_IMPORTED_MODULE_4__.isElement)(value)) {
     return cloneDeepElement(value, options);
   }
-  throw new _errors_DeepCloneError_mjs__WEBPACK_IMPORTED_MODULE_5__["default"]("Value provided to cloneDeep function couldn't be cloned", {
+  throw new _errors_DeepCloneError_mjs__WEBPACK_IMPORTED_MODULE_6__["default"]("Value provided to cloneDeep function couldn't be cloned", {
     value
   });
 };
@@ -25032,11 +25412,11 @@ const cloneShallowKeyValuePair = keyValuePair => {
     key,
     value
   } = keyValuePair;
-  return new _KeyValuePair_mjs__WEBPACK_IMPORTED_MODULE_1__["default"](key, value);
+  return new _KeyValuePair_mjs__WEBPACK_IMPORTED_MODULE_2__["default"](key, value);
 };
 const cloneShallowObjectSlice = objectSlice => {
   const items = [...objectSlice];
-  return new _ObjectSlice_mjs__WEBPACK_IMPORTED_MODULE_0__["default"](items);
+  return new _ObjectSlice_mjs__WEBPACK_IMPORTED_MODULE_1__["default"](items);
 };
 const cloneShallowElement = element => {
   const Ctor = element.constructor;
@@ -25048,17 +25428,20 @@ const cloneShallowElement = element => {
   if (!element.isAttributesEmpty) {
     copy.attributes = cloneDeep(element.attributes);
   }
-  if ((0,_predicates_index_mjs__WEBPACK_IMPORTED_MODULE_2__.hasElementSourceMap)(element)) {
-    _elements_SourceMap_mjs__WEBPACK_IMPORTED_MODULE_4__["default"].transfer(element, copy);
+  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_3__.isElement)(content)) {
+  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_1__["default"]) {
+  } else if (content instanceof _KeyValuePair_mjs__WEBPACK_IMPORTED_MODULE_2__["default"]) {
     copy.content = cloneShallowKeyValuePair(content);
   } else {
     copy.content = content;
@@ -25073,16 +25456,16 @@ const cloneShallowElement = element => {
  * @public
  */
 const cloneShallow = value => {
-  if (value instanceof _KeyValuePair_mjs__WEBPACK_IMPORTED_MODULE_1__["default"]) {
+  if (value instanceof _KeyValuePair_mjs__WEBPACK_IMPORTED_MODULE_2__["default"]) {
     return cloneShallowKeyValuePair(value);
   }
-  if (value instanceof _ObjectSlice_mjs__WEBPACK_IMPORTED_MODULE_0__["default"]) {
+  if (value instanceof _ObjectSlice_mjs__WEBPACK_IMPORTED_MODULE_1__["default"]) {
     return cloneShallowObjectSlice(value);
   }
-  if ((0,_predicates_index_mjs__WEBPACK_IMPORTED_MODULE_3__.isElement)(value)) {
+  if ((0,_predicates_index_mjs__WEBPACK_IMPORTED_MODULE_4__.isElement)(value)) {
     return cloneShallowElement(value);
   }
-  throw new _errors_ShallowCloneError_mjs__WEBPACK_IMPORTED_MODULE_6__["default"]("Value provided to cloneShallow function couldn't be cloned", {
+  throw new _errors_ShallowCloneError_mjs__WEBPACK_IMPORTED_MODULE_7__["default"]("Value provided to cloneShallow function couldn't be cloned", {
     value
   });
 };
@@ -25503,6 +25886,65 @@ function unpackSourceMap(packed) {
 
 /***/ },
 
+/***/ 9686
+(__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 _primitives_ObjectElement_mjs__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(7071);
+
+/**
+ * Shape with optional style property.
+ * @public
+ */
+/**
+ * StyleElement stores format-specific style information for round-trip preservation.
+ *
+ * The style data is stored as a plain object with format-specific namespaces
+ * (e.g., `yaml`, `json`). This element exists only during serialization/deserialization
+ * (refract format) - in memory, style lives directly on `element.style`.
+ *
+ * Follows the same pattern as SourceMapElement with __mappings__.
+ *
+ * @public
+ */
+class StyleElement extends _primitives_ObjectElement_mjs__WEBPACK_IMPORTED_MODULE_0__["default"] {
+  constructor(content, meta, attributes) {
+    super(content, meta, attributes);
+    this.element = '__styles__';
+  }
+
+  /**
+   * Transfers style property from one element to another.
+   */
+  static transfer(from, to) {
+    to.style = from.style;
+  }
+
+  /**
+   * Creates a StyleElement from an element's style property.
+   * Returns undefined if the element has no style.
+   */
+  static from(source) {
+    if (!source.style) {
+      return undefined;
+    }
+    return new StyleElement(source.style);
+  }
+
+  /**
+   * Restores the style property on the target element from this StyleElement.
+   */
+  applyTo(target) {
+    target.style = this.toValue();
+  }
+}
+/* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (StyleElement);
+
+/***/ },
+
 /***/ 6911
 (__unused_webpack___webpack_module__, __webpack_exports__, __webpack_require__) {
 
@@ -25565,6 +26007,7 @@ const isSourceMapElement = element => element instanceof _elements_SourceMap_mjs
 __webpack_require__.r(__webpack_exports__);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
 /* harmony export */   hasElementSourceMap: () => (/* binding */ hasElementSourceMap),
+/* harmony export */   hasElementStyle: () => (/* binding */ hasElementStyle),
 /* harmony export */   includesClasses: () => (/* binding */ includesClasses),
 /* harmony export */   includesSymbols: () => (/* binding */ includesSymbols),
 /* harmony export */   isAnnotationElement: () => (/* reexport safe */ _elements_mjs__WEBPACK_IMPORTED_MODULE_1__.isAnnotationElement),
@@ -25589,6 +26032,14 @@ __webpack_require__.r(__webpack_exports__);
 
 
 
+/**
+ * Checks if an element has format-specific style information.
+ * @public
+ */
+const hasElementStyle = element => {
+  return element.style !== undefined;
+};
+
 /**
  * Checks if an element has complete source position information.
  * Returns true only if all 6 position properties are numbers.
@@ -26125,6 +26576,12 @@ class Element {
    */
   parent;
 
+  /**
+   * Format-specific style information for round-trip preservation.
+   * Each format owns its own namespace (e.g., `yaml`, `json`).
+   */
+  style;
+
   // ============================================================================
   // Source Position (LSP-compatible, TextDocument-compatible, UTF-16 code units)
   // web-tree-sitter automatically provides position data in UTF-16 code units.
@@ -26333,7 +26790,13 @@ class Element {
 
   /** Unique identifier for this element. */
   get id() {
-    return this.getMetaProperty('id', '');
+    if (this.isFrozen) {
+      return this.getMetaProperty('id', '');
+    }
+    if (!this.hasMetaProperty('id')) {
+      this.setMetaProperty('id', '');
+    }
+    return this.meta.get('id');
   }
   set id(value) {
     this.setMetaProperty('id', value);
@@ -26341,7 +26804,13 @@ class Element {
 
   /** CSS-like class names. */
   get classes() {
-    return this.getMetaProperty('classes', []);
+    if (this.isFrozen) {
+      return this.getMetaProperty('classes', []);
+    }
+    if (!this.hasMetaProperty('classes')) {
+      this.setMetaProperty('classes', []);
+    }
+    return this.meta.get('classes');
   }
   set classes(value) {
     this.setMetaProperty('classes', value);
@@ -26349,7 +26818,13 @@ class Element {
 
   /** Hyperlinks associated with this element. */
   get links() {
-    return this.getMetaProperty('links', []);
+    if (this.isFrozen) {
+      return this.getMetaProperty('links', []);
+    }
+    if (!this.hasMetaProperty('links')) {
+      this.setMetaProperty('links', []);
+    }
+    return this.meta.get('links');
   }
   set links(value) {
     this.setMetaProperty('links', value);
@@ -26500,16 +26975,26 @@ class Element {
   }
 
   /**
-   * Gets a meta property, creating it with default value if not present.
+   * Gets a meta property.
+   *
+   * When the property doesn't exist:
+   * - With defaultValue: returns a new refracted element instance (not cached)
+   * - 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.meta.hasKey(name)) {
-      if (this.isFrozen) {
-        const element = this.refract(defaultValue);
+    if (!this.hasMetaProperty(name)) {
+      if (defaultValue === undefined) {
+        return undefined;
+      }
+      const element = this.refract(defaultValue);
+      if (element && this.isFrozen) {
         element.freeze();
-        return element;
       }
-      this.meta.set(name, defaultValue);
+      return element;
     }
     return this.meta.get(name);
   }
@@ -26977,6 +27462,8 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   "default": () => (__WEBPACK_DEFAULT_EXPORT__)
 /* harmony export */ });
 /* harmony import */ var _elements_SourceMap_mjs__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(5810);
+/* harmony import */ var _elements_Style_mjs__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(9686);
+
 
 /**
  * Serialized representation of an Element in JSON Refract format.
@@ -27035,6 +27522,17 @@ class JSONSerialiser {
         payload.meta.__mappings__ = this.serialise(sourceMap);
       }
     }
+
+    // Serialize style as __styles__ in meta (skip for StyleElement itself)
+    if (!(element instanceof _elements_Style_mjs__WEBPACK_IMPORTED_MODULE_1__["default"])) {
+      const styleElement = _elements_Style_mjs__WEBPACK_IMPORTED_MODULE_1__["default"].from(element);
+      if (styleElement) {
+        if (!payload.meta) {
+          payload.meta = {};
+        }
+        payload.meta.__styles__ = this.serialise(styleElement);
+      }
+    }
     const content = this.serialiseContent(element.content);
     if (content !== undefined) {
       payload.content = content;
@@ -27055,15 +27553,18 @@ class JSONSerialiser {
       element.element = value.element;
     }
 
-    // Extract __mappings__ without mutating input, filter remaining meta
+    // Extract __mappings__ and __styles__ without mutating input, filter remaining meta
     let mappingsDoc;
+    let stylesDoc;
     let metaToDeserialize = value.meta;
-    if (value.meta?.__mappings__) {
+    if (value.meta?.__mappings__ || value.meta?.__styles__) {
       const {
         __mappings__,
+        __styles__,
         ...rest
       } = value.meta;
       mappingsDoc = __mappings__;
+      stylesDoc = __styles__;
       metaToDeserialize = Object.keys(rest).length > 0 ? rest : undefined;
     }
     if (metaToDeserialize) {
@@ -27075,6 +27576,12 @@ class JSONSerialiser {
       const sourceMap = this.deserialise(mappingsDoc);
       sourceMap.applyTo(element);
     }
+
+    // Restore style from __styles__
+    if (stylesDoc) {
+      const styleElement = this.deserialise(stylesDoc);
+      styleElement.applyTo(element);
+    }
     if (value.attributes) {
       this.deserialiseObject(value.attributes, element.attributes);
     }