@classic-homes/slides 0.2.0 → 0.3.0

package/dist/chunk-YI7A4EWX.js

@@ -0,0 +1,107 @@
+import {
+  DeckSchema,
+  LAYOUTS,
+  LAYOUT_CATEGORIES,
+  baseSlide,
+  getLayout
+} from "./chunk-GXGDPBAR.js";
+
+// src/catalog.ts
+import { z } from "zod";
+import { zodToJsonSchema } from "zod-to-json-schema";
+function listLayouts() {
+  return LAYOUTS.map((l) => ({
+    name: l.name,
+    category: LAYOUT_CATEGORIES[l.name],
+    description: l.description,
+    whenToUse: l.whenToUse
+  }));
+}
+function describeLayout(name) {
+  const layout = getLayout(name);
+  if (!layout) return void 0;
+  const schema = z.object({ layout: z.literal(layout.name), ...layout.shape, ...baseSlide });
+  return {
+    name: layout.name,
+    description: layout.description,
+    whenToUse: layout.whenToUse,
+    defaults: layout.defaults ?? {},
+    schema: zodToJsonSchema(schema, { $refStrategy: "none" }),
+    example: layout.example
+  };
+}
+function deckJsonSchema() {
+  return zodToJsonSchema(DeckSchema, { name: "ClassicDeck", $refStrategy: "none" });
+}
+var AUTHORING_GUIDE = `# Writing a Classic Homes deck
+
+A deck is a YAML (or JSON) file: deck-level fields plus a list of slides. Each slide
+picks a **layout** and fills its fields. Layouts own all styling \u2014 there is no way to
+set colours, fonts or sizes directly, which is what keeps every deck on-brand.
+
+## Principles
+- **One idea per slide.** The headline states the point. Detail goes in \`notes\`.
+- **Short copy.** Titles under ~70 characters, bullets a few words, at most 6 bullets.
+  \`validate\` warns when a slide gets crowded \u2014 split it rather than shrinking text.
+- **Speaker notes on every content slide.** Presenters press N (or P for presenter view).
+- **Real photos over decoration.** Every image needs \`alt\` text.
+- **Tracks** colour the accent: \`value\` (red, default) for the homeowner/value story,
+  \`build\` (teal) for construction/process, \`neutral\` (navy) for framing slides.
+- **Backgrounds**: \`paper\` (default) for content; solid \`navy\`/\`red\`/\`teal\`/\`plum\`/\`grey\`/\`stone\`
+  for dividers. \`backgroundImage\` + \`overlay\` puts a photo behind title/section/statement slides.
+
+## Picking a layout
+- **Numbers:** \`stats\` (2\u20136 headline figures, optional trend + sparkline), \`chart\` (a real chart \u2014
+  put the takeaway in the title), \`table\` (exact figures people compare).
+- **Processes & structure:** \`flow\` (ordered steps with arrows), \`timeline\` (dated milestones, phases),
+  \`cycle\` (things that repeat), \`hierarchy\` (org chart / tree), \`matrix\` (2\xD72), \`tiers\`
+  (funnel or pyramid), \`walkthrough\` (photo per stage), \`journey\` (deck agenda).
+- **Media:** \`split\` (text + photos), \`photos\`, \`image\` (with numbered \`hotspots\` for floor plans
+  and site maps), \`compare\` (before/after slider), \`video\` (YouTube/Vimeo), \`embed\` (any https page:
+  maps, dashboards, 3D tours, forms).
+- **Words:** \`statement\`, \`bullets\`, \`cards\`, \`comparison\`, \`quote\`.
+- **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.
+
+## Video & embeds
+They need internet while presenting. Offline, in print and in PDF they show a poster (or
+\`fallback\` screenshot) with a QR code. Some sites refuse to be framed \u2014 the "Open \u2197" link
+always works; add a \`fallback\` image for anything critical.
+
+## Brand
+\`brand.profile\` picks who the deck speaks for (default \`classic-homes\`). You may override
+\`name\`, \`tagline\`, \`logo\`, \`logoOnDark\`, \`favicon\` and \`footer\`; colours come from the profile.
+\`settings\` controls slide numbers, logo placement, a confidential label and kiosk auto-advance.
+
+## Presenting
+Arrow keys / Space advance (and step through \`build: true\` reveals). N notes \xB7 P presenter window
+(current + next slide, notes, timer) \xB7 O overview \xB7 F fullscreen \xB7 \`?kiosk=15\` on the URL loops
+unattended. \`hidden: true\` skips a slide without deleting it.
+
+## Inline text
+\`**bold**\`, \`*highlight*\` (accent colour), \`\\\`code\\\`\`, \`[label](https://\u2026)\`. No HTML.
+
+## Journey decks
+Set \`journey.steps\` at deck level to get a numbered agenda. Then:
+- a \`journey\` slide shows the full map,
+- \`step: 3\` on any slide draws the vertical STEP rail,
+- \`showJourney: true\` adds the compact "you are here" strip (great on \`section\` slides).
+
+## Typical shape
+1. \`title\`
+2. \`statement\` or \`journey\` (why we're here / the agenda)
+3. per part: \`section\` \u2192 2\u20135 content slides
+4. \`qr\` (where to go next) \u2192 \`contacts\` \u2192 closing \`statement\`
+`;
+
+export {
+  listLayouts,
+  describeLayout,
+  deckJsonSchema,
+  AUTHORING_GUIDE
+};
+//# sourceMappingURL=chunk-YI7A4EWX.js.map

