@pixerate/editor 0.162.0 → 0.163.0

package/dist/{chunk-3IHNXRUV.cjs → chunk-GKNEJ6EN.cjs}

@@ -7,7 +7,7 @@
 
 
 
-var _chunkHDGBM7EAcjs = require('./chunk-HDGBM7EA.cjs');
+var _chunkSBQVEBSUcjs = require('./chunk-SBQVEBSU.cjs');
 
 
 
@@ -27,7 +27,16 @@ var _chunkHDGBM7EAcjs = require('./chunk-HDGBM7EA.cjs');
 
 
 
-var _chunkLL3H5XUHcjs = require('./chunk-LL3H5XUH.cjs');
+
+
+
+
+
+
+
+
+
+var _chunkR3P2M7HUcjs = require('./chunk-R3P2M7HU.cjs');
 
 
 
@@ -63,8 +72,8 @@ function splitOutside(text, sep) {
   return out;
 }
 function chartMermaidFamily(spec) {
-  const family = _chunkLL3H5XUHcjs.chartFamily.call(void 0, spec);
-  if (family === "pie" || family === "funnel" || family === "treemap") return "pie";
+  const family = _chunkR3P2M7HUcjs.chartFamily.call(void 0, spec);
+  if (family === "pie" || family === "funnel" || family === "treemap" || family === "parliament" || family === "sunburst") return "pie";
   if (family === "radar") return "radar";
   return "xychart";
 }
@@ -227,8 +236,8 @@ function chartFromMermaid(text, options = {}) {
   let title = _nullishCoalesce(frontTitle, () => ( ""));
   const categories = [];
   const series = [];
-  const xAxis = _chunkLL3H5XUHcjs.defaultChartAxis.call(void 0, false);
-  const yAxis = _chunkLL3H5XUHcjs.defaultChartAxis.call(void 0, true);
+  const xAxis = _chunkR3P2M7HUcjs.defaultChartAxis.call(void 0, false);
+  const yAxis = _chunkR3P2M7HUcjs.defaultChartAxis.call(void 0, true);
   const radarAxes = [];
   const pieSlices = [];
   let legendShow = true;
@@ -388,7 +397,7 @@ function chartFromMermaid(text, options = {}) {
       input.series = metaSeries.map((extra, i) => ({ ..._nullishCoalesce(base[i], () => ( {})), ..._nullishCoalesce(extra, () => ( {})) }));
     }
   }
-  const { spec, issues: specIssues } = _chunkLL3H5XUHcjs.normalizeChartSpec.call(void 0, input);
+  const { spec, issues: specIssues } = _chunkR3P2M7HUcjs.normalizeChartSpec.call(void 0, input);
   if (!family && !partial && !issues.length) issues.push({ path: "header", message: "The text is empty: expected a chart header (xychart-beta, pie or radar-beta)." });
   return { spec, issues: [...issues, ...specIssues], family, hasMeta: !!meta };
 }
@@ -427,11 +436,11 @@ function findMermaidCharts(text) {
 }
 
 // src/chart/summary.ts
