@openuji/speculator 0.3.2 → 0.4.0

package/dist/plugins/__tests__/citation-transform.test.js

@@ -0,0 +1,89 @@
+/**
+ * Citation Transform Tests
+ *
+ * Tests for bracket citation scanning in transform phase.
+ */
+import { describe, it, expect } from 'vitest';
+import { citationTransformPlugin } from '#src/plugins/citation-transform';
+function createDocument(paragraphText) {
+    return {
+        type: 'document',
+        children: [{
+                type: 'paragraph',
+                children: [{ type: 'text', value: paragraphText }],
+            }],
+    };
+}
+function getSectionDocument(paragraphText) {
+    return {
+        type: 'document',
+        children: [{
+                type: 'section',
+                children: [{
+                        type: 'paragraph',
+                        children: [{ type: 'text', value: paragraphText }],
+                    }],
+            }],
+    };
+}
+describe('CitationTransformPlugin', () => {
+    it('transforms basic [[FOO]] citations', async () => {
+        const doc = createDocument('See [[RFC2119]] for details.');
+        await citationTransformPlugin.transform({ document: doc });
+        const para = doc.children[0];
+        expect(para.children.length).toBe(3);
+        expect(para.children[0].value).toBe('See ');
+        expect(para.children[1].type).toBe('cite');
+        expect(para.children[1].key).toBe('rfc2119');
+        expect(para.children[2].value).toBe(' for details.');
+    });
+    it('transforms [[!FOO]] as forced normative', async () => {
+        const doc = createDocument('As required by [[!RFC2119]].');
+        await citationTransformPlugin.transform({ document: doc });
+        const para = doc.children[0];
+        const cite = para.children[1];
+        expect(cite.key).toBe('rfc2119');
+        expect(cite.forcedNormative).toBe(true);
+        expect(cite.kind).toBe('normative');
+    });
+    it('transforms [[?FOO]] as forced informative', async () => {
+        const doc = createDocument('For background, see [[?HTML]].');
+        await citationTransformPlugin.transform({ document: doc });
+        const para = doc.children[0];
+        const cite = para.children[1];
+        expect(cite.key).toBe('html');
+        expect(cite.forcedInformative).toBe(true);
+        expect(cite.kind).toBe('informative');
+    });
+    it('transforms [[[FOO]]] as expanded', async () => {
+        const doc = createDocument('See [[[RFC2119]]] specification.');
+        await citationTransformPlugin.transform({ document: doc });
+        const para = doc.children[0];
+        const cite = para.children[1];
+        expect(cite.key).toBe('rfc2119');
+        expect(cite.expanded).toBe(true);
+    });
+    it('transforms multiple citations in one text', async () => {
+        const doc = createDocument('See [[RFC2119]] and [[HTML]].');
+        await citationTransformPlugin.transform({ document: doc });
+        const para = doc.children[0];
+        expect(para.children.length).toBe(5);
+        expect(para.children[1].key).toBe('rfc2119');
+        expect(para.children[3].key).toBe('html');
+    });
+    it('transforms citations in sections', async () => {
+        const doc = getSectionDocument('Reference [[DOM]].');
+        await citationTransformPlugin.transform({ document: doc });
+        const section = doc.children[0];
+        const para = section.children[0];
+        expect(para.children[1].key).toBe('dom');
+    });
+    it('preserves text without citations', async () => {
+        const doc = createDocument('No citations here.');
+        await citationTransformPlugin.transform({ document: doc });
+        const para = doc.children[0];
+        expect(para.children.length).toBe(1);
+        expect(para.children[0].value).toBe('No citations here.');
+    });
+});
+//# sourceMappingURL=citation-transform.test.js.map

package/dist/plugins/__tests__/citation-transform.test.js.map

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

package/dist/plugins/__tests__/dfn-parsing.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dfn-parsing.test.d.ts.map

package/dist/plugins/__tests__/dfn-parsing.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dfn-parsing.test.d.ts","sourceRoot":"","sources":["../../../src/plugins/__tests__/dfn-parsing.test.ts"],"names":[],"mappings":""}

package/dist/plugins/__tests__/dfn-parsing.test.js

