@pixerate/editor 0.54.0 → 0.56.0

package/dist/{controller-CX0QfSv0.d.cts → controller-R2biKk_E.d.cts}

@@ -1,366 +1,6 @@
+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 ChartErrorBars, p as ChartTrendline, q as ChartValue, r as ChartSelection, s as ChartScene, t as ChartTextMark, u as ChartLegend } from './types-BRp-6zkY.cjs';
 import { H as HistoryManager } from './HistoryManager-DeQQMBCj.cjs';
 
-/**
- * Chart kinds.
- *
- * - `bar`, `line`, `area` and `scatter` are cartesian: categories along one axis, values along
- *   the other, and series may mix them (a combo chart). A scatter chart whose series carry
- *   numeric `x` values plots them on a numeric x axis instead.
- * - `bubble` plots `x`, `y` (the values) and `sizes` per series.
- * - `pie` and `donut` draw the first visible series, one slice per category.
- * - `radar` draws each series as a polygon over one spoke per category.
- * - `waterfall` draws the first series as running increases and decreases.
- * - `histogram` bins every value of the visible series; `box` draws one box and whiskers per series.
- * - `funnel` and `treemap` draw the first series, one bar or rectangle per category.
- */
-type ChartType = 'bar' | 'line' | 'area' | 'scatter' | 'bubble' | 'pie' | 'donut' | 'radar' | 'waterfall' | 'histogram' | 'box' | 'funnel' | 'treemap';
-/** How a series is drawn in a cartesian chart. */
-type ChartSeriesType = 'bar' | 'line' | 'area' | 'scatter';
-/** One data value; `null` is a gap (missing value). */
-type ChartValue = number | null;
-/** Point marker shapes for line, area and scatter series. */
-type ChartMarker = 'circle' | 'square' | 'diamond' | 'triangle' | 'cross' | 'none';
-/** Trendline fits (as in spreadsheets). */
-type ChartTrendlineType = 'linear' | 'exponential' | 'logarithmic' | 'power' | 'polynomial' | 'moving-average';
-interface ChartTrendline {
-    type: ChartTrendlineType;
-    /** Polynomial order, 2–6 (default 2). */
-    order?: number;
-    /** Moving-average period, 2 or more (default 2). */
-    period?: number;
-    /** Extend the line this many x units past the last point (default 0). */
-    forward?: number;
-    /** Extend the line this many x units before the first point (default 0). */
-    backward?: number;
-    /** Force the line through this y at x = 0 (linear, polynomial and exponential only). */
-    intercept?: number | null;
-    /** Write the fitted equation on the chart. */
-    showEquation?: boolean;
-    /** Write R² on the chart. */
-    showR2?: boolean;
-    /** Legend name (default: e.g. "Linear (Sales)"). */
-    name?: string;
-    /** CSS colour (default: the series colour). */
-    color?: string;
-}
-/** How error amounts are worked out (as in spreadsheets: Excel's `c:errValType`). */
-type ChartErrorBarType = 'fixed' | 'percent' | 'stddev' | 'stderr' | 'custom';
-/**
- * Error bars on a series (Excel's `c:errBars`). Amounts are in data units and drawn from each
- * point, except `stddev`, which is drawn around the series mean as Excel does.
- */
-interface ChartErrorBars {
-    /**
-     * - `fixed`: the same amount at every point (`value`, default 1).
-     * - `percent`: `value` percent of each point's value (default 5).
-     * - `stddev`: `value` standard deviations of the series (default 1), around the series mean.
-     * - `stderr`: the standard error of the series (sample standard deviation / √n) at every point.
-     * - `custom`: per-point amounts from `plus` and `minus`.
-     */
-    type: ChartErrorBarType;
-    /** The amount for `fixed`, `percent` and `stddev` (see `type` for defaults). */
-    value?: number;
-    /** Custom amounts above each point (0 or more; `null`: none). */
-    plus?: ChartValue[];
-    /** Custom amounts below each point (0 or more; `null`: none). Defaults to `plus`. */
-    minus?: ChartValue[];
-    /** Which way the bars go (default `both`). */
-    direction?: 'both' | 'plus' | 'minus';
-    /** Draw end caps (default `true`). */
-    cap?: boolean;
-}
-interface ChartSeries {
-    /** Stable id (unique within the chart). */
-    id: string;
-    name: string;
-    /** One value per category (the y values of a scatter or bubble chart). */
-    values: ChartValue[];
-    /** CSS colour (default: the palette colour for the series' position). */
-    color?: string;
-    /** Overrides the chart type for this series (cartesian charts only). */
-    type?: ChartSeriesType;
-    /** Hidden series keep their data but are not drawn or scaled. */
-    hidden?: boolean;
-    /** Plot against the secondary value axis (on the right). */
-    axis?: 'primary' | 'secondary';
-    /** Numeric x per category (scatter and bubble charts). */
-    x?: ChartValue[];
-    /** Bubble sizes per category (bubble charts; area is proportional to size). */
-    sizes?: ChartValue[];
-    /** Colour overrides per category (`null` keeps the series colour). */
-    pointColors?: (string | null)[];
-    /** Point marker (default: circles on lines when `points` is on). */
-    marker?: ChartMarker;
-    /** Line interpolation for this series (default: the chart's `curve`). */
-    curve?: ChartCurve;
-    /** Value labels for this series (default: the chart's `dataLabels`). */
-    dataLabels?: boolean;
-    /** How this series' data labels are written (default: the value axis format). */
-    format?: ChartNumberFormat;
-    /** Fitted lines drawn over the series. */
-    trendlines?: ChartTrendline[];
-    /** Error bars along the value axis (bar, line, area and scatter series). */
-    errorBars?: ChartErrorBars;
-    /** Error bars along the numeric x axis (scatter charts with x values). */
-    xErrorBars?: ChartErrorBars;
-}
-interface ChartNumberFormat {
-    /** `number` (default), `percent` (0.25 → 25%), `currency` or `compact` (1.2K). */
-    style?: 'number' | 'percent' | 'currency' | 'compact';
-    /** Fixed decimals (default: as many as the ticks need, up to 2). */
-    decimals?: number;
-    /** ISO currency code for `currency` (default `USD`). */
-    currency?: string;
-    prefix?: string;
-    suffix?: string;
-    /**
-     * A spreadsheet format code such as `#,##0.0,,"M"` or `0.0%;[Red]-0.0%`. When set it
-     * wins over the other fields. Supports sections (positive;negative;zero), digit
-     * placeholders, thousands separators and scaling, percent, scientific and literal text.
-     */
-    code?: string;
-}
-interface ChartAxis {
-    /** Draw the axis line, ticks and labels (default `true`). */
-    show: boolean;
-    title: string;
-    /** Fixed lower bound (default: from the data, including 0 for bars and areas). */
-    min: number | null;
-    /** Fixed upper bound (default: from the data). */
-    max: number | null;
-    /** Fixed distance between ticks (default: a round number from the plot size). */
-    step: number | null;
-    /** Grid lines at each tick (default: on for the value axis). */
-    gridlines: boolean;
-    /** How tick and data labels are written (value axes, and the x axis of scatter charts). */
-    format: ChartNumberFormat;
-    /**
-     * Category axis only: `date` reads the categories as dates (ISO `2024-03-01`, `2024-03`,
-     * `2024`), labels them with calendar steps that fit, and thins the rest.
-     */
-    kind?: 'category' | 'date';
-    /**
-     * Value axes (and the numeric x axis of scatter and bubble charts): `log` spaces ticks by
-     * powers of `logBase`. Values of 0 or less cannot be drawn and are skipped. Not allowed with
-     * percent stacking. Absent means `linear`.
-     */
-    scale?: 'linear' | 'log';
-    /** Base of a logarithmic axis, 2–1000 (default 10). */
-    logBase?: number;
-    /** Run the axis the other way: values from the top down, or categories from right to left. */
-    reverse?: boolean;
-}
-type ChartLegendPosition = 'top' | 'bottom' | 'left' | 'right';
-interface ChartLegend {
-    show: boolean;
-    position: ChartLegendPosition;
-}
-type ChartStacking = 'none' | 'stacked' | 'percent';
-type ChartOrientation = 'vertical' | 'horizontal';
-type ChartCurve = 'linear' | 'smooth' | 'step';
-/** Where bar labels go: `auto` puts them outside, or centred on stacked segments, and drops ones that do not fit. */
-type ChartLabelPosition = 'auto' | 'inside' | 'outside' | 'center';
-/** A whole chart: data plus presentation. Plain JSON, safe to persist. */
-interface ChartSpec {
-    version: 1;
-    type: ChartType;
-    title: string;
-    subtitle: string;
-    /** Category labels (the x axis, or pie slices). */
-    categories: string[];
-    series: ChartSeries[];
-    /** The category axis (or the numeric x axis of a scatter or bubble chart). */
-    xAxis: ChartAxis;
-    /** The value axis. */
-    yAxis: ChartAxis;
-    /** The secondary value axis, drawn on the right when a visible series uses it. */
-    yAxis2: ChartAxis;
-    legend: ChartLegend;
-    /** Stack bars and areas (`percent` scales each category to 100%). */
-    stacking: ChartStacking;
-    /** `horizontal` draws bars sideways (bar charts only). */
-    orientation: ChartOrientation;
-    /** Line and area interpolation. */
-    curve: ChartCurve;
-    /** Dots on line and area series. */
-    points: boolean;
-    /** Value labels on bars, points and slices. */
-    dataLabels: boolean;
-    /** Where bar value labels go. */
-    labelPosition: ChartLabelPosition;
-    /** Series colours in order (cycled through lighter and darker shades once used up). */
-    palette: string[];
-    /** Donut hole as a fraction of the radius (0–0.9). */
-    innerRadius: number;
-    /** Empty space between category groups, as a fraction of the category width (0–0.9). */
-    gapWidth: number;
-    /** How much bars in a group overlap, as a fraction of a bar's width (-1 to 1; negative is a gap). */
-    overlap: number;
-    /** Histogram bin count (`null`: √n, between 1 and 100). */
-    bins: number | null;
-    /** Waterfall: append a running-total bar (categories labelled "total" are always totals). */
-    showTotal: boolean;
-}
-/** What a click selects. */
-type ChartSelection = {
-    kind: 'chart';
-} | {
-    kind: 'title';
-} | {
-    kind: 'subtitle';
-} | {
-    kind: 'legend';
-} | {
-    kind: 'axis';
-    axis: 'x' | 'y' | 'y2';
-} | {
-    kind: 'series';
-    seriesId: string;
-} | {
-    kind: 'point';
-    seriesId: string;
-    index: number;
-} | {
-    kind: 'category';
-    index: number;
-} | {
-    kind: 'trendline';
-    seriesId: string;
-    index: number;
-};
-/** Colours and type used to lay out a chart. Any CSS colour strings work. */
-interface ChartTheme {
-    /** Fill behind the chart (`transparent` lets the page show through). */
-    background: string;
-    /** The page colour: slice separators and hollow points (set it when `background` is transparent). */
-    surface: string;
-    text: string;
-    mutedText: string;
-    grid: string;
-    axis: string;
-    /** Outline drawn around the selected mark. */
-    selection: string;
-    /** Waterfall increases. */
-    positive: string;
-    /** Waterfall decreases. */
-    negative: string;
-    fontFamily: string;
-    fontSize: number;
-    titleSize: number;
-}
-interface ChartRect {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-}
-/** What a mark is, for styling and tests. */
-type ChartMarkRole = 'background' | 'title' | 'subtitle' | 'grid' | 'axis' | 'tick' | 'tick-label' | 'axis-title' | 'bar' | 'line' | 'area' | 'point' | 'slice' | 'cell' | 'box' | 'whisker' | 'outlier' | 'connector' | 'trendline' | 'trendline-label' | 'error-bar' | 'data-label' | 'legend-swatch' | 'legend-label' | 'drag-readout' | 'selection' | 'empty';
-interface ChartMarkBase {
-    /** Unique within the scene (a stable key for frameworks). */
-    key: string;
-    role: ChartMarkRole;
-    /** What clicking this mark selects (none: not clickable). */
-    target?: ChartSelection;
-    /** Mark belongs to the current selection. */
-    selected?: boolean;
-    opacity?: number;
-}
-interface ChartRectMark extends ChartMarkBase {
-    kind: 'rect';
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-    fill: string;
-    stroke?: string;
-    strokeWidth?: number;
-    radius?: number;
-}
-interface ChartPathMark extends ChartMarkBase {
-    kind: 'path';
-    d: string;
-    fill?: string;
-    stroke?: string;
-    strokeWidth?: number;
-    dash?: string;
-}
-interface ChartCircleMark extends ChartMarkBase {
-    kind: 'circle';
-    cx: number;
-    cy: number;
-    r: number;
-    fill: string;
-    stroke?: string;
-    strokeWidth?: number;
-}
-interface ChartLineMark extends ChartMarkBase {
-    kind: 'line';
-    x1: number;
-    y1: number;
-    x2: number;
-    y2: number;
-    stroke: string;
-    strokeWidth?: number;
-    dash?: string;
-}
-interface ChartTextMark extends ChartMarkBase {
-    kind: 'text';
-    x: number;
-    y: number;
-    text: string;
-    anchor: 'start' | 'middle' | 'end';
-    /** Vertical alignment of the text box to `y`. */
-    baseline: 'top' | 'middle' | 'bottom';
-    size: number;
-    weight?: number;
-    fill: string;
-    /** Degrees, around (x, y). */
-    rotate?: number;
-}
-type ChartMark = ChartRectMark | ChartPathMark | ChartCircleMark | ChartLineMark | ChartTextMark;
-/** Maps between data values and scene pixels along one axis of the plot. */
-interface ChartValueScale {
-    /** `y` for vertical charts, `x` for horizontal bars and the numeric x axis of scatter charts. */
-    axis: 'x' | 'y';
-    domain: [number, number];
-    range: [number, number];
-    ticks: number[];
-    /** Set when the axis is logarithmic: values map by their logarithm in this base. */
-    logBase?: number;
-}
-/** Something the layout had to leave out or shorten, as a sentence (for agents and screen readers). */
-interface ChartWarning {
-    code: 'labels-hidden' | 'labels-truncated' | 'legend-truncated' | 'points-decimated' | 'values-skipped' | 'data-labels-hidden' | 'type-fallback';
-    message: string;
-}
-/** A laid-out chart: drawing primitives in scene pixels, ready for SVG, canvas or anything else. */
-interface ChartScene {
-    width: number;
-    height: number;
-    /** The plot area (inside the axes). Empty for pies. */
-    plot: ChartRect;
-    /** Draw in order. */
-    marks: ChartMark[];
-    /** The value scale of a cartesian chart (absent for pies and empty charts). */
-    valueScale?: ChartValueScale;
-    /** The secondary value scale, when a visible series uses it. */
-    valueScale2?: ChartValueScale;
-    /** The numeric x scale of a scatter or bubble chart with x values. */
-    xScale?: ChartValueScale;
-    /** Percent-stacked: values are shown as shares, so dragging is disabled. */
-    percent: boolean;
-    theme: ChartTheme;
-    /** What was left out or shortened (hidden labels, decimated lines, …). */
-    warnings: ChartWarning[];
-}
-interface ChartIssue {
-    path: string;
-    message: string;
-    /** 1-based source line, for text formats such as Mermaid. */
-    line?: number;
-}
-
 declare const CHART_TYPES: readonly ChartType[];
 declare const CHART_MARKERS: readonly ChartMarker[];
 declare const CHART_TRENDLINE_TYPES: readonly ChartTrendlineType[];
