onbuzz 4.9.1 → 4.9.7

package/src/tools/office/pres/themes/data-heavy.js

@@ -0,0 +1,83 @@
+/**
+ * Theme: data-heavy
+ *
+ * Reference: financial / analytics reporting — Bloomberg terminals,
+ * McKinsey decks, FT Lex columns. Tight spacing, gridded backgrounds,
+ * monospace numerals, restrained accents, lots of small data labels.
+ * Reads as "rigorous" and "trustworthy".
+ *
+ * Best fit: KPI reviews, earnings reports, research summaries, any
+ * deck where the numbers ARE the message.
+ */
+import { buildScale } from '../typography.js';
+
+export default {
+  id: 'data-heavy',
+  family: 'data',
+  description: 'Analyst-style: tight grid, monospace numerals, gridded backgrounds, restrained accents.',
+  defaults: {
+    palette:    'finch',
+    spacing:    'tight',
+    shape:      'sharp',
+    background: 'grid',
+  },
+  typography: buildScale({
+    display: 'Calibri',
+    body:    'Calibri',
+    mono:    'Consolas',
+    // Data-heavy stays tighter than the other two themes — readers are
+    // closer to the page (printable analyst report posture) — but the
+    // sizes still need to be conference-readable. Old scale was too
+    // close to "Word document"; this is "FT print spread".
+    sizes: {
+      display:  80,
+      title:    38,
+      subtitle: 22,
+      body:     17,
+      caption:  12,
+      stat:     176,
+      eyebrow:  12,
+    },
+    weights: { display: 'bold', title: 'bold', subtitle: 'normal' },
+    letterSpacing: { display: -2, title: -0.5, eyebrow: 2 },
+  }),
+  archetypes: {
+    hero: {
+      align: 'left',
+      reportMeta: true,             // small "Q4 2026 · Report" line over title
+    },
+    statCallout: {
+      statColor: 'primary',
+      labelStyle: 'mono',           // mono labels feel "data"
+      sourceFootnote: true,         // source line at bottom
+    },
+    quote: {
+      bigQuotes: false,
+      attributionStyle: 'block',
+    },
+    twoColChart: {
+      gridlinesOnChart: true,
+      smallMultiples: true,
+    },
+    table: {
+      striped: true,
+      monospaceNumbers: true,
+    },
+  },
+  decoration: {
+    grid: {
+      lineColor: 'subtle',
+      lineOpacity: 8,
+      spacing: 0.5,                  // grid line every 0.5"
+    },
+    geometric: {
+      style: 'data',
+      density: 'minimal',
+    },
+    noiseOpacity: 0,
+    mesh: {
+      stops: 2,
+      saturation: 'muted',
+    },
+  },
+};

package/src/tools/office/pres/themes/editorial-warm.js

@@ -0,0 +1,77 @@
+/**
+ * Theme: editorial-warm
+ *
+ * Reference: long-read magazines — Wired, NYT Magazine, The Atlantic.
+ * Serif display + sans body; cream paper background with hairline
+ * rules; sharp corners (no shadows); large breathing room; small
+ * eyebrow labels above titles. Reads as "considered" and "literary".
+ *
+ * Best fit: research reports, design reviews, brand-story decks, any
+ * narrative-driven presentation where the words carry the room.
+ */
+import { buildScale } from '../typography.js';
+
+export default {
+  id: 'editorial-warm',
+  family: 'editorial',
+  description: 'Magazine-style: serif display + sans body, generous whitespace, hairline rules, sharp corners.',
+  defaults: {
+    palette:    'cream-charcoal',
+    spacing:    'airy',
+    shape:      'sharp',
+    background: 'noise',
+  },
+  typography: buildScale({
+    display: 'Georgia',
+    body:    'Calibri',
+    mono:    'Consolas',
+    // Sizes calibrated for "designed editorial" reading distance — the
+    // hero title fills the slide; body copy is comfortably readable from
+    // the back of a room. The previous scale was magazine-WEB; this is
+    // magazine-CONFERENCE.
+    sizes: {
+      display:  96,
+      title:    48,
+      subtitle: 26,
+      body:     20,
+      caption:  13,
+      stat:     220,
+      eyebrow:  14,
+    },
+    weights: { subtitle: 'normal' },
+    letterSpacing: { display: -3, title: -1.5, eyebrow: 3 },
+  }),
+  /** Archetype-specific tweaks. Each archetype reads `theme.archetypes[id]`
+   *  with falls back to {}. Used to shift defaults without forking the
+   *  whole archetype implementation. */
+  archetypes: {
+    hero: {
+      align: 'left',
+      eyebrowDivider: true,   // a tiny accent rule under the eyebrow
+      drop: 'small-caps',     // titles are mixed-case, no all-caps
+    },
+    statCallout: {
+      statColor: 'primary',
+      labelStyle: 'eyebrow',
+    },
+    quote: {
+      bigQuotes: true,        // huge serif quote marks
+      attributionRule: true,  // hairline rule above attribution
+    },
+    sectionHeader: {
+      ruleAbove: true,
+    },
+  },
+  /** Generated-background tuning: noise opacity, mesh saturation, etc. */
+  decoration: {
+    noiseOpacity: 12,         // 0-100, applied to subtle dots over bg
+    geometric: {
+      style: 'editorial',     // small accent rules, blocks, no blobs
+      density: 'sparse',
+    },
+    mesh: {
+      stops: 3,
+      saturation: 'muted',
+    },
+  },
+};

