satteri 0.1.0

package/dist/pipeline.js

@@ -0,0 +1,87 @@
+import { visitMdast } from "./mdast/mdast-visitor.js";
+import { DataMap } from "./data-map.js";
+import { MdastReader } from "./mdast/mdast-reader.js";
+import { materializeNode } from "./mdast/mdast-materializer.js";
+// applyMutations is the NAPI function that takes an arena buffer + command
+// buffer and returns a new arena buffer with all mutations applied.
+import { applyMutations } from "../index.js";
+export class ProcessorContext {
+    #diagnostics = [];
+    report(diagnostic) {
+        this.#diagnostics.push(diagnostic);
+    }
+    getDiagnostics() {
+        return [...this.#diagnostics];
+    }
+}
+/**
+ * Process one arena buffer through an ordered list of initialized plugin instances.
+ */
+export function runPluginsOnBuffer(buffer, pluginInstances, { filename = "<unknown>", dataMap, deferLast = false, } = {}) {
+    const dm = dataMap ?? new DataMap();
+    const allMdastDiagnostics = [];
+    let totalMutations = 0;
+    let structuralMutations = 0;
+    let currentBuffer = buffer;
+    for (let i = 0; i < pluginInstances.length; i++) {
+        const { instance } = pluginInstances[i];
+        const reader = new MdastReader(currentBuffer);
+        const fileContext = {
+            source: reader.getSource(),
+            filename,
+            get root() {
+                return materializeNode(reader, 0, dm);
+            },
+        };
+        const wrappedPlugin = wrapInstance(instance, fileContext);
+        const result = visitMdast(reader, wrappedPlugin, dm);
+        allMdastDiagnostics.push(...result.diagnostics);
+        if (result.hasMutations) {
+            totalMutations += 1;
+            structuralMutations += 1;
+            if (deferLast && i === pluginInstances.length - 1) {
+                // Last plugin — defer mutations for fusion with the next pipeline step
+                return {
+                    buffer: currentBuffer,
+                    pendingCommands: result.commandBuffer,
+                    dataMap: dm,
+                    diagnostics: allMdastDiagnostics,
+                    mutationCount: totalMutations,
+                    structuralMutationCount: structuralMutations,
+                };
+            }
+            const arenaBuf = currentBuffer instanceof Uint8Array ? currentBuffer : new Uint8Array(currentBuffer);
+            currentBuffer = applyMutations(arenaBuf, result.commandBuffer);
+        }
+    }
+    return {
+        buffer: currentBuffer,
+        pendingCommands: null,
+        dataMap: dm,
+        diagnostics: allMdastDiagnostics,
+        mutationCount: totalMutations,
+        structuralMutationCount: structuralMutations,
+    };
+}
+function wrapInstance(instance, fileContext) {
+    const wrapped = {};
+    for (const [key, val] of Object.entries(instance)) {
+        if (key !== "before" && key !== "after" && key !== "transformRoot") {
+            if (typeof val === "function") {
+                wrapped[key] = val;
+            }
+        }
+    }
+    const inst = instance;
+    if (typeof inst.before === "function") {
+        wrapped.before = (visitorContext) => inst.before(fileContext, visitorContext);
+    }
+    if (typeof inst.after === "function") {
+        wrapped.after = (visitorContext) => inst.after(fileContext, visitorContext);
+    }
+    if (typeof inst.transformRoot === "function") {
+        wrapped.transformRoot = (root, visitorContext) => inst.transformRoot(root, fileContext, visitorContext);
+    }
+    return wrapped;
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../src/pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAKhE,2EAA2E;AAC3E,oEAAoE;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,OAAO,gBAAgB;IAClB,YAAY,GAAsB,EAAE,CAAC;IAE9C,MAAM,CAAC,UAA2B;QAChC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACrC,CAAC;IAED,cAAc;QACZ,OAAO,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC;IAChC,CAAC;CACF;AAkBD;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAgC,EAChC,eAA8F,EAC9F,EACE,QAAQ,GAAG,WAAW,EACtB,OAAO,EACP,SAAS,GAAG,KAAK,MACgD,EAAE;IAErE,MAAM,EAAE,GAAG,OAAO,IAAI,IAAI,OAAO,EAAE,CAAC;IACpC,MAAM,mBAAmB,GAAsB,EAAE,CAAC;IAClD,IAAI,cAAc,GAAG,CAAC,CAAC;IACvB,IAAI,mBAAmB,GAAG,CAAC,CAAC;IAC5B,IAAI,aAAa,GAAG,MAAM,CAAC;IAE3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,eAAe,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAChD,MAAM,EAAE,QAAQ,EAAE,GAAG,eAAe,CAAC,CAAC,CAAE,CAAC;QACzC,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,aAAa,CAAC,CAAC;QAE9C,MAAM,WAAW,GAAgB;YAC/B,MAAM,EAAE,MAAM,CAAC,SAAS,EAAE;YAC1B,QAAQ;YACR,IAAI,IAAI;gBACN,OAAO,eAAe,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YACxC,CAAC;SACF,CAAC;QAEF,MAAM,aAAa,GAAG,YAAY,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QAC1D,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,EAAE,aAAa,EAAE,EAAE,CAAC,CAAC;QACrD,mBAAmB,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;QAEhD,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;YACxB,cAAc,IAAI,CAAC,CAAC;YACpB,mBAAmB,IAAI,CAAC,CAAC;YAEzB,IAAI,SAAS,IAAI,CAAC,KAAK,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAClD,uEAAuE;gBACvE,OAAO;oBACL,MAAM,EAAE,aAAa;oBACrB,eAAe,EAAE,MAAM,CAAC,aAAa;oBACrC,OAAO,EAAE,EAAE;oBACX,WAAW,EAAE,mBAAmB;oBAChC,aAAa,EAAE,cAAc;oBAC7B,uBAAuB,EAAE,mBAAmB;iBAC7C,CAAC;YACJ,CAAC;YAED,MAAM,QAAQ,GACZ,aAAa,YAAY,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,aAAa,CAAC,CAAC;YACtF,aAAa,GAAG,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IAED,OAAO;QACL,MAAM,EAAE,aAAa;QACrB,eAAe,EAAE,IAAI;QACrB,OAAO,EAAE,EAAE;QACX,WAAW,EAAE,mBAAmB;QAChC,aAAa,EAAE,cAAc;QAC7B,uBAAuB,EAAE,mBAAmB;KAC7C,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CACnB,QAAyD,EACzD,WAAwB;IAExB,MAAM,OAAO,GAA4B,EAAE,CAAC;IAE5C,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAmC,CAAC,EAAE,CAAC;QAC7E,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,eAAe,EAAE,CAAC;YACnE,IAAI,OAAO,GAAG,KAAK,UAAU,EAAE,CAAC;gBAC9B,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;YACrB,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAG,QAAmC,CAAC;IACjD,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QACtC,OAAO,CAAC,MAAM,GAAG,CAAC,cAAuB,EAAE,EAAE,CAC1C,IAAI,CAAC,MAAoD,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IAC5F,CAAC;IACD,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;QACrC,OAAO,CAAC,KAAK,GAAG,CAAC,cAAuB,EAAE,EAAE,CACzC,IAAI,CAAC,KAAmD,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IAC3F,CAAC;IACD,IAAI,OAAO,IAAI,CAAC,aAAa,KAAK,UAAU,EAAE,CAAC;QAC7C,OAAO,CAAC,aAAa,GAAG,CAAC,IAAe,EAAE,cAAuB,EAAE,EAAE,CAClE,IAAI,CAAC,aAAyE,CAC7E,IAAI,EACJ,WAAW,EACX,cAAc,CACf,CAAC;IACN,CAAC;IAED,OAAO,OAA0D,CAAC;AACpE,CAAC"}

package/dist/plugin.d.ts

@@ -0,0 +1,12 @@
+import type { MdastPluginInstance } from "./mdast/mdast-visitor.js";
+import type { HastVisitorInstance } from "./hast/hast-visitor.js";
+export interface MdastPluginDefinition {
+    name: string;
+    createOnce(): MdastPluginInstance;
+}
+export interface HastPluginDefinition {
+    name: string;
+    createOnce(): HastVisitorInstance;
+}
+export declare function defineMdastPlugin(definition: MdastPluginDefinition): MdastPluginDefinition;
+export declare function defineHastPlugin(definition: HastPluginDefinition): HastPluginDefinition;

package/dist/plugin.js

@@ -0,0 +1,19 @@
+export function defineMdastPlugin(definition) {
+    if (!definition.name) {
+        throw new Error("Plugin definition must have a name");
+    }
+    if (typeof definition.createOnce !== "function") {
+        throw new Error("Plugin definition must have a createOnce function");
+    }
+    return definition;
+}
+export function defineHastPlugin(definition) {
+    if (!definition.name) {
+        throw new Error("Plugin definition must have a name");
+    }
+    if (typeof definition.createOnce !== "function") {
+        throw new Error("Plugin definition must have a createOnce function");
+    }
+    return definition;
+}
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAaA,MAAM,UAAU,iBAAiB,CAAC,UAAiC;IACjE,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACxD,CAAC;IACD,IAAI,OAAO,UAAU,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,UAAgC;IAC/D,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACxD,CAAC;IACD,IAAI,OAAO,UAAU,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/processor.d.ts

@@ -0,0 +1,33 @@
+import { ProcessorContext } from "./pipeline.js";
+import { DataMap } from "./data-map.js";
+import type { MdastPluginDefinition } from "./plugin.js";
+import type { MdastNode } from "./types.js";
+import type { MdastDiagnostic } from "./mdast/mdast-visitor.js";
+export { ProcessorContext };
+interface ProcessBufferResult {
+    buffer: ArrayBuffer | Uint8Array;
+    dataMap: DataMap;
+    diagnostics: MdastDiagnostic[];
+    mutationCount: number;
+    structuralMutationCount: number;
+}
+interface ProcessTreeResult {
+    tree: MdastNode;
+    dataMap: DataMap;
+    diagnostics: MdastDiagnostic[];
+    mutationCount: number;
+}
+export declare function createProcessor({ plugins, }?: {
+    plugins?: MdastPluginDefinition[];
+}): Processor;
+declare class Processor {
+    #private;
+    constructor(pluginDefs: MdastPluginDefinition[]);
+    processBuffer(buffer: ArrayBuffer | Uint8Array, options?: {
+        filename?: string;
+    }): ProcessBufferResult;
+    processBufferToTree(buffer: ArrayBuffer | Uint8Array, options?: {
+        filename?: string;
+    }): ProcessTreeResult;
+    getDiagnostics(): MdastDiagnostic[];
+}

package/dist/processor.js

@@ -0,0 +1,49 @@
+import { ProcessorContext, runPluginsOnBuffer } from "./pipeline.js";
+import { MdastReader } from "./mdast/mdast-reader.js";
+import { materializeTree } from "./mdast/mdast-materializer.js";
+import { DataMap } from "./data-map.js";
+export { ProcessorContext };
+export function createProcessor({ plugins = [], } = {}) {
+    return new Processor(plugins);
+}
+class Processor {
+    #pluginDefs;
+    #processorCtx;
+    #initializedPlugins = null;
+    constructor(pluginDefs) {
+        for (const def of pluginDefs) {
+            if (!def.name || typeof def.createOnce !== "function") {
+                throw new Error(`Invalid plugin: ${JSON.stringify(def.name)}`);
+            }
+        }
+        this.#pluginDefs = pluginDefs;
+        this.#processorCtx = new ProcessorContext();
+    }
+    #getPluginInstances() {
+        if (this.#initializedPlugins === null) {
+            this.#initializedPlugins = this.#pluginDefs.map((def) => ({
+                instance: def.createOnce(this.#processorCtx),
+                name: def.name,
+            }));
+        }
+        return this.#initializedPlugins;
+    }
+    processBuffer(buffer, options = {}) {
+        return runPluginsOnBuffer(buffer, this.#getPluginInstances(), options);
+    }
+    processBufferToTree(buffer, options = {}) {
+        const result = this.processBuffer(buffer, options);
+        const reader = new MdastReader(result.buffer);
+        const tree = materializeTree(reader, result.dataMap);
+        return {
+            tree,
+            dataMap: result.dataMap,
+            diagnostics: result.diagnostics,
+            mutationCount: result.mutationCount,
+        };
+    }
+    getDiagnostics() {
+        return this.#processorCtx.getDiagnostics();
+    }
+}
+//# sourceMappingURL=processor.js.map

