{ "name": "select", "displayName": "Select", "type": "component", "files": [ { "name": "Select.tsx", "content": "import {\n forwardRef,\n useCallback,\n useEffect,\n useId,\n useMemo,\n useRef,\n useState,\n type KeyboardEvent,\n} from 'react';\nimport { cn } from '../../utils/cn';\nimport styles from './Select.module.css';\n\nexport interface SelectOption {\n value: string;\n label: string;\n disabled?: boolean;\n group?: string;\n}\n\nexport interface SelectProps {\n label: string;\n options: SelectOption[];\n placeholder?: string;\n value?: string;\n defaultValue?: string;\n onChange?: (value: string) => void;\n disabled?: boolean;\n error?: string;\n helperText?: string;\n searchable?: boolean;\n id?: string;\n className?: string;\n 'data-testid'?: string;\n}\n\nexport const Select = forwardRef(\n function Select(\n {\n label,\n options,\n placeholder = 'Select…',\n value,\n defaultValue,\n onChange,\n disabled,\n error,\n helperText,\n searchable = false,\n id,\n className,\n 'data-testid': dataTestId = 'tatva-select',\n },\n ref,\n ) {\n const rid = useId();\n const triggerId = id ?? `${rid}-trigger`;\n const listboxId = `${rid}-listbox`;\n const [internal, setInternal] = useState(defaultValue);\n const current = value !== undefined ? value : internal;\n const setCurrent = (v: string) => {\n if (value === undefined) setInternal(v);\n onChange?.(v);\n };\n\n const [open, setOpen] = useState(false);\n const [query, setQuery] = useState('');\n const [activeIndex, setActiveIndex] = useState(-1);\n const rootRef = useRef(null);\n const searchRef = useRef(null);\n\n const filteredOptions = useMemo(() => {\n if (!searchable || !query) return options;\n const q = query.toLowerCase();\n return options.filter((o) => o.label.toLowerCase().includes(q));\n }, [options, query, searchable]);\n\n const groupedRender = useMemo(() => {\n const groups = new Map();\n for (const opt of filteredOptions) {\n const g = opt.group;\n const arr = groups.get(g) ?? [];\n arr.push(opt);\n groups.set(g, arr);\n }\n return groups;\n }, [filteredOptions]);\n\n // Flat list of visible options mapped to their linear index for keyboard nav.\n const flat = useMemo(() => filteredOptions, [filteredOptions]);\n\n useEffect(() => {\n if (!open) return;\n const handler = (e: MouseEvent) => {\n if (!rootRef.current?.contains(e.target as Node)) setOpen(false);\n };\n document.addEventListener('mousedown', handler);\n return () => document.removeEventListener('mousedown', handler);\n }, [open]);\n\n useEffect(() => {\n if (open && searchable) searchRef.current?.focus();\n }, [open, searchable]);\n\n useEffect(() => {\n if (open) {\n const idx = flat.findIndex((o) => o.value === current);\n setActiveIndex(idx >= 0 ? idx : 0);\n }\n }, [open, current, flat]);\n\n const selectedOption = options.find((o) => o.value === current);\n\n const commit = useCallback(\n (opt: SelectOption) => {\n if (opt.disabled) return;\n setCurrent(opt.value);\n setOpen(false);\n setQuery('');\n },\n // eslint-disable-next-line react-hooks/exhaustive-deps\n [onChange, value],\n );\n\n const move = (delta: number) => {\n if (flat.length === 0) return;\n let next = activeIndex;\n for (let i = 0; i < flat.length; i++) {\n next = (next + delta + flat.length) % flat.length;\n if (!flat[next].disabled) break;\n }\n setActiveIndex(next);\n };\n\n const handleListKey = (e: KeyboardEvent) => {\n if (e.key === 'ArrowDown') {\n e.preventDefault();\n move(1);\n } else if (e.key === 'ArrowUp') {\n e.preventDefault();\n move(-1);\n } else if (e.key === 'Enter') {\n e.preventDefault();\n const opt = flat[activeIndex];\n if (opt) commit(opt);\n } else if (e.key === 'Escape') {\n e.preventDefault();\n setOpen(false);\n } else if (!searchable && e.key.length === 1) {\n // Type-ahead\n const k = e.key.toLowerCase();\n const startIdx = flat.findIndex(\n (o, i) => i > activeIndex && o.label.toLowerCase().startsWith(k),\n );\n const idx =\n startIdx !== -1\n ? startIdx\n : flat.findIndex((o) => o.label.toLowerCase().startsWith(k));\n if (idx !== -1) setActiveIndex(idx);\n }\n };\n\n const handleTriggerKey = (e: KeyboardEvent) => {\n if (e.key === 'Escape' && open) {\n e.preventDefault();\n setOpen(false);\n return;\n }\n if (!open && ['Enter', ' ', 'ArrowDown', 'ArrowUp'].includes(e.key)) {\n e.preventDefault();\n setOpen(true);\n } else if (open) {\n handleListKey(e as unknown as KeyboardEvent);\n }\n };\n\n const rid2 = rid;\n\n return (\n
\n \n !disabled && setOpen((o) => !o)}\n onKeyDown={handleTriggerKey}\n data-testid={dataTestId}\n >\n \n {selectedOption?.label ?? placeholder}\n \n \n ▾\n \n \n\n {open && (\n
\n {searchable && (\n setQuery(e.target.value)}\n />\n )}\n \n {flat.length === 0 && (\n
  • No options
  • \n )}\n {Array.from(groupedRender.entries()).flatMap(\n ([groupName, opts]) => {\n const items = opts.map((opt) => {\n const idx = flat.indexOf(opt);\n const isActive = idx === activeIndex;\n const isSelected = opt.value === current;\n return (\n setActiveIndex(idx)}\n onMouseDown={(e) => {\n e.preventDefault();\n commit(opt);\n }}\n >\n {opt.label}\n \n );\n });\n if (groupName) {\n return [\n \n {groupName}\n ,\n ...items,\n ];\n }\n return items;\n },\n )}\n \n
    \n )}\n {helperText && !error && (\n {helperText}\n )}\n {error && (\n \n {error}\n \n )}\n
    \n );\n },\n);\n" }, { "name": "Select.module.css", "content": ".wrapper {\n position: relative;\n display: flex;\n flex-direction: column;\n gap: var(--tatva-space-1);\n font-family: var(--tatva-font-family);\n}\n\n.label {\n font-size: var(--tatva-font-size-sm);\n font-weight: var(--tatva-font-weight-medium);\n color: var(--tatva-color-fg);\n}\n\n.trigger {\n display: flex;\n align-items: center;\n justify-content: space-between;\n gap: var(--tatva-space-2);\n min-height: 40px;\n padding: 0 var(--tatva-space-3);\n background-color: var(--tatva-color-bg);\n border: 1px solid var(--tatva-color-border);\n border-radius: var(--tatva-radius-md);\n color: var(--tatva-color-fg);\n font-family: inherit;\n font-size: var(--tatva-font-size-md);\n cursor: pointer;\n text-align: left;\n transition:\n border-color var(--tatva-transition-fast),\n box-shadow var(--tatva-transition-fast);\n}\n\n.trigger:focus-visible,\n.open {\n outline: none;\n border-color: var(--tatva-color-primary-500);\n box-shadow: 0 0 0 3px var(--tatva-color-primary-200);\n}\n\n.hasError {\n border-color: var(--tatva-color-error);\n}\n\n.trigger:disabled {\n cursor: not-allowed;\n opacity: 0.55;\n}\n\n.placeholder {\n color: var(--tatva-color-fg-muted);\n}\n\n.caret {\n color: var(--tatva-color-fg-muted);\n font-size: var(--tatva-font-size-sm);\n}\n\n.popover {\n position: absolute;\n top: calc(100% + 4px);\n left: 0;\n right: 0;\n z-index: var(--tatva-z-dropdown);\n background-color: var(--tatva-color-bg);\n border: 1px solid var(--tatva-color-border);\n border-radius: var(--tatva-radius-md);\n box-shadow: var(--tatva-shadow-lg);\n max-height: 260px;\n overflow: hidden;\n display: flex;\n flex-direction: column;\n}\n\n.search {\n border: none;\n border-bottom: 1px solid var(--tatva-color-border);\n padding: var(--tatva-space-2) var(--tatva-space-3);\n background: transparent;\n color: var(--tatva-color-fg);\n font-family: inherit;\n font-size: var(--tatva-font-size-sm);\n outline: none;\n}\n\n.list {\n list-style: none;\n margin: 0;\n padding: var(--tatva-space-1) 0;\n overflow-y: auto;\n max-height: 220px;\n}\n\n.option {\n padding: var(--tatva-space-2) var(--tatva-space-3);\n cursor: pointer;\n color: var(--tatva-color-fg);\n font-size: var(--tatva-font-size-md);\n}\n\n.active {\n background-color: var(--tatva-color-primary-50);\n}\n\n.selected {\n background-color: var(--tatva-color-primary-100);\n font-weight: var(--tatva-font-weight-medium);\n}\n\n.optionDisabled {\n opacity: 0.5;\n cursor: not-allowed;\n}\n\n.groupHeader {\n padding: var(--tatva-space-2) var(--tatva-space-3) var(--tatva-space-1);\n font-size: var(--tatva-font-size-xs);\n text-transform: uppercase;\n color: var(--tatva-color-fg-muted);\n letter-spacing: 0.05em;\n}\n\n.empty {\n padding: var(--tatva-space-3);\n color: var(--tatva-color-fg-muted);\n text-align: center;\n}\n\n.helper {\n font-size: var(--tatva-font-size-xs);\n color: var(--tatva-color-fg-muted);\n}\n.error {\n font-size: var(--tatva-font-size-xs);\n color: var(--tatva-color-error);\n}\n" }, { "name": "index.ts", "content": "export { Select } from './Select';\nexport type { SelectProps, SelectOption } from './Select';\n" } ], "registryDependencies": [], "dependencies": [], "devDependencies": [] }