wand-decks-kit 0.8.0

package/wand_kit.js

@@ -0,0 +1,1016 @@
+/**
+ * wand_kit.js — the Wand deck design system, as code.
+ * Kit version: see VERSION below.   Spec: ../PROMPT.md
+ *
+ * This file replaces `wand-template.pptx`. Geometry is measured from
+ * Infinite_Labor__by_Rotem__July_2026.pptx, not transcribed from the spec.
+ *
+ * Canvas is 10.000" x 5.625" (pptxgenjs LAYOUT_16x9). Do not change it.
+ */
+
+const path = require("path");
+const M = require("./lib/shared").measure;
+const ASSETS = require("./lib/brand").resolve("assets");
+const G = require("./lib/shared").glyphs;
+
+/**
+ * Shrink text to fit its box, measured against the real Geist face.
+ * §9: LibreOffice substitutes DejaVu, so visual QA cannot be trusted for fit.
+ * This is measured, so it can be.
+ */
+function autoSize(text, w, h, opts) {
+  return M.fitSize(String(text), w, h, opts);
+}
+
+/* ------------------------------------------------------------------ tokens */
+
+const T = {
+  accent:     "8B7CF6",
+  accentDeep: "6C5CE7",
+  accentSoft: "A99CF8",
+  accentPale: "C4B5F4",
+
+  bgDark:      "0F0C26",
+  inkDark:     "F3F1FA",
+  white:       "FFFFFF",
+  bodyDark:    "B7B0DC",
+  bodyDarkAlt: "CCC0F2",
+  cardStroke:  "2E2757",
+  cardSolid:   "2C2460",
+  cardMuted:   "241D4F",
+  cardMutedStroke: "4A3F8C",
+  cardEmphFlat: "352B70",
+  band:        "0F0C26",
+  footerDark:  "F3F3F3",
+
+  bgLight:    "F8F6FB",
+  inkLight:   "1D1A33",
+  bodyLight:  "5C5779",
+  mutedLight: "555077",
+  cardLight:  "FFFFFF",
+  surface:    "EBE8F8",
+  track:      "E9E6F5",
+  divider:    "E4E0F2",
+  footerLight:"999999",
+};
+
+const F = {
+  reg:   "Geist",
+  med:   "Geist Medium",
+  semi:  "Geist SemiBold",
+  xbold: "Geist ExtraBold",
+  light: "Geist Light",
+};
+
+/* Column presets — never invent new ones. */
+const COLS = {
+  2:          { w: 4.25, x: [0.37, 5.38] },
+  "3wide":    { w: 2.90, x: [0.38, 3.55, 6.72] },
+  "3std":     { w: 2.84, x: [0.37, 3.58, 6.78] },
+  "3tall":    { w: 2.72, x: [0.37, 3.64, 6.90] },
+  4:          { w: 2.09, x: [0.37, 2.73, 5.15, 7.54] },
+  "4stat":    { w: 2.09, x: [0.37, 2.78, 5.15, 7.54] },
+  5:          { w: 1.78, x: [0.41, 2.29, 4.18, 6.06, 7.94] },
+  6:          { w: 1.50, x: [0.41, 1.96, 3.51, 5.06, 6.61, 8.16] },
+  full:       { w: 9.25, x: [0.37] },
+};
+
+/* roundRect corner radius is relative to the shorter side — recompute per card. */
+const radius = (w, h) => 0.10 / Math.min(w, h);
+
+/* Theme resolver. Every layout takes `dark` and reads colours through this. */
+const theme = (dark) => dark
+  ? { ink: T.inkDark, body: T.bodyDark, alt: T.bodyDarkAlt,
+      cardFill: { color: "9481FF", transparency: 88 },
+      cardLine: { color: T.cardStroke, width: 0.75 },
+      tile: T.accent, tileGlyphDark: false, foot: T.footerDark, eyebrow: T.accentPale }
+  : { ink: T.inkLight, body: T.bodyLight, alt: T.mutedLight,
+      cardFill: { color: T.cardLight },
+      cardLine: { color: T.cardLight, width: 0.75 },
+      tile: T.surface, tileGlyphDark: true, foot: T.footerLight, eyebrow: T.accentDeep };
+
+/* ------------------------------------------------------------------ chrome */
+
+function background(slide, dark) {
+  if (dark) {
+    slide.background = { color: T.bgDark };
+    slide.addImage({ path: `${ASSETS}/bg-overlay-dark.png`, x: 0, y: 0, w: 10, h: 5.625 });
+  } else {
+    slide.background = { color: T.bgLight };
+  }
+}
+
+/** Tag + logo mark. Present on every slide except cover and closing. */
+function chrome(slide, { tag, dark = true }) {
+  if (tag) {
+    slide.addText(tag.toUpperCase(), {
+      x: 0.35, y: 0.24, w: 6.75, h: 0.17, margin: 0, isTextBox: true,
+      fontFace: F.reg, fontSize: 8, bold: true, color: T.accent, valign: "middle",
+    });
+  }
+  slide.addImage({
+    path: `${ASSETS}/${dark ? "mark-white.png" : "mark-dark.png"}`,
+    x: 9.52, y: 0.24, w: 0.23, h: 0.19,
+  });
+}
+
+/** Footer band. `n` and `total` are literal — never a field. */
+function footer(slide, { deck, n, total, dark = true, confidential = "STRICTLY CONFIDENTIAL" }) {
+  const c = dark ? T.footerDark : T.footerLight;
+  slide.addText(`WAND  ·  ${deck.toUpperCase()}`, {
+    x: 0.37, y: 5.21, w: 4.58, h: 0.42, margin: 0, isTextBox: true,
+    fontFace: F.reg, fontSize: 6, color: c, valign: "middle",
+  });
+  const pad = (v) => String(v).padStart(2, "0");
+  slide.addText(`${confidential}  ·  ${pad(n)} / ${pad(total)}`, {
+    x: 5.23, y: 5.21, w: 4.76, h: 0.42, margin: 0, isTextBox: true,
+    fontFace: F.reg, fontSize: 6, color: c, align: "right", valign: "middle",
+  });
+}
+
+/**
+ * Title with the accent-italic device. Pass either a plain string or
+ * ["Two kinds of colleagues. ", "One set of drives", "."] — the middle
+ * run gets accent + italic, the period stays in ink. One per title.
+ */
+function title(slide, text, { dark = true, y = 0.62, h = 0.9, size = 24, w = 8.9 } = {}) {
+  const th = theme(dark);
+  const parts = Array.isArray(text) ? text : [text];
+  // A "\n" inside a run makes pptxgenjs start a new paragraph, which pushes every
+  // following run onto its own line. Split on it and carry the break explicitly.
+  const runs = [];
+  parts.forEach((part, i) => {
+    const style = i === 1 && parts.length > 1
+      ? { fontFace: F.reg, fontSize: size, bold: true, italic: true, color: T.accent }
+      : { fontFace: F.reg, fontSize: size, bold: true, color: th.ink };
+    String(part).split("\n").forEach((seg, j, arr) => {
+      runs.push({ text: seg, options: { ...style, breakLine: j !== arr.length - 1 } });
+    });
+  });
+  const flat = parts.join("");
+  const fitted = autoSize(flat, w, h, {
+    family: F.reg, bold: true, fontSize: size, min: 18, step: 0.5, lineSpacingMultiple: 1.08,
+  });
+  if (fitted !== size) runs.forEach((r) => { r.options.fontSize = fitted; });
+  slide.addText(runs, {
+    x: 0.37, y, w, h, margin: 0, isTextBox: true, valign: "top", lineSpacingMultiple: 1.08,
+  });
+}
+
+/**
+ * Subtitle. Grows its own box to the height the text actually needs rather than
+ * clipping or shrinking below the §3 scale, and RETURNS ITS BOTTOM EDGE so the
+ * caller can place the content band under it.
+ *
+ * This is the v5 contentY() lesson: long titles collided with subtitles and long
+ * subtitles pushed into the content band, because both boxes were fixed height
+ * and the overflow was invisible. Measure, then place.
+ */
+function subtitle(slide, text, { dark = true, y = 1.57, h = 0.42, w = 8.9 } = {}) {
+  const size = 12.5, lead = 1.2;
+  const lines = M.lineCount(text, w, { family: F.reg, fontSize: size });
+  // 3+ lines is a copy problem, not a layout problem — step down once, then wrap.
+  const fontSize = lines > 2 ? 11 : size;
+  const need = M.heightIn(text, w, { family: F.reg, fontSize, lineSpacingMultiple: lead });
+  const box = Math.max(h, need + 0.02);
+  slide.addText(text, {
+    x: 0.37, y, w, h: box, margin: 0, isTextBox: true,
+    fontFace: F.reg, fontSize, color: theme(dark).body,
+    valign: "top", lineSpacingMultiple: lead,
+  });
+  return y + box;
+}
+
+/**
+ * Where the content band starts, given the title and subtitle that precede it.
+ * Pass the same values you gave title()/subtitle(). Never hardcode a content y
+ * on a layout whose title can wrap.
+ */
+function contentTop(titleText, subtitleText, { titleY = 0.62, titleSize = 24, w = 8.9, gap = 0.26 } = {}) {
+  const flat = Array.isArray(titleText) ? titleText.join("") : String(titleText || "");
+  let y = titleY + M.heightIn(flat, w, { family: F.reg, bold: true, fontSize: titleSize, lineSpacingMultiple: 1.08 });
+  if (subtitleText) {
+    const lines = M.lineCount(subtitleText, w, { family: F.reg, fontSize: 12.5 });
+    const size = lines > 2 ? 11 : 12.5;
+    y += 0.10 + M.heightIn(subtitleText, w, { family: F.reg, fontSize: size, lineSpacingMultiple: 1.2 });
+  }
+  return +(y + gap).toFixed(3);
+}
+
+/** Italic footnote under the content band. */
+function kicker(slide, text, { dark = true, y = 4.82 } = {}) {
+  // A kicker is usually one short italic line, but a closing band can be a
+  // sentence. Measure it, and let it use the room down to the content limit.
+  const h = Math.min(0.30, 5.06 - y) + (String(text).length > 90 ? 0.16 : 0);
+  slide.addText(text, {
+    x: 0.37, y: Math.min(y, 5.06 - h), w: 9.25, h, margin: 0, isTextBox: true,
+    fontFace: F.reg,
+    fontSize: autoSize(text, 9.25, h, { family: F.reg, fontSize: 10, min: 7, lineSpacingMultiple: 1.2 }),
+    italic: true, color: theme(dark).body,
+    align: "center", valign: "middle", lineSpacingMultiple: 1.2,
+  });
+}
+
+/* ---------------------------------------------------------------- primitives */
+
+function card(slide, { x, y, w, h, dark = true, variant = "glass" }) {
+  const th = theme(dark);
+  let fill = th.cardFill, line = th.cardLine;
+  if (variant === "solid")  { fill = { color: T.cardSolid };     line = { color: T.cardMutedStroke, width: 1 }; }
+  if (variant === "muted")  { fill = { color: T.cardMuted };     line = { color: T.cardMutedStroke, width: 1, dashType: "dash" }; }
+  if (variant === "emph")   { fill = { color: T.cardEmphFlat };  line = { color: T.cardMutedStroke, width: 1 }; }
+  slide.addShape("roundRect", {
+    x, y, w, h, fill: { ...fill }, line: { ...line }, rectRadius: radius(w, h),
+  });
+}
+
+/** Icon tile + glyph. The glyph is a separate PNG — move them together. */
+function iconTile(slide, { x, y, size = 0.46, icon, dark = true }) {
+  slide.addShape("roundRect", {
+    x, y, w: size, h: size,
+    fill: { color: theme(dark).tile }, line: { color: theme(dark).tile, width: 0 },
+    rectRadius: size * 0.30,
+  });
+  if (icon) {
+    const g = size * 0.42;
+    const box = { x: x + (size - g) / 2, y: y + (size - g) / 2, w: g, h: g };
+    // A named glyph is recoloured to the tile's own ink, so it can never be a
+    // white mark on a light tile. A filename is the legacy PNG set, taken as-is.
+    const uri = G.dataUri(icon, theme(dark).tileGlyphDark ? T.accentDeep : T.white);
+    if (uri) slide.addImage({ data: uri, ...box });
+    else slide.addImage({ path: `${ASSETS}/icons/${/\.\w+$/.test(icon) ? icon : icon + ".png"}`, ...box });
+  }
+}
+
+/**
+ * variant: "accent"  filled accent, white text  (L9 "ours" badge)
+ *          "white"   filled white, accent text  (L4 emphasis-card pill)
+ *          "outline" dark fill, accent hairline (L9 "bring your own", L4 default)
+ */
+function pill(slide, { x, y, w, h = 0.34, text, variant = "outline", dark = true }) {
+  const fill = variant === "accent" ? { color: T.accent }
+             : variant === "white"  ? { color: T.white }
+             : { color: dark ? "1B1738" : T.cardLight };
+  const line = variant === "accent" ? { color: T.accent, width: 1 }
+             : variant === "white"  ? { color: T.white, width: 1 }
+             : { color: T.accentSoft, width: 1 };
+  const ink  = variant === "accent" ? T.white
+             : variant === "white"  ? T.accentDeep
+             : T.accentSoft;
+  slide.addShape("roundRect", { x, y, w, h, rectRadius: h / 2, fill, line });
+  slide.addText(text, {
+    x, y, w, h, margin: 0, isTextBox: true,
+    fontFace: F.med, fontSize: 9, color: ink, align: "center", valign: "middle",
+  });
+}
+
+/* ------------------------------------------------------------------ layouts */
+
+/** L1 cover — dark only, full bleed, no footer. */
+function cover(pres, { eyebrow, titleLines, body, kickerPlain, kickerBold, tag }) {
+  const s = pres.addSlide();
+  s.background = { color: T.bgDark };
+  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(), {
+    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",
+  });
+  // 46pt is the §3 cover size, but a long product name can force a third line.
+  // Measure and step down rather than let it collide with the body.
+  const tSize = autoSize(titleLines.join("\n"), 5.55, 1.55,
+    { family: F.xbold, fontSize: 46, min: 32, lineSpacingMultiple: 1.05 });
+  s.addText(titleLines.join("\n"), {
+    x: 0.39, y: 1.58, w: 5.55, h: 1.55, margin: 0, isTextBox: true,
+    fontFace: F.xbold, fontSize: tSize, color: T.white, valign: "top", lineSpacingMultiple: 1.05,
+  });
+  s.addText(body, {
+    x: 0.39, y: 3.25, w: 5.52, h: 0.57, margin: 0, isTextBox: true,
+    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" });
+  return s;
+}
+
+/** L2 divider — dark only, full bleed, tag kept, no footer. */
+function divider(pres, { tag, eyebrow, titleText, body }) {
+  const s = pres.addSlide();
+  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(), {
+    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",
+  });
+  const runs = Array.isArray(titleText)
+    ? titleText.map((t, i) => ({
+        text: t,
+        options: i === 1
+          ? { fontFace: F.semi, fontSize: 44, italic: true, color: T.accentSoft }
+          : { fontFace: F.semi, fontSize: 44, color: T.white },
+      }))
+    : [{ text: titleText, options: { fontFace: F.semi, fontSize: 44, color: T.white } }];
+  s.addText(runs, { x: 0.38, y: 2.09, w: 8.6, h: 0.77, margin: 0, isTextBox: true, valign: "top" });
+  if (body) s.addText(body, {
+    x: 0.38, y: 2.91, w: 5.81, h: 0.72, margin: 0, isTextBox: true,
+    fontFace: F.reg, fontSize: 12, color: T.bodyDark, valign: "top", lineSpacingMultiple: 1.25,
+  });
+  return s;
+}
+
+/** L3 closing — dark, centred, full bleed. */
+function closing(pres, { eyebrow, line1, line2, body, url }) {
+  const s = pres.addSlide();
+  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(), {
+    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 });
+  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,
+  });
+  if (url) s.addText(url, {
+    x: 1.5, y: 4.30, w: 7.0, h: 0.3, margin: 0, isTextBox: true,
+    fontFace: F.reg, fontSize: 10, bold: true, color: T.accentSoft, align: "center", valign: "middle",
+  });
+  return s;
+}
+
+/**
+ * L4 / L5 threeUp — 3 tall cards. Pass `arrows: true` for the progression variant.
+ * items: [{ eyebrow, title, pill, body, emph }]
+ */
+function threeUp(pres, { tag, titleText, subtitleText, items, dark = true, arrows = false, deck, n, total }) {
+  const s = pres.addSlide();
+  background(s, dark);
+  chrome(s, { tag, dark });
+  title(s, titleText, { dark, y: 0.76, h: 0.5 });
+  if (subtitleText) subtitle(s, subtitleText, { dark, y: 1.32, h: 0.5 });
+  const th = theme(dark);
+  const { w, x } = COLS["3tall"];
+  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(), {
+      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",
+    });
+    s.addText(it.title, {
+      x: cx + 0.22, y: cy + 0.46, w: w - 0.44, h: 0.34, margin: 0, isTextBox: true,
+      fontFace: F.semi, fontSize: 16, color: th.ink, valign: "middle",
+    });
+    if (it.pill) pill(s, { x: cx + 0.36, y: cy + 0.96, w: 2.00, text: it.pill, variant: it.emph ? "white" : "outline", dark });
+    s.addText(it.body, {
+      x: cx + 0.22, y: cy + 1.50, w: w - 0.42, h: 1.05, margin: 0, isTextBox: true,
+      fontFace: F.reg,
+      fontSize: autoSize(it.body, w - 0.42, 1.05, { family: F.reg, fontSize: 9, min: 6.5, lineSpacingMultiple: 1.25 }),
+      color: it.emph ? T.white : th.body, valign: "top", lineSpacingMultiple: 1.25,
+    });
+  });
+  if (arrows) [3.23, 6.50].forEach((ax) => {
+    s.addText("→", {
+      x: ax, y: 3.22, w: 0.27, h: 0.27, margin: 0, isTextBox: true,
+      fontFace: F.semi, fontSize: 16, color: T.accent, align: "center", valign: "middle",
+    });
+  });
+  if (deck) footer(s, { deck, n, total, dark });
+  return s;
+}
+
+/** L6 fourUpIcon — 4 icon cards. items: [{ icon, title, body }] */
+function fourUpIcon(pres, { tag, titleText, subtitleText, items, kickerText, dark = true, deck, n, total }) {
+  const s = pres.addSlide();
+  background(s, dark);
+  chrome(s, { tag, dark });
+  title(s, titleText, { dark, y: 0.62, h: 0.9 });
+  if (subtitleText) subtitle(s, subtitleText, { dark, y: 1.57 });
+  const th = theme(dark);
+  const { w, x } = COLS[4];
+  items.slice(0, 4).forEach((it, i) => {
+    const cx = x[i], cy = 2.28;
+    card(s, { x: cx, y: cy, w, h: 2.34, dark });
+    iconTile(s, { x: cx + 0.22, y: cy + 0.24, size: 0.46, icon: it.icon, dark });
+    s.addText(it.title, {
+      x: cx + 0.22, y: cy + 0.86, w: w - 0.42, h: 0.28, margin: 0, isTextBox: true,
+      fontFace: F.med, fontSize: 12.5, color: th.ink, valign: "middle",
+    });
+    s.addText(it.body, {
+      x: cx + 0.21, y: cy + 1.20, w: w - 0.42, h: 1.02, margin: 0, isTextBox: true,
+      fontFace: F.reg, fontSize: 9, color: th.body, valign: "top", lineSpacingMultiple: 1.25,
+    });
+  });
+  if (kickerText) kicker(s, kickerText, { dark });
+  if (deck) footer(s, { deck, n, total, dark });
+  return s;
+}
+
+/** L7 sixUpIcon — 6 cards in two rows. items: [{ icon, title, body }] */
+function sixUpIcon(pres, { tag, titleText, subtitleText, items, dark = true, deck, n, total }) {
+  const s = pres.addSlide();
+  background(s, dark);
+  chrome(s, { tag, dark });
+  title(s, titleText, { dark, y: 0.62, h: 0.6 });
+  if (subtitleText) subtitle(s, subtitleText, { dark, y: 1.18, h: 0.36 });
+  const th = theme(dark);
+  const { w, x } = COLS["3std"];
+  items.slice(0, 6).forEach((it, i) => {
+    const cx = x[i % 3], cy = i < 3 ? 1.63 : 3.46;
+    card(s, { x: cx, y: cy, w, h: 1.62, dark });
+    iconTile(s, { x: cx + 0.20, y: cy + 0.16, size: 0.40, icon: it.icon, dark });
+    s.addText(it.title, {
+      x: cx + 0.20, y: cy + 0.64, w: 2.44, h: 0.28, margin: 0, isTextBox: true,
+      fontFace: F.semi,
+      fontSize: autoSize(it.title, 2.44, 0.28, { family: F.semi, fontSize: 10.5, min: 7.5 }),
+      color: th.ink, valign: "middle",
+    });
+    s.addText(it.body, {
+      x: cx + 0.20, y: cy + 1.01, w: w - 0.40, h: it.note ? 0.42 : 0.55, margin: 0, isTextBox: true,
+      fontFace: F.reg,
+      fontSize: autoSize(it.body, w - 0.40, it.note ? 0.42 : 0.55, { family: F.reg, fontSize: 8, min: 6, lineSpacingMultiple: 1.2 }),
+      color: th.body, valign: "top", lineSpacingMultiple: 1.2,
+    });
+    if (it.note) s.addText(it.note, {
+      x: cx + 0.20, y: cy + 1.30, w: w - 0.40, h: 0.22, margin: 0, isTextBox: true,
+      fontFace: F.semi,
+      fontSize: autoSize(it.note, w - 0.40, 0.22, { family: F.semi, fontSize: 8, min: 6.5 }),
+      color: T.accent, valign: "middle",
+    });
+  });
+  if (deck) footer(s, { deck, n, total, dark });
+  return s;
+}
+
+/**
+ * L9 rows — 5 full-width rows. Best layout for a stack / ownership table.
+ * items: [{ icon, label, description, badge, ours }]
+ */
+function rows(pres, { tag, titleText, subtitleText, items, dark = true, deck, n, total }) {
+  const s = pres.addSlide();
+  background(s, dark);
+  chrome(s, { tag, dark });
+  title(s, titleText, { dark, y: 0.62, h: 0.9 });
+  if (subtitleText) subtitle(s, subtitleText, { dark, y: 1.50, h: 0.36 });
+  const th = theme(dark);
+  items.slice(0, 5).forEach((it, i) => {
+    const y = 1.94 + i * 0.645;
+    card(s, { x: 0.37, y, w: 9.25, h: 0.58, dark, variant: it.ours === false ? "muted" : "glass" });
+    iconTile(s, { x: 0.57, y: y + 0.11, size: 0.36, icon: it.icon, dark });
+    s.addText(it.label, {
+      x: 1.08, y, w: 1.95, h: 0.58, margin: 0, isTextBox: true,
+      fontFace: F.med, fontSize: 10.5, color: th.ink, valign: "middle",
+    });
+    s.addText(it.description, {
+      x: 3.03, y, w: 4.76, h: 0.58, margin: 0, isTextBox: true,
+      fontFace: F.reg, fontSize: 8, color: th.body, valign: "middle", lineSpacingMultiple: 1.2,
+    });
+    if (it.badge) pill(s, { x: 8.15, y: y + 0.14, w: 1.30, h: 0.30, text: it.badge, variant: it.ours === false ? "outline" : "accent", dark });
+  });
+  if (deck) footer(s, { deck, n, total, dark });
+  return s;
+}
+
+/**
+ * L10 parity — two contrasting cards with check rows and a centre badge.
+ * left/right: { label, icon, items: [] }
+ */
+function parity(pres, { tag, titleText, subtitleText, left, right, badge = "=", badgeNote, kickerText, dark = false, deck, n, total }) {
+  const s = pres.addSlide();
+  background(s, dark);
+  chrome(s, { tag, dark });
+  title(s, titleText, { dark, y: 0.62, h: 0.5 });
+  if (subtitleText) subtitle(s, subtitleText, { dark, y: 1.14, h: 0.36 });
+  const sides = [
+    { d: left,  x: 0.37, emph: false },
+    { d: right, x: 5.38, emph: true },
+  ];
+  sides.forEach(({ d, x, emph }) => {
+    const y = 1.68;
+    card(s, { x, y, w: 4.25, h: 2.92, dark: emph ? true : dark, variant: emph ? "emph" : "glass" });
+    const ink = emph ? T.white : theme(dark).ink;
+    if (d.eyebrow) s.addText(d.eyebrow.toUpperCase(), {
+      x: x + 0.30, y: y + 0.16, w: 3.65, h: 0.18, margin: 0, isTextBox: true,
+      fontFace: F.med, fontSize: 8, color: emph ? T.accentPale : theme(dark).eyebrow, valign: "middle",
+    });
+    if (d.icon) iconTile(s, { x: x + 0.30, y: y + 0.26, size: 0.44, icon: d.icon, dark: emph ? true : dark });
+    s.addText(d.label.toUpperCase(), {
+      x: x + 0.89, y: y + 0.26, w: 3.20, h: 0.44, margin: 0, isTextBox: true,
+      fontFace: F.semi, fontSize: 12, color: emph ? T.accentSoft : T.accentDeep, valign: "middle",
+    });
+    const rows = d.items.slice(0, 5);
+    const rowTop = y + 0.90, rowH = (2.92 - 1.02) / rows.length;
+    rows.forEach((t, i) => {
+      const ry = rowTop + i * rowH;
+      s.addText("✓", {
+        x: x + 0.35, y: ry, w: 0.20, h: 0.22, margin: 0, isTextBox: true,
+        fontFace: F.semi, fontSize: 11, color: T.accent, valign: "middle",
+      });
+      s.addText(t, {
+        x: x + 0.61, y: ry, w: 3.50, h: rowH, margin: 0, isTextBox: true,
+        fontFace: F.reg,
+        fontSize: autoSize(t, 3.50, rowH, { family: F.reg, fontSize: 9.5, min: 5.5, lineSpacingMultiple: 1.2 }),
+        color: ink, valign: "middle", lineSpacingMultiple: 1.2,
+      });
+    });
+  });
+  s.addShape("ellipse", { x: 4.75, y: 2.89, w: 0.50, h: 0.50, fill: { color: T.accent }, line: { width: 0 } });
+  s.addText(badge, {
+    x: 4.75, y: 2.89, w: 0.50, h: 0.50, margin: 0, isTextBox: true,
+    fontFace: F.semi, fontSize: 17, color: T.white, align: "center", valign: "middle",
+  });
+  if (badgeNote) s.addText(badgeNote.toUpperCase(), {
+    x: 4.35, y: 3.42, w: 1.30, h: 0.18, margin: 0, isTextBox: true,
+    fontFace: F.med,
+    fontSize: autoSize(badgeNote.toUpperCase(), 1.30, 0.18, { family: F.med, fontSize: 7, min: 5.5 }),
+    color: T.accent, align: "center", valign: "middle",
+  });
+  if (kickerText) kicker(s, kickerText, { dark, y: 4.84 });
+  if (deck) footer(s, { deck, n, total, dark });
+  return s;
+}
+
+/** L15 statQuad — 4 stat cards. items: [{ value, caption }] */
+function statQuad(pres, { tag, titleText, subtitleText, items, kickerText, dark = false, deck, n, total }) {
+  const s = pres.addSlide();
+  background(s, dark);
+  chrome(s, { tag, dark });
+  title(s, titleText, { dark, y: 0.62, h: 0.9 });
+  if (subtitleText) subtitle(s, subtitleText, { dark, y: 1.57 });
+  const th = theme(dark);
+  const { w, x } = COLS["4stat"];
+  items.slice(0, 4).forEach((it, i) => {
+    const cx = x[i], cy = 2.90;
+    card(s, { x: cx, y: cy, w, h: 1.42, dark });
+    s.addText(it.value, {
+      x: cx + 0.18, y: cy + 0.16, w: w - 0.36, h: 0.42, margin: 0, isTextBox: true,
+      fontFace: F.semi, fontSize: 21, color: T.accent, valign: "middle",
+    });
+    s.addText(it.caption, {
+      x: cx + 0.18, y: cy + 0.66, w: w - 0.36, h: 0.62, margin: 0, isTextBox: true,
+      fontFace: F.reg, fontSize: 8.5, color: th.body, valign: "top", lineSpacingMultiple: 1.2,
+    });
+  });
+  if (kickerText) kicker(s, kickerText, { dark, y: 4.70 });
+  if (deck) footer(s, { deck, n, total, dark });
+  return s;
+}
+
+/** L16 statGrid — 6 cards, 3x2. items: [{ value, label, caption, emph }] */
+function statGrid(pres, { tag, titleText, subtitleText, items, footnote, dark = false, deck, n, total }) {
+  const s = pres.addSlide();
+  background(s, dark);
+  chrome(s, { tag, dark });
+  title(s, titleText, { dark, y: 0.62, h: 0.6 });
+  if (subtitleText) subtitle(s, subtitleText, { dark, y: 1.18, h: 0.36 });
+  const th = theme(dark);
+  items.slice(0, 6).forEach((it, i) => {
+    const cx = 0.37 + (i % 3) * 3.25, cy = 1.60 + Math.floor(i / 3) * 1.60;
+    card(s, { x: cx, y: cy, w: 3.00, h: 1.35, dark, variant: it.emph ? "emph" : "glass" });
+    s.addText(it.value, {
+      x: cx + 0.20, y: cy + 0.14, w: 2.60, h: 0.40, margin: 0, isTextBox: true,
+      fontFace: F.semi, fontSize: 20, color: it.emph ? T.white : T.accent, valign: "middle",
+    });
+    s.addText(it.label, {
+      x: cx + 0.20, y: cy + 0.58, w: 2.60, h: 0.28, margin: 0, isTextBox: true,
+      fontFace: F.semi, fontSize: 12, color: it.emph ? T.white : th.ink, valign: "middle",
+    });
+    if (it.caption) s.addText(it.caption, {
+      x: cx + 0.20, y: cy + 0.88, w: 2.60, h: 0.36, margin: 0, isTextBox: true,
+      fontFace: F.reg, fontSize: 8, color: it.emph ? T.accentPale : T.accentDeep, valign: "top",
+    });
+  });
+  if (footnote) kicker(s, footnote, { dark, y: 4.70 });
+  if (deck) footer(s, { deck, n, total, dark });
+  return s;
+}
+
+/** L20 band — full-width assertion or equation band, usually paired with statQuad. */
+function band(pres, { tag, titleText, subtitleText, icon, runs, stats, quote, dark = false, deck, n, total }) {
+  const s = pres.addSlide();
+  background(s, dark);
+  chrome(s, { tag, dark });
+  title(s, titleText, { dark, y: 0.62, h: 0.5 });
+  if (subtitleText) subtitle(s, subtitleText, { dark, y: 1.14, h: 0.5 });
+  s.addShape("roundRect", {
+    x: 0.37, y: 1.78, w: 9.25, h: 0.86,
+    fill: { color: T.band }, line: { color: T.band, width: 0 }, rectRadius: radius(9.25, 0.86),
+  });
+  iconTile(s, { x: 0.68, y: 2.00, size: 0.42, icon, dark: true });
+  s.addText(
+    runs.map((r) => ({
+      text: r.text,
+      options: {
+        fontFace: F.semi, fontSize: 13.5,
+        color: r.accent ? T.accentSoft : T.white,
+        italic: !!r.accent,
+      },
+    })),
+    { x: 1.30, y: 1.78, w: 7.75, h: 0.86, margin: 0, isTextBox: true, valign: "middle" }
+  );
+  if (stats) {
+    const { w, x } = COLS["4stat"];
+    stats.slice(0, 4).forEach((it, i) => {
+      const cx = x[i], cy = 2.90;
+      card(s, { x: cx, y: cy, w, h: 1.42, dark });
+      s.addText(it.value, {
+        x: cx + 0.18, y: cy + 0.16, w: w - 0.36, h: 0.42, margin: 0, isTextBox: true,
+        fontFace: F.semi, fontSize: 21, color: T.accent, valign: "middle",
+      });
+      s.addText(it.caption, {
+        x: cx + 0.18, y: cy + 0.66, w: w - 0.36, h: 0.62, margin: 0, isTextBox: true,
+        fontFace: F.reg, fontSize: 8.5, color: theme(dark).body, valign: "top", lineSpacingMultiple: 1.2,
+      });
+    });
+  }
+  if (quote) kicker(s, quote, { dark, y: 4.70 });
+  if (deck) footer(s, { deck, n, total, dark });
+  return s;
+}
+
+
+/**
+ * L11 colCards — 2 or 3 tall cards carrying an image, prose, and a bullet list.
+ * Measured from reference S07: 2.90 x 3.51 at y1.44.
+ * items: [{ art, eyebrow, title, body, bullets: [] }]
+ */
+function colCards(pres, { tag, titleText, subtitleText, items, dark = true, deck, n, total }) {
+  const s = pres.addSlide();
+  background(s, dark);
+  chrome(s, { tag, dark });
+  title(s, titleText, { dark, y: 0.73, h: 0.46, w: 9.49 });
+  if (subtitleText) subtitle(s, subtitleText, { dark, y: 1.20, h: 0.30 });
+  const th = theme(dark);
+  const three = items.length >= 3;
+  const w = three ? 2.90 : 4.30;
+  const xs = three ? COLS["3wide"].x : COLS[2].x;
+  items.slice(0, 3).forEach((it, i) => {
+    const cx = xs[i], cy = 1.44, h = 3.51;
+    card(s, { x: cx, y: cy, w, h, dark });
+    if (it.art) s.addImage({ path: `${ASSETS}/${it.art}`, x: cx + 0.82, y: cy + 0.02, w: 1.20, h: 1.20 });
+    s.addText(it.eyebrow, {
+      x: cx + 0.19, y: cy + 1.10, w: 2.47, h: 0.23, margin: 0, isTextBox: true,
+      fontFace: F.semi, fontSize: 9, color: th.eyebrow, align: "center", valign: "middle",
+    });
+    s.addText(it.title, {
+      x: cx + 0.19, y: cy + 1.22, w: 2.47, h: 0.38, margin: 0, isTextBox: true,
+      fontFace: F.semi, fontSize: 15, color: th.ink, align: "center", valign: "middle",
+    });
+    if (it.sub) s.addText(it.sub, {
+      x: cx + 0.19, y: cy + 1.60, w: 2.47, h: 0.22, margin: 0, isTextBox: true,
+      fontFace: F.med, fontSize: 9, italic: true, color: th.eyebrow,
+      align: "center", valign: "middle",
+    });
+    if (it.body) s.addText(it.body, {
+      x: cx + 0.19, y: cy + (it.sub ? 1.86 : 1.72), w: 2.47, h: it.sub ? 0.72 : 0.79, margin: 0, isTextBox: true,
+      fontFace: F.reg,
+      fontSize: autoSize(it.body, 2.47, it.sub ? 0.72 : 0.79, { family: F.reg, fontSize: 8, min: 6, lineSpacingMultiple: 1.25 }),
+      color: th.body, valign: "top", lineSpacingMultiple: 1.25,
+    });
+    if (it.bullets && it.bullets.length) {
+      s.addText(
+        it.bullets.map((b, j) => ({
+          text: b,
+          options: { bullet: { code: "25A0" }, breakLine: j !== it.bullets.length - 1 },
+        })),
+        { x: cx + 0.20, y: cy + (it.body ? 2.66 : 1.86), w: 2.55, h: it.body ? 0.80 : 1.60, margin: 0, isTextBox: true,
+          fontFace: F.reg,
+          fontSize: autoSize(it.bullets.join(" "), 2.35, it.body ? 0.80 : 1.60,
+                             { family: F.reg, fontSize: 8, min: 6, lineSpacingMultiple: 1.25 }),
+          color: th.alt, valign: "top", paraSpaceAfter: 3 }
+      );
+    }
+  });
+  if (deck) footer(s, { deck, n, total, dark });
+  return s;
+}
+
+/**
+ * L17 featureStats — one emphasis card carrying a sentence, then 3 stat cards.
+ * Measured from reference S04: 2.09 x 2.10 at y2.63, x 0.37 / 2.75 / 5.13 / 7.51.
+ * lead: { icon, runs: [{text, accent}] }   stats: [{ value, caption }]
+ */
+function featureStats(pres, { tag, titleText, subtitleText, lead, stats, dark = false, deck, n, total }) {
+  const s = pres.addSlide();
+  background(s, dark);
+  chrome(s, { tag, dark });
+  title(s, titleText, { dark, y: 0.76, h: 0.92 });
+  if (subtitleText) subtitle(s, subtitleText, { dark, y: 1.69, h: 0.56 });
+  const th = theme(dark);
+  const xs = [0.37, 2.75, 5.13, 7.51];
+  card(s, { x: xs[0], y: 2.63, w: 2.09, h: 2.10, dark: true, variant: "emph" });
+  iconTile(s, { x: xs[0] + 0.17, y: 2.88, size: 0.42, icon: lead.icon, dark: true });
+  s.addText(
+    lead.runs.map((r) => ({
+      text: r.text,
+      options: { fontFace: F.reg, fontSize: 11, italic: !!r.accent,
+                 color: r.accent ? T.accentSoft : T.white },
+    })),
+    { x: xs[0] + 0.17, y: 3.52, w: 1.75, h: 1.05, margin: 0, isTextBox: true,
+      valign: "top", lineSpacingMultiple: 1.2 }
+  );
+  stats.slice(0, 3).forEach((it, i) => {
+    const cx = xs[i + 1];
+    card(s, { x: cx, y: 2.63, w: 2.09, h: 2.10, dark });
+    s.addText(it.value, {
+      x: cx + 0.18, y: 2.90, w: 1.75, h: 0.50, margin: 0, isTextBox: true,
+      fontFace: F.semi, fontSize: 26, color: T.accent, valign: "middle",
+    });
+    s.addText(it.caption, {
+      x: cx + 0.18, y: 3.62, w: 1.78, h: 0.80, margin: 0, isTextBox: true,
+      fontFace: F.reg, fontSize: 11, color: th.body, valign: "top", lineSpacingMultiple: 1.2,
+    });
+  });
+  if (deck) footer(s, { deck, n, total, dark });
+  return s;
+}
+
+/**
+ * L18 barRank — ranked magnitudes as shapes, never addChart(). Spec §5 / §9.
+ * Measured from reference S12: track 5.40 x 0.48 at x0.37 y2.10, step 0.64.
+ * bars: [{ label, value, frac }]   cards: [{ icon, value, caption }]
+ */
+function barRank(pres, { tag, titleText, subtitleText, bars, cards, footnote, dark = false, deck, n, total }) {
+  const s = pres.addSlide();
+  background(s, dark);
+  chrome(s, { tag, dark });
+  title(s, titleText, { dark, y: 0.62, h: 0.9 });
+  if (subtitleText) subtitle(s, subtitleText, { dark, y: 1.56, h: 0.30 });
+  const th = theme(dark);
+  const RAMP = ["7C6AE8", "8B7CF6", "9C8EF6", "6F5DE8"];
+  bars.slice(0, 4).forEach((b, i) => {
+    const y = 2.10 + i * 0.64, TRACK = 5.40;
+    s.addShape("roundRect", {
+      x: 0.37, y, w: TRACK, h: 0.48, rectRadius: radius(TRACK, 0.48),
+      fill: { color: dark ? T.cardMuted : T.track }, line: { width: 0 },
+    });
+    const fw = Math.max(0.30, Math.min(1, b.frac) * TRACK);
+    s.addShape("roundRect", {
+      x: 0.37, y, w: fw, h: 0.48, rectRadius: radius(fw, 0.48),
+      fill: { color: RAMP[i % RAMP.length] }, line: { width: 0 },
+    });
+    s.addText(b.label, {
+      x: 0.55, y, w: Math.max(0.60, fw - 0.26), h: 0.48, margin: 0, isTextBox: true,
+      fontFace: F.semi, fontSize: autoSize(b.label, Math.max(0.60, fw - 0.26), 0.44, { family: F.semi, fontSize: 9.5, min: 7 }), color: T.white, valign: "middle",
+    });
+    const inside = fw > TRACK - 1.1;
+    s.addText(b.value, {
+      x: 0.55, y, w: TRACK - 0.36, h: 0.48, margin: 0, isTextBox: true,
+      fontFace: F.semi, fontSize: 10.5, color: inside ? T.white : th.ink,
+      align: "right", valign: "middle",
+    });
+  });
+  (cards || []).slice(0, 3).forEach((c, i) => {
+    const y = 2.10 + i * 1.00;
+    card(s, { x: 6.38, y, w: 3.25, h: 0.92, dark });
+    iconTile(s, { x: 6.58, y: y + 0.26, size: 0.40, icon: c.icon, dark });
+    s.addText(c.value, {
+      x: 7.13, y: y + 0.12, w: 2.35, h: 0.30, margin: 0, isTextBox: true,
+      fontFace: F.semi, fontSize: 15, color: T.accent, valign: "middle",
+    });
+    s.addText(c.caption, {
+      x: 7.13, y: y + 0.44, w: 2.35, h: 0.36, margin: 0, isTextBox: true,
+      fontFace: F.reg, fontSize: 8, color: th.body, valign: "top", lineSpacingMultiple: 1.15,
+    });
+  });
+  if (footnote) kicker(s, footnote, { dark, y: 4.76 });
+  if (deck) footer(s, { deck, n, total, dark });
+  return s;
+}
+
+/**
+ * L19 bridge — a labelled waterfall in one card, plus a 2x2 stat block.
+ * Measured from reference S15: card 5.38 x 3.16 at x0.38 y1.74.
+ * rows: [{ label, value, frac }]   stats: [{ value, label, caption }]
+ */
+function bridge(pres, { tag, titleText, subtitleText, eyebrow, rows: brows, stats, dark = false, deck, n, total }) {
+  const s = pres.addSlide();
+  background(s, dark);
+  chrome(s, { tag, dark });
+  title(s, titleText, { dark, y: 0.62, h: 0.44 });
+  if (subtitleText) subtitle(s, subtitleText, { dark, y: 1.12, h: 0.42 });
+  const th = theme(dark);
+  card(s, { x: 0.38, y: 1.74, w: 5.38, h: 3.16, dark });
+  if (eyebrow) s.addText(eyebrow.toUpperCase(), {
+    x: 0.67, y: 1.96, w: 3.0, h: 0.22, margin: 0, isTextBox: true,
+    fontFace: F.semi, fontSize: 8, color: T.accentDeep, valign: "middle",
+  });
+  brows.slice(0, 5).forEach((r, i) => {
+    const y = 2.34 + i * 0.495, TRACK = 1.75;
+    s.addText(r.label, {
+      x: 0.67, y, w: 1.92, h: 0.34, margin: 0, isTextBox: true,
+      fontFace: F.reg, fontSize: 9.5, color: th.ink, valign: "middle",
+    });
+    s.addShape("roundRect", {
+      x: 2.64, y: y + 0.06, w: TRACK, h: 0.22, rectRadius: radius(TRACK, 0.22),
+      fill: { color: dark ? T.cardMuted : T.track }, line: { width: 0 },
+    });
+    const fw = Math.max(0.06, Math.min(1, r.frac) * TRACK);
+    s.addShape("roundRect", {
+      x: 2.64, y: y + 0.06, w: fw, h: 0.22, rectRadius: radius(fw, 0.22),
+      fill: { color: T.accent }, line: { width: 0 },
+    });
+    s.addText(r.value, {
+      x: 4.44, y, w: 0.95, h: 0.34, margin: 0, isTextBox: true,
+      fontFace: F.semi, fontSize: 9.5, color: th.ink, align: "right", valign: "middle",
+    });
+  });
+  (stats || []).slice(0, 4).forEach((c, i) => {
+    const cx = i % 2 ? 7.95 : 6.01, cy = i < 2 ? 1.74 : 3.41;
+    card(s, { x: cx, y: cy, w: 1.68, h: 1.50, dark });
+    s.addText(c.value, {
+      x: cx + 0.14, y: cy + 0.13, w: 1.44, h: 0.32, margin: 0, isTextBox: true,
+      fontFace: F.semi, fontSize: autoSize(c.value, 1.44, 0.32, { family: F.semi, fontSize: 17, min: 11 }), color: T.accent, valign: "middle",
+    });
+    s.addText(c.label.toUpperCase(), {
+      x: cx + 0.14, y: cy + 0.50, w: 1.44, h: 0.34, margin: 0, isTextBox: true,
+      fontFace: F.semi, fontSize: 8, color: th.ink, valign: "top",
+    });
+    if (c.caption) s.addText(c.caption, {
+      x: cx + 0.14, y: cy + 0.88, w: 1.42, h: 0.55, margin: 0, isTextBox: true,
+      fontFace: F.reg, fontSize: 8, color: th.body, valign: "top", lineSpacingMultiple: 1.15,
+    });
+  });
+  if (deck) footer(s, { deck, n, total, dark });
+  return s;
+}
+
+/**
+ * heroQuad — one tall hero card carrying two stacked figures, plus a 2x2 icon grid.
+ * Measured from reference S14: hero 4.21 x 3.06 at x0.38 y1.71; tiles 2.27 x 1.43.
+ * hero: { pill, bigValue, bigCaption, subValue, subCaption }
+ * tiles: [{ icon, title, body }]
+ */
+function heroQuad(pres, { tag, titleText, subtitleText, hero, tiles, kickerText, dark = true, deck, n, total }) {
+  const s = pres.addSlide();
+  background(s, dark);
+  chrome(s, { tag, dark });
+  title(s, titleText, { dark, y: 0.62, h: 0.5 });
+  if (subtitleText) subtitle(s, subtitleText, { dark, y: 1.11, h: 0.46 });
+  const th = theme(dark);
+  card(s, { x: 0.38, y: 1.71, w: 4.21, h: 3.06, dark });
+  if (hero.pill) pill(s, { x: 0.67, y: 1.95, w: 2.62, h: 0.34, text: hero.pill, variant: "outline", dark });
+  s.addText(hero.bigValue, {
+    x: 0.67, y: 2.39, w: 3.4, h: 0.56, margin: 0, isTextBox: true,
+    fontFace: F.semi, fontSize: 34, color: T.accent, valign: "middle",
+  });
+  s.addText(hero.bigCaption, {
+    x: 0.67, y: 2.97, w: 3.4, h: 0.24, margin: 0, isTextBox: true,
+    fontFace: F.reg, fontSize: 9, color: th.body, valign: "middle",
+  });
+  s.addShape("rect", { x: 0.67, y: 3.36, w: 3.30, h: 0.02,
+                       fill: { color: dark ? T.cardMutedStroke : T.divider }, line: { width: 0 } });
+  s.addText(hero.subValue, {
+    x: 0.67, y: 3.49, w: 3.4, h: 0.42, margin: 0, isTextBox: true,
+    fontFace: F.semi, fontSize: 26, color: th.ink, valign: "middle",
+  });
+  s.addText(hero.subCaption, {
+    x: 0.67, y: 3.95, w: 3.3, h: 0.40, margin: 0, isTextBox: true,
+    fontFace: F.reg, fontSize: 9, color: th.body, valign: "top", lineSpacingMultiple: 1.2,
+  });
+  tiles.slice(0, 4).forEach((t, i) => {
+    const cx = i % 2 ? 7.36 : 4.85, cy = i < 2 ? 1.71 : 3.34;
+    card(s, { x: cx, y: cy, w: 2.27, h: 1.43, dark });
+    iconTile(s, { x: cx + 0.18, y: cy + 0.18, size: 0.40, icon: t.icon, dark });
+    s.addText(t.title, {
+      x: cx + 0.68, y: cy + 0.18, w: 1.45, h: 0.40, margin: 0, isTextBox: true,
+      fontFace: F.semi, fontSize: 11, color: th.ink, valign: "middle",
+    });
+    s.addText(t.body, {
+      x: cx + 0.18, y: cy + 0.72, w: 1.91, h: 0.60, margin: 0, isTextBox: true,
+      fontFace: F.reg, fontSize: 8, color: th.body, valign: "top", lineSpacingMultiple: 1.2,
+    });
+  });
+  if (badgeNote) s.addText(badgeNote.toUpperCase(), {
+    x: 4.35, y: 3.42, w: 1.30, h: 0.18, margin: 0, isTextBox: true,
+    fontFace: F.med,
+    fontSize: autoSize(badgeNote.toUpperCase(), 1.30, 0.18, { family: F.med, fontSize: 7, min: 5.5 }),
+    color: T.accent, align: "center", valign: "middle",
+  });
+  if (kickerText) kicker(s, kickerText, { dark, y: 4.84 });
+  if (deck) footer(s, { deck, n, total, dark });
+  return s;
+}
+
+/**
+ * productMap — rail-labelled product architecture: one full band, three cards, a
+ * split workforce row. Measured from reference S11.
+ * bandRow: { rail, icon, title, body }
+ * cards: [{ icon, title, body, bullets: [] }]
+ * split: { rail, left, right }   base: string
+ */
+function productMap(pres, { tag, titleText, subtitleText, bandRow, cards, split, base, dark = false, deck, n, total }) {
+  const s = pres.addSlide();
+  background(s, dark);
+  chrome(s, { tag, dark });
+  title(s, titleText, { dark, y: 0.62, h: 0.48 });
+  if (subtitleText) subtitle(s, subtitleText, { dark, y: 1.16, h: 0.28 });
+  const th = theme(dark);
+  const rail = (label, y, h) => {
+    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 },
+    });
+    s.addText(label.toUpperCase(), {
+      x: 0.37, y, w: 1.0, h, margin: 0, isTextBox: true,
+      fontFace: F.med, fontSize: 8.5, color: T.accentDeep, align: "center", valign: "middle",
+    });
+  };
+
+  rail(bandRow.rail, 1.60, 0.62);
+  s.addShape("roundRect", {
+    x: 1.52, y: 1.60, w: 7.92, h: 0.62, rectRadius: radius(7.92, 0.62),
+    fill: { color: T.cardEmphFlat }, line: { color: T.cardMutedStroke, width: 1 },
+  });
+  iconTile(s, { x: 1.70, y: 1.72, size: 0.38, icon: bandRow.icon, dark: true });
+  s.addText(bandRow.title, {
+    x: 2.22, y: 1.68, w: 2.4, h: 0.24, margin: 0, isTextBox: true,
+    fontFace: F.semi, fontSize: 12, color: T.white, valign: "middle",
+  });
+  s.addText(bandRow.body, {
+    x: 2.22, y: 1.93, w: 6.8, h: 0.22, margin: 0, isTextBox: true,
+    fontFace: F.reg, fontSize: 8, color: T.bodyDark, valign: "middle",
+  });
+
+  rail("EXECUTE", 2.36, 1.88);
+  const xs = [1.52, 4.16, 6.97];
+  cards.slice(0, 3).forEach((c, i) => {
+    const cx = xs[i];
+    card(s, { x: cx, y: 2.36, w: 2.48, h: 1.88, dark });
+    iconTile(s, { x: cx + 0.18, y: 2.52, size: 0.38, icon: c.icon, dark });
+    s.addText(c.title, {
+      x: cx + 0.66, y: 2.52, w: 1.68, h: 0.38, margin: 0, isTextBox: true,
+      fontFace: F.semi, fontSize: 11.5, color: th.ink, valign: "middle",
+    });
+    s.addText(c.body, {
+      x: cx + 0.18, y: 3.02, w: 2.14, h: 0.48, margin: 0, isTextBox: true,
+      fontFace: F.reg, fontSize: 8, color: th.body, valign: "top", lineSpacingMultiple: 1.2,
+    });
+    if (c.bullets) s.addText(
+      c.bullets.map((b, j) => ({ text: b, options: { bullet: true, breakLine: j !== c.bullets.length - 1 } })),
+      { x: cx + 0.22, y: 3.52, w: 2.12, h: 0.70, margin: 0, isTextBox: true,
+        fontFace: F.reg, fontSize: 8, color: T.accentDeep, valign: "top", paraSpaceAfter: 2 }
+    );
+  });
+
+  rail(split.rail || "WORKFORCE", 4.38, 0.62);
+  s.addShape("roundRect", {
+    x: 1.52, y: 4.38, w: 3.84, h: 0.62, rectRadius: radius(3.84, 0.62),
+    fill: { color: T.cardEmphFlat }, line: { color: T.cardMutedStroke, width: 1 },
+  });
+  s.addText(split.left, {
+    x: 1.75, y: 4.38, w: 3.5, h: 0.62, margin: 0, isTextBox: true,
+    fontFace: F.semi, fontSize: 12, color: T.white, valign: "middle",
+  });
+  s.addShape("roundRect", {
+    x: 5.60, y: 4.38, w: 3.84, h: 0.62, rectRadius: radius(3.84, 0.62),
+    fill: { color: dark ? T.cardMuted : T.cardLight },
+    line: { color: dark ? T.cardMutedStroke : T.divider, width: 1 },
+  });
+  s.addText(split.right, {
+    x: 5.83, y: 4.38, w: 3.5, h: 0.62, margin: 0, isTextBox: true,
+    fontFace: F.semi, fontSize: 12, color: th.ink, valign: "middle",
+  });
+  if (base) s.addText(base.toUpperCase(), {
+    x: 0.37, y: 5.02, w: 9.25, h: 0.22, margin: 0, isTextBox: true,
+    fontFace: F.med, fontSize: 8.5, italic: true, color: th.body,
+    align: "center", valign: "middle",
+  });
+  if (deck) footer(s, { deck, n, total, dark });
+  return s;
+}
+
+/* ------------------------------------------------------------------ export */
+
+
+module.exports = {
+  VERSION: "0.8.0",
+  T, F, COLS, ASSETS, radius, theme, autoSize, measure: M,
+  background, chrome, footer, title, subtitle, kicker, contentTop,
+  card, iconTile, pill,
+  cover, divider, closing,
+  threeUp, fourUpIcon, sixUpIcon, rows, parity, statQuad, statGrid, band,
+  colCards, featureStats, barRank, bridge, heroQuad, productMap,
+
+  /** Call once, before adding slides. */
+  newDeck(pptxgen) {
+    const pres = new pptxgen();
+    pres.layout = "LAYOUT_16x9"; // 10.000" x 5.625" — do not change
+    return pres;
+  },
+};
+
+// Dense enterprise layouts live in their own module to keep this file readable.
+require("./lib/layouts_dense")(module.exports);
+require("./lib/layouts_consult")(module.exports);
+require("./lib/layouts_client")(module.exports);