@commercetools/nimbus-mcp 0.1.0 → 2.10.0

package/data/docs/types/ComboBoxRoot.json

@@ -0,0 +1,747 @@
+{
+  "tags": {
+    "example": "```tsx\n<ComboBox.Root\n  items={items}\n  getKey={(item) => item.id}\n  getTextValue={(item) => item.name}\n  onSelectionChange={(keys) => console.log(keys)}\n>\n  <ComboBox.Trigger>\n    <ComboBox.Input />\n  </ComboBox.Trigger>\n  <ComboBox.Popover>\n    <ComboBox.ListBox>\n      {(item) => <ComboBox.Option>{item.name}</ComboBox.Option>}\n    </ComboBox.ListBox>\n  </ComboBox.Popover>\n</ComboBox.Root>\n```",
+    "supportsStyleProps": ""
+  },
+  "filePath": "/home/runner/work/nimbus/nimbus/packages/nimbus/src/index.ts",
+  "description": "# ComboBox.Root\n\nRoot component for ComboBox that provides state management and context for all child components.\nHandles selection state, input filtering, menu open/close, and custom option creation.",
+  "displayName": "ComboBoxRoot",
+  "methods": [],
+  "props": {
+    "as": {
+      "defaultValue": null,
+      "description": "",
+      "name": "as",
+      "parent": {
+        "fileName": "nimbus/node_modules/.pnpm/@chakra-ui+react@3.34.0_@emotion+react@11.14.0_@types+react@19.2.14_react@19.2.0__react_10b2c786e2b7f83f500327a2347e0904/node_modules/@chakra-ui/react/dist/types/styled-system/factory.types.d.ts",
+        "name": "PolymorphicProps"
+      },
+      "declarations": [
+        {
+          "fileName": "nimbus/node_modules/.pnpm/@chakra-ui+react@3.34.0_@emotion+react@11.14.0_@types+react@19.2.14_react@19.2.0__react_10b2c786e2b7f83f500327a2347e0904/node_modules/@chakra-ui/react/dist/types/styled-system/factory.types.d.ts",
+          "name": "PolymorphicProps"
+        }
+      ],
+      "required": false,
+      "type": {
+        "name": "ElementType"
+      }
+    },
+    "asChild": {
+      "defaultValue": null,
+      "description": "",
+      "name": "asChild",
+      "parent": {
+        "fileName": "nimbus/node_modules/.pnpm/@chakra-ui+react@3.34.0_@emotion+react@11.14.0_@types+react@19.2.14_react@19.2.0__react_10b2c786e2b7f83f500327a2347e0904/node_modules/@chakra-ui/react/dist/types/styled-system/factory.types.d.ts",
+        "name": "PolymorphicProps"
+      },
+      "declarations": [
+        {
+          "fileName": "nimbus/node_modules/.pnpm/@chakra-ui+react@3.34.0_@emotion+react@11.14.0_@types+react@19.2.14_react@19.2.0__react_10b2c786e2b7f83f500327a2347e0904/node_modules/@chakra-ui/react/dist/types/styled-system/factory.types.d.ts",
+          "name": "PolymorphicProps"
+        }
+      ],
+      "required": false,
+      "type": {
+        "name": "boolean"
+      }
+    },
+    "css": {
+      "defaultValue": null,
+      "description": "",
+      "name": "css",
+      "parent": {
+        "fileName": "nimbus/node_modules/.pnpm/@chakra-ui+react@3.34.0_@emotion+react@11.14.0_@types+react@19.2.14_react@19.2.0__react_10b2c786e2b7f83f500327a2347e0904/node_modules/@chakra-ui/react/dist/types/styled-system/factory.types.d.ts",
+        "name": "JsxStyleProps"
+      },
+      "declarations": [
+        {
+          "fileName": "nimbus/node_modules/.pnpm/@chakra-ui+react@3.34.0_@emotion+react@11.14.0_@types+react@19.2.14_react@19.2.0__react_10b2c786e2b7f83f500327a2347e0904/node_modules/@chakra-ui/react/dist/types/styled-system/factory.types.d.ts",
+          "name": "JsxStyleProps"
+        }
+      ],
+      "required": false,
+      "type": {
+        "name": "SystemStyleObject | Omit<(SystemStyleObject)[], keyof any[]>"
+      }
+    },
+    "size": {
+      "defaultValue": {
+        "value": "\"md\""
+      },
+      "description": "Size variant of combobox",
+      "name": "size",
+      "declarations": [
+        {
+          "fileName": "nimbus/packages/nimbus/src/components/combobox/combobox.types.ts",
+          "name": "TypeLiteral"
+        }
+      ],
+      "required": false,
+      "type": {
+        "name": "ConditionalValue<\"sm\" | \"md\">"
+      }
+    },
+    "unstyled": {
+      "defaultValue": null,
+      "description": "If `true`, the element will opt out of the theme styles.",
+      "name": "unstyled",
+      "parent": {
+        "fileName": "nimbus/node_modules/.pnpm/@chakra-ui+react@3.34.0_@emotion+react@11.14.0_@types+react@19.2.14_react@19.2.0__react_10b2c786e2b7f83f500327a2347e0904/node_modules/@chakra-ui/react/dist/types/styled-system/factory.types.d.ts",
+        "name": "UnstyledProp"
+      },
+      "declarations": [
+        {
+          "fileName": "nimbus/node_modules/.pnpm/@chakra-ui+react@3.34.0_@emotion+react@11.14.0_@types+react@19.2.14_react@19.2.0__react_10b2c786e2b7f83f500327a2347e0904/node_modules/@chakra-ui/react/dist/types/styled-system/factory.types.d.ts",
+          "name": "UnstyledProp"
+        }
+      ],
+      "required": false,
+      "type": {
+        "name": "boolean"
+      }
+    },
+    "variant": {
+      "defaultValue": {
+        "value": "\"solid\""
+      },
+      "description": "Variant of combobox",
+      "name": "variant",
+      "declarations": [
+        {
+          "fileName": "nimbus/packages/nimbus/src/components/combobox/combobox.types.ts",
+          "name": "TypeLiteral"
+        }
+      ],
+      "required": false,
+      "type": {
+        "name": "ConditionalValue<\"solid\" | \"ghost\">"
+      }
+    },
+    "children": {
+      "defaultValue": null,
+      "description": "Render function for each item, or static JSX children.\nMust be React Aria collection elements (Section/Item components).",
+      "name": "children",
+      "declarations": [
+        {
+          "fileName": "nimbus/packages/nimbus/src/components/combobox/combobox.types.ts",
+          "name": "TypeLiteral"
+        }
+      ],
+      "required": false,
+      "type": {
+        "name": "ReactNode | ((values: T & { defaultChildren: ReactNode; } & ComboBoxRenderProps) => ReactNode)"
+      }
+    },
+    "selectionMode": {
+      "defaultValue": {
+        "value": "\"single\""
+      },
+      "description": "Selection mode - determines single vs multi-select behavior",
+      "name": "selectionMode",
+      "declarations": [
+        {
+          "fileName": "nimbus/packages/nimbus/src/components/combobox/combobox.types.ts",
+          "name": "TypeLiteral"
+        }
+      ],
+      "required": false,
+      "type": {
+        "name": "enum",
+        "raw": "\"multiple\" | \"single\"",
+        "value": [
+          {
+            "value": "\"multiple\""
+          },
+          {
+            "value": "\"single\""
+          }
+        ]
+      }
+    },
+    "items": {
+      "defaultValue": null,
+      "description": "Collection items to display.\nIf `children` is not provided, each item will be rendered using `getTextValue`.\n\nWhen `allowsCustomOptions` is enabled:\n- New items created via Enter key are automatically added to the collection\n- Both the items array and selection state are managed internally\n- Use `onCreateOption` callback for side effects (API calls, notifications, etc.)",
+      "name": "items",
+      "declarations": [
+        {
+          "fileName": "nimbus/packages/nimbus/src/components/combobox/combobox.types.ts",
+          "name": "TypeLiteral"
+        }
+      ],
+      "required": false,
+      "type": {
+        "name": "Iterable<T>"
+      }
+    },
+    "getKey": {
+      "defaultValue": {
+        "value": "useCallback((item) => (item.key ?? item.id), [])"
+      },
+      "description": "Function to extract unique key from each item when items do not have a `key` or `id` field.\nDefaults to using `item.key` or `item.id`.\n\n**Important:** Wrap this function in `useCallback` to prevent unnecessary\nre-synchronization of the list state.\n@param item - The item to extract the key from\n@returns The unique key for the item\n@example ```tsx\n// ✅ Good: Memoized with useCallback\nconst getKey = useCallback((item) => item.productId, []);\n<ComboBox.Root items={items} getKey={getKey} />\n\n// ❌ Bad: Inline function creates new identity on every render\n<ComboBox.Root items={items} getKey={(item) => item.productId} />\n```",
+      "name": "getKey",
+      "declarations": [
+        {
+          "fileName": "nimbus/packages/nimbus/src/components/combobox/combobox.types.ts",
+          "name": "TypeLiteral"
+        }
+      ],
+      "required": false,
+      "type": {
+        "name": "((item: T) => Key)"
+      }
+    },
+    "getTextValue": {
+      "defaultValue": {
+        "value": "useCallback((item) => item.label ?? item.name ?? String(item), [])"
+      },
+      "description": "Function to extract display text from each item when `children` is not provided.\nUsed for both rendering and filtering.\nDefaults to `item.label ?? item.name ?? String(item)`.\n\n**Important:** Wrap this function in `useCallback` for optimal performance.\n@param item - The item to extract text from\n@returns The display text for the item\n@example ```tsx\n// ✅ Good: Memoized with useCallback\nconst getTextValue = useCallback((item) => item.displayName, []);\n<ComboBox.Root items={items} getTextValue={getTextValue} />\n\n// ❌ Bad: Inline function creates new identity on every render\n<ComboBox.Root items={items} getTextValue={(item) => item.displayName} />\n```",
+      "name": "getTextValue",
+      "declarations": [
+        {
+          "fileName": "nimbus/packages/nimbus/src/components/combobox/combobox.types.ts",
+          "name": "TypeLiteral"
+        }
+      ],
+      "required": false,
+      "type": {
+        "name": "((item: T) => string)"
+      }
+    },
+    "selectedKeys": {
+      "defaultValue": null,
+      "description": "Controlled selected keys (unified for single/multi)\nSingle-select: pass a Key\nMulti-select: pass a Key[]\n\nInternally normalized to Set<Key> for React Stately",
+      "name": "selectedKeys",
+      "declarations": [
+        {
+          "fileName": "nimbus/packages/nimbus/src/components/combobox/combobox.types.ts",
+          "name": "TypeLiteral"
+        }
+      ],
+      "required": false,
+      "type": {
+        "name": "Key[]"
+      }
+    },
+    "onSelectionChange": {
+      "defaultValue": null,
+      "description": "Callback when selection changes\nAlways receives an array of keys regardless of selection mode:\n- Single-select: `[selectedKey]` or `[]` if nothing selected\n- Multi-select: `[key1, key2, ...]` or `[]` if nothing selected",
+      "name": "onSelectionChange",
+      "declarations": [
+        {
+          "fileName": "nimbus/packages/nimbus/src/components/combobox/combobox.types.ts",
+          "name": "TypeLiteral"
+        }
+      ],
+      "required": false,
+      "type": {
+        "name": "((keys: Key[]) => void)"
+      }
+    },
+    "disabledKeys": {
+      "defaultValue": null,
+      "description": "Keys of items that should be disabled and not selectable.\nDisabled items are still visible but cannot be selected or focused.\n@example ```tsx\n<ComboBox.Root\n  items={items}\n  disabledKeys={['item-2', 'item-5']}\n/>\n```",
+      "name": "disabledKeys",
+      "declarations": [
+        {
+          "fileName": "nimbus/packages/nimbus/src/components/combobox/combobox.types.ts",
+          "name": "TypeLiteral"
+        }
+      ],
+      "required": false,
+      "type": {
+        "name": "Iterable<Key>"
+      }
+    },
+    "inputValue": {
+      "defaultValue": null,
+      "description": "Input value for controlled mode\n\n**Controlled Mode:** When `onInputChange` is provided, you manage the input value.\nYou **MUST** update this prop in response to `onInputChange` for changes to be visible:\n- User typing in the input\n- Automatic sync on selection changes (single-select mode)\n- Input clearing after selection (multi-select mode)\n\n**Uncontrolled Mode:** When `onInputChange` is NOT provided, the component manages\nthe input value internally. You can still pass `inputValue` to set the initial value.\n@example ```tsx\n// ✅ Controlled: Update inputValue in response to onInputChange\nconst [inputValue, setInputValue] = useState(\"\");\n<ComboBox.Root\n  inputValue={inputValue}\n  onInputChange={setInputValue}\n/>\n\n// ✅ Uncontrolled: Component manages input internally\n<ComboBox.Root\n  inputValue=\"initial search text\"\n  // No onInputChange - component handles updates\n/>\n\n// ❌ Wrong: Controlled prop but never updated\n<ComboBox.Root\n  inputValue=\"fixed\"\n  onInputChange={(v) => console.log(v)} // Input will be frozen\n/>\n```",
+      "name": "inputValue",
+      "declarations": [
+        {
+          "fileName": "nimbus/packages/nimbus/src/components/combobox/combobox.types.ts",
+          "name": "TypeLiteral"
+        }
+      ],
+      "required": false,
+      "type": {
+        "name": "string"
+      }
+    },
+    "onInputChange": {
+      "defaultValue": null,
+      "description": "Callback when input value changes\n\n**When provided:** Enables controlled input mode. You must update `inputValue` prop\nin this callback for the input to update.\n\n**When NOT provided:** Component uses uncontrolled input mode and manages value internally.\n\nCalled when:\n- User types in the input\n- Selection changes in single-select mode (input syncs to selected item's text)\n- Option selected in multi-select mode (input clears)\n@param value - The new input value",
+      "name": "onInputChange",
+      "declarations": [
+        {
+          "fileName": "nimbus/packages/nimbus/src/components/combobox/combobox.types.ts",
+          "name": "TypeLiteral"
+        }
+      ],
+      "required": false,
+      "type": {
+        "name": "((value: string) => void)"
+      }
+    },
+    "placeholder": {
+      "defaultValue": null,
+      "description": "Placeholder text for input",
+      "name": "placeholder",
+      "declarations": [
+        {
+          "fileName": "nimbus/packages/nimbus/src/components/combobox/combobox.types.ts",
+          "name": "TypeLiteral"
+        }
+      ],
+      "required": false,
+      "type": {
+        "name": "string"
+      }
+    },
+    "menuTrigger": {
+      "defaultValue": {
+        "value": "\"input\""
+      },
+      "description": "Controls when the menu opens.\n- \"focus\": Opens when input receives focus\n- \"input\": Opens when user types (input value changes)\n- \"manual\": Only opens via button click or arrow down key",
+      "name": "menuTrigger",
+      "declarations": [
+        {
+          "fileName": "nimbus/packages/nimbus/src/components/combobox/combobox.types.ts",
+          "name": "TypeLiteral"
+        }
+      ],
+      "required": false,
+      "type": {
+        "name": "enum",
+        "raw": "\"input\" | \"manual\" | \"focus\"",
+        "value": [
+          {
+            "value": "\"input\""
+          },
+          {
+            "value": "\"manual\""
+          },
+          {
+            "value": "\"focus\""
+          }
+        ]
+      }
+    },
+    "shouldCloseOnBlur": {
+      "defaultValue": {
+        "value": "true"
+      },
+      "description": "Whether the menu should close when the combobox loses focus.\nSet to false to keep menu open when clicking outside.",
+      "name": "shouldCloseOnBlur",
+      "declarations": [
+        {
+          "fileName": "nimbus/packages/nimbus/src/components/combobox/combobox.types.ts",
+          "name": "TypeLiteral"
+        }
+      ],
+      "required": false,
+      "type": {
+        "name": "boolean"
+      }
+    },
+    "shouldCloseOnSelect": {
+      "defaultValue": {
+        "value": "true"
+      },
+      "description": "Whether to close the menu after an item is selected (single-select only).\nMulti-select always keeps menu open after selection.",
+      "name": "shouldCloseOnSelect",
+      "declarations": [
+        {
+          "fileName": "nimbus/packages/nimbus/src/components/combobox/combobox.types.ts",
+          "name": "TypeLiteral"
+        }
+      ],
+      "required": false,
+      "type": {
+        "name": "boolean"
+      }
+    },
+    "isOpen": {
+      "defaultValue": null,
+      "description": "Controlled open state of the menu",
+      "name": "isOpen",
+      "declarations": [
+        {
+          "fileName": "nimbus/packages/nimbus/src/components/combobox/combobox.types.ts",
+          "name": "TypeLiteral"
+        }
+      ],
+      "required": false,
+      "type": {
+        "name": "boolean"
+      }
+    },
+    "defaultOpen": {
+      "defaultValue": {
+        "value": "false"
+      },
+      "description": "Default open state for uncontrolled mode",
+      "name": "defaultOpen",
+      "declarations": [
+        {
+          "fileName": "nimbus/packages/nimbus/src/components/combobox/combobox.types.ts",
+          "name": "TypeLiteral"
+        }
+      ],
+      "required": false,
+      "type": {
+        "name": "boolean"
+      }
+    },
+    "onOpenChange": {
+      "defaultValue": null,
+      "description": "Callback when menu open state changes",
+      "name": "onOpenChange",
+      "declarations": [
+        {
+          "fileName": "nimbus/packages/nimbus/src/components/combobox/combobox.types.ts",
+          "name": "TypeLiteral"
+        }
+      ],
+      "required": false,
+      "type": {
+        "name": "((isOpen: boolean) => void)"
+      }
+    },
+    "allowsEmptyMenu": {
+      "defaultValue": {
+        "value": "false"
+      },
+      "description": "Whether to keep the menu open when the filtered collection is empty.\nWhen false (default), the menu automatically closes when no items match the filter.\nWhen true, the menu stays open and can show empty state content.",
+      "name": "allowsEmptyMenu",
+      "declarations": [
+        {
+          "fileName": "nimbus/packages/nimbus/src/components/combobox/combobox.types.ts",
+          "name": "TypeLiteral"
+        }
+      ],
+      "required": false,
+      "type": {
+        "name": "boolean"
+      }
+    },
+    "renderEmptyState": {
+      "defaultValue": null,
+      "description": "Custom render function for empty state when no items match the filter.\nOnly shown when `allowsEmptyMenu` is true and collection is empty.\nPassed through to React Aria's ListBox renderEmptyState prop.\n@example ```tsx\n<ComboBox.Root\n  allowsEmptyMenu={true}\n  renderEmptyState={() => (\n    <Box padding=\"400\" textAlign=\"center\">\n      <Text color=\"fg.muted\">No results found</Text>\n    </Box>\n  )}\n/>\n```",
+      "name": "renderEmptyState",
+      "declarations": [
+        {
+          "fileName": "nimbus/packages/nimbus/src/components/combobox/combobox.types.ts",
+          "name": "TypeLiteral"
+        }
+      ],
+      "required": false,
+      "type": {
+        "name": "(() => ReactNode)"
+      }
+    },
+    "isLoading": {
+      "defaultValue": null,
+      "description": "External loading state for displaying loading indicators.\nUseful when managing async data loading externally with React Stately's useAsyncList.\n\n**Note:** When using the built-in `async` prop, loading state is managed automatically.\nThis prop is only needed for external async management.\n@example ```tsx\n// External async control with useAsyncList\nconst asyncList = useAsyncList({\n  async load({ filterText, signal }) {\n    const res = await fetch(`/api/search?q=${filterText}`, { signal });\n    return { items: await res.json() };\n  }\n});\n\n<ComboBox.Root\n  items={asyncList.items}\n  isLoading={asyncList.loadingState === 'loading'}\n  inputValue={asyncList.filterText}\n  onInputChange={(value) => asyncList.setFilterText(value)}\n>\n  {(item) => <ComboBox.Option>{item.name}</ComboBox.Option>}\n</ComboBox.Root>\n```",
+      "name": "isLoading",
+      "declarations": [
+        {
+          "fileName": "nimbus/packages/nimbus/src/components/combobox/combobox.types.ts",
+          "name": "TypeLiteral"
+        }
+      ],
+      "required": false,
+      "type": {
+        "name": "boolean"
+      }
+    },
+    "async": {
+      "defaultValue": null,
+      "description": "Built-in async loading configuration with automatic state management.\n\nWhen provided, ComboBox automatically handles:\n- Loading state management\n- Request debouncing (300ms default)\n- Request cancellation on input changes\n- Automatic filter bypass (since API handles filtering)\n- Minimum search length validation\n- Error handling with optional callback\n\n**Important:** When using `async`, do NOT provide `items`, `isLoading`, `inputValue`, or `onInputChange`.\nThese are managed automatically by the internal useAsyncList integration.\n@example ```tsx\n// Simple async search\n<ComboBox.Root\n  async={{\n    load: async (filterText, signal) => {\n      const response = await fetch(\n        `/api/search?q=${encodeURIComponent(filterText)}`,\n        { signal }\n      );\n      return response.json();\n    }\n  }}\n>\n  {(item: SearchResult) => (\n    <ComboBox.Option>{item.name}</ComboBox.Option>\n  )}\n</ComboBox.Root>\n\n// With configuration and error handling\n<ComboBox.Root\n  async={{\n    load: async (filterText, signal) => {\n      const response = await fetch(`/api/search?q=${filterText}`, { signal });\n      const data = await response.json();\n      return data.results;\n    },\n    minSearchLength: 2,\n    debounce: 500,\n    onError: (error) => {\n      console.error('Search failed:', error);\n      toast.error('Failed to load results');\n    }\n  }}\n/>\n```",
+      "name": "async",
+      "declarations": [
+        {
+          "fileName": "nimbus/packages/nimbus/src/components/combobox/combobox.types.ts",
+          "name": "TypeLiteral"
+        }
+      ],
+      "required": false,
+      "type": {
+        "name": "ComboBoxAsyncConfig<T>"
+      }
+    },
+    "allowsCustomOptions": {
+      "defaultValue": {
+        "value": "false"
+      },
+      "description": "Whether to allow creating custom options that don't exist in the items collection.\nWhen enabled and input doesn't match any existing option, pressing Enter will create\na new option using `getNewOptionData`.\n\nRequires providing `getNewOptionData` to transform input value into item object.\n@example ```tsx\n<ComboBox.Root\n  items={tags}\n  allowsCustomOptions={true}\n  getNewOptionData={(inputValue) => ({\n    id: `tag-${Date.now()}`,\n    label: inputValue,\n  })}\n  onCreateOption={(inputValue) => {\n    console.log('Created new tag:', inputValue);\n  }}\n/>\n```",
+      "name": "allowsCustomOptions",
+      "declarations": [
+        {
+          "fileName": "nimbus/packages/nimbus/src/components/combobox/combobox.types.ts",
+          "name": "TypeLiteral"
+        }
+      ],
+      "required": false,
+      "type": {
+        "name": "boolean"
+      }
+    },
+    "isValidNewOption": {
+      "defaultValue": null,
+      "description": "Function to validate whether the current input value is valid for creating a new option.\nIf not provided, any non-empty input that doesn't match an existing option is valid.\n\nBased on react-select's isValidNewOption API.\n@param inputValue - The current input value\n@returns True if the input is valid for creating a new option\n@example ```tsx\n// Only allow creating tags that start with '#'\nisValidNewOption={(inputValue) => {\n  return inputValue.startsWith('#') && inputValue.length > 1;\n}}\n\n// Only allow email addresses\nisValidNewOption={(inputValue) => {\n  return /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/.test(inputValue);\n}}\n```",
+      "name": "isValidNewOption",
+      "declarations": [
+        {
+          "fileName": "nimbus/packages/nimbus/src/components/combobox/combobox.types.ts",
+          "name": "TypeLiteral"
+        }
+      ],
+      "required": false,
+      "type": {
+        "name": "((inputValue: string) => boolean)"
+      }
+    },
+    "getNewOptionData": {
+      "defaultValue": null,
+      "description": "Function to transform the input value into a new item object when creating a custom option.\nRequired when `allowsCustomValue` is true.\n\nThe returned item must be compatible with your items type and have properties\nthat `getKey` and `getTextValue` can extract.\n\nBased on react-select's getNewOptionData API.\n@param inputValue - The input value to transform\n@returns A new item object to add to the collection\n@example ```tsx\n// Simple tag creation\ngetNewOptionData={(inputValue) => ({\n  id: `tag-${Date.now()}`,\n  label: inputValue,\n})}\n\n// Product creation with additional fields\ngetNewOptionData={(inputValue) => ({\n  id: `product-${Date.now()}`,\n  name: inputValue,\n  category: 'uncategorized',\n  createdAt: new Date(),\n})}\n```",
+      "name": "getNewOptionData",
+      "declarations": [
+        {
+          "fileName": "nimbus/packages/nimbus/src/components/combobox/combobox.types.ts",
+          "name": "TypeLiteral"
+        }
+      ],
+      "required": false,
+      "type": {
+        "name": "((inputValue: string) => T)"
+      }
+    },
+    "onCreateOption": {
+      "defaultValue": null,
+      "description": "Callback when a new option is created via Enter key on valid input.\nCalled after the item is added to the collection and selected.\n\nUse this for side effects like API calls, analytics, or notifications.\n\nBased on react-select's onCreateOption API.\nNote: Unlike react-select, selection changes are still handled by `onSelectionChange`.\n@param newOption - The option that was created\n@example ```tsx\nonCreateOption={async (newOption) => {\n  // Make API call to persist\n  await createTagAPI(newOption);\n\n  // Show notification\n  toast.success(`Created tag: ${newOption.value}`);\n}}\n```",
+      "name": "onCreateOption",
+      "declarations": [
+        {
+          "fileName": "nimbus/packages/nimbus/src/components/combobox/combobox.types.ts",
+          "name": "TypeLiteral"
+        }
+      ],
+      "required": false,
+      "type": {
+        "name": "((newOption: T) => void)"
+      }
+    },
+    "leadingElement": {
+      "defaultValue": null,
+      "description": "Leading visual element rendered before the input\nCommon use cases: search icon, category indicator\n\n**Accessibility**: Ensure decorative elements have aria-hidden=\"true\".\nIf the element is functional (clickable), it needs its own aria-label.\n@example ```tsx\n// Decorative icon (recommended)\n<ComboBox.Root leadingElement={<Icons.Search aria-hidden=\"true\" />} />\n\n// Functional element (needs aria-label)\n<ComboBox.Root leadingElement={<Button aria-label=\"Clear search\"><Icons.Close /></Button>} />\n```",
+      "name": "leadingElement",
+      "declarations": [
+        {
+          "fileName": "nimbus/packages/nimbus/src/components/combobox/combobox.types.ts",
+          "name": "TypeLiteral"
+        }
+      ],
+      "required": false,
+      "type": {
+        "name": "ReactNode"
+      }
+    },
+    "isDisabled": {
+      "defaultValue": {
+        "value": "false"
+      },
+      "description": "Whether component is disabled",
+      "name": "isDisabled",
+      "declarations": [
+        {
+          "fileName": "nimbus/packages/nimbus/src/components/combobox/combobox.types.ts",
+          "name": "TypeLiteral"
+        }
+      ],
+      "required": false,
+      "type": {
+        "name": "boolean"
+      }
+    },
+    "isRequired": {
+      "defaultValue": {
+        "value": "false"
+      },
+      "description": "Whether component is required",
+      "name": "isRequired",
+      "declarations": [
+        {
+          "fileName": "nimbus/packages/nimbus/src/components/combobox/combobox.types.ts",
+          "name": "TypeLiteral"
+        }
+      ],
+      "required": false,
+      "type": {
+        "name": "boolean"
+      }
+    },
+    "isInvalid": {
+      "defaultValue": {
+        "value": "false"
+      },
+      "description": "Whether component is invalid",
+      "name": "isInvalid",
+      "declarations": [
+        {
+          "fileName": "nimbus/packages/nimbus/src/components/combobox/combobox.types.ts",
+          "name": "TypeLiteral"
+        }
+      ],
+      "required": false,
+      "type": {
+        "name": "boolean"
+      }
+    },
+    "isReadOnly": {
+      "defaultValue": {
+        "value": "false"
+      },
+      "description": "Whether component is read-only",
+      "name": "isReadOnly",
+      "declarations": [
+        {
+          "fileName": "nimbus/packages/nimbus/src/components/combobox/combobox.types.ts",
+          "name": "TypeLiteral"
+        }
+      ],
+      "required": false,
+      "type": {
+        "name": "boolean"
+      }
+    },
+    "shouldFocusWrap": {
+      "defaultValue": {
+        "value": "true"
+      },
+      "description": "Whether keyboard focus should wrap around when navigating through options.\nWhen true, pressing ArrowDown on the last option moves focus to the first option,\nand pressing ArrowUp on the first option moves focus to the last option.",
+      "name": "shouldFocusWrap",
+      "declarations": [
+        {
+          "fileName": "nimbus/packages/nimbus/src/components/combobox/combobox.types.ts",
+          "name": "TypeLiteral"
+        }
+      ],
+      "required": false,
+      "type": {
+        "name": "boolean"
+      }
+    },
+    "name": {
+      "defaultValue": null,
+      "description": "The name of the input element, used when submitting an HTML form.\n@see https://react-spectrum.adobe.com/react-aria/forms.html",
+      "name": "name",
+      "declarations": [
+        {
+          "fileName": "nimbus/packages/nimbus/src/components/combobox/combobox.types.ts",
+          "name": "TypeLiteral"
+        }
+      ],
+      "required": false,
+      "type": {
+        "name": "string"
+      }
+    },
+    "formValue": {
+      "defaultValue": null,
+      "description": "The current value of the hidden input element for form submission.\nBy default, the selected key is submitted. Use this to customize the submitted value.\n@see https://react-spectrum.adobe.com/react-aria/forms.html",
+      "name": "formValue",
+      "declarations": [
+        {
+          "fileName": "nimbus/packages/nimbus/src/components/combobox/combobox.types.ts",
+          "name": "TypeLiteral"
+        }
+      ],
+      "required": false,
+      "type": {
+        "name": "enum",
+        "raw": "\"text\" | \"key\"",
+        "value": [
+          {
+            "value": "\"text\""
+          },
+          {
+            "value": "\"key\""
+          }
+        ]
+      }
+    },
+    "validationBehavior": {
+      "defaultValue": {
+        "value": "'aria'"
+      },
+      "description": "Whether to use native HTML form validation to prevent form submission\nwhen the value is missing or invalid, or mark the field as required\nor invalid via ARIA.",
+      "name": "validationBehavior",
+      "declarations": [
+        {
+          "fileName": "nimbus/packages/nimbus/src/components/combobox/combobox.types.ts",
+          "name": "TypeLiteral"
+        }
+      ],
+      "required": false,
+      "type": {
+        "name": "enum",
+        "raw": "\"native\" | \"aria\"",
+        "value": [
+          {
+            "value": "\"native\""
+          },
+          {
+            "value": "\"aria\""
+          }
+        ]
+      }
+    },
+    "form": {
+      "defaultValue": null,
+      "description": "The form element to associate the input with.\nAccepts either an HTML form element or the id of a form element.",
+      "name": "form",
+      "declarations": [
+        {
+          "fileName": "nimbus/packages/nimbus/src/components/combobox/combobox.types.ts",
+          "name": "TypeLiteral"
+        }
+      ],
+      "required": false,
+      "type": {
+        "name": "string | HTMLFormElement"
+      }
+    },
+    "validate": {
+      "defaultValue": null,
+      "description": "A function that validates the current value and returns an error message if invalid.\nCalled when the value changes and on form submission.\n@see https://react-spectrum.adobe.com/react-aria/forms.html#validation",
+      "name": "validate",
+      "declarations": [
+        {
+          "fileName": "nimbus/packages/nimbus/src/components/combobox/combobox.types.ts",
+          "name": "TypeLiteral"
+        }
+      ],
+      "required": false,
+      "type": {
+        "name": "((value: string | null) => string | string[] | null)"
+      }
+    },
+    "ref": {
+      "defaultValue": null,
+      "description": "Ref to the root element",
+      "name": "ref",
+      "declarations": [
+        {
+          "fileName": "nimbus/packages/nimbus/src/components/combobox/combobox.types.ts",
+          "name": "TypeLiteral"
+        }
+      ],
+      "required": false,
+      "type": {
+        "name": "Ref<HTMLDivElement>"
+      }
+    }
+  },
+  "supportsStyleProps": true
+}