@zigrivers/scaffold 3.28.0 → 3.30.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-cite.test.d.ts

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

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

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

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

@@ -0,0 +1,26 @@
+import { describe, it, expect } from 'vitest';
+import { renderGuideBody } from './render.js';
+import { remarkCite } from './directives.js';
+describe('remarkCite', () => {
+    it('renders a blocking citation as an fp span the citation checker matches', async () => {
+        const { body } = await renderGuideBody('See :cite[src/foo.ts:42] for details.\n', {
+            plugins: [remarkCite],
+        });
+        expect(body).toContain('class="fp"');
+        expect(body).toContain('data-path="src/foo.ts:42"');
+        expect(body).toContain('>src/foo.ts:42<');
+    });
+    it('preserves a line range in data-path', async () => {
+        const { body } = await renderGuideBody(':cite[src/bar.ts:10-20]\n', { plugins: [remarkCite] });
+        expect(body).toContain('data-path="src/bar.ts:10-20"');
+    });
+    it('renders an advisory citation without the fp class so the gate does not block on it', async () => {
+        const { body } = await renderGuideBody(':cite[docs/x.md:3]{mode=advisory}\n', {
+            plugins: [remarkCite],
+        });
+        expect(body).toContain('class="cite-advisory"');
+        expect(body).toContain('data-path="docs/x.md:3"');
+        expect(body).not.toContain('class="fp"');
+    });
+});
+//# sourceMappingURL=directives-cite.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"directives-cite.test.js","sourceRoot":"","sources":["../../src/guides/directives-cite.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,wEAAwE,EAAE,KAAK,IAAI,EAAE;QACtF,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,eAAe,CAAC,yCAAyC,EAAE;YAChF,OAAO,EAAE,CAAC,UAAU,CAAC;SACtB,CAAC,CAAA;QACF,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAA;QACpC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,2BAA2B,CAAC,CAAA;QACnD,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAA;IAC3C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;QACnD,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,eAAe,CAAC,2BAA2B,EAAE,EAAE,OAAO,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,CAAA;QAC9F,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,8BAA8B,CAAC,CAAA;IACxD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,oFAAoF,EAAE,KAAK,IAAI,EAAE;QAClG,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,eAAe,CAAC,qCAAqC,EAAE;YAC5E,OAAO,EAAE,CAAC,UAAU,CAAC;SACtB,CAAC,CAAA;QACF,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAA;QAC/C,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,yBAAyB,CAAC,CAAA;QACjD,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,YAAY,CAAC,CAAA;IAC1C,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,8 @@
+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 remarkCite: 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;AAQD,eAAO,MAAM,UAAU,EAAE,SAgBxB,CAAA;AAKD,eAAO,MAAM,SAAS,EAAE,SAUvB,CAAA"}

package/dist/guides/directives.js

@@ -0,0 +1,182 @@
+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 ?? [])];
+    });
+};
+// `:cite[path:line]` (blocking) / `:cite[path:line]{mode=advisory}` (warns).
+// Blocking citations render as `<span class="fp" data-path="…">` so the existing
+// citation-drift checker (scripts/check-reference-citations.mjs FP_RE) verifies
+// the file:line still exists. Advisory citations use a non-`fp` class so the
+// checker's `\bfp\b` match ignores them (the gate never blocks on them).
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export const remarkCite = () => (tree) => {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    visit(tree, (node) => {
+        if (node.type !== 'textDirective' || node.name !== 'cite')
+            return;
+        const path = mdToString(node).trim();
+        const advisory = String(node.attributes?.mode ?? '').toLowerCase() === 'advisory';
+        node.data = node.data ?? {};
+        node.data.hName = 'span';
+        // camelCase `dataPath` matches the hast property convention and the
+        // sanitize allowlist (sanitize.ts) — serializes to the data-path attribute.
+        node.data.hProperties = {
+            className: advisory ? 'cite-advisory' : 'fp',
+            dataPath: path,
+        };
+        node.children = [{ type: 'text', value: path }];
+    });
+};
+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":"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"}

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/links.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Return the targets of relative links/images/reference-definitions in
+ * `markdown` that do not resolve on disk relative to `guideDir`.
+ *
+ * Parses the markdown body (frontmatter stripped) to an mdast and inspects only
+ * `link`, `image`, and `definition` nodes, so link-like text in code blocks,
+ * inline code, or frontmatter is never flagged, and reference-style links are
+ * covered. External URLs (`http:`, `mailto:`, …), protocol-relative (`//`), and
+ * pure anchors (`#…`) are ignored. A trailing `#anchor` is stripped and the
+ * target is percent-decoded before resolving. A `…/index.html` link is accepted
+ * when the `index.md` source exists (the HTML may not be built yet, e.g. a stub).
+ */
+export declare function findBrokenRelativeLinks(markdown: string, guideDir: string): string[];
+//# sourceMappingURL=links.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"links.d.ts","sourceRoot":"","sources":["../../src/guides/links.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAgCpF"}

