prime-ui-kit 0.15.0 → 0.16.0

package/dist/components/media-viewer/MediaViewer.d.ts

@@ -1,45 +1,73 @@
 import * as React from "react";
 import type { MediaViewerItem, MediaViewerLabels } from "./types";
 export type { MediaViewerItem, MediaViewerLabels } from "./types";
+export declare const MEDIA_VIEWER_LABELS: MediaViewerLabels;
+/** The viewer's props; each is described in `api.ts`. `ref` is the `role="dialog"` element. */
 export type MediaViewerProps = Omit<React.HTMLAttributes<HTMLDivElement>, "children"> & {
-    /** The photos and videos to page through, in order. */
+    /**
+     * `{ type?: "image" | "video", src, thumbnail?, poster?, alt?, caption?, width?, height? }`: `thumbnail` stands in while `src` loads, `width` / `height` give the picture its box before load.
+     */
     items: readonly MediaViewerItem[];
-    /** Controlled visibility; together with `onOpenChange`. */
+    /**
+     * Controlled visibility; together with `onOpenChange`.
+     */
     open?: boolean;
-    /** Initial visibility, uncontrolled. Default `false`. */
+    /**
+     * Initial visibility, uncontrolled.
+     */
     defaultOpen?: boolean;
-    /** Called on every open and close: the close button, Escape, a swipe, a click past the media. */
+    /**
+     * Called on every open and close: the close button, Escape, a swipe, a click on the stage past the media.
+     */
     onOpenChange?: (open: boolean) => void;
-    /** The item on screen (controlled); together with `onIndexChange`. */
+    /**
+     * The item on screen (controlled); together with `onIndexChange`.
+     */
     index?: number;
-    /** The item shown first, uncontrolled. Default `0`. */
+    /**
+     * The item shown first, uncontrolled.
+     */
     defaultIndex?: number;
-    /** The page turned: a swipe, an arrow, a key, a thumbnail. */
+    /**
+     * The page turned: a swipe, an arrow, a key, a thumbnail of the filmstrip. Fires once the page has settled, also after a slide to a far item.
+     */
     onIndexChange?: (index: number) => void;
-    /** Past the last item comes the first (with three items or more). Default `false`. */
+    /**
+     * Past the last item comes the first, and back (with three items or more).
+     */
     loop?: boolean;
-    /** How far a picture zooms, times its fitted size. Default `4`. */
+    /**
+     * How far a picture zooms, times its fitted size.
+     */
     maxZoom?: number;
-    /** A filmstrip of every item at the bottom. Default `false`. */
+    /**
+     * A filmstrip of every item along the bottom: it follows the page; after a scroll by the person it stays where it was left until the page turns, then glides back. A press slides to that item.
+     */
     thumbnails?: boolean;
     /**
-     * A video starts as soon as its page settles on screen; where the browser refuses sound, it
-     * starts muted. `false` — it waits for a press. Default `true`.
+     * A video starts once its page settles, muted where the browser refuses sound without a press. `false` — it waits for a press on its play disk.
      */
     autoPlay?: boolean;
-    /** Escape closes the viewer. Default `true`. */
+    /**
+     * Escape closes the viewer.
+     */
     closeOnEscape?: boolean;
-    /** A vertical swipe, or a click on the stage past the media, closes the viewer. Default `true`. */
+    /**
+     * A vertical swipe, or a mouse click on the stage past the media, closes the viewer.
+     */
     closeOnOutsideClick?: boolean;
     /**
-     * The element item `index` opens from and closes into (its thumbnail). Without it the viewer
-     * finds the picture in the element that opened it; with neither, it fades.
+     * The element item `index` opens from and closes into (its thumbnail). Without it the viewer finds the picture showing the item's `thumbnail`, `src` or `poster`; with none on screen, it fades.
      */
     getOrigin?: (index: number) => Element | null;
-    /** Actions for the item on screen, in the top bar before the close button. */
+    /**
+     * Actions for the item on screen in the top bar, before the zoom and close buttons: `Button shape="circle" variant="shade"`, a ⋯ Dropdown.
+     */
     renderActions?: (item: MediaViewerItem, index: number) => React.ReactNode;
+    /**
+     * Built-in strings, see Labels.
+     */
     labels?: Partial<MediaViewerLabels>;
-    /** The `role="dialog"` element. */
     ref?: React.Ref<HTMLDivElement>;
 };
 /**

package/dist/components/media-viewer/physics.d.ts

@@ -31,8 +31,6 @@ export declare function stepSpring(state: SpringState, target: number, dt: numbe
 export declare function springSettled(state: SpringState, target: number, epsilon?: number): boolean;
 /** Velocity left after `dt` ms of momentum. */
 export declare function decayVelocity(velocity: number, dt: number): number;