-function summarizeChart(spec, size = { width: 640, height: 400 }, scene = _chunkHDGBM7EAcjs.layoutChart.call(void 0, spec, { ...size, selection: null })) {
+function summarizeChart(spec, size = { width: 640, height: 400 }, scene = _chunkSBQVEBSUcjs.layoutChart.call(void 0, spec, { ...size, selection: null })) {
   const visible = spec.series.filter((s) => !s.hidden);
-  const series = visible.map((s) => _chunkHDGBM7EAcjs.summarizeChartSeries.call(void 0, s, spec.categories));
-  const colors = _chunkLL3H5XUHcjs.chartColorsByCategory.call(void 0, spec.type) ? spec.categories.map((_, i) => _optionalChain([visible, 'access', _10 => _10[0], 'optionalAccess', _11 => _11.pointColors, 'optionalAccess', _12 => _12[i]]) || _chunkLL3H5XUHcjs.chartSliceColor.call(void 0, spec, i)) : visible.map((s) => _chunkLL3H5XUHcjs.chartSeriesColor.call(void 0, spec, spec.series.indexOf(s)));
-  const check = _chunkLL3H5XUHcjs.checkChartColors.call(void 0, colors, { surface: scene.theme.surface.startsWith("var(") ? "#ffffff" : scene.theme.surface });
+  const series = visible.map((s) => _chunkSBQVEBSUcjs.summarizeChartSeries.call(void 0, s, spec.categories));
+  const colors = _chunkR3P2M7HUcjs.chartSpecColorsByCategory.call(void 0, spec) ? spec.categories.map((_, i) => _optionalChain([visible, 'access', _10 => _10[0], 'optionalAccess', _11 => _11.pointColors, 'optionalAccess', _12 => _12[i]]) || _chunkR3P2M7HUcjs.chartSliceColor.call(void 0, spec, i)) : visible.map((s) => _chunkR3P2M7HUcjs.chartSeriesColor.call(void 0, spec, spec.series.indexOf(s)));
+  const check = _chunkR3P2M7HUcjs.checkChartColors.call(void 0, colors, { surface: scene.theme.surface.startsWith("var(") ? "#ffffff" : scene.theme.surface });
   const axis = (s, a) => s ? { min: s.domain[0], max: s.domain[1], ticks: [...s.ticks], ...s.logBase ? { logBase: s.logBase } : {}, ...a.reverse ? { reversed: true } : {} } : void 0;
   return {
     type: spec.type,
@@ -446,22 +455,58 @@ function summarizeChart(spec, size = { width: 640, height: 400 }, scene = _chunk
     description: describeChart(spec, series)
   };
 }
-function describeChart(spec, series = spec.series.filter((s) => !s.hidden).map((s) => _chunkHDGBM7EAcjs.summarizeChartSeries.call(void 0, s, spec.categories))) {
-  const kind = _chunkLL3H5XUHcjs.CHART_TYPE_LABELS[spec.type].toLowerCase();
+function describeChart(spec, series = spec.series.filter((s) => !s.hidden).map((s) => _chunkSBQVEBSUcjs.summarizeChartSeries.call(void 0, s, spec.categories))) {
+  const kind = _chunkR3P2M7HUcjs.CHART_TYPE_LABELS[spec.type].toLowerCase();
   const parts = [];
-  const family = _chunkLL3H5XUHcjs.chartFamily.call(void 0, spec);
+  const family = _chunkR3P2M7HUcjs.chartFamily.call(void 0, spec);
   const format = spec.yAxis.format;
-  const fmt = (v) => v === null ? "blank" : _chunkHDGBM7EAcjs.formatChartNumber.call(void 0, v, format);
+  const fmt = (v) => v === null ? "blank" : _chunkSBQVEBSUcjs.formatChartNumber.call(void 0, v, format);
   const head = spec.title ? `${spec.title}: a ${kind} chart` : `A ${kind} chart`;
   if (!series.length || series.every((s) => s.count === 0)) return `${head} with no data.`;
-  if (family === "pie" || family === "funnel" || family === "treemap") {
+  if (family === "pie" || family === "funnel" || family === "treemap" || family === "sunburst") {
     const s = series[0];
     const total = _nullishCoalesce(s.sum, () => ( 0));
     const share = (v) => total && v !== null ? ` (${Math.round(v / total * 100)}%)` : "";
     parts.push(`${head} of ${s.name} across ${spec.categories.length} categories, totalling ${fmt(s.sum)}.`);
     parts.push(`The largest is ${s.maxAt} at ${fmt(s.max)}${share(s.max)}; the smallest is ${s.minAt} at ${fmt(s.min)}${share(s.min)}.`);
+    if (spec.tree.length) {
+      const depth = _chunkR3P2M7HUcjs.chartTreeDepth.call(void 0, spec.tree);
+      const items = _chunkR3P2M7HUcjs.chartTreeToRows.call(void 0, spec.tree).length;
+      parts.push(`The data is grouped ${depth} level${depth === 1 ? "" : "s"} deep with ${items} item${items === 1 ? "" : "s"}.`);
+    }
     return parts.join(" ");
   }
+  if (family === "parliament") {
+    const s = spec.series.find((x) => !x.hidden);
+    const seats = spec.categories.map((c, i) => ({ c, n: Math.max(0, Math.round(_nullishCoalesce(s.values[i], () => ( 0)))) }));
+    const total = seats.reduce((t, x) => t + x.n, 0);
+    const majority = _nullishCoalesce(spec.parliamentMajority, () => ( Math.floor(total / 2) + 1));
+    const largest = [...seats].sort((a, b) => b.n - a.n)[0];
+    const verdict = largest && largest.n >= majority ? `${largest.c} holds a majority with ${largest.n}` : `no group reaches the majority of ${majority}; the largest is ${_optionalChain([largest, 'optionalAccess', _13 => _13.c])} with ${_optionalChain([largest, 'optionalAccess', _14 => _14.n])}`;
+    return `${head} of ${total} seats across ${seats.length} groups: ${verdict}.`;
+  }
+  if (family === "slope") {
+    const [a, b] = spec.series.filter((x) => !x.hidden);
+    if (!b) return `${head} that needs a second series to compare against.`;
+    const moves = spec.categories.map((c, i) => ({ c, d: a.values[i] !== null && b.values[i] !== null ? b.values[i] - a.values[i] : null })).filter((m) => m.d !== null);
+    const up = moves.filter((m) => m.d > 0).length;
+    const down = moves.filter((m) => m.d < 0).length;
+    const top = [...moves].sort((x, y) => y.d - x.d);
+    const extremes = top.length ? ` The biggest rise is ${top[0].c} (${fmt(top[0].d)}); the biggest fall is ${top[top.length - 1].c} (${fmt(top[top.length - 1].d)}).` : "";
+    return `${head} from ${a.name} to ${b.name}: ${up} of ${moves.length} rose and ${down} fell.${extremes}`;
+  }
+  if (family === "likert") {
+    const answers = spec.series.filter((x) => !x.hidden);
+    const side = Math.floor(answers.length / 2);
+    const agree = spec.categories.map((c, i) => {
+      const vals = answers.map((x) => Math.max(0, _nullishCoalesce(x.values[i], () => ( 0))));
+      const total = vals.reduce((t, v) => t + v, 0);
+      return { c, share: total ? vals.slice(answers.length - side).reduce((t, v) => t + v, 0) / total : 0 };
+    });
+    const best = [...agree].sort((x, y) => y.share - x.share);
+    const pct = (v) => `${Math.round(v * 100)}%`;
+    return `${head} of ${spec.categories.length} questions with ${answers.length} answers from ${_optionalChain([answers, 'access', _15 => _15[0], 'optionalAccess', _16 => _16.name])} to ${_optionalChain([answers, 'access', _17 => _17[answers.length - 1], 'optionalAccess', _18 => _18.name])}. Most positive: ${_optionalChain([best, 'access', _19 => _19[0], 'optionalAccess', _20 => _20.c])} (${pct(_nullishCoalesce(_optionalChain([best, 'access', _21 => _21[0], 'optionalAccess', _22 => _22.share]), () => ( 0)))}); least: ${_optionalChain([best, 'access', _23 => _23[best.length - 1], 'optionalAccess', _24 => _24.c])} (${pct(_nullishCoalesce(_optionalChain([best, 'access', _25 => _25[best.length - 1], 'optionalAccess', _26 => _26.share]), () => ( 0)))}).`;
+  }
   if (family === "waterfall") {
     const s = spec.series.find((x) => !x.hidden);
     const steps = s.values.filter((v, i) => v !== null && Number.isFinite(v) && !/\b(sub)?total\b/i.test(_nullishCoalesce(spec.categories[i], () => ( ""))));
@@ -499,7 +544,7 @@ function describeChart(spec, series = spec.series.filter((s) => !s.hidden).map((
   }
   parts.push(...axes);
   for (const s of spec.series.filter((x) => !x.hidden && (x.errorBars || x.xErrorBars)).slice(0, 8)) {
-    const bars = [s.errorBars ? _chunkLL3H5XUHcjs.describeChartErrorBars.call(void 0, s.errorBars) : "", s.xErrorBars ? `x ${_chunkLL3H5XUHcjs.describeChartErrorBars.call(void 0, s.xErrorBars)}` : ""].filter(Boolean).join(" and ");
+    const bars = [s.errorBars ? _chunkR3P2M7HUcjs.describeChartErrorBars.call(void 0, s.errorBars) : "", s.xErrorBars ? `x ${_chunkR3P2M7HUcjs.describeChartErrorBars.call(void 0, s.xErrorBars)}` : ""].filter(Boolean).join(" and ");
     parts.push(`${s.name} has ${bars}.`);
   }
   return parts.join(" ");
@@ -564,7 +609,7 @@ function chartSceneToSvg(scene, options = {}) {
   return `<svg xmlns="http://www.w3.org/2000/svg" width="${scene.width}" height="${scene.height}" viewBox="0 0 ${scene.width} ${scene.height}" role="img"${label ? ` aria-label="${escape(label)}"` : ""}${labelled ? ` aria-labelledby="${labelled}"` : ""}>${head}${body}</svg>`;
 }
 function chartToSvg(spec, options) {
-  const scene = _chunkHDGBM7EAcjs.layoutChart.call(void 0, spec, { ...options, selection: null });
+  const scene = _chunkSBQVEBSUcjs.layoutChart.call(void 0, spec, { ...options, selection: null });
   return chartSceneToSvg(scene, { ...options, ariaLabel: _nullishCoalesce(options.ariaLabel, () => ( (spec.title || void 0))), description: _nullishCoalesce(options.description, () => ( describeChart(spec))) });
 }
 var SVG_NS = "http://www.w3.org/2000/svg";
@@ -602,10 +647,10 @@ var CHART_LAYOUT_PRESETS = [
 ];
 function monochromeChartPalette(base, count = 6) {
   const steps = count <= 1 ? [0] : Array.from({ length: count }, (_, i) => -0.45 + 1.05 * i / (count - 1));
-  return steps.map((t) => _chunkLL3H5XUHcjs.shadeChartColor.call(void 0, base, t));
+  return steps.map((t) => _chunkR3P2M7HUcjs.shadeChartColor.call(void 0, base, t));
 }
 var CHART_COLOR_SCHEMES = [
-  { id: "default", label: "Default", description: "Ten distinct colours, readable on light and dark backgrounds.", palette: _chunkLL3H5XUHcjs.DEFAULT_CHART_PALETTE },
+  { id: "default", label: "Default", description: "Ten distinct colours, readable on light and dark backgrounds.", palette: _chunkR3P2M7HUcjs.DEFAULT_CHART_PALETTE },
   { id: "okabe-ito", label: "Okabe\u2013Ito", description: "Eight colours chosen to stay distinct with colour-blindness.", palette: ["#e69f00", "#56b4e9", "#009e73", "#f0e442", "#0072b2", "#d55e00", "#cc79a7", "#000000"] },
   { id: "office", label: "Office", description: "The six accent colours of the default Office theme.", palette: ["#4472c4", "#ed7d31", "#a5a5a5", "#ffc000", "#5b9bd5", "#70ad47"] },
   { id: "warm", label: "Warm", description: "Reds, oranges and yellows.", palette: ["#b2182b", "#d6604d", "#f4a582", "#e08214", "#fdb863", "#8c510a"] },
@@ -632,6 +677,10 @@ function chartPresetPatch(options) {
 }
 
 // src/chart/controller.ts
+function pointLists(s) {
+  const lists = [s.values, s.x, s.sizes, s.pointColors, s.callouts, _optionalChain([s, 'access', _27 => _27.errorBars, 'optionalAccess', _28 => _28.plus]), _optionalChain([s, 'access', _29 => _29.errorBars, 'optionalAccess', _30 => _30.minus]), _optionalChain([s, 'access', _31 => _31.xErrorBars, 'optionalAccess', _32 => _32.plus]), _optionalChain([s, 'access', _33 => _33.xErrorBars, 'optionalAccess', _34 => _34.minus])];
+  return lists.filter((l) => Array.isArray(l));
+}
 function sameChartJson(a, b) {
   if (a === b) return true;
   if (typeof a !== "object" || typeof b !== "object" || a === null || b === null) return Number.isNaN(a) && Number.isNaN(b);
@@ -664,14 +713,14 @@ var ChartController = (_class = class {
   constructor(options = {}) {;_class.prototype.__init.call(this);_class.prototype.__init2.call(this);_class.prototype.__init3.call(this);_class.prototype.__init4.call(this);_class.prototype.__init5.call(this);_class.prototype.__init6.call(this);_class.prototype.__init7.call(this);_class.prototype.__init8.call(this);_class.prototype.__init9.call(this);_class.prototype.__init10.call(this);
     this.history = _nullishCoalesce(options.history, () => ( new (0, _chunkFJ2MSI43cjs.HistoryManager)()));
     this.onChange = options.onChange;
-    const { spec, issues } = _chunkLL3H5XUHcjs.normalizeChartSpec.call(void 0, _nullishCoalesce(options.spec, () => ( {})));
+    const { spec, issues } = _chunkR3P2M7HUcjs.normalizeChartSpec.call(void 0, _nullishCoalesce(options.spec, () => ( {})));
     this.spec = spec;
     this.issues = issues;
     this.state = this.computeState();
     this.connect();
   }
   connect() {
-    _optionalChain([this, 'access', _13 => _13.unsubscribeHistory, 'optionalCall', _14 => _14()]);
+    _optionalChain([this, 'access', _35 => _35.unsubscribeHistory, 'optionalCall', _36 => _36()]);
     this.unsubscribeHistory = this.history.subscribe((h) => {
       const s = this.state;
       if (this.applying || s.canUndo === h.canUndo && s.canRedo === h.canRedo && s.undoLabel === h.undoName && s.redoLabel === h.redoName) return;
@@ -701,12 +750,12 @@ var ChartController = (_class = class {
   computeState() {
     const h = this.history.getState();
     const sel = this.selection;
-    const seriesId = _optionalChain([sel, 'optionalAccess', _15 => _15.kind]) === "series" || _optionalChain([sel, 'optionalAccess', _16 => _16.kind]) === "point" || _optionalChain([sel, 'optionalAccess', _17 => _17.kind]) === "trendline" ? sel.seriesId : null;
+    const seriesId = _optionalChain([sel, 'optionalAccess', _37 => _37.kind]) === "series" || _optionalChain([sel, 'optionalAccess', _38 => _38.kind]) === "point" || _optionalChain([sel, 'optionalAccess', _39 => _39.kind]) === "trendline" ? sel.seriesId : null;
     return {
       spec: this.spec,
       selection: sel,
       selectedSeries: seriesId ? _nullishCoalesce(this.spec.series.find((s) => s.id === seriesId), () => ( null)) : null,
-      selectedIndex: _optionalChain([sel, 'optionalAccess', _18 => _18.kind]) === "point" || _optionalChain([sel, 'optionalAccess', _19 => _19.kind]) === "category" ? sel.index : null,
+      selectedIndex: _optionalChain([sel, 'optionalAccess', _40 => _40.kind]) === "point" || _optionalChain([sel, 'optionalAccess', _41 => _41.kind]) === "category" ? sel.index : null,
       issues: this.issues,
       gesture: this.gestureKey,
       canUndo: h.canUndo,
@@ -719,7 +768,7 @@ var ChartController = (_class = class {
   notify(specChanged) {
     this.revision++;
     this.state = this.computeState();
-    if (specChanged) _optionalChain([this, 'access', _20 => _20.onChange, 'optionalCall', _21 => _21(this.spec)]);
+    if (specChanged) _optionalChain([this, 'access', _42 => _42.onChange, 'optionalCall', _43 => _43(this.spec)]);
     const state = this.state;
     this.listeners.forEach((listener) => {
       try {
@@ -743,7 +792,7 @@ var ChartController = (_class = class {
       case "category":
         return sel.index < spec.categories.length ? sel : null;
       case "trendline":
-        return _optionalChain([spec, 'access', _22 => _22.series, 'access', _23 => _23.find, 'call', _24 => _24((s) => s.id === sel.seriesId), 'optionalAccess', _25 => _25.trendlines, 'optionalAccess', _26 => _26[sel.index]]) ? sel : null;
+        return _optionalChain([spec, 'access', _44 => _44.series, 'access', _45 => _45.find, 'call', _46 => _46((s) => s.id === sel.seriesId), 'optionalAccess', _47 => _47.trendlines, 'optionalAccess', _48 => _48[sel.index]]) ? sel : null;
       case "title":
         return spec.title ? sel : null;
       case "subtitle":
@@ -767,7 +816,7 @@ var ChartController = (_class = class {
     const hadIssues = this.issues.length > 0;
     this.issues = [];
     if (sameChartJson(before, next)) {
-      const reselect = select !== void 0 && !_chunkHDGBM7EAcjs.sameChartSelection.call(void 0, this.selection, select) && !(select === null && this.selection === null);
+      const reselect = select !== void 0 && !_chunkSBQVEBSUcjs.sameChartSelection.call(void 0, this.selection, select) && !(select === null && this.selection === null);
       if (reselect) this.selection = select;
       if (reselect || hadIssues) this.notify(false);
       return;
@@ -790,7 +839,7 @@ var ChartController = (_class = class {
   }
   /** A copy of the spec with `edit` applied (series and categories copied as needed). */
   edited(edit) {
-    const draft = _chunkLL3H5XUHcjs.cloneChartSpec.call(void 0, this.spec);
+    const draft = _chunkR3P2M7HUcjs.cloneChartSpec.call(void 0, this.spec);
     edit(draft);
     return draft;
   }
@@ -820,7 +869,7 @@ var ChartController = (_class = class {
       legend: patch.legend ? { ...s.legend, ...patch.legend } : s.legend,
       version: 1
     };
-    const { spec, issues } = _chunkLL3H5XUHcjs.normalizeChartSpec.call(void 0, merged);
+    const { spec, issues } = _chunkR3P2M7HUcjs.normalizeChartSpec.call(void 0, merged);
     if (issues.length) return this.reject(issues.map((i) => i.message).join(" "), issues);
     if (JSON.stringify(spec) === JSON.stringify(s)) return { ok: true };
     this.commit(_nullishCoalesce(options.label, () => ( updateLabel(patch))), spec);
@@ -861,17 +910,20 @@ var ChartController = (_class = class {
    * to the categories; all-or-nothing like `update`.
    */
   setData(data, options = {}) {
-    return this.update({ ...data.categories ? { categories: data.categories } : {}, ...data.series ? { series: data.series } : {} }, { label: _nullishCoalesce(options.label, () => ( "Edit chart data")) });
+    const clear = (data.categories || data.series) && this.spec.tree.length ? { tree: [] } : {};
+    return this.update({ ...data.categories ? { categories: data.categories } : {}, ...data.series ? { series: data.series } : {}, ...clear }, { label: _nullishCoalesce(options.label, () => ( "Edit chart data")) });
   }
   /**
    * Sets one value (numbers, numeric text such as `1,200` or `12%`, or blank for a gap).
    * One undo step, or part of the current gesture.
    */
   setValue(seriesId, index, value, options = {}) {
+    const grouped = this.treeLocked();
+    if (grouped) return grouped;
     const series = this.getSeries(seriesId);
     if (!series) return this.unknownSeries(seriesId);
     if (!Number.isInteger(index) || index < 0 || index >= this.spec.categories.length) return this.badIndex(index);
-    const parsed = _chunkLL3H5XUHcjs.parseChartValue.call(void 0, value);
+    const parsed = _chunkR3P2M7HUcjs.parseChartValue.call(void 0, value);
     if (parsed === void 0) return this.reject(`"${String(value)}" is not a number; enter a number or leave the cell blank.`, [{ path: `${seriesId}[${index}]`, message: `"${String(value)}" is not a number.` }]);
     if (series.values[index] === parsed) {
       if (this.issues.length) {
@@ -888,13 +940,15 @@ var ChartController = (_class = class {
   }
   /** Several values as one undo step (all-or-nothing). */
   setValues(cells, options = {}) {
+    const grouped = this.treeLocked();
+    if (grouped) return grouped;
     const issues = [];
     const parsed = [];
     for (const cell of cells) {
       if (!this.getSeries(cell.seriesId)) issues.push({ path: cell.seriesId, message: this.unknownSeries(cell.seriesId).message });
       else if (!Number.isInteger(cell.index) || cell.index < 0 || cell.index >= this.spec.categories.length) issues.push({ path: `${cell.seriesId}[${cell.index}]`, message: this.badIndex(cell.index).message });
       else {
-        const value = _chunkLL3H5XUHcjs.parseChartValue.call(void 0, cell.value);
+        const value = _chunkR3P2M7HUcjs.parseChartValue.call(void 0, cell.value);
         if (value === void 0) issues.push({ path: `${cell.seriesId}[${cell.index}]`, message: `"${String(cell.value)}" is not a number.` });
         else parsed.push({ seriesId: cell.seriesId, index: cell.index, value });
       }
@@ -908,12 +962,12 @@ var ChartController = (_class = class {
   }
   /** Adds a series (values padded to the categories) and selects it. Returns its id. */
   addSeries(input = {}, options = {}) {
-    const id = input.id && !this.getSeries(input.id) ? input.id : _chunkLL3H5XUHcjs.uniqueChartSeriesId.call(void 0, this.spec.series);
+    const id = input.id && !this.getSeries(input.id) ? input.id : _chunkR3P2M7HUcjs.uniqueChartSeriesId.call(void 0, this.spec.series);
     const name = _nullishCoalesce(input.name, () => ( `Series ${this.spec.series.length + 1}`));
     const at = Math.max(0, Math.min(this.spec.series.length, _nullishCoalesce(options.at, () => ( this.spec.series.length))));
     const series = [...this.spec.series];
     series.splice(at, 0, { ...input, id, name, values: _nullishCoalesce(input.values, () => ( [])) });
-    const { spec, issues } = _chunkLL3H5XUHcjs.normalizeChartSpec.call(void 0, { ...this.spec, series });
+    const { spec, issues } = _chunkR3P2M7HUcjs.normalizeChartSpec.call(void 0, { ...this.spec, series });
     if (issues.length) return this.reject(issues.map((i) => i.message).join(" "), issues);
     this.commit(`Add series "${name}"`, spec, { kind: "series", seriesId: id });
     return { ok: true, id };
@@ -925,6 +979,7 @@ var ChartController = (_class = class {
       `Delete series "${series.name}"`,
       this.edited((d) => {
         d.series = d.series.filter((s) => s.id !== id);
+        d.highlight = d.highlight.filter((h) => h !== id && (h !== series.name || d.series.some((s) => s.name === h) || d.categories.includes(h)));
       })
     );
     return { ok: true };
@@ -932,7 +987,7 @@ var ChartController = (_class = class {
   updateSeries(id, patch) {
     const series = this.getSeries(id);
     if (!series) return this.unknownSeries(id);
-    const next = _chunkLL3H5XUHcjs.cloneChartSeries.call(void 0, series);
+    const next = _chunkR3P2M7HUcjs.cloneChartSeries.call(void 0, series);
     if (patch.name !== void 0) next.name = String(patch.name);
     if (patch.color === null || patch.color === "") delete next.color;
     else if (patch.color !== void 0) next.color = patch.color;
@@ -942,7 +997,7 @@ var ChartController = (_class = class {
       if (patch.hidden) next.hidden = true;
       else delete next.hidden;
     }
-    const resettable = ["axis", "x", "sizes", "pointColors", "marker", "curve", "dataLabels", "format", "errorBars", "xErrorBars"];
+    const resettable = ["axis", "x", "sizes", "pointColors", "callouts", "marker", "curve", "dataLabels", "format", "errorBars", "xErrorBars"];
     for (const key of resettable) {
       if (!(key in patch) || patch[key] === void 0) continue;
       if (patch[key] === null) delete next[key];
@@ -950,7 +1005,9 @@ var ChartController = (_class = class {
     }
     if (next.axis === "primary") delete next.axis;
     const series2 = this.spec.series.map((s) => s.id === id ? next : s);
-    const { spec, issues } = _chunkLL3H5XUHcjs.normalizeChartSpec.call(void 0, { ...this.spec, series: series2 });
+    const renamed = next.name !== series.name && this.spec.highlight.includes(series.name) && !this.spec.categories.includes(series.name);
+    const highlight = renamed ? this.spec.highlight.map((h) => h === series.name ? next.name : h) : this.spec.highlight;
+    const { spec, issues } = _chunkR3P2M7HUcjs.normalizeChartSpec.call(void 0, { ...this.spec, series: series2, highlight });
     if (issues.length) return this.reject(issues.map((i) => i.message).join(" "), issues);
     if (JSON.stringify(spec.series) === JSON.stringify(this.spec.series)) return { ok: true };
     const label = patch.hidden !== void 0 && Object.keys(patch).length === 1 ? `${patch.hidden ? "Hide" : "Show"} "${series.name}"` : patch.name !== void 0 && Object.keys(patch).length === 1 ? "Rename series" : `Change series "${series.name}"`;
@@ -979,41 +1036,52 @@ var ChartController = (_class = class {
   }
   /** Inserts a category (with gaps in every series) at `at` (default: the end). Returns its index. */
   addCategory(label, options = {}) {
+    const grouped = this.treeLocked();
+    if (grouped) return grouped;
     const at = Math.max(0, Math.min(this.spec.categories.length, _nullishCoalesce(options.at, () => ( this.spec.categories.length))));
     const name = _nullishCoalesce(label, () => ( `${this.spec.categories.length + 1}`));
     this.commit(
       `Add category "${name}"`,
       this.edited((d) => {
         d.categories.splice(at, 0, name);
-        for (const s of d.series) s.values.splice(at, 0, null);
+        for (const s of d.series) for (const list of pointLists(s)) list.splice(at, 0, null);
       }),
       { kind: "category", index: at }
     );
     return { ok: true, index: at };
   }
   removeCategory(index) {
+    const grouped = this.treeLocked();
+    if (grouped) return grouped;
     if (!Number.isInteger(index) || index < 0 || index >= this.spec.categories.length) return this.badIndex(index);
     this.commit(
       `Delete category "${this.spec.categories[index]}"`,
       this.edited((d) => {
-        d.categories.splice(index, 1);
-        for (const s of d.series) s.values.splice(index, 1);
+        const [label] = d.categories.splice(index, 1);
+        for (const s of d.series) for (const list of pointLists(s)) list.splice(index, 1);
+        if (!d.categories.includes(label)) d.highlight = d.highlight.filter((h) => h !== label);
       })
     );
     return { ok: true };
   }
   renameCategory(index, label) {
+    const grouped = this.treeLocked();
+    if (grouped) return grouped;
     if (!Number.isInteger(index) || index < 0 || index >= this.spec.categories.length) return this.badIndex(index);
     if (this.spec.categories[index] === label) return { ok: true };
     this.commit(
       "Rename category",
       this.edited((d) => {
+        const before = d.categories[index];
         d.categories[index] = String(label);
+        if (d.highlight.includes(before) && !d.categories.includes(before)) d.highlight = d.highlight.map((h) => h === before ? String(label) : h);
       })
     );
     return { ok: true };
   }
   moveCategory(from, to) {
+    const grouped = this.treeLocked();
+    if (grouped) return grouped;
     if (!Number.isInteger(from) || from < 0 || from >= this.spec.categories.length) return this.badIndex(from);
     const target = Math.max(0, Math.min(this.spec.categories.length - 1, to));
     if (target === from) return { ok: true };
@@ -1025,7 +1093,7 @@ var ChartController = (_class = class {
       "Reorder categories",
       this.edited((d) => {
         move(d.categories);
-        for (const s of d.series) move(s.values);
+        for (const s of d.series) for (const list of pointLists(s)) move(list);
       })
     );
     return { ok: true };
@@ -1036,6 +1104,8 @@ var ChartController = (_class = class {
    * grid grows to fit. Non-numeric value cells become gaps and are reported in `issues`.
    */
   pasteCells(row, column, cells) {
+    const grouped = this.treeLocked();
+    if (grouped) return grouped;
     const rows = typeof cells === "string" ? cells.includes("	") ? _chunkN3KJFGXTcjs.parseTsv.call(void 0, cells) : _chunkN3KJFGXTcjs.parseCsv.call(void 0, cells) : cells.map((r) => [...r]);
     if (!rows.length) return { ok: true };
     const issues = [];
@@ -1043,7 +1113,7 @@ var ChartController = (_class = class {
       const width = Math.max(...rows.map((r) => r.length));
       const lastSeries = column + width - 1;
       while (d.series.length <= lastSeries) {
-        const id = _chunkLL3H5XUHcjs.uniqueChartSeriesId.call(void 0, d.series);
+        const id = _chunkR3P2M7HUcjs.uniqueChartSeriesId.call(void 0, d.series);
         d.series.push({ id, name: `Series ${d.series.length + 1}`, values: d.categories.map(() => null) });
       }
       const lastRow = row + rows.length - 1;
@@ -1057,7 +1127,7 @@ var ChartController = (_class = class {
           const index = row + r;
           if (col < 0) d.categories[index] = cell === null || cell === void 0 ? "" : String(cell).trim();
           else {
-            const parsed = _chunkLL3H5XUHcjs.parseChartValue.call(void 0, cell);
+            const parsed = _chunkR3P2M7HUcjs.parseChartValue.call(void 0, cell);
             if (parsed === void 0) issues.push({ path: `${d.series[col].id}[${index}]`, message: `"${String(cell)}" is not a number; it was left blank.` });
             d.series[col].values[index] = _nullishCoalesce(parsed, () => ( null));
           }
@@ -1076,14 +1146,14 @@ var ChartController = (_class = class {
    * colours and types are kept by name.
    */
   importTable(rows, options = {}) {
-    const data = _chunkLL3H5XUHcjs.chartDataFromTable.call(void 0, rows, options);
+    const data = _chunkR3P2M7HUcjs.chartDataFromTable.call(void 0, rows, options);
     if (!data.categories.length || !data.series.length) return this.reject("There is no data to import: expected a header row and at least one row of values.");
     const byName = new Map(this.spec.series.map((s) => [s.name, s]));
     const series = data.series.map((s) => {
       const old = byName.get(s.name);
-      return { ...s, ..._optionalChain([old, 'optionalAccess', _27 => _27.color]) ? { color: old.color } : {}, ..._optionalChain([old, 'optionalAccess', _28 => _28.type]) ? { type: old.type } : {}, ...old ? { id: old.id } : {} };
+      return { ...s, ..._optionalChain([old, 'optionalAccess', _49 => _49.color]) ? { color: old.color } : {}, ..._optionalChain([old, 'optionalAccess', _50 => _50.type]) ? { type: old.type } : {}, ...old ? { id: old.id } : {} };
     });
-    const { spec } = _chunkLL3H5XUHcjs.normalizeChartSpec.call(void 0, { ...this.spec, categories: data.categories, series });
+    const { spec } = _chunkR3P2M7HUcjs.normalizeChartSpec.call(void 0, { ...this.spec, categories: data.categories, series, tree: [] });
     this.commit("Import data", spec);
     if (data.issues.length) {
       this.issues = data.issues;
@@ -1098,18 +1168,264 @@ var ChartController = (_class = class {
     return this.importTable(_chunkN3KJFGXTcjs.parseCsv.call(void 0, text, { delimiter }), options);
   }
   // -------------------------------------------------------------------------
+  // Grouped data (tree)
+  // -------------------------------------------------------------------------
+  /** A refusal while the data is a tree (cell edits would be overwritten by its totals), else null. */
+  treeLocked() {
+    if (!this.spec.tree.length) return null;
+    return this.reject(
+      "This chart's data is grouped (a tree): its categories and values are the top-level groups and their totals. Change it with setTree / the tree node edits (set_chart_tree, add_chart_tree_node, update_chart_tree_node, remove_chart_tree_node), or replace it with new data."
+    );
+  }
+  /** Replaces the grouped data (an empty list goes back to the table, keeping the totals as values). One undo step. */
+  setTree(tree, options = {}) {
+    const issues = [];
+    const next = _chunkR3P2M7HUcjs.normalizeChartTree.call(void 0, tree, issues);
+    if (issues.length) return this.reject(issues.map((i) => i.message).join(" "), issues);
+    return this.update({ tree: next }, { label: _nullishCoalesce(options.label, () => ( (next.length ? "Replace grouped data" : "Ungroup data"))) });
+  }
+  /**
+   * Replaces the grouped data from rows of names and a value (group, …, item, value), as the
+   * data grid edits it; colours of nodes whose path is unchanged are kept. All-or-nothing.
+   */
+  setTreeRows(rows, options = {}) {
+    const issues = [];
+    const next = _chunkR3P2M7HUcjs.chartTreeFromRows.call(void 0, rows, issues);
+    if (issues.length) return this.reject(issues.map((i) => i.message).join(" "), issues);
+    const keepColors = (list, prefix) => {
+      for (const n of list) {
+        const old = _chunkR3P2M7HUcjs.findChartTreeNode.call(void 0, this.spec.tree, [...prefix, n.name]);
+        if (_optionalChain([old, 'optionalAccess', _51 => _51.color])) n.color = old.color;
+        if (n.children) keepColors(n.children, [...prefix, n.name]);
+      }
+    };
+    keepColors(next, []);
+    return this.update({ tree: next }, { label: _nullishCoalesce(options.label, () => ( "Edit grouped data")) });
+  }
+  /** Replaces the data with a table of names and values (group, …, item, value); see `chartTreeFromTable`. */
+  importTreeTable(rows, options = {}) {
+    const issues = [];
+    const next = _chunkR3P2M7HUcjs.chartTreeFromTable.call(void 0, rows, options, issues);
+    if (issues.length) return this.reject(issues.map((i) => i.message).join(" "), issues);
+    if (!next.length) return this.reject('There is no grouped data to import: expected rows of names followed by a value, e.g. "Europe,France,40".');
+    return this.update({ tree: next }, { label: "Import grouped data" });
+  }
+  nodeAt(path) {
+    const node = _chunkR3P2M7HUcjs.findChartTreeNode.call(void 0, this.spec.tree, path);
+    if (node) return node;
+    const known = path.length > 1 ? _chunkR3P2M7HUcjs.findChartTreeNode.call(void 0, this.spec.tree, path.slice(0, -1)) : null;
+    const siblings = _nullishCoalesce((path.length > 1 ? _optionalChain([known, 'optionalAccess', _52 => _52.children]) : this.spec.tree), () => ( []));
+    return fail(
+      `There is no node ${JSON.stringify(path)}. ${siblings.length ? `${path.length > 1 && known ? `"${known.name}" contains` : "The top level has"} ${siblings.map((n) => `"${n.name}"`).slice(0, 20).join(", ")}.` : "The chart has no grouped data yet; add nodes with add_chart_tree_node or set_chart_tree."}`
+    );
+  }
+  /** Adds a node under the group at `parent` ([] for the top level) at `at` (default: the end). Returns its path. */
+  addTreeNode(parent, input, options = {}) {
+    let siblings = this.spec.tree;
+    if (parent.length) {
+      const group = this.nodeAt(parent);
+      if ("ok" in group) return group;
+      if (!group.children) return this.reject(`"${group.name}" is an item with its own value, not a group; add the node next to it, or turn it into a group by replacing the tree with set_chart_tree.`);
+      siblings = group.children;
+    }
+    const issues = [];
+    const [node] = _chunkR3P2M7HUcjs.normalizeChartTree.call(void 0, [input], issues, "node");
+    if (!node || issues.length) return this.reject(issues.map((i) => i.message).join(" ") || "The node is not valid.", issues);
+    if (siblings.some((n) => n.name === node.name)) return this.reject(`"${node.name}" is already there; names under one group must be unique.`);
+    const at = Math.max(0, Math.min(siblings.length, _nullishCoalesce(options.at, () => ( siblings.length))));
+    const tree = _chunkR3P2M7HUcjs.cloneChartTree.call(void 0, this.spec.tree);
+    const list = parent.length ? _chunkR3P2M7HUcjs.findChartTreeNode.call(void 0, tree, parent).children : tree;
+    list.splice(at, 0, node);
+    const result = this.update({ tree }, { label: `Add "${node.name}"` });
+    if (!result.ok) return result;
+    return { ok: true, path: [...parent, node.name] };
+  }
+  /** Renames, revalues (items only) or recolours a node; `color: null` goes back to the palette. Returns its path. */
+  updateTreeNode(path, patch) {
+    const node = this.nodeAt(path);
+    if ("ok" in node) return node;
+    if (patch.value !== void 0 && node.children) return this.reject(`"${node.name}" is a group: its value is the sum of its items. Change the items instead.`);
+    const name = patch.name !== void 0 ? String(patch.name).trim() : node.name;
+    const siblings = (path.length > 1 ? _chunkR3P2M7HUcjs.findChartTreeNode.call(void 0, this.spec.tree, path.slice(0, -1)).children : this.spec.tree).filter((n) => n !== node);
+    if (siblings.some((n) => n.name === name)) return this.reject(`There is already a "${name}" next to "${node.name}"; names under one group must be unique.`);
+    const tree = _chunkR3P2M7HUcjs.cloneChartTree.call(void 0, this.spec.tree);
+    const target = _chunkR3P2M7HUcjs.findChartTreeNode.call(void 0, tree, path);
+    const merged = { ...target, name };
+    if (patch.value !== void 0) merged.value = patch.value;
+    if (patch.color === null) delete merged.color;
+    else if (patch.color !== void 0) merged.color = patch.color;
+    const issues = [];
+    const [checked] = _chunkR3P2M7HUcjs.normalizeChartTree.call(void 0, [merged], issues, "node");
+    if (!checked || issues.length) return this.reject(issues.map((i) => i.message).join(" "), issues);
+    Object.assign(target, checked);
+    if (patch.color === null) delete target.color;
+    const result = this.update({ tree }, { label: patch.name !== void 0 && patch.name !== node.name ? "Rename group" : `Change "${node.name}"` });
+    if (!result.ok) return result;
+    return { ok: true, path: [...path.slice(0, -1), name] };
+  }
+  /** Removes a node (with everything under it). A group left empty becomes an item with value 0. */
+  removeTreeNode(path) {
+    const node = this.nodeAt(path);
+    if ("ok" in node) return node;
+    const tree = _chunkR3P2M7HUcjs.cloneChartTree.call(void 0, this.spec.tree);
+    const parent = path.length > 1 ? _chunkR3P2M7HUcjs.findChartTreeNode.call(void 0, tree, path.slice(0, -1)) : null;
+    const list = parent ? parent.children : tree;
+    list.splice(
+      list.findIndex((n) => n.name === node.name),
+      1
+    );
+    if (parent && !parent.children.length) {
+      delete parent.children;
+      parent.value = 0;
+    }
+    return this.update({ tree }, { label: `Delete "${node.name}"` });
+  }
+  // -------------------------------------------------------------------------
+  // Annotations
+  // -------------------------------------------------------------------------
+  /** Sets the note written under the chart ("" removes it). */
+  setNote(note) {
+    return this.update({ note }, { label: note ? "Edit note" : "Remove note" });
+  }
+  /**
+   * Draws the named categories (labels) and series (names or ids) normally and mutes the
+   * rest; an empty list shows everything. Unknown names change nothing. Returns the category
+   * indexes and series ids that matched.
+   */
+  setHighlight(names) {
+    const s = this.spec;
+    const list = [...new Set(names.map(String))];
+    const unknown = list.filter((n) => !s.categories.includes(n) && !s.series.some((x) => x.id === n || x.name === n));
+    if (unknown.length)
+      return this.reject(
+        `${unknown.map((u) => `"${u}"`).join(", ")} ${unknown.length === 1 ? "is" : "are"} neither a category nor a series. Categories: ${s.categories.slice(0, 20).map((c) => `"${c}"`).join(", ") || "(none)"}; series: ${s.series.map((x) => `"${x.name}"`).join(", ") || "(none)"}.`
+      );
+    const result = this.update({ highlight: list }, { label: list.length ? "Highlight" : "Clear highlight" });
+    if (!result.ok) return result;
+    return {
+      ok: true,
+      categories: s.categories.flatMap((c, i) => list.includes(c) ? [i] : []),
+      series: s.series.filter((x) => list.includes(x.id) || list.includes(x.name)).map((x) => x.id)
+    };
+  }
+  /** Why a reference on `axis` at `values` cannot be drawn on this chart, or null. */
+  referenceProblem(axis, values) {
+    const s = this.spec;
+    const family = _chunkR3P2M7HUcjs.chartFamily.call(void 0, s);
+    if (family !== "cartesian" && family !== "xy") return `Reference lines and bands are drawn on bar, line, area, scatter and bubble charts; this is a ${s.type} chart.`;
+    if (axis === "x" && family !== "xy") return 'axis "x" needs a scatter or bubble chart with numeric x values; use "y" for the value axis.';
+    if (axis === "y2" && (family !== "cartesian" || !s.series.some((x) => !x.hidden && x.axis === "secondary")))
+      return 'axis "y2" needs a visible series on the secondary axis (set one with update_chart_series axis "secondary"), or use "y".';
+    const scale = (axis === "x" ? s.xAxis : axis === "y2" ? s.yAxis2 : s.yAxis).scale;
+    if (scale === "log" && values.some((v) => !(v > 0))) return "That axis is logarithmic, so the values must be above 0.";
+    return null;
+  }
+  editReferences(kind, label, edit, select) {
+    this.commit(
+      label,
+      this.edited((d) => edit(d[kind])),
+      select
+    );
+  }
+  /** Adds a reference line (a target, floor or average). Returns its index. */
+  addReferenceLine(input) {
+    const issues = [];
+    const line = _chunkR3P2M7HUcjs.normalizeChartReferenceLine.call(void 0, input, "referenceLine", issues);
+    if (!line || issues.length) return this.reject(issues.map((i) => i.message).join(" "), issues);
+    const problem = this.referenceProblem(line.axis, [line.value]);
+    if (problem) return this.reject(problem);
+    const index = this.spec.referenceLines.length;
+    this.editReferences("referenceLines", `Add reference line${line.label ? ` "${line.label}"` : ""}`, (list) => list.push(line));
+    return { ok: true, index };
+  }
+  /** Changes a reference line (all-or-nothing); `null` removes its label, colour or axis. */
+  updateReferenceLine(index, patch) {
+    const current = this.spec.referenceLines[index];
+    if (!current) return fail(this.noReference("reference line", this.spec.referenceLines.length, index));
+    const merged = { ...current, ...patch };
+    for (const [k, v] of Object.entries(patch)) if (v === null) delete merged[k];
+    const issues = [];
+    const line = _chunkR3P2M7HUcjs.normalizeChartReferenceLine.call(void 0, merged, "referenceLine", issues);
+    if (!line || issues.length) return this.reject(issues.map((i) => i.message).join(" "), issues);
+    const problem = this.referenceProblem(line.axis, [line.value]);
+    if (problem) return this.reject(problem);
+    this.editReferences("referenceLines", "Change reference line", (list) => list[index] = line);
+    return { ok: true };
+  }
+  removeReferenceLine(index) {
+    if (!this.spec.referenceLines[index]) return fail(this.noReference("reference line", this.spec.referenceLines.length, index));
+    this.editReferences("referenceLines", "Delete reference line", (list) => list.splice(index, 1));
+    return { ok: true };
+  }
+  /** Adds a reference band (a target range). Returns its index. */
+  addReferenceBand(input) {
+    const issues = [];
+    const band = _chunkR3P2M7HUcjs.normalizeChartReferenceBand.call(void 0, input, "referenceBand", issues);
+    if (!band || issues.length) return this.reject(issues.map((i) => i.message).join(" "), issues);
+    const problem = this.referenceProblem(band.axis, [band.from, band.to]);
+    if (problem) return this.reject(problem);
+    const index = this.spec.referenceBands.length;
+    this.editReferences("referenceBands", `Add reference band${band.label ? ` "${band.label}"` : ""}`, (list) => list.push(band));
+    return { ok: true, index };
+  }
+  /** Changes a reference band (all-or-nothing); `null` removes its label, colour or axis. */
+  updateReferenceBand(index, patch) {
+    const current = this.spec.referenceBands[index];
+    if (!current) return fail(this.noReference("reference band", this.spec.referenceBands.length, index));
+    const merged = { ...current, ...patch };
+    for (const [k, v] of Object.entries(patch)) if (v === null) delete merged[k];
+    const issues = [];
+    const band = _chunkR3P2M7HUcjs.normalizeChartReferenceBand.call(void 0, merged, "referenceBand", issues);
+    if (!band || issues.length) return this.reject(issues.map((i) => i.message).join(" "), issues);
+    const problem = this.referenceProblem(band.axis, [band.from, band.to]);
+    if (problem) return this.reject(problem);
+    this.editReferences("referenceBands", "Change reference band", (list) => list[index] = band);
+    return { ok: true };
+  }
+  removeReferenceBand(index) {
+    if (!this.spec.referenceBands[index]) return fail(this.noReference("reference band", this.spec.referenceBands.length, index));
+    this.editReferences("referenceBands", "Delete reference band", (list) => list.splice(index, 1));
+    return { ok: true };
+  }
+  noReference(what, count, index) {
+    return `There is no ${what} ${index}; ${count ? `expected 0 to ${count - 1}` : `the chart has none yet`}.`;
+  }
+  /**
+   * Pins a label to one bar or point (`null` or "" removes it) and selects the point. The
+   * point must have a value, on a bar, line, area, scatter or bubble chart.
+   */
+  setCallout(seriesId, index, label) {
+    const series = this.getSeries(seriesId);
+    if (!series) return this.unknownSeries(seriesId);
+    if (!Number.isInteger(index) || index < 0 || index >= this.spec.categories.length) return this.badIndex(index);
+    const family = _chunkR3P2M7HUcjs.chartFamily.call(void 0, this.spec);
+    const text = label === null ? "" : String(label).trim();
+    if (text && family !== "cartesian" && family !== "xy") return this.reject(`Callouts are drawn on bar, line, area, scatter and bubble charts; this is a ${this.spec.type} chart.`);
+    if (text && (series.values[index] === null || series.values[index] === void 0))
+      return this.reject(`"${series.name}" has no value at "${this.spec.categories[index]}", so there is nothing to point at; set a value first.`);
+    const next = this.edited((d) => {
+      const s = d.series.find((x) => x.id === seriesId);
+      const labels = s.callouts ? [...s.callouts] : d.categories.map(() => null);
+      labels[index] = text || null;
+      if (labels.some((l) => l)) s.callouts = labels;
+      else delete s.callouts;
+    });
+    this.commit(text ? "Add callout" : "Remove callout", next, { kind: "point", seriesId, index });
+    return { ok: true };
+  }
+  // -------------------------------------------------------------------------
   // Trendlines
   // -------------------------------------------------------------------------
   /** Adds a trendline to a series and selects it. Returns its index (and the fit, when it can be computed). */
   addTrendline(seriesId, input) {
     const series = this.getSeries(seriesId);
     if (!series) return this.unknownSeries(seriesId);
-    if (!_chunkHDGBM7EAcjs.chartSupportsTrendlines.call(void 0, this.spec.type, this.spec.stacking))
+    if (!_chunkSBQVEBSUcjs.chartSupportsTrendlines.call(void 0, this.spec.type, this.spec.stacking))
       return this.reject(`Trendlines need an unstacked bar, line, area, scatter or bubble chart; this is a ${this.spec.stacking !== "none" ? `${this.spec.stacking} ` : ""}${this.spec.type} chart.`);
     const issues = [];
-    const line = _chunkLL3H5XUHcjs.normalizeChartTrendline.call(void 0, input, "trendline", issues);
+    const line = _chunkR3P2M7HUcjs.normalizeChartTrendline.call(void 0, input, "trendline", issues);
     if (!line || issues.length) return this.reject(issues.map((i) => i.message).join(" ") || "The trendline is not valid.", issues);
-    const index = _nullishCoalesce(_optionalChain([series, 'access', _29 => _29.trendlines, 'optionalAccess', _30 => _30.length]), () => ( 0));
+    const index = _nullishCoalesce(_optionalChain([series, 'access', _53 => _53.trendlines, 'optionalAccess', _54 => _54.length]), () => ( 0));
     const next = this.edited((d) => {
       const s = d.series.find((x) => x.id === seriesId);
       s.trendlines = [..._nullishCoalesce(s.trendlines, () => ( [])), line];
@@ -1121,12 +1437,12 @@ var ChartController = (_class = class {
   updateTrendline(seriesId, index, patch) {
     const series = this.getSeries(seriesId);
     if (!series) return this.unknownSeries(seriesId);
-    const current = _optionalChain([series, 'access', _31 => _31.trendlines, 'optionalAccess', _32 => _32[index]]);
-    if (!current) return fail(`"${series.name}" has no trendline ${index}; ${_optionalChain([series, 'access', _33 => _33.trendlines, 'optionalAccess', _34 => _34.length]) ? `expected 0 to ${series.trendlines.length - 1}` : "it has none yet"}.`);
+    const current = _optionalChain([series, 'access', _55 => _55.trendlines, 'optionalAccess', _56 => _56[index]]);
+    if (!current) return fail(`"${series.name}" has no trendline ${index}; ${_optionalChain([series, 'access', _57 => _57.trendlines, 'optionalAccess', _58 => _58.length]) ? `expected 0 to ${series.trendlines.length - 1}` : "it has none yet"}.`);
     const issues = [];
     const merged = { ...current, ...patch };
     for (const [k, v] of Object.entries(patch)) if (v === null) delete merged[k];
-    const line = _chunkLL3H5XUHcjs.normalizeChartTrendline.call(void 0, merged, "trendline", issues);
+    const line = _chunkR3P2M7HUcjs.normalizeChartTrendline.call(void 0, merged, "trendline", issues);
     if (!line || issues.length) return this.reject(issues.map((i) => i.message).join(" "), issues);
     this.commit(
       "Change trendline",
@@ -1139,7 +1455,7 @@ var ChartController = (_class = class {
   removeTrendline(seriesId, index) {
     const series = this.getSeries(seriesId);
     if (!series) return this.unknownSeries(seriesId);
-    if (!_optionalChain([series, 'access', _35 => _35.trendlines, 'optionalAccess', _36 => _36[index]])) return fail(`"${series.name}" has no trendline ${index}.`);
+    if (!_optionalChain([series, 'access', _59 => _59.trendlines, 'optionalAccess', _60 => _60[index]])) return fail(`"${series.name}" has no trendline ${index}.`);
     this.commit(
       "Delete trendline",
       this.edited((d) => {
@@ -1154,25 +1470,25 @@ var ChartController = (_class = class {
   trendlinePoints(seriesId) {
     const series = this.getSeries(seriesId);
     if (!series) return [];
-    const xy = _chunkLL3H5XUHcjs.chartFamily.call(void 0, this.spec) === "xy";
+    const xy = _chunkR3P2M7HUcjs.chartFamily.call(void 0, this.spec) === "xy";
     const out = [];
     series.values.forEach((v, i) => {
-      const x = xy ? _nullishCoalesce(_optionalChain([series, 'access', _37 => _37.x, 'optionalAccess', _38 => _38[i]]), () => ( (this.spec.type === "bubble" ? i + 1 : null))) : i + 1;
+      const x = xy ? _nullishCoalesce(_optionalChain([series, 'access', _61 => _61.x, 'optionalAccess', _62 => _62[i]]), () => ( (this.spec.type === "bubble" ? i + 1 : null))) : i + 1;
       if (v !== null && x !== null && Number.isFinite(v) && Number.isFinite(x)) out.push([x, v]);
     });
     return out;
   }
   /** The fitted coefficients, R² and equation of a trendline (null for moving averages or unfittable data). */
   trendlineFit(seriesId, index) {
-    const line = _optionalChain([this, 'access', _39 => _39.getSeries, 'call', _40 => _40(seriesId), 'optionalAccess', _41 => _41.trendlines, 'optionalAccess', _42 => _42[index]]);
+    const line = _optionalChain([this, 'access', _63 => _63.getSeries, 'call', _64 => _64(seriesId), 'optionalAccess', _65 => _65.trendlines, 'optionalAccess', _66 => _66[index]]);
     if (!line) return null;
-    return _chunkHDGBM7EAcjs.fitChartTrendline.call(void 0, line, this.trendlinePoints(seriesId));
+    return _chunkSBQVEBSUcjs.fitChartTrendline.call(void 0, line, this.trendlinePoints(seriesId));
   }
   /** The moving-average points of a trendline (empty for other kinds). */
   trendlineMovingAverage(seriesId, index) {
-    const line = _optionalChain([this, 'access', _43 => _43.getSeries, 'call', _44 => _44(seriesId), 'optionalAccess', _45 => _45.trendlines, 'optionalAccess', _46 => _46[index]]);
+    const line = _optionalChain([this, 'access', _67 => _67.getSeries, 'call', _68 => _68(seriesId), 'optionalAccess', _69 => _69.trendlines, 'optionalAccess', _70 => _70[index]]);
     if (!line || line.type !== "moving-average") return [];
-    return _chunkHDGBM7EAcjs.chartMovingAverage.call(void 0, this.trendlinePoints(seriesId), _nullishCoalesce(line.period, () => ( 2)));
+    return _chunkSBQVEBSUcjs.chartMovingAverage.call(void 0, this.trendlinePoints(seriesId), _nullishCoalesce(line.period, () => ( 2)));
   }
   // -------------------------------------------------------------------------
   // Reshaping
@@ -1182,6 +1498,8 @@ var ChartController = (_class = class {
    * undo step). Series colours, types and other per-series settings are dropped.
    */
   transpose() {
+    const grouped = this.treeLocked();
+    if (grouped) return grouped;
     const s = this.spec;
     if (!s.series.length || !s.categories.length) return this.reject("There is no data to switch: the chart needs at least one series and one category.");
     const used = /* @__PURE__ */ new Set();
@@ -1191,7 +1509,7 @@ var ChartController = (_class = class {
       used.add(id);
       return { id, name, values: s.series.map((x) => _nullishCoalesce(x.values[i], () => ( null))) };
     });
-    const { spec } = _chunkLL3H5XUHcjs.normalizeChartSpec.call(void 0, { ...s, categories: s.series.map((x) => x.name), series });
+    const { spec } = _chunkR3P2M7HUcjs.normalizeChartSpec.call(void 0, { ...s, categories: s.series.map((x) => x.name), series });
     this.commit("Switch rows and columns", spec, null);
     return { ok: true };
   }
@@ -1201,7 +1519,7 @@ var ChartController = (_class = class {
   /** Selects a chart element (view state; not an undo step). */
   select(selection) {
     const next = this.validSelection(selection, this.spec);
-    if (_chunkHDGBM7EAcjs.sameChartSelection.call(void 0, next, this.selection) || next === null && this.selection === null) return;
+    if (_chunkSBQVEBSUcjs.sameChartSelection.call(void 0, next, this.selection) || next === null && this.selection === null) return;
     this.selection = next;
     this.notify(false);
   }
@@ -1235,6 +1553,8 @@ var ChartController = (_class = class {
   }
   /** Adds `delta` to a value (a gap counts as 0). */
   nudgeValue(seriesId, index, delta) {
+    const grouped = this.treeLocked();
+    if (grouped) return grouped;
     const series = this.getSeries(seriesId);
     if (!series) return this.unknownSeries(seriesId);
     const current = _nullishCoalesce(series.values[index], () => ( 0));
@@ -1276,14 +1596,14 @@ var ChartController = (_class = class {
   // -------------------------------------------------------------------------
   /** The spec, for saving (a copy). */
   toJSON() {
-    return _chunkLL3H5XUHcjs.cloneChartSpec.call(void 0, this.spec);
+    return _chunkR3P2M7HUcjs.cloneChartSpec.call(void 0, this.spec);
   }
   /**
    * Replaces the chart without an undo step (e.g. when opening a document). Problems are
    * fixed with defaults and reported in `state.issues` (and returned).
    */
   load(input, options = {}) {
-    const { spec, issues } = _chunkLL3H5XUHcjs.normalizeChartSpec.call(void 0, input);
+    const { spec, issues } = _chunkR3P2M7HUcjs.normalizeChartSpec.call(void 0, input);
     this.spec = spec;
     this.issues = issues;
     this.selection = this.validSelection(this.selection, spec);
@@ -1303,7 +1623,7 @@ var ChartController = (_class = class {
    * nothing changes and every problem is returned (and shown in `state.issues`).
    */
   replace(input, options = {}) {
-    const { spec, issues } = _chunkLL3H5XUHcjs.normalizeChartSpec.call(void 0, input);
+    const { spec, issues } = _chunkR3P2M7HUcjs.normalizeChartSpec.call(void 0, input);
     if (issues.length) return this.reject(issues.map((i) => i.message).join(" "), issues);
     this.commit(_nullishCoalesce(options.label, () => ( "Replace chart")), spec, this.validSelection(this.selection, spec));
     return { ok: true };
@@ -1318,7 +1638,7 @@ var ChartController = (_class = class {
   }
   /** Stops listening to the history (reconnected by the next `subscribe`). */
   destroy() {
-    _optionalChain([this, 'access', _47 => _47.unsubscribeHistory, 'optionalCall', _48 => _48()]);
+    _optionalChain([this, 'access', _71 => _71.unsubscribeHistory, 'optionalCall', _72 => _72()]);
     this.unsubscribeHistory = void 0;
     this.listeners.clear();
   }
@@ -1343,6 +1663,18 @@ function updateLabel(patch) {
     overlap: "Change bar overlap",
     bins: "Change histogram bins",
     showTotal: "Toggle waterfall total",
+    note: "Edit note",
+    highlight: "Change highlight",
+    referenceLines: "Change reference lines",
+    referenceBands: "Change reference bands",
+    varyColors: "Toggle colour by category",
+    likertNeutral: "Change neutral answer",
+    likertSort: "Sort questions",
+    parliamentArc: "Change hemicycle sweep",
+    parliamentMajority: "Change majority",
+    parliamentLabel: "Edit seat caption",
+    sunburstLabel: "Edit centre caption",
+    tree: "Replace grouped data",
     radarTicks: "Change radar rings",
     radarGraticule: "Change radar grid",
     legend: "Change legend",
@@ -1365,7 +1697,7 @@ function layoutSparkline(values, options) {
   const h = Number.isFinite(options.height) ? Math.max(1, options.height) : 1;
   const color = _nullishCoalesce(options.color, () => ( "#4269d0"));
   const negative = _nullishCoalesce(options.negativeColor, () => ( "#e5484d"));
-  const theme = { ..._chunkLL3H5XUHcjs.DEFAULT_CHART_THEME, background: "transparent" };
+  const theme = { ..._chunkR3P2M7HUcjs.DEFAULT_CHART_THEME, background: "transparent" };
   const marks = [];
   const scene = { width: w, height: h, plot: { x: 0, y: 0, width: w, height: h }, marks, percent: false, theme, warnings: [] };
   const vals = values.slice(0, MAX_POINTS).map((v) => v !== null && Number.isFinite(v) ? Math.max(-1e300, Math.min(1e300, v)) : null);
@@ -1398,7 +1730,7 @@ function layoutSparkline(values, options) {
     const flush = () => {
       if (run.length >= 2) {
         const pts = run.length > 4e3 ? run.filter((_, i) => i % (Math.floor(run.length / 2e3) + 1) === 0) : run;
-        d += pts.map(([x, y], i) => `${i ? "L" : "M"}${_chunkHDGBM7EAcjs.r2.call(void 0, x)},${_chunkHDGBM7EAcjs.r2.call(void 0, y)}`).join("");
+        d += pts.map(([x, y], i) => `${i ? "L" : "M"}${_chunkSBQVEBSUcjs.r2.call(void 0, x)},${_chunkSBQVEBSUcjs.r2.call(void 0, y)}`).join("");
       }
       run = [];
     };