package/dist/chunk-YI7A4EWX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/catalog.ts"],"sourcesContent":["import { z } from 'zod';\nimport { 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 } from './schema/common.js';\nimport { DeckSchema } from './schema/deck.js';\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: zodToJsonSchema(schema, { $refStrategy: 'none' }),\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 zodToJsonSchema(DeckSchema, { name: 'ClassicDeck', $refStrategy: 'none' });\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,uBAAuB;AAkBzB,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,gBAAgB,QAAQ,EAAE,cAAc,OAAO,CAAC;AAAA,IACxD,SAAS,OAAO;AAAA,EAClB;AACF;AAGO,SAAS,iBAAiB;AAC/B,SAAO,gBAAgB,YAAY,EAAE,MAAM,eAAe,cAAc,OAAO,CAAC;AAClF;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":[]}

package/dist/cli.js

@@ -4,18 +4,18 @@ import {
   deckJsonSchema,
   describeLayout,
   listLayouts
-} from "./chunk-TXNQKBWJ.js";
+} from "./chunk-YI7A4EWX.js";
 import {
   buildDeckFile,
   fileImageResolver,
   loadDeckFile
-} from "./chunk-CKVKX2ZD.js";
+} from "./chunk-2IPLZ3SA.js";
 import {
   DeckError,
   formatIssues,
   renderDeck,
   validateDeck
-} from "./chunk-TM3TNVHB.js";
+} from "./chunk-GXGDPBAR.js";
 
 // src/node/cli.ts
 import { watch } from "fs";
