@bazza-ui/react 0.0.0 → 0.1.0-canary.10

package/dist/internal/popup-menu/index.d.cts

@@ -0,0 +1,238 @@
+import { F as FocusOwnerStore, O as OpenChainStore, M as MenuTreeResolver, V as VirtualizationConfig, P as PopupMenuDebugOptions, v as VirtualAnchor } from '../../scroll-arrow-B81wZTZ2.cjs';
+export { b as PopupMenuArrow, h as PopupMenuArrowProps, c as PopupMenuBackdrop, i as PopupMenuBackdropProps, w as PopupMenuContext, r as PopupMenuContextValue, p as PopupMenuListCssVars, d as PopupMenuPopup, j as PopupMenuPopupProps, t as PopupMenuPopupState, e as PopupMenuPortal, k as PopupMenuPortalProps, q as PopupMenuPositionerCssVars, a as PopupMenuRootActions, l as PopupMenuScrollArrowProps, m as PopupMenuScrollArrowState, f as PopupMenuScrollDownArrow, n as PopupMenuScrollDownArrowProps, g as PopupMenuScrollUpArrow, o as PopupMenuScrollUpArrowProps, U as UsePopupMenuRootParams, u as useMaybePopupMenuContext, s as usePopupMenuContext, x as usePopupMenuRoot } from '../../scroll-arrow-B81wZTZ2.cjs';
+import * as React from 'react';
+import { p as SubpageStackContextValue, S as SubmenuContextValue, o as SubpageContextValue } from '../../type-guards-BC2B6bVi.cjs';
+export { P as PopupMenuGroupValue, a as PopupMenuPositioner, h as PopupMenuPositionerAlign, i as PopupMenuPositionerProps, b as PopupMenuRadioItemIndicator, j as PopupMenuRadioItemIndicatorProps, k as PopupMenuRadioItemIndicatorState, c as PopupMenuSubmenuRoot, l as PopupMenuSubmenuRootProps, d as PopupMenuSubmenuTriggerIndicator, m as PopupMenuSubmenuTriggerIndicatorProps, n as PopupMenuSubmenuTriggerIndicatorState, e as PopupMenuTree, f as PopupMenuTreeConnector, g as PopupMenuTreeItem, z as SubpageStackContext, U as UsePopupMenuItemParams, w as UsePopupMenuItemReturn, y as isTreeItemDef, u as useMaybeSubmenuContext, q as useMaybeSubpageContext, r as useMaybeSubpageStack, x as usePopupMenuItem, s as useSubmenuContext, t as useSubpageContext, v as useSubpageStack } from '../../type-guards-BC2B6bVi.cjs';
+import { b as ListboxStore } from '../../ListboxStore-nmorsoqX.cjs';
+export { V as VirtualItem } from '../../ListboxStore-nmorsoqX.cjs';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+export { P as PopupMenuEmpty, g as PopupMenuEmptyProps, h as PopupMenuEmptyState, a as PopupMenuGroup, b as PopupMenuGroupLabel, i as PopupMenuGroupLabelProps, j as PopupMenuGroupLabelState, k as PopupMenuGroupProps, l as PopupMenuGroupState, c as PopupMenuIcon, m as PopupMenuIconProps, n as PopupMenuIconState, d as PopupMenuList, o as PopupMenuListChildrenState, p as PopupMenuListProps, q as PopupMenuListState, e as PopupMenuSeparator, r as PopupMenuSeparatorProps, s as PopupMenuSeparatorState, f as PopupMenuSurface, t as PopupMenuSurfaceProps, u as PopupMenuSurfaceState } from '../../separator-BiySI623.cjs';
+export { P as PopupMenuInput, a as PopupMenuInputProps, b as PopupMenuInputState } from '../../input-C95v6jB0.cjs';
+export { P as PopupMenuLoading, a as PopupMenuLoadingProps, b as PopupMenuLoadingState } from '../../loading-C6WZGUc3.cjs';
+export { M as AsyncLoaderConfig, O as AsyncLoaderFetchStatus, Q as AsyncLoaderLoadingPhase, R as AsyncLoaderResult, S as AsyncLoaderSource, T as AsyncLoaderStatus, U as AsyncNodesConfig, V as AsyncRenderState, W as AsyncResultBehavior, X as AsyncState, Y as BreadcrumbNode, Z as CheckboxItemDef, _ as CheckboxItemRenderParams, $ as CheckboxItemRenderProps, a0 as DataListChildrenState, a1 as DeepSearchConfig, a2 as DisplayGroupNode, a3 as DisplayNode, a4 as DisplayRadioGroupNode, a5 as DisplayRowNode, a6 as DisplaySeparatorNode, a7 as DisplaySubpageNode, h as GetResolvedIdFn, a8 as GroupBehavior, a9 as GroupDef, aa as GroupLabelRenderParams, ab as GroupRenderContext, ac as GroupRenderParams, ad as IncludeInDeepSearch, ae as InitialQueryBehavior, af as ItemDef, ag as ItemRenderParams, ah as ItemRenderProps, ai as LoaderComponentProps, N as NodeDef, m as PopupMenuCheckboxItem, y as PopupMenuCheckboxItemProps, z as PopupMenuCheckboxItemState, P as PopupMenuHighlightChangeHandler, j as PopupMenuIdScope, q as PopupMenuItem, A as PopupMenuItemProps, B as PopupMenuItemState, r as PopupMenuNode, u as PopupMenuRadioGroup, D as PopupMenuRadioGroupProps, E as PopupMenuRadioGroupState, v as PopupMenuRadioItem, F as PopupMenuRadioItemProps, H as PopupMenuRadioItemState, w as PopupMenuSubmenuTrigger, I as PopupMenuSubmenuTriggerProps, J as PopupMenuSubmenuTriggerState, x as PopupMenuSubpageTrigger, K as PopupMenuSubpageTriggerProps, L as PopupMenuSubpageTriggerState, aj as QueryAsyncNodesConfig, ak as QueryLoaderConfig, al as RadioGroupBehavior, am as RadioGroupDef, an as RadioGroupLabelRenderParams, ao as RadioGroupRenderParams, ap as RadioGroupRenderProps, aq as RadioItemDef, ar as RadioItemRenderParams, as as RadioItemRenderProps, at as RowRenderContext, au as ScoredNode, av as SeparatorDef, aw as SeparatorRenderParams, ax as StaticAsyncNodesConfig, ay as StaticLoaderConfig, az as SubmenuDef, aA as SubmenuRenderParams, aB as SubmenuRenderProps, aC as SubpageContentRenderParams, aD as SubpageDef, aE as SubpageTriggerRenderParams, aF as SubpageTriggerRenderProps, aG as TreeItemDef, aH as TreeItemRenderParams, aI as TreeItemRenderProps, aJ as UnresolvedMenuNode, aK as defineRadioGroup, aL as isDisplayGroupNode, aM as isDisplayRadioGroupNode, aN as isDisplayRowNode, aO as isDisplaySeparatorNode } from '../../events-DPsuhBln.cjs';
+export { B as AsyncMenuCoordinatorValue, E as DataListContext, K as DataPopupContext, F as DataSurfaceContext, D as DataSurfaceContextValue, P as PopupMenuCheckboxItemIndicator, l as PopupMenuCheckboxItemIndicatorProps, m as PopupMenuCheckboxItemIndicatorState, a as PopupMenuFocusZone, n as PopupMenuFocusZoneProps, o as PopupMenuFocusZoneState, b as PopupMenuFooter, p as PopupMenuFooterProps, q as PopupMenuFooterState, c as PopupMenuHeader, r as PopupMenuHeaderProps, s as PopupMenuHeaderState, d as PopupMenuRadioGroupValue, C as PopupMenuRadioGroupValueProps, e as PopupMenuShortcut, t as PopupMenuShortcutProps, v as PopupMenuShortcutState, f as PopupMenuSubpage, g as PopupMenuSubpageBack, h as PopupMenuSubpageBackItem, w as PopupMenuSubpageBackItemProps, x as PopupMenuSubpageBackItemState, y as PopupMenuSubpageBackProps, z as PopupMenuSubpageBackState, A as PopupMenuSubpageProps, R as RenderNodeFn, G as defaultGetResolvedId, H as isPopupMenuNode, u as useAsyncMenuCoordinator, i as useDataList, I as useDataSurfaceContext, j as useMaybeAsyncMenuCoordinator, k as useMaybeDataList, J as useMaybeDataSurfaceContext } from '../../resolve-Dk_fAKb2.cjs';
+import '@base-ui/utils/store';
+import '@base-ui/react/popover';
+import '../../types-DT4FOOa2.cjs';
+import '../../use-listbox-item-NzZuY34-.cjs';
+
+declare function useFocusOwner(): FocusOwnerStore;
+
+declare function useOpenChain(): OpenChainStore;
+
+/**
+ * Context for passing surfaceId from Popup to Surface.
+ * This ensures Popup and Surface share the same ID for data attribute tracking.
+ *
+ * For root menus, Popup generates the ID and provides it via this context.
+ * For submenus, the ID comes from SubmenuContext.childSurfaceId instead.
+ */
+declare const PopupSurfaceIdContext: React.Context<string | null>;
+
+interface UseSubpageStackStateParams {
+    /** Surface ID of the root surface (the popup's own surface). */
+    surfaceId: string;
+    /** Listbox store; used to chain onPopupCloseComplete reset. Null-safe. */
+    store: ListboxStore | null;
+}
+interface UseSubpageStackStateReturn {
+    /** Context value provided to SubpageStackContext consumers. */
+    subpageStackContextValue: SubpageStackContextValue;
+    /** Whether subpage navigation is in its transient animation window. */
+    isSubpageNavigating: boolean;
+    /** Whether any subpage is currently open. */
+    hasOpenSubpage: boolean;
+    /** Active subpage ID, or null when the root surface is active. */
+    subpageId: string | null;
+    /** Ordered stack of open subpage IDs. */
+    openSubpageIds: string[];
+}
+/**
+ * Centralized subpage stack state for popup menu surfaces.
+ */
+declare function useSubpageStackState(params: UseSubpageStackStateParams): UseSubpageStackStateReturn;
+
+declare enum PopupMenuPopupDataAttributes {
+    /**
+     * Identifies the component part.
+     * @type {'bazzaui-dropdown-menu-popup' | 'bazzaui-context-menu-popup' | 'bazzaui-select-popup' | 'bazzaui-combobox-popup'}
+     */
+    slot = "bazzaui-[component]-popup",
+    /**
+     * Present when the popup menu is open.
+     */
+    open = "data-open",
+    /**
+     * Present when the popup menu is closed.
+     */
+    closed = "data-closed",
+    /**
+     * Indicates which side the popup is positioned relative to the trigger.
+     * @type {'top' | 'bottom' | 'left' | 'right'}
+     */
+    side = "data-side",
+    /**
+     * Indicates how the popup is aligned relative to specified side.
+     * @type {'start' | 'center' | 'end'}
+     */
+    align = "data-align",
+    /**
+     * Present when the popup is animating in.
+     */
+    startingStyle = "data-starting-style",
+    /**
+     * Present when the popup is animating out.
+     */
+    endingStyle = "data-ending-style",
+    /**
+     * Present if animations should be instant.
+     * @type {'click' | 'dismiss'}
+     */
+    instant = "data-instant",
+    /**
+     * Present when this popup's surface is the focus owner.
+     * Useful for styling the currently focused menu in a submenu chain.
+     */
+    focused = "data-focused",
+    /**
+     * Present when this popup has an open submenu below it in the menu tree.
+     * Useful for styling all parent menus in an open submenu chain.
+     */
+    hasOpenSubmenu = "data-has-open-submenu",
+    /**
+     * Present when this popup is a submenu (not the root menu).
+     * Useful for applying different styles to submenus vs root menus.
+     */
+    submenu = "data-submenu",
+    /**
+     * Present while navigating between subpages in this popup.
+     * Useful for temporary transition adjustments during subpage focus handoff.
+     */
+    navigating = "data-navigating"
+}
+
+/**
+ * Component name used for generating bazzaui-* slot attributes.
+ * E.g., 'dropdown-menu', 'context-menu', 'select', 'combobox', 'command-menu'
+ */
+type ComponentName = 'dropdown-menu' | 'context-menu' | 'select' | 'combobox' | 'command-menu';
+
+interface PopupMenuProvidersProps {
+    /** Created by `usePopupMenuRoot`, one per menu root. */
+    menuTreeResolver: MenuTreeResolver;
+    /** The Listbox store instance */
+    store: ListboxStore;
+    /** The FocusOwner store instance */
+    focusOwnerStore: FocusOwnerStore;
+    /** The OpenChain store instance */
+    openChainStore: OpenChainStore;
+    /** Whether this menu tree currently ignores user interaction */
+    disabled: boolean;
+    /** Nesting depth: 0 = root menu */
+    depth: number;
+    /** Close the entire menu tree */
+    closeAll: () => void;
+    /**
+     * Internal: when true, Surface handles Tab explicitly (close the tree, or
+     * cycle through focus zones). Enabled only by DropdownMenu.Root and
+     * ContextMenu.Root — never Select or Combobox.
+     */
+    explicitTabBehavior?: boolean;
+    /**
+     * Internal: what Tab does under `explicitTabBehavior` when the surface (and
+     * its ancestors) have no focus-zone tabbables. `'close'` closes the whole
+     * tree (dropdown/context-menu). `'inert'` swallows the event, keeping focus
+     * where it is (command palette).
+     */
+    tabWithoutZones?: 'close' | 'inert';
+    /** Register a surface for closeAll tracking */
+    registerSurface: (depth: number, setOpen: (open: boolean) => void) => () => void;
+    /** Virtualization configuration */
+    virtualization?: VirtualizationConfig;
+    /** Debug visualization flags. */
+    debug?: PopupMenuDebugOptions;
+    /**
+     * Virtual anchor for positioning (used by ContextMenu).
+     * DropdownMenu uses Popover's anchor (trigger button) instead.
+     */
+    virtualAnchor?: VirtualAnchor;
+    /**
+     * Type of menu for positioning logic.
+     * @default 'dropdown'
+     */
+    menuType?: 'dropdown' | 'context';
+    /**
+     * When to close the menu on outside interactions.
+     * @default 'pointerdown'
+     */
+    closeOnOutsidePress?: 'click' | 'pointerdown';
+    /**
+     * Component name for generating bazzaui-* slot attributes.
+     * E.g., 'dropdown-menu', 'context-menu', 'select', 'combobox'
+     */
+    componentName: ComponentName;
+    children: React.ReactNode;
+}
+/**
+ * Provides all shared context providers for popup menus.
+ * Wraps children with:
+ * - PopupMenuDebugContext (debug visualization flags)
+ * - PopupMenuContext (menu-specific state)
+ * - ListboxContextProvider (for compatibility with listbox components)
+ * - AimGuardProvider (for submenu aim detection)
+ * - FocusOwnerContext (for focus tracking across submenus)
+ * - OpenChainContext (for tracking open submenu chain)
+ */
+declare function PopupMenuProviders(props: PopupMenuProvidersProps): react_jsx_runtime.JSX.Element;
+
+interface UsePopupMenuKeyboardParams {
+    /** The Listbox store instance */
+    store: ListboxStore;
+    /** Unique identifier for this surface */
+    surfaceId: string;
+    /** The FocusOwner store for managing focus ownership */
+    focusOwnerStore: FocusOwnerStore;
+    /** Menu depth (0 for root, >0 for submenus) */
+    depth: number;
+    /** Submenu context for ArrowLeft navigation back to parent */
+    submenuContext: SubmenuContextValue | null;
+    /** Subpage context for back-stack navigation */
+    subpageContext?: SubpageContextValue | null;
+    /** Whether keyboard handling is enabled */
+    enabled: boolean;
+    /** Whether the menu currently ignores user interaction. */
+    disabled?: boolean;
+    /**
+     * Whether to enable type-to-search behavior.
+     * When true, printable characters will activate the input and set pending search.
+     * Used by List when hideUntilActive is enabled and input is not yet active.
+     * @default false
+     */
+    enableTypeToSearch?: boolean;
+    /** User's onKeyDown handler to compose with */
+    onKeyDown?: React.KeyboardEventHandler;
+    /**
+     * Callback to close the entire menu tree from the root.
+     * Used when Escape is pressed and closeRootOnEsc is true (default).
+     */
+    closeAll: () => void;
+    /**
+     * Whether to skip the focus owner check.
+     * When true, keyboard handling will work based on `enabled` prop alone,
+     * ignoring focus ownership. Useful for Combobox where the input is outside
+     * the Surface but should still handle keyboard navigation.
+     * @default false
+     */
+    skipFocusOwnerCheck?: boolean;
+}
+interface UsePopupMenuKeyboardReturn {
+    /** Keyboard event handler to attach to the element */
+    handleKeyDown: React.KeyboardEventHandler;
+}
+/**
+ * Centralized keyboard navigation hook for popup menus.
+ * Handles arrow navigation, vim bindings, submenu open/close, and selection.
+ */
+declare function usePopupMenuKeyboard(params: UsePopupMenuKeyboardParams): UsePopupMenuKeyboardReturn;
+
+export { FocusOwnerStore, MenuTreeResolver, PopupMenuDebugOptions, PopupMenuPopupDataAttributes, PopupMenuProviders, PopupSurfaceIdContext, SubmenuContextValue, SubpageContextValue, SubpageStackContextValue, VirtualAnchor, VirtualizationConfig, useFocusOwner, useOpenChain, usePopupMenuKeyboard, useSubpageStackState };

