@openpresentation/opf 0.14.0 → 0.15.1

package/dist/index.js

@@ -1,23 +1,312 @@
-export { specFileEntries, specFileKinds, specFilePaths } from './chunk-D3TY4TT6.js';
-export { getLayoutPreview, hasLayoutPreview, layoutPreviewIndex, layoutPreviewSlugs, layoutPreviews } from './chunk-PIQXLBBJ.js';
-export { OPFDataImportError, importData, parseTabularData } from './chunk-Q2TCMN56.js';
-export { fromMarkdown, toMarkdown } from './chunk-UPQQD7MA.js';
-export { OPFMarkdownError } from './chunk-4LDGKLUC.js';
-export { diff, merge } from './chunk-Z65B2B77.js';
-export { OPFPatchError, OPFPatchValidationError, applyPatch } from './chunk-BFLVSVA7.js';
-export { OPFFormatError, format } from './chunk-5ZU6JAPP.js';
-export { OPFPaginationError, paginate, paginateSlide } from './chunk-XIZUK2XM.js';
-import './chunk-4VJDTF55.js';
-import './chunk-CSQHPVGL.js';
-export { DEFAULT_CHART_PALETTE, DEFAULT_VALIDATION_THRESHOLDS, OPFValidationError, assertValid, assertValidCatalogRecord, findValidationRule, resolveSlideContext, validate, validateCatalogRecord, validationCategories, validationRules } from './chunk-JDJBDYSR.js';
-import { isRecord, DEFAULT_FONT_SCHEME, visitContentPayloads, listVariables, resolveFontSchemeReference, resolveFontFamilies, resolveCanvasDimensions, bareIdPattern } from './chunk-6OXY2CP3.js';
-export { DEFAULT_VARIABLE_DATE_FORMAT, OPFVariableError, VARIABLE_KINDS, chartNumber, coerceVariableValue, datasetDiagnostics, formatDataNumber, formatVariableNumber, fromExcelNumberFormat, hasContentVariables, inlineChartData, inlineDatasets, inlineTableData, isDatasetRef, isTemplate, isXYChartType, listBuiltinVariables, listVariables, normalizeLanguageFamily, numberFormatError, resolveChartData, resolveTableData, resolveVariables, suggestChartNumberFix, tableCellDisplayValue, toExcelNumberFormat, unusedDatasets, variableDeclarations } from './chunk-6OXY2CP3.js';
-import './chunk-S5W34SIJ.js';
-import { catalogs, catalogEntries } from './chunk-XOZ4KMSR.js';
-export { audiences, catalogEntries, catalogIndexes, catalogKinds, catalogSchemaNames, catalogs, chartTypes, colorSchemes, fontSchemes, languages, layouts, narratives, purposes, socialPlatforms, themes, tones } from './chunk-XOZ4KMSR.js';
-export { audience, chartType, colorScheme, fontScheme, language, layout, narrative, presentation, purpose, schemaEntries, schemaNames, schemas, socialPlatform, theme, tone } from './chunk-LS2FMPI5.js';
+export { specFileEntries, specFileKinds, specFilePaths } from './chunk-HXHOZ7AH.js';
+export { OPFDataImportError, importData, parseTabularData } from './chunk-U4J75TRG.js';
+export { fromMarkdown, toMarkdown } from './chunk-3JG4YXWF.js';
+export { OPFMarkdownError } from './chunk-3RKB4RDJ.js';
+export { diff, merge } from './chunk-TWQJLI6E.js';
+export { OPFPatchError, OPFPatchValidationError, applyPatch } from './chunk-5FTUIDUH.js';
+export { OPFFormatError, format } from './chunk-ZPU46TFA.js';
+export { OPFPaginationError, paginate, paginateSlide } from './chunk-UBFJ2QHH.js';
+import './chunk-374R35TJ.js';
+import './chunk-VGAOJEY7.js';
+export { DEFAULT_CHART_PALETTE, DEFAULT_VALIDATION_THRESHOLDS, OPFValidationError, assertValid, assertValidCatalogRecord, findValidationRule, resolveSlideContext, validate, validateCatalogRecord, validationCategories, validationRules } from './chunk-QDI75P2M.js';
+import { isRecord, visitContentPayloads, listVariables, resolveDesignRecords, resolveFontFamilies, resolveCanvasDimensions, imageBackground } from './chunk-O744SXXA.js';
+export { CHART_TYPES, DEFAULT_VARIABLE_DATE_FORMAT, ENGINE_DEFAULT_CHART_TYPES, ENGINE_DEFAULT_COLOR_SCHEME, ENGINE_DEFAULT_FONT_SCHEME, ENGINE_DEFAULT_THEME, LANGUAGES, OPFVariableError, SOCIAL_PLATFORMS, VARIABLE_KINDS, chartNumber, coerceVariableValue, datasetDiagnostics, formatDataNumber, formatVariableNumber, fromExcelNumberFormat, hasContentVariables, inlineChartData, inlineDatasets, inlineTableData, isDatasetRef, isTemplate, isXYChartType, listBuiltinVariables, listVariables, normalizeLanguageFamily, numberFormatError, resolveChartData, resolveDesignRecords, resolveFontScheme, resolveTableData, resolveVariables, suggestChartNumberFix, tableCellDisplayValue, toExcelNumberFormat, unusedDatasets, variableDeclarations } from './chunk-O744SXXA.js';
+export { catalogDisplayKinds, catalogSchemaNames } from './chunk-TRDXRRQK.js';
+import { embeddedCopy, checkCatalogsOption, catalogReferenceSites, parseReference, catalogGroupDeclared, resolveReference, dottedPath, unresolvedReference, recordReferenceSites, catalogGroupSource, registeredCatalog, catalogKinds, CATALOG_GROUP_PATTERN } from './chunk-SPFV27O5.js';
+export { CATALOG_GROUP_PATTERN, CATALOG_REFERENCE_PATTERN, OPFCatalogsOptionError, OPFUnresolvedReferenceError, catalogGroupSource, catalogKinds, catalogRecords, catalogReferenceSites, parseReference, resolveReference, unresolvedReference } from './chunk-SPFV27O5.js';
+export { audience, chartType, colorScheme, fontScheme, language, layout, narrative, presentation, purpose, schemaEntries, schemaNames, schemas, socialPlatform, theme, tone } from './chunk-2CJPC4HI.js';
 export { FONT_POLICY, applyFontPolicyDecisions, fontAvailabilityDiagnostics, fontPolicyFor } from './chunk-WXSPETQ6.js';
 
