wand-decks-kit 0.8.6 → 0.9.0

package/lib/schema.js

@@ -36,7 +36,8 @@ const L = {
     bleed: true,
     fields: {
       eyebrow: str(), body: str(), kickerPlain: str(), kickerBold: str(),
-      titleLines: s("string[]", req({ max: 3, note: "one entry per line; auto-shrinks 46→38pt" })),
+      titleLines: s("string[]", req({ max: 3, note: "one entry per line; auto-shrinks 39→30pt" })),
+      presentedTo: s("string[]", { max: 3, note: "the audience, bottom right — one name and title per entry" }),
     },
   },
   divider: {
@@ -50,6 +51,28 @@ const L = {
     fields: { eyebrow: str(), line1: str(req()), line2: str(), body: str(), url: str() },
   },
 
+  /* ----------------------------------------------------- guideline (0.9) */
+  agenda: {
+    use: "What we'll cover — 2–5 numbered cards in a row",
+    fields: { items: s("object[]", req({ min: 2, max: 5, of: { title: str(req()), body: str() } })) },
+  },
+  team: {
+    use: "Who's in the room — 2–4 people, each with a headshot slot the user fills",
+    fields: { items: s("object[]", req({ min: 2, max: 4, of: { name: str(req()), role: str(), initials: str() } })) },
+  },
+  fourCards: {
+    use: "Four titled cards under a lede — demo objectives, pillars, principles",
+    fields: { items: s("object[]", req({ min: 3, max: 4, of: { title: str(req()), body: str(req()) } })) },
+  },
+  deliverColumns: {
+    use: "Three flat columns with an accent bar — how we deliver, phases with an owner line. Light by default",
+    fields: { columns: s("object[]", req({ min: 2, max: 3, of: { heading: str(req()), lead: str(), body: str(req()) } })) },
+  },
+  coDelivery: {
+    use: "Up to six numbered rows in two columns — a co-delivery model, operating principles",
+    fields: { items: s("object[]", req({ min: 2, max: 6, of: { title: str(req()), body: str(req()) } })) },
+  },
+
   /* --------------------------------------------------------------- content */
   threeUp: {
     use: "3 comparable things. `arrows: true` for a progression",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wand-decks-kit",
-  "version": "0.8.6",
+  "version": "0.9.0",
   "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/tools/brandlint.py

@@ -0,0 +1,74 @@
+#!/usr/bin/env python3
+"""
+brandlint.py — is this deck on the guideline?
+
+    python3 tools/brandlint.py deck.pptx palette.json
+
+For a deck the kit did not build — one edited directly, or a client's file — the
+fit gate cannot run, but the guideline still can: is every text run in Geist, is
+every colour a token, is the canvas 10 x 5.625, does every content slide carry
+the tag and the page footer. Reports per slide and exits 1 on any miss, so an
+edit-only job ends with a list of inconsistencies to put to the user, not a
+silent hand-back.
+
+Only runs that carry text count. PowerPoint leaves Calibri on empty end-of-
+paragraph runs; flagging those would make every deck fail.
+"""
+import json, os, re, sys, zipfile, collections
+
+deck, palette = sys.argv[1], json.load(open(sys.argv[2]))
+tokens = {v.upper() for v in palette.values()}
+GEIST = re.compile(r"^Geist( |$)")
+z = zipfile.ZipFile(deck)
+names = sorted((n for n in z.namelist() if re.fullmatch(r"ppt/slides/slide\d+\.xml", n)),
+               key=lambda n: int(re.findall(r"\d+", n)[0]))
+pres = z.read("ppt/presentation.xml").decode()
+cx, cy = (int(v) for v in re.search(r'<p:sldSz cx="(\d+)" cy="(\d+)"', pres).groups())
+canvas_ok = abs(cx / 914400 - 10) < 0.01 and abs(cy / 914400 - 5.625) < 0.01
+
+bad = 0
+print(f"canvas      : {cx/914400:.3f} x {cy/914400:.3f} in — {'ok' if canvas_ok else 'NOT the 10 x 5.625 grid'}")
+bad += not canvas_ok
+font_hits = collections.Counter(); colour_hits = collections.Counter(); chrome_miss = []
+for n in names:
+    i = int(re.findall(r"\d+", n)[0])
+    s = z.read(n).decode("utf8", "ignore")
+    # runs with text: <a:r><a:rPr ...>…</a:rPr><a:t>text</a:t></a:r>
+    for m in re.finditer(r"<a:r>(.*?)</a:r>", s, re.S):
+        run = m.group(1)
+        t = re.search(r"<a:t>([^<]*)</a:t>", run)
+        if not t or not t.group(1).strip():
+            continue
+        face = re.search(r'<a:latin typeface="([^"]+)"', run)
+        if face and not GEIST.match(face.group(1)):
+            font_hits[(i, face.group(1))] += 1
+        for c in re.findall(r'<a:srgbClr val="([0-9A-Fa-f]{6})"', run):
+            if c.upper() not in tokens:
+                colour_hits[(i, c.upper())] += 1
+    # Content slides carry the footer; cover, dividers and the closing drop it by
+    # design. Those three are the first slide, the last, and any slide with fewer
+    # than seven text frames (a divider is tag, eyebrow, title, body).
+    frames = [t for t in re.findall(r"<a:t>([^<]*)</a:t>", s) if t.strip()]
+    if i not in (1, len(names)) and len(frames) >= 7 and "WAND" not in " ".join(frames).upper():
+        chrome_miss.append(i)
+
+if font_hits:
+    bad += 1
+    by = collections.defaultdict(list)
+    for (i, f), c in sorted(font_hits.items()): by[i].append(f"{f} x{c}")
+    print("fonts       : NOT Geist on " + ", ".join(f"S{i:02} ({'; '.join(v)})" for i, v in by.items()))
+else:
+    print("fonts       : every text run is Geist")
+if colour_hits:
+    top = colour_hits.most_common(8)
+    print("colours     : " + str(len(colour_hits)) + " off-palette use(s) — " +
+          ", ".join(f"S{i:02} {c} x{n}" for (i, c), n in top))
+    bad += 1
+else:
+    print("colours     : every text colour is a token")
+if chrome_miss:
+    print("chrome      : no WAND footer/tag text on " + ", ".join(f"S{i:02}" for i in chrome_miss))
+    bad += 1
+else:
+    print("chrome      : footer present on every content slide")
+sys.exit(1 if bad else 0)

package/wand.js

@@ -56,6 +56,7 @@ function runPython(args) {
 function doctor() {
   const rows = [];
   const py = python();
+  rows.push(["wand-decks-kit", require("./wand_kit").VERSION, "ok"]);
   rows.push(["node", process.version, "ok"]);
   rows.push(["python3", py ? execFileSync(py, ["-V"], { encoding: "utf8" }).trim() : "MISSING",
              py ? "ok" : "extract and font embedding unavailable"]);
@@ -253,6 +254,80 @@ function ship(specPath, outArg) {
   return gates.some(([, ok]) => ok === false) ? 1 : 0;
 }
 
+/**
+ * Every gate that does not need a spec, on any .pptx.
+ *
+ * A field run adapted a source deck by editing it directly — the right call,
+ * this kit cannot copy a source slide's shapes — and then delivered it with
+ * no gate but a generic validator, because `ship` wants a spec. Now the
+ * spec-free gates run on their own: file structure and fonts, the PDF text
+ * layer, a render of every slide with the contact sheet, and coverage when a
+ * verbatim dump is given. LibreOffice does the render, so fit is *not* judged
+ * here (§9 — DejaVu is wider than Geist); geometry, overlap and contrast are.
+ */
+function audit(file, dump) {
+  const work = path.join(path.dirname(file), "audit");
+  fs.mkdirSync(work, { recursive: true });
+  console.log(rule("1 file"));
+  const fileErrs = inspect(file);
+
+  console.log(rule("2 render"));
+  let shots = 0, garbled = null, pdf = null;
+  // on PATH in a sandbox; an app bundle on a Mac
+  const soffice = ["soffice", "libreoffice"].find((c) => has(c))
+    || ["/Applications/LibreOffice.app/Contents/MacOS/soffice"].find((p) => fs.existsSync(p)) || null;
+  if (soffice) {
+    spawnSync(soffice, ["--headless", "--convert-to", "pdf", "--outdir", work, file], { stdio: "ignore" });
+    pdf = path.join(work, path.basename(file).replace(/\.pptx$/i, ".pdf"));
+  }
+  if (pdf && fs.existsSync(pdf) && has("pdftoppm")) {
+    const dir = path.join(work, "slides");
+    fs.mkdirSync(dir, { recursive: true });
+    spawnSync("pdftoppm", ["-r", "96", "-png", pdf, path.join(dir, "slide")], { stdio: "ignore" });
+    shots = fs.readdirSync(dir).filter((f) => f.startsWith("slide")).length;
+    const small = fs.mkdtempSync(path.join(require("os").tmpdir(), "wand-sheet-"));
+    spawnSync("pdftoppm", ["-r", "26", "-png", pdf, path.join(small, "s")], { stdio: "ignore" });
+    const sheet = path.join(dir, "sheet.png");
+    runPython([path.join(KIT, "tools", "sheet.py"), small, sheet]);
+    fs.rmSync(small, { recursive: true, force: true });
+    console.log(`rendered    : ${shots} slide(s) — open ${rel(sheet)} (LibreOffice: trust geometry,`);
+    console.log(`              overlap and contrast; do NOT judge fit or weight from it)`);
+    if (has("pdftotext")) {
+      const r = spawnSync("pdftotext", [pdf, "-"], { encoding: "utf8" });
+      if (r.status === 0) {
+        garbled = 0;
+        for (const c of r.stdout || "") { const cp = c.codePointAt(0); if (cp >= 0x01c9 && cp <= 0x024f) garbled++; }
+        console.log(garbled ? `text layer  : ${garbled} garbled glyph(s) — fonts are subsetted` : "text layer  : digits decode clean");
+      }
+    }
+  } else {
+    console.log(soffice ? "pdftoppm absent — no renders" : "no LibreOffice — no renders; open the deck and look at every slide");
+  }
+
+  console.log(rule("3 brand"));
+  // The guideline, as a gate: fonts, colours, canvas, chrome. This is what an
+  // edit-only job reports back as "design inconsistencies" before touching
+  // anything the user did not ask for.
+  const pal = path.join(require("os").tmpdir(), `wand-palette-${process.pid}.json`);
+  fs.writeFileSync(pal, JSON.stringify(require("./wand_kit").T));
+  const brand = runPython([path.join(KIT, "tools", "brandlint.py"), file, pal]);
+  fs.rmSync(pal, { force: true });
+
+  console.log(rule("4 coverage"));
+  let cov = null;
+  if (dump && fs.existsSync(dump)) cov = runPython([path.join(KIT, "qa_coverage.py"), dump, file]);
+  else console.log("no dump given — skipped. Pass --dump work/visible_dump.txt from `rebuild` to check\n" +
+                   "every source string survived the edit.");
+
+  const gates = [["file", fileErrs === 0], ["brand", brand === 0],
+                 ["pdf text", garbled === null ? null : garbled === 0],
+                 ["renders", shots > 0 ? true : null], ["coverage", cov === null ? null : cov === 0]];
+  console.log(rule("gates"));
+  for (const [n, ok] of gates) console.log(`  ${ok === null ? "skip" : ok ? " ok " : "FAIL"}  ${n}`);
+  console.log("  (fit is not gated on a deck built outside the kit — say so in the review note)\n");
+  return gates.some(([, ok]) => ok === false) ? 1 : 0;
+}
+
 /**
  * File-level check, in-process. `validate.py` from the pptx skill is not in the
  * zip and LibreOffice may not be installed, so the kit carries its own: the
@@ -415,6 +490,12 @@ to.
     if (!positional[0]) die("usage: node wand.js inspect <deck.pptx>");
     process.exit(inspect(path.resolve(positional[0])) ? 1 : 0);
 
+  case "audit": {
+    if (!positional[0]) die("usage: node wand.js audit <deck.pptx> [--dump visible_dump.txt]");
+    const di = rest.indexOf("--dump");
+    process.exit(audit(path.resolve(positional[0]), di >= 0 ? path.resolve(rest[di + 1]) : null));
+  }
+
   case "ship":
     if (!positional[0]) die("usage: node wand.js ship <spec.json> [out.pptx]");
     process.exit(ship(positional[0], positional[1]));

package/wand_kit.js

@@ -25,23 +25,27 @@ function autoSize(text, w, h, opts) {
 /* ------------------------------------------------------------------ tokens */
 
 const T = {
-  accent:     "8B7CF6",
-  accentDeep: "6C5CE7",
-  accentSoft: "A99CF8",
-  accentPale: "C4B5F4",
+  // Measured from the guideline deck (Vivicta_Session_Deck, 2026-09-23): the
+  // counts are how many shape fills / text runs use each value across its 16
+  // slides. A token here is a guideline value, not a taste.
+  accent:     "8B7CF6",   // tags, accent-italic, rules, pills (fills 18, text 14)
+  accentDeep: "6C5CE7",   // accent text on light surfaces
+  accentSoft: "9481FF",   // accent text on dark: eyebrows, links, pills (text 22)
+  accentPale: "DCD6F5",   // quote marks, soft labels on dark (text 12)
 
-  bgDark:      "0F0C26",
-  inkDark:     "F3F1FA",
+  bgDark:      "240F48",  // flat dark ground — the guideline paints no art on interior slides
+  inkDark:     "FFFFFF",  // titles (text 101)
   white:       "FFFFFF",
-  bodyDark:    "B7B0DC",
-  bodyDarkAlt: "CCC0F2",
-  cardStroke:  "2E2757",
-  cardSolid:   "2C2460",
-  cardMuted:   "241D4F",
-  cardMutedStroke: "4A3F8C",
-  cardEmphFlat: "352B70",
-  band:        "0F0C26",
-  footerDark:  "F3F3F3",
+  bodyDark:    "F5F5F5",  // body (text 54)
+  mutedDark:   "BBBBBB",  // captions, footer (text 32)
+  bodyDarkAlt: "C6BFE4",  // lists inside cards (text 22)
+  cardStroke:  "5B4BB0",  // 1pt card stroke (lines 16)
+  cardSolid:   "2A1F5C",  // opaque card (fills 23)
+  cardMuted:   "1B1738",  // de-emphasised card (fills 16)
+  cardMutedStroke: "3A2E63",
+  cardEmphFlat: "251C63", // emphasis surface (fills 8)
+  band:        "240F48",
+  footerDark:  "BBBBBB",
 
   bgLight:    "F8F6FB",
   inkLight:   "1D1A33",
@@ -93,8 +97,9 @@ const theme = (dark) => dark
 
 function background(slide, dark) {
   if (dark) {
+    // The guideline's interior dark slides are a flat 240F48 — the gradient
+    // art belongs to the cover and closing only.
     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 };
   }
@@ -104,27 +109,28 @@ function background(slide, dark) {
 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,
+      x: 0.42, 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,
+    x: 9.40, y: 0.26, w: 0.22, h: 0.18,
   });
 }
 
 /** 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;
+  // guideline: a 0.34" band at y 5.29, 7pt, "WAND · CONFIDENTIAL" left, "03/13" right
   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",
+    x: 0.42, y: 5.29, w: 4.58, h: 0.34, margin: 0, isTextBox: true,
+    fontFace: F.reg, fontSize: 7, 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",
+  slide.addText(`${confidential}  ·  ${pad(n)}/${pad(total)}`, {
+    x: 5.23, y: 5.29, w: 4.38, h: 0.34, margin: 0, isTextBox: true,
+    fontFace: F.reg, fontSize: 7, color: c, align: "right", valign: "middle",
   });
 }
 
@@ -216,9 +222,17 @@ function kicker(slide, text, { dark = true, y = 4.82 } = {}) {
 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 }; }
+  if (dark) {
+    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 }; }
+  } else {
+    // The dark variants are dark purples; painted on a light slide they hide
+    // the light theme's ink. A guideline agenda rendered as four black boxes.
+    if (variant === "solid")  { fill = { color: T.cardLight };     line = { color: T.divider, width: 1 }; }
+    if (variant === "muted")  { fill = { color: T.surface };       line = { color: T.divider, width: 1, dashType: "dash" }; }
+    if (variant === "emph")   { fill = { color: T.surface };       line = { color: T.accentPale, width: 1 }; }
+  }
   slide.addShape("roundRect", {
     x, y, w, h, fill: { ...fill }, line: { ...line }, rectRadius: radius(w, h),
   });
@@ -267,37 +281,43 @@ function pill(slide, { x, y, w, h = 0.34, text, variant = "outline", dark = true
 /* ------------------------------------------------------------------ layouts */
 
 /** L1 cover — dark only, full bleed, no footer. */
-function cover(pres, { eyebrow, titleLines, body, kickerPlain, kickerBold, tag }) {
+function cover(pres, { eyebrow, titleLines, body, kickerPlain, kickerBold, tag, presentedTo }) {
   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 });
+  // The guideline cover is one full-bleed composition with the orb baked in.
+  s.addImage({ path: `${ASSETS}/cover-art.png`, x: 0, y: 0, w: 10, h: 5.625 });
   if (tag) chrome(s, { tag, dark: true });
   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",
+    x: 0.42, y: 1.36, w: 6.0, h: 0.3, margin: 0, isTextBox: true,
+    fontFace: F.med, fontSize: 11, 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 });
+  const tSize = autoSize(titleLines.join("\n"), 6.29, 1.23,
+    { family: F.xbold, fontSize: 39, min: 30, lineSpacingMultiple: 1.05 });
   s.addText(titleLines.join("\n"), {
-    x: 0.39, y: 1.58, w: 5.55, h: 1.55, margin: 0, isTextBox: true,
+    x: 0.42, y: 1.79, w: 6.29, h: 1.23, 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,
+  if (body) s.addText(body, {
+    x: 0.42, y: 3.15, w: 5.56, h: 0.6, margin: 0, isTextBox: true,
+    fontFace: F.reg, fontSize: 12.5, color: T.bodyDark, 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 } });
-  // 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 } },
+    kickerPlain && { text: kickerPlain + "  ", options: { fontFace: F.reg, fontSize: 10, color: T.bodyDark } },
     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" });
+    { x: 0.42, y: 4.52, w: 5.5, h: 0.4, margin: 0, isTextBox: true, valign: "middle" });
+  // "PRESENTED TO" block, bottom right — the guideline's audience line.
+  if (presentedTo && presentedTo.length) {
+    s.addText("PRESENTED TO", {
+      x: 6.67, y: 4.52, w: 3.21, h: 0.22, margin: 0, isTextBox: true,
+      fontFace: F.med, fontSize: 8, color: T.accentSoft, valign: "middle",
+    });
+    s.addText(presentedTo.join("\n"), {
+      x: 6.67, y: 4.74, w: 3.21, h: 0.66, margin: 0, isTextBox: true,
+      fontFace: F.reg, fontSize: 9.5, color: T.white, valign: "top", lineSpacingMultiple: 1.2,
+    });
+  }
   return s;
 }
 
