@pixerate/editor 0.52.0 → 0.54.0

package/dist/chart/index.d.cts

@@ -1,7 +1,8 @@
-import { C as ChartNumberFormat, a as ChartValue, b as ChartRect, c as ChartScene, d as ChartSpec, e as ChartLayoutOptions, f as ChartTheme, g as ChartWarning, h as ChartAxis, i as ChartLegend, j as ChartType, k as ChartStacking, l as ChartSeries, m as ChartIssue, n as ChartController, o as ChartValueScale, p as ChartSelection, q as ChartSpecPatch } from '../controller-DS3drIvy.cjs';
-export { r as CHART_AXIS_KINDS, s as CHART_CURVES, t as CHART_LABEL_POSITIONS, u as CHART_LEGEND_POSITIONS, v as CHART_MARKERS, w as CHART_NUMBER_STYLES, x as CHART_ORIENTATIONS, y as CHART_SERIES_TYPES, z as CHART_STACKINGS, A as CHART_TRENDLINE_TYPES, B as CHART_TYPES, D as CHART_TYPE_LABELS, E as CSS_VARIABLE_CHART_THEME, F as ChartActionResult, G as ChartCircleMark, H as ChartControllerOptions, I as ChartCurve, J as ChartDomSpec, K as ChartEditOptions, L as ChartFamily, M as ChartLabelPosition, N as ChartLegendPosition, O as ChartLineMark, P as ChartMark, Q as ChartMarkRole, R as ChartMarker, S as ChartOrientation, T as ChartPathMark, U as ChartRectMark, V as ChartSeriesInput, W as ChartSeriesPatch, X as ChartSeriesType, Y as ChartSparklineKind, Z as ChartSparklineOptions, _ as ChartState, $ as ChartSvgOptions, a0 as ChartTableData, a1 as ChartTableOptions, a2 as ChartTextMark, a3 as ChartTextMeasure, a4 as ChartTrendFit, a5 as ChartTrendline, a6 as ChartTrendlineType, a7 as DEFAULT_CHART_PALETTE, a8 as DEFAULT_CHART_THEME, a9 as chartColorInputValue, aa as chartColorsByCategory, ab as chartDataFromTable, ac as chartDataToTable, ad as chartFamily, ae as chartMovingAverage, af as chartPointColor, ag as chartSceneToDomSpec, ah as chartSceneToSvg, ai as chartSeriesColor, aj as chartSeriesType, ak as chartSliceColor, al as chartSupportsTrendlines, am as chartTextBaseline, an as chartTextTransform, ao as chartToSvg, ap as chartTrendlineName, aq as cloneChartSeries, ar as cloneChartSpec, as as contrastingTextColor, at as createChartController, au as createChartSpec, av as defaultChartAxis, aw as estimateChartTextWidth, ax as fitChartTrendline, ay as isCartesianChart, az as isXyChart, aA as layoutSparkline, aB as normalizeChartAxis, aC as normalizeChartSpec, aD as normalizeChartTrendline, aE as normalizeChartValues, aF as parseChartValue, aG as sameChartSelection, aH as sparklineToSvg, aI as trendNumberText, aJ as uniqueChartSeriesId } from '../controller-DS3drIvy.cjs';
+import { C as ChartValueScale, a as ChartNumberFormat, b as ChartValue, c as ChartRect, d as ChartErrorBars, e as ChartErrorBarType, f as ChartScene, g as ChartSpec, h as ChartLayoutOptions, i as ChartTheme, j as ChartWarning, k as ChartAxis, l as ChartLegend, m as ChartType, n as ChartStacking, o as ChartSeries, p as ChartIssue, q as ChartController, r as ChartSelection, s as ChartSpecPatch } from '../controller-CX0QfSv0.cjs';
+export { t as CHART_AXIS_KINDS, u as CHART_AXIS_SCALES, v as CHART_CURVES, w as CHART_LABEL_POSITIONS, x as CHART_LEGEND_POSITIONS, y as CHART_MARKERS, z as CHART_NUMBER_STYLES, A as CHART_ORIENTATIONS, B as CHART_SERIES_TYPES, D as CHART_STACKINGS, E as CHART_TRENDLINE_TYPES, F as CHART_TYPES, G as CHART_TYPE_LABELS, H as CSS_VARIABLE_CHART_THEME, I as ChartActionResult, J as ChartCircleMark, K as ChartControllerOptions, L as ChartCurve, M as ChartDomSpec, N as ChartEditOptions, O as ChartFamily, P as ChartLabelPosition, Q as ChartLegendPosition, R as ChartLineMark, S as ChartMark, T as ChartMarkRole, U as ChartMarker, V as ChartOrientation, W as ChartPathMark, X as ChartRectMark, Y as ChartSeriesInput, Z as ChartSeriesPatch, _ as ChartSeriesType, $ as ChartSparklineKind, a0 as ChartSparklineOptions, a1 as ChartState, a2 as ChartSvgOptions, a3 as ChartTableData, a4 as ChartTableOptions, a5 as ChartTextMark, a6 as ChartTextMeasure, a7 as ChartTrendFit, a8 as ChartTrendline, a9 as ChartTrendlineType, aa as DEFAULT_CHART_PALETTE, ab as DEFAULT_CHART_THEME, ac as chartColorInputValue, ad as chartColorsByCategory, ae as chartDataFromTable, af as chartDataToTable, ag as chartFamily, ah as chartMovingAverage, ai as chartPointColor, aj as chartSceneToDomSpec, ak as chartSceneToSvg, al as chartSeriesColor, am as chartSeriesType, an as chartSliceColor, ao as chartSupportsTrendlines, ap as chartTextBaseline, aq as chartTextTransform, ar as chartToSvg, as as chartTrendlineName, at as cloneChartSeries, au as cloneChartSpec, av as contrastingTextColor, aw as createChartController, ax as createChartSpec, ay as defaultChartAxis, az as estimateChartTextWidth, aA as fitChartTrendline, aB as isCartesianChart, aC as isXyChart, aD as layoutSparkline, aE as normalizeChartAxis, aF as normalizeChartErrorBars, aG as normalizeChartSpec, aH as normalizeChartTrendline, aI as normalizeChartValues, aJ as parseChartValue, aK as sameChartSelection, aL as sparklineToSvg, aM as trendNumberText, aN as uniqueChartSeriesId } from '../controller-CX0QfSv0.cjs';
 import { C as CommandSpec } from '../registry-CaR7LC6W.cjs';