@@ -105,8 +105,18 @@ ${"".padEnd(12)} Use for: ${l.whenToUse}
     case "schema":
       return void console.log(JSON.stringify(deckJsonSchema(), null, 2));
     case "mcp": {
-      const { runStdio } = await import("./mcp-5R6YD3QW.js");
-      return runStdio(values.root);
+      let mcp;
+      try {
+        mcp = await import("./mcp-PUA45IS7.js");
+      } catch (e) {
+        if (e.code === "ERR_MODULE_NOT_FOUND") {
+          throw new Error(
+            "The MCP server needs @modelcontextprotocol/sdk. Run it with:\n  npx -y -p @classic-homes/slides -p @modelcontextprotocol/sdk classic-slides mcp"
+          );
+        }
+        throw e;
+      }
+      return mcp.runStdio(values.root);
     }
     default:
       throw new Error(`Unknown command "${cmd}".

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/node/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * classic-slides — build branded Classic Homes decks from YAML.\n */\nimport { watch } from 'node:fs';\nimport { access, copyFile, mkdir } from 'node:fs/promises';\nimport { createServer } from 'node:http';\nimport { basename, dirname, join, resolve } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { parseArgs } from 'node:util';\nimport { AUTHORING_GUIDE, deckJsonSchema, describeLayout, listLayouts } from '../catalog.js';\nimport { renderDeck } from '../render.js';\nimport { DeckError, formatIssues, validateDeck } from '../validate.js';\nimport { buildDeckFile, fileImageResolver, loadDeckFile } from './index.js';\n\nconst HELP = `classic-slides — branded Classic Homes presentations\n\nUsage\n  classic-slides new <file.yaml> [--starter basic|journey]  Start a deck from a starter\n  classic-slides build <file.yaml> [-o out.html]            Render one self-contained HTML file\n  classic-slides dev <file.yaml> [--port 4321]              Live preview; reloads on save\n  classic-slides validate <file.yaml>                       Check for errors and crowded slides\n  classic-slides layouts [name]                             List layouts, or show one in detail\n  classic-slides guide                                      Print the authoring guide\n  classic-slides schema                                     Print the deck JSON Schema\n  classic-slides mcp [--root dir]                           Run the MCP server on stdio\n`;\n\nconst pkgRoot = resolve(dirname(fileURLToPath(import.meta.url)), '..');\n\nasync function main() {\n  const { positionals, values } = parseArgs({\n    allowPositionals: true,\n    options: {\n      out: { type: 'string', short: 'o' },\n      port: { type: 'string', default: '4321' },\n      starter: { type: 'string', default: 'basic' },\n      root: { type: 'string' },\n      help: { type: 'boolean', short: 'h' },\n    },\n  });\n  const [cmd, arg] = positionals;\n\n  if (!cmd || values.help) return void process.stdout.write(HELP);\n\n  switch (cmd) {\n    case 'new': {\n      if (!arg) throw new Error('Usage: classic-slides new <file.yaml>');\n      const target = resolve(arg.endsWith('.yaml') || arg.endsWith('.yml') ? arg : `${arg}.yaml`);\n      if (\n        await access(target).then(\n          () => true,\n          () => false\n        )\n      )\n        throw new Error(`${target} already exists.`);\n      const starter = join(pkgRoot, 'starters', `${values.starter}.yaml`);\n      await mkdir(dirname(target), { recursive: true });\n      await copyFile(starter, target);\n      console.log(`Created ${target}\\nNext: classic-slides dev ${basename(target)}`);\n      return;\n    }\n    case 'build': {\n      if (!arg) throw new Error('Usage: classic-slides build <file.yaml>');\n      const r = await buildDeckFile(arg, {\n        out: values.out,\n        onWarning: (w) => console.warn(`⚠ ${w}`),\n      });\n      if (r.warnings.length) console.warn(formatIssues(r.warnings));\n      console.log(`✔ ${r.out} — ${r.slideCount} slides, ${(r.bytes / 1024 / 1024).toFixed(2)} MB`);\n      return;\n    }\n    case 'validate': {\n      if (!arg) throw new Error('Usage: classic-slides validate <file.yaml>');\n      const v = validateDeck(await loadDeckFile(resolve(arg)));\n      console.log(v.issues.length ? formatIssues(v.issues) : '✔ Valid, no warnings');\n      process.exitCode = v.ok ? 0 : 1;\n      return;\n    }\n    case 'dev':\n      return dev(arg, Number(values.port));\n    case 'layouts': {\n      if (arg) {\n        const d = describeLayout(arg);\n        if (!d) throw new Error(`Unknown layout \"${arg}\".`);\n        console.log(JSON.stringify(d, null, 2));\n      } else {\n        for (const l of listLayouts())\n          console.log(\n            `${l.name.padEnd(12)} ${l.description}\\n${''.padEnd(12)} Use for: ${l.whenToUse}\\n`\n          );\n      }\n      return;\n    }\n    case 'guide':\n      return void console.log(AUTHORING_GUIDE);\n    case 'schema':\n      return void console.log(JSON.stringify(deckJsonSchema(), null, 2));\n    case 'mcp': {\n      const { runStdio } = await import('./mcp.js');\n      return runStdio(values.root);\n    }\n    default:\n      throw new Error(`Unknown command \"${cmd}\".\\n\\n${HELP}`);\n  }\n}\n\n/** Preview server: renders on every request and reloads the page when the deck folder changes. */\nasync function dev(file: string | undefined, port: number) {\n  if (!file) throw new Error('Usage: classic-slides dev <file.yaml>');\n  const abs = resolve(file);\n  const dir = dirname(abs);\n  const clients = new Set<import('node:http').ServerResponse>();\n  const reload = `<script>new EventSource('/__reload').onmessage=()=>location.reload()</script>`;\n\n  const errorPage = (msg: string) =>\n    `<!doctype html><meta charset=\"utf-8\"><title>Deck error</title><body style=\"font:15px/1.5 ui-monospace,monospace;padding:40px;background:#fdf2f2;color:#7f1d1d\"><h2 style=\"font-family:system-ui\">Deck has problems</h2><pre style=\"white-space:pre-wrap\">${msg\n      .replace(/&/g, '&amp;')\n      .replace(/</g, '&lt;')}</pre>${reload}`;\n\n  createServer(async (req, res) => {\n    if (req.url === '/__reload') {\n      res.writeHead(200, {\n        'content-type': 'text/event-stream',\n        'cache-control': 'no-cache',\n        connection: 'keep-alive',\n      });\n      res.write(': ok\\n\\n');\n      clients.add(res);\n      req.on('close', () => clients.delete(res));\n      return;\n    }\n    let html: string;\n    try {\n      const deck = await loadDeckFile(abs);\n      const r = await renderDeck(deck, {\n        resolveImage: fileImageResolver(dir),\n        embedSource: false,\n      });\n      html = r.html.replace('</body>', `${reload}</body>`);\n      if (r.warnings.length) console.warn(formatIssues(r.warnings));\n    } catch (e) {\n      html = errorPage(\n        e instanceof DeckError ? formatIssues(e.issues) : e instanceof Error ? e.message : String(e)\n      );\n    }\n    res.writeHead(200, { 'content-type': 'text/html; charset=utf-8', 'cache-control': 'no-store' });\n    res.end(html);\n  }).listen(port, () =>\n    console.log(`Previewing ${file} at http://localhost:${port}  (Ctrl+C to stop)`)\n  );\n\n  let timer: NodeJS.Timeout | undefined;\n  watch(dir, { recursive: true }, (_, name) => {\n    if (name && /\\.html$/.test(name)) return;\n    clearTimeout(timer);\n    timer = setTimeout(() => clients.forEach((c) => c.write('data: reload\\n\\n')), 120);\n  });\n}\n\nmain().catch((e) => {\n  console.error(e instanceof DeckError ? e.message : `✖ ${e instanceof Error ? e.message : e}`);\n  process.exit(1);\n});\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/node/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * classic-slides — build branded Classic Homes decks from YAML.\n */\nimport { watch } from 'node:fs';\nimport { access, copyFile, mkdir } from 'node:fs/promises';\nimport { createServer } from 'node:http';\nimport { basename, dirname, join, resolve } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { parseArgs } from 'node:util';\nimport { AUTHORING_GUIDE, deckJsonSchema, describeLayout, listLayouts } from '../catalog.js';\nimport { renderDeck } from '../render.js';\nimport { DeckError, formatIssues, validateDeck } from '../validate.js';\nimport { buildDeckFile, fileImageResolver, loadDeckFile } from './index.js';\n\nconst HELP = `classic-slides — branded Classic Homes presentations\n\nUsage\n  classic-slides new <file.yaml> [--starter basic|journey]  Start a deck from a starter\n  classic-slides build <file.yaml> [-o out.html]            Render one self-contained HTML file\n  classic-slides dev <file.yaml> [--port 4321]              Live preview; reloads on save\n  classic-slides validate <file.yaml>                       Check for errors and crowded slides\n  classic-slides layouts [name]                             List layouts, or show one in detail\n  classic-slides guide                                      Print the authoring guide\n  classic-slides schema                                     Print the deck JSON Schema\n  classic-slides mcp [--root dir]                           Run the MCP server on stdio\n`;\n\nconst pkgRoot = resolve(dirname(fileURLToPath(import.meta.url)), '..');\n\nasync function main() {\n  const { positionals, values } = parseArgs({\n    allowPositionals: true,\n    options: {\n      out: { type: 'string', short: 'o' },\n      port: { type: 'string', default: '4321' },\n      starter: { type: 'string', default: 'basic' },\n      root: { type: 'string' },\n      help: { type: 'boolean', short: 'h' },\n    },\n  });\n  const [cmd, arg] = positionals;\n\n  if (!cmd || values.help) return void process.stdout.write(HELP);\n\n  switch (cmd) {\n    case 'new': {\n      if (!arg) throw new Error('Usage: classic-slides new <file.yaml>');\n      const target = resolve(arg.endsWith('.yaml') || arg.endsWith('.yml') ? arg : `${arg}.yaml`);\n      if (\n        await access(target).then(\n          () => true,\n          () => false\n        )\n      )\n        throw new Error(`${target} already exists.`);\n      const starter = join(pkgRoot, 'starters', `${values.starter}.yaml`);\n      await mkdir(dirname(target), { recursive: true });\n      await copyFile(starter, target);\n      console.log(`Created ${target}\\nNext: classic-slides dev ${basename(target)}`);\n      return;\n    }\n    case 'build': {\n      if (!arg) throw new Error('Usage: classic-slides build <file.yaml>');\n      const r = await buildDeckFile(arg, {\n        out: values.out,\n        onWarning: (w) => console.warn(`⚠ ${w}`),\n      });\n      if (r.warnings.length) console.warn(formatIssues(r.warnings));\n      console.log(`✔ ${r.out} — ${r.slideCount} slides, ${(r.bytes / 1024 / 1024).toFixed(2)} MB`);\n      return;\n    }\n    case 'validate': {\n      if (!arg) throw new Error('Usage: classic-slides validate <file.yaml>');\n      const v = validateDeck(await loadDeckFile(resolve(arg)));\n      console.log(v.issues.length ? formatIssues(v.issues) : '✔ Valid, no warnings');\n      process.exitCode = v.ok ? 0 : 1;\n      return;\n    }\n    case 'dev':\n      return dev(arg, Number(values.port));\n    case 'layouts': {\n      if (arg) {\n        const d = describeLayout(arg);\n        if (!d) throw new Error(`Unknown layout \"${arg}\".`);\n        console.log(JSON.stringify(d, null, 2));\n      } else {\n        for (const l of listLayouts())\n          console.log(\n            `${l.name.padEnd(12)} ${l.description}\\n${''.padEnd(12)} Use for: ${l.whenToUse}\\n`\n          );\n      }\n      return;\n    }\n    case 'guide':\n      return void console.log(AUTHORING_GUIDE);\n    case 'schema':\n      return void console.log(JSON.stringify(deckJsonSchema(), null, 2));\n    case 'mcp': {\n      // The MCP SDK is an optional peer so apps that only render decks don't install it.\n      let mcp: typeof import('./mcp.js');\n      try {\n        mcp = await import('./mcp.js');\n      } catch (e) {\n        if ((e as { code?: string }).code === 'ERR_MODULE_NOT_FOUND') {\n          throw new Error(\n            'The MCP server needs @modelcontextprotocol/sdk. Run it with:\\n  npx -y -p @classic-homes/slides -p @modelcontextprotocol/sdk classic-slides mcp'\n          );\n        }\n        throw e;\n      }\n      return mcp.runStdio(values.root);\n    }\n    default:\n      throw new Error(`Unknown command \"${cmd}\".\\n\\n${HELP}`);\n  }\n}\n\n/** Preview server: renders on every request and reloads the page when the deck folder changes. */\nasync function dev(file: string | undefined, port: number) {\n  if (!file) throw new Error('Usage: classic-slides dev <file.yaml>');\n  const abs = resolve(file);\n  const dir = dirname(abs);\n  const clients = new Set<import('node:http').ServerResponse>();\n  const reload = `<script>new EventSource('/__reload').onmessage=()=>location.reload()</script>`;\n\n  const errorPage = (msg: string) =>\n    `<!doctype html><meta charset=\"utf-8\"><title>Deck error</title><body style=\"font:15px/1.5 ui-monospace,monospace;padding:40px;background:#fdf2f2;color:#7f1d1d\"><h2 style=\"font-family:system-ui\">Deck has problems</h2><pre style=\"white-space:pre-wrap\">${msg\n      .replace(/&/g, '&amp;')\n      .replace(/</g, '&lt;')}</pre>${reload}`;\n\n  createServer(async (req, res) => {\n    if (req.url === '/__reload') {\n      res.writeHead(200, {\n        'content-type': 'text/event-stream',\n        'cache-control': 'no-cache',\n        connection: 'keep-alive',\n      });\n      res.write(': ok\\n\\n');\n      clients.add(res);\n      req.on('close', () => clients.delete(res));\n      return;\n    }\n    let html: string;\n    try {\n      const deck = await loadDeckFile(abs);\n      const r = await renderDeck(deck, {\n        resolveImage: fileImageResolver(dir),\n        embedSource: false,\n      });\n      html = r.html.replace('</body>', `${reload}</body>`);\n      if (r.warnings.length) console.warn(formatIssues(r.warnings));\n    } catch (e) {\n      html = errorPage(\n        e instanceof DeckError ? formatIssues(e.issues) : e instanceof Error ? e.message : String(e)\n      );\n    }\n    res.writeHead(200, { 'content-type': 'text/html; charset=utf-8', 'cache-control': 'no-store' });\n    res.end(html);\n  }).listen(port, () =>\n    console.log(`Previewing ${file} at http://localhost:${port}  (Ctrl+C to stop)`)\n  );\n\n  let timer: NodeJS.Timeout | undefined;\n  watch(dir, { recursive: true }, (_, name) => {\n    if (name && /\\.html$/.test(name)) return;\n    clearTimeout(timer);\n    timer = setTimeout(() => clients.forEach((c) => c.write('data: reload\\n\\n')), 120);\n  });\n}\n\nmain().catch((e) => {\n  console.error(e instanceof DeckError ? e.message : `✖ ${e instanceof Error ? e.message : e}`);\n  process.exit(1);\n});\n"],"mappings":"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","names":[]}

