@pixerate/editor 0.51.0 → 0.53.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 { Z as ZipReadOptions } from '../zip-4nG0YAH7.cjs';
 import '../HistoryManager-DeQQMBCj.cjs';
 import '../types-DsiXGmjo.cjs';
 import '../schema-Di0CS6Pe.cjs';
@@ -30,6 +31,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%`,
@@ -255,6 +270,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
@@ -266,7 +314,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;
@@ -277,8 +325,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;
@@ -367,27 +419,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). */
@@ -684,12 +732,12 @@ declare function findMermaidCharts(text: string): FoundChartMermaid[];
 declare const CHART_OOXML_NS = "http://schemas.openxmlformats.org/drawingml/2006/chart";
 declare const CHART_OOXML_CONTENT_TYPE = "application/vnd.openxmlformats-officedocument.drawingml.chart+xml";
 declare const CHART_OOXML_RELATIONSHIP = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/chart";
-type ParserCtor$1 = {
+type ParserCtor$3 = {
     new (): DOMParser;
 };
 interface ChartOoxmlReadOptions {
     /** `DOMParser` constructor (default: the global one; pass jsdom's or xmldom's in Node). */
-    DOMParser?: ParserCtor$1;
+    DOMParser?: ParserCtor$3;
 }
 interface ChartOoxmlReadResult {
     spec: ChartSpec;
@@ -863,7 +911,7 @@ declare class ChartDirector {
     private performOne;
 }
 
-type ParserCtor = {
+type ParserCtor$2 = {
     new (): DOMParser;
 };
 interface ChartToolProviderOptions {
@@ -882,7 +930,7 @@ interface ChartToolProviderOptions {
         height: number;
     };
     /** Enables `import_chart_ooxml` (reading Office chart XML needs a DOMParser). Default: the global one, if any. */
-    DOMParser?: ParserCtor;
+    DOMParser?: ParserCtor$2;
     /**
      * Acts out `set_chart_values` and `select_chart_element` with a visible cursor (see
      * `ChartDirector`); each call is still one undo step. Without it, edits apply at once.
@@ -962,4 +1010,105 @@ declare function blendChartScenes(from: ChartScene | null, to: ChartScene, t: nu
 /** Ease-out cubic, for tweens. */
 declare const easeChartTween: (t: number) => number;
 
-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, 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, cyclePaletteColor, decimateChartPoints, describeChart, describeChartSelection, downloadChartPng, easeChartTween, 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 };
+type ParserCtor$1 = {
+    new (): DOMParser;
+};
+/** Office files charts can be read from. */
+type OfficeChartFileFormat = 'xlsx' | 'pptx' | 'docx';
+/** A chart found in an Excel workbook, PowerPoint deck or Word document. */
+interface OfficeFileChart {
+    /** `chart-1`, `chart-2`, … in file order (sheets, slides or the document body). */
+    id: string;
+    /** The chart part, e.g. `xl/charts/chart1.xml` or `ppt/charts/chartEx1.xml`. */
+    path: string;
+    /** `chart` for DrawingML (`c:chartSpace`), `chartex` for Office 2016 charts (`cx:chartSpace`). */
+    partKind: 'chart' | 'chartex';
+    /** Worksheet or chart sheet name (xlsx). */
+    sheet?: string;
+    /** 1-based slide number (pptx). */
+    slide?: number;
+    /** Top-left cell the chart is anchored to, e.g. `B2` (xlsx worksheets). */
+    anchor?: string;
+    /** The cells the chart covers, e.g. `B2:H18` (xlsx two-cell anchors). */
+    range?: string;
+    /** The shape name (`cNvPr name`), e.g. `Chart 3`. */
+    name?: string;
+    /** The chart's title (may be empty). */
+    title: string;
+    spec: ChartSpec;
+    /** Problems reading it, as sentences. */
+    issues: string[];
+    /** Features the chart editor cannot hold (3-D, stock, …). */
+    unsupported: string[];
+    /** Writing `spec` back loses nothing. */
+    lossless: boolean;
+}
+interface OfficeChartsResult {
+    format: OfficeChartFileFormat;
+    charts: OfficeFileChart[];
+}
+interface OfficeChartsReadOptions extends ZipReadOptions {
+    /** `DOMParser` constructor (default: the global one; pass jsdom's or xmldom's in Node). */
+    DOMParser?: ParserCtor$1;
+    /** Stop after this many charts (default 500). */
+    maxCharts?: number;
+}
+/** Thrown when the bytes are not a readable Office file of the expected kind. */
+declare class OfficeChartsError extends Error {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+/**
+ * Reads every chart in an Office file, detecting whether it is a workbook (charts on each
+ * worksheet's or chart sheet's drawing, with the sheet name and anchor cell), a presentation
+ * (charts on each slide, with the slide number) or a Word document (charts in the body).
+ * DrawingML and Office 2016 chartex parts are both read with `chartFromOoxml`; data comes
+ * from the cached values. Throws `OfficeChartsError` when the bytes are not an Office file.
+ */
+declare function extractOfficeCharts(bytes: ArrayBuffer | ArrayBufferView, options?: OfficeChartsReadOptions): Promise<OfficeChartsResult>;
+/** The charts in an Excel workbook (`xl/drawings/drawingN.xml` → `xl/charts/chartN.xml`), with sheet and anchor cell. */
+declare const extractXlsxCharts: (bytes: ArrayBuffer | ArrayBufferView, options?: OfficeChartsReadOptions) => Promise<OfficeFileChart[]>;
+/** The charts in a PowerPoint deck (`p:graphicFrame` → `ppt/charts/chartN.xml`), with their slide number. */
+declare const extractPptxCharts: (bytes: ArrayBuffer | ArrayBufferView, options?: OfficeChartsReadOptions) => Promise<OfficeFileChart[]>;
+/** The charts in the body of a Word document (`word/charts/chartN.xml`). */
+declare const extractDocxCharts: (bytes: ArrayBuffer | ArrayBufferView, options?: OfficeChartsReadOptions) => Promise<OfficeFileChart[]>;
+/** Where a chart sits, for labels: `Sheet1!B2`, `Slide 3`, `Document`. */
+declare function describeOfficeChartPlace(chart: OfficeFileChart): string;
+
+type ParserCtor = {
+    new (): DOMParser;
+};
+/** A file the host has opened and lets the agent read charts from. */
+interface OfficeChartFile {
+    name: string;
+    data: ArrayBuffer | ArrayBufferView;
+}
+interface OfficeChartToolProviderOptions {
+    /** Provider id (unique per registry). Default `office-charts`. */
+    id?: string;
+    /** Always prefix tool names with `<namespace>__`. */
+    namespace?: string;
+    /**
+     * Files the user opened. With it, the tools take a `file` name (and `list_open_files` lists
+     * them); without it, they take the file's bytes as base64 `data`.
+     */
+    files?: () => readonly OfficeChartFile[];
+    /** Enables `load_file_chart`, which replaces this chart with one from a file. */
+    controller?: ChartController;
+    /** The chart cannot be edited: `load_file_chart` is hidden. A string is the reason. */
+    readOnly?: boolean | string | (() => boolean | string);
+    /** `DOMParser` constructor (default: the global one). */
+    DOMParser?: ParserCtor;
+}
+/**
+ * Agent tools for reading charts out of Office files (`.xlsx`, `.pptx`, `.docx`), for a
+ * `ToolRegistry`. `list_file_charts` lists every chart with where it sits (sheet and anchor
+ * cell, slide number) and its read problems; `get_file_chart` returns one chart's full spec;
+ * with a `controller`, `load_file_chart` replaces that chart editor's chart with one of them
+ * as one undo step. With `files`, the tools address the files the user opened by name
+ * (`list_open_files`); otherwise they take the file as base64.
+ */
+declare function createOfficeChartToolProvider(options?: OfficeChartToolProviderOptions): AgentToolProvider;
+
+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 { Z as ZipReadOptions } from '../zip-4nG0YAH7.js';
 import '../HistoryManager-DWSLd6Tf.js';
 import '../types-DsiXGmjo.js';
 import '../schema-Di0CS6Pe.js';
@@ -30,6 +31,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%`,
@@ -255,6 +270,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
@@ -266,7 +314,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;
@@ -277,8 +325,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;
@@ -367,27 +419,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). */
@@ -684,12 +732,12 @@ declare function findMermaidCharts(text: string): FoundChartMermaid[];
 declare const CHART_OOXML_NS = "http://schemas.openxmlformats.org/drawingml/2006/chart";
 declare const CHART_OOXML_CONTENT_TYPE = "application/vnd.openxmlformats-officedocument.drawingml.chart+xml";
 declare const CHART_OOXML_RELATIONSHIP = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/chart";