package/dist/processor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"processor.js","sourceRoot":"","sources":["../src/processor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAKxC,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAiB5B,MAAM,UAAU,eAAe,CAAC,EAC9B,OAAO,GAAG,EAAE,MAC6B,EAAE;IAC3C,OAAO,IAAI,SAAS,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,SAAS;IACJ,WAAW,CAA0B;IACrC,aAAa,CAAmB;IACzC,mBAAmB,GAER,IAAI,CAAC;IAEhB,YAAY,UAAmC;QAC7C,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;YAC7B,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,GAAG,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;gBACtD,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjE,CAAC;QACH,CAAC;QACD,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;QAC9B,IAAI,CAAC,aAAa,GAAG,IAAI,gBAAgB,EAAE,CAAC;IAC9C,CAAC;IAED,mBAAmB;QAIjB,IAAI,IAAI,CAAC,mBAAmB,KAAK,IAAI,EAAE,CAAC;YACtC,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBACxD,QAAQ,EAAE,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,aAAa,CAAC;gBAC5C,IAAI,EAAE,GAAG,CAAC,IAAI;aACf,CAAC,CAAC,CAAC;QACN,CAAC;QACD,OAAO,IAAI,CAAC,mBAAmB,CAAC;IAClC,CAAC;IAED,aAAa,CACX,MAAgC,EAChC,UAAiC,EAAE;QAEnC,OAAO,kBAAkB,CAAC,MAAM,EAAE,IAAI,CAAC,mBAAmB,EAAE,EAAE,OAAO,CAAC,CAAC;IACzE,CAAC;IAED,mBAAmB,CACjB,MAAgC,EAChC,UAAiC,EAAE;QAEnC,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC9C,MAAM,IAAI,GAAG,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QACrD,OAAO;YACL,IAAI;YACJ,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,aAAa,EAAE,MAAM,CAAC,aAAa;SACpC,CAAC;IACJ,CAAC;IAED,cAAc;QACZ,OAAO,IAAI,CAAC,aAAa,CAAC,cAAc,EAAE,CAAC;IAC7C,CAAC;CACF"}

