@takazudo/zfb-md-wasm 2.7.1 → 2.9.0

package/README.md

@@ -22,7 +22,69 @@ binary directly.
 pnpm add @takazudo/zfb-md-wasm
 ```
 
-## Two API tiers
+## Choose an entry
+
+The package has four additive entries. Keep using `.` for the complete current
+API (`compile` plus render, parse, and highlight); root imports do not need a
+migration. `./highlight` is also backward-compatible. New `./render` and
+`./parse` entries are isolated **SWC-free** graphs: they omit `swc_core` and
+`zfb-render` but intentionally retain `zfb-content` and `syntect-fancy`.
+`./parse` is not syntect-free.
+
+| Entry | gzip-9 wasm (2.9.0) | Exact runtime values | Exact exported types |
+| --- | ---: | --- | --- |
+| `.` | 1,458,452 B | `init`, `compile`, `renderHtml`, `parseToAst`, `highlightCode`, `version`, `__forceTrapForTests`, `__getTrapRecoveryStateForTests`, `toMdastRoot`, `ZfbMdWasmTrapError`, `ZfbMdWasmTrapRecoveryLimitError`, `MdastAdapterError` | Full current compile/render/parse/raw-mdast/highlight surface |
+| `./highlight` | 758,246 B | `init`, `highlightCode`, `version`, `__forceTrapForTests`, `__getTrapRecoveryStateForTests`, `ZfbMdWasmTrapError`, `ZfbMdWasmTrapRecoveryLimitError` | `HighlightRole`, `HighlightCodeOptions`, `HighlightCodeResult`, `HighlightDiagnostic`, `HighlightDiagnosticSource` |
+| `./render` | 1,011,165 B | `init`, `renderHtml`, `version`, `ZfbMdWasmTrapError`, `ZfbMdWasmTrapRecoveryLimitError`, `__forceTrapForTests`, `__getTrapRecoveryStateForTests` | `RenderHtmlResult`, `Diagnostic`, `DiagnosticSource`, `ZfbMdWasmOptions`, `ParseDialect`, `PipelineOptions`, `GfmOptions`, `CodeHighlightMode`, `CodeHighlightOptions`, `MarkdownFeaturesConfig`, `JsxRuntime`, `HighlightRole` |
+| `./parse` | 276,437 B | `init`, `parseToAst`, `toMdastRoot`, `MdastAdapterError`, `version`, `ZfbMdWasmTrapError`, `ZfbMdWasmTrapRecoveryLimitError`, `__forceTrapForTests`, `__getTrapRecoveryStateForTests` | `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` |
+
+The focused entries own private resource pairs:
+
+```text
+wasm-render/zfb_md_wasm_render_glue.zfb-resource.mjs
+wasm-render/zfb_md_wasm_render_bg.wasm
+wasm-parse/zfb_md_wasm_parse_glue.zfb-resource.mjs
+wasm-parse/zfb_md_wasm_parse_bg.wasm
+```
+
+Each also has only its matching declaration sidecars. Every entry creates its
+own compiled-module, wasm-instance, generation, retry, and terminal state.
+Importing multiple entries intentionally loads independent pairs and instances;
+it does not deduplicate their resources.
+
+Migration is only needed when a root consumer calls one focused function:
+
+```ts
+// Direct Node import and browser-aware bundler import.
+import { renderHtml } from "@takazudo/zfb-md-wasm/render";
+import { parseToAst, toMdastRoot } from "@takazudo/zfb-md-wasm/parse";
+```
+
+For browser lazy loading, import from the user action. The conditional browser
+entry uses static URL edges for only that entry's own resource pair:
+
+```ts
+button.addEventListener("click", async () => {
+  const { renderHtml } = await import("@takazudo/zfb-md-wasm/render");
+  const { html } = await renderHtml(source, { filename: "preview.md" });
+  preview.innerHTML = html ?? "";
+});
+
+parseButton.addEventListener("click", async () => {
+  const { parseToAst, toMdastRoot } = await import("@takazudo/zfb-md-wasm/parse");
+  const parsed = await parseToAst(source, { filename: "preview.md" });
+  const root = parsed.ast === null ? null : toMdastRoot(parsed.ast);
+  inspect(root);
+});
+```
+
+`compile()` remains root-only. It returns module source, not an evaluated
+module; host evaluation must supply the JSX runtime and components. Controlled
+consumer code may interpret an already-parsed AST in a controlled AST-to-React
+renderer, but no slim entry evaluates author JavaScript. `renderHtml` is not a sanitizer and raw HTML remains
+untrusted; MDX JSX, expression, and ESM-shaped AST nodes are inert data.
+
+## Root API
 
 Both functions take the markdown/MDX `source` and an options object (every
 field optional; `{}` selects all defaults). Both return a result object plus a
@@ -72,14 +134,17 @@ plain-markdown preview when you don't need to evaluate a component module.
 ```ts
 import { renderHtml } from "@takazudo/zfb-md-wasm";
 
