@zigrivers/scaffold 3.28.0 → 3.29.0

package/dist/guides/loader.test.d.ts.map

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

package/dist/guides/loader.test.js

@@ -0,0 +1,85 @@
+import { describe, it, expect, afterEach } from 'vitest';
+import path from 'node:path';
+import fs from 'node:fs';
+import os from 'node:os';
+import { extractGuideFrontmatter, buildGuidesIndex } from './loader.js';
+const tmpDirs = [];
+function tmpGuides(files) {
+    const root = fs.mkdtempSync(path.join(os.tmpdir(), 'guides-'));
+    tmpDirs.push(root);
+    for (const [rel, body] of Object.entries(files)) {
+        const full = path.join(root, rel);
+        fs.mkdirSync(path.dirname(full), { recursive: true });
+        fs.writeFileSync(full, body);
+    }
+    return root;
+}
+afterEach(() => {
+    for (const d of tmpDirs) {
+        try {
+            fs.rmSync(d, { recursive: true, force: true });
+        }
+        catch { /* ignore */ }
+    }
+    tmpDirs.length = 0;
+});
+const VALID_FM = `---
+title: MMR Reference
+topic: mmr
+description: Multi-model review
+category: tools
+order: 10
+---
+
+# Body
+`;
+describe('extractGuideFrontmatter', () => {
+    it('parses required fields', () => {
+        const fm = extractGuideFrontmatter(VALID_FM);
+        expect(fm).toEqual({
+            title: 'MMR Reference', topic: 'mmr',
+            description: 'Multi-model review', category: 'tools', order: 10,
+        });
+    });
+    it('returns null when frontmatter missing required fields', () => {
+        expect(extractGuideFrontmatter('# no frontmatter')).toBeNull();
+    });
+});
+describe('buildGuidesIndex', () => {
+    it('indexes guide dirs by topic and skips invalid ones', () => {
+        const root = tmpGuides({
+            'mmr/index.md': VALID_FM,
+            'broken/index.md': '# missing frontmatter',
+        });
+        const idx = buildGuidesIndex(root);
+        expect([...idx.keys()]).toEqual(['mmr']);
+        const entry = idx.get('mmr');
+        expect(entry.topic).toBe('mmr');
+        expect(entry.mdPath).toBe(path.join(root, 'mmr', 'index.md'));
+        expect(entry.htmlPath).toBe(path.join(root, 'mmr', 'index.html'));
+    });
+    it('returns empty map when dir does not exist', () => {
+        expect(buildGuidesIndex(path.join(os.tmpdir(), 'nope-xyz')).size).toBe(0);
+    });
+    it('skips a guide dir whose frontmatter topic does not match the directory name', () => {
+        const root = tmpGuides({
+            'mmr/index.md': VALID_FM,
+            'not-mmr/index.md': VALID_FM, // frontmatter says topic: mmr, but dir is not-mmr
+        });
+        const idx = buildGuidesIndex(root);
+        expect([...idx.keys()]).toEqual(['mmr']);
+        expect(idx.has('not-mmr')).toBe(false);
+    });
+});
+describe('extractGuideFrontmatter — trailing-whitespace closing delimiter', () => {
+    it('parses frontmatter when closing --- has trailing whitespace', () => {
+        const lines = ['---', 'title: MMR Reference', 'topic: mmr',
+            'description: Multi-model review', 'category: tools', 'order: 10', '---   ', '', '# Body', ''];
+        const content = lines.join('\n');
+        const fm = extractGuideFrontmatter(content);
+        expect(fm).not.toBeNull();
+        expect(fm.title).toBe('MMR Reference');
+        expect(fm.order).toBe(10);
+    });
+});
+//# sourceMappingURL=loader.test.js.map

package/dist/guides/loader.test.js.map

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

package/dist/guides/mermaid-sanitize.test.d.ts

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

