@speclynx/apidom-core 2.11.0 → 2.12.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@speclynx/apidom-core",
-  "version": "2.11.0",
+  "version": "2.12.0",
   "description": "Tools for manipulating ApiDOM structures.",
   "publishConfig": {
     "access": "public",
@@ -40,9 +40,9 @@
   "license": "Apache-2.0",
   "dependencies": {
     "@babel/runtime-corejs3": "^7.28.4",
-    "@speclynx/apidom-datamodel": "^2.11.0",
-    "@speclynx/apidom-error": "^2.11.0",
-    "@speclynx/apidom-traverse": "^2.11.0",
+    "@speclynx/apidom-datamodel": "^2.12.0",
+    "@speclynx/apidom-error": "^2.12.0",
+    "@speclynx/apidom-traverse": "^2.12.0",
     "ramda": "~0.32.0",
     "ramda-adjunct": "^6.0.0",
     "short-unique-id": "^5.3.2",
@@ -59,5 +59,5 @@
     "README.md",
     "CHANGELOG.md"
   ],
-  "gitHead": "ee7e9488621be61f5dc1b098b8af135dc83c9ac1"
+  "gitHead": "672efe907afef6ae5b547a8028db077297a0c52e"
 }

package/src/fields/fixed-fields.cjs

@@ -9,6 +9,10 @@ var _apidomDatamodel = require("@speclynx/apidom-datamodel");
  * @public
  */
 
+/**
+ * @public
+ */
+
 /**
  * Returns the fixed fields for an Element class or instance.
  *

package/src/fields/fixed-fields.mjs

@@ -5,6 +5,10 @@ import { Element } from '@speclynx/apidom-datamodel';
  * @public
  */
 
+/**
+ * @public
+ */
+
 /**
  * Returns the fixed fields for an Element class or instance.
  *

package/src/refractor/toolbox.cjs

@@ -25,6 +25,7 @@ const predicates = {
   isCommentElement: _apidomDatamodel.isCommentElement,
   isParseResultElement: _apidomDatamodel.isParseResultElement,
   isSourceMapElement: _apidomDatamodel.isSourceMapElement,
+  hasElementStyle: _apidomDatamodel.hasElementStyle,
   hasElementSourceMap: _apidomDatamodel.hasElementSourceMap,
   includesSymbols: _apidomDatamodel.includesSymbols,
   includesClasses: _apidomDatamodel.includesClasses

package/src/refractor/toolbox.mjs

@@ -1,4 +1,4 @@
-import { isElement, isStringElement, isNumberElement, isNullElement, isBooleanElement, isArrayElement, isObjectElement, isMemberElement, isPrimitiveElement, isLinkElement, isRefElement, isAnnotationElement, isCommentElement, isParseResultElement, isSourceMapElement, hasElementSourceMap, includesSymbols, includesClasses } from '@speclynx/apidom-datamodel';
+import { isElement, isStringElement, isNumberElement, isNullElement, isBooleanElement, isArrayElement, isObjectElement, isMemberElement, isPrimitiveElement, isLinkElement, isRefElement, isAnnotationElement, isCommentElement, isParseResultElement, isSourceMapElement, hasElementStyle, hasElementSourceMap, includesSymbols, includesClasses } from '@speclynx/apidom-datamodel';
 import defaultNamespace from "../namespace.mjs";
 /**
  * @public
@@ -19,6 +19,7 @@ const predicates = {
   isCommentElement,
   isParseResultElement,
   isSourceMapElement,
+  hasElementStyle,
   hasElementSourceMap,
   includesSymbols,
   includesClasses

package/src/specification.cjs

@@ -35,7 +35,19 @@ const resolveSpecification = specification => {
       if ((0, _ramdaAdjunct.isPlainObject)(val) && (0, _ramda.has)('$ref', val) && (0, _ramda.propSatisfies)(_ramdaAdjunct.isString, '$ref', val)) {
         const $ref = (0, _ramda.path)(['$ref'], val);
         const pointer = (0, _ramdaAdjunct.trimCharsStart)('#/', $ref);
-        return (0, _ramda.path)(pointer.split('/'), root);
+        const resolved = (0, _ramda.path)(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, _ramdaAdjunct.isPlainObject)(resolved)) {
+          return {
+            ...resolved,
+            ...rest
+          };
+        }
+        return resolved;
       }
       if ((0, _ramdaAdjunct.isPlainObject)(val)) {
         return traverse(val, root, newPath);

package/src/specification.mjs

@@ -32,7 +32,19 @@ export const resolveSpecification = specification => {
       if (isPlainObject(val) && has('$ref', val) && propSatisfies(isString, '$ref', val)) {
         const $ref = path(['$ref'], val);
         const pointer = trimCharsStart('#/', $ref);
-        return path(pointer.split('/'), root);
+        const resolved = path(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 && isPlainObject(resolved)) {
+          return {
+            ...resolved,
+            ...rest
+          };
+        }
+        return resolved;
       }
       if (isPlainObject(val)) {
         return traverse(val, root, newPath);

package/src/transformers/serializers/json.cjs

@@ -3,9 +3,73 @@
 var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
 exports.__esModule = true;
 exports.default = void 0;
+var _apidomDatamodel = require("@speclynx/apidom-datamodel");
 var _value = _interopRequireDefault(require("./value.cjs"));
+const getStyle = element => {
+  return element.style?.json ?? {};
+};
+
+/**
+ * @public
+ */
+
+/**
+ * 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, _apidomDatamodel.isElement)(node)) return node;
+    if (visited.has(node)) return null;
+    visited.add(node);
+    if ((0, _apidomDatamodel.isObjectElement)(node)) {
+      const obj = {};
+      node.forEach((value, key) => {
+        const k = (0, _apidomDatamodel.isElement)(key) ? (0, _value.default)(key) : key;
+        if (typeof k === 'string') obj[k] = convert(value);
+      });
+      return obj;
+    }
+    if ((0, _apidomDatamodel.isArrayElement)(node)) {
+      const arr = [];
+      node.forEach(item => arr.push(convert(item)));
+      return arr;
+    }
+    if ((0, _apidomDatamodel.isRefElement)(node)) return String((0, _value.default)(node));
+    if ((0, _apidomDatamodel.isLinkElement)(node)) return (0, _apidomDatamodel.isStringElement)(node.href) ? (0, _value.default)(node.href) : '';
+
+    // number with rawContent — substitute with sentinel
+    if ((0, _apidomDatamodel.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.default)(node);
+  };
+  return convert(element);
+};
+
 /**
  * @public
  */
