@capra/core 1.13.0 → 1.14.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.mts CHANGED
@@ -1,7 +1,7 @@
1
1
  import * as React$2 from "react";
2
2
  import React$1, { HTMLAttributeAnchorTarget, HTMLAttributeReferrerPolicy, ReactNode } from "react";
3
3
  import { SvgIcon } from "@capra/icons";
4
- 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";
4
+ 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";
5
5
  import { SvgLogo } from "@capra/icons/logos";
6
6
  //#region src/utils/stylingOverride.d.ts
7
7
  interface StylingOverrideProps {
@@ -23,7 +23,7 @@ interface StylingOverrideProps {
23
23
  declare const layouts: readonly ['section', 'compact', 'inline'];
24
24
  type Layout = (typeof layouts)[number];
25
25
  declare const appearances$3: readonly ['info', 'warning', 'danger', 'success'];
26
- type Appearance$3 = (typeof appearances$3)[number];
26
+ type Appearance$4 = (typeof appearances$3)[number];
27
27
  type AlertProps = {
28
28
  /**
29
29
  * The layout of the alert.
@@ -49,7 +49,7 @@ type AlertProps = {
49
49
  * <li>'success' - Success alerts confirm an action has been completed.</li>
50
50
  * </ul>
51
51
  */
52
- appearance?: Appearance$3;
52
+ appearance?: Appearance$4;
53
53
  /**
54
54
  * The title of the alert. This is optional.
55
55
  */
@@ -88,21 +88,21 @@ declare function Alert({ appearance, layout, title, children, action, onDismiss,
88
88
  //#endregion
89
89
  //#region src/components/TextInput/TextInput.d.ts
90
90
  declare const appearances$2: readonly ['default', 'danger', 'warning'];
91
- type Appearance$2 = (typeof appearances$2)[number];
91
+ type Appearance$3 = (typeof appearances$2)[number];
92
92
  declare const sizes$2: readonly ['sm', 'md'];
93
- type Size$3 = (typeof sizes$2)[number];
93
+ type Size$4 = (typeof sizes$2)[number];
94
94
  type TextInputProps = {
95
95
  /** Appearance of the input.
96
96
  * @default 'default'
97
97
  */
98
- appearance?: Appearance$2;
98
+ appearance?: Appearance$3;
99
99
  /** Content before the input (e.g. icon). */
100
100
  leadingSlot?: React$2.ReactNode;
101
101
  /**
102
102
  * Size of the input.
103
103
  * @default 'md'
104
104
  */
105
- size?: Size$3;
105
+ size?: Size$4;
106
106
  /** Content after the input (e.g. icon or clear button). */
107
107
  trailingSlot?: React$2.ReactNode;
108
108
  } & StylingOverrideProps & Omit<React$2.ComponentPropsWithoutRef<'input'>, 'className' | 'style' | 'size'>;
@@ -113,14 +113,14 @@ declare const TextInput: React$2.ForwardRefExoticComponent<{
113
113
  /** Appearance of the input.
114
114
  * @default 'default'
115
115
  */
116
- appearance?: Appearance$2;
116
+ appearance?: Appearance$3;
117
117
  /** Content before the input (e.g. icon). */
118
118
  leadingSlot?: React$2.ReactNode;
119
119
  /**
120
120
  * Size of the input.
121
121
  * @default 'md'
122
122
  */
123
- size?: Size$3;
123
+ size?: Size$4;
124
124
  /** Content after the input (e.g. icon or clear button). */
125
125
  trailingSlot?: React$2.ReactNode;
126
126
  } & StylingOverrideProps & Omit<Omit<React$2.DetailedHTMLProps<React$2.InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref">, "className" | "size" | "style"> & React$2.RefAttributes<HTMLInputElement>>;
@@ -188,9 +188,9 @@ declare const AutocompleteField: ((props: {
188
188
  /** Whether to automatically size the dropdown to the width of the input. Defaults to `true` */
189
189
  shouldAutoSizeDropdown?: boolean;
190
190
  } & StylingOverrideProps & FieldLayoutProps & Omit<Omit<{
191
- appearance?: Appearance$2;
191
+ appearance?: Appearance$3;
192
192
  leadingSlot?: React$1.ReactNode;
193
- size?: Size$3;
193
+ size?: Size$4;
194
194
  trailingSlot?: React$1.ReactNode;
195
195
  } & 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) & {
196
196
  Item: typeof AutocompleteItem;
@@ -309,7 +309,19 @@ type LabelProp = {
309
309
  type AccessibleLabelProps = LabelledByProp | LabelProp;
310
310
  //#endregion
311
311
  //#region src/components/Badge/Badge.d.ts
312
- type AccessibleBadgeProps = AccessibleLabelProps & {
312
+ type NamedBadgeProps = AccessibleLabelProps & {
313
+ decorative?: never;
314
+ };
315
+ type DecorativeBadgeProps = {
316
+ /**
317
+ * Marks the badge as purely decorative, removing it from the accessibility tree.
318
+ * Must not be combined with 'aria-label' or 'aria-labelledby'.
319
+ */
320
+ decorative: true;
321
+ 'aria-label'?: never;
322
+ 'aria-labelledby'?: never;
323
+ };
324
+ type AccessibleBadgeProps = (NamedBadgeProps | DecorativeBadgeProps) & {
313
325
  'aria-live'?: React$2.AriaAttributes['aria-live'];
314
326
  };
315
327
  declare const badgeSizes: readonly ['sm', 'md'];
@@ -342,11 +354,11 @@ type BadgeProps = {
342
354
  * The number to display in the badge when the count is greater than the overflow count. Default is 99.
343
355
  */
344
356
  overflowCount?: number;
345
- } & StylingOverrideProps & AccessibleBadgeProps & Omit<React$2.ComponentPropsWithoutRef<'span'>, 'className' | 'role' | 'aria-label' | 'aria-labelledby' | 'aria-live'>;
357
+ } & StylingOverrideProps & AccessibleBadgeProps & Omit<React$2.ComponentPropsWithoutRef<'span'>, 'className' | 'role' | 'aria-label' | 'aria-labelledby' | 'aria-live' | 'aria-hidden'>;
346
358
  /**
347
359
  * Badges display an indicator/counter on an associated component.
348
360
  */
349
- declare function Badge({ appearance, variant, size, count, showZero, overflowCount, FORCE__className, style, ...props }: BadgeProps): React$2.JSX.Element | null;
361
+ 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;
350
362
  type BadgeLayoutProps = React$2.PropsWithChildren<{
351
363
  offset?: readonly [x: number, y: number];
352
364
  }>;
@@ -572,6 +584,8 @@ type CheckboxProps = {
572
584
  defaultChecked?: boolean;
573
585
  /** The label for the checkbox. */
574
586
  children?: string | React$2.ReactNode;
587
+ /** Slot name for React Aria context wiring (e.g. "selection" in Table). */
588
+ slot?: string | null;
575
589
  } & StylingOverrideProps & Omit<React$2.ComponentPropsWithoutRef<'input'>, 'className' | 'type'>;
576
590
  /**
577
591
  * Checkbox component for capturing boolean user input.
@@ -593,6 +607,8 @@ declare const Checkbox: React$2.ForwardRefExoticComponent<{
593
607
  defaultChecked?: boolean;
594
608
  /** The label for the checkbox. */
595
609
  children?: string | React$2.ReactNode;
610
+ /** Slot name for React Aria context wiring (e.g. "selection" in Table). */
611
+ slot?: string | null;
596
612
  } & StylingOverrideProps & Omit<Omit<React$2.DetailedHTMLProps<React$2.InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref">, "className" | "type"> & React$2.RefAttributes<HTMLInputElement>>;
597
613
  //#endregion
598
614
  //#region src/components/Collapse/Collapse.d.ts
@@ -631,7 +647,7 @@ type InputRowAddonProps = {
631
647
  * Vertical size to align with adjacent {@link TextInput} / field controls.
632
648
  * @default 'md'
633
649
  */
634
- size?: Size$3;
650
+ size?: Size$4;
635
651
  } & StylingOverrideProps & Omit<React$2.ComponentPropsWithoutRef<'span'>, 'className'>;
636
652
  declare function InputRowAddon({ children, size, FORCE__className: classNameOverride, ...rest }: InputRowAddonProps): React$2.JSX.Element;
637
653
  declare function InputRowRoot({ children, FORCE__className: classNameOverride, role: roleProp, 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledBy, ...rest }: InputRowProps): React$2.JSX.Element;
@@ -739,9 +755,9 @@ declare const DatePickerField: React$2.ForwardRefExoticComponent<FieldLayoutProp
739
755
  } & React$2.RefAttributes<HTMLDivElement>>;
740
756
  //#endregion
741
757
  //#region src/components/SelectField/SelectField.d.ts
742
- type SelectionMode = 'single' | 'multiple';
758
+ type SelectionMode$1 = 'single' | 'multiple';
743
759
  type DefaultItem = {
744
- id: Key;
760
+ id: Key$1;
745
761
  label: string;
746
762
  /** Optional icon rendered before the label. */
747
763
  icon?: SvgIcon;
@@ -749,7 +765,7 @@ type DefaultItem = {
749
765
  /** A group of `DefaultItem`s, rendered as a labeled section. Enables defining sections via `items` instead of JSX children. */
750
766
  type DefaultSection = {
751
767
  /** Unique key for the section. */
752
- id: Key;
768
+ id: Key$1;
753
769
  /** Visible header label. Omit for an unlabeled group (then pass `aria-label`). */
754
770
  label?: string;
755
771
  /** Accessible name when there is no visible header. */
@@ -760,11 +776,11 @@ type DefaultSection = {
760
776
  type DefaultItemOrSection = DefaultItem | DefaultSection;
761
777
  type ItemRenderer<T extends object> = (item: T) => React$2.ReactElement;
762
778
  type ItemsChildren<T extends object> = React$2.ReactNode | ItemRenderer<T>;
763
- type SelectFieldProps<T extends object = DefaultItemOrSection, M extends SelectionMode = 'single'> = FieldLayoutProps & StylingOverrideProps & {
779
+ type SelectFieldProps<T extends object = DefaultItemOrSection, M extends SelectionMode$1 = 'single'> = FieldLayoutProps & StylingOverrideProps & {
764
780
  /** Visual status of the trigger. `danger` marks the field invalid for accessibility and helper text treatment. @default 'default' */
765
- appearance?: Appearance$2;
781
+ appearance?: Appearance$3;
766
782
  /** Trigger size variant. @default 'md' */
767
- size?: Size$3;
783
+ size?: Size$4;
768
784
  /** Optional content rendered before the selected value, such as an icon. Pass a single node or group multiple nodes in a fragment or array. */
769
785
  leadingSlot?: React$2.ReactNode;
770
786
  /** Placeholder text shown in the trigger when there is no selection. Omit to render an empty trigger instead of a default placeholder. */
@@ -782,11 +798,11 @@ type SelectFieldProps<T extends object = DefaultItemOrSection, M extends Selecti
782
798
  /** Selection behavior for the field. @default 'single' */
783
799
  selectionMode?: M;
784
800
  /** Controlled selected key, or selected keys when `selectionMode` is `multiple`. */
785
- value?: M extends 'multiple' ? Iterable<Key> : Key | null;
801
+ value?: M extends 'multiple' ? Iterable<Key$1> : Key$1 | null;
786
802
  /** Uncontrolled initial selected key, or keys when `selectionMode` is `multiple`. */
787
- defaultValue?: M extends 'multiple' ? Iterable<Key> : Key | null;
803
+ defaultValue?: M extends 'multiple' ? Iterable<Key$1> : Key$1 | null;
788
804
  /** Called when the selection changes. Receives a `Set` of keys in multiple selection mode. */
789
- onChange?: (value: M extends 'multiple' ? Set<Key> : Key | null) => void;
805
+ onChange?: (value: M extends 'multiple' ? Set<Key$1> : Key$1 | null) => void;
790
806
  /** Controlled open state for the options popover. */
791
807
  isOpen?: boolean;
792
808
  /** Uncontrolled initial open state for the options popover. */
@@ -808,13 +824,13 @@ type SelectFieldProps<T extends object = DefaultItemOrSection, M extends Selecti
808
824
  /** Data source for dynamic option rendering. Omit to render static `SelectField.Item` children instead. */
809
825
  items?: Iterable<T>;
810
826
  /** Key(s) of options that cannot be selected, focused, or otherwise interacted with. */
811
- disabledKeys?: Iterable<Key>;
827
+ disabledKeys?: Iterable<Key$1>;
812
828
  /** 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. */
813
829
  children?: ItemsChildren<T>;
814
830
  };
815
831
  type SelectFieldItemProps = {
816
832
  /** Unique key for the option. */
817
- id: Key;
833
+ id: Key$1;
818
834
  /** Text used for typeahead and accessibility name computation. */
819
835
  textValue?: string;
820
836
  /** Disables the option, preventing selection, focus, and interaction. */
@@ -851,7 +867,7 @@ declare function SelectFieldSection(props: SelectFieldSectionProps): React$2.JSX
851
867
  /**
852
868
  * Composed select field with Capra label/helper text layout, single and multiple selection, and an optional popover search input.
853
869
  */
854
- declare const SelectField: (<T extends object = DefaultItemOrSection, M extends SelectionMode = "single">(props: SelectFieldProps<T, M> & React$2.RefAttributes<HTMLDivElement>) => React$2.ReactElement | null) & {
870
+ declare const SelectField: (<T extends object = DefaultItemOrSection, M extends SelectionMode$1 = "single">(props: SelectFieldProps<T, M> & React$2.RefAttributes<HTMLDivElement>) => React$2.ReactElement | null) & {
855
871
  Item: typeof SelectFieldItem;
856
872
  Header: typeof SelectFieldHeader;
857
873
  Section: typeof SelectFieldSection;
@@ -913,7 +929,7 @@ type TextAreaProps = {
913
929
  * Appearance of the text area.
914
930
  * @default 'default'
915
931
  */
916
- appearance?: Appearance$2;
932
+ appearance?: Appearance$3;
917
933
  /**
918
934
  * Whether the text area can be vertically resized by the user.
919
935
  * @default true
@@ -938,7 +954,7 @@ declare const TextArea: React$2.ForwardRefExoticComponent<{
938
954
  * Appearance of the text area.
939
955
  * @default 'default'
940
956
  */
941
- appearance?: Appearance$2;
957
+ appearance?: Appearance$3;
942
958
  /**
943
959
  * Whether the text area can be vertically resized by the user.
944
960
  * @default true
@@ -1000,10 +1016,10 @@ type ModalCreateResult = {
1000
1016
  closed: Promise<void>;
1001
1017
  };
1002
1018
  declare const appearances$1: readonly ['default', 'info', 'danger', 'warning', 'success'];
1003
- type Appearance$1 = (typeof appearances$1)[number];
1019
+ type Appearance$2 = (typeof appearances$1)[number];
1004
1020
  type ConfirmationModalProps = Omit<ModalProps, 'title' | 'footer' | 'size' | 'isDismissible' | 'FORCE__className'> & {
1005
1021
  /** Visual appearance of the confirmation modal */
1006
- appearance?: Appearance$1;
1022
+ appearance?: Appearance$2;
1007
1023
  /** Modal title shown in the header */
1008
1024
  title: string;
1009
1025
  /** Confirmation content */
@@ -1256,18 +1272,18 @@ declare const Anchor: <As extends React$2.ElementType = "a">(props: {
1256
1272
  declare const variants: readonly ['primary', 'secondary', 'tertiary'];
1257
1273
  type Variant = (typeof variants)[number];
1258
1274
  declare const appearances: readonly ['default', 'danger', 'neutral'];
1259
- type Appearance = (typeof appearances)[number];
1275
+ type Appearance$1 = (typeof appearances)[number];
1260
1276
  declare const sizes$1: readonly ['xs', 'sm', 'md', 'lg', 'xl'];
1261
- type Size$2 = (typeof sizes$1)[number];
1277
+ type Size$3 = (typeof sizes$1)[number];
1262
1278
  type ButtonProps = {
1263
1279
  /** The `label` for the button. */
1264
1280
  children: string;
1265
1281
  /** Which button style to use. Defaults to `secondary`. */
1266
1282
  variant?: Variant;
1267
1283
  /** Appearance to apply to the button. Defaults to `default`. */
1268
- appearance?: Appearance;
1284
+ appearance?: Appearance$1;
1269
1285
  /** Size of the button. Defaults to `md`. */
1270
- size?: Size$2;
1286
+ size?: Size$3;
1271
1287
  /** Whether the button is disabled. */
1272
1288
  disabled?: boolean;
1273
1289
  /** Whether the button is in a pending state. */
@@ -1290,9 +1306,9 @@ declare const Button: (props: {
1290
1306
  /** Which button style to use. Defaults to `secondary`. */
1291
1307
  variant?: Variant;
1292
1308
  /** Appearance to apply to the button. Defaults to `default`. */
1293
- appearance?: Appearance;
1309
+ appearance?: Appearance$1;
1294
1310
  /** Size of the button. Defaults to `md`. */
1295
- size?: Size$2;
1311
+ size?: Size$3;
1296
1312
  /** Whether the button is disabled. */
1297
1313
  disabled?: boolean;
1298
1314
  /** Whether the button is in a pending state. */
@@ -1343,9 +1359,9 @@ type ButtonLinkProps<As extends React$2.ElementType> = {
1343
1359
  /** Which visual style to use. Defaults to `secondary`. */
1344
1360
  variant?: Variant;
1345
1361
  /** Appearance to apply to the link. Defaults to `default`. */
1346
- appearance?: Appearance;
1362
+ appearance?: Appearance$1;
1347
1363
  /** Size of the link. Defaults to `md`. */
1348
- size?: Size$2;
1364
+ size?: Size$3;
1349
1365
  /** Whether the link is disabled. */
1350
1366
  disabled?: boolean;
1351
1367
  /** Whether the link is in a pending state. */
@@ -1368,9 +1384,9 @@ declare const ButtonLink: <As extends React$2.ElementType = "a">(props: {
1368
1384
  /** Which visual style to use. Defaults to `secondary`. */
1369
1385
  variant?: Variant;
1370
1386
  /** Appearance to apply to the link. Defaults to `default`. */
1371
- appearance?: Appearance;
1387
+ appearance?: Appearance$1;
1372
1388
  /** Size of the link. Defaults to `md`. */
1373
- size?: Size$2;
1389
+ size?: Size$3;
1374
1390
  /** Whether the link is disabled. */
1375
1391
  disabled?: boolean;
1376
1392
  /** Whether the link is in a pending state. */
@@ -1394,9 +1410,9 @@ type IconButtonProps = {
1394
1410
  /** Which button style to use. Defaults to `secondary`. */
1395
1411
  variant?: Variant;
1396
1412
  /** Appearance to apply to the button. Defaults to `default`. */
1397
- appearance?: Appearance;
1413
+ appearance?: Appearance$1;
1398
1414
  /** Size of the button. Defaults to `md`. */
1399
- size?: Size$2;
1415
+ size?: Size$3;
1400
1416
  /** Whether the button is disabled. */
1401
1417
  disabled?: boolean;
1402
1418
  /** Whether the button is in a pending state. */
@@ -1415,9 +1431,9 @@ declare const IconButton: (props: {
1415
1431
  /** Which button style to use. Defaults to `secondary`. */
1416
1432
  variant?: Variant;
1417
1433
  /** Appearance to apply to the button. Defaults to `default`. */
1418
- appearance?: Appearance;
1434
+ appearance?: Appearance$1;
1419
1435
  /** Size of the button. Defaults to `md`. */
1420
- size?: Size$2;
1436
+ size?: Size$3;
1421
1437
  /** Whether the button is disabled. */
1422
1438
  disabled?: boolean;
1423
1439
  /** Whether the button is in a pending state. */
@@ -1426,6 +1442,55 @@ declare const IconButton: (props: {
1426
1442
  onClick?: React$2.ComponentProps<'button'>['onClick'];
1427
1443
  } & StylingOverrideProps & Omit<ButtonProps$1, "className" | "isDisabled" | "isPending" | "onClick"> & React$2.RefAttributes<HTMLButtonElement>) => React$2.ReactElement;
1428
1444
  //#endregion
1445
+ //#region src/components/ToggleButtonGroup/ToggleButtonGroup.d.ts
1446
+ type Size$2 = Extract<Size$3, 'sm' | 'md'>;
1447
+ type ToggleButtonGroupTextItem = {
1448
+ /** Unique identifier used for selection state. */
1449
+ key: Key$1;
1450
+ /** Button label rendered as visible text. */
1451
+ text: string;
1452
+ /** Optional icon rendered before the label. */
1453
+ icon?: SvgIcon;
1454
+ /** Whether the item is disabled. */
1455
+ disabled?: boolean;
1456
+ /** Optional accessible name when visible text is not sufficient. */
1457
+ 'aria-label'?: string;
1458
+ };
1459
+ type ToggleButtonGroupIconItem = {
1460
+ /** Unique identifier used for selection state. */
1461
+ key: Key$1;
1462
+ text?: never;
1463
+ /** Icon rendered in the button. */
1464
+ icon: SvgIcon;
1465
+ /** Whether the item is disabled. */
1466
+ disabled?: boolean;
1467
+ /** Accessible name for the icon-only button. */
1468
+ 'aria-label': string;
1469
+ };
1470
+ type ToggleButtonGroupItem = ToggleButtonGroupTextItem | ToggleButtonGroupIconItem;
1471
+ type ToggleButtonGroupProps = {
1472
+ /** Items to render as toggle buttons. */
1473
+ items: ToggleButtonGroupItem[];
1474
+ /** Size forwarded to every rendered button. Defaults to `md`. */
1475
+ size?: Size$2;
1476
+ /** Whether the entire group is disabled. */
1477
+ disabled?: boolean;
1478
+ /** Whether single or multiple selection is enabled. Defaults to `single`. */
1479
+ selectionMode?: 'single' | 'multiple';
1480
+ /** Controlled selected keys. */
1481
+ selectedKeys?: Iterable<Key$1>;
1482
+ /** Uncontrolled initial selected keys. */
1483
+ defaultSelectedKeys?: Iterable<Key$1>;
1484
+ /** Handler called when the selection changes. */
1485
+ onSelectionChange?: (keys: Set<Key$1>) => void;
1486
+ /** Whether the group must always have at least one selected item. */
1487
+ disallowEmptySelection?: boolean;
1488
+ } & StylingOverrideProps & AccessibleLabelProps & Omit<ToggleButtonGroupProps$1, 'children' | 'className' | 'isDisabled' | 'selectedKeys' | 'defaultSelectedKeys' | 'onSelectionChange' | 'selectionMode' | 'disallowEmptySelection' | 'aria-label' | 'aria-labelledby'>;
1489
+ /**
1490
+ * A group of toggle buttons for choosing one or more options from a set.
1491
+ */
1492
+ declare function ToggleButtonGroup({ items, size, disabled, selectionMode, selectedKeys, defaultSelectedKeys, onSelectionChange, disallowEmptySelection, FORCE__className: classNameOverride, ...props }: ToggleButtonGroupProps): React$2.JSX.Element;
1493
+ //#endregion
1429
1494
  //#region src/components/Link/Link.d.ts
1430
1495
  type LinkProps<As extends React$2.ElementType> = {
1431
1496
  /**
@@ -1922,6 +1987,11 @@ type MenuItemProps<As extends React$2.ElementType = 'a'> = Omit<React$2.Componen
1922
1987
  * Children for compound usage.
1923
1988
  */
1924
1989
  children?: React$2.ReactNode;
1990
+ /**
1991
+ * Allow items to wrap when they exceed the maximum width
1992
+ * @default false
1993
+ */
1994
+ allowItemLineWrap?: boolean;
1925
1995
  };
1926
1996
  interface MenuHeaderProps extends StylingOverrideProps {
1927
1997
  /**
@@ -2049,7 +2119,7 @@ declare const MenuSection$1: {
2049
2119
  displayName: string;
2050
2120
  };
2051
2121
  declare const MenuItem$1: {
2052
- <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;
2122
+ <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;
2053
2123
  displayName: string;
2054
2124
  };
2055
2125
  declare const MenuDivider: {
@@ -2278,12 +2348,115 @@ type CustomTooltipTriggerProps = {
2278
2348
  */
2279
2349
  declare const CustomTooltipTrigger: React$2.ForwardRefExoticComponent<CustomTooltipTriggerProps & React$2.RefAttributes<HTMLElement>>;
2280
2350
  //#endregion
2351
+ //#region src/components/FilterToolbar/FilterToolbar.d.ts
2352
+ type FilterToolbarProps = {
2353
+ /** props to pass to the filter TextField */
2354
+ filterInputProps?: TextFieldProps;
2355
+ /** Render function for filter related actions */
2356
+ renderActions?: () => React$2.ReactNode;
2357
+ /** Render function for bulk edit text */
2358
+ renderBulkEditText?: () => React$2.ReactNode;
2359
+ /** Render function for bulk edit related actions */
2360
+ renderBulkEditActions?: () => React$2.ReactNode;
2361
+ /** Set of selected keys, necessary to determine filter vs. bulk edit mode */
2362
+ selectedKeys: Selection;
2363
+ };
2364
+ declare function FilterToolbar({ filterInputProps, renderActions, renderBulkEditText, renderBulkEditActions, selectedKeys }: FilterToolbarProps): React$2.JSX.Element;
2365
+ //#endregion
2366
+ //#region src/components/Table/Table.d.ts
2367
+ declare const EMPTY_CELL_PLACEHOLDER = "--";
2368
+ type ResizingConfig = true | {
2369
+ minWidth?: ColumnProps['minWidth'];
2370
+ maxWidth?: ColumnProps['maxWidth'];
2371
+ width?: ColumnProps['width'];
2372
+ defaultWidth?: ColumnProps['defaultWidth'];
2373
+ };
2374
+ type ColumnConfig<T extends string | number, ItemRecord extends BaseItemRecord> = {
2375
+ id: T;
2376
+ label: string;
2377
+ allowsSorting?: boolean;
2378
+ resizing?: ResizingConfig;
2379
+ render?: (value: ItemRecord[T], item: ItemRecord) => React$2.ReactNode;
2380
+ };
2381
+ 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;
2382
+ type BaseItemRecord = {
2383
+ id: string | number;
2384
+ [key: string]: unknown;
2385
+ };
2386
+ type Density = 'default' | 'compact' | 'tight';
2387
+ type Appearance = 'zebra' | 'flat';
2388
+ type ColumnConfigUnion<ItemRecord extends BaseItemRecord> = { [K in StringKeys<ItemRecord>]: ColumnConfig<K, ItemRecord>; }[StringKeys<ItemRecord>];
2389
+ declare function defineColumns<ItemRecord extends BaseItemRecord>(columns: ColumnConfigUnion<ItemRecord>[]): ColumnConfig<StringKeys<ItemRecord>, ItemRecord>[];
2390
+ type TableProps<ItemRecord extends BaseItemRecord, ColumnKey extends StringKeys<ItemRecord> = StringKeys<ItemRecord>> = {
2391
+ /** The data to render as rows in the Table */
2392
+ items: ItemRecord[];
2393
+ /** The density of the table, affects row height */
2394
+ density?: Density;
2395
+ /** Whether to apply zebra-striping to rows */
2396
+ appearance?: Appearance;
2397
+ /** Key and direction for sorting the Table */
2398
+ sortDescriptor?: SortDescriptor;
2399
+ /** Callback function fired when a the sorting configuration is changed */
2400
+ onSortChange?: (sortDescriptor: SortDescriptor) => void;
2401
+ /** The columns to render in the Table */
2402
+ columns: ColumnConfig<ColumnKey, ItemRecord>[];
2403
+ /** Which columns should be visible */
2404
+ visibleColumns: ColumnKey[];
2405
+ /** Whether the table is in a loading state */
2406
+ isLoading?: boolean;
2407
+ /** Whether drag-and-dropping rows is enabled */
2408
+ enableDragAndDrop?: boolean;
2409
+ /** todo: is this prop needed? */
2410
+ renderActionColumn?: (item: ItemRecord) => React$2.ReactNode;
2411
+ /** Mode of row selection
2412
+ * @default 'none'
2413
+ */
2414
+ selectionMode?: SelectionMode;
2415
+ /** The currently selected keys (controlled) */
2416
+ selectedKeys?: Selection;
2417
+ /** Callback fired when selection changes */
2418
+ onSelectionChange?: (keys: Selection) => void;
2419
+ } & StylingOverrideProps & Omit<React$2.ComponentPropsWithoutRef<'table'>, 'className'>;
2420
+ /**
2421
+ * A component for rendering tabular data
2422
+ */
2423
+ declare const Table: <T extends BaseItemRecord>(props: {
2424
+ /** The data to render as rows in the Table */
2425
+ items: T[];
2426
+ /** The density of the table, affects row height */
2427
+ density?: Density;
2428
+ /** Whether to apply zebra-striping to rows */
2429
+ appearance?: Appearance;
2430
+ /** Key and direction for sorting the Table */
2431
+ sortDescriptor?: SortDescriptor;
2432
+ /** Callback function fired when a the sorting configuration is changed */
2433
+ onSortChange?: (sortDescriptor: SortDescriptor) => void;
2434
+ /** The columns to render in the Table */
2435
+ columns: ColumnConfig<StringKeys<T>, T>[];
2436
+ /** Which columns should be visible */
2437
+ visibleColumns: StringKeys<T>[];
2438
+ /** Whether the table is in a loading state */
2439
+ isLoading?: boolean;
2440
+ /** Whether drag-and-dropping rows is enabled */
2441
+ enableDragAndDrop?: boolean;
2442
+ /** todo: is this prop needed? */
2443
+ renderActionColumn?: ((item: T) => React$2.ReactNode) | undefined;
2444
+ /** Mode of row selection
2445
+ * @default 'none'
2446
+ */
2447
+ selectionMode?: SelectionMode;
2448
+ /** The currently selected keys (controlled) */
2449
+ selectedKeys?: Selection;
2450
+ /** Callback fired when selection changes */
2451
+ onSelectionChange?: (keys: Selection) => void;
2452
+ } & StylingOverrideProps & Omit<Omit<React$2.DetailedHTMLProps<React$2.TableHTMLAttributes<HTMLTableElement>, HTMLTableElement>, "ref">, "className"> & React$2.RefAttributes<HTMLTableElement>) => React$2.ReactElement;
2453
+ //#endregion
2281
2454
  //#region src/components/Tree/Tree.d.ts
2282
2455
  interface TreeItemType {
2283
2456
  /**
2284
2457
  * The unique key of the tree item.
2285
2458
  */
2286
- key: Key;
2459
+ key: Key$1;
2287
2460
  /**
2288
2461
  * The label of the tree item.
2289
2462
  */
@@ -2321,31 +2494,31 @@ type TreeProps = StylingOverrideProps & {
2321
2494
  /**
2322
2495
  * Handler that is called when a user performs an action on an item.
2323
2496
  */
2324
- onAction?: (key: Key) => void;
2497
+ onAction?: (key: Key$1) => void;
2325
2498
  /**
2326
2499
  * The initial expanded keys when in uncontrolled mode.
2327
2500
  */
2328
- defaultExpandedKeys?: Iterable<Key>;
2501
+ defaultExpandedKeys?: Iterable<Key$1>;
2329
2502
  /**
2330
2503
  * The initial selected keys when in uncontrolled mode.
2331
2504
  */
2332
- defaultSelectedKeys?: Iterable<Key>;
2505
+ defaultSelectedKeys?: Iterable<Key$1>;
2333
2506
  /**
2334
2507
  * The currently expanded keys when in controlled mode.
2335
2508
  */
2336
- expandedKeys?: Iterable<Key>;
2509
+ expandedKeys?: Iterable<Key$1>;
2337
2510
  /**
2338
2511
  * Handler that is called when the expanded keys change.
2339
2512
  */
2340
- onExpandedChange?: (keys: Set<Key>) => void;
2513
+ onExpandedChange?: (keys: Set<Key$1>) => void;
2341
2514
  /**
2342
2515
  * Callback that is fired when the selection changes.
2343
2516
  */
2344
- onSelectionChange?: (keys: Set<Key>) => void;
2517
+ onSelectionChange?: (keys: Set<Key$1>) => void;
2345
2518
  /**
2346
2519
  * The currently selected keys when in controlled mode.
2347
2520
  */
2348
- selectedKeys?: Iterable<Key>;
2521
+ selectedKeys?: Iterable<Key$1>;
2349
2522
  /**
2350
2523
  * The selection mode of the tree.
2351
2524
  * @default 'multiple'
@@ -2376,4 +2549,4 @@ declare const Label: React$2.ForwardRefExoticComponent<{
2376
2549
  trailingSlot?: React$2.ReactNode;
2377
2550
  } & StylingOverrideProps & Omit<Omit<React$2.DetailedHTMLProps<React$2.LabelHTMLAttributes<HTMLLabelElement>, HTMLLabelElement>, "ref">, "className" | "style"> & React$2.RefAttributes<HTMLLabelElement>>;
2378
2551
  //#endregion
2379
- 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, 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, 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 };
2552
+ 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 };