package/dist/guides/mermaid-sanitize.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mermaid-sanitize.test.d.ts","sourceRoot":"","sources":["../../src/guides/mermaid-sanitize.test.ts"],"names":[],"mappings":""}

package/dist/guides/mermaid-sanitize.test.js

@@ -0,0 +1,57 @@
+import { describe, it, expect } from 'vitest';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { renderGuideBody } from './render.js';
+import { remarkMermaid } from './mermaid.js';
+describe('mermaid SVG through full render pipeline', () => {
+    it('keeps <rect> and <svg> but strips <script> (double-defence: sanitizeSvg + rehype-sanitize)', async () => {
+        // Stub renderer returns SVG that contains a script tag (to prove double-defence).
+        const stubbedRender = async (_source) => '<svg viewBox="0 0 100 50"><rect x="0" y="0" width="100" height="50"/><script>evil()</script></svg>';
+        const md = '```mermaid\nflowchart LR\nA-->B\n```\n';
+        // remarkMermaid needs a guideDir for cache. We pass the stub renderer so no browser is involved.
+        const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'mmd-san-'));
+        const { body } = await renderGuideBody(md, {
+            plugins: [remarkMermaid({ guideDir: dir, render: stubbedRender })],
+        });
+        // SVG structural tags must survive rehype-sanitize
+        expect(body).toContain('<svg');
+        expect(body).toContain('<rect');
+        // <script> must be stripped — sanitizeSvg removes it before rehype-sanitize sees it,
+        // and rehype-sanitize would strip any that somehow slipped through.
+        expect(body).not.toContain('<script');
+        expect(body).not.toContain('evil()');
+        // figure wrapper must survive
+        expect(body).toContain('class="mermaid"');
+    });
+    it('preserves mermaid arrowhead structure (marker/use/marker-end) through sanitize', async () => {
+        // Realistic mermaid-style SVG with arrowhead wiring: <defs><marker …>, marker-end="url(#id)", <use href="#id">
+        const stubbedRender = async (_source) => '<svg viewBox="0 0 100 50">' +
+            '<defs>' +
+            '<marker id="arrow" markerWidth="10" markerHeight="10" orient="auto" refX="5" refY="5">' +
+            '<path d="M0,0 L10,5 L0,10 z"/>' +
+            '</marker>' +
+            '</defs>' +
+            '<path d="M0,25 L90,25" marker-end="url(#arrow)" stroke="black"/>' +
+            '<use href="#arrow"/>' +
+            '</svg>';
+        const md = '```mermaid\nflowchart LR\nA-->B\n```\n';
+        const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'mmd-arrow-'));
+        const { body } = await renderGuideBody(md, {
+            plugins: [remarkMermaid({ guideDir: dir, render: stubbedRender })],
+        });
+        // <marker> element and its key attributes must survive
+        expect(body).toContain('<marker');
+        expect(body).toContain('id="arrow"');
+        expect(body).toContain('orient="auto"');
+        // marker-end attribute wiring the path to the marker must survive
+        // hast/rehype-stringify preserves SVG presentation attributes in their original hyphenated form
+        expect(body).toContain('marker-end="url(#arrow)"');
+        // <use> element referencing the marker must survive
+        expect(body).toContain('<use');
+        expect(body).toContain('href="#arrow"');
+        // The path element itself must survive
+        expect(body).toContain('<path');
+    });
+});
+//# sourceMappingURL=mermaid-sanitize.test.js.map

package/dist/guides/mermaid-sanitize.test.js.map

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

package/dist/guides/mermaid.d.ts

