@pixerate/editor 0.52.0 → 0.54.0

package/dist/chart/index.js

@@ -7,7 +7,7 @@ import {
   TRENDLINE_PROPS,
   VALUE,
   WIDTH
-} from "../chunk-5TWIN7ZJ.js";
+} from "../chunk-47WWV3LI.js";
 import {
   CHART_OOXML_CONTENT_TYPE,
   CHART_OOXML_NS,
@@ -16,7 +16,7 @@ import {
   chartFromOoxml,
   chartToOoxml,
   readZip
-} from "../chunk-UAW5FEMD.js";
+} from "../chunk-3S72F46R.js";
 import {
   CHART_COLOR_SCHEMES,
   CHART_DATE_STEPS,
@@ -35,6 +35,8 @@ import {
   chartMovingAverage,
   chartPresetPatch,
   chartQuantile,
+  chartScaleFromPixel,
+  chartScaleToPixel,
   chartSceneToDomSpec,
   chartSceneToSvg,
   chartSerialToDate,
@@ -62,6 +64,7 @@ import {
   layoutSparkline,
   linearMap,
   monochromeChartPalette,
+  niceLogScale,
   niceScale,
   niceStep,
   parseChartDate,
@@ -72,10 +75,14 @@ import {
   summarizeChart,
   summarizeChartSeries,
   trendNumberText
-} from "../chunk-WBOAXDKD.js";
+} from "../chunk-VODBAO32.js";
 import {
   CHART_AXIS_KINDS,
+  CHART_AXIS_SCALES,
   CHART_CURVES,
+  CHART_ERROR_BAR_DIRECTIONS,
+  CHART_ERROR_BAR_LABELS,
+  CHART_ERROR_BAR_TYPES,
   CHART_LABEL_POSITIONS,
   CHART_LEGEND_POSITIONS,
   CHART_MARKERS,
@@ -96,6 +103,8 @@ import {
   chartContrastRatio,
   chartDataFromTable,
   chartDataToTable,
+  chartErrorAmounts,
+  chartErrorBarsOfType,
   chartFamily,
   chartLuminance,
   chartPointColor,
@@ -111,23 +120,36 @@ import {
   createChartSpec,
   cyclePaletteColor,
   defaultChartAxis,
+  defaultChartErrorBarValue,
+  describeChartErrorBars,
+  formatChartAmountList,
   isCartesianChart,
   isXyChart,
   normalizeChartAxis,
+  normalizeChartErrorBars,
   normalizeChartSpec,
   normalizeChartTrendline,
   normalizeChartValues,
+  parseChartAmountList,
   parseChartColor,
   parseChartValue,
   shadeChartColor,
   simulateChartVision,
   uniqueChartSeriesId
-} from "../chunk-OV7UAKIY.js";
+} from "../chunk-633QC34G.js";
 import "../chunk-EKYHKQPG.js";
 import {
   parseCsv
 } from "../chunk-664LQYFJ.js";
 import "../chunk-QVZZGT4X.js";
+import {
+  PRESENCE_COLORS,
+  PerformanceQueue,
+  PresenceStore,
+  createInstantPresenceClock,
+  realPresenceClock,
+  tweenPresenceCursor
+} from "../chunk-B6DSIEXA.js";
 
 // src/chart/raster.ts
 var CHART_RASTER_MAX_SIZE = 1024;
@@ -413,7 +435,7 @@ function createChartCommands(controller, options = {}) {
       id: `${prefix}update`,
       label: "Change Chart\u2026",
       keywords: ["chart", "title", "axis", "legend", "stack", "style", "format", "type"],
-      description: "Changes chart presentation as one undo step: type, titles, axes (xAxis = categories, yAxis = values, yAxis2 = secondary values), legend, stacking, orientation, curve, points, data labels, palette, donut hole, bar spacing, histogram bins or waterfall total. Invalid values change nothing and return why.",
+      description: 'Changes chart presentation as one undo step: type, titles, axes (xAxis = categories, yAxis = values, yAxis2 = secondary values; reverse, and scale "log" on value axes), legend, stacking, orientation, curve, points, data labels, palette, donut hole, bar spacing, histogram bins or waterfall total. Invalid values change nothing and return why.',
       params: object(CHART_UPDATE_PROPERTIES),
       run: (_ctx, params) => {
         check(controller.update(params));
@@ -467,7 +489,7 @@ function createChartCommands(controller, options = {}) {
       id: `${prefix}updateSeries`,
       label: "Change Series\u2026",
       keywords: ["chart", "series", "rename", "colour", "color", "hide", "axis", "marker"],
-      description: "Renames, recolours, hides, moves to the secondary axis or changes how a series is drawn (null resets a field).",
+      description: "Renames, recolours, hides, moves to the secondary axis or changes how a series is drawn, including error bars (null resets a field).",
       params: object({ series: SERIES_REF, ...Object.fromEntries(Object.entries(SERIES_PROPS).filter(([k]) => k !== "values")) }, ["series"]),
       run: (_ctx, params) => {
         const { series, ...patch } = params;
@@ -690,13 +712,14 @@ function snapChartDragValue(scene, value, options = {}) {
   const scale = options.scale ?? scene.valueScale;
   const tolerance = options.tolerancePx ?? 6;
   if (scale) {
-    const px = (v) => linearMap(v, scale.domain, scale.range);
+    const px = (v) => chartScaleToPixel(v, scale);
     const at = px(value);
     let best = null;
     let bestDist = tolerance;
     for (const c of [...options.candidates ?? [], ...scale.ticks]) {
       if (!Number.isFinite(c)) continue;
       const d = Math.abs(px(c) - at);
+      if (!Number.isFinite(d)) continue;
       if (d <= bestDist) {
         best = c;
         bestDist = d;
@@ -704,7 +727,7 @@ function snapChartDragValue(scene, value, options = {}) {
     }
     if (best !== null) return best;
   }
-  return snapChartValue(scene, value, options.step, scale?.ticks);
+  return snapChartValue(scene, value, options.step, scale?.ticks, scale?.logBase);
 }
 function startChartPointDrag(controller, scene, target, start, options = {}) {
   if (!canDragChartPoint(controller, scene, target)) return null;
@@ -738,27 +761,31 @@ function startChartPointDrag(controller, scene, target, start, options = {}) {
       const at = chartValueAtPoint(scene, point, secondary);
       if (at === void 0) return;
       const factor = moveOptions.fine ? 0.1 : 1;
-      let dy = (at - startAt) * factor;
-      let dx = 0;
+      const moved = (from, to, s, value) => s.logBase && value > 0 && from > 0 && to > 0 ? value * Math.pow(to / from, factor) : value + (to - from) * factor;
+      let moveY = true;
+      let moveX = false;
+      let atX;
       if (xy && startX !== null && startAtX !== void 0) {
-        const atX = chartXAtPoint(scene, point);
-        if (atX !== void 0) dx = (atX - startAtX) * factor;
+        atX = chartXAtPoint(scene, point);
+        moveX = atX !== void 0;
         if (moveOptions.lockAxis) {
-          if (Math.abs(point.x - start.x) >= Math.abs(point.y - start.y)) dy = 0;
-          else dx = 0;
+          if (Math.abs(point.x - start.x) >= Math.abs(point.y - start.y)) moveY = false;
+          else moveX = false;
         }
       }
       const snap = (v, s, c) => {
         if (moveOptions.noSnap) return Number(v.toPrecision(12));
         if (moveOptions.fine) {
+          if (s.logBase && !options.step) return v > 0 ? Number(v.toPrecision(3)) : v;
           const unit = options.step ? options.step / 10 : s.ticks.length > 1 ? (s.ticks[1] - s.ticks[0]) / 100 : void 0;
           return snapChartValue(scene, v, unit, s.ticks);
         }
         return snapChartDragValue(scene, v, { candidates: c, tolerancePx: options.tolerancePx, step: options.step, scale: s });
       };
-      const y = snap(startValue + dy, scale, candidates);
+      const y = moveY ? snap(moved(startAt, at, scale, startValue), scale, candidates) : startValue;
       if (xy && startX !== null) {
-        const x = dx !== 0 ? snap(startX + dx, scene.xScale, [0, startX]) : startX;
+        const nextX = moveX ? moved(startAtX, atX, scene.xScale, startX) : startX;
+        const x = nextX !== startX ? snap(nextX, scene.xScale, [0, startX]) : startX;
         const xs = [...series.x ?? []];
         xs[index] = x;
         controller.setValue(seriesId, index, y, { label });
@@ -805,11 +832,21 @@ function handleChartKey(controller, scene, event) {
     case "ArrowUp":
     case "ArrowDown": {
       if (selection?.kind !== "point" || scene?.percent) return false;
-      const secondary = controller.getSeries(selection.seriesId)?.axis === "secondary";
-      const ticks = (secondary ? scene?.valueScale2 : null)?.ticks ?? scene?.valueScale?.ticks ?? [];
+      const series = controller.getSeries(selection.seriesId);
+      const secondary = series?.axis === "secondary";
+      const scale = (secondary ? scene?.valueScale2 : null) ?? scene?.valueScale;
+      const ticks = scale?.ticks ?? [];
+      const up = event.key === "ArrowUp";
+      const current = series?.values[selection.index] ?? null;
+      if (scale?.logBase && current !== null && current > 0) {
+        const power = event.shiftKey ? 1 : event.altKey ? 0.01 : 0.1;
+        const next = Number((current * Math.pow(scale.logBase, up ? power : -power)).toPrecision(event.altKey ? 4 : 3));
+        controller.nudgeValue(selection.seriesId, selection.index, next - current);
+        return true;
+      }
       const step = ticks.length > 1 ? ticks[1] - ticks[0] : 1;
       const amount = event.shiftKey ? step : event.altKey ? step / 100 : step / 10;
-      controller.nudgeValue(selection.seriesId, selection.index, amount * (event.key === "ArrowUp" ? 1 : -1));
+      controller.nudgeValue(selection.seriesId, selection.index, amount * (up ? 1 : -1));
       return true;
     }
     default:
@@ -1056,7 +1093,7 @@ function createChartToolProvider(controller, options = {}) {
   const updateChart = {
     name: "update_chart",
     title: "Change chart presentation",
-    description: "Changes how the chart looks, as one undo step: type, titles, axes (xAxis = categories or numeric x, yAxis = values, yAxis2 = secondary values), legend, stacking, orientation, curve, points, data labels and their position, palette, donut hole, bar spacing, histogram bins, waterfall total. All-or-nothing: invalid values change nothing and come back as sentences. Returns the new spec.",
+    description: 'Changes how the chart looks, as one undo step: type, titles, axes (xAxis = categories or numeric x, yAxis = values, yAxis2 = secondary values; each can be reversed, and value axes can be logarithmic with scale "log"), legend, stacking, orientation, curve, points, data labels and their position, palette, donut hole, bar spacing, histogram bins, waterfall total. All-or-nothing: invalid values change nothing and come back as sentences. Returns the new spec.',
     inputSchema: {
       type: "object",
       properties: CHART_UPDATE_PROPERTIES,
@@ -1144,7 +1181,7 @@ function createChartToolProvider(controller, options = {}) {
   const updateSeries = {
     name: "update_chart_series",
     title: "Change a series",
-    description: "Renames, recolours, hides, moves to the secondary axis or changes how a series is drawn (marker, curve, labels, format, x values, bubble sizes, point colours). null resets a field. Values change with set_chart_values. Returns the series.",
+    description: "Renames, recolours, hides, moves to the secondary axis or changes how a series is drawn (marker, curve, labels, format, x values, bubble sizes, point colours, error bars). null resets a field. Values change with set_chart_values. Returns the series.",
     inputSchema: {
       type: "object",
       properties: { series: SERIES_REF, ...Object.fromEntries(Object.entries(SERIES_PROPS).filter(([k]) => k !== "values")) },
@@ -1600,44 +1637,11 @@ function blendChartScenes(from, to, t) {
 var easeChartTween = (t) => 1 - Math.pow(1 - Math.max(0, Math.min(1, t)), 3);
 
 // src/chart/presence.ts
-var ChartPresence = class {
-  state = { actors: [] };
-  listeners = /* @__PURE__ */ new Set();
-  getState = () => this.state;
-  subscribe = (listener) => {
-    this.listeners.add(listener);
-    return () => {
-      this.listeners.delete(listener);
-    };
-  };
-  /** Adds or changes an actor. */
-  set(actor) {
-    const current = this.state.actors.find((a) => a.id === actor.id);
-    const next = { name: actor.id, color: CHART_PRESENCE_COLORS[this.state.actors.length % CHART_PRESENCE_COLORS.length], x: 0, y: 0, pressed: false, ...current, ...actor };
-    this.state = { actors: current ? this.state.actors.map((a) => a.id === actor.id ? next : a) : [...this.state.actors, next] };
-    this.listeners.forEach((l) => l(this.state));
-  }
-  remove(id) {
-    if (!this.state.actors.some((a) => a.id === id)) return;
-    this.state = { actors: this.state.actors.filter((a) => a.id !== id) };
-    this.listeners.forEach((l) => l(this.state));
-  }
-};
-var CHART_PRESENCE_COLORS = ["#7c3aed", "#db2777", "#0891b2", "#ea580c", "#16a34a"];
-var realChartClock = {
-  now: () => Date.now(),
-  wait: (ms) => new Promise((resolve2) => setTimeout(resolve2, Math.max(0, ms)))
+var ChartPresence = class extends PresenceStore {
 };
-function createInstantChartClock(start = 0) {
-  let t = start;
-  return {
-    now: () => t,
-    wait: async (ms) => {
-      t += Math.max(0, ms);
-    },
-    elapsed: () => t - start
-  };
-}
+var CHART_PRESENCE_COLORS = PRESENCE_COLORS;
+var realChartClock = realPresenceClock;
+var createInstantChartClock = createInstantPresenceClock;
 function chartPointAnchor(scene, seriesId, index) {
   const mark = scene.marks.find((m) => (m.role === "bar" || m.role === "point") && m.target?.kind === "point" && m.target.seriesId === seriesId && m.target.index === index);
   if (!mark) return null;
@@ -1704,35 +1708,25 @@ var ChartDirector = class {
     this.presence = presence;
     this.options = options;
     this.clock = options.clock ?? realChartClock;
+    this.queue = new PerformanceQueue(presence, {
+      clock: this.clock,
+      linger: options.linger,
+      beginGesture: (key) => controller.beginGesture(key),
+      endGesture: () => controller.endGesture()
+    });
   }
   controller;
   presence;
   options;
-  queues = /* @__PURE__ */ new Map();
   clock;
-  calls = 0;
+  queue;
   /** Acts out `commands` in order for `actor`. Resolves with one result per command. */
   perform(actor, commands) {
-    const prev = this.queues.get(actor.id) ?? Promise.resolve();
-    const run = prev.then(async () => {
+    return this.queue.run(actor, async () => {
       const results = [];
-      this.presence.set({ id: actor.id, ...actor.name ? { name: actor.name } : {}, ...actor.color ? { color: actor.color } : {} });
-      this.controller.beginGesture(`agent:${actor.id}:${++this.calls}`);
-      try {
-        for (const command of commands) results.push(await this.performOne(actor.id, command));
-      } finally {
-        this.controller.endGesture();
-        this.presence.set({ id: actor.id, message: void 0, pressed: false });
-      }
-      const linger = this.options.linger ?? 1500;
-      if (linger > 0) {
-        await this.clock.wait(linger);
-        if (this.queues.get(actor.id) === run) this.presence.remove(actor.id);
-      }
+      for (const command of commands) results.push(await this.performOne(actor.id, command));
       return results;
     });
-    this.queues.set(actor.id, run.catch(() => void 0));
-    return run;
   }
   stale(command) {
     const spec = this.controller.getSpec();
@@ -1744,15 +1738,8 @@ var ChartDirector = class {
     }
     return null;
   }
-  async move(id, from, to, ms, each) {
-    const frames = Math.max(1, Math.round(ms / 16));
-    for (let f = 1; f <= frames; f++) {
-      const t = f / frames;
-      const e = 1 - Math.pow(1 - t, 3);
-      this.presence.set({ id, x: from.x + (to.x - from.x) * e, y: from.y + (to.y - from.y) * e });
-      each?.(e);
-      await this.clock.wait(ms / frames);
-    }
+  move(id, from, to, ms, each) {
+    return tweenPresenceCursor(this.presence, this.clock, id, from, to, ms, each);
   }
   async performOne(id, command) {
     const stale = this.stale(command);
@@ -2106,9 +2093,13 @@ function createOfficeChartToolProvider(options = {}) {
 }
 export {
   CHART_AXIS_KINDS,
+  CHART_AXIS_SCALES,
   CHART_COLOR_SCHEMES,
   CHART_CURVES,
   CHART_DATE_STEPS,
+  CHART_ERROR_BAR_DIRECTIONS,
+  CHART_ERROR_BAR_LABELS,
+  CHART_ERROR_BAR_TYPES,
   CHART_LABEL_POSITIONS,
   CHART_LAYOUT_PRESETS,
   CHART_LEGEND_POSITIONS,
@@ -2152,6 +2143,8 @@ export {
   chartDataToTable,
   chartDateLabels,
   chartDateToSerial,
+  chartErrorAmounts,
+  chartErrorBarsOfType,
   chartFamily,
   chartFileName,
   chartFormatToCode,
@@ -2170,6 +2163,8 @@ export {
   chartRasterSize,
   chartRgbToHex,
   chartRgbToOklab,
+  chartScaleFromPixel,
+  chartScaleToPixel,
   chartSceneToDomSpec,
   chartSceneToSvg,
   chartSerialToDate,
@@ -2202,7 +2197,9 @@ export {
   cyclePaletteColor,
   decimateChartPoints,
   defaultChartAxis,
+  defaultChartErrorBarValue,
   describeChart,
+  describeChartErrorBars,
   describeChartSelection,
   describeOfficeChartPlace,
   downloadChartPng,
@@ -2214,6 +2211,7 @@ export {
   extractXlsxCharts,
   findMermaidCharts,
   fitChartTrendline,
+  formatChartAmountList,
   formatChartDate,
   formatChartNumber,
   formatChartValueWithCode,
@@ -2224,12 +2222,15 @@ export {
   layoutSparkline,
   linearMap,
   monochromeChartPalette,
+  niceLogScale,
   niceScale,
   niceStep,
   normalizeChartAxis,
+  normalizeChartErrorBars,
   normalizeChartSpec,
   normalizeChartTrendline,
   normalizeChartValues,
+  parseChartAmountList,
   parseChartColor,
   parseChartDate,
   parseChartValue,