package/dist/internal/popup-menu/index.d.ts

@@ -0,0 +1,238 @@
+import { F as FocusOwnerStore, O as OpenChainStore, M as MenuTreeResolver, V as VirtualizationConfig, P as PopupMenuDebugOptions, v as VirtualAnchor } from '../../scroll-arrow-CNd0tgME.js';
+export { b as PopupMenuArrow, h as PopupMenuArrowProps, c as PopupMenuBackdrop, i as PopupMenuBackdropProps, w as PopupMenuContext, r as PopupMenuContextValue, p as PopupMenuListCssVars, d as PopupMenuPopup, j as PopupMenuPopupProps, t as PopupMenuPopupState, e as PopupMenuPortal, k as PopupMenuPortalProps, q as PopupMenuPositionerCssVars, a as PopupMenuRootActions, l as PopupMenuScrollArrowProps, m as PopupMenuScrollArrowState, f as PopupMenuScrollDownArrow, n as PopupMenuScrollDownArrowProps, g as PopupMenuScrollUpArrow, o as PopupMenuScrollUpArrowProps, U as UsePopupMenuRootParams, u as useMaybePopupMenuContext, s as usePopupMenuContext, x as usePopupMenuRoot } from '../../scroll-arrow-CNd0tgME.js';
+import * as React from 'react';
+import { p as SubpageStackContextValue, S as SubmenuContextValue, o as SubpageContextValue } from '../../type-guards-ybcHBB3C.js';
+export { P as PopupMenuGroupValue, a as PopupMenuPositioner, h as PopupMenuPositionerAlign, i as PopupMenuPositionerProps, b as PopupMenuRadioItemIndicator, j as PopupMenuRadioItemIndicatorProps, k as PopupMenuRadioItemIndicatorState, c as PopupMenuSubmenuRoot, l as PopupMenuSubmenuRootProps, d as PopupMenuSubmenuTriggerIndicator, m as PopupMenuSubmenuTriggerIndicatorProps, n as PopupMenuSubmenuTriggerIndicatorState, e as PopupMenuTree, f as PopupMenuTreeConnector, g as PopupMenuTreeItem, z as SubpageStackContext, U as UsePopupMenuItemParams, w as UsePopupMenuItemReturn, y as isTreeItemDef, u as useMaybeSubmenuContext, q as useMaybeSubpageContext, r as useMaybeSubpageStack, x as usePopupMenuItem, s as useSubmenuContext, t as useSubpageContext, v as useSubpageStack } from '../../type-guards-ybcHBB3C.js';
+import { b as ListboxStore } from '../../ListboxStore-BYBpGrOz.js';
+export { V as VirtualItem } from '../../ListboxStore-BYBpGrOz.js';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+export { P as PopupMenuEmpty, g as PopupMenuEmptyProps, h as PopupMenuEmptyState, a as PopupMenuGroup, b as PopupMenuGroupLabel, i as PopupMenuGroupLabelProps, j as PopupMenuGroupLabelState, k as PopupMenuGroupProps, l as PopupMenuGroupState, c as PopupMenuIcon, m as PopupMenuIconProps, n as PopupMenuIconState, d as PopupMenuList, o as PopupMenuListChildrenState, p as PopupMenuListProps, q as PopupMenuListState, e as PopupMenuSeparator, r as PopupMenuSeparatorProps, s as PopupMenuSeparatorState, f as PopupMenuSurface, t as PopupMenuSurfaceProps, u as PopupMenuSurfaceState } from '../../separator-De8l8DKO.js';
+export { P as PopupMenuInput, a as PopupMenuInputProps, b as PopupMenuInputState } from '../../input-CYweYB_i.js';
+export { P as PopupMenuLoading, a as PopupMenuLoadingProps, b as PopupMenuLoadingState } from '../../loading-CC4n55sR.js';
+export { M as AsyncLoaderConfig, O as AsyncLoaderFetchStatus, Q as AsyncLoaderLoadingPhase, R as AsyncLoaderResult, S as AsyncLoaderSource, T as AsyncLoaderStatus, U as AsyncNodesConfig, V as AsyncRenderState, W as AsyncResultBehavior, X as AsyncState, Y as BreadcrumbNode, Z as CheckboxItemDef, _ as CheckboxItemRenderParams, $ as CheckboxItemRenderProps, a0 as DataListChildrenState, a1 as DeepSearchConfig, a2 as DisplayGroupNode, a3 as DisplayNode, a4 as DisplayRadioGroupNode, a5 as DisplayRowNode, a6 as DisplaySeparatorNode, a7 as DisplaySubpageNode, h as GetResolvedIdFn, a8 as GroupBehavior, a9 as GroupDef, aa as GroupLabelRenderParams, ab as GroupRenderContext, ac as GroupRenderParams, ad as IncludeInDeepSearch, ae as InitialQueryBehavior, af as ItemDef, ag as ItemRenderParams, ah as ItemRenderProps, ai as LoaderComponentProps, N as NodeDef, m as PopupMenuCheckboxItem, y as PopupMenuCheckboxItemProps, z as PopupMenuCheckboxItemState, P as PopupMenuHighlightChangeHandler, j as PopupMenuIdScope, q as PopupMenuItem, A as PopupMenuItemProps, B as PopupMenuItemState, r as PopupMenuNode, u as PopupMenuRadioGroup, D as PopupMenuRadioGroupProps, E as PopupMenuRadioGroupState, v as PopupMenuRadioItem, F as PopupMenuRadioItemProps, H as PopupMenuRadioItemState, w as PopupMenuSubmenuTrigger, I as PopupMenuSubmenuTriggerProps, J as PopupMenuSubmenuTriggerState, x as PopupMenuSubpageTrigger, K as PopupMenuSubpageTriggerProps, L as PopupMenuSubpageTriggerState, aj as QueryAsyncNodesConfig, ak as QueryLoaderConfig, al as RadioGroupBehavior, am as RadioGroupDef, an as RadioGroupLabelRenderParams, ao as RadioGroupRenderParams, ap as RadioGroupRenderProps, aq as RadioItemDef, ar as RadioItemRenderParams, as as RadioItemRenderProps, at as RowRenderContext, au as ScoredNode, av as SeparatorDef, aw as SeparatorRenderParams, ax as StaticAsyncNodesConfig, ay as StaticLoaderConfig, az as SubmenuDef, aA as SubmenuRenderParams, aB as SubmenuRenderProps, aC as SubpageContentRenderParams, aD as SubpageDef, aE as SubpageTriggerRenderParams, aF as SubpageTriggerRenderProps, aG as TreeItemDef, aH as TreeItemRenderParams, aI as TreeItemRenderProps, aJ as UnresolvedMenuNode, aK as defineRadioGroup, aL as isDisplayGroupNode, aM as isDisplayRadioGroupNode, aN as isDisplayRowNode, aO as isDisplaySeparatorNode } from '../../events-DOGItflK.js';
+export { B as AsyncMenuCoordinatorValue, E as DataListContext, K as DataPopupContext, F as DataSurfaceContext, D as DataSurfaceContextValue, P as PopupMenuCheckboxItemIndicator, l as PopupMenuCheckboxItemIndicatorProps, m as PopupMenuCheckboxItemIndicatorState, a as PopupMenuFocusZone, n as PopupMenuFocusZoneProps, o as PopupMenuFocusZoneState, b as PopupMenuFooter, p as PopupMenuFooterProps, q as PopupMenuFooterState, c as PopupMenuHeader, r as PopupMenuHeaderProps, s as PopupMenuHeaderState, d as PopupMenuRadioGroupValue, C as PopupMenuRadioGroupValueProps, e as PopupMenuShortcut, t as PopupMenuShortcutProps, v as PopupMenuShortcutState, f as PopupMenuSubpage, g as PopupMenuSubpageBack, h as PopupMenuSubpageBackItem, w as PopupMenuSubpageBackItemProps, x as PopupMenuSubpageBackItemState, y as PopupMenuSubpageBackProps, z as PopupMenuSubpageBackState, A as PopupMenuSubpageProps, R as RenderNodeFn, G as defaultGetResolvedId, H as isPopupMenuNode, u as useAsyncMenuCoordinator, i as useDataList, I as useDataSurfaceContext, j as useMaybeAsyncMenuCoordinator, k as useMaybeDataList, J as useMaybeDataSurfaceContext } from '../../resolve-BYm41YfG.js';
+import '@base-ui/utils/store';
+import '@base-ui/react/popover';
+import '../../types-DT4FOOa2.js';
+import '../../use-listbox-item-NzZuY34-.js';
+
+declare function useFocusOwner(): FocusOwnerStore;
+
+declare function useOpenChain(): OpenChainStore;
+
+/**
+ * Context for passing surfaceId from Popup to Surface.
+ * This ensures Popup and Surface share the same ID for data attribute tracking.
+ *
+ * For root menus, Popup generates the ID and provides it via this context.
+ * For submenus, the ID comes from SubmenuContext.childSurfaceId instead.
+ */
+declare const PopupSurfaceIdContext: React.Context<string | null>;
+
+interface UseSubpageStackStateParams {
+    /** Surface ID of the root surface (the popup's own surface). */
+    surfaceId: string;
+    /** Listbox store; used to chain onPopupCloseComplete reset. Null-safe. */
+    store: ListboxStore | null;
+}
+interface UseSubpageStackStateReturn {
+    /** Context value provided to SubpageStackContext consumers. */
+    subpageStackContextValue: SubpageStackContextValue;
+    /** Whether subpage navigation is in its transient animation window. */
+    isSubpageNavigating: boolean;
+    /** Whether any subpage is currently open. */
+    hasOpenSubpage: boolean;
+    /** Active subpage ID, or null when the root surface is active. */
+    subpageId: string | null;
+    /** Ordered stack of open subpage IDs. */
+    openSubpageIds: string[];
+}
+/**
+ * Centralized subpage stack state for popup menu surfaces.
+ */
+declare function useSubpageStackState(params: UseSubpageStackStateParams): UseSubpageStackStateReturn;
+
+declare enum PopupMenuPopupDataAttributes {
+    /**
+     * Identifies the component part.
+     * @type {'bazzaui-dropdown-menu-popup' | 'bazzaui-context-menu-popup' | 'bazzaui-select-popup' | 'bazzaui-combobox-popup'}
+     */
+    slot = "bazzaui-[component]-popup",
+    /**
+     * Present when the popup menu is open.
+     */
+    open = "data-open",
+    /**
+     * Present when the popup menu is closed.
+     */
+    closed = "data-closed",
+    /**
+     * Indicates which side the popup is positioned relative to the trigger.
+     * @type {'top' | 'bottom' | 'left' | 'right'}
+     */
+    side = "data-side",
+    /**
+     * Indicates how the popup is aligned relative to specified side.
+     * @type {'start' | 'center' | 'end'}
+     */
+    align = "data-align",
+    /**
+     * Present when the popup is animating in.
+     */
+    startingStyle = "data-starting-style",
+    /**
+     * Present when the popup is animating out.
+     */
+    endingStyle = "data-ending-style",
+    /**
+     * Present if animations should be instant.
+     * @type {'click' | 'dismiss'}
+     */
+    instant = "data-instant",
+    /**
+     * Present when this popup's surface is the focus owner.
+     * Useful for styling the currently focused menu in a submenu chain.
+     */
+    focused = "data-focused",
+    /**
+     * Present when this popup has an open submenu below it in the menu tree.
+     * Useful for styling all parent menus in an open submenu chain.
+     */
+    hasOpenSubmenu = "data-has-open-submenu",
+    /**
+     * Present when this popup is a submenu (not the root menu).
+     * Useful for applying different styles to submenus vs root menus.
+     */
+    submenu = "data-submenu",
+    /**
+     * Present while navigating between subpages in this popup.
+     * Useful for temporary transition adjustments during subpage focus handoff.
+     */
+    navigating = "data-navigating"
+}
+
+/**
+ * Component name used for generating bazzaui-* slot attributes.
+ * E.g., 'dropdown-menu', 'context-menu', 'select', 'combobox', 'command-menu'
+ */
+type ComponentName = 'dropdown-menu' | 'context-menu' | 'select' | 'combobox' | 'command-menu';
+
+interface PopupMenuProvidersProps {
+    /** Created by `usePopupMenuRoot`, one per menu root. */
+    menuTreeResolver: MenuTreeResolver;
+    /** The Listbox store instance */
+    store: ListboxStore;
+    /** The FocusOwner store instance */
+    focusOwnerStore: FocusOwnerStore;
+    /** The OpenChain store instance */
+    openChainStore: OpenChainStore;
+    /** Whether this menu tree currently ignores user interaction */
+    disabled: boolean;
+    /** Nesting depth: 0 = root menu */
+    depth: number;
+    /** Close the entire menu tree */
+    closeAll: () => void;
+    /**
+     * Internal: when true, Surface handles Tab explicitly (close the tree, or
+     * cycle through focus zones). Enabled only by DropdownMenu.Root and
+     * ContextMenu.Root — never Select or Combobox.
+     */
+    explicitTabBehavior?: boolean;
+    /**
+     * Internal: what Tab does under `explicitTabBehavior` when the surface (and
+     * its ancestors) have no focus-zone tabbables. `'close'` closes the whole
+     * tree (dropdown/context-menu). `'inert'` swallows the event, keeping focus
+     * where it is (command palette).
+     */
+    tabWithoutZones?: 'close' | 'inert';
+    /** Register a surface for closeAll tracking */
+    registerSurface: (depth: number, setOpen: (open: boolean) => void) => () => void;
+    /** Virtualization configuration */
+    virtualization?: VirtualizationConfig;
+    /** Debug visualization flags. */
+    debug?: PopupMenuDebugOptions;
+    /**
+     * Virtual anchor for positioning (used by ContextMenu).
+     * DropdownMenu uses Popover's anchor (trigger button) instead.
+     */
+    virtualAnchor?: VirtualAnchor;
+    /**
+     * Type of menu for positioning logic.
+     * @default 'dropdown'
+     */
+    menuType?: 'dropdown' | 'context';
+    /**
+     * When to close the menu on outside interactions.
+     * @default 'pointerdown'
+     */
+    closeOnOutsidePress?: 'click' | 'pointerdown';
+    /**
+     * Component name for generating bazzaui-* slot attributes.
+     * E.g., 'dropdown-menu', 'context-menu', 'select', 'combobox'
+     */
+    componentName: ComponentName;
+    children: React.ReactNode;
+}
+/**
+ * Provides all shared context providers for popup menus.
+ * Wraps children with:
+ * - PopupMenuDebugContext (debug visualization flags)
+ * - PopupMenuContext (menu-specific state)
+ * - ListboxContextProvider (for compatibility with listbox components)
+ * - AimGuardProvider (for submenu aim detection)
+ * - FocusOwnerContext (for focus tracking across submenus)
+ * - OpenChainContext (for tracking open submenu chain)
+ */
+declare function PopupMenuProviders(props: PopupMenuProvidersProps): react_jsx_runtime.JSX.Element;
+
+interface UsePopupMenuKeyboardParams {
+    /** The Listbox store instance */
+    store: ListboxStore;
+    /** Unique identifier for this surface */
+    surfaceId: string;
+    /** The FocusOwner store for managing focus ownership */
+    focusOwnerStore: FocusOwnerStore;
+    /** Menu depth (0 for root, >0 for submenus) */
+    depth: number;
+    /** Submenu context for ArrowLeft navigation back to parent */
+    submenuContext: SubmenuContextValue | null;
+    /** Subpage context for back-stack navigation */
+    subpageContext?: SubpageContextValue | null;
+    /** Whether keyboard handling is enabled */
+    enabled: boolean;
+    /** Whether the menu currently ignores user interaction. */
+    disabled?: boolean;
+    /**
+     * Whether to enable type-to-search behavior.
+     * When true, printable characters will activate the input and set pending search.
+     * Used by List when hideUntilActive is enabled and input is not yet active.
+     * @default false
+     */
+    enableTypeToSearch?: boolean;
+    /** User's onKeyDown handler to compose with */
+    onKeyDown?: React.KeyboardEventHandler;
+    /**
+     * Callback to close the entire menu tree from the root.
+     * Used when Escape is pressed and closeRootOnEsc is true (default).
+     */
+    closeAll: () => void;
+    /**
+     * Whether to skip the focus owner check.
+     * When true, keyboard handling will work based on `enabled` prop alone,
+     * ignoring focus ownership. Useful for Combobox where the input is outside
+     * the Surface but should still handle keyboard navigation.
+     * @default false
+     */
+    skipFocusOwnerCheck?: boolean;
+}
+interface UsePopupMenuKeyboardReturn {
+    /** Keyboard event handler to attach to the element */
+    handleKeyDown: React.KeyboardEventHandler;
+}
+/**
+ * Centralized keyboard navigation hook for popup menus.
+ * Handles arrow navigation, vim bindings, submenu open/close, and selection.
+ */
+declare function usePopupMenuKeyboard(params: UsePopupMenuKeyboardParams): UsePopupMenuKeyboardReturn;
+
+export { FocusOwnerStore, MenuTreeResolver, PopupMenuDebugOptions, PopupMenuPopupDataAttributes, PopupMenuProviders, PopupSurfaceIdContext, SubmenuContextValue, SubpageContextValue, SubpageStackContextValue, VirtualAnchor, VirtualizationConfig, useFocusOwner, useOpenChain, usePopupMenuKeyboard, useSubpageStackState };

