@ac-kit/format-yaml 0.1.0

package/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2024-2026 Anthony Champagne and contributors
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -0,0 +1,34 @@
+# @ac-kit/format-yaml
+
+YAML — including the part most parsers gloss over: a single file may hold
+several documents, separated by `---`, and a Kubernetes manifest or a CI config
+usually does.
+
+```ts
+import { parseAllYamlDocuments, parseYaml, printYaml } from "@ac-kit/format-yaml";
+
+parseYaml("port: 8080");
+
+// A multi-document file, as one value per document.
+for (const document of parseAllYamlDocuments(manifestSource)) {
+  deploy(document);
+}
+```
+
+## What it exposes
+
+- `parseYaml` / `printYaml` — a single document.
+- `parseYamlDocument` / `printYamlDocument` — the document node, when you need
+  its metadata rather than only its value.
+- `parseAllYamlDocuments` — every document in a multi-document stream.
+- `editYaml` / `createYamlEdits` — change one value, leaving the rest of the
+  source as it was.
+- `YamlParseStream`, `YamlPrintStream`, and the document-oriented stream
+  variants — `TransformStream`s over `@ac-kit/format-core`.
+
+Portable: no Node.js built-ins, so it runs unchanged in browsers, Deno, Bun and
+edge runtimes.
+
+See the
+[generated API docs](https://anthochamp.github.io/node-essentials/api/format-yaml/)
+for the full reference.

package/dist/document-parse-stream.d.ts

@@ -0,0 +1,11 @@
+import * as yaml from "yaml";
+export type YamlDocumentParseStreamOptions = {
+    parseOptions?: yaml.ParseOptions;
+    documentOptions?: yaml.DocumentOptions;
+    schemaOptions?: yaml.SchemaOptions;
+};
+/** Buffers a byte stream and emits one {@link yaml.Document} on flush. */
+export declare class YamlDocumentParseStream extends TransformStream<Uint8Array, yaml.Document> {
+    constructor(options?: YamlDocumentParseStreamOptions);
+}
+//# sourceMappingURL=document-parse-stream.d.ts.map

package/dist/document-parse-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-parse-stream.d.ts","sourceRoot":"","sources":["../src/document-parse-stream.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,MAAM,MAAM,8BAA8B,GAAG;IAC5C,YAAY,CAAC,EAAE,IAAI,CAAC,YAAY,CAAC;IACjC,eAAe,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC;IACvC,aAAa,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC;CACnC,CAAC;AAEF,0EAA0E;AAC1E,qBAAa,uBAAwB,SAAQ,eAAe,CAC3D,UAAU,EACV,IAAI,CAAC,QAAQ,CACb;IACA,YAAY,OAAO,GAAE,8BAAmC,EAYvD;CACD"}

package/dist/document-parse-stream.js

@@ -0,0 +1,13 @@
+import { wholeTextParseTransformer } from "@ac-kit/format-core";
+import * as yaml from "yaml";
+/** Buffers a byte stream and emits one {@link yaml.Document} on flush. */
+export class YamlDocumentParseStream extends TransformStream {
+    constructor(options = {}) {
+        super(wholeTextParseTransformer((source) => yaml.parseDocument(source, {
+            ...options.parseOptions,
+            ...options.documentOptions,
+            ...options.schemaOptions,
+        }), "YAML document"));
+    }
+}
+//# sourceMappingURL=document-parse-stream.js.map

package/dist/document-parse-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-parse-stream.js","sourceRoot":"","sources":["../src/document-parse-stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAQ7B,0EAA0E;AAC1E,MAAM,OAAO,uBAAwB,SAAQ,eAG5C;IACA,YAAY,OAAO,GAAmC,EAAE;QACvD,KAAK,CACJ,yBAAyB,CACxB,CAAC,MAAM,EAAE,EAAE,CACV,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE;YAC1B,GAAG,OAAO,CAAC,YAAY;YACvB,GAAG,OAAO,CAAC,eAAe;YAC1B,GAAG,OAAO,CAAC,aAAa;SACxB,CAAC,EACH,eAAe,CACf,CACD,CAAC;IACH,CAAC;CACD"}

package/dist/document-print-stream.d.ts

@@ -0,0 +1,6 @@
+import * as yaml from "yaml";
+/** Emits each incoming {@link yaml.Document} as UTF-8 encoded YAML. */
+export declare class YamlDocumentPrintStream extends TransformStream<yaml.Document, Uint8Array> {
+    constructor(options?: yaml.ToStringOptions);
+}
+//# sourceMappingURL=document-print-stream.d.ts.map

package/dist/document-print-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-print-stream.d.ts","sourceRoot":"","sources":["../src/document-print-stream.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,uEAAuE;AACvE,qBAAa,uBAAwB,SAAQ,eAAe,CAC3D,IAAI,CAAC,QAAQ,EACb,UAAU,CACV;IACA,YAAY,OAAO,GAAE,IAAI,CAAC,eAAoB,EAO7C;CACD"}

package/dist/document-print-stream.js

@@ -0,0 +1,8 @@
+import { textPrintTransformer } from "@ac-kit/format-core";
+/** Emits each incoming {@link yaml.Document} as UTF-8 encoded YAML. */
+export class YamlDocumentPrintStream extends TransformStream {
+    constructor(options = {}) {
+        super(textPrintTransformer((document) => document.toString(options), "YAML document"));
+    }
+}
+//# sourceMappingURL=document-print-stream.js.map

package/dist/document-print-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-print-stream.js","sourceRoot":"","sources":["../src/document-print-stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAG3D,uEAAuE;AACvE,MAAM,OAAO,uBAAwB,SAAQ,eAG5C;IACA,YAAY,OAAO,GAAyB,EAAE;QAC7C,KAAK,CACJ,oBAAoB,CACnB,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,EACxC,eAAe,CACf,CACD,CAAC;IACH,CAAC;CACD"}

package/dist/documents-parse-stream.d.ts

@@ -0,0 +1,14 @@
+import * as yaml from "yaml";
+export type YamlDocumentsParseStreamOptions = {
+    customTags?: yaml.SchemaOptions["customTags"];
+    version?: yaml.DocumentOptions["version"];
+    schema?: yaml.SchemaOptions["schema"];
+};
+/**
+ * Buffers a byte stream and emits every {@link yaml.Document} it contains on
+ * flush.
+ */
+export declare class YamlDocumentsParseStream extends TransformStream<Uint8Array, yaml.Document> {
+    constructor(options?: YamlDocumentsParseStreamOptions);
+}
+//# sourceMappingURL=documents-parse-stream.d.ts.map

package/dist/documents-parse-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents-parse-stream.d.ts","sourceRoot":"","sources":["../src/documents-parse-stream.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,MAAM,MAAM,+BAA+B,GAAG;IAC7C,UAAU,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;IAC9C,OAAO,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;IAC1C,MAAM,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;CACtC,CAAC;AAEF;;;GAGG;AACH,qBAAa,wBAAyB,SAAQ,eAAe,CAC5D,UAAU,EACV,IAAI,CAAC,QAAQ,CACb;IACA,YAAY,OAAO,GAAE,+BAAoC,EAkBxD;CACD"}

package/dist/documents-parse-stream.js

@@ -0,0 +1,28 @@
+import { concatBytes, decodeText } from "@ac-kit/core";
+import * as yaml from "yaml";
+/**
+ * Buffers a byte stream and emits every {@link yaml.Document} it contains on
+ * flush.
+ */
+export class YamlDocumentsParseStream extends TransformStream {
+    constructor(options = {}) {
+        const chunks = [];
+        super({
+            transform(chunk) {
+                chunks.push(chunk);
+            },
+            flush(controller) {
+                const source = decodeText(concatBytes(chunks), "utf-8");
+                try {
+                    for (const document of yaml.parseAllDocuments(source, options)) {
+                        controller.enqueue(document);
+                    }
+                }
+                catch (error) {
+                    throw new Error("parse YAML documents", { cause: error });
+                }
+            },
+        });
+    }
+}
+//# sourceMappingURL=documents-parse-stream.js.map

package/dist/documents-parse-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents-parse-stream.js","sourceRoot":"","sources":["../src/documents-parse-stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAQ7B;;;GAGG;AACH,MAAM,OAAO,wBAAyB,SAAQ,eAG7C;IACA,YAAY,OAAO,GAAoC,EAAE;QACxD,MAAM,MAAM,GAAiB,EAAE,CAAC;QAChC,KAAK,CAAC;YACL,SAAS,CAAC,KAAK;gBACd,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACpB,CAAC;YACD,KAAK,CAAC,UAAU;gBACf,MAAM,MAAM,GAAG,UAAU,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC;gBAExD,IAAI,CAAC;oBACJ,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;wBAChE,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;oBAC9B,CAAC;gBACF,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBAChB,MAAM,IAAI,KAAK,CAAC,sBAAsB,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;gBAC3D,CAAC;YACF,CAAC;SACD,CAAC,CAAC;IACJ,CAAC;CACD"}

package/dist/documents-print-stream.d.ts

@@ -0,0 +1,6 @@
+import * as yaml from "yaml";
+/** Emits each incoming {@link yaml.Document} as UTF-8 encoded YAML. */
+export declare class YamlDocumentsPrintStream extends TransformStream<yaml.Document, Uint8Array> {
+    constructor(options?: yaml.ToStringOptions);
+}
+//# sourceMappingURL=documents-print-stream.d.ts.map

package/dist/documents-print-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents-print-stream.d.ts","sourceRoot":"","sources":["../src/documents-print-stream.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,uEAAuE;AACvE,qBAAa,wBAAyB,SAAQ,eAAe,CAC5D,IAAI,CAAC,QAAQ,EACb,UAAU,CACV;IACA,YAAY,OAAO,GAAE,IAAI,CAAC,eAAoB,EAO7C;CACD"}

package/dist/documents-print-stream.js

@@ -0,0 +1,8 @@
+import { textPrintTransformer } from "@ac-kit/format-core";
+/** Emits each incoming {@link yaml.Document} as UTF-8 encoded YAML. */
+export class YamlDocumentsPrintStream extends TransformStream {
+    constructor(options = {}) {
+        super(textPrintTransformer((document) => document.toString(options), "YAML documents"));
+    }
+}
+//# sourceMappingURL=documents-print-stream.js.map

package/dist/documents-print-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents-print-stream.js","sourceRoot":"","sources":["../src/documents-print-stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAG3D,uEAAuE;AACvE,MAAM,OAAO,wBAAyB,SAAQ,eAG7C;IACA,YAAY,OAAO,GAAyB,EAAE;QAC7C,KAAK,CACJ,oBAAoB,CACnB,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,EACxC,gBAAgB,CAChB,CACD,CAAC;IACH,CAAC;CACD"}

package/dist/edit.d.ts

@@ -0,0 +1,18 @@
+import { PropertyPath, TextEdit } from "@ac-kit/core";
+import * as yaml from "yaml";
+import { type YamlPrintOptions } from "./print.js";
+/**
+ * Returns the {@link TextEdit} needed to set `value` at `path`.
+ *
+ * Medium-fidelity: uses `yaml.Document` mutation then reprints — a single
+ * full-replace edit.
+ */
+export declare function createYamlEdits(source: string, path: PropertyPath, value: unknown, options?: yaml.ToStringOptions): TextEdit[];
+/**
+ * Sets `value` at `path` in a YAML string and returns the updated source.
+ *
+ * Medium-fidelity: uses `yaml.Document` mutation then reprints — preserves
+ * structure outside the patched section but discards comments near it.
+ */
+export declare function editYaml(source: string, path: PropertyPath, value: unknown, options?: YamlPrintOptions): string;
+//# sourceMappingURL=edit.d.ts.map

package/dist/edit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit.d.ts","sourceRoot":"","sources":["../src/edit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAkB,MAAM,cAAc,CAAC;AACtE,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;;;;GAKG;AACH,wBAAgB,eAAe,CAC9B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,IAAI,CAAC,eAAe,GAC5B,QAAQ,EAAE,CAKZ;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CACvB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,gBAAgB,GACxB,MAAM,CAER"}

package/dist/edit.js

@@ -0,0 +1,24 @@
+import { applyTextEdits } from "@ac-kit/core";
+import * as yaml from "yaml";
+/**
+ * Returns the {@link TextEdit} needed to set `value` at `path`.
+ *
+ * Medium-fidelity: uses `yaml.Document` mutation then reprints — a single
+ * full-replace edit.
+ */
+export function createYamlEdits(source, path, value, options) {
+    const doc = yaml.parseDocument(source);
+    doc.setIn(path, value);
+    const newSource = doc.toString(options);
+    return [{ offset: 0, length: source.length, content: newSource }];
+}
+/**
+ * Sets `value` at `path` in a YAML string and returns the updated source.
+ *
+ * Medium-fidelity: uses `yaml.Document` mutation then reprints — preserves
+ * structure outside the patched section but discards comments near it.
+ */
+export function editYaml(source, path, value, options) {
+    return applyTextEdits(source, createYamlEdits(source, path, value, options));
+}
+//# sourceMappingURL=edit.js.map

package/dist/edit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit.js","sourceRoot":"","sources":["../src/edit.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,cAAc,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAI7B;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAC9B,MAAc,EACd,IAAkB,EAClB,KAAc,EACd,OAA8B;IAE9B,MAAM,GAAG,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IACvC,GAAG,CAAC,KAAK,CAAC,IAA2B,EAAE,KAAK,CAAC,CAAC;IAC9C,MAAM,SAAS,GAAG,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACxC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;AACnE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CACvB,MAAc,EACd,IAAkB,EAClB,KAAc,EACd,OAA0B;IAE1B,OAAO,cAAc,CAAC,MAAM,EAAE,eAAe,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;AAC9E,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export * from "./document-parse-stream.js";
+export * from "./document-print-stream.js";
+export * from "./documents-parse-stream.js";
+export * from "./documents-print-stream.js";
+export * from "./edit.js";
+export * from "./parse-stream.js";
+export * from "./parse.js";
+export * from "./print-stream.js";
+export * from "./print.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+export * from "./document-parse-stream.js";
+export * from "./document-print-stream.js";
+export * from "./documents-parse-stream.js";
+export * from "./documents-print-stream.js";
+export * from "./edit.js";
+export * from "./parse-stream.js";
+export * from "./parse.js";
+export * from "./print-stream.js";
+export * from "./print.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC"}

