{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "combobox",
  "title": "Integrated Combobox",
  "description": "Always-searchable, single-select autocomplete. A thin, opinionated preset over the Integrated Select with searchable forced on and multiple unavailable.",
  "registryDependencies": [
    "@easy-shadcn/select"
  ],
  "files": [
    {
      "path": "registry/ui/combobox.tsx",
      "content": "\"use client\";\n\nimport type { ClassValue } from \"clsx\";\nimport type { AriaAttributes, ReactNode } from \"react\";\nimport { Select } from \"@/registry/ui/select\";\n\nexport interface ComboboxItem {\n  /** Unselectable when true. */\n  disabled?: boolean;\n  /** Per-item class, merged AFTER the root-level `itemClassName`. */\n  itemClassName?: ClassValue;\n  /** Display label. string/number drive the default filter, else falls back to `value`. */\n  label: ReactNode;\n  /** Required; stable React key + controlled value. `\"\"` is valid. */\n  value: string;\n}\n\nexport interface ComboboxProps {\n  \"aria-describedby\"?: string;\n  \"aria-invalid\"?: AriaAttributes[\"aria-invalid\"];\n\n  /** `InputGroup` wrapper (the bordered control) className. */\n  className?: ClassValue;\n  /** Show an inline clear button when the field has a value. @default false */\n  clearable?: boolean;\n  /** Popover content container className. */\n  contentClassName?: ClassValue;\n  /** Uncontrolled initial open state. @default false */\n  defaultOpen?: boolean;\n  /** Uncontrolled initial value. */\n  defaultValue?: string;\n\n  /** Disable all interaction. */\n  disabled?: boolean;\n  /** `<ComboboxEmpty />` className. */\n  emptyClassName?: ClassValue;\n  /** Content shown when no items match the query. @default \"No results\" */\n  emptyMessage?: ReactNode;\n  /**\n   * Custom filter predicate — overrides the default match.\n   * @default case-insensitive `contains` against `label`, fallback `value`\n   */\n  filter?: (item: ComboboxItem, query: string) => boolean;\n  /** Id applied to the input, for `<label htmlFor>` / the Field component. */\n  id?: string;\n  /** The `<input>` className. */\n  inputClassName?: ClassValue;\n  /** Default item className, merged with each `item.itemClassName`. */\n  itemClassName?: ClassValue;\n  /** Option list. An empty array renders the empty state. */\n  items: ComboboxItem[];\n  /** Native form field name for form submission. */\n  name?: string;\n  /** Called when the popover open state changes. */\n  onOpenChange?: (open: boolean) => void;\n  /** Called when the selection changes. `undefined` represents no selection. */\n  onValueChange?: (value: string | undefined) => void;\n\n  /** Controlled popover open state. */\n  open?: boolean;\n\n  /** Placeholder shown when no value is selected. @default \"Pick an option\" */\n  placeholder?: string;\n\n  /** Controlled value. Prop presence (incl. `undefined`) signals controlled mode. */\n  value?: string;\n}\n\n/**\n * An always-searchable, single-select autocomplete. A thin, opinionated preset\n * over `Select` with `searchable` forced on and `multiple` unavailable — see\n * `docs/adr/0005-combobox-thin-preset-over-select.md`. The enumerated props are forwarded 1:1; anything\n * unlisted → use `Select` or the `components/ui/combobox` primitives.\n */\nexport const Combobox = (props: ComboboxProps) => {\n  const {\n    items,\n    defaultValue,\n    onValueChange,\n    open,\n    defaultOpen,\n    onOpenChange,\n    placeholder,\n    emptyMessage,\n    clearable,\n    filter,\n    disabled,\n    name,\n    id,\n    \"aria-describedby\": ariaDescribedBy,\n    \"aria-invalid\": ariaInvalid,\n    className,\n    inputClassName,\n    contentClassName,\n    itemClassName,\n    emptyClassName,\n  } = props;\n\n  // `value` presence (even `undefined`) signals controlled mode. Forward the\n  // key only when the caller passed it, so Select's `\"value\" in props` check\n  // mirrors Combobox's own controlled/uncontrolled decision.\n  const controlledValue: { value?: string } =\n    \"value\" in props ? { value: props.value } : {};\n\n  return (\n    <Select\n      aria-describedby={ariaDescribedBy}\n      aria-invalid={ariaInvalid}\n      className={className}\n      clearable={clearable}\n      contentClassName={contentClassName}\n      defaultOpen={defaultOpen}\n      defaultValue={defaultValue}\n      disabled={disabled}\n      emptyClassName={emptyClassName}\n      emptyMessage={emptyMessage}\n      filter={filter}\n      id={id}\n      inputClassName={inputClassName}\n      itemClassName={itemClassName}\n      items={items}\n      name={name}\n      onOpenChange={onOpenChange}\n      onValueChange={onValueChange}\n      open={open}\n      placeholder={placeholder}\n      searchable\n      {...controlledValue}\n    />\n  );\n};\n\nexport default Combobox;\n",
      "type": "registry:component",
      "target": "components/easy/combobox.tsx"
    }
  ],
  "type": "registry:component"
}