prime-ui-kit 0.14.0 → 0.16.0

package/dist/components/select/SelectItem.d.ts

@@ -10,6 +10,9 @@ export declare namespace SelectItemIcon {
     var displayName: string;
 }
 export type SelectItemTextProps = SpanProps & {
+    /**
+     * The text.
+     */
     children: React.ReactNode;
 };
 /** Title of a rich option; its text is the option label (trigger, typeahead, search). */
@@ -18,6 +21,9 @@ export declare namespace SelectItemText {
     var displayName: string;
 }
 export type SelectItemDescriptionProps = SpanProps & {
+    /**
+     * The text.
+     */
     children: React.ReactNode;
 };
 /** Muted second line under `Select.ItemText`; searchable. Makes the row two-line. */
@@ -26,6 +32,9 @@ export declare namespace SelectItemDescription {
     var displayName: string;
 }
 export type SelectItemMetaProps = SpanProps & {
+    /**
+     * The text.
+     */
     children: React.ReactNode;
 };
 /** Trailing meta of an option (price, count): muted, tabular, before the check. */
@@ -53,28 +62,46 @@ export declare function splitItemChildren(children: React.ReactNode): ItemParts;
  * `size`, decorative (the text names the option).
  */
 export declare function sizeMedia(leading: React.ReactNode[], size: ControlSize): React.ReactNode[];
