@takazudo/zfb-md-wasm 2.21.1 → 2.22.1

package/README.md

@@ -665,6 +665,33 @@ The root import remains the compatibility choice for code that also calls
 `compile`, and the existing highlight import remains compatible. This is also
 how the package's vitest suite and parse benchmark exercise the built wasm.
 
+## Cloudflare Workers (workerd)
+
+Only `./parse` and `./highlight` select `workerd` entries; the root and
+`./render` do not. In a Worker, use the same public subpath as in Node:
+
+```ts
+import { parseToAst } from "@takazudo/zfb-md-wasm/parse";
+
+export default {
+  async fetch(request: Request): Promise<Response> {
+    const source = new URL(request.url).searchParams.get("source") ?? "# Hello";
+    return Response.json(await parseToAst(source, { filename: "post.md" }));
+  },
+};
+```
+
+Wrangler's default module rules handle the static `.wasm` imports without
+extra configuration. For a bundled Worker in Miniflare, use
+`modulesRules: [{ type: "CompiledWasm", include: ["**/*.wasm"] }]`.
+`@cloudflare/vite-plugin` has not been tested.
+
+After a trap, each recovery creates a fresh glue closure against the same
+compiled module. The next call uses the replacement instance. A further trap
+after 16 successful recoveries makes that entry terminal and throws
+`ZfbMdWasmTrapRecoveryLimitError` on that and later calls; recycle the Worker
+isolate. Parse and highlight keep independent recovery state.
+
 ## Parity guarantee & limitations
 
 Output matches zfb's native pipeline on a fixed fixture corpus (the parity

package/dist/highlight-workerd.d.ts

@@ -0,0 +1,11 @@
+export declare const init: () => Promise<void>, highlightCode: (code: string, options: import("./types.js").HighlightCodeOptions) => Promise<import("./types.js").HighlightCodeResult>, version: () => Promise<string>, __forceTrapForTests: () => Promise<void>, __getTrapRecoveryStateForTests: () => {
+    compiledModuleLoads: number;
+    currentGeneration: number;
+    freshInstanceStarts: number;
+    glueImportAttempts: number;
+    maxTrapRecoveries: number;
+    trapRecoveriesStarted: number;
+    terminal: boolean;
+};
+export { ZfbMdWasmTrapError, ZfbMdWasmTrapRecoveryLimitError } from "./runtime-static.js";
+export type { HighlightRole, HighlightCodeOptions, HighlightCodeResult, HighlightDiagnostic, HighlightDiagnosticSource, } from "./types.js";

package/dist/highlight-workerd.js

@@ -0,0 +1,7 @@
+import wasmModule from "./wasm-highlight/zfb_md_wasm_highlight_bg.wasm";
+import { createGlue } from "./wasm-highlight/zfb_md_wasm_highlight_glue.zfb-factory.mjs";
+import { createStaticWasmApi } from "./runtime-static.js";
+const api = createStaticWasmApi({ module: wasmModule, createGlue });
+export const { init, highlightCode, version, __forceTrapForTests, __getTrapRecoveryStateForTests } = api;
+export { ZfbMdWasmTrapError, ZfbMdWasmTrapRecoveryLimitError } from "./runtime-static.js";
+//# sourceMappingURL=highlight-workerd.js.map

package/dist/highlight-workerd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"highlight-workerd.js","sourceRoot":"","sources":["../src/highlight-workerd.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,gDAAgD,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,MAAM,6DAA6D,CAAC;AACzF,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D,MAAM,GAAG,GAAG,mBAAmB,CAAC,EAAE,MAAM,EAAE,UAAgC,EAAE,UAAU,EAAE,CAAC,CAAC;AAE1F,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,mBAAmB,EAAE,8BAA8B,EAAE,GAChG,GAAG,CAAC;AAEN,OAAO,EAAE,kBAAkB,EAAE,+BAA+B,EAAE,MAAM,qBAAqB,CAAC","sourcesContent":["import wasmModule from \"./wasm-highlight/zfb_md_wasm_highlight_bg.wasm\";\nimport { createGlue } from \"./wasm-highlight/zfb_md_wasm_highlight_glue.zfb-factory.mjs\";\nimport { createStaticWasmApi } from \"./runtime-static.js\";\n\nconst api = createStaticWasmApi({ module: wasmModule as WebAssembly.Module, createGlue });\n\nexport const { init, highlightCode, version, __forceTrapForTests, __getTrapRecoveryStateForTests } =\n  api;\n\nexport { ZfbMdWasmTrapError, ZfbMdWasmTrapRecoveryLimitError } from \"./runtime-static.js\";\n\nexport type {\n  HighlightRole,\n  HighlightCodeOptions,\n  HighlightCodeResult,\n  HighlightDiagnostic,\n  HighlightDiagnosticSource,\n} from \"./types.js\";\n"]}

package/dist/parse-workerd.d.ts

@@ -0,0 +1,12 @@
+export declare const init: () => Promise<void>, parseToAst: (source: string, options?: import("./types.js").ParseToAstOptions) => Promise<import("./types.js").ParseToAstResult>, version: () => Promise<string>, __forceTrapForTests: () => Promise<void>, __getTrapRecoveryStateForTests: () => {
+    compiledModuleLoads: number;
+    currentGeneration: number;
+    freshInstanceStarts: number;
+    glueImportAttempts: number;
+    maxTrapRecoveries: number;
+    trapRecoveriesStarted: number;
+    terminal: boolean;
+};
+export { MdastAdapterError, toMdastRoot } from "./mdast.js";
+export { ZfbMdWasmTrapError, ZfbMdWasmTrapRecoveryLimitError } from "./runtime-static.js";
+export type { ParseToAstResult, ParseToAstOptions, ParseDialect, FrontmatterPolicy, ParsePipelineOptions, Diagnostic, DiagnosticSource, AstPoint, AstPosition, RawMdastData, MarkdownRsStop, MdastNode, MdastRoot, UnknownMdastNode, Root, Paragraph, Heading, ThematicBreak, Blockquote, List, ListItem, Html, Code, Definition, Text, DirectiveNodeBase, ContainerDirective, LeafDirective, TextDirective, Emphasis, Strong, InlineCode, Break, Link, Image, ReferenceKind, LinkReference, ImageReference, FootnoteDefinition, FootnoteReference, TableAlign, Table, TableRow, TableCell, Delete, Yaml, MdxFlowExpression, MdxTextExpression, MdxJsxFlowElement, MdxJsxTextElement, MdxJsxAttributeContent, MdxJsxAttribute, MdxJsxAttributeValueExpression, MdxJsxExpressionAttribute, } from "./types.js";

package/dist/parse-workerd.js

@@ -0,0 +1,8 @@
+import wasmModule from "./wasm-parse/zfb_md_wasm_parse_bg.wasm";
+import { createGlue } from "./wasm-parse/zfb_md_wasm_parse_glue.zfb-factory.mjs";
+import { createStaticWasmApi } from "./runtime-static.js";
+const api = createStaticWasmApi({ module: wasmModule, createGlue });
+export const { init, parseToAst, version, __forceTrapForTests, __getTrapRecoveryStateForTests } = api;
+export { MdastAdapterError, toMdastRoot } from "./mdast.js";
+export { ZfbMdWasmTrapError, ZfbMdWasmTrapRecoveryLimitError } from "./runtime-static.js";
+//# sourceMappingURL=parse-workerd.js.map

package/dist/parse-workerd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-workerd.js","sourceRoot":"","sources":["../src/parse-workerd.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,wCAAwC,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,qDAAqD,CAAC;AACjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D,MAAM,GAAG,GAAG,mBAAmB,CAAC,EAAE,MAAM,EAAE,UAAgC,EAAE,UAAU,EAAE,CAAC,CAAC;AAE1F,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,mBAAmB,EAAE,8BAA8B,EAAE,GAC7F,GAAG,CAAC;AAEN,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,+BAA+B,EAAE,MAAM,qBAAqB,CAAC","sourcesContent":["import wasmModule from \"./wasm-parse/zfb_md_wasm_parse_bg.wasm\";\nimport { createGlue } from \"./wasm-parse/zfb_md_wasm_parse_glue.zfb-factory.mjs\";\nimport { createStaticWasmApi } from \"./runtime-static.js\";\n\nconst api = createStaticWasmApi({ module: wasmModule as WebAssembly.Module, createGlue });\n\nexport const { init, parseToAst, version, __forceTrapForTests, __getTrapRecoveryStateForTests } =\n  api;\n\nexport { MdastAdapterError, toMdastRoot } from \"./mdast.js\";\nexport { ZfbMdWasmTrapError, ZfbMdWasmTrapRecoveryLimitError } from \"./runtime-static.js\";\nexport type {\n  ParseToAstResult,\n  ParseToAstOptions,\n  ParseDialect,\n  FrontmatterPolicy,\n  ParsePipelineOptions,\n  Diagnostic,\n  DiagnosticSource,\n  AstPoint,\n  AstPosition,\n  RawMdastData,\n  MarkdownRsStop,\n  MdastNode,\n  MdastRoot,\n  UnknownMdastNode,\n  Root,\n  Paragraph,\n  Heading,\n  ThematicBreak,\n  Blockquote,\n  List,\n  ListItem,\n  Html,\n  Code,\n  Definition,\n  Text,\n  DirectiveNodeBase,\n  ContainerDirective,\n  LeafDirective,\n  TextDirective,\n  Emphasis,\n  Strong,\n  InlineCode,\n  Break,\n  Link,\n  Image,\n  ReferenceKind,\n  LinkReference,\n  ImageReference,\n  FootnoteDefinition,\n  FootnoteReference,\n  TableAlign,\n  Table,\n  TableRow,\n  TableCell,\n  Delete,\n  Yaml,\n  MdxFlowExpression,\n  MdxTextExpression,\n  MdxJsxFlowElement,\n  MdxJsxTextElement,\n  MdxJsxAttributeContent,\n  MdxJsxAttribute,\n  MdxJsxAttributeValueExpression,\n  MdxJsxExpressionAttribute,\n} from \"./types.js\";\n"]}

