@eqtylab/equality 4.14.1 → 5.0.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.cts CHANGED
@@ -1,14 +1,13 @@
1
1
  import * as class_variance_authority_types from 'class-variance-authority/types';
2
2
  import * as react_jsx_runtime from 'react/jsx-runtime';
3
3
  import * as React$1 from 'react';
4
- import { HTMLAttributes, ReactNode, ComponentPropsWithoutRef } from 'react';
4
+ import { HTMLAttributes, ReactNode, KeyboardEvent, ComponentPropsWithoutRef } from 'react';
5
5
  import * as AlertDialogPrimitive from '@radix-ui/react-alert-dialog';
6
6
  import { VariantProps } from 'class-variance-authority';
7
7
  import * as AvatarPrimitive from '@radix-ui/react-avatar';
8
8
  import * as CheckboxPrimitive from '@radix-ui/react-checkbox';
9
9
  import { Command as Command$1 } from 'cmdk';
10
10
  import * as DialogPrimitive from '@radix-ui/react-dialog';
11
- import { Drawer as Drawer$1 } from 'vaul';
12
11
  import * as DropdownMenuPrimitive from '@radix-ui/react-dropdown-menu';
13
12
  import * as _radix_ui_react_slot from '@radix-ui/react-slot';
14
13
  import * as react_hook_form from 'react-hook-form';
@@ -18,7 +17,6 @@ import * as LucideIcons from 'lucide-react';
18
17
  import * as PopoverPrimitive from '@radix-ui/react-popover';
19
18
  import * as ProgressPrimitive from '@radix-ui/react-progress';
20
19
  import * as RadioGroupPrimitive from '@radix-ui/react-radio-group';
21
- import * as ScrollAreaPrimitive from '@radix-ui/react-scroll-area';
22
20
  import * as SelectPrimitive from '@radix-ui/react-select';
23
21
  import * as SeparatorPrimitive from '@radix-ui/react-separator';
24
22
  import * as SwitchPrimitives from '@radix-ui/react-switch';
@@ -891,147 +889,6 @@ interface DisplayFieldProps extends Omit<React.HTMLAttributes<HTMLDivElement>, '
891
889
  */
892
890
  declare function DisplayField({ className, variant, elevation, children, prefix, truncate, copy, actions, slot, ...props }: DisplayFieldProps): react_jsx_runtime.JSX.Element;
893
891
 
