satteri 0.1.1 → 0.1.3

package/README.md

@@ -1,7 +1,301 @@
 # satteri
 
-TypeScript layer with readers, visitors, materializers, and plugin system for Sätteri, a high-performance Markdown and MDX processor.
+Native-enhanced Markdown parsing and processing for JavaScript. Parse and compile in Rust, create flexible plugins in JavaScript.
 
-> [!NOTE]
-> **Work in progress** — this package is under active development.
-> See the [Contributing Guide](../../CONTRIBUTING.md) if you want to get involved!
+## Install
+
+```sh
+npm install satteri
+yarn add satteri
+pnpm add satteri
+```
+
+## Usage
+
+### Markdown to HTML
+
+```ts
+import { markdownToHtml } from "satteri";
+
+const html = markdownToHtml("# Hello\n\nWorld");
+// <h1>Hello</h1>\n<p>World</p>
+```
+
+### MDX to JS
+
+```ts
+import { mdxToJs } from "satteri";
+
+const js = mdxToJs("# Hello\n\n<MyComponent />");
+```
+
+### With plugins
+
+Both functions accept `mdastPlugins` (operate on the Markdown AST before conversion to HAST) and `hastPlugins` (operate on the HAST before output).
+
+```ts
+import { markdownToHtml } from "satteri";
+import { removeHeadings } from "./my-mdast-plugins.js";
+import { addLinkClasses } from "./my-hast-plugins.js";
+
+const html = markdownToHtml("# Hello\n\n[link](https://example.com)", {
+  mdastPlugins: [removeHeadings],
+  hastPlugins: [addLinkClasses],
+});
+```
+
+If you're familiar with the unified ecosystem, mdast and hast plugins would be similar to remark and rehype plugins, respectively, and re-uses the same AST shape for both. This project does not currently have an equivalent of micromark or recma plugins.
+
+## Plugins
+
+### MDAST plugins
+
+MDAST plugins run on the Markdown syntax tree, allowing you to do things like replace emoji shortcodes, unwrap images from paragraphs, or collect headings for a table of contents before Markdown is transformed to HTML / JS. Define visitor methods named after node types (`heading`, `code`, `link`, `image`, etc.). Each visitor receives the node and a context object for mutations.
+
+```ts
+const emojis = defineMdastPlugin({
+  name: "emojis",
+  text(node, ctx) {
+    if (node.value.includes(":wave:")) {
+      ctx.setProperty(node, "value", node.value.replaceAll(":wave:", "\u{1F44B}"));
+    }
+  },
+});
+```
+
+Visitors can alternatively return a replacement node, raw Markdown, or raw HTML. This is useful when the replacement can't be expressed as property changes on the original node:
+
+```ts
+const highlightCode = defineMdastPlugin({
+  name: "highlight-code",
+  code(node) {
+    return { rawHtml: `<pre class="highlighted">${escape(node.value)}</pre>` };
+  },
+});
+```
+
+All standard mdast node types are supported, plus GFM extensions (`table`, `tableRow`, `tableCell`, `delete`, `footnoteDefinition`, `footnoteReference`) and MDX nodes (`mdxJsxFlowElement`, `mdxJsxTextElement`, `mdxFlowExpression`, `mdxTextExpression`, `mdxjsEsm`) if enabled. For more information on the AST shape and node types, see the [mdast spec](https://github.com/syntax-tree/mdast).
+
+### HAST plugins
+
+HAST plugins run on the HTML syntax tree after mdast-to-hast conversion, allowing you to do things like add classes to elements, set attributes on links, or wrap HTML elements with other elements, etc. Element visitors use a `filter` array to specify which tag names (or component names for MDX) to match.
+
+```ts
+const addLinkClasses = defineHastPlugin({
+  name: "add-link-classes",
+  element: {
+    filter: ["a"],
+    visit(node, ctx) {
+      ctx.setProperty(node, "class", "link");
+      ctx.setProperty(node, "target", "_blank");
+    },
+  },
+});
+```
+
+Multiple filter groups on the same node type:
+
+```ts
+const multiFilter = defineHastPlugin({
+  name: "multi-filter",
+  element: [
+    {
+      filter: ["h1", "h2", "h3"],
+      visit(node, ctx) {
+        ctx.setProperty(node, "class", "heading");
+      },
+    },
+    {
+      filter: ["a"],
+      visit(node, ctx) {
+        ctx.setProperty(node, "target", "_blank");
+      },
+    },
+  ],
+});
+```
+
+An empty filter matches all elements, but can quickly become expensive when used on large documents, so use with caution:
+
+```ts
+const allElements = defineHastPlugin({
+  name: "all-elements",
+  element: {
+    filter: [],
+    visit(node, ctx) {
+      ctx.setProperty(node, "data-visited", "true");
+    },
+  },
+});
+```
+
+Non-element visitors (`text`, `comment`, `raw`, `doctype`, MDX expression types) use bare functions instead of filter objects:
+
+```ts
+const uppercaseText = defineHastPlugin({
+  name: "uppercase-text",
+  text(node, ctx) {
+    ctx.setProperty(node, "value", node.value.toUpperCase());
+  },
+});
+```
+
+For more information on the AST shape and node types, see the [hast spec](https://github.com/syntax-tree/hast).
+
+### Mutating nodes
+
+Unlike remark and rehype plugins, nodes in Sätteri inside plugins are read-only. The AST lives in Rust memory and JavaScript only has a "view" over the different nodes, so direct mutations like `node.value = "new text"` have no effect. Use the context methods (`ctx.setProperty`, `ctx.removeNode`, `ctx.replaceNode`, etc.) instead, which send changes back to Rust in an efficient way.
+
+```ts
+// Won't work
+heading(node, ctx) {
+  node.depth = 2; // no effect, TypeScript will also complain that the node is readonly
+}
+
+// Do this instead
+heading(node, ctx) {
+  ctx.setProperty(node, "depth", 2);
+}
+
+// Or return a new node to replace it entirely, but this is less efficient and generally not recommended
+heading(node) {
+  return { ..node, depth: 2 };
+}
+```
+
+### Async plugins
+
+Visitors can optionally be async. When any visitor is async, `markdownToHtml` and `mdxToJs` return a `Promise<string>` instead of `string`. For performance reasons, it is typically best to avoid async visitors, especially if your visitor matches a large number of nodes.
+
+````ts
+const highlighter = await createHighlighter({ themes: ["github-dark"], langs: ["js", "ts"] });
+
+const asyncHighlight = defineMdastPlugin({
+  name: "async-highlight",
+  async code(node) {
+    const html = await highlighter.codeToHtml(node.value, {
+      lang: node.lang,
+      theme: "github-dark",
+    });
+    return { rawHtml: html };
+  },
+});
+
+// Returns Promise<string> when async plugins are used
+const html = await markdownToHtml("```js\ncode\n```", {
+  mdastPlugins: [asyncHighlight],
+});
+````
+
+## API
+
+### `markdownToHtml(source: string, options?: CompileOptions)`
+
+Parse Markdown and compile to HTML. Returns `string` if all plugins are sync, `Promise<string>` if any are async.
+
+```ts
+const html = markdownToHtml("# Hello\n\nWorld");
+// <h1>Hello</h1>\n<p>World</p>
+```
+
+### `mdxToJs(source: string, options?: MdxCompileOptions)`
+
+Parse MDX and compile to JavaScript module code. Same sync/async return behavior.
+
+```ts
+const js = mdxToJs("# Hello\n\n<MyComponent />");
+```
+
+#### Static optimization
+
+The `optimizeStatic` option for MDX collapses static subtrees into pre-rendered HTML strings, reducing the number of JSX element calls in the output and increasing rendering performance. Dynamic content (JSX components, expressions) is preserved as normal JSX calls.
+
+```ts
+// Astro-style: wraps static HTML in <Fragment set:html="...">
+const js = mdxToJs("# Hello\n\nWorld", {
+  optimizeStatic: {
+    component: "Fragment",
+    prop: "set:html",
+  },
+});
+
+// React-style: wraps in <div dangerouslySetInnerHTML={{ __html: "..." }}>
+const js = mdxToJs("# Hello\n\nWorld", {
+  optimizeStatic: {
+    component: "div",
+    prop: "dangerouslySetInnerHTML",
+    wrapPropValue: true,
+  },
+});
+```
+
+The `ignoreElements` option can be used to exclude specific elements from collapsing.
+
+### `markdownToMdast(source: string)`
+
+Parse Markdown and return a complete mdast tree. This can be useful if you wanted to benefit from the fast native parsing of Sätteri, but ultimately wanted another pipeline to handle transformations and compilation, e.g. using remark plugins and `remark-stringify` to convert back to Markdown after processing.
+
+```ts
+import { markdownToMdast } from "satteri";
+
+const tree = markdownToMdast("# Hello\n\nWorld");
+// tree.children[0].type === "heading"
+// tree.children[0].depth === 1
+```
+
+### `mdxToMdast(source: string)`
+
+Parse MDX and return a complete mdast tree.
+
+```ts
+const tree = mdxToMdast('<Component foo="bar" />');
+// tree.children[0].type === "mdxJsxFlowElement"
+// tree.children[0].name === "Component"
+```
+
+### `markdownToHast(source: string)`
+
+Parse Markdown, convert to hast, and return a complete hast tree.
+
+```ts
+const tree = markdownToHast("# Hello\n\nWorld");
+// tree.children[0].type === "element"
+// tree.children[0].tagName === "h1"
+```
+
+### `mdxToHast(source: string)`
+
+Parse MDX, convert to hast, and return a complete hast tree.
+
+```ts
+const tree = mdxToHast("<MyComponent />");
+// tree.children[0].type === "mdxJsxFlowElement"
+// tree.children[0].name === "MyComponent"
+```
+
+### `defineMdastPlugin(definition: MdastPluginDefinition)`
+
+Type-safe wrapper for MDAST plugin definitions.
+
+### `defineHastPlugin(definition: HastPluginDefinition)`
+
+Type-safe wrapper for HAST plugin definitions.
+
+### `CompileOptions`
+
+```ts
+interface CompileOptions {
+  mdastPlugins?: MdastPluginDefinition[];
+  hastPlugins?: HastPluginDefinition[];
+  filename?: string;
+}
+
+// mdxToJs accepts MdxCompileOptions, which extends CompileOptions
+interface MdxCompileOptions extends CompileOptions {
+  optimizeStatic?: OptimizeStaticConfig;
+}
+```
+
+## License
+
+MIT

package/dist/command-buffer.js

@@ -40,7 +40,6 @@ export function classifyReturn(value) {
         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);

package/dist/compile.d.ts

@@ -1,10 +1,5 @@
-/**
- * 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";
+import type { MdastNode, HastNode } from "./types.js";
 /** Configuration for static subtree collapsing during MDX compilation. */
 export interface OptimizeStaticConfig {
     component: string;
@@ -15,8 +10,18 @@ export interface OptimizeStaticConfig {
 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>;
+export interface MdxCompileOptions extends CompileOptions {
+    optimizeStatic?: OptimizeStaticConfig;
+}
+export declare function markdownToHtml(source: string, options?: CompileOptions): string | Promise<string>;
+export declare function mdxToJs(source: string, options?: MdxCompileOptions): string | Promise<string>;
+/** Parse Markdown source into a materialized mdast tree. */
+export declare function markdownToMdast(source: string): MdastNode;
+/** Parse MDX source into a materialized mdast tree. */
+export declare function mdxToMdast(source: string): MdastNode;
+/** Convert Markdown source to a materialized hast tree. */
+export declare function markdownToHast(source: string): HastNode;
+/** Convert MDX source to a materialized hast tree. */
+export declare function mdxToHast(source: string): HastNode;

package/dist/compile.js

@@ -1,37 +1,27 @@
-/**
- * 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,
-    }));
-}
+import { parseToHtml, compileMdx, createHastHandle, createMdxHastHandle, renderHandle, compileHandle, applyCommandsToHandle, dropHandle, createMdastHandle, createMdxMdastHandle, applyCommandsToMdastHandle, convertMdastToHastHandle, applyCommandsAndConvertToHastHandle, getHandleSource, serializeHandle, serializeMdastHandle, } from "../index.js";
+import { ArenaReader } from "./mdast/mdast-reader.js";
+import { materializeTree } from "./mdast/mdast-materializer.js";
+import { HastReader } from "./hast/hast-reader.js";
+import { materializeHastTree } from "./hast/hast-materializer.js";
 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) {
+        while (i < plugins.length) {
             const idx = i++;
-            const { instance } = instances[idx];
-            const subs = resolveMdastSubscriptions(instance);
-            const result = visitMdastHandle(handle, instance, subs, source, filename);
+            const plugin = plugins[idx];
+            const subs = resolveMdastSubscriptions(plugin);
+            const result = visitMdastHandle(handle, plugin, subs, source, filename);
             if (result instanceof Promise) {
                 return result.then((r) => {
-                    applyMdastResult(r, idx, instances.length, handle);
+                    applyMdastResult(r, idx, plugins.length, handle);
                     return runNext();
                 });
             }
-            applyMdastResult(result, idx, instances.length, handle);
+            applyMdastResult(result, idx, plugins.length, handle);
         }
         return { handle, pendingCommands };
     };
@@ -47,18 +37,16 @@ function runMdastPluginsOnHandle(handle, plugins, filename) {
     }
     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];
+        while (i < plugins.length) {
+            const plugin = plugins[i];
             i++;
-            const subs = resolveSubscriptions(instance);
-            const result = visitHastHandle(handle, instance, subs, source, filename);
+            const subs = resolveSubscriptions(plugin);
+            const result = visitHastHandle(handle, plugin, subs, source, filename);
             if (result instanceof Promise) {
                 return result.then(runNext);
             }
@@ -66,7 +54,7 @@ function runHastPluginsOnHandle(handle, plugins, source, filename) {
     };
     return runNext();
 }
-export function compileMarkdownToHtml(source, options = {}) {
+export function markdownToHtml(source, options = {}) {
     const { mdastPlugins = [], hastPlugins = [], filename = "<unknown>" } = options;
     if (mdastPlugins.length === 0 && hastPlugins.length === 0) {
         return parseToHtml(source);
@@ -90,7 +78,7 @@ export function compileMarkdownToHtml(source, options = {}) {
     }
     return finish(handleResult);
 }
-export function compileMdxToJs(source, options = {}) {
+export function mdxToJs(source, options = {}) {
     const { mdastPlugins = [], hastPlugins = [], optimizeStatic, filename = "<unknown>" } = options;
     const mdxOptions = optimizeStatic ? { optimizeStatic } : undefined;
     if (mdastPlugins.length === 0 && hastPlugins.length === 0) {
@@ -135,3 +123,30 @@ function createHastHandleFromMdast(source, mdastPlugins, mdx, filename) {
     }
     return convert(mdastResult);
 }
+// Step-by-step API: individual pipeline stages with materialized trees
+/** Parse Markdown source into a materialized mdast tree. */
+export function markdownToMdast(source) {
+    const handle = createMdastHandle(source);
+    const buf = serializeMdastHandle(handle);
+    return materializeTree(new ArenaReader(buf));
+}
+/** Parse MDX source into a materialized mdast tree. */
+export function mdxToMdast(source) {
+    const handle = createMdxMdastHandle(source);
+    const buf = serializeMdastHandle(handle);
+    return materializeTree(new ArenaReader(buf));
+}
+/** Convert Markdown source to a materialized hast tree. */
+export function markdownToHast(source) {
+    const handle = createHastHandle(source);
+    const buf = serializeHandle(handle);
+    dropHandle(handle);
+    return materializeHastTree(new HastReader(buf));
+}
+/** Convert MDX source to a materialized hast tree. */
+export function mdxToHast(source) {
+    const handle = createMdxHastHandle(source);
+    const buf = serializeHandle(handle);
+    dropHandle(handle);
+    return materializeHastTree(new HastReader(buf));
+}

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

@@ -15,19 +15,19 @@ export interface HastDiagnostic {
 export interface HastVisitorContext {
     readonly source: string;
     readonly filename: string;
-    removeNode(node: HastNode): void;
-    replaceNode(node: HastNode, newNode: HastNode): void;
-    insertBefore(node: HastNode, newNode: HastNode): void;
-    insertAfter(node: HastNode, newNode: HastNode): void;
-    wrapNode(node: HastNode, parentNode: HastNode): void;
-    prependChild(node: HastNode, childNode: HastNode): void;
-    appendChild(node: HastNode, childNode: HastNode): void;
-    setProperty(node: HastNode, key: string, value: unknown): void;
+    removeNode(node: Readonly<HastNode>): void;
+    replaceNode(node: Readonly<HastNode>, newNode: HastNode): void;
+    insertBefore(node: Readonly<HastNode>, newNode: HastNode): void;
+    insertAfter(node: Readonly<HastNode>, newNode: HastNode): void;
+    wrapNode(node: Readonly<HastNode>, parentNode: HastNode): void;
+    prependChild(node: Readonly<HastNode>, childNode: HastNode): void;
+    appendChild(node: Readonly<HastNode>, childNode: HastNode): void;
+    setProperty(node: Readonly<HastNode>, key: string, value: unknown): void;
     /** Collect the concatenated text of all descendant text nodes (like DOM textContent). */
-    textContent(node: HastNode): string;
+    textContent(node: Readonly<HastNode>): string;
     report(opts: {
         message: string;
-        node?: HastNode;
+        node?: Readonly<HastNode>;
         severity?: "error" | "warning" | "info";
     }): void;
     getDiagnostics(): HastDiagnostic[];
@@ -35,9 +35,9 @@ export interface HastVisitorContext {
 /** A filtered visitor: Rust filters by tag/component name, only matched nodes cross the boundary. */
 export interface HastFilteredVisitor<N extends HastNode = HastNode> {
     filter: string[];
-    visit(node: N, ctx: HastVisitorContext): HastNode | void | Promise<HastNode | void>;
+    visit(node: Readonly<N>, ctx: HastVisitorContext): HastNode | void | Promise<HastNode | void>;
 }
-type HastVisitorFn<N extends HastNode = HastNode> = (node: N, ctx: HastVisitorContext) => HastNode | void | Promise<HastNode | void>;
+type HastVisitorFn<N extends HastNode = HastNode> = (node: Readonly<N>, ctx: HastVisitorContext) => HastNode | void | Promise<HastNode | void>;
 export interface HastVisitorInstance {
     element?: HastFilteredVisitor<Element> | HastFilteredVisitor<Element>[];
     mdxJsxFlowElement?: HastFilteredVisitor<MdxJsxFlowElementHast> | HastFilteredVisitor<MdxJsxFlowElementHast>[];

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-export { compileMarkdownToHtml, compileMdxToJs } from "./compile.js";
-export type { CompileOptions, OptimizeStaticConfig } from "./compile.js";
+export { markdownToHtml, mdxToJs, markdownToMdast, mdxToMdast, markdownToHast, mdxToHast, } from "./compile.js";
+export type { CompileOptions, MdxCompileOptions, OptimizeStaticConfig } from "./compile.js";
 export { defineMdastPlugin, defineHastPlugin } from "./plugin.js";
 export type { MdastPluginDefinition, HastPluginDefinition } from "./plugin.js";
 export type { HastVisitorInstance, HastVisitorContext, HastFilteredVisitor, EstreeProgram, } from "./hast/hast-visitor.js";

package/dist/index.js

@@ -1,4 +1,4 @@
 // Public API: compile functions
-export { compileMarkdownToHtml, compileMdxToJs } from "./compile.js";
+export { markdownToHtml, mdxToJs, markdownToMdast, mdxToMdast, markdownToHast, mdxToHast, } from "./compile.js";
 // Plugin definitions
 export { defineMdastPlugin, defineHastPlugin } from "./plugin.js";

package/dist/mdast/mdast-visitor.d.ts

@@ -15,22 +15,22 @@ export declare class MdastVisitorContext {
     readonly source: string;
     readonly filename: string;
     constructor(handle: MdastHandle, source: string, filename: string);
-    removeNode(node: MdastNode): void;
-    insertBefore(node: MdastNode, newNode: MdastNode): void;
-    insertAfter(node: MdastNode, newNode: MdastNode): void;
-    wrapNode(node: MdastNode, parentNode: MdastNode): void;
-    prependChild(node: MdastNode, childNode: MdastNode): void;
-    appendChild(node: MdastNode, childNode: MdastNode): void;
-    replaceNode(node: MdastNode, newNode: MdastNode): void;
-    setProperty(node: MdastNode, key: string, value: unknown): void;
+    removeNode(node: Readonly<MdastNode>): void;
+    insertBefore(node: Readonly<MdastNode>, newNode: MdastNode): void;
+    insertAfter(node: Readonly<MdastNode>, newNode: MdastNode): void;
+    wrapNode(node: Readonly<MdastNode>, parentNode: MdastNode): void;
+    prependChild(node: Readonly<MdastNode>, childNode: MdastNode): void;
+    appendChild(node: Readonly<MdastNode>, childNode: MdastNode): void;
+    replaceNode(node: Readonly<MdastNode>, newNode: MdastNode): void;
+    setProperty<N extends MdastNode, K extends keyof N & string>(node: Readonly<N>, key: K, value: N[K]): void;
     /** Collect the concatenated text of all descendant text nodes (like mdast-util-to-string). */
-    textContent(node: MdastNode, options?: {
+    textContent(node: Readonly<MdastNode>, options?: {
         includeImageAlt?: boolean;
         includeHtml?: boolean;
     }): string;
     report({ message, node, severity, }: {
         message: string;
-        node?: MdastNode;
+        node?: Readonly<MdastNode>;
         severity?: "error" | "warning" | "info";
     }): void;
     /** Get the binary command buffer for all mutations recorded via context methods. */
@@ -42,7 +42,7 @@ type MdastVisitorResult = MdastNode | {
 } | {
     rawHtml: string;
 } | undefined | null | void;
-type MdastVisitorFn<N extends MdastNode = MdastNode> = (node: N, context: MdastVisitorContext) => MdastVisitorResult | Promise<MdastVisitorResult>;
+type MdastVisitorFn<N extends MdastNode = MdastNode> = (node: Readonly<N>, context: MdastVisitorContext) => MdastVisitorResult | Promise<MdastVisitorResult>;
 export interface MdastPluginInstance {
     root?: MdastVisitorFn<Root>;
     paragraph?: MdastVisitorFn<Paragraph>;

package/dist/mdast/mdast-visitor.js

@@ -1,7 +1,7 @@
 import { materializeNode, TYPE_NAMES } from "./mdast-materializer.js";
 import { ArenaReader } from "./mdast-reader.js";
 import { CommandBuffer, classifyReturn } from "../command-buffer.js";
-import { walkMdastHandle, serializeMdastHandle, getNodeData as napiGetNodeData, setNodeData, mdastTextContentHandle, } from "../../index.js";
+import { walkMdastHandle, serializeMdastHandle, getNodeData as napiGetNodeData, mdastTextContentHandle, } from "../../index.js";
 const MutationType = {
     Replace: "replace",
     Remove: "remove",
@@ -86,6 +86,11 @@ export class MdastVisitorContext {
         this.#commandBuffer.replace(nid(node), newNode);
     }
     setProperty(node, key, value) {
+        if (key === "data") {
+            // data is stored as JSON in the arena, serialize it for the command buffer
+            this.#commandBuffer.setProperty(nid(node), key, value != null ? JSON.stringify(value) : null);
+            return;
+        }
         this.#commandBuffer.setProperty(nid(node), key, value);
     }
     /** Collect the concatenated text of all descendant text nodes (like mdast-util-to-string). */
@@ -209,7 +214,7 @@ class MdastLazyChildResolver {
  *   [node_data: u32+bytes][position: 6×u32 = 24B][child_count: u16][child_ids: N×u32][type-specific data]
  */
 const encoder = new TextEncoder();
-function readMdastMatchedNode(view, buf, dataOffset, nodeId, nodeType, dirtyData, resolver) {
+function readMdastMatchedNode(view, buf, dataOffset, nodeId, nodeType, resolver) {
     let pos = dataOffset;
     // Node data (JSON bytes), always first
     const dataJsonLen = ru32(view, pos);
@@ -452,26 +457,9 @@ function readMdastMatchedNode(view, buf, dataOffset, nodeId, nodeType, dirtyData
         // strong(12), break(14), tableRow(22), tableCell(23), delete(24): no extra data
     }
     mdastNodeIdMap.set(node, nodeId);
-    // Read inline node_data JSON from the end of the data section.
-    // The Rust serializer always appends [json_len: u32][json_bytes...] at the end.
-    // We need to find it by reading from dataEnd backwards.
-    // Actually, we read it at `dataOffset + dataLen - (4 + jsonDataLen)` but we don't
-    // know jsonDataLen yet. Instead, the data section ends with [len: u32][bytes...],
-    // so we scan from the current end of type-specific data.
-    // For simplicity, we'll handle this in the caller which knows the full data_len.
-    // Set up data getter/setter that tracks dirty entries
-    let currentData = initialData;
-    Object.defineProperty(node, "data", {
-        get() {
-            return currentData;
-        },
-        set(value) {
-            currentData = value;
-            dirtyData.set(nodeId, value);
-        },
-        configurable: true,
-        enumerable: true,
-    });
+    if (initialData) {
+        node.data = initialData;
+    }
     return node;
 }
 /** Apply a sync visitor result to the return buffer.
@@ -505,7 +493,6 @@ function applyMdastVisitResult(result, nodeId, returnBuffer, originalNode) {
 export function visitMdastHandle(handle, plugin, subs, source, filename) {
     const context = new MdastVisitorContext(handle, source, filename);
     const returnBuffer = new CommandBuffer();
-    const dirtyData = new Map();
     const resolver = new MdastLazyChildResolver(handle);
     const rustSubs = subs.map((s) => ({ nodeType: s.nodeType, tagFilter: [] }));
     const matchBuf = walkMdastHandle(handle, rustSubs);
@@ -518,7 +505,7 @@ export function visitMdastHandle(handle, plugin, subs, source, filename) {
         const subIndex = matchBuf[indexBase + 4];
         const dataOffset = ru32(matchView, indexBase + 6);
         const sub = subs[subIndex];
-        const node = readMdastMatchedNode(matchView, matchBuf, dataOffset, nodeId, sub.nodeType, dirtyData, resolver);
+        const node = readMdastMatchedNode(matchView, matchBuf, dataOffset, nodeId, sub.nodeType, resolver);
         const result = sub.visitFn.call(plugin, node, context);
         if (result instanceof Promise) {
             deferred ??= [];
@@ -533,16 +520,12 @@ export function visitMdastHandle(handle, plugin, subs, source, filename) {
             for (const { nodeId, result, originalNode } of results) {
                 applyMdastVisitResult(result, nodeId, returnBuffer, originalNode);
             }
-            return finalizeMdastVisit(handle, context, returnBuffer, dirtyData);
+            return finalizeMdastVisit(handle, context, returnBuffer);
         });
     }
-    return finalizeMdastVisit(handle, context, returnBuffer, dirtyData);
+    return finalizeMdastVisit(handle, context, returnBuffer);
 }
-function finalizeMdastVisit(handle, context, returnBuffer, dirtyData) {
-    for (const [id, value] of dirtyData) {
-        const json = value ? JSON.stringify(value) : "";
-        setNodeData(handle, id, encoder.encode(json));
-    }
+function finalizeMdastVisit(handle, context, returnBuffer) {
     const { merged, hasMutations } = mergeAndReset(returnBuffer, context);
     return { commandBuffer: merged, diagnostics: context.getDiagnostics(), hasMutations };
 }

package/dist/plugin.d.ts

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

package/dist/plugin.js

@@ -2,17 +2,11 @@ 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;
 }

package/dist/types.js

@@ -1,5 +1 @@
-// 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 {};

package/index.js

@@ -81,8 +81,8 @@ function requireNative() {
       try {
         const binding = require('@bruits/satteri-android-arm64')
         const bindingPackageVersion = require('@bruits/satteri-android-arm64/package.json').version
-        if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -97,8 +97,8 @@ function requireNative() {
       try {
         const binding = require('@bruits/satteri-android-arm-eabi')
         const bindingPackageVersion = require('@bruits/satteri-android-arm-eabi/package.json').version
-        if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -118,8 +118,8 @@ function requireNative() {
       try {
         const binding = require('@bruits/satteri-win32-x64-gnu')
         const bindingPackageVersion = require('@bruits/satteri-win32-x64-gnu/package.json').version
-        if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -134,8 +134,8 @@ function requireNative() {
       try {
         const binding = require('@bruits/satteri-win32-x64-msvc')
         const bindingPackageVersion = require('@bruits/satteri-win32-x64-msvc/package.json').version
-        if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -151,8 +151,8 @@ function requireNative() {
       try {
         const binding = require('@bruits/satteri-win32-ia32-msvc')
         const bindingPackageVersion = require('@bruits/satteri-win32-ia32-msvc/package.json').version
-        if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -167,8 +167,8 @@ function requireNative() {
       try {
         const binding = require('@bruits/satteri-win32-arm64-msvc')
         const bindingPackageVersion = require('@bruits/satteri-win32-arm64-msvc/package.json').version
-        if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -186,8 +186,8 @@ function requireNative() {
     try {
       const binding = require('@bruits/satteri-darwin-universal')
       const bindingPackageVersion = require('@bruits/satteri-darwin-universal/package.json').version
-      if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-        throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      if (bindingPackageVersion !== '0.1.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+        throw new Error(`Native binding package version mismatch, expected 0.1.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
       }
       return binding
     } catch (e) {
@@ -202,8 +202,8 @@ function requireNative() {
       try {
         const binding = require('@bruits/satteri-darwin-x64')
         const bindingPackageVersion = require('@bruits/satteri-darwin-x64/package.json').version
-        if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -218,8 +218,8 @@ function requireNative() {
       try {
         const binding = require('@bruits/satteri-darwin-arm64')
         const bindingPackageVersion = require('@bruits/satteri-darwin-arm64/package.json').version
-        if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -238,8 +238,8 @@ function requireNative() {
       try {
         const binding = require('@bruits/satteri-freebsd-x64')
         const bindingPackageVersion = require('@bruits/satteri-freebsd-x64/package.json').version
-        if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -254,8 +254,8 @@ function requireNative() {
       try {
         const binding = require('@bruits/satteri-freebsd-arm64')
         const bindingPackageVersion = require('@bruits/satteri-freebsd-arm64/package.json').version
-        if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -275,8 +275,8 @@ function requireNative() {
         try {
           const binding = require('@bruits/satteri-linux-x64-musl')
           const bindingPackageVersion = require('@bruits/satteri-linux-x64-musl/package.json').version
-          if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -291,8 +291,8 @@ function requireNative() {
         try {
           const binding = require('@bruits/satteri-linux-x64-gnu')
           const bindingPackageVersion = require('@bruits/satteri-linux-x64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -309,8 +309,8 @@ function requireNative() {
         try {
           const binding = require('@bruits/satteri-linux-arm64-musl')
           const bindingPackageVersion = require('@bruits/satteri-linux-arm64-musl/package.json').version
-          if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -325,8 +325,8 @@ function requireNative() {
         try {
           const binding = require('@bruits/satteri-linux-arm64-gnu')
           const bindingPackageVersion = require('@bruits/satteri-linux-arm64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -343,8 +343,8 @@ function requireNative() {
         try {
           const binding = require('@bruits/satteri-linux-arm-musleabihf')
           const bindingPackageVersion = require('@bruits/satteri-linux-arm-musleabihf/package.json').version
-          if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -359,8 +359,8 @@ function requireNative() {
         try {
           const binding = require('@bruits/satteri-linux-arm-gnueabihf')
           const bindingPackageVersion = require('@bruits/satteri-linux-arm-gnueabihf/package.json').version
-          if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -377,8 +377,8 @@ function requireNative() {
         try {
           const binding = require('@bruits/satteri-linux-loong64-musl')
           const bindingPackageVersion = require('@bruits/satteri-linux-loong64-musl/package.json').version
-          if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -393,8 +393,8 @@ function requireNative() {
         try {
           const binding = require('@bruits/satteri-linux-loong64-gnu')
           const bindingPackageVersion = require('@bruits/satteri-linux-loong64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -411,8 +411,8 @@ function requireNative() {
         try {
           const binding = require('@bruits/satteri-linux-riscv64-musl')
           const bindingPackageVersion = require('@bruits/satteri-linux-riscv64-musl/package.json').version
-          if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -427,8 +427,8 @@ function requireNative() {
         try {
           const binding = require('@bruits/satteri-linux-riscv64-gnu')
           const bindingPackageVersion = require('@bruits/satteri-linux-riscv64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -444,8 +444,8 @@ function requireNative() {
       try {
         const binding = require('@bruits/satteri-linux-ppc64-gnu')
         const bindingPackageVersion = require('@bruits/satteri-linux-ppc64-gnu/package.json').version
-        if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -460,8 +460,8 @@ function requireNative() {
       try {
         const binding = require('@bruits/satteri-linux-s390x-gnu')
         const bindingPackageVersion = require('@bruits/satteri-linux-s390x-gnu/package.json').version
-        if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -480,8 +480,8 @@ function requireNative() {
       try {
         const binding = require('@bruits/satteri-openharmony-arm64')
         const bindingPackageVersion = require('@bruits/satteri-openharmony-arm64/package.json').version
-        if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -496,8 +496,8 @@ function requireNative() {
       try {
         const binding = require('@bruits/satteri-openharmony-x64')
         const bindingPackageVersion = require('@bruits/satteri-openharmony-x64/package.json').version
-        if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -512,8 +512,8 @@ function requireNative() {
       try {
         const binding = require('@bruits/satteri-openharmony-arm')
         const bindingPackageVersion = require('@bruits/satteri-openharmony-arm/package.json').version
-        if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "satteri",
-  "version": "0.1.1",
-  "description": "High-performance Markdown processing",
+  "version": "0.1.3",
+  "description": "High-performance Markdown and MDX processing",
   "files": [
     "dist",
     "browser.js",
@@ -10,22 +10,19 @@
     "satteri_napi.wasi.cjs",
     "satteri_napi.wasi-browser.js",
     "wasi-worker.mjs",
-    "wasi-worker-browser.js",
-    "satteri_napi.linux-x64-gnu.node"
+    "wasi-worker-browser.js"
   ],
   "type": "module",
   "main": "./dist/index.js",
   "exports": {
-    ".": "./dist/index.js",
-    "./hast": "./dist/hast-types.js",
-    "./mdast": "./dist/mdast-types.js"
+    ".": "./dist/index.js"
   },
   "scripts": {
-    "build:native": "napi build --manifest-path ../../crates/satteri-napi-binding/Cargo.toml --output-dir . --platform --release --esm",
+    "build:native": "napi build --manifest-path ../../crates/satteri-napi-binding/Cargo.toml --output-dir . --platform --release --esm --strip",
     "build:native:debug": "napi build --manifest-path ../../crates/satteri-napi-binding/Cargo.toml --output-dir . --platform --esm",
     "build:ts": "tsc --project tsconfig.build.json",
     "build": "pnpm build:native && pnpm build:ts",
-    "artifacts": "napi create-npm-dirs && napi artifacts && napi version",
+    "artifacts": "napi create-npm-dirs && napi artifacts",
     "dev": "tsc --watch",
     "vitest": "vitest",
     "test": "vitest run",
@@ -41,6 +38,7 @@
     "@emnapi/runtime": "^1.9.1",
     "@napi-rs/wasm-runtime": "^1.1.2",
     "@types/node": "^25.5.0",
+    "shiki": "^4.0.2",
     "vitest": "^4"
   },
   "napi": {
@@ -53,5 +51,12 @@
       "x86_64-pc-windows-msvc",
       "wasm32-wasip1-threads"
     ]
+  },
+  "optionalDependencies": {
+    "@bruits/satteri-linux-x64-gnu": "0.1.3",
+    "@bruits/satteri-darwin-x64": "0.1.3",
+    "@bruits/satteri-darwin-arm64": "0.1.3",
+    "@bruits/satteri-win32-x64-msvc": "0.1.3",
+    "@bruits/satteri-wasm32-wasi": "0.1.3"
   }
 }