package/dist/internal/popup-menu/index.js

@@ -0,0 +1,2 @@
+import{$ as U,A as x,Aa as ta,B as y,Ba as ua,C as z,Ca as va,D as A,Da as wa,E as B,F as C,G as D,H as E,J as F,K as G,L as H,M as I,N as J,O as K,P as L,T as M,U as N,V as O,W as P,X as Q,Y as R,Z as S,_ as T,a,aa as V,b,ba as W,c,ca as X,d,da as Y,e,ea as Z,f,fa as _,g,ga as $,h,ha as aa,i,ia as ba,j,ja as ca,k,ka as da,l,la as ea,m,ma as fa,n,na as ga,o,oa as ha,p,pa as ia,q,qa as ja,r,ra as ka,s,sa as la,t,ta as ma,u,ua as na,va as oa,wa as pa,xa as qa,y as v,ya as ra,z as w,za as sa}from"../../chunk-BFOY762U.js";import"../../chunk-A4Z5BY7H.js";import"../../chunk-4C666HHU.js";export{z as DataListContext,w as DataPopupContext,v as DataSurfaceContext,n as FocusOwnerStore,s as PopupMenuArrow,t as PopupMenuBackdrop,$ as PopupMenuCheckboxItem,aa as PopupMenuCheckboxItemIndicator,c as PopupMenuContext,N as PopupMenuEmpty,ga as PopupMenuFocusZone,ha as PopupMenuFooter,ia as PopupMenuGroup,P as PopupMenuGroupLabel,ja as PopupMenuGroupValue,ka as PopupMenuHeader,M as PopupMenuIcon,O as PopupMenuInput,ba as PopupMenuItem,W as PopupMenuList,V as PopupMenuListCssVars,X as PopupMenuLoading,F as PopupMenuPopup,u as PopupMenuPopupDataAttributes,G as PopupMenuPortal,I as PopupMenuPositioner,H as PopupMenuPositionerCssVars,J as PopupMenuProviders,ca as PopupMenuRadioGroup,da as PopupMenuRadioGroupValue,ea as PopupMenuRadioItem,fa as PopupMenuRadioItemIndicator,Z as PopupMenuScrollDownArrow,Y as PopupMenuScrollUpArrow,la as PopupMenuSeparator,ma as PopupMenuShortcut,qa as PopupMenuSubmenuRoot,sa as PopupMenuSubmenuTrigger,ra as PopupMenuSubmenuTriggerIndicator,ta as PopupMenuSubpage,ua as PopupMenuSubpageBack,va as PopupMenuSubpageBackItem,wa as PopupMenuSubpageTrigger,_ as PopupMenuSurface,na as PopupMenuTree,oa as PopupMenuTreeConnector,pa as PopupMenuTreeItem,f as PopupSurfaceIdContext,k as SubpageStackContext,p as defaultGetResolvedId,Q as defineRadioGroup,R as isDisplayGroupNode,S as isDisplayRadioGroupNode,U as isDisplayRowNode,T as isDisplaySeparatorNode,o as isPopupMenuNode,E as isTreeItemDef,C as useAsyncMenuCoordinator,A as useDataList,x as useDataSurfaceContext,a as useFocusOwner,D as useMaybeAsyncMenuCoordinator,B as useMaybeDataList,y as useMaybeDataSurfaceContext,e as useMaybePopupMenuContext,h as useMaybeSubmenuContext,j as useMaybeSubpageContext,m as useMaybeSubpageStack,b as useOpenChain,d as usePopupMenuContext,K as usePopupMenuItem,L as usePopupMenuKeyboard,q as usePopupMenuRoot,g as useSubmenuContext,i as useSubpageContext,l as useSubpageStack,r as useSubpageStackState};
+//# sourceMappingURL=index.js.map