package/dist/parse-stream.d.ts

@@ -0,0 +1,7 @@
+import * as yaml from "yaml";
+export type YamlParseStreamOptions = yaml.ParseOptions & yaml.DocumentOptions & yaml.SchemaOptions;
+/** Buffers a byte stream and emits one parsed YAML value on flush. */
+export declare class YamlParseStream extends TransformStream<Uint8Array, unknown> {
+    constructor(options?: YamlParseStreamOptions);
+}
+//# sourceMappingURL=parse-stream.d.ts.map

package/dist/parse-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-stream.d.ts","sourceRoot":"","sources":["../src/parse-stream.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,MAAM,MAAM,sBAAsB,GAAG,IAAI,CAAC,YAAY,GACrD,IAAI,CAAC,eAAe,GACpB,IAAI,CAAC,aAAa,CAAC;AAEpB,sEAAsE;AACtE,qBAAa,eAAgB,SAAQ,eAAe,CAAC,UAAU,EAAE,OAAO,CAAC;IACxE,YAAY,OAAO,GAAE,sBAA2B,EAO/C;CACD"}

package/dist/parse-stream.js

@@ -0,0 +1,9 @@
+import { wholeTextParseTransformer } from "@ac-kit/format-core";
+import * as yaml from "yaml";
+/** Buffers a byte stream and emits one parsed YAML value on flush. */
+export class YamlParseStream extends TransformStream {
+    constructor(options = {}) {
+        super(wholeTextParseTransformer((source) => yaml.parse(source, options), "YAML"));
+    }
+}
+//# sourceMappingURL=parse-stream.js.map

