@pixerate/editor 0.50.0 → 0.52.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 ChartWarning, g as ChartAxis, h as ChartLegend, i as ChartType, j as ChartStacking, k as ChartSeries, l as ChartIssue, m as ChartController, n as ChartValueScale, o as ChartSelection, p as ChartSpecPatch } from '../controller-ChjCCMLl.cjs';
-export { q as CHART_AXIS_KINDS, r as CHART_CURVES, s as CHART_LABEL_POSITIONS, t as CHART_LEGEND_POSITIONS, u as CHART_MARKERS, v as CHART_NUMBER_STYLES, w as CHART_ORIENTATIONS, x as CHART_SERIES_TYPES, y as CHART_STACKINGS, z as CHART_TRENDLINE_TYPES, A as CHART_TYPES, B as CHART_TYPE_LABELS, D as CSS_VARIABLE_CHART_THEME, E as ChartActionResult, F as ChartCircleMark, G as ChartControllerOptions, H as ChartCurve, I as ChartDomSpec, J as ChartEditOptions, K as ChartFamily, L as ChartLabelPosition, M as ChartLegendPosition, N as ChartLineMark, O as ChartMark, P as ChartMarkRole, Q as ChartMarker, R as ChartOrientation, S as ChartPathMark, T as ChartRectMark, U as ChartSeriesInput, V as ChartSeriesPatch, W as ChartSeriesType, X as ChartSparklineKind, Y as ChartSparklineOptions, Z as ChartState, _ as ChartSvgOptions, $ as ChartTableData, a0 as ChartTableOptions, a1 as ChartTextMark, a2 as ChartTextMeasure, a3 as ChartTheme, 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-ChjCCMLl.cjs';
+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 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';
@@ -287,6 +288,86 @@ declare const MAX_CHART_LINE_POINTS = 2000;
 /** Markers beyond this many are thinned to one per 2px cell. */
 declare const MAX_CHART_MARKERS = 1000;
 
+/** Longest side, in pixels, of a rasterized chart unless `maxSize` says otherwise. */
+declare const CHART_RASTER_MAX_SIZE = 1024;
+interface ChartPaintScope {
+    /**
+     * Element whose CSS variables, `color` and `font-family` stand in for `var(--x)`,
+     * `currentColor` and `inherit` (default: the document's root element). Pass the chart's
+     * container when its theme is scoped (e.g. a `.dark` wrapper).
+     */
+    scope?: Element | null;
+    /** Looks up a custom property (`--name`) instead of `getComputedStyle(scope)`. Return '' when unset. */
+    lookup?: (name: string) => string;
+}
+interface RasterizeChartOptions extends ChartPaintScope {
+    /** Size of the chart in CSS pixels (the SVG's own size). */
+    width: number;
+    height: number;
+    /** Pixels per CSS pixel (default 2), reduced so the longest side stays within `maxSize`. */
+    scale?: number;
+    /** Longest side of the image in pixels (default 1024). */
+    maxSize?: number;
+    /** Fill behind the chart (default white; `transparent` keeps the alpha channel). */
+    background?: string;
+    /** Document to create the canvas and image in (default: the global one). */
+    document?: Document;
+}
+interface ChartRasterImage {
+    /** Base64 PNG, without the `data:` prefix. */
+    data: string;
+    mimeType: 'image/png';
+    /** Size of the image in pixels. */
+    width: number;
+    height: number;
+}
+/** Pixel size of the image for a chart of `width` × `height` CSS pixels: `scale` × the size, longest side ≤ `maxSize`. */
+declare function chartRasterSize(width: number, height: number, scale?: number, maxSize?: number): {
+    width: number;
+    height: number;
+    scale: number;
+};
+/**
+ * Makes a chart SVG drawable on its own (as an `<img>` or on a canvas, where the page's CSS
+ * does not apply): `var(--x, fallback)` becomes the variable's value on `scope` (or the
+ * fallback), `currentColor` the scope's colour and `font-family="inherit"` its font. An
+ * attribute left empty is dropped, so the renderer's default applies instead of an invalid
+ * paint. Text content is left alone.
+ */
+declare function resolveChartSvgPaints(svg: string, options?: ChartPaintScope): string;
+/**
+ * Turns a chart SVG (from `chartToSvg`, `chartSceneToSvg` or a live chart's `<svg>`) into a
+ * PNG in the browser: resolves CSS-variable paints first (see `resolveChartSvgPaints`, without
+ * which they draw black), draws it through an `Image` onto a canvas at `scale` (longest side
+ * ≤ `maxSize`, default 1024) over `background`, and returns base64 data. Throws a message
+ * saying what to do instead when there is no DOM or canvas.
+ */
+declare function rasterizeChartSvg(svg: string, options: RasterizeChartOptions): Promise<ChartRasterImage>;
+/**
+ * A `rasterize` function for `createChartToolProvider` (so `render_chart { format: "png" }`
+ * works), or `undefined` when there is no DOM to draw with. The React and Svelte
+ * `useChartToolProvider` pass one by default.
+ */
+declare function createChartRasterizer(options?: Omit<RasterizeChartOptions, 'width' | 'height'>): ((svg: string, size: {
+    width: number;
+    height: number;
+}) => Promise<ChartRasterImage>) | undefined;
+interface DownloadChartPngOptions extends Omit<RasterizeChartOptions, 'width' | 'height'> {
+    /** Chart size in CSS pixels (default 800 × 450). */
+    width?: number;
+    height?: number;
+    /** File name (default: the chart title, else `chart`, plus `.png`). */
+    filename?: string;
+    /** Colours and type (default: the light default theme, with concrete colours). */
+    theme?: Partial<ChartTheme>;
+}
+/** A file name for a chart: its title in lower case with dashes, else `chart`, plus the extension. */
+declare function chartFileName(spec: Pick<ChartSpec, 'title'>, extension: string): string;
+/** Renders a chart to PNG (see `rasterizeChartSvg`) and saves it through a download link. Returns the image and the file name. */
+declare function downloadChartPng(spec: ChartSpec, options?: DownloadChartPngOptions): Promise<ChartRasterImage & {
+    filename: string;
+}>;
+
 interface ChartSummary {
     type: ChartSpec['type'];
     title: string;
@@ -604,12 +685,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;
@@ -783,7 +864,7 @@ declare class ChartDirector {
     private performOne;
 }
 
-type ParserCtor = {
+type ParserCtor$2 = {
     new (): DOMParser;
 };
 interface ChartToolProviderOptions {
@@ -802,7 +883,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.
@@ -822,6 +903,11 @@ interface ChartToolProviderOptions {
         mimeType: string;
     };
 }
+/**
+ * When to look at the chart, for `render_chart`'s description (after vectorcraft's
+ * `render_preview` and Ursula's VIEW_DIAGRAM_INSTRUCTIONS).
+ */
+declare const RENDER_CHART_INSTRUCTIONS = "Draws the chart without changing it so you can check how it looks: SVG text by default, or a PNG image with format \"png\" when the host can rasterize. Returns the layout warnings (hidden or thinned labels, dropped markers) alongside. An image costs tokens, so render after a batch of edits rather than after each one, and use it to check what text cannot tell you: overlapping or cut-off labels, a crowded legend, unreadable colours, whether the chart reads at the given size. For values, ids and warnings alone, get_chart is cheaper.";
 /**
  * Agent tools for a chart editor, for a `ToolRegistry`: one tool per operation with strict
  * schemas. Reads (`get_chart`, `render_chart`, `check_chart_colors`, `recommend_chart`,
@@ -877,4 +963,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, 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 ChartPerformanceResult, type ChartPerformanceStep, type ChartPointDrag, ChartPresence, type ChartPresenceActor, type ChartPresenceState, type ChartPresetPatch, type ChartRecommendation, ChartRect, type ChartRgb, ChartScene, ChartSelection, ChartSeries, type ChartSeriesSummary, type ChartSnapOptions, ChartSpec, ChartSpecPatch, ChartStacking, ChartStream, type ChartStreamFormat, type ChartStreamResult, type ChartSummary, type ChartTableShape, type ChartToolProviderOptions, ChartType, ChartValue, ChartValueScale, type ChartVision, ChartWarning, type FoundChartMermaid, MAX_CHART_DATA_LABELS, MAX_CHART_LINE_POINTS, MAX_CHART_MARKERS, type NiceScale, analyzeChartTable, blendChartScenes, canDragChartPoint, chartBoxStats, chartClientToScene, chartColorDistance, chartContrastRatio, chartDateLabels, chartDateToSerial, chartFormatToCode, chartFromMermaid, chartFromOoxml, chartFromTable, chartHistogram, chartHitTest, chartLuminance, chartMermaidFamily, chartPointAnchor, chartPresetPatch, chartQuantile, chartRgbToHex, chartRgbToOklab, chartSerialToDate, chartSquarify, chartTextOn, chartToMermaid, chartToOoxml, chartValueAtPoint, chartXAtPoint, checkChartColors, compileChartFormatCode, createChartCommands, createChartToolProvider, createInstantChartClock, cyclePaletteColor, decimateChartPoints, describeChart, describeChartSelection, easeChartTween, findMermaidCharts, formatChartDate, formatChartNumber, formatChartValueWithCode, handleChartKey, layoutChart, linearMap, monochromeChartPalette, niceScale, niceStep, parseChartColor, parseChartDate, parsePartialChartJson, planChartCommand, realChartClock, recommendChartTypes, recommendForShape, 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_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 };

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 ChartWarning, g as ChartAxis, h as ChartLegend, i as ChartType, j as ChartStacking, k as ChartSeries, l as ChartIssue, m as ChartController, n as ChartValueScale, o as ChartSelection, p as ChartSpecPatch } from '../controller-DtbEo3om.js';
-export { q as CHART_AXIS_KINDS, r as CHART_CURVES, s as CHART_LABEL_POSITIONS, t as CHART_LEGEND_POSITIONS, u as CHART_MARKERS, v as CHART_NUMBER_STYLES, w as CHART_ORIENTATIONS, x as CHART_SERIES_TYPES, y as CHART_STACKINGS, z as CHART_TRENDLINE_TYPES, A as CHART_TYPES, B as CHART_TYPE_LABELS, D as CSS_VARIABLE_CHART_THEME, E as ChartActionResult, F as ChartCircleMark, G as ChartControllerOptions, H as ChartCurve, I as ChartDomSpec, J as ChartEditOptions, K as ChartFamily, L as ChartLabelPosition, M as ChartLegendPosition, N as ChartLineMark, O as ChartMark, P as ChartMarkRole, Q as ChartMarker, R as ChartOrientation, S as ChartPathMark, T as ChartRectMark, U as ChartSeriesInput, V as ChartSeriesPatch, W as ChartSeriesType, X as ChartSparklineKind, Y as ChartSparklineOptions, Z as ChartState, _ as ChartSvgOptions, $ as ChartTableData, a0 as ChartTableOptions, a1 as ChartTextMark, a2 as ChartTextMeasure, a3 as ChartTheme, 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-DtbEo3om.js';
+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 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';
@@ -287,6 +288,86 @@ declare const MAX_CHART_LINE_POINTS = 2000;
 /** Markers beyond this many are thinned to one per 2px cell. */
 declare const MAX_CHART_MARKERS = 1000;
 
+/** Longest side, in pixels, of a rasterized chart unless `maxSize` says otherwise. */
+declare const CHART_RASTER_MAX_SIZE = 1024;
+interface ChartPaintScope {
+    /**
+     * Element whose CSS variables, `color` and `font-family` stand in for `var(--x)`,
+     * `currentColor` and `inherit` (default: the document's root element). Pass the chart's
+     * container when its theme is scoped (e.g. a `.dark` wrapper).
+     */
+    scope?: Element | null;
+    /** Looks up a custom property (`--name`) instead of `getComputedStyle(scope)`. Return '' when unset. */
+    lookup?: (name: string) => string;
+}
+interface RasterizeChartOptions extends ChartPaintScope {
+    /** Size of the chart in CSS pixels (the SVG's own size). */
+    width: number;
+    height: number;
+    /** Pixels per CSS pixel (default 2), reduced so the longest side stays within `maxSize`. */
+    scale?: number;
+    /** Longest side of the image in pixels (default 1024). */
+    maxSize?: number;
+    /** Fill behind the chart (default white; `transparent` keeps the alpha channel). */
+    background?: string;
+    /** Document to create the canvas and image in (default: the global one). */
+    document?: Document;
+}
+interface ChartRasterImage {
+    /** Base64 PNG, without the `data:` prefix. */
+    data: string;
+    mimeType: 'image/png';
+    /** Size of the image in pixels. */
+    width: number;
+    height: number;
+}
+/** Pixel size of the image for a chart of `width` × `height` CSS pixels: `scale` × the size, longest side ≤ `maxSize`. */
+declare function chartRasterSize(width: number, height: number, scale?: number, maxSize?: number): {
+    width: number;
+    height: number;
+    scale: number;
+};
+/**
+ * Makes a chart SVG drawable on its own (as an `<img>` or on a canvas, where the page's CSS
+ * does not apply): `var(--x, fallback)` becomes the variable's value on `scope` (or the
+ * fallback), `currentColor` the scope's colour and `font-family="inherit"` its font. An
+ * attribute left empty is dropped, so the renderer's default applies instead of an invalid
+ * paint. Text content is left alone.
+ */
+declare function resolveChartSvgPaints(svg: string, options?: ChartPaintScope): string;
+/**
+ * Turns a chart SVG (from `chartToSvg`, `chartSceneToSvg` or a live chart's `<svg>`) into a
+ * PNG in the browser: resolves CSS-variable paints first (see `resolveChartSvgPaints`, without
+ * which they draw black), draws it through an `Image` onto a canvas at `scale` (longest side
+ * ≤ `maxSize`, default 1024) over `background`, and returns base64 data. Throws a message
+ * saying what to do instead when there is no DOM or canvas.
+ */
+declare function rasterizeChartSvg(svg: string, options: RasterizeChartOptions): Promise<ChartRasterImage>;
+/**
+ * A `rasterize` function for `createChartToolProvider` (so `render_chart { format: "png" }`
+ * works), or `undefined` when there is no DOM to draw with. The React and Svelte
+ * `useChartToolProvider` pass one by default.
+ */
+declare function createChartRasterizer(options?: Omit<RasterizeChartOptions, 'width' | 'height'>): ((svg: string, size: {
+    width: number;
+    height: number;
+}) => Promise<ChartRasterImage>) | undefined;
+interface DownloadChartPngOptions extends Omit<RasterizeChartOptions, 'width' | 'height'> {
+    /** Chart size in CSS pixels (default 800 × 450). */
+    width?: number;
+    height?: number;
+    /** File name (default: the chart title, else `chart`, plus `.png`). */
+    filename?: string;
+    /** Colours and type (default: the light default theme, with concrete colours). */
+    theme?: Partial<ChartTheme>;
+}
+/** A file name for a chart: its title in lower case with dashes, else `chart`, plus the extension. */
+declare function chartFileName(spec: Pick<ChartSpec, 'title'>, extension: string): string;
+/** Renders a chart to PNG (see `rasterizeChartSvg`) and saves it through a download link. Returns the image and the file name. */
+declare function downloadChartPng(spec: ChartSpec, options?: DownloadChartPngOptions): Promise<ChartRasterImage & {
+    filename: string;
+}>;
+
 interface ChartSummary {
     type: ChartSpec['type'];
     title: string;
@@ -604,12 +685,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;
@@ -783,7 +864,7 @@ declare class ChartDirector {
     private performOne;
 }
 
-type ParserCtor = {
+type ParserCtor$2 = {
     new (): DOMParser;
 };
 interface ChartToolProviderOptions {
@@ -802,7 +883,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.
@@ -822,6 +903,11 @@ interface ChartToolProviderOptions {
         mimeType: string;
     };
 }
+/**
+ * When to look at the chart, for `render_chart`'s description (after vectorcraft's
+ * `render_preview` and Ursula's VIEW_DIAGRAM_INSTRUCTIONS).
+ */
+declare const RENDER_CHART_INSTRUCTIONS = "Draws the chart without changing it so you can check how it looks: SVG text by default, or a PNG image with format \"png\" when the host can rasterize. Returns the layout warnings (hidden or thinned labels, dropped markers) alongside. An image costs tokens, so render after a batch of edits rather than after each one, and use it to check what text cannot tell you: overlapping or cut-off labels, a crowded legend, unreadable colours, whether the chart reads at the given size. For values, ids and warnings alone, get_chart is cheaper.";
 /**
  * Agent tools for a chart editor, for a `ToolRegistry`: one tool per operation with strict
  * schemas. Reads (`get_chart`, `render_chart`, `check_chart_colors`, `recommend_chart`,
@@ -877,4 +963,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, 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 ChartPerformanceResult, type ChartPerformanceStep, type ChartPointDrag, ChartPresence, type ChartPresenceActor, type ChartPresenceState, type ChartPresetPatch, type ChartRecommendation, ChartRect, type ChartRgb, ChartScene, ChartSelection, ChartSeries, type ChartSeriesSummary, type ChartSnapOptions, ChartSpec, ChartSpecPatch, ChartStacking, ChartStream, type ChartStreamFormat, type ChartStreamResult, type ChartSummary, type ChartTableShape, type ChartToolProviderOptions, ChartType, ChartValue, ChartValueScale, type ChartVision, ChartWarning, type FoundChartMermaid, MAX_CHART_DATA_LABELS, MAX_CHART_LINE_POINTS, MAX_CHART_MARKERS, type NiceScale, analyzeChartTable, blendChartScenes, canDragChartPoint, chartBoxStats, chartClientToScene, chartColorDistance, chartContrastRatio, chartDateLabels, chartDateToSerial, chartFormatToCode, chartFromMermaid, chartFromOoxml, chartFromTable, chartHistogram, chartHitTest, chartLuminance, chartMermaidFamily, chartPointAnchor, chartPresetPatch, chartQuantile, chartRgbToHex, chartRgbToOklab, chartSerialToDate, chartSquarify, chartTextOn, chartToMermaid, chartToOoxml, chartValueAtPoint, chartXAtPoint, checkChartColors, compileChartFormatCode, createChartCommands, createChartToolProvider, createInstantChartClock, cyclePaletteColor, decimateChartPoints, describeChart, describeChartSelection, easeChartTween, findMermaidCharts, formatChartDate, formatChartNumber, formatChartValueWithCode, handleChartKey, layoutChart, linearMap, monochromeChartPalette, niceScale, niceStep, parseChartColor, parseChartDate, parsePartialChartJson, planChartCommand, realChartClock, recommendChartTypes, recommendForShape, 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_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 };