@classic-homes/slides 0.2.1 → 0.4.0

package/README.md

@@ -63,30 +63,72 @@ Inline text supports `**bold**`, `*highlight*` (brand accent), `` `code` `` and
 Run `classic-slides layouts` for the list, `classic-slides layouts <name>` for
 every field plus an example.
 
-| Layout        | Use for                                               |
-| ------------- | ----------------------------------------------------- |
-| `title`       | First slide                                           |
-| `section`     | Chapter divider on a solid colour, optional photo row |
-| `statement`   | One big idea, a transition, a closing line            |
-| `bullets`     | Short checklist, one or two columns                   |
-| `split`       | Text beside 1–4 photos, optional callout badge        |
-| `cards`       | 3–8 peers: services, options, people                  |
-| `stats`       | 2–6 numbers worth remembering                         |
-| `comparison`  | 2–3 columns side by side                              |
-| `journey`     | Numbered agenda map (uses `journey.steps`)            |
-| `photos`      | A grid of photos: team, products, homes               |
-| `image`       | One big image or diagram                              |
-| `walkthrough` | Ordered stages, one slide each with a progress rail   |
-| `quote`       | A testimonial or pull quote                           |
-| `qr`          | Send people to a URL with a scannable code            |
-| `contacts`    | Who to call                                           |
+| Group              | Layouts                                                                                                                                         |
+| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------- |
+| Openers & dividers | `title`, `section`, `statement`, `journey`                                                                                                      |
+| Text               | `bullets`, `cards`, `comparison`, `quote`                                                                                                       |
+| Data               | `stats` (with trends + sparklines), `chart`, `table`                                                                                            |
+| Diagrams           | `flow`, `timeline`, `cycle`, `hierarchy`, `matrix`, `tiers` (funnel / pyramid)                                                                  |
+| Media              | `split`, `photos`, `image` (with numbered hotspots), `compare` (before/after), `walkthrough`, `video` (YouTube/Vimeo), `embed` (any https page) |
+| People & places    | `qr`, `contacts`                                                                                                                                |
 
 Every slide also accepts `track` (value/red, build/teal, neutral/navy),
-`background` (paper or a solid brand colour), `notes`, `time`, `id`, and — in
-decks with `journey.steps` — `step`, `stepDone` and `showJourney`.
+`background` (paper or a solid brand colour), `backgroundImage` + `overlay`,
+`notes`, `time`, `id`, `hidden`, and — in decks with `journey.steps` — `step`,
+`stepDone` and `showJourney`. `bullets`, `cards`, `flow` and `timeline` take
+`build: true` to reveal one item per click.
 
-`classic-slides guide` prints the writing rules; `classic-slides validate`
-flags errors and crowded slides.
+### Charts
+
+```yaml
+- layout: chart
+  title: Closings *doubled* since spring
+  chart:
+    type: column # bar, stacked-column, stacked-bar, line, area, pie, donut, funnel, gauge, scatter, radar
+    labels: [Q1, Q2, Q3, Q4]
+    series: [{ name: Closings, values: [42, 61, 88, 94] }]
+    unit: homes
+    highlight: Q4
+  insights: [Q4 best quarter on record]
+  source: Sales ops
+```
+
+Charts are rendered to static SVG with ECharts (server-side rendering, themed
+from `@classic-homes/charts-core`), so they work offline and in print. ECharts
+is loaded only when a deck has charts.
+
+### Video and embeds
+
+`video` takes YouTube/Vimeo links (privacy-enhanced players); `embed` takes any
+https page (maps, dashboards, 3D tours, forms) in a sandboxed frame. Both load
+only while their slide is shown, and fall back to a poster/screenshot with a QR
+code offline, in print and in PDF.
+
+## Brand profiles and deck settings
+
+```yaml
+brand:
+  profile: pentrust # admin-managed profile; default classic-homes
+  name: PenTrust Lending # optional overrides: name, tagline, logo, logoOnDark, favicon, footer
+settings:
+  slideNumbers: true
+  logo: all # title | all | none
+  confidential: Internal
+  autoAdvance: 15 # kiosk mode (also ?kiosk=15 on the URL)
+  loop: true
+```
+
+Profiles (`BrandProfile`) carry name, logos, favicon, footer and an optional
+palette; `validateBrandProfile()` enforces WCAG AA contrast. Pass them to
+`renderDeck(deck, { brands })` / `validateDeck(deck, { brands })`. Authors can
+override words and images, never colours.
+
+## Presenting
+
+Arrow keys / Space advance (and step through reveals) · **N** notes · **P**
+presenter window (current + next slide, notes, timer, clock) · **O** overview ·
+**F** fullscreen · `#slide-7` deep links · `?kiosk=15` loops unattended. Print
+to PDF gives one 16:9 page per slide with media fallbacks.
 
 ## With an AI agent (MCP)
 
