@flood-md/react 0.2.10 → 0.2.12

package/dist/index.d.ts

@@ -1,4 +1,164 @@
 import { type ButtonHTMLAttributes, type InputHTMLAttributes, type TextareaHTMLAttributes, type SelectHTMLAttributes, type AnchorHTMLAttributes, type ReactNode, type HTMLAttributes, type CSSProperties, type LabelHTMLAttributes, type FieldsetHTMLAttributes, type RefCallback, type RefObject, type Ref, type MouseEvent as ReactMouseEvent, type TableHTMLAttributes, type ImgHTMLAttributes, type BlockquoteHTMLAttributes } from "react";
+export interface OverflowAction extends MenuActionItem {
+    /** Higher priority actions remain visible longer; source order stays unchanged. */
+    priority?: number;
+}
+export interface OverflowActionsProps extends Omit<HTMLAttributes<HTMLDivElement>, "children" | "onAction"> {
+    label: string;
+    items: readonly OverflowAction[];
+    onAction?: (id: string) => void;
+    moreLabel?: string;
+    size?: "sm" | "md" | "lg" | "xl";
+    variant?: ButtonProps["variant"];
+    shape?: ToolbarProps["shape"];
+    containerVariant?: ToolbarProps["variant"];
+    disabled?: boolean;
+    /** Optional fixed content measured before command space is allocated. */
+    leading?: ReactNode;
+    trailing?: ReactNode;
+    /** Upper bound for visible commands; additional commands remain in More. */
+    maxVisibleActions?: number;
+}
+/** Priority-based overflow composed from Toolbar, Button and Menu. @since 0.2.11 */
+export declare const OverflowActions: import("react").ForwardRefExoticComponent<OverflowActionsProps & import("react").RefAttributes<HTMLDivElement>>;
+export interface FilterConditionValue {
+    property: string;
+    operator: "is" | "is-not";
+    values: string[];
+}
+export interface FilterConditionProperty {
+    id: string;
+    label: string;
+    options: readonly ComboboxOption[];
+    disabled?: boolean;
+}
+export interface FilterConditionProps extends Omit<FieldsetProps, "children" | "legend" | "onChange"> {
+    label: string;
+    properties: readonly FilterConditionProperty[];
+    value: FilterConditionValue;
+    onValueChange: (value: FilterConditionValue) => void;
+    onRemove?: () => void;
+    controlSize?: "sm" | "md" | "lg" | "xl";
+    labels?: Partial<Record<"property" | "operator" | "values" | "include" | "exclude" | "placeholder" | "remove", string>>;
+}
+/** One finite-choice filter predicate; the host owns application and query semantics. @since 0.2.11 */
+export declare const FilterCondition: import("react").ForwardRefExoticComponent<FilterConditionProps & import("react").RefAttributes<HTMLFieldSetElement>>;
+export interface FilterGroupCondition extends FilterConditionValue {
+    id: string;
+}
+export interface FilterGroupValue {
+    match: "all" | "any";
+    conditions: FilterGroupCondition[];
+}
+export interface FilterGroupProps extends Omit<FieldsetProps, "children" | "legend" | "onChange"> {
+    label: string;
+    properties: readonly FilterConditionProperty[];
+    value: FilterGroupValue;
+    onValueChange: (value: FilterGroupValue) => void;
+    controlSize?: "sm" | "md" | "lg" | "xl";
+    allowDuplicateProperties?: boolean;
+    maxConditions?: number;
+    labels?: Partial<Record<"match" | "all" | "any" | "add" | "condition", string>>;
+    conditionLabels?: FilterConditionProps["labels"];
+}
+/** A flat controlled group of finite-choice predicates, without query execution or Apply/Cancel ownership. @since 0.2.11 */
+export declare const FilterGroup: import("react").ForwardRefExoticComponent<FilterGroupProps & import("react").RefAttributes<HTMLFieldSetElement>>;
+export interface CollectionFilterSummary {
+    id: string;
+    label: string;
+    removeLabel?: string;
+    disabled?: boolean;
+}
+export interface CollectionToolbarProps extends Omit<FieldsetProps, "children" | "legend" | "onChange"> {
+    label: string;
+    searchValue: string;
+    onSearchValueChange: (value: string) => void;
+    searchLabel?: string;
+    searchPlaceholder?: string;
+    clearSearchLabel?: string;
+    appliedFilters?: readonly CollectionFilterSummary[];
+    onRemoveFilter?: (id: string) => void;
+    appliedFiltersLabel?: string;
+    summaryPrefix?: ReactNode;
+    /** At most two task-important quick filters; move additional properties into filterContent. */
+    quickFilters?: ReactNode;
+    /** Additional commands beside Filters in the same tool row. */
+    actions?: ReactNode;
+    filterContent?: ReactNode;
+    filtersLabel?: string;
+    filterTitle?: string;
+    filtersOpen?: boolean;
+    onFiltersOpenChange?: (open: boolean) => void;
+    filterPanelRef?: Ref<HTMLDivElement>;
+    filterPanelClassName?: string;
+    onClear?: () => void;
+    canClear?: boolean;
+    clearLabel?: string;
+    controlSize?: "sm" | "md" | "lg" | "xl";
+}
+/** Search, accepted summaries and staged filter disclosure; saved views and query semantics stay host-owned. @since 0.2.11 */
+export declare const CollectionToolbar: import("react").ForwardRefExoticComponent<CollectionToolbarProps & import("react").RefAttributes<HTMLFieldSetElement>>;
+export interface CollectionViewOption {
+    id: string;
+    name: string;
+    disabled?: boolean;
+}
+export interface CollectionViewSwitcherProps extends Omit<HTMLAttributes<HTMLDivElement>, "children" | "onChange"> {
+    label: string;
+    views: readonly CollectionViewOption[];
+    value: string;
+    onValueChange: (id: string) => void;
+    actions?: readonly OverflowAction[];
+    onAction?: (id: string) => void;
+    actionsLabel?: string;
+    moreLabel?: string;
+    controlSize?: "sm" | "md" | "lg" | "xl";
+    disabled?: boolean;
+    /** Focus target for host-owned naming/deletion dialogs. */
+    selectRef?: Ref<HTMLSelectElement>;
+}
+/** Controlled saved/preset view choice with optional adaptive commands. @since 0.2.11 */
+export declare const CollectionViewSwitcher: import("react").ForwardRefExoticComponent<CollectionViewSwitcherProps & import("react").RefAttributes<HTMLDivElement>>;
+export interface BulkActionBarProps extends Omit<HTMLAttributes<HTMLDivElement>, "children" | "onAction"> {
+    label: string;
+    selectionCount: number;
+    /** Complete localized count, for example "2 selected". */
+    selectionLabel?: string;
+    /** Visible selection summary. Hidden counters do not reserve a slot. */
+    counter?: "label" | "number" | "none";
+    /** Reserved counter width; stable while selectionCount changes. */
+    counterWidth?: CSSProperties["inlineSize"];
+    items: readonly OverflowAction[];
+    onAction?: (id: string) => void;
+    onClear: () => void;
+    clearLabel?: string;
+    moreLabel?: string;
+    size?: "sm" | "md" | "lg" | "xl";
+    /** One to three visible commands; the default is two. */
+    maxVisibleActions?: 1 | 2 | 3;
+    disabled?: boolean;
+    pending?: boolean;
+}
+/** A bounded single-row selection command capsule. The host owns positioning and updates. @since 0.2.11 */
+export declare const BulkActionBar: import("react").ForwardRefExoticComponent<BulkActionBarProps & import("react").RefAttributes<HTMLDivElement>>;
+export interface MenubarMenu {
+    id: string;
+    label: string;
+    disabled?: boolean;
+    items: readonly MenuItem[];
+}
+export interface MenubarProps extends Omit<HTMLAttributes<HTMLDivElement>, "children" | "onAction"> {
+    label: string;
+    menus: readonly MenubarMenu[];
+    openValue?: string | null;
+    defaultOpenValue?: string | null;
+    onOpenValueChange?: (id: string | null) => void;
+    onAction?: (menuId: string, actionId: string) => void;
+    controlSize?: "sm" | "md" | "lg" | "xl";
+    disabled?: boolean;
+}
+/** Desktop application commands; destinations use native links instead. @since 0.2.11 */
+export declare const Menubar: import("react").ForwardRefExoticComponent<MenubarProps & import("react").RefAttributes<HTMLDivElement>>;
 export interface TimePickerProps extends Omit<TimeFieldProps, "end"> {
     interval?: number;
     open?: boolean;
@@ -29,6 +189,10 @@ export interface DateTimeRangePickerProps extends Omit<HTMLAttributes<HTMLDivEle
     startTimeLabel?: string;
     endDateLabel?: string;
     endTimeLabel?: string;
+    startDatePickerLabels?: DateTimePickerProps["datePickerLabels"];
+    endDatePickerLabels?: DateTimePickerProps["datePickerLabels"];
+    startTimePickerLabels?: DateTimePickerProps["timePickerLabels"];
+    endTimePickerLabels?: DateTimePickerProps["timePickerLabels"];
     form?: string;
     required?: boolean;
     disabled?: boolean;
@@ -115,9 +279,21 @@ export declare const ImagePreview: import("react").ForwardRefExoticComponent<Ima
 export interface DataTableColumn {
     id: string;
     label: string;
+    /** Short unit shown alongside the label, such as USD or kg. */
+    unit?: string;
     sortable?: boolean;
+    numeric?: boolean;
     align?: "start" | "end";
     width?: CSSProperties["width"];
+    /** Keep this column visible when the host or Columns menu hides other columns. */
+    hideable?: boolean;
+    /** Opt into pointer and keyboard width adjustments for this column. */
+    resizable?: boolean;
+    /** Interactive width bounds in CSS pixels. */
+    minWidth?: number;
+    maxWidth?: number;
+    /** Keep the column at a logical edge when the table scrolls horizontally. */
+    pinned?: "start" | "end";
 }
 export interface DataTableRow {
     id: string;
@@ -125,6 +301,17 @@ export interface DataTableRow {
     cells: Readonly<Record<string, ReactNode>>;
     sortValues?: Readonly<Record<string, string | number | null>>;
     selectionDisabled?: boolean;
+    /** Related detail rendered in a separate full-width row on disclosure. */
+    expandedContent?: ReactNode;
+    /** One named record-opening action. Other controls in the row remain independent. */
+    primaryAction?: {
+        column: string;
+        title: string;
+        description?: ReactNode;
+        buttonProps: Omit<ButtonProps, "children" | "type" | "variant" | "size"> & {
+            ref?: Ref<HTMLButtonElement>;
+        };
+    };
 }
 export interface DataTableSort {
     column: string;
@@ -140,19 +327,47 @@ export interface DataTableLabels {
     results?: (from: number, to: number, total: number) => string;
     selection?: (selected: number, total: number) => string;
     sort?: (label: string) => string;
+    columns?: string;
+    resetColumns?: string;
+    sortedColumn?: (label: string) => string;
+    resizeColumn?: (label: string) => string;
+    expandRow?: (label: string) => string;
+    collapseRow?: (label: string) => string;
+    rowDetails?: string;
     pagination?: string;
     previousPage?: string;
     nextPage?: string;
     page?: (page: number) => string;
 }
 export interface DataTableProps extends Omit<HTMLAttributes<HTMLDivElement>, "children"> {
+    /** Host-owned heading, search and filters aligned with the outer table cells. */
+    toolbar?: ReactNode | ((controls: {
+        columns: ReactNode;
+    }) => ReactNode);
+    inset?: "standard" | "roomy";
+    /** Ready with no rows only. Compose EmptyState/actions here; loading and error keep their owners. */
+    emptyContent?: ReactNode;
     caption: string;
     hideCaption?: boolean;
     columns: readonly DataTableColumn[];
+    showColumnVisibility?: boolean;
+    hiddenColumnIds?: readonly string[];
+    /** Initial hidden columns and the layout restored by Reset columns. */
+    defaultHiddenColumnIds?: readonly string[];
+    onHiddenColumnIdsChange?: (ids: string[]) => void;
+    columnWidths?: Readonly<Record<string, number>>;
+    defaultColumnWidths?: Readonly<Record<string, number>>;
+    onColumnWidthsChange?: (widths: Record<string, number>) => void;
     rows: readonly DataTableRow[];
+    expandedIds?: readonly string[];
+    defaultExpandedIds?: readonly string[];
+    onExpandedChange?: (ids: string[]) => void;
     density?: "compact" | "comfortable";
     striped?: boolean;
     minWidth?: CSSProperties["minWidth"];
+    /** Maximum height of the scroll viewport, including the header. */
+    maxViewportHeight?: CSSProperties["maxBlockSize"];
+    stickyHeader?: boolean;
     sort?: DataTableSort | null;
     defaultSort?: DataTableSort | null;
     onSortChange?: (sort: DataTableSort | null) => void;
@@ -165,12 +380,35 @@ export interface DataTableProps extends Omit<HTMLAttributes<HTMLDivElement>, "ch
     defaultPage?: number;
     pageSize?: number;
     onPageChange?: (page: number) => void;
+    /** Hide the result range while preserving selection and pagination controls. */
+    showResults?: boolean;
+    /** Hide the visible selection count while retaining its accessible status. */
+    showSelection?: boolean;
+    /** Server mode renders rows as the supplied page, without local sorting/slicing. */
+    paginationMode?: "client" | "server";
+    totalRows?: number;
+    /** Server dataset selection is controlled; the host validates IDs outside this page. */
+    selectionScope?: "page" | "dataset";
     state?: "ready" | "loading" | "error";
     onRetry?: () => void;
     labels?: DataTableLabels;
 }
 /** A client-side table composed from native table, checkbox and pagination. @since 0.2.8 */
 export declare const DataTable: import("react").ForwardRefExoticComponent<DataTableProps & import("react").RefAttributes<HTMLDivElement>>;
+export interface SparklineProps extends Omit<HTMLAttributes<HTMLDivElement>, "children" | "role" | "aria-label" | "aria-labelledby"> {
+    /** Equally spaced observations in order. Missing or nonfinite values break the line. */
+    values: readonly (number | null)[];
+    /** Localized text conveying the trend or the absence of data. */
+    label: string;
+    showLabel?: boolean;
+    /** Shared lower and upper bounds for comparisons. Values outside the bounds are clipped. */
+    domain?: readonly [number, number];
+    size?: "sm" | "md";
+    tone?: "neutral" | "accent" | "success" | "warning" | "error";
+    variant?: "line" | "area";
+}
+/** @since 0.2.11 */
+export declare const Sparkline: import("react").ForwardRefExoticComponent<SparklineProps & import("react").RefAttributes<HTMLDivElement>>;
 export interface DataListProps extends Omit<HTMLAttributes<HTMLUListElement>, "role"> {
     density?: "compact" | "comfortable";
     dividers?: boolean;
@@ -289,6 +527,8 @@ export interface DateTimePickerProps extends Omit<HTMLAttributes<HTMLDivElement>
     onValueChange?: (value: DateTimeValue) => void;
     dateLabel?: string;
     timeLabel?: string;
+    datePickerLabels?: Pick<DatePickerProps, "calendarLabel" | "openCalendarLabel" | "previousMonthLabel" | "nextMonthLabel" | "viewLabels" | "segmentLabels" | "messages">;
+    timePickerLabels?: Pick<TimePickerProps, "panelLabel" | "openTimeLabel" | "segmentLabels" | "messages">;
     dateName?: string;
     timeName?: string;
     form?: string;
@@ -342,28 +582,136 @@ export interface TreeProps extends Omit<HTMLAttributes<HTMLDivElement>, "childre
 }
 /** @since 0.2.7 */
 export declare const Tree: import("react").ForwardRefExoticComponent<TreeProps & import("react").RefAttributes<HTMLDivElement>>;
+export interface NavigationItemDisclosure {
+    expanded: boolean;
+    onExpandedChange: (expanded: boolean) => void;
+    label: string;
+    controls?: string;
+    disabled?: boolean;
+}
+export interface NavigationItemProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children' | 'onChange'> {
+    label: string;
+    description?: string;
+    icon?: ReactNode;
+    reserveIcon?: boolean;
+    trailing?: ReactNode;
+    /** Independent action rendered beside the primary control in expanded rows. */
+    trailingAction?: ReactNode;
+    href?: string;
+    linkProps?: Omit<AnchorHTMLAttributes<HTMLAnchorElement>, 'href' | 'children' | 'aria-current'>;
+    onAction?: () => void;
+    actionProps?: Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'children'>;
+    disclosure?: NavigationItemDisclosure;
+    current?: boolean;
+    currentKind?: 'page' | 'location';
+    ancestorCurrent?: boolean;
+    disabled?: boolean;
+    size?: 'sm' | 'md' | 'lg';
+    compact?: boolean;
+    variant?: 'quiet' | 'standard';
+    tooltip?: boolean;
+    tooltipSide?: 'left' | 'right';
+    controlRef?: Ref<HTMLElement>;
+    disclosureRef?: Ref<HTMLButtonElement>;
+}
+/** Shared navigation row geometry and native destination/action behavior. @since 0.2.11 */
+export declare const NavigationItem: import("react").ForwardRefExoticComponent<NavigationItemProps & import("react").RefAttributes<HTMLDivElement>>;
+export interface NavigationGroupProps extends Omit<HTMLAttributes<HTMLDivElement>, "children" | "title" | "onChange"> {
+    label?: string;
+    hideLabel?: boolean;
+    headingAction?: ReactNode;
+    separator?: boolean;
+    collapsible?: boolean;
+    expanded?: boolean;
+    defaultExpanded?: boolean;
+    onExpandedChange?: (expanded: boolean) => void;
+    compact?: boolean;
+    size?: "sm" | "md" | "lg";
+    collapseDisabled?: boolean;
+    children?: ReactNode;
+}
+/** Related navigation with independently configurable presentation. @since 0.2.11 */
+export declare const NavigationGroup: import("react").ForwardRefExoticComponent<NavigationGroupProps & import("react").RefAttributes<HTMLDivElement>>;
 export interface NavigationTreeItem {
     value: string;
     label: string;
     href?: string;
     icon?: ReactNode;
+    trailing?: ReactNode;
+    trailingAction?: ReactNode;
     disabled?: boolean;
     children?: readonly NavigationTreeItem[];
     content?: ReactNode;
+    flyout?: {
+        openOnHover?: boolean;
+        positionReference?: RefObject<HTMLElement | null>;
+    };
     linkProps?: Omit<AnchorHTMLAttributes<HTMLAnchorElement>, "href" | "children" | "aria-current">;
 }
 export interface NavigationTreeProps extends Omit<HTMLAttributes<HTMLElement>, "children" | "onChange"> {
     label: string;
     items: readonly NavigationTreeItem[];
     currentValue?: string;
+    /** Page destination versus the current global module/location. */
+    currentKind?: "page" | "location";
     expandedValues?: readonly string[];
     defaultExpandedValues?: readonly string[];
     onExpandedValuesChange?: (values: string[]) => void;
     expandLabel?: (item: NavigationTreeItem, expanded: boolean) => string;
     size?: ContentSize;
+    variant?: "quiet" | "standard";
+    /** Icon rail; branches open a Popover without changing the accepted expansion set. */
+    compact?: boolean;
+    flyoutSide?: "left" | "right";
+    branchGuides?: boolean;
 }
 /** @since 0.2.7 */
 export declare const NavigationTree: import("react").ForwardRefExoticComponent<NavigationTreeProps & import("react").RefAttributes<HTMLElement>>;
+export interface SidebarGroup {
+    id: string;
+    label: string;
+    /** Keep the navigation name while omitting a redundant visible section title. */
+    hideLabel?: boolean;
+    separator?: boolean;
+    branchGuides?: boolean;
+    headingAction?: ReactNode;
+    collapsible?: boolean;
+    expanded?: boolean;
+    defaultExpanded?: boolean;
+    onExpandedChange?: (expanded: boolean) => void;
+    items: readonly NavigationTreeItem[];
+}
+export interface SidebarSlotState {
+    collapsed: boolean;
+}
+export interface SidebarProps extends Omit<HTMLAttributes<HTMLElement>, "children" | "onChange"> {
+    label: string;
+    groups: readonly SidebarGroup[];
+    currentValue?: string;
+    currentKind?: NavigationTreeProps["currentKind"];
+    collapsed?: boolean;
+    defaultCollapsed?: boolean;
+    onCollapsedChange?: (collapsed: boolean) => void;
+    collapsible?: boolean;
+    collapseLabel?: string;
+    expandLabel?: string;
+    expandedValues?: readonly string[];
+    defaultExpandedValues?: readonly string[];
+    onExpandedValuesChange?: (values: string[]) => void;
+    expandItemLabel?: NavigationTreeProps["expandLabel"];
+    size?: ContentSize;
+    /** Quiet recedes behind work content; standard preserves the stronger pill recipe. */
+    variant?: "quiet" | "standard";
+    side?: "start" | "end";
+    width?: CSSProperties["width"];
+    header?: ReactNode | ((state: SidebarSlotState) => ReactNode);
+    headerLayout?: "stacked" | "inline";
+    footer?: ReactNode | ((state: SidebarSlotState) => ReactNode);
+    footerSeparator?: boolean;
+    headerSeparator?: boolean;
+}
+/** Bounded desktop navigation composed from NavigationTree and ScrollArea. @since 0.2.11 */
+export declare const Sidebar: import("react").ForwardRefExoticComponent<SidebarProps & import("react").RefAttributes<HTMLElement>>;
 export interface ErrorSummaryItem {
     id: string;
     fieldId: string;
@@ -440,6 +788,7 @@ export interface DateRangePickerProps extends Omit<DateRangeFieldProps, "end"> {
     onOpenChange?: (open: boolean) => void;
     calendarLabel?: string;
     openCalendarLabel?: string;
+    viewLabels?: CalendarProps["viewLabels"];
     locale?: string;
     weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
     today?: string;
@@ -455,6 +804,7 @@ export interface DatePickerProps extends Omit<DateFieldProps, "end"> {
     onOpenChange?: (open: boolean) => void;
     calendarLabel?: string;
     openCalendarLabel?: string;
+    viewLabels?: CalendarProps["viewLabels"];
     locale?: string;
     weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
     today?: string;
@@ -602,6 +952,12 @@ export interface EditableProps extends Omit<HTMLAttributes<HTMLDivElement>, "def
     onEditingChange?: (editing: boolean) => void;
     onCommit?: (value: string) => void;
     onCancel?: () => void;
+    /** Return a message to keep the draft open and prevent a commit. */
+    validate?: (value: string) => string | undefined;
+    inputMode?: InputHTMLAttributes<HTMLInputElement>["inputMode"];
+    previewVariant?: "subtle" | "ghost";
+    /** Render the editor over its trigger at this preferred width. */
+    editorOverlayWidth?: CSSProperties["inlineSize"];
     blurAction?: "commit" | "cancel" | "none";
     readOnly?: boolean;
     disabled?: boolean;
@@ -620,6 +976,7 @@ export declare const Editable: import("react").ForwardRefExoticComponent<Editabl
 export type ControlSize = "2xs" | "xs" | "sm" | "md" | "lg" | "xl" | "2xl";
 export interface ButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
     variant?: "solid" | "subtle" | "outline" | "ghost";
+    tone?: "default" | "danger";
     size?: ControlSize;
     loading?: boolean;
 }
@@ -645,6 +1002,10 @@ export interface ToolbarProps extends Omit<HTMLAttributes<HTMLDivElement>, "role
     label: string;
     orientation?: "horizontal" | "vertical";
     loop?: boolean;
+    /** Pill keeps a single horizontal rail; rounded permits wrapped tool groups. */
+    shape?: "rounded" | "pill";
+    /** Plain groups keep control height without another surface or outer inset. */
+    variant?: "contained" | "plain";
 }
 /** @since 0.2.4 */
 export declare const Toolbar: import("react").ForwardRefExoticComponent<ToolbarProps & import("react").RefAttributes<HTMLDivElement>>;
@@ -669,6 +1030,9 @@ export interface TableProps extends Omit<TableHTMLAttributes<HTMLTableElement>,
     density?: DataDensity;
     striped?: boolean;
     scrollLabel?: string;
+    /** Maximum height of the scroll viewport, including the header and caption. */
+    maxViewportHeight?: CSSProperties["maxBlockSize"];
+    stickyHeader?: boolean;
     /** Shared cell alignment. Middle keeps mixed record/action rows coherent; top is an explicit prose-table choice. */
     cellVerticalAlign?: "top" | "middle" | "bottom";
 }
@@ -748,6 +1112,7 @@ export interface TabsProps extends Omit<HTMLAttributes<HTMLDivElement>, "childre
     onValueChange?: (value: string) => void;
     activationMode?: "automatic" | "manual";
     orientation?: "horizontal" | "vertical";
+    variant?: "contained" | "line";
     controlSize?: "sm" | "md" | "lg" | "xl";
     disabled?: boolean;
     iconOnly?: boolean;
@@ -839,9 +1204,13 @@ export interface MenuProps extends Omit<HTMLAttributes<HTMLDivElement>, "childre
 }
 /** @since 0.2.4 */
 export declare const Menu: import("react").ForwardRefExoticComponent<MenuProps & import("react").RefAttributes<HTMLDivElement>>;
+export interface TooltipTriggerProps extends HTMLAttributes<HTMLElement> {
+    ref: RefCallback<HTMLElement>;
+}
 export interface TooltipProps extends Omit<HTMLAttributes<HTMLDivElement>, "children" | "content" | "title" | "role"> {
     content: string;
-    trigger: (props: OverlayTriggerProps) => ReactNode;
+    /** Native link/button-safe hover/focus props; the trigger keeps its own semantics. */
+    trigger: (props: TooltipTriggerProps) => ReactNode;
     side?: "top" | "bottom" | "left" | "right";
     align?: "start" | "center" | "end";
     delay?: number;
@@ -850,7 +1219,7 @@ export interface TooltipProps extends Omit<HTMLAttributes<HTMLDivElement>, "chil
 export declare const Tooltip: import("react").ForwardRefExoticComponent<TooltipProps & import("react").RefAttributes<HTMLDivElement>>;
 export interface PopoverProps extends Omit<HTMLAttributes<HTMLDivElement>, "children" | "title" | "role"> {
     title: string;
-    chrome?: "default" | "minimal";
+    chrome?: "default" | "minimal" | "title-only";
     trigger: (props: OverlayTriggerProps) => ReactNode;
     children?: ReactNode;
     open?: boolean;
@@ -862,6 +1231,7 @@ export interface PopoverProps extends Omit<HTMLAttributes<HTMLDivElement>, "chil
     closeLabel?: string;
     initialFocusRef?: RefObject<HTMLElement | null>;
     positionReference?: RefObject<HTMLElement | null>;
+    focusOnOpen?: boolean;
 }
 export declare const Popover: import("react").ForwardRefExoticComponent<PopoverProps & import("react").RefAttributes<HTMLDivElement>>;
 export interface DialogProps extends Omit<HTMLAttributes<HTMLDialogElement>, "children" | "title" | "role"> {
@@ -878,12 +1248,30 @@ export interface DialogProps extends Omit<HTMLAttributes<HTMLDialogElement>, "ch
     initialFocusRef?: RefObject<HTMLElement | null>;
 }
 export declare const Dialog: import("react").ForwardRefExoticComponent<DialogProps & import("react").RefAttributes<HTMLDialogElement>>;
+export interface CommandPaletteProps extends Omit<DialogProps, "children" | "description" | "initialFocusRef"> {
+    searchLabel: string;
+    items: readonly CommandListItem[];
+    density?: "comfortable" | "compact";
+    query?: string;
+    defaultQuery?: string;
+    onQueryChange?: (query: string) => void;
+    onAction: (id: string) => void;
+    loading?: boolean;
+    placeholder?: string;
+    emptyMessage?: string;
+    loadingMessage?: string;
+}
+/** @since 0.2.11 */
+export declare const CommandPalette: import("react").ForwardRefExoticComponent<CommandPaletteProps & import("react").RefAttributes<HTMLDialogElement>>;
 export interface DrawerProps extends DialogProps {
     side?: "start" | "end" | "top" | "bottom";
     size?: "sm" | "md" | "lg";
     footer?: ReactNode;
 }
 export declare const Drawer: import("react").ForwardRefExoticComponent<DrawerProps & import("react").RefAttributes<HTMLDialogElement>>;
+export type SheetProps = Omit<DrawerProps, "side">;
+/** A modal bottom sheet for a short task or a list of choices. @since 0.2.12 */
+export declare const Sheet: import("react").ForwardRefExoticComponent<SheetProps & import("react").RefAttributes<HTMLDialogElement>>;
 export interface AlertDialogProps extends Omit<DialogProps, "children" | "role" | "description" | "closeLabel" | "closeOnOutsideClick" | "initialFocusRef"> {
     description: string;
     confirmLabel?: string;
@@ -895,6 +1283,8 @@ export interface AlertDialogProps extends Omit<DialogProps, "children" | "role"
 export declare const AlertDialog: import("react").ForwardRefExoticComponent<AlertDialogProps & import("react").RefAttributes<HTMLDialogElement>>;
 export interface CollapsibleProps extends Omit<HTMLAttributes<HTMLDivElement>, "title" | "onChange"> {
     title: string;
+    /** Independent action beside the disclosure trigger, never nested inside it. */
+    headerAction?: ReactNode;
     open?: boolean;
     defaultOpen?: boolean;
     onOpenChange?: (open: boolean) => void;
@@ -996,6 +1386,7 @@ export interface ComboboxOption {
     description?: string;
     keywords?: readonly string[];
     disabled?: boolean;
+    group?: string;
 }
 export interface ComboboxProps extends Omit<InputProps, "type" | "value" | "defaultValue" | "onChange" | "children"> {
     options: readonly ComboboxOption[];
@@ -1008,7 +1399,27 @@ export interface ComboboxProps extends Omit<InputProps, "type" | "value" | "defa
     toggleLabel?: string;
     clearLabel?: string;
     invalidSelectionMessage?: string;
+    query?: string;
+    onQueryChange?: (query: string) => void;
+    /** Manual results require a controlled query and a matching optionsQuery. */
+    filtering?: "local" | "manual";
+    optionsQuery?: string;
+    /** Retain the selected record's presentation while remote results change. */
+    selectedOptions?: readonly ComboboxOption[];
+    loadState?: "ready" | "loading" | "error";
+    loadingMessage?: string;
+    errorMessage?: string;
+    onRetry?: () => void;
+    retryLabel?: string;
 }
+export interface AutocompleteProps extends Omit<ComboboxProps, "query" | "onQueryChange" | "selectedOptions" | "value" | "defaultValue" | "onValueChange"> {
+    value?: string;
+    defaultValue?: string;
+    onValueChange?: (value: string) => void;
+    onOptionSelect?: (option: ComboboxOption) => void;
+}
+/** A free text field with suggestions; FormData contains text rather than an option ID. @since 0.2.11 */
+export declare const Autocomplete: import("react").ForwardRefExoticComponent<AutocompleteProps & import("react").RefAttributes<HTMLInputElement>>;
 /** @since 0.2.5 */
 export declare const Combobox: import("react").ForwardRefExoticComponent<ComboboxProps & import("react").RefAttributes<HTMLInputElement>>;
 export interface MultiSelectProps extends Omit<ComboboxProps, "value" | "defaultValue" | "onValueChange"> {
@@ -1101,9 +1512,13 @@ export interface RadioGroupProps extends Omit<FieldsetProps, "children" | "defau
     required?: boolean;
 }
 export declare const RadioGroup: import("react").ForwardRefExoticComponent<RadioGroupProps & import("react").RefAttributes<HTMLFieldSetElement>>;
+export interface SegmentedControlOption extends ToggleOption {
+    /** Optional visible count read with the label. Format localized counts before passing them. @since 0.2.11 */
+    count?: number | string;
+}
 export interface SegmentedControlProps extends Omit<RadioGroupProps, "legend" | "options"> {
     label: string;
-    options: readonly ToggleOption[];
+    options: readonly SegmentedControlOption[];
     controlSize?: "sm" | "md" | "lg" | "xl";
     iconOnly?: boolean;
     fullWidth?: boolean;
@@ -1155,7 +1570,7 @@ export interface TextProps extends HTMLAttributes<HTMLElement> {
 export declare const Text: import("react").ForwardRefExoticComponent<TextProps & import("react").RefAttributes<HTMLElement>>;
 export interface HeadingProps extends HTMLAttributes<HTMLHeadingElement> {
     level?: 1 | 2 | 3 | 4 | 5 | 6;
-    size?: "display" | "large" | "page" | "section";
+    size?: "display" | "large" | "page" | "section" | "group";
 }
 export declare const Heading: import("react").ForwardRefExoticComponent<HeadingProps & import("react").RefAttributes<HTMLHeadingElement>>;
 export type Space = "0" | "1" | "2" | "3" | "4" | "6" | "8" | "12";
@@ -1240,6 +1655,8 @@ export interface IconSlotProps extends HTMLAttributes<HTMLSpanElement> {
 export declare const IconSlot: import("react").ForwardRefExoticComponent<IconSlotProps & import("react").RefAttributes<HTMLSpanElement>>;
 export interface IconButtonProps extends Omit<ButtonProps, "aria-label"> {
     label: string;
+    /** Glyph size only; size continues to own the interactive target and insets. */
+    iconSize?: ControlSize;
 }
 export declare const IconButton: import("react").ForwardRefExoticComponent<IconButtonProps & import("react").RefAttributes<HTMLButtonElement>>;
 export declare const Divider: import("react").ForwardRefExoticComponent<HTMLAttributes<HTMLHRElement> & import("react").RefAttributes<HTMLHRElement>>;
@@ -1397,9 +1814,56 @@ export interface SectionProps extends Omit<HTMLAttributes<HTMLElement>, "title">
     description?: ReactNode;
     actions?: ReactNode;
     headingLevel?: 2 | 3 | 4 | 5 | 6;
-    headingSize?: "display" | "large" | "page" | "section";
+    headingSize?: HeadingProps["size"];
 }
 export declare const Section: import("react").ForwardRefExoticComponent<SectionProps & import("react").RefAttributes<HTMLElement>>;
+export interface PageHeaderProps extends Omit<HTMLAttributes<HTMLElement>, "title" | "children"> {
+    title: string;
+    description?: ReactNode;
+    actions?: ReactNode;
+    headingId?: string;
+    /** Use level 2 when showing a page header inside an existing document outline. */
+    headingLevel?: 1 | 2;
+    headingSize?: "page" | "large" | "display";
+}
+/** The primary heading and associated actions inside a page's main region. @since 0.2.11 */
+export declare const PageHeader: import("react").ForwardRefExoticComponent<PageHeaderProps & import("react").RefAttributes<HTMLElement>>;
+export interface AppTopBarProps extends Omit<HTMLAttributes<HTMLElement>, "children"> {
+    start?: ReactNode;
+    end?: ReactNode;
+    bordered?: boolean;
+}
+/** Persistent application chrome with independent context and action slots. @since 0.2.11 */
+export declare const AppTopBar: import("react").ForwardRefExoticComponent<AppTopBarProps & import("react").RefAttributes<HTMLElement>>;
+export interface AppShellNavigationDrawer {
+    /** Switch below this shell width in CSS pixels. */
+    below: number;
+    title: string;
+    triggerLabel?: string;
+    size?: DrawerProps["size"];
+    renderContent: (close: () => void) => ReactNode;
+}
+export interface AppShellProps extends HTMLAttributes<HTMLDivElement> {
+    navigation?: ReactNode;
+    navigationSide?: "start" | "end";
+    navigationDrawer?: AppShellNavigationDrawer;
+    /** Render function places the shell's responsive trigger in a custom top bar. */
+    topBar?: ReactNode | ((navigationTrigger: ReactNode) => ReactNode);
+    footer?: ReactNode;
+    scroll?: "content" | "page";
+    mainId?: string;
+    /** Use section when embedding a shell inside an existing main landmark. */
+    mainAs?: "main" | "section";
+    mainLabel?: string;
+    mainRef?: Ref<HTMLElement>;
+    scrollLabel?: string;
+    scrollOrientation?: ScrollAreaProps["orientation"];
+    /** Keep the content width stable with "none" when the layout already clears the overlay rails. */
+    scrollContentInset?: ScrollAreaProps["contentInset"];
+    skipLabel?: string;
+}
+/** Composes application navigation and a main landmark with optional bounded scrolling. @since 0.2.11 */
+export declare const AppShell: import("react").ForwardRefExoticComponent<AppShellProps & import("react").RefAttributes<HTMLDivElement>>;
 export interface SplitProps extends Omit<HTMLAttributes<HTMLDivElement>, "children"> {
     main: ReactNode;
     aside: ReactNode;