@acronis-platform/ui-react 0.58.0 → 0.60.0

package/dist/react.js.map

@@ -1 +1 @@
-{"version":3,"file":"react.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"react.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/src/components/ui/area-chart/area-chart.d.ts

@@ -1,11 +1,11 @@
 import { VariantProps } from 'class-variance-authority';
-import { ChartTooltip, ChartConfig } from '../chart';
+import { ChartConfig, CartesianChartProps } from '../chart';
 import * as React from 'react';
 declare const areaChartVariants: (props?: ({
     layout?: "single" | "stacked" | null | undefined;
     fill?: "solid" | "gradient" | null | undefined;
 } & import('class-variance-authority/types').ClassProp) | undefined) => string;
-export interface AreaChartProps extends Omit<React.ComponentProps<'div'>, 'children'>, VariantProps<typeof areaChartVariants> {
+export interface AreaChartProps extends Omit<React.ComponentProps<'div'>, 'children'>, VariantProps<typeof areaChartVariants>, CartesianChartProps {
     /** Row-per-point data. Each object holds the category key + one numeric field per series (`null` breaks the area unless `connectNulls`). */
     data: ReadonlyArray<Record<string, string | number | null>>;
     /**
@@ -18,12 +18,6 @@ export interface AreaChartProps extends Omit<React.ComponentProps<'div'>, 'child
     dataKeys: string[];
     /** Category axis key (the shared dimension across rows, e.g. `"month"`). */
     xKey: string;
-    /** Title rendered beneath the horizontal (X) axis. */
-    xAxisLabel?: string;
-    /** Title rendered beside the vertical (Y) axis (rotated). */
-    yAxisLabel?: string;
-    /** Unit suffix appended to Y-axis tick values (recharts `unit`; the X axis is categorical). */
-    yUnit?: string;
     /** Interpolation between points. */
     curve?: 'linear' | 'monotone' | 'step';
     /** Stroke width of each area's top border. */
@@ -34,16 +28,7 @@ export interface AreaChartProps extends Omit<React.ComponentProps<'div'>, 'child
     showDots?: boolean;
     /** Bridge `null` gaps in the data instead of breaking the area. */
     connectNulls?: boolean;
-    showGrid?: boolean;
-    showTooltip?: boolean;
     showLegend?: boolean;
-    /**
-     * Replace the default tooltip. Pass a configured `ChartTooltipContent`
-     * (imported from this library) — e.g. with a `formatter` / `labelFormatter` /
-     * `indicator` — to customize formatting, per-series rows, or extra fields
-     * without composing recharts yourself. Ignored when `showTooltip` is false.
-     */
-    tooltipContent?: React.ComponentProps<typeof ChartTooltip>['content'];
 }
 declare const AreaChart: React.ForwardRefExoticComponent<Omit<AreaChartProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
 export { AreaChart, areaChartVariants };

package/dist/src/components/ui/bar-chart/bar-chart.d.ts

@@ -1,5 +1,5 @@
 import { VariantProps } from 'class-variance-authority';
-import { ChartTooltip, ChartConfig } from '../chart';
+import { ChartConfig, CartesianChartProps } from '../chart';
 import * as React from 'react';
 declare const barChartVariants: (props?: ({
     orientation?: "horizontal" | "vertical" | null | undefined;
@@ -24,7 +24,7 @@ export interface BarChartReferenceLine {
  * Exported for unit tests; not part of the package's public API.
  */
 export declare function barChartReferenceValue(referenceLine: BarChartReferenceLine | undefined, data: ReadonlyArray<Record<string, string | number>>, dataKeys: string[]): number | undefined;
-export interface BarChartProps extends Omit<React.ComponentProps<'div'>, 'children'>, VariantProps<typeof barChartVariants> {
+export interface BarChartProps extends Omit<React.ComponentProps<'div'>, 'children'>, VariantProps<typeof barChartVariants>, CartesianChartProps {
     /** Row-per-category data. Each object holds the category key + one numeric field per series. */
     data: ReadonlyArray<Record<string, string | number>>;
     /**
@@ -43,26 +43,11 @@ export interface BarChartProps extends Omit<React.ComponentProps<'div'>, 'childr
      * series `average`. Pass a single object or an array to draw several at once.
      */
     referenceLine?: BarChartReferenceLine | BarChartReferenceLine[];
-    /** Title rendered beneath the horizontal (X) axis. */
-    xAxisLabel?: string;
-    /** Title rendered beside the vertical (Y) axis (rotated). */
-    yAxisLabel?: string;
     /** Unit suffix on X-axis tick values (recharts `unit`) — applies when the X axis is numeric (`orientation="horizontal"`). */
     xUnit?: string;
-    /** Unit suffix on Y-axis tick values (recharts `unit`) — applies when the Y axis is numeric (`orientation="vertical"`). */
-    yUnit?: string;
     /** Corner radius applied to the growing end of each bar. */
     barRadius?: number;
-    showGrid?: boolean;
-    showTooltip?: boolean;
     showLegend?: boolean;
-    /**
-     * Replace the default tooltip. Pass a configured `ChartTooltipContent`
-     * (imported from this library) — e.g. with a `formatter` / `labelFormatter` /
-     * `indicator` — to customize formatting, per-series rows, or extra fields
-     * without composing recharts yourself. Ignored when `showTooltip` is false.
-     */
-    tooltipContent?: React.ComponentProps<typeof ChartTooltip>['content'];
 }
 declare const BarChart: React.ForwardRefExoticComponent<Omit<BarChartProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
 export { BarChart, barChartVariants };

package/dist/src/components/ui/carousel-dialog/carousel-dialog.d.ts

@@ -0,0 +1,28 @@
+import * as React from 'react';
+export type CarouselDialogVariant = 'first' | 'middle' | 'last';
+export interface CarouselDialogProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'children'> {
+    /** Which slide position this renders for. Defaults to `'first'`. */
+    variant?: CarouselDialogVariant;
+    /** Total number of slides, used to render the dot `ListIndicator`. Defaults to `1`. */
+    slideCount?: number;
+    /** The currently active slide index (0-based). Defaults to `0`. */
+    selectedIndex?: number;
+    /** Fires when a dot is activated, with the dot's slide index. */
+    onSelectIndex?: (index: number) => void;
+    /** Fires when `Back` (hidden on `variant="first"`) is activated. */
+    onBack?: () => void;
+    /** Fires when `Next` (`variant="first" | "middle"`) is activated. */
+    onNext?: () => void;
+    /** Fires when the call-to-action button (`variant="last"`) is activated. */
+    onPrimaryAction?: () => void;
+    /** `Back` button label. Defaults to `'Back'`. */
+    backLabel?: string;
+    /** `Next` button label (`variant="first" | "middle"`). Defaults to `'Next'`. */
+    nextLabel?: string;
+    /** Call-to-action button label (`variant="last"`). Defaults to `'Call to action'`. */
+    primaryLabel?: string;
+    /** Builds each dot's accessible name from its 0-based index and the slide count. */
+    goToSlideLabel?: (index: number, count: number) => string;
+}
+declare const CarouselDialog: React.ForwardRefExoticComponent<CarouselDialogProps & React.RefAttributes<HTMLDivElement>>;
+export { CarouselDialog };

package/dist/src/components/ui/carousel-dialog/index.d.ts

@@ -0,0 +1 @@
+export { CarouselDialog, type CarouselDialogProps, type CarouselDialogVariant, } from './carousel-dialog';

package/dist/src/components/ui/category-bar/category-bar.d.ts

@@ -0,0 +1,51 @@
+import { VariantProps } from 'class-variance-authority';
+import { ChartConfig } from '../chart';
+import * as React from 'react';
+declare const categoryBarVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
+export interface CategoryBarSegment {
+    /** Key into `config` for this segment's label + color. */
+    key: string;
+    /** The segment's value — its width is this over the sum of all values. */
+    value: number;
+}
+/** The resolved segment passed to a custom `tooltipContent` renderer. */
+export interface CategoryBarTooltipContext extends CategoryBarSegment {
+    /** Resolved `config` label (falls back to the key); may be any `ReactNode`. */
+    label: React.ReactNode;
+    /** Share of the total as a rounded percentage (0–100). */
+    percent: number;
+    /**
+     * CSS color reference for the segment — the `var(--color-<key>)` bridge, which
+     * resolves the config entry's `color` or its per-theme `theme` value. Usable
+     * anywhere a CSS color is (e.g. a `style` background); not a literal value.
+     */
+    color: string;
+}
+export interface CategoryBarProps extends Omit<React.ComponentProps<'div'>, 'children'>, VariantProps<typeof categoryBarVariants> {
+    /** Ordered segments (left → right). Widths are proportional to `value`. */
+    data: ReadonlyArray<CategoryBarSegment>;
+    /** Maps each segment `key` to a `label` and `color` (an existing `--ui-*` token). */
+    config: ChartConfig;
+    /** Show the legend below the bar (color dot + label + value + %). */
+    showLegend?: boolean;
+    /** Show a hover tooltip per segment (dot + label + value + %). */
+    showTooltip?: boolean;
+    /**
+     * Custom tooltip content per segment — replaces the default (dot + label +
+     * `value · %`) inside the same card. Ignored when `showTooltip` is false.
+     */
+    tooltipContent?: (segment: CategoryBarTooltipContext) => React.ReactNode;
+    /** Format the numeric value (legend + tooltip). Defaults to `toLocaleString()`. */
+    valueFormatter?: (value: number) => string;
+    /** Render the tooltip for this segment index initially open (VR/testing). */
+    defaultOpenIndex?: number;
+    /**
+     * Accessible summary of the whole bar. Defaults to a `label value` list built
+     * from the data; pass a fuller sentence for screen readers if you have one.
+     */
+    'aria-label'?: string;
+}
+declare const CategoryBar: React.ForwardRefExoticComponent<Omit<CategoryBarProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export { CategoryBar, categoryBarVariants };

package/dist/src/components/ui/category-bar/index.d.ts

@@ -0,0 +1 @@
+export { CategoryBar, categoryBarVariants, type CategoryBarProps, type CategoryBarSegment, type CategoryBarTooltipContext, } from './category-bar';

package/dist/src/components/ui/chart/__tests__/chart-format.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/components/ui/chart/chart-format.d.ts

@@ -0,0 +1,111 @@
+import { AxisDomainItem } from 'recharts';
+import { ChartTooltipContentType } from './chart';
+/** A recharts-compatible tick formatter: `(value, index) => label`. */
+export type TickFormatter = (value: number | string, index?: number) => string;
+/**
+ * Props shared by every cartesian chart (Bar, Line, Area, Composed, Scatter,
+ * ConfidenceCone, Histogram) — chrome toggles, axis titles/units, tick
+ * formatting/visibility, and grid trim. All optional. `showLegend` and `xUnit`
+ * are deliberately *not* here: `showLegend` doesn't apply to `Histogram` and
+ * `xUnit` only to charts with a numeric X axis, so they stay per-component.
+ */
+export interface CartesianChartProps {
+    /** Render the CartesianGrid. Defaults to `true`. */
+    showGrid?: boolean;
+    /** Render the hover tooltip. Defaults to `true`. */
+    showTooltip?: boolean;
+    /**
+     * Replace the default tooltip. Pass a configured `ChartTooltipContent` (from
+     * this library) — e.g. with a `formatter` / `labelFormatter` — to customize it
+     * without composing recharts yourself. Ignored when `showTooltip` is false.
+     */
+    tooltipContent?: ChartTooltipContentType;
+    /** Title rendered beneath the X axis. */
+    xAxisLabel?: string;
+    /** Title rendered beside the Y axis (rotated). */
+    yAxisLabel?: string;
+    /**
+     * Unit suffix appended to the Y axis's tick values (recharts `unit`) — applies
+     * when the Y axis is the numeric one. `BarChart` with
+     * `orientation="horizontal"` puts the values on X instead; use `xUnit` there.
+     */
+    yUnit?: string;
+    /** Show the X axis (its ticks + title). Defaults to `true`. */
+    showXAxis?: boolean;
+    /** Show the Y axis (its ticks + title). Defaults to `true`. */
+    showYAxis?: boolean;
+    /** Format each X-axis tick value — e.g. `formatCompactNumber` or a `createTickFormatter(...)`. */
+    xTickFormatter?: TickFormatter;
+    /** Format each Y-axis tick value — e.g. `formatCompactNumber` or a `createTickFormatter(...)`. */
+    yTickFormatter?: TickFormatter;
+    /**
+     * Rotate the X-axis tick labels by this many degrees. A negative angle (e.g.
+     * `-45`) tilts them up toward the right; the tick anchor + axis height adjust
+     * to keep long labels readable.
+     */
+    xAxisAngle?: number;
+    /**
+     * X-axis tick density — a recharts placement strategy, or a fixed number of
+     * ticks to *skip* between two rendered ones (recharts `interval`: `0` shows
+     * every tick, `1` every other one, `2` every third, …).
+     */
+    xAxisInterval?: number | 'preserveStart' | 'preserveEnd' | 'preserveStartEnd' | 'equidistantPreserveStart';
+    /**
+     * Desired number of ticks on the value axis (recharts `tickCount`; a hint, not
+     * exact). Applies to whichever axis holds the values — Y for most charts, X for
+     * `BarChart` with `orientation="horizontal"`.
+     */
+    yAxisTickCount?: number;
+    /**
+     * Value-axis domain preset. Applies to whichever axis holds the values — Y for
+     * most charts, X for `BarChart` with `orientation="horizontal"`.
+     *
+     * - `auto` — fit the data at both ends; the axis need not include 0.
+     * - `zero` — anchor the axis at 0. This is also recharts' behavior when the
+     *   prop is omitted, so it's the explicit form of the default.
+     * - `dataMin-dataMax` — tight to the data, with no padding.
+     */
+    yAxisDomain?: 'auto' | 'dataMin-dataMax' | 'zero';
+    /** Draw grid lines dashed instead of solid. */
+    gridDashed?: boolean;
+    /** Show horizontal grid lines. Defaults to each chart's own default when unset. */
+    gridHorizontal?: boolean;
+    /** Show vertical grid lines. Defaults to each chart's own default when unset. */
+    gridVertical?: boolean;
+}
+/**
+ * Map a `yAxisDomain` preset to a recharts `domain`. Shared by all 7 cartesian
+ * charts, and applied to whichever axis holds the values (X for horizontal bars).
+ *
+ * `undefined` (no preset) is left to recharts, whose default is `[0, 'auto']` —
+ * i.e. already zero-anchored. That's why `auto` has to be spelled out as
+ * `['auto', 'auto']`: passing `undefined` for it would silently anchor at 0 and
+ * make the preset indistinguishable from `zero`.
+ */
+export declare function resolveAxisDomain(preset: 'auto' | 'dataMin-dataMax' | 'zero' | undefined): Readonly<[AxisDomainItem, AxisDomainItem]> | undefined;
+/**
+ * Compact thousands/millions: `1234 → "1.2K"`, `1_500_000 → "1.5M"`. Non-numeric
+ * values (including blank strings) pass through unchanged. Use for large-count
+ * axes (revenue, users, …).
+ *
+ * Formats in `en`. For another locale use
+ * `createTickFormatter({ notation: 'compact', maximumFractionDigits: 1 }, locale)`.
+ */
+export declare const formatCompactNumber: TickFormatter;
+/**
+ * Append a percent sign to an already-scaled value: `41.8 → "41.8%"`. (The value
+ * is treated as a percentage, not a 0–1 fraction.) Non-numeric values (including
+ * blank strings) pass through.
+ *
+ * Appends a bare `%`, which is not how every locale writes it. For locale-correct
+ * output on values that really are fractions, use
+ * `createTickFormatter({ style: 'percent' }, locale)`.
+ */
+export declare const formatPercent: TickFormatter;
+/**
+ * Build a tick formatter from `Intl.NumberFormat` options — the escape hatch for
+ * currency, fixed decimals, or a specific locale. E.g.
+ * `createTickFormatter({ style: 'currency', currency: 'USD', notation: 'compact' })`
+ * → `146500 → "$147K"`. Non-numeric values pass through unchanged.
+ */
+export declare function createTickFormatter(options: Intl.NumberFormatOptions, locale?: string): TickFormatter;

package/dist/src/components/ui/chart/chart.d.ts

@@ -49,6 +49,8 @@ declare const ChartStyle: ({ id, config }: {
     config: ChartConfig;
 }) => import("react/jsx-runtime").JSX.Element | null;
 declare const ChartTooltip: typeof RechartsPrimitive.Tooltip;
+/** The `content` a caller passes to override the default tooltip (recharts' `Tooltip['content']`). */
+export type ChartTooltipContentType = React.ComponentProps<typeof ChartTooltip>['content'];
 declare function ChartTooltipContent({ active, payload, label, className, indicator, hideLabel, hideIndicator, labelFormatter, formatter, labelClassName, color, nameKey, labelKey, }: ChartTooltipContentProps): import("react/jsx-runtime").JSX.Element | null;
 declare const ChartLegend: React.MemoExoticComponent<(outsideProps: RechartsPrimitive.LegendProps) => React.ReactPortal | null>;
 declare function ChartLegendContent({ className, hideIcon, payload, verticalAlign, nameKey, }: ChartLegendContentProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/src/components/ui/chart/index.d.ts

@@ -1,2 +1,4 @@
 export { ChartContainer, ChartTooltip, ChartTooltipContent, ChartLegend, ChartLegendContent, ChartStyle, } from './chart';
-export type { ChartConfig, ChartContainerProps, ChartTooltipContentProps, ChartLegendContentProps, } from './chart';
+export type { ChartConfig, ChartContainerProps, ChartTooltipContentProps, ChartLegendContentProps, ChartTooltipContentType, } from './chart';
+export { formatCompactNumber, formatPercent, createTickFormatter, resolveAxisDomain, } from './chart-format';
+export type { TickFormatter, CartesianChartProps } from './chart-format';

package/dist/src/components/ui/composed-chart/composed-chart.d.ts

@@ -1,4 +1,4 @@
-import { ChartTooltip, ChartConfig } from '../chart';
+import { ChartConfig, CartesianChartProps } from '../chart';
 import * as React from 'react';
 export type ComposedSeriesType = 'bar' | 'line' | 'area';
 export interface ComposedSeries {
@@ -7,7 +7,7 @@ export interface ComposedSeries {
     /** How this series renders. */
     type: ComposedSeriesType;
 }
-export interface ComposedChartProps extends Omit<React.ComponentProps<'div'>, 'children'> {
+export interface ComposedChartProps extends Omit<React.ComponentProps<'div'>, 'children'>, CartesianChartProps {
     /** Row-per-category data. Each object holds `xKey` + one numeric field per series. */
     data: ReadonlyArray<Record<string, string | number>>;
     /**
@@ -21,28 +21,13 @@ export interface ComposedChartProps extends Omit<React.ComponentProps<'div'>, 'c
     series: ComposedSeries[];
     /** Category axis key (the shared dimension across rows, e.g. `"month"`). */
     xKey: string;
-    /** Title rendered beneath the horizontal (X) axis. */
-    xAxisLabel?: string;
-    /** Title rendered beside the vertical (Y) axis (rotated). */
-    yAxisLabel?: string;
-    /** Unit suffix appended to Y-axis tick values (recharts `unit`; the X axis is categorical). */
-    yUnit?: string;
     /** Interpolation for the line and area series. */
     curve?: 'linear' | 'monotone' | 'step';
     /** Corner radius on the growing end of bar series. */
     barRadius?: number;
     /** Flat-fill opacity for area series. */
     fillOpacity?: number;
-    showGrid?: boolean;
-    showTooltip?: boolean;
     showLegend?: boolean;
-    /**
-     * Replace the default tooltip. Pass a configured `ChartTooltipContent`
-     * (imported from this library) — e.g. with a `formatter` / `labelFormatter` /
-     * `indicator` — to customize formatting, per-series rows, or extra fields
-     * without composing recharts yourself. Ignored when `showTooltip` is false.
-     */
-    tooltipContent?: React.ComponentProps<typeof ChartTooltip>['content'];
 }
 declare const ComposedChart: React.ForwardRefExoticComponent<Omit<ComposedChartProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
 export { ComposedChart };

package/dist/src/components/ui/confidence-cone/confidence-cone.d.ts

@@ -1,4 +1,4 @@
-import { ChartTooltip, ChartConfig } from '../chart';
+import { ChartTooltip, ChartConfig, CartesianChartProps } from '../chart';
 import * as React from 'react';
 /**
  * Drop the synthetic cone-band range series from a recharts tooltip/legend
@@ -22,7 +22,7 @@ type TooltipContentType = NonNullable<React.ComponentProps<typeof ChartTooltip>[
 type TooltipContentFn = Extract<TooltipContentType, (...args: never[]) => unknown>;
 type TooltipRenderProps = Parameters<TooltipContentFn>[0];
 export declare function createConeTooltip(tooltipContent: TooltipContentType): (props: TooltipRenderProps) => React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | React.FunctionComponentElement<import('recharts').TooltipContentProps<import('recharts').TooltipValueType, import('recharts/types/component/DefaultTooltipContent').NameType>>;
-export interface ConfidenceConeProps extends Omit<React.ComponentProps<'div'>, 'children'> {
+export interface ConfidenceConeProps extends Omit<React.ComponentProps<'div'>, 'children'>, CartesianChartProps {
     /**
      * Row-per-point data — the shared x dimension plus the actual / forecast /
      * bound fields. Rows are naturally sparse (a point has either an actual or a
@@ -48,12 +48,6 @@ export interface ConfidenceConeProps extends Omit<React.ComponentProps<'div'>, '
     lowerKey: string;
     /** Field for the cone's upper bound. */
     upperKey: string;
-    /** Title rendered beneath the horizontal (X) axis. */
-    xAxisLabel?: string;
-    /** Title rendered beside the vertical (Y) axis (rotated). */
-    yAxisLabel?: string;
-    /** Unit suffix appended to Y-axis tick values (recharts `unit`; the X axis is categorical). */
-    yUnit?: string;
     /** Stroke width of the actual + forecast lines. */
     strokeWidth?: number;
     /**
@@ -62,18 +56,7 @@ export interface ConfidenceConeProps extends Omit<React.ComponentProps<'div'>, '
      * band over the forecast region.
      */
     showForecastRegion?: boolean;
-    showGrid?: boolean;
-    showTooltip?: boolean;
     showLegend?: boolean;
-    /**
-     * Replace the default tooltip. Pass a configured `ChartTooltipContent`
-     * (imported from this library) — e.g. with a `formatter` / `labelFormatter` —
-     * to customize the tooltip without composing recharts yourself. The synthetic
-     * cone band is filtered out of the payload before your tooltip sees it, so a
-     * `__cone` item never reaches your formatter. Ignored when `showTooltip` is
-     * false.
-     */
-    tooltipContent?: React.ComponentProps<typeof ChartTooltip>['content'];
 }
 declare const ConfidenceCone: React.ForwardRefExoticComponent<Omit<ConfidenceConeProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
 export { ConfidenceCone };

package/dist/src/components/ui/dialog-footer-carousel/dialog-footer-carousel.d.ts

@@ -0,0 +1,9 @@
+import { CarouselDialogProps } from '../carousel-dialog';
+import * as React from 'react';
+export type DialogFooterCarouselVariant = 'start' | 'middle' | 'end';
+export interface DialogFooterCarouselProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'children'>, Pick<CarouselDialogProps, 'slideCount' | 'selectedIndex' | 'onSelectIndex' | 'onBack' | 'onNext' | 'onPrimaryAction' | 'backLabel' | 'nextLabel' | 'primaryLabel' | 'goToSlideLabel'> {
+    /** Which slide position this renders for. Defaults to `'start'`. */
+    variant?: DialogFooterCarouselVariant;
+}
+declare const DialogFooterCarousel: React.ForwardRefExoticComponent<DialogFooterCarouselProps & React.RefAttributes<HTMLDivElement>>;
+export { DialogFooterCarousel };

package/dist/src/components/ui/dialog-footer-carousel/index.d.ts

@@ -0,0 +1 @@
+export { DialogFooterCarousel, type DialogFooterCarouselProps, type DialogFooterCarouselVariant, } from './dialog-footer-carousel';

package/dist/src/components/ui/dialog-welcome/dialog-welcome.d.ts

@@ -0,0 +1,54 @@
+import { DialogContentProps, DialogRoot } from '../dialog';
+import * as React from 'react';
+export interface DialogWelcomeSlide {
+    /** Illustration/media for the slide. Falls back to a placeholder surface when omitted. */
+    image?: React.ReactNode;
+    title: string;
+    description: string;
+}
+export type DialogWelcomeVariant = 'carousel' | 'single';
+type DialogRootProps = React.ComponentPropsWithoutRef<typeof DialogRoot>;
+export interface DialogWelcomeProps extends Omit<DialogRootProps, 'children'> {
+    /** Selects the Figma-defined layout. Defaults to `'carousel'`. */
+    variant?: DialogWelcomeVariant;
+    /** Slides shown one at a time (`variant="carousel"`). Defaults to a 3-slide placeholder. */
+    slides?: DialogWelcomeSlide[];
+    /** Controls the active slide (`variant="carousel"`). Uncontrolled when omitted. */
+    selectedIndex?: number;
+    /** Fires whenever the active slide changes (`variant="carousel"`). */
+    onSelectedIndexChange?: (index: number) => void;
+    /** `Back` button label (`variant="carousel"`). Defaults to `'Back'`. */
+    backLabel?: string;
+    /** `Next` button label (`variant="carousel"`). Defaults to `'Next'`. */
+    nextLabel?: string;
+    /** Builds each carousel dot's accessible name (`variant="carousel"`). */
+    goToSlideLabel?: (index: number, count: number) => string;
+    /** Illustration/media (`variant="single"`). */
+    image?: React.ReactNode;
+    /** Title (`variant="single"`). Defaults to `'Title'`. */
+    title?: string;
+    /** Description (`variant="single"`). Defaults to `'Feature description.'`. */
+    description?: string;
+    /** `Close` link label (`variant="single"`). Defaults to `'Close'`. */
+    closeLabel?: string;
+    /** Fires when `Close` (`variant="single"`) is activated, before the dialog closes. */
+    onCloseAction?: () => void;
+    /**
+     * Call-to-action button label — the last carousel slide's button
+     * (`variant="carousel"`) or the single body's primary button
+     * (`variant="single"`). Defaults to `'Call to action'`.
+     */
+    primaryLabel?: string;
+    /** Fires when the call-to-action button is activated. */
+    onPrimaryAction?: () => void;
+    /** Render inside a portal (forwarded to `DialogContent`). Defaults to `true`. */
+    portal?: boolean;
+    /** Portal container (forwarded to `DialogContent`). */
+    portalContainer?: DialogContentProps['portalContainer'];
+    /** Keep the content mounted while closed (forwarded to `DialogContent`). */
+    keepMounted?: DialogContentProps['keepMounted'];
+    /** Extra classes merged onto the popup container. */
+    className?: string;
+}
+declare const DialogWelcome: React.ForwardRefExoticComponent<DialogWelcomeProps & React.RefAttributes<HTMLDivElement>>;
+export { DialogWelcome };

package/dist/src/components/ui/dialog-welcome/dialog-welcome.docs.d.ts

@@ -0,0 +1,55 @@
+/** Props for `DialogWelcome` — the onboarding/announcement dialog recipe. */
+export interface DialogWelcomeProps {
+    /** Selects the Figma-defined layout. Defaults to `'carousel'`. */
+    variant?: 'carousel' | 'single';
+    /** Slides shown one at a time (`variant="carousel"`). Defaults to a 3-slide placeholder. */
+    slides?: Array<{
+        image?: unknown;
+        title: string;
+        description: string;
+    }>;
+    /** Controls the active slide (`variant="carousel"`). Uncontrolled when omitted. */
+    selectedIndex?: number;
+    /** Fires whenever the active slide changes (`variant="carousel"`). */
+    onSelectedIndexChange?: (index: number) => void;
+    /** `Back` button label (`variant="carousel"`). Defaults to `'Back'`. */
+    backLabel?: string;
+    /** `Next` button label (`variant="carousel"`). Defaults to `'Next'`. */
+    nextLabel?: string;
+    /** Builds each carousel dot's accessible name (`variant="carousel"`). */
+    goToSlideLabel?: (index: number, count: number) => string;
+    /** Illustration/media (`variant="single"`). */
+    image?: unknown;
+    /** Title (`variant="single"`). Defaults to `'Title'`. */
+    title?: string;
+    /** Description (`variant="single"`). Defaults to `'Feature description.'`. */
+    description?: string;
+    /** `Close` link label (`variant="single"`). Defaults to `'Close'`. */
+    closeLabel?: string;
+    /** Fires when `Close` (`variant="single"`) is activated, before the dialog closes. */
+    onCloseAction?: () => void;
+    /**
+     * Call-to-action button label — the last carousel slide's button
+     * (`variant="carousel"`) or the single body's primary button
+     * (`variant="single"`). Defaults to `'Call to action'`.
+     */
+    primaryLabel?: string;
+    /** Fires when the call-to-action button is activated. */
+    onPrimaryAction?: () => void;
+    /** Render inside a portal (forwarded to `DialogContent`). Defaults to `true`. */
+    portal?: boolean;
+    /** Portal container (forwarded to `DialogContent`). */
+    portalContainer?: HTMLElement | null;
+    /** Keep the content mounted while closed (forwarded to `DialogContent`). */
+    keepMounted?: boolean;
+    /** Extra classes merged onto the popup container. */
+    className?: string;
+    /** Controlled open state. Pair with `onOpenChange`. */
+    open?: boolean;
+    /** Open on mount, uncontrolled. */
+    defaultOpen?: boolean;
+    /** Modal behavior — focus trap and scroll lock while open. Defaults to `true`. */
+    modal?: boolean | 'trap-focus';
+    /** Fires when the dialog opens or closes. */
+    onOpenChange?: (open: boolean, eventDetails: unknown) => void;
+}

package/dist/src/components/ui/dialog-welcome/index.d.ts

@@ -0,0 +1 @@
+export { DialogWelcome, type DialogWelcomeProps, type DialogWelcomeSlide, type DialogWelcomeVariant, } from './dialog-welcome';

package/dist/src/components/ui/histogram/histogram.d.ts

@@ -1,4 +1,4 @@
-import { ChartTooltip, ChartConfig } from '../chart';
+import { ChartConfig, CartesianChartProps } from '../chart';
 import * as React from 'react';
 export interface HistogramBin {
     /** Lower bound of the bin (inclusive). */
@@ -18,7 +18,7 @@ export interface HistogramBin {
  * the package's public API.
  */
 export declare function computeHistogramBins(values: ReadonlyArray<number>, binCount: number, domain?: [number, number]): HistogramBin[];
-export interface HistogramProps extends Omit<React.ComponentProps<'div'>, 'children'> {
+export interface HistogramProps extends Omit<React.ComponentProps<'div'>, 'children'>, CartesianChartProps {
     /** Raw continuous samples to bin (non-finite values are ignored). */
     values: ReadonlyArray<number>;
     /**
@@ -33,23 +33,8 @@ export interface HistogramProps extends Omit<React.ComponentProps<'div'>, 'child
     binCount?: number;
     /** Fix the binning range instead of deriving it from the data's min/max. */
     domain?: [number, number];
-    /** Title rendered beneath the horizontal (X) axis. */
-    xAxisLabel?: string;
-    /** Title rendered beside the vertical (Y) axis (rotated). */
-    yAxisLabel?: string;
-    /** Unit suffix appended to Y-axis tick values (recharts `unit`; the X axis is the bin label). */
-    yUnit?: string;
     /** Corner radius on the top of each bar. */
     barRadius?: number;
-    showGrid?: boolean;
-    showTooltip?: boolean;
-    /**
-     * Replace the default tooltip. Pass a configured `ChartTooltipContent`
-     * (imported from this library) — e.g. with a `formatter` / `labelFormatter` —
-     * to customize the tooltip without composing recharts yourself. Ignored when
-     * `showTooltip` is false.
-     */
-    tooltipContent?: React.ComponentProps<typeof ChartTooltip>['content'];
 }
 declare const Histogram: React.ForwardRefExoticComponent<Omit<HistogramProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
 export { Histogram };

package/dist/src/components/ui/line-chart/line-chart.d.ts

@@ -1,5 +1,5 @@
 import { VariantProps } from 'class-variance-authority';
-import { ChartTooltip, ChartConfig } from '../chart';
+import { ChartTooltip, ChartConfig, CartesianChartProps } from '../chart';
 import * as React from 'react';
 declare const lineChartVariants: (props?: ({
     curve?: "step" | "linear" | "monotone" | null | undefined;
@@ -27,7 +27,7 @@ type TooltipRenderProps = Parameters<TooltipContentFn>[0];
  * component is a stable content type (memoize it on `tooltipContent`).
  */
 export declare function createBandStrippedTooltip(tooltipContent: TooltipContentType): (props: TooltipRenderProps) => React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | React.FunctionComponentElement<import('recharts').TooltipContentProps<import('recharts').TooltipValueType, import('recharts/types/component/DefaultTooltipContent').NameType>>;
-export interface LineChartProps extends Omit<React.ComponentProps<'div'>, 'children'>, VariantProps<typeof lineChartVariants> {
+export interface LineChartProps extends Omit<React.ComponentProps<'div'>, 'children'>, VariantProps<typeof lineChartVariants>, CartesianChartProps {
     /** Row-per-point data. Each object holds the category key + one numeric field per series (`null` breaks the line unless `connectNulls`). */
     data: ReadonlyArray<Record<string, string | number | null>>;
     /**
@@ -56,28 +56,13 @@ export interface LineChartProps extends Omit<React.ComponentProps<'div'>, 'child
     deltaBands?: Array<[string, string]>;
     /** Category axis key (the shared dimension across rows, e.g. `"month"`). */
     xKey: string;
-    /** Title rendered beneath the horizontal (X) axis. */
-    xAxisLabel?: string;
-    /** Title rendered beside the vertical (Y) axis (rotated). */
-    yAxisLabel?: string;
-    /** Unit suffix appended to Y-axis tick values (recharts `unit`; the X axis is categorical). */
-    yUnit?: string;
     /** Stroke width of each line. */
     strokeWidth?: number;
     /** Render a dot at each data point. */
     showDots?: boolean;
     /** Bridge `null` gaps in the data instead of breaking the line. */
     connectNulls?: boolean;
-    showGrid?: boolean;
-    showTooltip?: boolean;
     showLegend?: boolean;
-    /**
-     * Replace the default tooltip. Pass a configured `ChartTooltipContent`
-     * (imported from this library) — e.g. with a `formatter` / `labelFormatter` /
-     * `indicator` — to customize formatting, per-series rows, or extra fields
-     * without composing recharts yourself. Ignored when `showTooltip` is false.
-     */
-    tooltipContent?: React.ComponentProps<typeof ChartTooltip>['content'];
 }
 declare const LineChart: React.ForwardRefExoticComponent<Omit<LineChartProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
 export { LineChart, lineChartVariants };

package/dist/src/components/ui/sankey-chart/index.d.ts

@@ -0,0 +1,2 @@
+export { SankeyChart } from './sankey-chart';
+export type { SankeyChartProps, SankeyChartNode, SankeyChartLink, } from './sankey-chart';