@thanh01.pmt/presentation-kit 0.3.2 → 0.3.4

package/dist/node/index.d.ts

@@ -1,5 +1,35 @@
 import { H as HtmlCompileOptions, a as HtmlDeckData } from '../types-k_eae8UV.js';
 
+interface LayoutQaIssue {
+    slideIndex: number;
+    /** Largest fully-empty horizontal band, in stage px. */
+    deadBand: number;
+    /** Top edge of the dead band, in stage px. */
+    atY: number;
+}
+interface LayoutQaResult {
+    /** false = harness unavailable (no Chrome) — QA skipped, NOT failed. */
+    available: boolean;
+    issues: LayoutQaIssue[];
+    error?: string;
+}
+interface LayoutQaOptions {
+    /** Band height (stage px) that flags a slide. Default 400. */
+    threshold?: number;
+    /** Wall-clock budget for the whole headless run. Default 120s. */
+    timeoutMs?: number;
+}
+interface LayoutQaSlidePage {
+    /** Authored HTML for one slide (the `.bespoke-slide` inner markup). */
+    html: string;
+}
+/**
+ * Scanline QA over authored slide HTML: wraps each slide in a minimal deck
+ * shell (same class names the compiler emits), renders in headless Chromium,
+ * and flags slides whose largest content-free horizontal band ≥ threshold.
+ */
+declare function runSlideLayoutQa(slides: LayoutQaSlidePage[], options?: LayoutQaOptions): Promise<LayoutQaResult>;
+
 declare function resolveFontDir(): string | null;
 /**
  * `@font-face` CSS with base64 woff2 for the requested families (all vendored
@@ -33,4 +63,4 @@ declare function compileStandaloneHtmlDeck(deckData: HtmlDeckData, options?: Sta
 /** Off-box references a compiled deck still carries — must be empty to ship. */
 declare function findExternalReferences(html: string): string[];
 
-export { type StandaloneCompileOptions, collectDeckFontFamilies, compileStandaloneHtmlDeck, findExternalReferences, loadEmbeddedFontFaceCss, resolveFontDir };
+export { type LayoutQaIssue, type LayoutQaOptions, type LayoutQaResult, type LayoutQaSlidePage, type StandaloneCompileOptions, collectDeckFontFamilies, compileStandaloneHtmlDeck, findExternalReferences, loadEmbeddedFontFaceCss, resolveFontDir, runSlideLayoutQa };

package/dist/node/index.js

@@ -1,24 +1,184 @@
-import { compileHtmlDeck } from '../chunk-LVSQN2VI.js';
+import { compileHtmlDeck } from '../chunk-7ZQHP7OD.js';
 import fs from 'fs';
-import path from 'path';
+import path2 from 'path';
 import { fileURLToPath } from 'url';
+import os from 'os';
+import { execFile } from 'child_process';
 
