@zigrivers/scaffold 3.28.0 → 3.29.0

package/dist/guides/build.d.ts

@@ -0,0 +1,12 @@
+import type { LintResult } from './lint.js';
+export declare function loadThemeCss(): string;
+export interface BuildGuideArgs {
+    guideDir: string;
+    css: string;
+    mermaidRender?: (source: string) => Promise<string>;
+}
+export declare function buildGuide(args: BuildGuideArgs): Promise<{
+    lint: LintResult;
+}>;
+export declare function buildAllGuides(projectRoot?: string): Promise<void>;
+//# sourceMappingURL=build.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/guides/build.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAE3C,wBAAgB,YAAY,IAAI,MAAM,CAQrC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAA;IAChB,GAAG,EAAE,MAAM,CAAA;IACX,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;CACpD;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC,CAoBpF;AAED,wBAAsB,cAAc,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQxE"}

package/dist/guides/build.js

@@ -0,0 +1,50 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { atomicWriteFile, getPackageRoot, getPackageGuidesDir } from '../utils/fs.js';
+import { buildGuidesIndex, extractGuideFrontmatter } from './loader.js';
+import { renderGuideBody } from './render.js';
+import { remarkCallout, remarkTabs, remarkFilterTable, remarkChart, remarkSev } from './directives.js';
+import { remarkMermaid, pruneDiagrams } from './mermaid.js';
+import { wrapInChrome } from './template.js';
+import { renderIndexPage } from './index-page.js';
+import { lintGuide } from './lint.js';
+export function loadThemeCss() {
+    const p = path.join(getPackageRoot(), 'dist', 'guides', 'dashboard-theme.css');
+    if (!fs.existsSync(p)) {
+        throw new Error(`Missing ${p} — run \`npm run build\` (the build copies lib/dashboard-theme.css into dist/guides/).`);
+    }
+    return fs.readFileSync(p, 'utf8');
+}
+export async function buildGuide(args) {
+    const md = fs.readFileSync(path.join(args.guideDir, 'index.md'), 'utf8');
+    const lint = lintGuide(md);
+    if (lint.errors.length) {
+        throw new Error(`guide lint failed:\n  ${lint.errors.join('\n  ')}`);
+    }
+    for (const w of lint.warnings)
+        process.stderr.write(`warning: ${w}\n`);
+    const fm = extractGuideFrontmatter(md);
+    if (!fm)
+        throw new Error(`invalid or missing frontmatter in ${path.join(args.guideDir, 'index.md')}`);
+    const diagramIds = [];
+    const { body, headings } = await renderGuideBody(md, {
+        plugins: [
+            remarkCallout, remarkTabs, remarkFilterTable, remarkChart, remarkSev,
+            remarkMermaid({ guideDir: args.guideDir, render: args.mermaidRender, collect: diagramIds }),
+        ],
+    });
+    pruneDiagrams(args.guideDir, diagramIds);
+    const html = wrapInChrome({ title: fm.title, body, headings, css: args.css });
+    atomicWriteFile(path.join(args.guideDir, 'index.html'), html);
+    return { lint };
+}
+export async function buildAllGuides(projectRoot) {
+    const css = loadThemeCss();
+    const guidesDir = getPackageGuidesDir(projectRoot);
+    const index = buildGuidesIndex(guidesDir);
+    for (const entry of index.values()) {
+        await buildGuide({ guideDir: entry.dir, css });
+    }
+    atomicWriteFile(path.join(guidesDir, 'index.html'), renderIndexPage([...index.values()], css));
+}
+//# sourceMappingURL=build.js.map

package/dist/guides/build.js.map

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

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

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

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

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

package/dist/guides/build.test.js