-const serializer = (element, replacer, space) => JSON.stringify((0, _value.default)(element), replacer, space);
+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.default)(element), replacer, space);
+};
 var _default = exports.default = serializer;

package/src/transformers/serializers/json.mjs

@@ -1,6 +1,70 @@
-import serializeValue from "./value.mjs";
+import { isElement, isObjectElement, isArrayElement, isRefElement, isLinkElement, isStringElement, isNumberElement } from '@speclynx/apidom-datamodel';
+import toValue from "./value.mjs";
+const getStyle = element => {
+  return element.style?.json ?? {};
+};
+
 /**
  * @public
  */
-const serializer = (element, replacer, space) => JSON.stringify(serializeValue(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 (!isElement(node)) return node;
+    if (visited.has(node)) return null;
+    visited.add(node);
+    if (isObjectElement(node)) {
+      const obj = {};
+      node.forEach((value, key) => {
+        const k = isElement(key) ? toValue(key) : key;
+        if (typeof k === 'string') obj[k] = convert(value);
+      });
+      return obj;
+    }
+    if (isArrayElement(node)) {
+      const arr = [];
+      node.forEach(item => arr.push(convert(item)));
+      return arr;
+    }
+    if (isRefElement(node)) return String(toValue(node));
+    if (isLinkElement(node)) return isStringElement(node.href) ? toValue(node.href) : '';
+
+    // number with rawContent — substitute with sentinel
+    if (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 toValue(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(toValue(element), replacer, space);
+};
 export default serializer;

package/src/transformers/serializers/yaml-1-2.cjs

@@ -4,16 +4,111 @@ var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequ
 exports.__esModule = true;
 exports.default = void 0;
 var _yaml = require("yaml");
+var _apidomDatamodel = require("@speclynx/apidom-datamodel");
 var _value = _interopRequireDefault(require("./value.cjs"));
+const getStyle = element => {
+  return element.style?.yaml ?? {};
+};
+
+// map our scalarStyle strings to YAML library Scalar.Type constants
+const scalarStyleMap = {
+  Plain: _yaml.Scalar.PLAIN,
+  SingleQuoted: _yaml.Scalar.QUOTE_SINGLE,
+  DoubleQuoted: _yaml.Scalar.QUOTE_DOUBLE,
+  Literal: _yaml.Scalar.BLOCK_LITERAL,
+  Folded: _yaml.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, _apidomDatamodel.isElement)(element)) return element;
+
+  // cycle detection
+  if (visited.has(element)) return undefined;
+  visited.add(element);
+  const style = getStyle(element);
+  if ((0, _apidomDatamodel.isObjectElement)(element)) {
+    const map = new _yaml.YAMLMap();
+    map.flow = style.styleGroup === 'Flow';
+    applyComments(map, style);
+    element.forEach((value, key, member) => {
+      const memberStyle = (0, _apidomDatamodel.isMemberElement)(member) ? getStyle(member) : {};
+      const keyNode = toYAMLNode(key, visited);
+      const valueNode = toYAMLNode(value, visited);
+      const pair = new _yaml.Pair(keyNode, valueNode);
+      if (memberStyle.commentBefore && (0, _yaml.isNode)(keyNode)) {
+        keyNode.commentBefore = ` ${memberStyle.commentBefore}`;
+      }
+      if (memberStyle.comment && (0, _yaml.isNode)(valueNode)) {
+        valueNode.comment = ` ${memberStyle.comment}`;
+      }
+      map.items.push(pair);
+    });
+    return map;
+  }
+  if ((0, _apidomDatamodel.isArrayElement)(element)) {
+    const seq = new _yaml.YAMLSeq();
+    seq.flow = style.styleGroup === 'Flow';
+    applyComments(seq, style);
+    element.forEach(item => {
+      seq.items.push(toYAMLNode(item, visited));
+    });
+    return seq;
+  }
+  if ((0, _apidomDatamodel.isRefElement)(element)) {
+    return new _yaml.Scalar(String((0, _value.default)(element)));
+  }
+  if ((0, _apidomDatamodel.isLinkElement)(element)) {
+    return new _yaml.Scalar((0, _apidomDatamodel.isStringElement)(element.href) ? (0, _value.default)(element.href) : '');
+  }
+
+  // scalar element (string, number, boolean, null)
+  const scalarType = style.scalarStyle ? scalarStyleMap[style.scalarStyle] : undefined;
+  const scalar = new _yaml.Scalar((0, _value.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
 } = {}) => {
@@ -21,6 +116,22 @@ 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.Document(undefined, allOptions);
+    doc.contents = rootNode;
+    if (directive) {
+      doc.directives.yaml.explicit = true;
+    }
+    return doc.toString(allOptions);
+  }
   if (directive) {
     const doc = new _yaml.Document((0, _value.default)(element), allOptions);
     doc.directives.yaml.explicit = true;

package/src/transformers/serializers/yaml-1-2.mjs

@@ -1,13 +1,109 @@
-import { Document, stringify } from 'yaml';
+import { Document, stringify, isNode, Scalar, YAMLMap, YAMLSeq, Pair } from 'yaml';
+import { isElement, isObjectElement, isArrayElement, isRefElement, isLinkElement, isStringElement, isMemberElement } from '@speclynx/apidom-datamodel';
 import toValue from "./value.mjs";
+const getStyle = element => {
+  return element.style?.yaml ?? {};
+};
+
+// map our scalarStyle strings to YAML library Scalar.Type constants
+const scalarStyleMap = {
+  Plain: Scalar.PLAIN,
+  SingleQuoted: Scalar.QUOTE_SINGLE,
+  DoubleQuoted: Scalar.QUOTE_DOUBLE,
+  Literal: Scalar.BLOCK_LITERAL,
+  Folded: 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 (!isElement(element)) return element;
+
+  // cycle detection
+  if (visited.has(element)) return undefined;
+  visited.add(element);
+  const style = getStyle(element);
+  if (isObjectElement(element)) {
+    const map = new YAMLMap();
+    map.flow = style.styleGroup === 'Flow';
+    applyComments(map, style);
+    element.forEach((value, key, member) => {
+      const memberStyle = isMemberElement(member) ? getStyle(member) : {};
+      const keyNode = toYAMLNode(key, visited);
+      const valueNode = toYAMLNode(value, visited);
+      const pair = new Pair(keyNode, valueNode);
+      if (memberStyle.commentBefore && isNode(keyNode)) {
+        keyNode.commentBefore = ` ${memberStyle.commentBefore}`;
+      }
+      if (memberStyle.comment && isNode(valueNode)) {
+        valueNode.comment = ` ${memberStyle.comment}`;
+      }
+      map.items.push(pair);
+    });
+    return map;
+  }
+  if (isArrayElement(element)) {
+    const seq = new YAMLSeq();
+    seq.flow = style.styleGroup === 'Flow';
+    applyComments(seq, style);
+    element.forEach(item => {
+      seq.items.push(toYAMLNode(item, visited));
+    });
+    return seq;
+  }
+  if (isRefElement(element)) {
+    return new Scalar(String(toValue(element)));
+  }
+  if (isLinkElement(element)) {
+    return new Scalar(isStringElement(element.href) ? toValue(element.href) : '');
+  }
+
+  // scalar element (string, number, boolean, null)
+  const scalarType = style.scalarStyle ? scalarStyleMap[style.scalarStyle] : undefined;
+  const scalar = new Scalar(toValue(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
 } = {}) => {
@@ -15,6 +111,22 @@ 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 Document(undefined, allOptions);
+    doc.contents = rootNode;
+    if (directive) {
+      doc.directives.yaml.explicit = true;
+    }
+    return doc.toString(allOptions);
+  }
   if (directive) {
     const doc = new Document(toValue(element), allOptions);
     doc.directives.yaml.explicit = true;

package/types/apidom-core.d.ts

@@ -5,6 +5,7 @@ import { CreateNodeOptions } from 'yaml';
 import { DocumentOptions } from 'yaml';
 import { Element as Element_2 } from '@speclynx/apidom-datamodel';
 import { hasElementSourceMap } from '@speclynx/apidom-datamodel';
+import { hasElementStyle } from '@speclynx/apidom-datamodel';
 import { includesClasses } from '@speclynx/apidom-datamodel';
 import { includesSymbols } from '@speclynx/apidom-datamodel';
 import { isAnnotationElement } from '@speclynx/apidom-datamodel';
@@ -146,10 +147,6 @@ export declare interface DispatchPluginsSync {
  */
 export declare const dispatchRefractorPlugins: DispatchPluginsSync;
 
-declare type ElementClass = typeof Element_2 & {
-    fixedFields?: FixedField[];
-};
-
 /**
  * @public
  */
@@ -197,10 +194,17 @@ export declare interface FixedField {
  *
  * @public
  */
-export declare function fixedFields<T extends boolean = false>(elementOrClass: Element_2 | ElementClass, options?: {
+export declare function fixedFields<T extends boolean = false>(elementOrClass: Element_2 | FixedFieldsElementClass, options?: {
     indexed?: T;
 }): T extends true ? Record<string, FixedField> : FixedField[];
 
+/**
+ * @public
+ */
+export declare type FixedFieldsElementClass = typeof Element_2 & {
+    fixedFields?: FixedField[];
+};
+
 /**
  * Transforms data to an Element from a particular namespace.
  *
@@ -227,6 +231,14 @@ export declare class IdentityManager {
     generateId(): string;
 }
 
+/**
+ * @public
+ */
+export declare interface JSONSerializerOptions {
+    /** Preserve original formatting styles from `element.style.json` */
+    preserveStyle?: boolean;
+}
+
 /**
  * @public
  */
@@ -281,6 +293,7 @@ export declare interface Predicates {
     isCommentElement: typeof isCommentElement;
     isParseResultElement: typeof isParseResultElement;
     isSourceMapElement: typeof isSourceMapElement;
+    hasElementStyle: typeof hasElementStyle;
     hasElementSourceMap: typeof hasElementSourceMap;
     includesSymbols: typeof includesSymbols;
     includesClasses: typeof includesClasses;
@@ -342,7 +355,7 @@ export declare const sexprs: (element: Element_2) => string;
 /**
  * @public
  */
-export declare const toJSON: (element: Element_2, replacer?: (this: any, key: string, value: any) => any, space?: string | number) => string;
+export declare const toJSON: (element: Element_2, replacer?: (this: unknown, key: string, value: unknown) => unknown, space?: string | number, options?: JSONSerializerOptions) => string;
 
 /**
  * @public
@@ -370,7 +383,7 @@ export declare const toValue: <T extends Element_2 | unknown>(element: T) => unk
 /**
  * @public
  */
-export declare const toYAML: (element: Element_2, { directive, aliasDuplicateObjects, ...options }?: YamlSerializerOptions) => string;
+export declare const toYAML: (element: Element_2, { directive, preserveStyle, aliasDuplicateObjects, ...options }?: YAMLSerializerOptions) => string;
 
 /**
  * This is a mutating function. If you don't want your Element to be mutated,
@@ -396,9 +409,13 @@ export declare class Transcluder {
 /**
  * @public
  */
-export declare interface YamlSerializerOptions extends DocumentOptions, Pick<CreateNodeOptions, 'aliasDuplicateObjects'>, Pick<SchemaOptions, 'sortMapEntries'>, ToStringOptions {
+export declare interface YAMLSerializerOptions extends DocumentOptions, Pick<CreateNodeOptions, 'aliasDuplicateObjects'>, Pick<SchemaOptions, 'sortMapEntries'>, ToStringOptions {
     /** Include %YAML directive and document marker */
     directive?: boolean;
+    /** Preserve original formatting styles from `element.style.yaml` */
+    preserveStyle?: boolean;
+    /** Padding inside flow collections (e.g. `{ a: 1 }` vs `{a: 1}`) */
+    flowCollectionPadding?: boolean;
 }
 
 export { }