-/** Where momentum from `velocity` comes to rest, measured from where it starts. */
-export declare function projectMomentum(velocity: number): number;
 /**
  * Distance shown for `overshoot` px dragged past an edge of a `dimension`-long viewport: the iOS
  * curve, 1 : 1 at first, ever stiffer, never past the dimension.

package/dist/components/media-viewer/viewerEngine.d.ts

@@ -114,7 +114,6 @@ export declare class ViewerEngine {
     syncIndex(index: number): void;
     /** The stage resized: the zoom keeps its scale but stays inside the new limits. */
     setArea(area: Size): void;
-    get isZoomed(): boolean;
     /** Paints the current state: after React mounted or moved a slide. */
     paint: () => void;
     /** The page on screen as a fractional index: the track's offset read in pages. */

package/dist/components/message/Message.d.ts

@@ -1,4 +1,5 @@
 import * as React from "react";
+import { type AsyncHandler } from "../../internal/usePendingChanges";
 import { MessageContact, MessageLinkPreview, MessageLocation } from "./MessageCards";
 import { MessageFile } from "./MessageFile";
 import { MessageMedia } from "./MessageMedia";
@@ -19,7 +20,6 @@ export type MessageStatus = "sending" | "sent" | "read" | "failed";
  * - `round` — a video message: a circle, no backing, the meta on a pill over it, reactions under it.
  */
 export type MessageShell = "bubble" | "media" | "round";
-type AsyncEvent<T> = (value: T) => void | Promise<unknown>;
 export type MessageActionsProps = React.HTMLAttributes<HTMLDivElement> & {
     ref?: React.Ref<HTMLDivElement>;
 };
@@ -33,34 +33,45 @@ declare namespace MessageActions {
     var displayName: string;
 }
 export type MessageRootProps = Omit<React.HTMLAttributes<HTMLElement>, "role"> & {
-    /** The id of the message: selection, `onNewMessage`, `onRead`, `current`, `Message.Reply target`. */
+    /**
+     * The message id for selection, jumps, read receipts, search, pins and `Message.Reply target` (`Chat.Messages items` sets the item's key). Keep it when the server confirms a sent message.
+     */
     value?: string;
-    /** `incoming` on the start side on a surface fill, `outgoing` on the end side in the accent hue. */
+    /**
+     * `incoming` — on the start side, a surface one step off the chat; `outgoing` — on the end side, in the accent hue (`--prime-color-message-outgoing-*`), everything inside recolors with it.
+     */
     direction?: MessageDirection;
     /**
-     * The place in a run of one author's messages (`Chat.Messages items` sets it): sets the small gap inside a
-     * run and the tail on its last bubble. Default `single`.
+     * The place in a run of one author (`Chat.Messages items` sets it): `single` and `last` end a run with the tail (and a group chat's avatar); `single` and `first` show the author's header.
      */
     position?: MessagePosition;
-    /** When it was sent: a `Date` (shown with `formatTime`) or the text to show. */
+    /**
+     * When it was sent: a `Date` shown with `formatTime` (and put in `<time dateTime>`), or the text to show.
+     */
     time?: Date | string;
-    /** Display of a `Date` time. Default «09:05». */
+    /**
+     * Display of a `Date` time.
+     */
     formatTime?: (date: Date) => string;
-    /** The text was edited: «изменено» before the time. */
+    /**
+     * The text was edited: `labels.edited` before the time.
+     */
     edited?: boolean;
-    /** Delivery of an outgoing message: clock → ✓ → ✓✓, or failed with a retry. */
+    /**
+     * Delivery of an outgoing message: a clock, one check, two checks (accent), or a danger mark; the glyphs cross-fade from one state to the next. Named for assistive tech by `labels`.
+     */
     status?: MessageStatus;
     /**
-     * Sends a failed message again (the retry button beside it). A returned promise shows `sending`
-     * until it settles; a rejection leaves it failed.
+     * Sends a failed message again: a ghost danger button beside the bubble. A returned promise shows `sending` until it settles; a rejection leaves it failed.
+     */
+    onRetry?: AsyncHandler;
+    /**
+     * Puts or takes back the reader's reaction (a chip, a double tap, `L`, the reaction bar). Shown at once; a returned promise keeps it pending, a rejection drops it back. Without it reactions are read-only.
      */
-    onRetry?: () => void | Promise<void>;
+    onReactionToggle?: AsyncHandler<[emoji: string], unknown>;
     /**
-     * The reader puts or takes back a reaction: a chip of `Message.Reactions`, a double tap (the
-     * chat's quick reaction), `L`, or the reaction bar. A returned promise keeps the chip pending until it
-     * settles; update the reactions when it resolves. Without it reactions are read-only.
+     * Built-in strings, see Labels.
      */
-    onReactionToggle?: AsyncEvent<string>;
     labels?: Partial<MessageLabels>;
     ref?: React.Ref<HTMLElement>;
 };