package/dist/echarts-render-2QVSBZ6V.js

@@ -0,0 +1,50 @@
+// src/echarts-render.ts
+import { lightTheme } from "@classic-homes/charts-core/theme";
+import {
+  BarChart,
+  FunnelChart,
+  GaugeChart,
+  LineChart,
+  PieChart,
+  RadarChart,
+  ScatterChart
+} from "echarts/charts";
+import { GridComponent, LegendComponent, RadarComponent } from "echarts/components";
+import * as echarts from "echarts/core";
+import { SVGRenderer } from "echarts/renderers";
+echarts.use([
+  BarChart,
+  FunnelChart,
+  GaugeChart,
+  LineChart,
+  PieChart,
+  RadarChart,
+  ScatterChart,
+  GridComponent,
+  LegendComponent,
+  RadarComponent,
+  SVGRenderer
+]);
+echarts.registerTheme("classic-slides", lightTheme);
+function createRenderer() {
+  return {
+    render(option, width, height) {
+      const chart = echarts.init(null, "classic-slides", {
+        renderer: "svg",
+        ssr: true,
+        width,
+        height
+      });
+      try {
+        chart.setOption(option);
+        return chart.renderToSVGString();
+      } finally {
+        chart.dispose();
+      }
+    }
+  };
+}
+export {
+  createRenderer
+};
+//# sourceMappingURL=echarts-render-2QVSBZ6V.js.map

