@classic-homes/slides 0.2.0

package/dist/index.js.map

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

package/dist/mcp-5R6YD3QW.js

@@ -0,0 +1,320 @@
+import {
+  addSlide,
+  moveSlide,
+  outline,
+  removeSlide,
+  updateSlide
+} from "./chunk-VONVGYRL.js";
+import {
+  AUTHORING_GUIDE,
+  describeLayout,
+  listLayouts
+} from "./chunk-TXNQKBWJ.js";
+import {
+  buildDeckFile,
+  loadDeckFile,
+  saveDeckFile
+} from "./chunk-CKVKX2ZD.js";
+import {
+  formatIssues,
+  stringifyDeck,
+  validateDeck
+} from "./chunk-TM3TNVHB.js";
+
+// src/node/mcp.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { access } from "fs/promises";
+import { relative, resolve, sep } from "path";
+import { z } from "zod";
+var VERSION = "0.1.0";
+var text = (t, isError = false) => ({
+  content: [{ type: "text", text: t }],
+  ...isError ? { isError } : {}
+});
+function createSlidesMcpServer(rootDir = process.cwd()) {
+  const root = resolve(rootDir);
+  const server = new McpServer({ name: "classic-slides", version: VERSION });
+  function safePath(p) {
+    const abs = resolve(root, p);
+    if (abs !== root && !abs.startsWith(root + sep))
+      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;
+  }
+  async function load(p) {
+    const abs = safePath(p);
+    const deck = await loadDeckFile(abs);
+    if (!deck || !Array.isArray(deck.slides))
+      throw new Error(`${p} is not a deck file (no slides list).`);
+    return { abs, deck };
+  }
+  async function commit(abs, deck, done) {
+    const v = validateDeck(deck);
+    if (!v.ok) {
+      return text(
+        `Not saved \u2014 the change would make the deck invalid:
+${formatIssues(v.issues)}
+
+Fix the fields and try again.`,
+        true
+      );
+    }
+    await saveDeckFile(abs, deck);
+    const warnings = v.issues.filter((i) => i.level === "warning");
+    return text(
+      `${done}
+
+Outline:
+${outline(deck).join("\n")}${warnings.length ? `
+
+Warnings (saved anyway):
+${formatIssues(warnings)}` : ""}`
+    );
+  }
+  const run = (fn) => async (args) => {
+    try {
+      return await fn(args);
+    } catch (e) {
+      return text(e instanceof Error ? e.message : String(e), true);
+    }
+  };
+  const Path = z.string().describe(`Deck file path, relative to ${root}.`);
+  const Ref = z.union([z.string(), z.number()]).describe("Slide id, or 1-based slide number.");
+  const SlideObj = z.record(z.unknown()).describe("A slide object: { layout, ...fields }. See get_layout for fields.");
+  server.tool(
+    "list_layouts",
+    "List every slide layout with what it is for. Start here.",
+    {},
+    async () => text(
+      listLayouts().map((l) => `- **${l.name}** \u2014 ${l.description}
+  Use for: ${l.whenToUse}`).join("\n")
+    )
+  );
+  server.tool(
+    "get_layout",
+    "Full field reference (JSON Schema) and a working example for one layout.",
+    { name: z.string() },
+    run(async ({ name }) => {
+      const d = describeLayout(name);
+      if (!d) return text(`Unknown layout "${name}". Call list_layouts.`, true);
+      return text(JSON.stringify(d, null, 2));
+    })
+  );
+  server.tool(
+    "get_authoring_guide",
+    "Brand and writing rules for Classic Homes decks. Read before writing slides.",
+    {},
+    async () => text(AUTHORING_GUIDE)
+  );
+  server.tool(
+    "create_deck",
+    "Create a new deck file. Optionally include the first slides.",
+    {
+      path: Path,
+      title: z.string(),
+      description: z.string().optional(),
+      journeySteps: z.array(z.string()).optional().describe("Numbered agenda steps; enables journey features."),
+      slides: z.array(SlideObj).optional(),
+      overwrite: z.boolean().default(false)
+    },
+    run(async ({ path, title, description, journeySteps, slides, overwrite }) => {
+      const abs = safePath(path);
+      if (!overwrite) {
+        const exists = await access(abs).then(
+          () => true,
+          () => false
+        );
+        if (exists)
+          return text(
+            `${path} already exists. Use read_deck and edit it, or pass overwrite: true.`,
+            true
+          );
+      }
+      const deck = {
+        title,
+        ...description ? { description } : {},
+        ...journeySteps?.length ? { journey: { steps: journeySteps } } : {},
+        slides: slides?.length ? slides : [{ layout: "title", title }]
+      };
+      return commit(abs, deck, `Created ${path}.`);
+    })
+  );
+  server.tool(
+    "read_deck",
+    "Read a deck: outline plus the full YAML source.",
+    { path: Path },
+    run(async ({ path }) => {
+      const { deck } = await load(path);
+      return text(
+        `Outline:
+${outline(deck).join("\n")}
+
+Source:
+\`\`\`yaml
+${stringifyDeck(deck)}\`\`\``
+      );
+    })
+  );
+  server.tool(
+    "update_deck",
+    "Change deck-level fields (title, description, author, date, journey). Set a field to null to remove it.",
+    { path: Path, fields: z.record(z.unknown()) },
+    run(async ({ path, fields }) => {
+      const { abs, deck } = await load(path);
+      for (const [k, v] of Object.entries(fields)) {
+        if (k === "slides") return text("Use the slide tools to change slides.", true);
+        if (v === null) delete deck[k];
+        else deck[k] = v;
+      }
+      return commit(abs, deck, "Deck fields updated.");
+    })
+  );
+  server.tool(
+    "add_slide",
+    "Insert a slide. position is 1-based; omit to append.",
+    { path: Path, slide: SlideObj, position: z.number().int().positive().optional() },
+    run(async ({ path, slide, position }) => {
+      const { abs, deck } = await load(path);
+      const at = addSlide(deck, slide, position);
+      return commit(abs, deck, `Added slide ${at}.`);
+    })
+  );
+  server.tool(
+    "add_slides",
+    "Append several slides at once (e.g. a whole section). Saved only if all are valid.",
+    { path: Path, slides: z.array(SlideObj).min(1) },
+    run(async ({ path, slides }) => {
+      const { abs, deck } = await load(path);
+      slides.forEach((s) => addSlide(deck, s));
+      return commit(abs, deck, `Added ${slides.length} slides.`);
+    })
+  );
+  server.tool(
+    "update_slide",
+    "Merge fields into a slide. Set a field to null to remove it. Changing layout replaces the slide.",
+    { path: Path, slide: Ref, fields: z.record(z.unknown()) },
+    run(async ({ path, slide, fields }) => {
+      const { abs, deck } = await load(path);
+      const at = updateSlide(deck, slide, fields);
+      return commit(abs, deck, `Updated slide ${at}.`);
+    })
+  );
+  server.tool(
+    "move_slide",
+    "Move a slide to a new 1-based position.",
+    { path: Path, slide: Ref, to: z.number().int().positive() },
+    run(async ({ path, slide, to }) => {
+      const { abs, deck } = await load(path);
+      const at = moveSlide(deck, slide, to);
+      return commit(abs, deck, `Moved slide to ${at}.`);
+    })
+  );
+  server.tool(
+    "delete_slide",
+    "Delete a slide.",
+    { path: Path, slide: Ref },
+    run(async ({ path, slide }) => {
+      const { abs, deck } = await load(path);
+      const removed = removeSlide(deck, slide);
+      return commit(abs, deck, `Deleted [${removed.layout}] slide.`);
+    })
+  );
+  server.tool(
+    "validate_deck",
+    "Check a deck for errors and crowded slides. Fix every error and most warnings before building.",
+    { path: Path },
+    run(async ({ path }) => {
+      const { deck } = await load(path);
+      const v = validateDeck(deck);
+      if (!v.issues.length) return text("Deck is valid with no warnings.");
+      return text(
+        `${v.ok ? "Valid, with warnings" : "Invalid"}:
+${formatIssues(v.issues)}`,
+        !v.ok
+      );
+    })
+  );
+  server.tool(
+    "build_deck",
+    "Render the deck to one self-contained HTML file (images and fonts inlined). Returns the output path.",
+    {
+      path: Path,
+      out: z.string().optional().describe("Output .html path; defaults next to the deck.")
+    },
+    run(async ({ path, out }) => {
+      const abs = safePath(path);
+      let outAbs;
+      if (out) {
+        outAbs = resolve(root, out);
+        if (!outAbs.startsWith(root + sep) || !outAbs.endsWith(".html"))
+          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) });
+      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 ? `
+
+Image warnings:
+- ${warnings.join("\n- ")}` : ""}${r.warnings.length ? `
+
+Content warnings:
+${formatIssues(r.warnings)}` : ""}`
+      );
+    })
+  );
+  server.resource(
+    "authoring-guide",
+    "slides://guide",
+    { mimeType: "text/markdown" },
+    async (uri) => ({
+      contents: [{ uri: uri.href, mimeType: "text/markdown", text: AUTHORING_GUIDE }]
+    })
+  );
+  server.prompt(
+    "build_deck_from_outline",
+    "Turn a topic and rough outline into a finished, validated deck.",
+    {
+      path: z.string().describe("Where to save the deck, e.g. decks/closing-day.yaml"),
+      topic: z.string(),
+      audience: z.string(),
+      outline: z.string().optional().describe("Bullet outline, notes, or pasted source material.")
+    },
+    ({ path, topic, audience, outline: src }) => ({
+      messages: [
+        {
+          role: "user",
+          content: {
+            type: "text",
+            text: `Build a Classic Homes presentation.
+
+Topic: ${topic}
+Audience: ${audience}
+Save to: ${path}
+${src ? `
+Source material:
+${src}
+` : ""}
+Steps:
+1. Call get_authoring_guide and list_layouts. Call get_layout for each layout you plan to use.
+2. Plan the slide list (one idea per slide) before writing.
+3. create_deck, then add_slides one section at a time. Put detail in each slide's notes.
+4. validate_deck and fix every error and crowding warning.
+5. build_deck and report the output path with a one-line summary per section.`
+          }
+        }
+      ]
+    })
+  );
+  return server;
+}
+async function runStdio(rootDir) {
+  const server = createSlidesMcpServer(rootDir);
+  await server.connect(new StdioServerTransport());
+}
+export {
+  createSlidesMcpServer,
+  runStdio
+};
+//# sourceMappingURL=mcp-5R6YD3QW.js.map

package/dist/mcp-5R6YD3QW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/node/mcp.ts"],"sourcesContent":["/**\n * Local MCP server (stdio) for building decks on disk with an AI agent.\n *\n * Tools work slide-by-slide on a YAML deck file and validate before every\n * save, so an agent can never leave a deck in a broken state. File access is\n * confined to the root directory the server was started in.\n */\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\nimport { access } from 'node:fs/promises';\nimport { relative, resolve, sep } from 'node:path';\nimport { z } from 'zod';\nimport { AUTHORING_GUIDE, describeLayout, listLayouts } from '../catalog.js';\nimport {\n  addSlide,\n  moveSlide,\n  outline,\n  removeSlide,\n  updateSlide,\n  type EditableDeck,\n} from '../edit.js';\nimport { stringifyDeck } from '../parse.js';\nimport { formatIssues, validateDeck } from '../validate.js';\nimport { buildDeckFile, loadDeckFile, saveDeckFile } from './index.js';\n\nconst VERSION = '0.1.0';\n\ntype ToolResult = { content: { type: 'text'; text: string }[]; isError?: boolean };\nconst text = (t: string, isError = false): ToolResult => ({\n  content: [{ type: 'text', text: t }],\n  ...(isError ? { isError } : {}),\n});\n\nexport function createSlidesMcpServer(rootDir = process.cwd()): McpServer {\n  const root = resolve(rootDir);\n  const server = new McpServer({ name: 'classic-slides', version: VERSION });\n\n  function safePath(p: string): string {\n    const abs = resolve(root, p);\n    if (abs !== root && !abs.startsWith(root + sep))\n      throw new Error(`Path \"${p}\" is outside the deck root ${root}.`);\n    if (!/\\.(ya?ml|json)$/i.test(abs))\n      throw new Error('Deck files must end in .yaml, .yml or .json.');\n    return abs;\n  }\n\n  async function load(p: string): Promise<{ abs: string; deck: EditableDeck }> {\n    const abs = safePath(p);\n    const deck = (await loadDeckFile(abs)) as EditableDeck;\n    if (!deck || !Array.isArray(deck.slides))\n      throw new Error(`${p} is not a deck file (no slides list).`);\n    return { abs, deck };\n  }\n\n  /** Validates, then saves only when there are no errors. */\n  async function commit(abs: string, deck: EditableDeck, done: string): Promise<ToolResult> {\n    const v = validateDeck(deck);\n    if (!v.ok) {\n      return text(\n        `Not saved — the change would make the deck invalid:\\n${formatIssues(v.issues)}\\n\\nFix the fields and try again.`,\n        true\n      );\n    }\n    await saveDeckFile(abs, deck);\n    const warnings = v.issues.filter((i) => i.level === 'warning');\n    return text(\n      `${done}\\n\\nOutline:\\n${outline(deck).join('\\n')}${warnings.length ? `\\n\\nWarnings (saved anyway):\\n${formatIssues(warnings)}` : ''}`\n    );\n  }\n\n  const run =\n    <A>(fn: (args: A) => Promise<ToolResult>) =>\n    async (args: A): Promise<ToolResult> => {\n      try {\n        return await fn(args);\n      } catch (e) {\n        return text(e instanceof Error ? e.message : String(e), true);\n      }\n    };\n\n  const Path = z.string().describe(`Deck file path, relative to ${root}.`);\n  const Ref = z.union([z.string(), z.number()]).describe('Slide id, or 1-based slide number.');\n  const SlideObj = z\n    .record(z.unknown())\n    .describe('A slide object: { layout, ...fields }. See get_layout for fields.');\n\n  server.tool(\n    'list_layouts',\n    'List every slide layout with what it is for. Start here.',\n    {},\n    async () =>\n      text(\n        listLayouts()\n          .map((l) => `- **${l.name}** — ${l.description}\\n  Use for: ${l.whenToUse}`)\n          .join('\\n')\n      )\n  );\n\n  server.tool(\n    'get_layout',\n    'Full field reference (JSON Schema) and a working example for one layout.',\n    { name: z.string() },\n    run(async ({ name }) => {\n      const d = describeLayout(name);\n      if (!d) return text(`Unknown layout \"${name}\". Call list_layouts.`, true);\n      return text(JSON.stringify(d, null, 2));\n    })\n  );\n\n  server.tool(\n    'get_authoring_guide',\n    'Brand and writing rules for Classic Homes decks. Read before writing slides.',\n    {},\n    async () => text(AUTHORING_GUIDE)\n  );\n\n  server.tool(\n    'create_deck',\n    'Create a new deck file. Optionally include the first slides.',\n    {\n      path: Path,\n      title: z.string(),\n      description: z.string().optional(),\n      journeySteps: z\n        .array(z.string())\n        .optional()\n        .describe('Numbered agenda steps; enables journey features.'),\n      slides: z.array(SlideObj).optional(),\n      overwrite: z.boolean().default(false),\n    },\n    run(async ({ path, title, description, journeySteps, slides, overwrite }) => {\n      const abs = safePath(path);\n      if (!overwrite) {\n        const exists = await access(abs).then(\n          () => true,\n          () => false\n        );\n        if (exists)\n          return text(\n            `${path} already exists. Use read_deck and edit it, or pass overwrite: true.`,\n            true\n          );\n      }\n      const deck: EditableDeck = {\n        title,\n        ...(description ? { description } : {}),\n        ...(journeySteps?.length ? { journey: { steps: journeySteps } } : {}),\n        slides: slides?.length ? slides : [{ layout: 'title', title }],\n      };\n      return commit(abs, deck, `Created ${path}.`);\n    })\n  );\n\n  server.tool(\n    'read_deck',\n    'Read a deck: outline plus the full YAML source.',\n    { path: Path },\n    run(async ({ path }) => {\n      const { deck } = await load(path);\n      return text(\n        `Outline:\\n${outline(deck).join('\\n')}\\n\\nSource:\\n\\`\\`\\`yaml\\n${stringifyDeck(deck)}\\`\\`\\``\n      );\n    })\n  );\n\n  server.tool(\n    'update_deck',\n    'Change deck-level fields (title, description, author, date, journey). Set a field to null to remove it.',\n    { path: Path, fields: z.record(z.unknown()) },\n    run(async ({ path, fields }) => {\n      const { abs, deck } = await load(path);\n      for (const [k, v] of Object.entries(fields)) {\n        if (k === 'slides') return text('Use the slide tools to change slides.', true);\n        if (v === null) delete deck[k];\n        else deck[k] = v;\n      }\n      return commit(abs, deck, 'Deck fields updated.');\n    })\n  );\n\n  server.tool(\n    'add_slide',\n    'Insert a slide. position is 1-based; omit to append.',\n    { path: Path, slide: SlideObj, position: z.number().int().positive().optional() },\n    run(async ({ path, slide, position }) => {\n      const { abs, deck } = await load(path);\n      const at = addSlide(deck, slide, position);\n      return commit(abs, deck, `Added slide ${at}.`);\n    })\n  );\n\n  server.tool(\n    'add_slides',\n    'Append several slides at once (e.g. a whole section). Saved only if all are valid.',\n    { path: Path, slides: z.array(SlideObj).min(1) },\n    run(async ({ path, slides }) => {\n      const { abs, deck } = await load(path);\n      slides.forEach((s) => addSlide(deck, s));\n      return commit(abs, deck, `Added ${slides.length} slides.`);\n    })\n  );\n\n  server.tool(\n    'update_slide',\n    'Merge fields into a slide. Set a field to null to remove it. Changing layout replaces the slide.',\n    { path: Path, slide: Ref, fields: z.record(z.unknown()) },\n    run(async ({ path, slide, fields }) => {\n      const { abs, deck } = await load(path);\n      const at = updateSlide(deck, slide, fields);\n      return commit(abs, deck, `Updated slide ${at}.`);\n    })\n  );\n\n  server.tool(\n    'move_slide',\n    'Move a slide to a new 1-based position.',\n    { path: Path, slide: Ref, to: z.number().int().positive() },\n    run(async ({ path, slide, to }) => {\n      const { abs, deck } = await load(path);\n      const at = moveSlide(deck, slide, to);\n      return commit(abs, deck, `Moved slide to ${at}.`);\n    })\n  );\n\n  server.tool(\n    'delete_slide',\n    'Delete a slide.',\n    { path: Path, slide: Ref },\n    run(async ({ path, slide }) => {\n      const { abs, deck } = await load(path);\n      const removed = removeSlide(deck, slide);\n      return commit(abs, deck, `Deleted [${removed.layout}] slide.`);\n    })\n  );\n\n  server.tool(\n    'validate_deck',\n    'Check a deck for errors and crowded slides. Fix every error and most warnings before building.',\n    { path: Path },\n    run(async ({ path }) => {\n      const { deck } = await load(path);\n      const v = validateDeck(deck);\n      if (!v.issues.length) return text('Deck is valid with no warnings.');\n      return text(\n        `${v.ok ? 'Valid, with warnings' : 'Invalid'}:\\n${formatIssues(v.issues)}`,\n        !v.ok\n      );\n    })\n  );\n\n  server.tool(\n    'build_deck',\n    'Render the deck to one self-contained HTML file (images and fonts inlined). Returns the output path.',\n    {\n      path: Path,\n      out: z.string().optional().describe('Output .html path; defaults next to the deck.'),\n    },\n    run(async ({ path, out }) => {\n      const abs = safePath(path);\n      let outAbs: string | undefined;\n      if (out) {\n        outAbs = resolve(root, out);\n        if (!outAbs.startsWith(root + sep) || !outAbs.endsWith('.html'))\n          throw new Error('out must be an .html path inside the deck root.');\n      }\n      const warnings: string[] = [];\n      const r = await buildDeckFile(abs, { out: outAbs, onWarning: (w) => warnings.push(w) });\n      return text(\n        `Built ${relative(root, r.out)} — ${r.slideCount} slides, ${(r.bytes / 1024 / 1024).toFixed(2)} MB. Open it in a browser to present (N = notes, F = fullscreen).${\n          warnings.length ? `\\n\\nImage warnings:\\n- ${warnings.join('\\n- ')}` : ''\n        }${r.warnings.length ? `\\n\\nContent warnings:\\n${formatIssues(r.warnings)}` : ''}`\n      );\n    })\n  );\n\n  server.resource(\n    'authoring-guide',\n    'slides://guide',\n    { mimeType: 'text/markdown' },\n    async (uri) => ({\n      contents: [{ uri: uri.href, mimeType: 'text/markdown', text: AUTHORING_GUIDE }],\n    })\n  );\n\n  server.prompt(\n    'build_deck_from_outline',\n    'Turn a topic and rough outline into a finished, validated deck.',\n    {\n      path: z.string().describe('Where to save the deck, e.g. decks/closing-day.yaml'),\n      topic: z.string(),\n      audience: z.string(),\n      outline: z.string().optional().describe('Bullet outline, notes, or pasted source material.'),\n    },\n    ({ path, topic, audience, outline: src }) => ({\n      messages: [\n        {\n          role: 'user',\n          content: {\n            type: 'text',\n            text: `Build a Classic Homes presentation.\n\nTopic: ${topic}\nAudience: ${audience}\nSave to: ${path}\n${src ? `\\nSource material:\\n${src}\\n` : ''}\nSteps:\n1. Call get_authoring_guide and list_layouts. Call get_layout for each layout you plan to use.\n2. Plan the slide list (one idea per slide) before writing.\n3. create_deck, then add_slides one section at a time. Put detail in each slide's notes.\n4. validate_deck and fix every error and crowding warning.\n5. build_deck and report the output path with a one-line summary per section.`,\n          },\n        },\n      ],\n    })\n  );\n\n  return server;\n}\n\nexport async function runStdio(rootDir?: string): Promise<void> {\n  const server = createSlidesMcpServer(rootDir);\n  await server.connect(new StdioServerTransport());\n}\n"],"mappings":"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","names":[]}

