"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, } 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 DisabledOptionItem({ option }: { option: ComboboxOption }) { // cmdk's CommandItem swallows pointer events with no native tooltip slot, so // we wrap the disabled item in a Tooltip trigger. The trigger is a plain // div; CommandItem still owns keyboard nav and rendering. const item = (
{option.renderLabel ? option.renderLabel() : option.label}
); if (!option.disabledReason) return item; return (
{item}
{option.disabledReason}
); } function OptionsList({ options, value, onSelect, }: { options: ComboboxOption[]; value: string; onSelect: (value: string) => void; }) { return ( {options.map((option) => option.disabled ? ( ) : ( onSelect(option.value)} className="relative pr-7" >
{option.renderLabel ? option.renderLabel() : option.label}
), )}
); } 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); }} />
); });