-const { html, frontmatter, diagnostics } = await renderHtml("# Heading\n\nSome **bold** text.\n", {
+const { html, frontmatter, diagnostics } = await renderHtml("Budget <8 ms\n", {
   filename: "post.md",
 });
-// html -> "<h1>Heading</h1><p>Some <strong>bold</strong> text.</p>"
+// html -> "<p>Budget &lt;8 ms</p>"
 ```
 
-`renderHtml` accepts and ignores `jsxRuntime` / `development`, so one options
-object can serve both tiers.
+`renderHtml` infers CommonMark for `.md` and MDX for `.mdx`; an explicit
+`dialect: "markdown" | "mdx"` overrides either valid extension. Omitting the
+filename uses `<anonymous>.md`, hence CommonMark. `compile` remains MDX-only
+and accepts/ignores `dialect`, while `renderHtml` accepts/ignores
+`jsxRuntime` / `development`, so one options object can serve both tiers.
 
 ### `version()` / `init()`
 
@@ -99,7 +164,7 @@ Shiki classes.
 
 If `highlightCode` is the only thing you use, import it from
 `@takazudo/zfb-md-wasm/highlight` instead of the package root — that entry
-ships a separate, much smaller wasm artifact with no `compile`/`renderHtml`
+ships a separate highlight-only wasm artifact with no `compile`/`renderHtml`
 (and no md/MDX/JSX pipeline behind them at all). Same function, same result
 shape, same `init()`/`version()`; see "Artifact size" below for the byte
 savings.
@@ -110,7 +175,7 @@ import {
   type HighlightCodeOptions,
   type HighlightCodeResult,
 } from "@takazudo/zfb-md-wasm";
-// or, for the smaller highlight-only artifact:
+// or, for the highlight-only artifact:
 // } from "@takazudo/zfb-md-wasm/highlight";
 
 const output: HighlightCodeResult = await highlightCode("const answer = 42;", {
@@ -403,25 +468,37 @@ for your own environment.
 
 ## Browser loading and emitted resources
 
-The package root has a `browser` export condition. Its browser entry imports
-the generated glue and Wasm binary through an explicit bundler `?url` asset
+Every entry has a `browser` export condition. Its browser entry imports the
+generated glue and Wasm binary through an explicit bundler `?url` asset
 contract. Vite and zfb's pinned esbuild setup therefore keep separate resource
-edges for exactly `zfb_md_wasm_glue.zfb-resource.mjs` and
-`zfb_md_wasm_bg.wasm`; a zfb production build emits them under hashed names:
+edges for exactly its own pair. The focused pairs are:
 
 ```text
-assets/islands-resource-zfb_md_wasm_glue.zfb-resource-<hash>.mjs
-assets/islands-resource-zfb_md_wasm_bg-<hash>.wasm
+wasm-render/zfb_md_wasm_render_glue.zfb-resource.mjs
+wasm-render/zfb_md_wasm_render_bg.wasm
+wasm-parse/zfb_md_wasm_parse_glue.zfb-resource.mjs
+wasm-parse/zfb_md_wasm_parse_bg.wasm
 ```
 
+Root and highlight retain their existing `wasm/` and `wasm-highlight/` pairs;
+each directory is closed with its matching glue/wasm declaration sidecars. A
+zfb production build emits each selected pair under hashed names.
+
 Keep the package import in a user action when first-load cost matters:
 
 ```ts
 button.addEventListener("click", async () => {
-  const { highlightCode } = await import("@takazudo/zfb-md-wasm");
-  const result = await highlightCode(editor.value, { language: "javascript" });
+  const { renderHtml } = await import("@takazudo/zfb-md-wasm/render");
+  const result = await renderHtml(editor.value, { filename: "preview.md" });
   preview.innerHTML = result.html ?? "";
 });
+
+parseButton.addEventListener("click", async () => {
+  const { parseToAst, toMdastRoot } = await import("@takazudo/zfb-md-wasm/parse");
+  const parsed = await parseToAst(editor.value, { filename: "preview.md" });
+  const root = parsed.ast === null ? null : toMdastRoot(parsed.ast);
+  inspect(root);
+});
 ```
 
 That import/call boundary keeps both resources unloaded before the action;
@@ -432,18 +509,17 @@ replace the static imports with source paths or manually copied resource
 files, which breaks the emitted URL graph. No Vite plugin, alias, or
 package-specific consumer configuration is required.
 
-The `./highlight` subpath (see "Artifact size" above) has the identical
-`browser` export condition and resource-loading contract, pointed at its own
-separate resources: `zfb_md_wasm_highlight_glue.zfb-resource.mjs` and
-`zfb_md_wasm_highlight_bg.wasm`. Importing `@takazudo/zfb-md-wasm` and
-`@takazudo/zfb-md-wasm/highlight` in the same bundle loads BOTH wasm
-artifacts — pick one entry per bundle.
+The `./highlight` subpath has the identical `browser` export condition and
+resource-loading contract, pointed at its own separate resources. Importing
+multiple entries in the same bundle intentionally loads each private pair and
+creates independent wasm state; no entry evicts or shares another's instance.
 
 ## Options shape
 
 ```ts
 interface ZfbMdWasmOptions {
   filename?: string; // must end .md/.mdx; drives frontmatter dispatch + diagnostics
+  dialect?: "markdown" | "mdx"; // renderHtml only; inferred from filename when absent
   jsxRuntime?: "preact" | "react"; // compile only; default "preact"
   development?: boolean; // compile only; default false
   pipeline?: {
@@ -574,9 +650,20 @@ alias.
 ## Node usage
 
 For tests and tooling, the package loads and runs under Node ≥ 20 with no extra
-setup — the same `compile` / `renderHtml` / `parseToAst` / `version` API. This
-is exactly how this package's own vitest suite (and `parseToAst`'s Node
-benchmark against `remark-parse`) exercises the wasm.
+setup. Direct imports select the resource pair that matches the operation:
+
+```ts
+import { renderHtml } from "@takazudo/zfb-md-wasm/render";
+import { parseToAst, toMdastRoot } from "@takazudo/zfb-md-wasm/parse";
+
+const { html } = await renderHtml("# Hello from Node\n");
+const parsed = await parseToAst("# Hello from Node\n", { filename: "post.md" });
+const root = parsed.ast === null ? null : toMdastRoot(parsed.ast);
+```
+
+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.
 
 ## Parity guarantee & limitations
 
@@ -593,37 +680,80 @@ suite gates exact-match). Deliberate limitations of the browser build:
 - **No cross-file features.** Route-table link resolution and cross-file anchor
   resolution need the whole project graph, which a single-document browser call
   doesn't have.
-- **The default artifact carries SWC even for `renderHtml`-only use.** One
-  cdylib can't tree-shake SWC away when only `renderHtml` is called; a slim
-  `renderHtml`-only artifact is a documented possible follow-up. If you only
-  ever call `highlightCode`, use the `./highlight` entry instead (see
-  "Artifact size" below) — it drops `compile`/`renderHtml` and the whole
-  md/MDX/JSX pipeline entirely.
-- **Grammar subsetting is not built.** Both artifacts ship every bundled
+- **Choose a focused artifact for non-compile calls.** The root remains the
+  compatibility entry and carries the complete compiler graph. `./highlight`
+  keeps its public API and resources while the post-#2449/#2450 graph is
+  proven SWC-free — and its payload shows it: 758,246 B gzip-9 versus
+  1,458,452 B for root. `./render` and `./parse` are also SWC-free and omit
+  `zfb-render`; parse intentionally retains `zfb-content`/`syntect-fancy`, so
+  it is not syntect-free. Use `./render` or `./parse` when a consumer does
+  not need `compile`; root and highlight callers otherwise require no
+  migration.
+- **`compile` is the execution boundary.** It returns ES-module source and
+  only the root entry exposes it. Host code must explicitly evaluate that
+  source and provide the JSX runtime/components. Controlled consumer code may
+  interpret an already-parsed AST; no slim entry evaluates author JavaScript.
+- **`renderHtml` is not a sanitizer.** Raw HTML remains untrusted, and JSX,
+  expression, or ESM-shaped AST nodes from MDX remain inert data.
+- **`renderHtml` selects syntax from the filename.** `.md` uses CommonMark,
+  `.mdx` uses MDX, and an explicit `dialect` overrides either valid extension.
+  `compile` remains MDX-only.
+- **Grammar subsetting is not built.** All four artifacts ship every bundled
   syntect grammar; there is no per-language allowlist knob.
 - **Syntax highlighting uses syntect's `fancy-regex` backend** (native zfb uses
   `oniguruma`, which can't compile to wasm). The two are byte-identical on
   zfb's fixture corpus; any grammar-level divergences are tracked in the
   crate's informational backend-divergence test.
 
-## Artifact size
-
-Shipping SWC in the bytes makes the default module large. The build applies a
-size-optimized cargo profile (`opt-level = "z"`, LTO, one codegen unit,
-`panic = "abort"`) plus `wasm-opt`, which roughly halves the raw binary either
-way. The package ships **two** wasm artifacts (zfb#1849, epic zfb#1845):
-
-| Entry          | Import                            | What it has                                           | Raw `.wasm` | Gzipped |
-| -------------- | --------------------------------- | ----------------------------------------------------- | ----------- | ------- |
-| Default        | `@takazudo/zfb-md-wasm`           | `compile` + `renderHtml` + `highlightCode`            | ~2.9 MB     | ~1.3 MB |
-| Highlight-only | `@takazudo/zfb-md-wasm/highlight` | `highlightCode` only (no md/MDX/JSX pipeline, no SWC) | ~1.4 MB     | ~0.7 MB |
-
-The highlight-only artifact drops the `pipeline` Cargo feature entirely (see
-`crates/zfb-md-wasm/Cargo.toml`) rather than subsetting syntect grammars —
-both artifacts bundle every grammar (see "Grammar subsetting is not built"
-above). The CI `wasm-md` job prints the authoritative gzipped size for BOTH
-artifacts on every run — treat that as the source of truth rather than this
-table, which can drift.
+## Artifact size and locked ceilings
+
+### Maintainer repair workflow
+
+These guarded size numbers use `crates/zfb-md-wasm/shipped-sizes.json` as their
+source of truth. After an intentional artifact change, use this verified
+three-step repair sequence:
+
+1. Re-run the four-artifact build and capture its summary:
+   `BUILD_LOG=/tmp/zfb-md-wasm-build.log; node crates/zfb-md-wasm/npm/scripts/build.mjs 2>&1 | tee "$BUILD_LOG"`.
+2. Run `node scripts/assert-zfb-md-wasm-budgets.mjs --build-log "$BUILD_LOG" --dist crates/zfb-md-wasm/npm/dist --update-manifest`.
+3. Run `node scripts/assert-md-wasm-size-docs.mjs --fix`, then `pnpm format:mdx`.
+
+These are the shipped **2.9.0** artifact rows — optimized final wasm after
+wasm-bindgen and wasm-opt, Node `gzipSync(..., { level: 9 })`, and glue
+bytes/gzip:
+
+| Entry/graph | final wasm | gzip-9 | glue | glue gzip-9 |
+| --- | ---: | ---: | ---: | ---: |
+| root (full) | 3,274,064 B | 1,458,452 B | 14,998 B | 4,199 B |
+| highlight | 1,476,740 B | 758,246 B | 8,758 B | 2,637 B |
+| render | 2,083,465 B | 1,011,165 B | 8,772 B | 2,661 B |
+| parse | 624,976 B | 276,437 B | 11,159 B | 3,797 B |
+
+The #2447 decision snapshot measured the split package at 3,638,607 B versus
+2,314,818 B for the root-plus-highlight package. Locked gzip-9 ceilings are
+root 1,600,000 B, highlight 820,000 B, render 1,100,000 B, and parse
+325,000 B; the complete packed tarball ceiling is 3,900,000 B. All four ship
+inside their ceilings, with 141,548 B (root), 61,754 B (highlight), 88,835 B
+(render), and 48,563 B (parse) of headroom. These are 2.9.0 measurements, not
+permanent promises — re-measure against the version you actually install.
+The clean four-step production ceiling is 210 seconds; the selected #2447
+median was 155.015 s [153.496, 165.977].
+
+Gating `swc_core` out of the highlight graph (#2449/#2450) was a
+**provability win, not a size win**. The shipped highlight artifact is only
+7,965 B smaller than #2447's SWC-retaining baseline (1,484,705 B →
+1,476,740 B; gzip-9 767,009 B → 758,244 B, −8,765 B) — wasm-opt was already
+dead-stripping the unreachable `swc_core`, and #2450's exact-parity and
+no-`swc_core` assertions turned that emergent property into a guaranteed one.
+The delta that matters to a highlight-only consumer is root versus
+highlight: the highlight artifact is 1,797,324 B smaller raw and 700,206 B
+smaller gzip-9, landing at about 45% of root's raw bytes and 52% of its
+gzipped bytes.
+
+Every shipped final wasm came in under its #2447 candidate measurement: root
+−62,869 B, highlight −7,965 B, render −39,844 B, parse −25,482 B. The glue
+rows moved the other way by a negligible amount (root +117 B, render +135 B,
+parse +18 B; highlight unchanged).
 
 ## Error / trap / re-init contract
 

package/dist/parse-browser.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.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-browser.js

@@ -0,0 +1,17 @@
+import glueHref from "./wasm-parse/zfb_md_wasm_parse_glue.zfb-resource.mjs?url";
+import wasmHref from "./wasm-parse/zfb_md_wasm_parse_bg.wasm?url";
+import { createWasmApi } from "./runtime.js";
+const GLUE_URL = new URL(glueHref, import.meta.url);
+const WASM_URL = new URL(wasmHref, import.meta.url);
+async function loadBrowserWasmBytes() {
+    const response = await fetch(WASM_URL);
+    if (!response.ok) {
+        throw new Error(`zfb-md-wasm: failed to fetch wasm binary: ${response.status} ${response.statusText}`);
+    }
+    return response.arrayBuffer();
+}
+const api = createWasmApi({ glueUrl: GLUE_URL, loadWasmBytes: loadBrowserWasmBytes });
+export const { init, parseToAst, version, __forceTrapForTests, __getTrapRecoveryStateForTests } = api;
+export { MdastAdapterError, toMdastRoot } from "./mdast.js";
+export { ZfbMdWasmTrapError, ZfbMdWasmTrapRecoveryLimitError } from "./runtime.js";
+//# sourceMappingURL=parse-browser.js.map

package/dist/parse-browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-browser.js","sourceRoot":"","sources":["../src/parse-browser.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,0DAA0D,CAAC;AAChF,OAAO,QAAQ,MAAM,4CAA4C,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACpD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEpD,KAAK,UAAU,oBAAoB;IACjC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,CAAC;IACvC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,6CAA6C,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CACtF,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC,WAAW,EAAE,CAAC;AAChC,CAAC;AAED,MAAM,GAAG,GAAG,aAAa,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,oBAAoB,EAAE,CAAC,CAAC;AAEtF,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,cAAc,CAAC","sourcesContent":["import glueHref from \"./wasm-parse/zfb_md_wasm_parse_glue.zfb-resource.mjs?url\";\nimport wasmHref from \"./wasm-parse/zfb_md_wasm_parse_bg.wasm?url\";\nimport { createWasmApi } from \"./runtime.js\";\n\nconst GLUE_URL = new URL(glueHref, import.meta.url);\nconst WASM_URL = new URL(wasmHref, import.meta.url);\n\nasync function loadBrowserWasmBytes(): Promise<ArrayBuffer> {\n  const response = await fetch(WASM_URL);\n  if (!response.ok) {\n    throw new Error(\n      `zfb-md-wasm: failed to fetch wasm binary: ${response.status} ${response.statusText}`,\n    );\n  }\n  return response.arrayBuffer();\n}\n\nconst api = createWasmApi({ glueUrl: GLUE_URL, loadWasmBytes: loadBrowserWasmBytes });\n\nexport const { init, parseToAst, version, __forceTrapForTests, __getTrapRecoveryStateForTests } =\n  api;\n\nexport { MdastAdapterError, toMdastRoot } from \"./mdast.js\";\nexport { ZfbMdWasmTrapError, ZfbMdWasmTrapRecoveryLimitError } from \"./runtime.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/parse.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.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.js

@@ -0,0 +1,23 @@
+import { createWasmApi } from "./runtime.js";
+const GLUE_URL = new URL("./wasm-parse/zfb_md_wasm_parse_glue.zfb-resource.mjs", import.meta.url);
+const WASM_URL = new URL("./wasm-parse/zfb_md_wasm_parse_bg.wasm", import.meta.url);
+async function loadDirectWasmBytes() {
+    if (typeof process !== "undefined" && process.versions?.node) {
+        const [{ readFile }, { fileURLToPath }] = await Promise.all([
+            import("node:fs/promises"),
+            import("node:url"),
+        ]);
+        const bytes = await readFile(fileURLToPath(WASM_URL));
+        return bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength);
+    }
+    const response = await fetch(WASM_URL);
+    if (!response.ok) {
+        throw new Error(`zfb-md-wasm: failed to fetch wasm binary: ${response.status} ${response.statusText}`);
+    }
+    return response.arrayBuffer();
+}
+const api = createWasmApi({ glueUrl: GLUE_URL, loadWasmBytes: loadDirectWasmBytes });
+export const { init, parseToAst, version, __forceTrapForTests, __getTrapRecoveryStateForTests } = api;
+export { MdastAdapterError, toMdastRoot } from "./mdast.js";
+export { ZfbMdWasmTrapError, ZfbMdWasmTrapRecoveryLimitError } from "./runtime.js";
+//# sourceMappingURL=parse.js.map

package/dist/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,sDAAsD,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClG,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,wCAAwC,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEpF,KAAK,UAAU,mBAAmB;IAChC,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;QAC7D,MAAM,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,aAAa,EAAE,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC1D,MAAM,CAAC,kBAAkB,CAAC;YAC1B,MAAM,CAAC,UAAU,CAAC;SACnB,CAAC,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC;QACtD,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAgB,CAAC;IAClG,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,CAAC;IACvC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,6CAA6C,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CACtF,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC,WAAW,EAAE,CAAC;AAChC,CAAC;AAED,MAAM,GAAG,GAAG,aAAa,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,mBAAmB,EAAE,CAAC,CAAC;AAErF,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,cAAc,CAAC","sourcesContent":["import { createWasmApi } from \"./runtime.js\";\n\nconst GLUE_URL = new URL(\"./wasm-parse/zfb_md_wasm_parse_glue.zfb-resource.mjs\", import.meta.url);\nconst WASM_URL = new URL(\"./wasm-parse/zfb_md_wasm_parse_bg.wasm\", import.meta.url);\n\nasync function loadDirectWasmBytes(): Promise<ArrayBuffer> {\n  if (typeof process !== \"undefined\" && process.versions?.node) {\n    const [{ readFile }, { fileURLToPath }] = await Promise.all([\n      import(\"node:fs/promises\"),\n      import(\"node:url\"),\n    ]);\n    const bytes = await readFile(fileURLToPath(WASM_URL));\n    return bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength) as ArrayBuffer;\n  }\n  const response = await fetch(WASM_URL);\n  if (!response.ok) {\n    throw new Error(\n      `zfb-md-wasm: failed to fetch wasm binary: ${response.status} ${response.statusText}`,\n    );\n  }\n  return response.arrayBuffer();\n}\n\nconst api = createWasmApi({ glueUrl: GLUE_URL, loadWasmBytes: loadDirectWasmBytes });\n\nexport const { init, parseToAst, version, __forceTrapForTests, __getTrapRecoveryStateForTests } =\n  api;\n\nexport { MdastAdapterError, toMdastRoot } from \"./mdast.js\";\nexport { ZfbMdWasmTrapError, ZfbMdWasmTrapRecoveryLimitError } from \"./runtime.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/render-browser.d.ts

@@ -0,0 +1,11 @@
+export declare const init: () => Promise<void>, renderHtml: (source: string, options?: import("./types.js").ZfbMdWasmOptions) => Promise<import("./types.js").RenderHtmlResult>, 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.js";
+export type { RenderHtmlResult, Diagnostic, DiagnosticSource, ZfbMdWasmOptions, ParseDialect, PipelineOptions, GfmOptions, CodeHighlightMode, CodeHighlightOptions, MarkdownFeaturesConfig, JsxRuntime, HighlightRole, } from "./types.js";

package/dist/render-browser.js

@@ -0,0 +1,16 @@
+import glueHref from "./wasm-render/zfb_md_wasm_render_glue.zfb-resource.mjs?url";
+import wasmHref from "./wasm-render/zfb_md_wasm_render_bg.wasm?url";
+import { createWasmApi } from "./runtime.js";
+const GLUE_URL = new URL(glueHref, import.meta.url);
+const WASM_URL = new URL(wasmHref, import.meta.url);
+async function loadBrowserWasmBytes() {
+    const response = await fetch(WASM_URL);
+    if (!response.ok) {
+        throw new Error(`zfb-md-wasm: failed to fetch wasm binary: ${response.status} ${response.statusText}`);
+    }
+    return response.arrayBuffer();
+}
+const api = createWasmApi({ glueUrl: GLUE_URL, loadWasmBytes: loadBrowserWasmBytes });
+export const { init, renderHtml, version, __forceTrapForTests, __getTrapRecoveryStateForTests } = api;
+export { ZfbMdWasmTrapError, ZfbMdWasmTrapRecoveryLimitError } from "./runtime.js";
+//# sourceMappingURL=render-browser.js.map

package/dist/render-browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-browser.js","sourceRoot":"","sources":["../src/render-browser.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,4DAA4D,CAAC;AAClF,OAAO,QAAQ,MAAM,8CAA8C,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACpD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEpD,KAAK,UAAU,oBAAoB;IACjC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,CAAC;IACvC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,6CAA6C,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CACtF,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC,WAAW,EAAE,CAAC;AAChC,CAAC;AAED,MAAM,GAAG,GAAG,aAAa,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,oBAAoB,EAAE,CAAC,CAAC;AAEtF,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,mBAAmB,EAAE,8BAA8B,EAAE,GAC7F,GAAG,CAAC;AAEN,OAAO,EAAE,kBAAkB,EAAE,+BAA+B,EAAE,MAAM,cAAc,CAAC","sourcesContent":["import glueHref from \"./wasm-render/zfb_md_wasm_render_glue.zfb-resource.mjs?url\";\nimport wasmHref from \"./wasm-render/zfb_md_wasm_render_bg.wasm?url\";\nimport { createWasmApi } from \"./runtime.js\";\n\nconst GLUE_URL = new URL(glueHref, import.meta.url);\nconst WASM_URL = new URL(wasmHref, import.meta.url);\n\nasync function loadBrowserWasmBytes(): Promise<ArrayBuffer> {\n  const response = await fetch(WASM_URL);\n  if (!response.ok) {\n    throw new Error(\n      `zfb-md-wasm: failed to fetch wasm binary: ${response.status} ${response.statusText}`,\n    );\n  }\n  return response.arrayBuffer();\n}\n\nconst api = createWasmApi({ glueUrl: GLUE_URL, loadWasmBytes: loadBrowserWasmBytes });\n\nexport const { init, renderHtml, version, __forceTrapForTests, __getTrapRecoveryStateForTests } =\n  api;\n\nexport { ZfbMdWasmTrapError, ZfbMdWasmTrapRecoveryLimitError } from \"./runtime.js\";\nexport type {\n  RenderHtmlResult,\n  Diagnostic,\n  DiagnosticSource,\n  ZfbMdWasmOptions,\n  ParseDialect,\n  PipelineOptions,\n  GfmOptions,\n  CodeHighlightMode,\n  CodeHighlightOptions,\n  MarkdownFeaturesConfig,\n  JsxRuntime,\n  HighlightRole,\n} from \"./types.js\";\n"]}

