@pixerate/editor 0.47.0 → 0.48.0

package/dist/chart/index.d.cts

@@ -1,113 +1,11 @@
-import { C as ChartAxis, a as ChartCurve, b as ChartLabelPosition, c as ChartLegendPosition, d as ChartMarker, e as ChartNumberFormat, f as ChartOrientation, g as ChartSeriesType, h as ChartStacking, i as ChartTrendlineType, j as ChartType, k as ChartTheme, l as ChartSeries, m as ChartIssue, n as ChartSpec, o as ChartTrendline, p as ChartValue, q as ChartRect, r as ChartSelection, s as ChartScene, t as ChartTextMark, u as ChartWarning, v as ChartLegend, w as ChartValueScale } from '../types-BVqWm3d1.cjs';
-export { x as ChartCircleMark, y as ChartLineMark, z as ChartMark, A as ChartMarkRole, B as ChartPathMark, D as ChartRectMark } from '../types-BVqWm3d1.cjs';
-import { H as HistoryManager } from '../HistoryManager-DeQQMBCj.cjs';
+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 CommandSpec } from '../registry-CaR7LC6W.cjs';
 import { A as AgentToolProvider } from '../registry-B4l-lYts.cjs';
+import '../HistoryManager-DeQQMBCj.cjs';
 import '../types-DsiXGmjo.cjs';
 import '../schema-Di0CS6Pe.cjs';
 
