prime-ui-kit 0.14.0 → 0.16.0

package/dist/components/gallery/Gallery.d.ts

@@ -1,6 +1,8 @@
 import * as React from "react";
 import { type TransferDirection, type TransferLabels, type TransferState } from "../../internal/transfer";
 import { type GalleryLayout } from "./layout";
+/** The most items one album lays out: a longer set goes as several albums. */
+export { GALLERY_MAX } from "./layout";
 export type GalleryItem = {
     /** Default `image`. */
     type?: "image" | "video";
@@ -28,38 +30,64 @@ export type GalleryLabels = {
     photo: string;
     video: string;
 } & TransferLabels;
+export declare const GALLERY_LABELS: GalleryLabels;
+/** The album's props; each is described in `api.ts`. */
 export type GalleryProps = React.HTMLAttributes<HTMLDivElement> & {
-    /** One photo or video, or an album of 2–10 laid out by their aspect ratios. More are not shown. */
+    /**
+     * `{ type?, src, poster?, alt?, width?, height?, duration?, transfer?, transferProgress?, transferDirection? }`; `width` / `height` give the ratio (default 4 : 3). The first 10 are shown.
+     */
     items: readonly GalleryItem[];
     /**
-     * The album opens in the kit's `MediaViewer` (default `true`): a tile opens it at that item, the
-     * whole album its set, out of the tile and back into it. `false` — no viewer of the kit: open your
-     * own from `onOpenChange` and `onIndexChange`.
+     * Caps the width at this CSS length instead of the host's width (`85cqi` of a chat row); the gallery then draws no radius — the host shapes and clips it.
+     */
+    maxSize?: string;
+    /**
+     * A tile (a press, Enter or Space) opens the album in the kit's `MediaViewer` at that item. `false` — no viewer of the kit: open your own from `onOpenChange` and `onIndexChange`.
      */
     viewer?: boolean;
-    /** The viewer is open (controlled). */
+    /**
+     * The viewer is open (controlled).
+     */
     open?: boolean;
-    /** Initially open (uncontrolled). Default `false`. */
+    /**
+     * Initially open (uncontrolled).
+     */
     defaultOpen?: boolean;
-    /** A tile opened the viewer (`true`), or the viewer closed (`false`). */
+    /**
+     * A tile opened the viewer (`true`), or the viewer closed (`false`).
+     */
     onOpenChange?: (open: boolean) => void;
-    /** The item the viewer shows (controlled); a tile sets it to its own. */
+    /**
+     * The item the viewer shows (controlled); a tile sets it to its own.
+     */
     index?: number;
-    /** The item shown first (uncontrolled). Default `0`. */
+    /**
+     * The item shown first (uncontrolled).
+     */
     defaultIndex?: number;
-    /** A tile was activated, or the viewer turned its page: the item now shown. */
+    /**
+     * A tile was activated, or the viewer turned its page: the item now shown.
+     */
     onIndexChange?: (index: number) => void;
     /**
-     * Cancel the transfer of a tile (the disk with the cross in its middle). A returned promise keeps
-     * the disk pending; a rejection leaves the transfer running and is announced.
+     * Cancel the transfer in flight: the disk's cross. A returned promise keeps the disk pending (a spinner, `aria-busy`, no second press); a rejection leaves the transfer as it was and announces `cancelFailed`.
      */
     onCancel?: (index: number) => void | Promise<void>;
-    /** Transfer a failed tile again; a promise works the same. */
+    /**
+     * Transfer it again after a failure: the danger disk's retry; a promise works the same (`retryFailed` on a rejection).
+     */
     onRetry?: (index: number) => void | Promise<void>;
-    /** Fetch a `remote` tile (the download arrow); a promise works the same. */
+    /**
+     * Fetch a `remote` content: the download arrow; set `transfer` to `loading` with `transferDirection="download"` as it starts. A promise works the same (`downloadFailed` on a rejection).
+     */
     onDownload?: (index: number) => void | Promise<void>;
+    /**
+     * Built-in strings, see Labels.
+     */
     labels?: Partial<GalleryLabels>;
-    /** Laid over the gallery, above every tile (a caption pill, a message's time). */
+    /**
+     * Laid over the gallery, above every tile (a caption pill, a message's time).
+     */
     children?: React.ReactNode;
     ref?: React.Ref<HTMLDivElement>;
 };
@@ -73,7 +101,7 @@ export declare function galleryLayoutOf(items: readonly GalleryItem[]): GalleryL
  * `viewer={false}` with the open and index triads); a tile on its way, either way, dims under the
  * shared transfer disk.
  */