package/dist/render.d.ts

@@ -0,0 +1,11 @@
+export declare const init: () => Promise<void>, renderHtml: (source: string, options?: import("./types.js").ZfbMdWasmOptions) => Promise<import("./types.js").RenderHtmlResult>, 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.js";
+export type { RenderHtmlResult, Diagnostic, DiagnosticSource, ZfbMdWasmOptions, ParseDialect, PipelineOptions, GfmOptions, CodeHighlightMode, CodeHighlightOptions, MarkdownFeaturesConfig, JsxRuntime, HighlightRole, } from "./types.js";

package/dist/render.js

@@ -0,0 +1,22 @@
+import { createWasmApi } from "./runtime.js";
+const GLUE_URL = new URL("./wasm-render/zfb_md_wasm_render_glue.zfb-resource.mjs", import.meta.url);
+const WASM_URL = new URL("./wasm-render/zfb_md_wasm_render_bg.wasm", import.meta.url);
+async function loadDirectWasmBytes() {
+    if (typeof process !== "undefined" && process.versions?.node) {
+        const [{ readFile }, { fileURLToPath }] = await Promise.all([
+            import("node:fs/promises"),
+            import("node:url"),
+        ]);
+        const bytes = await readFile(fileURLToPath(WASM_URL));
+        return bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength);
+    }
+    const response = await fetch(WASM_URL);
+    if (!response.ok) {
+        throw new Error(`zfb-md-wasm: failed to fetch wasm binary: ${response.status} ${response.statusText}`);
+    }
+    return response.arrayBuffer();
+}
+const api = createWasmApi({ glueUrl: GLUE_URL, loadWasmBytes: loadDirectWasmBytes });
+export const { init, renderHtml, version, __forceTrapForTests, __getTrapRecoveryStateForTests } = api;
+export { ZfbMdWasmTrapError, ZfbMdWasmTrapRecoveryLimitError } from "./runtime.js";
+//# sourceMappingURL=render.js.map

