@synertech/ui 0.40.0 → 0.41.0

package/dist/index.d.ts

@@ -365,6 +365,22 @@ interface BarChartProps extends CartesianChartBaseProps, Omit<ComponentPropsWith
     orientation?: BarChartOrientation;
     /** `none` groups the series side by side; the others stack them. */
     stack?: ChartStackMode;
+    /**
+     * Reads the bars against a reference instead of against zero.
+     *
+     * `true` centres on zero and a number centres on that value: the baseline
+     * moves there, bars run both ways from it, and a lone series takes the
+     * diverging ramp — the gap to a target, an index against its base.
+     *
+     * A series KEY centres the stack on that series instead, splitting it evenly
+     * on both sides: the Likert layout, where the middle of an agreement scale
+     * has to sit on the middle of the chart.
+     *
+     * The ramp says which side of the reference a bar falls on and how far. It
+     * never says whether that is good news — a schedule slipping is "above", and
+     * above is not good.
+     */
+    diverging?: boolean | number | string;
     /** Caps the thickness of a mark. Never fills the slot: the leftover is air. */
     barSize?: number;
     /** Orders the categories by their total. */
@@ -388,7 +404,7 @@ interface BarChartProps extends CartesianChartBaseProps, Omit<ComponentPropsWith
  * is read for the length of its mark, and an axis starting at 40 exaggerates
  * every difference on the chart.
  */
-declare function BarChart({ data, series, x, y, height, width, size, grid, legend, tooltip, tableView, emphasis, title, description, loading, emptyState, onPointClick, orientation, stack, barSize, sort, showValues, referenceLines, legendToggle, margin, locale, plotLabel, className, ...props }: BarChartProps): react_jsx_runtime.JSX.Element;
+declare function BarChart({ data, series, x, y, height, width, size, grid, legend, tooltip, tableView, emphasis, title, description, loading, emptyState, onPointClick, orientation, stack, diverging, barSize, sort, showValues, referenceLines, legendToggle, margin, locale, plotLabel, className, ...props }: BarChartProps): react_jsx_runtime.JSX.Element;
 
 type BannerVariant = "notification" | "hero" | "promotion";
 type BannerType = "info" | "success" | "warning" | "error" | "default";
@@ -428,6 +444,83 @@ interface BreadcrumbProps extends ComponentPropsWithoutRef<"nav"> {
 }
 declare function Breadcrumb({ items, separator, size, maxItems, itemColor, activeColor, separatorColor, className, ...props }: BreadcrumbProps): react_jsx_runtime.JSX.Element;
 
