@takazudo/zfb-md-wasm 2.7.1 → 2.9.0

package/dist/runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  CompileResult,\n  HighlightCodeOptions,\n  HighlightCodeResult,\n  ParseToAstOptions,\n  ParseToAstResult,\n  RenderHtmlResult,\n  ZfbMdWasmOptions,\n} from \"./types.js\";\n\ninterface WasmGlueModule {\n  // Keep this deliberately structural instead of importing the generated\n  // glue's declaration file. The browser entry imports that file as a *URL\n  // resource*, while the direct entry imports it dynamically. Both paths\n  // nevertheless use the same wasm-bindgen surface and recovery\n  // implementation below.\n  //\n  // `compile`/`renderHtml` are optional: the highlight-only wasm artifact\n  // (`./highlight` entry, zfb#1849, epic zfb#1845) is compiled with the\n  // `pipeline` Cargo feature off (see crates/zfb-md-wasm/Cargo.toml), so its\n  // wasm-bindgen glue never generates these exports at all. `createWasmApi`\n  // below is shared by both entries; only `src/index.ts`/`src/browser.ts`\n  // re-export the functions that call them.\n  initSync(input?: { module: WebAssembly.Module }): unknown;\n  compile?(source: string, optionsJson: string): string;\n  renderHtml?(source: string, optionsJson: string): string;\n  // Raw-mdast export (zfb#1857, epic zfb#1854); pipeline-gated like\n  // compile/renderHtml -- the highlight-only artifact never generates it.\n  parseToAst?(source: string, optionsJson: string): string;\n  highlightCode(code: string, optionsJson: string): string;\n  version(): string;\n  __forceTrapForTests(): void;\n}\n\nexport interface WasmResourceConfig {\n  glueUrl: URL;\n  loadWasmBytes(): Promise<ArrayBuffer>;\n  /** @internal Deterministic test seam; production uses WebAssembly.compile. */\n  compileWasm?(bytes: ArrayBuffer): Promise<WebAssembly.Module>;\n  /** @internal Deterministic test seam; production dynamically imports the glue URL. */\n  importGlue?(specifier: string): Promise<WasmGlueModule>;\n}\n\nexport class ZfbMdWasmTrapError extends Error {\n  constructor(cause: unknown) {\n    super(\n      \"zfb-md-wasm: the wasm instance trapped (a Rust panic or internal fault) and has been \" +\n        \"automatically re-instantiated. This is always a bug in zfb-md-wasm -- please report it \" +\n        \"with the input that triggered it.\",\n    );\n    this.name = \"ZfbMdWasmTrapError\";\n    this.cause = cause;\n  }\n}\n\nexport class ZfbMdWasmTrapRecoveryLimitError extends Error {\n  constructor(maxRecoveries: number, cause: unknown) {\n    super(\n      `zfb-md-wasm: wasm trap recovery limit reached after ${maxRecoveries} ` +\n        `successful re-instantiations. Further automatic recovery is disabled to avoid ` +\n        `unbounded ES module record growth. Reload the JS realm before using zfb-md-wasm ` +\n        `again, and please report the input that triggered the repeated traps.`,\n    );\n    this.name = \"ZfbMdWasmTrapRecoveryLimitError\";\n    this.cause = cause;\n  }\n}\n\nexport function createWasmApi({\n  glueUrl,\n  loadWasmBytes,\n  compileWasm = (bytes) => WebAssembly.compile(bytes),\n  importGlue = (specifier) => import(/* @vite-ignore */ specifier) as Promise<WasmGlueModule>,\n}: WasmResourceConfig) {\n  let compiledModulePromise: Promise<WebAssembly.Module> | undefined;\n  let compiledModuleLoads = 0;\n\n  function getCompiledModule(): Promise<WebAssembly.Module> {\n    if (!compiledModulePromise) {\n      compiledModuleLoads += 1;\n      const attempt = Promise.resolve().then(loadWasmBytes).then(compileWasm);\n      compiledModulePromise = attempt;\n      void attempt.catch(() => {\n        // A rejected attempt must be retryable, but it must not erase a newer\n        // attempt if its rejection cleanup runs late.\n        if (compiledModulePromise === attempt) {\n          compiledModulePromise = undefined;\n        }\n      });\n    }\n    return compiledModulePromise;\n  }\n\n  const MAX_TRAP_RECOVERIES = 16;\n\n  let currentGeneration = 0;\n  let trapRecoveriesStarted = 0;\n  let freshInstanceStarts = 0;\n  let glueImportAttempts = 0;\n  let terminalTrapRecoveryError: ZfbMdWasmTrapRecoveryLimitError | undefined;\n\n  interface Instance {\n    generation: number;\n    glue: WasmGlueModule;\n  }\n\n  /**\n   * Every fresh instance attempt creates a new wasm-bindgen glue module\n   * record. The import-attempt nonce is deliberately independent of the trap\n   * generation: transient import/initSync failures need a new module record\n   * without consuming the bounded trap-recovery budget.\n   */\n  async function freshInstance(generation: number): Promise<Instance> {\n    freshInstanceStarts += 1;\n    glueImportAttempts += 1;\n    const glueSpecifier = new URL(glueUrl.href);\n    glueSpecifier.searchParams.set(\"zfbMdWasmGen\", String(generation));\n    glueSpecifier.searchParams.set(\"zfbMdWasmAttempt\", String(glueImportAttempts));\n    const [module, glue] = await Promise.all([\n      getCompiledModule(),\n      // Deferring the injected function also converts a synchronous test-seam\n      // throw into the rejection handled by the retryable instance cache.\n      Promise.resolve().then(() => importGlue(glueSpecifier.href)),\n    ]);\n    glue.initSync({ module });\n    return { generation, glue };\n  }\n\n  let instancePromise: Promise<Instance> | undefined;\n\n  function startInstance(generation: number): Promise<Instance> {\n    const attempt = freshInstance(generation);\n    instancePromise = attempt;\n    void attempt.catch(() => {\n      // Trap recovery can replace the installed instance promise. Never let a\n      // stale initialization rejection clear that newer attempt.\n      if (instancePromise === attempt) {\n        instancePromise = undefined;\n      }\n    });\n    return attempt;\n  }\n\n  function getInstance(): Promise<Instance> {\n    if (terminalTrapRecoveryError) {\n      return Promise.reject(terminalTrapRecoveryError);\n    }\n    if (!instancePromise) {\n      return startInstance(currentGeneration);\n    }\n    return instancePromise;\n  }\n\n  function isTrap(err: unknown): boolean {\n    return typeof WebAssembly !== \"undefined\" && err instanceof WebAssembly.RuntimeError;\n  }\n\n  async function recoverAfterTrap(observedGeneration: number, cause: unknown): Promise<void> {\n    if (terminalTrapRecoveryError) {\n      throw terminalTrapRecoveryError;\n    }\n\n    // CAS-style single-flight: reporters for an already-replaced generation\n    // await its replacement instead of creating another glue module record.\n    if (observedGeneration !== currentGeneration) {\n      await getInstance();\n      return;\n    }\n\n    if (trapRecoveriesStarted >= MAX_TRAP_RECOVERIES) {\n      terminalTrapRecoveryError = new ZfbMdWasmTrapRecoveryLimitError(MAX_TRAP_RECOVERIES, cause);\n      instancePromise = undefined;\n      throw terminalTrapRecoveryError;\n    }\n\n    trapRecoveriesStarted += 1;\n    currentGeneration += 1;\n    await startInstance(currentGeneration);\n  }\n\n  async function callWasm<T>(fn: (instance: Instance) => T): Promise<T> {\n    const instance = await getInstance();\n    try {\n      return fn(instance);\n    } catch (err) {\n      if (!isTrap(err)) {\n        throw err;\n      }\n      await recoverAfterTrap(instance.generation, err);\n      throw new ZfbMdWasmTrapError(err);\n    }\n  }\n\n  async function init(): Promise<void> {\n    await getInstance();\n  }\n\n  // Both throw helpers below fire only if `compile`/`renderHtml` were\n  // somehow invoked against the highlight-only glue -- unreachable through\n  // the public API surface, since `src/highlight.ts`/`src/highlight-browser.ts`\n  // never re-export these two functions. Kept as a clear runtime error\n  // rather than a silent `undefined()` crash.\n  function requirePipelineExport<T>(fn: T | undefined, name: string): T {\n    if (!fn) {\n      throw new Error(\n        `zfb-md-wasm: ${name}() is not available in the highlight-only wasm artifact ` +\n          `(built with the \\`pipeline\\` Cargo feature off) -- use the default \\`.\\` entry instead.`,\n      );\n    }\n    return fn;\n  }\n\n  async function compile(source: string, options: ZfbMdWasmOptions = {}): Promise<CompileResult> {\n    const optionsJson = JSON.stringify(options);\n    const json = await callWasm(({ glue }) =>\n      requirePipelineExport(glue.compile, \"compile\").call(glue, source, optionsJson),\n    );\n    return JSON.parse(json) as CompileResult;\n  }\n\n  async function renderHtml(\n    source: string,\n    options: ZfbMdWasmOptions = {},\n  ): Promise<RenderHtmlResult> {\n    const optionsJson = JSON.stringify(options);\n    const json = await callWasm(({ glue }) =>\n      requirePipelineExport(glue.renderHtml, \"renderHtml\").call(glue, source, optionsJson),\n    );\n    return JSON.parse(json) as RenderHtmlResult;\n  }\n\n  /**\n   * Parse markdown/MDX into a raw mdast tree (zfb#1857, epic zfb#1854).\n   * The `parseToAst + JSON.parse` round trip here IS the product cost the\n   * epic's benchmark measures against remark-parse. See `types.ts`'s\n   * `ParseToAstResult`/`MdastNode` docs for the result shape and the\n   * UTF-16 position contract.\n   */\n  async function parseToAst(\n    source: string,\n    options: ParseToAstOptions = {},\n  ): Promise<ParseToAstResult> {\n    const optionsJson = JSON.stringify(options);\n    const json = await callWasm(({ glue }) =>\n      requirePipelineExport(glue.parseToAst, \"parseToAst\").call(glue, source, optionsJson),\n    );\n    return JSON.parse(json) as ParseToAstResult;\n  }\n\n  async function highlightCode(\n    code: string,\n    options: HighlightCodeOptions,\n  ): Promise<HighlightCodeResult> {\n    const optionsJson = JSON.stringify(options);\n    const json = await callWasm(({ glue }) => glue.highlightCode(code, optionsJson));\n    return JSON.parse(json) as HighlightCodeResult;\n  }\n\n  async function version(): Promise<string> {\n    return callWasm(({ glue }) => glue.version());\n  }\n\n  /** @internal Test-only hook that forces the current instance to trap. */\n  async function __forceTrapForTests(): Promise<void> {\n    await callWasm(({ glue }) => glue.__forceTrapForTests());\n  }\n\n  /** @internal Test-only observability for the bounded recovery contract. */\n  function __getTrapRecoveryStateForTests(): {\n    compiledModuleLoads: number;\n    currentGeneration: number;\n    freshInstanceStarts: number;\n    glueImportAttempts: number;\n    maxTrapRecoveries: number;\n    trapRecoveriesStarted: number;\n    terminal: boolean;\n  } {\n    return {\n      compiledModuleLoads,\n      currentGeneration,\n      freshInstanceStarts,\n      glueImportAttempts,\n      maxTrapRecoveries: MAX_TRAP_RECOVERIES,\n      trapRecoveriesStarted,\n      terminal: !!terminalTrapRecoveryError,\n    };\n  }\n\n  return {\n    init,\n    compile,\n    renderHtml,\n    parseToAst,\n    highlightCode,\n    version,\n    __forceTrapForTests,\n    __getTrapRecoveryStateForTests,\n  };\n}\n"]}
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  CompileResult,\n  HighlightCodeOptions,\n  HighlightCodeResult,\n  ParseToAstOptions,\n  ParseToAstResult,\n  RenderHtmlResult,\n  ZfbMdWasmOptions,\n} from \"./types.js\";\n\ninterface WasmGlueModule {\n  // Keep this deliberately structural instead of importing the generated\n  // glue's declaration file. The browser entry imports that file as a *URL\n  // resource*, while the direct entry imports it dynamically. Both paths\n  // nevertheless use the same wasm-bindgen surface and recovery\n  // implementation below.\n  //\n  // Capability functions are structural and optional because each singleton\n  // artifact's wasm-bindgen glue contains only its selected Rust export.\n  // Public entries expose only the matching calls from `createWasmApi`.\n  initSync(input?: { module: WebAssembly.Module }): unknown;\n  compile?(source: string, optionsJson: string): string;\n  renderHtml?(source: string, optionsJson: string): string;\n  // Raw-mdast export (zfb#1857, epic zfb#1854).\n  parseToAst?(source: string, optionsJson: string): string;\n  highlightCode?(code: string, optionsJson: string): string;\n  version(): string;\n  __forceTrapForTests(): void;\n}\n\nexport interface WasmResourceConfig {\n  glueUrl: URL;\n  loadWasmBytes(): Promise<ArrayBuffer>;\n  /** @internal Deterministic test seam; production uses WebAssembly.compile. */\n  compileWasm?(bytes: ArrayBuffer): Promise<WebAssembly.Module>;\n  /** @internal Deterministic test seam; production dynamically imports the glue URL. */\n  importGlue?(specifier: string): Promise<WasmGlueModule>;\n}\n\nexport class ZfbMdWasmTrapError extends Error {\n  constructor(cause: unknown) {\n    super(\n      \"zfb-md-wasm: the wasm instance trapped (a Rust panic or internal fault) and has been \" +\n        \"automatically re-instantiated. This is always a bug in zfb-md-wasm -- please report it \" +\n        \"with the input that triggered it.\",\n    );\n    this.name = \"ZfbMdWasmTrapError\";\n    this.cause = cause;\n  }\n}\n\nexport class ZfbMdWasmTrapRecoveryLimitError extends Error {\n  constructor(maxRecoveries: number, cause: unknown) {\n    super(\n      `zfb-md-wasm: wasm trap recovery limit reached after ${maxRecoveries} ` +\n        `successful re-instantiations. Further automatic recovery is disabled to avoid ` +\n        `unbounded ES module record growth. Reload the JS realm before using zfb-md-wasm ` +\n        `again, and please report the input that triggered the repeated traps.`,\n    );\n    this.name = \"ZfbMdWasmTrapRecoveryLimitError\";\n    this.cause = cause;\n  }\n}\n\nexport function createWasmApi({\n  glueUrl,\n  loadWasmBytes,\n  compileWasm = (bytes) => WebAssembly.compile(bytes),\n  importGlue = (specifier) => import(/* @vite-ignore */ specifier) as Promise<WasmGlueModule>,\n}: WasmResourceConfig) {\n  let compiledModulePromise: Promise<WebAssembly.Module> | undefined;\n  let compiledModuleLoads = 0;\n\n  function getCompiledModule(): Promise<WebAssembly.Module> {\n    if (!compiledModulePromise) {\n      compiledModuleLoads += 1;\n      const attempt = Promise.resolve().then(loadWasmBytes).then(compileWasm);\n      compiledModulePromise = attempt;\n      void attempt.catch(() => {\n        // A rejected attempt must be retryable, but it must not erase a newer\n        // attempt if its rejection cleanup runs late.\n        if (compiledModulePromise === attempt) {\n          compiledModulePromise = undefined;\n        }\n      });\n    }\n    return compiledModulePromise;\n  }\n\n  const MAX_TRAP_RECOVERIES = 16;\n\n  let currentGeneration = 0;\n  let trapRecoveriesStarted = 0;\n  let freshInstanceStarts = 0;\n  let glueImportAttempts = 0;\n  let terminalTrapRecoveryError: ZfbMdWasmTrapRecoveryLimitError | undefined;\n\n  interface Instance {\n    generation: number;\n    glue: WasmGlueModule;\n  }\n\n  /**\n   * Every fresh instance attempt creates a new wasm-bindgen glue module\n   * record. The import-attempt nonce is deliberately independent of the trap\n   * generation: transient import/initSync failures need a new module record\n   * without consuming the bounded trap-recovery budget.\n   */\n  async function freshInstance(generation: number): Promise<Instance> {\n    freshInstanceStarts += 1;\n    glueImportAttempts += 1;\n    const glueSpecifier = new URL(glueUrl.href);\n    glueSpecifier.searchParams.set(\"zfbMdWasmGen\", String(generation));\n    glueSpecifier.searchParams.set(\"zfbMdWasmAttempt\", String(glueImportAttempts));\n    const [module, glue] = await Promise.all([\n      getCompiledModule(),\n      // Deferring the injected function also converts a synchronous test-seam\n      // throw into the rejection handled by the retryable instance cache.\n      Promise.resolve().then(() => importGlue(glueSpecifier.href)),\n    ]);\n    glue.initSync({ module });\n    return { generation, glue };\n  }\n\n  let instancePromise: Promise<Instance> | undefined;\n\n  function startInstance(generation: number): Promise<Instance> {\n    const attempt = freshInstance(generation);\n    instancePromise = attempt;\n    void attempt.catch(() => {\n      // Trap recovery can replace the installed instance promise. Never let a\n      // stale initialization rejection clear that newer attempt.\n      if (instancePromise === attempt) {\n        instancePromise = undefined;\n      }\n    });\n    return attempt;\n  }\n\n  function getInstance(): Promise<Instance> {\n    if (terminalTrapRecoveryError) {\n      return Promise.reject(terminalTrapRecoveryError);\n    }\n    if (!instancePromise) {\n      return startInstance(currentGeneration);\n    }\n    return instancePromise;\n  }\n\n  function isTrap(err: unknown): boolean {\n    return typeof WebAssembly !== \"undefined\" && err instanceof WebAssembly.RuntimeError;\n  }\n\n  async function recoverAfterTrap(observedGeneration: number, cause: unknown): Promise<void> {\n    if (terminalTrapRecoveryError) {\n      throw terminalTrapRecoveryError;\n    }\n\n    // CAS-style single-flight: reporters for an already-replaced generation\n    // await its replacement instead of creating another glue module record.\n    if (observedGeneration !== currentGeneration) {\n      await getInstance();\n      return;\n    }\n\n    if (trapRecoveriesStarted >= MAX_TRAP_RECOVERIES) {\n      terminalTrapRecoveryError = new ZfbMdWasmTrapRecoveryLimitError(MAX_TRAP_RECOVERIES, cause);\n      instancePromise = undefined;\n      throw terminalTrapRecoveryError;\n    }\n\n    trapRecoveriesStarted += 1;\n    currentGeneration += 1;\n    await startInstance(currentGeneration);\n  }\n\n  async function callWasm<T>(fn: (instance: Instance) => T): Promise<T> {\n    const instance = await getInstance();\n    try {\n      return fn(instance);\n    } catch (err) {\n      if (!isTrap(err)) {\n        throw err;\n      }\n      await recoverAfterTrap(instance.generation, err);\n      throw new ZfbMdWasmTrapError(err);\n    }\n  }\n\n  async function init(): Promise<void> {\n    await getInstance();\n  }\n\n  // Public entry surfaces make missing calls unreachable. This guard keeps\n  // structural glue mismatches artifact-neutral and actionable.\n  function requireCapability<T>(fn: T | undefined, name: string): T {\n    if (!fn) {\n      throw new Error(\n        `zfb-md-wasm: ${name}() is not available in this wasm artifact. ` +\n          `Import an entry whose artifact provides that capability.`,\n      );\n    }\n    return fn;\n  }\n\n  async function compile(source: string, options: ZfbMdWasmOptions = {}): Promise<CompileResult> {\n    const optionsJson = JSON.stringify(options);\n    const json = await callWasm(({ glue }) =>\n      requireCapability(glue.compile, \"compile\").call(glue, source, optionsJson),\n    );\n    return JSON.parse(json) as CompileResult;\n  }\n\n  async function renderHtml(\n    source: string,\n    options: ZfbMdWasmOptions = {},\n  ): Promise<RenderHtmlResult> {\n    const optionsJson = JSON.stringify(options);\n    const json = await callWasm(({ glue }) =>\n      requireCapability(glue.renderHtml, \"renderHtml\").call(glue, source, optionsJson),\n    );\n    return JSON.parse(json) as RenderHtmlResult;\n  }\n\n  /**\n   * Parse markdown/MDX into a raw mdast tree (zfb#1857, epic zfb#1854).\n   * The `parseToAst + JSON.parse` round trip here IS the product cost the\n   * epic's benchmark measures against remark-parse. See `types.ts`'s\n   * `ParseToAstResult`/`MdastNode` docs for the result shape and the\n   * UTF-16 position contract.\n   */\n  async function parseToAst(\n    source: string,\n    options: ParseToAstOptions = {},\n  ): Promise<ParseToAstResult> {\n    const optionsJson = JSON.stringify(options);\n    const json = await callWasm(({ glue }) =>\n      requireCapability(glue.parseToAst, \"parseToAst\").call(glue, source, optionsJson),\n    );\n    return JSON.parse(json) as ParseToAstResult;\n  }\n\n  async function highlightCode(\n    code: string,\n    options: HighlightCodeOptions,\n  ): Promise<HighlightCodeResult> {\n    const optionsJson = JSON.stringify(options);\n    const json = await callWasm(({ glue }) =>\n      requireCapability(glue.highlightCode, \"highlightCode\").call(glue, code, optionsJson),\n    );\n    return JSON.parse(json) as HighlightCodeResult;\n  }\n\n  async function version(): Promise<string> {\n    return callWasm(({ glue }) => glue.version());\n  }\n\n  /** @internal Test-only hook that forces the current instance to trap. */\n  async function __forceTrapForTests(): Promise<void> {\n    await callWasm(({ glue }) => glue.__forceTrapForTests());\n  }\n\n  /** @internal Test-only observability for the bounded recovery contract. */\n  function __getTrapRecoveryStateForTests(): {\n    compiledModuleLoads: number;\n    currentGeneration: number;\n    freshInstanceStarts: number;\n    glueImportAttempts: number;\n    maxTrapRecoveries: number;\n    trapRecoveriesStarted: number;\n    terminal: boolean;\n  } {\n    return {\n      compiledModuleLoads,\n      currentGeneration,\n      freshInstanceStarts,\n      glueImportAttempts,\n      maxTrapRecoveries: MAX_TRAP_RECOVERIES,\n      trapRecoveriesStarted,\n      terminal: !!terminalTrapRecoveryError,\n    };\n  }\n\n  return {\n    init,\n    compile,\n    renderHtml,\n    parseToAst,\n    highlightCode,\n    version,\n    __forceTrapForTests,\n    __getTrapRecoveryStateForTests,\n  };\n}\n"]}

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>;