prime-ui-kit 0.15.0 → 0.17.0

package/dist/components/scroll-container/useScrollEdges.d.ts

@@ -1,29 +1,6 @@
 import * as React from "react";
+import type { ScrollRegion } from "../../hooks/useScrollRegion";
 export type ScrollEdgeHandler = () => void | Promise<void>;
-/**
- * What a ScrollContainer lets its content ask for (`useScrollRegion`): a chat list asks to go to
- * the end after its own message, to bring a message into view, and follows whether the reader is
- * at the end. The region scrolls only itself.
- */
-export type ScrollRegion = {
-    /** The reader is at the end (`anchor="end"`, within 4 px). */
-    atEnd: () => boolean;
-    /** Follows `atEnd`; returns the unsubscribe. */
-    subscribe: (listener: () => void) => () => void;
-    /** Scrolls to the end; `smooth` glides there (instant under reduced motion). */
-    scrollToEnd: (behavior?: ScrollBehavior) => void;
-    /** Scrolls the region (only) so `element` stands in its middle. */
-    scrollToElement: (element: Element, behavior?: ScrollBehavior) => void;
-    /**
-     * Content is about to change size in place (a message opens its transcript or its reactions
-     * row): for `ms`, what the reader sees stays still — even at the end of `anchor="end"`, so the
-     * change grows past the edge instead of pushing everything up. Call it right before the change.
-     */
-    hold: (ms: number) => void;
-};
-export declare const ScrollRegionContext: React.Context<ScrollRegion | null>;
-/** The ScrollContainer around this component, or `null` outside one. */
-export declare function useScrollRegion(): ScrollRegion | null;
 type Options = {
     anchor: "start" | "end";
     horizontal: boolean;

package/dist/components/segmented-control/SegmentedControl.d.ts

@@ -5,25 +5,51 @@ export type SegmentedControlLabels = {
     /** Muted marker after the label when `optional`. */
     optional: string;
 };
-export type SegmentedControlRootProps = Omit<FieldRootDomProps, "dir"> & Omit<FieldFrameProps, "focusRing"> & {
+export declare const SEGMENTED_CONTROL_LABELS: SegmentedControlLabels;
+export type SegmentedControlRootProps = Omit<FieldRootDomProps, "dir"> & FieldFrameProps & {
+    /**
+     * Selected value (controlled).
+     */
     value?: string;
+    /**
+     * Initial value (uncontrolled); `""` — nothing selected.
+     */
     defaultValue?: string;
+    /**
+     * Called with the new value on click or arrow keys.
+     */
     onValueChange?: (value: string) => void;
+    /**
+     * Disables the whole group.
+     */
     disabled?: boolean;
+    /**
+     * Control tier; the outer height equals the control height 28 · 32 · 36 · 40 · 48. Without it the tier of its host (a toolbar, a panel with a size), else `m`.
+     */
     size?: ControlSize;
     /**
-     * Stretch to the container width. Single-line segments tend to equal widths but never get
-     * narrower than their label; when they do not fit, the row scrolls.
+     * Fills the container; single-line segments tend to equal widths but never get narrower than their label — when they do not fit, the row scrolls.
      */
     fullWidth?: boolean;
-    /** Invalid state: a danger ring on the track and `aria-invalid` on the radiogroup. */
+    /**
+     * Danger inset ring, `aria-invalid` and `data-invalid` on the `radiogroup`; the control shakes once when an error arrives.
+     */
     invalid?: boolean;
-    /** Always render the support row so an appearing error does not shift the layout. */
+    /**
+     * Always render the support row, so an appearing error does not shift the layout.
+     */
     reserveSupportRow?: boolean;
-    /** Id of the `role="radiogroup"` element; generated when omitted. */
+    /**
+     * Id of the `radiogroup` element (generated when omitted); hint id is `<id>-hint`, error id `<id>-error`.
+     */
     id?: string;
+    /**
+     * Built-in strings, see Labels.
+     */
     labels?: Partial<SegmentedControlLabels>;
-    /** `SegmentedControl.Item` segments. */
+    /**
+     * `SegmentedControl.Item`s (may be wrapped, e.g. in `Tooltip.Trigger`).
+     */
     children?: React.ReactNode;
 };
 /**
@@ -35,19 +61,25 @@ declare namespace SegmentedControlRoot {
     var displayName: string;
 }
 export type SegmentedControlItemProps = Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "value" | "children" | "type" | "role"> & {
+    /**
+     * Option value compared with the root value.
+     */
     value: string;
+    /**
+     * Disables this option; arrow keys skip it.
+     */
     disabled?: boolean;
     /**
-     * Palette hue of the option (e.g. a status): a dot of that hue before the content, and while
-     * selected the sliding thumb takes a soft fill of the hue with a ring of it.
+     * Palette hue: a dot before the content; while selected the thumb takes a soft fill of the hue with a ring of it.
      */
     color?: PaletteColor;
     /**
-     * Text, `SegmentedControl.Icon`, `SegmentedControl.Label`, `SegmentedControl.Count`,
-     * `SegmentedControl.Description`. A description makes the segment two-line. Only an icon makes the
-     * segment square: give it `aria-label` (and wrap it in a Tooltip).
+     * Text, `Icon`, `Label`, `Count`, `Description`. Only an icon → square segment; give it `aria-label`.
      */
     children: React.ReactNode;
+    /**
+     * Class on the segment button.
+     */
     className?: string;
     ref?: React.Ref<HTMLButtonElement>;
 };
@@ -56,7 +88,13 @@ declare namespace SegmentedControlItem {
     var displayName: string;
 }
 export type SegmentedControlIconProps = {
+    /**
+     * The icon, e.g. `<Icon name="theme.light" />`.
+     */
     children: React.ReactNode;
+    /**
+     * Class on the icon box.
+     */
     className?: string;
     ref?: React.Ref<HTMLSpanElement>;
 } & Omit<React.HTMLAttributes<HTMLSpanElement>, "children">;
@@ -65,18 +103,33 @@ declare namespace SegmentedControlIcon {
     var displayName: string;
 }
 export type SegmentedControlLabelProps = {
+    /**
+     * Title text.
+     */
     children: React.ReactNode;
+    /**
+     * Class on the label.
+     */
     className?: string;
     ref?: React.Ref<HTMLSpanElement>;
 } & Omit<React.HTMLAttributes<HTMLSpanElement>, "children">;
-/** Segment title on one line; never truncated. Plain text children are wrapped automatically. */
+/**
+ * Segment title on one line; never truncated. Plain text children are wrapped automatically. In a
+ * row collapsed to icons the visible title leaves the row and a VisuallyHidden copy keeps naming
+ * the segment.
+ */
 declare function SegmentedControlLabel({ children, className, ...rest }: SegmentedControlLabelProps): import("react/jsx-runtime").JSX.Element;
 declare namespace SegmentedControlLabel {
     var displayName: string;
 }
 export type SegmentedControlDescriptionProps = {
-    /** Muted second line; wrap the key value in `<strong>` to emphasize it. */
+    /**
+     * Second-line text; wrap a key value in `<strong>`.
+     */
     children: React.ReactNode;
+    /**
+     * Class on the description.
+     */
     className?: string;
     ref?: React.Ref<HTMLSpanElement>;
 } & Omit<React.HTMLAttributes<HTMLSpanElement>, "children">;
@@ -86,8 +139,13 @@ declare namespace SegmentedControlDescription {
     var displayName: string;
 }
 export type SegmentedControlCountProps = Omit<React.HTMLAttributes<HTMLSpanElement>, "children" | "color"> & {
-    /** Badge hue. Default `gray`. */
+    /**
+     * Badge hue.
+     */
     color?: PaletteColor;
+    /**
+     * The number.
+     */
     children: React.ReactNode;
     ref?: React.Ref<HTMLSpanElement>;
 };

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

@@ -1,77 +1,152 @@
 import * as React from "react";
-import { type FieldFrameProps, type FieldRootDomProps } from "../../internal/FieldFrame";
+import { type FieldFocusRingProps, type FieldFrameProps, type FieldRootDomProps } from "../../internal/FieldFrame";
 import { type MenuGroupProps } from "../../internal/MenuGroup";
 import type { ControlSize } from "../../internal/states";
 import { SelectAction, SelectItem, SelectItemDescription, SelectItemIcon, SelectItemMeta, SelectItemText } from "./SelectItem";
 import { type SelectLabels } from "./selectContext";
 export type { SelectActionProps, SelectItemDescriptionProps, SelectItemIconProps, SelectItemMetaProps, SelectItemProps, SelectItemTextProps, } from "./SelectItem";
 export type { SelectLabels } from "./selectContext";
-type SelectRootBase = FieldRootDomProps & FieldFrameProps & {
+export declare const SELECT_LABELS: SelectLabels;
+type SelectRootBase = FieldRootDomProps & FieldFrameProps & FieldFocusRingProps & {
+    /**
+     * Field tier: trigger height, padding, text; the list rows, the label and the hint follow it. Without it the tier of its host (a form, a panel with a size), else `m`.
+     */
     size?: ControlSize;
+    /**
+     * Disabled field; the list never opens.
+     */
     disabled?: boolean;
+    /**
+     * Text in the trigger while nothing is picked.
+     */
     placeholder?: string;
-    /** Danger ring and `aria-invalid`; a non-empty `error` implies it. */
+    /**
+     * Danger inset ring and `aria-invalid`.
+     */
     invalid?: boolean;
-    /** Id of the trigger; generated when omitted. */
+    /**
+     * Id of the trigger; generated when omitted.
+     */
     id?: string;
+    /**
+     * Controlled open state of the list.
+     */
     open?: boolean;
+    /**
+     * Initial open state, uncontrolled.
+     */
     defaultOpen?: boolean;
+    /**
+     * Called on every open and close: trigger, pick, Escape, an outside press.
+     */
     onOpenChange?: (open: boolean) => void;
-    /** Clear segment in the trigger (and `Delete` / `Backspace` on it) while a value is selected. */
+    /**
+     * Escape closes the list and returns focus to the trigger.
+     */
+    closeOnEscape?: boolean;
+    /**
+     * A press outside the list and its trigger closes it; focus follows the pointer.
+     */
+    closeOnOutsideClick?: boolean;
+    /**
+     * A clear segment before the chevron while a value is set; `Delete` / `Backspace` on the trigger clear too.
+     */
     clearable?: boolean;
-    /** Form field name: hidden inputs submit the value (one per value with `multiple`). */
+    /**
+     * Form field name: hidden inputs submit the value (`""` while empty; one input per value with `multiple`).
+     */
     name?: string;
-    /** The search query (`Select.Content searchable`), controlled; cleared when the list closes. */
+    /**
+     * Controlled search query (`Select.Content searchable`); together with `onSearchChange`. Cleared when the list closes.
+     */
     search?: string;
-    /** The initial query, uncontrolled. Default `""`. */
+    /**
+     * Initial query, uncontrolled.
+     */
     defaultSearch?: string;
-    /** Called with the new query: typing, and `""` when the list closes. */
+    /**
+     * Called with the new query: typing, and `""` when the list closes. Load the matching options here for a server search.
+     */
     onSearchChange?: (search: string) => void;
     /**
-     * The list filters its items by the query. `false` when the results come from a server: every
-     * item shows, highlighting of the query stays.
+     * The list filters its items by the query. `false` when the options come from a server: every item shows, the query is still marked in the labels.
      */
     filter?: boolean;
     /**
-     * Options are loading: a Spinner instead of the chevron, `aria-busy`, skeleton rows in the list
-     * while no item matches (items on screen stay).
+     * Options are loading: a Spinner instead of the chevron, `aria-busy`, skeleton rows in the list while no item matches; items already on screen stay.
      */
     loading?: boolean;
-    /** More options are loading at the end: skeleton rows after the items. */
+    /**
+     * More options are loading at the end: skeleton rows after the items.
+     */
     loadingMore?: boolean;
-    /** More options exist: reaching the end of the list calls `onLoadMore`. */
+    /**
+     * More options exist: reaching the end of the list calls `onLoadMore`.
+     */
     hasMore?: boolean;
-    /** Asked once per round when the end of the list scrolls into view or the highlight reaches it. */
+    /**
+     * Called once per round with `hasMore` when the end of the list scrolls into view or the highlight reaches the last option; set `loadingMore` while it runs.
+     */
     onLoadMore?: () => void | Promise<void>;
-    /** The options failed to load: replaces the list with the message in `role="alert"`. */
+    /**
+     * The options failed to load: the message replaces the list in `role="alert"`. Not the field `error` (validation).
+     */
     loadError?: React.ReactNode;
-    /** A retry button (`labels.retry`) under `loadError`; Enter in the open list runs it too. */
+    /**
+     * A retry button (`labels.retry`) under `loadError`; Enter in the open list runs it too.
+     */
     onRetry?: () => void;
+    /**
+     * Built-in strings, see Labels.
+     */
     labels?: Partial<SelectLabels>;
+    /**
+     * Class on the field frame `<div>`.
+     */
     className?: string;
+    /**
+     * Trigger and Content.
+     */
     children: React.ReactNode;
 };
 type SelectSingleProps = {
+    /**
+     * Several values: checkboxes in the list, the list stays open on a pick, labels joined in the trigger.
+     */
     multiple?: false;
+    /**
+     * Controlled value; `string[]` with `multiple`.
+     */
     value?: string;
+    /**
+     * Initial value, uncontrolled.
+     */
     defaultValue?: string;
     /**
-     * Picked value; `""` after clearing. Return the save's promise: the value shows at once with a
-     * Spinner on the trigger and picks wait; resolve keeps it, reject rolls it back and announces
-     * `labels.changeFailed`.
+     * The picked value (`""` after clearing) or, with `multiple`, the new list. A promise: the value shows at once with a trigger Spinner, picks wait; reject rolls back and announces `labels.changeFailed`.
      */
     onValueChange?: (value: string) => void | Promise<void>;
 };
 type SelectMultipleProps = {
-    /** `string[]` value, checkboxes in the list, the list stays open on a pick. */
+    /**
+     * Several values: checkboxes in the list, the list stays open on a pick, labels joined in the trigger.
+     */
     multiple: true;
+    /**
+     * Controlled value; `string[]` with `multiple`.
+     */
     value?: string[];
+    /**
+     * Initial value, uncontrolled.
+     */
     defaultValue?: string[];
-    /** The new list; a promise as in single mode. */
+    /**
+     * The picked value (`""` after clearing) or, with `multiple`, the new list. A promise: the value shows at once with a trigger Spinner, picks wait; reject rolls back and announces `labels.changeFailed`.
+     */
     onValueChange?: (value: string[]) => void | Promise<void>;
 };
 export type SelectRootProps = SelectRootBase & (SelectSingleProps | SelectMultipleProps);
-declare function SelectRoot(props: SelectRootProps): import("react/jsx-runtime").JSX.Element;
+declare function SelectRoot(props: SelectRootProps): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>;
 declare namespace SelectRoot {
     var displayName: string;
 }
@@ -89,10 +164,7 @@ export type SelectValueItem = {
 };
 export type SelectValueProps = Omit<React.HTMLAttributes<HTMLSpanElement>, "children"> & {
     /**
-     * Single mode: renders the selected option in the trigger with the same parts as the row —
-     * leading `Avatar.Root` / `Thumbnail.Root`, `Select.ItemText`, `Select.ItemDescription`, and a
-     * trailing `Badge.Root` / `Select.ItemMeta` at the end. Not called while empty (the placeholder
-     * shows) and not used in `multiple` mode.
+     * Single mode: draws the picked option in the trigger with the same parts as the row (Avatar, ItemText, Badge…); not called while empty.
      */
     renderValue?: (item: SelectValueItem) => React.ReactNode;
     ref?: React.Ref<HTMLSpanElement>;
@@ -112,10 +184,12 @@ declare namespace SelectTriggerIcon {
 }
 export type SelectContentProps = Omit<React.HTMLAttributes<HTMLDivElement>, "children" | "hidden" | "onKeyDown" | "onAnimationEnd"> & {
     /**
-     * A search field on top of the list; items filter by label, description and `keywords` (or the
-     * owner loads them: `Select.Root` `search`, `filter={false}`).
+     * A search field on top; items filter by label, description and `keywords` — or the owner loads them by the query (`search`, `filter={false}` on Root).
      */
     searchable?: boolean;
+    /**
+     * Items, groups, separators; `Select.Action` children stand under the list.
+     */
     children: React.ReactNode;
     /** The floating panel. */
     ref?: React.Ref<HTMLDivElement>;

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