package/dist/node.d.ts

@@ -0,0 +1,25 @@
+import { R as RenderOptions, g as RenderResult, I as ImageResolver } from './render-CZ4g2fa9.js';
+export { r as renderDeck } from './render-CZ4g2fa9.js';
+import 'zod';
+
+/** Largest single image we inline without warning. Big photos bloat the deck file. */
+declare const IMAGE_WARN_BYTES: number;
+interface FileResolverOptions {
+    /** Fetch https images and inline them so the deck works offline. Default true. */
+    inlineRemote?: boolean;
+    onWarning?: (message: string) => void;
+}
+/** Resolves image paths relative to the deck file and inlines them as data URIs. */
+declare function fileImageResolver(baseDir: string, options?: FileResolverOptions): ImageResolver;
+declare function loadDeckFile(path: string): Promise<unknown>;
+declare function saveDeckFile(path: string, deck: unknown): Promise<void>;
+interface BuildOptions extends Omit<RenderOptions, 'resolveImage'>, FileResolverOptions {
+    out?: string;
+}
+/** Renders a deck file to a self-contained HTML file next to it (or at `out`). */
+declare function buildDeckFile(path: string, options?: BuildOptions): Promise<RenderResult & {
+    out: string;
+    bytes: number;
+}>;
+
+export { type BuildOptions, type FileResolverOptions, IMAGE_WARN_BYTES, buildDeckFile, fileImageResolver, loadDeckFile, saveDeckFile };

