satteri 0.1.0

package/README.md

@@ -0,0 +1,7 @@
+# satteri
+
+TypeScript layer with readers, visitors, materializers, and plugin system for Sätteri, a high-performance Markdown and MDX processor.
+
+> [!NOTE]
+> **Work in progress** — this package is under active development.
+> See the [Contributing Guide](../../CONTRIBUTING.md) if you want to get involved!

package/browser.js

@@ -0,0 +1 @@
+export * from '@bruits/satteri-wasm32-wasi'

package/dist/command-buffer.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Binary command buffer for efficient JS→Rust mutation serialization.
+ *
+ * Simple mutations (remove, setProperty) are encoded as compact binary commands.
+ * Structural mutations (insert, replace) carry payloads that can be raw strings
+ * (for Rust to re-parse) or JSON-serialized node trees.
+ *
+ * All multi-byte integers are little-endian to match native x86/ARM layout and
+ * avoid byte-swapping on the Rust side.
+ */
+import type { MdastNode } from "./types.js";
+type ReturnClass = "no_change" | "raw_markdown" | "raw_html" | "structured_node";
+export declare function classifyReturn(value: unknown): ReturnClass;
+export declare class CommandBuffer {
+    private buffer;
+    private view;
+    private bytes;
+    private offset;
+    constructor();
+    removeNode(nodeId: number): void;
+    /** Unified set-property for both MDAST and HAST nodes. */
+    setProperty(nodeId: number, key: string, value: unknown): void;
+    insertBefore(nodeId: number, newNode: MdastNode | {
+        raw: string;
+    } | {
+        rawHtml: string;
+    }): void;
+    insertAfter(nodeId: number, newNode: MdastNode | {
+        raw: string;
+    } | {
+        rawHtml: string;
+    }): void;
+    prependChild(nodeId: number, newNode: MdastNode | {
+        raw: string;
+    } | {
+        rawHtml: string;
+    }): void;
+    appendChild(nodeId: number, newNode: MdastNode | {
+        raw: string;
+    } | {
+        rawHtml: string;
+    }): void;
+    wrapNode(nodeId: number, parentNode: MdastNode | {
+        raw: string;
+    } | {
+        rawHtml: string;
+    }): void;
+    replace(nodeId: number, newNode: MdastNode | {
+        raw: string;
+    } | {
+        rawHtml: string;
+    }): void;
+    /** Write a REPLACE command with a pre-serialized JSON payload. */
+    replaceRawJson(nodeId: number, json: string): void;
+    /** Write any structural command with a pre-serialized JSON payload. */
+    insertBeforeRawJson(nodeId: number, json: string): void;
+    insertAfterRawJson(nodeId: number, json: string): void;
+    prependChildRawJson(nodeId: number, json: string): void;
+    appendChildRawJson(nodeId: number, json: string): void;
+    wrapNodeRawJson(nodeId: number, json: string): void;
+    private writeRawJsonCommand;
+    /** Return a Uint8Array view of the written bytes (no copy). */
+    getBuffer(): Uint8Array;
+    /** Number of bytes written so far. */
+    get length(): number;
+    /** Reset the buffer for reuse, releasing the old ArrayBuffer. */
+    reset(): void;
+    private writeStructuralCommand;
+    private ensureCapacity;
+    private grow;
+    private writeU8;
+    private writeU32;
+    private writeBytes;
+}
+export {};

package/dist/command-buffer.js

