{ "$schema": "https://ui.shadcn.com/schema/registry-item.json", "name": "combobox", "type": "registry:block", "title": "Combobox", "description": "A searchable combobox for forms, filters, and async choices.", "author": "Wensity ", "dependencies": [ "@base-ui/react", "@tabler/icons-react", "clsx", "tailwind-merge" ], "registryDependencies": [], "files": [ { "path": "registry/wensity/lib/utils.ts", "type": "registry:lib", "target": "@lib/utils.ts", "content": "import { type ClassValue, clsx } from \"clsx\";\nimport { twMerge } from \"tailwind-merge\";\n\nexport function cn(...inputs: ClassValue[]) {\n return twMerge(clsx(inputs));\n}\n" }, { "path": "registry/wensity/combobox.tsx", "type": "registry:component", "target": "@components/wensity/combobox.tsx", "content": "\"use client\";\n\n/**\n * Combobox — Base UI Combobox foundation (Phase 5).\n *\n * Public API preserved: options/value/onValueChange/multiple, async\n * (filter=false + onSearchChange), creatable (Wensity-owned action row),\n * label/hint/error, status icons, sizes, and multi-selection summary.\n *\n * D-17: onOpenChange → (open: boolean) => void.\n *\n * Tokens: solid `--primitive-surface-overlay` + `--primitive-shadow-overlay`\n * for the popup surface. Trigger heights/radius come from the control family\n * (`--primitive-control-height-*`, `--primitive-radius-control`).\n */\n\nimport * as React from \"react\";\nimport { Combobox as BaseCombobox } from \"@base-ui/react/combobox\";\nimport { IconPlus, IconSearch } from \"@tabler/icons-react\";\nimport { cn } from \"@/lib/utils\";\n\nexport type ComboboxSize = \"sm\" | \"md\" | \"lg\";\nexport type ComboboxStatus = \"default\" | \"error\" | \"success\";\n\nexport type ComboboxOption = {\n value: string;\n label: React.ReactNode;\n description?: React.ReactNode;\n leading?: React.ReactNode;\n disabled?: boolean;\n};\n\nexport type ComboboxGroup = {\n label?: React.ReactNode;\n options: ComboboxOption[];\n};\n\nexport interface ComboboxProps {\n id?: string;\n options: ComboboxOption[] | ComboboxGroup[];\n value?: string | string[];\n defaultValue?: string | string[];\n onValueChange?: (value: string | string[]) => void;\n open?: boolean;\n defaultOpen?: boolean;\n onOpenChange?: (open: boolean) => void;\n multiple?: boolean;\n creatable?: boolean;\n onCreateOption?: (inputValue: string) => ComboboxOption | void;\n createLabel?: (inputValue: string) => React.ReactNode;\n loading?: boolean;\n onSearchChange?: (query: string) => void;\n /** Client-side filter. Set false when options are driven by `onSearchChange`. */\n filter?: boolean;\n name?: string;\n required?: boolean;\n disabled?: boolean;\n label?: React.ReactNode;\n hint?: React.ReactNode;\n error?: React.ReactNode;\n success?: React.ReactNode;\n status?: ComboboxStatus;\n placeholder?: string;\n emptyMessage?: React.ReactNode;\n /** Screen reader copy when nothing is selected in `multiple` mode. */\n emptySelectionLabel?: React.ReactNode;\n /** Close the list when every selectable option is chosen in `multiple` mode. */\n closeWhenAllSelected?: boolean;\n comboboxSize?: ComboboxSize;\n fullWidth?: boolean;\n leadingIcon?: React.ReactNode;\n containerClassName?: string;\n triggerClassName?: string;\n contentClassName?: string;\n \"aria-describedby\"?: string;\n \"aria-invalid\"?: boolean | \"true\" | \"false\";\n \"aria-required\"?: boolean | \"true\" | \"false\";\n}\n\n/** Sentinel value used for the Wensity \"create new\" action row. */\nconst CREATE_SENTINEL = \"__wensity_combobox_create__\";\n\nconst triggerHeights: Record = {\n sm: \"min-h-[var(--primitive-control-height-sm)] text-xs\",\n md: \"min-h-[var(--primitive-control-height-md)] text-sm\",\n lg: \"min-h-[var(--primitive-control-height-lg)] text-[15px]\",\n};\n\nconst inputHeights: Record = {\n sm: \"px-3\",\n md: \"px-3.5\",\n lg: \"px-4\",\n};\n\nconst contentWidths: Record = {\n sm: \"min-w-[12rem]\",\n md: \"min-w-[15rem]\",\n lg: \"min-w-[17rem]\",\n};\n\nconst overlaySurfaceClass = \"text-[var(--foreground)]\";\n\nconst popupMotionClass = cn(\n \"origin-[var(--transform-origin)] transform-gpu outline-none\",\n \"transition-[opacity,scale] duration-[var(--primitive-motion-fast)] ease-[var(--primitive-ease,cubic-bezier(0.23,1,0.32,1))]\",\n \"data-[ending-style]:duration-[var(--primitive-motion-fast-exit)]\",\n \"data-[starting-style]:opacity-0 data-[ending-style]:opacity-0\",\n \"data-[starting-style]:scale-[0.96] data-[ending-style]:scale-[0.96]\",\n \"motion-reduce:transition-none motion-reduce:data-[starting-style]:scale-100 motion-reduce:data-[ending-style]:scale-100\",\n);\n\nfunction adaptOpenChange(\n onOpenChange?: (open: boolean) => void,\n): ((open: boolean, details: unknown) => void) | undefined {\n if (!onOpenChange) return undefined;\n return (open) => onOpenChange(open);\n}\n\nfunction isGroupedOptions(\n options: ComboboxOption[] | ComboboxGroup[],\n): options is ComboboxGroup[] {\n return options.length > 0 && \"options\" in options[0];\n}\n\nfunction flattenOptions(options: ComboboxOption[] | ComboboxGroup[]) {\n return isGroupedOptions(options)\n ? options.flatMap((group) => group.options)\n : options;\n}\n\nfunction getOptionLabelText(option: ComboboxOption) {\n return typeof option.label === \"string\" || typeof option.label === \"number\"\n ? String(option.label)\n : option.value;\n}\n\nfunction buildMultipleFieldSummary(\n selectedOptions: ComboboxOption[],\n selectedCount: number,\n totalSelectable: number,\n) {\n if (selectedCount === 0) return null;\n if (totalSelectable > 0 && selectedCount >= totalSelectable) {\n return totalSelectable === 1\n ? getOptionLabelText(selectedOptions[0]!)\n : `All ${totalSelectable} selected`;\n }\n if (selectedCount === 1 && selectedOptions[0]) {\n return getOptionLabelText(selectedOptions[0]);\n }\n const first = selectedOptions[0] ? getOptionLabelText(selectedOptions[0]) : \"\";\n const remaining = selectedCount - 1;\n return remaining > 0 ? `${first} + ${remaining} more` : first;\n}\n\nfunction countSelectableOptions(options: ComboboxOption[]) {\n return options.filter((option) => !option.disabled).length;\n}\n\nfunction normalizeValue(\n value: string | string[] | undefined,\n multiple: boolean,\n): string | string[] {\n if (multiple) {\n if (Array.isArray(value)) return value;\n if (value) return [value];\n return [];\n }\n return Array.isArray(value) ? (value[0] ?? \"\") : (value ?? \"\");\n}\n\n/** ButtonSpinner recipe — canonical loading indicator (PRIM-MOTION-002). */\nfunction ButtonSpinner({ className }: { className?: string }) {\n return (\n \n );\n}\n\nfunction ComboboxSuccessCheck() {\n return (\n \n \n \n );\n}\n\nfunction ComboboxErrorX() {\n return (\n \n \n \n \n );\n}\n\nexport function Combobox({\n options,\n id,\n value,\n defaultValue,\n onValueChange,\n open: controlledOpen,\n defaultOpen,\n onOpenChange,\n multiple = false,\n creatable = false,\n onCreateOption,\n createLabel,\n loading = false,\n onSearchChange,\n filter = true,\n name,\n required,\n disabled,\n label,\n hint,\n error,\n success,\n status: statusProp,\n placeholder = \"Search…\",\n emptyMessage = \"No results found.\",\n emptySelectionLabel = \"Nothing selected.\",\n closeWhenAllSelected = true,\n comboboxSize = \"md\",\n fullWidth = true,\n leadingIcon,\n containerClassName,\n triggerClassName,\n contentClassName,\n \"aria-describedby\": ariaDescribedBy,\n \"aria-invalid\": ariaInvalid,\n \"aria-required\": ariaRequired,\n}: ComboboxProps) {\n const reactId = React.useId();\n const comboboxId = id ?? `wensity-combobox-${reactId}`;\n const labelId = label ? `${comboboxId}-label` : undefined;\n const hintId = hint ? `${comboboxId}-hint` : undefined;\n const errorId = error ? `${comboboxId}-error` : undefined;\n const successId = success ? `${comboboxId}-success` : undefined;\n\n const [uncontrolledOpen, setUncontrolledOpen] = React.useState(\n defaultOpen ?? false,\n );\n const [uncontrolledValue, setUncontrolledValue] = React.useState(() =>\n normalizeValue(defaultValue, multiple),\n );\n const [inputValue, setInputValue] = React.useState(\"\");\n const [createdOptions, setCreatedOptions] = React.useState([]);\n\n const open = controlledOpen ?? uncontrolledOpen;\n const selectedValue = value ?? uncontrolledValue;\n\n const authoredOptions = React.useMemo(() => flattenOptions(options), [options]);\n const localCreatedOptions = React.useMemo(() => {\n if (createdOptions.length === 0) return [];\n const authoredValues = new Set(authoredOptions.map((option) => option.value));\n return createdOptions.filter((option) => !authoredValues.has(option.value));\n }, [authoredOptions, createdOptions]);\n const flattenedOptions = React.useMemo(\n () =>\n localCreatedOptions.length > 0\n ? [...authoredOptions, ...localCreatedOptions]\n : authoredOptions,\n [authoredOptions, localCreatedOptions],\n );\n\n const resolvedStatus: ComboboxStatus =\n statusProp ?? (error ? \"error\" : success ? \"success\" : \"default\");\n\n const selectedValues = multiple\n ? Array.isArray(selectedValue)\n ? selectedValue\n : []\n : selectedValue\n ? [selectedValue as string]\n : [];\n\n const selectedOptions = flattenedOptions.filter((option) =>\n selectedValues.includes(option.value),\n );\n const selectableCount = countSelectableOptions(flattenedOptions);\n const hasSelection = selectedValues.length > 0;\n const allSelected =\n multiple && hasSelection && selectableCount > 0 && selectedValues.length >= selectableCount;\n\n const describedBy =\n [ariaDescribedBy, errorId, successId, hintId].filter(Boolean).join(\" \") ||\n undefined;\n\n const filterQuery = filter ? inputValue.trim().toLowerCase() : \"\";\n\n const filteredFlat = React.useMemo(() => {\n if (!filterQuery) return flattenedOptions;\n return flattenedOptions.filter((option) => {\n const labelText = getOptionLabelText(option).toLowerCase();\n const descriptionText =\n typeof option.description === \"string\"\n ? option.description.toLowerCase()\n : \"\";\n return (\n labelText.includes(filterQuery) ||\n option.value.toLowerCase().includes(filterQuery) ||\n descriptionText.includes(filterQuery)\n );\n });\n }, [filterQuery, flattenedOptions]);\n\n const canCreate =\n creatable &&\n inputValue.trim().length > 0 &&\n !flattenedOptions.some(\n (option) =>\n getOptionLabelText(option).toLowerCase() === inputValue.trim().toLowerCase() ||\n option.value.toLowerCase() === inputValue.trim().toLowerCase(),\n );\n\n const setOpen = React.useCallback(\n (next: boolean) => {\n if (controlledOpen === undefined) setUncontrolledOpen(next);\n onOpenChange?.(next);\n },\n [controlledOpen, onOpenChange],\n );\n\n const commitValue = React.useCallback(\n (next: string | string[]) => {\n if (value === undefined) setUncontrolledValue(next);\n onValueChange?.(next);\n },\n [onValueChange, value],\n );\n\n const performCreate = React.useCallback(() => {\n const trimmed = inputValue.trim();\n if (!trimmed || !creatable) return;\n\n const created = onCreateOption?.(trimmed) ?? {\n value: trimmed.toLowerCase().replace(/\\s+/g, \"-\"),\n label: trimmed,\n };\n\n if (!created) return;\n setCreatedOptions((current) =>\n current.some((option) => option.value === created.value) ? current : [...current, created],\n );\n\n if (multiple) {\n const current = Array.isArray(selectedValue) ? selectedValue : [];\n if (!current.includes(created.value)) {\n commitValue([...current, created.value]);\n }\n } else {\n commitValue(created.value);\n setOpen(false);\n }\n setInputValue(\"\");\n onSearchChange?.(\"\");\n }, [\n commitValue,\n creatable,\n inputValue,\n multiple,\n onCreateOption,\n onSearchChange,\n selectedValue,\n setOpen,\n ]);\n\n const handleValueChange = React.useCallback(\n (next: string | string[] | null) => {\n // Base UI reports `null` for single-select clear; normalize to \"\".\n const normalized = multiple\n ? Array.isArray(next)\n ? next\n : []\n : ((next as string | null) ?? \"\");\n\n if (multiple && Array.isArray(normalized) && normalized.includes(CREATE_SENTINEL)) {\n // Strip the sentinel; performCreate will add the real option below.\n performCreate();\n return;\n }\n if (!multiple && normalized === CREATE_SENTINEL) {\n performCreate();\n return;\n }\n\n commitValue(normalized);\n\n if (\n multiple &&\n Array.isArray(normalized) &&\n closeWhenAllSelected &&\n selectableCount > 0 &&\n normalized.length >= selectableCount\n ) {\n setOpen(false);\n } else if (!multiple) {\n setOpen(false);\n }\n },\n [\n closeWhenAllSelected,\n commitValue,\n multiple,\n performCreate,\n selectableCount,\n setOpen,\n ],\n );\n\n const handleInputValueChange = React.useCallback(\n (next: string) => {\n setInputValue(next);\n onSearchChange?.(next);\n },\n [onSearchChange],\n );\n\n const handleInputKeyDown = React.useCallback(\n (event: React.KeyboardEvent) => {\n if (\n event.key === \"Backspace\" &&\n multiple &&\n !inputValue &&\n selectedValues.length\n ) {\n commitValue(selectedValues.slice(0, -1));\n }\n },\n [commitValue, inputValue, multiple, selectedValues],\n );\n\n const multipleFieldSummary =\n multiple && !open\n ? buildMultipleFieldSummary(\n selectedOptions,\n selectedValues.length,\n selectableCount,\n )\n : null;\n\n const inputPlaceholder =\n open && multiple && hasSelection ? \"Search to add or remove…\" : placeholder;\n\n const adaptedOnValueChange = React.useCallback(\n (next: string | string[] | null) => {\n handleValueChange(next);\n },\n [handleValueChange],\n );\n\n const rootValue = multiple ? selectedValues : ((selectedValues[0] ?? null) as string | null);\n\n const renderOptionRow = (option: ComboboxOption) => {\n const isSelected = selectedValues.includes(option.value);\n return (\n \n {option.leading ? (\n \n {option.leading}\n \n ) : null}\n \n \n {option.label}\n \n {option.description ? (\n \n {option.description}\n \n ) : null}\n \n \n \n \n \n \n \n );\n };\n\n return (\n \n {label ? (\n \n {label}\n \n ) : null}\n\n handleInputValueChange(next)}\n // Disable Base UI internal filtering — we filter/render ourselves so\n // that grouped headings, creatable rows, and Backspace-clear-last\n // (multi mode) stay Wensity-owned.\n filter={null}\n autoHighlight\n multiple={multiple as false}\n value={rootValue as string | null}\n onValueChange={adaptedOnValueChange as (v: string | null) => void}\n >\n \n \n {leadingIcon ?? }\n \n\n
\n {multipleFieldSummary ? (\n \n {multipleFieldSummary}\n \n ) : null}\n\n \n
\n\n {multiple && hasSelection ? (\n \n {selectedValues.length}/{selectableCount}\n \n ) : null}\n\n {resolvedStatus === \"success\" && !allSelected ? (\n \n \n \n ) : null}\n {resolvedStatus === \"error\" ? (\n \n \n \n ) : null}\n\n {loading ? (\n \n \n \n ) : (\n \n \n \n \n \n )}\n \n\n \n \n \n {multiple && (filteredFlat.length > 0 || canCreate) ? (\n
\n \n {selectedValues.length} of {selectableCount} selected\n \n {allSelected ? (\n \n Complete\n \n ) : null}\n
\n ) : null}\n\n \n {loading && filteredFlat.length === 0 ? (\n \n \n Loading…\n \n ) : filteredFlat.length === 0 && !canCreate ? (\n \n {emptyMessage}\n \n ) : (\n <>\n {isGroupedOptions(options)\n ? options.map((group, groupIndex) => {\n const visible = group.options.filter((option) =>\n filteredFlat.some((match) => match.value === option.value),\n );\n if (visible.length === 0) return null;\n return (\n \n {group.label ? (\n \n {group.label}\n \n ) : null}\n {visible.map((option) => renderOptionRow(option))}\n \n );\n })\n : filteredFlat.map((option) => renderOptionRow(option))}\n\n {isGroupedOptions(options) && localCreatedOptions.length > 0\n ? localCreatedOptions\n .filter((option) =>\n filteredFlat.some((match) => match.value === option.value),\n )\n .map((option) => renderOptionRow(option))\n : null}\n\n {canCreate ? (\n \n \n \n \n \n {createLabel\n ? createLabel(inputValue.trim())\n : `Create \"${inputValue.trim()}\"`}\n \n \n ) : null}\n \n )}\n \n
\n \n
\n
\n\n {error ? (\n \n {error}\n

\n ) : success ? (\n \n {success}\n

\n ) : hint ? (\n

\n {hint}\n

\n ) : null}\n \n );\n}\n" } ], "cssVars": { "theme": { "font-sans": "var(--font-satoshi, ui-sans-serif, system-ui, -apple-system, Segoe UI, Roboto, Helvetica Neue, Arial, sans-serif)", "font-display": "var(--font-satoshi, ui-sans-serif, system-ui, -apple-system, Segoe UI, Roboto, Helvetica Neue, Arial, sans-serif)", "font-heading": "var(--font-cabinet, ui-sans-serif, system-ui, sans-serif)", "color-background": "var(--background)", "color-foreground": "var(--foreground)", "color-surface": "var(--surface)", "color-surface-muted": "var(--surface-muted)", "color-border": "var(--border)", "color-border-strong": "var(--border-strong)", "color-muted": "var(--muted)", "color-muted-foreground": "var(--muted-foreground)", "color-ring": "var(--ring)", "color-chili-50": "#fff1ee", "color-chili-100": "#ffe2db", "color-chili-200": "#ffa896", "color-chili-300": "#ff8a73", "color-chili-400": "#f15a45", "color-chili-500": "#cd1c18", "color-chili-600": "#b31614", "color-chili-700": "#9b1313", "color-chili-800": "#6a0d0e", "color-chili-900": "#38000a", "color-chili-950": "#1f0006", "color-primitive-surface-elevated": "var(--primitive-surface-elevated)", "color-primitive-surface-overlay": "var(--primitive-surface-overlay)", "color-primitive-surface-hover": "var(--primitive-surface-hover)", "color-primitive-surface-active": "var(--primitive-surface-active)", "color-primitive-surface-selected": "var(--primitive-surface-selected)", "color-primitive-border-subtle": "var(--primitive-border-subtle)", "color-primitive-ring": "var(--primitive-ring)", "color-primitive-text-secondary": "var(--primitive-text-secondary)", "color-primitive-text-placeholder": "var(--primitive-text-placeholder)", "color-primitive-text-inverse": "var(--primitive-text-inverse)", "color-primitive-destructive": "var(--primitive-destructive)", "color-primitive-destructive-hover": "var(--primitive-destructive-hover)", "color-primitive-destructive-active": "var(--primitive-destructive-active)", "color-primitive-destructive-foreground": "var(--primitive-destructive-foreground)", "color-primitive-destructive-surface": "var(--primitive-destructive-surface)", "color-primitive-destructive-border": "var(--primitive-destructive-border)", "color-primitive-success": "var(--primitive-success)", "color-primitive-warning": "var(--primitive-warning)", "color-primitive-info": "var(--primitive-info)", "color-primitive-control-solid": "var(--primitive-control-solid)", "color-primitive-control-solid-hover": "var(--primitive-control-solid-hover)", "color-primitive-control-solid-active": "var(--primitive-control-solid-active)", "color-primitive-control-solid-foreground": "var(--primitive-control-solid-foreground)", "color-primitive-chart-1": "var(--primitive-chart-1)", "color-primitive-chart-2": "var(--primitive-chart-2)", "color-primitive-chart-3": "var(--primitive-chart-3)", "color-primitive-chart-4": "var(--primitive-chart-4)", "color-primitive-chart-5": "var(--primitive-chart-5)", "color-primitive-chart-6": "var(--primitive-chart-6)", "radius-primitive": "var(--primitive-radius)", "radius-primitive-control": "var(--primitive-radius-control)", "radius-primitive-control-sm": "var(--primitive-radius-control-sm)", "radius-primitive-surface": "var(--primitive-radius-surface)", "radius-primitive-popup": "var(--primitive-radius-popup)", "radius-primitive-item": "var(--primitive-radius-item)", "font-primitive-sans": "var(--primitive-font-sans)", "font-primitive-display": "var(--primitive-font-display)", "font-primitive-mono": "var(--primitive-font-mono)", "spacing-primitive-control-height-sm": "var(--primitive-control-height-sm)", "spacing-primitive-control-height-md": "var(--primitive-control-height-md)", "spacing-primitive-control-height-lg": "var(--primitive-control-height-lg)" }, "light": { "background": "#fafafa", "foreground": "#0a0a0a", "surface": "#ffffff", "surface-muted": "#f4f4f5", "border": "rgba(10, 10, 10, 0.08)", "border-strong": "rgba(10, 10, 10, 0.16)", "muted": "#f4f4f5", "muted-foreground": "#52525b", "ring": "#cd1c18", "pattern-fg": "rgba(10, 10, 10, 0.07)", "llb-primary": "#18181b", "llb-primary-fg": "#ffffff", "llb-success": "#1f883d", "llb-error": "#cf222e", "primitive-surface-elevated": "#ffffff", "primitive-surface-overlay": "#ffffff", "primitive-surface-hover": "color-mix(in srgb, var(--foreground) 4%, transparent)", "primitive-surface-active": "color-mix(in srgb, var(--foreground) 7%, transparent)", "primitive-surface-selected": "color-mix(in srgb, var(--foreground) 6%, transparent)", "primitive-border-subtle": "color-mix(in srgb, var(--border) 60%, transparent)", "primitive-ring": "color-mix(in srgb, var(--foreground) 45%, transparent)", "primitive-text-secondary": "color-mix(in srgb, var(--foreground) 72%, transparent)", "primitive-text-placeholder": "color-mix(in srgb, var(--muted-foreground) 85%, transparent)", "primitive-radius": "0.75rem", "primitive-font-sans": "var(--font-sans)", "primitive-font-display": "var(--font-display)", "primitive-font-mono": "ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace", "primitive-control-solid": "#24292d", "primitive-control-solid-hover": "#2c3237", "primitive-control-solid-active": "#1e2326", "primitive-control-solid-foreground": "#ffffff", "primitive-chart-1": "#2a78d6", "primitive-chart-2": "#1baf7a", "primitive-chart-3": "#eda100", "primitive-chart-4": "#008300", "primitive-chart-5": "#4a3aa7", "primitive-chart-6": "#e34948", "primitive-text-inverse": "#ffffff", "primitive-text-hint": "0.6875rem", "primitive-destructive": "#dc2626", "primitive-destructive-hover": "#b91c1c", "primitive-destructive-active": "#991b1b", "primitive-destructive-foreground": "#ffffff", "primitive-destructive-surface": "rgba(220, 38, 38, 0.10)", "primitive-destructive-border": "rgba(220, 38, 38, 0.45)", "primitive-success": "#047857", "primitive-success-surface": "rgba(4, 120, 87, 0.10)", "primitive-success-border": "rgba(4, 120, 87, 0.45)", "primitive-warning": "#b45309", "primitive-warning-surface": "rgba(180, 83, 9, 0.10)", "primitive-warning-border": "rgba(180, 83, 9, 0.45)", "primitive-info": "#0369a1", "primitive-info-surface": "rgba(3, 105, 161, 0.10)", "primitive-info-border": "rgba(3, 105, 161, 0.45)", "primitive-radius-control": "var(--primitive-radius)", "primitive-radius-control-sm": "min(calc(var(--primitive-radius) * 0.8), 12px)", "primitive-radius-surface": "calc(var(--primitive-radius) * 1.4)", "primitive-radius-popup": "var(--primitive-radius)", "primitive-radius-item": "calc(var(--primitive-radius) * 0.8)", "primitive-control-height-sm": "2rem", "primitive-control-height-md": "2.25rem", "primitive-control-height-lg": "2.5rem", "primitive-shadow-raised": "0 1px 1px -0.5px rgba(10, 10, 10, 0.08), 0 2px 6px -2px rgba(10, 10, 10, 0.08)", "primitive-shadow-overlay": "0 2px 4px -1px rgba(10, 10, 10, 0.06), 0 8px 16px -4px rgba(10, 10, 10, 0.08), 0 16px 32px -8px rgba(10, 10, 10, 0.14)", "primitive-shadow-modal": "0 4px 8px -2px rgba(10, 10, 10, 0.06), 0 16px 32px -8px rgba(10, 10, 10, 0.12), 0 32px 64px -16px rgba(10, 10, 10, 0.2)", "primitive-edge": "rgba(10, 10, 10, 0.1)", "primitive-catchlight": "rgba(10, 10, 10, 0.06)", "primitive-groove-shadow": "rgba(10, 10, 10, 0.08)", "primitive-groove-highlight": "rgba(255, 255, 255, 0.85)", "primitive-shadow-drop": "0 1px 1px -0.5px rgba(10, 10, 10, 0.1), 0 2px 4px -1px rgba(10, 10, 10, 0.06)", "primitive-shadow-recess": "inset 0 2px 3px -1px rgba(10, 10, 10, 0.1)", "primitive-control-face": "var(--primitive-surface-elevated)", "primitive-field-face": "var(--primitive-surface-elevated)", "primitive-well": "rgba(10, 10, 10, 0.045)", "primitive-shadow-well": "inset 0 1px 2px 0 rgba(10, 10, 10, 0.06)", "primitive-tint-hover": "rgba(10, 10, 10, 0.045)", "primitive-tint-press": "rgba(10, 10, 10, 0.06)", "primitive-footer": "color-mix(in srgb, var(--primitive-surface-elevated) 97%, black)", "primitive-overlay-face": "var(--primitive-surface-overlay)", "primitive-frame-face": "color-mix(in srgb, var(--primitive-surface-elevated) 97%, black)", "primitive-z-overlay": "100", "primitive-z-popover": "130", "primitive-z-toast": "140", "primitive-backdrop": "rgba(0, 0, 0, 0.6)", "primitive-motion-fast": "80ms", "primitive-motion-fast-exit": "60ms", "primitive-motion-moderate": "160ms", "primitive-motion-moderate-exit": "120ms", "primitive-motion-slow": "240ms", "primitive-motion-slow-exit": "160ms", "primitive-ease": "cubic-bezier(0.23, 1, 0.32, 1)" }, "dark": { "background": "#0a0a0b", "foreground": "#f5f5f6", "surface": "#111113", "surface-muted": "#18181b", "border": "rgba(255, 255, 255, 0.08)", "border-strong": "rgba(255, 255, 255, 0.14)", "muted": "#1c1c1f", "muted-foreground": "#a1a1aa", "ring": "#cd1c18", "pattern-fg": "rgba(255, 255, 255, 0.06)", "llb-primary": "#f5f5f6", "llb-primary-fg": "#0a0a0b", "llb-success": "#2da44e", "llb-error": "#f85149", "primitive-surface-elevated": "#0f0f10", "primitive-surface-overlay": "#141415", "primitive-surface-hover": "color-mix(in srgb, var(--foreground) 5%, transparent)", "primitive-surface-active": "color-mix(in srgb, var(--foreground) 10%, transparent)", "primitive-surface-selected": "color-mix(in srgb, var(--foreground) 8%, transparent)", "primitive-border-subtle": "color-mix(in srgb, var(--border) 60%, transparent)", "primitive-ring": "color-mix(in srgb, var(--foreground) 45%, transparent)", "primitive-text-secondary": "color-mix(in srgb, var(--foreground) 72%, transparent)", "primitive-text-placeholder": "color-mix(in srgb, var(--muted-foreground) 85%, transparent)", "primitive-radius": "0.75rem", "primitive-font-sans": "var(--font-sans)", "primitive-font-display": "var(--font-display)", "primitive-font-mono": "ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace", "primitive-control-solid": "#f5f3ee", "primitive-control-solid-hover": "#ffffff", "primitive-control-solid-active": "#e8e4da", "primitive-control-solid-foreground": "#151719", "primitive-chart-1": "#3987e5", "primitive-chart-2": "#199e70", "primitive-chart-3": "#c98500", "primitive-chart-4": "#008300", "primitive-chart-5": "#9085e9", "primitive-chart-6": "#e66767", "primitive-text-inverse": "#151719", "primitive-text-hint": "0.6875rem", "primitive-destructive": "#e11d2e", "primitive-destructive-hover": "#c1121f", "primitive-destructive-active": "#a4161a", "primitive-destructive-foreground": "#ffffff", "primitive-destructive-surface": "rgba(225, 29, 46, 0.12)", "primitive-destructive-border": "rgba(225, 29, 46, 0.52)", "primitive-success": "#34d399", "primitive-success-surface": "rgba(52, 211, 153, 0.12)", "primitive-success-border": "rgba(52, 211, 153, 0.45)", "primitive-warning": "#fbbf24", "primitive-warning-surface": "rgba(251, 191, 36, 0.12)", "primitive-warning-border": "rgba(251, 191, 36, 0.45)", "primitive-info": "#38bdf8", "primitive-info-surface": "rgba(56, 189, 248, 0.12)", "primitive-info-border": "rgba(56, 189, 248, 0.45)", "primitive-radius-control": "var(--primitive-radius)", "primitive-radius-control-sm": "min(calc(var(--primitive-radius) * 0.8), 12px)", "primitive-radius-surface": "calc(var(--primitive-radius) * 1.4)", "primitive-radius-popup": "var(--primitive-radius)", "primitive-radius-item": "calc(var(--primitive-radius) * 0.8)", "primitive-control-height-sm": "2rem", "primitive-control-height-md": "2.25rem", "primitive-control-height-lg": "2.5rem", "primitive-shadow-raised": "inset 0 1px 0 0 rgba(255, 255, 255, 0.05), 0 1px 2px -1px rgba(0, 0, 0, 0.6), 0 2px 6px -2px rgba(0, 0, 0, 0.5)", "primitive-shadow-overlay": "inset 0 1px 0 0 rgba(255, 255, 255, 0.06), 0 2px 4px -1px rgba(0, 0, 0, 0.4), 0 8px 16px -4px rgba(0, 0, 0, 0.45), 0 16px 32px -8px rgba(0, 0, 0, 0.65)", "primitive-shadow-modal": "inset 0 1px 0 0 rgba(255, 255, 255, 0.06), 0 4px 8px -2px rgba(0, 0, 0, 0.4), 0 16px 32px -8px rgba(0, 0, 0, 0.55), 0 32px 64px -16px rgba(0, 0, 0, 0.75)", "primitive-edge": "rgba(255, 255, 255, 0.09)", "primitive-catchlight": "rgba(255, 255, 255, 0.16)", "primitive-groove-shadow": "rgba(0, 0, 0, 0.55)", "primitive-groove-highlight": "rgba(255, 255, 255, 0.05)", "primitive-shadow-drop": "0 1px 1px -0.5px rgba(0, 0, 0, 0.6), 0 2px 4px -1px rgba(0, 0, 0, 0.4)", "primitive-shadow-recess": "inset 0 2px 3px -1px rgba(0, 0, 0, 0.5)", "primitive-control-face": "var(--primitive-frame-face)", "primitive-field-face": "var(--primitive-frame-face)", "primitive-well": "rgba(0, 0, 0, 0.35)", "primitive-shadow-well": "inset 0 1px 2px 0 rgba(0, 0, 0, 0.45)", "primitive-tint-hover": "rgba(255, 255, 255, 0.06)", "primitive-tint-press": "rgba(0, 0, 0, 0.2)", "primitive-footer": "color-mix(in srgb, var(--primitive-surface-elevated) 97%, white)", "primitive-overlay-face": "color-mix(in srgb, var(--primitive-surface-overlay) 94%, white)", "primitive-frame-face": "color-mix(in srgb, var(--primitive-surface-elevated) 97%, white)", "primitive-z-overlay": "100", "primitive-z-popover": "130", "primitive-z-toast": "140", "primitive-backdrop": "rgba(0, 0, 0, 0.6)", "primitive-motion-fast": "80ms", "primitive-motion-fast-exit": "60ms", "primitive-motion-moderate": "160ms", "primitive-motion-moderate-exit": "120ms", "primitive-motion-slow": "240ms", "primitive-motion-slow-exit": "160ms", "primitive-ease": "cubic-bezier(0.23, 1, 0.32, 1)" } }, "css": { "@layer components": { "[data-surface]": { "--surface-tint": "transparent", "border-width": "1px", "border-style": "solid", "border-color": "var(--surface-rim)", "border-top-color": "var(--surface-rim-top)", "background-color": "var(--surface-face)", "background-image": "linear-gradient(var(--surface-tint), var(--surface-tint))", "--tw-shadow": "var(--surface-depth)", "box-shadow": "var(--tw-inset-shadow, 0 0 #0000), var(--tw-inset-ring-shadow, 0 0 #0000), var(--tw-ring-offset-shadow, 0 0 #0000), var(--tw-ring-shadow, 0 0 #0000), var(--tw-shadow)" }, "[data-surface=\"control\"]": { "--surface-face": "var(--primitive-control-face)", "--surface-rim": "var(--primitive-edge)", "--surface-rim-top": "var(--primitive-catchlight)", "--surface-depth": "var(--primitive-shadow-drop)" }, "[data-surface=\"field\"]": { "--surface-face": "var(--primitive-field-face)", "--surface-rim": "var(--primitive-edge)", "--surface-rim-top": "var(--primitive-catchlight)", "--surface-depth": "var(--primitive-shadow-drop)" }, "[data-surface=\"fill\"]": { "--surface-face": "var(--primitive-control-solid)", "--surface-rim": "color-mix(in srgb, var(--surface-face) 88%, black)", "--surface-rim-top": "color-mix(in srgb, var(--surface-face) 80%, white)", "--surface-depth": "var(--primitive-shadow-drop)" }, "[data-surface=\"flat\"], [data-surface=\"toggle\"], [data-surface=\"toggle-fill\"]": { "--surface-face": "transparent", "--surface-rim": "transparent", "--surface-rim-top": "transparent", "--surface-depth": "0 0 #0000" }, "[data-surface=\"toggle\"]:is([data-pressed]:not([data-pressed=\"false\"]), [aria-pressed=\"true\"])": { "--surface-face": "var(--primitive-control-face)", "--surface-rim": "var(--primitive-edge)", "--surface-rim-top": "var(--primitive-catchlight)", "--surface-depth": "var(--primitive-shadow-drop)" }, "[data-surface=\"toggle-fill\"]:is([data-pressed]:not([data-pressed=\"false\"]), [aria-pressed=\"true\"])": { "--surface-face": "var(--primitive-control-solid)", "--surface-rim": "color-mix(in srgb, var(--surface-face) 88%, black)", "--surface-rim-top": "color-mix(in srgb, var(--surface-face) 80%, white)", "--surface-depth": "var(--primitive-shadow-drop)" }, "[data-surface=\"well\"]": { "--surface-face": "var(--primitive-well)", "--surface-rim": "transparent", "--surface-rim-top": "transparent", "--surface-depth": "var(--primitive-shadow-well)" }, "[data-surface=\"frame\"]": { "--surface-face": "var(--primitive-frame-face)", "--surface-rim": "var(--primitive-edge)", "--surface-rim-top": "var(--primitive-catchlight)", "--surface-depth": "0 0 #0000" }, "[data-surface=\"panel\"]": { "--surface-face": "var(--primitive-surface-elevated)", "--surface-rim": "var(--primitive-edge)", "--surface-rim-top": "var(--primitive-edge)", "--surface-depth": "var(--primitive-shadow-raised)" }, "[data-surface=\"overlay\"]": { "--surface-face": "var(--primitive-overlay-face)", "--surface-rim": "var(--primitive-edge)", "--surface-rim-top": "var(--primitive-edge)", "--surface-depth": "var(--primitive-shadow-overlay)" }, "[data-surface=\"modal\"]": { "--surface-face": "var(--primitive-surface-elevated)", "--surface-rim": "var(--primitive-edge)", "--surface-rim-top": "var(--primitive-edge)", "--surface-depth": "var(--primitive-shadow-modal)" }, "[data-surface=\"footer\"]": { "--surface-face": "var(--primitive-footer)", "--surface-rim": "transparent", "--surface-rim-top": "transparent", "--surface-depth": "0 0 #0000", "border-width": "0", "background-image": "linear-gradient(to bottom, var(--primitive-groove-shadow) 0 1px, var(--primitive-groove-highlight) 1px 2px)", "background-size": "100% 2px", "background-repeat": "no-repeat", "background-position": "top" }, "@media (hover: hover)": { "[data-surface]:where(button, a[href], summary, label, [role=\"button\"], [role=\"tab\"], [role=\"combobox\"], [role=\"option\"], [role=\"menuitem\"]):where(:not(:disabled, [data-disabled], [aria-disabled=\"true\"])):hover": { "--surface-tint": "var(--primitive-tint-hover)" }, ":is([data-surface=\"control\"], [data-surface=\"field\"]):is([data-pressed]:not([data-pressed=\"false\"]), [aria-pressed=\"true\"]):where(:not(:disabled, [data-disabled], [aria-disabled=\"true\"])):hover": { "--surface-tint": "var(--primitive-tint-hover)" } }, ":is([data-surface=\"control\"], [data-surface=\"field\"]):is([data-pressed]:not([data-pressed=\"false\"]), [aria-pressed=\"true\"])": { "--surface-tint": "var(--primitive-tint-press)", "--surface-rim-top": "var(--surface-rim)", "--surface-depth": "var(--primitive-shadow-recess)" }, ":is([data-surface=\"control\"], [data-surface=\"field\"], [data-surface=\"fill\"], [data-surface=\"toggle\"], [data-surface=\"toggle-fill\"]):is([aria-expanded=\"true\"], [data-popup-open]):not(input, textarea)": { "--surface-tint": "var(--primitive-tint-press)", "--surface-rim-top": "var(--surface-rim)", "--surface-depth": "var(--primitive-shadow-recess)" }, ":is([data-surface=\"control\"], [data-surface=\"field\"], [data-surface=\"fill\"], [data-surface=\"toggle\"], [data-surface=\"toggle-fill\"]):where(button, a[href], summary, [role=\"button\"], [role=\"tab\"]):where(:not(:disabled, [data-disabled], [aria-disabled=\"true\"])):active": { "--surface-tint": "var(--primitive-tint-press)", "--surface-rim-top": "var(--surface-rim)", "--surface-depth": "var(--primitive-shadow-recess)" }, "[data-surface=\"flat\"]:where(button, a[href], summary, [role=\"button\"], [role=\"tab\"]):where(:not(:disabled, [data-disabled], [aria-disabled=\"true\"])):active": { "--surface-tint": "var(--primitive-tint-press)" }, "[data-surface]:is([aria-invalid=\"true\"], :has(> :is(input, textarea)[aria-invalid=\"true\"]))": { "--surface-rim": "var(--primitive-destructive-border)", "--surface-rim-top": "var(--primitive-destructive-border)" }, "[data-surface][data-surface]:is(:disabled, [data-disabled], [aria-disabled=\"true\"])": { "--surface-tint": "transparent", "--surface-rim-top": "var(--surface-rim)", "--surface-depth": "0 0 #0000" }, "[data-groove]": { "flex-shrink": "0", "border-width": "0", "background-image": "linear-gradient(var(--groove-direction, to bottom), var(--primitive-groove-shadow) 0 1px, var(--primitive-groove-highlight) 1px 2px)" }, "[data-groove=\"horizontal\"]": { "height": "2px" }, "[data-groove=\"vertical\"]": { "--groove-direction": "to right", "width": "2px", "align-self": "stretch" }, "[data-carve]": { "background-image": "linear-gradient(to bottom, var(--primitive-groove-shadow) 0 1px, var(--primitive-groove-highlight) 1px 2px)", "background-repeat": "no-repeat", "background-size": "100% 2px" }, "[data-carve=\"top\"]": { "background-position": "top" }, "[data-carve=\"bottom\"]": { "background-position": "bottom" } }, "@layer base": { ":where([data-wensity-primitive])": { "font-family": "var(--primitive-font-sans)" } }, "@utility scrollbar-hidden": { "scrollbar-width": "none", "-ms-overflow-style": "none", "&::-webkit-scrollbar": { "display": "none" } }, "@keyframes wensity-marquee-x": { "from": { "transform": "translate3d(0, 0, 0)" }, "to": { "transform": "translate3d(-50%, 0, 0)" } }, "@keyframes wensity-marquee-x-reverse": { "from": { "transform": "translate3d(-50%, 0, 0)" }, "to": { "transform": "translate3d(0, 0, 0)" } }, "@keyframes wensity-morph-rot-cw": { "from": { "transform": "rotate(0deg)" }, "to": { "transform": "rotate(360deg)" } }, "@keyframes wensity-morph-rot-ccw": { "from": { "transform": "rotate(0deg)" }, "to": { "transform": "rotate(-360deg)" } } }, "docs": "Free Wensity component. Installs to @components/wensity/combobox.tsx. For Pro components and updates, use pnpm dlx wensity@latest add combobox.", "categories": [ "UI Primitives", "wensity", "free" ], "meta": { "wensity": { "slug": "combobox", "access": "free", "category": "UI Primitives", "kind": "component", "componentUrl": "https://ui.wensity.com/primitives/combobox", "shadcnUrl": "https://ui.wensity.com/r/combobox", "cliInstall": "pnpm dlx wensity@latest add combobox" } } }