@openuji/speculator 0.4.0 → 0.5.0

package/dist/index.d.ts

@@ -8,7 +8,7 @@ export type { FileProvider } from './file-provider/types.js';
 export * from './types/ast.generated.js';
 export { speculate, SpeculatorPipeline, PHASES, POSTPROCESS_PHASES } from './pipeline/index.js';
 export type { Plugin, Phase, PostprocessPhase, SpeculateOptions, SpeculateResult } from './pipeline/types.js';
-export { citationTransformPlugin, dfnIndexPlugin, referenceResolvePlugin, corePlugins, } from './postprocess/index.js';
+export { citationTransformPlugin, dfnIndexPlugin, referenceResolvePlugin, tocPlugin, corePlugins, } from './postprocess/index.js';
 export { coreHtmlParsers, coreMarkdownParsers, } from './parse/parsers.js';
 export { sortEntriesByDeps } from './workspace/index.js';
 export type { EntryWithConfig, SortResult } from './workspace/index.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAE1C,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC1E,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,YAAY,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,cAAc,0BAA0B,CAAC;AAGzC,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAChG,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAG9G,OAAO,EACH,uBAAuB,EACvB,cAAc,EACd,sBAAsB,EACtB,WAAW,GACd,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACH,eAAe,EACf,mBAAmB,GACtB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAE1C,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC1E,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,YAAY,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,cAAc,0BAA0B,CAAC;AAGzC,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAChG,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAG9G,OAAO,EACH,uBAAuB,EACvB,cAAc,EACd,sBAAsB,EACtB,SAAS,EACT,WAAW,GACd,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACH,eAAe,EACf,mBAAmB,GACtB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -8,7 +8,7 @@ export * from './types/ast.generated.js';
 // Pipeline (Single Entrypoint)
 export { speculate, SpeculatorPipeline, PHASES, POSTPROCESS_PHASES } from './pipeline/index.js';
 // Postprocess Plugins
-export { citationTransformPlugin, dfnIndexPlugin, referenceResolvePlugin, corePlugins, } from './postprocess/index.js';
+export { citationTransformPlugin, dfnIndexPlugin, referenceResolvePlugin, tocPlugin, corePlugins, } from './postprocess/index.js';
 // Parser Modules (for advanced use)
 export { coreHtmlParsers, coreMarkdownParsers, } from './parse/parsers.js';
 // Workspace Utilities

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAK1C,iBAAiB;AACjB,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAG/D,YAAY;AACZ,cAAc,0BAA0B,CAAC;AAEzC,+BAA+B;AAC/B,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAGhG,sBAAsB;AACtB,OAAO,EACH,uBAAuB,EACvB,cAAc,EACd,sBAAsB,EACtB,WAAW,GACd,MAAM,wBAAwB,CAAC;AAEhC,oCAAoC;AACpC,OAAO,EACH,eAAe,EACf,mBAAmB,GACtB,MAAM,oBAAoB,CAAC;AAE5B,sBAAsB;AACtB,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAK1C,iBAAiB;AACjB,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAG/D,YAAY;AACZ,cAAc,0BAA0B,CAAC;AAEzC,+BAA+B;AAC/B,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAGhG,sBAAsB;AACtB,OAAO,EACH,uBAAuB,EACvB,cAAc,EACd,sBAAsB,EACtB,SAAS,EACT,WAAW,GACd,MAAM,wBAAwB,CAAC;AAEhC,oCAAoC;AACpC,OAAO,EACH,eAAe,EACf,mBAAmB,GACtB,MAAM,oBAAoB,CAAC;AAE5B,sBAAsB;AACtB,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/postprocess/__tests__/toc.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * TOC Plugin Tests
+ */
+export {};
+//# sourceMappingURL=toc.test.d.ts.map

package/dist/postprocess/__tests__/toc.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toc.test.d.ts","sourceRoot":"","sources":["../../../src/postprocess/__tests__/toc.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/postprocess/__tests__/toc.test.js