@@ -0,0 +1,18 @@
+import type { AnyPlugin } from './render.js';
+export declare function computeFingerprint(source: string): string;
+export declare function sanitizeSvg(svg: string): string;
+export declare function renderMermaid(source: string): Promise<string>;
+export interface ResolveArgs {
+    guideDir: string;
+    diagramId: string;
+    source: string;
+    render?: (source: string) => Promise<string>;
+}
+export declare function resolveDiagram(args: ResolveArgs): Promise<string>;
+export declare function pruneDiagrams(guideDir: string, keepIds: string[]): void;
+export declare function remarkMermaid(opts: {
+    guideDir: string;
+    render?: (s: string) => Promise<string>;
+    collect?: string[];
+}): AnyPlugin;
+//# sourceMappingURL=mermaid.d.ts.map

package/dist/guides/mermaid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mermaid.d.ts","sourceRoot":"","sources":["../../src/guides/mermaid.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAY5C,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAKzD;AAGD,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM/C;AAGD,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAkBnE;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;CAC7C;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAkCvE;AAGD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAkBvE;AAMD,wBAAgB,aAAa,CAAC,IAAI,EAAE;IAClC,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IACvC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CACnB,GAAG,SAAS,CAwBZ"}

package/dist/guides/mermaid.js

@@ -0,0 +1,137 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { createHash } from 'node:crypto';
+import { execFileSync } from 'node:child_process';
+import { visit } from 'unist-util-visit';
+const MMDC_VERSION_FINGERPRINT = 'mmdc12'; // bump when render options/version change
+const RENDER_OPTS = ['-t', 'neutral', '-b', 'transparent'];
+// Mermaid config passed to mmdc via `-c`. `htmlLabels: false` forces node/edge
+// labels to render as native SVG <text>/<tspan> instead of <foreignObject> HTML.
+// This is REQUIRED: sanitizeSvg() strips <foreignObject> for security, so with
+// the mmdc default (HTML labels) every node label would vanish, leaving empty
+// boxes. The fingerprint includes this JSON so cache invalidates when it changes.
+const MERMAID_CONFIG = JSON.stringify({ htmlLabels: false, flowchart: { htmlLabels: false } });
+export function computeFingerprint(source) {
+    return createHash('sha256')
+        .update(`${MMDC_VERSION_FINGERPRINT}\n${RENDER_OPTS.join(' ')}\n${MERMAID_CONFIG}\n${source}`)
+        .digest('hex')
+        .slice(0, 16);
+}
+// Strict SVG hardening: remove dangerous elements/attrs.
+export function sanitizeSvg(svg) {
+    return svg
+        .replace(/<script[\s\S]*?<\/script>/gi, '')
+        .replace(/<foreignObject[\s\S]*?<\/foreignObject>/gi, '')
+        .replace(/\son\w+\s*=\s*("[^"]*"|'[^']*'|[^\s>]+)/gi, '')
+        .replace(/((?:xlink:)?href)\s*=\s*("javascript:[^"]*"|'javascript:[^']*')/gi, '');
+}
+// Default renderer: shells out to mmdc (build-time; needs a browser).
+export async function renderMermaid(source) {
+    const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'mmdc-'));
+    try {
+        const inFile = path.join(tmp, 'in.mmd');
+        const outFile = path.join(tmp, 'out.svg');
+        const cfgFile = path.join(tmp, 'config.json');
+        fs.writeFileSync(inFile, source);
+        fs.writeFileSync(cfgFile, MERMAID_CONFIG);
+        const npx = process.platform === 'win32' ? 'npx.cmd' : 'npx';
+        execFileSync(npx, ['--no-install', 'mmdc', '-i', inFile, '-o', outFile, '-c', cfgFile, ...RENDER_OPTS], { stdio: 'pipe' });
+        return fs.readFileSync(outFile, 'utf8');
+    }
+    finally {
+        fs.rmSync(tmp, { recursive: true, force: true });
+    }
+}
+export async function resolveDiagram(args) {
+    const { guideDir, diagramId, source } = args;
+    const render = args.render ?? renderMermaid;
+    const cacheDir = path.join(guideDir, '.diagrams');
+    const svgPath = path.join(cacheDir, `${diagramId}.svg`);
+    const manifestPath = path.join(cacheDir, 'manifest.json');
+    const fp = computeFingerprint(source);
+    let manifest = {};
+    if (fs.existsSync(manifestPath)) {
+        try {
+            manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
+        }
+        catch {
+            // Corrupt manifest (e.g. partially-written from a crashed build) — treat as empty.
+            manifest = {};
+        }
+    }
+    if (manifest[diagramId] === fp && fs.existsSync(svgPath)) {
+        return fs.readFileSync(svgPath, 'utf8');
+    }
+    let raw;
+    try {
+        raw = await render(source);
+    }
+    catch (e) {
+        throw new Error(`mermaid render failed for "${diagramId}" ` +
+            `(no browser? install per dev-setup.md). Cache: ${svgPath}\n${String(e)}`);
+    }
+    const clean = sanitizeSvg(raw);
+    fs.mkdirSync(cacheDir, { recursive: true });
+    fs.writeFileSync(svgPath, clean);
+    manifest[diagramId] = fp;
+    fs.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2) + '\n');
+    return clean;
+}
+// Prune cached SVGs whose diagramId is no longer present.
+export function pruneDiagrams(guideDir, keepIds) {
+    const cacheDir = path.join(guideDir, '.diagrams');
+    if (!fs.existsSync(cacheDir))
+        return;
+    const keep = new Set(keepIds);
+    for (const f of fs.readdirSync(cacheDir)) {
+        if (f.endsWith('.svg') && !keep.has(f.replace(/\.svg$/, '')))
+            fs.rmSync(path.join(cacheDir, f));
+    }
+    const manifestPath = path.join(cacheDir, 'manifest.json');
+    if (fs.existsSync(manifestPath)) {
+        let m = {};
+        try {
+            m = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
+        }
+        catch {
+            // Corrupt manifest — self-heal by writing back an empty one after pruning.
+        }
+        for (const k of Object.keys(m))
+            if (!keep.has(k))
+                delete m[k];
+        fs.writeFileSync(manifestPath, JSON.stringify(m, null, 2) + '\n');
+    }
+}
+// remark plugin: replace ```mermaid code blocks with the resolved inline SVG.
+// Diagram id = `diagram-<n>` by document order.
+// Diagrams are resolved SEQUENTIALLY to avoid concurrent read+write races on the
+// shared manifest.json (each resolveDiagram reads and then writes the file).
+export function remarkMermaid(opts) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    return () => async (tree) => {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const jobs = [];
+        let n = 0;
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        visit(tree, 'code', (node) => {
+            if (node.lang !== 'mermaid')
+                return;
+            const diagramId = `diagram-${n++}`;
+            if (opts.collect)
+                opts.collect.push(diagramId);
+            jobs.push({ node, diagramId, source: node.value });
+        });
+        for (const job of jobs) {
+            const svg = await resolveDiagram({
+                guideDir: opts.guideDir,
+                diagramId: job.diagramId,
+                source: job.source,
+                render: opts.render,
+            });
+            job.node.type = 'html';
+            job.node.value = `<figure class="mermaid">${svg}</figure>`;
+        }
+    };
+}
+//# sourceMappingURL=mermaid.js.map