package/dist/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,wDAAwD,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACpG,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,0CAA0C,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEtF,KAAK,UAAU,mBAAmB;IAChC,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;QAC7D,MAAM,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,aAAa,EAAE,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC1D,MAAM,CAAC,kBAAkB,CAAC;YAC1B,MAAM,CAAC,UAAU,CAAC;SACnB,CAAC,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC;QACtD,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAgB,CAAC;IAClG,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,CAAC;IACvC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,6CAA6C,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CACtF,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC,WAAW,EAAE,CAAC;AAChC,CAAC;AAED,MAAM,GAAG,GAAG,aAAa,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,mBAAmB,EAAE,CAAC,CAAC;AAErF,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,mBAAmB,EAAE,8BAA8B,EAAE,GAC7F,GAAG,CAAC;AAEN,OAAO,EAAE,kBAAkB,EAAE,+BAA+B,EAAE,MAAM,cAAc,CAAC","sourcesContent":["import { createWasmApi } from \"./runtime.js\";\n\nconst GLUE_URL = new URL(\"./wasm-render/zfb_md_wasm_render_glue.zfb-resource.mjs\", import.meta.url);\nconst WASM_URL = new URL(\"./wasm-render/zfb_md_wasm_render_bg.wasm\", import.meta.url);\n\nasync function loadDirectWasmBytes(): Promise<ArrayBuffer> {\n  if (typeof process !== \"undefined\" && process.versions?.node) {\n    const [{ readFile }, { fileURLToPath }] = await Promise.all([\n      import(\"node:fs/promises\"),\n      import(\"node:url\"),\n    ]);\n    const bytes = await readFile(fileURLToPath(WASM_URL));\n    return bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength) as ArrayBuffer;\n  }\n  const response = await fetch(WASM_URL);\n  if (!response.ok) {\n    throw new Error(\n      `zfb-md-wasm: failed to fetch wasm binary: ${response.status} ${response.statusText}`,\n    );\n  }\n  return response.arrayBuffer();\n}\n\nconst api = createWasmApi({ glueUrl: GLUE_URL, loadWasmBytes: loadDirectWasmBytes });\n\nexport const { init, renderHtml, version, __forceTrapForTests, __getTrapRecoveryStateForTests } =\n  api;\n\nexport { ZfbMdWasmTrapError, ZfbMdWasmTrapRecoveryLimitError } from \"./runtime.js\";\nexport type {\n  RenderHtmlResult,\n  Diagnostic,\n  DiagnosticSource,\n  ZfbMdWasmOptions,\n  ParseDialect,\n  PipelineOptions,\n  GfmOptions,\n  CodeHighlightMode,\n  CodeHighlightOptions,\n  MarkdownFeaturesConfig,\n  JsxRuntime,\n  HighlightRole,\n} from \"./types.js\";\n"]}