@@ -0,0 +1,257 @@
+/**
+ * TOC Plugin Tests
+ */
+import { describe, it, expect } from 'vitest';
+import { tocPlugin } from '#src/postprocess/plugins/toc';
+function createSectionWithHeading(headingText, depth, explicitId) {
+    const section = {
+        type: 'section',
+        heading: {
+            type: 'heading',
+            depth,
+            children: [{ type: 'text', value: headingText }],
+        },
+        children: [],
+    };
+    if (explicitId) {
+        section.id = explicitId;
+    }
+    return section;
+}
+function createDocWithSections(sections) {
+    return {
+        type: 'document',
+        children: sections,
+    };
+}
+describe('TocPlugin', () => {
+    it('generates TOC from sections with headings', async () => {
+        const section1 = createSectionWithHeading('Introduction', 1, 'intro');
+        const section2 = createSectionWithHeading('Methods', 1, 'methods');
+        const doc = createDocWithSections([section1, section2]);
+        await tocPlugin.compute({ document: doc, level: 0 });
+        expect(doc.computed?.toc).toBeDefined();
+        expect(doc.computed.toc).toHaveLength(2);
+        expect(doc.computed.toc[0]).toMatchObject({
+            id: 'intro',
+            depth: 1,
+            text: 'Introduction',
+            number: '1',
+        });
+        expect(doc.computed.toc[1]).toMatchObject({
+            id: 'methods',
+            depth: 1,
+            text: 'Methods',
+            number: '2',
+        });
+    });
+    it('handles nested sections correctly', async () => {
+        const childSection = createSectionWithHeading('Sub Topic', 2, 'sub-topic');
+        const parentSection = createSectionWithHeading('Main Topic', 1, 'main-topic');
+        parentSection.children = [childSection];
+        const doc = createDocWithSections([parentSection]);
+        await tocPlugin.compute({ document: doc, level: 0 });
+        expect(doc.computed?.toc).toBeDefined();
+        expect(doc.computed.toc).toHaveLength(1);
+        expect(doc.computed.toc[0]).toMatchObject({
+            id: 'main-topic',
+            depth: 1,
+            text: 'Main Topic',
+            number: '1',
+        });
+        expect(doc.computed.toc[0].children).toHaveLength(1);
+        expect(doc.computed.toc[0].children[0]).toMatchObject({
+            id: 'sub-topic',
+            depth: 2,
+            text: 'Sub Topic',
+            number: '1.1',
+        });
+    });
+    it('generates correct heading numbers for multiple levels', async () => {
+        const child1 = createSectionWithHeading('First Child', 2, 'child-1');
+        const child2 = createSectionWithHeading('Second Child', 2, 'child-2');
+        const parent1 = createSectionWithHeading('First Parent', 1, 'parent-1');
+        parent1.children = [child1, child2];
+        const parent2 = createSectionWithHeading('Second Parent', 1, 'parent-2');
+        const child3 = createSectionWithHeading('Third Child', 2, 'child-3');
+        parent2.children = [child3];
+        const doc = createDocWithSections([parent1, parent2]);
+        await tocPlugin.compute({ document: doc, level: 0 });
+        expect(doc.computed?.headingNumbers).toEqual({
+            'parent-1': '1',
+            'child-1': '1.1',
+            'child-2': '1.2',
+            'parent-2': '2',
+            'child-3': '2.1',
+        });
+    });
+    it('empty document produces empty TOC', async () => {
+        const doc = {
+            type: 'document',
+            children: [],
+        };
+        await tocPlugin.compute({ document: doc, level: 0 });
+        expect(doc.computed?.toc).toEqual([]);
+    });
+    it('skips sections without headings', async () => {
+        const sectionWithHeading = createSectionWithHeading('Has Heading', 1, 'has-heading');
+        const sectionWithoutHeading = {
+            type: 'section',
+            children: [],
+        };
+        const doc = createDocWithSections([sectionWithHeading, sectionWithoutHeading]);
+        await tocPlugin.compute({ document: doc, level: 0 });
+        expect(doc.computed?.toc).toHaveLength(1);
+        expect(doc.computed.toc[0].text).toBe('Has Heading');
+    });
+    it('handles heading with inline code', async () => {
+        const section = {
+            type: 'section',
+            id: 'getelementbyid',
+            heading: {
+                type: 'heading',
+                depth: 1,
+                children: [
+                    { type: 'text', value: 'Using ' },
+                    { type: 'inlineCode', value: 'getElementById' },
+                    { type: 'text', value: ' method' },
+                ],
+            },
+            children: [],
+        };
+        const doc = createDocWithSections([section]);
+        await tocPlugin.compute({ document: doc, level: 0 });
+        expect(doc.computed.toc[0].text).toBe('Using getElementById method');
+    });
+    it('handles heading with emphasis and strong', async () => {
+        const section = {
+            type: 'section',
+            id: 'important-notes',
+            heading: {
+                type: 'heading',
+                depth: 1,
+                children: [
+                    { type: 'emphasis', children: [{ type: 'text', value: 'Important' }] },
+                    { type: 'text', value: ' ' },
+                    { type: 'strong', children: [{ type: 'text', value: 'Notes' }] },
+                ],
+            },
+            children: [],
+        };
+        const doc = createDocWithSections([section]);
+        await tocPlugin.compute({ document: doc, level: 0 });
+        expect(doc.computed.toc[0].text).toBe('Important Notes');
+    });
+    it('handles heading with link', async () => {
+        const section = {
+            type: 'section',
+            id: 'see-docs',
+            heading: {
+                type: 'heading',
+                depth: 1,
+                children: [
+                    { type: 'text', value: 'See ' },
+                    {
+                        type: 'link',
+                        url: 'https://example.com',
+                        children: [{ type: 'text', value: 'Documentation' }]
+                    },
+                ],
+            },
+            children: [],
+        };
+        const doc = createDocWithSections([section]);
+        await tocPlugin.compute({ document: doc, level: 0 });
+        expect(doc.computed.toc[0].text).toBe('See Documentation');
+    });
+    it('handles deeply nested sections (3+ levels)', async () => {
+        const level3 = createSectionWithHeading('Level 3', 3, 'level-3');
+        const level2 = createSectionWithHeading('Level 2', 2, 'level-2');
+        level2.children = [level3];
+        const level1 = createSectionWithHeading('Level 1', 1, 'level-1');
+        level1.children = [level2];
+        const doc = createDocWithSections([level1]);
+        await tocPlugin.compute({ document: doc, level: 0 });
+        expect(doc.computed?.headingNumbers).toEqual({
+            'level-1': '1',
+            'level-2': '1.1',
+            'level-3': '1.1.1',
+        });
+        const tocLevel1 = doc.computed.toc[0];
+        const tocLevel2 = tocLevel1.children[0];
+        const tocLevel3 = tocLevel2.children[0];
+        expect(tocLevel3.number).toBe('1.1.1');
+    });
+    it('handles sections without IDs (no heading number stored)', async () => {
+        const section = createSectionWithHeading('No ID Section', 1);
+        // No ID assigned
+        const doc = createDocWithSections([section]);
+        await tocPlugin.compute({ document: doc, level: 0 });
+        expect(doc.computed?.toc).toHaveLength(1);
+        expect(doc.computed.toc[0]).toMatchObject({
+            depth: 1,
+            text: 'No ID Section',
+            number: '1',
+        });
+        expect(doc.computed.toc[0].id).toBeUndefined();
+        // headingNumbers should be empty or not contain this section
+        expect(doc.computed?.headingNumbers).toBeUndefined();
+    });
+    it('preserves existing computed fields', async () => {
+        const section = createSectionWithHeading('Test', 1, 'test');
+        const doc = createDocWithSections([section]);
+        doc.computed = {
+            wordCount: 100,
+            readingTime: 5,
+        };
+        await tocPlugin.compute({ document: doc, level: 0 });
+        expect(doc.computed.wordCount).toBe(100);
+        expect(doc.computed.readingTime).toBe(5);
+        expect(doc.computed.toc).toBeDefined();
+    });
+    it('handles heading with definition', async () => {
+        const section = {
+            type: 'section',
+            id: 'about-loop',
+            heading: {
+                type: 'heading',
+                depth: 1,
+                children: [
+                    { type: 'text', value: 'About ' },
+                    {
+                        type: 'definition',
+                        term: 'event loop',
+                        children: [{ type: 'text', value: 'Event Loop' }]
+                    },
+                ],
+            },
+            children: [],
+        };
+        const doc = createDocWithSections([section]);
+        await tocPlugin.compute({ document: doc, level: 0 });
+        expect(doc.computed.toc[0].text).toBe('About event loop');
+    });
+    it('handles heading with reference', async () => {
+        const section = {
+            type: 'section',
+            id: 'understanding',
+            heading: {
+                type: 'heading',
+                depth: 1,
+                children: [
+                    { type: 'text', value: 'Understanding ' },
+                    {
+                        type: 'reference',
+                        targetTerm: 'task queue',
+                        children: [{ type: 'text', value: 'Task Queue' }]
+                    },
+                ],
+            },
+            children: [],
+        };
+        const doc = createDocWithSections([section]);
+        await tocPlugin.compute({ document: doc, level: 0 });
+        expect(doc.computed.toc[0].text).toBe('Understanding task queue');
+    });
+});
+//# sourceMappingURL=toc.test.js.map

