@openpresentation/opf-editor 0.11.2 → 0.12.1

package/dist/switches.js

@@ -2,6 +2,7 @@
 // dimension that turns "switch this dimension to X" into a validated JSON Patch, and applies
 // it to an editor session as one undoable transaction. The preview recomposes and the PPTX
 // export follows from the same document, so no dimension needs a special refresh path.
+import * as core from "@openpresentation/opf";
 import { catalogSchemaNames, catalogs as bundledCatalogs, schemas } from "@openpresentation/opf";
 import {
   OPFEditorError,
@@ -251,7 +252,7 @@ export function prepareDimensionSwitch(document, dimension, value, options = {})
       throw fail("path-slide-mismatch", "options.path is not on the slide named by options.slideIndex.", { slideIndex, path: options.path });
     const chart = owner && getValueAtPath(document, [...owner, "chart"]);
     if (!chart || typeof chart !== "object") throw fail("chart-not-found", "This slide has no chart to switch. Insert a chart block first.", { slideIndex, path: options.path });
-    patches = [...catalogRecordPatches(document, dimension, options), ...(chart.type === value ? [] : createValuePatch(document, [...owner, "chart", "type"], value))];
+    patches = [...catalogRecordPatches(document, dimension, options), ...(chart.type === value ? [] : [...createValuePatch(document, [...owner, "chart", "type"], value), ...staleMappingPatches(document, owner, chart, value)])];
   } else if (dimension === "blocks") {
     if (options.path === undefined) throw fail("missing-path", "Choose the block to replace with options.path.");
     // convert: true moves the block's own text into the new kind (block-convert.js) instead of replacing it.
@@ -394,11 +395,27 @@ const SINGLE_SERIES_ONLY = new Set(["pieChart", "doughnutChart", "funnelChart",
 const MULTI_SERIES_CAPABLE = new Set(["barChart", "lineChart", "areaChart", "radarChart"]);
 const DISTRIBUTION_ELEMENTS = new Set(["histogramChart", "boxWhiskerChart", "mapChart"]);
 
-function chartDataShape(chart) {
-  const data = chart?.data;
-  if (!data || !Array.isArray(data.columns) || !Array.isArray(data.rows)) return undefined;
-  // The renderers read the first column as the category label and every further column as a series.
-  return { series: Math.max(0, data.columns.length - 1), categories: data.rows.length };
+// RR-54: `mapping.x` names the X column of an XY chart; a type without an X axis ignores it (core warns chart-mapping-adapted). Switching to such a
+// type removes it, and the whole mapping when nothing else is left, so the document does not keep a warning it cannot act on.
+function staleMappingPatches(document, owner, chart, type) {
+  const mapping = chart.mapping;
+  if (!mapping || typeof mapping !== "object" || Array.isArray(mapping) || mapping.x === undefined) return [];
+  if (typeof core.isXYChartType !== "function" || core.isXYChartType(type)) return [];
+  const { x: _x, ...rest } = mapping;
+  const parts = [...owner, "chart", "mapping"];
+  return Object.keys(rest).length ? createValuePatch(document, parts, rest) : [{ op: "remove", path: opfPathToJsonPointer(parts) }];
+}
+
+function chartDataShape(chart, document) {
+  // RR-54: inline data, a dataset reference and a series mapping all resolve to the columns the renderers read: the first column labels
+  // the categories and every further column is a series.
+  if (typeof core.resolveChartData !== "function") {
+    const data = chart?.data;
+    return data && Array.isArray(data.columns) && Array.isArray(data.rows) ? { series: Math.max(0, data.columns.length - 1), categories: data.rows.length } : undefined;
+  }
+  const resolved = core.resolveChartData(chart, document);
+  if (!resolved.ok) return undefined;
+  return { series: Math.max(0, resolved.columns.length - 1), categories: resolved.rows.length };
 }
 
 /**
@@ -415,7 +432,7 @@ export function compatibleChartTypes(document, options = {}) {
   const owner = options.path ? splitOpfPath(options.path) : document.slides?.[slideIndex] ? findChartOwner(document, slideIndex) : undefined;
   const chart = owner && getValueAtPath(document, [...owner, "chart"]);
   if (!chart || typeof chart !== "object") return [];
-  const shape = chartDataShape(chart);
+  const shape = chartDataShape(chart, document);
   const result = [];
   for (const option of listSwitchOptions(document, "charts", options)) {
     const record = option.record;

package/dist/table-options.js

@@ -32,7 +32,11 @@ const RULE_COLOR = "textSecondary";
 
 const isObject = (value) => Boolean(value) && typeof value === "object" && !Array.isArray(value);
 const isStyled = (cell) => isObject(cell) && Object.hasOwn(cell, "value");
-const valueOf = (cell) => (isStyled(cell) ? cell.value : cell);
+// RR-54: a header may be a DataColumn `{ name, format? }`. Styling or merging it makes it the equivalent styled header `{ value: name, format?, ... }`
+// (a styled header's `format` is the column's format, the same as a DataColumn's).
+const isColumnObject = (cell) => isObject(cell) && Object.hasOwn(cell, "name") && !Object.hasOwn(cell, "value");
+const asStyled = (cell) => (isColumnObject(cell) ? { value: cell.name, ...(typeof cell.format === "string" ? { format: cell.format } : {}) } : cell);
+const valueOf = (cell) => (isStyled(cell) ? cell.value : isColumnObject(cell) ? cell.name : cell);
 const isEmptyValue = (value) => value === null || value === undefined || value === "" || (Array.isArray(value) && value.every((run) => (typeof run === "string" ? run === "" : run?.text === "")));
 const clone = (value) => structuredClone(value);
 
@@ -58,6 +62,8 @@ export function parseTableCellPath(path) {
 function tableAt(document, tablePath) {
   const parts = splitOpfPath(tablePath);
   const table = getValueAtPath(document, parts);
+  if (isObject(table) && !Array.isArray(table.rows) && typeof table.dataset === "string")
+    throw fail("table-dataset-backed", `This table shows the shared dataset '${table.dataset}', which holds no cell styles or merged cells. Use a copy of the data (in the data grid) to style it.`, { tablePath, dataset: table.dataset });
   if (!isObject(table) || !Array.isArray(table.rows)) throw fail("table-not-found", "Choose a table (a path ending in .table).", { tablePath });
   return { parts, table };
 }
@@ -143,14 +149,17 @@ function joinedValue(values) {
   return parts.map(plainText).join(" ");
 }
 
-function withCell(raw, patch) {
+function withCell(cell, patch) {
   // A styled cell with no style and no spans collapses back to the plain value.
+  const raw = asStyled(cell);
   const merged = isStyled(raw) ? { ...raw } : { value: raw };
   for (const [key, value] of Object.entries(patch)) {
     if (value === undefined || value === null || (key === "style" && isObject(value) && !Object.keys(value).length)) delete merged[key];
     else merged[key] = value;
   }
   const keys = Object.keys(merged);
+  // A DataColumn header that gained no style or span stays a DataColumn.
+  if (isColumnObject(cell) && keys.every((key) => key === "value" || key === "format")) return cell;
   return keys.length === 1 && keys[0] === "value" ? merged.value : merged;
 }
 
@@ -226,7 +235,8 @@ export function prepareTableMerge(document, tablePath, cell, span, options = {})
     for (const entry of covered) entry.line[entry.column] = null;
     const anchorLine = lineOf(table, target);
     const raw = anchorLine[target.column];
-    anchorLine[target.column] = withCell(isStyled(raw) ? { ...raw, value: anchorValue } : anchorValue, { colSpan: colSpan > 1 ? colSpan : undefined, rowSpan: rowSpan > 1 ? rowSpan : undefined });
+    const base = asStyled(raw);
+    anchorLine[target.column] = withCell(isStyled(base) ? { ...base, value: anchorValue } : anchorValue, { colSpan: colSpan > 1 ? colSpan : undefined, rowSpan: rowSpan > 1 ? rowSpan : undefined });
     return { merged: true, joined: filled.length > 0 };
   }, { action: "merge", cell, span: { colSpan, rowSpan } });
 }

package/dist/transfer.js

@@ -187,6 +187,30 @@ export function prepareOpfImport(
     assetIds.add(next);
     assetMap.set(id, next);
   }
+  // RR-54: a chart or table that shows a shared dataset (`{ dataset: id }`) brings that dataset along. A dataset the deck already holds
+  // with the same content is shared; one with the same id and other content is stored under a free id and the references follow it.
+  const datasetMap = new Map();
+  const usedDatasets = new Set();
+  const collectDatasets = (value, key = "") => {
+    if (Array.isArray(value)) value.forEach((child) => collectDatasets(child, key));
+    else if (value && typeof value === "object") for (const [childKey, child] of Object.entries(value)) collectDatasets(child, childKey);
+    else if (key === "dataset" && typeof value === "string") usedDatasets.add(value);
+  };
+  collectDatasets(incoming.slides);
+  const datasetIds = new Set(Object.keys(document.datasets ?? {}));
+  for (const id of usedDatasets) {
+    const mine = incoming.datasets && Object.hasOwn(incoming.datasets, id) ? incoming.datasets[id] : undefined;
+    if (mine === undefined) continue;
+    if (datasetIds.has(id) && JSON.stringify(document.datasets[id]) === JSON.stringify(mine)) {
+      datasetMap.set(id, id);
+      continue;
+    }
+    let next = id,
+      n = 2;
+    while (datasetIds.has(next)) next = `${id}-${n++}`;
+    datasetIds.add(next);
+    datasetMap.set(id, next);
+  }
   const rewrite = (value, key = "") => {
     if (Array.isArray(value)) return value.map((child) => rewrite(child, key));
     if (value && typeof value === "object") {
@@ -210,6 +234,7 @@ export function prepareOpfImport(
       return result;
     }
     if (typeof value === "string") {
+      if (key === "dataset" && datasetMap.has(value)) return datasetMap.get(value);
       if (mappings[key]?.has(value)) return mappings[key].get(value);
       if (
         ["src", "image", "video", "poster"].includes(key) &&
@@ -243,6 +268,11 @@ export function prepareOpfImport(
           ? `asset:${assetMap.get(asset.slice(6))}`
           : asset;
   }
+  for (const [id, next] of datasetMap) {
+    if (document.datasets && Object.hasOwn(document.datasets, next)) continue;
+    document.datasets ??= {};
+    document.datasets[next] = clone(incoming.datasets[id]);
+  }
   const ids = new Set(collectReservedPresentationIds(document));
   for (const slide of rewritten.slides) remapSlideTreeIds(slide, ids);
   const index = Math.max(0, Math.min(document.slides.length, slideIndex + 1));

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@openpresentation/opf-editor",
-  "version": "0.11.2",
+  "version": "0.12.1",
   "description": "Embeddable local OPF editor primitives built on the deterministic renderer.",
   "license": "MIT",
   "type": "module",
   "private": false,
   "engines": {
-    "node": "24.x"
+    "node": ">=22"
   },
   "repository": {
     "type": "git",
@@ -207,8 +207,11 @@
   "sideEffects": false,
   "scripts": {
     "build": "node scripts/build.mjs",
-    "typecheck": "node --check src/index.js && node --check src/annotations.js && node --check test/annotations.mjs && node --check src/react.js && node --check src/svelte.js && node --check scripts/build.mjs && node --check scripts/validate-package.mjs && node --check test/smoke.mjs && node --check test/component-smoke.mjs && node --check src/canvas.js && node --check src/canvas-fields.js && node --check test/canvas-fields.mjs && node --check test/browser-canvas.mjs && node --check src/transfer.js && node --check src/presentation-ids.js && node --check src/font-defaults.js && node --check src/color-authoring.js && node --check test/presentation-ids.mjs && node --check src/galleries.js && node --check examples/transfer-controls.js && node --check src/schema.js && node --check src/schema-inspector.js && node --check test/rich-table-browser.mjs && node --check test/styled-table.mjs && node --check test/styled-table-browser.mjs && node --check examples/pptx-controls.js && node --check scripts/build-playground.mjs && node --check test/playground-pptx.mjs && node --check test/playground-script-fonts.mjs && node --check test/playground-lazy-fonts.mjs && node --check test/playground-base-fonts.mjs && node --check src/text-input.js && node --check src/rich-text.js && node --check src/rich-text-input.js && node --check src/rich-text-toolbar.js && node --check test/rich-text.mjs && node --check test/rich-input-browser.mjs && node --check src/json-editor.js && node --check src/json-menu.js && node --check src/json-options.js && node --check src/json-source.js && node --check src/switches.js && node --check test/switches.mjs && node --check test/switches-export.mjs && node --check test/placeholder-selection.mjs && node --check test/selection-browser.mjs && node --check scripts/check-font-hotlinks.mjs && node --check scripts/check-font-hotlinks.test.mjs && node --check src/exact-source.js && node --check test/exact-source.mjs && node --check test/playground-source.mjs && node --check src/font-gate.js && node --check test/font-gate.mjs && node --check test/font-gate-registry.mjs && node --check test/playground-ensure-fonts.mjs && node --check test/canvas-fonts-browser.mjs && node --check src/text-pointer.js && node --check test/click-entry-browser.mjs && node --check src/edit-helpers.js && node --check src/block-convert.js && node --check src/design-options.js && node --check src/table-options.js && node --check src/design-controls.js && node --check test/block-convert.mjs && node --check test/design-options.mjs && node --check test/table-options.mjs && node --check test/switches-ui.mjs && node --check test/design-controls-browser.mjs && node --check src/assets.js && node --check src/chart-options.js && node --check src/chart-options-panel.js && node --check examples/chart-controls.js && node --check test/chart-options.mjs && node --check test/chart-options-browser.mjs && node --check src/background-options.js && node --check test/assets.mjs && node --check test/background-options.mjs && node --check test/design-gaps-browser.mjs && node --check src/templates.js && node --check src/template-panel.js && node --check examples/template-controls.js && node --check test/templates.mjs && node --check test/template-panel-browser.mjs && node --check src/grid-text.js && node --check src/grid-model.js && node --check src/table-structure.js && node --check src/chart-data.js && node --check src/data-grid.js && node --check test/data-grid.mjs && node --check test/data-grid-browser.mjs && node --check src/slides.js && node --check src/outline.js && node --check src/slide-manager.js && node --check src/outline-view.js && node --check test/slides.mjs && node --check test/outline.mjs && node --check test/slides-browser.mjs && node --check src/persistence.js && node --check src/persistence-ui.js && node --check test/persistence.mjs && node --check test/persistence-browser.mjs && node --check src/find-replace.js && node --check src/find-panel.js && node --check src/image-crop.js && node --check src/image-cropper.js && node --check examples/find-controls.js && node --check examples/crop-controls.js && node --check examples/mobile-controls.js && node --check test/find-replace.mjs && node --check test/image-crop.mjs && node --check test/support/playground-harness.mjs && node --check test/find-replace-browser.mjs && node --check test/image-crop-browser.mjs && node --check test/mobile-browser.mjs && node --check src/content-actions.js && node --check src/content-controls.js && node --check test/content-actions.mjs && node --check test/font-gate-latin-families.mjs && node --check src/review.js && node --check src/review-panel.js && node --check examples/review-controls.js && node --check test/review.mjs && node --check test/review-panel-browser.mjs && node --check test/patch.mjs && node --check src/export.js && node --check src/zip.js && node --check examples/download-controls.js && node --check test/export.mjs && node --check test/playground-download.mjs && node --check src/numbering.js && node --check src/numbering-panel.js && node --check examples/numbering-controls.js && node --check test/numbering.mjs && node --check test/numbering-panel-browser.mjs",
-    "test": "npm run build && npm run check:font-hotlinks && node test/accepted-text.mjs && node test/smoke.mjs && node test/component-smoke.mjs && node test/canvas-fields.mjs && node test/transfer.mjs && node test/gallery-font-roles.mjs && node test/default-font-scheme.mjs && node test/presentation-ids.mjs && node test/schema.mjs && node test/rich-text.mjs && node test/layout.mjs && node test/blocks.mjs && node test/styled-table.mjs && node test/json-source.mjs && node test/json-options.mjs && node test/switches.mjs && node test/block-convert.mjs && node test/design-options.mjs && node test/templates.mjs && node test/table-options.mjs && node test/annotations.mjs && node test/switches-ui.mjs && node test/assets.mjs && node test/chart-options.mjs && node test/background-options.mjs && node test/slides.mjs && node test/outline.mjs && node test/persistence.mjs && node test/switches-export.mjs && node test/placeholder-selection.mjs && node test/exact-source.mjs && node test/font-gate.mjs && node test/data-grid.mjs && node test/font-gate-registry.mjs && node test/find-replace.mjs && node test/image-crop.mjs && node test/content-actions.mjs && node test/font-gate-latin-families.mjs && node test/review.mjs && node test/patch.mjs && node test/export.mjs && node test/numbering.mjs",
+    "typecheck": "node scripts/check-syntax.mjs src test scripts examples",
+    "test": "npm run build && npm run check:font-hotlinks && node scripts/run-tests.mjs && npm run check:runners && npm run check:changes",
+    "test:contract": "npm run build && node scripts/run-tests.mjs --suite contract",
+    "check:runners": "node --test scripts/run-tests.test.mjs",
+    "check:changes": "node --test scripts/changelog-fragments.test.mjs && node scripts/changelog-fragments.mjs check",
     "validate": "node scripts/validate-package.mjs",
     "test:packed": "node test/packed-install.mjs",
     "prepack": "npm run build",
@@ -227,6 +230,8 @@
     "test:template-panel-browser": "node test/template-panel-browser.mjs",
     "test:design-gaps-browser": "node test/design-gaps-browser.mjs",
     "test:data-grid-browser": "node test/data-grid-browser.mjs",
+    "test:data-grid-datasets-browser": "node test/data-grid-datasets-browser.mjs",
+    "test:data-import-dataset-browser": "node test/data-import-dataset-browser.mjs",
     "test:slides-browser": "node test/slides-browser.mjs",
     "test:persistence-browser": "node test/persistence-browser.mjs",
     "test:find-browser": "node test/find-replace-browser.mjs",
@@ -246,11 +251,11 @@
     "@codemirror/state": "6.7.6",
     "@codemirror/view": "6.43.13",
     "@lezer/highlight": "1.2.4",
-    "@openpresentation/opf": "^0.12.0",
+    "@openpresentation/opf": "^0.13.0",
     "jsonc-parser": "3.3.1"
   },
   "peerDependencies": {
-    "@openpresentation/opf-render": "^0.12.0"
+    "@openpresentation/opf-render": "^0.13.1"
   },
   "peerDependenciesMeta": {
     "@openpresentation/opf-render": {
@@ -292,10 +297,11 @@
     "@expo-google-fonts/noto-sans-thai": "0.4.2",
     "@expo-google-fonts/noto-serif-hebrew": "0.4.2",
     "@expo-google-fonts/noto-serif-tibetan": "0.4.2",
-    "@openpresentation/opf-pptx": "^0.12.0",
-    "@openpresentation/opf-render": "^0.12.0",
+    "@openpresentation/opf-pptx": "^0.13.2",
+    "@openpresentation/opf-render": "^0.13.1",
     "axe-core": "4.13.0",
     "esbuild": "0.28.2",
+    "jszip": "3.10.2",
     "pdfjs-dist": "6.3.289",
     "playwright": "1.63.0",
     "@expo-google-fonts/noto-color-emoji": "0.4.6",