package/dist/echarts-render-2QVSBZ6V.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  LineChart,\n  PieChart,\n  RadarChart,\n  ScatterChart,\n} from 'echarts/charts';\nimport { GridComponent, LegendComponent, RadarComponent } 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  LineChart,\n  PieChart,\n  RadarChart,\n  ScatterChart,\n  GridComponent,\n  LegendComponent,\n  RadarComponent,\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,OACK;AACP,SAAS,eAAe,iBAAiB,sBAAsB;AAC/D,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;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/index.d.ts

@@ -1,9 +1,11 @@
-export { D as Deck, a as DeckError, b as DeckInput, c as DeckSchema, I as ImageResolver, L as LAYOUTS, d as LayoutDef, e as LayoutIssue, f as LayoutName, R as RenderOptions, g as RenderResult, S as SlideData, h as SlideInput, i as SlideSchema, V as ValidationResult, j as collectImageSources, k as extractDeckSource, l as formatIssues, m as formatPath, n as getLayout, r as renderDeck, v as validateDeck } from './render-CZ4g2fa9.js';
+import { L as LayoutCategory, B as BrandPalette } from './render-DcyKuBRD.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, I as ImageInput, m as ImageResolver, n as ImageValue, o as ItemValue, p as LAYOUTS, q as LAYOUT_CATEGORIES, r as LAYOUT_CATEGORY_ORDER, s as LayoutDef, t as LayoutIssue, u as LayoutName, P as PREVIEW_SIZE, R as RenderOptions, v as RenderResult, w as ResolvedBrand, S as SlideData, x as SlideInput, y as SlideSchema, V as ValidateOptions, z as ValidationResult, A as checkPalette, E as collectImageSources, F as extractDeckSource, G as formatIssues, H as formatPath, J as getLayout, K as renderDeck, M as resolveBrand, N as validateBrandProfile, O as validateDeck } from './render-DcyKuBRD.js';
 import * as zod_to_json_schema from 'zod-to-json-schema';
