@speclynx/apidom-parser-adapter-yaml-1-2 2.11.0 → 2.12.1

package/CHANGELOG.md

@@ -3,6 +3,16 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [2.12.1](https://github.com/speclynx/apidom/compare/v2.12.0...v2.12.1) (2026-02-18)
+
+**Note:** Version bump only for package @speclynx/apidom-parser-adapter-yaml-1-2
+
+# [2.12.0](https://github.com/speclynx/apidom/compare/v2.11.0...v2.12.0) (2026-02-18)
+
+### Features
+
+- add support for lossless JSON/YAML roundtrips ([#97](https://github.com/speclynx/apidom/issues/97)) ([dc17c9a](https://github.com/speclynx/apidom/commit/dc17c9a78fbc7df07a91e8f35b12be6409117d91))
+
 # [2.11.0](https://github.com/speclynx/apidom/compare/v2.10.3...v2.11.0) (2026-02-12)
 
 **Note:** Version bump only for package @speclynx/apidom-parser-adapter-yaml-1-2

package/README.md

@@ -64,7 +64,8 @@ This adapter exposes an instance of [base ApiDOM namespace](https://github.com/s
 Option | Type | Default | Description
 --- | --- | --- | ---
 <a name="sourceMap"></a>`sourceMap` | `Boolean` | `false` | Indicate whether to generate source maps.
-<a name="strict"></a>`strict` | `Boolean` | `false` | Use strict parsing mode ([yaml](https://www.npmjs.com/package/yaml) library). When `true`, parsing is faster but doesn't support source maps.
+<a name="style"></a>`style` | `Boolean` | `false` | Indicate whether to capture format-specific style information for round-trip preservation.
+<a name="strict"></a>`strict` | `Boolean` | `false` | Use strict parsing mode ([yaml](https://www.npmjs.com/package/yaml) library). When `true`, parsing is faster but doesn't support source maps or style preservation.
 
 All unrecognized arbitrary options will be ignored.
 
@@ -76,12 +77,14 @@ This adapter supports two parsing modes:
 - Uses [web-tree-sitter](https://www.npmjs.com/package/web-tree-sitter) for parsing
 - Provides error recovery for malformed YAML
 - Supports source map generation
+- Supports style preservation (quoting styles, flow/block, comments, indentation)
 - Full YAML 1.2 spec compliance with custom AST
 
 **Strict mode** (`strict: true`):
 - Uses [yaml](https://www.npmjs.com/package/yaml) library for parsing
 - Faster performance
 - Does not support source maps (throws error if both `strict` and `sourceMap` are `true`)
+- Does not support style preservation (throws error if both `strict` and `style` are `true`)
 
 ## Usage
 
@@ -105,7 +108,10 @@ await detect('prop: value', { strict: true }); // => true
 // parsing (tree-sitter mode - default, with source maps)
 const parseResult = await parse('prop: value', { sourceMap: true });
 
-// parsing (strict mode - faster, no source maps)
+// parsing (tree-sitter mode, with style preservation)
+const parseResultStyled = await parse('prop: value', { style: true });
+
+// parsing (strict mode - faster, no source maps or style)
 const parseResultStrict = await parse('prop: value', { strict: true });
 ```