koda-format 1.0.2 → 1.0.4

package/README.md

@@ -1,104 +1,135 @@
-# KODA — Compact Object Data Architecture
+# koda-format
 
-**KODA** is a compact data format with a **text syntax** (`.koda`) and a **canonical binary encoding** (`.kod`). It is optimized for smaller payloads, efficient storage, and deterministic encoding—not for beating JSON on text parse speed. It wins on **size**, **IO**, and **storage** when using the binary format.
+Compact Object Data Architecture: a structured data format with a human-readable text syntax and a canonical binary encoding. Optimized for compact storage and scalable backend processing.
 
-[![npm version](https://img.shields.io/npm/v/koda-format.svg)](https://www.npmjs.com/package/koda-format)  
-**License:** MIT
+[![npm version](https://img.shields.io/npm/v/koda-format.svg)](https://www.npmjs.com/package/koda-format)
 
----
-
-## Quick start
+## Installation
 
 ```bash
 npm install koda-format
 ```
 
+Requires Node.js 18 or later.
+
+## Quick example
+
 ```ts
 import { parse, stringify, encode, decode } from 'koda-format';
 
-// Text
+// Text format (.koda): key-value, optional commas, comments
 const value = parse(`
   name: "my-app"
   version: 1
   enabled: true
 `);
-const back = stringify(value);
 
-// Binary (canonical, smaller, good for storage)
+// Binary format (.kod): canonical, deterministic
 const bytes = encode(value);
-const decoded = decode(bytes);
+const decoded = await decode(bytes);
 ```
 
----
+## When to use KODA
 
-## What’s in the box
+KODA is suited to:
 
-| Feature | Description |
-|--------|-------------|
-| **Text (`.koda`)** | Objects, arrays, `key: value`, optional commas, `//` and `/* */` comments, unquoted identifiers. |
-| **Binary (`.kod`)** | Magic + version, key dictionary (each key stored once), then typed data; big-endian; deterministic. |
-| **Security** | Configurable max depth, max input length, max dictionary/string size. |
-| **Optional C++ addon** | Faster encode/decode when built; same API, pure JS fallback. |
+- **Large payloads** — configuration, event batches, log datasets
+- **Repetitive structures** — arrays of objects with repeated keys
+- **Storage-heavy workloads** — databases, caches, bulk export/import
+- **IO-bound systems** — smaller payloads reduce disk and network transfer
+- **Backend services** — where non-blocking decode and parallel processing matter
 
-Full grammar and binary layout: **[SPEC.md](./SPEC.md)**.
+KODA is not a drop-in replacement for JSON in all contexts. It is optimized for compact binary storage and scalable backend processing. Use JSON where interoperability, tooling, or simple string exchange are the main requirements.
 
----
+## Non-blocking decode and multithreading
 
-## API
+**Why it matters**
 
-| Function | Description |
-|----------|-------------|
-| `parse(text, options?)` | Parse KODA text → value. Options: `maxDepth`, `maxInputLength`. |
-| `stringify(value, options?)` | Value → KODA text. Options: `indent`, `newline`. |
-| `encode(value, options?)` | Value → canonical binary `Uint8Array`. Options: `maxDepth`. |
-| `decode(buffer, options?)` | Binary → value. Options: `maxDepth`, `maxDictionarySize`, `maxStringLength`. |
-| `loadFile(path, options?)` | Read file (UTF-8) and parse. |
-| `saveFile(path, value, options?)` | Stringify and write file. |
-| `toJSON(value)` | Same as `JSON.stringify(value)`. |
-| `fromJSON(json)` | Same as `JSON.parse(json)`. |
-| `parseWithLexer(text, options?)` | Lexer-based parse (better error positions). |
-| `isNativeAvailable()` | `true` if the C++ addon is loaded. |
+`JSON.parse` is synchronous: it blocks the Node.js event loop until the parse finishes. For large payloads or many concurrent requests, that can stall I/O, timers, and other work. KODA’s default binary decode is **non-blocking** and can run in **worker threads**, so the main thread stays responsive.
 
-Errors: `KodaParseError`, `KodaEncodeError`, `KodaDecodeError` (with `.position` or `.byteOffset`).
+**How it works**
 
----
+- **`decode(buffer)`** — Returns a `Promise<KodaValue>`. Each call runs decode in a separate worker thread. The main thread only schedules the job and receives the result; it does not perform the parse. Use this for normal async usage.
+- **`decodeSync(buffer)`** — Synchronous decode on the main thread. Use only when you cannot use async (e.g. some legacy code paths) or for very small payloads.
+- **`createDecoderPool({ poolSize })`** — Creates a fixed pool of worker threads. `pool.decode(buffer)` dispatches to a worker from the pool and returns a promise. Reusing workers avoids per-call worker startup cost and allows **parallel decoding across multiple CPU cores**. Suited to high-throughput backends (e.g. many decode requests in parallel).
 
-## Binary format (implemented)
+**Summary**
 
-- **Magic:** 4 bytes `KODA` (0x4B 0x4F 0x44 0x41).  
-- **Version:** 1 byte (`1`).  
-- **Dictionary:** N unique keys (UTF-8), canonical order; each key: 4 bytes length (BE) + bytes.  
-- **Data:** Root value with type tags: null, false, true, int64, float64, string, array, object. Objects use key indices into the dictionary. Same value → same bytes.
+- Non-blocking: decode work runs off the main thread; the event loop is not blocked.
+- Multithreading: decoding runs in Node.js worker threads; a decoder pool uses multiple workers and cores.
+- Suited to backends and batch jobs where throughput and main-thread latency matter.
 
----
+## Benchmark results
 
-## Storage (e.g. PostgreSQL BYTEA)
+Size comparison for workloads that match KODA’s design: large documents, repeated keys, and tabular data.
 
-```ts
-const bytes = encode(document);
-// store in BYTEA; later:
-const value = decode(row.bytes);
-```
+| Scenario | JSON | KODA binary | Reduction |
+|----------|------|-------------|-----------|
+| Large (500 items) | 54.4 KB | 26.2 KB | 52% |
+| 1000 rows × 100 items | 10.2 MB | 4.65 MB | 54% |
+| 1 document, 10k long keys | 1.55 MB | 488 KB | 68% |
+
+The binary format stores each key once in a dictionary; documents with many repeated keys see the largest size reduction.
+
+## Performance characteristics
+
+**Event loop and concurrency**
+
+`JSON.parse` is synchronous and blocks the Node.js event loop for the duration of the parse. KODA’s primary decode API is asynchronous: decoding runs in worker threads, so the main thread remains responsive. This reduces latency impact on the rest of the application.
+
+**Parallel processing**
+
+Decoding can be distributed across multiple worker threads. A decoder pool (`createDecoderPool`) allows many decode operations to run in parallel and use multiple CPU cores. This suits high-throughput backends and batch processing where many payloads are decoded concurrently.
+
+**Summary**
+
+- Non-blocking decode: work runs off the main thread.
+- Parallel scalability: multiple workers and cores can be used.
+- No claim is made about raw single-thread parse speed versus JSON; the advantages are non-blocking behavior and parallel scalability.
 
----
+## API overview
 
-## Build C++ addon (optional)
+**Text**
 
-Requires Node.js build tools and a C++ compiler:
+| Method | Description |
+|--------|-------------|
+| `parse(text, options?)` | Parse KODA text to a value. Options: `maxDepth`, `maxInputLength`. |
+| `stringify(value, options?)` | Serialize value to KODA text. Options: `indent`, `newline`. |
+
+**Binary**
+
+| Method | Description |
+|--------|-------------|
+| `encode(value, options?)` | Encode value to canonical binary. Returns `Uint8Array`. Options: `maxDepth`. |
+| `decode(buffer, options?)` | Decode binary to value. Returns `Promise<KodaValue>`. Runs in a worker thread. |
+| `decodeSync(buffer, options?)` | Synchronous decode. Blocks the event loop. |
+| `createDecoderPool(options?)` | Create a pool of decoder workers. Returns `{ decode, destroy }`. Options: `poolSize`. |
+
+**Decode options:** `maxDepth`, `maxDictionarySize`, `maxStringLength`.
+
+**Utilities**
+
+| Method | Description |
+|--------|-------------|
+| `loadFile(path, options?)` | Read and parse a `.koda` file. |
+| `saveFile(path, value, options?)` | Serialize and write a `.koda` file. |
+| `isNativeAvailable()` | Whether the optional C++ addon is loaded. |
+
+**Errors:** `KodaParseError`, `KodaEncodeError`, `KodaDecodeError` (with `.position` or `.byteOffset` where applicable).
+
+Full specification (grammar, binary layout, canonicalization): [SPEC.md](./SPEC.md).
+
+## Building the native addon
+
+The package works with pure JavaScript. An optional C++ addon improves encode/decode performance when built:
 
 ```bash
+npm run build
 npm run build:addon
-# or
-npm run build:all
 ```
 
----
-
-## Repo
-
-- **[SPEC.md](./SPEC.md)** — Grammar, data model, binary layout, canonicalization, security.
-- **Source:** `src/` (TypeScript). **Native:** `native/` (C++ N-API). **Tests:** `test/`. **Examples:** `examples/*.koda`.
+Requires Node.js build tools and a C++ compiler. The addon is used automatically when present.
 
----
+## License
 
-**KODA** — Compact Object Data Architecture. MIT.
+MIT

package/SPEC.md

@@ -18,7 +18,7 @@ KODA (Compact Object Data Architecture) is a structured data format designed for
 
 KODA addresses limitations of JSON (verbosity, no comments, non-deterministic key order), YAML (complexity, security issues), and binary formats like MessagePack (non-canonical, key repetition).
 
-**Positioning:** KODA is a **compact binary data format** first. It is optimized for **smaller payloads**, **efficient storage**, **reduced IO**, and **fast binary encode/decode** — not for beating JSON on raw text parsing speed. In real systems, KODA wins on size, IO efficiency, storage, and scalability (see project docs).
+**Positioning:** KODA is a **compact binary data format** first. It is optimized for **smaller payloads**, **efficient storage**, **reduced IO**, and **fast binary encode/decode** — not for beating JSON on raw text parsing speed. In real systems, KODA wins on size, IO efficiency, storage, and scalability (see [README.md](./README.md)).
 
 ---
 

package/dist/decode-async.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Non-blocking decode: runs in a worker thread. Uses transferable buffer when possible.
+ */
+import type { KodaValue } from './ast.js';
+import type { DecodeOptions } from './decoder.js';
+export interface DecoderPoolOptions {
+    /** Number of worker threads (default 1). */
+    poolSize?: number;
+}
+export interface DecoderPool {
+    /** Decode buffer in a worker; does not block the event loop. */
+    decode(buffer: Uint8Array, options?: DecodeOptions): Promise<KodaValue>;
+    /** Stop all workers. */
+    destroy(): void;
+}
+/**
+ * Decode binary in a worker thread. Main thread stays responsive.
+ * Uses transferable ArrayBuffer when possible to avoid copy.
+ */
+export declare function decodeAsync(buffer: Uint8Array, options?: DecodeOptions): Promise<KodaValue>;
+/**
+ * Create a pool of decoder workers for high throughput. Decode jobs are
+ * distributed round-robin across workers.
+ */
+export declare function createDecoderPool(options?: DecoderPoolOptions): DecoderPool;
+//# sourceMappingURL=decode-async.d.ts.map

package/dist/decode-async.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode-async.d.ts","sourceRoot":"","sources":["../src/decode-async.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAgBlD,MAAM,WAAW,kBAAkB;IACjC,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,gEAAgE;IAChE,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IACxE,wBAAwB;IACxB,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,CAAC,CAsC3F;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,kBAAuB,GAAG,WAAW,CAiD/E"}

package/dist/decode-async.js

@@ -0,0 +1,121 @@
+/**
+ * Non-blocking decode: runs in a worker thread. Uses transferable buffer when possible.
+ */
+import { existsSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { fileURLToPath } from 'node:url';
+import { Worker } from 'node:worker_threads';
+import { KodaDecodeError } from './errors.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+function getWorkerURL() {
+    const fromModule = join(__dirname, 'worker', 'decoder-worker.js');
+    if (existsSync(fromModule))
+        return pathToFileURL(fromModule);
+    const fromDist = join(process.cwd(), 'dist', 'worker', 'decoder-worker.js');
+    if (existsSync(fromDist))
+        return pathToFileURL(fromDist);
+    return pathToFileURL(fromModule);
+}
+let nextId = 0;
+/**
+ * Decode binary in a worker thread. Main thread stays responsive.
+ * Uses transferable ArrayBuffer when possible to avoid copy.
+ */
+export function decodeAsync(buffer, options) {
+    const id = nextId++;
+    const ab = buffer.buffer.slice(buffer.byteOffset, buffer.byteOffset + buffer.byteLength);
+    return new Promise((resolve, reject) => {
+        const worker = new Worker(getWorkerURL(), { workerData: null, eval: false });
+        const onMessage = (msg) => {
+            if (msg.id !== id)
+                return;
+            cleanup();
+            if ('error' in msg && msg.error) {
+                reject(new KodaDecodeError(msg.error));
+            }
+            else if ('value' in msg && msg.value !== undefined) {
+                resolve(msg.value);
+            }
+            else {
+                reject(new KodaDecodeError('Worker did not return value'));
+            }
+        };
+        const onError = (err) => {
+            cleanup();
+            reject(err);
+        };
+        const onExit = (code) => {
+            if (code !== 0) {
+                cleanup();
+                reject(new KodaDecodeError(`Worker exited with code ${code}`));
+            }
+        };
+        const cleanup = () => {
+            worker.off('message', onMessage);
+            worker.off('error', onError);
+            worker.off('exit', onExit);
+            worker.terminate().catch(() => { });
+        };
+        worker.on('message', onMessage);
+        worker.on('error', onError);
+        worker.on('exit', onExit);
+        worker.postMessage({ id, buffer: ab, options }, [ab]);
+    });
+}
+/**
+ * Create a pool of decoder workers for high throughput. Decode jobs are
+ * distributed round-robin across workers.
+ */
+export function createDecoderPool(options = {}) {
+    const poolSize = Math.max(1, options.poolSize ?? 1);
+    const workers = [];
+    const pendingByWorker = new Map();
+    let nextIndex = 0;
+    let destroyed = false;
+    for (let i = 0; i < poolSize; i++) {
+        const w = new Worker(getWorkerURL(), { workerData: null, eval: false });
+        pendingByWorker.set(w, new Map());
+        w.on('message', (msg) => {
+            const pending = pendingByWorker.get(w);
+            const entry = pending.get(msg.id);
+            if (!entry)
+                return;
+            pending.delete(msg.id);
+            if ('error' in msg && msg.error) {
+                entry.reject(new KodaDecodeError(msg.error));
+            }
+            else if ('value' in msg && msg.value !== undefined) {
+                entry.resolve(msg.value);
+            }
+            else {
+                entry.reject(new KodaDecodeError('Worker did not return value'));
+            }
+        });
+        workers.push(w);
+    }
+    function decode(buffer, options) {
+        if (destroyed)
+            return Promise.reject(new KodaDecodeError('Decoder pool has been destroyed'));
+        const id = nextId++;
+        const ab = buffer.buffer.slice(buffer.byteOffset, buffer.byteOffset + buffer.byteLength);
+        return new Promise((resolve, reject) => {
+            const worker = workers[nextIndex % workers.length];
+            nextIndex++;
+            pendingByWorker.get(worker).set(id, { resolve, reject });
+            worker.postMessage({ id, buffer: ab, options }, [ab]);
+        });
+    }
+    function destroy() {
+        if (destroyed)
+            return;
+        destroyed = true;
+        for (const w of workers) {
+            w.terminate().catch(() => { });
+        }
+        workers.length = 0;
+    }
+    return { decode, destroy };
+}
+//# sourceMappingURL=decode-async.js.map

package/dist/decode-async.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode-async.js","sourceRoot":"","sources":["../src/decode-async.ts"],"names":[],"mappings":"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"}

package/dist/decoderV2.d.ts

@@ -0,0 +1,11 @@
+/**
+ * KODA binary v2 decoding (BINARY-V2.md).
+ */
+import type { KodaValue } from './ast.js';
+export interface DecodeV2Options {
+    maxDepth?: number;
+    maxDictionarySize?: number;
+    maxStringLength?: number;
+}
+export declare function decodeV2(buffer: Uint8Array, options?: DecodeV2Options): KodaValue;
+//# sourceMappingURL=decoderV2.d.ts.map

package/dist/decoderV2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decoderV2.d.ts","sourceRoot":"","sources":["../src/decoderV2.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAmB1C,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAMD,wBAAgB,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,GAAE,eAAoB,GAAG,SAAS,CAuHrF"}

package/dist/decoderV2.js

@@ -0,0 +1,142 @@
+/**
+ * KODA binary v2 decoding (BINARY-V2.md).
+ */
+import { KodaDecodeError } from './errors.js';
+import { readUvarint as readUvarintFrom, zigzagDecode } from './varint.js';
+const MAGIC_V2 = new Uint8Array([0x4b, 0x44]);
+const VERSION_V2 = 0x02;
+var Tag;
+(function (Tag) {
+    Tag[Tag["Null"] = 0] = "Null";
+    Tag[Tag["False"] = 1] = "False";
+    Tag[Tag["True"] = 2] = "True";
+    Tag[Tag["IntVarint"] = 3] = "IntVarint";
+    Tag[Tag["Int64"] = 4] = "Int64";
+    Tag[Tag["Float"] = 5] = "Float";
+    Tag[Tag["String"] = 6] = "String";
+    Tag[Tag["Array"] = 8] = "Array";
+    Tag[Tag["Object"] = 9] = "Object";
+})(Tag || (Tag = {}));
+const DEFAULT_MAX_DEPTH = 256;
+const DEFAULT_MAX_DICT = 65536;
+const DEFAULT_MAX_STRING = 1_000_000;
+export function decodeV2(buffer, options = {}) {
+    const maxDepth = options.maxDepth ?? DEFAULT_MAX_DEPTH;
+    const maxDict = options.maxDictionarySize ?? DEFAULT_MAX_DICT;
+    const maxStr = options.maxStringLength ?? DEFAULT_MAX_STRING;
+    let offset = 0;
+    const view = new DataView(buffer.buffer, buffer.byteOffset, buffer.length);
+    function fail(message) {
+        throw new KodaDecodeError(message, { byteOffset: offset });
+    }
+    function ensure(n) {
+        if (offset + n > buffer.length)
+            fail('Truncated input');
+    }
+    function readByte() {
+        ensure(1);
+        return buffer[offset++];
+    }
+    function readUvarint() {
+        const r = readUvarintFrom(buffer, offset);
+        offset = r.offset;
+        return r.value;
+    }
+    function readBytes(n) {
+        ensure(n);
+        const slice = buffer.subarray(offset, offset + n);
+        offset += n;
+        return slice;
+    }
+    function readI64() {
+        ensure(8);
+        const v = view.getBigInt64(offset, false);
+        offset += 8;
+        if (v >= Number.MIN_SAFE_INTEGER && v <= Number.MAX_SAFE_INTEGER)
+            return Number(v);
+        return Number(v);
+    }
+    function readF64() {
+        ensure(8);
+        const v = view.getFloat64(offset, false);
+        offset += 8;
+        return v;
+    }
+    function decodeUtf8(bytes) {
+        return new TextDecoder('utf-8', { fatal: true }).decode(bytes);
+    }
+    // Header
+    ensure(3);
+    if (buffer[offset] !== MAGIC_V2[0] || buffer[offset + 1] !== MAGIC_V2[1])
+        fail('Invalid magic (expected v2)');
+    offset += 2;
+    const version = readByte();
+    if (version !== VERSION_V2)
+        fail(`Unsupported version: ${version}`);
+    const dictLen = readUvarint();
+    if (dictLen > maxDict)
+        fail('Dictionary too large');
+    const dictionary = new Array(dictLen);
+    for (let i = 0; i < dictLen; i++) {
+        const keyLen = readUvarint();
+        if (keyLen > maxStr)
+            fail('Key string too long');
+        const keyBytes = readBytes(keyLen);
+        dictionary[i] = decodeUtf8(keyBytes);
+    }
+    function decodeValue(depth) {
+        if (depth > maxDepth)
+            fail('Maximum nesting depth exceeded');
+        ensure(1);
+        const tag = readByte();
+        switch (tag) {
+            case Tag.Null:
+                return null;
+            case Tag.False:
+                return false;
+            case Tag.True:
+                return true;
+            case Tag.IntVarint: {
+                const z = readUvarint();
+                return zigzagDecode(z);
+            }
+            case Tag.Int64:
+                return readI64();
+            case Tag.Float:
+                return readF64();
+            case Tag.String: {
+                const len = readUvarint();
+                if (len > maxStr)
+                    fail('String too long');
+                const bytes = readBytes(len);
+                return decodeUtf8(bytes);
+            }
+            case Tag.Array: {
+                const count = readUvarint();
+                const arr = new Array(count);
+                for (let i = 0; i < count; i++)
+                    arr[i] = decodeValue(depth + 1);
+                return arr;
+            }
+            case Tag.Object: {
+                const count = readUvarint();
+                const obj = {};
+                for (let i = 0; i < count; i++) {
+                    const keyIdx = readUvarint();
+                    if (keyIdx >= dictionary.length)
+                        fail('Invalid key index');
+                    const key = dictionary[keyIdx];
+                    obj[key] = decodeValue(depth + 1);
+                }
+                return obj;
+            }
+            default:
+                fail(`Unknown type tag: 0x${tag.toString(16)}`);
+        }
+    }
+    const value = decodeValue(0);
+    if (offset !== buffer.length)
+        fail('Trailing bytes after root value');
+    return value;
+}
+//# sourceMappingURL=decoderV2.js.map

package/dist/decoderV2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decoderV2.js","sourceRoot":"","sources":["../src/decoderV2.ts"],"names":[],"mappings":"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"}

package/dist/encoderV2.d.ts

@@ -0,0 +1,10 @@
+/**
+ * KODA binary v2 — compact storage-oriented encoding (BINARY-V2.md).
+ * Varints, minimal header, dictionary with varint lengths.
+ */
+import type { KodaValue } from './ast.js';
+export interface EncodeV2Options {
+    maxDepth?: number;
+}
+export declare function encodeV2(value: KodaValue, options?: EncodeV2Options): Uint8Array;
+//# sourceMappingURL=encoderV2.d.ts.map

package/dist/encoderV2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoderV2.d.ts","sourceRoot":"","sources":["../src/encoderV2.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAgD1C,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAID,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,GAAE,eAAoB,GAAG,UAAU,CAwHpF"}

package/dist/encoderV2.js

@@ -0,0 +1,159 @@
+/**
+ * KODA binary v2 — compact storage-oriented encoding (BINARY-V2.md).
+ * Varints, minimal header, dictionary with varint lengths.
+ */
+import { KodaEncodeError } from './errors.js';
+import { uvarintSize, writeUvarint, zigzagEncode } from './varint.js';
+const MAGIC_V2 = new Uint8Array([0x4b, 0x44]); // "KD"
+const VERSION_V2 = 0x02;
+var Tag;
+(function (Tag) {
+    Tag[Tag["Null"] = 0] = "Null";
+    Tag[Tag["False"] = 1] = "False";
+    Tag[Tag["True"] = 2] = "True";
+    Tag[Tag["IntVarint"] = 3] = "IntVarint";
+    Tag[Tag["Int64"] = 4] = "Int64";
+    Tag[Tag["Float"] = 5] = "Float";
+    Tag[Tag["String"] = 6] = "String";
+    Tag[Tag["Array"] = 8] = "Array";
+    Tag[Tag["Object"] = 9] = "Object";
+})(Tag || (Tag = {}));
+const MIN_INT32 = -0x8000_0000;
+const MAX_INT32 = 0x7fff_ffff;
+function collectKeys(value, set) {
+    if (value === null || typeof value !== 'object')
+        return;
+    if (Array.isArray(value)) {
+        for (const v of value)
+            collectKeys(v, set);
+        return;
+    }
+    const obj = value;
+    for (const k of Object.keys(obj)) {
+        set.add(k);
+        collectKeys(obj[k], set);
+    }
+}
+function encodeUtf8(s) {
+    return new TextEncoder().encode(s);
+}
+function compareKeys(a, b) {
+    const aa = encodeUtf8(a);
+    const bb = encodeUtf8(b);
+    for (let i = 0; i < Math.min(aa.length, bb.length); i++) {
+        if (aa[i] !== bb[i])
+            return aa[i] - bb[i];
+    }
+    return aa.length - bb.length;
+}
+const DEFAULT_MAX_DEPTH = 256;
+export function encodeV2(value, options = {}) {
+    const maxDepth = options.maxDepth ?? DEFAULT_MAX_DEPTH;
+    const keysSet = new Set();
+    collectKeys(value, keysSet);
+    const dictionary = [...keysSet].sort(compareKeys);
+    const keyToIndex = new Map();
+    dictionary.forEach((k, i) => keyToIndex.set(k, i));
+    const INITIAL = 4096;
+    let buf = new Uint8Array(INITIAL);
+    let off = 0;
+    function ensure(n) {
+        if (off + n > buf.length) {
+            const next = new Uint8Array(Math.max(buf.length * 2, off + n));
+            next.set(buf.subarray(0, off));
+            buf = next;
+        }
+    }
+    function writeByte(x) {
+        ensure(1);
+        buf[off++] = x;
+    }
+    function writeBytes(b) {
+        ensure(b.length);
+        buf.set(b, off);
+        off += b.length;
+    }
+    function appendUvarint(v) {
+        ensure(uvarintSize(v));
+        off = writeUvarint(buf, off, v);
+    }
+    // Header
+    buf.set(MAGIC_V2, off);
+    off += 2;
+    writeByte(VERSION_V2);
+    // Dictionary
+    appendUvarint(dictionary.length);
+    for (const k of dictionary) {
+        const bytes = encodeUtf8(k);
+        appendUvarint(bytes.length);
+        writeBytes(bytes);
+    }
+    function encodeValue(v, depth) {
+        if (depth > maxDepth) {
+            throw new KodaEncodeError('Maximum nesting depth exceeded', { byteOffset: off });
+        }
+        if (v === null) {
+            writeByte(Tag.Null);
+            return;
+        }
+        if (v === false) {
+            writeByte(Tag.False);
+            return;
+        }
+        if (v === true) {
+            writeByte(Tag.True);
+            return;
+        }
+        if (typeof v === 'number') {
+            if (Number.isInteger(v) && v >= MIN_INT32 && v <= MAX_INT32) {
+                writeByte(Tag.IntVarint);
+                const z = zigzagEncode(v);
+                ensure(uvarintSize(z));
+                off = writeUvarint(buf, off, z);
+                return;
+            }
+            // Float or int64
+            if (Number.isInteger(v) && v >= Number.MIN_SAFE_INTEGER && v <= Number.MAX_SAFE_INTEGER) {
+                writeByte(Tag.Int64);
+                ensure(8);
+                const view = new DataView(buf.buffer, buf.byteOffset + off, 8);
+                view.setBigInt64(0, BigInt(Math.floor(v)), false);
+                off += 8;
+                return;
+            }
+            writeByte(Tag.Float);
+            ensure(8);
+            new DataView(buf.buffer, buf.byteOffset + off, 8).setFloat64(0, v, false);
+            off += 8;
+            return;
+        }
+        if (typeof v === 'string') {
+            const bytes = encodeUtf8(v);
+            writeByte(Tag.String);
+            appendUvarint(bytes.length);
+            writeBytes(bytes);
+            return;
+        }
+        if (Array.isArray(v)) {
+            writeByte(Tag.Array);
+            appendUvarint(v.length);
+            for (const item of v)
+                encodeValue(item, depth + 1);
+            return;
+        }
+        const obj = v;
+        const sortedKeys = Object.keys(obj).sort(compareKeys);
+        writeByte(Tag.Object);
+        appendUvarint(sortedKeys.length);
+        for (const key of sortedKeys) {
+            const idx = keyToIndex.get(key);
+            if (idx === undefined)
+                throw new KodaEncodeError('Key not in dictionary', { byteOffset: off });
+            appendUvarint(idx);
+            encodeValue(obj[key], depth + 1);
+        }
+    }
+    encodeValue(value, 0);
+    return off === buf.length ? buf : buf.subarray(0, off);
+}
+//# sourceMappingURL=encoderV2.js.map

package/dist/encoderV2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoderV2.js","sourceRoot":"","sources":["../src/encoderV2.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -17,6 +17,8 @@ export type { ParseOptions } from './parser.js';
 export type { StringifyOptions } from './stringify.js';
 export type { EncodeOptions } from './encoder.js';
 export type { DecodeOptions } from './decoder.js';
+export { decodeAsync, createDecoderPool } from './decode-async.js';
+export type { DecoderPool, DecoderPoolOptions } from './decode-async.js';
 /** True if the C++ native addon is in use. */
 export declare function isNativeAvailable(): boolean;
 /**
@@ -35,10 +37,15 @@ export declare function stringify(value: KodaValue, options?: StringifyOptions):
  */
 export declare function encode(value: KodaValue, options?: EncodeOptions): Uint8Array;
 /**
- * Decode binary (.kod) to a value.
- * Uses native C++ when addon is built.
+ * Decode binary (.kod) to a value. Non-blocking: runs in a worker thread so the
+ * main thread stays responsive. Prefer this over decodeSync for large payloads.
  */
-export declare function decode(buffer: Uint8Array, options?: DecodeOptions): KodaValue;
+export declare function decode(buffer: Uint8Array, options?: DecodeOptions): Promise<KodaValue>;
+/**
+ * Synchronous decode. Blocks the event loop; use sparingly or for small payloads.
+ * Uses native C++ when addon is built, otherwise JS fallback.
+ */
+export declare function decodeSync(buffer: Uint8Array, options?: DecodeOptions): KodaValue;
 /**
  * Load and parse a .koda text file (UTF-8).
  */

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAIlD,OAAO,EAAE,KAAK,IAAI,cAAc,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC5G,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC1F,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAQlD,8CAA8C;AAC9C,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,SAAS,CAUrE;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAM9E;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,UAAU,CAM5E;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,SAAS,CAe7E;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC,CAGvF;AAED,gGAAgG;AAChG,OAAO,EAAE,cAAc,EAAE,CAAC;AAE1B;;GAEG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAGxG;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAE/C;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAEhD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAIlD,OAAO,EAAE,KAAK,IAAI,cAAc,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC5G,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC1F,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACnE,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAQzE,8CAA8C;AAC9C,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,SAAS,CAUrE;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAM9E;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,UAAU,CAM5E;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,CAAC,CAEtF;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,SAAS,CAejF;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC,CAGvF;AAED,gGAAgG;AAChG,OAAO,EAAE,cAAc,EAAE,CAAC;AAE1B;;GAEG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAGxG;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAE/C;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAEhD"}

package/dist/index.js

@@ -13,9 +13,11 @@ import { KodaDecodeError, KodaParseError } from './errors.js';
 import { loadNative } from './native.js';
 import { parseFast } from './parseFast.js';
 import { parse as parseWithLexer } from './parser.js';
+import { decodeAsync } from './decode-async.js';
 import { stringify as stringifyText } from './stringify.js';
 export { isKodaObject, isKodaArray, isKodaString, isKodaNumber, isKodaBoolean, isKodaNull } from './ast.js';
 export { KodaError, KodaParseError, KodaEncodeError, KodaDecodeError } from './errors.js';
+export { decodeAsync, createDecoderPool } from './decode-async.js';
 const _addonPath = join(dirname(dirname(fileURLToPath(import.meta.url))), 'build', 'Release', 'koda_format.node');
 function getNative() {
     return loadNative(import.meta.url, _addonPath);
@@ -63,10 +65,17 @@ export function encode(value, options) {
     return encodeBinary(value, options);
 }
 /**
- * Decode binary (.kod) to a value.
- * Uses native C++ when addon is built.
+ * Decode binary (.kod) to a value. Non-blocking: runs in a worker thread so the
+ * main thread stays responsive. Prefer this over decodeSync for large payloads.
  */
 export function decode(buffer, options) {
+    return decodeAsync(buffer, options);
+}
+/**
+ * Synchronous decode. Blocks the event loop; use sparingly or for small payloads.
+ * Uses native C++ when addon is built, otherwise JS fallback.
+ */
+export function decodeSync(buffer, options) {
     const native = getNative();
     if (native) {
         try {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,MAAM,IAAI,YAAY,EAAE,MAAM,cAAc,CAAC;AAEtD,OAAO,EAAE,MAAM,IAAI,YAAY,EAAE,MAAM,cAAc,CAAC;AAEtD,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAsB,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,KAAK,IAAI,cAAc,EAAE,MAAM,aAAa,CAAC;AAEtD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAI5D,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC5G,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAK1F,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGnE,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,kBAAkB,CAAC,CAAC;AAElH,SAAS,SAAS;IAChB,OAAO,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;AACjD,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,iBAAiB;IAC/B,OAAO,SAAS,EAAE,KAAK,IAAI,CAAC;AAC9B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,KAAK,CAAC,IAAY,EAAE,OAAsB;IACxD,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,IAAI,MAAM,EAAE,CAAC;QACX,IAAI,CAAC;YACH,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAc,CAAC;QAC1E,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,CAAC,YAAY,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,cAAc,CAAE,CAAW,CAAC,OAAO,CAAC,CAAC;QACnF,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,KAAgB,EAAE,OAA0B;IACpE,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,IAAI,MAAM,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QAC/B,OAAO,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AACvC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,MAAM,CAAC,KAAgB,EAAE,OAAuB;IAC9D,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAe,CAAC;IAC7E,CAAC;IACD,OAAO,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,MAAM,CAAC,MAAkB,EAAE,OAAuB;IAChE,OAAO,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,MAAkB,EAAE,OAAuB;IACpE,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,IAAI,MAAM,EAAE,CAAC;QACX,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACnE,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE;gBACxB,QAAQ,EAAE,OAAO,EAAE,QAAQ;gBAC3B,iBAAiB,EAAE,OAAO,EAAE,iBAAiB;gBAC7C,eAAe,EAAE,OAAO,EAAE,eAAe;aAC1C,CAAc,CAAC;QAClB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,CAAC,YAAY,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,eAAe,CAAE,CAAW,CAAC,OAAO,CAAC,CAAC;QACrF,CAAC;IACH,CAAC;IACD,OAAO,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAY,EAAE,OAAsB;IACjE,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC9C,OAAO,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AACjC,CAAC;AAED,gGAAgG;AAChG,OAAO,EAAE,cAAc,EAAE,CAAC;AAE1B;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAY,EAAE,KAAgB,EAAE,OAA0B;IACvF,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC1C,MAAM,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,MAAM,CAAC,KAAgB;IACrC,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAc,CAAC;AACvC,CAAC"}

package/dist/varint.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Unsigned and zigzag signed varint encoding for KODA binary v2.
+ */
+/** Encode unsigned integer as varint; write into buf at off; return new offset. */
+export declare function writeUvarint(buf: Uint8Array, off: number, v: number): number;
+/** Read unsigned varint from buf at off; return value and new offset. */
+export declare function readUvarint(buf: Uint8Array, off: number): {
+    value: number;
+    offset: number;
+};
+/** Zigzag encode: 0->0, -1->1, 1->2, -2->3. Fits 32-bit signed int. */
+export declare function zigzagEncode(n: number): number;
+/** Zigzag decode. */
+export declare function zigzagDecode(z: number): number;
+/** Return number of bytes needed to encode v as unsigned varint. */
+export declare function uvarintSize(v: number): number;
+//# sourceMappingURL=varint.d.ts.map

package/dist/varint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"varint.d.ts","sourceRoot":"","sources":["../src/varint.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,mFAAmF;AACnF,wBAAgB,YAAY,CAAC,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAO5E;AAED,yEAAyE;AACzE,wBAAgB,WAAW,CAAC,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAW3F;AAED,uEAAuE;AACvE,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,qBAAqB;AACrB,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,oEAAoE;AACpE,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ7C"}

package/dist/varint.js

@@ -0,0 +1,48 @@
+/**
+ * Unsigned and zigzag signed varint encoding for KODA binary v2.
+ */
+/** Encode unsigned integer as varint; write into buf at off; return new offset. */
+export function writeUvarint(buf, off, v) {
+    while (v > 0x7f) {
+        buf[off++] = (v & 0x7f) | 0x80;
+        v >>>= 7;
+    }
+    buf[off++] = v & 0x7f;
+    return off;
+}
+/** Read unsigned varint from buf at off; return value and new offset. */
+export function readUvarint(buf, off) {
+    let value = 0;
+    let shift = 0;
+    for (;;) {
+        if (off >= buf.length)
+            throw new Error('Truncated varint');
+        const b = buf[off++];
+        value |= (b & 0x7f) << shift;
+        if ((b & 0x80) === 0)
+            return { value, offset: off };
+        shift += 7;
+        if (shift >= 35)
+            throw new Error('Varint overflow');
+    }
+}
+/** Zigzag encode: 0->0, -1->1, 1->2, -2->3. Fits 32-bit signed int. */
+export function zigzagEncode(n) {
+    return (n << 1) ^ (n >> 31);
+}
+/** Zigzag decode. */
+export function zigzagDecode(z) {
+    return (z >>> 1) ^ -(z & 1);
+}
+/** Return number of bytes needed to encode v as unsigned varint. */
+export function uvarintSize(v) {
+    if (v === 0)
+        return 1;
+    let n = 0;
+    while (v > 0) {
+        n++;
+        v >>>= 7;
+    }
+    return n;
+}
+//# sourceMappingURL=varint.js.map

package/dist/varint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"varint.js","sourceRoot":"","sources":["../src/varint.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,mFAAmF;AACnF,MAAM,UAAU,YAAY,CAAC,GAAe,EAAE,GAAW,EAAE,CAAS;IAClE,OAAO,CAAC,GAAG,IAAI,EAAE,CAAC;QAChB,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;QAC/B,CAAC,MAAM,CAAC,CAAC;IACX,CAAC;IACD,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;IACtB,OAAO,GAAG,CAAC;AACb,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,WAAW,CAAC,GAAe,EAAE,GAAW;IACtD,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,SAAS,CAAC;QACR,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;QAC3D,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,EAAE,CAAE,CAAC;QACtB,KAAK,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,KAAK,CAAC;QAC7B,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;QACpD,KAAK,IAAI,CAAC,CAAC;QACX,IAAI,KAAK,IAAI,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACtD,CAAC;AACH,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,YAAY,CAAC,CAAS;IACpC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AAC9B,CAAC;AAED,qBAAqB;AACrB,MAAM,UAAU,YAAY,CAAC,CAAS;IACpC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AAC9B,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,WAAW,CAAC,CAAS;IACnC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACtB,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACb,CAAC,EAAE,CAAC;QACJ,CAAC,MAAM,CAAC,CAAC;IACX,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/view.d.ts

@@ -0,0 +1,46 @@
+/**
+ * KodaView — direct-access API over KODA binary (v3) or wrapper over decoded value (v2).
+ *
+ * For v3 format: parses only header + dictionary + root directory; get(key) seeks and
+ * decodes one value. See BINARY-DIRECT-ACCESS.md.
+ *
+ * For v2 format: full decode then wrap (same API, no direct access). Enables consistent
+ * API until v3 encoder exists.
+ */
+import type { KodaValue } from './ast.js';
+export interface ViewOptions {
+    /** Reserved for v3 options (e.g. maxDictionarySize). */
+    maxDictionarySize?: number;
+}
+/**
+ * View over a KODA value: direct-access style API (get/has/keys/getAt) without
+ * building a full object unless toObject() is called.
+ */
+export interface KodaView {
+    /** Get value by key (object) or index (array). Returns KodaView for nested object/array. */
+    get(key: string | number): KodaValue | KodaView | undefined;
+    /** True if key exists (object) or index in range (array). */
+    has(key: string | number): boolean;
+    /** Keys of this object (canonical order). For array, returns indices as strings. */
+    keys(): string[];
+    /** Get array element by index. Same as get(index) for arrays. */
+    getAt(index: number): KodaValue | KodaView | undefined;
+    /** Number of keys (object) or length (array). */
+    readonly length: number;
+    /** Node type. */
+    readonly type: 'object' | 'array' | 'scalar';
+    /** Decode this subtree to a plain KodaValue (object/array/primitive). */
+    toObject(): KodaValue;
+}
+/**
+ * Open a KODA binary buffer as a KodaView.
+ * - v3 (future): direct access; only directory parsed until get().
+ * - v2 (current): full decode then wrap; same API, no direct access.
+ */
+export declare function view(buffer: Uint8Array, _options?: ViewOptions): KodaView;
+/**
+ * Wrap a decoded KodaValue in the KodaView API. Used for v2 buffers.
+ * No direct access; all data already in memory.
+ */
+export declare function wrapAsView(value: KodaValue): KodaView;
+//# sourceMappingURL=view.d.ts.map

package/dist/view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../src/view.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAO1C,MAAM,WAAW,WAAW;IAC1B,wDAAwD;IACxD,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,4FAA4F;IAC5F,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC5D,6DAA6D;IAC7D,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACnC,oFAAoF;IACpF,IAAI,IAAI,MAAM,EAAE,CAAC;IACjB,iEAAiE;IACjE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;IACvD,iDAAiD;IACjD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,iBAAiB;IACjB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC7C,yEAAyE;IACzE,QAAQ,IAAI,SAAS,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,GAAE,WAAgB,GAAG,QAAQ,CAc7E;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,CAQrD"}

package/dist/view.js

@@ -0,0 +1,162 @@
+/**
+ * KodaView — direct-access API over KODA binary (v3) or wrapper over decoded value (v2).
+ *
+ * For v3 format: parses only header + dictionary + root directory; get(key) seeks and
+ * decodes one value. See BINARY-DIRECT-ACCESS.md.
+ *
+ * For v2 format: full decode then wrap (same API, no direct access). Enables consistent
+ * API until v3 encoder exists.
+ */
+import { decodeV2 } from './decoderV2.js';
+const MAGIC_V2 = new Uint8Array([0x4b, 0x44]);
+const VERSION_V2 = 0x02;
+const VERSION_V3 = 0x03;
+/**
+ * Open a KODA binary buffer as a KodaView.
+ * - v3 (future): direct access; only directory parsed until get().
+ * - v2 (current): full decode then wrap; same API, no direct access.
+ */
+export function view(buffer, _options = {}) {
+    if (buffer.length < 3)
+        throw new Error('KODA buffer too short');
+    if (buffer[0] !== MAGIC_V2[0] || buffer[1] !== MAGIC_V2[1]) {
+        throw new Error('Invalid KODA magic');
+    }
+    const version = buffer[2];
+    if (version === VERSION_V3) {
+        throw new Error('KODA binary v3 direct-access not yet implemented. See BINARY-DIRECT-ACCESS.md.');
+    }
+    if (version === VERSION_V2) {
+        const value = decodeV2(buffer);
+        return wrapAsView(value);
+    }
+    throw new Error(`Unsupported KODA binary version: ${version}`);
+}
+/**
+ * Wrap a decoded KodaValue in the KodaView API. Used for v2 buffers.
+ * No direct access; all data already in memory.
+ */
+export function wrapAsView(value) {
+    if (value === null || typeof value !== 'object') {
+        return new ScalarView(value);
+    }
+    if (Array.isArray(value)) {
+        return new ArrayView(value);
+    }
+    return new ObjectView(value);
+}
+function asView(v) {
+    if (v === null || typeof v !== 'object')
+        return new ScalarView(v);
+    if (Array.isArray(v))
+        return new ArrayView(v);
+    return new ObjectView(v);
+}
+class ScalarView {
+    value;
+    constructor(value) {
+        this.value = value;
+    }
+    get() {
+        return this.value;
+    }
+    has() {
+        return false;
+    }
+    keys() {
+        return [];
+    }
+    getAt() {
+        return undefined;
+    }
+    get length() {
+        return 0;
+    }
+    get type() {
+        return 'scalar';
+    }
+    toObject() {
+        return this.value;
+    }
+}
+class ObjectView {
+    obj;
+    keyList;
+    constructor(obj) {
+        this.obj = obj;
+        this.keyList = Object.keys(obj).sort((a, b) => a.localeCompare(b, 'en', { sensitivity: 'base' }));
+    }
+    get(key) {
+        if (typeof key !== 'string')
+            return undefined;
+        const v = this.obj[key];
+        if (v === undefined)
+            return undefined;
+        if (v === null || typeof v !== 'object')
+            return v;
+        if (Array.isArray(v))
+            return new ArrayView(v);
+        return new ObjectView(v);
+    }
+    has(key) {
+        return typeof key === 'string' && key in this.obj;
+    }
+    keys() {
+        return this.keyList;
+    }
+    getAt(index) {
+        const k = this.keyList[index];
+        return k === undefined ? undefined : this.get(k);
+    }
+    get length() {
+        return this.keyList.length;
+    }
+    get type() {
+        return 'object';
+    }
+    toObject() {
+        return this.obj;
+    }
+}
+class ArrayView {
+    arr;
+    constructor(arr) {
+        this.arr = arr;
+    }
+    get(key) {
+        const i = typeof key === 'number' ? key : parseInt(key, 10);
+        if (Number.isNaN(i) || i < 0 || i >= this.arr.length)
+            return undefined;
+        const v = this.arr[i];
+        if (v === undefined)
+            return undefined;
+        if (v === null || typeof v !== 'object')
+            return v;
+        return asView(v);
+    }
+    has(key) {
+        const i = typeof key === 'number' ? key : parseInt(key, 10);
+        return !Number.isNaN(i) && i >= 0 && i < this.arr.length;
+    }
+    keys() {
+        return this.arr.map((_, i) => String(i));
+    }
+    getAt(index) {
+        const v = this.arr[index];
+        if (v === undefined)
+            return undefined;
+        if (v === null || typeof v !== 'object')
+            return v;
+        return asView(v);
+    }
+    get length() {
+        return this.arr.length;
+    }
+    get type() {
+        return 'array';
+    }
+    toObject() {
+        return this.arr;
+    }
+}
+//# sourceMappingURL=view.js.map

package/dist/view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.js","sourceRoot":"","sources":["../src/view.ts"],"names":[],"mappings":"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"}

package/dist/worker/decoder-worker.d.ts

@@ -0,0 +1,20 @@
+/**
+ * KODA decoder worker. Runs in a Worker Thread; loads native addon or uses JS fallback.
+ * Receives binary buffer (transferable), decodes, posts result. Keeps main thread non-blocking.
+ */
+import type { KodaValue } from '../ast.js';
+import type { DecodeOptions } from '../decoder.js';
+export interface DecoderWorkerMessageIn {
+    id: number;
+    buffer: ArrayBuffer;
+    options?: DecodeOptions;
+}
+export interface DecoderWorkerMessageOutSuccess {
+    id: number;
+    value: KodaValue;
+}
+export interface DecoderWorkerMessageOutError {
+    id: number;
+    error: string;
+}
+//# sourceMappingURL=decoder-worker.d.ts.map

package/dist/worker/decoder-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decoder-worker.d.ts","sourceRoot":"","sources":["../../src/worker/decoder-worker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAcnD,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAED,MAAM,WAAW,8BAA8B;IAC7C,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,WAAW,4BAA4B;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/worker/decoder-worker.js

@@ -0,0 +1,42 @@
+/**
+ * KODA decoder worker. Runs in a Worker Thread; loads native addon or uses JS fallback.
+ * Receives binary buffer (transferable), decodes, posts result. Keeps main thread non-blocking.
+ */
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { parentPort } from 'node:worker_threads';
+import { decode as decodeJS } from '../decoder.js';
+import { loadNative } from '../native.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const addonPath = join(__dirname, '..', '..', 'build', 'Release', 'koda_format.node');
+let cachedNative = undefined;
+function getNative() {
+    if (cachedNative !== undefined)
+        return cachedNative;
+    cachedNative = loadNative(import.meta.url, addonPath);
+    return cachedNative;
+}
+function doDecode(buffer, options) {
+    const buf = Buffer.from(buffer);
+    const binding = getNative();
+    if (binding) {
+        return binding.decode(buf, {
+            maxDepth: options?.maxDepth,
+            maxDictionarySize: options?.maxDictionarySize,
+            maxStringLength: options?.maxStringLength,
+        });
+    }
+    return decodeJS(new Uint8Array(buffer), options);
+}
+parentPort.on('message', (msg) => {
+    const { id, buffer, options } = msg;
+    try {
+        const value = doDecode(buffer, options);
+        parentPort.postMessage({ id, value });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        parentPort.postMessage({ id, error: message });
+    }
+});
+//# sourceMappingURL=decoder-worker.js.map

package/dist/worker/decoder-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decoder-worker.js","sourceRoot":"","sources":["../../src/worker/decoder-worker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,OAAO,EAAE,MAAM,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,EAAE,UAAU,EAAsB,MAAM,cAAc,CAAC;AAE9D,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,kBAAkB,CAAC,CAAC;AAEtF,IAAI,YAAY,GAAqC,SAAS,CAAC;AAE/D,SAAS,SAAS;IAChB,IAAI,YAAY,KAAK,SAAS;QAAE,OAAO,YAAY,CAAC;IACpD,YAAY,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IACtD,OAAO,YAAY,CAAC;AACtB,CAAC;AAkBD,SAAS,QAAQ,CAAC,MAAmB,EAAE,OAAuB;IAC5D,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAChC,MAAM,OAAO,GAAG,SAAS,EAAE,CAAC;IAC5B,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE;YACzB,QAAQ,EAAE,OAAO,EAAE,QAAQ;YAC3B,iBAAiB,EAAE,OAAO,EAAE,iBAAiB;YAC7C,eAAe,EAAE,OAAO,EAAE,eAAe;SAC1C,CAAc,CAAC;IAClB,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC;AACnD,CAAC;AAED,UAAW,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,GAA2B,EAAE,EAAE;IACxD,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC;IACpC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC5C,UAAW,CAAC,WAAW,CAAC,EAAE,EAAE,EAAE,KAAK,EAAoC,CAAC,CAAC;IACvE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,UAAW,CAAC,WAAW,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAkC,CAAC,CAAC;IAClF,CAAC;AACH,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "koda-format",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "type": "module",
   "description": "Compact Object Data Architecture — text and binary format with canonical encoding",
   "main": "dist/index.js",