@acronis-platform/ui-react 0.58.0 → 0.61.0

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

@@ -1,37 +1,96 @@
 import { VariantProps } from 'class-variance-authority';
 import * as React from 'react';
+type TimelineVariant = 'default' | 'tree';
 declare const timelineVariants: (props?: ({
-    size?: "small" | "medium" | null | undefined;
-    density?: "compact" | "default" | null | undefined;
+    variant?: "tree" | "default" | null | undefined;
 } & import('class-variance-authority/types').ClassProp) | undefined) => string;
 export interface TimelineProps extends React.ComponentProps<'ol'>, VariantProps<typeof timelineVariants> {
     /**
-     * `Timeline.Item`s — pass them as direct children (the connector auto-hides on
-     * the last one). Grouping/headings aren't supported as intervening children.
+     * Whether the list collapses. `default` never does; `tree` gives every row that
+     * has descendants a disclosure button ahead of its marker, which hides those
+     * descendants, and widens the indent step to reserve it on every row.
+     *
+     * Unrelated to `Timeline.Item`'s `collapsibleBody`, which folds a single card's
+     * own body and works the same under both variants.
+     */
+    variant?: TimelineVariant;
+    /**
+     * `Timeline.Item`s — pass them as direct children in visual order (never
+     * wrapped in a fragment, or their levels can't be read). Connectors are derived
+     * from the levels, so no row ever leaves a dangling line.
      */
     children?: React.ReactNode;
 }
-export type TimelineStatus = 'neutral' | 'info' | 'success' | 'warning' | 'danger' | 'critical';
+export type TimelineLevel = 1 | 2 | 3;
+/** The marker Avatar's color scheme (Figma ships the Timeline marker as Blue). */
+export type TimelineMarkerColor = 'blue' | 'gray' | 'green' | 'teal' | 'violet' | 'red' | 'yellow' | 'orange';
 export interface TimelineItemProps extends Omit<React.ComponentProps<'li'>, 'title'> {
+    /** Event title (the primary line in the card header). */
+    title: React.ReactNode;
     /** Event time — pass a `<time dateTime>` for an accessible, machine-readable stamp. */
     timestamp?: React.ReactNode;
-    /** Event title (the primary line). */
-    title: React.ReactNode;
-    /** Optional secondary description. */
+    /** Slot beside the title, before the timestamp — e.g. a `Tag`. */
+    tag?: React.ReactNode;
+    /** Optional secondary description under the title. */
     description?: React.ReactNode;
-    /** Semantic status — tints the marker (a subtle cue, never large blocks of text). */
-    status?: TimelineStatus;
-    /** Icon shown in a status-tinted marker badge instead of the plain dot. */
+    /** Icon rendered inside the marker Avatar. Takes precedence over `initials`. */
     icon?: React.ReactNode;
-    /** Metadata slot under the description — e.g. `Tag`s. */
-    metadata?: React.ReactNode;
-    /** Actions slot — e.g. a `Link` or `ButtonMenu`. */
-    actions?: React.ReactNode;
-    /** Emphasize this item as the current one (a ringed marker). */
-    current?: boolean;
-    /** Dim a non-applicable / inactive item. */
-    disabled?: boolean;
-    /** Expandable detail composed by the caller — e.g. an `Accordion`. */
+    /** Initials rendered inside the marker Avatar when no `icon` is given. */
+    initials?: string;
+    /** Marker Avatar color scheme. */
+    color?: TimelineMarkerColor;
+    /** Nesting depth (Figma `Nesting` L1-L3). Drives the indent only. */
+    level?: TimelineLevel;
+    /**
+     * Force the elbow joining this row to its parent's connector on or off (Figma's
+     * `Nesting` `-First`). Leave it unset — `Timeline` derives it from the levels,
+     * drawing it whenever this row is deeper than the one above it. Ignored at
+     * `level={1}`, which has no parent.
+     */
+    branchStart?: boolean;
+    /**
+     * Force the connector descending to the next row on or off (Figma
+     * `Connecting line`). Leave it unset — `Timeline` derives it from the levels,
+     * drawing it only when the next visible row is at this row's depth or deeper.
+     */
+    connector?: boolean;
+    /**
+     * Branch disclosure state (controlled). Only meaningful under `variant="tree"`
+     * on a row that has descendants — those rows get the control automatically.
+     */
+    expanded?: boolean;
+    /** Initial branch disclosure state when uncontrolled. */
+    defaultExpanded?: boolean;
+    /** Called with the requested disclosure state whenever the control is activated. */
+    onExpandedChange?: (expanded: boolean) => void;
+    /**
+     * Accessible name for the branch disclosure control — the one that drops this
+     * row's descendant rows. Distinct from `bodyToggleLabel` by default, because a
+     * tree row can carry both controls at once.
+     */
+    toggleLabel?: string;
+    /**
+     * Give this row's card a chevron at the trailing edge of its header that shows
+     * and hides the body (Figma's `Action Button`).
+     *
+     * Orthogonal to `variant`: it is the *card's* disclosure, not the timeline's, so
+     * it works the same in `default` and `tree` and a tree row can have both — the
+     * branch control drops the rows below, this one folds this card's own body.
+     * (It lives here only until `Card` grows the behaviour itself.)
+     */
+    collapsibleBody?: boolean;
+    /** Card-body disclosure state (controlled). */
+    bodyExpanded?: boolean;
+    /** Initial card-body disclosure state when uncontrolled. */
+    defaultBodyExpanded?: boolean;
+    /** Called with the requested card-body disclosure state. */
+    onBodyExpandedChange?: (expanded: boolean) => void;
+    /**
+     * Accessible name for the card-body disclosure control — the one that folds this
+     * row's own body. Distinct from `toggleLabel` by default.
+     */
+    bodyToggleLabel?: string;
+    /** Card body, rendered below a divider. */
     children?: React.ReactNode;
 }
 declare const TimelineItem: React.ForwardRefExoticComponent<Omit<TimelineItemProps, "ref"> & React.RefAttributes<HTMLLIElement>>;

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