package/dist/guides/links.js

@@ -0,0 +1,56 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { unified } from 'unified';
+import remarkParse from 'remark-parse';
+import remarkGfm from 'remark-gfm';
+import { visit } from 'unist-util-visit';
+import { stripFrontmatter } from './render.js';
+/**
+ * Return the targets of relative links/images/reference-definitions in
+ * `markdown` that do not resolve on disk relative to `guideDir`.
+ *
+ * Parses the markdown body (frontmatter stripped) to an mdast and inspects only
+ * `link`, `image`, and `definition` nodes, so link-like text in code blocks,
+ * inline code, or frontmatter is never flagged, and reference-style links are
+ * covered. External URLs (`http:`, `mailto:`, …), protocol-relative (`//`), and
+ * pure anchors (`#…`) are ignored. A trailing `#anchor` is stripped and the
+ * target is percent-decoded before resolving. A `…/index.html` link is accepted
+ * when the `index.md` source exists (the HTML may not be built yet, e.g. a stub).
+ */
+export function findBrokenRelativeLinks(markdown, guideDir) {
+    const tree = unified().use(remarkParse).use(remarkGfm).parse(stripFrontmatter(markdown));
+    const urls = [];
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    visit(tree, (node) => {
+        if ((node.type === 'link' || node.type === 'image' || node.type === 'definition') &&
+            typeof node.url === 'string') {
+            urls.push(node.url);
+        }
+    });
+    const broken = [];
+    for (const raw of urls) {
+        const trimmed = raw.trim();
+        if (/^[a-z][a-z0-9+.-]*:/i.test(trimmed))
+            continue; // http:, https:, mailto:, …
+        if (trimmed.startsWith('#') || trimmed.startsWith('//'))
+            continue;
+        const target = trimmed.split('#')[0];
+        if (!target)
+            continue;
+        let decoded;
+        try {
+            decoded = decodeURIComponent(target);
+        }
+        catch {
+            decoded = target;
+        }
+        const abs = path.resolve(guideDir, decoded);
+        if (fs.existsSync(abs))
+            continue;
+        if (decoded.endsWith('index.html') && fs.existsSync(abs.replace(/index\.html$/, 'index.md')))
+            continue;
+        broken.push(raw);
+    }
+    return broken;
+}
+//# sourceMappingURL=links.js.map

package/dist/guides/links.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"links.js","sourceRoot":"","sources":["../../src/guides/links.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,WAAW,MAAM,cAAc,CAAA;AACtC,OAAO,SAAS,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAE9C;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,uBAAuB,CAAC,QAAgB,EAAE,QAAgB;IACxE,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAA;IACxF,MAAM,IAAI,GAAa,EAAE,CAAA;IACzB,8DAA8D;IAC9D,KAAK,CAAC,IAAI,EAAE,CAAC,IAAS,EAAE,EAAE;QACxB,IACE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY,CAAC;YAC7E,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ,EAC5B,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACrB,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAA;QAC1B,IAAI,sBAAsB,CAAC,IAAI,CAAC,OAAO,CAAC;YAAE,SAAQ,CAAC,4BAA4B;QAC/E,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,SAAQ;QACjE,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;QACpC,IAAI,CAAC,MAAM;YAAE,SAAQ;QACrB,IAAI,OAAe,CAAA;QACnB,IAAI,CAAC;YACH,OAAO,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAA;QACtC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,GAAG,MAAM,CAAA;QAClB,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;QAC3C,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAQ;QAChC,IAAI,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC;YAAE,SAAQ;QACtG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAClB,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC"}

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

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

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

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