satteri 0.1.0

package/dist/hast/hast-materializer.js

@@ -0,0 +1,150 @@
+import { HastReader, HAST_ROOT, HAST_ELEMENT, HAST_TEXT, HAST_COMMENT, HAST_DOCTYPE, HAST_RAW, HAST_MDX_JSX_ELEMENT, HAST_MDX_JSX_TEXT_ELEMENT, HAST_MDX_FLOW_EXPRESSION, HAST_MDX_TEXT_EXPRESSION, HAST_MDX_ESM, } from "./hast-reader.js";
+import { lazyProp, lazyGroup } from "../lazy-props.js";
+function propsToRecord(props) {
+    const result = {};
+    for (const p of props) {
+        result[p.name] = p.value;
+    }
+    return result;
+}
+/**
+ * Materialize a single HAST node from a binary buffer as a lazy JS object.
+ */
+export function materializeHastNode(reader, nodeId) {
+    const nodeType = reader.getNodeType(nodeId);
+    let typeName;
+    switch (nodeType) {
+        case HAST_ROOT:
+            typeName = "root";
+            break;
+        case HAST_ELEMENT:
+            typeName = "element";
+            break;
+        case HAST_TEXT:
+            typeName = "text";
+            break;
+        case HAST_COMMENT:
+            typeName = "comment";
+            break;
+        case HAST_DOCTYPE:
+            typeName = "doctype";
+            break;
+        case HAST_RAW:
+            typeName = "raw";
+            break;
+        case HAST_MDX_JSX_ELEMENT:
+            typeName = "mdxJsxFlowElement";
+            break;
+        case HAST_MDX_JSX_TEXT_ELEMENT:
+            typeName = "mdxJsxTextElement";
+            break;
+        case HAST_MDX_FLOW_EXPRESSION:
+            typeName = "mdxFlowExpression";
+            break;
+        case HAST_MDX_TEXT_EXPRESSION:
+            typeName = "mdxTextExpression";
+            break;
+        case HAST_MDX_ESM:
+            typeName = "mdxjsEsm";
+            break;
+        default:
+            typeName = `unknown(${nodeType})`;
+            break;
+    }
+    const node = { type: typeName };
+    // _nodeId: non-enumerable internal reference
+    Object.defineProperty(node, "_nodeId", {
+        value: nodeId,
+        writable: false,
+        configurable: true,
+        enumerable: false,
+    });
+    switch (nodeType) {
+        case HAST_ROOT:
+            // children: lazy getter
+            Object.defineProperty(node, "children", {
+                get() {
+                    const childIds = reader.getChildIds(nodeId);
+                    const children = childIds.map((id) => materializeHastNode(reader, id));
+                    Object.defineProperty(this, "children", {
+                        value: children,
+                        writable: true,
+                        configurable: true,
+                        enumerable: true,
+                    });
+                    return children;
+                },
+                configurable: true,
+                enumerable: true,
+            });
+            break;
+        case HAST_ELEMENT: {
+            // tagName and properties: lazy, resolved together from one reader call
+            lazyGroup(node, ["tagName", "properties"], () => {
+                const { tagName, properties } = reader.getElementData(nodeId);
+                return { tagName, properties: propsToRecord(properties) };
+            });
+            // children: lazy
+            Object.defineProperty(node, "children", {
+                get() {
+                    const childIds = reader.getChildIds(nodeId);
+                    const children = childIds.map((id) => materializeHastNode(reader, id));
+                    Object.defineProperty(this, "children", {
+                        value: children,
+                        writable: true,
+                        configurable: true,
+                        enumerable: true,
+                    });
+                    return children;
+                },
+                configurable: true,
+                enumerable: true,
+            });
+            break;
+        }
+        case HAST_TEXT:
+        case HAST_COMMENT:
+        case HAST_RAW:
+            Object.defineProperties(node, {
+                value: lazyProp("value", () => reader.getTextValue(nodeId)),
+            });
+            break;
+        case HAST_DOCTYPE:
+            // No extra properties
+            break;
+        case HAST_MDX_JSX_ELEMENT:
+        case HAST_MDX_JSX_TEXT_ELEMENT:
+            lazyGroup(node, ["name", "attributes"], () => reader.getMdxJsxElementData(nodeId));
+            Object.defineProperty(node, "children", {
+                get() {
+                    const childIds = reader.getChildIds(nodeId);
+                    const children = childIds.map((id) => materializeHastNode(reader, id));
+                    Object.defineProperty(this, "children", {
+                        value: children,
+                        writable: true,
+                        configurable: true,
+                        enumerable: true,
+                    });
+                    return children;
+                },
+                configurable: true,
+                enumerable: true,
+            });
+            break;
+        case HAST_MDX_FLOW_EXPRESSION:
+        case HAST_MDX_TEXT_EXPRESSION:
+        case HAST_MDX_ESM:
+            Object.defineProperties(node, {
+                value: lazyProp("value", () => reader.getTextValue(nodeId)),
+            });
+            break;
+    }
+    return node;
+}
+/**
+ * Materialize the full HAST tree from root (nodeId=0).
+ */
+export function materializeHastTree(reader) {
+    return materializeHastNode(reader, 0);
+}
+//# sourceMappingURL=hast-materializer.js.map

