@openuji/speculator 0.3.2 → 0.5.0

package/dist/postprocess/plugins/citation-transform.js

@@ -0,0 +1,179 @@
+/**
+ * Citation Transform Plugin
+ *
+ * Scans text nodes for bracket citation patterns and transforms them
+ * into InlineCite nodes.
+ *
+ * Patterns:
+ * - [[FOO]] - basic citation
+ * - [[!FOO]] - forced normative
+ * - [[?FOO]] - forced informative
+ * - [[[FOO]]] - expanded (shows full title)
+ * - [[\FOO]] - escaped (should be skipped)
+ */
+import { normalizeTerm } from '#src/parse/normalize';
+/**
+ * Citation pattern regex.
+ *
+ * Groups:
+ * 1. Expanded marker (third bracket)
+ * 2. Modifier (!, ?, or \)
+ * 3. Citation key
+ */
+const CITATION_PATTERN = /\[\[(\[)?([!?\\])?([^\][]+)\]\](\])?/g;
+function parseCitationMatch(match) {
+    const [raw, openBracket, modifier, key, closeBracket] = match;
+    const expanded = !!openBracket && !!closeBracket;
+    return {
+        key: normalizeTerm(key),
+        forcedNormative: modifier === '!',
+        forcedInformative: modifier === '?',
+        expanded,
+        escaped: modifier === '\\',
+        startIndex: match.index,
+        endIndex: match.index + raw.length,
+        raw,
+    };
+}
+/**
+ * Transform a text node containing citations into an array of nodes.
+ * Returns null if no citations found.
+ */
+function transformTextWithCitations(text) {
+    const value = text.value;
+    CITATION_PATTERN.lastIndex = 0;
+    const citations = [];
+    let match;
+    while ((match = CITATION_PATTERN.exec(value)) !== null) {
+        citations.push(parseCitationMatch(match));
+    }
+    if (citations.length === 0) {
+        return null;
+    }
+    const result = [];
+    let lastIndex = 0;
+    for (const citation of citations) {
+        // Add text before citation
+        if (citation.startIndex > lastIndex) {
+            const before = value.slice(lastIndex, citation.startIndex);
+            if (before) {
+                result.push({ type: 'text', value: before });
+            }
+        }
+        if (citation.escaped) {
+            // Escaped citation: output as text without backslash
+            result.push({ type: 'text', value: `[[${citation.key}]]` });
+        }
+        else {
+            // Create citation node
+            const cite = {
+                type: 'cite',
+                key: citation.key,
+            };
+            if (citation.expanded) {
+                cite.expanded = true;
+            }
+            if (citation.forcedNormative) {
+                cite.forcedNormative = true;
+                cite.kind = 'normative';
+            }
+            if (citation.forcedInformative) {
+                cite.forcedInformative = true;
+                cite.kind = 'informative';
+            }
+            result.push(cite);
+        }
+        lastIndex = citation.endIndex;
+    }
+    // Add text after last citation
+    if (lastIndex < value.length) {
+        result.push({ type: 'text', value: value.slice(lastIndex) });
+    }
+    return result;
+}
+/**
+ * Recursively transform children of inline array
+ */
+function transformInlineChildren(children) {
+    const result = [];
+    for (const child of children) {
+        if (child.type === 'text') {
+            const transformed = transformTextWithCitations(child);
+            if (transformed) {
+                result.push(...transformed);
+            }
+            else {
+                result.push(child);
+            }
+        }
+        else if ('children' in child && Array.isArray(child.children)) {
+            // Recursively process children of container nodes (e.g., emphasis, strong, link)
+            const childWithChildren = child;
+            childWithChildren.children = transformInlineChildren(childWithChildren.children);
+            result.push(child);
+        }
+        else {
+            result.push(child);
+        }
+    }
+    return result;
+}
+/**
+ * Transform block children recursively
+ */
+function transformBlock(block) {
+    if ('children' in block && Array.isArray(block.children)) {
+        if (block.type === 'paragraph' || block.type === 'heading') {
+            // These have Inline[] children
+            const blockWithChildren = block;
+            blockWithChildren.children = transformInlineChildren(blockWithChildren.children);
+        }
+        else {
+            // These have Block[] children (list items, blockquote, etc.)
+            const blockWithChildren = block;
+            for (const child of blockWithChildren.children) {
+                if (typeof child === 'object' && child !== null) {
+                    transformBlock(child);
+                }
+            }
+        }
+    }
+}
+/**
+ * Transform section recursively
+ */
+function transformSection(section) {
+    // Transform heading if present
+    if (section.heading) {
+        section.heading.children = transformInlineChildren(section.heading.children);
+    }
+    // Transform children
+    for (const child of section.children) {
+        if (child.type === 'section') {
+            transformSection(child);
+        }
+        else {
+            transformBlock(child);
+        }
+    }
+}
+/**
+ * Citation transform plugin
+ */
+export const citationTransformPlugin = {
+    name: 'citation-transform',
+    order: { transform: 10 },
+    async transform(ctx) {
+        const document = ctx.document;
+        // Transform all children (sections and blocks)
+        for (const child of document.children) {
+            if (child.type === 'section') {
+                transformSection(child);
+            }
+            else {
+                transformBlock(child);
+            }
+        }
+    },
+};
+//# sourceMappingURL=citation-transform.js.map