package/dist/types.d.ts

@@ -0,0 +1,86 @@
+import type { Position } from "unist";
+import type { Literal as MdastLiteral, Nodes as MdastStdNodes } from "mdast";
+import type { Nodes as HastStdNodes } from "hast";
+export type { Position, Point } from "unist";
+export type { MdxJsxFlowElement, MdxJsxTextElement, MdxJsxAttribute as MdxJsxAttributeNode, MdxJsxExpressionAttribute as MdxJsxExpressionAttributeNode, MdxJsxAttributeValueExpression as MdxJsxAttributeValueExpressionNode, } from "mdast-util-mdx-jsx";
+export type { MdxFlowExpression, MdxTextExpression } from "mdast-util-mdx-expression";
+export type { MdxjsEsm } from "mdast-util-mdxjs-esm";
+import type { MdxJsxAttribute, MdxJsxExpressionAttribute } from "mdast-util-mdx-jsx";
+export type MdxJsxAttributeUnion = MdxJsxAttribute | MdxJsxExpressionAttribute;
+export interface Toml extends MdastLiteral {
+    type: "toml";
+}
+export interface MathNode extends MdastLiteral {
+    type: "math";
+    meta?: string | null | undefined;
+}
+export interface InlineMath extends MdastLiteral {
+    type: "inlineMath";
+}
+declare module "mdast" {
+    interface FrontmatterContentMap {
+        toml: Toml;
+    }
+    interface RootContentMap {
+        toml: Toml;
+        math: MathNode;
+        inlineMath: InlineMath;
+    }
+    interface PhrasingContentMap {
+        inlineMath: InlineMath;
+    }
+    interface BlockContentMap {
+        math: MathNode;
+    }
+}
+export interface HastRaw {
+    type: "raw";
+    value: string;
+}
+declare module "hast" {
+    interface RootContentMap {
+        raw: HastRaw;
+    }
+    interface ElementContentMap {
+        raw: HastRaw;
+    }
+}
+/**
+ * Materialized mdast node — a standard `mdast.Nodes` discriminated union.
+ * Narrow by `node.type` to access type-specific properties
+ * (e.g. `depth` on `"heading"`, `url` on `"link"`).
+ */
+export type MdastNode = MdastStdNodes;
+/**
+ * Materialized hast node — a standard `hast.Nodes` discriminated union.
+ * Narrow by `node.type` to access type-specific properties
+ * (e.g. `tagName` on `"element"`, `value` on `"text"`).
+ */
+export type HastNode = HastStdNodes;
+export interface StringRefRaw {
+    offset: number;
+    len: number;
+}
+export interface MdastNodeRaw {
+    id: number;
+    type: number;
+    typeName: string;
+    parent: number;
+    position: Position;
+    childrenStart: number;
+    childrenCount: number;
+    dataOffset: number;
+    dataLen: number;
+}
+export interface BufferHeader {
+    version: number;
+    nodeStructSize: number;
+    nodeCount: number;
+    nodesOffset: number;
+    childrenCount: number;
+    childrenOffset: number;
+    typeDataLen: number;
+    typeDataOffset: number;
+    sourceLen: number;
+    sourceOffset: number;
+}