@@ -0,0 +1,74 @@
+import { describe, it, expect } from 'vitest';
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { buildGuide } from './build.js';
+import { renderIndexPage } from './index-page.js';
+const CSS = ':root{--bg:#fff}';
+const GUIDE_MD = `---
+title: MMR
+topic: mmr
+description: review
+category: tools
+order: 10
+---
+
+## Intro
+
+:::callout{type=tip}
+Use :sev[P1]{level=p1} wisely.
+:::
+
+| Flag | Desc |
+|---|---|
+| --pr | number |
+`;
+describe('buildGuide', () => {
+    it('writes a self-contained index.html and returns the lint result', async () => {
+        const root = fs.mkdtempSync(path.join(os.tmpdir(), 'gb-'));
+        const dir = path.join(root, 'mmr');
+        fs.mkdirSync(dir, { recursive: true });
+        fs.writeFileSync(path.join(dir, 'index.md'), GUIDE_MD);
+        const res = await buildGuide({ guideDir: dir, css: CSS, mermaidRender: async () => '<svg><rect/></svg>' });
+        const html = fs.readFileSync(path.join(dir, 'index.html'), 'utf8');
+        expect(html).toContain('<title>MMR</title>');
+        expect(html).toContain('callout-tip');
+        expect(html).toContain('sev-p1');
+        expect(res.lint.errors).toEqual([]);
+    });
+    it('throws when lint finds a missing text-equivalent', async () => {
+        const root = fs.mkdtempSync(path.join(os.tmpdir(), 'gb-'));
+        const dir = path.join(root, 'mmr');
+        fs.mkdirSync(dir, { recursive: true });
+        fs.writeFileSync(path.join(dir, 'index.md'), GUIDE_MD + '\n:::embed{src=partials/x.svg}\n:::\n');
+        await expect(buildGuide({ guideDir: dir, css: CSS, mermaidRender: async () => '' }))
+            .rejects.toThrow(/text-equivalent/i);
+    });
+});
+describe('renderIndexPage', () => {
+    it('lists guides by order with links', () => {
+        const html = renderIndexPage([
+            /* eslint-disable @typescript-eslint/no-explicit-any */
+            ({ topic: 'mmr', frontmatter: {
+                    title: 'MMR', topic: 'mmr', description: 'review', category: 'tools', order: 10,
+                } }),
+            /* eslint-enable @typescript-eslint/no-explicit-any */
+        ], CSS);
+        expect(html).toContain('href="mmr/index.html"');
+        expect(html).toContain('MMR');
+        expect(html).toContain('review');
+    });
+    it('escapes < and & in frontmatter fields', () => {
+        const html = renderIndexPage([
+            /* eslint-disable @typescript-eslint/no-explicit-any */
+            ({ topic: 'x', frontmatter: {
+                    title: 'A & B', topic: 'x', description: '<script>x</script>', category: 'c', order: 1,
+                } }),
+            /* eslint-enable @typescript-eslint/no-explicit-any */
+        ], ':root{}');
+        expect(html).toContain('A &amp; B');
+        expect(html).not.toContain('<script>x</script>');
+        expect(html).toContain('&lt;script&gt;');
+    });
+});
+//# sourceMappingURL=build.test.js.map

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

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

package/dist/guides/chrome.d.ts

@@ -0,0 +1,24 @@
+/**
+ * THEME_INIT_JS — tiny blocking script for <head>.
+ *
+ * Reads saved theme or OS preference and sets [data-theme] on <html> before
+ * first paint, eliminating flash-of-unstyled-theme (FOUC) for dark-mode users.
+ * Must run synchronously in <head>; no toggle logic here.
+ */
+export declare const THEME_INIT_JS: string;
+/**
+ * CHROME_JS — self-contained IIFE for guide pages (end-of-body).
+ *
+ * Dark mode: keyed on [data-theme="dark"] on <html>, matching dashboard-theme.css.
+ * Initial theme application is handled by THEME_INIT_JS in <head>.
+ *
+ * Behaviours:
+ *  - theme     : [data-action=theme] toggles current data-theme + persists to localStorage
+ *  - mobile nav: [data-action=nav] toggles .open on .rail
+ *  - copy      : wrap every <pre> in <div class="code">, prepend <button class="copy-btn">Copy</button>
+ *  - tabs      : click .tab-btn → activate matching .tabpane within same .tabs group
+ *  - filter-table: .filter-input input → hide non-matching <tbody tr> in enclosing .filter-table
+ *  - scrollspy : IntersectionObserver on h2[id],h3[id]; marks .toc a[href="#id"] active
+ */
+export declare const CHROME_JS: string;
+//# sourceMappingURL=chrome.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chrome.d.ts","sourceRoot":"","sources":["../../src/guides/chrome.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,EAAE,MAGqD,CAAA;AAEjF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,SAAS,EAAE,MA4FlB,CAAA"}