package/dist/postprocess/plugins/citation-transform.js.map

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

package/dist/postprocess/plugins/dfn-index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Definition Index Plugin
+ *
+ * Indexes all definitions (dfn) in the document into document.indexes.definitions.
+ *
+ * Process:
+ * 1. Walk AST to collect all InlineDefinition nodes
+ * 2. Generate IDs for definitions without explicit IDs
+ * 3. Build index entries with term, linkTexts, forContexts, dfnType
+ */
+import type { Plugin } from '#src/pipeline/types';
+/**
+ * Definition index plugin
+ */
+export declare const dfnIndexPlugin: Plugin;
+//# sourceMappingURL=dfn-index.d.ts.map

package/dist/postprocess/plugins/dfn-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dfn-index.d.ts","sourceRoot":"","sources":["../../../src/postprocess/plugins/dfn-index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAgB,MAAM,qBAAqB,CAAC;AAqEhE;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAO5B,CAAC"}

package/dist/postprocess/plugins/dfn-index.js

@@ -0,0 +1,76 @@
+/**
+ * Definition Index Plugin
+ *
+ * Indexes all definitions (dfn) in the document into document.indexes.definitions.
+ *
+ * Process:
+ * 1. Walk AST to collect all InlineDefinition nodes
+ * 2. Generate IDs for definitions without explicit IDs
+ * 3. Build index entries with term, linkTexts, forContexts, dfnType
+ */
+import { walkDocument } from '../walk-ast.js';
+/**
+ * Generate a unique ID for a definition if not already set
+ */
+function generateDfnId(term, forContext) {
+    const base = term.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '');
+    if (forContext) {
+        const forPart = forContext.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '');
+        return `dfn-${forPart}-${base}`;
+    }
+    return `dfn-${base}`;
+}
+/**
+ * Build definition index from document into document.indexes
+ */
+function buildDefinitionIndex(document) {
+    // Initialize indexes structure
+    if (!document.indexes) {
+        document.indexes = {};
+    }
+    if (!document.indexes.definitions) {
+        document.indexes.definitions = [];
+    }
+    const definitionIndex = document.indexes.definitions;
+    walkDocument(document, {
+        visitInline: (inline) => {
+            if (inline.type === 'definition') {
+                const dfn = inline;
+                // Generate ID if not present
+                const forContext = dfn.forContexts?.[0] ?? null;
+                const id = dfn.explicitId || dfn.id || generateDfnId(dfn.term, forContext);
+                // Assign ID back to the node (mutation for index building)
+                dfn.id = id;
+                // Create index entry
+                const entry = {
+                    id,
+                    term: dfn.term,
+                    linkTexts: dfn.linkTexts,
+                    forContexts: dfn.forContexts,
+                    dfnType: dfn.dfnType,
+                    sourcePos: dfn.sourcePos || {
+                        file: document.sourcePos?.file || 'unknown',
+                        line: 0,
+                        column: 0
+                    }
+                };
+                // Ensure entry.sourcePos.file is set if sourcePos exists but file is missing
+                if (entry.sourcePos && !entry.sourcePos.file) {
+                    entry.sourcePos.file = document.sourcePos?.file || 'unknown';
+                }
+                definitionIndex.push(entry);
+            }
+        }
+    });
+}
+/**
+ * Definition index plugin
+ */
+export const dfnIndexPlugin = {
+    name: 'dfn-index',
+    order: { index: 10 },
+    async index(ctx) {
+        buildDefinitionIndex(ctx.document);
+    },
+};
+//# sourceMappingURL=dfn-index.js.map

