@adminiumjs/ui 0.1.0-rc.1

package/dist/components/choice-chips/ChoiceChips.d.ts

@@ -0,0 +1,40 @@
+import type * as React from 'react';
+export interface ChoiceChipOption {
+    value: string;
+    label: React.ReactNode;
+    /** Optional leading icon (decorative). */
+    icon?: React.ReactNode | undefined;
+    disabled?: boolean | undefined;
+}
+interface ChoiceChipsCommonProps extends Omit<React.ComponentPropsWithRef<'div'>, 'style' | 'defaultValue' | 'onChange'> {
+    options: readonly ChoiceChipOption[];
+    /** Disables the whole group. */
+    disabled?: boolean | undefined;
+}
+export interface ChoiceChipsSingleProps extends ChoiceChipsCommonProps {
+    /**
+     * Single-select (default): radiogroup semantics — one tab stop, ←→/↑↓ move
+     * AND select (mirrored in RTL), Space/Enter select.
+     */
+    multiple?: false | undefined;
+    value?: string | null | undefined;
+    defaultValue?: string | null | undefined;
+    onValueChange?: ((value: string | null) => void) | undefined;
+}
+export interface ChoiceChipsMultipleProps extends ChoiceChipsCommonProps {
+    /** Multi-select: independent `aria-pressed` toggle chips in natural tab order. */
+    multiple: true;
+    value?: readonly string[] | undefined;
+    defaultValue?: readonly string[] | undefined;
+    onValueChange?: ((value: string[]) => void) | undefined;
+}
+export type ChoiceChipsProps = ChoiceChipsSingleProps | ChoiceChipsMultipleProps;
+/**
+ * ChoiceChips / PillOptions — pill option chips, selected = accent border +
+ * accent-soft bg + accent text (research/design-system.md §3 Tier 2).
+ * Single mode is a radiogroup with roving tabindex; multiple mode renders
+ * `aria-pressed` toggle chips.
+ */
+export declare function ChoiceChips(props: ChoiceChipsProps): React.JSX.Element;
+export {};
+//# sourceMappingURL=ChoiceChips.d.ts.map

package/dist/components/choice-chips/ChoiceChips.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChoiceChips.d.ts","sourceRoot":"","sources":["../../../src/components/choice-chips/ChoiceChips.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAIpC,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,0CAA0C;IAC1C,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAChC;AAED,UAAU,sBAAuB,SAAQ,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,cAAc,GAAG,UAAU,CAAC;IACtH,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACrC,gCAAgC;IAChC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAChC;AAED,MAAM,WAAW,sBAAuB,SAAQ,sBAAsB;IACpE;;;OAGG;IACH,QAAQ,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAClC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACzC,aAAa,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CAC9D;AAED,MAAM,WAAW,wBAAyB,SAAQ,sBAAsB;IACtE,kFAAkF;IAClF,QAAQ,EAAE,IAAI,CAAC;IACf,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACtC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAC7C,aAAa,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CACzD;AAED,MAAM,MAAM,gBAAgB,GAAG,sBAAsB,GAAG,wBAAwB,CAAC;AASjF;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,qBAwGlD"}

package/dist/components/choice-chips/ChoiceChips.js