package/dist/types.js

@@ -0,0 +1,6 @@
+// Shared types for the satteri JS layer.
+//
+// Uses standard @types/mdast, @types/hast, and mdast-util-mdx-* packages
+// for AST node types. Extension types (toml, math, raw) are augmented here.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,yEAAyE;AACzE,4EAA4E"}

package/index.d.ts

@@ -0,0 +1,109 @@
+/* auto-generated by NAPI-RS */
+/* eslint-disable */
+/**
+ * Apply MDAST commands and convert to HAST handle in one step.
+ * The MDAST handle is consumed (emptied).
+ */
+export declare function applyCommandsAndConvertToHastHandle(handle: ArenaHandle, commandBuf: Uint8Array): ArenaHandle
+
+/** Apply a command buffer to a handle's arena in-place. No serialize/deserialize. */
+export declare function applyCommandsToHandle(handle: ArenaHandle, commandBuf: Uint8Array): void
+
+/** Apply a command buffer to an MDAST handle in-place. */
+export declare function applyCommandsToMdastHandle(handle: ArenaHandle, commandBuf: Uint8Array): void
+
+/** Compile a handle's HAST arena to MDX JavaScript. Does not consume the handle. */
+export declare function compileHandle(handle: ArenaHandle, options?: JsMdxOptions | undefined | null): string
+
+/** Compile MDX source directly to JavaScript. */
+export declare function compileMdx(source: string, options?: JsMdxOptions | undefined | null): string
+
+/** Convert an MDAST handle to a HAST handle. The MDAST handle is consumed (emptied). */
+export declare function convertMdastToHastHandle(handle: ArenaHandle): ArenaHandle
+
+/**
+ * Parse markdown source and convert to HAST. Returns an opaque handle.
+ * The arena stays in Rust memory — no buffer is copied to JS.
+ */
+export declare function createHastHandle(source: string): ArenaHandle
+
+/** Parse markdown source into an MDAST arena handle. */
+export declare function createMdastHandle(source: string): ArenaHandle
+
+/** Parse MDX source and convert to HAST. Returns an opaque handle. */
+export declare function createMdxHastHandle(source: string): ArenaHandle
+
+/** Parse MDX source into an MDAST arena handle. */
+export declare function createMdxMdastHandle(source: string): ArenaHandle
+
+/**
+ * Release the arena memory held by a handle. The handle becomes empty
+ * but remains valid (subsequent calls are no-ops or return empty results).
+ */
+export declare function dropHandle(handle: ArenaHandle): void
+
+/** Get the source string from an MDAST handle. */
+export declare function getHandleSource(handle: ArenaHandle): string
+
+/** Read the node_data JSON blob for a node. Returns null if none is set. */
+export declare function getNodeData(handle: ArenaHandle, nodeId: number): string | null
+
+/** MDX compile options passed from JavaScript. */
+export interface JsMdxOptions {
+  /**
+   * Static subtree optimization. If provided, static subtrees are collapsed
+   * into raw HTML strings using the specified component and prop.
+   */
+  optimizeStatic?: JsOptimizeStaticConfig
+}
+
+/** Static optimization config passed from JavaScript. */
+export interface JsOptimizeStaticConfig {
+  /** Component/element name to wrap collapsed HTML in (e.g. "Fragment", "div"). */
+  component: string
+  /** Prop name for the HTML string (e.g. "set:html", "dangerouslySetInnerHTML"). */
+  prop: string
+  /** If true, prop value is wrapped as `{ __html: "..." }` (React-style). */
+  wrapPropValue?: boolean
+  /** Element tag names to exclude from collapsing. */
+  ignoreElements?: Array<string>
+}
+
+/** A subscription passed from JS. */
+export interface JsSubscription {
+  nodeType: number
+  tagFilter: Array<string>
+}
+
+/**
+ * Parse a JavaScript expression and return its ESTree-compatible AST as a JSON string.
+ * Returns null if parsing fails. The JS layer calls JSON.parse (faster than serde_json → NAPI).
+ */
+export declare function parseExpression(source: string): string | null
+
+/** Parse Markdown source and return HTML string directly. */
+export declare function parseToHtml(source: string): string
+
+/** Render a handle's HAST arena to HTML. Does not consume the handle. */
+export declare function renderHandle(handle: ArenaHandle): string
+
+/** Serialize a handle's arena to a binary buffer (for fallback paths like transformRoot). */
+export declare function serializeHandle(handle: ArenaHandle): Uint8Array
+
+/** Serialize an MDAST handle to a binary buffer (read-only snapshot for JS visitor). */
+export declare function serializeMdastHandle(handle: ArenaHandle): Uint8Array
+
+/** Set the `data` blob (JSON bytes) for a node in the handle's arena. */
+export declare function setNodeData(handle: ArenaHandle, nodeId: number, json: Uint8Array): void
+
+/**
+ * Collect the concatenated text content of a node and all its descendants.
+ * Walks entirely in Rust — no per-child NAPI round-trips.
+ */
+export declare function textContentHandle(handle: ArenaHandle, nodeId: number): string
+
+/** Walk a handle's arena and return matched nodes as a flat binary buffer. */
+export declare function walkHandle(handle: ArenaHandle, subscriptions: Array<JsSubscription>): Uint8Array
+
+/** Walk an MDAST handle's arena and return matched nodes as a flat binary buffer. */
+export declare function walkMdastHandle(handle: ArenaHandle, subscriptions: Array<JsSubscription>): Uint8Array