@nucleux/command 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nucleux
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,26 @@
+# @nucleux/command
+
+Searchable command palette — Nucleux agentic UI for React.
+
+Part of **[Nucleux](https://github.com/intelligaia-open-labs/nucleux)** — agentic UI components for React. Install a single component, or the full kit via [`@nucleux/react`](https://www.npmjs.com/package/@nucleux/react).
+
+## Install
+
+```bash
+pnpm add @nucleux/command @nucleux/tokens
+```
+
+`react` / `react-dom` are peer dependencies.
+
+## Usage
+
+```tsx
+import { Command } from "@nucleux/command";
+```
+
+Requires the theme once in your app: `import "@nucleux/tokens/styles.css";`
+and the Tailwind preset from `@nucleux/tokens/preset`.
+
+## License
+
+MIT © Nucleux

package/dist/index.cjs

@@ -0,0 +1,219 @@
+"use client";
+'use strict';
+
+var React = require('react');
+var lucideReact = require('lucide-react');
+var utils = require('@nucleux/utils');
+var jsxRuntime = require('react/jsx-runtime');
+
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+var React__namespace = /*#__PURE__*/_interopNamespace(React);
+
+// src/index.tsx
+var CommandContext = React__namespace.createContext(null);
+var useCommand = (component) => {
+  const ctx = React__namespace.useContext(CommandContext);
+  if (!ctx) throw new Error(`${component} must be used within a Command`);
+  return ctx;
+};
+var matches = (text, search) => text.toLowerCase().includes(search.trim().toLowerCase());
+var Command = React__namespace.forwardRef(
+  ({ className, children, ...props }, ref) => {
+    const [search, setSearch] = React__namespace.useState("");
+    const [activeValue, setActiveValue] = React__namespace.useState(null);
+    const [, setEmpty] = React__namespace.useState(false);
+    const listRef = React__namespace.useRef(null);
+    const reportEmpty = React__namespace.useCallback((e) => setEmpty(e), []);
+    return /* @__PURE__ */ jsxRuntime.jsx(
+      "div",
+      {
+        ref,
+        className: utils.cn(
+          "flex w-full flex-col overflow-hidden rounded-lg border border-border bg-background text-foreground shadow-md",
+          className
+        ),
+        ...props,
+        children: /* @__PURE__ */ jsxRuntime.jsx(
+          CommandContext.Provider,
+          {
+            value: { search, setSearch, activeValue, setActiveValue, listRef, reportEmpty },
+            children
+          }
+        )
+      }
+    );
+  }
+);
+Command.displayName = "Command";
+var CommandInput = React__namespace.forwardRef(
+  ({ className, placeholder = "Type a command or search\u2026", ...props }, ref) => {
+    const { search, setSearch, listRef, activeValue, setActiveValue } = useCommand("CommandInput");
+    const visibleItems = () => Array.from(listRef.current?.querySelectorAll("[data-command-item]") ?? []);
+    const handleKeyDown = (e) => {
+      const items = visibleItems();
+      if (items.length === 0) return;
+      const values = items.map((el) => el.dataset.value ?? "");
+      const idx = values.indexOf(activeValue ?? "");
+      if (e.key === "ArrowDown") {
+        e.preventDefault();
+        setActiveValue(values[(idx + 1) % values.length] ?? null);
+      } else if (e.key === "ArrowUp") {
+        e.preventDefault();
+        setActiveValue(values[(idx - 1 + values.length) % values.length] ?? null);
+      } else if (e.key === "Home") {
+        e.preventDefault();
+        setActiveValue(values[0] ?? null);
+      } else if (e.key === "End") {
+        e.preventDefault();
+        setActiveValue(values[values.length - 1] ?? null);
+      } else if (e.key === "Enter") {
+        e.preventDefault();
+        const el = items.find((i) => i.dataset.value === activeValue) ?? items[0];
+        el?.click();
+      }
+    };
+    return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-center gap-2 border-b border-border px-3", children: [
+      /* @__PURE__ */ jsxRuntime.jsx(lucideReact.Search, { "aria-hidden": true, className: "h-4 w-4 shrink-0 text-muted-foreground" }),
+      /* @__PURE__ */ jsxRuntime.jsx(
+        "input",
+        {
+          ref,
+          type: "text",
+          role: "combobox",
+          "aria-expanded": "true",
+          "aria-controls": "command-list",
+          value: search,
+          placeholder,
+          onChange: (e) => {
+            setSearch(e.target.value);
+            setActiveValue(null);
+          },
+          onKeyDown: handleKeyDown,
+          className: utils.cn(
+            "flex h-11 w-full bg-transparent py-3 text-sm outline-none placeholder:text-muted-foreground",
+            className
+          ),
+          ...props
+        }
+      )
+    ] });
+  }
+);
+CommandInput.displayName = "CommandInput";
+var CommandList = React__namespace.forwardRef(
+  ({ className, children, ...props }, ref) => {
+    const { listRef, search, reportEmpty, activeValue, setActiveValue } = useCommand("CommandList");
+    const setRefs = (node) => {
+      listRef.current = node;
+      if (typeof ref === "function") ref(node);
+      else if (ref) ref.current = node;
+    };
+    React__namespace.useEffect(() => {
+      const items = Array.from(
+        listRef.current?.querySelectorAll("[data-command-item]") ?? []
+      );
+      reportEmpty(items.length === 0);
+      const values = items.map((el) => el.dataset.value ?? "");
+      if (values.length && !values.includes(activeValue ?? "")) setActiveValue(values[0] ?? null);
+    }, [search, listRef, reportEmpty, activeValue, setActiveValue]);
+    return /* @__PURE__ */ jsxRuntime.jsx(
+      "div",
+      {
+        ref: setRefs,
+        id: "command-list",
+        role: "listbox",
+        className: utils.cn("max-h-72 overflow-y-auto overflow-x-hidden p-1", className),
+        ...props,
+        children
+      }
+    );
+  }
+);
+CommandList.displayName = "CommandList";
+var CommandGroup = React__namespace.forwardRef(
+  ({ className, heading, children, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsxs("div", { ref, role: "group", className: utils.cn("overflow-hidden py-1", className), ...props, children: [
+    heading && /* @__PURE__ */ jsxRuntime.jsx("div", { className: "px-2 py-1.5 text-xs font-medium text-muted-foreground", children: heading }),
+    children
+  ] })
+);
+CommandGroup.displayName = "CommandGroup";
+var CommandItem = React__namespace.forwardRef(
+  ({ className, value, disabled = false, onSelect, onClick, children, ...props }, ref) => {
+    const { search, activeValue, setActiveValue } = useCommand("CommandItem");
+    if (search && !matches(value, search)) return null;
+    const active = activeValue === value;
+    return /* @__PURE__ */ jsxRuntime.jsx(
+      "div",
+      {
+        ref,
+        "data-command-item": "",
+        "data-value": value,
+        role: "option",
+        "aria-selected": active,
+        "aria-disabled": disabled || void 0,
+        onMouseMove: () => !disabled && setActiveValue(value),
+        onClick: (e) => {
+          onClick?.(e);
+          if (!disabled && !e.defaultPrevented) onSelect?.(value);
+        },
+        className: utils.cn(
+          "flex cursor-pointer items-center gap-2 rounded-sm px-2 py-1.5 text-sm outline-none",
+          active && "bg-accent text-accent-foreground",
+          disabled && "pointer-events-none opacity-50",
+          className
+        ),
+        ...props,
+        children
+      }
+    );
+  }
+);
+CommandItem.displayName = "CommandItem";
+var CommandEmpty = React__namespace.forwardRef(
+  ({ className, children = "No results found.", ...props }, ref) => {
+    const { listRef, search } = useCommand("CommandEmpty");
+    const [empty, setEmpty] = React__namespace.useState(false);
+    React__namespace.useEffect(() => {
+      const count = listRef.current?.querySelectorAll("[data-command-item]").length ?? 0;
+      setEmpty(count === 0);
+    }, [search, listRef]);
+    if (!empty) return null;
+    return /* @__PURE__ */ jsxRuntime.jsx(
+      "div",
+      {
+        ref,
+        role: "presentation",
+        className: utils.cn("py-6 text-center text-sm text-muted-foreground", className),
+        ...props,
+        children
+      }
+    );
+  }
+);
+CommandEmpty.displayName = "CommandEmpty";
+
+exports.Command = Command;
+exports.CommandEmpty = CommandEmpty;
+exports.CommandGroup = CommandGroup;
+exports.CommandInput = CommandInput;
+exports.CommandItem = CommandItem;
+exports.CommandList = CommandList;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.tsx"],"names":["React","jsx","cn","jsxs","Search"],"mappings":"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","file":"index.cjs","sourcesContent":["import * as React from \"react\";\nimport { Search } from \"lucide-react\";\nimport { cn } from \"@nucleux/utils\";\n\ninterface CommandContextValue {\n  search: string;\n  setSearch: (v: string) => void;\n  activeValue: string | null;\n  setActiveValue: (v: string | null) => void;\n  listRef: React.RefObject<HTMLDivElement>;\n  reportEmpty: (empty: boolean) => void;\n}\n\nconst CommandContext = React.createContext<CommandContextValue | null>(null);\nconst useCommand = (component: string) => {\n  const ctx = React.useContext(CommandContext);\n  if (!ctx) throw new Error(`${component} must be used within a Command`);\n  return ctx;\n};\n\nconst matches = (text: string, search: string) =>\n  text.toLowerCase().includes(search.trim().toLowerCase());\n\nexport type CommandProps = React.HTMLAttributes<HTMLDivElement>;\n\n/**\n * A composable command palette: a filterable, keyboard-navigable list of\n * actions. Compose with CommandInput, CommandList, CommandGroup, CommandItem,\n * and CommandEmpty.\n */\nexport const Command = React.forwardRef<HTMLDivElement, CommandProps>(\n  ({ className, children, ...props }, ref) => {\n    const [search, setSearch] = React.useState(\"\");\n    const [activeValue, setActiveValue] = React.useState<string | null>(null);\n    const [, setEmpty] = React.useState(false);\n    const listRef = React.useRef<HTMLDivElement>(null);\n\n    const reportEmpty = React.useCallback((e: boolean) => setEmpty(e), []);\n\n    return (\n      <div\n        ref={ref}\n        className={cn(\n          \"flex w-full flex-col overflow-hidden rounded-lg border border-border bg-background text-foreground shadow-md\",\n          className,\n        )}\n        {...props}\n      >\n        <CommandContext.Provider\n          value={{ search, setSearch, activeValue, setActiveValue, listRef, reportEmpty }}\n        >\n          {children}\n        </CommandContext.Provider>\n      </div>\n    );\n  },\n);\nCommand.displayName = \"Command\";\n\nexport type CommandInputProps = Omit<\n  React.InputHTMLAttributes<HTMLInputElement>,\n  \"value\" | \"onChange\"\n>;\n\n/** The search field that filters the command list. */\nexport const CommandInput = React.forwardRef<HTMLInputElement, CommandInputProps>(\n  ({ className, placeholder = \"Type a command or search…\", ...props }, ref) => {\n    const { search, setSearch, listRef, activeValue, setActiveValue } = useCommand(\"CommandInput\");\n\n    const visibleItems = () =>\n      Array.from(listRef.current?.querySelectorAll<HTMLElement>(\"[data-command-item]\") ?? []);\n\n    const handleKeyDown = (e: React.KeyboardEvent<HTMLInputElement>) => {\n      const items = visibleItems();\n      if (items.length === 0) return;\n      const values = items.map((el) => el.dataset.value ?? \"\");\n      const idx = values.indexOf(activeValue ?? \"\");\n      if (e.key === \"ArrowDown\") {\n        e.preventDefault();\n        setActiveValue(values[(idx + 1) % values.length] ?? null);\n      } else if (e.key === \"ArrowUp\") {\n        e.preventDefault();\n        setActiveValue(values[(idx - 1 + values.length) % values.length] ?? null);\n      } else if (e.key === \"Home\") {\n        e.preventDefault();\n        setActiveValue(values[0] ?? null);\n      } else if (e.key === \"End\") {\n        e.preventDefault();\n        setActiveValue(values[values.length - 1] ?? null);\n      } else if (e.key === \"Enter\") {\n        e.preventDefault();\n        const el = items.find((i) => i.dataset.value === activeValue) ?? items[0];\n        el?.click();\n      }\n    };\n\n    return (\n      <div className=\"flex items-center gap-2 border-b border-border px-3\">\n        <Search aria-hidden className=\"h-4 w-4 shrink-0 text-muted-foreground\" />\n        <input\n          ref={ref}\n          type=\"text\"\n          role=\"combobox\"\n          aria-expanded=\"true\"\n          aria-controls=\"command-list\"\n          value={search}\n          placeholder={placeholder}\n          onChange={(e) => {\n            setSearch(e.target.value);\n            setActiveValue(null);\n          }}\n          onKeyDown={handleKeyDown}\n          className={cn(\n            \"flex h-11 w-full bg-transparent py-3 text-sm outline-none placeholder:text-muted-foreground\",\n            className,\n          )}\n          {...props}\n        />\n      </div>\n    );\n  },\n);\nCommandInput.displayName = \"CommandInput\";\n\nexport type CommandListProps = React.HTMLAttributes<HTMLDivElement>;\n\n/** Scrollable container for command groups and items. */\nexport const CommandList = React.forwardRef<HTMLDivElement, CommandListProps>(\n  ({ className, children, ...props }, ref) => {\n    const { listRef, search, reportEmpty, activeValue, setActiveValue } = useCommand(\"CommandList\");\n    const setRefs = (node: HTMLDivElement | null) => {\n      (listRef as React.MutableRefObject<HTMLDivElement | null>).current = node;\n      if (typeof ref === \"function\") ref(node);\n      else if (ref) (ref as React.MutableRefObject<HTMLDivElement | null>).current = node;\n    };\n\n    // After each search change, recount visible items and keep an active item.\n    React.useEffect(() => {\n      const items = Array.from(\n        listRef.current?.querySelectorAll<HTMLElement>(\"[data-command-item]\") ?? [],\n      );\n      reportEmpty(items.length === 0);\n      const values = items.map((el) => el.dataset.value ?? \"\");\n      if (values.length && !values.includes(activeValue ?? \"\")) setActiveValue(values[0] ?? null);\n    }, [search, listRef, reportEmpty, activeValue, setActiveValue]);\n\n    return (\n      <div\n        ref={setRefs}\n        id=\"command-list\"\n        role=\"listbox\"\n        className={cn(\"max-h-72 overflow-y-auto overflow-x-hidden p-1\", className)}\n        {...props}\n      >\n        {children}\n      </div>\n    );\n  },\n);\nCommandList.displayName = \"CommandList\";\n\nexport interface CommandGroupProps extends React.HTMLAttributes<HTMLDivElement> {\n  heading?: React.ReactNode;\n}\n\n/** A labelled group of {@link CommandItem}s. */\nexport const CommandGroup = React.forwardRef<HTMLDivElement, CommandGroupProps>(\n  ({ className, heading, children, ...props }, ref) => (\n    <div ref={ref} role=\"group\" className={cn(\"overflow-hidden py-1\", className)} {...props}>\n      {heading && (\n        <div className=\"px-2 py-1.5 text-xs font-medium text-muted-foreground\">{heading}</div>\n      )}\n      {children}\n    </div>\n  ),\n);\nCommandGroup.displayName = \"CommandGroup\";\n\nexport interface CommandItemProps\n  extends Omit<React.HTMLAttributes<HTMLDivElement>, \"onSelect\"> {\n  /** The value used for filtering + selection. Defaults to the text content. */\n  value: string;\n  disabled?: boolean;\n  onSelect?: (value: string) => void;\n}\n\n/** A selectable command. Hidden automatically when it doesn't match the search. */\nexport const CommandItem = React.forwardRef<HTMLDivElement, CommandItemProps>(\n  ({ className, value, disabled = false, onSelect, onClick, children, ...props }, ref) => {\n    const { search, activeValue, setActiveValue } = useCommand(\"CommandItem\");\n    if (search && !matches(value, search)) return null;\n    const active = activeValue === value;\n\n    return (\n      <div\n        ref={ref}\n        data-command-item=\"\"\n        data-value={value}\n        role=\"option\"\n        aria-selected={active}\n        aria-disabled={disabled || undefined}\n        onMouseMove={() => !disabled && setActiveValue(value)}\n        onClick={(e) => {\n          onClick?.(e);\n          if (!disabled && !e.defaultPrevented) onSelect?.(value);\n        }}\n        className={cn(\n          \"flex cursor-pointer items-center gap-2 rounded-sm px-2 py-1.5 text-sm outline-none\",\n          active && \"bg-accent text-accent-foreground\",\n          disabled && \"pointer-events-none opacity-50\",\n          className,\n        )}\n        {...props}\n      >\n        {children}\n      </div>\n    );\n  },\n);\nCommandItem.displayName = \"CommandItem\";\n\nexport type CommandEmptyProps = React.HTMLAttributes<HTMLDivElement>;\n\n/** Shown when no items match the current search. */\nexport const CommandEmpty = React.forwardRef<HTMLDivElement, CommandEmptyProps>(\n  ({ className, children = \"No results found.\", ...props }, ref) => {\n    const { listRef, search } = useCommand(\"CommandEmpty\");\n    const [empty, setEmpty] = React.useState(false);\n\n    React.useEffect(() => {\n      const count =\n        listRef.current?.querySelectorAll(\"[data-command-item]\").length ?? 0;\n      setEmpty(count === 0);\n    }, [search, listRef]);\n\n    if (!empty) return null;\n    return (\n      <div\n        ref={ref}\n        role=\"presentation\"\n        className={cn(\"py-6 text-center text-sm text-muted-foreground\", className)}\n        {...props}\n      >\n        {children}\n      </div>\n    );\n  },\n);\nCommandEmpty.displayName = \"CommandEmpty\";\n"]}