package/dist/runtime-core.d.ts

@@ -0,0 +1,41 @@
+import type { CompileResult, HighlightCodeOptions, HighlightCodeResult, ParseToAstOptions, ParseToAstResult, RenderHtmlResult, ZfbMdWasmOptions } from "./types.js";
+export interface WasmGlueModule {
+    initSync(input?: {
+        module: WebAssembly.Module;
+    }): unknown;
+    compile?(source: string, optionsJson: string): string;
+    renderHtml?(source: string, optionsJson: string): string;
+    parseToAst?(source: string, optionsJson: string): string;
+    highlightCode?(code: string, optionsJson: string): string;
+    version(): string;
+    __forceTrapForTests(): void;
+}
+export declare class ZfbMdWasmTrapError extends Error {
+    constructor(cause: unknown);
+}
+export declare class ZfbMdWasmTrapRecoveryLimitError extends Error {
+    constructor(maxRecoveries: number, cause: unknown);
+}
+export interface WasmInstanceStrategy {
+    getModule(onLoad: () => void): Promise<WebAssembly.Module>;
+    createGlue(generation: number, attempt: number): WasmGlueModule | Promise<WasmGlueModule>;
+}
+/** Shared instance lifecycle and bounded trap recovery for URL and static entries. */
+export declare function createWasmApiFromStrategy(strategy: WasmInstanceStrategy): {
+    init: () => Promise<void>;
+    compile: (source: string, options?: ZfbMdWasmOptions) => Promise<CompileResult>;
+    renderHtml: (source: string, options?: ZfbMdWasmOptions) => Promise<RenderHtmlResult>;
+    parseToAst: (source: string, options?: ParseToAstOptions) => Promise<ParseToAstResult>;
+    highlightCode: (code: string, options: HighlightCodeOptions) => Promise<HighlightCodeResult>;
+    version: () => Promise<string>;
+    __forceTrapForTests: () => Promise<void>;
+    __getTrapRecoveryStateForTests: () => {
+        compiledModuleLoads: number;
+        currentGeneration: number;
+        freshInstanceStarts: number;
+        glueImportAttempts: number;
+        maxTrapRecoveries: number;
+        trapRecoveriesStarted: number;
+        terminal: boolean;
+    };
+};

package/dist/runtime-core.js

@@ -0,0 +1,174 @@
+export class ZfbMdWasmTrapError extends Error {
+    constructor(cause) {
+        super("zfb-md-wasm: the wasm instance trapped (a Rust panic or internal fault) and has been " +
+            "automatically re-instantiated. This is always a bug in zfb-md-wasm -- please report it " +
+            "with the input that triggered it.");
+        this.name = "ZfbMdWasmTrapError";
+        this.cause = cause;
+    }
+}
+export class ZfbMdWasmTrapRecoveryLimitError extends Error {
+    constructor(maxRecoveries, cause) {
+        super(`zfb-md-wasm: wasm trap recovery limit reached after ${maxRecoveries} ` +
+            `successful re-instantiations. Further automatic recovery is disabled to avoid ` +
+            `unbounded recovery resource growth. Reload the JS realm before using zfb-md-wasm ` +
+            `again, and please report the input that triggered the repeated traps.`);
+        this.name = "ZfbMdWasmTrapRecoveryLimitError";
+        this.cause = cause;
+    }
+}
+/** Shared instance lifecycle and bounded trap recovery for URL and static entries. */
+export function createWasmApiFromStrategy(strategy) {
+    const MAX_TRAP_RECOVERIES = 16;
+    let currentGeneration = 0;
+    let trapRecoveriesStarted = 0;
+    let freshInstanceStarts = 0;
+    // For the static strategy, glueImportAttempts counts createGlue calls.
+    let glueImportAttempts = 0;
+    let compiledModuleLoads = 0;
+    let terminalTrapRecoveryError;
+    /**
+     * Every fresh instance attempt creates new wasm-bindgen glue. The attempt
+     * counter is independent of the trap generation: transient glue/initSync
+     * failures must not consume the bounded trap-recovery budget.
+     */
+    async function freshInstance(generation) {
+        freshInstanceStarts += 1;
+        glueImportAttempts += 1;
+        const [module, glue] = await Promise.all([
+            strategy.getModule(() => {
+                compiledModuleLoads += 1;
+            }),
+            // A synchronous factory throw is a retryable instance rejection.
+            Promise.resolve().then(() => strategy.createGlue(generation, glueImportAttempts)),
+        ]);
+        glue.initSync({ module });
+        return { generation, glue };
+    }
+    let instancePromise;
+    function startInstance(generation) {
+        const attempt = freshInstance(generation);
+        instancePromise = attempt;
+        void attempt.catch(() => {
+            // Trap recovery can replace the installed instance promise. Never let a
+            // stale initialization rejection clear that newer attempt.
+            if (instancePromise === attempt) {
+                instancePromise = undefined;
+            }
+        });
+        return attempt;
+    }
+    function getInstance() {
+        if (terminalTrapRecoveryError) {
+            return Promise.reject(terminalTrapRecoveryError);
+        }
+        if (!instancePromise) {
+            return startInstance(currentGeneration);
+        }
+        return instancePromise;
+    }
+    function isTrap(err) {
+        return typeof WebAssembly !== "undefined" && err instanceof WebAssembly.RuntimeError;
+    }
+    async function recoverAfterTrap(observedGeneration, cause) {
+        if (terminalTrapRecoveryError) {
+            throw terminalTrapRecoveryError;
+        }
+        // CAS-style single-flight: reporters for an already-replaced generation
+        // await its replacement instead of creating another glue instance.
+        if (observedGeneration !== currentGeneration) {
+            await getInstance();
+            return;
+        }
+        if (trapRecoveriesStarted >= MAX_TRAP_RECOVERIES) {
+            terminalTrapRecoveryError = new ZfbMdWasmTrapRecoveryLimitError(MAX_TRAP_RECOVERIES, cause);
+            instancePromise = undefined;
+            throw terminalTrapRecoveryError;
+        }
+        trapRecoveriesStarted += 1;
+        currentGeneration += 1;
+        await startInstance(currentGeneration);
+    }
+    async function callWasm(fn) {
+        const instance = await getInstance();
+        try {
+            return fn(instance);
+        }
+        catch (err) {
+            if (!isTrap(err)) {
+                throw err;
+            }
+            await recoverAfterTrap(instance.generation, err);
+            throw new ZfbMdWasmTrapError(err);
+        }
+    }
+    async function init() {
+        await getInstance();
+    }
+    // Public entry surfaces make missing calls unreachable. This guard keeps
+    // structural glue mismatches artifact-neutral and actionable.
+    function requireCapability(fn, name) {
+        if (!fn) {
+            throw new Error(`zfb-md-wasm: ${name}() is not available in this wasm artifact. ` +
+                `Import an entry whose artifact provides that capability.`);
+        }
+        return fn;
+    }
+    async function compile(source, options = {}) {
+        const optionsJson = JSON.stringify(options);
+        const json = await callWasm(({ glue }) => requireCapability(glue.compile, "compile").call(glue, source, optionsJson));
+        return JSON.parse(json);
+    }
+    async function renderHtml(source, options = {}) {
+        const optionsJson = JSON.stringify(options);
+        const json = await callWasm(({ glue }) => requireCapability(glue.renderHtml, "renderHtml").call(glue, source, optionsJson));
+        return JSON.parse(json);
+    }
+    /**
+     * Parse markdown/MDX into a raw mdast tree (zfb#1857, epic zfb#1854).
+     * The `parseToAst + JSON.parse` round trip here IS the product cost the
+     * epic's benchmark measures against remark-parse. See `types.ts`'s
+     * `ParseToAstResult`/`MdastNode` docs for the result shape and the
+     * UTF-16 position contract.
+     */
+    async function parseToAst(source, options = {}) {
+        const optionsJson = JSON.stringify(options);
+        const json = await callWasm(({ glue }) => requireCapability(glue.parseToAst, "parseToAst").call(glue, source, optionsJson));
+        return JSON.parse(json);
+    }
+    async function highlightCode(code, options) {
+        const optionsJson = JSON.stringify(options);
+        const json = await callWasm(({ glue }) => requireCapability(glue.highlightCode, "highlightCode").call(glue, code, optionsJson));
+        return JSON.parse(json);
+    }
+    async function version() {
+        return callWasm(({ glue }) => glue.version());
+    }
+    /** @internal Test-only hook that forces the current instance to trap. */
+    async function __forceTrapForTests() {
+        await callWasm(({ glue }) => glue.__forceTrapForTests());
+    }
+    /** @internal Test-only observability for the bounded recovery contract. */
+    function __getTrapRecoveryStateForTests() {
+        return {
+            compiledModuleLoads,
+            currentGeneration,
+            freshInstanceStarts,
+            glueImportAttempts,
+            maxTrapRecoveries: MAX_TRAP_RECOVERIES,
+            trapRecoveriesStarted,
+            terminal: !!terminalTrapRecoveryError,
+        };
+    }
+    return {
+        init,
+        compile,
+        renderHtml,
+        parseToAst,
+        highlightCode,
+        version,
+        __forceTrapForTests,
+        __getTrapRecoveryStateForTests,
+    };
+}
+//# sourceMappingURL=runtime-core.js.map

