@thangnqdev/ui 0.2.1 → 0.2.2

package/src/registry/components.ts

@@ -1,1368 +1,1368 @@
-export interface ComponentMeta {
-  name: string;
-  module:
-    | 'core'
-    | 'layout'
-    | 'typography'
-    | 'buttons'
-    | 'forms'
-    | 'overlays'
-    | 'navigation'
-    | 'data-display'
-    | 'feedback'
-    | 'glass'
-    | 'bento';
-  category: 'Foundation' | 'Primitives' | 'Composite' | 'Advanced' | 'Visual';
-  status: 'stable' | 'beta' | 'experimental' | 'deprecated';
-  accessibility: 'verified' | 'supported' | 'native' | 'none';
-  description: string;
-  since: string;
-  props?: Record<string, string>;
-}
-
-export const COMPONENT_REGISTRY: ComponentMeta[] = [
-  // Core & Layout
-  {
-    name: 'ThemeProvider',
-    module: 'core',
-    category: 'Foundation',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'System-aware dark/light theme context provider with localStorage synchronization.',
-    since: '0.1.0',
-    props: { defaultTheme: "'dark' | 'light' | 'system'", storageKey: 'string', children: 'ReactNode' },
-  },
-  {
-    name: 'useTheme',
-    module: 'core',
-    category: 'Foundation',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'Hook returning theme state, resolved theme, and setter functions.',
-    since: '0.1.0',
-  },
-  {
-    name: 'cn',
-    module: 'core',
-    category: 'Foundation',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'Tailwind CSS class merging utility combining clsx and tailwind-merge.',
-    since: '0.1.0',
-  },
-  {
-    name: 'Container',
-    module: 'layout',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'Max-width constrained responsive wrapper.',
-    since: '0.1.0',
-    props: { size: "'sm' | 'md' | 'lg' | 'xl' | '2xl' | 'fluid'", padding: "'none' | 'sm' | 'md' | 'lg'" },
-  },
-  {
-    name: 'Stack',
-    module: 'layout',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'Flexbox layout stack with configurable direction, gap, and alignment.',
-    since: '0.1.0',
-  },
-  {
-    name: 'HStack',
-    module: 'layout',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'Horizontal flexbox stack.',
-    since: '0.1.0',
-  },
-  {
-    name: 'VStack',
-    module: 'layout',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'Vertical flexbox stack.',
-    since: '0.1.0',
-  },
-  {
-    name: 'Grid',
-    module: 'layout',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'CSS grid container with responsive column breakpoints.',
-    since: '0.1.0',
-  },
-  {
-    name: 'GridItem',
-    module: 'layout',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'Grid child with colSpan and rowSpan props.',
-    since: '0.1.0',
-  },
-  {
-    name: 'Flex',
-    module: 'layout',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'Generic flex container.',
-    since: '0.1.0',
-  },
-  {
-    name: 'Divider',
-    module: 'layout',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'Visual separation line with optional label.',
-    since: '0.1.0',
-  },
-  {
-    name: 'Spacer',
-    module: 'layout',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'Flexible spacer taking up remaining flex space.',
-    since: '0.1.0',
-  },
-  {
-    name: 'AspectRatio',
-    module: 'layout',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'Container enforcing a specific aspect ratio.',
-    since: '0.1.0',
-  },
-  {
-    name: 'PageLayout',
-    module: 'layout',
-    category: 'Composite',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'Top-level shell layout with header, sidebar, and content areas.',
-    since: '0.1.0',
-  },
-  {
-    name: 'PageHeader',
-    module: 'layout',
-    category: 'Composite',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'Header container for page title, actions, and breadcrumb.',
-    since: '0.1.0',
-  },
-  {
-    name: 'PageSidebar',
-    module: 'layout',
-    category: 'Composite',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'Sidebar navigation panel with collapse support.',
-    since: '0.1.0',
-  },
-  {
-    name: 'ScrollArea',
-    module: 'layout',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'Custom styled scrollable container.',
-    since: '0.1.0',
-  },
-
-  // Typography
-  {
-    name: 'Heading',
-    module: 'typography',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'Polymorphic heading primitive with optical tracking.',
-    since: '0.1.0',
-    props: { as: "'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6' | 'div' | 'span'", size: "'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6'" },
-  },
-  {
-    name: 'Text',
-    module: 'typography',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'Body text primitive with editorial hierarchy variants.',
-    since: '0.1.0',
-  },
-  {
-    name: 'Label',
-    module: 'typography',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'Accessible form label with required indicator.',
-    since: '0.1.0',
-  },
-  {
-    name: 'Link',
-    module: 'typography',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'Anchor element with underline animations and external link handling.',
-    since: '0.1.0',
-  },
-  {
-    name: 'Code',
-    module: 'typography',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'Inline monospace code badge.',
-    since: '0.1.0',
-  },
-  {
-    name: 'CodeBlock',
-    module: 'typography',
-    category: 'Composite',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'Multi-line code snippet with syntax highlighting and copy-to-clipboard button.',
-    since: '0.1.0',
-  },
-  {
-    name: 'Blockquote',
-    module: 'typography',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'Stylized editorial quote with author citation.',
-    since: '0.1.0',
-  },
-  {
-    name: 'Kbd',
-    module: 'typography',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'Keyboard key badge with optical shadow.',
-    since: '0.1.0',
-  },
-
-  // Buttons
-  {
-    name: 'Button',
-    module: 'buttons',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Interactive button with micro-interactions, loading spinners, and optical states.',
-    since: '0.1.0',
-    props: { variant: "'primary' | 'secondary' | 'outline' | 'ghost' | 'danger' | 'link' | 'glass'", size: "'xs' | 'sm' | 'md' | 'lg' | 'xl'", loading: 'boolean' },
-  },
-  {
-    name: 'IconButton',
-    module: 'buttons',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Square or round icon button with mandatory aria-label.',
-    since: '0.1.0',
-  },
-  {
-    name: 'ButtonGroup',
-    module: 'buttons',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Connected group of action buttons.',
-    since: '0.1.0',
-  },
-  {
-    name: 'ToggleButton',
-    module: 'buttons',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Two-state button with pressed state.',
-    since: '0.1.0',
-  },
-  {
-    name: 'ToggleGroup',
-    module: 'buttons',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Single or multi-select group of toggle buttons.',
-    since: '0.1.0',
-  },
-  {
-    name: 'SplitButton',
-    module: 'buttons',
-    category: 'Composite',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Dual-action button with primary click and dropdown arrow menu.',
-    since: '0.1.0',
-  },
-
-  // Forms
-  {
-    name: 'FormField',
-    module: 'forms',
-    category: 'Foundation',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Accessible form field context orchestrating label, input, helper text, and error states.',
-    since: '0.1.0',
-  },
-  {
-    name: 'FormLabel',
-    module: 'forms',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Label linked automatically to FormField id.',
-    since: '0.1.0',
-  },
-  {
-    name: 'FormHelperText',
-    module: 'forms',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Descriptive helper text linked to aria-describedby.',
-    since: '0.1.0',
-  },
-  {
-    name: 'FormErrorMessage',
-    module: 'forms',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Error message linked to aria-describedby with role=alert.',
-    since: '0.1.0',
-  },
-  {
-    name: 'Input',
-    module: 'forms',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Text input with leading/trailing icons and glass focus rings.',
-    since: '0.1.0',
-  },
-  {
-    name: 'SearchInput',
-    module: 'forms',
-    category: 'Composite',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Input with search icon and one-click clear button.',
-    since: '0.1.0',
-  },
-  {
-    name: 'PasswordInput',
-    module: 'forms',
-    category: 'Composite',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Password input with toggleable visibility eye button.',
-    since: '0.1.0',
-  },
-  {
-    name: 'Textarea',
-    module: 'forms',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Multi-line textarea with auto-resize option.',
-    since: '0.1.0',
-  },
-  {
-    name: 'Select',
-    module: 'forms',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Native select dropdown with styled Chevron icon and FormField integration.',
-    since: '0.1.0',
-  },
-  {
-    name: 'Checkbox',
-    module: 'forms',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Controlled and uncontrolled checkbox with indeterminate support and full WAI-ARIA compliance.',
-    since: '0.1.0',
-    props: { checked: 'boolean', defaultChecked: 'boolean', indeterminate: 'boolean', onCheckedChange: '(checked: boolean) => void' },
-  },
-  {
-    name: 'CheckboxGroup',
-    module: 'forms',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Group container for related checkboxes.',
-    since: '0.1.0',
-  },
-  {
-    name: 'Radio',
-    module: 'forms',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Accessible radio button with animated selection dot.',
-    since: '0.1.0',
-  },
-  {
-    name: 'RadioGroup',
-    module: 'forms',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Radio group with keyboard arrow navigation.',
-    since: '0.1.0',
-  },
-  {
-    name: 'Switch',
-    module: 'forms',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'iOS-inspired spatial toggle switch with smooth physics and role=switch.',
-    since: '0.1.0',
-  },
-  {
-    name: 'Slider',
-    module: 'forms',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Single-value track slider with live fill and tooltips.',
-    since: '0.1.0',
-  },
-  {
-    name: 'RangeSlider',
-    module: 'forms',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Dual-thumb range slider with pointer capture and WAI-ARIA slider roles.',
-    since: '0.1.0',
-    props: { min: 'number', max: 'number', step: 'number', value: '[number, number]', defaultValue: '[number, number]', onChange: '(val: [number, number]) => void' },
-  },
-  {
-    name: 'PinInput',
-    module: 'forms',
-    category: 'Composite',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Multi-digit OTP/PIN code input with paste handling and arrow key navigation.',
-    since: '0.1.0',
-  },
-  {
-    name: 'DatePicker',
-    module: 'forms',
-    category: 'Composite',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Calendar date picker popover with quick presets and min/max restrictions.',
-    since: '0.1.0',
-  },
-  {
-    name: 'DateRangePicker',
-    module: 'forms',
-    category: 'Composite',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Dual date range picker with live span highlight.',
-    since: '0.1.0',
-  },
-  {
-    name: 'TimePicker',
-    module: 'forms',
-    category: 'Composite',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Time selector supporting 12h (AM/PM) and 24h formats with parent controlled sync.',
-    since: '0.1.0',
-    props: { value: 'string', defaultValue: 'string', format: "'12h' | '24h'", onChange: '(time: string) => void' },
-  },
-  {
-    name: 'Combobox',
-    module: 'forms',
-    category: 'Composite',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Searchable autocomplete dropdown with keyboard navigation and active descendant ARIA roles.',
-    since: '0.1.0',
-    props: { options: 'ComboboxOption[]', value: 'string', onChange: '(val: string) => void', searchPlaceholder: 'string' },
-  },
-  {
-    name: 'MultiSelect',
-    module: 'forms',
-    category: 'Composite',
-    status: 'beta',
-    accessibility: 'supported',
-    description: 'Multi-tag selector with search filtering, keyboard navigation, and removable chips.',
-    since: '0.1.0',
-  },
-  {
-    name: 'FileUpload',
-    module: 'forms',
-    category: 'Advanced',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Drag-and-drop file upload zone with file preview, progress bars, and validation.',
-    since: '0.1.0',
-  },
-  {
-    name: 'NumberInput',
-    module: 'forms',
-    category: 'Composite',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Numeric input with stepper buttons, clamping, and formatters.',
-    since: '0.1.0',
-  },
-  {
-    name: 'CurrencyInput',
-    module: 'forms',
-    category: 'Composite',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Currency formatted input with currency symbol adornment.',
-    since: '0.1.0',
-  },
-  {
-    name: 'MaskedInput',
-    module: 'forms',
-    category: 'Composite',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Input with format pattern mask (e.g. phone, credit card).',
-    since: '0.1.0',
-  },
-
-  // Overlays
-  {
-    name: 'Portal',
-    module: 'overlays',
-    category: 'Foundation',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'Mounts overlay children at document.body.',
-    since: '0.1.0',
-  },
-  {
-    name: 'FocusTrap',
-    module: 'overlays',
-    category: 'Foundation',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Traps keyboard Tab navigation inside container and restores focus upon exit.',
-    since: '0.1.0',
-  },
-  {
-    name: 'Modal',
-    module: 'overlays',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Accessible modal dialog with focus trapping, scroll lock reference counting, and ARIA auto-linking.',
-    since: '0.1.0',
-    props: { isOpen: 'boolean', onClose: '() => void', closeOnEsc: 'boolean', closeOnOverlayClick: 'boolean' },
-  },
-  {
-    name: 'ModalOverlay',
-    module: 'overlays',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Backdrop for modal dialogs.',
-    since: '0.1.0',
-  },
-  {
-    name: 'ModalContent',
-    module: 'overlays',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Content box for modal dialogs.',
-    since: '0.1.0',
-  },
-  {
-    name: 'ModalHeader',
-    module: 'overlays',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Header container for modal dialogs.',
-    since: '0.1.0',
-  },
-  {
-    name: 'ModalTitle',
-    module: 'overlays',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Title linked automatically to modal aria-labelledby.',
-    since: '0.1.0',
-  },
-  {
-    name: 'ModalDescription',
-    module: 'overlays',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Description linked automatically to modal aria-describedby.',
-    since: '0.1.0',
-  },
-  {
-    name: 'ModalBody',
-    module: 'overlays',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Main body for modal dialogs.',
-    since: '0.1.0',
-  },
-  {
-    name: 'ModalFooter',
-    module: 'overlays',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Action footer for modal dialogs.',
-    since: '0.1.0',
-  },
-  {
-    name: 'ModalCloseButton',
-    module: 'overlays',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Top-right close button for modal dialogs.',
-    since: '0.1.0',
-  },
-  {
-    name: 'AlertDialog',
-    module: 'overlays',
-    category: 'Composite',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Confirmation alert dialog with role=alertdialog and primary/danger confirm action.',
-    since: '0.1.0',
-  },
-  {
-    name: 'Drawer',
-    module: 'overlays',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Side or bottom drawer sheet with focus trap, scroll lock, and slide animation.',
-    since: '0.1.0',
-    props: { isOpen: 'boolean', onClose: '() => void', placement: "'right' | 'left' | 'top' | 'bottom'" },
-  },
-  {
-    name: 'DrawerHeader',
-    module: 'overlays',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Header container for drawer sheets.',
-    since: '0.1.0',
-  },
-  {
-    name: 'DrawerBody',
-    module: 'overlays',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Body container for drawer sheets.',
-    since: '0.1.0',
-  },
-  {
-    name: 'DrawerFooter',
-    module: 'overlays',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Footer container for drawer sheets.',
-    since: '0.1.0',
-  },
-  {
-    name: 'Tooltip',
-    module: 'overlays',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Micro tooltip with hover delays and role=tooltip.',
-    since: '0.1.0',
-  },
-  {
-    name: 'Popover',
-    module: 'overlays',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Floating popover anchor with outside click detection.',
-    since: '0.1.0',
-  },
-  {
-    name: 'Toast',
-    module: 'overlays',
-    category: 'Composite',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Floating toast notification with status variants and progress bar.',
-    since: '0.1.0',
-  },
-  {
-    name: 'ToasterProvider',
-    module: 'overlays',
-    category: 'Foundation',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Context provider managing toast notifications queue.',
-    since: '0.1.0',
-  },
-  {
-    name: 'useToast',
-    module: 'overlays',
-    category: 'Foundation',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Hook to trigger toasts: { toast, dismiss, toasts }.',
-    since: '0.1.0',
-  },
-  {
-    name: 'BottomSheet',
-    module: 'overlays',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Mobile drawer sheet with drag handle and scroll lock.',
-    since: '0.1.0',
-  },
-  {
-    name: 'BottomSheetHeader',
-    module: 'overlays',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Header container for bottom sheet.',
-    since: '0.1.0',
-  },
-  {
-    name: 'BottomSheetBody',
-    module: 'overlays',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Body container for bottom sheet.',
-    since: '0.1.0',
-  },
-  {
-    name: 'BottomSheetFooter',
-    module: 'overlays',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Footer container for bottom sheet.',
-    since: '0.1.0',
-  },
-  {
-    name: 'ContextMenu',
-    module: 'overlays',
-    category: 'Composite',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Right-click context menu with keyboard navigation and portal positioning.',
-    since: '0.1.0',
-  },
-  {
-    name: 'ContextMenuItem',
-    module: 'overlays',
-    category: 'Composite',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Item inside context menu with shortcut badges.',
-    since: '0.1.0',
-  },
-  {
-    name: 'ContextMenuSeparator',
-    module: 'overlays',
-    category: 'Composite',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Separator line in context menu.',
-    since: '0.1.0',
-  },
-  {
-    name: 'HoverCard',
-    module: 'overlays',
-    category: 'Composite',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Preview card appearing when hovering over trigger with delay.',
-    since: '0.1.0',
-  },
-
-  // Navigation
-  {
-    name: 'Tabs',
-    module: 'navigation',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Accessible tab system with keyboard arrow navigation, roving tabIndex, and auto-linked tab/panel IDs.',
-    since: '0.1.0',
-    props: { defaultValue: 'string', value: 'string', onValueChange: '(val: string) => void', variant: "'pills' | 'line' | 'enclosed'", orientation: "'horizontal' | 'vertical'" },
-  },
-  {
-    name: 'TabsList',
-    module: 'navigation',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Container for tab triggers with role=tablist.',
-    since: '0.1.0',
-  },
-  {
-    name: 'TabsTrigger',
-    module: 'navigation',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Tab trigger button with roving tabIndex and role=tab.',
-    since: '0.1.0',
-  },
-  {
-    name: 'TabsContent',
-    module: 'navigation',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Tab panel content with role=tabpanel and aria-labelledby.',
-    since: '0.1.0',
-  },
-  {
-    name: 'Breadcrumb',
-    module: 'navigation',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Breadcrumb navigation trail with role=navigation.',
-    since: '0.1.0',
-  },
-  {
-    name: 'BreadcrumbItem',
-    module: 'navigation',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Single item in breadcrumb trail.',
-    since: '0.1.0',
-  },
-  {
-    name: 'BreadcrumbLink',
-    module: 'navigation',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Clickable breadcrumb link.',
-    since: '0.1.0',
-  },
-  {
-    name: 'BreadcrumbPage',
-    module: 'navigation',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Current active breadcrumb page with aria-current=page.',
-    since: '0.1.0',
-  },
-  {
-    name: 'BreadcrumbSeparator',
-    module: 'navigation',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Separator icon between breadcrumb items.',
-    since: '0.1.0',
-  },
-  {
-    name: 'Pagination',
-    module: 'navigation',
-    category: 'Composite',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Pagination controls with page numbers, ellipsis, and prev/next buttons.',
-    since: '0.1.0',
-  },
-  {
-    name: 'Stepper',
-    module: 'navigation',
-    category: 'Composite',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Multi-step process indicator with completed, active, and upcoming steps.',
-    since: '0.1.0',
-  },
-  {
-    name: 'DropdownMenu',
-    module: 'navigation',
-    category: 'Composite',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Contextual dropdown menu with keyboard arrow navigation and role=menu.',
-    since: '0.1.0',
-  },
-  {
-    name: 'DropdownMenuTrigger',
-    module: 'navigation',
-    category: 'Composite',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Trigger button for dropdown menu.',
-    since: '0.1.0',
-  },
-  {
-    name: 'DropdownMenuContent',
-    module: 'navigation',
-    category: 'Composite',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Menu list container with role=menu.',
-    since: '0.1.0',
-  },
-  {
-    name: 'DropdownMenuItem',
-    module: 'navigation',
-    category: 'Composite',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Interactive item in dropdown menu with role=menuitem.',
-    since: '0.1.0',
-  },
-  {
-    name: 'DropdownMenuSeparator',
-    module: 'navigation',
-    category: 'Composite',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Divider in dropdown menu.',
-    since: '0.1.0',
-  },
-  {
-    name: 'DropdownMenuLabel',
-    module: 'navigation',
-    category: 'Composite',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Group label in dropdown menu.',
-    since: '0.1.0',
-  },
-  {
-    name: 'CommandPalette',
-    module: 'navigation',
-    category: 'Advanced',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Spotlight-style ⌘K global command palette with search filtering.',
-    since: '0.1.0',
-  },
-
-  // Data Display
-  {
-    name: 'Card',
-    module: 'data-display',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'Glass-morphic and solid card container.',
-    since: '0.1.0',
-  },
-  {
-    name: 'CardHeader',
-    module: 'data-display',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'Card top header section.',
-    since: '0.1.0',
-  },
-  {
-    name: 'CardTitle',
-    module: 'data-display',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'Card title heading.',
-    since: '0.1.0',
-  },
-  {
-    name: 'CardDescription',
-    module: 'data-display',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'Card secondary description text.',
-    since: '0.1.0',
-  },
-  {
-    name: 'CardContent',
-    module: 'data-display',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'Card body content section.',
-    since: '0.1.0',
-  },
-  {
-    name: 'CardFooter',
-    module: 'data-display',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'Card bottom action section.',
-    since: '0.1.0',
-  },
-  {
-    name: 'Table',
-    module: 'data-display',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'HTML5 semantic table container.',
-    since: '0.1.0',
-  },
-  {
-    name: 'TableHeader',
-    module: 'data-display',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'Table thead element.',
-    since: '0.1.0',
-  },
-  {
-    name: 'TableBody',
-    module: 'data-display',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'Table tbody element.',
-    since: '0.1.0',
-  },
-  {
-    name: 'TableFooter',
-    module: 'data-display',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'Table tfoot element.',
-    since: '0.1.0',
-  },
-  {
-    name: 'TableRow',
-    module: 'data-display',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'Table tr element.',
-    since: '0.1.0',
-  },
-  {
-    name: 'TableHead',
-    module: 'data-display',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'Table th element.',
-    since: '0.1.0',
-  },
-  {
-    name: 'TableCell',
-    module: 'data-display',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'Table td element.',
-    since: '0.1.0',
-  },
-  {
-    name: 'TableCaption',
-    module: 'data-display',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'Table caption element.',
-    since: '0.1.0',
-  },
-  {
-    name: 'Avatar',
-    module: 'data-display',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'User avatar image with fallback initials and status badge indicator.',
-    since: '0.1.0',
-  },
-  {
-    name: 'AvatarGroup',
-    module: 'data-display',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'Stacked group of avatars with overflow counter.',
-    since: '0.1.0',
-  },
-  {
-    name: 'Accordion',
-    module: 'data-display',
-    category: 'Composite',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Collapsible accordion with single/multiple expansion modes and smooth height animation.',
-    since: '0.1.0',
-  },
-  {
-    name: 'AccordionItem',
-    module: 'data-display',
-    category: 'Composite',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Single collapsible accordion item.',
-    since: '0.1.0',
-  },
-  {
-    name: 'AccordionTrigger',
-    module: 'data-display',
-    category: 'Composite',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Header button triggering accordion collapse/expand.',
-    since: '0.1.0',
-  },
-  {
-    name: 'AccordionContent',
-    module: 'data-display',
-    category: 'Composite',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Collapsible body content.',
-    since: '0.1.0',
-  },
-  {
-    name: 'Chip',
-    module: 'data-display',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Interactive tag or badge with removable button.',
-    since: '0.1.0',
-  },
-  {
-    name: 'StatCard',
-    module: 'data-display',
-    category: 'Composite',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'Dashboard metric card with trend indicators and sparklines.',
-    since: '0.1.0',
-  },
-  {
-    name: 'Timeline',
-    module: 'data-display',
-    category: 'Composite',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'Chronological timeline of events with icons and connecting rails.',
-    since: '0.1.0',
-  },
-  {
-    name: 'DataTablePro',
-    module: 'data-display',
-    category: 'Advanced',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Enterprise data table with sorting, search accessors, pagination clamp, cross-page selection, CSV export, and server-mode support.',
-    since: '0.1.0',
-    props: {
-      data: 'TData[]',
-      columns: 'ColumnDef<TData>[]',
-      keyExtractor: '(row: TData) => string',
-      searchable: 'boolean',
-      selectable: 'boolean',
-      manualPagination: 'boolean',
-      manualSorting: 'boolean',
-      manualFiltering: 'boolean',
-    },
-  },
-  {
-    name: 'TreeView',
-    module: 'data-display',
-    category: 'Advanced',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Hierarchical tree view with full WAI-ARIA keyboard navigation and expand/collapse states.',
-    since: '0.1.0',
-    props: { data: 'TreeItem[]', selectedId: 'string', onSelect: '(item: TreeItem) => void' },
-  },
-  {
-    name: 'Carousel',
-    module: 'data-display',
-    category: 'Composite',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Sliding carousel with touch swipe, arrow navigation, and dot indicators.',
-    since: '0.1.0',
-  },
-
-  // Feedback
-  {
-    name: 'Spinner',
-    module: 'feedback',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Loading spinner with role=status and size variants.',
-    since: '0.1.0',
-  },
-  {
-    name: 'Skeleton',
-    module: 'feedback',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'Animated shimmering placeholder for loading states.',
-    since: '0.1.0',
-  },
-  {
-    name: 'SkeletonText',
-    module: 'feedback',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'Multi-line text skeleton.',
-    since: '0.1.0',
-  },
-  {
-    name: 'SkeletonCircle',
-    module: 'feedback',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'Circular skeleton for avatar placeholders.',
-    since: '0.1.0',
-  },
-  {
-    name: 'ProgressBar',
-    module: 'feedback',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Linear progress bar with role=progressbar and value announcements.',
-    since: '0.1.0',
-  },
-  {
-    name: 'CircularProgress',
-    module: 'feedback',
-    category: 'Primitives',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Radial SVG progress indicator.',
-    since: '0.1.0',
-  },
-  {
-    name: 'Alert',
-    module: 'feedback',
-    category: 'Composite',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Contextual feedback alert with status icons and role=alert.',
-    since: '0.1.0',
-  },
-  {
-    name: 'AlertTitle',
-    module: 'feedback',
-    category: 'Composite',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Alert heading title.',
-    since: '0.1.0',
-  },
-  {
-    name: 'AlertDescription',
-    module: 'feedback',
-    category: 'Composite',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Alert message body.',
-    since: '0.1.0',
-  },
-  {
-    name: 'EmptyState',
-    module: 'feedback',
-    category: 'Composite',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'Placeholder view for empty data tables, lists, or search results.',
-    since: '0.1.0',
-  },
-
-  // Glass & Bento
-  {
-    name: 'GlassCard',
-    module: 'glass',
-    category: 'Visual',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'Spatial backdrop-filter blur card with dynamic border sheen.',
-    since: '0.1.0',
-  },
-  {
-    name: 'GlassButton',
-    module: 'glass',
-    category: 'Visual',
-    status: 'stable',
-    accessibility: 'verified',
-    description: 'Translucent glass button with optical reflections.',
-    since: '0.1.0',
-  },
-  {
-    name: 'GlassBadge',
-    module: 'glass',
-    category: 'Visual',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'Pill badge with glass backdrop effect.',
-    since: '0.1.0',
-  },
-  {
-    name: 'BentoGrid',
-    module: 'bento',
-    category: 'Visual',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'Editorial bento layout grid container.',
-    since: '0.1.0',
-  },
-  {
-    name: 'BentoCard',
-    module: 'bento',
-    category: 'Visual',
-    status: 'stable',
-    accessibility: 'native',
-    description: 'Bento tile with graphic highlights and responsive spans.',
-    since: '0.1.0',
-  },
-];
+export interface ComponentMeta {
+  name: string;
+  module:
+    | 'core'
+    | 'layout'
+    | 'typography'
+    | 'buttons'
+    | 'forms'
+    | 'overlays'
+    | 'navigation'
+    | 'data-display'
+    | 'feedback'
+    | 'glass'
+    | 'bento';
+  category: 'Foundation' | 'Primitives' | 'Composite' | 'Advanced' | 'Visual';
+  status: 'stable' | 'beta' | 'experimental' | 'deprecated';
+  accessibility: 'verified' | 'supported' | 'native' | 'none';
+  description: string;
+  since: string;
+  props?: Record<string, string>;
+}
+
+export const COMPONENT_REGISTRY: ComponentMeta[] = [
+  // Core & Layout
+  {
+    name: 'ThemeProvider',
+    module: 'core',
+    category: 'Foundation',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'System-aware dark/light theme context provider with a light default and localStorage synchronization.',
+    since: '0.1.0',
+    props: { defaultTheme: "'dark' | 'light' | 'system' (default: 'light')", storageKey: 'string', children: 'ReactNode' },
+  },
+  {
+    name: 'useTheme',
+    module: 'core',
+    category: 'Foundation',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'Hook returning theme state, resolved theme, and setter functions.',
+    since: '0.1.0',
+  },
+  {
+    name: 'cn',
+    module: 'core',
+    category: 'Foundation',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'Tailwind CSS class merging utility combining clsx and tailwind-merge.',
+    since: '0.1.0',
+  },
+  {
+    name: 'Container',
+    module: 'layout',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'Max-width constrained responsive wrapper.',
+    since: '0.1.0',
+    props: { size: "'sm' | 'md' | 'lg' | 'xl' | '2xl' | 'fluid'", padding: "'none' | 'sm' | 'md' | 'lg'" },
+  },
+  {
+    name: 'Stack',
+    module: 'layout',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'Flexbox layout stack with configurable direction, gap, and alignment.',
+    since: '0.1.0',
+  },
+  {
+    name: 'HStack',
+    module: 'layout',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'Horizontal flexbox stack.',
+    since: '0.1.0',
+  },
+  {
+    name: 'VStack',
+    module: 'layout',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'Vertical flexbox stack.',
+    since: '0.1.0',
+  },
+  {
+    name: 'Grid',
+    module: 'layout',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'CSS grid container with responsive column breakpoints.',
+    since: '0.1.0',
+  },
+  {
+    name: 'GridItem',
+    module: 'layout',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'Grid child with colSpan and rowSpan props.',
+    since: '0.1.0',
+  },
+  {
+    name: 'Flex',
+    module: 'layout',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'Generic flex container.',
+    since: '0.1.0',
+  },
+  {
+    name: 'Divider',
+    module: 'layout',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'Visual separation line with optional label.',
+    since: '0.1.0',
+  },
+  {
+    name: 'Spacer',
+    module: 'layout',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'Flexible spacer taking up remaining flex space.',
+    since: '0.1.0',
+  },
+  {
+    name: 'AspectRatio',
+    module: 'layout',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'Container enforcing a specific aspect ratio.',
+    since: '0.1.0',
+  },
+  {
+    name: 'PageLayout',
+    module: 'layout',
+    category: 'Composite',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'Top-level shell layout with header, sidebar, and content areas.',
+    since: '0.1.0',
+  },
+  {
+    name: 'PageHeader',
+    module: 'layout',
+    category: 'Composite',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'Header container for page title, actions, and breadcrumb.',
+    since: '0.1.0',
+  },
+  {
+    name: 'PageSidebar',
+    module: 'layout',
+    category: 'Composite',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'Sidebar navigation panel with collapse support.',
+    since: '0.1.0',
+  },
+  {
+    name: 'ScrollArea',
+    module: 'layout',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'Custom styled scrollable container.',
+    since: '0.1.0',
+  },
+
+  // Typography
+  {
+    name: 'Heading',
+    module: 'typography',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'Polymorphic heading primitive with optical tracking.',
+    since: '0.1.0',
+    props: { as: "'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6' | 'div' | 'span'", size: "'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6'" },
+  },
+  {
+    name: 'Text',
+    module: 'typography',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'Body text primitive with editorial hierarchy variants.',
+    since: '0.1.0',
+  },
+  {
+    name: 'Label',
+    module: 'typography',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'Accessible form label with required indicator.',
+    since: '0.1.0',
+  },
+  {
+    name: 'Link',
+    module: 'typography',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'Anchor element with underline animations and external link handling.',
+    since: '0.1.0',
+  },
+  {
+    name: 'Code',
+    module: 'typography',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'Inline monospace code badge.',
+    since: '0.1.0',
+  },
+  {
+    name: 'CodeBlock',
+    module: 'typography',
+    category: 'Composite',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'Multi-line code snippet with syntax highlighting and copy-to-clipboard button.',
+    since: '0.1.0',
+  },
+  {
+    name: 'Blockquote',
+    module: 'typography',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'Stylized editorial quote with author citation.',
+    since: '0.1.0',
+  },
+  {
+    name: 'Kbd',
+    module: 'typography',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'Keyboard key badge with optical shadow.',
+    since: '0.1.0',
+  },
+
+  // Buttons
+  {
+    name: 'Button',
+    module: 'buttons',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Interactive button with micro-interactions, loading spinners, and optical states.',
+    since: '0.1.0',
+    props: { variant: "'primary' | 'secondary' | 'outline' | 'ghost' | 'danger' | 'link' | 'glass'", size: "'xs' | 'sm' | 'md' | 'lg' | 'xl'", loading: 'boolean' },
+  },
+  {
+    name: 'IconButton',
+    module: 'buttons',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Square or round icon button with mandatory aria-label.',
+    since: '0.1.0',
+  },
+  {
+    name: 'ButtonGroup',
+    module: 'buttons',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Connected group of action buttons.',
+    since: '0.1.0',
+  },
+  {
+    name: 'ToggleButton',
+    module: 'buttons',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Two-state button with pressed state.',
+    since: '0.1.0',
+  },
+  {
+    name: 'ToggleGroup',
+    module: 'buttons',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Single or multi-select group of toggle buttons.',
+    since: '0.1.0',
+  },
+  {
+    name: 'SplitButton',
+    module: 'buttons',
+    category: 'Composite',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Dual-action button with primary click and dropdown arrow menu.',
+    since: '0.1.0',
+  },
+
+  // Forms
+  {
+    name: 'FormField',
+    module: 'forms',
+    category: 'Foundation',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Accessible form field context orchestrating label, input, helper text, and error states.',
+    since: '0.1.0',
+  },
+  {
+    name: 'FormLabel',
+    module: 'forms',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Label linked automatically to FormField id.',
+    since: '0.1.0',
+  },
+  {
+    name: 'FormHelperText',
+    module: 'forms',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Descriptive helper text linked to aria-describedby.',
+    since: '0.1.0',
+  },
+  {
+    name: 'FormErrorMessage',
+    module: 'forms',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Error message linked to aria-describedby with role=alert.',
+    since: '0.1.0',
+  },
+  {
+    name: 'Input',
+    module: 'forms',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Text input with leading/trailing icons and glass focus rings.',
+    since: '0.1.0',
+  },
+  {
+    name: 'SearchInput',
+    module: 'forms',
+    category: 'Composite',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Input with search icon and one-click clear button.',
+    since: '0.1.0',
+  },
+  {
+    name: 'PasswordInput',
+    module: 'forms',
+    category: 'Composite',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Password input with toggleable visibility eye button.',
+    since: '0.1.0',
+  },
+  {
+    name: 'Textarea',
+    module: 'forms',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Multi-line textarea with auto-resize option.',
+    since: '0.1.0',
+  },
+  {
+    name: 'Select',
+    module: 'forms',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Native select dropdown with styled Chevron icon and FormField integration.',
+    since: '0.1.0',
+  },
+  {
+    name: 'Checkbox',
+    module: 'forms',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Controlled and uncontrolled checkbox with indeterminate support and full WAI-ARIA compliance.',
+    since: '0.1.0',
+    props: { checked: 'boolean', defaultChecked: 'boolean', indeterminate: 'boolean', onCheckedChange: '(checked: boolean) => void' },
+  },
+  {
+    name: 'CheckboxGroup',
+    module: 'forms',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Group container for related checkboxes.',
+    since: '0.1.0',
+  },
+  {
+    name: 'Radio',
+    module: 'forms',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Accessible radio button with animated selection dot.',
+    since: '0.1.0',
+  },
+  {
+    name: 'RadioGroup',
+    module: 'forms',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Radio group with keyboard arrow navigation.',
+    since: '0.1.0',
+  },
+  {
+    name: 'Switch',
+    module: 'forms',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'iOS-inspired spatial toggle switch with smooth physics and role=switch.',
+    since: '0.1.0',
+  },
+  {
+    name: 'Slider',
+    module: 'forms',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Single-value track slider with live fill and tooltips.',
+    since: '0.1.0',
+  },
+  {
+    name: 'RangeSlider',
+    module: 'forms',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Dual-thumb range slider with pointer capture and WAI-ARIA slider roles.',
+    since: '0.1.0',
+    props: { min: 'number', max: 'number', step: 'number', value: '[number, number]', defaultValue: '[number, number]', onChange: '(val: [number, number]) => void' },
+  },
+  {
+    name: 'PinInput',
+    module: 'forms',
+    category: 'Composite',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Multi-digit OTP/PIN code input with paste handling and arrow key navigation.',
+    since: '0.1.0',
+  },
+  {
+    name: 'DatePicker',
+    module: 'forms',
+    category: 'Composite',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Calendar date picker popover with quick presets and min/max restrictions.',
+    since: '0.1.0',
+  },
+  {
+    name: 'DateRangePicker',
+    module: 'forms',
+    category: 'Composite',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Dual date range picker with live span highlight.',
+    since: '0.1.0',
+  },
+  {
+    name: 'TimePicker',
+    module: 'forms',
+    category: 'Composite',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Time selector supporting 12h (AM/PM) and 24h formats with parent controlled sync.',
+    since: '0.1.0',
+    props: { value: 'string', defaultValue: 'string', format: "'12h' | '24h'", onChange: '(time: string) => void' },
+  },
+  {
+    name: 'Combobox',
+    module: 'forms',
+    category: 'Composite',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Searchable autocomplete dropdown with keyboard navigation and active descendant ARIA roles.',
+    since: '0.1.0',
+    props: { options: 'ComboboxOption[]', value: 'string', onChange: '(val: string) => void', searchPlaceholder: 'string' },
+  },
+  {
+    name: 'MultiSelect',
+    module: 'forms',
+    category: 'Composite',
+    status: 'beta',
+    accessibility: 'supported',
+    description: 'Multi-tag selector with search filtering, keyboard navigation, and removable chips.',
+    since: '0.1.0',
+  },
+  {
+    name: 'FileUpload',
+    module: 'forms',
+    category: 'Advanced',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Drag-and-drop file upload zone with file preview, progress bars, and validation.',
+    since: '0.1.0',
+  },
+  {
+    name: 'NumberInput',
+    module: 'forms',
+    category: 'Composite',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Numeric input with stepper buttons, clamping, and formatters.',
+    since: '0.1.0',
+  },
+  {
+    name: 'CurrencyInput',
+    module: 'forms',
+    category: 'Composite',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Currency formatted input with currency symbol adornment.',
+    since: '0.1.0',
+  },
+  {
+    name: 'MaskedInput',
+    module: 'forms',
+    category: 'Composite',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Input with format pattern mask (e.g. phone, credit card).',
+    since: '0.1.0',
+  },
+
+  // Overlays
+  {
+    name: 'Portal',
+    module: 'overlays',
+    category: 'Foundation',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'Mounts overlay children at document.body.',
+    since: '0.1.0',
+  },
+  {
+    name: 'FocusTrap',
+    module: 'overlays',
+    category: 'Foundation',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Traps keyboard Tab navigation inside container and restores focus upon exit.',
+    since: '0.1.0',
+  },
+  {
+    name: 'Modal',
+    module: 'overlays',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Accessible modal dialog with focus trapping, scroll lock reference counting, and ARIA auto-linking.',
+    since: '0.1.0',
+    props: { isOpen: 'boolean', onClose: '() => void', closeOnEsc: 'boolean', closeOnOverlayClick: 'boolean' },
+  },
+  {
+    name: 'ModalOverlay',
+    module: 'overlays',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Backdrop for modal dialogs.',
+    since: '0.1.0',
+  },
+  {
+    name: 'ModalContent',
+    module: 'overlays',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Content box for modal dialogs.',
+    since: '0.1.0',
+  },
+  {
+    name: 'ModalHeader',
+    module: 'overlays',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Header container for modal dialogs.',
+    since: '0.1.0',
+  },
+  {
+    name: 'ModalTitle',
+    module: 'overlays',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Title linked automatically to modal aria-labelledby.',
+    since: '0.1.0',
+  },
+  {
+    name: 'ModalDescription',
+    module: 'overlays',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Description linked automatically to modal aria-describedby.',
+    since: '0.1.0',
+  },
+  {
+    name: 'ModalBody',
+    module: 'overlays',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Main body for modal dialogs.',
+    since: '0.1.0',
+  },
+  {
+    name: 'ModalFooter',
+    module: 'overlays',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Action footer for modal dialogs.',
+    since: '0.1.0',
+  },
+  {
+    name: 'ModalCloseButton',
+    module: 'overlays',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Top-right close button for modal dialogs.',
+    since: '0.1.0',
+  },
+  {
+    name: 'AlertDialog',
+    module: 'overlays',
+    category: 'Composite',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Confirmation alert dialog with role=alertdialog and primary/danger confirm action.',
+    since: '0.1.0',
+  },
+  {
+    name: 'Drawer',
+    module: 'overlays',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Side or bottom drawer sheet with focus trap, scroll lock, and slide animation.',
+    since: '0.1.0',
+    props: { isOpen: 'boolean', onClose: '() => void', placement: "'right' | 'left' | 'top' | 'bottom'" },
+  },
+  {
+    name: 'DrawerHeader',
+    module: 'overlays',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Header container for drawer sheets.',
+    since: '0.1.0',
+  },
+  {
+    name: 'DrawerBody',
+    module: 'overlays',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Body container for drawer sheets.',
+    since: '0.1.0',
+  },
+  {
+    name: 'DrawerFooter',
+    module: 'overlays',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Footer container for drawer sheets.',
+    since: '0.1.0',
+  },
+  {
+    name: 'Tooltip',
+    module: 'overlays',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Micro tooltip with hover delays and role=tooltip.',
+    since: '0.1.0',
+  },
+  {
+    name: 'Popover',
+    module: 'overlays',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Floating popover anchor with outside click detection.',
+    since: '0.1.0',
+  },
+  {
+    name: 'Toast',
+    module: 'overlays',
+    category: 'Composite',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Floating toast notification with status variants and progress bar.',
+    since: '0.1.0',
+  },
+  {
+    name: 'ToasterProvider',
+    module: 'overlays',
+    category: 'Foundation',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Context provider managing toast notifications queue.',
+    since: '0.1.0',
+  },
+  {
+    name: 'useToast',
+    module: 'overlays',
+    category: 'Foundation',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Hook to trigger toasts: { toast, dismiss, toasts }.',
+    since: '0.1.0',
+  },
+  {
+    name: 'BottomSheet',
+    module: 'overlays',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Mobile drawer sheet with drag handle and scroll lock.',
+    since: '0.1.0',
+  },
+  {
+    name: 'BottomSheetHeader',
+    module: 'overlays',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Header container for bottom sheet.',
+    since: '0.1.0',
+  },
+  {
+    name: 'BottomSheetBody',
+    module: 'overlays',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Body container for bottom sheet.',
+    since: '0.1.0',
+  },
+  {
+    name: 'BottomSheetFooter',
+    module: 'overlays',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Footer container for bottom sheet.',
+    since: '0.1.0',
+  },
+  {
+    name: 'ContextMenu',
+    module: 'overlays',
+    category: 'Composite',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Right-click context menu with keyboard navigation and portal positioning.',
+    since: '0.1.0',
+  },
+  {
+    name: 'ContextMenuItem',
+    module: 'overlays',
+    category: 'Composite',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Item inside context menu with shortcut badges.',
+    since: '0.1.0',
+  },
+  {
+    name: 'ContextMenuSeparator',
+    module: 'overlays',
+    category: 'Composite',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Separator line in context menu.',
+    since: '0.1.0',
+  },
+  {
+    name: 'HoverCard',
+    module: 'overlays',
+    category: 'Composite',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Preview card appearing when hovering over trigger with delay.',
+    since: '0.1.0',
+  },
+
+  // Navigation
+  {
+    name: 'Tabs',
+    module: 'navigation',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Accessible tab system with keyboard arrow navigation, roving tabIndex, and auto-linked tab/panel IDs.',
+    since: '0.1.0',
+    props: { defaultValue: 'string', value: 'string', onValueChange: '(val: string) => void', variant: "'pills' | 'line' | 'enclosed'", orientation: "'horizontal' | 'vertical'" },
+  },
+  {
+    name: 'TabsList',
+    module: 'navigation',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Container for tab triggers with role=tablist.',
+    since: '0.1.0',
+  },
+  {
+    name: 'TabsTrigger',
+    module: 'navigation',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Tab trigger button with roving tabIndex and role=tab.',
+    since: '0.1.0',
+  },
+  {
+    name: 'TabsContent',
+    module: 'navigation',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Tab panel content with role=tabpanel and aria-labelledby.',
+    since: '0.1.0',
+  },
+  {
+    name: 'Breadcrumb',
+    module: 'navigation',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Breadcrumb navigation trail with role=navigation.',
+    since: '0.1.0',
+  },
+  {
+    name: 'BreadcrumbItem',
+    module: 'navigation',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Single item in breadcrumb trail.',
+    since: '0.1.0',
+  },
+  {
+    name: 'BreadcrumbLink',
+    module: 'navigation',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Clickable breadcrumb link.',
+    since: '0.1.0',
+  },
+  {
+    name: 'BreadcrumbPage',
+    module: 'navigation',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Current active breadcrumb page with aria-current=page.',
+    since: '0.1.0',
+  },
+  {
+    name: 'BreadcrumbSeparator',
+    module: 'navigation',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Separator icon between breadcrumb items.',
+    since: '0.1.0',
+  },
+  {
+    name: 'Pagination',
+    module: 'navigation',
+    category: 'Composite',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Pagination controls with page numbers, ellipsis, and prev/next buttons.',
+    since: '0.1.0',
+  },
+  {
+    name: 'Stepper',
+    module: 'navigation',
+    category: 'Composite',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Multi-step process indicator with completed, active, and upcoming steps.',
+    since: '0.1.0',
+  },
+  {
+    name: 'DropdownMenu',
+    module: 'navigation',
+    category: 'Composite',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Contextual dropdown menu with keyboard arrow navigation and role=menu.',
+    since: '0.1.0',
+  },
+  {
+    name: 'DropdownMenuTrigger',
+    module: 'navigation',
+    category: 'Composite',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Trigger button for dropdown menu.',
+    since: '0.1.0',
+  },
+  {
+    name: 'DropdownMenuContent',
+    module: 'navigation',
+    category: 'Composite',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Menu list container with role=menu.',
+    since: '0.1.0',
+  },
+  {
+    name: 'DropdownMenuItem',
+    module: 'navigation',
+    category: 'Composite',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Interactive item in dropdown menu with role=menuitem.',
+    since: '0.1.0',
+  },
+  {
+    name: 'DropdownMenuSeparator',
+    module: 'navigation',
+    category: 'Composite',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Divider in dropdown menu.',
+    since: '0.1.0',
+  },
+  {
+    name: 'DropdownMenuLabel',
+    module: 'navigation',
+    category: 'Composite',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Group label in dropdown menu.',
+    since: '0.1.0',
+  },
+  {
+    name: 'CommandPalette',
+    module: 'navigation',
+    category: 'Advanced',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Spotlight-style ⌘K global command palette with search filtering.',
+    since: '0.1.0',
+  },
+
+  // Data Display
+  {
+    name: 'Card',
+    module: 'data-display',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'Glass-morphic and solid card container.',
+    since: '0.1.0',
+  },
+  {
+    name: 'CardHeader',
+    module: 'data-display',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'Card top header section.',
+    since: '0.1.0',
+  },
+  {
+    name: 'CardTitle',
+    module: 'data-display',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'Card title heading.',
+    since: '0.1.0',
+  },
+  {
+    name: 'CardDescription',
+    module: 'data-display',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'Card secondary description text.',
+    since: '0.1.0',
+  },
+  {
+    name: 'CardContent',
+    module: 'data-display',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'Card body content section.',
+    since: '0.1.0',
+  },
+  {
+    name: 'CardFooter',
+    module: 'data-display',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'Card bottom action section.',
+    since: '0.1.0',
+  },
+  {
+    name: 'Table',
+    module: 'data-display',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'HTML5 semantic table container.',
+    since: '0.1.0',
+  },
+  {
+    name: 'TableHeader',
+    module: 'data-display',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'Table thead element.',
+    since: '0.1.0',
+  },
+  {
+    name: 'TableBody',
+    module: 'data-display',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'Table tbody element.',
+    since: '0.1.0',
+  },
+  {
+    name: 'TableFooter',
+    module: 'data-display',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'Table tfoot element.',
+    since: '0.1.0',
+  },
+  {
+    name: 'TableRow',
+    module: 'data-display',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'Table tr element.',
+    since: '0.1.0',
+  },
+  {
+    name: 'TableHead',
+    module: 'data-display',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'Table th element.',
+    since: '0.1.0',
+  },
+  {
+    name: 'TableCell',
+    module: 'data-display',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'Table td element.',
+    since: '0.1.0',
+  },
+  {
+    name: 'TableCaption',
+    module: 'data-display',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'Table caption element.',
+    since: '0.1.0',
+  },
+  {
+    name: 'Avatar',
+    module: 'data-display',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'User avatar image with fallback initials and status badge indicator.',
+    since: '0.1.0',
+  },
+  {
+    name: 'AvatarGroup',
+    module: 'data-display',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'Stacked group of avatars with overflow counter.',
+    since: '0.1.0',
+  },
+  {
+    name: 'Accordion',
+    module: 'data-display',
+    category: 'Composite',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Collapsible accordion with single/multiple expansion modes and smooth height animation.',
+    since: '0.1.0',
+  },
+  {
+    name: 'AccordionItem',
+    module: 'data-display',
+    category: 'Composite',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Single collapsible accordion item.',
+    since: '0.1.0',
+  },
+  {
+    name: 'AccordionTrigger',
+    module: 'data-display',
+    category: 'Composite',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Header button triggering accordion collapse/expand.',
+    since: '0.1.0',
+  },
+  {
+    name: 'AccordionContent',
+    module: 'data-display',
+    category: 'Composite',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Collapsible body content.',
+    since: '0.1.0',
+  },
+  {
+    name: 'Chip',
+    module: 'data-display',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Interactive tag or badge with removable button.',
+    since: '0.1.0',
+  },
+  {
+    name: 'StatCard',
+    module: 'data-display',
+    category: 'Composite',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'Dashboard metric card with trend indicators and sparklines.',
+    since: '0.1.0',
+  },
+  {
+    name: 'Timeline',
+    module: 'data-display',
+    category: 'Composite',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'Chronological timeline of events with icons and connecting rails.',
+    since: '0.1.0',
+  },
+  {
+    name: 'DataTablePro',
+    module: 'data-display',
+    category: 'Advanced',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Enterprise data table with sorting, search accessors, pagination clamp, cross-page selection, CSV export, and server-mode support.',
+    since: '0.1.0',
+    props: {
+      data: 'TData[]',
+      columns: 'ColumnDef<TData>[]',
+      keyExtractor: '(row: TData) => string',
+      searchable: 'boolean',
+      selectable: 'boolean',
+      manualPagination: 'boolean',
+      manualSorting: 'boolean',
+      manualFiltering: 'boolean',
+    },
+  },
+  {
+    name: 'TreeView',
+    module: 'data-display',
+    category: 'Advanced',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Hierarchical tree view with full WAI-ARIA keyboard navigation and expand/collapse states.',
+    since: '0.1.0',
+    props: { data: 'TreeItem[]', selectedId: 'string', onSelect: '(item: TreeItem) => void' },
+  },
+  {
+    name: 'Carousel',
+    module: 'data-display',
+    category: 'Composite',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Sliding carousel with touch swipe, arrow navigation, and dot indicators.',
+    since: '0.1.0',
+  },
+
+  // Feedback
+  {
+    name: 'Spinner',
+    module: 'feedback',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Loading spinner with role=status and size variants.',
+    since: '0.1.0',
+  },
+  {
+    name: 'Skeleton',
+    module: 'feedback',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'Animated shimmering placeholder for loading states.',
+    since: '0.1.0',
+  },
+  {
+    name: 'SkeletonText',
+    module: 'feedback',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'Multi-line text skeleton.',
+    since: '0.1.0',
+  },
+  {
+    name: 'SkeletonCircle',
+    module: 'feedback',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'Circular skeleton for avatar placeholders.',
+    since: '0.1.0',
+  },
+  {
+    name: 'ProgressBar',
+    module: 'feedback',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Linear progress bar with role=progressbar and value announcements.',
+    since: '0.1.0',
+  },
+  {
+    name: 'CircularProgress',
+    module: 'feedback',
+    category: 'Primitives',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Radial SVG progress indicator.',
+    since: '0.1.0',
+  },
+  {
+    name: 'Alert',
+    module: 'feedback',
+    category: 'Composite',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Contextual feedback alert with status icons and role=alert.',
+    since: '0.1.0',
+  },
+  {
+    name: 'AlertTitle',
+    module: 'feedback',
+    category: 'Composite',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Alert heading title.',
+    since: '0.1.0',
+  },
+  {
+    name: 'AlertDescription',
+    module: 'feedback',
+    category: 'Composite',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Alert message body.',
+    since: '0.1.0',
+  },
+  {
+    name: 'EmptyState',
+    module: 'feedback',
+    category: 'Composite',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'Placeholder view for empty data tables, lists, or search results.',
+    since: '0.1.0',
+  },
+
+  // Glass & Bento
+  {
+    name: 'GlassCard',
+    module: 'glass',
+    category: 'Visual',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'Spatial backdrop-filter blur card with dynamic border sheen.',
+    since: '0.1.0',
+  },
+  {
+    name: 'GlassButton',
+    module: 'glass',
+    category: 'Visual',
+    status: 'stable',
+    accessibility: 'verified',
+    description: 'Translucent glass button with optical reflections.',
+    since: '0.1.0',
+  },
+  {
+    name: 'GlassBadge',
+    module: 'glass',
+    category: 'Visual',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'Pill badge with glass backdrop effect.',
+    since: '0.1.0',
+  },
+  {
+    name: 'BentoGrid',
+    module: 'bento',
+    category: 'Visual',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'Editorial bento layout grid container.',
+    since: '0.1.0',
+  },
+  {
+    name: 'BentoCard',
+    module: 'bento',
+    category: 'Visual',
+    status: 'stable',
+    accessibility: 'native',
+    description: 'Bento tile with graphic highlights and responsive spans.',
+    since: '0.1.0',
+  },
+];