-export type SelectItemProps = {
+export type SelectItemProps = Omit<React.HTMLAttributes<HTMLDivElement>, "role" | "id" | "children"> & {
+    /**
+     * Value of the option.
+     */
     value: string;
-    /** Text shown in the trigger and used by typeahead; defaults to `Select.ItemText`, then plain text. */
+    /**
+     * Text in the trigger and for typeahead; defaults to `Select.ItemText`, then the plain text.
+     */
     label?: string;
-    /** Extra words for the search (`Select.Content searchable`). */
+    /**
+     * Extra words for the search.
+     */
     keywords?: string;
+    /**
+     * Muted, skipped by the keyboard, not selectable.
+     */
     disabled?: boolean;
-    className?: string;
+    /**
+     * Text, or `Select.ItemIcon`, `Avatar.Root`, `Thumbnail.Root`, `Select.ItemText`, `Select.ItemDescription`, `Select.ItemMeta`, `Badge.Root` as direct children.
+     */
     children: React.ReactNode;
     ref?: React.Ref<HTMLDivElement>;
 };
-export declare function SelectItem({ value, label, keywords, disabled, className, children, ref, }: SelectItemProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function SelectItem({ value, label, keywords, disabled, className, children, onClick, onMouseMove, ref, ...rest }: SelectItemProps): import("react/jsx-runtime").JSX.Element | null;
 export declare namespace SelectItem {
     var displayName: string;
 }
 export declare const isActionValue: (value: string) => boolean;
 export type SelectActionProps = Omit<React.HTMLAttributes<HTMLDivElement>, "onSelect" | "role" | "id" | "children"> & {
-    /** Runs the action: a click, or Enter / Space while it is highlighted; the list then closes. */
+    /**
+     * Runs the action: a click, or Enter / Space while it is highlighted; the list then closes and the value stays.
+     */
     onSelect: () => void;
-    /** Muted, skipped by the keyboard, not runnable. */
+    /**
+     * Muted, skipped by the keyboard, not runnable.
+     */
     disabled?: boolean;
-    /** The action text; an optional `Select.ItemIcon` in front. */
+    /**
+     * The action text; an optional `Select.ItemIcon` in front.
+     */
     children: React.ReactNode;
     ref?: React.Ref<HTMLDivElement>;
 };

package/dist/components/select/selectContext.d.ts

@@ -1,5 +1,5 @@
 import type * as React from "react";
-import { type Store } from "../../internal/listbox";
+import type { ListboxRegistry, Store } from "../../internal/listbox";
 import type { ControlSize } from "../../internal/states";
 export type SelectLabels = {
     /** Placeholder and accessible name of the search field (`Select.Content searchable`). */
@@ -20,32 +20,18 @@ export type SelectLabels = {
     changeFailed: string;
 };
 export declare const normalize: (text: string) => string;
-/**
- * The items of a Select: their labels (shown in the trigger; kept after an item unmounts, so the
- * label does not flicker while the list moves between the closed registry and the open panel)
- * and the mounted ones with their search text (the empty state). `version` changes on every
- * (un)registration.
- */
-export type ItemRegistry = {
-    version: Store<number>;
-    labelOf: (value: string) => string;
-    /** Registers a mounted item; returns the unregistration. */
-    register: (value: string, label: string, haystack: string) => () => void;
-    /** Some mounted item matches the normalized query. */
-    anyMatch: (query: string) => boolean;
-};
-export declare function createItemRegistry(): ItemRegistry;
 export type SelectContextValue = {
     size: ControlSize;
     invalid: boolean;
-    focusRing: boolean;
+    focusRing: boolean | undefined;
     required: boolean;
     disabled: boolean;
     placeholder: string | undefined;
     multiple: boolean;
     /** Selected values: one or none in single mode. */
     selected: string[];
-    registry: ItemRegistry;
+    /** The items and actions of the list (`@/internal/listbox`): labels, the query view, Enter. */
+    registry: ListboxRegistry;
     pick: (value: string) => void;
     clear: () => void;
     clearable: boolean;
@@ -61,6 +47,8 @@ export type SelectContextValue = {
     filter: boolean;
     isOpen: boolean;
     setOpen: (open: boolean) => void;
+    closeOnEscape: boolean;
+    closeOnOutsideClick: boolean;
     /** The highlighted option; items subscribe to their own slice of it. */
     highlight: Store<string | undefined>;
     query: string;
@@ -71,4 +59,4 @@ export type SelectContextValue = {
     triggerRef: React.RefObject<HTMLButtonElement | null>;
     labels: SelectLabels;
 };
-export declare const SelectProvider: React.Provider<SelectContextValue | null>, useSelectContext: () => SelectContextValue;
+export declare const SelectProvider: React.Provider<SelectContextValue | null>, useSelectContext: (part?: string) => SelectContextValue;

package/dist/components/sheet/Sheet.d.ts

@@ -1,34 +1,51 @@
-import * as React from "react";
-import { DialogGuard } from "../modal/DialogGuard";
-import { DialogActions, DialogBody, DialogClose, DialogDescription, type DialogDiscardLabels, DialogFooter, DialogHeader, DialogIcon, DialogMeta, DialogTitle, DialogTrigger } from "../modal/DialogParts";
-export type { DialogGuardProps as SheetGuardProps } from "../modal/DialogGuard";
-export type { DialogActionsProps as SheetActionsProps, DialogBodyProps as SheetBodyProps, DialogCloseProps as SheetCloseProps, DialogDescriptionProps as SheetDescriptionProps, DialogFooterProps as SheetFooterProps, DialogHeaderProps as SheetHeaderProps, DialogIconProps as SheetIconProps, DialogMetaProps as SheetMetaProps, DialogTitleProps as SheetTitleProps, DialogTriggerProps as SheetTriggerProps, } from "../modal/DialogParts";
-export type SheetLabels = DialogDiscardLabels & {
-    /** `aria-label` of the header close button. */
-    close: string;
-};
+import type * as React from "react";
+import { DialogGuard } from "../../internal/overlay/DialogGuard";
+import { DialogActions, DialogBody, DialogClose, DialogDescription, DialogFooter, DialogHeader, DialogIcon, type DialogLabels, DialogMeta, DialogTitle, DialogTrigger } from "../../internal/overlay/DialogParts";
+export type { DialogGuardProps as SheetGuardProps } from "../../internal/overlay/DialogGuard";
+export type { DialogActionsProps as SheetActionsProps, DialogBodyProps as SheetBodyProps, DialogCloseProps as SheetCloseProps, DialogDescriptionProps as SheetDescriptionProps, DialogFooterProps as SheetFooterProps, DialogHeaderProps as SheetHeaderProps, DialogIconProps as SheetIconProps, DialogMetaProps as SheetMetaProps, DialogTitleProps as SheetTitleProps, DialogTriggerProps as SheetTriggerProps, } from "../../internal/overlay/DialogParts";
+export type SheetLabels = DialogLabels;
 export type SheetRootProps = {
+    /**
+     * Controlled visibility; together with `onOpenChange`.
+     */
     open?: boolean;
+    /**
+     * Initial visibility, uncontrolled.
+     */
     defaultOpen?: boolean;
+    /**
+     * Called on every open and close: trigger, close button, `Close`, Escape, scrim click, code. A `Guard` holds the dismisses (not code).
+     */
     onOpenChange?: (open: boolean) => void;
-    /** Escape closes the sheet. Default `true`. */
+    /**
+     * Escape closes the dialog.
+     */
     closeOnEscape?: boolean;
-    /** A click on the scrim or a swipe down closes the sheet. Default `true`. */
+    /**
+     * A click on the scrim (and a swipe down, which draws the grab handle) closes the dialog. A destructive action is confirmed in a ConfirmDialog; unsaved changes are held by `Guard`.
+     */
     closeOnOutsideClick?: boolean;
+    /**
+     * Built-in strings, see Labels.
+     */
     labels?: Partial<SheetLabels>;
+    /**
+     * Trigger and Content.
+     */
     children?: React.ReactNode;
 };
-declare function SheetRoot({ labels, children, ...options }: SheetRootProps): import("react/jsx-runtime").JSX.Element;
+declare function SheetRoot({ children, ...options }: SheetRootProps): import("react/jsx-runtime").JSX.Element;
 declare namespace SheetRoot {
     var displayName: string;
 }
 export type SheetContentProps = React.HTMLAttributes<HTMLDivElement> & {
-    /** Class on the full-screen scrim. */
+    /**
+     * Class on the scrim.
+     */
     overlayClassName?: string;
-    /** The `role="dialog"` panel. */
     ref?: React.Ref<HTMLDivElement>;
 };
-declare function SheetContent({ children, ...props }: SheetContentProps): import("react/jsx-runtime").JSX.Element | null;
+declare function SheetContent(props: SheetContentProps): import("react/jsx-runtime").JSX.Element;
 declare namespace SheetContent {
     var displayName: string;
 }

package/dist/components/skeleton/Skeleton.d.ts

@@ -7,11 +7,17 @@ import type { ControlSize } from "../../internal/states";
  */
 export type SkeletonShape = "text" | "control" | "circle" | "block";
 export type SkeletonProps = Omit<React.HTMLAttributes<HTMLSpanElement>, "children"> & {
-    /** Default `text`. */
+    /**
+     * `text` — lines of the tier's text; `control` — a field or button of the tier; `circle` — an avatar of the tier; `block` — a box that fills its container (image, chart, card).
+     */
     shape?: SkeletonShape;
-    /** Tier of the text line, control height or avatar size. Default: the host tier, else `m`. */
+    /**
+     * Tier of the text line (control text size and line height), the control height or the avatar size.
+     */
     size?: ControlSize;
-    /** `text` only: number of lines; the last of several is shorter. Default 1. */
+    /**
+     * `text` only: number of lines; the last of several is 60% wide.
+     */
     lines?: number;
     ref?: React.Ref<HTMLSpanElement>;
 };

package/dist/components/slider/Slider.d.ts

@@ -4,43 +4,83 @@ export type SliderLabels = {
     /** Muted marker after the label when `optional`. */
     optional: string;
 };
-export type SliderProps = FieldRootDomProps & Omit<FieldFrameProps, "focusRing"> & {
+export declare const SLIDER_LABELS: SliderLabels;
+export type SliderProps = FieldRootDomProps & FieldFrameProps & {
+    /**
+     * Controlled value; clamped to `min`…`max`.
+     */
     value?: number;
+    /**
+     * Initial value when uncontrolled.
+     */
     defaultValue?: number;
+    /**
+     * Called with the new number while dragging and on every key step.
+     */
     onValueChange?: (value: number) => void;
     /**
-     * The value the person settled on: fires once when the thumb is released (pointer) or after a
-     * key moved it, and only if the value differs from the last commit. Save here instead of on
-     * every `onValueChange` step. Return the save's promise: the thumb dims (`aria-busy`) until it
-     * settles; reject — the value glides back to the last saved one.
+     * The value the person settled on, once after a drag or a key step. Save here, not in `onValueChange`. Return the save's promise: the thumb dims until it settles; on reject the value goes back.
      */
     onCommit?: (value: number) => void | Promise<void>;
-    /** Name of the range input, submitted with a form. */
+    /**
+     * Name of the range input, submitted with a form.
+     */
     name?: string;
+    /**
+     * Lower bound.
+     */
     min?: number;
+    /**
+     * Upper bound.
+     */
     max?: number;
+    /**
+     * Step of the keyboard and of the snapping; fractions allowed.
+     */
     step?: number;
+    /**
+     * Muted track and thumb, dimmed label and value, no interaction.
+     */
     disabled?: boolean;
-    /** Invalid state: `aria-invalid` on the range input. A non-empty `error` implies it. */
+    /**
+     * `aria-invalid` on the range input and a danger focus ring on the thumb. A non-empty `error` implies it.
+     */
     invalid?: boolean;
-    /** Shows the current value at the end of the label row (tabular numbers). */
+    /**
+     * Shows the current value at the end of the label row (tabular numbers, `aria-hidden` — the input announces it).
+     */
     showValue?: boolean;
-    /** Formats the displayed value and `aria-valuetext` (e.g. `(v) => \`${v} °C\``). */
+    /**
+     * Formats the shown value and `aria-valuetext` (units, currency).
+     */
     formatValue?: (value: number) => string;
-    /** Tier. Default: the tier of the surrounding control (a form, a panel), else `m`. */
+    /**
+     * Tier of the track thickness T (thumb 4.5T × 3T), the label, the value and the hint. Without it the tier of its host (a form, a panel), else `m`.
+     */
     size?: ControlSize;
-    /** Color of the filled part of the track. */
+    /**
+     * Color of the filled part of the track.
+     */
     tone?: Tone;
     /**
-     * `vertical` — the track stands upright, minimum at the bottom, seven thumbs long at its tier
-     * (a level beside a button). Default `horizontal`.
+     * `vertical` — the track stands upright, minimum at the bottom: a level beside a button, a mixer column.
      */
     orientation?: "horizontal" | "vertical";
-    /** Id of the range input; generated when omitted. */
+    /**
+     * Id of the range input (generated when omitted); hint id is `<id>-hint`, error id is `<id>-error`.
+     */
     id?: string;
-    /** Name of the range input when there is no `label`. */
+    /**
+     * Accessible name when there is no visible `label`.
+     */
     "aria-label"?: string;
+    /**
+     * Merged before the hint / error ids on the range input.
+     */
     "aria-describedby"?: string;
+    /**
+     * Built-in strings, see Labels.
+     */
     labels?: Partial<SliderLabels>;
 };
 /**

package/dist/components/smart-filter/SmartFilter.d.ts

@@ -1,5 +1,5 @@
 import * as React from "react";
-import type { ControlSize } from "../../internal/states";
+import { type ControlSize } from "../../internal/states";
 import { type SmartFilterValue } from "./model";
 export type { SmartFilterFieldValue, SmartFilterMode, SmartFilterRange, SmartFilterSelection, SmartFilterValue, } from "./model";
 export { isSmartFilterRange, matchesSmartFilter, resolveSmartFilterValues } from "./model";
@@ -96,34 +96,61 @@ export type SmartFilterLabels = {
     /** Chip value of a range with only the upper bound. */
     rangeTo: string;
 };
-export type SmartFilterRootProps = {
-    /** The fields this screen filters by, in display order. Empty: only the search remains. */
+export declare const SMART_FILTER_LABELS: SmartFilterLabels;
+export type SmartFilterRootProps = Omit<React.HTMLAttributes<HTMLDivElement>, "children" | "defaultValue" | "onChange"> & {
+    /**
+     * Fields of this screen, in display order; empty — only the search. Pass a stable reference.
+     */
     fields: readonly SmartFilterField[];
-    /** Value per field key: a selection, or the bounds of a range field. */
+    /**
+     * Value per field key, controlled: `{ include, exclude }` for an options field, `{ from, to }` (numbers or dates, `null` — open) for a range field.
+     */
     value?: SmartFilterValue;
+    /**
+     * Initial selection, uncontrolled.
+     */
     defaultValue?: SmartFilterValue;
+    /**
+     * The whole next value; keys of fields this root does not show are kept.
+     */
     onValueChange?: (value: SmartFilterValue) => void;
-    /** Free-text search. Applied as typed; debounce it in the owner if needed. */
+    /**
+     * Search text, controlled.
+     */
     search?: string;
+    /**
+     * Initial search text, uncontrolled.
+     */
     defaultSearch?: string;
+    /**
+     * Every keystroke; debounce in the owner when it asks a server.
+     */
     onSearchChange?: (search: string) => void;
+    /**
+     * Tier of the filter button, the search, the tags and the panel. Without it the tier of its host, else `m`.
+     */
     size?: ControlSize;
-    /** Values of one field shown before «Ещё N». Default 12. */
+    /**
+     * Values of one field shown before «Ещё N» (not while searching).
+     */
     collapsedLimit?: number;
+    /**
+     * Built-in strings, see Labels.
+     */
     labels?: Partial<SmartFilterLabels>;
-    className?: string;
-    /** `SmartFilter.Toolbar` and `SmartFilter.Chips`. */
+    /**
+     * `SmartFilter.Toolbar` and `SmartFilter.Chips`, anywhere inside.
+     */
     children: React.ReactNode;
     ref?: React.Ref<HTMLDivElement>;
 };
-declare function SmartFilterRoot({ fields, value, defaultValue, onValueChange, search, defaultSearch, onSearchChange, size, collapsedLimit, labels, className, children, ref, }: SmartFilterRootProps): import("react/jsx-runtime").JSX.Element;
+declare function SmartFilterRoot({ fields, value, defaultValue, onValueChange, search, defaultSearch, onSearchChange, size: sizeProp, collapsedLimit, labels, className, children, ref, ...rest }: SmartFilterRootProps): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>;
 declare namespace SmartFilterRoot {
     var displayName: string;
 }
 export type SmartFilterToolbarProps = Omit<React.HTMLAttributes<HTMLDivElement>, "children"> & {
     /**
-     * The search input (default `true`). `false` — the filter button alone, for a screen whose
-     * text search lives elsewhere or does not exist.
+     * The search input. `false` — the filter button alone; the panel opens at its own width (24rem at most) and lists every field.
      */
     searchable?: boolean;
     ref?: React.Ref<HTMLDivElement>;
@@ -136,7 +163,7 @@ export type SmartFilterChipsProps = Omit<React.HTMLAttributes<HTMLDivElement>, "
     ref?: React.Ref<HTMLDivElement>;
 };
 /** The applied filters as removable tags, with "add" and "clear all". Renders nothing without filters. */
-declare function SmartFilterChips({ className, ...rest }: SmartFilterChipsProps): import("react/jsx-runtime").JSX.Element | null;
+declare function SmartFilterChips({ className, ref, ...rest }: SmartFilterChipsProps): import("react/jsx-runtime").JSX.Element | null;
 declare namespace SmartFilterChips {
     var displayName: string;
 }

package/dist/components/sparkline/Sparkline.d.ts

@@ -38,55 +38,78 @@ export type SparklineSummary = "latest" | "sum" | "average";
  * the height of an `xs` control, for a table cell or a list row.
  */
 export type SparklineLayout = "default" | "compact";
+export declare const SPARKLINE_LABELS: SparklineLabels;
 type SparklineRest = {
-    /** Default `latest`. */
+    /**
+     * What the headline shows at rest: `latest` — the latest point (or `highlight`), for a level (MRR, conversion); `sum` — the period total, for a flow (revenue per day); `average` — the period mean.
+     */
     summary?: "latest";
     /**
-     * Index of the point at rest (the current month): the headline shows it when nobody scrubs,
-     * and `bars` draw the other bars quieter. Default: the latest point with a value.
+     * Index of the point at rest with `summary="latest"` (the current month): the headline returns to it; `bars` draw the other bars quieter. Not allowed with `sum` / `average`.
      */
     highlight?: number;
 } | {
+    /**
+     * What the headline shows at rest: `latest` — the latest point (or `highlight`), for a level (MRR, conversion); `sum` — the period total, for a flow (revenue per day); `average` — the period mean.
+     */
     summary: "sum" | "average";
-    /** A total or a mean is no point: there is nothing to highlight at rest. */
+    /**
+     * Index of the point at rest with `summary="latest"` (the current month): the headline returns to it; `bars` draw the other bars quieter. Not allowed with `sum` / `average`.
+     */
     highlight?: never;
 };
 export type SparklineProps = Omit<React.HTMLAttributes<HTMLDivElement>, "children"> & SparklineRest & {
-    /** Points in order, oldest first; two present points in a row draw a line. */
+    /**
+     * Points oldest first, `{ label, value }`; `label` names the point («8 окт»), `value: null` is a point with no data — the line breaks, the bar is absent. A new array cross-fades the chart in.
+     */
     data: SparklinePoint[];
     /**
-     * Visible title above the value and the accessible name of the chart; with `layout="compact"`
-     * only the accessible name.
+     * Visible title above the value and the accessible name of the chart; with `layout="compact"` only the accessible name.
      */
     label: string;
-    /** Default `area`. */
+    /**
+     * `area` — a line over an accent gradient that fades to the bottom; `line` — the line alone, for many trends side by side; `bars` — a bar per point standing on a zero line: up when positive, down (danger) when negative.
+     */
     variant?: SparklineVariant;
-    /** Shape of the line between points (`area`, `line`). Default `smooth`. */
+    /**
+     * Shape of the line (`area`, `line`): `smooth` — a monotone cubic through every point that never overshoots a peak or a trough; `linear` — straight segments; `step` — a level per point, changing halfway between points.
+     */
     curve?: SparklineCurve;
-    /** Default `default`. */
+    /**
+     * `default` — the headline over an 80 px plot; `compact` — the plot alone at an `xs` control height with the dot at rest, for a DataTable cell; the scrubbed point shows in the tooltip and `aria-valuetext`.
+     */
     layout?: SparklineLayout;
-    /** What a scrubbed point's change badge compares with. Default `previous`. */
+    /**
+     * What the change badge of a shown point compares it with: `previous` — the point before it; `first` — the first point with a value (the change over the period); `none` — no badge.
+     */
     change?: SparklineChange;
     /**
-     * The same summary for the previous period («прошлые 30 дней»): the change badge at rest compares
-     * the headline with it. Without it a `sum` / `average` headline shows no change at rest.
+     * The same summary for the previous period («прошлые 30 дней»): the badge at rest compares the headline with it. Without it a `sum` / `average` headline shows no change at rest.
      */
     compareTo?: number;
     /**
-     * The value axis spans at least `min`…`max`: one scale for several sparklines (a table column)
-     * or a meaningful floor. Data outside widens the scale, never gets cut.
+     * The value axis reaches down to at least this value: a floor of zero, or one scale for several sparklines (a table column). Data below widens the scale, never gets cut.
      */
     min?: number;
+    /**
+     * The value axis reaches up to at least this value; data above widens the scale.
+     */
     max?: number;
-    /** A dashed horizontal line at this value: a plan, a target, an average. */
+    /**
+     * A dashed horizontal line at this value — a plan, a target, an average; the scale holds it and the chart is described by `labels.reference`.
+     */
     reference?: number;
     /**
-     * The series is on its way: Skeletons of the value, the date and the plot, which cross-fade into
-     * the data. The title stays; the root is `aria-busy`.
+     * The series is on its way: Skeletons of the date, the value and the plot that cross-fade into the data; the title stays, the root is `aria-busy` and the chart is not focusable yet.
      */
     loading?: boolean;
-    /** Display of a value («312 400 ₽»). Default: the number with Russian digit groups. */
+    /**
+     * Display of a value in the headline, the tooltip, the reference description and the spoken point («312 400 ₽»).
+     */
     formatValue?: (value: number) => string;
+    /**
+     * Built-in strings, see Labels.
+     */
     labels?: Partial<SparklineLabels>;
     ref?: React.Ref<HTMLDivElement>;
 };

package/dist/components/spinner/Spinner.d.ts

@@ -1,23 +1,29 @@
-import * as React from "react";
+import type * as React from "react";
 import type { ControlSize, TextTone } from "../../internal/states";
 export type SpinnerLabels = {
     /** Text read by screen readers while the spinner is shown. */
     loading: string;
 };
+export declare const SPINNER_LABELS: SpinnerLabels;
 export type SpinnerProps = Omit<React.HTMLAttributes<HTMLSpanElement>, "children"> & {
     /**
-     * Explicit size on the icon scale (xs 14 · s 16 · m 20 · l 24 · xl 32). Without it the spinner
-     * follows its host like an `Icon`: the host's icon size, else the nearest control tier, else 16.
+     * Explicit size on the icon scale: 14 · 16 · 20 · 24 · 32. Without it the spinner follows its host like `Icon`: the host's `--prime-icon-size`, else the nearest control tier, else 16.
      */
     size?: ControlSize;
-    /** Ring color; `default` inherits `currentColor`. */
+    /**
+     * Ring color; `default` inherits `currentColor`.
+     */
     tone?: TextTone;
+    /**
+     * Built-in strings, see Labels.
+     */
     labels?: Partial<SpinnerLabels>;
     ref?: React.Ref<HTMLSpanElement>;
 };
 /**
  * Indeterminate loading indicator: the kit ring (`internal/ring`) with the share unknown — a quarter
  * arc turning on a faint track, at the line weight. A `role="status"` region with `labels.loading`
- * for screen readers; pass `aria-hidden` when the host already says it is busy.
+ * for screen readers; pass `aria-hidden` when the host already says it is busy. It fades itself in
+ * (`enterMotion.enterFade`), so a host that shows it conditionally needs no motion of its own.
  */
 export declare function Spinner({ size: sizeProp, tone, labels: labelsProp, className, ...rest }: SpinnerProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/stepper/Stepper.d.ts

@@ -1,25 +1,54 @@
 import * as React from "react";
 import type { ControlSize } from "../../internal/states";
-/** Item state: derived from the Root `value` (before → `completed`, equal → `active`, after → `pending`) unless set on the item. */
-export type StepperItemStatus = "pending" | "active" | "completed" | "danger";
+/** Item state: derived from the Root `value` (before → `completed`, equal → `current`, after → `pending`) unless set on the item. */
+export type StepperItemStatus = "pending" | "current" | "completed" | "danger";
+export type StepperLabels = {
+    /** Spoken after the name of a completed step (the check is only seen). */
+    completed: string;
+    /** Spoken after the name of a step that needs attention (the colour and the glyph are only seen). */
+    danger: string;
+};
+export declare const STEPPER_LABELS: StepperLabels;
+type StepperOrientation = "horizontal" | "vertical";
 export type StepperRootProps = Omit<React.OlHTMLAttributes<HTMLOListElement>, "defaultValue" | "onChange"> & {
-    /** Default `vertical`. A horizontal stepper stacks vertically in containers narrower than 480px. */
-    orientation?: "horizontal" | "vertical";
-    /** Current step (0-based), controlled. */
+    /**
+     * Column of rows, or one row with chevrons (steps shrink and wrap their titles) that stacks below a 480px container.
+     */
+    orientation?: StepperOrientation;
+    /**
+     * Current step, 0-based (controlled).
+     */
     value?: number;
-    /** Initial step when uncontrolled. Default `0`. */
+    /**
+     * Initial step (uncontrolled).
+     */
     defaultValue?: number;
-    /** Called with the item index when an item is clicked. */
+    /**
+     * Called with the index of the clicked item.
+     */
     onValueChange?: (index: number) => void;
+    /**
+     * Every vertical row ends with a chevron: each step opens a page or panel. Horizontal steps already have their chevrons.
+     */
+    arrows?: boolean;
+    /**
+     * Indicator 20 · 24 · 28 · 32 · 36, title in the control text of the tier. Without it the tier of its host, else `m`.
+     */
     size?: ControlSize;
+    /**
+     * Built-in strings, see Labels.
+     */
+    labels?: Partial<StepperLabels>;
     ref?: React.Ref<HTMLOListElement>;
 };
-declare function StepperRoot({ orientation, value: valueProp, defaultValue, onValueChange, size, children, className, ...rest }: StepperRootProps): import("react/jsx-runtime").JSX.Element;
+declare function StepperRoot({ orientation, value: valueProp, defaultValue, onValueChange, arrows, size: sizeProp, labels: labelsProp, children, className, ...rest }: StepperRootProps): import("react/jsx-runtime").JSX.Element;
 declare namespace StepperRoot {
     var displayName: string;
 }
 export type StepperItemProps = Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "type"> & {
-    /** Overrides the status derived from the Root `value` (e.g. `danger`). */
+    /**
+     * Overrides the status derived from `value` (before → `completed`, equal → `current`, after → `pending`).
+     */
     status?: StepperItemStatus;
     ref?: React.Ref<HTMLButtonElement>;
 };
@@ -31,7 +60,9 @@ type SpanProps = React.HTMLAttributes<HTMLSpanElement> & {
     ref?: React.Ref<HTMLSpanElement>;
 };
 export type StepperIndicatorProps = SpanProps & {
-    /** Replaces the default content (the item number, or a check when completed). */
+    /**
+     * Replaces the default content, e.g. `<Icon name="status.info" />`.
+     */
     children?: React.ReactNode;
 };
 declare function StepperIndicator({ children, className, ...rest }: StepperIndicatorProps): import("react/jsx-runtime").JSX.Element;
@@ -54,14 +85,6 @@ declare function StepperDescription({ className, ...rest }: StepperDescriptionPr
 declare namespace StepperDescription {
     var displayName: string;
 }
-export type StepperArrowProps = Omit<React.SVGAttributes<SVGSVGElement>, "children" | "color"> & {
-    ref?: React.Ref<SVGSVGElement>;
-};
-/** Trailing chevron for vertical items that open a page or panel. */
-declare function StepperArrow({ className, ...rest }: StepperArrowProps): import("react/jsx-runtime").JSX.Element;
-declare namespace StepperArrow {
-    var displayName: string;
-}
 export declare const Stepper: {
     Root: typeof StepperRoot;
     Item: typeof StepperItem;
@@ -69,6 +92,5 @@ export declare const Stepper: {
     Content: typeof StepperContent;
     Title: typeof StepperTitle;
     Description: typeof StepperDescription;
-    Arrow: typeof StepperArrow;
 };
 export {};