@@ -0,0 +1,65 @@
+import { describe, it, expect } from 'vitest';
+import { MarkdownUnitParser } from '#src/parse/markdown/parser';
+import { ParseHandlerRegistry } from '#src/parse/registry';
+import { dfnPlugin } from '#src/plugins/dfn';
+import { paragraphPlugin } from '#src/plugins/paragraph';
+import { inlinePlugin } from '#src/plugins/inline';
+function createParser() {
+    const registry = new ParseHandlerRegistry();
+    if (paragraphPlugin.parse?.markdown) {
+        registry.registerMdHandler(paragraphPlugin.parse.markdown);
+    }
+    if (inlinePlugin.parse?.markdown) {
+        registry.registerMdHandler(inlinePlugin.parse.markdown);
+    }
+    if (dfnPlugin.parse?.markdown) {
+        registry.registerMdHandler(dfnPlugin.parse.markdown);
+    }
+    return new MarkdownUnitParser(registry);
+}
+describe('dfn plugin (markdown)', () => {
+    const parser = createParser();
+    it('parses simple :dfn directive', () => {
+        const blocks = parser.parse({
+            content: ':dfn[Term]',
+            file: '/test.md',
+            format: 'markdown',
+            startLine: 1,
+        });
+        const paragraph = blocks[0];
+        const dfn = paragraph.children[0];
+        expect(dfn.type).toBe('definition');
+        expect(dfn.term).toBe('term');
+        expect(dfn.linkTexts).toEqual(['term']);
+        expect(dfn.forContexts).toEqual([null]);
+        expect(dfn.dfnType).toBe('dfn');
+    });
+    it('parses :dfn with attributes', () => {
+        const blocks = parser.parse({
+            content: ':dfn[Foo]{#foo data-lt="Foo;Bar" data-dfn-for="Baz" data-dfn-type="method"}',
+            file: '/test.md',
+            format: 'markdown',
+            startLine: 1,
+        });
+        const paragraph = blocks[0];
+        const dfn = paragraph.children[0];
+        expect(dfn.explicitId).toBe('foo');
+        expect(dfn.linkTexts).toEqual(['foo', 'bar']);
+        expect(dfn.forContexts).toEqual(['baz']);
+        expect(dfn.dfnType).toBe('method');
+    });
+    it('keeps surrounding text when :dfn appears inline', () => {
+        const blocks = parser.parse({
+            content: 'Intro :dfn[Item]{#item} outro',
+            file: '/test.md',
+            format: 'markdown',
+            startLine: 1,
+        });
+        const paragraph = blocks[0];
+        const [before, dfn, after] = paragraph.children;
+        expect(before.value).toBe('Intro ');
+        expect(dfn.type).toBe('definition');
+        expect(after.value).toBe(' outro');
+    });
+});
+//# sourceMappingURL=dfn-parsing.test.js.map

package/dist/plugins/__tests__/dfn-parsing.test.js.map

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

package/dist/plugins/__tests__/dfn-resolve.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * DFN Resolve Plugin Tests
+ */
+export {};
+//# sourceMappingURL=dfn-resolve.test.d.ts.map

package/dist/plugins/__tests__/dfn-resolve.test.d.ts.map

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

package/dist/plugins/__tests__/dfn-resolve.test.js

