@openpresentation/opf 0.17.0 → 0.18.3

package/dist/{chunk-WWYWFVOI.js → chunk-IM337HP5.js}

@@ -1,6 +1,58 @@
-import { isRecord, visitContentPayloads, listVariables, resolveDesignRecords, resolveFontFamilies, resolveCanvasDimensions, imageBackground } from './chunk-CW7GEAV3.js';
+import { OPFDataImportError, parseTabularData } from './chunk-ZCFSDSUX.js';
+import { applyPatchWithInverse } from './chunk-WHHLGDCQ.js';
+import { validate, OPFValidationError } from './chunk-KA3ZPFVT.js';
+import { isRecord, visitContentPayloads, listVariables, resolveVariables, LOGO_SHAPES, resolveDesignRecords, resolveFontFamilies, resolveCanvasDimensions, imageBackground } from './chunk-MBU42S5Y.js';
 import { embeddedCopy, checkCatalogsOption, catalogReferenceSites, parseReference, catalogGroupDeclared, resolveReference, dottedPath, unresolvedReference, recordReferenceSites, catalogGroupSource, registeredCatalog, catalogKinds, CATALOG_GROUP_PATTERN } from './chunk-SPFV27O5.js';
 
+// src/api-errors.ts
+var OPFApiError = class extends Error {
+  code;
+  details;
+  findings;
+  constructor(message, code, extra = {}) {
+    super(message, extra.cause === void 0 ? void 0 : { cause: extra.cause });
+    this.name = new.target.name;
+    this.code = code;
+    this.details = extra.details ?? {};
+    this.findings = extra.findings ?? [];
+  }
+};
+var OPFExportError = class extends OPFApiError {
+};
+var OPFImportError = class extends OPFApiError {
+};
+function asApiError(Class, error, fallbackCode) {
+  if (error instanceof Class) return error;
+  if (error instanceof OPFApiError) return new Class(error.message, error.code, { details: error.details, findings: error.findings, cause: error });
+  const failure = error;
+  return new Class(failure?.message ?? String(error), typeof failure?.code === "string" ? failure.code : fallbackCode, { cause: error });
+}
+
+// src/slide-selection.ts
+var isSlideNumber = (value) => typeof value === "number" && Number.isInteger(value) && value >= 1;
+function parseSlideSelection(selection, total, label = "slides") {
+  if (!(total >= 1)) throw new OPFApiError("The presentation has no slides.", "no-slides");
+  const listed = typeof selection === "number" ? [selection] : Array.isArray(selection) ? selection : void 0;
+  if (listed) {
+    const bad = listed.find((value) => !isSlideNumber(value));
+    if (bad !== void 0 || listed.length === 0) throw new OPFApiError(`${label} needs slide numbers counted from 1 (got ${JSON.stringify(bad ?? listed)}).`, "invalid-option");
+  } else if (typeof selection !== "string") throw new OPFApiError(`${label} needs a slide number, a list of numbers or text like "1,3-5".`, "invalid-option");
+  const spec = listed ? listed.join(",") : selection;
+  const chosen = /* @__PURE__ */ new Set();
+  for (const part of spec.split(",")) {
+    const text = part.trim();
+    const match = /^(\d*)(-?)(\d*)$/.exec(text);
+    if (!text || !match || !match[1] && !match[3]) throw new OPFApiError(`${label} needs numbers like 1,3-5 (got "${spec}").`, "invalid-option");
+    const [, from, dash, to] = match;
+    const first = from ? Number(from) : 1;
+    const last = dash ? to ? Number(to) : total : first;
+    if (first < 1 || last < first) throw new OPFApiError(`${label} range "${text}" is not valid (slides count from 1).`, "invalid-option");
+    if (last > total) throw new OPFApiError(`${label} ${text} is outside the presentation, which has ${total} slide${total === 1 ? "" : "s"}.`, "invalid-option");
+    for (let n = first; n <= last; n++) chosen.add(n);
+  }
+  return [...chosen].sort((a, b) => a - b);
+}
+
 // src/catalog-helpers.ts
 var isRec = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 var rec = (value) => isRec(value) ? value : {};
