@openuji/speculator 0.1.0

package/README.md

@@ -0,0 +1,38 @@
+# Speculator
+
+A TypeScript library for processing ReSpec-like markup and open for intgration in any frontend framework out there
+
+
+## Installation
+
+```bash
+pnpm install @openui/speculator
+```
+
+
+## Package Structure
+
+```bash
+speculator/
+├── src/
+│ ├── index.ts
+│ ├── renderer.ts
+│ ├── types.ts
+│ └── utils/
+│ ├── markdown.ts
+│ └── file-loader.ts
+├── tests/
+│ ├── renderer.test.ts
+│ └── fixtures/
+│ ├── intro.md
+│ ├── smooth-scroller.md
+│ └── ujse.webidl
+├── dist/
+├── package.json
+├── tsconfig.json
+├── jest.config.js
+├── .npmignore
+└── README.md
+```
+
+

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { Speculator } from './speculator';
+export { parseMarkdown, createMarkdownRenderer } from './markdown';
+export { nodeFileLoader, browserFileLoader, createFallbackFileLoader, getDefaultFileLoader } from './utils/file-loader';
+export type { SpeculatorOptions, FileLoader, MarkdownOptions, ProcessingResult, ProcessingStats, DataFormat } from './types';
+export { SpeculatorError } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EACL,aAAa,EACb,sBAAsB,EACvB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,wBAAwB,EACxB,oBAAoB,EACrB,MAAM,qBAAqB,CAAC;AAG7B,YAAY,EACV,iBAAiB,EACjB,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,UAAU,EACX,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SpeculatorError = exports.getDefaultFileLoader = exports.createFallbackFileLoader = exports.browserFileLoader = exports.nodeFileLoader = exports.createMarkdownRenderer = exports.parseMarkdown = exports.Speculator = void 0;
+// Main exports
+var speculator_1 = require("./speculator");
+Object.defineProperty(exports, "Speculator", { enumerable: true, get: function () { return speculator_1.Speculator; } });
+var markdown_1 = require("./markdown");
+Object.defineProperty(exports, "parseMarkdown", { enumerable: true, get: function () { return markdown_1.parseMarkdown; } });
+Object.defineProperty(exports, "createMarkdownRenderer", { enumerable: true, get: function () { return markdown_1.createMarkdownRenderer; } });
+var file_loader_1 = require("./utils/file-loader");
+Object.defineProperty(exports, "nodeFileLoader", { enumerable: true, get: function () { return file_loader_1.nodeFileLoader; } });
+Object.defineProperty(exports, "browserFileLoader", { enumerable: true, get: function () { return file_loader_1.browserFileLoader; } });
+Object.defineProperty(exports, "createFallbackFileLoader", { enumerable: true, get: function () { return file_loader_1.createFallbackFileLoader; } });
+Object.defineProperty(exports, "getDefaultFileLoader", { enumerable: true, get: function () { return file_loader_1.getDefaultFileLoader; } });
+var types_1 = require("./types");
+Object.defineProperty(exports, "SpeculatorError", { enumerable: true, get: function () { return types_1.SpeculatorError; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,eAAe;AACf,2CAA0C;AAAjC,wGAAA,UAAU,OAAA;AACnB,uCAGoB;AAFlB,yGAAA,aAAa,OAAA;AACb,kHAAA,sBAAsB,OAAA;AAExB,mDAK6B;AAJ3B,6GAAA,cAAc,OAAA;AACd,gHAAA,iBAAiB,OAAA;AACjB,uHAAA,wBAAwB,OAAA;AACxB,mHAAA,oBAAoB,OAAA;AAatB,iCAA0C;AAAjC,wGAAA,eAAe,OAAA"}

package/dist/markdown/index.d.ts

@@ -0,0 +1,5 @@
+import MarkdownIt from 'markdown-it';
+import type { MarkdownOptions } from '../types.js';
+export declare function createMarkdownRenderer(options?: MarkdownOptions): MarkdownIt;
+export declare function parseMarkdown(markdown: string, options?: MarkdownOptions, env?: Record<string, any>): string;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/markdown/index.ts"],"names":[],"mappings":"AAAC,OAAO,UAAU,MAAM,aAAa,CAAC;AACrC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAKnD,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,eAAoB,GAAG,UAAU,CA0ChF;AAGF,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAQhH"}

package/dist/markdown/index.js

@@ -0,0 +1,70 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMarkdownRenderer = createMarkdownRenderer;
+exports.parseMarkdown = parseMarkdown;
+const markdown_it_1 = __importDefault(require("markdown-it"));
+const concept_js_1 = require("../markdown/plugins/concept.js");
+const idl_js_1 = require("../markdown/plugins/idl.js");
+const cite_js_1 = require("../markdown/plugins/cite.js");
+function createMarkdownRenderer(options = {}) {
+    const md = new markdown_it_1.default({
+        html: false,
+        linkify: options.gfm ?? true,
+        breaks: options.breaks ?? true,
+        typographer: options.smartypants ?? true,
+        xhtmlOut: false,
+    });
+    const headerIds = options.headerIds ?? true;
+    md.renderer.rules.heading_open = (tokens, idx, _opts, env, self) => {
+        void env;
+        const open = tokens[idx];
+        const inline = tokens[idx + 1];
+        const close = tokens[idx + 2];
+        if (open.tag === 'h1') {
+            open.tag = 'h2';
+            if (close && close.type === 'heading_close')
+                close.tag = 'h2';
+        }
+        if (headerIds && inline && inline.type === 'inline') {
+            const id = slugify(inline.content);
+            open.attrSet('id', id);
+        }
+        return self.renderToken(tokens, idx, _opts);
+    };
+    md.renderer.rules.fence = (tokens, idx) => {
+        const token = tokens[idx];
+        const info = (token.info || '').trim();
+        const lang = info ? info.split(/\s+/)[0] : '';
+        const classAttr = lang ? ` class="${md.utils.escapeHtml(lang)}"` : '';
+        const code = md.utils.escapeHtml(token.content);
+        return `<pre${classAttr}><code>${code}</code></pre>\n`;
+    };
+    // Install ReSpec-aligned shorthand plugins
+    md.use(concept_js_1.respecConceptPlugin);
+    md.use(idl_js_1.respecIdlPlugin);
+    md.use(cite_js_1.respecCitePlugin);
+    return md;
+}
+// Optional env bag lets callers read things like __citations
+function parseMarkdown(markdown, options = {}, env) {
+    try {
+        const md = createMarkdownRenderer(options);
+        return md.render(markdown, env);
+    }
+    catch (error) {
+        console.error('Markdown parsing error:', error);
+        return `<p class="error">Error parsing markdown: ${error instanceof Error ? error.message : 'Unknown error'}</p>`;
+    }
+}
+function slugify(content) {
+    return content
+        .toLowerCase()
+        .trim()
+        .replace(/[^\w\s-]/g, '') // Remove non-word characters except spaces and hyphens
+        .replace(/\s+/g, '-') // Replace spaces with hyphens
+        .replace(/-+/g, '-'); // Collapse multiple hyphens
+}
+//# sourceMappingURL=index.js.map

package/dist/markdown/index.js.map

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

package/dist/markdown/plugins/cite.d.ts

@@ -0,0 +1,3 @@
+import type MarkdownIt from 'markdown-it';
+export declare function respecCitePlugin(md: MarkdownIt): void;
+//# sourceMappingURL=cite.d.ts.map

package/dist/markdown/plugins/cite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cite.d.ts","sourceRoot":"","sources":["../../../src/markdown/plugins/cite.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,aAAa,CAAC;AAK1C,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,UAAU,QAuC9C"}

package/dist/markdown/plugins/cite.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.respecCitePlugin = respecCitePlugin;
+function respecCitePlugin(md) {
+    const NAME = 'respec-cite';
+    function tokenize(state, silent) {
+        const pos = state.pos;
+        const src = state.src;
+        // Must start with "[["
+        if (src.charCodeAt(pos) !== 0x5B /*[*/ || src.charCodeAt(pos + 1) !== 0x5B /*[*/)
+            return false;
+        const end = src.indexOf(']]', pos + 2);
+        if (end < 0)
+            return false;
+        if (!silent) {
+            const raw = src.slice(pos + 2, end).trim();
+            const normative = raw.startsWith('!');
+            const id = normative ? raw.slice(1) : raw;
+            // record into env
+            const env = state.env;
+            const col = (env.__citations || (env.__citations = []));
+            col.push({ id, normative });
+            // Render as a link placeholder
+            const open = state.push('link_open', 'a', 1);
+            open.attrSet('data-spec', id);
+            open.attrSet('data-normative', String(normative));
+            const text = state.push('text', '', 0);
+            text.content = `[${id}]`;
+            state.push('link_close', 'a', -1);
+        }
+        state.pos = end + 2;
+        return true;
+    }
+    md.inline.ruler.before('link', NAME, tokenize);
+}
+//# sourceMappingURL=cite.js.map

package/dist/markdown/plugins/cite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cite.js","sourceRoot":"","sources":["../../../src/markdown/plugins/cite.ts"],"names":[],"mappings":";;AAKA,4CAuCC;AAvCD,SAAgB,gBAAgB,CAAC,EAAc;IAC7C,MAAM,IAAI,GAAG,aAAa,CAAC;IAE3B,SAAS,QAAQ,CAAC,KAAkB,EAAE,MAAe;QACnD,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;QACtB,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;QAEtB,uBAAuB;QACvB,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,KAAK,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;QAE/F,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC;QACvC,IAAI,GAAG,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;QAE1B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;YAC3C,MAAM,SAAS,GAAG,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;YACtC,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;YAE1C,kBAAkB;YAClB,MAAM,GAAG,GAAG,KAAK,CAAC,GAAU,CAAC;YAC7B,MAAM,GAAG,GAAe,CAAC,GAAG,CAAC,WAAW,KAAf,GAAG,CAAC,WAAW,GAAK,EAAE,EAAC,CAAC;YACjD,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;YAE5B,+BAA+B;YAC/B,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;YAC7C,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YAC9B,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;YAElD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;YACvC,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,GAAG,CAAC;YAEzB,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;QACpC,CAAC;QAED,KAAK,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;AACjD,CAAC"}

package/dist/markdown/plugins/concept.d.ts

@@ -0,0 +1,3 @@
+import type MarkdownIt from 'markdown-it';
+export declare function respecConceptPlugin(md: MarkdownIt): void;
+//# sourceMappingURL=concept.d.ts.map

package/dist/markdown/plugins/concept.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concept.d.ts","sourceRoot":"","sources":["../../../src/markdown/plugins/concept.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,aAAa,CAAC;AAI1C,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,UAAU,QAiCjD"}

package/dist/markdown/plugins/concept.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.respecConceptPlugin = respecConceptPlugin;
+function respecConceptPlugin(md) {
+    const NAME = 'respec-concept';
+    function tokenize(state, silent) {
+        const pos = state.pos;
+        const src = state.src;
+        // Must start with "[="
+        if (src.charCodeAt(pos) !== 0x5B /*[*/ || src.charCodeAt(pos + 1) !== 0x3D /*=*/)
+            return false;
+        const end = src.indexOf('=]', pos + 2);
+        if (end < 0)
+            return false;
+        if (!silent) {
+            const content = src.slice(pos + 2, end).trim();
+            const tokenOpen = state.push('respec_concept_open', 'a', 1);
+            tokenOpen.attrSet('data-xref', content);
+            const text = state.push('text', '', 0);
+            text.content = content;
+            state.push('respec_concept_close', 'a', -1);
+        }
+        state.pos = end + 2;
+        return true;
+    }
+    md.inline.ruler.before('link', NAME, tokenize);
+    md.renderer.rules.respec_concept_open = (tokens, idx) => `<a data-xref="${md.utils.escapeHtml(tokens[idx].attrGet('data-xref') || '')}">`;
+    md.renderer.rules.respec_concept_close = () => `</a>`;
+}
+//# sourceMappingURL=concept.js.map

package/dist/markdown/plugins/concept.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concept.js","sourceRoot":"","sources":["../../../src/markdown/plugins/concept.ts"],"names":[],"mappings":";;AAIA,kDAiCC;AAjCD,SAAgB,mBAAmB,CAAC,EAAc;IAChD,MAAM,IAAI,GAAG,gBAAgB,CAAC;IAE9B,SAAS,QAAQ,CAAC,KAAkB,EAAE,MAAe;QACnD,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;QACtB,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;QAEtB,uBAAuB;QACvB,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,KAAK,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;QAE/F,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC;QACvC,IAAI,GAAG,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;QAE1B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;YAC/C,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,qBAAqB,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;YAC5D,SAAS,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YAExC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;YACvC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;YAEvB,KAAK,CAAC,IAAI,CAAC,sBAAsB,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;QAC9C,CAAC;QAED,KAAK,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IAE/C,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,mBAAmB,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,CACtD,iBAAiB,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC;IACnF,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,oBAAoB,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC;AACxD,CAAC"}

package/dist/markdown/plugins/idl.d.ts

@@ -0,0 +1,3 @@
+import type MarkdownIt from 'markdown-it';
+export declare function respecIdlPlugin(md: MarkdownIt): void;
+//# sourceMappingURL=idl.d.ts.map

package/dist/markdown/plugins/idl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idl.d.ts","sourceRoot":"","sources":["../../../src/markdown/plugins/idl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,aAAa,CAAC;AAI1C,wBAAgB,eAAe,CAAC,EAAE,EAAE,UAAU,QA6B7C"}

package/dist/markdown/plugins/idl.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.respecIdlPlugin = respecIdlPlugin;
+function respecIdlPlugin(md) {
+    const NAME = 'respec-idl';
+    function tokenize(state, silent) {
+        const pos = state.pos;
+        const src = state.src;
+        // Must start with "{{"
+        if (src.charCodeAt(pos) !== 0x7B /*{*/ || src.charCodeAt(pos + 1) !== 0x7B /*{*/)
+            return false;
+        const end = src.indexOf('}}', pos + 2);
+        if (end < 0)
+            return false;
+        if (!silent) {
+            const content = src.slice(pos + 2, end).trim();
+            const open = state.push('link_open', 'a', 1);
+            open.attrSet('data-idl', content);
+            const text = state.push('text', '', 0);
+            text.content = content;
+            state.push('link_close', 'a', -1);
+        }
+        state.pos = end + 2;
+        return true;
+    }
+    md.inline.ruler.before('emphasis', NAME, tokenize);
+}
+//# sourceMappingURL=idl.js.map

package/dist/markdown/plugins/idl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idl.js","sourceRoot":"","sources":["../../../src/markdown/plugins/idl.ts"],"names":[],"mappings":";;AAIA,0CA6BC;AA7BD,SAAgB,eAAe,CAAC,EAAc;IAC5C,MAAM,IAAI,GAAG,YAAY,CAAC;IAE1B,SAAS,QAAQ,CAAC,KAAkB,EAAE,MAAe;QACnD,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;QACtB,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;QAEtB,uBAAuB;QACvB,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,KAAK,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;QAE/F,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC;QACvC,IAAI,GAAG,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;QAE1B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;YAC/C,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;YAC7C,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YAElC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;YACvC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;YAEvB,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;QACpC,CAAC;QAED,KAAK,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;AACrD,CAAC"}

package/dist/pipeline/passes/boilerplate.d.ts

@@ -0,0 +1,3 @@
+import type { PostprocessOptions } from '@/types';
+export declare function runBoilerplatePass(root: Element, options: PostprocessOptions): void;
+//# sourceMappingURL=boilerplate.d.ts.map

package/dist/pipeline/passes/boilerplate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boilerplate.d.ts","sourceRoot":"","sources":["../../../src/pipeline/passes/boilerplate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAsBlD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,kBAAkB,GAAG,IAAI,CA2CnF"}

package/dist/pipeline/passes/boilerplate.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runBoilerplatePass = runBoilerplatePass;
+function createSection(doc, id, title, content) {
+    const sec = doc.createElement('section');
+    sec.id = id;
+    const h2 = doc.createElement('h2');
+    h2.textContent = title;
+    sec.appendChild(h2);
+    if (content) {
+        const p = doc.createElement('p');
+        p.textContent = content;
+        sec.appendChild(p);
+    }
+    return sec;
+}
+function runBoilerplatePass(root, options) {
+    const bp = options.boilerplate;
+    if (!bp)
+        return;
+    const doc = root.ownerDocument;
+    const mountMode = bp.mount || 'end';
+    // Determine insertion reference node based on mount option
+    let ref = null;
+    if (mountMode === 'before-references') {
+        ref = root.querySelector('#references');
+    }
+    else if (mountMode === 'after-toc') {
+        const toc = root.querySelector('#toc');
+        ref = toc ? toc.nextSibling : null;
+    }
+    const insert = (section) => {
+        if (ref) {
+            root.insertBefore(section, ref);
+        }
+        else {
+            root.appendChild(section);
+        }
+    };
+    const defs = [
+        { key: 'conformance', title: 'Conformance' },
+        { key: 'security', title: 'Security' },
+        { key: 'privacy', title: 'Privacy' },
+    ];
+    for (const { key, title: defaultTitle } of defs) {
+        const opt = bp[key];
+        if (!opt)
+            continue; // not enabled
+        const cfg = typeof opt === 'object' ? opt : {};
+        const id = cfg.id || key;
+        if (root.querySelector(`#${id}`))
+            continue; // avoid overwriting existing sections
+        const title = cfg.title || defaultTitle;
+        const content = cfg.content;
+        const sec = createSection(doc, id, title, content);
+        insert(sec);
+    }
+}
+//# sourceMappingURL=boilerplate.js.map

package/dist/pipeline/passes/boilerplate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boilerplate.js","sourceRoot":"","sources":["../../../src/pipeline/passes/boilerplate.ts"],"names":[],"mappings":";;AAsBA,gDA2CC;AAzDD,SAAS,aAAa,CAAC,GAAa,EAAE,EAAU,EAAE,KAAa,EAAE,OAAgB;IAC/E,MAAM,GAAG,GAAG,GAAG,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;IACzC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC;IACZ,MAAM,EAAE,GAAG,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IACnC,EAAE,CAAC,WAAW,GAAG,KAAK,CAAC;IACvB,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IACpB,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,CAAC,GAAG,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;QACjC,CAAC,CAAC,WAAW,GAAG,OAAO,CAAC;QACxB,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAgB,kBAAkB,CAAC,IAAa,EAAE,OAA2B;IAC3E,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC;IAC/B,IAAI,CAAC,EAAE;QAAE,OAAO;IAEhB,MAAM,GAAG,GAAG,IAAI,CAAC,aAAc,CAAC;IAChC,MAAM,SAAS,GAAG,EAAE,CAAC,KAAK,IAAI,KAAK,CAAC;IAEpC,2DAA2D;IAC3D,IAAI,GAAG,GAAgB,IAAI,CAAC;IAC5B,IAAI,SAAS,KAAK,mBAAmB,EAAE,CAAC;QACtC,GAAG,GAAG,IAAI,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;IAC1C,CAAC;SAAM,IAAI,SAAS,KAAK,WAAW,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QACvC,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC;IACrC,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,OAAoB,EAAE,EAAE;QACtC,IAAI,GAAG,EAAE,CAAC;YACR,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAClC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,IAAI,GAA0E;QAClF,EAAE,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE;QAC5C,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE;QACtC,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;KACrC,CAAC;IAEF,KAAK,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC;QAChD,MAAM,GAAG,GAAI,EAAU,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,CAAC,GAAG;YAAE,SAAS,CAAC,cAAc;QAElC,MAAM,GAAG,GAAa,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACzD,MAAM,EAAE,GAAG,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC;QACzB,IAAI,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,EAAE,CAAC;YAAE,SAAS,CAAC,sCAAsC;QAElF,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,IAAI,YAAY,CAAC;QACxC,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;QAC5B,MAAM,GAAG,GAAG,aAAa,CAAC,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QACnD,MAAM,CAAC,GAAG,CAAC,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/pipeline/passes/diagnostics.d.ts

@@ -0,0 +1,3 @@
+import type { DiagnosticsOptions } from '@/types';
+export declare function runDiagnosticsPass(root: Element, options?: DiagnosticsOptions): string[];
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/pipeline/passes/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../../src/pipeline/passes/diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,MAAM,EAAE,CAwCxF"}

package/dist/pipeline/passes/diagnostics.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runDiagnosticsPass = runDiagnosticsPass;
+function runDiagnosticsPass(root, options) {
+    const warnings = [];
+    const suppressClass = options?.suppressClass ?? 'no-link-warnings';
+    const idsAndLinks = options?.idsAndLinks ?? true;
+    if (idsAndLinks) {
+        // Duplicate IDs
+        const seen = new Map();
+        root.querySelectorAll('[id]').forEach(el => {
+            const id = el.id;
+            if (!id)
+                return;
+            if (seen.has(id)) {
+                if (!el.closest(`.${suppressClass}`)) {
+                    warnings.push(`Duplicate id: "${id}"`);
+                }
+            }
+            else {
+                seen.set(id, el);
+            }
+        });
+        // Anchors missing href
+        const anchors = root.querySelectorAll('a');
+        anchors.forEach(a => {
+            if (a.closest(`.${suppressClass}`))
+                return;
+            const hasHref = a.hasAttribute('href') && a.getAttribute('href') !== '';
+            const isPlaceholder = a.hasAttribute('data-xref') || a.hasAttribute('data-idl') || a.hasAttribute('data-spec');
+            if (!hasHref && isPlaceholder) {
+                const label = a.getAttribute('data-xref') ||
+                    a.getAttribute('data-idl') ||
+                    a.getAttribute('data-spec') ||
+                    a.textContent ||
+                    '';
+                warnings.push(`Unresolved link placeholder: "${label.trim()}"`);
+            }
+        });
+    }
+    return warnings;
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/pipeline/passes/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../../src/pipeline/passes/diagnostics.ts"],"names":[],"mappings":";;AAEA,gDAwCC;AAxCD,SAAgB,kBAAkB,CAAC,IAAa,EAAE,OAA4B;IAC5E,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,aAAa,GAAG,OAAO,EAAE,aAAa,IAAI,kBAAkB,CAAC;IACnE,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,IAAI,CAAC;IAEjD,IAAI,WAAW,EAAE,CAAC;QAChB,gBAAgB;QAChB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAmB,CAAC;QACxC,IAAI,CAAC,gBAAgB,CAAc,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE;YACtD,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;YACjB,IAAI,CAAC,EAAE;gBAAE,OAAO;YAChB,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;gBACjB,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,aAAa,EAAE,CAAC,EAAE,CAAC;oBACrC,QAAQ,CAAC,IAAI,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC;gBACzC,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;YACnB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,uBAAuB;QACvB,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,CAAoB,GAAG,CAAC,CAAC;QAC9D,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;YAClB,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,aAAa,EAAE,CAAC;gBAAE,OAAO;YAC3C,MAAM,OAAO,GAAG,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YACxE,MAAM,aAAa,GACjB,CAAC,CAAC,YAAY,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;YAC3F,IAAI,CAAC,OAAO,IAAI,aAAa,EAAE,CAAC;gBAC9B,MAAM,KAAK,GACT,CAAC,CAAC,YAAY,CAAC,WAAW,CAAC;oBAC3B,CAAC,CAAC,YAAY,CAAC,UAAU,CAAC;oBAC1B,CAAC,CAAC,YAAY,CAAC,WAAW,CAAC;oBAC3B,CAAC,CAAC,WAAW;oBACb,EAAE,CAAC;gBACL,QAAQ,CAAC,IAAI,CAAC,iCAAiC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAClE,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/pipeline/passes/idl.d.ts

@@ -0,0 +1,4 @@
+import type { PostprocessOptions } from '@/types';
+/** Public pass */
+export declare function runIdlPass(root: Element, options: PostprocessOptions): string[];
+//# sourceMappingURL=idl.d.ts.map

package/dist/pipeline/passes/idl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idl.d.ts","sourceRoot":"","sources":["../../../src/pipeline/passes/idl.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAsJlD,kBAAkB;AAClB,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,kBAAkB,GAAG,MAAM,EAAE,CAM/E"}

package/dist/pipeline/passes/idl.js

@@ -0,0 +1,188 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runIdlPass = runIdlPass;
+const WebIDL2 = __importStar(require("webidl2"));
+function norm(s) {
+    return s.toLowerCase().replace(/\s+/g, ' ').trim();
+}
+function slug(s) {
+    return s.trim().toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '');
+}
+function uniqueId(doc, base) {
+    let id = base;
+    let i = 2;
+    while (doc.getElementById(id)) {
+        id = `${base}-${i++}`;
+    }
+    return id;
+}
+function collectTargetsFromAst(ast) {
+    const defs = [];
+    const addTop = (name) => {
+        const key = norm(name);
+        defs.push({ id: `idl-${slug(name)}`, key, text: name });
+    };
+    const addMember = (ifc, mem) => {
+        const key = `${norm(ifc)}.${norm(mem)}`;
+        defs.push({ id: `idl-${slug(ifc)}-${slug(mem)}`, key, text: `${ifc}.${mem}` });
+    };
+    for (const d of ast) {
+        switch (d.type) {
+            case 'interface':
+            case 'interface mixin':
+            case 'namespace':
+            case 'dictionary':
+            case 'callback interface':
+            case 'callback':
+            case 'typedef':
+            case 'enum': {
+                if (!('name' in d) || !d.name)
+                    break;
+                addTop(d.name);
+                // members where applicable
+                if ('members' in d && Array.isArray(d.members)) {
+                    for (const m of d.members) {
+                        if (m.type === 'attribute' && m.name)
+                            addMember(d.name, m.name);
+                        else if (m.type === 'operation' && m.name)
+                            addMember(d.name, m.name);
+                        else if (m.type === 'const' && m.name)
+                            addMember(d.name, m.name);
+                        else if (m.type === 'field' && m.name)
+                            addMember(d.name, m.name);
+                    }
+                }
+                break;
+            }
+            // 'includes' doesn’t add new top-level names — skip
+        }
+    }
+    return { defs };
+}
+/** Insert hidden anchors for each target before the given <pre>. */
+function insertAnchorsBefore(pre, targets) {
+    if (!targets.length)
+        return;
+    const doc = pre.ownerDocument;
+    const wrapper = doc.createElement('div');
+    wrapper.className = 'idl-anchors';
+    wrapper.hidden = true; // JS property for broader envs
+    for (const t of targets) {
+        const a = doc.createElement('a');
+        a.id = uniqueId(doc, t.id);
+        a.textContent = t.text;
+        wrapper.appendChild(a);
+    }
+    pre.parentNode?.insertBefore(wrapper, pre);
+}
+/** Try to parse a string of IDL; return targets or throw. */
+function parseIdlToTargets(idl) {
+    const ast = WebIDL2.parse(idl);
+    return collectTargetsFromAst(ast).defs;
+}
+/** Find candidate <pre> blocks containing IDL. */
+function findIdlBlocks(root) {
+    const blocks = [];
+    const pres = root.querySelectorAll('pre');
+    pres.forEach((pre) => {
+        const cls = (pre.getAttribute('class') || '').toLowerCase();
+        const looksIdlClass = /\b(idl|language-idl)\b/.test(cls);
+        const code = pre.querySelector('code');
+        const text = (code ? code.textContent : pre.textContent) || '';
+        const maybeIdl = looksIdlClass || /^\s*(interface|dictionary|enum|namespace|callback|typedef)\b/.test(text);
+        if (maybeIdl && text.trim())
+            blocks.push(pre);
+    });
+    return blocks;
+}
+/** Build a map of resolvable IDL keys -> href based on parsed blocks. */
+function buildIdlIndex(root, warnings) {
+    const map = new Map();
+    const blocks = findIdlBlocks(root);
+    for (const pre of blocks) {
+        const code = pre.querySelector('code');
+        const idl = (code ? code.textContent : pre.textContent) || '';
+        try {
+            const targets = parseIdlToTargets(idl);
+            insertAnchorsBefore(pre, targets);
+            for (const t of targets) {
+                const href = `#${t.id}`;
+                if (!map.has(t.key))
+                    map.set(t.key, href);
+            }
+        }
+        catch (e) {
+            const msg = e && e.message ? e.message : String(e);
+            warnings.push(`IDL parse error: ${msg}`);
+        }
+    }
+    return map;
+}
+/** Resolve <a data-idl> anchors using the built index. */
+function resolveIdlLinks(root, index, warnings, suppressClass) {
+    const anchors = root.querySelectorAll('a[data-idl]');
+    Array.from(anchors).forEach((a) => {
+        if (a.closest(`.${suppressClass}`))
+            return;
+        const raw = a.getAttribute('data-idl') || '';
+        const term = raw.trim();
+        const hasMember = term.includes('.');
+        let key = '';
+        if (hasMember) {
+            const [iface, member] = term.split('.', 2);
+            key = `${norm(iface)}.${norm(member)}`;
+        }
+        else {
+            key = norm(term);
+        }
+        const href = index.get(key);
+        if (href) {
+            a.setAttribute('href', href);
+        }
+        else {
+            warnings.push(`Unresolved IDL link: "${term}"`);
+        }
+    });
+}
+/** Public pass */
+function runIdlPass(root, options) {
+    const warnings = [];
+    const suppressClass = options.diagnostics?.suppressClass ?? 'no-link-warnings';
+    const index = buildIdlIndex(root, warnings);
+    resolveIdlLinks(root, index, warnings, suppressClass);
+    return warnings;
+}
+//# sourceMappingURL=idl.js.map