package/dist/hast/hast-materializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hast-materializer.js","sourceRoot":"","sources":["../../src/hast/hast-materializer.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,SAAS,EACT,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,oBAAoB,EACpB,yBAAyB,EACzB,wBAAwB,EACxB,wBAAwB,EACxB,YAAY,GAEb,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAIvD,SAAS,aAAa,CAAC,KAAqB;IAC1C,MAAM,MAAM,GAAgD,EAAE,CAAC;IAC/D,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC;IAC3B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAkB,EAAE,MAAc;IACpE,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAE5C,IAAI,QAAgB,CAAC;IACrB,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,SAAS;YACZ,QAAQ,GAAG,MAAM,CAAC;YAClB,MAAM;QACR,KAAK,YAAY;YACf,QAAQ,GAAG,SAAS,CAAC;YACrB,MAAM;QACR,KAAK,SAAS;YACZ,QAAQ,GAAG,MAAM,CAAC;YAClB,MAAM;QACR,KAAK,YAAY;YACf,QAAQ,GAAG,SAAS,CAAC;YACrB,MAAM;QACR,KAAK,YAAY;YACf,QAAQ,GAAG,SAAS,CAAC;YACrB,MAAM;QACR,KAAK,QAAQ;YACX,QAAQ,GAAG,KAAK,CAAC;YACjB,MAAM;QACR,KAAK,oBAAoB;YACvB,QAAQ,GAAG,mBAAmB,CAAC;YAC/B,MAAM;QACR,KAAK,yBAAyB;YAC5B,QAAQ,GAAG,mBAAmB,CAAC;YAC/B,MAAM;QACR,KAAK,wBAAwB;YAC3B,QAAQ,GAAG,mBAAmB,CAAC;YAC/B,MAAM;QACR,KAAK,wBAAwB;YAC3B,QAAQ,GAAG,mBAAmB,CAAC;YAC/B,MAAM;QACR,KAAK,YAAY;YACf,QAAQ,GAAG,UAAU,CAAC;YACtB,MAAM;QACR;YACE,QAAQ,GAAG,WAAW,QAAQ,GAAG,CAAC;YAClC,MAAM;IACV,CAAC;IAED,MAAM,IAAI,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAc,CAAC;IAE5C,6CAA6C;IAC7C,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE;QACrC,KAAK,EAAE,MAAM;QACb,QAAQ,EAAE,KAAK;QACf,YAAY,EAAE,IAAI;QAClB,UAAU,EAAE,KAAK;KAClB,CAAC,CAAC;IAEH,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,SAAS;YACZ,wBAAwB;YACxB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE;gBACtC,GAAG;oBACD,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;oBAC5C,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,mBAAmB,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC;oBACvE,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE;wBACtC,KAAK,EAAE,QAAQ;wBACf,QAAQ,EAAE,IAAI;wBACd,YAAY,EAAE,IAAI;wBAClB,UAAU,EAAE,IAAI;qBACjB,CAAC,CAAC;oBACH,OAAO,QAAQ,CAAC;gBAClB,CAAC;gBACD,YAAY,EAAE,IAAI;gBAClB,UAAU,EAAE,IAAI;aACjB,CAAC,CAAC;YACH,MAAM;QAER,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,uEAAuE;YACvE,SAAS,CAAC,IAAI,EAAE,CAAC,SAAS,EAAE,YAAY,CAAC,EAAE,GAAG,EAAE;gBAC9C,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;gBAC9D,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,aAAa,CAAC,UAAU,CAAC,EAAE,CAAC;YAC5D,CAAC,CAAC,CAAC;YACH,iBAAiB;YACjB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE;gBACtC,GAAG;oBACD,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;oBAC5C,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,mBAAmB,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC;oBACvE,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE;wBACtC,KAAK,EAAE,QAAQ;wBACf,QAAQ,EAAE,IAAI;wBACd,YAAY,EAAE,IAAI;wBAClB,UAAU,EAAE,IAAI;qBACjB,CAAC,CAAC;oBACH,OAAO,QAAQ,CAAC;gBAClB,CAAC;gBACD,YAAY,EAAE,IAAI;gBAClB,UAAU,EAAE,IAAI;aACjB,CAAC,CAAC;YACH,MAAM;QACR,CAAC;QAED,KAAK,SAAS,CAAC;QACf,KAAK,YAAY,CAAC;QAClB,KAAK,QAAQ;YACX,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE;gBAC5B,KAAK,EAAE,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;aAC5D,CAAC,CAAC;YACH,MAAM;QAER,KAAK,YAAY;YACf,sBAAsB;YACtB,MAAM;QAER,KAAK,oBAAoB,CAAC;QAC1B,KAAK,yBAAyB;YAC5B,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC;YACnF,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE;gBACtC,GAAG;oBACD,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;oBAC5C,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,mBAAmB,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC;oBACvE,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE;wBACtC,KAAK,EAAE,QAAQ;wBACf,QAAQ,EAAE,IAAI;wBACd,YAAY,EAAE,IAAI;wBAClB,UAAU,EAAE,IAAI;qBACjB,CAAC,CAAC;oBACH,OAAO,QAAQ,CAAC;gBAClB,CAAC;gBACD,YAAY,EAAE,IAAI;gBAClB,UAAU,EAAE,IAAI;aACjB,CAAC,CAAC;YACH,MAAM;QAER,KAAK,wBAAwB,CAAC;QAC9B,KAAK,wBAAwB,CAAC;QAC9B,KAAK,YAAY;YACf,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE;gBAC5B,KAAK,EAAE,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;aAC5D,CAAC,CAAC;YACH,MAAM;IACV,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAkB;IACpD,OAAO,mBAAmB,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;AACxC,CAAC"}