package/src/tools/office/pres/themes/index.js

@@ -0,0 +1,84 @@
+/**
+ * pres/themes — theme registry + resolver.
+ *
+ * The agent passes `theme: 'editorial-warm'` (or one of the other
+ * presets). This module turns that string + optional per-axis overrides
+ * (palette, spacing, shape, background) into a fully-resolved Theme
+ * object that downstream archetypes consume.
+ *
+ * Adding a theme:
+ *   1. Create `themes/<id>.js` exporting the shape these three follow
+ *   2. Register it below in THEMES
+ *   3. Pick a default palette + defaults for the other 4 axes
+ */
+import editorialWarm from './editorial-warm.js';
+import techBold from './tech-bold.js';
+import dataHeavy from './data-heavy.js';
+import monoKeynote from './mono-keynote.js';
+
+import { resolvePalette } from '../palettes.js';
+import { resolveSpacing } from '../grid.js';
+import { resolveShape } from '../shapes.js';
+
+const THEMES = {
+  'editorial-warm': editorialWarm,
+  'tech-bold':      techBold,
+  'data-heavy':     dataHeavy,
+  'mono-keynote':   monoKeynote,
+};
+
+/**
+ * List the available theme presets — used by the showcase verifier
+ * and by the agent-facing tool description.
+ */
+export function listThemes() {
+  return Object.values(THEMES).map(t => ({
+    id: t.id,
+    family: t.family,
+    description: t.description,
+    defaults: t.defaults,
+  }));
+}
+
+/**
+ * Resolve a theme spec into the full runtime object every archetype
+ * + background generator consumes.
+ *
+ * Inputs:
+ *   spec.theme       — 'editorial-warm' | 'tech-bold' | 'data-heavy'
+ *   spec.palette     — optional palette override
+ *   spec.spacing     — optional spacing override
+ *   spec.shape       — optional shape override
+ *   spec.background  — optional background-style override (theme-wide)
+ *
+ * The returned object holds:
+ *   theme            — the registered theme module (typography, archetypes config)
+ *   palette          — resolved palette object (6 semantic roles)
+ *   spacing          — resolved spacing metrics (margins, grid, body/header regions)
+ *   shape            — resolved shape tokens (corner radius, shadow)
+ *   bg               — resolved background style id (used by backgrounds/index.js)
+ *   decoration       — passthrough decoration config from the theme module
+ */
+export function resolveTheme(spec = {}) {
+  const id = spec.theme && THEMES[spec.theme] ? spec.theme : 'editorial-warm';
+  const theme = THEMES[id];
+
+  const palette = resolvePalette(spec.palette || theme.defaults.palette, theme.family);
+  const spacing = resolveSpacing(spec.spacing || theme.defaults.spacing);
+  const shape   = resolveShape(spec.shape   || theme.defaults.shape);
+  const bg      = spec.background || theme.defaults.background;
+
+  return {
+    theme,
+    palette,
+    spacing,
+    shape,
+    bg,
+    decoration: theme.decoration || {},
+    typography: theme.typography,
+    /** Convenience accessor: theme-specific archetype config. */
+    archetypeConfig(archetypeId) {
+      return (theme.archetypes && theme.archetypes[archetypeId]) || {};
+    },
+  };
+}

package/src/tools/office/pres/themes/mono-keynote.js