package/dist/postprocess/__tests__/toc.test.js.map

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

package/dist/postprocess/index.d.ts

@@ -10,6 +10,7 @@ export { citationTransformPlugin } from './plugins/citation-transform.js';
 export { sectionIdPlugin } from './plugins/section-id.js';
 export { dfnIndexPlugin } from './plugins/dfn-index.js';
 export { referenceResolvePlugin } from './plugins/reference-resolve.js';
+export { tocPlugin } from './plugins/toc.js';
 export { walkDocument, type AstVisitor } from './walk-ast.js';
 export declare const corePlugins: import("../index.js").Plugin[];
 //# sourceMappingURL=index.d.ts.map

package/dist/postprocess/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/postprocess/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAG1E,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAGxE,OAAO,EAAE,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAY9D,eAAO,MAAM,WAAW,gCAQvB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/postprocess/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAG1E,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAGxE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAG7C,OAAO,EAAE,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAa9D,eAAO,MAAM,WAAW,gCAUvB,CAAC"}

package/dist/postprocess/index.js

@@ -13,6 +13,8 @@ export { sectionIdPlugin } from './plugins/section-id.js';
 export { dfnIndexPlugin } from './plugins/dfn-index.js';
 // Resolve plugins
 export { referenceResolvePlugin } from './plugins/reference-resolve.js';