-import 'zod';
+import { z } from 'zod';
 
 interface LayoutSummary {
     name: string;
+    category: LayoutCategory;
     description: string;
     whenToUse: string;
 }
@@ -33,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 to see them.\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 section dividers and moments of emphasis. Don't put dense content on solid grounds.\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 (`bullets`, `split`, `cards`, `stats`, `photos`, `walkthrough`)\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. 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";
 
 /** Parses deck source text. YAML is a superset of JSON, so both work. */
 declare function parseDeckSource(text: string): unknown;
@@ -82,6 +84,12 @@ declare const PALETTE: {
 };
 /** Horizontal Classic Homes lockup (mark + wordmark), mirrors LogoMain in theme-svelte. Colours follow CSS. */
 declare const LOGO_SVG: string;
+/**
+ * Logo lockup from a name. Classic Homes brands (divisions, studios) keep the
+ * flower mark; partner brands without a logo file get a clean wordmark so
+ * they are never shown under the Classic Homes mark.
+ */
+declare function logoLockup(name: string, withMark?: boolean): string;
 
 /**
  * Slide-level edits on a deck object. Pure functions shared by the MCP
@@ -95,6 +103,18 @@ interface EditableDeck {
 /** A slide reference: its `id`, or its 1-based position. */
 type SlideRef = string | number;
 declare function findSlide(deck: EditableDeck, ref: SlideRef): number;