@@ -1 +1 @@
-export { Treemap, type TreemapProps } from './treemap';
+export { Treemap, type TreemapProps, type TreemapLabelAlign } from './treemap';

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

@@ -1,16 +1,48 @@
-import { ChartTooltip, ChartConfig } from '../chart';
+import { ChartTooltip, ChartConfig, ChartAnimationProps, TickFormatter } from '../chart';
 import * as React from 'react';
+/**
+ * Where a cell's label block sits inside its rectangle. Named logically, not
+ * physically: the corner variants anchor to the tile's *start* edge, so they
+ * mirror under `dir="rtl"`. `bottom-start` is the design's placement; `center`
+ * is what the chart drew before the block had a second line.
+ */
+export type TreemapLabelAlign = 'bottom-start' | 'top-start' | 'center';
+/**
+ * Compose a cell's second line out of the caller's `secondaryKeys`. Empty and
+ * missing fields are skipped rather than printed as a gap, so one row without
+ * the field doesn't leave a dangling separator.
+ */
+export declare function treemapSecondaryLabel(options: {
+    row: Record<string, string | number>;
+    keys: readonly string[];
+    separator: string;
+    formatter?: TickFormatter;
+}): string | undefined;
 interface TreemapCellProps {
     x?: number;
     y?: number;
     width?: number;
     height?: number;
     name?: string;
+    /** The leaf's display name — its `config` label, stamped onto the row by `Treemap`. */
+    primaryLabel?: string;
+    /** The label's precomputed second line, stamped onto each row by `Treemap`. */
+    secondaryLabel?: string;
     showLabels?: boolean;
+    labelAlign?: TreemapLabelAlign;
 }