package/dist/hast/hast-reader.d.ts

@@ -0,0 +1,65 @@
+import type { BufferHeader } from "../types.js";
+import type { MdxJsxAttribute, MdxJsxExpressionAttribute } from "mdast-util-mdx-jsx";
+export type { MdxJsxAttribute, MdxJsxExpressionAttribute };
+export declare const HAST_ROOT = 0;
+export declare const HAST_ELEMENT = 1;
+export declare const HAST_TEXT = 2;
+export declare const HAST_COMMENT = 3;
+export declare const HAST_DOCTYPE = 4;
+export declare const HAST_RAW = 5;
+export declare const HAST_MDX_JSX_ELEMENT = 10;
+export declare const HAST_MDX_JSX_TEXT_ELEMENT = 11;
+export declare const HAST_MDX_FLOW_EXPRESSION = 12;
+export declare const HAST_MDX_ESM = 13;
+export declare const HAST_MDX_TEXT_EXPRESSION = 14;
+export interface HastProperty {
+    name: string;
+    value: string | boolean | string[];
+}
+export declare class HastReader {
+    #private;
+    constructor(buffer: ArrayBuffer | Uint8Array);
+    get nodeCount(): number;
+    get header(): BufferHeader;
+    /** Get the full source string (string pool). */
+    getSource(): string;
+    /** Read a substring from the string pool by byte offset and length. */
+    getString(offset: number, len: number): string;
+    /** Get the node_type byte for a given node ID. */
+    getNodeType(nodeId: number): number;
+    /** Get child node IDs for a given node. */
+    getChildIds(nodeId: number): number[];
+    /** Push child node IDs directly onto a stack array (reverse order for depth-first). */
+    pushChildIds(nodeId: number, stack: number[]): void;
+    /** Get the raw type_data bytes for a node. */
+    getTypeData(nodeId: number): Uint8Array;
+    /**
+     * Get element data for a HAST_ELEMENT node.
+     *
+     * Element type_data layout:
+     *   [tag_name: StringRef(8B)][prop_count: u32(4B)][_pad: u32(4B)] = 16-byte header
+     *   then prop_count * 20 bytes:
+     *     [name: StringRef(8B)][value_type: u8(1B)][_pad: [u8;3](3B)][value: StringRef(8B)]
+     */
+    getElementData(nodeId: number): {
+        tagName: string;
+        properties: HastProperty[];
+    };
+    /**
+     * Get MDX JSX element data: name and attributes.
+     *
+     * MDX JSX element type_data layout:
+     *   [name: StringRef(8B)][attr_count: u32(4B)][_pad: u32(4B)] = 16-byte header
+     *   then attr_count * 20 bytes:
+     *     [kind: u8(1B)][_pad: [u8;3](3B)][name: StringRef(8B)][value: StringRef(8B)]
+     */
+    getMdxJsxElementData(nodeId: number): {
+        name: string | null;
+        attributes: (MdxJsxAttribute | MdxJsxExpressionAttribute)[];
+    };
+    /**
+     * Get the string value for HAST_TEXT, HAST_COMMENT, or HAST_RAW nodes.
+     * These store a single StringRef (8 bytes) as their type_data.
+     */
+    getTextValue(nodeId: number): string;
+}

