@classic-homes/slides 0.2.0

package/dist/chunk-TXNQKBWJ.js

@@ -0,0 +1,69 @@
+import {
+  DeckSchema,
+  LAYOUTS,
+  baseSlide,
+  getLayout
+} from "./chunk-TM3TNVHB.js";
+
+// src/catalog.ts
+import { z } from "zod";
+import { zodToJsonSchema } from "zod-to-json-schema";
+function listLayouts() {
+  return LAYOUTS.map((l) => ({ name: 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 to see them.
+- **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 section dividers and moments of emphasis. Don't put dense content on solid grounds.
+
+## 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 (\`bullets\`, \`split\`, \`cards\`, \`stats\`, \`photos\`, \`walkthrough\`)
+4. \`qr\` (where to go next) \u2192 \`contacts\` \u2192 closing \`statement\`
+`;
+
+export {
+  listLayouts,
+  describeLayout,
+  deckJsonSchema,
+  AUTHORING_GUIDE
+};
+//# sourceMappingURL=chunk-TXNQKBWJ.js.map

package/dist/chunk-TXNQKBWJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/catalog.ts"],"sourcesContent":["import { z } from 'zod';\nimport { zodToJsonSchema } from 'zod-to-json-schema';\nimport { LAYOUTS, getLayout } from './layouts/index.js';\nimport { baseSlide } from './schema/common.js';\nimport { DeckSchema } from './schema/deck.js';\n\nexport interface LayoutSummary {\n  name: string;\n  description: string;\n  whenToUse: string;\n}\n\nexport function listLayouts(): LayoutSummary[] {\n  return LAYOUTS.map((l) => ({ name: l.name, description: l.description, whenToUse: l.whenToUse }));\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 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://…)\\`. 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 (\\`bullets\\`, \\`split\\`, \\`cards\\`, \\`stats\\`, \\`photos\\`, \\`walkthrough\\`)\n4. \\`qr\\` (where to go next) → \\`contacts\\` → closing \\`statement\\`\n`;\n"],"mappings":";;;;;;;;AAAA,SAAS,SAAS;AAClB,SAAS,uBAAuB;AAWzB,SAAS,cAA+B;AAC7C,SAAO,QAAQ,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,EAAE,aAAa,WAAW,EAAE,UAAU,EAAE;AAClG;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;","names":[]}

package/dist/chunk-VONVGYRL.js

@@ -0,0 +1,52 @@
+// src/edit.ts
+function findSlide(deck, ref) {
+  const index = typeof ref === "number" || /^\d+$/.test(ref) ? Number(ref) - 1 : deck.slides.findIndex((s) => s.id === ref);
+  if (index < 0 || index >= deck.slides.length) {
+    throw new Error(
+      `No slide "${ref}". The deck has ${deck.slides.length} slides; use a 1-based number or a slide id.`
+    );
+  }
+  return index;
+}
+function addSlide(deck, slide, position) {
+  const at = position === void 0 ? deck.slides.length : Math.max(0, Math.min(deck.slides.length, position - 1));
+  deck.slides.splice(at, 0, slide);
+  return at + 1;
+}
+function updateSlide(deck, ref, patch) {
+  const i = findSlide(deck, ref);
+  const next = patch.layout && patch.layout !== deck.slides[i].layout ? {} : { ...deck.slides[i] };
+  for (const [k, v] of Object.entries(patch)) {
+    if (v === null) delete next[k];
+    else next[k] = v;
+  }
+  deck.slides[i] = next;
+  return i + 1;
+}
+function moveSlide(deck, ref, to) {
+  const from = findSlide(deck, ref);
+  const [slide] = deck.slides.splice(from, 1);
+  const at = Math.max(0, Math.min(deck.slides.length, to - 1));
+  deck.slides.splice(at, 0, slide);
+  return at + 1;
+}
+function removeSlide(deck, ref) {
+  const i = findSlide(deck, ref);
+  return deck.slides.splice(i, 1)[0];
+}
+function outline(deck) {
+  return deck.slides.map((s, i) => {
+    const label = s.title ?? s.quote ?? s.kicker ?? "";
+    return `${i + 1}. [${s.layout}]${s.id ? ` #${s.id}` : ""} ${label}`.trim();
+  });
+}
+
+export {
+  findSlide,
+  addSlide,
+  updateSlide,
+  moveSlide,
+  removeSlide,
+  outline
+};
+//# sourceMappingURL=chunk-VONVGYRL.js.map

package/dist/chunk-VONVGYRL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/edit.ts"],"sourcesContent":["/**\n * Slide-level edits on a deck object. Pure functions shared by the MCP\n * server and (later) the hosted editor, so agents change one slide at a\n * time instead of rewriting whole files.\n */\nexport interface EditableDeck {\n  slides: Record<string, unknown>[];\n  [key: string]: unknown;\n}\n\n/** A slide reference: its `id`, or its 1-based position. */\nexport type SlideRef = string | number;\n\nexport function findSlide(deck: EditableDeck, ref: SlideRef): number {\n  const index =\n    typeof ref === 'number' || /^\\d+$/.test(ref)\n      ? Number(ref) - 1\n      : deck.slides.findIndex((s) => s.id === ref);\n  if (index < 0 || index >= deck.slides.length) {\n    throw new Error(\n      `No slide \"${ref}\". The deck has ${deck.slides.length} slides; use a 1-based number or a slide id.`\n    );\n  }\n  return index;\n}\n\n/** Inserts a slide. `position` is 1-based; omitted appends. Returns the new slide's position. */\nexport function addSlide(\n  deck: EditableDeck,\n  slide: Record<string, unknown>,\n  position?: number\n): number {\n  const at =\n    position === undefined\n      ? deck.slides.length\n      : Math.max(0, Math.min(deck.slides.length, position - 1));\n  deck.slides.splice(at, 0, slide);\n  return at + 1;\n}\n\n/** Shallow-merges fields into a slide. A field set to null is removed. Changing `layout` replaces the slide. */\nexport function updateSlide(\n  deck: EditableDeck,\n  ref: SlideRef,\n  patch: Record<string, unknown>\n): number {\n  const i = findSlide(deck, ref);\n  const next = patch.layout && patch.layout !== deck.slides[i].layout ? {} : { ...deck.slides[i] };\n  for (const [k, v] of Object.entries(patch)) {\n    if (v === null) delete (next as Record<string, unknown>)[k];\n    else (next as Record<string, unknown>)[k] = v;\n  }\n  deck.slides[i] = next;\n  return i + 1;\n}\n\nexport function moveSlide(deck: EditableDeck, ref: SlideRef, to: number): number {\n  const from = findSlide(deck, ref);\n  const [slide] = deck.slides.splice(from, 1);\n  const at = Math.max(0, Math.min(deck.slides.length, to - 1));\n  deck.slides.splice(at, 0, slide);\n  return at + 1;\n}\n\nexport function removeSlide(deck: EditableDeck, ref: SlideRef): Record<string, unknown> {\n  const i = findSlide(deck, ref);\n  return deck.slides.splice(i, 1)[0];\n}\n\n/** One-line outline of each slide, for agents and CLIs. */\nexport function outline(deck: EditableDeck): string[] {\n  return deck.slides.map((s, i) => {\n    const label = (s.title ?? s.quote ?? s.kicker ?? '') as string;\n    return `${i + 1}. [${s.layout}]${s.id ? ` #${s.id}` : ''} ${label}`.trim();\n  });\n}\n"],"mappings":";AAaO,SAAS,UAAU,MAAoB,KAAuB;AACnE,QAAM,QACJ,OAAO,QAAQ,YAAY,QAAQ,KAAK,GAAG,IACvC,OAAO,GAAG,IAAI,IACd,KAAK,OAAO,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG;AAC/C,MAAI,QAAQ,KAAK,SAAS,KAAK,OAAO,QAAQ;AAC5C,UAAM,IAAI;AAAA,MACR,aAAa,GAAG,mBAAmB,KAAK,OAAO,MAAM;AAAA,IACvD;AAAA,EACF;AACA,SAAO;AACT;AAGO,SAAS,SACd,MACA,OACA,UACQ;AACR,QAAM,KACJ,aAAa,SACT,KAAK,OAAO,SACZ,KAAK,IAAI,GAAG,KAAK,IAAI,KAAK,OAAO,QAAQ,WAAW,CAAC,CAAC;AAC5D,OAAK,OAAO,OAAO,IAAI,GAAG,KAAK;AAC/B,SAAO,KAAK;AACd;AAGO,SAAS,YACd,MACA,KACA,OACQ;AACR,QAAM,IAAI,UAAU,MAAM,GAAG;AAC7B,QAAM,OAAO,MAAM,UAAU,MAAM,WAAW,KAAK,OAAO,CAAC,EAAE,SAAS,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,EAAE;AAC/F,aAAW,CAAC,GAAG,CAAC,KAAK,OAAO,QAAQ,KAAK,GAAG;AAC1C,QAAI,MAAM,KAAM,QAAQ,KAAiC,CAAC;AAAA,QACrD,CAAC,KAAiC,CAAC,IAAI;AAAA,EAC9C;AACA,OAAK,OAAO,CAAC,IAAI;AACjB,SAAO,IAAI;AACb;AAEO,SAAS,UAAU,MAAoB,KAAe,IAAoB;AAC/E,QAAM,OAAO,UAAU,MAAM,GAAG;AAChC,QAAM,CAAC,KAAK,IAAI,KAAK,OAAO,OAAO,MAAM,CAAC;AAC1C,QAAM,KAAK,KAAK,IAAI,GAAG,KAAK,IAAI,KAAK,OAAO,QAAQ,KAAK,CAAC,CAAC;AAC3D,OAAK,OAAO,OAAO,IAAI,GAAG,KAAK;AAC/B,SAAO,KAAK;AACd;AAEO,SAAS,YAAY,MAAoB,KAAwC;AACtF,QAAM,IAAI,UAAU,MAAM,GAAG;AAC7B,SAAO,KAAK,OAAO,OAAO,GAAG,CAAC,EAAE,CAAC;AACnC;AAGO,SAAS,QAAQ,MAA8B;AACpD,SAAO,KAAK,OAAO,IAAI,CAAC,GAAG,MAAM;AAC/B,UAAM,QAAS,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU;AACjD,WAAO,GAAG,IAAI,CAAC,MAAM,EAAE,MAAM,IAAI,EAAE,KAAK,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,KAAK,GAAG,KAAK;AAAA,EAC3E,CAAC;AACH;","names":[]}

package/dist/cli.js

@@ -0,0 +1,167 @@
+#!/usr/bin/env node
+import {
+  AUTHORING_GUIDE,
+  deckJsonSchema,
+  describeLayout,
+  listLayouts
+} from "./chunk-TXNQKBWJ.js";
+import {
+  buildDeckFile,
+  fileImageResolver,
+  loadDeckFile
+} from "./chunk-CKVKX2ZD.js";
+import {
+  DeckError,
+  formatIssues,
+  renderDeck,
+  validateDeck
+} from "./chunk-TM3TNVHB.js";
+
+// src/node/cli.ts
+import { watch } from "fs";
+import { access, copyFile, mkdir } from "fs/promises";
+import { createServer } from "http";
+import { basename, dirname, join, resolve } from "path";
+import { fileURLToPath } from "url";
+import { parseArgs } from "util";
+var HELP = `classic-slides \u2014 branded Classic Homes presentations
+
+Usage
+  classic-slides new <file.yaml> [--starter basic|journey]  Start a deck from a starter
+  classic-slides build <file.yaml> [-o out.html]            Render one self-contained HTML file
+  classic-slides dev <file.yaml> [--port 4321]              Live preview; reloads on save
+  classic-slides validate <file.yaml>                       Check for errors and crowded slides
+  classic-slides layouts [name]                             List layouts, or show one in detail
+  classic-slides guide                                      Print the authoring guide
+  classic-slides schema                                     Print the deck JSON Schema
+  classic-slides mcp [--root dir]                           Run the MCP server on stdio
+`;
+var pkgRoot = resolve(dirname(fileURLToPath(import.meta.url)), "..");
+async function main() {
+  const { positionals, values } = parseArgs({
+    allowPositionals: true,
+    options: {
+      out: { type: "string", short: "o" },
+      port: { type: "string", default: "4321" },
+      starter: { type: "string", default: "basic" },
+      root: { type: "string" },
+      help: { type: "boolean", short: "h" }
+    }
+  });
+  const [cmd, arg] = positionals;
+  if (!cmd || values.help) return void process.stdout.write(HELP);
+  switch (cmd) {
+    case "new": {
+      if (!arg) throw new Error("Usage: classic-slides new <file.yaml>");
+      const target = resolve(arg.endsWith(".yaml") || arg.endsWith(".yml") ? arg : `${arg}.yaml`);
+      if (await access(target).then(
+        () => true,
+        () => false
+      ))
+        throw new Error(`${target} already exists.`);
+      const starter = join(pkgRoot, "starters", `${values.starter}.yaml`);
+      await mkdir(dirname(target), { recursive: true });
+      await copyFile(starter, target);
+      console.log(`Created ${target}
+Next: classic-slides dev ${basename(target)}`);
+      return;
+    }
+    case "build": {
+      if (!arg) throw new Error("Usage: classic-slides build <file.yaml>");
+      const r = await buildDeckFile(arg, {
+        out: values.out,
+        onWarning: (w) => console.warn(`\u26A0 ${w}`)
+      });
+      if (r.warnings.length) console.warn(formatIssues(r.warnings));
+      console.log(`\u2714 ${r.out} \u2014 ${r.slideCount} slides, ${(r.bytes / 1024 / 1024).toFixed(2)} MB`);
+      return;
+    }
+    case "validate": {
+      if (!arg) throw new Error("Usage: classic-slides validate <file.yaml>");
+      const v = validateDeck(await loadDeckFile(resolve(arg)));
+      console.log(v.issues.length ? formatIssues(v.issues) : "\u2714 Valid, no warnings");
+      process.exitCode = v.ok ? 0 : 1;
+      return;
+    }
+    case "dev":
+      return dev(arg, Number(values.port));
+    case "layouts": {
+      if (arg) {
+        const d = describeLayout(arg);
+        if (!d) throw new Error(`Unknown layout "${arg}".`);
+        console.log(JSON.stringify(d, null, 2));
+      } else {
+        for (const l of listLayouts())
+          console.log(
+            `${l.name.padEnd(12)} ${l.description}
+${"".padEnd(12)} Use for: ${l.whenToUse}
+`
+          );
+      }
+      return;
+    }
+    case "guide":
+      return void console.log(AUTHORING_GUIDE);
+    case "schema":
+      return void console.log(JSON.stringify(deckJsonSchema(), null, 2));
+    case "mcp": {
+      const { runStdio } = await import("./mcp-5R6YD3QW.js");
+      return runStdio(values.root);
+    }
+    default:
+      throw new Error(`Unknown command "${cmd}".
+
+${HELP}`);
+  }
+}
+async function dev(file, port) {
+  if (!file) throw new Error("Usage: classic-slides dev <file.yaml>");
+  const abs = resolve(file);
+  const dir = dirname(abs);
+  const clients = /* @__PURE__ */ new Set();
+  const reload = `<script>new EventSource('/__reload').onmessage=()=>location.reload()</script>`;
+  const errorPage = (msg) => `<!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.replace(/&/g, "&amp;").replace(/</g, "&lt;")}</pre>${reload}`;
+  createServer(async (req, res) => {
+    if (req.url === "/__reload") {
+      res.writeHead(200, {
+        "content-type": "text/event-stream",
+        "cache-control": "no-cache",
+        connection: "keep-alive"
+      });
+      res.write(": ok\n\n");
+      clients.add(res);
+      req.on("close", () => clients.delete(res));
+      return;
+    }
+    let html;
+    try {
+      const deck = await loadDeckFile(abs);
+      const r = await renderDeck(deck, {
+        resolveImage: fileImageResolver(dir),
+        embedSource: false
+      });
+      html = r.html.replace("</body>", `${reload}</body>`);
+      if (r.warnings.length) console.warn(formatIssues(r.warnings));
+    } catch (e) {
+      html = errorPage(
+        e instanceof DeckError ? formatIssues(e.issues) : e instanceof Error ? e.message : String(e)
+      );
+    }
+    res.writeHead(200, { "content-type": "text/html; charset=utf-8", "cache-control": "no-store" });
+    res.end(html);
+  }).listen(
+    port,
+    () => console.log(`Previewing ${file} at http://localhost:${port}  (Ctrl+C to stop)`)
+  );
+  let timer;
+  watch(dir, { recursive: true }, (_, name) => {
+    if (name && /\.html$/.test(name)) return;
+    clearTimeout(timer);
+    timer = setTimeout(() => clients.forEach((c) => c.write("data: reload\n\n")), 120);
+  });
+}
+main().catch((e) => {
+  console.error(e instanceof DeckError ? e.message : `\u2716 ${e instanceof Error ? e.message : e}`);
+  process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +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":[]}

package/dist/index.d.ts

@@ -0,0 +1,149 @@
+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 * as zod_to_json_schema from 'zod-to-json-schema';
+import 'zod';
+
+interface LayoutSummary {
+    name: string;
+    description: string;
+    whenToUse: string;
+}
+declare function listLayouts(): LayoutSummary[];
+/** Full description of one layout: fields as JSON Schema plus a working example. */
+declare function describeLayout(name: string): {
+    name: string;
+    description: string;
+    whenToUse: string;
+    defaults: {
+        background?: string;
+        track?: "value" | "build" | "neutral";
+    };
+    schema: zod_to_json_schema.JsonSchema7Type & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: zod_to_json_schema.JsonSchema7Type;
+        } | undefined;
+    };
+    example: Record<string, unknown>;
+} | undefined;
+/** JSON Schema for a whole deck (editor tooling, `$schema` in deck files). */
+declare function deckJsonSchema(): zod_to_json_schema.JsonSchema7Type & {
+    $schema?: string | undefined;
+    definitions?: {
+        [key: string]: 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";
+
+/** Parses deck source text. YAML is a superset of JSON, so both work. */
+declare function parseDeckSource(text: string): unknown;
+/** Serializes a deck back to YAML, the human-editable format. */
+declare function stringifyDeck(deck: unknown): string;
+
+/**
+ * Inline text formatting for slide copy and speaker notes.
+ *
+ * Deck text is never raw HTML: authors and agents write a tiny markdown subset
+ * and everything else is escaped. That keeps decks on-brand (no inline styles)
+ * and makes rendered output safe to publish.
+ *
+ *   **bold**        → <b>          (strong ink colour)
+ *   *highlight*     → <em class="hl"> (track accent colour)
+ *   `code`          → <code>
+ *   [label](url)    → <a>          (http/https/mailto/tel only)
+ *   single newline  → <br>
+ */
+declare function escapeHtml(value: string): string;
+/** Formats one run of inline text. Newlines become line breaks. */
+declare function inline(text: string | undefined | null): string;
+/**
+ * Formats a block of prose (speaker notes, long captions): blank lines split
+ * paragraphs, lines starting with "- " become a bullet list.
+ */
+declare function prose(text: string | undefined | null): string;
+
+/**
+ * Slide palette. Mostly brand tokens used as-is; the few surface tints
+ * (paper, soft accents) are deck-specific and derived here.
+ */
+declare const PALETTE: {
+    readonly red: "#a91c22";
+    readonly redLogo: "#e02726";
+    readonly teal: "#236265";
+    readonly tealFill: "#236265";
+    readonly navy: "#002e3f";
+    readonly plum: "#5e2c41";
+    readonly sage: "#969a82";
+    readonly stone: "#676d69";
+    readonly grey: "#4f4f4f";
+    readonly ink: "#002e3f";
+    readonly inkSoft: "#4f4f4f";
+    readonly inkFaint: "#7a7a7a";
+};
+/** Horizontal Classic Homes lockup (mark + wordmark), mirrors LogoMain in theme-svelte. Colours follow CSS. */
+declare const LOGO_SVG: string;
+
+/**
+ * Slide-level edits on a deck object. Pure functions shared by the MCP
+ * server and (later) the hosted editor, so agents change one slide at a
+ * time instead of rewriting whole files.
+ */
+interface EditableDeck {
+    slides: Record<string, unknown>[];
+    [key: string]: unknown;
+}
+/** A slide reference: its `id`, or its 1-based position. */
+type SlideRef = string | number;
+declare function findSlide(deck: EditableDeck, ref: SlideRef): number;
+/** 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. */
+declare function updateSlide(deck: EditableDeck, ref: SlideRef, patch: Record<string, unknown>): number;
+declare function moveSlide(deck: EditableDeck, ref: SlideRef, to: number): number;
+declare function removeSlide(deck: EditableDeck, ref: SlideRef): Record<string, unknown>;
+/** One-line outline of each slide, for agents and CLIs. */
+declare function outline(deck: EditableDeck): string[];
+
+type EditorField = FieldBase<'inline'> | FieldBase<'string'> | (FieldBase<'enum'> & {
+    options: (string | number)[];
+}) | FieldBase<'boolean'> | (FieldBase<'number'> & {
+    min?: number;
+    max?: number;
+    integer: boolean;
+}) | FieldBase<'image'> | FieldBase<'item'> | (FieldBase<'list'> & {
+    of: EditorField;
+    min?: number;
+    max?: number;
+}) | (FieldBase<'group'> & {
+    fields: EditorField[];
+});
+interface FieldBase<K extends string> {
+    kind: K;
+    /** Property name ('' for list elements). */
+    key: string;
+    label: string;
+    description?: string;
+    required: boolean;
+    default?: unknown;
+    /** Suggest a textarea rather than a one-line input. */
+    multiline?: boolean;
+}
+interface LayoutEditorInfo {
+    name: string;
+    description: string;
+    whenToUse: string;
+    defaults: {
+        background?: string;
+        track?: string;
+    };
+    /** Layout-specific fields, in declaration order. */
+    fields: EditorField[];
+    /** A valid starting slide for this layout. */
+    example: Record<string, unknown>;
+}
+/** Fields shared by every slide (track, background, notes, step…). */
+declare function commonSlideFields(): EditorField[];
+declare function layoutEditorInfo(name: string): LayoutEditorInfo | undefined;
+declare function allLayoutEditorInfo(): LayoutEditorInfo[];
+
+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 };

package/dist/index.js

@@ -0,0 +1,190 @@
+import {
+  addSlide,
+  findSlide,
+  moveSlide,
+  outline,
+  removeSlide,
+  updateSlide
+} from "./chunk-VONVGYRL.js";
+import {
+  AUTHORING_GUIDE,
+  deckJsonSchema,
+  describeLayout,
+  listLayouts
+} from "./chunk-TXNQKBWJ.js";
+import {
+  DeckError,
+  DeckSchema,
+  Image,
+  Item,
+  LAYOUTS,
+  LOGO_SVG,
+  PALETTE,
+  SlideSchema,
+  Text,
+  baseSlide,
+  collectImageSources,
+  escapeHtml,
+  extractDeckSource,
+  formatIssues,
+  formatPath,
+  getLayout,
+  inline,
+  parseDeckSource,
+  prose,
+  renderDeck,
+  stringifyDeck,
+  validateDeck
+} from "./chunk-TM3TNVHB.js";
+
+// src/editor.ts
+import { z } from "zod";
+var MULTILINE = /* @__PURE__ */ new Set(["lead", "body", "text", "quote", "footnote", "sub", "notes", "caption"]);
+var LABELS = {
+  eyebrowSub: "Eyebrow subtitle",
+  showJourney: "Show journey strip",
+  stepDone: "Step completed",
+  mediaSide: "Photo side",
+  imageAspect: "Photo shape",
+  numberFrom: "First badge number",
+  url: "URL",
+  id: "Slide id"
+};
+function labelFor(key) {
+  if (LABELS[key]) return LABELS[key];
+  const words = key.replace(/([A-Z])/g, " $1").toLowerCase();
+  return words.charAt(0).toUpperCase() + words.slice(1);
+}
+function unwrap(schema) {
+  let s = schema;
+  let required = true;
+  let dflt;
+  let description = schema.description;
+  for (; ; ) {
+    description ??= s.description;
+    if (s instanceof z.ZodOptional || s instanceof z.ZodNullable) {
+      required = false;
+      s = s.unwrap();
+    } else if (s instanceof z.ZodDefault) {
+      required = false;
+      dflt = s._def.defaultValue();
+      s = s._def.innerType;
+    } else break;
+  }
+  return { inner: s, required, default: dflt, description };
+}
+function isText(s) {
+  return s === Text || s instanceof z.ZodString && s.description === Text.description;
+}
+function describeField(key, schema) {
+  const { inner, required, default: dflt, description } = unwrap(schema);
+  const base = {
+    key,
+    label: labelFor(key),
+    required,
+    ...description ? { description } : {},
+    ...dflt !== void 0 ? { default: dflt } : {},
+    ...MULTILINE.has(key) ? { multiline: true } : {}
+  };
+  if (inner === Image) return { ...base, kind: "image" };
+  if (inner === Item) return { ...base, kind: "item" };
+  if (isText(inner)) return { ...base, kind: "inline" };
+  if (inner instanceof z.ZodString) return { ...base, kind: "string" };
+  if (inner instanceof z.ZodBoolean) return { ...base, kind: "boolean" };
+  if (inner instanceof z.ZodEnum) return { ...base, kind: "enum", options: [...inner.options] };
+  if (inner instanceof z.ZodLiteral) return { ...base, kind: "enum", options: [inner.value] };
+  if (inner instanceof z.ZodNumber) {
+    return {
+      ...base,
+      kind: "number",
+      integer: inner.isInt,
+      ...inner.minValue !== null ? { min: inner.minValue } : {},
+      ...inner.maxValue !== null ? { max: inner.maxValue } : {}
+    };
+  }
+  if (inner instanceof z.ZodUnion) {
+    const opts = inner.options;
+    if (opts.every((o) => o instanceof z.ZodLiteral)) {
+      return {
+        ...base,
+        kind: "enum",
+        options: opts.map((o) => o.value)
+      };
+    }
+    return { ...base, kind: "string" };
+  }
+  if (inner instanceof z.ZodArray) {
+    const el = inner.element;
+    return {
+      ...base,
+      kind: "list",
+      of: { ...describeField("", el), label: labelFor(key.replace(/s$/, "")) },
+      ...inner._def.minLength ? { min: inner._def.minLength.value } : {},
+      ...inner._def.maxLength ? { max: inner._def.maxLength.value } : {}
+    };
+  }
+  if (inner instanceof z.ZodObject) {
+    return {
+      ...base,
+      kind: "group",
+      fields: Object.entries(inner.shape).map(
+        ([k, v]) => describeField(k, v)
+      )
+    };
+  }
+  return { ...base, kind: "string" };
+}
+function commonSlideFields() {
+  return Object.entries(baseSlide).map(([k, v]) => describeField(k, v));
+}
+function layoutEditorInfo(name) {
+  const layout = getLayout(name);
+  if (!layout) return void 0;
+  return {
+    name: layout.name,
+    description: layout.description,
+    whenToUse: layout.whenToUse,
+    defaults: layout.defaults ?? {},
+    fields: Object.entries(layout.shape).map(
+      ([k, v]) => describeField(k, v)
+    ),
+    example: layout.example
+  };
+}
+function allLayoutEditorInfo() {
+  return LAYOUTS.map((l) => layoutEditorInfo(l.name));
+}
+export {
+  AUTHORING_GUIDE,
+  DeckError,
+  DeckSchema,
+  LAYOUTS,
+  LOGO_SVG,
+  PALETTE,
+  SlideSchema,
+  addSlide,
+  allLayoutEditorInfo,
+  collectImageSources,
+  commonSlideFields,
+  deckJsonSchema,
+  describeLayout,
+  escapeHtml,
+  extractDeckSource,
+  findSlide,
+  formatIssues,
+  formatPath,
+  getLayout,
+  inline,
+  layoutEditorInfo,
+  listLayouts,
+  moveSlide,
+  outline,
+  parseDeckSource,
+  prose,
+  removeSlide,
+  renderDeck,
+  stringifyDeck,
+  updateSlide,
+  validateDeck
+};
+//# sourceMappingURL=index.js.map