@pixerate/editor 0.164.0 → 0.166.0

package/dist/{chunk-M4MIZPQI.cjs → chunk-SJ2CPTQC.cjs}

@@ -3,6 +3,42 @@
 
 var _chunk2BSBFBOAcjs = require('./chunk-2BSBFBOA.cjs');
 
+// src/persistence/assetWrites.ts
+var leases = /* @__PURE__ */ new Map();
+var watchers = /* @__PURE__ */ new Set();
+function leaseAssetRefs(refs) {
+  const held = [...new Set(refs)];
+  for (const ref of held) {
+    leases.set(ref, (_nullishCoalesce(leases.get(ref), () => ( 0))) + 1);
+    for (const touched of watchers) touched.add(ref);
+  }
+  let released = false;
+  return () => {
+    if (released) return;
+    released = true;
+    for (const ref of held) {
+      const n = (_nullishCoalesce(leases.get(ref), () => ( 1))) - 1;
+      if (n > 0) leases.set(ref, n);
+      else leases.delete(ref);
+    }
+  };
+}
+function watchAssetLeases() {
+  const touched = new Set(leases.keys());
+  watchers.add(touched);
+  return { touched, stop: () => void watchers.delete(touched) };
+}
+function withAssetLock(prefix, mode, task) {
+  let locks;
+  try {
+    locks = _optionalChain([globalThis, 'access', _ => _.navigator, 'optionalAccess', _2 => _2.locks]);
+  } catch (e) {
+    locks = void 0;
+  }
+  if (!locks || typeof locks.request !== "function") return task();
+  return locks.request(`pixerate-editor-assets:${prefix}`, { mode }, task);
+}
+
 // src/persistence/assets.ts
 var EDITOR_ASSET_PREFIX = "pixerate-asset:";
 var REF = /pixerate-asset:[0-9a-z]+-[0-9a-z]+(?:~[0-9]+)?/g;