package/dist/hast/hast-reader.js

@@ -0,0 +1,280 @@
+// HAST node type constants (must match node_types.rs)
+export const HAST_ROOT = 0;
+export const HAST_ELEMENT = 1;
+export const HAST_TEXT = 2;
+export const HAST_COMMENT = 3;
+export const HAST_DOCTYPE = 4;
+export const HAST_RAW = 5;
+// MDX-specific HAST node types
+export const HAST_MDX_JSX_ELEMENT = 10;
+export const HAST_MDX_JSX_TEXT_ELEMENT = 11;
+export const HAST_MDX_FLOW_EXPRESSION = 12;
+export const HAST_MDX_ESM = 13;
+export const HAST_MDX_TEXT_EXPRESSION = 14;
+const PROP_STRING = 0;
+const PROP_BOOL_TRUE = 1;
+const PROP_BOOL_FALSE = 2;
+const PROP_SPACE_SEP = 3;
+const PROP_COMMA_SEP = 4;
+// MDX JSX attribute kinds (must match node_types.rs)
+const MDX_ATTR_BOOLEAN_PROP = 0;
+const MDX_ATTR_LITERAL_PROP = 1;
+const MDX_ATTR_EXPRESSION_PROP = 2;
+const MDX_ATTR_SPREAD = 3;
+// HastNode field offsets (same layout as MDAST — shared binary format)
+//   id: u32          @ 0
+//   node_type: u8    @ 4
+//   _pad: [u8; 3]    @ 5
+//   parent: u32      @ 8
+//   ...
+//   children_start: u32 @ 36
+//   children_count: u32 @ 40
+//   data_offset: u32 @ 44
+//   data_len: u32    @ 48
+//   Total: 52 bytes
+const FIELD = {
+    node_type: 4,
+    children_start: 36,
+    children_count: 40,
+    data_offset: 44,
+    data_len: 48,
+};
+// "MDAR" bytes: 4d 44 41 52; read as LE u32 = 0x5241444d
+const MAGIC = 0x5241444d;
+export class HastReader {
+    #view;
+    #header;
+    #textDecoder;
+    #sourceCache = null;
+    constructor(buffer) {
+        if (buffer instanceof Uint8Array) {
+            this.#view = new DataView(buffer.buffer, buffer.byteOffset, buffer.byteLength);
+        }
+        else {
+            this.#view = new DataView(buffer);
+        }
+        this.#textDecoder = new TextDecoder("utf-8");
+        this.#header = this.#readHeader();
+    }
+    #readHeader() {
+        const v = this.#view;
+        const magic = v.getUint32(0, true);
+        if (magic !== MAGIC) {
+            throw new Error(`Invalid HAST buffer: bad magic 0x${magic.toString(16)}`);
+        }
+        const version = v.getUint32(4, true);
+        if (version !== 1) {
+            throw new Error(`Unsupported HAST buffer version: ${version}`);
+        }
+        return {
+            version,
+            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),
+        };
+    }
+    get nodeCount() {
+        return this.#header.nodeCount;
+    }
+    get header() {
+        return { ...this.#header };
+    }
+    /** Get the full source string (string pool). */
+    getSource() {
+        if (this.#sourceCache === null) {
+            const { sourceOffset, sourceLen } = this.#header;
+            const bytes = new Uint8Array(this.#view.buffer, this.#view.byteOffset + sourceOffset, sourceLen);
+            this.#sourceCache = this.#textDecoder.decode(bytes);
+        }
+        return this.#sourceCache;
+    }
+    /** Read a substring from the string pool by byte offset and length. */
+    getString(offset, len) {
+        if (len === 0)
+            return "";
+        const { sourceOffset } = this.#header;
+        const bytes = new Uint8Array(this.#view.buffer, this.#view.byteOffset + sourceOffset + offset, len);
+        return this.#textDecoder.decode(bytes);
+    }
+    /** Get the node_type byte for a given node ID. */
+    getNodeType(nodeId) {
+        const { nodesOffset, nodeStructSize } = this.#header;
+        return this.#view.getUint8(nodesOffset + nodeId * nodeStructSize + FIELD.node_type);
+    }
+    /** Get child node IDs for a given node. */
+    getChildIds(nodeId) {
+        const base = this.#header.nodesOffset + nodeId * this.#header.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 < childrenCount; i++) {
+            ids.push(v.getUint32(childrenOffset + (childrenStart + i) * 4, true));
+        }
+        return ids;
+    }
+    /** Push child node IDs directly onto a stack array (reverse order for depth-first). */
+    pushChildIds(nodeId, stack) {
+        const base = this.#header.nodesOffset + nodeId * this.#header.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;
+        for (let i = childrenCount - 1; i >= 0; i--) {
+            stack.push(v.getUint32(childrenOffset + (childrenStart + i) * 4, true));
+        }
+    }
+    /** Get the raw type_data bytes for a node. */
+    getTypeData(nodeId) {
+        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);
+        return new Uint8Array(this.#view.buffer, this.#view.byteOffset + this.#header.typeDataOffset + dataOffset, dataLen);
+    }
+    /** Read a StringRef (offset: u32 LE, len: u32 LE) from a byte array at byteOffset. */
+    #readStringRef(data, byteOffset) {
+        const view = new DataView(data.buffer, data.byteOffset + byteOffset);
+        return {
+            offset: view.getUint32(0, true),
+            len: view.getUint32(4, true),
+        };
+    }
+    /**
+     * Get element data for a HAST_ELEMENT node.
+     *
+     * Element type_data layout:
+     *   [tag_name: StringRef(8B)][prop_count: u32(4B)][_pad: u32(4B)] = 16-byte header
+     *   then prop_count * 20 bytes:
+     *     [name: StringRef(8B)][value_type: u8(1B)][_pad: [u8;3](3B)][value: StringRef(8B)]
+     */
+    getElementData(nodeId) {
+        const data = this.getTypeData(nodeId);
+        if (data.length < 16) {
+            return { tagName: "", properties: [] };
+        }
+        const tagRef = this.#readStringRef(data, 0);
+        const tagName = this.getString(tagRef.offset, tagRef.len);
+        const view = new DataView(data.buffer, data.byteOffset + 8);
+        const propCount = view.getUint32(0, true);
+        const properties = [];
+        for (let i = 0; i < propCount; i++) {
+            const base = 16 + i * 20;
+            const nameRef = this.#readStringRef(data, base);
+            const name = this.getString(nameRef.offset, nameRef.len);
+            const valueType = data[base + 8];
+            const valueRef = this.#readStringRef(data, base + 12);
+            switch (valueType) {
+                case PROP_BOOL_TRUE:
+                    properties.push({ name, value: true });
+                    break;
+                case PROP_BOOL_FALSE:
+                    // skip false booleans
+                    break;
+                case PROP_STRING:
+                    properties.push({ name, value: this.getString(valueRef.offset, valueRef.len) });
+                    break;
+                case PROP_SPACE_SEP: {
+                    const raw = this.getString(valueRef.offset, valueRef.len);
+                    properties.push({ name, value: raw.split(" ").filter((s) => s.length > 0) });
+                    break;
+                }
+                case PROP_COMMA_SEP: {
+                    const raw = this.getString(valueRef.offset, valueRef.len);
+                    properties.push({
+                        name,
+                        value: raw
+                            .split(",")
+                            .map((s) => s.trim())
+                            .filter((s) => s.length > 0),
+                    });
+                    break;
+                }
+            }
+        }
+        return { tagName, properties };
+    }
+    /**
+     * Get MDX JSX element data: name and attributes.
+     *
+     * MDX JSX element type_data layout:
+     *   [name: StringRef(8B)][attr_count: u32(4B)][_pad: u32(4B)] = 16-byte header
+     *   then attr_count * 20 bytes:
+     *     [kind: u8(1B)][_pad: [u8;3](3B)][name: StringRef(8B)][value: StringRef(8B)]
+     */
+    getMdxJsxElementData(nodeId) {
+        const data = this.getTypeData(nodeId);
+        if (data.length < 16) {
+            return { name: null, attributes: [] };
+        }
+        const nameRef = this.#readStringRef(data, 0);
+        const name = nameRef.len > 0 ? this.getString(nameRef.offset, nameRef.len) : null;
+        const view = new DataView(data.buffer, data.byteOffset + 8);
+        const attrCount = view.getUint32(0, true);
+        const attributes = [];
+        for (let i = 0; i < attrCount; i++) {
+            const base = 16 + i * 20;
+            const kind = data[base];
+            const attrNameRef = this.#readStringRef(data, base + 4);
+            const attrValueRef = this.#readStringRef(data, base + 12);
+            switch (kind) {
+                case MDX_ATTR_BOOLEAN_PROP:
+                    attributes.push({
+                        type: "mdxJsxAttribute",
+                        name: this.getString(attrNameRef.offset, attrNameRef.len),
+                        value: null,
+                    });
+                    break;
+                case MDX_ATTR_LITERAL_PROP:
+                    attributes.push({
+                        type: "mdxJsxAttribute",
+                        name: this.getString(attrNameRef.offset, attrNameRef.len),
+                        value: this.getString(attrValueRef.offset, attrValueRef.len),
+                    });
+                    break;
+                case MDX_ATTR_EXPRESSION_PROP:
+                    attributes.push({
+                        type: "mdxJsxAttribute",
+                        name: this.getString(attrNameRef.offset, attrNameRef.len),
+                        value: {
+                            type: "mdxJsxAttributeValueExpression",
+                            value: this.getString(attrValueRef.offset, attrValueRef.len),
+                        },
+                    });
+                    break;
+                case MDX_ATTR_SPREAD:
+                    attributes.push({
+                        type: "mdxJsxExpressionAttribute",
+                        value: this.getString(attrValueRef.offset, attrValueRef.len),
+                    });
+                    break;
+            }
+        }
+        return { name, attributes };
+    }
+    /**
+     * Get the string value for HAST_TEXT, HAST_COMMENT, or HAST_RAW nodes.
+     * These store a single StringRef (8 bytes) as their type_data.
+     */
+    getTextValue(nodeId) {
+        const data = this.getTypeData(nodeId);
+        if (data.length < 8)
+            return "";
+        const ref = this.#readStringRef(data, 0);
+        return this.getString(ref.offset, ref.len);
+    }
+}
+//# sourceMappingURL=hast-reader.js.map