package/dist/internal/popup-menu/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/items-B6HeFO_8.d.cts

@@ -0,0 +1,37 @@
+import * as React from 'react';
+
+/**
+ * Type for custom item equality comparison functions.
+ * Used to compare object values in Select and Combobox components.
+ */
+type ItemEqualityComparer<Value = unknown> = (itemValue: Value, value: Value) => boolean;
+
+/**
+ * A single entry in the array form of the `items` prop passed to
+ * `Select.Root` / `Combobox.Root`.
+ */
+interface ItemsEntry {
+    /**
+     * The item's value.
+     *
+     * Use `null` to describe a clearable/placeholder item (its label is used as
+     * the trigger placeholder and selecting it clears the value).
+     */
+    value: string | null;
+    /** The label to display for this item. */
+    label: React.ReactNode;
+    /**
+     * Additional keywords to match against when filtering, on top of the label.
+     * Useful for aliases or synonyms.
+     */
+    keywords?: string[];
+}
+/**
+ * Data structure describing the items rendered in a Select/Combobox popup.
+ *
+ * Either a record mapping a value to its label, or an array of entries. Only
+ * the array form can express `keywords` or a `null` (clearable) value.
+ */
+type Items = Record<string, React.ReactNode> | Array<ItemsEntry>;
+
+export type { ItemEqualityComparer as I, Items as a };