@@ -0,0 +1,76 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useDirection } from '@radix-ui/react-direction';
+import { useRef, useState } from 'react';
+import { cn } from '../../lib/cn.js';
+const chipClasses = 'inline-flex h-7 select-none items-center gap-1.5 whitespace-nowrap rounded-full border border-border-strong bg-surface px-3 text-[12px] font-semibold text-fg-muted ' +
+    'transition-colors duration-150 hover:text-fg ' +
+    'focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-accent ' +
+    'disabled:pointer-events-none disabled:opacity-40 ' +
+    'data-[selected]:border-accent data-[selected]:bg-accent-soft data-[selected]:text-accent [&_svg]:size-3.5 [&_svg]:shrink-0';
+/**
+ * ChoiceChips / PillOptions — pill option chips, selected = accent border +
+ * accent-soft bg + accent text (research/design-system.md §3 Tier 2).
+ * Single mode is a radiogroup with roving tabindex; multiple mode renders
+ * `aria-pressed` toggle chips.
+ */
+export function ChoiceChips(props) {
+    const { options, disabled = false, multiple, value, defaultValue, onValueChange, className, ...rest } = props;
+    const direction = useDirection();
+    const groupRef = useRef(null);
+    const [internal, setInternal] = useState(defaultValue ?? (multiple ? [] : null));
+    const current = value !== undefined ? value : internal;
+    const isSelected = (optionValue) => multiple ? current.includes(optionValue) : current === optionValue;
+    const emit = (next) => {
+        if (value === undefined)
+            setInternal(next);
+        onValueChange?.(next);
+    };
+    const toggle = (optionValue) => {
+        if (multiple) {
+            const selected = current;
+            emit(selected.includes(optionValue)
+                ? selected.filter((existing) => existing !== optionValue)
+                : [...selected, optionValue]);
+        }
+        else {
+            emit(optionValue);
+        }
+    };
+    /** Roving arrows (single mode): move focus and select, RTL-mirrored. */
+    const handleKeyDown = (event) => {
+        if (multiple)
+            return;
+        const forwardKeys = direction === 'rtl' ? ['ArrowLeft', 'ArrowDown'] : ['ArrowRight', 'ArrowDown'];
+        const backwardKeys = direction === 'rtl' ? ['ArrowRight', 'ArrowUp'] : ['ArrowLeft', 'ArrowUp'];
+        let delta = 0;
+        if (forwardKeys.includes(event.key))
+            delta = 1;
+        else if (backwardKeys.includes(event.key))
+            delta = -1;
+        else
+            return;
+        event.preventDefault();
+        const enabled = options.filter((option) => !option.disabled);
+        if (enabled.length === 0)
+            return;
+        const focusedValue = document.activeElement?.getAttribute('data-value');
+        const fromIndex = enabled.findIndex((option) => option.value === (focusedValue ?? current));
+        const nextIndex = (fromIndex + delta + enabled.length) % enabled.length;
+        const nextOption = enabled[nextIndex];
+        if (!nextOption)
+            return;
+        emit(nextOption.value);
+        groupRef.current
+            ?.querySelector(`[data-value="${CSS.escape(nextOption.value)}"]`)
+            ?.focus();
+    };
+    const firstEnabled = options.find((option) => !option.disabled)?.value;
+    return (_jsx("div", { ref: groupRef, role: multiple ? 'group' : 'radiogroup', onKeyDown: handleKeyDown, className: cn('flex flex-wrap items-center gap-1.5', className), ...rest, children: options.map((option) => {
+            const selected = isSelected(option.value);
+            const singleTabbable = current === option.value || (current === null && option.value === firstEnabled);
+            return (_jsxs("button", { type: "button", "data-value": option.value, "data-selected": selected ? '' : undefined, disabled: disabled || option.disabled, className: chipClasses, ...(multiple
+                    ? { 'aria-pressed': selected }
+                    : { role: 'radio', 'aria-checked': selected, tabIndex: singleTabbable ? 0 : -1 }), onClick: () => toggle(option.value), children: [option.icon ? (_jsx("span", { "aria-hidden": "true", className: "flex items-center", children: option.icon })) : null, option.label] }, option.value));
+        }) }));
+}
+//# sourceMappingURL=ChoiceChips.js.map

package/dist/components/choice-chips/ChoiceChips.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChoiceChips.js","sourceRoot":"","sources":["../../../src/components/choice-chips/ChoiceChips.tsx"],"names":[],"mappings":"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"}

package/dist/components/choice-chips/index.d.ts

@@ -0,0 +1,3 @@
+export { ChoiceChips } from './ChoiceChips.js';
+export type { ChoiceChipOption, ChoiceChipsMultipleProps, ChoiceChipsProps, ChoiceChipsSingleProps, } from './ChoiceChips.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/choice-chips/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/choice-chips/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EACV,gBAAgB,EAChB,wBAAwB,EACxB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,kBAAkB,CAAC"}

package/dist/components/choice-chips/index.js

@@ -0,0 +1,2 @@
+export { ChoiceChips } from './ChoiceChips.js';
+//# sourceMappingURL=index.js.map

package/dist/components/choice-chips/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/choice-chips/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

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

