@baseline-ui/core 3.0.1 → 3.2.0

package/dist/chunk-UVVONIZB.mjs

@@ -0,0 +1,10 @@
+import {j,l,m,k,o,i,h}from'./chunk-75722G3R.mjs';import {a as a$3}from'./chunk-ECPG4S5O.mjs';import {a as a$2}from'./chunk-KCHAWPUN.mjs';import {b}from'./chunk-J3MJZQUJ.mjs';import {a}from'./chunk-F3HQNHR5.mjs';import {e}from'./chunk-B7PSE5KC.mjs';import {a as a$1}from'./chunk-4QEH5CGK.mjs';import z,{useEffect,useContext}from'react';import {jsxs,jsx}from'react/jsx-runtime';/**
+ * Copyright (c) 2023-2024 PSPDFKit GmbH. All rights reserved.
+ *
+ * THIS SOURCE CODE AND ANY ACCOMPANYING DOCUMENTATION ARE PROTECTED BY INTERNATIONAL COPYRIGHT LAW
+ * AND MAY NOT BE RESOLD OR REDISTRIBUTED. USAGE IS BOUND TO THE PSPDFKIT LICENSE AGREEMENT.
+ * UNAUTHORIZED REPRODUCTION OR DISTRIBUTION IS SUBJECT TO CIVIL AND CRIMINAL PENALTIES.
+ * This notice may not be removed from this file.
+ *
+ */
+var I="xyd2ss0 _1yep5z6n6 _1yep5z6n7 _1yep5z6n8 _1yep5z6pi _1yep5z6pj _1yep5z6pk _1yep5z6qo _1yep5z6qp _1yep5z6qq _1yep5z6oc _1yep5z6od _1yep5z6oe _1yep5z6ru _1yep5z6rv _1yep5z6rw _1yep5z6u6 _1yep5z6u7 _1yep5z6u8 _1yep5z6vc _1yep5z6vd _1yep5z6ve _1yep5z6t0 _1yep5z6t1 _1yep5z6t2 _1yep5z6wo _1yep5z6wp _1yep5z6wq _1yep5z6xc _1yep5z6xd _1yep5z6xe _1yep5z6y0 _1yep5z6y1 _1yep5z6y2 _1yep5z6yo _1yep5z6yp _1yep5z6yq _1yep5z617v _1yep5z617u _1yep5z6143 _1yep5z617y _1yep5z6124";var P=e=>e!=null&&typeof e=="object"&&!(Symbol.iterator in e);function G(e,o,r){let i=P(o)||P(r),s=o!=null&&!P(o)||r!=null&&!P(r);return e&&s?"Menu: an object `selectionMode` expects `selectedKeys`/`defaultSelectedKeys` to be records keyed by section id.":!e&&i?"Menu: a per-section `selectedKeys`/`defaultSelectedKeys` record requires the object form of `selectionMode`.":null}var Q=z.forwardRef(({defaultOpen:e,onOpenChange:o,isOpen:r,isDisabled:i,contentClassName:s,placement:l$1="bottom start",isNonModal:a$3,shouldFlip:c,shouldUpdatePosition:t,boundaryElement:M,boundaryAxis:p,horizontalBoundaryBehavior:d,crossOffset:_,offset:Z,triggerLabel:x,renderTrigger:v=({buttonProps:u,ref:y})=>jsx(b,{...u,variant:"popover",ref:y,"data-testid":"menu-trigger"}),portalContainer:$,selectionMode:m,selectedKeys:b$1,defaultSelectedKeys:S,onSelectionChange:K,disabledKeys:h,disallowEmptySelection:A,itemClassName:w,optionClassName:C,optionStyle:ee,renderOption:oe,...O},re)=>{let u=a($),y=m!=null&&typeof m=="object",N=z.useMemo(()=>h==null?void 0:new Set(h),[h]),te=z.useMemo(()=>w?(ne,ie)=>a$1(w,a$2(C,ne,ie)):C,[w,C]),k=G(y,b$1,S);if(k)throw new Error(k);return useEffect(()=>{!x&&!v&&console.warn("The `triggerLabel` prop is required when no `renderTrigger` or `children` is provided.");},[v,x]),jsxs(j,{defaultOpen:e,onOpenChange:o,isOpen:r,children:[jsx(W,{isDisabled:i,renderTrigger:v,triggerLabel:x}),jsx(X,{placement:l$1,isNonModal:a$3,shouldFlip:c,shouldUpdatePosition:t,boundaryElement:M,boundaryAxis:p,horizontalBoundaryBehavior:d,crossOffset:_,offset:Z||2,className:"BaselineUI-Menu-Popover",portalContainer:u,children:jsx(l,{...O,disabledKeys:N,...y?{}:{selectionMode:m,selectedKeys:b$1,defaultSelectedKeys:S,onSelectionChange:K,disallowEmptySelection:A},className:a$1(I,s),ref:re,children:V(O.items,u,{onAction:O.onAction,disabledKeys:N,contentClassName:s,optionClassName:te,optionStyle:ee,renderOption:oe,selection:y?{modes:m,selectedKeys:b$1,defaultSelectedKeys:S,onSelectionChange:K,disallowEmptySelection:A}:void 0})})})]})});function V(e,o$1,r){let{onAction:i,disabledKeys:s,contentClassName:l$1,selection:a,...c}=r;return e.map((t,M)=>{if("children"in t){let p=t,d=a?.modes[p.id];return jsx(m,{section:p,componentName:"Menu",isFirstCollectionItem:M===0,showSectionHeader:!!p.title,...c,...d?{selectionMode:d,selectedKeys:a?.selectedKeys?.[p.id],defaultSelectedKeys:a?.defaultSelectedKeys?.[p.id],disabledKeys:s,disallowEmptySelection:a?.disallowEmptySelection,onSelectionChange:_=>{a?.onSelectionChange?.(_,{sectionId:p.id});}}:{}},p.id)}return t.items?jsxs(k,{children:[jsx(o,{item:t,componentName:"Menu",...c}),jsx(X,{className:"BaselineUI-Menu-SubmenuPopover",portalContainer:o$1,children:jsx(l,{className:a$1(I,l$1),onAction:i,disabledKeys:s,children:V(t.items,o$1,r)})})]},t.id):jsx(o,{item:t,componentName:"Menu",...c},t.id)})}var W=z.forwardRef(({renderTrigger:e,triggerLabel:o,isDisabled:r,...i$1},s)=>{let l=useContext(i);return e?.({buttonProps:{...i$1,isDisabled:r,label:typeof o=="function"?o(l?.isOpen||false):o,isOpen:l?.isOpen||false,className:"BaselineUI-Menu-Trigger"},ref:s})});W.displayName="MyTrigger";var X=({children:e$1,...o})=>{let r=useContext(i),[i$1]=e(o,void 0,h);return r?.isOpen?jsx(a$3,{...i$1,state:r,children:e$1}):null};Q.displayName="Menu";export{Q as a};