package/dist/guides/chrome.js

@@ -0,0 +1,118 @@
+/**
+ * THEME_INIT_JS — tiny blocking script for <head>.
+ *
+ * Reads saved theme or OS preference and sets [data-theme] on <html> before
+ * first paint, eliminating flash-of-unstyled-theme (FOUC) for dark-mode users.
+ * Must run synchronously in <head>; no toggle logic here.
+ */
+export const THEME_INIT_JS = '(function(){try{var t=localStorage.getItem(\'guide-theme\');' +
+    'if(!t&&window.matchMedia&&matchMedia(\'(prefers-color-scheme: dark)\').matches)t=\'dark\';' +
+    'if(t)document.documentElement.setAttribute(\'data-theme\',t);}catch(e){}})();';
+/**
+ * CHROME_JS — self-contained IIFE for guide pages (end-of-body).
+ *
+ * Dark mode: keyed on [data-theme="dark"] on <html>, matching dashboard-theme.css.
+ * Initial theme application is handled by THEME_INIT_JS in <head>.
+ *
+ * Behaviours:
+ *  - theme     : [data-action=theme] toggles current data-theme + persists to localStorage
+ *  - mobile nav: [data-action=nav] toggles .open on .rail
+ *  - copy      : wrap every <pre> in <div class="code">, prepend <button class="copy-btn">Copy</button>
+ *  - tabs      : click .tab-btn → activate matching .tabpane within same .tabs group
+ *  - filter-table: .filter-input input → hide non-matching <tbody tr> in enclosing .filter-table
+ *  - scrollspy : IntersectionObserver on h2[id],h3[id]; marks .toc a[href="#id"] active
+ */
+export const CHROME_JS = /* js */ `(function(){
+  var LS_KEY = 'guide-theme';
+  function applyTheme(t) {
+    document.documentElement.setAttribute('data-theme', t);
+  }
+
+  document.addEventListener('DOMContentLoaded', function() {
+    // ─── Theme toggle ────────────────────────────────────────────────────────
+    document.querySelectorAll('[data-action="theme"]').forEach(function(btn) {
+      btn.addEventListener('click', function() {
+        var current = document.documentElement.getAttribute('data-theme');
+        var next = current === 'dark' ? 'light' : 'dark';
+        applyTheme(next);
+        try { localStorage.setItem(LS_KEY, next); } catch(e) {}
+      });
+    });
+
+    // ─── Mobile nav ──────────────────────────────────────────────────────────
+    document.querySelectorAll('[data-action="nav"]').forEach(function(btn) {
+      btn.addEventListener('click', function() {
+        var rail = document.querySelector('.rail');
+        if (rail) rail.classList.toggle('open');
+      });
+    });
+
+    // ─── Copy buttons ─────────────────────────────────────────────────────────
+    document.querySelectorAll('pre').forEach(function(pre) {
+      if (!pre.parentNode) return;
+      var wrapper = document.createElement('div');
+      wrapper.className = 'code';
+      pre.parentNode.insertBefore(wrapper, pre);
+      wrapper.appendChild(pre);
+      var btn = document.createElement('button');
+      btn.className = 'copy-btn';
+      btn.textContent = 'Copy';
+      btn.addEventListener('click', function() {
+        var text = pre.textContent || '';
+        if (navigator.clipboard && navigator.clipboard.writeText) {
+          navigator.clipboard.writeText(text).then(function() {
+            btn.textContent = 'Copied';
+            setTimeout(function() { btn.textContent = 'Copy'; }, 1200);
+          }, function() {
+            btn.textContent = 'Copy';
+          });
+        }
+      });
+      wrapper.insertBefore(btn, pre);
+    });
+
+    // ─── Tabs ─────────────────────────────────────────────────────────────────
+    document.querySelectorAll('.tabs').forEach(function(group) {
+      group.querySelectorAll('.tab-btn').forEach(function(btn) {
+        btn.addEventListener('click', function() {
+          var idx = btn.getAttribute('data-tab');
+          group.querySelectorAll('.tab-btn').forEach(function(b) {
+            b.classList.toggle('active', b === btn);
+          });
+          group.querySelectorAll('.tabpane').forEach(function(pane) {
+            pane.classList.toggle('active', pane.getAttribute('data-tab') === idx);
+          });
+        });
+      });
+    });
+
+    // ─── Filter tables ────────────────────────────────────────────────────────
+    document.querySelectorAll('.filter-input').forEach(function(input) {
+      input.addEventListener('input', function() {
+        var q = input.value.toLowerCase();
+        var container = input.closest('.filter-table');
+        if (!container) return;
+        container.querySelectorAll('tbody tr').forEach(function(row) {
+          var text = (row.textContent || '').toLowerCase();
+          row.style.display = text.includes(q) ? '' : 'none';
+        });
+      });
+    });
+
+    // ─── Scrollspy ────────────────────────────────────────────────────────────
+    if (typeof IntersectionObserver === 'undefined') return;
+    var headings = document.querySelectorAll('h2[id],h3[id]');
+    if (!headings.length) return;
+    var observer = new IntersectionObserver(function(entries) {
+      entries.forEach(function(entry) {
+        if (!entry.isIntersecting) return;
+        var id = entry.target.getAttribute('id');
+        document.querySelectorAll('.toc a').forEach(function(a) {
+          a.classList.toggle('active', a.getAttribute('href') === '#' + id);
+        });
+      });
+    }, { rootMargin: '0px 0px -70% 0px', threshold: 0 });
+    headings.forEach(function(h) { observer.observe(h); });
+  });
+})();`;
+//# sourceMappingURL=chrome.js.map