@@ -0,0 +1,54 @@
+import type * as React from 'react';
+export interface ComboboxOption {
+    value: string;
+    /** Plain-string label — filtered against and echoed into the input. */
+    label: string;
+    /** Muted second line in the option row. */
+    description?: string | undefined;
+    /** Leading slot — typically an `Avatar` or Lucide icon (decorative). */
+    leading?: React.ReactNode | undefined;
+    disabled?: boolean | undefined;
+}
+export interface ComboboxProps {
+    options: readonly ComboboxOption[];
+    /** Controlled selected value (`null` = nothing selected). */
+    value?: string | null | undefined;
+    /** Uncontrolled initial value. */
+    defaultValue?: string | null | undefined;
+    onValueChange?: ((value: string | null) => void) | undefined;
+    /** Empty-state row shown when no option matches the query (i18n: no default). */
+    emptyText: React.ReactNode;
+    placeholder?: string | undefined;
+    /** Custom match predicate; defaults to case-insensitive `label` substring. */
+    filter?: ((option: ComboboxOption, query: string) => boolean) | undefined;
+    disabled?: boolean | undefined;
+    /** Danger border + ring, `aria-invalid` (also injected by `FormField`). */
+    error?: boolean | undefined;
+    /** JetBrains Mono input text (technical values). */
+    mono?: boolean | undefined;
+    /** Classes for the root wrapper (the panel width follows the anchor). */
+    className?: string | undefined;
+    /** Control id — injected by `FormField`, applied to the input. */
+    id?: string | undefined;
+    name?: string | undefined;
+    ref?: React.Ref<HTMLInputElement> | undefined;
+    'aria-label'?: string | undefined;
+    'aria-labelledby'?: string | undefined;
+    /** Injected by `FormField`; applied to the input. */
+    'aria-describedby'?: string | undefined;
+    'aria-invalid'?: React.AriaAttributes['aria-invalid'] | undefined;
+    'aria-required'?: React.AriaAttributes['aria-required'] | undefined;
+}
+/**
+ * Combobox — searchable single-select (research/design-system.md §3 Tier 2):
+ * Input chrome + chevron; typing filters the option list in an anchored
+ * Radix Popover panel; rows take a `leading` slot (avatars) and an optional
+ * description; empty state via `emptyText`.
+ *
+ * ARIA 1.2 combobox pattern, dependency-free beyond `@radix-ui/react-popover`:
+ * the input keeps focus (`role="combobox"`, `aria-expanded`,
+ * `aria-activedescendant`); ↑/↓ move the active option, ↵ selects, Esc
+ * closes, Tab/outside-click dismisses.
+ */
+export declare function Combobox({ options, value, defaultValue, onValueChange, emptyText, placeholder, filter, disabled, error, mono, className, id, name, ref, ...aria }: ComboboxProps): React.JSX.Element;
+//# sourceMappingURL=Combobox.d.ts.map

package/dist/components/combobox/Combobox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Combobox.d.ts","sourceRoot":"","sources":["../../../src/components/combobox/Combobox.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAIpC,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,wEAAwE;IACxE,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAChC;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,SAAS,cAAc,EAAE,CAAC;IACnC,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAClC,kCAAkC;IAClC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACzC,aAAa,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAC7D,iFAAiF;IACjF,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,8EAA8E;IAC9E,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,SAAS,CAAC;IAC1E,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,2EAA2E;IAC3E,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,oDAAoD;IACpD,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,kEAAkE;IAClE,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,GAAG,SAAS,CAAC;IAC9C,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,qDAAqD;IACrD,kBAAkB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,cAAc,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,GAAG,SAAS,CAAC;IAClE,eAAe,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,eAAe,CAAC,GAAG,SAAS,CAAC;CACrE;AAKD;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,EACvB,OAAO,EACP,KAAK,EACL,YAAY,EACZ,aAAa,EACb,SAAS,EACT,WAAW,EACX,MAAsB,EACtB,QAAgB,EAChB,KAAa,EACb,IAAY,EACZ,SAAS,EACT,EAAE,EACF,IAAI,EACJ,GAAG,EACH,GAAG,IAAI,EACR,EAAE,aAAa,qBAqMf"}

package/dist/components/combobox/Combobox.js