@@ -0,0 +1,152 @@
+/**
+ * DFN Resolve Plugin Tests
+ */
+import { describe, it, expect } from 'vitest';
+import { dfnResolvePlugin } from '#src/plugins/dfn-resolve';
+function createDocWithDfnAndRef(dfnTerm, refTerm) {
+    return {
+        type: 'document',
+        children: [{
+                type: 'section',
+                children: [
+                    {
+                        type: 'paragraph',
+                        children: [{
+                                type: 'definition',
+                                term: dfnTerm,
+                                children: [{ type: 'text', value: dfnTerm }],
+                            }],
+                    },
+                    {
+                        type: 'paragraph',
+                        children: [{
+                                type: 'reference',
+                                targetTerm: refTerm,
+                                children: [{ type: 'text', value: refTerm }],
+                            }],
+                    },
+                ],
+            }],
+    };
+}
+describe('DfnResolvePlugin', () => {
+    it('resolves reference to definition with same term', async () => {
+        const doc = createDocWithDfnAndRef('event loop', 'event loop');
+        await dfnResolvePlugin.index({ document: doc });
+        await dfnResolvePlugin.resolve({ document: doc });
+        const section = doc.children[0];
+        const refPara = section.children[1];
+        const ref = refPara.children[0];
+        expect(ref.targetId).toBe('dfn-event-loop');
+    });
+    it('assigns ID to definition', async () => {
+        const doc = createDocWithDfnAndRef('task queue', 'task queue');
+        await dfnResolvePlugin.index({ document: doc });
+        await dfnResolvePlugin.resolve({ document: doc });
+        const section = doc.children[0];
+        const dfnPara = section.children[0];
+        const dfn = dfnPara.children[0];
+        expect(dfn.id).toBe('dfn-task-queue');
+    });
+    it('resolves reference using candidateTerms', async () => {
+        const doc = {
+            type: 'document',
+            children: [{
+                    type: 'section',
+                    children: [
+                        {
+                            type: 'paragraph',
+                            children: [{
+                                    type: 'definition',
+                                    term: 'event loop',
+                                    linkTexts: ['event loop', 'loop'],
+                                    children: [{ type: 'text', value: 'event loop' }],
+                                }],
+                        },
+                        {
+                            type: 'paragraph',
+                            children: [{
+                                    type: 'reference',
+                                    targetTerm: 'loop',
+                                    candidateTerms: ['loop'],
+                                    children: [{ type: 'text', value: 'loop' }],
+                                }],
+                        },
+                    ],
+                }],
+        };
+        await dfnResolvePlugin.index({ document: doc });
+        await dfnResolvePlugin.resolve({ document: doc });
+        const section = doc.children[0];
+        const refPara = section.children[1];
+        const ref = refPara.children[0];
+        expect(ref.targetId).toBe('dfn-event-loop');
+    });
+    it('resolves with forContext matching', async () => {
+        const doc = {
+            type: 'document',
+            children: [{
+                    type: 'section',
+                    children: [
+                        {
+                            type: 'paragraph',
+                            children: [{
+                                    type: 'definition',
+                                    term: 'postMessage',
+                                    forContexts: ['Window'],
+                                    children: [{ type: 'text', value: 'postMessage' }],
+                                }],
+                        },
+                        {
+                            type: 'paragraph',
+                            children: [{
+                                    type: 'reference',
+                                    targetTerm: 'postMessage',
+                                    forContexts: ['Window'],
+                                    children: [{ type: 'text', value: 'postMessage' }],
+                                }],
+                        },
+                    ],
+                }],
+        };
+        await dfnResolvePlugin.index({ document: doc });
+        await dfnResolvePlugin.resolve({ document: doc });
+        const section = doc.children[0];
+        const refPara = section.children[1];
+        const ref = refPara.children[0];
+        expect(ref.targetId).toBe('dfn-window-postmessage');
+    });
+    it('leaves targetId undefined for unresolved reference', async () => {
+        const doc = createDocWithDfnAndRef('foo', 'bar');
+        await dfnResolvePlugin.index({ document: doc });
+        await dfnResolvePlugin.resolve({ document: doc });
+        const section = doc.children[0];
+        const refPara = section.children[1];
+        const ref = refPara.children[0];
+        expect(ref.targetId).toBeUndefined();
+    });
+    it('preserves explicitId on definition', async () => {
+        const doc = {
+            type: 'document',
+            children: [{
+                    type: 'section',
+                    children: [{
+                            type: 'paragraph',
+                            children: [{
+                                    type: 'definition',
+                                    term: 'focus',
+                                    explicitId: 'dom-focus',
+                                    children: [{ type: 'text', value: 'focus' }],
+                                }],
+                        }],
+                }],
+        };
+        await dfnResolvePlugin.index({ document: doc });
+        await dfnResolvePlugin.resolve({ document: doc });
+        const section = doc.children[0];
+        const dfnPara = section.children[0];
+        const dfn = dfnPara.children[0];
+        expect(dfn.id).toBe('dom-focus');
+    });
+});
+//# sourceMappingURL=dfn-resolve.test.js.map

package/dist/plugins/__tests__/dfn-resolve.test.js.map

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

package/dist/plugins/__tests__/xref-parsing.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=xref-parsing.test.d.ts.map

package/dist/plugins/__tests__/xref-parsing.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xref-parsing.test.d.ts","sourceRoot":"","sources":["../../../src/plugins/__tests__/xref-parsing.test.ts"],"names":[],"mappings":""}

package/dist/plugins/__tests__/xref-parsing.test.js

