@classic-homes/slides 0.3.0 → 0.5.0

package/README.md

@@ -16,6 +16,7 @@ npx classic-slides new decks/closing-day.yaml            # basic starter
 npx classic-slides new decks/orientation.yaml --starter journey
 npx classic-slides dev decks/closing-day.yaml            # live preview, reloads on save
 npx classic-slides build decks/closing-day.yaml          # → decks/closing-day.html
+npx classic-slides export decks/closing-day.yaml         # → decks/closing-day.deck.json
 ```
 
 Present: open the HTML, use arrow keys or Space. **N** shows speaker notes,
@@ -165,11 +166,33 @@ The core entry has no Node dependencies (it runs in Workers and browsers);
 (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.
+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.
 
+### Portable decks (import / export)
+
+`classic-slides export` (or `exportDeckFile` from `/node`) writes one JSON file
+with every image inlined as a `data:` URI — the format to import into a hosted
+deck editor. Keep it under ~10 MB by resizing photos to ~2000px wide.
+
+In code, `inlineDeckImages(deck, resolveImage)` does the export side and
+`externalizeDeckImages(deck, upload)` the import side: it hands each `data:`
+image to `upload` and puts the returned URL in its place. Both build on
+`mapDeckImages(deck, fn)`, which finds images written as plain strings too and
+returns a copy in the author's shape (no schema defaults added).
+
 ## Brand
 
 Colours come from `@classic-homes/theme-tokens`. Fonts (Figtree, Spectral) are

package/dist/{chunk-2IPLZ3SA.js → chunk-GX6P2SE6.js}

@@ -1,8 +1,9 @@
 import {
+  inlineDeckImages,
   parseDeckSource,
   renderDeck,
   stringifyDeck
-} from "./chunk-GXGDPBAR.js";
+} from "./chunk-OUAMH2TP.js";
 
 // src/node/index.ts
 import { readFile, stat, writeFile } from "fs/promises";
@@ -94,6 +95,18 @@ async function buildDeckFile(path, options = {}) {
   await writeFile(out, result.html);
   return { ...result, out, bytes: (await stat(out)).size };
 }
+async function exportDeckFile(path, options = {}) {
+  const abs = options.rootDir ? confinedPath(options.rootDir, resolve2(path)) : resolve2(path);
+  const result = await inlineDeckImages(
+    await loadDeckFile(abs),
+    fileImageResolver(dirname2(abs), options)
+  );
+  const candidate = options.out ? resolve2(options.out) : abs.replace(/\.(ya?ml|json)$/i, "").replace(/\.deck$/i, "") + ".deck.json";
+  const out = options.rootDir ? confinedPath(options.rootDir, candidate) : candidate;
+  if (out === abs) throw new Error(`Refusing to overwrite the source deck ${abs}. Pass --out.`);
+  await writeFile(out, JSON.stringify(result.deck) + "\n");
+  return { ...result, out, bytes: (await stat(out)).size };
+}
 
 export {
   confinedPath,
@@ -101,6 +114,7 @@ export {
   fileImageResolver,
   loadDeckFile,
   saveDeckFile,
-  buildDeckFile
+  buildDeckFile,
+  exportDeckFile
 };
-//# sourceMappingURL=chunk-2IPLZ3SA.js.map
+//# sourceMappingURL=chunk-GX6P2SE6.js.map

package/dist/chunk-GX6P2SE6.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 { inlineDeckImages, type InlineImagesResult } from '../images.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 interface ExportOptions extends FileResolverOptions {\n  out?: string;\n}\n\n/**\n * Writes a portable copy of a deck file: JSON with every image inlined as a\n * data URI, ready to import into a hosted deck editor. Defaults to\n * `<name>.deck.json` next to the source.\n */\nexport async function exportDeckFile(\n  path: string,\n  options: ExportOptions = {}\n): Promise<InlineImagesResult & { out: string; bytes: number }> {\n  const abs = options.rootDir ? confinedPath(options.rootDir, resolve(path)) : resolve(path);\n  const result = await inlineDeckImages(\n    await loadDeckFile(abs),\n    fileImageResolver(dirname(abs), options)\n  );\n  const candidate = options.out\n    ? resolve(options.out)\n    : abs.replace(/\\.(ya?ml|json)$/i, '').replace(/\\.deck$/i, '') + '.deck.json';\n  const out = options.rootDir ? confinedPath(options.rootDir, candidate) : candidate;\n  if (out === abs) throw new Error(`Refusing to overwrite the source deck ${abs}. Pass --out.`);\n  await writeFile(out, JSON.stringify(result.deck) + '\\n');\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"]}

package/dist/{chunk-GXGDPBAR.js → chunk-OUAMH2TP.js}

@@ -620,6 +620,10 @@ function prose(text) {
     return `<p>${inline(para)}</p>`;
   }).join("");
 }
+function plain(text) {
+  if (!text) return "";
+  return text.replace(/`([^`]+)`/g, "$1").replace(/\[([^\]]+)\]\([^)]+\)/g, "$1").replace(/\*\*(.+?)\*\*/g, "$1").replace(/\*(.+?)\*/g, "$1");
+}
 
 // src/video.ts
 var YT = /^(?:https:\/\/)?(?:www\.|m\.)?(?:youtube\.com\/(?:watch\?(?:.*&)?v=|embed\/|shorts\/|live\/)|youtu\.be\/)([\w-]{11})/;