@@ -0,0 +1,231 @@
+/**
+ * Binary command buffer for efficient JS→Rust mutation serialization.
+ *
+ * Simple mutations (remove, setProperty) are encoded as compact binary commands.
+ * Structural mutations (insert, replace) carry payloads that can be raw strings
+ * (for Rust to re-parse) or JSON-serialized node trees.
+ *
+ * All multi-byte integers are little-endian to match native x86/ARM layout and
+ * avoid byte-swapping on the Rust side.
+ */
+// ---------------------------------------------------------------------------
+// Command bytes (0x01–0x0F)
+// ---------------------------------------------------------------------------
+const CMD_REMOVE = 0x01;
+const CMD_INSERT_BEFORE = 0x05;
+const CMD_INSERT_AFTER = 0x06;
+const CMD_PREPEND_CHILD = 0x07;
+const CMD_APPEND_CHILD = 0x08;
+const CMD_WRAP = 0x09;
+const CMD_REPLACE = 0x0b;
+const CMD_SET_PROPERTY = 0x0c;
+// ---------------------------------------------------------------------------
+// Payload types (0x10+, distinct range from commands)
+// ---------------------------------------------------------------------------
+const PAYLOAD_RAW_MARKDOWN = 0x10;
+const PAYLOAD_RAW_HTML = 0x11;
+const PAYLOAD_SERDE_JSON = 0x12;
+// ---------------------------------------------------------------------------
+// Value types for CMD_SET_PROPERTY (must match commands.rs PROP_* constants)
+// ---------------------------------------------------------------------------
+const PROP_STRING = 0;
+const PROP_BOOL_TRUE = 1;
+const PROP_BOOL_FALSE = 2;
+const PROP_SPACE_SEP = 3;
+const PROP_INT = 4;
+const PROP_NULL = 5;
+export function classifyReturn(value) {
+    if (value === undefined || value === null)
+        return "no_change";
+    const v = value;
+    if (typeof v.raw === "string")
+        return "raw_markdown";
+    if (typeof v.rawHtml === "string")
+        return "raw_html";
+    if (typeof v.type === "string")
+        return "structured_node";
+    throw new Error("Invalid return value from visitor: must have raw, rawHtml, or type");
+}
+// ---------------------------------------------------------------------------
+// CommandBuffer
+// ---------------------------------------------------------------------------
+const INITIAL_SIZE = 4096;
+const encoder = new TextEncoder();
+const EMPTY_U8 = new Uint8Array(0);
+export class CommandBuffer {
+    buffer;
+    view;
+    bytes;
+    offset = 0;
+    constructor() {
+        this.buffer = new ArrayBuffer(INITIAL_SIZE);
+        this.view = new DataView(this.buffer);
+        this.bytes = new Uint8Array(this.buffer);
+    }
+    // -- Public command methods -----------------------------------------------
+    removeNode(nodeId) {
+        this.ensureCapacity(5);
+        this.writeU8(CMD_REMOVE);
+        this.writeU32(nodeId);
+    }
+    /** Unified set-property for both MDAST and HAST nodes. */
+    setProperty(nodeId, key, value) {
+        const encodedName = encoder.encode(key);
+        let valueType;
+        let encodedValue;
+        if (value === null || value === undefined) {
+            valueType = PROP_NULL;
+            encodedValue = EMPTY_U8;
+        }
+        else if (value === true) {
+            valueType = PROP_BOOL_TRUE;
+            encodedValue = EMPTY_U8;
+        }
+        else if (value === false) {
+            valueType = PROP_BOOL_FALSE;
+            encodedValue = EMPTY_U8;
+        }
+        else if (typeof value === "number") {
+            valueType = PROP_INT;
+            encodedValue = encoder.encode(String(value));
+        }
+        else if (Array.isArray(value)) {
+            valueType = PROP_SPACE_SEP;
+            encodedValue = encoder.encode(value.join(" "));
+        }
+        else {
+            valueType = PROP_STRING;
+            encodedValue = encoder.encode(String(value));
+        }
+        // 1(cmd) + 4(nodeId) + 1(valueType) + 4(nameLen) + name + 4(valueLen) + value
+        this.ensureCapacity(14 + encodedName.length + encodedValue.length);
+        this.writeU8(CMD_SET_PROPERTY);
+        this.writeU32(nodeId);
+        this.writeU8(valueType);
+        this.writeU32(encodedName.length);
+        this.writeBytes(encodedName);
+        this.writeU32(encodedValue.length);
+        this.writeBytes(encodedValue);
+    }
+    insertBefore(nodeId, newNode) {
+        this.writeStructuralCommand(CMD_INSERT_BEFORE, nodeId, newNode);
+    }
+    insertAfter(nodeId, newNode) {
+        this.writeStructuralCommand(CMD_INSERT_AFTER, nodeId, newNode);
+    }
+    prependChild(nodeId, newNode) {
+        this.writeStructuralCommand(CMD_PREPEND_CHILD, nodeId, newNode);
+    }
+    appendChild(nodeId, newNode) {
+        this.writeStructuralCommand(CMD_APPEND_CHILD, nodeId, newNode);
+    }
+    wrapNode(nodeId, parentNode) {
+        this.writeStructuralCommand(CMD_WRAP, nodeId, parentNode);
+    }
+    replace(nodeId, newNode) {
+        this.writeStructuralCommand(CMD_REPLACE, nodeId, newNode);
+    }
+    /** Write a REPLACE command with a pre-serialized JSON payload. */
+    replaceRawJson(nodeId, json) {
+        this.writeRawJsonCommand(CMD_REPLACE, nodeId, json);
+    }
+    /** Write any structural command with a pre-serialized JSON payload. */
+    insertBeforeRawJson(nodeId, json) {
+        this.writeRawJsonCommand(CMD_INSERT_BEFORE, nodeId, json);
+    }
+    insertAfterRawJson(nodeId, json) {
+        this.writeRawJsonCommand(CMD_INSERT_AFTER, nodeId, json);
+    }
+    prependChildRawJson(nodeId, json) {
+        this.writeRawJsonCommand(CMD_PREPEND_CHILD, nodeId, json);
+    }
+    appendChildRawJson(nodeId, json) {
+        this.writeRawJsonCommand(CMD_APPEND_CHILD, nodeId, json);
+    }
+    wrapNodeRawJson(nodeId, json) {
+        this.writeRawJsonCommand(CMD_WRAP, nodeId, json);
+    }
+    writeRawJsonCommand(cmd, nodeId, json) {
+        const encoded = encoder.encode(json);
+        this.ensureCapacity(10 + encoded.length);
+        this.writeU8(cmd);
+        this.writeU32(nodeId);
+        this.writeU8(PAYLOAD_SERDE_JSON);
+        this.writeU32(encoded.length);
+        this.writeBytes(encoded);
+    }
+    // -- Result accessors -----------------------------------------------------
+    /** Return a Uint8Array view of the written bytes (no copy). */
+    getBuffer() {
+        return new Uint8Array(this.buffer, 0, this.offset);
+    }
+    /** Number of bytes written so far. */
+    get length() {
+        return this.offset;
+    }
+    /** Reset the buffer for reuse, releasing the old ArrayBuffer. */
+    reset() {
+        this.buffer = new ArrayBuffer(INITIAL_SIZE);
+        this.view = new DataView(this.buffer);
+        this.bytes = new Uint8Array(this.buffer);
+        this.offset = 0;
+    }
+    // -- Private helpers ------------------------------------------------------
+    writeStructuralCommand(cmd, nodeId, node) {
+        const v = node;
+        if (typeof v.raw === "string") {
+            const encoded = encoder.encode(v.raw);
+            this.ensureCapacity(10 + encoded.length); // 1(cmd) + 4(nodeId) + 1(payloadType) + 4(len) + payload
+            this.writeU8(cmd);
+            this.writeU32(nodeId);
+            this.writeU8(PAYLOAD_RAW_MARKDOWN);
+            this.writeU32(encoded.length);
+            this.writeBytes(encoded);
+        }
+        else if (typeof v.rawHtml === "string") {
+            const encoded = encoder.encode(v.rawHtml);
+            this.ensureCapacity(10 + encoded.length);
+            this.writeU8(cmd);
+            this.writeU32(nodeId);
+            this.writeU8(PAYLOAD_RAW_HTML);
+            this.writeU32(encoded.length);
+            this.writeBytes(encoded);
+        }
+        else {
+            // Structured node — serialize as JSON
+            const json = JSON.stringify(node);
+            const encoded = encoder.encode(json);
+            this.ensureCapacity(10 + encoded.length);
+            this.writeU8(cmd);
+            this.writeU32(nodeId);
+            this.writeU8(PAYLOAD_SERDE_JSON);
+            this.writeU32(encoded.length);
+            this.writeBytes(encoded);
+        }
+    }
+    ensureCapacity(needed) {
+        while (this.offset + needed > this.buffer.byteLength) {
+            this.grow();
+        }
+    }
+    grow() {
+        const newBuffer = new ArrayBuffer(this.buffer.byteLength * 2);
+        new Uint8Array(newBuffer).set(this.bytes);
+        this.buffer = newBuffer;
+        this.view = new DataView(this.buffer);
+        this.bytes = new Uint8Array(this.buffer);
+    }
+    writeU8(val) {
+        this.view.setUint8(this.offset, val);
+        this.offset += 1;
+    }
+    writeU32(val) {
+        this.view.setUint32(this.offset, val, true);
+        this.offset += 4;
+    }
+    writeBytes(data) {
+        this.bytes.set(data, this.offset);
+        this.offset += data.length;
+    }
+}
+//# sourceMappingURL=command-buffer.js.map