@@ -0,0 +1,66 @@
+import { describe, it, expect } from 'vitest';
+import { MarkdownUnitParser } from '#src/parse/markdown/parser';
+import { ParseHandlerRegistry } from '#src/parse/registry';
+import { xrefPlugin } from '../xref.js';
+import { paragraphPlugin } from '../paragraph.js';
+import { inlinePlugin } from '../inline.js';
+describe('xref plugin (markdown)', () => {
+    const registry = new ParseHandlerRegistry();
+    // Register required handlers
+    if (paragraphPlugin.parse?.markdown) {
+        registry.registerMdHandler(paragraphPlugin.parse.markdown);
+    }
+    if (inlinePlugin.parse?.markdown) {
+        registry.registerMdHandler(inlinePlugin.parse.markdown);
+    }
+    if (xrefPlugin.parse?.markdown) {
+        registry.registerMdHandler(xrefPlugin.parse.markdown);
+    }
+    const parser = new MarkdownUnitParser(registry);
+    it('parses simple :xref directive', () => {
+        const content = ':xref[Term]';
+        const result = parser.parse({
+            content,
+            file: '/test.md',
+            format: 'markdown',
+            startLine: 1
+        });
+        const paragraph = result[0];
+        const xref = paragraph.children[0];
+        expect(xref.type).toBe('reference');
+        expect(xref.targetTerm).toBe('term');
+        expect(xref.candidateTerms).toEqual(['term']);
+    });
+    it('parses :xref with attributes', () => {
+        const content = ':xref[Term]{data-link-type="method" data-xref-for="Baz" data-xref-spec="dom" data-allow-external="no"}';
+        const result = parser.parse({
+            content,
+            file: '/test.md',
+            format: 'markdown',
+            startLine: 1
+        });
+        const paragraph = result[0];
+        const xref = paragraph.children[0];
+        expect(xref.type).toBe('reference');
+        expect(xref.targetTerm).toBe('term');
+        expect(xref.preferredType).toBe('method');
+        expect(xref.forContexts).toEqual(['baz']);
+        expect(xref.xrefSpec).toBe('dom');
+        expect(xref.allowExternal).toBe(false);
+    });
+    it('parses :xref with alternate text (data-lt)', () => {
+        const content = ':xref[Term]{data-lt="Foo; Bar"}';
+        const result = parser.parse({
+            content,
+            file: '/test.md',
+            format: 'markdown',
+            startLine: 1
+        });
+        const paragraph = result[0];
+        const xref = paragraph.children[0];
+        expect(xref.type).toBe('reference');
+        expect(xref.targetTerm).toBe('term');
+        expect(xref.candidateTerms).toEqual(['foo', 'bar']);
+    });
+});
+//# sourceMappingURL=xref-parsing.test.js.map

package/dist/plugins/__tests__/xref-parsing.test.js.map

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

package/dist/plugins/aside.d.ts

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

package/dist/plugins/aside.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aside.d.ts","sourceRoot":"","sources":["../../src/plugins/aside.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAoC,MAAM,qBAAqB,CAAC;AAgCpF;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,MAkDzB,CAAC"}

package/dist/plugins/aside.js

