@classic-homes/slides 0.5.12 → 0.7.0

package/dist/{chunk-42YDHMNB.js → chunk-ORNJ4CTQ.js}

@@ -6,7 +6,7 @@ import {
   LAYOUT_CATEGORIES,
   baseSlide,
   getLayout
-} from "./chunk-25NZMEQG.js";
+} from "./chunk-HI5ZCAHO.js";
 
 // src/catalog.ts
 import { z } from "zod";
@@ -89,9 +89,22 @@ set colours, fonts or sizes directly, which is what keeps every deck on-brand.
 - **Wrap-up:** \`qr\` (send people somewhere), \`contacts\`, closing \`statement\`.
 
 ## Charts
-\`chart.labels\` are the categories; each series has one value per label. Pie, donut, funnel and
-gauge use the first series; gauge needs \`max\`; scatter uses two series as x and y. Use
-\`highlight\` to emphasise one category and \`format\`/\`unit\` instead of typing symbols into numbers.
+\`chart.labels\` are the categories; each series has one value per label. Use \`highlight\` to
+emphasise one category and \`format\`/\`unit\` instead of typing symbols into numbers.
+- **Compare:** \`column\`/\`bar\`; \`dumbbell\` (2+ series as dots per row, e.g. last year vs this
+  year); \`bullet\` (series 1 actual, series 2 target; \`max\` sets the track).
+- **Part of whole:** \`stacked-*\` (absolute), \`percent-column\`/\`percent-bar\` (each row = 100%),
+  \`pie\`/\`donut\` (\u2264 7 slices), \`treemap\` (many categories).
+- **Change:** \`line\`/\`area\`; \`combo\` (series 1 bars, the rest lines; set a series' \`as\` to
+  override and \`axis: secondary\` + \`secondaryFormat\` for a second scale, e.g. closings and average
+  price); \`waterfall\` (series 1 is signed changes; list running-total rows in \`totals\`).
+- **Single value:** \`gauge\` (one value, needs \`max\`); \`ring\` (up to 4 progress rings, one per label;
+  \`max\`, or \`format: percent\` for 100); \`pictogram\` (house icons per row; \`perIcon\` sets the step).
+- **Grid & flow:** \`heatmap\` (labels are rows, series names are columns); \`sankey\` (labels are
+  sources, series names are destinations, each cell a flow; a destination that is also a label chains
+  stages; no loops).
+- **Other:** \`funnel\` (drop-off, first series), \`scatter\` (two series as x and y), \`radar\`.
+Pie, donut, funnel, gauge, ring, treemap, waterfall and pictogram read the first series only.
 
 ## Video & embeds
 They need internet while presenting. Offline, in print and in PDF they show a poster (or
@@ -130,4 +143,4 @@ export {
   deckJsonSchema,
   AUTHORING_GUIDE
 };
-//# sourceMappingURL=chunk-42YDHMNB.js.map
+//# sourceMappingURL=chunk-ORNJ4CTQ.js.map

package/dist/{chunk-42YDHMNB.js.map → chunk-ORNJ4CTQ.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/catalog.ts"],"sourcesContent":["import { z } from 'zod';\nimport { ignoreOverride, zodToJsonSchema } from 'zod-to-json-schema';\nimport {\n  LAYOUT_CATEGORIES,\n  LAYOUTS,\n  getLayout,\n  type LayoutCategory,\n  type LayoutName,\n} from './layouts/index.js';\nimport { baseSlide, Image, Item } from './schema/common.js';\nimport { DeckSchema } from './schema/deck.js';\n\n/**\n * Item and Image accept a bare string as shorthand (\"Q4 best\" → { text }, \"a.jpg\" → { src }).\n * zod-to-json-schema only sees the object behind the preprocess, so advertise both forms\n * or agents reading the schema think the shorthand in our own examples is invalid.\n */\nconst SHORTHAND = new Map<unknown, string>([\n  [(Item._def as { schema: unknown }).schema, 'Shorthand for { text }.'],\n  [(Image._def as { schema: unknown }).schema, 'Shorthand for { src }.'],\n]);\n\nfunction toJsonSchema(schema: z.ZodTypeAny, name?: string) {\n  return zodToJsonSchema(schema, {\n    ...(name ? { name } : {}),\n    $refStrategy: 'none',\n    override: (def) => {\n      const inner = (def as { schema?: unknown }).schema;\n      const isEffects = (def as { typeName?: string }).typeName === 'ZodEffects';\n      const hint = isEffects ? SHORTHAND.get(inner) : undefined;\n      if (!hint) return ignoreOverride;\n      const object = zodToJsonSchema(inner as z.ZodTypeAny, {\n        $refStrategy: 'none',\n      }) as Record<string, unknown>;\n      delete object.$schema;\n      return {\n        anyOf: [{ type: 'string', description: hint }, object],\n        ...((def as { description?: string }).description\n          ? { description: (def as { description?: string }).description }\n          : {}),\n      };\n    },\n  });\n}\n\nexport interface LayoutSummary {\n  name: string;\n  category: LayoutCategory;\n  description: string;\n  whenToUse: string;\n}\n\nexport function listLayouts(): LayoutSummary[] {\n  return LAYOUTS.map((l) => ({\n    name: l.name,\n    category: LAYOUT_CATEGORIES[l.name as LayoutName],\n    description: l.description,\n    whenToUse: l.whenToUse,\n  }));\n}\n\n/** Full description of one layout: fields as JSON Schema plus a working example. */\nexport function describeLayout(name: string) {\n  const layout = getLayout(name);\n  if (!layout) return undefined;\n  const schema = z.object({ layout: z.literal(layout.name), ...layout.shape, ...baseSlide });\n  return {\n    name: layout.name,\n    description: layout.description,\n    whenToUse: layout.whenToUse,\n    defaults: layout.defaults ?? {},\n    schema: toJsonSchema(schema),\n    example: layout.example,\n  };\n}\n\n/** JSON Schema for a whole deck (editor tooling, `$schema` in deck files). */\nexport function deckJsonSchema() {\n  return toJsonSchema(DeckSchema, 'ClassicDeck');\n}\n\n/** Authoring guidance shared by the CLI, MCP server and docs. */\nexport const AUTHORING_GUIDE = `# Writing a Classic Homes deck\n\nA deck is a YAML (or JSON) file: deck-level fields plus a list of slides. Each slide\npicks a **layout** and fills its fields. Layouts own all styling — there is no way to\nset colours, fonts or sizes directly, which is what keeps every deck on-brand.\n\n## Principles\n- **One idea per slide.** The headline states the point. Detail goes in \\`notes\\`.\n- **Short copy.** Titles under ~70 characters, bullets a few words, at most 6 bullets.\n  \\`validate\\` warns when a slide gets crowded — split it rather than shrinking text.\n- **Speaker notes on every content slide.** Presenters press N (or P for presenter view).\n- **Real photos over decoration.** Every image needs \\`alt\\` text.\n- **Tracks** colour the accent: \\`value\\` (red, default) for the homeowner/value story,\n  \\`build\\` (teal) for construction/process, \\`neutral\\` (navy) for framing slides.\n- **Backgrounds**: \\`paper\\` (default) for content; solid \\`navy\\`/\\`red\\`/\\`teal\\`/\\`plum\\`/\\`grey\\`/\\`stone\\`\n  for dividers. \\`backgroundImage\\` + \\`overlay\\` puts a photo behind title/section/statement slides.\n\n## Picking a layout\n- **Numbers:** \\`stats\\` (2–6 headline figures, optional trend + sparkline), \\`chart\\` (a real chart —\n  put the takeaway in the title), \\`table\\` (exact figures people compare).\n- **Processes & structure:** \\`flow\\` (ordered steps with arrows), \\`timeline\\` (dated milestones, phases),\n  \\`cycle\\` (things that repeat), \\`hierarchy\\` (org chart / tree), \\`matrix\\` (2×2), \\`tiers\\`\n  (funnel or pyramid), \\`walkthrough\\` (photo per stage), \\`journey\\` (deck agenda).\n- **Media:** \\`split\\` (text + photos), \\`photos\\`, \\`image\\` (with numbered \\`hotspots\\` for floor plans\n  and site maps), \\`compare\\` (before/after slider), \\`video\\` (YouTube/Vimeo), \\`embed\\` (any https page:\n  maps, dashboards, 3D tours, forms).\n- **Words:** \\`statement\\`, \\`bullets\\`, \\`cards\\`, \\`comparison\\`, \\`quote\\`.\n- **Wrap-up:** \\`qr\\` (send people somewhere), \\`contacts\\`, closing \\`statement\\`.\n\n## Charts\n\\`chart.labels\\` are the categories; each series has one value per label. Pie, donut, funnel and\ngauge use the first series; gauge needs \\`max\\`; scatter uses two series as x and y. Use\n\\`highlight\\` to emphasise one category and \\`format\\`/\\`unit\\` instead of typing symbols into numbers.\n\n## Video & embeds\nThey need internet while presenting. Offline, in print and in PDF they show a poster (or\n\\`fallback\\` screenshot) with a QR code. Some sites refuse to be framed — the \"Open ↗\" link\nalways works; add a \\`fallback\\` image for anything critical.\n\n## Brand\n\\`brand.profile\\` picks who the deck speaks for (default \\`classic-homes\\`). You may override\n\\`name\\`, \\`tagline\\`, \\`logo\\`, \\`logoOnDark\\`, \\`favicon\\` and \\`footer\\`; colours come from the profile.\n\\`settings\\` controls slide numbers, logo placement, a confidential label and kiosk auto-advance.\n\n## Presenting\nArrow keys / Space advance (and step through \\`build: true\\` reveals). N notes · P presenter window\n(current + next slide, notes, timer) · O overview · F fullscreen · \\`?kiosk=15\\` on the URL loops\nunattended. \\`hidden: true\\` skips a slide without deleting it.\n\n## Inline text\n\\`**bold**\\`, \\`*highlight*\\` (accent colour), \\`\\\\\\`code\\\\\\`\\`, \\`[label](https://…)\\`. No HTML.\n\n## Journey decks\nSet \\`journey.steps\\` at deck level to get a numbered agenda. Then:\n- a \\`journey\\` slide shows the full map,\n- \\`step: 3\\` on any slide draws the vertical STEP rail,\n- \\`showJourney: true\\` adds the compact \"you are here\" strip (great on \\`section\\` slides).\n\n## Typical shape\n1. \\`title\\`\n2. \\`statement\\` or \\`journey\\` (why we're here / the agenda)\n3. per part: \\`section\\` → 2–5 content slides\n4. \\`qr\\` (where to go next) → \\`contacts\\` → closing \\`statement\\`\n`;\n"],"mappings":";;;;;;;;;;;AAAA,SAAS,SAAS;AAClB,SAAS,gBAAgB,uBAAuB;AAgBhD,IAAM,YAAY,oBAAI,IAAqB;AAAA,EACzC,CAAE,KAAK,KAA6B,QAAQ,yBAAyB;AAAA,EACrE,CAAE,MAAM,KAA6B,QAAQ,wBAAwB;AACvE,CAAC;AAED,SAAS,aAAa,QAAsB,MAAe;AACzD,SAAO,gBAAgB,QAAQ;AAAA,IAC7B,GAAI,OAAO,EAAE,KAAK,IAAI,CAAC;AAAA,IACvB,cAAc;AAAA,IACd,UAAU,CAAC,QAAQ;AACjB,YAAM,QAAS,IAA6B;AAC5C,YAAM,YAAa,IAA8B,aAAa;AAC9D,YAAM,OAAO,YAAY,UAAU,IAAI,KAAK,IAAI;AAChD,UAAI,CAAC,KAAM,QAAO;AAClB,YAAM,SAAS,gBAAgB,OAAuB;AAAA,QACpD,cAAc;AAAA,MAChB,CAAC;AACD,aAAO,OAAO;AACd,aAAO;AAAA,QACL,OAAO,CAAC,EAAE,MAAM,UAAU,aAAa,KAAK,GAAG,MAAM;AAAA,QACrD,GAAK,IAAiC,cAClC,EAAE,aAAc,IAAiC,YAAY,IAC7D,CAAC;AAAA,MACP;AAAA,IACF;AAAA,EACF,CAAC;AACH;AASO,SAAS,cAA+B;AAC7C,SAAO,QAAQ,IAAI,CAAC,OAAO;AAAA,IACzB,MAAM,EAAE;AAAA,IACR,UAAU,kBAAkB,EAAE,IAAkB;AAAA,IAChD,aAAa,EAAE;AAAA,IACf,WAAW,EAAE;AAAA,EACf,EAAE;AACJ;AAGO,SAAS,eAAe,MAAc;AAC3C,QAAM,SAAS,UAAU,IAAI;AAC7B,MAAI,CAAC,OAAQ,QAAO;AACpB,QAAM,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,OAAO,IAAI,GAAG,GAAG,OAAO,OAAO,GAAG,UAAU,CAAC;AACzF,SAAO;AAAA,IACL,MAAM,OAAO;AAAA,IACb,aAAa,OAAO;AAAA,IACpB,WAAW,OAAO;AAAA,IAClB,UAAU,OAAO,YAAY,CAAC;AAAA,IAC9B,QAAQ,aAAa,MAAM;AAAA,IAC3B,SAAS,OAAO;AAAA,EAClB;AACF;AAGO,SAAS,iBAAiB;AAC/B,SAAO,aAAa,YAAY,aAAa;AAC/C;AAGO,IAAM,kBAAkB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;","names":[]}
+{"version":3,"sources":["../src/catalog.ts"],"sourcesContent":["import { z } from 'zod';\nimport { ignoreOverride, zodToJsonSchema } from 'zod-to-json-schema';\nimport {\n  LAYOUT_CATEGORIES,\n  LAYOUTS,\n  getLayout,\n  type LayoutCategory,\n  type LayoutName,\n} from './layouts/index.js';\nimport { baseSlide, Image, Item } from './schema/common.js';\nimport { DeckSchema } from './schema/deck.js';\n\n/**\n * Item and Image accept a bare string as shorthand (\"Q4 best\" → { text }, \"a.jpg\" → { src }).\n * zod-to-json-schema only sees the object behind the preprocess, so advertise both forms\n * or agents reading the schema think the shorthand in our own examples is invalid.\n */\nconst SHORTHAND = new Map<unknown, string>([\n  [(Item._def as { schema: unknown }).schema, 'Shorthand for { text }.'],\n  [(Image._def as { schema: unknown }).schema, 'Shorthand for { src }.'],\n]);\n\nfunction toJsonSchema(schema: z.ZodTypeAny, name?: string) {\n  return zodToJsonSchema(schema, {\n    ...(name ? { name } : {}),\n    $refStrategy: 'none',\n    override: (def) => {\n      const inner = (def as { schema?: unknown }).schema;\n      const isEffects = (def as { typeName?: string }).typeName === 'ZodEffects';\n      const hint = isEffects ? SHORTHAND.get(inner) : undefined;\n      if (!hint) return ignoreOverride;\n      const object = zodToJsonSchema(inner as z.ZodTypeAny, {\n        $refStrategy: 'none',\n      }) as Record<string, unknown>;\n      delete object.$schema;\n      return {\n        anyOf: [{ type: 'string', description: hint }, object],\n        ...((def as { description?: string }).description\n          ? { description: (def as { description?: string }).description }\n          : {}),\n      };\n    },\n  });\n}\n\nexport interface LayoutSummary {\n  name: string;\n  category: LayoutCategory;\n  description: string;\n  whenToUse: string;\n}\n\nexport function listLayouts(): LayoutSummary[] {\n  return LAYOUTS.map((l) => ({\n    name: l.name,\n    category: LAYOUT_CATEGORIES[l.name as LayoutName],\n    description: l.description,\n    whenToUse: l.whenToUse,\n  }));\n}\n\n/** Full description of one layout: fields as JSON Schema plus a working example. */\nexport function describeLayout(name: string) {\n  const layout = getLayout(name);\n  if (!layout) return undefined;\n  const schema = z.object({ layout: z.literal(layout.name), ...layout.shape, ...baseSlide });\n  return {\n    name: layout.name,\n    description: layout.description,\n    whenToUse: layout.whenToUse,\n    defaults: layout.defaults ?? {},\n    schema: toJsonSchema(schema),\n    example: layout.example,\n  };\n}\n\n/** JSON Schema for a whole deck (editor tooling, `$schema` in deck files). */\nexport function deckJsonSchema() {\n  return toJsonSchema(DeckSchema, 'ClassicDeck');\n}\n\n/** Authoring guidance shared by the CLI, MCP server and docs. */\nexport const AUTHORING_GUIDE = `# Writing a Classic Homes deck\n\nA deck is a YAML (or JSON) file: deck-level fields plus a list of slides. Each slide\npicks a **layout** and fills its fields. Layouts own all styling — there is no way to\nset colours, fonts or sizes directly, which is what keeps every deck on-brand.\n\n## Principles\n- **One idea per slide.** The headline states the point. Detail goes in \\`notes\\`.\n- **Short copy.** Titles under ~70 characters, bullets a few words, at most 6 bullets.\n  \\`validate\\` warns when a slide gets crowded — split it rather than shrinking text.\n- **Speaker notes on every content slide.** Presenters press N (or P for presenter view).\n- **Real photos over decoration.** Every image needs \\`alt\\` text.\n- **Tracks** colour the accent: \\`value\\` (red, default) for the homeowner/value story,\n  \\`build\\` (teal) for construction/process, \\`neutral\\` (navy) for framing slides.\n- **Backgrounds**: \\`paper\\` (default) for content; solid \\`navy\\`/\\`red\\`/\\`teal\\`/\\`plum\\`/\\`grey\\`/\\`stone\\`\n  for dividers. \\`backgroundImage\\` + \\`overlay\\` puts a photo behind title/section/statement slides.\n\n## Picking a layout\n- **Numbers:** \\`stats\\` (2–6 headline figures, optional trend + sparkline), \\`chart\\` (a real chart —\n  put the takeaway in the title), \\`table\\` (exact figures people compare).\n- **Processes & structure:** \\`flow\\` (ordered steps with arrows), \\`timeline\\` (dated milestones, phases),\n  \\`cycle\\` (things that repeat), \\`hierarchy\\` (org chart / tree), \\`matrix\\` (2×2), \\`tiers\\`\n  (funnel or pyramid), \\`walkthrough\\` (photo per stage), \\`journey\\` (deck agenda).\n- **Media:** \\`split\\` (text + photos), \\`photos\\`, \\`image\\` (with numbered \\`hotspots\\` for floor plans\n  and site maps), \\`compare\\` (before/after slider), \\`video\\` (YouTube/Vimeo), \\`embed\\` (any https page:\n  maps, dashboards, 3D tours, forms).\n- **Words:** \\`statement\\`, \\`bullets\\`, \\`cards\\`, \\`comparison\\`, \\`quote\\`.\n- **Wrap-up:** \\`qr\\` (send people somewhere), \\`contacts\\`, closing \\`statement\\`.\n\n## Charts\n\\`chart.labels\\` are the categories; each series has one value per label. Use \\`highlight\\` to\nemphasise one category and \\`format\\`/\\`unit\\` instead of typing symbols into numbers.\n- **Compare:** \\`column\\`/\\`bar\\`; \\`dumbbell\\` (2+ series as dots per row, e.g. last year vs this\n  year); \\`bullet\\` (series 1 actual, series 2 target; \\`max\\` sets the track).\n- **Part of whole:** \\`stacked-*\\` (absolute), \\`percent-column\\`/\\`percent-bar\\` (each row = 100%),\n  \\`pie\\`/\\`donut\\` (≤ 7 slices), \\`treemap\\` (many categories).\n- **Change:** \\`line\\`/\\`area\\`; \\`combo\\` (series 1 bars, the rest lines; set a series' \\`as\\` to\n  override and \\`axis: secondary\\` + \\`secondaryFormat\\` for a second scale, e.g. closings and average\n  price); \\`waterfall\\` (series 1 is signed changes; list running-total rows in \\`totals\\`).\n- **Single value:** \\`gauge\\` (one value, needs \\`max\\`); \\`ring\\` (up to 4 progress rings, one per label;\n  \\`max\\`, or \\`format: percent\\` for 100); \\`pictogram\\` (house icons per row; \\`perIcon\\` sets the step).\n- **Grid & flow:** \\`heatmap\\` (labels are rows, series names are columns); \\`sankey\\` (labels are\n  sources, series names are destinations, each cell a flow; a destination that is also a label chains\n  stages; no loops).\n- **Other:** \\`funnel\\` (drop-off, first series), \\`scatter\\` (two series as x and y), \\`radar\\`.\nPie, donut, funnel, gauge, ring, treemap, waterfall and pictogram read the first series only.\n\n## Video & embeds\nThey need internet while presenting. Offline, in print and in PDF they show a poster (or\n\\`fallback\\` screenshot) with a QR code. Some sites refuse to be framed — the \"Open ↗\" link\nalways works; add a \\`fallback\\` image for anything critical.\n\n## Brand\n\\`brand.profile\\` picks who the deck speaks for (default \\`classic-homes\\`). You may override\n\\`name\\`, \\`tagline\\`, \\`logo\\`, \\`logoOnDark\\`, \\`favicon\\` and \\`footer\\`; colours come from the profile.\n\\`settings\\` controls slide numbers, logo placement, a confidential label and kiosk auto-advance.\n\n## Presenting\nArrow keys / Space advance (and step through \\`build: true\\` reveals). N notes · P presenter window\n(current + next slide, notes, timer) · O overview · F fullscreen · \\`?kiosk=15\\` on the URL loops\nunattended. \\`hidden: true\\` skips a slide without deleting it.\n\n## Inline text\n\\`**bold**\\`, \\`*highlight*\\` (accent colour), \\`\\\\\\`code\\\\\\`\\`, \\`[label](https://…)\\`. No HTML.\n\n## Journey decks\nSet \\`journey.steps\\` at deck level to get a numbered agenda. Then:\n- a \\`journey\\` slide shows the full map,\n- \\`step: 3\\` on any slide draws the vertical STEP rail,\n- \\`showJourney: true\\` adds the compact \"you are here\" strip (great on \\`section\\` slides).\n\n## Typical shape\n1. \\`title\\`\n2. \\`statement\\` or \\`journey\\` (why we're here / the agenda)\n3. per part: \\`section\\` → 2–5 content slides\n4. \\`qr\\` (where to go next) → \\`contacts\\` → closing \\`statement\\`\n`;\n"],"mappings":";;;;;;;;;;;AAAA,SAAS,SAAS;AAClB,SAAS,gBAAgB,uBAAuB;AAgBhD,IAAM,YAAY,oBAAI,IAAqB;AAAA,EACzC,CAAE,KAAK,KAA6B,QAAQ,yBAAyB;AAAA,EACrE,CAAE,MAAM,KAA6B,QAAQ,wBAAwB;AACvE,CAAC;AAED,SAAS,aAAa,QAAsB,MAAe;AACzD,SAAO,gBAAgB,QAAQ;AAAA,IAC7B,GAAI,OAAO,EAAE,KAAK,IAAI,CAAC;AAAA,IACvB,cAAc;AAAA,IACd,UAAU,CAAC,QAAQ;AACjB,YAAM,QAAS,IAA6B;AAC5C,YAAM,YAAa,IAA8B,aAAa;AAC9D,YAAM,OAAO,YAAY,UAAU,IAAI,KAAK,IAAI;AAChD,UAAI,CAAC,KAAM,QAAO;AAClB,YAAM,SAAS,gBAAgB,OAAuB;AAAA,QACpD,cAAc;AAAA,MAChB,CAAC;AACD,aAAO,OAAO;AACd,aAAO;AAAA,QACL,OAAO,CAAC,EAAE,MAAM,UAAU,aAAa,KAAK,GAAG,MAAM;AAAA,QACrD,GAAK,IAAiC,cAClC,EAAE,aAAc,IAAiC,YAAY,IAC7D,CAAC;AAAA,MACP;AAAA,IACF;AAAA,EACF,CAAC;AACH;AASO,SAAS,cAA+B;AAC7C,SAAO,QAAQ,IAAI,CAAC,OAAO;AAAA,IACzB,MAAM,EAAE;AAAA,IACR,UAAU,kBAAkB,EAAE,IAAkB;AAAA,IAChD,aAAa,EAAE;AAAA,IACf,WAAW,EAAE;AAAA,EACf,EAAE;AACJ;AAGO,SAAS,eAAe,MAAc;AAC3C,QAAM,SAAS,UAAU,IAAI;AAC7B,MAAI,CAAC,OAAQ,QAAO;AACpB,QAAM,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,OAAO,IAAI,GAAG,GAAG,OAAO,OAAO,GAAG,UAAU,CAAC;AACzF,SAAO;AAAA,IACL,MAAM,OAAO;AAAA,IACb,aAAa,OAAO;AAAA,IACpB,WAAW,OAAO;AAAA,IAClB,UAAU,OAAO,YAAY,CAAC;AAAA,IAC9B,QAAQ,aAAa,MAAM;AAAA,IAC3B,SAAS,OAAO;AAAA,EAClB;AACF;AAGO,SAAS,iBAAiB;AAC/B,SAAO,aAAa,YAAY,aAAa;AAC/C;AAGO,IAAM,kBAAkB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;","names":[]}