package/dist/components/message/MessageCards.d.ts

@@ -6,17 +6,31 @@ export type MessageLocationLabels = {
     /** The mark of a live location. */
     live: string;
 };
+export declare const MESSAGE_LOCATION_LABELS: MessageLocationLabels;
 export type MessageLocationProps = Omit<React.HTMLAttributes<HTMLDivElement>, "children"> & {
-    /** A map picture of the place (your static map service: the kit ships no map). */
+    /**
+     * A map picture of the place from your map service (the kit ships no map).
+     */
     src: string;
-    /** Opens the place in a map (a new tab). */
+    /**
+     * Opens the place in a map, in a new tab.
+     */
     href?: string;
-    /** The place («Склад на Складочной»). */
+    /**
+     * The place.
+     */
     title?: string;
-    /** Its address. */
+    /**
+     * Its address.
+     */
     address?: string;
-    /** A location shared live: a pulsing pin and a «Трансляция» mark. */
+    /**
+     * A location shared live (still under reduced motion).
+     */
     live?: boolean;
+    /**
+     * Built-in strings, see Labels.
+     */
     labels?: Partial<MessageLocationLabels>;
     ref?: React.Ref<HTMLDivElement>;
 };
@@ -29,13 +43,25 @@ export declare namespace MessageLocation {
     var displayName: string;
 }
 export type MessageContactProps = Omit<React.HTMLAttributes<HTMLDivElement>, "color"> & {
+    /**
+     * The person.
+     */
     name: string;
+    /**
+     * The phone, as written.
+     */
     phone?: string;
-    /** The person's photo; without it the initials. */
+    /**
+     * The person's photo; without it the initials.
+     */
     src?: string;
-    /** Hue of the initials. Default `blue`. */
+    /**
+     * Hue of the initials.
+     */
     color?: PaletteColor;
-    /** Actions under the card: `Button.Root`s («Написать», «Добавить»). */
+    /**
+     * `Button.Root` actions in a row under the person («Написать», «Добавить»).
+     */
     children?: React.ReactNode;
     ref?: React.Ref<HTMLDivElement>;
 };
@@ -45,12 +71,25 @@ export declare namespace MessageContact {
     var displayName: string;
 }
 export type MessageLinkPreviewProps = Omit<React.HTMLAttributes<HTMLElement>, "title"> & {
+    /**
+     * The page.
+     */
     href: string;
-    /** The site's name, in the accent color. */
+    /**
+     * The site's name, in the accent color.
+     */
     site?: string;
+    /**
+     * The page title.
+     */
     title?: string;
+    /**
+     * Its description, up to three lines.
+     */
     description?: string;
-    /** The page's picture, full width under the text (16 : 9, its box final before it loads). */
+    /**
+     * The page's picture, full width under the text.
+     */
     image?: string;
     ref?: React.Ref<HTMLAnchorElement>;
 };

package/dist/components/message/MessageFile.d.ts