package/dist/parse-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-stream.js","sourceRoot":"","sources":["../src/parse-stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAM7B,sEAAsE;AACtE,MAAM,OAAO,eAAgB,SAAQ,eAAoC;IACxE,YAAY,OAAO,GAA2B,EAAE;QAC/C,KAAK,CACJ,yBAAyB,CACxB,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAY,EAClD,MAAM,CACN,CACD,CAAC;IACH,CAAC;CACD"}

package/dist/parse.d.ts

@@ -0,0 +1,9 @@
+import * as yaml from "yaml";
+export type YamlParseOptions = yaml.ParseOptions & yaml.DocumentOptions & yaml.SchemaOptions & yaml.ToJSOptions;
+/** Parses a YAML string into a plain JS value. */
+export declare function parseYaml(source: string, options?: YamlParseOptions): unknown;
+/** Parses a YAML string into a {@link yaml.Document} (CST-level). */
+export declare function parseYamlDocument(source: string, options?: yaml.ParseOptions & yaml.DocumentOptions & yaml.SchemaOptions): yaml.Document;
+/** Parses all YAML documents from a multi-document string. */
+export declare function parseAllYamlDocuments(source: string, options?: yaml.ParseOptions & yaml.DocumentOptions & yaml.SchemaOptions): yaml.Document[];
+//# sourceMappingURL=parse.d.ts.map