@@ -0,0 +1,78 @@
+/**
+ * Aside/Note Plugin
+ *
+ * Handles <aside>, <div class="note">, <div class="example">, etc.
+ * These containers mark informative content for citation classification.
+ */
+/**
+ * Note type classifications
+ */
+const NOTE_CLASSES = ['note', 'warning', 'example', 'issue', 'advisement'];
+/**
+ * Check if element has a note-like class
+ */
+function getNoteType(element, ctx) {
+    // hast converts 'class' to 'className' 
+    const className = ctx.getAttr(element, 'className') ?? '';
+    const classes = className.toLowerCase().split(/\s+/);
+    for (const noteClass of NOTE_CLASSES) {
+        if (classes.includes(noteClass)) {
+            // Map advisement to warning
+            if (noteClass === 'advisement')
+                return 'warning';
+            return noteClass;
+        }
+    }
+    // Check role attribute
+    const role = ctx.getAttr(element, 'role');
+    if (role === 'note')
+        return 'note';
+    return null;
+}
+/**
+ * Plugin for aside and note-type elements.
+ */
+export const asidePlugin = {
+    name: 'aside',
+    order: { parse: 8 }, // Run before misc plugin but after specialized handlers
+    parse: {
+        html: {
+            tags: ['aside', 'div'],
+            handleBlock(element, ctx) {
+                const tagName = element.tagName.toLowerCase();
+                // For <aside>, always treat as note
+                // For <div>, only if it has a note class
+                let noteType;
+                if (tagName === 'aside') {
+                    noteType = getNoteType(element, ctx) ?? 'note';
+                }
+                else {
+                    // tagName === 'div'
+                    noteType = getNoteType(element, ctx);
+                    if (!noteType) {
+                        // Not a note-type div, let misc plugin handle it
+                        return null;
+                    }
+                }
+                const sourcePos = ctx.createSourcePos(element);
+                const id = ctx.getAttr(element, 'id');
+                // Transform children to blocks (notes should not contain sections)
+                const childBlocks = ctx.transformBlockChildren(element.children);
+                // Filter out sections if any - notes only contain blocks
+                const children = childBlocks.filter((c) => c.type !== 'section');
+                const result = {
+                    type: 'note',
+                    noteType,
+                    informative: true, // Always informative
+                    children,
+                };
+                if (id)
+                    result.id = id;
+                if (sourcePos)
+                    result.sourcePos = sourcePos;
+                return result;
+            },
+        },
+    },
+};
+//# sourceMappingURL=aside.js.map

package/dist/plugins/aside.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aside.js","sourceRoot":"","sources":["../../src/plugins/aside.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;GAEG;AACH,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,CAAU,CAAC;AAGpF;;GAEG;AACH,SAAS,WAAW,CAAC,OAAgB,EAAE,GAAiB;IACpD,wCAAwC;IACxC,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC;IAC1D,MAAM,OAAO,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAErD,KAAK,MAAM,SAAS,IAAI,YAAY,EAAE,CAAC;QACnC,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,4BAA4B;YAC5B,IAAI,SAAS,KAAK,YAAY;gBAAE,OAAO,SAAS,CAAC;YACjD,OAAO,SAAqB,CAAC;QACjC,CAAC;IACL,CAAC;IAED,uBAAuB;IACvB,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC1C,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,MAAM,CAAC;IAEnC,OAAO,IAAI,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAW;IAC/B,IAAI,EAAE,OAAO;IACb,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,wDAAwD;IAE7E,KAAK,EAAE;QACH,IAAI,EAAE;YACF,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC;YAEtB,WAAW,CAAC,OAAgB,EAAE,GAAiB;gBAC3C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;gBAE9C,oCAAoC;gBACpC,yCAAyC;gBACzC,IAAI,QAAyB,CAAC;gBAE9B,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;oBACtB,QAAQ,GAAG,WAAW,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC;gBACnD,CAAC;qBAAM,CAAC;oBACJ,oBAAoB;oBACpB,QAAQ,GAAG,WAAW,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;oBACrC,IAAI,CAAC,QAAQ,EAAE,CAAC;wBACZ,iDAAiD;wBACjD,OAAO,IAAI,CAAC;oBAChB,CAAC;gBACL,CAAC;gBAED,MAAM,SAAS,GAAG,GAAG,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;gBAC/C,MAAM,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBAEtC,mEAAmE;gBACnE,MAAM,WAAW,GAAG,GAAG,CAAC,sBAAsB,CAAC,OAAO,CAAC,QAAyB,CAAC,CAAC;gBAClF,yDAAyD;gBACzD,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAiD,EAAE,CACrF,CAAC,CAAC,IAAI,KAAK,SAAS,CACvB,CAAC;gBAEF,MAAM,MAAM,GAAc;oBACtB,IAAI,EAAE,MAAM;oBACZ,QAAQ;oBACR,WAAW,EAAE,IAAI,EAAE,qBAAqB;oBACxC,QAAQ;iBACX,CAAC;gBAEF,IAAI,EAAE;oBAAE,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC;gBACvB,IAAI,SAAS;oBAAE,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC;gBAE5C,OAAO,MAAM,CAAC;YAClB,CAAC;SACJ;KACJ;CACJ,CAAC"}

package/dist/plugins/blockquote.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Blockquote Plugin
+ *
+ * Handles blockquote HTML elements and Markdown blockquote nodes.
+ */
+import type { Plugin } from '#src/pipeline/types';
+/**
+ * Plugin for blockquote elements.
+ */
+export declare const blockquotePlugin: Plugin;
+//# sourceMappingURL=blockquote.d.ts.map