package/dist/postprocess/plugins/dfn-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dfn-index.js","sourceRoot":"","sources":["../../../src/postprocess/plugins/dfn-index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;GAEG;AACH,SAAS,aAAa,CAAC,IAAY,EAAE,UAAyB;IAC1D,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAClF,IAAI,UAAU,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC3F,OAAO,OAAO,OAAO,IAAI,IAAI,EAAE,CAAC;IACpC,CAAC;IACD,OAAO,OAAO,IAAI,EAAE,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,SAAS,oBAAoB,CAAC,QAAkB;IAC5C,+BAA+B;IAC/B,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QACpB,QAAQ,CAAC,OAAO,GAAG,EAAE,CAAC;IAC1B,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QAChC,QAAQ,CAAC,OAAO,CAAC,WAAW,GAAG,EAAE,CAAC;IACtC,CAAC;IACD,MAAM,eAAe,GAAG,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC;IAErD,YAAY,CAAC,QAAQ,EAAE;QACnB,WAAW,EAAE,CAAC,MAAM,EAAE,EAAE;YACpB,IAAI,MAAM,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBAC/B,MAAM,GAAG,GAAG,MAA0B,CAAC;gBAEvC,6BAA6B;gBAC7B,MAAM,UAAU,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;gBAChD,MAAM,EAAE,GAAG,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,EAAE,IAAI,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;gBAE3E,2DAA2D;gBAC3D,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC;gBAEZ,qBAAqB;gBACrB,MAAM,KAAK,GAAyB;oBAChC,EAAE;oBACF,IAAI,EAAE,GAAG,CAAC,IAAI;oBACd,SAAS,EAAE,GAAG,CAAC,SAAS;oBACxB,WAAW,EAAE,GAAG,CAAC,WAAW;oBAC5B,OAAO,EAAE,GAAG,CAAC,OAAO;oBACpB,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI;wBACxB,IAAI,EAAE,QAAQ,CAAC,SAAS,EAAE,IAAI,IAAI,SAAS;wBAC3C,IAAI,EAAE,CAAC;wBACP,MAAM,EAAE,CAAC;qBACZ;iBACJ,CAAC;gBAGF,6EAA6E;gBAC7E,IAAI,KAAK,CAAC,SAAS,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;oBAC3C,KAAK,CAAC,SAAS,CAAC,IAAI,GAAG,QAAQ,CAAC,SAAS,EAAE,IAAI,IAAI,SAAS,CAAC;gBACjE,CAAC;gBAGD,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAChC,CAAC;QACL,CAAC;KACJ,CAAC,CAAC;AACP,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAW;IAClC,IAAI,EAAE,WAAW;IACjB,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;IAEpB,KAAK,CAAC,KAAK,CAAC,GAAiB;QACzB,oBAAoB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC;CACJ,CAAC"}

package/dist/postprocess/plugins/reference-resolve.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Reference Resolve Plugin
+ *
+ * Resolves cross-references (xref) to their target definitions (dfn).
+ *
+ * Process:
+ * 1. Build lookup map from document.indexes.definitions
+ * 2. Walk AST to find all InlineReference nodes
+ * 3. Match references to definitions using term/candidateTerms + forContext
+ * 4. Assign targetId to resolved references
+ *
+ * Note: Requires dfn-index plugin to run first to populate document.indexes.definitions
+ */
+import type { Plugin } from '#src/pipeline/types';
+/**
+ * Reference resolve plugin
+ */
+export declare const referenceResolvePlugin: Plugin;
+//# sourceMappingURL=reference-resolve.d.ts.map

package/dist/postprocess/plugins/reference-resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-resolve.d.ts","sourceRoot":"","sources":["../../../src/postprocess/plugins/reference-resolve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAkB,MAAM,qBAAqB,CAAC;AAuFlE;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,MA2BpC,CAAC"}

package/dist/postprocess/plugins/reference-resolve.js

