{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "components-combobox",
  "type": "registry:component",
  "title": "Combobox",
  "description": "A searchable single- or multi-select with ranked options",
  "author": "sudo-kw <https://github.com/sudo-kw>",
  "dependencies": [
    "@gpuix/native@0.11.0",
    "@gpuix/react@0.11.0",
    "effect@4.1.2",
    "react@^19.2.4"
  ],
  "registryDependencies": [
    "https://gpuixui.sudokw.com/gpuix-icons.json",
    "https://gpuixui.sudokw.com/gpuix-motion.json",
    "https://gpuixui.sudokw.com/gpuix-primitives.json",
    "https://gpuixui.sudokw.com/gpuix-tokens.json",
    "https://gpuixui.sudokw.com/gpuix-tw.json"
  ],
  "files": [
    {
      "path": "packages/components/src/combobox.tsx",
      "target": "@ui/gpuixui/components/combobox.tsx",
      "type": "registry:component",
      "content": "/** @jsxImportSource @gpuix/react */\nimport {\n  Combobox as HeadlessCombobox,\n  ComboboxEmpty as HeadlessEmpty,\n  ComboboxInput as HeadlessInput,\n  ComboboxItem as HeadlessItem,\n  ComboboxList as HeadlessList,\n  ComboboxTrigger as HeadlessTrigger,\n  type ComboboxItemState,\n  type ComboboxListProps as HeadlessListProps,\n  type ComboboxTriggerProps as HeadlessTriggerProps,\n  type ComboboxValue,\n} from \"@gpuix/react\";\nimport { useGpuix } from \"@gpuix/react\";\nimport type { PublicInstance, StyleDesc } from \"@gpuix/react\";\nimport {\n  FloatingLayer,\n  mergeStyles,\n  resolveStyle,\n  type FloatingContentProps,\n  type StateStyle,\n} from \"@gpuix/react/floating\";\nimport { Icon } from \"../icons/index.js\";\nimport {\n  cn,\n  COMBOBOX_CARET,\n  COMBOBOX_CONTENT,\n  COMBOBOX_EMPTY,\n  COMBOBOX_INPUT,\n  COMBOBOX_ITEM,\n  COMBOBOX_ITEM_DESCRIPTION,\n  COMBOBOX_ITEM_MARK,\n  COMBOBOX_ITEM_TEXT,\n  COMBOBOX_LIST,\n  COMBOBOX_TRIGGER,\n  COMBOBOX_TRIGGER_TEXT,\n} from \"../tw/index.js\";\nimport * as Arr from \"effect/Array\";\nimport * as Option from \"effect/Option\";\nimport * as Str from \"effect/String\";\nimport {\n  createContext,\n  useContext,\n  useLayoutEffect,\n  useRef,\n  useState,\n  type ReactNode,\n  type RefObject,\n} from \"react\";\nimport {\n  createRowQuery,\n  createRowValue,\n  filterOptions,\n  isCreateRow,\n  labelOf,\n  offersCreate,\n  optionsOf,\n  selectionOf,\n  type ComboboxOption,\n} from \"./combobox/logic.js\";\nimport { useControllableState } from \"./internal/controllable.js\";\nimport {\n  fieldHelp,\n  fieldHint,\n  hintHost,\n  renderFieldHint,\n} from \"../primitives/components/hint.js\";\nimport { dismissTopLayer, pushDismissLayer } from \"./internal/dismiss-layer.js\";\nimport { DismissScope, useDismissDepth } from \"./internal/dismiss-scope.js\";\nimport { isDismiss } from \"./internal/key.js\";\nimport {\n  assertParts,\n  type PartChildren,\n  type PartComponent,\n  type PartsContract,\n} from \"./internal/parts.js\";\nimport {\n  fadeFromAnchor,\n  PresenceShield,\n  presenceMotion,\n  presenceStyle,\n  useSurfacePresence,\n  useSurfaceTiming,\n} from \"./internal/presence.js\";\nimport { recipeStyle } from \"./internal/recipe.js\";\nimport { useMergedRef } from \"./internal/ref.js\";\nimport {\n  controlHeight,\n  controlRing,\n  disabledFade,\n  keepContent,\n  nativeTextTheme,\n  selectionWash,\n  useTheme,\n  type Theme,\n} from \"./internal/theme.js\";\nimport { usePlacement } from \"./internal/use-placement.js\";\n\nexport type ComboboxSelection = string | null | ReadonlyArray<string>;\n\ninterface ComboboxContextValue {\n  readonly options: ReadonlyArray<ComboboxOption>;\n  readonly selectedValues: ReadonlyArray<string>;\n  readonly open: boolean;\n  readonly disabled: boolean;\n\n  readonly loading: boolean;\n\n  readonly query: string;\n  readonly labelFor: (value: string) => string;\n  readonly isDisabled: (value: string) => boolean;\n  readonly trigger: RefObject<PublicInstance | null>;\n  readonly registerTrigger: (instance: PublicInstance | null) => void;\n\n  readonly close: () => void;\n\n  readonly noteOutsidePress: () => void;\n}\n\nconst ComboboxContext = createContext<ComboboxContextValue | undefined>(\n  undefined,\n);\n\nconst useCombobox = (): ComboboxContextValue => {\n  const value = useContext(ComboboxContext);\n  if (value === undefined) {\n    throw new Error(\"Combobox parts must be used inside Combobox\");\n  }\n  return value;\n};\n\nexport interface ComboboxProps {\n  readonly options: ReadonlyArray<ComboboxOption>;\n\n  readonly value?: string | ReadonlyArray<string>;\n\n  readonly defaultValue?: string | ReadonlyArray<string>;\n  readonly onValueChange?: (value: ComboboxSelection) => void;\n\n  readonly multiple?: boolean;\n  readonly disabled?: boolean;\n\n  readonly onCreate?: (query: string) => void;\n\n  readonly createLabel?: (query: string) => string;\n\n  readonly onQueryChange?: (query: string) => void;\n\n  readonly shouldFilter?: boolean;\n\n  readonly loading?: boolean;\n  readonly children?: PartChildren;\n}\n\nconst toRuntimeValue = (\n  value: Option.Option<string | ReadonlyArray<string>>,\n  multiple: boolean,\n): ComboboxValue | undefined =>\n  Option.match(value, {\n    onNone: () => undefined,\n    onSome: (chosen) =>\n      multiple\n        ? typeof chosen === \"string\"\n          ? [chosen]\n          : [...chosen]\n        : typeof chosen === \"string\"\n          ? chosen\n          : (chosen[0] ?? null),\n  });\n\nconst optionOf = (\n  options: ReadonlyArray<ComboboxOption>,\n  value: string,\n): Option.Option<ComboboxOption> =>\n  Arr.findFirst(options, (option) => option.value === value);\n\nconst rowStyle = (theme: Theme, state: ComboboxItemState): StyleDesc => ({\n  ...recipeStyle(COMBOBOX_ITEM, theme),\n  minHeight: controlHeight(theme, \"sm\"),\n  cursor: state.disabled ? \"not-allowed\" : \"pointer\",\n  backgroundColor: state.highlighted ? theme.colors.hover : undefined,\n  color: state.selected\n    ? theme.colors.foreground\n    : theme.colors.popoverForeground,\n  hover: state.disabled ? undefined : { backgroundColor: theme.colors.hover },\n});\n\nconst labelColor = (\n  theme: Theme,\n  state: { readonly disabled: boolean; readonly selected: boolean },\n): string =>\n  state.disabled\n    ? theme.colors.disabledForeground\n    : state.selected\n      ? theme.colors.foreground\n      : theme.colors.popoverForeground;\n\nexport const Combobox = ({\n  options,\n  value: valueProp,\n  defaultValue,\n  onValueChange,\n  multiple = false,\n  disabled = false,\n  onCreate,\n  createLabel = (query) => `Create \"${query}\"`,\n  onQueryChange,\n  shouldFilter = true,\n  loading = false,\n  children,\n}: ComboboxProps) => {\n  const renderer = useGpuix().renderer;\n  const [open, setOpen] = useState(false);\n  const [query, setQuery] = useState(\"\");\n  const trigger = useRef<PublicInstance | null>(null);\n  const restoreFocus = useRef(false);\n  const wasOpen = useRef(false);\n\n  const labelWrite = useRef<Option.Option<string>>(Option.none());\n\n  const timing = useSurfaceTiming(\"normal\");\n  const presence = useSurfacePresence(open, timing);\n\n  useLayoutEffect(() => {\n    if (presence.mounted) return;\n    setQuery(\"\");\n  }, [presence.mounted]);\n\n  const onQueryChangeRef = useRef(onQueryChange);\n  useLayoutEffect(() => {\n    onQueryChangeRef.current = onQueryChange;\n  });\n\n  useLayoutEffect(() => {\n    if (!open || disabled) return;\n    onQueryChangeRef.current?.(query);\n  }, [disabled, open, query]);\n\n  const [selected, setSelected] = useControllableState<ComboboxValue>({\n    value: toRuntimeValue(selectionOf(valueProp), multiple),\n    defaultValue:\n      toRuntimeValue(selectionOf(defaultValue), multiple) ??\n      (multiple ? [] : null),\n    onChange: onValueChange,\n  });\n\n  const selectedValues: ReadonlyArray<string> = Array.isArray(selected)\n    ? selected\n    : selected === null\n      ? []\n      : [selected];\n\n  const optionList = optionsOf(options);\n  const visible =\n    shouldFilter === true ? filterOptions(optionList, query) : optionList;\n  const create = offersCreate(\n    visible,\n    query,\n    onCreate !== undefined && !multiple,\n  )\n    ? createRowValue(Str.trim(query))\n    : undefined;\n  const items =\n    create === undefined\n      ? Arr.map(visible, (option) => option.value)\n      : Arr.append(\n          Arr.map(visible, (option) => option.value),\n          create,\n        );\n\n  assertParts(comboboxRoot, children);\n\n  const labelFor = (value: string): string =>\n    isCreateRow(value)\n      ? createLabel(createRowQuery(value))\n      : Option.match(optionOf(optionList, value), {\n          onNone: () => value,\n          onSome: labelOf,\n        });\n\n  useLayoutEffect(() => {\n    if (!disabled) return;\n    setOpen(false);\n  }, [disabled]);\n\n  useLayoutEffect(() => {\n    if (wasOpen.current && !open && restoreFocus.current) {\n      const instance = trigger.current;\n      if (instance !== null) renderer?.focusElement?.(instance.id);\n    }\n    if (!open) restoreFocus.current = false;\n    wasOpen.current = open;\n  }, [open, renderer]);\n\n  const depth = useDismissDepth();\n  useLayoutEffect(() => {\n    if (!open) return;\n    return pushDismissLayer((event) => {\n      restoreFocus.current = event.eventType === \"keyDown\";\n      setOpen(false);\n    }, depth);\n  }, [depth, open]);\n\n  useLayoutEffect(() => {\n    labelWrite.current = Option.none();\n  });\n\n  return (\n    <ComboboxContext.Provider\n      value={{\n        options: optionList,\n        selectedValues,\n        open,\n        disabled,\n        loading,\n        query,\n        labelFor,\n        isDisabled: (value) =>\n          Option.exists(\n            optionOf(optionList, value),\n            (option) => option.disabled === true,\n          ),\n        trigger,\n        close: () => setOpen(false),\n        registerTrigger: (instance) => {\n          trigger.current = instance;\n        },\n        noteOutsidePress: () => {\n          restoreFocus.current = false;\n        },\n      }}\n    >\n      <HeadlessCombobox\n        items={items}\n        value={selected}\n        onValueChange={(next) => {\n          labelWrite.current = Option.fromNullishOr(\n            typeof next === \"string\" ? labelFor(next) : null,\n          );\n          if (typeof next === \"string\" && isCreateRow(next)) {\n            onCreate?.(createRowQuery(next));\n            restoreFocus.current = true;\n            setOpen(false);\n            return;\n          }\n          restoreFocus.current = !multiple;\n          setSelected(next);\n        }}\n        inputValue={query}\n        onInputValueChange={(next) => {\n          const written = labelWrite.current;\n          labelWrite.current = Option.none();\n          if (!open) return;\n          if (Option.exists(written, (label) => label === next)) return;\n          setQuery(next);\n        }}\n        open={open}\n        onOpenChange={(next) => {\n          if (next) {\n            restoreFocus.current = false;\n            setQuery(\"\");\n            setOpen(true);\n            return;\n          }\n          setOpen(false);\n        }}\n        multiple={multiple}\n        disabled={disabled}\n        autoHighlight=\"always\"\n        filter={null}\n        itemToStringValue={(value) => labelFor(value)}\n        style={{ display: \"flex\", flexDirection: \"column\", width: \"100%\" }}\n      >\n        {children}\n      </HeadlessCombobox>\n    </ComboboxContext.Provider>\n  );\n};\n\nexport interface ComboboxTriggerProps extends Omit<\n  HeadlessTriggerProps,\n  \"children\"\n> {\n  readonly placeholder?: string;\n\n  readonly label?: string;\n\n  readonly className?: string;\n\n  readonly testId?: string;\n}\n\nexport const ComboboxTrigger = ({\n  placeholder = \"Select…\",\n  label,\n  className,\n  testId = \"combobox-trigger\",\n  ...rest\n}: ComboboxTriggerProps) => {\n  const theme = useTheme();\n  const { selectedValues, open, disabled, labelFor, registerTrigger } =\n    useCombobox();\n  const display =\n    selectedValues.length === 0\n      ? placeholder\n      : Arr.join(\n          Arr.map(selectedValues, (value) => labelFor(value)),\n          \", \",\n        );\n  const isPlaceholder = selectedValues.length === 0;\n\n  return (\n    <HeadlessTrigger\n      {...(label === undefined ? {} : { \"aria-label\": label })}\n      aria-expanded={open}\n      ref={registerTrigger}\n      testId={testId}\n      disabled={disabled}\n      {...rest}\n      style={mergeStyles(recipeStyle(cn(COMBOBOX_TRIGGER, className), theme), {\n        height: controlHeight(theme, \"md\"),\n        color: isPlaceholder\n          ? theme.colors.mutedForeground\n          : theme.colors.foreground,\n        cursor: disabled ? \"not-allowed\" : \"pointer\",\n        ...disabledFade(disabled),\n        hover: disabled ? undefined : { backgroundColor: theme.colors.hover },\n        ...controlRing(theme, { disabled }),\n      })}\n    >\n      <text\n        style={mergeStyles(recipeStyle(COMBOBOX_TRIGGER_TEXT, theme), {\n          color: isPlaceholder\n            ? theme.colors.mutedForeground\n            : theme.colors.foreground,\n        })}\n      >\n        {display}\n      </text>\n      <div style={recipeStyle(COMBOBOX_CARET, theme)}>\n        <Icon\n          name=\"chevron-down\"\n          size=\"xs\"\n          color={theme.colors.mutedForeground}\n        />\n      </div>\n    </HeadlessTrigger>\n  );\n};\n\nexport interface ComboboxContentProps extends FloatingContentProps {\n  readonly side?: \"top\" | \"right\" | \"bottom\" | \"left\";\n\n  readonly align?: \"start\" | \"center\" | \"end\";\n\n  readonly sideOffset?: number;\n\n  readonly alignOffset?: number;\n\n  readonly className?: string;\n  readonly children?: PartChildren;\n}\n\nexport const ComboboxContent = ({\n  side = \"bottom\",\n  align = \"start\",\n  sideOffset = 4,\n  alignOffset = 0,\n  collisionPadding = 8,\n  className,\n  children,\n  onMouseDownOutside,\n  style,\n  ref,\n  ...rest\n}: ComboboxContentProps) => {\n  const theme = useTheme();\n  const { close, noteOutsidePress, open, trigger } = useCombobox();\n  const surface = useRef<PublicInstance | null>(null);\n  const setSurface = useMergedRef<PublicInstance | null>(surface, ref);\n  const timing = useSurfaceTiming(\"normal\");\n  const presence = useSurfacePresence(open, timing);\n  const placement = usePlacement({\n    open: presence.mounted,\n    side,\n    align,\n    margin: collisionPadding,\n    trigger,\n    surface,\n  });\n  assertParts(comboboxContent, children);\n\n  if (!open && !presence.mounted) return null;\n\n  const frames = fadeFromAnchor(side, 4);\n\n  return (\n    <FloatingLayer\n      testId=\"combobox-content\"\n      motion={presenceMotion(frames, presence)}\n      side={placement.side}\n      align={placement.align}\n      sideOffset={sideOffset}\n      alignOffset={placement.alignOffset + alignOffset}\n      collisionPadding={collisionPadding}\n      ref={setSurface}\n      {...rest}\n      onMouseDownOutside={(event) => {\n        noteOutsidePress();\n        onMouseDownOutside?.(event);\n        close();\n      }}\n      style={mergeStyles(\n        mergeStyles(recipeStyle(cn(COMBOBOX_CONTENT, className), theme), {\n          maxHeight: 280,\n          overflowY: \"scroll\",\n\n          position: \"relative\",\n          ...presenceStyle(presence.present),\n        }),\n        style,\n      )}\n    >\n      <DismissScope>{children}</DismissScope>\n      <PresenceShield present={presence.present} />\n    </FloatingLayer>\n  );\n};\n\nexport interface ComboboxInputProps {\n  readonly placeholder?: string;\n\n  readonly label?: string;\n}\n\nexport const ComboboxInput = ({\n  placeholder = \"Search…\",\n  label = \"Search options\",\n}: ComboboxInputProps) => {\n  const theme = useTheme();\n  const { query } = useCombobox();\n  const fieldStyle = mergeStyles(recipeStyle(COMBOBOX_INPUT, theme), {\n    height: controlHeight(theme, \"sm\"),\n    ...controlRing(theme),\n    ...keepContent,\n    ...selectionWash(theme),\n  });\n  const hint = fieldHint({ placeholder }, theme, query, {\n    origin: \"host\",\n    align: \"center\",\n    style: fieldStyle,\n  });\n\n  return (\n    <div\n      style={hintHost({\n        width: \"100%\",\n\n        flexShrink: 0,\n        paddingBottom: theme.spacing.xs,\n      })}\n    >\n      <HeadlessInput\n        testId=\"combobox-input\"\n        aria-label={label}\n        aria-description={fieldHelp({ placeholder }, query)}\n        theme={nativeTextTheme(theme, \"input\")}\n        onKeyDown={(event) => {\n          if (isDismiss(event)) dismissTopLayer(event);\n        }}\n        style={fieldStyle}\n      />\n      {Option.match(hint, {\n        onNone: () => null,\n        onSome: (painted) => renderFieldHint(painted, \"combobox-input\"),\n      })}\n    </div>\n  );\n};\n\nexport interface ComboboxListProps extends Omit<HeadlessListProps, \"children\"> {\n  readonly label?: string;\n\n  readonly itemStyle?: StateStyle<ComboboxItemState>;\n}\n\nexport const ComboboxList = ({\n  label = \"Options\",\n  itemStyle,\n  style,\n  ...rest\n}: ComboboxListProps) => {\n  const theme = useTheme();\n  return (\n    <HeadlessList\n      role=\"listbox\"\n      aria-label={label}\n      {...rest}\n      style={mergeStyles(recipeStyle(COMBOBOX_LIST, theme), style)}\n    >\n      {(item) => <ComboboxItem key={item} value={item} style={itemStyle} />}\n    </HeadlessList>\n  );\n};\n\nexport interface ComboboxItemProps {\n  readonly value: string;\n\n  readonly style?: StateStyle<ComboboxItemState>;\n}\n\nexport const ComboboxItem = ({ value, style }: ComboboxItemProps) => {\n  const theme = useTheme();\n  const { options, selectedValues, labelFor, isDisabled } = useCombobox();\n  const option = optionOf(options, value);\n  const selected = Arr.contains(selectedValues, value);\n  const disabled = isDisabled(value);\n  const color = labelColor(theme, { disabled, selected });\n\n  return (\n    <HeadlessItem\n      value={value}\n      role=\"option\"\n      aria-selected={selected}\n      disabled={disabled}\n      testId={\n        isCreateRow(value) ? \"combobox-create\" : `combobox-option-${value}`\n      }\n      style={(state) =>\n        mergeStyles(rowStyle(theme, state), resolveStyle(style, state)) ??\n        rowStyle(theme, state)\n      }\n    >\n      <div\n        style={{\n          display: \"flex\",\n          flexDirection: \"column\",\n          flexGrow: 1,\n          minWidth: 0,\n          gap: theme.spacing[\"2xs\"],\n        }}\n      >\n        <text\n          style={mergeStyles(recipeStyle(COMBOBOX_ITEM_TEXT, theme), { color })}\n        >\n          {labelFor(value)}\n        </text>\n        {Option.match(option, {\n          onNone: () => null,\n          onSome: (candidate) =>\n            candidate.description === undefined ? null : (\n              <text\n                style={mergeStyles(\n                  recipeStyle(COMBOBOX_ITEM_DESCRIPTION, theme),\n                  {\n                    color: disabled\n                      ? theme.colors.disabledForeground\n                      : theme.colors.mutedForeground,\n                  },\n                )}\n              >\n                {candidate.description}\n              </text>\n            ),\n        })}\n      </div>\n      {selected ? (\n        <div style={recipeStyle(COMBOBOX_ITEM_MARK, theme)}>\n          <Icon\n            name=\"check\"\n            size=\"xs\"\n            color={theme.colors.primary}\n            label=\"Selected\"\n          />\n        </div>\n      ) : null}\n    </HeadlessItem>\n  );\n};\n\nexport interface ComboboxEmptyProps {\n  readonly children?: ReactNode;\n}\n\nexport const ComboboxEmpty = ({ children }: ComboboxEmptyProps) => {\n  const theme = useTheme();\n  const { loading } = useCombobox();\n\n  return (\n    <HeadlessEmpty testId=\"combobox-empty\">\n      {children ?? (\n        <text style={recipeStyle(COMBOBOX_EMPTY, theme)}>\n          {loading ? \"Searching…\" : \"No matches\"}\n        </text>\n      )}\n    </HeadlessEmpty>\n  );\n};\n\nexport type { ComboboxOption } from \"./combobox/logic.js\";\n\nexport type { ComboboxItemState } from \"@gpuix/react\";\n\nconst comboboxParts: ReadonlyArray<PartComponent> = [\n  Combobox,\n  ComboboxTrigger,\n  ComboboxContent,\n  ComboboxInput,\n  ComboboxList,\n  ComboboxItem,\n  ComboboxEmpty,\n];\n\nconst comboboxRoot: PartsContract = {\n  parent: \"Combobox\",\n  family: comboboxParts,\n  accepts: [ComboboxTrigger, ComboboxContent],\n  hint: \"Put ComboboxTrigger and ComboboxContent directly inside Combobox.\",\n};\n\nconst comboboxContent: PartsContract = {\n  parent: \"ComboboxContent\",\n  family: comboboxParts,\n  accepts: [ComboboxInput, ComboboxList, ComboboxEmpty],\n  hint: \"Put ComboboxInput, ComboboxList and ComboboxEmpty directly inside ComboboxContent.\",\n};\n\nexport const comboboxMeta = {\n  name: \"Comboboxes\",\n  tier: 2,\n  status: \"done\",\n  gpuixSupport: \"partial\",\n  limitations: [\n    \"GPUix's filter is order-preserving, so the adapter feeds it pre-ranked items and controls inputValue\",\n    \"selection yields option values, never labels\",\n    \"no aria-activedescendant in 0.11.0: the highlighted row is visual while the input keeps focus\",\n    \"create-new is single-select only, is offered when the query matches no option, and reports the query — the caller adds the option and owns the selection\",\n    \"async is the caller's: onQueryChange reports each search and shouldFilter={false} paints the rows a remote search already chose and ranked; the component neither fetches nor debounces\",\n    'the popup placement is corrected by the component: the runtime snaps but does not flip, and align=\"center\" is measured from the trigger',\n    \"the popup is the one surface whose rows are the runtime's own list: it keeps them for its exit, so a dismissed popup fades in the state it was dismissed in rather than re-filtering under the reader\",\n  ],\n  docs: \"docs/combobox.mdx\",\n  example: \"examples/combobox.example.tsx\",\n  testFile: \"src/behaviour/combobox.test.tsx\",\n} as const;\n"
    },
    {
      "path": "packages/components/src/combobox/logic.ts",
      "target": "@ui/gpuixui/components/combobox/logic.ts",
      "type": "registry:lib",
      "content": "import * as Arr from \"effect/Array\";\nimport * as Option from \"effect/Option\";\nimport * as Order from \"effect/Order\";\nimport * as P from \"effect/Predicate\";\nimport * as Schema from \"effect/Schema\";\nimport * as Str from \"effect/String\";\n\nexport interface ComboboxOption {\n  readonly value: string;\n  readonly label: string;\n  readonly description?: string;\n  readonly disabled?: boolean;\n}\n\nclass StoredOption extends Schema.Class<StoredOption>(\"StoredOption\")({\n  value: Schema.String,\n  label: Schema.optionalKey(Schema.NullOr(Schema.String)),\n  description: Schema.optionalKey(Schema.NullOr(Schema.String)),\n  disabled: Schema.optionalKey(Schema.NullOr(Schema.Boolean)),\n}) {}\n\nconst decodeStoredOption = Schema.decodeUnknownOption(StoredOption);\n\nexport const optionsOf = (value: unknown): ReadonlyArray<ComboboxOption> =>\n  Arr.isArray(value)\n    ? Arr.getSomes(\n        Arr.map(value, (entry) =>\n          Option.map(decodeStoredOption(entry), (option) => ({\n            value: option.value,\n            label: Option.getOrElse(\n              Option.fromNullishOr(option.label),\n              () => option.value,\n            ),\n            ...Option.match(Option.fromNullishOr(option.description), {\n              onNone: () => ({}),\n              onSome: (description) => ({ description }),\n            }),\n            disabled: Option.getOrElse(\n              Option.fromNullishOr(option.disabled),\n              () => false,\n            ),\n          })),\n        ),\n      )\n    : [];\n\nexport const selectionOf = (\n  value: unknown,\n): Option.Option<string | ReadonlyArray<string>> =>\n  P.isString(value)\n    ? Option.some(value)\n    : Arr.isArray(value)\n      ? Option.some(Arr.filter(value, P.isString))\n      : Option.none();\n\nexport const labelOf = (option: ComboboxOption): string => {\n  const label = Str.trim(option.label);\n  return Str.isNonEmpty(label) ? label : option.value;\n};\n\ninterface Ranked {\n  readonly option: ComboboxOption;\n  readonly rank: number;\n  readonly index: number;\n}\n\nconst normalise = (value: string): string => Str.toLowerCase(Str.trim(value));\n\nconst wordStarts = (haystack: string, needle: string): boolean =>\n  Arr.some(Str.split(haystack, \" \"), (word) => Str.startsWith(needle)(word));\n\nconst rank = (option: ComboboxOption, query: string): Option.Option<number> => {\n  const label = normalise(labelOf(option));\n  if (Str.startsWith(query)(label)) return Option.some(0);\n  if (wordStarts(label, query)) return Option.some(1);\n  if (Str.includes(query)(label)) return Option.some(2);\n  if (Str.includes(query)(normalise(option.description ?? \"\")))\n    return Option.some(3);\n  return Option.none();\n};\n\nconst byRankThenDeclaration = Order.combine(\n  Order.mapInput(Order.Number, (entry: Ranked) => entry.rank),\n  Order.mapInput(Order.Number, (entry: Ranked) => entry.index),\n);\n\nexport const filterOptions = (\n  options: ReadonlyArray<ComboboxOption>,\n  query: string,\n): ReadonlyArray<ComboboxOption> => {\n  const needle = normalise(query);\n  if (Str.isEmpty(needle)) return options;\n\n  const ranked = Arr.flatMap(options, (option, index) =>\n    Option.match(rank(option, needle), {\n      onNone: () => [],\n      onSome: (value) => [{ option, rank: value, index }],\n    }),\n  );\n\n  return Arr.map(\n    Arr.sort(ranked, byRankThenDeclaration),\n    (entry) => entry.option,\n  );\n};\n\nconst CREATE_ROW_PREFIX = \"\\u0000create\\u0000\";\n\nexport const isCreateRow = (value: string): boolean =>\n  Str.startsWith(CREATE_ROW_PREFIX)(value);\n\nexport const createRowValue = (query: string): string =>\n  `${CREATE_ROW_PREFIX}${query}`;\n\nexport const createRowQuery = (value: string): string =>\n  Str.slice(CREATE_ROW_PREFIX.length)(value);\n\nexport const offersCreate = (\n  visible: ReadonlyArray<ComboboxOption>,\n  query: string,\n  canCreate: boolean,\n): boolean =>\n  canCreate &&\n  !Str.isEmpty(Str.trim(query)) &&\n  Arr.isReadonlyArrayEmpty(visible);\n\nexport const toggledSelection = (\n  selected: ReadonlyArray<string>,\n  value: string,\n): ReadonlyArray<string> =>\n  Arr.contains(selected, value)\n    ? Arr.filter(selected, (candidate) => candidate !== value)\n    : Arr.append(selected, value);\n\nexport const selectedLabel = (\n  options: ReadonlyArray<ComboboxOption>,\n  value: Option.Option<string>,\n): Option.Option<string> =>\n  Option.flatMap(value, (selected) =>\n    Option.map(\n      Arr.findFirst(options, (option) => option.value === selected),\n      labelOf,\n    ),\n  );\n"
    },
    {
      "path": "packages/components/src/internal/clock.ts",
      "target": "@ui/gpuixui/components/internal/clock.ts",
      "type": "registry:lib",
      "content": "import { Effect } from \"effect\";\nimport * as Clock from \"effect/Clock\";\n\nexport const monotonicNanos = (): bigint =>\n  Effect.runSync(Clock.monotonicTimeNanos);\n\nexport const hoverDelay = (value: number, fallback: number): number =>\n  Number.isFinite(value) ? Math.max(0, value) : fallback;\n"
    },
    {
      "path": "packages/components/src/internal/controllable.ts",
      "target": "@ui/gpuixui/components/internal/controllable.ts",
      "type": "registry:lib",
      "content": "import { useCallback, useState } from \"react\";\n\nexport type ControllableState<Value> = readonly [Value, (next: Value) => void];\n\nexport interface ControllableStateOptions<Value> {\n  readonly value: Value | undefined;\n\n  readonly defaultValue: Value;\n\n  readonly onChange?: (next: Value) => void;\n}\n\nexport const useControllableState = <Value>({\n  value,\n  defaultValue,\n  onChange,\n}: ControllableStateOptions<Value>): ControllableState<Value> => {\n  const [internal, setInternal] = useState(defaultValue);\n  const controlled = value !== undefined;\n\n  const setValue = useCallback(\n    (next: Value) => {\n      if (!controlled) setInternal(next);\n      if (value !== next) onChange?.(next);\n    },\n    [controlled, value, onChange],\n  );\n\n  return [controlled ? value : internal, setValue];\n};\n"
    },
    {
      "path": "packages/components/src/internal/dismiss-layer.ts",
      "target": "@ui/gpuixui/components/internal/dismiss-layer.ts",
      "type": "registry:lib",
      "content": "import type { EventPayload } from \"@gpuix/react\";\nimport * as Arr from \"effect/Array\";\nimport * as Duration from \"effect/Duration\";\nimport * as Option from \"effect/Option\";\nimport * as Order from \"effect/Order\";\nimport { monotonicNanos } from \"./clock.js\";\n\nexport type DismissHandler = (event: EventPayload) => void;\n\ninterface Layer {\n  readonly onDismiss: DismissHandler;\n  readonly depth: number;\n}\n\nlet layers: ReadonlyArray<Layer> = [];\n\nlet dismissedKeystroke: Option.Option<number> = Option.none();\n\ninterface Press {\n  readonly shape: string;\n  readonly at: bigint;\n}\n\nlet dismissedPress: Option.Option<Press> = Option.none();\n\nexport const pointerGestureWindow: Duration.Duration = Duration.millis(64);\n\nconst PRESS_WINDOW_NANOS =\n  BigInt(Duration.toMillis(pointerGestureWindow)) * 1_000_000n;\n\nconst pressShape = (event: EventPayload): string =>\n  Arr.join(\":\")(\n    Arr.map(\n      [event.eventType, event.x, event.y, event.button, event.clickCount],\n      (part) => (part === undefined ? \"\" : `${part}`),\n    ),\n  );\n\nconst consumedPress = (event: EventPayload, now: bigint): boolean => {\n  const shape = pressShape(event);\n  const repeated = Option.exists(\n    dismissedPress,\n    (press) => press.shape === shape && now - press.at <= PRESS_WINDOW_NANOS,\n  );\n  if (!repeated) dismissedPress = Option.some({ shape, at: now });\n  return repeated;\n};\n\nlet lastDismissedPoint: Option.Option<{\n  readonly point: string;\n  readonly at: bigint;\n}> = Option.none();\n\nconst pointOf = (event: EventPayload): string =>\n  Arr.join(\":\")(\n    Arr.map([event.x, event.y, event.button], (part) =>\n      part === undefined ? \"\" : `${part}`,\n    ),\n  );\n\nexport const isDismissalClick = (\n  event: EventPayload,\n  now: bigint = monotonicNanos(),\n): boolean =>\n  Option.exists(\n    lastDismissedPoint,\n    (dismissed) =>\n      dismissed.point === pointOf(event) &&\n      now - dismissed.at <= PRESS_WINDOW_NANOS,\n  );\n\nconst consumedKeystroke = (keystrokeId: number): boolean => {\n  if (Option.contains(dismissedKeystroke, keystrokeId)) return true;\n  dismissedKeystroke = Option.some(keystrokeId);\n  return false;\n};\n\nconst consume = (event: EventPayload, now: bigint): boolean =>\n  Option.match(Option.fromNullishOr(event.keystrokeId), {\n    onNone: () => consumedPress(event, now),\n    onSome: consumedKeystroke,\n  });\n\nconst byDepth: Order.Order<Layer> = Order.mapInput(\n  Order.Number,\n  (layer: Layer) => layer.depth,\n);\n\nconst topmost = (): Option.Option<DismissHandler> =>\n  Option.map(Arr.last(Arr.sort(layers, byDepth)), (layer) => layer.onDismiss);\n\nexport const pushDismissLayer = (\n  onDismiss: DismissHandler,\n  depth: number,\n): (() => void) => {\n  const layer: Layer = { onDismiss, depth };\n  layers = Arr.append(layers, layer);\n  return () => {\n    layers = Arr.filter(layers, (candidate) => candidate !== layer);\n    if (Arr.length(layers) === 0) {\n      dismissedKeystroke = Option.none();\n      dismissedPress = Option.none();\n    }\n  };\n};\n\nexport const dismissTopLayer = (\n  event: EventPayload,\n  now: bigint = monotonicNanos(),\n): boolean => {\n  if (consume(event, now)) return false;\n  return Option.match(topmost(), {\n    onNone: () => false,\n    onSome: (onDismiss) => {\n      lastDismissedPoint = Option.some({ point: pointOf(event), at: now });\n      onDismiss(event);\n      return true;\n    },\n  });\n};\n\nexport const dismissLayerCount = (): number => Arr.length(layers);\n"
    },
    {
      "path": "packages/components/src/internal/dismiss-scope.tsx",
      "target": "@ui/gpuixui/components/internal/dismiss-scope.tsx",
      "type": "registry:component",
      "content": "/** @jsxImportSource @gpuix/react */\nimport { createContext, useContext, type ReactNode } from \"react\";\n\nconst AmbientDepth = createContext(0);\n\nexport const useDismissDepth = (): number => useContext(AmbientDepth) + 1;\n\nexport const DismissScope = ({\n  children,\n}: {\n  readonly children: ReactNode;\n}) => (\n  <AmbientDepth.Provider value={useDismissDepth()}>\n    {children}\n  </AmbientDepth.Provider>\n);\n"
    },
    {
      "path": "packages/components/src/internal/key.ts",
      "target": "@ui/gpuixui/components/internal/key.ts",
      "type": "registry:lib",
      "content": "import type { EventPayload, KeyEvent, Props } from \"@gpuix/react\";\nimport * as Option from \"effect/Option\";\n\nexport type KeyPhase = \"down\" | \"up\";\n\nexport const isActivation = (event: EventPayload, phase: KeyPhase): boolean => {\n  if (event.isHeld === true) return false;\n  if (event.key === \"enter\") return phase === \"down\";\n  return event.key === \"space\" && phase === \"up\";\n};\n\nexport const swallowsDefault = (\n  event: EventPayload,\n  phase: KeyPhase,\n): boolean => event.key === \"space\" && phase === \"down\";\n\nexport const activationHandlers = (\n  activate: (event: KeyEvent) => void,\n  observe: Pick<Props, \"onKeyDown\" | \"onKeyUp\"> = {},\n): Pick<Props, \"onKeyDown\" | \"onKeyUp\"> => ({\n  onKeyDown: (event: KeyEvent) => {\n    if (swallowsDefault(event, \"down\")) event.preventDefault();\n    if (isActivation(event, \"down\")) activate(event);\n    observe.onKeyDown?.(event);\n  },\n  onKeyUp: (event: KeyEvent) => {\n    if (isActivation(event, \"up\")) activate(event);\n    observe.onKeyUp?.(event);\n  },\n});\n\nexport const isEnter = (event: EventPayload): boolean => event.key === \"enter\";\n\nexport const isDown = (event: EventPayload): boolean =>\n  event.key === \"down\" || (event.key === \"n\" && event.modifiers?.ctrl === true);\n\nexport const isUp = (event: EventPayload): boolean =>\n  event.key === \"up\" || (event.key === \"p\" && event.modifiers?.ctrl === true);\n\nexport const isRight = (event: EventPayload): boolean => event.key === \"right\";\n\nexport const isLeft = (event: EventPayload): boolean => event.key === \"left\";\n\nexport const isFirst = (event: EventPayload): boolean => event.key === \"home\";\n\nexport const isLast = (event: EventPayload): boolean => event.key === \"end\";\n\nexport const isPageUp = (event: EventPayload): boolean =>\n  event.key === \"pageup\";\n\nexport const isPageDown = (event: EventPayload): boolean =>\n  event.key === \"pagedown\";\n\nexport const isDismiss = (event: EventPayload): boolean =>\n  event.key === \"escape\";\n\nexport const isTab = (event: EventPayload): boolean => event.key === \"tab\";\n\nexport const isSelectAll = (event: EventPayload): boolean =>\n  event.key === \"a\" &&\n  (event.modifiers?.cmd === true || event.modifiers?.ctrl === true);\n\nexport const isMenuKey = (event: EventPayload): boolean =>\n  (event.key === \"f10\" && event.modifiers?.shift === true) ||\n  event.key === \"contextmenu\";\n\nexport const axisDirection = (\n  event: EventPayload,\n  orientation: \"horizontal\" | \"vertical\",\n): Option.Option<1 | -1> => {\n  if (event.key === \"right\") return Option.some(1);\n  if (event.key === \"left\") return Option.some(-1);\n  if (orientation === \"vertical\") {\n    if (isDown(event)) return Option.some(1);\n    if (isUp(event)) return Option.some(-1);\n  }\n  return Option.none();\n};\n"
    },
    {
      "path": "packages/components/src/internal/parts.ts",
      "target": "@ui/gpuixui/components/internal/parts.ts",
      "type": "registry:lib",
      "content": "import * as Arr from \"effect/Array\";\nimport * as P from \"effect/Predicate\";\nimport {\n  Children,\n  Fragment,\n  isValidElement,\n  type ReactElement,\n  type ReactNode,\n} from \"react\";\n\nexport type PartComponent = (props: never) => ReactNode;\n\nexport type PartChildren =\n  | ReactElement<unknown>\n  | boolean\n  | null\n  | undefined\n  | ReadonlyArray<PartChildren>;\n\nexport interface PartsContract {\n  readonly parent: string;\n\n  readonly family: ReadonlyArray<PartComponent>;\n\n  readonly accepts: ReadonlyArray<PartComponent>;\n\n  readonly hint?: string;\n}\n\nconst componentName = (type: unknown): string =>\n  P.isString(type)\n    ? type\n    : P.isFunction(type)\n      ? type.name || \"anonymous\"\n      : \"element\";\n\nconst fragmentChildren = (element: ReactElement<unknown>): ReactNode =>\n  hasChildren(element.props) ? element.props.children : undefined;\n\nconst hasChildren = (\n  value: unknown,\n): value is { readonly children?: ReactNode } =>\n  P.isObject(value) && \"children\" in value;\n\nconst leaves = (children: ReactNode): ReadonlyArray<unknown> =>\n  Arr.flatMap(Children.toArray(children), (child) =>\n    isValidElement<unknown>(child) && child.type === Fragment\n      ? leaves(fragmentChildren(child))\n      : [child],\n  );\n\nexport const assertParts = (\n  contract: PartsContract,\n  children: ReactNode,\n): void => {\n  Arr.forEach(leaves(children), (leaf) => {\n    if (!isValidElement(leaf)) return;\n    if (Arr.some(contract.accepts, (part) => part === leaf.type)) return;\n    if (!Arr.some(contract.family, (part) => part === leaf.type)) return;\n\n    throw new Error(\n      `${componentName(leaf.type)} cannot be used inside ${contract.parent}.` +\n        (contract.hint === undefined ? \"\" : ` ${contract.hint}`),\n    );\n  });\n};\n"
    },
    {
      "path": "packages/components/src/internal/placement.ts",
      "target": "@ui/gpuixui/components/internal/placement.ts",
      "type": "registry:lib",
      "content": "import type { FloatingAlign, FloatingSide } from \"@gpuix/react/floating\";\nimport { Match } from \"effect\";\nimport * as Schema from \"effect/Schema\";\n\nexport interface FloatingBounds {\n  readonly x: number;\n  readonly y: number;\n  readonly width: number;\n  readonly height: number;\n}\n\nexport interface WindowBounds {\n  readonly width: number;\n  readonly height: number;\n}\n\nexport interface PlacementInput {\n  readonly side: unknown;\n\n  readonly align: unknown;\n  readonly trigger: FloatingBounds;\n\n  readonly surface: FloatingBounds;\n  readonly window: WindowBounds;\n  readonly margin: number;\n}\n\nexport interface Placement {\n  readonly side: FloatingSide;\n  readonly align: FloatingAlign;\n  readonly alignOffset: number;\n}\n\nconst PlacementSide = Schema.Literals([\"top\", \"right\", \"bottom\", \"left\"]);\n\nexport const isAlign = Schema.is(Schema.Literals([\"start\", \"center\", \"end\"]));\n\nconst sideOf = (side: unknown): FloatingSide =>\n  Schema.is(PlacementSide)(side) ? side : \"bottom\";\n\nconst alignOf = (align: unknown): FloatingAlign =>\n  isAlign(align) ? align : \"start\";\n\nconst oppositeSide = (side: unknown): FloatingSide =>\n  Match.value(sideOf(side)).pipe(\n    Match.when(\"top\", () => \"bottom\" as const),\n    Match.when(\"bottom\", () => \"top\" as const),\n    Match.when(\"left\", () => \"right\" as const),\n    Match.when(\"right\", () => \"left\" as const),\n    Match.exhaustive,\n  );\n\nconst roomOn = (side: unknown, input: PlacementInput): number =>\n  Match.value(sideOf(side)).pipe(\n    Match.when(\"top\", () => input.trigger.y - input.margin),\n    Match.when(\n      \"bottom\",\n      () =>\n        input.window.height -\n        input.margin -\n        (input.trigger.y + input.trigger.height),\n    ),\n    Match.when(\"left\", () => input.trigger.x - input.margin),\n    Match.when(\n      \"right\",\n      () =>\n        input.window.width -\n        input.margin -\n        (input.trigger.x + input.trigger.width),\n    ),\n    Match.exhaustive,\n  );\n\nconst extentOn = (side: unknown, surface: FloatingBounds): number =>\n  Match.value(sideOf(side)).pipe(\n    Match.when(\"top\", () => surface.height),\n    Match.when(\"bottom\", () => surface.height),\n    Match.when(\"left\", () => surface.width),\n    Match.when(\"right\", () => surface.width),\n    Match.exhaustive,\n  );\n\nexport const resolveSide = (input: PlacementInput): FloatingSide => {\n  const side = sideOf(input.side);\n  const extent = extentOn(side, input.surface);\n  if (roomOn(side, input) >= extent) return side;\n\n  const opposite = oppositeSide(side);\n  const oppositeRoom = roomOn(opposite, input);\n  if (oppositeRoom >= extentOn(opposite, input.surface)) return opposite;\n\n  return oppositeRoom > roomOn(side, input) ? opposite : side;\n};\n\nconst alignOffsetOn = (\n  side: unknown,\n  align: unknown,\n  trigger: FloatingBounds,\n  surface: FloatingBounds,\n): number =>\n  Match.value(alignOf(align)).pipe(\n    Match.when(\"center\", () =>\n      Match.value(sideOf(side)).pipe(\n        Match.when(\"top\", () => (trigger.width - surface.width) / 2),\n        Match.when(\"bottom\", () => (trigger.width - surface.width) / 2),\n        Match.when(\"left\", () => (trigger.height - surface.height) / 2),\n        Match.when(\"right\", () => (trigger.height - surface.height) / 2),\n        Match.exhaustive,\n      ),\n    ),\n    Match.when(\"start\", () => 0),\n    Match.when(\"end\", () => 0),\n    Match.exhaustive,\n  );\n\nconst hostAlign = (align: FloatingAlign): \"start\" | \"end\" =>\n  align === \"end\" ? \"end\" : \"start\";\n\nexport const requestedPlacement = (\n  side: unknown,\n  align: unknown,\n): Placement => ({\n  side: sideOf(side),\n  align: hostAlign(alignOf(align)),\n  alignOffset: 0,\n});\n\nexport const resolvePlacement = (input: PlacementInput): Placement => {\n  const side = resolveSide(input);\n  return {\n    side,\n    align: hostAlign(alignOf(input.align)),\n    alignOffset: alignOffsetOn(side, input.align, input.trigger, input.surface),\n  };\n};\n"
    },
    {
      "path": "packages/components/src/internal/presence.tsx",
      "target": "@ui/gpuixui/components/internal/presence.tsx",
      "type": "registry:component",
      "content": "/** @jsxImportSource @gpuix/react */\nimport type { MotionProps } from \"@gpuix/react\";\nimport {\n  delayedTiming,\n  exitWindowMs,\n  fadeFrom,\n  fadeFromAnchor,\n  fadeFromSide,\n  fadeOnly,\n  presenceMotion as motionOfPresence,\n  presenceStyle,\n  transitionWindowMs,\n  type PresenceFrames,\n  type PresenceHitRule,\n  type PresenceSide,\n  type PresenceTiming,\n  type PresenceTransition,\n} from \"../../motion/presence.js\";\nimport {\n  MotionProvider,\n  useMotionPreference,\n  useSurfacePresence,\n  useSurfaceTiming,\n  type MotionProviderProps,\n  type SurfacePresence,\n} from \"../../motion/react/presence.js\";\nimport {\n  motionTiming,\n  type MotionLevel,\n  type MotionPreference,\n} from \"../../motion/timing.js\";\n\nexport { MotionProvider, useMotionPreference, type MotionProviderProps };\n\nexport type SurfaceFrames = PresenceFrames;\n\nexport type SurfaceTiming = PresenceTiming;\n\nexport type PanelSide = PresenceSide;\n\nexport {\n  delayedTiming,\n  exitWindowMs,\n  fadeFrom,\n  fadeFromAnchor,\n  fadeFromSide,\n  fadeOnly,\n  presenceStyle,\n  transitionWindowMs,\n};\nexport type { PresenceHitRule };\n\nexport { useSurfacePresence, useSurfaceTiming, type SurfacePresence };\n\nexport const moveTiming = (\n  level: MotionLevel,\n  preference: MotionPreference,\n): PresenceTransition => motionTiming(level, { phase: \"standard\", preference });\n\nexport const useMoveTiming = (level: MotionLevel): PresenceTransition =>\n  moveTiming(level, useMotionPreference());\n\nexport const presenceMotion = (\n  frames: SurfaceFrames,\n  presence: SurfacePresence,\n  timing: SurfaceTiming = presence.timing,\n): MotionProps => motionOfPresence(frames, presence.present, timing);\n\nexport const PresenceShield = ({ present }: { readonly present: boolean }) =>\n  present ? null : (\n    <div\n      testId=\"presence-shield\"\n      style={{ position: \"absolute\", top: 0, right: 0, bottom: 0, left: 0 }}\n    />\n  );\n\nexport const presenceTabStop = (\n  present: boolean,\n): { readonly tabIndex?: number } => (present ? {} : { tabIndex: -1 });\n"
    },
    {
      "path": "packages/components/src/internal/recipe.ts",
      "target": "@ui/gpuixui/components/internal/recipe.ts",
      "type": "registry:lib",
      "content": "import type { StyleDesc } from \"@gpuix/react\";\nimport { createRecipeCache } from \"../../tw/index.js\";\nimport type { Theme } from \"./theme.js\";\n\nexport const recipeStyle: (recipe: string, theme: Theme) => StyleDesc =\n  createRecipeCache(512);\n"
    },
    {
      "path": "packages/components/src/internal/ref.ts",
      "target": "@ui/gpuixui/components/internal/ref.ts",
      "type": "registry:lib",
      "content": "import type { Ref, RefCallback } from \"react\";\nimport { useCallback } from \"react\";\n\nconst assign = <T>(ref: Ref<T> | undefined, value: T): void => {\n  if (ref === null || ref === undefined) return;\n  if (typeof ref === \"function\") {\n    ref(value);\n    return;\n  }\n  ref.current = value;\n};\n\nexport const useMergedRef = <T>(\n  internal: Ref<T>,\n  caller: Ref<T> | undefined,\n): RefCallback<T> =>\n  useCallback(\n    (value: T) => {\n      assign(internal, value);\n      assign(caller, value);\n    },\n    [internal, caller],\n  );\n"
    },
    {
      "path": "packages/components/src/internal/theme.ts",
      "target": "@ui/gpuixui/components/internal/theme.ts",
      "type": "registry:lib",
      "content": "import type { StyleDesc } from \"@gpuix/react\";\nimport * as Schema from \"effect/Schema\";\nimport {\n  alpha,\n  avatarPixels,\n  avatarSize,\n  brandTextOn,\n  controlFocusRing,\n  controlHeight,\n  controlPaddingX,\n  currentPlatform,\n  darkTheme,\n  disabledAction,\n  disabledOpacity,\n  elevationShadow,\n  filledHover,\n  filledPressed,\n  findHighlight,\n  focusRing,\n  keyboardFocusRing,\n  lightTheme,\n  nativeTextTheme,\n  pointerWash,\n  selectionOn,\n  statusTone,\n  syntaxColors,\n  targetSize,\n  textStyle,\n  type BoxShadow,\n  type ElevationLevel,\n  type FindHighlightSource,\n  type NativeTextFill,\n  type PlatformName,\n  type PointerWashSurface,\n  type StatusTone,\n  type SyntaxColors,\n  type SyntaxRole,\n  type TextRole,\n  type Theme,\n  type ThemeColors,\n} from \"../../tokens/index.js\";\n\nexport {\n  alpha,\n  avatarPixels,\n  avatarSize,\n  controlFocusRing,\n  controlHeight,\n  controlPaddingX,\n  currentPlatform,\n  darkTheme,\n  disabledAction,\n  disabledOpacity,\n  elevationShadow,\n  filledHover,\n  filledPressed,\n  findHighlight,\n  focusRing,\n  keyboardFocusRing,\n  lightTheme,\n  nativeTextTheme,\n  statusTone,\n  syntaxColors,\n  targetSize,\n  textStyle,\n};\nexport type {\n  BoxShadow,\n  ElevationLevel,\n  FindHighlightSource,\n  NativeTextFill,\n  PlatformName,\n  StatusTone,\n  SyntaxColors,\n  SyntaxRole,\n  TextRole,\n  Theme,\n};\nexport { ThemeProvider, useTheme } from \"../../tokens/react.js\";\n\nexport const keyboardRing = (theme: Theme, invalid = false): StyleDesc =>\n  controlFocusRing(theme, { invalid }) ?? {};\n\nexport interface ControlRingState {\n  readonly disabled?: boolean;\n\n  readonly invalid?: boolean;\n}\n\nexport const controlRing = (\n  theme: Theme,\n  state: ControlRingState = {},\n): StyleDesc => controlFocusRing(theme, state) ?? {};\n\nexport const pressWash = (theme: Theme, replaced: PointerWashSurface): string =>\n  pointerWash(theme, \"active\", replaced) ?? theme.colors.active;\n\nexport const selectionWash = (theme: Theme): StyleDesc => ({\n  selectionColor: theme.colors.selection,\n});\n\nexport const keepContent: StyleDesc = { keyboardFocusDim: false };\n\nexport const disabledFade = (\n  disabled: boolean,\n): { readonly opacity: number } | undefined =>\n  disabled ? { opacity: disabledOpacity } : undefined;\n\nconst Tones = Schema.Literals([\"info\", \"success\", \"warning\", \"danger\"]);\n\nexport type Tone = typeof Tones.Type;\n\nexport const toneOf = (value: unknown): Tone =>\n  Schema.is(Tones)(value) ? value : \"info\";\n\nexport interface ToneStyle {\n  readonly fg: string;\n  readonly bg: string;\n  readonly border: string;\n}\n\nconst TOKEN_TONE: Readonly<Record<Tone, StatusTone>> = {\n  info: \"info\",\n  success: \"success\",\n  warning: \"warning\",\n  danger: \"destructive\",\n};\n\nexport const tone = (theme: Theme, value: Tone): ToneStyle => {\n  const { background, border, foreground } = statusTone(\n    theme,\n    TOKEN_TONE[value],\n  );\n  return { bg: background, border, fg: foreground };\n};\n\nconst softRoles: Readonly<Record<Tone, keyof ThemeColors>> = {\n  info: \"infoSoft\",\n  success: \"successSoft\",\n  warning: \"warningSoft\",\n  danger: \"destructiveSoft\",\n};\n\nexport const messageLink = (theme: Theme, value: Tone): string =>\n  brandTextOn(theme, softRoles[value]);\n\nexport const messageSelection = (theme: Theme, value: Tone): string =>\n  selectionOn(theme, softRoles[value]);\n\nexport const toneSurface = (theme: Theme, value: Tone): StyleDesc => {\n  const { bg, border, fg } = tone(theme, value);\n  return {\n    backgroundColor: bg,\n    color: fg,\n    borderWidth: theme.borderWidth.thin,\n    borderColor: border,\n  };\n};\n"
    },
    {
      "path": "packages/components/src/internal/use-placement.ts",
      "target": "@ui/gpuixui/components/internal/use-placement.ts",
      "type": "registry:lib",
      "content": "import { useGpuix, type PublicInstance } from \"@gpuix/react\";\nimport type { FloatingAlign, FloatingSide } from \"@gpuix/react/floating\";\nimport * as Option from \"effect/Option\";\nimport { useLayoutEffect, useRef, useState, type RefObject } from \"react\";\nimport {\n  requestedPlacement,\n  resolvePlacement,\n  type Placement,\n} from \"./placement.js\";\n\nexport interface UsePlacementInput {\n  readonly open: boolean;\n  readonly side: FloatingSide;\n  readonly align: FloatingAlign;\n  readonly margin: number;\n  readonly trigger: RefObject<PublicInstance | null>;\n  readonly surface: RefObject<PublicInstance | null>;\n}\n\nconst boundsOf = (\n  renderer: ReturnType<typeof useGpuix>[\"renderer\"],\n  instance: PublicInstance | null,\n): Option.Option<{ x: number; y: number; width: number; height: number }> =>\n  Option.flatMap(Option.fromNullishOr(instance), (element) =>\n    Option.fromNullishOr(renderer?.getElementBounds?.(element.id)),\n  );\n\nexport const usePlacement = ({\n  open,\n  side,\n  align,\n  margin,\n  trigger,\n  surface,\n}: UsePlacementInput): Placement => {\n  const renderer = useGpuix().renderer;\n  const [placement, setPlacement] = useState<Option.Option<Placement>>(\n    Option.none(),\n  );\n  const measuredFor = useRef<string | null>(null);\n  const key = `${side}:${align}:${margin}`;\n\n  useLayoutEffect(() => {\n    if (!open) {\n      measuredFor.current = null;\n      setPlacement(Option.none());\n      return;\n    }\n    if (measuredFor.current === key) return;\n\n    const measured = Option.all({\n      trigger: boundsOf(renderer, trigger.current),\n      surface: boundsOf(renderer, surface.current),\n      window: Option.fromNullishOr(renderer?.getWindowSize?.()),\n    });\n    if (Option.isNone(measured)) return;\n\n    measuredFor.current = key;\n    setPlacement(\n      Option.some(resolvePlacement({ ...measured.value, side, align, margin })),\n    );\n  }, [align, key, margin, open, renderer, side, surface, trigger]);\n\n  return Option.getOrElse(placement, () => requestedPlacement(side, align));\n};\n"
    }
  ],
  "docs": "[Combobox](https://gpuixui.sudokw.com/components/combobox) — These are GPUix native components: the files render through GPUix's reconciler against `@gpuix/react`, not the DOM, and need the per-platform `@gpuix/native` binding. The CLI installs the `@gpuixui/*` runtime the components import as registry items, so the copied tree resolves on its own; wrap it in `ThemeProvider` before it renders.",
  "meta": {
    "url": "/components/combobox",
    "kind": "component",
    "runtime": "gpuix",
    "registry": "gpuixui"
  }
}