package/dist/guides/mermaid.js.map

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

package/dist/guides/mermaid.test.d.ts

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

package/dist/guides/mermaid.test.d.ts.map

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

package/dist/guides/mermaid.test.js

@@ -0,0 +1,105 @@
+import { describe, it, expect, vi } from 'vitest';
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { sanitizeSvg, resolveDiagram, computeFingerprint, pruneDiagrams, remarkMermaid } from './mermaid.js';
+import { renderGuideBody } from './render.js';
+describe('sanitizeSvg', () => {
+    it('strips script, foreignObject, on* and javascript hrefs', () => {
+        const dirty = '<svg><script>x()</script><foreignObject></foreignObject>' +
+            '<a xlink:href="javascript:x()" onclick="y()"><rect/></a></svg>';
+        const clean = sanitizeSvg(dirty);
+        expect(clean).not.toContain('<script');
+        expect(clean).not.toContain('foreignObject');
+        expect(clean).not.toContain('onclick');
+        expect(clean).not.toContain('javascript:');
+        expect(clean).toContain('<rect');
+    });
+});
+describe('resolveDiagram', () => {
+    it('renders on a cache miss and writes the SVG + manifest', async () => {
+        const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'mmd-'));
+        const render = vi.fn(async () => '<svg><rect/></svg>');
+        const svg = await resolveDiagram({ guideDir: dir, diagramId: 'd0', source: 'flowchart LR\nA-->B', render });
+        expect(render).toHaveBeenCalledTimes(1);
+        expect(svg).toContain('<rect');
+        expect(fs.existsSync(path.join(dir, '.diagrams', 'd0.svg'))).toBe(true);
+        const manifest = JSON.parse(fs.readFileSync(path.join(dir, '.diagrams', 'manifest.json'), 'utf8'));
+        expect(manifest.d0).toBe(computeFingerprint('flowchart LR\nA-->B'));
+    });
+    it('uses cache on a hit (no render call)', async () => {
+        const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'mmd-'));
+        const render = vi.fn(async () => '<svg><rect/></svg>');
+        await resolveDiagram({ guideDir: dir, diagramId: 'd0', source: 'X', render });
+        render.mockClear();
+        const svg = await resolveDiagram({ guideDir: dir, diagramId: 'd0', source: 'X', render });
+        expect(render).not.toHaveBeenCalled();
+        expect(svg).toContain('<rect');
+    });
+});
+describe('pruneDiagrams', () => {
+    it('removes unlisted SVGs and drops their manifest entries, keeping listed ones', () => {
+        const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'mmd-prune-'));
+        const cacheDir = path.join(dir, '.diagrams');
+        fs.mkdirSync(cacheDir);
+        fs.writeFileSync(path.join(cacheDir, 'keep.svg'), '<svg/>');
+        fs.writeFileSync(path.join(cacheDir, 'drop.svg'), '<svg/>');
+        fs.writeFileSync(path.join(cacheDir, 'manifest.json'), JSON.stringify({ keep: 'fp-keep', drop: 'fp-drop' }, null, 2) + '\n');
+        pruneDiagrams(dir, ['keep']);
+        expect(fs.existsSync(path.join(cacheDir, 'keep.svg'))).toBe(true);
+        expect(fs.existsSync(path.join(cacheDir, 'drop.svg'))).toBe(false);
+        const manifest = JSON.parse(fs.readFileSync(path.join(cacheDir, 'manifest.json'), 'utf8'));
+        expect(manifest).toEqual({ keep: 'fp-keep' });
+    });
+    it('self-heals a corrupt manifest (writes a pruned-empty manifest)', () => {
+        const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'mmd-prune-corrupt-'));
+        const cacheDir = path.join(dir, '.diagrams');
+        fs.mkdirSync(cacheDir);
+        fs.writeFileSync(path.join(cacheDir, 'drop.svg'), '<svg/>');
+        fs.writeFileSync(path.join(cacheDir, 'manifest.json'), '{bad json}');
+        // Should not throw; drop.svg removed; manifest rewritten as {}
+        expect(() => pruneDiagrams(dir, [])).not.toThrow();
+        expect(fs.existsSync(path.join(cacheDir, 'drop.svg'))).toBe(false);
+        const manifest = JSON.parse(fs.readFileSync(path.join(cacheDir, 'manifest.json'), 'utf8'));
+        expect(manifest).toEqual({});
+    });
+});
+describe('remarkMermaid — sequential manifest writes', () => {
+    it('resolves two mermaid blocks and writes both entries to the manifest', async () => {
+        const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'mmd-seq-'));
+        let callCount = 0;
+        const render = vi.fn(async () => {
+            callCount++;
+            return `<svg><rect id="r${callCount}"/></svg>`;
+        });
+        const md = [
+            '```mermaid',
+            'flowchart LR\nA-->B',
+            '```',
+            '',
+            '```mermaid',
+            'flowchart LR\nC-->D',
+            '```',
+        ].join('\n') + '\n';
+        const collected = [];
+        const plugin = remarkMermaid({ guideDir: dir, render, collect: collected });
+        const { body } = await renderGuideBody(md, { plugins: [plugin] });
+        // Both diagrams rendered and inlined
+        expect(body).toContain('class="mermaid"');
+        expect(render).toHaveBeenCalledTimes(2);
+        // collect receives the exact ids the plugin assigned, in order
+        expect(collected).toEqual(['diagram-0', 'diagram-1']);
+        // Both entries written to the manifest (no clobber from race)
+        const manifestPath = path.join(dir, '.diagrams', 'manifest.json');
+        expect(fs.existsSync(manifestPath)).toBe(true);
+        const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
+        expect(Object.keys(manifest)).toContain('diagram-0');
+        expect(Object.keys(manifest)).toContain('diagram-1');
+        // pruneDiagrams with the collected ids keeps both SVGs (no accidental deletion)
+        const { pruneDiagrams: prune } = await import('./mermaid.js');
+        prune(dir, collected);
+        expect(fs.existsSync(path.join(dir, '.diagrams', 'diagram-0.svg'))).toBe(true);
+        expect(fs.existsSync(path.join(dir, '.diagrams', 'diagram-1.svg'))).toBe(true);
+    });
+});
+//# sourceMappingURL=mermaid.test.js.map

