@openuji/speculator 0.3.1 → 0.4.0

package/dist/parse/__tests__/pipeline.test.js

@@ -0,0 +1,215 @@
+/**
+ * Parse Pipeline Integration Tests
+ */
+import { describe, it, expect } from 'vitest';
+import { parse, parseCompositeSource } from '#src/parse/pipeline';
+function createPreprocessedSpec(units, config = {}) {
+    return {
+        config,
+        source: {
+            entryFile: units[0]?.file ?? '/spec/format.md',
+            entryFormat: units[0]?.format ?? 'markdown',
+            units,
+            includeGraph: new Map(),
+        },
+    };
+}
+describe('parse', () => {
+    describe('markdown parsing', () => {
+        it('parses simple markdown document', () => {
+            const spec = createPreprocessedSpec([{
+                    file: '/spec/format.md',
+                    format: 'markdown',
+                    content: '# Title\n\nParagraph text.',
+                    startLine: 1,
+                }]);
+            const result = parse(spec);
+            expect(result.hasErrors).toBe(false);
+            expect(result.result?.document.type).toBe('document');
+            expect(result.result?.document.children).toHaveLength(1);
+        });
+        it('creates section hierarchy from headings', () => {
+            const spec = createPreprocessedSpec([{
+                    file: '/spec/format.md',
+                    format: 'markdown',
+                    content: '# Title\n## Section\nContent',
+                    startLine: 1,
+                }]);
+            const result = parse(spec);
+            expect(result.hasErrors).toBe(false);
+            const rootSection = result.result?.document.children[0];
+            expect(rootSection.type).toBe('section');
+            expect(rootSection.heading?.depth).toBe(1);
+            expect(rootSection.children.some((c) => c.type === 'section')).toBe(true);
+        });
+    });
+    describe('HTML parsing', () => {
+        it('parses HTML with sections', () => {
+            const spec = createPreprocessedSpec([{
+                    file: '/spec/format.html',
+                    format: 'html',
+                    content: '<section id="abstract"><h2>Abstract</h2><p>Summary</p></section>',
+                    startLine: 1,
+                }]);
+            const result = parse(spec);
+            expect(result.hasErrors).toBe(false);
+            const section = result.result?.document.children[0];
+            expect(section.type).toBe('section');
+            expect(section.id).toBe('abstract');
+        });
+    });
+    describe('mixed units', () => {
+        it('parses markdown and HTML units together', () => {
+            const spec = createPreprocessedSpec([
+                {
+                    file: '/spec/format.html',
+                    format: 'html',
+                    content: '<section id="abstract"><h2>Abstract</h2><p>Summary</p></section>',
+                    startLine: 1,
+                },
+                {
+                    file: '/spec/intro.md',
+                    format: 'markdown',
+                    content: '## Introduction\n\nIntro text.',
+                    startLine: 1,
+                },
+            ]);
+            const result = parse(spec);
+            expect(result.hasErrors).toBe(false);
+            expect(result.result?.document.children.length).toBeGreaterThanOrEqual(1);
+        });
+        it('preserves sourcePos.file per unit', () => {
+            const spec = createPreprocessedSpec([
+                {
+                    file: '/spec/format.md',
+                    format: 'markdown',
+                    content: '# Title',
+                    startLine: 1,
+                },
+                {
+                    file: '/spec/intro.md',
+                    format: 'markdown',
+                    content: '## Intro',
+                    startLine: 1,
+                },
+            ]);
+            const result = parse(spec);
+            expect(result.hasErrors).toBe(false);
+            // Find sections and check their sourcePos
+            function collectSourceFiles(node) {
+                if (typeof node !== 'object' || node === null)
+                    return [];
+                const files = [];
+                if ('sourcePos' in node && typeof node.sourcePos === 'object' && node.sourcePos !== null && 'file' in node.sourcePos) {
+                    if (typeof node.sourcePos.file === 'string')
+                        files.push(node.sourcePos.file);
+                }
+                if ('children' in node && Array.isArray(node.children)) {
+                    for (const child of node.children) {
+                        files.push(...collectSourceFiles(child));
+                    }
+                }
+                if ('heading' in node && typeof node.heading === 'object' && node.heading !== null) {
+                    if ('sourcePos' in node.heading && typeof node.heading.sourcePos === 'object' && node.heading.sourcePos !== null && 'file' in node.heading.sourcePos) {
+                        if (typeof node.heading.sourcePos.file === 'string')
+                            files.push(node.heading.sourcePos.file);
+                    }
+                }
+                return files;
+            }
+            const files = collectSourceFiles(result.result?.document);
+            expect(files).toContain('/spec/format.md');
+            expect(files).toContain('/spec/intro.md');
+        });
+    });
+    describe('config integration', () => {
+        it('includes config in result', () => {
+            const spec = createPreprocessedSpec([{
+                    file: '/spec/format.md',
+                    format: 'markdown',
+                    content: '# Title',
+                    startLine: 1,
+                }], { title: 'My Spec', status: 'ED' });
+            const result = parse(spec);
+            expect(result.result?.config.title).toBe('My Spec');
+            expect(result.result?.config.status).toBe('ED');
+        });
+        it('populates document metadata from config', () => {
+            const spec = createPreprocessedSpec([{
+                    file: '/spec/format.md',
+                    format: 'markdown',
+                    content: '# Title',
+                    startLine: 1,
+                }], { title: 'Test Spec', shortName: 'test' });
+            const result = parse(spec);
+            expect(result.result?.document.metadata?.title).toBe('Test Spec');
+            expect(result.result?.document.metadata?.shortName).toBe('test');
+        });
+    });
+    describe('realistic example', () => {
+        it('processes spec with includes (simulated via units)', () => {
+            const spec = createPreprocessedSpec([
+                {
+                    file: '/spec/format.md',
+                    format: 'markdown',
+                    content: '# Design Tokens Format\n## Abstract\nShort summary\n',
+                    startLine: 1,
+                },
+                {
+                    file: '/spec/intro.md',
+                    format: 'markdown',
+                    content: '## Introduction\nText about tokens',
+                    startLine: 1,
+                },
+            ], {
+                title: 'Design Tokens Format',
+                shortName: 'design-tokens',
+            });
+            const result = parse(spec);
+            expect(result.hasErrors).toBe(false);
+            expect(result.result?.document.children.length).toBeGreaterThan(0);
+            expect(result.result?.document.metadata?.title).toBe('Design Tokens Format');
+        });
+        it('processes HTML entry with markdown includes (simulated)', () => {
+            const spec = createPreprocessedSpec([
+                {
+                    file: '/spec/format.html',
+                    format: 'html',
+                    content: '<section id="abstract"><h2>Abstract</h2><p>Short summary</p></section>',
+                    startLine: 1,
+                },
+                {
+                    file: '/spec/intro.md',
+                    format: 'markdown',
+                    content: '## Introduction\nText...',
+                    startLine: 1,
+                },
+            ]);
+            const result = parse(spec);
+            expect(result.hasErrors).toBe(false);
+            // Find nodes from each file
+            const doc = result.result?.document;
+            const htmlSection = doc?.children.find((c) => typeof c === 'object' && c !== null && 'sourcePos' in c && c.sourcePos?.file === '/spec/format.html');
+            expect(htmlSection).toBeDefined();
+        });
+    });
+});
+describe('parseCompositeSource', () => {
+    it('parses without full PreprocessedSpec', () => {
+        const source = {
+            entryFile: '/spec/format.md',
+            entryFormat: 'markdown',
+            units: [{
+                    file: '/spec/format.md',
+                    format: 'markdown',
+                    content: '# Title',
+                    startLine: 1,
+                }],
+            includeGraph: new Map(),
+        };
+        const result = parseCompositeSource(source);
+        expect(result.hasErrors).toBe(false);
+        expect(result.result?.document.type).toBe('document');
+    });
+});
+//# sourceMappingURL=pipeline.test.js.map

