@rfdtech/components 1.22.0 → 2.0.1

package/dist/mcp/generated/search.json

@@ -0,0 +1,1626 @@
+[
+  {
+    "slug": "app-header",
+    "name": "AppHeader",
+    "category": "Components",
+    "keywords": [
+      "app header",
+      "header bar",
+      "top bar",
+      "navbar",
+      "search bar",
+      "profile menu",
+      "notifications"
+    ],
+    "description": "Top bar with search and profile",
+    "headings": [
+      "AppHeader",
+      "Example",
+      "Variants",
+      "Components",
+      "`AppHeader`",
+      "`AppHeaderActions`",
+      "`AppHeaderBranding`",
+      "`AppHeaderSearch`",
+      "`AppHeaderNotifications`",
+      "`AppHeaderNotificationItem`",
+      "Profile trigger",
+      "Types",
+      "`AppHeaderProps`",
+      "`AppHeaderActionsProps`",
+      "`AppHeaderBrandingProps`",
+      "`AppHeaderSearchProps`",
+      "`AppHeaderSearchDataGroup`",
+      "`AppHeaderSearchItem`",
+      "`AppHeaderNotificationsProps`",
+      "`AppHeaderNotificationItemProps`",
+      "`AppHeaderNotificationItemClassNames`",
+      "`AppHeaderProfileProps` (deprecated)",
+      "Notes",
+      "Design tokens",
+      "AppHeader",
+      "Avatar"
+    ]
+  },
+  {
+    "slug": "app-layout",
+    "name": "AppLayout",
+    "category": "Components",
+    "keywords": [
+      "app layout",
+      "application shell",
+      "layout container",
+      "sidebar layout",
+      "page shell"
+    ],
+    "description": "Application shell layout",
+    "headings": [
+      "AppLayout",
+      "Example",
+      "Variants",
+      "Components",
+      "`AppLayout`",
+      "`AppSidebar`",
+      "`AppBody`",
+      "Breadcrumbs",
+      "Types",
+      "`AppLayoutProps`",
+      "`AppSidebarProps`",
+      "`AppBodyProps`",
+      "Design tokens",
+      "Notes"
+    ]
+  },
+  {
+    "slug": "app-switcher",
+    "name": "AppSwitcher",
+    "category": "Components",
+    "keywords": [
+      "app switcher",
+      "9-dot menu",
+      "app launcher",
+      "product switcher",
+      "grid menu",
+      "deprecated"
+    ],
+    "description": "Deprecated — use Launchpad instead",
+    "headings": [
+      "AppSwitcher",
+      "Examples",
+      "Props",
+      "Types",
+      "`AppItem`",
+      "`AppSwitcherProps`",
+      "Hooks",
+      "Design tokens",
+      "Notes"
+    ]
+  },
+  {
+    "slug": "badge",
+    "name": "Badge",
+    "category": "Components",
+    "keywords": [
+      "badge",
+      "status label",
+      "count badge",
+      "pill",
+      "tag"
+    ],
+    "description": "Status and count label",
+    "headings": [
+      "Badge",
+      "Example",
+      "Props",
+      "Types",
+      "`BadgeProps`",
+      "`BadgeClassNames`",
+      "`BadgeVariant`",
+      "`BadgeSize`",
+      "Design tokens",
+      "Notes"
+    ]
+  },
+  {
+    "slug": "breadcrumb",
+    "name": "Breadcrumb",
+    "category": "Components",
+    "keywords": [
+      "breadcrumb",
+      "page trail",
+      "navigation trail",
+      "crumb",
+      "path navigation"
+    ],
+    "description": "Page trail navigation",
+    "headings": [
+      "Breadcrumb",
+      "Example",
+      "React Router",
+      "Components",
+      "`Breadcrumb`",
+      "`BreadcrumbList`",
+      "`BreadcrumbItem`",
+      "`BreadcrumbLink`",
+      "`BreadcrumbPage`",
+      "`BreadcrumbSeparator`",
+      "`BreadcrumbEllipsis`",
+      "Types",
+      "Design tokens",
+      "Notes"
+    ]
+  },
+  {
+    "slug": "bulk-import-modal",
+    "name": "BulkImportModal",
+    "category": "Components",
+    "keywords": [
+      "bulk import",
+      "csv upload",
+      "xlsx import",
+      "spreadsheet import",
+      "batch import"
+    ],
+    "description": "Spreadsheet import wizard",
+    "headings": [
+      "BulkImportModal",
+      "Example",
+      "Steps",
+      "Props",
+      "Design tokens",
+      "Notes"
+    ]
+  },
+  {
+    "slug": "button",
+    "name": "Button",
+    "category": "Components",
+    "keywords": [
+      "button",
+      "cta",
+      "action button",
+      "submit button",
+      "click",
+      "primary button"
+    ],
+    "description": "Action button with variants",
+    "headings": [
+      "Button",
+      "Example",
+      "Props",
+      "Types",
+      "`ButtonProps`",
+      "`ButtonClassNames`",
+      "`ButtonVariant`",
+      "`ButtonSize`",
+      "Design tokens",
+      "Notes",
+      "Do",
+      "Don't"
+    ]
+  },
+  {
+    "slug": "card",
+    "name": "Card",
+    "category": "Components",
+    "keywords": [
+      "card",
+      "surface",
+      "container",
+      "panel",
+      "content wrapper"
+    ],
+    "description": "Surface card container",
+    "headings": [
+      "Card",
+      "Example",
+      "Card",
+      "CardHeader",
+      "CardTitle",
+      "CardActions",
+      "Design tokens",
+      "Notes",
+      "Do",
+      "Don't"
+    ]
+  },
+  {
+    "slug": "changelog",
+    "name": "Changelog",
+    "category": "Guide",
+    "keywords": [
+      "changelog",
+      "release notes",
+      "version history",
+      "whats new"
+    ],
+    "description": "Release history",
+    "headings": [
+      "Changelog",
+      "[Unreleased]",
+      "[2.0.1] - 2026-07-16",
+      "Added",
+      "Breaking",
+      "Deprecated",
+      "Changed",
+      "Fixed",
+      "[2.0.0] - 2026-07-11",
+      "Breaking",
+      "Added",
+      "Changed",
+      "[1.22.0] - 2026-07-07",
+      "Added",
+      "Changed",
+      "Fixed",
+      "Removed",
+      "[1.20.0] - 2026-06-28",
+      "Added",
+      "Changed",
+      "Fixed",
+      "Removed",
+      "[1.19.0] - 2026-06-26",
+      "Added",
+      "Changed",
+      "Fixed",
+      "[1.18.1] - 2026-06-22",
+      "Fixed",
+      "Changed",
+      "[1.18.0] - 2026-06-21",
+      "Breaking",
+      "Added",
+      "Changed",
+      "[1.17.0] - 2026-06-20",
+      "Added",
+      "Changed",
+      "Fixed",
+      "[1.16.1] - 2026-06-19",
+      "Added",
+      "Fixed",
+      "Changed",
+      "[1.16.0] - 2026-06-19",
+      "Added",
+      "Changed",
+      "Fixed",
+      "[1.15.2] - 2026-06-19",
+      "Added",
+      "[1.15.1] - 2026-06-19",
+      "Changed",
+      "Fixed",
+      "Added",
+      "[1.14.0] - 2026-06-18",
+      "Changed",
+      "[1.13.2] - 2026-06-18",
+      "Changed",
+      "[1.13.1] - 2026-06-18",
+      "Added",
+      "Changed",
+      "Cleanups",
+      "Fixes",
+      "[1.13.0] - 2026-06-18",
+      "Added",
+      "Changed",
+      "[1.12.0] - 2026-06-18",
+      "Fixed",
+      "Changed",
+      "[1.11.0] - 2026-06-18",
+      "Added",
+      "[1.10.0] - 2026-06-18",
+      "[1.9.0] - 2026-06-17",
+      "Added",
+      "Changed",
+      "[1.8.0] - 2026-06-15",
+      "Added",
+      "Changed",
+      "Removed",
+      "[1.7.0] - 2026-06-15",
+      "Added",
+      "Changed",
+      "[1.5.0] - 2026-06-15",
+      "Added",
+      "Changed",
+      "[1.4.0] - 2026-06-14",
+      "Added",
+      "Changed",
+      "Removed",
+      "[1.3.0] - 2026-06-14",
+      "Added",
+      "Changed",
+      "[1.2.0] - 2026-06-14",
+      "Added",
+      "Changed",
+      "Removed",
+      "[1.0.3] - 2026-06-12",
+      "Added",
+      "[1.0.2] - 2026-06-12",
+      "Added",
+      "Changed",
+      "[1.0.0] - 2026-06-11",
+      "Added",
+      "Changed",
+      "Removed",
+      "[0.4.0] - 2026-06-11",
+      "Added",
+      "Changed"
+    ]
+  },
+  {
+    "slug": "checkbox",
+    "name": "Checkbox",
+    "category": "Components",
+    "keywords": [
+      "checkbox",
+      "toggle",
+      "boolean input",
+      "form checkbox"
+    ],
+    "description": "Accessible checkbox",
+    "headings": [
+      "Checkbox",
+      "Example",
+      "Props",
+      "Types",
+      "`CheckboxProps`",
+      "`CheckboxClassNames`",
+      "Design tokens",
+      "Notes"
+    ]
+  },
+  {
+    "slug": "combobox",
+    "name": "Combobox",
+    "category": "Components",
+    "keywords": [
+      "combobox",
+      "multi select",
+      "searchable select",
+      "autocomplete",
+      "typeahead"
+    ],
+    "description": "Searchable single- and multi-select popover list",
+    "headings": [
+      "Combobox",
+      "Example",
+      "Props",
+      "Types",
+      "`ComboboxProps`",
+      "`ComboboxOption`",
+      "`ComboboxClassNames`",
+      "Design tokens",
+      "Notes"
+    ]
+  },
+  {
+    "slug": "command",
+    "name": "Command",
+    "category": "Components",
+    "keywords": [
+      "command palette",
+      "cmd k",
+      "search menu",
+      "combobox",
+      "quick actions"
+    ],
+    "description": "Command palette and inline search",
+    "headings": [
+      "Command",
+      "Inline example",
+      "Dialog example",
+      "Components",
+      "`Command`",
+      "`CommandDialog`",
+      "`CommandInput`",
+      "`CommandList`",
+      "`CommandEmpty`",
+      "`CommandGroup`",
+      "`CommandItem`",
+      "`CommandSeparator`",
+      "`CommandLoading`",
+      "`CommandShortcut`",
+      "`useCommandShortcut`",
+      "Types",
+      "`CommandProps`",
+      "`CommandDialogProps`",
+      "`CommandInputProps` / `CommandListProps` / `CommandEmptyProps`",
+      "`CommandGroupProps` / `CommandItemProps` / `CommandSeparatorProps` / `CommandLoadingProps`",
+      "`CommandShortcutProps`",
+      "`UseCommandShortcutOptions`",
+      "`*ClassNames`",
+      "Design tokens",
+      "Notes"
+    ]
+  },
+  {
+    "slug": "country-selector",
+    "name": "CountrySelector",
+    "category": "Components",
+    "keywords": [
+      "country selector",
+      "country picker",
+      "flag dropdown",
+      "iso code select",
+      "deprecated"
+    ],
+    "description": "Deprecated — use Combobox or PhoneNumberInput",
+    "headings": [
+      "CountrySelector",
+      "Example",
+      "Props",
+      "Usage with react-hook-form",
+      "Types",
+      "`CountrySelectorProps`",
+      "`CountrySelectorClassNames`",
+      "Design tokens",
+      "Notes"
+    ]
+  },
+  {
+    "slug": "date-range-selector",
+    "name": "DateRangeSelector",
+    "category": "Components",
+    "keywords": [
+      "date range",
+      "date range picker",
+      "calendar range",
+      "start and end date",
+      "date filter"
+    ],
+    "description": "Date range picker",
+    "headings": [
+      "DateRangeSelector",
+      "Example",
+      "With quick-select presets",
+      "Inside a table filter",
+      "Props",
+      "Usage with react-hook-form",
+      "Types",
+      "`DateRangeValue`",
+      "`DateRangeSelectorProps`",
+      "`DateRangePreset`",
+      "`DateRangeSelectorClassNames`",
+      "Design tokens",
+      "Notes",
+      "Don't"
+    ]
+  },
+  {
+    "slug": "date-selector",
+    "name": "DateSelector",
+    "category": "Components",
+    "keywords": [
+      "date",
+      "date picker",
+      "calendar",
+      "single date"
+    ],
+    "description": "Calendar date picker",
+    "headings": [
+      "DateSelector",
+      "Example",
+      "Props",
+      "Usage with react-hook-form",
+      "Types",
+      "`DateSelectorProps`",
+      "`DateSelectorClassNames`",
+      "Design tokens",
+      "Notes",
+      "Don't"
+    ]
+  },
+  {
+    "slug": "dialog",
+    "name": "Dialog",
+    "category": "Components",
+    "keywords": [
+      "dialog",
+      "modal dialog",
+      "popup",
+      "confirm dialog",
+      "overlay"
+    ],
+    "description": "Modal dialog",
+    "headings": [
+      "Dialog",
+      "Example",
+      "URL state",
+      "Components",
+      "`Dialog`",
+      "`DialogTrigger`",
+      "`DialogPortal`",
+      "`DialogOverlay`",
+      "`DialogContent`",
+      "`DialogTitle`",
+      "`DialogDescription`",
+      "Other exports",
+      "Types",
+      "`DialogOverlayProps`",
+      "`DialogContentProps`",
+      "`DialogTitleProps` / `DialogDescriptionProps`",
+      "`DialogOverlayClassNames`",
+      "`DialogContentClassNames`",
+      "`DialogTitleClassNames`",
+      "`DialogDescriptionClassNames`",
+      "Design tokens",
+      "Notes",
+      "Do",
+      "Don't"
+    ]
+  },
+  {
+    "slug": "draggable",
+    "name": "Draggable",
+    "category": "Components",
+    "keywords": [
+      "draggable",
+      "drag panel",
+      "repositionable",
+      "drag and drop",
+      "movable panel"
+    ],
+    "description": "Repositionable panel",
+    "headings": [
+      "Draggable",
+      "Handle drag",
+      "Root drag",
+      "List sort",
+      "Components",
+      "`Draggable`",
+      "`DraggableHandle`",
+      "`useDraggable`",
+      "Types",
+      "`DraggablePosition`",
+      "`DraggableAxis`",
+      "`DraggableBounds`",
+      "`DraggableClassNames`",
+      "Notes"
+    ]
+  },
+  {
+    "slug": "dropdown",
+    "name": "Dropdown",
+    "category": "Components",
+    "keywords": [
+      "dropdown",
+      "select",
+      "combobox",
+      "option picker"
+    ],
+    "description": "Select dropdown",
+    "headings": [
+      "Dropdown",
+      "Example",
+      "Disabled and custom rendering",
+      "Props",
+      "Types",
+      "`DropdownProps`",
+      "`DropdownOption`",
+      "`DropdownClassNames`",
+      "Design tokens",
+      "Notes",
+      "Custom rendering with `formatOption`",
+      "Do",
+      "Don't"
+    ]
+  },
+  {
+    "slug": "export-button",
+    "name": "ExportButton",
+    "category": "Components",
+    "keywords": [
+      "export",
+      "download",
+      "csv",
+      "excel",
+      "xlsx",
+      "pdf",
+      "print",
+      "report"
+    ],
+    "description": "Export tabular data to CSV, Excel, or PDF",
+    "headings": [
+      "ExportButton",
+      "Examples",
+      "Props",
+      "Types",
+      "`ExportColumn`",
+      "`ExportFormat`",
+      "`ExportMeta`",
+      "Using the export functions directly",
+      "Notes"
+    ]
+  },
+  {
+    "slug": "form-field",
+    "name": "FormField",
+    "category": "Components",
+    "keywords": [
+      "form field",
+      "react hook form",
+      "form validation",
+      "zod",
+      "controller"
+    ],
+    "description": "RHF form adapters",
+    "headings": [
+      "FormField",
+      "Example",
+      "Setup",
+      "Zod validation",
+      "`register()` shortcut",
+      "Components",
+      "`Form`",
+      "`FormField`",
+      "`useFormField`",
+      "Types",
+      "`FormProps`",
+      "`FormFieldProps`",
+      "`UseFormFieldReturn`",
+      "Notes",
+      "Do",
+      "Don't"
+    ]
+  },
+  {
+    "slug": "form",
+    "name": "Form",
+    "category": "Components",
+    "keywords": [
+      "form",
+      "field",
+      "input",
+      "textarea",
+      "label",
+      "form validation"
+    ],
+    "description": "Form field primitives",
+    "headings": [
+      "Form",
+      "Example",
+      "Form inside a Modal, with an async submit",
+      "Field anatomy",
+      "Components",
+      "`Field`",
+      "`FieldLabel` / `FieldDescription` / `FieldError` / `FieldControl`",
+      "`Input`",
+      "`Textarea`",
+      "Types",
+      "`FieldClassNames`",
+      "`InputClassNames` / `TextareaClassNames`",
+      "Design tokens",
+      "Input",
+      "Textarea",
+      "Field",
+      "Notes",
+      "Do",
+      "Don't"
+    ]
+  },
+  {
+    "slug": "getting-started",
+    "name": "Getting started",
+    "category": "Guide",
+    "keywords": [
+      "getting started",
+      "installation",
+      "setup",
+      "install",
+      "quick start"
+    ],
+    "description": "Installation and setup",
+    "headings": [
+      "Getting started",
+      "Install",
+      "Styles",
+      "Theme",
+      "Basic usage",
+      "Requirements",
+      "Theming",
+      "Tips"
+    ]
+  },
+  {
+    "slug": "hooks",
+    "name": "Hooks",
+    "category": "Guide",
+    "keywords": [
+      "hooks",
+      "use dialog search param",
+      "url state",
+      "use debounce",
+      "use toast"
+    ],
+    "description": "Shared React hooks",
+    "headings": [
+      "Hooks",
+      "Example",
+      "`useDialogSearchParam`",
+      "Flat data params",
+      "`useModalSearchParam`",
+      "`useSearchParamOverlay`",
+      "React Router",
+      "Adapters",
+      "`createBrowserSearchParamAdapter`",
+      "`createSearchParamAdapter`",
+      "Data utilities",
+      "Types",
+      "`SearchParamAdapter`",
+      "`SearchParamOverlayState<TData>`",
+      "`SearchParamOverlayData`",
+      "`UseSearchParamOverlayReturn<TData>`",
+      "Notes",
+      "`useConfirmBeforeUnload`",
+      "`useDebounce`",
+      "`useTableState`",
+      "`useTablePagination`"
+    ]
+  },
+  {
+    "slug": "launchpad",
+    "name": "Launchpad",
+    "category": "Components",
+    "keywords": [
+      "launchpad",
+      "app switcher",
+      "9-dot menu",
+      "app launcher",
+      "product switcher",
+      "grid menu"
+    ],
+    "description": "Constrained 9-app launcher with a built-in expand button + required role switcher",
+    "headings": [
+      "Launchpad",
+      "Examples",
+      "Props",
+      "Types",
+      "`LaunchpadApp`",
+      "`LaunchpadProps`",
+      "Hooks",
+      "Design tokens",
+      "Notes"
+    ]
+  },
+  {
+    "slug": "metric-card",
+    "name": "MetricCard",
+    "category": "Components",
+    "keywords": [
+      "metric card",
+      "stat card",
+      "kpi card",
+      "dashboard metric",
+      "trend indicator"
+    ],
+    "description": "Metric display card",
+    "headings": [
+      "MetricCard",
+      "Example",
+      "Loading state",
+      "Props",
+      "Variants",
+      "Outline variant",
+      "Types",
+      "`MetricCardProps`",
+      "`MetricCardClassNames`",
+      "Design tokens",
+      "Notes",
+      "Do"
+    ]
+  },
+  {
+    "slug": "migration-v2",
+    "name": "Migration guide: v1 → v2",
+    "category": "Guide",
+    "keywords": [
+      "migration",
+      "upgrade",
+      "v2",
+      "breaking changes",
+      "deprecated",
+      "new design system",
+      "AppHeaderProfile",
+      "ProfilePopover",
+      "Launchpad",
+      "AppSwitcher",
+      "rebrand",
+      "AppLayout",
+      "Sidebar",
+      "RoleSelect",
+      "stacked layout",
+      "CountrySelector",
+      "Combobox",
+      "NetworkOperator",
+      "gsl-to-clet",
+      "cletTheme",
+      "gslTheme",
+      "rename",
+      "TableFooter",
+      "noBorder"
+    ],
+    "description": "Agent instructions for upgrading to v2 and the new design system",
+    "headings": [
+      "Migration guide: v1 → v2 — Agent Instructions",
+      "1. `AppHeaderProfile` → `ProfilePopover`",
+      "2. `AppItem.icon` → `SystemAppIcon` or `AppIconTile`",
+      "3. `AppSwitcher` maxItems default is 6",
+      "4. `Table`: selection-only loses kebab column",
+      "5. Rebrand: new default colors and typography",
+      "6. Prefer `Launchpad` over deprecated `AppSwitcher`",
+      "7. `CountrySelector` → `Combobox` or `PhoneNumberInput`'s country picker",
+      "8. `NetworkOperator` → `Combobox`",
+      "9. Naming rename: `.gsl-*` → `.clet-*`, `gslTheme()` → `cletTheme()`",
+      "Adopting the new design system",
+      "Layout shell: `AppLayout variant=\"stacked\"` + `AppHeader variant=\"plain\"` + `Sidebar variant=\"plain\"`",
+      "Use built-in `loading` states — never hand-roll placeholders",
+      "One role switcher, consistent across all three locations",
+      "Table family — adopt together",
+      "Other preferred variants",
+      "Checklist"
+    ]
+  },
+  {
+    "slug": "modal",
+    "name": "Modal",
+    "category": "Components",
+    "keywords": [
+      "modal",
+      "overlay",
+      "review dialog",
+      "full screen modal",
+      "workflow modal"
+    ],
+    "description": "Centered overlay with size variants",
+    "headings": [
+      "Modal",
+      "Example",
+      "Sizes",
+      "Prevent close",
+      "URL state",
+      "Components",
+      "`Modal`",
+      "`ModalTrigger`",
+      "`ModalPortal`",
+      "`ModalOverlay`",
+      "`ModalContent`",
+      "`ModalHeader`",
+      "`ModalTitle`",
+      "`ModalDescription`",
+      "`ModalBody`",
+      "`ModalFooter`",
+      "Other exports",
+      "Types",
+      "`ModalSize`",
+      "`ModalOverlayProps` / `ModalContentProps` / `ModalHeaderProps`",
+      "`ModalTitleProps` / `ModalDescriptionProps`",
+      "`ModalBodyProps` / `ModalFooterProps`",
+      "`ModalOverlayClassNames`",
+      "`ModalContentClassNames`",
+      "`ModalHeaderClassNames` / `ModalTitleClassNames` / `ModalDescriptionClassNames`",
+      "`ModalBodyClassNames` / `ModalFooterClassNames`",
+      "Design tokens",
+      "Notes",
+      "Do",
+      "Don't"
+    ]
+  },
+  {
+    "slug": "network-operator",
+    "name": "NetworkOperator",
+    "category": "Components",
+    "keywords": [
+      "network operator",
+      "mtn",
+      "vodafone",
+      "airteltigo",
+      "telco picker",
+      "deprecated"
+    ],
+    "description": "Deprecated — use Combobox instead",
+    "headings": [
+      "NetworkOperator",
+      "Example",
+      "Props",
+      "Usage with react-hook-form",
+      "Types",
+      "`NetworkOperatorOption`",
+      "`NetworkOperatorProps`",
+      "`NetworkOperatorClassNames`",
+      "Design tokens",
+      "Notes"
+    ]
+  },
+  {
+    "slug": "notice",
+    "name": "Notice",
+    "category": "Components",
+    "keywords": [
+      "notice",
+      "callout",
+      "alert",
+      "banner",
+      "info box"
+    ],
+    "description": "Boxed callout for scoped context, policy, or status messages",
+    "headings": [
+      "Notice",
+      "Example",
+      "Compact / inline usage",
+      "Props",
+      "Types",
+      "`NoticeProps`",
+      "`NoticeClassNames`",
+      "`NoticeVariant`",
+      "Design tokens",
+      "Notes"
+    ]
+  },
+  {
+    "slug": "otp-input",
+    "name": "OtpInput",
+    "category": "Components",
+    "keywords": [
+      "otp",
+      "one-time password",
+      "verification code",
+      "2fa",
+      "mfa input",
+      "pin code"
+    ],
+    "description": "One-time password input",
+    "headings": [
+      "OtpInput",
+      "Example",
+      "Verification gate inside a Dialog",
+      "Props",
+      "Usage with react-hook-form",
+      "Types",
+      "`OtpInputProps`",
+      "`OtpInputClassNames`",
+      "Design tokens",
+      "Notes"
+    ]
+  },
+  {
+    "slug": "phone-number-input",
+    "name": "PhoneNumberInput",
+    "category": "Components",
+    "keywords": [
+      "phone number",
+      "phone input",
+      "country code",
+      "dial code",
+      "telephone"
+    ],
+    "description": "Phone input with country codes",
+    "headings": [
+      "PhoneNumberInput",
+      "Example",
+      "Props",
+      "Field composition (label, optional tag, hint, error)",
+      "Form validation",
+      "Usage with react-hook-form",
+      "Types",
+      "`PhoneNumberInputProps`",
+      "`PhoneNumberInputClassNames`",
+      "Design tokens",
+      "Notes"
+    ]
+  },
+  {
+    "slug": "popover",
+    "name": "Popover",
+    "category": "Components",
+    "keywords": [
+      "popover",
+      "floating panel",
+      "menu",
+      "action menu",
+      "tooltip panel"
+    ],
+    "description": "Floating content panel",
+    "headings": [
+      "Popover",
+      "Example",
+      "Components",
+      "`Popover`",
+      "`PopoverTrigger`",
+      "`PopoverContent`",
+      "Other exports",
+      "Types",
+      "`PopoverContentProps`",
+      "`PopoverContentClassNames`",
+      "Design tokens",
+      "Notes"
+    ]
+  },
+  {
+    "slug": "popup",
+    "name": "Popup",
+    "category": "Components",
+    "keywords": [
+      "popup",
+      "floating card",
+      "confirm",
+      "quick action",
+      "popover"
+    ],
+    "description": "Compact floating card for confirmations and quick actions",
+    "headings": [
+      "Popup",
+      "Example",
+      "Variants",
+      "Components",
+      "`Popup`",
+      "`PopupTrigger`",
+      "`PopupContent`",
+      "`PopupHeader`",
+      "`PopupTitle`",
+      "`PopupDescription`",
+      "`PopupBody`",
+      "`PopupFooter`",
+      "Other exports",
+      "Types",
+      "`PopupContentProps`",
+      "`PopupContentClassNames`",
+      "`PopupHeaderProps`, `PopupTitleProps`, `PopupDescriptionProps`, `PopupBodyProps`",
+      "`PopupFooterProps`",
+      "Design tokens",
+      "Notes"
+    ]
+  },
+  {
+    "slug": "profile-popover",
+    "name": "ProfilePopover",
+    "category": "Components",
+    "keywords": [
+      "profile popover",
+      "account menu",
+      "user menu",
+      "sign out",
+      "profile menu"
+    ],
+    "description": "Unified user profile menu popover",
+    "headings": [
+      "ProfilePopover",
+      "Example",
+      "Header-style trigger (`user`/`variant`)",
+      "Loading state",
+      "Props",
+      "`ProfilePopoverItem`",
+      "`AppUser`",
+      "Notes"
+    ]
+  },
+  {
+    "slug": "progress-bar",
+    "name": "ProgressBar",
+    "category": "Components",
+    "keywords": [
+      "progress bar",
+      "loading indicator",
+      "progress indicator",
+      "determinate progress"
+    ],
+    "description": "Progress indicator",
+    "headings": [
+      "ProgressBar",
+      "Example",
+      "Props",
+      "Types",
+      "`ProgressBarProps`",
+      "`ProgressBarClassNames`",
+      "`ProgressBarVariant`",
+      "`ProgressBarSize`",
+      "Design tokens",
+      "Notes"
+    ]
+  },
+  {
+    "slug": "radio-group",
+    "name": "RadioGroup",
+    "category": "Components",
+    "keywords": [
+      "radio group",
+      "radio button",
+      "choice cards",
+      "single select",
+      "option list"
+    ],
+    "description": "Radio group component",
+    "headings": [
+      "RadioGroup",
+      "Example",
+      "Choice cards",
+      "Decision form with a conditional field",
+      "Components",
+      "`RadioGroup`",
+      "`Radio`",
+      "Types",
+      "`RadioGroupProps`",
+      "`RadioProps`",
+      "`RadioGroupVariant`",
+      "`RadioGroupClassNames`",
+      "`RadioClassNames`",
+      "Design tokens",
+      "Notes"
+    ]
+  },
+  {
+    "slug": "role-select",
+    "name": "RoleSelect",
+    "category": "Components",
+    "keywords": [
+      "role select",
+      "switch role",
+      "role switcher",
+      "portal switch"
+    ],
+    "description": "Dropdown control for switching between roles",
+    "headings": [
+      "RoleSelect",
+      "Example",
+      "Props",
+      "Types",
+      "`Role`",
+      "Notes"
+    ]
+  },
+  {
+    "slug": "router-adapter",
+    "name": "RouterAdapter",
+    "category": "Guide",
+    "keywords": [
+      "router adapter",
+      "next.js",
+      "react router",
+      "routing abstraction"
+    ],
+    "description": "Framework-agnostic router abstraction for Next.js and react-router compatibility",
+    "headings": [
+      "RouterAdapter",
+      "How it works",
+      "New exports",
+      "react-router (default, zero change)",
+      "Next.js App Router",
+      "Installing in Next.js",
+      "Custom adapters"
+    ]
+  },
+  {
+    "slug": "section-header",
+    "name": "SectionHeader",
+    "category": "Components",
+    "keywords": [
+      "section header",
+      "page header",
+      "title",
+      "description",
+      "actions"
+    ],
+    "description": "Title, description, and actions row for a page section",
+    "headings": [
+      "SectionHeader",
+      "Example",
+      "Components",
+      "`SectionHeader`",
+      "`SectionTitle`",
+      "`SectionDescription`",
+      "`SectionActions`",
+      "Types",
+      "`SectionHeaderProps`",
+      "`SectionTitleProps`, `SectionDescriptionProps`, `SectionActionsProps`",
+      "Design tokens",
+      "Notes"
+    ]
+  },
+  {
+    "slug": "sheet",
+    "name": "Sheet",
+    "category": "Components",
+    "keywords": [
+      "sheet",
+      "side panel",
+      "drawer",
+      "slide out panel",
+      "filters panel"
+    ],
+    "description": "Side panel",
+    "headings": [
+      "Sheet",
+      "Example",
+      "Components",
+      "`Sheet`",
+      "`SheetTrigger`",
+      "`SheetPortal`",
+      "`SheetOverlay`",
+      "`SheetContent`",
+      "`SheetHeader`",
+      "`SheetTitle`",
+      "`SheetDescription`",
+      "`SheetBody`",
+      "`SheetFooter`",
+      "Other exports",
+      "Types",
+      "`SheetSide`",
+      "`SheetOverlayProps` / `SheetContentProps` / `SheetHeaderProps`",
+      "`SheetTitleProps` / `SheetDescriptionProps`",
+      "`SheetBodyProps` / `SheetFooterProps`",
+      "`SheetOverlayClassNames`",
+      "`SheetContentClassNames`",
+      "`SheetHeaderClassNames` / `SheetTitleClassNames` / `SheetDescriptionClassNames`",
+      "`SheetBodyClassNames` / `SheetFooterClassNames`",
+      "Design tokens",
+      "Notes"
+    ]
+  },
+  {
+    "slug": "sidebar",
+    "name": "Sidebar",
+    "category": "Components",
+    "keywords": [
+      "sidebar",
+      "nav rail",
+      "navigation sidebar",
+      "app shell nav",
+      "collapsible sidebar"
+    ],
+    "description": "Layout sidebar",
+    "headings": [
+      "Sidebar",
+      "Example",
+      "Variants",
+      "Loading state",
+      "React Router",
+      "Components",
+      "`SidebarProvider`",
+      "`Sidebar`",
+      "`SidebarCollapse`",
+      "`SidebarTrigger`",
+      "`SidebarOverlay`",
+      "`SidebarHeader`",
+      "`SidebarContent`",
+      "`SidebarFooter`",
+      "`SidebarNav`",
+      "`SidebarGroup`",
+      "`SidebarGroupLabel`",
+      "`SidebarItem`",
+      "`SidebarBadge`",
+      "`SidebarLink`",
+      "Types",
+      "`SidebarProviderProps`",
+      "`SidebarProps`",
+      "`SidebarTriggerProps`",
+      "`SidebarCollapseProps`",
+      "`SidebarOverlayProps`",
+      "`SidebarHeaderProps` / `SidebarContentProps` / `SidebarFooterProps`",
+      "`SidebarNavProps` / `SidebarGroupProps` / `SidebarGroupLabelProps` / `SidebarItemProps`",
+      "`SidebarLinkProps`",
+      "`SidebarBadgeProps`",
+      "`SidebarProviderClassNames`",
+      "`SidebarClassNames`",
+      "Other `*ClassNames`",
+      "Design tokens",
+      "Notes"
+    ]
+  },
+  {
+    "slug": "sortable",
+    "name": "Sortable",
+    "category": "Components",
+    "keywords": [
+      "sortable",
+      "reorder list",
+      "drag to reorder",
+      "drag and drop list"
+    ],
+    "description": "Reorderable list",
+    "headings": [
+      "Sortable",
+      "Example",
+      "Components",
+      "`Sortable`",
+      "`SortableList`",
+      "`SortableItem`",
+      "`SortableHandle`",
+      "`reorderItems`",
+      "Types",
+      "`SortableId`",
+      "`SortableStrategy`",
+      "`SortableClassNames`",
+      "Notes"
+    ]
+  },
+  {
+    "slug": "stepper",
+    "name": "Stepper",
+    "category": "Components",
+    "keywords": [
+      "stepper",
+      "step indicator",
+      "multi step flow",
+      "wizard steps",
+      "progress steps"
+    ],
+    "description": "Horizontal step indicator for multi-step flows",
+    "headings": [
+      "Stepper",
+      "Example",
+      "Components",
+      "`Stepper`",
+      "`Step`",
+      "`StepLabel`",
+      "Namespace",
+      "Types",
+      "`StepperClassNames`",
+      "`StepClassNames`",
+      "`StepLabelClassNames`",
+      "`StepState`",
+      "Notes",
+      "CSS Custom Properties"
+    ]
+  },
+  {
+    "slug": "switch",
+    "name": "Switch",
+    "category": "Components",
+    "keywords": [
+      "switch",
+      "toggle",
+      "on off",
+      "checkbox alternative"
+    ],
+    "description": "Binary on/off toggle control",
+    "headings": [
+      "Switch",
+      "Example",
+      "Props",
+      "Types",
+      "`SwitchProps`",
+      "`SwitchClassNames`",
+      "Design tokens",
+      "Notes"
+    ]
+  },
+  {
+    "slug": "table",
+    "name": "Table",
+    "category": "Components",
+    "keywords": [
+      "table",
+      "data table",
+      "data grid",
+      "pagination",
+      "bulk actions",
+      "sortable columns",
+      "row selection"
+    ],
+    "description": "Data table",
+    "headings": [
+      "Table",
+      "Example",
+      "Example Empty State",
+      "Panel variant",
+      "CRUD with bulk delete and a row action menu",
+      "Toolbar filters with `TableActions`",
+      "Spread filter variant",
+      "Architecture",
+      "`<Table>`",
+      "`<TableSearch>`",
+      "`<TableFilter>`",
+      "`<TableContent>`",
+      "Row actions",
+      "`TableColumn<T>`",
+      "`<TableBulkActions>`",
+      "Basic usage",
+      "Custom render",
+      "`<TablePagination>`",
+      "`<TableHeader>`",
+      "`<TableFooter>`",
+      "`<TableActions>`",
+      "`useTableState`",
+      "`useTableFilter`",
+      "`useTablePagination`",
+      "Types",
+      "`TableProps`",
+      "`TableClassNames`",
+      "`TableBulkAction`",
+      "`TableRowAction`",
+      "`TableBulkActionsClassNames`",
+      "`TableContentClassNames`",
+      "`TableSearchClassNames`",
+      "`TableFilterClassNames`",
+      "`TablePaginationClassNames`",
+      "`TableHeaderClassNames`",
+      "`TableFooterClassNames`",
+      "`TableActionsClassNames`",
+      "`PaginationControlsProps`",
+      "Design tokens",
+      "Notes",
+      "Do",
+      "Don't"
+    ]
+  },
+  {
+    "slug": "tabs",
+    "name": "Tabs",
+    "category": "Components",
+    "keywords": [
+      "tabs",
+      "tabbed panels",
+      "segmented control",
+      "pill tabs",
+      "line tabs"
+    ],
+    "description": "Tabbed panels",
+    "headings": [
+      "Tabs",
+      "Example",
+      "Line variant",
+      "Pill variant",
+      "Tabs as a table filter",
+      "Components",
+      "`Tabs`",
+      "`TabsList`",
+      "`TabsTrigger`",
+      "`TabsContent`",
+      "Types",
+      "`TabsProps`",
+      "`TabsListProps`",
+      "`TabsTriggerProps`",
+      "`TabsContentProps`",
+      "`TabsVariant`",
+      "`TabsClassNames`",
+      "`TabsListClassNames`",
+      "`TabsTriggerClassNames`",
+      "`TabsContentClassNames`",
+      "Notes",
+      "CSS Custom Properties"
+    ]
+  },
+  {
+    "slug": "theme",
+    "name": "Theme",
+    "category": "Guide",
+    "keywords": [
+      "theme",
+      "dark mode",
+      "light mode",
+      "theme provider",
+      "design tokens",
+      "tailwind",
+      "clettheme",
+      "runtime theme override",
+      "component tokens",
+      "customize colors"
+    ],
+    "description": "Theme provider",
+    "headings": [
+      "Theme",
+      "Setup",
+      "Modes",
+      "Toggle at runtime",
+      "CSS tokens",
+      "Colors",
+      "Semantic",
+      "Radius",
+      "Shadow",
+      "Z-index",
+      "Other",
+      "`cletTheme()` (recommended)",
+      "Manual CSS",
+      "Tailwind v4 integration",
+      "Consumer setup",
+      "Dark mode",
+      "Non-Tailwind consumers",
+      "Controlled mode"
+    ]
+  },
+  {
+    "slug": "timeline",
+    "name": "Timeline",
+    "category": "Components",
+    "keywords": [
+      "timeline",
+      "vertical timeline",
+      "activity feed",
+      "history log",
+      "event log"
+    ],
+    "description": "Vertical timeline for ordered events and history",
+    "headings": [
+      "Timeline",
+      "Example",
+      "Components",
+      "`Timeline`",
+      "`TimelineItem`",
+      "`TimelineTitle`",
+      "`TimelineData`",
+      "`TimelineFooter`",
+      "Types",
+      "`TimelineItemClassNames`",
+      "Notes",
+      "Tokens"
+    ]
+  },
+  {
+    "slug": "toast",
+    "name": "Toast",
+    "category": "Components",
+    "keywords": [
+      "toast",
+      "notification",
+      "snackbar",
+      "alert message",
+      "sonner"
+    ],
+    "description": "Notification toasts",
+    "headings": [
+      "Toast",
+      "Example",
+      "Icons",
+      "Setup",
+      "`useToast`",
+      "`ToastOptions`",
+      "Components",
+      "`ToastProvider`",
+      "`Toaster`",
+      "Types",
+      "`ToastVariant`",
+      "`ToastClassNames`",
+      "Design tokens",
+      "Notes",
+      "Do"
+    ]
+  },
+  {
+    "slug": "tooltip",
+    "name": "Tooltip",
+    "category": "Components",
+    "keywords": [
+      "tooltip",
+      "hover label",
+      "hint text",
+      "icon label"
+    ],
+    "description": "Hover label for icon-only controls and truncated content",
+    "headings": [
+      "Tooltip",
+      "Example",
+      "Props",
+      "Types",
+      "`TooltipProps`",
+      "`TooltipClassNames`",
+      "Design tokens",
+      "Notes"
+    ]
+  },
+  {
+    "slug": "upload-field",
+    "name": "UploadField",
+    "category": "Components",
+    "keywords": [
+      "upload field",
+      "file upload",
+      "dropzone",
+      "file picker",
+      "drag and drop upload"
+    ],
+    "description": "File upload",
+    "headings": [
+      "UploadField",
+      "Example",
+      "Multiple files",
+      "Per-file upload status",
+      "Form validation",
+      "Usage with react-hook-form",
+      "Native validation",
+      "Zod validation",
+      "Props",
+      "File type detection",
+      "Types",
+      "`UploadFieldProps`",
+      "`UploadFieldFileStatus`",
+      "`UploadFieldClassNames`",
+      "Design tokens",
+      "Notes"
+    ]
+  }
+]