@markup-carve/carve-wasm 0.1.2 → 0.1.4

package/carve_wasm_bg.js

@@ -1,3 +1,156 @@
+/**
+ * Replay patch JSON onto a PART 12 tree, returning the result as AST JSON.
+ * @param {string} ast
+ * @param {string} patch
+ * @returns {string}
+ */
+export function applyAstPatch(ast, patch) {
+    let deferred4_0;
+    let deferred4_1;
+    try {
+        const ptr0 = passStringToWasm0(ast, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(patch, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len1 = WASM_VECTOR_LEN;
+        const ret = wasm.applyAstPatch(ptr0, len0, ptr1, len1);
+        var ptr3 = ret[0];
+        var len3 = ret[1];
+        if (ret[3]) {
+            ptr3 = 0; len3 = 0;
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        deferred4_0 = ptr3;
+        deferred4_1 = len3;
+        return getStringFromWasm0(ptr3, len3);
+    } finally {
+        wasm.__wbindgen_free(deferred4_0, deferred4_1, 1);
+    }
+}
+
+/**
+ * Apply a security profile to an AST-JSON document (PART 12), keeping the
+ * filtered tree.
+ *
+ * The `profile` render option filters on the way to HTML and throws the result
+ * of the filtering away. This is the same pass with the tree kept, so a host
+ * that stores, diffs or re-renders an untrusted document does not have to
+ * render HTML and parse it back to get one.
+ *
+ * `violations` reports what the filter degraded or stripped, which the HTML
+ * path cannot: a profile whose action is `error` throws instead, so a
+ * resolved call under `to-text` or `strip` is the only place this is visible.
+ *
+ * Only `profileBaseHost` and `smartTypography` are read from `options`. The
+ * rest of the render options describe a renderer, and this is not one.
+ *
+ * The profile's `max_length` is NOT enforced here: the engine applies it to the
+ * source bytes before a parse, and this entry point is handed a tree.
+ * @param {string} json
+ * @param {string} profile
+ * @param {object | null} [options]
+ * @returns {ProfileFilterResult}
+ */
+export function applyProfile(json, profile, options) {
+    const ptr0 = passStringToWasm0(json, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ptr1 = passStringToWasm0(profile, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len1 = WASM_VECTOR_LEN;
+    const ret = wasm.applyProfile(ptr0, len0, ptr1, len1, isLikeNone(options) ? 0 : addToExternrefTable0(options));
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return takeFromExternrefTable0(ret[0]);
+}
+
+/**
+ * Replay a reversible patch, forward or inverted.
+ *
+ * The fingerprint is checked first: a tree that is not the one this patch was
+ * made against is refused rather than half-patched. That is a broken caller
+ * contract, so it throws.
+ * @param {string} ast
+ * @param {string} patch
+ * @param {boolean | null} [inverse]
+ * @returns {string}
+ */
+export function applyReversibleAstPatch(ast, patch, inverse) {
+    let deferred4_0;
+    let deferred4_1;
+    try {
+        const ptr0 = passStringToWasm0(ast, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(patch, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len1 = WASM_VECTOR_LEN;
+        const ret = wasm.applyReversibleAstPatch(ptr0, len0, ptr1, len1, isLikeNone(inverse) ? 0xFFFFFF : inverse ? 1 : 0);
+        var ptr3 = ret[0];
+        var len3 = ret[1];
+        if (ret[3]) {
+            ptr3 = 0; len3 = 0;
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        deferred4_0 = ptr3;
+        deferred4_1 = len3;
+        return getStringFromWasm0(ptr3, len3);
+    } finally {
+        wasm.__wbindgen_free(deferred4_0, deferred4_1, 1);
+    }
+}
+
+/**
+ * Apply a trusted patch after its source length and fingerprint still match.
+ * @param {string} source
+ * @param {any} patch
+ * @returns {string}
+ */
+export function applySourcePatch(source, patch) {
+    let deferred3_0;
+    let deferred3_1;
+    try {
+        const ptr0 = passStringToWasm0(source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.applySourcePatch(ptr0, len0, patch);
+        var ptr2 = ret[0];
+        var len2 = ret[1];
+        if (ret[3]) {
+            ptr2 = 0; len2 = 0;
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        deferred3_0 = ptr2;
+        deferred3_1 = len2;
+        return getStringFromWasm0(ptr2, len2);
+    } finally {
+        wasm.__wbindgen_free(deferred3_0, deferred3_1, 1);
+    }
+}
+
+/**
+ * Render an AST-JSON document (PART 12) to ANSI-styled text. See
+ * [`ast_json_to_markdown`], including what a tree without positions costs.
+ * @param {string} json
+ * @param {object | null} [options]
+ * @returns {string}
+ */
+export function astJsonToAnsi(json, options) {
+    let deferred3_0;
+    let deferred3_1;
+    try {
+        const ptr0 = passStringToWasm0(json, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.astJsonToAnsi(ptr0, len0, isLikeNone(options) ? 0 : addToExternrefTable0(options));
+        var ptr2 = ret[0];
+        var len2 = ret[1];
+        if (ret[3]) {
+            ptr2 = 0; len2 = 0;
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        deferred3_0 = ptr2;
+        deferred3_1 = len2;
+        return getStringFromWasm0(ptr2, len2);
+    } finally {
+        wasm.__wbindgen_free(deferred3_0, deferred3_1, 1);
+    }
+}
+
 /**
  * Render an AST-JSON document (PART 12) back to canonical Carve source.
  *
@@ -62,6 +215,242 @@ export function astJsonToHtml(json, options) {
     }
 }
 
+/**
+ * Render an AST-JSON document (PART 12) to Markdown.
+ *
+ * The direct call for a host that already holds a tree. Without it Markdown was
+ * reached through `astJsonToCarve` and then `toMarkdown`: a canonical write, a
+ * re-parse and a second render for one answer, and lossier than this, because a
+ * tree holding something no Carve source can spell is refused by the write
+ * rather than rendered.
+ *
+ * Takes the same options object as [`to_markdown_with_options`], and reads the
+ * same narrow part of it. The profile filter and the `before_render` hooks run,
+ * as they do in [`ast_json_to_html`].
+ *
+ * ORDERING FOLLOWS THE TREE. `toMarkdown` parses with positions on, because
+ * section 7 orders collected definitions by source position. A tree arriving as
+ * JSON carries whatever positions its producer put there, and one carrying none
+ * prints its footnote and link definitions in label order. That is the only
+ * order available to a tree without spans, so it is reported here rather than
+ * repaired.
+ * @param {string} json
+ * @param {object | null} [options]
+ * @returns {string}
+ */
+export function astJsonToMarkdown(json, options) {
+    let deferred3_0;
+    let deferred3_1;
+    try {
+        const ptr0 = passStringToWasm0(json, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.astJsonToMarkdown(ptr0, len0, isLikeNone(options) ? 0 : addToExternrefTable0(options));
+        var ptr2 = ret[0];
+        var len2 = ret[1];
+        if (ret[3]) {
+            ptr2 = 0; len2 = 0;
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        deferred3_0 = ptr2;
+        deferred3_1 = len2;
+        return getStringFromWasm0(ptr2, len2);
+    } finally {
+        wasm.__wbindgen_free(deferred3_0, deferred3_1, 1);
+    }
+}
+
+/**
+ * Render an AST-JSON document (PART 12) to plain text. See
+ * [`ast_json_to_markdown`], including what a tree without positions costs.
+ * @param {string} json
+ * @param {object | null} [options]
+ * @returns {string}
+ */
+export function astJsonToPlainText(json, options) {
+    let deferred3_0;
+    let deferred3_1;
+    try {
+        const ptr0 = passStringToWasm0(json, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.astJsonToPlainText(ptr0, len0, isLikeNone(options) ? 0 : addToExternrefTable0(options));
+        var ptr2 = ret[0];
+        var len2 = ret[1];
+        if (ret[3]) {
+            ptr2 = 0; len2 = 0;
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        deferred3_0 = ptr2;
+        deferred3_1 = len2;
+        return getStringFromWasm0(ptr2, len2);
+    } finally {
+        wasm.__wbindgen_free(deferred3_0, deferred3_1, 1);
+    }
+}
+
+/**
+ * The difference between two PART 12 trees, as patch JSON.
+ *
+ * ```js
+ * const patch = createAstPatch(parseJson('# One\n'), parseJson('# Two\n'))
+ * applyAstPatch(parseJson('# One\n'), patch) // the '# Two' tree
+ * ```
+ *
+ * Trees and patches both cross as JSON strings, matching `parseJson` and
+ * `astJsonToHtml`. A patch carries node payloads, so it carries arbitrary
+ * document text - the reason `parseJson` chose a string in the first place.
+ *
+ * The engine's `ast_patch_to_json` and `ast_patch_from_json` are not bound
+ * separately. With the patch crossing as JSON they ARE the encoding of this
+ * pair, and a host calling them would be converting JSON it already holds.
+ *
+ * The operations are position-independent `{ op, path, value }`, so a patch
+ * stays meaningful against a tree that moved underneath it - unlike a source
+ * patch, which `createSourcePatch` fingerprints against staleness.
+ * @param {string} before
+ * @param {string} after
+ * @returns {string}
+ */
+export function createAstPatch(before, after) {
+    let deferred4_0;
+    let deferred4_1;
+    try {
+        const ptr0 = passStringToWasm0(before, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(after, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len1 = WASM_VECTOR_LEN;
+        const ret = wasm.createAstPatch(ptr0, len0, ptr1, len1);
+        var ptr3 = ret[0];
+        var len3 = ret[1];
+        if (ret[3]) {
+            ptr3 = 0; len3 = 0;
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        deferred4_0 = ptr3;
+        deferred4_1 = len3;
+        return getStringFromWasm0(ptr3, len3);
+    } finally {
+        wasm.__wbindgen_free(deferred4_0, deferred4_1, 1);
+    }
+}
+
+/**
+ * The same difference with its inverse and both fingerprints, as one JSON
+ * object: `{ forward, inverse, beforeFingerprint, afterFingerprint }`.
+ *
+ * This is the shape an undo step wants. THE STACK IS THE HOST'S: every entry
+ * point in this package is a pure function that owns nothing, so there is no
+ * history kept here to undo against, and a browser host already has one - a
+ * key handler, a toolbar, an editor's own history plugin.
+ *
+ * What the pair adds over two `createAstPatch` calls is the precondition.
+ * [`apply_reversible_ast_patch`] refuses a tree whose fingerprint is not the
+ * one the patch was made against, so an undo cannot be replayed onto a
+ * document that has moved on.
+ * @param {string} before
+ * @param {string} after
+ * @returns {string}
+ */
+export function createReversibleAstPatch(before, after) {
+    let deferred4_0;
+    let deferred4_1;
+    try {
+        const ptr0 = passStringToWasm0(before, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(after, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len1 = WASM_VECTOR_LEN;
+        const ret = wasm.createReversibleAstPatch(ptr0, len0, ptr1, len1);
+        var ptr3 = ret[0];
+        var len3 = ret[1];
+        if (ret[3]) {
+            ptr3 = 0; len3 = 0;
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        deferred4_0 = ptr3;
+        deferred4_1 = len3;
+        return getStringFromWasm0(ptr3, len3);
+    } finally {
+        wasm.__wbindgen_free(deferred4_0, deferred4_1, 1);
+    }
+}
+
+/**
+ * Build the smallest single UTF-8 byte-range replacement between two sources.
+ * @param {string} source
+ * @param {string} replacement
+ * @param {string} kind
+ * @param {string} code
+ * @returns {SourcePatch}
+ */
+export function createSourcePatch(source, replacement, kind, code) {
+    const ptr0 = passStringToWasm0(source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ptr1 = passStringToWasm0(replacement, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len1 = WASM_VECTOR_LEN;
+    const ptr2 = passStringToWasm0(kind, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len2 = WASM_VECTOR_LEN;
+    const ptr3 = passStringToWasm0(code, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len3 = WASM_VECTOR_LEN;
+    const ret = wasm.createSourcePatch(ptr0, len0, ptr1, len1, ptr2, len2, ptr3, len3);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return takeFromExternrefTable0(ret[0]);
+}
+
+/**
+ * Expand `{{ path }}` include directives (spec PART 9 §19) through a JS
+ * resolver, and hand back the expanded tree as AST JSON.
+ *
+ * The resolver MUST BE SYNCHRONOUS, which decides who can use this. A browser
+ * host that would resolve a path by `fetch` cannot: `fetch` is a Promise and
+ * wasm-bindgen cannot await across the call. A host whose files are already in
+ * memory - an editor with its open buffers, a bundler, a VFS, a test harness -
+ * resolves from that map and is exactly who this is for.
+ *
+ * ```js
+ * const files = new Map([['child.crv', 'Included body.\n']])
+ * expandIncludes('Before.\n\n{{ child.crv }}\n', {
+ *   resolve: (path) => files.get(path) ?? null,
+ * })
+ * // { json, warnings: [], suppressedWarnings: 0, dependencies: […],
+ * //   chargedBytes: 15, resolverErrors: [] }
+ * ```
+ *
+ * The resolver returns the child's source as a string, or
+ * `{ source, id }` when it can name the file canonically - the id is what the
+ * cycle guard compares, so two spellings of one file defeat it without one.
+ * `null` refuses the directive as `not-found`; `{ denial }` refuses it in one
+ * of the classes §19 names.
+ *
+ * An `async` resolver returns a Promise, which is not a string and cannot be
+ * awaited. That is a per-document failure reported in `resolverErrors`,
+ * matching what an `async` `renderers.math` gets from
+ * [`to_html_with_renderers`]: the directive stays literal and the caller is
+ * told why, rather than the value being swallowed or stringified.
+ *
+ * The BUDGETS are part of the contract, not a detail: `maxBytes` defaults to
+ * `max(1 MB, 8 x source bytes)`, `maxDepth` to 16, `maxResolverCalls` to 1000
+ * and `maxWarnings` to 100. They bound what a document of directives can make
+ * a host do, and lowering them is how a host serving untrusted documents keeps
+ * that bounded.
+ *
+ * The tree carries no positions. Expansion merges nodes from several files,
+ * and a span on a node that came from a child would point into a source the
+ * caller did not pass.
+ * @param {string} source
+ * @param {object} options
+ * @returns {IncludeExpansion}
+ */
+export function expandIncludes(source, options) {
+    const ptr0 = passStringToWasm0(source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.expandIncludes(ptr0, len0, options);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return takeFromExternrefTable0(ret[0]);
+}
+
 /**
  * Every extension name this build accepts, in registry order.
  *
@@ -133,7 +522,7 @@ export function fromDjot(source) {
 /**
  * @param {string} source
  * @param {string | null} [mode]
- * @returns {any}
+ * @returns {MigrationResult}
  */
 export function fromHtml(source, mode) {
     const ptr0 = passStringToWasm0(source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
@@ -149,7 +538,7 @@ export function fromHtml(source, mode) {
 
 /**
  * @param {string} source
- * @returns {any}
+ * @returns {MigrationResult}
  */
 export function fromMarkdown(source) {
     const ptr0 = passStringToWasm0(source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
@@ -161,6 +550,77 @@ export function fromMarkdown(source) {
     return takeFromExternrefTable0(ret[0]);
 }
 
+/**
+ * Convert a ProseMirror document back to canonical Carve source.
+ *
+ * The save half of the editor loop. A payload the schema map does not describe
+ * is refused rather than written approximately, so an editor extended with a
+ * node the bridge has never seen fails where it can be reported.
+ * @param {string} doc
+ * @returns {string}
+ */
+export function fromProseMirror(doc) {
+    let deferred3_0;
+    let deferred3_1;
+    try {
+        const ptr0 = passStringToWasm0(doc, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.fromProseMirror(ptr0, len0);
+        var ptr2 = ret[0];
+        var len2 = ret[1];
+        if (ret[3]) {
+            ptr2 = 0; len2 = 0;
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        deferred3_0 = ptr2;
+        deferred3_1 = len2;
+        return getStringFromWasm0(ptr2, len2);
+    } finally {
+        wasm.__wbindgen_free(deferred3_0, deferred3_1, 1);
+    }
+}
+
+/**
+ * Import HTML straight to the tree, as AST JSON.
+ *
+ * `htmlToCarve` writes Carve SOURCE, so a host that wanted the tree had to
+ * re-parse what it had just written - two parses of one document to get one
+ * answer. This is the same importer without that round trip.
+ *
+ * ```js
+ * const { value, report } = htmlToAst('<p>Hello <b>world</b></p>', 'safe')
+ * astJsonToHtml(value)
+ * ```
+ *
+ * Returns the SAME `{ value, report }` shape `htmlToCarve` does, with `value`
+ * holding the tree instead of the source, in the same fidelity vocabulary. A
+ * third result shape for one importer is what that avoids.
+ *
+ * The REPORT IS NOT ALWAYS IDENTICAL, and the difference is the point. A loss
+ * only a WRITER takes is not reported here, because no writer ran (PART 12
+ * §16): a `<figure>` wrapping a table, or a table with an explicit
+ * head/body/foot grouping, has no Carve spelling, so `htmlToCarve` reports
+ * `structure-unspellable` and this does not - the tree keeps the thing that
+ * would have been lost.
+ *
+ * `mode` is spelled as it is there: `safe` (the default), `semantic`, and
+ * trusted-only `roundtrip`.
+ * @param {string} source
+ * @param {string | null} [mode]
+ * @returns {MigrationResult}
+ */
+export function htmlToAst(source, mode) {
+    const ptr0 = passStringToWasm0(source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    var ptr1 = isLikeNone(mode) ? 0 : passStringToWasm0(mode, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    var len1 = WASM_VECTOR_LEN;
+    const ret = wasm.htmlToAst(ptr0, len0, ptr1, len1);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return takeFromExternrefTable0(ret[0]);
+}
+
 /**
  * Import HTML through the Rust HTML5 DOM and canonical Carve writer.
  *
@@ -168,7 +628,7 @@ export function fromMarkdown(source) {
  * decision observable. `roundtrip` is only safe for Carve-produced HTML.
  * @param {string} source
  * @param {string | null} [mode]
- * @returns {any}
+ * @returns {MigrationResult}
  */
 export function htmlToCarve(source, mode) {
     const ptr0 = passStringToWasm0(source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
@@ -182,6 +642,25 @@ export function htmlToCarve(source, mode) {
     return takeFromExternrefTable0(ret[0]);
 }
 
+/**
+ * The accessibility diagnostics, a second family beside `lintCarve`.
+ *
+ * Its own rule ids (`a11y/image-alt`, `a11y/heading-jump`) and its own
+ * severity, which `lintCarve` has no field for. Offsets are `null` when the
+ * node that triggered the rule carried no position.
+ * @param {string} source
+ * @returns {AccessibilityDiagnostic[]}
+ */
+export function lintAccessibility(source) {
+    const ptr0 = passStringToWasm0(source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.lintAccessibility(ptr0, len0);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return takeFromExternrefTable0(ret[0]);
+}
+
 /**
  * Lint a document for the degradations PART 15 describes.
  *
@@ -205,6 +684,135 @@ export function lintCarve(source) {
     return takeFromExternrefTable0(ret[0]);
 }
 
+/**
+ * Lint a document with the same options object the render entry points take.
+ *
+ * `lintCarve` is the option-less form. Which degradations exist depends on the
+ * extensions in play, so a host that renders with a set has to lint with it.
+ * @param {string} source
+ * @param {object | null} [options]
+ * @returns {LintWarning[]}
+ */
+export function lintCarveWithOptions(source, options) {
+    const ptr0 = passStringToWasm0(source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.lintCarveWithOptions(ptr0, len0, isLikeNone(options) ? 0 : addToExternrefTable0(options));
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return takeFromExternrefTable0(ret[0]);
+}
+
+/**
+ * Import Markdown straight to the tree, as AST JSON.
+ *
+ * `fromMarkdown` writes Carve SOURCE, so a host that wanted the tree had to
+ * re-parse what it had just written. This is the same importer without that
+ * round trip. The losses `fromMarkdown` reports are not repeated here; a host
+ * that needs them calls that one.
+ * @param {string} source
+ * @returns {string}
+ */
+export function markdownToAstJson(source) {
+    let deferred2_0;
+    let deferred2_1;
+    try {
+        const ptr0 = passStringToWasm0(source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.markdownToAstJson(ptr0, len0);
+        deferred2_0 = ret[0];
+        deferred2_1 = ret[1];
+        return getStringFromWasm0(ret[0], ret[1]);
+    } finally {
+        wasm.__wbindgen_free(deferred2_0, deferred2_1, 1);
+    }
+}
+
+/**
+ * Three-way merge over PART 12 trees, with conflicts as a VALUE.
+ *
+ * ```js
+ * const { ok, ast, conflicts } = JSON.parse(mergeAst(base, ours, theirs))
+ * ```
+ *
+ * Returns `{ ok, ast, conflicts, resolverErrors }` as one JSON string. A
+ * conflict does NOT throw: it is a result the caller asked for, and two people
+ * editing one document is the ordinary case rather than a broken contract.
+ * `ok` is false, `ast` is null, and `conflicts` says where and why.
+ *
+ * The `{ ok, ast, conflicts }` shape and the three `reason` names -
+ * `both-changed`, `delete-edit`, `concurrent-sequence-edit` - are carve-js's,
+ * so a host merging with either engine reads one contract. The Rust engine
+ * carries no `deleted` flags on a conflict, so that optional carve-js field is
+ * absent here rather than guessed at.
+ *
+ * `options.resolve` is an optional `(conflict) => 'base' | 'ours' | 'theirs' |
+ * { value } | null`, answering conflicts while the merge runs; an answer of
+ * `null` leaves one unresolved. IT MUST BE SYNCHRONOUS. A resolver that asks a
+ * server, or asks the user, returns a Promise the merge cannot await - that is
+ * reported in `resolverErrors` and the conflict is left unresolved, the same
+ * treatment an `async` `renderers.math` gets.
+ * @param {string} base
+ * @param {string} ours
+ * @param {string} theirs
+ * @param {object | null} [options]
+ * @returns {string}
+ */
+export function mergeAst(base, ours, theirs, options) {
+    let deferred5_0;
+    let deferred5_1;
+    try {
+        const ptr0 = passStringToWasm0(base, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(ours, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len1 = WASM_VECTOR_LEN;
+        const ptr2 = passStringToWasm0(theirs, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len2 = WASM_VECTOR_LEN;
+        const ret = wasm.mergeAst(ptr0, len0, ptr1, len1, ptr2, len2, isLikeNone(options) ? 0 : addToExternrefTable0(options));
+        var ptr4 = ret[0];
+        var len4 = ret[1];
+        if (ret[3]) {
+            ptr4 = 0; len4 = 0;
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        deferred5_0 = ptr4;
+        deferred5_1 = len4;
+        return getStringFromWasm0(ptr4, len4);
+    } finally {
+        wasm.__wbindgen_free(deferred5_0, deferred5_1, 1);
+    }
+}
+
+/**
+ * Convert BBCode and retain a conservative v2 fidelity report.
+ * @param {string} source
+ * @returns {MigrationResult}
+ */
+export function migrateBbcode(source) {
+    const ptr0 = passStringToWasm0(source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.migrateBbcode(ptr0, len0);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return takeFromExternrefTable0(ret[0]);
+}
+
+/**
+ * Convert Djot and retain a conservative v2 fidelity report.
+ * @param {string} source
+ * @returns {MigrationResult}
+ */
+export function migrateDjot(source) {
+    const ptr0 = passStringToWasm0(source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.migrateDjot(ptr0, len0);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return takeFromExternrefTable0(ret[0]);
+}
+
 /**
  * Whether a document was last processed under an older spec version than
  * `currentVersion`. An unstamped document counts as needing review.
@@ -252,19 +860,302 @@ export function parseJson(source) {
         deferred2_1 = ret[1];
         return getStringFromWasm0(ret[0], ret[1]);
     } finally {
-        wasm.__wbindgen_free(deferred2_0, deferred2_1, 1);
+        wasm.__wbindgen_free(deferred2_0, deferred2_1, 1);
+    }
+}
+
+/**
+ * Serialize the tree with the same options object as
+ * [`to_html_with_options`], so a host can export the tree of an untrusted
+ * document under the `profile` it renders that document with.
+ *
+ * `positions` is not read: every serialized tree this binding produces carries
+ * them, as in [`parse_json`].
+ * @param {string} source
+ * @param {object | null} [options]
+ * @returns {string}
+ */
+export function parseJsonWithOptions(source, options) {
+    let deferred3_0;
+    let deferred3_1;
+    try {
+        const ptr0 = passStringToWasm0(source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.parseJsonWithOptions(ptr0, len0, isLikeNone(options) ? 0 : addToExternrefTable0(options));
+        var ptr2 = ret[0];
+        var len2 = ret[1];
+        if (ret[3]) {
+            ptr2 = 0; len2 = 0;
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        deferred3_0 = ptr2;
+        deferred3_1 = len2;
+        return getStringFromWasm0(ptr2, len2);
+    } finally {
+        wasm.__wbindgen_free(deferred3_0, deferred3_1, 1);
+    }
+}
+
+/**
+ * Parse the locator portion of a citation into `{ label, value, suffixText }`.
+ *
+ * A field the source did not carry is `null`. Same shape as carve-js
+ * `parseLocator`; pure, and never throws on bad input.
+ * @param {string} loc
+ * @returns {ParsedLocator}
+ */
+export function parseLocator(loc) {
+    const ptr0 = passStringToWasm0(loc, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.parseLocator(ptr0, len0);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return takeFromExternrefTable0(ret[0]);
+}
+
+/**
+ * Parse a document and keep what a later [`reparse`] needs.
+ *
+ * Returns one JSON object: `{ source, document, sourceLayout, changedSource,
+ * reusedPreviousTree }`. `document` is the PART 12 tree, `sourceLayout` the
+ * byte-exact record [`parse_source_layout_json`] produces, and
+ * `changedSource` the byte ranges this parse covered - the whole document, on
+ * a first parse.
+ *
+ * The snapshot crosses as JSON rather than as a handle a host has to `free()`.
+ * Every other entry point here is a pure function that owns nothing, and the
+ * engine's own snapshot holds only the source, so there is no tree being kept
+ * alive in wasm memory for a handle to point at.
+ * @param {string} source
+ * @returns {string}
+ */
+export function parseSnapshot(source) {
+    let deferred2_0;
+    let deferred2_1;
+    try {
+        const ptr0 = passStringToWasm0(source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.parseSnapshot(ptr0, len0);
+        deferred2_0 = ret[0];
+        deferred2_1 = ret[1];
+        return getStringFromWasm0(ret[0], ret[1]);
+    } finally {
+        wasm.__wbindgen_free(deferred2_0, deferred2_1, 1);
+    }
+}
+
+/**
+ * The PART 12 §13 source-layout sidecar for a document.
+ *
+ * Separate from `parseJson`, which carries semantic positions on the nodes.
+ * This is the byte-exact record of the SOURCE: its line endings, whether it
+ * had a BOM, and a path-addressed byte span per node - what a host needs to
+ * write an edit back into the file it came from.
+ * @param {string} source
+ * @returns {string}
+ */
+export function parseSourceLayoutJson(source) {
+    let deferred2_0;
+    let deferred2_1;
+    try {
+        const ptr0 = passStringToWasm0(source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.parseSourceLayoutJson(ptr0, len0);
+        deferred2_0 = ret[0];
+        deferred2_1 = ret[1];
+        return getStringFromWasm0(ret[0], ret[1]);
+    } finally {
+        wasm.__wbindgen_free(deferred2_0, deferred2_1, 1);
+    }
+}
+
+/**
+ * Read a document's provenance marker: `{ version, generatedBy }`, or `null`.
+ * @param {string} source
+ * @returns {Stamp | null}
+ */
+export function readStamp(source) {
+    const ptr0 = passStringToWasm0(source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.readStamp(ptr0, len0);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return takeFromExternrefTable0(ret[0]);
+}
+
+/**
+ * Re-parse `source` with `changes` applied.
+ *
+ * ```js
+ * const first = JSON.parse(parseSnapshot('# One\n'))
+ * const next = JSON.parse(reparse(first.source, '[{"range":[2,5],"replacement":"Two"}]'))
+ * ```
+ *
+ * `changes` is a JSON array of `{ range: [start, end], replacement }`.
+ *
+ * THE OFFSETS ARE UTF-8 BYTE OFFSETS, which is what `parseJson` positions and
+ * `createSourcePatch` ranges already mean. A browser editor counts UTF-16 code
+ * units, so a host holding a `selectionStart` converts before calling - an
+ * offset that lands inside a multi-byte character is refused rather than
+ * guessed at.
+ *
+ * A malformed change THROWS: overlapping ranges, an end past the source, and a
+ * range that splits a code point are all a broken caller contract, not a
+ * result the caller asked for.
+ *
+ * `reusedPreviousTree` says whether the parse reused any of the previous one.
+ * The pinned engine always reports `false` - it validates and applies the
+ * edits and then parses the whole source - so a host should read this as the
+ * engine's own answer rather than assume work was saved.
+ * @param {string} source
+ * @param {string} changes
+ * @returns {string}
+ */
+export function reparse(source, changes) {
+    let deferred4_0;
+    let deferred4_1;
+    try {
+        const ptr0 = passStringToWasm0(source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(changes, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len1 = WASM_VECTOR_LEN;
+        const ret = wasm.reparse(ptr0, len0, ptr1, len1);
+        var ptr3 = ret[0];
+        var len3 = ret[1];
+        if (ret[3]) {
+            ptr3 = 0; len3 = 0;
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        deferred4_0 = ptr3;
+        deferred4_1 = len3;
+        return getStringFromWasm0(ptr3, len3);
+    } finally {
+        wasm.__wbindgen_free(deferred4_0, deferred4_1, 1);
+    }
+}
+
+/**
+ * Sanitize an SVG document, the helper a host embedding SVG would otherwise
+ * reimplement.
+ *
+ * `{ svg, ok }`. `ok` false means the input was not a single well-formed
+ * `<svg>` root, and a caller must then show the SOURCE rather than the input:
+ * `svg` carries nothing to display. Every option defaults to `false`, which is
+ * the strict setting.
+ * @param {string} source
+ * @param {object | null} [options]
+ * @returns {SanitizeResult}
+ */
+export function sanitizeSvg(source, options) {
+    const ptr0 = passStringToWasm0(source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.sanitizeSvg(ptr0, len0, isLikeNone(options) ? 0 : addToExternrefTable0(options));
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return takeFromExternrefTable0(ret[0]);
+}
+
+/**
+ * Write a provenance marker onto already-formatted Carve.
+ *
+ * The other half of `readStamp` and `needsReview`, which could read a marker
+ * this package had no way to write. `generatedBy` is the engine identity a
+ * host wants recorded, e.g. `"my-app 1.2"`; `form` is `"line"` (default) or
+ * `"block"`. Same signature as carve-js `stampCarve`.
+ *
+ * The input is expected to be formatted already: this appends the marker and
+ * replaces one the document carries, it does not canonicalize. `toCarve` is
+ * the formatter.
+ * @param {string} formatted
+ * @param {string} generated_by
+ * @param {string | null} [form]
+ * @returns {string}
+ */
+export function stampCarve(formatted, generated_by, form) {
+    let deferred5_0;
+    let deferred5_1;
+    try {
+        const ptr0 = passStringToWasm0(formatted, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(generated_by, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len1 = WASM_VECTOR_LEN;
+        var ptr2 = isLikeNone(form) ? 0 : passStringToWasm0(form, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        var len2 = WASM_VECTOR_LEN;
+        const ret = wasm.stampCarve(ptr0, len0, ptr1, len1, ptr2, len2);
+        var ptr4 = ret[0];
+        var len4 = ret[1];
+        if (ret[3]) {
+            ptr4 = 0; len4 = 0;
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        deferred5_0 = ptr4;
+        deferred5_1 = len4;
+        return getStringFromWasm0(ptr4, len4);
+    } finally {
+        wasm.__wbindgen_free(deferred5_0, deferred5_1, 1);
+    }
+}
+
+/**
+ * @param {string} source
+ * @returns {string}
+ */
+export function toAnsi(source) {
+    let deferred2_0;
+    let deferred2_1;
+    try {
+        const ptr0 = passStringToWasm0(source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.toAnsi(ptr0, len0);
+        deferred2_0 = ret[0];
+        deferred2_1 = ret[1];
+        return getStringFromWasm0(ret[0], ret[1]);
+    } finally {
+        wasm.__wbindgen_free(deferred2_0, deferred2_1, 1);
+    }
+}
+
+/**
+ * Render to ANSI text with an options object. See
+ * [`to_markdown_with_options`].
+ * @param {string} source
+ * @param {object | null} [options]
+ * @returns {string}
+ */
+export function toAnsiWithOptions(source, options) {
+    let deferred3_0;
+    let deferred3_1;
+    try {
+        const ptr0 = passStringToWasm0(source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.toAnsiWithOptions(ptr0, len0, isLikeNone(options) ? 0 : addToExternrefTable0(options));
+        var ptr2 = ret[0];
+        var len2 = ret[1];
+        if (ret[3]) {
+            ptr2 = 0; len2 = 0;
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        deferred3_0 = ptr2;
+        deferred3_1 = len2;
+        return getStringFromWasm0(ptr2, len2);
+    } finally {
+        wasm.__wbindgen_free(deferred3_0, deferred3_1, 1);
     }
 }
 
 /**
- * Read a document's provenance marker: `{ version, generatedBy }`, or `null`.
  * @param {string} source
- * @returns {Stamp | null}
+ * @param {boolean | null} [strict]
+ * @param {number | null} [maximum]
+ * @returns {any}
  */
-export function readStamp(source) {
+export function toAnsiWithReport(source, strict, maximum) {
     const ptr0 = passStringToWasm0(source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
     const len0 = WASM_VECTOR_LEN;
-    const ret = wasm.readStamp(ptr0, len0);
+    const ret = wasm.toAnsiWithReport(ptr0, len0, isLikeNone(strict) ? 0xFFFFFF : strict ? 1 : 0, isLikeNone(maximum) ? 0x100000001 : (maximum) >>> 0);
     if (ret[2]) {
         throw takeFromExternrefTable0(ret[1]);
     }
@@ -275,13 +1166,13 @@ export function readStamp(source) {
  * @param {string} source
  * @returns {string}
  */
-export function toAnsi(source) {
+export function toCarve(source) {
     let deferred2_0;
     let deferred2_1;
     try {
         const ptr0 = passStringToWasm0(source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
         const len0 = WASM_VECTOR_LEN;
-        const ret = wasm.toAnsi(ptr0, len0);
+        const ret = wasm.toCarve(ptr0, len0);
         deferred2_0 = ret[0];
         deferred2_1 = ret[1];
         return getStringFromWasm0(ret[0], ret[1]);
@@ -291,15 +1182,14 @@ export function toAnsi(source) {
 }
 
 /**
+ * Preview canonical formatting as a source-preserving patch.
  * @param {string} source
- * @param {boolean | null} [strict]
- * @param {number | null} [maximum]
- * @returns {any}
+ * @returns {SourcePatch}
  */
-export function toAnsiWithReport(source, strict, maximum) {
+export function toCarvePatch(source) {
     const ptr0 = passStringToWasm0(source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
     const len0 = WASM_VECTOR_LEN;
-    const ret = wasm.toAnsiWithReport(ptr0, len0, isLikeNone(strict) ? 0xFFFFFF : strict ? 1 : 0, isLikeNone(maximum) ? 0x100000001 : (maximum) >>> 0);
+    const ret = wasm.toCarvePatch(ptr0, len0);
     if (ret[2]) {
         throw takeFromExternrefTable0(ret[1]);
     }
@@ -307,21 +1197,32 @@ export function toAnsiWithReport(source, strict, maximum) {
 }
 
 /**
+ * Write canonical Carve with an options object.
+ *
+ * `profile` is the only option this target reads; see
+ * [`to_markdown_with_options`] for why.
  * @param {string} source
+ * @param {object | null} [options]
  * @returns {string}
  */
-export function toCarve(source) {
-    let deferred2_0;
-    let deferred2_1;
+export function toCarveWithOptions(source, options) {
+    let deferred3_0;
+    let deferred3_1;
     try {
         const ptr0 = passStringToWasm0(source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
         const len0 = WASM_VECTOR_LEN;
-        const ret = wasm.toCarve(ptr0, len0);
-        deferred2_0 = ret[0];
-        deferred2_1 = ret[1];
-        return getStringFromWasm0(ret[0], ret[1]);
+        const ret = wasm.toCarveWithOptions(ptr0, len0, isLikeNone(options) ? 0 : addToExternrefTable0(options));
+        var ptr2 = ret[0];
+        var len2 = ret[1];
+        if (ret[3]) {
+            ptr2 = 0; len2 = 0;
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        deferred3_0 = ptr2;
+        deferred3_1 = len2;
+        return getStringFromWasm0(ptr2, len2);
     } finally {
-        wasm.__wbindgen_free(deferred2_0, deferred2_1, 1);
+        wasm.__wbindgen_free(deferred3_0, deferred3_1, 1);
     }
 }
 
@@ -456,11 +1357,22 @@ export function toHtmlFull(source, symbols) {
  * * `lowercaseHeadingIds` (default `false`) and `asciiHeadingIds`
  *   (`"off"` (default), `"fold"`, `"strict"`) - the slug policy, for a host
  *   whose anchors have to match another generator's.
+ * * `mentionUrl` and `tagUrl` - URL templates for `@mention` and `#tag`.
+ *   Without them both render as inert spans, which is why a host that wants
+ *   them linked has to say where to. The token name is percent-encoded into
+ *   `{name}` - `{user}` works too for a mention - and the result goes through
+ *   the same URL sanitizer as an authored link. These are the HOST's
+ *   configuration, not the document's: the template is trusted, the name
+ *   substituted into it is not.
  *
  * An unrecognized key is ignored: the object is configuration, and a caller
  * who mistypes one deserves the render to still work. A wrong TYPE on a key
  * that is recognized does throw, because that changes behavior silently.
  *
+ * `renderers` is the one recognized key this entry point refuses, because a
+ * render callback can fail and a bare string has nowhere to report that. Use
+ * [`to_html_with_renderers`].
+ *
  * Turning sections off changes nothing else. Ids, collision dedup, `</#id>`
  * crossrefs, implicit `[Heading][]` references and heading numbering all
  * resolve against the slug rather than the element carrying it, and the
@@ -491,6 +1403,77 @@ export function toHtmlWithOptions(source, options) {
     }
 }
 
+/**
+ * Render with a build-time math renderer, the option `mode: "static"` needs.
+ *
+ * Static output carries no client scripts, so a formula it contains has to be
+ * rendered while the HTML is being written. `renderers.math` is the callback
+ * the engine calls for each ``` ```math ``` fence, with the TeX source and a
+ * display flag; KaTeX's `renderToString` has that exact shape.
+ *
+ * ```js
+ * toHtmlWithRenderers(src, {
+ *   mode: 'static',
+ *   extensions: ['math-block'],
+ *   renderers: { math: (tex, display) => katex.renderToString(tex, { displayMode: display }) },
+ * })
+ * // { html: '…', rendererErrors: [] }
+ * ```
+ *
+ * SECURITY: what the callback returns is inserted as **TRUSTED RAW HTML**, the
+ * same trust class as a `symbols` value. The difference worth stating: a symbol
+ * value is host configuration keyed by a NAME, while a renderer is host
+ * configuration that is HANDED DOCUMENT CONTENT and typically echoes some of it
+ * back. A host rendering documents it did not author is accepting whatever its
+ * renderer makes of that input, so the escaping is the renderer's job.
+ *
+ * The engine consults the renderer only under `mode: "static"`; interactive
+ * output keeps the `\[…\]` source for the client to typeset, and so does a
+ * static render with no renderer supplied.
+ *
+ * The callback must be SYNCHRONOUS. wasm-bindgen cannot await across it, so an
+ * `async` renderer returns a Promise the engine has no way to resolve; that is
+ * recorded as a failure rather than stringified into the document.
+ *
+ * `renderers.diagrams` is the same callback one level down, keyed by the
+ * fence's css class: `{ mermaid: (source) => html }`. A host that renders its
+ * diagrams beforehand passes the lookup in that one line -
+ * `(source) => prerendered.get(source)`. Mermaid itself cannot be passed,
+ * because its `render` returns a Promise from v10 on.
+ *
+ * ```js
+ * toHtmlWithRenderers(src, {
+ *   mode: 'static',
+ *   extensions: ['fenced-render'],
+ *   renderers: { diagrams: { mermaid: (source) => prerendered.get(source) } },
+ * })
+ * ```
+ *
+ * A diagram key the document never uses renders nothing and reports nothing.
+ * So does a fence whose class the caller did not configure: the engine
+ * degrades it to an escaped source block, and this binding never sees the
+ * node.
+ *
+ * A callback that throws, or returns anything other than a string, does not
+ * abort the render: the node it was called for emits nothing and the failure
+ * is reported in `rendererErrors`, with `renderer` naming the css class.
+ * This entry point exists because [`to_html_with_options`] returns a bare
+ * string with nowhere to put that, and so it rejects `renderers` rather than
+ * dropping the failures.
+ * @param {string} source
+ * @param {object | null} [options]
+ * @returns {StaticRenderResult}
+ */
+export function toHtmlWithRenderers(source, options) {
+    const ptr0 = passStringToWasm0(source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.toHtmlWithRenderers(ptr0, len0, isLikeNone(options) ? 0 : addToExternrefTable0(options));
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return takeFromExternrefTable0(ret[0]);
+}
+
 /**
  * @param {string} source
  * @param {boolean | null} [strict]
@@ -566,6 +1549,52 @@ export function toMarkdown(source) {
     }
 }
 
+/**
+ * Render to Markdown with the same options object as
+ * [`to_html_with_options`].
+ *
+ * `profile` is why this exists. Without it a host can hold an untrusted
+ * document to a profile on the way to HTML and not on the way to Markdown,
+ * out of one package: the max-length bound, the denied constructs and the
+ * link policy were all unreachable here. A document the profile rejects
+ * throws a `ProfileViolationError` rather than resolving to an empty string.
+ *
+ * What these targets read is narrower than HTML's list: `profile` and
+ * `smartTypography` change the output and extensions run, while `symbols`
+ * (markup-carve/carve-rs#1668), `labels`, `sections`, `sourceLine`, `mode` and
+ * the heading-id switches are HTML-side concerns the engine's other renderers
+ * do not consult. `renderers` is refused for the reason
+ * [`to_html_with_options`] refuses it.
+ *
+ * [`to_carve_with_options`] is narrower again and reads `profile` alone: the
+ * engine's canonical writer is parse-only by contract, so extensions and
+ * `smartTypography` are inert there. They are accepted rather than refused
+ * because one options object is meant to serve every target.
+ * @param {string} source
+ * @param {object | null} [options]
+ * @returns {string}
+ */
+export function toMarkdownWithOptions(source, options) {
+    let deferred3_0;
+    let deferred3_1;
+    try {
+        const ptr0 = passStringToWasm0(source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.toMarkdownWithOptions(ptr0, len0, isLikeNone(options) ? 0 : addToExternrefTable0(options));
+        var ptr2 = ret[0];
+        var len2 = ret[1];
+        if (ret[3]) {
+            ptr2 = 0; len2 = 0;
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        deferred3_0 = ptr2;
+        deferred3_1 = len2;
+        return getStringFromWasm0(ptr2, len2);
+    } finally {
+        wasm.__wbindgen_free(deferred3_0, deferred3_1, 1);
+    }
+}
+
 /**
  * @param {string} source
  * @param {boolean | null} [strict]
@@ -601,6 +1630,34 @@ export function toPlainText(source) {
     }
 }
 
+/**
+ * Render to plain text with an options object. See
+ * [`to_markdown_with_options`].
+ * @param {string} source
+ * @param {object | null} [options]
+ * @returns {string}
+ */
+export function toPlainTextWithOptions(source, options) {
+    let deferred3_0;
+    let deferred3_1;
+    try {
+        const ptr0 = passStringToWasm0(source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.toPlainTextWithOptions(ptr0, len0, isLikeNone(options) ? 0 : addToExternrefTable0(options));
+        var ptr2 = ret[0];
+        var len2 = ret[1];
+        if (ret[3]) {
+            ptr2 = 0; len2 = 0;
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        deferred3_0 = ptr2;
+        deferred3_1 = len2;
+        return getStringFromWasm0(ptr2, len2);
+    } finally {
+        wasm.__wbindgen_free(deferred3_0, deferred3_1, 1);
+    }
+}
+
 /**
  * @param {string} source
  * @param {boolean | null} [strict]
@@ -617,6 +1674,33 @@ export function toPlainTextWithReport(source, strict, maximum) {
     return takeFromExternrefTable0(ret[0]);
 }
 
+/**
+ * Convert Carve source to the ProseMirror document shape.
+ *
+ * ProseMirror runs in a browser and nowhere else, so this is the one engine
+ * capability whose whole audience sits behind a WASM binding. Without it a host
+ * wiring a Carve editor either round-trips to a server or reimplements the node
+ * mapping in JS, where it drifts from the engine's.
+ *
+ * Returns `{ json, dropped, degraded }`. `json` is the ProseMirror document as
+ * a JSON string, the same choice `parseJson` makes and for the same reason.
+ * The two maps say what the ProseMirror model could not hold: `dropped` where
+ * the content is gone, `degraded` where the text survives without its node
+ * type. A silent conversion is the degradation shape `lintCarve` exists to
+ * avoid.
+ * @param {string} source
+ * @returns {ProseMirrorResult}
+ */
+export function toProseMirror(source) {
+    const ptr0 = passStringToWasm0(source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.toProseMirror(ptr0, len0);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return takeFromExternrefTable0(ret[0]);
+}
+
 /**
  * @returns {string}
  */
@@ -632,19 +1716,82 @@ export function version() {
         wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
     }
 }
+export function __wbg_Error_2e59b1b37a9a34c3(arg0, arg1) {
+    const ret = Error(getStringFromWasm0(arg0, arg1));
+    return ret;
+}
+export function __wbg_Number_e6ffdb596c888833(arg0) {
+    const ret = Number(arg0);
+    return ret;
+}
+export function __wbg_String_8564e559799eccda(arg0, arg1) {
+    const ret = String(arg1);
+    const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len1 = WASM_VECTOR_LEN;
+    getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
+    getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
+}
+export function __wbg___wbindgen_bigint_get_as_i64_2c5082002e4826e2(arg0, arg1) {
+    const v = arg1;
+    const ret = typeof(v) === 'bigint' ? v : undefined;
+    getDataViewMemory0().setBigInt64(arg0 + 8 * 1, isLikeNone(ret) ? BigInt(0) : ret, true);
+    getDataViewMemory0().setInt32(arg0 + 4 * 0, !isLikeNone(ret), true);
+}
 export function __wbg___wbindgen_boolean_get_a86c216575a75c30(arg0) {
     const v = arg0;
     const ret = typeof(v) === 'boolean' ? v : undefined;
     return isLikeNone(ret) ? 0xFFFFFF : ret ? 1 : 0;
 }
+export function __wbg___wbindgen_debug_string_dd5d2d07ce9e6c57(arg0, arg1) {
+    const ret = debugString(arg1);
+    const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len1 = WASM_VECTOR_LEN;
+    getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
+    getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
+}
+export function __wbg___wbindgen_in_4bd7a57e54337366(arg0, arg1) {
+    const ret = arg0 in arg1;
+    return ret;
+}
+export function __wbg___wbindgen_is_bigint_6c98f7e945dacdde(arg0) {
+    const ret = typeof(arg0) === 'bigint';
+    return ret;
+}
+export function __wbg___wbindgen_is_function_49868bde5eb1e745(arg0) {
+    const ret = typeof(arg0) === 'function';
+    return ret;
+}
 export function __wbg___wbindgen_is_null_344c8750a8525473(arg0) {
     const ret = arg0 === null;
     return ret;
 }
+export function __wbg___wbindgen_is_object_40c5a80572e8f9d3(arg0) {
+    const val = arg0;
+    const ret = typeof(val) === 'object' && val !== null;
+    return ret;
+}
+export function __wbg___wbindgen_is_string_b29b5c5a8065ba1a(arg0) {
+    const ret = typeof(arg0) === 'string';
+    return ret;
+}
 export function __wbg___wbindgen_is_undefined_c0cca72b82b86f4d(arg0) {
     const ret = arg0 === undefined;
     return ret;
 }
+export function __wbg___wbindgen_jsval_eq_7d430e744a913d26(arg0, arg1) {
+    const ret = arg0 === arg1;
+    return ret;
+}
+export function __wbg___wbindgen_jsval_loose_eq_3a72ae764d46d944(arg0, arg1) {
+    const ret = arg0 == arg1;
+    return ret;
+}
+export function __wbg___wbindgen_number_get_7579aab02a8a620c(arg0, arg1) {
+    const obj = arg1;
+    const ret = typeof(obj) === 'number' ? obj : undefined;
+    getDataViewMemory0().setFloat64(arg0 + 8 * 1, isLikeNone(ret) ? 0 : ret, true);
+    getDataViewMemory0().setInt32(arg0 + 4 * 0, !isLikeNone(ret), true);
+}
 export function __wbg___wbindgen_string_get_914df97fcfa788f2(arg0, arg1) {
     const obj = arg1;
     const ret = typeof(obj) === 'string' ? obj : undefined;
@@ -656,6 +1803,26 @@ export function __wbg___wbindgen_string_get_914df97fcfa788f2(arg0, arg1) {
 export function __wbg___wbindgen_throw_81fc77679af83bc6(arg0, arg1) {
     throw new Error(getStringFromWasm0(arg0, arg1));
 }
+export function __wbg___wbindgen_typeof_ec2e006152efc95c(arg0) {
+    const ret = typeof arg0;
+    return ret;
+}
+export function __wbg_call_368fa9c372d473ba() { return handleError(function (arg0, arg1, arg2, arg3) {
+    const ret = arg0.call(arg1, arg2, arg3);
+    return ret;
+}, arguments); }
+export function __wbg_call_7f2987183bb62793() { return handleError(function (arg0, arg1) {
+    const ret = arg0.call(arg1);
+    return ret;
+}, arguments); }
+export function __wbg_call_d578befcc3145dee() { return handleError(function (arg0, arg1, arg2) {
+    const ret = arg0.call(arg1, arg2);
+    return ret;
+}, arguments); }
+export function __wbg_done_547d467e97529006(arg0) {
+    const ret = arg0.done;
+    return ret;
+}
 export function __wbg_entries_616b1a459b85be0b(arg0) {
     const ret = Object.entries(arg0);
     return ret;
@@ -672,6 +1839,10 @@ export function __wbg_get_4848e350b40afc16(arg0, arg1) {
     const ret = arg0[arg1 >>> 0];
     return ret;
 }
+export function __wbg_get_ed0642c4b9d31ddf() { return handleError(function (arg0, arg1) {
+    const ret = Reflect.get(arg0, arg1);
+    return ret;
+}, arguments); }
 export function __wbg_get_f96702c6245e4ef9() { return handleError(function (arg0, arg1) {
     const ret = Reflect.get(arg0, arg1);
     return ret;
@@ -680,6 +1851,30 @@ export function __wbg_get_unchecked_7d7babe32e9e6a54(arg0, arg1) {
     const ret = arg0[arg1 >>> 0];
     return ret;
 }
+export function __wbg_get_with_ref_key_6412cf3094599694(arg0, arg1) {
+    const ret = arg0[arg1];
+    return ret;
+}
+export function __wbg_instanceof_ArrayBuffer_ff7c1337a5e3b33a(arg0) {
+    let result;
+    try {
+        result = arg0 instanceof ArrayBuffer;
+    } catch (_) {
+        result = false;
+    }
+    const ret = result;
+    return ret;
+}
+export function __wbg_instanceof_Error_e3390d6805733dad(arg0) {
+    let result;
+    try {
+        result = arg0 instanceof Error;
+    } catch (_) {
+        result = false;
+    }
+    const ret = result;
+    return ret;
+}
 export function __wbg_instanceof_Map_a10a2795ef4bfe97(arg0) {
     let result;
     try {
@@ -700,14 +1895,50 @@ export function __wbg_instanceof_Object_72ee0c53dd8f0726(arg0) {
     const ret = result;
     return ret;
 }
+export function __wbg_instanceof_Promise_95d523058012a13d(arg0) {
+    let result;
+    try {
+        result = arg0 instanceof Promise;
+    } catch (_) {
+        result = false;
+    }
+    const ret = result;
+    return ret;
+}
+export function __wbg_instanceof_Uint8Array_4b8da683deb25d72(arg0) {
+    let result;
+    try {
+        result = arg0 instanceof Uint8Array;
+    } catch (_) {
+        result = false;
+    }
+    const ret = result;
+    return ret;
+}
 export function __wbg_isArray_db61795ad004c139(arg0) {
     const ret = Array.isArray(arg0);
     return ret;
 }
+export function __wbg_isSafeInteger_ea83862ba994770c(arg0) {
+    const ret = Number.isSafeInteger(arg0);
+    return ret;
+}
+export function __wbg_iterator_de403ef31815a3e6() {
+    const ret = Symbol.iterator;
+    return ret;
+}
+export function __wbg_length_0c32cb8543c8e4c8(arg0) {
+    const ret = arg0.length;
+    return ret;
+}
 export function __wbg_length_6e821edde497a532(arg0) {
     const ret = arg0.length;
     return ret;
 }
+export function __wbg_message_7367f8c7d0fa1589(arg0) {
+    const ret = arg0.message;
+    return ret;
+}
 export function __wbg_new_47dfee3855dec446(arg0, arg1) {
     const ret = new TypeError(getStringFromWasm0(arg0, arg1));
     return ret;
@@ -716,6 +1947,10 @@ export function __wbg_new_4f9fafbb3909af72() {
     const ret = new Object();
     return ret;
 }
+export function __wbg_new_a560378ea1240b14(arg0) {
+    const ret = new Uint8Array(arg0);
+    return ret;
+}
 export function __wbg_new_e3b04b4d53d1b593(arg0, arg1) {
     const ret = new Error(getStringFromWasm0(arg0, arg1));
     return ret;
@@ -724,14 +1959,31 @@ export function __wbg_new_f3c9df4f38f3f798() {
     const ret = new Array();
     return ret;
 }
+export function __wbg_next_01132ed6134b8ef5(arg0) {
+    const ret = arg0.next;
+    return ret;
+}
+export function __wbg_next_b3713ec761a9dbfd() { return handleError(function (arg0) {
+    const ret = arg0.next();
+    return ret;
+}, arguments); }
 export function __wbg_parse_545d11396395fbbd() { return handleError(function (arg0, arg1) {
     const ret = JSON.parse(getStringFromWasm0(arg0, arg1));
     return ret;
 }, arguments); }
+export function __wbg_prototypesetcall_3e05eb9545565046(arg0, arg1, arg2) {
+    Uint8Array.prototype.set.call(getArrayU8FromWasm0(arg0, arg1), arg2);
+}
 export function __wbg_push_6bdbc990be5ac37b(arg0, arg1) {
     const ret = arg0.push(arg1);
     return ret;
 }
+export function __wbg_set_6be42768c690e380(arg0, arg1, arg2) {
+    arg0[arg1] = arg2;
+}
+export function __wbg_set_6c60b2e8ad0e9383(arg0, arg1, arg2) {
+    arg0[arg1 >>> 0] = arg2;
+}
 export function __wbg_set_8ee2d34facb8466e() { return handleError(function (arg0, arg1, arg2) {
     const ret = Reflect.set(arg0, arg1, arg2);
     return ret;
@@ -739,6 +1991,14 @@ export function __wbg_set_8ee2d34facb8466e() { return handleError(function (arg0
 export function __wbg_set_name_ab9c98596fd7310a(arg0, arg1, arg2) {
     arg0.name = getStringFromWasm0(arg1, arg2);
 }
+export function __wbg_stringify_a2c39d991e1bf91d() { return handleError(function (arg0) {
+    const ret = JSON.stringify(arg0);
+    return ret;
+}, arguments); }
+export function __wbg_value_7f6052747ccf940f(arg0) {
+    const ret = arg0.value;
+    return ret;
+}
 export function __wbindgen_cast_0000000000000001(arg0) {
     // Cast intrinsic for `F64 -> Externref`.
     const ret = arg0;
@@ -749,6 +2009,11 @@ export function __wbindgen_cast_0000000000000002(arg0, arg1) {
     const ret = getStringFromWasm0(arg0, arg1);
     return ret;
 }
+export function __wbindgen_cast_0000000000000003(arg0) {
+    // Cast intrinsic for `U64 -> Externref`.
+    const ret = BigInt.asUintN(64, arg0);
+    return ret;
+}
 export function __wbindgen_init_externref_table() {
     const table = wasm.__wbindgen_externrefs;
     const offset = table.grow(4);
@@ -764,6 +2029,71 @@ function addToExternrefTable0(obj) {
     return idx;
 }
 
+function debugString(val) {
+    // primitive types
+    const type = typeof val;
+    if (type == 'number' || type == 'boolean' || val == null) {
+        return  `${val}`;
+    }
+    if (type == 'string') {
+        return `"${val}"`;
+    }
+    if (type == 'symbol') {
+        const description = val.description;
+        if (description == null) {
+            return 'Symbol';
+        } else {
+            return `Symbol(${description})`;
+        }
+    }
+    if (type == 'function') {
+        const name = val.name;
+        if (typeof name == 'string' && name.length > 0) {
+            return `Function(${name})`;
+        } else {
+            return 'Function';
+        }
+    }
+    // objects
+    if (Array.isArray(val)) {
+        const length = val.length;
+        let debug = '[';
+        if (length > 0) {
+            debug += debugString(val[0]);
+        }
+        for(let i = 1; i < length; i++) {
+            debug += ', ' + debugString(val[i]);
+        }
+        debug += ']';
+        return debug;
+    }
+    // Test for built-in
+    const builtInMatches = /\[object ([^\]]+)\]/.exec(toString.call(val));
+    let className;
+    if (builtInMatches && builtInMatches.length > 1) {
+        className = builtInMatches[1];
+    } else {
+        // Failed to match the standard '[object ClassName]'
+        return toString.call(val);
+    }
+    if (className == 'Object') {
+        // we're a user defined class or Object
+        // JSON.stringify avoids problems with cycles, and is generally much
+        // easier than looping through ownProperties of `val`.
+        try {
+            return 'Object(' + JSON.stringify(val) + ')';
+        } catch (_) {
+            return 'Object';
+        }
+    }
+    // errors
+    if (val instanceof Error) {
+        return `${val.name}: ${val.message}\n${val.stack}`;
+    }
+    // TODO we could test for more things here, like `Set`s and `Map`s.
+    return className;
+}
+
 function getArrayJsValueFromWasm0(ptr, len) {
     ptr = ptr >>> 0;
     const mem = getDataViewMemory0();
@@ -775,6 +2105,11 @@ function getArrayJsValueFromWasm0(ptr, len) {
     return result;
 }
 
+function getArrayU8FromWasm0(ptr, len) {
+    ptr = ptr >>> 0;
+    return getUint8ArrayMemory0().subarray(ptr / 1, ptr / 1 + len);
+}
+
 let cachedDataViewMemory0 = null;
 function getDataViewMemory0() {
     if (cachedDataViewMemory0 === null || cachedDataViewMemory0.buffer.detached === true || (cachedDataViewMemory0.buffer.detached === undefined && cachedDataViewMemory0.buffer !== wasm.memory.buffer)) {