package/dist/{chunk-6CYZI27I.js → chunk-UKRX7A2V.js}

@@ -3,7 +3,7 @@ import {
   parseDeckSource,
   renderDeck,
   stringifyDeck
-} from "./chunk-25NZMEQG.js";
+} from "./chunk-HI5ZCAHO.js";
 
 // src/node/index.ts
 import { readFile, stat, writeFile } from "fs/promises";
@@ -181,4 +181,4 @@ export {
   buildDeckFile,
   exportDeckFile
 };
-//# sourceMappingURL=chunk-6CYZI27I.js.map
+//# sourceMappingURL=chunk-UKRX7A2V.js.map

package/dist/cli.js

@@ -4,19 +4,19 @@ import {
   deckJsonSchema,
   describeLayout,
   listLayouts
-} from "./chunk-42YDHMNB.js";
+} from "./chunk-ORNJ4CTQ.js";
 import {
   buildDeckFile,
   exportDeckFile,
   fileImageResolver,
   loadDeckFile
-} from "./chunk-6CYZI27I.js";
+} from "./chunk-UKRX7A2V.js";
 import {
   DeckError,
   formatIssues,
   renderDeck,
   validateDeck
-} from "./chunk-25NZMEQG.js";
+} from "./chunk-HI5ZCAHO.js";
 
 // src/node/cli.ts
 import { watch } from "fs";