package/dist/guides/mermaid.test.js.map

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

package/dist/guides/render.d.ts

@@ -0,0 +1,12 @@
+import type { Plugin } from 'unified';
+import type { TocHeading } from './types.js';
+export type AnyPlugin = Plugin<any[], any, any>;
+export interface RenderOptions {
+    /** remark-phase plugins only; injected after remark-directive and before remark-rehype */
+    plugins?: AnyPlugin[];
+}
+export declare function renderGuideBody(markdown: string, opts?: RenderOptions): Promise<{
+    body: string;
+    headings: TocHeading[];
+}>;
+//# sourceMappingURL=render.d.ts.map

package/dist/guides/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/guides/render.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAWrC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAI5C,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,CAAA;AAE/C,MAAM,WAAW,aAAa;IAC5B,0FAA0F;IAC1F,OAAO,CAAC,EAAE,SAAS,EAAE,CAAA;CACtB;AA+BD,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,aAAkB,GACvB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,UAAU,EAAE,CAAA;CAAE,CAAC,CAgBnD"}

package/dist/guides/render.js

@@ -0,0 +1,58 @@
+import { unified } from 'unified';
+import remarkParse from 'remark-parse';
+import remarkGfm from 'remark-gfm';
+import remarkDirective from 'remark-directive';
+import remarkRehype from 'remark-rehype';
+import rehypeRaw from 'rehype-raw';
+import rehypeSanitize from 'rehype-sanitize';
+import rehypeStringify from 'rehype-stringify';
+import { visit } from 'unist-util-visit';
+import { toString as mdToString } from 'mdast-util-to-string';
+import { guideSanitizeSchema } from './sanitize.js';
+function slug(text) {
+    return text.toLowerCase().trim().replace(/[^\w\s-]/g, '').replace(/[_\s]+/g, '-');
+}
+function stripFrontmatter(md) {
+    const lines = md.split(/\r?\n/);
+    if (lines[0]?.trim() !== '---')
+        return md;
+    const close = lines.findIndex((l, i) => i > 0 && l.trim() === '---');
+    if (close === -1)
+        return md;
+    return lines.slice(close + 1).join('\n');
+}
+function collectHeadings(out) {
+    return () => (tree) => {
+        visit(tree, 'heading', (node) => {
+            const h = node;
+            if (h.depth !== 2 && h.depth !== 3)
+                return;
+            const text = mdToString(h);
+            const id = slug(text);
+            h.data = h.data ?? {};
+            h.data.hProperties = {
+                ...(h.data.hProperties ?? {}),
+                id,
+            };
+            out.push({ depth: h.depth, text, id });
+        });
+    };
+}
+export async function renderGuideBody(markdown, opts = {}) {
+    const headings = [];
+    const src = stripFrontmatter(markdown);
+    // Build processor with loose typing to avoid unified's complex generics
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let proc = unified().use(remarkParse).use(remarkGfm).use(remarkDirective);
+    for (const p of opts.plugins ?? [])
+        proc = proc.use(p);
+    proc = proc.use(collectHeadings(headings));
+    const file = await proc
+        .use(remarkRehype, { allowDangerousHtml: true })
+        .use(rehypeRaw)
+        .use(rehypeSanitize, guideSanitizeSchema)
+        .use(rehypeStringify)
+        .process(src);
+    return { body: String(file), headings };
+}
+//# sourceMappingURL=render.js.map