package/dist/runtime-core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-core.js","sourceRoot":"","sources":["../src/runtime-core.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  CompileResult,\n  HighlightCodeOptions,\n  HighlightCodeResult,\n  ParseToAstOptions,\n  ParseToAstResult,\n  RenderHtmlResult,\n  ZfbMdWasmOptions,\n} from \"./types.js\";\n\nexport interface WasmGlueModule {\n  // Keep this deliberately structural instead of importing the generated\n  // glue's declaration file. The browser entry imports that file as a *URL\n  // resource*, while the direct entry imports it dynamically. Both paths\n  // nevertheless use the same wasm-bindgen surface and recovery\n  // implementation below.\n  //\n  // Capability functions are structural and optional because each singleton\n  // artifact's wasm-bindgen glue contains only its selected Rust export.\n  // Public entries expose only the matching calls from `createWasmApi`.\n  initSync(input?: { module: WebAssembly.Module }): unknown;\n  compile?(source: string, optionsJson: string): string;\n  renderHtml?(source: string, optionsJson: string): string;\n  // Raw-mdast export (zfb#1857, epic zfb#1854).\n  parseToAst?(source: string, optionsJson: string): string;\n  highlightCode?(code: string, optionsJson: string): string;\n  version(): string;\n  __forceTrapForTests(): void;\n}\n\nexport class ZfbMdWasmTrapError extends Error {\n  constructor(cause: unknown) {\n    super(\n      \"zfb-md-wasm: the wasm instance trapped (a Rust panic or internal fault) and has been \" +\n        \"automatically re-instantiated. This is always a bug in zfb-md-wasm -- please report it \" +\n        \"with the input that triggered it.\",\n    );\n    this.name = \"ZfbMdWasmTrapError\";\n    this.cause = cause;\n  }\n}\n\nexport class ZfbMdWasmTrapRecoveryLimitError extends Error {\n  constructor(maxRecoveries: number, cause: unknown) {\n    super(\n      `zfb-md-wasm: wasm trap recovery limit reached after ${maxRecoveries} ` +\n        `successful re-instantiations. Further automatic recovery is disabled to avoid ` +\n        `unbounded recovery resource growth. Reload the JS realm before using zfb-md-wasm ` +\n        `again, and please report the input that triggered the repeated traps.`,\n    );\n    this.name = \"ZfbMdWasmTrapRecoveryLimitError\";\n    this.cause = cause;\n  }\n}\n\nexport interface WasmInstanceStrategy {\n  getModule(onLoad: () => void): Promise<WebAssembly.Module>;\n  createGlue(generation: number, attempt: number): WasmGlueModule | Promise<WasmGlueModule>;\n}\n\n/** Shared instance lifecycle and bounded trap recovery for URL and static entries. */\nexport function createWasmApiFromStrategy(strategy: WasmInstanceStrategy) {\n  const MAX_TRAP_RECOVERIES = 16;\n\n  let currentGeneration = 0;\n  let trapRecoveriesStarted = 0;\n  let freshInstanceStarts = 0;\n  // For the static strategy, glueImportAttempts counts createGlue calls.\n  let glueImportAttempts = 0;\n  let compiledModuleLoads = 0;\n  let terminalTrapRecoveryError: ZfbMdWasmTrapRecoveryLimitError | undefined;\n\n  interface Instance {\n    generation: number;\n    glue: WasmGlueModule;\n  }\n\n  /**\n   * Every fresh instance attempt creates new wasm-bindgen glue. The attempt\n   * counter is independent of the trap generation: transient glue/initSync\n   * failures must not consume the bounded trap-recovery budget.\n   */\n  async function freshInstance(generation: number): Promise<Instance> {\n    freshInstanceStarts += 1;\n    glueImportAttempts += 1;\n    const [module, glue] = await Promise.all([\n      strategy.getModule(() => {\n        compiledModuleLoads += 1;\n      }),\n      // A synchronous factory throw is a retryable instance rejection.\n      Promise.resolve().then(() => strategy.createGlue(generation, glueImportAttempts)),\n    ]);\n    glue.initSync({ module });\n    return { generation, glue };\n  }\n\n  let instancePromise: Promise<Instance> | undefined;\n\n  function startInstance(generation: number): Promise<Instance> {\n    const attempt = freshInstance(generation);\n    instancePromise = attempt;\n    void attempt.catch(() => {\n      // Trap recovery can replace the installed instance promise. Never let a\n      // stale initialization rejection clear that newer attempt.\n      if (instancePromise === attempt) {\n        instancePromise = undefined;\n      }\n    });\n    return attempt;\n  }\n\n  function getInstance(): Promise<Instance> {\n    if (terminalTrapRecoveryError) {\n      return Promise.reject(terminalTrapRecoveryError);\n    }\n    if (!instancePromise) {\n      return startInstance(currentGeneration);\n    }\n    return instancePromise;\n  }\n\n  function isTrap(err: unknown): boolean {\n    return typeof WebAssembly !== \"undefined\" && err instanceof WebAssembly.RuntimeError;\n  }\n\n  async function recoverAfterTrap(observedGeneration: number, cause: unknown): Promise<void> {\n    if (terminalTrapRecoveryError) {\n      throw terminalTrapRecoveryError;\n    }\n\n    // CAS-style single-flight: reporters for an already-replaced generation\n    // await its replacement instead of creating another glue instance.\n    if (observedGeneration !== currentGeneration) {\n      await getInstance();\n      return;\n    }\n\n    if (trapRecoveriesStarted >= MAX_TRAP_RECOVERIES) {\n      terminalTrapRecoveryError = new ZfbMdWasmTrapRecoveryLimitError(MAX_TRAP_RECOVERIES, cause);\n      instancePromise = undefined;\n      throw terminalTrapRecoveryError;\n    }\n\n    trapRecoveriesStarted += 1;\n    currentGeneration += 1;\n    await startInstance(currentGeneration);\n  }\n\n  async function callWasm<T>(fn: (instance: Instance) => T): Promise<T> {\n    const instance = await getInstance();\n    try {\n      return fn(instance);\n    } catch (err) {\n      if (!isTrap(err)) {\n        throw err;\n      }\n      await recoverAfterTrap(instance.generation, err);\n      throw new ZfbMdWasmTrapError(err);\n    }\n  }\n\n  async function init(): Promise<void> {\n    await getInstance();\n  }\n\n  // Public entry surfaces make missing calls unreachable. This guard keeps\n  // structural glue mismatches artifact-neutral and actionable.\n  function requireCapability<T>(fn: T | undefined, name: string): T {\n    if (!fn) {\n      throw new Error(\n        `zfb-md-wasm: ${name}() is not available in this wasm artifact. ` +\n          `Import an entry whose artifact provides that capability.`,\n      );\n    }\n    return fn;\n  }\n\n  async function compile(source: string, options: ZfbMdWasmOptions = {}): Promise<CompileResult> {\n    const optionsJson = JSON.stringify(options);\n    const json = await callWasm(({ glue }) =>\n      requireCapability(glue.compile, \"compile\").call(glue, source, optionsJson),\n    );\n    return JSON.parse(json) as CompileResult;\n  }\n\n  async function renderHtml(\n    source: string,\n    options: ZfbMdWasmOptions = {},\n  ): Promise<RenderHtmlResult> {\n    const optionsJson = JSON.stringify(options);\n    const json = await callWasm(({ glue }) =>\n      requireCapability(glue.renderHtml, \"renderHtml\").call(glue, source, optionsJson),\n    );\n    return JSON.parse(json) as RenderHtmlResult;\n  }\n\n  /**\n   * Parse markdown/MDX into a raw mdast tree (zfb#1857, epic zfb#1854).\n   * The `parseToAst + JSON.parse` round trip here IS the product cost the\n   * epic's benchmark measures against remark-parse. See `types.ts`'s\n   * `ParseToAstResult`/`MdastNode` docs for the result shape and the\n   * UTF-16 position contract.\n   */\n  async function parseToAst(\n    source: string,\n    options: ParseToAstOptions = {},\n  ): Promise<ParseToAstResult> {\n    const optionsJson = JSON.stringify(options);\n    const json = await callWasm(({ glue }) =>\n      requireCapability(glue.parseToAst, \"parseToAst\").call(glue, source, optionsJson),\n    );\n    return JSON.parse(json) as ParseToAstResult;\n  }\n\n  async function highlightCode(\n    code: string,\n    options: HighlightCodeOptions,\n  ): Promise<HighlightCodeResult> {\n    const optionsJson = JSON.stringify(options);\n    const json = await callWasm(({ glue }) =>\n      requireCapability(glue.highlightCode, \"highlightCode\").call(glue, code, optionsJson),\n    );\n    return JSON.parse(json) as HighlightCodeResult;\n  }\n\n  async function version(): Promise<string> {\n    return callWasm(({ glue }) => glue.version());\n  }\n\n  /** @internal Test-only hook that forces the current instance to trap. */\n  async function __forceTrapForTests(): Promise<void> {\n    await callWasm(({ glue }) => glue.__forceTrapForTests());\n  }\n\n  /** @internal Test-only observability for the bounded recovery contract. */\n  function __getTrapRecoveryStateForTests(): {\n    compiledModuleLoads: number;\n    currentGeneration: number;\n    freshInstanceStarts: number;\n    glueImportAttempts: number;\n    maxTrapRecoveries: number;\n    trapRecoveriesStarted: number;\n    terminal: boolean;\n  } {\n    return {\n      compiledModuleLoads,\n      currentGeneration,\n      freshInstanceStarts,\n      glueImportAttempts,\n      maxTrapRecoveries: MAX_TRAP_RECOVERIES,\n      trapRecoveriesStarted,\n      terminal: !!terminalTrapRecoveryError,\n    };\n  }\n\n  return {\n    init,\n    compile,\n    renderHtml,\n    parseToAst,\n    highlightCode,\n    version,\n    __forceTrapForTests,\n    __getTrapRecoveryStateForTests,\n  };\n}\n"]}

package/dist/runtime-static.d.ts