package/dist/node.js

@@ -0,0 +1,19 @@
+import {
+  IMAGE_WARN_BYTES,
+  buildDeckFile,
+  fileImageResolver,
+  loadDeckFile,
+  saveDeckFile
+} from "./chunk-CKVKX2ZD.js";
+import {
+  renderDeck
+} from "./chunk-TM3TNVHB.js";
+export {
+  IMAGE_WARN_BYTES,
+  buildDeckFile,
+  fileImageResolver,
+  loadDeckFile,
+  renderDeck,
+  saveDeckFile
+};
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/render-CZ4g2fa9.d.ts

@@ -0,0 +1,136 @@
+import { z } from 'zod';
+
+/** The deck-level fields a layout may read while rendering. */
+interface DeckContext {
+    title: string;
+    journey?: {
+        steps: string[];
+        label: string;
+    };
+}
+interface RenderContext {
+    deck: DeckContext;
+    /** Resolved image sources (original src → data URI or URL). */
+    image(src: string): string;
+    /** Pre-rendered QR code SVG for a URL. */
+    qr(url: string): string;
+}
+/** One rendered <section>. Layouts return several when one entry expands into a sequence. */
+interface RenderedSlide {
+    html: string;
+    /** Extra classes on the section (layout class is added automatically). */
+    classes?: string[];
+    /** Overrides the slide's own notes (e.g. per-stage notes in a walkthrough). */
+    notes?: string;
+    time?: string;
+}
+interface LayoutIssue {
+    level: 'error' | 'warning';
+    path: (string | number)[];
+    message: string;
+}
+interface LayoutDef<Shape extends z.ZodRawShape = z.ZodRawShape> {
+    /** Value of `layout` in the deck file. */
+    name: string;
+    /** One line: what the slide looks like. */
+    description: string;
+    /** When an author or agent should pick this layout. */
+    whenToUse: string;
+    /** Layout-specific fields (base slide fields are added by the deck schema). */
+    shape: Shape;
+    /** Defaults applied when the slide leaves them unset. */
+    defaults?: {
+        background?: string;
+        track?: 'value' | 'build' | 'neutral';
+    };
+    /** A complete, valid example slide. */
+    example: Record<string, unknown>;
+    /** Soft checks beyond the schema: length and density limits that keep slides clean. */
+    lint?(slide: z.infer<z.ZodObject<Shape>>): LayoutIssue[];
+    render(slide: z.infer<z.ZodObject<Shape>>, ctx: RenderContext): RenderedSlide | RenderedSlide[];
+}
+
+/** Every layout, in the order they are offered to authors. */
+declare const LAYOUTS: readonly LayoutDef<any>[];
+type LayoutName = 'title' | 'section' | 'statement' | 'bullets' | 'split' | 'cards' | 'stats' | 'comparison' | 'journey' | 'photos' | 'image' | 'walkthrough' | 'quote' | 'qr' | 'contacts';
+declare function getLayout(name: string): LayoutDef | undefined;
+
+/** Fields every slide has after parsing; layout-specific fields ride along. */
+interface SlideData {
+    layout: LayoutName;
+    id?: string;
+    track?: 'value' | 'build' | 'neutral';
+    background?: 'paper' | 'navy' | 'slate' | 'red' | 'teal' | 'plum' | 'grey' | 'stone';
+    notes?: string;
+    time?: string;
+    step?: number;
+    stepDone?: boolean;
+    showJourney?: boolean;
+    [field: string]: unknown;
+}
+interface Deck {
+    title: string;
+    description?: string;
+    author?: string;
+    date?: string;
+    lang: string;
+    journey?: {
+        steps: string[];
+        label: string;
+    };
+    slides: SlideData[];
+}
+/** A deck as authored (before defaults are applied). */
+type DeckInput = Omit<Partial<Deck>, 'slides' | 'journey'> & {
+    title: string;
+    journey?: {
+        steps: string[];
+        label?: string;
+    };
+    slides: ({
+        layout: LayoutName;
+    } & Record<string, unknown>)[];
+};
+type SlideInput = DeckInput['slides'][number];
+declare const SlideSchema: z.ZodType<SlideData, z.ZodTypeDef, unknown>;
+declare const DeckSchema: z.ZodType<Deck, z.ZodTypeDef, unknown>;
+
+interface ValidationResult {
+    ok: boolean;
+    deck?: Deck;
+    /** Errors block rendering; warnings are advice that keeps slides clean. */
+    issues: LayoutIssue[];
+}
+declare function validateDeck(input: unknown): ValidationResult;
+/** Human path: slides.3.items.0 → "slide 4 › items › 1" (positions are 1-based, like the outline). */
+declare function formatPath(path: (string | number)[]): string;
+declare function formatIssues(issues: LayoutIssue[]): string;
+declare class DeckError extends Error {
+    issues: LayoutIssue[];
+    constructor(issues: LayoutIssue[]);
+}
+
+type ImageResolver = (src: string) => Promise<string> | string;
+interface RenderOptions {
+    /**
+     * Turns an image `src` from the deck into something the browser can load,
+     * normally a data: URI so the file stays self-contained. The default passes
+     * data: and https: URLs through and rejects everything else.
+     */
+    resolveImage?: ImageResolver;
+    /** Embed the deck source (JSON, without image data) so the HTML can be re-opened for editing. Default true. */
+    embedSource?: boolean;
+}
+interface RenderResult {
+    html: string;
+    deck: Deck;
+    slideCount: number;
+    warnings: ReturnType<typeof validateDeck>['issues'];
+}
+/** Collects every image src in the deck (any object with a string `src`). */
+declare function collectImageSources(value: unknown, out?: Set<string>): Set<string>;
+declare function renderDeck(input: unknown, options?: RenderOptions): Promise<RenderResult>;
+/** 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 };

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@classic-homes/slides",
+  "version": "0.2.0",
+  "description": "Branded Classic Homes presentations from structured deck files: schema, layouts, renderer, CLI and MCP server",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "classic-slides": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./node": {
+      "types": "./dist/node.d.ts",
+      "default": "./dist/node.js"
+    }
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "starters",
+    "README.md"
+  ],
+  "keywords": [
+    "presentation",
+    "slides",
+    "deck",
+    "mcp",
+    "classic-theme"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Classic-Homes/classic-theme.git",
+    "directory": "packages/slides"
+  },
+  "license": "MIT",
+  "author": "Classic Homes",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "generate": "tsx scripts/embed-fonts.ts",
+    "build": "npm run generate && tsup",
+    "dev": "npm run generate && tsup --watch",
+    "typecheck": "npm run generate && tsc --noEmit",
+    "test": "npm run generate && vitest run",
+    "test:watch": "vitest",
+    "clean": "node ../../scripts/rm.mjs dist src/generated"
+  },
+  "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"
+  },
+  "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"
+  }
+}