@classic-homes/slides 0.2.0 → 0.2.1

package/dist/{chunk-CKVKX2ZD.js → chunk-MYY5GZC2.js}

@@ -2,7 +2,7 @@ import {
   parseDeckSource,
   renderDeck,
   stringifyDeck
-} from "./chunk-TM3TNVHB.js";
+} from "./chunk-7FROOJCY.js";
 
 // src/node/index.ts
 import { readFile, stat, writeFile } from "fs/promises";
@@ -73,4 +73,4 @@ export {
   saveDeckFile,
   buildDeckFile
 };
-//# sourceMappingURL=chunk-CKVKX2ZD.js.map
+//# sourceMappingURL=chunk-MYY5GZC2.js.map

package/dist/cli.js

@@ -4,18 +4,18 @@ import {
   deckJsonSchema,
   describeLayout,
   listLayouts
-} from "./chunk-TXNQKBWJ.js";
+} from "./chunk-33EPZMT6.js";
 import {
   buildDeckFile,
   fileImageResolver,
   loadDeckFile
-} from "./chunk-CKVKX2ZD.js";
+} from "./chunk-MYY5GZC2.js";
 import {
   DeckError,
   formatIssues,
   renderDeck,
   validateDeck
-} from "./chunk-TM3TNVHB.js";
+} from "./chunk-7FROOJCY.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-DGMQTIQI.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/index.d.ts

@@ -1,4 +1,4 @@
-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';
+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 * as zod_to_json_schema from 'zod-to-json-schema';
 import 'zod';
 
@@ -145,5 +145,17 @@ 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;
 
-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, 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 };

package/dist/index.js

@@ -11,149 +11,34 @@ import {
   deckJsonSchema,
   describeLayout,
   listLayouts
-} from "./chunk-TXNQKBWJ.js";
+} from "./chunk-33EPZMT6.js";
 import {
   DeckError,
   DeckSchema,
-  Image,
-  Item,
   LAYOUTS,
   LOGO_SVG,
   PALETTE,
+  PLACEHOLDER_IMAGE,
+  PREVIEW_SIZE,
   SlideSchema,
-  Text,
-  baseSlide,
+  allLayoutEditorInfo,
+  blankSlide,
   collectImageSources,
+  commonSlideFields,
   escapeHtml,
   extractDeckSource,
   formatIssues,
   formatPath,
   getLayout,
   inline,
+  isPlaceholderImage,
+  layoutEditorInfo,
   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));