@@ -0,0 +1,25 @@
+import type { WasmGlueModule } from "./runtime-core.js";
+export { ZfbMdWasmTrapError, ZfbMdWasmTrapRecoveryLimitError } from "./runtime-core.js";
+export interface StaticWasmResourceConfig {
+    module: WebAssembly.Module | (() => WebAssembly.Module | Promise<WebAssembly.Module>);
+    createGlue(): WasmGlueModule;
+}
+/** Create fresh glue instances around one statically supplied compiled module. */
+export declare function createStaticWasmApi({ module, createGlue }: StaticWasmResourceConfig): {
+    init: () => Promise<void>;
+    compile: (source: string, options?: import("./types.js").ZfbMdWasmOptions) => Promise<import("./types.js").CompileResult>;
+    renderHtml: (source: string, options?: import("./types.js").ZfbMdWasmOptions) => Promise<import("./types.js").RenderHtmlResult>;
+    parseToAst: (source: string, options?: import("./types.js").ParseToAstOptions) => Promise<import("./types.js").ParseToAstResult>;
+    highlightCode: (code: string, options: import("./types.js").HighlightCodeOptions) => Promise<import("./types.js").HighlightCodeResult>;
+    version: () => Promise<string>;
+    __forceTrapForTests: () => Promise<void>;
+    __getTrapRecoveryStateForTests: () => {
+        compiledModuleLoads: number;
+        currentGeneration: number;
+        freshInstanceStarts: number;
+        glueImportAttempts: number;
+        maxTrapRecoveries: number;
+        trapRecoveriesStarted: number;
+        terminal: boolean;
+    };
+};

package/dist/runtime-static.js

@@ -0,0 +1,23 @@
+import { createWasmApiFromStrategy } from "./runtime-core.js";
+export { ZfbMdWasmTrapError, ZfbMdWasmTrapRecoveryLimitError } from "./runtime-core.js";
+/** Create fresh glue instances around one statically supplied compiled module. */
+export function createStaticWasmApi({ module, createGlue }) {
+    let modulePromise;
+    function getModule(onLoad) {
+        if (!modulePromise) {
+            onLoad();
+            const attempt = Promise.resolve().then(() => typeof module === "function" ? module() : module);
+            modulePromise = attempt;
+            void attempt.catch(() => {
+                if (modulePromise === attempt)
+                    modulePromise = undefined;
+            });
+        }
+        return modulePromise;
+    }
+    return createWasmApiFromStrategy({
+        getModule,
+        createGlue,
+    });
+}
+//# sourceMappingURL=runtime-static.js.map

package/dist/runtime-static.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-static.js","sourceRoot":"","sources":["../src/runtime-static.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAG9D,OAAO,EAAE,kBAAkB,EAAE,+BAA+B,EAAE,MAAM,mBAAmB,CAAC;AAOxF,kFAAkF;AAClF,MAAM,UAAU,mBAAmB,CAAC,EAAE,MAAM,EAAE,UAAU,EAA4B;IAClF,IAAI,aAAsD,CAAC;IAC3D,SAAS,SAAS,CAAC,MAAkB;QACnC,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,MAAM,EAAE,CAAC;YACT,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAC1C,OAAO,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,CACjD,CAAC;YACF,aAAa,GAAG,OAAO,CAAC;YACxB,KAAK,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE;gBACtB,IAAI,aAAa,KAAK,OAAO;oBAAE,aAAa,GAAG,SAAS,CAAC;YAC3D,CAAC,CAAC,CAAC;QACL,CAAC;QACD,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,OAAO,yBAAyB,CAAC;QAC/B,SAAS;QACT,UAAU;KACX,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { createWasmApiFromStrategy } from \"./runtime-core.js\";\nimport type { WasmGlueModule } from \"./runtime-core.js\";\n\nexport { ZfbMdWasmTrapError, ZfbMdWasmTrapRecoveryLimitError } from \"./runtime-core.js\";\n\nexport interface StaticWasmResourceConfig {\n  module: WebAssembly.Module | (() => WebAssembly.Module | Promise<WebAssembly.Module>);\n  createGlue(): WasmGlueModule;\n}\n\n/** Create fresh glue instances around one statically supplied compiled module. */\nexport function createStaticWasmApi({ module, createGlue }: StaticWasmResourceConfig) {\n  let modulePromise: Promise<WebAssembly.Module> | undefined;\n  function getModule(onLoad: () => void): Promise<WebAssembly.Module> {\n    if (!modulePromise) {\n      onLoad();\n      const attempt = Promise.resolve().then(() =>\n        typeof module === \"function\" ? module() : module,\n      );\n      modulePromise = attempt;\n      void attempt.catch(() => {\n        if (modulePromise === attempt) modulePromise = undefined;\n      });\n    }\n    return modulePromise;\n  }\n\n  return createWasmApiFromStrategy({\n    getModule,\n    createGlue,\n  });\n}\n"]}

package/dist/runtime.d.ts