+interface BulletChartProps extends Omit<ComponentPropsWithoutRef<"figure">, "children" | "title"> {
+    /** One row per measure. */
+    data: ChartDatum[];
+    /** Field holding the name of each row. */
+    x: ChartXAxisConfig;
+    /** Field holding the figure reached. */
+    value: string;
+    /** Field holding the figure aimed at. Drawn as a tick across the track. */
+    target?: string;
+    /**
+     * Field holding the qualitative range boundaries — an ascending array of
+     * numbers, painted as grey bands behind the bar.
+     */
+    ranges?: string;
+    /** Fixed bounds for every row. Implies a shared scale and a value axis. */
+    domain?: [number, number];
+    /**
+     * `row` gives each row its own scale, which is what lets a revenue and an
+     * NPS share a panel. `shared` puts them all on one scale and draws the value
+     * axis — only meaningful when the rows carry the same unit.
+     */
+    normalize?: "row" | "shared";
+    /** Writes the figure reached after each track. */
+    showValues?: boolean;
+    /** Thickness of a track. */
+    trackSize?: number;
+    /** Replaces the range greys — any CSS colours, darkest first. */
+    rangeColors?: readonly string[];
+    /** Colour of the measure bar. Defaults to the first palette slot. */
+    color?: string;
+    height?: number;
+    width?: number;
+    size?: ChartSize;
+    tooltip?: boolean | ((row: BulletRow) => ReactNode);
+    tableView?: boolean | "toggle";
+    title?: ReactNode;
+    description?: ReactNode;
+    loading?: boolean;
+    emptyState?: ReactNode;
+    locale?: string;
+    plotLabel?: string;
+    /** Header of the value column of the data table. */
+    valueLabel?: string;
+    /** Header of the target column of the data table. */
+    targetLabel?: string;
+    format?: (value: number) => string;
+    onRowClick?: (row: BulletRow) => void;
+}
+/** One measure, as the tooltip and the click handler see it. */
+interface BulletRow {
+    index: number;
+    x: ChartXValue;
+    label: string;
+    value: number | null;
+    target: number | null;
+    ranges: number[];
+    formattedValue: string;
+    formattedTarget: string;
+    /** `value / target`, or `null` when either is missing. */
+    attainment: number | null;
+    datum: ChartDatum;
+}
+/**
+ * What was reached, what was aimed at, and what counts as good — on one line.
+ *
+ * The densest readout of the kit: three measures fit where three gauges would
+ * take the page. It completes `StatCard` rather than competing with it — the
+ * card gives a figure and how it moved, the bullet gives where it stands
+ * against its target.
+ *
+ * Each row is scaled on its own by default, which is what lets a revenue in
+ * dollars and an NPS out of 100 share a panel. That also means there is no
+ * common axis to read across rows: pass `normalize="shared"` (or a `domain`)
+ * when the rows carry the same unit, and the value axis comes back.
+ */
+declare function BulletChart({ data, x, value, target, ranges, domain, normalize, showValues, trackSize, rangeColors, color, height, width, size, tooltip, tableView, title, description, loading, emptyState, locale, plotLabel, valueLabel, targetLabel, format, onRowClick, className, ...props }: BulletChartProps): react_jsx_runtime.JSX.Element;
+
 interface ButtonProps extends ComponentPropsWithoutRef<"button"> {
     label?: string;
     children?: ReactNode;
@@ -793,6 +886,170 @@ interface ChartTooltipContentProps {
  */
 declare function ChartTooltipContent({ title, points }: ChartTooltipContentProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * Number of categorical slots the palette holds.
+ *
+ * Eight is not a round number picked for looks: past it, a generated hue is
+ * indistinguishable from an existing slot for a colour-blind reader. A ninth
+ * series is folded into an "Other" bucket, faceted into several charts, or
+ * given a second channel (shape, texture) — never a ninth colour.
+ */
+declare const CHART_PALETTE_SIZE = 8;
+/**
+ * The eight slots, in the order they are assigned.
+ *
+ * The order is the safety mechanism — it was picked among the orderings that
+ * keep every neighbouring pair distinguishable under simulated protanopia and
+ * deuteranopia, in both themes. The values live in `src/styles/index.css`, so
+ * an application can rebrand the kit without forking a component.
+ */
+declare const CHART_SERIES_COLORS: readonly ["var(--color-chart-1)", "var(--color-chart-2)", "var(--color-chart-3)", "var(--color-chart-4)", "var(--color-chart-5)", "var(--color-chart-6)", "var(--color-chart-7)", "var(--color-chart-8)"];
+/** Grey used for de-emphasised series and for the "Other" bucket. */
+declare const CHART_MUTED_COLOR = "var(--color-chart-muted)";
+/**
+ * Number of series a chart can carry when any two marks may end up side by
+ * side — a scatter or bubble plot. Neighbouring bars and lines only ever
+ * compare adjacent slots, which all eight clear; with every pair in play, only
+ * the first three do.
+ */
+declare const CHART_ALL_PAIRS_LIMIT = 3;
+/**
+ * Colour of the series sitting at `index`.
+ *
+ * Colour follows the series' position in the `series` array — its identity —
+ * so hiding or filtering one series never repaints the others.
+ */
+declare function getSeriesColor(index: number, override?: string): string;
+/**
+ * Colour of a series, taking the chart's `emphasis` into account: the
+ * emphasised series keeps its slot, every other one drops to grey.
+ */
+declare function resolveSeriesColor(series: ChartSeries, index: number, emphasis?: string): string;
+/** Label shown for a series — its own, or its key as a fallback. */
+declare function getSeriesLabel(series: ChartSeries): string;
+/** Builds the legend entries of a series list, colours already resolved. */
+declare function toLegendItems(series: ChartSeries[], emphasis?: string): ChartLegendItem[];
+/** One hue, light to dark: a continuous magnitude (a heat map). */
+declare const CHART_SEQUENTIAL_COLORS: readonly ["var(--color-chart-seq-1)", "var(--color-chart-seq-2)", "var(--color-chart-seq-3)", "var(--color-chart-seq-4)", "var(--color-chart-seq-5)", "var(--color-chart-seq-6)"];
+/** One hue in ordered steps: ranked bands, brackets, a funnel. */
+declare const CHART_ORDINAL_COLORS: readonly ["var(--color-chart-ord-1)", "var(--color-chart-ord-2)", "var(--color-chart-ord-3)", "var(--color-chart-ord-4)", "var(--color-chart-ord-5)"];
+/**
+ * Two opposed poles around a neutral middle: a gap to a reference, a Likert
+ * scale. Blue on one side, orange on the other — two cool hues never read as
+ * opposites.
+ */
+declare const CHART_DIVERGING_COLORS: readonly ["var(--color-chart-div-1)", "var(--color-chart-div-2)", "var(--color-chart-div-3)", "var(--color-chart-div-4)", "var(--color-chart-div-5)", "var(--color-chart-div-6)", "var(--color-chart-div-7)"];
+/** Index of the neutral step of `CHART_DIVERGING_COLORS`. */
+declare const CHART_DIVERGING_NEUTRAL_INDEX = 3;
+declare const CHART_SEQUENTIAL_DARK_STOPS: readonly [false, false, false, false, true, true];
+declare const CHART_ORDINAL_DARK_STOPS: readonly [false, false, true, true, true];
+declare const CHART_DIVERGING_DARK_STOPS: readonly [true, false, false, false, false, false, true];
+/**
+ * Past this many colour classes, two neighbouring cells stop being tellable
+ * apart — the reader sees a texture rather than a scale. A finer grid is read
+ * as a continuous wash, which is what the scale does when `steps` is unset.
+ */
+declare const CHART_MAX_COLOR_CLASSES = 7;
+/** A colour ramp, already bound to the values it has to paint. */
+interface ChartColorScale {
+    /** Colour of a value. Out-of-domain values clamp to the nearest end. */
+    (value: number): string;
+    readonly domain: readonly [number, number];
+    /** The stops, in ramp order — what a legend draws its gradient from. */
+    readonly colors: readonly string[];
+    /** Number of classes the ramp was cut into, or `null` when it is continuous. */
+    readonly steps: number | null;
+    /** Where a value falls along the ramp, from 0 to 1. */
+    position(value: number): number;
+    /**
+     * `true` when the colour under `value` is dark enough that text written on
+     * it has to be light. Always `false` for a ramp brought by the caller,
+     * which the kit knows nothing about.
+     */
+    onDark(value: number): boolean;
+}
+/**
+ * Colour at `t` (0 to 1) along a ramp.
+ *
+ * Between two stops the colour is mixed in OKLab rather than snapped to the
+ * nearer one: a ramp cut into six classes reads as six bands, which is a lie
+ * about a measure that varies continuously. The mix happens in CSS, so the
+ * stops stay overridable variables instead of hex frozen into the bundle.
+ */
+declare function rampColor(colors: readonly string[], t: number): string;
+interface SequentialScaleOptions {
+    /** Cuts the ramp into that many classes instead of leaving it continuous. */
+    steps?: number;
+    /** Replaces the stops — any CSS colours, usually custom properties. */
+    colors?: readonly string[];
+    /**
+     * One flag per stop, saying which ones need light text written on them.
+     * Only worth passing alongside `colors`: the built-in ramps carry their own.
+     */
+    darkStops?: readonly boolean[];
+}
+/**
+ * Maps a magnitude onto the sequential ramp.
+ *
+ * A zero-width domain pins everything to the light end: with a single value
+ * on the grid there is no magnitude to show, and painting it as the maximum
+ * would invent one.
+ */
+declare function createSequentialScale(domain: readonly [number, number], options?: SequentialScaleOptions): ChartColorScale;
+interface DivergingScaleOptions extends SequentialScaleOptions {
+    /** Value the two directions are measured from. Defaults to `0`. */
+    center?: number;
+    /**
+     * Stretches the shorter arm so both cover the same distance. On by default:
+     * with independent arms, a gap of +5 and a gap of −5 come out at different
+     * intensities, which reads as one of them being the bigger miss.
+     */
+    symmetric?: boolean;
+}
+/**
+ * Maps a signed gap onto the diverging pair, neutral at the centre.
+ *
+ * The ramp says which side of the reference a value falls on and how far — it
+ * never says whether that is good news. A schedule slipping is "above", and
+ * above is not good; that judgement belongs to the status colours, which are
+ * reserved for exactly that and always carry a label.
+ */
+declare function createDivergingScale(domain: readonly [number, number], options?: DivergingScaleOptions): ChartColorScale;
+/**
+ * Colour of the `index`-th band of an ordered set.
+ *
+ * Spread across the whole ramp rather than taken from its start, so three
+ * bands use the light, the middle and the dark end instead of three steps
+ * that look alike.
+ */
+declare function getOrdinalColor(index: number, count?: number, colors?: readonly string[]): string;
+
+interface ChartScaleLegendProps extends Omit<ComponentPropsWithoutRef<"div">, "children"> {
+    /** The ramp the chart paints with — usually the one it built for its marks. */
+    scale: ChartColorScale;
+    /** What the colour encodes. Say the measure and its unit, not "legend". */
+    label?: ReactNode;
+    /** Formats the numbers under the bar. */
+    format?: (value: number) => string;
+    /** How many numbers to place. Ignored by a stepped ramp, which labels its classes. */
+    ticks?: number;
+    size?: ChartSize;
+    /** Thickness of the colour bar. */
+    thickness?: number;
+    locale?: string;
+}
+/**
+ * The legend of a colour ramp.
+ *
+ * Mandatory as soon as a colour encodes a magnitude: without it a heat map
+ * shows a pattern and states no value. It is the piece that turns "this cell
+ * is darker" into "this cell is 4 200".
+ *
+ * The bar is laid out in CSS rather than measured, so it needs no container
+ * observation and renders on the server.
+ */
+declare function ChartScaleLegend({ scale, label, format, ticks, size, thickness, locale, className, ...props }: ChartScaleLegendProps): react_jsx_runtime.JSX.Element;
+
 interface ChartTableViewProps extends ComponentPropsWithoutRef<"div"> {
     data: ChartDatum[];
     series: ChartSeries[];
@@ -816,6 +1073,90 @@ interface ChartTableViewProps extends ComponentPropsWithoutRef<"div"> {
  */
 declare function ChartTableView({ data, series, xKey, xLabel, formatX, formatValue, caption, emptyLabel, className, ...props }: ChartTableViewProps): react_jsx_runtime.JSX.Element;
 
+/** One panel, ready to be drawn. */
+interface ChartFacetPanel {
+    /** Stable identity of the panel — the raw value of the splitting field. */
+    key: string;
+    /** That value, formatted. */
+    label: string;
+    /** The rows belonging to this panel, in their original order. */
+    data: ChartDatum[];
+    /**
+     * The value domain EVERY panel has to draw against. Hand it straight to the
+     * chart: panels on free scales cannot be compared, which is the only reason
+     * to put them side by side.
+     */
+    domain: [number, number];
+    index: number;
+    count: number;
+}
+interface ChartFacetsProps extends Omit<ComponentPropsWithoutRef<"div">, "children" | "title"> {
+    data: ChartDatum[];
+    /** Field the panels are split on. */
+    by: string;
+    /** Fields the shared domain is measured over — the series each panel draws. */
+    values: string[];
+    /** Fixed bounds instead of the ones measured across the whole set. */
+    domain?: [number, number];
+    /**
+     * Keeps zero inside the shared domain. Off by default, which suits the lines
+     * and sparklines a facet grid usually holds; turn it on for bars, which are
+     * read for the length of their mark.
+     */
+    includeZero?: boolean;
+    /** Target tick count, which drives how the shared bounds are rounded. */
+    ticks?: number;
+    /** Explicit panel order. Values missing from the data are skipped. */
+    order?: ChartXValue[];
+    /** Orders the panels by their total instead. */
+    sort?: "none" | "asc" | "desc";
+    /** Fixed number of columns. Defaults to as many as `minPanelWidth` allows. */
+    columns?: number;
+    /** Narrowest a panel may get before the grid drops to fewer columns. */
+    minPanelWidth?: number;
+    formatLabel?: (value: ChartXValue, index: number) => string;
+    /** Hides the panel captions — for a grid whose charts carry their own title. */
+    showLabels?: boolean;
+    title?: ReactNode;
+    description?: ReactNode;
+    size?: ChartSize;
+    locale?: string;
+    emptyState?: ReactNode;
+    children: (panel: ChartFacetPanel) => ReactNode;
+}
+/**
+ * Small multiples: one chart repeated across a dimension, on a shared scale.
+ *
+ * Not a chart — a layout. It is the answer two components of the kit already
+ * give without it existing: `ScatterChart` caps itself at three series and
+ * `PieChart` folds its tail, both on the grounds that the rest belongs in
+ * separate panels.
+ *
+ * What makes it work is the one thing it computes itself: the value domain is
+ * measured across the whole set and imposed on every panel. Panels on free
+ * scales look comparable and are not, which is worse than not faceting at all.
+ *
+ * ```tsx
+ * <ChartFacets data={rows} by="region" values={["revenue"]}>
+ *   {({ data, domain, label }) => (
+ *     <LineChart
+ *       data={data}
+ *       series={[{ key: "revenue" }]}
+ *       x={{ key: "month" }}
+ *       y={{ domain }}
+ *       plotLabel={label}
+ *       height={140}
+ *     />
+ *   )}
+ * </ChartFacets>
+ * ```
+ *
+ * No hooks: the grid is laid out in CSS, so it renders on the server.
+ */
+declare function ChartFacets({ data, by, values, domain, includeZero, ticks, order, sort, columns, minPanelWidth, formatLabel, showLabels, title, description, size, locale, emptyState, children, className, ...props }: ChartFacetsProps): react_jsx_runtime.JSX.Element;
+/** Resets the one-shot panel-count warning. Test helper. */
+declare function resetFacetWarnings(): void;
+
 /**
  * Width a chart draws at before its container has been measured.
  *
@@ -846,50 +1187,6 @@ interface UseChartSizeResult<T extends HTMLElement> {
  */
 declare function useChartSize<T extends HTMLElement = HTMLDivElement>(options?: UseChartSizeOptions): UseChartSizeResult<T>;
 
-/**
- * Number of categorical slots the palette holds.
- *
- * Eight is not a round number picked for looks: past it, a generated hue is
- * indistinguishable from an existing slot for a colour-blind reader. A ninth
- * series is folded into an "Other" bucket, faceted into several charts, or
- * given a second channel (shape, texture) — never a ninth colour.
- */
-declare const CHART_PALETTE_SIZE = 8;
-/**
- * The eight slots, in the order they are assigned.
- *
- * The order is the safety mechanism — it was picked among the orderings that
- * keep every neighbouring pair distinguishable under simulated protanopia and
- * deuteranopia, in both themes. The values live in `src/styles/index.css`, so
- * an application can rebrand the kit without forking a component.
- */
-declare const CHART_SERIES_COLORS: readonly ["var(--color-chart-1)", "var(--color-chart-2)", "var(--color-chart-3)", "var(--color-chart-4)", "var(--color-chart-5)", "var(--color-chart-6)", "var(--color-chart-7)", "var(--color-chart-8)"];
-/** Grey used for de-emphasised series and for the "Other" bucket. */
-declare const CHART_MUTED_COLOR = "var(--color-chart-muted)";
-/**
- * Number of series a chart can carry when any two marks may end up side by
- * side — a scatter or bubble plot. Neighbouring bars and lines only ever
- * compare adjacent slots, which all eight clear; with every pair in play, only
- * the first three do.
- */
-declare const CHART_ALL_PAIRS_LIMIT = 3;
-/**
- * Colour of the series sitting at `index`.
- *
- * Colour follows the series' position in the `series` array — its identity —
- * so hiding or filtering one series never repaints the others.
- */
-declare function getSeriesColor(index: number, override?: string): string;
-/**
- * Colour of a series, taking the chart's `emphasis` into account: the
- * emphasised series keeps its slot, every other one drops to grey.
- */
-declare function resolveSeriesColor(series: ChartSeries, index: number, emphasis?: string): string;
-/** Label shown for a series — its own, or its key as a fallback. */
-declare function getSeriesLabel(series: ChartSeries): string;
-/** Builds the legend entries of a series list, colours already resolved. */
-declare function toLegendItems(series: ChartSeries[], emphasis?: string): ChartLegendItem[];
-
 interface CheckboxProps extends Omit<ComponentPropsWithoutRef<"input">, "size" | "onChange" | "type"> {
     checked?: boolean;
     defaultChecked?: boolean;
@@ -1886,6 +2183,86 @@ declare namespace Label {
     var displayName: string;
 }
 
+interface HeatmapProps extends Omit<ComponentPropsWithoutRef<"figure">, "children" | "title"> {
+    /** One row per cell: its column, its row and its value. */
+    data: ChartDatum[];
+    /** Field holding the column each cell belongs to. */
+    x: ChartXAxisConfig;
+    /** Field holding the row each cell belongs to. */
+    y: ChartXAxisConfig;
+    /** Field holding the value the colour encodes. */
+    value: string;
+    /** Formats a value, in the cells, the legend, the tooltip and the table. */
+    format?: (value: number) => string;
+    /** Bounds the ramp covers. Defaults to the extent of the data. */
+    domain?: [number, number];
+    /**
+     * `sequential` paints a magnitude, `diverging` a gap on either side of
+     * `center` — a correlation matrix, a variance against a target.
+     */
+    scale?: "sequential" | "diverging";
+    /** Middle of a diverging ramp. Defaults to `0`. */
+    center?: number;
+    /**
+     * Cuts the ramp into that many classes. Left unset the wash is continuous,
+     * which is how a fine grid is read anyway.
+     */
+    steps?: number;
+    /** Replaces the ramp stops — any CSS colours. */
+    colors?: readonly string[];
+    /** Column order. Defaults to first appearance in the data. */
+    xDomain?: ChartXValue[];
+    /** Row order. Defaults to first appearance in the data. */
+    yDomain?: ChartXValue[];
+    /** Surface gap between two cells. */
+    cellGap?: number;
+    cellRadius?: number;
+    /** Writes the value inside each cell that has room for it. */
+    showValues?: boolean;
+    height?: number;
+    width?: number;
+    size?: ChartSize;
+    /** The scale legend. Mandatory reading, so it shows unless turned off. */
+    legend?: boolean | ChartLegendPosition;
+    /** What the colour encodes — the measure and its unit. */
+    legendLabel?: ReactNode;
+    tooltip?: boolean | ((cell: HeatmapCell) => ReactNode);
+    tableView?: boolean | "toggle";
+    title?: ReactNode;
+    description?: ReactNode;
+    loading?: boolean;
+    emptyState?: ReactNode;
+    locale?: string;
+    plotLabel?: string;
+    onCellClick?: (cell: HeatmapCell) => void;
+}
+/** A cell, as the tooltip and the click handler see it. */
+interface HeatmapCell {
+    x: ChartXValue;
+    y: ChartXValue;
+    xLabel: string;
+    yLabel: string;
+    /** `null` when the pair is missing from the data. */
+    value: number | null;
+    formattedValue: string;
+    color: string;
+    datum?: ChartDatum;
+}
+/**
+ * A magnitude on a grid: load by day and hour, retention by cohort, a
+ * correlation matrix.
+ *
+ * The one chart of the kit where colour carries the measure rather than the
+ * identity — which is why the scale legend is on by default and why the data
+ * table matters more here than anywhere else. A grid without its legend shows
+ * a pattern and states no value.
+ *
+ * The ramp stays continuous unless `steps` cuts it: past seven classes two
+ * neighbouring cells stop being tellable apart, and a fine grid is read as a
+ * wash anyway.
+ */
+declare function Heatmap({ data, x, y, value, format, domain, scale, center, steps, colors, xDomain, yDomain, cellGap, cellRadius, showValues, height, width, size, legend, legendLabel, tooltip, tableView, title, description, loading, emptyState, locale, plotLabel, onCellClick, className, ...props }: HeatmapProps): react_jsx_runtime.JSX.Element;
+
 interface LineChartProps extends CartesianChartBaseProps, Omit<ComponentPropsWithoutRef<"figure">, keyof CartesianChartBaseProps | "children" | "title"> {
     curve?: ChartCurve;
     /**
@@ -3083,6 +3460,10 @@ interface UILabels {
     chartLoading: string;
     /** Bucket the smallest slices of a pie chart are folded into. */
     chartOther: string;
+    /** Header of the "reached" column of a bullet chart's data table. */
+    chartValue: string;
+    /** Header of the "aimed at" column of a bullet chart's data table. */
+    chartTarget: string;
 }
 /** English labels, used when no provider is mounted. */
 declare const defaultUILabels: UILabels;
@@ -3168,4 +3549,4 @@ declare function isFocusable(element: HTMLElement): boolean;
  */
 declare function getFocusableElements(container: HTMLElement): HTMLElement[];
 
-export { Accordion, AccordionContent, type AccordionContentProps, AccordionItem, type AccordionItemProps, type AccordionProps, type AccordionSize, AccordionTrigger, type AccordionTriggerProps, type AccordionType, type AccordionVariant, AdvanceDetachable, type AdvanceDetachableProps, type AdvanceDetachableRef, type AdvanceDetachableRenderContext, type AggregateFunction, type Align, AreaChart, type AreaChartProps, Avatar, type AvatarProps, Badge, type BadgeColor, type BadgeProps, type BadgeSize, type BadgeVariant, Banner, type BannerProps, type BannerType, type BannerVariant, BarChart, type BarChartOrientation, type BarChartProps, Breadcrumb, type BreadcrumbItem, type BreadcrumbProps, Button, ButtonGroup, type ButtonGroupProps, type ButtonProps, CHART_ALL_PAIRS_LIMIT, CHART_MUTED_COLOR, CHART_PALETTE_SIZE, CHART_SERIES_COLORS, Calendar, type CalendarColor, type CalendarDateRange, type CalendarDayState, type CalendarLabels, type CalendarMode, type CalendarProps, type CalendarSize, type CalendarWeekStart, Card, CardBody, type CardBodyProps, CardDescription, type CardDescriptionProps, CardFooter, type CardFooterProps, CardHeader, type CardHeaderProps, CardImage, type CardImageProps, type CardProps, CardTitle, type CardTitleProps, type CartesianChartBaseProps, ChartAxis, type ChartAxisOrientation, type ChartAxisProps, ChartContainer, type ChartContainerProps, type ChartContainerRenderArgs, type ChartCurve, type ChartDatum, type ChartDimensions, ChartGrid, type ChartGridLines, type ChartGridProps, ChartLegend, type ChartLegendItem, type ChartLegendMarker, type ChartLegendPosition, type ChartLegendProps, type ChartMargin, type ChartPoint, type ChartPointEvent, type ChartReferenceLine, type ChartScaleType, type ChartSeries, type ChartSize, ChartTableView, type ChartTableViewProps, type ChartTick, ChartTooltip, ChartTooltipContent, type ChartTooltipContentProps, type ChartTooltipPayload, type ChartTooltipProps, type ChartXAxisConfig, type ChartXValue, type ChartYAxisConfig, Checkbox, CheckboxGroup, CheckboxGroupItem, type CheckboxGroupItemProps, type CheckboxGroupProps, type CheckboxProps, Chip, type ChipColor, type ChipProps, type ChipSize, type ChipVariant, CircularProgress, type CircularProgressColor, type CircularProgressProps, type CircularProgressSize, type CircularProgressThickness, type ColumnDef, DEFAULT_CHART_WIDTH, DEFAULT_FIELD_TYPES, DataGrid, type DataGridMode, type DataGridProps, type DataGridRef, type Density, Detachable, type DetachableProps, type DetachableRef, DeviceMockup, type DeviceMockupProps, type DeviceOrientation, type DeviceSize, type DeviceTheme, type DeviceType, type DialogA11yProps, type DialogInitialFocus, type DialogReturnFocus, Divider, type DividerOrientation, type DividerProps, type DividerTextAlign, type DividerVariant, Drawer, type DrawerPosition, type DrawerProps, type DrawerSize, Dropdown, DropdownCheckboxItem, type DropdownCheckboxItemProps, DropdownContent, type DropdownContentProps, type DropdownContextValue, DropdownItem, type DropdownItemProps, DropdownLabel, type DropdownLabelProps, type DropdownProps, DropdownRadioGroup, type DropdownRadioGroupProps, DropdownRadioItem, type DropdownRadioItemProps, DropdownSeparator, type DropdownSeparatorProps, DropdownSubMenu, DropdownSubMenuContent, type DropdownSubMenuContentProps, type DropdownSubMenuProps, DropdownSubMenuTrigger, type DropdownSubMenuTriggerProps, DropdownTrigger, type DropdownTriggerProps, FOCUSABLE_SELECTOR, FileSelector, type FileSelectorProps, type FilterOperator, type FilterType, type FilterValue, Footer, FooterBottom, type FooterBottomProps, FooterColumn, type FooterColumnProps, FooterLink, type FooterLinkProps, type FooterProps, FooterSection, type FooterSectionProps, FooterSocial, FooterSocialLink, type FooterSocialLinkProps, type FooterSocialProps, Header, type HeaderProps, HelpButton, type HelpButtonProps, INERT_IGNORE_ATTRIBUTE, ImageUploader, type ImageUploaderProps, Indicator, type IndicatorColor, type IndicatorPlacement, type IndicatorProps, type IndicatorSize, type IndicatorVariant, Input, type InputProps, Label, type LabelColor, type LabelProps, type LabelSize, type LabelVariant, type LabelWeight, LineChart, type LineChartProps, MarkdownEditorComponent, type MentionData, MentionInput, type MentionInputProps, type MentionInputValue, type MentionSuggestion, Modal, type ModalProps, type NavItem, type NodeRegistryEntry, NumberInput, type NumberInputProps, Pagination, type PaginationConfig, type PaginationProps, PieChart, type PieChartProps, type Position, ProgressBar, type ProgressBarColor, type ProgressBarProps, type ProgressBarSize, type ProgressBarVariant, RadioButton, type RadioButtonProps, ScatterChart, type ScatterChartProps, SchemaEditor, type SchemaEditorProps, type SchemaEditorRef, type SchemaField, type SchemaFieldEvent, type SchemaFieldType, type SchemaRelation, type SchemaRelationCardinality, type SchemaTable, type SchemaTableEvent, type SchemaValue, type SchemaViewport, Select, type SelectOption, type SelectProps, type SelectedFile, type SelectionMode, type Side, Sidebar, SidebarContent, type SidebarContentProps, SidebarFooter, type SidebarFooterProps, SidebarGroup, type SidebarGroupProps, SidebarHeader, type SidebarHeaderProps, SidebarItem, type SidebarItemProps, type SidebarPosition, type SidebarProps, SidebarSubMenu, type SidebarSubMenuProps, SidebarToggle, type SidebarToggleProps, type SidebarVariant, Skeleton, type SkeletonAnimation, type SkeletonProps, type SkeletonVariant, Slider, type SliderColor, type SliderMark, type SliderProps, type SliderSize, type SortDirection, type SortState, Sparkline, type SparklineProps, StatCard, type StatCardDelta, type StatCardDeltaDirection, type StatCardDeltaTone, StatCardGroup, type StatCardGroupProps, type StatCardProps, Table, TableBody, type TableBodyProps, TableCell, type TableCellProps, TableHeader, TableHeaderCell, type TableHeaderCellProps, type TableHeaderProps, type TableProps, TableRow, type TableRowProps, Tabs, type TabsColor, TabsContent, type TabsContentProps, TabsList, type TabsListProps, type TabsOrientation, type TabsProps, type TabsSize, TabsTrigger, type TabsTriggerProps, type TabsVariant, Toast, type ToastPosition, type ToastProps, type ToastType, type ToastVariant, Tooltip, type TooltipPosition, type TooltipProps, type TooltipSize, type TooltipTrigger, type TooltipVariant, type UILabels, UILabelsProvider, type UILabelsProviderProps, type UseChartSizeOptions, type UseChartSizeResult, type UseDialogA11yOptions, type UseDialogA11yResult, type UseKeyboardNavigationOptions, type UsePositioningOptions, WithHelpButton, type WithHelpButtonProps, Wizard, WizardActions, type WizardActionsProps, type WizardColor, WizardContent, type WizardContentProps, type WizardContextValue, type WizardDirection, WizardNext, type WizardNextProps, type WizardOrientation, WizardPanel, type WizardPanelProps, WizardPrevious, type WizardPreviousProps, type WizardProps, type WizardSize, type WizardStepChangeMeta, type WizardStepDefinition, type WizardStepStatus, WizardSteps, type WizardStepsProps, type WizardVariant, type WorkflowDirection, type WorkflowEdge, WorkflowEditor, type WorkflowEditorProps, type WorkflowEditorRef, type WorkflowNode, type WorkflowNodeAction, type WorkflowNodeActionEvent, type WorkflowNodeActionPosition, type WorkflowNodeEvent, type WorkflowPort, type WorkflowValue, type WorkflowViewport, autoLayoutTables, cn, createDefaultField, createDefaultTable, defaultUILabels, findOwnedLayers, frenchUILabels, generateFieldId, generateRelationId, generateSQL, generateTableId, getFocusableElements, getSeriesColor, getSeriesLabel, hideOthers, isElementVisible, isFocusable, registerFloatingLayer, resolveSeriesColor, toLegendItems, useChartSize, useClickOutside, useDialogA11y, useDropdownContext, useFocusItem, useKeyboardNavigation, usePositioning, useSidebar, useUILabels, useWizard };
+export { Accordion, AccordionContent, type AccordionContentProps, AccordionItem, type AccordionItemProps, type AccordionProps, type AccordionSize, AccordionTrigger, type AccordionTriggerProps, type AccordionType, type AccordionVariant, AdvanceDetachable, type AdvanceDetachableProps, type AdvanceDetachableRef, type AdvanceDetachableRenderContext, type AggregateFunction, type Align, AreaChart, type AreaChartProps, Avatar, type AvatarProps, Badge, type BadgeColor, type BadgeProps, type BadgeSize, type BadgeVariant, Banner, type BannerProps, type BannerType, type BannerVariant, BarChart, type BarChartOrientation, type BarChartProps, Breadcrumb, type BreadcrumbItem, type BreadcrumbProps, BulletChart, type BulletChartProps, type BulletRow, Button, ButtonGroup, type ButtonGroupProps, type ButtonProps, CHART_ALL_PAIRS_LIMIT, CHART_DIVERGING_COLORS, CHART_DIVERGING_DARK_STOPS, CHART_DIVERGING_NEUTRAL_INDEX, CHART_MAX_COLOR_CLASSES, CHART_MUTED_COLOR, CHART_ORDINAL_COLORS, CHART_ORDINAL_DARK_STOPS, CHART_PALETTE_SIZE, CHART_SEQUENTIAL_COLORS, CHART_SEQUENTIAL_DARK_STOPS, CHART_SERIES_COLORS, Calendar, type CalendarColor, type CalendarDateRange, type CalendarDayState, type CalendarLabels, type CalendarMode, type CalendarProps, type CalendarSize, type CalendarWeekStart, Card, CardBody, type CardBodyProps, CardDescription, type CardDescriptionProps, CardFooter, type CardFooterProps, CardHeader, type CardHeaderProps, CardImage, type CardImageProps, type CardProps, CardTitle, type CardTitleProps, type CartesianChartBaseProps, ChartAxis, type ChartAxisOrientation, type ChartAxisProps, type ChartColorScale, ChartContainer, type ChartContainerProps, type ChartContainerRenderArgs, type ChartCurve, type ChartDatum, type ChartDimensions, type ChartFacetPanel, ChartFacets, type ChartFacetsProps, ChartGrid, type ChartGridLines, type ChartGridProps, ChartLegend, type ChartLegendItem, type ChartLegendMarker, type ChartLegendPosition, type ChartLegendProps, type ChartMargin, type ChartPoint, type ChartPointEvent, type ChartReferenceLine, ChartScaleLegend, type ChartScaleLegendProps, type ChartScaleType, type ChartSeries, type ChartSize, ChartTableView, type ChartTableViewProps, type ChartTick, ChartTooltip, ChartTooltipContent, type ChartTooltipContentProps, type ChartTooltipPayload, type ChartTooltipProps, type ChartXAxisConfig, type ChartXValue, type ChartYAxisConfig, Checkbox, CheckboxGroup, CheckboxGroupItem, type CheckboxGroupItemProps, type CheckboxGroupProps, type CheckboxProps, Chip, type ChipColor, type ChipProps, type ChipSize, type ChipVariant, CircularProgress, type CircularProgressColor, type CircularProgressProps, type CircularProgressSize, type CircularProgressThickness, type ColumnDef, DEFAULT_CHART_WIDTH, DEFAULT_FIELD_TYPES, DataGrid, type DataGridMode, type DataGridProps, type DataGridRef, type Density, Detachable, type DetachableProps, type DetachableRef, DeviceMockup, type DeviceMockupProps, type DeviceOrientation, type DeviceSize, type DeviceTheme, type DeviceType, type DialogA11yProps, type DialogInitialFocus, type DialogReturnFocus, type DivergingScaleOptions, Divider, type DividerOrientation, type DividerProps, type DividerTextAlign, type DividerVariant, Drawer, type DrawerPosition, type DrawerProps, type DrawerSize, Dropdown, DropdownCheckboxItem, type DropdownCheckboxItemProps, DropdownContent, type DropdownContentProps, type DropdownContextValue, DropdownItem, type DropdownItemProps, DropdownLabel, type DropdownLabelProps, type DropdownProps, DropdownRadioGroup, type DropdownRadioGroupProps, DropdownRadioItem, type DropdownRadioItemProps, DropdownSeparator, type DropdownSeparatorProps, DropdownSubMenu, DropdownSubMenuContent, type DropdownSubMenuContentProps, type DropdownSubMenuProps, DropdownSubMenuTrigger, type DropdownSubMenuTriggerProps, DropdownTrigger, type DropdownTriggerProps, FOCUSABLE_SELECTOR, FileSelector, type FileSelectorProps, type FilterOperator, type FilterType, type FilterValue, Footer, FooterBottom, type FooterBottomProps, FooterColumn, type FooterColumnProps, FooterLink, type FooterLinkProps, type FooterProps, FooterSection, type FooterSectionProps, FooterSocial, FooterSocialLink, type FooterSocialLinkProps, type FooterSocialProps, Header, type HeaderProps, Heatmap, type HeatmapCell, type HeatmapProps, HelpButton, type HelpButtonProps, INERT_IGNORE_ATTRIBUTE, ImageUploader, type ImageUploaderProps, Indicator, type IndicatorColor, type IndicatorPlacement, type IndicatorProps, type IndicatorSize, type IndicatorVariant, Input, type InputProps, Label, type LabelColor, type LabelProps, type LabelSize, type LabelVariant, type LabelWeight, LineChart, type LineChartProps, MarkdownEditorComponent, type MentionData, MentionInput, type MentionInputProps, type MentionInputValue, type MentionSuggestion, Modal, type ModalProps, type NavItem, type NodeRegistryEntry, NumberInput, type NumberInputProps, Pagination, type PaginationConfig, type PaginationProps, PieChart, type PieChartProps, type Position, ProgressBar, type ProgressBarColor, type ProgressBarProps, type ProgressBarSize, type ProgressBarVariant, RadioButton, type RadioButtonProps, ScatterChart, type ScatterChartProps, SchemaEditor, type SchemaEditorProps, type SchemaEditorRef, type SchemaField, type SchemaFieldEvent, type SchemaFieldType, type SchemaRelation, type SchemaRelationCardinality, type SchemaTable, type SchemaTableEvent, type SchemaValue, type SchemaViewport, Select, type SelectOption, type SelectProps, type SelectedFile, type SelectionMode, type SequentialScaleOptions, type Side, Sidebar, SidebarContent, type SidebarContentProps, SidebarFooter, type SidebarFooterProps, SidebarGroup, type SidebarGroupProps, SidebarHeader, type SidebarHeaderProps, SidebarItem, type SidebarItemProps, type SidebarPosition, type SidebarProps, SidebarSubMenu, type SidebarSubMenuProps, SidebarToggle, type SidebarToggleProps, type SidebarVariant, Skeleton, type SkeletonAnimation, type SkeletonProps, type SkeletonVariant, Slider, type SliderColor, type SliderMark, type SliderProps, type SliderSize, type SortDirection, type SortState, Sparkline, type SparklineProps, StatCard, type StatCardDelta, type StatCardDeltaDirection, type StatCardDeltaTone, StatCardGroup, type StatCardGroupProps, type StatCardProps, Table, TableBody, type TableBodyProps, TableCell, type TableCellProps, TableHeader, TableHeaderCell, type TableHeaderCellProps, type TableHeaderProps, type TableProps, TableRow, type TableRowProps, Tabs, type TabsColor, TabsContent, type TabsContentProps, TabsList, type TabsListProps, type TabsOrientation, type TabsProps, type TabsSize, TabsTrigger, type TabsTriggerProps, type TabsVariant, Toast, type ToastPosition, type ToastProps, type ToastType, type ToastVariant, Tooltip, type TooltipPosition, type TooltipProps, type TooltipSize, type TooltipTrigger, type TooltipVariant, type UILabels, UILabelsProvider, type UILabelsProviderProps, type UseChartSizeOptions, type UseChartSizeResult, type UseDialogA11yOptions, type UseDialogA11yResult, type UseKeyboardNavigationOptions, type UsePositioningOptions, WithHelpButton, type WithHelpButtonProps, Wizard, WizardActions, type WizardActionsProps, type WizardColor, WizardContent, type WizardContentProps, type WizardContextValue, type WizardDirection, WizardNext, type WizardNextProps, type WizardOrientation, WizardPanel, type WizardPanelProps, WizardPrevious, type WizardPreviousProps, type WizardProps, type WizardSize, type WizardStepChangeMeta, type WizardStepDefinition, type WizardStepStatus, WizardSteps, type WizardStepsProps, type WizardVariant, type WorkflowDirection, type WorkflowEdge, WorkflowEditor, type WorkflowEditorProps, type WorkflowEditorRef, type WorkflowNode, type WorkflowNodeAction, type WorkflowNodeActionEvent, type WorkflowNodeActionPosition, type WorkflowNodeEvent, type WorkflowPort, type WorkflowValue, type WorkflowViewport, autoLayoutTables, cn, createDefaultField, createDefaultTable, createDivergingScale, createSequentialScale, defaultUILabels, findOwnedLayers, frenchUILabels, generateFieldId, generateRelationId, generateSQL, generateTableId, getFocusableElements, getOrdinalColor, getSeriesColor, getSeriesLabel, hideOthers, isElementVisible, isFocusable, rampColor, registerFloatingLayer, resetFacetWarnings, resolveSeriesColor, toLegendItems, useChartSize, useClickOutside, useDialogA11y, useDropdownContext, useFocusItem, useKeyboardNavigation, usePositioning, useSidebar, useUILabels, useWizard };