package/dist/runtime.d.ts

@@ -6,7 +6,7 @@ interface WasmGlueModule {
     compile?(source: string, optionsJson: string): string;
     renderHtml?(source: string, optionsJson: string): string;
     parseToAst?(source: string, optionsJson: string): string;
-    highlightCode(code: string, optionsJson: string): string;
+    highlightCode?(code: string, optionsJson: string): string;
     version(): string;
     __forceTrapForTests(): void;
 }

package/dist/runtime.js

@@ -122,26 +122,23 @@ export function createWasmApi({ glueUrl, loadWasmBytes, compileWasm = (bytes) =>
     async function init() {
         await getInstance();
     }
-    // Both throw helpers below fire only if `compile`/`renderHtml` were
-    // somehow invoked against the highlight-only glue -- unreachable through
-    // the public API surface, since `src/highlight.ts`/`src/highlight-browser.ts`
-    // never re-export these two functions. Kept as a clear runtime error
-    // rather than a silent `undefined()` crash.
-    function requirePipelineExport(fn, name) {
+    // 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 the highlight-only wasm artifact ` +
-                `(built with the \`pipeline\` Cargo feature off) -- use the default \`.\` entry instead.`);
+            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 }) => requirePipelineExport(glue.compile, "compile").call(glue, source, optionsJson));
+        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 }) => requirePipelineExport(glue.renderHtml, "renderHtml").call(glue, source, optionsJson));
+        const json = await callWasm(({ glue }) => requireCapability(glue.renderHtml, "renderHtml").call(glue, source, optionsJson));
         return JSON.parse(json);
     }
     /**
@@ -153,12 +150,12 @@ export function createWasmApi({ glueUrl, loadWasmBytes, compileWasm = (bytes) =>
      */
     async function parseToAst(source, options = {}) {
         const optionsJson = JSON.stringify(options);
-        const json = await callWasm(({ glue }) => requirePipelineExport(glue.parseToAst, "parseToAst").call(glue, source, optionsJson));
+        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 }) => glue.highlightCode(code, optionsJson));
+        const json = await callWasm(({ glue }) => requireCapability(glue.highlightCode, "highlightCode").call(glue, code, optionsJson));
         return JSON.parse(json);
     }
     async function version() {