+/** A short random slide id such as "s-k3f9x2" (valid for the slide `id` field). */
+declare function newSlideId(taken?: ReadonlySet<string>): string;
+/**
+ * Gives every slide without an `id` a stable random one, so comments and
+ * analytics can anchor to slides across edits and reorders. Idempotent;
+ * returns how many ids were added.
+ */
+declare function ensureSlideIds(deck: EditableDeck): number;
+/** Stable key for a slide: its id, or "#<position>" for decks saved before ids existed. */
+declare function slideKey(slide: {
+    id?: unknown;
+}, index: number): string;
 /** Inserts a slide. `position` is 1-based; omitted appends. Returns the new slide's position. */
 declare function addSlide(deck: EditableDeck, slide: Record<string, unknown>, position?: number): number;
 /** Shallow-merges fields into a slide. A field set to null is removed. Changing `layout` replaces the slide. */
@@ -127,9 +147,23 @@ interface FieldBase<K extends string> {
     default?: unknown;
     /** Suggest a textarea rather than a one-line input. */
     multiline?: boolean;
+    /**
+     * Suggests a richer widget; editors that don't know a hint can fall back to `kind`.
+     * - url: https link · video-url: YouTube/Vimeo link
+     * - chart: ChartSpec group (edit labels × series as a grid)
+     * - grid: list of rows of cells (table layout)
+     * - point: {x, y} in % of an image (hotspot picker)
+     */
+    hint?: 'url' | 'video-url' | 'chart' | 'grid' | 'point';
 }