-type ParserCtor$1 = {
+type ParserCtor$3 = {
     new (): DOMParser;
 };
 interface ChartOoxmlReadOptions {
     /** `DOMParser` constructor (default: the global one; pass jsdom's or xmldom's in Node). */
-    DOMParser?: ParserCtor$1;
+    DOMParser?: ParserCtor$3;
 }
 interface ChartOoxmlReadResult {
     spec: ChartSpec;
@@ -863,7 +911,7 @@ declare class ChartDirector {
     private performOne;
 }
 
-type ParserCtor = {
+type ParserCtor$2 = {
     new (): DOMParser;
 };
 interface ChartToolProviderOptions {
@@ -882,7 +930,7 @@ interface ChartToolProviderOptions {
         height: number;
     };
     /** Enables `import_chart_ooxml` (reading Office chart XML needs a DOMParser). Default: the global one, if any. */
-    DOMParser?: ParserCtor;
+    DOMParser?: ParserCtor$2;
     /**
      * Acts out `set_chart_values` and `select_chart_element` with a visible cursor (see
      * `ChartDirector`); each call is still one undo step. Without it, edits apply at once.
@@ -962,4 +1010,105 @@ declare function blendChartScenes(from: ChartScene | null, to: ChartScene, t: nu
 /** Ease-out cubic, for tweens. */
 declare const easeChartTween: (t: number) => number;
 
-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, 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, cyclePaletteColor, decimateChartPoints, describeChart, describeChartSelection, downloadChartPng, easeChartTween, 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 };
+type ParserCtor$1 = {
+    new (): DOMParser;
+};
+/** Office files charts can be read from. */
+type OfficeChartFileFormat = 'xlsx' | 'pptx' | 'docx';
+/** A chart found in an Excel workbook, PowerPoint deck or Word document. */
+interface OfficeFileChart {
+    /** `chart-1`, `chart-2`, … in file order (sheets, slides or the document body). */
+    id: string;
+    /** The chart part, e.g. `xl/charts/chart1.xml` or `ppt/charts/chartEx1.xml`. */
+    path: string;
+    /** `chart` for DrawingML (`c:chartSpace`), `chartex` for Office 2016 charts (`cx:chartSpace`). */
+    partKind: 'chart' | 'chartex';
+    /** Worksheet or chart sheet name (xlsx). */
+    sheet?: string;
+    /** 1-based slide number (pptx). */
+    slide?: number;
+    /** Top-left cell the chart is anchored to, e.g. `B2` (xlsx worksheets). */
+    anchor?: string;
+    /** The cells the chart covers, e.g. `B2:H18` (xlsx two-cell anchors). */
+    range?: string;
+    /** The shape name (`cNvPr name`), e.g. `Chart 3`. */
+    name?: string;
+    /** The chart's title (may be empty). */
+    title: string;
+    spec: ChartSpec;
+    /** Problems reading it, as sentences. */
+    issues: string[];
+    /** Features the chart editor cannot hold (3-D, stock, …). */
+    unsupported: string[];
+    /** Writing `spec` back loses nothing. */
+    lossless: boolean;
+}
+interface OfficeChartsResult {
+    format: OfficeChartFileFormat;
+    charts: OfficeFileChart[];
+}
+interface OfficeChartsReadOptions extends ZipReadOptions {
+    /** `DOMParser` constructor (default: the global one; pass jsdom's or xmldom's in Node). */
+    DOMParser?: ParserCtor$1;
+    /** Stop after this many charts (default 500). */
+    maxCharts?: number;
+}
+/** Thrown when the bytes are not a readable Office file of the expected kind. */
+declare class OfficeChartsError extends Error {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+/**
+ * Reads every chart in an Office file, detecting whether it is a workbook (charts on each
+ * worksheet's or chart sheet's drawing, with the sheet name and anchor cell), a presentation
+ * (charts on each slide, with the slide number) or a Word document (charts in the body).
+ * DrawingML and Office 2016 chartex parts are both read with `chartFromOoxml`; data comes
+ * from the cached values. Throws `OfficeChartsError` when the bytes are not an Office file.
+ */
+declare function extractOfficeCharts(bytes: ArrayBuffer | ArrayBufferView, options?: OfficeChartsReadOptions): Promise<OfficeChartsResult>;
+/** The charts in an Excel workbook (`xl/drawings/drawingN.xml` → `xl/charts/chartN.xml`), with sheet and anchor cell. */
+declare const extractXlsxCharts: (bytes: ArrayBuffer | ArrayBufferView, options?: OfficeChartsReadOptions) => Promise<OfficeFileChart[]>;
+/** The charts in a PowerPoint deck (`p:graphicFrame` → `ppt/charts/chartN.xml`), with their slide number. */
+declare const extractPptxCharts: (bytes: ArrayBuffer | ArrayBufferView, options?: OfficeChartsReadOptions) => Promise<OfficeFileChart[]>;
+/** The charts in the body of a Word document (`word/charts/chartN.xml`). */
+declare const extractDocxCharts: (bytes: ArrayBuffer | ArrayBufferView, options?: OfficeChartsReadOptions) => Promise<OfficeFileChart[]>;
+/** Where a chart sits, for labels: `Sheet1!B2`, `Slide 3`, `Document`. */
+declare function describeOfficeChartPlace(chart: OfficeFileChart): string;
+
+type ParserCtor = {
+    new (): DOMParser;
+};
+/** A file the host has opened and lets the agent read charts from. */
+interface OfficeChartFile {
+    name: string;
+    data: ArrayBuffer | ArrayBufferView;
+}
+interface OfficeChartToolProviderOptions {
+    /** Provider id (unique per registry). Default `office-charts`. */
+    id?: string;
+    /** Always prefix tool names with `<namespace>__`. */
+    namespace?: string;
+    /**
+     * Files the user opened. With it, the tools take a `file` name (and `list_open_files` lists
+     * them); without it, they take the file's bytes as base64 `data`.
+     */
+    files?: () => readonly OfficeChartFile[];
+    /** Enables `load_file_chart`, which replaces this chart with one from a file. */
+    controller?: ChartController;
+    /** The chart cannot be edited: `load_file_chart` is hidden. A string is the reason. */
+    readOnly?: boolean | string | (() => boolean | string);
+    /** `DOMParser` constructor (default: the global one). */
+    DOMParser?: ParserCtor;
+}
+/**
+ * Agent tools for reading charts out of Office files (`.xlsx`, `.pptx`, `.docx`), for a
+ * `ToolRegistry`. `list_file_charts` lists every chart with where it sits (sheet and anchor
+ * cell, slide number) and its read problems; `get_file_chart` returns one chart's full spec;
+ * with a `controller`, `load_file_chart` replaces that chart editor's chart with one of them
+ * as one undo step. With `files`, the tools address the files the user opened by name
+ * (`list_open_files`); otherwise they take the file as base64.
+ */
+declare function createOfficeChartToolProvider(options?: OfficeChartToolProviderOptions): AgentToolProvider;
+
+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 };