@@ -870,4 +510,4 @@ declare class ChartController {
 }
 declare function createChartController(options?: ChartControllerOptions): ChartController;
 
-export { type ChartSparklineKind as $, CHART_ORIENTATIONS as A, CHART_SERIES_TYPES as B, type ChartValueScale as C, CHART_STACKINGS as D, CHART_TRENDLINE_TYPES as E, CHART_TYPES as F, CHART_TYPE_LABELS as G, CSS_VARIABLE_CHART_THEME as H, type ChartActionResult as I, type ChartCircleMark as J, type ChartControllerOptions as K, type ChartCurve as L, type ChartDomSpec as M, type ChartEditOptions as N, type ChartFamily as O, type ChartLabelPosition as P, type ChartLegendPosition as Q, type ChartLineMark as R, type ChartMark as S, type ChartMarkRole as T, type ChartMarker as U, type ChartOrientation as V, type ChartPathMark as W, type ChartRectMark as X, type ChartSeriesInput as Y, type ChartSeriesPatch as Z, type ChartSeriesType as _, type ChartNumberFormat as a, type ChartSparklineOptions as a0, type ChartState as a1, type ChartSvgOptions as a2, type ChartTableData as a3, type ChartTableOptions as a4, type ChartTextMark as a5, type ChartTextMeasure as a6, type ChartTrendFit as a7, type ChartTrendline as a8, type ChartTrendlineType as a9, fitChartTrendline as aA, isCartesianChart as aB, isXyChart as aC, layoutSparkline as aD, normalizeChartAxis as aE, normalizeChartErrorBars as aF, normalizeChartSpec as aG, normalizeChartTrendline as aH, normalizeChartValues as aI, parseChartValue as aJ, sameChartSelection as aK, sparklineToSvg as aL, trendNumberText as aM, uniqueChartSeriesId as aN, DEFAULT_CHART_PALETTE as aa, DEFAULT_CHART_THEME as ab, chartColorInputValue as ac, chartColorsByCategory as ad, chartDataFromTable as ae, chartDataToTable as af, chartFamily as ag, chartMovingAverage as ah, chartPointColor as ai, chartSceneToDomSpec as aj, chartSceneToSvg as ak, chartSeriesColor as al, chartSeriesType as am, chartSliceColor as an, chartSupportsTrendlines as ao, chartTextBaseline as ap, chartTextTransform as aq, chartToSvg as ar, chartTrendlineName as as, cloneChartSeries as at, cloneChartSpec as au, contrastingTextColor as av, createChartController as aw, createChartSpec as ax, defaultChartAxis as ay, estimateChartTextWidth as az, type ChartValue as b, type ChartRect as c, type ChartErrorBars as d, type ChartErrorBarType as e, type ChartScene as f, type ChartSpec as g, type ChartLayoutOptions as h, type ChartTheme as i, type ChartWarning as j, type ChartAxis as k, type ChartLegend as l, type ChartType as m, type ChartStacking as n, type ChartSeries as o, type ChartIssue as p, ChartController as q, type ChartSelection as r, type ChartSpecPatch as s, CHART_AXIS_KINDS as t, CHART_AXIS_SCALES as u, CHART_CURVES as v, CHART_LABEL_POSITIONS as w, CHART_LEGEND_POSITIONS as x, CHART_MARKERS as y, CHART_NUMBER_STYLES as z };
+export { contrastingTextColor as $, type ChartSvgOptions as A, type ChartTableData as B, type ChartLayoutOptions as C, type ChartTableOptions as D, type ChartTextMeasure as E, type ChartTrendFit as F, DEFAULT_CHART_PALETTE as G, DEFAULT_CHART_THEME as H, chartColorInputValue as I, chartColorsByCategory as J, chartDataFromTable as K, chartDataToTable as L, chartFamily as M, chartMovingAverage as N, chartPointColor as O, chartSceneToDomSpec as P, chartSceneToSvg as Q, chartSeriesColor as R, chartSeriesType as S, chartSliceColor as T, chartSupportsTrendlines as U, chartTextBaseline as V, chartTextTransform as W, chartToSvg as X, chartTrendlineName as Y, cloneChartSeries as Z, cloneChartSpec as _, ChartController as a, createChartController as a0, createChartSpec as a1, defaultChartAxis as a2, estimateChartTextWidth as a3, fitChartTrendline as a4, isCartesianChart as a5, isXyChart as a6, layoutSparkline as a7, normalizeChartAxis as a8, normalizeChartErrorBars as a9, normalizeChartSpec as aa, normalizeChartTrendline as ab, normalizeChartValues as ac, parseChartValue as ad, sameChartSelection as ae, sparklineToSvg as af, trendNumberText as ag, uniqueChartSeriesId as ah, type ChartSpecPatch as b, CHART_AXIS_KINDS as c, CHART_AXIS_SCALES as d, CHART_CURVES as e, CHART_LABEL_POSITIONS as f, CHART_LEGEND_POSITIONS as g, CHART_MARKERS as h, CHART_NUMBER_STYLES as i, CHART_ORIENTATIONS as j, CHART_SERIES_TYPES as k, CHART_STACKINGS as l, CHART_TRENDLINE_TYPES as m, CHART_TYPES as n, CHART_TYPE_LABELS as o, CSS_VARIABLE_CHART_THEME as p, type ChartActionResult as q, type ChartControllerOptions as r, type ChartDomSpec as s, type ChartEditOptions as t, type ChartFamily as u, type ChartSeriesInput as v, type ChartSeriesPatch as w, type ChartSparklineKind as x, type ChartSparklineOptions as y, type ChartState as z };