@speclynx/apidom-reference 2.11.0 → 2.12.0

package/dist/apidom-reference.browser.js

@@ -5654,6 +5654,11 @@ class Parser {
    */
   sourceMap;
 
+  /**
+   * Whether to capture format-specific style information for round-trip preservation.
+   */
+  style;
+
   /**
    * Whether to use strict parsing (native JSON.parse/YAML instead of tree-sitter).
    */
@@ -5672,6 +5677,7 @@ class Parser {
     name,
     allowEmpty = true,
     sourceMap = false,
+    style = false,
     strict = true,
     fileExtensions = [],
     mediaTypes = []
@@ -5679,6 +5685,7 @@ class Parser {
     this.name = name;
     this.allowEmpty = allowEmpty;
     this.sourceMap = sourceMap;
+    this.style = style;
     this.strict = strict;
     this.fileExtensions = fileExtensions;
     this.mediaTypes = mediaTypes;
@@ -5826,7 +5833,7 @@ class ArazzoJSON1Parser extends _Parser_ts__WEBPACK_IMPORTED_MODULE_4__["default
   async parse(file, options) {
     const source = file.toString();
     try {
-      const parserOpts = (0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])(['sourceMap', 'strict', 'refractorOpts'], this);
+      const parserOpts = (0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])(['sourceMap', 'style', 'strict', 'refractorOpts'], this);
       const parseResult = await (0,_speclynx_apidom_parser_adapter_arazzo_json_1__WEBPACK_IMPORTED_MODULE_1__.parse)(source, parserOpts);
       const shouldParseSourceDescriptions = options?.parse?.parserOpts?.[this.name]?.sourceDescriptions ?? options?.parse?.parserOpts?.sourceDescriptions;
       if (shouldParseSourceDescriptions) {
@@ -6142,7 +6149,7 @@ class ArazzoYAML1Parser extends _Parser_ts__WEBPACK_IMPORTED_MODULE_4__["default
   async parse(file, options) {
     const source = file.toString();
     try {
-      const parserOpts = (0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])(['sourceMap', 'strict', 'refractorOpts'], this);
+      const parserOpts = (0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])(['sourceMap', 'style', 'strict', 'refractorOpts'], this);
       const parseResult = await (0,_speclynx_apidom_parser_adapter_arazzo_yaml_1__WEBPACK_IMPORTED_MODULE_1__.parse)(source, parserOpts);
       const shouldParseSourceDescriptions = options?.parse?.parserOpts?.[this.name]?.sourceDescriptions ?? options?.parse?.parserOpts?.sourceDescriptions;
       if (shouldParseSourceDescriptions) {
@@ -6234,7 +6241,7 @@ class AsyncAPIJSON2Parser extends _Parser_ts__WEBPACK_IMPORTED_MODULE_4__["defau
   async parse(file) {
     const source = file.toString();
     try {
-      const parserOpts = (0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])(['sourceMap', 'strict', 'refractorOpts'], this);
+      const parserOpts = (0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])(['sourceMap', 'style', 'strict', 'refractorOpts'], this);
       return await (0,_speclynx_apidom_parser_adapter_asyncapi_json_2__WEBPACK_IMPORTED_MODULE_1__.parse)(source, parserOpts);
     } catch (error) {
       throw new _errors_ParserError_ts__WEBPACK_IMPORTED_MODULE_3__["default"](`Error parsing "${file.uri}"`, {
@@ -6300,7 +6307,7 @@ class AsyncAPIYAML2Parser extends _Parser_ts__WEBPACK_IMPORTED_MODULE_4__["defau
   async parse(file) {
     const source = file.toString();
     try {
-      const parserOpts = (0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])(['sourceMap', 'strict', 'refractorOpts'], this);
+      const parserOpts = (0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])(['sourceMap', 'style', 'strict', 'refractorOpts'], this);
       return await (0,_speclynx_apidom_parser_adapter_asyncapi_yaml_2__WEBPACK_IMPORTED_MODULE_1__.parse)(source, parserOpts);
     } catch (error) {
       throw new _errors_ParserError_ts__WEBPACK_IMPORTED_MODULE_3__["default"](`Error parsing "${file.uri}"`, {
@@ -6432,7 +6439,7 @@ class JSONParser extends _Parser_ts__WEBPACK_IMPORTED_MODULE_4__["default"] {
   async parse(file) {
     const source = file.toString();
     try {
-      const parserOpts = (0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])(['sourceMap', 'strict'], this);
+      const parserOpts = (0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])(['sourceMap', 'style', 'strict'], this);
       return await (0,_speclynx_apidom_parser_adapter_json__WEBPACK_IMPORTED_MODULE_1__.parse)(source, parserOpts);
     } catch (error) {
       throw new _errors_ParserError_ts__WEBPACK_IMPORTED_MODULE_3__["default"](`Error parsing "${file.uri}"`, {
@@ -6498,7 +6505,7 @@ class OpenAPIJSON2Parser extends _Parser_ts__WEBPACK_IMPORTED_MODULE_4__["defaul
   async parse(file) {
     const source = file.toString();
     try {
-      const parserOpts = (0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])(['sourceMap', 'strict', 'refractorOpts'], this);
+      const parserOpts = (0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])(['sourceMap', 'style', 'strict', 'refractorOpts'], this);
       return await (0,_speclynx_apidom_parser_adapter_openapi_json_2__WEBPACK_IMPORTED_MODULE_1__.parse)(source, parserOpts);
     } catch (error) {
       throw new _errors_ParserError_ts__WEBPACK_IMPORTED_MODULE_3__["default"](`Error parsing "${file.uri}"`, {
@@ -6564,7 +6571,7 @@ class OpenAPIJSON3_0Parser extends _Parser_ts__WEBPACK_IMPORTED_MODULE_4__["defa
   async parse(file) {
     const source = file.toString();
     try {
-      const parserOpts = (0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])(['sourceMap', 'strict', 'refractorOpts'], this);
+      const parserOpts = (0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])(['sourceMap', 'style', 'strict', 'refractorOpts'], this);
       return await (0,_speclynx_apidom_parser_adapter_openapi_json_3_0__WEBPACK_IMPORTED_MODULE_1__.parse)(source, parserOpts);
     } catch (error) {
       throw new _errors_ParserError_ts__WEBPACK_IMPORTED_MODULE_3__["default"](`Error parsing "${file.uri}"`, {
@@ -6630,7 +6637,7 @@ class OpenAPIJSON3_1Parser extends _Parser_ts__WEBPACK_IMPORTED_MODULE_4__["defa
   async parse(file) {
     const source = file.toString();
     try {
-      const parserOpts = (0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])(['sourceMap', 'strict', 'refractorOpts'], this);
+      const parserOpts = (0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])(['sourceMap', 'style', 'strict', 'refractorOpts'], this);
       return await (0,_speclynx_apidom_parser_adapter_openapi_json_3_1__WEBPACK_IMPORTED_MODULE_1__.parse)(source, parserOpts);
     } catch (error) {
       throw new _errors_ParserError_ts__WEBPACK_IMPORTED_MODULE_3__["default"](`Error parsing "${file.uri}"`, {
@@ -6696,7 +6703,7 @@ class OpenAPIYAML2Parser extends _Parser_ts__WEBPACK_IMPORTED_MODULE_4__["defaul
   async parse(file) {
     const source = file.toString();
     try {
-      const parserOpts = (0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])(['sourceMap', 'strict', 'refractorOpts'], this);
+      const parserOpts = (0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])(['sourceMap', 'style', 'strict', 'refractorOpts'], this);
       return await (0,_speclynx_apidom_parser_adapter_openapi_yaml_2__WEBPACK_IMPORTED_MODULE_1__.parse)(source, parserOpts);
     } catch (error) {
       throw new _errors_ParserError_ts__WEBPACK_IMPORTED_MODULE_3__["default"](`Error parsing "${file.uri}"`, {
@@ -6762,7 +6769,7 @@ class OpenAPIYAML3_0Parser extends _Parser_ts__WEBPACK_IMPORTED_MODULE_4__["defa
   async parse(file) {
     const source = file.toString();
     try {
-      const parserOpts = (0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])(['sourceMap', 'strict', 'refractorOpts'], this);
+      const parserOpts = (0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])(['sourceMap', 'style', 'strict', 'refractorOpts'], this);
       return await (0,_speclynx_apidom_parser_adapter_openapi_yaml_3_0__WEBPACK_IMPORTED_MODULE_1__.parse)(source, parserOpts);
     } catch (error) {
       throw new _errors_ParserError_ts__WEBPACK_IMPORTED_MODULE_3__["default"](`Error parsing "${file.uri}"`, {
@@ -6828,7 +6835,7 @@ class OpenAPIYAML3_1Parser extends _Parser_ts__WEBPACK_IMPORTED_MODULE_4__["defa
   async parse(file) {
     const source = file.toString();
     try {
-      const parserOpts = (0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])(['sourceMap', 'strict', 'refractorOpts'], this);
+      const parserOpts = (0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])(['sourceMap', 'style', 'strict', 'refractorOpts'], this);
       return await (0,_speclynx_apidom_parser_adapter_openapi_yaml_3_1__WEBPACK_IMPORTED_MODULE_1__.parse)(source, parserOpts);
     } catch (error) {
       throw new _errors_ParserError_ts__WEBPACK_IMPORTED_MODULE_3__["default"](`Error parsing "${file.uri}"`, {
@@ -6894,6 +6901,7 @@ class YAML1Parser extends _Parser_ts__WEBPACK_IMPORTED_MODULE_3__["default"] {
     try {
       return await (0,_speclynx_apidom_parser_adapter_yaml_1_2__WEBPACK_IMPORTED_MODULE_0__.parse)(source, {
         sourceMap: this.sourceMap,
+        style: this.style,
         strict: this.strict
       });
     } catch (error) {
@@ -27815,6 +27823,53 @@ var both = /*#__PURE__*/(0,_internal_curry2_js__WEBPACK_IMPORTED_MODULE_0__["def
 
 /***/ },
 
+/***/ 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__(18938);
+
+
+
+/**
+ * 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);
+
+/***/ },
+
 /***/ 68199
 (__unused_webpack___webpack_module__, __webpack_exports__, __webpack_require__) {
 
@@ -29541,6 +29596,132 @@ function _checkForMethod(methodname, fn) {
 
 /***/ },
 
+/***/ 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__(31254);
+/* harmony import */ var _type_js__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(60963);
+
+
+
+/**
+ * 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;
+}();
+
+/***/ },
+
 /***/ 31254
 (__unused_webpack___webpack_module__, __webpack_exports__, __webpack_require__) {
 
@@ -46730,6 +46911,10 @@ __webpack_require__.r(__webpack_exports__);
  * @public
  */
 
+/**
+ * @public
+ */
+
 /**
  * Returns the fixed fields for an Element class or instance.
  *
@@ -47177,6 +47362,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
@@ -47248,7 +47434,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);
@@ -47871,20 +48069,22 @@ class ShallowCloneError extends _CloneError_mjs__WEBPACK_IMPORTED_MODULE_0__["de
 "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_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__(38504);
-/* harmony import */ var _KeyValuePair_mjs__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(36663);
-/* harmony import */ var _predicates_index_mjs__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(18252);
-/* harmony import */ var _predicates_index_mjs__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(25162);
-/* harmony import */ var _elements_SourceMap_mjs__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(25810);
-/* harmony import */ var _errors_DeepCloneError_mjs__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(95018);
-/* 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__(38504);
+/* harmony import */ var _KeyValuePair_mjs__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(36663);
+/* harmony import */ var _predicates_index_mjs__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(18252);
+/* harmony import */ var _predicates_index_mjs__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(25162);
+/* harmony import */ var _elements_SourceMap_mjs__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(25810);
+/* harmony import */ var _errors_DeepCloneError_mjs__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(95018);
+/* 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);
+
 
 
 
@@ -47917,9 +48117,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;
@@ -47943,7 +48143,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;
 };
@@ -47959,7 +48159,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;
 };
@@ -47970,16 +48170,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
   });
 };
@@ -47995,11 +48195,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;
@@ -48011,17 +48211,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;
@@ -48036,16 +48239,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
   });
 };
@@ -48472,6 +48675,66 @@ function unpackSourceMap(packed) {
 
 /***/ },
 
+/***/ 49686
+(__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 _primitives_ObjectElement_mjs__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(97071);
+
+/**
+ * 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);
+
+/***/ },
+
 /***/ 96911
 (__unused_webpack___webpack_module__, __webpack_exports__, __webpack_require__) {
 
@@ -48536,6 +48799,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),
@@ -48560,6 +48824,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.
@@ -49101,6 +49373,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.
@@ -49990,17 +50268,18 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   CollectionElement: () => (/* reexport safe */ _primitives_CollectionElement_mjs__WEBPACK_IMPORTED_MODULE_1__["default"]),
 /* harmony export */   CommentElement: () => (/* reexport safe */ _elements_Comment_mjs__WEBPACK_IMPORTED_MODULE_12__["default"]),
 /* harmony export */   Element: () => (/* reexport safe */ _primitives_Element_mjs__WEBPACK_IMPORTED_MODULE_0__["default"]),
-/* harmony export */   KeyValuePair: () => (/* reexport safe */ _KeyValuePair_mjs__WEBPACK_IMPORTED_MODULE_16__["default"]),
+/* harmony export */   KeyValuePair: () => (/* reexport safe */ _KeyValuePair_mjs__WEBPACK_IMPORTED_MODULE_17__["default"]),
 /* harmony export */   LinkElement: () => (/* reexport safe */ _elements_LinkElement_mjs__WEBPACK_IMPORTED_MODULE_9__["default"]),
 /* harmony export */   MemberElement: () => (/* reexport safe */ _primitives_MemberElement_mjs__WEBPACK_IMPORTED_MODULE_7__["default"]),
 /* harmony export */   NullElement: () => (/* reexport safe */ _primitives_NullElement_mjs__WEBPACK_IMPORTED_MODULE_2__["default"]),
 /* harmony export */   NumberElement: () => (/* reexport safe */ _primitives_NumberElement_mjs__WEBPACK_IMPORTED_MODULE_4__["default"]),
 /* harmony export */   ObjectElement: () => (/* reexport safe */ _primitives_ObjectElement_mjs__WEBPACK_IMPORTED_MODULE_8__["default"]),
-/* harmony export */   ObjectSlice: () => (/* reexport safe */ _ObjectSlice_mjs__WEBPACK_IMPORTED_MODULE_15__["default"]),
+/* harmony export */   ObjectSlice: () => (/* reexport safe */ _ObjectSlice_mjs__WEBPACK_IMPORTED_MODULE_16__["default"]),
 /* harmony export */   ParseResultElement: () => (/* reexport safe */ _elements_ParseResult_mjs__WEBPACK_IMPORTED_MODULE_13__["default"]),
 /* harmony export */   RefElement: () => (/* reexport safe */ _elements_RefElement_mjs__WEBPACK_IMPORTED_MODULE_10__["default"]),
 /* harmony export */   SourceMapElement: () => (/* reexport safe */ _elements_SourceMap_mjs__WEBPACK_IMPORTED_MODULE_14__["default"]),
 /* harmony export */   StringElement: () => (/* reexport safe */ _primitives_StringElement_mjs__WEBPACK_IMPORTED_MODULE_3__["default"]),
+/* harmony export */   StyleElement: () => (/* reexport safe */ _elements_Style_mjs__WEBPACK_IMPORTED_MODULE_15__["default"]),
 /* harmony export */   refract: () => (/* binding */ refract)
 /* harmony export */ });
 /* harmony import */ var _primitives_Element_mjs__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(60728);
@@ -50018,8 +50297,10 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var _elements_Comment_mjs__WEBPACK_IMPORTED_MODULE_12__ = __webpack_require__(40094);
 /* harmony import */ var _elements_ParseResult_mjs__WEBPACK_IMPORTED_MODULE_13__ = __webpack_require__(4823);
 /* harmony import */ var _elements_SourceMap_mjs__WEBPACK_IMPORTED_MODULE_14__ = __webpack_require__(25810);
-/* harmony import */ var _ObjectSlice_mjs__WEBPACK_IMPORTED_MODULE_15__ = __webpack_require__(38504);
-/* harmony import */ var _KeyValuePair_mjs__WEBPACK_IMPORTED_MODULE_16__ = __webpack_require__(36663);
+/* 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);
+
 
 
 
@@ -50106,6 +50387,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__(25810);
+/* harmony import */ var _elements_Style_mjs__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(49686);
+
 
 /**
  * Serialized representation of an Element in JSON Refract format.
@@ -50164,6 +50447,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;
@@ -50184,15 +50478,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) {
@@ -50204,6 +50501,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);
     }
@@ -53025,6 +53328,7 @@ __webpack_require__.r(__webpack_exports__);
 /* 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_2__ = __webpack_require__(25810);
+/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(49686);
 
 
 
@@ -53052,6 +53356,7 @@ class Visitor {
       to.attributes = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_0__["default"])(target, source);
     }
     _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__["default"].transfer(from, to);
+    _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__["default"].transfer(from, to);
   }
 }
 /* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (Visitor);
@@ -63401,7 +63706,7 @@ const specification = {
                   $ref: '#/visitors/value'
                 },
                 attributes: {
-                  $visitor: _visitors_FallbackVisitor_mjs__WEBPACK_IMPORTED_MODULE_1__["default"],
+                  $ref: '#/visitors/value',
                   alias: 'attributesField'
                 },
                 orderingKey: {
@@ -63691,6 +63996,7 @@ __webpack_require__.r(__webpack_exports__);
 /* 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_2__ = __webpack_require__(25810);
+/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(49686);
 
 
 
@@ -63718,6 +64024,7 @@ class Visitor {
       to.attributes = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_0__["default"])(target, source);
     }
     _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__["default"].transfer(from, to);
+    _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__["default"].transfer(from, to);
   }
 }
 /* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (Visitor);
@@ -71445,7 +71752,7 @@ const specification = {
           fixedFields: {
             // core vocabulary
             id: {
-              $visitor: _visitors_FallbackVisitor_mjs__WEBPACK_IMPORTED_MODULE_0__["default"],
+              $ref: '#/visitors/value',
               alias: 'idField'
             },
             $schema: {
@@ -71727,6 +72034,7 @@ __webpack_require__.r(__webpack_exports__);
 /* 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_2__ = __webpack_require__(25810);
+/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(49686);
 
 
 
@@ -71754,6 +72062,7 @@ class Visitor {
       to.attributes = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_0__["default"])(target, source);
     }
     _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__["default"].transfer(from, to);
+    _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__["default"].transfer(from, to);
   }
 }
 /* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (Visitor);
@@ -77156,6 +77465,7 @@ __webpack_require__.r(__webpack_exports__);
 /* 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_2__ = __webpack_require__(25810);
+/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(49686);
 
 
 
@@ -77183,6 +77493,7 @@ class Visitor {
       to.attributes = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_0__["default"])(target, source);
     }
     _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__["default"].transfer(from, to);
+    _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__["default"].transfer(from, to);
   }
 }
 /* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (Visitor);
@@ -79401,10 +79712,10 @@ class Encoding extends _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__["
   set headers(headers) {
     this.set('headers', headers);
   }
-  get style() {
+  get styleField() {
     return this.get('style');
   }
-  set style(style) {
+  set styleField(style) {
     this.set('style', style);
   }
   get explode() {
@@ -79551,10 +79862,10 @@ class Header extends _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__["de
   set allowEmptyValue(allowEmptyValue) {
     this.set('allowEmptyValue', allowEmptyValue);
   }
-  get style() {
+  get styleField() {
     return this.get('style');
   }
-  set style(style) {
+  set styleField(style) {
     this.set('style', style);
   }
   get explode() {
@@ -80170,10 +80481,10 @@ class Parameter extends _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__[
   set allowEmptyValue(allowEmptyValue) {
     this.set('allowEmptyValue', allowEmptyValue);
   }
-  get style() {
+  get styleField() {
     return this.get('style');
   }
-  set style(style) {
+  set styleField(style) {
     this.set('style', style);
   }
   get explode() {
@@ -83041,7 +83352,8 @@ const specification = {
               $ref: '#/visitors/value'
             },
             style: {
-              $ref: '#/visitors/value'
+              $ref: '#/visitors/value',
+              alias: 'styleField'
             },
             explode: {
               $ref: '#/visitors/value'
@@ -83097,7 +83409,8 @@ const specification = {
             },
             headers: _visitors_open_api_3_0_encoding_HeadersVisitor_mjs__WEBPACK_IMPORTED_MODULE_60__["default"],
             style: {
-              $ref: '#/visitors/value'
+              $ref: '#/visitors/value',
+              alias: 'styleField'
             },
             explode: {
               $ref: '#/visitors/value'
@@ -83187,7 +83500,8 @@ const specification = {
               $ref: '#/visitors/value'
             },
             style: {
-              $ref: '#/visitors/value'
+              $ref: '#/visitors/value',
+              alias: 'styleField'
             },
             explode: {
               $ref: '#/visitors/value'
@@ -83609,6 +83923,7 @@ __webpack_require__.r(__webpack_exports__);
 /* 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_2__ = __webpack_require__(25810);
+/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(49686);
 
 
 
@@ -83636,6 +83951,7 @@ class Visitor {
       to.attributes = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_0__["default"])(target, source);
     }
     _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__["default"].transfer(from, to);
+    _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__["default"].transfer(from, to);
   }
 }
 /* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (Visitor);
@@ -91378,16 +91694,21 @@ const detect = async (source, {
  */
 const parse = async (source, {
   sourceMap = false,
+  style = false,
   strict = false
 } = {}) => {
   if (strict && sourceMap) {
     throw new _speclynx_apidom_error__WEBPACK_IMPORTED_MODULE_1__["default"]('Cannot use sourceMap with strict parsing. Strict parsing does not support source maps.');
   }
+  if (strict && style) {
+    throw new _speclynx_apidom_error__WEBPACK_IMPORTED_MODULE_1__["default"]('Cannot use style with strict parsing. Strict parsing does not support style preservation.');
+  }
   if (strict) {
     return _native_index_mjs__WEBPACK_IMPORTED_MODULE_2__.parse(source);
   }
   return _tree_sitter_index_mjs__WEBPACK_IMPORTED_MODULE_3__.parse(source, {
-    sourceMap
+    sourceMap,
+    style
   });
 };
 
@@ -91518,12 +91839,14 @@ const detect = async source => {
  * @public
  */
 const parse = async (source, {
-  sourceMap = false
+  sourceMap = false,
+  style = false
 } = {}) => {
   const cst = await (0,_lexical_analysis_index_mjs__WEBPACK_IMPORTED_MODULE_0__["default"])(source);
   try {
     return (0,_syntactic_analysis_index_mjs__WEBPACK_IMPORTED_MODULE_1__["default"])(cst, {
-      sourceMap
+      sourceMap,
+      style
     });
   } finally {
     cst.delete();
@@ -91626,6 +91949,24 @@ const maybeAddSourceMap = (info, element, ctx) => {
   element.endCharacter = info.endPosition.column;
   element.endOffset = info.endIndex;
 };
+
+// build json style object for an element
+const buildJsonStyle = (ctx, extras) => {
+  const jsonStyle = {
+    indent: ctx.indent
+  };
+  if (extras) Object.assign(jsonStyle, extras);
+  return {
+    json: jsonStyle
+  };
+};
+
+// detect indent from an object's first pair child position
+// called during transformChildren when we encounter the first pair
+const detectIndent = (objectColumn, firstPairColumn) => {
+  const diff = firstPairColumn - objectColumn;
+  return diff > 0 ? diff : 2;
+};
 const transform = (cursor, transformerMap, ctx) => {
   const info = getCursorInfo(cursor);
 
@@ -91689,11 +92030,27 @@ const createTransformers = transformerMap => ({
     const element = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_7__["default"]();
     maybeAddSourceMap(info, element, ctx);
 
+    // Detect indent from first pair if style is enabled and not yet detected
+    if (ctx.style && ctx.indent === 0) {
+      if (cursor.gotoFirstChild()) {
+        do {
+          if (cursor.nodeType === 'pair') {
+            ctx.indent = detectIndent(info.startPosition.column, cursor.startPosition.column);
+            break;
+          }
+        } while (cursor.gotoNextSibling());
+        cursor.gotoParent();
+      }
+    }
+
     // Transform children (pairs)
     const children = transformChildren(cursor, transformerMap, ctx);
     for (const child of children) {
       element.push(child);
     }
+    if (ctx.style) {
+      element.style = buildJsonStyle(ctx);
+    }
     return element;
   },
   array(cursor, ctx) {
@@ -91706,6 +92063,9 @@ const createTransformers = transformerMap => ({
     for (const child of children) {
       element.push(child);
     }
+    if (ctx.style) {
+      element.style = buildJsonStyle(ctx);
+    }
     return element;
   },
   pair(cursor, ctx) {
@@ -91747,30 +92107,47 @@ const createTransformers = transformerMap => ({
         });
       }
     }
+    if (ctx.style) {
+      element.style = buildJsonStyle(ctx);
+    }
     maybeAddSourceMap(info, element, ctx);
     return element;
   },
   number(cursor, ctx) {
     const info = getCursorInfo(cursor);
     const element = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__["default"](Number(info.text));
+    if (ctx.style) {
+      element.style = buildJsonStyle(ctx, {
+        rawContent: info.text
+      });
+    }
     maybeAddSourceMap(info, element, ctx);
     return element;
   },
   null(cursor, ctx) {
     const info = getCursorInfo(cursor);
     const element = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__["default"]();
+    if (ctx.style) {
+      element.style = buildJsonStyle(ctx);
+    }
     maybeAddSourceMap(info, element, ctx);
     return element;
   },
   true(cursor, ctx) {
     const info = getCursorInfo(cursor);
     const element = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_4__["default"](true);
+    if (ctx.style) {
+      element.style = buildJsonStyle(ctx);
+    }
     maybeAddSourceMap(info, element, ctx);
     return element;
   },
   false(cursor, ctx) {
     const info = getCursorInfo(cursor);
     const element = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_4__["default"](false);
+    if (ctx.style) {
+      element.style = buildJsonStyle(ctx);
+    }
     maybeAddSourceMap(info, element, ctx);
     return element;
   },
@@ -91801,11 +92178,14 @@ Object.assign(transformers, createTransformers(transformers));
  * @public
  */
 const analyze = (cst, {
-  sourceMap = false
+  sourceMap = false,
+  style = false
 } = {}) => {
   const cursor = cst.walk();
   const ctx = {
     sourceMap,
+    style,
+    indent: 0,
     annotations: []
   };
   const result = transform(cursor, transformers, ctx);
@@ -92387,16 +92767,21 @@ const detect = async (source, {
  */
 const parse = async (source, {
   sourceMap = false,
+  style = false,
   strict = false
 } = {}) => {
   if (strict && sourceMap) {
     throw new _speclynx_apidom_error__WEBPACK_IMPORTED_MODULE_1__["default"]('Cannot use sourceMap with strict parsing. Strict parsing does not support source maps.');
   }
+  if (strict && style) {
+    throw new _speclynx_apidom_error__WEBPACK_IMPORTED_MODULE_1__["default"]('Cannot use style with strict parsing. Strict parsing does not support style preservation.');
+  }
   if (strict) {
     return _yaml_index_mjs__WEBPACK_IMPORTED_MODULE_2__.parse(source);
   }
   return _tree_sitter_index_mjs__WEBPACK_IMPORTED_MODULE_3__.parse(source, {
-    sourceMap
+    sourceMap,
+    style
   });
 };
 
@@ -92471,12 +92856,14 @@ const detect = async source => {
  * @public
  */
 const parse = async (source, {
-  sourceMap = false
+  sourceMap = false,
+  style = false
 } = {}) => {
   const cst = await (0,_lexical_analysis_index_mjs__WEBPACK_IMPORTED_MODULE_0__["default"])(source);
   try {
     return (0,_syntactic_analysis_index_mjs__WEBPACK_IMPORTED_MODULE_1__["default"])(cst, {
-      sourceMap
+      sourceMap,
+      style
     });
   } finally {
     cst.delete();
@@ -92550,18 +92937,20 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var _ast_Error_mjs__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(33240);
 /* harmony import */ var _ast_Literal_mjs__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(86951);
 /* harmony import */ var _ast_ParseResult_mjs__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(88912);
-/* harmony import */ var _ast_nodes_YamlAlias_mjs__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(15103);
-/* harmony import */ var _ast_nodes_YamlAnchor_mjs__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(2838);
-/* harmony import */ var _ast_nodes_YamlComment_mjs__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(14120);
-/* harmony import */ var _ast_nodes_YamlDirective_mjs__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(22532);
-/* harmony import */ var _ast_nodes_YamlDocument_mjs__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(17374);
-/* harmony import */ var _ast_nodes_YamlKeyValuePair_mjs__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(39113);
-/* harmony import */ var _ast_nodes_YamlMapping_mjs__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(17373);
-/* harmony import */ var _ast_nodes_YamlScalar_mjs__WEBPACK_IMPORTED_MODULE_10__ = __webpack_require__(20301);
-/* harmony import */ var _ast_nodes_YamlSequence_mjs__WEBPACK_IMPORTED_MODULE_11__ = __webpack_require__(46794);
-/* harmony import */ var _ast_nodes_YamlStream_mjs__WEBPACK_IMPORTED_MODULE_12__ = __webpack_require__(74213);
-/* harmony import */ var _ast_nodes_YamlTag_mjs__WEBPACK_IMPORTED_MODULE_13__ = __webpack_require__(48139);
-/* harmony import */ var _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_14__ = __webpack_require__(21544);
+/* harmony import */ var _ast_nodes_YamlNode_mjs__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(6821);
+/* harmony import */ var _ast_nodes_YamlAlias_mjs__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(15103);
+/* harmony import */ var _ast_nodes_YamlAnchor_mjs__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(2838);
+/* harmony import */ var _ast_nodes_YamlComment_mjs__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(14120);
+/* harmony import */ var _ast_nodes_YamlDirective_mjs__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(22532);
+/* harmony import */ var _ast_nodes_YamlDocument_mjs__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(17374);
+/* harmony import */ var _ast_nodes_YamlKeyValuePair_mjs__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(39113);
+/* harmony import */ var _ast_nodes_YamlMapping_mjs__WEBPACK_IMPORTED_MODULE_10__ = __webpack_require__(17373);
+/* harmony import */ var _ast_nodes_YamlScalar_mjs__WEBPACK_IMPORTED_MODULE_11__ = __webpack_require__(20301);
+/* harmony import */ var _ast_nodes_YamlSequence_mjs__WEBPACK_IMPORTED_MODULE_12__ = __webpack_require__(46794);
+/* harmony import */ var _ast_nodes_YamlStream_mjs__WEBPACK_IMPORTED_MODULE_13__ = __webpack_require__(74213);
+/* harmony import */ var _ast_nodes_YamlTag_mjs__WEBPACK_IMPORTED_MODULE_14__ = __webpack_require__(48139);
+/* harmony import */ var _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_15__ = __webpack_require__(21544);
+
 
 
 
@@ -92601,16 +92990,16 @@ const toPositionProps = info => ({
   endOffset: info.endIndex
 });
 const toYamlAnchor = info => {
-  return new _ast_nodes_YamlAnchor_mjs__WEBPACK_IMPORTED_MODULE_4__["default"]({
+  return new _ast_nodes_YamlAnchor_mjs__WEBPACK_IMPORTED_MODULE_5__["default"]({
     name: info.text,
     ...toPositionProps(info)
   });
 };
 const toYamlTag = (info, tagInfo) => {
   const explicitName = tagInfo?.text || (info.type === 'plain_scalar' ? '?' : '!');
-  const kind = info.type.endsWith('mapping') ? _ast_nodes_YamlTag_mjs__WEBPACK_IMPORTED_MODULE_13__.YamlNodeKind.Mapping : info.type.endsWith('sequence') ? _ast_nodes_YamlTag_mjs__WEBPACK_IMPORTED_MODULE_13__.YamlNodeKind.Sequence : _ast_nodes_YamlTag_mjs__WEBPACK_IMPORTED_MODULE_13__.YamlNodeKind.Scalar;
+  const kind = info.type.endsWith('mapping') ? _ast_nodes_YamlTag_mjs__WEBPACK_IMPORTED_MODULE_14__.YamlNodeKind.Mapping : info.type.endsWith('sequence') ? _ast_nodes_YamlTag_mjs__WEBPACK_IMPORTED_MODULE_14__.YamlNodeKind.Sequence : _ast_nodes_YamlTag_mjs__WEBPACK_IMPORTED_MODULE_14__.YamlNodeKind.Scalar;
   const positionProps = tagInfo ? toPositionProps(tagInfo) : undefined;
-  return new _ast_nodes_YamlTag_mjs__WEBPACK_IMPORTED_MODULE_13__["default"]({
+  return new _ast_nodes_YamlTag_mjs__WEBPACK_IMPORTED_MODULE_14__["default"]({
     explicitName,
     kind,
     ...positionProps
@@ -92658,12 +93047,29 @@ const processChildren = (cursor, ctx, transformerMap) => {
   return results;
 };
 
+// strip leading '# ' (or bare '#') from comment text, keeping only the content
+const stripCommentHash = text => text.split('\n').map(line => line.replace(/^#\s?/, '')).join('\n');
+
+// find the first YamlNode in a TransformResult (which may be an array from block_node)
+const findYamlNode = result => {
+  if (result instanceof _ast_nodes_YamlNode_mjs__WEBPACK_IMPORTED_MODULE_3__["default"]) return result;
+  if (Array.isArray(result)) {
+    for (const item of result.flat()) {
+      if (item instanceof _ast_nodes_YamlNode_mjs__WEBPACK_IMPORTED_MODULE_3__["default"]) return item;
+    }
+  }
+  return null;
+};
 // Helper to process key-value pair children
 const processKeyValuePairChildren = (cursor, ctx, transformerMap) => {
   let key = null;
   let value = null;
   const errors = [];
+  const commentsBetweenKeyValue = [];
+  const commentsAfterValue = [];
   let siblings = {};
+  let seenKey = false;
+  let seenValue = false;
   if (cursor.gotoFirstChild()) {
     do {
       const info = getCursorInfo(cursor);
@@ -92678,12 +93084,25 @@ const processKeyValuePairChildren = (cursor, ctx, transformerMap) => {
         siblings.anchor = info;
         continue;
       }
+
+      // collect comment nodes (extras placed by tree-sitter between key/value)
+      if (info.type === 'comment') {
+        const commentText = stripCommentHash(info.text);
+        if (seenValue) {
+          commentsAfterValue.push(commentText);
+        } else if (seenKey) {
+          commentsBetweenKeyValue.push(commentText);
+        }
+        continue;
+      }
       if (fieldName === 'key') {
         key = transform(cursor, ctx, transformerMap, siblings);
         siblings = {};
+        seenKey = true;
       } else if (fieldName === 'value') {
         value = transform(cursor, ctx, transformerMap, siblings);
         siblings = {};
+        seenValue = true;
       } else if (info.type === 'ERROR') {
         const errorResult = transform(cursor, ctx, transformerMap, siblings);
         if (errorResult !== null) {
@@ -92696,7 +93115,9 @@ const processKeyValuePairChildren = (cursor, ctx, transformerMap) => {
   return {
     key,
     value,
-    errors
+    errors,
+    commentsBetweenKeyValue,
+    commentsAfterValue
   };
 };
 const transform = (cursor, ctx, transformerMap, siblings = {}) => {
@@ -92725,7 +93146,7 @@ const createTransformers = transformerMap => ({
   stream(cursor, ctx) {
     const info = getCursorInfo(cursor);
     const children = processChildren(cursor, ctx, transformerMap);
-    const stream = new _ast_nodes_YamlStream_mjs__WEBPACK_IMPORTED_MODULE_12__["default"]({
+    const stream = new _ast_nodes_YamlStream_mjs__WEBPACK_IMPORTED_MODULE_13__["default"]({
       children: children.filter(c => c !== null),
       ...toPositionProps(info),
       isMissing: info.isMissing
@@ -92748,7 +93169,7 @@ const createTransformers = transformerMap => ({
       } while (cursor.gotoNextSibling());
       cursor.gotoParent();
     }
-    return new _ast_nodes_YamlDirective_mjs__WEBPACK_IMPORTED_MODULE_6__["default"]({
+    return new _ast_nodes_YamlDirective_mjs__WEBPACK_IMPORTED_MODULE_7__["default"]({
       ...toPositionProps(info),
       name: '%YAML',
       parameters: {
@@ -92767,7 +93188,7 @@ const createTransformers = transformerMap => ({
       } while (cursor.gotoNextSibling());
       cursor.gotoParent();
     }
-    const tagDirective = new _ast_nodes_YamlDirective_mjs__WEBPACK_IMPORTED_MODULE_6__["default"]({
+    const tagDirective = new _ast_nodes_YamlDirective_mjs__WEBPACK_IMPORTED_MODULE_7__["default"]({
       ...toPositionProps(info),
       name: '%TAG',
       parameters: {
@@ -92789,7 +93210,7 @@ const createTransformers = transformerMap => ({
       } while (cursor.gotoNextSibling());
       cursor.gotoParent();
     }
-    return new _ast_nodes_YamlDirective_mjs__WEBPACK_IMPORTED_MODULE_6__["default"]({
+    return new _ast_nodes_YamlDirective_mjs__WEBPACK_IMPORTED_MODULE_7__["default"]({
       ...toPositionProps(info),
       name: children[0],
       parameters: {
@@ -92801,7 +93222,7 @@ const createTransformers = transformerMap => ({
   document(cursor, ctx) {
     const info = getCursorInfo(cursor);
     const children = processChildren(cursor, ctx, transformerMap);
-    return new _ast_nodes_YamlDocument_mjs__WEBPACK_IMPORTED_MODULE_7__["default"]({
+    return new _ast_nodes_YamlDocument_mjs__WEBPACK_IMPORTED_MODULE_8__["default"]({
       children: children.flat().filter(c => c !== null),
       ...toPositionProps(info),
       isMissing: info.isMissing
@@ -92833,7 +93254,7 @@ const createTransformers = transformerMap => ({
 
     // No kind node - create empty scalar
     if (lastChildInfo) {
-      const emptyScalarNode = new _ast_nodes_YamlScalar_mjs__WEBPACK_IMPORTED_MODULE_10__["default"]({
+      const emptyScalarNode = new _ast_nodes_YamlScalar_mjs__WEBPACK_IMPORTED_MODULE_11__["default"]({
         content: '',
         anchor: siblings.anchor ? toYamlAnchor(siblings.anchor) : undefined,
         tag: toYamlTag(lastChildInfo, siblings.tag),
@@ -92843,8 +93264,8 @@ const createTransformers = transformerMap => ({
         endLine: lastChildInfo.endPosition.row,
         endCharacter: lastChildInfo.endPosition.column,
         endOffset: lastChildInfo.endIndex,
-        styleGroup: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_14__.YamlStyleGroup.Flow,
-        style: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_14__.YamlStyle.Plain
+        styleGroup: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_15__.YamlStyleGroup.Flow,
+        style: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_15__.YamlStyle.Plain
       });
       registerAnchor(emptyScalarNode, ctx);
       return emptyScalarNode;
@@ -92856,13 +93277,13 @@ const createTransformers = transformerMap => ({
     const tag = toYamlTag(info, siblings.tag);
     const anchor = siblings.anchor ? toYamlAnchor(siblings.anchor) : undefined;
     const children = processChildren(cursor, ctx, transformerMap);
-    const mappingNode = new _ast_nodes_YamlMapping_mjs__WEBPACK_IMPORTED_MODULE_9__["default"]({
+    const mappingNode = new _ast_nodes_YamlMapping_mjs__WEBPACK_IMPORTED_MODULE_10__["default"]({
       children: children.filter(c => c !== null),
       ...toPositionProps(info),
       anchor,
       tag,
-      styleGroup: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_14__.YamlStyleGroup.Block,
-      style: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_14__.YamlStyle.NextLine,
+      styleGroup: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_15__.YamlStyleGroup.Block,
+      style: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_15__.YamlStyle.NextLine,
       isMissing: info.isMissing
     });
     registerAnchor(mappingNode, ctx);
@@ -92873,13 +93294,15 @@ const createTransformers = transformerMap => ({
     const {
       key,
       value,
-      errors
+      errors,
+      commentsBetweenKeyValue,
+      commentsAfterValue
     } = processKeyValuePairChildren(cursor, ctx, transformerMap);
     const children = [];
 
     // Handle empty key
     if (key === null) {
-      const emptyKey = new _ast_nodes_YamlScalar_mjs__WEBPACK_IMPORTED_MODULE_10__["default"]({
+      const emptyKey = new _ast_nodes_YamlScalar_mjs__WEBPACK_IMPORTED_MODULE_11__["default"]({
         content: '',
         startLine: info.startPosition.row,
         startCharacter: info.startPosition.column,
@@ -92887,12 +93310,12 @@ const createTransformers = transformerMap => ({
         endLine: info.startPosition.row,
         endCharacter: info.startPosition.column,
         endOffset: info.startIndex,
-        tag: new _ast_nodes_YamlTag_mjs__WEBPACK_IMPORTED_MODULE_13__["default"]({
+        tag: new _ast_nodes_YamlTag_mjs__WEBPACK_IMPORTED_MODULE_14__["default"]({
           explicitName: '?',
-          kind: _ast_nodes_YamlTag_mjs__WEBPACK_IMPORTED_MODULE_13__.YamlNodeKind.Scalar
+          kind: _ast_nodes_YamlTag_mjs__WEBPACK_IMPORTED_MODULE_14__.YamlNodeKind.Scalar
         }),
-        styleGroup: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_14__.YamlStyleGroup.Flow,
-        style: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_14__.YamlStyle.Plain
+        styleGroup: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_15__.YamlStyleGroup.Flow,
+        style: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_15__.YamlStyle.Plain
       });
       children.push(emptyKey);
     } else {
@@ -92901,7 +93324,7 @@ const createTransformers = transformerMap => ({
 
     // Handle empty value
     if (value === null) {
-      const emptyValue = new _ast_nodes_YamlScalar_mjs__WEBPACK_IMPORTED_MODULE_10__["default"]({
+      const emptyValue = new _ast_nodes_YamlScalar_mjs__WEBPACK_IMPORTED_MODULE_11__["default"]({
         content: '',
         startLine: info.endPosition.row,
         startCharacter: info.endPosition.column,
@@ -92909,22 +93332,37 @@ const createTransformers = transformerMap => ({
         endLine: info.endPosition.row,
         endCharacter: info.endPosition.column,
         endOffset: info.endIndex,
-        tag: new _ast_nodes_YamlTag_mjs__WEBPACK_IMPORTED_MODULE_13__["default"]({
+        tag: new _ast_nodes_YamlTag_mjs__WEBPACK_IMPORTED_MODULE_14__["default"]({
           explicitName: '?',
-          kind: _ast_nodes_YamlTag_mjs__WEBPACK_IMPORTED_MODULE_13__.YamlNodeKind.Scalar
+          kind: _ast_nodes_YamlTag_mjs__WEBPACK_IMPORTED_MODULE_14__.YamlNodeKind.Scalar
         }),
-        styleGroup: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_14__.YamlStyleGroup.Flow,
-        style: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_14__.YamlStyle.Plain
+        styleGroup: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_15__.YamlStyleGroup.Flow,
+        style: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_15__.YamlStyle.Plain
       });
       children.push(emptyValue);
     } else {
       children.push(value);
     }
+
+    // attach comments found between key and value to the value node
+    if (commentsBetweenKeyValue.length > 0) {
+      const valueNode = findYamlNode(value);
+      if (valueNode) {
+        valueNode.commentBefore = commentsBetweenKeyValue.join('\n');
+      }
+    }
+    // attach comments found after value to the value node
+    if (commentsAfterValue.length > 0) {
+      const valueNode = findYamlNode(value);
+      if (valueNode) {
+        valueNode.comment = commentsAfterValue.join('\n');
+      }
+    }
     children.push(...errors);
-    return new _ast_nodes_YamlKeyValuePair_mjs__WEBPACK_IMPORTED_MODULE_8__["default"]({
+    return new _ast_nodes_YamlKeyValuePair_mjs__WEBPACK_IMPORTED_MODULE_9__["default"]({
       children: children.flat().filter(c => c !== null),
       ...toPositionProps(info),
-      styleGroup: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_14__.YamlStyleGroup.Block,
+      styleGroup: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_15__.YamlStyleGroup.Block,
       isMissing: info.isMissing
     });
   },
@@ -92933,13 +93371,13 @@ const createTransformers = transformerMap => ({
     const tag = toYamlTag(info, siblings.tag);
     const anchor = siblings.anchor ? toYamlAnchor(siblings.anchor) : undefined;
     const children = processChildren(cursor, ctx, transformerMap);
-    const mappingNode = new _ast_nodes_YamlMapping_mjs__WEBPACK_IMPORTED_MODULE_9__["default"]({
+    const mappingNode = new _ast_nodes_YamlMapping_mjs__WEBPACK_IMPORTED_MODULE_10__["default"]({
       children: children.flat().filter(c => c !== null),
       ...toPositionProps(info),
       anchor,
       tag,
-      styleGroup: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_14__.YamlStyleGroup.Flow,
-      style: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_14__.YamlStyle.Explicit,
+      styleGroup: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_15__.YamlStyleGroup.Flow,
+      style: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_15__.YamlStyle.Explicit,
       isMissing: info.isMissing
     });
     registerAnchor(mappingNode, ctx);
@@ -92950,13 +93388,15 @@ const createTransformers = transformerMap => ({
     const {
       key,
       value,
-      errors
+      errors,
+      commentsBetweenKeyValue,
+      commentsAfterValue
     } = processKeyValuePairChildren(cursor, ctx, transformerMap);
     const children = [];
 
     // Handle empty key
     if (key === null) {
-      const emptyKey = new _ast_nodes_YamlScalar_mjs__WEBPACK_IMPORTED_MODULE_10__["default"]({
+      const emptyKey = new _ast_nodes_YamlScalar_mjs__WEBPACK_IMPORTED_MODULE_11__["default"]({
         content: '',
         startLine: info.startPosition.row,
         startCharacter: info.startPosition.column,
@@ -92964,12 +93404,12 @@ const createTransformers = transformerMap => ({
         endLine: info.startPosition.row,
         endCharacter: info.startPosition.column,
         endOffset: info.startIndex,
-        tag: new _ast_nodes_YamlTag_mjs__WEBPACK_IMPORTED_MODULE_13__["default"]({
+        tag: new _ast_nodes_YamlTag_mjs__WEBPACK_IMPORTED_MODULE_14__["default"]({
           explicitName: '?',
-          kind: _ast_nodes_YamlTag_mjs__WEBPACK_IMPORTED_MODULE_13__.YamlNodeKind.Scalar
+          kind: _ast_nodes_YamlTag_mjs__WEBPACK_IMPORTED_MODULE_14__.YamlNodeKind.Scalar
         }),
-        styleGroup: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_14__.YamlStyleGroup.Flow,
-        style: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_14__.YamlStyle.Plain
+        styleGroup: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_15__.YamlStyleGroup.Flow,
+        style: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_15__.YamlStyle.Plain
       });
       children.push(emptyKey);
     } else {
@@ -92978,7 +93418,7 @@ const createTransformers = transformerMap => ({
 
     // Handle empty value
     if (value === null) {
-      const emptyValue = new _ast_nodes_YamlScalar_mjs__WEBPACK_IMPORTED_MODULE_10__["default"]({
+      const emptyValue = new _ast_nodes_YamlScalar_mjs__WEBPACK_IMPORTED_MODULE_11__["default"]({
         content: '',
         startLine: info.endPosition.row,
         startCharacter: info.endPosition.column,
@@ -92986,22 +93426,37 @@ const createTransformers = transformerMap => ({
         endLine: info.endPosition.row,
         endCharacter: info.endPosition.column,
         endOffset: info.endIndex,
-        tag: new _ast_nodes_YamlTag_mjs__WEBPACK_IMPORTED_MODULE_13__["default"]({
+        tag: new _ast_nodes_YamlTag_mjs__WEBPACK_IMPORTED_MODULE_14__["default"]({
           explicitName: '?',
-          kind: _ast_nodes_YamlTag_mjs__WEBPACK_IMPORTED_MODULE_13__.YamlNodeKind.Scalar
+          kind: _ast_nodes_YamlTag_mjs__WEBPACK_IMPORTED_MODULE_14__.YamlNodeKind.Scalar
         }),
-        styleGroup: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_14__.YamlStyleGroup.Flow,
-        style: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_14__.YamlStyle.Plain
+        styleGroup: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_15__.YamlStyleGroup.Flow,
+        style: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_15__.YamlStyle.Plain
       });
       children.push(emptyValue);
     } else {
       children.push(value);
     }
+
+    // attach comments found between key and value to the value node
+    if (commentsBetweenKeyValue.length > 0) {
+      const valueNode = findYamlNode(value);
+      if (valueNode) {
+        valueNode.commentBefore = commentsBetweenKeyValue.join('\n');
+      }
+    }
+    // attach comments found after value to the value node
+    if (commentsAfterValue.length > 0) {
+      const valueNode = findYamlNode(value);
+      if (valueNode) {
+        valueNode.comment = commentsAfterValue.join('\n');
+      }
+    }
     children.push(...errors);
-    return new _ast_nodes_YamlKeyValuePair_mjs__WEBPACK_IMPORTED_MODULE_8__["default"]({
+    return new _ast_nodes_YamlKeyValuePair_mjs__WEBPACK_IMPORTED_MODULE_9__["default"]({
       children: children.flat().filter(c => c !== null),
       ...toPositionProps(info),
-      styleGroup: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_14__.YamlStyleGroup.Flow,
+      styleGroup: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_15__.YamlStyleGroup.Flow,
       isMissing: info.isMissing
     });
   },
@@ -93010,13 +93465,13 @@ const createTransformers = transformerMap => ({
     const tag = toYamlTag(info, siblings.tag);
     const anchor = siblings.anchor ? toYamlAnchor(siblings.anchor) : undefined;
     const children = processChildren(cursor, ctx, transformerMap);
-    const sequenceNode = new _ast_nodes_YamlSequence_mjs__WEBPACK_IMPORTED_MODULE_11__["default"]({
+    const sequenceNode = new _ast_nodes_YamlSequence_mjs__WEBPACK_IMPORTED_MODULE_12__["default"]({
       children: children.flat(Infinity).filter(c => c !== null),
       ...toPositionProps(info),
       anchor,
       tag,
-      styleGroup: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_14__.YamlStyleGroup.Block,
-      style: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_14__.YamlStyle.NextLine
+      styleGroup: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_15__.YamlStyleGroup.Block,
+      style: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_15__.YamlStyle.NextLine
     });
     registerAnchor(sequenceNode, ctx);
     return ctx.schema.resolve(sequenceNode);
@@ -93027,11 +93482,11 @@ const createTransformers = transformerMap => ({
 
     // If only one child (the "-" literal), create empty node
     if (children.length === 0) {
-      const emptyScalarNode = new _ast_nodes_YamlScalar_mjs__WEBPACK_IMPORTED_MODULE_10__["default"]({
+      const emptyScalarNode = new _ast_nodes_YamlScalar_mjs__WEBPACK_IMPORTED_MODULE_11__["default"]({
         content: '',
-        tag: new _ast_nodes_YamlTag_mjs__WEBPACK_IMPORTED_MODULE_13__["default"]({
+        tag: new _ast_nodes_YamlTag_mjs__WEBPACK_IMPORTED_MODULE_14__["default"]({
           explicitName: '?',
-          kind: _ast_nodes_YamlTag_mjs__WEBPACK_IMPORTED_MODULE_13__.YamlNodeKind.Scalar
+          kind: _ast_nodes_YamlTag_mjs__WEBPACK_IMPORTED_MODULE_14__.YamlNodeKind.Scalar
         }),
         startLine: info.endPosition.row,
         startCharacter: info.endPosition.column,
@@ -93039,8 +93494,8 @@ const createTransformers = transformerMap => ({
         endLine: info.endPosition.row,
         endCharacter: info.endPosition.column,
         endOffset: info.endIndex,
-        styleGroup: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_14__.YamlStyleGroup.Flow,
-        style: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_14__.YamlStyle.Plain
+        styleGroup: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_15__.YamlStyleGroup.Flow,
+        style: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_15__.YamlStyle.Plain
       });
       return [emptyScalarNode];
     }
@@ -93051,13 +93506,13 @@ const createTransformers = transformerMap => ({
     const tag = toYamlTag(info, siblings.tag);
     const anchor = siblings.anchor ? toYamlAnchor(siblings.anchor) : undefined;
     const children = processChildren(cursor, ctx, transformerMap);
-    const sequenceNode = new _ast_nodes_YamlSequence_mjs__WEBPACK_IMPORTED_MODULE_11__["default"]({
+    const sequenceNode = new _ast_nodes_YamlSequence_mjs__WEBPACK_IMPORTED_MODULE_12__["default"]({
       children: children.flat().filter(c => c !== null),
       ...toPositionProps(info),
       anchor,
       tag,
-      styleGroup: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_14__.YamlStyleGroup.Flow,
-      style: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_14__.YamlStyle.Explicit
+      styleGroup: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_15__.YamlStyleGroup.Flow,
+      style: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_15__.YamlStyle.Explicit
     });
     registerAnchor(sequenceNode, ctx);
     return ctx.schema.resolve(sequenceNode);
@@ -93066,14 +93521,15 @@ const createTransformers = transformerMap => ({
     const info = getCursorInfo(cursor);
     const tag = toYamlTag(info, siblings.tag);
     const anchor = siblings.anchor ? toYamlAnchor(siblings.anchor) : undefined;
-    const scalarNode = new _ast_nodes_YamlScalar_mjs__WEBPACK_IMPORTED_MODULE_10__["default"]({
+    const scalarNode = new _ast_nodes_YamlScalar_mjs__WEBPACK_IMPORTED_MODULE_11__["default"]({
       content: info.text,
       anchor,
       tag,
       ...toPositionProps(info),
-      styleGroup: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_14__.YamlStyleGroup.Flow,
-      style: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_14__.YamlStyle.Plain
+      styleGroup: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_15__.YamlStyleGroup.Flow,
+      style: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_15__.YamlStyle.Plain
     });
+    scalarNode.rawContent = info.text;
     registerAnchor(scalarNode, ctx);
     return ctx.schema.resolve(scalarNode);
   },
@@ -93081,14 +93537,15 @@ const createTransformers = transformerMap => ({
     const info = getCursorInfo(cursor);
     const tag = toYamlTag(info, siblings.tag);
     const anchor = siblings.anchor ? toYamlAnchor(siblings.anchor) : undefined;
-    const scalarNode = new _ast_nodes_YamlScalar_mjs__WEBPACK_IMPORTED_MODULE_10__["default"]({
+    const scalarNode = new _ast_nodes_YamlScalar_mjs__WEBPACK_IMPORTED_MODULE_11__["default"]({
       content: info.text,
       anchor,
       tag,
       ...toPositionProps(info),
-      styleGroup: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_14__.YamlStyleGroup.Flow,
-      style: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_14__.YamlStyle.SingleQuoted
+      styleGroup: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_15__.YamlStyleGroup.Flow,
+      style: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_15__.YamlStyle.SingleQuoted
     });
+    scalarNode.rawContent = info.text;
     registerAnchor(scalarNode, ctx);
     return ctx.schema.resolve(scalarNode);
   },
@@ -93096,14 +93553,15 @@ const createTransformers = transformerMap => ({
     const info = getCursorInfo(cursor);
     const tag = toYamlTag(info, siblings.tag);
     const anchor = siblings.anchor ? toYamlAnchor(siblings.anchor) : undefined;
-    const scalarNode = new _ast_nodes_YamlScalar_mjs__WEBPACK_IMPORTED_MODULE_10__["default"]({
+    const scalarNode = new _ast_nodes_YamlScalar_mjs__WEBPACK_IMPORTED_MODULE_11__["default"]({
       content: info.text,
       anchor,
       tag,
       ...toPositionProps(info),
-      styleGroup: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_14__.YamlStyleGroup.Flow,
-      style: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_14__.YamlStyle.DoubleQuoted
+      styleGroup: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_15__.YamlStyleGroup.Flow,
+      style: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_15__.YamlStyle.DoubleQuoted
     });
+    scalarNode.rawContent = info.text;
     registerAnchor(scalarNode, ctx);
     return ctx.schema.resolve(scalarNode);
   },
@@ -93111,27 +93569,29 @@ const createTransformers = transformerMap => ({
     const info = getCursorInfo(cursor);
     const tag = toYamlTag(info, siblings.tag);
     const anchor = siblings.anchor ? toYamlAnchor(siblings.anchor) : undefined;
-    const style = info.text.startsWith('|') ? _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_14__.YamlStyle.Literal : info.text.startsWith('>') ? _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_14__.YamlStyle.Folded : _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_14__.YamlStyle.Plain;
-    const scalarNode = new _ast_nodes_YamlScalar_mjs__WEBPACK_IMPORTED_MODULE_10__["default"]({
+    const style = info.text.startsWith('|') ? _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_15__.YamlStyle.Literal : info.text.startsWith('>') ? _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_15__.YamlStyle.Folded : _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_15__.YamlStyle.Plain;
+    const scalarNode = new _ast_nodes_YamlScalar_mjs__WEBPACK_IMPORTED_MODULE_11__["default"]({
       content: info.text,
       anchor,
       tag,
       ...toPositionProps(info),
-      styleGroup: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_14__.YamlStyleGroup.Block,
+      styleGroup: _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_15__.YamlStyleGroup.Block,
       style
     });
+    scalarNode.rawContent = info.text;
     registerAnchor(scalarNode, ctx);
     return ctx.schema.resolve(scalarNode);
   },
   comment(cursor) {
     const info = getCursorInfo(cursor);
-    return new _ast_nodes_YamlComment_mjs__WEBPACK_IMPORTED_MODULE_5__["default"]({
-      content: info.text
+    return new _ast_nodes_YamlComment_mjs__WEBPACK_IMPORTED_MODULE_6__["default"]({
+      content: info.text,
+      ...toPositionProps(info)
     });
   },
   alias(cursor, ctx) {
     const info = getCursorInfo(cursor);
-    const alias = new _ast_nodes_YamlAlias_mjs__WEBPACK_IMPORTED_MODULE_3__["default"]({
+    const alias = new _ast_nodes_YamlAlias_mjs__WEBPACK_IMPORTED_MODULE_4__["default"]({
       content: info.text
     });
     return ctx.referenceManager.resolveAlias(alias);
@@ -93213,6 +93673,147 @@ const maybeAddSourceMap = (node, element, ctx) => {
   _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_8__["default"].transfer(node, element);
 };
 
+// find the first descendant matching a type path through the AST
+const findFirst = (node, path) => {
+  if (path.length === 0) return node;
+  const [type, ...rest] = path;
+  for (const child of node.children || []) {
+    if (child.type !== type) continue;
+    const found = findFirst(child, rest);
+    if (found) return found;
+  }
+  return undefined;
+};
+
+// detect indent from first nested block mapping (stream > document > mapping > keyValuePair > mapping)
+const detectIndent = node => {
+  const nested = findFirst(node, ['document', 'mapping', 'keyValuePair', 'mapping']);
+  if (nested?.styleGroup === _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_9__.YamlStyleGroup.Block && typeof nested.startCharacter === 'number' && nested.startCharacter > 0) {
+    return nested.startCharacter;
+  }
+  return 2;
+};
+
+// strip leading '#' from each line of comment text; yaml library adds '#' during stringification
+const stripCommentHash = text => text.split('\n').map(line => line.replace(/^#/, '')).join('\n');
+
+// collect comment texts from raw AST children, indexed by position relative to non-comment siblings
+
+// is the comment on the same line as the previous non-comment sibling?
+const isInlineComment = (child, lastEndLine, pending) => {
+  return pending.length === 0 && lastEndLine !== undefined && child.startLine === lastEndLine;
+};
+
+/**
+ * @param children - raw AST children of a mapping/sequence
+ * @param containerStartCol - the start column of the container node;
+ *   trailing comments whose startCharacter is less than this are out-of-scope
+ *   (tree-sitter may place them inside a nested block they don't belong to)
+ */
+const collectComments = (children, containerStartCol) => {
+  const before = new Map();
+  const after = new Map();
+  const pending = [];
+  let lastNonCommentEndLine;
+  let elementIdx = 0;
+  for (const child of children) {
+    if (child?.type === 'comment') {
+      const text = stripCommentHash(child.content || '');
+      if (elementIdx > 0 && isInlineComment(child, lastNonCommentEndLine, pending)) {
+        after.set(elementIdx - 1, text);
+      } else {
+        pending.push({
+          text,
+          startLine: child.startLine,
+          startCharacter: child.startCharacter
+        });
+      }
+      continue;
+    }
+
+    // non-comment node: attach any pending comments as commentBefore
+    if (pending.length > 0) {
+      before.set(elementIdx, pending.map(c => c.text).join('\n'));
+      pending.length = 0;
+    }
+    lastNonCommentEndLine = child.endLine;
+    elementIdx++;
+  }
+
+  // remaining pending comments are trailing — split into in-scope and out-of-scope
+  let trailing = null;
+  const outOfScope = [];
+  for (const c of pending) {
+    if (containerStartCol !== undefined && c.startCharacter !== undefined && c.startCharacter < containerStartCol) {
+      outOfScope.push(c.text);
+    } else {
+      trailing = trailing ? `${trailing}\n${c.text}` : c.text;
+    }
+  }
+  return {
+    before,
+    after,
+    trailing,
+    outOfScope
+  };
+};
+
+// set a yaml style property on an element, initializing style.yaml if needed
+const setYamlStyleProp = (element, key, value) => {
+  if (!element.style) element.style = {};
+  const yaml = element.style.yaml ?? {};
+  yaml[key] = value;
+  element.style.yaml = yaml;
+};
+
+// apply collected comments to transformed ApiDOM elements
+const applyComments = (elements, comments) => {
+  comments.before.forEach((text, idx) => {
+    if (elements[idx]) setYamlStyleProp(elements[idx], 'commentBefore', text);
+  });
+  comments.after.forEach((text, idx) => {
+    if (elements[idx]) setYamlStyleProp(elements[idx], 'comment', text);
+  });
+};
+
+// detect flow collection padding from node positions
+// gap of 1 between container start and first child start → no padding: [x
+// gap of 2+ → padding: [ x
+// gap of 1 between container start and first child start → no padding: {x
+// gap of 2+ → padding: { x
+const detectFlowPadding = node => {
+  const firstChild = (node.children || [])[0];
+  if (firstChild && typeof node.startCharacter === 'number' && typeof firstChild.startCharacter === 'number') {
+    return firstChild.startCharacter - node.startCharacter > 1;
+  }
+  return true;
+};
+
+// build yaml style object for an element
+const buildYamlStyle = (node, ctx, extras) => {
+  const yamlStyle = {
+    styleGroup: node.styleGroup,
+    indent: ctx.indent
+  };
+  if (ctx.flowCollectionPadding !== null) {
+    yamlStyle.flowCollectionPadding = ctx.flowCollectionPadding;
+  }
+  if (node.comment) {
+    yamlStyle.comment = node.comment;
+  }
+  if (node.commentBefore) {
+    yamlStyle.commentBefore = node.commentBefore;
+  }
+  if (extras) {
+    for (const [key, value] of Object.entries(extras)) {
+      if (value !== undefined) yamlStyle[key] = value;
+    }
+  }
+  return {
+    yaml: yamlStyle
+  };
+};
+
 // Transform a single node based on its type
 const transform = (node, ctx) => {
   if (node === null || node === undefined) {
@@ -93248,22 +93849,58 @@ const transform = (node, ctx) => {
 // Transform children array and flatten results
 const transformChildren = (children, ctx) => {
   const results = [];
+  let pendingPromoted = [];
   for (const child of children) {
     const result = transform(child, ctx);
     if (result === null) {
+      // collect any promoted comments generated during this null transform
+      if (ctx.style && ctx.promotedComments.length > 0) {
+        pendingPromoted.push(...ctx.promotedComments);
+        ctx.promotedComments = [];
+      }
       continue;
     }
+
+    // apply promoted comments from PREVIOUS children as commentBefore on this element
+    if (ctx.style && pendingPromoted.length > 0) {
+      const target = Array.isArray(result) ? result[0] : result;
+      if (target) {
+        if (!target.style) target.style = {};
+        const yaml = target.style.yaml ?? {};
+        const existing = yaml.commentBefore;
+        const promoted = pendingPromoted.join('\n');
+        yaml.commentBefore = existing ? `${promoted}\n${existing}` : promoted;
+        target.style.yaml = yaml;
+      }
+      pendingPromoted = [];
+    }
+
+    // collect any promoted comments generated by this child's transform
+    // (these will be applied to the NEXT sibling)
+    if (ctx.style && ctx.promotedComments.length > 0) {
+      pendingPromoted.push(...ctx.promotedComments);
+      ctx.promotedComments = [];
+    }
     if (Array.isArray(result)) {
       results.push(...result);
     } else {
       results.push(result);
     }
   }
+
+  // if promoted comments remain after all children, propagate up to parent scope
+  if (pendingPromoted.length > 0) {
+    ctx.promotedComments.push(...pendingPromoted);
+  }
   return results;
 };
 
 // Stream: Wraps transformed children in ParseResultElement
 const transformStream = (node, ctx) => {
+  // detect indent from the stream structure (only needed for style preservation)
+  if (ctx.style) {
+    ctx.indent = detectIndent(node);
+  }
   const element = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_7__["default"]();
 
   // Transform all children
@@ -93309,12 +93946,35 @@ const transformDocument = (node, ctx) => {
   return transformChildren(node.children || [], ctx);
 };
 
+// shared logic for transformMapping and transformSequence
+const transformCollection = (element, node, ctx) => {
+  const typedNode = node;
+  const children = node.children || [];
+  if (ctx.style) {
+    if (ctx.flowCollectionPadding === null && node.styleGroup === _ast_nodes_YamlStyle_mjs__WEBPACK_IMPORTED_MODULE_9__.YamlStyleGroup.Flow) {
+      ctx.flowCollectionPadding = detectFlowPadding(typedNode);
+    }
+    const comments = collectComments(children, typedNode.startCharacter);
+    const childElements = transformChildren(children, ctx);
+    // bypass content setter to avoid re-refracting already-transformed elements
+    element._content = childElements; // eslint-disable-line @typescript-eslint/no-explicit-any
+    applyComments(childElements, comments);
+    element.style = buildYamlStyle(node, ctx, {
+      comment: comments.trailing
+    });
+    if (comments.outOfScope.length > 0) {
+      ctx.promotedComments.push(...comments.outOfScope);
+    }
+  } else {
+    element._content = transformChildren(children, ctx); // eslint-disable-line @typescript-eslint/no-explicit-any
+  }
+  maybeAddSourceMap(typedNode, element, ctx);
+};
+
 // Mapping: Transforms to ObjectElement
 const transformMapping = (node, ctx) => {
   const element = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_4__["default"]();
-  // @ts-ignore
-  element._content = transformChildren(node.children || [], ctx);
-  maybeAddSourceMap(node, element, ctx);
+  transformCollection(element, node, ctx);
   return element;
 };
 
@@ -93348,9 +94008,7 @@ const transformKeyValuePair = (node, ctx) => {
 // Sequence: Transforms to ArrayElement
 const transformSequence = (node, ctx) => {
   const element = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__["default"]();
-  // @ts-ignore
-  element._content = transformChildren(node.children || [], ctx);
-  maybeAddSourceMap(node, element, ctx);
+  transformCollection(element, node, ctx);
   return element;
 };
 
@@ -93363,6 +94021,15 @@ const transformScalar = (node, ctx) => {
     element.classes.push('yaml-e-node');
     element.classes.push('yaml-e-scalar');
   }
+  if (ctx.style) {
+    const extras = {
+      scalarStyle: node.style
+    };
+    if (node.rawContent !== undefined) {
+      extras.rawContent = node.rawContent;
+    }
+    element.style = buildYamlStyle(node, ctx, extras);
+  }
   maybeAddSourceMap(node, element, ctx);
   return element;
 };
@@ -93427,13 +94094,18 @@ const transformRootError = (node, ctx) => {
  * @public
  */
 const transformYamlAstToApiDOM = (yamlAst, {
-  sourceMap = false
+  sourceMap = false,
+  style = false
 } = {}) => {
   const ctx = {
     sourceMap,
+    style,
     namespace: new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__["default"](),
     annotations: [],
-    processedDocumentCount: 0
+    processedDocumentCount: 0,
+    indent: 2,
+    flowCollectionPadding: null,
+    promotedComments: []
   };
   const rootNode = yamlAst.rootNode;
 
@@ -94032,6 +94704,8 @@ class YamlNode extends _Node_mjs__WEBPACK_IMPORTED_MODULE_0__["default"] {
   tag;
   style;
   styleGroup;
+  comment;
+  commentBefore;
   constructor({
     anchor,
     tag,
@@ -94071,6 +94745,7 @@ __webpack_require__.r(__webpack_exports__);
 class YamlScalar extends _YamlNode_mjs__WEBPACK_IMPORTED_MODULE_0__["default"] {
   static type = 'scalar';
   content;
+  rawContent;
   constructor({
     content,
     ...rest
@@ -94868,7 +95543,8 @@ __webpack_require__.r(__webpack_exports__);
  * @public
  */
 const analyze = (cst, {
-  sourceMap = false
+  sourceMap = false,
+  style = false
 } = {}) => {
   const cursor = cst.walk();
   const schema = new _ast_schemas_json_index_mjs__WEBPACK_IMPORTED_MODULE_0__["default"]();
@@ -94883,7 +95559,8 @@ const analyze = (cst, {
 
   // Pass 2: YAML AST -> ApiDOM (direct transformation)
   return (0,_YamlAstTransformer_mjs__WEBPACK_IMPORTED_MODULE_3__.transformYamlAstToApiDOM)(yamlAst, {
-    sourceMap
+    sourceMap,
+    style
   });
 };
 /* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (analyze);