@pixerate/editor 0.50.0 → 0.51.0

package/dist/chart/index.d.cts

@@ -1,5 +1,5 @@
-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 '../HistoryManager-DeQQMBCj.cjs';
@@ -287,6 +287,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;
@@ -822,6 +902,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 +962,4 @@ 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 };
+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 };

package/dist/chart/index.d.ts

@@ -1,5 +1,5 @@
-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 '../HistoryManager-DWSLd6Tf.js';
@@ -287,6 +287,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;
@@ -822,6 +902,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 +962,4 @@ 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 };
+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 };

package/dist/chart/index.js

@@ -128,6 +128,127 @@ import {
 } from "../chunk-664LQYFJ.js";
 import "../chunk-QVZZGT4X.js";
 
+// src/chart/raster.ts
+var CHART_RASTER_MAX_SIZE = 1024;
+function chartRasterSize(width, height, scale = 2, maxSize = CHART_RASTER_MAX_SIZE) {
+  if (!(width > 0) || !(height > 0)) throw new Error(`A chart image needs a positive width and height; got ${width} \xD7 ${height}.`);
+  const factor = Math.min(scale > 0 ? scale : 1, maxSize / Math.max(width, height));
+  return { width: Math.max(1, Math.round(width * factor)), height: Math.max(1, Math.round(height * factor)), scale: factor };
+}
+function closingParen(text, open) {
+  let depth = 0;
+  for (let i = open; i < text.length; i++) {
+    if (text[i] === "(") depth++;
+    else if (text[i] === ")" && --depth === 0) return i + 1;
+  }
+  return -1;
+}
+function substituteVars(value, lookup, depth = 0) {
+  let out = "";
+  let i = 0;
+  for (let at = value.indexOf("var(", i); at !== -1; at = value.indexOf("var(", i)) {
+    const end = closingParen(value, at + 3);
+    if (end === -1) break;
+    const inner = value.slice(at + 4, end - 1);
+    let comma = -1;
+    for (let j = 0, d = 0; j < inner.length; j++) {
+      if (inner[j] === "(") d++;
+      else if (inner[j] === ")") d--;
+      else if (inner[j] === "," && d === 0) {
+        comma = j;
+        break;
+      }
+    }
+    const name = (comma === -1 ? inner : inner.slice(0, comma)).trim();
+    const fallback = comma === -1 ? "" : inner.slice(comma + 1).trim();
+    const found = lookup(name).trim();
+    const resolved = found || fallback;
+    out += value.slice(i, at) + (depth < 8 && resolved.includes("var(") ? substituteVars(resolved, lookup, depth + 1) : resolved);
+    i = end;
+  }
+  return out + value.slice(i);
+}
+var PAINT_ATTRIBUTE = /(\s)([\w:-]+)="([^"]*)"/g;
+function resolveChartSvgPaints(svg, options = {}) {
+  const doc = globalThis.document;
+  const scope = options.scope ?? doc?.documentElement ?? null;
+  const view = scope?.ownerDocument?.defaultView ?? globalThis;
+  let computed;
+  const style = () => {
+    if (computed === void 0) computed = scope && typeof view?.getComputedStyle === "function" ? view.getComputedStyle(scope) : null;
+    return computed;
+  };
+  const lookup = options.lookup ?? ((name) => style()?.getPropertyValue(name) ?? "");
+  return svg.replace(PAINT_ATTRIBUTE, (match, space, name, raw) => {
+    let value = raw;
+    if (value.includes("var(")) value = substituteVars(value.replace(/&quot;/g, '"'), lookup).replace(/"/g, "&quot;");
+    if (/currentcolor/i.test(value)) value = value.replace(/currentcolor/gi, style()?.color || "#000000");
+    if (name === "font-family" && /^(inherit|unset|initial)$/i.test(value.trim())) value = (style()?.fontFamily || "sans-serif").replace(/"/g, "'");
+    if (value === raw) return match;
+    return value.trim() ? `${space}${name}="${value}"` : "";
+  });
+}
+var NO_DOM = 'Rasterizing a chart needs a browser DOM (document, Image and a 2D canvas). Outside a browser, render SVG with chartToSvg (or render_chart with format "svg") and convert it with an SVG renderer, or pass your own rasterize option to createChartToolProvider.';
+async function svgToPngDataUrl(svg, options) {
+  const doc = options.document ?? globalThis.document;
+  const ImageCtor = doc?.defaultView?.Image ?? globalThis.Image;
+  if (!doc || typeof doc.createElement !== "function" || !ImageCtor) throw new Error(NO_DOM);
+  const size = chartRasterSize(options.width, options.height, options.scale, options.maxSize);
+  const canvas = doc.createElement("canvas");
+  canvas.width = size.width;
+  canvas.height = size.height;
+  let context = null;
+  try {
+    context = canvas.getContext("2d");
+  } catch {
+    context = null;
+  }
+  if (!context) throw new Error(NO_DOM);
+  const drawable = resolveChartSvgPaints(svg, options);
+  const image = new ImageCtor();
+  await new Promise((resolve2, reject) => {
+    image.onload = () => resolve2();
+    image.onerror = () => reject(new Error("The chart SVG could not be loaded as an image; check that it is a complete <svg> document with the SVG namespace."));
+    image.src = `data:image/svg+xml;charset=utf-8,${encodeURIComponent(drawable)}`;
+  });
+  const background = options.background ?? "#ffffff";
+  if (background !== "transparent") {
+    context.fillStyle = background;
+    context.fillRect(0, 0, size.width, size.height);
+  }
+  context.drawImage(image, 0, 0, size.width, size.height);
+  const url = canvas.toDataURL("image/png");
+  if (!url.startsWith("data:image/png")) throw new Error("This canvas cannot export PNG (toDataURL returned no image).");
+  return { url, width: size.width, height: size.height };
+}
+async function rasterizeChartSvg(svg, options) {
+  const { url, width, height } = await svgToPngDataUrl(svg, options);
+  return { data: url.slice(url.indexOf(",") + 1), mimeType: "image/png", width, height };
+}
+function createChartRasterizer(options = {}) {
+  const doc = options.document ?? globalThis.document;
+  if (!doc || typeof doc.createElement !== "function") return void 0;
+  return (svg, size) => rasterizeChartSvg(svg, { ...options, ...size });
+}
+function chartFileName(spec, extension) {
+  const base = (spec.title ?? "").toLowerCase().replace(/[^\p{L}\p{N}]+/gu, "-").replace(/^-+|-+$/g, "").slice(0, 60);
+  return `${base || "chart"}.${extension}`;
+}
+async function downloadChartPng(spec, options = {}) {
+  const { width = 800, height = 450, filename = chartFileName(spec, "png"), theme, ...raster } = options;
+  const svg = chartToSvg(spec, { width, height, theme });
+  const { url, width: w, height: h } = await svgToPngDataUrl(svg, { ...raster, width, height });
+  const doc = raster.document ?? globalThis.document;
+  const link = doc.createElement("a");
+  link.href = url;
+  link.download = filename;
+  link.style.display = "none";
+  doc.body?.appendChild(link);
+  link.click();
+  link.remove();
+  return { data: url.slice(url.indexOf(",") + 1), mimeType: "image/png", width: w, height: h, filename };
+}
+
 // src/chart/recommend.ts
 var blank = (c) => c === null || c === void 0 || String(c).trim() === "";
 var isText = (c) => blank(c) || parseChartValue(c) === void 0;
@@ -763,6 +884,7 @@ function chartHitTest(scene, point, measure = (t, s, w = 400) => t.length * s *
 }
 
 // src/chart/tools.ts
+var 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.';
 var READ = { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false };
 var WRITE = { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false };
 var WRITE_IDEMPOTENT = { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false };
@@ -817,21 +939,36 @@ function createChartToolProvider(controller, options = {}) {
   const renderChart = {
     name: "render_chart",
     title: "Render the chart",
-    description: 'Draws the chart without changing it, to check it visually: SVG text by default, or a PNG image (format "png") when the host can rasterize. Look for overlapping or hidden labels; get_chart lists layout warnings without a render.',
+    description: RENDER_CHART_INSTRUCTIONS,
     inputSchema: {
       type: "object",
-      properties: { width: WIDTH, height: HEIGHT, format: { type: "string", enum: ["svg", "png"], description: "svg (default) or png (only when the host supports it)." } },
+      properties: {
+        width: WIDTH,
+        height: HEIGHT,
+        format: { type: "string", enum: ["svg", "png"], description: "svg (default): the SVG document as text. png: an image to look at (only when the host can rasterize; costs image tokens)." }
+      },
       additionalProperties: false
     },
     annotations: { title: "Render the chart", ...READ },
     handler: async ({ width = size.width, height = size.height, format = "svg" }) => {
-      const svg = chartToSvg(controller.toJSON(), { width, height });
+      const json = controller.toJSON();
+      const scene = layoutChart(json, { width, height, selection: null });
+      const svg = chartSceneToSvg(scene, { ariaLabel: json.title || void 0, description: describeChart(json) });
+      const warnings = scene.warnings;
       if (format === "png") {
-        if (!options.rasterize) fail2('This host cannot rasterize charts; call render_chart with format "svg".');
+        if (!options.rasterize) fail2('This host cannot rasterize charts; call render_chart with format "svg", or get_chart for the layout warnings.');
         const image = await options.rasterize(svg, { width, height });
-        return { content: [{ type: "image", data: image.data, mimeType: image.mimeType }], structuredContent: { width, height, mimeType: image.mimeType } };
+        const info = { width, height, mimeType: image.mimeType, warnings };
+        const note = warnings.length ? `Layout warnings: ${warnings.map((w) => w.message).join(" ")}` : "No layout warnings.";
+        return {
+          content: [
+            { type: "image", data: image.data, mimeType: image.mimeType },
+            { type: "text", text: `Chart at ${width} \xD7 ${height}. ${note}` }
+          ],
+          structuredContent: info
+        };
       }
-      return { svg, width, height };
+      return { svg, width, height, warnings };
     }
   };
   const checkColors = {
@@ -1683,6 +1820,7 @@ export {
   CHART_ORIENTATIONS,
   CHART_PALETTE_SHADES,
   CHART_PRESENCE_COLORS,
+  CHART_RASTER_MAX_SIZE,
   CHART_SERIES_TYPES,
   CHART_STACKINGS,
   CHART_TRENDLINE_TYPES,
@@ -1698,6 +1836,7 @@ export {
   MAX_CHART_DATA_LABELS,
   MAX_CHART_LINE_POINTS,
   MAX_CHART_MARKERS,
+  RENDER_CHART_INSTRUCTIONS,
   analyzeChartTable,
   blendChartScenes,
   canDragChartPoint,
@@ -1712,6 +1851,7 @@ export {
   chartDateLabels,
   chartDateToSerial,
   chartFamily,
+  chartFileName,
   chartFormatToCode,
   chartFromMermaid,
   chartFromOoxml,
@@ -1725,6 +1865,7 @@ export {
   chartPointColor,
   chartPresetPatch,
   chartQuantile,
+  chartRasterSize,
   chartRgbToHex,
   chartRgbToOklab,
   chartSceneToDomSpec,
@@ -1751,6 +1892,7 @@ export {
   contrastingTextColor,
   createChartCommands,
   createChartController,
+  createChartRasterizer,
   createChartSpec,
   createChartToolProvider,
   createInstantChartClock,
@@ -1759,6 +1901,7 @@ export {
   defaultChartAxis,
   describeChart,
   describeChartSelection,
+  downloadChartPng,
   easeChartTween,
   estimateChartTextWidth,
   findMermaidCharts,
@@ -1784,9 +1927,11 @@ export {
   parseChartValue,
   parsePartialChartJson,
   planChartCommand,
+  rasterizeChartSvg,
   realChartClock,
   recommendChartTypes,
   recommendForShape,
+  resolveChartSvgPaints,
   sameChartSelection,
   shadeChartColor,
   simulateChartVision,