package/dist/items-B6HeFO_8.d.ts

@@ -0,0 +1,37 @@
+import * as React from 'react';
+
+/**
+ * Type for custom item equality comparison functions.
+ * Used to compare object values in Select and Combobox components.
+ */
+type ItemEqualityComparer<Value = unknown> = (itemValue: Value, value: Value) => boolean;
+
+/**
+ * A single entry in the array form of the `items` prop passed to
+ * `Select.Root` / `Combobox.Root`.
+ */
+interface ItemsEntry {
+    /**
+     * The item's value.
+     *
+     * Use `null` to describe a clearable/placeholder item (its label is used as
+     * the trigger placeholder and selecting it clears the value).
+     */
+    value: string | null;
+    /** The label to display for this item. */
+    label: React.ReactNode;
+    /**
+     * Additional keywords to match against when filtering, on top of the label.
+     * Useful for aliases or synonyms.
+     */
+    keywords?: string[];
+}
+/**
+ * Data structure describing the items rendered in a Select/Combobox popup.
+ *
+ * Either a record mapping a value to its label, or an array of entries. Only
+ * the array form can express `keywords` or a `null` (clearable) value.
+ */
+type Items = Record<string, React.ReactNode> | Array<ItemsEntry>;
+
+export type { ItemEqualityComparer as I, Items as a };