@@ -2193,8 +2197,11 @@ var LABELS = {
   imageAspect: "Photo shape",
   numberFrom: "First badge number",
   url: "URL",
-  id: "Slide id"
+  id: "Slide id",
+  time: "Speaking time",
+  track: "Accent colour"
 };
+var ADVANCED = /* @__PURE__ */ new Set(["id", "time", "track"]);
 function labelFor(key) {
   if (LABELS[key]) return LABELS[key];
   const words = key.replace(/([A-Z])/g, " $1").toLowerCase();
@@ -2231,7 +2238,8 @@ function describeField(key, schema) {
     required,
     ...description ? { description } : {},
     ...dflt !== void 0 ? { default: dflt } : {},
-    ...MULTILINE.has(key) ? { multiline: true } : {}
+    ...MULTILINE.has(key) ? { multiline: true } : {},
+    ...ADVANCED.has(key) ? { advanced: true } : {}
   };
   if (inner === Image) return { ...base, kind: "image" };
   if (inner === ChartSpec) {
@@ -2335,6 +2343,16 @@ function layoutEditorInfo(name) {
 function allLayoutEditorInfo() {
   return LAYOUTS.map((l) => layoutEditorInfo(l.name));
 }
+function layoutGalleryDeck() {
+  const slides = [];
+  const slideFor = {};
+  for (const layout of LAYOUTS) {
+    slideFor[layout.name] = slides.length;
+    slides.push(blankSlide(layout.name));
+  }
+  const journey2 = { steps: ["Contract", "Design", "Build", "Close", "Move in", "Warranty"] };
+  return { deck: { title: "Layouts", journey: journey2, slides }, slideFor };
+}
 var PLACEHOLDER_IMAGE = "data:image/svg+xml;base64," + btoa(
   '<svg xmlns="http://www.w3.org/2000/svg" width="1600" height="1000" viewBox="0 0 1600 1000"><rect width="1600" height="1000" fill="#ecebe6"/><rect x="24" y="24" width="1552" height="952" fill="none" stroke="#b9bcb4" stroke-width="6" stroke-dasharray="28 20"/><text x="800" y="520" text-anchor="middle" font-family="Figtree,Arial,sans-serif" font-size="64" fill="#7a7a7a">Add a photo</text></svg>'
 );
@@ -2567,8 +2585,83 @@ var RUNTIME_JS = String.raw`
     if (!embedded || e.source !== window.parent) return;
     if (d.type === 'classic-slides:go' && Number.isInteger(d.index)) go(d.index, true);
     else if (d.type === 'classic-slides:notes') { if (notes && notes.classList.contains('open') !== !!d.open) toggleNotes(); }
+    else if (d.type === 'classic-slides:highlight' && editor) highlight(d.index, d.path);
   });
 
+  // ---------- editor click-to-edit ----------
+  // Matches the clicked element to a slide field by its visible text (or an
+  // image by its src), walking up from the target, so layouts need no markup.
+  const editor = embedded && body.hasAttribute('data-editor');
+  const fieldsEl = editor && document.getElementById('deck-fields');
+  const FIELDS = fieldsEl ? JSON.parse(fieldsEl.textContent || '[]') : [];
+  const norm = (t) => (t || '').replace(/\s+/g, ' ').trim();
+  function ownText(el) {
+    let t = '';
+    el.childNodes.forEach((n) => { if (n.nodeType === 3) t += n.textContent; });
+    return norm(t);
+  }
+  function fieldFor(el, candidates) {
+    if (el.tagName === 'IMG') {
+      const src = el.getAttribute('src');
+      return candidates.find((c) => c.img && c.img === src);
+    }
+    const text = norm(el.textContent);
+    const own = ownText(el);
+    return candidates.find((c) => c.text && (c.text === text || (own && c.text === own)));
+  }
+  function locate(target) {
+    const section = target.closest && target.closest('.slide');
+    if (!section) return null;
+    const index = Number(section.getAttribute('data-index'));
+    const candidates = FIELDS[index] || [];
+    for (let el = target; el && el !== section; el = el.parentElement) {
+      const field = fieldFor(el, candidates);
+      if (field) return { index, path: field.path, el };
+    }
+    return { index, path: null, el: section };
+  }
+  let hovered = null;
+  let selected = null;
+  function highlight(index, path) {
+    selected?.classList.remove('cs-edit-selected');
+    selected = null;
+    if (!Array.isArray(path)) return;
+    const key = JSON.stringify(path);
+    const candidates = FIELDS[index] || [];
+    for (const section of deck.querySelectorAll('.slide[data-index="' + index + '"]')) {
+      for (const el of section.querySelectorAll('*')) {
+        const field = fieldFor(el, candidates);
+        if (field && JSON.stringify(field.path) === key) {
+          selected = el;
+          el.classList.add('cs-edit-selected');
+          return;
+        }
+      }
+    }
+  }
+  if (editor) {
+    const style = document.createElement('style');
+    style.textContent = '.cs-edit-hover{outline:2px dashed rgba(0,122,255,.7);outline-offset:4px;cursor:pointer}' +
+      '.cs-edit-selected{outline:2px solid rgb(0,122,255);outline-offset:4px}';
+    document.head.appendChild(style);
+    deck.addEventListener('click', (e) => {
+      const hit = locate(e.target);
+      if (!hit) return;
+      // Links on a slide would navigate the preview away
+      if (e.target.closest('a[href]')) e.preventDefault();
+      window.parent.postMessage({ type: 'classic-slides:select', index: hit.index, path: hit.path }, '*');
+    }, true);
+    deck.addEventListener('mouseover', (e) => {
+      const hit = locate(e.target);
+      const el = hit && hit.path ? hit.el : null;
+      if (el === hovered) return;
+      hovered?.classList.remove('cs-edit-hover');
+      hovered = el;
+      el?.classList.add('cs-edit-hover');
+    });
+    deck.addEventListener('mouseleave', () => { hovered?.classList.remove('cs-edit-hover'); hovered = null; });
+  }
+
   function onKey(e) {
     if (e.metaKey || e.ctrlKey || e.altKey) return;
     const k = e.key;
@@ -3286,6 +3379,48 @@ body.presenter{margin:0;height:100vh;display:grid;grid-template-rows:1fr auto;ba
 
 // src/render.ts
 var PREVIEW_SIZE = { width: 1280, height: 720 };
+var NON_VISUAL_KEYS = /* @__PURE__ */ new Set([
+  "layout",
+  "id",
+  "notes",
+  "time",
+  "hidden",
+  "background",
+  "backgroundImage",
+  "overlay",
+  "track",
+  "step",
+  "stepDone",
+  "showJourney",
+  "href",
+  "url",
+  "fit",
+  "focus",
+  "size",
+  "alt"
+]);
+function fieldMarkers(slide, resolveImage = (src) => src) {
+  const out = [];
+  const walk = (value, path) => {
+    if (typeof value === "string") {
+      const text = plain(value).replace(/\s+/g, " ").trim();
+      if (text) out.push({ path, text });
+    } else if (Array.isArray(value)) {
+      value.forEach((v, i) => walk(v, [...path, i]));
+    } else if (value && typeof value === "object") {
+      const obj = value;
+      if (typeof obj.src === "string") {
+        out.push({ path, img: resolveImage(obj.src) });
+        return;
+      }
+      for (const [key, v] of Object.entries(obj)) {
+        if (!NON_VISUAL_KEYS.has(key)) walk(v, [...path, key]);
+      }
+    }
+  };
+  walk(slide, []);
+  return out;
+}
 var passThrough = (src) => {
   if (/^(data:|https?:)/.test(src)) return src;
   throw new Error(
@@ -3476,6 +3611,12 @@ async function renderDeck(input, options = {}) {
     });
   });
   const withNotes = options.speakerNotes !== false;
+  const fields = options.editorMarkers ? `<script type="application/json" id="deck-fields">${JSON.stringify(
+    deck.slides.map(
+      (slide) => fieldMarkers(slide, (src) => images.get(src) ?? src)
+    )
+  ).replace(/</g, "\\u003c")}</script>
+` : "";
   const json = (v) => JSON.stringify(v).replace(/</g, "\\u003c");
   const stripData = (key, v) => !withNotes && key === "notes" ? void 0 : typeof v === "string" && /^data:/i.test(v) ? "(embedded)" : v;
   const source = options.embedSource === false ? "" : `<script type="application/json" id="deck-source">${JSON.stringify(deck, stripData).replace(/</g, "\\u003c")}</script>
@@ -3492,7 +3633,7 @@ ${deck.description ? `<meta name="description" content="${escapeAttr(deck.descri
 <style id="brand-fonts">${fontsCss()}</style>
 <style>${tokensCss(brand.stock ? void 0 : brand.palette)}${DECK_CSS}${DECK_CSS_EXTRA}</style>
 </head>
-<body${wantFooter ? ' class="has-foot"' : ""}${options.initialSlide ? ` data-initial-slide="${Math.max(0, Math.floor(options.initialSlide))}"` : ""}${deck.settings.autoAdvance ? ` data-auto-advance="${deck.settings.autoAdvance}"` : ""}${deck.settings.loop ? " data-loop" : ""}${options.allowEmbeddedKiosk ? " data-embedded-kiosk" : ""}>
+<body${wantFooter ? ' class="has-foot"' : ""}${options.initialSlide ? ` data-initial-slide="${Math.max(0, Math.floor(options.initialSlide))}"` : ""}${deck.settings.autoAdvance ? ` data-auto-advance="${deck.settings.autoAdvance}"` : ""}${deck.settings.loop ? " data-loop" : ""}${options.allowEmbeddedKiosk ? " data-embedded-kiosk" : ""}${options.editorMarkers ? " data-editor" : ""}>
 <div class="rail" id="rail"></div>
 <main class="deck" id="deck">
 ${sections.join("\n")}
@@ -3503,7 +3644,7 @@ ${withNotes ? `<div class="hud"><span class="counter" id="counter" aria-live="po
 <aside class="notes" id="notes" aria-live="polite"><div class="notes__head"><span class="tag">Speaker notes</span><span class="time" id="notesTime"></span></div><div class="notes__body" id="notesBody"></div></aside>` : `<div class="hud"><span class="counter" id="counter" aria-live="polite"></span></div>
 <div class="hint"><kbd>&uarr;</kbd><kbd>&darr;</kbd> or <kbd>Space</kbd> navigate &middot; <kbd>O</kbd> overview &middot; <kbd>F</kbd> fullscreen</div>`}
 <script type="application/json" id="deck-notes">${json(withNotes ? notes : [])}</script>
-${source}<script>${RUNTIME_JS}</script>
+${source}${fields}<script>${RUNTIME_JS}</script>
 </body>
 </html>
 `;
@@ -3683,6 +3824,73 @@ function stringifyDeck(deck) {
   });
 }
 
+// src/images.ts
+function imagePaths(value, path = [], out = []) {
+  if (Array.isArray(value)) value.forEach((v, i) => imagePaths(v, [...path, i], out));
+  else if (value && typeof value === "object") {
+    const obj = value;
+    if (typeof obj.src === "string") out.push(path);
+    for (const [k, v] of Object.entries(obj)) imagePaths(v, [...path, k], out);
+  }
+  return out;
+}
+async function mapDeckImages(input, fn, options = {}) {
+  const result = validateDeck(input, options);
+  if (!result.ok || !result.deck) throw new DeckError(result.issues);
+  const paths = imagePaths(result.deck);
+  const deck = structuredClone(input);
+  const read = (path) => path.reduce((node, key) => node[key], deck);
+  const sources = [
+    ...new Set(
+      paths.map((p) => {
+        const node = read(p);
+        return typeof node === "string" ? node : node.src;
+      })
+    )
+  ];
+  const replaced = /* @__PURE__ */ new Map();
+  let next = 0;
+  await Promise.all(
+    Array.from({ length: Math.min(options.concurrency ?? 4, sources.length) }, async () => {
+      while (next < sources.length) {
+        const src = sources[next++];
+        replaced.set(src, await fn(src));
+      }
+    })
+  );
+  for (const path of paths) {
+    const node = read(path);
+    if (typeof node === "string") {
+      const parent = read(path.slice(0, -1));
+      parent[path[path.length - 1]] = replaced.get(node);
+    } else {
+      const img2 = node;
+      img2.src = replaced.get(img2.src);
+    }
+  }
+  return deck;
+}
+async function inlineDeckImages(input, resolve, options = {}) {
+  const warnings = [];
+  const deck = await mapDeckImages(
+    input,
+    async (src) => {
+      if (/^data:/i.test(src)) return src;
+      try {
+        return await resolve(src);
+      } catch (e) {
+        warnings.push({ src, message: e instanceof Error ? e.message : String(e) });
+        return src;
+      }
+    },
+    options
+  );
+  return { deck, warnings };
+}
+function externalizeDeckImages(input, upload, options = {}) {
+  return mapDeckImages(input, (src) => /^data:/i.test(src) ? upload(src) : src, options);
+}
+
 export {
   baseSlide,
   BrandPaletteSchema,
@@ -3727,6 +3935,7 @@ export {
   commonSlideFields,
   layoutEditorInfo,
   allLayoutEditorInfo,
+  layoutGalleryDeck,
   PLACEHOLDER_IMAGE,
   isPlaceholderImage,
   blankSlide,
@@ -3735,10 +3944,14 @@ export {
   formatIssues,
   DeckError,
   PREVIEW_SIZE,
+  fieldMarkers,
   collectImageSources,
   renderDeck,
   extractDeckSource,
   parseDeckSource,
-  stringifyDeck
+  stringifyDeck,
+  mapDeckImages,
+  inlineDeckImages,
+  externalizeDeckImages
 };
-//# sourceMappingURL=chunk-GXGDPBAR.js.map
+//# sourceMappingURL=chunk-OUAMH2TP.js.map