package/dist/parse/__tests__/pipeline.test.js.map

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

package/dist/parse/__tests__/respec.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * ReSpec Plugin Tests
+ *
+ * Tests for dfn, xref, data-cite, and aside plugins.
+ */
+export {};
+//# sourceMappingURL=respec.test.d.ts.map

package/dist/parse/__tests__/respec.test.d.ts.map

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

package/dist/parse/__tests__/respec.test.js

@@ -0,0 +1,151 @@
+/**
+ * ReSpec Plugin Tests
+ *
+ * Tests for dfn, xref, data-cite, and aside plugins.
+ */
+import { describe, it, expect } from 'vitest';
+import { HtmlUnitParser } from '#src/parse/html/index';
+function createUnit(content, file = '/spec/test.html') {
+    return { file, format: 'html', content, startLine: 1 };
+}
+describe('DfnPlugin', () => {
+    const parser = new HtmlUnitParser();
+    it('parses basic dfn elements', () => {
+        const unit = createUnit('<p><dfn>event loop</dfn> is a term.</p>');
+        const blocks = parser.parse(unit);
+        const para = blocks[0];
+        const dfn = para.children.find((c) => c.type === 'definition');
+        expect(dfn).toBeDefined();
+        expect(dfn.type).toBe('definition');
+        expect(dfn.term).toBe('event loop');
+        expect(dfn.linkTexts).toEqual(['event loop']);
+        expect(dfn.forContexts).toEqual([null]);
+        expect(dfn.dfnType).toBe('dfn');
+    });
+    it('parses dfn with data-lt attribute', () => {
+        const unit = createUnit('<p><dfn data-lt="loop;event cycle">event loop</dfn></p>');
+        const blocks = parser.parse(unit);
+        const para = blocks[0];
+        const dfn = para.children.find((c) => c.type === 'definition');
+        expect(dfn.linkTexts).toEqual(['loop', 'event cycle']);
+    });
+    it('parses dfn with data-dfn-for attribute', () => {
+        const unit = createUnit('<p><dfn data-dfn-for="Window">postMessage()</dfn></p>');
+        const blocks = parser.parse(unit);
+        const para = blocks[0];
+        const dfn = para.children.find((c) => c.type === 'definition');
+        expect(dfn.forContexts).toEqual(['window']);
+    });
+    it('parses dfn with data-dfn-type attribute', () => {
+        const unit = createUnit('<p><dfn data-dfn-type="method">postMessage()</dfn></p>');
+        const blocks = parser.parse(unit);
+        const para = blocks[0];
+        const dfn = para.children.find((c) => c.type === 'definition');
+        expect(dfn.dfnType).toBe('method');
+    });
+    it('preserves explicitId when present', () => {
+        const unit = createUnit('<p><dfn id="dom-event-loop">event loop</dfn></p>');
+        const blocks = parser.parse(unit);
+        const para = blocks[0];
+        const dfn = para.children.find((c) => c.type === 'definition');
+        expect(dfn.explicitId).toBe('dom-event-loop');
+    });
+});
+describe('XrefPlugin', () => {
+    const parser = new HtmlUnitParser();
+    it('parses xref elements', () => {
+        const unit = createUnit('<p>See <xref>event loop</xref></p>');
+        const blocks = parser.parse(unit);
+        const para = blocks[0];
+        const xref = para.children.find((c) => c.type === 'reference');
+        expect(xref).toBeDefined();
+        expect(xref.type).toBe('reference');
+        expect(xref.targetTerm).toBe('event loop');
+        expect(xref.candidateTerms).toEqual(['event loop']);
+        expect(xref.allowExternal).toBe(true);
+    });
+    it('parses xref with data-xref-for', () => {
+        const unit = createUnit('<p><xref data-xref-for="Window">postMessage()</xref></p>');
+        const blocks = parser.parse(unit);
+        const para = blocks[0];
+        const xref = para.children.find((c) => c.type === 'reference');
+        expect(xref.forContexts).toEqual(['window']);
+    });
+    it('parses xref with data-allow-external="no"', () => {
+        const unit = createUnit('<p><xref data-allow-external="no">event loop</xref></p>');
+        const blocks = parser.parse(unit);
+        const para = blocks[0];
+        const xref = para.children.find((c) => c.type === 'reference');
+        expect(xref.allowExternal).toBe(false);
+    });
+    it('handles anchor with xref attributes', () => {
+        const unit = createUnit('<p><a data-lt="loop">event loop</a></p>');
+        const blocks = parser.parse(unit);
+        const para = blocks[0];
+        const xref = para.children.find((c) => c.type === 'reference');
+        expect(xref).toBeDefined();
+        expect(xref.candidateTerms).toEqual(['loop']);
+    });
+});
+describe('DataCitePlugin', () => {
+    const parser = new HtmlUnitParser();
+    it('parses data-cite on anchor', () => {
+        const unit = createUnit('<p><a data-cite="HTML#the-a-element">anchor element</a></p>');
+        const blocks = parser.parse(unit);
+        const para = blocks[0];
+        const cite = para.children.find((c) => c.type === 'cite');
+        expect(cite).toBeDefined();
+        expect(cite.type).toBe('cite');
+        expect(cite.key).toBe('html');
+        expect(cite.fragment).toBe('the-a-element');
+    });
+    it('parses forced normative data-cite', () => {
+        const unit = createUnit('<p><a data-cite="!RFC2119">keywords</a></p>');
+        const blocks = parser.parse(unit);
+        const para = blocks[0];
+        const cite = para.children.find((c) => c.type === 'cite');
+        expect(cite.forcedNormative).toBe(true);
+        expect(cite.kind).toBe('normative');
+    });
+    it('parses data-cite with path', () => {
+        const unit = createUnit('<p><a data-cite="rfc2119/section-2#anchor">section</a></p>');
+        const blocks = parser.parse(unit);
+        const para = blocks[0];
+        const cite = para.children.find((c) => c.type === 'cite');
+        expect(cite.key).toBe('rfc2119');
+        expect(cite.path).toBe('section-2');
+        expect(cite.fragment).toBe('anchor');
+    });
+});
+describe('AsidePlugin', () => {
+    const parser = new HtmlUnitParser();
+    it('parses aside elements as notes', () => {
+        const unit = createUnit('<aside><p>This is a note.</p></aside>');
+        const blocks = parser.parse(unit);
+        const note = blocks[0];
+        expect(note.type).toBe('note');
+        expect(note.informative).toBe(true);
+        expect(note.noteType).toBe('note');
+    });
+    it('parses aside with class="warning"', () => {
+        const unit = createUnit('<aside class="warning"><p>Warning!</p></aside>');
+        const blocks = parser.parse(unit);
+        const note = blocks[0];
+        expect(note.noteType).toBe('warning');
+        expect(note.informative).toBe(true);
+    });
+    it('parses div with class="note"', () => {
+        const unit = createUnit('<div class="note"><p>A note.</p></div>');
+        const blocks = parser.parse(unit);
+        const note = blocks[0];
+        expect(note.type).toBe('note');
+        expect(note.informative).toBe(true);
+    });
+    it('does not match plain div', () => {
+        const unit = createUnit('<div><p>Just a div.</p></div>');
+        const blocks = parser.parse(unit);
+        // Plain div should flatten to paragraph
+        expect(blocks[0].type).toBe('paragraph');
+    });
+});
+//# sourceMappingURL=respec.test.js.map