+function chromeCandidates() {
+  if (process.env.LAYOUT_QA_CHROME) return [process.env.LAYOUT_QA_CHROME];
+  const linux = ["/usr/bin/chromium", "/usr/bin/chromium-browser", "/usr/bin/google-chrome"];
+  const mac = [
+    "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
+    "/Applications/Chromium.app/Contents/MacOS/Chromium"
+  ];
+  return process.platform === "darwin" ? [...mac, ...linux] : [...linux, ...mac];
+}
+function findChrome() {
+  for (const c of chromeCandidates()) {
+    try {
+      if (c && fs.existsSync(c)) return c;
+    } catch {
+    }
+  }
+  return null;
+}
+var PROBE = `(function(){
+  var H = 1080, ROW = 10, ROWS = Math.ceil(H / ROW);
+  var pages = Array.prototype.slice.call(document.querySelectorAll('.slide-page'));
+  var wrap = document.createElement('div');
+  wrap.style.cssText = 'position:fixed;left:0;top:0;width:1px;height:1px;overflow:hidden;';
+  var stage = document.createElement('div');
+  stage.className = 'slide-canvas';
+  stage.style.cssText = 'position:absolute;left:0;top:0;width:1920px;height:1080px;';
+  var inner = document.createElement('div');
+  inner.style.cssText = 'position:absolute;inset:0;';
+  stage.appendChild(inner);
+  wrap.appendChild(stage);
+  document.body.appendChild(wrap);
+  function hasDirectText(el) {
+    for (var n = el.firstChild; n; n = n.nextSibling) {
+      if (n.nodeType === 3 && n.textContent.trim().length > 0) return true;
+    }
+    return false;
+  }
+  var out = [];
+  for (var i = 0; i < pages.length; i++) {
+    var src = pages[i].querySelector('.bespoke-slide');
+    if (!src) { out.push(null); continue; }
+    inner.innerHTML = '';
+    inner.appendChild(src.cloneNode(true));
+    var all = stage.querySelectorAll('*');
+    for (var j = 0; j < all.length; j++) {
+      all[j].style.animation = 'none';
+      all[j].style.transition = 'none';
+      all[j].style.opacity = '1';
+      all[j].style.visibility = 'visible';
+      if (!/^(SVG|CANVAS|IMG|VIDEO)$/.test(all[j].tagName)) all[j].style.transform = 'none';
+    }
+    var stageTop = stage.getBoundingClientRect().top;
+    var rows = new Array(ROWS);
+    for (var k = 0; k < ROWS; k++) rows[k] = false;
+    var els = inner.querySelectorAll('*');
+    for (var e = 0; e < els.length; e++) {
+      var el = els[e];
+      var isVisual = /^(IMG|SVG|CANVAS|VIDEO)$/.test(el.tagName);
+      if (!isVisual && !hasDirectText(el)) continue;
+      var cs = getComputedStyle(el);
+      if (cs.display === 'none' || cs.visibility === 'hidden') continue;
+      var r = el.getBoundingClientRect();
+      if (r.width < 4 || r.height < 4) continue;
+      var t = r.top - stageTop;
+      var b = r.bottom - stageTop;
+      if (b <= 0 || t >= H) continue;
+      var k0 = Math.max(0, Math.floor(t / ROW));
+      var k1 = Math.min(ROWS, Math.ceil(b / ROW));
+      for (var k = k0; k < k1; k++) rows[k] = true;
+    }
+    var best = 0, bestStart = 0, cur = 0, curStart = 0;
+    for (var k = 2; k < ROWS - 2; k++) {
+      if (!rows[k]) {
+        if (cur === 0) curStart = k;
+        cur++;
+        if (cur > best) { best = cur; bestStart = curStart; }
+      } else cur = 0;
+    }
+    out.push({ deadBand: best * ROW, atY: bestStart * ROW });
+  }
+  wrap.remove();
+  document.title = 'QA_RESULT:' + JSON.stringify(out);
+})();`;
+async function runSlideLayoutQa(slides, options = {}) {
+  const threshold = options.threshold ?? 400;
+  const timeoutMs = options.timeoutMs ?? 12e4;
+  const chrome = findChrome();
+  if (!chrome) return { available: false, issues: [], error: "no chrome binary found" };
+  const themeCss = ":root{--bg:#ffffff;--bg-secondary:#f5f5f5;--primary:#1d4ed8;--accent:#f59e0b;--text:#111111;--text-muted:#555555;--border:#e5e7eb;--font-display:'Space Grotesk',sans-serif;--font-body:'Inter',sans-serif;--font-code:'JetBrains Mono',monospace;}";
+  const pagesHtml = slides.map((s) => `<div class="slide-page"><div class="bespoke-slide">${s.html}</div></div>`).join("\n");
+  const probeSafe = PROBE.replace(/<\/script/gi, "<\\/script");
+  const html = `<!doctype html><html><head><meta charset="utf-8"><style>
+${themeCss}
+.slide-canvas{position:relative;width:1920px;height:1080px;overflow:hidden;background:var(--bg);}
+.slide-page{position:absolute;inset:0;width:100%;height:100%;display:none;opacity:0;}
+.slide-page.active{display:block;opacity:1;}
+</style></head><body><div class="slide-canvas">
+${pagesHtml}
+</div><script>${probeSafe}</script></body></html>`;
+  const dir = fs.mkdtempSync(path2.join(os.tmpdir(), "layout-qa-"));
+  const file = path2.join(dir, "deck.html");
+  try {
+    fs.writeFileSync(file, html, "utf-8");
+    const args = [
+      "--headless=new",
+      "--no-sandbox",
+      "--disable-gpu",
+      "--disable-dev-shm-usage",
+      "--hide-scrollbars",
+      "--virtual-time-budget=5000",
+      "--window-size=1920,1200",
+      "--dump-dom",
+      `file://${file}`
+    ];
+    const stdout = await new Promise((resolve, reject) => {
+      execFile(
+        chrome,
+        args,
+        { timeout: timeoutMs, maxBuffer: 64 * 1024 * 1024 },
+        (err, stdout2) => {
+          if (err && !stdout2) return reject(err);
+          resolve(String(stdout2 || ""));
+        }
+      );
+    });
+    const marker = stdout.match(/QA_RESULT:(\[[\s\S]*?\])<\/title>/);
+    if (!marker) {
+      return {
+        available: true,
+        issues: slides.map((_, i) => ({ slideIndex: i + 1, deadBand: threshold, atY: 0 })),
+        error: "probe produced no result (chrome render failed?)"
+      };
+    }
+    const parsed = JSON.parse(marker[1]);
+    const issues = [];
+    for (let i = 0; i < parsed.length; i++) {
+      const row = parsed[i];
+      if (!row) continue;
+      if (row.deadBand >= threshold) {
+        issues.push({ slideIndex: i + 1, deadBand: row.deadBand, atY: row.atY });
+      }
+    }
+    return { available: true, issues };
+  } catch (err) {
+    return {
+      available: true,
+      issues: slides.map((_, i) => ({ slideIndex: i + 1, deadBand: threshold, atY: 0 })),
+      error: err?.message || String(err)
+    };
+  } finally {
+    try {
+      fs.rmSync(dir, { recursive: true, force: true });
+    } catch {
+    }
+  }
+}
+
+// src/node/index.ts
 var fontManifest = null;
 var fontFaceCache = /* @__PURE__ */ new Map();
 function fontDirCandidates() {
-  const here = path.dirname(fileURLToPath(import.meta.url));
+  const here = path2.dirname(fileURLToPath(import.meta.url));
   return [
     process.env.PRESENTATION_KIT_FONT_DIR || "",
     // dist/node/index.js → dist/assets/fonts
-    path.resolve(here, "../assets/fonts"),
-    path.resolve(here, "../..", "assets/fonts"),
+    path2.resolve(here, "../assets/fonts"),
+    path2.resolve(here, "../..", "assets/fonts"),
     // src/node/index.ts (tsx/vitest) → <pkg>/assets/fonts
-    path.resolve(here, "../../assets/fonts")
+    path2.resolve(here, "../../assets/fonts")
   ].filter(Boolean);
 }
 function resolveFontDir() {
   for (const dir of fontDirCandidates()) {
-    if (fs.existsSync(path.join(dir, "SOURCES.json"))) return dir;
+    if (fs.existsSync(path2.join(dir, "SOURCES.json"))) return dir;
   }
   return null;
 }
