satteri 0.8.1 → 0.9.0

package/dist/mdast/mdast-reader.js

@@ -1,94 +1,9 @@
-// Node type discriminant values (must match NodeType enum in node.rs)
-export const NodeType = Object.freeze({
-    Root: 0,
-    Paragraph: 1,
-    Heading: 2,
-    ThematicBreak: 3,
-    Blockquote: 4,
-    List: 5,
-    ListItem: 6,
-    Html: 7,
-    Code: 8,
-    Definition: 9,
-    Text: 10,
-    Emphasis: 11,
-    Strong: 12,
-    InlineCode: 13,
-    Break: 14,
-    Link: 15,
-    Image: 16,
-    LinkReference: 17,
-    ImageReference: 18,
-    FootnoteDefinition: 19,
-    FootnoteReference: 20,
-    Table: 21,
-    TableRow: 22,
-    TableCell: 23,
-    Delete: 24,
-    Yaml: 25,
-    Toml: 26,
-    Math: 27,
-    InlineMath: 28,
-    // Directives
-    ContainerDirective: 30,
-    LeafDirective: 31,
-    TextDirective: 32,
-    // MDX
-    MdxJsxFlowElement: 100,
-    MdxJsxTextElement: 101,
-    MdxFlowExpression: 102,
-    MdxTextExpression: 103,
-    MdxjsEsm: 104,
-});
-// Reverse map: number → string name
-export const NodeTypeName = Object.fromEntries(Object.entries(NodeType).map(([k, v]) => [v, k]));
-// MdastNode field offsets within NODE_STRUCT_SIZE bytes.
-// Must match MdastNode #[repr(C)] layout in node.rs:
-//   id: u32          @ 0
-//   node_type: u8    @ 4
-//   _pad: [u8; 3]    @ 5
-//   parent: u32      @ 8
-//   start_offset: u32 @ 12
-//   end_offset: u32  @ 16
-//   start_line: u32  @ 20
-//   start_column: u32 @ 24
-//   end_line: u32    @ 28
-//   end_column: u32  @ 32
-//   children_start: u32 @ 36
-//   children_count: u32 @ 40
-//   data_offset: u32 @ 44
-//   data_len: u32    @ 48
-//   Total: 52 bytes
-const FIELD = {
-    id: 0,
-    node_type: 4, // u8
-    parent: 8,
-    start_offset: 12,
-    end_offset: 16,
-    start_line: 20,
-    start_column: 24,
-    end_line: 28,
-    end_column: 32,
-    children_start: 36,
-    children_count: 40,
-    data_offset: 44,
-    data_len: 48,
-};
-// BufferHeader field offsets (all u32, little-endian):
-//   magic: [u8; 4]        @ 0
-//   kind: u32              @ 4   (1 = mdast, 2 = hast)
-//   node_struct_size: u32  @ 8
-//   node_count: u32        @ 12
-//   nodes_offset: u32      @ 16
-//   children_count: u32    @ 20
-//   children_offset: u32   @ 24
-//   type_data_len: u32     @ 28
-//   type_data_offset: u32  @ 32
-//   source_len: u32        @ 36
-//   source_offset: u32     @ 40
-//   Total: 44 bytes
-const MAGIC = 0x5241444d; // "MDAR" bytes [0x4d,0x44,0x41,0x52] read as little-endian u32
-const KIND_MDAST = 1;
+import { restorePhantomSpaces } from "../phantom.js";
+import { readPosition } from "../wire-read.js";
+import { decodeColumnAlign } from "./column-align.js";
+import { NodeTypeName } from "./generated/node-types.js";
+import { ARENA_MAGIC, KIND_MDAST, FIELD, HEADER } from "../generated/arena-layout.js";
+export { NodeType, NodeTypeName } from "./generated/node-types.js";
 export class MdastReader {
     #view;
     #header;
@@ -106,27 +21,27 @@ export class MdastReader {
     }
     #readHeader() {
         const v = this.#view;
-        const magic = v.getUint32(0, true);
-        if (magic !== MAGIC) {
-            throw new Error(`Invalid buffer: bad magic 0x${magic.toString(16)}, expected 0x${MAGIC.toString(16)}`);
+        const magic = v.getUint32(HEADER.magic, true);
+        if (magic !== ARENA_MAGIC) {
+            throw new Error(`Invalid buffer: bad magic 0x${magic.toString(16)}, expected 0x${ARENA_MAGIC.toString(16)}`);
         }
-        const kind = v.getUint32(4, true);
+        const kind = v.getUint32(HEADER.kind, true);
         if (kind !== KIND_MDAST) {
             throw new Error(`MdastReader was handed a buffer of kind ${kind} (expected ${KIND_MDAST}). ` +
                 `MDAST and HAST node types overlap; reading the wrong kind decodes garbage.`);
         }
         return {
-            nodeStructSize: v.getUint32(8, true),
-            nodeCount: v.getUint32(12, true),
-            nodesOffset: v.getUint32(16, true),
-            childrenCount: v.getUint32(20, true),
-            childrenOffset: v.getUint32(24, true),
-            typeDataLen: v.getUint32(28, true),
-            typeDataOffset: v.getUint32(32, true),
-            sourceLen: v.getUint32(36, true),
-            sourceOffset: v.getUint32(40, true),
-            nodeDataCount: v.getUint32(44, true),
-            nodeDataOffset: v.getUint32(48, true),
+            nodeStructSize: v.getUint32(HEADER.node_struct_size, true),
+            nodeCount: v.getUint32(HEADER.node_count, true),
+            nodesOffset: v.getUint32(HEADER.nodes_offset, true),
+            childrenCount: v.getUint32(HEADER.children_count, true),
+            childrenOffset: v.getUint32(HEADER.children_offset, true),
+            typeDataLen: v.getUint32(HEADER.type_data_len, true),
+            typeDataOffset: v.getUint32(HEADER.type_data_offset, true),
+            sourceLen: v.getUint32(HEADER.source_len, true),
+            sourceOffset: v.getUint32(HEADER.source_offset, true),
+            nodeDataCount: v.getUint32(HEADER.node_data_count, true),
+            nodeDataOffset: v.getUint32(HEADER.node_data_offset, true),
         };
     }
     #nodeDataTable = null;
@@ -181,25 +96,7 @@ export class MdastReader {
         const base = nodesOffset + nodeId * nodeStructSize;
         const v = this.#view;
         const type = v.getUint8(base + FIELD.node_type);
-        const startLine = v.getUint32(base + FIELD.start_line, true);
-        const startOffset = v.getUint32(base + FIELD.start_offset, true);
-        // Sentinel: nodes with both line=0 and offset=0 are synthesized
-        // without source position (e.g. GFM autolink-literal nodes that
-        // remark-gfm produces via mdast-util-find-and-replace).
-        const position = startLine === 0 && startOffset === 0
-            ? undefined
-            : {
-                start: {
-                    offset: startOffset,
-                    line: startLine,
-                    column: v.getUint32(base + FIELD.start_column, true),
-                },
-                end: {
-                    offset: v.getUint32(base + FIELD.end_offset, true),
-                    line: v.getUint32(base + FIELD.end_line, true),
-                    column: v.getUint32(base + FIELD.end_column, true),
-                },
-            };
+        const position = readPosition(v, base + FIELD.start_offset);
         return {
             id: v.getUint32(base + FIELD.id, true),
             type,
@@ -217,15 +114,22 @@ export class MdastReader {
         const { nodesOffset, nodeStructSize } = this.#header;
         return this.#view.getUint8(nodesOffset + nodeId * nodeStructSize + FIELD.node_type);
     }
+    /** Fast path: read only the parent id for a node (0xffffffff at the root). */
+    getParentId(nodeId) {
+        const { nodesOffset, nodeStructSize } = this.#header;
+        return this.#view.getUint32(nodesOffset + nodeId * nodeStructSize + FIELD.parent, true);
+    }
     getChildIds(nodeId) {
-        const node = this.getNode(nodeId);
-        if (node.childrenCount === 0)
+        const { nodesOffset, nodeStructSize, childrenOffset } = this.#header;
+        const base = nodesOffset + nodeId * nodeStructSize;
+        const v = this.#view;
+        const childrenStart = v.getUint32(base + FIELD.children_start, true);
+        const childrenCount = v.getUint32(base + FIELD.children_count, true);
+        if (childrenCount === 0)
             return [];
-        const { childrenOffset } = this.#header;
         const ids = [];
-        for (let i = 0; i < node.childrenCount; i++) {
-            const off = childrenOffset + (node.childrenStart + i) * 4;
-            ids.push(this.#view.getUint32(off, true));
+        for (let i = 0; i < childrenCount; i++) {
+            ids.push(v.getUint32(childrenOffset + (childrenStart + i) * 4, true));
         }
         return ids;
     }
@@ -243,11 +147,13 @@ export class MdastReader {
         }
     }
     getTypeData(nodeId) {
-        const node = this.getNode(nodeId);
-        if (node.dataLen === 0)
+        const base = this.#header.nodesOffset + nodeId * this.#header.nodeStructSize;
+        const v = this.#view;
+        const dataOffset = v.getUint32(base + FIELD.data_offset, true);
+        const dataLen = v.getUint32(base + FIELD.data_len, true);
+        if (dataLen === 0)
             return new Uint8Array(0);
-        const { typeDataOffset } = this.#header;
-        return new Uint8Array(this.#view.buffer, this.#view.byteOffset + typeDataOffset + node.dataOffset, node.dataLen);
+        return new Uint8Array(v.buffer, v.byteOffset + this.#header.typeDataOffset + dataOffset, dataLen);
     }
     /** Read a StringRef (offset: u32 LE, len: u32 LE) from type data. */
     readStringRef(typeData, byteOffset = 0) {
@@ -257,12 +163,8 @@ export class MdastReader {
             len: view.getUint32(4, true),
         };
     }
-    /** HeadingData: depth u8 @ 0. */
-    getHeadingDepth(nodeId) {
-        return this.getTypeData(nodeId)[0];
-    }
     /**
-     * StringRef value. Valid for Text, InlineCode, Html, Yaml, Toml, InlineMath nodes.
+     * StringRef value. Valid for Text, InlineCode, Html, Yaml, Toml nodes.
      * These store a single StringRef as their type data.
      */
     getTextValue(nodeId) {
@@ -270,79 +172,6 @@ export class MdastReader {
         const ref = this.readStringRef(data);
         return this.getString(ref.offset, ref.len);
     }
-    /**
-     * LinkData: url(0..8), title(8..16).
-     * Valid for Link nodes.
-     */
-    getLinkData(nodeId) {
-        const data = this.getTypeData(nodeId);
-        const urlRef = this.readStringRef(data, 0);
-        const titleRef = this.readStringRef(data, 8);
-        return {
-            url: this.getString(urlRef.offset, urlRef.len),
-            title: titleRef.len > 0 ? this.getString(titleRef.offset, titleRef.len) : null,
-        };
-    }
-    /**
-     * ImageData: url(0..8), alt(8..16), title(16..24).
-     * Valid for Image nodes.
-     */
-    getImageData(nodeId) {
-        const data = this.getTypeData(nodeId);
-        const urlRef = this.readStringRef(data, 0);
-        const altRef = this.readStringRef(data, 8);
-        const titleRef = this.readStringRef(data, 16);
-        return {
-            url: this.getString(urlRef.offset, urlRef.len),
-            alt: this.getString(altRef.offset, altRef.len),
-            title: titleRef.len > 0 ? this.getString(titleRef.offset, titleRef.len) : null,
-        };
-    }
-    /**
-     * CodeData #[repr(C)]: lang(0..8), meta(8..16), value(16..24), fence_char(24), _pad(25..28).
-     * Valid for Code nodes.
-     */
-    getCodeData(nodeId) {
-        const data = this.getTypeData(nodeId);
-        const langRef = this.readStringRef(data, 0);
-        const metaRef = this.readStringRef(data, 8);
-        const valueRef = this.readStringRef(data, 16);
-        return {
-            lang: langRef.len > 0 ? this.getString(langRef.offset, langRef.len) : null,
-            meta: metaRef.len > 0 ? this.getString(metaRef.offset, metaRef.len) : null,
-            value: this.getString(valueRef.offset, valueRef.len),
-        };
-    }
-    /**
-     * MathData #[repr(C)]: meta(0..8), value(8..16).
-     * Valid for Math nodes.
-     */
-    getMathData(nodeId) {
-        const data = this.getTypeData(nodeId);
-        const metaRef = this.readStringRef(data, 0);
-        const valueRef = this.readStringRef(data, 8);
-        return {
-            meta: metaRef.len > 0 ? this.getString(metaRef.offset, metaRef.len) : null,
-            value: this.getString(valueRef.offset, valueRef.len),
-        };
-    }
-    /**
-     * DefinitionData #[repr(C)]: url(0..8), title(8..16), identifier(16..24), label(24..32).
-     * Valid for Definition nodes.
-     */
-    getDefinitionData(nodeId) {
-        const data = this.getTypeData(nodeId);
-        const urlRef = this.readStringRef(data, 0);
-        const titleRef = this.readStringRef(data, 8);
-        const identifierRef = this.readStringRef(data, 16);
-        const labelRef = this.readStringRef(data, 24);
-        return {
-            url: this.getString(urlRef.offset, urlRef.len),
-            title: titleRef.len > 0 ? this.getString(titleRef.offset, titleRef.len) : null,
-            identifier: this.getString(identifierRef.offset, identifierRef.len),
-            label: this.getString(labelRef.offset, labelRef.len),
-        };
-    }
     /**
      * ListData #[repr(C)]: start(0..4), ordered(4), spread(5), _pad(6..8).
      * Valid for List nodes.
@@ -368,52 +197,6 @@ export class MdastReader {
             spread: data[1] !== 0,
         };
     }
-    /**
-     * ReferenceData #[repr(C)]: identifier(0..8), label(8..16), reference_kind(16), _pad(17..20).
-     * referenceKind: 0=shortcut, 1=collapsed, 2=full.
-     * Valid for LinkReference, ImageReference, FootnoteReference nodes.
-     */
-    getReferenceData(nodeId) {
-        const data = this.getTypeData(nodeId);
-        const identifierRef = this.readStringRef(data, 0);
-        const labelRef = this.readStringRef(data, 8);
-        const kindByte = data[16];
-        const referenceTypes = ["shortcut", "collapsed", "full"];
-        return {
-            identifier: this.getString(identifierRef.offset, identifierRef.len),
-            label: this.getString(labelRef.offset, labelRef.len),
-            referenceType: referenceTypes[kindByte] ?? "shortcut",
-        };
-    }
-    /**
-     * ImageReference layout: 20-byte ReferenceData header + 8-byte alt StringRef.
-     * Parser-emitted image references carry alt inline; plugin-created ones
-     * may lack this suffix, in which case `alt` is empty.
-     */
-    getImageReferenceData(nodeId) {
-        const base = this.getReferenceData(nodeId);
-        const data = this.getTypeData(nodeId);
-        if (data.length >= 28) {
-            const altRef = this.readStringRef(data, 20);
-            return {
-                ...base,
-                alt: this.getString(altRef.offset, altRef.len),
-            };
-        }
-        return { ...base, alt: "" };
-    }
-    /**
-     * FootnoteDefinitionData #[repr(C)]: identifier(0..8), label(8..16).
-     */
-    getFootnoteDefinitionData(nodeId) {
-        const data = this.getTypeData(nodeId);
-        const identifierRef = this.readStringRef(data, 0);
-        const labelRef = this.readStringRef(data, 8);
-        return {
-            identifier: this.getString(identifierRef.offset, identifierRef.len),
-            label: this.getString(labelRef.offset, labelRef.len),
-        };
-    }
     /**
      * TableData #[repr(C)]: align_count(0..4), then align_count bytes.
      * Alignment bytes: 0=none, 1=left, 2=right, 3=center.
@@ -424,10 +207,9 @@ export class MdastReader {
             return [];
         const view = new DataView(data.buffer, data.byteOffset);
         const count = view.getUint32(0, true);
-        const alignNames = [null, "left", "right", "center"];
         const result = [];
         for (let i = 0; i < count; i++) {
-            result.push(alignNames[data[4 + i]] ?? null);
+            result.push(decodeColumnAlign(data[4 + i]));
         }
         return result;
     }
@@ -485,14 +267,14 @@ export class MdastReader {
                         name: this.getString(attrNameRef.offset, attrNameRef.len),
                         value: {
                             type: "mdxJsxAttributeValueExpression",
-                            value: this.getString(attrValueRef.offset, attrValueRef.len).replaceAll("", " "),
+                            value: restorePhantomSpaces(this.getString(attrValueRef.offset, attrValueRef.len)),
                         },
                     });
                     break;
                 case 3: // Spread
                     attributes.push({
                         type: "mdxJsxExpressionAttribute",
-                        value: this.getString(attrValueRef.offset, attrValueRef.len).replaceAll("", " "),
+                        value: restorePhantomSpaces(this.getString(attrValueRef.offset, attrValueRef.len)),
                     });
                     break;
             }
@@ -525,15 +307,6 @@ export class MdastReader {
         }
         return { name, attributes };
     }
-    /**
-     * ExpressionData #[repr(C)]: value StringRef (0..8).
-     * Valid for MdxFlowExpression, MdxTextExpression, MdxjsEsm.
-     */
-    getExpressionValue(nodeId) {
-        const data = this.getTypeData(nodeId);
-        const valueRef = this.readStringRef(data, 0);
-        return this.getString(valueRef.offset, valueRef.len).replaceAll("", " ");
-    }
     /**
      * Walk the tree depth-first. Return false from visitor to skip children.
      */

package/dist/mdast/mdast-visitor.d.ts

@@ -1,10 +1,21 @@
+import { MdastReader } from "./mdast-reader.js";
 import { CommandBuffer } from "../command-buffer.js";
-import type { MdastNode, Toml, MathNode, InlineMath } from "../types.js";
-import type { Blockquote, Break, Code, Definition, Delete, Emphasis, FootnoteDefinition, FootnoteReference, Heading, Html, Image, ImageReference, InlineCode, Link, LinkReference, List, ListItem, Paragraph, Strong, Table, TableRow, TableCell, Text, ThematicBreak, Yaml } from "mdast";
+import type { MdastNode, Toml, MathNode, InlineMath, Superscript, Subscript, Data } from "../types.js";
+import { LazyChildResolver } from "../lazy-child-resolver.js";
+import type { MdastHandle } from "../handles.js";
+import type { Blockquote, Break, Code, Definition, Delete, Emphasis, FootnoteDefinition, FootnoteReference, Heading, Html, Image, ImageReference, InlineCode, Link, LinkReference, List, ListItem, Paragraph, Strong, Table, TableRow, TableCell, Text, ThematicBreak, Yaml, Parents as MdastParents, Root as MdastRoot } from "mdast";
 import type { MdxJsxFlowElement, MdxJsxTextElement } from "../mdx-types.js";
 import type { MdxFlowExpression, MdxTextExpression } from "../mdx-types.js";
 import type { MdxjsEsm } from "../mdx-types.js";
 import type { ContainerDirective, LeafDirective, TextDirective } from "../directive-types.js";
+/** New content for a structural mutation: a declarative node, or a raw markdown
+ *  / HTML escape hatch. Declarative nodes compile to the op-stream; a type the
+ *  op-stream can't encode is a hard error. */
+export type MdastContent = MdastNode | {
+    raw: string;
+} | {
+    rawHtml: string;
+};
 export interface MdastDiagnostic {
     message: string;
     nodeId?: number | undefined;
@@ -19,29 +30,56 @@ export declare class MdastVisitorContext {
      * decoded filesystem path.
      */
     readonly fileURL: URL | undefined;
-    constructor(handle: MdastHandle, getSource: () => string, fileURL: URL | undefined);
+    /**
+     * Document-level data bag, shared across every plugin in the compile and
+     * across the mdast→hast phase boundary. Mutate keys directly
+     * (`ctx.data.foo = x`); the bag itself isn't reassignable. Values are kept
+     * on the JS side, so any value is allowed, including functions and class
+     * instances. Returned to the caller as `result.data`.
+     */
+    readonly data: Data;
+    constructor(handle: MdastHandle, getSource: () => string, fileURL: URL | undefined, resolver: LazyChildResolver<MdastReader, MdastNode>, data: Data);
     get source(): string;
     removeNode(node: Readonly<MdastNode>): void;
-    insertBefore(node: Readonly<MdastNode>, newNode: MdastNode | MdastNode[]): void;
-    insertAfter(node: Readonly<MdastNode>, newNode: MdastNode | MdastNode[]): void;
+    insertBefore(node: Readonly<MdastNode>, newNode: MdastContent | MdastContent[]): void;
+    insertAfter(node: Readonly<MdastNode>, newNode: MdastContent | MdastContent[]): void;
     /**
      * Wrap `node` in `parentNode`, making it `parentNode`'s first child. Any
      * children `parentNode` declares are kept after it.
      */
-    wrapNode(node: Readonly<MdastNode>, parentNode: MdastNode): void;
-    prependChild(node: Readonly<MdastNode>, childNode: MdastNode | MdastNode[]): void;
-    appendChild(node: Readonly<MdastNode>, childNode: MdastNode | MdastNode[]): void;
+    wrapNode(node: Readonly<MdastNode>, parentNode: MdastContent): void;
+    prependChild(node: Readonly<MdastNode>, childNode: MdastContent | MdastContent[]): void;
+    appendChild(node: Readonly<MdastNode>, childNode: MdastContent | MdastContent[]): void;
     /** Insert one node or an array at `index`; clamps (`0` or less prepends, past the end appends). */
-    insertChildAt(node: Readonly<MdastNode>, index: number, childNode: MdastNode | MdastNode[]): void;
+    insertChildAt(node: Readonly<MdastNode>, index: number, childNode: MdastContent | MdastContent[]): void;
     /** Remove the `index`-th child of `node`; a no-op when there is no such child. */
     removeChildAt(node: Readonly<MdastNode>, index: number): void;
-    replaceNode(node: Readonly<MdastNode>, newNode: MdastNode): void;
+    replaceNode(node: Readonly<MdastNode>, newNode: MdastContent): void;
     setProperty<N extends MdastNode, K extends keyof N & string>(node: Readonly<N>, key: K, value: N[K]): void;
+    /** `children` is structural and every parent accepts it, so the key also
+     *  works on node-type unions (e.g. a node returned by `parent()`). */
+    setProperty(node: Readonly<MdastNode>, key: "children", value: readonly MdastNode[]): void;
+    /** `data` is an open per-node bag serialized to JSON on the wire, so it
+     *  accepts any record (hName/hProperties/custom fields), not just the node's
+     *  declared `data` shape. `null` clears it. */
+    setProperty(node: Readonly<MdastNode>, key: "data", value: Record<string, unknown> | null): void;
     /** Collect the concatenated text of all descendant text nodes (like mdast-util-to-string). */
     textContent(node: Readonly<MdastNode>, options?: {
         includeImageAlt?: boolean;
         includeHtml?: boolean;
     }): string;
+    /**
+     * The parent of a node, or `undefined` at the root. Within a pass the same
+     * parent is always the same object, so visitors on sibling nodes can dedupe
+     * by identity.
+     */
+    parent<N extends Exclude<MdastNode, MdastRoot>>(node: Readonly<N>): Readonly<MdastParents>;
+    parent(node: Readonly<MdastNode>): Readonly<MdastParents> | undefined;
+    /**
+     * Index of `node` within its parent's children, or `undefined` at the root.
+     * Use this rather than `parent.children.indexOf(node)`, which won't find it.
+     */
+    indexOf(node: Readonly<MdastNode>): number | undefined;
     report({ message, node, severity, }: {
         message: string;
         node?: Readonly<MdastNode>;
@@ -89,6 +127,8 @@ export interface MdastPluginInstance {
     containerDirective?: MdastVisitorFn<ContainerDirective>;
     leafDirective?: MdastVisitorFn<LeafDirective>;
     textDirective?: MdastVisitorFn<TextDirective>;
+    superscript?: MdastVisitorFn<Superscript>;
+    subscript?: MdastVisitorFn<Subscript>;
     mdxJsxFlowElement?: MdastVisitorFn<MdxJsxFlowElement>;
     mdxJsxTextElement?: MdastVisitorFn<MdxJsxTextElement>;
     mdxFlowExpression?: MdastVisitorFn<MdxFlowExpression>;
@@ -101,12 +141,11 @@ interface MdastVisitResult {
     diagnostics: MdastDiagnostic[];
     hasMutations: boolean;
 }
-export type MdastHandle = any;
+export type { MdastHandle };
 interface MdastSubscription {
     nodeType: number;
     visitFn: (node: MdastNode, context: MdastVisitorContext) => unknown;
 }
-/** Resolve subscriptions from a plugin instance. */
 export declare function resolveMdastSubscriptions(plugin: MdastPluginInstance): MdastSubscription[];
 /**
  * Walk an MDAST handle in Rust, dispatch matched nodes to JS visitor functions,
@@ -115,5 +154,4 @@ export declare function resolveMdastSubscriptions(plugin: MdastPluginInstance):
  * Returns MdastVisitResult synchronously if all visitors are sync,
  * or Promise<MdastVisitResult> if any visitor is async.
  */
-export declare function visitMdastHandle(handle: MdastHandle, plugin: MdastPluginInstance, subs: MdastSubscription[], source: string | (() => string), fileURL: URL | undefined): MdastVisitResult | Promise<MdastVisitResult>;
-export {};
+export declare function visitMdastHandle(handle: MdastHandle, plugin: MdastPluginInstance, subs: MdastSubscription[], source: string | (() => string), fileURL: URL | undefined, data?: Data): MdastVisitResult | Promise<MdastVisitResult>;