@tensor_1/react 2.41.0 → 2.42.0

package/dist/index.d.cts

@@ -1,12 +1,17 @@
 import * as react from 'react';
-import { RefObject, AnchorHTMLAttributes, ReactNode, ButtonHTMLAttributes, HTMLAttributes, AriaAttributes, CSSProperties, SelectHTMLAttributes, Ref, InputHTMLAttributes, TextareaHTMLAttributes, MouseEvent, DetailsHTMLAttributes, LiHTMLAttributes, TdHTMLAttributes, TableHTMLAttributes, ThHTMLAttributes, ReactElement } from 'react';
+import { RefObject, AnchorHTMLAttributes, ReactNode, HTMLAttributes, ButtonHTMLAttributes, AriaAttributes, CSSProperties, SelectHTMLAttributes, Ref, InputHTMLAttributes, TextareaHTMLAttributes, MouseEvent, DetailsHTMLAttributes, LiHTMLAttributes, TdHTMLAttributes, TableHTMLAttributes, ThHTMLAttributes, ReactElement } from 'react';
 import { P as Placement } from './overlay-position-2Afke51l.cjs';
 export { A as Align, a as PositionOptions, b as PositionResult, R as Rect, S as Side, c as Size, d as computePosition } from './overlay-position-2Afke51l.cjs';
 export { C as ChartStatPoint, L as LinearFit, P as PredictionBandPoint, l as linearFit, n as normalQuantile, p as predictionBand, q as quantiles, s as studentTQuantile } from './chart-stats-o4zDhpVm.cjs';
 
 declare function cx(...args: (string | false | null | undefined | 0)[]): string;
 
-declare function useDialog(open: boolean, onClose?: () => void): React.RefObject<HTMLDialogElement>;
+/**
+ * `keepOpen` is asked when the browser closed the dialog on its own (Escape or a close request
+ * nobody cancelled, a `method="dialog"` form). Returning `true` reopens it instead of calling
+ * `onClose`: a form dialog with unsaved input or a save in flight (HAR-2029).
+ */
+declare function useDialog(open: boolean, onClose?: () => void, keepOpen?: () => boolean): React.RefObject<HTMLDialogElement>;
 
 /**
  * uix table engine — framework-agnostic, dependency-free logic for data grids.
@@ -255,6 +260,40 @@ interface UixLinkProps extends AnchorHTMLAttributes<HTMLAnchorElement> {
 type UixRenderLink = (props: UixLinkProps) => ReactNode;
 declare const renderPlainLink: UixRenderLink;
 
+interface KbdProps extends HTMLAttributes<HTMLElement> {
+    children?: ReactNode;
+}
+/** One keyboard key over `.uix-kbd` (HAR-1361; TENSOR C14, MOTUS B-A16). */
+declare function Kbd({ className, children, ...props }: KbdProps): react.JSX.Element;
+type KbdPlatform = 'mac' | 'other';
+/**
+ * A keyboard shortcut (HAR-2031): the keys pressed together, in `KbdCombo`'s names, e.g.
+ * `['Mod', 'K']`, `['Shift', '?']` or `['A']`. `Mod` is ⌘ on Apple and Ctrl elsewhere.
+ */
+type KeyShortcut = readonly string[];
+/**
+ * The `aria-keyshortcuts` value of a shortcut on a platform (HAR-2031): `['Mod', 'K']` is
+ * `Meta+K` on Apple and `Control+K` elsewhere; a single letter is upper-cased (`['a']` is `A`).
+ * For a control the kit does not render.
+ */
+declare function ariaKeyShortcuts(keys: KeyShortcut, platform: KbdPlatform): string;
+interface KbdComboProps extends Omit<HTMLAttributes<HTMLSpanElement>, 'children'> {
+    /**
+     * Keys in order, e.g. `['Mod', 'K']`. `Mod` is ⌘ on Apple and Ctrl elsewhere; `Shift`,
+     * `Alt`, `Enter`, `Escape`, `Backspace`, `Tab` and the arrows get platform glyphs.
+     */
+    keys: string[];
+    /** Fix the platform (tests, docs). Default: detected after mount; the server renders `other`. */
+    platform?: KbdPlatform;
+    /** Spoken names for keys, e.g. `{ Mod: 'Steuerung' }`; the glyphs stay. */
+    keyLabels?: Partial<Record<string, string>>;
+}
+/**
+ * A shortcut such as ⌘K / Ctrl+K. Screen readers hear the key names ("Command+K"), not the
+ * glyphs. The platform is resolved at display time, after mount, so server and client agree.
+ */
+declare function KbdCombo({ keys, platform, keyLabels, className, ...props }: KbdComboProps): react.JSX.Element;
+
 type ButtonVariant = 'primary' | 'secondary' | 'outline' | 'ghost' | 'danger' | 'link';
 /** `xs` is 24 px: the smallest hit area WCAG 2.5.8 allows, for dense tool rows (HAR-1348). */
 type ButtonSize = 'xs' | 'sm' | 'md' | 'lg';
@@ -263,6 +302,21 @@ interface ButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
     size?: ButtonSize;
     icon?: boolean;
     loading?: boolean;
+    /**
+     * Let a long label wrap onto more lines: the size becomes a minimum height instead of a fixed
+     * one (HAR-1813, WCAG 1.4.10 reflow). For human-language labels on public or narrow screens;
+     * dense staff rows keep the one-line default. Ignored with `icon`.
+     */
+    wrap?: boolean;
+    /**
+     * The button's keyboard shortcut, in `KbdCombo` key names: `['A']`, `['Mod', 'Enter']`
+     * (HAR-2031). Hover or focus shows the keys in a hint above the button (an icon button's
+     * `aria-label` before them), and the button gets `aria-keyshortcuts` for the viewer's platform
+     * (⌘ / Meta on Apple, Ctrl / Control elsewhere), unless you pass `aria-keyshortcuts` yourself.
+     * Inside a `Tooltip` the Tooltip shows the keys in its own bubble. The kit only shows the
+     * shortcut: the product binds the key.
+     */
+    shortcut?: KeyShortcut;
     children?: ReactNode;
 }
 declare const Button: react.ForwardRefExoticComponent<ButtonProps & react.RefAttributes<HTMLButtonElement>>;