@@ -0,0 +1,103 @@
+/**
+ * Reference Resolve Plugin
+ *
+ * Resolves cross-references (xref) to their target definitions (dfn).
+ *
+ * Process:
+ * 1. Build lookup map from document.indexes.definitions
+ * 2. Walk AST to find all InlineReference nodes
+ * 3. Match references to definitions using term/candidateTerms + forContext
+ * 4. Assign targetId to resolved references
+ *
+ * Note: Requires dfn-index plugin to run first to populate document.indexes.definitions
+ */
+import { normalizeTerm } from '#src/parse/normalize';
+import { walkDocument } from '../walk-ast.js';
+/**
+ * Build lookup map from definition index
+ */
+function buildLookupMap(document) {
+    const map = new Map();
+    const definitions = document.indexes?.definitions || [];
+    for (const entry of definitions) {
+        const linkTexts = entry.linkTexts || [entry.term];
+        // Index by all link texts
+        for (const text of linkTexts) {
+            const key = normalizeTerm(text);
+            const existing = map.get(key) || [];
+            existing.push(entry);
+            map.set(key, existing);
+        }
+        // Also index by the primary term if different
+        const termKey = normalizeTerm(entry.term);
+        if (!linkTexts.some(lt => normalizeTerm(lt) === termKey)) {
+            const existing = map.get(termKey) || [];
+            existing.push(entry);
+            map.set(termKey, existing);
+        }
+    }
+    return map;
+}
+/**
+ * Resolve a reference to a definition
+ */
+function resolveReference(ref, index) {
+    const candidateTerms = ref.candidateTerms || [ref.targetTerm];
+    const forContexts = ref.forContexts || [null];
+    const preferredType = ref.preferredType;
+    // Try each candidate term
+    for (const term of candidateTerms) {
+        const key = normalizeTerm(term);
+        const entries = index.get(key);
+        if (!entries || entries.length === 0)
+            continue;
+        // Filter by forContext if specified
+        let matches = entries;
+        // If reference has a forContext, prefer definitions with that forContext
+        const refForContext = forContexts.find((fc) => fc !== null);
+        if (refForContext) {
+            const exactMatches = matches.filter(e => (e.forContexts || [null]).some(fc => fc && normalizeTerm(fc) === normalizeTerm(refForContext)));
+            if (exactMatches.length > 0) {
+                matches = exactMatches;
+            }
+        }
+        // Filter by preferred type if specified
+        if (preferredType && matches.length > 1) {
+            const typeMatches = matches.filter(e => e.dfnType === preferredType);
+            if (typeMatches.length > 0) {
+                matches = typeMatches;
+            }
+        }
+        // Return first match
+        if (matches.length > 0) {
+            return matches[0];
+        }
+    }
+    return null;
+}
+/**
+ * Reference resolve plugin
+ */
+export const referenceResolvePlugin = {
+    name: 'reference-resolve',
+    order: { resolve: 10 },
+    async resolve(ctx) {
+        // Use global index if in a workspace, otherwise build local lookup map
+        const index = ctx.workspace
+            ? ctx.workspace.globalIndex.definitions
+            : buildLookupMap(ctx.document);
+        walkDocument(ctx.document, {
+            visitInline: (inline) => {
+                if (inline.type === 'reference') {
+                    const ref = inline;
+                    const match = resolveReference(ref, index);
+                    if (match) {
+                        // Assign the resolved target ID (mutation for resolution)
+                        ref.targetId = match.id;
+                    }
+                }
+            }
+        });
+    },
+};
+//# sourceMappingURL=reference-resolve.js.map

package/dist/postprocess/plugins/reference-resolve.js.map

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

package/dist/postprocess/plugins/section-id.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Section ID Plugin
+ *
+ * Ensures all sections have unique, slug-based IDs.
+ *
+ * Process:
+ * 1. Walk AST to find all Section nodes
+ * 2. For sections without IDs or with non-slug IDs, generate from heading text
+ * 3. Ensure uniqueness by tracking used IDs and appending numbers (-2, -3, etc.)
+ */
+import type { Plugin } from '#src/pipeline/types';
+/**
+ * Section ID plugin
+ */
+export declare const sectionIdPlugin: Plugin;
+//# sourceMappingURL=section-id.d.ts.map

package/dist/postprocess/plugins/section-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"section-id.d.ts","sourceRoot":"","sources":["../../../src/postprocess/plugins/section-id.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAgB,MAAM,qBAAqB,CAAC;AA8GhE;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,MAO7B,CAAC"}

package/dist/postprocess/plugins/section-id.js