package/dist/index.d.cts

@@ -0,0 +1,33 @@
+import * as React from 'react';
+
+type CommandProps = React.HTMLAttributes<HTMLDivElement>;
+/**
+ * A composable command palette: a filterable, keyboard-navigable list of
+ * actions. Compose with CommandInput, CommandList, CommandGroup, CommandItem,
+ * and CommandEmpty.
+ */
+declare const Command: React.ForwardRefExoticComponent<CommandProps & React.RefAttributes<HTMLDivElement>>;
+type CommandInputProps = Omit<React.InputHTMLAttributes<HTMLInputElement>, "value" | "onChange">;
+/** The search field that filters the command list. */
+declare const CommandInput: React.ForwardRefExoticComponent<CommandInputProps & React.RefAttributes<HTMLInputElement>>;
+type CommandListProps = React.HTMLAttributes<HTMLDivElement>;
+/** Scrollable container for command groups and items. */
+declare const CommandList: React.ForwardRefExoticComponent<CommandListProps & React.RefAttributes<HTMLDivElement>>;
+interface CommandGroupProps extends React.HTMLAttributes<HTMLDivElement> {
+    heading?: React.ReactNode;
+}
+/** A labelled group of {@link CommandItem}s. */
+declare const CommandGroup: React.ForwardRefExoticComponent<CommandGroupProps & React.RefAttributes<HTMLDivElement>>;
+interface CommandItemProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onSelect"> {
+    /** The value used for filtering + selection. Defaults to the text content. */
+    value: string;
+    disabled?: boolean;
+    onSelect?: (value: string) => void;
+}
+/** A selectable command. Hidden automatically when it doesn't match the search. */
+declare const CommandItem: React.ForwardRefExoticComponent<CommandItemProps & React.RefAttributes<HTMLDivElement>>;
+type CommandEmptyProps = React.HTMLAttributes<HTMLDivElement>;
+/** Shown when no items match the current search. */
+declare const CommandEmpty: React.ForwardRefExoticComponent<CommandEmptyProps & React.RefAttributes<HTMLDivElement>>;
+
+export { Command, CommandEmpty, type CommandEmptyProps, CommandGroup, type CommandGroupProps, CommandInput, type CommandInputProps, CommandItem, type CommandItemProps, CommandList, type CommandListProps, type CommandProps };

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+import * as React from 'react';
+
+type CommandProps = React.HTMLAttributes<HTMLDivElement>;
+/**
+ * A composable command palette: a filterable, keyboard-navigable list of
+ * actions. Compose with CommandInput, CommandList, CommandGroup, CommandItem,
+ * and CommandEmpty.
+ */
+declare const Command: React.ForwardRefExoticComponent<CommandProps & React.RefAttributes<HTMLDivElement>>;
+type CommandInputProps = Omit<React.InputHTMLAttributes<HTMLInputElement>, "value" | "onChange">;
+/** The search field that filters the command list. */
+declare const CommandInput: React.ForwardRefExoticComponent<CommandInputProps & React.RefAttributes<HTMLInputElement>>;
+type CommandListProps = React.HTMLAttributes<HTMLDivElement>;
+/** Scrollable container for command groups and items. */
+declare const CommandList: React.ForwardRefExoticComponent<CommandListProps & React.RefAttributes<HTMLDivElement>>;
+interface CommandGroupProps extends React.HTMLAttributes<HTMLDivElement> {
+    heading?: React.ReactNode;
+}
+/** A labelled group of {@link CommandItem}s. */
+declare const CommandGroup: React.ForwardRefExoticComponent<CommandGroupProps & React.RefAttributes<HTMLDivElement>>;
+interface CommandItemProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onSelect"> {
+    /** The value used for filtering + selection. Defaults to the text content. */
+    value: string;
+    disabled?: boolean;
+    onSelect?: (value: string) => void;
+}
+/** A selectable command. Hidden automatically when it doesn't match the search. */
+declare const CommandItem: React.ForwardRefExoticComponent<CommandItemProps & React.RefAttributes<HTMLDivElement>>;
+type CommandEmptyProps = React.HTMLAttributes<HTMLDivElement>;
+/** Shown when no items match the current search. */
+declare const CommandEmpty: React.ForwardRefExoticComponent<CommandEmptyProps & React.RefAttributes<HTMLDivElement>>;
+
+export { Command, CommandEmpty, type CommandEmptyProps, CommandGroup, type CommandGroupProps, CommandInput, type CommandInputProps, CommandItem, type CommandItemProps, CommandList, type CommandListProps, type CommandProps };