+// src/catalog-helpers.ts
+var isRec = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var rec = (value) => isRec(value) ? value : {};
+function canonical(value) {
+  if (Array.isArray(value)) return `[${value.map(canonical).join(",")}]`;
+  if (isRec(value))
+    return `{${Object.keys(value).filter((key) => value[key] !== void 0).sort().map((key) => `${JSON.stringify(key)}:${canonical(value[key])}`).join(",")}}`;
+  return JSON.stringify(value);
+}
+function sameRecord(a, b) {
+  return canonical(embeddedCopy(a)) === canonical(embeddedCopy(b));
+}
+function setAt(root, path, value) {
+  let node = root;
+  for (const part of path.slice(0, -1)) node = node[part];
+  node[path[path.length - 1]] = value;
+}
+var kindsOf = (group, kind) => {
+  if (!isRec(group[kind])) group[kind] = {};
+  return group[kind];
+};
+function embed(document, options = {}) {
+  const catalogs = { catalogs: checkCatalogsOption(options.catalogs, "embed") };
+  const out = structuredClone(rec(document));
+  const added = [];
+  const unresolved = [];
+  const queue = catalogReferenceSites(out);
+  const reported = /* @__PURE__ */ new Set();
+  while (queue.length) {
+    const site = queue.shift();
+    const parsed = parseReference(site.reference);
+    if (parsed?.group !== void 0 && !catalogGroupDeclared(out, parsed.group)) continue;
+    const found = resolveReference(out, site.kind, site.reference, { ...catalogs, ...site.group !== void 0 ? { group: site.group } : {} });
+    if (!found) {
+      const path = dottedPath(site.path);
+      if (!reported.has(path)) {
+        reported.add(path);
+        unresolved.push(unresolvedReference(out, site.kind, site.reference, path, catalogs));
+      }
+      continue;
+    }
+    if (found.origin === "document") continue;
+    if (!isRec(out.catalogs)) out.catalogs = {};
+    const groups = out.catalogs;
+    if (!isRec(groups[found.group])) groups[found.group] = {};
+    const group = groups[found.group];
+    if (found.group !== "custom" && typeof group.source !== "string" && found.source !== void 0) {
+      const rest = { ...group };
+      for (const key of Object.keys(group)) delete group[key];
+      Object.assign(group, { source: found.source }, rest);
+    }
+    const copy = embeddedCopy(found.record);
+    kindsOf(group, site.kind)[found.id] = copy;
+    added.push({ group: found.group, kind: site.kind, id: found.id, ...found.source !== void 0 ? { source: found.source } : {} });
+    queue.push(...recordReferenceSites(site.kind, copy, ["catalogs", found.group, site.kind, found.id], found.group));
+  }
+  return { document: out, added, unresolved };
+}
+function groupNameFor(source) {
+  const base = source.startsWith("pkg:") ? source.slice(4).replace(/^@/, "").split("/").slice(0, 2).join("-") : (() => {
+    try {
+      return new URL(source).hostname.replace(/^www\./, "");
+    } catch {
+      return source;
+    }
+  })();
+  const name = base.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+  return /^[a-z]/.test(name) ? name : `catalog-${name || "source"}`;
+}
+function copySlides(from, to, indexes, options = {}) {
+  const catalogs = { catalogs: checkCatalogsOption(options.catalogs, "copySlides") };
+  const source = rec(from);
+  const target = structuredClone(rec(to));
+  const sourceSlides = Array.isArray(source.slides) ? source.slides : [];
+  const targetSlides = Array.isArray(target.slides) ? target.slides : [];
+  for (const index of indexes)
+    if (!Number.isInteger(index) || index < 0 || index >= sourceSlides.length) throw new RangeError(`Slide index ${String(index)} is outside the source presentation's ${sourceSlides.length} slides.`);
+  const at = options.at ?? targetSlides.length;
+  if (!Number.isInteger(at) || at < 0 || at > targetSlides.length) throw new RangeError(`Insertion index ${String(at)} is outside the target presentation's ${targetSlides.length + 1} positions.`);
+  const renamed = [];
+  const addedGroups = [];
+  const added = [];
+  const unresolved = [];
+  const hadCatalogs = isRec(target.catalogs);
+  const groups = () => {
+    if (!isRec(target.catalogs)) target.catalogs = {};
+    return target.catalogs;
+  };
+  const memo = /* @__PURE__ */ new Map();
+  const targetGroupFor = (catalogSource, sourceGroupName) => {
+    for (const [name2, value] of Object.entries(rec(target.catalogs))) if (name2 !== "custom" && isRec(value) && value.source === catalogSource) return name2;
+    if (rec(target.catalogs).default !== false && catalogGroupSource(target, "default", catalogs) === catalogSource) return "default";
+    let name = sourceGroupName === "default" || sourceGroupName === "custom" ? groupNameFor(catalogSource) : sourceGroupName;
+    for (let n = 2; catalogGroupDeclared(target, name) || name === "default" || name === "custom"; n++) name = `${sourceGroupName === "default" ? groupNameFor(catalogSource) : sourceGroupName}-${n}`;
+    groups()[name] = { source: catalogSource };
+    addedGroups.push({ name, source: catalogSource });
+    return name;
+  };
+  const bareTaken = (kind, id) => resolveReference(target, kind, id, catalogs) !== void 0;
+  const addCustom = (kind, wanted, record, renamed2 = false) => {
+    const custom = rec(rec(target.catalogs).custom);
+    const existing = rec(custom[kind]);
+    for (const [id2, value] of Object.entries(existing)) if ((!renamed2 && id2 === wanted || /^-\d+$/.test(id2.slice(wanted.length))) && id2.startsWith(wanted) && sameRecord(value, record)) return { id: id2, reused: true };
+    let n = renamed2 ? 2 : 1;
+    let id = renamed2 ? `${wanted}-2` : wanted;
+    while (Object.hasOwn(existing, id) || bareTaken(kind, id)) id = `${wanted}-${++n}`;
+    if (!isRec(groups().custom)) groups().custom = {};
+    kindsOf(groups().custom, kind)[id] = record;
+    added.push({ group: "custom", kind, id });
+    return { id, reused: false };
+  };
+  const referenceTo = (kind, group, id, holder) => {
+    const found = resolveReference(target, kind, id, { ...catalogs, ...holder !== void 0 ? { group: holder } : {} });
+    return found && found.group === group && found.id === id ? id : `${group}:${id}`;
+  };
+  const place = (kind, reference2, path, holder) => {
+    const found = resolveReference(source, kind, reference2, { ...catalogs, ...holder !== void 0 ? { group: holder } : {} });
+    if (!found) {
+      unresolved.push(unresolvedReference(source, kind, reference2, path, catalogs));
+      return void 0;
+    }
+    const key = `${kind}\0${found.group}\0${found.source ?? ""}\0${found.id}`;
+    const known = memo.get(key);
+    if (known) return known;
+    const incoming = embeddedCopy(found.record);
+    const catalogSource = found.group === "custom" ? void 0 : found.source;
+    const group = catalogSource === void 0 ? "custom" : targetGroupFor(catalogSource, found.group);
+    const inner = recordReferenceSites(kind, incoming, []).map((site) => ({ site, placed: place(site.kind, site.reference, `${path} -> ${site.path.join(".")}`, found.group) }));
+    const rewrite = (holderGroup) => {
+      const copy = structuredClone(incoming);
+      for (const { site, placed: placed2 } of inner) if (placed2) setAt(copy, site.path, referenceTo(site.kind, placed2.group, placed2.id, holderGroup));
+      return copy;
+    };
+    let placed;
+    if (group === "custom") {
+      const result = addCustom(kind, found.id, rewrite("custom"));
+      if (result.id !== found.id && !result.reused) renamed.push({ kind, from: reference2, to: result.id, reason: "custom-conflict" });
+      placed = { group: "custom", id: result.id };
+    } else {
+      const record = rewrite(group);
+      const embedded = rec(rec(rec(target.catalogs)[group])[kind]);
+      const current = Object.hasOwn(embedded, found.id) ? embedded[found.id] : registeredCatalog(catalogGroupSource(target, group, catalogs), catalogs)?.[kind]?.[found.id];
+      if (current === void 0 || sameRecord(current, record)) {
+        if (!Object.hasOwn(embedded, found.id)) {
+          if (!isRec(groups()[group])) groups()[group] = {};
+          const holder2 = groups()[group];
+          if (typeof holder2.source !== "string" && catalogSource !== void 0) {
+            const rest = { ...holder2 };
+            for (const key2 of Object.keys(holder2)) delete holder2[key2];
+            Object.assign(holder2, { source: catalogSource }, rest);
+          }
+          kindsOf(holder2, kind)[found.id] = record;
+          added.push({ group, kind, id: found.id, ...catalogSource !== void 0 ? { source: catalogSource } : {} });
+        }
+        placed = { group, id: found.id };
+      } else {
+        const { id, reused } = addCustom(kind, found.id, rewrite("custom"), true);
+        if (!reused) renamed.push({ kind, from: reference2, to: id, reason: "catalog-revision" });
+        placed = { group: "custom", id };
+      }
+    }
+    memo.set(key, placed);
+    return placed;
+  };
+  const copied = [];
+  for (const index of indexes) {
+    const slide = structuredClone(sourceSlides[index]);
+    const holder = { slides: [slide] };
+    for (const site of catalogReferenceSites(holder, { records: false })) {
+      const placed = place(site.kind, site.reference, `slides.${index}.${site.path.slice(2).join(".")}`);
+      if (placed) setAt(holder, site.path, referenceTo(site.kind, placed.group, placed.id));
+    }
+    copied.push(holder.slides[0]);
+  }
+  targetSlides.splice(at, 0, ...copied);
+  target.slides = targetSlides;
+  if (!hadCatalogs && isRec(target.catalogs) && Object.keys(target.catalogs).length === 0) delete target.catalogs;
+  return { document: target, slides: copied.map((_, offset) => at + offset), renamed, addedGroups, added, unresolved };
+}
+var pointerPart = (part) => part.replaceAll("~", "~0").replaceAll("/", "~1");
+function updateFromCatalog(document, catalogs, refs) {
+  const options = { catalogs: checkCatalogsOption(catalogs, "updateFromCatalog") };
+  const groups = rec(rec(document).catalogs);
+  const wanted = refs?.map((ref) => {
+    const parsed = parseReference(ref.reference);
+    return parsed ? { kind: ref.kind, group: parsed.group ?? "default", id: parsed.id } : void 0;
+  });
+  const changes = [];
+  for (const [group, value] of Object.entries(groups)) {
+    if (group === "custom" || !isRec(value)) continue;
+    const catalogSource = catalogGroupSource(document, group, options);
+    const registered = registeredCatalog(catalogSource, options);
+    if (!registered || catalogSource === void 0) continue;
+    for (const kind of catalogKinds)
+      for (const [id, embedded] of Object.entries(rec(value[kind]))) {
+        if (wanted && !wanted.some((entry) => entry && entry.kind === kind && entry.group === group && entry.id === id)) continue;
+        const current = registered[kind]?.[id];
+        if (current === void 0 || sameRecord(embedded, current)) continue;
+        changes.push({ kind, reference: group === "default" ? id : `${group}:${id}`, group, id, source: catalogSource, embedded: rec(embedded), current: embeddedCopy(current) });
+      }
+  }
+  return {
+    changes,
+    patch: changes.map((change) => ({ op: "replace", path: `/catalogs/${pointerPart(change.group)}/${change.kind}/${pointerPart(change.id)}`, value: change.current }))
+  };
+}
+var OPFMoveToCustomError = class extends Error {
+  code;
+  constructor(code, message) {
+    super(message);
+    this.name = "OPFMoveToCustomError";
+    this.code = code;
+  }
+};
+var pointerOf = (path) => `/${path.map((part) => pointerPart(String(part))).join("/")}`;
+function moveToCustom(document, ref, options = {}) {
+  const catalogs = { catalogs: checkCatalogsOption(options.catalogs, "moveToCustom") };
+  const parsed = parseReference(ref.reference);
+  if (!parsed || !catalogKinds.includes(ref.kind)) throw new OPFMoveToCustomError("invalid-reference", `moveToCustom: ${JSON.stringify(ref.reference)} is not a ${String(ref.kind)} reference (an id or name:id).`);
+  const { kind } = ref;
+  const fromGroup = parsed.group ?? "default";
+  if (fromGroup === "custom") throw new OPFMoveToCustomError("already-custom", `moveToCustom: ${ref.reference} already names a record of catalogs.custom.`);
+  const before = rec(document);
+  const records = rec(rec(rec(before.catalogs)[fromGroup])[kind]);
+  if (!Object.hasOwn(records, parsed.id)) throw new OPFMoveToCustomError("not-embedded", `moveToCustom: catalogs.${fromGroup}.${kind} does not embed ${JSON.stringify(parsed.id)}.`);
+  const fromId = parsed.id;
+  const record = rec(records[fromId]);
+  const sites = catalogReferenceSites(before);
+  const targets = sites.map((site) => resolveReference(before, site.kind, site.reference, { ...catalogs, ...site.group !== void 0 ? { group: site.group } : {} }));
+  const isMoved = (found) => found?.origin === "document" && found.kind === kind && found.group === fromGroup && found.id === fromId;
+  const inMoved = (site) => site.path.length >= 4 && site.path[0] === "catalogs" && site.path[1] === fromGroup && site.path[2] === kind && site.path[3] === fromId;
+  const after = structuredClone(before);
+  const groups = after.catalogs;
+  const custom = rec(groups.custom);
+  const existing = rec(custom[kind]);
+  const moved = structuredClone(record);
+  const ownSites = sites.map((site, index) => ({ site, found: targets[index] })).filter(({ site }) => inMoved(site));
+  if (options.id !== void 0 && (typeof options.id !== "string" || !CATALOG_GROUP_PATTERN.test(options.id))) throw new OPFMoveToCustomError("invalid-id", `moveToCustom: the new id ${JSON.stringify(options.id)} is not a lowercase kebab-case id.`);
+  const wanted = options.id ?? fromId;
+  let toId = wanted;
+  for (let n = 2; Object.hasOwn(existing, toId) && !sameRecord(existing[toId], moved); n++) toId = `${wanted}-${n}`;
+  const reused = Object.hasOwn(existing, toId);
+  const patch = [];
+  const fromRecords = groups[fromGroup][kind];
+  delete fromRecords[fromId];
+  patch.push({ op: "remove", path: pointerOf(["catalogs", fromGroup, kind, fromId]) });
+  if (Object.keys(fromRecords).length === 0) {
+    delete groups[fromGroup][kind];
+    patch.push({ op: "remove", path: pointerOf(["catalogs", fromGroup, kind]) });
+  }
+  if (!isRec(groups.custom)) {
+    groups.custom = {};
+    patch.push({ op: "add", path: pointerOf(["catalogs", "custom"]), value: {} });
+  }
+  if (!isRec(groups.custom[kind])) {
+    groups.custom[kind] = {};
+    patch.push({ op: "add", path: pointerOf(["catalogs", "custom", kind]), value: {} });
+  }
+  const referenceTo = (targetKind, group, id, holder) => {
+    const found = resolveReference(after, targetKind, id, { ...catalogs, ...holder !== void 0 ? { group: holder } : {} });
+    return found && found.group === group && found.id === id ? id : `${group}:${id}`;
+  };
+  if (!reused) {
+    groups.custom[kind][toId] = moved;
+    for (const { site, found } of ownSites) {
+      if (!found) continue;
+      const target = isMoved(found) ? { group: "custom", id: toId } : { group: found.group, id: found.id };
+      setAt(moved, site.path.slice(4), referenceTo(site.kind, target.group, target.id, "custom"));
+    }
+    patch.push({ op: "add", path: pointerOf(["catalogs", "custom", kind, toId]), value: structuredClone(moved) });
+  }
+  const references = [];
+  sites.forEach((site, index) => {
+    if (inMoved(site) || !isMoved(targets[index])) return;
+    const written = referenceTo(kind, "custom", toId, site.group);
+    if (written === site.reference) return;
+    setAt(after, site.path, written);
+    references.push(pointerOf(site.path));
+    patch.push({ op: "replace", path: pointerOf(site.path), value: written });
+  });
+  return {
+    document: after,
+    from: { kind, group: fromGroup, id: fromId, reference: fromGroup === "default" ? fromId : `${fromGroup}:${fromId}` },
+    to: { kind, group: "custom", id: toId, reference: toId },
+    references,
+    patch,
+    ...toId !== wanted ? { renamed: { from: wanted, to: toId } } : {}
+  };
+}
+
 // src/stats.ts
 var DEFAULT_WORDS_PER_MINUTE = 130;
 var KIND_ORDER = ["text", "items", "bullets", "quote", "metric", "code", "timeline", "chart", "table", "image", "video"];
