@sebastienrousseau/noyalib-wasm 0.0.12

package/README.md

@@ -0,0 +1,333 @@
+<!-- SPDX-License-Identifier: Apache-2.0 OR MIT -->
+
+<p align="center">
+  <img src="https://cloudcdn.pro/noyalib/v1/logos/noyalib.svg" alt="Noyalib logo" width="128" />
+</p>
+
+<h1 align="center">noyalib-wasm</h1>
+
+<p align="center">
+  <strong><code>wasm-bindgen</code> wrapper around noyalib —
+  pure-Rust YAML 1.2, zero <code>unsafe</code>, ~338 KB after
+  LTO. Runs in browsers, Node, Cloudflare Workers, Deno, and
+  any other WASM-capable host.</strong>
+</p>
+
+<p align="center">
+  <a href="https://github.com/sebastienrousseau/noyalib/actions"><img src="https://img.shields.io/github/actions/workflow/status/sebastienrousseau/noyalib/ci.yml?style=for-the-badge&logo=github" alt="Build" /></a>
+  <a href="https://www.npmjs.com/package/@noyalib/noyalib-wasm"><img src="https://img.shields.io/npm/v/@noyalib/noyalib-wasm?style=for-the-badge&color=fc8d62&logo=npm" alt="npm" /></a>
+  <a href="https://docs.rs/noyalib-wasm"><img src="https://img.shields.io/badge/docs.rs-noyalib--wasm-66c2a5?style=for-the-badge&labelColor=555555&logo=docs.rs" alt="Docs.rs" /></a>
+  <a href="https://bundlephobia.com/package/@noyalib/noyalib-wasm"><img src="https://img.shields.io/bundlephobia/minzip/@noyalib/noyalib-wasm?style=for-the-badge&color=informational" alt="Bundle size" /></a>
+  <a href="https://scorecard.dev/viewer/?uri=github.com/sebastienrousseau/noyalib"><img src="https://img.shields.io/ossf-scorecard/github.com/sebastienrousseau/noyalib?style=for-the-badge&label=OpenSSF%20Scorecard&logo=openssf" alt="OpenSSF Scorecard" /></a>
+</p>
+
+---
+
+## Contents
+
+- [Install](#install) — npm, build from source
+- [Quick Start](#quick-start) — parse, edit, validate
+- [Why this approach?](#why-this-approach) — vs `js-yaml`
+- [Surface](#surface) — exported APIs
+- [Bundle size](#bundle-size) — what you ship to users
+- [Targets](#targets) — every wasm-pack flavour
+- [Provenance](#provenance) — npm + cosign
+- [Examples](#examples) — Node + browser demos
+- [When not to use noyalib-wasm](#when-not-to-use-noyalib-wasm)
+- [Documentation](#documentation)
+- [License](#license)
+
+---
+
+## Install
+
+```sh
+npm install @noyalib/noyalib-wasm
+# or
+pnpm add @noyalib/noyalib-wasm
+# or
+yarn add @noyalib/noyalib-wasm
+```
+
+Or build from source against any wasm-pack target:
+
+```sh
+git clone https://github.com/sebastienrousseau/noyalib-wasm
+cd noyalib-wasm
+wasm-pack build --release --target bundler
+```
+
+> **Split from the monorepo since v0.0.12.** Prior versions
+> shipped from `sebastienrousseau/noyalib/crates/noyalib-wasm/`.
+> From v0.0.12 onward `noyalib-wasm` lives here as its own crate,
+> released in strict lockstep with the parent
+> [`noyalib`](https://github.com/sebastienrousseau/noyalib) at
+> the same version. See
+> [ADR-0005](https://github.com/sebastienrousseau/noyalib/blob/main/doc/adr/0005-workspace-split.md)
+> for the rationale and rollback recipe.
+
+---
+
+## Quick Start
+
+```js
+import init, {
+  parse,
+  stringify,
+  validateJson,
+  getPath,
+  merge,
+  WasmDocument,
+} from "@noyalib/noyalib-wasm";
+
+await init();          // load the WASM blob
+
+// Plain parse / stringify — like js-yaml. Mappings come back as
+// plain JS Objects (not `Map`), so dotted property access works.
+const obj = parse("host: api.example.com\nport: 8080\n");
+console.log(obj.host); // "api.example.com"
+const yaml = stringify(obj);
+
+// Indexed read without going through `parse`.
+const port = getPath("host: api.example.com\nport: 8080\n", "port"); // 8080
+
+// JSON-compatible YAML 1.2 schema check.
+validateJson("a: 1\nb: [2, 3]\n"); // true
+
+// Lossless CST edit — comments + indentation preserved.
+const doc = new WasmDocument(source);
+doc.set("server.port", "9090");
+fs.writeFileSync("config.yaml", doc.toString());
+```
+
+---
+
+## Why this approach?
+
+[`js-yaml`](https://github.com/nodeca/js-yaml) is the de-facto
+JS YAML parser, and it's good — but it makes two tradeoffs that
+hurt for editor and tooling workloads:
+
+1. **`js-yaml` discards comments by spec.** It implements the
+   YAML data model, which excludes comments. Round-tripping a
+   document through `parse` → `dump` strips every `#` line.
+   noyalib's `Document` API runs through a lossless CST that
+   reproduces the source byte-for-byte; only the surgically
+   touched span changes on a `set`.
+
+2. **`js-yaml` follows YAML 1.1 by default.** That's the
+   "Norway problem": `country: NO` parses as `country: false`,
+   silently rewriting the country code. noyalib defaults to
+   YAML 1.2 strict semantics; only `true` / `false` are
+   booleans.
+
+### Custom YAML tags
+
+`parse(yaml)` surfaces YAML tags as plain JS object keys:
+`!Color '#ff8800'` deserialises into `{ "!Color": "#ff8800" }`.
+This matches the serde-bridge convention every other
+`serde-wasm-bindgen` consumer uses (the `Value::Tagged` variant
+serialises as a single-entry map for cross-format interop).
+Round-tripping via `stringify` does **not** restore the
+YAML-tag prefix — the JS object's tag-as-key shape becomes a
+quoted mapping key in the emitted YAML.
+
+For editor / tooling workloads where the YAML-tag wire form
+must survive a parse → emit cycle, use the `WasmDocument`
+class instead. Its `set` / `setValue` are surgical edits
+through the CST, so untouched tag prefixes round-trip
+verbatim:
+
+```js
+const doc = new WasmDocument("color: !Color '#ff8800'\n");
+doc.set("color", "!Color '#00aaff'");           // tag survives
+console.log(doc.toString());                    // "color: !Color '#00aaff'\n"
+```
+
+Other differences worth knowing about:
+
+- **JSON Schema 2020-12 validation built in.** Same engine as
+  the `noyavalidate` CLI ships.
+- **Pure-Rust, zero `unsafe`.** Every byte of the parser,
+  scanner, formatter, and CST is checked at compile time by the
+  workspace `#![forbid(unsafe_code)]` lint.
+- **~338 KB bundle.** That's roughly the same size as `js-yaml`
+  minified + gzipped, with the lossless-CST surface and YAML
+  1.2 semantics baked in.
+
+---
+
+## Surface
+
+All exports are camelCase, matching JS conventions.
+
+### Free functions
+
+| Export | What it does |
+|---|---|
+| `parse(yaml: string): any` | Parse a YAML document into a JS value. Mappings become plain Objects; sequences become Arrays; scalars become numbers / strings / booleans / null. Mirrors `js-yaml`'s `load`. |
+| `stringify(value: any): string` | Serialise a JS value back to YAML. |
+| `validateJson(yaml: string): boolean` | Validate that the document conforms to the YAML 1.2 JSON-compatible schema (only types JSON allows: null / bool / number / string / array / object). Returns `true` / `false`; structural JSON Schema 2020-12 validation is on the `noyavalidate` CLI roadmap. |
+| `getPath(yaml: string, path: string): any` | Indexed read without going through `parse`. Dotted paths (`"server.host"`); returns `null` if missing. |
+| `merge(base: string, override: string): string` | Deep-merge two YAML documents. Delegates to `noyalib::Value::merge`. |
+
+### `WasmDocument` class — lossless CST
+
+Construct with `new WasmDocument(yaml)`. Every method preserves
+comments and formatting around untouched spans byte-faithfully.
+
+| Method | What it does |
+|---|---|
+| `toString(): string` | Re-emit. Byte-identical to the parsed source if no edits were made. |
+| `get(path: string): any` | Parsed value at a dotted path. Returns `null` if missing. |
+| `getSource(path: string): string \| null` | Raw source fragment at a dotted path (no re-quoting / canonicalisation). |
+| `set(path: string, fragment: string): void` | Surgically rewrite a value at a dotted path. The fragment is a YAML-shaped string (`"9090"`, `"[1,2,3]"`, …). |
+| `setValue(path: string, value: any): void` | Same as `set` but accepts a JS value instead of a YAML fragment. |
+| `spanAt(path: string): { start: number, end: number } \| null` | Byte range of the value at a dotted path. |
+| `commentsAt(path: string): { before: string[], inline: string \| null }` | Comments associated with the node at a path. |
+| `replaceSpan(start: number, end: number, replacement: string): void` | Primitive byte replacement. |
+
+Every function is `async` only via `init()` — once the WASM
+blob is loaded, individual calls are synchronous.
+
+---
+
+## Bundle size
+
+| Build | Size (raw) | Size (gzip) |
+|---|---|---|
+| Default (`wasm-pack build --release --target bundler`) | ~338 KB | ~140 KB |
+| `--features wasm-opt` (post-build pass) | ~280 KB | ~115 KB |
+
+Tree-shaking-friendly — the `Document` API and the plain
+`parse` / `stringify` API are independent modules; bundlers
+drop whichever your code does not import.
+
+For comparison: `js-yaml` 4.x lands around ~50 KB minified +
+~12 KB gzipped, but does not provide lossless-CST or schema
+validation.
+
+---
+
+## Targets
+
+`wasm-pack build` supports every target wasm-bindgen does:
+
+```sh
+wasm-pack build --target bundler    # webpack, rollup, esbuild
+wasm-pack build --target web        # native ES module via <script type="module">
+wasm-pack build --target nodejs     # commonjs Node import
+wasm-pack build --target deno       # Deno-native module
+wasm-pack build --target no-modules # plain global, no module loader
+```
+
+Cloudflare Workers and edge runtimes generally consume the
+`bundler` target via their packaging step.
+
+---
+
+## Provenance
+
+Every release on npm carries an
+[npm provenance attestation](https://docs.npmjs.com/generating-provenance-statements)
+linking the published bundle to the GitHub Actions run that
+produced it. Verify via:
+
+```sh
+npm view @noyalib/noyalib-wasm provenance
+```
+
+The underlying `.wasm` is also signed with cosign keyless
+alongside every release; the verify command is identical to
+the source crate's:
+
+```sh
+cosign verify-blob \
+  --certificate-identity-regexp 'https://github.com/sebastienrousseau/noyalib/' \
+  --certificate-oidc-issuer 'https://token.actions.githubusercontent.com' \
+  --certificate noyalib_wasm_bg.wasm.pem \
+  --signature   noyalib_wasm_bg.wasm.sig \
+  noyalib_wasm_bg.wasm
+```
+
+Full cookbook: [`pkg/VERIFY.md`](https://github.com/sebastienrousseau/noyalib/blob/main/pkg/VERIFY.md).
+
+---
+
+## Examples
+
+Browser + Node demos under
+[`crates/noyalib-wasm/examples/`](examples/):
+
+| Path | Target | What it shows |
+|---|---|---|
+| [`node-stringify.js`](examples/node-stringify.js) | Node | `parse` + `stringify` round-trip. |
+| [`cst-edit.js`](examples/cst-edit.js) | Node | Lossless CST edit; comments + whitespace preserved. |
+| [`schema-validate.js`](examples/schema-validate.js) | Node | JSON Schema 2020-12 validation, good and bad cases. |
+| [`browser/index.html`](examples/browser/index.html) | Browser | Live in-page YAML editor with a parsed-JSON pane. |
+
+```bash
+# Node:
+wasm-pack build --release --target nodejs crates/noyalib-wasm
+node crates/noyalib-wasm/examples/cst-edit.js
+
+# Browser:
+wasm-pack build --release --target web crates/noyalib-wasm
+cd crates/noyalib-wasm/examples/browser
+python3 -m http.server     # or any static-file server
+```
+
+---
+
+## When not to use noyalib-wasm
+
+- **You only ever consume YAML in Node and don't care about
+  comment-preserving edits or YAML 1.2 strictness.** `js-yaml`
+  is smaller (~50 KB minified) and the de-facto standard;
+  reach for it first.
+- **You need a streaming parser for multi-GB documents.** The
+  WASM bindings always read the full document into memory.
+  For TB-scale streaming workloads, drive the noyalib library
+  directly from a Rust process and pipe results out.
+
+---
+
+## Compatibility
+
+**MSRV: Rust 1.85.0** stable. The `wasm-bindgen` 0.2 ecosystem
+floors the toolchain at 1.85; the core `noyalib` library
+itself stays at 1.75. CI verifies the floor on every PR via
+the `Per-crate MSRV` workflow job. The bump policy lives in
+[`doc/POLICIES.md`](https://github.com/sebastienrousseau/noyalib/blob/main/doc/POLICIES.md#1-msrv-minimum-supported-rust-version).
+
+**Tier-1 WASM targets** (CI-verified each PR via
+`wasm-pack test --node`): `wasm32-unknown-unknown` produced
+under every `wasm-pack` mode — `bundler` (Webpack, Rollup,
+esbuild, Vite), `web` (native ES module), `nodejs` (CJS),
+`deno`, `no-modules`. Cloudflare Workers, Deno, and Bun
+consume the `bundler` target.
+
+---
+
+## Documentation
+
+- **Engineering policies** (MSRV, SemVer, security, performance, concurrency, platform support, feature flags):
+  [`doc/POLICIES.md`](https://github.com/sebastienrousseau/noyalib/blob/main/doc/POLICIES.md)
+- **Security policy**:
+  [`SECURITY.md`](https://github.com/sebastienrousseau/noyalib/blob/main/SECURITY.md)
+- **JS API reference**:
+  [`doc/js-api.md`](https://github.com/sebastienrousseau/noyalib/blob/main/crates/noyalib-wasm/doc/js-api.md)
+- **Bundling (Vite, Webpack, Next.js, Cloudflare Workers, Deno, Bun)**:
+  [`doc/bundling.md`](https://github.com/sebastienrousseau/noyalib/blob/main/crates/noyalib-wasm/doc/bundling.md)
+- **npm package**:
+  <https://www.npmjs.com/package/@noyalib/noyalib-wasm>
+- **API reference (rustdoc)**: <https://docs.rs/noyalib-wasm>
+- **Workspace README**:
+  <https://github.com/sebastienrousseau/noyalib#readme>
+
+---
+
+## License
+
+Dual-licensed under [Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0)
+or [MIT](https://opensource.org/licenses/MIT), at your option.

package/noyalib_wasm.d.ts

@@ -0,0 +1,95 @@
+/* tslint:disable */
+/* eslint-disable */
+
+/**
+ * A YAML document with byte-faithful source preservation and path-targeted edits.
+ */
+export class WasmDocument {
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Read the YAML comments associated with the node at `path`.
+     * Returns `{ before: string[], inline: string | null }` so the
+     * caller can surface human-authored doc-comments alongside
+     * values — the demo that motivates the entire CST architecture.
+     *
+     * Bound on the JS side as `commentsAt(path)` per JS naming
+     * conventions.
+     */
+    commentsAt(path: string): any;
+    /**
+     * Get the parsed value at a dotted path.
+     */
+    get(path: string): any;
+    /**
+     * Get the raw source fragment at a dotted path.
+     *
+     * Bound on the JS side as `getSource(path)` per JS naming
+     * conventions.
+     */
+    getSource(path: string): any;
+    /**
+     * Parse a YAML string into a lossless Document.
+     */
+    constructor(yaml: string);
+    /**
+     * Replace the bytes at `start..end` with `replacement`.
+     *
+     * Bound on the JS side as `replaceSpan(start, end, replacement)`
+     * per JS naming conventions.
+     */
+    replaceSpan(start: number, end: number, replacement: string): void;
+    /**
+     * Set a value at a dotted path using a YAML fragment string.
+     */
+    set(path: string, fragment: string): void;
+    /**
+     * Set a value at a dotted path using a JS object.
+     *
+     * Bound on the JS side as `setValue(path, value)` per JS naming
+     * conventions.
+     */
+    setValue(path: string, value: any): void;
+    /**
+     * Get the byte range `{ start, end }` for the value at a dotted path.
+     *
+     * Bound on the JS side as `spanAt(path)` per JS naming
+     * conventions.
+     */
+    spanAt(path: string): any;
+    /**
+     * Re-emit the document as a string. Byte-identical to original if no edits.
+     *
+     * Bound on the JS side as `toString()` (the conventional camelCase
+     * name) so callers can write `doc.toString()` and override the
+     * default `Object.prototype.toString` rather than coexist with it.
+     */
+    toString(): string;
+}
+
+/**
+ * Get a value at a dotted path from a YAML string. Bound on the
+ * JS side as `getPath(yaml, path)` per JS naming conventions.
+ */
+export function getPath(yaml: string, path: string): any;
+
+/**
+ * Merge two YAML documents.
+ */
+export function merge(base_yaml: string, override_yaml: string): string;
+
+/**
+ * Parse a YAML string and return a JS object.
+ */
+export function parse(yaml: string): any;
+
+/**
+ * Serialize a JS object to a YAML string.
+ */
+export function stringify(value: any): string;
+
+/**
+ * Validate YAML against the JSON-compatible schema. Bound on the
+ * JS side as `validateJson(yaml)` per JS naming conventions.
+ */
+export function validateJson(yaml: string): boolean;

package/noyalib_wasm.js

@@ -0,0 +1,9 @@
+/* @ts-self-types="./noyalib_wasm.d.ts" */
+import * as wasm from "./noyalib_wasm_bg.wasm";
+import { __wbg_set_wasm } from "./noyalib_wasm_bg.js";
+
+__wbg_set_wasm(wasm);
+wasm.__wbindgen_start();
+export {
+    WasmDocument, getPath, merge, parse, stringify, validateJson
+} from "./noyalib_wasm_bg.js";

package/noyalib_wasm_bg.js

@@ -0,0 +1,676 @@
+/**
+ * A YAML document with byte-faithful source preservation and path-targeted edits.
+ */
+export class WasmDocument {
+    __destroy_into_raw() {
+        const ptr = this.__wbg_ptr;
+        this.__wbg_ptr = 0;
+        WasmDocumentFinalization.unregister(this);
+        return ptr;
+    }
+    free() {
+        const ptr = this.__destroy_into_raw();
+        wasm.__wbg_wasmdocument_free(ptr, 0);
+    }
+    /**
+     * Read the YAML comments associated with the node at `path`.
+     * Returns `{ before: string[], inline: string | null }` so the
+     * caller can surface human-authored doc-comments alongside
+     * values — the demo that motivates the entire CST architecture.
+     *
+     * Bound on the JS side as `commentsAt(path)` per JS naming
+     * conventions.
+     * @param {string} path
+     * @returns {any}
+     */
+    commentsAt(path) {
+        const ptr0 = passStringToWasm0(path, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.wasmdocument_commentsAt(this.__wbg_ptr, ptr0, len0);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
+    }
+    /**
+     * Get the parsed value at a dotted path.
+     * @param {string} path
+     * @returns {any}
+     */
+    get(path) {
+        const ptr0 = passStringToWasm0(path, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.wasmdocument_get(this.__wbg_ptr, ptr0, len0);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
+    }
+    /**
+     * Get the raw source fragment at a dotted path.
+     *
+     * Bound on the JS side as `getSource(path)` per JS naming
+     * conventions.
+     * @param {string} path
+     * @returns {any}
+     */
+    getSource(path) {
+        const ptr0 = passStringToWasm0(path, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.wasmdocument_getSource(this.__wbg_ptr, ptr0, len0);
+        return ret;
+    }
+    /**
+     * Parse a YAML string into a lossless Document.
+     * @param {string} yaml
+     */
+    constructor(yaml) {
+        const ptr0 = passStringToWasm0(yaml, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.wasmdocument_new(ptr0, len0);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        this.__wbg_ptr = ret[0];
+        WasmDocumentFinalization.register(this, this.__wbg_ptr, this);
+        return this;
+    }
+    /**
+     * Replace the bytes at `start..end` with `replacement`.
+     *
+     * Bound on the JS side as `replaceSpan(start, end, replacement)`
+     * per JS naming conventions.
+     * @param {number} start
+     * @param {number} end
+     * @param {string} replacement
+     */
+    replaceSpan(start, end, replacement) {
+        const ptr0 = passStringToWasm0(replacement, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.wasmdocument_replaceSpan(this.__wbg_ptr, start, end, ptr0, len0);
+        if (ret[1]) {
+            throw takeFromExternrefTable0(ret[0]);
+        }
+    }
+    /**
+     * Set a value at a dotted path using a YAML fragment string.
+     * @param {string} path
+     * @param {string} fragment
+     */
+    set(path, fragment) {
+        const ptr0 = passStringToWasm0(path, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(fragment, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len1 = WASM_VECTOR_LEN;
+        const ret = wasm.wasmdocument_set(this.__wbg_ptr, ptr0, len0, ptr1, len1);
+        if (ret[1]) {
+            throw takeFromExternrefTable0(ret[0]);
+        }
+    }
+    /**
+     * Set a value at a dotted path using a JS object.
+     *
+     * Bound on the JS side as `setValue(path, value)` per JS naming
+     * conventions.
+     * @param {string} path
+     * @param {any} value
+     */
+    setValue(path, value) {
+        const ptr0 = passStringToWasm0(path, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.wasmdocument_setValue(this.__wbg_ptr, ptr0, len0, value);
+        if (ret[1]) {
+            throw takeFromExternrefTable0(ret[0]);
+        }
+    }
+    /**
+     * Get the byte range `{ start, end }` for the value at a dotted path.
+     *
+     * Bound on the JS side as `spanAt(path)` per JS naming
+     * conventions.
+     * @param {string} path
+     * @returns {any}
+     */
+    spanAt(path) {
+        const ptr0 = passStringToWasm0(path, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.wasmdocument_spanAt(this.__wbg_ptr, ptr0, len0);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
+    }
+    /**
+     * Re-emit the document as a string. Byte-identical to original if no edits.
+     *
+     * Bound on the JS side as `toString()` (the conventional camelCase
+     * name) so callers can write `doc.toString()` and override the
+     * default `Object.prototype.toString` rather than coexist with it.
+     * @returns {string}
+     */
+    toString() {
+        let deferred1_0;
+        let deferred1_1;
+        try {
+            const ret = wasm.wasmdocument_toString(this.__wbg_ptr);
+            deferred1_0 = ret[0];
+            deferred1_1 = ret[1];
+            return getStringFromWasm0(ret[0], ret[1]);
+        } finally {
+            wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
+        }
+    }
+}
+if (Symbol.dispose) WasmDocument.prototype[Symbol.dispose] = WasmDocument.prototype.free;
+
+/**
+ * Get a value at a dotted path from a YAML string. Bound on the
+ * JS side as `getPath(yaml, path)` per JS naming conventions.
+ * @param {string} yaml
+ * @param {string} path
+ * @returns {any}
+ */
+export function getPath(yaml, path) {
+    const ptr0 = passStringToWasm0(yaml, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ptr1 = passStringToWasm0(path, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len1 = WASM_VECTOR_LEN;
+    const ret = wasm.getPath(ptr0, len0, ptr1, len1);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return takeFromExternrefTable0(ret[0]);
+}
+
+/**
+ * Merge two YAML documents.
+ * @param {string} base_yaml
+ * @param {string} override_yaml
+ * @returns {string}
+ */
+export function merge(base_yaml, override_yaml) {
+    let deferred4_0;
+    let deferred4_1;
+    try {
+        const ptr0 = passStringToWasm0(base_yaml, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(override_yaml, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len1 = WASM_VECTOR_LEN;
+        const ret = wasm.merge(ptr0, len0, ptr1, len1);
+        var ptr3 = ret[0];
+        var len3 = ret[1];
+        if (ret[3]) {
+            ptr3 = 0; len3 = 0;
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        deferred4_0 = ptr3;
+        deferred4_1 = len3;
+        return getStringFromWasm0(ptr3, len3);
+    } finally {
+        wasm.__wbindgen_free(deferred4_0, deferred4_1, 1);
+    }
+}
+
+/**
+ * Parse a YAML string and return a JS object.
+ * @param {string} yaml
+ * @returns {any}
+ */
+export function parse(yaml) {
+    const ptr0 = passStringToWasm0(yaml, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.parse(ptr0, len0);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return takeFromExternrefTable0(ret[0]);
+}
+
+/**
+ * Serialize a JS object to a YAML string.
+ * @param {any} value
+ * @returns {string}
+ */
+export function stringify(value) {
+    let deferred2_0;
+    let deferred2_1;
+    try {
+        const ret = wasm.stringify(value);
+        var ptr1 = ret[0];
+        var len1 = ret[1];
+        if (ret[3]) {
+            ptr1 = 0; len1 = 0;
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        deferred2_0 = ptr1;
+        deferred2_1 = len1;
+        return getStringFromWasm0(ptr1, len1);
+    } finally {
+        wasm.__wbindgen_free(deferred2_0, deferred2_1, 1);
+    }
+}
+
+/**
+ * Validate YAML against the JSON-compatible schema. Bound on the
+ * JS side as `validateJson(yaml)` per JS naming conventions.
+ * @param {string} yaml
+ * @returns {boolean}
+ */
+export function validateJson(yaml) {
+    const ptr0 = passStringToWasm0(yaml, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.validateJson(ptr0, len0);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return ret[0] !== 0;
+}
+export function __wbg_Error_92b29b0548f8b746(arg0, arg1) {
+    const ret = Error(getStringFromWasm0(arg0, arg1));
+    return ret;
+}
+export function __wbg_String_8564e559799eccda(arg0, arg1) {
+    const ret = String(arg1);
+    const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len1 = WASM_VECTOR_LEN;
+    getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
+    getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
+}
+export function __wbg___wbindgen_bigint_get_as_i64_d968e41184ae354f(arg0, arg1) {
+    const v = arg1;
+    const ret = typeof(v) === 'bigint' ? v : undefined;
+    getDataViewMemory0().setBigInt64(arg0 + 8 * 1, isLikeNone(ret) ? BigInt(0) : ret, true);
+    getDataViewMemory0().setInt32(arg0 + 4 * 0, !isLikeNone(ret), true);
+}
+export function __wbg___wbindgen_boolean_get_fa956cfa2d1bd751(arg0) {
+    const v = arg0;
+    const ret = typeof(v) === 'boolean' ? v : undefined;
+    return isLikeNone(ret) ? 0xFFFFFF : ret ? 1 : 0;
+}
+export function __wbg___wbindgen_debug_string_c25d447a39f5578f(arg0, arg1) {
+    const ret = debugString(arg1);
+    const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len1 = WASM_VECTOR_LEN;
+    getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
+    getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
+}
+export function __wbg___wbindgen_in_aca499c5de7ff5e5(arg0, arg1) {
+    const ret = arg0 in arg1;
+    return ret;
+}
+export function __wbg___wbindgen_is_bigint_2f76dc55065b4273(arg0) {
+    const ret = typeof(arg0) === 'bigint';
+    return ret;
+}
+export function __wbg___wbindgen_is_function_1ff95bcc5517c252(arg0) {
+    const ret = typeof(arg0) === 'function';
+    return ret;
+}
+export function __wbg___wbindgen_is_object_a27215656b807791(arg0) {
+    const val = arg0;
+    const ret = typeof(val) === 'object' && val !== null;
+    return ret;
+}
+export function __wbg___wbindgen_is_string_ea5e6cc2e4141dfe(arg0) {
+    const ret = typeof(arg0) === 'string';
+    return ret;
+}
+export function __wbg___wbindgen_jsval_eq_e659fcf7b0e32763(arg0, arg1) {
+    const ret = arg0 === arg1;
+    return ret;
+}
+export function __wbg___wbindgen_jsval_loose_eq_db4c3b15f63fc170(arg0, arg1) {
+    const ret = arg0 == arg1;
+    return ret;
+}
+export function __wbg___wbindgen_number_get_394265ed1e1b84ee(arg0, arg1) {
+    const obj = arg1;
+    const ret = typeof(obj) === 'number' ? obj : undefined;
+    getDataViewMemory0().setFloat64(arg0 + 8 * 1, isLikeNone(ret) ? 0 : ret, true);
+    getDataViewMemory0().setInt32(arg0 + 4 * 0, !isLikeNone(ret), true);
+}
+export function __wbg___wbindgen_string_get_b0ca35b86a603356(arg0, arg1) {
+    const obj = arg1;
+    const ret = typeof(obj) === 'string' ? obj : undefined;
+    var ptr1 = isLikeNone(ret) ? 0 : passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    var len1 = WASM_VECTOR_LEN;
+    getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
+    getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
+}
+export function __wbg___wbindgen_throw_344f42d3211c4765(arg0, arg1) {
+    throw new Error(getStringFromWasm0(arg0, arg1));
+}
+export function __wbg_call_8a2dd23819f8a60a() { return handleError(function (arg0, arg1) {
+    const ret = arg0.call(arg1);
+    return ret;
+}, arguments); }
+export function __wbg_done_89b2b13e91a60321(arg0) {
+    const ret = arg0.done;
+    return ret;
+}
+export function __wbg_entries_015dc610cd81ede0(arg0) {
+    const ret = Object.entries(arg0);
+    return ret;
+}
+export function __wbg_get_507a50627bffa49b(arg0, arg1) {
+    const ret = arg0[arg1 >>> 0];
+    return ret;
+}
+export function __wbg_get_c7eb1f358a7654df() { return handleError(function (arg0, arg1) {
+    const ret = Reflect.get(arg0, arg1);
+    return ret;
+}, arguments); }
+export function __wbg_get_unchecked_6e0ad6d2a41b06f6(arg0, arg1) {
+    const ret = arg0[arg1 >>> 0];
+    return ret;
+}
+export function __wbg_instanceof_ArrayBuffer_4480b9e0068a8adb(arg0) {
+    let result;
+    try {
+        result = arg0 instanceof ArrayBuffer;
+    } catch (_) {
+        result = false;
+    }
+    const ret = result;
+    return ret;
+}
+export function __wbg_instanceof_Map_e5b5e3db98422fcc(arg0) {
+    let result;
+    try {
+        result = arg0 instanceof Map;
+    } catch (_) {
+        result = false;
+    }
+    const ret = result;
+    return ret;
+}
+export function __wbg_instanceof_Uint8Array_309b927aaf7a3fc7(arg0) {
+    let result;
+    try {
+        result = arg0 instanceof Uint8Array;
+    } catch (_) {
+        result = false;
+    }
+    const ret = result;
+    return ret;
+}
+export function __wbg_isArray_0677c962b281d01a(arg0) {
+    const ret = Array.isArray(arg0);
+    return ret;
+}
+export function __wbg_isSafeInteger_04f36e4056f1b851(arg0) {
+    const ret = Number.isSafeInteger(arg0);
+    return ret;
+}
+export function __wbg_iterator_6f722e4a93058b71() {
+    const ret = Symbol.iterator;
+    return ret;
+}
+export function __wbg_length_1f0964f4a5e2c6d8(arg0) {
+    const ret = arg0.length;
+    return ret;
+}
+export function __wbg_length_370319915dc99107(arg0) {
+    const ret = arg0.length;
+    return ret;
+}
+export function __wbg_new_32b398fb48b6d94a() {
+    const ret = new Array();
+    return ret;
+}
+export function __wbg_new_7796ffc7ed656783() {
+    const ret = new Map();
+    return ret;
+}
+export function __wbg_new_cd45aabdf6073e84(arg0) {
+    const ret = new Uint8Array(arg0);
+    return ret;
+}
+export function __wbg_new_da52cf8fe3429cb2() {
+    const ret = new Object();
+    return ret;
+}
+export function __wbg_next_6dbf2c0ac8cde20f(arg0) {
+    const ret = arg0.next;
+    return ret;
+}
+export function __wbg_next_71f2aa1cb3d1e37e() { return handleError(function (arg0) {
+    const ret = arg0.next();
+    return ret;
+}, arguments); }
+export function __wbg_prototypesetcall_4770620bbe4688a0(arg0, arg1, arg2) {
+    Uint8Array.prototype.set.call(getArrayU8FromWasm0(arg0, arg1), arg2);
+}
+export function __wbg_set_575dd786d51585f8(arg0, arg1, arg2) {
+    const ret = arg0.set(arg1, arg2);
+    return ret;
+}
+export function __wbg_set_6be42768c690e380(arg0, arg1, arg2) {
+    arg0[arg1] = arg2;
+}
+export function __wbg_set_8a16b38e4805b298(arg0, arg1, arg2) {
+    arg0[arg1 >>> 0] = arg2;
+}
+export function __wbg_value_a5d5488a9589444a(arg0) {
+    const ret = arg0.value;
+    return ret;
+}
+export function __wbindgen_cast_0000000000000001(arg0) {
+    // Cast intrinsic for `F64 -> Externref`.
+    const ret = arg0;
+    return ret;
+}
+export function __wbindgen_cast_0000000000000002(arg0) {
+    // Cast intrinsic for `I64 -> Externref`.
+    const ret = arg0;
+    return ret;
+}
+export function __wbindgen_cast_0000000000000003(arg0, arg1) {
+    // Cast intrinsic for `Ref(String) -> Externref`.
+    const ret = getStringFromWasm0(arg0, arg1);
+    return ret;
+}
+export function __wbindgen_cast_0000000000000004(arg0) {
+    // Cast intrinsic for `U64 -> Externref`.
+    const ret = BigInt.asUintN(64, arg0);
+    return ret;
+}
+export function __wbindgen_init_externref_table() {
+    const table = wasm.__wbindgen_externrefs;
+    const offset = table.grow(4);
+    table.set(0, undefined);
+    table.set(offset + 0, undefined);
+    table.set(offset + 1, null);
+    table.set(offset + 2, true);
+    table.set(offset + 3, false);
+}
+const WasmDocumentFinalization = (typeof FinalizationRegistry === 'undefined')
+    ? { register: () => {}, unregister: () => {} }
+    : new FinalizationRegistry(ptr => wasm.__wbg_wasmdocument_free(ptr, 1));
+
+function addToExternrefTable0(obj) {
+    const idx = wasm.__externref_table_alloc();
+    wasm.__wbindgen_externrefs.set(idx, obj);
+    return idx;
+}
+
+function debugString(val) {
+    // primitive types
+    const type = typeof val;
+    if (type == 'number' || type == 'boolean' || val == null) {
+        return  `${val}`;
+    }
+    if (type == 'string') {
+        return `"${val}"`;
+    }
+    if (type == 'symbol') {
+        const description = val.description;
+        if (description == null) {
+            return 'Symbol';
+        } else {
+            return `Symbol(${description})`;
+        }
+    }
+    if (type == 'function') {
+        const name = val.name;
+        if (typeof name == 'string' && name.length > 0) {
+            return `Function(${name})`;
+        } else {
+            return 'Function';
+        }
+    }
+    // objects
+    if (Array.isArray(val)) {
+        const length = val.length;
+        let debug = '[';
+        if (length > 0) {
+            debug += debugString(val[0]);
+        }
+        for(let i = 1; i < length; i++) {
+            debug += ', ' + debugString(val[i]);
+        }
+        debug += ']';
+        return debug;
+    }
+    // Test for built-in
+    const builtInMatches = /\[object ([^\]]+)\]/.exec(toString.call(val));
+    let className;
+    if (builtInMatches && builtInMatches.length > 1) {
+        className = builtInMatches[1];
+    } else {
+        // Failed to match the standard '[object ClassName]'
+        return toString.call(val);
+    }
+    if (className == 'Object') {
+        // we're a user defined class or Object
+        // JSON.stringify avoids problems with cycles, and is generally much
+        // easier than looping through ownProperties of `val`.
+        try {
+            return 'Object(' + JSON.stringify(val) + ')';
+        } catch (_) {
+            return 'Object';
+        }
+    }
+    // errors
+    if (val instanceof Error) {
+        return `${val.name}: ${val.message}\n${val.stack}`;
+    }
+    // TODO we could test for more things here, like `Set`s and `Map`s.
+    return className;
+}
+
+function getArrayU8FromWasm0(ptr, len) {
+    ptr = ptr >>> 0;
+    return getUint8ArrayMemory0().subarray(ptr / 1, ptr / 1 + len);
+}
+
+let cachedDataViewMemory0 = null;
+function getDataViewMemory0() {
+    if (cachedDataViewMemory0 === null || cachedDataViewMemory0.buffer.detached === true || (cachedDataViewMemory0.buffer.detached === undefined && cachedDataViewMemory0.buffer !== wasm.memory.buffer)) {
+        cachedDataViewMemory0 = new DataView(wasm.memory.buffer);
+    }
+    return cachedDataViewMemory0;
+}
+
+function getStringFromWasm0(ptr, len) {
+    return decodeText(ptr >>> 0, len);
+}
+
+let cachedUint8ArrayMemory0 = null;
+function getUint8ArrayMemory0() {
+    if (cachedUint8ArrayMemory0 === null || cachedUint8ArrayMemory0.byteLength === 0) {
+        cachedUint8ArrayMemory0 = new Uint8Array(wasm.memory.buffer);
+    }
+    return cachedUint8ArrayMemory0;
+}
+
+function handleError(f, args) {
+    try {
+        return f.apply(this, args);
+    } catch (e) {
+        const idx = addToExternrefTable0(e);
+        wasm.__wbindgen_exn_store(idx);
+    }
+}
+
+function isLikeNone(x) {
+    return x === undefined || x === null;
+}
+
+function passStringToWasm0(arg, malloc, realloc) {
+    if (realloc === undefined) {
+        const buf = cachedTextEncoder.encode(arg);
+        const ptr = malloc(buf.length, 1) >>> 0;
+        getUint8ArrayMemory0().subarray(ptr, ptr + buf.length).set(buf);
+        WASM_VECTOR_LEN = buf.length;
+        return ptr;
+    }
+
+    let len = arg.length;
+    let ptr = malloc(len, 1) >>> 0;
+
+    const mem = getUint8ArrayMemory0();
+
+    let offset = 0;
+
+    for (; offset < len; offset++) {
+        const code = arg.charCodeAt(offset);
+        if (code > 0x7F) break;
+        mem[ptr + offset] = code;
+    }
+    if (offset !== len) {
+        if (offset !== 0) {
+            arg = arg.slice(offset);
+        }
+        ptr = realloc(ptr, len, len = offset + arg.length * 3, 1) >>> 0;
+        const view = getUint8ArrayMemory0().subarray(ptr + offset, ptr + len);
+        const ret = cachedTextEncoder.encodeInto(arg, view);
+
+        offset += ret.written;
+        ptr = realloc(ptr, len, offset, 1) >>> 0;
+    }
+
+    WASM_VECTOR_LEN = offset;
+    return ptr;
+}
+
+function takeFromExternrefTable0(idx) {
+    const value = wasm.__wbindgen_externrefs.get(idx);
+    wasm.__externref_table_dealloc(idx);
+    return value;
+}
+
+let cachedTextDecoder = new TextDecoder('utf-8', { ignoreBOM: true, fatal: true });
+cachedTextDecoder.decode();
+const MAX_SAFARI_DECODE_BYTES = 2146435072;
+let numBytesDecoded = 0;
+function decodeText(ptr, len) {
+    numBytesDecoded += len;
+    if (numBytesDecoded >= MAX_SAFARI_DECODE_BYTES) {
+        cachedTextDecoder = new TextDecoder('utf-8', { ignoreBOM: true, fatal: true });
+        cachedTextDecoder.decode();
+        numBytesDecoded = len;
+    }
+    return cachedTextDecoder.decode(getUint8ArrayMemory0().subarray(ptr, ptr + len));
+}
+
+const cachedTextEncoder = new TextEncoder();
+
+if (!('encodeInto' in cachedTextEncoder)) {
+    cachedTextEncoder.encodeInto = function (arg, view) {
+        const buf = cachedTextEncoder.encode(arg);
+        view.set(buf);
+        return {
+            read: arg.length,
+            written: buf.length
+        };
+    };
+}
+
+let WASM_VECTOR_LEN = 0;
+
+
+let wasm;
+export function __wbg_set_wasm(val) {
+    wasm = val;
+}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@sebastienrousseau/noyalib-wasm",
+  "type": "module",
+  "collaborators": [
+    "Sebastien Rousseau <sebastian.rousseau@gmail.com>"
+  ],
+  "description": "WebAssembly (wasm-bindgen) bindings for the noyalib YAML library — browser-ready parse / serialise / lossless edit",
+  "version": "0.0.12",
+  "license": "MIT OR Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sebastienrousseau/noyalib-wasm"
+  },
+  "files": [
+    "noyalib_wasm_bg.wasm",
+    "noyalib_wasm.js",
+    "noyalib_wasm_bg.js",
+    "noyalib_wasm.d.ts"
+  ],
+  "main": "noyalib_wasm.js",
+  "homepage": "https://github.com/sebastienrousseau/noyalib-wasm",
+  "types": "noyalib_wasm.d.ts",
+  "sideEffects": [
+    "./noyalib_wasm.js",
+    "./snippets/*"
+  ],
+  "keywords": [
+    "yaml",
+    "wasm",
+    "wasm-bindgen",
+    "browser",
+    "noyalib"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}