-}
+} from "./chunk-7FROOJCY.js";
 export {
   AUTHORING_GUIDE,
   DeckError,
@@ -161,9 +46,12 @@ export {
   LAYOUTS,
   LOGO_SVG,
   PALETTE,
+  PLACEHOLDER_IMAGE,
+  PREVIEW_SIZE,
   SlideSchema,
   addSlide,
   allLayoutEditorInfo,
+  blankSlide,
   collectImageSources,
   commonSlideFields,
   deckJsonSchema,
@@ -175,6 +63,7 @@ export {
   formatPath,
   getLayout,
   inline,
+  isPlaceholderImage,
   layoutEditorInfo,
   listLayouts,
   moveSlide,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/editor.ts"],"sourcesContent":["/**\n * Form metadata for editors. Walks each layout's zod shape and describes its\n * fields as simple widget descriptors, so a UI can build a form for any\n * layout without understanding zod or JSON Schema.\n */\nimport { z } from 'zod';\nimport { getLayout, LAYOUTS } from './layouts/index.js';\nimport { baseSlide, Image, Item, Text } from './schema/common.js';\n\nexport type EditorField =\n  | FieldBase<'inline'> // formatted text (**bold**, *highlight*, links)\n  | FieldBase<'string'>\n  | (FieldBase<'enum'> & { options: (string | number)[] })\n  | FieldBase<'boolean'>\n  | (FieldBase<'number'> & { min?: number; max?: number; integer: boolean })\n  | FieldBase<'image'>\n  | FieldBase<'item'> // { text, sub? } bullet\n  | (FieldBase<'list'> & { of: EditorField; min?: number; max?: number })\n  | (FieldBase<'group'> & { fields: EditorField[] });\n\ninterface FieldBase<K extends string> {\n  kind: K;\n  /** Property name ('' for list elements). */\n  key: string;\n  label: string;\n  description?: string;\n  required: boolean;\n  default?: unknown;\n  /** Suggest a textarea rather than a one-line input. */\n  multiline?: boolean;\n}\n\nconst MULTILINE = new Set(['lead', 'body', 'text', 'quote', 'footnote', 'sub', 'notes', 'caption']);\nconst LABELS: Record<string, string> = {\n  eyebrowSub: 'Eyebrow subtitle',\n  showJourney: 'Show journey strip',\n  stepDone: 'Step completed',\n  mediaSide: 'Photo side',\n  imageAspect: 'Photo shape',\n  numberFrom: 'First badge number',\n  url: 'URL',\n  id: 'Slide id',\n};\n\nfunction labelFor(key: string): string {\n  if (LABELS[key]) return LABELS[key];\n  const words = key.replace(/([A-Z])/g, ' $1').toLowerCase();\n  return words.charAt(0).toUpperCase() + words.slice(1);\n}\n\ntype AnyZod = z.ZodTypeAny;\n\nfunction unwrap(schema: AnyZod): {\n  inner: AnyZod;\n  required: boolean;\n  default?: unknown;\n  description?: string;\n} {\n  let s = schema;\n  let required = true;\n  let dflt: unknown;\n  let description = schema.description;\n  for (;;) {\n    description ??= s.description;\n    if (s instanceof z.ZodOptional || s instanceof z.ZodNullable) {\n      required = false;\n      s = s.unwrap();\n    } else if (s instanceof z.ZodDefault) {\n      required = false;\n      dflt = s._def.defaultValue();\n      s = s._def.innerType;\n    } else break;\n  }\n  return { inner: s, required, default: dflt, description };\n}\n\nfunction isText(s: AnyZod): boolean {\n  // Text may have been re-described (.describe clones), so compare by checks too.\n  return s === Text || (s instanceof z.ZodString && s.description === Text.description);\n}\n\nfunction describeField(key: string, schema: AnyZod): EditorField {\n  const { inner, required, default: dflt, description } = unwrap(schema);\n  const base = {\n    key,\n    label: labelFor(key),\n    required,\n    ...(description ? { description } : {}),\n    ...(dflt !== undefined ? { default: dflt } : {}),\n    ...(MULTILINE.has(key) ? { multiline: true } : {}),\n  };\n\n  if (inner === Image) return { ...base, kind: 'image' };\n  if (inner === Item) return { ...base, kind: 'item' };\n  if (isText(inner)) return { ...base, kind: 'inline' };\n  if (inner instanceof z.ZodString) return { ...base, kind: 'string' };\n  if (inner instanceof z.ZodBoolean) return { ...base, kind: 'boolean' };\n  if (inner instanceof z.ZodEnum) return { ...base, kind: 'enum', options: [...inner.options] };\n  if (inner instanceof z.ZodLiteral) return { ...base, kind: 'enum', options: [inner.value] };\n  if (inner instanceof z.ZodNumber) {\n    return {\n      ...base,\n      kind: 'number',\n      integer: inner.isInt,\n      ...(inner.minValue !== null ? { min: inner.minValue } : {}),\n      ...(inner.maxValue !== null ? { max: inner.maxValue } : {}),\n    };\n  }\n  if (inner instanceof z.ZodUnion) {\n    const opts = inner.options as AnyZod[];\n    if (opts.every((o) => o instanceof z.ZodLiteral)) {\n      return {\n        ...base,\n        kind: 'enum',\n        options: opts.map((o) => (o as z.ZodLiteral<string | number>).value),\n      };\n    }\n    return { ...base, kind: 'string' };\n  }\n  if (inner instanceof z.ZodArray) {\n    const el = inner.element as AnyZod;\n    return {\n      ...base,\n      kind: 'list',\n      of: { ...describeField('', el), label: labelFor(key.replace(/s$/, '')) },\n      ...(inner._def.minLength ? { min: inner._def.minLength.value } : {}),\n      ...(inner._def.maxLength ? { max: inner._def.maxLength.value } : {}),\n    };\n  }\n  if (inner instanceof z.ZodObject) {\n    return {\n      ...base,\n      kind: 'group',\n      fields: Object.entries(inner.shape as Record<string, AnyZod>).map(([k, v]) =>\n        describeField(k, v)\n      ),\n    };\n  }\n  return { ...base, kind: 'string' };\n}\n\nexport interface LayoutEditorInfo {\n  name: string;\n  description: string;\n  whenToUse: string;\n  defaults: { background?: string; track?: string };\n  /** Layout-specific fields, in declaration order. */\n  fields: EditorField[];\n  /** A valid starting slide for this layout. */\n  example: Record<string, unknown>;\n}\n\n/** Fields shared by every slide (track, background, notes, step…). */\nexport function commonSlideFields(): EditorField[] {\n  return Object.entries(baseSlide).map(([k, v]) => describeField(k, v));\n}\n\nexport function layoutEditorInfo(name: string): LayoutEditorInfo | undefined {\n  const layout = getLayout(name);\n  if (!layout) return undefined;\n  return {\n    name: layout.name,\n    description: layout.description,\n    whenToUse: layout.whenToUse,\n    defaults: layout.defaults ?? {},\n    fields: Object.entries(layout.shape as Record<string, AnyZod>).map(([k, v]) =>\n      describeField(k, v)\n    ),\n    example: layout.example,\n  };\n}\n\nexport function allLayoutEditorInfo(): LayoutEditorInfo[] {\n  return LAYOUTS.map((l) => layoutEditorInfo(l.name)!);\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/{mcp-5R6YD3QW.js → mcp-DGMQTIQI.js}

@@ -9,17 +9,17 @@ import {
   AUTHORING_GUIDE,
   describeLayout,
   listLayouts
-} from "./chunk-TXNQKBWJ.js";
+} from "./chunk-33EPZMT6.js";
 import {
   buildDeckFile,
   loadDeckFile,
   saveDeckFile
-} from "./chunk-CKVKX2ZD.js";
+} from "./chunk-MYY5GZC2.js";
 import {
   formatIssues,
   stringifyDeck,
   validateDeck
-} from "./chunk-TM3TNVHB.js";
+} from "./chunk-7FROOJCY.js";
 
 // src/node/mcp.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -317,4 +317,4 @@ export {
   createSlidesMcpServer,
   runStdio
 };