@@ -0,0 +1,57 @@
+/**
+ * Theme: mono-keynote
+ *
+ * Reference: Vercel Ship Week, Next.js Conf, Geist brand decks. Pure
+ * black or pure white canvas, single accent colour, geometric sans
+ * typography weight 500-600 at 120-180pt, code as hero content,
+ * rule-of-thirds composition with vast diagonal negative space.
+ *
+ * Reads as "engineering-confident" and "Swiss-minimal". The fourth
+ * theme in the system, sitting alongside editorial-warm (literary),
+ * tech-bold (SaaS-keynote), data-heavy (analyst).
+ */
+import { buildScale } from '../typography.js';
+
+export default {
+  id: 'mono-keynote',
+  family: 'mono',
+  description: 'Vercel / Geist energy: pure black/white, single accent, geometric sans, code as hero.',
+  defaults: {
+    palette:    'mono-light',
+    spacing:    'airy',
+    shape:      'sharp',
+    background: 'solid',
+  },
+  typography: buildScale({
+    display: 'Calibri',
+    body:    'Calibri',
+    mono:    'Consolas',
+    sizes: {
+      display:  140,        // Vercel-class hero type
+      title:    52,
+      subtitle: 24,
+      body:     18,
+      caption:  12,
+      stat:     240,
+      eyebrow:  11,
+    },
+    weights: { display: 'bold', title: 'bold', subtitle: 'normal' },
+    letterSpacing: { display: -3, title: -1, eyebrow: 4 },
+  }),
+  archetypes: {
+    hero:           { align: 'left' },
+    sectionHeader:  { ruleAbove: true },
+    statCallout:    { statColor: 'primary' },
+    bigStat:        {},
+    twoColChart:    { gridlinesOnChart: false },
+  },
+  decoration: {
+    // mono-keynote backgrounds are intentionally restrained — the
+    // typography carries the slide. Solid is the default; mesh + grid
+    // are available per-slide for moments where geometry adds value.
+    mesh:   { stops: 2, saturation: 'muted' },
+    grid:   { lineColor: 'subtle', lineOpacity: 4, spacing: 1.0 },
+    geometric: { style: 'tech', density: 'minimal' },
+    noiseOpacity: 0,
+  },
+};

package/src/tools/office/pres/themes/tech-bold.js

@@ -0,0 +1,77 @@
+/**
+ * Theme: tech-bold
+ *
+ * Reference: modern SaaS keynotes — Linear, Stripe Sessions, Vercel
+ * Ship Week. Dark default background, electric accents, round corners
+ * with soft shadows on cards, tight typographic rhythm, mesh-gradient
+ * backgrounds for hero / section slides. Reads as "future-forward"
+ * and "confident".
+ *
+ * Best fit: investor pitches, product launches, engineering keynotes,
+ * any deck that needs visual energy without sacrificing readability.
+ */
+import { buildScale } from '../typography.js';
+
+export default {
+  id: 'tech-bold',
+  family: 'tech',
+  description: 'Modern SaaS keynote: dark, electric, round corners + soft shadows, mesh-gradient hero slides.',
+  defaults: {
+    palette:    'electric-night',
+    spacing:    'cozy',
+    shape:      'round',
+    // `void` on the master = clean dark canvas (Apple-keynote rhythm).
+    // Archetypes like bentoGrid can per-slide opt into `mesh` for the
+    // Stripe-style 4-corner gradient. Most slides on void; mesh used as
+    // a deliberate moment.
+    background: 'void',
+  },
+  typography: buildScale({
+    display: 'Calibri',
+    body:    'Calibri',
+    mono:    'Consolas',
+    // Tech-bold runs the biggest type — the hero title is meant to
+    // command a 20-foot screen. Body copy stays generous so it never
+    // feels like a wireframe.
+    sizes: {
+      display:  120,
+      title:    56,
+      subtitle: 30,
+      body:     22,
+      caption:  14,
+      stat:     280,
+      eyebrow:  14,
+    },
+    weights: { display: 'bold', title: 'bold', subtitle: 'normal' },
+    letterSpacing: { display: -3, title: -1.5, eyebrow: 2 },
+  }),
+  archetypes: {
+    hero: {
+      align: 'left',
+      eyebrowOnAccent: true,    // eyebrow uses accent colour
+    },
+    statCallout: {
+      statColor: 'primary',
+      cardBackground: 'surface', // wrap the stat in a surface card with glow
+    },
+    quote: {
+      bigQuotes: false,
+      attributionStyle: 'inline-rule',
+    },
+    twoColChart: {
+      chartElevated: true,       // chart sits in a "card" with shadow
+    },
+  },
+  decoration: {
+    mesh: {
+      stops: 4,
+      saturation: 'vivid',
+      blur: 'high',
+    },
+    geometric: {
+      style: 'tech',             // floating blob + diagonal line accents
+      density: 'medium',
+    },
+    noiseOpacity: 0,             // no grain — mesh is the texture
+  },
+};

