@flood-md/react 0.2.9 → 0.2.11

package/dist/index.d.ts

@@ -1,4 +1,162 @@
 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;
+    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 +187,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;
@@ -116,6 +278,7 @@ export interface DataTableColumn {
     id: string;
     label: string;
     sortable?: boolean;
+    numeric?: boolean;
     align?: "start" | "end";
     width?: CSSProperties["width"];
 }
@@ -125,6 +288,15 @@ export interface DataTableRow {
     cells: Readonly<Record<string, ReactNode>>;
     sortValues?: Readonly<Record<string, string | number | null>>;
     selectionDisabled?: boolean;
+    /** 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;
@@ -146,6 +318,11 @@ export interface DataTableLabels {
     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;
+    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[];
@@ -165,6 +342,13 @@ 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;
+    /** 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;
@@ -289,6 +473,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 +528,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 +734,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 +750,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;
@@ -620,6 +916,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 +942,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 +970,8 @@ export interface TableProps extends Omit<TableHTMLAttributes<HTMLTableElement>,
     density?: DataDensity;
     striped?: boolean;
     scrollLabel?: string;
+    /** Shared cell alignment. Middle keeps mixed record/action rows coherent; top is an explicit prose-table choice. */
+    cellVerticalAlign?: "top" | "middle" | "bottom";
 }
 /** @since 0.2.4 */
 export declare const Table: import("react").ForwardRefExoticComponent<TableProps & import("react").RefAttributes<HTMLTableElement>>;
@@ -746,6 +1049,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;
@@ -837,9 +1141,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;
@@ -848,7 +1156,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;
@@ -860,6 +1168,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"> {
@@ -876,6 +1185,21 @@ 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";
@@ -893,6 +1217,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;
@@ -994,6 +1320,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[];
@@ -1006,7 +1333,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"> {
@@ -1073,6 +1420,8 @@ export interface LabelProps extends LabelHTMLAttributes<HTMLLabelElement> {
 export declare const Label: import("react").ForwardRefExoticComponent<LabelProps & import("react").RefAttributes<HTMLLabelElement>>;
 export interface FieldsetProps extends FieldsetHTMLAttributes<HTMLFieldSetElement> {
     legend: ReactNode;
+    /** Visual role only; compact choice captions remain the default. @since 0.2.10 */
+    legendSize?: "label" | "section";
     /** @since 0.2.3 */
     hideLabel?: boolean;
     hint?: ReactNode;
@@ -1097,9 +1446,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;
@@ -1236,6 +1589,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>>;
@@ -1396,6 +1751,51 @@ export interface SectionProps extends Omit<HTMLAttributes<HTMLElement>, "title">
     headingSize?: "display" | "large" | "page" | "section";
 }
 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"];
+    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;