@choice-ui/react 1.4.3 → 1.4.6

package/dist/components/code-block/src/components/code-block-header.js

@@ -1,6 +1,6 @@
 import { jsxs, jsx } from "react/jsx-runtime";
 import { IconButton } from "../../../icon-button/dist/index.js";
-import { FileCode, CircleCirclehecirclek, ClipboardSmall, Enlarge } from "@choiceform/icons-react";
+import { FileCode, Check, ClipboardSmall, Enlarge } from "@choiceform/icons-react";
 import { memo } from "react";
 import { getIconFromFilename, getLanguageIcon } from "../utils/language-icon-map.js";
 import { getDefaultFilenameForLanguage } from "../utils/default-filename.js";
@@ -9,17 +9,51 @@ const codeBlockHeaderTv = tcv({
   slots: {
     header: "text-body-medium code-header flex h-8 items-center justify-between pr-1 pl-2",
     title: "flex items-center gap-1",
-    filename: "text-secondary-foreground",
+    filename: "",
     actions: "flex items-center",
-    button: "opacity-0 group-hover:opacity-100",
+    button: "opacity-0 group-hover/code-block:opacity-100",
     lineCount: "text-success-foreground ml-2 font-strong"
   },
   variants: {
     isExpanded: {
-      true: { header: "bg-secondary-background" },
+      true: {},
       false: {}
+    },
+    variant: {
+      default: {
+        filename: "text-secondary-foreground"
+      },
+      light: {
+        filename: "text-gray-900"
+      },
+      dark: {
+        filename: "text-white"
+      }
     }
   },
+  compoundVariants: [
+    {
+      variant: "default",
+      isExpanded: true,
+      class: {
+        header: "bg-secondary-background"
+      }
+    },
+    {
+      variant: "light",
+      isExpanded: true,
+      class: {
+        header: "bg-gray-100"
+      }
+    },
+    {
+      variant: "dark",
+      isExpanded: true,
+      class: {
+        header: "bg-gray-700"
+      }
+    }
+  ],
   defaultVariants: {
     isExpanded: true
   }
@@ -28,7 +62,7 @@ const CodeBlockHeader = memo(function CodeBlockHeader2(props) {
   const {
     className,
     codeBlock,
-    showLineCount = true,
+    showLineCount = false,
     i18n = {
       collapse: "Collapse",
       copied: "Copied",
@@ -46,12 +80,13 @@ const CodeBlockHeader = memo(function CodeBlockHeader2(props) {
     copied = false,
     expandable = true,
     handleExpand,
-    handleCopy
+    handleCopy,
+    variant
   } = codeBlock;
   if (!handleExpand || !handleCopy) {
     return null;
   }
-  const tv = codeBlockHeaderTv({ isExpanded });
+  const tv = codeBlockHeaderTv({ isExpanded, variant });
   let icon = null;
   try {
     if (filename && typeof filename === "string") {
@@ -78,17 +113,17 @@ const CodeBlockHeader = memo(function CodeBlockHeader2(props) {
         IconButton,
         {
           className: tv.button(),
-          variant: "ghost",
+          variant: variant === "dark" ? "dark" : "ghost",
           onClick: () => handleCopy(),
           tooltip: { content: copyTooltipContent },
-          children: copied ? /* @__PURE__ */ jsx(CircleCirclehecirclek, { className: "text-success-foreground" }) : /* @__PURE__ */ jsx(ClipboardSmall, {})
+          children: copied ? /* @__PURE__ */ jsx(Check, { className: "text-success-foreground" }) : /* @__PURE__ */ jsx(ClipboardSmall, {})
         }
       ),
       expandable && /* @__PURE__ */ jsx(
         IconButton,
         {
           className: tv.button(),
-          variant: "ghost",
+          variant: variant === "dark" ? "dark" : "ghost",
           onClick: handleExpand,
           tooltip: {
             content: expandTooltipContent

package/dist/components/code-block/src/index.d.ts

@@ -1,10 +1,4 @@
-import { CodeBlockContent } from './components';
-export declare const CodeBlock: import('react').NamedExoticComponent<import('../..').CodeBlockProps> & {
-    Code: import('react').NamedExoticComponent<import('../..').CodeBlockCodeProps>;
-    Content: typeof CodeBlockContent;
-    Footer: import('react').NamedExoticComponent<import('../..').CodeBlockFooterProps>;
-    Header: import('react').NamedExoticComponent<import('../..').CodeBlockHeaderProps>;
-};
-export { CodeBlockCode } from './components';
-export type { CodeBlockProps, CodeBlockHeaderProps, CodeBlockFooterProps, CodeBlockContentProps, CodeBlockCodeProps, CodeBlockContextValue, CodeBlockInjectedProps, UseCodeBlockOptions, UseCodeBlockReturn, UseScrollDetectionOptions, } from './types';
+export { CodeBlock } from './code-block';
+export { CodeBlockHeader, CodeBlockFooter, CodeBlockContent, CodeBlockCode } from './components';
+export type { CodeBlockProps, CodeBlockHeaderProps, CodeBlockFooterProps, CodeBlockContentProps, CodeBlockCodeProps, } from './types';
 export { getDefaultFilenameForLanguage } from './utils';

package/dist/components/combobox/dist/index.d.ts

@@ -19,21 +19,33 @@ interface ComboboxTriggerProps extends Omit<HTMLProps<HTMLInputElement>, "size"
     value?: string;
     variant?: "default" | "dark" | "reset";
 }
-declare const ComboboxTrigger: React.ForwardRefExoticComponent<Omit<ComboboxTriggerProps, "ref"> & React.RefAttributes<HTMLInputElement>>;
+declare const ComboboxTrigger: React.MemoExoticComponent<React.ForwardRefExoticComponent<Omit<ComboboxTriggerProps, "ref"> & React.RefAttributes<HTMLInputElement>>>;
 
 interface ComboboxRef {
     handleKeyDown: (event: React.KeyboardEvent) => void;
 }
 interface ComboboxProps {
+    /**
+     * @default true
+     */
     autoSelection?: boolean;
     children?: React.ReactNode;
     disabled?: boolean;
-    focusManagerProps?: FloatingFocusManagerProps;
+    /**
+     * @default { returnFocus: true, modal: false }
+     */
+    focusManagerProps?: Partial<Omit<FloatingFocusManagerProps, "children" | "context">>;
+    /**
+     * @default true
+     */
     matchTriggerWidth?: boolean;
     onBlur?: (value: string) => void;
     onChange?: (value: string) => void;
     onOpenChange?: (open: boolean, trigger?: "click" | "focus" | "input") => void;
     open?: boolean;
+    /**
+     * @default "bottom-start"
+     */
     placement?: Placement;
     portalId?: string;
     position?: {
@@ -42,8 +54,15 @@ interface ComboboxProps {
     } | null;
     readOnly?: boolean;
     root?: HTMLElement | null;
+    /**
+     * Trigger type: "input" for input mode, "coordinate" for coordinate mode
+     * @default "input"
+     */
     trigger?: "input" | "coordinate";
     value?: string;
+    /**
+     * @default "default"
+     */
     variant?: "default" | "light" | "reset";
 }
 interface ComboboxComponentType extends React.ForwardRefExoticComponent<ComboboxProps & React.RefAttributes<ComboboxRef>> {

package/dist/components/combobox/dist/index.js

@@ -119,8 +119,8 @@ var comboboxTriggerTv = tcv({
     noMatch: false
   }
 });
-var ComboboxTrigger = forwardRef(
-  function ComboboxTrigger2(props, ref) {
+var ComboboxTrigger = memo(
+  forwardRef(function ComboboxTrigger2(props, ref) {
     const {
       active = false,
       className,
@@ -194,12 +194,14 @@ var ComboboxTrigger = forwardRef(
           variant: "ghost",
           tooltip: { content: i18n.clear },
           onClick: handleClear,
+          disabled,
           children: /* @__PURE__ */ jsx(RemoveSmall, {})
         }
       ) : suffixElement && /* @__PURE__ */ jsx(
         IconButton,
         {
           className: tv.icon(),
+          disabled,
           variant: "solid",
           active,
           onClick: (e) => {
@@ -211,8 +213,9 @@ var ComboboxTrigger = forwardRef(
         }
       )
     ] });
-  }
+  })
 );
+ComboboxTrigger.displayName = "ComboboxTrigger";
 var PORTAL_ROOT_ID = "floating-menu-root";
 var DEFAULT_OFFSET = 4;
 var ComboboxComponent = memo(function ComboboxComponent2(props) {
@@ -230,7 +233,6 @@ var ComboboxComponent = memo(function ComboboxComponent2(props) {
     position,
     readOnly = false,
     trigger = "input",
-    // 默认为输入模式
     value: controlledValue = "",
     focusManagerProps = {
       returnFocus: true,
@@ -327,8 +329,10 @@ var ComboboxComponent = memo(function ComboboxComponent2(props) {
         apply(args) {
           var _a;
           const { elements, availableHeight, rects } = args;
-          const contentHeight = ((_a = scrollRef.current) == null ? void 0 : _a.scrollHeight) || elements.floating.scrollHeight;
-          const maxHeight = Math.min(contentHeight, availableHeight);
+          const floatingScrollHeight = elements.floating.scrollHeight;
+          const scrollRefHeight = ((_a = scrollRef.current) == null ? void 0 : _a.scrollHeight) || 0;
+          const contentHeight = Math.max(floatingScrollHeight, scrollRefHeight);
+          const maxHeight = contentHeight > 0 ? Math.min(contentHeight, availableHeight) : availableHeight;
           Object.assign(elements.floating.style, {
             maxHeight: `${maxHeight}px`,
             display: "flex",
@@ -375,8 +379,6 @@ var ComboboxComponent = memo(function ComboboxComponent2(props) {
     virtual: true,
     loop: true,
     allowEscape: !isCoordinateMode
-    // 官方案例中有这个设置
-    // selectedIndex: isCoordinateMode ? null : activeIndex, // 确保选中状态同步
   });
   const { getReferenceProps, getFloatingProps, getItemProps } = useInteractions([
     role,
@@ -431,11 +433,11 @@ var ComboboxComponent = memo(function ComboboxComponent2(props) {
     setScrollTop,
     touch,
     isSelect: false,
-    // Combobox 不是 Select
+    // Combobox is not a Select
     fallback: false,
-    // Combobox 没有 fallback 机制
+    // Combobox does not have fallback mechanism
     setInnerOffset: void 0
-    // Combobox 不使用 innerOffset
+    // Combobox does not use innerOffset
   });
   const handleTouchStart = useEventCallback(() => {
     setTouch(true);
@@ -568,7 +570,7 @@ var ComboboxComponent = memo(function ComboboxComponent2(props) {
                           onContextMenu(e) {
                             e.preventDefault();
                           },
-                          // 坐标模式下添加键盘事件处理
+                          // Add keyboard event handling in coordinate mode
                           ...isCoordinateMode && {
                             tabIndex: 0,
                             onKeyDown: handleKeyDown
@@ -590,7 +592,8 @@ var ComboboxComponent = memo(function ComboboxComponent2(props) {
                               innerOffset: 0,
                               isPositioned,
                               onScroll: handleArrowScroll,
-                              onHide: handleArrowHide
+                              onHide: handleArrowHide,
+                              variant
                             },
                             dir
                           ))

package/dist/components/combobox/src/combobox-trigger.d.ts

@@ -17,4 +17,4 @@ export interface ComboboxTriggerProps extends Omit<HTMLProps<HTMLInputElement>,
     value?: string;
     variant?: "default" | "dark" | "reset";
 }
-export declare const ComboboxTrigger: React.ForwardRefExoticComponent<Omit<ComboboxTriggerProps, "ref"> & React.RefAttributes<HTMLInputElement>>;
+export declare const ComboboxTrigger: React.MemoExoticComponent<React.ForwardRefExoticComponent<Omit<ComboboxTriggerProps, "ref"> & React.RefAttributes<HTMLInputElement>>>;

package/dist/components/combobox/src/combobox-trigger.js

@@ -1,12 +1,12 @@
 import { jsx, jsxs } from "react/jsx-runtime";
 import { IconButton } from "../../icon-button/dist/index.js";
 import { ChevronDownSmall, RemoveSmall } from "@choiceform/icons-react";
-import { forwardRef, useState } from "react";
+import { memo, forwardRef, useState } from "react";
 import { useEventCallback } from "usehooks-ts";
 import { comboboxTriggerTv } from "./tv.js";
 import { tcx } from "../../../shared/utils/tcx/tcx.js";
-const ComboboxTrigger = forwardRef(
-  function ComboboxTrigger2(props, ref) {
+const ComboboxTrigger = memo(
+  forwardRef(function ComboboxTrigger2(props, ref) {
     const {
       active = false,
       className,
@@ -80,12 +80,14 @@ const ComboboxTrigger = forwardRef(
           variant: "ghost",
           tooltip: { content: i18n.clear },
           onClick: handleClear,
+          disabled,
           children: /* @__PURE__ */ jsx(RemoveSmall, {})
         }
       ) : suffixElement && /* @__PURE__ */ jsx(
         IconButton,
         {
           className: tv.icon(),
+          disabled,
           variant: "solid",
           active,
           onClick: (e) => {
@@ -97,8 +99,9 @@ const ComboboxTrigger = forwardRef(
         }
       )
     ] });
-  }
+  })
 );
+ComboboxTrigger.displayName = "ComboboxTrigger";
 export {
   ComboboxTrigger
 };

package/dist/components/combobox/src/combobox.d.ts

@@ -6,15 +6,27 @@ export interface ComboboxRef {
     handleKeyDown: (event: React.KeyboardEvent) => void;
 }
 export interface ComboboxProps {
+    /**
+     * @default true
+     */
     autoSelection?: boolean;
     children?: React.ReactNode;
     disabled?: boolean;
-    focusManagerProps?: FloatingFocusManagerProps;
+    /**
+     * @default { returnFocus: true, modal: false }
+     */
+    focusManagerProps?: Partial<Omit<FloatingFocusManagerProps, "children" | "context">>;
+    /**
+     * @default true
+     */
     matchTriggerWidth?: boolean;
     onBlur?: (value: string) => void;
     onChange?: (value: string) => void;
     onOpenChange?: (open: boolean, trigger?: "click" | "focus" | "input") => void;
     open?: boolean;
+    /**
+     * @default "bottom-start"
+     */
     placement?: Placement;
     portalId?: string;
     position?: {
@@ -23,8 +35,15 @@ export interface ComboboxProps {
     } | null;
     readOnly?: boolean;
     root?: HTMLElement | null;
+    /**
+     * Trigger type: "input" for input mode, "coordinate" for coordinate mode
+     * @default "input"
+     */
     trigger?: "input" | "coordinate";
     value?: string;
+    /**
+     * @default "default"
+     */
     variant?: "default" | "light" | "reset";
 }
 interface ComboboxComponentType extends React.ForwardRefExoticComponent<ComboboxProps & React.RefAttributes<ComboboxRef>> {

package/dist/components/combobox/src/combobox.js

@@ -24,7 +24,6 @@ const ComboboxComponent = memo(function ComboboxComponent2(props) {
     position,
     readOnly = false,
     trigger = "input",
-    // 默认为输入模式
     value: controlledValue = "",
     focusManagerProps = {
       returnFocus: true,
@@ -121,8 +120,10 @@ const ComboboxComponent = memo(function ComboboxComponent2(props) {
         apply(args) {
           var _a;
           const { elements, availableHeight, rects } = args;
-          const contentHeight = ((_a = scrollRef.current) == null ? void 0 : _a.scrollHeight) || elements.floating.scrollHeight;
-          const maxHeight = Math.min(contentHeight, availableHeight);
+          const floatingScrollHeight = elements.floating.scrollHeight;
+          const scrollRefHeight = ((_a = scrollRef.current) == null ? void 0 : _a.scrollHeight) || 0;
+          const contentHeight = Math.max(floatingScrollHeight, scrollRefHeight);
+          const maxHeight = contentHeight > 0 ? Math.min(contentHeight, availableHeight) : availableHeight;
           Object.assign(elements.floating.style, {
             maxHeight: `${maxHeight}px`,
             display: "flex",
@@ -169,8 +170,6 @@ const ComboboxComponent = memo(function ComboboxComponent2(props) {
     virtual: true,
     loop: true,
     allowEscape: !isCoordinateMode
-    // 官方案例中有这个设置
-    // selectedIndex: isCoordinateMode ? null : activeIndex, // 确保选中状态同步
   });
   const { getReferenceProps, getFloatingProps, getItemProps } = useInteractions([
     role,
@@ -225,11 +224,11 @@ const ComboboxComponent = memo(function ComboboxComponent2(props) {
     setScrollTop,
     touch,
     isSelect: false,
-    // Combobox 不是 Select
+    // Combobox is not a Select
     fallback: false,
-    // Combobox 没有 fallback 机制
+    // Combobox does not have fallback mechanism
     setInnerOffset: void 0
-    // Combobox 不使用 innerOffset
+    // Combobox does not use innerOffset
   });
   const handleTouchStart = useEventCallback(() => {
     setTouch(true);
@@ -362,7 +361,7 @@ const ComboboxComponent = memo(function ComboboxComponent2(props) {
                           onContextMenu(e) {
                             e.preventDefault();
                           },
-                          // 坐标模式下添加键盘事件处理
+                          // Add keyboard event handling in coordinate mode
                           ...isCoordinateMode && {
                             tabIndex: 0,
                             onKeyDown: handleKeyDown
@@ -384,7 +383,8 @@ const ComboboxComponent = memo(function ComboboxComponent2(props) {
                               innerOffset: 0,
                               isPositioned,
                               onScroll: handleArrowScroll,
-                              onHide: handleArrowHide
+                              onHide: handleArrowHide,
+                              variant
                             },
                             dir
                           ))

package/dist/components/command/dist/index.d.ts

@@ -10,9 +10,24 @@ interface CommandEmptyProps extends HTMLProps<HTMLDivElement> {
 }
 
 interface CommandGroupProps extends HTMLProps<HTMLDivElement> {
+    /**
+     * Whether to force mount the group.
+     * @default false
+     */
     forceMount?: boolean;
+    /**
+     * The heading of the group.
+     */
     heading?: react__default.ReactNode;
+    /**
+     * The value of the group.
+     */
     value?: string;
+    /**
+     * Whether the group is hidden.
+     * @default false
+     */
+    hidden?: boolean;
 }
 
 interface CommandInputProps extends Omit<TextFieldProps, "value" | "onChange" | "type"> {
@@ -43,12 +58,23 @@ interface CommandListProps extends ScrollAreaProps {
 }
 
 interface CommandLoadingProps extends react__default.HTMLAttributes<HTMLDivElement> {
+    /**
+     * The label of the loading.
+     * @default "Loading..."
+     */
     label?: string;
+    /**
+     * The progress of the loading.
+     * @default undefined
+     */
     progress?: number;
 }
 
 interface CommandDividerProps extends HTMLProps<HTMLDivElement> {
-    /** 是否始终渲染此分隔符。当禁用自动过滤功能时特别有用。 */
+    /**
+     * Whether to always render this divider. Useful when automatic filtering is disabled.
+     * @default false
+     */
     alwaysRender?: boolean;
 }
 
@@ -85,17 +111,40 @@ interface CommandProps extends Omit<react__default.HTMLAttributes<HTMLDivElement
      * If `false`, you must conditionally render valid items based on the search query yourself.
      */
     shouldFilter?: boolean;
+    /**
+     * The size of the command menu.
+     * @default "default"
+     */
     size?: "default" | "large";
     /**
      * Optional controlled state of the selected command menu item.
      */
     value?: string;
+    /**
+     * The variant of the command menu.
+     * @default "default"
+     */
     variant?: "default" | "dark";
     /**
      * Set to `false` to disable ctrl+n/j/p/k shortcuts. Defaults to `true`.
      */
     vimBindings?: boolean;
 }
+type Context = {
+    filter: () => boolean;
+    getDisablePointerSelection: () => boolean;
+    group: (id: string) => () => void;
+    inputId: string;
+    item: (id: string, groupId?: string) => () => void;
+    label?: string;
+    labelId: string;
+    listId: string;
+    listInnerRef: react__default.MutableRefObject<HTMLDivElement | null>;
+    size?: "default" | "large";
+    store: Store;
+    value: (id: string, value?: string, keywords?: string[]) => void;
+    variant?: "default" | "dark";
+};
 type State = {
     filtered: {
         count: number;
@@ -106,19 +155,31 @@ type State = {
     selectedItemId?: string;
     value: string;
 };
+type Store = {
+    emit: () => void;
+    setState: <K extends keyof State>(key: K, value: State[K], opts?: unknown) => void;
+    snapshot: () => State;
+    subscribe: (callback: () => void) => () => void;
+};
 
 declare const defaultFilter: CommandFilter;
 declare const Command$1: react__default.ForwardRefExoticComponent<CommandProps & react__default.RefAttributes<HTMLDivElement>>;
 
+declare const useCommand: () => Context;
+
 /** Run a selector against the store state. */
 declare function useCommandState<T>(selector: (state: State) => T): T;
 
+declare function useValue(id: string, ref: react__default.RefObject<HTMLElement>, deps: (string | react__default.ReactNode | react__default.RefObject<HTMLElement>)[], aliases?: string[]): react__default.MutableRefObject<string | undefined>;
+
+declare function commandScore(string: string, abbreviation: string, aliases?: string[]): number;
+
 declare const Command: react.ForwardRefExoticComponent<CommandProps & react.RefAttributes<HTMLDivElement>> & {
     Empty: react.ForwardRefExoticComponent<Omit<CommandEmptyProps, "ref"> & react.RefAttributes<HTMLDivElement>>;
     Footer: react.ForwardRefExoticComponent<Omit<react.HTMLProps<HTMLDivElement>, "ref"> & react.RefAttributes<HTMLDivElement>>;
-    Group: react.ForwardRefExoticComponent<Omit<CommandGroupProps, "ref"> & react.RefAttributes<HTMLDivElement>>;
+    Group: react.MemoExoticComponent<react.ForwardRefExoticComponent<Omit<CommandGroupProps, "ref"> & react.RefAttributes<HTMLDivElement>>>;
     Input: react.ForwardRefExoticComponent<Omit<CommandInputProps, "ref"> & react.RefAttributes<HTMLInputElement>>;
-    Item: react.ForwardRefExoticComponent<Omit<CommandItemProps, "ref"> & react.RefAttributes<HTMLDivElement>>;
+    Item: react.MemoExoticComponent<react.ForwardRefExoticComponent<Omit<CommandItemProps, "ref"> & react.RefAttributes<HTMLDivElement>>>;
     List: react.ForwardRefExoticComponent<CommandListProps & react.RefAttributes<HTMLDivElement>>;
     Loading: react.ForwardRefExoticComponent<CommandLoadingProps & react.RefAttributes<HTMLDivElement>>;
     Divider: react.ForwardRefExoticComponent<Omit<CommandDividerProps, "ref"> & react.RefAttributes<HTMLDivElement>>;
@@ -127,4 +188,4 @@ declare const Command: react.ForwardRefExoticComponent<CommandProps & react.RefA
     TabItem: react.MemoExoticComponent<react.ForwardRefExoticComponent<Omit<_choice_ui_tabs.TabItemProps, "ref"> & react.RefAttributes<HTMLElement>>>;
 };
 
-export { Command, Command$1 as CommandRoot, defaultFilter, useCommandState };
+export { Command, type CommandDividerProps, type CommandGroupProps, type CommandInputProps, type CommandItemProps, type CommandListProps, type CommandLoadingProps, type CommandProps, Command$1 as CommandRoot, commandScore, defaultFilter, useCommand, useCommandState, useValue };

package/dist/components/command/src/command.js

@@ -1,7 +1,6 @@
 import { jsxs, jsx } from "react/jsx-runtime";
 import { forwardRef, useId, useRef, useMemo, useCallback } from "react";
 import { useIsomorphicLayoutEffect, useEventCallback } from "usehooks-ts";
-import { commandScore } from "./command-score.js";
 import { commandTv } from "./tv.js";
 import { useAsRef } from "./hooks/use-as-ref.js";
 import { useScheduleLayoutEffect } from "./hooks/use-schedule-layout-effect.js";
@@ -10,6 +9,7 @@ import { findNextSibling, findPreviousSibling } from "./utils/dom.js";
 import { createCommandContext } from "./context/create-command-context.js";
 import { SlottableWithNestedChildren } from "./utils/helpers.js";
 import { StoreContext, CommandContext } from "./context/command-context.js";
+import { commandScore } from "./utils/command-score.js";
 import { useLazyRef } from "../../../shared/hooks/use-lazy-ref/use-lazy-ref.js";
 import { tcx } from "../../../shared/utils/tcx/tcx.js";
 const defaultFilter = (value, search, keywords) => commandScore(value, search, keywords);
@@ -163,7 +163,6 @@ const Command = forwardRef((props, forwardedRef) => {
     store.setState("value", value2 || "");
   }, []);
   const filterItems = useCallback(() => {
-    var _a, _b;
     if (!state.current.search || // Explicitly false, because true | undefined is the default
     propsRef.current.shouldFilter === false) {
       state.current.filtered.count = allItems.current.size;
@@ -172,8 +171,10 @@ const Command = forwardRef((props, forwardedRef) => {
     state.current.filtered.groups = /* @__PURE__ */ new Set();
     let itemCount = 0;
     for (const id of allItems.current) {
-      const value2 = ((_a = ids.current.get(id)) == null ? void 0 : _a.value) ?? "";
-      const keywords = ((_b = ids.current.get(id)) == null ? void 0 : _b.keywords) ?? [];
+      const itemData = ids.current.get(id);
+      if (!itemData) continue;
+      const value2 = itemData.value ?? "";
+      const keywords = itemData.keywords ?? [];
       const rank = score(value2, keywords);
       state.current.filtered.items.set(id, rank);
       if (rank > 0) itemCount++;
@@ -259,7 +260,7 @@ const Command = forwardRef((props, forwardedRef) => {
       variant
     }),
     []
-    // ❌ 空依赖数组，和原始实现一致
+    // Empty deps array, consistent with original cmdk implementation
   );
   const last = () => updateSelectedToIndex(getValidItems().length - 1);
   const next = (e) => {

package/dist/components/command/src/components/command-divider.d.ts

@@ -1,6 +1,9 @@
 import { HTMLProps } from 'react';
 export interface CommandDividerProps extends HTMLProps<HTMLDivElement> {
-    /** 是否始终渲染此分隔符。当禁用自动过滤功能时特别有用。 */
+    /**
+     * Whether to always render this divider. Useful when automatic filtering is disabled.
+     * @default false
+     */
     alwaysRender?: boolean;
 }
 export declare const CommandDivider: import('react').ForwardRefExoticComponent<Omit<CommandDividerProps, "ref"> & import('react').RefAttributes<HTMLDivElement>>;

package/dist/components/command/src/components/command-group.d.ts

@@ -1,7 +1,22 @@
 import { default as React, HTMLProps } from 'react';
 export interface CommandGroupProps extends HTMLProps<HTMLDivElement> {
+    /**
+     * Whether to force mount the group.
+     * @default false
+     */
     forceMount?: boolean;
+    /**
+     * The heading of the group.
+     */
     heading?: React.ReactNode;
+    /**
+     * The value of the group.
+     */
     value?: string;
+    /**
+     * Whether the group is hidden.
+     * @default false
+     */
+    hidden?: boolean;
 }
-export declare const CommandGroup: React.ForwardRefExoticComponent<Omit<CommandGroupProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export declare const CommandGroup: React.MemoExoticComponent<React.ForwardRefExoticComponent<Omit<CommandGroupProps, "ref"> & React.RefAttributes<HTMLDivElement>>>;