-export declare function TreemapCell({ x, y, width, height, name, showLabels, }: TreemapCellProps): import("react/jsx-runtime").JSX.Element;
-export interface TreemapProps extends Omit<React.ComponentProps<'div'>, 'children'> {
-    /** Row-per-leaf data. Each object holds the leaf's `nameKey` label + its `dataKey` numeric size. */
+export declare function TreemapCell({ x, y, width, height, name, primaryLabel, secondaryLabel, showLabels, labelAlign, }: TreemapCellProps): import("react/jsx-runtime").JSX.Element;
+export interface TreemapProps extends Omit<React.ComponentProps<'div'>, 'children'>, ChartAnimationProps {
+    /**
+     * Row-per-leaf data. Each object holds the leaf's `nameKey` label + its
+     * `dataKey` numeric size.
+     *
+     * `fill`, `primaryLabel` and `secondaryLabel` are reserved: the chart stamps
+     * them onto a copy of each row to carry the cell color and the two label lines
+     * through to the renderer (recharts hands the whole row to `content`, so
+     * anything the cell needs has to be on it). A row of your own carrying one of
+     * those names may end up driving what the tile paints.
+     */
     data: ReadonlyArray<Record<string, string | number>>;
     /**
      * Per-leaf map of `label` / `color`, keyed by the leaf's `nameKey` value
@@ -22,16 +54,44 @@ export interface TreemapProps extends Omit<React.ComponentProps<'div'>, 'childre
     /** Numeric field that sizes each leaf's rectangle. */
     dataKey: string;
     /**
-     * Label field that names each leaf (drives the on-cell label, tooltip, and
-     * `--color-<name>` lookup). Values should be unique and CSS-safe (they become
-     * part of a custom-property name).
+     * Label field that names each leaf (drives the on-cell label, legend, tooltip,
+     * and `--color-<name>` lookup). Values should be unique and CSS-safe (they
+     * become part of a custom-property name).
      */
     nameKey: string;
     /** Width-to-height ratio the tiling targets. */
     aspectRatio?: number;
-    /** Render each leaf's name inside its cell (when it fits). */
+    /** Render each leaf's label inside its cell (when it fits). */
     showLabels?: boolean;
+    /**
+     * Where a cell's label sits. Defaults to `bottom-start` — the design's
+     * placement, which keeps the label anchored to a tile corner as the tiling
+     * reflows. `top-start` anchors it to the opposite corner; `center` centers the
+     * block in the tile. The corner variants are named for the tile's *start* edge
+     * because they mirror under `dir="rtl"`.
+     */
+    labelAlign?: TreemapLabelAlign;
+    /**
+     * Fields whose values make up a second label line under the leaf's name — e.g.
+     * `[dataKey]` for the size, or `['size', 'count']` for a value and a count. The
+     * line is dropped on cells too short to hold it.
+     */
+    secondaryKeys?: readonly string[];
+    /**
+     * Format each secondary value. Receives the field's index in `secondaryKeys`
+     * as its second argument, so one formatter can cover fields of different kinds.
+     */
+    secondaryFormatter?: TickFormatter;
+    /** Separator drawn between multiple secondary values. */
+    secondarySeparator?: string;
     showTooltip?: boolean;
+    /**
+     * Render the legend — one entry per leaf. Off by default: a treemap labels its
+     * cells, so the legend is for the case where the tiles are too small to.
+     */
+    showLegend?: boolean;
+    /** Which edge the legend sits on. */
+    legendPos?: 'top' | 'bottom';
     /**
      * Replace the default tooltip. Pass a configured `ChartTooltipContent`
      * (imported from this library) — e.g. with a `formatter` / `labelFormatter` —

package/dist/src/index.d.ts

@@ -1,5 +1,6 @@
 export { cn } from './lib/utils';
 export * from './hooks';
+export * from './lib/breakpoints';
 export { PortalContainerProvider, usePortalContainer, type PortalContainerProviderProps, } from './lib/portal-container';
 export * from './components/ui/accordion';
 export * from './components/ui/alert';
@@ -15,6 +16,7 @@ export * from './components/ui/button-menu';
 export * from './components/ui/calendar';
 export * from './components/ui/card';
 export * from './components/ui/card-filter';
+export * from './components/ui/category-bar';
 export * from './components/ui/chart';
 export * from './components/ui/chart-state';
 export * from './components/ui/checkbox';
@@ -27,7 +29,9 @@ export * from './components/ui/data-table';
 export * from './components/ui/date-range-picker';
 export * from './components/ui/description-list';
 export { Dialog, DialogClose, type DialogProps, type DialogVariant, } from './components/ui/dialog';
+export * from './components/ui/dialog-footer-carousel';
 export * from './components/ui/dialog-footer-default';
+export * from './components/ui/dialog-welcome';
 export * from './components/ui/dropdown-menu';
 export * from './components/ui/empty';
 export * from './components/ui/field';
@@ -60,9 +64,9 @@ export * from './components/ui/pie-chart';
 export * from './components/ui/popover';
 export * from './components/ui/progress';
 export * from './components/ui/progress-circle';
+export * from './components/ui/sankey-chart';
 export * from './components/ui/scatter-chart';
 export * from './components/ui/scroll-area';
-export * from './components/ui/search-global';
 export { InputText as Input, type InputTextProps as InputProps, } from './components/ui/input-text';
 export { InputSearch as Search, type InputSearchProps as SearchProps, } from './components/ui/input-search';
 export { InputTextArea as Textarea, type InputTextAreaProps as TextareaProps, } from './components/ui/input-text-area';