package/dist/hast/hast-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hast-reader.js","sourceRoot":"","sources":["../../src/hast/hast-reader.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,71 @@
+import { type HastNode } from "./hast-materializer.js";
+import type { HastRaw } from "../types.js";
+import type { Element, Text, Comment, Doctype } from "hast";
+import type { MdxJsxFlowElementHast, MdxJsxTextElementHast } from "mdast-util-mdx-jsx";
+import type { MdxFlowExpressionHast, MdxTextExpressionHast } from "mdast-util-mdx-expression";
+import type { MdxjsEsmHast } from "mdast-util-mdxjs-esm";
+export type HastHandle = any;
+/** ESTree-compatible Program node returned by `parseExpression()`. */
+export type EstreeProgram = Record<string, any>;
+export interface HastDiagnostic {
+    message: string;
+    nodeId?: number | undefined;
+    severity: "error" | "warning" | "info";
+}
+export interface HastVisitorContext {
+    readonly source: string;
+    readonly filename: string;
+    removeNode(node: HastNode): void;
+    replaceNode(node: HastNode, newNode: HastNode): void;
+    insertBefore(node: HastNode, newNode: HastNode): void;
+    insertAfter(node: HastNode, newNode: HastNode): void;
+    wrapNode(node: HastNode, parentNode: HastNode): void;
+    prependChild(node: HastNode, childNode: HastNode): void;
+    appendChild(node: HastNode, childNode: HastNode): void;
+    setProperty(node: HastNode, key: string, value: unknown): void;
+    /** Collect the concatenated text of all descendant text nodes (like DOM textContent). */
+    textContent(node: HastNode): string;
+    report(opts: {
+        message: string;
+        node?: HastNode;
+        severity?: "error" | "warning" | "info";
+    }): void;
+    getDiagnostics(): HastDiagnostic[];
+}
+/** A filtered visitor: Rust filters by tag/component name, only matched nodes cross the boundary. */
+export interface HastFilteredVisitor<N extends HastNode = HastNode> {
+    filter: string[];
+    visit(node: N, ctx: HastVisitorContext): HastNode | void | Promise<HastNode | void>;
+}
+type HastVisitorFn<N extends HastNode = HastNode> = (node: N, ctx: HastVisitorContext) => HastNode | void | Promise<HastNode | void>;
+export interface HastVisitorInstance {
+    element?: HastFilteredVisitor<Element> | HastFilteredVisitor<Element>[];
+    mdxJsxFlowElement?: HastFilteredVisitor<MdxJsxFlowElementHast> | HastFilteredVisitor<MdxJsxFlowElementHast>[];
+    mdxJsxTextElement?: HastFilteredVisitor<MdxJsxTextElementHast> | HastFilteredVisitor<MdxJsxTextElementHast>[];
+    text?: HastVisitorFn<Text>;
+    comment?: HastVisitorFn<Comment>;
+    raw?: HastVisitorFn<HastRaw>;
+    doctype?: HastVisitorFn<Doctype>;
+    mdxFlowExpression?: HastVisitorFn<MdxFlowExpressionHast & {
+        parseExpression(): EstreeProgram | null;
+    }>;
+    mdxTextExpression?: HastVisitorFn<MdxTextExpressionHast & {
+        parseExpression(): EstreeProgram | null;
+    }>;
+    mdxjsEsm?: HastVisitorFn<MdxjsEsmHast>;
+}
+interface ResolvedSubscription {
+    nodeType: number;
+    tagFilter: string[];
+    visitFn: (node: HastNode, ctx: HastVisitorContext) => HastNode | void;
+}
+/** Resolve subscriptions from a plugin instance. */
+export declare function resolveSubscriptions(plugin: HastVisitorInstance): ResolvedSubscription[];
+/**
+ * Walk a handle's arena in Rust, dispatch matched nodes to JS visitor functions,
+ * and apply mutations back to the handle. No arena buffers cross NAPI.
+ *
+ * Returns void if all visitors are sync, or a Promise if any visitor is async.
+ */
+export declare function visitHastHandle(handle: HastHandle, plugin: HastVisitorInstance, subs: ResolvedSubscription[], source: string, filename: string): void | Promise<void>;
+export {};