@@ -0,0 +1,127 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import * as PopoverPrimitive from '@radix-ui/react-popover';
+import { Check, ChevronDown } from 'lucide-react';
+import { useEffect, useId, useRef, useState } from 'react';
+import { cn } from '../../lib/cn.js';
+const defaultFilter = (option, query) => option.label.toLowerCase().includes(query.trim().toLowerCase());
+/**
+ * Combobox — searchable single-select (research/design-system.md §3 Tier 2):
+ * Input chrome + chevron; typing filters the option list in an anchored
+ * Radix Popover panel; rows take a `leading` slot (avatars) and an optional
+ * description; empty state via `emptyText`.
+ *
+ * ARIA 1.2 combobox pattern, dependency-free beyond `@radix-ui/react-popover`:
+ * the input keeps focus (`role="combobox"`, `aria-expanded`,
+ * `aria-activedescendant`); ↑/↓ move the active option, ↵ selects, Esc
+ * closes, Tab/outside-click dismisses.
+ */
+export function Combobox({ options, value, defaultValue, onValueChange, emptyText, placeholder, filter = defaultFilter, disabled = false, error = false, mono = false, className, id, name, ref, ...aria }) {
+    const generatedId = useId();
+    const inputId = id ?? generatedId;
+    const listboxId = `${inputId}-listbox`;
+    const rootRef = useRef(null);
+    const inputRef = useRef(null);
+    const [internalValue, setInternalValue] = useState(defaultValue ?? null);
+    const selectedValue = value !== undefined ? value : internalValue;
+    const selectedOption = options.find((option) => option.value === selectedValue);
+    const [open, setOpen] = useState(false);
+    const [query, setQuery] = useState('');
+    const [activeIndex, setActiveIndex] = useState(-1);
+    const filtered = query === '' ? options : options.filter((option) => filter(option, query));
+    const optionId = (index) => `${inputId}-option-${index}`;
+    const activeOption = activeIndex >= 0 ? filtered[activeIndex] : undefined;
+    const invalid = error || aria['aria-invalid'] === true || aria['aria-invalid'] === 'true';
+    useEffect(() => {
+        if (open && activeIndex >= 0) {
+            document.getElementById(`${inputId}-option-${activeIndex}`)?.scrollIntoView({ block: 'nearest' });
+        }
+    }, [activeIndex, open, inputId]);
+    const openList = () => {
+        if (disabled || open)
+            return;
+        setOpen(true);
+        setQuery('');
+        const selectedIndex = options.findIndex((option) => option.value === selectedValue && !option.disabled);
+        setActiveIndex(selectedIndex >= 0 ? selectedIndex : options.findIndex((option) => !option.disabled));
+    };
+    const closeList = () => {
+        setOpen(false);
+        setQuery('');
+        setActiveIndex(-1);
+    };
+    const commit = (option) => {
+        if (option.disabled)
+            return;
+        if (value === undefined)
+            setInternalValue(option.value);
+        onValueChange?.(option.value);
+        closeList();
+    };
+    const moveActive = (delta) => {
+        if (filtered.length === 0)
+            return;
+        let index = activeIndex;
+        for (let step = 0; step < filtered.length; step += 1) {
+            index = (index + delta + filtered.length) % filtered.length;
+            if (!filtered[index]?.disabled)
+                break;
+        }
+        setActiveIndex(index);
+    };
+    const handleKeyDown = (event) => {
+        if (event.key === 'ArrowDown' || event.key === 'ArrowUp') {
+            event.preventDefault();
+            if (!open)
+                openList();
+            else
+                moveActive(event.key === 'ArrowDown' ? 1 : -1);
+        }
+        else if (event.key === 'Enter') {
+            if (open && activeOption) {
+                event.preventDefault();
+                commit(activeOption);
+            }
+        }
+        else if (event.key === 'Escape') {
+            if (open) {
+                event.preventDefault();
+                closeList();
+            }
+        }
+        else if (event.key === 'Tab') {
+            if (open)
+                closeList();
+        }
+    };
+    return (_jsx(PopoverPrimitive.Root, { open: open, onOpenChange: (next) => (next ? openList() : closeList()), children: _jsxs("div", { ref: rootRef, className: cn('relative w-full', className), children: [_jsx(PopoverPrimitive.Anchor, { asChild: true, children: _jsxs("div", { "data-invalid": invalid ? '' : undefined, className: cn('flex h-[34px] w-full min-w-0 items-center gap-2 rounded-md border border-border-strong bg-surface-2 ps-3 pe-2 ', 'transition-[border-color,box-shadow] duration-150 ', 'focus-within:border-accent focus-within:ring-[3px] focus-within:ring-accent-soft ', 'has-[input:disabled]:pointer-events-none has-[input:disabled]:opacity-40 ', 'data-[invalid]:border-danger data-[invalid]:focus-within:ring-danger-soft'), onPointerDown: (event) => {
+                            // keep focus on the input; toggle instead of blur-then-reopen
+                            if (event.target !== inputRef.current)
+                                event.preventDefault();
+                            inputRef.current?.focus();
+                            if (!open)
+                                openList();
+                        }, children: [_jsx("input", { ref: (node) => {
+                                    inputRef.current = node;
+                                    if (typeof ref === 'function')
+                                        ref(node);
+                                    else if (ref)
+                                        ref.current = node;
+                                }, id: inputId, ...(name === undefined ? {} : { name }), type: "text", role: "combobox", autoComplete: "off", "aria-expanded": open, "aria-autocomplete": "list", ...(open ? { 'aria-controls': listboxId } : {}), ...(open && activeOption ? { 'aria-activedescendant': optionId(activeIndex) } : {}), ...(invalid ? { 'aria-invalid': true } : {}), ...aria, disabled: disabled, ...(placeholder === undefined ? {} : { placeholder }), value: open ? query : (selectedOption?.label ?? ''), onChange: (event) => {
+                                    if (!open)
+                                        setOpen(true);
+                                    setQuery(event.target.value);
+                                    setActiveIndex(0);
+                                }, onKeyDown: handleKeyDown, className: cn('h-full w-full min-w-0 flex-1 bg-transparent text-[13px] text-fg placeholder:text-fg-subtle focus:outline-none', mono && 'font-mono tabular-nums') }), _jsx(ChevronDown, { "aria-hidden": "true", className: cn('size-3.5 shrink-0 text-fg-subtle transition-transform duration-150', open && 'rotate-180') })] }) }), _jsx(PopoverPrimitive.Portal, { children: _jsx(PopoverPrimitive.Content, { sideOffset: 5, align: "start", onOpenAutoFocus: (event) => event.preventDefault(), onInteractOutside: (event) => {
+                            // clicks on the anchor input must not count as "outside"
+                            if (rootRef.current?.contains(event.target))
+                                event.preventDefault();
+                        }, className: cn('z-50 w-[var(--radix-popper-anchor-width)] rounded-lg border border-border bg-surface p-1 shadow-menu ', 'animate-[nb-pop_.16s_cubic-bezier(.2,.7,.3,1)]'), children: _jsxs("div", { role: "listbox", id: listboxId, className: "nb-scroll max-h-[260px] overflow-y-auto", children: [filtered.map((option, index) => {
+                                    const selected = option.value === selectedValue;
+                                    const active = index === activeIndex;
+                                    return (_jsxs("div", { id: optionId(index), role: "option", "aria-selected": selected, ...(option.disabled ? { 'aria-disabled': true } : {}), "data-active": active ? '' : undefined, onPointerDown: (event) => event.preventDefault(), onPointerMove: () => {
+                                            if (!option.disabled && !active)
+                                                setActiveIndex(index);
+                                        }, onClick: () => commit(option), className: cn('flex cursor-default select-none items-center gap-2.5 rounded-[8px] px-2.5 py-1.5 text-[13px] text-fg ', 'data-[active]:bg-surface-2', option.disabled && 'pointer-events-none opacity-40'), children: [option.leading ? (_jsx("span", { "aria-hidden": "true", className: "flex shrink-0 items-center [&_svg]:size-3.5", children: option.leading })) : null, _jsxs("span", { className: "flex min-w-0 flex-1 flex-col", children: [_jsx("span", { className: "truncate", children: option.label }), option.description === undefined ? null : (_jsx("span", { className: "truncate text-[11.5px] leading-4 text-fg-muted", children: option.description }))] }), selected ? (_jsx(Check, { "aria-hidden": "true", strokeWidth: 3, className: "size-3.5 shrink-0 text-accent" })) : null] }, option.value));
+                                }), filtered.length === 0 ? (_jsx("div", { className: "px-2.5 py-3 text-center text-[12.5px] text-fg-muted", children: emptyText })) : null] }) }) })] }) }));
+}
+//# sourceMappingURL=Combobox.js.map