package/dist/parse/__tests__/respec.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"respec.test.js","sourceRoot":"","sources":["../../../src/parse/__tests__/respec.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAIvD,SAAS,UAAU,CAAC,OAAe,EAAE,IAAI,GAAG,iBAAiB;IACzD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;AAC3D,CAAC;AAED,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACvB,MAAM,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;IAEpC,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACjC,MAAM,IAAI,GAAG,UAAU,CAAC,yCAAyC,CAAC,CAAC;QACnE,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAElC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAmB,CAAC;QACzC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,CAAqB,CAAC;QAEnF,MAAM,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;QAC1B,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACpC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACpC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;QAC9C,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACxC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QACzC,MAAM,IAAI,GAAG,UAAU,CAAC,yDAAyD,CAAC,CAAC;QACnF,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAElC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAmB,CAAC;QACzC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,CAAqB,CAAC;QAEnF,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAC9C,MAAM,IAAI,GAAG,UAAU,CAAC,uDAAuD,CAAC,CAAC;QACjF,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAElC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAmB,CAAC;QACzC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,CAAqB,CAAC;QAEnF,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QAC/C,MAAM,IAAI,GAAG,UAAU,CAAC,wDAAwD,CAAC,CAAC;QAClF,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAElC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAmB,CAAC;QACzC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,CAAqB,CAAC;QAEnF,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QACzC,MAAM,IAAI,GAAG,UAAU,CAAC,kDAAkD,CAAC,CAAC;QAC5E,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAElC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAmB,CAAC;QACzC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,CAAqB,CAAC;QAEnF,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IACxB,MAAM,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;IAEpC,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAC5B,MAAM,IAAI,GAAG,UAAU,CAAC,oCAAoC,CAAC,CAAC;QAC9D,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAElC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAmB,CAAC;QACzC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAoB,CAAC;QAElF,MAAM,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;QAC3B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACpC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC3C,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;QACpD,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACtC,MAAM,IAAI,GAAG,UAAU,CAAC,0DAA0D,CAAC,CAAC;QACpF,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAElC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAmB,CAAC;QACzC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAoB,CAAC;QAElF,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACjD,MAAM,IAAI,GAAG,UAAU,CAAC,yDAAyD,CAAC,CAAC;QACnF,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAElC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAmB,CAAC;QACzC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAoB,CAAC;QAElF,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC3C,MAAM,IAAI,GAAG,UAAU,CAAC,yCAAyC,CAAC,CAAC;QACnE,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAElC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAmB,CAAC;QACzC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAoB,CAAC;QAElF,MAAM,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;QAC3B,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC5B,MAAM,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;IAEpC,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QAClC,MAAM,IAAI,GAAG,UAAU,CAAC,6DAA6D,CAAC,CAAC;QACvF,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAElC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAmB,CAAC;QACzC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAe,CAAC;QAExE,MAAM,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;QAC3B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/B,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QACzC,MAAM,IAAI,GAAG,UAAU,CAAC,6CAA6C,CAAC,CAAC;QACvE,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAElC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAmB,CAAC;QACzC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAe,CAAC;QAExE,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QAClC,MAAM,IAAI,GAAG,UAAU,CAAC,4DAA4D,CAAC,CAAC;QACtF,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAElC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAmB,CAAC;QACzC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAe,CAAC;QAExE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACjC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACpC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IACzB,MAAM,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;IAEpC,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACtC,MAAM,IAAI,GAAG,UAAU,CAAC,uCAAuC,CAAC,CAAC;QACjE,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAElC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAc,CAAC;QACpC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/B,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QACzC,MAAM,IAAI,GAAG,UAAU,CAAC,gDAAgD,CAAC,CAAC;QAC1E,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAElC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAc,CAAC;QACpC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACtC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACpC,MAAM,IAAI,GAAG,UAAU,CAAC,wCAAwC,CAAC,CAAC;QAClE,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAElC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAc,CAAC;QACpC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/B,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;QAChC,MAAM,IAAI,GAAG,UAAU,CAAC,+BAA+B,CAAC,CAAC;QACzD,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAElC,wCAAwC;QACxC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/parse/assembler.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Document Assembler
+ *
+ * Assembles parsed blocks from multiple units into a document with
+ * proper section hierarchy based on heading levels.
+ */
+import type { Section, Block, Document } from '#src/types/ast.generated';
+import type { SpecConfig } from '#src/preprocess/types';
+/**
+ * Build section hierarchy from flat blocks
+ *
+ * Converts headings to sections and nests content based on heading depth.
+ * Pre-existing sections (from HTML) are inserted at their natural position.
+ */
+export declare function buildSectionHierarchy(blocks: (Section | Block)[]): (Section | Block)[];
+/**
+ * Assemble blocks into a complete document
+ */
+export declare function assembleDocument(blocks: (Section | Block)[], config: SpecConfig, entryFile: string): Document;
+//# sourceMappingURL=assembler.d.ts.map

package/dist/parse/assembler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assembler.d.ts","sourceRoot":"","sources":["../../src/parse/assembler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACR,OAAO,EACP,KAAK,EAEL,QAAQ,EAEX,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AA0CxD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,CAAC,OAAO,GAAG,KAAK,CAAC,EAAE,GAAG,CAAC,OAAO,GAAG,KAAK,CAAC,EAAE,CAmEtF;AAiDD;;GAEG;AACH,wBAAgB,gBAAgB,CAC5B,MAAM,EAAE,CAAC,OAAO,GAAG,KAAK,CAAC,EAAE,EAC3B,MAAM,EAAE,UAAU,EAClB,SAAS,EAAE,MAAM,GAClB,QAAQ,CAwBV"}

package/dist/parse/assembler.js

@@ -0,0 +1,175 @@
+/**
+ * Document Assembler
+ *
+ * Assembles parsed blocks from multiple units into a document with
+ * proper section hierarchy based on heading levels.
+ */
+/**
+ * Check if node is a heading block
+ */
+function isHeading(node) {
+    return node.type === 'heading';
+}
+/**
+ * Check if node is already a section
+ */
+function isSection(node) {
+    return node.type === 'section';
+}
+/**
+ * Create section from heading
+ */
+function createSectionFromHeading(heading) {
+    const section = {
+        type: 'section',
+        heading: {
+            type: 'heading',
+            depth: heading.depth,
+            children: heading.children,
+        },
+        children: [],
+    };
+    if (heading.id) {
+        section.id = heading.id;
+        section.heading.id = heading.id;
+    }
+    if (heading.sourcePos) {
+        section.sourcePos = heading.sourcePos;
+        section.heading.sourcePos = heading.sourcePos;
+    }
+    return section;
+}
+/**
+ * Build section hierarchy from flat blocks
+ *
+ * Converts headings to sections and nests content based on heading depth.
+ * Pre-existing sections (from HTML) are inserted at their natural position.
+ */
+export function buildSectionHierarchy(blocks) {
+    if (blocks.length === 0)
+        return [];
+    const result = [];
+    // Stack of (section, depth) for tracking hierarchy
+    // depth 0 means top-level content before any heading
+    const sectionStack = [
+        { section: null, depth: 0 }
+    ];
+    /**
+     * Get current container for adding content
+     */
+    function getCurrentContainer() {
+        const top = sectionStack[sectionStack.length - 1];
+        if (top.section) {
+            return top.section.children;
+        }
+        return result;
+    }
+    /**
+     * Pop sections until we find one with depth < targetDepth
+     */
+    function popToDepth(targetDepth) {
+        while (sectionStack.length > 1) {
+            const top = sectionStack[sectionStack.length - 1];
+            if (top.depth < targetDepth)
+                break;
+            sectionStack.pop();
+        }
+    }
+    for (const node of blocks) {
+        if (isSection(node)) {
+            // Pre-existing section - determine its depth from heading or default to 1
+            const sectionDepth = node.heading?.depth ?? 1;
+            // Pop to appropriate level
+            popToDepth(sectionDepth);
+            // Add to current container
+            getCurrentContainer().push(node);
+            // Push this section onto stack
+            sectionStack.push({ section: node, depth: sectionDepth });
+        }
+        else if (isHeading(node)) {
+            const headingDepth = node.depth;
+            // Pop sections until we find parent level
+            popToDepth(headingDepth);
+            // Create new section from heading
+            const newSection = createSectionFromHeading(node);
+            // Add to current container
+            getCurrentContainer().push(newSection);
+            // Push new section onto stack
+            sectionStack.push({ section: newSection, depth: headingDepth });
+        }
+        else {
+            // Regular block - add to current container
+            getCurrentContainer().push(node);
+        }
+    }
+    return result;
+}
+/**
+ * Convert SpecConfig to DocumentMetadata
+ */
+function configToMetadata(config) {
+    const meta = {};
+    let hasContent = false;
+    if (config.title) {
+        meta.title = config.title;
+        hasContent = true;
+    }
+    if (config.shortName) {
+        meta.shortName = config.shortName;
+        hasContent = true;
+    }
+    if (config.status) {
+        meta.status = config.status;
+        hasContent = true;
+    }
+    if (config.publishDate) {
+        meta.publishDate = config.publishDate;
+        hasContent = true;
+    }
+    if (config.editors && config.editors.length > 0) {
+        meta.editors = config.editors.map(e => ({
+            name: e.name,
+            url: e.url,
+            company: e.company,
+        }));
+        hasContent = true;
+    }
+    if (config.authors && config.authors.length > 0) {
+        meta.authors = config.authors.map(a => ({
+            name: a.name,
+            url: a.url,
+            company: a.company,
+        }));
+        hasContent = true;
+    }
+    if (config.abstract) {
+        meta.abstract = config.abstract;
+        hasContent = true;
+    }
+    return hasContent ? meta : undefined;
+}
+/**
+ * Assemble blocks into a complete document
+ */
+export function assembleDocument(blocks, config, entryFile) {
+    // Build section hierarchy
+    const children = buildSectionHierarchy(blocks);
+    // Create document
+    const doc = {
+        type: 'document',
+        children,
+    };
+    // Add metadata from config
+    const metadata = configToMetadata(config);
+    if (metadata) {
+        doc.metadata = metadata;
+    }
+    // Add sourcePos for document root
+    doc.sourcePos = {
+        file: entryFile,
+        line: 1,
+        column: 1,
+    };
+    return doc;
+}
+//# sourceMappingURL=assembler.js.map

package/dist/parse/assembler.js.map

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

package/dist/parse/html/AsideHtmlParser.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Aside/Note HTML Parser
+ *
+ * Handles <aside>, <div class="note">, <div class="example">, etc.
+ * These containers mark informative content for citation classification.
+ */
+import type { HtmlParserModule } from '#src/parse/registry';
+/**
+ * HTML parser module for aside and note-type elements.
+ */
+export declare const AsideHtmlParser: HtmlParserModule;
+//# sourceMappingURL=AsideHtmlParser.d.ts.map

package/dist/parse/html/AsideHtmlParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AsideHtmlParser.d.ts","sourceRoot":"","sources":["../../../src/parse/html/AsideHtmlParser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAoC,MAAM,qBAAqB,CAAC;AAgC9F;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,gBA6C7B,CAAC"}