package/dist/command-buffer.js.map

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

package/dist/compile.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Top-level compile functions — the primary public API.
+ *
+ * Both MDAST and HAST arenas stay in Rust memory via opaque handles.
+ * Only matched nodes and mutation commands cross the NAPI boundary.
+ */
+import type { MdastPluginDefinition, HastPluginDefinition } from "./plugin.js";
+/** Configuration for static subtree collapsing during MDX compilation. */
+export interface OptimizeStaticConfig {
+    component: string;
+    prop: string;
+    wrapPropValue?: boolean;
+    ignoreElements?: string[];
+}
+export interface CompileOptions {
+    mdastPlugins?: MdastPluginDefinition[];
+    hastPlugins?: HastPluginDefinition[];
+    optimizeStatic?: OptimizeStaticConfig;
+    filename?: string;
+}
+export declare function compileMarkdownToHtml(source: string, options?: CompileOptions): string | Promise<string>;
+export declare function compileMdxToJs(source: string, options?: CompileOptions): string | Promise<string>;

package/dist/compile.js

@@ -0,0 +1,144 @@
+/**
+ * Top-level compile functions — the primary public API.
+ *
+ * Both MDAST and HAST arenas stay in Rust memory via opaque handles.
+ * Only matched nodes and mutation commands cross the NAPI boundary.
+ */
+import { visitHastHandle, resolveSubscriptions } from "./hast/hast-visitor.js";
+import { visitMdastHandle, resolveMdastSubscriptions, } from "./mdast/mdast-visitor.js";
+import { parseToHtml, compileMdx, createHastHandle, createMdxHastHandle, renderHandle, compileHandle, applyCommandsToHandle, dropHandle, createMdastHandle, createMdxMdastHandle, applyCommandsToMdastHandle, convertMdastToHastHandle, applyCommandsAndConvertToHastHandle, getHandleSource, } from "../index.js";
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function initPlugins(plugins) {
+    return plugins.map((def) => ({
+        instance: def.createOnce(),
+        name: def.name,
+    }));
+}
+function runMdastPluginsOnHandle(handle, plugins, filename) {
+    const instances = initPlugins(plugins);
+    let pendingCommands = null;
+    const source = getHandleSource(handle);
+    let i = 0;
+    const runNext = () => {
+        while (i < instances.length) {
+            const idx = i++;
+            const { instance } = instances[idx];
+            const subs = resolveMdastSubscriptions(instance);
+            const result = visitMdastHandle(handle, instance, subs, source, filename);
+            if (result instanceof Promise) {
+                return result.then((r) => {
+                    applyMdastResult(r, idx, instances.length, handle);
+                    return runNext();
+                });
+            }
+            applyMdastResult(result, idx, instances.length, handle);
+        }
+        return { handle, pendingCommands };
+    };
+    function applyMdastResult(result, idx, total, h) {
+        if (result.hasMutations) {
+            if (idx === total - 1) {
+                pendingCommands = result.commandBuffer;
+            }
+            else {
+                applyCommandsToMdastHandle(h, result.commandBuffer);
+            }
+        }
+    }
+    return runNext();
+}
+// ---------------------------------------------------------------------------
+// HAST plugin runner (handle-based)
+// ---------------------------------------------------------------------------
+function runHastPluginsOnHandle(handle, plugins, source, filename) {
+    if (plugins.length === 0)
+        return;
+    const instances = initPlugins(plugins);
+    let i = 0;
+    const runNext = () => {
+        while (i < instances.length) {
+            const { instance } = instances[i];
+            i++;
+            const subs = resolveSubscriptions(instance);
+            const result = visitHastHandle(handle, instance, subs, source, filename);
+            if (result instanceof Promise) {
+                return result.then(runNext);
+            }
+        }
+    };
+    return runNext();
+}
+export function compileMarkdownToHtml(source, options = {}) {
+    const { mdastPlugins = [], hastPlugins = [], filename = "<unknown>" } = options;
+    if (mdastPlugins.length === 0 && hastPlugins.length === 0) {
+        return parseToHtml(source);
+    }
+    const handleResult = createHastHandleFromMdast(source, mdastPlugins, false, filename);
+    const finish = (hastHandle) => {
+        const asyncResult = runHastPluginsOnHandle(hastHandle, hastPlugins, source, filename);
+        if (asyncResult instanceof Promise) {
+            return asyncResult.then(() => {
+                const html = renderHandle(hastHandle);
+                dropHandle(hastHandle);
+                return html;
+            });
+        }
+        const html = renderHandle(hastHandle);
+        dropHandle(hastHandle);
+        return html;
+    };
+    if (handleResult instanceof Promise) {
+        return handleResult.then(finish);
+    }
+    return finish(handleResult);
+}
+export function compileMdxToJs(source, options = {}) {
+    const { mdastPlugins = [], hastPlugins = [], optimizeStatic, filename = "<unknown>" } = options;
+    const mdxOptions = optimizeStatic ? { optimizeStatic } : undefined;
+    if (mdastPlugins.length === 0 && hastPlugins.length === 0) {
+        return compileMdx(source, mdxOptions);
+    }
+    const handleResult = createHastHandleFromMdast(source, mdastPlugins, true, filename);
+    const finish = (hastHandle) => {
+        const asyncResult = runHastPluginsOnHandle(hastHandle, hastPlugins, source, filename);
+        if (asyncResult instanceof Promise) {
+            return asyncResult.then(() => {
+                const js = compileHandle(hastHandle, mdxOptions);
+                dropHandle(hastHandle);
+                return js;
+            });
+        }
+        const js = compileHandle(hastHandle, mdxOptions);
+        dropHandle(hastHandle);
+        return js;
+    };
+    if (handleResult instanceof Promise) {
+        return handleResult.then(finish);
+    }
+    return finish(handleResult);
+}
+// ---------------------------------------------------------------------------
+// Pipeline: parse → mdast plugins → hast conversion → hast plugins
+// All arenas stay in Rust. No intermediate buffer copies to JS.
+// ---------------------------------------------------------------------------
+/** Parse + mdast plugins + convert to HAST handle. */
+function createHastHandleFromMdast(source, mdastPlugins, mdx, filename) {
+    if (mdastPlugins.length === 0) {
+        return mdx ? createMdxHastHandle(source) : createHastHandle(source);
+    }
+    const mdastHandle = mdx ? createMdxMdastHandle(source) : createMdastHandle(source);
+    const mdastResult = runMdastPluginsOnHandle(mdastHandle, mdastPlugins, filename);
+    const convert = (r) => {
+        if (r.pendingCommands) {
+            return applyCommandsAndConvertToHastHandle(r.handle, r.pendingCommands);
+        }
+        return convertMdastToHastHandle(r.handle);
+    };
+    if (mdastResult instanceof Promise) {
+        return mdastResult.then(convert);
+    }
+    return convert(mdastResult);
+}
+//# sourceMappingURL=compile.js.map