package/dist/components/combobox/Combobox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Combobox.js","sourceRoot":"","sources":["../../../src/components/combobox/Combobox.tsx"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,3 @@
+export { Combobox } from './Combobox.js';
+export type { ComboboxOption, ComboboxProps } from './Combobox.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/combobox/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/dist/components/combobox/index.js

@@ -0,0 +1,2 @@
+export { Combobox } from './Combobox.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/combobox/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC"}

package/dist/components/command-palette/CommandPalette.d.ts

@@ -0,0 +1,62 @@
+import type { ReactNode } from 'react';
+export interface CommandItem {
+    /** Unique across all groups (used for selection + DOM ids). */
+    id: string;
+    label: string;
+    /** Muted single-line subtitle under the label (e.g. a record hit's row context). */
+    description?: string | undefined;
+    /** Lucide icon element rendered in a small tile. */
+    icon?: ReactNode;
+    /** Keyboard hint rendered as `Kbd` at the row end (e.g. "G D"). */
+    hint?: string;
+    /** Extra strings matched by the default filter. */
+    keywords?: readonly string[] | undefined;
+    disabled?: boolean | undefined;
+}
+export interface CommandGroup {
+    id: string;
+    /** Uppercase section label ("Navigation", "Actions"). */
+    label: string;
+    items: readonly CommandItem[];
+}
+export interface CommandPaletteLabels {
+    /** Sr-only dialog title (e.g. "Command palette"). */
+    dialog: string;
+    /** Search input placeholder + accessible name. */
+    placeholder: string;
+    /** Footer hint next to ↑↓. */
+    navigate: string;
+    /** Footer hint next to ↵. */
+    open: string;
+    /** Footer hint next to esc. */
+    close: string;
+    /** Empty-state copy; receives the query to echo it back. */
+    empty: (query: string) => ReactNode;
+}
+export interface CommandPaletteProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    /** Grouped items — the palette does no data fetching. */
+    groups: readonly CommandGroup[];
+    /** Invoked on Enter or click; the palette closes unless `closeOnSelect` is false. */
+    onSelect: (item: CommandItem) => void;
+    labels: CommandPaletteLabels;
+    /** Controlled query (optional — internal state by default). */
+    query?: string | undefined;
+    onQueryChange?: ((query: string) => void) | undefined;
+    /** Case-insensitive substring over label+keywords by default. */
+    filter?: ((item: CommandItem, query: string) => boolean) | undefined;
+    closeOnSelect?: boolean | undefined;
+    /** Extra footer content (e.g. the "Ask AI" slot). */
+    footerExtra?: ReactNode;
+    className?: string | undefined;
+}
+/**
+ * CommandPalette — ⌘K dialog shell: search header, grouped results (icon tile
+ * + label + kbd hint), accent-soft selected row, empty state echoing the
+ * query, footer hint bar; fully keyboard driven (↑↓ wrap, Enter opens, Esc
+ * closes) with `aria-activedescendant` combobox semantics
+ * (research/design-system.md §3 Tier 3). Pair with `useCommandK`.
+ */
+export declare function CommandPalette({ open, onOpenChange, groups, onSelect, labels, query: controlledQuery, onQueryChange, filter, closeOnSelect, footerExtra, className, }: CommandPaletteProps): import("react").JSX.Element;
+//# sourceMappingURL=CommandPalette.d.ts.map