package/dist/guides/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/guides/render.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAEjC,OAAO,WAAW,MAAM,cAAc,CAAA;AACtC,OAAO,SAAS,MAAM,YAAY,CAAA;AAClC,OAAO,eAAe,MAAM,kBAAkB,CAAA;AAC9C,OAAO,YAAY,MAAM,eAAe,CAAA;AACxC,OAAO,SAAS,MAAM,YAAY,CAAA;AAClC,OAAO,cAAc,MAAM,iBAAiB,CAAA;AAC5C,OAAO,eAAe,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AACxC,OAAO,EAAE,QAAQ,IAAI,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAG7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AAUnD,SAAS,IAAI,CAAC,IAAY;IACxB,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAA;AACnF,CAAC;AAED,SAAS,gBAAgB,CAAC,EAAU;IAClC,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IAC/B,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,KAAK;QAAE,OAAO,EAAE,CAAA;IACzC,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,KAAK,CAAC,CAAA;IACpE,IAAI,KAAK,KAAK,CAAC,CAAC;QAAE,OAAO,EAAE,CAAA;IAC3B,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAC1C,CAAC;AAED,SAAS,eAAe,CAAC,GAAiB;IACxC,OAAO,GAAG,EAAE,CAAC,CAAC,IAAiC,EAAE,EAAE;QACjD,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE;YAC9B,MAAM,CAAC,GAAG,IAAe,CAAA;YACzB,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC;gBAAE,OAAM;YAC1C,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,CAAA;YAC1B,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,CAAA;YACrB,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,EAAE,CACpB;YAAC,CAAC,CAAC,IAAgC,CAAC,WAAW,GAAG;gBACjD,GAAG,CAAE,CAAC,CAAC,IAAgC,CAAC,WAAsC,IAAI,EAAE,CAAC;gBACrF,EAAE;aACH,CAAA;YACD,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAA;QACxC,CAAC,CAAC,CAAA;IACJ,CAAC,CAAA;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,QAAgB,EAChB,OAAsB,EAAE;IAExB,MAAM,QAAQ,GAAiB,EAAE,CAAA;IACjC,MAAM,GAAG,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAA;IAEtC,wEAAwE;IACxE,8DAA8D;IAC9D,IAAI,IAAI,GAAQ,OAAO,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,CAAA;IAC9E,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,IAAI,EAAE;QAAE,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;IACtD,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAA;IAC1C,MAAM,IAAI,GAAG,MAAM,IAAI;SACpB,GAAG,CAAC,YAAY,EAAE,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC;SAC/C,GAAG,CAAC,SAAS,CAAC;SACd,GAAG,CAAC,cAAc,EAAE,mBAAmB,CAAC;SACxC,GAAG,CAAC,eAAe,CAAC;SACpB,OAAO,CAAC,GAAG,CAAC,CAAA;IACf,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAA;AACzC,CAAC"}

