wand-decks-kit 0.8.1 → 0.8.2

package/SKILL.md

@@ -99,6 +99,17 @@ Decks built here carry their own spec inside the file. Change only what was
 asked, then `ship`. If the deck carries no spec it was not built here — treat it
 as a rebrand.
 
+## Work in fast loops, ship once
+
+`node wand.js validate` and `node wand.js check` run in seconds; `ship` runs the
+whole pipeline. Iterate spec edits against the first two, and run `ship` when
+they are clean — never as your discovery tool.
+
+When one error reveals a pattern — a field on the wrong layout, a missing
+optional — **sweep the entire spec for that pattern before re-running anything**.
+Paying a full cycle per instance is the slow way to learn the same fact
+repeatedly.
+
 ## Rules that decide whether the output is usable
 
 1. **Faithful means verbatim.** No consolidating slides, no paraphrasing to

package/build.js

@@ -129,7 +129,11 @@ function check(spec) {
               (bad ? `  — ${bad} overflow${bad > 1 ? "s" : ""} above` : "  — clean"));
   console.log(`bounds check: ${oob ? oob + " shape(s) outside the content band — listed above" : "clean"}`);
   console.log(`asset check : ${missing ? missing + " missing — listed above" : `${seen.size} resolved`}`);
-  return bad + oob + missing;
+  // A slide whose layout threw has no shapes, so nothing above can fail for
+  // it — a crash used to print an ERROR line and exit 0, and the spec author
+  // paid a full ship cycle to find out.
+  if (t.errors.length) console.log(`layout check: ${t.errors.length} slide(s) threw — listed above`);
+  return bad + oob + missing + t.errors.length;
 }
 
 /** The same trace, as a PDF. Fonts embedded, no LibreOffice, no conversion. */

package/lib/schema.js