@@ -31,11 +191,11 @@ function loadManifest() {
     );
     return fontManifest = [];
   }
-  const parsed = JSON.parse(fs.readFileSync(path.join(dir, "SOURCES.json"), "utf-8"));
+  const parsed = JSON.parse(fs.readFileSync(path2.join(dir, "SOURCES.json"), "utf-8"));
   return fontManifest = parsed.fonts;
 }
 function base64(file, dir) {
-  return fs.readFileSync(path.join(dir, file)).toString("base64");
+  return fs.readFileSync(path2.join(dir, file)).toString("base64");
 }
 function loadEmbeddedFontFaceCss(families) {
   const dir = resolveFontDir();
@@ -100,6 +260,6 @@ function findExternalReferences(html) {
   return Array.from(new Set(refs));
 }
 
-export { collectDeckFontFamilies, compileStandaloneHtmlDeck, findExternalReferences, loadEmbeddedFontFaceCss, resolveFontDir };
+export { collectDeckFontFamilies, compileStandaloneHtmlDeck, findExternalReferences, loadEmbeddedFontFaceCss, resolveFontDir, runSlideLayoutQa };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/node/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/node/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["// ═══════════════════════════════════════════════════════════════════════════════\n// @learnwell/presentation-kit/node — Self-contained deck assembly (Node only)\n//\n// Kept OUT of the main entry on purpose: the browser entry (`compileHtmlDeck`,\n// `renderSlide`) must never pull `node:fs`. Server-side callers (curriculum-kit's\n// slide workflow, the app's artifact pipeline) use this module to produce a deck\n// that renders with typography intact and WITHOUT a single outbound request.\n//\n// What \"self-contained\" has to cover (measured on the old artifacts):\n//   1. fonts — were `<link>` to fonts.googleapis.com (gone offline → system fonts)\n//   2. Tailwind — was `<script src=\"https://cdn.tailwindcss.com\">` (gone offline →\n//      every slot-layout slide rendered unstyled)\n//   3. anything the AUTHORED slides bring in (handled by the sanitizer)\n// ═══════════════════════════════════════════════════════════════════════════════\n\nimport fs from 'node:fs';\nimport path from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { compileHtmlDeck } from '../html-engine/compiler.js';\nimport type { HtmlCompileOptions, HtmlDeckData } from '../html-engine/types.js';\n\ninterface FontSource {\n  family: string;\n  file: string;\n  weights: string;\n  license: string;\n  source: string;\n}\n\nlet fontManifest: FontSource[] | null = null;\nlet fontFaceCache = new Map<string, string>();\n\n/** Candidate asset dirs: published `dist/assets/fonts`, then the repo's `assets/fonts`. */\nfunction fontDirCandidates(): string[] {\n  const here = path.dirname(fileURLToPath(import.meta.url));\n  return [\n    process.env.PRESENTATION_KIT_FONT_DIR || '',\n    // dist/node/index.js → dist/assets/fonts\n    path.resolve(here, '../assets/fonts'),\n    path.resolve(here, '../..', 'assets/fonts'),\n    // src/node/index.ts (tsx/vitest) → <pkg>/assets/fonts\n    path.resolve(here, '../../assets/fonts'),\n  ].filter(Boolean) as string[];\n}\n\nexport function resolveFontDir(): string | null {\n  for (const dir of fontDirCandidates()) {\n    if (fs.existsSync(path.join(dir, 'SOURCES.json'))) return dir;\n  }\n  return null;\n}\n\nfunction loadManifest(): FontSource[] {\n  if (fontManifest) return fontManifest;\n  const dir = resolveFontDir();\n  if (!dir) {\n    console.warn(\n      '[presentation-kit/node] vendored fonts not found (assets/fonts/SOURCES.json) — ' +\n        'run `node scripts/vendor-fonts.mjs`. Decks will fall back to external font links.'\n    );\n    return (fontManifest = []);\n  }\n  const parsed = JSON.parse(fs.readFileSync(path.join(dir, 'SOURCES.json'), 'utf-8'));\n  return (fontManifest = parsed.fonts as FontSource[]);\n}\n\nfunction base64(file: string, dir: string): string {\n  return fs.readFileSync(path.join(dir, file)).toString('base64');\n}\n\n/**\n * `@font-face` CSS with base64 woff2 for the requested families (all vendored\n * families when omitted). Returns '' when nothing is vendored, so the shell\n * keeps its (external) fallback instead of silently rendering with no fonts.\n */\nexport function loadEmbeddedFontFaceCss(families?: string[]): string {\n  const dir = resolveFontDir();\n  const manifest = loadManifest();\n  if (!dir || manifest.length === 0) return '';\n\n  const wanted = families && families.length > 0 ? families : manifest.map((f) => f.family);\n  const cacheKey = [...wanted].sort().join('|');\n  const cached = fontFaceCache.get(cacheKey);\n  if (cached !== undefined) return cached;\n\n  const blocks: string[] = [];\n  for (const font of manifest) {\n    if (!wanted.includes(font.family)) continue;\n    const data = base64(font.file, dir);\n    blocks.push(\n      `@font-face{font-family:'${font.family}';font-style:normal;font-weight:${font.weights};` +\n        `font-display:swap;src:url(data:font/woff2;base64,${data}) format('woff2');}`\n    );\n  }\n  const css = blocks.join('\\n');\n  fontFaceCache.set(cacheKey, css);\n  return css;\n}\n\n/**\n * Which vendored families a compiled deck actually needs: the active theme's\n * display/body/code pairing, plus any vendored family named in the markup\n * (authored slides may reference one directly).\n */\nexport function collectDeckFontFamilies(html: string, theme: { typography?: Record<string, string> }): string[] {\n  const manifest = loadManifest();\n  const vendored = new Set(manifest.map((f) => f.family));\n  const found = new Set<string>();\n\n  // Only the PRIMARY family of each stack needs embedding: fallbacks exist for\n  // when the primary is unavailable, and an embedded primary never is. (The old\n  // code also pulled every fallback, e.g. Fira Code behind JetBrains Mono → +35KB\n  // per deck for a font that can never be reached.)\n  for (const value of Object.values(theme.typography || {})) {\n    const primary = String(value).split(',')[0].replace(/[\"']/g, '').trim();\n    if (vendored.has(primary)) found.add(primary);\n  }\n  // Authored slides may name a family directly (`font-family: 'Fira Code'`).\n  // The theme's own variable declarations are excluded: they legitimately list\n  // fallbacks, which must not drag a whole extra font into every deck.\n  const authoredOnly = html.replace(/--font-(?:display|body|code)\\s*:[^;]+;/g, '');\n  for (const family of vendored) {\n    if (new RegExp(`font-family[^;}]*${family.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')}`, 'i').test(authoredOnly)) {\n      found.add(family);\n    }\n  }\n  return Array.from(found);\n}\n\nexport interface StandaloneCompileOptions extends HtmlCompileOptions {\n  /** Skip embedding fonts (returns the deck with external font links). */\n  embedFonts?: boolean;\n}\n\n/**\n * Compiles a deck that needs no network at all: fonts embedded, utilities\n * inlined (the shell does that unconditionally now), markup sanitized.\n */\nexport function compileStandaloneHtmlDeck(\n  deckData: HtmlDeckData,\n  options: StandaloneCompileOptions = {}\n): { html: string; slideCount: number; theme: unknown; title: string; embeddedFonts: string[] } {\n  const base = compileHtmlDeck(deckData, options);\n  if (options.embedFonts === false) return { ...base, embeddedFonts: [] };\n\n  const families = collectDeckFontFamilies(base.html, base.theme as any);\n  const fontFaceCss = loadEmbeddedFontFaceCss(families);\n  if (!fontFaceCss) return { ...base, embeddedFonts: [] };\n\n  // The shell marks the block so this is an exact, single replacement — no\n  // regex surgery on the rest of the document.\n  const html = base.html.replace(\n    /<!-- DECK_FONT_BLOCK_START -->[\\s\\S]*?<!-- DECK_FONT_BLOCK_END -->/,\n    `<!-- DECK_FONT_BLOCK_START -->\\n  <style>\\n${fontFaceCss}\\n  </style>\\n  <!-- DECK_FONT_BLOCK_END -->`\n  );\n\n  return { ...base, html, embeddedFonts: families };\n}\n\n/** Off-box references a compiled deck still carries — must be empty to ship. */\nexport function findExternalReferences(html: string): string[] {\n  const refs: string[] = [];\n  for (const match of html.matchAll(/(?:https?:)?\\/\\/[a-z0-9.-]+\\.[a-z]{2,}[^\\s\"'<>)]*/gi)) {\n    const url = match[0];\n    // Namespaced identifiers (xmlns, schema URLs) are values, not fetches.\n    if (/^\\/\\/(www\\.)?w3\\.org/i.test(url)) continue;\n    if (/xmlns/i.test(html.slice(Math.max(0, (match.index ?? 0) - 24), match.index ?? 0))) continue;\n    refs.push(url);\n  }\n  return Array.from(new Set(refs));\n}\n"]}
+{"version":3,"sources":["../../src/node/layoutQa.ts","../../src/node/index.ts"],"names":["path","stdout","fs"],"mappings":"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","file":"index.js","sourcesContent":["// ═══════════════════════════════════════════════════════════════════════════════\n// @learnwell/presentation-kit/node — post-compile layout QA (headless scanline)\n//\n// Closes the gap ADR-0009 documented as the static lint's ceiling: authored\n// slides whose geometry hides a ≥400px vertical dead band (multi-column\n// layouts, footer bands, non-space-between holes) pass the HTML contract but\n// render with a hole. This harness drives a real browser, lays each slide out\n// at the REAL 1920×1080 stage, and applies the scanline test: a horizontal\n// band is \"occupied\" when any glyph, image or vector touches it.\n//\n// Optional capability, same contract family as validateBespokeSlideHtml:\n//   - no Chrome binary → returns { available: false }, caller keeps the deck\n//   - any harness error → every slide counts as flagged (fail-closed)\n//\n// ponytail: system Chromium only (no puppeteer bundle — deployment weight).\n// Upgrade path: real interaction QA (step-reveal walking) once needed.\n// ═══════════════════════════════════════════════════════════════════════════════\n\nimport fs from 'node:fs';\nimport os from 'node:os';\nimport path from 'node:path';\nimport { execFile } from 'node:child_process';\n\nfunction chromeCandidates(): string[] {\n  if (process.env.LAYOUT_QA_CHROME) return [process.env.LAYOUT_QA_CHROME];\n  const linux = ['/usr/bin/chromium', '/usr/bin/chromium-browser', '/usr/bin/google-chrome'];\n  const mac = [\n    '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',\n    '/Applications/Chromium.app/Contents/MacOS/Chromium',\n  ];\n  return process.platform === 'darwin' ? [...mac, ...linux] : [...linux, ...mac];\n}\n\nfunction findChrome(): string | null {\n  for (const c of chromeCandidates()) {\n    try {\n      if (c && fs.existsSync(c)) return c;\n    } catch {\n      /* unreadable path — skip */\n    }\n  }\n  return null;\n}\n\nexport interface LayoutQaIssue {\n  slideIndex: number;\n  /** Largest fully-empty horizontal band, in stage px. */\n  deadBand: number;\n  /** Top edge of the dead band, in stage px. */\n  atY: number;\n}\n\nexport interface LayoutQaResult {\n  /** false = harness unavailable (no Chrome) — QA skipped, NOT failed. */\n  available: boolean;\n  issues: LayoutQaIssue[];\n  error?: string;\n}\n\nexport interface LayoutQaOptions {\n  /** Band height (stage px) that flags a slide. Default 400. */\n  threshold?: number;\n  /** Wall-clock budget for the whole headless run. Default 120s. */\n  timeoutMs?: number;\n}\n\n/** Runs inside headless Chrome, writes results into document.title. */\nconst PROBE = `(function(){\n  var H = 1080, ROW = 10, ROWS = Math.ceil(H / ROW);\n  var pages = Array.prototype.slice.call(document.querySelectorAll('.slide-page'));\n  var wrap = document.createElement('div');\n  wrap.style.cssText = 'position:fixed;left:0;top:0;width:1px;height:1px;overflow:hidden;';\n  var stage = document.createElement('div');\n  stage.className = 'slide-canvas';\n  stage.style.cssText = 'position:absolute;left:0;top:0;width:1920px;height:1080px;';\n  var inner = document.createElement('div');\n  inner.style.cssText = 'position:absolute;inset:0;';\n  stage.appendChild(inner);\n  wrap.appendChild(stage);\n  document.body.appendChild(wrap);\n  function hasDirectText(el) {\n    for (var n = el.firstChild; n; n = n.nextSibling) {\n      if (n.nodeType === 3 && n.textContent.trim().length > 0) return true;\n    }\n    return false;\n  }\n  var out = [];\n  for (var i = 0; i < pages.length; i++) {\n    var src = pages[i].querySelector('.bespoke-slide');\n    if (!src) { out.push(null); continue; }\n    inner.innerHTML = '';\n    inner.appendChild(src.cloneNode(true));\n    var all = stage.querySelectorAll('*');\n    for (var j = 0; j < all.length; j++) {\n      all[j].style.animation = 'none';\n      all[j].style.transition = 'none';\n      all[j].style.opacity = '1';\n      all[j].style.visibility = 'visible';\n      if (!/^(SVG|CANVAS|IMG|VIDEO)$/.test(all[j].tagName)) all[j].style.transform = 'none';\n    }\n    var stageTop = stage.getBoundingClientRect().top;\n    var rows = new Array(ROWS);\n    for (var k = 0; k < ROWS; k++) rows[k] = false;\n    var els = inner.querySelectorAll('*');\n    for (var e = 0; e < els.length; e++) {\n      var el = els[e];\n      var isVisual = /^(IMG|SVG|CANVAS|VIDEO)$/.test(el.tagName);\n      if (!isVisual && !hasDirectText(el)) continue;\n      var cs = getComputedStyle(el);\n      if (cs.display === 'none' || cs.visibility === 'hidden') continue;\n      var r = el.getBoundingClientRect();\n      if (r.width < 4 || r.height < 4) continue;\n      var t = r.top - stageTop;\n      var b = r.bottom - stageTop;\n      if (b <= 0 || t >= H) continue;\n      var k0 = Math.max(0, Math.floor(t / ROW));\n      var k1 = Math.min(ROWS, Math.ceil(b / ROW));\n      for (var k = k0; k < k1; k++) rows[k] = true;\n    }\n    var best = 0, bestStart = 0, cur = 0, curStart = 0;\n    for (var k = 2; k < ROWS - 2; k++) {\n      if (!rows[k]) {\n        if (cur === 0) curStart = k;\n        cur++;\n        if (cur > best) { best = cur; bestStart = curStart; }\n      } else cur = 0;\n    }\n    out.push({ deadBand: best * ROW, atY: bestStart * ROW });\n  }\n  wrap.remove();\n  document.title = 'QA_RESULT:' + JSON.stringify(out);\n})();`;\n\nexport interface LayoutQaSlidePage {\n  /** Authored HTML for one slide (the `.bespoke-slide` inner markup). */\n  html: string;\n}\n\n/**\n * Scanline QA over authored slide HTML: wraps each slide in a minimal deck\n * shell (same class names the compiler emits), renders in headless Chromium,\n * and flags slides whose largest content-free horizontal band ≥ threshold.\n */\nexport async function runSlideLayoutQa(\n  slides: LayoutQaSlidePage[],\n  options: LayoutQaOptions = {}\n): Promise<LayoutQaResult> {\n  const threshold = options.threshold ?? 400;\n  const timeoutMs = options.timeoutMs ?? 120_000;\n  const chrome = findChrome();\n  if (!chrome) return { available: false, issues: [], error: 'no chrome binary found' };\n\n  // Minimal shell — theme vars mirror the compiled defaults so authored\n  // markup lays out with real colors/fonts; the probe only reads geometry.\n  const themeCss =\n    ':root{--bg:#ffffff;--bg-secondary:#f5f5f5;--primary:#1d4ed8;--accent:#f59e0b;--text:#111111;--text-muted:#555555;--border:#e5e7eb;' +\n    \"--font-display:'Space Grotesk',sans-serif;--font-body:'Inter',sans-serif;--font-code:'JetBrains Mono',monospace;}\";\n\n  const pagesHtml = slides\n    .map((s) => `<div class=\"slide-page\"><div class=\"bespoke-slide\">${s.html}</div></div>`)\n    .join('\\n');\n\n  const probeSafe = PROBE.replace(/<\\/script/gi, '<\\\\/script');\n  const html = `<!doctype html><html><head><meta charset=\"utf-8\"><style>\n${themeCss}\n.slide-canvas{position:relative;width:1920px;height:1080px;overflow:hidden;background:var(--bg);}\n.slide-page{position:absolute;inset:0;width:100%;height:100%;display:none;opacity:0;}\n.slide-page.active{display:block;opacity:1;}\n</style></head><body><div class=\"slide-canvas\">\n${pagesHtml}\n</div><script>${probeSafe}</script></body></html>`;\n\n  const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'layout-qa-'));\n  const file = path.join(dir, 'deck.html');\n  try {\n    fs.writeFileSync(file, html, 'utf-8');\n    const args = [\n      '--headless=new',\n      '--no-sandbox',\n      '--disable-gpu',\n      '--disable-dev-shm-usage',\n      '--hide-scrollbars',\n      '--virtual-time-budget=5000',\n      '--window-size=1920,1200',\n      '--dump-dom',\n      `file://${file}`,\n    ];\n    const stdout = await new Promise<string>((resolve, reject) => {\n      execFile(\n        chrome,\n        args,\n        { timeout: timeoutMs, maxBuffer: 64 * 1024 * 1024 },\n        (err, stdout) => {\n          if (err && !stdout) return reject(err);\n          resolve(String(stdout || ''));\n        }\n      );\n    });\n    const marker = stdout.match(/QA_RESULT:(\\[[\\s\\S]*?\\])<\\/title>/);\n    if (!marker) {\n      // Fail-closed: report every slide flagged rather than silently passing.\n      return {\n        available: true,\n        issues: slides.map((_, i) => ({ slideIndex: i + 1, deadBand: threshold, atY: 0 })),\n        error: 'probe produced no result (chrome render failed?)',\n      };\n    }\n    const parsed = JSON.parse(marker[1]);\n    const issues: LayoutQaIssue[] = [];\n    for (let i = 0; i < parsed.length; i++) {\n      const row = parsed[i];\n      if (!row) continue;\n      if (row.deadBand >= threshold) {\n        issues.push({ slideIndex: i + 1, deadBand: row.deadBand, atY: row.atY });\n      }\n    }\n    return { available: true, issues };\n  } catch (err: any) {\n    return {\n      available: true,\n      issues: slides.map((_, i) => ({ slideIndex: i + 1, deadBand: threshold, atY: 0 })),\n      error: err?.message || String(err),\n    };\n  } finally {\n    try {\n      fs.rmSync(dir, { recursive: true, force: true });\n    } catch {\n      /* temp dir best-effort cleanup */\n    }\n  }\n}\n","// ═══════════════════════════════════════════════════════════════════════════════\n// @learnwell/presentation-kit/node — Self-contained deck assembly (Node only)\n//\n// Kept OUT of the main entry on purpose: the browser entry (`compileHtmlDeck`,\n// `renderSlide`) must never pull `node:fs`. Server-side callers (curriculum-kit's\n// slide workflow, the app's artifact pipeline) use this module to produce a deck\n// that renders with typography intact and WITHOUT a single outbound request.\n//\n// What \"self-contained\" has to cover (measured on the old artifacts):\n//   1. fonts — were `<link>` to fonts.googleapis.com (gone offline → system fonts)\n//   2. Tailwind — was `<script src=\"https://cdn.tailwindcss.com\">` (gone offline →\n//      every slot-layout slide rendered unstyled)\n//   3. anything the AUTHORED slides bring in (handled by the sanitizer)\n// ═══════════════════════════════════════════════════════════════════════════════\n\nimport fs from 'node:fs';\nimport path from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { compileHtmlDeck } from '../html-engine/compiler.js';\nimport type { HtmlCompileOptions, HtmlDeckData } from '../html-engine/types.js';\n\ninterface FontSource {\n  family: string;\n  file: string;\n  weights: string;\n  license: string;\n  source: string;\n}\n\nlet fontManifest: FontSource[] | null = null;\nlet fontFaceCache = new Map<string, string>();\n\n/** Candidate asset dirs: published `dist/assets/fonts`, then the repo's `assets/fonts`. */\nfunction fontDirCandidates(): string[] {\n  const here = path.dirname(fileURLToPath(import.meta.url));\n  return [\n    process.env.PRESENTATION_KIT_FONT_DIR || '',\n    // dist/node/index.js → dist/assets/fonts\n    path.resolve(here, '../assets/fonts'),\n    path.resolve(here, '../..', 'assets/fonts'),\n    // src/node/index.ts (tsx/vitest) → <pkg>/assets/fonts\n    path.resolve(here, '../../assets/fonts'),\n  ].filter(Boolean) as string[];\n}\n\nexport function resolveFontDir(): string | null {\n  for (const dir of fontDirCandidates()) {\n    if (fs.existsSync(path.join(dir, 'SOURCES.json'))) return dir;\n  }\n  return null;\n}\n\nfunction loadManifest(): FontSource[] {\n  if (fontManifest) return fontManifest;\n  const dir = resolveFontDir();\n  if (!dir) {\n    console.warn(\n      '[presentation-kit/node] vendored fonts not found (assets/fonts/SOURCES.json) — ' +\n        'run `node scripts/vendor-fonts.mjs`. Decks will fall back to external font links.'\n    );\n    return (fontManifest = []);\n  }\n  const parsed = JSON.parse(fs.readFileSync(path.join(dir, 'SOURCES.json'), 'utf-8'));\n  return (fontManifest = parsed.fonts as FontSource[]);\n}\n\nfunction base64(file: string, dir: string): string {\n  return fs.readFileSync(path.join(dir, file)).toString('base64');\n}\n\n/**\n * `@font-face` CSS with base64 woff2 for the requested families (all vendored\n * families when omitted). Returns '' when nothing is vendored, so the shell\n * keeps its (external) fallback instead of silently rendering with no fonts.\n */\nexport function loadEmbeddedFontFaceCss(families?: string[]): string {\n  const dir = resolveFontDir();\n  const manifest = loadManifest();\n  if (!dir || manifest.length === 0) return '';\n\n  const wanted = families && families.length > 0 ? families : manifest.map((f) => f.family);\n  const cacheKey = [...wanted].sort().join('|');\n  const cached = fontFaceCache.get(cacheKey);\n  if (cached !== undefined) return cached;\n\n  const blocks: string[] = [];\n  for (const font of manifest) {\n    if (!wanted.includes(font.family)) continue;\n    const data = base64(font.file, dir);\n    blocks.push(\n      `@font-face{font-family:'${font.family}';font-style:normal;font-weight:${font.weights};` +\n        `font-display:swap;src:url(data:font/woff2;base64,${data}) format('woff2');}`\n    );\n  }\n  const css = blocks.join('\\n');\n  fontFaceCache.set(cacheKey, css);\n  return css;\n}\n\n/**\n * Which vendored families a compiled deck actually needs: the active theme's\n * display/body/code pairing, plus any vendored family named in the markup\n * (authored slides may reference one directly).\n */\nexport function collectDeckFontFamilies(html: string, theme: { typography?: Record<string, string> }): string[] {\n  const manifest = loadManifest();\n  const vendored = new Set(manifest.map((f) => f.family));\n  const found = new Set<string>();\n\n  // Only the PRIMARY family of each stack needs embedding: fallbacks exist for\n  // when the primary is unavailable, and an embedded primary never is. (The old\n  // code also pulled every fallback, e.g. Fira Code behind JetBrains Mono → +35KB\n  // per deck for a font that can never be reached.)\n  for (const value of Object.values(theme.typography || {})) {\n    const primary = String(value).split(',')[0].replace(/[\"']/g, '').trim();\n    if (vendored.has(primary)) found.add(primary);\n  }\n  // Authored slides may name a family directly (`font-family: 'Fira Code'`).\n  // The theme's own variable declarations are excluded: they legitimately list\n  // fallbacks, which must not drag a whole extra font into every deck.\n  const authoredOnly = html.replace(/--font-(?:display|body|code)\\s*:[^;]+;/g, '');\n  for (const family of vendored) {\n    if (new RegExp(`font-family[^;}]*${family.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')}`, 'i').test(authoredOnly)) {\n      found.add(family);\n    }\n  }\n  return Array.from(found);\n}\n\nexport interface StandaloneCompileOptions extends HtmlCompileOptions {\n  /** Skip embedding fonts (returns the deck with external font links). */\n  embedFonts?: boolean;\n}\n\n/**\n * Compiles a deck that needs no network at all: fonts embedded, utilities\n * inlined (the shell does that unconditionally now), markup sanitized.\n */\nexport function compileStandaloneHtmlDeck(\n  deckData: HtmlDeckData,\n  options: StandaloneCompileOptions = {}\n): { html: string; slideCount: number; theme: unknown; title: string; embeddedFonts: string[] } {\n  const base = compileHtmlDeck(deckData, options);\n  if (options.embedFonts === false) return { ...base, embeddedFonts: [] };\n\n  const families = collectDeckFontFamilies(base.html, base.theme as any);\n  const fontFaceCss = loadEmbeddedFontFaceCss(families);\n  if (!fontFaceCss) return { ...base, embeddedFonts: [] };\n\n  // The shell marks the block so this is an exact, single replacement — no\n  // regex surgery on the rest of the document.\n  const html = base.html.replace(\n    /<!-- DECK_FONT_BLOCK_START -->[\\s\\S]*?<!-- DECK_FONT_BLOCK_END -->/,\n    `<!-- DECK_FONT_BLOCK_START -->\\n  <style>\\n${fontFaceCss}\\n  </style>\\n  <!-- DECK_FONT_BLOCK_END -->`\n  );\n\n  return { ...base, html, embeddedFonts: families };\n}\n\n/** Off-box references a compiled deck still carries — must be empty to ship. */\nexport function findExternalReferences(html: string): string[] {\n  const refs: string[] = [];\n  for (const match of html.matchAll(/(?:https?:)?\\/\\/[a-z0-9.-]+\\.[a-z]{2,}[^\\s\"'<>)]*/gi)) {\n    const url = match[0];\n    // Namespaced identifiers (xmlns, schema URLs) are values, not fetches.\n    if (/^\\/\\/(www\\.)?w3\\.org/i.test(url)) continue;\n    if (/xmlns/i.test(html.slice(Math.max(0, (match.index ?? 0) - 24), match.index ?? 0))) continue;\n    refs.push(url);\n  }\n  return Array.from(new Set(refs));\n}\n\nexport { runSlideLayoutQa } from './layoutQa.js';\nexport type { LayoutQaIssue, LayoutQaResult, LayoutQaOptions, LayoutQaSlidePage } from './layoutQa.js';\n"]}