@@ -272,6 +326,8 @@ interface ButtonLinkProps extends AnchorHTMLAttributes<HTMLAnchorElement> {
     size?: ButtonSize;
     /** Icon-only link: square, and needs `aria-label`. */
     icon?: boolean;
+    /** Let a long label wrap (see `ButtonProps.wrap`, HAR-1813). Ignored with `icon`. */
+    wrap?: boolean;
     /**
      * Renders the link without `href`, with `aria-disabled="true"`, so it is announced
      * as an unavailable link and cannot be followed or focused.
@@ -285,7 +341,7 @@ interface ButtonLinkProps extends AnchorHTMLAttributes<HTMLAnchorElement> {
  * A link that looks like a `Button` (HAR-1348; TENSOR A4/B5, MOTUS C-3). Use it when the
  * action navigates; use `Button` when it acts in place.
  */
-declare function ButtonLink({ href, variant, size, icon, disabled, renderLink, className, children, onClick, ...props }: ButtonLinkProps): react.JSX.Element;
+declare function ButtonLink({ href, variant, size, icon, wrap, disabled, renderLink, className, children, onClick, ...props }: ButtonLinkProps): react.JSX.Element;
 interface ButtonGroupProps {
     children?: ReactNode;
     className?: string;
@@ -2605,6 +2661,86 @@ interface InlineEditProps {
  */
 declare function InlineEdit({ value, onSave, label, renderView, renderEditor, multiline, validate, placeholder, disabled, labels: labelOverrides, className, }: InlineEditProps): react.JSX.Element;
 
+/** The words of the "Discard changes?" step a `dirty` Drawer or Modal asks before it closes (HAR-2029). */
+interface DiscardPromptLabels {
+    /** The question, e.g. "Discard changes?". It names the step. */
+    title: string;
+    /** What discarding means, under the question. */
+    description: string;
+    /** The safe choice. It has focus when the step opens. */
+    keepEditing: string;
+    /** Close and throw the input away. */
+    discard: string;
+}
+type DialogCloseProps = ButtonProps;
+/**
+ * A button that closes the surrounding `Drawer` or `Modal` the way its × does (HAR-2029): at once
+ * when the form is clean, through the "Discard changes?" step (placed against this button) when
+ * the dialog is `dirty`, and not at all while it is `pending`. Use it for the footer's Cancel.
+ * Its own `onClick` runs first; `event.preventDefault()` there keeps the dialog open.
+ */
+declare const DialogClose: react.ForwardRefExoticComponent<ButtonProps & react.RefAttributes<HTMLButtonElement>>;
+
+/** The words of a `SearchBar` (HAR-2030); the field's own name is its `label`. */
+interface SearchBarLabels {
+    /** Accessible name of the clear button. */
+    clear: string;
+    /** Text of the submit button (`submitButton`). */
+    submit: string;
+}
+interface SearchBarProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onSubmit' | 'onChange' | 'defaultValue'> {
+    /**
+     * Accessible name of the field and of its search landmark, e.g. "Search services". It is not
+     * shown (the placeholder is not a label): the field shows `placeholder`.
+     */
+    label: string;
+    /** The text in the field (controlled). Leave it out, with `defaultValue`, for an uncontrolled field. */
+    value?: string;
+    defaultValue?: string;
+    /** Called on every edit, and with `''` when the field is cleared. */
+    onValueChange?: (value: string) => void;
+    /** Enter in the field, or the submit button: search for this text. */
+    onSubmit?: (value: string) => void;
+    /** After the clear button or Escape emptied the field. Focus stays in the field. */
+    onClear?: () => void;
+    placeholder?: string;
+    /** `md` (default) for a header or a toolbar; `lg` for a page-level or public search: 44 px, the touch floor. */
+    size?: 'md' | 'lg';
+    /** A submit button after the field, with `labels.submit`. Enter submits either way. */
+    submitButton?: boolean;
+    /** The submit button's variant. Default `primary`. */
+    submitVariant?: ButtonVariant;
+    /**
+     * A `search` landmark named by `label` (default). Pass `false` for a field that filters a list
+     * or a table, where one more landmark per toolbar would crowd the landmark list. Never wrap it
+     * in a `<search>` or `role="search"` of your own: that nests two landmarks.
+     */
+    landmark?: boolean;
+    /** Ids of elements that describe the field (a hint, a result count), as its `aria-describedby`. */
+    inputDescribedBy?: string;
+    /** The words. Default: `UixLabelsProvider` `searchBar`, then English. */
+    labels?: Partial<SearchBarLabels>;
+    /** The field's `name`. */
+    name?: string;
+    /** The field's `id`, e.g. for a "/" shortcut that focuses it. Default: generated. */
+    inputId?: string;
+    inputRef?: Ref<HTMLInputElement>;
+    autoFocus?: boolean;
+    disabled?: boolean;
+}
+/**
+ * One search field look and behaviour (HAR-2030; TENSOR audit UXC-02) over the `.uix-searchbar`
+ * contract: a leading magnifier, a clear button while there is text, Enter to search, Escape to
+ * clear (an empty field lets Escape through, so it still closes the dialog it sits in). It is a
+ * `search` landmark named by `label`.
+ *
+ * It is not a `<form>`, so it can sit inside one: Enter calls `onSubmit` and never submits a
+ * surrounding form. For suggestions while typing, use `SearchSuggest`. Inside an overlay that
+ * takes Escape itself before the field (a ConfirmPopover, the table's view menu), Escape closes
+ * the overlay rather than clearing the text.
+ */
+declare function SearchBar({ label, value: valueProp, defaultValue, onValueChange, onSubmit, onClear, placeholder, size, submitButton, submitVariant, landmark, inputDescribedBy, labels: labelsProp, name, inputId, inputRef, autoFocus, disabled, className, ...props }: SearchBarProps): react.JSX.Element;
+
 /**
  * Kit chrome strings by component (HAR-1358; TENSOR C20, MOTUS executive summary #3).
  * Each entry overrides that component's English defaults for every instance below the
@@ -2621,6 +2757,8 @@ interface UixLabels {
     drawer?: {
         close?: string;
     };
+    /** The "Discard changes?" step of a `dirty` Drawer or Modal (HAR-2029). */
+    discardPrompt?: Partial<DiscardPromptLabels>;
     peek?: {
         previous?: string;
         next?: string;
@@ -2643,6 +2781,8 @@ interface UixLabels {
     searchSuggest?: {
         clear?: string;
     };
+    /** `SearchBar` (HAR-2030): the clear button's name and the submit button's text. */
+    searchBar?: Partial<SearchBarLabels>;
     /** `resultsOne` / `resultsMany`: the polite result count; `{count}`. */
     commandPalette?: {
         input?: string;
@@ -2695,6 +2835,11 @@ interface InputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'size'>
     size?: 'sm' | 'md';
     invalid?: boolean;
     valid?: boolean;
+    /**
+     * "Check this": a value the reader should confirm, not an error, e.g. one an assistant filled
+     * in (HAR-1814). Draws the warning border; `invalid` wins when both are set.
+     */
+    warning?: boolean;
 }
 declare const Input: react.ForwardRefExoticComponent<InputProps & react.RefAttributes<HTMLInputElement>>;
 interface InputGroupProps {
@@ -2810,6 +2955,12 @@ interface FieldProps {
     label?: string;
     hint?: string;
     error?: string;
+    /**
+     * A value to check, not an error (HAR-1814): shown under the control in the warning colour,
+     * announced politely, and marks the control `data-warning`. `error` wins over it; it wins
+     * over `success` and `hint`.
+     */
+    warning?: string;
     success?: string;
     required?: boolean;
     /**
@@ -2824,11 +2975,21 @@ interface FieldProps {
     className?: string;
     htmlFor?: string;
 }
-declare function Field({ label, hint, error, success, required, help, helpLabel, children, className, htmlFor }: FieldProps): react.JSX.Element;
+declare function Field({ label, hint, error, warning, success, required, help, helpLabel, children, className, htmlFor }: FieldProps): react.JSX.Element;
 
 interface ModalProps extends Omit<HTMLAttributes<HTMLDialogElement>, 'title'> {
     open: boolean;
     onClose?: () => void;
+    /**
+     * The dialog holds input that is not saved (HAR-2029). Escape, the close button and a
+     * `DialogClose` then open an anchored "Discard changes?" step with focus on "Keep editing"
+     * instead of calling `onClose`; "Discard" calls it. A clean dialog closes at once.
+     */
+    dirty?: boolean;
+    /** A save is in flight: Escape, the close button and a `DialogClose` do nothing. */
+    pending?: boolean;
+    /** The words of the discard step. Default: `UixLabelsProvider` `discardPrompt`, then English. */
+    discardLabels?: Partial<DiscardPromptLabels>;
     title?: ReactNode;
     children?: ReactNode;
     footer?: ReactNode;
@@ -2836,7 +2997,7 @@ interface ModalProps extends Omit<HTMLAttributes<HTMLDialogElement>, 'title'> {
     closeLabel?: string;
     role?: 'dialog' | 'alertdialog';
 }
-declare function Modal({ open, onClose, title, children, footer, className, closeLabel: closeLabelProp, role, ...rest }: ModalProps): react.JSX.Element;
+declare function Modal({ open, onClose, dirty, pending, discardLabels, title, children, footer, className, closeLabel: closeLabelProp, role, onKeyDown, ...rest }: ModalProps): react.JSX.Element;
 
 interface ConfirmDialogProps {
     open: boolean;
@@ -2945,10 +3106,22 @@ interface DrawerProps extends Omit<HTMLAttributes<HTMLDialogElement>, 'title'> {
     closeLabel?: string;
     open: boolean;
     onClose?: () => void;
+    /**
+     * The drawer holds input that is not saved (HAR-2029), e.g. react-hook-form's
+     * `formState.isDirty`. Escape, the close button, a backdrop click and a `DialogClose` then open
+     * an anchored "Discard changes?" step with focus on "Keep editing" instead of calling `onClose`;
+     * "Discard" calls it. A clean drawer closes at once. A `<form method="dialog">` submit counts
+     * as a way out too: save with your own handler instead.
+     */
+    dirty?: boolean;
+    /** A save is in flight: Escape, the close button, a backdrop click and a `DialogClose` do nothing. */
+    pending?: boolean;
+    /** The words of the discard step. Default: `UixLabelsProvider` `discardPrompt`, then English. */
+    discardLabels?: Partial<DiscardPromptLabels>;
     /**
      * A click on the dimmed backdrop calls `onClose`, like Escape and the close button
-     * (TENSOR HAR-547). Pass `false` on a drawer that holds unsaved form input, so a stray click
-     * can't discard it; Escape and the close button still close. Default `true`.
+     * (TENSOR HAR-547), or asks first when the drawer is `dirty`. `false` ignores backdrop clicks
+     * altogether. Default `true`.
      */
     dismissOnBackdrop?: boolean;
     /**
@@ -2960,7 +3133,7 @@ interface DrawerProps extends Omit<HTMLAttributes<HTMLDialogElement>, 'title'> {
     children?: ReactNode;
     footer?: ReactNode;
 }
-declare function Drawer({ open, onClose, dismissOnBackdrop, side, title, children, footer, closeLabel: closeLabelProp, className, onClick, ...rest }: DrawerProps): react.JSX.Element;
+declare function Drawer({ open, onClose, dirty, pending, discardLabels, dismissOnBackdrop, side, title, children, footer, closeLabel: closeLabelProp, className, onClick, onKeyDown, ...rest }: DrawerProps): react.JSX.Element;
 
 interface PeekProps extends Omit<HTMLAttributes<HTMLDialogElement>, 'title'> {
     /** TENSOR RX-125 (UIX-04): translatable; English default. */
@@ -3331,6 +3504,17 @@ declare function ListItem({ title, meta, trail, leading, children, className, ..
  * Use `items` for data-driven lists (the common case) or the `DescriptionItem`
  * compound child for hand-authored content. Both render `<dt>`/`<dd>` pairs as
  * direct children of the grid `<dl>`, so they align into the same columns.
+ *
+ * Below 22rem of its own width (a phone, a side rail, a narrow column) each label
+ * sits above its value and both take the full width (HAR-2032), so a long label
+ * never squeezes the value. A `DetailLayout` side column always stacks.
+ *
+ * The list is an inline-size container for this, so its content no longer sizes
+ * it: in a box sized by its content (a flex row, a `Popover` or hover card, a
+ * `max-content` tooltip, an auto-layout table cell, inline-block, a float) it is
+ * 12rem wide, and stacked, unless you size it (`flex: 1`, a width). And an
+ * unnamed `@container` query or a `cqi` unit inside a value now measures the
+ * list: name the container you mean (`@container/card`).
  */
 interface DescriptionListItem {
     /** Stable identity for the row; falls back to the list index when omitted. */
@@ -4168,29 +4352,6 @@ interface ChipGroupProps extends HTMLAttributes<HTMLDivElement> {
 /** A wrapping row of chips with a group name. */
 declare function ChipGroup({ label, children, className, ...props }: ChipGroupProps): react.JSX.Element;
 
-interface KbdProps extends HTMLAttributes<HTMLElement> {
-    children?: ReactNode;
-}
-/** One keyboard key over `.uix-kbd` (HAR-1361; TENSOR C14, MOTUS B-A16). */
-declare function Kbd({ className, children, ...props }: KbdProps): react.JSX.Element;
-type KbdPlatform = 'mac' | 'other';
-interface KbdComboProps extends Omit<HTMLAttributes<HTMLSpanElement>, 'children'> {
-    /**
-     * Keys in order, e.g. `['Mod', 'K']`. `Mod` is ⌘ on Apple and Ctrl elsewhere; `Shift`,
-     * `Alt`, `Enter`, `Escape`, `Backspace`, `Tab` and the arrows get platform glyphs.
-     */
-    keys: string[];
-    /** Fix the platform (tests, docs). Default: detected after mount; the server renders `other`. */
-    platform?: KbdPlatform;
-    /** Spoken names for keys, e.g. `{ Mod: 'Steuerung' }`; the glyphs stay. */
-    keyLabels?: Partial<Record<string, string>>;
-}
-/**
- * A shortcut such as ⌘K / Ctrl+K. Screen readers hear the key names ("Command+K"), not the
- * glyphs. The platform is resolved at display time, after mount, so server and client agree.
- */
-declare function KbdCombo({ keys, platform, keyLabels, className, ...props }: KbdComboProps): react.JSX.Element;
-
 type StepState = 'complete' | 'current' | 'upcoming' | 'waiting' | 'error';
 /** The state words read after each step's title (state is never colour alone). */
 interface StepStateLabels {
@@ -4269,6 +4430,14 @@ interface TooltipProps extends Omit<HTMLAttributes<HTMLSpanElement>, 'content'>
     content?: ReactNode;
     /** Preferred placement. Default `'top'`. */
     placement?: Placement;
+    /**
+     * The trigger's keyboard shortcut, in `KbdCombo` key names, e.g. `['Mod', 'K']` (HAR-2031):
+     * shown with `Kbd` after the text, and set as the trigger's `aria-keyshortcuts` for the
+     * viewer's platform. Default: the `shortcut` of a `Button` child, so a Tooltip around a Button
+     * with a shortcut shows one bubble with the label and the keys. The kit only shows it: the
+     * product binds the key.
+     */
+    shortcut?: KeyShortcut;
     children?: ReactNode;
 }
 /**
@@ -4279,7 +4448,7 @@ interface TooltipProps extends Omit<HTMLAttributes<HTMLSpanElement>, 'content'>
  * (document-level, per WCAG 1.4.13), and hoverable: the bubble stays open while
  * the pointer is over it (UIX-A11Y-1).
  */
-declare function Tooltip({ label, content, placement, className, children, ...props }: TooltipProps): react.JSX.Element;
+declare function Tooltip({ label, content, placement, shortcut, className, children, ...props }: TooltipProps): react.JSX.Element;
 
 interface InfoTipProps extends Omit<HTMLAttributes<HTMLSpanElement>, 'content' | 'children'> {
     /**
@@ -4905,8 +5074,12 @@ interface MenuItemProps extends MenuItemAttributes {
     href?: string;
     renderLink?: UixRenderLink;
     icon?: ReactNode;
-    /** Shortcut hint at the end of the row, e.g. `<KbdCombo keys={['Mod', 'D']} />`. */
-    shortcut?: ReactNode;
+    /**
+     * The row's keyboard shortcut, at its end. Key names (`['Mod', 'D']`, `['A']`) render with
+     * `KbdCombo` and set the row's `aria-keyshortcuts` for the viewer's platform (HAR-2031); any
+     * other node renders as given.
+     */
+    shortcut?: KeyShortcut | ReactNode;
     tone?: 'default' | 'danger';
     disabled?: boolean;
     className?: string;
@@ -4935,7 +5108,8 @@ interface MenuItemRadioProps extends MenuItemAttributes {
     closeOnSelect?: boolean;
     children?: ReactNode;
     icon?: ReactNode;
-    shortcut?: ReactNode;
+    /** Key names (`['Shift', 'W']`) or a node; see `MenuItemProps.shortcut`. */
+    shortcut?: KeyShortcut | ReactNode;
     disabled?: boolean;
     className?: string;
 }
@@ -4948,7 +5122,8 @@ interface MenuItemCheckboxProps extends MenuItemAttributes {
     closeOnSelect?: boolean;
     children?: ReactNode;
     icon?: ReactNode;
-    shortcut?: ReactNode;
+    /** Key names (`['Shift', 'W']`) or a node; see `MenuItemProps.shortcut`. */
+    shortcut?: KeyShortcut | ReactNode;
     disabled?: boolean;
     className?: string;
 }
@@ -5127,7 +5302,7 @@ interface PageIntroProps extends Omit<HTMLAttributes<HTMLElement>, 'title'> {
     lede?: ReactNode;
     /** Label shown above the search well. */
     searchLabel?: ReactNode;
-    /** The search well itself (form + `.uix-searchbar` markup, or `SearchBar`-style composition). */
+    /** The search well itself: a `SearchBar size="lg"` (HAR-2030), or `.uix-searchbar` markup. */
     search?: ReactNode;
     /** Shortcut buttons; rendered inside the `.uix-shortcut-grid` full-width row. */
     shortcuts?: ReactNode;
@@ -5731,6 +5906,13 @@ interface MetricInputProps {
     label: string;
     invalid?: boolean;
     errorMessage?: string;
+    /**
+     * A required value (HAR-1819): the label shows the same marker as `Field`, and the input
+     * gets native `required` and `aria-required="true"`.
+     */
+    required?: boolean;
+    /** Guidance under the control (a range, a unit rule), tied to the input by `aria-describedby`. */
+    hint?: string;
     disabled?: boolean;
     readOnly?: boolean;
     parse?: (input: string) => number | null;
@@ -5739,7 +5921,7 @@ interface MetricInputProps {
     id?: string;
 }
 /** Accessible numeric recipe composed from Input and the UIx stepper controls. */
-declare function MetricInput({ value, onValueChange, min, max, step, unit, label, invalid, errorMessage, disabled, readOnly, parse, format, className, id: providedId, }: MetricInputProps): react.JSX.Element;
+declare function MetricInput({ value, onValueChange, min, max, step, unit, label, invalid, errorMessage, required, hint, disabled, readOnly, parse, format, className, id: providedId, }: MetricInputProps): react.JSX.Element;
 
 declare function clampMetricValue(value: number, min?: number, max?: number): number;
 declare function stepMetricValue(value: number | null, direction: -1 | 1, options?: {
@@ -5964,4 +6146,4 @@ declare function hsvToHex(value: HsvColor): string;
 declare function contrastRatio(background: string, foreground: string): number | undefined;
 declare function meetsContrast(background: string, foreground: string, minimum?: number): boolean;
 
-export { type AccessStateProps, Alert, type AlertProps, type AlertTone, AppShell, type AppShellProps, type AppliedBrandProfileSnapshot, type AsyncOperationState, AsyncOperationStatus, type AsyncOperationStatusProps, Attachment, type AttachmentLabels, AttachmentList, type AttachmentListProps, type AttachmentProps, Avatar, AvatarGroup, type AvatarGroupProps, type AvatarPresence, type AvatarProps, type BoundedRelationshipGraph, type BrandProfile, BrandProfileEditor, type BrandProfileEditorLabels, type BrandProfileEditorProps, type BrandProfileLogo, type BrandProfileTypography, BrandProfiles, type BreadcrumbItem, Breadcrumbs, type BreadcrumbsProps, BuilderCanvas, type BuilderCanvasItem, type BuilderCanvasLabels, type BuilderCanvasProps, type BuilderPaletteItem, BulkBar, type BulkBarProps, Bullet, type BulletProps, Button, ButtonGroup, type ButtonGroupProps, ButtonLink, type ButtonLinkProps, type ButtonProps, type ButtonSize, type ButtonVariant, type CalendarDay, type CalendarWeekday, Card, CardLink, type CardLinkProps, type CardProps, CellStrong, CellSub, Checkbox, type CheckboxProps, Chip, ChipGroup, type ChipGroupProps, type ChipProps, CollapsibleSection, type CollapsibleSectionProps, ColorPicker, type ColorPickerLabels, type ColorPickerProps, type ColumnFilter, Combobox, type ComboboxOption, type ComboboxProps, CommandGroup, type CommandGroupProps, CommandItem, type CommandItemProps, CommandPalette, type CommandPaletteProps, Comment, type CommentProps, Comments, type CommentsProps, Composer, ComposerBar, type ComposerBarProps, type ComposerProps, ConfirmDialog, type ConfirmDialogProps, ContentList, ContentListItem, type ContentListItemProps, type ContentListProps, CopyButton, type CopyButtonProps, DAY, DEFAULT_ATTACHMENT_LABELS, DEFAULT_BRAND_PROFILE_EDITOR_LABELS, DEFAULT_BUILDER_CANVAS_LABELS, DEFAULT_COLOR_PICKER_LABELS, DEFAULT_DATE_PICKER_LABELS, DEFAULT_DATE_RANGE_PICKER_LABELS, DEFAULT_DATE_TIME_PICKER_LABELS, DEFAULT_DIFF_VIEWER_LABELS, DEFAULT_ENTITY_PICKER_LABELS, DEFAULT_FILE_UPLOAD_LABELS, DEFAULT_FILTER_EDITOR_LABELS, DEFAULT_FILTER_SUMMARY_LABELS, DEFAULT_INLINE_EDIT_LABELS, DEFAULT_INSIGHT_CARD_LABELS, DEFAULT_LIGHTBOX_LABELS, DEFAULT_MATCH_REVIEW_LABELS, DEFAULT_PAGINATION_LABELS, DEFAULT_PRESENCE_LABELS, DEFAULT_RELATIONSHIP_GRAPH_LABELS, DEFAULT_RULE_BUILDER_LABELS, DEFAULT_RULE_SUMMARY_WORDS, DEFAULT_RULE_VALIDATION_MESSAGES, DEFAULT_SAVE_STATUS_LABELS, DEFAULT_SCHEDULING_CALENDAR_LABELS, DEFAULT_SCHEDULING_TIMELINE_LABELS, DEFAULT_STEP_STATE_LABELS, DEFAULT_TEXT_DIFF_LABELS, DEFAULT_TREE_LABELS, DashboardGrid, type DashboardGridBreakpoint, type DashboardGridColumnCount, type DashboardGridColumns, type DashboardGridGap, DashboardGridItem, type DashboardGridItemProps, type DashboardGridProps, type DashboardGridSpan, type DateInputProblem, type DatePart, DatePicker, type DatePickerLabels, type DatePickerProps, DateRangePicker, type DateRangePickerLabels, type DateRangePickerProps, type DateRangeValue, DateTimePicker, type DateTimePickerLabels, type DateTimePickerProps, type DaySpanLayout, DescriptionItem, type DescriptionItemProps, DescriptionList, type DescriptionListItem, type DescriptionListProps, DetailLayout, type DetailLayoutProps, DetailPage, type DetailPageLinkProps, type DetailPageMetric, type DetailPageProps, type DetailPageTab, type DiffEntry, type DiffKind, type DiffResolution, type DiffSummary, DiffViewer, type DiffViewerLabels, type DiffViewerProps, Drawer, type DrawerProps, EmptyState, type EmptyStateProps, EntityPicker, type EntityPickerLabels, type EntityPickerProps, type EntityPickerSearchResult, ErrorState, type ErrorStateProps, EventRow, type EventRowProps, ExpandToggle, type ExpandToggleProps, FeaturedRundown, FeaturedRundownItem, type FeaturedRundownItemProps, type FeaturedRundownProps, FeaturedStage, type FeaturedStageProps, Field, type FieldProps, type FileRejection, type FileRejectionReason, type FileSizeFormatter, type FileSizeOptions, FileUpload, type FileUploadItem, type FileUploadLabels, type FileUploadProps, type FileUploadStatus, type FilterChoice, FilterEditor, type FilterEditorLabels, type FilterEditorProps, type FilterField, type FilterKind, type FilterOp, type FilterOption, FilterPopover, type FilterPopoverProps, type FilterPreset, type FilterSummaryLabels, type FilterValue, type FilterValueKind, FilteredEmptyState, type FlatNode, Flow, FlowNode, type FlowNodeProps, type FlowNodeState, type FlowProps, type FlowVariant, type FoldedText, ForbiddenState, HOUR, Heartbeat, type HeartbeatProps, type HeartbeatState, Highlighted, type HighlightedProps, type HsvColor, Inbox, InboxDetail, type InboxDetailProps, InboxItem, type InboxItemProps, InboxList, type InboxListProps, type InboxProps, InfoTip, type InfoTipProps, InlineEdit, type InlineEditEditorProps, type InlineEditLabels, type InlineEditProps, Input, InputGroup, type InputGroupProps, type InputProps, InsightCard, type InsightCardLabels, type InsightCardProps, type InsightComparison, type InsightCoverage, type InsightKpi, type InsightStatus, type InsightStatusTone, type InsightTarget, type JsonPrimitive, type JsonValue, Kanban, KanbanCard, type KanbanCardProps, KanbanColumn, type KanbanColumnProps, type KanbanMoveDirection, type KanbanProps, Kbd, KbdCombo, type KbdComboProps, type KbdPlatform, type KbdProps, Label, type LabelProps, type LaneCluster, type LaneInterval, type LanePlacement, type LayeredColumn, type LayeredEdgeClassification, type LayeredEdgeKind, type LayeredItem, type LayeredLayout, type LayeredLayoutOptions, type LayeredNavigationKey, type LayoutLaneOptions, type LayoutMonthSpansOptions, LicensePositionBar, type LicensePositionBarProps, Lightbox, type LightboxItem, type LightboxLabels, type LightboxProps, List, ListItem, type ListItemProps, type ListProps, LiveIndicator, type LiveIndicatorProps, LoadingState, type LoadingStateProps, Mark, type MarkProps, type MatchBulkResult, MatchReview, type MatchReviewAction, type MatchReviewCandidate, type MatchReviewField, type MatchReviewLabels, type MatchReviewProps, Menu, MenuGroup, type MenuGroupProps, MenuItem, type MenuItemAttributes, MenuItemCheckbox, type MenuItemCheckboxProps, type MenuItemProps, MenuItemRadio, type MenuItemRadioProps, type MenuProps, MenuRadioGroup, type MenuRadioGroupProps, MenuSeparator, Meter, type MeterProps, type MeterTone, MetricInput, type MetricInputProps, Modal, type ModalProps, type MonthSpanGroup, type MonthSpanInput, type MonthSpanLayout, type MoveProposal, NUMBER_FILTER_OPERATORS, type NavFavouriteItem, NavFavourites, type NavFavouritesLabels, type NavFavouritesProps, NavGroup, type NavGroupProps, NavItem, type NavItemProps, NewsLead, type NewsLeadProps, NotFoundState, Note, type NoteProps, type NoteTone, NoticeQueue, type NoticeQueueProps, type NumberFilterOperator, type PackLanesOptions, type PackedLanes, PageHeader, type PageHeaderProps, PageIntro, type PageIntroProps, Pagination, type PaginationLabels, type PaginationProps, Peek, type PeekProps, type PillSize, type PillTone, type PillTreatment, Pipeline, type PipelineProps, PipelineStage, type PipelineStageProps, type PipelineStageState, type PlacedDaySpan, type PlacedMonthSpan, type PlacedSpan, Placement, Popconfirm, type PopconfirmProps, Popover, type PopoverProps, type PositionedRelationshipNode, PresenceDot, type PresenceDotProps, type Primitive, Progress, type ProgressProps, PromptDialog, type PromptDialogProps, Prose, type ProseProps, Radio, RadioCard, type RadioCardProps, RadioGroup, type RadioGroupProps, type RadioProps, type RelatedLinkItem, RelatedLinks, type RelatedLinksProps, RelationshipGraph, type RelationshipGraphArrow, type RelationshipGraphCluster, type RelationshipGraphEdge, type RelationshipGraphLabels, type RelationshipGraphLegendItem, type RelationshipGraphNode, type RelationshipGraphProps, RelativeTime, type RelativeTimeFormatContext, type RelativeTimeProps, type RelativeTimeUnit, type RelativeTimeValue, ResourceGrid, type ResourceGridProps, type RgbColor, type RoutedEdge, type Row, RowAction, type RowActionProps, RowActions, type RowActionsProps, type RuleAction, type RuleActionDefinition, RuleBuilder, type RuleBuilderLabels, type RuleBuilderProps, type RuleCheck, type RuleCondition, type RuleDefinition, type RuleFieldDefinition, type RuleGroup, type RuleOperatorDefinition, type RuleSummaryWords, type RuleValidationIssue, type RuleValidationOptions, type RuleValueEditorProps, SaveStatus, type SaveStatusLabels, type SaveStatusProps, type SaveStatusState, type SavedViewItem, SavedViewMenu, type SavedViewMenuProps, type SavedViewSection, type SchedulingAgendaGroup, type SchedulingBand, SchedulingCalendar, type SchedulingCalendarDay, type SchedulingCalendarEntry, type SchedulingCalendarLabels, type SchedulingCalendarOverlay, type SchedulingCalendarProps, type SchedulingCalendarView, type SchedulingDatePart, type SchedulingEntryState, type SchedulingLegendItem, type SchedulingMarker, type SchedulingMarkerEmphasis, type SchedulingOverlayKind, type SchedulingOverlayPattern, type SchedulingStatus, SchedulingTimeline, type SchedulingTimelineGroup, type SchedulingTimelineItem, type SchedulingTimelineLabels, type SchedulingTimelineLane, type SchedulingTimelineMarker, type SchedulingTimelineOverlay, type SchedulingTimelineOverlayKind, type SchedulingTimelineProps, type SearchSegment, SearchSuggest, type SearchSuggestAction, type SearchSuggestOption, type SearchSuggestProps, SectionHead, type SectionHeadProps, type Segment, Segmented, SegmentedOption, type SegmentedOptionProps, type SegmentedProps, Select, type SelectAllState, type SelectGroup, type SelectLabels, type SelectOption, type SelectProps, type ShellNav, Sidebar, type SidebarProps, SidebarSection, type SidebarSectionProps, Skeleton, type SkeletonProps, type SortDir, type SortDirection, type SortKey, Spinner, type SpinnerProps, StarButton, type StarButtonProps, Stat, StatLine, type StatLineItem, type StatLineProps, type StatProps, type StatTrend, type StateVariant, StatusPill, type StatusPillProps, StatusRow, type StatusRowProps, Step, type StepProps, type StepState, type StepStateLabels, Steps, type StepsProps, SubNavItem, type SubNavItemProps, type SummarizeFilterOptions, Switch, type SwitchProps, TEXT_FILTER_OPERATORS, TOAST_LEAVE_MS, TOP_LANE_CROSS_MIDNIGHT_MINUTES, Tab, TabPanel, type TabPanelProps, type TabProps, Table, type TableDensity, type TableProps, TableWrap, type TableWrapProps, Tabs, type TabsProps, Td, type TdProps, TextDiff, type TextDiffGranularity, type TextDiffLabels, type TextDiffLine, type TextDiffOp, type TextDiffOptions, type TextDiffProps, type TextDiffResult, type TextDiffRow, type TextDiffSegment, type TextFilterOperator, Textarea, type TextareaProps, Th, type ThProps, type TimeGridDayLayout, type TimeGridEntryContext, type TimeGridEntryInput, type TimeGridPart, type TimeGridSegment, Timeline, TimelineItem, type TimelineItemProps, type TimelineProps, type TimelineRange, type TimelineScale, type TimelineSpan, type TimelineSubTick, type TimelineTick, Toast, type ToastAction, type ToastApi, type ToastDismissReason, type ToastKind, type ToastOptions, type ToastPromiseMessages, type ToastProps, type ToastRecord, type ToastStore, type ToastTone, Toaster, type ToasterProps, ToggleRow, type ToggleRowProps, Tooltip, type TooltipProps, Tr, type TrProps, Tree, type TreeLabels, type TreeLike, type TreeNavAction, type TreeNodeData, type TreeNodeProps, type TreeProps, type UixLabels, UixLabelsProvider, type UixLabelsProviderProps, type UixLinkProps, type UixRenderLink, type UndoableToastOptions, type UseAnchoredPositionOptions, type UseTableOptions, type UseTableResult, type UseVirtualRowsOptions, type UseVirtualRowsResult, UserChip, type UserChipProps, ViewMenu, type ViewMenuColumn, type ViewMenuColumnLabels, type ViewMenuProps, type ViewState, type VirtualWindow, type ZonedDateSpan, type ZonedDayBounds, type ZonedDayShift, type ZonedDaySpan, type ZonedHourSlot, addCalendarDays, addCalendarMonths, addZonedDays, appendRuleNode, applyBrandProfile, applyFilters, boundRelationshipGraph, buildMonthGrid, buildThreeWayDiff, cachedDateTimeFormat, clampMetricValue, clampWidth, classifyLayeredEdges, clusterIdFor, contrastRatio, createToastApi, createToastStore, cx, dashboardGridClassName, dashboardGridItemClassName, dateOrder, datePattern, defaultTimelineStep, diffText, diffTokens, emptyFilterValue, enumerateDateKeys, enumerateDateSpan, fileKind, fileMatchesAccept, filterComboboxOptions, findRuleNodeDepth, flattenTree, foldForSearch, formatDateKey, formatFileSize, hexToRgb, highlightSegments, hsvToHex, hsvToRgb, isDateInRange, isDateUnavailable, isFilterEmpty, isRuleGroup, isValidDateKey, itemDaySpan, joinDateTime, layeredNeighbor, layoutDaySpans, layoutLane, layoutLayeredGraph, layoutMonthSpans, layoutRelationshipGraph, layoutTimeGridDay, mapRuleGroup, matchFilter, matchFilterPreset, meetsContrast, mergePinned, moveRuleNode, multiSort, nextSortDir, normalizeHex, packLanes, parseDateInput, parseDateValue, parseMetricValue, parseView, partitionFiles, pixelsToMs, placeSpan, placesInTopLane, proposeMove, rankOverflow, relationshipNeighbors, relativeTimeValue, removeRuleNode, renderPlainLink, reorder, restoreBrandProfile, rgbToHex, rgbToHsv, ruleDepth, schedulingGridDays, searchRows, searchSegments, selectAllState, selectRangeDate, serializeView, setRuleCombinator, shiftSpan, shouldVirtualize, snapToStep, splitDateTime, startOfMonth, stepMetricValue, summarizeDiff, summarizeFilter, summarizeRule, textDiffRows, timeZoneName, timelineRepeatedHourOffset, timelineStepDelta, timelineSubTicks, timelineTicks, toDateKey, toast, toggleId, togglePage, toggleSort, tokenizeText, traverseRelationshipNode, treeNav, useAnchoredPosition, useDialog, useTable, useUixLabels, useVirtualRows, validateRuleDefinition, virtualWindow, wrapEdgeLabel, zonedDateKey, zonedDateSpan, zonedDayBounds, zonedDaySpan, zonedHourSlots, zonedTimeOfDay };
+export { type AccessStateProps, Alert, type AlertProps, type AlertTone, AppShell, type AppShellProps, type AppliedBrandProfileSnapshot, type AsyncOperationState, AsyncOperationStatus, type AsyncOperationStatusProps, Attachment, type AttachmentLabels, AttachmentList, type AttachmentListProps, type AttachmentProps, Avatar, AvatarGroup, type AvatarGroupProps, type AvatarPresence, type AvatarProps, type BoundedRelationshipGraph, type BrandProfile, BrandProfileEditor, type BrandProfileEditorLabels, type BrandProfileEditorProps, type BrandProfileLogo, type BrandProfileTypography, BrandProfiles, type BreadcrumbItem, Breadcrumbs, type BreadcrumbsProps, BuilderCanvas, type BuilderCanvasItem, type BuilderCanvasLabels, type BuilderCanvasProps, type BuilderPaletteItem, BulkBar, type BulkBarProps, Bullet, type BulletProps, Button, ButtonGroup, type ButtonGroupProps, ButtonLink, type ButtonLinkProps, type ButtonProps, type ButtonSize, type ButtonVariant, type CalendarDay, type CalendarWeekday, Card, CardLink, type CardLinkProps, type CardProps, CellStrong, CellSub, Checkbox, type CheckboxProps, Chip, ChipGroup, type ChipGroupProps, type ChipProps, CollapsibleSection, type CollapsibleSectionProps, ColorPicker, type ColorPickerLabels, type ColorPickerProps, type ColumnFilter, Combobox, type ComboboxOption, type ComboboxProps, CommandGroup, type CommandGroupProps, CommandItem, type CommandItemProps, CommandPalette, type CommandPaletteProps, Comment, type CommentProps, Comments, type CommentsProps, Composer, ComposerBar, type ComposerBarProps, type ComposerProps, ConfirmDialog, type ConfirmDialogProps, ContentList, ContentListItem, type ContentListItemProps, type ContentListProps, CopyButton, type CopyButtonProps, DAY, DEFAULT_ATTACHMENT_LABELS, DEFAULT_BRAND_PROFILE_EDITOR_LABELS, DEFAULT_BUILDER_CANVAS_LABELS, DEFAULT_COLOR_PICKER_LABELS, DEFAULT_DATE_PICKER_LABELS, DEFAULT_DATE_RANGE_PICKER_LABELS, DEFAULT_DATE_TIME_PICKER_LABELS, DEFAULT_DIFF_VIEWER_LABELS, DEFAULT_ENTITY_PICKER_LABELS, DEFAULT_FILE_UPLOAD_LABELS, DEFAULT_FILTER_EDITOR_LABELS, DEFAULT_FILTER_SUMMARY_LABELS, DEFAULT_INLINE_EDIT_LABELS, DEFAULT_INSIGHT_CARD_LABELS, DEFAULT_LIGHTBOX_LABELS, DEFAULT_MATCH_REVIEW_LABELS, DEFAULT_PAGINATION_LABELS, DEFAULT_PRESENCE_LABELS, DEFAULT_RELATIONSHIP_GRAPH_LABELS, DEFAULT_RULE_BUILDER_LABELS, DEFAULT_RULE_SUMMARY_WORDS, DEFAULT_RULE_VALIDATION_MESSAGES, DEFAULT_SAVE_STATUS_LABELS, DEFAULT_SCHEDULING_CALENDAR_LABELS, DEFAULT_SCHEDULING_TIMELINE_LABELS, DEFAULT_STEP_STATE_LABELS, DEFAULT_TEXT_DIFF_LABELS, DEFAULT_TREE_LABELS, DashboardGrid, type DashboardGridBreakpoint, type DashboardGridColumnCount, type DashboardGridColumns, type DashboardGridGap, DashboardGridItem, type DashboardGridItemProps, type DashboardGridProps, type DashboardGridSpan, type DateInputProblem, type DatePart, DatePicker, type DatePickerLabels, type DatePickerProps, DateRangePicker, type DateRangePickerLabels, type DateRangePickerProps, type DateRangeValue, DateTimePicker, type DateTimePickerLabels, type DateTimePickerProps, type DaySpanLayout, DescriptionItem, type DescriptionItemProps, DescriptionList, type DescriptionListItem, type DescriptionListProps, DetailLayout, type DetailLayoutProps, DetailPage, type DetailPageLinkProps, type DetailPageMetric, type DetailPageProps, type DetailPageTab, DialogClose, type DialogCloseProps, type DiffEntry, type DiffKind, type DiffResolution, type DiffSummary, DiffViewer, type DiffViewerLabels, type DiffViewerProps, type DiscardPromptLabels, Drawer, type DrawerProps, EmptyState, type EmptyStateProps, EntityPicker, type EntityPickerLabels, type EntityPickerProps, type EntityPickerSearchResult, ErrorState, type ErrorStateProps, EventRow, type EventRowProps, ExpandToggle, type ExpandToggleProps, FeaturedRundown, FeaturedRundownItem, type FeaturedRundownItemProps, type FeaturedRundownProps, FeaturedStage, type FeaturedStageProps, Field, type FieldProps, type FileRejection, type FileRejectionReason, type FileSizeFormatter, type FileSizeOptions, FileUpload, type FileUploadItem, type FileUploadLabels, type FileUploadProps, type FileUploadStatus, type FilterChoice, FilterEditor, type FilterEditorLabels, type FilterEditorProps, type FilterField, type FilterKind, type FilterOp, type FilterOption, FilterPopover, type FilterPopoverProps, type FilterPreset, type FilterSummaryLabels, type FilterValue, type FilterValueKind, FilteredEmptyState, type FlatNode, Flow, FlowNode, type FlowNodeProps, type FlowNodeState, type FlowProps, type FlowVariant, type FoldedText, ForbiddenState, HOUR, Heartbeat, type HeartbeatProps, type HeartbeatState, Highlighted, type HighlightedProps, type HsvColor, Inbox, InboxDetail, type InboxDetailProps, InboxItem, type InboxItemProps, InboxList, type InboxListProps, type InboxProps, InfoTip, type InfoTipProps, InlineEdit, type InlineEditEditorProps, type InlineEditLabels, type InlineEditProps, Input, InputGroup, type InputGroupProps, type InputProps, InsightCard, type InsightCardLabels, type InsightCardProps, type InsightComparison, type InsightCoverage, type InsightKpi, type InsightStatus, type InsightStatusTone, type InsightTarget, type JsonPrimitive, type JsonValue, Kanban, KanbanCard, type KanbanCardProps, KanbanColumn, type KanbanColumnProps, type KanbanMoveDirection, type KanbanProps, Kbd, KbdCombo, type KbdComboProps, type KbdPlatform, type KbdProps, type KeyShortcut, Label, type LabelProps, type LaneCluster, type LaneInterval, type LanePlacement, type LayeredColumn, type LayeredEdgeClassification, type LayeredEdgeKind, type LayeredItem, type LayeredLayout, type LayeredLayoutOptions, type LayeredNavigationKey, type LayoutLaneOptions, type LayoutMonthSpansOptions, LicensePositionBar, type LicensePositionBarProps, Lightbox, type LightboxItem, type LightboxLabels, type LightboxProps, List, ListItem, type ListItemProps, type ListProps, LiveIndicator, type LiveIndicatorProps, LoadingState, type LoadingStateProps, Mark, type MarkProps, type MatchBulkResult, MatchReview, type MatchReviewAction, type MatchReviewCandidate, type MatchReviewField, type MatchReviewLabels, type MatchReviewProps, Menu, MenuGroup, type MenuGroupProps, MenuItem, type MenuItemAttributes, MenuItemCheckbox, type MenuItemCheckboxProps, type MenuItemProps, MenuItemRadio, type MenuItemRadioProps, type MenuProps, MenuRadioGroup, type MenuRadioGroupProps, MenuSeparator, Meter, type MeterProps, type MeterTone, MetricInput, type MetricInputProps, Modal, type ModalProps, type MonthSpanGroup, type MonthSpanInput, type MonthSpanLayout, type MoveProposal, NUMBER_FILTER_OPERATORS, type NavFavouriteItem, NavFavourites, type NavFavouritesLabels, type NavFavouritesProps, NavGroup, type NavGroupProps, NavItem, type NavItemProps, NewsLead, type NewsLeadProps, NotFoundState, Note, type NoteProps, type NoteTone, NoticeQueue, type NoticeQueueProps, type NumberFilterOperator, type PackLanesOptions, type PackedLanes, PageHeader, type PageHeaderProps, PageIntro, type PageIntroProps, Pagination, type PaginationLabels, type PaginationProps, Peek, type PeekProps, type PillSize, type PillTone, type PillTreatment, Pipeline, type PipelineProps, PipelineStage, type PipelineStageProps, type PipelineStageState, type PlacedDaySpan, type PlacedMonthSpan, type PlacedSpan, Placement, Popconfirm, type PopconfirmProps, Popover, type PopoverProps, type PositionedRelationshipNode, PresenceDot, type PresenceDotProps, type Primitive, Progress, type ProgressProps, PromptDialog, type PromptDialogProps, Prose, type ProseProps, Radio, RadioCard, type RadioCardProps, RadioGroup, type RadioGroupProps, type RadioProps, type RelatedLinkItem, RelatedLinks, type RelatedLinksProps, RelationshipGraph, type RelationshipGraphArrow, type RelationshipGraphCluster, type RelationshipGraphEdge, type RelationshipGraphLabels, type RelationshipGraphLegendItem, type RelationshipGraphNode, type RelationshipGraphProps, RelativeTime, type RelativeTimeFormatContext, type RelativeTimeProps, type RelativeTimeUnit, type RelativeTimeValue, ResourceGrid, type ResourceGridProps, type RgbColor, type RoutedEdge, type Row, RowAction, type RowActionProps, RowActions, type RowActionsProps, type RuleAction, type RuleActionDefinition, RuleBuilder, type RuleBuilderLabels, type RuleBuilderProps, type RuleCheck, type RuleCondition, type RuleDefinition, type RuleFieldDefinition, type RuleGroup, type RuleOperatorDefinition, type RuleSummaryWords, type RuleValidationIssue, type RuleValidationOptions, type RuleValueEditorProps, SaveStatus, type SaveStatusLabels, type SaveStatusProps, type SaveStatusState, type SavedViewItem, SavedViewMenu, type SavedViewMenuProps, type SavedViewSection, type SchedulingAgendaGroup, type SchedulingBand, SchedulingCalendar, type SchedulingCalendarDay, type SchedulingCalendarEntry, type SchedulingCalendarLabels, type SchedulingCalendarOverlay, type SchedulingCalendarProps, type SchedulingCalendarView, type SchedulingDatePart, type SchedulingEntryState, type SchedulingLegendItem, type SchedulingMarker, type SchedulingMarkerEmphasis, type SchedulingOverlayKind, type SchedulingOverlayPattern, type SchedulingStatus, SchedulingTimeline, type SchedulingTimelineGroup, type SchedulingTimelineItem, type SchedulingTimelineLabels, type SchedulingTimelineLane, type SchedulingTimelineMarker, type SchedulingTimelineOverlay, type SchedulingTimelineOverlayKind, type SchedulingTimelineProps, SearchBar, type SearchBarLabels, type SearchBarProps, type SearchSegment, SearchSuggest, type SearchSuggestAction, type SearchSuggestOption, type SearchSuggestProps, SectionHead, type SectionHeadProps, type Segment, Segmented, SegmentedOption, type SegmentedOptionProps, type SegmentedProps, Select, type SelectAllState, type SelectGroup, type SelectLabels, type SelectOption, type SelectProps, type ShellNav, Sidebar, type SidebarProps, SidebarSection, type SidebarSectionProps, Skeleton, type SkeletonProps, type SortDir, type SortDirection, type SortKey, Spinner, type SpinnerProps, StarButton, type StarButtonProps, Stat, StatLine, type StatLineItem, type StatLineProps, type StatProps, type StatTrend, type StateVariant, StatusPill, type StatusPillProps, StatusRow, type StatusRowProps, Step, type StepProps, type StepState, type StepStateLabels, Steps, type StepsProps, SubNavItem, type SubNavItemProps, type SummarizeFilterOptions, Switch, type SwitchProps, TEXT_FILTER_OPERATORS, TOAST_LEAVE_MS, TOP_LANE_CROSS_MIDNIGHT_MINUTES, Tab, TabPanel, type TabPanelProps, type TabProps, Table, type TableDensity, type TableProps, TableWrap, type TableWrapProps, Tabs, type TabsProps, Td, type TdProps, TextDiff, type TextDiffGranularity, type TextDiffLabels, type TextDiffLine, type TextDiffOp, type TextDiffOptions, type TextDiffProps, type TextDiffResult, type TextDiffRow, type TextDiffSegment, type TextFilterOperator, Textarea, type TextareaProps, Th, type ThProps, type TimeGridDayLayout, type TimeGridEntryContext, type TimeGridEntryInput, type TimeGridPart, type TimeGridSegment, Timeline, TimelineItem, type TimelineItemProps, type TimelineProps, type TimelineRange, type TimelineScale, type TimelineSpan, type TimelineSubTick, type TimelineTick, Toast, type ToastAction, type ToastApi, type ToastDismissReason, type ToastKind, type ToastOptions, type ToastPromiseMessages, type ToastProps, type ToastRecord, type ToastStore, type ToastTone, Toaster, type ToasterProps, ToggleRow, type ToggleRowProps, Tooltip, type TooltipProps, Tr, type TrProps, Tree, type TreeLabels, type TreeLike, type TreeNavAction, type TreeNodeData, type TreeNodeProps, type TreeProps, type UixLabels, UixLabelsProvider, type UixLabelsProviderProps, type UixLinkProps, type UixRenderLink, type UndoableToastOptions, type UseAnchoredPositionOptions, type UseTableOptions, type UseTableResult, type UseVirtualRowsOptions, type UseVirtualRowsResult, UserChip, type UserChipProps, ViewMenu, type ViewMenuColumn, type ViewMenuColumnLabels, type ViewMenuProps, type ViewState, type VirtualWindow, type ZonedDateSpan, type ZonedDayBounds, type ZonedDayShift, type ZonedDaySpan, type ZonedHourSlot, addCalendarDays, addCalendarMonths, addZonedDays, appendRuleNode, applyBrandProfile, applyFilters, ariaKeyShortcuts, boundRelationshipGraph, buildMonthGrid, buildThreeWayDiff, cachedDateTimeFormat, clampMetricValue, clampWidth, classifyLayeredEdges, clusterIdFor, contrastRatio, createToastApi, createToastStore, cx, dashboardGridClassName, dashboardGridItemClassName, dateOrder, datePattern, defaultTimelineStep, diffText, diffTokens, emptyFilterValue, enumerateDateKeys, enumerateDateSpan, fileKind, fileMatchesAccept, filterComboboxOptions, findRuleNodeDepth, flattenTree, foldForSearch, formatDateKey, formatFileSize, hexToRgb, highlightSegments, hsvToHex, hsvToRgb, isDateInRange, isDateUnavailable, isFilterEmpty, isRuleGroup, isValidDateKey, itemDaySpan, joinDateTime, layeredNeighbor, layoutDaySpans, layoutLane, layoutLayeredGraph, layoutMonthSpans, layoutRelationshipGraph, layoutTimeGridDay, mapRuleGroup, matchFilter, matchFilterPreset, meetsContrast, mergePinned, moveRuleNode, multiSort, nextSortDir, normalizeHex, packLanes, parseDateInput, parseDateValue, parseMetricValue, parseView, partitionFiles, pixelsToMs, placeSpan, placesInTopLane, proposeMove, rankOverflow, relationshipNeighbors, relativeTimeValue, removeRuleNode, renderPlainLink, reorder, restoreBrandProfile, rgbToHex, rgbToHsv, ruleDepth, schedulingGridDays, searchRows, searchSegments, selectAllState, selectRangeDate, serializeView, setRuleCombinator, shiftSpan, shouldVirtualize, snapToStep, splitDateTime, startOfMonth, stepMetricValue, summarizeDiff, summarizeFilter, summarizeRule, textDiffRows, timeZoneName, timelineRepeatedHourOffset, timelineStepDelta, timelineSubTicks, timelineTicks, toDateKey, toast, toggleId, togglePage, toggleSort, tokenizeText, traverseRelationshipNode, treeNav, useAnchoredPosition, useDialog, useTable, useUixLabels, useVirtualRows, validateRuleDefinition, virtualWindow, wrapEdgeLabel, zonedDateKey, zonedDateSpan, zonedDayBounds, zonedDaySpan, zonedHourSlots, zonedTimeOfDay };

package/dist/index.d.ts

@@ -11,6 +11,7 @@ export { Input, InputGroup, InputGroupProps, InputProps } from './components/Inp
 export { Combobox, ComboboxProps } from './components/Combobox.js';
 export { ComboboxOption, filterComboboxOptions } from './combobox-model.js';
 export { SearchSuggest, SearchSuggestAction, SearchSuggestOption, SearchSuggestProps } from './components/SearchSuggest.js';
+export { SearchBar, SearchBarLabels, SearchBarProps } from './components/SearchBar.js';
 export { DEFAULT_ENTITY_PICKER_LABELS, EntityPicker, EntityPickerLabels, EntityPickerProps, EntityPickerSearchResult } from './components/EntityPicker.js';
 export { FoldedText, SearchSegment, foldForSearch, searchSegments } from './search-suggest-model.js';
 export { Textarea, TextareaProps } from './components/Textarea.js';
@@ -23,6 +24,7 @@ export { Field, FieldProps } from './components/Field.js';
 export { Modal, ModalProps } from './components/Modal.js';
 export { ConfirmDialog, ConfirmDialogProps, Popconfirm, PopconfirmProps, PromptDialog, PromptDialogProps } from './components/Dialogs.js';
 export { Drawer, DrawerProps } from './components/Drawer.js';
+export { DialogClose, DialogCloseProps, DiscardPromptLabels } from './components/DiscardPrompt.js';
 export { Peek, PeekProps } from './components/Peek.js';
 export { DEFAULT_LIGHTBOX_LABELS, Lightbox, LightboxItem, LightboxLabels, LightboxProps } from './components/Lightbox.js';
 export { Card, CardLink, CardLinkProps, CardProps } from './components/Card.js';
@@ -60,7 +62,7 @@ export { Stat, StatProps, StatTrend } from './components/Stat.js';
 export { Bullet, BulletProps, DEFAULT_INSIGHT_CARD_LABELS, InsightCard, InsightCardLabels, InsightCardProps, InsightComparison, InsightCoverage, InsightKpi, InsightStatus, InsightStatusTone, InsightTarget } from './components/InsightCard.js';
 export { ChartStatPoint, LinearFit, PredictionBandPoint, linearFit, normalQuantile, predictionBand, quantiles, studentTQuantile } from './chart-stats.js';
 export { Chip, ChipGroup, ChipGroupProps, ChipProps } from './components/Chip.js';
-export { Kbd, KbdCombo, KbdComboProps, KbdPlatform, KbdProps } from './components/Kbd.js';
+export { Kbd, KbdCombo, KbdComboProps, KbdPlatform, KbdProps, KeyShortcut, ariaKeyShortcuts } from './components/Kbd.js';
 export { DEFAULT_STEP_STATE_LABELS, Step, StepProps, StepState, StepStateLabels, Steps, StepsProps } from './components/Steps.js';
 export { Tooltip, TooltipProps } from './components/Tooltip.js';
 export { InfoTip, InfoTipProps } from './components/InfoTip.js';

package/dist/index.js

@@ -11,6 +11,7 @@ import { Input, InputGroup } from "./components/Input.js";
 import { Combobox } from "./components/Combobox.js";
 import { filterComboboxOptions } from "./combobox-model.js";
 import { SearchSuggest } from "./components/SearchSuggest.js";
+import { SearchBar } from "./components/SearchBar.js";
 import { EntityPicker, DEFAULT_ENTITY_PICKER_LABELS } from "./components/EntityPicker.js";
 import { searchSegments, foldForSearch } from "./search-suggest-model.js";
 import { Textarea } from "./components/Textarea.js";
@@ -23,6 +24,7 @@ import { Field } from "./components/Field.js";
 import { Modal } from "./components/Modal.js";
 import { ConfirmDialog, Popconfirm, PromptDialog } from "./components/Dialogs.js";
 import { Drawer } from "./components/Drawer.js";
+import { DialogClose } from "./components/DiscardPrompt.js";
 import { Peek } from "./components/Peek.js";
 import { Lightbox, DEFAULT_LIGHTBOX_LABELS } from "./components/Lightbox.js";
 import { Card, CardLink } from "./components/Card.js";
@@ -74,7 +76,7 @@ import { Stat } from "./components/Stat.js";
 import { Bullet, DEFAULT_INSIGHT_CARD_LABELS, InsightCard } from "./components/InsightCard.js";
 import { linearFit, normalQuantile, predictionBand, quantiles, studentTQuantile } from "./chart-stats.js";
 import { Chip, ChipGroup } from "./components/Chip.js";
-import { Kbd, KbdCombo } from "./components/Kbd.js";
+import { Kbd, KbdCombo, ariaKeyShortcuts } from "./components/Kbd.js";
 import { Steps, Step, DEFAULT_STEP_STATE_LABELS } from "./components/Steps.js";
 import { Tooltip } from "./components/Tooltip.js";
 import { InfoTip } from "./components/InfoTip.js";
@@ -290,6 +292,7 @@ export {
   DescriptionList,
   DetailLayout,
   DetailPage,
+  DialogClose,
   DiffViewer,
   Drawer,
   EmptyState,
@@ -378,6 +381,7 @@ export {
   SavedViewMenu,
   SchedulingCalendar,
   SchedulingTimeline,
+  SearchBar,
   SearchSuggest,
   SectionHead,
   Segmented,
@@ -424,6 +428,7 @@ export {
   addZonedDays,
   appendRuleNode,
   applyBrandProfile,
+  ariaKeyShortcuts,
   boundRelationshipGraph,
   buildMonthGrid,
   buildThreeWayDiff,

package/dist/labels-context.d.ts

@@ -14,6 +14,8 @@ import { AttachmentLabels } from './attachment-labels.js';
 import { EntityPickerLabels } from './components/EntityPicker.js';
 import { TreeLabels } from './components/Tree.js';
 import { InlineEditLabels } from './components/InlineEdit.js';
+import { DiscardPromptLabels } from './components/DiscardPrompt.js';
+import { SearchBarLabels } from './components/SearchBar.js';
 import './link.js';
 import './calendar-model.js';
 import './scheduling-calendar-model.js';
@@ -26,6 +28,8 @@ import './json-value.js';
 import './rule-builder-model.js';
 import './file-model.js';
 import './components/SearchSuggest.js';
+import './components/Button.js';
+import './components/Kbd.js';
 
 /**
  * Kit chrome strings by component (HAR-1358; TENSOR C20, MOTUS executive summary #3).
@@ -43,6 +47,8 @@ interface UixLabels {
     drawer?: {
         close?: string;
     };
+    /** The "Discard changes?" step of a `dirty` Drawer or Modal (HAR-2029). */
+    discardPrompt?: Partial<DiscardPromptLabels>;
     peek?: {
         previous?: string;
         next?: string;
@@ -65,6 +71,8 @@ interface UixLabels {
     searchSuggest?: {
         clear?: string;
     };
+    /** `SearchBar` (HAR-2030): the clear button's name and the submit button's text. */
+    searchBar?: Partial<SearchBarLabels>;
     /** `resultsOne` / `resultsMany`: the polite result count; `{count}`. */
     commandPalette?: {
         input?: string;