-//# sourceMappingURL=mcp-5R6YD3QW.js.map
+//# sourceMappingURL=mcp-DGMQTIQI.js.map

package/dist/node.d.ts

@@ -1,5 +1,5 @@
-import { R as RenderOptions, g as RenderResult, I as ImageResolver } from './render-CZ4g2fa9.js';
-export { r as renderDeck } from './render-CZ4g2fa9.js';
+import { R as RenderOptions, g as RenderResult, I as ImageResolver } from './render-DTz7tLKM.js';
+export { r as renderDeck } from './render-DTz7tLKM.js';
 import 'zod';
 
 /** Largest single image we inline without warning. Big photos bloat the deck file. */

package/dist/node.js

@@ -4,10 +4,10 @@ import {
   fileImageResolver,
   loadDeckFile,
   saveDeckFile
-} from "./chunk-CKVKX2ZD.js";
+} from "./chunk-MYY5GZC2.js";
 import {
   renderDeck
-} from "./chunk-TM3TNVHB.js";
+} from "./chunk-7FROOJCY.js";
 export {
   IMAGE_WARN_BYTES,
   buildDeckFile,

package/dist/{render-CZ4g2fa9.d.ts → render-DTz7tLKM.d.ts}

@@ -110,6 +110,15 @@ declare class DeckError extends Error {
     constructor(issues: LayoutIssue[]);
 }
 
+/**
+ * Size to lay a preview out at before scaling it down. Slides are responsive
+ * and switch to a stacked layout below ~840px wide, so small previews should
+ * render at this size and use a CSS transform.
+ */
+declare const PREVIEW_SIZE: {
+    readonly width: 1280;
+    readonly height: 720;
+};
 type ImageResolver = (src: string) => Promise<string> | string;
 interface RenderOptions {
     /**
@@ -120,11 +129,15 @@ interface RenderOptions {
     resolveImage?: ImageResolver;
     /** Embed the deck source (JSON, without image data) so the HTML can be re-opened for editing. Default true. */
     embedSource?: boolean;
+    /** 0-based rendered slide to open on (ignored when the URL has #slide-N). Handy for editor previews. */
+    initialSlide?: number;
 }
 interface RenderResult {
     html: string;
     deck: Deck;
     slideCount: number;
+    /** For each deck slide, the 0-based indices of the rendered slides it produced (a walkthrough yields several). */
+    slideMap: number[][];
     warnings: ReturnType<typeof validateDeck>['issues'];
 }
 /** Collects every image src in the deck (any object with a string `src`). */
@@ -133,4 +146,4 @@ declare function renderDeck(input: unknown, options?: RenderOptions): Promise<Re
 /** Pulls the embedded deck source back out of a rendered HTML file. */
 declare function extractDeckSource(html: string): unknown | undefined;
 
-export { type Deck as D, type ImageResolver as I, LAYOUTS as L, type RenderOptions as R, type SlideData as S, type ValidationResult as V, DeckError as a, type DeckInput as b, DeckSchema as c, type LayoutDef as d, type LayoutIssue as e, type LayoutName as f, type RenderResult as g, type SlideInput as h, SlideSchema as i, collectImageSources as j, extractDeckSource as k, formatIssues as l, formatPath as m, getLayout as n, renderDeck as r, validateDeck as v };
+export { type Deck as D, type ImageResolver as I, LAYOUTS as L, PREVIEW_SIZE as P, type RenderOptions as R, type SlideData as S, type ValidationResult as V, DeckError as a, type DeckInput as b, DeckSchema as c, type LayoutDef as d, type LayoutIssue as e, type LayoutName as f, type RenderResult as g, type SlideInput as h, SlideSchema as i, collectImageSources as j, extractDeckSource as k, formatIssues as l, formatPath as m, getLayout as n, renderDeck as r, validateDeck as v };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@classic-homes/slides",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Branded Classic Homes presentations from structured deck files: schema, layouts, renderer, CLI and MCP server",
   "type": "module",
   "main": "dist/index.js",
@@ -52,18 +52,26 @@
   },
   "dependencies": {
     "@classic-homes/theme-tokens": "^0.4.0",
-    "@modelcontextprotocol/sdk": "^1.11.0",
     "qrcode": "^1.5.4",
     "yaml": "^2.6.0",
     "zod": "^3.25.0",
     "zod-to-json-schema": "^3.24.0"
   },
+  "peerDependencies": {
+    "@modelcontextprotocol/sdk": "^1.11.0"
+  },
+  "peerDependenciesMeta": {
+    "@modelcontextprotocol/sdk": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@types/node": "^22.0.0",
     "@types/qrcode": "^1.5.5",
     "tsup": "^8.0.0",
     "tsx": "^4.0.0",
     "typescript": "^5.3.0",
-    "vitest": "^4.1.10"
+    "vitest": "^4.1.10",
+    "@modelcontextprotocol/sdk": "^1.11.0"
   }
 }