package/dist/kbd/index.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }var _chunkJFEVUUPCcjs = require('../chunk-JFEVUUPC.cjs');var _chunkM4G6J7DPcjs = require('../chunk-M4G6J7DP.cjs');var w={};_chunkM4G6J7DPcjs.a.call(void 0, w,{Key:()=>a,Root:()=>M});var _userender = require('@base-ui/react/use-render');var _react = require('react'); var s = _interopRequireWildcard(_react); var t = _interopRequireWildcard(_react);var a=s.forwardRef(function(d,m){let{label:o,children:c,render:r,className:f,style:i,...l}=d,K=s.useMemo(()=>({}),[]),e=_nullishCoalesce(c, () => (o));return _userender.useRender.call(void 0, {render:r,ref:m,state:K,props:{...l,"data-kbd-key":"",className:f,style:i,children:e},defaultTagName:"kbd"})});var _jsxruntime = require('react/jsx-runtime');var I={platform:p=>({"data-platform":String(p)})},M=t.forwardRef(function(d,m){let{keys:o,platform:c,separator:r="then",render:f,className:i,style:l,...K}=d,e=_chunkJFEVUUPCcjs.e.call(void 0, c),x=t.useMemo(()=>_chunkJFEVUUPCcjs.a.call(void 0, o),[o]),N=t.useMemo(()=>({platform:e}),[e]),L=t.useMemo(()=>{let n=[],g=new Map;for(let $ of x.chords){let P=_chunkJFEVUUPCcjs.c.call(void 0, $,e),b=P.join("+"),h=(_nullishCoalesce(g.get(b), () => (0)))+1;g.set(b,h);let k=`${b}#${h}`;n.length>0&&n.push(_jsxruntime.jsx.call(void 0, "span",{"data-kbd-separator":"",children:r},`${k}-separator`));for(let S of P)n.push(_jsxruntime.jsx.call(void 0, a,{children:S},`${k}-${S}`))}return n},[x,e,r]);return _userender.useRender.call(void 0, {render:f,ref:m,state:N,stateAttributesMapping:I,props:{...K,"data-kbd-root":"",className:i,style:l,children:L},defaultTagName:"span"})});exports.Kbd = w; exports.getChordLabels = _chunkJFEVUUPCcjs.c; exports.getKeyLabel = _chunkJFEVUUPCcjs.b; exports.isApplePlatform = _chunkJFEVUUPCcjs.d; exports.parseKeybinding = _chunkJFEVUUPCcjs.a; exports.usePlatform = _chunkJFEVUUPCcjs.e;
+//# sourceMappingURL=index.cjs.map