@@ -1,15 +1,5 @@
-import type { CompileResult, HighlightCodeOptions, HighlightCodeResult, ParseToAstOptions, ParseToAstResult, RenderHtmlResult, ZfbMdWasmOptions } from "./types.js";
-interface WasmGlueModule {
-    initSync(input?: {
-        module: WebAssembly.Module;
-    }): unknown;
-    compile?(source: string, optionsJson: string): string;
-    renderHtml?(source: string, optionsJson: string): string;
-    parseToAst?(source: string, optionsJson: string): string;
-    highlightCode?(code: string, optionsJson: string): string;
-    version(): string;
-    __forceTrapForTests(): void;
-}
+import type { WasmGlueModule } from "./runtime-core.js";
+export { ZfbMdWasmTrapError, ZfbMdWasmTrapRecoveryLimitError } from "./runtime-core.js";
 export interface WasmResourceConfig {
     glueUrl: URL;
     loadWasmBytes(): Promise<ArrayBuffer>;
@@ -18,18 +8,13 @@ export interface WasmResourceConfig {
     /** @internal Deterministic test seam; production dynamically imports the glue URL. */
     importGlue?(specifier: string): Promise<WasmGlueModule>;
 }
-export declare class ZfbMdWasmTrapError extends Error {
-    constructor(cause: unknown);
-}
-export declare class ZfbMdWasmTrapRecoveryLimitError extends Error {
-    constructor(maxRecoveries: number, cause: unknown);
-}
+/** URL loading strategy used by the existing browser and direct entries. */
 export declare function createWasmApi({ glueUrl, loadWasmBytes, compileWasm, importGlue, }: WasmResourceConfig): {
     init: () => Promise<void>;
-    compile: (source: string, options?: ZfbMdWasmOptions) => Promise<CompileResult>;
-    renderHtml: (source: string, options?: ZfbMdWasmOptions) => Promise<RenderHtmlResult>;
-    parseToAst: (source: string, options?: ParseToAstOptions) => Promise<ParseToAstResult>;
-    highlightCode: (code: string, options: HighlightCodeOptions) => Promise<HighlightCodeResult>;
+    compile: (source: string, options?: import("./types.js").ZfbMdWasmOptions) => Promise<import("./types.js").CompileResult>;
+    renderHtml: (source: string, options?: import("./types.js").ZfbMdWasmOptions) => Promise<import("./types.js").RenderHtmlResult>;
+    parseToAst: (source: string, options?: import("./types.js").ParseToAstOptions) => Promise<import("./types.js").ParseToAstResult>;
+    highlightCode: (code: string, options: import("./types.js").HighlightCodeOptions) => Promise<import("./types.js").HighlightCodeResult>;
     version: () => Promise<string>;
     __forceTrapForTests: () => Promise<void>;
     __getTrapRecoveryStateForTests: () => {
@@ -42,4 +27,3 @@ export declare function createWasmApi({ glueUrl, loadWasmBytes, compileWasm, imp
         terminal: boolean;
     };
 };
-export {};

package/dist/runtime.js

@@ -1,191 +1,29 @@
-export class ZfbMdWasmTrapError extends Error {
-    constructor(cause) {
-        super("zfb-md-wasm: the wasm instance trapped (a Rust panic or internal fault) and has been " +
-            "automatically re-instantiated. This is always a bug in zfb-md-wasm -- please report it " +
-            "with the input that triggered it.");
-        this.name = "ZfbMdWasmTrapError";
-        this.cause = cause;
-    }
-}
-export class ZfbMdWasmTrapRecoveryLimitError extends Error {
-    constructor(maxRecoveries, cause) {
-        super(`zfb-md-wasm: wasm trap recovery limit reached after ${maxRecoveries} ` +
-            `successful re-instantiations. Further automatic recovery is disabled to avoid ` +
-            `unbounded ES module record growth. Reload the JS realm before using zfb-md-wasm ` +
-            `again, and please report the input that triggered the repeated traps.`);
-        this.name = "ZfbMdWasmTrapRecoveryLimitError";
-        this.cause = cause;
-    }
-}
+import { createWasmApiFromStrategy } from "./runtime-core.js";
+export { ZfbMdWasmTrapError, ZfbMdWasmTrapRecoveryLimitError } from "./runtime-core.js";
+/** URL loading strategy used by the existing browser and direct entries. */
 export function createWasmApi({ glueUrl, loadWasmBytes, compileWasm = (bytes) => WebAssembly.compile(bytes), importGlue = (specifier) => import(/* @vite-ignore */ specifier), }) {
     let compiledModulePromise;
-    let compiledModuleLoads = 0;
-    function getCompiledModule() {
+    function getModule(onLoad) {
         if (!compiledModulePromise) {
-            compiledModuleLoads += 1;
+            onLoad();
             const attempt = Promise.resolve().then(loadWasmBytes).then(compileWasm);
             compiledModulePromise = attempt;
             void attempt.catch(() => {
-                // A rejected attempt must be retryable, but it must not erase a newer
-                // attempt if its rejection cleanup runs late.
-                if (compiledModulePromise === attempt) {
+                // Only the rejected attempt may clear its own cache slot.
+                if (compiledModulePromise === attempt)
                     compiledModulePromise = undefined;
-                }
             });
         }
         return compiledModulePromise;
     }
-    const MAX_TRAP_RECOVERIES = 16;
-    let currentGeneration = 0;
-    let trapRecoveriesStarted = 0;
-    let freshInstanceStarts = 0;
-    let glueImportAttempts = 0;
-    let terminalTrapRecoveryError;
-    /**
-     * Every fresh instance attempt creates a new wasm-bindgen glue module
-     * record. The import-attempt nonce is deliberately independent of the trap
-     * generation: transient import/initSync failures need a new module record
-     * without consuming the bounded trap-recovery budget.
-     */
-    async function freshInstance(generation) {
-        freshInstanceStarts += 1;
-        glueImportAttempts += 1;
-        const glueSpecifier = new URL(glueUrl.href);
-        glueSpecifier.searchParams.set("zfbMdWasmGen", String(generation));
-        glueSpecifier.searchParams.set("zfbMdWasmAttempt", String(glueImportAttempts));
-        const [module, glue] = await Promise.all([
-            getCompiledModule(),
-            // Deferring the injected function also converts a synchronous test-seam
-            // throw into the rejection handled by the retryable instance cache.
-            Promise.resolve().then(() => importGlue(glueSpecifier.href)),
-        ]);
-        glue.initSync({ module });
-        return { generation, glue };
-    }
-    let instancePromise;
-    function startInstance(generation) {
-        const attempt = freshInstance(generation);
-        instancePromise = attempt;
-        void attempt.catch(() => {
-            // Trap recovery can replace the installed instance promise. Never let a
-            // stale initialization rejection clear that newer attempt.
-            if (instancePromise === attempt) {
-                instancePromise = undefined;
-            }
-        });
-        return attempt;
-    }
-    function getInstance() {
-        if (terminalTrapRecoveryError) {
-            return Promise.reject(terminalTrapRecoveryError);
-        }
-        if (!instancePromise) {
-            return startInstance(currentGeneration);
-        }
-        return instancePromise;
-    }
-    function isTrap(err) {
-        return typeof WebAssembly !== "undefined" && err instanceof WebAssembly.RuntimeError;
-    }
-    async function recoverAfterTrap(observedGeneration, cause) {
-        if (terminalTrapRecoveryError) {
-            throw terminalTrapRecoveryError;
-        }
-        // CAS-style single-flight: reporters for an already-replaced generation
-        // await its replacement instead of creating another glue module record.
-        if (observedGeneration !== currentGeneration) {
-            await getInstance();
-            return;
-        }
-        if (trapRecoveriesStarted >= MAX_TRAP_RECOVERIES) {
-            terminalTrapRecoveryError = new ZfbMdWasmTrapRecoveryLimitError(MAX_TRAP_RECOVERIES, cause);
-            instancePromise = undefined;
-            throw terminalTrapRecoveryError;
-        }
-        trapRecoveriesStarted += 1;
-        currentGeneration += 1;
-        await startInstance(currentGeneration);
-    }
-    async function callWasm(fn) {
-        const instance = await getInstance();
-        try {
-            return fn(instance);
-        }
-        catch (err) {
-            if (!isTrap(err)) {
-                throw err;
-            }
-            await recoverAfterTrap(instance.generation, err);
-            throw new ZfbMdWasmTrapError(err);
-        }
-    }
-    async function init() {
-        await getInstance();
-    }
-    // Public entry surfaces make missing calls unreachable. This guard keeps
-    // structural glue mismatches artifact-neutral and actionable.
-    function requireCapability(fn, name) {
-        if (!fn) {
-            throw new Error(`zfb-md-wasm: ${name}() is not available in this wasm artifact. ` +
-                `Import an entry whose artifact provides that capability.`);
-        }
-        return fn;
-    }
-    async function compile(source, options = {}) {
-        const optionsJson = JSON.stringify(options);
-        const json = await callWasm(({ glue }) => requireCapability(glue.compile, "compile").call(glue, source, optionsJson));
-        return JSON.parse(json);
-    }
-    async function renderHtml(source, options = {}) {
-        const optionsJson = JSON.stringify(options);
-        const json = await callWasm(({ glue }) => requireCapability(glue.renderHtml, "renderHtml").call(glue, source, optionsJson));
-        return JSON.parse(json);
-    }
-    /**
-     * Parse markdown/MDX into a raw mdast tree (zfb#1857, epic zfb#1854).
-     * The `parseToAst + JSON.parse` round trip here IS the product cost the
-     * epic's benchmark measures against remark-parse. See `types.ts`'s
-     * `ParseToAstResult`/`MdastNode` docs for the result shape and the
-     * UTF-16 position contract.
-     */
-    async function parseToAst(source, options = {}) {
-        const optionsJson = JSON.stringify(options);
-        const json = await callWasm(({ glue }) => requireCapability(glue.parseToAst, "parseToAst").call(glue, source, optionsJson));
-        return JSON.parse(json);
-    }
-    async function highlightCode(code, options) {
-        const optionsJson = JSON.stringify(options);
-        const json = await callWasm(({ glue }) => requireCapability(glue.highlightCode, "highlightCode").call(glue, code, optionsJson));
-        return JSON.parse(json);
-    }
-    async function version() {
-        return callWasm(({ glue }) => glue.version());
-    }
-    /** @internal Test-only hook that forces the current instance to trap. */
-    async function __forceTrapForTests() {
-        await callWasm(({ glue }) => glue.__forceTrapForTests());
-    }
-    /** @internal Test-only observability for the bounded recovery contract. */
-    function __getTrapRecoveryStateForTests() {
-        return {
-            compiledModuleLoads,
-            currentGeneration,
-            freshInstanceStarts,
-            glueImportAttempts,
-            maxTrapRecoveries: MAX_TRAP_RECOVERIES,
-            trapRecoveriesStarted,
-            terminal: !!terminalTrapRecoveryError,
-        };
-    }
-    return {
-        init,
-        compile,
-        renderHtml,
-        parseToAst,
-        highlightCode,
-        version,
-        __forceTrapForTests,
-        __getTrapRecoveryStateForTests,
-    };
+    return createWasmApiFromStrategy({
+        getModule,
+        createGlue(generation, attempt) {
+            const glueSpecifier = new URL(glueUrl.href);
+            glueSpecifier.searchParams.set("zfbMdWasmGen", String(generation));
+            glueSpecifier.searchParams.set("zfbMdWasmAttempt", String(attempt));
+            return importGlue(glueSpecifier.href);
+        },
+    });
 }
 //# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  CompileResult,\n  HighlightCodeOptions,\n  HighlightCodeResult,\n  ParseToAstOptions,\n  ParseToAstResult,\n  RenderHtmlResult,\n  ZfbMdWasmOptions,\n} from \"./types.js\";\n\ninterface WasmGlueModule {\n  // Keep this deliberately structural instead of importing the generated\n  // glue's declaration file. The browser entry imports that file as a *URL\n  // resource*, while the direct entry imports it dynamically. Both paths\n  // nevertheless use the same wasm-bindgen surface and recovery\n  // implementation below.\n  //\n  // Capability functions are structural and optional because each singleton\n  // artifact's wasm-bindgen glue contains only its selected Rust export.\n  // Public entries expose only the matching calls from `createWasmApi`.\n  initSync(input?: { module: WebAssembly.Module }): unknown;\n  compile?(source: string, optionsJson: string): string;\n  renderHtml?(source: string, optionsJson: string): string;\n  // Raw-mdast export (zfb#1857, epic zfb#1854).\n  parseToAst?(source: string, optionsJson: string): string;\n  highlightCode?(code: string, optionsJson: string): string;\n  version(): string;\n  __forceTrapForTests(): void;\n}\n\nexport interface WasmResourceConfig {\n  glueUrl: URL;\n  loadWasmBytes(): Promise<ArrayBuffer>;\n  /** @internal Deterministic test seam; production uses WebAssembly.compile. */\n  compileWasm?(bytes: ArrayBuffer): Promise<WebAssembly.Module>;\n  /** @internal Deterministic test seam; production dynamically imports the glue URL. */\n  importGlue?(specifier: string): Promise<WasmGlueModule>;\n}\n\nexport class ZfbMdWasmTrapError extends Error {\n  constructor(cause: unknown) {\n    super(\n      \"zfb-md-wasm: the wasm instance trapped (a Rust panic or internal fault) and has been \" +\n        \"automatically re-instantiated. This is always a bug in zfb-md-wasm -- please report it \" +\n        \"with the input that triggered it.\",\n    );\n    this.name = \"ZfbMdWasmTrapError\";\n    this.cause = cause;\n  }\n}\n\nexport class ZfbMdWasmTrapRecoveryLimitError extends Error {\n  constructor(maxRecoveries: number, cause: unknown) {\n    super(\n      `zfb-md-wasm: wasm trap recovery limit reached after ${maxRecoveries} ` +\n        `successful re-instantiations. Further automatic recovery is disabled to avoid ` +\n        `unbounded ES module record growth. Reload the JS realm before using zfb-md-wasm ` +\n        `again, and please report the input that triggered the repeated traps.`,\n    );\n    this.name = \"ZfbMdWasmTrapRecoveryLimitError\";\n    this.cause = cause;\n  }\n}\n\nexport function createWasmApi({\n  glueUrl,\n  loadWasmBytes,\n  compileWasm = (bytes) => WebAssembly.compile(bytes),\n  importGlue = (specifier) => import(/* @vite-ignore */ specifier) as Promise<WasmGlueModule>,\n}: WasmResourceConfig) {\n  let compiledModulePromise: Promise<WebAssembly.Module> | undefined;\n  let compiledModuleLoads = 0;\n\n  function getCompiledModule(): Promise<WebAssembly.Module> {\n    if (!compiledModulePromise) {\n      compiledModuleLoads += 1;\n      const attempt = Promise.resolve().then(loadWasmBytes).then(compileWasm);\n      compiledModulePromise = attempt;\n      void attempt.catch(() => {\n        // A rejected attempt must be retryable, but it must not erase a newer\n        // attempt if its rejection cleanup runs late.\n        if (compiledModulePromise === attempt) {\n          compiledModulePromise = undefined;\n        }\n      });\n    }\n    return compiledModulePromise;\n  }\n\n  const MAX_TRAP_RECOVERIES = 16;\n\n  let currentGeneration = 0;\n  let trapRecoveriesStarted = 0;\n  let freshInstanceStarts = 0;\n  let glueImportAttempts = 0;\n  let terminalTrapRecoveryError: ZfbMdWasmTrapRecoveryLimitError | undefined;\n\n  interface Instance {\n    generation: number;\n    glue: WasmGlueModule;\n  }\n\n  /**\n   * Every fresh instance attempt creates a new wasm-bindgen glue module\n   * record. The import-attempt nonce is deliberately independent of the trap\n   * generation: transient import/initSync failures need a new module record\n   * without consuming the bounded trap-recovery budget.\n   */\n  async function freshInstance(generation: number): Promise<Instance> {\n    freshInstanceStarts += 1;\n    glueImportAttempts += 1;\n    const glueSpecifier = new URL(glueUrl.href);\n    glueSpecifier.searchParams.set(\"zfbMdWasmGen\", String(generation));\n    glueSpecifier.searchParams.set(\"zfbMdWasmAttempt\", String(glueImportAttempts));\n    const [module, glue] = await Promise.all([\n      getCompiledModule(),\n      // Deferring the injected function also converts a synchronous test-seam\n      // throw into the rejection handled by the retryable instance cache.\n      Promise.resolve().then(() => importGlue(glueSpecifier.href)),\n    ]);\n    glue.initSync({ module });\n    return { generation, glue };\n  }\n\n  let instancePromise: Promise<Instance> | undefined;\n\n  function startInstance(generation: number): Promise<Instance> {\n    const attempt = freshInstance(generation);\n    instancePromise = attempt;\n    void attempt.catch(() => {\n      // Trap recovery can replace the installed instance promise. Never let a\n      // stale initialization rejection clear that newer attempt.\n      if (instancePromise === attempt) {\n        instancePromise = undefined;\n      }\n    });\n    return attempt;\n  }\n\n  function getInstance(): Promise<Instance> {\n    if (terminalTrapRecoveryError) {\n      return Promise.reject(terminalTrapRecoveryError);\n    }\n    if (!instancePromise) {\n      return startInstance(currentGeneration);\n    }\n    return instancePromise;\n  }\n\n  function isTrap(err: unknown): boolean {\n    return typeof WebAssembly !== \"undefined\" && err instanceof WebAssembly.RuntimeError;\n  }\n\n  async function recoverAfterTrap(observedGeneration: number, cause: unknown): Promise<void> {\n    if (terminalTrapRecoveryError) {\n      throw terminalTrapRecoveryError;\n    }\n\n    // CAS-style single-flight: reporters for an already-replaced generation\n    // await its replacement instead of creating another glue module record.\n    if (observedGeneration !== currentGeneration) {\n      await getInstance();\n      return;\n    }\n\n    if (trapRecoveriesStarted >= MAX_TRAP_RECOVERIES) {\n      terminalTrapRecoveryError = new ZfbMdWasmTrapRecoveryLimitError(MAX_TRAP_RECOVERIES, cause);\n      instancePromise = undefined;\n      throw terminalTrapRecoveryError;\n    }\n\n    trapRecoveriesStarted += 1;\n    currentGeneration += 1;\n    await startInstance(currentGeneration);\n  }\n\n  async function callWasm<T>(fn: (instance: Instance) => T): Promise<T> {\n    const instance = await getInstance();\n    try {\n      return fn(instance);\n    } catch (err) {\n      if (!isTrap(err)) {\n        throw err;\n      }\n      await recoverAfterTrap(instance.generation, err);\n      throw new ZfbMdWasmTrapError(err);\n    }\n  }\n\n  async function init(): Promise<void> {\n    await getInstance();\n  }\n\n  // Public entry surfaces make missing calls unreachable. This guard keeps\n  // structural glue mismatches artifact-neutral and actionable.\n  function requireCapability<T>(fn: T | undefined, name: string): T {\n    if (!fn) {\n      throw new Error(\n        `zfb-md-wasm: ${name}() is not available in this wasm artifact. ` +\n          `Import an entry whose artifact provides that capability.`,\n      );\n    }\n    return fn;\n  }\n\n  async function compile(source: string, options: ZfbMdWasmOptions = {}): Promise<CompileResult> {\n    const optionsJson = JSON.stringify(options);\n    const json = await callWasm(({ glue }) =>\n      requireCapability(glue.compile, \"compile\").call(glue, source, optionsJson),\n    );\n    return JSON.parse(json) as CompileResult;\n  }\n\n  async function renderHtml(\n    source: string,\n    options: ZfbMdWasmOptions = {},\n  ): Promise<RenderHtmlResult> {\n    const optionsJson = JSON.stringify(options);\n    const json = await callWasm(({ glue }) =>\n      requireCapability(glue.renderHtml, \"renderHtml\").call(glue, source, optionsJson),\n    );\n    return JSON.parse(json) as RenderHtmlResult;\n  }\n\n  /**\n   * Parse markdown/MDX into a raw mdast tree (zfb#1857, epic zfb#1854).\n   * The `parseToAst + JSON.parse` round trip here IS the product cost the\n   * epic's benchmark measures against remark-parse. See `types.ts`'s\n   * `ParseToAstResult`/`MdastNode` docs for the result shape and the\n   * UTF-16 position contract.\n   */\n  async function parseToAst(\n    source: string,\n    options: ParseToAstOptions = {},\n  ): Promise<ParseToAstResult> {\n    const optionsJson = JSON.stringify(options);\n    const json = await callWasm(({ glue }) =>\n      requireCapability(glue.parseToAst, \"parseToAst\").call(glue, source, optionsJson),\n    );\n    return JSON.parse(json) as ParseToAstResult;\n  }\n\n  async function highlightCode(\n    code: string,\n    options: HighlightCodeOptions,\n  ): Promise<HighlightCodeResult> {\n    const optionsJson = JSON.stringify(options);\n    const json = await callWasm(({ glue }) =>\n      requireCapability(glue.highlightCode, \"highlightCode\").call(glue, code, optionsJson),\n    );\n    return JSON.parse(json) as HighlightCodeResult;\n  }\n\n  async function version(): Promise<string> {\n    return callWasm(({ glue }) => glue.version());\n  }\n\n  /** @internal Test-only hook that forces the current instance to trap. */\n  async function __forceTrapForTests(): Promise<void> {\n    await callWasm(({ glue }) => glue.__forceTrapForTests());\n  }\n\n  /** @internal Test-only observability for the bounded recovery contract. */\n  function __getTrapRecoveryStateForTests(): {\n    compiledModuleLoads: number;\n    currentGeneration: number;\n    freshInstanceStarts: number;\n    glueImportAttempts: number;\n    maxTrapRecoveries: number;\n    trapRecoveriesStarted: number;\n    terminal: boolean;\n  } {\n    return {\n      compiledModuleLoads,\n      currentGeneration,\n      freshInstanceStarts,\n      glueImportAttempts,\n      maxTrapRecoveries: MAX_TRAP_RECOVERIES,\n      trapRecoveriesStarted,\n      terminal: !!terminalTrapRecoveryError,\n    };\n  }\n\n  return {\n    init,\n    compile,\n    renderHtml,\n    parseToAst,\n    highlightCode,\n    version,\n    __forceTrapForTests,\n    __getTrapRecoveryStateForTests,\n  };\n}\n"]}
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAG9D,OAAO,EAAE,kBAAkB,EAAE,+BAA+B,EAAE,MAAM,mBAAmB,CAAC;AAWxF,4EAA4E;AAC5E,MAAM,UAAU,aAAa,CAAC,EAC5B,OAAO,EACP,aAAa,EACb,WAAW,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,EACnD,UAAU,GAAG,CAAC,SAAS,EAAE,EAAE,CAAC,MAAM,CAAC,kBAAkB,CAAC,SAAS,CAA4B,GACxE;IACnB,IAAI,qBAA8D,CAAC;IACnE,SAAS,SAAS,CAAC,MAAkB;QACnC,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAC3B,MAAM,EAAE,CAAC;YACT,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACxE,qBAAqB,GAAG,OAAO,CAAC;YAChC,KAAK,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE;gBACtB,0DAA0D;gBAC1D,IAAI,qBAAqB,KAAK,OAAO;oBAAE,qBAAqB,GAAG,SAAS,CAAC;YAC3E,CAAC,CAAC,CAAC;QACL,CAAC;QACD,OAAO,qBAAqB,CAAC;IAC/B,CAAC;IAED,OAAO,yBAAyB,CAAC;QAC/B,SAAS;QACT,UAAU,CAAC,UAAU,EAAE,OAAO;YAC5B,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC5C,aAAa,CAAC,YAAY,CAAC,GAAG,CAAC,cAAc,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;YACnE,aAAa,CAAC,YAAY,CAAC,GAAG,CAAC,kBAAkB,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;YACpE,OAAO,UAAU,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QACxC,CAAC;KACF,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { createWasmApiFromStrategy } from \"./runtime-core.js\";\nimport type { WasmGlueModule } from \"./runtime-core.js\";\n\nexport { ZfbMdWasmTrapError, ZfbMdWasmTrapRecoveryLimitError } from \"./runtime-core.js\";\n\nexport interface WasmResourceConfig {\n  glueUrl: URL;\n  loadWasmBytes(): Promise<ArrayBuffer>;\n  /** @internal Deterministic test seam; production uses WebAssembly.compile. */\n  compileWasm?(bytes: ArrayBuffer): Promise<WebAssembly.Module>;\n  /** @internal Deterministic test seam; production dynamically imports the glue URL. */\n  importGlue?(specifier: string): Promise<WasmGlueModule>;\n}\n\n/** URL loading strategy used by the existing browser and direct entries. */\nexport function createWasmApi({\n  glueUrl,\n  loadWasmBytes,\n  compileWasm = (bytes) => WebAssembly.compile(bytes),\n  importGlue = (specifier) => import(/* @vite-ignore */ specifier) as Promise<WasmGlueModule>,\n}: WasmResourceConfig) {\n  let compiledModulePromise: Promise<WebAssembly.Module> | undefined;\n  function getModule(onLoad: () => void): Promise<WebAssembly.Module> {\n    if (!compiledModulePromise) {\n      onLoad();\n      const attempt = Promise.resolve().then(loadWasmBytes).then(compileWasm);\n      compiledModulePromise = attempt;\n      void attempt.catch(() => {\n        // Only the rejected attempt may clear its own cache slot.\n        if (compiledModulePromise === attempt) compiledModulePromise = undefined;\n      });\n    }\n    return compiledModulePromise;\n  }\n\n  return createWasmApiFromStrategy({\n    getModule,\n    createGlue(generation, attempt) {\n      const glueSpecifier = new URL(glueUrl.href);\n      glueSpecifier.searchParams.set(\"zfbMdWasmGen\", String(generation));\n      glueSpecifier.searchParams.set(\"zfbMdWasmAttempt\", String(attempt));\n      return importGlue(glueSpecifier.href);\n    },\n  });\n}\n"]}

package/dist/wasm-highlight/zfb_md_wasm_highlight_glue.zfb-factory.d.mts

@@ -0,0 +1,6 @@
+export function createGlue(): {
+  initSync(input: { module: WebAssembly.Module }): unknown;
+  highlightCode(code: string, optionsJson: string): string;
+  version(): string;
+  __forceTrapForTests(): void;
+};

package/dist/wasm-highlight/zfb_md_wasm_highlight_glue.zfb-factory.mjs

@@ -0,0 +1,201 @@
+export function createGlue() {
+/* @ts-self-types="./zfb_md_wasm_highlight.d.ts" */
+
+/**
+ * Deliberately trap the current WebAssembly instance for wrapper recovery
+ * tests. This is not part of the typed package API; the JavaScript wrapper
+ * exposes it only through its internal test hook.
+ *
+ * A Rust panic is the reliable cross-engine representation of the real
+ * failure this hook needs to exercise. Calling a generated raw C-ABI export
+ * with fabricated pointers could instead enter undefined Rust-level work and
+ * hang Chromium before reaching the wasm trap boundary.
+ */
+ function __forceTrapForTests() {
+    wasm.__forceTrapForTests();
+}
+
+/**
+ * Highlight arbitrary source into semantic class-mode HTML without requiring
+ * a Markdown fence. Exported to JavaScript as `highlightCode`.
+ *
+ * Returns `{ "html": string|null, "diagnostics": HighlightDiagnostic[] }`.
+ * Invalid options are structured errors; an unknown non-empty language or a
+ * tokenizer fallback returns escaped wrapper markup plus a warning.
+ * @param {string} code
+ * @param {string} options_json
+ * @returns {string}
+ */
+ function highlightCode(code, options_json) {
+    let deferred3_0;
+    let deferred3_1;
+    try {
+        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+        const ptr0 = passStringToWasm0(code, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(options_json, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+        const len1 = WASM_VECTOR_LEN;
+        wasm.highlightCode(retptr, ptr0, len0, ptr1, len1);
+        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+        deferred3_0 = r0;
+        deferred3_1 = r1;
+        return getStringFromWasm0(r0, r1);
+    } finally {
+        wasm.__wbindgen_add_to_stack_pointer(16);
+        wasm.__wbindgen_export3(deferred3_0, deferred3_1, 1);
+    }
+}
+
+/**
+ * This package's release version, stamped by CI at compile time.
+ *
+ * Development builds without `ZFB_RELEASE_VERSION` fall back to this crate's
+ * manifest version (`CARGO_PKG_VERSION`).
+ * @returns {string}
+ */
+ function version() {
+    let deferred1_0;
+    let deferred1_1;
+    try {
+        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+        wasm.version(retptr);
+        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+        deferred1_0 = r0;
+        deferred1_1 = r1;
+        return getStringFromWasm0(r0, r1);
+    } finally {
+        wasm.__wbindgen_add_to_stack_pointer(16);
+        wasm.__wbindgen_export3(deferred1_0, deferred1_1, 1);
+    }
+}
+function __wbg_get_imports() {
+    const import0 = {
+        __proto__: null,
+    };
+    return {
+        __proto__: null,
+        "./zfb_md_wasm_highlight_bg.js": import0,
+    };
+}
+
+let cachedDataViewMemory0 = null;
+function getDataViewMemory0() {
+    if (cachedDataViewMemory0 === null || cachedDataViewMemory0.buffer.detached === true || (cachedDataViewMemory0.buffer.detached === undefined && cachedDataViewMemory0.buffer !== wasm.memory.buffer)) {
+        cachedDataViewMemory0 = new DataView(wasm.memory.buffer);
+    }
+    return cachedDataViewMemory0;
+}
+
+function getStringFromWasm0(ptr, len) {
+    return decodeText(ptr >>> 0, len);
+}
+
+let cachedUint8ArrayMemory0 = null;
+function getUint8ArrayMemory0() {
+    if (cachedUint8ArrayMemory0 === null || cachedUint8ArrayMemory0.byteLength === 0) {
+        cachedUint8ArrayMemory0 = new Uint8Array(wasm.memory.buffer);
+    }
+    return cachedUint8ArrayMemory0;
+}
+
+function passStringToWasm0(arg, malloc, realloc) {
+    if (realloc === undefined) {
+        const buf = cachedTextEncoder.encode(arg);
+        const ptr = malloc(buf.length, 1) >>> 0;
+        getUint8ArrayMemory0().subarray(ptr, ptr + buf.length).set(buf);
+        WASM_VECTOR_LEN = buf.length;
+        return ptr;
+    }
+
+    let len = arg.length;
+    let ptr = malloc(len, 1) >>> 0;
+
+    const mem = getUint8ArrayMemory0();
+
+    let offset = 0;
+
+    for (; offset < len; offset++) {
+        const code = arg.charCodeAt(offset);
+        if (code > 0x7F) break;
+        mem[ptr + offset] = code;
+    }
+    if (offset !== len) {
+        if (offset !== 0) {
+            arg = arg.slice(offset);
+        }
+        ptr = realloc(ptr, len, len = offset + arg.length * 3, 1) >>> 0;
+        const view = getUint8ArrayMemory0().subarray(ptr + offset, ptr + len);
+        const ret = cachedTextEncoder.encodeInto(arg, view);
+
+        offset += ret.written;
+        ptr = realloc(ptr, len, offset, 1) >>> 0;
+    }
+
+    WASM_VECTOR_LEN = offset;
+    return ptr;
+}
+
+let cachedTextDecoder = new TextDecoder('utf-8', { ignoreBOM: true, fatal: true });
+cachedTextDecoder.decode();
+const MAX_SAFARI_DECODE_BYTES = 2146435072;
+let numBytesDecoded = 0;
+function decodeText(ptr, len) {
+    numBytesDecoded += len;
+    if (numBytesDecoded >= MAX_SAFARI_DECODE_BYTES) {
+        cachedTextDecoder = new TextDecoder('utf-8', { ignoreBOM: true, fatal: true });
+        cachedTextDecoder.decode();
+        numBytesDecoded = len;
+    }
+    return cachedTextDecoder.decode(getUint8ArrayMemory0().subarray(ptr, ptr + len));
+}
+
+const cachedTextEncoder = new TextEncoder();
+
+if (!('encodeInto' in cachedTextEncoder)) {
+    cachedTextEncoder.encodeInto = function (arg, view) {
+        const buf = cachedTextEncoder.encode(arg);
+        view.set(buf);
+        return {
+            read: arg.length,
+            written: buf.length
+        };
+    };
+}
+
+let WASM_VECTOR_LEN = 0;
+
+let wasmModule, wasmInstance, wasm;
+function __wbg_finalize_init(instance, module) {
+    wasmInstance = instance;
+    wasm = instance.exports;
+    wasmModule = module;
+    cachedDataViewMemory0 = null;
+    cachedUint8ArrayMemory0 = null;
+    return wasm;
+}
+
+
+
+function initSync(module) {
+    if (wasm !== undefined) return wasm;
+
+
+    if (module !== undefined) {
+        if (Object.getPrototypeOf(module) === Object.prototype) {
+            ({module} = module)
+        } else {
+            console.warn('using deprecated parameters for `initSync()`; pass a single object instead')
+        }
+    }
+
+    const imports = __wbg_get_imports();
+    if (!(module instanceof WebAssembly.Module)) {
+        module = new WebAssembly.Module(module);
+    }
+    const instance = new WebAssembly.Instance(module, imports);
+    return __wbg_finalize_init(instance, module);
+}
+  return { initSync, highlightCode, version, __forceTrapForTests };
+}

package/dist/wasm-parse/zfb_md_wasm_parse_glue.zfb-factory.d.mts

@@ -0,0 +1,6 @@
+export function createGlue(): {
+  initSync(input: { module: WebAssembly.Module }): unknown;
+  parseToAst(source: string, optionsJson: string): string;
+  version(): string;
+  __forceTrapForTests(): void;
+};

package/dist/wasm-parse/zfb_md_wasm_parse_glue.zfb-factory.mjs

@@ -0,0 +1,242 @@
+export function createGlue() {
+/* @ts-self-types="./zfb_md_wasm_parse.d.ts" */
+
+/**
+ * Deliberately trap the current WebAssembly instance for wrapper recovery
+ * tests. This is not part of the typed package API; the JavaScript wrapper
+ * exposes it only through its internal test hook.
+ *
+ * A Rust panic is the reliable cross-engine representation of the real
+ * failure this hook needs to exercise. Calling a generated raw C-ABI export
+ * with fabricated pointers could instead enter undefined Rust-level work and
+ * hang Chromium before reaching the wasm trap boundary.
+ */
+ function __forceTrapForTests() {
+    wasm.__forceTrapForTests();
+}
+
+/**
+ * Parse markdown/MDX source into a serialized RAW mdast tree — a
+ * supported API tier (zfb#1857, decided GO by epic zfb#1854 / zfb#1828).
+ * Exported to JS as `parseToAst`.
+ *
+ * Returns a JSON string: `{ "ast": mdast|null, "frontmatter": json,
+ * "diagnostics": Diagnostic[] }`. The tree is raw markdown-rs parser output
+ * converted through its serde shape into an open carrier, optionally
+ * composed with generic directives (post-frontmatter-strip,
+ * PRE-zfb-visitors — mdast, not hast, and
+ * unrecognized/custom constructs such as MDX JSX elements survive as typed
+ * nodes rather than being dropped), serialized in the unist shape via
+ * markdown-rs's `serde` feature, with every `position` shifted back into
+ * original-source coordinates (see [`shift_interop_positions`]). Its
+ * distinct closed options document accepts only `filename`, `dialect`,
+ * `directives`, and `pipeline.gfm`; compile/visitor/serializer knobs are
+ * rejected rather than silently ignored. A missing filename defaults to
+ * `<anonymous>.mdx`.
+ * Otherwise `.md` infers Markdown and `.mdx` infers MDX; an explicit dialect
+ * overrides either valid extension without waiving the extension gate.
+ *
+ * ## Position contract: UTF-16 code units (decided zfb#1856)
+ *
+ * `position.offset` and `position.column` are UTF-16 code-unit indices —
+ * remark/unist convention, and what `String.prototype.slice`,
+ * `mdast-util-to-hast`, and consumer mdast plugins already index by.
+ * `position.line` is unit-agnostic and needs no conversion. This matters on
+ * non-ASCII sources: a scalar value outside the Basic Multilingual Plane
+ * (most emoji) is 1 UTF-16 code unit different from its UTF-8 byte width
+ * (2 UTF-16 units vs. usually 4 bytes) — see [`Utf16Positions`] for the
+ * conversion and `tests/parse_to_ast.rs`'s
+ * `utf16_code_unit_semantics_are_pinned_on_non_ascii` for the pin. Pure-
+ * ASCII sources take a fast path that skips the conversion entirely (byte
+ * units already equal UTF-16 units there).
+ *
+ * ## Documented divergences from remark-parse / remark-mdx
+ *
+ * - `mdxJsxAttribute` records carry no `position` — markdown-rs does not
+ *   model attribute positions.
+ * - Top-level `import`/`export` degrade to paragraphs (no `mdxjsEsm` nodes
+ *   — markdown-rs's `mdx_esm_parse` needs a JS ESM parser the wasm boundary
+ *   cannot host), and MDX expressions carry no estree data (the default
+ *   aggressive mode validates braces only, unlike remark-mdx's acorn pass).
+ *   Consumers needing remark-mdx-equivalent ESM/estree keep remark for
+ *   those documents.
+ * - `_markdownRsStops` (on MDX expression/ESM nodes) is markdown-rs-
+ *   internal re-parse bookkeeping: internal, unstable, and BYTE-based (NOT
+ *   UTF-16 like `position`) — never slice a string with it.
+ * @param {string} source
+ * @param {string} options_json
+ * @returns {string}
+ */
+ function parseToAst(source, options_json) {
+    let deferred3_0;
+    let deferred3_1;
+    try {
+        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+        const ptr0 = passStringToWasm0(source, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(options_json, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+        const len1 = WASM_VECTOR_LEN;
+        wasm.parseToAst(retptr, ptr0, len0, ptr1, len1);
+        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+        deferred3_0 = r0;
+        deferred3_1 = r1;
+        return getStringFromWasm0(r0, r1);
+    } finally {
+        wasm.__wbindgen_add_to_stack_pointer(16);
+        wasm.__wbindgen_export3(deferred3_0, deferred3_1, 1);
+    }
+}
+
+/**
+ * This package's release version, stamped by CI at compile time.
+ *
+ * Development builds without `ZFB_RELEASE_VERSION` fall back to this crate's
+ * manifest version (`CARGO_PKG_VERSION`).
+ * @returns {string}
+ */
+ function version() {
+    let deferred1_0;
+    let deferred1_1;
+    try {
+        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+        wasm.version(retptr);
+        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+        deferred1_0 = r0;
+        deferred1_1 = r1;
+        return getStringFromWasm0(r0, r1);
+    } finally {
+        wasm.__wbindgen_add_to_stack_pointer(16);
+        wasm.__wbindgen_export3(deferred1_0, deferred1_1, 1);
+    }
+}
+function __wbg_get_imports() {
+    const import0 = {
+        __proto__: null,
+    };
+    return {
+        __proto__: null,
+        "./zfb_md_wasm_parse_bg.js": import0,
+    };
+}
+
+let cachedDataViewMemory0 = null;
+function getDataViewMemory0() {
+    if (cachedDataViewMemory0 === null || cachedDataViewMemory0.buffer.detached === true || (cachedDataViewMemory0.buffer.detached === undefined && cachedDataViewMemory0.buffer !== wasm.memory.buffer)) {
+        cachedDataViewMemory0 = new DataView(wasm.memory.buffer);
+    }
+    return cachedDataViewMemory0;
+}
+
+function getStringFromWasm0(ptr, len) {
+    return decodeText(ptr >>> 0, len);
+}
+
+let cachedUint8ArrayMemory0 = null;
+function getUint8ArrayMemory0() {
+    if (cachedUint8ArrayMemory0 === null || cachedUint8ArrayMemory0.byteLength === 0) {
+        cachedUint8ArrayMemory0 = new Uint8Array(wasm.memory.buffer);
+    }
+    return cachedUint8ArrayMemory0;
+}
+
+function passStringToWasm0(arg, malloc, realloc) {
+    if (realloc === undefined) {
+        const buf = cachedTextEncoder.encode(arg);
+        const ptr = malloc(buf.length, 1) >>> 0;
+        getUint8ArrayMemory0().subarray(ptr, ptr + buf.length).set(buf);
+        WASM_VECTOR_LEN = buf.length;
+        return ptr;
+    }
+
+    let len = arg.length;
+    let ptr = malloc(len, 1) >>> 0;
+
+    const mem = getUint8ArrayMemory0();
+
+    let offset = 0;
+
+    for (; offset < len; offset++) {
+        const code = arg.charCodeAt(offset);
+        if (code > 0x7F) break;
+        mem[ptr + offset] = code;
+    }
+    if (offset !== len) {
+        if (offset !== 0) {
+            arg = arg.slice(offset);
+        }
+        ptr = realloc(ptr, len, len = offset + arg.length * 3, 1) >>> 0;
+        const view = getUint8ArrayMemory0().subarray(ptr + offset, ptr + len);
+        const ret = cachedTextEncoder.encodeInto(arg, view);
+
+        offset += ret.written;
+        ptr = realloc(ptr, len, offset, 1) >>> 0;
+    }
+
+    WASM_VECTOR_LEN = offset;
+    return ptr;
+}
+
+let cachedTextDecoder = new TextDecoder('utf-8', { ignoreBOM: true, fatal: true });
+cachedTextDecoder.decode();
+const MAX_SAFARI_DECODE_BYTES = 2146435072;
+let numBytesDecoded = 0;
+function decodeText(ptr, len) {
+    numBytesDecoded += len;
+    if (numBytesDecoded >= MAX_SAFARI_DECODE_BYTES) {
+        cachedTextDecoder = new TextDecoder('utf-8', { ignoreBOM: true, fatal: true });
+        cachedTextDecoder.decode();
+        numBytesDecoded = len;
+    }
+    return cachedTextDecoder.decode(getUint8ArrayMemory0().subarray(ptr, ptr + len));
+}
+
+const cachedTextEncoder = new TextEncoder();
+
+if (!('encodeInto' in cachedTextEncoder)) {
+    cachedTextEncoder.encodeInto = function (arg, view) {
+        const buf = cachedTextEncoder.encode(arg);
+        view.set(buf);
+        return {
+            read: arg.length,
+            written: buf.length
+        };
+    };
+}
+
+let WASM_VECTOR_LEN = 0;
+
+let wasmModule, wasmInstance, wasm;
+function __wbg_finalize_init(instance, module) {
+    wasmInstance = instance;
+    wasm = instance.exports;
+    wasmModule = module;
+    cachedDataViewMemory0 = null;
+    cachedUint8ArrayMemory0 = null;
+    return wasm;
+}
+
+
+
+function initSync(module) {
+    if (wasm !== undefined) return wasm;
+
+
+    if (module !== undefined) {
+        if (Object.getPrototypeOf(module) === Object.prototype) {
+            ({module} = module)
+        } else {
+            console.warn('using deprecated parameters for `initSync()`; pass a single object instead')
+        }
+    }
+
+    const imports = __wbg_get_imports();
+    if (!(module instanceof WebAssembly.Module)) {
+        module = new WebAssembly.Module(module);
+    }
+    const instance = new WebAssembly.Instance(module, imports);
+    return __wbg_finalize_init(instance, module);
+}
+  return { initSync, parseToAst, version, __forceTrapForTests };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takazudo/zfb-md-wasm",
-  "version": "2.21.1",
+  "version": "2.22.1",
   "private": false,
   "type": "module",
   "description": "zfb's md/mdx -> JS/HTML conversion pipeline compiled to WebAssembly, for browser-side dynamic conversion (CMS live preview with parity to zfb's production output).",
@@ -35,6 +35,7 @@
     },
     "./highlight": {
       "types": "./dist/highlight.d.ts",
+      "workerd": "./dist/highlight-workerd.js",
       "browser": "./dist/highlight-browser.js",
       "default": "./dist/highlight.js"
     },
@@ -45,6 +46,7 @@
     },
     "./parse": {
       "types": "./dist/parse.d.ts",
+      "workerd": "./dist/parse-workerd.js",
       "browser": "./dist/parse-browser.js",
       "default": "./dist/parse.js"
     }
@@ -71,10 +73,11 @@
     "binaryen": "130.0.0",
     "esbuild": "0.27.7",
     "mdast-util-to-hast": "^13.2.1",
+    "miniflare": "4.20260424.0",
+    "remark-directive": "^4.0.0",
     "remark-gfm": "^4.0.1",
     "remark-mdx": "^3.1.1",
     "remark-parse": "^11.0.0",
-    "remark-directive": "^4.0.0",
     "typescript": "^5.9.0",
     "unified": "^11.0.5",
     "unist-util-visit": "^5.0.0",