@pixerate/editor 0.51.0 → 0.52.0

package/dist/chart/index.d.cts

@@ -2,6 +2,7 @@ import { C as ChartNumberFormat, a as ChartValue, b as ChartRect, c as ChartScen
 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';
@@ -684,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;
@@ -863,7 +864,7 @@ declare class ChartDirector {
     private performOne;
 }
 
-type ParserCtor = {
+type ParserCtor$2 = {
     new (): DOMParser;
 };
 interface ChartToolProviderOptions {
@@ -882,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.
@@ -962,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, 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_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

@@ -2,6 +2,7 @@ import { C as ChartNumberFormat, a as ChartValue, b as ChartRect, c as ChartScen
 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';
@@ -684,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;
@@ -863,7 +864,7 @@ declare class ChartDirector {
     private performOne;
 }
 
-type ParserCtor = {
+type ParserCtor$2 = {
     new (): DOMParser;
 };
 interface ChartToolProviderOptions {
@@ -882,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.
@@ -962,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, 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_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 };