package/dist/components/command-palette/CommandPalette.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommandPalette.d.ts","sourceRoot":"","sources":["../../../src/components/command-palette/CommandPalette.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAMvC,MAAM,WAAW,WAAW;IAC1B,+DAA+D;IAC/D,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,oFAAoF;IACpF,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,oDAAoD;IACpD,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAChC;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,oBAAoB;IACnC,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,SAAS,CAAC;CACrC;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC,yDAAyD;IACzD,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC;IAChC,qFAAqF;IACrF,QAAQ,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,CAAC;IACtC,MAAM,EAAE,oBAAoB,CAAC;IAC7B,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,aAAa,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACtD,iEAAiE;IACjE,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,SAAS,CAAC;IACrE,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACpC,qDAAqD;IACrD,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AASD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,EAC7B,IAAI,EACJ,YAAY,EACZ,MAAM,EACN,QAAQ,EACR,MAAM,EACN,KAAK,EAAE,eAAe,EACtB,aAAa,EACb,MAAsB,EACtB,aAAoB,EACpB,WAAW,EACX,SAAS,GACV,EAAE,mBAAmB,+BA4LrB"}

package/dist/components/command-palette/CommandPalette.js

@@ -0,0 +1,91 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import * as DialogPrimitive from '@radix-ui/react-dialog';
+import { CornerDownLeft, Search, SearchX } from 'lucide-react';
+import { useEffect, useId, useMemo, useRef, useState } from 'react';
+import { cn } from '../../lib/cn.js';
+import { IconTile } from '../icon-tile/IconTile.js';
+import { Kbd } from '../kbd/Kbd.js';
+const defaultFilter = (item, query) => {
+    const q = query.trim().toLowerCase();
+    if (q === '')
+        return true;
+    if (item.label.toLowerCase().includes(q))
+        return true;
+    return (item.keywords ?? []).some((k) => k.toLowerCase().includes(q));
+};
+/**
+ * CommandPalette — ⌘K dialog shell: search header, grouped results (icon tile
+ * + label + kbd hint), accent-soft selected row, empty state echoing the
+ * query, footer hint bar; fully keyboard driven (↑↓ wrap, Enter opens, Esc
+ * closes) with `aria-activedescendant` combobox semantics
+ * (research/design-system.md §3 Tier 3). Pair with `useCommandK`.
+ */
+export function CommandPalette({ open, onOpenChange, groups, onSelect, labels, query: controlledQuery, onQueryChange, filter = defaultFilter, closeOnSelect = true, footerExtra, className, }) {
+    const listId = useId();
+    const [internalQuery, setInternalQuery] = useState('');
+    const query = controlledQuery ?? internalQuery;
+    const setQuery = (next) => {
+        setInternalQuery(next);
+        onQueryChange?.(next);
+    };
+    const filteredGroups = useMemo(() => groups
+        .map((group) => ({ ...group, items: group.items.filter((item) => filter(item, query)) }))
+        .filter((group) => group.items.length > 0), [groups, filter, query]);
+    const flatItems = useMemo(() => filteredGroups.flatMap((g) => g.items), [filteredGroups]);
+    const [activeId, setActiveId] = useState(null);
+    const activeIndex = flatItems.findIndex((item) => item.id === activeId);
+    const active = activeIndex === -1 ? null : flatItems[activeIndex];
+    // Reset query + selection when opening; keep selection valid as results change.
+    useEffect(() => {
+        if (open)
+            setInternalQuery('');
+    }, [open]);
+    useEffect(() => {
+        if (active === null || active === undefined)
+            setActiveId(flatItems[0]?.id ?? null);
+    }, [flatItems, active]);
+    const listRef = useRef(null);
+    const move = (delta) => {
+        if (flatItems.length === 0)
+            return;
+        const next = (activeIndex + delta + flatItems.length) % flatItems.length;
+        const item = flatItems[next];
+        setActiveId(item.id);
+        document.getElementById(optionDomId(item))?.scrollIntoView?.({ block: 'nearest' });
+    };
+    const select = (item) => {
+        if (item.disabled)
+            return;
+        onSelect(item);
+        if (closeOnSelect)
+            onOpenChange(false);
+    };
+    const optionDomId = (item) => `${listId}-${item.id}`;
+    return (_jsx(DialogPrimitive.Root, { open: open, onOpenChange: onOpenChange, children: _jsxs(DialogPrimitive.Portal, { children: [_jsx(DialogPrimitive.Overlay, { className: "fixed inset-0 z-50 bg-[var(--scrim)] backdrop-blur-[3px] animate-[nb-fade_.2s_cubic-bezier(.2,.7,.3,1)]" }), _jsxs(DialogPrimitive.Content, { "aria-label": labels.dialog, "aria-describedby": undefined, className: cn('fixed inset-x-0 top-[16vh] z-50 mx-auto flex max-h-[60vh] w-[560px] max-w-[calc(100vw-32px)] flex-col', 'overflow-hidden rounded-lg border border-border bg-surface shadow-modal outline-none', 'animate-[nb-pop_.16s_cubic-bezier(.2,.7,.3,1)]', className), children: [_jsx(DialogPrimitive.Title, { className: "sr-only", children: labels.dialog }), _jsxs("div", { className: "flex shrink-0 items-center gap-2.5 border-b border-border px-4", children: [_jsx(Search, { className: "size-4 shrink-0 text-fg-subtle", "aria-hidden": "true" }), _jsx("input", { type: "text", role: "combobox", "aria-expanded": "true", "aria-controls": listId, "aria-activedescendant": active ? optionDomId(active) : undefined, "aria-label": labels.placeholder, placeholder: labels.placeholder, autoFocus: true, autoComplete: "off", spellCheck: false, value: query, onChange: (event) => setQuery(event.target.value), onKeyDown: (event) => {
+                                        if (event.key === 'ArrowDown') {
+                                            event.preventDefault();
+                                            move(1);
+                                        }
+                                        else if (event.key === 'ArrowUp') {
+                                            event.preventDefault();
+                                            move(-1);
+                                        }
+                                        else if (event.key === 'Enter') {
+                                            event.preventDefault();
+                                            if (active)
+                                                select(active);
+                                        }
+                                        else if (event.key === 'Home' && flatItems.length > 0) {
+                                            event.preventDefault();
+                                            setActiveId(flatItems[0].id);
+                                        }
+                                        else if (event.key === 'End' && flatItems.length > 0) {
+                                            event.preventDefault();
+                                            setActiveId(flatItems[flatItems.length - 1].id);
+                                        }
+                                    }, className: "h-12 w-full bg-transparent text-body text-fg outline-none placeholder:text-fg-subtle" }), _jsx(Kbd, { children: "esc" })] }), _jsx("div", { ref: listRef, id: listId, role: "listbox", "aria-label": labels.dialog, className: "nb-scroll min-h-0 flex-1 overflow-y-auto p-2", children: flatItems.length === 0 ? (_jsxs("div", { className: "flex flex-col items-center gap-3 px-6 py-10 text-center", children: [_jsx(IconTile, { size: "lg", tone: "neutral", icon: _jsx(SearchX, {}) }), _jsx("div", { className: "text-body-sm text-fg-muted", children: labels.empty(query) })] })) : (filteredGroups.map((group) => (_jsxs("div", { role: "group", "aria-label": group.label, className: "mb-1 last:mb-0", children: [_jsx("div", { className: "px-2.5 pb-1 pt-2 text-micro uppercase text-fg-subtle", children: group.label }), group.items.map((item) => {
+                                        const isActive = item.id === activeId;
+                                        return (_jsxs("div", { id: optionDomId(item), "data-item-id": item.id, role: "option", "aria-selected": isActive, "aria-disabled": item.disabled || undefined, onMouseMove: () => setActiveId(item.id), onClick: () => select(item), className: cn('flex cursor-pointer select-none items-center gap-2.5 rounded-md px-2.5 py-2', isActive ? 'bg-accent-soft' : undefined, item.disabled ? 'cursor-default opacity-40' : undefined), children: [item.icon === undefined || item.icon === null ? null : (_jsx(IconTile, { size: "sm", tone: isActive ? 'accent' : 'neutral', icon: item.icon })), _jsxs("span", { className: "min-w-0 flex-1", children: [_jsx("span", { className: cn('block truncate text-body font-semibold', isActive ? 'text-accent' : 'text-fg'), children: item.label }), item.description === undefined ? null : (_jsx("span", { className: "block truncate text-caption text-fg-muted", children: item.description }))] }), item.hint === undefined ? null : _jsx(Kbd, { children: item.hint })] }, item.id));
+                                    })] }, group.id)))) }), _jsxs("div", { className: "flex shrink-0 items-center gap-4 border-t border-border bg-surface-2 px-4 py-2.5 text-caption text-fg-muted", children: [_jsxs("span", { className: "flex items-center gap-1.5", children: [_jsx(Kbd, { children: "\u2191" }), _jsx(Kbd, { children: "\u2193" }), labels.navigate] }), _jsxs("span", { className: "flex items-center gap-1.5", children: [_jsx(Kbd, { children: _jsx(CornerDownLeft, { className: "size-3", "aria-hidden": "true" }) }), labels.open] }), _jsxs("span", { className: "flex items-center gap-1.5", children: [_jsx(Kbd, { children: "esc" }), labels.close] }), footerExtra === undefined ? null : _jsx("span", { className: "ms-auto", children: footerExtra })] })] })] }) }));
+}
+//# sourceMappingURL=CommandPalette.js.map

