@zigrivers/scaffold 3.28.0 → 3.29.0

package/dist/guides/directives-callout.test.d.ts

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

package/dist/guides/directives-callout.test.d.ts.map

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

package/dist/guides/directives-callout.test.js

@@ -0,0 +1,22 @@
+import { describe, it, expect } from 'vitest';
+import { renderGuideBody } from './render.js';
+import { remarkCallout } from './directives.js';
+describe('remarkCallout', () => {
+    it('renders a container directive as a typed callout div', async () => {
+        const md = ':::callout{type=warning}\nBe careful **here**.\n:::\n';
+        const { body } = await renderGuideBody(md, { plugins: [remarkCallout] });
+        expect(body).toContain('class="callout callout-warning"');
+        expect(body).toContain('<strong>here</strong>');
+    });
+    it('defaults to type=note when no type given', async () => {
+        const { body } = await renderGuideBody(':::callout\ntext\n:::\n', { plugins: [remarkCallout] });
+        expect(body).toContain('class="callout callout-note"');
+    });
+    it('lowercases the type attribute before allowlist check', async () => {
+        const md = ':::callout{type=Warning}\nWatch out.\n:::\n';
+        const { body } = await renderGuideBody(md, { plugins: [remarkCallout] });
+        expect(body).toContain('class="callout callout-warning"');
+        expect(body).not.toContain('class="callout callout-note"');
+    });
+});
+//# sourceMappingURL=directives-callout.test.js.map