-import { A as AgentToolProvider } from '../registry-B4l-lYts.cjs';
+import { A as AgentToolProvider } from '../registry-DIpIaCkH.cjs';
+import { e as PresenceClock, g as PresenceStore, d as PresenceActorInfo, c as PresenceActor, f as PresenceState, h as createInstantPresenceClock } from '../presence-Cb6WhcrQ.cjs';
 import { Z as ZipReadOptions } from '../zip-4nG0YAH7.cjs';
 import '../HistoryManager-DeQQMBCj.cjs';
 import '../types-DsiXGmjo.cjs';
@@ -31,6 +32,20 @@ declare function stepDecimals(step: number): number;
 declare function formatChartNumber(value: number | null | undefined, format?: ChartNumberFormat, fallbackDecimals?: number): string;
 /** Linear map from `domain` to `range`. */
 declare function linearMap(value: number, domain: readonly [number, number], range: readonly [number, number]): number;
+/**
+ * A logarithmic scale over `[lo, hi]` (only positive values count): the ends extend to whole
+ * powers of `base` unless fixed, and ticks sit on the powers, thinned to about `count`, or, in
+ * base 10 over a few decades, on the 1-2-5 steps between them. `step` is the base. Non-positive
+ * or non-finite ends fall back to the data, and no positive data at all gives 1 to `base`.
+ */
+declare function niceLogScale(lo: number, hi: number, count?: number, base?: number, fixedMin?: number | null, fixedMax?: number | null): NiceScale;
+/**
+ * A data value's pixel on a value scale: linear, or by logarithm when `scale.logBase` is set
+ * (values of 0 or less have no pixel there and give NaN).
+ */
+declare function chartScaleToPixel(value: number, scale: Pick<ChartValueScale, 'domain' | 'range' | 'logBase'>): number;
+/** The data value at a pixel on a value scale (the inverse of `chartScaleToPixel`). */
+declare function chartScaleFromPixel(px: number, scale: Pick<ChartValueScale, 'domain' | 'range' | 'logBase'>): number;
 
 /**
  * A compiled spreadsheet number format code for chart labels, e.g. `#,##0.00`, `0.0%`,
@@ -256,6 +271,39 @@ declare function summarizeChartSeries(series: {
     values: readonly ChartValue[];
 }, categories: readonly string[]): ChartSeriesSummary;
 
+declare const CHART_ERROR_BAR_TYPES: readonly ChartErrorBarType[];
+declare const CHART_ERROR_BAR_DIRECTIONS: readonly NonNullable<ChartErrorBars['direction']>[];
+/** Labels for pickers, shared by the React and Svelte components. */
+declare const CHART_ERROR_BAR_LABELS: Readonly<Record<ChartErrorBarType, string>>;
+/** The default `value` per type (`fixed` 1, `percent` 5, `stddev` 1). */
+declare function defaultChartErrorBarValue(type: ChartErrorBarType): number | undefined;
+/** One point's error bar: where it is centred and how far it reaches each way (both 0 or more). */
+interface ChartErrorAmount {
+    /** The point's value, or the series mean for `stddev` (as Excel draws it). */
+    center: number;
+    plus: number;
+    minus: number;
+}
+/**
+ * The error bar at each point of `values` (a series' values, or its x values for x error
+ * bars), following Excel's error amount types: `fixed` and `percent` from `value`, `stddev`
+ * around the series mean, `stderr` (sample standard deviation / √n) and `custom` amounts from
+ * `plus` / `minus`. Gaps (and custom points without an amount) give `null`.
+ */
+declare function chartErrorAmounts(bars: ChartErrorBars, values: readonly ChartValue[]): (ChartErrorAmount | null)[];
+/** A one-line description of error bars ("±5% error bars", "±1 standard deviation error bars"). */
+declare function describeChartErrorBars(bars: ChartErrorBars): string;
+/**
+ * Error bars for a picker change: `null` for none, else bars of `type` that keep the current
+ * direction and caps. Switching to `custom` starts from the amounts the current bars (or ±1)
+ * draw, so the picture does not jump. Shared by the React and Svelte inspectors.
+ */
+declare function chartErrorBarsOfType(type: ChartErrorBarType | '' | null, current: ChartErrorBars | undefined, values: readonly ChartValue[]): ChartErrorBars | null;
+/** Custom amounts as text for an input: "1, 2, -, 0.5" (`-` is a point without a bar). */
+declare function formatChartAmountList(values: readonly ChartValue[] | undefined): string;
+/** Reads amounts typed as "1, 2, -, 0.5" (commas, semicolons or spaces; `-` or blank for none). */
+declare function parseChartAmountList(text: string): (string | null)[];
+
 /**
  * Lays a chart out as drawing primitives (rects, paths, circles, lines and text) in a
  * `width × height` box. Pure and DOM-free: the React and Svelte canvases render the marks
@@ -267,7 +315,7 @@ declare function layoutChart(spec: ChartSpec, options: ChartLayoutOptions): Char
 /**
  * The data value at a scene point along the value axis (for dragging a bar or point), or
  * `undefined` when the scene has no value scale or is percent-stacked. `secondary` reads the
- * secondary axis.
+ * secondary axis. Reversed and logarithmic axes are mapped as drawn.
  */
 declare function chartValueAtPoint(scene: ChartScene, point: {
     x: number;
@@ -278,8 +326,12 @@ declare function chartXAtPoint(scene: ChartScene, point: {
     x: number;
     y: number;
 }): number | undefined;
-/** The value a drag should store: snapped to a tenth of the tick step (or `step`) and kept finite. */
-declare function snapChartValue(scene: ChartScene, value: number, step?: number, ticks?: readonly number[]): number;
+/**
+ * The value a drag should store: snapped to a tenth of the tick step (or `step`) and kept
+ * finite. On a logarithmic axis (`logBase`, without a `step`) ticks are not evenly spaced, so
+ * the value is rounded to two significant digits instead.
+ */
+declare function snapChartValue(scene: ChartScene, value: number, step?: number, ticks?: readonly number[], logBase?: number): number;
 
 /** Data labels are skipped on series with more points than this. */
 declare const MAX_CHART_DATA_LABELS = 200;
@@ -368,27 +420,23 @@ declare function downloadChartPng(spec: ChartSpec, options?: DownloadChartPngOpt
     filename: string;
 }>;
 
+/** An axis as drawn. `logBase` is set on a logarithmic axis, `reversed` when it runs the other way. */
+interface ChartAxisSummary {
+    min: number;
+    max: number;
+    ticks: number[];
+    logBase?: number;
+    reversed?: boolean;
+}
 interface ChartSummary {
     type: ChartSpec['type'];
     title: string;
     categories: number;
     series: ChartSeriesSummary[];
     /** The value axis as drawn: range and ticks (absent for pies and treemaps). */
-    valueAxis?: {
-        min: number;
-        max: number;
-        ticks: number[];
-    };
-    secondaryAxis?: {
-        min: number;
-        max: number;
-        ticks: number[];
-    };
-    xAxis?: {
-        min: number;
-        max: number;
-        ticks: number[];
-    };
+    valueAxis?: ChartAxisSummary;
+    secondaryAxis?: ChartAxisSummary;
+    xAxis?: ChartAxisSummary;
     /** What the layout left out at this size (hidden labels, thinned lines, …). */
     warnings: ChartWarning[];
     /** Whether the series colours can be told apart (also with colour-blindness). */
@@ -727,42 +775,17 @@ interface ChartOoxmlWriteResult {
  */
 declare function chartToOoxml(spec: ChartSpec): ChartOoxmlWriteResult;
 
-interface ChartPresenceActor {
-    id: string;
-    name: string;
-    color: string;
-    /** Cursor position in scene coordinates. */
-    x: number;
-    y: number;
-    /** The button is down (dragging). */
-    pressed: boolean;
-    /** A short note shown next to the cursor (what the agent is doing). */
-    message?: string;
-}
-interface ChartPresenceState {
-    actors: readonly ChartPresenceActor[];
-}
+type ChartPresenceActor = PresenceActor;
+type ChartPresenceState = PresenceState;
 /** Cursor positions and notes of agents acting on a chart, for an overlay. */
-declare class ChartPresence {
-    private state;
-    private readonly listeners;
-    getState: () => ChartPresenceState;
-    subscribe: (listener: (state: ChartPresenceState) => void) => (() => void);
-    /** Adds or changes an actor. */
-    set(actor: Pick<ChartPresenceActor, 'id'> & Partial<ChartPresenceActor>): void;
-    remove(id: string): void;
+declare class ChartPresence extends PresenceStore {
 }
 declare const CHART_PRESENCE_COLORS: readonly string[];
 /** Time for performances: real timers, or an instant clock for tests and recordings. */
-interface ChartClock {
-    now(): number;
-    wait(ms: number): Promise<void>;
-}
+type ChartClock = PresenceClock;
 declare const realChartClock: ChartClock;
 /** A clock whose waits finish at once while its time still advances (repeatable performances). */
-declare function createInstantChartClock(start?: number): ChartClock & {
-    elapsed(): number;
-};
+declare const createInstantChartClock: typeof createInstantPresenceClock;
 /** What an agent asks for. Each command commits as one undo step. */
 type ChartAgentCommand = {
     kind: 'setValue';
@@ -830,11 +853,7 @@ interface ChartDirectorOptions {
     /** Hide each actor's cursor this long after its last command (ms, default 1500; 0 keeps it). */
     linger?: number;
 }
-interface ChartDirectorActor {
-    id: string;
-    name?: string;
-    color?: string;
-}
+type ChartDirectorActor = PresenceActorInfo;
 type ChartPerformanceResult = {
     ok: true;
     command: ChartAgentCommand;
@@ -853,9 +872,8 @@ declare class ChartDirector {
     private readonly controller;
     readonly presence: ChartPresence;
     private readonly options;
-    private readonly queues;
     private readonly clock;
-    private calls;
+    private readonly queue;
     constructor(controller: ChartController, presence: ChartPresence, options: ChartDirectorOptions);
     /** Acts out `commands` in order for `actor`. Resolves with one result per command. */
     perform(actor: ChartDirectorActor, commands: readonly ChartAgentCommand[]): Promise<ChartPerformanceResult[]>;
@@ -1064,4 +1082,4 @@ interface OfficeChartToolProviderOptions {
  */
 declare function createOfficeChartToolProvider(options?: OfficeChartToolProviderOptions): AgentToolProvider;
 
-export { CHART_COLOR_SCHEMES, CHART_DATE_STEPS, CHART_LAYOUT_PRESETS, CHART_MERMAID_META_PREFIX, CHART_OOXML_CONTENT_TYPE, CHART_OOXML_NS, CHART_OOXML_RELATIONSHIP, CHART_PALETTE_SHADES, CHART_PRESENCE_COLORS, CHART_RASTER_MAX_SIZE, type ChartAgentCommand, ChartAxis, type ChartBoxStats, type ChartClock, type ChartColorCheck, type ChartColorCheckOptions, type ChartColorPair, type ChartColorScheme, type ChartCommandOptions, ChartController, type ChartDateLabels, type ChartDateStep, ChartDirector, type ChartDirectorActor, type ChartDirectorOptions, type ChartDragMoveOptions, type ChartFormatCode, type ChartFromTable, type ChartHistogramBin, ChartIssue, type ChartKeyInput, ChartLayoutOptions, type ChartLayoutPreset, ChartLegend, type ChartMermaidFamily, type ChartMermaidOptions, type ChartMermaidParseOptions, type ChartMermaidResult, ChartNumberFormat, type ChartOoxmlReadOptions, type ChartOoxmlReadResult, type ChartOoxmlWriteResult, type ChartPaintScope, type ChartPerformanceResult, type ChartPerformanceStep, type ChartPointDrag, ChartPresence, type ChartPresenceActor, type ChartPresenceState, type ChartPresetPatch, type ChartRasterImage, type ChartRecommendation, ChartRect, type ChartRgb, ChartScene, ChartSelection, ChartSeries, type ChartSeriesSummary, type ChartSnapOptions, ChartSpec, ChartSpecPatch, ChartStacking, ChartStream, type ChartStreamFormat, type ChartStreamResult, type ChartSummary, type ChartTableShape, ChartTheme, type ChartToolProviderOptions, ChartType, ChartValue, ChartValueScale, type ChartVision, ChartWarning, type DownloadChartPngOptions, type FoundChartMermaid, MAX_CHART_DATA_LABELS, MAX_CHART_LINE_POINTS, MAX_CHART_MARKERS, type NiceScale, type OfficeChartFile, type OfficeChartFileFormat, type OfficeChartToolProviderOptions, OfficeChartsError, type OfficeChartsReadOptions, type OfficeChartsResult, type OfficeFileChart, RENDER_CHART_INSTRUCTIONS, type RasterizeChartOptions, analyzeChartTable, blendChartScenes, canDragChartPoint, chartBoxStats, chartClientToScene, chartColorDistance, chartContrastRatio, chartDateLabels, chartDateToSerial, chartFileName, chartFormatToCode, chartFromMermaid, chartFromOoxml, chartFromTable, chartHistogram, chartHitTest, chartLuminance, chartMermaidFamily, chartPointAnchor, chartPresetPatch, chartQuantile, chartRasterSize, chartRgbToHex, chartRgbToOklab, chartSerialToDate, chartSquarify, chartTextOn, chartToMermaid, chartToOoxml, chartValueAtPoint, chartXAtPoint, checkChartColors, compileChartFormatCode, createChartCommands, createChartRasterizer, createChartToolProvider, createInstantChartClock, createOfficeChartToolProvider, cyclePaletteColor, decimateChartPoints, describeChart, describeChartSelection, describeOfficeChartPlace, downloadChartPng, easeChartTween, extractDocxCharts, extractOfficeCharts, extractPptxCharts, extractXlsxCharts, findMermaidCharts, formatChartDate, formatChartNumber, formatChartValueWithCode, handleChartKey, layoutChart, linearMap, monochromeChartPalette, niceScale, niceStep, parseChartColor, parseChartDate, parsePartialChartJson, planChartCommand, rasterizeChartSvg, realChartClock, recommendChartTypes, recommendForShape, resolveChartSvgPaints, shadeChartColor, simulateChartVision, snapChartDragValue, snapChartValue, startChartPointDrag, stepDecimals, summarizeChart, summarizeChartSeries };
+export { CHART_COLOR_SCHEMES, CHART_DATE_STEPS, CHART_ERROR_BAR_DIRECTIONS, CHART_ERROR_BAR_LABELS, CHART_ERROR_BAR_TYPES, CHART_LAYOUT_PRESETS, CHART_MERMAID_META_PREFIX, CHART_OOXML_CONTENT_TYPE, CHART_OOXML_NS, CHART_OOXML_RELATIONSHIP, CHART_PALETTE_SHADES, CHART_PRESENCE_COLORS, CHART_RASTER_MAX_SIZE, type ChartAgentCommand, ChartAxis, type ChartAxisSummary, type ChartBoxStats, type ChartClock, type ChartColorCheck, type ChartColorCheckOptions, type ChartColorPair, type ChartColorScheme, type ChartCommandOptions, ChartController, type ChartDateLabels, type ChartDateStep, ChartDirector, type ChartDirectorActor, type ChartDirectorOptions, type ChartDragMoveOptions, type ChartErrorAmount, ChartErrorBarType, ChartErrorBars, type ChartFormatCode, type ChartFromTable, type ChartHistogramBin, ChartIssue, type ChartKeyInput, ChartLayoutOptions, type ChartLayoutPreset, ChartLegend, type ChartMermaidFamily, type ChartMermaidOptions, type ChartMermaidParseOptions, type ChartMermaidResult, ChartNumberFormat, type ChartOoxmlReadOptions, type ChartOoxmlReadResult, type ChartOoxmlWriteResult, type ChartPaintScope, type ChartPerformanceResult, type ChartPerformanceStep, type ChartPointDrag, ChartPresence, type ChartPresenceActor, type ChartPresenceState, type ChartPresetPatch, type ChartRasterImage, type ChartRecommendation, ChartRect, type ChartRgb, ChartScene, ChartSelection, ChartSeries, type ChartSeriesSummary, type ChartSnapOptions, ChartSpec, ChartSpecPatch, ChartStacking, ChartStream, type ChartStreamFormat, type ChartStreamResult, type ChartSummary, type ChartTableShape, ChartTheme, type ChartToolProviderOptions, ChartType, ChartValue, ChartValueScale, type ChartVision, ChartWarning, type DownloadChartPngOptions, type FoundChartMermaid, MAX_CHART_DATA_LABELS, MAX_CHART_LINE_POINTS, MAX_CHART_MARKERS, type NiceScale, type OfficeChartFile, type OfficeChartFileFormat, type OfficeChartToolProviderOptions, OfficeChartsError, type OfficeChartsReadOptions, type OfficeChartsResult, type OfficeFileChart, RENDER_CHART_INSTRUCTIONS, type RasterizeChartOptions, analyzeChartTable, blendChartScenes, canDragChartPoint, chartBoxStats, chartClientToScene, chartColorDistance, chartContrastRatio, chartDateLabels, chartDateToSerial, chartErrorAmounts, chartErrorBarsOfType, chartFileName, chartFormatToCode, chartFromMermaid, chartFromOoxml, chartFromTable, chartHistogram, chartHitTest, chartLuminance, chartMermaidFamily, chartPointAnchor, chartPresetPatch, chartQuantile, chartRasterSize, chartRgbToHex, chartRgbToOklab, chartScaleFromPixel, chartScaleToPixel, chartSerialToDate, chartSquarify, chartTextOn, chartToMermaid, chartToOoxml, chartValueAtPoint, chartXAtPoint, checkChartColors, compileChartFormatCode, createChartCommands, createChartRasterizer, createChartToolProvider, createInstantChartClock, createOfficeChartToolProvider, cyclePaletteColor, decimateChartPoints, defaultChartErrorBarValue, describeChart, describeChartErrorBars, describeChartSelection, describeOfficeChartPlace, downloadChartPng, easeChartTween, extractDocxCharts, extractOfficeCharts, extractPptxCharts, extractXlsxCharts, findMermaidCharts, formatChartAmountList, formatChartDate, formatChartNumber, formatChartValueWithCode, handleChartKey, layoutChart, linearMap, monochromeChartPalette, niceLogScale, niceScale, niceStep, parseChartAmountList, parseChartColor, parseChartDate, parsePartialChartJson, planChartCommand, rasterizeChartSvg, realChartClock, recommendChartTypes, recommendForShape, resolveChartSvgPaints, shadeChartColor, simulateChartVision, snapChartDragValue, snapChartValue, startChartPointDrag, stepDecimals, summarizeChart, summarizeChartSeries };

package/dist/chart/index.d.ts

@@ -1,7 +1,8 @@
-import { C as ChartNumberFormat, a as ChartValue, b as ChartRect, c as ChartScene, d as ChartSpec, e as ChartLayoutOptions, f as ChartTheme, g as ChartWarning, h as ChartAxis, i as ChartLegend, j as ChartType, k as ChartStacking, l as ChartSeries, m as ChartIssue, n as ChartController, o as ChartValueScale, p as ChartSelection, q as ChartSpecPatch } from '../controller-BdKzaxs2.js';
-export { r as CHART_AXIS_KINDS, s as CHART_CURVES, t as CHART_LABEL_POSITIONS, u as CHART_LEGEND_POSITIONS, v as CHART_MARKERS, w as CHART_NUMBER_STYLES, x as CHART_ORIENTATIONS, y as CHART_SERIES_TYPES, z as CHART_STACKINGS, A as CHART_TRENDLINE_TYPES, B as CHART_TYPES, D as CHART_TYPE_LABELS, E as CSS_VARIABLE_CHART_THEME, F as ChartActionResult, G as ChartCircleMark, H as ChartControllerOptions, I as ChartCurve, J as ChartDomSpec, K as ChartEditOptions, L as ChartFamily, M as ChartLabelPosition, N as ChartLegendPosition, O as ChartLineMark, P as ChartMark, Q as ChartMarkRole, R as ChartMarker, S as ChartOrientation, T as ChartPathMark, U as ChartRectMark, V as ChartSeriesInput, W as ChartSeriesPatch, X as ChartSeriesType, Y as ChartSparklineKind, Z as ChartSparklineOptions, _ as ChartState, $ as ChartSvgOptions, a0 as ChartTableData, a1 as ChartTableOptions, a2 as ChartTextMark, a3 as ChartTextMeasure, a4 as ChartTrendFit, a5 as ChartTrendline, a6 as ChartTrendlineType, a7 as DEFAULT_CHART_PALETTE, a8 as DEFAULT_CHART_THEME, a9 as chartColorInputValue, aa as chartColorsByCategory, ab as chartDataFromTable, ac as chartDataToTable, ad as chartFamily, ae as chartMovingAverage, af as chartPointColor, ag as chartSceneToDomSpec, ah as chartSceneToSvg, ai as chartSeriesColor, aj as chartSeriesType, ak as chartSliceColor, al as chartSupportsTrendlines, am as chartTextBaseline, an as chartTextTransform, ao as chartToSvg, ap as chartTrendlineName, aq as cloneChartSeries, ar as cloneChartSpec, as as contrastingTextColor, at as createChartController, au as createChartSpec, av as defaultChartAxis, aw as estimateChartTextWidth, ax as fitChartTrendline, ay as isCartesianChart, az as isXyChart, aA as layoutSparkline, aB as normalizeChartAxis, aC as normalizeChartSpec, aD as normalizeChartTrendline, aE as normalizeChartValues, aF as parseChartValue, aG as sameChartSelection, aH as sparklineToSvg, aI as trendNumberText, aJ as uniqueChartSeriesId } from '../controller-BdKzaxs2.js';
+import { C as ChartValueScale, a as ChartNumberFormat, b as ChartValue, c as ChartRect, d as ChartErrorBars, e as ChartErrorBarType, f as ChartScene, g as ChartSpec, h as ChartLayoutOptions, i as ChartTheme, j as ChartWarning, k as ChartAxis, l as ChartLegend, m as ChartType, n as ChartStacking, o as ChartSeries, p as ChartIssue, q as ChartController, r as ChartSelection, s as ChartSpecPatch } from '../controller-DscWQbjO.js';
+export { t as CHART_AXIS_KINDS, u as CHART_AXIS_SCALES, v as CHART_CURVES, w as CHART_LABEL_POSITIONS, x as CHART_LEGEND_POSITIONS, y as CHART_MARKERS, z as CHART_NUMBER_STYLES, A as CHART_ORIENTATIONS, B as CHART_SERIES_TYPES, D as CHART_STACKINGS, E as CHART_TRENDLINE_TYPES, F as CHART_TYPES, G as CHART_TYPE_LABELS, H as CSS_VARIABLE_CHART_THEME, I as ChartActionResult, J as ChartCircleMark, K as ChartControllerOptions, L as ChartCurve, M as ChartDomSpec, N as ChartEditOptions, O as ChartFamily, P as ChartLabelPosition, Q as ChartLegendPosition, R as ChartLineMark, S as ChartMark, T as ChartMarkRole, U as ChartMarker, V as ChartOrientation, W as ChartPathMark, X as ChartRectMark, Y as ChartSeriesInput, Z as ChartSeriesPatch, _ as ChartSeriesType, $ as ChartSparklineKind, a0 as ChartSparklineOptions, a1 as ChartState, a2 as ChartSvgOptions, a3 as ChartTableData, a4 as ChartTableOptions, a5 as ChartTextMark, a6 as ChartTextMeasure, a7 as ChartTrendFit, a8 as ChartTrendline, a9 as ChartTrendlineType, aa as DEFAULT_CHART_PALETTE, ab as DEFAULT_CHART_THEME, ac as chartColorInputValue, ad as chartColorsByCategory, ae as chartDataFromTable, af as chartDataToTable, ag as chartFamily, ah as chartMovingAverage, ai as chartPointColor, aj as chartSceneToDomSpec, ak as chartSceneToSvg, al as chartSeriesColor, am as chartSeriesType, an as chartSliceColor, ao as chartSupportsTrendlines, ap as chartTextBaseline, aq as chartTextTransform, ar as chartToSvg, as as chartTrendlineName, at as cloneChartSeries, au as cloneChartSpec, av as contrastingTextColor, aw as createChartController, ax as createChartSpec, ay as defaultChartAxis, az as estimateChartTextWidth, aA as fitChartTrendline, aB as isCartesianChart, aC as isXyChart, aD as layoutSparkline, aE as normalizeChartAxis, aF as normalizeChartErrorBars, aG as normalizeChartSpec, aH as normalizeChartTrendline, aI as normalizeChartValues, aJ as parseChartValue, aK as sameChartSelection, aL as sparklineToSvg, aM as trendNumberText, aN as uniqueChartSeriesId } from '../controller-DscWQbjO.js';
 import { C as CommandSpec } from '../registry-rVtFJjRM.js';
-import { A as AgentToolProvider } from '../registry-CSlH4iUn.js';
+import { A as AgentToolProvider } from '../registry-7AZFuand.js';
+import { e as PresenceClock, g as PresenceStore, d as PresenceActorInfo, c as PresenceActor, f as PresenceState, h as createInstantPresenceClock } from '../presence-Cb6WhcrQ.js';
 import { Z as ZipReadOptions } from '../zip-4nG0YAH7.js';
 import '../HistoryManager-DWSLd6Tf.js';
 import '../types-DsiXGmjo.js';
@@ -31,6 +32,20 @@ declare function stepDecimals(step: number): number;
 declare function formatChartNumber(value: number | null | undefined, format?: ChartNumberFormat, fallbackDecimals?: number): string;
 /** Linear map from `domain` to `range`. */
 declare function linearMap(value: number, domain: readonly [number, number], range: readonly [number, number]): number;
+/**
+ * A logarithmic scale over `[lo, hi]` (only positive values count): the ends extend to whole
+ * powers of `base` unless fixed, and ticks sit on the powers, thinned to about `count`, or, in
+ * base 10 over a few decades, on the 1-2-5 steps between them. `step` is the base. Non-positive
+ * or non-finite ends fall back to the data, and no positive data at all gives 1 to `base`.
+ */
+declare function niceLogScale(lo: number, hi: number, count?: number, base?: number, fixedMin?: number | null, fixedMax?: number | null): NiceScale;
+/**
+ * A data value's pixel on a value scale: linear, or by logarithm when `scale.logBase` is set
+ * (values of 0 or less have no pixel there and give NaN).
+ */
+declare function chartScaleToPixel(value: number, scale: Pick<ChartValueScale, 'domain' | 'range' | 'logBase'>): number;
+/** The data value at a pixel on a value scale (the inverse of `chartScaleToPixel`). */
+declare function chartScaleFromPixel(px: number, scale: Pick<ChartValueScale, 'domain' | 'range' | 'logBase'>): number;
 
 /**
  * A compiled spreadsheet number format code for chart labels, e.g. `#,##0.00`, `0.0%`,
@@ -256,6 +271,39 @@ declare function summarizeChartSeries(series: {
     values: readonly ChartValue[];
 }, categories: readonly string[]): ChartSeriesSummary;
 
+declare const CHART_ERROR_BAR_TYPES: readonly ChartErrorBarType[];
+declare const CHART_ERROR_BAR_DIRECTIONS: readonly NonNullable<ChartErrorBars['direction']>[];
+/** Labels for pickers, shared by the React and Svelte components. */
+declare const CHART_ERROR_BAR_LABELS: Readonly<Record<ChartErrorBarType, string>>;
+/** The default `value` per type (`fixed` 1, `percent` 5, `stddev` 1). */
+declare function defaultChartErrorBarValue(type: ChartErrorBarType): number | undefined;
+/** One point's error bar: where it is centred and how far it reaches each way (both 0 or more). */
+interface ChartErrorAmount {
+    /** The point's value, or the series mean for `stddev` (as Excel draws it). */
+    center: number;
+    plus: number;
+    minus: number;
+}
+/**
+ * The error bar at each point of `values` (a series' values, or its x values for x error
+ * bars), following Excel's error amount types: `fixed` and `percent` from `value`, `stddev`
+ * around the series mean, `stderr` (sample standard deviation / √n) and `custom` amounts from
+ * `plus` / `minus`. Gaps (and custom points without an amount) give `null`.
+ */
+declare function chartErrorAmounts(bars: ChartErrorBars, values: readonly ChartValue[]): (ChartErrorAmount | null)[];
+/** A one-line description of error bars ("±5% error bars", "±1 standard deviation error bars"). */
+declare function describeChartErrorBars(bars: ChartErrorBars): string;
+/**
+ * Error bars for a picker change: `null` for none, else bars of `type` that keep the current
+ * direction and caps. Switching to `custom` starts from the amounts the current bars (or ±1)
+ * draw, so the picture does not jump. Shared by the React and Svelte inspectors.
+ */
+declare function chartErrorBarsOfType(type: ChartErrorBarType | '' | null, current: ChartErrorBars | undefined, values: readonly ChartValue[]): ChartErrorBars | null;
+/** Custom amounts as text for an input: "1, 2, -, 0.5" (`-` is a point without a bar). */
+declare function formatChartAmountList(values: readonly ChartValue[] | undefined): string;
+/** Reads amounts typed as "1, 2, -, 0.5" (commas, semicolons or spaces; `-` or blank for none). */
+declare function parseChartAmountList(text: string): (string | null)[];
+
 /**
  * Lays a chart out as drawing primitives (rects, paths, circles, lines and text) in a
  * `width × height` box. Pure and DOM-free: the React and Svelte canvases render the marks
@@ -267,7 +315,7 @@ declare function layoutChart(spec: ChartSpec, options: ChartLayoutOptions): Char
 /**
  * The data value at a scene point along the value axis (for dragging a bar or point), or
  * `undefined` when the scene has no value scale or is percent-stacked. `secondary` reads the
- * secondary axis.
+ * secondary axis. Reversed and logarithmic axes are mapped as drawn.
  */
 declare function chartValueAtPoint(scene: ChartScene, point: {
     x: number;
@@ -278,8 +326,12 @@ declare function chartXAtPoint(scene: ChartScene, point: {
     x: number;
     y: number;
 }): number | undefined;
-/** The value a drag should store: snapped to a tenth of the tick step (or `step`) and kept finite. */
-declare function snapChartValue(scene: ChartScene, value: number, step?: number, ticks?: readonly number[]): number;
+/**
+ * The value a drag should store: snapped to a tenth of the tick step (or `step`) and kept
+ * finite. On a logarithmic axis (`logBase`, without a `step`) ticks are not evenly spaced, so
+ * the value is rounded to two significant digits instead.
+ */
+declare function snapChartValue(scene: ChartScene, value: number, step?: number, ticks?: readonly number[], logBase?: number): number;
 
 /** Data labels are skipped on series with more points than this. */
 declare const MAX_CHART_DATA_LABELS = 200;
@@ -368,27 +420,23 @@ declare function downloadChartPng(spec: ChartSpec, options?: DownloadChartPngOpt
     filename: string;
 }>;
 
+/** An axis as drawn. `logBase` is set on a logarithmic axis, `reversed` when it runs the other way. */
+interface ChartAxisSummary {
+    min: number;
+    max: number;
+    ticks: number[];
+    logBase?: number;
+    reversed?: boolean;
+}
 interface ChartSummary {
     type: ChartSpec['type'];
     title: string;
     categories: number;
     series: ChartSeriesSummary[];
     /** The value axis as drawn: range and ticks (absent for pies and treemaps). */
-    valueAxis?: {
-        min: number;
-        max: number;
-        ticks: number[];
-    };
-    secondaryAxis?: {
-        min: number;
-        max: number;
-        ticks: number[];
-    };
-    xAxis?: {
-        min: number;
-        max: number;
-        ticks: number[];
-    };
+    valueAxis?: ChartAxisSummary;
+    secondaryAxis?: ChartAxisSummary;
+    xAxis?: ChartAxisSummary;
     /** What the layout left out at this size (hidden labels, thinned lines, …). */
     warnings: ChartWarning[];
     /** Whether the series colours can be told apart (also with colour-blindness). */
@@ -727,42 +775,17 @@ interface ChartOoxmlWriteResult {
  */
 declare function chartToOoxml(spec: ChartSpec): ChartOoxmlWriteResult;
 
-interface ChartPresenceActor {
-    id: string;
-    name: string;
-    color: string;
-    /** Cursor position in scene coordinates. */
-    x: number;
-    y: number;
-    /** The button is down (dragging). */
-    pressed: boolean;
-    /** A short note shown next to the cursor (what the agent is doing). */
-    message?: string;
-}
-interface ChartPresenceState {
-    actors: readonly ChartPresenceActor[];
-}
+type ChartPresenceActor = PresenceActor;
+type ChartPresenceState = PresenceState;
 /** Cursor positions and notes of agents acting on a chart, for an overlay. */
-declare class ChartPresence {
-    private state;
-    private readonly listeners;
-    getState: () => ChartPresenceState;
-    subscribe: (listener: (state: ChartPresenceState) => void) => (() => void);
-    /** Adds or changes an actor. */
-    set(actor: Pick<ChartPresenceActor, 'id'> & Partial<ChartPresenceActor>): void;
-    remove(id: string): void;
+declare class ChartPresence extends PresenceStore {
 }
 declare const CHART_PRESENCE_COLORS: readonly string[];
 /** Time for performances: real timers, or an instant clock for tests and recordings. */
-interface ChartClock {
-    now(): number;
-    wait(ms: number): Promise<void>;
-}
+type ChartClock = PresenceClock;
 declare const realChartClock: ChartClock;
 /** A clock whose waits finish at once while its time still advances (repeatable performances). */
-declare function createInstantChartClock(start?: number): ChartClock & {
-    elapsed(): number;
-};
+declare const createInstantChartClock: typeof createInstantPresenceClock;
 /** What an agent asks for. Each command commits as one undo step. */
 type ChartAgentCommand = {
     kind: 'setValue';
@@ -830,11 +853,7 @@ interface ChartDirectorOptions {
     /** Hide each actor's cursor this long after its last command (ms, default 1500; 0 keeps it). */
     linger?: number;
 }
-interface ChartDirectorActor {
-    id: string;
-    name?: string;
-    color?: string;
-}
+type ChartDirectorActor = PresenceActorInfo;
 type ChartPerformanceResult = {
     ok: true;
     command: ChartAgentCommand;
@@ -853,9 +872,8 @@ declare class ChartDirector {
     private readonly controller;
     readonly presence: ChartPresence;
     private readonly options;
-    private readonly queues;
     private readonly clock;
-    private calls;
+    private readonly queue;
     constructor(controller: ChartController, presence: ChartPresence, options: ChartDirectorOptions);
     /** Acts out `commands` in order for `actor`. Resolves with one result per command. */
     perform(actor: ChartDirectorActor, commands: readonly ChartAgentCommand[]): Promise<ChartPerformanceResult[]>;
@@ -1064,4 +1082,4 @@ interface OfficeChartToolProviderOptions {
  */
 declare function createOfficeChartToolProvider(options?: OfficeChartToolProviderOptions): AgentToolProvider;
 
-export { CHART_COLOR_SCHEMES, CHART_DATE_STEPS, CHART_LAYOUT_PRESETS, CHART_MERMAID_META_PREFIX, CHART_OOXML_CONTENT_TYPE, CHART_OOXML_NS, CHART_OOXML_RELATIONSHIP, CHART_PALETTE_SHADES, CHART_PRESENCE_COLORS, CHART_RASTER_MAX_SIZE, type ChartAgentCommand, ChartAxis, type ChartBoxStats, type ChartClock, type ChartColorCheck, type ChartColorCheckOptions, type ChartColorPair, type ChartColorScheme, type ChartCommandOptions, ChartController, type ChartDateLabels, type ChartDateStep, ChartDirector, type ChartDirectorActor, type ChartDirectorOptions, type ChartDragMoveOptions, type ChartFormatCode, type ChartFromTable, type ChartHistogramBin, ChartIssue, type ChartKeyInput, ChartLayoutOptions, type ChartLayoutPreset, ChartLegend, type ChartMermaidFamily, type ChartMermaidOptions, type ChartMermaidParseOptions, type ChartMermaidResult, ChartNumberFormat, type ChartOoxmlReadOptions, type ChartOoxmlReadResult, type ChartOoxmlWriteResult, type ChartPaintScope, type ChartPerformanceResult, type ChartPerformanceStep, type ChartPointDrag, ChartPresence, type ChartPresenceActor, type ChartPresenceState, type ChartPresetPatch, type ChartRasterImage, type ChartRecommendation, ChartRect, type ChartRgb, ChartScene, ChartSelection, ChartSeries, type ChartSeriesSummary, type ChartSnapOptions, ChartSpec, ChartSpecPatch, ChartStacking, ChartStream, type ChartStreamFormat, type ChartStreamResult, type ChartSummary, type ChartTableShape, ChartTheme, type ChartToolProviderOptions, ChartType, ChartValue, ChartValueScale, type ChartVision, ChartWarning, type DownloadChartPngOptions, type FoundChartMermaid, MAX_CHART_DATA_LABELS, MAX_CHART_LINE_POINTS, MAX_CHART_MARKERS, type NiceScale, type OfficeChartFile, type OfficeChartFileFormat, type OfficeChartToolProviderOptions, OfficeChartsError, type OfficeChartsReadOptions, type OfficeChartsResult, type OfficeFileChart, RENDER_CHART_INSTRUCTIONS, type RasterizeChartOptions, analyzeChartTable, blendChartScenes, canDragChartPoint, chartBoxStats, chartClientToScene, chartColorDistance, chartContrastRatio, chartDateLabels, chartDateToSerial, chartFileName, chartFormatToCode, chartFromMermaid, chartFromOoxml, chartFromTable, chartHistogram, chartHitTest, chartLuminance, chartMermaidFamily, chartPointAnchor, chartPresetPatch, chartQuantile, chartRasterSize, chartRgbToHex, chartRgbToOklab, chartSerialToDate, chartSquarify, chartTextOn, chartToMermaid, chartToOoxml, chartValueAtPoint, chartXAtPoint, checkChartColors, compileChartFormatCode, createChartCommands, createChartRasterizer, createChartToolProvider, createInstantChartClock, createOfficeChartToolProvider, cyclePaletteColor, decimateChartPoints, describeChart, describeChartSelection, describeOfficeChartPlace, downloadChartPng, easeChartTween, extractDocxCharts, extractOfficeCharts, extractPptxCharts, extractXlsxCharts, findMermaidCharts, formatChartDate, formatChartNumber, formatChartValueWithCode, handleChartKey, layoutChart, linearMap, monochromeChartPalette, niceScale, niceStep, parseChartColor, parseChartDate, parsePartialChartJson, planChartCommand, rasterizeChartSvg, realChartClock, recommendChartTypes, recommendForShape, resolveChartSvgPaints, shadeChartColor, simulateChartVision, snapChartDragValue, snapChartValue, startChartPointDrag, stepDecimals, summarizeChart, summarizeChartSeries };
+export { CHART_COLOR_SCHEMES, CHART_DATE_STEPS, CHART_ERROR_BAR_DIRECTIONS, CHART_ERROR_BAR_LABELS, CHART_ERROR_BAR_TYPES, CHART_LAYOUT_PRESETS, CHART_MERMAID_META_PREFIX, CHART_OOXML_CONTENT_TYPE, CHART_OOXML_NS, CHART_OOXML_RELATIONSHIP, CHART_PALETTE_SHADES, CHART_PRESENCE_COLORS, CHART_RASTER_MAX_SIZE, type ChartAgentCommand, ChartAxis, type ChartAxisSummary, type ChartBoxStats, type ChartClock, type ChartColorCheck, type ChartColorCheckOptions, type ChartColorPair, type ChartColorScheme, type ChartCommandOptions, ChartController, type ChartDateLabels, type ChartDateStep, ChartDirector, type ChartDirectorActor, type ChartDirectorOptions, type ChartDragMoveOptions, type ChartErrorAmount, ChartErrorBarType, ChartErrorBars, type ChartFormatCode, type ChartFromTable, type ChartHistogramBin, ChartIssue, type ChartKeyInput, ChartLayoutOptions, type ChartLayoutPreset, ChartLegend, type ChartMermaidFamily, type ChartMermaidOptions, type ChartMermaidParseOptions, type ChartMermaidResult, ChartNumberFormat, type ChartOoxmlReadOptions, type ChartOoxmlReadResult, type ChartOoxmlWriteResult, type ChartPaintScope, type ChartPerformanceResult, type ChartPerformanceStep, type ChartPointDrag, ChartPresence, type ChartPresenceActor, type ChartPresenceState, type ChartPresetPatch, type ChartRasterImage, type ChartRecommendation, ChartRect, type ChartRgb, ChartScene, ChartSelection, ChartSeries, type ChartSeriesSummary, type ChartSnapOptions, ChartSpec, ChartSpecPatch, ChartStacking, ChartStream, type ChartStreamFormat, type ChartStreamResult, type ChartSummary, type ChartTableShape, ChartTheme, type ChartToolProviderOptions, ChartType, ChartValue, ChartValueScale, type ChartVision, ChartWarning, type DownloadChartPngOptions, type FoundChartMermaid, MAX_CHART_DATA_LABELS, MAX_CHART_LINE_POINTS, MAX_CHART_MARKERS, type NiceScale, type OfficeChartFile, type OfficeChartFileFormat, type OfficeChartToolProviderOptions, OfficeChartsError, type OfficeChartsReadOptions, type OfficeChartsResult, type OfficeFileChart, RENDER_CHART_INSTRUCTIONS, type RasterizeChartOptions, analyzeChartTable, blendChartScenes, canDragChartPoint, chartBoxStats, chartClientToScene, chartColorDistance, chartContrastRatio, chartDateLabels, chartDateToSerial, chartErrorAmounts, chartErrorBarsOfType, chartFileName, chartFormatToCode, chartFromMermaid, chartFromOoxml, chartFromTable, chartHistogram, chartHitTest, chartLuminance, chartMermaidFamily, chartPointAnchor, chartPresetPatch, chartQuantile, chartRasterSize, chartRgbToHex, chartRgbToOklab, chartScaleFromPixel, chartScaleToPixel, chartSerialToDate, chartSquarify, chartTextOn, chartToMermaid, chartToOoxml, chartValueAtPoint, chartXAtPoint, checkChartColors, compileChartFormatCode, createChartCommands, createChartRasterizer, createChartToolProvider, createInstantChartClock, createOfficeChartToolProvider, cyclePaletteColor, decimateChartPoints, defaultChartErrorBarValue, describeChart, describeChartErrorBars, describeChartSelection, describeOfficeChartPlace, downloadChartPng, easeChartTween, extractDocxCharts, extractOfficeCharts, extractPptxCharts, extractXlsxCharts, findMermaidCharts, formatChartAmountList, formatChartDate, formatChartNumber, formatChartValueWithCode, handleChartKey, layoutChart, linearMap, monochromeChartPalette, niceLogScale, niceScale, niceStep, parseChartAmountList, parseChartColor, parseChartDate, parsePartialChartJson, planChartCommand, rasterizeChartSvg, realChartClock, recommendChartTypes, recommendForShape, resolveChartSvgPaints, shadeChartColor, simulateChartVision, snapChartDragValue, snapChartValue, startChartPointDrag, stepDecimals, summarizeChart, summarizeChartSeries };