package/src/tools/office/pres/typography.js

@@ -0,0 +1,113 @@
+/**
+ * pres/typography — type scales per theme family.
+ *
+ * Six named roles every theme defines, so archetypes can ask for
+ * "display" or "caption" without thinking about points. The agent
+ * never picks font size or font face — only the theme does.
+ *
+ * Font choices are deliberately conservative: each is either a
+ * Windows/Mac default or has a sensible substitution. The user's
+ * PowerPoint will best-effort substitute if missing, but starting
+ * from defaults means the deck looks the same to ~95% of viewers.
+ */
+
+/** Typography scale shape. */
+export const ROLES = ['display', 'title', 'subtitle', 'body', 'caption', 'mono'];
+
+/**
+ * Build a typography scale from a theme's font pair + base sizes.
+ * Lets each theme override only what differs from the family default.
+ *
+ *   buildScale({
+ *     display: 'Georgia',
+ *     body:    'Calibri',
+ *     mono:    'Consolas',
+ *     sizes: { display: 60, title: 36, subtitle: 18, body: 14, caption: 11, mono: 12 },
+ *   })
+ */
+export function buildScale({
+  display,
+  body,
+  mono,
+  sizes = {},
+  weights = {},
+  letterSpacing = {},
+  textColor = null,
+}) {
+  const s = {
+    display:  sizes.display  ?? 56,
+    title:    sizes.title    ?? 34,
+    subtitle: sizes.subtitle ?? 18,
+    body:     sizes.body     ?? 14,
+    caption:  sizes.caption  ?? 11,
+    mono:     sizes.mono     ?? 12,
+  };
+  return {
+    display: {
+      fontFace: display,
+      fontSize: s.display,
+      bold: weights.display === 'bold' || weights.display === undefined,
+      charSpacing: letterSpacing.display ?? -1, // tight tracking on huge text
+    },
+    title: {
+      fontFace: display,
+      fontSize: s.title,
+      bold: weights.title !== 'normal',
+      charSpacing: letterSpacing.title ?? 0,
+    },
+    subtitle: {
+      fontFace: body,
+      fontSize: s.subtitle,
+      bold: weights.subtitle === 'bold',
+      charSpacing: letterSpacing.subtitle ?? 0,
+    },
+    body: {
+      fontFace: body,
+      fontSize: s.body,
+      charSpacing: letterSpacing.body ?? 0,
+    },
+    caption: {
+      fontFace: body,
+      fontSize: s.caption,
+      charSpacing: letterSpacing.caption ?? 0.5, // a bit looser for small text
+    },
+    mono: {
+      fontFace: mono,
+      fontSize: s.mono,
+    },
+    /** Big-stat numeric override that data-heavy themes can opt into. */
+    stat: {
+      fontFace: display,
+      fontSize: sizes.stat ?? 96,
+      bold: true,
+      charSpacing: -2,
+    },
+    /** Tiny pill / eyebrow label sitting above titles. */
+    eyebrow: {
+      fontFace: body,
+      fontSize: sizes.eyebrow ?? 10,
+      bold: true,
+      charSpacing: 2,
+    },
+    /** Optional default text colour the archetype falls back to when
+     *  the palette doesn't dictate. */
+    defaultColor: textColor,
+  };
+}
+
+/**
+ * Merge a role's base style with overrides (colour, alignment, etc.)
+ * the archetype passes through. Used in every archetype so the agent
+ * never sets font/size directly.
+ */
+export function textStyle(scale, role, overrides = {}) {
+  const base = scale[role] || scale.body;
+  return {
+    fontFace: base.fontFace,
+    fontSize: base.fontSize,
+    bold: base.bold,
+    italic: base.italic,
+    charSpacing: base.charSpacing,
+    ...overrides,
+  };
+}