package/dist/kbd/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kianbazza/repos/bazzalabs/ui/packages/react/dist/kbd/index.cjs","../../src/kbd/index.parts.ts","../../src/kbd/key/key.tsx","../../src/kbd/root/root.tsx"],"names":["index_parts_exports","__export","KbdKey","KbdRoot","props","forwardedRef","label","children","render","className","style","rest","state","renderedChildren","useRender","stateAttributesMapping","value","keys","platformProp","separator","platform","usePlatform","keybinding","parseKeybinding","entries","seen","chord","labels","getChordLabels","chordId","occurrence","prefix"],"mappings":"AAAA,wfAAqE,yDAA0C,ICA/GA,CAAAA,CAAA,CAAA,CAAA,CAAAC,iCAAAA,CAAAD,CAAA,CAAA,GAAA,CAAA,CAAA,CAAA,EAAAE,CAAAA,CAAA,IAAA,CAAA,CAAA,CAAA,EAAAC,CAAAA,CAAAA,CAAAA,CCEA,sDAA0B,gHACH,IAUVD,CAAAA,CAAe,CAAA,CAAA,UAAA,CAC1B,QAAA,CAAgBE,CAAAA,CAAOC,CAAAA,CAAc,CACnC,GAAM,CAAE,KAAA,CAAAC,CAAAA,CAAO,QAAA,CAAAC,CAAAA,CAAU,MAAA,CAAAC,CAAAA,CAAQ,SAAA,CAAAC,CAAAA,CAAW,KAAA,CAAAC,CAAAA,CAAO,GAAGC,CAAK,CAAA,CAAIP,CAAAA,CAEzDQ,CAAAA,CAA4B,CAAA,CAAA,OAAA,CAAQ,CAAA,CAAA,EAAA,CAAO,CAAC,CAAA,CAAA,CAAI,CAAC,CAAC,CAAA,CAClDC,CAAAA,kBAAmBN,CAAAA,SAAYD,GAAAA,CAErC,OAAOQ,kCAAAA,CACL,MAAA,CAAAN,CAAAA,CACA,GAAA,CAAKH,CAAAA,CACL,KAAA,CAAAO,CAAAA,CACA,KAAA,CAAO,CACL,GAAGD,CAAAA,CACF,cAAA,CAA2B,EAAA,CAC5B,SAAA,CAAAF,CAAAA,CACA,KAAA,CAAAC,CAAAA,CACA,QAAA,CAAUG,CACZ,CAAA,CACA,cAAA,CAAgB,KAClB,CAAC,CACH,CACF,CAAA,CChCA,+CA4DY,IAvCNE,CAAAA,CAAyB,CAC7B,QAAA,CAAWC,CAAAA,EAAAA,CAAmD,CAC3D,eAAA,CAAiC,MAAA,CAAOA,CAAK,CAChD,CAAA,CACF,CAAA,CAEab,CAAAA,CAAgB,CAAA,CAAA,UAAA,CAC3B,QAAA,CAAiBC,CAAAA,CAAOC,CAAAA,CAAc,CACpC,GAAM,CACJ,IAAA,CAAAY,CAAAA,CACA,QAAA,CAAUC,CAAAA,CACV,SAAA,CAAAC,CAAAA,CAAY,MAAA,CACZ,MAAA,CAAAX,CAAAA,CACA,SAAA,CAAAC,CAAAA,CACA,KAAA,CAAAC,CAAAA,CACA,GAAGC,CACL,CAAA,CAAIP,CAAAA,CAEEgB,CAAAA,CAAWC,iCAAAA,CAAwB,CAAA,CACnCC,CAAAA,CAAmB,CAAA,CAAA,OAAA,CAAQ,CAAA,CAAA,EAAMC,iCAAAA,CAAoB,CAAA,CAAG,CAACN,CAAI,CAAC,CAAA,CAE9DL,CAAAA,CAA6B,CAAA,CAAA,OAAA,CAAQ,CAAA,CAAA,EAAA,CAAO,CAAE,QAAA,CAAAQ,CAAS,CAAA,CAAA,CAAI,CAACA,CAAQ,CAAC,CAAA,CAErEP,CAAAA,CAAyB,CAAA,CAAA,OAAA,CAAQ,CAAA,CAAA,EAAM,CAC3C,IAAMW,CAAAA,CAA6B,CAAC,CAAA,CAI9BC,CAAAA,CAAO,IAAI,GAAA,CAEjB,GAAA,CAAA,IAAWC,EAAAA,GAASJ,CAAAA,CAAW,MAAA,CAAQ,CACrC,IAAMK,CAAAA,CAASC,iCAAAA,CAAeF,CAAON,CAAQ,CAAA,CACvCS,CAAAA,CAAUF,CAAAA,CAAO,IAAA,CAAK,GAAG,CAAA,CACzBG,CAAAA,CAAAA,kBAAcL,CAAAA,CAAK,GAAA,CAAII,CAAO,CAAA,SAAK,GAAA,CAAA,CAAK,CAAA,CAC9CJ,CAAAA,CAAK,GAAA,CAAII,CAAAA,CAASC,CAAU,CAAA,CAC5B,IAAMC,CAAAA,CAAS,CAAA,EAAA","file":"/Users/kianbazza/repos/bazzalabs/ui/packages/react/dist/kbd/index.cjs","sourcesContent":[null,"export { KbdKey as Key } from './key/key.js'\nexport { KbdRoot as Root } from './root/root.js'\n","'use client'\n\nimport { useRender } from '@base-ui/react/use-render'\nimport * as React from 'react'\nimport type { ComponentProps } from '../../utils/types.js'\nimport { KbdKeyDataAttributes } from './key.data-attrs.js'\n\nexport interface KbdKeyState extends Record<string, unknown> {}\n\nexport interface KbdKeyProps extends ComponentProps<'kbd', KbdKey.State> {\n  label?: string\n}\n\nexport const KbdKey = React.forwardRef<HTMLElement, KbdKey.Props>(\n  function KbdKey(props, forwardedRef) {\n    const { label, children, render, className, style, ...rest } = props\n\n    const state: KbdKey.State = React.useMemo(() => ({}), [])\n    const renderedChildren = children ?? label\n\n    return useRender({\n      render,\n      ref: forwardedRef,\n      state,\n      props: {\n        ...rest,\n        [KbdKeyDataAttributes.key]: '',\n        className,\n        style,\n        children: renderedChildren,\n      },\n      defaultTagName: 'kbd',\n    })\n  },\n)\n\nexport namespace KbdKey {\n  export type State = KbdKeyState\n  export interface Props extends KbdKeyProps {}\n}\n","'use client'\n\nimport { useRender } from '@base-ui/react/use-render'\nimport * as React from 'react'\nimport type { ComponentProps } from '../../utils/types.js'\nimport { KbdKey } from '../key/key.js'\nimport { getChordLabels, parseKeybinding } from '../utils/parse-keybinding.js'\nimport { usePlatform } from '../utils/platform.js'\nimport { KbdRootDataAttributes } from './root.data-attrs.js'\n\ntype Platform = 'apple' | 'other'\n\nexport interface KbdRootState extends Record<string, unknown> {\n  platform: Platform\n}\n\nexport interface KbdRootProps\n  extends Omit<ComponentProps<'span', KbdRoot.State>, 'children'> {\n  keys: string\n  platform?: Platform\n  separator?: React.ReactNode\n}\n\nconst stateAttributesMapping = {\n  platform: (value: unknown): Record<string, string> | null => ({\n    [KbdRootDataAttributes.platform]: String(value),\n  }),\n}\n\nexport const KbdRoot = React.forwardRef<HTMLSpanElement, KbdRoot.Props>(\n  function KbdRoot(props, forwardedRef) {\n    const {\n      keys,\n      platform: platformProp,\n      separator = 'then',\n      render,\n      className,\n      style,\n      ...rest\n    } = props\n\n    const platform = usePlatform(platformProp)\n    const keybinding = React.useMemo(() => parseKeybinding(keys), [keys])\n\n    const state: KbdRoot.State = React.useMemo(() => ({ platform }), [platform])\n\n    const renderedChildren = React.useMemo(() => {\n      const entries: React.ReactNode[] = []\n      // Content-derived keys: chords are fully derived from the `keys` string,\n      // so a chord's joined labels (disambiguated by occurrence count for\n      // repeated chords like \"g g\") form a stable identity.\n      const seen = new Map<string, number>()\n\n      for (const chord of keybinding.chords) {\n        const labels = getChordLabels(chord, platform)\n        const chordId = labels.join('+')\n        const occurrence = (seen.get(chordId) ?? 0) + 1\n        seen.set(chordId, occurrence)\n        const prefix = `${chordId}#${occurrence}`\n\n        if (entries.length > 0) {\n          entries.push(\n            <span key={`${prefix}-separator`} data-kbd-separator=\"\">\n              {separator}\n            </span>,\n          )\n        }\n        for (const label of labels) {\n          entries.push(<KbdKey key={`${prefix}-${label}`}>{label}</KbdKey>)\n        }\n      }\n\n      return entries\n    }, [keybinding, platform, separator])\n\n    return useRender({\n      render,\n      ref: forwardedRef,\n      state,\n      stateAttributesMapping,\n      props: {\n        ...rest,\n        [KbdRootDataAttributes.root]: '',\n        className,\n        style,\n        children: renderedChildren,\n      },\n      defaultTagName: 'span',\n    })\n  },\n)\n\nexport namespace KbdRoot {\n  export type State = KbdRootState\n  export interface Props extends KbdRootProps {}\n}\n"]}