@@ -331,23 +351,30 @@ function divider(pres, { tag, eyebrow, titleText, body }) {
 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.addImage({ path: `${ASSETS}/closing-art.png`, x: 0, y: 0, w: 10, h: 5.625 });
+  s.addImage({ path: `${ASSETS}/mark-white.png`, x: 9.40, y: 0.24, w: 0.22, h: 0.19 });
+  s.addImage({ path: `${ASSETS}/orb-glow.png`, x: 3.98, y: 0.69, w: 2.03, h: 2.03 });
+  // The orb owns the top; everything reads below it. A long line shrinks
+  // rather than wrapping into the eyebrow — the guideline's "Thank You" is
+  // 33pt, but a real ask is usually a sentence.
   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",
+    x: 1.16, y: 2.82, w: 7.67, h: 0.24, margin: 0, isTextBox: true,
+    fontFace: F.med, fontSize: 10, color: T.accentSoft, align: "center", valign: "middle",
   });
+  const joined = (line1 || "") + (line2 ? " " + line2 : "");
+  const size = autoSize(joined, 7.67, 0.72, { family: F.semi, fontSize: 33, min: 22, lineSpacingMultiple: 1.05 });
   s.addText([
-    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 });
+    line1 && { text: line1 + (line2 ? " " : ""), options: { fontFace: F.semi, fontSize: size, color: T.white } },
+    line2 && { text: line2, options: { fontFace: F.semi, fontSize: size, italic: true, color: T.accentSoft } },
+  ].filter(Boolean), { x: 1.16, y: 3.08, w: 7.67, h: 0.72, margin: 0, isTextBox: true, align: "center", valign: "middle", lineSpacingMultiple: 1.05 });
   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,