@@ -117,8 +159,23 @@ import { buildDeckFile, fileImageResolver } from '@classic-homes/slides/node';
 const { html } = await renderDeck(deck, { resolveImage: (src) => lookUp(src) });
 ```
 
-The core entry has no Node dependencies (it runs in Workers); `/node` adds
-file-based image loading and `buildDeckFile`.
+The core entry has no Node dependencies (it runs in Workers and browsers);
+`/node` adds file-based image loading and `buildDeckFile`. For editors,
+`layoutEditorInfo()` / `deckEditorFields()` describe every field as a widget
+(with `hint`s for chart, grid, url, video-url and point pickers),
+`blankSlide(layout)` gives a valid starting slide, and `renderDeck(deck,
+{ includeHidden: true, initialSlide })` plus the `postMessage` API drive a
+live preview. Fields flagged `advanced` (slide id, speaking time, accent
+colour) belong behind an "Advanced" section.
+
+Click-to-edit: render the preview with `editorMarkers: true` and, inside an
+iframe, clicking a title, bullet or picture posts
+`{ type: 'classic-slides:select', index, path }` to the parent (`index` is the
+deck slide, `path` the field such as `['items', 2, 'text']`, or `null` for the
+slide itself). Send `{ type: 'classic-slides:highlight', index, path }` to
+outline the field being edited. Never turn it on for shared or exported decks.
+`layoutGalleryDeck()` returns one deck with every layout's starting slide, for
+rendering a layout picker's thumbnails in one pass.
 
 Rendered HTML embeds the deck source (minus image data), so
 `extractDeckSource(html)` recovers the editable deck.

package/dist/chunk-JFUJ47TP.js

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

package/dist/chunk-JFUJ47TP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/catalog.ts"],"sourcesContent":["import { z } from 'zod';\nimport { zodToJsonSchema } from 'zod-to-json-schema';\nimport {\n  LAYOUT_CATEGORIES,\n  LAYOUTS,\n  getLayout,\n  type LayoutCategory,\n  type LayoutName,\n} from './layouts/index.js';\nimport { baseSlide } from './schema/common.js';\nimport { DeckSchema } from './schema/deck.js';\n\nexport interface LayoutSummary {\n  name: string;\n  category: LayoutCategory;\n  description: string;\n  whenToUse: string;\n}\n\nexport function listLayouts(): LayoutSummary[] {\n  return LAYOUTS.map((l) => ({\n    name: l.name,\n    category: LAYOUT_CATEGORIES[l.name as LayoutName],\n    description: l.description,\n    whenToUse: l.whenToUse,\n  }));\n}\n\n/** Full description of one layout: fields as JSON Schema plus a working example. */\nexport function describeLayout(name: string) {\n  const layout = getLayout(name);\n  if (!layout) return undefined;\n  const schema = z.object({ layout: z.literal(layout.name), ...layout.shape, ...baseSlide });\n  return {\n    name: layout.name,\n    description: layout.description,\n    whenToUse: layout.whenToUse,\n    defaults: layout.defaults ?? {},\n    schema: zodToJsonSchema(schema, { $refStrategy: 'none' }),\n    example: layout.example,\n  };\n}\n\n/** JSON Schema for a whole deck (editor tooling, `$schema` in deck files). */\nexport function deckJsonSchema() {\n  return zodToJsonSchema(DeckSchema, { name: 'ClassicDeck', $refStrategy: 'none' });\n}\n\n/** Authoring guidance shared by the CLI, MCP server and docs. */\nexport const AUTHORING_GUIDE = `# Writing a Classic Homes deck\n\nA deck is a YAML (or JSON) file: deck-level fields plus a list of slides. Each slide\npicks a **layout** and fills its fields. Layouts own all styling — there is no way to\nset colours, fonts or sizes directly, which is what keeps every deck on-brand.\n\n## Principles\n- **One idea per slide.** The headline states the point. Detail goes in \\`notes\\`.\n- **Short copy.** Titles under ~70 characters, bullets a few words, at most 6 bullets.\n  \\`validate\\` warns when a slide gets crowded — split it rather than shrinking text.\n- **Speaker notes on every content slide.** Presenters press N (or P for presenter view).\n- **Real photos over decoration.** Every image needs \\`alt\\` text.\n- **Tracks** colour the accent: \\`value\\` (red, default) for the homeowner/value story,\n  \\`build\\` (teal) for construction/process, \\`neutral\\` (navy) for framing slides.\n- **Backgrounds**: \\`paper\\` (default) for content; solid \\`navy\\`/\\`red\\`/\\`teal\\`/\\`plum\\`/\\`grey\\`/\\`stone\\`\n  for dividers. \\`backgroundImage\\` + \\`overlay\\` puts a photo behind title/section/statement slides.\n\n## Picking a layout\n- **Numbers:** \\`stats\\` (2–6 headline figures, optional trend + sparkline), \\`chart\\` (a real chart —\n  put the takeaway in the title), \\`table\\` (exact figures people compare).\n- **Processes & structure:** \\`flow\\` (ordered steps with arrows), \\`timeline\\` (dated milestones, phases),\n  \\`cycle\\` (things that repeat), \\`hierarchy\\` (org chart / tree), \\`matrix\\` (2×2), \\`tiers\\`\n  (funnel or pyramid), \\`walkthrough\\` (photo per stage), \\`journey\\` (deck agenda).\n- **Media:** \\`split\\` (text + photos), \\`photos\\`, \\`image\\` (with numbered \\`hotspots\\` for floor plans\n  and site maps), \\`compare\\` (before/after slider), \\`video\\` (YouTube/Vimeo), \\`embed\\` (any https page:\n  maps, dashboards, 3D tours, forms).\n- **Words:** \\`statement\\`, \\`bullets\\`, \\`cards\\`, \\`comparison\\`, \\`quote\\`.\n- **Wrap-up:** \\`qr\\` (send people somewhere), \\`contacts\\`, closing \\`statement\\`.\n\n## Charts\n\\`chart.labels\\` are the categories; each series has one value per label. Pie, donut, funnel and\ngauge use the first series; gauge needs \\`max\\`; scatter uses two series as x and y. Use\n\\`highlight\\` to emphasise one category and \\`format\\`/\\`unit\\` instead of typing symbols into numbers.\n\n## Video & embeds\nThey need internet while presenting. Offline, in print and in PDF they show a poster (or\n\\`fallback\\` screenshot) with a QR code. Some sites refuse to be framed — the \"Open ↗\" link\nalways works; add a \\`fallback\\` image for anything critical.\n\n## Brand\n\\`brand.profile\\` picks who the deck speaks for (default \\`classic-homes\\`). You may override\n\\`name\\`, \\`tagline\\`, \\`logo\\`, \\`logoOnDark\\`, \\`favicon\\` and \\`footer\\`; colours come from the profile.\n\\`settings\\` controls slide numbers, logo placement, a confidential label and kiosk auto-advance.\n\n## Presenting\nArrow keys / Space advance (and step through \\`build: true\\` reveals). N notes · P presenter window\n(current + next slide, notes, timer) · O overview · F fullscreen · \\`?kiosk=15\\` on the URL loops\nunattended. \\`hidden: true\\` skips a slide without deleting it.\n\n## Inline text\n\\`**bold**\\`, \\`*highlight*\\` (accent colour), \\`\\\\\\`code\\\\\\`\\`, \\`[label](https://…)\\`. No HTML.\n\n## Journey decks\nSet \\`journey.steps\\` at deck level to get a numbered agenda. Then:\n- a \\`journey\\` slide shows the full map,\n- \\`step: 3\\` on any slide draws the vertical STEP rail,\n- \\`showJourney: true\\` adds the compact \"you are here\" strip (great on \\`section\\` slides).\n\n## Typical shape\n1. \\`title\\`\n2. \\`statement\\` or \\`journey\\` (why we're here / the agenda)\n3. per part: \\`section\\` → 2–5 content slides\n4. \\`qr\\` (where to go next) → \\`contacts\\` → closing \\`statement\\`\n`;\n"],"mappings":";;;;;;;;;AAAA,SAAS,SAAS;AAClB,SAAS,uBAAuB;AAkBzB,SAAS,cAA+B;AAC7C,SAAO,QAAQ,IAAI,CAAC,OAAO;AAAA,IACzB,MAAM,EAAE;AAAA,IACR,UAAU,kBAAkB,EAAE,IAAkB;AAAA,IAChD,aAAa,EAAE;AAAA,IACf,WAAW,EAAE;AAAA,EACf,EAAE;AACJ;AAGO,SAAS,eAAe,MAAc;AAC3C,QAAM,SAAS,UAAU,IAAI;AAC7B,MAAI,CAAC,OAAQ,QAAO;AACpB,QAAM,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,OAAO,IAAI,GAAG,GAAG,OAAO,OAAO,GAAG,UAAU,CAAC;AACzF,SAAO;AAAA,IACL,MAAM,OAAO;AAAA,IACb,aAAa,OAAO;AAAA,IACpB,WAAW,OAAO;AAAA,IAClB,UAAU,OAAO,YAAY,CAAC;AAAA,IAC9B,QAAQ,gBAAgB,QAAQ,EAAE,cAAc,OAAO,CAAC;AAAA,IACxD,SAAS,OAAO;AAAA,EAClB;AACF;AAGO,SAAS,iBAAiB;AAC/B,SAAO,gBAAgB,YAAY,EAAE,MAAM,eAAe,cAAc,OAAO,CAAC;AAClF;AAGO,IAAM,kBAAkB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;","names":[]}

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

