@acronis-platform/ui-react 0.58.0 → 0.61.0

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

@@ -1,15 +1,115 @@
-import { ChartTooltip, ChartConfig } from '../chart';
+import { VariantProps } from 'class-variance-authority';
+import { ChartConfig, CartesianChartProps, ChartAnimationProps, ChartBrushProps, ChartCategoryRange, ChartDataLabelProps, ChartReferenceLine, CartesianLabelPosition, ChartYAxisTarget, SecondaryYAxisProps } from '../chart';
 import * as React from 'react';
+declare const composedChartVariants: (props?: ({
+    orientation?: "horizontal" | "vertical" | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
 export type ComposedSeriesType = 'bar' | 'line' | 'area';
+/** Interpolation for a line or area series. */
+export type ComposedCurveType = 'linear' | 'monotone' | 'step';
+/**
+ * How a series is marked in the legend. Deliberately narrower than recharts'
+ * icon set: `ChartLegendContent` draws its own marker and reads only whether the
+ * entry is a `line` (a rule, dashed when the series is) or anything else (a
+ * swatch), so the wider union would advertise icons that never render. `none`
+ * keeps the series off the legend entirely.
+ */
+export type ComposedSeriesLegendType = 'line' | 'rect' | 'none';
+/** Plot-area inset, in px. Any side left out keeps the chart's own default. */
+export interface ComposedChartMargin {
+    top?: number;
+    right?: number;
+    bottom?: number;
+    left?: number;
+}
 export interface ComposedSeries {
     /** Column key to plot — must match a `config` entry; drives its `--color-<key>` paint. */
     key: string;
     /** How this series renders. */
     type: ComposedSeriesType;
+    /**
+     * Which value axis this series is measured against. Defaults to `primary`.
+     * The secondary axis is rendered only when at least one series selects it — use
+     * it when a series carries a different unit or magnitude (a rate next to a
+     * count) that a shared scale would flatten.
+     */
+    yAxis?: ChartYAxisTarget;
+    /**
+     * Paint for this series, overriding its `config` color. Reference an existing
+     * semantic `--ui-*` token; there is no chart palette tier yet.
+     */
+    color?: string;
+    /**
+     * Stack this series with every other series of the *same mark type* carrying
+     * the same id. Bars stack with bars and areas with areas — the ids are
+     * namespaced per type, so one id can't merge a bar into an area stack. Ignored
+     * on a line series, which recharts does not stack.
+     */
+    stackId?: string;
+    /** Interpolation, overriding the chart's `curve`. Line and area series only. */
+    curve?: ComposedCurveType;
+    /**
+     * Stroke width, overriding the chart's `strokeWidth` on a line or area series.
+     * On a bar it sizes the dashed outline `strokeDasharray` draws — a bar has no
+     * other stroke, so the chart-level default never reaches one and this is the
+     * only way to set it.
+     */
+    strokeWidth?: number;
+    /**
+     * Dash pattern for the stroke (an SVG `stroke-dasharray`, e.g. `'5 5'`) — the
+     * conventional way to mark a series as a projection. On a bar series it draws a
+     * dashed outline in the series colour.
+     */
+    strokeDasharray?: string;
+    /** Render a dot at each point, overriding the chart's `showDots`. Line and area series only. */
+    showDots?: boolean;
+    /** Render the hover dot, overriding the chart's `showActiveDots`. Line and area series only. */
+    showActiveDots?: boolean;
+    /** Bridge `null` gaps instead of breaking the series, overriding `connectNulls`. */
+    connectNulls?: boolean;
+    /** Corner radius on the growing end, overriding the chart's `barRadius`. Bar series only. */
+    barRadius?: number;
+    /** Fixed bar thickness in px, overriding the chart's `barSize`. Bar series only. */
+    barSize?: number;
+    /** Highlight this bar on hover, overriding the chart's `showActiveBar`. Bar series only. */
+    showActiveBar?: boolean;
+    /** Draw a full-height track behind this series' bars, overriding `showBackground`. Bar series only. */
+    showBackground?: boolean;
+    /** Fill opacity, overriding the chart's `fillOpacity` (which applies to area series). */
+    fillOpacity?: number;
+    /** How this series is marked in the legend — `none` keeps it off the legend. */
+    legendType?: ComposedSeriesLegendType;
 }
-export interface ComposedChartProps extends Omit<React.ComponentProps<'div'>, 'children'> {
-    /** Row-per-category data. Each object holds `xKey` + one numeric field per series. */
-    data: ReadonlyArray<Record<string, string | number>>;
+/**
+ * A dashed rule on the chart. Either a position on the *value* axis (a fixed
+ * `value`, or the mean of one/every series via `average`) or, with `category`, a
+ * rule across the *category* axis at one category — the "today" divider between
+ * actuals and forecast. A value position wins if both are given.
+ */
+export interface ComposedChartReferenceLine extends ChartReferenceLine {
+    /**
+     * Category to draw the rule at — the category's own value (an `xKey` cell) or
+     * its 0-based row index.
+     */
+    category?: string | number;
+    /**
+     * Which value axis the rule is measured against, on a chart carrying two.
+     * Defaults to the axis of the series named by `average`, and to `primary`
+     * otherwise — so a target read off the secondary scale lands on it rather
+     * than being plotted against the primary one. `average: true` then pools only
+     * the series on this axis, never two scales at once. Inert while no series
+     * selects the secondary axis.
+     */
+    yAxis?: ChartYAxisTarget;
+}
+/** A shaded band behind a range of categories. */
+export interface ComposedChartReferenceArea extends ChartCategoryRange {
+    /** Caption above the band. */
+    label?: string;
+}
+export interface ComposedChartProps extends Omit<React.ComponentProps<'div'>, 'children'>, VariantProps<typeof composedChartVariants>, CartesianChartProps, SecondaryYAxisProps, ChartAnimationProps, ChartBrushProps, ChartDataLabelProps {
+    /** Row-per-category data. Each object holds `xKey` + one numeric field per series (`null` breaks a line/area unless `connectNulls`). */
+    data: ReadonlyArray<Record<string, string | number | null>>;
     /**
      * Per-series map of `label` / `color`, keyed by `series[].key` (imported from
      * the shared `Chart` primitives). Turned into `--color-<key>` custom
@@ -17,32 +117,66 @@ export interface ComposedChartProps extends Omit<React.ComponentProps<'div'>, 'c
      * `--ui-*` token; there is no chart palette tier yet.
      */
     config: ChartConfig;
-    /** Series to plot, each `{ key, type }` — one bar/line/area per entry. Each key must exist in `config` and every data row. */
+    /**
+     * Series to plot, each `{ key, type }` plus any per-series style override —
+     * one bar/line/area per entry. Each key must exist in `config` and every data
+     * row. Every styling prop on the chart is the default a series overrides here.
+     */
     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;
+    /**
+     * One or more dashed reference lines — on a value axis (`value` / `average`,
+     * placed by the entry's `yAxis`) or across the category axis (`category`).
+     * Pass a single object or an array.
+     */
+    referenceLine?: ComposedChartReferenceLine | ComposedChartReferenceLine[];
+    /**
+     * One or more shaded bands behind a range of categories — e.g. a forecast
+     * period. Pass a single object or an array to draw several.
+     */
+    referenceArea?: ComposedChartReferenceArea | ComposedChartReferenceArea[];
+    /** Unit suffix on the value-axis tick values when it is X (`orientation="horizontal"`). */
+    xUnit?: string;
     /** Interpolation for the line and area series. */
-    curve?: 'linear' | 'monotone' | 'step';
+    curve?: ComposedCurveType;
     /** Corner radius on the growing end of bar series. */
     barRadius?: number;
+    /** Fixed bar thickness, in px. Unset, recharts sizes bars from the available width. */
+    barSize?: number;
+    /** Gap between bars of the same category, in px or a percentage string. */
+    barGap?: number | string;
+    /** Gap between category groups, in px or a percentage string. */
+    barCategoryGap?: number | string;
+    /** Draw a full-height track behind every bar. */
+    showBackground?: boolean;
+    /** Fill for the track background. Defaults to the secondary surface. */
+    backgroundFill?: string;
+    /** Highlight the hovered bar. */
+    showActiveBar?: boolean;
     /** Flat-fill opacity for area series. */
     fillOpacity?: number;
-    showGrid?: boolean;
-    showTooltip?: boolean;
+    /** Stroke width for the line series. Areas keep recharts' thinner outline unless set. */
+    strokeWidth?: number;
+    /** Render a dot at each point of the line and area series. */
+    showDots?: boolean;
+    /** Render the hover dot on the line and area series. Unset, recharts' own default applies. */
+    showActiveDots?: boolean;
+    /** Bridge `null` gaps in the data instead of breaking the line/area. */
+    connectNulls?: boolean;
+    /** Plot-area inset. Any side left out keeps the chart's own default. */
+    margin?: ComposedChartMargin;
+    /** Draw the hover cursor (the band/rule under the tooltip). Defaults to `true`. */
+    tooltipCursor?: boolean;
     showLegend?: boolean;
+    /** Which edge the legend sits on. Defaults to `bottom`. */
+    legendPosition?: 'top' | 'bottom';
     /**
-     * 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.
+     * Position of the value labels when `showLabels` is on. Defaults to each
+     * series' growing end — `top` (or `right` when horizontal), and the centre of
+     * a stacked segment, which has no free space at its end.
      */
-    tooltipContent?: React.ComponentProps<typeof ChartTooltip>['content'];
+    labelPosition?: CartesianLabelPosition;
 }
 declare const ComposedChart: React.ForwardRefExoticComponent<Omit<ComposedChartProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
-export { ComposedChart };
+export { ComposedChart, composedChartVariants };

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

@@ -1 +1 @@
-export { ComposedChart, type ComposedChartProps, type ComposedSeries, type ComposedSeriesType, } from './composed-chart';
+export { ComposedChart, composedChartVariants, type ComposedChartProps, type ComposedChartMargin, type ComposedChartReferenceArea, type ComposedChartReferenceLine, type ComposedCurveType, type ComposedSeries, type ComposedSeriesLegendType, type ComposedSeriesType, } from './composed-chart';

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

@@ -1,14 +1,23 @@
-import { ChartTooltip, ChartConfig } from '../chart';
+import { ChartTooltip, ChartConfig, CartesianChartProps, ChartAnimationProps } from '../chart';
 import * as React from 'react';
 /**
- * Drop the synthetic cone-band range series from a recharts tooltip/legend
+ * Drop every synthetic cone-band range series from a recharts tooltip/legend
  * payload, keeping the real actual/forecast series (and their order). Applied to
- * both the default tooltip and any caller-supplied `tooltipContent`, so the
- * `__cone` band never surfaces regardless of which path renders.
+ * both the default tooltip and any caller-supplied `tooltipContent`, so no band
+ * surfaces regardless of which path renders or how many series are plotted.
  */
 export declare function dropConeBand<T extends {
     dataKey?: unknown;
 }>(payload: readonly T[] | undefined): T[] | undefined;
+/**
+ * Reduce a legend payload to the metrics the chart plots — one entry per series.
+ * A series' actual, forecast and cone are three recharts series painting a
+ * single metric in a single hue, so the legend names each metric once, with its
+ * actual series' swatch, instead of listing line styles as separate series.
+ */
+export declare function keepMetricSeries<T extends {
+    dataKey?: unknown;
+}>(payload: readonly T[] | undefined, actualKeys: readonly string[]): T[] | undefined;
 /**
  * Wrap a caller-supplied `tooltipContent` so the synthetic cone band is stripped
  * from the payload before it renders, while preserving recharts' own mount
@@ -22,58 +31,150 @@ 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'> {
+/**
+ * One plotted metric: its actual / forecast columns and, optionally, the two
+ * bound columns that shade its cone. Omit `lowerKey`/`upperKey` for a band-less
+ * metric — a solid line handing off to a bare dashed projection.
+ */
+export interface ConfidenceConeSeries {
+    /** Field for the known/actual values — drawn as a solid line with a filled area. */
+    actualKey: string;
+    /** Field for the projected values — drawn as a dashed line. */
+    forecastKey: string;
+    /** Field for the cone's lower bound. Omit (with `upperKey`) for no cone. */
+    lowerKey?: string;
+    /** Field for the cone's upper bound. Omit (with `lowerKey`) for no cone. */
+    upperKey?: string;
+}
+/**
+ * The x values of the projected period — every row carrying a forecast value for
+ * at least one series, in data order. The first is the hand-off point (where the
+ * shaded region and divider start); the whole set drives the forecast tick
+ * styling, matched by value so tick `interval` can't skew it the way a tick
+ * index would. Exported for unit tests; not part of the package's public API.
+ */
+export declare function forecastPeriodX(data: ReadonlyArray<Record<string, string | number | null | undefined>>, series: readonly ConfidenceConeSeries[], xKey: string): Array<string | number | null | undefined>;
+/**
+ * Build the X-axis tick renderer that sets the projected columns apart: italic,
+ * in the metric's hue. Styled inline rather than through the `fill` attribute
+ * recharts hands every tick, so the accent survives the class-based tick color
+ * a chart theme may apply. A custom tick owns its own text, so the caller's
+ * `xTickFormatter` is applied here — recharts only applies it to default ticks.
+ * Exported for unit tests; not part of the package's public API.
+ */
+export declare function createForecastTick(forecastX: ReadonlySet<string | number | null | undefined>, color: string, tickFormatter?: CartesianChartProps['xTickFormatter']): ({ payload, index, ...tickProps }: {
+    payload?: {
+        value?: string | number;
+    };
+    index?: number;
+}) => import("react/jsx-runtime").JSX.Element;
+/** A dashed horizontal threshold on the value axis. */
+export interface ConfidenceConeReferenceLine {
+    /** Position on the value (Y) axis. */
+    value: number;
+    /** Optional caption rendered at the line's right end. */
+    label?: string;
+}
+/**
+ * Every prop except the one-form-or-the-other requirement `ConfidenceConeProps`
+ * layers on below. Exported so the stories can type their `Meta` on a single
+ * object shape — Storybook can't split a union's required args between `meta.args`
+ * and a story's. Not re-exported from `index.ts`; not part of the public API.
+ */
+export interface ConfidenceConeBaseProps extends Omit<React.ComponentProps<'div'>, 'children'>, CartesianChartProps, ChartAnimationProps {
     /**
-     * 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
-     * forecast + bounds), so missing fields are allowed. Avoid a field named
-     * `__cone` — it's reserved for the internal prediction-band series.
+     * Row-per-point data — the shared x dimension plus each series' actual /
+     * forecast / bound fields. Rows are naturally sparse (a point has either an
+     * actual or a forecast + bounds), so missing fields are allowed. Avoid fields
+     * starting with `__cone` — that prefix is reserved for the internal
+     * prediction-band series.
      */
     data: ReadonlyArray<Record<string, string | number | null | undefined>>;
     /**
      * Per-series map of `label` / `color` for the actual + forecast lines
      * (imported from the shared `Chart` primitives). Colors are caller-supplied —
      * reference an existing semantic `--ui-*` token; there is no chart palette tier
-     * yet. The cone band and the forecast line both reuse the actual series'
-     * color — actual and forecast differ by line style, not hue.
+     * yet. Each metric renders in one hue: its cone band and forecast line both
+     * reuse its actual series' color — actual and forecast differ by line style,
+     * not hue.
      */
     config: ChartConfig;
     /** Category / time axis key (the shared dimension across rows). */
     xKey: string;
-    /** Field for the known/actual values — drawn as a solid line with a filled area. */
-    actualKey: string;
-    /** Field for the projected values — drawn as a dashed line. */
-    forecastKey: string;
-    /** Field for the cone's lower bound. */
-    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;
+    /**
+     * Plot several metrics against one shared axis — each with its own actual /
+     * forecast / bound fields and its own hue (from `config[actualKey]`). Takes
+     * precedence over the single-series `actualKey`/`forecastKey`/`lowerKey`/
+     * `upperKey` shorthand below; pass one form or the other, not both. One of the
+     * two forms is required.
+     */
+    series?: readonly ConfidenceConeSeries[];
+    /**
+     * Single-series shorthand — field for the known/actual values, drawn as a
+     * solid line with a filled area. Required (with `forecastKey`) unless `series`
+     * is set, which supersedes it.
+     */
+    actualKey?: string;
+    /**
+     * Single-series shorthand — field for the projected values, drawn as a dashed
+     * line. Required (with `actualKey`) unless `series` is set, which supersedes
+     * it.
+     */
+    forecastKey?: string;
+    /** Field for the cone's lower bound. Omit (with `upperKey`) for no cone. */
+    lowerKey?: string;
+    /** Field for the cone's upper bound. Omit (with `lowerKey`) for no cone. */
+    upperKey?: string;
+    /**
+     * How the known/actual period is drawn: a filled `area` under the line (the
+     * default), or a bare `line` — for a chart where the cone is the only shaded
+     * region, or where several metrics' fills would muddy each other.
+     */
+    actualType?: 'area' | 'line';
     /** Stroke width of the actual + forecast lines. */
     strokeWidth?: number;
+    /**
+     * Mark each data point: a filled dot on the observed values, a hollow one on
+     * the projection — so a point reads as measured or predicted at a glance.
+     */
+    showDots?: boolean;
+    /**
+     * Italicize the X-axis ticks over the forecast period and paint them in the
+     * first series' hue, so the projected columns read as projected even when the
+     * shaded region is off.
+     */
+    styleForecastTicks?: boolean;
+    /**
+     * One or more dashed horizontal thresholds on the value axis — e.g. a target
+     * or a capacity limit. Pass a single object or an array to draw several.
+     */
+    referenceLine?: ConfidenceConeReferenceLine | ConfidenceConeReferenceLine[];
     /**
      * Set off the forecast period from the actuals with a dashed divider at the
      * hand-off point (the first row with a forecast value) and a subtle shaded
      * 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>>;
+/**
+ * Which columns to plot has to be spelled out one way or the other: the `series`
+ * array, or the flat `actualKey` + `forecastKey` shorthand. Expressed as a union
+ * so a chart with neither is a compile error rather than a silent plot of axes
+ * and nothing else. Both forms together stay legal — `series` wins (see
+ * `plotted`), which is what the multi-series stories rely on to clear the args
+ * table.
+ */
+export type ConfidenceConeProps = ConfidenceConeBaseProps & ({
+    series: readonly ConfidenceConeSeries[];
+} | {
+    actualKey: string;
+    forecastKey: string;
+});
+declare const ConfidenceCone: React.ForwardRefExoticComponent<(Omit<ConfidenceConeBaseProps & {
+    series: readonly ConfidenceConeSeries[];
+}, "ref"> | Omit<ConfidenceConeBaseProps & {
+    actualKey: string;
+    forecastKey: string;
+}, "ref">) & React.RefAttributes<HTMLDivElement>>;
 export { ConfidenceCone };

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

@@ -1 +1 @@
-export { ConfidenceCone, type ConfidenceConeProps } from './confidence-cone';
+export { ConfidenceCone, type ConfidenceConeProps, type ConfidenceConeSeries, type ConfidenceConeReferenceLine, } from './confidence-cone';

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';