package/dist/compile.js.map

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

package/dist/data-map.d.ts

@@ -0,0 +1,10 @@
+export declare class DataMap {
+    #private;
+    get(nodeId: number): Record<string, unknown> | null;
+    set(nodeId: number, value: Record<string, unknown>): void;
+    merge(nodeId: number, value: Record<string, unknown>): void;
+    has(nodeId: number): boolean;
+    delete(nodeId: number): void;
+    clear(): void;
+    get size(): number;
+}

package/dist/data-map.js

@@ -0,0 +1,26 @@
+export class DataMap {
+    #map = new Map();
+    get(nodeId) {
+        return this.#map.get(nodeId) ?? null;
+    }
+    set(nodeId, value) {
+        this.#map.set(nodeId, value);
+    }
+    merge(nodeId, value) {
+        const existing = this.#map.get(nodeId);
+        this.#map.set(nodeId, existing ? { ...existing, ...value } : { ...value });
+    }
+    has(nodeId) {
+        return this.#map.has(nodeId);
+    }
+    delete(nodeId) {
+        this.#map.delete(nodeId);
+    }
+    clear() {
+        this.#map.clear();
+    }
+    get size() {
+        return this.#map.size;
+    }
+}
+//# sourceMappingURL=data-map.js.map

package/dist/data-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-map.js","sourceRoot":"","sources":["../src/data-map.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,OAAO;IACT,IAAI,GAAG,IAAI,GAAG,EAAmC,CAAC;IAE3D,GAAG,CAAC,MAAc;QAChB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC;IACvC,CAAC;IAED,GAAG,CAAC,MAAc,EAAE,KAA8B;QAChD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,MAAc,EAAE,KAA8B;QAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED,GAAG,CAAC,MAAc;QAChB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM,CAAC,MAAc;QACnB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;IAED,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IACxB,CAAC;CACF"}

package/dist/hast/hast-materializer.d.ts

@@ -0,0 +1,11 @@
+import { HastReader } from "./hast-reader.js";
+import type { HastNode } from "../types.js";
+export type { HastNode };
+/**
+ * Materialize a single HAST node from a binary buffer as a lazy JS object.
+ */
+export declare function materializeHastNode(reader: HastReader, nodeId: number): HastNode;
+/**
+ * Materialize the full HAST tree from root (nodeId=0).
+ */
+export declare function materializeHastTree(reader: HastReader): HastNode;