@@ -0,0 +1,116 @@
+/**
+ * Section ID Plugin
+ *
+ * Ensures all sections have unique, slug-based IDs.
+ *
+ * Process:
+ * 1. Walk AST to find all Section nodes
+ * 2. For sections without IDs or with non-slug IDs, generate from heading text
+ * 3. Ensure uniqueness by tracking used IDs and appending numbers (-2, -3, etc.)
+ */
+import { walkDocument } from '../walk-ast.js';
+/**
+ * Extract plain text from heading inline nodes
+ */
+function extractHeadingText(heading) {
+    function extractFromInlines(inlines) {
+        return inlines
+            .map(inline => {
+            switch (inline.type) {
+                case 'text':
+                    return inline.value;
+                case 'emphasis':
+                case 'strong':
+                case 'link':
+                    return extractFromInlines(inline.children);
+                case 'inlineCode':
+                    return inline.value;
+                case 'definition':
+                    return inline.term;
+                case 'reference':
+                    return inline.targetTerm;
+                case 'issue':
+                    return extractFromInlines(inline.children);
+                case 'cite':
+                    return inline.children ? extractFromInlines(inline.children) : inline.key;
+                default:
+                    return '';
+            }
+        })
+            .join('');
+    }
+    return extractFromInlines(heading.children);
+}
+/**
+ * Convert text to URL-safe slug
+ */
+function slugify(text) {
+    return text
+        .toLowerCase()
+        .trim()
+        // Replace spaces and underscores with hyphens
+        .replace(/[\s_]+/g, '-')
+        // Remove non-alphanumeric characters except hyphens
+        .replace(/[^a-z0-9-]+/g, '')
+        // Remove leading/trailing hyphens
+        .replace(/^-+|-+$/g, '')
+        // Collapse multiple hyphens
+        .replace(/-+/g, '-');
+}
+/**
+ * Check if a string looks like a slug (lowercase alphanumeric with hyphens)
+ */
+function isSlugLike(id) {
+    return /^[a-z0-9]+(-[a-z0-9]+)*$/.test(id);
+}
+/**
+ * Ensure all sections have unique, slug-based IDs
+ */
+function ensureSectionIds(document) {
+    const usedIds = new Set();
+    /**
+     * Generate a unique ID from base slug
+     */
+    function makeUniqueId(baseSlug) {
+        if (!baseSlug) {
+            baseSlug = 'section';
+        }
+        let id = baseSlug;
+        let counter = 2;
+        while (usedIds.has(id)) {
+            id = `${baseSlug}-${counter}`;
+            counter++;
+        }
+        usedIds.add(id);
+        return id;
+    }
+    walkDocument(document, {
+        visitSection: (section) => {
+            // Check if section needs an ID
+            const needsId = !section.id || !isSlugLike(section.id);
+            if (needsId && section.heading) {
+                // Generate ID from heading text
+                const headingText = extractHeadingText(section.heading);
+                const baseSlug = slugify(headingText);
+                const uniqueId = makeUniqueId(baseSlug);
+                // Assign the ID to the section
+                section.id = uniqueId;
+            }
+            else if (section.id) {
+                // Track existing ID to avoid duplicates
+                usedIds.add(section.id);
+            }
+        }
+    });
+}
+/**
+ * Section ID plugin
+ */
+export const sectionIdPlugin = {
+    name: 'section-id',
+    order: { index: 5 },
+    async index(ctx) {
+        ensureSectionIds(ctx.document);
+    },
+};
+//# sourceMappingURL=section-id.js.map

package/dist/postprocess/plugins/section-id.js.map

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

package/dist/postprocess/plugins/toc.d.ts

@@ -0,0 +1,19 @@
+/**
+ * TOC (Table of Contents) Plugin
+ *
+ * Generates a hierarchical table of contents from document sections.
+ * Runs during the compute phase to populate document.computed.toc
+ * and document.computed.headingNumbers.
+ *
+ * Process:
+ * 1. Walk AST to find all Section nodes with headings
+ * 2. Build hierarchical TOC entries with depth and text
+ * 3. Generate hierarchical heading numbers (1, 1.1, 1.2, 2, etc.)
+ * 4. Populate computed fields on the document
+ */
+import type { Plugin } from '#src/pipeline/types';
+/**
+ * TOC plugin
+ */
+export declare const tocPlugin: Plugin;
+//# sourceMappingURL=toc.d.ts.map

package/dist/postprocess/plugins/toc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toc.d.ts","sourceRoot":"","sources":["../../../src/postprocess/plugins/toc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAkB,MAAM,qBAAqB,CAAC;AAoIlE;;GAEG;AACH,eAAO,MAAM,SAAS,EAAE,MAOvB,CAAC"}