+// Compute plugins
+export { tocPlugin } from './plugins/toc.js';
 // Utilities
 export { walkDocument } from './walk-ast.js';
 /**
@@ -24,6 +26,7 @@ import { citationTransformPlugin } from './plugins/citation-transform.js';
 import { sectionIdPlugin } from './plugins/section-id.js';
 import { dfnIndexPlugin } from './plugins/dfn-index.js';
 import { referenceResolvePlugin } from './plugins/reference-resolve.js';
+import { tocPlugin } from './plugins/toc.js';
 export const corePlugins = [
     // Transform plugins
     citationTransformPlugin, // order: { transform: 10 }
@@ -32,5 +35,7 @@ export const corePlugins = [
     dfnIndexPlugin, // order: { index: 10 }
     // Resolve plugins
     referenceResolvePlugin, // order: { resolve: 10 }
+    // Compute plugins
+    tocPlugin, // order: { compute: 10 }
 ];
 //# sourceMappingURL=index.js.map

package/dist/postprocess/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/postprocess/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,oBAAoB;AACpB,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAE1E,gBAAgB;AAChB,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,kBAAkB;AAClB,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAExE,YAAY;AACZ,OAAO,EAAE,YAAY,EAAmB,MAAM,eAAe,CAAC;AAE9D;;;;GAIG;AACH,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAExE,MAAM,CAAC,MAAM,WAAW,GAAG;IACvB,oBAAoB;IACpB,uBAAuB,EAAK,2BAA2B;IACvD,gBAAgB;IAChB,eAAe,EAAa,sBAAsB;IAClD,cAAc,EAAc,uBAAuB;IACnD,kBAAkB;IAClB,sBAAsB,EAAM,yBAAyB;CACxD,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/postprocess/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,oBAAoB;AACpB,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAE1E,gBAAgB;AAChB,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,kBAAkB;AAClB,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAExE,kBAAkB;AAClB,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,YAAY;AACZ,OAAO,EAAE,YAAY,EAAmB,MAAM,eAAe,CAAC;AAE9D;;;;GAIG;AACH,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,MAAM,CAAC,MAAM,WAAW,GAAG;IACvB,oBAAoB;IACpB,uBAAuB,EAAK,2BAA2B;IACvD,gBAAgB;IAChB,eAAe,EAAa,sBAAsB;IAClD,cAAc,EAAc,uBAAuB;IACnD,kBAAkB;IAClB,sBAAsB,EAAM,yBAAyB;IACrD,kBAAkB;IAClB,SAAS,EAAmB,yBAAyB;CACxD,CAAC"}

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"}

package/dist/postprocess/plugins/toc.js

@@ -0,0 +1,125 @@
+/**
+ * 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
+ */
+/**
+ * Extract plain text from heading inline nodes
+ * Reused pattern from section-id.ts
+ */
+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);
+}
+/**
+ * Build TOC entries recursively from sections
+ */
+function buildTocFromSections(children, counters, headingNumbers) {
+    const entries = [];
+    for (const child of children) {
+        if (child.type !== 'section')
+            continue;
+        const section = child;
+        // Skip sections without headings
+        if (!section.heading)
+            continue;
+        const depth = section.heading.depth;
+        const text = extractHeadingText(section.heading);
+        // Adjust counters array to match current depth
+        // depth 1 = index 0, depth 2 = index 1, etc.
+        const depthIndex = depth - 1;
+        // Ensure counters array is long enough
+        while (counters.length <= depthIndex) {
+            counters.push(0);
+        }
+        // Increment counter at current depth
+        counters[depthIndex]++;
+        // Reset all deeper counters
+        for (let i = depthIndex + 1; i < counters.length; i++) {
+            counters[i] = 0;
+        }
+        // Build number string from counters (only up to current depth)
+        const numberParts = counters.slice(0, depthIndex + 1).filter(n => n > 0);
+        const number = numberParts.join('.');
+        // Store heading number if section has an ID
+        if (section.id && number) {
+            headingNumbers.set(section.id, number);
+        }
+        // Recursively process nested sections
+        const nestedChildren = buildTocFromSections(section.children, [...counters], // Pass a copy to avoid mutation issues
+        headingNumbers);
+        const entry = {
+            id: section.id,
+            depth,
+            text,
+            number,
+        };
+        if (nestedChildren.length > 0) {
+            entry.children = nestedChildren;
+        }
+        entries.push(entry);
+    }
+    return entries;
+}
+/**
+ * Generate TOC and heading numbers for a document
+ */
+function generateToc(document) {
+    const headingNumbers = new Map();
+    const counters = [];
+    const toc = buildTocFromSections(document.children, counters, headingNumbers);
+    // Initialize computed fields if not present
+    if (!document.computed) {
+        document.computed = {};
+    }
+    // Set TOC
+    document.computed.toc = toc;
+    // Convert Map to plain object for headingNumbers
+    if (headingNumbers.size > 0) {
+        document.computed.headingNumbers = Object.fromEntries(headingNumbers);
+    }
+}
+/**
+ * TOC plugin
+ */
+export const tocPlugin = {
+    name: 'toc',
+    order: { compute: 10 },
+    async compute(ctx) {
+        generateToc(ctx.document);
+    },
+};
+//# sourceMappingURL=toc.js.map

package/dist/postprocess/plugins/toc.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openuji/speculator",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "AST-first specification processor with schema-central architecture",
   "type": "module",
   "main": "dist/index.js",