-declare const CHART_TYPES: readonly ChartType[];
-declare const CHART_MARKERS: readonly ChartMarker[];
-declare const CHART_TRENDLINE_TYPES: readonly ChartTrendlineType[];
-declare const CHART_LABEL_POSITIONS: readonly ChartLabelPosition[];
-declare const CHART_AXIS_KINDS: readonly NonNullable<ChartAxis['kind']>[];
-declare const CHART_SERIES_TYPES: readonly ChartSeriesType[];
-declare const CHART_STACKINGS: readonly ChartStacking[];
-declare const CHART_CURVES: readonly ChartCurve[];
-declare const CHART_ORIENTATIONS: readonly ChartOrientation[];
-declare const CHART_LEGEND_POSITIONS: readonly ChartLegendPosition[];
-declare const CHART_NUMBER_STYLES: readonly NonNullable<ChartNumberFormat['style']>[];
-/** Labels for pickers, shared by the React and Svelte components. */
-declare const CHART_TYPE_LABELS: Readonly<Record<ChartType, string>>;
-/** How a chart type is laid out. */
-type ChartFamily = 'cartesian' | 'xy' | 'pie' | 'radar' | 'waterfall' | 'histogram' | 'box' | 'funnel' | 'treemap';
-/** A colour-blind-friendly categorical palette (Okabe–Ito order, tuned for light and dark backgrounds). */
-declare const DEFAULT_CHART_PALETTE: readonly string[];
-declare const DEFAULT_CHART_THEME: ChartTheme;
-/**
- * A theme that reads the page's `--background`, `--foreground`, `--muted-foreground`,
- * `--border` and `--primary` colour variables (full colours, as the other components'
- * inline styles use them), with light fallbacks. The React and Svelte canvases use it.
- */
-declare const CSS_VARIABLE_CHART_THEME: ChartTheme;
-/** Bar, line, area and scatter: categories (or numeric x) against values, series may mix. */
-declare function isCartesianChart(type: ChartType): boolean;
-/** Whether the chart plots series against a numeric x axis (bubble charts, and scatter charts with x values). */
-declare function isXyChart(spec: Pick<ChartSpec, 'type' | 'series'>): boolean;
-/** How a chart is laid out (see `ChartType`). */
-declare function chartFamily(spec: Pick<ChartSpec, 'type' | 'series'>): ChartFamily;
-/** Chart types whose legend lists categories (one colour per category) rather than series. */
-declare function chartColorsByCategory(type: ChartType): boolean;
-declare function defaultChartAxis(value: boolean): ChartAxis;
-/** A complete spec with every default filled in. */
-declare function createChartSpec(partial?: Partial<ChartSpec>): ChartSpec;
-/** The colour a series is drawn with. */
-declare function chartSeriesColor(spec: Pick<ChartSpec, 'palette' | 'series'>, seriesIndex: number): string;
-/** The colour a pie slice is drawn with (by category). */
-declare function chartSliceColor(spec: Pick<ChartSpec, 'palette'>, index: number): string;
-/** The colour of one bar or point: its override, else the series colour. */
-declare function chartPointColor(spec: Pick<ChartSpec, 'palette' | 'series'>, seriesIndex: number, index: number): string;
-/** How a series is drawn in a cartesian chart. */
-declare function chartSeriesType(spec: Pick<ChartSpec, 'type'>, series: ChartSeries): ChartSeriesType;
-/** An id not used by any series (`series-1`, `series-2`, …). */
-declare function uniqueChartSeriesId(series: readonly Pick<ChartSeries, 'id'>[], base?: string): string;
-/**
- * Reads a number the way people type it in a data grid: `1,234.5`, `12%` (→ 0.12),
- * `$40`, `(3)` (→ -3). Blank → `null`. Returns `undefined` when it is not a number.
- */
-declare function parseChartValue(input: unknown): ChartValue | undefined;
-declare function normalizeChartAxis(value: unknown, fallback: ChartAxis, path: string, issues?: ChartIssue[]): ChartAxis;
-/** Values as numbers or nulls; bad entries become null and are reported. */
-declare function normalizeChartValues(value: unknown, length: number | undefined, path: string, issues?: ChartIssue[]): ChartValue[];
-/** Checks one trendline; `null` (reported) when it is unusable. */
-declare function normalizeChartTrendline(value: unknown, path: string, issues?: ChartIssue[]): ChartTrendline | null;
-/**
- * Turns any input (a partial spec, saved JSON, an agent's arguments) into a complete,
- * valid `ChartSpec`. Every value is checked; problems are reported as sentences in
- * `issues` and replaced by defaults, so the result is always drawable. Series values are
- * padded or trimmed to the number of categories.
- */
-declare function normalizeChartSpec(input: unknown): {
-    spec: ChartSpec;
-    issues: ChartIssue[];
-};
-/** A deep copy (specs are plain JSON). */
-declare function cloneChartSpec(spec: ChartSpec): ChartSpec;
-declare function cloneChartSeries(series: ChartSeries): ChartSeries;
-interface ChartTableOptions {
-    /**
-     * `columns` (default): the first column holds categories and each other column is a
-     * series. `rows`: the first row holds categories and each other row is a series.
-     */
-    seriesIn?: 'columns' | 'rows';
-    /**
-     * The first row (or column for `rows`) holds series names (default `true`). `auto`: only
-     * when one of its value cells is not a number.
-     */
-    header?: boolean | 'auto';
-    /**
-     * Read the first column as numeric x values (scatter and bubble charts): every series gets
-     * them as `x`, and the categories are their labels.
-     */
-    xFromFirstColumn?: boolean;
-}
-interface ChartTableData {
-    categories: string[];
-    series: ChartSeries[];
-    issues: ChartIssue[];
-}
-/**
- * Reads a grid of cells (from CSV, a spreadsheet range or the clipboard) as categories and
- * series. Cells that are not numbers become gaps and are reported.
- */
-declare function chartDataFromTable(rows: ReadonlyArray<ReadonlyArray<unknown>>, options?: ChartTableOptions): ChartTableData;
-/** The chart's data as a grid: a header row of series names, then one row per category. */
-declare function chartDataToTable(spec: Pick<ChartSpec, 'categories' | 'series'>, options?: {
-    categoryHeader?: string;
-}): (string | number | null)[][];
-/** A colour input value (`#rrggbb`) for a CSS colour: `#abc` expands, non-hex colours show as black. */
-declare function chartColorInputValue(color: string): string;
-
 /** A "nice" step (1, 2, 2.5 or 5 × 10ⁿ) for about `count` intervals over `span`. */
 declare function niceStep(span: number, count: number): number;
 interface NiceScale {
@@ -357,87 +255,6 @@ declare function summarizeChartSeries(series: {
     values: readonly ChartValue[];
 }, categories: readonly string[]): ChartSeriesSummary;
 
-/**
- * A fitted regression trendline. Exponential, logarithmic and power fits are linear fits of
- * transformed data (`ln y ~ x`, `y ~ ln x`, `ln y ~ ln x`), as spreadsheets document them;
- * points the transform cannot take (values ≤ 0) are skipped, and R² is for the transformed fit.
- */
-interface ChartTrendFit {
-    type: Exclude<ChartTrendlineType, 'moving-average'>;
-    /** Coefficients `c0…cd` of `Y = Σ cₖ·Xᵏ` in the transformed variables. */
-    coefficients: number[];
-    /** Coefficient of determination; `null` when undefined (all y equal). */
-    r2: number | null;
-    /** The equation as a label, e.g. `y = 0.5x² - 2x + 1` or `y = 3e^(0.2x)`. */
-    equation: string;
-    /** Number of points used. */
-    points: number;
-    /** The fitted y at `x`, or `null` outside the fit's domain (x ≤ 0 for log and power). */
-    evaluate(x: number): number | null;
-}
-/**
- * Fits `trendline` to the points. Returns `null` for moving averages (see
- * `chartMovingAverage`) and degenerate data: too few usable points, all x equal, or a
- * singular system.
- */
-declare function fitChartTrendline(trendline: ChartTrendline, points: ReadonlyArray<readonly [number, number]>): ChartTrendFit | null;
-/** A coefficient as trendline labels show it: up to four decimals, scientific when tiny or huge. */
-declare function trendNumberText(v: number): string;
-/**
- * Moving average of `period` consecutive points in plotted order: point `i` (from
- * `period - 1`) is `(xᵢ, mean(yᵢ₋ₚ₊₁ … yᵢ))`. Empty when there are fewer points than `period`.
- */
-declare function chartMovingAverage(points: ReadonlyArray<readonly [number, number]>, period: number): [number, number][];
-/** The legend name spreadsheets give a trendline, e.g. `Linear (Sales)`. */
-declare function chartTrendlineName(trendline: ChartTrendline, seriesName: string): string;
-/** Whether trendlines can be drawn for this chart type and stacking (unstacked cartesian and xy charts). */
-declare function chartSupportsTrendlines(type: string, stacking: string): boolean;
-
-type ChartTextMeasure = (text: string, size: number, weight?: number) => number;
-interface ChartLayoutOptions {
-    width: number;
-    height: number;
-    theme?: Partial<ChartTheme>;
-    /** Highlighted in the scene (selection outlines, `selected` flags). */
-    selection?: ChartSelection | null;
-    /** Text width in pixels (default: an estimate from the character count). */
-    measureText?: ChartTextMeasure;
-    /** Shown when there is nothing to draw (default "No data"). */
-    emptyMessage?: string;
-    /**
-     * Fixes the value axis to this range (over `yAxis.min` / `yAxis.max`). Canvases pass
-     * `ChartPointDrag.valueDomain` during a drag so the axis does not rescale under the pointer.
-     */
-    valueDomain?: {
-        min: number;
-        max: number;
-    } | null;
-    /** Fixes the secondary value axis the same way (`ChartPointDrag.valueDomain2`). */
-    valueDomain2?: {
-        min: number;
-        max: number;
-    } | null;
-    /** Fixes the numeric x axis of a scatter or bubble chart (`ChartPointDrag.xDomain`). */
-    xDomain?: {
-        min: number;
-        max: number;
-    } | null;
-    /** Shows the value of this point next to it (a `drag-readout` text mark, kept inside the plot). */
-    readout?: {
-        seriesId: string;
-        index: number;
-    } | null;
-}
-/** A DOM-free text width estimate (average glyph ≈ 0.56 em, bold ≈ 0.6 em). */
-declare const estimateChartTextWidth: ChartTextMeasure;
-/** Whether two selections point at the same thing. */
-declare function sameChartSelection(a: ChartSelection | null | undefined, b: ChartSelection | null | undefined): boolean;
-/**
- * Black or white text for a label drawn on `fill` (#rgb, #rrggbb or rgb()), by perceived
- * luminance (0.299 R + 0.587 G + 0.114 B). Unparseable colours (CSS variables) get white.
- */
-declare function contrastingTextColor(fill: string): string;
-
 /**
  * Lays a chart out as drawing primitives (rects, paths, circles, lines and text) in a
  * `width × height` box. Pure and DOM-free: the React and Svelte canvases render the marks
@@ -470,23 +287,6 @@ declare const MAX_CHART_LINE_POINTS = 2000;
 /** Markers beyond this many are thinned to one per 2px cell. */
 declare const MAX_CHART_MARKERS = 1000;
 
-/** SVG `dominant-baseline` for a text mark's baseline (shared by every renderer). */
-declare function chartTextBaseline(baseline: ChartTextMark['baseline']): 'hanging' | 'central' | 'text-after-edge';
-/** SVG `transform` for a rotated text mark, if any. */
-declare function chartTextTransform(mark: ChartTextMark): string | undefined;
-interface ChartSvgOptions {
-    /** Leave out selection outlines (default `true`: exports show the chart only). */
-    hideSelection?: boolean;
-    /** Accessible title (default: the chart title). */
-    ariaLabel?: string;
-    /** A longer description written as `<desc>` (`chartToSvg` defaults to `describeChart`). */
-    description?: string;
-}
-/** Writes a laid-out scene as a standalone SVG document string. */
-declare function chartSceneToSvg(scene: ChartScene, options?: ChartSvgOptions): string;
-/** Lays out and writes a chart as SVG, e.g. for export or server rendering. */
-declare function chartToSvg(spec: ChartSpec, options: Omit<ChartLayoutOptions, 'selection'> & ChartSvgOptions): string;
-
 interface ChartSummary {
     type: ChartSpec['type'];
     title: string;
@@ -524,34 +324,6 @@ declare function summarizeChart(spec: ChartSpec, size?: Pick<ChartLayoutOptions,
 /** A plain-language description of a chart: type, what it compares, ranges and notable extremes. */
 declare function describeChart(spec: ChartSpec, series?: ChartSeriesSummary[]): string;
 
-type ChartSparklineKind = 'line' | 'column' | 'win-loss';
-interface ChartSparklineOptions {
-    kind?: ChartSparklineKind;
-    width: number;
-    height: number;
-    /** Line, positive column and win colour (default the first palette colour). */
-    color?: string;
-    /** Negative column and loss colour (default red). */
-    negativeColor?: string;
-    /** Dots on every line point (thinned past 500). */
-    markers?: boolean;
-    /** Highlight the highest and lowest point of a line (or column). */
-    highLow?: boolean;
-    /** Fixed value range (default: the data, including 0 for columns). */
-    min?: number;
-    max?: number;
-}
-/**
- * Lays out a word-sized chart (a sparkline) as marks: a line broken at gaps, columns
- * (negatives in `negativeColor`) or win/loss bars of equal height. Long lines are thinned past
- * 4000 points. Returns a scene with no axes, legend or targets.
- */
-declare function layoutSparkline(values: readonly ChartValue[], options: ChartSparklineOptions): ChartScene;
-/** A sparkline as a standalone SVG string (e.g. for an inline image in rich text). */
-declare function sparklineToSvg(values: readonly ChartValue[], options: ChartSparklineOptions & {
-    ariaLabel?: string;
-}): string;
-
 /** A partial change several fields at once (what `ChartController.update` takes). */
 type ChartPresetPatch = Partial<Omit<ChartSpec, 'version' | 'xAxis' | 'yAxis' | 'yAxis2' | 'legend' | 'series' | 'categories'>> & {
     xAxis?: Partial<ChartAxis>;
@@ -643,268 +415,6 @@ declare function chartFromTable(rows: ReadonlyArray<ReadonlyArray<unknown>>, opt
     type?: ChartType | 'auto';
 }): ChartFromTable;
 
-interface ChartControllerOptions {
-    /** Starting chart (any partial or saved spec; problems are reported in `state.issues`). */
-    spec?: Partial<ChartSpec> | unknown;
-    /** History to record into, e.g. one shared with the rest of the app (default: a new one). */
-    history?: HistoryManager;
-    /** Called after the spec changes (edit, undo, redo, load). */
-    onChange?: (spec: Readonly<ChartSpec>) => void;
-}
-/** A snapshot of the controller. The same object is returned until something changes. */
-interface ChartState {
-    spec: Readonly<ChartSpec>;
-    selection: ChartSelection | null;
-    /** The series the selection belongs to (a series, one of its points or one of its trendlines). */
-    selectedSeries: ChartSeries | null;
-    /** The category the selection belongs to (a category or a point). */
-    selectedIndex: number | null;
-    /** Problems from the last load or rejected edit, as sentences. */
-    issues: readonly ChartIssue[];
-    /** The gesture in progress (e.g. a bar drag), if any. */
-    gesture: string | null;
-    canUndo: boolean;
-    canRedo: boolean;
-    undoLabel: string;
-    redoLabel: string;
-    /** Bumped on every change. */
-    revision: number;
-}
-type ChartActionResult = {
-    ok: true;
-} | {
-    ok: false;
-    message: string;
-    issues?: ChartIssue[];
-};
-/** Top-level fields with partial axes and legend. */
-type ChartSpecPatch = Partial<Omit<ChartSpec, 'version' | 'xAxis' | 'yAxis' | 'yAxis2' | 'legend'>> & {
-    xAxis?: Partial<ChartAxis>;
-    yAxis?: Partial<ChartAxis>;
-    yAxis2?: Partial<ChartAxis>;
-    legend?: Partial<ChartLegend>;
-};
-interface ChartSeriesInput {
-    id?: string;
-    name?: string;
-    values?: readonly unknown[];
-    color?: string;
-    type?: ChartSeriesType;
-    hidden?: boolean;
-    axis?: 'primary' | 'secondary';
-    x?: readonly unknown[];
-    sizes?: readonly unknown[];
-    pointColors?: readonly (string | null)[];
-    marker?: ChartMarker;
-    curve?: ChartCurve;
-    dataLabels?: boolean;
-    format?: ChartNumberFormat;
-    trendlines?: readonly ChartTrendline[];
-}
-/** Changes to one series; `null` resets a field to the chart's default. */
-interface ChartSeriesPatch {
-    name?: string;
-    /** `null` goes back to the palette colour. */
-    color?: string | null;
-    /** `null` follows the chart type. */
-    type?: ChartSeriesType | null;
-    hidden?: boolean;
-    axis?: 'primary' | 'secondary' | null;
-    x?: readonly unknown[] | null;
-    sizes?: readonly unknown[] | null;
-    pointColors?: readonly (string | null)[] | null;
-    marker?: ChartMarker | null;
-    curve?: ChartCurve | null;
-    dataLabels?: boolean | null;
-    format?: ChartNumberFormat | null;
-}
-interface ChartEditOptions {
-    /** Undo step label. */
-    label?: string;
-}
-/**
- * Headless state for a chart editor: a validated `ChartSpec`, a selection, and undoable
- * edits to data (values, series, categories, pasted grids, CSV) and presentation (type,
- * titles, axes, legend, stacking, …). Drags merge into one undo step (`beginGesture`).
- * `getState()` returns the same object until something changes, so it works with
- * `useSyncExternalStore` and Svelte runes alike.
- */
-declare class ChartController {
-    readonly history: HistoryManager;
-    private spec;
-    private selection;
-    private issues;
-    private gestureKey;
-    private gestureCount;
-    private gestureStart;
-    private revision;
-    private applying;
-    private readonly onChange?;
-    private readonly listeners;
-    private unsubscribeHistory?;
-    private state;
-    constructor(options?: ChartControllerOptions);
-    private connect;
-    /** The current snapshot (stable until the next change). */
-    getState: () => ChartState;
-    /** Calls `listener` after every change. Returns an unsubscribe function. */
-    subscribe: (listener: (state: ChartState) => void) => (() => void);
-    /** The current spec (do not mutate; edit through the controller). */
-    getSpec(): Readonly<ChartSpec>;
-    getSeries(id: string): ChartSeries | undefined;
-    private computeState;
-    private notify;
-    /** Drops a selection that no longer points at anything. */
-    private validSelection;
-    private applySpec;
-    private commit;
-    private reject;
-    /** A copy of the spec with `edit` applied (series and categories copied as needed). */
-    private edited;
-    private unknownSeries;
-    private badIndex;
-    /**
-     * Changes any presentation or data fields as one undo step. All-or-nothing: if anything
-     * is invalid, nothing changes and every problem is returned (and shown in `state.issues`).
-     */
-    update(patch: ChartSpecPatch, options?: ChartEditOptions): ChartActionResult;
-    setType(type: ChartType): ChartActionResult;
-    setTitle(title: string): ChartActionResult;
-    setSubtitle(subtitle: string): ChartActionResult;
-    /** Changes the category (`x`), value (`y`) or secondary value (`y2`) axis. */
-    setAxis(axis: 'x' | 'y' | 'y2', patch: Partial<ChartAxis>): ChartActionResult;
-    /**
-     * Applies a named quick layout and / or colour scheme (see `CHART_LAYOUT_PRESETS` and
-     * `CHART_COLOR_SCHEMES`) as one undo step.
-     */
-    applyPreset(options: {
-        layout?: string;
-        colors?: string;
-    }): ChartActionResult;
-    setLegend(patch: Partial<ChartLegend>): ChartActionResult;
-    /**
-     * Replaces categories and / or series as one undo step. Values are validated and padded
-     * to the categories; all-or-nothing like `update`.
-     */
-    setData(data: {
-        categories?: readonly unknown[];
-        series?: readonly ChartSeriesInput[];
-    }, options?: ChartEditOptions): ChartActionResult;
-    /**
-     * Sets one value (numbers, numeric text such as `1,200` or `12%`, or blank for a gap).
-     * One undo step, or part of the current gesture.
-     */
-    setValue(seriesId: string, index: number, value: unknown, options?: ChartEditOptions): ChartActionResult;
-    /** Several values as one undo step (all-or-nothing). */
-    setValues(cells: readonly {
-        seriesId: string;
-        index: number;
-        value: unknown;
-    }[], options?: ChartEditOptions): ChartActionResult;
-    /** Adds a series (values padded to the categories) and selects it. Returns its id. */
-    addSeries(input?: ChartSeriesInput, options?: {
-        at?: number;
-    }): {
-        ok: true;
-        id: string;
-    } | {
-        ok: false;
-        message: string;
-        issues?: ChartIssue[];
-    };
-    removeSeries(id: string): ChartActionResult;
-    updateSeries(id: string, patch: ChartSeriesPatch): ChartActionResult;
-    toggleSeries(id: string): ChartActionResult;
-    /** Moves a series to position `to` (drawing and legend order). */
-    moveSeries(id: string, to: number): ChartActionResult;
-    /** Inserts a category (with gaps in every series) at `at` (default: the end). Returns its index. */
-    addCategory(label?: string, options?: {
-        at?: number;
-    }): {
-        ok: true;
-        index: number;
-    };
-    removeCategory(index: number): ChartActionResult;
-    renameCategory(index: number, label: string): ChartActionResult;
-    moveCategory(from: number, to: number): ChartActionResult;
-    /**
-     * Pastes a block of cells (TSV / CSV text or rows) into the data grid with its top-left at
-     * `row` (category index) and `column` (series index; `-1` is the category column). The
-     * grid grows to fit. Non-numeric value cells become gaps and are reported in `issues`.
-     */
-    pasteCells(row: number, column: number, cells: string | ReadonlyArray<ReadonlyArray<unknown>>): ChartActionResult & {
-        issues?: ChartIssue[];
-    };
-    /**
-     * Replaces the data with a grid of cells (see `chartDataFromTable`): one undo step. Series
-     * colours and types are kept by name.
-     */
-    importTable(rows: ReadonlyArray<ReadonlyArray<unknown>>, options?: ChartTableOptions): ChartActionResult & {
-        issues?: ChartIssue[];
-    };
-    /** Imports CSV (or TSV, detected by tabs) text; see `importTable`. */
-    importCsv(text: string, options?: ChartTableOptions & {
-        delimiter?: string;
-    }): ChartActionResult & {
-        issues?: ChartIssue[];
-    };
-    /** Adds a trendline to a series and selects it. Returns its index (and the fit, when it can be computed). */
-    addTrendline(seriesId: string, input: ChartTrendline): {
-        ok: true;
-        index: number;
-        fit: ChartTrendFit | null;
-    } | {
-        ok: false;
-        message: string;
-        issues?: ChartIssue[];
-    };
-    /** Changes a trendline (all-or-nothing). */
-    updateTrendline(seriesId: string, index: number, patch: Partial<ChartTrendline>): ChartActionResult;
-    removeTrendline(seriesId: string, index: number): ChartActionResult;
-    /** The points a series' trendlines are fitted to: (x, y) with x = 1, 2, 3 … on category charts. */
-    trendlinePoints(seriesId: string): [number, number][];
-    /** The fitted coefficients, R² and equation of a trendline (null for moving averages or unfittable data). */
-    trendlineFit(seriesId: string, index: number): ChartTrendFit | null;
-    /** The moving-average points of a trendline (empty for other kinds). */
-    trendlineMovingAverage(seriesId: string, index: number): [number, number][];
-    /**
-     * Switches rows and columns: series become categories and categories become series (one
-     * undo step). Series colours, types and other per-series settings are dropped.
-     */
-    transpose(): ChartActionResult;
-    /** Selects a chart element (view state; not an undo step). */
-    select(selection: ChartSelection | null): void;
-    /**
-     * Deletes what is selected: a series or category is removed, a point becomes a gap, a
-     * title is cleared, the legend or an axis is hidden.
-     */
-    deleteSelection(): ChartActionResult;
-    /** Adds `delta` to a value (a gap counts as 0). */
-    nudgeValue(seriesId: string, index: number, delta: number): ChartActionResult;
-    /** Starts a continuous edit (a drag): every change until `endGesture()` is one undo step. */
-    beginGesture(key: string): void;
-    /**
-     * Cancels the gesture in progress (Escape during a drag): everything it changed is taken
-     * back and leaves no undo or redo step.
-     */
-    cancelGesture(): void;
-    endGesture(): void;
-    /** The spec, for saving (a copy). */
-    toJSON(): ChartSpec;
-    /**
-     * Replaces the chart without an undo step (e.g. when opening a document). Problems are
-     * fixed with defaults and reported in `state.issues` (and returned).
-     */
-    load(input: unknown, options?: {
-        clearHistory?: boolean;
-    }): ChartIssue[];
-    undo(): boolean;
-    redo(): boolean;
-    /** Stops listening to the history (reconnected by the next `subscribe`). */
-    destroy(): void;
-}
-declare function createChartController(options?: ChartControllerOptions): ChartController;
-
 interface ChartCommandOptions {
     /** Id prefix (default `chart.`); use one per chart when several are registered. */
     prefix?: string;
@@ -1367,4 +877,4 @@ declare function blendChartScenes(from: ChartScene | null, to: ChartScene, t: nu
 /** Ease-out cubic, for tweens. */
 declare const easeChartTween: (t: number) => number;
 
-export { CHART_AXIS_KINDS, CHART_COLOR_SCHEMES, CHART_CURVES, CHART_DATE_STEPS, CHART_LABEL_POSITIONS, CHART_LAYOUT_PRESETS, CHART_LEGEND_POSITIONS, CHART_MARKERS, CHART_MERMAID_META_PREFIX, CHART_NUMBER_STYLES, CHART_OOXML_CONTENT_TYPE, CHART_OOXML_NS, CHART_OOXML_RELATIONSHIP, CHART_ORIENTATIONS, CHART_PALETTE_SHADES, CHART_PRESENCE_COLORS, CHART_SERIES_TYPES, CHART_STACKINGS, CHART_TRENDLINE_TYPES, CHART_TYPES, CHART_TYPE_LABELS, CSS_VARIABLE_CHART_THEME, type ChartActionResult, type ChartAgentCommand, ChartAxis, type ChartBoxStats, type ChartClock, type ChartColorCheck, type ChartColorCheckOptions, type ChartColorPair, type ChartColorScheme, type ChartCommandOptions, ChartController, type ChartControllerOptions, ChartCurve, type ChartDateLabels, type ChartDateStep, ChartDirector, type ChartDirectorActor, type ChartDirectorOptions, type ChartDragMoveOptions, type ChartEditOptions, type ChartFamily, type ChartFormatCode, type ChartFromTable, type ChartHistogramBin, ChartIssue, type ChartKeyInput, ChartLabelPosition, type ChartLayoutOptions, type ChartLayoutPreset, ChartLegend, ChartLegendPosition, ChartMarker, type ChartMermaidFamily, type ChartMermaidOptions, type ChartMermaidParseOptions, type ChartMermaidResult, ChartNumberFormat, type ChartOoxmlReadOptions, type ChartOoxmlReadResult, type ChartOoxmlWriteResult, ChartOrientation, type ChartPerformanceResult, type ChartPerformanceStep, type ChartPointDrag, ChartPresence, type ChartPresenceActor, type ChartPresenceState, type ChartPresetPatch, type ChartRecommendation, ChartRect, type ChartRgb, ChartScene, ChartSelection, ChartSeries, type ChartSeriesInput, type ChartSeriesPatch, type ChartSeriesSummary, ChartSeriesType, type ChartSnapOptions, type ChartSparklineKind, type ChartSparklineOptions, ChartSpec, type ChartSpecPatch, ChartStacking, type ChartState, ChartStream, type ChartStreamFormat, type ChartStreamResult, type ChartSummary, type ChartSvgOptions, type ChartTableData, type ChartTableOptions, type ChartTableShape, ChartTextMark, type ChartTextMeasure, ChartTheme, type ChartToolProviderOptions, type ChartTrendFit, ChartTrendline, ChartTrendlineType, ChartType, ChartValue, ChartValueScale, type ChartVision, ChartWarning, DEFAULT_CHART_PALETTE, DEFAULT_CHART_THEME, type FoundChartMermaid, MAX_CHART_DATA_LABELS, MAX_CHART_LINE_POINTS, MAX_CHART_MARKERS, type NiceScale, analyzeChartTable, blendChartScenes, canDragChartPoint, chartBoxStats, chartClientToScene, chartColorDistance, chartColorInputValue, chartColorsByCategory, chartContrastRatio, chartDataFromTable, chartDataToTable, chartDateLabels, chartDateToSerial, chartFamily, chartFormatToCode, chartFromMermaid, chartFromOoxml, chartFromTable, chartHistogram, chartHitTest, chartLuminance, chartMermaidFamily, chartMovingAverage, chartPointAnchor, chartPointColor, chartPresetPatch, chartQuantile, chartRgbToHex, chartRgbToOklab, chartSceneToSvg, chartSerialToDate, chartSeriesColor, chartSeriesType, chartSliceColor, chartSquarify, chartSupportsTrendlines, chartTextBaseline, chartTextOn, chartTextTransform, chartToMermaid, chartToOoxml, chartToSvg, chartTrendlineName, chartValueAtPoint, chartXAtPoint, checkChartColors, cloneChartSeries, cloneChartSpec, compileChartFormatCode, contrastingTextColor, createChartCommands, createChartController, createChartSpec, createChartToolProvider, createInstantChartClock, cyclePaletteColor, decimateChartPoints, defaultChartAxis, describeChart, describeChartSelection, easeChartTween, estimateChartTextWidth, findMermaidCharts, fitChartTrendline, formatChartDate, formatChartNumber, formatChartValueWithCode, handleChartKey, isCartesianChart, isXyChart, layoutChart, layoutSparkline, linearMap, monochromeChartPalette, niceScale, niceStep, normalizeChartAxis, normalizeChartSpec, normalizeChartTrendline, normalizeChartValues, parseChartColor, parseChartDate, parseChartValue, parsePartialChartJson, planChartCommand, realChartClock, recommendChartTypes, recommendForShape, sameChartSelection, shadeChartColor, simulateChartVision, snapChartDragValue, snapChartValue, sparklineToSvg, startChartPointDrag, stepDecimals, summarizeChart, summarizeChartSeries, trendNumberText, uniqueChartSeriesId };
+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 };