modern-cmdk 1.2.1 → 1.2.2

package/dist/react/index.d.mts

@@ -1,6 +1,5 @@
 
 import { Component, ComponentPropsWithRef, Context, ErrorInfo, ReactNode } from "react";
-
 //#region src/react/activity.d.ts
 /** Activity mode — maps directly to React's Activity API */
 type ActivityMode = "visible" | "hidden";
@@ -11,14 +10,11 @@ interface CommandActivityProps {
   readonly children: ReactNode;
 }
 /**
-* Wraps content in React 19.3.0-canary Activity API.
-* When mode="hidden", the component tree is preserved in memory but not rendered.
-* Falls back to conditional rendering if Activity is unavailable.
-*/
-declare function CommandActivity({
-  mode,
-  children
-}: CommandActivityProps): ReactNode;
+ * Wraps content in React 19.3.0-canary Activity API.
+ * When mode="hidden", the component tree is preserved in memory but not rendered.
+ * Falls back to conditional rendering if Activity is unavailable.
+ */
+export declare function CommandActivity({ mode, children }: CommandActivityProps): ReactNode;
 //#endregion
 //#region src/core/search/types.d.ts
 /** Result of scoring a single item against a query */
@@ -44,31 +40,31 @@ interface SearchEngine extends Disposable {
 //#endregion
 //#region src/core/types.d.ts
 /**
-* Branded type for command item IDs.
-* Prevents accidental mixing with plain strings at the type level.
-*
-* @example
-* ```ts
-* const id = itemId('copy');
-* // id has type ItemId, not string — catches type errors at compile time
-* ```
-*/
+ * Branded type for command item IDs.
+ * Prevents accidental mixing with plain strings at the type level.
+ *
+ * @example
+ * ```ts
+ * const id = itemId('copy');
+ * // id has type ItemId, not string — catches type errors at compile time
+ * ```
+ */
 declare const __itemIdBrand: unique symbol;
 type ItemId = string & {
   readonly [__itemIdBrand]: never;
 };
 /**
-* Branded type for group IDs.
-* Prevents accidental mixing with plain strings or ItemId at the type level.
-*/
+ * Branded type for group IDs.
+ * Prevents accidental mixing with plain strings or ItemId at the type level.
+ */
 declare const __groupIdBrand: unique symbol;
 type GroupId = string & {
   readonly [__groupIdBrand]: never;
 };
 /**
-* A registered command item in the palette.
-* All fields are readonly — state machine creates new items on update.
-*/
+ * A registered command item in the palette.
+ * All fields are readonly — state machine creates new items on update.
+ */
 interface CommandItem$1 {
   /** Unique identifier (branded type) */
   readonly id: ItemId;
@@ -88,9 +84,9 @@ interface CommandItem$1 {
   readonly data?: Readonly<Record<string, unknown>> | undefined;
 }
 /**
-* A command group for categorizing items.
-* Groups are rendered with headings and sorted by priority.
-*/
+ * A command group for categorizing items.
+ * Groups are rendered with headings and sorted by priority.
+ */
 interface CommandGroup$1 {
   /** Unique identifier (branded type) */
   readonly id: GroupId;
@@ -100,10 +96,10 @@ interface CommandGroup$1 {
   readonly priority?: number | undefined;
 }
 /**
-* Immutable state snapshot of the command palette.
-* Consumed by React via `useSyncExternalStore` — each mutation
-* produces a new object reference for efficient re-render detection.
-*/
+ * Immutable state snapshot of the command palette.
+ * Consumed by React via `useSyncExternalStore` — each mutation
+ * produces a new object reference for efficient re-render detection.
+ */
 interface CommandState {
   /** Current search query string */
   readonly search: string;
@@ -228,9 +224,9 @@ interface CommandMachineOptions {
 //#endregion
 //#region src/core/keyboard/parser.d.ts
 /**
-* Structured representation of a keyboard shortcut after parsing.
-* The `normalized` field provides a deterministic string for dedup and comparison.
-*/
+ * Structured representation of a keyboard shortcut after parsing.
+ * The `normalized` field provides a deterministic string for dedup and comparison.
+ */
 interface ParsedShortcut {
   readonly key: string;
   readonly meta: boolean;
@@ -248,10 +244,10 @@ interface ShortcutBinding {
   readonly handler: () => void;
 }
 /**
-* Manages keyboard shortcut bindings with global keydown listening.
-* Supports `using` for automatic cleanup of both individual bindings and the
-* global document listener. Detects conflicts via Map.groupBy (ES2026).
-*/
+ * Manages keyboard shortcut bindings with global keydown listening.
+ * Supports `using` for automatic cleanup of both individual bindings and the
+ * global document listener. Detects conflicts via Map.groupBy (ES2026).
+ */
 declare class KeyboardShortcutRegistry implements Disposable {
   #private;
   constructor(options?: {
@@ -274,10 +270,10 @@ declare class KeyboardShortcutRegistry implements Disposable {
 //#endregion
 //#region src/core/registry.d.ts
 /**
-* Manages registration and lookup of command items and groups.
-* Uses set operation helpers (union/intersection/difference) for efficient ID operations.
-* All registration methods return Disposable for automatic cleanup via `using`.
-*/
+ * Manages registration and lookup of command items and groups.
+ * Uses set operation helpers (union/intersection/difference) for efficient ID operations.
+ * All registration methods return Disposable for automatic cleanup via `using`.
+ */
 declare class CommandRegistry implements Disposable {
   #private;
   /** Register an item — returns Disposable for `using` auto-deregister */
@@ -355,20 +351,12 @@ interface CommandAsyncItemsProps {
   readonly children: (items: readonly CommandItem$1[]) => ReactNode;
 }
 /** Suspense-based async item loader that resolves a promise of items using React 19 `use()`. */
-declare function CommandAsyncItems({
-  items,
-  fallback,
-  children
-}: CommandAsyncItemsProps): ReactNode;
+export declare function CommandAsyncItems({ items, fallback, children }: CommandAsyncItemsProps): ReactNode;
 //#endregion
 //#region src/react/badge.d.ts
 interface CommandBadgeProps extends ComponentPropsWithRef<"span"> {}
 /** Inline badge for categorization or status indicators on command items. */
-declare function CommandBadge({
-  ref,
-  children,
-  ...props
-}: CommandBadgeProps): ReactNode;
+export declare function CommandBadge({ ref, children, ...props }: CommandBadgeProps): ReactNode;
 //#endregion
 //#region src/react/dialog.d.ts
 interface CommandDialogProps extends CommandMachineOptions {
@@ -385,27 +373,12 @@ interface CommandDialogProps extends CommandMachineOptions {
   readonly container?: HTMLElement | null;
 }
 /** Dialog variant that wraps the command palette in a Radix UI Dialog with focus trap and overlay. */
-declare function CommandDialog({
-  children,
-  className,
-  overlayClassName,
-  contentClassName,
-  label,
-  description,
-  open: controlledOpen,
-  onOpenChange,
-  container,
-  ...machineOptions
-}: CommandDialogProps): ReactNode;
+export declare function CommandDialog({ children, className, overlayClassName, contentClassName, label, description, open: controlledOpen, onOpenChange, container, ...machineOptions }: CommandDialogProps): ReactNode;
 //#endregion
 //#region src/react/empty.d.ts
 interface CommandEmptyProps extends ComponentPropsWithRef<"div"> {}
 /** Rendered when no items match the current search query. */
-declare function CommandEmpty({
-  ref,
-  children,
-  ...props
-}: CommandEmptyProps): ReactNode;
+export declare function CommandEmpty({ ref, children, ...props }: CommandEmptyProps): ReactNode;
 //#endregion
 //#region src/react/group.d.ts
 interface CommandGroupProps extends ComponentPropsWithRef<"div"> {
@@ -417,14 +390,7 @@ interface CommandGroupProps extends ComponentPropsWithRef<"div"> {
   readonly forceId?: string;
 }
 /** Visual grouping container with an optional heading that hides when no items match. */
-declare function CommandGroup({
-  ref,
-  children,
-  heading,
-  priority,
-  forceId,
-  ...props
-}: CommandGroupProps): ReactNode;
+export declare function CommandGroup({ ref, children, heading, priority, forceId, ...props }: CommandGroupProps): ReactNode;
 //#endregion
 //#region src/react/highlight.d.ts
 interface CommandHighlightProps {
@@ -436,23 +402,14 @@ interface CommandHighlightProps {
   readonly highlightClassName?: string;
 }
 /** Renders search match highlighting by splitting text at scored match ranges. */
-declare function CommandHighlight({
-  text,
-  ranges,
-  highlightClassName
-}: CommandHighlightProps): ReactNode;
+export declare function CommandHighlight({ text, ranges, highlightClassName }: CommandHighlightProps): ReactNode;
 //#endregion
 //#region src/react/input.d.ts
 interface CommandInputProps extends Omit<ComponentPropsWithRef<"input">, "value" | "onChange" | "type" | "role"> {
   readonly onValueChange?: (value: string) => void;
 }
 /** Combobox input that drives the command palette search state. */
-declare function CommandInput({
-  ref,
-  placeholder,
-  onValueChange,
-  ...props
-}: CommandInputProps): ReactNode;
+export declare function CommandInput({ ref, placeholder, onValueChange, ...props }: CommandInputProps): ReactNode;
 //#endregion
 //#region src/react/item.d.ts
 interface CommandItemProps extends Omit<ComponentPropsWithRef<"div">, "onSelect" | "value"> {
@@ -464,17 +421,7 @@ interface CommandItemProps extends Omit<ComponentPropsWithRef<"div">, "onSelect"
   readonly forceId?: string;
 }
 /** Individual selectable item in the command list with keyboard and pointer activation. */
-declare function CommandItem({
-  ref,
-  children,
-  value,
-  keywords,
-  onSelect,
-  disabled,
-  shortcut,
-  forceId,
-  ...props
-}: CommandItemProps): ReactNode;
+export declare function CommandItem({ ref, children, value, keywords, onSelect, disabled, shortcut, forceId, ...props }: CommandItemProps): ReactNode;
 //#endregion
 //#region src/react/list.d.ts
 interface CommandListProps extends ComponentPropsWithRef<"div"> {
@@ -488,16 +435,7 @@ interface CommandListProps extends ComponentPropsWithRef<"div"> {
   readonly announceResults?: (count: number) => string;
 }
 /** Scrollable list container with auto-virtualization and aria-live announcements. */
-declare function CommandList({
-  ref,
-  children,
-  virtualize,
-  estimateSize,
-  overscan,
-  announceResults,
-  style,
-  ...props
-}: CommandListProps): ReactNode;
+export declare function CommandList({ ref, children, virtualize, estimateSize, overscan, announceResults, style, ...props }: CommandListProps): ReactNode;
 //#endregion
 //#region src/react/loading.d.ts
 interface CommandLoadingProps extends ComponentPropsWithRef<"div"> {
@@ -505,12 +443,7 @@ interface CommandLoadingProps extends ComponentPropsWithRef<"div"> {
   readonly loading?: boolean;
 }
 /** Shown during async operations, with configurable loading state override. */
-declare function CommandLoading({
-  ref,
-  children,
-  loading: loadingOverride,
-  ...props
-}: CommandLoadingProps): ReactNode;
+export declare function CommandLoading({ ref, children, loading: loadingOverride, ...props }: CommandLoadingProps): ReactNode;
 //#endregion
 //#region src/react/page.d.ts
 /** Branded page identifier */
@@ -523,18 +456,12 @@ interface CommandPageProps {
   readonly children?: ReactNode;
 }
 /** Page navigation container that only renders when its ID matches the active page. */
-declare function CommandPage({
-  id,
-  children
-}: CommandPageProps): ReactNode;
+export declare function CommandPage({ id, children }: CommandPageProps): ReactNode;
 //#endregion
 //#region src/react/separator.d.ts
 interface CommandSeparatorProps extends ComponentPropsWithRef<"div"> {}
 /** Visual divider between items or groups, rendered as a presentational element. */
-declare function CommandSeparator({
-  ref,
-  ...props
-}: CommandSeparatorProps): ReactNode;
+export declare function CommandSeparator({ ref, ...props }: CommandSeparatorProps): ReactNode;
 //#endregion
 //#region src/react/shortcut.d.ts
 interface CommandShortcutProps extends ComponentPropsWithRef<"kbd"> {
@@ -542,12 +469,7 @@ interface CommandShortcutProps extends ComponentPropsWithRef<"kbd"> {
   readonly shortcut?: string;
 }
 /** Keyboard shortcut display with platform-aware formatting (e.g., Cmd vs Ctrl). */
-declare function CommandShortcut({
-  ref,
-  shortcut,
-  children,
-  ...props
-}: CommandShortcutProps): ReactNode;
+export declare function CommandShortcut({ ref, shortcut, children, ...props }: CommandShortcutProps): ReactNode;
 //#endregion
 //#region src/react/command.d.ts
 interface CommandRootProps extends CommandMachineOptions {
@@ -556,14 +478,9 @@ interface CommandRootProps extends CommandMachineOptions {
   readonly label?: string;
 }
 /** Root compound component that provides the command state machine context to all children. */
-declare function CommandRoot({
-  children,
-  className,
-  label,
-  ...machineOptions
-}: CommandRootProps): ReactNode;
+declare function CommandRoot({ children, className, label, ...machineOptions }: CommandRootProps): ReactNode;
 /** Compound component namespace */
-declare const Command: typeof CommandRoot & {
+export declare const Command: typeof CommandRoot & {
   readonly Input: typeof CommandInput;
   readonly List: typeof CommandList;
   readonly Item: typeof CommandItem;
@@ -623,8 +540,8 @@ interface CommandStateContextValue {
   /** Map of visible item IDs to their translateY pixel offsets. null = not virtualizing. */
   readonly virtualPositionMap: ReadonlyMap<ItemId, number> | null;
 }
-declare const CommandStableContext: Context<CommandStableContextValue | null>;
-declare const CommandStateContext: Context<CommandStateContextValue | null>;
+export declare const CommandStableContext: Context<CommandStableContextValue | null>;
+export declare const CommandStateContext: Context<CommandStateContextValue | null>;
 interface CommandGroupContextValue {
   readonly groupId: string;
   readonly headingId: string;
@@ -640,7 +557,7 @@ interface CommandErrorBoundaryState {
   readonly error: Error | null;
 }
 /** Error boundary for graceful failure recovery in command subtrees. */
-declare class CommandErrorBoundary extends Component<CommandErrorBoundaryProps, CommandErrorBoundaryState> {
+export declare class CommandErrorBoundary extends Component<CommandErrorBoundaryProps, CommandErrorBoundaryState> {
   override state: CommandErrorBoundaryState;
   static getDerivedStateFromError(error: Error): CommandErrorBoundaryState;
   override componentDidCatch(error: Error, errorInfo: ErrorInfo): void;
@@ -658,32 +575,32 @@ interface UseCommandReturn {
   readonly id: CommandRootId;
 }
 /** Core hook that binds a CommandMachine to React via useSyncExternalStore, useTransition, and useOptimistic. */
-declare function useCommand(machine: CommandMachine): UseCommandReturn;
+export declare function useCommand(machine: CommandMachine): UseCommandReturn;
 //#endregion
 //#region src/react/hooks/use-command-state.d.ts
 /** Get the full command state with proper subscription */
-declare function useCommandState(): CommandState;
+export declare function useCommandState(): CommandState;
 /** Get a selected slice of command state — only re-renders when selected value changes */
-declare function useCommandState<T>(selector: (state: CommandState) => T): T;
+export declare function useCommandState<T>(selector: (state: CommandState) => T): T;
 //#endregion
 //#region src/react/hooks/use-devtools.d.ts
 /**
-* Exposes command palette internals to browser devtools.
-* Only active in development — completely tree-shaken in production builds.
-*
-* @example
-* ```tsx
-* function MyPalette() {
-*   useCommandDevtools('main');
-*   return <Command>...</Command>;
-* }
-* ```
-*/
-declare function useCommandDevtools(label?: string): void;
+ * Exposes command palette internals to browser devtools.
+ * Only active in development — completely tree-shaken in production builds.
+ *
+ * @example
+ * ```tsx
+ * function MyPalette() {
+ *   useCommandDevtools('main');
+ *   return <Command>...</Command>;
+ * }
+ * ```
+ */
+export declare function useCommandDevtools(label?: string): void;
 //#endregion
 //#region src/react/hooks/use-keyboard.d.ts
 /** Create a keydown handler for command palette keyboard navigation */
-declare function createKeydownHandler(machine: CommandMachine, getState: () => CommandState): (event: KeyboardEvent) => void;
+export declare function createKeydownHandler(machine: CommandMachine, getState: () => CommandState): (event: KeyboardEvent) => void;
 //#endregion
 //#region src/react/hooks/use-register.d.ts
 /** Options for item registration */
@@ -697,14 +614,14 @@ interface RegisterItemOptions {
   readonly forceId?: string;
 }
 /** Register a command item with the machine — auto-deregisters on unmount */
-declare function useRegisterItem(value: string, options?: RegisterItemOptions): ItemId;
+export declare function useRegisterItem(value: string, options?: RegisterItemOptions): ItemId;
 /** Options for group registration */
 interface RegisterGroupOptions {
   readonly priority?: number;
   readonly forceId?: string;
 }
 /** Register a command group with the machine — auto-deregisters on unmount */
-declare function useRegisterGroup(heading?: string, options?: RegisterGroupOptions): GroupId;
+export declare function useRegisterGroup(heading?: string, options?: RegisterGroupOptions): GroupId;
 //#endregion
 //#region src/react/hooks/use-virtualizer.d.ts
 interface VirtualizerOptions {
@@ -727,6 +644,6 @@ interface VirtualizerReturn {
   readonly measureElement: (element: HTMLElement | null) => void;
 }
 /** Lightweight virtualizer for large item lists using ResizeObserver and scroll tracking. */
-declare function useVirtualizer(options: VirtualizerOptions): VirtualizerReturn;
+export declare function useVirtualizer(options: VirtualizerOptions): VirtualizerReturn;
 //#endregion
-export { type ActivityMode, Command, CommandActivity, type CommandActivityProps, CommandAsyncItems, type CommandAsyncItemsProps, CommandBadge, type CommandBadgeProps, type CommandContextValue, CommandDialog, type CommandDialogProps, CommandEmpty, type CommandEmptyProps, CommandErrorBoundary, type CommandErrorBoundaryProps, CommandGroup, type CommandGroupContextValue, type CommandGroupProps, CommandHighlight, type CommandHighlightProps, CommandInput, type CommandInputProps, CommandItem, type CommandItemProps, CommandList, type CommandListProps, CommandLoading, type CommandLoadingProps, CommandPage, type CommandPageId, type CommandPageProps, type CommandRootId, type CommandRootProps, CommandSeparator, type CommandSeparatorProps, CommandShortcut, type CommandShortcutProps, CommandStableContext, type CommandStableContextValue, CommandStateContext, type CommandStateContextValue, type RegisterGroupOptions, type RegisterItemOptions, type UseCommandReturn, type VirtualItem, type VirtualizerOptions, type VirtualizerReturn, createKeydownHandler, useCommand, useCommandDevtools, useCommandState, useRegisterGroup, useRegisterItem, useVirtualizer };
+export type { ActivityMode, CommandActivityProps, CommandAsyncItemsProps, CommandBadgeProps, CommandContextValue, CommandDialogProps, CommandEmptyProps, CommandErrorBoundaryProps, CommandGroupContextValue, CommandGroupProps, CommandHighlightProps, CommandInputProps, CommandItemProps, CommandListProps, CommandLoadingProps, CommandPageId, CommandPageProps, CommandRootId, CommandRootProps, CommandSeparatorProps, CommandShortcutProps, CommandStableContextValue, CommandStateContextValue, RegisterGroupOptions, RegisterItemOptions, UseCommandReturn, VirtualItem, VirtualizerOptions, VirtualizerReturn };

package/dist/react/index.mjs

@@ -98,82 +98,6 @@ function ensureWellFormed(str) {
 	return str.replace(LONE_SURROGATE_RE, REPLACEMENT_CHAR);
 }
 //#endregion
-//#region src/core/keyboard/parser.ts
-const isMac = typeof navigator !== "undefined" && (navigator.userAgentData?.platform === "macOS" || /Mac|iPod|iPhone|iPad/.test(navigator.platform));
-/** Modifier aliases — cross-platform Mod resolution */
-const MODIFIER_MAP = {
-	mod: isMac ? "meta" : "ctrl",
-	meta: "meta",
-	cmd: "meta",
-	command: "meta",
-	ctrl: "ctrl",
-	control: "ctrl",
-	shift: "shift",
-	alt: "alt",
-	option: "alt",
-	opt: "alt"
-};
-/**
-* Parse a shortcut string like "Mod+Shift+K" into a structured ParsedShortcut.
-* Ensures valid Unicode input via ensureWellFormed helper.
-*/
-function parseShortcut(shortcut) {
-	const safeShortcut = ensureWellFormed(shortcut);
-	const parts = safeShortcut.split("+").map((p) => p.trim().toLowerCase());
-	let meta = false;
-	let ctrl = false;
-	let shift = false;
-	let alt = false;
-	let key = "";
-	for (const part of parts) {
-		const modifier = MODIFIER_MAP[part];
-		if (modifier) switch (modifier) {
-			case "meta":
-				meta = true;
-				break;
-			case "ctrl":
-				ctrl = true;
-				break;
-			case "shift":
-				shift = true;
-				break;
-			case "alt":
-				alt = true;
-				break;
-		}
-		else key = part;
-	}
-	const modifiers = [];
-	if (meta) modifiers.push("meta");
-	if (ctrl) modifiers.push("ctrl");
-	if (shift) modifiers.push("shift");
-	if (alt) modifiers.push("alt");
-	modifiers.push(key);
-	return {
-		key,
-		meta,
-		ctrl,
-		shift,
-		alt,
-		raw: safeShortcut,
-		normalized: modifiers.join("+")
-	};
-}
-/**
-* Formats a ParsedShortcut for display using platform-appropriate symbols.
-* On macOS: renders glyphs (⌘, ⇧, ⌥, ⌃). On other platforms: text labels joined by "+".
-*/
-function formatShortcut(parsed) {
-	const parts = [];
-	if (parsed.meta) parts.push(isMac ? "⌘" : "Ctrl");
-	if (parsed.ctrl && !(!isMac && parsed.meta)) parts.push(isMac ? "⌃" : "Ctrl");
-	if (parsed.shift) parts.push(isMac ? "⇧" : "Shift");
-	if (parsed.alt) parts.push(isMac ? "⌥" : "Alt");
-	const displayKey = parsed.key.length === 1 ? parsed.key.toUpperCase() : parsed.key.charAt(0).toUpperCase() + parsed.key.slice(1);
-	parts.push(displayKey);
-	return isMac ? parts.join("") : parts.join("+");
-}
-//#endregion
 //#region src/core/types.ts
 /** Create a branded {@link ItemId} from a plain string. Ensures well-formed Unicode. */
 function itemId(id) {
@@ -371,6 +295,80 @@ function detectConflicts(shortcuts) {
 	return new Map(grouped.entries().filter(([, group]) => group.length > 1));
 }
 //#endregion
+//#region src/core/keyboard/parser.ts
+const isMac = typeof navigator !== "undefined" && (navigator.userAgentData?.platform === "macOS" || /Mac|iPod|iPhone|iPad/.test(navigator.platform));
+/** Modifier aliases — cross-platform Mod resolution */
+const MODIFIER_MAP = {
+	mod: isMac ? "meta" : "ctrl",
+	meta: "meta",
+	cmd: "meta",
+	command: "meta",
+	ctrl: "ctrl",
+	control: "ctrl",
+	shift: "shift",
+	alt: "alt",
+	option: "alt",
+	opt: "alt"
+};
+/**
+* Parse a shortcut string like "Mod+Shift+K" into a structured ParsedShortcut.
+* Ensures valid Unicode input via ensureWellFormed helper.
+*/
+function parseShortcut(shortcut) {
+	const safeShortcut = ensureWellFormed(shortcut);
+	const parts = safeShortcut.split("+").map((p) => p.trim().toLowerCase());
+	let meta = false;
+	let ctrl = false;
+	let shift = false;
+	let alt = false;
+	let key = "";
+	for (const part of parts) {
+		const modifier = MODIFIER_MAP[part];
+		if (modifier) switch (modifier) {
+			case "meta":
+				meta = true;
+				break;
+			case "ctrl":
+				ctrl = true;
+				break;
+			case "shift":
+				shift = true;
+				break;
+			case "alt": alt = true;
+		}
+		else key = part;
+	}
+	const modifiers = [];
+	if (meta) modifiers.push("meta");
+	if (ctrl) modifiers.push("ctrl");
+	if (shift) modifiers.push("shift");
+	if (alt) modifiers.push("alt");
+	modifiers.push(key);
+	return {
+		key,
+		meta,
+		ctrl,
+		shift,
+		alt,
+		raw: safeShortcut,
+		normalized: modifiers.join("+")
+	};
+}
+/**
+* Formats a ParsedShortcut for display using platform-appropriate symbols.
+* On macOS: renders glyphs (⌘, ⇧, ⌥, ⌃). On other platforms: text labels joined by "+".
+*/
+function formatShortcut(parsed) {
+	const parts = [];
+	if (parsed.meta) parts.push(isMac ? "⌘" : "Ctrl");
+	if (parsed.ctrl && !(!isMac && parsed.meta)) parts.push(isMac ? "⌃" : "Ctrl");
+	if (parsed.shift) parts.push(isMac ? "⇧" : "Shift");
+	if (parsed.alt) parts.push(isMac ? "⌥" : "Alt");
+	const displayKey = parsed.key.length === 1 ? parsed.key.toUpperCase() : parsed.key.charAt(0).toUpperCase() + parsed.key.slice(1);
+	parts.push(displayKey);
+	return isMac ? parts.join("") : parts.join("+");
+}
+//#endregion
 //#region src/core/keyboard/index.ts
 /**
 * Manages keyboard shortcut bindings with global keydown listening.
@@ -1059,9 +1057,10 @@ function createCommandMachine(options = {}) {
 		const loop = options.loop ?? true;
 		const currentIdx = activeId ? filteredIdIndex.get(activeId) ?? -1 : -1;
 		let newIdx;
-		if (direction === "next") if (currentIdx === -1 || currentIdx >= filteredIds.length - 1) newIdx = loop ? 0 : filteredIds.length - 1;
-		else newIdx = currentIdx + 1;
-		else if (currentIdx <= 0) newIdx = loop ? filteredIds.length - 1 : 0;
+		if (direction === "next") {
+			if (currentIdx === -1 || currentIdx >= filteredIds.length - 1) newIdx = loop ? 0 : filteredIds.length - 1;
+			else newIdx = currentIdx + 1;
+		} else if (currentIdx <= 0) newIdx = loop ? filteredIds.length - 1 : 0;
 		else newIdx = currentIdx - 1;
 		const newActiveId = filteredIds[newIdx] ?? null;
 		if (newActiveId !== activeId) {
@@ -1177,7 +1176,6 @@ function createCommandMachine(options = {}) {
 			case "UNREGISTER_GROUP":
 				registry.unregisterGroup(event.id);
 				refilter(state.search);
-				break;
 		}
 	}
 	return {
@@ -1294,7 +1292,6 @@ function createKeydownHandler(machine, getState) {
 			case "Escape":
 				event.preventDefault();
 				machine.send({ type: "CLOSE" });
-				break;
 		}
 	};
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "modern-cmdk",
-  "version": "1.2.1",
+  "version": "1.2.2",
   "type": "module",
   "description": "The definitive command palette engine for the modern web",
   "license": "MIT",
@@ -57,13 +57,13 @@
     }
   },
   "dependencies": {
-    "idb-keyval": "6.2.5"
+    "idb-keyval": "6.3.0"
   },
   "devDependencies": {
-    "globby": "16.2.0",
-    "jscodeshift": "17.3.0",
-    "radix-ui": "1.6.0",
-    "@types/jscodeshift": "^17.3.0"
+    "globby": "16.2.4",
+    "jscodeshift": "17.4.0",
+    "radix-ui": "1.6.7",
+    "@types/jscodeshift": "17.3.0"
   },
   "keywords": [
     "command-palette",