@@ -8,17 +8,31 @@ export type MessageFileLabels = {
     /** The line under the name while it transfers: `{done}`, `{total}`. */
     transferred: string;
 } & TransferLabels;
+export declare const MESSAGE_FILE_LABELS: MessageFileLabels;
 export type MessageFileProps = Omit<React.HTMLAttributes<HTMLDivElement>, "children"> & TransferProps & {
-    /** The file name, with its extension (the format tile reads it). */
+    /**
+     * The file name with its extension (the format tile reads it).
+     */
     name: string;
-    /** Bytes; shown as «1,2 МБ». */
+    /**
+     * Bytes, shown as «1,2 МБ».
+     */
     fileSize?: number;
-    /** Display of `fileSize`. Default Russian digits with Б · КБ · МБ · ГБ. */
+    /**
+     * Display of `fileSize`.
+     */
     formatSize?: (bytes: number) => string;
-    /** Where to get it: the tile becomes the download button. */
+    /**
+     * Where to get it: the tile becomes the download link «Скачать {name}».
+     */
     href?: string;
-    /** A picture of the file (an image, the first page) in the tile instead of the format. */
+    /**
+     * A picture of the file (an image, the first page) in the tile in place of the format.
+     */
     preview?: string;
+    /**
+     * Built-in strings, see Labels.
+     */
     labels?: Partial<MessageFileLabels>;
     ref?: React.Ref<HTMLDivElement>;
 };

package/dist/components/message/MessageParts.d.ts