package/dist/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,YAAY,GAC/C,IAAI,CAAC,eAAe,GACpB,IAAI,CAAC,aAAa,GAClB,IAAI,CAAC,WAAW,CAAC;AAElB,kDAAkD;AAClD,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAM7E;AAED,qEAAqE;AACrE,wBAAgB,iBAAiB,CAChC,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,aAAa,GACrE,IAAI,CAAC,QAAQ,CAEf;AAED,8DAA8D;AAC9D,wBAAgB,qBAAqB,CACpC,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,aAAa,GACrE,IAAI,CAAC,QAAQ,EAAE,CAEjB"}

package/dist/parse.js

@@ -0,0 +1,19 @@
+import * as yaml from "yaml";
+/** Parses a YAML string into a plain JS value. */
+export function parseYaml(source, options) {
+    try {
+        return yaml.parse(source, options);
+    }
+    catch (error) {
+        throw new Error("parse YAML", { cause: error });
+    }
+}
+/** Parses a YAML string into a {@link yaml.Document} (CST-level). */
+export function parseYamlDocument(source, options) {
+    return yaml.parseDocument(source, options);
+}
+/** Parses all YAML documents from a multi-document string. */
+export function parseAllYamlDocuments(source, options) {
+    return yaml.parseAllDocuments(source, options);
+}
+//# sourceMappingURL=parse.js.map