package/dist/guides/render.test.d.ts

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

package/dist/guides/render.test.d.ts.map

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

package/dist/guides/render.test.js

@@ -0,0 +1,46 @@
+import { describe, it, expect } from 'vitest';
+import { renderGuideBody } from './render.js';
+describe('renderGuideBody', () => {
+    it('renders headings, paragraphs, and a GFM table; strips frontmatter', async () => {
+        const md = `---
+title: T
+topic: t
+description: d
+category: c
+order: 1
+---
+
+## Section One
+
+Hello **world**.
+
+| A | B |
+|---|---|
+| 1 | 2 |
+`;
+        const { body, headings } = await renderGuideBody(md);
+        expect(body).toContain('<h2');
+        expect(body).toContain('Section One');
+        expect(body).toContain('<table>');
+        expect(body).not.toContain('title: T');
+        expect(headings).toEqual([{ depth: 2, text: 'Section One', id: 'section-one' }]);
+    });
+    it('strips a raw <script> tag in prose', async () => {
+        const { body } = await renderGuideBody('Hi\n\n<script>alert(1)</script>\n');
+        expect(body).not.toContain('<script>');
+    });
+    it('gives h2/h3 stable slug ids', async () => {
+        const { headings } = await renderGuideBody('## Foo Bar\n\n### Baz Qux\n');
+        expect(headings).toEqual([
+            { depth: 2, text: 'Foo Bar', id: 'foo-bar' },
+            { depth: 3, text: 'Baz Qux', id: 'baz-qux' },
+        ]);
+    });
+    it('strips frontmatter whose closing delimiter has trailing whitespace', async () => {
+        const md = '---\ntitle: Leaky\n---  \n\n## Body\n';
+        const { body } = await renderGuideBody(md);
+        expect(body).not.toContain('title:');
+        expect(body).toContain('Body');
+    });
+});
+//# sourceMappingURL=render.test.js.map