@@ -45,7 +81,8 @@ function createEditorAssetRegistry() {
     },
     get size() {
       return byRef.size;
-    }
+    },
+    refs: () => [...byRef.keys()]
   };
 }
 function externalizeAssets(value, registry) {
@@ -85,11 +122,22 @@ function internalizeAssets(value, registry) {
   return walk(value);
 }
 var persisted = /* @__PURE__ */ new WeakMap();
-var assetKey = (ref, options) => `${_nullishCoalesce(options.prefix, () => ( "pixerate.assets:"))}${ref.slice(EDITOR_ASSET_PREFIX.length)}`;
+var assetPrefix = (options) => _nullishCoalesce(options.prefix, () => ( "pixerate.assets:"));
+var assetKey = (ref, options) => `${assetPrefix(options)}${ref.slice(EDITOR_ASSET_PREFIX.length)}`;
+var markerKey = (options) => `${assetPrefix(options)}#collected`;
+var ASSET_ID = /^[0-9a-z]+-[0-9a-z]+(?:~[0-9]+)?$/;
 async function persistEditorAssets(storage, registry, document, options = {}) {
-  const written = _nullishCoalesce(persisted.get(storage), () => ( /* @__PURE__ */ new Set()));
-  persisted.set(storage, written);
-  for (const ref of collectAssetRefs(document)) {
+  const refs = collectAssetRefs(document);
+  if (!refs.length) return;
+  const cache = _nullishCoalesce(persisted.get(storage), () => ( { marker: void 0, keys: /* @__PURE__ */ new Set() }));
+  persisted.set(storage, cache);
+  const marker = await storage.get(markerKey(options)).catch(() => void 0);
+  if (marker === void 0 || marker !== cache.marker) {
+    cache.keys.clear();
+    cache.marker = marker;
+  }
+  const written = cache.keys;
+  for (const ref of refs) {
     const key = assetKey(ref, options);
     if (written.has(key)) continue;
     const data = registry.get(ref);
@@ -120,11 +168,134 @@ function withEditorAssets(storage, registry, options = {}) {
       return value;
     },
     async set(key, value) {
-      if (value.includes(EDITOR_ASSET_PREFIX)) await persistEditorAssets(storage, registry, value, options);
-      await storage.set(key, value);
+      if (!value.includes(EDITOR_ASSET_PREFIX)) return storage.set(key, value);
+      await writeWithAssets(storage, registry, value, options, () => storage.set(key, value));
     },
-    remove: (key) => storage.remove(key)
+    remove: (key) => storage.remove(key),
+    ...storage.keys ? { keys: (prefix) => storage.keys(prefix) } : {}
+  };
+}
+async function writeWithAssets(storage, registry, document, options, write) {
+  const release = leaseAssetRefs(collectAssetRefs(document));
+  try {
+    await withAssetLock(assetPrefix(options), "shared", async () => {
+      if (registry) await persistEditorAssets(storage, registry, document, options);
+      await write();
+    });
+  } finally {
+    release();
+  }
+}
+var isRegistry = (value) => !!value && typeof value === "object" && ["put", "get", "has", "set"].every((k) => typeof value[k] === "function");
+var refChars = (ref) => parseInt(ref.slice(EDITOR_ASSET_PREFIX.length).split("-")[0], 36) || 0;
+function keptRefs(keep) {
+  const out = /* @__PURE__ */ new Set();
+  const addRegistry = (registry) => {
+    if (typeof registry.refs !== "function") {
+      throw new Error("A registry passed in keep cannot list its references (it has no refs()). Use createEditorAssetRegistry, or pass the documents to keep instead.");
+    }
+    for (const ref of registry.refs()) out.add(ref);
   };
+  for (const item of keep) {
+    if (isRegistry(item)) addRegistry(item);
+    else if (item && typeof item === "object" && isRegistry(item.assets)) addRegistry(item.assets);
+    else for (const ref of collectAssetRefs(item)) out.add(ref);
+  }
+  return out;
+}
+async function collectEditorAssetGarbage(storage, options = {}) {
+  if (typeof storage.keys !== "function") {
+    throw new Error(
+      `This ${storage.kind} storage cannot list its keys, so unreferenced assets cannot be found. Give the adapter a keys(prefix) method (every built-in adapter has one).`
+    );
+  }
+  const listKeys = storage.keys.bind(storage);
+  const prefix = assetPrefix(options);
+  const keep = keptRefs(_nullishCoalesce(options.keep, () => ( [])));
+  const dryRun = options.dryRun === true;
+  return withAssetLock(prefix, "exclusive", async () => {
+    const watch = watchAssetLeases();
+    try {
+      const assetKeys = (await listKeys(prefix)).filter((key) => ASSET_ID.test(key.slice(prefix.length)));
+      const others = (await listKeys("")).filter((key) => !key.startsWith(prefix));
+      const live = /* @__PURE__ */ new Set();
+      for (const key of others) {
+        const value = await storage.get(key);
+        if (value !== null && value.includes(EDITOR_ASSET_PREFIX)) for (const ref of collectAssetRefs(value)) live.add(ref);
+      }
+      const toRef = (key) => `${EDITOR_ASSET_PREFIX}${key.slice(prefix.length)}`;
+      let referenced = 0;
+      let kept = 0;
+      const candidates = [];
+      for (const key of assetKeys) {
+        const ref = toRef(key);
+        if (live.has(ref)) referenced++;
+        else if (keep.has(ref) || watch.touched.has(ref)) kept++;
+        else candidates.push(ref);
+      }
+      let unreferenced = candidates;
+      if (options.only) {
+        const wanted = new Set(options.only);
+        const stale = [...wanted].filter((ref) => !candidates.includes(ref));
+        if (stale.length) {
+          throw new Error(
+            `${stale.length} of the given asset${stale.length === 1 ? " is" : "s are"} not unreferenced in storage now (${stale.slice(0, 3).join(", ")}${stale.length > 3 ? ", \u2026" : ""}): unknown, already deleted, referenced or in use. Nothing was deleted; find the unreferenced assets again.`
+          );
+        }
+        unreferenced = candidates.filter((ref) => wanted.has(ref));
+      }
+      const report = {
+        assets: assetKeys.length,
+        scannedKeys: others.length,
+        referenced,
+        kept,
+        unreferenced,
+        unreferencedChars: unreferenced.reduce((n, ref) => n + refChars(ref), 0),
+        removed: [],
+        freedChars: 0,
+        dryRun
+      };
+      if (dryRun || !unreferenced.length) return report;
+      await storage.set(markerKey(options), `${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`);
+      for (const ref of unreferenced) {
+        if (watch.touched.has(ref)) {
+          report.kept++;
+          continue;
+        }
+        try {
+          await storage.remove(assetKey(ref, options));
+        } catch (error) {
+          throw new Error(
+            `Deleted ${report.removed.length} of ${unreferenced.length} unreferenced assets, then storage failed: ${error instanceof Error ? error.message : String(error)}. The rest are still stored and nothing refers to the deleted ones; run the collection again.`
+          );
+        }
+        report.removed.push(ref);
+        report.freedChars += refChars(ref);
+      }
+      return report;
+    } finally {
+      watch.stop();
+    }
+  });
+}
+async function tryCollectEditorAssetGarbage(storage, options = {}) {
+  if (typeof storage.keys !== "function") return null;
+  try {
+    return await collectEditorAssetGarbage(storage, options);
+  } catch (e2) {
+    return null;
+  }
+}
+async function collectRetiredEditorAssets(storage, doc, setting = true) {
+  if (!doc.assets || setting === false) return null;
+  const extra = setting === true ? {} : setting;
+  let current;
+  try {
+    current = doc.getDocument();
+  } catch (e3) {
+    return null;
+  }
+  return tryCollectEditorAssetGarbage(storage, { ...extra, keep: [current, ..._nullishCoalesce(extra.keep, () => ( []))] });
 }
 
 // src/persistence/migrate.ts
@@ -148,7 +319,7 @@ function toObject(json) {
   if (typeof json === "string") {
     try {
       value = JSON.parse(json);
-    } catch (e) {
+    } catch (e4) {
       return void 0;
     }
   }
@@ -185,7 +356,7 @@ function migrateDocument(json, options) {
   }
   let doc = deepClone(original);
   for (let step = from; step < target; step++) {
-    const fn = _optionalChain([options, 'access', _ => _.steps, 'optionalAccess', _2 => _2[step]]);
+    const fn = _optionalChain([options, 'access', _3 => _3.steps, 'optionalAccess', _4 => _4[step]]);
     if (!fn) {
       report.readOnly = {
         kind: "migrationFailed",
@@ -242,7 +413,7 @@ function loadSections(doc, sections, options = {}) {
 function loadDocument(json, sections, options) {
   const { doc, report } = migrateDocument(json, options);
   const ignore = _nullishCoalesce(options.ignore, () => ( [_nullishCoalesce(options.versionKey, () => ( "version"))]));
-  const result = loadSections(_optionalChain([report, 'access', _3 => _3.readOnly, 'optionalAccess', _4 => _4.kind]) === "invalid" ? {} : doc, sections, {
+  const result = loadSections(_optionalChain([report, 'access', _5 => _5.readOnly, 'optionalAccess', _6 => _6.kind]) === "invalid" ? {} : doc, sections, {
     ignore
   });
   report.problems = result.problems;
@@ -340,7 +511,7 @@ function defineEditorDocument(spec) {
       if (document === void 0 || document === null) throw new EditorDocumentLoadError(`No ${spec.kind} document was given.`);
       try {
         const result = spec.load(spec.assets ? internalizeAssets(document, spec.assets) : document, { history: _nullishCoalesce(options.history, () => ( "reset")) });
-        if (_optionalChain([result, 'optionalAccess', _5 => _5.problems, 'optionalAccess', _6 => _6.length])) report.problems.push(...result.problems);
+        if (_optionalChain([result, 'optionalAccess', _7 => _7.problems, 'optionalAccess', _8 => _8.length])) report.problems.push(...result.problems);
       } catch (error) {
         if (error instanceof EditorDocumentLoadError) throw error;
         throw new EditorDocumentLoadError(error instanceof Error ? error.message : String(error));
@@ -360,9 +531,9 @@ function defineEditorDocument(spec) {
     },
     history: spec.history,
     ...spec.assets ? { assets: spec.assets } : {},
-    readOnly: () => _nullishCoalesce(_optionalChain([spec, 'access', _7 => _7.readOnly, 'optionalCall', _8 => _8()]), () => ( false)),
+    readOnly: () => _nullishCoalesce(_optionalChain([spec, 'access', _9 => _9.readOnly, 'optionalCall', _10 => _10()]), () => ( false)),
     destroy() {
-      _optionalChain([unsubscribe, 'optionalCall', _9 => _9()]);
+      _optionalChain([unsubscribe, 'optionalCall', _11 => _11()]);
       unsubscribe = null;
     }
   };
@@ -390,4 +561,7 @@ function defineEditorDocument(spec) {
 
 
 
-exports.EDITOR_ASSET_PREFIX = EDITOR_ASSET_PREFIX; exports.isInlineAsset = isInlineAsset; exports.createEditorAssetRegistry = createEditorAssetRegistry; exports.externalizeAssets = externalizeAssets; exports.collectAssetRefs = collectAssetRefs; exports.internalizeAssets = internalizeAssets; exports.persistEditorAssets = persistEditorAssets; exports.preloadEditorAssets = preloadEditorAssets; exports.withEditorAssets = withEditorAssets; exports.hasLoadProblems = hasLoadProblems; exports.createLoadReport = createLoadReport; exports.migrateDocument = migrateDocument; exports.loadSections = loadSections; exports.loadDocument = loadDocument; exports.EditorDocumentLoadError = EditorDocumentLoadError; exports.EDITOR_DOCUMENT_FORMAT = EDITOR_DOCUMENT_FORMAT; exports.isEditorDocumentFile = isEditorDocumentFile; exports.toEditorDocumentFile = toEditorDocumentFile; exports.serializeEditorDocument = serializeEditorDocument; exports.parseEditorDocument = parseEditorDocument; exports.defineEditorDocument = defineEditorDocument;
+
+
+
+exports.EDITOR_ASSET_PREFIX = EDITOR_ASSET_PREFIX; exports.isInlineAsset = isInlineAsset; exports.createEditorAssetRegistry = createEditorAssetRegistry; exports.externalizeAssets = externalizeAssets; exports.collectAssetRefs = collectAssetRefs; exports.internalizeAssets = internalizeAssets; exports.persistEditorAssets = persistEditorAssets; exports.preloadEditorAssets = preloadEditorAssets; exports.withEditorAssets = withEditorAssets; exports.collectEditorAssetGarbage = collectEditorAssetGarbage; exports.tryCollectEditorAssetGarbage = tryCollectEditorAssetGarbage; exports.collectRetiredEditorAssets = collectRetiredEditorAssets; exports.hasLoadProblems = hasLoadProblems; exports.createLoadReport = createLoadReport; exports.migrateDocument = migrateDocument; exports.loadSections = loadSections; exports.loadDocument = loadDocument; exports.EditorDocumentLoadError = EditorDocumentLoadError; exports.EDITOR_DOCUMENT_FORMAT = EDITOR_DOCUMENT_FORMAT; exports.isEditorDocumentFile = isEditorDocumentFile; exports.toEditorDocumentFile = toEditorDocumentFile; exports.serializeEditorDocument = serializeEditorDocument; exports.parseEditorDocument = parseEditorDocument; exports.defineEditorDocument = defineEditorDocument;

package/dist/{chunk-YGG7WDWT.cjs → chunk-SZWVMB3B.cjs}

@@ -8,7 +8,7 @@
 
 
 
-var _chunkR3P2M7HUcjs = require('./chunk-R3P2M7HU.cjs');
+var _chunkBPX4Z3N3cjs = require('./chunk-BPX4Z3N3.cjs');
 
 // src/chart/ooxml.ts
 var CHART_OOXML_NS = "http://schemas.openxmlformats.org/drawingml/2006/chart";
@@ -111,11 +111,11 @@ function chartFromOoxml(xml, options = {}) {
   try {
     doc = new (parser(options))().parseFromString(xml, "application/xml");
   } catch (error) {
-    return { spec: _chunkR3P2M7HUcjs.normalizeChartSpec.call(void 0, {}).spec, issues: [{ path: "", message: `The chart XML could not be read: ${error.message}` }], unsupported, lossless: false };
+    return { spec: _chunkBPX4Z3N3cjs.normalizeChartSpec.call(void 0, {}).spec, issues: [{ path: "", message: `The chart XML could not be read: ${error.message}` }], unsupported, lossless: false };
   }
   const root = doc.documentElement;
   if (!root || root.localName !== "chartSpace" || doc.getElementsByTagName("parsererror").length) {
-    return { spec: _chunkR3P2M7HUcjs.normalizeChartSpec.call(void 0, {}).spec, issues: [{ path: "", message: "This is not a chart part: expected a c:chartSpace (or cx:chartSpace) root element." }], unsupported, lossless: false };
+    return { spec: _chunkBPX4Z3N3cjs.normalizeChartSpec.call(void 0, {}).spec, issues: [{ path: "", message: "This is not a chart part: expected a c:chartSpace (or cx:chartSpace) root element." }], unsupported, lossless: false };
   }
   if (_optionalChain([root, 'access', _14 => _14.namespaceURI, 'optionalAccess', _15 => _15.includes, 'call', _16 => _16("chartex")]) || kid(root, "chartData")) return readChartex(root, issues, unsupported);
   const chart = kid(root, "chart");
@@ -280,7 +280,7 @@ function chartFromOoxml(xml, options = {}) {
   }
   if (!types.length) {
     issues.push({ path: "plotArea", message: unsupported.length ? `The chart type is not supported: ${unsupported.join(", ")}.` : "The chart has no plot groups." });
-    return { spec: _chunkR3P2M7HUcjs.normalizeChartSpec.call(void 0, input).spec, issues, unsupported, lossless: false };
+    return { spec: _chunkBPX4Z3N3cjs.normalizeChartSpec.call(void 0, input).spec, issues, unsupported, lossless: false };
   }
   const first = types[0];
   const combo = types.some((t) => t !== first);
@@ -290,14 +290,14 @@ function chartFromOoxml(xml, options = {}) {
   if (!combo) {
     for (const s of series) if (s.axis) issues.push({ path: "series", message: `"${s.name}" is on a second value axis.` });
   }
-  if (types.some((t) => !_chunkR3P2M7HUcjs.isCartesianChart.call(void 0, t)) && combo) unsupported.push("a pie or radar mixed with other chart types");
+  if (types.some((t) => !_chunkBPX4Z3N3cjs.isCartesianChart.call(void 0, t)) && combo) unsupported.push("a pie or radar mixed with other chart types");
   input.series = series;
   input.categories = categories.length ? categories : Array.from({ length: Math.max(0, ...series.map((s) => s.values.length)) }, (_, i) => `${i + 1}`);
   input.stacking = stacking;
   input.orientation = orientation;
   input.dataLabels = dataLabels;
   input.points = points || first !== "line";
-  if (bool(val(groups[0], "varyColors")) && !combo && _chunkR3P2M7HUcjs.isCartesianChart.call(void 0, first) && series.length === 1) input.varyColors = true;
+  if (bool(val(groups[0], "varyColors")) && !combo && _chunkBPX4Z3N3cjs.isCartesianChart.call(void 0, first) && series.length === 1) input.varyColors = true;
   const readAxis = (a, fallback) => {
     const axis = { ...fallback, format: {} };
     if (!a) return axis;
@@ -324,12 +324,12 @@ function chartFromOoxml(xml, options = {}) {
   };
   const xy = first === "scatter" || first === "bubble";
   const catAxis = _nullishCoalesce(_nullishCoalesce(kid(plot, "catAx"), () => ( kid(plot, "dateAx"))), () => ( (xy ? valAxes.find((a) => !vertical(a)) : void 0)));
-  input.xAxis = readAxis(catAxis, _chunkR3P2M7HUcjs.defaultChartAxis.call(void 0, false));
+  input.xAxis = readAxis(catAxis, _chunkBPX4Z3N3cjs.defaultChartAxis.call(void 0, false));
   if (kid(plot, "dateAx")) input.xAxis.kind = "date";
-  input.yAxis = readAxis(_nullishCoalesce(_nullishCoalesce(primaryAxis, () => ( valAxes.find(vertical))), () => ( valAxes[0])), _chunkR3P2M7HUcjs.defaultChartAxis.call(void 0, true));
+  input.yAxis = readAxis(_nullishCoalesce(_nullishCoalesce(primaryAxis, () => ( valAxes.find(vertical))), () => ( valAxes[0])), _chunkBPX4Z3N3cjs.defaultChartAxis.call(void 0, true));
   const secondaryAxis = valAxes.find((a) => a !== primaryAxis && (xy ? vertical(a) && a !== primaryAxis : true) && a !== catAxis);
-  if (series.some((s) => s.axis === "secondary") && secondaryAxis) input.yAxis2 = readAxis(secondaryAxis, _chunkR3P2M7HUcjs.defaultChartAxis.call(void 0, false));
-  const { spec, issues: specIssues } = _chunkR3P2M7HUcjs.normalizeChartSpec.call(void 0, input);
+  if (series.some((s) => s.axis === "secondary") && secondaryAxis) input.yAxis2 = readAxis(secondaryAxis, _chunkBPX4Z3N3cjs.defaultChartAxis.call(void 0, false));
+  const { spec, issues: specIssues } = _chunkBPX4Z3N3cjs.normalizeChartSpec.call(void 0, input);
   issues.push(...specIssues);
   const uniq = [...new Set(unsupported)];
   return { spec, issues, unsupported: uniq, lossless: uniq.length === 0 && specIssues.length === 0 };
@@ -382,7 +382,7 @@ function readChartex(root, issues, unsupported) {
   const type = layouts[layout];
   if (!type) {
     issues.push({ path: "plotArea", message: `The chart layout "${layout || "unknown"}" is not supported.` });
-    return { spec: _chunkR3P2M7HUcjs.normalizeChartSpec.call(void 0, {}).spec, issues, unsupported: [layout || "unknown chartex layout"], lossless: false };
+    return { spec: _chunkBPX4Z3N3cjs.normalizeChartSpec.call(void 0, {}).spec, issues, unsupported: [layout || "unknown chartex layout"], lossless: false };
   }
   if (layout === "paretoLine") unsupported.push("pareto line");
   const series = [];
@@ -409,18 +409,18 @@ function readChartex(root, issues, unsupported) {
   const first = data.get(_nullishCoalesce(_optionalChain([kid, 'call', _35 => _35(seriesEls[0], "dataId"), 'optionalAccess', _36 => _36.getAttribute, 'call', _37 => _37("val")]), () => ( "0")));
   if ((type === "treemap" || type === "sunburst") && _optionalChain([first, 'optionalAccess', _38 => _38.paths])) {
     const treeIssues = [];
-    input.tree = _chunkR3P2M7HUcjs.chartTreeFromRows.call(void 0, first.paths.map((path2, i) => ({ path: path2, value: _nullishCoalesce(first.values[i], () => ( 0)) })), treeIssues);
+    input.tree = _chunkBPX4Z3N3cjs.chartTreeFromRows.call(void 0, first.paths.map((path2, i) => ({ path: path2, value: _nullishCoalesce(first.values[i], () => ( 0)) })), treeIssues);
     for (const t of treeIssues) issues.push({ path: "chartData", message: t.message });
   }
-  const { spec, issues: specIssues } = _chunkR3P2M7HUcjs.normalizeChartSpec.call(void 0, input);
+  const { spec, issues: specIssues } = _chunkBPX4Z3N3cjs.normalizeChartSpec.call(void 0, input);
   issues.push(...specIssues);
   return { spec, issues, unsupported, lossless: unsupported.length === 0 && specIssues.length === 0 };
 }
 var esc = (s) => s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
 var hex = (color) => {
   if (!color) return null;
-  const rgb = _chunkR3P2M7HUcjs.parseChartColor.call(void 0, color);
-  return rgb ? _chunkR3P2M7HUcjs.chartRgbToHex.call(void 0, rgb).slice(1).toUpperCase() : null;
+  const rgb = _chunkBPX4Z3N3cjs.parseChartColor.call(void 0, color);
+  return rgb ? _chunkBPX4Z3N3cjs.chartRgbToHex.call(void 0, rgb).slice(1).toUpperCase() : null;
 };
 var fillXml = (color, line = false) => {
   const h = hex(color);
@@ -464,7 +464,7 @@ function errBarsXml(bars, dir) {
 var MARKER_OUT = { circle: "circle", square: "square", diamond: "diamond", triangle: "triangle", cross: "x", none: "none" };
 function chartToOoxml(spec) {
   const issues = [];
-  const family = _chunkR3P2M7HUcjs.chartFamily.call(void 0, spec);
+  const family = _chunkBPX4Z3N3cjs.chartFamily.call(void 0, spec);
   let type = spec.type;
   if (family === "waterfall" || family === "histogram" || family === "box" || family === "funnel") {
     issues.push(`${spec.type} charts are written as bar charts: DrawingML has no ${spec.type} type (Office 2016 stores it as chartex).`);
@@ -475,6 +475,12 @@ function chartToOoxml(spec) {
   } else if (family === "sunburst") {
     issues.push(`Sunburst charts are written as doughnut charts of the ${spec.tree.length ? "top-level group totals" : "values"}: DrawingML has no sunburst type (Office 2016 stores it as chartex).`);
     type = "donut";
+  } else if (family === "barrace") {
+    issues.push("Bar chart races are written as clustered bar charts of every name at every time point: DrawingML has no animation.");
+    type = "bar";
+  } else if (family === "sankey") {
+    issues.push("Sankey diagrams are written as bar charts of how much passes through each node: DrawingML has no flows.");
+    type = "bar";
   } else if (family === "parliament") {
     issues.push("Parliament charts are written as doughnut charts of the seats: DrawingML has no parliament type.");
     type = "donut";
@@ -499,7 +505,7 @@ function chartToOoxml(spec) {
   const ids = { cat: 500000001, val: 500000002, cat2: 500000003, val2: 500000004 };
   const xy = family === "xy" || type === "scatter" || type === "bubble";
   const pieLike = type === "pie" || type === "donut";
-  const typed = (s) => pieLike || type === "radar" ? type : type === "bubble" ? "bubble" : xy ? "scatter" : _chunkR3P2M7HUcjs.chartSeriesType.call(void 0, { type }, s);
+  const typed = (s) => pieLike || type === "radar" ? type : type === "bubble" ? "bubble" : xy ? "scatter" : _chunkBPX4Z3N3cjs.chartSeriesType.call(void 0, { type }, s);
   const groups = [];
   visible.forEach((s) => {
     const kind = typed(s);
@@ -562,7 +568,7 @@ function chartToOoxml(spec) {
     return `<c:ser>${parts.join("")}</c:ser>`;
   };
   const dLbls = `<c:dLbls><c:showLegendKey val="0"/><c:showVal val="${spec.dataLabels ? 1 : 0}"/><c:showCatName val="0"/><c:showSerName val="0"/><c:showPercent val="0"/><c:showBubbleSize val="0"/></c:dLbls>`;
-  const vary = _chunkR3P2M7HUcjs.chartVariesColors.call(void 0, spec) ? 1 : 0;
+  const vary = _chunkBPX4Z3N3cjs.chartVariesColors.call(void 0, spec) ? 1 : 0;
   const groupXml = groups.map((g) => {
     const axes2 = g.secondary ? `<c:axId val="${ids.cat2}"/><c:axId val="${ids.val2}"/>` : `<c:axId val="${ids.cat}"/><c:axId val="${ids.val}"/>`;
     const sers = g.series.map(({ s, index }) => serXml(g.kind, s, index)).join("");

package/dist/chunk-TFF2GTGN.cjs

@@ -0,0 +1,153 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }
+
+
+
+
+
+
+
+
+
+
+
+var _chunk5UEFBM2Mcjs = require('./chunk-5UEFBM2M.cjs');
+
+// src/color/gamut.ts
+var clamp01 = (v) => Math.min(1, Math.max(0, v));
+function inSrgbGamut(c, epsilon = 1e-5) {
+  return c.r >= -epsilon && c.r <= 1 + epsilon && c.g >= -epsilon && c.g <= 1 + epsilon && c.b >= -epsilon && c.b <= 1 + epsilon;
+}
+function deltaEOK(a, b) {
+  const la = _chunk5UEFBM2Mcjs.rgbToOklab.call(void 0, a);
+  const lb = _chunk5UEFBM2Mcjs.rgbToOklab.call(void 0, b);
+  return Math.hypot(la.l - lb.l, la.a - lb.a, la.b - lb.b);
+}
+function toSrgbGamut(c) {
+  const lch = _chunk5UEFBM2Mcjs.oklabToOklch.call(void 0, _chunk5UEFBM2Mcjs.rgbToOklab.call(void 0, c));
+  if (lch.l >= 1) return { r: 1, g: 1, b: 1, a: c.a };
+  if (lch.l <= 0) return { r: 0, g: 0, b: 0, a: c.a };
+  if (inSrgbGamut(c)) {
+    return { r: clamp01(c.r), g: clamp01(c.g), b: clamp01(c.b), a: c.a };
+  }
+  let low = 0;
+  let high = lch.c;
+  let clippedCandidate = { r: clamp01(c.r), g: clamp01(c.g), b: clamp01(c.b), a: c.a };
+  const JND = 0.02;
+  const EPS = 1e-4;
+  for (let i = 0; i < 30; i++) {
+    const mid = (low + high) / 2;
+    const candidate = _chunk5UEFBM2Mcjs.oklabToRgb.call(void 0, _chunk5UEFBM2Mcjs.oklchToOklab.call(void 0, { l: lch.l, c: mid, h: lch.h, alpha: c.a }));
+    const clipped = {
+      r: clamp01(candidate.r),
+      g: clamp01(candidate.g),
+      b: clamp01(candidate.b),
+      a: c.a
+    };
+    clippedCandidate = clipped;
+    const dE = deltaEOK(candidate, clipped);
+    if (dE < JND) {
+      if (JND - dE < EPS) {
+        return clipped;
+      }
+      low = mid;
+    } else {
+      high = mid;
+    }
+    if (high - low < 1e-4) {
+      break;
+    }
+  }
+  return clippedCandidate;
+}
+
+// src/color/format.ts
+var clamp012 = (v) => Math.min(1, Math.max(0, v));
+var byte = (v) => Math.round(clamp012(v) * 255);
+var hex2 = (n) => n.toString(16).padStart(2, "0");
+var round2 = (n) => (Math.round(n * 100) / 100).toString();
+function formatHex(c) {
+  const mapped = toSrgbGamut(c);
+  const head = `#${hex2(byte(mapped.r))}${hex2(byte(mapped.g))}${hex2(byte(mapped.b))}`;
+  const alpha = byte(mapped.a);
+  return alpha === 255 ? head : head + hex2(alpha);
+}
+function formatColor(c, format) {
+  switch (format) {
+    case "hex":
+      return formatHex(c);
+    case "rgb": {
+      const inGamut = toSrgbGamut(c);
+      const r = byte(inGamut.r);
+      const g = byte(inGamut.g);
+      const b = byte(inGamut.b);
+      return c.a < 1 ? `rgb(${r} ${g} ${b} / ${round2(c.a)})` : `rgb(${r} ${g} ${b})`;
+    }
+    case "hsl": {
+      const hsl = _chunk5UEFBM2Mcjs.rgbToHsl.call(void 0, toSrgbGamut(c));
+      const h = (Math.round(hsl.h * 100) / 100).toString();
+      const s = (Math.round(hsl.s * 1e4) / 100).toString();
+      const l = (Math.round(hsl.l * 1e4) / 100).toString();
+      return c.a < 1 ? `hsl(${h} ${s}% ${l}% / ${round2(c.a)})` : `hsl(${h} ${s}% ${l}%)`;
+    }
+    case "oklch": {
+      const lch = _chunk5UEFBM2Mcjs.oklabToOklch.call(void 0, _chunk5UEFBM2Mcjs.rgbToOklab.call(void 0, c));
+      const l = (lch.l * 100).toFixed(2);
+      const ch = lch.c.toFixed(4);
+      const h = lch.h.toFixed(2);
+      return c.a < 1 ? `oklch(${l}% ${ch} ${h} / ${round2(c.a)})` : `oklch(${l}% ${ch} ${h})`;
+    }
+    case "oklab": {
+      const lab = _chunk5UEFBM2Mcjs.rgbToOklab.call(void 0, c);
+      const l = (lab.l * 100).toFixed(2);
+      const a = lab.a.toFixed(4);
+      const b = lab.b.toFixed(4);
+      return c.a < 1 ? `oklab(${l}% ${a} ${b} / ${round2(c.a)})` : `oklab(${l}% ${a} ${b})`;
+    }
+    case "p3": {
+      const linSrgb = {
+        r: _chunk5UEFBM2Mcjs.srgbToLinear.call(void 0, c.r),
+        g: _chunk5UEFBM2Mcjs.srgbToLinear.call(void 0, c.g),
+        b: _chunk5UEFBM2Mcjs.srgbToLinear.call(void 0, c.b),
+        a: c.a
+      };
+      const linP3 = _chunk5UEFBM2Mcjs.linearSrgbToDisplayP3.call(void 0, linSrgb);
+      const r = _chunk5UEFBM2Mcjs.linearToSrgb.call(void 0, linP3.r).toFixed(4);
+      const g = _chunk5UEFBM2Mcjs.linearToSrgb.call(void 0, linP3.g).toFixed(4);
+      const b = _chunk5UEFBM2Mcjs.linearToSrgb.call(void 0, linP3.b).toFixed(4);
+      return c.a < 1 ? `color(display-p3 ${r} ${g} ${b} / ${round2(c.a)})` : `color(display-p3 ${r} ${g} ${b})`;
+    }
+  }
+}
+function normalizeColor(input) {
+  const parsed = _chunk5UEFBM2Mcjs.parseColor.call(void 0, input);
+  return parsed ? formatHex(parsed) : null;
+}
+
+// src/color/suggest.ts
+function suggestAccessibleForeground(foreground, background, options = {}) {
+  const large = _nullishCoalesce(options.large, () => ( false));
+  const lch = _chunk5UEFBM2Mcjs.oklabToOklch.call(void 0, _chunk5UEFBM2Mcjs.rgbToOklab.call(void 0, foreground));
+  const asHex = (l) => _chunk5UEFBM2Mcjs.parseColor.call(void 0, formatHex(toSrgbGamut(_chunk5UEFBM2Mcjs.oklabToRgb.call(void 0, _chunk5UEFBM2Mcjs.oklchToOklab.call(void 0, { ...lch, l })))));
+  for (let d = 0.01; d <= 1; d += 0.01) {
+    const downCand = asHex(Math.max(0, lch.l - d));
+    const upCand = asHex(Math.min(1, lch.l + d));
+    const downRatio = _chunk5UEFBM2Mcjs.contrastRatio.call(void 0, downCand, background);
+    const upRatio = _chunk5UEFBM2Mcjs.contrastRatio.call(void 0, upCand, background);
+    const downPass = _chunk5UEFBM2Mcjs.contrastLevel.call(void 0, downRatio, { large }) !== "fail";
+    const upPass = _chunk5UEFBM2Mcjs.contrastLevel.call(void 0, upRatio, { large }) !== "fail";
+    if (downPass && upPass) return formatHex(downRatio >= upRatio ? downCand : upCand);
+    if (downPass) return formatHex(downCand);
+    if (upPass) return formatHex(upCand);
+  }
+  return void 0;
+}
+
+
+
+
+
+
+
+
+
+exports.inSrgbGamut = inSrgbGamut; exports.deltaEOK = deltaEOK; exports.toSrgbGamut = toSrgbGamut; exports.formatHex = formatHex; exports.formatColor = formatColor; exports.normalizeColor = normalizeColor; exports.suggestAccessibleForeground = suggestAccessibleForeground;