package/dist/components/command-palette/CommandPalette.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommandPalette.js","sourceRoot":"","sources":["../../../src/components/command-palette/CommandPalette.tsx"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,4 @@
+export { CommandPalette } from './CommandPalette.js';
+export type { CommandGroup, CommandItem, CommandPaletteLabels, CommandPaletteProps, } from './CommandPalette.js';
+export { useCommandK } from './useCommandK.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/command-palette/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/command-palette/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EACV,YAAY,EACZ,WAAW,EACX,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/components/command-palette/index.js

@@ -0,0 +1,3 @@
+export { CommandPalette } from './CommandPalette.js';
+export { useCommandK } from './useCommandK.js';
+//# sourceMappingURL=index.js.map

package/dist/components/command-palette/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/command-palette/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAOrD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/components/command-palette/useCommandK.d.ts

@@ -0,0 +1,9 @@
+/**
+ * useCommandK — global ⌘K / Ctrl+K hotkey (research/design-system.md §3
+ * Tier 3 CommandPalette). Fires `onTrigger` and prevents the browser default;
+ * typical wiring toggles the palette: `useCommandK(() => setOpen((o) => !o))`.
+ */
+export declare function useCommandK(onTrigger: () => void, options?: {
+    enabled?: boolean | undefined;
+}): void;
+//# sourceMappingURL=useCommandK.d.ts.map