package/dist/guides/render.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.test.js","sourceRoot":"","sources":["../../src/guides/render.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAE7C,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,mEAAmE,EAAE,KAAK,IAAI,EAAE;QACjF,MAAM,EAAE,GAAG;;;;;;;;;;;;;;;CAed,CAAA;QACG,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,MAAM,eAAe,CAAC,EAAE,CAAC,CAAA;QACpD,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;QAC7B,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAA;QACrC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAA;QACjC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,UAAU,CAAC,CAAA;QACtC,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC,CAAA;IAClF,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,oCAAoC,EAAE,KAAK,IAAI,EAAE;QAClD,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,eAAe,CAAC,mCAAmC,CAAC,CAAA;QAC3E,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,UAAU,CAAC,CAAA;IACxC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,6BAA6B,EAAE,KAAK,IAAI,EAAE;QAC3C,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,eAAe,CAAC,6BAA6B,CAAC,CAAA;QACzE,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;YACvB,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE;YAC5C,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE;SAC7C,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,oEAAoE,EAAE,KAAK,IAAI,EAAE;QAClF,MAAM,EAAE,GAAG,uCAAuC,CAAA;QAClD,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,eAAe,CAAC,EAAE,CAAC,CAAA;QAC1C,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAA;QACpC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;IAChC,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/guides/sanitize.d.ts

@@ -0,0 +1,3 @@
+import type { Schema } from 'hast-util-sanitize';
+export declare const guideSanitizeSchema: Schema;
+//# sourceMappingURL=sanitize.d.ts.map

package/dist/guides/sanitize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.d.ts","sourceRoot":"","sources":["../../src/guides/sanitize.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAGhD,eAAO,MAAM,mBAAmB,EAAE,MAwEjC,CAAA"}