package/dist/react/index.cjs

@@ -1,8 +1,8 @@
 'use strict';
 
-var chunk2FJGU32M_cjs = require('../chunk-2FJGU32M.cjs');
+var chunkWKTPYYO2_cjs = require('../chunk-WKTPYYO2.cjs');
 var chunk3Q4RMZVQ_cjs = require('../chunk-3Q4RMZVQ.cjs');
-var chunkYO6TN5TA_cjs = require('../chunk-YO6TN5TA.cjs');
+var chunkKXX5PGN7_cjs = require('../chunk-KXX5PGN7.cjs');
 var React2 = require('react');
 var jsxRuntime = require('react/jsx-runtime');
 
@@ -26,7 +26,7 @@ function useSlideState(options) {
   const result = React2.useMemo(() => {
     if (!markdown || !markdown.trim()) return null;
     renderCountRef.current++;
-    return chunk2FJGU32M_cjs.renderSlide(markdown, {
+    return chunkWKTPYYO2_cjs.renderSlide(markdown, {
       theme,
       enableMermaid: true,
       enableClicks,
@@ -1338,7 +1338,7 @@ function SlideViewer({
       containers.forEach((container) => {
         if (container instanceof HTMLElement) {
           const themeName2 = typeof theme === "string" ? theme : "dark";
-          chunk2FJGU32M_cjs.renderMermaidDiagrams(container, themeName2).catch(() => {
+          chunkWKTPYYO2_cjs.renderMermaidDiagrams(container, themeName2).catch(() => {
           });
         }
       });
@@ -1622,7 +1622,7 @@ var HtmlSlideViewer = ({
   const fullHtml = React2.useMemo(() => {
     if (initialHtml) return initialHtml;
     if (deckData) {
-      return chunkYO6TN5TA_cjs.compileHtmlDeck(deckData).html;
+      return chunkKXX5PGN7_cjs.compileHtmlDeck(deckData).html;
     }
     return "";
   }, [initialHtml, deckData]);
@@ -1778,35 +1778,35 @@ var HtmlSlideViewer = ({
 
 Object.defineProperty(exports, "defineTheme", {
   enumerable: true,
-  get: function () { return chunk2FJGU32M_cjs.defineTheme; }
+  get: function () { return chunkWKTPYYO2_cjs.defineTheme; }
 });
 Object.defineProperty(exports, "extractMaxClicks", {
   enumerable: true,
-  get: function () { return chunk2FJGU32M_cjs.extractMaxClicks; }
+  get: function () { return chunkWKTPYYO2_cjs.extractMaxClicks; }
 });
 Object.defineProperty(exports, "generateClickCss", {
   enumerable: true,
-  get: function () { return chunk2FJGU32M_cjs.generateClickCss; }
+  get: function () { return chunkWKTPYYO2_cjs.generateClickCss; }
 });
 Object.defineProperty(exports, "postprocessClicks", {
   enumerable: true,
-  get: function () { return chunk2FJGU32M_cjs.postprocessClicks; }
+  get: function () { return chunkWKTPYYO2_cjs.postprocessClicks; }
 });
 Object.defineProperty(exports, "preprocessClicks", {
   enumerable: true,
-  get: function () { return chunk2FJGU32M_cjs.preprocessClicks; }
+  get: function () { return chunkWKTPYYO2_cjs.preprocessClicks; }
 });
 Object.defineProperty(exports, "renderSlide", {
   enumerable: true,
-  get: function () { return chunk2FJGU32M_cjs.renderSlide; }
+  get: function () { return chunkWKTPYYO2_cjs.renderSlide; }
 });
 Object.defineProperty(exports, "renderSlideAsync", {
   enumerable: true,
-  get: function () { return chunk2FJGU32M_cjs.renderSlideAsync; }
+  get: function () { return chunkWKTPYYO2_cjs.renderSlideAsync; }
 });
 Object.defineProperty(exports, "resolveTheme", {
   enumerable: true,
-  get: function () { return chunk2FJGU32M_cjs.resolveTheme; }
+  get: function () { return chunkWKTPYYO2_cjs.resolveTheme; }
 });
 exports.DeckView = DeckView;
 exports.HtmlSlideViewer = HtmlSlideViewer;

package/dist/react/index.js

@@ -1,7 +1,7 @@
-import { renderSlide, renderMermaidDiagrams } from '../chunk-FIBXWRWQ.js';
-export { defineTheme, extractMaxClicks, generateClickCss, postprocessClicks, preprocessClicks, renderSlide, renderSlideAsync, resolveTheme } from '../chunk-FIBXWRWQ.js';
+import { renderSlide, renderMermaidDiagrams } from '../chunk-UOWSDZEF.js';
+export { defineTheme, extractMaxClicks, generateClickCss, postprocessClicks, preprocessClicks, renderSlide, renderSlideAsync, resolveTheme } from '../chunk-UOWSDZEF.js';
 import { SLIDE_LAYOUT_PRESETS, updateSlideLayoutInMarkdown } from '../chunk-V6X7D44H.js';
-import { compileHtmlDeck } from '../chunk-LVSQN2VI.js';
+import { compileHtmlDeck } from '../chunk-7ZQHP7OD.js';
 import React2, { useState, useRef, useMemo, useEffect, useCallback } from 'react';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thanh01.pmt/presentation-kit",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "description": "Standalone client-side slide rendering engine with Marp, Shiki syntax highlighting, Mermaid diagrams, custom themes, and AI slide authoring tools.",
   "author": "Thanh Pham <https://github.com/thanh01pmt>",
   "license": "MIT",