package/dist/index.js

@@ -0,0 +1,192 @@
+"use client";
+import * as React from 'react';
+import { Search } from 'lucide-react';
+import { cn } from '@nucleux/utils';
+import { jsx, jsxs } from 'react/jsx-runtime';
+
+// src/index.tsx
+var CommandContext = React.createContext(null);
+var useCommand = (component) => {
+  const ctx = React.useContext(CommandContext);
+  if (!ctx) throw new Error(`${component} must be used within a Command`);
+  return ctx;
+};
+var matches = (text, search) => text.toLowerCase().includes(search.trim().toLowerCase());
+var Command = React.forwardRef(
+  ({ className, children, ...props }, ref) => {
+    const [search, setSearch] = React.useState("");
+    const [activeValue, setActiveValue] = React.useState(null);
+    const [, setEmpty] = React.useState(false);
+    const listRef = React.useRef(null);
+    const reportEmpty = React.useCallback((e) => setEmpty(e), []);
+    return /* @__PURE__ */ jsx(
+      "div",
+      {
+        ref,
+        className: cn(
+          "flex w-full flex-col overflow-hidden rounded-lg border border-border bg-background text-foreground shadow-md",
+          className
+        ),
+        ...props,
+        children: /* @__PURE__ */ jsx(
+          CommandContext.Provider,
+          {
+            value: { search, setSearch, activeValue, setActiveValue, listRef, reportEmpty },
+            children
+          }
+        )
+      }
+    );
+  }
+);
+Command.displayName = "Command";
+var CommandInput = React.forwardRef(
+  ({ className, placeholder = "Type a command or search\u2026", ...props }, ref) => {
+    const { search, setSearch, listRef, activeValue, setActiveValue } = useCommand("CommandInput");
+    const visibleItems = () => Array.from(listRef.current?.querySelectorAll("[data-command-item]") ?? []);
+    const handleKeyDown = (e) => {
+      const items = visibleItems();
+      if (items.length === 0) return;
+      const values = items.map((el) => el.dataset.value ?? "");
+      const idx = values.indexOf(activeValue ?? "");
+      if (e.key === "ArrowDown") {
+        e.preventDefault();
+        setActiveValue(values[(idx + 1) % values.length] ?? null);
+      } else if (e.key === "ArrowUp") {
+        e.preventDefault();
+        setActiveValue(values[(idx - 1 + values.length) % values.length] ?? null);
+      } else if (e.key === "Home") {
+        e.preventDefault();
+        setActiveValue(values[0] ?? null);
+      } else if (e.key === "End") {
+        e.preventDefault();
+        setActiveValue(values[values.length - 1] ?? null);
+      } else if (e.key === "Enter") {
+        e.preventDefault();
+        const el = items.find((i) => i.dataset.value === activeValue) ?? items[0];
+        el?.click();
+      }
+    };
+    return /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-2 border-b border-border px-3", children: [
+      /* @__PURE__ */ jsx(Search, { "aria-hidden": true, className: "h-4 w-4 shrink-0 text-muted-foreground" }),
+      /* @__PURE__ */ jsx(
+        "input",
+        {
+          ref,
+          type: "text",
+          role: "combobox",
+          "aria-expanded": "true",
+          "aria-controls": "command-list",
+          value: search,
+          placeholder,
+          onChange: (e) => {
+            setSearch(e.target.value);
+            setActiveValue(null);
+          },
+          onKeyDown: handleKeyDown,
+          className: cn(
+            "flex h-11 w-full bg-transparent py-3 text-sm outline-none placeholder:text-muted-foreground",
+            className
+          ),
+          ...props
+        }
+      )
+    ] });
+  }
+);
+CommandInput.displayName = "CommandInput";
+var CommandList = React.forwardRef(
+  ({ className, children, ...props }, ref) => {
+    const { listRef, search, reportEmpty, activeValue, setActiveValue } = useCommand("CommandList");
+    const setRefs = (node) => {
+      listRef.current = node;
+      if (typeof ref === "function") ref(node);
+      else if (ref) ref.current = node;
+    };
+    React.useEffect(() => {
+      const items = Array.from(
+        listRef.current?.querySelectorAll("[data-command-item]") ?? []
+      );
+      reportEmpty(items.length === 0);
+      const values = items.map((el) => el.dataset.value ?? "");
+      if (values.length && !values.includes(activeValue ?? "")) setActiveValue(values[0] ?? null);
+    }, [search, listRef, reportEmpty, activeValue, setActiveValue]);
+    return /* @__PURE__ */ jsx(
+      "div",
+      {
+        ref: setRefs,
+        id: "command-list",
+        role: "listbox",
+        className: cn("max-h-72 overflow-y-auto overflow-x-hidden p-1", className),
+        ...props,
+        children
+      }
+    );
+  }
+);
+CommandList.displayName = "CommandList";
+var CommandGroup = React.forwardRef(
+  ({ className, heading, children, ...props }, ref) => /* @__PURE__ */ jsxs("div", { ref, role: "group", className: cn("overflow-hidden py-1", className), ...props, children: [
+    heading && /* @__PURE__ */ jsx("div", { className: "px-2 py-1.5 text-xs font-medium text-muted-foreground", children: heading }),
+    children
+  ] })
+);
+CommandGroup.displayName = "CommandGroup";
+var CommandItem = React.forwardRef(
+  ({ className, value, disabled = false, onSelect, onClick, children, ...props }, ref) => {
+    const { search, activeValue, setActiveValue } = useCommand("CommandItem");
+    if (search && !matches(value, search)) return null;
+    const active = activeValue === value;
+    return /* @__PURE__ */ jsx(
+      "div",
+      {
+        ref,
+        "data-command-item": "",
+        "data-value": value,
+        role: "option",
+        "aria-selected": active,
+        "aria-disabled": disabled || void 0,
+        onMouseMove: () => !disabled && setActiveValue(value),
+        onClick: (e) => {
+          onClick?.(e);
+          if (!disabled && !e.defaultPrevented) onSelect?.(value);
+        },
+        className: cn(
+          "flex cursor-pointer items-center gap-2 rounded-sm px-2 py-1.5 text-sm outline-none",
+          active && "bg-accent text-accent-foreground",
+          disabled && "pointer-events-none opacity-50",
+          className
+        ),
+        ...props,
+        children
+      }
+    );
+  }
+);
+CommandItem.displayName = "CommandItem";
+var CommandEmpty = React.forwardRef(
+  ({ className, children = "No results found.", ...props }, ref) => {
+    const { listRef, search } = useCommand("CommandEmpty");
+    const [empty, setEmpty] = React.useState(false);
+    React.useEffect(() => {
+      const count = listRef.current?.querySelectorAll("[data-command-item]").length ?? 0;
+      setEmpty(count === 0);
+    }, [search, listRef]);
+    if (!empty) return null;
+    return /* @__PURE__ */ jsx(
+      "div",
+      {
+        ref,
+        role: "presentation",
+        className: cn("py-6 text-center text-sm text-muted-foreground", className),
+        ...props,
+        children
+      }
+    );
+  }
+);
+CommandEmpty.displayName = "CommandEmpty";
+
+export { Command, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.tsx"],"names":[],"mappings":";;;;;;AAaA,IAAM,cAAA,GAAuB,oBAA0C,IAAI,CAAA;AAC3E,IAAM,UAAA,GAAa,CAAC,SAAA,KAAsB;AACxC,EAAA,MAAM,GAAA,GAAY,iBAAW,cAAc,CAAA;AAC3C,EAAA,IAAI,CAAC,GAAA,EAAK,MAAM,IAAI,KAAA,CAAM,CAAA,EAAG,SAAS,CAAA,8BAAA,CAAgC,CAAA;AACtE,EAAA,OAAO,GAAA;AACT,CAAA;AAEA,IAAM,OAAA,GAAU,CAAC,IAAA,EAAc,MAAA,KAC7B,IAAA,CAAK,WAAA,EAAY,CAAE,QAAA,CAAS,MAAA,CAAO,IAAA,EAAK,CAAE,WAAA,EAAa,CAAA;AASlD,IAAM,OAAA,GAAgB,KAAA,CAAA,UAAA;AAAA,EAC3B,CAAC,EAAE,SAAA,EAAW,UAAU,GAAG,KAAA,IAAS,GAAA,KAAQ;AAC1C,IAAA,MAAM,CAAC,MAAA,EAAQ,SAAS,CAAA,GAAU,eAAS,EAAE,CAAA;AAC7C,IAAA,MAAM,CAAC,WAAA,EAAa,cAAc,CAAA,GAAU,eAAwB,IAAI,CAAA;AACxE,IAAA,MAAM,GAAG,QAAQ,CAAA,GAAU,eAAS,KAAK,CAAA;AACzC,IAAA,MAAM,OAAA,GAAgB,aAAuB,IAAI,CAAA;AAEjD,IAAA,MAAM,WAAA,GAAoB,kBAAY,CAAC,CAAA,KAAe,SAAS,CAAC,CAAA,EAAG,EAAE,CAAA;AAErE,IAAA,uBACE,GAAA;AAAA,MAAC,KAAA;AAAA,MAAA;AAAA,QACC,GAAA;AAAA,QACA,SAAA,EAAW,EAAA;AAAA,UACT,8GAAA;AAAA,UACA;AAAA,SACF;AAAA,QACC,GAAG,KAAA;AAAA,QAEJ,QAAA,kBAAA,GAAA;AAAA,UAAC,cAAA,CAAe,QAAA;AAAA,UAAf;AAAA,YACC,OAAO,EAAE,MAAA,EAAQ,WAAW,WAAA,EAAa,cAAA,EAAgB,SAAS,WAAA,EAAY;AAAA,YAE7E;AAAA;AAAA;AACH;AAAA,KACF;AAAA,EAEJ;AACF;AACA,OAAA,CAAQ,WAAA,GAAc,SAAA;AAQf,IAAM,YAAA,GAAqB,KAAA,CAAA,UAAA;AAAA,EAChC,CAAC,EAAE,SAAA,EAAW,WAAA,GAAc,kCAA6B,GAAG,KAAA,IAAS,GAAA,KAAQ;AAC3E,IAAA,MAAM,EAAE,QAAQ,SAAA,EAAW,OAAA,EAAS,aAAa,cAAA,EAAe,GAAI,WAAW,cAAc,CAAA;AAE7F,IAAA,MAAM,YAAA,GAAe,MACnB,KAAA,CAAM,IAAA,CAAK,OAAA,CAAQ,SAAS,gBAAA,CAA8B,qBAAqB,CAAA,IAAK,EAAE,CAAA;AAExF,IAAA,MAAM,aAAA,GAAgB,CAAC,CAAA,KAA6C;AAClE,MAAA,MAAM,QAAQ,YAAA,EAAa;AAC3B,MAAA,IAAI,KAAA,CAAM,WAAW,CAAA,EAAG;AACxB,MAAA,MAAM,MAAA,GAAS,MAAM,GAAA,CAAI,CAAC,OAAO,EAAA,CAAG,OAAA,CAAQ,SAAS,EAAE,CAAA;AACvD,MAAA,MAAM,GAAA,GAAM,MAAA,CAAO,OAAA,CAAQ,WAAA,IAAe,EAAE,CAAA;AAC5C,MAAA,IAAI,CAAA,CAAE,QAAQ,WAAA,EAAa;AACzB,QAAA,CAAA,CAAE,cAAA,EAAe;AACjB,QAAA,cAAA,CAAe,QAAQ,GAAA,GAAM,CAAA,IAAK,MAAA,CAAO,MAAM,KAAK,IAAI,CAAA;AAAA,MAC1D,CAAA,MAAA,IAAW,CAAA,CAAE,GAAA,KAAQ,SAAA,EAAW;AAC9B,QAAA,CAAA,CAAE,cAAA,EAAe;AACjB,QAAA,cAAA,CAAe,MAAA,CAAA,CAAQ,MAAM,CAAA,GAAI,MAAA,CAAO,UAAU,MAAA,CAAO,MAAM,KAAK,IAAI,CAAA;AAAA,MAC1E,CAAA,MAAA,IAAW,CAAA,CAAE,GAAA,KAAQ,MAAA,EAAQ;AAC3B,QAAA,CAAA,CAAE,cAAA,EAAe;AACjB,QAAA,cAAA,CAAe,MAAA,CAAO,CAAC,CAAA,IAAK,IAAI,CAAA;AAAA,MAClC,CAAA,MAAA,IAAW,CAAA,CAAE,GAAA,KAAQ,KAAA,EAAO;AAC1B,QAAA,CAAA,CAAE,cAAA,EAAe;AACjB,QAAA,cAAA,CAAe,MAAA,CAAO,MAAA,CAAO,MAAA,GAAS,CAAC,KAAK,IAAI,CAAA;AAAA,MAClD,CAAA,MAAA,IAAW,CAAA,CAAE,GAAA,KAAQ,OAAA,EAAS;AAC5B,QAAA,CAAA,CAAE,cAAA,EAAe;AACjB,QAAA,MAAM,EAAA,GAAK,KAAA,CAAM,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,OAAA,CAAQ,KAAA,KAAU,WAAW,CAAA,IAAK,KAAA,CAAM,CAAC,CAAA;AACxE,QAAA,EAAA,EAAI,KAAA,EAAM;AAAA,MACZ;AAAA,IACF,CAAA;AAEA,IAAA,uBACE,IAAA,CAAC,KAAA,EAAA,EAAI,SAAA,EAAU,qDAAA,EACb,QAAA,EAAA;AAAA,sBAAA,GAAA,CAAC,MAAA,EAAA,EAAO,aAAA,EAAW,IAAA,EAAC,SAAA,EAAU,wCAAA,EAAyC,CAAA;AAAA,sBACvE,GAAA;AAAA,QAAC,OAAA;AAAA,QAAA;AAAA,UACC,GAAA;AAAA,UACA,IAAA,EAAK,MAAA;AAAA,UACL,IAAA,EAAK,UAAA;AAAA,UACL,eAAA,EAAc,MAAA;AAAA,UACd,eAAA,EAAc,cAAA;AAAA,UACd,KAAA,EAAO,MAAA;AAAA,UACP,WAAA;AAAA,UACA,QAAA,EAAU,CAAC,CAAA,KAAM;AACf,YAAA,SAAA,CAAU,CAAA,CAAE,OAAO,KAAK,CAAA;AACxB,YAAA,cAAA,CAAe,IAAI,CAAA;AAAA,UACrB,CAAA;AAAA,UACA,SAAA,EAAW,aAAA;AAAA,UACX,SAAA,EAAW,EAAA;AAAA,YACT,6FAAA;AAAA,YACA;AAAA,WACF;AAAA,UACC,GAAG;AAAA;AAAA;AACN,KAAA,EACF,CAAA;AAAA,EAEJ;AACF;AACA,YAAA,CAAa,WAAA,GAAc,cAAA;AAKpB,IAAM,WAAA,GAAoB,KAAA,CAAA,UAAA;AAAA,EAC/B,CAAC,EAAE,SAAA,EAAW,UAAU,GAAG,KAAA,IAAS,GAAA,KAAQ;AAC1C,IAAA,MAAM,EAAE,SAAS,MAAA,EAAQ,WAAA,EAAa,aAAa,cAAA,EAAe,GAAI,WAAW,aAAa,CAAA;AAC9F,IAAA,MAAM,OAAA,GAAU,CAAC,IAAA,KAAgC;AAC/C,MAAC,QAA0D,OAAA,GAAU,IAAA;AACrE,MAAA,IAAI,OAAO,GAAA,KAAQ,UAAA,EAAY,GAAA,CAAI,IAAI,CAAA;AAAA,WAAA,IAC9B,GAAA,EAAM,GAAA,CAAsD,OAAA,GAAU,IAAA;AAAA,IACjF,CAAA;AAGA,IAAM,gBAAU,MAAM;AACpB,MAAA,MAAM,QAAQ,KAAA,CAAM,IAAA;AAAA,QAClB,OAAA,CAAQ,OAAA,EAAS,gBAAA,CAA8B,qBAAqB,KAAK;AAAC,OAC5E;AACA,MAAA,WAAA,CAAY,KAAA,CAAM,WAAW,CAAC,CAAA;AAC9B,MAAA,MAAM,MAAA,GAAS,MAAM,GAAA,CAAI,CAAC,OAAO,EAAA,CAAG,OAAA,CAAQ,SAAS,EAAE,CAAA;AACvD,MAAA,IAAI,MAAA,CAAO,MAAA,IAAU,CAAC,MAAA,CAAO,QAAA,CAAS,WAAA,IAAe,EAAE,CAAA,EAAG,cAAA,CAAe,MAAA,CAAO,CAAC,CAAA,IAAK,IAAI,CAAA;AAAA,IAC5F,GAAG,CAAC,MAAA,EAAQ,SAAS,WAAA,EAAa,WAAA,EAAa,cAAc,CAAC,CAAA;AAE9D,IAAA,uBACE,GAAA;AAAA,MAAC,KAAA;AAAA,MAAA;AAAA,QACC,GAAA,EAAK,OAAA;AAAA,QACL,EAAA,EAAG,cAAA;AAAA,QACH,IAAA,EAAK,SAAA;AAAA,QACL,SAAA,EAAW,EAAA,CAAG,gDAAA,EAAkD,SAAS,CAAA;AAAA,QACxE,GAAG,KAAA;AAAA,QAEH;AAAA;AAAA,KACH;AAAA,EAEJ;AACF;AACA,WAAA,CAAY,WAAA,GAAc,aAAA;AAOnB,IAAM,YAAA,GAAqB,KAAA,CAAA,UAAA;AAAA,EAChC,CAAC,EAAE,SAAA,EAAW,OAAA,EAAS,UAAU,GAAG,KAAA,IAAS,GAAA,qBAC3C,IAAA,CAAC,SAAI,GAAA,EAAU,IAAA,EAAK,SAAQ,SAAA,EAAW,EAAA,CAAG,wBAAwB,SAAS,CAAA,EAAI,GAAG,KAAA,EAC/E,QAAA,EAAA;AAAA,IAAA,OAAA,oBACC,GAAA,CAAC,KAAA,EAAA,EAAI,SAAA,EAAU,uDAAA,EAAyD,QAAA,EAAA,OAAA,EAAQ,CAAA;AAAA,IAEjF;AAAA,GAAA,EACH;AAEJ;AACA,YAAA,CAAa,WAAA,GAAc,cAAA;AAWpB,IAAM,WAAA,GAAoB,KAAA,CAAA,UAAA;AAAA,EAC/B,CAAC,EAAE,SAAA,EAAW,KAAA,EAAO,QAAA,GAAW,KAAA,EAAO,QAAA,EAAU,OAAA,EAAS,QAAA,EAAU,GAAG,KAAA,EAAM,EAAG,GAAA,KAAQ;AACtF,IAAA,MAAM,EAAE,MAAA,EAAQ,WAAA,EAAa,cAAA,EAAe,GAAI,WAAW,aAAa,CAAA;AACxE,IAAA,IAAI,UAAU,CAAC,OAAA,CAAQ,KAAA,EAAO,MAAM,GAAG,OAAO,IAAA;AAC9C,IAAA,MAAM,SAAS,WAAA,KAAgB,KAAA;AAE/B,IAAA,uBACE,GAAA;AAAA,MAAC,KAAA;AAAA,MAAA;AAAA,QACC,GAAA;AAAA,QACA,mBAAA,EAAkB,EAAA;AAAA,QAClB,YAAA,EAAY,KAAA;AAAA,QACZ,IAAA,EAAK,QAAA;AAAA,QACL,eAAA,EAAe,MAAA;AAAA,QACf,iBAAe,QAAA,IAAY,MAAA;AAAA,QAC3B,WAAA,EAAa,MAAM,CAAC,QAAA,IAAY,eAAe,KAAK,CAAA;AAAA,QACpD,OAAA,EAAS,CAAC,CAAA,KAAM;AACd,UAAA,OAAA,GAAU,CAAC,CAAA;AACX,UAAA,IAAI,CAAC,QAAA,IAAY,CAAC,CAAA,CAAE,gBAAA,aAA6B,KAAK,CAAA;AAAA,QACxD,CAAA;AAAA,QACA,SAAA,EAAW,EAAA;AAAA,UACT,oFAAA;AAAA,UACA,MAAA,IAAU,kCAAA;AAAA,UACV,QAAA,IAAY,gCAAA;AAAA,UACZ;AAAA,SACF;AAAA,QACC,GAAG,KAAA;AAAA,QAEH;AAAA;AAAA,KACH;AAAA,EAEJ;AACF;AACA,WAAA,CAAY,WAAA,GAAc,aAAA;AAKnB,IAAM,YAAA,GAAqB,KAAA,CAAA,UAAA;AAAA,EAChC,CAAC,EAAE,SAAA,EAAW,QAAA,GAAW,qBAAqB,GAAG,KAAA,IAAS,GAAA,KAAQ;AAChE,IAAA,MAAM,EAAE,OAAA,EAAS,MAAA,EAAO,GAAI,WAAW,cAAc,CAAA;AACrD,IAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAU,eAAS,KAAK,CAAA;AAE9C,IAAM,gBAAU,MAAM;AACpB,MAAA,MAAM,QACJ,OAAA,CAAQ,OAAA,EAAS,gBAAA,CAAiB,qBAAqB,EAAE,MAAA,IAAU,CAAA;AACrE,MAAA,QAAA,CAAS,UAAU,CAAC,CAAA;AAAA,IACtB,CAAA,EAAG,CAAC,MAAA,EAAQ,OAAO,CAAC,CAAA;AAEpB,IAAA,IAAI,CAAC,OAAO,OAAO,IAAA;AACnB,IAAA,uBACE,GAAA;AAAA,MAAC,KAAA;AAAA,MAAA;AAAA,QACC,GAAA;AAAA,QACA,IAAA,EAAK,cAAA;AAAA,QACL,SAAA,EAAW,EAAA,CAAG,gDAAA,EAAkD,SAAS,CAAA;AAAA,QACxE,GAAG,KAAA;AAAA,QAEH;AAAA;AAAA,KACH;AAAA,EAEJ;AACF;AACA,YAAA,CAAa,WAAA,GAAc,cAAA","file":"index.js","sourcesContent":["import * as React from \"react\";\nimport { Search } from \"lucide-react\";\nimport { cn } from \"@nucleux/utils\";\n\ninterface CommandContextValue {\n  search: string;\n  setSearch: (v: string) => void;\n  activeValue: string | null;\n  setActiveValue: (v: string | null) => void;\n  listRef: React.RefObject<HTMLDivElement>;\n  reportEmpty: (empty: boolean) => void;\n}\n\nconst CommandContext = React.createContext<CommandContextValue | null>(null);\nconst useCommand = (component: string) => {\n  const ctx = React.useContext(CommandContext);\n  if (!ctx) throw new Error(`${component} must be used within a Command`);\n  return ctx;\n};\n\nconst matches = (text: string, search: string) =>\n  text.toLowerCase().includes(search.trim().toLowerCase());\n\nexport type CommandProps = React.HTMLAttributes<HTMLDivElement>;\n\n/**\n * A composable command palette: a filterable, keyboard-navigable list of\n * actions. Compose with CommandInput, CommandList, CommandGroup, CommandItem,\n * and CommandEmpty.\n */\nexport const Command = React.forwardRef<HTMLDivElement, CommandProps>(\n  ({ className, children, ...props }, ref) => {\n    const [search, setSearch] = React.useState(\"\");\n    const [activeValue, setActiveValue] = React.useState<string | null>(null);\n    const [, setEmpty] = React.useState(false);\n    const listRef = React.useRef<HTMLDivElement>(null);\n\n    const reportEmpty = React.useCallback((e: boolean) => setEmpty(e), []);\n\n    return (\n      <div\n        ref={ref}\n        className={cn(\n          \"flex w-full flex-col overflow-hidden rounded-lg border border-border bg-background text-foreground shadow-md\",\n          className,\n        )}\n        {...props}\n      >\n        <CommandContext.Provider\n          value={{ search, setSearch, activeValue, setActiveValue, listRef, reportEmpty }}\n        >\n          {children}\n        </CommandContext.Provider>\n      </div>\n    );\n  },\n);\nCommand.displayName = \"Command\";\n\nexport type CommandInputProps = Omit<\n  React.InputHTMLAttributes<HTMLInputElement>,\n  \"value\" | \"onChange\"\n>;\n\n/** The search field that filters the command list. */\nexport const CommandInput = React.forwardRef<HTMLInputElement, CommandInputProps>(\n  ({ className, placeholder = \"Type a command or search…\", ...props }, ref) => {\n    const { search, setSearch, listRef, activeValue, setActiveValue } = useCommand(\"CommandInput\");\n\n    const visibleItems = () =>\n      Array.from(listRef.current?.querySelectorAll<HTMLElement>(\"[data-command-item]\") ?? []);\n\n    const handleKeyDown = (e: React.KeyboardEvent<HTMLInputElement>) => {\n      const items = visibleItems();\n      if (items.length === 0) return;\n      const values = items.map((el) => el.dataset.value ?? \"\");\n      const idx = values.indexOf(activeValue ?? \"\");\n      if (e.key === \"ArrowDown\") {\n        e.preventDefault();\n        setActiveValue(values[(idx + 1) % values.length] ?? null);\n      } else if (e.key === \"ArrowUp\") {\n        e.preventDefault();\n        setActiveValue(values[(idx - 1 + values.length) % values.length] ?? null);\n      } else if (e.key === \"Home\") {\n        e.preventDefault();\n        setActiveValue(values[0] ?? null);\n      } else if (e.key === \"End\") {\n        e.preventDefault();\n        setActiveValue(values[values.length - 1] ?? null);\n      } else if (e.key === \"Enter\") {\n        e.preventDefault();\n        const el = items.find((i) => i.dataset.value === activeValue) ?? items[0];\n        el?.click();\n      }\n    };\n\n    return (\n      <div className=\"flex items-center gap-2 border-b border-border px-3\">\n        <Search aria-hidden className=\"h-4 w-4 shrink-0 text-muted-foreground\" />\n        <input\n          ref={ref}\n          type=\"text\"\n          role=\"combobox\"\n          aria-expanded=\"true\"\n          aria-controls=\"command-list\"\n          value={search}\n          placeholder={placeholder}\n          onChange={(e) => {\n            setSearch(e.target.value);\n            setActiveValue(null);\n          }}\n          onKeyDown={handleKeyDown}\n          className={cn(\n            \"flex h-11 w-full bg-transparent py-3 text-sm outline-none placeholder:text-muted-foreground\",\n            className,\n          )}\n          {...props}\n        />\n      </div>\n    );\n  },\n);\nCommandInput.displayName = \"CommandInput\";\n\nexport type CommandListProps = React.HTMLAttributes<HTMLDivElement>;\n\n/** Scrollable container for command groups and items. */\nexport const CommandList = React.forwardRef<HTMLDivElement, CommandListProps>(\n  ({ className, children, ...props }, ref) => {\n    const { listRef, search, reportEmpty, activeValue, setActiveValue } = useCommand(\"CommandList\");\n    const setRefs = (node: HTMLDivElement | null) => {\n      (listRef as React.MutableRefObject<HTMLDivElement | null>).current = node;\n      if (typeof ref === \"function\") ref(node);\n      else if (ref) (ref as React.MutableRefObject<HTMLDivElement | null>).current = node;\n    };\n\n    // After each search change, recount visible items and keep an active item.\n    React.useEffect(() => {\n      const items = Array.from(\n        listRef.current?.querySelectorAll<HTMLElement>(\"[data-command-item]\") ?? [],\n      );\n      reportEmpty(items.length === 0);\n      const values = items.map((el) => el.dataset.value ?? \"\");\n      if (values.length && !values.includes(activeValue ?? \"\")) setActiveValue(values[0] ?? null);\n    }, [search, listRef, reportEmpty, activeValue, setActiveValue]);\n\n    return (\n      <div\n        ref={setRefs}\n        id=\"command-list\"\n        role=\"listbox\"\n        className={cn(\"max-h-72 overflow-y-auto overflow-x-hidden p-1\", className)}\n        {...props}\n      >\n        {children}\n      </div>\n    );\n  },\n);\nCommandList.displayName = \"CommandList\";\n\nexport interface CommandGroupProps extends React.HTMLAttributes<HTMLDivElement> {\n  heading?: React.ReactNode;\n}\n\n/** A labelled group of {@link CommandItem}s. */\nexport const CommandGroup = React.forwardRef<HTMLDivElement, CommandGroupProps>(\n  ({ className, heading, children, ...props }, ref) => (\n    <div ref={ref} role=\"group\" className={cn(\"overflow-hidden py-1\", className)} {...props}>\n      {heading && (\n        <div className=\"px-2 py-1.5 text-xs font-medium text-muted-foreground\">{heading}</div>\n      )}\n      {children}\n    </div>\n  ),\n);\nCommandGroup.displayName = \"CommandGroup\";\n\nexport interface CommandItemProps\n  extends Omit<React.HTMLAttributes<HTMLDivElement>, \"onSelect\"> {\n  /** The value used for filtering + selection. Defaults to the text content. */\n  value: string;\n  disabled?: boolean;\n  onSelect?: (value: string) => void;\n}\n\n/** A selectable command. Hidden automatically when it doesn't match the search. */\nexport const CommandItem = React.forwardRef<HTMLDivElement, CommandItemProps>(\n  ({ className, value, disabled = false, onSelect, onClick, children, ...props }, ref) => {\n    const { search, activeValue, setActiveValue } = useCommand(\"CommandItem\");\n    if (search && !matches(value, search)) return null;\n    const active = activeValue === value;\n\n    return (\n      <div\n        ref={ref}\n        data-command-item=\"\"\n        data-value={value}\n        role=\"option\"\n        aria-selected={active}\n        aria-disabled={disabled || undefined}\n        onMouseMove={() => !disabled && setActiveValue(value)}\n        onClick={(e) => {\n          onClick?.(e);\n          if (!disabled && !e.defaultPrevented) onSelect?.(value);\n        }}\n        className={cn(\n          \"flex cursor-pointer items-center gap-2 rounded-sm px-2 py-1.5 text-sm outline-none\",\n          active && \"bg-accent text-accent-foreground\",\n          disabled && \"pointer-events-none opacity-50\",\n          className,\n        )}\n        {...props}\n      >\n        {children}\n      </div>\n    );\n  },\n);\nCommandItem.displayName = \"CommandItem\";\n\nexport type CommandEmptyProps = React.HTMLAttributes<HTMLDivElement>;\n\n/** Shown when no items match the current search. */\nexport const CommandEmpty = React.forwardRef<HTMLDivElement, CommandEmptyProps>(\n  ({ className, children = \"No results found.\", ...props }, ref) => {\n    const { listRef, search } = useCommand(\"CommandEmpty\");\n    const [empty, setEmpty] = React.useState(false);\n\n    React.useEffect(() => {\n      const count =\n        listRef.current?.querySelectorAll(\"[data-command-item]\").length ?? 0;\n      setEmpty(count === 0);\n    }, [search, listRef]);\n\n    if (!empty) return null;\n    return (\n      <div\n        ref={ref}\n        role=\"presentation\"\n        className={cn(\"py-6 text-center text-sm text-muted-foreground\", className)}\n        {...props}\n      >\n        {children}\n      </div>\n    );\n  },\n);\nCommandEmpty.displayName = \"CommandEmpty\";\n"]}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@nucleux/command",
+  "version": "0.2.0",
+  "type": "module",
+  "sideEffects": false,
+  "description": "Searchable command palette — Nucleux agentic UI for React.",
+  "keywords": [
+    "nucleux",
+    "react",
+    "ui",
+    "components",
+    "agentic",
+    "ai",
+    "tailwind",
+    "command"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "peerDependencies": {
+    "react": ">=18",
+    "react-dom": ">=18"
+  },
+  "dependencies": {
+    "lucide-react": "^0.469.0",
+    "@nucleux/utils": "0.2.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "@types/react": "^18.3.18",
+    "react": "^18.3.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/intelligaia-open-labs/nucleux.git",
+    "directory": "packages/command"
+  },
+  "homepage": "https://github.com/intelligaia-open-labs/nucleux#readme",
+  "scripts": {
+    "build": "tsup"
+  }
+}