package/dist/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAO7B,kDAAkD;AAClD,MAAM,UAAU,SAAS,CAAC,MAAc,EAAE,OAA0B;IACnE,IAAI,CAAC;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACjD,CAAC;AACF,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,iBAAiB,CAChC,MAAc,EACd,OAAuE;IAEvE,OAAO,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC5C,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,qBAAqB,CACpC,MAAc,EACd,OAAuE;IAEvE,OAAO,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAChD,CAAC"}

package/dist/print-stream.d.ts

@@ -0,0 +1,7 @@
+import * as yaml from "yaml";
+export type YamlPrintStreamOptions = yaml.DocumentOptions & yaml.SchemaOptions & yaml.ParseOptions & yaml.CreateNodeOptions & yaml.ToStringOptions;
+/** Emits each incoming value as a UTF-8 encoded YAML document. */
+export declare class YamlPrintStream extends TransformStream<unknown, Uint8Array> {
+    constructor(options?: YamlPrintStreamOptions);
+}
+//# sourceMappingURL=print-stream.d.ts.map

package/dist/print-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"print-stream.d.ts","sourceRoot":"","sources":["../src/print-stream.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,MAAM,MAAM,sBAAsB,GAAG,IAAI,CAAC,eAAe,GACxD,IAAI,CAAC,aAAa,GAClB,IAAI,CAAC,YAAY,GACjB,IAAI,CAAC,iBAAiB,GACtB,IAAI,CAAC,eAAe,CAAC;AAEtB,kEAAkE;AAClE,qBAAa,eAAgB,SAAQ,eAAe,CAAC,OAAO,EAAE,UAAU,CAAC;IACxE,YAAY,OAAO,GAAE,sBAA2B,EAI/C;CACD"}

package/dist/print-stream.js

@@ -0,0 +1,9 @@
+import { textPrintTransformer } from "@ac-kit/format-core";
+import * as yaml from "yaml";
+/** Emits each incoming value as a UTF-8 encoded YAML document. */
+export class YamlPrintStream extends TransformStream {
+    constructor(options = {}) {
+        super(textPrintTransformer((value) => yaml.stringify(value, options), "YAML"));
+    }
+}
+//# sourceMappingURL=print-stream.js.map

package/dist/print-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"print-stream.js","sourceRoot":"","sources":["../src/print-stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAQ7B,kEAAkE;AAClE,MAAM,OAAO,eAAgB,SAAQ,eAAoC;IACxE,YAAY,OAAO,GAA2B,EAAE;QAC/C,KAAK,CACJ,oBAAoB,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,CACvE,CAAC;IACH,CAAC;CACD"}

