Combobox

Overview

Combobox is a design-system component intended for reusable, product-agnostic UI composition.

Import

import { Combobox } from "@tesseract-nexus/tesserix-ui"

Exports

export { Combobox } from "./combobox"
export type { ComboboxProps, ComboboxOption } from "./combobox"

Props

export interface ComboboxProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "defaultValue" | "onChange"> {
  options: ComboboxOption[]
  value?: string
  defaultValue?: string
  onValueChange?: (value: string) => void
  placeholder?: string
  searchPlaceholder?: string
  emptyText?: string
  disabled?: boolean
}

Variations

No explicit cva variant map found. Variations are primarily structural/compositional for this component.

Usage Patterns

Basic

import { Combobox } from "@tesseract-nexus/tesserix-ui"
 
export function Example() {
  return <Combobox />
}

Do / Don’t

Do

// Compose with domain wrappers in product code
<Combobox className="w-full" />

Don’t

// Avoid one-off hardcoded values that bypass tokens
<Combobox className="bg-[#123456] text-[#fafafa] px-[13px]" />

Token / Theming Mapping

• Color tokens: —primary, —secondary, —muted, —destructive, —foreground, —background
• Shape tokens: —radius
• Border/input tokens: —border, —input, —ring
• Spacing and typography: Tailwind scale via design-system preset

Interaction Test Checklist

1. Interaction: click/keyboard activation for primary paths.
2. Focus: visible focus styles and logical tab order.
3. Variants: core variants and sizes render correctly.
4. Disabled/error states: behavior and ARIA attributes are correct.
5. Regression: Storybook visual check for primary states.

Accessibility

• Verify keyboard behavior for all interactive states.
• Ensure labels and semantic roles are present in consuming screens.
• Validate focus treatment and screen-reader output during QA.