+/** Deck-level fields for a settings panel: brand overrides and presentation settings. */
+declare function deckEditorFields(): {
+    brand: EditorField[];
+    settings: EditorField[];
+};
 interface LayoutEditorInfo {
     name: string;
+    category: LayoutCategory;
     description: string;
     whenToUse: string;
     defaults: {
@@ -145,5 +179,116 @@ interface LayoutEditorInfo {
 declare function commonSlideFields(): EditorField[];
 declare function layoutEditorInfo(name: string): LayoutEditorInfo | undefined;
 declare function allLayoutEditorInfo(): LayoutEditorInfo[];
+/**
+ * Stand-in image for new slides: a neutral frame reading "Add a photo".
+ * It validates (so a fresh slide previews immediately) but lint warns until
+ * it is replaced.
+ */
+declare const PLACEHOLDER_IMAGE: string;
+declare function isPlaceholderImage(src: string | undefined): boolean;
+/**
+ * A new slide for a layout, ready to edit: the layout's example with sample
+ * image paths swapped for {@link PLACEHOLDER_IMAGE}. Always passes validation.
+ */
+declare function blankSlide(name: string): Record<string, unknown> | undefined;
+
+/**
+ * Chart specs for the `chart` layout. Authors describe data, never styling;
+ * this module turns a spec into an ECharts option themed from the brand, and
+ * renders it to static SVG (server-side rendering, no runtime JS) so charts
+ * work offline, in print, in Workers and in the browser alike.
+ *
+ * ECharts is imported lazily (echarts-render.ts) so decks without charts
+ * never load it.
+ */
+
+declare const CHART_TYPES: readonly ["column", "bar", "stacked-column", "stacked-bar", "line", "area", "pie", "donut", "funnel", "gauge", "scatter", "radar"];
+type ChartType = (typeof CHART_TYPES)[number];
+declare const ChartSpec: z.ZodObject<{
+    type: z.ZodEnum<["column", "bar", "stacked-column", "stacked-bar", "line", "area", "pie", "donut", "funnel", "gauge", "scatter", "radar"]>;
+    labels: z.ZodArray<z.ZodString, "many">;
+    series: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        values: z.ZodArray<z.ZodNumber, "many">;
+    }, "strip", z.ZodTypeAny, {
+        values: number[];
+        name: string;
+    }, {
+        values: number[];
+        name: string;
+    }>, "many">;
+    format: z.ZodDefault<z.ZodEnum<["number", "percent", "currency", "compact"]>>;
+    decimals: z.ZodDefault<z.ZodNumber>;
+    unit: z.ZodOptional<z.ZodString>;
+    legend: z.ZodDefault<z.ZodEnum<["auto", "show", "hide"]>>;
+    labelsOnData: z.ZodDefault<z.ZodBoolean>;
+    highlight: z.ZodOptional<z.ZodString>;
+    max: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    type: "column" | "bar" | "stacked-column" | "stacked-bar" | "line" | "area" | "pie" | "donut" | "funnel" | "gauge" | "scatter" | "radar";
+    labels: string[];
+    series: {
+        values: number[];
+        name: string;
+    }[];
+    format: "number" | "percent" | "currency" | "compact";
+    decimals: number;
+    legend: "auto" | "show" | "hide";
+    labelsOnData: boolean;
+    unit?: string | undefined;
+    highlight?: string | undefined;
+    max?: number | undefined;
+}, {
+    type: "column" | "bar" | "stacked-column" | "stacked-bar" | "line" | "area" | "pie" | "donut" | "funnel" | "gauge" | "scatter" | "radar";
+    labels: string[];
+    series: {
+        values: number[];
+        name: string;
+    }[];
+    format?: "number" | "percent" | "currency" | "compact" | undefined;
+    decimals?: number | undefined;
+    unit?: string | undefined;
+    legend?: "auto" | "show" | "hide" | undefined;
+    labelsOnData?: boolean | undefined;
+    highlight?: string | undefined;
+    max?: number | undefined;
+}>;
+type ChartSpecInput = z.input<typeof ChartSpec>;
+type ChartSpecValue = z.output<typeof ChartSpec>;
+declare function formatValue(v: number, spec: Pick<ChartSpecValue, 'format' | 'decimals' | 'unit'>): string;
+/** Builds the ECharts option for a spec. Pure; exported for tests and custom renderers. */
+declare function chartOption(spec: ChartSpecValue, palette?: BrandPalette): Record<string, unknown>;
+/** Renders one chart spec to an accessible, responsive SVG string. */
+declare function renderChartSvg(spec: ChartSpecValue, opts?: {
+    width?: number;
+    height?: number;
+    palette?: BrandPalette;
+    title?: string;
+}): Promise<string>;
+/** Plain-language summary for screen readers. */
+declare function describeChart(spec: ChartSpecValue): string;
+
+/** YouTube / Vimeo URL parsing for the video layout. */
+interface VideoRef {
+    provider: 'youtube' | 'vimeo';
+    id: string;
+    /** Canonical watch URL (used for QR codes and "open" links). */
+    watchUrl: string;
+    /** Poster image URL, when the provider exposes a predictable one. */
+    poster?: string;
+}
+declare function parseVideoUrl(url: string): VideoRef | undefined;
+interface EmbedOptions {
+    start?: number;
+    end?: number;
+    muted?: boolean;
+    captions?: boolean;
+    autoplay?: boolean;
+}
+/** Privacy-friendly player URL (youtube-nocookie, Vimeo with dnt). */
+declare function videoEmbedUrl(ref: VideoRef, o: EmbedOptions): string;
+
+/** CSP source for the inline presenter runtime: script-src '<hash>'. */
+declare const RUNTIME_SCRIPT_HASH = "sha256-oKFaVecqTMnaoeBzefA8f7poigISWe5hotztD1XgJP8=";
 
-export { AUTHORING_GUIDE, type EditableDeck, type EditorField, LOGO_SVG, type LayoutEditorInfo, PALETTE, type SlideRef, addSlide, allLayoutEditorInfo, commonSlideFields, deckJsonSchema, describeLayout, escapeHtml, findSlide, inline, layoutEditorInfo, listLayouts, moveSlide, outline, parseDeckSource, prose, removeSlide, stringifyDeck, updateSlide };
+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, listLayouts, logoLockup, moveSlide, newSlideId, outline, parseDeckSource, parseVideoUrl, prose, removeSlide, renderChartSvg, slideKey, stringifyDeck, updateSlide, videoEmbedUrl };