@taloswork/ose-shared 0.1.1 → 0.1.3

package/skills/document/bin/deck-build.cjs

@@ -6,7 +6,7 @@ var import_promises = require("node:fs/promises");
 var import_node_fs = require("node:fs");
 var import_node_path = require("node:path");
 
-// packages/core/dist/fs/deck-figures.js
+// packages/core/dist/document/deck-figures.js
 var FIGURE_SPECS = {
   radar: {
     metrics: { required: ["name", "score"], derived: [] }
@@ -159,7 +159,7 @@ function derivePins(rows, warnings) {
   });
 }
 
-// packages/core/dist/fs/deck-build.js
+// packages/core/dist/document/deck-build.js
 var SLOT_RE = /\{\{(?![#/])([^{}]*)\}\}/g;
 var BLOCK_RE = /\{\{#([A-Za-z_][\w-]*)\}\}([\s\S]*?)\{\{\/\1\}\}/g;
 function escapeHtml(s) {
@@ -287,6 +287,214 @@ function assembleDeck(spec, readLayout) {
   return { html: sections.join("\n"), warnings: problems.warnings, errors: problems.errors };
 }
 
+// packages/core/dist/document/deck-catalog.js
+var KINDS = ["skin", "pack"];
+var MODES = ["light", "dark"];
+var ID_RE = /^[a-z0-9][a-z0-9-]*$/;
+function isStr(v) {
+  return typeof v === "string" && v.length > 0;
+}
+function isStrArr(v) {
+  return Array.isArray(v) && v.every((x) => typeof x === "string");
+}
+function parseCatalog(raw) {
+  const errors = [];
+  const o = raw;
+  if (!o || typeof o !== "object")
+    return { catalog: null, errors: ["catalog is not an object"] };
+  const groups = [];
+  const rawGroups = Array.isArray(o.groups) ? o.groups : [];
+  if (!Array.isArray(o.groups))
+    errors.push("catalog.groups must be an array");
+  rawGroups.forEach((g, i) => {
+    const at = `group[${i}]`;
+    if (!isStr(g?.id) || !ID_RE.test(g.id))
+      errors.push(`${at}: bad id`);
+    if (!isStr(g?.name_cn))
+      errors.push(`${at}: missing name_cn`);
+    if (!isStr(g?.sample))
+      errors.push(`${at}: missing sample`);
+    if (!isStrArr(g?.scenarios))
+      errors.push(`${at}: scenarios must be a string array`);
+    if (isStr(g?.id) && isStr(g?.name_cn) && isStr(g?.sample) && isStrArr(g?.scenarios)) {
+      groups.push({ id: g.id, name_cn: g.name_cn, sample: g.sample, scenarios: g.scenarios });
+    }
+  });
+  const entries = [];
+  const rawEntries = Array.isArray(o.entries) ? o.entries : [];
+  if (!Array.isArray(o.entries))
+    errors.push("catalog.entries must be an array");
+  rawEntries.forEach((e, i) => {
+    const at = `entry[${i}]${isStr(e?.id) ? ` (${e.id})` : ""}`;
+    const before = errors.length;
+    if (!isStr(e?.id) || !ID_RE.test(e.id))
+      errors.push(`${at}: bad id`);
+    if (!isStr(e?.kind) || !KINDS.includes(e.kind))
+      errors.push(`${at}: kind must be "skin" or "pack"`);
+    if (!isStr(e?.group))
+      errors.push(`${at}: missing group`);
+    if (!isStr(e?.name_cn))
+      errors.push(`${at}: missing name_cn`);
+    if (!isStr(e?.oneliner))
+      errors.push(`${at}: missing oneliner`);
+    if (!isStrArr(e?.scenarios))
+      errors.push(`${at}: scenarios must be a string array`);
+    if (!isStr(e?.mode) || !MODES.includes(e.mode))
+      errors.push(`${at}: mode must be "light" or "dark"`);
+    if (!isStr(e?.sample))
+      errors.push(`${at}: missing sample`);
+    if (e?.motion !== void 0 && !isStr(e.motion))
+      errors.push(`${at}: motion must be a string when present`);
+    if (errors.length === before) {
+      entries.push({
+        id: e.id,
+        kind: e.kind,
+        group: e.group,
+        name_cn: e.name_cn,
+        oneliner: e.oneliner,
+        scenarios: e.scenarios,
+        mode: e.mode,
+        sample: e.sample,
+        ...e.motion !== void 0 ? { motion: e.motion } : {}
+      });
+    }
+  });
+  return { catalog: errors.length ? null : { groups, entries }, errors };
+}
+function resolveEntry(catalog, id) {
+  return catalog.entries.find((e) => e.id === id) ?? null;
+}
+
+// packages/core/dist/document/deck-motion.js
+var ANIM_EFFECTS = [
+  "fade",
+  "fade-up",
+  "float",
+  "appear",
+  "fly-up",
+  "fly-down",
+  "fly-left",
+  "fly-right"
+];
+var START_MODES = ["after", "with", "onclick"];
+var SEL_RE = /^\.[a-z][a-z0-9-]*$/;
+function validateMotionPreset(raw) {
+  const errors = [];
+  const p = raw;
+  if (!p || typeof p !== "object")
+    return ["motion preset is not an object"];
+  if (p.transition !== void 0) {
+    const t = p.transition;
+    if (!t || typeof t.effect !== "string" || !t.effect)
+      errors.push("transition.effect must be a non-empty string");
+    if (t?.durMs !== void 0 && typeof t.durMs !== "number")
+      errors.push("transition.durMs must be a number");
+    if (t?.dir !== void 0 && typeof t.dir !== "string")
+      errors.push("transition.dir must be a string");
+  }
+  if (p.entrance !== void 0) {
+    if (typeof p.entrance !== "object" || p.entrance === null) {
+      errors.push("entrance must be an object keyed by role");
+    } else {
+      for (const [role, steps] of Object.entries(p.entrance)) {
+        if (!Array.isArray(steps)) {
+          errors.push(`entrance.${role} must be an array`);
+          continue;
+        }
+        steps.forEach((s, i) => {
+          const at = `entrance.${role}[${i}]`;
+          if (typeof s?.sel !== "string" || !SEL_RE.test(s.sel))
+            errors.push(`${at}: sel must be a single class selector like ".card"`);
+          if (typeof s?.anim !== "string" || !ANIM_EFFECTS.includes(s.anim)) {
+            errors.push(`${at}: anim "${String(s?.anim)}" is not implemented by pptx-anim.ts`);
+          }
+          for (const k of ["delay", "dur", "stagger"]) {
+            if (s?.[k] !== void 0 && typeof s[k] !== "number")
+              errors.push(`${at}: ${k} must be a number`);
+          }
+          if (s?.start !== void 0 && !START_MODES.includes(s.start))
+            errors.push(`${at}: start must be one of ${START_MODES.join("/")}`);
+        });
+      }
+    }
+  }
+  return errors;
+}
+var ROLE_OVERRIDES = {
+  transition: "section",
+  hero: "cover",
+  title: "cover",
+  "title-meta": "cover",
+  quote: "content",
+  bento: "cards",
+  list: "cards",
+  "icon-row": "cards",
+  "cards-grid": "cards",
+  "blocks-2x2": "cards",
+  "chart-kpi": "stat",
+  "two-kpi": "stat",
+  "three-kpi": "stat",
+  "big-stat": "stat",
+  "stats-chart": "stat"
+};
+function roleOfLayout(layoutId) {
+  if (ROLE_OVERRIDES[layoutId])
+    return ROLE_OVERRIDES[layoutId];
+  if (layoutId.startsWith("cover"))
+    return "cover";
+  if (layoutId.startsWith("toc"))
+    return "toc";
+  if (layoutId.startsWith("section"))
+    return "section";
+  if (layoutId.startsWith("ending"))
+    return "ending";
+  if (layoutId.startsWith("cards"))
+    return "cards";
+  return "content";
+}
+var num2 = (v) => typeof v === "number" && Number.isFinite(v) ? String(Math.round(v)) : null;
+function addAttrs(tag, attrs) {
+  if (/\bdata-anim=/.test(tag))
+    return tag;
+  const extra = Object.entries(attrs).filter(([, v]) => v !== null).map(([k, v]) => ` ${k}="${v}"`).join("");
+  return tag.replace(/\s*\/?>$/, (end) => extra + end);
+}
+function applyMotion(html, layoutId, preset) {
+  let out = html;
+  const role = roleOfLayout(layoutId);
+  const steps = preset.entrance?.[role];
+  if (steps?.length) {
+    let seq = 0;
+    for (const step of steps) {
+      const cls = step.sel.slice(1);
+      const re = new RegExp(`<([a-z][a-z0-9]*)\\b([^>]*\\bclass="[^"]*(?<![\\w-])${cls}(?![\\w-])[^"]*"[^>]*)>`, "gi");
+      let nth = 0;
+      out = out.replace(re, (tag) => {
+        nth += 1;
+        seq += 1;
+        const delay = nth === 1 ? num2(step.delay) : num2(step.stagger ?? step.delay);
+        return addAttrs(tag, {
+          "data-anim": step.anim,
+          "data-anim-seq": String(seq),
+          "data-anim-delay": delay,
+          "data-anim-dur": num2(step.dur),
+          "data-anim-start": step.start ?? null
+        });
+      });
+    }
+  }
+  const t = preset.transition;
+  if (t?.effect) {
+    out = out.replace(/<section\b([^>]*\bclass="[^"]*(?<![\w-])slide(?![\w-])[^"]*"[^>]*)>/i, (tag) => {
+      if (/\bdata-transition=/.test(tag))
+        return tag;
+      const extra = ` data-transition="${t.effect}"` + (t.dir ? ` data-transition-dir="${t.dir}"` : "") + (num2(t.durMs) ? ` data-transition-dur="${num2(t.durMs)}"` : "");
+      return tag.replace(/\s*>$/, extra + ">");
+    });
+  }
+  return out;
+}
+
 // apps/admin/data/skills.lib/document/bin-src/deck-build.mjs
 function die(msg, code = 1) {
   process.stderr.write(`deck-build: ${msg}
@@ -303,11 +511,36 @@ async function main() {
   } catch (e) {
     die(`cannot read spec ${specPath}: ${e.message}`, 66);
   }
-  const layoutsDir = (0, import_node_path.join)((0, import_node_path.dirname)((0, import_node_path.dirname)(process.argv[1] || "")), "layouts");
+  const skillDir = (0, import_node_path.dirname)((0, import_node_path.dirname)(process.argv[1] || ""));
+  const layoutsDir = (0, import_node_path.join)(skillDir, "layouts");
+  let catalogEntry = null;
+  let packLayoutsDir = null;
+  const styleId = typeof spec?.style === "string" ? spec.style : null;
+  if (styleId) {
+    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")));
+        catalogEntry = catalog ? resolveEntry(catalog, styleId) : null;
+        if (catalogEntry?.kind === "pack") packLayoutsDir = (0, import_node_path.join)(skillDir, "packs", catalogEntry.id, "layouts");
+      } catch {
+      }
+    }
+  }
+  let fromPack = 0, fromShared = 0;
   const readLayout = (id) => {
     if (!/^[a-z0-9-]+$/i.test(id)) return null;
+    if (packLayoutsDir) {
+      const pp = (0, import_node_path.join)(packLayoutsDir, `${id}.tpl`);
+      if ((0, import_node_fs.existsSync)(pp)) {
+        fromPack++;
+        return (0, import_node_fs.readFileSync)(pp, "utf8");
+      }
+    }
     const p = (0, import_node_path.join)(layoutsDir, `${id}.tpl`);
-    return (0, import_node_fs.existsSync)(p) ? (0, import_node_fs.readFileSync)(p, "utf8") : null;
+    if (!(0, import_node_fs.existsSync)(p)) return null;
+    if (packLayoutsDir) fromShared++;
+    return (0, import_node_fs.readFileSync)(p, "utf8");
   };
   const { html, warnings, errors } = assembleDeck(spec, readLayout);
   for (const w of warnings) process.stderr.write(`deck-build: ${w}
@@ -317,14 +550,49 @@ async function main() {
 `);
     die(`${errors.length} spec error(s) \u2014 nothing written (see layouts/slots.json for each layout's slots + rows)`, 1);
   }
-  await (0, import_promises.writeFile)(outPath, html, "utf8");
-  const style = typeof spec?.style === "string" ? spec.style : null;
+  const resolved = fromPack + fromShared;
+  if (packLayoutsDir && resolved > 0) {
+    const ratio = fromShared / resolved;
+    if (ratio > 0.4) {
+      process.stderr.write(
+        `deck-build: pack-dilution \u2014 ${fromShared}/${resolved} \u9875\uFF08${Math.round(ratio * 100)}%\uFF09\u56DE\u843D\u5230\u5171\u4EAB\u7248\u5F0F\uFF0C\u8D85\u8FC7 40% \u9608\u503C\u3002\u5305 "${styleId}" \u7684\u9875\u9762\u6E05\u5355\u76F8\u5BF9\u672C\u6B21\u5185\u5BB9\u91CF\u504F\u8584\uFF0C\u8003\u8651\u6269\u5305\u6216\u6539\u7528 skin\u3002
+`
+      );
+    }
+  }
+  let motionPreset = null;
+  if (catalogEntry?.motion) {
+    const mp = (0, import_node_path.join)(skillDir, catalogEntry.motion);
+    if (!(0, import_node_fs.existsSync)(mp)) die(`motion preset not found: ${catalogEntry.motion}`, 66);
+    let raw;
+    try {
+      raw = JSON.parse((0, import_node_fs.readFileSync)(mp, "utf8"));
+    } catch (e) {
+      die(`cannot parse motion preset ${catalogEntry.motion}: ${e.message}`, 66);
+    }
+    const mErrors = validateMotionPreset(raw);
+    if (mErrors.length) {
+      for (const m of mErrors) process.stderr.write(`deck-build: ERROR motion ${m}
+`);
+      die(`${mErrors.length} motion preset error(s) \u2014 nothing written`, 1);
+    }
+    motionPreset = raw;
+  }
+  let finalHtml = html;
+  if (motionPreset) {
+    const perSlide = html.split(/(?=<section\b[^>]*\bclass="[^"]*(?<![\w-])slide(?![\w-]))/).filter(Boolean);
+    finalHtml = perSlide.map((sec) => {
+      const id = sec.match(/data-layout="([a-z0-9-]+)"/i)?.[1];
+      return id ? applyMotion(sec, id, motionPreset) : sec;
+    }).join("");
+  }
+  await (0, import_promises.writeFile)(outPath, finalHtml, "utf8");
   process.stdout.write(JSON.stringify({
     ok: true,
     out: outPath,
     slides: Array.isArray(spec?.slides) ? spec.slides.length : 0,
     warnings,
-    next: `html2pptx ${outPath} out.pptx${style ? ` --style ${style}` : " --style <skin>"}`
+    next: `html2pptx ${outPath} out.pptx${styleId ? ` --style ${styleId}` : " --style <skin>"}`
   }, null, 1) + "\n");
 }
 main().catch((e) => die(e.message, 1));

package/skills/document/bin/deck-qa.cjs

@@ -9818,7 +9818,7 @@ var require_lib3 = __commonJS({
 // apps/admin/data/skills.lib/document/bin-src/deck-qa.mjs
 var import_promises = require("node:fs/promises");
 
-// packages/core/dist/fs/doc-design-lint.js
+// packages/core/dist/document/doc-design-lint.js
 var import_jszip = __toESM(require_lib3(), 1);
 var PLACEHOLDER_RE = /替换为|在这里写|占位|示例文本|Lorem ipsum/i;
 var CJK_TEXT_RE = /[぀-ヿ㐀-䶿一-鿿가-힯豈-﫿]/;

package/skills/document/bin/doc-convert.cjs

@@ -148976,11 +148976,11 @@ var require_fontkit_umd = __commonJS({
 var import_node_path2 = require("node:path");
 var import_promises2 = require("node:fs/promises");
 
-// packages/core/dist/fs/doc-convert.js
+// packages/core/dist/document/doc-convert.js
 var import_jszip3 = __toESM(require_lib3(), 1);
 var import_mammoth2 = __toESM(require_lib6(), 1);
 
-// packages/core/dist/fs/office-converter.js
+// packages/core/dist/document/office-converter.js
 var import_jszip = __toESM(require_lib3(), 1);
 var import_mammoth = __toESM(require_lib6(), 1);
 function isZipMagic(buffer) {
@@ -168101,7 +168101,7 @@ var findPatchKeys = (text) => {
   return (_text$match = text.match(pattern)) !== null && _text$match !== void 0 ? _text$match : [];
 };
 
-// packages/core/dist/fs/doc-gen.js
+// packages/core/dist/document/doc-gen.js
 var import_exceljs = __toESM(require_excel(), 1);
 var import_jszip2 = __toESM(require_lib3(), 1);
 var import_pptxgenjs = __toESM(require_pptxgen_cjs(), 1);
@@ -168109,7 +168109,7 @@ var import_pdf_lib = __toESM(require_cjs(), 1);
 var import_fontkit = __toESM(require_fontkit_umd(), 1);
 var import_node_fs = require("node:fs");
 
-// packages/core/dist/fs/doc-theme.js
+// packages/core/dist/document/doc-theme.js
 var DEFAULT_THEME = {
   bestFor: "",
   fonts: { heading: "", body: "" },
@@ -168301,7 +168301,7 @@ function asTheme(themeInput) {
   return themeInput && typeof themeInput === "object" && "warnings" in themeInput ? themeInput : resolveTheme(themeInput);
 }
 
-// packages/core/dist/fs/doc-palette.js
+// packages/core/dist/document/doc-palette.js
 var PALETTE_LIBRARY = [
   {
     name: "corporate-navy",
@@ -168536,7 +168536,7 @@ function themeSpecFromTopic(topic) {
   return paletteToThemeSpec(resolvePalette(topic));
 }
 
-// packages/core/dist/fs/lucide-icons.js
+// packages/core/dist/document/lucide-icons.js
 var LUCIDE_ICONS = {
   check: '<path d="M20 6 9 17l-5-5"/>',
   "check-circle": '<circle cx="12" cy="12" r="10"/><path d="m9 12 2 2 4-4"/>',
@@ -168593,7 +168593,7 @@ function iconSvgDataUri(name, colorHex) {
   return "data:image/svg+xml;base64," + Buffer.from(svg).toString("base64");
 }
 
-// packages/core/dist/fs/doc-gen.js
+// packages/core/dist/document/doc-gen.js
 function bareHex(c) {
   return c.replace("#", "").toUpperCase();
 }
@@ -170152,10 +170152,10 @@ async function generateDocument(kind, spec, theme) {
   }
 }
 
-// packages/core/dist/fs/doc-html.js
+// packages/core/dist/document/doc-html.js
 var FONT_STACK = 'TalosCJK, "Helvetica Neue", Helvetica, Arial, "PingFang SC", "Hiragino Sans GB", "Microsoft YaHei", "Noto Sans CJK SC", "Source Han Sans SC", "WenQuanYi Zen Hei", sans-serif';
 
-// packages/core/dist/fs/doc-convert.js
+// packages/core/dist/document/doc-convert.js
 var PRINT_STYLE = `
 @page { size: A4; margin: 20mm 18mm; }
 * { box-sizing: border-box; }
@@ -170266,7 +170266,7 @@ async function convertOfficeToPrintable(buffer, filename) {
   return { error: `\u4E0D\u652F\u6301 ${filename} \u7684\u6587\u4EF6\u683C\u5F0F\uFF08doc-convert \u53EA\u652F\u6301 .docx/.pptx\uFF09` };
 }
 
-// packages/core/dist/fs/soffice.js
+// packages/core/dist/document/soffice.js
 var import_node_child_process = require("node:child_process");
 var import_node_fs2 = require("node:fs");
 var import_promises = require("node:fs/promises");
@@ -170412,7 +170412,7 @@ function runSoffice(bin, args, timeoutMs) {
   });
 }
 
-// packages/core/dist/fs/office-service.js
+// packages/core/dist/document/office-service.js
 async function convertViaOfficeService(bytes, filename, url, options = {}) {
   const doFetch = options.fetchImpl ?? fetch;
   const view = bytes instanceof Uint8Array ? bytes : new Uint8Array(bytes);

package/skills/document/bin/doc-fill.cjs

@@ -16068,7 +16068,7 @@ var require_js = __commonJS({
 var import_promises = require("node:fs/promises");
 var import_node_path = require("node:path");
 
-// packages/core/dist/fs/doc-template.js
+// packages/core/dist/document/doc-template.js
 var import_docxtemplater = __toESM(require_docxtemplater(), 1);
 var import_pizzip = __toESM(require_js(), 1);
 var DEFAULT_DELIMITERS = { start: "{{", end: "}}" };