"use client"; import { memo, useState } from "react"; import { IconCheck, IconChevronDown, IconLoader2 } from "@tabler/icons-react"; import { cn } from "@/lib/utils"; import { Button } from "@kandev/ui/button"; import { Command, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, } from "@kandev/ui/command"; import { Popover, PopoverContent, PopoverTrigger } from "@kandev/ui/popover"; import { Tooltip, TooltipContent, TooltipTrigger } from "@kandev/ui/tooltip"; export type ComboboxOption = { value: string; label: string; description?: string; keywords?: string[]; renderLabel?: () => React.ReactNode; /** When true the option renders dimmed and isn't selectable. */ disabled?: boolean; /** Tooltip shown on hover when disabled is true. */ disabledReason?: string; }; // Custom filter compatible with cmdk's `` prop. // Returns a number in [0, 1]; >0 means the option is included, sorted desc. export type ComboboxFilter = (value: string, search: string, keywords?: string[]) => number; interface ComboboxProps { options: ComboboxOption[]; value: string; onValueChange: (value: string) => void; dropdownLabel?: string; placeholder?: string; searchPlaceholder?: string; emptyMessage?: string; disabled?: boolean; className?: string; triggerClassName?: string; showSearch?: boolean; testId?: string; popoverSide?: "top" | "right" | "bottom" | "left"; popoverAlign?: "start" | "center" | "end"; /** When true, the trigger always renders the plain label text instead of renderLabel. */ plainTrigger?: boolean; /** Optional custom filter; defaults to cmdk's built-in command-score. */ filter?: ComboboxFilter; /** Optional node rendered to the right of the dropdown label (e.g. refresh button). */ headerAction?: React.ReactNode; /** When true, swap the trigger chevron for a spinner to indicate loading. */ loading?: boolean; } function TriggerLabel({ selectedOption, plainTrigger, placeholder, }: { selectedOption: ComboboxOption | undefined; plainTrigger: boolean; placeholder: string; }) { if (!plainTrigger && selectedOption?.renderLabel) { return selectedOption.renderLabel(); } return {selectedOption?.label || placeholder}; } function OptionsList({ options, value, onSelect, }: { options: ComboboxOption[]; value: string; onSelect: (value: string) => void; }) { const enabled = options.filter((o) => !o.disabled); const disabled = options.filter((o) => o.disabled); const renderItem = (option: ComboboxOption) => { const item = ( !option.disabled && onSelect(option.value)} disabled={option.disabled} className={cn("relative pr-7", option.disabled && "opacity-40 cursor-not-allowed")} >
{option.renderLabel ? option.renderLabel() : option.label}
); // cmdk's CommandItem swallows pointer events with no native tooltip slot; // wrap disabled items in a Tooltip trigger so the disabled reason shows. if (option.disabled && option.disabledReason) { return (
{item}
{option.disabledReason}
); } return item; }; return ( <> {enabled.map(renderItem)} {disabled.length > 0 && ( <> {disabled.map(renderItem)} )} ); } export const Combobox = memo(function Combobox({ options, value, onValueChange, dropdownLabel, placeholder = "Select option...", searchPlaceholder = "Search...", emptyMessage = "No option found.", disabled = false, className, triggerClassName, showSearch = true, testId, popoverSide, popoverAlign = "start", plainTrigger = false, filter, headerAction, loading = false, }: ComboboxProps) { const [open, setOpen] = useState(false); // Track the highlighted item. Defaults to the selected value so the current // selection is highlighted when the popover opens (not the first item). const [highlighted, setHighlighted] = useState(""); const selectedOption = options.find((option) => option.value === value); return ( { setOpen(next); if (next) setHighlighted(value); }} > {dropdownLabel || headerAction ? (
{dropdownLabel} {headerAction}
) : null} {showSearch && } {emptyMessage} { onValueChange(v === value ? "" : v); setOpen(false); }} />
); });