894
- /**
895
- * **Props**
896
- * - `activeSnapPoint?: string | number | null`
897
- * - `setActiveSnapPoint?: (snapPoint: string | number | null) => void`
898
- * - `children?: ReactNode`
899
- * - `open?: boolean`
900
- * - `closeThreshold?: number` (default `0.25`) — Number between 0 and 1 that determines when the drawer should be closed.
901
- * Example: threshold of 0.5 would close the drawer if the user swiped for 50% of the height of the drawer or more.
902
- * - `noBodyStyles?: boolean` — When `true` the `body` doesn't get any styles assigned from Vaul
903
- * - `onOpenChange?: (open: boolean) => void`
904
- * - `shouldScaleBackground?: boolean` (default `true`)
905
- * - `setBackgroundColorOnScale?: boolean` (default `true`) — When `false` we don't change body's background color when the drawer is open.
906
- * - `scrollLockTimeout?: number` (default `500ms`) — Duration for which the drawer is not draggable after scrolling content inside of the drawer.
907
- * - `fixed?: boolean` — When `true`, don't move the drawer upwards if there's space, but rather only change it's height so it's fully scrollable when the keyboard is open
908
- * - `handleOnly?: boolean` (default `false`) — When `true` only allows the drawer to be dragged by the `<Drawer.Handle />` component.
909
- * - `dismissible?: boolean` (default `true`) — When `false` dragging, clicking outside, pressing esc, etc. will not close the drawer.
910
- * Use this in comination with the `open` prop, otherwise you won't be able to open/close the drawer.
911
- * - `onDrag?: (event: PointerEvent<HTMLDivElement>, percentageDragged: number) => void`
912
- * - `onRelease?: (event: PointerEvent<HTMLDivElement>, open: boolean) => void`
913
- * - `modal?: boolean` (default `true`) — When `false` it allows to interact with elements outside of the drawer without closing it.
914
- * - `nested?: boolean`
915
- * - `onClose?: () => void`
916
- * - `direction?: "top" | "bottom" | "left" | "right"` (default `'bottom'`) — Direction of the drawer. Can be `top` or `bottom`, `left`, `right`.
917
- * - `defaultOpen?: boolean` (default `false`) — Opened by default, skips initial enter animation. Still reacts to `open` state changes
918
- * - `disablePreventScroll?: boolean` (default `false`) — When set to `true` prevents scrolling on the document body on mount, and restores it on unmount.
919
- * - `repositionInputs?: boolean` (default `true when {@link snapPoints } is defined`) — When `true` Vaul will reposition inputs rather than scroll then into view if the keyboard is in the way.
920
- * Setting it to `false` will fall back to the default browser behavior.
921
- * - `snapToSequentialPoint?: boolean` (default `false`) — Disabled velocity based swiping for snap points.
922
- * This means that a snap point won't be skipped even if the velocity is high enough.
923
- * Useful if each snap point in a drawer is equally important.
924
- * - `container?: HTMLElement | null`
925
- * - `onAnimationEnd?: (open: boolean) => void` — Gets triggered after the open or close animation ends, it receives an `open` argument with the `open` state of the drawer by the time the function was triggered.
926
- * Useful to revert any state changes for example.
927
- * - `preventScrollRestoration?: boolean`
928
- * - `autoFocus?: boolean`
929
- * - `snapPoints?: (string | number)[]` — Array of numbers from 0 to 100 that corresponds to % of the screen a given snap point should take up.
930
- * Should go from least visible. Example `[0.2, 0.5, 0.8]`.
931
- * You can also use px values, which doesn't take screen height into account.
932
- * - `fadeFromIndex?: number` — Index of a `snapPoint` from which the overlay fade should be applied. Defaults to the last snap point.
933
- */
934
- declare const Drawer: {
935
- ({ shouldScaleBackground, ...props }: React$1.ComponentProps<typeof Drawer$1.Root>): react_jsx_runtime.JSX.Element;
936
- displayName: string;
937
- };
938
- /**
939
- * **Props**
940
- * - `asChild?: boolean`
941
- *
942
- * Also accepts the standard `HTMLButtonElement` attributes, such as `className`, `id`, `aria-*` and event handlers.
943
- */
944
- declare const DrawerTrigger: React$1.ForwardRefExoticComponent<DialogPrimitive.DialogTriggerProps & React$1.RefAttributes<HTMLButtonElement>>;
945
- /**
946
- * **Props**
947
- * - `children: React.ReactNode`
948
- */
949
- declare const DrawerPortal: ({ children }: {
950
- children: React$1.ReactNode;
951
- }) => react_jsx_runtime.JSX.Element;
952
- /**
953
- * **Props**
954
- * - `asChild?: boolean`
955
- *
956
- * Also accepts the standard `HTMLButtonElement` attributes, such as `className`, `id`, `aria-*` and event handlers.
957
- */
958
- declare const DrawerClose: React$1.ForwardRefExoticComponent<DialogPrimitive.DialogCloseProps & React$1.RefAttributes<HTMLButtonElement>>;
959
- /**
960
- * **Props**
961
- * - `asChild?: boolean`
962
- * - `forceMount?: true` — Used to force mounting when more control is needed. Useful when
963
- * controlling animation with React animation libraries.
964
- *
965
- * Also accepts the standard `HTMLDivElement` attributes, such as `className`, `id`, `aria-*` and event handlers.
966
- */
967
- declare const DrawerOverlay: React$1.ForwardRefExoticComponent<Omit<Omit<DialogPrimitive.DialogOverlayProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
968
- /**
969
- * **Props**
970
- * - `asChild?: boolean`
971
- * - `onEscapeKeyDown?: (event: KeyboardEvent) => void` — Event handler called when the escape key is down.
972
- * Can be prevented.
973
- * - `onPointerDownOutside?: (event: PointerDownOutsideEvent) => void` — Event handler called when the a `pointerdown` event happens outside of the `DismissableLayer`.
974
- * Can be prevented.
975
- * - `onFocusOutside?: (event: FocusOutsideEvent) => void` — Event handler called when the focus moves outside of the `DismissableLayer`.
976
- * Can be prevented.
977
- * - `onInteractOutside?: (event: FocusOutsideEvent | PointerDownOutsideEvent) => void` — Event handler called when an interaction happens outside the `DismissableLayer`.
978
- * Specifically, when a `pointerdown` event happens outside or focus moves outside of it.
979
- * Can be prevented.
980
- * - `onOpenAutoFocus?: (event: Event) => void` — Event handler called when auto-focusing on open.
981
- * Can be prevented.
982
- * - `onCloseAutoFocus?: (event: Event) => void` — Event handler called when auto-focusing on close.
983
- * Can be prevented.
984
- * - `forceMount?: true` — Used to force mounting when more control is needed. Useful when
985
- * controlling animation with React animation libraries.
986
- *
987
- * Also accepts the standard `HTMLDivElement` attributes, such as `className`, `id`, `aria-*` and event handlers.
988
- */
989
- declare const DrawerContent: React$1.ForwardRefExoticComponent<Omit<Omit<DialogPrimitive.DialogContentProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
990
- /**
991
- * Accepts the standard `HTMLDivElement` attributes, such as `className`, `id`, `aria-*` and event handlers.
992
- */
993
- declare const DrawerHeader: {
994
- ({ className, ...props }: React$1.HTMLAttributes<HTMLDivElement>): react_jsx_runtime.JSX.Element;
995
- displayName: string;
996
- };
997
- /**
998
- * **Props**
999
- * - `rowSpan: number`
1000
- *
1001
- * Also accepts the standard `HTMLDivElement` attributes, such as `className`, `id`, `aria-*` and event handlers.
1002
- */
1003
- declare const DrawerHeaderActions: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & {
1004
- rowSpan: number;
1005
- } & React$1.RefAttributes<HTMLDivElement>>;
1006
- /**
1007
- * Accepts the standard `HTMLDivElement` attributes, such as `className`, `id`, `aria-*` and event handlers.
1008
- */
1009
- declare const DrawerFooter: {
1010
- ({ className, ...props }: React$1.HTMLAttributes<HTMLDivElement>): react_jsx_runtime.JSX.Element;
1011
- displayName: string;
1012
- };
1013
- /**
1014
- * **Props**
1015
- * - `asChild?: boolean`
1016
- *
1017
- * Also accepts the standard `HTMLHeadingElement` attributes, such as `className`, `id`, `aria-*` and event handlers.
1018
- */
1019
- declare const DrawerTitle: React$1.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogTitleProps & React$1.RefAttributes<HTMLHeadingElement>, "ref"> & React$1.RefAttributes<HTMLHeadingElement>>;
1020
- /**
1021
- * **Props**
1022
- * - `asChild?: boolean`
1023
- *
1024
- * Also accepts the standard `HTMLParagraphElement` attributes, such as `className`, `id`, `aria-*` and event handlers.
1025
- */
1026
- declare const DrawerDescription: React$1.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogDescriptionProps & React$1.RefAttributes<HTMLParagraphElement>, "ref"> & React$1.RefAttributes<HTMLParagraphElement>>;
1027
- /**
1028
- * Accepts the standard `HTMLDivElement` attributes, such as `className`, `id`, `aria-*` and event handlers.
1029
- */
1030
- declare const DrawerInnerContent: {
1031
- ({ className, ...props }: React$1.HTMLAttributes<HTMLDivElement>): react_jsx_runtime.JSX.Element;
1032
- displayName: string;
1033
- };
1034
-
1035
892
  declare const useDropdownMenuSearchQuery: () => {
1036
893
  query: string;
1037
894
  isSearching: boolean;
@@ -1119,7 +976,7 @@ declare const DropdownMenuSubTrigger: React$1.ForwardRefExoticComponent<Omit<Dro
1119
976
  * - `arrowPadding?: number`
1120
977
  * - `avoidCollisions?: boolean`
1121
978
  * - `collisionBoundary?: Boundary | Boundary[]`
1122
- * - `collisionPadding?: number | Partial<Record<"top" | "bottom" | "left" | "right", number>>`
979
+ * - `collisionPadding?: number | Partial<Record<"top" | "right" | "bottom" | "left", number>>`
1123
980
  * - `sticky?: "partial" | "always"`
1124
981
  * - `hideWhenDetached?: boolean`
1125
982
  * - `updatePositionStrategy?: "optimized" | "always"`
@@ -1151,14 +1008,14 @@ declare const DropdownMenuSub: ({ children, ...props }: React$1.ComponentPropsWi
1151
1008
  * - `forceMount?: true` — Used to force mounting when more control is needed. Useful when
1152
1009
  * controlling animation with React animation libraries.
1153
1010
  * - `loop?: boolean` — Whether keyboard navigation should loop around
1154
- * - `side?: "top" | "bottom" | "left" | "right"`
1011
+ * - `side?: "top" | "right" | "bottom" | "left"`
1155
1012
  * - `sideOffset?: number` (default `4`)
1156
1013
  * - `align?: "center" | "start" | "end"`
1157
1014
  * - `alignOffset?: number`
1158
1015
  * - `arrowPadding?: number`
1159
1016
  * - `avoidCollisions?: boolean`
1160
1017
  * - `collisionBoundary?: Boundary | Boundary[]`
1161
- * - `collisionPadding?: number | Partial<Record<"top" | "bottom" | "left" | "right", number>>`
1018
+ * - `collisionPadding?: number | Partial<Record<"top" | "right" | "bottom" | "left", number>>`
1162
1019
  * - `sticky?: "partial" | "always"`
1163
1020
  * - `hideWhenDetached?: boolean`
1164
1021
  * - `updatePositionStrategy?: "optimized" | "always"`
@@ -1513,7 +1370,7 @@ interface IconButtonProps extends Omit<React$1.ButtonHTMLAttributes<HTMLButtonEl
1513
1370
  *
1514
1371
  * [Icon Button documentation](https://equality.eqtylab.io/components/icon-button)
1515
1372
  */
1516
- declare function IconButton({ className, size, variant, name, label, href, target, download, disabled, ...props }: IconButtonProps): react_jsx_runtime.JSX.Element;
1373
+ declare const IconButton: React$1.ForwardRefExoticComponent<IconButtonProps & React$1.RefAttributes<HTMLButtonElement | HTMLAnchorElement>>;
1517
1374
 
1518
1375
  declare const iconVariants: (props?: ({
1519
1376
  size?: "sm" | "md" | "lg" | "xs" | null | undefined;
@@ -1598,27 +1455,6 @@ declare const Input: React$1.ForwardRefExoticComponent<Omit<React$1.InputHTMLAtt
1598
1455
  */
1599
1456
  declare const Label: React$1.ForwardRefExoticComponent<Omit<LabelPrimitive.LabelProps & React$1.RefAttributes<HTMLLabelElement>, "ref"> & VariantProps<(props?: class_variance_authority_types.ClassProp | undefined) => string> & React$1.RefAttributes<HTMLLabelElement>>;
1600
1457
 
1601
- type ViewMode = 'grid' | 'list';
1602
- type ViewOrder = ['grid', 'list'] | ['list', 'grid'];
1603
- interface ListOrGridViewToggleProps {
1604
- viewMode: ViewMode;
1605
- onViewModeChange: (mode: ViewMode) => void;
1606
- order?: ViewOrder;
1607
- className?: string;
1608
- }
1609
- /**
1610
- * **Props**
1611
- * - `viewMode: "grid" | "list"`
1612
- * - `onViewModeChange: (mode: ViewMode) => void`
1613
- * - `order?: ViewOrder` (default `['grid', 'list']`)
1614
- * - `className?: string`
1615
- *
1616
- * [List or Grid View Toggle documentation](https://equality.eqtylab.io/components/list-or-grid-view-toggle)
1617
- *
1618
- * @deprecated Use `SegmentedControls` instead.
1619
- */
1620
- declare const ListOrGridViewToggle: ({ viewMode, onViewModeChange, order, className, }: ListOrGridViewToggleProps) => react_jsx_runtime.JSX.Element;
1621
-
1622
1458
  interface LoadingOverlayProps {
1623
1459
  isVisible: boolean;
1624
1460
  message?: string;
@@ -1671,6 +1507,223 @@ interface MotionCollapsibleContentProps {
1671
1507
  */
1672
1508
  declare const MotionCollapsibleContent: ({ isOpen, children, className, }: MotionCollapsibleContentProps) => react_jsx_runtime.JSX.Element;
1673
1509
 
1510
+ type NavDrillRequest = 'drill' | 'back';
1511
+ interface NavDrillProps extends React$1.HTMLAttributes<HTMLDivElement> {
1512
+ /** Controlled: the `value` of the level on show */
1513
+ value?: string;
1514
+ /** Uncontrolled: the `value` of the first level */
1515
+ defaultValue?: string;
1516
+ /** Called when a drill row or ‹ asks for a level; a controlled caller sets `value` from it */
1517
+ onValueChange?: (value: string, request: NavDrillRequest) => void;
1518
+ /** Slides levels in and out after a drill row or ‹; off swaps them at once */
1519
+ animate?: boolean;
1520
+ }
1521
+ /**
1522
+ * **Props**
1523
+ * - `value?: string` — Controlled: the `value` of the level on show
1524
+ * - `defaultValue?: string` — Uncontrolled: the `value` of the first level
1525
+ * - `onValueChange?: (value: string, request: NavDrillRequest) => void` — Called when a drill row or ‹ asks for a level; a controlled caller sets `value` from it
1526
+ * - `animate?: boolean` (default `true`) — Slides levels in and out after a drill row or ‹; off swaps them at once
1527
+ *
1528
+ * Also accepts the standard `HTMLDivElement` attributes, such as `className`, `id`, `aria-*` and event handlers.
1529
+ */
1530
+ declare const NavDrill: React$1.ForwardRefExoticComponent<NavDrillProps & React$1.RefAttributes<HTMLDivElement>>;
1531
+ interface NavDrillLevelBaseProps extends React$1.HTMLAttributes<HTMLDivElement> {
1532
+ /** The `NavDrill` value that shows this level; must be a direct child of `NavDrill` */
1533
+ value: string;
1534
+ }
1535
+ interface NavDrillChildLevelProps extends NavDrillLevelBaseProps {
1536
+ /** The `value` ‹ returns to; draws the ‹ row at the top of the level */
1537
+ parent?: string;
1538
+ /** Names where you are, on the ‹ row */
1539
+ label: string;
1540
+ /** The ‹ row's accessible name; must start with `label` (WCAG 2.5.3). @default "{label}, back" */
1541
+ backLabel?: string;
1542
+ }
1543
+ interface NavDrillTopLevelProps extends NavDrillLevelBaseProps {
1544
+ parent?: undefined;
1545
+ label?: undefined;
1546
+ backLabel?: undefined;
1547
+ }
1548
+ type NavDrillLevelProps = NavDrillChildLevelProps | NavDrillTopLevelProps;
1549
+ /**
1550
+ * **Props**
1551
+ * - `value: string` — The `NavDrill` value that shows this level; must be a direct child of `NavDrill`
1552
+ * - `parent?: string` — The `value` ‹ returns to; draws the ‹ row at the top of the level
1553
+ * - `label?: string` — Names where you are, on the ‹ row
1554
+ * - `backLabel?: string` (default `"{label}, back"`) — The ‹ row's accessible name; must start with `label` (WCAG 2.5.3).
1555
+ *
1556
+ * Also accepts the standard `HTMLDivElement` attributes, such as `className`, `id`, `aria-*` and event handlers.
1557
+ */
1558
+ declare const NavDrillLevel: React$1.ForwardRefExoticComponent<NavDrillLevelProps & React$1.RefAttributes<HTMLDivElement>>;
1559
+
1560
+ type NavListProps = React$1.HTMLAttributes<HTMLDivElement>;
1561
+ /**
1562
+ * Accepts the standard `HTMLDivElement` attributes, such as `className`, `id`, `aria-*` and event handlers.
1563
+ */
1564
+ declare const NavList: React$1.ForwardRefExoticComponent<NavListProps & React$1.RefAttributes<HTMLDivElement>>;
1565
+ interface NavListGroupProps extends React$1.HTMLAttributes<HTMLDivElement> {
1566
+ /** Names the group's list; leave it out where a ‹ row already names what the rows belong to */
1567
+ label?: string;
1568
+ }
1569
+ /**
1570
+ * **Props**
1571
+ * - `label?: string` — Names the group's list; leave it out where a ‹ row already names what the rows belong to
1572
+ *
1573
+ * Also accepts the standard `HTMLDivElement` attributes, such as `className`, `id`, `aria-*` and event handlers.
1574
+ */
1575
+ declare const NavListGroup: React$1.ForwardRefExoticComponent<NavListGroupProps & React$1.RefAttributes<HTMLDivElement>>;
1576
+ interface NavListItemProps extends Omit<React$1.HTMLAttributes<HTMLElement>, 'prefix'>, Pick<React$1.AnchorHTMLAttributes<HTMLAnchorElement>, 'href' | 'target' | 'rel' | 'download'> {
1577
+ /** The row's text, also its full title when it truncates */
1578
+ label: string;
1579
+ /** An icon before the label, on top-level rows only; hidden from screen readers */
1580
+ prefix?: React$1.ReactNode;
1581
+ /** Badges or marks after the label; screen readers read them as part of the row */
1582
+ suffix?: React$1.ReactNode;
1583
+ /** Marks the row as the page on show */
1584
+ current?: boolean;
1585
+ /** The `value` of the `NavDrillLevel` this row opens; adds the › caret */
1586
+ drill?: string;
1587
+ /** Renders the row as its only child, such as a router link */
1588
+ asChild?: boolean;
1589
+ }
1590
+ /**
1591
+ * **Props**
1592
+ * - `label: string` — The row's text, also its full title when it truncates
1593
+ * - `prefix?: React.ReactNode` — An icon before the label, on top-level rows only; hidden from screen readers
1594
+ * - `suffix?: React.ReactNode` — Badges or marks after the label; screen readers read them as part of the row
1595
+ * - `current?: boolean` (default `false`) — Marks the row as the page on show
1596
+ * - `drill?: string` — The `value` of the `NavDrillLevel` this row opens; adds the › caret
1597
+ * - `asChild?: boolean` (default `false`) — Renders the row as its only child, such as a router link
1598
+ *
1599
+ * Also accepts the standard `HTMLElement` attributes, such as `className`, `id`, `aria-*` and event handlers.
1600
+ */
1601
+ declare const NavListItem: React$1.ForwardRefExoticComponent<NavListItemProps & React$1.RefAttributes<HTMLElement>>;
1602
+ /**
1603
+ * Accepts the standard `HTMLElement` attributes, such as `className`, `id`, `aria-*` and event handlers.
1604
+ */
1605
+ declare const NavListSeparator: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLElement> & React$1.RefAttributes<HTMLElement>>;
1606
+
1607
+ interface NavPanelProps extends Omit<React$1.HTMLAttributes<HTMLElement>, 'title'> {
1608
+ /** Names the panel's landmark */
1609
+ 'aria-label': string;
1610
+ /** Above the rows, such as a `NavSwitcher` or a heading */
1611
+ header?: React$1.ReactNode;
1612
+ }
1613
+ /**
1614
+ * **Props**
1615
+ * - `"aria-label": string` — Names the panel's landmark
1616
+ * - `header?: React.ReactNode` — Above the rows, such as a `NavSwitcher` or a heading
1617
+ *
1618
+ * Also accepts the standard `HTMLElement` attributes, such as `className`, `id`, `aria-*` and event handlers.
1619
+ *
1620
+ * [Nav documentation](https://equality.eqtylab.io/components/nav)
1621
+ */
1622
+ declare const NavPanel: React$1.ForwardRefExoticComponent<NavPanelProps & React$1.RefAttributes<HTMLElement>>;
1623
+
1624
+ interface NavRailProps extends React$1.HTMLAttributes<HTMLElement> {
1625
+ /** Names the rail's landmark */
1626
+ 'aria-label': string;
1627
+ }
1628
+ /**
1629
+ * **Props**
1630
+ * - `"aria-label": string` — Names the rail's landmark
1631
+ *
1632
+ * Also accepts the standard `HTMLElement` attributes, such as `className`, `id`, `aria-*` and event handlers.
1633
+ *
1634
+ * [Nav documentation](https://equality.eqtylab.io/components/nav)
1635
+ */
1636
+ declare const NavRail: React$1.ForwardRefExoticComponent<NavRailProps & React$1.RefAttributes<HTMLElement>>;
1637
+ interface NavRailItemBaseProps extends Omit<React$1.AnchorHTMLAttributes<HTMLAnchorElement>, 'href'> {
1638
+ /** The item's only visible content; hidden from screen readers */
1639
+ icon: React$1.ReactNode;
1640
+ /** The item's accessible name and its tooltip */
1641
+ label: string;
1642
+ /** Marks the item as the section on show */
1643
+ current?: boolean;
1644
+ }
1645
+ interface NavRailItemLinkProps extends NavRailItemBaseProps {
1646
+ /** Where the item goes */
1647
+ href: string;
1648
+ asChild?: false;
1649
+ }
1650
+ interface NavRailItemSlotProps extends NavRailItemBaseProps {
1651
+ href?: string;
1652
+ /** Renders the item as its only child, such as a router link */
1653
+ asChild: true;
1654
+ }
1655
+ type NavRailItemProps = NavRailItemLinkProps | NavRailItemSlotProps;
1656
+ /**
1657
+ * **Props**
1658
+ * - `icon: React.ReactNode` — The item's only visible content; hidden from screen readers
1659
+ * - `label: string` — The item's accessible name and its tooltip
1660
+ * - `current?: boolean` (default `false`) — Marks the item as the section on show
1661
+ * - `href?: string` — Where the item goes
1662
+ * - `asChild?: false | true` (default `false`) — Renders the item as its only child, such as a router link
1663
+ *
1664
+ * Also accepts the standard `HTMLAnchorElement` attributes, such as `className`, `id`, `aria-*` and event handlers.
1665
+ *
1666
+ * [Nav documentation](https://equality.eqtylab.io/components/nav)
1667
+ */
1668
+ declare const NavRailItem: React$1.ForwardRefExoticComponent<NavRailItemProps & React$1.RefAttributes<HTMLAnchorElement>>;
1669
+
1670
+ interface NavSwitcherOption {
1671
+ /** The option's value, passed to `onValueChange` */
1672
+ value: string;
1673
+ /** The option's name in the list */
1674
+ label: string;
1675
+ /** Matched by search as well as the label, for identifiers a user may know but never sees */
1676
+ keywords?: string[];
1677
+ }
1678
+ interface NavSwitcherAction {
1679
+ /** The action's link text */
1680
+ label: string;
1681
+ /** Runs once the list has closed */
1682
+ onSelect: () => void;
1683
+ }
1684
+ interface NavSwitcherLoadedProps {
1685
+ /** Shows a placeholder at the switcher's height while the current item loads */
1686
+ loading?: false;
1687
+ /** The current item's name, shown as the panel's heading */
1688
+ label: string;
1689
+ /** Singular and lowercase, for the trigger's name: "{label}, switch {noun}" */
1690
+ noun: string;
1691
+ /** Plural and lowercase, for the search and empty copy */
1692
+ collection: string;
1693
+ /** The items to switch between */
1694
+ options: NavSwitcherOption[];
1695
+ /** The current item's value */
1696
+ value: string;
1697
+ /** Called with the picked item's value */
1698
+ onValueChange: (value: string) => void;
1699
+ /** Hover or focus on an option, for a caller that preloads its destination */
1700
+ onHighlight?: (value: string) => void;
1701
+ /** Hover or focus leaves an option, for a caller that cancels its preload */
1702
+ onHighlightEnd?: () => void;
1703
+ /** A command at the bottom of the list, kept while searching, such as "Create Project" */
1704
+ action?: NavSwitcherAction;
1705
+ }
1706
+ interface NavSwitcherLoadingProps {
1707
+ loading: true;
1708
+ }
1709
+ type NavSwitcherProps = NavSwitcherLoadedProps | NavSwitcherLoadingProps;
1710
+ /**
1711
+ * **Props**
1712
+ * - `loading?: false | true` — Shows a placeholder at the switcher's height while the current item loads
1713
+ * - `label?: string` — The current item's name, shown as the panel's heading
1714
+ * - `noun?: string` — Singular and lowercase, for the trigger's name: "{label}, switch {noun}"
1715
+ * - `collection?: string` — Plural and lowercase, for the search and empty copy
1716
+ * - `options?: NavSwitcherOption[]` — The items to switch between
1717
+ * - `value?: string` — The current item's value
1718
+ * - `onValueChange?: (value: string) => void` — Called with the picked item's value
1719
+ * - `onHighlight?: (value: string) => void` — Hover or focus on an option, for a caller that preloads its destination
1720
+ * - `onHighlightEnd?: () => void` — Hover or focus leaves an option, for a caller that cancels its preload
1721
+ * - `action?: NavSwitcherAction` — A command at the bottom of the list, kept while searching, such as "Create Project"
1722
+ *
1723
+ * [Nav documentation](https://equality.eqtylab.io/components/nav)
1724
+ */
1725
+ declare const NavSwitcher: React$1.ForwardRefExoticComponent<NavSwitcherProps & React$1.RefAttributes<HTMLButtonElement>>;
1726
+
1674
1727
  interface NotFoundProps {
1675
1728
  className?: string;
1676
1729
  title?: string;
@@ -1777,14 +1830,14 @@ declare const PopoverTrigger: React$1.ForwardRefExoticComponent<PopoverPrimitive
1777
1830
  * Can be prevented.
1778
1831
  * - `forceMount?: true` — Used to force mounting when more control is needed. Useful when
1779
1832
  * controlling animation with React animation libraries.
1780
- * - `side?: "top" | "bottom" | "left" | "right"`
1833
+ * - `side?: "top" | "right" | "bottom" | "left"`
1781
1834
  * - `sideOffset?: number` (default `4`)
1782
1835
  * - `align?: "center" | "start" | "end"` (default `"center"`)
1783
1836
  * - `alignOffset?: number`
1784
1837
  * - `arrowPadding?: number`
1785
1838
  * - `avoidCollisions?: boolean`
1786
1839
  * - `collisionBoundary?: Boundary | Boundary[]`
1787
- * - `collisionPadding?: number | Partial<Record<"top" | "bottom" | "left" | "right", number>>`
1840
+ * - `collisionPadding?: number | Partial<Record<"top" | "right" | "bottom" | "left", number>>`
1788
1841
  * - `sticky?: "partial" | "always"`
1789
1842
  * - `hideWhenDetached?: boolean`
1790
1843
  * - `updatePositionStrategy?: "optimized" | "always"`
@@ -1974,35 +2027,6 @@ interface ResourceBadgeProps {
1974
2027
  */
1975
2028
  declare const ResourceBadge: ({ type, display, closeable, handleClosable, closeLabel, children, }: ResourceBadgeProps) => react_jsx_runtime.JSX.Element;
1976
2029
 
1977
- /**
1978
- * **Props**
1979
- * - `type?: "auto" | "always" | "scroll" | "hover"`
1980
- * - `dir?: "ltr" | "rtl"`
1981
- * - `asChild?: boolean`
1982
- * - `scrollHideDelay?: number`
1983
- *
1984
- * Also accepts the standard `HTMLDivElement` attributes, such as `className`, `id`, `aria-*` and event handlers.
1985
- *
1986
- * [Scroll Area documentation](https://equality.eqtylab.io/components/scroll-area)
1987
- *
1988
- * @deprecated Use a native scrollable element instead — set an overflow and a height on your own
1989
- * container and leave the browser's scrollbar unstyled.
1990
- */
1991
- declare const ScrollArea: React$1.ForwardRefExoticComponent<Omit<ScrollAreaPrimitive.ScrollAreaProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
1992
- /**
1993
- * **Props**
1994
- * - `asChild?: boolean`
1995
- * - `forceMount?: true`
1996
- * - `orientation?: "horizontal" | "vertical"` (default `"vertical"`)
1997
- *
1998
- * Also accepts the standard `HTMLDivElement` attributes, such as `className`, `id`, `aria-*` and event handlers.
1999
- *
2000
- * [Scroll Area documentation](https://equality.eqtylab.io/components/scroll-area)
2001
- *
2002
- * @deprecated Part of the deprecated `ScrollArea`. Use a native scrollable element instead.
2003
- */
2004
- declare const ScrollBar: React$1.ForwardRefExoticComponent<Omit<ScrollAreaPrimitive.ScrollAreaScrollbarProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
2005
-
2006
2030
  interface SearchBarProps {
2007
2031
  className?: string;
2008
2032
  placeholder?: string;
@@ -2150,14 +2174,14 @@ declare const SelectTrigger: React$1.ForwardRefExoticComponent<Omit<SelectPrimit
2150
2174
  * Can be prevented.
2151
2175
  * - `onCloseAutoFocus?: (event: Event) => void` — Event handler called when auto-focusing on close.
2152
2176
  * Can be prevented.
2153
- * - `side?: "top" | "bottom" | "left" | "right"`
2177
+ * - `side?: "top" | "right" | "bottom" | "left"`
2154
2178
  * - `sideOffset?: number`
2155
2179
  * - `align?: "center" | "start" | "end"`
2156
2180
  * - `alignOffset?: number`
2157
2181
  * - `arrowPadding?: number`
2158
2182
  * - `avoidCollisions?: boolean`
2159
2183
  * - `collisionBoundary?: Boundary | Boundary[]`
2160
- * - `collisionPadding?: number | Partial<Record<"top" | "bottom" | "left" | "right", number>>`
2184
+ * - `collisionPadding?: number | Partial<Record<"top" | "right" | "bottom" | "left", number>>`
2161
2185
  * - `sticky?: "partial" | "always"`
2162
2186
  * - `hideWhenDetached?: boolean`
2163
2187
  * - `updatePositionStrategy?: "optimized" | "always"`
@@ -2229,6 +2253,8 @@ declare const SelectSeparator: React$1.ForwardRefExoticComponent<Omit<SelectPrim
2229
2253
  persistent?: boolean;
2230
2254
  } & React$1.RefAttributes<HTMLDivElement>>;
2231
2255
 
2256
+ declare const blockClosedTypeahead: (event: KeyboardEvent<HTMLButtonElement>) => void;
2257
+
2232
2258
  /**
2233
2259
  * **Props**
2234
2260
  * - `asChild?: boolean`
@@ -2835,14 +2861,14 @@ declare const TooltipTrigger: React$1.ForwardRefExoticComponent<TooltipPrimitive
2835
2861
  * Can be prevented.
2836
2862
  * - `forceMount?: true` — Used to force mounting when more control is needed. Useful when
2837
2863
  * controlling animation with React animation libraries.
2838
- * - `side?: "top" | "bottom" | "left" | "right"`
2864
+ * - `side?: "top" | "right" | "bottom" | "left"`
2839
2865
  * - `sideOffset?: number` (default `4`)
2840
2866
  * - `align?: "center" | "start" | "end"`
2841
2867
  * - `alignOffset?: number`
2842
2868
  * - `arrowPadding?: number`
2843
2869
  * - `avoidCollisions?: boolean`
2844
2870
  * - `collisionBoundary?: Boundary | Boundary[]`
2845
- * - `collisionPadding?: number | Partial<Record<"top" | "bottom" | "left" | "right", number>>`
2871
+ * - `collisionPadding?: number | Partial<Record<"top" | "right" | "bottom" | "left", number>>`
2846
2872
  * - `sticky?: "partial" | "always"`
2847
2873
  * - `hideWhenDetached?: boolean`
2848
2874
  * - `updatePositionStrategy?: "optimized" | "always"`
@@ -2899,7 +2925,7 @@ declare const ThemeProvider: ({ customVars, portalContainer, children }: ThemePr
2899
2925
  declare const PORTAL_ROOT_ID = "equality-theme-provider-root-portal";
2900
2926
  /**
2901
2927
  * Container for portalled surfaces — tooltips, popovers, selects, dialogs, sheets,
2902
- * drawers, dropdown menus.
2928
+ * dropdown menus.
2903
2929
  *
2904
2930
  * Resolves to whatever the nearest `PortalContainerProvider` supplies, falling back to
2905
2931
  * looking up `#equality-theme-provider-root-portal` in the document so consumers
@@ -2914,7 +2940,7 @@ interface PortalContainerProviderProps {
2914
2940
  }
2915
2941
  /**
2916
2942
  * Supplies the container for portalled surfaces — tooltips, popovers, selects, dialogs,
2917
- * sheets, drawers, dropdown menus.
2943
+ * sheets, dropdown menus.
2918
2944
  *
2919
2945
  * `ThemeProvider` renders one of these automatically, so most consumers never need it
2920
2946
  * directly. Reach for it when the container has to be an element you own:
@@ -2958,4 +2984,4 @@ declare const CODE_BLOCK_ATTRIBUTE = "data-equality-code-block";
2958
2984
  */
2959
2985
  declare const scheduleHighlight: (root?: Node) => Promise<void>;
2960
2986
 
2961
- export { Alert, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, Avatar, AvatarFallback, AvatarImage, Badge, type BadgeDisplayMode, type BadgeProps, BarGraph, type BarGraphProps, BarGraphSegment, type BarGraphSegmentProps, BgGradient, Button, type ButtonProps, CODE_BLOCK_ATTRIBUTE, Card, CardContent, CardContentHeader, type CardContentHeaderProps, CardDescription, CardFooter, CardHeader, CardTitle, Checkbox, CodeBlock, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, ControlStatusBadge, type ControlStatusBadgeDisplayMode, CopyButton, type CopyButtonProps, DateRangePicker, Dialog, DialogClose, DialogContainer, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogHeaderIcon, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DisplayField, type DisplayFieldProps, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerHeaderActions, DrawerInnerContent, DrawerOverlay, DrawerPortal, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuEmpty, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSearch, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, ELEVATION, type Elevation, EmptyTableState, FilterDropdown, Form, FormControl, FormDescription, FormField, FormItem, FormLabel, FormMessage, FormatDate, type FormatDateDisplayMode, type FormatDateProps, Heading, Icon, IconButton, type IconButtonProps, type IconProps, InfoCard, Input, type InputProps, Label, ListOrGridViewToggle, LoadingOverlay, MetricCard, MotionCollapsibleContent, NotFound, PORTAL_ROOT_ID, Pagination, PanelLabel, Popover, PopoverContent, PopoverTrigger, PortalContainerProvider, Progress, ProgressIndicator, type ProgressIndicatorProps, ProgressIndicatorStep, type ProgressIndicatorStepProps, RadialGraph, type RadialGraphProps, RadioDropdown, RadioGroup, RadioGroupItem, ResourceBadge, type ResourceDisplayMode, type ResourceType, ScrollArea, ScrollBar, SearchBar, SectionHeading, type SegmentedControlOption, type SegmentedControlVariant, SegmentedControls, type SegmentedControlsDisplay, type SegmentedControlsProps, type SegmentedControlsSize, Select, SelectContent, SelectEmpty, SelectGroup, SelectItem, SelectLabel, SelectSearch, SelectSeparator, SelectTrigger, SelectValue, Separator, Sheet, SheetClose, SheetContainer, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetHeaderIcon, SheetOverlay, SheetPortal, SheetTitle, SheetTrigger, Skeleton, SortButton, type SortField, type SortMode, type SortOrder, SortSelector, Spinner, Switch, TableBody, TableCaption, TableCell, TableContainer, TableFooter, TableHead, TableHeader, TableRow, Tabs, TabsContainer, TabsContent, TabsList, TabsTrigger, Textarea, type Theme, ThemeProvider, Toast, ToastAction, type ToastActionElement, ToastClose, ToastContainer, ToastDescription, type ToastProps$1 as ToastProps, ToastProvider, ToastRoot, ToastTitle, ToastViewport, Toaster, type ToasterToast, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, TruncatedDescription, type ViewMode, type ViewOrder, badgeVariants, buttonVariants, reducer, scheduleHighlight, toast, useDropdownMenuSearchQuery, useFormField, usePortalContainer, useSelectSearchQuery, useTheme, useToast };
2987
+ export { Alert, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, Avatar, AvatarFallback, AvatarImage, Badge, type BadgeDisplayMode, type BadgeProps, BarGraph, type BarGraphProps, BarGraphSegment, type BarGraphSegmentProps, BgGradient, Button, type ButtonProps, CODE_BLOCK_ATTRIBUTE, Card, CardContent, CardContentHeader, type CardContentHeaderProps, CardDescription, CardFooter, CardHeader, CardTitle, Checkbox, CodeBlock, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, ControlStatusBadge, type ControlStatusBadgeDisplayMode, CopyButton, type CopyButtonProps, DateRangePicker, Dialog, DialogClose, DialogContainer, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogHeaderIcon, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DisplayField, type DisplayFieldProps, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuEmpty, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSearch, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, ELEVATION, type Elevation, EmptyTableState, FilterDropdown, Form, FormControl, FormDescription, FormField, FormItem, FormLabel, FormMessage, FormatDate, type FormatDateDisplayMode, type FormatDateProps, Heading, Icon, IconButton, type IconButtonProps, type IconProps, InfoCard, Input, type InputProps, Label, LoadingOverlay, MetricCard, MotionCollapsibleContent, NavDrill, NavDrillLevel, type NavDrillLevelProps, type NavDrillProps, type NavDrillRequest, NavList, NavListGroup, type NavListGroupProps, NavListItem, type NavListItemProps, type NavListProps, NavListSeparator, NavPanel, type NavPanelProps, NavRail, NavRailItem, type NavRailItemProps, type NavRailProps, NavSwitcher, type NavSwitcherAction, type NavSwitcherOption, type NavSwitcherProps, NotFound, PORTAL_ROOT_ID, Pagination, PanelLabel, Popover, PopoverContent, PopoverTrigger, PortalContainerProvider, Progress, ProgressIndicator, type ProgressIndicatorProps, ProgressIndicatorStep, type ProgressIndicatorStepProps, RadialGraph, type RadialGraphProps, RadioDropdown, RadioGroup, RadioGroupItem, ResourceBadge, type ResourceDisplayMode, type ResourceType, SearchBar, SectionHeading, type SegmentedControlOption, type SegmentedControlVariant, SegmentedControls, type SegmentedControlsDisplay, type SegmentedControlsProps, type SegmentedControlsSize, Select, SelectContent, SelectEmpty, SelectGroup, SelectItem, SelectLabel, SelectSearch, SelectSeparator, SelectTrigger, SelectValue, Separator, Sheet, SheetClose, SheetContainer, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetHeaderIcon, SheetOverlay, SheetPortal, SheetTitle, SheetTrigger, Skeleton, SortButton, type SortField, type SortMode, type SortOrder, SortSelector, Spinner, Switch, TableBody, TableCaption, TableCell, TableContainer, TableFooter, TableHead, TableHeader, TableRow, Tabs, TabsContainer, TabsContent, TabsList, TabsTrigger, Textarea, type Theme, ThemeProvider, Toast, ToastAction, type ToastActionElement, ToastClose, ToastContainer, ToastDescription, type ToastProps$1 as ToastProps, ToastProvider, ToastRoot, ToastTitle, ToastViewport, Toaster, type ToasterToast, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, TruncatedDescription, badgeVariants, blockClosedTypeahead, buttonVariants, reducer, scheduleHighlight, toast, useDropdownMenuSearchQuery, useFormField, usePortalContainer, useSelectSearchQuery, useTheme, useToast };