@takazudo/zfb-md-wasm 2.7.0 → 2.8.0

package/dist/types.d.ts

@@ -6,7 +6,7 @@ export interface GfmOptions {
     taskListItem?: boolean;
     footnoteDefinition?: boolean;
 }
-/** Base syntax selected by `parseToAst`. */
+/** Base syntax selected by `parseToAst` and `renderHtml`. */
 export type ParseDialect = "markdown" | "mdx";
 /** How `parseToAst` handles recognized YAML frontmatter. */
 export type FrontmatterPolicy = "extract" | "node" | "none";
@@ -109,6 +109,11 @@ export interface ZfbMdWasmOptions {
      * `<anonymous>.md` for `renderHtml`.
      */
     filename?: string;
+    /**
+     * Consumed only by `renderHtml`; `compile` accepts and ignores it.
+     * Without an override, `.md` selects CommonMark and `.mdx` selects MDX.
+     */
+    dialect?: ParseDialect;
     /** Consumed only by `compile`; `renderHtml` accepts and ignores it. */
     jsxRuntime?: JsxRuntime;
     /** Consumed only by `compile`; `renderHtml` accepts and ignores it. */

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,2EAA2E;AAC3E,qEAAqE;AACrE,gCAAgC","sourcesContent":["// Mirrors the JSON contracts of the `zfb-md-wasm` Rust crate (zfb#1576)\n// literally -- see that crate's `src/lib.rs` rustdoc for the authoritative\n// shape. Keep this file in lock-step with the crate when the crate's\n// options/result shapes change.\n\n/** `zfb_content::facade::PipelineOptions`'s `gfm` sub-object, verbatim. */\nexport interface GfmOptions {\n  strikethrough?: boolean;\n  table?: boolean;\n  autolinkLiteral?: boolean;\n  taskListItem?: boolean;\n  footnoteDefinition?: boolean;\n}\n\n/** Base syntax selected by `parseToAst`. */\nexport type ParseDialect = \"markdown\" | \"mdx\";\n\n/** How `parseToAst` handles recognized YAML frontmatter. */\nexport type FrontmatterPolicy = \"extract\" | \"node\" | \"none\";\n\n/** Raw-parser pipeline options. Visitor/serializer options are not accepted. */\nexport interface ParsePipelineOptions {\n  gfm?: GfmOptions;\n}\n\n/**\n * The distinct, closed options document consumed by `parseToAst`.\n *\n * `filename` must end in lowercase `.md` or `.mdx`. With no explicit\n * `dialect`, `.md` selects CommonMark and `.mdx` selects MDX; omitting the\n * filename uses `<anonymous>.mdx`, hence MDX. An explicit dialect overrides\n * either valid extension but does not waive that extension gate.\n */\nexport interface ParseToAstOptions {\n  filename?: string;\n  dialect?: ParseDialect;\n  /** Parse generic remark-directive syntax. Default: `false`. */\n  directives?: boolean;\n  /**\n   * YAML handling policy. Default: `\"extract\"`.\n   *\n   * - `extract`: parse the stripped body, return YAML as JSON, no YAML node;\n   * - `node`: parse the full logical source, return JSON plus canonical YAML node;\n   * - `none`: parse every logical-source byte as Markdown/MDX and always return null.\n   *\n   * Malformed/unterminated YAML fails `extract`/`node` with one\n   * `frontmatter` diagnostic; `none` never produces a YAML diagnostic.\n   */\n  frontmatter?: FrontmatterPolicy;\n  pipeline?: ParsePipelineOptions;\n}\n\n/**\n * `MarkdownFeaturesConfig` (see `crates/zfb-md-ast/src/features_config.rs`).\n * Left as an open record here -- the wasm boundary passes it through to the\n * Rust `deny_unknown_fields` deserializer verbatim, which is the\n * authoritative validator for its keys.\n */\nexport type MarkdownFeaturesConfig = Record<string, unknown>;\n\n/**\n * `zfb_content::facade::CodeHighlightOptions`'s `mode` field -- mirrors the\n * `\"inline\"` / `\"class\"` string-literal union in native `zfb.config.ts`\n * (`CodeHighlightConfig.mode`).\n */\nexport type CodeHighlightMode = \"inline\" | \"class\";\n\n/**\n * `zfb_content::facade::CodeHighlightOptions`, verbatim (Highlight Tokens\n * epic zfb#1528, wasm routing sub zfb#1852).\n */\nexport interface CodeHighlightOptions {\n  /** Output mode for fenced-code highlighting. Defaults to `\"inline\"` --\n   * reproduces the pre-existing per-token inline-color behaviour\n   * byte-for-byte. */\n  mode?: CodeHighlightMode;\n  /** Class-name prefix for class-mode role classes (e.g. the default\n   * `\"hi-\"` yields `hi-kw`, `hi-str`, ...). Only meaningful when `mode` is\n   * `\"class\"`. */\n  classPrefix?: string;\n  /** Per-role class overrides for class mode. Absent or `null` uses\n   * `{classPrefix}{role}` for every role. Only meaningful when `mode` is\n   * `\"class\"`. */\n  roleClasses?: Partial<Record<HighlightRole, string>> | null;\n}\n\n/** `zfb_content::facade::PipelineOptions`, verbatim. */\nexport interface PipelineOptions {\n  /**\n   * A syntect theme name. Absent, or explicit `null`, keeps the built-in\n   * default theme (`base16-ocean.dark`) -- fenced code is ALWAYS\n   * highlighted through this field; there is no \"no syntax highlighting\"\n   * value (this comment previously claimed `null` meant no highlighting,\n   * which was never true of the Rust deserializer -- corrected in\n   * zfb#1852). Mutually exclusive with `codeHighlight.mode: \"class\"`.\n   */\n  theme?: string | null;\n  gfm?: GfmOptions;\n  cjkFriendly?: boolean;\n  hardBreaks?: boolean;\n  /**\n   * Output mode + class-mode knobs for fenced-code highlighting\n   * (Highlight Tokens epic zfb#1528). Absent, `null`, or\n   * `{ mode: \"inline\" }` reproduce the pre-existing inline-color\n   * behaviour byte-for-byte. `{ mode: \"class\" }` is mutually exclusive\n   * with a top-level `theme`.\n   */\n  codeHighlight?: CodeHighlightOptions | null;\n  features?: MarkdownFeaturesConfig;\n}\n\n/** `jsxRuntime` option values. Consumed only by `compile`. */\nexport type JsxRuntime = \"preact\" | \"react\";\n\n/**\n * The options JSON document shared by `compile` and `renderHtml`. Every\n * field is optional; `{}` selects all defaults. Unknown fields are\n * rejected by the Rust side at both nesting levels (`deny_unknown_fields`).\n */\nexport interface ZfbMdWasmOptions {\n  /**\n   * Must end in `.md` or `.mdx`. Drives frontmatter dispatch and\n   * diagnostics display. Defaults to `<anonymous>.mdx` for `compile` and\n   * `<anonymous>.md` for `renderHtml`.\n   */\n  filename?: string;\n  /** Consumed only by `compile`; `renderHtml` accepts and ignores it. */\n  jsxRuntime?: JsxRuntime;\n  /** Consumed only by `compile`; `renderHtml` accepts and ignores it. */\n  development?: boolean;\n  pipeline?: PipelineOptions;\n}\n\n/** `source` values a `Diagnostic` can carry. */\nexport type DiagnosticSource = \"options\" | \"frontmatter\" | \"markdown\" | \"compile\";\n\n/**\n * One diagnostic entry. `line`/`column` are the sole supported diagnostic\n * location and are 1-based. For `\"markdown\"` / `\"frontmatter\"` they point\n * into the *original source* (frontmatter lines included) in JavaScript\n * UTF-16 code units. For `\"options\"` they point into the *options JSON\n * document*. They are `null` when the underlying error carries no location.\n */\nexport interface Diagnostic {\n  severity: \"error\";\n  source: DiagnosticSource;\n  /**\n   * Opaque display text from this package or an upstream dependency. Do not\n   * parse or rewrite it: embedded coordinates, when present, are not public\n   * API and may use the dependency's own coordinate space. Use structured\n   * `line` and `column` for the supported location instead.\n   */\n  message: string;\n  line: number | null;\n  column: number | null;\n}\n\n/** Result document of `compile`. */\nexport interface CompileResult {\n  /** ES-module JS source on success, `null` on failure. */\n  code: string | null;\n  /** Parsed YAML frontmatter as JSON, `null` when absent or unextractable. */\n  frontmatter: unknown;\n  diagnostics: Diagnostic[];\n}\n\n/**\n * One point in the original source (unist convention). `line` is 1-based\n * and unit-agnostic. `column` is 1-based and `offset` is 0-based, BOTH in\n * **UTF-16 code units** (zfb#1856, epic zfb#1854) — the indexing\n * `String.prototype.slice`, `mdast-util-to-hast`, and consumer mdast\n * plugins already use, and remark/unist's own convention. This is NOT\n * Unicode scalar values/code points: a scalar value outside the Basic\n * Multilingual Plane (most emoji) is 2 UTF-16 code units but 1 code point,\n * so a surrogate-pair character advances `offset`/`column` by 2, not 1.\n * Pure-ASCII sources have byte offsets == UTF-16 offsets, so this only\n * matters once the source has non-ASCII content.\n */\nexport interface AstPoint {\n  line: number;\n  column: number;\n  offset: number;\n}\n\n/** Start/end span of two {@link AstPoint}s (unist convention). */\nexport interface AstPosition {\n  start: AstPoint;\n  end: AstPoint;\n}\n\n/** Optional unist data carried losslessly by known raw tree nodes. */\nexport interface RawMdastData {\n  data?: Record<string, unknown>;\n}\n\n/**\n * Internal markdown-rs re-parse bookkeeping carried by MDX expression/ESM\n * nodes: `[indexInValue, absoluteSourceOffset]`. Internal, unstable, and\n * (unlike {@link AstPosition}) **UTF-8 BYTE**-based -- markdown-rs uses it\n * to re-resolve sub-positions inside an expression's own re-parse pass.\n * Never slice a string with it; it does not share `position`'s UTF-16 unit\n * contract.\n */\nexport type MarkdownRsStop = readonly [indexInValue: number, absoluteSourceOffsetBytes: number];\n\n/** GFM alignment for a table column. `null` means no explicit alignment. */\nexport type TableAlign = \"left\" | \"right\" | \"center\" | null;\n\n/** Explicitness of a `link`/`image` reference (GFM footnotes reuse it too). */\nexport type ReferenceKind = \"shortcut\" | \"collapsed\" | \"full\";\n\n// ── mdast core node set ─────────────────────────────────────────────────────\n// Mirrors `markdown::mdast::Node`'s variants (markdown-rs, `serde(tag =\n// \"type\", rename_all = \"camelCase\")`) -- see that crate's `src/mdast.rs` for\n// the authoritative field shapes. Every variant here always carries\n// `position` (requirement 2 of zfb#1828); the one documented exception,\n// `mdxJsxAttribute`/its value/expression-attribute siblings, is intentionally\n// NOT part of the `MdastNode` union below -- they are attribute records\n// embedded in `MdxJsxFlowElement`/`MdxJsxTextElement.attributes`, not\n// standalone tree nodes.\n\nexport interface Root extends RawMdastData {\n  type: \"root\";\n  position: AstPosition;\n  children: MdastNode[];\n}\nexport interface Paragraph extends RawMdastData {\n  type: \"paragraph\";\n  position: AstPosition;\n  children: MdastNode[];\n}\nexport interface Heading extends RawMdastData {\n  type: \"heading\";\n  position: AstPosition;\n  depth: 1 | 2 | 3 | 4 | 5 | 6;\n  children: MdastNode[];\n}\nexport interface ThematicBreak extends RawMdastData {\n  type: \"thematicBreak\";\n  position: AstPosition;\n}\nexport interface Blockquote extends RawMdastData {\n  type: \"blockquote\";\n  position: AstPosition;\n  children: MdastNode[];\n}\nexport interface List extends RawMdastData {\n  type: \"list\";\n  position: AstPosition;\n  ordered: boolean;\n  /**\n   * Absent for an unordered list. Rust serializes `None` here by OMITTING\n   * the key (`#[serde(skip_serializing_if = \"Option::is_none\")]`), not as\n   * JSON `null` -- hence `?:`, not `| null`.\n   */\n  start?: number;\n  spread: boolean;\n  children: MdastNode[];\n}\nexport interface ListItem extends RawMdastData {\n  type: \"listItem\";\n  position: AstPosition;\n  spread: boolean;\n  /** GFM task-list state; absent (not `null` -- see {@link List.start}) for a plain (non-task) item. */\n  checked?: boolean;\n  children: MdastNode[];\n}\nexport interface Html extends RawMdastData {\n  type: \"html\";\n  position: AstPosition;\n  value: string;\n}\nexport interface Code extends RawMdastData {\n  type: \"code\";\n  position: AstPosition;\n  /** Absent when the fence has no language (see {@link List.start}). */\n  lang?: string;\n  /** Absent when the fence has no meta string (see {@link List.start}). */\n  meta?: string;\n  value: string;\n}\nexport interface Definition extends RawMdastData {\n  type: \"definition\";\n  position: AstPosition;\n  url: string;\n  /** Absent when there is no title (see {@link List.start}). */\n  title?: string;\n  identifier: string;\n  /** Absent when there is no label (see {@link List.start}). */\n  label?: string;\n}\nexport interface Text extends RawMdastData {\n  type: \"text\";\n  position: AstPosition;\n  value: string;\n}\n\n/** Shared raw shape of the three generic remark-directive node kinds. */\nexport interface DirectiveNodeBase extends RawMdastData {\n  position: AstPosition;\n  name: string;\n  /** Always present; boolean attributes are represented by an empty string. */\n  attributes: Record<string, string>;\n  children: MdastNode[];\n}\nexport interface ContainerDirective extends DirectiveNodeBase {\n  type: \"containerDirective\";\n}\nexport interface LeafDirective extends DirectiveNodeBase {\n  type: \"leafDirective\";\n}\nexport interface TextDirective extends DirectiveNodeBase {\n  type: \"textDirective\";\n}\nexport interface Emphasis extends RawMdastData {\n  type: \"emphasis\";\n  position: AstPosition;\n  children: MdastNode[];\n}\nexport interface Strong extends RawMdastData {\n  type: \"strong\";\n  position: AstPosition;\n  children: MdastNode[];\n}\nexport interface InlineCode extends RawMdastData {\n  type: \"inlineCode\";\n  position: AstPosition;\n  value: string;\n}\nexport interface Break extends RawMdastData {\n  type: \"break\";\n  position: AstPosition;\n}\nexport interface Link extends RawMdastData {\n  type: \"link\";\n  position: AstPosition;\n  url: string;\n  /** Absent when there is no title (see {@link List.start}). */\n  title?: string;\n  children: MdastNode[];\n}\nexport interface Image extends RawMdastData {\n  type: \"image\";\n  position: AstPosition;\n  alt: string;\n  url: string;\n  /** Absent when there is no title (see {@link List.start}). */\n  title?: string;\n}\nexport interface LinkReference extends RawMdastData {\n  type: \"linkReference\";\n  position: AstPosition;\n  referenceType: ReferenceKind;\n  identifier: string;\n  /** Absent when there is no label (see {@link List.start}). */\n  label?: string;\n  children: MdastNode[];\n}\nexport interface ImageReference extends RawMdastData {\n  type: \"imageReference\";\n  position: AstPosition;\n  alt: string;\n  referenceType: ReferenceKind;\n  identifier: string;\n  /** Absent when there is no label (see {@link List.start}). */\n  label?: string;\n}\n/** GFM footnote definition (`[^id]: ...`). */\nexport interface FootnoteDefinition extends RawMdastData {\n  type: \"footnoteDefinition\";\n  position: AstPosition;\n  identifier: string;\n  /** Absent when there is no label (see {@link List.start}). */\n  label?: string;\n  children: MdastNode[];\n}\n/** GFM footnote reference (`[^id]`). */\nexport interface FootnoteReference extends RawMdastData {\n  type: \"footnoteReference\";\n  position: AstPosition;\n  identifier: string;\n  /** Absent when there is no label (see {@link List.start}). */\n  label?: string;\n}\n/** GFM table. */\nexport interface Table extends RawMdastData {\n  type: \"table\";\n  position: AstPosition;\n  align: TableAlign[];\n  children: MdastNode[];\n}\nexport interface TableRow extends RawMdastData {\n  type: \"tableRow\";\n  position: AstPosition;\n  children: MdastNode[];\n}\nexport interface TableCell extends RawMdastData {\n  type: \"tableCell\";\n  position: AstPosition;\n  children: MdastNode[];\n}\n/** GFM strikethrough (`~~text~~`). */\nexport interface Delete extends RawMdastData {\n  type: \"delete\";\n  position: AstPosition;\n  children: MdastNode[];\n}\n/**\n * Canonical markdown-rs YAML frontmatter node emitted by\n * `frontmatter: \"node\"`. Its value excludes fences and line endings while\n * its position covers the complete fenced block.\n */\nexport interface Yaml extends RawMdastData {\n  type: \"yaml\";\n  position: AstPosition;\n  value: string;\n}\n\n// ── MDX node set ─────────────────────────────────────────────────────────\n\n/** MDX flow expression (`{...}` on its own line). */\nexport interface MdxFlowExpression extends RawMdastData {\n  type: \"mdxFlowExpression\";\n  position: AstPosition;\n  value: string;\n  /** Internal/unstable/byte-based -- see {@link MarkdownRsStop}. */\n  _markdownRsStops: MarkdownRsStop[];\n}\n/** MDX text expression (`{...}` inline in phrasing content). */\nexport interface MdxTextExpression extends RawMdastData {\n  type: \"mdxTextExpression\";\n  position: AstPosition;\n  value: string;\n  _markdownRsStops: MarkdownRsStop[];\n}\n/** MDX JSX element as flow (block-level) content. */\nexport interface MdxJsxFlowElement extends RawMdastData {\n  type: \"mdxJsxFlowElement\";\n  position: AstPosition;\n  /** Absent for a JSX fragment (`<>...</>`) -- see {@link List.start}. */\n  name?: string;\n  attributes: MdxJsxAttributeContent[];\n  children: MdastNode[];\n}\n/** MDX JSX element as phrasing (inline) content. */\nexport interface MdxJsxTextElement extends RawMdastData {\n  type: \"mdxJsxTextElement\";\n  position: AstPosition;\n  /** Absent for a JSX fragment (`<>...</>`) -- see {@link List.start}. */\n  name?: string;\n  attributes: MdxJsxAttributeContent[];\n  children: MdastNode[];\n}\n\n/**\n * A JSX attribute's value: a plain string literal, or a `{...}` expression\n * value. Divergence: expression attribute VALUES carry no `position`\n * (mirrors the `mdxJsxAttribute`/`mdxJsxExpressionAttribute` divergence\n * below -- markdown-rs does not model attribute positions anywhere).\n */\nexport interface MdxJsxAttributeValueExpression extends RawMdastData {\n  type: \"mdxJsxAttributeValueExpression\";\n  value: string;\n  _markdownRsStops: MarkdownRsStop[];\n}\n/**\n * One `name=\"value\"` / `name={expr}` / bare `name` JSX attribute.\n * Divergence: carries no `position` -- markdown-rs does not model attribute\n * positions (zfb#1828 requirement 2's one documented exception).\n */\nexport interface MdxJsxAttribute extends RawMdastData {\n  type: \"mdxJsxAttribute\";\n  name: string;\n  /** Absent for a bare boolean attribute (`<a b />`) -- see {@link List.start}. */\n  value?: string | MdxJsxAttributeValueExpression;\n}\n/**\n * A JSX spread attribute (`{...expr}`). Divergence: carries no `position`,\n * same reason as {@link MdxJsxAttribute}.\n */\nexport interface MdxJsxExpressionAttribute extends RawMdastData {\n  type: \"mdxJsxExpressionAttribute\";\n  value: string;\n  _markdownRsStops: MarkdownRsStop[];\n}\n/** One entry of `MdxJsxFlowElement`/`MdxJsxTextElement.attributes`. */\nexport type MdxJsxAttributeContent = MdxJsxAttribute | MdxJsxExpressionAttribute;\n\n/**\n * Catch-all for any mdast node type not enumerated above -- keeps\n * unrecognized/future node types TYPED (requirement 3 of zfb#1828: an opaque\n * `unknown` would silently drop this contract) rather than falling back to\n * `unknown`. `type` is deliberately the general `string` here (not a\n * literal), so TypeScript's discriminated-union narrowing on `type` keeps\n * this member alongside any single literal match; disambiguate with an\n * explicit assertion once a runtime `type` check has confirmed which shape\n * you actually have (see `test/consumer-compatibility-parse-to-ast.ts` for\n * the pattern).\n */\nexport interface UnknownMdastNode {\n  type: string;\n  position: AstPosition;\n  [key: string]: unknown;\n}\n\n/**\n * Any node markdown-rs's raw mdast serialization can produce through\n * `parseToAst` -- the documented mdast core set, the documented MDX set, or\n * {@link UnknownMdastNode} for anything else. Attribute-record shapes\n * ({@link MdxJsxAttributeContent} and its members) are intentionally NOT\n * part of this union -- see their own docs.\n */\nexport type MdastNode =\n  | Root\n  | Paragraph\n  | Heading\n  | ThematicBreak\n  | Blockquote\n  | List\n  | ListItem\n  | Html\n  | Code\n  | Definition\n  | Text\n  | Emphasis\n  | Strong\n  | InlineCode\n  | Break\n  | Link\n  | Image\n  | LinkReference\n  | ImageReference\n  | FootnoteDefinition\n  | FootnoteReference\n  | Table\n  | TableRow\n  | TableCell\n  | Delete\n  | Yaml\n  | MdxFlowExpression\n  | MdxTextExpression\n  | MdxJsxFlowElement\n  | MdxJsxTextElement\n  | ContainerDirective\n  | LeafDirective\n  | TextDirective\n  | UnknownMdastNode;\n\n/** The tree root `parseToAst` returns -- always a `root` node when present. */\nexport type MdastRoot = Root;\n\n/**\n * Result document of `parseToAst` (zfb#1857, epic zfb#1854). `ast` is the\n * raw markdown-rs mdast converted through its serde shape into an open\n * carrier (unist-shaped `type`, fields, and `position`) and PRE-zfb-visitors.\n * Source selection follows {@link FrontmatterPolicy}. When `directives` is\n * true the carrier can also contain the three generic directive kinds;\n * otherwise directive-looking text survives exactly as markdown-rs parsed\n * it. `position.offset` and\n * `position.column` are UTF-16 code units (see {@link AstPoint}).\n *\n * Markdown mode preserves CommonMark HTML/comments, angle autolinks,\n * indented code, and literal braces. MDX mode enables JSX/expressions and\n * keeps markdown-rs's conflicting CommonMark constructs disabled. Both\n * modes apply the same five independent {@link GfmOptions} switches.\n *\n * Documented divergences from remark-parse / remark-mdx in MDX mode:\n * - `mdxJsxAttribute` (and its value/expression-attribute siblings) carry no\n *   `position` -- markdown-rs does not model attribute positions.\n * - Top-level `import`/`export` degrade to paragraphs (no `mdxjsEsm` nodes),\n *   and MDX expressions carry no estree data -- the wasm boundary cannot\n *   host a JS ESM/acorn parser. Consumers needing remark-mdx-equivalent\n *   ESM/estree keep remark for those documents.\n * - `_markdownRsStops` is internal, unstable, and byte-based (not UTF-16) --\n *   see {@link MarkdownRsStop}.\n */\nexport interface ParseToAstResult {\n  /** Serialized raw mdast root on success, `null` on failure. */\n  ast: MdastRoot | null;\n  /** Parsed YAML frontmatter as JSON, `null` when absent or unextractable. */\n  frontmatter: unknown;\n  diagnostics: Diagnostic[];\n}\n\n/** Result document of `renderHtml`. */\nexport interface RenderHtmlResult {\n  /** HTML fragment on success, `null` on failure. */\n  html: string | null;\n  frontmatter: unknown;\n  diagnostics: Diagnostic[];\n}\n\n/**\n * The fixed 18-role semantic taxonomy emitted by `highlightCode`. This union\n * is mechanically checked against Rust's canonical `HiRole::FULL_NAMES` by\n * `zfb`'s role-drift guard; do not add a second unguarded role list.\n */\nexport type HighlightRole =\n  | \"escape\"\n  | \"operator\"\n  | \"comment\"\n  | \"string\"\n  | \"number\"\n  | \"constant\"\n  | \"keyword\"\n  | \"function\"\n  | \"type\"\n  | \"namespace\"\n  | \"property\"\n  | \"variable\"\n  | \"tag\"\n  | \"attribute\"\n  | \"punctuation\"\n  | \"inserted\"\n  | \"deleted\"\n  | \"heading\";\n\n/** Options for direct arbitrary-code semantic class highlighting. */\nexport interface HighlightCodeOptions {\n  /** Required syntax token, for example `\"html\"`, `\"css\"`, or `\"javascript\"`. */\n  language: string;\n  /** The only supported direct output mode. Defaults to `\"class\"`. */\n  mode?: \"class\";\n  /** Semantic role class prefix. Defaults to `\"hi-\"`. */\n  classPrefix?: string;\n  /** Full-name role overrides, for example `{ keyword: \"text-violet-600\" }`. */\n  roleClasses?: Partial<Record<HighlightRole, string>>;\n}\n\n/** Sources used by direct `highlightCode` diagnostics. */\nexport type HighlightDiagnosticSource = \"options\" | \"highlight\" | \"internal\";\n\n/** A structured direct-highlighting diagnostic. */\nexport interface HighlightDiagnostic {\n  severity: \"error\" | \"warning\";\n  source: HighlightDiagnosticSource;\n  message: string;\n  /** Always `null` for semantic/highlight diagnostics; JSON option parse locations are 1-based. */\n  line: number | null;\n  /** Always `null` for semantic/highlight diagnostics; JSON option parse locations are 1-based. */\n  column: number | null;\n}\n\n/** Result document returned by {@link highlightCode}. */\nexport interface HighlightCodeResult {\n  /** Complete semantic `<pre><code>` wrapper, or `null` for invalid options/internal errors. */\n  html: string | null;\n  diagnostics: HighlightDiagnostic[];\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,2EAA2E;AAC3E,qEAAqE;AACrE,gCAAgC","sourcesContent":["// Mirrors the JSON contracts of the `zfb-md-wasm` Rust crate (zfb#1576)\n// literally -- see that crate's `src/lib.rs` rustdoc for the authoritative\n// shape. Keep this file in lock-step with the crate when the crate's\n// options/result shapes change.\n\n/** `zfb_content::facade::PipelineOptions`'s `gfm` sub-object, verbatim. */\nexport interface GfmOptions {\n  strikethrough?: boolean;\n  table?: boolean;\n  autolinkLiteral?: boolean;\n  taskListItem?: boolean;\n  footnoteDefinition?: boolean;\n}\n\n/** Base syntax selected by `parseToAst` and `renderHtml`. */\nexport type ParseDialect = \"markdown\" | \"mdx\";\n\n/** How `parseToAst` handles recognized YAML frontmatter. */\nexport type FrontmatterPolicy = \"extract\" | \"node\" | \"none\";\n\n/** Raw-parser pipeline options. Visitor/serializer options are not accepted. */\nexport interface ParsePipelineOptions {\n  gfm?: GfmOptions;\n}\n\n/**\n * The distinct, closed options document consumed by `parseToAst`.\n *\n * `filename` must end in lowercase `.md` or `.mdx`. With no explicit\n * `dialect`, `.md` selects CommonMark and `.mdx` selects MDX; omitting the\n * filename uses `<anonymous>.mdx`, hence MDX. An explicit dialect overrides\n * either valid extension but does not waive that extension gate.\n */\nexport interface ParseToAstOptions {\n  filename?: string;\n  dialect?: ParseDialect;\n  /** Parse generic remark-directive syntax. Default: `false`. */\n  directives?: boolean;\n  /**\n   * YAML handling policy. Default: `\"extract\"`.\n   *\n   * - `extract`: parse the stripped body, return YAML as JSON, no YAML node;\n   * - `node`: parse the full logical source, return JSON plus canonical YAML node;\n   * - `none`: parse every logical-source byte as Markdown/MDX and always return null.\n   *\n   * Malformed/unterminated YAML fails `extract`/`node` with one\n   * `frontmatter` diagnostic; `none` never produces a YAML diagnostic.\n   */\n  frontmatter?: FrontmatterPolicy;\n  pipeline?: ParsePipelineOptions;\n}\n\n/**\n * `MarkdownFeaturesConfig` (see `crates/zfb-md-ast/src/features_config.rs`).\n * Left as an open record here -- the wasm boundary passes it through to the\n * Rust `deny_unknown_fields` deserializer verbatim, which is the\n * authoritative validator for its keys.\n */\nexport type MarkdownFeaturesConfig = Record<string, unknown>;\n\n/**\n * `zfb_content::facade::CodeHighlightOptions`'s `mode` field -- mirrors the\n * `\"inline\"` / `\"class\"` string-literal union in native `zfb.config.ts`\n * (`CodeHighlightConfig.mode`).\n */\nexport type CodeHighlightMode = \"inline\" | \"class\";\n\n/**\n * `zfb_content::facade::CodeHighlightOptions`, verbatim (Highlight Tokens\n * epic zfb#1528, wasm routing sub zfb#1852).\n */\nexport interface CodeHighlightOptions {\n  /** Output mode for fenced-code highlighting. Defaults to `\"inline\"` --\n   * reproduces the pre-existing per-token inline-color behaviour\n   * byte-for-byte. */\n  mode?: CodeHighlightMode;\n  /** Class-name prefix for class-mode role classes (e.g. the default\n   * `\"hi-\"` yields `hi-kw`, `hi-str`, ...). Only meaningful when `mode` is\n   * `\"class\"`. */\n  classPrefix?: string;\n  /** Per-role class overrides for class mode. Absent or `null` uses\n   * `{classPrefix}{role}` for every role. Only meaningful when `mode` is\n   * `\"class\"`. */\n  roleClasses?: Partial<Record<HighlightRole, string>> | null;\n}\n\n/** `zfb_content::facade::PipelineOptions`, verbatim. */\nexport interface PipelineOptions {\n  /**\n   * A syntect theme name. Absent, or explicit `null`, keeps the built-in\n   * default theme (`base16-ocean.dark`) -- fenced code is ALWAYS\n   * highlighted through this field; there is no \"no syntax highlighting\"\n   * value (this comment previously claimed `null` meant no highlighting,\n   * which was never true of the Rust deserializer -- corrected in\n   * zfb#1852). Mutually exclusive with `codeHighlight.mode: \"class\"`.\n   */\n  theme?: string | null;\n  gfm?: GfmOptions;\n  cjkFriendly?: boolean;\n  hardBreaks?: boolean;\n  /**\n   * Output mode + class-mode knobs for fenced-code highlighting\n   * (Highlight Tokens epic zfb#1528). Absent, `null`, or\n   * `{ mode: \"inline\" }` reproduce the pre-existing inline-color\n   * behaviour byte-for-byte. `{ mode: \"class\" }` is mutually exclusive\n   * with a top-level `theme`.\n   */\n  codeHighlight?: CodeHighlightOptions | null;\n  features?: MarkdownFeaturesConfig;\n}\n\n/** `jsxRuntime` option values. Consumed only by `compile`. */\nexport type JsxRuntime = \"preact\" | \"react\";\n\n/**\n * The options JSON document shared by `compile` and `renderHtml`. Every\n * field is optional; `{}` selects all defaults. Unknown fields are\n * rejected by the Rust side at both nesting levels (`deny_unknown_fields`).\n */\nexport interface ZfbMdWasmOptions {\n  /**\n   * Must end in `.md` or `.mdx`. Drives frontmatter dispatch and\n   * diagnostics display. Defaults to `<anonymous>.mdx` for `compile` and\n   * `<anonymous>.md` for `renderHtml`.\n   */\n  filename?: string;\n  /**\n   * Consumed only by `renderHtml`; `compile` accepts and ignores it.\n   * Without an override, `.md` selects CommonMark and `.mdx` selects MDX.\n   */\n  dialect?: ParseDialect;\n  /** Consumed only by `compile`; `renderHtml` accepts and ignores it. */\n  jsxRuntime?: JsxRuntime;\n  /** Consumed only by `compile`; `renderHtml` accepts and ignores it. */\n  development?: boolean;\n  pipeline?: PipelineOptions;\n}\n\n/** `source` values a `Diagnostic` can carry. */\nexport type DiagnosticSource = \"options\" | \"frontmatter\" | \"markdown\" | \"compile\";\n\n/**\n * One diagnostic entry. `line`/`column` are the sole supported diagnostic\n * location and are 1-based. For `\"markdown\"` / `\"frontmatter\"` they point\n * into the *original source* (frontmatter lines included) in JavaScript\n * UTF-16 code units. For `\"options\"` they point into the *options JSON\n * document*. They are `null` when the underlying error carries no location.\n */\nexport interface Diagnostic {\n  severity: \"error\";\n  source: DiagnosticSource;\n  /**\n   * Opaque display text from this package or an upstream dependency. Do not\n   * parse or rewrite it: embedded coordinates, when present, are not public\n   * API and may use the dependency's own coordinate space. Use structured\n   * `line` and `column` for the supported location instead.\n   */\n  message: string;\n  line: number | null;\n  column: number | null;\n}\n\n/** Result document of `compile`. */\nexport interface CompileResult {\n  /** ES-module JS source on success, `null` on failure. */\n  code: string | null;\n  /** Parsed YAML frontmatter as JSON, `null` when absent or unextractable. */\n  frontmatter: unknown;\n  diagnostics: Diagnostic[];\n}\n\n/**\n * One point in the original source (unist convention). `line` is 1-based\n * and unit-agnostic. `column` is 1-based and `offset` is 0-based, BOTH in\n * **UTF-16 code units** (zfb#1856, epic zfb#1854) — the indexing\n * `String.prototype.slice`, `mdast-util-to-hast`, and consumer mdast\n * plugins already use, and remark/unist's own convention. This is NOT\n * Unicode scalar values/code points: a scalar value outside the Basic\n * Multilingual Plane (most emoji) is 2 UTF-16 code units but 1 code point,\n * so a surrogate-pair character advances `offset`/`column` by 2, not 1.\n * Pure-ASCII sources have byte offsets == UTF-16 offsets, so this only\n * matters once the source has non-ASCII content.\n */\nexport interface AstPoint {\n  line: number;\n  column: number;\n  offset: number;\n}\n\n/** Start/end span of two {@link AstPoint}s (unist convention). */\nexport interface AstPosition {\n  start: AstPoint;\n  end: AstPoint;\n}\n\n/** Optional unist data carried losslessly by known raw tree nodes. */\nexport interface RawMdastData {\n  data?: Record<string, unknown>;\n}\n\n/**\n * Internal markdown-rs re-parse bookkeeping carried by MDX expression/ESM\n * nodes: `[indexInValue, absoluteSourceOffset]`. Internal, unstable, and\n * (unlike {@link AstPosition}) **UTF-8 BYTE**-based -- markdown-rs uses it\n * to re-resolve sub-positions inside an expression's own re-parse pass.\n * Never slice a string with it; it does not share `position`'s UTF-16 unit\n * contract.\n */\nexport type MarkdownRsStop = readonly [indexInValue: number, absoluteSourceOffsetBytes: number];\n\n/** GFM alignment for a table column. `null` means no explicit alignment. */\nexport type TableAlign = \"left\" | \"right\" | \"center\" | null;\n\n/** Explicitness of a `link`/`image` reference (GFM footnotes reuse it too). */\nexport type ReferenceKind = \"shortcut\" | \"collapsed\" | \"full\";\n\n// ── mdast core node set ─────────────────────────────────────────────────────\n// Mirrors `markdown::mdast::Node`'s variants (markdown-rs, `serde(tag =\n// \"type\", rename_all = \"camelCase\")`) -- see that crate's `src/mdast.rs` for\n// the authoritative field shapes. Every variant here always carries\n// `position` (requirement 2 of zfb#1828); the one documented exception,\n// `mdxJsxAttribute`/its value/expression-attribute siblings, is intentionally\n// NOT part of the `MdastNode` union below -- they are attribute records\n// embedded in `MdxJsxFlowElement`/`MdxJsxTextElement.attributes`, not\n// standalone tree nodes.\n\nexport interface Root extends RawMdastData {\n  type: \"root\";\n  position: AstPosition;\n  children: MdastNode[];\n}\nexport interface Paragraph extends RawMdastData {\n  type: \"paragraph\";\n  position: AstPosition;\n  children: MdastNode[];\n}\nexport interface Heading extends RawMdastData {\n  type: \"heading\";\n  position: AstPosition;\n  depth: 1 | 2 | 3 | 4 | 5 | 6;\n  children: MdastNode[];\n}\nexport interface ThematicBreak extends RawMdastData {\n  type: \"thematicBreak\";\n  position: AstPosition;\n}\nexport interface Blockquote extends RawMdastData {\n  type: \"blockquote\";\n  position: AstPosition;\n  children: MdastNode[];\n}\nexport interface List extends RawMdastData {\n  type: \"list\";\n  position: AstPosition;\n  ordered: boolean;\n  /**\n   * Absent for an unordered list. Rust serializes `None` here by OMITTING\n   * the key (`#[serde(skip_serializing_if = \"Option::is_none\")]`), not as\n   * JSON `null` -- hence `?:`, not `| null`.\n   */\n  start?: number;\n  spread: boolean;\n  children: MdastNode[];\n}\nexport interface ListItem extends RawMdastData {\n  type: \"listItem\";\n  position: AstPosition;\n  spread: boolean;\n  /** GFM task-list state; absent (not `null` -- see {@link List.start}) for a plain (non-task) item. */\n  checked?: boolean;\n  children: MdastNode[];\n}\nexport interface Html extends RawMdastData {\n  type: \"html\";\n  position: AstPosition;\n  value: string;\n}\nexport interface Code extends RawMdastData {\n  type: \"code\";\n  position: AstPosition;\n  /** Absent when the fence has no language (see {@link List.start}). */\n  lang?: string;\n  /** Absent when the fence has no meta string (see {@link List.start}). */\n  meta?: string;\n  value: string;\n}\nexport interface Definition extends RawMdastData {\n  type: \"definition\";\n  position: AstPosition;\n  url: string;\n  /** Absent when there is no title (see {@link List.start}). */\n  title?: string;\n  identifier: string;\n  /** Absent when there is no label (see {@link List.start}). */\n  label?: string;\n}\nexport interface Text extends RawMdastData {\n  type: \"text\";\n  position: AstPosition;\n  value: string;\n}\n\n/** Shared raw shape of the three generic remark-directive node kinds. */\nexport interface DirectiveNodeBase extends RawMdastData {\n  position: AstPosition;\n  name: string;\n  /** Always present; boolean attributes are represented by an empty string. */\n  attributes: Record<string, string>;\n  children: MdastNode[];\n}\nexport interface ContainerDirective extends DirectiveNodeBase {\n  type: \"containerDirective\";\n}\nexport interface LeafDirective extends DirectiveNodeBase {\n  type: \"leafDirective\";\n}\nexport interface TextDirective extends DirectiveNodeBase {\n  type: \"textDirective\";\n}\nexport interface Emphasis extends RawMdastData {\n  type: \"emphasis\";\n  position: AstPosition;\n  children: MdastNode[];\n}\nexport interface Strong extends RawMdastData {\n  type: \"strong\";\n  position: AstPosition;\n  children: MdastNode[];\n}\nexport interface InlineCode extends RawMdastData {\n  type: \"inlineCode\";\n  position: AstPosition;\n  value: string;\n}\nexport interface Break extends RawMdastData {\n  type: \"break\";\n  position: AstPosition;\n}\nexport interface Link extends RawMdastData {\n  type: \"link\";\n  position: AstPosition;\n  url: string;\n  /** Absent when there is no title (see {@link List.start}). */\n  title?: string;\n  children: MdastNode[];\n}\nexport interface Image extends RawMdastData {\n  type: \"image\";\n  position: AstPosition;\n  alt: string;\n  url: string;\n  /** Absent when there is no title (see {@link List.start}). */\n  title?: string;\n}\nexport interface LinkReference extends RawMdastData {\n  type: \"linkReference\";\n  position: AstPosition;\n  referenceType: ReferenceKind;\n  identifier: string;\n  /** Absent when there is no label (see {@link List.start}). */\n  label?: string;\n  children: MdastNode[];\n}\nexport interface ImageReference extends RawMdastData {\n  type: \"imageReference\";\n  position: AstPosition;\n  alt: string;\n  referenceType: ReferenceKind;\n  identifier: string;\n  /** Absent when there is no label (see {@link List.start}). */\n  label?: string;\n}\n/** GFM footnote definition (`[^id]: ...`). */\nexport interface FootnoteDefinition extends RawMdastData {\n  type: \"footnoteDefinition\";\n  position: AstPosition;\n  identifier: string;\n  /** Absent when there is no label (see {@link List.start}). */\n  label?: string;\n  children: MdastNode[];\n}\n/** GFM footnote reference (`[^id]`). */\nexport interface FootnoteReference extends RawMdastData {\n  type: \"footnoteReference\";\n  position: AstPosition;\n  identifier: string;\n  /** Absent when there is no label (see {@link List.start}). */\n  label?: string;\n}\n/** GFM table. */\nexport interface Table extends RawMdastData {\n  type: \"table\";\n  position: AstPosition;\n  align: TableAlign[];\n  children: MdastNode[];\n}\nexport interface TableRow extends RawMdastData {\n  type: \"tableRow\";\n  position: AstPosition;\n  children: MdastNode[];\n}\nexport interface TableCell extends RawMdastData {\n  type: \"tableCell\";\n  position: AstPosition;\n  children: MdastNode[];\n}\n/** GFM strikethrough (`~~text~~`). */\nexport interface Delete extends RawMdastData {\n  type: \"delete\";\n  position: AstPosition;\n  children: MdastNode[];\n}\n/**\n * Canonical markdown-rs YAML frontmatter node emitted by\n * `frontmatter: \"node\"`. Its value excludes fences and line endings while\n * its position covers the complete fenced block.\n */\nexport interface Yaml extends RawMdastData {\n  type: \"yaml\";\n  position: AstPosition;\n  value: string;\n}\n\n// ── MDX node set ─────────────────────────────────────────────────────────\n\n/** MDX flow expression (`{...}` on its own line). */\nexport interface MdxFlowExpression extends RawMdastData {\n  type: \"mdxFlowExpression\";\n  position: AstPosition;\n  value: string;\n  /** Internal/unstable/byte-based -- see {@link MarkdownRsStop}. */\n  _markdownRsStops: MarkdownRsStop[];\n}\n/** MDX text expression (`{...}` inline in phrasing content). */\nexport interface MdxTextExpression extends RawMdastData {\n  type: \"mdxTextExpression\";\n  position: AstPosition;\n  value: string;\n  _markdownRsStops: MarkdownRsStop[];\n}\n/** MDX JSX element as flow (block-level) content. */\nexport interface MdxJsxFlowElement extends RawMdastData {\n  type: \"mdxJsxFlowElement\";\n  position: AstPosition;\n  /** Absent for a JSX fragment (`<>...</>`) -- see {@link List.start}. */\n  name?: string;\n  attributes: MdxJsxAttributeContent[];\n  children: MdastNode[];\n}\n/** MDX JSX element as phrasing (inline) content. */\nexport interface MdxJsxTextElement extends RawMdastData {\n  type: \"mdxJsxTextElement\";\n  position: AstPosition;\n  /** Absent for a JSX fragment (`<>...</>`) -- see {@link List.start}. */\n  name?: string;\n  attributes: MdxJsxAttributeContent[];\n  children: MdastNode[];\n}\n\n/**\n * A JSX attribute's value: a plain string literal, or a `{...}` expression\n * value. Divergence: expression attribute VALUES carry no `position`\n * (mirrors the `mdxJsxAttribute`/`mdxJsxExpressionAttribute` divergence\n * below -- markdown-rs does not model attribute positions anywhere).\n */\nexport interface MdxJsxAttributeValueExpression extends RawMdastData {\n  type: \"mdxJsxAttributeValueExpression\";\n  value: string;\n  _markdownRsStops: MarkdownRsStop[];\n}\n/**\n * One `name=\"value\"` / `name={expr}` / bare `name` JSX attribute.\n * Divergence: carries no `position` -- markdown-rs does not model attribute\n * positions (zfb#1828 requirement 2's one documented exception).\n */\nexport interface MdxJsxAttribute extends RawMdastData {\n  type: \"mdxJsxAttribute\";\n  name: string;\n  /** Absent for a bare boolean attribute (`<a b />`) -- see {@link List.start}. */\n  value?: string | MdxJsxAttributeValueExpression;\n}\n/**\n * A JSX spread attribute (`{...expr}`). Divergence: carries no `position`,\n * same reason as {@link MdxJsxAttribute}.\n */\nexport interface MdxJsxExpressionAttribute extends RawMdastData {\n  type: \"mdxJsxExpressionAttribute\";\n  value: string;\n  _markdownRsStops: MarkdownRsStop[];\n}\n/** One entry of `MdxJsxFlowElement`/`MdxJsxTextElement.attributes`. */\nexport type MdxJsxAttributeContent = MdxJsxAttribute | MdxJsxExpressionAttribute;\n\n/**\n * Catch-all for any mdast node type not enumerated above -- keeps\n * unrecognized/future node types TYPED (requirement 3 of zfb#1828: an opaque\n * `unknown` would silently drop this contract) rather than falling back to\n * `unknown`. `type` is deliberately the general `string` here (not a\n * literal), so TypeScript's discriminated-union narrowing on `type` keeps\n * this member alongside any single literal match; disambiguate with an\n * explicit assertion once a runtime `type` check has confirmed which shape\n * you actually have (see `test/consumer-compatibility-parse-to-ast.ts` for\n * the pattern).\n */\nexport interface UnknownMdastNode {\n  type: string;\n  position: AstPosition;\n  [key: string]: unknown;\n}\n\n/**\n * Any node markdown-rs's raw mdast serialization can produce through\n * `parseToAst` -- the documented mdast core set, the documented MDX set, or\n * {@link UnknownMdastNode} for anything else. Attribute-record shapes\n * ({@link MdxJsxAttributeContent} and its members) are intentionally NOT\n * part of this union -- see their own docs.\n */\nexport type MdastNode =\n  | Root\n  | Paragraph\n  | Heading\n  | ThematicBreak\n  | Blockquote\n  | List\n  | ListItem\n  | Html\n  | Code\n  | Definition\n  | Text\n  | Emphasis\n  | Strong\n  | InlineCode\n  | Break\n  | Link\n  | Image\n  | LinkReference\n  | ImageReference\n  | FootnoteDefinition\n  | FootnoteReference\n  | Table\n  | TableRow\n  | TableCell\n  | Delete\n  | Yaml\n  | MdxFlowExpression\n  | MdxTextExpression\n  | MdxJsxFlowElement\n  | MdxJsxTextElement\n  | ContainerDirective\n  | LeafDirective\n  | TextDirective\n  | UnknownMdastNode;\n\n/** The tree root `parseToAst` returns -- always a `root` node when present. */\nexport type MdastRoot = Root;\n\n/**\n * Result document of `parseToAst` (zfb#1857, epic zfb#1854). `ast` is the\n * raw markdown-rs mdast converted through its serde shape into an open\n * carrier (unist-shaped `type`, fields, and `position`) and PRE-zfb-visitors.\n * Source selection follows {@link FrontmatterPolicy}. When `directives` is\n * true the carrier can also contain the three generic directive kinds;\n * otherwise directive-looking text survives exactly as markdown-rs parsed\n * it. `position.offset` and\n * `position.column` are UTF-16 code units (see {@link AstPoint}).\n *\n * Markdown mode preserves CommonMark HTML/comments, angle autolinks,\n * indented code, and literal braces. MDX mode enables JSX/expressions and\n * keeps markdown-rs's conflicting CommonMark constructs disabled. Both\n * modes apply the same five independent {@link GfmOptions} switches.\n *\n * Documented divergences from remark-parse / remark-mdx in MDX mode:\n * - `mdxJsxAttribute` (and its value/expression-attribute siblings) carry no\n *   `position` -- markdown-rs does not model attribute positions.\n * - Top-level `import`/`export` degrade to paragraphs (no `mdxjsEsm` nodes),\n *   and MDX expressions carry no estree data -- the wasm boundary cannot\n *   host a JS ESM/acorn parser. Consumers needing remark-mdx-equivalent\n *   ESM/estree keep remark for those documents.\n * - `_markdownRsStops` is internal, unstable, and byte-based (not UTF-16) --\n *   see {@link MarkdownRsStop}.\n */\nexport interface ParseToAstResult {\n  /** Serialized raw mdast root on success, `null` on failure. */\n  ast: MdastRoot | null;\n  /** Parsed YAML frontmatter as JSON, `null` when absent or unextractable. */\n  frontmatter: unknown;\n  diagnostics: Diagnostic[];\n}\n\n/** Result document of `renderHtml`. */\nexport interface RenderHtmlResult {\n  /** HTML fragment on success, `null` on failure. */\n  html: string | null;\n  frontmatter: unknown;\n  diagnostics: Diagnostic[];\n}\n\n/**\n * The fixed 18-role semantic taxonomy emitted by `highlightCode`. This union\n * is mechanically checked against Rust's canonical `HiRole::FULL_NAMES` by\n * `zfb`'s role-drift guard; do not add a second unguarded role list.\n */\nexport type HighlightRole =\n  | \"escape\"\n  | \"operator\"\n  | \"comment\"\n  | \"string\"\n  | \"number\"\n  | \"constant\"\n  | \"keyword\"\n  | \"function\"\n  | \"type\"\n  | \"namespace\"\n  | \"property\"\n  | \"variable\"\n  | \"tag\"\n  | \"attribute\"\n  | \"punctuation\"\n  | \"inserted\"\n  | \"deleted\"\n  | \"heading\";\n\n/** Options for direct arbitrary-code semantic class highlighting. */\nexport interface HighlightCodeOptions {\n  /** Required syntax token, for example `\"html\"`, `\"css\"`, or `\"javascript\"`. */\n  language: string;\n  /** The only supported direct output mode. Defaults to `\"class\"`. */\n  mode?: \"class\";\n  /** Semantic role class prefix. Defaults to `\"hi-\"`. */\n  classPrefix?: string;\n  /** Full-name role overrides, for example `{ keyword: \"text-violet-600\" }`. */\n  roleClasses?: Partial<Record<HighlightRole, string>>;\n}\n\n/** Sources used by direct `highlightCode` diagnostics. */\nexport type HighlightDiagnosticSource = \"options\" | \"highlight\" | \"internal\";\n\n/** A structured direct-highlighting diagnostic. */\nexport interface HighlightDiagnostic {\n  severity: \"error\" | \"warning\";\n  source: HighlightDiagnosticSource;\n  message: string;\n  /** Always `null` for semantic/highlight diagnostics; JSON option parse locations are 1-based. */\n  line: number | null;\n  /** Always `null` for semantic/highlight diagnostics; JSON option parse locations are 1-based. */\n  column: number | null;\n}\n\n/** Result document returned by {@link highlightCode}. */\nexport interface HighlightCodeResult {\n  /** Complete semantic `<pre><code>` wrapper, or `null` for invalid options/internal errors. */\n  html: string | null;\n  diagnostics: HighlightDiagnostic[];\n}\n"]}

package/dist/wasm/zfb_md_wasm_glue.zfb-resource.d.mts

@@ -88,7 +88,9 @@ export function parseToAst(source: string, options_json: string): string;
  *
  * Returns a JSON string: `{ "html": string|null, "frontmatter": json,
  * "diagnostics": Diagnostic[] }` — see the crate docs for the options
- * and diagnostics shapes. Exported to JS as `renderHtml`.
+ * and diagnostics shapes. A `.md` filename selects CommonMark and `.mdx`
+ * selects MDX unless the top-level `dialect` option overrides it. Exported
+ * to JS as `renderHtml`.
  */
 export function renderHtml(source: string, options_json: string): string;
 

package/dist/wasm/zfb_md_wasm_glue.zfb-resource.mjs

@@ -155,7 +155,9 @@ export function parseToAst(source, options_json) {
  *
  * Returns a JSON string: `{ "html": string|null, "frontmatter": json,
  * "diagnostics": Diagnostic[] }` — see the crate docs for the options
- * and diagnostics shapes. Exported to JS as `renderHtml`.
+ * and diagnostics shapes. A `.md` filename selects CommonMark and `.mdx`
+ * selects MDX unless the top-level `dialect` option overrides it. Exported
+ * to JS as `renderHtml`.
  * @param {string} source
  * @param {string} options_json
  * @returns {string}

package/dist/wasm-parse/zfb_md_wasm_parse_bg.wasm.d.ts

@@ -0,0 +1,10 @@
+/* tslint:disable */
+/* eslint-disable */
+export const memory: WebAssembly.Memory;
+export const __forceTrapForTests: () => void;
+export const parseToAst: (a: number, b: number, c: number, d: number, e: number) => void;
+export const version: (a: number) => void;
+export const __wbindgen_add_to_stack_pointer: (a: number) => number;
+export const __wbindgen_export: (a: number, b: number) => number;
+export const __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;
+export const __wbindgen_export3: (a: number, b: number, c: number) => void;

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

@@ -0,0 +1,108 @@
+/* tslint:disable */
+/* eslint-disable */
+
+/**
+ * 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.
+ */
+export function __forceTrapForTests(): void;
+
+/**
+ * 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.
+ */
+export function parseToAst(source: string, options_json: string): string;
+
+/**
+ * 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`).
+ */
+export function version(): string;
+
+export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
+
+export interface InitOutput {
+    readonly memory: WebAssembly.Memory;
+    readonly __forceTrapForTests: () => void;
+    readonly parseToAst: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly version: (a: number) => void;
+    readonly __wbindgen_add_to_stack_pointer: (a: number) => number;
+    readonly __wbindgen_export: (a: number, b: number) => number;
+    readonly __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;
+    readonly __wbindgen_export3: (a: number, b: number, c: number) => void;
+}
+
+export type SyncInitInput = BufferSource | WebAssembly.Module;
+
+/**
+ * Instantiates the given `module`, which can either be bytes or
+ * a precompiled `WebAssembly.Module`.
+ *
+ * @param {{ module: SyncInitInput }} module - Passing `SyncInitInput` directly is deprecated.
+ *
+ * @returns {InitOutput}
+ */
+export function initSync(module: { module: SyncInitInput } | SyncInitInput): InitOutput;
+
+/**
+ * If `module_or_path` is {RequestInfo} or {URL}, makes a request and
+ * for everything else, calls `WebAssembly.instantiate` directly.
+ *
+ * @param {{ module_or_path: InitInput | Promise<InitInput> }} module_or_path - Passing `InitInput` directly is deprecated.
+ *
+ * @returns {Promise<InitOutput>}
+ */
+export default function __wbg_init (module_or_path?: { module_or_path: InitInput | Promise<InitInput> } | InitInput | Promise<InitInput>): Promise<InitOutput>;

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

@@ -0,0 +1,300 @@
+/* @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.
+ */
+export 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}
+ */
+export 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}
+ */
+export 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;
+}
+
+async function __wbg_load(module, imports) {
+    if (typeof Response === 'function' && module instanceof Response) {
+        if (typeof WebAssembly.instantiateStreaming === 'function') {
+            try {
+                return await WebAssembly.instantiateStreaming(module, imports);
+            } catch (e) {
+                const validResponse = module.ok && expectedResponseType(module.type);
+
+                if (validResponse && module.headers.get('Content-Type') !== 'application/wasm') {
+                    console.warn("`WebAssembly.instantiateStreaming` failed because your server does not serve Wasm with `application/wasm` MIME type. Falling back to `WebAssembly.instantiate` which is slower. Original error:\n", e);
+
+                } else { throw e; }
+            }
+        }
+
+        const bytes = await module.arrayBuffer();
+        return await WebAssembly.instantiate(bytes, imports);
+    } else {
+        const instance = await WebAssembly.instantiate(module, imports);
+
+        if (instance instanceof WebAssembly.Instance) {
+            return { instance, module };
+        } else {
+            return instance;
+        }
+    }
+
+    function expectedResponseType(type) {
+        switch (type) {
+            case 'basic': case 'cors': case 'default': return true;
+        }
+        return false;
+    }
+}
+
+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);
+}
+
+async function __wbg_init(module_or_path) {
+    if (wasm !== undefined) return wasm;
+
+
+    if (module_or_path !== undefined) {
+        if (Object.getPrototypeOf(module_or_path) === Object.prototype) {
+            ({module_or_path} = module_or_path)
+        } else {
+            console.warn('using deprecated parameters for the initialization function; pass a single object instead')
+        }
+    }
+
+    if (module_or_path === undefined) {
+        module_or_path = new URL('zfb_md_wasm_parse_bg.wasm', import.meta.url);
+    }
+    const imports = __wbg_get_imports();
+
+    if (typeof module_or_path === 'string' || (typeof Request === 'function' && module_or_path instanceof Request) || (typeof URL === 'function' && module_or_path instanceof URL)) {
+        module_or_path = fetch(module_or_path);
+    }
+
+    const { instance, module } = await __wbg_load(await module_or_path, imports);
+
+    return __wbg_finalize_init(instance, module);
+}
+
+export { initSync, __wbg_init as default };

package/dist/wasm-render/zfb_md_wasm_render_bg.wasm.d.ts

@@ -0,0 +1,10 @@
+/* tslint:disable */
+/* eslint-disable */
+export const memory: WebAssembly.Memory;
+export const __forceTrapForTests: () => void;
+export const renderHtml: (a: number, b: number, c: number, d: number, e: number) => void;
+export const version: (a: number) => void;
+export const __wbindgen_add_to_stack_pointer: (a: number) => number;
+export const __wbindgen_export: (a: number, b: number) => number;
+export const __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;
+export const __wbindgen_export3: (a: number, b: number, c: number) => void;