@pixerate/editor 0.165.0 → 0.166.0

package/dist/{chunk-ODFCS7HF.cjs → chunk-HXOBOHH2.cjs}

@@ -11,10 +11,10 @@ var _chunkYN6JKAUEcjs = require('./chunk-YN6JKAUE.cjs');
 
 
 
-var _chunkQ25WAFTDcjs = require('./chunk-Q25WAFTD.cjs');
+var _chunkSZWVMB3Bcjs = require('./chunk-SZWVMB3B.cjs');
 
 
-var _chunkUVXTOZ2Bcjs = require('./chunk-UVXTOZ2B.cjs');
+var _chunkBPX4Z3N3cjs = require('./chunk-BPX4Z3N3.cjs');
 
 // src/export/images.ts
 var DOCX_IMAGE_TYPES = {
@@ -1028,12 +1028,12 @@ var DocxBuilder = (_class2 = class {
       this.drop("node", "chart", "chart has no spec");
       return;
     }
-    const spec = _chunkUVXTOZ2Bcjs.normalizeChartSpec.call(void 0, raw).spec;
-    const written = _chunkQ25WAFTDcjs.chartToOoxml.call(void 0, spec);
+    const spec = _chunkBPX4Z3N3cjs.normalizeChartSpec.call(void 0, raw).spec;
+    const written = _chunkSZWVMB3Bcjs.chartToOoxml.call(void 0, spec);
     for (const issue of written.issues) this.drop("node", "chart", issue);
     const name = `chart${this.charts.length + 1}.xml`;
     this.charts.push(written.xml);
-    const relId = this.rels.add(_chunkQ25WAFTDcjs.CHART_OOXML_RELATIONSHIP, `charts/${name}`);
+    const relId = this.rels.add(_chunkSZWVMB3Bcjs.CHART_OOXML_RELATIONSHIP, `charts/${name}`);
     let width = _nullishCoalesce(pixelAttr(_optionalChain([node, 'access', _91 => _91.attrs, 'optionalAccess', _92 => _92.width])), () => ( MAX_IMAGE_WIDTH_PX));
     let height = _nullishCoalesce(pixelAttr(_optionalChain([node, 'access', _93 => _93.attrs, 'optionalAccess', _94 => _94.height])), () => ( 320));
     if (width > MAX_IMAGE_WIDTH_PX) {
@@ -1050,8 +1050,8 @@ var DocxBuilder = (_class2 = class {
     drawing.empty("wp:extent", { cx, cy }).empty("wp:effectExtent", { l: 0, t: 0, r: 0, b: 0 });
     drawing.empty("wp:docPr", { id, name: `Chart ${id}`, descr: title || void 0, title: title || void 0 });
     drawing.empty("wp:cNvGraphicFramePr");
-    drawing.open("a:graphic").open("a:graphicData", { uri: _chunkQ25WAFTDcjs.CHART_OOXML_NS });
-    drawing.empty("c:chart", { "xmlns:c": _chunkQ25WAFTDcjs.CHART_OOXML_NS, "r:id": relId });
+    drawing.open("a:graphic").open("a:graphicData", { uri: _chunkSZWVMB3Bcjs.CHART_OOXML_NS });
+    drawing.empty("c:chart", { "xmlns:c": _chunkSZWVMB3Bcjs.CHART_OOXML_NS, "r:id": relId });
     drawing.close("a:graphicData").close("a:graphic").close("wp:inline").close("w:drawing").close("w:r");
     this.report.written.paragraphs++;
     w.open("w:p");
@@ -1384,7 +1384,7 @@ var DocxBuilder = (_class2 = class {
     if (people) add("word/people.xml", people, `${CT_WML}people+xml`);
     parts.push({ name: "word/_rels/document.xml.rels", data: this.rels.xml() });
     for (const file of this.media) parts.push({ name: `word/media/${file.name}`, data: file.bytes });
-    this.charts.forEach((xml, i) => add(`word/charts/chart${i + 1}.xml`, xml, _chunkQ25WAFTDcjs.CHART_OOXML_CONTENT_TYPE));
+    this.charts.forEach((xml, i) => add(`word/charts/chart${i + 1}.xml`, xml, _chunkSZWVMB3Bcjs.CHART_OOXML_CONTENT_TYPE));
     add("docProps/core.xml", this.coreXml(now), "application/vnd.openxmlformats-package.core-properties+xml");
     const app = new XmlWriter();
     app.open("Properties", { xmlns: "http://schemas.openxmlformats.org/officeDocument/2006/extended-properties" });

package/dist/{chunk-V5GSY3NC.js → chunk-ITANXMZD.js}

@@ -12,7 +12,7 @@ import {
   chartTreeTotal,
   chartVariesColors,
   shadeChartColor
-} from "./chunk-2ZRN43IN.js";
+} from "./chunk-FR432ROA.js";
 import {
   NumberFormat
 } from "./chunk-II2WIF5Z.js";
@@ -1677,6 +1677,38 @@ function trendlineLegendItems(spec, color) {
   );
 }
 
+// src/chart/race.ts
+function chartRaceValueAt(series, index) {
+  for (let i = Math.min(index, series.values.length - 1); i >= 0; i--) {
+    const v = series.values[i];
+    if (v !== null && v !== void 0 && Number.isFinite(v)) return v;
+  }
+  return 0;
+}
+function chartRaceMoment(count, frame) {
+  const last = Math.max(0, count - 1);
+  const at = frame === null || frame === void 0 || !Number.isFinite(frame) ? last : Math.max(0, Math.min(last, frame));
+  const from = Math.floor(at);
+  const to = Math.min(last, from + 1);
+  return { from, to, t: at - from, at };
+}
+function chartRaceRanking(spec, frame) {
+  const visible = spec.series.filter((s) => !s.hidden);
+  const { from, to, t } = chartRaceMoment(spec.categories.length, frame);
+  const rankAt = (i) => {
+    const order2 = visible.map((s, k) => ({ id: s.id, v: chartRaceValueAt(s, i), k })).sort((a, b) => b.v - a.v || a.k - b.k);
+    return new Map(order2.map((o, r) => [o.id, r]));
+  };
+  const r0 = rankAt(from);
+  const r1 = rankAt(to);
+  const near = t < 0.5 ? r0 : r1;
+  return visible.map((s) => {
+    const a = chartRaceValueAt(s, from);
+    const b = chartRaceValueAt(s, to);
+    return { seriesId: s.id, name: s.name, value: a + (b - a) * t, position: r0.get(s.id) + (r1.get(s.id) - r0.get(s.id)) * t, rank: near.get(s.id) };
+  }).sort((a, b) => a.position - b.position || b.value - a.value);
+}
+
 // src/chart/layout-families.ts
 var sliceColor = (ctx, series, i) => series.pointColors?.[i] || chartSliceColor(ctx.spec, i);
 function layoutPie(ctx, area, series) {
@@ -2441,11 +2473,50 @@ function layoutSankey(ctx, area, series) {
   if (hidden) ctx.warn("labels-truncated", `${hidden} node label${hidden === 1 ? " was" : "s were"} shortened to fit between the columns.`);
   return { plot: area };
 }
+function layoutBarRace(ctx, area, frame) {
+  const { spec, theme, marks, fs, measure } = ctx;
+  const top = spec.raceTopN;
+  const moment = chartRaceMoment(spec.categories.length, frame);
+  const ranking = chartRaceRanking(spec, frame);
+  const shown = ranking.filter((e) => e.position < top);
+  const labelW = Math.min(area.width * 0.3, Math.max(0, ...ranking.map((e) => measure(e.name, fs)))) + 8;
+  const tickH = spec.yAxis.show ? fs * 1.6 : 4;
+  const plot = { x: area.x + labelW, y: area.y + tickH, width: Math.max(1, area.width - labelW - fs * 4), height: Math.max(1, area.height - tickH) };
+  const lead = Math.max(1e-9, ...shown.map((e) => e.value));
+  const max = spec.yAxis.max !== null && spec.yAxis.max > 0 ? spec.yAxis.max : lead * 1.08;
+  const xOf = (v) => plot.x + Math.max(0, Math.min(max, v)) / max * plot.width;
+  const ticks = niceScale(0, max, 5).ticks.filter((t) => t <= max);
+  const axisTarget = { kind: "axis", axis: "y" };
+  const format = spec.yAxis.format;
+  ticks.forEach((t, k) => {
+    if (spec.yAxis.gridlines) marks.push({ kind: "line", key: `grid-y-${k}`, role: "grid", x1: xOf(t), y1: plot.y, x2: xOf(t), y2: plot.y + plot.height, stroke: theme.grid, strokeWidth: 1 });
+    if (spec.yAxis.show) marks.push({ kind: "text", key: `tick-y-${k}`, role: "tick-label", x: xOf(t), y: area.y, text: formatChartNumber(t, format, format.decimals ?? stepDecimals(ticks[1] - ticks[0] || 1)), anchor: "middle", baseline: "top", size: fs - 1, fill: theme.mutedText, target: axisTarget });
+  });
+  const label = spec.categories[moment.t < 0.5 ? moment.from : moment.to] ?? "";
+  const timeSize = Math.min(theme.titleSize * 3, plot.height * 0.2, plot.width * 0.5 / Math.max(1, label.length * 0.6));
+  marks.push({ kind: "text", key: "race-time", role: "race-time", x: plot.x + plot.width, y: plot.y + plot.height - 4, text: label, anchor: "end", baseline: "bottom", size: timeSize, weight: 700, fill: theme.mutedText, opacity: 0.55, target: { kind: "category", index: moment.t < 0.5 ? moment.from : moment.to } });
+  const band = plot.height / top;
+  const barH = Math.max(2, band * (1 - Math.min(0.8, spec.gapWidth)));
+  const index = Math.round(moment.at);
+  for (const e of shown) {
+    const si = spec.series.findIndex((s2) => s2.id === e.seriesId);
+    const s = spec.series[si];
+    const y = plot.y + e.position * band + (band - barH) / 2;
+    const target = { kind: "point", seriesId: e.seriesId, index };
+    const selected = ctx.isSelected(target) || ctx.seriesSelected(e.seriesId);
+    const width = Math.max(0, xOf(e.value) - plot.x);
+    marks.push({ kind: "rect", key: `bar-${e.seriesId}`, role: "bar", x: plot.x, y, width, height: barH, fill: chartSeriesColor(spec, si), radius: Math.min(3, barH / 4), target, selected, ...selected ? { stroke: theme.selection, strokeWidth: 1.5 } : {} });
+    marks.push({ kind: "text", key: `label-name-${e.seriesId}`, role: "tick-label", x: plot.x - 6, y: y + barH / 2, text: truncate(e.name, labelW - 8, fs, measure), anchor: "end", baseline: "middle", size: fs, fill: selected ? theme.selection : theme.text, target: { kind: "series", seriesId: e.seriesId } });
+    if (s.dataLabels ?? true) marks.push({ kind: "text", key: `label-${e.seriesId}`, role: "data-label", x: plot.x + width + 5, y: y + barH / 2, text: formatChartNumber(e.value, s.format ?? format, (s.format ?? format).decimals ?? (Math.abs(e.value) >= 100 ? 0 : void 0)), anchor: "start", baseline: "middle", size: fs - 1, fill: theme.text, target });
+  }
+  if (ranking.length > top) ctx.warn("values-skipped", `The race shows the top ${top} of ${ranking.length} names at each moment (raceTopN).`);
+  return { plot, valueScale: { axis: "x", domain: [0, max], range: [plot.x, plot.x + plot.width], ticks } };
+}
 
 // src/chart/layout.ts
 function legendItems(spec, ctx) {
   const family = chartFamily(spec);
-  if (spec.type === "funnel" || spec.type === "slope" || spec.type === "sankey") return [];
+  if (spec.type === "funnel" || spec.type === "slope" || spec.type === "sankey" || spec.type === "barrace") return [];
   if (chartSpecColorsByCategory(spec)) {
     const first = spec.series.find((s) => !s.hidden);
     const seats = (i) => Math.max(0, Math.round(first?.values[i] ?? 0));
@@ -2585,6 +2656,8 @@ function layoutChart(spec, options) {
       return finish(layoutFunnel(ctx, area, visible[0]));
     case "treemap":
       return finish(spec.tree.length ? layoutTreemapTree(ctx, area, spec.series[0]) : layoutTreemap(ctx, area, visible[0]));
+    case "barrace":
+      return finish(layoutBarRace(ctx, area, options.raceFrame));
     case "sankey":
       if (!spec.links.length) {
         ctx.warn("type-fallback", "A Sankey diagram needs flows (set_chart_links); it is drawn as a bar chart until then.");
@@ -2794,6 +2867,9 @@ export {
   MAX_CHART_DATA_LABELS,
   MAX_CHART_LINE_POINTS,
   MAX_CHART_MARKERS,
+  chartRaceValueAt,
+  chartRaceMoment,
+  chartRaceRanking,
   layoutChart,
   chartValueAtPoint,
   chartXAtPoint,

package/dist/{chunk-TVQW26AV.cjs → chunk-MZFZSVUJ.cjs}

@@ -18,7 +18,7 @@
 
 
 
-var _chunkUVXTOZ2Bcjs = require('./chunk-UVXTOZ2B.cjs');
+var _chunkBPX4Z3N3cjs = require('./chunk-BPX4Z3N3.cjs');
 
 // src/chart/schemas.ts
 var VALUE = { type: ["number", "string", "null"], description: 'A number, numeric text ("1,200", "12%", "$40", "(3)") or null for a gap.' };
@@ -30,7 +30,7 @@ var FORMAT = {
   type: "object",
   description: "How numbers are written on this axis or series.",
   properties: {
-    style: { type: "string", enum: [..._chunkUVXTOZ2Bcjs.CHART_NUMBER_STYLES], description: "number (default), percent (0.25 \u2192 25%), currency or compact (1.2K)." },
+    style: { type: "string", enum: [..._chunkBPX4Z3N3cjs.CHART_NUMBER_STYLES], description: "number (default), percent (0.25 \u2192 25%), currency or compact (1.2K)." },
     decimals: { type: "integer", minimum: 0, maximum: 10, description: "Fixed decimals (default: what the ticks need)." },
     currency: { type: "string", description: 'ISO currency code for style "currency", e.g. "EUR" (default USD).' },
     prefix: { type: "string", description: "Text before every number." },
@@ -50,10 +50,10 @@ var AXIS = (what) => ({
     step: { type: ["number", "null"], exclusiveMinimum: 0, description: "Fixed distance between ticks, or null for automatic." },
     gridlines: { type: "boolean", description: "Grid lines at each tick." },
     format: FORMAT,
-    kind: { type: ["string", "null"], enum: [..._chunkUVXTOZ2Bcjs.CHART_AXIS_KINDS, null], description: 'Category axis only: "date" reads categories as dates and labels them by calendar steps.' },
+    kind: { type: ["string", "null"], enum: [..._chunkBPX4Z3N3cjs.CHART_AXIS_KINDS, null], description: 'Category axis only: "date" reads categories as dates and labels them by calendar steps.' },
     scale: {
       type: ["string", "null"],
-      enum: [..._chunkUVXTOZ2Bcjs.CHART_AXIS_SCALES, null],
+      enum: [..._chunkBPX4Z3N3cjs.CHART_AXIS_SCALES, null],
       description: 'Value axes and the numeric x axis of scatter / bubble charts: "log" spaces ticks by powers of logBase (values of 0 or less are skipped; min and max must be above 0; not with percent stacking). "linear" or null is the default. Ignored on a category axis.'
     },
     logBase: { type: ["number", "null"], minimum: 2, maximum: 1e3, description: "Base of a log axis, 2 to 1000 (default 10; null resets)." },
@@ -62,7 +62,7 @@ var AXIS = (what) => ({
   additionalProperties: false
 });
 var TRENDLINE_PROPS = {
-  type: { type: "string", enum: [..._chunkUVXTOZ2Bcjs.CHART_TRENDLINE_TYPES], description: "Fit: linear, exponential, logarithmic, power, polynomial or moving-average." },
+  type: { type: "string", enum: [..._chunkBPX4Z3N3cjs.CHART_TRENDLINE_TYPES], description: "Fit: linear, exponential, logarithmic, power, polynomial or moving-average." },
   order: { type: "integer", minimum: 2, maximum: 6, description: "Polynomial order (default 2)." },
   period: { type: "integer", minimum: 2, description: "Moving-average period in points (default 2)." },
   forward: { type: "number", minimum: 0, description: "Extend the line this many x units past the last point (default 0)." },
@@ -77,7 +77,7 @@ var REFERENCE_COMMON = {
   label: { type: "string", description: 'Text written on it, e.g. "Target" (default none).' },
   axis: {
     type: "string",
-    enum: [..._chunkUVXTOZ2Bcjs.CHART_REFERENCE_AXES],
+    enum: [..._chunkBPX4Z3N3cjs.CHART_REFERENCE_AXES],
     description: "Axis it is measured on: y (default) is the value axis, y2 the secondary value axis (needs a series there), x the numeric x axis of a scatter or bubble chart."
   },
   color: { type: "string", description: "CSS colour (default: the text colour)." }
@@ -93,7 +93,7 @@ var REFERENCE_BAND_PROPS = {
 };
 var REFERENCE_COMMON_PATCH = {
   label: { type: ["string", "null"], description: "Text written on it; null removes it." },
-  axis: { type: ["string", "null"], enum: [..._chunkUVXTOZ2Bcjs.CHART_REFERENCE_AXES, null], description: "Axis it is measured on (y, y2 or x); null goes back to y." },
+  axis: { type: ["string", "null"], enum: [..._chunkBPX4Z3N3cjs.CHART_REFERENCE_AXES, null], description: "Axis it is measured on (y, y2 or x); null goes back to y." },
   color: { type: ["string", "null"], description: "CSS colour; null goes back to the text colour." }
 };
 var REFERENCE_LINE_PATCH = { value: REFERENCE_LINE_PROPS.value, ...REFERENCE_COMMON_PATCH };
@@ -119,6 +119,7 @@ var LINK_PROPS = {
   value: { type: "number", exclusiveMinimum: 0, description: "How much flows, above 0 (its width)." },
   color: { type: "string", description: "CSS colour (default: by sankeyLinkColor)." }
 };
+var RACE_TIME = { type: ["string", "number"], description: 'Time point label (a category, e.g. "2023") or index from 0; an index may be fractional, 2.5 being halfway between the third and fourth time points.' };
 var LINK_INDEX = { type: "integer", minimum: 0, description: "Flow index (0 = first), as get_chart lists them in spec.links." };
 var ERROR_BARS = (what) => ({
   type: ["object", "null"],
@@ -126,13 +127,13 @@ var ERROR_BARS = (what) => ({
   properties: {
     type: {
       type: "string",
-      enum: [..._chunkUVXTOZ2Bcjs.CHART_ERROR_BAR_TYPES],
+      enum: [..._chunkBPX4Z3N3cjs.CHART_ERROR_BAR_TYPES],
       description: "fixed: the same amount at every point; percent: a percentage of each value; stddev: value standard deviations of the series, drawn around the series mean (as Excel does); stderr: the standard error of the series at every point; custom: per-point plus / minus amounts."
     },
     value: { type: "number", minimum: 0, description: "Amount in data units for fixed (default 1), percent of each value for percent (default 5), number of standard deviations for stddev (default 1). Not for stderr or custom." },
     plus: { type: "array", items: VALUE, description: "custom only: amount above each point, one per category, in data units (0 or more; null for none)." },
     minus: { type: "array", items: VALUE, description: "custom only: amount below each point, one per category (default: the plus amounts)." },
-    direction: { type: "string", enum: [..._chunkUVXTOZ2Bcjs.CHART_ERROR_BAR_DIRECTIONS], description: "both (default), plus (only above) or minus (only below)." },
+    direction: { type: "string", enum: [..._chunkBPX4Z3N3cjs.CHART_ERROR_BAR_DIRECTIONS], description: "both (default), plus (only above) or minus (only below)." },
     cap: { type: "boolean", description: "Draw end caps (default true)." }
   },
   required: ["type"],
@@ -142,22 +143,22 @@ var SERIES_PROPS = {
   name: { type: "string", description: "Series name (legend and data grid header)." },
   values: { type: "array", items: VALUE, description: "One value per category, in category order (padded with gaps)." },
   color: { type: ["string", "null"], description: "CSS colour, or null for the palette colour." },
-  type: { type: ["string", "null"], enum: [..._chunkUVXTOZ2Bcjs.CHART_SERIES_TYPES, null], description: "Draw this series as bar, line, area or scatter (a combo chart); null follows the chart type." },
+  type: { type: ["string", "null"], enum: [..._chunkBPX4Z3N3cjs.CHART_SERIES_TYPES, null], description: "Draw this series as bar, line, area or scatter (a combo chart); null follows the chart type." },
   hidden: { type: "boolean", description: "Hide the series (its data is kept)." },
   axis: { type: ["string", "null"], enum: ["primary", "secondary", null], description: "Value axis: secondary is drawn on the right with its own scale." },
   x: { type: ["array", "null"], items: VALUE, description: "Numeric x per category, for scatter and bubble charts." },
   sizes: { type: ["array", "null"], items: VALUE, description: "Bubble sizes per category (area is proportional to size)." },
   pointColors: { type: ["array", "null"], items: { type: ["string", "null"] }, description: "Colour per category (null keeps the series colour)." },
   callouts: { type: ["array", "null"], items: { type: ["string", "null"] }, description: "A label pinned to each point that matters, one per category (null: none); null removes them all. Bar, line, area and scatter charts. set_chart_callout sets one." },
-  marker: { type: ["string", "null"], enum: [..._chunkUVXTOZ2Bcjs.CHART_MARKERS, null], description: "Point marker shape for line, area and scatter series." },
-  curve: { type: ["string", "null"], enum: [..._chunkUVXTOZ2Bcjs.CHART_CURVES, null], description: "Line shape for this series: linear, smooth or step." },
+  marker: { type: ["string", "null"], enum: [..._chunkBPX4Z3N3cjs.CHART_MARKERS, null], description: "Point marker shape for line, area and scatter series." },
+  curve: { type: ["string", "null"], enum: [..._chunkBPX4Z3N3cjs.CHART_CURVES, null], description: "Line shape for this series: linear, smooth or step." },
   dataLabels: { type: ["boolean", "null"], description: "Value labels for this series (null follows the chart)." },
   format: { ...FORMAT, type: ["object", "null"], description: "How this series' labels are written (null follows the value axis)." },
   errorBars: ERROR_BARS("Error bars along the value axis (bar, line, area and scatter series; on stacked charts they sit on the stack top)."),
   xErrorBars: ERROR_BARS("Error bars along the x axis (scatter and bubble charts with numeric x values; amounts in x units).")
 };
 var CHART_UPDATE_PROPERTIES = {
-  type: { type: "string", enum: [..._chunkUVXTOZ2Bcjs.CHART_TYPES], description: "Chart type. slope joins each category from the first series (before) to the second (after); likert reads each category as a question and the series as answers from most negative to most positive; parliament draws the first series as seats; sunburst draws the grouped data (set_chart_tree) as rings, and a treemap with grouped data nests its groups; sankey draws the flows (set_chart_links)." },
+  type: { type: "string", enum: [..._chunkBPX4Z3N3cjs.CHART_TYPES], description: "Chart type. slope joins each category from the first series (before) to the second (after); likert reads each category as a question and the series as answers from most negative to most positive; parliament draws the first series as seats; sunburst draws the grouped data (set_chart_tree) as rings, and a treemap with grouped data nests its groups; sankey draws the flows (set_chart_links); barrace reads categories as time points and series as names, and animates their ranking." },
   title: { type: "string", description: 'Title ("" for none).' },
   subtitle: { type: "string", description: 'Subtitle ("" for none).' },
   xAxis: AXIS("Category axis (or numeric x axis of scatter / bubble charts)."),
@@ -166,15 +167,15 @@ var CHART_UPDATE_PROPERTIES = {
   legend: {
     type: "object",
     description: "Legend.",
-    properties: { show: { type: "boolean", description: "Show the legend." }, position: { type: "string", enum: [..._chunkUVXTOZ2Bcjs.CHART_LEGEND_POSITIONS], description: "Where the legend goes." } },
+    properties: { show: { type: "boolean", description: "Show the legend." }, position: { type: "string", enum: [..._chunkBPX4Z3N3cjs.CHART_LEGEND_POSITIONS], description: "Where the legend goes." } },
     additionalProperties: false
   },
-  stacking: { type: "string", enum: [..._chunkUVXTOZ2Bcjs.CHART_STACKINGS], description: "none, stacked, or percent (each category scaled to 100%)." },
-  orientation: { type: "string", enum: [..._chunkUVXTOZ2Bcjs.CHART_ORIENTATIONS], description: "horizontal draws bars sideways." },
-  curve: { type: "string", enum: [..._chunkUVXTOZ2Bcjs.CHART_CURVES], description: "Line shape: linear, smooth or step." },
+  stacking: { type: "string", enum: [..._chunkBPX4Z3N3cjs.CHART_STACKINGS], description: "none, stacked, or percent (each category scaled to 100%)." },
+  orientation: { type: "string", enum: [..._chunkBPX4Z3N3cjs.CHART_ORIENTATIONS], description: "horizontal draws bars sideways." },
+  curve: { type: "string", enum: [..._chunkBPX4Z3N3cjs.CHART_CURVES], description: "Line shape: linear, smooth or step." },
   points: { type: "boolean", description: "Dots on line and area series." },
   dataLabels: { type: "boolean", description: "Value labels on bars, points and slices." },
-  labelPosition: { type: "string", enum: [..._chunkUVXTOZ2Bcjs.CHART_LABEL_POSITIONS], description: "Bar label position; auto drops labels that do not fit." },
+  labelPosition: { type: "string", enum: [..._chunkBPX4Z3N3cjs.CHART_LABEL_POSITIONS], description: "Bar label position; auto drops labels that do not fit." },
   palette: { type: "array", items: { type: "string" }, minItems: 1, description: "Series colours in order (CSS colours)." },
   innerRadius: { type: "number", minimum: 0, maximum: 0.9, description: "Donut hole as a fraction of the radius." },
   gapWidth: { type: "number", minimum: 0, maximum: 0.9, description: "Space between bar groups as a fraction of the category (default 0.28)." },
@@ -182,19 +183,20 @@ var CHART_UPDATE_PROPERTIES = {
   bins: { type: ["integer", "null"], minimum: 1, maximum: 500, description: "Histogram bin count, or null for \u221An." },
   showTotal: { type: "boolean", description: "Waterfall: append a total bar." },
   radarTicks: { type: ["integer", "null"], minimum: 1, maximum: 50, description: "Radar: number of evenly spaced rings from the value axis min to max, or null for round-number rings (default null)." },
-  radarGraticule: { type: "string", enum: [..._chunkUVXTOZ2Bcjs.CHART_RADAR_GRATICULES], description: "Radar: draw rings as polygons through the spokes or as circles (default polygon)." },
+  radarGraticule: { type: "string", enum: [..._chunkBPX4Z3N3cjs.CHART_RADAR_GRATICULES], description: "Radar: draw rings as polygons through the spokes or as circles (default polygon)." },
   note: { type: "string", description: 'A source or footnote written under the chart ("" for none).' },
   highlight: { type: "array", items: { type: "string" }, description: "Category labels and series names (or ids) to draw normally while the rest are muted; [] shows everything. highlight_chart checks the names." },
   referenceLines: { type: "array", items: { type: "object", properties: REFERENCE_LINE_PROPS, required: ["value"], additionalProperties: false }, description: "Replaces every reference line (targets, floors, averages across the plot). add_chart_reference_line adds one." },
   referenceBands: { type: "array", items: { type: "object", properties: REFERENCE_BAND_PROPS, required: ["from", "to"], additionalProperties: false }, description: "Replaces every reference band (target ranges across the plot). add_chart_reference_band adds one." },
   varyColors: { type: "boolean", description: "A one-series bar, line, area or scatter chart colours each category from the palette, and its legend lists the categories (default false)." },
-  likertNeutral: { type: "string", enum: [..._chunkUVXTOZ2Bcjs.CHART_LIKERT_NEUTRALS], description: "Likert with an odd number of answers: split (default) puts the middle answer across the centre line; separate draws it in its own column on the right." },
-  likertSort: { type: "string", enum: [..._chunkUVXTOZ2Bcjs.CHART_LIKERT_SORTS], description: "Likert: order the questions by agreement (positive), by disagreement (negative) or as given (none, default)." },
+  likertNeutral: { type: "string", enum: [..._chunkBPX4Z3N3cjs.CHART_LIKERT_NEUTRALS], description: "Likert with an odd number of answers: split (default) puts the middle answer across the centre line; separate draws it in its own column on the right." },
+  likertSort: { type: "string", enum: [..._chunkBPX4Z3N3cjs.CHART_LIKERT_SORTS], description: "Likert: order the questions by agreement (positive), by disagreement (negative) or as given (none, default)." },
   parliamentArc: { type: "number", minimum: 90, maximum: 360, description: "Parliament: sweep of the hemicycle in degrees (default 180)." },
   parliamentMajority: { type: ["integer", "null"], minimum: 1, description: "Parliament: seats needed for a majority, drawn as a dashed line (null: half of the seats plus one)." },
   parliamentLabel: { type: "string", description: 'Parliament: caption under the seat total ("" writes "seats").' },
   sunburstLabel: { type: "string", description: 'Sunburst: caption under the total in the centre ("" for none).' },
-  sankeyLinkColor: { type: "string", enum: [..._chunkUVXTOZ2Bcjs.CHART_SANKEY_LINK_COLORS], description: "Sankey: colour each flow by its source node (default), its target node, or grey." },
+  sankeyLinkColor: { type: "string", enum: [..._chunkBPX4Z3N3cjs.CHART_SANKEY_LINK_COLORS], description: "Sankey: colour each flow by its source node (default), its target node, or grey." },
+  raceTopN: { type: "integer", minimum: 1, maximum: 30, description: "Bar race: how many bars each moment shows (default 10)." },
   sankeyNodes: { type: "array", items: { type: "string" }, description: "Sankey: node names in the order to stack them within their columns (reorder to untangle crossing flows); nodes left out follow in the order the flows name them." }
 };
 
@@ -216,4 +218,5 @@ var CHART_UPDATE_PROPERTIES = {
 
 
 
-exports.VALUE = VALUE; exports.SERIES_REF = SERIES_REF; exports.CATEGORY_REF = CATEGORY_REF; exports.WIDTH = WIDTH; exports.HEIGHT = HEIGHT; exports.TRENDLINE_PROPS = TRENDLINE_PROPS; exports.REFERENCE_LINE_PROPS = REFERENCE_LINE_PROPS; exports.REFERENCE_BAND_PROPS = REFERENCE_BAND_PROPS; exports.REFERENCE_LINE_PATCH = REFERENCE_LINE_PATCH; exports.REFERENCE_BAND_PATCH = REFERENCE_BAND_PATCH; exports.REFERENCE_INDEX = REFERENCE_INDEX; exports.TREE_DEFS = TREE_DEFS; exports.TREE_PATH = TREE_PATH; exports.LINK_PROPS = LINK_PROPS; exports.LINK_INDEX = LINK_INDEX; exports.SERIES_PROPS = SERIES_PROPS; exports.CHART_UPDATE_PROPERTIES = CHART_UPDATE_PROPERTIES;
+
+exports.VALUE = VALUE; exports.SERIES_REF = SERIES_REF; exports.CATEGORY_REF = CATEGORY_REF; exports.WIDTH = WIDTH; exports.HEIGHT = HEIGHT; exports.TRENDLINE_PROPS = TRENDLINE_PROPS; exports.REFERENCE_LINE_PROPS = REFERENCE_LINE_PROPS; exports.REFERENCE_BAND_PROPS = REFERENCE_BAND_PROPS; exports.REFERENCE_LINE_PATCH = REFERENCE_LINE_PATCH; exports.REFERENCE_BAND_PATCH = REFERENCE_BAND_PATCH; exports.REFERENCE_INDEX = REFERENCE_INDEX; exports.TREE_DEFS = TREE_DEFS; exports.TREE_PATH = TREE_PATH; exports.LINK_PROPS = LINK_PROPS; exports.RACE_TIME = RACE_TIME; exports.LINK_INDEX = LINK_INDEX; exports.SERIES_PROPS = SERIES_PROPS; exports.CHART_UPDATE_PROPERTIES = CHART_UPDATE_PROPERTIES;

package/dist/{chunk-N7NBGT2Y.js → chunk-NQQDGGXY.js}

@@ -11,10 +11,10 @@ import {
   CHART_OOXML_NS,
   CHART_OOXML_RELATIONSHIP,
   chartToOoxml
-} from "./chunk-CRFSQWKQ.js";
+} from "./chunk-XNU45TYA.js";
 import {
   normalizeChartSpec
-} from "./chunk-2ZRN43IN.js";
+} from "./chunk-FR432ROA.js";
 
 // src/export/images.ts
 var DOCX_IMAGE_TYPES = {

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

@@ -8,7 +8,7 @@
 
 
 
-var _chunkUVXTOZ2Bcjs = require('./chunk-UVXTOZ2B.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: _chunkUVXTOZ2Bcjs.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: _chunkUVXTOZ2Bcjs.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: _chunkUVXTOZ2Bcjs.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) => !_chunkUVXTOZ2Bcjs.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 && _chunkUVXTOZ2Bcjs.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, _chunkUVXTOZ2Bcjs.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])), _chunkUVXTOZ2Bcjs.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, _chunkUVXTOZ2Bcjs.defaultChartAxis.call(void 0, false));
-  const { spec, issues: specIssues } = _chunkUVXTOZ2Bcjs.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: _chunkUVXTOZ2Bcjs.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 = _chunkUVXTOZ2Bcjs.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 } = _chunkUVXTOZ2Bcjs.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 = _chunkUVXTOZ2Bcjs.parseChartColor.call(void 0, color);
-  return rgb ? _chunkUVXTOZ2Bcjs.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 = _chunkUVXTOZ2Bcjs.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,9 @@ 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";
@@ -502,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" : _chunkUVXTOZ2Bcjs.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);
@@ -565,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 = _chunkUVXTOZ2Bcjs.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("");