@thanh01.pmt/presentation-kit 0.3.2 → 0.3.4

package/dist/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 chunkEAPUC5BA_cjs = require('./chunk-EAPUC5BA.cjs');
 
 // src/engine.ts
@@ -20,14 +20,14 @@ function createEngine(config = {}) {
   }
   return {
     render: (markdown, options) => {
-      return chunk2FJGU32M_cjs.renderSlide(markdown, mergeOptions(options));
+      return chunkWKTPYYO2_cjs.renderSlide(markdown, mergeOptions(options));
     },
     renderAsync: async (markdown, options) => {
-      return chunk2FJGU32M_cjs.renderSlideAsync(markdown, mergeOptions(options));
+      return chunkWKTPYYO2_cjs.renderSlideAsync(markdown, mergeOptions(options));
     },
     getThemeCss: (theme, containerId) => {
-      const resolved = chunk2FJGU32M_cjs.resolveTheme(theme);
-      return chunk2FJGU32M_cjs.generateScopedCss2(resolved, containerId);
+      const resolved = chunkWKTPYYO2_cjs.resolveTheme(theme);
+      return chunkWKTPYYO2_cjs.generateScopedCss2(resolved, containerId);
     }
   };
 }
@@ -103,7 +103,7 @@ async function convertMarkdownToPptx(markdown, options) {
   pptx.layout = "LAYOUT_WIDE";
   if (options?.title) pptx.title = options.title;
   if (options?.author) pptx.author = options.author;
-  const renderResult = chunk2FJGU32M_cjs.renderSlide(markdown);
+  const renderResult = chunkWKTPYYO2_cjs.renderSlide(markdown);
   const { slides } = chunk3Q4RMZVQ_cjs.splitMarkdownSlides(markdown);
   const isDark = options?.theme !== "light";
   const defaultBg = isDark ? "14151B" : "FFFFFF";
@@ -203,107 +203,107 @@ async function convertMarkdownToPptx(markdown, options) {
 
 Object.defineProperty(exports, "convertTextArrows", {
   enumerable: true,
-  get: function () { return chunk2FJGU32M_cjs.convertTextArrows; }
+  get: function () { return chunkWKTPYYO2_cjs.convertTextArrows; }
 });
 Object.defineProperty(exports, "countSlides", {
   enumerable: true,
-  get: function () { return chunk2FJGU32M_cjs.countSlides; }
+  get: function () { return chunkWKTPYYO2_cjs.countSlides; }
 });
 Object.defineProperty(exports, "darkThemeTokens", {
   enumerable: true,
-  get: function () { return chunk2FJGU32M_cjs.darkThemeTokens; }
+  get: function () { return chunkWKTPYYO2_cjs.darkThemeTokens; }
 });
 Object.defineProperty(exports, "defineTheme", {
   enumerable: true,
-  get: function () { return chunk2FJGU32M_cjs.defineTheme; }
+  get: function () { return chunkWKTPYYO2_cjs.defineTheme; }
 });
 Object.defineProperty(exports, "detectMermaidBlocks", {
   enumerable: true,
-  get: function () { return chunk2FJGU32M_cjs.detectMermaidBlocks; }
+  get: function () { return chunkWKTPYYO2_cjs.detectMermaidBlocks; }
 });
 Object.defineProperty(exports, "extractLayoutsAndNotes", {
   enumerable: true,
-  get: function () { return chunk2FJGU32M_cjs.extractLayoutsAndNotes; }
+  get: function () { return chunkWKTPYYO2_cjs.extractLayoutsAndNotes; }
 });
 Object.defineProperty(exports, "extractMarpSource", {
   enumerable: true,
-  get: function () { return chunk2FJGU32M_cjs.extractMarpSource; }
+  get: function () { return chunkWKTPYYO2_cjs.extractMarpSource; }
 });
 Object.defineProperty(exports, "extractMaxClicks", {
   enumerable: true,
-  get: function () { return chunk2FJGU32M_cjs.extractMaxClicks; }
+  get: function () { return chunkWKTPYYO2_cjs.extractMaxClicks; }
 });
 Object.defineProperty(exports, "filterPresenterNotes", {
   enumerable: true,
-  get: function () { return chunk2FJGU32M_cjs.filterPresenterNotes; }
+  get: function () { return chunkWKTPYYO2_cjs.filterPresenterNotes; }
 });
 Object.defineProperty(exports, "generateClickCss", {
   enumerable: true,
-  get: function () { return chunk2FJGU32M_cjs.generateClickCss; }
+  get: function () { return chunkWKTPYYO2_cjs.generateClickCss; }
 });
 Object.defineProperty(exports, "generateLayoutCss", {
   enumerable: true,
-  get: function () { return chunk2FJGU32M_cjs.generateLayoutCss; }
+  get: function () { return chunkWKTPYYO2_cjs.generateLayoutCss; }
 });
 Object.defineProperty(exports, "generateScopedCss", {
   enumerable: true,
-  get: function () { return chunk2FJGU32M_cjs.generateScopedCss2; }
+  get: function () { return chunkWKTPYYO2_cjs.generateScopedCss2; }
 });
 Object.defineProperty(exports, "generateScopedCssFromTokens", {
   enumerable: true,
-  get: function () { return chunk2FJGU32M_cjs.generateScopedCss; }
+  get: function () { return chunkWKTPYYO2_cjs.generateScopedCss; }
 });
 Object.defineProperty(exports, "getThemeTokens", {
   enumerable: true,
-  get: function () { return chunk2FJGU32M_cjs.getThemeTokens; }
+  get: function () { return chunkWKTPYYO2_cjs.getThemeTokens; }
 });
 Object.defineProperty(exports, "isLayoutComment", {
   enumerable: true,
-  get: function () { return chunk2FJGU32M_cjs.isLayoutComment; }
+  get: function () { return chunkWKTPYYO2_cjs.isLayoutComment; }
 });
 Object.defineProperty(exports, "lightThemeTokens", {
   enumerable: true,
-  get: function () { return chunk2FJGU32M_cjs.lightThemeTokens; }
+  get: function () { return chunkWKTPYYO2_cjs.lightThemeTokens; }
 });
 Object.defineProperty(exports, "navyThemeTokens", {
   enumerable: true,
-  get: function () { return chunk2FJGU32M_cjs.navyThemeTokens; }
+  get: function () { return chunkWKTPYYO2_cjs.navyThemeTokens; }
 });
 Object.defineProperty(exports, "parseLayoutFromComment", {
   enumerable: true,
-  get: function () { return chunk2FJGU32M_cjs.parseLayoutFromComment; }
+  get: function () { return chunkWKTPYYO2_cjs.parseLayoutFromComment; }
 });
 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, "renderMarp", {
   enumerable: true,
-  get: function () { return chunk2FJGU32M_cjs.renderMarp; }
+  get: function () { return chunkWKTPYYO2_cjs.renderMarp; }
 });
 Object.defineProperty(exports, "renderMermaidDiagrams", {
   enumerable: true,
-  get: function () { return chunk2FJGU32M_cjs.renderMermaidDiagrams; }
+  get: function () { return chunkWKTPYYO2_cjs.renderMermaidDiagrams; }
 });
 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; }
 });
 Object.defineProperty(exports, "sanitizeMermaidCode", {
   enumerable: true,
-  get: function () { return chunk2FJGU32M_cjs.sanitizeMermaidCode; }
+  get: function () { return chunkWKTPYYO2_cjs.sanitizeMermaidCode; }
 });
 Object.defineProperty(exports, "SLIDE_LAYOUT_PRESETS", {
   enumerable: true,
@@ -339,63 +339,63 @@ Object.defineProperty(exports, "updateSlideTextInMarkdown", {
 });
 Object.defineProperty(exports, "HTML_SLIDE_PRESETS", {
   enumerable: true,
-  get: function () { return chunkYO6TN5TA_cjs.HTML_SLIDE_PRESETS; }
+  get: function () { return chunkKXX5PGN7_cjs.HTML_SLIDE_PRESETS; }
 });
 Object.defineProperty(exports, "HTML_THEMES", {
   enumerable: true,
-  get: function () { return chunkYO6TN5TA_cjs.HTML_THEMES; }
+  get: function () { return chunkKXX5PGN7_cjs.HTML_THEMES; }
 });
 Object.defineProperty(exports, "SLIDE_UTILITY_CSS", {
   enumerable: true,
-  get: function () { return chunkYO6TN5TA_cjs.SLIDE_UTILITY_CSS; }
+  get: function () { return chunkKXX5PGN7_cjs.SLIDE_UTILITY_CSS; }
 });
 Object.defineProperty(exports, "buildBespokeSlideMarkup", {
   enumerable: true,
-  get: function () { return chunkYO6TN5TA_cjs.buildBespokeSlideMarkup; }
+  get: function () { return chunkKXX5PGN7_cjs.buildBespokeSlideMarkup; }
 });
 Object.defineProperty(exports, "compileHtmlDeck", {
   enumerable: true,
-  get: function () { return chunkYO6TN5TA_cjs.compileHtmlDeck; }
+  get: function () { return chunkKXX5PGN7_cjs.compileHtmlDeck; }
 });
 Object.defineProperty(exports, "compileHtmlDeckAsync", {
   enumerable: true,
-  get: function () { return chunkYO6TN5TA_cjs.compileHtmlDeckAsync; }
+  get: function () { return chunkKXX5PGN7_cjs.compileHtmlDeckAsync; }
 });
 Object.defineProperty(exports, "generateHtmlShell", {
   enumerable: true,
-  get: function () { return chunkYO6TN5TA_cjs.generateHtmlShell; }
+  get: function () { return chunkKXX5PGN7_cjs.generateHtmlShell; }
 });
 Object.defineProperty(exports, "getHighlighter", {
   enumerable: true,
-  get: function () { return chunkYO6TN5TA_cjs.getHighlighter; }
+  get: function () { return chunkKXX5PGN7_cjs.getHighlighter; }
 });
 Object.defineProperty(exports, "highlightCodeBlocks", {
   enumerable: true,
-  get: function () { return chunkYO6TN5TA_cjs.highlightCodeBlocks; }
+  get: function () { return chunkKXX5PGN7_cjs.highlightCodeBlocks; }
 });
 Object.defineProperty(exports, "highlightDeckCodeBlocks", {
   enumerable: true,
-  get: function () { return chunkYO6TN5TA_cjs.highlightDeckCodeBlocks; }
+  get: function () { return chunkKXX5PGN7_cjs.highlightDeckCodeBlocks; }
 });
 Object.defineProperty(exports, "listUtilityClasses", {
   enumerable: true,
-  get: function () { return chunkYO6TN5TA_cjs.listUtilityClasses; }
+  get: function () { return chunkKXX5PGN7_cjs.listUtilityClasses; }
 });
 Object.defineProperty(exports, "normalizeSlideSlots", {
   enumerable: true,
-  get: function () { return chunkYO6TN5TA_cjs.normalizeSlideSlots; }
+  get: function () { return chunkKXX5PGN7_cjs.normalizeSlideSlots; }
 });
 Object.defineProperty(exports, "resolveHtmlTheme", {
   enumerable: true,
-  get: function () { return chunkYO6TN5TA_cjs.resolveHtmlTheme; }
+  get: function () { return chunkKXX5PGN7_cjs.resolveHtmlTheme; }
 });
 Object.defineProperty(exports, "sanitizeSlideHtml", {
   enumerable: true,
-  get: function () { return chunkYO6TN5TA_cjs.sanitizeSlideHtml; }
+  get: function () { return chunkKXX5PGN7_cjs.sanitizeSlideHtml; }
 });
 Object.defineProperty(exports, "validateBespokeSlideHtml", {
   enumerable: true,
-  get: function () { return chunkYO6TN5TA_cjs.validateBespokeSlideHtml; }
+  get: function () { return chunkKXX5PGN7_cjs.validateBespokeSlideHtml; }
 });
 Object.defineProperty(exports, "FRONTEND_SLIDES_CORE_RULES", {
   enumerable: true,

package/dist/index.js

@@ -1,8 +1,8 @@
-import { resolveTheme, generateScopedCss2, renderSlideAsync, renderSlide } from './chunk-FIBXWRWQ.js';
-export { convertTextArrows, countSlides, darkThemeTokens, defineTheme, detectMermaidBlocks, extractLayoutsAndNotes, extractMarpSource, extractMaxClicks, filterPresenterNotes, generateClickCss, generateLayoutCss, generateScopedCss2 as generateScopedCss, generateScopedCss as generateScopedCssFromTokens, getThemeTokens, isLayoutComment, lightThemeTokens, navyThemeTokens, parseLayoutFromComment, postprocessClicks, preprocessClicks, renderMarp, renderMermaidDiagrams, renderSlide, renderSlideAsync, resolveTheme, sanitizeMermaidCode } from './chunk-FIBXWRWQ.js';
+import { resolveTheme, generateScopedCss2, renderSlideAsync, renderSlide } from './chunk-UOWSDZEF.js';
+export { convertTextArrows, countSlides, darkThemeTokens, defineTheme, detectMermaidBlocks, extractLayoutsAndNotes, extractMarpSource, extractMaxClicks, filterPresenterNotes, generateClickCss, generateLayoutCss, generateScopedCss2 as generateScopedCss, generateScopedCss as generateScopedCssFromTokens, getThemeTokens, isLayoutComment, lightThemeTokens, navyThemeTokens, parseLayoutFromComment, postprocessClicks, preprocessClicks, renderMarp, renderMermaidDiagrams, renderSlide, renderSlideAsync, resolveTheme, sanitizeMermaidCode } from './chunk-UOWSDZEF.js';
 import { splitMarkdownSlides } from './chunk-V6X7D44H.js';
 export { SLIDE_LAYOUT_PRESETS, getSlideLayoutPresetById, getSlideLayoutPresetsByCategory, removeSlideElementFromMarkdown, serializeLayoutToComment, splitMarkdownSlides, updateSlideLayoutInMarkdown, updateSlideTextInMarkdown } from './chunk-V6X7D44H.js';
-export { HTML_SLIDE_PRESETS, HTML_THEMES, SLIDE_UTILITY_CSS, buildBespokeSlideMarkup, compileHtmlDeck, compileHtmlDeckAsync, generateHtmlShell, getHighlighter, highlightCodeBlocks, highlightDeckCodeBlocks, listUtilityClasses, normalizeSlideSlots, resolveHtmlTheme, sanitizeSlideHtml, validateBespokeSlideHtml } from './chunk-LVSQN2VI.js';
+export { HTML_SLIDE_PRESETS, HTML_THEMES, SLIDE_UTILITY_CSS, buildBespokeSlideMarkup, compileHtmlDeck, compileHtmlDeckAsync, generateHtmlShell, getHighlighter, highlightCodeBlocks, highlightDeckCodeBlocks, listUtilityClasses, normalizeSlideSlots, resolveHtmlTheme, sanitizeSlideHtml, validateBespokeSlideHtml } from './chunk-7ZQHP7OD.js';
 export { FRONTEND_SLIDES_CORE_RULES, STYLE_PRESETS, TEMPLATES_CATALOG, VIEWPORT_BASE_CSS, frontendSlidesTools, getFrontendSlidesSkillPrompt, getSlideStylePresetSchema, getStylePreset, getStylePresetById, getTemplatesCatalog, querySlideTemplatesSchema, searchTemplates } from './chunk-WNPKREEW.js';
 
 // src/engine.ts

package/dist/node/index.cjs

@@ -1,32 +1,193 @@
 'use strict';
 
-var chunkYO6TN5TA_cjs = require('../chunk-YO6TN5TA.cjs');
+var chunkKXX5PGN7_cjs = require('../chunk-KXX5PGN7.cjs');
 var fs = require('fs');
-var path = require('path');
+var path2 = require('path');
 var url = require('url');
+var os = require('os');
+var child_process = require('child_process');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
 var fs__default = /*#__PURE__*/_interopDefault(fs);
-var path__default = /*#__PURE__*/_interopDefault(path);
+var path2__default = /*#__PURE__*/_interopDefault(path2);
+var os__default = /*#__PURE__*/_interopDefault(os);
 
+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__default.default.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__default.default.mkdtempSync(path2__default.default.join(os__default.default.tmpdir(), "layout-qa-"));
+  const file = path2__default.default.join(dir, "deck.html");
+  try {
+    fs__default.default.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) => {
+      child_process.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__default.default.rmSync(dir, { recursive: true, force: true });
+    } catch {
+    }
+  }
+}
+
+// src/node/index.ts
 var fontManifest = null;
 var fontFaceCache = /* @__PURE__ */ new Map();
 function fontDirCandidates() {
-  const here = path__default.default.dirname(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href))));
+  const here = path2__default.default.dirname(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href))));
   return [
     process.env.PRESENTATION_KIT_FONT_DIR || "",
     // dist/node/index.js → dist/assets/fonts
-    path__default.default.resolve(here, "../assets/fonts"),
-    path__default.default.resolve(here, "../..", "assets/fonts"),
+    path2__default.default.resolve(here, "../assets/fonts"),
+    path2__default.default.resolve(here, "../..", "assets/fonts"),
     // src/node/index.ts (tsx/vitest) → <pkg>/assets/fonts
-    path__default.default.resolve(here, "../../assets/fonts")
+    path2__default.default.resolve(here, "../../assets/fonts")
   ].filter(Boolean);
 }
 function resolveFontDir() {
   for (const dir of fontDirCandidates()) {
-    if (fs__default.default.existsSync(path__default.default.join(dir, "SOURCES.json"))) return dir;
+    if (fs__default.default.existsSync(path2__default.default.join(dir, "SOURCES.json"))) return dir;
   }
   return null;
 }
