@jasonbelmonti/markdown-engine 0.1.0 → 1.0.0

package/dist/cli/run.js

@@ -0,0 +1,37 @@
+import { serialize } from "../api/contracts.js";
+import { cliUsage, parseCliArgs } from "./args.js";
+import { compatibilityModeForDocumentVersion } from "./document-version.js";
+import { readMarkdownFile } from "./files.js";
+import { normalizeMarkdown } from "./normalize-markdown.js";
+export async function runCli(input) {
+    const argsResult = parseCliArgs(input.args);
+    if (argsResult.kind === "help") {
+        input.stdout.write(cliUsage);
+        return 0;
+    }
+    if (argsResult.kind === "error") {
+        input.stderr.write(`${argsResult.message}\n\n${cliUsage}`);
+        return 2;
+    }
+    try {
+        const markdown = await readMarkdownFile(argsResult.targetPath, input.cwd);
+        const normalizeResult = normalizeMarkdown({
+            documentVersion: argsResult.documentVersion,
+            markdown,
+            path: argsResult.targetPath,
+        });
+        input.stdout.write(`${serialize(normalizeResult, {
+            compatibilityMode: compatibilityModeForDocumentVersion(argsResult.documentVersion),
+            pretty: true,
+        })}\n`);
+        return 0;
+    }
+    catch (error) {
+        input.stderr.write(`${errorMessage(error)}\n`);
+        return 1;
+    }
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=run.js.map

package/dist/cli/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/cli/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,mCAAmC,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAa5D,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,KAAkB;IAC7C,MAAM,UAAU,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE5C,IAAI,UAAU,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC/B,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC7B,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,UAAU,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAChC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC,OAAO,OAAO,QAAQ,EAAE,CAAC,CAAC;QAC3D,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,UAAU,CAAC,UAAU,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1E,MAAM,eAAe,GAAG,iBAAiB,CAAC;YACxC,eAAe,EAAE,UAAU,CAAC,eAAe;YAC3C,QAAQ;YACR,IAAI,EAAE,UAAU,CAAC,UAAU;SAC5B,CAAC,CAAC;QAEH,KAAK,CAAC,MAAM,CAAC,KAAK,CAChB,GAAG,SAAS,CAAC,eAAe,EAAE;YAC5B,iBAAiB,EAAE,mCAAmC,CACpD,UAAU,CAAC,eAAe,CAC3B;YACD,MAAM,EAAE,IAAI;SACb,CAAC,IAAI,CACP,CAAC;QACF,OAAO,CAAC,CAAC;IACX,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/C,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC"}

package/dist/ir/document-derived-views.d.ts

@@ -0,0 +1,4 @@
+import type { EngineDocument } from "../api/document.js";
+import { type DocumentViewBuildOptions } from "./document-targets.js";
+export declare function buildDocumentViews(document: EngineDocument, options: DocumentViewBuildOptions): EngineDocument;
+//# sourceMappingURL=document-derived-views.d.ts.map

package/dist/ir/document-derived-views.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-derived-views.d.ts","sourceRoot":"","sources":["../../src/ir/document-derived-views.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAKzD,OAAO,EAEL,KAAK,wBAAwB,EAE9B,MAAM,uBAAuB,CAAC;AAG/B,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,wBAAwB,GAChC,cAAc,CAoBhB"}

package/dist/ir/document-derived-views.js

@@ -0,0 +1,25 @@
+import { collectLinks } from "./document-link-views.js";
+import { collectLists } from "./document-list-views.js";
+import { buildSections } from "./document-sections.js";
+import { collectTables } from "./document-table-views.js";
+import { targetFor, withNodeMetadata, } from "./document-targets.js";
+import { collectTextSpans } from "./document-text-spans.js";
+export function buildDocumentViews(document, options) {
+    const children = document.children.map((node, index) => withNodeMetadata(node, [index], options));
+    return {
+        ...document,
+        version: "1.0.0",
+        target: targetFor("document", [], document.sourceRange),
+        children,
+        compatibility: {
+            mode: "default",
+            reason: "1.0 document contract",
+        },
+        sections: buildSections(children),
+        textSpans: collectTextSpans(children),
+        tables: collectTables(children),
+        lists: collectLists(children),
+        links: collectLinks(children),
+    };
+}
+//# sourceMappingURL=document-derived-views.js.map

package/dist/ir/document-derived-views.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-derived-views.js","sourceRoot":"","sources":["../../src/ir/document-derived-views.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EACL,SAAS,EAET,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,MAAM,UAAU,kBAAkB,CAChC,QAAwB,EACxB,OAAiC;IAEjC,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACrD,gBAAgB,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CACzC,CAAC;IAEF,OAAO;QACL,GAAG,QAAQ;QACX,OAAO,EAAE,OAAO;QAChB,MAAM,EAAE,SAAS,CAAC,UAAU,EAAE,EAAE,EAAE,QAAQ,CAAC,WAAW,CAAC;QACvD,QAAQ;QACR,aAAa,EAAE;YACb,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,uBAAuB;SAChC;QACD,QAAQ,EAAE,aAAa,CAAC,QAAQ,CAAC;QACjC,SAAS,EAAE,gBAAgB,CAAC,QAAQ,CAAC;QACrC,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC;QAC/B,KAAK,EAAE,YAAY,CAAC,QAAQ,CAAC;QAC7B,KAAK,EAAE,YAAY,CAAC,QAAQ,CAAC;KAC9B,CAAC;AACJ,CAAC"}

package/dist/ir/document-link-views.d.ts

@@ -0,0 +1,3 @@
+import type { EngineLink, EngineNode } from "../api/document.js";
+export declare function collectLinks(nodes: readonly EngineNode[]): readonly EngineLink[];
+//# sourceMappingURL=document-link-views.d.ts.map

package/dist/ir/document-link-views.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-link-views.d.ts","sourceRoot":"","sources":["../../src/ir/document-link-views.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGjE,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,GAAG,SAAS,UAAU,EAAE,CAwBhF"}

package/dist/ir/document-link-views.js

@@ -0,0 +1,24 @@
+import { flatMapNodes } from "./document-node-walk.js";
+export function collectLinks(nodes) {
+    return flatMapNodes(nodes, (node) => {
+        if (node.type !== "link" ||
+            node.target === undefined ||
+            typeof node.attributes?.url !== "string") {
+            return [];
+        }
+        return [
+            {
+                target: node.target,
+                url: node.attributes.url,
+                text: node.text ?? "",
+                ...(typeof node.attributes.title === "string"
+                    ? { title: node.attributes.title }
+                    : {}),
+                ...(node.sourceRange !== undefined
+                    ? { sourceRange: node.sourceRange }
+                    : {}),
+            },
+        ];
+    });
+}
+//# sourceMappingURL=document-link-views.js.map

package/dist/ir/document-link-views.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-link-views.js","sourceRoot":"","sources":["../../src/ir/document-link-views.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,MAAM,UAAU,YAAY,CAAC,KAA4B;IACvD,OAAO,YAAY,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE;QAClC,IACE,IAAI,CAAC,IAAI,KAAK,MAAM;YACpB,IAAI,CAAC,MAAM,KAAK,SAAS;YACzB,OAAO,IAAI,CAAC,UAAU,EAAE,GAAG,KAAK,QAAQ,EACxC,CAAC;YACD,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO;YACL;gBACE,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,GAAG,EAAE,IAAI,CAAC,UAAU,CAAC,GAAG;gBACxB,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE;gBACrB,GAAG,CAAC,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,KAAK,QAAQ;oBAC3C,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE;oBAClC,CAAC,CAAC,EAAE,CAAC;gBACP,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS;oBAChC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE;oBACnC,CAAC,CAAC,EAAE,CAAC;aACR;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/ir/document-list-views.d.ts

@@ -0,0 +1,3 @@
+import type { EngineList, EngineNode } from "../api/document.js";
+export declare function collectLists(nodes: readonly EngineNode[]): readonly EngineList[];
+//# sourceMappingURL=document-list-views.d.ts.map

package/dist/ir/document-list-views.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-list-views.d.ts","sourceRoot":"","sources":["../../src/ir/document-list-views.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EAEV,UAAU,EACX,MAAM,oBAAoB,CAAC;AAG5B,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,GAAG,SAAS,UAAU,EAAE,CAEhF"}

package/dist/ir/document-list-views.js

@@ -0,0 +1,38 @@
+import { requireNodeTarget } from "./document-targets.js";
+export function collectLists(nodes) {
+    return collectListsAtDepth(nodes, 0);
+}
+function collectListsAtDepth(nodes, depth) {
+    return nodes.flatMap((node) => {
+        const childDepth = node.type === "list" ? depth + 1 : depth;
+        const nestedLists = collectListsAtDepth(node.children ?? [], childDepth);
+        if (node.type !== "list" || node.target === undefined) {
+            return nestedLists;
+        }
+        return [
+            {
+                target: node.target,
+                ordered: node.attributes?.ordered === true,
+                ...(typeof node.attributes?.start === "number"
+                    ? { start: node.attributes.start }
+                    : {}),
+                items: listItems(node, depth),
+            },
+            ...nestedLists,
+        ];
+    });
+}
+function listItems(list, depth) {
+    return (list.children ?? [])
+        .filter((node) => node.type === "listItem" && node.target !== undefined)
+        .map((item, itemIndex) => ({
+        target: requireNodeTarget(item),
+        itemIndex,
+        depth,
+        ...(typeof item.attributes?.checked === "boolean"
+            ? { checked: item.attributes.checked }
+            : {}),
+        ...(item.sourceRange !== undefined ? { sourceRange: item.sourceRange } : {}),
+    }));
+}
+//# sourceMappingURL=document-list-views.js.map

package/dist/ir/document-list-views.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-list-views.js","sourceRoot":"","sources":["../../src/ir/document-list-views.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1D,MAAM,UAAU,YAAY,CAAC,KAA4B;IACvD,OAAO,mBAAmB,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;AACvC,CAAC;AAED,SAAS,mBAAmB,CAC1B,KAA4B,EAC5B,KAAa;IAEb,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAC5B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAC5D,MAAM,WAAW,GAAG,mBAAmB,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,EAAE,UAAU,CAAC,CAAC;QAEzE,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACtD,OAAO,WAAW,CAAC;QACrB,CAAC;QAED,OAAO;YACL;gBACE,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,OAAO,KAAK,IAAI;gBAC1C,GAAG,CAAC,OAAO,IAAI,CAAC,UAAU,EAAE,KAAK,KAAK,QAAQ;oBAC5C,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE;oBAClC,CAAC,CAAC,EAAE,CAAC;gBACP,KAAK,EAAE,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC;aAC9B;YACD,GAAG,WAAW;SACf,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,SAAS,CAAC,IAAgB,EAAE,KAAa;IAChD,OAAO,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;SACzB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,UAAU,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC;SACvE,GAAG,CAAC,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;QACzB,MAAM,EAAE,iBAAiB,CAAC,IAAI,CAAC;QAC/B,SAAS;QACT,KAAK;QACL,GAAG,CAAC,OAAO,IAAI,CAAC,UAAU,EAAE,OAAO,KAAK,SAAS;YAC/C,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE;YACtC,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7E,CAAC,CAAC,CAAC;AACR,CAAC"}

package/dist/ir/document-node-walk.d.ts

@@ -0,0 +1,5 @@
+import type { EngineNode } from "../api/document.js";
+export declare function flatMapNodes<T>(nodes: readonly EngineNode[], callback: (node: EngineNode) => readonly T[]): T[];
+export declare function flattenNodes(nodes: readonly EngineNode[]): EngineNode[];
+export declare function nodeText(node: EngineNode): string;
+//# sourceMappingURL=document-node-walk.d.ts.map

package/dist/ir/document-node-walk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-node-walk.d.ts","sourceRoot":"","sources":["../../src/ir/document-node-walk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,wBAAgB,YAAY,CAAC,CAAC,EAC5B,KAAK,EAAE,SAAS,UAAU,EAAE,EAC5B,QAAQ,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,SAAS,CAAC,EAAE,GAC3C,CAAC,EAAE,CAKL;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,GAAG,UAAU,EAAE,CAEvE;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAMjD"}

package/dist/ir/document-node-walk.js

@@ -0,0 +1,16 @@
+export function flatMapNodes(nodes, callback) {
+    return nodes.flatMap((node) => [
+        ...callback(node),
+        ...flatMapNodes(node.children ?? [], callback),
+    ]);
+}
+export function flattenNodes(nodes) {
+    return flatMapNodes(nodes, (node) => [node]);
+}
+export function nodeText(node) {
+    if (node.text !== undefined) {
+        return node.text;
+    }
+    return (node.children ?? []).map((child) => nodeText(child)).join("");
+}
+//# sourceMappingURL=document-node-walk.js.map

package/dist/ir/document-node-walk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-node-walk.js","sourceRoot":"","sources":["../../src/ir/document-node-walk.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,YAAY,CAC1B,KAA4B,EAC5B,QAA4C;IAE5C,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QAC7B,GAAG,QAAQ,CAAC,IAAI,CAAC;QACjB,GAAG,YAAY,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,EAAE,QAAQ,CAAC;KAC/C,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAA4B;IACvD,OAAO,YAAY,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAgB;IACvC,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACxE,CAAC"}

package/dist/ir/document-sections.d.ts

@@ -0,0 +1,3 @@
+import type { EngineNode, EngineSection } from "../api/document.js";
+export declare function buildSections(children: readonly EngineNode[]): readonly EngineSection[];
+//# sourceMappingURL=document-sections.d.ts.map

package/dist/ir/document-sections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-sections.d.ts","sourceRoot":"","sources":["../../src/ir/document-sections.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,aAAa,EAEd,MAAM,oBAAoB,CAAC;AAa5B,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,SAAS,UAAU,EAAE,GAC9B,SAAS,aAAa,EAAE,CAsC1B"}

package/dist/ir/document-sections.js

@@ -0,0 +1,57 @@
+import { requireNodeTarget } from "./document-targets.js";
+export function buildSections(children) {
+    const sections = [];
+    const stack = [];
+    for (const node of children) {
+        if (isHeading(node)) {
+            const depth = headingDepth(node);
+            let currentSection = stack.at(-1);
+            while (currentSection !== undefined && currentSection.depth >= depth) {
+                stack.pop();
+                currentSection = stack.at(-1);
+            }
+            const section = sectionForHeading(node, depth, currentSection);
+            currentSection?.childSections.push(section.target);
+            sections.push(section);
+            stack.push(section);
+            continue;
+        }
+        if (node.target !== undefined) {
+            stack.at(-1)?.bodyTargets.push(node.target);
+        }
+    }
+    return sections.map((section) => ({
+        target: section.target,
+        headingTarget: section.headingTarget,
+        ...(section.parentSection !== undefined
+            ? { parentSection: section.parentSection }
+            : {}),
+        depth: section.depth,
+        title: section.title,
+        bodyTargets: section.bodyTargets,
+        childSections: section.childSections,
+    }));
+}
+function isHeading(node) {
+    return node.type === "heading" && node.target !== undefined;
+}
+function headingDepth(node) {
+    return typeof node.attributes?.depth === "number" ? node.attributes.depth : 0;
+}
+function sectionForHeading(node, depth, parentSection) {
+    const headingTarget = requireNodeTarget(node);
+    return {
+        target: {
+            ...headingTarget,
+            id: `section:${headingTarget.id}`,
+            nodeType: "section",
+        },
+        headingTarget,
+        ...(parentSection !== undefined ? { parentSection: parentSection.target } : {}),
+        depth,
+        title: node.text ?? "",
+        bodyTargets: [],
+        childSections: [],
+    };
+}
+//# sourceMappingURL=document-sections.js.map

package/dist/ir/document-sections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-sections.js","sourceRoot":"","sources":["../../src/ir/document-sections.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAY1D,MAAM,UAAU,aAAa,CAC3B,QAA+B;IAE/B,MAAM,QAAQ,GAAqB,EAAE,CAAC;IACtC,MAAM,KAAK,GAAqB,EAAE,CAAC;IAEnC,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,IAAI,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YACpB,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YACjC,IAAI,cAAc,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YAElC,OAAO,cAAc,KAAK,SAAS,IAAI,cAAc,CAAC,KAAK,IAAI,KAAK,EAAE,CAAC;gBACrE,KAAK,CAAC,GAAG,EAAE,CAAC;gBACZ,cAAc,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YAChC,CAAC;YAED,MAAM,OAAO,GAAG,iBAAiB,CAAC,IAAI,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;YAE/D,cAAc,EAAE,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACnD,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACpB,SAAS;QACX,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC9B,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAChC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,GAAG,CAAC,OAAO,CAAC,aAAa,KAAK,SAAS;YACrC,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE;YAC1C,CAAC,CAAC,EAAE,CAAC;QACP,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,aAAa,EAAE,OAAO,CAAC,aAAa;KACrC,CAAC,CAAC,CAAC;AACN,CAAC;AAED,SAAS,SAAS,CAAC,IAAgB;IACjC,OAAO,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC;AAC9D,CAAC;AAED,SAAS,YAAY,CAAC,IAAgB;IACpC,OAAO,OAAO,IAAI,CAAC,UAAU,EAAE,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAChF,CAAC;AAED,SAAS,iBAAiB,CACxB,IAAgB,EAChB,KAAa,EACb,aAAyC;IAEzC,MAAM,aAAa,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAE9C,OAAO;QACL,MAAM,EAAE;YACN,GAAG,aAAa;YAChB,EAAE,EAAE,WAAW,aAAa,CAAC,EAAE,EAAE;YACjC,QAAQ,EAAE,SAAS;SACpB;QACD,aAAa;QACb,GAAG,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/E,KAAK;QACL,KAAK,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE;QACtB,WAAW,EAAE,EAAE;QACf,aAAa,EAAE,EAAE;KAClB,CAAC;AACJ,CAAC"}

package/dist/ir/document-table-views.d.ts

@@ -0,0 +1,3 @@
+import type { EngineNode, EngineTable } from "../api/document.js";
+export declare function collectTables(nodes: readonly EngineNode[]): readonly EngineTable[];
+//# sourceMappingURL=document-table-views.d.ts.map

package/dist/ir/document-table-views.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-table-views.d.ts","sourceRoot":"","sources":["../../src/ir/document-table-views.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EAEZ,MAAM,oBAAoB,CAAC;AAI5B,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,GAAG,SAAS,WAAW,EAAE,CAalF"}

package/dist/ir/document-table-views.js

@@ -0,0 +1,31 @@
+import { flatMapNodes, nodeText } from "./document-node-walk.js";
+import { requireNodeTarget } from "./document-targets.js";
+export function collectTables(nodes) {
+    return flatMapNodes(nodes, (node) => {
+        if (node.type !== "table" || node.target === undefined) {
+            return [];
+        }
+        return [
+            {
+                target: node.target,
+                cells: tableCells(node),
+            },
+        ];
+    });
+}
+function tableCells(table) {
+    const rows = (table.children ?? []).filter((node) => node.type === "tableRow");
+    return rows.flatMap((row, rowIndex) => (row.children ?? [])
+        .filter((node) => node.type === "tableCell" && node.target !== undefined)
+        .map((cell, columnIndex) => ({
+        target: requireNodeTarget(cell),
+        text: nodeText(cell),
+        rowIndex,
+        columnIndex,
+        header: rowIndex === 0,
+        ...(cell.sourceRange !== undefined
+            ? { sourceRange: cell.sourceRange }
+            : {}),
+    })));
+}
+//# sourceMappingURL=document-table-views.js.map

package/dist/ir/document-table-views.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-table-views.js","sourceRoot":"","sources":["../../src/ir/document-table-views.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1D,MAAM,UAAU,aAAa,CAAC,KAA4B;IACxD,OAAO,YAAY,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE;QAClC,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACvD,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO;YACL;gBACE,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC;aACxB;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,UAAU,CAAC,KAAiB;IACnC,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;IAE/E,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,CACpC,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC;SACjB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,WAAW,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC;SACxE,GAAG,CAAC,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC;QAC3B,MAAM,EAAE,iBAAiB,CAAC,IAAI,CAAC;QAC/B,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC;QACpB,QAAQ;QACR,WAAW;QACX,MAAM,EAAE,QAAQ,KAAK,CAAC;QACtB,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS;YAChC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE;YACnC,CAAC,CAAC,EAAE,CAAC;KACR,CAAC,CAAC,CACN,CAAC;AACJ,CAAC"}

package/dist/ir/document-targets.d.ts

@@ -0,0 +1,10 @@
+import type { SourceRange } from "../api/diagnostics.js";
+import type { EngineNode, EngineNodeTarget } from "../api/document.js";
+export interface DocumentViewBuildOptions {
+    preserveSourceLocations: boolean;
+    source: string;
+}
+export declare function withNodeMetadata(node: EngineNode, path: readonly number[], options: DocumentViewBuildOptions): EngineNode;
+export declare function targetFor(nodeType: string, path: readonly number[], sourceRange: SourceRange | undefined): EngineNodeTarget;
+export declare function requireNodeTarget(node: EngineNode): EngineNodeTarget;
+//# sourceMappingURL=document-targets.d.ts.map

package/dist/ir/document-targets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-targets.d.ts","sourceRoot":"","sources":["../../src/ir/document-targets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EACV,UAAU,EAEV,gBAAgB,EACjB,MAAM,oBAAoB,CAAC;AAG5B,MAAM,WAAW,wBAAwB;IACvC,uBAAuB,EAAE,OAAO,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE,wBAAwB,GAChC,UAAU,CAaZ;AAED,wBAAgB,SAAS,CACvB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,WAAW,EAAE,WAAW,GAAG,SAAS,GACnC,gBAAgB,CAYlB;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,gBAAgB,CAMpE"}

package/dist/ir/document-targets.js

@@ -0,0 +1,44 @@
+import { cloneSourceRange, sourceOffsetBounds } from "./source-ranges.js";
+export function withNodeMetadata(node, path, options) {
+    const children = (node.children ?? []).map((child, index) => withNodeMetadata(child, [...path, index], options));
+    const target = targetFor(node.type, path, node.sourceRange);
+    const source = sourceSliceForRange(node.sourceRange, options);
+    return {
+        ...node,
+        target,
+        ...(source !== undefined ? { source } : {}),
+        ...(children.length > 0 ? { children } : {}),
+    };
+}
+export function targetFor(nodeType, path, sourceRange) {
+    const idPath = path.length === 0 ? "root" : path.join(".");
+    return {
+        kind: "node",
+        id: `node:${idPath}:${nodeType}`,
+        path: [...path],
+        nodeType,
+        ...(sourceRange !== undefined
+            ? { sourceRange: cloneSourceRange(sourceRange) }
+            : {}),
+    };
+}
+export function requireNodeTarget(node) {
+    if (node.target === undefined) {
+        throw new Error(`Expected ${node.type} node to have a target.`);
+    }
+    return node.target;
+}
+function sourceSliceForRange(sourceRange, options) {
+    if (!options.preserveSourceLocations || sourceRange === undefined) {
+        return undefined;
+    }
+    const offsets = sourceOffsetBounds(sourceRange, options.source.length);
+    if (offsets === undefined) {
+        return undefined;
+    }
+    return {
+        range: cloneSourceRange(sourceRange),
+        text: options.source.slice(offsets.startOffset, offsets.endOffset),
+    };
+}
+//# sourceMappingURL=document-targets.js.map

package/dist/ir/document-targets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-targets.js","sourceRoot":"","sources":["../../src/ir/document-targets.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAO1E,MAAM,UAAU,gBAAgB,CAC9B,IAAgB,EAChB,IAAuB,EACvB,OAAiC;IAEjC,MAAM,QAAQ,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAC1D,gBAAgB,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,EAAE,OAAO,CAAC,CACnD,CAAC;IACF,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAC5D,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAE9D,OAAO;QACL,GAAG,IAAI;QACP,MAAM;QACN,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3C,GAAG,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CACvB,QAAgB,EAChB,IAAuB,EACvB,WAAoC;IAEpC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAE3D,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,EAAE,EAAE,QAAQ,MAAM,IAAI,QAAQ,EAAE;QAChC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;QACf,QAAQ;QACR,GAAG,CAAC,WAAW,KAAK,SAAS;YAC3B,CAAC,CAAC,EAAE,WAAW,EAAE,gBAAgB,CAAC,WAAW,CAAC,EAAE;YAChD,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAgB;IAChD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,YAAY,IAAI,CAAC,IAAI,yBAAyB,CAAC,CAAC;IAClE,CAAC;IAED,OAAO,IAAI,CAAC,MAAM,CAAC;AACrB,CAAC;AAED,SAAS,mBAAmB,CAC1B,WAAoC,EACpC,OAAiC;IAEjC,IAAI,CAAC,OAAO,CAAC,uBAAuB,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAClE,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,OAAO,GAAG,kBAAkB,CAAC,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAEvE,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO;QACL,KAAK,EAAE,gBAAgB,CAAC,WAAW,CAAC;QACpC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,SAAS,CAAC;KACnE,CAAC;AACJ,CAAC"}

package/dist/ir/document-text-spans.d.ts

@@ -0,0 +1,3 @@
+import type { EngineNode, EngineTextSpan } from "../api/document.js";
+export declare function collectTextSpans(nodes: readonly EngineNode[]): readonly EngineTextSpan[];
+//# sourceMappingURL=document-text-spans.d.ts.map

package/dist/ir/document-text-spans.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-text-spans.d.ts","sourceRoot":"","sources":["../../src/ir/document-text-spans.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGrE,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,UAAU,EAAE,GAC3B,SAAS,cAAc,EAAE,CAgB3B"}

package/dist/ir/document-text-spans.js

@@ -0,0 +1,18 @@
+import { flatMapNodes } from "./document-node-walk.js";
+export function collectTextSpans(nodes) {
+    return flatMapNodes(nodes, (node) => {
+        if (node.text === undefined || node.target === undefined) {
+            return [];
+        }
+        return [
+            {
+                target: node.target,
+                text: node.text,
+                ...(node.sourceRange !== undefined
+                    ? { sourceRange: node.sourceRange }
+                    : {}),
+            },
+        ];
+    });
+}
+//# sourceMappingURL=document-text-spans.js.map

package/dist/ir/document-text-spans.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-text-spans.js","sourceRoot":"","sources":["../../src/ir/document-text-spans.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,MAAM,UAAU,gBAAgB,CAC9B,KAA4B;IAE5B,OAAO,YAAY,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE;QAClC,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACzD,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO;YACL;gBACE,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS;oBAChC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE;oBACnC,CAAC,CAAC,EAAE,CAAC;aACR;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/ir/document.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../src/ir/document.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAc,MAAM,oBAAoB,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGtD,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,cAAc,EACtB,OAAO,GAAE,gBAAqB,GAC7B,cAAc,CAmBhB"}
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../src/ir/document.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAc,MAAM,oBAAoB,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAKtD,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,cAAc,EACtB,OAAO,GAAE,gBAAqB,GAC7B,cAAc,CA6BhB"}

package/dist/ir/document.js

@@ -1,11 +1,14 @@
 import { hasOwnProperty, isPlainRecord } from "../internal/plain-record.js";
+import { buildDocumentViews } from "./document-derived-views.js";
+import { cloneSourceRange } from "./source-ranges.js";
 export function normalizeParsedMarkdown(parsed, options = {}) {
     const preserveSourceLocations = options.preserveSourceLocations ?? true;
     const document = parsed.document;
     const path = document.path ?? parsed.path;
-    return {
+    const version = options.documentVersion ?? document.version;
+    const normalizedDocument = {
         kind: "markdown-document",
-        version: document.version,
+        version,
         ...(path !== undefined ? { path } : {}),
         ...(hasOwnProperty(parsed, "frontmatter")
             ? { frontmatter: cloneUnknown(parsed.frontmatter) }
@@ -15,6 +18,13 @@ export function normalizeParsedMarkdown(parsed, options = {}) {
             : {}),
         children: document.children.map((node) => normalizeNode(node, preserveSourceLocations)),
     };
+    if (version === "1.0.0") {
+        return buildDocumentViews(normalizedDocument, {
+            preserveSourceLocations,
+            source: parsed.markdown,
+        });
+    }
+    return normalizedDocument;
 }
 function normalizeNode(node, preserveSourceLocations) {
     return {
@@ -47,10 +57,4 @@ function cloneUnknown(value) {
     }
     return value;
 }
-function cloneSourceRange(sourceRange) {
-    return {
-        start: { ...sourceRange.start },
-        end: { ...sourceRange.end },
-    };
-}
 //# sourceMappingURL=document.js.map

package/dist/ir/document.js.map

@@ -1 +1 @@
-{"version":3,"file":"document.js","sourceRoot":"","sources":["../../src/ir/document.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE5E,MAAM,UAAU,uBAAuB,CACrC,MAAsB,EACtB,UAA4B,EAAE;IAE9B,MAAM,uBAAuB,GAAG,OAAO,CAAC,uBAAuB,IAAI,IAAI,CAAC;IACxE,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IACjC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC;IAE1C,OAAO;QACL,IAAI,EAAE,mBAAmB;QACzB,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvC,GAAG,CAAC,cAAc,CAAC,MAAM,EAAE,aAAa,CAAC;YACvC,CAAC,CAAC,EAAE,WAAW,EAAE,YAAY,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE;YACnD,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,uBAAuB,IAAI,QAAQ,CAAC,WAAW,KAAK,SAAS;YAC/D,CAAC,CAAC,EAAE,WAAW,EAAE,gBAAgB,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE;YACzD,CAAC,CAAC,EAAE,CAAC;QACP,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACvC,aAAa,CAAC,IAAI,EAAE,uBAAuB,CAAC,CAC7C;KACF,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CACpB,IAAgB,EAChB,uBAAgC;IAEhC,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,GAAG,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS;YAC/B,CAAC,CAAC,EAAE,UAAU,EAAE,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE;YAC9C,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,uBAAuB,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS;YAC3D,CAAC,CAAC,EAAE,WAAW,EAAE,gBAAgB,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE;YACrD,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS;YAC7B,CAAC,CAAC;gBACE,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CACpC,aAAa,CAAC,KAAK,EAAE,uBAAuB,CAAC,CAC9C;aACF;YACH,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,MAA+B;IAClD,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;SAChB,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAClD,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;IACjD,CAAC;IAED,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,gBAAgB,CAAC,WAAwB;IAChD,OAAO;QACL,KAAK,EAAE,EAAE,GAAG,WAAW,CAAC,KAAK,EAAE;QAC/B,GAAG,EAAE,EAAE,GAAG,WAAW,CAAC,GAAG,EAAE;KAC5B,CAAC;AACJ,CAAC"}
+{"version":3,"file":"document.js","sourceRoot":"","sources":["../../src/ir/document.ts"],"names":[],"mappings":"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"}

package/dist/ir/source-ranges.d.ts

@@ -0,0 +1,8 @@
+import type { SourceRange } from "../api/diagnostics.js";
+export interface SourceOffsetBounds {
+    startOffset: number;
+    endOffset: number;
+}
+export declare function cloneSourceRange(sourceRange: SourceRange): SourceRange;
+export declare function sourceOffsetBounds(sourceRange: SourceRange | undefined, sourceLength: number): SourceOffsetBounds | undefined;
+//# sourceMappingURL=source-ranges.d.ts.map

package/dist/ir/source-ranges.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-ranges.d.ts","sourceRoot":"","sources":["../../src/ir/source-ranges.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,WAAW,GAAG,WAAW,CAKtE;AAED,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,WAAW,GAAG,SAAS,EACpC,YAAY,EAAE,MAAM,GACnB,kBAAkB,GAAG,SAAS,CAiBhC"}

package/dist/ir/source-ranges.js

@@ -0,0 +1,21 @@
+export function cloneSourceRange(sourceRange) {
+    return {
+        start: { ...sourceRange.start },
+        end: { ...sourceRange.end },
+    };
+}
+export function sourceOffsetBounds(sourceRange, sourceLength) {
+    const startOffset = sourceRange?.start.offset;
+    const endOffset = sourceRange?.end.offset;
+    if (typeof startOffset !== "number" ||
+        typeof endOffset !== "number" ||
+        !Number.isInteger(startOffset) ||
+        !Number.isInteger(endOffset) ||
+        startOffset < 0 ||
+        endOffset < startOffset ||
+        endOffset > sourceLength) {
+        return undefined;
+    }
+    return { startOffset, endOffset };
+}
+//# sourceMappingURL=source-ranges.js.map

package/dist/ir/source-ranges.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-ranges.js","sourceRoot":"","sources":["../../src/ir/source-ranges.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,gBAAgB,CAAC,WAAwB;IACvD,OAAO;QACL,KAAK,EAAE,EAAE,GAAG,WAAW,CAAC,KAAK,EAAE;QAC/B,GAAG,EAAE,EAAE,GAAG,WAAW,CAAC,GAAG,EAAE;KAC5B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,WAAoC,EACpC,YAAoB;IAEpB,MAAM,WAAW,GAAG,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC;IAC9C,MAAM,SAAS,GAAG,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC;IAE1C,IACE,OAAO,WAAW,KAAK,QAAQ;QAC/B,OAAO,SAAS,KAAK,QAAQ;QAC7B,CAAC,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC;QAC9B,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC;QAC5B,WAAW,GAAG,CAAC;QACf,SAAS,GAAG,WAAW;QACvB,SAAS,GAAG,YAAY,EACxB,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;AACpC,CAAC"}

package/package.json

@@ -1,9 +1,12 @@
 {
   "name": "@jasonbelmonti/markdown-engine",
-  "version": "0.1.0",
+  "version": "1.0.0",
   "description": "Deterministic Markdown parsing and validation engine package.",
   "license": "MIT",
   "type": "module",
+  "bin": {
+    "markdown-engine": "dist/cli/index.js"
+  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/jasonbelmonti/markdown-engine.git"
@@ -41,8 +44,23 @@
     "prepublishOnly": "npm run release:verify",
     "release:verify": "npm run typecheck && npm test && node scripts/check-boundaries.mjs && npm run build && node scripts/prove-repeatability.mjs --runs 10 && npm run release:check-clean",
     "release:check-clean": "git diff --check HEAD -- && git diff --exit-code HEAD --",
+    "snapshots:update:parser": "npm run build && vitest run tests/parser-fixtures.test.ts -u \"--exclude=.worktrees/**\"",
+    "snapshots:update:rules": "npm run build && vitest run tests/rules.test.ts -u \"--exclude=.worktrees/**\"",
+    "snapshots:update:rich-ir": "npm run build && vitest run tests/rich-ir-targets.test.ts tests/rich-ir-queries.test.ts -u \"--exclude=.worktrees/**\"",
+    "snapshots:update:serialization": "npm run build && vitest run tests/serialization-repeatability.test.ts tests/boundary-inspection.test.ts -u \"--exclude=.worktrees/**\"",
+    "test:rich-ir:proving": "npm run build && vitest run tests/rich-ir-proving.test.ts \"--exclude=.worktrees/**\"",
+    "test:rich-ir:contract": "npm run build && tsc -p tsconfig.document-contract.json && vitest run tests/document-contract.test.ts \"--exclude=.worktrees/**\"",
+    "test:rich-ir:targets": "npm run build && vitest run tests/rich-ir-targets.test.ts \"--exclude=.worktrees/**\"",
+    "test:rich-ir:queries": "npm run build && vitest run tests/rich-ir-queries.test.ts \"--exclude=.worktrees/**\"",
+    "test:rich-ir:annotations": "npm run build && vitest run tests/rich-ir-annotations.test.ts \"--exclude=.worktrees/**\"",
+    "test:rich-ir:compat": "npm run build && vitest run tests/rich-ir-compat.test.ts \"--exclude=.worktrees/**\"",
+    "test:rich-ir:repeatability": "npm run build && vitest run tests/rich-ir-repeatability.test.ts \"--exclude=.worktrees/**\"",
+    "test:rich-ir:downstream": "npm run build && vitest run tests/rich-ir-downstream.test.ts \"--exclude=.worktrees/**\"",
+    "audit:rich-ir-boundary": "node scripts/check-boundaries.mjs",
+    "docs:rich-ir-contract": "node scripts/check-rich-ir-contract-docs.mjs",
     "typecheck": "tsc -p tsconfig.json --noEmit",
-    "test": "npm run build && vitest run \"--exclude=.worktrees/**\""
+    "test": "npm run build && vitest run \"--exclude=.worktrees/**\"",
+    "test:snapshots": "npm run build && vitest run tests/parser-fixtures.test.ts tests/rules.test.ts tests/rich-ir-targets.test.ts tests/rich-ir-queries.test.ts tests/serialization-repeatability.test.ts \"--exclude=.worktrees/**\""
   },
   "engines": {
     "node": "^20.19.0 || >=22.12.0"