@@ -294,9 +346,8 @@ function moveToCustom(document, ref, options = {}) {
 // src/stats.ts
 var DEFAULT_WORDS_PER_MINUTE = 130;
 var KIND_ORDER = ["text", "items", "bullets", "quote", "metric", "code", "timeline", "chart", "table", "image", "video"];
-var FURNITURE_FIELDS = ["logo", "image", "text", "socials", "date"];
+var FURNITURE_FIELDS = ["image", "text", "socials", "date"];
 var ZONES = ["left", "center", "right"];
-var LOGO_VARIANTS = ["default", "light", "dark", "stacked", "stackedLight", "stackedDark", "icon", "iconLight", "iconDark", "wordmark", "wordmarkLight", "wordmarkDark"];
 var WORD = /[\p{L}\p{N}\p{M}]+(?:['’.,-][\p{L}\p{N}\p{M}]+)*/gu;
 var UNSPACED = /[฀-໿က-႟ក-៿぀-ヿ㐀-䶿一-鿿豈-﫿]/gu;
 var wordCount = (text) => {
@@ -417,7 +468,7 @@ function stats(presentation2, options = {}) {
   const images = { content: { total: 0, withAlt: 0, decorative: 0, missingAlt: 0 }, logos: 0, watermarks: { deck: false, slides: 0 }, backgrounds: { deck: false, slides: 0 }, headerFooter: 0, speakerPhotos: 0, videos: 0 };
   const contentImage = (asset) => {
     if (srcOf(asset) === void 0) return 0;
-    useAsset(asset);
+    if (!String(srcOf(asset)).startsWith("var:organization.")) useAsset(asset);
     images.content.total++;
     const alt = altOf(asset);
     if (alt === void 0 || alt !== "" && alt.trim() === "") images.content.missingAlt++;
@@ -425,18 +476,14 @@ function stats(presentation2, options = {}) {
     else images.content.withAlt++;
     return 1;
   };
-  const logoImages = (value) => {
-    if (srcOf(value) !== void 0) {
-      useAsset(value);
-      images.logos++;
-      return;
-    }
-    if (isRecord(value)) {
-      for (const variant of LOGO_VARIANTS) if (srcOf(value[variant]) !== void 0) {
-        useAsset(value[variant]);
-        images.logos++;
-      }
-    }
+  const logoAssets = (value) => {
+    if (srcOf(value) !== void 0) return [value];
+    if (!isRecord(value)) return [];
+    return LOGO_SHAPES.flatMap((shape) => {
+      const entry = value[shape];
+      if (srcOf(entry) !== void 0) return [entry];
+      return isRecord(entry) ? [entry.onLight, entry.onDark].filter((tone2) => srcOf(tone2) !== void 0) : [];
+    });
   };
   const watermarkOf = (value) => {
     if (value === void 0 || value === false) return false;
@@ -453,15 +500,13 @@ function stats(presentation2, options = {}) {
     if (!isRecord(value)) return;
     for (const zone of ZONES) {
       const item = value[zone];
-      if (isRecord(item) && srcOf(item.image) !== void 0) {
-        useAsset(item.image);
-        images.headerFooter++;
-      }
+      if (!isRecord(item) || srcOf(item.image) === void 0) continue;
+      if (!String(srcOf(item.image)).startsWith("var:organization.")) useAsset(item.image);
+      images.headerFooter++;
     }
   };
   const designAssets = (value, scope) => {
     if (!isRecord(value)) return;
-    logoImages(value.logo);
     if (watermarkOf(value.watermark)) {
       if (scope === "deck") images.watermarks.deck = true;
       else images.watermarks.slides++;
@@ -474,11 +519,12 @@ function stats(presentation2, options = {}) {
     furnitureImages(value.footer);
   };
   const organizations = list(deck.organization).filter(isRecord).map((entry) => {
-    const hasLogo = srcOf(entry.logo) !== void 0;
-    if (hasLogo) {
-      useAsset(entry.logo);
+    const logos = logoAssets(entry.logo);
+    for (const logo of logos) {
+      useAsset(logo);
       images.logos++;
     }
+    const hasLogo = logos.length > 0;
     return { id: str(entry.id) ?? "", name: str(entry.name) ?? "", role: str(entry.role), hasLogo };
   });
   const speakers = list(deck.speaker).filter(isRecord).map((entry) => {
@@ -790,4 +836,84 @@ function stats(presentation2, options = {}) {
   return result;
 }
 
-export { OPFMoveToCustomError, copySlides, embed, moveToCustom, sameRecord, stats, updateFromCatalog };
+// src/edit.ts
+function edit(deck, patch, options = {}) {
+  const result = applyPatchWithInverse(deck, patch);
+  const presentation2 = result.presentation;
+  if (options.validate === false) return { presentation: presentation2, findings: [], inverse: result.inverse };
+  const report = validate(presentation2, { only: ["format", "references"], ...options.catalogs ? { catalogs: options.catalogs } : {} });
+  if (!report.valid) throw new OPFValidationError(report);
+  return { presentation: presentation2, findings: report.findings, inverse: result.inverse };
+}
+
+// src/fill.ts
+var isRecord2 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+function fillRecords(raw, options = {}) {
+  const format2 = options.format ?? (/^[\s\uFEFF]*[[{]/.test(raw) ? "json" : "csv");
+  if (format2 === "json") {
+    let value;
+    try {
+      value = JSON.parse(raw.replace(/^\uFEFF/, ""));
+    } catch {
+      throw new OPFDataImportError("Invalid JSON data.");
+    }
+    if (isRecord2(value) && !("columns" in value && "rows" in value)) return [value];
+    if (Array.isArray(value) && value.length && value.every(isRecord2)) return value;
+    if (Array.isArray(value) && !value.length) throw new OPFDataImportError("Data contains no records.");
+  }
+  const table = parseTabularData(raw, { format: format2, header: options.header, delimiter: options.delimiter });
+  if (!table.rows.length) throw new OPFDataImportError("Data contains no records.");
+  return table.rows.map((row) => Object.fromEntries(table.columns.map((column, index) => [column, row[index] === "" ? null : row[index]])));
+}
+function fill(template, data, options = {}) {
+  if (!isRecord2(template)) throw new TypeError("fill expects a template object.");
+  const records = data === void 0 ? [{}] : typeof data === "string" ? fillRecords(data, options) : Array.isArray(data) ? [...data] : [data];
+  if (!records.length) throw new OPFDataImportError("Data contains no records.");
+  if (!records.every(isRecord2)) throw new OPFDataImportError("Each record must be an object keyed by variable id.");
+  const decks = records.map((record, offset) => ({ index: offset + 1, record, ...resolveVariables(template, record, { template: false, partial: options.partial === true, examples: options.examples === true }) }));
+  return {
+    decks: decks.map(({ index, record, presentation: presentation2, diagnostics, unfilled, complete }) => ({ index, record, presentation: presentation2, diagnostics, unfilled, complete })),
+    ...options.combine ? { presentation: combine(decks) } : {},
+    complete: decks.every((deck) => deck.complete),
+    unfilled: [...new Set(decks.flatMap((deck) => deck.unfilled))],
+    diagnostics: summarize(decks)
+  };
+}
+function combine(decks) {
+  const first = decks[0];
+  const seen = /* @__PURE__ */ new Set();
+  const slides = [];
+  const assets = {};
+  for (const deck of decks) {
+    for (const slide of Array.isArray(deck.presentation.slides) ? deck.presentation.slides : []) {
+      if (isRecord2(slide) && typeof slide.id === "string") {
+        let id = slide.id;
+        if (seen.has(id)) {
+          id = `${slide.id}-${deck.index}`;
+          for (let suffix = 2; seen.has(id); suffix++) id = `${slide.id}-${deck.index}-${suffix}`;
+        }
+        seen.add(id);
+        slides.push(id === slide.id ? slide : { ...slide, id });
+      } else slides.push(slide);
+    }
+    if (isRecord2(deck.presentation.assets)) {
+      for (const [key, value] of Object.entries(deck.presentation.assets)) if (!(key in assets)) assets[key] = value;
+    }
+  }
+  return { ...first.presentation, ...Object.keys(assets).length ? { assets } : {}, slides };
+}
+function summarize(decks) {
+  const merged = /* @__PURE__ */ new Map();
+  for (const deck of decks) {
+    for (const diagnostic of deck.diagnostics) {
+      if (diagnostic.severity === "info") continue;
+      const key = `${diagnostic.code}\0${diagnostic.id}\0${diagnostic.path}`;
+      const entry = merged.get(key);
+      if (entry) entry.records.push(deck.index);
+      else merged.set(key, { ...diagnostic, records: [deck.index] });
+    }
+  }
+  return [...merged.values()];
+}
+
+export { OPFApiError, OPFExportError, OPFImportError, OPFMoveToCustomError, asApiError, copySlides, edit, embed, fill, fillRecords, moveToCustom, parseSlideSelection, sameRecord, stats, updateFromCatalog };

package/dist/{chunk-YT7FMQER.js → chunk-JCOSZTOI.js}

@@ -1,4 +1,4 @@
-import { presentation } from './chunk-RA64UQKI.js';
+import { presentation } from './chunk-2PEWUUBR.js';
 
 // src/format.ts
 var OPFFormatError = class extends Error {