@openpresentation/opf 0.10.1 → 0.11.1

package/dist/{chunk-ZIL7MGZU.js → chunk-M4GTWRK7.js}

@@ -1,9 +1,89 @@
-import { MAX_COMPOSITION_DEPTH, tableGrid } from './chunk-PQJRDNA6.js';
-import { schemas, schemaEntries } from './chunk-D3GQIREP.js';
-import { catalogSchemaNames } from './chunk-TU7I3KSB.js';
+import { MAX_COMPOSITION_DEPTH, tableGrid } from './chunk-6UPHKXI5.js';
+import { schemas, schemaEntries } from './chunk-LTSDDBNW.js';
+import { catalogSchemaNames } from './chunk-7LF37SG3.js';
 import Ajv2020 from 'ajv/dist/2020.js';
 import addFormats from 'ajv-formats';
 
+// src/content-walk.ts
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function pathFor(parentPath, key) {
+  return parentPath === "/" ? `/${key}` : `${parentPath}/${key.replaceAll("~", "~0").replaceAll("/", "~1")}`;
+}
+var bareIdPattern = /^[a-z0-9][a-z0-9-]*$/;
+var promotedRegionKeys = [
+  "left",
+  "center",
+  "right",
+  "left+center",
+  "center+right",
+  "left+center+right",
+  "top",
+  "middle",
+  "bottom",
+  "top+middle",
+  "middle+bottom",
+  "top+middle+bottom",
+  "top:left",
+  "top:center",
+  "top:right",
+  "top:left+center",
+  "top:center+right",
+  "top:left+center+right",
+  "middle:left",
+  "middle:center",
+  "middle:right",
+  "middle:left+center",
+  "middle:center+right",
+  "middle:left+center+right",
+  "bottom:left",
+  "bottom:center",
+  "bottom:right",
+  "bottom:left+center",
+  "bottom:center+right",
+  "bottom:left+center+right",
+  "top+middle:left",
+  "top+middle:center",
+  "top+middle:right",
+  "top+middle:left+center",
+  "top+middle:center+right",
+  "top+middle:left+center+right",
+  "middle+bottom:left",
+  "middle+bottom:center",
+  "middle+bottom:right",
+  "middle+bottom:left+center",
+  "middle+bottom:center+right",
+  "middle+bottom:left+center+right",
+  "top+middle+bottom:left",
+  "top+middle+bottom:center",
+  "top+middle+bottom:right",
+  "top+middle+bottom:left+center",
+  "top+middle+bottom:center+right",
+  "top+middle+bottom:left+center+right"
+];
+function visitContentPayloads(slide, slidePath, visit) {
+  const walk = (payload, path, depth, ancestors) => {
+    visit(payload, path);
+    if (!Array.isArray(payload.blocks) || depth >= MAX_COMPOSITION_DEPTH || ancestors.includes(payload)) return;
+    const nested = [...ancestors, payload];
+    const blocksPath = pathFor(path, "blocks");
+    payload.blocks.forEach((block, index) => {
+      if (isRecord(block)) walk(block, `${blocksPath}/${index}`, depth + 1, nested);
+    });
+  };
+  if (Array.isArray(slide.blocks)) {
+    const blocksPath = pathFor(slidePath, "blocks");
+    slide.blocks.forEach((block, index) => {
+      if (isRecord(block)) walk(block, `${blocksPath}/${index}`, 0, []);
+    });
+  }
+  for (const key of promotedRegionKeys) {
+    const region = slide[key];
+    if (isRecord(region)) walk(region, pathFor(slidePath, key), 0, []);
+  }
+}
+
 // src/generated/catalog-ids.ts
 var catalogIds = {
   audiences: [
@@ -16,7 +96,19 @@ var catalogIds = {
     "marketing-team",
     "all-hands",
     "candidates",
-    "regulators"
+    "regulators",
+    "executive",
+    "investor",
+    "technical",
+    "sales",
+    "marketing",
+    "academic",
+    "internal-team",
+    "customer",
+    "general-public",
+    "media",
+    "partner",
+    "regulatory"
   ],
   purposes: [
     "inform",
@@ -77,6 +169,32 @@ var catalogIds = {
     "title-subtitle"
   ],
   chartTypes: [
+    "100pct-stacked-area-3x",
+    "100pct-stacked-bar-3x",
+    "100pct-stacked-column-3x",
+    "area",
+    "bar",
+    "box-and-whisker",
+    "column",
+    "doughnut",
+    "filled-radar",
+    "funnel",
+    "histogram",
+    "line",
+    "line-with-markers",
+    "pareto",
+    "pie",
+    "radar",
+    "radar-with-markers",
+    "scatter",
+    "stacked-area-3x",
+    "stacked-bar-3x",
+    "stacked-column-3x",
+    "stacked-line-3x",
+    "stacked-line-with-markers-3x",
+    "treemap",
+    "waterfall",
+    "world",
     "100pct-bullet-bar",
     "100pct-bullet-bar-2x",
     "100pct-bullet-bar-3x",
@@ -85,15 +203,9 @@ var catalogIds = {
     "100pct-bullet-column-3x",
     "100pct-progress-bar",
     "100pct-stacked-area-2x",
-    "100pct-stacked-area-3x",
     "100pct-stacked-bar-2x",
-    "100pct-stacked-bar-3x",
     "100pct-stacked-column-2x",
-    "100pct-stacked-column-3x",
-    "area",
     "australia",
-    "bar",
-    "box-and-whisker",
     "box-and-whisker-2x",
     "box-and-whisker-3x",
     "bullet-bar",
@@ -105,31 +217,19 @@ var catalogIds = {
     "canada",
     "clustered-bar-2x",
     "clustered-column",
-    "column",
     "dot-plot",
     "dot-plot-2x",
     "dot-plot-3x",
     "dot-plot-4x",
     "dot-plot-5x",
     "dot-plot-6x",
-    "doughnut",
     "dumbbell",
-    "filled-radar",
-    "funnel",
-    "histogram",
-    "line",
     "line-2x",
     "line-3x",
     "line-with-high-low",
     "line-with-high-low-and-markers",
-    "line-with-markers",
     "line-with-markers-2x",
     "line-with-markers-3x",
-    "pareto",
-    "pie",
-    "radar",
-    "radar-with-markers",
-    "scatter",
     "sparkline",
     "sparkline-2x",
     "sparkline-3x",
@@ -137,26 +237,21 @@ var catalogIds = {
     "sparkline-5x",
     "sparkline-6x",
     "stacked-area-2x",
-    "stacked-area-3x",
     "stacked-bar-2x",
-    "stacked-bar-3x",
     "stacked-column-2x",
-    "stacked-column-3x",
     "stacked-line-2x",
-    "stacked-line-3x",
     "stacked-line-with-markers-2x",
-    "stacked-line-with-markers-3x",
-    "treemap",
     "treemap-2x",
     "treemap-3x",
     "united-kingdom",
-    "united-states",
-    "waterfall",
-    "world"
+    "united-states"
   ],
   narratives: [
     "problem-solution",
     "scqa",
+    "pyramid-principle",
+    "situation-complication-resolution",
+    "what-so-what-now-what",
     "strategic-narrative",
     "golden-circle",
     "conference-talk",
@@ -165,15 +260,20 @@ var catalogIds = {
     "early-startup-pitch",
     "venture-pitch",
     "persuasive-sales",
+    "sparkline",
     "company-intro",
     "marketing-strategy",
     "product-launch",
     "strategic-advisory",
     "challenge-resolution",
     "project-proposal",
+    "vision-roadmap",
     "failure-analysis",
+    "star-method",
     "classic-story",
+    "heros-journey",
     "business-narrative",
+    "change-story",
     "rags-to-riches",
     "underdog-victory",
     "survival-story",
@@ -191,6 +291,7 @@ var catalogIds = {
     "performance-review",
     "survey-analysis",
     "trend-analysis",
+    "data-story",
     "employee-review",
     "performance-improvement-plan",
     "capacity-planning"
@@ -410,6 +511,58 @@ var catalogIds = {
     "yu-gothic"
   ]
 };
+var deprecatedCatalogIds = {
+  "chartTypes/100pct-bullet-bar": "100pct-stacked-bar-3x",
+  "chartTypes/100pct-bullet-bar-2x": "100pct-stacked-bar-3x",
+  "chartTypes/100pct-bullet-bar-3x": "100pct-stacked-bar-3x",
+  "chartTypes/100pct-bullet-column": "100pct-stacked-column-3x",
+  "chartTypes/100pct-bullet-column-2x": "100pct-stacked-column-3x",
+  "chartTypes/100pct-bullet-column-3x": "100pct-stacked-column-3x",
+  "chartTypes/100pct-progress-bar": "100pct-stacked-bar-3x",
+  "chartTypes/100pct-stacked-area-2x": "100pct-stacked-area-3x",
+  "chartTypes/100pct-stacked-bar-2x": "100pct-stacked-bar-3x",
+  "chartTypes/100pct-stacked-column-2x": "100pct-stacked-column-3x",
+  "chartTypes/australia": "world",
+  "chartTypes/box-and-whisker-2x": "box-and-whisker",
+  "chartTypes/box-and-whisker-3x": "box-and-whisker",
+  "chartTypes/bullet-bar": "bar",
+  "chartTypes/bullet-bar-2x": "bar",
+  "chartTypes/bullet-bar-3x": "bar",
+  "chartTypes/bullet-column": "column",
+  "chartTypes/bullet-column-2x": "column",
+  "chartTypes/bullet-column-3x": "column",
+  "chartTypes/canada": "world",
+  "chartTypes/clustered-bar-2x": "bar",
+  "chartTypes/clustered-column": "column",
+  "chartTypes/dot-plot": "scatter",
+  "chartTypes/dot-plot-2x": "scatter",
+  "chartTypes/dot-plot-3x": "scatter",
+  "chartTypes/dot-plot-4x": "scatter",
+  "chartTypes/dot-plot-5x": "scatter",
+  "chartTypes/dot-plot-6x": "scatter",
+  "chartTypes/dumbbell": "scatter",
+  "chartTypes/line-2x": "line",
+  "chartTypes/line-3x": "line",
+  "chartTypes/line-with-high-low": "line",
+  "chartTypes/line-with-high-low-and-markers": "line-with-markers",
+  "chartTypes/line-with-markers-2x": "line-with-markers",
+  "chartTypes/line-with-markers-3x": "line-with-markers",
+  "chartTypes/sparkline": "line",
+  "chartTypes/sparkline-2x": "line",
+  "chartTypes/sparkline-3x": "line",
+  "chartTypes/sparkline-4x": "line",
+  "chartTypes/sparkline-5x": "line",
+  "chartTypes/sparkline-6x": "line",
+  "chartTypes/stacked-area-2x": "stacked-area-3x",
+  "chartTypes/stacked-bar-2x": "stacked-bar-3x",
+  "chartTypes/stacked-column-2x": "stacked-column-3x",
+  "chartTypes/stacked-line-2x": "stacked-line-3x",
+  "chartTypes/stacked-line-with-markers-2x": "stacked-line-with-markers-3x",
+  "chartTypes/treemap-2x": "treemap",
+  "chartTypes/treemap-3x": "treemap",
+  "chartTypes/united-kingdom": "world",
+  "chartTypes/united-states": "world"
+};
 
 // src/validation-definitions.ts
 var schemaLocations;
@@ -466,56 +619,6 @@ var OPFValidationError = class extends Error {
 var schemaNameByCatalogKind = catalogSchemaNames;
 var ajv;
 var dynamicSchemaCache = /* @__PURE__ */ new WeakMap();
-var promotedRegionKeys = [
-  "left",
-  "center",
-  "right",
-  "left+center",
-  "center+right",
-  "left+center+right",
-  "top",
-  "middle",
-  "bottom",
-  "top+middle",
-  "middle+bottom",
-  "top+middle+bottom",
-  "top:left",
-  "top:center",
-  "top:right",
-  "top:left+center",
-  "top:center+right",
-  "top:left+center+right",
-  "middle:left",
-  "middle:center",
-  "middle:right",
-  "middle:left+center",
-  "middle:center+right",
-  "middle:left+center+right",
-  "bottom:left",
-  "bottom:center",
-  "bottom:right",
-  "bottom:left+center",
-  "bottom:center+right",
-  "bottom:left+center+right",
-  "top+middle:left",
-  "top+middle:center",
-  "top+middle:right",
-  "top+middle:left+center",
-  "top+middle:center+right",
-  "top+middle:left+center+right",
-  "middle+bottom:left",
-  "middle+bottom:center",
-  "middle+bottom:right",
-  "middle+bottom:left+center",
-  "middle+bottom:center+right",
-  "middle+bottom:left+center+right",
-  "top+middle+bottom:left",
-  "top+middle+bottom:center",
-  "top+middle+bottom:right",
-  "top+middle+bottom:left+center",
-  "top+middle+bottom:center+right",
-  "top+middle+bottom:left+center+right"
-];
 var promotedRegionKeySet = new Set(promotedRegionKeys);
 var rootPayloadFields = [
   "type",
@@ -655,18 +758,12 @@ function semanticIssue(path, message, params = {}) {
     params
   };
 }
-function isRecord(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
 function hasOwn(value, key) {
   return Object.hasOwn(value, key);
 }
 function isEnUkTag(value) {
   return typeof value === "string" && value.toLowerCase() === "en-uk";
 }
-function pathFor(parentPath, key) {
-  return parentPath === "/" ? `/${key}` : `${parentPath}/${key.replaceAll("~", "~0").replaceAll("/", "~1")}`;
-}
 function presentFields(value, fields) {
   return fields.filter((field) => hasOwn(value, field));
 }
@@ -839,27 +936,32 @@ function validatePresentationSemantics(value) {
       replacement: "en-GB"
     }));
   }
-  const slideIds = /* @__PURE__ */ new Set();
+  const documentIds = /* @__PURE__ */ new Map();
   value.slides.forEach((slide, index) => {
     if (isRecord(slide)) {
+      const slidePath = `/slides/${index}`;
       if (typeof slide.id === "string") {
-        if (slideIds.has(slide.id)) issues.push(semanticIssue(`/slides/${index}/id`, "slide ids must be unique within a presentation", { id: slide.id }));
-        slideIds.add(slide.id);
+        const seen = documentIds.get(slide.id);
+        if (seen === "slide") issues.push(semanticIssue(`${slidePath}/id`, "slide ids must be unique within a presentation", { id: slide.id }));
+        else if (seen === "payload") issues.push(semanticIssue(`${slidePath}/id`, "slide id duplicates a content payload id; ids must be unique among slide and payload ids within a presentation", { id: slide.id }));
+        else documentIds.set(slide.id, "slide");
       }
-      issues.push(...validateSlideRegions(slide, `/slides/${index}`));
-      const visitTables = (node, path) => {
-        if (isRecord(node.table)) for (const issue of tableGrid(node.table).issues) issues.push(semanticIssue(pathFor(path, "table") + issue.path.slice(5).replaceAll(".", "/"), issue.message));
-        if (Array.isArray(node.blocks)) node.blocks.forEach((block, i) => {
-          if (isRecord(block)) visitTables(block, `${path}/blocks/${i}`);
-        });
-        for (const key of promotedRegionKeys) if (isRecord(node[key])) visitTables(node[key], pathFor(path, key));
+      visitContentPayloads(slide, slidePath, (payload, path) => {
+        if (typeof payload.id === "string") {
+          if (documentIds.has(payload.id)) issues.push(semanticIssue(`${path}/id`, "content payload ids must be unique among slide and payload ids within a presentation", { id: payload.id }));
+          else documentIds.set(payload.id, "payload");
+        }
+      });
+      issues.push(...validateSlideRegions(slide, slidePath));
+      const payloadTableIssues = (payload, path) => {
+        if (isRecord(payload.table)) for (const issue of tableGrid(payload.table).issues) issues.push(semanticIssue(pathFor(path, "table") + issue.path.slice(5).replaceAll(".", "/"), issue.message));
       };
-      visitTables(slide, `/slides/${index}`);
+      payloadTableIssues(slide, slidePath);
+      visitContentPayloads(slide, slidePath, payloadTableIssues);
     }
   });
   return issues;
 }
-var bareIdPattern = /^[a-z0-9][a-z0-9-]*$/;
 function inlineCatalogEntry(context, kind) {
   const catalogsField = context.document.catalogs;
   if (!isRecord(catalogsField)) {
@@ -878,13 +980,14 @@ function unknownIdWarning(kind, value, path, context) {
       if (Array.isArray(entry.records) && entry.records.some((record) => isRecord(record) && record.id === value)) {
         return void 0;
       }
-      if (typeof entry.source === "string") {
+      if (typeof entry.source === "string" || Array.isArray(entry.source) && entry.source.length > 0) {
         return void 0;
       }
     }
   }
   if (catalogIds[kind].includes(value)) {
-    return void 0;
+    const replacedBy = deprecatedCatalogIds[`${kind}/${value}`];
+    return replacedBy === void 0 ? void 0 : semanticIssue(path, `deprecated ${kind} catalog id '${value}'; use '${replacedBy}'`, { kind, id: value, replacedBy });
   }
   return semanticIssue(path, `unknown ${kind} catalog id '${value}'`, { kind, id: value });
 }
@@ -932,6 +1035,126 @@ function chartTypeWarnings(payload, path, context) {
   }
   return issues;
 }
+var cellBorderEdges = ["top", "right", "bottom", "left"];
+var variableIdPattern = /^[a-z][a-z0-9-]*$/;
+var hexColorPattern = /^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/;
+var schemeColorNames = /* @__PURE__ */ new Set([
+  "accent1",
+  "accent2",
+  "accent3",
+  "accent4",
+  "accent5",
+  "accent6",
+  "dark1",
+  "dark2",
+  "light1",
+  "light2",
+  "hyperlink",
+  "followedHyperlink",
+  "primary",
+  "secondary",
+  "accent",
+  "background",
+  "surface",
+  "text",
+  "textSecondary"
+]);
+function variableReferenceWarnings(value) {
+  if (!Array.isArray(value.slides)) {
+    return [];
+  }
+  const variables = isRecord(value.variables) ? value.variables : {};
+  const issues = [];
+  const colorRef = (entry, path) => {
+    if (typeof entry !== "string" || !entry.startsWith("var:")) return;
+    const id = entry.slice("var:".length);
+    if (!variableIdPattern.test(id) || hasOwn(variables, id)) return;
+    issues.push(semanticIssue(path, `unknown variable '${id}'; declare it in the top-level variables map`, { id }));
+  };
+  const runColor = (entry, path) => {
+    if (typeof entry !== "string") return;
+    if (hexColorPattern.test(entry) || schemeColorNames.has(entry)) return;
+    if (entry.startsWith("var:") && variableIdPattern.test(entry.slice("var:".length))) {
+      colorRef(entry, path);
+      return;
+    }
+    issues.push(semanticIssue(
+      path,
+      `run color '${entry}' is not a hex color, a color-scheme name, or a 'var:' reference; renderers fall back to the theme color`,
+      { color: entry }
+    ));
+  };
+  const richText = (entry, path) => {
+    if (!Array.isArray(entry)) return;
+    entry.forEach((run, index) => {
+      if (isRecord(run)) runColor(run.color, `${path}/${index}/color`);
+    });
+  };
+  const cellStyle = (style, path) => {
+    if (!isRecord(style)) return;
+    colorRef(style.fill, pathFor(path, "fill"));
+    colorRef(style.color, pathFor(path, "color"));
+    if (!isRecord(style.borders)) return;
+    const bordersPath = pathFor(path, "borders");
+    for (const edge of cellBorderEdges) {
+      const border = style.borders[edge];
+      if (isRecord(border)) colorRef(border.color, `${pathFor(bordersPath, edge)}/color`);
+    }
+  };
+  const tableCell = (cell, path) => {
+    if (Array.isArray(cell)) {
+      richText(cell, path);
+      return;
+    }
+    if (!isRecord(cell)) return;
+    richText(cell.value, pathFor(path, "value"));
+    cellStyle(cell.style, pathFor(path, "style"));
+  };
+  const table = (node, path) => {
+    if (!isRecord(node)) return;
+    if (Array.isArray(node.columns)) {
+      const columnsPath = pathFor(path, "columns");
+      node.columns.forEach((column, index) => {
+        tableCell(column, `${columnsPath}/${index}`);
+      });
+    }
+    if (Array.isArray(node.rows)) {
+      const rowsPath = pathFor(path, "rows");
+      node.rows.forEach((row, rowIndex) => {
+        if (!Array.isArray(row)) return;
+        row.forEach((cell, cellIndex) => {
+          tableCell(cell, `${rowsPath}/${rowIndex}/${cellIndex}`);
+        });
+      });
+    }
+  };
+  const textEntries = (entries, path) => {
+    if (!Array.isArray(entries)) return;
+    entries.forEach((entry, index) => {
+      const entryPath = `${path}/${index}`;
+      if (Array.isArray(entry)) {
+        richText(entry, entryPath);
+        return;
+      }
+      if (!isRecord(entry)) return;
+      richText(entry.text, pathFor(entryPath, "text"));
+      richText(entry.description, pathFor(entryPath, "description"));
+    });
+  };
+  const payload = (node, path) => {
+    richText(node.text, pathFor(path, "text"));
+    textEntries(node.items, pathFor(path, "items"));
+    textEntries(node.bullets, pathFor(path, "bullets"));
+    table(node.table, pathFor(path, "table"));
+  };
+  value.slides.forEach((slide, index) => {
+    if (!isRecord(slide)) return;
+    const slidePath = `/slides/${index}`;
+    payload(slide, slidePath);
+    visitContentPayloads(slide, slidePath, payload);
+  });
+  return issues;
+}
 function presentationReferenceWarnings(value) {
   if (!isRecord(value) || !Array.isArray(value.slides)) {
     return [];
@@ -941,7 +1164,15 @@ function presentationReferenceWarnings(value) {
   if (typeof value.narrative === "string") {
     pushIfDefined(issues, unknownIdWarning("narratives", value.narrative, "/narrative", context));
   }
+  if (Array.isArray(value.audience)) {
+    value.audience.forEach((entry, index) => {
+      pushIfDefined(issues, referenceObjectWarning("audiences", entry, `/audience/${index}`, context));
+    });
+  } else {
+    pushIfDefined(issues, unknownIdWarning("audiences", value.audience, "/audience", context));
+  }
   issues.push(...designReferenceWarnings(value.design, "/design", context));
+  issues.push(...variableReferenceWarnings(value));
   value.slides.forEach((slide, index) => {
     if (!isRecord(slide)) {
       return;
@@ -1057,4 +1288,4 @@ function assertValidCatalogRecord(kind, value) {
   assertValid(value, kind);
 }
 
-export { OPFValidationError, assertValid, assertValidCatalogRecord, assertValidPresentation, validate, validateCatalogRecord, validatePresentation, validationDefinition };
+export { OPFValidationError, assertValid, assertValidCatalogRecord, assertValidPresentation, bareIdPattern, isRecord, promotedRegionKeys, validate, validateCatalogRecord, validatePresentation, validationDefinition, visitContentPayloads };