@@ -130,7 +130,7 @@ ${"".padEnd(12)} Use for: ${l.whenToUse}
     case "mcp": {
       let mcp;
       try {
-        mcp = await import("./mcp-P3CPIO3H.js");
+        mcp = await import("./mcp-MG2E7J3I.js");
       } catch (e) {
         if (e.code === "ERR_MODULE_NOT_FOUND") {
           throw new Error(

package/dist/{echarts-render-2QVSBZ6V.js → echarts-render-GDCT5QAF.js}

@@ -4,25 +4,39 @@ import {
   BarChart,
   FunnelChart,
   GaugeChart,
+  HeatmapChart,
   LineChart,
+  PictorialBarChart,
   PieChart,
   RadarChart,
-  ScatterChart
+  SankeyChart,
+  ScatterChart,
+  TreemapChart
 } from "echarts/charts";
-import { GridComponent, LegendComponent, RadarComponent } from "echarts/components";
+import {
+  GridComponent,
+  LegendComponent,
+  RadarComponent,
+  VisualMapContinuousComponent
+} from "echarts/components";
 import * as echarts from "echarts/core";
 import { SVGRenderer } from "echarts/renderers";
 echarts.use([
   BarChart,
   FunnelChart,
   GaugeChart,
+  HeatmapChart,
   LineChart,
+  PictorialBarChart,
   PieChart,
   RadarChart,
+  SankeyChart,
   ScatterChart,
+  TreemapChart,
   GridComponent,
   LegendComponent,
   RadarComponent,
+  VisualMapContinuousComponent,
   SVGRenderer
 ]);
 echarts.registerTheme("classic-slides", lightTheme);
@@ -47,4 +61,4 @@ function createRenderer() {
 export {
   createRenderer
 };
-//# sourceMappingURL=echarts-render-2QVSBZ6V.js.map
+//# sourceMappingURL=echarts-render-GDCT5QAF.js.map

package/dist/echarts-render-GDCT5QAF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/echarts-render.ts"],"sourcesContent":["/** ECharts server-side SVG renderer. Loaded lazily by charts.ts. */\nimport { lightTheme } from '@classic-homes/charts-core/theme';\nimport {\n  BarChart,\n  FunnelChart,\n  GaugeChart,\n  HeatmapChart,\n  LineChart,\n  PictorialBarChart,\n  PieChart,\n  RadarChart,\n  SankeyChart,\n  ScatterChart,\n  TreemapChart,\n} from 'echarts/charts';\nimport {\n  GridComponent,\n  LegendComponent,\n  RadarComponent,\n  VisualMapContinuousComponent,\n} from 'echarts/components';\nimport * as echarts from 'echarts/core';\nimport { SVGRenderer } from 'echarts/renderers';\nimport type { ChartRenderer } from './charts.js';\n\necharts.use([\n  BarChart,\n  FunnelChart,\n  GaugeChart,\n  HeatmapChart,\n  LineChart,\n  PictorialBarChart,\n  PieChart,\n  RadarChart,\n  SankeyChart,\n  ScatterChart,\n  TreemapChart,\n  GridComponent,\n  LegendComponent,\n  RadarComponent,\n  VisualMapContinuousComponent,\n  SVGRenderer,\n]);\necharts.registerTheme('classic-slides', lightTheme as unknown as object);\n\nexport function createRenderer(): ChartRenderer {\n  return {\n    render(option, width, height) {\n      const chart = echarts.init(null, 'classic-slides', {\n        renderer: 'svg',\n        ssr: true,\n        width,\n        height,\n      });\n      try {\n        chart.setOption(option);\n        return chart.renderToSVGString();\n      } finally {\n        chart.dispose();\n      }\n    },\n  };\n}\n"],"mappings":";AACA,SAAS,kBAAkB;AAC3B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,YAAY,aAAa;AACzB,SAAS,mBAAmB;AAGpB,YAAI;AAAA,EACV;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AACO,sBAAc,kBAAkB,UAA+B;AAEhE,SAAS,iBAAgC;AAC9C,SAAO;AAAA,IACL,OAAO,QAAQ,OAAO,QAAQ;AAC5B,YAAM,QAAgB,aAAK,MAAM,kBAAkB;AAAA,QACjD,UAAU;AAAA,QACV,KAAK;AAAA,QACL;AAAA,QACA;AAAA,MACF,CAAC;AACD,UAAI;AACF,cAAM,UAAU,MAAM;AACtB,eAAO,MAAM,kBAAkB;AAAA,MACjC,UAAE;AACA,cAAM,QAAQ;AAAA,MAChB;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/dist/{images-8N30SsCW.d.ts → images-rkJZtnjl.d.ts}

@@ -491,13 +491,13 @@ declare const DeckSettingsSchema: z.ZodObject<{
     autoAdvance: z.ZodOptional<z.ZodNumber>;
     loop: z.ZodDefault<z.ZodBoolean>;
 }, "strict", z.ZodTypeAny, {
-    logo: "title" | "all" | "none";
+    logo: "all" | "title" | "none";
     slideNumbers: boolean;
     loop: boolean;
     confidential?: string | undefined;
     autoAdvance?: number | undefined;
 }, {
-    logo?: "title" | "all" | "none" | undefined;
+    logo?: "all" | "title" | "none" | undefined;
     slideNumbers?: boolean | undefined;
     confidential?: string | undefined;
     autoAdvance?: number | undefined;
@@ -598,6 +598,35 @@ interface RenderResult {
 /** Collects every image src in the deck (any object with a string `src`). */
 declare function collectImageSources(value: unknown, out?: Set<string>): Set<string>;
 declare function renderDeck(input: unknown, options?: RenderOptions): Promise<RenderResult>;
+interface SpeakerNotesOptions {
+    /** Brand profiles available to `deck.brand.profile` (needed to validate decks that name one). */
+    brands?: BrandProfile[];
+    /** List slides marked `hidden` too. Default false, matching a presentation. */
+    includeHidden?: boolean;
+}
+/** One presented slide's speaker notes. */
+interface SpeakerNote {
+    /** 1-based slide number as presented (a walkthrough counts once per stage). */
+    number: number;
+    /** 0-based index of the deck slide it came from. */
+    deckIndex: number;
+    slideId?: string;
+    /** Stage of a slide that expands into several (a walkthrough), else absent. */
+    part?: {
+        index: number;
+        count: number;
+    };
+    /** Timing cue. */
+    time?: string;
+    /** Notes as HTML (paragraphs, bullets, inline marks), escaped; '' when there are none. */
+    html: string;
+}
+/**
+ * Every presented slide's speaker notes, numbered as `renderDeck` numbers
+ * them, for a printed notes handout. Walks the slides the way `renderDeck`
+ * does but skips images, QR codes and charts, so nothing is fetched or drawn.
+ */
+declare function speakerNotes(input: unknown, options?: SpeakerNotesOptions): SpeakerNote[];
 /** Pulls the embedded deck source back out of a rendered HTML file. */
 declare function extractDeckSource(html: string): unknown | undefined;
 
@@ -638,4 +667,4 @@ declare function inlineDeckImages(input: unknown, resolve: ImageResolver, option
  */
 declare function externalizeDeckImages(input: unknown, upload: (dataUri: string) => string | Promise<string>, options?: MapImagesOptions): Promise<unknown>;
 
-export { type ValidationResult as A, type BrandPalette as B, CLASSIC_HOMES_BRAND as C, type Deck as D, checkPalette as E, type FieldMarker as F, collectImageSources as G, externalizeDeckImages as H, type ImageInput as I, extractDeckSource as J, fieldMarkers as K, type LayoutCategory as L, type MapImagesOptions as M, formatIssues as N, formatPath as O, PREVIEW_SIZE as P, getLayout as Q, type RenderOptions as R, type SlideData as S, inlineDeckImages as T, mapDeckImages as U, type ValidateOptions as V, renderDeck as W, resolveBrand as X, validateBrandProfile as Y, validateDeck as Z, BrandPaletteSchema as a, type BrandProfile as b, type BrandProfileInput as c, BrandProfileSchema as d, CLASSIC_HOMES_PALETTE as e, type DeckBrand as f, DeckBrandSchema as g, DeckError as h, type DeckInput as i, DeckSchema as j, type DeckSettings as k, DeckSettingsSchema as l, type ImageResolver as m, type ImageValue as n, type InlineImagesResult as o, type ItemValue as p, LAYOUTS as q, LAYOUT_CATEGORIES as r, LAYOUT_CATEGORY_ORDER as s, type LayoutDef as t, type LayoutIssue as u, type LayoutName as v, type RenderResult as w, type ResolvedBrand as x, type SlideInput as y, SlideSchema as z };
+export { validateBrandProfile as $, type SpeakerNote as A, type BrandPalette as B, CLASSIC_HOMES_BRAND as C, type Deck as D, type SpeakerNotesOptions as E, type FieldMarker as F, type ValidationResult as G, checkPalette as H, type ImageInput as I, collectImageSources as J, externalizeDeckImages as K, type LayoutCategory as L, type MapImagesOptions as M, extractDeckSource as N, fieldMarkers as O, PREVIEW_SIZE as P, formatIssues as Q, type RenderOptions as R, type SlideData as S, formatPath as T, getLayout as U, type ValidateOptions as V, inlineDeckImages as W, mapDeckImages as X, renderDeck as Y, resolveBrand as Z, speakerNotes as _, BrandPaletteSchema as a, validateDeck as a0, type BrandProfile as b, type BrandProfileInput as c, BrandProfileSchema as d, CLASSIC_HOMES_PALETTE as e, type DeckBrand as f, DeckBrandSchema as g, DeckError as h, type DeckInput as i, DeckSchema as j, type DeckSettings as k, DeckSettingsSchema as l, type ImageResolver as m, type ImageValue as n, type InlineImagesResult as o, type ItemValue as p, LAYOUTS as q, LAYOUT_CATEGORIES as r, LAYOUT_CATEGORY_ORDER as s, type LayoutDef as t, type LayoutIssue as u, type LayoutName as v, type RenderResult as w, type ResolvedBrand as x, type SlideInput as y, SlideSchema as z };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { L as LayoutCategory, B as BrandPalette } from './images-8N30SsCW.js';
-export { a as BrandPaletteSchema, b as BrandProfile, c as BrandProfileInput, d as BrandProfileSchema, C as CLASSIC_HOMES_BRAND, e as CLASSIC_HOMES_PALETTE, D as Deck, f as DeckBrand, g as DeckBrandSchema, h as DeckError, i as DeckInput, j as DeckSchema, k as DeckSettings, l as DeckSettingsSchema, F as FieldMarker, I as ImageInput, m as ImageResolver, n as ImageValue, o as InlineImagesResult, p as ItemValue, q as LAYOUTS, r as LAYOUT_CATEGORIES, s as LAYOUT_CATEGORY_ORDER, t as LayoutDef, u as LayoutIssue, v as LayoutName, M as MapImagesOptions, P as PREVIEW_SIZE, R as RenderOptions, w as RenderResult, x as ResolvedBrand, S as SlideData, y as SlideInput, z as SlideSchema, V as ValidateOptions, A as ValidationResult, E as checkPalette, G as collectImageSources, H as externalizeDeckImages, J as extractDeckSource, K as fieldMarkers, N as formatIssues, O as formatPath, Q as getLayout, T as inlineDeckImages, U as mapDeckImages, W as renderDeck, X as resolveBrand, Y as validateBrandProfile, Z as validateDeck } from './images-8N30SsCW.js';
+import { L as LayoutCategory, B as BrandPalette } from './images-rkJZtnjl.js';
+export { a as BrandPaletteSchema, b as BrandProfile, c as BrandProfileInput, d as BrandProfileSchema, C as CLASSIC_HOMES_BRAND, e as CLASSIC_HOMES_PALETTE, D as Deck, f as DeckBrand, g as DeckBrandSchema, h as DeckError, i as DeckInput, j as DeckSchema, k as DeckSettings, l as DeckSettingsSchema, F as FieldMarker, I as ImageInput, m as ImageResolver, n as ImageValue, o as InlineImagesResult, p as ItemValue, q as LAYOUTS, r as LAYOUT_CATEGORIES, s as LAYOUT_CATEGORY_ORDER, t as LayoutDef, u as LayoutIssue, v as LayoutName, M as MapImagesOptions, P as PREVIEW_SIZE, R as RenderOptions, w as RenderResult, x as ResolvedBrand, S as SlideData, y as SlideInput, z as SlideSchema, A as SpeakerNote, E as SpeakerNotesOptions, V as ValidateOptions, G as ValidationResult, H as checkPalette, J as collectImageSources, K as externalizeDeckImages, N as extractDeckSource, O as fieldMarkers, Q as formatIssues, T as formatPath, U as getLayout, W as inlineDeckImages, X as mapDeckImages, Y as renderDeck, Z as resolveBrand, _ as speakerNotes, $ as validateBrandProfile, a0 as validateDeck } from './images-rkJZtnjl.js';
 import * as zod_to_json_schema from 'zod-to-json-schema';
 import { z } from 'zod';
 
@@ -35,7 +35,7 @@ declare function deckJsonSchema(): zod_to_json_schema.JsonSchema7Type & {
     } | undefined;
 };
 /** Authoring guidance shared by the CLI, MCP server and docs. */
-declare const AUTHORING_GUIDE = "# Writing a Classic Homes deck\n\nA deck is a YAML (or JSON) file: deck-level fields plus a list of slides. Each slide\npicks a **layout** and fills its fields. Layouts own all styling \u2014 there is no way to\nset colours, fonts or sizes directly, which is what keeps every deck on-brand.\n\n## Principles\n- **One idea per slide.** The headline states the point. Detail goes in `notes`.\n- **Short copy.** Titles under ~70 characters, bullets a few words, at most 6 bullets.\n  `validate` warns when a slide gets crowded \u2014 split it rather than shrinking text.\n- **Speaker notes on every content slide.** Presenters press N (or P for presenter view).\n- **Real photos over decoration.** Every image needs `alt` text.\n- **Tracks** colour the accent: `value` (red, default) for the homeowner/value story,\n  `build` (teal) for construction/process, `neutral` (navy) for framing slides.\n- **Backgrounds**: `paper` (default) for content; solid `navy`/`red`/`teal`/`plum`/`grey`/`stone`\n  for dividers. `backgroundImage` + `overlay` puts a photo behind title/section/statement slides.\n\n## Picking a layout\n- **Numbers:** `stats` (2\u20136 headline figures, optional trend + sparkline), `chart` (a real chart \u2014\n  put the takeaway in the title), `table` (exact figures people compare).\n- **Processes & structure:** `flow` (ordered steps with arrows), `timeline` (dated milestones, phases),\n  `cycle` (things that repeat), `hierarchy` (org chart / tree), `matrix` (2\u00D72), `tiers`\n  (funnel or pyramid), `walkthrough` (photo per stage), `journey` (deck agenda).\n- **Media:** `split` (text + photos), `photos`, `image` (with numbered `hotspots` for floor plans\n  and site maps), `compare` (before/after slider), `video` (YouTube/Vimeo), `embed` (any https page:\n  maps, dashboards, 3D tours, forms).\n- **Words:** `statement`, `bullets`, `cards`, `comparison`, `quote`.\n- **Wrap-up:** `qr` (send people somewhere), `contacts`, closing `statement`.\n\n## Charts\n`chart.labels` are the categories; each series has one value per label. Pie, donut, funnel and\ngauge use the first series; gauge needs `max`; scatter uses two series as x and y. Use\n`highlight` to emphasise one category and `format`/`unit` instead of typing symbols into numbers.\n\n## Video & embeds\nThey need internet while presenting. Offline, in print and in PDF they show a poster (or\n`fallback` screenshot) with a QR code. Some sites refuse to be framed \u2014 the \"Open \u2197\" link\nalways works; add a `fallback` image for anything critical.\n\n## Brand\n`brand.profile` picks who the deck speaks for (default `classic-homes`). You may override\n`name`, `tagline`, `logo`, `logoOnDark`, `favicon` and `footer`; colours come from the profile.\n`settings` controls slide numbers, logo placement, a confidential label and kiosk auto-advance.\n\n## Presenting\nArrow keys / Space advance (and step through `build: true` reveals). N notes \u00B7 P presenter window\n(current + next slide, notes, timer) \u00B7 O overview \u00B7 F fullscreen \u00B7 `?kiosk=15` on the URL loops\nunattended. `hidden: true` skips a slide without deleting it.\n\n## Inline text\n`**bold**`, `*highlight*` (accent colour), `\\`code\\``, `[label](https://\u2026)`. No HTML.\n\n## Journey decks\nSet `journey.steps` at deck level to get a numbered agenda. Then:\n- a `journey` slide shows the full map,\n- `step: 3` on any slide draws the vertical STEP rail,\n- `showJourney: true` adds the compact \"you are here\" strip (great on `section` slides).\n\n## Typical shape\n1. `title`\n2. `statement` or `journey` (why we're here / the agenda)\n3. per part: `section` \u2192 2\u20135 content slides\n4. `qr` (where to go next) \u2192 `contacts` \u2192 closing `statement`\n";
+declare const AUTHORING_GUIDE = "# Writing a Classic Homes deck\n\nA deck is a YAML (or JSON) file: deck-level fields plus a list of slides. Each slide\npicks a **layout** and fills its fields. Layouts own all styling \u2014 there is no way to\nset colours, fonts or sizes directly, which is what keeps every deck on-brand.\n\n## Principles\n- **One idea per slide.** The headline states the point. Detail goes in `notes`.\n- **Short copy.** Titles under ~70 characters, bullets a few words, at most 6 bullets.\n  `validate` warns when a slide gets crowded \u2014 split it rather than shrinking text.\n- **Speaker notes on every content slide.** Presenters press N (or P for presenter view).\n- **Real photos over decoration.** Every image needs `alt` text.\n- **Tracks** colour the accent: `value` (red, default) for the homeowner/value story,\n  `build` (teal) for construction/process, `neutral` (navy) for framing slides.\n- **Backgrounds**: `paper` (default) for content; solid `navy`/`red`/`teal`/`plum`/`grey`/`stone`\n  for dividers. `backgroundImage` + `overlay` puts a photo behind title/section/statement slides.\n\n## Picking a layout\n- **Numbers:** `stats` (2\u20136 headline figures, optional trend + sparkline), `chart` (a real chart \u2014\n  put the takeaway in the title), `table` (exact figures people compare).\n- **Processes & structure:** `flow` (ordered steps with arrows), `timeline` (dated milestones, phases),\n  `cycle` (things that repeat), `hierarchy` (org chart / tree), `matrix` (2\u00D72), `tiers`\n  (funnel or pyramid), `walkthrough` (photo per stage), `journey` (deck agenda).\n- **Media:** `split` (text + photos), `photos`, `image` (with numbered `hotspots` for floor plans\n  and site maps), `compare` (before/after slider), `video` (YouTube/Vimeo), `embed` (any https page:\n  maps, dashboards, 3D tours, forms).\n- **Words:** `statement`, `bullets`, `cards`, `comparison`, `quote`.\n- **Wrap-up:** `qr` (send people somewhere), `contacts`, closing `statement`.\n\n## Charts\n`chart.labels` are the categories; each series has one value per label. Use `highlight` to\nemphasise one category and `format`/`unit` instead of typing symbols into numbers.\n- **Compare:** `column`/`bar`; `dumbbell` (2+ series as dots per row, e.g. last year vs this\n  year); `bullet` (series 1 actual, series 2 target; `max` sets the track).\n- **Part of whole:** `stacked-*` (absolute), `percent-column`/`percent-bar` (each row = 100%),\n  `pie`/`donut` (\u2264 7 slices), `treemap` (many categories).\n- **Change:** `line`/`area`; `combo` (series 1 bars, the rest lines; set a series' `as` to\n  override and `axis: secondary` + `secondaryFormat` for a second scale, e.g. closings and average\n  price); `waterfall` (series 1 is signed changes; list running-total rows in `totals`).\n- **Single value:** `gauge` (one value, needs `max`); `ring` (up to 4 progress rings, one per label;\n  `max`, or `format: percent` for 100); `pictogram` (house icons per row; `perIcon` sets the step).\n- **Grid & flow:** `heatmap` (labels are rows, series names are columns); `sankey` (labels are\n  sources, series names are destinations, each cell a flow; a destination that is also a label chains\n  stages; no loops).\n- **Other:** `funnel` (drop-off, first series), `scatter` (two series as x and y), `radar`.\nPie, donut, funnel, gauge, ring, treemap, waterfall and pictogram read the first series only.\n\n## Video & embeds\nThey need internet while presenting. Offline, in print and in PDF they show a poster (or\n`fallback` screenshot) with a QR code. Some sites refuse to be framed \u2014 the \"Open \u2197\" link\nalways works; add a `fallback` image for anything critical.\n\n## Brand\n`brand.profile` picks who the deck speaks for (default `classic-homes`). You may override\n`name`, `tagline`, `logo`, `logoOnDark`, `favicon` and `footer`; colours come from the profile.\n`settings` controls slide numbers, logo placement, a confidential label and kiosk auto-advance.\n\n## Presenting\nArrow keys / Space advance (and step through `build: true` reveals). N notes \u00B7 P presenter window\n(current + next slide, notes, timer) \u00B7 O overview \u00B7 F fullscreen \u00B7 `?kiosk=15` on the URL loops\nunattended. `hidden: true` skips a slide without deleting it.\n\n## Inline text\n`**bold**`, `*highlight*` (accent colour), `\\`code\\``, `[label](https://\u2026)`. No HTML.\n\n## Journey decks\nSet `journey.steps` at deck level to get a numbered agenda. Then:\n- a `journey` slide shows the full map,\n- `step: 3` on any slide draws the vertical STEP rail,\n- `showJourney: true` adds the compact \"you are here\" strip (great on `section` slides).\n\n## Typical shape\n1. `title`\n2. `statement` or `journey` (why we're here / the agenda)\n3. per part: `section` \u2192 2\u20135 content slides\n4. `qr` (where to go next) \u2192 `contacts` \u2192 closing `statement`\n";
 
 /** Parses deck source text. YAML is a superset of JSON, so both work. */
 declare function parseDeckSource(text: string): unknown;
@@ -219,20 +219,28 @@ declare function blankSlide(name: string): Record<string, unknown> | undefined;
  * never load it.
  */
 
-declare const CHART_TYPES: readonly ["column", "bar", "stacked-column", "stacked-bar", "line", "area", "pie", "donut", "funnel", "gauge", "scatter", "radar"];
+declare const CHART_TYPES: readonly ["column", "bar", "stacked-column", "stacked-bar", "line", "area", "pie", "donut", "funnel", "gauge", "scatter", "radar", "percent-column", "percent-bar", "combo", "waterfall", "heatmap", "dumbbell", "bullet", "treemap", "ring", "sankey", "pictogram"];
 type ChartType = (typeof CHART_TYPES)[number];
+/** Types that only read the first series. */
+declare const SINGLE_SERIES_CHARTS: readonly ChartType[];
 declare const ChartSpec: z.ZodObject<{
-    type: z.ZodEnum<["column", "bar", "stacked-column", "stacked-bar", "line", "area", "pie", "donut", "funnel", "gauge", "scatter", "radar"]>;
+    type: z.ZodEnum<["column", "bar", "stacked-column", "stacked-bar", "line", "area", "pie", "donut", "funnel", "gauge", "scatter", "radar", "percent-column", "percent-bar", "combo", "waterfall", "heatmap", "dumbbell", "bullet", "treemap", "ring", "sankey", "pictogram"]>;
     labels: z.ZodArray<z.ZodString, "many">;
     series: z.ZodArray<z.ZodObject<{
         name: z.ZodString;
         values: z.ZodArray<z.ZodNumber, "many">;
+        as: z.ZodOptional<z.ZodEnum<["bar", "line"]>>;
+        axis: z.ZodOptional<z.ZodEnum<["primary", "secondary"]>>;
     }, "strip", z.ZodTypeAny, {
         values: number[];
         name: string;
+        as?: "bar" | "line" | undefined;
+        axis?: "primary" | "secondary" | undefined;
     }, {
         values: number[];
         name: string;
+        as?: "bar" | "line" | undefined;
+        axis?: "primary" | "secondary" | undefined;
     }>, "many">;
     format: z.ZodDefault<z.ZodEnum<["number", "percent", "currency", "compact"]>>;
     decimals: z.ZodDefault<z.ZodNumber>;
@@ -241,12 +249,17 @@ declare const ChartSpec: z.ZodObject<{
     labelsOnData: z.ZodDefault<z.ZodBoolean>;
     highlight: z.ZodOptional<z.ZodString>;
     max: z.ZodOptional<z.ZodNumber>;
+    secondaryFormat: z.ZodOptional<z.ZodEnum<["number", "percent", "currency", "compact"]>>;
+    totals: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    perIcon: z.ZodOptional<z.ZodNumber>;
 }, "strict", z.ZodTypeAny, {
-    type: "column" | "bar" | "stacked-column" | "stacked-bar" | "line" | "area" | "pie" | "donut" | "funnel" | "gauge" | "scatter" | "radar";
+    type: "column" | "bar" | "stacked-column" | "stacked-bar" | "line" | "area" | "pie" | "donut" | "funnel" | "gauge" | "scatter" | "radar" | "percent-column" | "percent-bar" | "combo" | "waterfall" | "heatmap" | "dumbbell" | "bullet" | "treemap" | "ring" | "sankey" | "pictogram";
     labels: string[];
     series: {
         values: number[];
         name: string;
+        as?: "bar" | "line" | undefined;
+        axis?: "primary" | "secondary" | undefined;
     }[];
     format: "number" | "percent" | "currency" | "compact";
     decimals: number;
@@ -255,12 +268,17 @@ declare const ChartSpec: z.ZodObject<{
     unit?: string | undefined;
     highlight?: string | undefined;
     max?: number | undefined;
+    secondaryFormat?: "number" | "percent" | "currency" | "compact" | undefined;
+    totals?: string[] | undefined;
+    perIcon?: number | undefined;
 }, {
-    type: "column" | "bar" | "stacked-column" | "stacked-bar" | "line" | "area" | "pie" | "donut" | "funnel" | "gauge" | "scatter" | "radar";
+    type: "column" | "bar" | "stacked-column" | "stacked-bar" | "line" | "area" | "pie" | "donut" | "funnel" | "gauge" | "scatter" | "radar" | "percent-column" | "percent-bar" | "combo" | "waterfall" | "heatmap" | "dumbbell" | "bullet" | "treemap" | "ring" | "sankey" | "pictogram";
     labels: string[];
     series: {
         values: number[];
         name: string;
+        as?: "bar" | "line" | undefined;
+        axis?: "primary" | "secondary" | undefined;
     }[];
     format?: "number" | "percent" | "currency" | "compact" | undefined;
     decimals?: number | undefined;
@@ -269,6 +287,9 @@ declare const ChartSpec: z.ZodObject<{
     labelsOnData?: boolean | undefined;
     highlight?: string | undefined;
     max?: number | undefined;
+    secondaryFormat?: "number" | "percent" | "currency" | "compact" | undefined;
+    totals?: string[] | undefined;
+    perIcon?: number | undefined;
 }>;
 type ChartSpecInput = z.input<typeof ChartSpec>;
 type ChartSpecValue = z.output<typeof ChartSpec>;
@@ -308,4 +329,4 @@ declare function videoEmbedUrl(ref: VideoRef, o: EmbedOptions): string;
 /** CSP source for the inline presenter runtime: script-src '<hash>'. */
 declare const RUNTIME_SCRIPT_HASH = "sha256-gElvQAb4VPvKu4UeyJRVKuoHYNp8NGhXwx2EhL7NB88=";
 
-export { AUTHORING_GUIDE, BrandPalette, CHART_TYPES, ChartSpec, type ChartSpecInput, type ChartSpecValue, type ChartType, type EditableDeck, type EditorField, LOGO_SVG, LayoutCategory, type LayoutEditorInfo, PALETTE, PLACEHOLDER_IMAGE, RUNTIME_SCRIPT_HASH, type SlideRef, type VideoRef, addSlide, allLayoutEditorInfo, blankSlide, chartOption, commonSlideFields, deckEditorFields, deckJsonSchema, describeChart, describeLayout, ensureSlideIds, escapeHtml, findSlide, formatValue, inline, isPlaceholderImage, layoutEditorInfo, layoutGalleryDeck, listLayouts, logoLockup, moveSlide, newSlideId, outline, parseDeckSource, parseVideoUrl, prose, removeSlide, renderChartSvg, slideKey, stringifyDeck, updateSlide, videoEmbedUrl };
+export { AUTHORING_GUIDE, BrandPalette, CHART_TYPES, ChartSpec, type ChartSpecInput, type ChartSpecValue, type ChartType, type EditableDeck, type EditorField, LOGO_SVG, LayoutCategory, type LayoutEditorInfo, PALETTE, PLACEHOLDER_IMAGE, RUNTIME_SCRIPT_HASH, SINGLE_SERIES_CHARTS, type SlideRef, type VideoRef, addSlide, allLayoutEditorInfo, blankSlide, chartOption, commonSlideFields, deckEditorFields, deckJsonSchema, describeChart, describeLayout, ensureSlideIds, escapeHtml, findSlide, formatValue, inline, isPlaceholderImage, layoutEditorInfo, layoutGalleryDeck, listLayouts, logoLockup, moveSlide, newSlideId, outline, parseDeckSource, parseVideoUrl, prose, removeSlide, renderChartSvg, slideKey, stringifyDeck, updateSlide, videoEmbedUrl };

package/dist/index.js

@@ -3,7 +3,7 @@ import {
   deckJsonSchema,
   describeLayout,
   listLayouts
-} from "./chunk-42YDHMNB.js";
+} from "./chunk-ORNJ4CTQ.js";
 import {
   BrandPaletteSchema,
   BrandProfileSchema,
@@ -22,6 +22,7 @@ import {
   PALETTE,
   PLACEHOLDER_IMAGE,
   PREVIEW_SIZE,
+  SINGLE_SERIES_CHARTS,
   SlideSchema,
   addSlide,
   allLayoutEditorInfo,
@@ -60,12 +61,13 @@ import {
   renderDeck,
   resolveBrand,
   slideKey,
+  speakerNotes,
   stringifyDeck,
   updateSlide,
   validateBrandProfile,
   validateDeck,
   videoEmbedUrl
-} from "./chunk-25NZMEQG.js";
+} from "./chunk-HI5ZCAHO.js";
 
 // src/generated/runtime-hash.ts
 var RUNTIME_SCRIPT_HASH = "sha256-gElvQAb4VPvKu4UeyJRVKuoHYNp8NGhXwx2EhL7NB88=";
@@ -89,6 +91,7 @@ export {
   PLACEHOLDER_IMAGE,
   PREVIEW_SIZE,
   RUNTIME_SCRIPT_HASH,
+  SINGLE_SERIES_CHARTS,
   SlideSchema,
   addSlide,
   allLayoutEditorInfo,
@@ -130,6 +133,7 @@ export {
   renderDeck,
   resolveBrand,
   slideKey,
+  speakerNotes,
   stringifyDeck,
   updateSlide,
   validateBrandProfile,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/generated/runtime-hash.ts"],"sourcesContent":["// Generated by scripts/embed-fonts.ts. Do not edit.\n/** CSP source for the inline presenter runtime: script-src '<hash>'. */\nexport const RUNTIME_SCRIPT_HASH = 'sha256-gElvQAb4VPvKu4UeyJRVKuoHYNp8NGhXwx2EhL7NB88=';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEO,IAAM,sBAAsB;","names":[]}
+{"version":3,"sources":["../src/generated/runtime-hash.ts"],"sourcesContent":["// Generated by scripts/embed-fonts.ts. Do not edit.\n/** CSP source for the inline presenter runtime: script-src '<hash>'. */\nexport const RUNTIME_SCRIPT_HASH = 'sha256-gElvQAb4VPvKu4UeyJRVKuoHYNp8NGhXwx2EhL7NB88=';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEO,IAAM,sBAAsB;","names":[]}

package/dist/{mcp-P3CPIO3H.js → mcp-MG2E7J3I.js}

@@ -2,13 +2,13 @@ import {
   AUTHORING_GUIDE,
   describeLayout,
   listLayouts
-} from "./chunk-42YDHMNB.js";
+} from "./chunk-ORNJ4CTQ.js";
 import {
   buildDeckFile,
   confinedPath,
   loadDeckFile,
   saveDeckFile
-} from "./chunk-6CYZI27I.js";
+} from "./chunk-UKRX7A2V.js";
 import {
   addSlide,
   formatIssues,
@@ -18,7 +18,7 @@ import {
   stringifyDeck,
   updateSlide,
   validateDeck
-} from "./chunk-25NZMEQG.js";
+} from "./chunk-HI5ZCAHO.js";
 
 // src/node/mcp.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -320,4 +320,4 @@ export {
   createSlidesMcpServer,
   runStdio
 };
-//# sourceMappingURL=mcp-P3CPIO3H.js.map
+//# sourceMappingURL=mcp-MG2E7J3I.js.map

package/dist/node.d.ts

@@ -1,5 +1,5 @@
-import { R as RenderOptions, w as RenderResult, o as InlineImagesResult, m as ImageResolver } from './images-8N30SsCW.js';
-export { W as renderDeck } from './images-8N30SsCW.js';
+import { R as RenderOptions, w as RenderResult, o as InlineImagesResult, m as ImageResolver } from './images-rkJZtnjl.js';
+export { Y as renderDeck } from './images-rkJZtnjl.js';
 import 'zod';
 
 /** Largest single image we inline without warning. Big photos bloat the deck file. */

package/dist/node.js

@@ -5,10 +5,10 @@ import {
   fileImageResolver,
   loadDeckFile,
   saveDeckFile
-} from "./chunk-6CYZI27I.js";
+} from "./chunk-UKRX7A2V.js";
 import {
   renderDeck
-} from "./chunk-25NZMEQG.js";
+} from "./chunk-HI5ZCAHO.js";
 export {
   IMAGE_WARN_BYTES,
   buildDeckFile,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@classic-homes/slides",
-  "version": "0.5.12",
+  "version": "0.7.0",
   "description": "Branded Classic Homes presentations from structured deck files: schema, layouts, renderer, CLI and MCP server",
   "type": "module",
   "main": "dist/index.js",