@speclynx/apidom-reference 2.10.3 → 2.12.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@speclynx/apidom-reference",
-  "version": "2.10.3",
+  "version": "2.12.0",
   "description": "Advanced algorithms for semantic ApiDOM manipulations like dereferencing or resolution.",
   "publishConfig": {
     "access": "public",
@@ -231,29 +231,29 @@
   "license": "Apache-2.0",
   "dependencies": {
     "@babel/runtime-corejs3": "^7.28.4",
-    "@speclynx/apidom-core": "^2.10.3",
-    "@speclynx/apidom-datamodel": "^2.10.3",
-    "@speclynx/apidom-error": "^2.10.3",
-    "@speclynx/apidom-json-pointer": "^2.10.3",
-    "@speclynx/apidom-ns-arazzo-1": "^2.10.3",
-    "@speclynx/apidom-ns-asyncapi-2": "^2.10.3",
-    "@speclynx/apidom-ns-json-schema-2020-12": "^2.10.3",
-    "@speclynx/apidom-ns-openapi-2": "^2.10.3",
-    "@speclynx/apidom-ns-openapi-3-0": "^2.10.3",
-    "@speclynx/apidom-ns-openapi-3-1": "^2.10.3",
-    "@speclynx/apidom-parser-adapter-arazzo-json-1": "^2.10.3",
-    "@speclynx/apidom-parser-adapter-arazzo-yaml-1": "^2.10.3",
-    "@speclynx/apidom-parser-adapter-asyncapi-json-2": "^2.10.3",
-    "@speclynx/apidom-parser-adapter-asyncapi-yaml-2": "^2.10.3",
-    "@speclynx/apidom-parser-adapter-json": "^2.10.3",
-    "@speclynx/apidom-parser-adapter-openapi-json-2": "^2.10.3",
-    "@speclynx/apidom-parser-adapter-openapi-json-3-0": "^2.10.3",
-    "@speclynx/apidom-parser-adapter-openapi-json-3-1": "^2.10.3",
-    "@speclynx/apidom-parser-adapter-openapi-yaml-2": "^2.10.3",
-    "@speclynx/apidom-parser-adapter-openapi-yaml-3-0": "^2.10.3",
-    "@speclynx/apidom-parser-adapter-openapi-yaml-3-1": "^2.10.3",
-    "@speclynx/apidom-parser-adapter-yaml-1-2": "^2.10.3",
-    "@speclynx/apidom-traverse": "^2.10.3",
+    "@speclynx/apidom-core": "^2.12.0",
+    "@speclynx/apidom-datamodel": "^2.12.0",
+    "@speclynx/apidom-error": "^2.12.0",
+    "@speclynx/apidom-json-pointer": "^2.12.0",
+    "@speclynx/apidom-ns-arazzo-1": "^2.12.0",
+    "@speclynx/apidom-ns-asyncapi-2": "^2.12.0",
+    "@speclynx/apidom-ns-json-schema-2020-12": "^2.12.0",
+    "@speclynx/apidom-ns-openapi-2": "^2.12.0",
+    "@speclynx/apidom-ns-openapi-3-0": "^2.12.0",
+    "@speclynx/apidom-ns-openapi-3-1": "^2.12.0",
+    "@speclynx/apidom-parser-adapter-arazzo-json-1": "^2.12.0",
+    "@speclynx/apidom-parser-adapter-arazzo-yaml-1": "^2.12.0",
+    "@speclynx/apidom-parser-adapter-asyncapi-json-2": "^2.12.0",
+    "@speclynx/apidom-parser-adapter-asyncapi-yaml-2": "^2.12.0",
+    "@speclynx/apidom-parser-adapter-json": "^2.12.0",
+    "@speclynx/apidom-parser-adapter-openapi-json-2": "^2.12.0",
+    "@speclynx/apidom-parser-adapter-openapi-json-3-0": "^2.12.0",
+    "@speclynx/apidom-parser-adapter-openapi-json-3-1": "^2.12.0",
+    "@speclynx/apidom-parser-adapter-openapi-yaml-2": "^2.12.0",
+    "@speclynx/apidom-parser-adapter-openapi-yaml-3-0": "^2.12.0",
+    "@speclynx/apidom-parser-adapter-openapi-yaml-3-1": "^2.12.0",
+    "@speclynx/apidom-parser-adapter-yaml-1-2": "^2.12.0",
+    "@speclynx/apidom-traverse": "^2.12.0",
     "@swaggerexpert/arazzo-runtime-expression": "^2.0.3",
     "axios": "^1.13.0",
     "minimatch": "^7.4.6",
@@ -274,5 +274,5 @@
     "README.md",
     "CHANGELOG.md"
   ],
-  "gitHead": "d4801d19a42266df43ce85d07990fbf25a1548ad"
+  "gitHead": "672efe907afef6ae5b547a8028db077297a0c52e"
 }

