modern-cmdk 1.2.2 → 1.2.3

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";
 /** Props for the CommandActivity wrapper that controls visibility via React's Activity API. */
@@ -10,13 +9,11 @@ interface CommandActivityProps {
   readonly children: ReactNode;
 }
 /**
- * Wraps content in React 19.3.0-canary Activity API.
+ * Wraps content in React's <Activity> API (React 19.2+).
  * 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 */
 interface SearchResult {
   readonly id: ItemId;
@@ -37,8 +34,6 @@ interface SearchEngine extends Disposable {
   /** Dispose resources */
   [Symbol.dispose](): void;
 }
-//#endregion
-//#region src/core/types.d.ts
 /**
  * Branded type for command item IDs.
  * Prevents accidental mixing with plain strings at the type level.
@@ -221,8 +216,6 @@ interface CommandMachineOptions {
   /** Item count threshold for automatic virtualization (default: 100) */
   readonly virtualizeThreshold?: number | undefined;
 }
-//#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.
@@ -236,8 +229,6 @@ interface ParsedShortcut {
   readonly raw: string;
   readonly normalized: string;
 }
-//#endregion
-//#region src/core/keyboard/index.d.ts
 interface ShortcutBinding {
   readonly shortcut: ParsedShortcut;
   readonly itemId: ItemId;
@@ -267,8 +258,6 @@ declare class KeyboardShortcutRegistry implements Disposable {
   getBindings(): ReadonlyMap<string, ShortcutBinding>;
   [Symbol.dispose](): void;
 }
-//#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.
@@ -322,8 +311,6 @@ declare class CommandRegistry implements Disposable {
   clear(): void;
   [Symbol.dispose](): void;
 }
-//#endregion
-//#region src/core/machine.d.ts
 /** Command machine — explicit resource management via `using` */
 interface CommandMachine extends Disposable {
   getState(): CommandState;
@@ -340,8 +327,6 @@ interface CommandMachine extends Disposable {
   getFilteredIdIndex(): ReadonlyMap<ItemId, number>;
   [Symbol.dispose](): void;
 }
-//#endregion
-//#region src/react/async-items.d.ts
 interface CommandAsyncItemsProps {
   /** Promise that resolves to items */
   readonly items: Promise<readonly CommandItem$1[]>;
@@ -352,13 +337,9 @@ interface CommandAsyncItemsProps {
 }
 /** Suspense-based async item loader that resolves a promise of items using React 19 `use()`. */
 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. */
 export declare function CommandBadge({ ref, children, ...props }: CommandBadgeProps): ReactNode;
-//#endregion
-//#region src/react/dialog.d.ts
 interface CommandDialogProps extends CommandMachineOptions {
   readonly children?: ReactNode;
   readonly className?: string;
@@ -374,13 +355,9 @@ interface CommandDialogProps extends CommandMachineOptions {
 }
 /** Dialog variant that wraps the command palette in a Radix UI Dialog with focus trap and overlay. */
 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. */
 export declare function CommandEmpty({ ref, children, ...props }: CommandEmptyProps): ReactNode;
-//#endregion
-//#region src/react/group.d.ts
 interface CommandGroupProps extends ComponentPropsWithRef<"div"> {
   /** Heading text displayed above the group */
   readonly heading?: string;
@@ -391,8 +368,6 @@ interface CommandGroupProps extends ComponentPropsWithRef<"div"> {
 }
 /** Visual grouping container with an optional heading that hides when no items match. */
 export declare function CommandGroup({ ref, children, heading, priority, forceId, ...props }: CommandGroupProps): ReactNode;
-//#endregion
-//#region src/react/highlight.d.ts
 interface CommandHighlightProps {
   /** The full text to display */
   readonly text: string;
@@ -403,15 +378,11 @@ interface CommandHighlightProps {
 }
 /** Renders search match highlighting by splitting text at scored match ranges. */
 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. */
 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"> {
   readonly value: string;
   readonly keywords?: readonly string[];
@@ -422,8 +393,6 @@ interface CommandItemProps extends Omit<ComponentPropsWithRef<"div">, "onSelect"
 }
 /** Individual selectable item in the command list with keyboard and pointer activation. */
 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"> {
   /** Override automatic virtualization (default: auto at >100 items, false to opt-out) */
   readonly virtualize?: boolean;
@@ -436,16 +405,12 @@ interface CommandListProps extends ComponentPropsWithRef<"div"> {
 }
 /** Scrollable list container with auto-virtualization and aria-live announcements. */
 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"> {
   /** Override the loading state detection */
   readonly loading?: boolean;
 }
 /** Shown during async operations, with configurable loading state override. */
 export declare function CommandLoading({ ref, children, loading: loadingOverride, ...props }: CommandLoadingProps): ReactNode;
-//#endregion
-//#region src/react/page.d.ts
 /** Branded page identifier */
 type CommandPageId = string & {
   readonly __brand: "CommandPageId";
@@ -457,21 +422,15 @@ interface CommandPageProps {
 }
 /** Page navigation container that only renders when its ID matches the active page. */
 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. */
 export declare function CommandSeparator({ ref, ...props }: CommandSeparatorProps): ReactNode;
-//#endregion
-//#region src/react/shortcut.d.ts
 interface CommandShortcutProps extends ComponentPropsWithRef<"kbd"> {
   /** Shortcut string to display (e.g., "Mod+K"). If not provided, reads from nearest Command.Item. */
   readonly shortcut?: string;
 }
 /** Keyboard shortcut display with platform-aware formatting (e.g., Cmd vs Ctrl). */
 export declare function CommandShortcut({ ref, shortcut, children, ...props }: CommandShortcutProps): ReactNode;
-//#endregion
-//#region src/react/command.d.ts
 interface CommandRootProps extends CommandMachineOptions {
   readonly children?: ReactNode;
   readonly className?: string;
@@ -496,8 +455,6 @@ export declare const Command: typeof CommandRoot & {
   readonly AsyncItems: typeof CommandAsyncItems;
   readonly Activity: typeof CommandActivity;
 };
-//#endregion
-//#region src/react/context.d.ts
 /** Branded newtype for the root instance ID */
 type CommandRootId = string & {
   readonly __brand: "CommandRootId";
@@ -546,8 +503,6 @@ interface CommandGroupContextValue {
   readonly groupId: string;
   readonly headingId: string;
 }
-//#endregion
-//#region src/react/error-boundary.d.ts
 interface CommandErrorBoundaryProps {
   readonly children: ReactNode;
   readonly fallback?: ReactNode | ((error: Error) => ReactNode);
@@ -563,8 +518,6 @@ export declare class CommandErrorBoundary extends Component<CommandErrorBoundary
   override componentDidCatch(error: Error, errorInfo: ErrorInfo): void;
   override render(): ReactNode;
 }
-//#endregion
-//#region src/react/hooks/use-command.d.ts
 interface UseCommandReturn {
   readonly state: CommandState;
   readonly isPending: boolean;
@@ -576,33 +529,27 @@ interface UseCommandReturn {
 }
 /** Core hook that binds a CommandMachine to React via useSyncExternalStore, useTransition, and useOptimistic. */
 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 */
 export declare function useCommandState(): CommandState;
 /** Get a selected slice of command state — only re-renders when selected value changes */
 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.
+ * Development only: the effect is gated on `process.env.NODE_ENV` and returns early in
+ * production builds (the hook itself still ships). Call it from a component rendered inside
+ * `<Command>`: outside one there is no machine to inspect and the hook does nothing.
  *
  * @example
  * ```tsx
- * function MyPalette() {
+ * function DevtoolsBridge() {
  *   useCommandDevtools('main');
- *   return <Command>...</Command>;
+ *   return null;
  * }
  * ```
  */
 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 */
 export declare function createKeydownHandler(machine: CommandMachine, getState: () => CommandState): (event: KeyboardEvent) => void;
-//#endregion
-//#region src/react/hooks/use-register.d.ts
 /** Options for item registration */
 interface RegisterItemOptions {
   readonly keywords?: readonly string[];
@@ -622,8 +569,6 @@ interface RegisterGroupOptions {
 }
 /** Register a command group with the machine — auto-deregisters on unmount */
 export declare function useRegisterGroup(heading?: string, options?: RegisterGroupOptions): GroupId;
-//#endregion
-//#region src/react/hooks/use-virtualizer.d.ts
 interface VirtualizerOptions {
   readonly count: number;
   readonly estimateSize: number;
@@ -645,5 +590,4 @@ interface VirtualizerReturn {
 }
 /** Lightweight virtualizer for large item lists using ResizeObserver and scroll tracking. */
 export declare function useVirtualizer(options: VirtualizerOptions): VirtualizerReturn;
-//#endregion
 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 };