{"$schema":"https://ui.shadcn.com/schema/registry-item.json","name":"combobox","type":"registry:ui","title":"Combobox","description":"Search and select from a list without leaving the field.","categories":["inputs"],"dependencies":["lucide-react","motion"],"registryDependencies":["https://ui.teamofsilicons.com/r/silicon-motion-tokens.json"],"files":[{"path":"registry/components/combobox/combobox.tsx","type":"registry:component","target":"@components/silicon-ui/combobox/combobox.tsx","content":"\"use client\";\n\nimport { animate, AnimatePresence, motion, useReducedMotion } from \"motion/react\";\nimport { Check, ChevronDown, Search, X } from \"lucide-react\";\nimport {\n  forwardRef,\n  useEffect,\n  useId,\n  useImperativeHandle,\n  useMemo,\n  useRef,\n  useState,\n} from \"react\";\nimport type { InputHTMLAttributes, KeyboardEvent, MouseEvent as ReactMouseEvent, ReactNode } from \"react\";\nimport { motionTokens } from \"../lib/motion-tokens\";\nimport { useNearestItem } from \"../lib/fluid-hover\";\nimport styles from \"./combobox.module.css\";\n\nexport interface ComboboxOption {\n  value: string;\n  label: string;\n  disabled?: boolean;\n  keywords?: string[];\n}\n\nexport interface ComboboxProps\n  extends Omit<InputHTMLAttributes<HTMLInputElement>, \"value\" | \"defaultValue\" | \"onChange\" | \"placeholder\"> {\n  label: string;\n  options: ComboboxOption[];\n  value?: string;\n  defaultValue?: string;\n  onValueChange?: (value: string) => void;\n  description?: string;\n  placeholder?: string;\n  emptyMessage?: string;\n  className?: string;\n}\n\n/** Follows the listbox height with a critically damped spring, so filtering never snaps the menu. */\nfunction AutoHeight({ children, reduceMotion }: { children: ReactNode; reduceMotion: boolean | null }) {\n  const innerRef = useRef<HTMLDivElement>(null);\n  const [height, setHeight] = useState<number | \"auto\">(\"auto\");\n  useEffect(() => {\n    const inner = innerRef.current;\n    if (!inner) return;\n    const observer = new ResizeObserver(() => setHeight(inner.offsetHeight));\n    observer.observe(inner);\n    return () => observer.disconnect();\n  }, []);\n  return <motion.div className={styles.autoHeight} initial={false} animate={{ height }} transition={reduceMotion ? { duration: 0 } : motionTokens.spring.smooth}><div ref={innerRef}>{children}</div></motion.div>;\n}\n\nexport const Combobox = forwardRef<HTMLInputElement, ComboboxProps>(function Combobox(\n  {\n    label,\n    options,\n    value: controlledValue,\n    defaultValue = \"\",\n    onValueChange,\n    description,\n    placeholder = \"Search or select…\",\n    emptyMessage = \"No matches found\",\n    id,\n    className,\n    disabled,\n    onBlur,\n    ...inputProps\n  },\n  forwardedRef,\n) {\n  const generatedId = useId();\n  const controlId = id ?? generatedId;\n  const listboxId = `${controlId}-listbox`;\n  const hintId = description ? `${controlId}-description` : undefined;\n  const rootRef = useRef<HTMLDivElement>(null);\n  const inputRef = useRef<HTMLInputElement>(null);\n  const optionRefs = useRef<Record<string, HTMLDivElement | null>>({});\n  const reduceMotion = useReducedMotion();\n  const [uncontrolledValue, setUncontrolledValue] = useState(defaultValue);\n  const [open, setOpen] = useState(false);\n  const [query, setQuery] = useState(\"\");\n  const [activeIndex, setActiveIndex] = useState(-1);\n  // Fluid hover: the mouse makes the nearest option active, gaps and padding included, and a click there picks it.\n  // The listbox keeps focus in the input, so a press in its padding never closes the popover.\n  const nearest = useNearestItem<HTMLDivElement>({ items: '[role=\"option\"]', onPick: (item) => setActiveIndex(Number(item.dataset.index)) });\n  const selectedValue = controlledValue ?? uncontrolledValue;\n  const selectedOption = options.find((option) => option.value === selectedValue);\n\n  useImperativeHandle(forwardedRef, () => inputRef.current as HTMLInputElement);\n\n  // A chosen label settles into the field: it rises in from below with a soft blur. Clearing fades the\n  // placeholder in instead of snapping from the old label.\n  const settledValue = useRef(selectedValue);\n  useEffect(() => {\n    if (settledValue.current === selectedValue) return;\n    settledValue.current = selectedValue;\n    const input = inputRef.current;\n    if (!input || reduceMotion || (selectedValue && open)) return;\n    const controls = selectedValue\n      ? animate(input, { opacity: [0, 1], y: [\"0.35em\", \"0em\"], filter: [`blur(${motionTokens.blur.soft}px)`, \"blur(0px)\"] }, { duration: motionTokens.duration.standard, ease: [...motionTokens.ease.enter] })\n      : animate(input, { opacity: [0, 1] }, { duration: motionTokens.duration.fast, ease: [...motionTokens.ease.enter] });\n    return () => controls.complete();\n  }, [selectedValue, reduceMotion, open]);\n\n  const filteredOptions = useMemo(() => {\n    const normalizedQuery = query.trim().toLocaleLowerCase();\n    if (!normalizedQuery) return options;\n    return options.filter((option) =>\n      [option.label, ...(option.keywords ?? [])].some((term) => term.toLocaleLowerCase().includes(normalizedQuery)),\n    );\n  }, [options, query]);\n\n  const enabledIndices = filteredOptions.reduce<number[]>((indices, option, index) => {\n    if (!option.disabled) indices.push(index);\n    return indices;\n  }, []);\n\n  useEffect(() => {\n    if (!open) return;\n    const activeOption = activeIndex >= 0 ? filteredOptions[activeIndex] : undefined;\n    const option = activeOption ? optionRefs.current[activeOption.value] : null;\n    const listbox = option?.parentElement;\n    if (option && listbox) {\n      const top = option.offsetTop;\n      const bottom = top + option.offsetHeight;\n      if (top < listbox.scrollTop) listbox.scrollTop = top;\n      else if (bottom > listbox.scrollTop + listbox.clientHeight) listbox.scrollTop = bottom - listbox.clientHeight;\n    }\n  }, [activeIndex, filteredOptions, open]);\n\n  useEffect(() => {\n    const handlePointerDown = (event: PointerEvent) => {\n      if (rootRef.current && !rootRef.current.contains(event.target as Node)) {\n        setOpen(false);\n        setQuery(\"\");\n      }\n    };\n    document.addEventListener(\"pointerdown\", handlePointerDown);\n    return () => document.removeEventListener(\"pointerdown\", handlePointerDown);\n  }, []);\n\n  const choose = (option: ComboboxOption) => {\n    if (option.disabled) return;\n    setUncontrolledValue(option.value);\n    onValueChange?.(option.value);\n    setQuery(\"\");\n    setOpen(false);\n    inputRef.current?.focus();\n  };\n\n  const clear = (event: ReactMouseEvent<HTMLButtonElement>) => {\n    event.preventDefault();\n    setUncontrolledValue(\"\");\n    onValueChange?.(\"\");\n    setQuery(\"\");\n    setOpen(true);\n    inputRef.current?.focus();\n  };\n\n  const openMenu = () => {\n    if (disabled) return;\n    setOpen(true);\n    setQuery(\"\");\n    setActiveIndex(-1);\n  };\n\n  const handleKeyDown = (event: KeyboardEvent<HTMLInputElement>) => {\n    if (disabled) return;\n    if (event.key === \"ArrowDown\" || event.key === \"ArrowUp\") {\n      event.preventDefault();\n      if (!open) {\n        openMenu();\n        return;\n      }\n      if (!enabledIndices.length) return;\n      const currentPosition = enabledIndices.indexOf(activeIndex);\n      const nextPosition = event.key === \"ArrowDown\"\n        ? (currentPosition + 1) % enabledIndices.length\n        : (currentPosition - 1 + enabledIndices.length) % enabledIndices.length;\n      setActiveIndex(enabledIndices[nextPosition]!);\n      return;\n    }\n    if (event.key === \"Enter\" && open && activeIndex >= 0) {\n      event.preventDefault();\n      const option = filteredOptions[activeIndex];\n      if (option) choose(option);\n      return;\n    }\n    if (event.key === \"Escape\" && open) {\n      event.preventDefault();\n      setOpen(false);\n      setQuery(\"\");\n      return;\n    }\n  };\n\n  const inputValue = open ? query : selectedOption?.label ?? \"\";\n  const activeOption = activeIndex >= 0 ? filteredOptions[activeIndex] : undefined;\n\n  return (\n    <div ref={rootRef} className={styles.field}>\n      <label htmlFor={controlId}>{label}</label>\n      <div className={[styles.control, open ? styles.open : \"\", disabled ? styles.disabled : \"\", className ?? \"\"].filter(Boolean).join(\" \")}>\n        <Search className={styles.searchIcon} size={16} strokeWidth={1.75} aria-hidden=\"true\" />\n        <input\n          {...inputProps}\n          ref={inputRef}\n          id={controlId}\n          type=\"text\"\n          role=\"combobox\"\n          value={inputValue}\n          // While searching, the chosen label stays in place as muted placeholder copy instead of vanishing.\n          placeholder={selectedOption?.label ?? placeholder}\n          disabled={disabled}\n          aria-describedby={hintId}\n          aria-expanded={open}\n          aria-controls={open ? listboxId : undefined}\n          aria-autocomplete=\"list\"\n          aria-activedescendant={open && activeOption ? `${controlId}-option-${activeOption.value}` : undefined}\n          // WAI-ARIA combobox: focus alone never opens the list (a Tab walk through a form would drop it over the next\n          // fields); typing, ArrowDown/ArrowUp or a click do. Leaving the field closes it, so it never stays open\n          // behind focus.\n          onBlur={(event) => {\n            onBlur?.(event);\n            // Focus moving anywhere but into the list (the next field, or the field's own Clear button) closes it.\n            const next = event.relatedTarget as Node | null;\n            if (open && next && !document.getElementById(listboxId)?.contains(next)) {\n              setOpen(false);\n              setQuery(\"\");\n            }\n          }}\n          onClick={openMenu}\n          onChange={(event) => {\n            setQuery(event.target.value);\n            setOpen(true);\n            setActiveIndex(-1);\n          }}\n          onKeyDown={handleKeyDown}\n        />\n        <AnimatePresence initial={false}>\n          {selectedOption && !disabled && (\n            <motion.button\n              type=\"button\"\n              className={styles.clear}\n              aria-label=\"Clear selection\"\n              onMouseDown={event => event.preventDefault()}\n              onClick={clear}\n              initial={reduceMotion ? { opacity: 0 } : { opacity: 0, scale: 0.6, filter: `blur(${motionTokens.blur.subtle}px)` }}\n              animate={{ opacity: 1, scale: 1, filter: \"blur(0px)\", transition: reduceMotion ? { duration: motionTokens.duration.instant } : { ...motionTokens.spring.snappy, opacity: { duration: motionTokens.duration.fast } } }}\n              exit={{ opacity: 0, ...(reduceMotion ? {} : { scale: 0.6, filter: `blur(${motionTokens.blur.subtle}px)` }), transition: { duration: motionTokens.duration.instant, ease: [...motionTokens.ease.standard] } }}\n              whileTap={{ scale: reduceMotion ? 1 : 0.96, transition: { duration: motionTokens.duration.instant, ease: [...motionTokens.ease.standard] } }}\n            >\n              <X size={16} strokeWidth={1.75} aria-hidden=\"true\" />\n            </motion.button>\n          )}\n        </AnimatePresence>\n        <ChevronDown className={styles.chevron} size={16} strokeWidth={1.75} aria-hidden=\"true\" />\n      </div>\n      {description && <span id={hintId} className={styles.hint}>{description}</span>}\n      <AnimatePresence initial={false}>\n        {open && (\n          <motion.div\n            className={styles.popover}\n            initial={reduceMotion ? { opacity: 0 } : { opacity: 0, y: -6, scale: 0.97 }}\n            animate={{ opacity: 1, y: 0, scale: 1, transition: reduceMotion ? { duration: motionTokens.duration.instant } : { ...motionTokens.spring.snappy, opacity: { duration: motionTokens.duration.fast, ease: [...motionTokens.ease.enter] } } }}\n            exit={{ opacity: 0, ...(reduceMotion ? {} : { y: -4, scale: 0.98 }), transition: { duration: motionTokens.duration.instant, ease: [...motionTokens.ease.standard] } }}\n            role=\"presentation\"\n          >\n            <AutoHeight reduceMotion={reduceMotion}>\n            {/* Not a Tab stop (it scrolls, so browsers would make it one): the arrow keys move through its options. */}\n            <div id={listboxId} className={styles.listbox} role=\"listbox\" aria-label={`${label} options`} tabIndex={-1} onMouseDown={(event) => event.preventDefault()} {...nearest}>\n              {filteredOptions.length ? filteredOptions.map((option, index) => (\n                <div\n                  key={option.value}\n                  ref={(element) => { optionRefs.current[option.value] = element; }}\n                  id={`${controlId}-option-${option.value}`}\n                  className={styles.option}\n                  data-active={index === activeIndex ? \"true\" : undefined}\n                  data-disabled={option.disabled ? \"true\" : undefined}\n                  role=\"option\"\n                  aria-selected={option.value === selectedValue}\n                  aria-disabled={option.disabled || undefined}\n                  onMouseDown={(event) => event.preventDefault()}\n                  data-index={index}\n                  onClick={() => choose(option)}\n                >\n                  <span>{option.label}</span>\n                  {option.value === selectedValue && <Check className={styles.check} size={16} strokeWidth={1.75} aria-hidden=\"true\" />}\n                </div>\n              )) : <motion.div className={styles.empty} role=\"status\" initial={reduceMotion ? false : { opacity: 0, y: 4, filter: `blur(${motionTokens.blur.soft}px)` }} animate={{ opacity: 1, y: 0, filter: \"blur(0px)\" }} transition={{ duration: motionTokens.duration.standard, ease: [...motionTokens.ease.enter] }}>{emptyMessage}</motion.div>}\n            </div>\n            </AutoHeight>\n          </motion.div>\n        )}\n      </AnimatePresence>\n    </div>\n  );\n});\n\nCombobox.displayName = \"Combobox\";\n"},{"path":"registry/components/combobox/combobox.module.css","type":"registry:component","target":"@components/silicon-ui/combobox/combobox.module.css","content":".field { position: relative; display: grid; gap: var(--space-related); min-width: 0; }\n.field label { font-size: var(--text-sm); font-weight: 500; letter-spacing: var(--tracking-body); }\n.control { position: relative; z-index: 2; display: flex; min-height: var(--control-height-md); align-items: center; gap: var(--space-related); border: 1px solid var(--border); border-radius: var(--radius-control); padding: 0 var(--space-group); background: var(--surface); color: var(--foreground); transition: border-color var(--duration-fast) var(--ease-standard), background-color var(--duration-fast) var(--ease-standard), box-shadow var(--duration-fast) var(--ease-standard); }\n@media (hover: hover) and (pointer: fine) { .control:hover:not(.disabled) { border-color: var(--border-strong); background: var(--surface-muted); } }\n.control:focus-within { border-color: var(--accent); box-shadow: 0 0 0 3px var(--focus-ring); }\n.control.open { border-color: var(--border-strong); background: var(--surface-muted); }\n.control.disabled { opacity: .5; cursor: not-allowed; }\n.searchIcon { flex: 0 0 auto; color: var(--text-muted); }\n.control input { width: 100%; min-width: 0; border: 0; outline: 0; padding: 0; background: transparent; color: var(--foreground); font: inherit; font-size: var(--field-text-size, var(--text-sm)); }\n.control input:focus-visible { outline: none; }\n.control input::placeholder { color: var(--text-muted); }\n.chevron { flex: 0 0 auto; color: var(--text-muted); transition: transform var(--duration-spring) var(--ease-spring); }\n.open .chevron { transform: rotate(180deg); }\n.clear { display: grid; width: 22px; height: 22px; flex: 0 0 auto; place-items: center; border: 0; border-radius: var(--radius-control); background: transparent; color: var(--text-muted); cursor: pointer; transition: background-color var(--duration-fast) var(--ease-standard), color var(--duration-fast) var(--ease-standard); }\n@media (hover: hover) and (pointer: fine) { .clear:hover { background: var(--surface-muted); color: var(--foreground); } }\n.clear:focus-visible { --focus-outline-offset: 1px; }\n.hint { color: var(--field-hint-colour, var(--text-muted)); font-size: var(--field-hint-size, var(--text-xs)); letter-spacing: var(--tracking-body); }\n.popover { position: absolute; z-index: var(--layer-dropdown); top: calc(100% + var(--space-related)); right: 0; left: 0; overflow: hidden; transform-origin: top center; border: 1px solid var(--border); border-radius: var(--radius-container); padding: var(--space-tight); background: var(--surface-raised); color: var(--foreground); box-shadow: var(--shadow-floating); will-change: transform, opacity; }\n.autoHeight { overflow: hidden; }\n.listbox { max-height: min(300px, 40vh); overflow-y: auto; overscroll-behavior: contain; }\n/* Arrow keys move the highlight often, so it changes almost instantly. */\n.option { display: flex; min-height: 36px; align-items: center; justify-content: space-between; gap: var(--space-group); border-radius: calc(var(--radius-container) - var(--space-tight)); padding: 0 var(--space-group); color: var(--foreground); font-size: var(--text-sm); cursor: pointer; outline: none; user-select: none; transition: background-color 80ms var(--ease-standard), color 80ms var(--ease-standard); }\n.option > span:first-child { min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }\n.option[data-active=\"true\"] { background: var(--surface-muted); }\n.option[data-disabled=\"true\"] { opacity: .42; cursor: not-allowed; }\n.check { flex: 0 0 auto; color: var(--foreground); }\n.empty { padding: var(--space-group); color: var(--text-muted); font-size: var(--text-sm); }\n@media (prefers-reduced-motion: reduce) { .control, .chevron, .clear, .option { transition: none; } }\n"},{"path":"lib/fluid-hover.tsx","type":"registry:lib","target":"@components/silicon-ui/lib/fluid-hover.tsx","content":"\"use client\";\n\n/**\n * Fluid hover: in a set of items (a menu, a list, tabs, a grid), the item nearest the pointer is lit, even while the\n * pointer is in a gap, the padding or past the last item, and one highlight springs between items. A click in a gap goes\n * to the lit item, so what is lit is what a click hits. A new pointer entry fades the highlight in where it lands instead\n * of sliding it over from the last item. The keyboard moves it without travel, and reduced motion keeps the fade but\n * drops the travel.\n *\n *   const list = useRef<HTMLUListElement>(null);\n *   const hover = useFluidHover(list, { items: \"[data-item]\" });\n *   <ul ref={list} className={styles.list} {...hover.handlers}>      // .list { position: relative }\n *     <FluidHoverHighlight hover={hover} className={styles.highlight} />\n *     …items…\n *   </ul>\n *\n * Adapted from Fluid Functionalism's use-fluid-hover and fluid-hover-highlight by Micka Touillaud (MIT),\n * https://github.com/mickadesign/fluid-functionalism. Items are found by a selector instead of registering themselves,\n * so a component adopts it without changing its items.\n */\nimport { useEffect, useEffectEvent, useRef, useState } from \"react\";\nimport type { FocusEvent, MouseEvent, PointerEvent, RefObject } from \"react\";\nimport { AnimatePresence, motion, useReducedMotion } from \"motion/react\";\nimport { motionTokens } from \"./motion-tokens\";\n\n/** An item's box in the container's own layout space (unaffected by transforms or scrolling). */\nexport interface FluidRect { top: number; left: number; width: number; height: number }\n\nexport interface FluidHoverState {\n  /** Where the highlight sits, or null when nothing is lit. */\n  rect: FluidRect | null;\n  /** The lit item. */\n  item: HTMLElement | null;\n  /** False when the highlight should jump (keyboard, a resize) rather than travel. */\n  glide: boolean;\n  /** Steps on each new pointer entry, so the highlight fades in where it lands. */\n  session: number;\n}\n\nexport interface FluidHoverOptions {\n  /** Selector for the items inside the container. */\n  items: string;\n  /** \"y\" for lists (default), \"x\" for a row of tabs, \"xy\" for grids. */\n  axis?: \"x\" | \"y\" | \"xy\";\n  /** Items the highlight skips (and a gap click never activates). Defaults to disabled or aria-disabled items. */\n  isItemDisabled?: (item: HTMLElement) => boolean;\n  /** \"skip\" (default) lights the nearest enabled item even over a disabled one; \"clear\" lights nothing over a disabled item (a calendar's unavailable days). */\n  disabled?: \"skip\" | \"clear\";\n  /** Route a click in a gap to the lit item. On by default; turn it off where empty space should stay inert. */\n  gapClick?: boolean;\n  /** Light the item that receives keyboard focus. On by default. */\n  followFocus?: boolean;\n}\n\nconst defaultDisabled = (item: HTMLElement) =>\n  item.matches(\":disabled, [aria-disabled='true'], [data-disabled]\");\n\n/** Controls that sit between items keep their own clicks. */\nconst CONTROL = \"input, textarea, select, button, a, summary, [contenteditable], [role='textbox'], [role='searchbox'], [role='button']\";\n\n/** The item's box relative to the container, summing offsets through positioned ancestors in between. */\nexport function rectOf(item: HTMLElement, container: HTMLElement): FluidRect {\n  let top = item.offsetTop, left = item.offsetLeft;\n  let parent = item.offsetParent as HTMLElement | null;\n  while (parent && parent !== container && container.contains(parent)) {\n    top += parent.offsetTop + parent.clientTop;\n    left += parent.offsetLeft + parent.clientLeft;\n    parent = parent.offsetParent as HTMLElement | null;\n  }\n  return { top, left, width: item.offsetWidth, height: item.offsetHeight };\n}\n\n/**\n * The item the pointer is inside, or else the one whose edge is nearest along the axis (both axes for a grid). Edges, not\n * centres, so a gap next to a wide item still lights the item the pointer is closer to.\n */\nexport function pickNearest(items: HTMLElement[], x: number, y: number, axis: \"x\" | \"y\" | \"xy\"): HTMLElement | null {\n  let nearest: HTMLElement | null = null, best = Infinity;\n  for (const item of items) {\n    const r = item.getBoundingClientRect();\n    if (!r.width && !r.height) continue;\n    if (x >= r.left && x <= r.right && y >= r.top && y <= r.bottom) return item;\n    const dx = Math.max(r.left - x, 0, x - r.right), dy = Math.max(r.top - y, 0, y - r.bottom);\n    const distance = axis === \"x\" ? dx : axis === \"y\" ? dy : Math.hypot(dx, dy);\n    if (distance < best) { best = distance; nearest = item; }\n  }\n  return nearest;\n}\n\n/** Hands a gap click to the item as a real mouse click (detail, modifiers and coordinates kept), so the item reads it as a pointer press, not a keyboard one. */\nfunction forwardClick(item: HTMLElement, event: MouseEvent<HTMLElement>) {\n  const { detail, clientX, clientY, screenX, screenY, ctrlKey, shiftKey, altKey, metaKey, button, buttons } = event;\n  item.dispatchEvent(new globalThis.MouseEvent(\"click\", { bubbles: true, cancelable: true, composed: true, view: window, detail, clientX, clientY, screenX, screenY, ctrlKey, shiftKey, altKey, metaKey, button, buttons }));\n}\n\n/** Whether an event happened inside the element whose handler hears it, not in a portalled child (a submenu, a tooltip). */\nconst isOwn = (event: { currentTarget: EventTarget; target: EventTarget }) =>\n  !(event.currentTarget instanceof Node) || !(event.target instanceof Node) || event.currentTarget.contains(event.target);\n\nexport function useFluidHover<T extends HTMLElement>(container: RefObject<T | null>, options: FluidHoverOptions) {\n  const { items: selector, axis = \"y\", isItemDisabled = defaultDisabled, disabled = \"skip\", gapClick = true, followFocus = true } = options;\n  const [state, setState] = useState<FluidHoverState>({ rect: null, item: null, glide: false, session: 0 });\n  const current = useRef(state);\n  const pointer = useRef(false);\n  const entering = useRef(false);\n  const frame = useRef(0);\n\n  function commit(next: FluidHoverState) {\n    const prev = current.current;\n    if (prev.item === next.item && prev.session === next.session && sameRect(prev.rect, next.rect)) return;\n    current.current = next;\n    setState(next);\n  }\n\n  function light(item: HTMLElement | null, glide: boolean) {\n    const root = container.current;\n    if (!root || !item) return commit({ ...current.current, rect: null, item: null, glide });\n    let session = current.current.session;\n    if (entering.current) { entering.current = false; session += 1; }\n    commit({ rect: rectOf(item, root), item, glide: glide && session === current.current.session, session });\n  }\n\n  const enabledItems = () => {\n    const root = container.current;\n    return root ? [...root.querySelectorAll<HTMLElement>(selector)].filter(item => !isItemDisabled(item)) : [];\n  };\n\n  // The lit item can move under a still highlight (a resize, content above it changing): follow it without travel.\n  const follow = useEffectEvent(() => { const { item } = current.current; if (item?.isConnected) light(item, false); });\n  useEffect(() => {\n    const root = container.current;\n    if (!root || typeof ResizeObserver === \"undefined\") return;\n    const observer = new ResizeObserver(() => follow());\n    observer.observe(root);\n    return () => observer.disconnect();\n  }, [container]);\n  useEffect(() => () => cancelAnimationFrame(frame.current), []);\n\n  const handlers = {\n    onMouseEnter: () => { entering.current = true; },\n    onMouseMove: (event: MouseEvent<T>) => {\n      if (!isOwn(event)) return;\n      pointer.current = true;\n      const { clientX, clientY } = event;\n      cancelAnimationFrame(frame.current);\n      frame.current = requestAnimationFrame(() => {\n        const over = disabled === \"clear\" ? document.elementFromPoint(clientX, clientY)?.closest<HTMLElement>(selector) : null;\n        light(over && isItemDisabled(over) ? null : pickNearest(enabledItems(), clientX, clientY, axis), true);\n      });\n    },\n    onMouseLeave: () => { cancelAnimationFrame(frame.current); entering.current = false; light(null, false); },\n    onKeyDownCapture: () => { pointer.current = false; },\n    onFocus: (event: FocusEvent<T>) => {\n      if (!followFocus || pointer.current || !isOwn(event)) return;\n      const item = event.target instanceof HTMLElement ? event.target.closest<HTMLElement>(selector) : null;\n      if (item && container.current?.contains(item) && !isItemDisabled(item)) light(item, false);\n    },\n    onBlur: (event: FocusEvent<T>) => {\n      if (!pointer.current && !event.currentTarget.contains(event.relatedTarget as Node | null)) light(null, false);\n    },\n    onClick: (event: MouseEvent<T>) => {\n      if (!gapClick || !isOwn(event)) return;\n      const target = event.target as Element;\n      if (!target.isConnected || target.closest(selector) || target.closest(CONTROL)) return;\n      const { item } = current.current;\n      if (item?.isConnected && !isItemDisabled(item)) forwardClick(item, event);\n    },\n  };\n\n  /** Clears the highlight at once, such as when a menu opens again. */\n  const reset = () => { cancelAnimationFrame(frame.current); entering.current = true; light(null, false); };\n\n  return { ...state, handlers, reset, light };\n}\n\nexport interface NearestItemOptions extends Omit<FluidHoverOptions, \"followFocus\"> {\n  /** Called with the nearest enabled item as the mouse moves over the container. */\n  onPick: (item: HTMLElement) => void;\n}\n\n/**\n * Fluid hover's picking without its highlight, for a list that already keeps its own active item and highlight (a listbox\n * with aria-activedescendant, a roving list): the mouse picks the nearest enabled item, gaps and padding included, and a\n * click in a gap goes to that item. Spread the result on the container.\n */\n// A hook only so callbacks that touch refs can be passed during render; it keeps no state.\nexport function useNearestItem<T extends HTMLElement>({ items: selector, axis = \"y\", isItemDisabled = defaultDisabled, gapClick = true, onPick }: NearestItemOptions) {\n  const nearest = (event: MouseEvent<T>) => {\n    if (!isOwn(event)) return null;\n    const items = [...event.currentTarget.querySelectorAll<HTMLElement>(selector)].filter(item => !isItemDisabled(item));\n    return pickNearest(items, event.clientX, event.clientY, axis);\n  };\n  return {\n    onPointerMove: (event: PointerEvent<T>) => { if (event.pointerType !== \"mouse\") return; const item = nearest(event); if (item) onPick(item); },\n    onClick: (event: MouseEvent<T>) => {\n      if (!gapClick) return;\n      const target = event.target as Element;\n      if (!target.isConnected || target.closest(selector) || target.closest(CONTROL)) return;\n      const item = nearest(event);\n      if (item) forwardClick(item, event);\n    },\n  };\n}\n\nconst sameRect = (a: FluidRect | null, b: FluidRect | null) =>\n  a === b || (!!a && !!b && a.top === b.top && a.left === b.left && a.width === b.width && a.height === b.height);\n\nexport interface FluidHoverHighlightProps {\n  /** The state from useFluidHover (or any { rect, glide, session }). */\n  hover: Pick<FluidHoverState, \"rect\" | \"glide\" | \"session\">;\n  /** Radius, fill, z-index. The container must be position: relative; the highlight is placed at its top-left corner. */\n  className?: string;\n  /** Extra attributes for styling, such as data-tone. */\n  tone?: string;\n}\n\n/** The one highlight a fluid hover set renders: it springs between items on transforms, and fades in and out. */\nexport function FluidHoverHighlight({ hover, className, tone }: FluidHoverHighlightProps) {\n  const reduced = useReducedMotion() ?? false;\n  const { rect, glide, session } = hover;\n  const place = rect ? { x: rect.left, y: rect.top, width: rect.width, height: rect.height } : undefined;\n  return (\n    <AnimatePresence initial={false}>\n      {place ? (\n        <motion.span key={session} className={className} data-tone={tone} aria-hidden=\"true\"\n          style={{ position: \"absolute\", top: 0, left: 0, pointerEvents: \"none\" }}\n          initial={{ opacity: 0, ...place }}\n          animate={{ opacity: 1, ...place }}\n          exit={{ opacity: 0, transition: motionTokens.spring.fast.exit }}\n          transition={{ default: glide && !reduced ? motionTokens.spring.fast : { duration: 0 }, opacity: { duration: motionTokens.duration.fast } }} />\n      ) : null}\n    </AnimatePresence>\n  );\n}\n"}],"docs":"Docs and live preview: https://ui.teamofsilicons.com/combobox","meta":{"tier":"free","kind":"component","docs":"https://ui.teamofsilicons.com/combobox","markdown":"https://ui.teamofsilicons.com/combobox.md","tags":["field","search"],"status":"stable"}}