package/dist/guides/directives-callout.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"directives-callout.test.js","sourceRoot":"","sources":["../../src/guides/directives-callout.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAE/C,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACpE,MAAM,EAAE,GAAG,uDAAuD,CAAA;QAClE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,eAAe,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC,CAAA;QACxE,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,iCAAiC,CAAC,CAAA;QACzD,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAA;IACjD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;QACxD,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,eAAe,CAAC,yBAAyB,EAAE,EAAE,OAAO,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC,CAAA;QAC/F,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,8BAA8B,CAAC,CAAA;IACxD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACpE,MAAM,EAAE,GAAG,6CAA6C,CAAA;QACxD,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,eAAe,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC,CAAA;QACxE,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,iCAAiC,CAAC,CAAA;QACzD,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,8BAA8B,CAAC,CAAA;IAC5D,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/guides/directives-chart.test.d.ts

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

package/dist/guides/directives-chart.test.d.ts.map

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

package/dist/guides/directives-chart.test.js

@@ -0,0 +1,25 @@
+import { describe, it, expect } from 'vitest';
+import { renderGuideBody } from './render.js';
+import { remarkChart } from './directives.js';
+describe('remarkChart', () => {
+    it('renders static bars from the following table and keeps the table', async () => {
+        const md = ':::chart{type=bar}\n\n| Host | Count |\n|---|---|\n| github.com | 40 |\n| npmjs.com | 10 |\n:::\n';
+        const { body } = await renderGuideBody(md, { plugins: [remarkChart] });
+        expect(body).toContain('class="chart chart-bar"');
+        expect(body).toContain('width:100%');
+        expect(body).toContain('width:25%');
+        expect(body).toContain('aria-label="github.com: 40"');
+        expect(body).toContain('<table>');
+    });
+    it('preserves stray prose children inside a :::chart block', async () => {
+        const md = ':::chart{type=bar}\n\n| Host | Count |\n|---|---|\n| alpha | 10 |\n\nStray note inside chart\n:::\n';
+        const { body } = await renderGuideBody(md, { plugins: [remarkChart] });
+        expect(body).toContain('class="chart chart-bar"');
+        expect(body).toContain('<table>');
+        expect(body).toContain('Stray note inside chart');
+    });
+    it('fails the build when not followed by a table', async () => {
+        await expect(renderGuideBody(':::chart{type=bar}\nno table\n:::\n', { plugins: [remarkChart] })).rejects.toThrow(/chart.*table/i);
+    });
+});
+//# sourceMappingURL=directives-chart.test.js.map

package/dist/guides/directives-chart.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"directives-chart.test.js","sourceRoot":"","sources":["../../src/guides/directives-chart.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAE7C,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,kEAAkE,EAAE,KAAK,IAAI,EAAE;QAChF,MAAM,EAAE,GAAG,mGAAmG,CAAA;QAC9G,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,eAAe,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,CAAA;QACtE,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,yBAAyB,CAAC,CAAA;QACjD,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAA;QACpC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAA;QACnC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,6BAA6B,CAAC,CAAA;QACrD,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAA;IACnC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,wDAAwD,EAAE,KAAK,IAAI,EAAE;QACtE,MAAM,EAAE,GAAG,qGAAqG,CAAA;QAChH,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,eAAe,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,CAAA;QACtE,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,yBAAyB,CAAC,CAAA;QACjD,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAA;QACjC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,yBAAyB,CAAC,CAAA;IACnD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;QAC5D,MAAM,MAAM,CACV,eAAe,CAAC,qCAAqC,EAAE,EAAE,OAAO,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,CACnF,CAAC,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,CAAA;IACpC,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/guides/directives-filter-table.test.d.ts

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

package/dist/guides/directives-filter-table.test.d.ts.map

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

package/dist/guides/directives-filter-table.test.js

@@ -0,0 +1,22 @@
+import { describe, it, expect } from 'vitest';
+import { renderGuideBody } from './render.js';
+import { remarkFilterTable } from './directives.js';
+describe('remarkFilterTable', () => {
+    it('wraps a GFM table with a filter input and filterable container', async () => {
+        const md = `:::filter-table
+
+| Flag | Description |
+|---|---|
+| --pr | PR number |
+| --staged | staged diff |
+:::
+`;
+        const { body } = await renderGuideBody(md, { plugins: [remarkFilterTable] });
+        expect(body).toContain('class="filter-table"');
+        expect(body).toContain('type="text"');
+        expect(body).toContain('class="filter-input"');
+        expect(body).toContain('<table>');
+        expect(body).toContain('--staged');
+    });
+});
+//# sourceMappingURL=directives-filter-table.test.js.map

package/dist/guides/directives-filter-table.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"directives-filter-table.test.js","sourceRoot":"","sources":["../../src/guides/directives-filter-table.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAEnD,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,gEAAgE,EAAE,KAAK,IAAI,EAAE;QAC9E,MAAM,EAAE,GAAG;;;;;;;CAOd,CAAA;QACG,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,eAAe,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAA;QAC5E,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,sBAAsB,CAAC,CAAA;QAC9C,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAA;QACrC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,sBAAsB,CAAC,CAAA;QAC9C,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAA;QACjC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAA;IACpC,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/guides/directives-sev.test.d.ts

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

package/dist/guides/directives-sev.test.d.ts.map

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

package/dist/guides/directives-sev.test.js

@@ -0,0 +1,15 @@
+import { describe, it, expect } from 'vitest';
+import { renderGuideBody } from './render.js';
+import { remarkSev } from './directives.js';
+describe('remarkSev', () => {
+    it('renders an inline severity chip', async () => {
+        const { body } = await renderGuideBody('A :sev[P0]{level=p0} finding.\n', { plugins: [remarkSev] });
+        expect(body).toContain('class="sev sev-p0"');
+        expect(body).toContain('>P0<');
+    });
+    it('falls back to p2 for an unknown level', async () => {
+        const { body } = await renderGuideBody('x :sev[P9]{level=p9} y\n', { plugins: [remarkSev] });
+        expect(body).toContain('class="sev sev-p2"');
+    });
+});
+//# sourceMappingURL=directives-sev.test.js.map

package/dist/guides/directives-sev.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"directives-sev.test.js","sourceRoot":"","sources":["../../src/guides/directives-sev.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAE3C,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACzB,EAAE,CAAC,iCAAiC,EAAE,KAAK,IAAI,EAAE;QAC/C,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,eAAe,CAAC,iCAAiC,EAAE,EAAE,OAAO,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAA;QACnG,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAA;QAC5C,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;IAChC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,uCAAuC,EAAE,KAAK,IAAI,EAAE;QACrD,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,eAAe,CAAC,0BAA0B,EAAE,EAAE,OAAO,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAA;QAC5F,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAA;IAC9C,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/guides/directives-tabs.test.d.ts

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

package/dist/guides/directives-tabs.test.d.ts.map

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

package/dist/guides/directives-tabs.test.js

@@ -0,0 +1,52 @@
+import { describe, it, expect } from 'vitest';
+import { renderGuideBody } from './render.js';
+import { remarkTabs } from './directives.js';
+describe('remarkTabs', () => {
+    it('preserves stray prose children inside a ::::tabs block', async () => {
+        const md = [
+            '::::tabs',
+            '',
+            ':::tab{title="One"}',
+            'Tab body',
+            ':::',
+            '',
+            'Stray paragraph inside tabs',
+            '',
+            '::::',
+        ].join('\n') + '\n';
+        const { body } = await renderGuideBody(md, { plugins: [remarkTabs] });
+        expect(body).toContain('Tab body');
+        expect(body).toContain('Stray paragraph inside tabs');
+    });
+    it('renders a tab group with buttons and panes', async () => {
+        const md = [
+            '::::tabs',
+            '',
+            ':::tab{title="Codex"}',
+            'Codex body',
+            ':::',
+            '',
+            ':::tab{title="Gemini"}',
+            'Gemini body',
+            ':::',
+            '',
+            '::::',
+        ].join('\n') + '\n';
+        const { body } = await renderGuideBody(md, { plugins: [remarkTabs] });
+        // No stray delimiter paragraph
+        expect(body).not.toContain('<p>:::');
+        // Structure
+        expect(body).toContain('class="tabs"');
+        expect(body).toContain('role="tab"');
+        expect(body).toContain('data-tab="0"');
+        expect(body).toContain('data-tab="1"');
+        // Both tab bodies present
+        expect(body).toContain('Codex body');
+        expect(body).toContain('Gemini body');
+        // Exactly one active tab button
+        expect(body.match(/tab-btn active/g)?.length).toBe(1);
+        // First pane is active
+        expect(body).toContain('class="tabpane active"');
+    });
+});
+//# sourceMappingURL=directives-tabs.test.js.map

package/dist/guides/directives-tabs.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"directives-tabs.test.js","sourceRoot":"","sources":["../../src/guides/directives-tabs.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAE5C,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,EAAE,CAAC,wDAAwD,EAAE,KAAK,IAAI,EAAE;QACtE,MAAM,EAAE,GAAG;YACT,UAAU;YACV,EAAE;YACF,qBAAqB;YACrB,UAAU;YACV,KAAK;YACL,EAAE;YACF,6BAA6B;YAC7B,EAAE;YACF,MAAM;SACP,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;QACnB,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,eAAe,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,CAAA;QACrE,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAA;QAClC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,6BAA6B,CAAC,CAAA;IACvD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QAC1D,MAAM,EAAE,GAAG;YACT,UAAU;YACV,EAAE;YACF,uBAAuB;YACvB,YAAY;YACZ,KAAK;YACL,EAAE;YACF,wBAAwB;YACxB,aAAa;YACb,KAAK;YACL,EAAE;YACF,MAAM;SACP,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;QACnB,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,eAAe,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,CAAA;QACrE,+BAA+B;QAC/B,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAA;QACpC,YAAY;QACZ,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAA;QACtC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAA;QACpC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAA;QACtC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAA;QACtC,0BAA0B;QAC1B,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAA;QACpC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAA;QACrC,gCAAgC;QAChC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACrD,uBAAuB;QACvB,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,wBAAwB,CAAC,CAAA;IAClD,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/guides/directives.d.ts

@@ -0,0 +1,7 @@
+import type { AnyPlugin } from './render.js';
+export declare const remarkCallout: AnyPlugin;
+export declare const remarkTabs: AnyPlugin;
+export declare const remarkChart: AnyPlugin;
+export declare const remarkFilterTable: AnyPlugin;
+export declare const remarkSev: AnyPlugin;
+//# sourceMappingURL=directives.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"directives.d.ts","sourceRoot":"","sources":["../../src/guides/directives.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAI5C,eAAO,MAAM,aAAa,EAAE,SAU3B,CAAA;AAGD,eAAO,MAAM,UAAU,EAAE,SA+CxB,CAAA;AAGD,eAAO,MAAM,WAAW,EAAE,SAqDzB,CAAA;AAGD,eAAO,MAAM,iBAAiB,EAAE,SAmB/B,CAAA;AAKD,eAAO,MAAM,SAAS,EAAE,SAUvB,CAAA"}

package/dist/guides/directives.js

@@ -0,0 +1,158 @@
+import { visit } from 'unist-util-visit';
+import { toString as mdToString } from 'mdast-util-to-string';
+const CALLOUT_TYPES = new Set(['note', 'tip', 'warning', 'danger', 'info']);
+export const remarkCallout = () => (tree) => {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    visit(tree, (node) => {
+        if (node.type !== 'containerDirective' || node.name !== 'callout')
+            return;
+        const type = String(node.attributes?.type ?? 'note').toLowerCase();
+        const safe = CALLOUT_TYPES.has(type) ? type : 'note';
+        node.data = node.data ?? {};
+        node.data.hName = 'div';
+        node.data.hProperties = { className: `callout callout-${safe}` };
+    });
+};
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export const remarkTabs = () => (tree) => {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    visit(tree, (node) => {
+        if (node.type !== 'containerDirective' || node.name !== 'tabs')
+            return;
+        // With a 4-colon outer fence (::::tabs) wrapping 3-colon (:::tab) children,
+        // remark-directive nests tab nodes directly inside node.children — no sibling
+        // collection needed, no stray ::: paragraph produced.
+        const tabs = (node.children ?? []).filter(
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        (c) => c.type === 'containerDirective' && c.name === 'tab');
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const others = (node.children ?? []).filter((c) => !(c.type === 'containerDirective' && c.name === 'tab'));
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const buttons = tabs.map((t, i) => ({
+            type: 'paragraph',
+            data: {
+                hName: 'button',
+                hProperties: {
+                    className: 'tab-btn' + (i === 0 ? ' active' : ''),
+                    role: 'tab',
+                    'data-tab': String(i),
+                },
+            },
+            children: [{ type: 'text', value: String(t.attributes?.title ?? `Tab ${i + 1}`) }],
+        }));
+        const tablist = {
+            type: 'paragraph',
+            data: { hName: 'div', hProperties: { className: 'tablist', role: 'tablist' } },
+            children: buttons,
+        };
+        // Mutate each tab node in place: assign hast properties and keep its children.
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        tabs.forEach((t, i) => {
+            t.data = t.data ?? {};
+            t.data.hName = 'div';
+            t.data.hProperties = {
+                className: 'tabpane' + (i === 0 ? ' active' : ''),
+                'data-tab': String(i),
+            };
+        });
+        node.data = node.data ?? {};
+        node.data.hName = 'div';
+        node.data.hProperties = { className: 'tabs' };
+        node.children = [tablist, ...tabs, ...others];
+    });
+};
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export const remarkChart = () => (tree) => {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    visit(tree, (node) => {
+        if (node.type !== 'containerDirective' || node.name !== 'chart')
+            return;
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const table = (node.children ?? []).find((c) => c.type === 'table');
+        if (!table)
+            throw new Error('`:::chart` must contain a GFM table');
+        const rows = table.children.slice(1); // drop header row
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const parsed = rows.map((r) => {
+            const cells = r.children;
+            const label = mdToString(cells[0]);
+            const value = Number(mdToString(cells[cells.length - 1]).trim());
+            if (!Number.isFinite(value))
+                throw new Error(`:::chart value column must be numeric (got "${label}")`);
+            return { label, value };
+        });
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const max = Math.max(...parsed.map((p) => p.value), 0) || 1;
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const bars = parsed.map((p) => {
+            const pct = Math.round((p.value / max) * 100);
+            return {
+                type: 'paragraph',
+                data: {
+                    hName: 'div',
+                    hProperties: { className: 'chart-row', 'aria-label': `${p.label}: ${p.value}` },
+                },
+                children: [
+                    {
+                        type: 'paragraph',
+                        data: { hName: 'span', hProperties: { className: 'chart-label' } },
+                        children: [{ type: 'text', value: p.label }],
+                    },
+                    {
+                        type: 'paragraph',
+                        data: { hName: 'div', hProperties: { className: 'chart-bar', style: `width:${pct}%` } },
+                        children: [],
+                    },
+                ],
+            };
+        });
+        const chart = {
+            type: 'paragraph',
+            data: { hName: 'div', hProperties: { className: 'chart chart-bar' } },
+            children: bars,
+        };
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const chartOthers = (node.children ?? []).filter((c) => c !== table);
+        node.data = node.data ?? {};
+        node.data.hName = 'div';
+        node.data.hProperties = { className: 'chart-block' };
+        node.children = [chart, table, ...chartOthers];
+    });
+};
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export const remarkFilterTable = () => (tree) => {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    visit(tree, (node) => {
+        if (node.type !== 'containerDirective' || node.name !== 'filter-table')
+            return;
+        const input = {
+            type: 'paragraph',
+            data: {
+                hName: 'input',
+                hProperties: {
+                    type: 'text', className: 'filter-input', placeholder: 'Filter…', 'aria-label': 'Filter table rows',
+                },
+            },
+            children: [],
+        };
+        node.data = node.data ?? {};
+        node.data.hName = 'div';
+        node.data.hProperties = { className: 'filter-table' };
+        node.children = [input, ...(node.children ?? [])];
+    });
+};
+const SEV_LEVELS = new Set(['p0', 'p1', 'p2', 'p3', 'pass']);
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export const remarkSev = () => (tree) => {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    visit(tree, (node) => {
+        if (node.type !== 'textDirective' || node.name !== 'sev')
+            return;
+        const level = String(node.attributes?.level ?? 'p2').toLowerCase();
+        const safe = SEV_LEVELS.has(level) ? level : 'p2';
+        node.data = node.data ?? {};
+        node.data.hName = 'span';
+        node.data.hProperties = { className: `sev sev-${safe}` };
+    });
+};
+//# sourceMappingURL=directives.js.map

package/dist/guides/directives.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"directives.js","sourceRoot":"","sources":["../../src/guides/directives.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AACxC,OAAO,EAAE,QAAQ,IAAI,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAI7D,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAA;AAE3E,MAAM,CAAC,MAAM,aAAa,GAAc,GAAG,EAAE,CAAC,CAAC,IAAU,EAAE,EAAE;IAC3D,8DAA8D;IAC9D,KAAK,CAAC,IAAI,EAAE,CAAC,IAAS,EAAE,EAAE;QACxB,IAAI,IAAI,CAAC,IAAI,KAAK,oBAAoB,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;YAAE,OAAM;QACzE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,IAAI,MAAM,CAAC,CAAC,WAAW,EAAE,CAAA;QAClE,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAA;QACpD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,CAAA;QAC3B,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;QACvB,IAAI,CAAC,IAAI,CAAC,WAAW,GAAG,EAAE,SAAS,EAAE,mBAAmB,IAAI,EAAE,EAAE,CAAA;IAClE,CAAC,CAAC,CAAA;AACJ,CAAC,CAAA;AAED,8DAA8D;AAC9D,MAAM,CAAC,MAAM,UAAU,GAAc,GAAG,EAAE,CAAC,CAAC,IAAS,EAAE,EAAE;IACvD,8DAA8D;IAC9D,KAAK,CAAC,IAAI,EAAE,CAAC,IAAS,EAAE,EAAE;QACxB,IAAI,IAAI,CAAC,IAAI,KAAK,oBAAoB,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;YAAE,OAAM;QACtE,4EAA4E;QAC5E,8EAA8E;QAC9E,sDAAsD;QAEtD,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,MAAM;QACvC,8DAA8D;QAC9D,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,oBAAoB,IAAI,CAAC,CAAC,IAAI,KAAK,KAAK,CAChE,CAAA;QACD,8DAA8D;QAC9D,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,oBAAoB,IAAI,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAA;QAC/G,8DAA8D;QAC9D,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,CAAS,EAAE,EAAE,CAAC,CAAC;YAC/C,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE;gBACJ,KAAK,EAAE,QAAQ;gBACf,WAAW,EAAE;oBACX,SAAS,EAAE,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;oBACjD,IAAI,EAAE,KAAK;oBACX,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;iBACtB;aACF;YACD,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,UAAU,EAAE,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;SACnF,CAAC,CAAC,CAAA;QACH,MAAM,OAAO,GAAG;YACd,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE;YAC9E,QAAQ,EAAE,OAAO;SAClB,CAAA;QACD,+EAA+E;QAC/E,8DAA8D;QAC9D,IAAI,CAAC,OAAO,CAAC,CAAC,CAAM,EAAE,CAAS,EAAE,EAAE;YACjC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,EAAE,CAAA;YACrB,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;YACpB,CAAC,CAAC,IAAI,CAAC,WAAW,GAAG;gBACnB,SAAS,EAAE,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;gBACjD,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;aACtB,CAAA;QACH,CAAC,CAAC,CAAA;QACF,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,CAAA;QAC3B,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;QACvB,IAAI,CAAC,IAAI,CAAC,WAAW,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,CAAA;QAC7C,IAAI,CAAC,QAAQ,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC,CAAA;IAC/C,CAAC,CAAC,CAAA;AACJ,CAAC,CAAA;AAED,8DAA8D;AAC9D,MAAM,CAAC,MAAM,WAAW,GAAc,GAAG,EAAE,CAAC,CAAC,IAAS,EAAE,EAAE;IACxD,8DAA8D;IAC9D,KAAK,CAAC,IAAI,EAAE,CAAC,IAAS,EAAE,EAAE;QACxB,IAAI,IAAI,CAAC,IAAI,KAAK,oBAAoB,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO;YAAE,OAAM;QACvE,8DAA8D;QAC9D,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAA;QACxE,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAA;QAClE,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA,CAAC,kBAAkB;QACvD,8DAA8D;QAC9D,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE;YACjC,MAAM,KAAK,GAAG,CAAC,CAAC,QAAQ,CAAA;YACxB,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;YAClC,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;YAChE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,+CAA+C,KAAK,IAAI,CAAC,CAAA;YACtG,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAA;QACzB,CAAC,CAAC,CAAA;QACF,8DAA8D;QAC9D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAA;QAChE,8DAA8D;QAC9D,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE;YACjC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAA;YAC7C,OAAO;gBACL,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE;oBACJ,KAAK,EAAE,KAAK;oBACZ,WAAW,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,GAAG,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;iBAChF;gBACD,QAAQ,EAAE;oBACR;wBACE,IAAI,EAAE,WAAW;wBACjB,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE,EAAE;wBAClE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;qBAC7C;oBACD;wBACE,IAAI,EAAE,WAAW;wBACjB,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,GAAG,GAAG,EAAE,EAAE;wBACvF,QAAQ,EAAE,EAAE;qBACb;iBACF;aACF,CAAA;QACH,CAAC,CAAC,CAAA;QACF,MAAM,KAAK,GAAG;YACZ,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,SAAS,EAAE,iBAAiB,EAAE,EAAE;YACrE,QAAQ,EAAE,IAAI;SACf,CAAA;QACD,8DAA8D;QAC9D,MAAM,WAAW,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,CAAC,CAAA;QACzE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,CAAA;QAC3B,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;QACvB,IAAI,CAAC,IAAI,CAAC,WAAW,GAAG,EAAE,SAAS,EAAE,aAAa,EAAE,CAAA;QACpD,IAAI,CAAC,QAAQ,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,WAAW,CAAC,CAAA;IAChD,CAAC,CAAC,CAAA;AACJ,CAAC,CAAA;AAED,8DAA8D;AAC9D,MAAM,CAAC,MAAM,iBAAiB,GAAc,GAAG,EAAE,CAAC,CAAC,IAAS,EAAE,EAAE;IAC9D,8DAA8D;IAC9D,KAAK,CAAC,IAAI,EAAE,CAAC,IAAS,EAAE,EAAE;QACxB,IAAI,IAAI,CAAC,IAAI,KAAK,oBAAoB,IAAI,IAAI,CAAC,IAAI,KAAK,cAAc;YAAE,OAAM;QAC9E,MAAM,KAAK,GAAG;YACZ,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE;gBACJ,KAAK,EAAE,OAAO;gBACd,WAAW,EAAE;oBACX,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,mBAAmB;iBACnG;aACF;YACD,QAAQ,EAAE,EAAE;SACb,CAAA;QACD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,CAAA;QAC3B,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;QACvB,IAAI,CAAC,IAAI,CAAC,WAAW,GAAG,EAAE,SAAS,EAAE,cAAc,EAAE,CAAA;QACrD,IAAI,CAAC,QAAQ,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAA;IACnD,CAAC,CAAC,CAAA;AACJ,CAAC,CAAA;AAED,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAA;AAE5D,8DAA8D;AAC9D,MAAM,CAAC,MAAM,SAAS,GAAc,GAAG,EAAE,CAAC,CAAC,IAAS,EAAE,EAAE;IACtD,8DAA8D;IAC9D,KAAK,CAAC,IAAI,EAAE,CAAC,IAAS,EAAE,EAAE;QACxB,IAAI,IAAI,CAAC,IAAI,KAAK,eAAe,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK;YAAE,OAAM;QAChE,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,IAAI,IAAI,CAAC,CAAC,WAAW,EAAE,CAAA;QAClE,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAA;QACjD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,CAAA;QAC3B,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,MAAM,CAAA;QACxB,IAAI,CAAC,IAAI,CAAC,WAAW,GAAG,EAAE,SAAS,EAAE,WAAW,IAAI,EAAE,EAAE,CAAA;IAC1D,CAAC,CAAC,CAAA;AACJ,CAAC,CAAA"}

package/dist/guides/fs-guides.test.d.ts

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

package/dist/guides/fs-guides.test.d.ts.map

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

package/dist/guides/fs-guides.test.js

@@ -0,0 +1,14 @@
+import { describe, it, expect } from 'vitest';
+import path from 'node:path';
+import { getPackageGuidesDir, getPackageRoot } from '../utils/fs.js';
+describe('getPackageGuidesDir', () => {
+    it('returns <packageRoot>/content/guides when no projectRoot given', () => {
+        expect(getPackageGuidesDir()).toBe(path.join(getPackageRoot(), 'content', 'guides'));
+    });
+    it('prefers an existing projectRoot/content/guides', () => {
+        const root = getPackageRoot();
+        const result = getPackageGuidesDir(root);
+        expect(result).toBe(path.join(root, 'content', 'guides'));
+    });
+});
+//# sourceMappingURL=fs-guides.test.js.map

package/dist/guides/fs-guides.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-guides.test.js","sourceRoot":"","sources":["../../src/guides/fs-guides.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAEpE,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;QACxE,MAAM,CAAC,mBAAmB,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAA;IACtF,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,IAAI,GAAG,cAAc,EAAE,CAAA;QAC7B,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAA;QACxC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAA;IAC3D,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/guides/index-page.d.ts

@@ -0,0 +1,3 @@
+import type { GuideEntry } from './types.js';
+export declare function renderIndexPage(entries: GuideEntry[], css: string): string;
+//# sourceMappingURL=index-page.d.ts.map

package/dist/guides/index-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-page.d.ts","sourceRoot":"","sources":["../../src/guides/index-page.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAG5C,wBAAgB,eAAe,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAa1E"}

package/dist/guides/index-page.js

@@ -0,0 +1,14 @@
+import { wrapInChrome, esc } from './template.js';
+export function renderIndexPage(entries, css) {
+    const sorted = [...entries].sort((a, b) => a.frontmatter.order - b.frontmatter.order);
+    const items = sorted.map((e) => `<li><a href="${e.topic}/index.html"><strong>${esc(e.frontmatter.title)}</strong></a>` +
+        `<span class="cat">${esc(e.frontmatter.category)}</span>` +
+        `<p>${esc(e.frontmatter.description)}</p></li>`).join('');
+    return wrapInChrome({
+        title: 'Scaffold Guides',
+        body: `<h2 id="guides">Guides</h2><ul class="guide-index">${items}</ul>`,
+        headings: [{ depth: 2, text: 'Guides', id: 'guides' }],
+        css,
+    });
+}
+//# sourceMappingURL=index-page.js.map

package/dist/guides/index-page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-page.js","sourceRoot":"","sources":["../../src/guides/index-page.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,eAAe,CAAA;AAEjD,MAAM,UAAU,eAAe,CAAC,OAAqB,EAAE,GAAW;IAChE,MAAM,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,GAAG,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;IACrF,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAC7B,gBAAgB,CAAC,CAAC,KAAK,wBAAwB,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,eAAe;QACtF,qBAAqB,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,SAAS;QACzD,MAAM,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,WAAW,CAAC,WAAW,CAChD,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACV,OAAO,YAAY,CAAC;QAClB,KAAK,EAAE,iBAAiB;QACxB,IAAI,EAAE,sDAAsD,KAAK,OAAO;QACxE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC;QACtD,GAAG;KACJ,CAAC,CAAA;AACJ,CAAC"}

package/dist/guides/lint.d.ts

@@ -0,0 +1,6 @@
+export interface LintResult {
+    errors: string[];
+    warnings: string[];
+}
+export declare function lintGuide(markdown: string): LintResult;
+//# sourceMappingURL=lint.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../../src/guides/lint.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IAAG,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE;AAMpE,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAoBtD"}

package/dist/guides/lint.js

@@ -0,0 +1,27 @@
+const EMBED_OPEN = /^:::embed\{[^}]*\}\s*$/;
+const EMBED_CLOSE = /^:::\s*$/;
+const TEXT_EQUIV = /text[\s-]?equivalent/i;
+export function lintGuide(markdown) {
+    const errors = [];
+    const warnings = [];
+    const lines = markdown.split(/\r?\n/);
+    let embedCount = 0;
+    for (let i = 0; i < lines.length; i++) {
+        if (!EMBED_OPEN.test(lines[i]))
+            continue;
+        embedCount++;
+        let body = '';
+        let j = i + 1;
+        for (; j < lines.length && !EMBED_CLOSE.test(lines[j]); j++)
+            body += lines[j] + '\n';
+        if (!TEXT_EQUIV.test(body)) {
+            errors.push(`:::embed at line ${i + 1} is missing a text-equivalent (required for agent-readability)`);
+        }
+        i = j;
+    }
+    if (embedCount > 3) {
+        warnings.push(`guide uses ${embedCount} escape-hatch embeds (>3) — prefer first-class directives`);
+    }
+    return { errors, warnings };
+}
+//# sourceMappingURL=lint.js.map

package/dist/guides/lint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.js","sourceRoot":"","sources":["../../src/guides/lint.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAAG,wBAAwB,CAAA;AAC3C,MAAM,WAAW,GAAG,UAAU,CAAA;AAC9B,MAAM,UAAU,GAAG,uBAAuB,CAAA;AAE1C,MAAM,UAAU,SAAS,CAAC,QAAgB;IACxC,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,MAAM,QAAQ,GAAa,EAAE,CAAA;IAC7B,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IACrC,IAAI,UAAU,GAAG,CAAC,CAAA;IAClB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAAE,SAAQ;QACxC,UAAU,EAAE,CAAA;QACZ,IAAI,IAAI,GAAG,EAAE,CAAA;QACb,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACb,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE;YAAE,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAA;QACpF,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,gEAAgE,CAAC,CAAA;QACxG,CAAC;QACD,CAAC,GAAG,CAAC,CAAA;IACP,CAAC;IACD,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;QACnB,QAAQ,CAAC,IAAI,CAAC,cAAc,UAAU,2DAA2D,CAAC,CAAA;IACpG,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAA;AAC7B,CAAC"}

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

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

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

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

package/dist/guides/lint.test.js

@@ -0,0 +1,24 @@
+import { describe, it, expect } from 'vitest';
+import { lintGuide } from './lint.js';
+describe('lintGuide', () => {
+    it('passes a guide with no embeds', () => {
+        const r = lintGuide('# Hi\n\nplain markdown\n');
+        expect(r.errors).toEqual([]);
+        expect(r.warnings).toEqual([]);
+    });
+    it('errors when an :::embed lacks a text-equivalent', () => {
+        const md = ':::embed{src=partials/x.svg}\n:::\n';
+        const r = lintGuide(md);
+        expect(r.errors.some((e) => /text.equivalent/i.test(e))).toBe(true);
+    });
+    it('passes an :::embed that includes a text-equivalent', () => {
+        const md = ':::embed{src=partials/x.svg}\n**Text equivalent:** a diagram.\n:::\n';
+        expect(lintGuide(md).errors).toEqual([]);
+    });
+    it('warns past 3 embeds', () => {
+        const one = ':::embed{src=p.svg}\n**Text equivalent:** x\n:::\n\n';
+        const r = lintGuide(one.repeat(4));
+        expect(r.warnings.some((w) => /embed/i.test(w))).toBe(true);
+    });
+});
+//# sourceMappingURL=lint.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lint.test.js","sourceRoot":"","sources":["../../src/guides/lint.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAErC,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACzB,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,CAAC,GAAG,SAAS,CAAC,0BAA0B,CAAC,CAAA;QAC/C,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;QAC5B,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IAChC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,EAAE,GAAG,qCAAqC,CAAA;QAChD,MAAM,CAAC,GAAG,SAAS,CAAC,EAAE,CAAC,CAAA;QACvB,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACrE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,EAAE,GAAG,sEAAsE,CAAA;QACjF,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IAC1C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,qBAAqB,EAAE,GAAG,EAAE;QAC7B,MAAM,GAAG,GAAG,sDAAsD,CAAA;QAClE,MAAM,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;QAClC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC7D,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/guides/loader.d.ts

@@ -0,0 +1,4 @@
+import type { GuideFrontmatter, GuideEntry } from './types.js';
+export declare function extractGuideFrontmatter(content: string): GuideFrontmatter | null;
+export declare function buildGuidesIndex(guidesDir: string): Map<string, GuideEntry>;
+//# sourceMappingURL=loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/guides/loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE9D,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAwBhF;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAwB3E"}

package/dist/guides/loader.js

@@ -0,0 +1,63 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import yaml from 'js-yaml';
+export function extractGuideFrontmatter(content) {
+    const lines = content.split(/\r?\n/);
+    if (lines[0]?.trim() !== '---')
+        return null;
+    const closeIdx = lines.findIndex((l, i) => i > 0 && l.trim() === '---');
+    if (closeIdx === -1)
+        return null;
+    const yamlText = lines.slice(1, closeIdx).join('\n');
+    let parsed;
+    try {
+        parsed = yaml.load(yamlText, { schema: yaml.JSON_SCHEMA });
+    }
+    catch {
+        return null;
+    }
+    if (!parsed || typeof parsed !== 'object')
+        return null;
+    const p = parsed;
+    if (typeof p.title !== 'string' || typeof p.topic !== 'string' ||
+        typeof p.description !== 'string' || typeof p.category !== 'string' ||
+        typeof p.order !== 'number')
+        return null;
+    const fm = {
+        title: p.title, topic: p.topic, description: p.description,
+        category: p.category, order: p.order,
+    };
+    return fm;
+}
+export function buildGuidesIndex(guidesDir) {
+    const index = new Map();
+    if (!fs.existsSync(guidesDir))
+        return index;
+    let dirents;
+    try {
+        dirents = fs.readdirSync(guidesDir, { withFileTypes: true });
+    }
+    catch {
+        return index;
+    }
+    for (const d of dirents) {
+        if (!d.isDirectory() || d.name.startsWith('.'))
+            continue;
+        const dir = path.join(guidesDir, d.name);
+        const mdPath = path.join(dir, 'index.md');
+        if (!fs.existsSync(mdPath))
+            continue;
+        let fm;
+        try {
+            fm = extractGuideFrontmatter(fs.readFileSync(mdPath, 'utf8'));
+        }
+        catch {
+            continue;
+        }
+        if (!fm || fm.topic !== d.name)
+            continue;
+        index.set(fm.topic, { topic: fm.topic, dir, mdPath, htmlPath: path.join(dir, 'index.html'), frontmatter: fm });
+    }
+    return index;
+}
+//# sourceMappingURL=loader.js.map

package/dist/guides/loader.js.map

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

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

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