@@ -32,7 +32,7 @@ const COMMON = {
 const L = {
   /* ------------------------------------------------------------ structural */
   cover: {
-    use: "Slide 1. Dark, full bleed, no footer",
+    use: "Slide 1. Always dark, full bleed, no footer. The lede goes in `body` — there is no subtitleText here",
     bleed: true,
     fields: {
       eyebrow: str(), body: str(), kickerPlain: str(), kickerBold: str(),
@@ -40,12 +40,12 @@ const L = {
     },
   },
   divider: {
-    use: "Section breaks and the agenda. Keeps the tag, drops the footer",
+    use: "Section breaks. Always dark, keeps the tag, drops the footer. Prose goes in `body`",
     bleed: true,
     fields: { eyebrow: str(), titleText: s("title", req()), body: str() },
   },
   closing: {
-    use: "Last slide. Centred, full bleed",
+    use: "Last slide. Always dark, centred, full bleed",
     bleed: true,
     fields: { eyebrow: str(), line1: str(req()), line2: str(), body: str(), url: str() },
   },
@@ -357,6 +357,18 @@ function validate(spec) {
     }
     if (sl.layout === "TODO") return;
     checkFields({ ...COMMON, ...def.fields }, sl, path, errs, warns);
+    // COMMON exempts fields every layout takes — but the full-bleed three do
+    // not take all of them, and a lede typed as subtitleText on a cover was
+    // silently dropped: valid name, wrong layout, no message, one ship cycle
+    // wasted finding out. Say it at validate time instead.
+    if (def.bleed) {
+      if (sl.subtitleText != null && !def.fields.subtitleText) {
+        errs.push(`${path}: ${sl.layout} does not render subtitleText — its lede goes in \`body\``);
+      }
+      if (sl.dark === false) {
+        warns.push(`${path}: ${sl.layout} is always dark — \`dark: false\` is ignored`);
+      }
+    }
     seen.push(sl.layout);
   });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wand-decks-kit",
-  "version": "0.8.1",
+  "version": "0.8.2",
   "description": "Rebuilds or authors a client-ready .pptx on the Wand design system: measured fit, embedded Geist, verbatim content.",
   "license": "SEE LICENSE IN PROMPT.md",
   "bin": {

package/wand_kit.js

@@ -273,7 +273,7 @@ function cover(pres, { eyebrow, titleLines, body, kickerPlain, kickerBold, tag }
   s.addImage({ path: `${ASSETS}/bg-cover-dark.png`, x: 0, y: 0, w: 10, h: 5.625 });
   s.addImage({ path: `${ASSETS}/orb-cover.png`, x: 5.72, y: 0.38, w: 4.61, h: 4.61 });
   if (tag) chrome(s, { tag, dark: true });
-  s.addText(eyebrow.toUpperCase(), {
+  if (eyebrow) s.addText(eyebrow.toUpperCase(), {
     x: 0.38, y: 1.24, w: 6.0, h: 0.4, margin: 0, isTextBox: true,
     fontFace: F.med, fontSize: 12, color: T.accentSoft, valign: "middle",
   });
@@ -290,10 +290,14 @@ function cover(pres, { eyebrow, titleLines, body, kickerPlain, kickerBold, tag }
     fontFace: F.reg, fontSize: 12.5, color: T.inkDark, valign: "top", lineSpacingMultiple: 1.12,
   });
   s.addShape("rect", { x: 0.38, y: 3.95, w: 0.60, h: 0.04, fill: { color: T.accent }, line: { width: 0 } });
-  s.addText([
-    { text: kickerPlain + "  ", options: { fontFace: F.reg, fontSize: 10, color: T.inkDark } },
-    { text: kickerBold,        options: { fontFace: F.reg, fontSize: 10, bold: true, color: T.white } },
-  ], { x: 0.39, y: 4.03, w: 6.0, h: 0.4, margin: 0, isTextBox: true, valign: "middle" });
+  // Concatenating an absent kicker used to paint the word "undefined" on the
+  // cover — visible only in a render, past every machine gate.
+  const kickerRuns = [
+    kickerPlain && { text: kickerPlain + "  ", options: { fontFace: F.reg, fontSize: 10, color: T.inkDark } },
+    kickerBold && { text: kickerBold, options: { fontFace: F.reg, fontSize: 10, bold: true, color: T.white } },
+  ].filter(Boolean);
+  if (kickerRuns.length) s.addText(kickerRuns,
+    { x: 0.39, y: 4.03, w: 6.0, h: 0.4, margin: 0, isTextBox: true, valign: "middle" });
   return s;
 }
 
@@ -303,7 +307,7 @@ function divider(pres, { tag, eyebrow, titleText, body }) {
   s.background = { color: T.bgDark };
   s.addImage({ path: `${ASSETS}/bg-statement-dark.png`, x: 0, y: 0, w: 10, h: 5.625 });
   chrome(s, { tag, dark: true });
-  s.addText(eyebrow.toUpperCase(), {
+  if (eyebrow) s.addText(eyebrow.toUpperCase(), {
     x: 0.38, y: 1.77, w: 8.9, h: 0.24, margin: 0, isTextBox: true,
     fontFace: F.med, fontSize: 12, color: T.accentSoft, valign: "middle",
   });
@@ -329,14 +333,14 @@ function closing(pres, { eyebrow, line1, line2, body, url }) {
   s.background = { color: T.bgDark };
   s.addImage({ path: `${ASSETS}/bg-statement-dark.png`, x: 0, y: 0, w: 10, h: 5.625 });
   s.addImage({ path: `${ASSETS}/wordmark-white.png`, x: 4.60, y: 0.98, w: 0.80, h: 0.22 });
-  s.addText(eyebrow.toUpperCase(), {
+  if (eyebrow) s.addText(eyebrow.toUpperCase(), {
     x: 0.55, y: 1.85, w: 8.9, h: 0.3, margin: 0, isTextBox: true,
     fontFace: F.med, fontSize: 12, color: T.accentSoft, align: "center", valign: "middle",
   });
   s.addText([
-    { text: line1 + "\n", options: { fontFace: F.reg, fontSize: 24, bold: true, color: T.white } },
-    { text: line2,        options: { fontFace: F.reg, fontSize: 24, bold: true, italic: true, color: T.accentSoft } },
-  ], { x: 0.55, y: 2.19, w: 8.9, h: 1.0, margin: 0, isTextBox: true, align: "center", valign: "top", lineSpacingMultiple: 1.15 });
+    line1 && { text: line1 + (line2 ? "\n" : ""), options: { fontFace: F.reg, fontSize: 24, bold: true, color: T.white } },
+    line2 && { text: line2, options: { fontFace: F.reg, fontSize: 24, bold: true, italic: true, color: T.accentSoft } },
+  ].filter(Boolean), { x: 0.55, y: 2.19, w: 8.9, h: 1.0, margin: 0, isTextBox: true, align: "center", valign: "top", lineSpacingMultiple: 1.15 });
   if (body) s.addText(body, {
     x: 1.5, y: 3.23, w: 7.0, h: 0.7, margin: 0, isTextBox: true,
     fontFace: F.reg, fontSize: 12.5, color: T.bodyDark, align: "center", valign: "top", lineSpacingMultiple: 1.25,
@@ -363,7 +367,7 @@ function threeUp(pres, { tag, titleText, subtitleText, items, dark = true, arrow
   items.slice(0, 3).forEach((it, i) => {
     const cx = x[i], cy = 2.02;
     card(s, { x: cx, y: cy, w, h: 2.70, dark, variant: it.emph ? "emph" : "glass" });
-    s.addText(it.eyebrow.toUpperCase(), {
+    if (it.eyebrow) s.addText(it.eyebrow.toUpperCase(), {
       x: cx + 0.22, y: cy + 0.22, w: w - 0.42, h: 0.20, margin: 0, isTextBox: true,
       fontFace: F.med, fontSize: 8, color: th.eyebrow, valign: "middle",
     });
@@ -917,6 +921,7 @@ function productMap(pres, { tag, titleText, subtitleText, bandRow, cards, split,
   if (subtitleText) subtitle(s, subtitleText, { dark, y: 1.16, h: 0.28 });
   const th = theme(dark);
   const rail = (label, y, h) => {
+    if (!label) return;
     s.addShape("roundRect", {
       x: 0.37, y, w: 1.0, h, rectRadius: radius(1.0, h),
       fill: { color: dark ? T.cardMuted : T.surface }, line: { width: 0 },
@@ -994,7 +999,7 @@ function productMap(pres, { tag, titleText, subtitleText, bandRow, cards, split,
 
 
 module.exports = {
-  VERSION: "0.8.1",
+  VERSION: "0.8.2",
   T, F, COLS, ASSETS, radius, theme, autoSize, measure: M,
   background, chrome, footer, title, subtitle, kicker, contentTop,
   card, iconTile, pill,