@capra/core 1.12.0 → 1.14.0

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import * as React$2 from "react";
-import React$1, { HTMLAttributeAnchorTarget, HTMLAttributeReferrerPolicy } from "react";
+import React$1, { HTMLAttributeAnchorTarget, HTMLAttributeReferrerPolicy, ReactNode } from "react";
 import { SvgIcon } from "@capra/icons";
-import { BreadcrumbProps as BreadcrumbProps$1, BreadcrumbsProps as BreadcrumbsProps$1, ButtonProps as ButtonProps$1, ComboBoxRenderProps, DatePickerProps, DateRangePickerProps, DateValue, DisclosureProps, Focusable, Key, LinkProps as LinkProps$1, ListBoxItemProps, PopoverProps as PopoverProps$1, PressEvent, RouterProvider } from "react-aria-components";
+import { BreadcrumbProps as BreadcrumbProps$1, BreadcrumbsProps as BreadcrumbsProps$1, ButtonProps as ButtonProps$1, ColumnProps, ComboBoxRenderProps, DatePickerProps, DateRangePickerProps, DateValue, DisclosureProps, Focusable, Key, Key as Key$1, LinkProps as LinkProps$1, ListBoxItemProps, PopoverProps as PopoverProps$1, PressEvent, RouterProvider, Selection, SelectionMode, SortDescriptor, ToggleButtonGroupProps as ToggleButtonGroupProps$1 } from "react-aria-components";
 import { SvgLogo } from "@capra/icons/logos";
 //#region src/utils/stylingOverride.d.ts
 interface StylingOverrideProps {
@@ -23,7 +23,7 @@ interface StylingOverrideProps {
 declare const layouts: readonly ['section', 'compact', 'inline'];
 type Layout = (typeof layouts)[number];
 declare const appearances$3: readonly ['info', 'warning', 'danger', 'success'];
-type Appearance$3 = (typeof appearances$3)[number];
+type Appearance$4 = (typeof appearances$3)[number];
 type AlertProps = {
   /**
    * The layout of the alert.
@@ -49,7 +49,7 @@ type AlertProps = {
    *   <li>'success' - Success alerts confirm an action has been completed.</li>
    * </ul>
    */
-  appearance?: Appearance$3;
+  appearance?: Appearance$4;
   /**
    * The title of the alert. This is optional.
    */
@@ -88,21 +88,21 @@ declare function Alert({ appearance, layout, title, children, action, onDismiss,
 //#endregion
 //#region src/components/TextInput/TextInput.d.ts
 declare const appearances$2: readonly ['default', 'danger', 'warning'];
-type Appearance$2 = (typeof appearances$2)[number];
+type Appearance$3 = (typeof appearances$2)[number];
 declare const sizes$2: readonly ['sm', 'md'];
-type Size$3 = (typeof sizes$2)[number];
+type Size$4 = (typeof sizes$2)[number];
 type TextInputProps = {
   /** Appearance of the input.
    * @default 'default'
    */
-  appearance?: Appearance$2;
+  appearance?: Appearance$3;
   /** Content before the input (e.g. icon). */
   leadingSlot?: React$2.ReactNode;
   /**
    * Size of the input.
    * @default 'md'
    */
-  size?: Size$3;
+  size?: Size$4;
   /** Content after the input (e.g. icon or clear button). */
   trailingSlot?: React$2.ReactNode;
 } & StylingOverrideProps & Omit<React$2.ComponentPropsWithoutRef<'input'>, 'className' | 'style' | 'size'>;
@@ -113,18 +113,23 @@ declare const TextInput: React$2.ForwardRefExoticComponent<{
   /** Appearance of the input.
    * @default 'default'
    */
-  appearance?: Appearance$2;
+  appearance?: Appearance$3;
   /** Content before the input (e.g. icon). */
   leadingSlot?: React$2.ReactNode;
   /**
    * Size of the input.
    * @default 'md'
    */
-  size?: Size$3;
+  size?: Size$4;
   /** Content after the input (e.g. icon or clear button). */
   trailingSlot?: React$2.ReactNode;
 } & StylingOverrideProps & Omit<Omit<React$2.DetailedHTMLProps<React$2.InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref">, "className" | "size" | "style"> & React$2.RefAttributes<HTMLInputElement>>;
 //#endregion
+//#region src/components/input-helpers/ChildrenOrFunction.d.ts
+type ChildrenOrFunction$1<T> = ReactNode | ((values: T & {
+  defaultChildren: ReactNode | undefined;
+}) => ReactNode);
+//#endregion
 //#region src/components/input-helpers/fieldLayout.d.ts
 type FieldLayoutProps = {
   /** Helper text below the field. Replaced by error message when status is error. Use for requirements, disclaimers. */
@@ -139,9 +144,7 @@ type FieldLayoutProps = {
 type AutocompleteItem = {
   value: string;
 };
-type ChildrenOrFunction<T> = React$1.ReactNode | ((values: T & {
-  defaultChildren: React$1.ReactNode | undefined;
-}) => React$1.ReactNode);
+type ChildrenOrFunction<T> = ChildrenOrFunction$1<T>;
 type AutocompleteFieldProps = {
   /** Whether to show a clear button for the input. */
   canClear?: boolean;
@@ -185,9 +188,9 @@ declare const AutocompleteField: ((props: {
   /** Whether to automatically size the dropdown to the width of the input. Defaults to `true` */
   shouldAutoSizeDropdown?: boolean;
 } & StylingOverrideProps & FieldLayoutProps & Omit<Omit<{
-  appearance?: Appearance$2;
+  appearance?: Appearance$3;
   leadingSlot?: React$1.ReactNode;
-  size?: Size$3;
+  size?: Size$4;
   trailingSlot?: React$1.ReactNode;
 } & StylingOverrideProps & Omit<Omit<React$1.DetailedHTMLProps<React$1.InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref">, "className" | "size" | "style"> & React$1.RefAttributes<HTMLInputElement>, "ref">, "onChange" | "value"> & React$1.RefAttributes<HTMLInputElement>) => React$1.ReactElement) & {
   Item: typeof AutocompleteItem;
@@ -306,7 +309,19 @@ type LabelProp = {
 type AccessibleLabelProps = LabelledByProp | LabelProp;
 //#endregion
 //#region src/components/Badge/Badge.d.ts
-type AccessibleBadgeProps = AccessibleLabelProps & {
+type NamedBadgeProps = AccessibleLabelProps & {
+  decorative?: never;
+};
+type DecorativeBadgeProps = {
+  /**
+   * Marks the badge as purely decorative, removing it from the accessibility tree.
+   * Must not be combined with 'aria-label' or 'aria-labelledby'.
+   */
+  decorative: true;
+  'aria-label'?: never;
+  'aria-labelledby'?: never;
+};
+type AccessibleBadgeProps = (NamedBadgeProps | DecorativeBadgeProps) & {
   'aria-live'?: React$2.AriaAttributes['aria-live'];
 };
 declare const badgeSizes: readonly ['sm', 'md'];
@@ -339,11 +354,11 @@ type BadgeProps = {
    * The number to display in the badge when the count is greater than the overflow count. Default is 99.
    */
   overflowCount?: number;
-} & StylingOverrideProps & AccessibleBadgeProps & Omit<React$2.ComponentPropsWithoutRef<'span'>, 'className' | 'role' | 'aria-label' | 'aria-labelledby' | 'aria-live'>;
+} & StylingOverrideProps & AccessibleBadgeProps & Omit<React$2.ComponentPropsWithoutRef<'span'>, 'className' | 'role' | 'aria-label' | 'aria-labelledby' | 'aria-live' | 'aria-hidden'>;
 /**
  * Badges display an indicator/counter on an associated component.
  */
-declare function Badge({ appearance, variant, size, count, showZero, overflowCount, FORCE__className, style, ...props }: BadgeProps): React$2.JSX.Element | null;
+declare function Badge({ appearance, variant, size, count, showZero, overflowCount, decorative, 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledBy, FORCE__className, style, ...props }: BadgeProps): React$2.JSX.Element | null;
 type BadgeLayoutProps = React$2.PropsWithChildren<{
   offset?: readonly [x: number, y: number];
 }>;
@@ -569,6 +584,8 @@ type CheckboxProps = {
   defaultChecked?: boolean;
   /** The label for the checkbox. */
   children?: string | React$2.ReactNode;
+  /** Slot name for React Aria context wiring (e.g. "selection" in Table). */
+  slot?: string | null;
 } & StylingOverrideProps & Omit<React$2.ComponentPropsWithoutRef<'input'>, 'className' | 'type'>;
 /**
  * Checkbox component for capturing boolean user input.
@@ -590,6 +607,8 @@ declare const Checkbox: React$2.ForwardRefExoticComponent<{
   defaultChecked?: boolean;
   /** The label for the checkbox. */
   children?: string | React$2.ReactNode;
+  /** Slot name for React Aria context wiring (e.g. "selection" in Table). */
+  slot?: string | null;
 } & StylingOverrideProps & Omit<Omit<React$2.DetailedHTMLProps<React$2.InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref">, "className" | "type"> & React$2.RefAttributes<HTMLInputElement>>;
 //#endregion
 //#region src/components/Collapse/Collapse.d.ts
@@ -628,7 +647,7 @@ type InputRowAddonProps = {
    * Vertical size to align with adjacent {@link TextInput} / field controls.
    * @default 'md'
    */
-  size?: Size$3;
+  size?: Size$4;
 } & StylingOverrideProps & Omit<React$2.ComponentPropsWithoutRef<'span'>, 'className'>;
 declare function InputRowAddon({ children, size, FORCE__className: classNameOverride, ...rest }: InputRowAddonProps): React$2.JSX.Element;
 declare function InputRowRoot({ children, FORCE__className: classNameOverride, role: roleProp, 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledBy, ...rest }: InputRowProps): React$2.JSX.Element;
@@ -735,6 +754,125 @@ declare const DatePickerField: React$2.ForwardRefExoticComponent<FieldLayoutProp
   isInvalid?: boolean;
 } & React$2.RefAttributes<HTMLDivElement>>;
 //#endregion
+//#region src/components/SelectField/SelectField.d.ts
+type SelectionMode$1 = 'single' | 'multiple';
+type DefaultItem = {
+  id: Key$1;
+  label: string;
+  /** Optional icon rendered before the label. */
+  icon?: SvgIcon;
+};
+/** A group of `DefaultItem`s, rendered as a labeled section. Enables defining sections via `items` instead of JSX children. */
+type DefaultSection = {
+  /** Unique key for the section. */
+  id: Key$1;
+  /** Visible header label. Omit for an unlabeled group (then pass `aria-label`). */
+  label?: string;
+  /** Accessible name when there is no visible header. */
+  'aria-label'?: string;
+  /** Options within this section. */
+  children: Iterable<DefaultItem>;
+};
+type DefaultItemOrSection = DefaultItem | DefaultSection;
+type ItemRenderer<T extends object> = (item: T) => React$2.ReactElement;
+type ItemsChildren<T extends object> = React$2.ReactNode | ItemRenderer<T>;
+type SelectFieldProps<T extends object = DefaultItemOrSection, M extends SelectionMode$1 = 'single'> = FieldLayoutProps & StylingOverrideProps & {
+  /** Visual status of the trigger. `danger` marks the field invalid for accessibility and helper text treatment. @default 'default' */
+  appearance?: Appearance$3;
+  /** Trigger size variant. @default 'md' */
+  size?: Size$4;
+  /** Optional content rendered before the selected value, such as an icon. Pass a single node or group multiple nodes in a fragment or array. */
+  leadingSlot?: React$2.ReactNode;
+  /** Placeholder text shown in the trigger when there is no selection. Omit to render an empty trigger instead of a default placeholder. */
+  placeholder?: string;
+  /** Disables the field and prevents opening the listbox. */
+  disabled?: boolean;
+  /** Marks the field as required and shows the required indicator on the label. */
+  required?: boolean;
+  /** HTML `id` for the field root; associates the label, trigger, and helper text. */
+  id?: string;
+  /** Form field `name` used for native form submission. */
+  name?: string;
+  /** Whether to focus the trigger on mount. */
+  autoFocus?: boolean;
+  /** Selection behavior for the field. @default 'single' */
+  selectionMode?: M;
+  /** Controlled selected key, or selected keys when `selectionMode` is `multiple`. */
+  value?: M extends 'multiple' ? Iterable<Key$1> : Key$1 | null;
+  /** Uncontrolled initial selected key, or keys when `selectionMode` is `multiple`. */
+  defaultValue?: M extends 'multiple' ? Iterable<Key$1> : Key$1 | null;
+  /** Called when the selection changes. Receives a `Set` of keys in multiple selection mode. */
+  onChange?: (value: M extends 'multiple' ? Set<Key$1> : Key$1 | null) => void;
+  /** Controlled open state for the options popover. */
+  isOpen?: boolean;
+  /** Uncontrolled initial open state for the options popover. */
+  defaultOpen?: boolean;
+  /** Called when the options popover opens or closes. */
+  onOpenChange?: (isOpen: boolean) => void;
+  /** When true, renders a search input in the popover to filter options. */
+  canSearch?: boolean;
+  /** Placeholder text for the in-popover search input when `canSearch` is true. */
+  searchPlaceholder?: string;
+  /** Whether the popover should be at least as wide as the trigger. @default true */
+  shouldAutoSizeDropdown?: boolean;
+  /** Accessible name when a visible `label` is not provided. */
+  'aria-label'?: string;
+  /** Id of an element that labels the field when a visible `label` is not used. */
+  'aria-labelledby'?: string;
+  /** Id of an element that describes the field, such as external helper or error text. */
+  'aria-describedby'?: string;
+  /** Data source for dynamic option rendering. Omit to render static `SelectField.Item` children instead. */
+  items?: Iterable<T>;
+  /** Key(s) of options that cannot be selected, focused, or otherwise interacted with. */
+  disabledKeys?: Iterable<Key$1>;
+  /** Static `SelectField.Item` children, or a render function for each item in `items`. Defaults to rendering each item's `id` and `label` when `items` is provided and `children` is omitted. */
+  children?: ItemsChildren<T>;
+};
+type SelectFieldItemProps = {
+  /** Unique key for the option. */
+  id: Key$1;
+  /** Text used for typeahead and accessibility name computation. */
+  textValue?: string;
+  /** Disables the option, preventing selection, focus, and interaction. */
+  isDisabled?: boolean;
+  /**
+   * Extra inset for the row. When omitted, items inside {@link SelectField.Section} with a {@link SelectField.Header} indent automatically.
+   */
+  indent?: boolean;
+  /** The object value this item represents. Set automatically when using dynamic collections via `items`. */
+  value?: object;
+  /** Content rendered for the option label. */
+  children: React$2.ReactNode;
+};
+type SelectFieldHeaderProps = StylingOverrideProps & {
+  /**
+   * Optional id for `aria-labelledby` on {@link SelectField.Section}. When omitted inside a section, an id is assigned automatically.
+   */
+  id?: string;
+  /** Header label. */
+  label?: React$2.ReactNode;
+  /** Children for compound usage. */
+  children?: React$2.ReactNode;
+};
+type SelectFieldSectionProps = StylingOverrideProps & Omit<React$2.HTMLAttributes<HTMLElement>, 'role'> & {
+  /**
+   * Groups {@link SelectField.Item} rows. Use with an optional {@link SelectField.Header} to label the group.
+   * If there is no header, pass `aria-label` (or `aria-labelledby`) so the group has an accessible name.
+   */
+  children?: React$2.ReactNode;
+};
+declare function SelectFieldItem(props: SelectFieldItemProps): React$2.JSX.Element;
+declare function SelectFieldHeader(props: SelectFieldHeaderProps): React$2.JSX.Element;
+declare function SelectFieldSection(props: SelectFieldSectionProps): React$2.JSX.Element;
+/**
+ * Composed select field with Capra label/helper text layout, single and multiple selection, and an optional popover search input.
+ */
+declare const SelectField: (<T extends object = DefaultItemOrSection, M extends SelectionMode$1 = "single">(props: SelectFieldProps<T, M> & React$2.RefAttributes<HTMLDivElement>) => React$2.ReactElement | null) & {
+  Item: typeof SelectFieldItem;
+  Header: typeof SelectFieldHeader;
+  Section: typeof SelectFieldSection;
+};
+//#endregion
 //#region src/components/DateRangePickerField/DateRangePickerField.d.ts
 /** Visible placeholders for empty start/end when the field is not focus-within. */
 type DateRangePickerFieldPlaceholder = readonly [string, string];
@@ -791,7 +929,7 @@ type TextAreaProps = {
    * Appearance of the text area.
    * @default 'default'
    */
-  appearance?: Appearance$2;
+  appearance?: Appearance$3;
   /**
    * Whether the text area can be vertically resized by the user.
    * @default true
@@ -816,7 +954,7 @@ declare const TextArea: React$2.ForwardRefExoticComponent<{
    * Appearance of the text area.
    * @default 'default'
    */
-  appearance?: Appearance$2;
+  appearance?: Appearance$3;
   /**
    * Whether the text area can be vertically resized by the user.
    * @default true
@@ -878,10 +1016,10 @@ type ModalCreateResult = {
   closed: Promise<void>;
 };
 declare const appearances$1: readonly ['default', 'info', 'danger', 'warning', 'success'];
-type Appearance$1 = (typeof appearances$1)[number];
+type Appearance$2 = (typeof appearances$1)[number];
 type ConfirmationModalProps = Omit<ModalProps, 'title' | 'footer' | 'size' | 'isDismissible' | 'FORCE__className'> & {
   /** Visual appearance of the confirmation modal */
-  appearance?: Appearance$1;
+  appearance?: Appearance$2;
   /** Modal title shown in the header */
   title: string;
   /** Confirmation content */
@@ -1134,18 +1272,18 @@ declare const Anchor: <As extends React$2.ElementType = "a">(props: {
 declare const variants: readonly ['primary', 'secondary', 'tertiary'];
 type Variant = (typeof variants)[number];
 declare const appearances: readonly ['default', 'danger', 'neutral'];
-type Appearance = (typeof appearances)[number];
+type Appearance$1 = (typeof appearances)[number];
 declare const sizes$1: readonly ['xs', 'sm', 'md', 'lg', 'xl'];
-type Size$2 = (typeof sizes$1)[number];
+type Size$3 = (typeof sizes$1)[number];
 type ButtonProps = {
   /** The `label` for the button. */
   children: string;
   /** Which button style to use. Defaults to `secondary`. */
   variant?: Variant;
   /** Appearance to apply to the button. Defaults to `default`. */
-  appearance?: Appearance;
+  appearance?: Appearance$1;
   /** Size of the button. Defaults to `md`. */
-  size?: Size$2;
+  size?: Size$3;
   /** Whether the button is disabled. */
   disabled?: boolean;
   /** Whether the button is in a pending state. */
@@ -1168,9 +1306,9 @@ declare const Button: (props: {
   /** Which button style to use. Defaults to `secondary`. */
   variant?: Variant;
   /** Appearance to apply to the button. Defaults to `default`. */
-  appearance?: Appearance;
+  appearance?: Appearance$1;
   /** Size of the button. Defaults to `md`. */
-  size?: Size$2;
+  size?: Size$3;
   /** Whether the button is disabled. */
   disabled?: boolean;
   /** Whether the button is in a pending state. */
@@ -1221,9 +1359,9 @@ type ButtonLinkProps<As extends React$2.ElementType> = {
   /** Which visual style to use. Defaults to `secondary`. */
   variant?: Variant;
   /** Appearance to apply to the link. Defaults to `default`. */
-  appearance?: Appearance;
+  appearance?: Appearance$1;
   /** Size of the link. Defaults to `md`. */
-  size?: Size$2;
+  size?: Size$3;
   /** Whether the link is disabled. */
   disabled?: boolean;
   /** Whether the link is in a pending state. */
@@ -1246,9 +1384,9 @@ declare const ButtonLink: <As extends React$2.ElementType = "a">(props: {
   /** Which visual style to use. Defaults to `secondary`. */
   variant?: Variant;
   /** Appearance to apply to the link. Defaults to `default`. */
-  appearance?: Appearance;
+  appearance?: Appearance$1;
   /** Size of the link. Defaults to `md`. */
-  size?: Size$2;
+  size?: Size$3;
   /** Whether the link is disabled. */
   disabled?: boolean;
   /** Whether the link is in a pending state. */
@@ -1272,9 +1410,9 @@ type IconButtonProps = {
   /** Which button style to use. Defaults to `secondary`. */
   variant?: Variant;
   /** Appearance to apply to the button. Defaults to `default`. */
-  appearance?: Appearance;
+  appearance?: Appearance$1;
   /** Size of the button. Defaults to `md`. */
-  size?: Size$2;
+  size?: Size$3;
   /** Whether the button is disabled. */
   disabled?: boolean;
   /** Whether the button is in a pending state. */
@@ -1293,9 +1431,9 @@ declare const IconButton: (props: {
   /** Which button style to use. Defaults to `secondary`. */
   variant?: Variant;
   /** Appearance to apply to the button. Defaults to `default`. */
-  appearance?: Appearance;
+  appearance?: Appearance$1;
   /** Size of the button. Defaults to `md`. */
-  size?: Size$2;
+  size?: Size$3;
   /** Whether the button is disabled. */
   disabled?: boolean;
   /** Whether the button is in a pending state. */
@@ -1304,6 +1442,55 @@ declare const IconButton: (props: {
   onClick?: React$2.ComponentProps<'button'>['onClick'];
 } & StylingOverrideProps & Omit<ButtonProps$1, "className" | "isDisabled" | "isPending" | "onClick"> & React$2.RefAttributes<HTMLButtonElement>) => React$2.ReactElement;
 //#endregion
+//#region src/components/ToggleButtonGroup/ToggleButtonGroup.d.ts
+type Size$2 = Extract<Size$3, 'sm' | 'md'>;
+type ToggleButtonGroupTextItem = {
+  /** Unique identifier used for selection state. */
+  key: Key$1;
+  /** Button label rendered as visible text. */
+  text: string;
+  /** Optional icon rendered before the label. */
+  icon?: SvgIcon;
+  /** Whether the item is disabled. */
+  disabled?: boolean;
+  /** Optional accessible name when visible text is not sufficient. */
+  'aria-label'?: string;
+};
+type ToggleButtonGroupIconItem = {
+  /** Unique identifier used for selection state. */
+  key: Key$1;
+  text?: never;
+  /** Icon rendered in the button. */
+  icon: SvgIcon;
+  /** Whether the item is disabled. */
+  disabled?: boolean;
+  /** Accessible name for the icon-only button. */
+  'aria-label': string;
+};
+type ToggleButtonGroupItem = ToggleButtonGroupTextItem | ToggleButtonGroupIconItem;
+type ToggleButtonGroupProps = {
+  /** Items to render as toggle buttons. */
+  items: ToggleButtonGroupItem[];
+  /** Size forwarded to every rendered button. Defaults to `md`. */
+  size?: Size$2;
+  /** Whether the entire group is disabled. */
+  disabled?: boolean;
+  /** Whether single or multiple selection is enabled. Defaults to `single`. */
+  selectionMode?: 'single' | 'multiple';
+  /** Controlled selected keys. */
+  selectedKeys?: Iterable<Key$1>;
+  /** Uncontrolled initial selected keys. */
+  defaultSelectedKeys?: Iterable<Key$1>;
+  /** Handler called when the selection changes. */
+  onSelectionChange?: (keys: Set<Key$1>) => void;
+  /** Whether the group must always have at least one selected item. */
+  disallowEmptySelection?: boolean;
+} & StylingOverrideProps & AccessibleLabelProps & Omit<ToggleButtonGroupProps$1, 'children' | 'className' | 'isDisabled' | 'selectedKeys' | 'defaultSelectedKeys' | 'onSelectionChange' | 'selectionMode' | 'disallowEmptySelection' | 'aria-label' | 'aria-labelledby'>;
+/**
+ * A group of toggle buttons for choosing one or more options from a set.
+ */
+declare function ToggleButtonGroup({ items, size, disabled, selectionMode, selectedKeys, defaultSelectedKeys, onSelectionChange, disallowEmptySelection, FORCE__className: classNameOverride, ...props }: ToggleButtonGroupProps): React$2.JSX.Element;
+//#endregion
 //#region src/components/Link/Link.d.ts
 type LinkProps<As extends React$2.ElementType> = {
   /**
@@ -1800,6 +1987,11 @@ type MenuItemProps<As extends React$2.ElementType = 'a'> = Omit<React$2.Componen
    * Children for compound usage.
    */
   children?: React$2.ReactNode;
+  /**
+   * Allow items to wrap when they exceed the maximum width
+   * @default false
+   */
+  allowItemLineWrap?: boolean;
 };
 interface MenuHeaderProps extends StylingOverrideProps {
   /**
@@ -1927,7 +2119,7 @@ declare const MenuSection$1: {
   displayName: string;
 };
 declare const MenuItem$1: {
-  <As extends React$2.ElementType = "a">({ as: Component, label, description, ariaLabel, href, disabled, active, variant, icon, indent: indentProp, shortcut, parent, onPress, onClick, FORCE__className, children, ...rest }: MenuItemProps<As>): React$2.JSX.Element;
+  <As extends React$2.ElementType = "a">({ as: Component, label, description, ariaLabel, href, disabled, active, variant, icon, indent: indentProp, shortcut, parent, onPress, onClick, FORCE__className, children, allowItemLineWrap, ...rest }: MenuItemProps<As>): React$2.JSX.Element;
   displayName: string;
 };
 declare const MenuDivider: {
@@ -2156,12 +2348,115 @@ type CustomTooltipTriggerProps = {
  */
 declare const CustomTooltipTrigger: React$2.ForwardRefExoticComponent<CustomTooltipTriggerProps & React$2.RefAttributes<HTMLElement>>;
 //#endregion
+//#region src/components/FilterToolbar/FilterToolbar.d.ts
+type FilterToolbarProps = {
+  /** props to pass to the filter TextField */
+  filterInputProps?: TextFieldProps;
+  /** Render function for filter related actions */
+  renderActions?: () => React$2.ReactNode;
+  /** Render function for bulk edit text */
+  renderBulkEditText?: () => React$2.ReactNode;
+  /** Render function for bulk edit related actions */
+  renderBulkEditActions?: () => React$2.ReactNode;
+  /** Set of selected keys, necessary to determine filter vs. bulk edit mode */
+  selectedKeys: Selection;
+};
+declare function FilterToolbar({ filterInputProps, renderActions, renderBulkEditText, renderBulkEditActions, selectedKeys }: FilterToolbarProps): React$2.JSX.Element;
+//#endregion
+//#region src/components/Table/Table.d.ts
+declare const EMPTY_CELL_PLACEHOLDER = "--";
+type ResizingConfig = true | {
+  minWidth?: ColumnProps['minWidth'];
+  maxWidth?: ColumnProps['maxWidth'];
+  width?: ColumnProps['width'];
+  defaultWidth?: ColumnProps['defaultWidth'];
+};
+type ColumnConfig<T extends string | number, ItemRecord extends BaseItemRecord> = {
+  id: T;
+  label: string;
+  allowsSorting?: boolean;
+  resizing?: ResizingConfig;
+  render?: (value: ItemRecord[T], item: ItemRecord) => React$2.ReactNode;
+};
+type StringKeys<T extends Record<string, unknown>> = keyof { [K in keyof T as string extends K ? never : number extends K ? never : K]: T[K]; } & string;
+type BaseItemRecord = {
+  id: string | number;
+  [key: string]: unknown;
+};
+type Density = 'default' | 'compact' | 'tight';
+type Appearance = 'zebra' | 'flat';
+type ColumnConfigUnion<ItemRecord extends BaseItemRecord> = { [K in StringKeys<ItemRecord>]: ColumnConfig<K, ItemRecord>; }[StringKeys<ItemRecord>];
+declare function defineColumns<ItemRecord extends BaseItemRecord>(columns: ColumnConfigUnion<ItemRecord>[]): ColumnConfig<StringKeys<ItemRecord>, ItemRecord>[];
+type TableProps<ItemRecord extends BaseItemRecord, ColumnKey extends StringKeys<ItemRecord> = StringKeys<ItemRecord>> = {
+  /** The data to render as rows in the Table */
+  items: ItemRecord[];
+  /** The density of the table, affects row height */
+  density?: Density;
+  /** Whether to apply zebra-striping to rows */
+  appearance?: Appearance;
+  /** Key and direction for sorting the Table */
+  sortDescriptor?: SortDescriptor;
+  /** Callback function fired when a the sorting configuration is changed */
+  onSortChange?: (sortDescriptor: SortDescriptor) => void;
+  /** The columns to render in the Table */
+  columns: ColumnConfig<ColumnKey, ItemRecord>[];
+  /** Which columns should be visible */
+  visibleColumns: ColumnKey[];
+  /** Whether the table is in a loading state */
+  isLoading?: boolean;
+  /** Whether drag-and-dropping rows is enabled */
+  enableDragAndDrop?: boolean;
+  /** todo: is this prop needed? */
+  renderActionColumn?: (item: ItemRecord) => React$2.ReactNode;
+  /** Mode of row selection
+   * @default 'none'
+   */
+  selectionMode?: SelectionMode;
+  /** The currently selected keys (controlled) */
+  selectedKeys?: Selection;
+  /** Callback fired when selection changes */
+  onSelectionChange?: (keys: Selection) => void;
+} & StylingOverrideProps & Omit<React$2.ComponentPropsWithoutRef<'table'>, 'className'>;
+/**
+ * A component for rendering tabular data
+ */
+declare const Table: <T extends BaseItemRecord>(props: {
+  /** The data to render as rows in the Table */
+  items: T[];
+  /** The density of the table, affects row height */
+  density?: Density;
+  /** Whether to apply zebra-striping to rows */
+  appearance?: Appearance;
+  /** Key and direction for sorting the Table */
+  sortDescriptor?: SortDescriptor;
+  /** Callback function fired when a the sorting configuration is changed */
+  onSortChange?: (sortDescriptor: SortDescriptor) => void;
+  /** The columns to render in the Table */
+  columns: ColumnConfig<StringKeys<T>, T>[];
+  /** Which columns should be visible */
+  visibleColumns: StringKeys<T>[];
+  /** Whether the table is in a loading state */
+  isLoading?: boolean;
+  /** Whether drag-and-dropping rows is enabled */
+  enableDragAndDrop?: boolean;
+  /** todo: is this prop needed? */
+  renderActionColumn?: ((item: T) => React$2.ReactNode) | undefined;
+  /** Mode of row selection
+   * @default 'none'
+   */
+  selectionMode?: SelectionMode;
+  /** The currently selected keys (controlled) */
+  selectedKeys?: Selection;
+  /** Callback fired when selection changes */
+  onSelectionChange?: (keys: Selection) => void;
+} & StylingOverrideProps & Omit<Omit<React$2.DetailedHTMLProps<React$2.TableHTMLAttributes<HTMLTableElement>, HTMLTableElement>, "ref">, "className"> & React$2.RefAttributes<HTMLTableElement>) => React$2.ReactElement;
+//#endregion
 //#region src/components/Tree/Tree.d.ts
 interface TreeItemType {
   /**
    * The unique key of the tree item.
    */
-  key: Key;
+  key: Key$1;
   /**
    * The label of the tree item.
    */
@@ -2199,31 +2494,31 @@ type TreeProps = StylingOverrideProps & {
   /**
    * Handler that is called when a user performs an action on an item.
    */
-  onAction?: (key: Key) => void;
+  onAction?: (key: Key$1) => void;
   /**
    * The initial expanded keys when in uncontrolled mode.
    */
-  defaultExpandedKeys?: Iterable<Key>;
+  defaultExpandedKeys?: Iterable<Key$1>;
   /**
    * The initial selected keys when in uncontrolled mode.
    */
-  defaultSelectedKeys?: Iterable<Key>;
+  defaultSelectedKeys?: Iterable<Key$1>;
   /**
    * The currently expanded keys when in controlled mode.
    */
-  expandedKeys?: Iterable<Key>;
+  expandedKeys?: Iterable<Key$1>;
   /**
    * Handler that is called when the expanded keys change.
    */
-  onExpandedChange?: (keys: Set<Key>) => void;
+  onExpandedChange?: (keys: Set<Key$1>) => void;
   /**
    * Callback that is fired when the selection changes.
    */
-  onSelectionChange?: (keys: Set<Key>) => void;
+  onSelectionChange?: (keys: Set<Key$1>) => void;
   /**
    * The currently selected keys when in controlled mode.
    */
-  selectedKeys?: Iterable<Key>;
+  selectedKeys?: Iterable<Key$1>;
   /**
    * The selection mode of the tree.
    * @default 'multiple'
@@ -2254,4 +2549,4 @@ declare const Label: React$2.ForwardRefExoticComponent<{
   trailingSlot?: React$2.ReactNode;
 } & StylingOverrideProps & Omit<Omit<React$2.DetailedHTMLProps<React$2.LabelHTMLAttributes<HTMLLabelElement>, HTMLLabelElement>, "ref">, "className" | "style"> & React$2.RefAttributes<HTMLLabelElement>>;
 //#endregion
-export { Alert, type AlertProps, Anchor, type AnchorProps, AutocompleteField, type AutocompleteFieldProps, Badge, BadgeLayout, type BadgeProps, Breadcrumb, type BreadcrumbProps, Breadcrumbs, type BreadcrumbsProps, Button, ButtonLink, type ButtonLinkProps, type ButtonProps, Card, Checkbox, type CheckboxProps, Collapse, type CollapseProps, CustomTooltipTrigger, type CustomTooltipTriggerProps, DatePickerField, type DatePickerFieldProps, DateRangePickerField, type DateRangePickerFieldPlaceholder, type DateRangePickerFieldProps, Divider, type DividerProps, type DividerType, Drawer, type DrawerPlacement, type DrawerProps, EmptyState, type EmptyStateProps, IconButton, type IconButtonProps, InputRow, type InputRowAddonProps, type InputRowProps, Label, type LabelProps, Link, type LinkProps, ListItem, type ListItemProps, Menu, type MenuDividerProps, type MenuHeaderProps, type MenuItemProps, type MenuListProps, type MenuPanelPadding, type MenuProps, type MenuSectionProps, type MenuSubmenuProps, Modal, type ModalProps, NumberField, type NumberFieldProps, Pagination, type PaginationProps, PasswordField, type PasswordFieldProps, Pill, type PillProps, Popover, type PopoverProps, Radio, RadioGroup, type RadioGroupProps, type RadioProps, RadioTile, type RadioTileProps, Ribbon, type RibbonProps, type RoutedLinkProps, RouterProvider, SKELETON_SIZE, SKELETON_SIZE_TOKENS, Skeleton, type SkeletonElementProps, SkeletonGroup, type SkeletonGroupButtonProps, type SkeletonGroupInputProps, type SkeletonGroupNodeProps, type SkeletonParagraphProps, type SkeletonProps, type SkeletonSize, type SkeletonTitleProps, Spinner, type SpinnerProps, type StylingOverrideProps, Switch, type SwitchProps, TabNav, type TabNavItemType, type TabNavItemVariant, type TabNavPlacement, type TabNavProps, type TabNavSubItemType, Tag, type TagColor, type TagProps, Text, TextArea, type TextAreaAutoSize, type TextAreaProps, TextField, type TextFieldProps, type TextProps, Toast, type ToastOptions, type ToastPosition, type ToastType, Tooltip, type TooltipProps, TopNav, type TopNavCenterProps, type TopNavEndProps, type TopNavProps, type TopNavStartProps, Tree, type TreeItemType, type TreeProps, VerticalNavigation, type VerticalNavigationCollapseProps, type VerticalNavigationFooterProps, type VerticalNavigationItemListProps, type VerticalNavigationItemProps, type VerticalNavigationProps, VisuallyHidden, type VisuallyHiddenProps, submenuPanelClassName, tagColors };
+export { Alert, type AlertProps, Anchor, type AnchorProps, AutocompleteField, type AutocompleteFieldProps, Badge, BadgeLayout, type BadgeProps, type BaseItemRecord, Breadcrumb, type BreadcrumbProps, Breadcrumbs, type BreadcrumbsProps, Button, ButtonLink, type ButtonLinkProps, type ButtonProps, Card, Checkbox, type CheckboxProps, Collapse, type CollapseProps, CustomTooltipTrigger, type CustomTooltipTriggerProps, DatePickerField, type DatePickerFieldProps, DateRangePickerField, type DateRangePickerFieldPlaceholder, type DateRangePickerFieldProps, Divider, type DividerProps, type DividerType, Drawer, type DrawerPlacement, type DrawerProps, EMPTY_CELL_PLACEHOLDER, EmptyState, type EmptyStateProps, FilterToolbar, type FilterToolbarProps, IconButton, type IconButtonProps, InputRow, type InputRowAddonProps, type InputRowProps, type Key, Label, type LabelProps, Link, type LinkProps, ListItem, type ListItemProps, Menu, type MenuDividerProps, type MenuHeaderProps, type MenuItemProps, type MenuListProps, type MenuPanelPadding, type MenuProps, type MenuSectionProps, type MenuSubmenuProps, Modal, type ModalProps, NumberField, type NumberFieldProps, Pagination, type PaginationProps, PasswordField, type PasswordFieldProps, Pill, type PillProps, Popover, type PopoverProps, Radio, RadioGroup, type RadioGroupProps, type RadioProps, RadioTile, type RadioTileProps, Ribbon, type RibbonProps, type RoutedLinkProps, RouterProvider, SKELETON_SIZE, SKELETON_SIZE_TOKENS, SelectField, type SelectFieldHeaderProps, type SelectFieldItemProps, type SelectFieldProps, type SelectFieldSectionProps, Skeleton, type SkeletonElementProps, SkeletonGroup, type SkeletonGroupButtonProps, type SkeletonGroupInputProps, type SkeletonGroupNodeProps, type SkeletonParagraphProps, type SkeletonProps, type SkeletonSize, type SkeletonTitleProps, Spinner, type SpinnerProps, type StylingOverrideProps, Switch, type SwitchProps, TabNav, type TabNavItemType, type TabNavItemVariant, type TabNavPlacement, type TabNavProps, type TabNavSubItemType, Table, type TableProps, Tag, type TagColor, type TagProps, Text, TextArea, type TextAreaAutoSize, type TextAreaProps, TextField, type TextFieldProps, type TextProps, Toast, type ToastOptions, type ToastPosition, type ToastType, ToggleButtonGroup, type ToggleButtonGroupIconItem, type ToggleButtonGroupItem, type ToggleButtonGroupProps, type ToggleButtonGroupTextItem, Tooltip, type TooltipProps, TopNav, type TopNavCenterProps, type TopNavEndProps, type TopNavProps, type TopNavStartProps, Tree, type TreeItemType, type TreeProps, VerticalNavigation, type VerticalNavigationCollapseProps, type VerticalNavigationFooterProps, type VerticalNavigationItemListProps, type VerticalNavigationItemProps, type VerticalNavigationProps, VisuallyHidden, type VisuallyHiddenProps, defineColumns, submenuPanelClassName, tagColors };