+    x: 1.16, y: 3.90, w: 7.67, h: 0.62, margin: 0, isTextBox: true,
+    fontFace: F.reg, fontSize: autoSize(body, 7.67, 0.62, { family: F.reg, fontSize: 16, min: 11, lineSpacingMultiple: 1.2 }),
+    color: T.bodyDark, align: "center", valign: "top", lineSpacingMultiple: 1.2,
   });
   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",
+    x: 1.16, y: 4.62, w: 7.67, h: 0.24, margin: 0, isTextBox: true,
+    fontFace: F.reg, fontSize: 10, color: T.mutedDark, align: "center", valign: "middle",
   });
   return s;
 }
@@ -998,12 +1025,170 @@ function productMap(pres, { tag, titleText, subtitleText, bandRow, cards, split,
 /* ------------------------------------------------------------------ export */
 
 
+
+/* ------------------------------------------------- guideline layouts (0.9) */
+/* Measured from Vivicta_Session_Deck: the slides a sales session adds to the
+   standard deck — agenda, team, demo objectives, delivery columns, co-delivery. */
+
+/** Agenda — 2–5 numbered cards in a row (S03). items: [{ title, body }] */
+function agenda(pres, { tag, titleText, subtitleText, items, dark = true, deck, n, total }) {
+  const s = pres.addSlide();
+  background(s, dark); chrome(s, { tag, dark });
+  const th = theme(dark);
+  const top = contentTop(titleText, subtitleText);
+  title(s, titleText, { dark, y: 0.62, h: 0.5 });
+  if (subtitleText) subtitle(s, subtitleText, { dark, y: 1.14, h: 0.3 });
+  const list = items.slice(0, 5);
+  const gap = 0.22, w = (9.17 - gap * (list.length - 1)) / list.length, cy = 1.62, ch = 2.41;
+  list.forEach((it, i) => {
+    const cx = 0.42 + i * (w + gap);
+    card(s, { x: cx, y: cy, w, h: ch, dark, variant: "solid" });
+    s.addText(String(i + 1).padStart(2, "0"), {
+      x: cx + 0.15, y: cy + 0.14, w: 1.0, h: 0.15, margin: 0, isTextBox: true,
+      fontFace: F.semi, fontSize: 8, color: T.accentSoft, valign: "middle",
+    });
+    s.addText(it.title, {
+      x: cx + 0.15, y: cy + 0.44, w: w - 0.3, h: 0.5, margin: 0, isTextBox: true,
+      fontFace: F.semi, fontSize: 11, color: th.ink, valign: "top", lineSpacingMultiple: 1.15,
+    });
+    if (it.body) s.addText(it.body, {
+      x: cx + 0.15, y: cy + 1.0, w: w - 0.3, h: ch - 1.15, margin: 0, isTextBox: true,
+      fontFace: F.reg, fontSize: autoSize(it.body, w - 0.3, ch - 1.15, { family: F.reg, fontSize: 8.5, min: 7, lineSpacingMultiple: 1.3 }),
+      color: th.body, valign: "top", lineSpacingMultiple: 1.3,
+    });
+  });
+  if (deck) footer(s, { deck, n, total, dark });
+  return s;
+}
+
+/** Team — 2–4 people with a headshot slot (S02). items: [{ name, role, initials }] */
+function team(pres, { tag, titleText, items, dark = true, deck, n, total }) {
+  const s = pres.addSlide();
+  background(s, dark); chrome(s, { tag, dark });
+  const th = theme(dark);
+  title(s, titleText, { dark, y: 0.70, h: 0.5 });
+  const list = items.slice(0, 4);
+  const cw = 2.14, ch = 2.34, gap = 0.20;
+  const x0 = (10 - (cw * list.length + gap * (list.length - 1))) / 2;
+  list.forEach((it, i) => {
+    const cx = x0 + i * (cw + gap), cy = 1.62;
+    card(s, { x: cx, y: cy, w: cw, h: ch, dark, variant: "solid" });
+    // headshot slot: a circle the user drops a picture onto; initials until then
+    const d = 0.95;
+    s.addShape("ellipse", { x: cx + (cw - d) / 2, y: cy + 0.22, w: d, h: d,
+      fill: { color: dark ? T.cardMuted : T.surface }, line: { color: T.accentSoft, width: 1 } });
+    s.addText(it.initials || it.name.split(/\s+/).map((p) => p[0]).join("").slice(0, 2).toUpperCase(), {
+      x: cx + (cw - d) / 2, y: cy + 0.22, w: d, h: d, margin: 0, isTextBox: true,
+      fontFace: F.semi, fontSize: 18, color: T.accentSoft, align: "center", valign: "middle",
+    });
+    s.addText(it.name, {
+      x: cx + 0.15, y: cy + 1.32, w: cw - 0.3, h: 0.26, margin: 0, isTextBox: true,
+      fontFace: F.semi, fontSize: 11, color: th.ink, align: "center", valign: "middle",
+    });
+    if (it.role) s.addText(it.role, {
+      x: cx + 0.15, y: cy + 1.60, w: cw - 0.3, h: 0.5, margin: 0, isTextBox: true,
+      fontFace: F.reg, fontSize: 8.5, color: T.accentSoft, align: "center", valign: "top", lineSpacingMultiple: 1.25,
+    });
+  });
+  if (deck) footer(s, { deck, n, total, dark });
+  return s;
+}
+
+/** Four cards under a title and lede — demo objectives, pillars (S12). items: [{ title, body }] */
+function fourCards(pres, { tag, titleText, subtitleText, items, dark = true, deck, n, total }) {
+  const s = pres.addSlide();
+  background(s, dark); chrome(s, { tag, dark });
+  const th = theme(dark);
+  title(s, titleText, { dark, y: 0.62, h: 0.5 });
+  if (subtitleText) subtitle(s, subtitleText, { dark, y: 1.14, h: 0.45 });
+  const list = items.slice(0, 4);
+  const gap = 0.20, w = (9.17 - gap * (list.length - 1)) / list.length, cy = 1.92, ch = 2.55;
+  list.forEach((it, i) => {
+    const cx = 0.42 + i * (w + gap);
+    card(s, { x: cx, y: cy, w, h: ch, dark, variant: "solid" });
+    s.addText(it.title, {
+      x: cx + 0.17, y: cy + 0.22, w: w - 0.34, h: 0.5, margin: 0, isTextBox: true,
+      fontFace: F.semi, fontSize: 11, color: th.ink, valign: "top", lineSpacingMultiple: 1.15,
+    });
+    s.addText(it.body, {
+      x: cx + 0.17, y: cy + 0.82, w: w - 0.34, h: ch - 1.0, margin: 0, isTextBox: true,
+      fontFace: F.reg, fontSize: autoSize(it.body, w - 0.34, ch - 1.0, { family: F.reg, fontSize: 8.5, min: 7, lineSpacingMultiple: 1.3 }),
+      color: th.body, valign: "top", lineSpacingMultiple: 1.3,
+    });
+  });
+  if (deck) footer(s, { deck, n, total, dark });
+  return s;
+}
+
+/** Three flat columns with an accent bar — "how we deliver" (S14). columns: [{ heading, lead, body }] */
+function deliverColumns(pres, { tag, titleText, subtitleText, columns, dark = false, deck, n, total }) {
+  const s = pres.addSlide();
+  background(s, dark); chrome(s, { tag, dark });
+  const th = theme(dark);
+  title(s, titleText, { dark, y: 0.58, h: 0.5 });
+  if (subtitleText) subtitle(s, subtitleText, { dark, y: 1.14, h: 0.3 });
+  const list = columns.slice(0, 3);
+  const gap = 0.23, w = (9.17 - gap * (list.length - 1)) / list.length, cy = 1.62, ch = 3.02;
+  list.forEach((c, i) => {
+    const cx = 0.42 + i * (w + gap);
+    s.addShape("rect", { x: cx, y: cy, w, h: ch, fill: { color: dark ? T.cardSolid : T.surface }, line: { width: 0 } });
+    s.addShape("rect", { x: cx, y: cy, w, h: 0.04, fill: { color: T.accent }, line: { width: 0 } });
+    s.addText(c.heading, {
+      x: cx + 0.2, y: cy + 0.15, w: w - 0.4, h: 0.24, margin: 0, isTextBox: true,
+      fontFace: F.semi, fontSize: 11, color: th.ink, valign: "middle",
+    });
+    if (c.lead) s.addText(c.lead, {
+      x: cx + 0.2, y: cy + 0.40, w: w - 0.4, h: 0.32, margin: 0, isTextBox: true,
+      fontFace: F.med, fontSize: 9.5, color: dark ? T.accentSoft : T.accentDeep, valign: "top", lineSpacingMultiple: 1.2,
+    });
+    s.addText(c.body, {
+      x: cx + 0.2, y: cy + 0.80, w: w - 0.4, h: ch - 0.95, margin: 0, isTextBox: true,
+      fontFace: F.reg, fontSize: autoSize(c.body, w - 0.4, ch - 0.95, { family: F.reg, fontSize: 8.5, min: 7, lineSpacingMultiple: 1.3 }),
+      color: th.body, valign: "top", lineSpacingMultiple: 1.3,
+    });
+  });
+  if (deck) footer(s, { deck, n, total, dark });
+  return s;
+}
+
+/** Numbered rows in two columns — a co-delivery model, principles (S13). items: [{ title, body }] up to 6 */
+function coDelivery(pres, { tag, titleText, subtitleText, items, dark = true, deck, n, total }) {
+  const s = pres.addSlide();
+  background(s, dark); chrome(s, { tag, dark });
+  const th = theme(dark);
+  title(s, titleText, { dark, y: 0.62, h: 0.5 });
+  if (subtitleText) subtitle(s, subtitleText, { dark, y: 1.14, h: 0.3 });
+  const list = items.slice(0, 6);
+  const cw = 4.17, ch = 0.80, colX = [0.55, 5.04], rows = Math.ceil(list.length / 2), y0 = 1.65, gy = 0.26;
+  list.forEach((it, i) => {
+    const col = Math.floor(i / rows), row = i % rows;
+    const cx = colX[col], cy = y0 + row * (ch + gy);
+    card(s, { x: cx, y: cy, w: cw, h: ch, dark, variant: "solid" });
+    s.addText(String(i + 1).padStart(2, "0"), {
+      x: cx + 0.14, y: cy + 0.2, w: 0.35, h: 0.25, margin: 0, isTextBox: true,
+      fontFace: F.semi, fontSize: 11, color: T.accentSoft, valign: "middle",
+    });
+    s.addText(it.title, {
+      x: cx + 0.55, y: cy + 0.12, w: cw - 0.7, h: 0.19, margin: 0, isTextBox: true,
+      fontFace: F.semi, fontSize: 10, color: th.ink, valign: "middle",
+    });
+    s.addText(it.body, {
+      x: cx + 0.55, y: cy + 0.35, w: cw - 0.7, h: ch - 0.42, margin: 0, isTextBox: true,
+      fontFace: F.reg, fontSize: autoSize(it.body, cw - 0.7, ch - 0.42, { family: F.reg, fontSize: 8, min: 6.5, lineSpacingMultiple: 1.2 }),
+      color: th.body, valign: "top", lineSpacingMultiple: 1.2,
+    });
+  });
+  if (deck) footer(s, { deck, n, total, dark });
+  return s;
+}
+
 module.exports = {
-  VERSION: "0.8.6",
+  VERSION: "0.9.0",
   T, F, COLS, ASSETS, radius, theme, autoSize, measure: M,
   background, chrome, footer, title, subtitle, kicker, contentTop,
   card, iconTile, pill,
   cover, divider, closing,
+  agenda, team, fourCards, deliverColumns, coDelivery,
   threeUp, fourUpIcon, sixUpIcon, rows, parity, statQuad, statGrid, band,
   colCards, featureStats, barRank, bridge, heroQuad, productMap,