@classic-homes/slides 0.2.1 → 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-33EPZMT6.js";
+} from "./chunk-YI7A4EWX.js";
 import {
   buildDeckFile,
   fileImageResolver,
   loadDeckFile
-} from "./chunk-MYY5GZC2.js";
+} from "./chunk-2IPLZ3SA.js";
 import {
   DeckError,
   formatIssues,
   renderDeck,
   validateDeck
-} from "./chunk-7FROOJCY.js";
+} from "./chunk-GXGDPBAR.js";
 
 // src/node/cli.ts
 import { watch } from "fs";
@@ -107,7 +107,7 @@ ${"".padEnd(12)} Use for: ${l.whenToUse}
     case "mcp": {
       let mcp;
       try {
-        mcp = await import("./mcp-DGMQTIQI.js");
+        mcp = await import("./mcp-PUA45IS7.js");
       } catch (e) {
         if (e.code === "ERR_MODULE_NOT_FOUND") {
           throw new Error(

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, P as PREVIEW_SIZE, 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-DTz7tLKM.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: {
@@ -158,4 +192,103 @@ declare function isPlaceholderImage(src: string | undefined): boolean;
  */
 declare function blankSlide(name: string): Record<string, unknown> | undefined;
 
-export { AUTHORING_GUIDE, type EditableDeck, type EditorField, LOGO_SVG, type LayoutEditorInfo, PALETTE, PLACEHOLDER_IMAGE, type SlideRef, addSlide, allLayoutEditorInfo, blankSlide, commonSlideFields, deckJsonSchema, describeLayout, escapeHtml, findSlide, inline, isPlaceholderImage, layoutEditorInfo, listLayouts, moveSlide, outline, parseDeckSource, prose, removeSlide, stringifyDeck, updateSlide };
+/**
+ * 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, 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 };

package/dist/index.js

@@ -1,79 +1,129 @@
-import {
-  addSlide,
-  findSlide,
-  moveSlide,
-  outline,
-  removeSlide,
-  updateSlide
-} from "./chunk-VONVGYRL.js";
 import {
   AUTHORING_GUIDE,
   deckJsonSchema,
   describeLayout,
   listLayouts
-} from "./chunk-33EPZMT6.js";
+} from "./chunk-YI7A4EWX.js";
 import {
+  BrandPaletteSchema,
+  BrandProfileSchema,
+  CHART_TYPES,
+  CLASSIC_HOMES_BRAND,
+  CLASSIC_HOMES_PALETTE,
+  ChartSpec,
+  DeckBrandSchema,
   DeckError,
   DeckSchema,
+  DeckSettingsSchema,
   LAYOUTS,
+  LAYOUT_CATEGORIES,
+  LAYOUT_CATEGORY_ORDER,
   LOGO_SVG,
   PALETTE,
   PLACEHOLDER_IMAGE,
   PREVIEW_SIZE,
   SlideSchema,
+  addSlide,
   allLayoutEditorInfo,
   blankSlide,
+  chartOption,
+  checkPalette,
   collectImageSources,
   commonSlideFields,
+  deckEditorFields,
+  describeChart,
+  ensureSlideIds,
   escapeHtml,
   extractDeckSource,
+  findSlide,
   formatIssues,
   formatPath,
+  formatValue,
   getLayout,
   inline,
   isPlaceholderImage,
   layoutEditorInfo,
+  logoLockup,
+  moveSlide,
+  newSlideId,
+  outline,
   parseDeckSource,
+  parseVideoUrl,
   prose,
+  removeSlide,
+  renderChartSvg,
   renderDeck,
+  resolveBrand,
+  slideKey,
   stringifyDeck,
-  validateDeck
-} from "./chunk-7FROOJCY.js";
+  updateSlide,
+  validateBrandProfile,
+  validateDeck,
+  videoEmbedUrl
+} from "./chunk-GXGDPBAR.js";
+
+// src/generated/runtime-hash.ts
+var RUNTIME_SCRIPT_HASH = "sha256-oKFaVecqTMnaoeBzefA8f7poigISWe5hotztD1XgJP8=";
 export {
   AUTHORING_GUIDE,
+  BrandPaletteSchema,
+  BrandProfileSchema,
+  CHART_TYPES,
+  CLASSIC_HOMES_BRAND,
+  CLASSIC_HOMES_PALETTE,
+  ChartSpec,
+  DeckBrandSchema,
   DeckError,
   DeckSchema,
+  DeckSettingsSchema,
   LAYOUTS,
+  LAYOUT_CATEGORIES,
+  LAYOUT_CATEGORY_ORDER,
   LOGO_SVG,
   PALETTE,
   PLACEHOLDER_IMAGE,
   PREVIEW_SIZE,
+  RUNTIME_SCRIPT_HASH,
   SlideSchema,
   addSlide,
   allLayoutEditorInfo,
   blankSlide,
+  chartOption,
+  checkPalette,
   collectImageSources,
   commonSlideFields,
+  deckEditorFields,
   deckJsonSchema,
+  describeChart,
   describeLayout,
+  ensureSlideIds,
   escapeHtml,
   extractDeckSource,
   findSlide,
   formatIssues,
   formatPath,
+  formatValue,
   getLayout,
   inline,
   isPlaceholderImage,
   layoutEditorInfo,
   listLayouts,
+  logoLockup,
   moveSlide,
+  newSlideId,
   outline,
   parseDeckSource,
+  parseVideoUrl,
   prose,
   removeSlide,
+  renderChartSvg,
   renderDeck,
+  resolveBrand,
+  slideKey,
   stringifyDeck,
   updateSlide,
-  validateDeck
+  validateBrandProfile,
+  validateDeck,
+  videoEmbedUrl
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","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-oKFaVecqTMnaoeBzefA8f7poigISWe5hotztD1XgJP8=';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEO,IAAM,sBAAsB;","names":[]}

package/dist/{mcp-DGMQTIQI.js → mcp-PUA45IS7.js}

@@ -1,25 +1,24 @@
-import {
-  addSlide,
-  moveSlide,
-  outline,
-  removeSlide,
-  updateSlide
-} from "./chunk-VONVGYRL.js";
 import {
   AUTHORING_GUIDE,
   describeLayout,
   listLayouts
-} from "./chunk-33EPZMT6.js";
+} from "./chunk-YI7A4EWX.js";
 import {
   buildDeckFile,
+  confinedPath,
   loadDeckFile,
   saveDeckFile
-} from "./chunk-MYY5GZC2.js";
+} from "./chunk-2IPLZ3SA.js";
 import {
+  addSlide,
   formatIssues,
+  moveSlide,
+  outline,
+  removeSlide,
   stringifyDeck,
+  updateSlide,
   validateDeck
-} from "./chunk-7FROOJCY.js";
+} from "./chunk-GXGDPBAR.js";
 
 // src/node/mcp.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -41,7 +40,7 @@ function createSlidesMcpServer(rootDir = process.cwd()) {
       throw new Error(`Path "${p}" is outside the deck root ${root}.`);
     if (!/\.(ya?ml|json)$/i.test(abs))
       throw new Error("Deck files must end in .yaml, .yml or .json.");
-    return abs;
+    return confinedPath(root, abs);
   }
   async function load(p) {
     const abs = safePath(p);
@@ -61,7 +60,7 @@ Fix the fields and try again.`,
         true
       );
     }
-    await saveDeckFile(abs, deck);
+    await saveDeckFile(confinedPath(root, abs), deck);
     const warnings = v.issues.filter((i) => i.level === "warning");
     return text(
       `${done}
@@ -252,7 +251,11 @@ ${formatIssues(v.issues)}`,
           throw new Error("out must be an .html path inside the deck root.");
       }
       const warnings = [];
-      const r = await buildDeckFile(abs, { out: outAbs, onWarning: (w) => warnings.push(w) });
+      const r = await buildDeckFile(abs, {
+        out: outAbs,
+        rootDir: root,
+        onWarning: (w) => warnings.push(w)
+      });
       return text(
         `Built ${relative(root, r.out)} \u2014 ${r.slideCount} slides, ${(r.bytes / 1024 / 1024).toFixed(2)} MB. Open it in a browser to present (N = notes, F = fullscreen).${warnings.length ? `
 
@@ -317,4 +320,4 @@ export {
   createSlidesMcpServer,
   runStdio
 };
-//# sourceMappingURL=mcp-DGMQTIQI.js.map
+//# sourceMappingURL=mcp-PUA45IS7.js.map