package/dist/components/command-palette/useCommandK.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCommandK.d.ts","sourceRoot":"","sources":["../../../src/components/command-palette/useCommandK.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,IAAI,EAAE,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CAAO,GAAG,IAAI,CAexG"}

package/dist/components/command-palette/useCommandK.js

@@ -0,0 +1,24 @@
+import { useEffect } from 'react';
+/**
+ * useCommandK — global ⌘K / Ctrl+K hotkey (research/design-system.md §3
+ * Tier 3 CommandPalette). Fires `onTrigger` and prevents the browser default;
+ * typical wiring toggles the palette: `useCommandK(() => setOpen((o) => !o))`.
+ */
+export function useCommandK(onTrigger, options = {}) {
+    const enabled = options.enabled ?? true;
+    useEffect(() => {
+        if (!enabled)
+            return;
+        const onKeyDown = (event) => {
+            if ((event.metaKey || event.ctrlKey) && event.key.toLowerCase() === 'k' && !event.altKey) {
+                event.preventDefault();
+                onTrigger();
+            }
+        };
+        window.addEventListener('keydown', onKeyDown);
+        return () => window.removeEventListener('keydown', onKeyDown);
+        // onTrigger intentionally unbound — callers pass inline lambdas; latest
+        // closure is captured via the listener re-registration below.
+    }, [enabled, onTrigger]);
+}
+//# sourceMappingURL=useCommandK.js.map