package/dist/plugins/blockquote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blockquote.d.ts","sourceRoot":"","sources":["../../src/plugins/blockquote.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAoC,MAAM,qBAAqB,CAAC;AAGpF;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,MA4C9B,CAAC"}

package/dist/plugins/blockquote.js

@@ -0,0 +1,47 @@
+/**
+ * Blockquote Plugin
+ *
+ * Handles blockquote HTML elements and Markdown blockquote nodes.
+ */
+/**
+ * Plugin for blockquote elements.
+ */
+export const blockquotePlugin = {
+    name: 'blockquote',
+    order: { parse: 10 },
+    parse: {
+        html: {
+            tags: ['blockquote'],
+            handleBlock(element, ctx) {
+                const sourcePos = ctx.createSourcePos(element);
+                const result = {
+                    type: 'blockquote',
+                    children: ctx.transformBlockChildren(element.children)
+                        .filter((n) => n !== null && n.type !== 'section'),
+                };
+                const id = ctx.getAttr(element, 'id');
+                if (id)
+                    result.id = id;
+                if (sourcePos)
+                    result.sourcePos = sourcePos;
+                return result;
+            },
+        },
+        markdown: {
+            nodeTypes: ['blockquote'],
+            handleBlock(node, ctx) {
+                const quoteNode = node;
+                const sourcePos = ctx.createSourcePos(node);
+                const result = {
+                    type: 'blockquote',
+                    children: ctx.transformBlockChildren(quoteNode.children)
+                        .filter((n) => n !== null),
+                };
+                if (sourcePos)
+                    result.sourcePos = sourcePos;
+                return result;
+            },
+        },
+    },
+};
+//# sourceMappingURL=blockquote.js.map

package/dist/plugins/blockquote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blockquote.js","sourceRoot":"","sources":["../../src/plugins/blockquote.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAW;IACpC,IAAI,EAAE,YAAY;IAClB,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;IAEpB,KAAK,EAAE;QACH,IAAI,EAAE;YACF,IAAI,EAAE,CAAC,YAAY,CAAC;YAEpB,WAAW,CAAC,OAAgB,EAAE,GAAiB;gBAC3C,MAAM,SAAS,GAAG,GAAG,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;gBAE/C,MAAM,MAAM,GAAe;oBACvB,IAAI,EAAE,YAAY;oBAClB,QAAQ,EAAE,GAAG,CAAC,sBAAsB,CAAC,OAAO,CAAC,QAAQ,CAAC;yBACjD,MAAM,CAAC,CAAC,CAAC,EAAc,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC;iBACrE,CAAC;gBAEF,MAAM,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBACtC,IAAI,EAAE;oBAAE,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC;gBACvB,IAAI,SAAS;oBAAE,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC;gBAE5C,OAAO,MAAM,CAAC;YAClB,CAAC;SACJ;QAED,QAAQ,EAAE;YACN,SAAS,EAAE,CAAC,YAAY,CAAC;YAEzB,WAAW,CAAC,IAAsB,EAAE,GAAiB;gBACjD,MAAM,SAAS,GAAG,IAAkB,CAAC;gBACrC,MAAM,SAAS,GAAG,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;gBAE5C,MAAM,MAAM,GAAe;oBACvB,IAAI,EAAE,YAAY;oBAClB,QAAQ,EAAE,GAAG,CAAC,sBAAsB,CAAC,SAAS,CAAC,QAAQ,CAAC;yBACnD,MAAM,CAAC,CAAC,CAAC,EAAc,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC;iBAC7C,CAAC;gBAEF,IAAI,SAAS;oBAAE,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC;gBAE5C,OAAO,MAAM,CAAC;YAClB,CAAC;SACJ;KACJ;CACJ,CAAC"}

package/dist/plugins/citation-transform.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 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 type { Plugin } from '#src/pipeline/types';
+/**
+ * Citation transform plugin
+ */
+export declare const citationTransformPlugin: Plugin;
+//# sourceMappingURL=citation-transform.d.ts.map

package/dist/plugins/citation-transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"citation-transform.d.ts","sourceRoot":"","sources":["../../src/plugins/citation-transform.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAoB,MAAM,qBAAqB,CAAC;AAsLpE;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,MAgBrC,CAAC"}