@@ -55,20 +344,12 @@ var embeddedBytes = (src) => {
   return Math.max(0, Math.floor(payload.length * 3 / 4) - padding);
 };
 var srcOf = (asset) => typeof asset === "string" ? asset : isRecord(asset) && typeof asset.src === "string" ? asset.src : void 0;
-var lookup = (deck, kind, id) => {
-  const inline = deck.catalogs?.[kind]?.records;
-  const found = (Array.isArray(inline) ? inline : []).find((record) => record?.id === id) ?? catalogs[kind].find((record) => record.id === id);
-  return isRecord(found) ? found : void 0;
-};
-var themeRecord = (deck, value) => {
-  if (typeof value === "string") return lookup(deck, "themes", value) ?? {};
-  if (isRecord(value)) return { ...typeof value.id === "string" ? lookup(deck, "themes", value.id) : void 0, ...value };
-  return {};
-};
-function slideSize(deck) {
+function slideSize(deck, catalogs) {
   const design = isRecord(deck.design) ? deck.design : {};
-  const theme2 = themeRecord(deck, design.theme ?? "minimal");
-  const source = design.dimensions !== void 0 ? "design" : theme2.dimensions !== void 0 ? "theme" : "default";
+  const records = resolveDesignRecords(deck, void 0, catalogs);
+  const theme2 = records.theme;
+  const themed = typeof design.theme === "string" && !records.diagnostics.some((diagnostic) => diagnostic.kind === "themes");
+  const source = design.dimensions !== void 0 ? "design" : themed && theme2.dimensions !== void 0 ? "theme" : "default";
   const dimensions = design.dimensions ?? theme2.dimensions;
   let width = 40 / 3, height = 7.5;
   try {
@@ -110,6 +391,7 @@ function visitRuns(value, visit) {
   }
 }
 function stats(presentation2, options = {}) {
+  const catalogs = { catalogs: checkCatalogsOption(options.catalogs, "stats") };
   if (!isRecord(presentation2)) throw new TypeError("stats needs a presentation object.");
   const deck = presentation2;
   const wordsPerMinute = options.wordsPerMinute ?? DEFAULT_WORDS_PER_MINUTE;
@@ -178,8 +460,9 @@ function stats(presentation2, options = {}) {
     return srcOf(value) !== void 0;
   };
   const backgroundImage = (value) => {
-    if (!isRecord(value) || value.type !== "image" || !isRecord(value.image)) return false;
-    useAsset(value.image);
+    const picture = imageBackground(value);
+    if (!picture) return false;
+    useAsset(picture.src);
     return true;
   };
   const furnitureImages = (value) => {
@@ -193,7 +476,7 @@ function stats(presentation2, options = {}) {
     }
   };
   const designAssets = (value, scope) => {
-    if (!isRecord(value)) return 0;
+    if (!isRecord(value)) return;
     logoImages(value.logo);
     if (watermarkOf(value.watermark)) {
       if (scope === "deck") images.watermarks.deck = true;
@@ -205,7 +488,6 @@ function stats(presentation2, options = {}) {
     }
     furnitureImages(value.header);
     furnitureImages(value.footer);
-    return contentImage(value.slideImage);
   };
   const organizations = list(deck.organization).filter(isRecord).map((entry) => {
     const hasLogo = srcOf(entry.logo) !== void 0;
@@ -232,7 +514,7 @@ function stats(presentation2, options = {}) {
     filename: str(deck.filename),
     author: list(deck.author).filter((entry) => typeof entry === "string"),
     language: reference(deck.language),
-    slideSize: slideSize(deck),
+    slideSize: slideSize(deck, catalogs),
     template: deck.template === true,
     tags: Array.isArray(deck.tags) ? deck.tags.filter((tag) => typeof tag === "string") : [],
     takeaways: list(deck.takeaway).filter((entry) => typeof entry === "string").length,
@@ -246,7 +528,7 @@ function stats(presentation2, options = {}) {
   const datasetRecords = isRecord(deck.datasets) ? Object.entries(deck.datasets).filter(([, value]) => isRecord(value)) : [];
   const datasetUse = /* @__PURE__ */ new Map();
   const payloadCounts = { text: 0, items: 0, bullets: 0, quote: 0, metric: 0, code: 0, timeline: 0, chart: 0, table: 0, image: 0, video: 0, blocks: 0, regions: 0, groups: 0, maxDepth: 0 };
-  const layouts2 = /* @__PURE__ */ new Map(), chartTypes2 = /* @__PURE__ */ new Map(), extensions = /* @__PURE__ */ new Set();
+  const layouts = /* @__PURE__ */ new Map(), chartTypes = /* @__PURE__ */ new Map(), extensions = /* @__PURE__ */ new Set();
   const chartData = { inline: 0, dataset: 0, source: 0 };
   const tableItems = [];
   let tableRows = 0, tableColumns = 0, datasetBackedTables = 0, chartTotal = 0, captions = 0;
@@ -256,9 +538,7 @@ function stats(presentation2, options = {}) {
   const total = { citations: 0, footnotes: 0, links: 0, cited: /* @__PURE__ */ new Set(), families: /* @__PURE__ */ new Set() };
   const perSlide = [];
   const contentPerSlide = [];
-  const schemeReferences = [];
-  const deckTheme = themeRecord(deck, design.theme ?? "minimal");
-  schemeReferences.push(design.fontScheme ?? deckTheme.fontScheme ?? DEFAULT_FONT_SCHEME);
+  const schemeDesigns = [void 0];
   slides.forEach((slide, index) => {
     const id = str(slide.id);
     const ref = { index, id };
@@ -334,7 +614,7 @@ function stats(presentation2, options = {}) {
       if (isRecord(node.chart)) {
         chartTotal++;
         slideCharts++;
-        bump(chartTypes2, str(node.chart.type) ?? "unknown");
+        bump(chartTypes, str(node.chart.type) ?? "unknown");
         const data = node.chart.data;
         if (isRecord(data)) {
           if (typeof data.dataset === "string") {
@@ -397,7 +677,7 @@ function stats(presentation2, options = {}) {
     if (slide.beat !== void 0) withBeat++;
     if (slide.hidden === true) hidden.push(ref);
     const layout2 = str(slide.layout);
-    if (layout2) bump(layouts2, layout2);
+    if (layout2) bump(layouts, layout2);
     else withoutLayout++;
     const section = str(slide.section);
     if (section !== null && section !== "") {
@@ -407,13 +687,12 @@ function stats(presentation2, options = {}) {
     } else unsectioned++;
     if (slideDesign) {
       withOwnDesign++;
-      slideImages += designAssets(slideDesign, "slide");
+      designAssets(slideDesign, "slide");
       for (const kind of ["header", "footer"]) {
         if (slideDesign[kind] === false) headerOverrides[`${kind}Suppressed`]++;
         else if (isRecord(slideDesign[kind])) headerOverrides[kind]++;
       }
-      if (slideDesign.fontScheme !== void 0) schemeReferences.push(slideDesign.fontScheme);
-      else if (slideDesign.theme !== void 0 && design.fontScheme === void 0) schemeReferences.push(themeRecord(deck, slideDesign.theme).fontScheme ?? DEFAULT_FONT_SCHEME);
+      if (slideDesign.fontScheme !== void 0 || slideDesign.theme !== void 0 && design.fontScheme === void 0) schemeDesigns.push(index);
     }
     if (options.perSlide)
       perSlide.push({
@@ -459,24 +738,26 @@ function stats(presentation2, options = {}) {
     unused: variables.filter((variable) => variable.uses.length === 0).map((variable) => variable.id)
   };
   const families = new Set(total.families), schemeIds = /* @__PURE__ */ new Set(), unresolved = /* @__PURE__ */ new Set();
-  const addScheme = (value) => {
-    const resolved = resolveFontSchemeReference(value, (id2) => lookup(deck, "fontSchemes", id2));
-    if (resolved.diagnostic) unresolved.add(resolved.diagnostic.id);
-    const id = typeof value === "string" ? value : isRecord(value) && typeof value.id === "string" ? value.id : void 0;
-    if (id !== void 0) schemeIds.add(id);
-    const scheme = resolved.scheme;
+  const addScheme = (slideIndex) => {
+    const resolved = resolveDesignRecords(deck, slideIndex, catalogs);
+    for (const diagnostic of resolved.diagnostics) if (diagnostic.kind === "fontSchemes") unresolved.add(diagnostic.reference);
+    if (resolved.fontSchemeReference !== void 0) schemeIds.add(resolved.fontSchemeReference);
+    const scheme = resolved.fontScheme;
     const named = resolveFontFamilies(scheme);
     families.add(named.heading);
     families.add(named.body);
     if (scheme.code !== void 0) families.add(named.code);
     if (named.accent) families.add(named.accent);
   };
-  for (const entry of schemeReferences) addScheme(entry);
-  const catalogOverrides = {};
+  for (const entry of schemeDesigns) addScheme(entry);
+  const catalogGroups = {};
   if (isRecord(deck.catalogs))
-    for (const kind of Object.keys(deck.catalogs).sort()) {
-      const entry = deck.catalogs[kind];
-      if (isRecord(entry)) catalogOverrides[kind] = { records: Array.isArray(entry.records) ? entry.records.length : 0, source: str(entry.source) };
+    for (const group of Object.keys(deck.catalogs).sort()) {
+      const entry = deck.catalogs[group];
+      if (!isRecord(entry)) continue;
+      const records = {};
+      for (const kind of catalogKinds) if (isRecord(entry[kind])) records[kind] = Object.keys(entry[kind]).length;
+      catalogGroups[group] = { source: str(entry.source), records };
     }
   const colorVariables = variables.filter((variable) => variable.kind === "color").map((variable) => ({ id: variable.id, value: typeof variable.value === "string" ? variable.value : null, uses: variable.uses.length }));
   const contentMean = slides.length ? decimals(contentWords / slides.length, 1) : 0;
@@ -491,7 +772,7 @@ function stats(presentation2, options = {}) {
       withBeat,
       sections,
       unsectioned,
-      layouts: sortedCounts(layouts2),
+      layouts: sortedCounts(layouts),
       withoutLayout,
       withOwnDesign
     },
@@ -505,7 +786,7 @@ function stats(presentation2, options = {}) {
     notes: { withNotes, withoutNotes },
     speakingTime: { basis: "estimate", wordsPerMinute, notesWords, minutes: decimals(notesWords / wordsPerMinute, 1), declaredMinutes: deckFacts.declaredMinutes },
     images,
-    charts: { total: chartTotal, byType: sortedCounts(chartTypes2), data: chartData },
+    charts: { total: chartTotal, byType: sortedCounts(chartTypes), data: chartData },
     tables: { total: tableItems.length, datasetBacked: datasetBackedTables, rows: tableRows, columns: tableColumns, items: tableItems },
     datasets: { count: datasetItems.length, withSource: datasetItems.filter((item) => item.source !== null).length, items: datasetItems },
     citations: { references: references.length, cited, citations: total.citations, footnotes: total.footnotes, captions, links: total.links },
@@ -519,208 +800,10 @@ function stats(presentation2, options = {}) {
     fonts: { families: sorted(families), schemeIds: sorted(schemeIds), unresolvedSchemeIds: sorted(unresolved), runOverrides: sorted(total.families) },
     colors: { variables: colorVariables },
     extensions: sorted(extensions),
-    catalogOverrides
+    catalogs: catalogGroups
   };
   if (options.perSlide) result.perSlide = perSlide;
   return result;
 }
 
-// src/bundle.ts
-function reportKey(kind, id) {
-  return `${kind}:${id}`;
-}
-function referenceId(value) {
-  if (typeof value === "string" && bareIdPattern.test(value)) return value;
-  if (isRecord(value) && typeof value.id === "string" && bareIdPattern.test(value.id)) return value.id;
-  return void 0;
-}
-function addReference(collector, kind, value, reportable) {
-  const id = referenceId(value);
-  if (!id) return;
-  if (reportable) collector.reportable.add(reportKey(kind, id));
-  let ids = collector.referenced.get(kind);
-  if (!ids) {
-    ids = /* @__PURE__ */ new Set();
-    collector.referenced.set(kind, ids);
-  }
-  if (ids.has(id)) return;
-  ids.add(id);
-  collector.queue.push({ kind, id });
-}
-function collectDesignReferences(collector, design) {
-  if (!isRecord(design)) return;
-  addReference(collector, "themes", design.theme, true);
-  addReference(collector, "colorSchemes", design.colorScheme, true);
-  addReference(collector, "fontSchemes", design.fontScheme, true);
-  if (isRecord(design.theme)) {
-    addReference(collector, "colorSchemes", design.theme.colorScheme, true);
-    addReference(collector, "fontSchemes", design.theme.fontScheme, true);
-  }
-}
-function collectChartReference(collector, payload) {
-  if (!isRecord(payload.chart)) return;
-  addReference(collector, "chartTypes", payload.chart.type, typeof payload.chart.type === "string");
-}
-function collectSocialReferences(collector, holder) {
-  const entries = Array.isArray(holder) ? holder : [holder];
-  for (const entry of entries) {
-    if (!isRecord(entry) || !isRecord(entry.socials)) continue;
-    for (const key of Object.keys(entry.socials)) addReference(collector, "socialPlatforms", key, false);
-  }
-}
-function collectBeatReferences(collector, narrative2) {
-  if (!isRecord(narrative2) || !Array.isArray(narrative2.beats)) return;
-  for (const beat of narrative2.beats) {
-    if (isRecord(beat)) addReference(collector, "layouts", beat.layout, false);
-  }
-}
-function collectLanguageReferences(collector, language2) {
-  addReference(collector, "languages", language2, false);
-  if (!isRecord(language2)) return;
-  addReference(collector, "fontSchemes", language2.fontScheme, false);
-  addReference(collector, "fontSchemes", language2.googleFontScheme, false);
-}
-function collectDocumentReferences(collector, document) {
-  addReference(collector, "narratives", document.narrative, typeof document.narrative === "string");
-  addReference(collector, "tones", document.tone, false);
-  addReference(collector, "purposes", document.purpose, false);
-  collectLanguageReferences(collector, document.language);
-  if (Array.isArray(document.audience)) {
-    for (const entry of document.audience) addReference(collector, "audiences", entry, true);
-  } else if (isRecord(document.audience)) {
-    addReference(collector, "audiences", document.audience, true);
-  } else {
-    addReference(collector, "audiences", document.audience, typeof document.audience === "string");
-  }
-  collectDesignReferences(collector, document.design);
-  collectSocialReferences(collector, document.organization);
-  collectSocialReferences(collector, document.speaker);
-  if (!Array.isArray(document.slides)) return;
-  for (const slide of document.slides) {
-    if (!isRecord(slide)) continue;
-    addReference(collector, "layouts", slide.layout, false);
-    collectDesignReferences(collector, slide.design);
-    collectChartReference(collector, slide);
-    visitContentPayloads(slide, "", (payload) => {
-      collectChartReference(collector, payload);
-    });
-  }
-}
-function collectRecordReferences(collector, kind, record) {
-  if (kind === "themes") {
-    addReference(collector, "colorSchemes", record.colorScheme, false);
-    addReference(collector, "fontSchemes", record.fontScheme, false);
-  } else if (kind === "narratives") {
-    collectBeatReferences(collector, record);
-  } else if (kind === "languages") {
-    addReference(collector, "fontSchemes", record.fontScheme, false);
-    addReference(collector, "fontSchemes", record.googleFontScheme, false);
-  }
-}
-var bundledIndex;
-function bundledCatalogIndex() {
-  if (bundledIndex) return bundledIndex;
-  const index = /* @__PURE__ */ new Map();
-  for (const entry of catalogEntries) {
-    const records = /* @__PURE__ */ new Map();
-    for (const record of entry.records) {
-      if (isRecord(record) && typeof record.id === "string") records.set(record.id, record);
-    }
-    index.set(entry.kind, records);
-  }
-  bundledIndex = index;
-  return index;
-}
-function bundledRecord(kind, id) {
-  const record = bundledCatalogIndex().get(kind)?.get(id);
-  if (!record) return void 0;
-  const clone = structuredClone(record);
-  delete clone.$schema;
-  return clone;
-}
-function readKindState(catalogsField, kind) {
-  const entry = catalogsField[kind];
-  const inline = /* @__PURE__ */ new Map();
-  if (!isRecord(entry)) return { customSource: false, inline };
-  if (Array.isArray(entry.records)) {
-    for (const record of entry.records) {
-      if (isRecord(record) && typeof record.id === "string") inline.set(record.id, record);
-    }
-  }
-  const customSource = typeof entry.source === "string" || Array.isArray(entry.source) && entry.source.length > 0;
-  return { customSource, inline };
-}
-function kindState(states, catalogsField, kind) {
-  const cached = states.get(kind);
-  if (cached) return cached;
-  const state = readKindState(catalogsField, kind);
-  states.set(kind, state);
-  return state;
-}
-function pushReportId(map, kind, id) {
-  const list2 = map[kind];
-  if (list2) list2.push(id);
-  else map[kind] = [id];
-}
-function bundle(value) {
-  const report = { added: {}, alreadyInline: {}, keptSources: [], unresolved: {} };
-  if (!isRecord(value)) {
-    return { presentation: value, report };
-  }
-  const presentation2 = structuredClone(value);
-  if (presentation2.catalogs !== void 0 && !isRecord(presentation2.catalogs)) {
-    return { presentation: presentation2, report };
-  }
-  const catalogsField = isRecord(presentation2.catalogs) ? presentation2.catalogs : {};
-  const collector = { queue: [], referenced: /* @__PURE__ */ new Map(), reportable: /* @__PURE__ */ new Set() };
-  collectDocumentReferences(collector, presentation2);
-  const states = /* @__PURE__ */ new Map();
-  const resolved = /* @__PURE__ */ new Map();
-  for (let index = 0; index < collector.queue.length; index += 1) {
-    const pending = collector.queue[index];
-    if (!pending) continue;
-    const { kind, id } = pending;
-    const state = kindState(states, catalogsField, kind);
-    const inlineRecord = state.inline.get(id);
-    if (inlineRecord) {
-      collectRecordReferences(collector, kind, inlineRecord);
-      continue;
-    }
-    if (state.customSource) continue;
-    const record = bundledRecord(kind, id);
-    if (!record) continue;
-    let kindRecords = resolved.get(kind);
-    if (!kindRecords) {
-      kindRecords = /* @__PURE__ */ new Map();
-      resolved.set(kind, kindRecords);
-    }
-    kindRecords.set(id, record);
-    collectRecordReferences(collector, kind, record);
-  }
-  for (const [kind, ids] of collector.referenced) {
-    const state = kindState(states, catalogsField, kind);
-    if (state.customSource) report.keptSources.push(kind);
-    const kindResolved = resolved.get(kind);
-    const addedIds = [];
-    for (const id of [...ids].sort()) {
-      if (state.inline.has(id)) pushReportId(report.alreadyInline, kind, id);
-      else if (kindResolved?.has(id)) addedIds.push(id);
-      else if (!state.customSource && collector.reportable.has(reportKey(kind, id))) {
-        pushReportId(report.unresolved, kind, id);
-      }
-    }
-    if (!addedIds.length) continue;
-    if (!isRecord(presentation2.catalogs)) presentation2.catalogs = {};
-    const catalogs2 = presentation2.catalogs;
-    if (!isRecord(catalogs2[kind])) catalogs2[kind] = {};
-    const entry = catalogs2[kind];
-    if (!Array.isArray(entry.records)) entry.records = [];
-    const records = entry.records;
-    for (const id of addedIds) records.push(kindResolved?.get(id));
-    report.added[kind] = addedIds;
-  }
-  report.keptSources.sort();
-  return { presentation: presentation2, report };
-}
-
-export { bundle, stats };
+export { OPFMoveToCustomError, copySlides, embed, moveToCustom, sameRecord, stats, updateFromCatalog };