@taloswork/ose-shared 0.1.6 → 0.1.8

package/skills/document/bin/html2pptx.cjs

@@ -69412,7 +69412,7 @@ var require_dir_writer = __commonJS({
     module2.exports = DirWriter;
     var Writer = require_writer();
     var inherits2 = require_inherits();
-    var mkdir = require_mkdirp();
+    var mkdir2 = require_mkdirp();
     var path = require("path");
     var collect = require_collect();
     inherits2(DirWriter, Writer);
@@ -69428,7 +69428,7 @@ var require_dir_writer = __commonJS({
     }
     DirWriter.prototype._create = function() {
       var self2 = this;
-      mkdir(self2._path, Writer.dirmode, function(er) {
+      mkdir2(self2._path, Writer.dirmode, function(er) {
         if (er) return self2.error(er);
         self2.ready = true;
         self2.emit("ready");
@@ -69773,7 +69773,7 @@ var require_writer = __commonJS({
     var fs = require_graceful_fs();
     var inherits2 = require_inherits();
     var rimraf = require_rimraf();
-    var mkdir = require_mkdirp();
+    var mkdir2 = require_mkdirp();
     var path = require("path");
     var umask = process.platform === "win32" ? 0 : process.umask();
     var getType = require_get_type();
@@ -69879,7 +69879,7 @@ var require_writer = __commonJS({
       }
     };
     function create(self2) {
-      mkdir(path.dirname(self2._path), Writer.dirmode, function(er, made) {
+      mkdir2(path.dirname(self2._path), Writer.dirmode, function(er, made) {
         if (er) return self2.error(er);
         self2._madeDir = made;
         return self2._create();
@@ -146935,7 +146935,7 @@ function themeCssVars(theme) {
     `--secondary:${c.secondary}`,
     `--text:${c.text}`,
     `--muted:${c.muted}`,
-    `--card-bg:${c.tableHeaderBg}`,
+    `--surface-card:${c.tableHeaderBg}`,
     `--border:${c.tableBorder}`,
     `--slide-bg:${theme.pptx.background}`,
     `--title-color:${theme.pptx.titleColor}`,
@@ -147823,8 +147823,14 @@ var LAYOUT_WALKER_JS = `
 })()
 `;
 
+// packages/core/dist/shared/async.js
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
 // packages/core/dist/document/html-pptx-headless.js
-var sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+var configuredSettleMs = Number(process.env.TALOS_CAPTURE_SETTLE_MS ?? 16);
+var CAPTURE_SETTLE_MS = Number.isFinite(configuredSettleMs) ? Math.max(0, Math.min(250, configuredSettleMs)) : 16;
 var pngDataUri = (bytes) => "data:image/png;base64," + Buffer.from(bytes).toString("base64");
 var isolateSlide = (si) => `new Promise((done) => { const secs = document.querySelectorAll("section.slide"); secs.forEach((s, j) => { s.style.display = j === ${si} ? "" : "none"; }); window.scrollTo(0, 0); requestAnimationFrame(() => requestAnimationFrame(() => done(true))); })`;
 var showAllSlides = `document.querySelectorAll("section.slide").forEach((s) => { s.style.display = ""; }); document.getElementById("__talos_hide")?.remove(); true`;
@@ -147839,7 +147845,7 @@ async function snapshotHeadless(page, opts = {}) {
     await page.evaluate(`(() => { document.querySelectorAll("*").forEach((el) => { const bake = getComputedStyle(el).getPropertyValue("--talos-bake").trim() === "1" || (el.closest && el.closest("[data-bake]")); if (bake) { const c = getComputedStyle(el).color; el.style.setProperty("color", c, "important"); el.style.setProperty("-webkit-text-fill-color", c, "important"); } }); const s = document.createElement("style"); s.id = "__talos_hide"; s.textContent = "*{color:transparent !important;-webkit-text-fill-color:transparent !important;text-shadow:none !important}"; document.head.appendChild(s); return true; })()`);
     for (let si = 0; si < snapshot.slides.length; si++) {
       await page.evaluate(isolateSlide(si));
-      await sleep(90);
+      await sleep(CAPTURE_SETTLE_MS);
       const png = await page.screenshot({ x: 0, y: 0, width: 1280, height: 720 });
       const backdropEl = { kind: "image", frame: { x: 0, y: 0, w: 1280, h: 720 }, data: pngDataUri(png) };
       const keepEls = snapshot.slides[si].elements.filter((e) => e && (e.kind === "text" || e.kind === "chart"));
@@ -147854,7 +147860,7 @@ async function snapshotHeadless(page, opts = {}) {
       if (!Array.isArray(els) || !els.some((e) => e && e.kind === "capture"))
         continue;
       await page.evaluate(isolateSlide(si));
-      await sleep(90);
+      await sleep(CAPTURE_SETTLE_MS);
       for (const el of els) {
         if (!el || el.kind !== "capture")
           continue;
@@ -147883,12 +147889,16 @@ async function snapshotHeadless(page, opts = {}) {
   }
   return snapshot;
 }
-async function rasterizeHeadless(page) {
+async function rasterizeHeadless(page, slideIndexes) {
   const count = Number(await page.evaluate('document.querySelectorAll("section.slide").length'));
   if (!count)
     throw new Error('no <section class="slide"> found');
+  const indexes = slideIndexes ?? Array.from({ length: count }, (_2, i) => i);
+  if (indexes.length === 0 || indexes.some((i) => !Number.isInteger(i) || i < 0 || i >= count)) {
+    throw new Error(`preview page is out of bounds (deck has ${count} slide${count === 1 ? "" : "s"})`);
+  }
   const shots = [];
-  for (let i = 0; i < count; i++) {
+  for (const i of indexes) {
     await page.evaluate(`new Promise((done) => { window.scrollTo(0, document.querySelectorAll("section.slide")[${i}].offsetTop); requestAnimationFrame(() => requestAnimationFrame(() => done(true))); })`);
     const png = await page.screenshot({ x: 0, y: 0, width: 1280, height: 720 });
     shots.push(Buffer.from(png).toString("base64"));
@@ -147948,7 +147958,9 @@ async function inlineHtmlImages(html, resolve) {
 // packages/core/dist/document/deck-catalog.js
 var KINDS = ["skin", "pack"];
 var MODES = ["light", "dark"];
+var RENDER_MODES = ["classic-v1", "theme-v2"];
 var ID_RE = /^[a-z0-9][a-z0-9-]*$/;
+var COMMIT_RE = /^[0-9a-f]{7,40}$/;
 function isStr(v) {
   return typeof v === "string" && v.length > 0;
 }
@@ -147978,6 +147990,35 @@ function parseCatalog(raw) {
       groups.push({ id: g.id, name_cn: g.name_cn, sample: g.sample, scenarios: g.scenarios });
     }
   });
+  const collections = [];
+  const rawCollections = o.collections === void 0 ? [] : Array.isArray(o.collections) ? o.collections : [];
+  if (o.collections !== void 0 && !Array.isArray(o.collections))
+    errors.push("catalog.collections must be an array when present");
+  rawCollections.forEach((c, i) => {
+    const at = `collection[${i}]`;
+    const before = errors.length;
+    if (!isStr(c?.id) || !ID_RE.test(c.id))
+      errors.push(`${at}: bad id`);
+    if (!isStr(c?.name_cn))
+      errors.push(`${at}: missing name_cn`);
+    if (!isStr(c?.renderMode) || !RENDER_MODES.includes(c.renderMode))
+      errors.push(`${at}: bad renderMode`);
+    if (!isStrArr(c?.entryIds) || c.entryIds.length === 0)
+      errors.push(`${at}: entryIds must be a non-empty string array`);
+    if (c?.sourceCommit !== void 0 && (!isStr(c.sourceCommit) || !COMMIT_RE.test(c.sourceCommit)))
+      errors.push(`${at}: bad sourceCommit`);
+    if (c?.renderMode === "classic-v1" && c?.sourceCommit === void 0)
+      errors.push(`${at}: classic-v1 requires sourceCommit`);
+    if (errors.length === before) {
+      collections.push({
+        id: c.id,
+        name_cn: c.name_cn,
+        renderMode: c.renderMode,
+        entryIds: c.entryIds,
+        ...c.sourceCommit !== void 0 ? { sourceCommit: c.sourceCommit } : {}
+      });
+    }
+  });
   const entries = [];
   const rawEntries = Array.isArray(o.entries) ? o.entries : [];
   if (!Array.isArray(o.entries))
@@ -148017,11 +148058,14 @@ function parseCatalog(raw) {
       });
     }
   });
-  return { catalog: errors.length ? null : { groups, entries }, errors };
+  return { catalog: errors.length ? null : { groups, ...collections.length ? { collections } : {}, entries }, errors };
 }
 function resolveEntry(catalog, id) {
   return catalog.entries.find((e) => e.id === id) ?? null;
 }
+function renderModeOf(catalog, id) {
+  return catalog.collections?.find((c) => c.entryIds.includes(id))?.renderMode ?? "theme-v2";
+}
 function assetDirOf(entry) {
   return entry.kind === "skin" ? `styles/${entry.id}` : `packs/${entry.id}`;
 }
@@ -148029,6 +148073,108 @@ function cssFileOf(entry) {
   return entry.kind === "skin" ? "skin.css" : "pack.css";
 }
 
+// packages/core/dist/shared/guards.js
+function isRecord(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+
+// packages/core/dist/document/deck-theme-system.js
+var ID_RE2 = /^[a-z0-9][a-z0-9-]*$/;
+var PATH_RE = /^[a-z0-9_./-]+\.css$/i;
+function isSafeCssPath(v) {
+  return typeof v === "string" && PATH_RE.test(v) && !v.startsWith("/") && !v.includes("..");
+}
+function parsePathMap(value, at, errors) {
+  if (!isRecord(value)) {
+    errors.push(`${at} must be an object`);
+    return {};
+  }
+  const out = {};
+  for (const [id, path] of Object.entries(value)) {
+    if (!ID_RE2.test(id))
+      errors.push(`${at}.${id}: bad id`);
+    if (!isSafeCssPath(path)) {
+      errors.push(`${at}.${id}: must be a safe relative .css path`);
+      continue;
+    }
+    out[id] = path;
+  }
+  return out;
+}
+function parseThemeSystem(raw) {
+  const errors = [];
+  if (!isRecord(raw))
+    return { system: null, errors: ["theme system is not an object"] };
+  if (raw.version !== 2)
+    errors.push("theme system version must be 2");
+  if (!isSafeCssPath(raw.componentBase)) {
+    errors.push("componentBase must be a safe relative .css path");
+  }
+  if (!isSafeCssPath(raw.artBase)) {
+    errors.push("artBase must be a safe relative .css path");
+  }
+  const componentProfiles = parsePathMap(raw.componentProfiles, "componentProfiles", errors);
+  const mediaStyles = parsePathMap(raw.mediaStyles, "mediaStyles", errors);
+  const artDirections = parsePathMap(raw.artDirections, "artDirections", errors);
+  const bindings = {};
+  if (!isRecord(raw.bindings))
+    errors.push("bindings must be an object");
+  else {
+    for (const [id, value] of Object.entries(raw.bindings)) {
+      const at = `bindings.${id}`;
+      if (!ID_RE2.test(id))
+        errors.push(`${at}: bad id`);
+      if (!isRecord(value)) {
+        errors.push(`${at} must be an object`);
+        continue;
+      }
+      const componentProfile = value.componentProfile;
+      const mediaStyle = value.mediaStyle;
+      const artDirection = value.artDirection;
+      if (typeof componentProfile !== "string" || !ID_RE2.test(componentProfile))
+        errors.push(`${at}: bad componentProfile`);
+      if (typeof mediaStyle !== "string" || !ID_RE2.test(mediaStyle))
+        errors.push(`${at}: bad mediaStyle`);
+      if (typeof artDirection !== "string" || !ID_RE2.test(artDirection))
+        errors.push(`${at}: bad artDirection`);
+      if (typeof componentProfile === "string" && typeof mediaStyle === "string" && typeof artDirection === "string") {
+        bindings[id] = { componentProfile, mediaStyle, artDirection };
+      }
+    }
+  }
+  if (errors.length)
+    return { system: null, errors };
+  return {
+    system: {
+      version: 2,
+      componentBase: raw.componentBase,
+      artBase: raw.artBase,
+      componentProfiles,
+      mediaStyles,
+      artDirections,
+      bindings
+    },
+    errors
+  };
+}
+function resolveThemeLayers(system, styleId, mediaOverride) {
+  const binding = system.bindings[styleId];
+  if (!binding)
+    return null;
+  const mediaStyle = mediaOverride ?? binding.mediaStyle;
+  const componentPath = system.componentProfiles[binding.componentProfile];
+  const mediaPath = system.mediaStyles[mediaStyle];
+  const artPath = system.artDirections[binding.artDirection];
+  if (!componentPath || !mediaPath || !artPath)
+    return null;
+  return {
+    paths: [system.componentBase, componentPath, mediaPath, system.artBase, artPath],
+    componentProfile: binding.componentProfile,
+    mediaStyle,
+    artDirection: binding.artDirection
+  };
+}
+
 // apps/admin/data/skills.lib/document/bin-src/html2pptx.mjs
 function imageResolver(baseDir) {
   return async (src) => {
@@ -148047,6 +148193,19 @@ function die(msg, code = 1) {
 `);
   process.exit(code);
 }
+function parsePreviewPages(spec) {
+  if (!spec || spec.trim().toLowerCase() === "all") return null;
+  const pages = [];
+  for (const part of spec.split(",")) {
+    const match = /^(\d+)(?:-(\d+))?$/.exec(part.trim());
+    if (!match) die(`bad preview page spec: ${spec} (use all or N,N-M)`, 64);
+    const from = Number(match[1]);
+    const to = match[2] ? Number(match[2]) : from;
+    if (from < 1 || to < from) die(`bad preview page range: ${part}`, 64);
+    for (let p = from; p <= to; p++) if (!pages.includes(p - 1)) pages.push(p - 1);
+  }
+  return pages;
+}
 var _tailwindCss;
 async function tailwindCss() {
   if (_tailwindCss !== void 0) return _tailwindCss;
@@ -148102,7 +148261,7 @@ async function latinFontFaceCss(doc) {
   }
   return _latinFontCss;
 }
-async function withHeadlessPage(html, fn) {
+async function withHeadlessPage(html, fn, density = DOCUMENT_CAPTURE_DENSITY) {
   const headless = (process.env.TALOS_HTML2PPTX_HEADLESS ?? "").trim().toLowerCase();
   if (headless === "off" || headless === "none" || headless === "0" || headless === "false") return null;
   let pw;
@@ -148121,7 +148280,7 @@ async function withHeadlessPage(html, fn) {
   try {
     const page = await browser2.newPage({
       viewport: { width: 1280, height: 720 },
-      deviceScaleFactor: DOCUMENT_CAPTURE_DENSITY
+      deviceScaleFactor: density
     });
     await page.setContent(html, { waitUntil: "load" });
     await page.evaluate("document.fonts && document.fonts.ready").catch(() => {
@@ -148131,7 +148290,7 @@ async function withHeadlessPage(html, fn) {
       screenshot: async (clip) => {
         const png = await page.screenshot({ clip });
         const w = png.readUInt32BE(16), h = png.readUInt32BE(20);
-        const want = [clip.width * DOCUMENT_CAPTURE_DENSITY, clip.height * DOCUMENT_CAPTURE_DENSITY];
+        const want = [clip.width * density, clip.height * density];
         if (w !== want[0] || h !== want[1]) throw new Error(`captured ${w}x${h}, expected ${want[0]}x${want[1]}`);
         return png;
       }
@@ -148197,19 +148356,38 @@ async function main() {
   const themePath = themeIdx >= 0 ? args[themeIdx + 1] : void 0;
   const styleIdx = args.indexOf("--style");
   const styleArg = styleIdx >= 0 ? args[styleIdx + 1] : void 0;
+  const themeV2 = args.includes("--theme-v2");
+  const mediaIdx = args.indexOf("--media-style");
+  const mediaStyleArg = mediaIdx >= 0 ? args[mediaIdx + 1] : void 0;
   const bdIdx = args.indexOf("--backdrop");
   const bdVariant = bdIdx >= 0 ? args[bdIdx + 1] : void 0;
   const lineIdx = args.indexOf("--line");
   const lineArg = lineIdx >= 0 ? args[lineIdx + 1] : void 0;
   const notesIdx = args.indexOf("--notes-doc");
   const notesDocPath = notesIdx >= 0 ? args[notesIdx + 1] : void 0;
-  const consumed = /* @__PURE__ */ new Set([themeIdx, themeIdx >= 0 ? themeIdx + 1 : -1, styleIdx, styleIdx >= 0 ? styleIdx + 1 : -1, bdIdx, bdIdx >= 0 ? bdIdx + 1 : -1, lineIdx, lineIdx >= 0 ? lineIdx + 1 : -1, modeIdx, modeIdx >= 0 ? modeIdx + 1 : -1, notesIdx, notesIdx >= 0 ? notesIdx + 1 : -1]);
-  const positional = args.filter((a, i) => a !== "--rasterize" && a !== "--editable" && !consumed.has(i));
+  const previewIdx = args.indexOf("--preview-dir");
+  const previewDir = previewIdx >= 0 ? args[previewIdx + 1] : void 0;
+  const previewPagesIdx = args.indexOf("--preview-pages");
+  const previewPagesArg = previewPagesIdx >= 0 ? args[previewPagesIdx + 1] : void 0;
+  const previewIndexes = parsePreviewPages(previewPagesArg);
+  const previewDensityIdx = args.indexOf("--preview-density");
+  const previewDensityArg = previewDensityIdx >= 0 ? args[previewDensityIdx + 1] : void 0;
+  const previewDensity = previewDensityArg === void 0 ? DOCUMENT_CAPTURE_DENSITY : Number(previewDensityArg);
+  const consumed = /* @__PURE__ */ new Set([themeIdx, themeIdx >= 0 ? themeIdx + 1 : -1, styleIdx, styleIdx >= 0 ? styleIdx + 1 : -1, mediaIdx, mediaIdx >= 0 ? mediaIdx + 1 : -1, bdIdx, bdIdx >= 0 ? bdIdx + 1 : -1, lineIdx, lineIdx >= 0 ? lineIdx + 1 : -1, modeIdx, modeIdx >= 0 ? modeIdx + 1 : -1, notesIdx, notesIdx >= 0 ? notesIdx + 1 : -1, previewIdx, previewIdx >= 0 ? previewIdx + 1 : -1, previewPagesIdx, previewPagesIdx >= 0 ? previewPagesIdx + 1 : -1, previewDensityIdx, previewDensityIdx >= 0 ? previewDensityIdx + 1 : -1]);
+  const positional = args.filter((a, i) => a !== "--rasterize" && a !== "--editable" && a !== "--theme-v2" && !consumed.has(i));
   const [input, out] = positional;
-  if (!input || !out) die("usage: html2pptx <in.html|in.layout.json> <out.pptx> [--theme <theme.json>] [--style <name|dir>] [--backdrop <variant>] [--line <name|none>] [--editable] [--rasterize] [--notes-doc <out.md>]", 64);
-  if (!/\.pptx$/i.test(out)) die("output must be a .pptx path", 64);
+  if (!input || !out && !previewDir) die("usage: html2pptx <in.html|in.layout.json> [out.pptx] [--theme <theme.json>] [--style <name|dir>] [--theme-v2] [--media-style <id>] [--backdrop <variant>] [--line <name|none>] [--editable] [--rasterize] [--notes-doc <out.md>] [--preview-dir <dir>] [--preview-pages <all|N,N-M>] [--preview-density <1..4>]", 64);
+  if (previewPagesArg && !previewDir) die("--preview-pages requires --preview-dir", 64);
+  if (previewDensityArg !== void 0 && !previewDir) die("--preview-density requires --preview-dir", 64);
+  if (!(previewDensity > 0 && previewDensity <= 4)) die("--preview-density must be a number in (0, 4]", 64);
+  if (previewDir && out) die("--preview-dir is preview-only; omit the .pptx output", 64);
+  if (previewDir && (rasterize || forceEditable || notesDocPath)) die("--preview-dir cannot be combined with --rasterize, --editable/--mode, or --notes-doc", 64);
+  if (themeV2 && !styleArg) die("--theme-v2 requires --style <catalog-id>", 64);
+  if (mediaStyleArg && !themeV2) die("--media-style requires --theme-v2", 64);
+  if (!previewDir && !/\.pptx$/i.test(out)) die("output must be a .pptx path", 64);
   const raw = await (0, import_promises.readFile)(input, "utf8").catch((e) => die(`cannot read ${input}: ${e.message}`, 66));
   if (/\.json$/i.test(input)) {
+    if (previewDir) die("--preview-dir requires HTML input", 64);
     let snapshot2;
     try {
       snapshot2 = JSON.parse(raw);
@@ -148249,18 +148427,17 @@ async function main() {
   let skinCss = "", backdropHtml = "", skinAccent = "", skinAxis = "", skinChart1 = "";
   if (styleArg) {
     const skillDir = (0, import_node_path.dirname)((0, import_node_path.dirname)(process.argv[1] || ""));
-    let styleDir, cssName = "skin.css";
+    let styleDir, cssName = "skin.css", entry = null, catalog = null;
     if ((0, import_node_fs.existsSync)((0, import_node_path.join)(styleArg, "skin.css"))) {
       styleDir = styleArg;
     } else if ((0, import_node_fs.existsSync)((0, import_node_path.join)(styleArg, "pack.css"))) {
       styleDir = styleArg;
       cssName = "pack.css";
     } else {
-      let entry = null;
       const catalogPath = (0, import_node_path.join)(skillDir, "catalog.json");
       if ((0, import_node_fs.existsSync)(catalogPath)) {
         try {
-          const { catalog } = parseCatalog(JSON.parse((0, import_node_fs.readFileSync)(catalogPath, "utf8")));
+          ({ catalog } = parseCatalog(JSON.parse((0, import_node_fs.readFileSync)(catalogPath, "utf8"))));
           if (catalog) entry = resolveEntry(catalog, styleArg);
         } catch {
         }
@@ -148275,7 +148452,27 @@ async function main() {
       die(`cannot read style ${skinPath}: ${e.message}`, 66);
     }
     const defaultsPath = (0, import_node_path.join)(skillDir, "styles", "_contract-defaults.css");
-    if ((0, import_node_fs.existsSync)(defaultsPath)) skinCss = await (0, import_promises.readFile)(defaultsPath, "utf8") + "\n" + skinCss;
+    let v2Css = "";
+    if (themeV2) {
+      if (!entry) die("--theme-v2 requires a catalog style id (explicit style directories are V1 only)", 64);
+      if (catalog && renderModeOf(catalog, entry.id) === "classic-v1") {
+        die(`style "${entry.id}" is frozen in collection "original-13" as classic-v1; omit --theme-v2 and --media-style`, 64);
+      }
+      const registryPath = (0, import_node_path.join)(skillDir, "theme-system.json");
+      let parsed;
+      try {
+        parsed = parseThemeSystem(JSON.parse(await (0, import_promises.readFile)(registryPath, "utf8")));
+      } catch (e) {
+        die(`cannot read Theme V2 registry ${registryPath}: ${e.message}`, 66);
+      }
+      if (!parsed.system) die(`invalid Theme V2 registry: ${parsed.errors.join("; ")}`, 66);
+      const layers = resolveThemeLayers(parsed.system, entry.id, mediaStyleArg);
+      if (!layers) die(`Theme V2 cannot resolve style "${entry.id}"${mediaStyleArg ? ` with media style "${mediaStyleArg}"` : ""}`, 66);
+      for (const rel of layers.paths) v2Css += await (0, import_promises.readFile)((0, import_node_path.join)(skillDir, rel), "utf8") + "\n";
+      process.stderr.write(`html2pptx: Theme V2 ${entry.id} = components:${layers.componentProfile} + media:${layers.mediaStyle} + art:${layers.artDirection}
+`);
+    }
+    skinCss = ((0, import_node_fs.existsSync)(defaultsPath) ? await (0, import_promises.readFile)(defaultsPath, "utf8") + "\n" : "") + v2Css + skinCss;
     const sharedBackdropsDir = (0, import_node_path.join)(skillDir, "styles", "_backdrops");
     const NO_AUTO_BACKDROP_VARIETY = /* @__PURE__ */ new Set(["mckinsey", "mono", "cinereel"]);
     let bdPath;
@@ -148289,7 +148486,7 @@ async function main() {
 `);
         bdPath = (0, import_node_path.join)(styleDir, "backdrop.html");
       }
-    } else if (NO_AUTO_BACKDROP_VARIETY.has((0, import_node_path.basename)(styleDir))) {
+    } else if (themeV2 || NO_AUTO_BACKDROP_VARIETY.has((0, import_node_path.basename)(styleDir))) {
       bdPath = (0, import_node_path.join)(styleDir, "backdrop.html");
     } else {
       const ownVariants = (0, import_node_fs.existsSync)(styleDir) ? (0, import_node_fs.readdirSync)(styleDir).filter((f) => /^backdrop.*\.html$/.test(f)).map((f) => (0, import_node_path.join)(styleDir, f)) : [];
@@ -148323,7 +148520,8 @@ async function main() {
   for (const s of skipped) process.stderr.write(`html2pptx: <img src="${s}"> not found/unfetchable \u2014 the render will drop it
 `);
   if (styleArg) {
-    if (backdropHtml) rawInlined = rawInlined.replace(/<div class="slide-backdrop">\s*<\/div>/g, `<div class="slide-backdrop">${backdropHtml}</div>`);
+    const artLayer = themeV2 ? '<div class="theme-art-layer" aria-hidden="true"><i class="art-shape art-a"></i><i class="art-shape art-b"></i><i class="art-shape art-c"></i><i class="art-pattern"></i></div>' : "";
+    if (backdropHtml || artLayer) rawInlined = rawInlined.replace(/<div class="slide-backdrop">\s*<\/div>/g, `<div class="slide-backdrop">${backdropHtml}${artLayer}</div>`);
     if (skinAccent) rawInlined = rawInlined.replaceAll("__ACCENT__", skinAccent);
     if (skinAxis) rawInlined = rawInlined.replaceAll("__AXIS__", skinAxis);
     if (skinChart1) rawInlined = rawInlined.replaceAll("__CHART1__", skinChart1);
@@ -148333,6 +148531,27 @@ async function main() {
   const latin = await latinFontFaceCss(rawInlined + skinCss);
   const fontCss = cjk + latin;
   const html = injectHead(rawInlined, `${fontCss ? `<style>${fontCss}</style>` : ""}${tw ? `<style>${tw}</style>` : ""}<style>${themeCss}${SKELETON_CSS}${skinCss}</style>`);
+  if (previewDir) {
+    let images;
+    if (hasService) ({ images } = await callService("/shot", html, {
+      ...previewIndexes ? { pages: previewIndexes } : {},
+      ...previewDensityArg !== void 0 ? { density: previewDensity } : {}
+    }).catch((e) => die(e.message, 1)));
+    else {
+      images = await withHeadlessPage(html, (p) => rasterizeHeadless(p, previewIndexes ?? void 0), previewDensity).catch((e) => die(e.message, 1));
+      if (images == null) die(NO_BROWSER, 69);
+    }
+    await (0, import_promises.mkdir)(previewDir, { recursive: true });
+    const pageNumbers = previewIndexes ? previewIndexes.map((i) => i + 1) : images.map((_2, i) => i + 1);
+    const files = [];
+    for (let i = 0; i < images.length; i++) {
+      const path = (0, import_node_path.join)(previewDir, `slide-${String(pageNumbers[i]).padStart(3, "0")}.png`);
+      await (0, import_promises.writeFile)(path, Buffer.from(images[i], "base64"));
+      files.push(path);
+    }
+    process.stdout.write(JSON.stringify({ ok: true, engine: hasService ? "preview" : "preview (headless)", slides: images.length, pages: pageNumbers, density: previewDensity, files }, null, 1) + "\n");
+    return;
+  }
   if (rasterize) {
     let images;
     if (hasService) ({ images } = await callService("/shot", html).catch((e) => die(e.message, 1)));

package/skills/document/bin/pptx-clone.cjs

@@ -9860,9 +9860,9 @@ function unescXml(s) {
     }
   });
 }
-function visualWidth(text2) {
+function visualWidth(text3) {
   let w = 0;
-  for (const ch of text2) {
+  for (const ch of text3) {
     const cp = ch.codePointAt(0);
     if (ch === " " || ch === "	")
       w += 0.35;
@@ -9891,9 +9891,9 @@ function replaceTextAcrossRuns(xml, find, replacement, opts) {
     const segs = [];
     let flat = "";
     for (const m of para.matchAll(textRe)) {
-      const text2 = unescXml(m[2]);
-      segs.push({ el: m[0], attrs: m[1] ?? "", text: text2, start: flat.length });
-      flat += text2;
+      const text3 = unescXml(m[2]);
+      segs.push({ el: m[0], attrs: m[1] ?? "", text: text3, start: flat.length });
+      flat += text3;
     }
     if (!flat.includes(find))
       return para;
@@ -9936,9 +9936,36 @@ function replaceTextAcrossRuns(xml, find, replacement, opts) {
   return { xml: rewritten, count };
 }
 
-// packages/core/dist/document/pptx-clone.js
+// packages/core/dist/document/pptx-register-slide.js
 var SLIDE_CT = "application/vnd.openxmlformats-officedocument.presentationml.slide+xml";
 var SLIDE_REL_TYPE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/slide";
+async function text(zip, path) {
+  const f = zip.file(path);
+  if (!f)
+    throw new Error(`not a PowerPoint file (${path} missing)`);
+  return f.async("string");
+}
+async function registerSlidePart(zip, newNum, newXmlPath) {
+  const ctPath = "[Content_Types].xml";
+  const ct = await text(zip, ctPath);
+  if (!ct.includes(`PartName="/${newXmlPath}"`)) {
+    zip.file(ctPath, ct.replace("</Types>", `<Override PartName="/${newXmlPath}" ContentType="${SLIDE_CT}"/></Types>`));
+  }
+  const presRelsPath = "ppt/_rels/presentation.xml.rels";
+  const presRels = await text(zip, presRelsPath);
+  const maxRid = Math.max(0, ...[...presRels.matchAll(/Id="rId(\d+)"/g)].map((m) => Number(m[1])));
+  const newRid = `rId${maxRid + 1}`;
+  zip.file(presRelsPath, presRels.replace("</Relationships>", `<Relationship Id="${newRid}" Type="${SLIDE_REL_TYPE}" Target="slides/slide${newNum}.xml"/></Relationships>`));
+  const presPath = "ppt/presentation.xml";
+  const pres = await text(zip, presPath);
+  const maxSldId = Math.max(255, ...[...pres.matchAll(/<p:sldId id="(\d+)"/g)].map((m) => Number(m[1])));
+  const updated = pres.replace("</p:sldIdLst>", `<p:sldId id="${maxSldId + 1}" r:id="${newRid}"/></p:sldIdLst>`);
+  if (updated === pres)
+    throw new Error("could not locate the slide list in presentation.xml");
+  zip.file(presPath, updated);
+}
+
+// packages/core/dist/document/pptx-clone.js
 var EMU_PER_PT = 12700;
 function capacityWarning(slideXml, token, value) {
   const idx = slideXml.indexOf(token);
@@ -9971,7 +9998,7 @@ function capacityWarning(slideXml, token, value) {
     return void 0;
   return `${token}: replacement is ~${Math.ceil(width)} width-units, slot fits ~${Math.floor(capacity)} (${Math.round(widthPt)}\xD7${Math.round(heightPt)}pt box @ ${fontPt}pt) \u2014 likely overflow. Shorten the wording; do NOT shrink the font to make it fit.`;
 }
-async function text(zip, path) {
+async function text2(zip, path) {
   const f = zip.file(path);
   if (!f)
     throw new Error(`not a PowerPoint file (${path} missing)`);
@@ -9996,7 +10023,7 @@ async function clonePptxSlide(bytes, slideNumber, replacements = {}) {
   const newNum = Math.max(...slideNums) + 1;
   const srcXmlPath = `ppt/slides/slide${slideNumber}.xml`;
   const newXmlPath = `ppt/slides/slide${newNum}.xml`;
-  let slideXml = await text(zip, srcXmlPath);
+  let slideXml = await text2(zip, srcXmlPath);
   const replaced = [];
   const missing = [];
   const warnings = [];
@@ -10024,23 +10051,7 @@ async function clonePptxSlide(bytes, slideNumber, replacements = {}) {
     const rels = removeElement(await srcRels.async("string"), "Relationship", (el) => /Type="[^"]*\/notesSlide"/.test(el)).xml;
     zip.file(`ppt/slides/_rels/slide${newNum}.xml.rels`, rels);
   }
-  const ctPath = "[Content_Types].xml";
-  const ct = await text(zip, ctPath);
-  if (!ct.includes(`PartName="/${newXmlPath}"`)) {
-    zip.file(ctPath, ct.replace("</Types>", `<Override PartName="/${newXmlPath}" ContentType="${SLIDE_CT}"/></Types>`));
-  }
-  const presRelsPath = "ppt/_rels/presentation.xml.rels";
-  const presRels = await text(zip, presRelsPath);
-  const maxRid = Math.max(0, ...[...presRels.matchAll(/Id="rId(\d+)"/g)].map((m) => Number(m[1])));
-  const newRid = `rId${maxRid + 1}`;
-  zip.file(presRelsPath, presRels.replace("</Relationships>", `<Relationship Id="${newRid}" Type="${SLIDE_REL_TYPE}" Target="slides/slide${newNum}.xml"/></Relationships>`));
-  const presPath = "ppt/presentation.xml";
-  const pres = await text(zip, presPath);
-  const maxSldId = Math.max(255, ...[...pres.matchAll(/<p:sldId id="(\d+)"/g)].map((m) => Number(m[1])));
-  const updated = pres.replace("</p:sldIdLst>", `<p:sldId id="${maxSldId + 1}" r:id="${newRid}"/></p:sldIdLst>`);
-  if (updated === pres)
-    throw new Error("could not locate the slide list in presentation.xml");
-  zip.file(presPath, updated);
+  await registerSlidePart(zip, newNum, newXmlPath);
   const out = await zip.generateAsync({ type: "nodebuffer", compression: "DEFLATE" });
   return { bytes: new Uint8Array(out), newSlideNumber: newNum, replaced, missing, warnings };
 }
@@ -10065,7 +10076,7 @@ async function removePptxSlide(bytes, slideNumber) {
   const xmlPath = `ppt/slides/slide${slideNumber}.xml`;
   const relsPath = `ppt/slides/_rels/slide${slideNumber}.xml.rels`;
   const presRelsPath = "ppt/_rels/presentation.xml.rels";
-  const presRels = await text(zip, presRelsPath);
+  const presRels = await text2(zip, presRelsPath);
   const targetRe = new RegExp(`Target="(/ppt/)?slides/slide${slideNumber}\\.xml"`);
   const relMatch = findElement(presRels, "Relationship", (r) => r.includes(SLIDE_REL_TYPE) && targetRe.test(r));
   if (!relMatch)
@@ -10075,19 +10086,19 @@ async function removePptxSlide(bytes, slideNumber) {
     throw new Error(`slide ${slideNumber}'s relationship carries no Id (corrupt deck?)`);
   zip.file(presRelsPath, presRels.replace(relMatch, ""));
   const presPath = "ppt/presentation.xml";
-  const pres = await text(zip, presPath);
+  const pres = await text2(zip, presPath);
   const sld = removeElement(pres, "p:sldId", (el) => el.includes(`r:id="${rId}"`));
   if (!sld.removed)
     throw new Error(`slide ${slideNumber} (${rId}) not found in the slide list (corrupt deck?)`);
   zip.file(presPath, sld.xml);
-  const slideRels = zip.file(relsPath) ? await text(zip, relsPath) : "";
+  const slideRels = zip.file(relsPath) ? await text2(zip, relsPath) : "";
   const notesTarget = /<Relationship\b[^>]*Type="[^"]*\/notesSlide"[^>]*Target="\.\.\/(notesSlides\/notesSlide\d+\.xml)"/.exec(slideRels)?.[1];
   const removedParts = [xmlPath, relsPath];
   if (notesTarget) {
     const otherSlideRels = Object.keys(zip.files).filter((p) => /^ppt\/slides\/_rels\/slide\d+\.xml\.rels$/.test(p) && p !== relsPath);
     let shared = false;
     for (const p of otherSlideRels) {
-      if ((await text(zip, p)).includes(notesTarget)) {
+      if ((await text2(zip, p)).includes(notesTarget)) {
         shared = true;
         break;
       }
@@ -10095,7 +10106,7 @@ async function removePptxSlide(bytes, slideNumber) {
     if (!shared)
       removedParts.push(`ppt/${notesTarget}`, `ppt/notesSlides/_rels/${notesTarget.split("/")[1]}.rels`);
   }
-  let ct = await text(zip, "[Content_Types].xml");
+  let ct = await text2(zip, "[Content_Types].xml");
   for (const part of removedParts) {
     zip.remove(part);
     ct = removeElement(ct, "Override", (el) => el.includes(`PartName="/${part}"`)).xml;

package/skills/document/bin/pptx-embed-fonts.cjs

@@ -9820,10 +9820,14 @@ var import_promises = require("node:fs/promises");
 
 // packages/core/dist/document/pptx-fonts.js
 var import_jszip = __toESM(require_lib3(), 1);
-var FONT_REL_TYPE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/font";
+
+// packages/core/dist/document/ooxml-util.js
 function escXml(s) {
-  return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+  return s.replace(/[&<>"']/g, (c) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&apos;" })[c]);
 }
+
+// packages/core/dist/document/pptx-fonts.js
+var FONT_REL_TYPE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/font";
 async function text(zip, path) {
   const f = zip.file(path);
   if (!f)