-export declare function Gallery({ items: itemsProp, viewer, open: openProp, defaultOpen, onOpenChange, index: indexProp, defaultIndex, onIndexChange, onCancel, onRetry, onDownload, labels: labelsProp, className, style, children, ref, ...rest }: GalleryProps): import("react/jsx-runtime").JSX.Element;
+export declare function Gallery({ items, maxSize, viewer, open: openProp, defaultOpen, onOpenChange, index: indexProp, defaultIndex, onIndexChange, onCancel, onRetry, onDownload, labels: labelsProp, className, style, children, ...rest }: GalleryProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace Gallery {
     var displayName: string;
 }

package/dist/components/gallery/layout.d.ts

@@ -30,5 +30,8 @@ export type GalleryLayout = {
 export declare const GALLERY_MAX = 10;
 /** Width ÷ height of an item, kept between a tall portrait and a wide panorama. */
 export declare function itemRatio(width: number | undefined, height: number | undefined, single: boolean): number;
-/** The layout of `ratios` (width ÷ height of each item, in order). */
+/**
+ * The layout of `ratios` (width ÷ height of each item, in order): the only place the album is
+ * capped — items past `GALLERY_MAX` get no tile.
+ */
 export declare function layoutGallery(ratios: readonly number[]): GalleryLayout;

package/dist/components/gantt/Gantt.d.ts

@@ -42,73 +42,108 @@ export type GanttLabels = {
     /** Default empty-state text (when `empty` is not set). */
     empty: string;
 };
-export type GanttProps<Row, Bar extends GanttBar = GanttBar> = Omit<React.HTMLAttributes<HTMLDivElement>, "children" | "onSelect"> & {
-    /** The outer surface `<div>`; `aria-label` / `aria-labelledby` name the grid inside. */
+export declare const GANTT_LABELS: GanttLabels;
+export type GanttProps<Row, Bar extends GanttBar = GanttBar> = Omit<React.HTMLAttributes<HTMLDivElement>, "children"> & {
     ref?: React.Ref<HTMLDivElement>;
-    /** Rows: people, rooms, vehicles, tasks. Only the rows in view are rendered. */
+    /**
+     * Rows: people, rooms, vehicles, tasks. Virtualized, so thousands of rows stay fast.
+     */
     rows: Row[];
-    /** Stable row id. */
+    /**
+     * Stable row id.
+     */
     getRowKey: (row: Row) => React.Key;
-    /** Row name: the first column text by default, and the row header for assistive tech. */
+    /**
+     * Row name: the first column text by default and the row header for assistive tech.
+     */
     getRowLabel: (row: Row) => string;
-    /** Bars of a row; overlapping bars stack into lanes. */
+    /**
+     * Bars of a row (`GanttBar`); bars that overlap in time stack into lanes and grow the row.
+     */
     getRowBars: (row: Row) => Bar[];
-    /** First-column content instead of the label (a name with a role or a code). */
+    /**
+     * First-column content instead of the label (a name with a role or a code).
+     */
     renderRow?: (row: Row) => React.ReactNode;
-    /** A picture before the row content (an `Avatar`); on a narrow chart the column keeps only it. */
+    /**
+     * A picture before the row content (an `Avatar`). Below 36rem of chart width the column keeps only it; the row header is then named by `getRowLabel` (`aria-label`).
+     */
     renderRowAvatar?: (row: Row) => React.ReactNode;
     /**
-     * The row header is a link: a real `<a>` fills the first column and is the row's stop in the
-     * grid, so a click, ⌘/Ctrl-click, a middle click and «open in new tab» work on it.
+     * The row header is a link: a real `<a>` fills the first column and is the row's stop in the grid, so a click, ⌘/Ctrl-click, a middle click and «open in new tab» work on it; Space follows it like Enter.
      */
     getRowHref?: (row: Row) => string;
     /**
-     * Opens a row in place: a click on its header (never on a control inside it, never from a
-     * portal) or Enter / Space on the focused header. With `getRowHref` it gets the plain clicks
-     * only — call `event.preventDefault()` there to route in the app instead of loading the page.
+     * Opens a row in place (a profile in a Drawer): a click on its header, Enter or Space; never from a control inside it. With `getRowHref` it gets plain clicks: `event.preventDefault()` routes in the app.
      */
     onRowClick?: (row: Row, event: GanttRowClickEvent) => void;
     /**
-     * Extra content of a bar's tooltip, under its title and the dates line (which always stay: the
-     * dates are what the bar means on the axis). A client, hours, an owner.
+     * Extra lines of a bar's tooltip (a client, hours, an owner), under its title and the dates line — those always stay, the dates and the duration are what the bar means on the axis.
      */
     renderBarTooltip?: (bar: Bar, row: Row) => React.ReactNode;
-    /** Zoom, controlled. */
+    /**
+     * Zoom, controlled: a column per day (months over days), per week (months over weeks) or per month (years over months).
+     */
     scale?: GanttScale;
-    /** Initial zoom, uncontrolled. */
+    /**
+     * Initial zoom, uncontrolled.
+     */
     defaultScale?: GanttScale;
+    /**
+     * The zoom switch changed. The day in the middle of the view stays in the middle.
+     */
     onScaleChange?: (scale: GanttScale) => void;
-    /** The time axis; default — every bar and today with room on both sides. */
+    /**
+     * The time axis, snapped to whole units. Default: every bar and today with room on both sides (a week of days, two weeks, a month), at least 35 days / 14 weeks / 12 months.
+     */
     range?: GanttDates;
-    /** The day of the today line. Default — the current day. */
+    /**
+     * The day of the today line; the chart opens with it a third into the view and «Сегодня» scrolls back to it.
+     */
     today?: Date;
-    /** date-fns locale of the header and the dates. Default `ru`. */
+    /**
+     * date-fns locale of the header, tooltips and spoken dates.
+     */
     locale?: Locale;
+    /**
+     * Tier of rows, bars, header and toolbar controls: one-lane rows 28 · 32 · 44 · 48 · 52 px; a day is 32 · 40 · 48 px wide at `day`; bar text one tier down. Without it the tier of its host, else `m`.
+     */
     size?: ControlSize;
-    /** No moving, resizing or creating; bars still select and show their dates. */
+    /**
+     * No moving, resizing or creating; bars still select and show their dates.
+     */
     readOnly?: boolean;
-    /** Skeleton rows while there are no rows yet; with rows they stay and the grid is busy. */
+    /**
+     * Without rows — skeleton rows in the chart's geometry and a status for screen readers; with rows they stay and the grid is `aria-busy`.
+     */
     loading?: boolean;
-    /** Empty-state content (e.g. `EmptyPage`); defaults to `labels.empty`. */
+    /**
+     * Empty-state content when `rows` is empty; a string goes into a compact `EmptyPage`. Defaults to `labels.empty`.
+     */
     empty?: React.ReactNode;
-    /** Content at the start of the toolbar (title, filters); the zoom and «Сегодня» sit at its end. */
+    /**
+     * Content at the start of the toolbar (title, filters, a primary action); the zoom and «Сегодня» sit at its end.
+     */
     toolbar?: React.ReactNode;
-    /** Max height of the scroll viewport in px; `"fill"` — the chart takes its parent's height. */
+    /**
+     * Max height of the viewport in px, so the header sticks while rows scroll; `"fill"` — the chart takes its flex / grid parent's height.
+     */
     scrollHeight?: number | "fill";
-    /** A bar was activated (click, Enter, Space): open its record. */
-    onSelect?: (bar: Bar, row: Row) => void;
     /**
-     * New dates of a bar after a drag or an editing key, in whole scale units. Update your data with
-     * them. A returned Promise keeps the bar at the new dates and busy until it settles; on reject it
-     * glides back. Without it, bars cannot be edited.
+     * A bar was activated (click, Enter, Space): open its record. A drag never opens it.
+     */
+    onItemOpen?: (bar: Bar, row: Row) => void;
+    /**
+     * New dates of a bar after a drag or an editing key — update your data. A returned Promise keeps the bar busy at the new dates; a rejection glides it back. Without it bars cannot be edited.
      */
     onBarChange?: (dates: GanttDates, bar: Bar, row: Row) => void | Promise<void>;
     /**
-     * A bar was drawn on an empty spot of a row (drag, double-click, long-press, `N`), in whole scale
-     * units. Add it to your data. A returned Promise keeps a busy ghost in place until it settles;
-     * on reject the ghost fades out. Without it, nothing can be created.
+     * A new bar in a row: drawn across empty space, a double-click, a touch long-press or `N`. Add it to your data; a returned Promise keeps a busy ghost in place. Without it nothing can be created.
      */
     onBarCreate?: (dates: GanttDates, row: Row) => void | Promise<void>;
+    /**
+     * Built-in strings, see Labels.
+     */
     labels?: Partial<GanttLabels>;
 };
 /**
@@ -117,4 +152,4 @@ export type GanttProps<Row, Bar extends GanttBar = GanttBar> = Omit<React.HTMLAt
  * keyboard through an async `onBarChange`, and are drawn on empty space through `onBarCreate`.
  * Rows and the time axis are virtualized: thousands of rows over years stay fast.
  */
-export declare function Gantt<Row, Bar extends GanttBar = GanttBar>({ rows, getRowKey, getRowLabel, getRowBars, renderRow, renderRowAvatar, getRowHref, onRowClick, renderBarTooltip, scale: scaleProp, defaultScale, onScaleChange, range: rangeProp, today: todayProp, locale, size, readOnly, loading, empty, toolbar, scrollHeight, onSelect, onBarChange, onBarCreate, labels: labelsProp, className, style, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, ref, ...rest }: GanttProps<Row, Bar>): import("react/jsx-runtime").JSX.Element;
+export declare function Gantt<Row, Bar extends GanttBar = GanttBar>({ rows, getRowKey, getRowLabel, getRowBars, renderRow, renderRowAvatar, getRowHref, onRowClick, renderBarTooltip, scale: scaleProp, defaultScale, onScaleChange, range: rangeProp, today: todayProp, locale, size: sizeProp, readOnly, loading, empty, toolbar, scrollHeight, onItemOpen, onBarChange, onBarCreate, labels: labelsProp, className, style, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, ref, ...rest }: GanttProps<Row, Bar>): import("react/jsx-runtime").JSX.Element;

package/dist/components/gantt/GanttRow.d.ts

@@ -13,9 +13,9 @@ export type GanttTrackEvent = "pointerDown" | "pointerMove" | "pointerUp" | "poi
  * row re-renders only when its own props change — scrolling mounts new rows and leaves the rest.
  */
 export type GanttRowContext = {
-    register: (id: string) => (node: HTMLElement | null) => void;
+    register: (id: string) => React.RefCallback<HTMLElement>;
     focus: (id: string) => void;
-    select: (barId: string, rowIndex: number) => void;
+    open: (barId: string, rowIndex: number) => void;
     /** `onRowClick` of the row at `rowIndex`. */
     openRow: (rowIndex: number, event: React.MouseEvent<HTMLElement> | React.KeyboardEvent<HTMLElement>) => void;
     commit: (barId: string, rowIndex: number, dates: GanttDates) => void;

package/dist/components/hint/Hint.d.ts

@@ -1,15 +1,21 @@
 import type * as React from "react";
 import type { ControlSize } from "../../internal/states";
 export type HintRootProps = React.HTMLAttributes<HTMLParagraphElement> & {
-    /** Tier of the paired field. */
+    /**
+     * Tier of the paired field: 12/16 for xs–m, 13/20 for l and xl. Without it the tier of its host, else `m`.
+     */
     size?: ControlSize;
-    /** Error message styling (`danger-text`); the message drops in. */
+    /**
+     * Error styling: danger text that drops in (fade + 4 px from above).
+     */
     invalid?: boolean;
-    /** Dimmed text next to a disabled control. */
+    /**
+     * Disabled text color, next to a disabled control. A disabled `Fieldset` around the hint sets it too.
+     */
     disabled?: boolean;
     ref?: React.Ref<HTMLParagraphElement>;
 };
-declare function HintRoot({ className, size, invalid, disabled, children, ...rest }: HintRootProps): import("react/jsx-runtime").JSX.Element;
+declare function HintRoot({ className, size: sizeProp, invalid, disabled: disabledProp, children, ...rest }: HintRootProps): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>;
 declare namespace HintRoot {
     var displayName: string;
 }

package/dist/components/index.d.ts

@@ -1,14 +1,13 @@
 export type { ControlSizeProviderProps } from "../internal/ControlSizeContext";
 export { ControlSizeProvider, useOptionalControlSize } from "../internal/ControlSizeContext";
 export type { ProgressScale, ProgressSegment } from "../internal/progressSegments";
-export type { VisuallyHiddenProps } from "../internal/VisuallyHidden";
-export { VisuallyHidden } from "../internal/VisuallyHidden";
 export * from "../layout/index";
-export type { AccordionContentProps, AccordionHeaderProps, AccordionIconProps, AccordionItemProps, AccordionMultipleProps, AccordionRootProps, AccordionSingleProps, AccordionTriggerProps, } from "./accordion/Accordion";
+export type { AccordionContentProps, AccordionHeaderProps, AccordionHeadingLevel, AccordionIconProps, AccordionItemProps, AccordionMultipleProps, AccordionRootProps, AccordionSingleProps, AccordionTriggerProps, } from "./accordion/Accordion";
 export { Accordion } from "./accordion/Accordion";
 export type { AvatarFallbackProps, AvatarGroupProps, AvatarImageProps, AvatarOverflowProps, AvatarPresence, AvatarRootProps, AvatarSize, AvatarStatusLabels, AvatarStatusProps, } from "./avatar/Avatar";
 export { Avatar } from "./avatar/Avatar";
-export * from "./badge/Badge";
+export type { BadgeActionProps, BadgeDotProps, BadgeIconProps, BadgeLabels, BadgeRootProps, } from "./badge/Badge";
+export { Badge } from "./badge/Badge";
 export type { BannerActionsProps, BannerContentProps, BannerDescriptionProps, BannerIconProps, BannerLabels, BannerRootProps, BannerTitleProps, } from "./banner/Banner";
 export { Banner } from "./banner/Banner";
 export type { BreadcrumbEllipsisProps, BreadcrumbItemProps, BreadcrumbLabels, BreadcrumbRootProps, } from "./breadcrumb/Breadcrumb";
@@ -19,13 +18,13 @@ export type { ButtonGroupIconProps, ButtonGroupItemProps, ButtonGroupLabels, But
 export { ButtonGroup } from "./button-group/ButtonGroup";
 export type { CardBodyProps, CardDeltaProps, CardDescriptionProps, CardFooterProps, CardHeaderProps, CardHeadingLevel, CardIconProps, CardLabelProps, CardListItemProps, CardListProps, CardMediaProps, CardMetaProps, CardRootProps, CardTitleProps, CardValueProps, CardVariant, } from "./card/Card";
 export { Card } from "./card/Card";
-export type { ChartFrameActionsProps, ChartFrameDeltaProps, ChartFrameDescriptionProps, ChartFrameHeaderProps, ChartFrameLabels, ChartFrameLegendProps, ChartFramePlotArea, ChartFramePlotProps, ChartFramePlotSeries, ChartFrameRootProps, ChartFrameSeries, ChartFrameState, ChartFrameTableProps, ChartFrameTableRow, ChartFrameTitleProps, ChartFrameTooltipItem, ChartFrameTooltipProps, ChartFrameValueProps, } from "./chart-frame/ChartFrame";
+export type { ChartFrameActionsProps, ChartFrameDeltaProps, ChartFrameDescriptionProps, ChartFrameHeaderProps, ChartFrameLabels, ChartFrameLegendProps, ChartFramePlotArea, ChartFramePlotProps, ChartFramePlotSeries, ChartFrameRootProps, ChartFrameRow, ChartFrameSeries, ChartFrameState, ChartFrameTitleProps, ChartFrameTooltipItem, ChartFrameTooltipProps, ChartFrameValueProps, } from "./chart-frame/ChartFrame";
 export { ChartFrame } from "./chart-frame/ChartFrame";
 export type { ChatActionsProps, ChatDescriptionProps, ChatFooterProps, ChatHeaderProps, ChatLabels, ChatMessageEntry, ChatMessagesProps, ChatPinnedItem, ChatPinnedLabels, ChatPinnedProps, ChatRootProps, ChatSearchButtonProps, ChatSearchProps, ChatSelectionBarProps, ChatSeparatorProps, ChatServiceProps, ChatTitleProps, ChatUnreadLabels, ChatUnreadProps, GroupMessagesOptions, MessageListEntry, } from "./chat/Chat";
 export { Chat, formatMessageDate, groupMessages } from "./chat/Chat";
 export type { ChatListItemDescriptionProps, ChatListItemIconProps, ChatListItemMenuProps, ChatListItemProps, ChatListItemTextProps, ChatListLabels, ChatListMediaKind, ChatListRootProps, } from "./chat-list/ChatList";
 export { ChatList, formatChatTime } from "./chat-list/ChatList";
-export type { CheckboxIndicatorProps, CheckboxLabelProps, CheckboxRootProps, CheckboxShape, } from "./checkbox/Checkbox";
+export type { CheckboxIndicatorProps, CheckboxLabelProps, CheckboxLabels, CheckboxRootProps, CheckboxShape, } from "./checkbox/Checkbox";
 export { Checkbox } from "./checkbox/Checkbox";
 export type { CodeBlockColorScheme, CodeBlockProps, CodeBlockVariant, } from "./code-block/CodeBlock";
 export { CodeBlock } from "./code-block/CodeBlock";
@@ -44,7 +43,7 @@ export { Crossfade } from "./crossfade/Crossfade";
 export type { DataTableColumn, DataTableColumnsMenuProps, DataTableGroup, DataTableLabels, DataTableOrder, DataTableProps, DataTableRowClickEvent, DataTableSortState, } from "./data-table/DataTable";
 export { DataTable } from "./data-table/DataTable";
 export type { DatepickerLabels, DatepickerPanelProps, DatepickerPreset, DatepickerRange, DatepickerRootProps, WeekStart, } from "./datepicker/Datepicker";
-export { Datepicker, DEFAULT_DATEPICKER_PRESETS, datepickerPresets, formatDatepickerValue, YEARLESS_YEAR, } from "./datepicker/Datepicker";
+export { Datepicker, DEFAULT_DATEPICKER_PRESETS, datepickerPresets, formatDatepickerValue, formatDateValue, YEARLESS_YEAR, } from "./datepicker/Datepicker";
 export type { DescriptionListItemActionProps, DescriptionListItemProps, DescriptionListLabels, DescriptionListOrientation, DescriptionListRootProps, } from "./description-list/DescriptionList";
 export { DescriptionList } from "./description-list/DescriptionList";
 export type { DigitInputLabels, DigitInputProps } from "./digit-input/DigitInput";
@@ -52,8 +51,7 @@ export { DigitInput } from "./digit-input/DigitInput";
 export type { DividerAlign, DividerOrientation, DividerProps } from "./divider/Divider";
 export { Divider } from "./divider/Divider";
 export type { DndDraggableProps, DndDropZoneProps, DndHandleProps, DndLabels, DndRootProps, DndSortableItemProps, DndSortableProps, DragItem, DragOutcome, } from "./dnd/Dnd";
-export { Dnd } from "./dnd/Dnd";
-export { moveBefore } from "./dnd/useSortableList";
+export { Dnd, moveBefore } from "./dnd/Dnd";
 export * from "./drawer/Drawer";
 export type { DropdownCheckboxItemProps, DropdownContentProps, DropdownDescriptionProps, DropdownGroupProps, DropdownHeaderProps, DropdownItemDescriptionProps, DropdownItemIconProps, DropdownItemProps, DropdownItemShortcutProps, DropdownRootProps, DropdownSeparatorProps, DropdownTitleProps, DropdownTriggerProps, } from "./dropdown/Dropdown";
 export { Dropdown } from "./dropdown/Dropdown";
@@ -65,7 +63,7 @@ export type { FieldListColumn, FieldListColumnWidth, FieldListLabels, FieldListP
 export { FieldList } from "./field-list/FieldList";
 export type { FieldsetProps } from "./fieldset/Fieldset";
 export { Fieldset } from "./fieldset/Fieldset";
-export type { FileUploadBodyProps, FileUploadDescriptionProps, FileUploadFile, FileUploadFormatBadgeProps, FileUploadIconProps, FileUploadItemActionsProps, FileUploadItemDescriptionProps, FileUploadItemNameProps, FileUploadItemPreviewProps, FileUploadItemProgressProps, FileUploadItemProps, FileUploadLabels, FileUploadLayout, FileUploadQueueProps, FileUploadQueueSource, FileUploadRootProps, FileUploadTitleProps, FileUploadTrigger, FileUploadVariant, } from "./file-upload/FileUpload";
+export type { FileUploadBodyProps, FileUploadDescriptionProps, FileUploadFile, FileUploadFormatBadgeProps, FileUploadIconProps, FileUploadItemActionsProps, FileUploadItemDescriptionProps, FileUploadItemPreviewProps, FileUploadItemProgressProps, FileUploadItemProps, FileUploadItemTextProps, FileUploadLabels, FileUploadLayout, FileUploadPicker, FileUploadQueueProps, FileUploadQueueSource, FileUploadRootProps, FileUploadTitleProps, FileUploadTrigger, FileUploadVariant, } from "./file-upload/FileUpload";
 export { FileUpload } from "./file-upload/FileUpload";
 export type { GalleryItem, GalleryLabels, GalleryProps } from "./gallery/Gallery";
 export { Gallery } from "./gallery/Gallery";
@@ -76,7 +74,7 @@ export { Hint } from "./hint/Hint";
 export type { InputActionProps, InputAffixProps, InputClearButtonProps, InputCopyButtonProps, InputCounterProps, InputFieldProps, InputIconProps, InputInlineAffixProps, InputLabels, InputRevealButtonProps, InputRootProps, InputWrapperProps, } from "./input/Input";
 export { Input } from "./input/Input";
 export { getPasswordStrength, type PasswordStrength } from "./input/passwordStrength";
-export type { KanbanColumn, KanbanColumnMove, KanbanItemBadgesProps, KanbanItemClickEvent, KanbanItemCountProps, KanbanItemDescriptionProps, KanbanItemFooterProps, KanbanItemHeaderProps, KanbanItemProps, KanbanItemTitleProps, KanbanLabels, KanbanMove, KanbanRootProps, KanbanValue, KanbanVariant, } from "./kanban/Kanban";
+export type { KanbanColumn, KanbanColumnMove, KanbanColumnTitleAs, KanbanItemBadgesProps, KanbanItemCountProps, KanbanItemDescriptionProps, KanbanItemFooterProps, KanbanItemHeaderProps, KanbanItemOpenEvent, KanbanItemProps, KanbanItemTitleProps, KanbanLabels, KanbanMove, KanbanRootProps, KanbanValue, KanbanVariant, } from "./kanban/Kanban";
 export { Kanban } from "./kanban/Kanban";
 export type { KbdProps } from "./kbd/Kbd";
 export { Kbd } from "./kbd/Kbd";
@@ -96,15 +94,15 @@ export { Message } from "./message/Message";
 export type { MessageContactProps, MessageLinkPreviewProps, MessageLocationLabels, MessageLocationProps, } from "./message/MessageCards";
 export type { MessageFileLabels, MessageFileProps } from "./message/MessageFile";
 export type { MessageMediaProps } from "./message/MessageMedia";
-export type { ModalActionsProps, ModalBodyProps, ModalCloseProps, ModalConfirmProps, ModalContentProps, ModalDescriptionProps, ModalFooterProps, ModalGuardProps, ModalHeaderProps, ModalIconProps, ModalLabels, ModalMetaProps, ModalRootProps, ModalTitleProps, ModalTriggerProps, } from "./modal/Modal";
+export type { ModalActionsProps, ModalBodyProps, ModalCloseProps, ModalConfirmProps, ModalContentProps, ModalDescriptionProps, ModalFooterProps, ModalGuardProps, ModalHeaderProps, ModalIconProps, ModalLabels, ModalMetaProps, ModalPlacement, ModalRootProps, ModalTitleProps, ModalTriggerProps, } from "./modal/Modal";
 export { Modal } from "./modal/Modal";
 export type { NativeSelectLabels, NativeSelectProps } from "./native-select/NativeSelect";
 export { NativeSelect } from "./native-select/NativeSelect";
-export type { NotificationAction, NotificationCardProps, NotificationLabels, NotificationOptions, NotificationPosition, NotificationRecord, NotificationTone, } from "./notification/Notification";
+export type { NotificationAction, NotificationCardProps, NotificationDismissReason, NotificationLabels, NotificationOptions, NotificationPosition, NotificationRecord, NotificationTone, } from "./notification/Notification";
 export { NotificationCard } from "./notification/Notification";
 export type { NotificationProviderProps } from "./notification/NotificationStore";
 export { NotificationProvider, useNotifications, } from "./notification/NotificationStore";
-export type { PageContentActionsProps, PageContentBackButtonProps, PageContentBodyProps, PageContentCellProps, PageContentCellRows, PageContentCellSpan, PageContentDescriptionMeasure, PageContentDescriptionProps, PageContentDetailProps, PageContentGridProps, PageContentHeaderProps, PageContentLabels, PageContentListProps, PageContentMaxWidth, PageContentPageProps, PageContentRootProps, PageContentSectionLayout, PageContentSectionProps, PageContentSplitProps, PageContentTitleProps, } from "./page-content/PageContent";
+export type { PageContentActionsProps, PageContentBackButtonProps, PageContentBodyProps, PageContentCellProps, PageContentCellRows, PageContentCellSpan, PageContentDescriptionMeasure, PageContentDescriptionProps, PageContentGridProps, PageContentHeaderProps, PageContentLabels, PageContentMaxWidth, PageContentPanelKind, PageContentPanelProps, PageContentRootAs, PageContentRootProps, PageContentSectionLayout, PageContentSectionProps, PageContentSplitProps, PageContentTitleProps, } from "./page-content/PageContent";
 export { PageContent } from "./page-content/PageContent";
 export type { PageToolbarActionsProps, PageToolbarChipsProps, PageToolbarRootProps, PageToolbarSectionsProps, PageToolbarToolsProps, PageToolbarViewProps, } from "./page-toolbar/PageToolbar";
 export { PageToolbar } from "./page-toolbar/PageToolbar";
@@ -135,18 +133,19 @@ export type { SparklineLabels, SparklineLayout, SparklinePoint, SparklineProps,
 export { Sparkline } from "./sparkline/Sparkline";
 export type { SpinnerLabels, SpinnerProps } from "./spinner/Spinner";
 export { Spinner } from "./spinner/Spinner";
-export type { StepperArrowProps, StepperContentProps, StepperDescriptionProps, StepperIndicatorProps, StepperItemProps, StepperItemStatus, StepperRootProps, StepperTitleProps, } from "./stepper/Stepper";
+export type { StepperContentProps, StepperDescriptionProps, StepperIndicatorProps, StepperItemProps, StepperItemStatus, StepperLabels, StepperRootProps, StepperTitleProps, } from "./stepper/Stepper";
 export { Stepper } from "./stepper/Stepper";
-export type { SwitchLabelProps, SwitchRootProps, } from "./switch/Switch";
+export type { SwitchLabelProps, SwitchLabels, SwitchRootProps, } from "./switch/Switch";
 export { Switch } from "./switch/Switch";
-export * from "./tabs/Tabs";
+export type { TabsCountProps, TabsDescriptionProps, TabsIconProps, TabsItemProps, TabsLabelProps, TabsLabels, TabsListProps, TabsPanelProps, TabsRootProps, TabsSeparatorProps, } from "./tabs/Tabs";
+export { Tabs } from "./tabs/Tabs";
 export type { TagSelectLabels, TagSelectOption, TagSelectOptionUpdate, TagSelectProps, } from "./tag-select/TagSelect";
 export { TagSelect } from "./tag-select/TagSelect";
 export type { TextareaActionProps, TextareaCopyButtonProps, TextareaCounterProps, TextareaLabels, TextareaRootProps, TextFormat, } from "./textarea/Textarea";
 export { Textarea } from "./textarea/Textarea";
 export type { ThumbnailFallbackProps, ThumbnailImageProps, ThumbnailRatio, ThumbnailRootProps, ThumbnailVideoProps, } from "./thumbnail/Thumbnail";
 export { Thumbnail } from "./thumbnail/Thumbnail";
-export type { TimelineGapMetaProps, TimelineGapProps, TimelineGroupProps, TimelineItemProps, TimelineMetaPrimaryProps, TimelineMetaProps, TimelineRootProps, TimelineTitleProps, TimelineValueMetaProps, TimelineValueProps, } from "./timeline/Timeline";
+export type { TimelineDescriptionProps, TimelineGapProps, TimelineGroupProps, TimelineItemMetaProps, TimelineItemProps, TimelineItemTitleProps, TimelineItemValueProps, TimelineRootProps, } from "./timeline/Timeline";
 export { Timeline } from "./timeline/Timeline";
 export type { TooltipAlign, TooltipContentProps, TooltipProviderProps, TooltipRootProps, TooltipSide, TooltipTriggerProps, } from "./tooltip/Tooltip";
 export { Tooltip } from "./tooltip/Tooltip";
@@ -154,5 +153,7 @@ export type { TypographyAs, TypographyProps, TypographyRole, TypographyTracking,
 export { Typography } from "./typography/Typography";
 export type { VideoNoteLabels, VideoNoteProps } from "./video-note/VideoNote";
 export { VideoNote } from "./video-note/VideoNote";
+export type { VisuallyHiddenProps } from "./visually-hidden/VisuallyHidden";
+export { VisuallyHidden } from "./visually-hidden/VisuallyHidden";
 export type { VoicePlayerLabels, VoicePlayerProps, VoicePlayerRate, } from "./voice-player/VoicePlayer";
 export { getWaveform, VoicePlayer } from "./voice-player/VoicePlayer";

package/dist/components/input/Input.d.ts

@@ -1,7 +1,7 @@
 import * as React from "react";
 import { type FieldActionButtonProps } from "../../internal/FieldAction";
 import { type FieldCommitHandler } from "../../internal/FieldCommit";
-import { type FieldRootDomProps } from "../../internal/FieldFrame";
+import { type FieldFocusRingProps, type FieldRootDomProps } from "../../internal/FieldFrame";
 import type { ControlSize } from "../../internal/states";
 import { type PasswordStrength } from "./passwordStrength";
 export type InputLabels = {
@@ -31,46 +31,67 @@ export type InputLabels = {
     strengthMedium: string;
     strengthHard: string;
 };
-export type InputRootProps = FieldRootDomProps & {
-    /** Tier. Default: the tier of the surrounding control (a form, a panel), else `m`. */
+export declare const INPUT_LABELS: InputLabels;
+export type InputRootProps = FieldRootDomProps & FieldFocusRingProps & {
+    /**
+     * Tier for height, padding, radius, text, label and hint. Without it the field takes the tier of its host (LoginForm, Popover, a panel with a size), else `m`. Also provided to nested controls via the control-size context.
+     */
     size?: ControlSize;
-    /** Invalid state: danger ring on the field and `aria-invalid` on the input. A non-empty `error` implies it. */
+    /**
+     * Danger inset ring on the field, `aria-invalid` on the input. A non-empty `error` implies it.
+     */
     invalid?: boolean;
     /**
-     * Draws the focus ring on `Input.Wrapper` (default). `false` hides only the visual ring — focus,
-     * keyboard and ARIA are unchanged, the error ring still shows. Turn it off only where focus is
-     * otherwise obvious (a single search field with a caret, e.g. a command palette); WCAG 2.4.7.
+     * Label above the field, rendered as `<label htmlFor>`. Without it, give `Input.Field` an `aria-label`.
      */
-    focusRing?: boolean;
     label?: React.ReactNode;
-    /** Shows a red `*` after the label and sets native `required` on `Input.Field`. */
+    /**
+     * Red `*` after the label (`aria-hidden`) and native `required` on `Input.Field`.
+     */
     required?: boolean;
-    /** Shows the muted optional marker after the label text (`labels.optional`). */
+    /**
+     * Muted marker right after the label text (`labels.optional`).
+     */
     optional?: boolean;
+    /**
+     * Help text under the field. Hidden while `error` is shown.
+     */
     hint?: React.ReactNode;
-    /** Error message; replaces the hint in the same slot and implies `invalid`. */
+    /**
+     * Error message in the hint slot; implies `invalid`.
+     */
     error?: React.ReactNode;
-    /** Right-aligned slot of the support row, e.g. `<Input.Counter current={n} max={50} />`. */
+    /**
+     * Right side of the support row, usually `<Input.Counter current max />`.
+     */
     counter?: React.ReactNode;
-    /** Always render the support row so an appearing error does not shift the layout. */
+    /**
+     * Always render the support row (min height = hint line height), so an appearing error does not shift the layout.
+     */
     reserveSupportRow?: boolean;
-    /** Explicit id for the underlying <input>; auto-generated if omitted. */
+    /**
+     * Id of the `<input>` (auto-generated when omitted); hint id is `<id>-hint`, error id is `<id>-error`.
+     */
     id?: string;
     /**
-     * A password strength meter under the field: four steps that fill as the value grows stronger,
-     * with the level word on the right of the support row. Use on new-password fields.
+     * A password strength meter for new-password fields: a stepped `ProgressBar` under the field and the level word (weak … hard) in the support row. Follows the value of `Input.Field`.
      */
     strength?: boolean;
-    /** Replaces the kit's estimate (`getPasswordStrength`): return 0 (empty) … 4 (hard). */
+    /**
+     * Replaces the kit's estimate of `strength`. Return 0 for empty, 1 weak … 4 hard. A hint for the person typing, not a security check.
+     */
     getStrength?: (value: string) => PasswordStrength;
     /**
-     * Saves the field on its own (inline editing): fires with the value on blur and Enter when it
-     * differs from the last committed one; Escape reverts to it. Return a Promise to show a spinner
-     * at the field's edge while it runs (the field stays editable, Tab moves on); a rejection puts
-     * the committed value back — show why through `error`. Success shows a brief check.
+     * Inline save: fires with a changed value on blur and Enter; Escape reverts. Return a Promise: the field shows a spinner and stays editable; a rejection restores the value — show why through `error`.
      */
     onCommit?: FieldCommitHandler;
+    /**
+     * Built-in strings, see Labels.
+     */
     labels?: Partial<InputLabels>;
+    /**
+     * Usually `Input.Wrapper`.
+     */
     children: React.ReactNode;
 };
 declare function InputRoot({ size: sizeProp, invalid, focusRing, label, required, optional, hint, error, counter, reserveSupportRow, id, strength, getStrength, onCommit, labels: labelsProp, children, className, ...rest }: InputRootProps): import("react/jsx-runtime").JSX.Element;
@@ -78,6 +99,9 @@ declare namespace InputRoot {
     var displayName: string;
 }
 export type InputWrapperProps = React.HTMLAttributes<HTMLDivElement> & {
+    /**
+     * `Field` and the slots: `Icon`, `Affix`, `InlineAffix`; the end segments `ClearButton`, `CopyButton`, `RevealButton`, `Action` in source order.
+     */
     children: React.ReactNode;
     ref?: React.Ref<HTMLDivElement>;
 };
@@ -86,7 +110,9 @@ declare namespace InputWrapper {
     var displayName: string;
 }
 export type InputFieldProps = Omit<React.InputHTMLAttributes<HTMLInputElement>, "size" | "id"> & {
-    /** Called with the new string value; native `onChange` still fires. */
+    /**
+     * Called with the new string; native `onChange` still fires first.
+     */
     onValueChange?: (value: string) => void;
     ref?: React.Ref<HTMLInputElement>;
 };
@@ -96,7 +122,13 @@ declare namespace InputField {
     var displayName: string;
 }
 export type InputIconProps = Omit<React.HTMLAttributes<HTMLSpanElement>, "children"> & {
+    /**
+     * Side of the value.
+     */
     side: "start" | "end";
+    /**
+     * An icon; kit icons without an explicit `size` take the field tier.
+     */
     children: React.ReactNode;
     ref?: React.Ref<HTMLSpanElement>;
 };
@@ -105,7 +137,13 @@ declare namespace InputIcon {
     var displayName: string;
 }
 export type InputAffixProps = Omit<React.HTMLAttributes<HTMLDivElement>, "children"> & {
+    /**
+     * Edge the section sits on.
+     */
     side: "start" | "end";
+    /**
+     * Static text: protocol, domain, country code.
+     */
     children: React.ReactNode;
     ref?: React.Ref<HTMLDivElement>;
 };
@@ -114,7 +152,13 @@ declare namespace InputAffix {
     var displayName: string;
 }
 export type InputInlineAffixProps = Omit<React.HTMLAttributes<HTMLSpanElement>, "children"> & {
+    /**
+     * Side of the value.
+     */
     side: "start" | "end";
+    /**
+     * Short unit: `₽`, `%`, `кг`.
+     */
     children: React.ReactNode;
     ref?: React.Ref<HTMLSpanElement>;
 };
@@ -127,9 +171,10 @@ export type InputClearButtonProps = Omit<React.ButtonHTMLAttributes<HTMLButtonEl
 };
 /**
  * Trailing clear action. Render it only when the field has a value; clicking returns focus
- * to the input after `onClick` runs (clear the value in `onClick`).
+ * to the input after `onClick` runs (clear the value in `onClick`). It rises in when it appears
+ * after the field and closes up in place when it goes (`partPresence`).
  */
-declare function InputClearButton({ onClick, ref, ...rest }: InputClearButtonProps): import("react/jsx-runtime").JSX.Element;
+declare function InputClearButton({ onClick, className, ref, ...rest }: InputClearButtonProps): import("react/jsx-runtime").JSX.Element;
 declare namespace InputClearButton {
     var displayName: string;
 }
@@ -143,7 +188,9 @@ declare namespace InputAction {
     var displayName: string;
 }
 export type InputCopyButtonProps = Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "type" | "children" | "aria-label"> & {
-    /** Text to copy; the field's current value when omitted. */
+    /**
+     * Text to copy instead of the field's current value.
+     */
     value?: string;
     ref?: React.Ref<HTMLButtonElement>;
 };
@@ -164,7 +211,13 @@ declare namespace InputRevealButton {
     var displayName: string;
 }
 export type InputCounterProps = Omit<React.HTMLAttributes<HTMLSpanElement>, "children"> & {
+    /**
+     * Current length.
+     */
     current: number;
+    /**
+     * Limit; `current > max` turns the counter danger (`data-invalid="true"`).
+     */
     max: number;
     ref?: React.Ref<HTMLSpanElement>;
 };