@@ -17,8 +17,6 @@ export type MessageLabels = {
     failed: string;
     /** The retry button beside a failed message. */
     retry: string;
-    /** The name of the context menu. */
-    menu: string;
     /** The menu item that starts selection mode with this message. */
     select: string;
     /** Announced when the quick reaction is put: `{emoji}`. */
@@ -52,7 +50,7 @@ export type MessageAvatarProps = React.HTMLAttributes<HTMLDivElement> & {
 };
 /**
  * The author's picture in the gutter beside an incoming bubble of a group chat (`Chat.Messages
- * type="group"`): put an `Avatar` in it on every message; the message shows it on the last of a
+ * group`): put an `Avatar` in it on every message; the message shows it on the last of a
  * run and keeps the gutter empty on the others.
  */
 export declare function MessageAvatar({ className, ...rest }: MessageAvatarProps): import("react/jsx-runtime").JSX.Element;
@@ -61,11 +59,12 @@ export declare namespace MessageAvatar {
 }
 export type MessageAuthorProps = Omit<React.HTMLAttributes<HTMLDivElement>, "color"> & {
     /**
-     * The author's hue: one per person in a group chat. Default: a hue stable per name
-     * (`hueOf(name)`); pass `hueOf(user.id)` to keep it per person.
+     * The author's hue: one per person in a chat. By default a hue stable per name (`"blue"` when the name is not plain text); pass `hueOf(user.id)` to keep it per person.
      */
     color?: PaletteColor;
-    /** The member's own title in this chat, muted after the name («Админ», «Бухгалтерия»). */
+    /**
+     * The member's own title in this chat, muted after the name («Админ», «Бухгалтерия»).
+     */
     tag?: React.ReactNode;
     ref?: React.Ref<HTMLDivElement>;
 };
@@ -93,11 +92,12 @@ export declare namespace MessageAuthorIcon {
 }
 export type MessageTextProps = Omit<React.HTMLAttributes<HTMLDivElement>, "children"> & {
     /**
-     * The text. A string renders its Markdown subset (**bold**, _italic_, ~~strike~~, `code`,
-     * ``` blocks, [links](url), bare URLs, `> ` quotes) as elements, never as HTML.
+     * The text: a string renders its Markdown subset.
      */
     children: React.ReactNode;
-    /** Render a string as is, without its Markdown. Default `false`. */
+    /**
+     * Render a string as is, without its Markdown.
+     */
     plain?: boolean;
     ref?: React.Ref<HTMLDivElement>;
 };
@@ -113,21 +113,27 @@ export type MessageReplyLabels = {
     /** Read before the quote: what it is. */
     reply: string;
 };
+export declare const MESSAGE_REPLY_LABELS: MessageReplyLabels;
 export type MessageReplyProps = Omit<React.HTMLAttributes<HTMLElement>, "color" | "onClick"> & {
-    /** Who wrote the quoted message. */
+    /**
+     * Who wrote the quoted message.
+     */
     author: React.ReactNode;
-    /** The author's hue (the same as their `Message.Author`). Default `blue`. */
+    /**
+     * The author's hue (the same as their `Message.Author`).
+     */
     color?: PaletteColor;
     /**
-     * The `value` of the quoted message: a press brings it into view in the group and flashes it,
-     * moving the focus to it. Makes the quote a button.
+     * The `value` of the quoted message: a press brings the chat to it (rendering it first in a window), the message blinks, and the focus moves to it. Makes the quote a button.
      */
     target?: string;
     /**
-     * A press on the quote (after `target` is shown): load the original when it is not in the list
-     * yet. Makes the quote a button.
+     * A press on the quote, after `target` is shown: load the original when it is not in the list yet. Makes the quote a button.
      */
     onClick?: (event: React.MouseEvent<HTMLButtonElement>) => void;
+    /**
+     * `reply` — the hidden prefix read before the quote.
+     */
     labels?: Partial<MessageReplyLabels>;
     ref?: React.Ref<HTMLElement>;
 };
@@ -140,9 +146,15 @@ export type MessageForwardedLabels = {
     /** The header of a forwarded message; `{author}` is the original author. */
     forwarded: string;
 };
+export declare const MESSAGE_FORWARDED_LABELS: MessageForwardedLabels;
 export type MessageForwardedProps = Omit<React.HTMLAttributes<HTMLDivElement>, "children"> & {
-    /** Who wrote the original message. */
+    /**
+     * Who wrote the original.
+     */
     from: string;
+    /**
+     * `forwarded` — the header template with `{author}`.
+     */
     labels?: Partial<MessageForwardedLabels>;
     ref?: React.Ref<HTMLDivElement>;
 };
@@ -179,9 +191,23 @@ export type MessageReactionsLabels = {
     /** The name of the row. */
     reactions: string;
 };
+export declare const MESSAGE_REACTIONS_LABELS: MessageReactionsLabels;
 export type MessageReactionsProps = Omit<React.HTMLAttributes<HTMLDivElement>, "children"> & {
-    /** The reactions to the message; a press on a chip calls `Message.Root onReactionToggle`. */
+    /**
+     * `{ emoji, count, selected?, users? }` — `count` is the total, `selected` the reader's own reaction, `users` (`{ id, name, src?, color? }[]`, in the order they put it) who put it; without `users` the chip shows the count.
+     */
     items: readonly MessageReaction[];
+    /**
+     * A press outside closes the message's reaction bar.
+     */
+    closeOnOutsideClick?: boolean;
+    /**
+     * Escape closes the message's reaction bar.
+     */
+    closeOnEscape?: boolean;
+    /**
+     * Built-in strings, see Labels.
+     */
     labels?: Partial<MessageReactionsLabels>;
     ref?: React.Ref<HTMLDivElement>;
 };
@@ -191,7 +217,7 @@ export type MessageReactionsProps = Omit<React.HTMLAttributes<HTMLDivElement>, "
  * goes to `Message.Root onReactionToggle`. Every message holds the row's place, closed: the first
  * reaction opens it and the last one taken back closes it, each in one layout.
  */
-export declare function MessageReactions({ items, labels: labelsProp, className, ...rest }: MessageReactionsProps): import("react/jsx-runtime").JSX.Element;
+export declare function MessageReactions({ items, closeOnOutsideClick: _closeOnOutsideClick, closeOnEscape: _closeOnEscape, labels: labelsProp, className, ...rest }: MessageReactionsProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace MessageReactions {
     var displayName: string;
 }

package/dist/components/message/MessageReactionBar.d.ts

@@ -21,6 +21,8 @@ type ReactionBarProps = {
     onPick: (emoji: string) => void;
     /** Opened from the keyboard: focus moves to the first reaction. */
     focusOnOpen: boolean;
+    closeOnOutsideClick: boolean;
+    closeOnEscape: boolean;
     labels: ReactionBarLabels;
     onPointerEnter?: () => void;
     onPointerLeave?: () => void;
@@ -31,5 +33,5 @@ type ReactionBarProps = {
  * emoji arrive in a quick stagger, Escape and a press outside close it. A toolbar of toggle
  * buttons named by the reactions; arrows move between them.
  */
-export declare function ReactionBar({ open, onOpenChange, anchorRef, align, options, selected, onPick, focusOnOpen, labels, onPointerEnter, onPointerLeave, }: ReactionBarProps): import("react/jsx-runtime").JSX.Element;
+export declare function ReactionBar({ open, onOpenChange, anchorRef, align, options, selected, onPick, focusOnOpen, closeOnOutsideClick, closeOnEscape, labels, onPointerEnter, onPointerLeave, }: ReactionBarProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/message/MessageTyping.d.ts

@@ -3,15 +3,19 @@ export type MessageTypingLabels = {
     /** Read while the other side types. */
     typing: string;
 };
+export declare const MESSAGE_TYPING_LABELS: MessageTypingLabels;
 export type MessageTypingProps = Omit<React.HTMLAttributes<HTMLDivElement>, "children"> & {
     /**
-     * The other side is typing. Keep the part mounted and switch this: it enters like an incoming
-     * message and leaves closing its height — or at once, when the reply arrives in the same update.
-     * Default `true`.
+     * The bubble is open: the other side is typing. Keep the part mounted and switch this, so it folds open and closed.
+     */
+    open?: boolean;
+    /**
+     * `Message.Avatar` of who types, in a group chat (`Chat.Messages group`).
      */
-    active?: boolean;
-    /** `Message.Avatar` of who types, for a group chat (`Chat.Messages type="group"`). */
     children?: React.ReactNode;
+    /**
+     * `typing` — the text read for assistive tech.
+     */
     labels?: Partial<MessageTypingLabels>;
     ref?: React.Ref<HTMLDivElement>;
 };
@@ -19,7 +23,7 @@ export type MessageTypingProps = Omit<React.HTMLAttributes<HTMLDivElement>, "chi
  * «Печатает…»: an incoming bubble of three dots that rise and fade in turn, at the end of the
  * conversation while the other side types. A polite status for assistive tech.
  */
-export declare function MessageTyping({ active, labels: labelsProp, className, children, ...rest }: MessageTypingProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function MessageTyping({ open, labels: labelsProp, className, children, ...rest }: MessageTypingProps): import("react/jsx-runtime").JSX.Element | null;
 export declare namespace MessageTyping {
     var displayName: string;
 }

package/dist/components/message/bubbleMorph.d.ts

@@ -9,6 +9,8 @@ export type BubbleMorphElements = {
     fill: HTMLElement | null;
     /** The row of the list the message stands in (its windowed box, or the message itself). */
     row: HTMLElement | null;
+    /** The scroller of the conversation (`ScrollRegion.element()`); `null` outside one. */
+    scroller: HTMLElement | null;
     /** Holds the conversation's own anchoring while the message gives way itself (`Chat.Messages`). */
     hold?: (() => void) | undefined;
 };

package/dist/components/modal/Modal.d.ts

@@ -1,9 +1,9 @@
-import { DialogGuard } from "./DialogGuard";
-import { DialogActions, DialogBody, DialogClose, DialogConfirm, DialogDescription, DialogFooter, DialogHeader, DialogIcon, DialogMeta, DialogTitle, DialogTrigger } from "./DialogParts";
-import { ModalContent, ModalRoot } from "./ModalDialog";
-export type { DialogGuardProps as ModalGuardProps } from "./DialogGuard";
-export type { DialogActionsProps as ModalActionsProps, DialogBodyProps as ModalBodyProps, DialogCloseProps as ModalCloseProps, DialogConfirmProps as ModalConfirmProps, DialogDescriptionProps as ModalDescriptionProps, DialogFooterProps as ModalFooterProps, DialogHeaderProps as ModalHeaderProps, DialogIconProps as ModalIconProps, DialogMetaProps as ModalMetaProps, DialogTitleProps as ModalTitleProps, DialogTriggerProps as ModalTriggerProps, } from "./DialogParts";
-export type { ModalContentProps, ModalLabels, ModalRootProps } from "./ModalDialog";
+import { DialogGuard } from "../../internal/overlay/DialogGuard";
+import { DialogActions, DialogBody, DialogClose, DialogConfirm, DialogDescription, DialogFooter, DialogHeader, DialogIcon, DialogMeta, DialogTitle, DialogTrigger } from "../../internal/overlay/DialogParts";
+import { ModalContent, ModalRoot } from "../../internal/overlay/ModalDialog";
+export type { DialogGuardProps as ModalGuardProps } from "../../internal/overlay/DialogGuard";
+export type { DialogActionsProps as ModalActionsProps, DialogBodyProps as ModalBodyProps, DialogCloseProps as ModalCloseProps, DialogConfirmProps as ModalConfirmProps, DialogDescriptionProps as ModalDescriptionProps, DialogFooterProps as ModalFooterProps, DialogHeaderProps as ModalHeaderProps, DialogIconProps as ModalIconProps, DialogMetaProps as ModalMetaProps, DialogTitleProps as ModalTitleProps, DialogTriggerProps as ModalTriggerProps, } from "../../internal/overlay/DialogParts";
+export type { ModalContentProps, ModalLabels, ModalPlacement, ModalRootProps, } from "../../internal/overlay/ModalDialog";
 export declare const Modal: {
     Root: typeof ModalRoot;
     Trigger: typeof DialogTrigger;

package/dist/components/native-select/NativeSelect.d.ts

@@ -1,20 +1,35 @@
 import type * as React from "react";
-import { type FieldFrameProps } from "../../internal/FieldFrame";
+import { type FieldFocusRingProps, type FieldFrameProps } from "../../internal/FieldFrame";
 import type { ControlSize } from "../../internal/states";
 export type NativeSelectLabels = {
     /** Muted marker after the label when `optional`. */
     optional: string;
 };
-export type NativeSelectProps = FieldFrameProps & Omit<React.SelectHTMLAttributes<HTMLSelectElement>, "size" | "multiple" | "children"> & {
+export declare const NATIVE_SELECT_LABELS: NativeSelectLabels;
+export type NativeSelectProps = FieldFrameProps & FieldFocusRingProps & Omit<React.SelectHTMLAttributes<HTMLSelectElement>, "size" | "multiple" | "children"> & {
+    /**
+     * Field tier: height, padding, text; the label and the hint follow it.
+     */
     size?: ControlSize;
-    /** Danger ring and `aria-invalid`; a non-empty `error` implies it. */
+    /**
+     * Danger inset ring and `aria-invalid`.
+     */
     invalid?: boolean;
-    /** First, empty option shown while nothing is picked. */
+    /**
+     * Empty first option shown in the placeholder color while nothing is picked.
+     */
     placeholder?: string;
-    /** Called with the picked value; native `onChange` still fires. */
+    /**
+     * Called with the picked value; native `onChange` still fires.
+     */
     onValueChange?: (value: string) => void;
+    /**
+     * Built-in strings, see Labels.
+     */
     labels?: Partial<NativeSelectLabels>;
-    /** Native `<option>` and `<optgroup>` elements. */
+    /**
+     * Native `<option>` and `<optgroup>` elements.
+     */
     children: React.ReactNode;
     ref?: React.Ref<HTMLSelectElement>;
 };
@@ -22,7 +37,7 @@ export type NativeSelectProps = FieldFrameProps & Omit<React.SelectHTMLAttribute
  * The system `<select>` in the field look: the OS picker opens on touch devices. Options are
  * plain `<option>` / `<optgroup>` elements.
  */
-export declare function NativeSelect({ size, label, required, optional, hint, error, invalid, focusRing, disabled: disabledProp, placeholder, id, value, defaultValue, onChange, onValueChange, labels: labelsProp, className, children, "aria-describedby": ariaDescribedBy, ...rest }: NativeSelectProps): import("react/jsx-runtime").JSX.Element;
+export declare function NativeSelect({ size: sizeProp, label, required, optional, hint, error, invalid, focusRing, disabled: disabledProp, placeholder, id, value, defaultValue, onChange, onValueChange, labels: labelsProp, className, children, "aria-describedby": ariaDescribedBy, ...rest }: NativeSelectProps): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>;
 export declare namespace NativeSelect {
     var displayName: string;
 }