@@ -39,11 +200,11 @@ function loadManifest() {
     );
     return fontManifest = [];
   }
-  const parsed = JSON.parse(fs__default.default.readFileSync(path__default.default.join(dir, "SOURCES.json"), "utf-8"));
+  const parsed = JSON.parse(fs__default.default.readFileSync(path2__default.default.join(dir, "SOURCES.json"), "utf-8"));
   return fontManifest = parsed.fonts;
 }
 function base64(file, dir) {
-  return fs__default.default.readFileSync(path__default.default.join(dir, file)).toString("base64");
+  return fs__default.default.readFileSync(path2__default.default.join(dir, file)).toString("base64");
 }
 function loadEmbeddedFontFaceCss(families) {
   const dir = resolveFontDir();
@@ -82,7 +243,7 @@ function collectDeckFontFamilies(html, theme) {
   return Array.from(found);
 }
 function compileStandaloneHtmlDeck(deckData, options = {}) {
-  const base = chunkYO6TN5TA_cjs.compileHtmlDeck(deckData, options);
+  const base = chunkKXX5PGN7_cjs.compileHtmlDeck(deckData, options);
   if (options.embedFonts === false) return { ...base, embeddedFonts: [] };
   const families = collectDeckFontFamilies(base.html, base.theme);
   const fontFaceCss = loadEmbeddedFontFaceCss(families);
@@ -113,5 +274,6 @@ exports.compileStandaloneHtmlDeck = compileStandaloneHtmlDeck;
 exports.findExternalReferences = findExternalReferences;
 exports.loadEmbeddedFontFaceCss = loadEmbeddedFontFaceCss;
 exports.resolveFontDir = resolveFontDir;
+exports.runSlideLayoutQa = runSlideLayoutQa;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/node/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/node/index.ts"],"names":["path","fileURLToPath","fs","compileHtmlDeck"],"mappings":"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","file":"index.cjs","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":["fs","path","os","execFile","stdout","fileURLToPath","compileHtmlDeck"],"mappings":"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","file":"index.cjs","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/node/index.d.cts

@@ -1,5 +1,35 @@
 import { H as HtmlCompileOptions, a as HtmlDeckData } from '../types-k_eae8UV.cjs';
 
+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 };