@aperturesyndicate/synx-format 3.6.0 → 3.6.1

package/README.md

@@ -1,17 +1,17 @@
-# SYNX for JS/TS — @aperturesyndicate/synx
+# SYNX for JS/TS — @aperturesyndicate/synx-format
 
 The official JavaScript & TypeScript parser for the SYNX format.
 
 ## Install
 
 ```bash
-npm install @aperturesyndicate/synx
+npm install @aperturesyndicate/synx-format
 ```
 
 ## Usage
 
 ```javascript
-const Synx = require('@aperturesyndicate/synx');
+const Synx = require('@aperturesyndicate/synx-format');
 
 // Load from file
 const data = Synx.loadSync('config.synx');
@@ -25,7 +25,7 @@ console.log(data2.name); // "Wario"
 ### TypeScript
 
 ```typescript
-import Synx from '@aperturesyndicate/synx';
+import Synx from '@aperturesyndicate/synx-format';
 
 interface Config {
   server: { port: number; host: string };
@@ -63,7 +63,7 @@ console.log(data.server.port); // typed as number
 Install globally:
 
 ```bash
-npm install -g @aperturesyndicate/synx
+npm install -g @aperturesyndicate/synx-format
 ```
 
 ### Commands

package/SPECIFICATION.md

@@ -2,5 +2,6 @@
 
 The normative specification files live in the monorepo (not duplicated here for npm):
 
-- English: [`docs/spec/SPECIFICATION_EN.md`](https://github.com/kaiserrberg/synx-format/blob/main/docs/spec/SPECIFICATION_EN.md)
-- Russian: [`docs/spec/SPECIFICATION_RU.md`](https://github.com/kaiserrberg/synx-format/blob/main/docs/spec/SPECIFICATION_RU.md)
+- English: [`docs/spec/SPECIFICATION_EN.md`](https://github.com/APERTURESyndicate/synx-format/blob/main/docs/spec/SPECIFICATION_EN.md)
+- Russian: [`docs/spec/SPECIFICATION_RU.md`](https://github.com/APERTURESyndicate/synx-format/blob/main/docs/spec/SPECIFICATION_RU.md)
+- Normative (SYNX 3.6): [`docs/spec/SYNX-3.6-NORMATIVE.md`](https://github.com/APERTURESyndicate/synx-format/blob/main/docs/spec/SYNX-3.6-NORMATIVE.md)

package/bin/synx.js

@@ -14,7 +14,7 @@ SYNX CLI — The Active Data Format (v3.6.0)
 
 DEPRECATED: This Node.js CLI is superseded by the native Rust CLI.
             Install: cargo install synx-cli
-            Docs:    https://github.com/kaiserrberg/synx-format#cli-rust
+            Docs:    https://github.com/APERTURESyndicate/synx-format#cli-rust
 
 Usage:
   synx convert <file.synx> [--format json|yaml|toml|env]  [--strict] [--active]

package/dist/browser.d.ts

@@ -1,5 +1,5 @@
 /**
- * SYNX Browser Bundle — @aperturesyndicate/synx
+ * SYNX Browser Bundle — @aperturesyndicate/synx-format
  *
  * Lightweight browser-compatible build.
  * No Node.js dependencies (fs, path).

package/dist/browser.js

@@ -1,6 +1,6 @@
 "use strict";
 /**
- * SYNX Browser Bundle — @aperturesyndicate/synx
+ * SYNX Browser Bundle — @aperturesyndicate/synx-format
  *
  * Lightweight browser-compatible build.
  * No Node.js dependencies (fs, path).

package/dist/calc.d.ts

@@ -1,5 +1,5 @@
 /**
- * SYNX Safe Calculator — @aperturesyndicate/synx
+ * SYNX Safe Calculator — @aperturesyndicate/synx-format
  *
  * Evaluates arithmetic expressions WITHOUT eval() or new Function().
  * Supports: +, -, *, /, %, parentheses, and numeric literals.

package/dist/calc.js

@@ -1,6 +1,6 @@
 "use strict";
 /**
- * SYNX Safe Calculator — @aperturesyndicate/synx
+ * SYNX Safe Calculator — @aperturesyndicate/synx-format
  *
  * Evaluates arithmetic expressions WITHOUT eval() or new Function().
  * Supports: +, -, *, /, %, parentheses, and numeric literals.

package/dist/engine.d.ts

@@ -1,5 +1,5 @@
 /**
- * SYNX Engine — @aperturesyndicate/synx
+ * SYNX Engine — @aperturesyndicate/synx-format
  *
  * Resolves active markers (:random, :calc, :env, :alias, :secret, etc.)
  * in a parsed SYNX object tree. Only runs in !active mode.

package/dist/engine.js

@@ -1,6 +1,6 @@
 "use strict";
 /**
- * SYNX Engine — @aperturesyndicate/synx
+ * SYNX Engine — @aperturesyndicate/synx-format
  *
  * Resolves active markers (:random, :calc, :env, :alias, :secret, etc.)
  * in a parsed SYNX object tree. Only runs in !active mode.

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * SYNX — @aperturesyndicate/synx
+ * SYNX — @aperturesyndicate/synx-format
  *
  * The Active Data Format.
  * Faster than JSON. Cheaper for AI tokens. Built-in logic.
@@ -54,6 +54,32 @@ declare class Synx {
      * ```
      */
     static load<T extends SynxObject = SynxObject>(filePath: string, options?: SynxOptions): Promise<T>;
+    /**
+     * Save a JS object to a .synx file synchronously.
+     *
+     * @param filePath - Path to the .synx file.
+     * @param obj      - The object to serialize and save.
+     * @param active   - If true, include `!active` directive.
+     *
+     * @example
+     * ```ts
+     * Synx.saveSync('config.synx', { app_name: 'TotalWario', port: 8080 });
+     * ```
+     */
+    static saveSync(filePath: string, obj: SynxObject, active?: boolean): void;
+    /**
+     * Save a JS object to a .synx file asynchronously.
+     *
+     * @param filePath - Path to the .synx file.
+     * @param obj      - The object to serialize and save.
+     * @param active   - If true, include `!active` directive.
+     *
+     * @example
+     * ```ts
+     * await Synx.save('config.synx', { app_name: 'TotalWario', port: 8080 });
+     * ```
+     */
+    static save(filePath: string, obj: SynxObject, active?: boolean): Promise<void>;
     /**
      * Serialize a JS object back to .synx format string.
      *
@@ -169,6 +195,70 @@ declare class Synx {
      * ```
      */
     static diff(a: SynxObject, b: SynxObject): SynxDiff;
+    /** Magic header for .synxb files */
+    private static readonly SYNXB_MAGIC;
+    /**
+     * Check if data is a `.synxb` binary file.
+     *
+     * @param data - Raw bytes to check.
+     * @returns True if the data starts with the SYNXB magic header.
+     *
+     * @example
+     * ```ts
+     * const buf = fs.readFileSync('config.synxb');
+     * if (Synx.isSynxb(buf)) { ... }
+     * ```
+     */
+    static isSynxb(data: Buffer | Uint8Array): boolean;
+    /**
+     * Compile a .synx string into compact binary `.synxb` format.
+     *
+     * The binary format stores the parsed value tree with an interned string table.
+     * It is deterministic and much faster to load than re-parsing text.
+     *
+     * @param text     - The .synx source text.
+     * @param resolved - If true and text is `!active`, resolve markers first.
+     * @returns A Uint8Array containing the `.synxb` binary.
+     *
+     * @example
+     * ```ts
+     * const binary = Synx.compile('name Alice\nage 30');
+     * fs.writeFileSync('config.synxb', binary);
+     * ```
+     */
+    static compile(text: string, resolved?: boolean): Uint8Array;
+    /**
+     * Decompile a `.synxb` binary back into a .synx text string.
+     *
+     * @param data - Raw `.synxb` bytes.
+     * @returns The reconstructed .synx text.
+     * @throws Error if the data is not valid `.synxb`.
+     *
+     * @example
+     * ```ts
+     * const buf = fs.readFileSync('config.synxb');
+     * const text = Synx.decompile(buf);
+     * console.log(text);
+     * ```
+     */
+    static decompile(data: Buffer | Uint8Array): string;
+    /**
+     * Parse a `!tool` mode SYNX text, reshaping into `{ tool, params }` format.
+     *
+     * @param text    - The .synx text (should contain `!tool` directive).
+     * @param options - Optional settings.
+     * @returns `{ tool: string, params: SynxObject }`.
+     *
+     * @example
+     * ```ts
+     * const toolCall = Synx.parseTool('!tool\ntool search\nparams\n  query AI');
+     * // { tool: 'search', params: { query: 'AI' } }
+     * ```
+     */
+    static parseTool(text: string, options?: SynxOptions): {
+        tool: string;
+        params: SynxObject;
+    };
 }
 type WatchCallback = (config: SynxObject, error?: Error) => void;
 interface WatchHandle {
@@ -178,9 +268,10 @@ interface SynxSchemaProperty {
     type?: string;
     minimum?: number;
     maximum?: number;
+    minLength?: number;
+    maxLength?: number;
     pattern?: string;
     enum?: string[];
-    required?: boolean;
 }
 interface SynxSchema {
     $schema: string;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAe,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGzF,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACtG,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAiEpC,cAAM,IAAI;IACR;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,UAAU,GAAG,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,CAAC;IAoC3F;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,UAAU,GAAG,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,CAAC;IAQlG;;;;;;;;;;;;OAYG;WACU,IAAI,CAAC,CAAC,SAAS,UAAU,GAAG,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,CAAC,CAAC;IAQ7G;;;;;;OAMG;IACH,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,UAAQ,GAAG,MAAM;IAWzD;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI;IAgBpE;;;;;;;OAOG;IACH,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAWnE;;;;;;;;;;OAUG;IACH,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI;IAoBnE;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,SAAS,GAAG,IAAI;IAuBvE;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO;IAIzC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IA4BnC,gEAAgE;IAChE,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,UAAO,GAAG,MAAM;IAIrD,gEAAgE;IAChE,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM;IAItC,gEAAgE;IAChE,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM;IAItC,kFAAkF;IAClF,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,SAAK,GAAG,MAAM;IAIlD,2FAA2F;IAC3F,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,OAAO,GAAE,WAAgB,GAAG,WAAW;IA0B/F,gEAAgE;IAChE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU;IAqCvC;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,QAAQ;CA2BpD;AAwRD,KAAK,aAAa,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC;AAEjE,UAAU,WAAW;IACnB,KAAK,IAAI,IAAI,CAAC;CACf;AAID,UAAU,kBAAkB;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,UAAU,UAAU;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC/C,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAID,eAAe,IAAI,CAAC;AACpB,OAAO,EAAE,IAAI,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 /**
- * SYNX — @aperturesyndicate/synx
+ * SYNX — @aperturesyndicate/synx-format
  *
  * The Active Data Format.
  * Faster than JSON. Cheaper for AI tokens. Built-in logic.
@@ -189,6 +189,40 @@ class Synx {
         const opts = options.basePath ? options : { ...options, basePath: path.dirname(absPath) };
         return Synx.parse(text, opts);
     }
+    /**
+     * Save a JS object to a .synx file synchronously.
+     *
+     * @param filePath - Path to the .synx file.
+     * @param obj      - The object to serialize and save.
+     * @param active   - If true, include `!active` directive.
+     *
+     * @example
+     * ```ts
+     * Synx.saveSync('config.synx', { app_name: 'TotalWario', port: 8080 });
+     * ```
+     */
+    static saveSync(filePath, obj, active = false) {
+        const absPath = path.resolve(filePath);
+        const text = Synx.stringify(obj, active);
+        fs.writeFileSync(absPath, text, 'utf-8');
+    }
+    /**
+     * Save a JS object to a .synx file asynchronously.
+     *
+     * @param filePath - Path to the .synx file.
+     * @param obj      - The object to serialize and save.
+     * @param active   - If true, include `!active` directive.
+     *
+     * @example
+     * ```ts
+     * await Synx.save('config.synx', { app_name: 'TotalWario', port: 8080 });
+     * ```
+     */
+    static async save(filePath, obj, active = false) {
+        const absPath = path.resolve(filePath);
+        const text = Synx.stringify(obj, active);
+        await fs.promises.writeFile(absPath, text, 'utf-8');
+    }
     /**
      * Serialize a JS object back to .synx format string.
      *
@@ -447,7 +481,6 @@ class Synx {
                 if (c.enum)
                     prop.enum = c.enum;
                 if (c.required) {
-                    prop.required = true;
                     required.push(key);
                 }
                 properties[key] = prop;
@@ -506,9 +539,296 @@ class Synx {
         }
         return { added, removed, changed, unchanged };
     }
+    /**
+     * Check if data is a `.synxb` binary file.
+     *
+     * @param data - Raw bytes to check.
+     * @returns True if the data starts with the SYNXB magic header.
+     *
+     * @example
+     * ```ts
+     * const buf = fs.readFileSync('config.synxb');
+     * if (Synx.isSynxb(buf)) { ... }
+     * ```
+     */
+    static isSynxb(data) {
+        if (data.length < 6)
+            return false;
+        for (let i = 0; i < 5; i++) {
+            if (data[i] !== Synx.SYNXB_MAGIC[i])
+                return false;
+        }
+        return true;
+    }
+    /**
+     * Compile a .synx string into compact binary `.synxb` format.
+     *
+     * The binary format stores the parsed value tree with an interned string table.
+     * It is deterministic and much faster to load than re-parsing text.
+     *
+     * @param text     - The .synx source text.
+     * @param resolved - If true and text is `!active`, resolve markers first.
+     * @returns A Uint8Array containing the `.synxb` binary.
+     *
+     * @example
+     * ```ts
+     * const binary = Synx.compile('name Alice\nage 30');
+     * fs.writeFileSync('config.synxb', binary);
+     * ```
+     */
+    static compile(text, resolved = false) {
+        const input = resolved && !/(?:^|\n)\s*!active\b/.test(text) ? '!active\n' + text : text;
+        const parsed = Synx.parse(input);
+        const strings = [];
+        const stringIndex = new Map();
+        function internString(s) {
+            if (stringIndex.has(s))
+                return stringIndex.get(s);
+            const idx = strings.length;
+            strings.push(s);
+            stringIndex.set(s, idx);
+            return idx;
+        }
+        // Collect all strings first
+        function collectStrings(val) {
+            if (val === null || val === undefined)
+                return;
+            if (typeof val === 'string') {
+                internString(val);
+                return;
+            }
+            if (Array.isArray(val)) {
+                val.forEach(collectStrings);
+                return;
+            }
+            if (typeof val === 'object') {
+                for (const [k, v] of Object.entries(val)) {
+                    internString(k);
+                    collectStrings(v);
+                }
+            }
+        }
+        collectStrings(parsed);
+        // Encode
+        const buf = [];
+        // Magic + version
+        buf.push(0x53, 0x59, 0x4e, 0x58, 0x42); // SYNXB
+        buf.push(0x01); // version 1
+        // Flags: bit0=active, bit3=resolved
+        const isActive = text.trimStart().startsWith('!active');
+        let flags = 0;
+        if (isActive)
+            flags |= 0x01;
+        if (resolved)
+            flags |= 0x08;
+        buf.push(flags);
+        // String table
+        writeVarint(buf, strings.length);
+        for (const s of strings) {
+            const encoded = new TextEncoder().encode(s);
+            writeVarint(buf, encoded.length);
+            for (const b of encoded)
+                buf.push(b);
+        }
+        // Value tree
+        function writeValue(val) {
+            if (val === null || val === undefined) {
+                buf.push(0x00);
+                return;
+            }
+            if (typeof val === 'boolean') {
+                buf.push(val ? 0x02 : 0x01);
+                return;
+            }
+            if (typeof val === 'number') {
+                if (Number.isInteger(val)) {
+                    buf.push(0x03);
+                    writeZigzag(buf, val);
+                }
+                else {
+                    buf.push(0x04);
+                    const view = new DataView(new ArrayBuffer(8));
+                    view.setFloat64(0, val, true); // little-endian
+                    for (let i = 0; i < 8; i++)
+                        buf.push(view.getUint8(i));
+                }
+                return;
+            }
+            if (typeof val === 'string') {
+                buf.push(0x05);
+                writeVarint(buf, internString(val));
+                return;
+            }
+            if (Array.isArray(val)) {
+                buf.push(0x06);
+                writeVarint(buf, val.length);
+                val.forEach(writeValue);
+                return;
+            }
+            if (typeof val === 'object') {
+                const entries = Object.entries(val);
+                buf.push(0x07);
+                writeVarint(buf, entries.length);
+                for (const [k, v] of entries) {
+                    writeVarint(buf, internString(k));
+                    writeValue(v);
+                }
+            }
+        }
+        writeValue(parsed);
+        return new Uint8Array(buf);
+    }
+    /**
+     * Decompile a `.synxb` binary back into a .synx text string.
+     *
+     * @param data - Raw `.synxb` bytes.
+     * @returns The reconstructed .synx text.
+     * @throws Error if the data is not valid `.synxb`.
+     *
+     * @example
+     * ```ts
+     * const buf = fs.readFileSync('config.synxb');
+     * const text = Synx.decompile(buf);
+     * console.log(text);
+     * ```
+     */
+    static decompile(data) {
+        if (!Synx.isSynxb(data)) {
+            throw new types_1.SynxError('Not a valid .synxb file');
+        }
+        let offset = 5; // skip magic
+        const version = data[offset++];
+        if (version !== 1)
+            throw new types_1.SynxError(`Unsupported .synxb version: ${version}`);
+        const flags = data[offset++];
+        const isActive = (flags & 0x01) !== 0;
+        const isLocked = (flags & 0x02) !== 0;
+        // String table
+        const [strCount, o1] = readVarint(data, offset);
+        offset = o1;
+        const strings = [];
+        const decoder = new TextDecoder();
+        for (let i = 0; i < strCount; i++) {
+            const [len, o2] = readVarint(data, offset);
+            offset = o2;
+            strings.push(decoder.decode(data.slice(offset, offset + len)));
+            offset += len;
+        }
+        // Value tree
+        function readValue() {
+            const tag = data[offset++];
+            switch (tag) {
+                case 0x00: return null;
+                case 0x01: return false;
+                case 0x02: return true;
+                case 0x03: {
+                    const [v, o] = readZigzag(data, offset);
+                    offset = o;
+                    return v;
+                }
+                case 0x04: {
+                    const view = new DataView(data.buffer, data.byteOffset + offset, 8);
+                    offset += 8;
+                    return view.getFloat64(0, true);
+                }
+                case 0x05: {
+                    const [idx, o] = readVarint(data, offset);
+                    offset = o;
+                    return strings[idx];
+                }
+                case 0x06: {
+                    const [len, o] = readVarint(data, offset);
+                    offset = o;
+                    const arr = [];
+                    for (let i = 0; i < len; i++)
+                        arr.push(readValue());
+                    return arr;
+                }
+                case 0x07: {
+                    const [len, o] = readVarint(data, offset);
+                    offset = o;
+                    const obj = {};
+                    for (let i = 0; i < len; i++) {
+                        const [ki, o2] = readVarint(data, offset);
+                        offset = o2;
+                        obj[strings[ki]] = readValue();
+                    }
+                    return obj;
+                }
+                case 0x08: {
+                    const [idx, o] = readVarint(data, offset);
+                    offset = o;
+                    return '[SECRET]';
+                }
+                default: throw new types_1.SynxError(`Unknown value tag: 0x${tag.toString(16)}`);
+            }
+        }
+        const value = readValue();
+        let header = '';
+        if (isActive)
+            header += '!active\n';
+        if (isLocked)
+            header += '!lock\n';
+        if (header)
+            header += '\n';
+        return header + serializeObject(value, 0);
+    }
+    /**
+     * Parse a `!tool` mode SYNX text, reshaping into `{ tool, params }` format.
+     *
+     * @param text    - The .synx text (should contain `!tool` directive).
+     * @param options - Optional settings.
+     * @returns `{ tool: string, params: SynxObject }`.
+     *
+     * @example
+     * ```ts
+     * const toolCall = Synx.parseTool('!tool\ntool search\nparams\n  query AI');
+     * // { tool: 'search', params: { query: 'AI' } }
+     * ```
+     */
+    static parseTool(text, options = {}) {
+        const parsed = Synx.parse(text, options);
+        const tool = typeof parsed.tool === 'string' ? parsed.tool : '';
+        const params = (typeof parsed.params === 'object' && parsed.params !== null && !Array.isArray(parsed.params))
+            ? parsed.params
+            : {};
+        return { tool, params };
+    }
 }
 exports.Synx = Synx;
-// ─── Deep equality helper ─────────────────────────────────
+// ─── Binary Format (.synxb) ─────────────────────────────
+/** Magic header for .synxb files */
+Synx.SYNXB_MAGIC = new Uint8Array([0x53, 0x59, 0x4e, 0x58, 0x42]); // "SYNXB"
+// ─── Binary encoding helpers ──────────────────────────────
+function writeVarint(buf, value) {
+    let v = value >>> 0;
+    while (v > 0x7f) {
+        buf.push((v & 0x7f) | 0x80);
+        v >>>= 7;
+    }
+    buf.push(v);
+}
+function readVarint(data, offset) {
+    let result = 0;
+    let shift = 0;
+    while (offset < data.length) {
+        const byte = data[offset++];
+        result |= (byte & 0x7f) << shift;
+        if ((byte & 0x80) === 0)
+            break;
+        shift += 7;
+    }
+    return [result >>> 0, offset];
+}
+function writeZigzag(buf, value) {
+    const zigzag = (value << 1) ^ (value >> 31);
+    writeVarint(buf, zigzag >>> 0);
+}
+function readZigzag(data, offset) {
+    const [raw, newOffset] = readVarint(data, offset);
+    const value = (raw >>> 1) ^ -(raw & 1);
+    return [value, newOffset];
+}
 function deepEqual(a, b) {
     if (a === b)
         return true;