package/dist/{chunk-VLQ4S7XC.mjs → chunk-WXWGGDTG.mjs}

@@ -1,4 +1,4 @@
-import {a,b as b$1,c as c$1,d}from'./chunk-VHDXSFQC.mjs';import {c}from'./chunk-6ZV4UYEG.mjs';import {b}from'./chunk-PAQQ7MQG.mjs';import {b as b$2}from'./chunk-TZ4MVY4E.mjs';import {a as a$1}from'./chunk-4QEH5CGK.mjs';import v,{useMemo}from'react';import {jsx}from'react/jsx-runtime';/**
+import {a,b as b$1,c as c$1,d}from'./chunk-VHDXSFQC.mjs';import {c}from'./chunk-L3SNGDBH.mjs';import {b}from'./chunk-PAQQ7MQG.mjs';import {b as b$2}from'./chunk-TZ4MVY4E.mjs';import {a as a$1}from'./chunk-4QEH5CGK.mjs';import v,{useMemo}from'react';import {jsx}from'react/jsx-runtime';/**
  * Copyright (c) 2023-2024 PSPDFKit GmbH. All rights reserved.
  *
  * THIS SOURCE CODE AND ANY ACCOMPANYING DOCUMENTATION ARE PROTECTED BY INTERNATIONAL COPYRIGHT LAW

package/dist/{chunk-RJC3HQDZ.mjs → chunk-X3NOIEDZ.mjs}

@@ -1,4 +1,4 @@
-import {b as b$4,a as a$7,c as c$4}from'./chunk-WOVAT6U4.mjs';import {c,d,b as b$5,e as e$1,f as f$2}from'./chunk-FJ2JRD3H.mjs';import {e,c as c$2,f as f$1}from'./chunk-O66FNQSB.mjs';import {a as a$9}from'./chunk-AZRPXTYJ.mjs';import {f,d as d$1}from'./chunk-YVYMYKYN.mjs';import {b as b$3}from'./chunk-246VHB32.mjs';import {a as a$1,c as c$3,b as b$7}from'./chunk-6ZV4UYEG.mjs';import {b as b$6}from'./chunk-PAQQ7MQG.mjs';import {a as a$6,b as b$1}from'./chunk-KCHAWPUN.mjs';import {a as a$a}from'./chunk-NSC53QWT.mjs';import {a as a$4}from'./chunk-O7XK2WIX.mjs';import {b as b$2}from'./chunk-N2XGJKZG.mjs';import {a}from'./chunk-66CUIXA6.mjs';import {a as a$3}from'./chunk-RSKKEGJZ.mjs';import {a as a$8}from'./chunk-K6X2BHPP.mjs';import {a as a$2}from'./chunk-3FYY26ED.mjs';import {b,c as c$1}from'./chunk-TZ4MVY4E.mjs';import {a as a$5}from'./chunk-4QEH5CGK.mjs';import B,{useRef,createElement,useContext,useEffect}from'react';import {CheckmarkIcon}from'@baseline-ui/icons/24';import {jsxs,jsx,Fragment}from'react/jsx-runtime';/**
+import {b as b$4,a as a$7,c as c$4}from'./chunk-WOVAT6U4.mjs';import {c,d,b as b$5,e as e$1,f as f$2}from'./chunk-FJ2JRD3H.mjs';import {e,c as c$2,f as f$1}from'./chunk-O66FNQSB.mjs';import {a as a$9}from'./chunk-AZRPXTYJ.mjs';import {f,d as d$1}from'./chunk-YVYMYKYN.mjs';import {b as b$3}from'./chunk-246VHB32.mjs';import {a as a$1,c as c$3,b as b$7}from'./chunk-L3SNGDBH.mjs';import {b as b$6}from'./chunk-PAQQ7MQG.mjs';import {a as a$6,b as b$1}from'./chunk-KCHAWPUN.mjs';import {a as a$a}from'./chunk-NSC53QWT.mjs';import {a as a$4}from'./chunk-O7XK2WIX.mjs';import {b as b$2}from'./chunk-N2XGJKZG.mjs';import {a}from'./chunk-66CUIXA6.mjs';import {a as a$3}from'./chunk-RSKKEGJZ.mjs';import {a as a$8}from'./chunk-K6X2BHPP.mjs';import {a as a$2}from'./chunk-3FYY26ED.mjs';import {b,c as c$1}from'./chunk-TZ4MVY4E.mjs';import {a as a$5}from'./chunk-4QEH5CGK.mjs';import B,{useRef,createElement,useContext,useEffect}from'react';import {CheckmarkIcon}from'@baseline-ui/icons/24';import {jsxs,jsx,Fragment}from'react/jsx-runtime';/**
  * Copyright (c) 2023-2024 PSPDFKit GmbH. All rights reserved.
  *
  * THIS SOURCE CODE AND ANY ACCOMPANYING DOCUMENTATION ARE PROTECTED BY INTERNATIONAL COPYRIGHT LAW

package/dist/{chunk-P6CAKOCM.mjs → chunk-Y45SV547.mjs}

@@ -1,4 +1,4 @@
-import {a as a$j}from'./chunk-FTYXFTJV.mjs';import {a as a$l}from'./chunk-4U2H67UB.mjs';import {c as c$4}from'./chunk-Q67U2HNE.mjs';import {c as c$2}from'./chunk-RJC3HQDZ.mjs';import {I,j,f,e,p,F,A,H,i,B,s,C,G,z,h,g,m,q,D,E,t,l,v,y,u,a as a$m,w,d,c as c$6,x,k,b as b$8,o,n,r}from'./chunk-7HZ5JFYX.mjs';import {a as a$6,b as b$7,c as c$5,d as d$1}from'./chunk-EU75HMPG.mjs';import {a as a$o}from'./chunk-NPJX2CEI.mjs';import {a as a$h}from'./chunk-5YYWD7PK.mjs';import {a as a$b}from'./chunk-PHDDEIWA.mjs';import {a as a$c}from'./chunk-RPF5NT6H.mjs';import {b as b$5,e as e$1}from'./chunk-BBS5ZRQE.mjs';import {a as a$d}from'./chunk-NSC53QWT.mjs';import {b as b$2,c as c$3}from'./chunk-GX2IOGYR.mjs';import {b as b$4}from'./chunk-J3MJZQUJ.mjs';import {a as a$g}from'./chunk-O7XK2WIX.mjs';import {a as a$k}from'./chunk-JB3O4ABN.mjs';import {a as a$f}from'./chunk-F6JQN7YM.mjs';import {a as a$9}from'./chunk-F3HQNHR5.mjs';import {a as a$n}from'./chunk-JJPCZOOI.mjs';import {a as a$i}from'./chunk-ZGRRD3TU.mjs';import {b as b$3}from'./chunk-N2XGJKZG.mjs';import {b}from'./chunk-4ZJMZB5B.mjs';import {b as b$6,j as j$1}from'./chunk-4NYPVKDO.mjs';import {a as a$8}from'./chunk-UUBOEBYZ.mjs';import {a as a$e}from'./chunk-VDUFLHKK.mjs';import {a as a$7}from'./chunk-4PYEGHW5.mjs';import {a as a$5}from'./chunk-66CUIXA6.mjs';import {a as a$a}from'./chunk-X3AXUU3H.mjs';import {a as a$1}from'./chunk-YS3Y5KGV.mjs';import {a as a$3}from'./chunk-RSKKEGJZ.mjs';import {a as a$2}from'./chunk-K6X2BHPP.mjs';import {a}from'./chunk-3FYY26ED.mjs';import {b as b$1,c as c$1}from'./chunk-TZ4MVY4E.mjs';import {c}from'./chunk-JDLUGVXG.mjs';import {g as g$1}from'./chunk-AUOQSTS5.mjs';import {a as a$4}from'./chunk-4QEH5CGK.mjs';import No,{useCallback,useMemo,useEffect}from'react';import {jsxs,jsx,Fragment}from'react/jsx-runtime';import {TextIcon,PlusIcon,MinusIcon}from'@baseline-ui/icons/20';import {sprinkles}from'@baseline-ui/tokens';/**
+import {a as a$j}from'./chunk-FTYXFTJV.mjs';import {a as a$l}from'./chunk-GZ5ZWXIC.mjs';import {c as c$4}from'./chunk-L452ID76.mjs';import {c as c$2}from'./chunk-X3NOIEDZ.mjs';import {I,j,f,e,p,F,A,H,i,B,s,C,G,z,h,g,m,q,D,E,t,l,v,y,u,a as a$m,w,d,c as c$6,x,k,b as b$8,o,n,r}from'./chunk-7HZ5JFYX.mjs';import {a as a$6,b as b$7,c as c$5,d as d$1}from'./chunk-EU75HMPG.mjs';import {a as a$o}from'./chunk-NPJX2CEI.mjs';import {a as a$h}from'./chunk-5YYWD7PK.mjs';import {a as a$b}from'./chunk-ECPG4S5O.mjs';import {a as a$c}from'./chunk-5PIO6M4F.mjs';import {b as b$5,e as e$1}from'./chunk-DF3BVX5Z.mjs';import {a as a$d}from'./chunk-NSC53QWT.mjs';import {b as b$2,c as c$3}from'./chunk-GX2IOGYR.mjs';import {b as b$4}from'./chunk-J3MJZQUJ.mjs';import {a as a$g}from'./chunk-O7XK2WIX.mjs';import {a as a$k}from'./chunk-JB3O4ABN.mjs';import {a as a$f}from'./chunk-F6JQN7YM.mjs';import {a as a$9}from'./chunk-F3HQNHR5.mjs';import {a as a$n}from'./chunk-JJPCZOOI.mjs';import {a as a$i}from'./chunk-ZGRRD3TU.mjs';import {b as b$3}from'./chunk-N2XGJKZG.mjs';import {b}from'./chunk-4ZJMZB5B.mjs';import {b as b$6,j as j$1}from'./chunk-4NYPVKDO.mjs';import {a as a$8}from'./chunk-UUBOEBYZ.mjs';import {a as a$e}from'./chunk-VDUFLHKK.mjs';import {a as a$7}from'./chunk-4PYEGHW5.mjs';import {a as a$5}from'./chunk-66CUIXA6.mjs';import {a as a$a}from'./chunk-X3AXUU3H.mjs';import {a as a$1}from'./chunk-YS3Y5KGV.mjs';import {a as a$3}from'./chunk-RSKKEGJZ.mjs';import {a as a$2}from'./chunk-K6X2BHPP.mjs';import {a}from'./chunk-3FYY26ED.mjs';import {b as b$1,c as c$1}from'./chunk-TZ4MVY4E.mjs';import {c}from'./chunk-JDLUGVXG.mjs';import {g as g$1}from'./chunk-AUOQSTS5.mjs';import {a as a$4}from'./chunk-4QEH5CGK.mjs';import No,{useCallback,useMemo,useEffect}from'react';import {jsxs,jsx,Fragment}from'react/jsx-runtime';import {TextIcon,PlusIcon,MinusIcon}from'@baseline-ui/icons/20';import {sprinkles}from'@baseline-ui/tokens';/**
  * Copyright (c) 2023-2024 PSPDFKit GmbH. All rights reserved.
  *
  * THIS SOURCE CODE AND ANY ACCOMPANYING DOCUMENTATION ARE PROTECTED BY INTERNATIONAL COPYRIGHT LAW

package/dist/hooks/useContainerScopedRef.mjs

@@ -0,0 +1 @@
+export{a as useContainerScopedRef}from'../chunk-4BYKAG4W.mjs';import'../chunk-XPISSX5R.mjs';

package/dist/index.d.ts

@@ -3829,6 +3829,21 @@ interface OverlayProps {
     isExiting?: boolean;
 }
 
+interface MenuItemRenderProps extends ItemRenderProps {
+    /**
+     * Whether the item has a submenu.
+     *
+     * @selector [data-has-submenu]
+     */
+    hasSubmenu: boolean;
+    /**
+     * Whether the item's submenu is open.
+     *
+     * @selector [data-open]
+     */
+    isOpen: boolean;
+}
+
 interface ProgressBarBaseProps {
     /**
      * The current value (controlled).
@@ -5889,6 +5904,13 @@ interface ListOption<T = Record<string, any>> {
     icon?: React__default.FC<IconProps>;
     data?: T;
 }
+/**
+ * Keep keyboardShortcut on the shared item so it survives typed collection rebuilding.
+ */
+type CollectionOptionItem = ListOption & {
+    /** A label for the option's trailing slot, such as a keyboard shortcut (`"⌘K"`). */
+    keyboardShortcut?: string;
+};
 interface ListSection<T = Record<string, any>> {
     id: string;
     title?: string;
@@ -6831,12 +6853,121 @@ declare const PopoverTrigger: React__default.FC<PopoverTriggerProps>;
 
 declare const Popover: React__default.FC<PopoverProps>;
 
-type MenuOption = Omit<ListOption, "description"> & {
-    keyboardShortcut?: string;
+interface ListHandle {
+    /** Scrolls the listbox to the specified item. */
+    scrollIntoView: (id: string, options?: ScrollIntoViewOptions) => void;
+    /** Imperatively focuses the specified key */
+    setFocusedKey: (key: string) => void;
+}
+interface CollectionOptionRenderProps<TOption extends ListOption = ListOption, TRenderProps extends ListBoxItemRenderProps = ListBoxItemRenderProps> {
+    /**
+     * The custom render function for the collection's options.
+     *
+     * Replaces the option's entire contents, the default selection indicator
+     * included, so render your own affordance from `options` when you need one.
+     * The hover, focus and disabled styling lives in that default body too —
+     * only selection and keyboard behavior are unaffected. Keep a text label in
+     * the output; it is what names the option to a screen reader.
+     *
+     * Reading component state here works, at the cost of rebuilding every cached option and
+     * section whenever the function's identity changes — see {@link UNSAFE_ListBoxProps.items}
+     * for when that cost applies.
+     */
+    renderOption?: (item: TOption, options: TRenderProps) => React__default.ReactNode;
+    /**
+     * A CSS class name added to the option's built-in classes.
+     *
+     * Compared by identity, so an inline function or an unmemoized value rebuilds every
+     * cached option and section on each render. A plain string is compared by value.
+     */
+    optionClassName?: string | ((item: TOption, renderProps: TRenderProps) => string | undefined);
+    /**
+     * The style of the option.
+     *
+     * Compared by identity, so an inline function or object literal rebuilds every cached
+     * option and section on each render — memoize it to avoid that.
+     */
+    optionStyle?: React__default.CSSProperties | ((item: TOption, renderProps: TRenderProps) => React__default.CSSProperties | undefined);
+}
+interface CollectionSectionRenderProps {
+    /**
+     * The custom render function for the listbox sections.
+     *
+     * Reading component state here works, at the cost of rebuilding every cached option and
+     * section whenever the function's identity changes — see {@link UNSAFE_ListBoxProps.items}
+     * for when that cost applies.
+     *
+     * @param section ListSection
+     */
+    renderSectionHeader?: (section: ListSection) => React__default.ReactNode;
+    /**
+     * The CSS class name for the section.
+     *
+     * Compared by identity, so an inline function or an unmemoized value rebuilds every
+     * cached option and section on each render. A plain string is compared by value.
+     */
+    sectionClassName?: string | ((section: ListSection) => string | undefined);
+    /**
+     * The style of the section.
+     *
+     * Compared by identity, so an inline function or object literal rebuilds every cached
+     * option and section on each render — memoize it to avoid that.
+     */
+    sectionStyle?: React__default.CSSProperties | ((section: ListSection) => React__default.CSSProperties | undefined);
+    /**
+     * Whether to show each section title when provided.
+     *
+     * @default false
+     */
+    showSectionHeader?: boolean;
+    /**
+     * Wether to add initial padding to section titles if shown.
+     *
+     * @default false
+     */
+    withSectionHeaderPadding?: boolean;
+}
+type CollectionRenderProps = CollectionOptionRenderProps & CollectionSectionRenderProps;
+interface UNSAFE_ListBoxProps extends StylingProps, Omit<AriaListBoxProps<ListItem> & AriaListBoxOptions<ListItem>, "children" | "linkBehavior" | "isVirtualized" | "keyboardDelegate" | "items">, Pick<ListBoxProps$1<ListItem>, "dragAndDropHooks" | "orientation" | "layout" | "dependencies">, CollectionRenderProps {
+    /**
+     * The items to render in the listbox. Items have the following shape:
+     *
+     * ```ts
+     * export type ListOption = {
+     *   id: string;
+     *   label: string;
+     *   description?: string;
+     *   icon?: React.FC<IconProps>;
+     * };
+     *
+     * export type ListSection = {
+     *   id: string;
+     *   title?: string;
+     *   type: "section";
+     *   children: ListOption[];
+     * };
+     *
+     * type ListItem = ListOption | ListSection;
+     * ```
+     *
+     * Rendered options and sections are cached per item object. Building this array inline
+     * (`items={data.map(...)}`) produces new item objects every render, so nothing is ever
+     * reused and the customisation props cost nothing; memoize it and the cache applies,
+     * which is when their identity starts to matter.
+     */
+    items?: ListItem[];
+    /** The label for the listbox. */
+    label?: React__default.ReactNode;
+    /** Handle to access the listbox methods. */
+    listBoxHandle?: React__default.RefObject<ListHandle>;
+}
+
+type MenuOption = Omit<CollectionOptionItem, "description"> & {
     /**
      * Nested menu items. When present, this option becomes a submenu trigger that
-     * opens a nested menu instead of acting as a leaf action. Recursive: a submenu
-     * may itself contain leaf options, sections, or deeper submenus.
+     * opens a nested menu instead of acting as a leaf action, and spends its
+     * trailing `keyboardShortcut` slot on a chevron. Recursive: a submenu may
+     * itself contain leaf options, sections, or deeper submenus.
      */
     items?: MenuItem[];
 };
@@ -6846,12 +6977,17 @@ type MenuSection = Omit<ListSection, "children"> & {
 type MenuItem = MenuOption | MenuSection;
 type MenuPopoverProps = Pick<PopoverContentProps, "isNonModal" | "placement" | "shouldUpdatePosition" | "shouldFlip" | "boundaryElement" | "boundaryAxis" | "horizontalBoundaryBehavior" | "crossOffset" | "offset" | "portalContainer">;
 type MenuSelectionKeys = "selectionMode" | "selectedKeys" | "defaultSelectedKeys" | "onSelectionChange";
-interface MenuPropsBase extends MenuPopoverProps, MenuTriggerProps, Omit<AriaMenuProps<MenuItem>, "children" | MenuSelectionKeys>, Omit<AriaMenuTriggerProps, "type"> {
+interface MenuPropsBase extends MenuPopoverProps, MenuTriggerProps, CollectionOptionRenderProps<MenuOption, MenuItemRenderProps>, Omit<AriaMenuProps<MenuItem>, "children" | MenuSelectionKeys>, Omit<AriaMenuTriggerProps, "type"> {
     /** The `className` property assigned to the root element of the component. */
     className?: string;
     /** The `className` property assigned to the content element of the component. */
     contentClassName?: string;
-    /** The `className` property assigned to the item element of the component. */
+    /**
+     * The `className` property assigned to the item element of the component.
+     *
+     * @deprecated Use `optionClassName`, which also accepts a function of the item
+     * and its render state. Both are applied when set.
+     */
     itemClassName?: string;
     /**
      * A list of items to render in the menu. See `MenuItem`.
@@ -8140,116 +8276,6 @@ declare const Accordion: React__default.ForwardRefExoticComponent<AccordionProps
 
 declare const AccordionItem: React__default.ForwardRefExoticComponent<AccordionItemProps & React__default.RefAttributes<HTMLHeadingElement>>;
 
-interface ListHandle {
-    /** Scrolls the listbox to the specified item. */
-    scrollIntoView: (id: string, options?: ScrollIntoViewOptions) => void;
-    /** Imperatively focuses the specified key */
-    setFocusedKey: (key: string) => void;
-}
-interface CollectionOptionRenderProps {
-    /**
-     * The custom render function for the listbox options.
-     *
-     * Replaces the option's entire contents, including the default selection
-     * indicator — render your own affordance from `options.isSelected` if you
-     * need one. Selection and keyboard behavior are unaffected.
-     *
-     * Reading component state here works, at the cost of rebuilding every cached option and
-     * section whenever the function's identity changes — see {@link UNSAFE_ListBoxProps.items}
-     * for when that cost applies.
-     *
-     * @param item ListOption
-     * @param options ListBoxItemRenderProps
-     */
-    renderOption?: (item: ListOption, options: ListBoxItemRenderProps) => React__default.ReactNode;
-    /**
-     * A CSS class name added to the option's built-in classes.
-     *
-     * Compared by identity, so an inline function or an unmemoized value rebuilds every
-     * cached option and section on each render. A plain string is compared by value.
-     */
-    optionClassName?: string | ((item: ListOption, renderProps: ListBoxItemRenderProps) => string | undefined);
-    /**
-     * The style of the option.
-     *
-     * Compared by identity, so an inline function or object literal rebuilds every cached
-     * option and section on each render — memoize it to avoid that.
-     */
-    optionStyle?: React__default.CSSProperties | ((item: ListOption, renderProps: ListBoxItemRenderProps) => React__default.CSSProperties | undefined);
-}
-interface CollectionSectionRenderProps {
-    /**
-     * The custom render function for the listbox sections.
-     *
-     * Reading component state here works, at the cost of rebuilding every cached option and
-     * section whenever the function's identity changes — see {@link UNSAFE_ListBoxProps.items}
-     * for when that cost applies.
-     *
-     * @param section ListSection
-     */
-    renderSectionHeader?: (section: ListSection) => React__default.ReactNode;
-    /**
-     * The CSS class name for the section.
-     *
-     * Compared by identity, so an inline function or an unmemoized value rebuilds every
-     * cached option and section on each render. A plain string is compared by value.
-     */
-    sectionClassName?: string | ((section: ListSection) => string | undefined);
-    /**
-     * The style of the section.
-     *
-     * Compared by identity, so an inline function or object literal rebuilds every cached
-     * option and section on each render — memoize it to avoid that.
-     */
-    sectionStyle?: React__default.CSSProperties | ((section: ListSection) => React__default.CSSProperties | undefined);
-    /**
-     * Whether to show each section title when provided.
-     *
-     * @default false
-     */
-    showSectionHeader?: boolean;
-    /**
-     * Wether to add initial padding to section titles if shown.
-     *
-     * @default false
-     */
-    withSectionHeaderPadding?: boolean;
-}
-type CollectionRenderProps = CollectionOptionRenderProps & CollectionSectionRenderProps;
-interface UNSAFE_ListBoxProps extends StylingProps, Omit<AriaListBoxProps<ListItem> & AriaListBoxOptions<ListItem>, "children" | "linkBehavior" | "isVirtualized" | "keyboardDelegate" | "items">, Pick<ListBoxProps$1<ListItem>, "dragAndDropHooks" | "orientation" | "layout" | "dependencies">, CollectionRenderProps {
-    /**
-     * The items to render in the listbox. Items have the following shape:
-     *
-     * ```ts
-     * export type ListOption = {
-     *   id: string;
-     *   label: string;
-     *   description?: string;
-     *   icon?: React.FC<IconProps>;
-     * };
-     *
-     * export type ListSection = {
-     *   id: string;
-     *   title?: string;
-     *   type: "section";
-     *   children: ListOption[];
-     * };
-     *
-     * type ListItem = ListOption | ListSection;
-     * ```
-     *
-     * Rendered options and sections are cached per item object. Building this array inline
-     * (`items={data.map(...)}`) produces new item objects every render, so nothing is ever
-     * reused and the customisation props cost nothing; memoize it and the cache applies,
-     * which is when their identity starts to matter.
-     */
-    items?: ListItem[];
-    /** The label for the listbox. */
-    label?: React__default.ReactNode;
-    /** Handle to access the listbox methods. */
-    listBoxHandle?: React__default.RefObject<ListHandle>;
-}
-
 type SelectionMode = "single" | "multiple";
 interface SelectProps<M extends SelectionMode = SelectionMode> extends Omit<AriaSelectOptions<ListItem, M> & SelectStateOptions<ListItem, M> & PopoverContentProps, "validationState" | "items" | "children" | "isRequired" | "className" | "style" | "triggerRef" | "validate" | "validationBehavior" | "keyboardDelegate" | "state" | "overlayProps">, Pick<UNSAFE_ListBoxProps, "items" | "optionStyle" | "optionClassName" | "showSectionHeader">, Pick<ColorInputProps, "onTriggerPress">, StylingProps {
     /**
@@ -10569,7 +10595,7 @@ interface ColorSwatchPickerProps extends StylingProps, Pick<RadioGroupProps, "op
 
 declare const ColorSwatchPicker: React__default.ForwardRefExoticComponent<ColorSwatchPickerProps & React__default.RefAttributes<HTMLDivElement>>;
 
-declare const TimeField: React__default.ForwardRefExoticComponent<StylingProps & Omit<Omit<TimeFieldStateOptions<TimeValue>, "locale"> & AriaTimeFieldProps<TimeValue>, "isRequired" | "validate" | "validationState" | "isInvalid"> & Pick<SharedInputProps, "label" | "variant" | "validationState" | "labelPosition"> & InputMessage & React__default.RefAttributes<HTMLDivElement>>;
+declare const TimeField: React__default.ForwardRefExoticComponent<StylingProps & Omit<Omit<TimeFieldStateOptions<TimeValue>, "locale"> & AriaTimeFieldProps<TimeValue>, "validationState" | "isRequired" | "validate" | "isInvalid"> & Pick<SharedInputProps, "label" | "variant" | "validationState" | "labelPosition"> & InputMessage & React__default.RefAttributes<HTMLDivElement>>;
 
 type TimeFieldProps = StylingProps & Omit<Omit<TimeFieldStateOptions, "locale"> & AriaTimeFieldProps<TimeValue>, "validationState" | "isInvalid" | "isRequired" | "validate"> & Pick<SharedInputProps, "variant" | "labelPosition" | "validationState" | "label"> & InputMessage;
 
@@ -10848,7 +10874,7 @@ type DateFieldProps = StylingProps & Omit<Omit<DateFieldStateOptions, "locale">
     openCalendarLabel?: string;
 };
 
-declare const DateField: React__default.ForwardRefExoticComponent<StylingProps & Omit<Omit<DateFieldStateOptions<DateValue>, "locale"> & AriaDateFieldProps<DateValue>, "isRequired" | "validate" | "validationState" | "isInvalid" | "createCalendar"> & Pick<SharedInputProps, "label" | "variant" | "validationState" | "labelPosition"> & InputMessage & {
+declare const DateField: React__default.ForwardRefExoticComponent<StylingProps & Omit<Omit<DateFieldStateOptions<DateValue>, "locale"> & AriaDateFieldProps<DateValue>, "validationState" | "isRequired" | "validate" | "isInvalid" | "createCalendar"> & Pick<SharedInputProps, "label" | "variant" | "validationState" | "labelPosition"> & InputMessage & {
     pickerType?: DateFieldPickerType;
     openCalendarLabel?: string;
 } & React__default.RefAttributes<HTMLDivElement>>;