package/dist/print.d.ts

@@ -0,0 +1,7 @@
+import * as yaml from "yaml";
+export type YamlPrintOptions = yaml.DocumentOptions & yaml.SchemaOptions & yaml.CreateNodeOptions & yaml.ToStringOptions;
+/** Serializes a value to a YAML string. */
+export declare function printYaml(value: unknown, options?: YamlPrintOptions): string;
+/** Serializes a {@link yaml.Document} to a YAML string. */
+export declare function printYamlDocument(doc: yaml.Document, options?: yaml.ToStringOptions): string;
+//# sourceMappingURL=print.d.ts.map

package/dist/print.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"print.d.ts","sourceRoot":"","sources":["../src/print.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,eAAe,GAClD,IAAI,CAAC,aAAa,GAClB,IAAI,CAAC,iBAAiB,GACtB,IAAI,CAAC,eAAe,CAAC;AAEtB,2CAA2C;AAC3C,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAM5E;AAED,2DAA2D;AAC3D,wBAAgB,iBAAiB,CAChC,GAAG,EAAE,IAAI,CAAC,QAAQ,EAClB,OAAO,CAAC,EAAE,IAAI,CAAC,eAAe,GAC5B,MAAM,CAER"}

package/dist/print.js

@@ -0,0 +1,15 @@
+import * as yaml from "yaml";
+/** Serializes a value to a YAML string. */
+export function printYaml(value, options) {
+    try {
+        return yaml.stringify(value, options);
+    }
+    catch (error) {
+        throw new Error("print YAML", { cause: error });
+    }
+}
+/** Serializes a {@link yaml.Document} to a YAML string. */
+export function printYamlDocument(doc, options) {
+    return doc.toString(options);
+}
+//# sourceMappingURL=print.js.map

package/dist/print.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"print.js","sourceRoot":"","sources":["../src/print.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAO7B,2CAA2C;AAC3C,MAAM,UAAU,SAAS,CAAC,KAAc,EAAE,OAA0B;IACnE,IAAI,CAAC;QACJ,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACjD,CAAC;AACF,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,iBAAiB,CAChC,GAAkB,EAClB,OAA8B;IAE9B,OAAO,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC9B,CAAC"}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@ac-kit/format-yaml",
+  "version": "0.1.0",
+  "description": "YAML parse and print streams over @ac-kit/format-core.",
+  "keywords": [
+    "config",
+    "parser",
+    "streams",
+    "yaml"
+  ],
+  "homepage": "https://anthochamp.github.io/node-essentials/api/format-yaml/",
+  "bugs": {
+    "url": "https://github.com/anthochamp/node-essentials/issues"
+  },
+  "license": "BSD-3-Clause",
+  "author": "Anthony Champagne <dev@anthonychampagne.fr>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/anthochamp/node-essentials.git",
+    "directory": "packages/format-yaml"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "exports": {
+    ".": "./dist/index.js",
+    "./file": "./dist/file.js"
+  },
+  "publishConfig": {
+    "main": "./dist/index.js",
+    "exports": {
+      ".": "./dist/index.js",
+      "./file": "./dist/file.js"
+    },
+    "access": "public"
+  },
+  "scripts": {
+    "compile": "tsc -p ./tsconfig.build.json -outDir dist",
+    "compile:check": "tsc -noEmit -p ./tsconfig.json",
+    "clean": "rimraf dist",
+    "build": "yarn clean && yarn compile",
+    "test": "yarn run -T vitest run",
+    "prepack": "yarn build"
+  },
+  "dependencies": {
+    "@ac-kit/core": "^0.1.0",
+    "@ac-kit/format-core": "^0.1.0",
+    "@types/node": "^26.5.1",
+    "yaml": "^2.9.0"
+  },
+  "devDependencies": {
+    "@ac-kit/tsconfig": "0.1.0",
+    "@ac-kit/typedoc-config": "0.1.0",
+    "@ac-kit/vitest-config": "0.1.0",
+    "@typescript/native": "typescript@7.0.2",
+    "rimraf": "6.1.3",
+    "typedoc": "0.28.20",
+    "typescript": "@typescript/typescript6@6.0.2"
+  },
+  "engines": {
+    "node": ">=24"
+  }
+}