package/src/parse/parsers/Parser.cjs

@@ -22,6 +22,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).
    */
@@ -40,6 +45,7 @@ class Parser {
     name,
     allowEmpty = true,
     sourceMap = false,
+    style = false,
     strict = true,
     fileExtensions = [],
     mediaTypes = []
@@ -47,6 +53,7 @@ class Parser {
     this.name = name;
     this.allowEmpty = allowEmpty;
     this.sourceMap = sourceMap;
+    this.style = style;
     this.strict = strict;
     this.fileExtensions = fileExtensions;
     this.mediaTypes = mediaTypes;

package/src/parse/parsers/Parser.mjs

@@ -18,6 +18,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).
    */
@@ -36,6 +41,7 @@ class Parser {
     name,
     allowEmpty = true,
     sourceMap = false,
+    style = false,
     strict = true,
     fileExtensions = [],
     mediaTypes = []
@@ -43,6 +49,7 @@ class Parser {
     this.name = name;
     this.allowEmpty = allowEmpty;
     this.sourceMap = sourceMap;
+    this.style = style;
     this.strict = strict;
     this.fileExtensions = fileExtensions;
     this.mediaTypes = mediaTypes;

package/src/parse/parsers/arazzo-json-1/index.cjs

@@ -44,7 +44,7 @@ class ArazzoJSON1Parser extends _Parser.default {
   async parse(file, options) {
     const source = file.toString();
     try {
-      const parserOpts = (0, _ramda.pick)(['sourceMap', 'strict', 'refractorOpts'], this);
+      const parserOpts = (0, _ramda.pick)(['sourceMap', 'style', 'strict', 'refractorOpts'], this);
       const parseResult = await (0, _apidomParserAdapterArazzoJson.parse)(source, parserOpts);
       const shouldParseSourceDescriptions = options?.parse?.parserOpts?.[this.name]?.sourceDescriptions ?? options?.parse?.parserOpts?.sourceDescriptions;
       if (shouldParseSourceDescriptions) {

package/src/parse/parsers/arazzo-json-1/index.mjs

@@ -37,7 +37,7 @@ class ArazzoJSON1Parser extends Parser {
   async parse(file, options) {
     const source = file.toString();
     try {
-      const parserOpts = pick(['sourceMap', 'strict', 'refractorOpts'], this);
+      const parserOpts = pick(['sourceMap', 'style', 'strict', 'refractorOpts'], this);
       const parseResult = await parse(source, parserOpts);
       const shouldParseSourceDescriptions = options?.parse?.parserOpts?.[this.name]?.sourceDescriptions ?? options?.parse?.parserOpts?.sourceDescriptions;
       if (shouldParseSourceDescriptions) {

package/src/parse/parsers/arazzo-yaml-1/index.cjs

@@ -44,7 +44,7 @@ class ArazzoYAML1Parser extends _Parser.default {
   async parse(file, options) {
     const source = file.toString();
     try {
-      const parserOpts = (0, _ramda.pick)(['sourceMap', 'strict', 'refractorOpts'], this);
+      const parserOpts = (0, _ramda.pick)(['sourceMap', 'style', 'strict', 'refractorOpts'], this);
       const parseResult = await (0, _apidomParserAdapterArazzoYaml.parse)(source, parserOpts);
       const shouldParseSourceDescriptions = options?.parse?.parserOpts?.[this.name]?.sourceDescriptions ?? options?.parse?.parserOpts?.sourceDescriptions;
       if (shouldParseSourceDescriptions) {

package/src/parse/parsers/arazzo-yaml-1/index.mjs

@@ -37,7 +37,7 @@ class ArazzoYAML1Parser extends Parser {
   async parse(file, options) {
     const source = file.toString();
     try {
-      const parserOpts = pick(['sourceMap', 'strict', 'refractorOpts'], this);
+      const parserOpts = pick(['sourceMap', 'style', 'strict', 'refractorOpts'], this);
       const parseResult = await parse(source, parserOpts);
       const shouldParseSourceDescriptions = options?.parse?.parserOpts?.[this.name]?.sourceDescriptions ?? options?.parse?.parserOpts?.sourceDescriptions;
       if (shouldParseSourceDescriptions) {

package/src/parse/parsers/asyncapi-json-2/index.cjs

@@ -42,7 +42,7 @@ class AsyncAPIJSON2Parser extends _Parser.default {
   async parse(file) {
     const source = file.toString();
     try {
-      const parserOpts = (0, _ramda.pick)(['sourceMap', 'strict', 'refractorOpts'], this);
+      const parserOpts = (0, _ramda.pick)(['sourceMap', 'style', 'strict', 'refractorOpts'], this);
       return await (0, _apidomParserAdapterAsyncapiJson.parse)(source, parserOpts);
     } catch (error) {
       throw new _ParserError.default(`Error parsing "${file.uri}"`, {

package/src/parse/parsers/asyncapi-json-2/index.mjs

@@ -36,7 +36,7 @@ class AsyncAPIJSON2Parser extends Parser {
   async parse(file) {
     const source = file.toString();
     try {
-      const parserOpts = pick(['sourceMap', 'strict', 'refractorOpts'], this);
+      const parserOpts = pick(['sourceMap', 'style', 'strict', 'refractorOpts'], this);
       return await parse(source, parserOpts);
     } catch (error) {
       throw new ParserError(`Error parsing "${file.uri}"`, {

package/src/parse/parsers/asyncapi-yaml-2/index.cjs

@@ -42,7 +42,7 @@ class AsyncAPIYAML2Parser extends _Parser.default {
   async parse(file) {
     const source = file.toString();
     try {
-      const parserOpts = (0, _ramda.pick)(['sourceMap', 'strict', 'refractorOpts'], this);
+      const parserOpts = (0, _ramda.pick)(['sourceMap', 'style', 'strict', 'refractorOpts'], this);
       return await (0, _apidomParserAdapterAsyncapiYaml.parse)(source, parserOpts);
     } catch (error) {
       throw new _ParserError.default(`Error parsing "${file.uri}"`, {

package/src/parse/parsers/asyncapi-yaml-2/index.mjs

@@ -36,7 +36,7 @@ class AsyncAPIYAML2Parser extends Parser {
   async parse(file) {
     const source = file.toString();
     try {
-      const parserOpts = pick(['sourceMap', 'strict', 'refractorOpts'], this);
+      const parserOpts = pick(['sourceMap', 'style', 'strict', 'refractorOpts'], this);
       return await parse(source, parserOpts);
     } catch (error) {
       throw new ParserError(`Error parsing "${file.uri}"`, {

package/src/parse/parsers/json/index.cjs

@@ -41,7 +41,7 @@ class JSONParser extends _Parser.default {
   async parse(file) {
     const source = file.toString();
     try {
-      const parserOpts = (0, _ramda.pick)(['sourceMap', 'strict'], this);
+      const parserOpts = (0, _ramda.pick)(['sourceMap', 'style', 'strict'], this);
       return await (0, _apidomParserAdapterJson.parse)(source, parserOpts);
     } catch (error) {
       throw new _ParserError.default(`Error parsing "${file.uri}"`, {

package/src/parse/parsers/json/index.mjs

@@ -35,7 +35,7 @@ class JSONParser extends Parser {
   async parse(file) {
     const source = file.toString();
     try {
-      const parserOpts = pick(['sourceMap', 'strict'], this);
+      const parserOpts = pick(['sourceMap', 'style', 'strict'], this);
       return await parse(source, parserOpts);
     } catch (error) {
       throw new ParserError(`Error parsing "${file.uri}"`, {

package/src/parse/parsers/openapi-json-2/index.cjs

@@ -42,7 +42,7 @@ class OpenAPIJSON2Parser extends _Parser.default {
   async parse(file) {
     const source = file.toString();
     try {
-      const parserOpts = (0, _ramda.pick)(['sourceMap', 'strict', 'refractorOpts'], this);
+      const parserOpts = (0, _ramda.pick)(['sourceMap', 'style', 'strict', 'refractorOpts'], this);
       return await (0, _apidomParserAdapterOpenapiJson.parse)(source, parserOpts);
     } catch (error) {
       throw new _ParserError.default(`Error parsing "${file.uri}"`, {

package/src/parse/parsers/openapi-json-2/index.mjs

@@ -36,7 +36,7 @@ class OpenAPIJSON2Parser extends Parser {
   async parse(file) {
     const source = file.toString();
     try {
-      const parserOpts = pick(['sourceMap', 'strict', 'refractorOpts'], this);
+      const parserOpts = pick(['sourceMap', 'style', 'strict', 'refractorOpts'], this);
       return await parse(source, parserOpts);
     } catch (error) {
       throw new ParserError(`Error parsing "${file.uri}"`, {

package/src/parse/parsers/openapi-json-3-0/index.cjs

@@ -42,7 +42,7 @@ class OpenAPIJSON3_0Parser extends _Parser.default {
   async parse(file) {
     const source = file.toString();
     try {
-      const parserOpts = (0, _ramda.pick)(['sourceMap', 'strict', 'refractorOpts'], this);
+      const parserOpts = (0, _ramda.pick)(['sourceMap', 'style', 'strict', 'refractorOpts'], this);
       return await (0, _apidomParserAdapterOpenapiJson.parse)(source, parserOpts);
     } catch (error) {
       throw new _ParserError.default(`Error parsing "${file.uri}"`, {

package/src/parse/parsers/openapi-json-3-0/index.mjs

@@ -36,7 +36,7 @@ class OpenAPIJSON3_0Parser extends Parser {
   async parse(file) {
     const source = file.toString();
     try {
-      const parserOpts = pick(['sourceMap', 'strict', 'refractorOpts'], this);
+      const parserOpts = pick(['sourceMap', 'style', 'strict', 'refractorOpts'], this);
       return await parse(source, parserOpts);
     } catch (error) {
       throw new ParserError(`Error parsing "${file.uri}"`, {

package/src/parse/parsers/openapi-json-3-1/index.cjs

@@ -42,7 +42,7 @@ class OpenAPIJSON3_1Parser extends _Parser.default {
   async parse(file) {
     const source = file.toString();
     try {
-      const parserOpts = (0, _ramda.pick)(['sourceMap', 'strict', 'refractorOpts'], this);
+      const parserOpts = (0, _ramda.pick)(['sourceMap', 'style', 'strict', 'refractorOpts'], this);
       return await (0, _apidomParserAdapterOpenapiJson.parse)(source, parserOpts);
     } catch (error) {
       throw new _ParserError.default(`Error parsing "${file.uri}"`, {

package/src/parse/parsers/openapi-json-3-1/index.mjs

@@ -36,7 +36,7 @@ class OpenAPIJSON3_1Parser extends Parser {
   async parse(file) {
     const source = file.toString();
     try {
-      const parserOpts = pick(['sourceMap', 'strict', 'refractorOpts'], this);
+      const parserOpts = pick(['sourceMap', 'style', 'strict', 'refractorOpts'], this);
       return await parse(source, parserOpts);
     } catch (error) {
       throw new ParserError(`Error parsing "${file.uri}"`, {

package/src/parse/parsers/openapi-yaml-2/index.cjs

@@ -42,7 +42,7 @@ class OpenAPIYAML2Parser extends _Parser.default {
   async parse(file) {
     const source = file.toString();
     try {
-      const parserOpts = (0, _ramda.pick)(['sourceMap', 'strict', 'refractorOpts'], this);
+      const parserOpts = (0, _ramda.pick)(['sourceMap', 'style', 'strict', 'refractorOpts'], this);
       return await (0, _apidomParserAdapterOpenapiYaml.parse)(source, parserOpts);
     } catch (error) {
       throw new _ParserError.default(`Error parsing "${file.uri}"`, {

package/src/parse/parsers/openapi-yaml-2/index.mjs

@@ -36,7 +36,7 @@ class OpenAPIYAML2Parser extends Parser {
   async parse(file) {
     const source = file.toString();
     try {
-      const parserOpts = pick(['sourceMap', 'strict', 'refractorOpts'], this);
+      const parserOpts = pick(['sourceMap', 'style', 'strict', 'refractorOpts'], this);
       return await parse(source, parserOpts);
     } catch (error) {
       throw new ParserError(`Error parsing "${file.uri}"`, {

package/src/parse/parsers/openapi-yaml-3-0/index.cjs

@@ -42,7 +42,7 @@ class OpenAPIYAML3_0Parser extends _Parser.default {
   async parse(file) {
     const source = file.toString();
     try {
-      const parserOpts = (0, _ramda.pick)(['sourceMap', 'strict', 'refractorOpts'], this);
+      const parserOpts = (0, _ramda.pick)(['sourceMap', 'style', 'strict', 'refractorOpts'], this);
       return await (0, _apidomParserAdapterOpenapiYaml.parse)(source, parserOpts);
     } catch (error) {
       throw new _ParserError.default(`Error parsing "${file.uri}"`, {

package/src/parse/parsers/openapi-yaml-3-0/index.mjs

@@ -36,7 +36,7 @@ class OpenAPIYAML3_0Parser extends Parser {
   async parse(file) {
     const source = file.toString();
     try {
-      const parserOpts = pick(['sourceMap', 'strict', 'refractorOpts'], this);
+      const parserOpts = pick(['sourceMap', 'style', 'strict', 'refractorOpts'], this);
       return await parse(source, parserOpts);
     } catch (error) {
       throw new ParserError(`Error parsing "${file.uri}"`, {

package/src/parse/parsers/openapi-yaml-3-1/index.cjs

@@ -42,7 +42,7 @@ class OpenAPIYAML3_1Parser extends _Parser.default {
   async parse(file) {
     const source = file.toString();
     try {
-      const parserOpts = (0, _ramda.pick)(['sourceMap', 'strict', 'refractorOpts'], this);
+      const parserOpts = (0, _ramda.pick)(['sourceMap', 'style', 'strict', 'refractorOpts'], this);
       return await (0, _apidomParserAdapterOpenapiYaml.parse)(source, parserOpts);
     } catch (error) {
       throw new _ParserError.default(`Error parsing "${file.uri}"`, {

package/src/parse/parsers/openapi-yaml-3-1/index.mjs

@@ -36,7 +36,7 @@ class OpenAPIYAML3_1Parser extends Parser {
   async parse(file) {
     const source = file.toString();
     try {
-      const parserOpts = pick(['sourceMap', 'strict', 'refractorOpts'], this);
+      const parserOpts = pick(['sourceMap', 'style', 'strict', 'refractorOpts'], this);
       return await parse(source, parserOpts);
     } catch (error) {
       throw new ParserError(`Error parsing "${file.uri}"`, {

package/src/parse/parsers/yaml-1-2/index.cjs

@@ -43,6 +43,7 @@ class YAML1Parser extends _Parser.default {
     try {
       return await (0, _apidomParserAdapterYaml.parse)(source, {
         sourceMap: this.sourceMap,
+        style: this.style,
         strict: this.strict
       });
     } catch (error) {

package/src/parse/parsers/yaml-1-2/index.mjs

@@ -37,6 +37,7 @@ class YAML1Parser extends Parser {
     try {
       return await parse(source, {
         sourceMap: this.sourceMap,
+        style: this.style,
         strict: this.strict
       });
     } catch (error) {

package/types/apidom-reference.d.ts

@@ -331,6 +331,10 @@ export declare abstract class Parser {
      * Whether to generate source map during parsing.
      */
     sourceMap: boolean;
+    /**
+     * Whether to capture format-specific style information for round-trip preservation.
+     */
+    style: boolean;
     /**
      * Whether to use strict parsing (native JSON.parse/YAML instead of tree-sitter).
      */
@@ -343,7 +347,7 @@ export declare abstract class Parser {
      * List of supported media types.
      */
     mediaTypes: string[];
-    constructor({ name, allowEmpty, sourceMap, strict, fileExtensions, mediaTypes, }: ParserOptions);
+    constructor({ name, allowEmpty, sourceMap, style, strict, fileExtensions, mediaTypes, }: ParserOptions);
     abstract canParse(file: File_2, options?: ApiDOMReferenceOptions): boolean | Promise<boolean>;
     abstract parse(file: File_2, options?: ApiDOMReferenceOptions): ParseResultElement | Promise<ParseResultElement>;
 }
@@ -361,6 +365,7 @@ export declare interface ParserOptions {
     readonly name: string;
     readonly allowEmpty?: boolean;
     readonly sourceMap?: boolean;
+    readonly style?: boolean;
     readonly strict?: boolean;
     readonly fileExtensions?: string[];
     readonly mediaTypes?: string[];

package/types/parse/parsers/Parser.d.ts

@@ -8,6 +8,7 @@ export interface ParserOptions {
     readonly name: string;
     readonly allowEmpty?: boolean;
     readonly sourceMap?: boolean;
+    readonly style?: boolean;
     readonly strict?: boolean;
     readonly fileExtensions?: string[];
     readonly mediaTypes?: string[];
@@ -25,6 +26,10 @@ declare abstract class Parser {
      * Whether to generate source map during parsing.
      */
     sourceMap: boolean;
+    /**
+     * Whether to capture format-specific style information for round-trip preservation.
+     */
+    style: boolean;
     /**
      * Whether to use strict parsing (native JSON.parse/YAML instead of tree-sitter).
      */
@@ -37,7 +42,7 @@ declare abstract class Parser {
      * List of supported media types.
      */
     mediaTypes: string[];
-    constructor({ name, allowEmpty, sourceMap, strict, fileExtensions, mediaTypes, }: ParserOptions);
+    constructor({ name, allowEmpty, sourceMap, style, strict, fileExtensions, mediaTypes, }: ParserOptions);
     abstract canParse(file: File, options?: ReferenceOptions): boolean | Promise<boolean>;
     abstract parse(file: File, options?: ReferenceOptions): ParseResultElement | Promise<ParseResultElement>;
 }