@synertech/ui 0.42.0 → 0.43.0

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
-import react__default, { ReactNode, ReactElement, ComponentPropsWithoutRef, RefObject, ChangeEvent, MouseEvent, Dispatch, SetStateAction, HTMLAttributes, TableHTMLAttributes, ThHTMLAttributes, TdHTMLAttributes } from 'react';
+import react__default, { ReactNode, ReactElement, ComponentPropsWithoutRef, CSSProperties, RefObject, ChangeEvent, MouseEvent, Dispatch, SetStateAction, HTMLAttributes, TableHTMLAttributes, ThHTMLAttributes, TdHTMLAttributes } from 'react';
 import { M as MarkdownEditorComponent } from './types-99-Ej5og.js';
 export { a as MarkdownEditorProps } from './types-99-Ej5og.js';
 
@@ -243,6 +243,34 @@ interface ChartReferenceLine {
     color?: string;
     dashed?: boolean;
 }
+/** What every annotation carries. */
+interface ChartAnnotationBase {
+    /** The comment itself. Without it an annotation marks a spot and says nothing. */
+    label?: string;
+    /** Any CSS colour. Defaults to a muted grey, which is what keeps it chrome. */
+    color?: string;
+}
+/** A single observation worth commenting, marked where it sits on the plot. */
+interface ChartPointAnnotation extends ChartAnnotationBase {
+    type: "point";
+    x: ChartXValue;
+    /** Value the marker is pinned to, read on the chart's own value axis. */
+    y: number;
+}
+/** A moment: a release, a price change, the day the tracking broke. */
+interface ChartLineAnnotation extends ChartAnnotationBase {
+    type: "line";
+    x: ChartXValue;
+    /** Solid instead of dashed — for a boundary rather than an event. */
+    dashed?: boolean;
+}
+/** A stretch of the category axis: a campaign, an outage, a closed quarter. */
+interface ChartBandAnnotation extends ChartAnnotationBase {
+    type: "band";
+    from: ChartXValue;
+    to: ChartXValue;
+}
+type ChartAnnotation = ChartPointAnnotation | ChartLineAnnotation | ChartBandAnnotation;
 /** An entry of the legend. */
 interface ChartLegendItem {
     key: string;
@@ -256,6 +284,13 @@ interface ChartLegendItem {
      * series drawn as a line cannot wear the same block as the bars beside it.
      */
     marker?: "line" | "rect" | "dot";
+    /**
+     * Texture slot the entry wears, when the chart draws its marks with them.
+     *
+     * The swatch has to carry both channels the plot carries, or the texture is
+     * a pattern the reader cannot map onto anything.
+     */
+    pattern?: number;
 }
 /** A tick, already placed on its axis. */
 interface ChartTick {
@@ -317,6 +352,25 @@ interface AreaChartProps extends CartesianChartBaseProps, Omit<ComponentPropsWit
     baseline?: number;
     connectNulls?: boolean;
     referenceLines?: ChartReferenceLine[];
+    /**
+     * What happened, drawn where it happened: a release, a campaign, an outage.
+     *
+     * The counterpart of `referenceLines`, which marks a threshold on the value
+     * axis. Bands are drawn under the areas, rules and pinned points over them.
+     */
+    annotations?: ChartAnnotation[];
+    /**
+     * Draws each band with a texture on top of its colour.
+     *
+     * The channel a reader falls back on when the hue fails them: severe colour
+     * vision deficiency, a grayscale print, a forced-colours theme. Off by
+     * default — it is an accessibility option, not a decoration.
+     *
+     * Only the bands of a stack take one. An overlay's fill is a 12% wash, thin
+     * enough that no texture survives it, and there the identity is carried by
+     * the edge line rather than by the surface under it.
+     */
+    patterns?: boolean;
     legendToggle?: boolean;
     margin?: Partial<ChartMargin>;
     locale?: string;
@@ -333,7 +387,7 @@ interface AreaChartProps extends CartesianChartBaseProps, Omit<ComponentPropsWit
  * bands, separated by 2px of the surface colour rather than by a border drawn
  * around each one.
  */
-declare function AreaChart({ data, series, x, y, height, width, size, grid, legend, tooltip, tableView, emphasis, title, description, loading, emptyState, onPointClick, curve, stack, baseline, connectNulls, referenceLines, legendToggle, margin, locale, plotLabel, className, ...props }: AreaChartProps): react_jsx_runtime.JSX.Element;
+declare function AreaChart({ data, series, x, y, height, width, size, grid, legend, tooltip, tableView, emphasis, title, description, loading, emptyState, onPointClick, curve, stack, baseline, connectNulls, referenceLines, annotations, patterns, legendToggle, margin, locale, plotLabel, className, ...props }: AreaChartProps): react_jsx_runtime.JSX.Element;
 
 interface AvatarProps extends ComponentPropsWithoutRef<"div"> {
     src?: string;
@@ -418,7 +472,7 @@ declare function binEdges(values: readonly number[], spec?: BinSpec): number[];
  */
 declare function binValues(values: readonly (number | null | undefined)[], spec?: BinSpec): HistogramBin[];
 
-/** Resets the histogram warning. Test helper. */
+/** Resets the one-shot warnings. Test helper. */
 declare function resetBarChartWarnings(): void;
 type BarChartOrientation = CartesianOrientation;
 interface BarChartProps extends CartesianChartBaseProps, Omit<ComponentPropsWithoutRef<"figure">, keyof CartesianChartBaseProps | "children" | "title"> {
@@ -478,6 +532,28 @@ interface BarChartProps extends CartesianChartBaseProps, Omit<ComponentPropsWith
     /** Draws the value at the end of each bar, where it fits without collision. */
     showValues?: boolean;
     referenceLines?: ChartReferenceLine[];
+    /**
+     * What happened, drawn where it happened: a release, a campaign, an outage.
+     *
+     * Read on the category axis, so a **vertical** chart alone takes them: the
+     * horizontal one runs its categories up the side, and a moment placed there
+     * is not a moment any more. They are ignored, with a warning, when the bars
+     * are laid out horizontally.
+     */
+    annotations?: ChartAnnotation[];
+    /**
+     * Draws each series with a texture on top of its colour.
+     *
+     * The channel a reader falls back on when the hue fails them: severe colour
+     * vision deficiency, a grayscale print, a forced-colours theme. Off by
+     * default — it is an accessibility option, not a decoration, and a textured
+     * chart nobody needs textured is just a busier chart.
+     *
+     * Ignored where the bars are painted by their own value (a lone series
+     * against a reference): the ramp measures a magnitude, and a texture can
+     * only say which series a mark belongs to.
+     */
+    patterns?: boolean;
     legendToggle?: boolean;
     margin?: Partial<ChartMargin>;
     locale?: string;
@@ -494,7 +570,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, diverging, bins, curve, 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, bins, curve, barSize, sort, showValues, referenceLines, annotations, patterns, legendToggle, margin, locale, plotLabel, className, ...props }: BarChartProps): react_jsx_runtime.JSX.Element;
 
 type BannerVariant = "notification" | "hero" | "promotion";
 type BannerType = "info" | "success" | "warning" | "error" | "default";
@@ -1215,6 +1291,135 @@ interface ChartTooltipContentProps {
  */
 declare function ChartTooltipContent({ title, points }: ChartTooltipContentProps): react_jsx_runtime.JSX.Element;
 
+interface ChartAnnotationLayerProps {
+    annotations: readonly ChartAnnotation[];
+    /**
+     * Where an x value lands along the category axis, or `null` when it is not
+     * on the plot at all — an annotation for a date outside the window is
+     * skipped rather than drawn on the edge.
+     */
+    xAt: (value: ChartXValue) => number | null;
+    /** Where a value lands along the value axis. */
+    yAt: (value: number) => number;
+    /** Size of the plot area. */
+    width: number;
+    height: number;
+    /**
+     * Width of a band on the category axis, `0` on a point placement.
+     *
+     * A band annotation covers whole categories, so it reaches half a band past
+     * the centres its ends resolve to — otherwise "March to May" is drawn from
+     * the middle of March to the middle of May.
+     */
+    bandwidth?: number;
+    /**
+     * Which half of the layer to draw.
+     *
+     * `under` holds the bands and goes below the marks — a region the data sits
+     * in, not over it. `over` holds the rules and the pinned points, which are
+     * worthless hidden behind an area. A chart renders the component twice, once
+     * on each side of its series.
+     */
+    layer?: "under" | "over";
+}
+/**
+ * The annotation layer: what happened, drawn where it happened.
+ *
+ * Laid out behind the marks for the bands and over them for the lines and the
+ * points. A band is a region the data sits in and belongs under it; a line is
+ * a boundary and is worthless hidden behind an area.
+ *
+ * Everything here is chrome by default — grey, thin, dashed. An annotation
+ * that draws the eye more strongly than the data has become the chart.
+ */
+declare function ChartAnnotationLayer({ annotations, xAt, yAt, width, height, bandwidth, layer, }: ChartAnnotationLayerProps): react_jsx_runtime.JSX.Element | null;
+/**
+ * The annotations, as one sentence for the chart's accessible name.
+ *
+ * An SVG marked `role="img"` exposes its name and nothing inside it, so a
+ * caption drawn on the plot is invisible to a screen reader. The comments are
+ * half of what an annotated chart says, so they are appended to the name the
+ * chart already carries rather than left on the picture alone.
+ */
+declare function describeAnnotations(annotations: readonly ChartAnnotation[] | undefined, prefix: string): string;
+
+/**
+ * The colour a texture is cut through — the chart surface itself.
+ *
+ * Declared in `src/styles/index.css` under both theme scopes, so a stripe is
+ * white on a white panel and gray-800 on a dark one without a component ever
+ * asking which theme is on.
+ */
+declare const CHART_SURFACE_COLOR = "var(--color-chart-surface)";
+/**
+ * The textures, in the order they are handed out.
+ *
+ * One per palette slot, and assigned the same way: by the series' position in
+ * `series`, never by its rank. Hiding a series repaints nothing, and the
+ * texture a reader learnt in the legend is still the one on the plot.
+ *
+ * Every hatch runs at 45° or its mirror at 135°, never horizontal and never
+ * vertical: those two align with the gridlines and with the edges of the
+ * marks, where they read as part of the chrome rather than as a fill. The
+ * first slot is left solid — an untextured mark is itself a texture, and the
+ * easiest of all to tell apart.
+ */
+declare const CHART_PATTERNS: readonly ["solid", "diagonal", "diagonal-reverse", "cross", "dots", "diagonal-wide", "diagonal-reverse-wide", "dots-wide"];
+type ChartPattern = (typeof CHART_PATTERNS)[number];
+/** The texture at `index`, wrapping around once past the last one. */
+declare function getPattern(index: number): ChartPattern;
+/**
+ * Id of the SVG pattern a chart declared for its `index`-th series.
+ *
+ * The base is stripped down to id characters: `useId` returns `:r0:` on React
+ * 18, and a fill pointing at `url(#:r0:-texture-1)` is a fragment reference
+ * browsers are not obliged to resolve.
+ */
+declare function patternId(baseId: string, index: number): string;
+/**
+ * The fill a mark wears.
+ *
+ * The texture when they are on and the slot has one, the flat colour
+ * otherwise — so a chart calls this once and never branches itself.
+ */
+declare function patternFill(enabled: boolean, baseId: string, index: number, color: string): string;
+/** One texture to declare: the slot it belongs to, and the colour it paints. */
+interface ChartPatternEntry {
+    /** Palette slot of the mark — what `patternFill` is called with. */
+    slot: number;
+    color: string;
+}
+interface ChartPatternDefsProps {
+    /** Unique per chart instance — a `useId()`, so two charts never collide. */
+    id: string;
+    /**
+     * The marks to declare a texture for.
+     *
+     * Keyed by slot rather than by position: a pie sorts its slices and a bar
+     * chart hides some of its series, and in both the texture has to keep
+     * following the identity it was handed out to.
+     */
+    entries: readonly ChartPatternEntry[];
+}
+/**
+ * The `<defs>` block holding one texture per series.
+ *
+ * A mark keeps its colour at full strength and the texture is *cut out* of it
+ * in the surface colour, rather than painted over a washed-down fill: a
+ * stacked band has to read as a quantity, and a fill dimmed to make room for
+ * stripes stops doing that.
+ */
+declare function ChartPatternDefs({ id, entries }: ChartPatternDefsProps): react_jsx_runtime.JSX.Element;
+/**
+ * The same texture, in CSS, for the HTML swatch of a legend.
+ *
+ * The legend and the plot have to carry the same two channels, or the texture
+ * becomes noise the reader cannot map onto anything. A gradient reproduces the
+ * SVG tile closely enough at swatch size, and it flips with the theme through
+ * the same surface variable.
+ */
+declare function patternBackground(index: number, color: string): CSSProperties;
+
 /**
  * Number of categorical slots the palette holds.
  *
@@ -1258,8 +1463,14 @@ declare function getSeriesColor(index: number, override?: string): string;
 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[];
+/**
+ * Builds the legend entries of a series list, colours already resolved.
+ *
+ * `patterns` mirrors the chart's own setting: when the marks are textured the
+ * swatches have to be too, since the texture is the channel a reader falls
+ * back on when the hue fails them.
+ */
+declare function toLegendItems(series: ChartSeries[], emphasis?: string, patterns?: boolean): 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. */
@@ -1488,6 +1699,140 @@ declare function ChartFacets({ data, by, values, domain, includeZero, ticks, ord
 /** Resets the one-shot panel-count warning. Test helper. */
 declare function resetFacetWarnings(): void;
 
+interface ChartFilterBarProps extends Omit<ComponentPropsWithoutRef<"div">, "title"> {
+    /** Names the row for assistive technology. Defaults to the translated "Filters". */
+    label?: string;
+    /** Pushed to the far end of the row: an export, a refresh, a saved view. */
+    actions?: ReactNode;
+    /** Keeps the row on screen while a long dashboard scrolls under it. */
+    sticky?: boolean;
+    /** The rule under the row, which is what makes it read as a frame. */
+    bordered?: boolean;
+    size?: ChartSize;
+    children: ReactNode;
+}
+/**
+ * The filters, in one row above everything they frame.
+ *
+ * Not a chart and barely a component — a rule written down as a layout. A
+ * dashboard filtered per card is a dashboard whose numbers stop agreeing: two
+ * panels answer two questions and nothing on screen says so. One row, above
+ * the charts, applying to all of them, is the only arrangement where a reader
+ * can trust that two figures are comparable.
+ *
+ * It composes what the library already has — `ChartPeriodPicker` for the
+ * window, `Select` and `Dropdown` for the dimensions — rather than growing
+ * controls of its own.
+ *
+ * ```tsx
+ * <ChartFilterBar actions={<Button size="sm">Export</Button>}>
+ *   <ChartPeriodPicker value={period} onChange={setPeriod} />
+ *   <Select size="sm" options={regions} value={region} onValueChange={setRegion} />
+ * </ChartFilterBar>
+ * ```
+ */
+declare function ChartFilterBar({ label, actions, sticky, bordered, size, children, className, ...props }: ChartFilterBarProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * The periods a dashboard is read over, resolved to real dates.
+ *
+ * Pure functions on purpose: "the last 30 days" is the kind of thing that is
+ * wrong by one day for a month before anybody notices, and it is much easier
+ * to pin down here than through a rendered picker.
+ */
+/** The windows a filter row offers by name. */
+type ChartPeriodPreset = "7d" | "30d" | "90d" | "12m" | "mtd" | "qtd" | "ytd" | "custom";
+/** A resolved window: where it came from, and the two dates it covers. */
+interface ChartPeriod {
+    /** The entry that produced it. `custom` when the dates were picked by hand. */
+    preset: ChartPeriodPreset;
+    from: Date;
+    to: Date;
+}
+/** The presets a picker offers when it is not told otherwise. */
+declare const DEFAULT_CHART_PERIOD_PRESETS: readonly ChartPeriodPreset[];
+/** Midnight at the start of a day, in the reader's own time zone. */
+declare function startOfDay(date: Date): Date;
+/**
+ * The last millisecond of a day.
+ *
+ * A window ending at midnight drops everything that happened during its last
+ * day — the single most common off-by-one in a dashboard.
+ */
+declare function endOfDay(date: Date): Date;
+/**
+ * Resolves a named window against a reference moment.
+ *
+ * "The last 7 days" counts today as one of them, which is what a reader
+ * expects from a figure that includes what happened this morning.
+ */
+declare function resolvePeriodPreset(preset: ChartPeriodPreset, now?: Date): {
+    from: Date;
+    to: Date;
+};
+/** A named window, resolved into the period a chart is filtered by. */
+declare function createPeriod(preset: ChartPeriodPreset, now?: Date): ChartPeriod;
+/**
+ * The two ends of a window as one string.
+ *
+ * `formatRange` is what a locale expects here — it collapses the parts the two
+ * dates share ("1 – 15 March 2026" rather than twice the month and the year).
+ */
+declare function formatPeriodRange(from: Date, to: Date, locale?: string): string;
+/** `true` when two periods cover the same window, to the millisecond. */
+declare function samePeriod(a: ChartPeriod | undefined, b: ChartPeriod | undefined): boolean;
+
+interface ChartPeriodPickerProps extends Omit<ComponentPropsWithoutRef<"button">, "value" | "defaultValue" | "onChange" | "children"> {
+    /** Controlled window. */
+    value?: ChartPeriod;
+    /** Uncontrolled starting window — a resolved period, or a preset to resolve. */
+    defaultValue?: ChartPeriod | ChartPeriodPreset;
+    onChange?: (period: ChartPeriod) => void;
+    /** Which windows to offer, in the order they are listed. */
+    presets?: readonly ChartPeriodPreset[];
+    /** Offers the calendar, for a window the presets do not cover. */
+    custom?: boolean;
+    /** Overrides a preset's caption, without going through the labels provider. */
+    presetLabels?: Partial<Record<ChartPeriodPreset, string>>;
+    /**
+     * The moment the presets are measured from.
+     *
+     * Injected by a test, and by an application that freezes "today" — a report
+     * generated at 3am must not silently change window at midnight.
+     */
+    now?: Date;
+    /** Bounds of the calendar. A dashboard usually caps it at today. */
+    minDate?: Date;
+    maxDate?: Date;
+    /** Number of months shown side by side by the calendar. */
+    numberOfMonths?: number;
+    weekStartsOn?: CalendarWeekStart;
+    locale?: string;
+    size?: ChartSize;
+    /** Which end of the trigger the panel lines up with. */
+    align?: "start" | "end";
+    disabled?: boolean;
+    /** Names the control when the default "Period" is not specific enough. */
+    label?: string;
+}
+/**
+ * The window a dashboard is read over.
+ *
+ * The one filter every dashboard has, and the one the library was missing:
+ * `Calendar` picks a date and hands it back, which is a different job. This
+ * picks a *period*, offers the windows people actually ask for by name, and
+ * falls back to the calendar for the rest.
+ *
+ * It belongs in a `ChartFilterBar` with the other filters, above the charts
+ * and never inside one of them — a period picked per card is how two panels
+ * end up answering two questions without saying so.
+ *
+ * The presets are resolved against `now` rather than against a clock read
+ * somewhere inside: a window is data, and data a component makes up on its own
+ * cannot be tested, frozen or shared between two charts.
+ */
+declare function ChartPeriodPicker({ value, defaultValue, onChange, presets, custom, presetLabels, now, minDate, maxDate, numberOfMonths, weekStartsOn, locale, size, align, disabled, label, className, ...props }: ChartPeriodPickerProps): react_jsx_runtime.JSX.Element;
+
 /**
  * Width a chart draws at before its container has been measured.
  *
@@ -3020,6 +3365,17 @@ interface LineChartProps extends CartesianChartBaseProps, Omit<ComponentPropsWit
     /** Draws through the gaps instead of breaking the line. */
     connectNulls?: boolean;
     referenceLines?: ChartReferenceLine[];
+    /**
+     * What happened, drawn where it happened: a release, a campaign, an outage.
+     *
+     * The counterpart of `referenceLines`, which marks a threshold on the value
+     * axis. A spike nobody explained is a question rather than an answer, and
+     * the explanation almost always sits on the time axis.
+     *
+     * The captions are appended to the chart's accessible name, since an SVG
+     * exposes nothing drawn inside it.
+     */
+    annotations?: ChartAnnotation[];
     /** Lets the legend show and hide series. */
     legendToggle?: boolean;
     margin?: Partial<ChartMargin>;
@@ -3039,7 +3395,7 @@ interface LineChartProps extends CartesianChartBaseProps, Omit<ComponentPropsWit
  * invent a correlation the data does not carry; plot them as two charts, or
  * index both to a common base.
  */
-declare function LineChart({ data, series, x, y, height, width, size, grid, legend, tooltip, tableView, emphasis, title, description, loading, emptyState, onPointClick, curve, forecastFrom, forecastLabel, markers, connectNulls, referenceLines, legendToggle, margin, locale, plotLabel, className, ...props }: LineChartProps): react_jsx_runtime.JSX.Element;
+declare function LineChart({ data, series, x, y, height, width, size, grid, legend, tooltip, tableView, emphasis, title, description, loading, emptyState, onPointClick, curve, forecastFrom, forecastLabel, markers, connectNulls, referenceLines, annotations, legendToggle, margin, locale, plotLabel, className, ...props }: LineChartProps): react_jsx_runtime.JSX.Element;
 
 interface ModalProps {
     isOpen: boolean;
@@ -3152,6 +3508,17 @@ interface PieChartProps extends Omit<ComponentPropsWithoutRef<"figure">, "childr
     description?: ReactNode;
     loading?: boolean;
     emptyState?: ReactNode;
+    /**
+     * Draws each slice with a texture on top of its colour.
+     *
+     * The channel a reader falls back on when the hue fails them: severe colour
+     * vision deficiency, a grayscale print, a forced-colours theme. Off by
+     * default — it is an accessibility option, not a decoration.
+     *
+     * The folded tail keeps its flat grey: it is the one slice that is not an
+     * identity, and giving it a texture would make it look like one.
+     */
+    patterns?: boolean;
     locale?: string;
     plotLabel?: string;
     onSliceClick?: (slice: {
@@ -3170,7 +3537,7 @@ interface PieChartProps extends Omit<ComponentPropsWithoutRef<"figure">, "childr
  * over six slices at most, which is why the tail folds into a single bucket
  * rather than taking a seventh colour.
  */
-declare function PieChart({ data, x, value, variant, innerRadius, maxSlices, otherLabel, sort, showLabels, centerLabel, height, width, size, legend, tooltip, tableView, title, description, loading, emptyState, locale, plotLabel, onSliceClick, className, ...props }: PieChartProps): react_jsx_runtime.JSX.Element;
+declare function PieChart({ data, x, value, variant, innerRadius, maxSlices, otherLabel, sort, showLabels, centerLabel, patterns, height, width, size, legend, tooltip, tableView, title, description, loading, emptyState, locale, plotLabel, onSliceClick, className, ...props }: PieChartProps): react_jsx_runtime.JSX.Element;
 
 type ProgressBarSize = "xs" | "sm" | "md" | "lg" | "xl";
 type ProgressBarColor = "default" | "primary" | "success" | "warning" | "error" | "info";
@@ -4243,6 +4610,21 @@ interface UILabels {
     chartProgress: string;
     /** Name of the rule marking today on a schedule. */
     chartToday: string;
+    /** Word the annotation captions are announced under in a chart's name. */
+    chartAnnotations: string;
+    /** Accessible name of the filter row above a set of charts. */
+    chartFilters: string;
+    /** Accessible name of the period picker, and its caption when nothing is set. */
+    chartPeriod: string;
+    chartPeriodLast7Days: string;
+    chartPeriodLast30Days: string;
+    chartPeriodLast90Days: string;
+    chartPeriodLast12Months: string;
+    chartPeriodMonthToDate: string;
+    chartPeriodQuarterToDate: string;
+    chartPeriodYearToDate: string;
+    /** Entry opening the calendar, for a window the presets do not cover. */
+    chartPeriodCustom: string;
 }
 /** English labels, used when no provider is mounted. */
 declare const defaultUILabels: UILabels;
@@ -4328,4 +4710,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, type BinSpec, BoxPlot, type BoxPlotBox, type BoxPlotProps, type BoxPlotQuantileKeys, type BoxStats, 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_DOWN_COLOR, 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, CHART_UP_COLOR, Calendar, type CalendarColor, type CalendarDateRange, type CalendarDayState, type CalendarLabels, type CalendarMode, type CalendarProps, type CalendarSize, type CalendarWeekStart, type Candle, CandlestickChart, type CandlestickChartProps, 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, DumbbellChart, type DumbbellChartProps, type DumbbellRow, type DumbbellSort, 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, FunnelChart, type FunnelChartProps, type FunnelStage, GanttChart, type GanttChartProps, type GanttTask, Header, type HeaderProps, Heatmap, type HeatmapCell, type HeatmapProps, HelpButton, type HelpButtonProps, type HistogramBin, 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, type TimeTickScale, type TimeUnit, 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, WaterfallChart, type WaterfallChartProps, type WaterfallKind, type WaterfallStep, 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, binEdges, binValues, boxStats, cn, createDefaultField, createDefaultTable, createDivergingScale, createSequentialScale, defaultUILabels, findOwnedLayers, formatTimeTick, frenchUILabels, generateFieldId, generateRelationId, generateSQL, generateTableId, getFocusableElements, getOrdinalColor, getSeriesColor, getSeriesLabel, hideOthers, isElementVisible, isFocusable, niceTimeTicks, quantile, quantileSorted, rampColor, registerFloatingLayer, resetBarChartWarnings, resetDumbbellWarnings, resetFacetWarnings, resolveSeriesColor, sturgesBins, toLegendItems, toTimestamp, 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, type BinSpec, BoxPlot, type BoxPlotBox, type BoxPlotProps, type BoxPlotQuantileKeys, type BoxStats, 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_DOWN_COLOR, CHART_MAX_COLOR_CLASSES, CHART_MUTED_COLOR, CHART_ORDINAL_COLORS, CHART_ORDINAL_DARK_STOPS, CHART_PALETTE_SIZE, CHART_PATTERNS, CHART_SEQUENTIAL_COLORS, CHART_SEQUENTIAL_DARK_STOPS, CHART_SERIES_COLORS, CHART_SURFACE_COLOR, CHART_UP_COLOR, Calendar, type CalendarColor, type CalendarDateRange, type CalendarDayState, type CalendarLabels, type CalendarMode, type CalendarProps, type CalendarSize, type CalendarWeekStart, type Candle, CandlestickChart, type CandlestickChartProps, Card, CardBody, type CardBodyProps, CardDescription, type CardDescriptionProps, CardFooter, type CardFooterProps, CardHeader, type CardHeaderProps, CardImage, type CardImageProps, type CardProps, CardTitle, type CardTitleProps, type CartesianChartBaseProps, type ChartAnnotation, type ChartAnnotationBase, ChartAnnotationLayer, type ChartAnnotationLayerProps, ChartAxis, type ChartAxisOrientation, type ChartAxisProps, type ChartBandAnnotation, type ChartColorScale, ChartContainer, type ChartContainerProps, type ChartContainerRenderArgs, type ChartCurve, type ChartDatum, type ChartDimensions, type ChartFacetPanel, ChartFacets, type ChartFacetsProps, ChartFilterBar, type ChartFilterBarProps, ChartGrid, type ChartGridLines, type ChartGridProps, ChartLegend, type ChartLegendItem, type ChartLegendMarker, type ChartLegendPosition, type ChartLegendProps, type ChartLineAnnotation, type ChartMargin, type ChartPattern, ChartPatternDefs, type ChartPatternDefsProps, type ChartPatternEntry, type ChartPeriod, ChartPeriodPicker, type ChartPeriodPickerProps, type ChartPeriodPreset, type ChartPoint, type ChartPointAnnotation, 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_PERIOD_PRESETS, 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, DumbbellChart, type DumbbellChartProps, type DumbbellRow, type DumbbellSort, 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, FunnelChart, type FunnelChartProps, type FunnelStage, GanttChart, type GanttChartProps, type GanttTask, Header, type HeaderProps, Heatmap, type HeatmapCell, type HeatmapProps, HelpButton, type HelpButtonProps, type HistogramBin, 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, type TimeTickScale, type TimeUnit, 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, WaterfallChart, type WaterfallChartProps, type WaterfallKind, type WaterfallStep, 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, binEdges, binValues, boxStats, cn, createDefaultField, createDefaultTable, createDivergingScale, createPeriod, createSequentialScale, defaultUILabels, describeAnnotations, endOfDay, findOwnedLayers, formatPeriodRange, formatTimeTick, frenchUILabels, generateFieldId, generateRelationId, generateSQL, generateTableId, getFocusableElements, getOrdinalColor, getPattern, getSeriesColor, getSeriesLabel, hideOthers, isElementVisible, isFocusable, niceTimeTicks, patternBackground, patternFill, patternId, quantile, quantileSorted, rampColor, registerFloatingLayer, resetBarChartWarnings, resetDumbbellWarnings, resetFacetWarnings, resolvePeriodPreset, resolveSeriesColor, samePeriod, startOfDay, sturgesBins, toLegendItems, toTimestamp, useChartSize, useClickOutside, useDialogA11y, useDropdownContext, useFocusItem, useKeyboardNavigation, usePositioning, useSidebar, useUILabels, useWizard };