package/dist/guides/chrome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chrome.js","sourceRoot":"","sources":["../../src/guides/chrome.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,aAAa,GACxB,8DAA8D;IAC9D,4FAA4F;IAC5F,+EAA+E,CAAA;AAEjF;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,SAAS,GAAW,QAAQ,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MA4FpC,CAAA"}

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

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

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

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

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

@@ -0,0 +1,41 @@
+import { describe, it, expect } from 'vitest';
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { execFileSync } from 'node:child_process';
+import { listGuides, resolveGuide } from '../cli/commands/guides.js';
+const FM = '---\ntitle: MMR\ntopic: mmr\ndescription: review\ncategory: tools\norder: 10\n---\n# x\n';
+function fixture() {
+    const root = fs.mkdtempSync(path.join(os.tmpdir(), 'cli-'));
+    const dir = path.join(root, 'content', 'guides', 'mmr');
+    fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(path.join(dir, 'index.md'), FM);
+    fs.writeFileSync(path.join(dir, 'index.html'), '<html></html>');
+    return root;
+}
+describe('--no-open flag (yargs strict regression)', () => {
+    it('accepts --no-open without a strict-mode rejection', () => {
+        const cli = path.resolve('dist/index.js');
+        const out = execFileSync('node', [cli, 'guides', '--no-open', '--list', '--format', 'json'], { encoding: 'utf8' });
+        const parsed = JSON.parse(out);
+        expect(parsed.success).toBe(true);
+    });
+});
+describe('listGuides', () => {
+    it('returns guide summaries sorted by order', () => {
+        const list = listGuides(fixture());
+        expect(list).toEqual([{ topic: 'mmr', title: 'MMR', description: 'review', category: 'tools' }]);
+    });
+});
+describe('resolveGuide', () => {
+    it('returns md and html paths for a topic', () => {
+        const root = fixture();
+        const g = resolveGuide(root, 'mmr');
+        expect(g.mdPath.endsWith(path.join('mmr', 'index.md'))).toBe(true);
+        expect(g.htmlPath.endsWith(path.join('mmr', 'index.html'))).toBe(true);
+    });
+    it('returns null for an unknown topic', () => {
+        expect(resolveGuide(fixture(), 'nope')).toBeNull();
+    });
+});
+//# sourceMappingURL=cli-guides.test.js.map

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

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