@@ -2,11 +2,38 @@ import {
   parseDeckSource,
   renderDeck,
   stringifyDeck
-} from "./chunk-7FROOJCY.js";
+} from "./chunk-PTTLL6PQ.js";
 
 // src/node/index.ts
 import { readFile, stat, writeFile } from "fs/promises";
-import { dirname, extname, isAbsolute, join, resolve } from "path";
+import { dirname as dirname2, extname, isAbsolute, join, resolve as resolve2 } from "path";
+
+// src/node/paths.ts
+import { lstatSync, realpathSync } from "fs";
+import { dirname, relative, resolve, sep } from "path";
+function confinedPath(root, path) {
+  const canonicalRoot = realpathSync(root);
+  const absolute = resolve(path);
+  let ancestor = absolute;
+  for (; ; ) {
+    try {
+      const canonical = resolve(realpathSync(ancestor), relative(ancestor, absolute));
+      if (canonical !== canonicalRoot && !canonical.startsWith(canonicalRoot + sep)) {
+        throw new Error(`Path "${path}" is outside the deck root ${root}.`);
+      }
+      return canonical;
+    } catch (error) {
+      if (error.code !== "ENOENT" || ancestor === dirname(ancestor))
+        throw error;
+      if (lstatSync(ancestor, { throwIfNoEntry: false })?.isSymbolicLink()) {
+        throw new Error(`Cannot follow dangling symlink "${ancestor}".`);
+      }
+      ancestor = dirname(ancestor);
+    }
+  }
+}
+
+// src/node/index.ts
 var MIME = {
   ".jpg": "image/jpeg",
   ".jpeg": "image/jpeg",
@@ -32,7 +59,8 @@ function fileImageResolver(baseDir, options = {}) {
         warn(`${src} is ${(buf2.length / 1024).toFixed(0)} KB; consider a smaller copy.`);
       return `data:${type2};base64,${buf2.toString("base64")}`;
     }
-    const path = isAbsolute(src) ? src : join(baseDir, src);
+    const candidate = isAbsolute(src) ? src : join(baseDir, src);
+    const path = options.rootDir ? confinedPath(options.rootDir, candidate) : candidate;
     const type = MIME[extname(path).toLowerCase()];
     if (!type)
       throw new Error(`Unsupported image type for "${src}". Use jpg, png, webp, gif, svg or avif.`);
@@ -55,22 +83,24 @@ async function saveDeckFile(path, deck) {
   await writeFile(path, text);
 }
 async function buildDeckFile(path, options = {}) {
-  const abs = resolve(path);
+  const abs = options.rootDir ? confinedPath(options.rootDir, resolve2(path)) : resolve2(path);
   const deck = await loadDeckFile(abs);
   const result = await renderDeck(deck, {
     ...options,
-    resolveImage: fileImageResolver(dirname(abs), options)
+    resolveImage: fileImageResolver(dirname2(abs), options)
   });
-  const out = options.out ? resolve(options.out) : abs.replace(/\.(ya?ml|json)$/i, "") + ".html";
+  const candidate = options.out ? resolve2(options.out) : abs.replace(/\.(ya?ml|json)$/i, "") + ".html";
+  const out = options.rootDir ? confinedPath(options.rootDir, candidate) : candidate;
   await writeFile(out, result.html);
   return { ...result, out, bytes: (await stat(out)).size };
 }
 
 export {
+  confinedPath,
   IMAGE_WARN_BYTES,
   fileImageResolver,
   loadDeckFile,
   saveDeckFile,
   buildDeckFile
 };
-//# sourceMappingURL=chunk-MYY5GZC2.js.map
+//# sourceMappingURL=chunk-L7G3VH7K.js.map

package/dist/chunk-L7G3VH7K.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/node/index.ts","../src/node/paths.ts"],"sourcesContent":["/** Node-only helpers: read deck files, inline local images, write HTML. */\nimport { readFile, stat, writeFile } from 'node:fs/promises';\nimport { dirname, extname, isAbsolute, join, resolve } from 'node:path';\nimport { confinedPath } from './paths.js';\nimport { parseDeckSource, stringifyDeck } from '../parse.js';\nimport {\n  renderDeck,\n  type ImageResolver,\n  type RenderOptions,\n  type RenderResult,\n} from '../render.js';\n\nconst MIME: Record<string, string> = {\n  '.jpg': 'image/jpeg',\n  '.jpeg': 'image/jpeg',\n  '.png': 'image/png',\n  '.webp': 'image/webp',\n  '.gif': 'image/gif',\n  '.svg': 'image/svg+xml',\n  '.avif': 'image/avif',\n};\n\n/** Largest single image we inline without warning. Big photos bloat the deck file. */\nexport const IMAGE_WARN_BYTES = 800 * 1024;\n\nexport interface FileResolverOptions {\n  /** Restrict local image reads and build paths to this root (used by the MCP server). */\n  rootDir?: string;\n  /** Fetch https images and inline them so the deck works offline. Default true. */\n  inlineRemote?: boolean;\n  onWarning?: (message: string) => void;\n}\n\n/** Resolves image paths relative to the deck file and inlines them as data URIs. */\nexport function fileImageResolver(\n  baseDir: string,\n  options: FileResolverOptions = {}\n): ImageResolver {\n  const warn = options.onWarning ?? (() => {});\n  return async (src) => {\n    if (src.startsWith('data:')) return src;\n    if (/^https?:/.test(src)) {\n      if (options.inlineRemote === false) return src;\n      const res = await fetch(src);\n      if (!res.ok) throw new Error(`Image ${src} returned HTTP ${res.status}`);\n      const type = res.headers.get('content-type') ?? 'application/octet-stream';\n      const buf = Buffer.from(await res.arrayBuffer());\n      if (buf.length > IMAGE_WARN_BYTES)\n        warn(`${src} is ${(buf.length / 1024).toFixed(0)} KB; consider a smaller copy.`);\n      return `data:${type};base64,${buf.toString('base64')}`;\n    }\n    const candidate = isAbsolute(src) ? src : join(baseDir, src);\n    const path = options.rootDir ? confinedPath(options.rootDir, candidate) : candidate;\n    const type = MIME[extname(path).toLowerCase()];\n    if (!type)\n      throw new Error(`Unsupported image type for \"${src}\". Use jpg, png, webp, gif, svg or avif.`);\n    let buf: Buffer;\n    try {\n      buf = await readFile(path);\n    } catch {\n      throw new Error(`Image not found: \"${src}\" (looked in ${path})`);\n    }\n    if (buf.length > IMAGE_WARN_BYTES)\n      warn(`${src} is ${(buf.length / 1024).toFixed(0)} KB; consider resizing to ~2000px wide.`);\n    return `data:${type};base64,${buf.toString('base64')}`;\n  };\n}\n\nexport async function loadDeckFile(path: string): Promise<unknown> {\n  return parseDeckSource(await readFile(path, 'utf8'));\n}\n\nexport async function saveDeckFile(path: string, deck: unknown): Promise<void> {\n  const text = path.endsWith('.json') ? JSON.stringify(deck, null, 2) + '\\n' : stringifyDeck(deck);\n  await writeFile(path, text);\n}\n\nexport interface BuildOptions extends Omit<RenderOptions, 'resolveImage'>, FileResolverOptions {\n  out?: string;\n}\n\n/** Renders a deck file to a self-contained HTML file next to it (or at `out`). */\nexport async function buildDeckFile(\n  path: string,\n  options: BuildOptions = {}\n): Promise<RenderResult & { out: string; bytes: number }> {\n  const abs = options.rootDir ? confinedPath(options.rootDir, resolve(path)) : resolve(path);\n  const deck = await loadDeckFile(abs);\n  const result = await renderDeck(deck, {\n    ...options,\n    resolveImage: fileImageResolver(dirname(abs), options),\n  });\n  const candidate = options.out\n    ? resolve(options.out)\n    : abs.replace(/\\.(ya?ml|json)$/i, '') + '.html';\n  const out = options.rootDir ? confinedPath(options.rootDir, candidate) : candidate;\n  await writeFile(out, result.html);\n  return { ...result, out, bytes: (await stat(out)).size };\n}\n\nexport { renderDeck };\n","/** Canonical containment for existing files and new output files. */\nimport { lstatSync, realpathSync } from 'node:fs';\nimport { dirname, relative, resolve, sep } from 'node:path';\n\nexport function confinedPath(root: string, path: string): string {\n  const canonicalRoot = realpathSync(root);\n  const absolute = resolve(path);\n  let ancestor = absolute;\n  for (;;) {\n    try {\n      const canonical = resolve(realpathSync(ancestor), relative(ancestor, absolute));\n      if (canonical !== canonicalRoot && !canonical.startsWith(canonicalRoot + sep)) {\n        throw new Error(`Path \"${path}\" is outside the deck root ${root}.`);\n      }\n      return canonical;\n    } catch (error) {\n      if ((error as NodeJS.ErrnoException).code !== 'ENOENT' || ancestor === dirname(ancestor))\n        throw error;\n      if (lstatSync(ancestor, { throwIfNoEntry: false })?.isSymbolicLink()) {\n        throw new Error(`Cannot follow dangling symlink \"${ancestor}\".`);\n      }\n      ancestor = dirname(ancestor);\n    }\n  }\n}\n"],"mappings":"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","names":["dirname","resolve","type","buf","resolve","dirname"]}