{
  "schemaVersion": 1,
  "packageName": "@rockshin/tao-ui",
  "generatedAt": "2026-11-12T16:33:14.640Z",
  "components": [
    {
      "name": "affix",
      "displayName": "Affix",
      "category": "Navigation",
      "description": "Affixes content to a window or scroll container boundary.",
      "exports": [
        "Affix"
      ],
      "source": "src/components/affix/affix.tsx",
      "story": "stories/affix.stories.tsx",
      "tests": [
        "tests/affix/affix.test.tsx"
      ],
      "semanticParts": [
        "root",
        "content"
      ],
      "usage": {
        "description": "Affixes content to a window or scroll container boundary."
      }
    },
    {
      "name": "alert",
      "displayName": "Alert",
      "category": "Feedback",
      "description": "Displays important contextual feedback messages with semantic status types.",
      "exports": [
        "Alert"
      ],
      "source": "src/components/alert/alert.tsx",
      "story": "stories/alert.stories.tsx",
      "tests": [
        "tests/alert/alert.test.tsx"
      ],
      "semanticParts": [
        "root",
        "icon",
        "title",
        "description",
        "action",
        "close"
      ],
      "keywords": [
        "alert",
        "banner",
        "feedback",
        "message",
        "notification",
        "status"
      ],
      "related": [
        "Sonner",
        "Modal",
        "Tag"
      ],
      "usage": {
        "description": "Use Alert for persistent, page-level feedback about a state or operation. Use Sonner toasts for transient notifications.",
        "bestPractices": [
          "Pick the semantic type that matches the severity of the message.",
          "Keep the title short; put detail in the description.",
          "Enable showIcon when the alert needs to be scannable at a glance."
        ],
        "avoid": [
          "Do not stack many alerts in one view; prefer a single summary.",
          "Do not use Alert for transient feedback; use a toast instead."
        ]
      },
      "props": [
        {
          "name": "type",
          "type": "'success' | 'info' | 'warning' | 'error'",
          "description": "Semantic status type controlling colors and default icon.",
          "defaultValue": "'info'"
        },
        {
          "name": "title",
          "type": "ReactNode",
          "description": "Bold heading line of the alert."
        },
        {
          "name": "description",
          "type": "ReactNode",
          "description": "Secondary text rendered below the title."
        },
        {
          "name": "showIcon",
          "type": "boolean",
          "description": "Whether to render the per-type status icon.",
          "defaultValue": "false"
        },
        {
          "name": "icon",
          "type": "ReactNode",
          "description": "Custom icon overriding the per-type default."
        },
        {
          "name": "closable",
          "type": "boolean",
          "description": "Whether to show a close button that dismisses the alert.",
          "defaultValue": "false"
        },
        {
          "name": "onClose",
          "type": "(e: MouseEvent<HTMLElement>) => void",
          "description": "Called when the close button is clicked."
        },
        {
          "name": "action",
          "type": "ReactNode",
          "description": "Right-side action slot, e.g. a button."
        }
      ]
    },
    {
      "name": "app",
      "displayName": "App",
      "category": "Config",
      "description": "Scopes imperative messages, notifications and confirmation dialogs to the current React tree and TaoProvider theme.",
      "exports": [
        "App"
      ],
      "source": "src/components/app/app.tsx",
      "story": "stories/app.stories.tsx",
      "tests": [
        "tests/app/app.test.tsx"
      ],
      "semanticParts": [
        "root"
      ],
      "keywords": [
        "app",
        "message",
        "notification",
        "modal",
        "context"
      ],
      "related": [
        "TaoProvider",
        "Modal",
        "Sonner"
      ],
      "usage": {
        "description": "Place App below TaoProvider, then call App.useApp() from descendant components. Messages return callable close handles that can be awaited; confirmation dialogs return update, destroy and then.",
        "bestPractices": [
          "Create feedback in event handlers or effects.",
          "Await modal confirmation when the next action depends on the user’s choice.",
          "Keep an App instance mounted for the lifetime of its feedback."
        ],
        "avoid": [
          "Do not call App.useApp() above its App provider.",
          "Do not use transient messages for information that must remain available."
        ]
      }
    },
    {
      "name": "auto-complete",
      "displayName": "AutoComplete",
      "category": "Data Entry",
      "description": "Editable text input with searchable suggestions, keyboard completion and custom input support.",
      "exports": [
        "AutoComplete"
      ],
      "source": "src/components/auto-complete/auto-complete.tsx",
      "story": "stories/auto-complete.stories.tsx",
      "tests": [
        "tests/auto-complete/auto-complete.test.tsx"
      ],
      "semanticParts": [
        "root",
        "prefix",
        "input",
        "placeholder",
        "content",
        "clear",
        "popup.root",
        "popup.list",
        "popup.listItem"
      ],
      "keywords": [
        "autocomplete",
        "suggestion",
        "search",
        "input"
      ],
      "related": [
        "Input",
        "Select",
        "Mentions"
      ],
      "usage": {
        "description": "Use AutoComplete when free-form input is valid and suggestions help users finish typing.",
        "bestPractices": [
          "Control value with onChange and fetch suggestions with onSearch.",
          "Provide stable values and concise option labels.",
          "Give custom input elements an accessible name."
        ],
        "avoid": [
          "Do not use onSearch as the only controlled-value update during composition.",
          "Use Select when users must choose from a closed list."
        ]
      }
    },
    {
      "name": "avatar",
      "displayName": "Avatar",
      "category": "Data Display",
      "description": "Represents people with images, icons or automatically fitted initials.",
      "exports": [
        "Avatar"
      ],
      "source": "src/components/avatar/avatar.tsx",
      "story": "stories/avatar.stories.tsx",
      "tests": [
        "tests/avatar/avatar.test.tsx"
      ],
      "semanticParts": [
        "root",
        "image",
        "icon",
        "content"
      ],
      "keywords": [
        "profile",
        "person",
        "group"
      ],
      "usage": {
        "description": "Use Avatar for a person or account; group related people with Avatar.Group.",
        "bestPractices": [
          "Provide meaningful image alternative text.",
          "Supply initials or an icon as an image fallback."
        ],
        "avoid": [
          "Do not rely on an image alone to identify an account."
        ]
      }
    },
    {
      "name": "badge",
      "displayName": "Badge",
      "category": "Data Display",
      "description": "Adds notification counts, status indicators or a ribbon to content.",
      "exports": [
        "Badge"
      ],
      "source": "src/components/badge/badge.tsx",
      "story": "stories/badge.stories.tsx",
      "tests": [
        "tests/badge/badge.test.tsx"
      ],
      "semanticParts": [
        "root",
        "indicator"
      ],
      "keywords": [
        "count",
        "status",
        "notification",
        "ribbon"
      ],
      "usage": {
        "description": "Use Badge for compact counts or a status next to a label.",
        "bestPractices": [
          "Pair status colors with meaningful text."
        ],
        "avoid": [
          "Do not use a count badge for long descriptions."
        ]
      }
    },
    {
      "name": "border-beam",
      "displayName": "BorderBeam",
      "category": "General",
      "description": "Animates a highlighted beam around the border of its child.",
      "exports": [
        "BorderBeam"
      ],
      "source": "src/components/border-beam/border-beam.tsx",
      "story": "stories/border-beam.stories.tsx",
      "tests": [
        "tests/border-beam/border-beam.test.tsx"
      ],
      "semanticParts": [
        "root",
        "beam"
      ],
      "usage": {
        "description": "Animates a highlighted beam around the border of its child."
      }
    },
    {
      "name": "breadcrumb",
      "displayName": "Breadcrumb",
      "category": "Navigation",
      "description": "Renders the user location in a hierarchy of pages or views.",
      "exports": [
        "Breadcrumb"
      ],
      "source": "src/components/breadcrumb/breadcrumb.tsx",
      "story": "stories/breadcrumb.stories.tsx",
      "tests": [
        "tests/breadcrumb/breadcrumb.test.tsx"
      ],
      "semanticParts": [
        "root",
        "list",
        "item",
        "link",
        "page",
        "separator",
        "ellipsis"
      ],
      "keywords": [
        "navigation",
        "path",
        "hierarchy"
      ],
      "related": [
        "Tabs",
        "Dropdown"
      ],
      "usage": {
        "description": "Use Breadcrumb near the top of a page when users need to understand or move through nested context.",
        "bestPractices": [
          "Keep labels short and recognizable.",
          "Use links for ancestors and plain text for the current item."
        ],
        "avoid": [
          "Do not use Breadcrumb as primary navigation."
        ]
      },
      "props": [
        {
          "name": "items",
          "type": "BreadcrumbItemType[]",
          "description": "Ordered breadcrumb items."
        },
        {
          "name": "separator",
          "type": "ReactNode",
          "description": "Custom separator between items."
        }
      ]
    },
    {
      "name": "button",
      "displayName": "Button",
      "category": "General",
      "description": "Triggers an immediate action such as submitting, saving, or opening a surface.",
      "exports": [
        "Button"
      ],
      "source": "src/components/button/button.tsx",
      "story": "stories/button.stories.tsx",
      "tests": [
        "tests/button/button.test.tsx"
      ],
      "semanticParts": [
        "root"
      ],
      "keywords": [
        "button",
        "action",
        "submit",
        "loading"
      ],
      "related": [
        "FormActions",
        "Modal"
      ],
      "usage": {
        "description": "Use Button for explicit actions. It inherits size, disabled, and variant defaults from TaoProvider.",
        "bestPractices": [
          "Prefer one primary action per view or decision area.",
          "Use loading when an action is pending.",
          "Pass a native type when using a button inside a form."
        ],
        "avoid": [
          "Do not use Button for simple navigation when a link is more accurate."
        ]
      },
      "props": [
        {
          "name": "variant",
          "type": "'primary' | 'secondary' | 'ghost' | 'destructive' | 'bare'",
          "description": "Visual emphasis.",
          "defaultValue": "'primary'"
        },
        {
          "name": "size",
          "type": "TaoSize",
          "description": "Control size, falling back to TaoProvider."
        },
        {
          "name": "loading",
          "type": "boolean",
          "description": "Disables the button and sets aria-busy."
        },
        {
          "name": "classNames",
          "type": "SemanticClassNames<'root'>",
          "description": "Semantic class override."
        }
      ]
    },
    {
      "name": "calendar",
      "displayName": "Calendar",
      "category": "Data Display",
      "description": "Browse a month or year and place events inside date cells.",
      "exports": [
        "Calendar"
      ],
      "source": "src/components/calendar/calendar.tsx",
      "story": "stories/calendar.stories.tsx",
      "tests": [
        "tests/calendar/calendar.test.tsx"
      ],
      "semanticParts": [
        "root",
        "header",
        "body",
        "content",
        "item",
        "itemContent"
      ],
      "keywords": [
        "calendar",
        "date",
        "events",
        "month",
        "year"
      ],
      "related": [
        "DatePicker",
        "TimePicker"
      ],
      "usage": {
        "description": "Use Calendar to browse schedules and select a day without opening a popup.",
        "bestPractices": [
          "Use validRange to bound the available dates.",
          "Use cellRender for date-specific events.",
          "Use fullscreen=false for compact embedded calendars."
        ],
        "avoid": [
          "Do not mutate the Day.js values passed to callbacks."
        ]
      }
    },
    {
      "name": "card",
      "displayName": "Card",
      "category": "Data Display",
      "description": "Groups related content with an optional heading, cover, tabs and actions.",
      "exports": [
        "Card"
      ],
      "source": "src/components/card/card.tsx",
      "story": "stories/card.stories.tsx",
      "tests": [
        "tests/card/card.test.tsx"
      ],
      "semanticParts": [
        "root",
        "header",
        "body",
        "extra",
        "title",
        "actions",
        "cover"
      ],
      "keywords": [
        "container",
        "content",
        "metadata",
        "panel"
      ],
      "usage": {
        "description": "Use Card for a distinct content item; Card.Meta organizes its identity and description.",
        "bestPractices": [
          "Keep titles short and actions specific."
        ],
        "avoid": [
          "Do not wrap every page section in nested cards."
        ]
      }
    },
    {
      "name": "carousel",
      "displayName": "Carousel",
      "category": "Data Display",
      "description": "Swipeable slides with fade, directional dots, autoplay, arrows and imperative navigation.",
      "exports": [
        "Carousel"
      ],
      "source": "src/components/carousel/carousel.tsx",
      "story": "stories/carousel.stories.tsx",
      "tests": [
        "tests/carousel/carousel.test.tsx"
      ],
      "semanticParts": [
        "root",
        "dots"
      ],
      "usage": {
        "description": "Swipeable slides with fade, directional dots, autoplay, arrows and imperative navigation.",
        "bestPractices": [
          "Provide meaningful labels and concise content.",
          "Keep controlled state synchronized through the change callbacks."
        ]
      }
    },
    {
      "name": "cascader",
      "displayName": "Cascader",
      "category": "Data Entry",
      "description": "Choose paths through hierarchical options with search, lazy loading, multiple selection and an inline panel.",
      "exports": [
        "Cascader",
        "CascaderPanel"
      ],
      "source": "src/components/cascader/cascader.tsx",
      "story": "stories/cascader.stories.tsx",
      "tests": [
        "tests/cascader/cascader.test.tsx"
      ],
      "semanticParts": [
        "root",
        "prefix",
        "suffix",
        "input",
        "clear",
        "placeholder",
        "content",
        "item",
        "itemContent",
        "itemRemove",
        "popup.root",
        "popup.list",
        "popup.listItem"
      ],
      "keywords": [
        "cascade",
        "select",
        "path",
        "hierarchy",
        "location"
      ],
      "related": [
        "TreeSelect",
        "Select"
      ],
      "usage": {
        "description": "Use Cascader when users select a complete path such as region, department or category.",
        "bestPractices": [
          "Use stable values at each level.",
          "Enable changeOnSelect when parent paths are valid choices.",
          "Use Cascader.Panel when the hierarchy should stay visible."
        ],
        "avoid": [
          "Do not combine lazy loadData with search over unloaded options.",
          "Do not flatten paths before handling onChange."
        ]
      }
    },
    {
      "name": "checkbox",
      "displayName": "Checkbox",
      "category": "Data Entry",
      "description": "Selects one or more independent boolean options.",
      "exports": [
        "Checkbox",
        "CheckboxGroup"
      ],
      "source": "src/components/checkbox/checkbox.tsx",
      "story": "stories/checkbox.stories.tsx",
      "tests": [
        "tests/checkbox/checkbox.test.tsx"
      ],
      "semanticParts": [
        "root",
        "indicator",
        "label"
      ],
      "keywords": [
        "checkbox",
        "boolean",
        "multi select"
      ],
      "related": [
        "Radio",
        "Switch"
      ],
      "usage": {
        "description": "Use Checkbox for independent choices, or CheckboxGroup when users can select multiple options from a set.",
        "bestPractices": [
          "Use clear labels that describe the checked state.",
          "Group related options with CheckboxGroup."
        ],
        "avoid": [
          "Do not use CheckboxGroup when only one option may be selected; use RadioGroup instead."
        ]
      },
      "props": [
        {
          "name": "checked",
          "type": "boolean",
          "description": "Controlled checked state."
        },
        {
          "name": "options",
          "type": "CheckboxOptionType[]",
          "description": "Options for CheckboxGroup."
        },
        {
          "name": "classNames",
          "type": "SemanticClassNames<CheckboxSemanticPart>",
          "description": "Semantic class overrides."
        }
      ]
    },
    {
      "name": "collapse",
      "displayName": "Collapse",
      "category": "Data Display",
      "description": "Groups content into accessible item-based panels with built-in headers, expand icons and accordion behavior.",
      "exports": [
        "Collapse"
      ],
      "source": "src/components/collapse/collapse.tsx",
      "story": "stories/collapse.stories.tsx",
      "tests": [
        "tests/collapse/collapse.test.tsx",
        "tests/collapse/panels.test.tsx"
      ],
      "semanticParts": [
        "root",
        "item",
        "header",
        "trigger",
        "title",
        "icon",
        "extra",
        "content",
        "body"
      ],
      "keywords": [
        "accordion",
        "disclosure",
        "expand"
      ],
      "related": [
        "Drawer",
        "Tabs"
      ],
      "usage": {
        "description": "Pass items with key, label and children for ready-to-use panels; use accordion to allow one open panel and activeKey/onChange for controlled state.",
        "bestPractices": [
          "Make the trigger label describe the hidden content.",
          "Use activeKey/onChange when expansion must coordinate with other UI.",
          "Keep independent header actions in extra; reserve collapsible=\"icon\" for icon-only activation."
        ],
        "avoid": [
          "Do not hide required form inputs in a collapsed region without a clear cue."
        ]
      }
    },
    {
      "name": "color-picker",
      "displayName": "ColorPicker",
      "category": "Data Entry",
      "description": "Choose single or gradient colors with hex, RGB, HSB and alpha controls.",
      "exports": [
        "ColorPicker"
      ],
      "source": "src/components/color-picker/color-picker.tsx",
      "story": "stories/color-picker.stories.tsx",
      "tests": [
        "tests/color-picker/color-picker.test.tsx"
      ],
      "semanticParts": [
        "root",
        "body",
        "content",
        "description",
        "popup.root",
        "popup.container"
      ],
      "keywords": [
        "color",
        "palette",
        "gradient",
        "hex",
        "rgb",
        "hsb"
      ],
      "related": [
        "Popover",
        "Input"
      ],
      "usage": {
        "description": "Keep the returned Color object when precision matters and call toCssString for use in CSS.",
        "bestPractices": [
          "Use presets for a constrained brand palette.",
          "Use disabledAlpha when transparency is not supported.",
          "Use onChangeComplete when a finished edit should be committed."
        ],
        "avoid": [
          "Do not discard the Color object during a drag if precision matters."
        ]
      }
    },
    {
      "name": "context-menu",
      "displayName": "ContextMenu",
      "category": "Navigation",
      "description": "Displays contextual actions from a right click or long press interaction.",
      "exports": [
        "ContextMenu"
      ],
      "source": "src/components/context-menu/context-menu.tsx",
      "story": "stories/context-menu.stories.tsx",
      "tests": [
        "tests/context-menu/context-menu.test.tsx"
      ],
      "semanticParts": [
        "root",
        "content",
        "item",
        "itemIcon",
        "itemLabel",
        "itemExtra",
        "divider",
        "groupLabel",
        "subTrigger",
        "subContent"
      ],
      "keywords": [
        "menu",
        "right click",
        "actions"
      ],
      "related": [
        "Dropdown"
      ],
      "usage": {
        "description": "Use ContextMenu for secondary actions attached to an object or region.",
        "bestPractices": [
          "Keep items short and action-oriented.",
          "Provide another reachable path for critical actions."
        ],
        "avoid": [
          "Do not put primary workflows only inside a context menu."
        ]
      }
    },
    {
      "name": "date-picker",
      "displayName": "DatePicker",
      "category": "Data Entry",
      "description": "Lets users enter or choose a single date, with optional time selection.",
      "exports": [
        "DatePicker"
      ],
      "source": "src/components/date-picker/date-picker.tsx",
      "story": "stories/date-picker.stories.tsx",
      "tests": [
        "tests/date-picker/date-picker.test.tsx",
        "tests/date-picker/use-calendar.test.ts"
      ],
      "semanticParts": [
        "root",
        "input",
        "popup",
        "calendar",
        "cell",
        "footer"
      ],
      "keywords": [
        "date",
        "calendar",
        "time"
      ],
      "related": [
        "RangePicker",
        "Input"
      ],
      "usage": {
        "description": "Use DatePicker when free text date input would be error-prone or when users benefit from calendar context.",
        "bestPractices": [
          "Support keyboard entry for known dates.",
          "Use presets for common relative choices when helpful."
        ],
        "avoid": [
          "Do not force calendar navigation for dates far in the past without typed input."
        ]
      }
    },
    {
      "name": "descriptions",
      "displayName": "Descriptions",
      "category": "Data Display",
      "description": "Displays labeled record fields with responsive columns and flexible spans.",
      "exports": [
        "Descriptions"
      ],
      "source": "src/components/descriptions/descriptions.tsx",
      "story": "stories/descriptions.stories.tsx",
      "tests": [
        "tests/descriptions/descriptions.test.tsx"
      ],
      "semanticParts": [
        "root",
        "header",
        "title",
        "extra",
        "label",
        "content"
      ],
      "usage": {
        "description": "Use Descriptions for read-only details; use Form for editable fields."
      }
    },
    {
      "name": "divider",
      "displayName": "Divider",
      "category": "Layout",
      "description": "Separates sections or inline actions with an optional title.",
      "exports": [
        "Divider"
      ],
      "source": "src/components/divider/divider.tsx",
      "story": "stories/divider.stories.tsx",
      "tests": [
        "tests/divider/divider.test.tsx"
      ],
      "semanticParts": [
        "root",
        "rail",
        "content"
      ],
      "keywords": [
        "separator",
        "line",
        "section"
      ],
      "usage": {
        "description": "Use a divider when spacing alone cannot explain a section boundary.",
        "bestPractices": [
          "Use vertical dividers between short inline actions."
        ],
        "avoid": [
          "Do not put titles inside vertical dividers."
        ]
      }
    },
    {
      "name": "drawer",
      "displayName": "Drawer",
      "category": "Feedback",
      "description": "Opens a side panel for related tasks without leaving the current page.",
      "exports": [
        "Drawer"
      ],
      "source": "src/components/drawer/drawer.tsx",
      "story": "stories/drawer.stories.tsx",
      "tests": [
        "tests/drawer/drawer.test.tsx"
      ],
      "semanticParts": [
        "root",
        "overlay",
        "header",
        "title",
        "extra",
        "body",
        "footer",
        "close",
        "dragger"
      ],
      "keywords": [
        "panel",
        "overlay",
        "side sheet"
      ],
      "related": [
        "Modal"
      ],
      "usage": {
        "description": "Use Drawer for inspection, editing, or supporting workflows that should stay connected to the current page.",
        "bestPractices": [
          "Use a clear title and predictable close affordance.",
          "Keep destructive confirmations in a dedicated confirmation step."
        ],
        "avoid": [
          "Do not stack multiple drawers for a single workflow."
        ]
      }
    },
    {
      "name": "dropdown",
      "displayName": "Dropdown",
      "category": "Navigation",
      "description": "Opens a menu of actions or navigation choices from a trigger.",
      "exports": [
        "Dropdown"
      ],
      "source": "src/components/dropdown/dropdown.tsx",
      "story": "stories/dropdown.stories.tsx",
      "tests": [
        "tests/dropdown/dropdown.test.tsx"
      ],
      "semanticParts": [
        "root",
        "content",
        "item",
        "itemIcon",
        "itemLabel",
        "itemExtra",
        "divider",
        "groupLabel",
        "subTrigger",
        "subContent"
      ],
      "keywords": [
        "menu",
        "actions",
        "more"
      ],
      "related": [
        "ContextMenu",
        "Select"
      ],
      "usage": {
        "description": "Use Dropdown for compact action sets that do not need to stay visible.",
        "bestPractices": [
          "Order frequent actions first.",
          "Use destructive styling only for destructive items."
        ],
        "avoid": [
          "Do not use Dropdown as a replacement for visible primary navigation."
        ]
      }
    },
    {
      "name": "empty",
      "displayName": "Empty",
      "category": "Data Display",
      "description": "Shows a localized empty state with an illustration, description and optional action.",
      "exports": [
        "Empty"
      ],
      "source": "src/components/empty/empty.tsx",
      "story": "stories/empty.stories.tsx",
      "tests": [
        "tests/empty/empty.test.tsx"
      ],
      "semanticParts": [
        "root",
        "image",
        "description",
        "footer"
      ],
      "keywords": [
        "empty",
        "feedback",
        "status"
      ],
      "related": [
        "Button",
        "Result"
      ],
      "usage": {
        "description": "Shows a localized empty state with an illustration, description and optional action.",
        "bestPractices": [
          "Explain the current state and offer a useful next action.",
          "Keep descriptions concise and localized."
        ],
        "avoid": [
          "Do not replace an actionable error with an unexplained empty state."
        ]
      }
    },
    {
      "name": "float-button",
      "displayName": "FloatButton",
      "category": "General",
      "description": "Provides floating actions, grouped controls and a scroll-to-top action.",
      "exports": [
        "FloatButton"
      ],
      "source": "src/components/float-button/float-button.tsx",
      "story": "stories/float-button.stories.tsx",
      "tests": [
        "tests/float-button/float-button.test.tsx"
      ],
      "semanticParts": [
        "root",
        "icon",
        "content"
      ],
      "usage": {
        "description": "Provides floating actions, grouped controls and a scroll-to-top action."
      }
    },
    {
      "name": "form",
      "displayName": "Form",
      "category": "Data Entry",
      "description": "Collects and validates field values with an antd-aligned API (rules, dependencies, Form.List) on top of the rc-form engine.",
      "exports": [
        "Form"
      ],
      "source": "src/components/form/form.tsx",
      "story": "stories/form.stories.tsx",
      "tests": [
        "tests/form/form.test.tsx",
        "tests/form/form-scroll.test.tsx"
      ],
      "semanticParts": [
        "root"
      ],
      "keywords": [
        "form",
        "validation",
        "rules",
        "submit"
      ],
      "related": [
        "FormField",
        "FormSection",
        "FormActions",
        "Input"
      ],
      "usage": {
        "description": "Use Form with Form.Item when fields need a value store, rule validation, or submit handling. Use the lighter FormField when you manage state yourself.",
        "bestPractices": [
          "Declare validation as rules on Form.Item; the required mark is inferred from rules.",
          "Use dependencies for cross-field rules such as password confirmation.",
          "Use Form.useForm() for imperative control (setFieldsValue, resetFields, submit).",
          "Call form.scrollToField(name, { focus: true }) to reveal a mounted field, including full Form.List paths; custom controls must forward ref or id.",
          "Set size or disabled on Form to cascade them to every control inside."
        ],
        "avoid": [
          "Do not bind the same name in two mounted Form.Items.",
          "Do not mix manual value/onChange props with a bound Form.Item on the same control."
        ]
      },
      "props": [
        {
          "name": "initialValues",
          "type": "Record<string, unknown>",
          "description": "Seed values for the form store."
        },
        {
          "name": "onFinish",
          "type": "(values) => void",
          "description": "Called with collected values after a valid submit."
        },
        {
          "name": "layout",
          "type": "'vertical' | 'horizontal'",
          "description": "Label/control arrangement inherited by Form.Item.",
          "defaultValue": "'vertical'"
        },
        {
          "name": "Form.Item rules",
          "type": "Rule[]",
          "description": "Validation rules (required, pattern, min/max, validator, …), same engine as antd."
        },
        {
          "name": "Form.Item help / extra",
          "type": "ReactNode",
          "description": "help overrides the rule message; extra renders a description below the control."
        }
      ]
    },
    {
      "name": "form-actions",
      "displayName": "FormActions",
      "category": "Data Entry",
      "description": "Lays out submit, cancel, and secondary actions for forms.",
      "exports": [
        "FormActions"
      ],
      "source": "src/components/form-actions/form-actions.tsx",
      "story": "stories/form.stories.tsx",
      "tests": [
        "tests/form-actions/form-actions.test.tsx"
      ],
      "semanticParts": [
        "root"
      ],
      "keywords": [
        "form",
        "actions",
        "submit"
      ],
      "related": [
        "Button",
        "FormField",
        "FormSection"
      ],
      "usage": {
        "description": "Use FormActions at the end of a form or section to align the final actions consistently.",
        "bestPractices": [
          "Keep action order consistent across forms.",
          "Use a single submit action unless the workflow truly branches."
        ]
      }
    },
    {
      "name": "form-field",
      "displayName": "FormField",
      "category": "Data Entry",
      "description": "Associates labels, help text, validation state, and controls.",
      "exports": [
        "FormField"
      ],
      "source": "src/components/form-field/form-field.tsx",
      "story": "stories/form.stories.tsx",
      "tests": [
        "tests/form-field/form-field.test.tsx"
      ],
      "semanticParts": [
        "root",
        "label",
        "description",
        "error"
      ],
      "keywords": [
        "form",
        "label",
        "validation"
      ],
      "related": [
        "Input",
        "Select",
        "FormSection"
      ],
      "usage": {
        "description": "Use FormField to provide accessible labeling and status text around a single control.",
        "bestPractices": [
          "Connect every input with a visible label.",
          "Keep validation copy specific and actionable."
        ]
      }
    },
    {
      "name": "form-layout",
      "displayName": "FormLayout",
      "category": "Layout",
      "description": "Arranges form content with consistent label and control alignment.",
      "exports": [
        "FormLayout"
      ],
      "source": "src/layouts/form-layout/form-layout.tsx",
      "story": "stories/form-layout.stories.tsx",
      "tests": [
        "tests/layouts/form-layout/form-layout.test.tsx"
      ],
      "semanticParts": [
        "root"
      ],
      "keywords": [
        "form",
        "layout",
        "labels"
      ],
      "related": [
        "FormField",
        "FormSection"
      ],
      "usage": {
        "description": "Use FormLayout to keep dense forms aligned and predictable.",
        "bestPractices": [
          "Use one layout strategy per form.",
          "Prefer vertical layout on narrow screens."
        ]
      }
    },
    {
      "name": "form-section",
      "displayName": "FormSection",
      "category": "Data Entry",
      "description": "Groups related form fields with a title and optional description.",
      "exports": [
        "FormSection"
      ],
      "source": "src/components/form-section/form-section.tsx",
      "story": "stories/form.stories.tsx",
      "tests": [
        "tests/form-section/form-section.test.tsx"
      ],
      "semanticParts": [
        "root",
        "header",
        "title",
        "description",
        "body"
      ],
      "keywords": [
        "form",
        "section",
        "group"
      ],
      "related": [
        "FormField",
        "FormLayout"
      ],
      "usage": {
        "description": "Use FormSection to break long forms into scannable groups.",
        "bestPractices": [
          "Use headings that describe the group, not the control type.",
          "Keep each section focused on one user decision area."
        ]
      }
    },
    {
      "name": "headless-input-number",
      "displayName": "HeadlessInputNumber",
      "category": "Headless",
      "description": "Headless numeric input primitives and hook for custom number entry experiences.",
      "exports": [
        "HeadlessInputNumber",
        "NumberInput",
        "useNumberInput"
      ],
      "source": "src/number-input/number-input.tsx",
      "story": "stories/headless-input-number.stories.tsx",
      "tests": [
        "tests/number-input/headless-input-number.test.tsx",
        "tests/number-input/use-number-input.test.tsx",
        "tests/number-input/format.test.ts",
        "tests/number-input/validate.test.ts"
      ],
      "keywords": [
        "headless",
        "number",
        "formatting",
        "validation"
      ],
      "related": [
        "InputNumber"
      ],
      "props": [
        {
          "name": "locale",
          "type": "string",
          "description": "BCP 47 numeric locale, also accepted by useNumberInput. Inherits TaoProvider numberLocale; explicit separators win. Canonical values and callbacks remain exact ASCII strings."
        }
      ],
      "usage": {
        "description": "Use the headless API when tao-ui styling is not appropriate but number formatting behavior should stay consistent.",
        "bestPractices": [
          "Use useNumberInput for fully custom rendering.",
          "Reuse the validation helpers for parity with the styled InputNumber."
        ]
      }
    },
    {
      "name": "image",
      "displayName": "Image",
      "category": "Data Display",
      "description": "Images with keyboard-accessible preview, grouping, transforms, fallbacks and upload progress.",
      "exports": [
        "Image",
        "ImagePreviewGroup"
      ],
      "source": "src/components/image/image.tsx",
      "story": "stories/image.stories.tsx",
      "tests": [
        "tests/image/image.test.tsx"
      ],
      "semanticParts": [
        "root",
        "image",
        "cover",
        "popup.root",
        "popup.mask",
        "popup.body",
        "popup.footer",
        "popup.actions",
        "popup.close",
        "placeholder.progress.root",
        "placeholder.progress.content",
        "placeholder.progress.rail",
        "placeholder.progress.indicator"
      ],
      "usage": {
        "description": "Images with keyboard-accessible preview, grouping, transforms, fallbacks and upload progress.",
        "bestPractices": [
          "Provide meaningful labels and concise content.",
          "Keep controlled state synchronized through the change callbacks."
        ]
      }
    },
    {
      "name": "input",
      "displayName": "Input",
      "category": "Data Entry",
      "description": "Text inputs with clearing, counting, password visibility, search, text areas and OTP.",
      "exports": [
        "Input"
      ],
      "source": "src/components/input/input.tsx",
      "story": "stories/input.stories.tsx",
      "tests": [
        "tests/input/input.test.tsx",
        "tests/input/family.test.tsx"
      ],
      "semanticParts": [
        "root",
        "input",
        "prefix",
        "suffix",
        "clear",
        "count",
        "addonBefore",
        "addonAfter"
      ],
      "keywords": [
        "text field",
        "input",
        "search"
      ],
      "related": [
        "Textarea",
        "FormField"
      ],
      "usage": {
        "description": "Use Input for short text values such as names, filters, search terms, and identifiers.",
        "bestPractices": [
          "Pair with FormField for labels and validation.",
          "Use type, inputMode, and autoComplete when applicable.",
          "Use Input.Password, Input.Search, Input.TextArea and Input.OTP for specialized input.",
          "Use count.max for a soft limit; add exceedFormatter for custom clipping."
        ]
      }
    },
    {
      "name": "input-number",
      "displayName": "InputNumber",
      "category": "Data Entry",
      "description": "A styled numeric input built on tao-ui number formatting and validation behavior.",
      "exports": [
        "InputNumber"
      ],
      "source": "src/components/input-number/input-number.tsx",
      "story": "stories/input-number.stories.tsx",
      "tests": [
        "tests/input-number/input-number.test.tsx"
      ],
      "semanticParts": [
        "root",
        "input",
        "prefix",
        "suffix"
      ],
      "keywords": [
        "number",
        "numeric",
        "stepper"
      ],
      "related": [
        "HeadlessInputNumber",
        "Input"
      ],
      "props": [
        {
          "name": "locale",
          "type": "string",
          "description": "BCP 47 numeric locale. Inherits TaoProvider numberLocale; explicit decimalSeparator/thousandsSeparator override regional symbols. Callbacks keep exact canonical ASCII strings."
        }
      ],
      "usage": {
        "description": "Use InputNumber for numeric values that need min, max, step, precision, or formatted display.",
        "bestPractices": [
          "Set min and max when the domain is bounded.",
          "Use the headless API when custom rendering is required."
        ],
        "avoid": [
          "Do not use a numeric input for identifiers such as account numbers."
        ]
      }
    },
    {
      "name": "list",
      "displayName": "List",
      "category": "Data Display",
      "description": "Displays records with metadata, actions, loading, pagination and responsive columns.",
      "exports": [
        "List"
      ],
      "source": "src/components/list/list.tsx",
      "story": "stories/list.stories.tsx",
      "tests": [
        "tests/list/list.test.tsx"
      ],
      "semanticParts": [
        "root",
        "header",
        "items",
        "footer",
        "pagination",
        "empty"
      ],
      "keywords": [
        "list",
        "records",
        "pagination"
      ],
      "related": [
        "Card",
        "Listy",
        "Empty"
      ],
      "usage": {
        "description": "Compose repeated content with List.Item and List.Item.Meta.",
        "bestPractices": [
          "Supply stable row keys for changing records.",
          "Use a responsive grid for cards and pagination for bounded pages."
        ],
        "avoid": [
          "Use Listy with virtualization for very large scrollable lists."
        ]
      }
    },
    {
      "name": "listy",
      "displayName": "Listy",
      "category": "Data Display",
      "description": "Renders grouped or virtualized lists with precise item, group and position scrolling.",
      "exports": [
        "Listy"
      ],
      "source": "src/components/listy/listy.tsx",
      "story": "stories/listy.stories.tsx",
      "tests": [
        "tests/listy/listy.test.tsx"
      ],
      "semanticParts": [
        "root",
        "item",
        "groupHeader"
      ],
      "keywords": [
        "list",
        "virtual",
        "group",
        "scroll"
      ],
      "related": [
        "List",
        "Table"
      ],
      "usage": {
        "description": "Render long lists and grouped records without mounting the entire data set.",
        "bestPractices": [
          "Provide stable rowKey values and a height when virtual is enabled.",
          "Use scrollTo with keys when records can change order."
        ],
        "avoid": [
          "Do not enable virtual scrolling without a bounded height."
        ]
      }
    },
    {
      "name": "masonry",
      "displayName": "Masonry",
      "category": "Data Display",
      "description": "Arranges variable-height content in responsive balanced columns.",
      "exports": [
        "Masonry"
      ],
      "source": "src/components/masonry/masonry.tsx",
      "story": "stories/masonry.stories.tsx",
      "tests": [
        "tests/masonry/masonry.test.tsx"
      ],
      "semanticParts": [
        "root",
        "item"
      ],
      "usage": {
        "description": "Arranges variable-height content in responsive balanced columns."
      }
    },
    {
      "name": "mentions",
      "displayName": "Mentions",
      "category": "Data Entry",
      "description": "Insert mentions into multiline text using configurable prefixes, search suggestions and keyboard selection.",
      "exports": [
        "Mentions"
      ],
      "source": "src/components/mentions/mentions.tsx",
      "story": "stories/mentions.stories.tsx",
      "tests": [
        "tests/mentions/mentions.test.tsx"
      ],
      "semanticParts": [
        "root",
        "textarea",
        "popup",
        "suffix"
      ],
      "keywords": [
        "mention",
        "textarea",
        "people",
        "tag"
      ],
      "related": [
        "Textarea",
        "AutoComplete"
      ],
      "usage": {
        "description": "Use Mentions for comments and messages that refer to people, topics or identifiers.",
        "bestPractices": [
          "Use onSearch to fetch suggestions and loading while they arrive.",
          "Use unique option values that are meaningful in the resulting text.",
          "Use Mentions.getMentions with the same prefix and split configuration."
        ],
        "avoid": [
          "Keep prefix and split consistent when parsing stored text.",
          "Do not use labels as insertion values when identifiers differ."
        ]
      }
    },
    {
      "name": "modal",
      "displayName": "Modal",
      "category": "Feedback",
      "description": "Displays a focused dialog for decisions, forms, and interruptive information.",
      "exports": [
        "Modal"
      ],
      "source": "src/components/modal/modal.tsx",
      "story": "stories/modal.stories.tsx",
      "tests": [
        "tests/modal/modal.test.tsx"
      ],
      "semanticParts": [
        "root",
        "container",
        "wrapper",
        "mask",
        "overlay",
        "header",
        "title",
        "body",
        "footer",
        "close"
      ],
      "keywords": [
        "dialog",
        "confirm",
        "overlay"
      ],
      "related": [
        "Drawer",
        "Button"
      ],
      "usage": {
        "description": "Use Modal for focused tasks or decisions. Static helpers such as Modal.confirm mirror common confirmation flows.",
        "bestPractices": [
          "Prefer Modal.useModal inside React trees so dialogs inherit TaoProvider context.",
          "Keep modal content short and task-oriented."
        ],
        "avoid": [
          "Do not use nested modals for multi-step workflows."
        ]
      },
      "props": [
        {
          "name": "width",
          "type": "number | string | TaoBreakpointMap<number | string>",
          "description": "Dialog width; accepts a breakpoint map, largest matching breakpoint wins.",
          "defaultValue": "520"
        }
      ]
    },
    {
      "name": "pagination",
      "displayName": "Pagination",
      "category": "Navigation",
      "description": "Moves through paged data with current page and page-size controls.",
      "exports": [
        "Pagination"
      ],
      "source": "src/components/pagination/pagination.tsx",
      "story": "stories/pagination.stories.tsx",
      "tests": [
        "tests/pagination/pagination.test.tsx"
      ],
      "semanticParts": [
        "root",
        "item",
        "total"
      ],
      "keywords": [
        "pages",
        "table",
        "navigation"
      ],
      "related": [
        "Table"
      ],
      "usage": {
        "description": "Use Pagination when a collection is split into pages rather than infinitely loaded.",
        "bestPractices": [
          "Keep the current page controlled when data is loaded remotely.",
          "Show total counts when they help users judge scope."
        ]
      }
    },
    {
      "name": "popconfirm",
      "displayName": "Popconfirm",
      "category": "Feedback",
      "description": "Shows a compact confirmation popup anchored to a trigger element, with OK and Cancel actions.",
      "exports": [
        "Popconfirm"
      ],
      "source": "src/components/popconfirm/popconfirm.tsx",
      "story": "stories/popconfirm.stories.tsx",
      "tests": [
        "tests/popconfirm/popconfirm.test.tsx"
      ],
      "semanticParts": [
        "content",
        "title",
        "description",
        "footer",
        "icon"
      ],
      "keywords": [
        "popconfirm",
        "confirm",
        "popover",
        "delete",
        "warning"
      ],
      "related": [
        "Popover",
        "Modal",
        "Button"
      ],
      "usage": {
        "description": "Use Popconfirm for lightweight inline confirmations such as delete actions, where a full Modal would be too heavy. Use Modal.confirm for critical or complex confirmations.",
        "bestPractices": [
          "Keep the title to one short question; put detail in the description.",
          "Use Popconfirm for reversible, low-risk actions anchored to the control that triggers them."
        ],
        "avoid": [
          "Do not use Popconfirm for irreversible high-risk operations; use Modal.confirm instead.",
          "Do not put forms or rich interactions inside a Popconfirm."
        ]
      },
      "props": [
        {
          "name": "title",
          "type": "ReactNode (required)",
          "description": "Main question text of the confirm popup."
        },
        {
          "name": "description",
          "type": "ReactNode",
          "description": "Secondary text shown under the title."
        },
        {
          "name": "onConfirm",
          "type": "(e?: MouseEvent<HTMLElement>) => void",
          "description": "Called when OK is clicked; the popup also closes."
        },
        {
          "name": "onCancel",
          "type": "(e?: MouseEvent<HTMLElement>) => void",
          "description": "Called when Cancel is clicked; the popup also closes."
        },
        {
          "name": "okText",
          "type": "ReactNode",
          "description": "Text of the OK button.",
          "defaultValue": "'OK'"
        },
        {
          "name": "cancelText",
          "type": "ReactNode",
          "description": "Text of the Cancel button.",
          "defaultValue": "'Cancel'"
        },
        {
          "name": "okButtonProps",
          "type": "ButtonProps",
          "description": "Extra props forwarded to the OK button."
        },
        {
          "name": "cancelButtonProps",
          "type": "ButtonProps",
          "description": "Extra props forwarded to the Cancel button."
        },
        {
          "name": "icon",
          "type": "ReactNode | null",
          "description": "Icon shown before the title. Pass `null` to hide it. Defaults to a warning triangle."
        },
        {
          "name": "disabled",
          "type": "boolean",
          "description": "When true, the trigger still renders but the popup never opens.",
          "defaultValue": "false"
        },
        {
          "name": "open",
          "type": "boolean",
          "description": "Controlled open state."
        },
        {
          "name": "defaultOpen",
          "type": "boolean",
          "description": "Initial open state (uncontrolled).",
          "defaultValue": "false"
        },
        {
          "name": "onOpenChange",
          "type": "(open: boolean) => void",
          "description": "Called when the open state changes."
        },
        {
          "name": "placement",
          "type": "'top' | 'bottom' | 'left' | 'right'",
          "description": "Popup side relative to the trigger.",
          "defaultValue": "'top'"
        },
        {
          "name": "classNames",
          "type": "SemanticClassNames<'content' | 'title' | 'description' | 'footer' | 'icon'>",
          "description": "Semantic per-part class name overrides."
        },
        {
          "name": "styles",
          "type": "SemanticStyles<'content' | 'title' | 'description' | 'footer' | 'icon'>",
          "description": "Semantic per-part inline style overrides."
        }
      ]
    },
    {
      "name": "popover",
      "displayName": "Popover",
      "category": "Data Display",
      "description": "Displays a floating card with rich content anchored to a trigger element, opened by click or hover.",
      "exports": [
        "Popover"
      ],
      "source": "src/components/popover/popover.tsx",
      "story": "stories/popover.stories.tsx",
      "tests": [
        "tests/popover/popover.test.tsx"
      ],
      "semanticParts": [
        "root",
        "container",
        "title",
        "content",
        "arrow"
      ],
      "keywords": [
        "popover",
        "popup",
        "floating",
        "card",
        "hover",
        "click"
      ],
      "related": [
        "Tooltip",
        "Dropdown",
        "Modal"
      ],
      "usage": {
        "description": "Use Popover for rich, non-blocking contextual content behind a click or hover. Use Tooltip for short text-only hints and Modal for blocking interactions.",
        "bestPractices": [
          "Keep the title to one short line; put detail in the content.",
          "Use the default hover trigger for read-only previews and trigger=\"click\" for interactive content.",
          "Keep popup content compact; link out for long-form detail."
        ],
        "avoid": [
          "Do not nest essential workflows inside a hover-only popover.",
          "Do not chain popovers from inside another popover."
        ]
      },
      "props": [
        {
          "name": "title",
          "type": "ReactNode",
          "description": "Header text of the popup."
        },
        {
          "name": "content",
          "type": "ReactNode",
          "description": "Body content of the popup."
        },
        {
          "name": "trigger",
          "type": "'hover' | 'focus' | 'click' | 'contextMenu' | PopoverTrigger[]",
          "description": "How the popup opens.",
          "defaultValue": "'hover'"
        },
        {
          "name": "placement",
          "type": "'top' | 'topLeft' | 'topRight' | 'bottom' | 'bottomLeft' | 'bottomRight' | 'left' | 'leftTop' | 'leftBottom' | 'right' | 'rightTop' | 'rightBottom'",
          "description": "Popup side relative to the trigger.",
          "defaultValue": "'top'"
        },
        {
          "name": "open",
          "type": "boolean",
          "description": "Controlled open state."
        },
        {
          "name": "defaultOpen",
          "type": "boolean",
          "description": "Initial open state (uncontrolled).",
          "defaultValue": "false"
        },
        {
          "name": "onOpenChange",
          "type": "(open: boolean) => void",
          "description": "Called when the open state changes."
        },
        {
          "name": "mouseEnterDelay",
          "type": "number",
          "description": "Delay in seconds before a hover opens the popup.",
          "defaultValue": "0.1"
        },
        {
          "name": "mouseLeaveDelay",
          "type": "number",
          "description": "Delay in seconds before a hover closes the popup.",
          "defaultValue": "0.1"
        },
        {
          "name": "arrow",
          "type": "boolean | { pointAtCenter?: boolean }",
          "description": "Whether to render a pointing arrow on the popup.",
          "defaultValue": "true"
        },
        {
          "name": "destroyOnHidden",
          "type": "boolean",
          "description": "Unmount the popup content while closed. When false, the content is kept mounted and hidden.",
          "defaultValue": "false"
        },
        {
          "name": "classNames",
          "type": "SemanticClassNames<'root' | 'container' | 'title' | 'content' | 'arrow'>",
          "description": "Semantic per-part class name overrides."
        },
        {
          "name": "styles",
          "type": "SemanticStyles<'root' | 'container' | 'title' | 'content' | 'arrow'>",
          "description": "Semantic per-part inline style overrides."
        }
      ]
    },
    {
      "name": "progress",
      "displayName": "Progress",
      "category": "Feedback",
      "description": "Shows measured completion with line, circle, dashboard or stepped progress indicators.",
      "exports": [
        "Progress"
      ],
      "source": "src/components/progress/progress.tsx",
      "story": "stories/progress.stories.tsx",
      "tests": [
        "tests/progress/progress.test.tsx"
      ],
      "semanticParts": [
        "root",
        "body",
        "rail",
        "track",
        "indicator"
      ],
      "keywords": [
        "progress",
        "feedback",
        "loading"
      ],
      "related": [
        "Spinner",
        "Skeleton"
      ],
      "usage": {
        "description": "Shows measured completion with line, circle, dashboard or stepped progress indicators.",
        "bestPractices": [
          "Choose a shape that matches the content and available space.",
          "Provide meaningful labels and real loading state."
        ],
        "avoid": [
          "Do not show fabricated progress or leave loading states unresolved."
        ]
      }
    },
    {
      "name": "qr-code",
      "displayName": "QRCode",
      "category": "Data Display",
      "description": "Encode a value as a canvas or SVG QR code with status and refresh controls.",
      "exports": [
        "QRCode"
      ],
      "source": "src/components/qr-code/qr-code.tsx",
      "story": "stories/qr-code.stories.tsx",
      "tests": [
        "tests/qr-code/qr-code.test.tsx"
      ],
      "semanticParts": [
        "root",
        "cover"
      ],
      "keywords": [
        "qr",
        "code",
        "scan",
        "canvas",
        "svg"
      ],
      "related": [
        "Image",
        "Spinner"
      ],
      "usage": {
        "description": "Provide a stable value and choose canvas for bitmap download or SVG for resolution-independent output.",
        "bestPractices": [
          "Use a high-contrast foreground and background.",
          "Keep the quiet zone clear.",
          "Use onRefresh for expired tokens."
        ],
        "avoid": [
          "Do not use a large center icon with low error correction."
        ]
      }
    },
    {
      "name": "radio",
      "displayName": "Radio",
      "category": "Data Entry",
      "description": "Selects exactly one option from a mutually exclusive set.",
      "exports": [
        "Radio",
        "RadioGroup"
      ],
      "source": "src/components/radio/radio.tsx",
      "story": "stories/radio.stories.tsx",
      "tests": [
        "tests/radio/radio.test.tsx"
      ],
      "semanticParts": [
        "root",
        "indicator",
        "label"
      ],
      "keywords": [
        "radio",
        "single choice",
        "selection"
      ],
      "related": [
        "Checkbox",
        "SegmentedControl"
      ],
      "usage": {
        "description": "Use RadioGroup when every option is visible and only one can be selected.",
        "bestPractices": [
          "Use concise labels.",
          "Provide a default value when one option is recommended or required."
        ],
        "avoid": [
          "Do not use RadioGroup for very long option lists; use Select instead."
        ]
      }
    },
    {
      "name": "range-picker",
      "displayName": "RangePicker",
      "category": "Data Entry",
      "description": "Lets users select a start and end date as one range value.",
      "exports": [
        "RangePicker"
      ],
      "source": "src/components/date-picker/range-picker.tsx",
      "story": "stories/date-picker.stories.tsx",
      "tests": [
        "tests/date-picker/range-picker.test.tsx",
        "tests/date-picker/use-calendar.test.ts"
      ],
      "semanticParts": [
        "root",
        "input",
        "separator",
        "popup",
        "calendar",
        "cell"
      ],
      "keywords": [
        "date range",
        "calendar",
        "time range"
      ],
      "related": [
        "DatePicker"
      ],
      "usage": {
        "description": "Use RangePicker for reporting windows, booking windows, and filters with start/end dates.",
        "bestPractices": [
          "Use presets for common ranges such as today, this week, or last 30 days.",
          "Make inclusive/exclusive range behavior clear when it matters."
        ]
      }
    },
    {
      "name": "rate",
      "displayName": "Rate",
      "category": "Data Entry",
      "description": "Collects or displays a rating with half steps, keyboard control and custom symbols.",
      "exports": [
        "Rate"
      ],
      "source": "src/components/rate/rate.tsx",
      "story": "stories/rate.stories.tsx",
      "tests": [
        "tests/rate/rate.test.tsx"
      ],
      "semanticParts": [
        "root",
        "item"
      ],
      "keywords": [
        "rate",
        "rating",
        "stars"
      ],
      "related": [
        "Slider",
        "Form"
      ],
      "usage": {
        "description": "Collect or show a bounded rating.",
        "bestPractices": [
          "Label the rating with aria-label or aria-labelledby.",
          "Use readOnly for results and allowHalf only when precision is meaningful."
        ],
        "avoid": [
          "Do not rely on color alone to explain a rating scale."
        ]
      }
    },
    {
      "name": "result",
      "displayName": "Result",
      "category": "Feedback",
      "description": "Communicates an operation result or error page with status, explanation and next actions.",
      "exports": [
        "Result"
      ],
      "source": "src/components/result/result.tsx",
      "story": "stories/result.stories.tsx",
      "tests": [
        "tests/result/result.test.tsx"
      ],
      "semanticParts": [
        "root",
        "title",
        "subTitle",
        "body",
        "extra",
        "icon"
      ],
      "keywords": [
        "result",
        "feedback",
        "status"
      ],
      "related": [
        "Button",
        "Empty"
      ],
      "usage": {
        "description": "Communicates an operation result or error page with status, explanation and next actions.",
        "bestPractices": [
          "Explain the current state and offer a useful next action.",
          "Keep descriptions concise and localized."
        ],
        "avoid": [
          "Do not replace an actionable error with an unexplained empty state."
        ]
      }
    },
    {
      "name": "scroll-area",
      "displayName": "ScrollArea",
      "category": "Data Display",
      "description": "Provides a styled scroll container for overflow content.",
      "exports": [
        "ScrollArea"
      ],
      "source": "src/components/scroll-area/scroll-area.tsx",
      "story": "stories/scroll-area.stories.tsx",
      "tests": [
        "tests/scroll-area/scroll-area.test.tsx"
      ],
      "semanticParts": [
        "root",
        "viewport",
        "scrollbar",
        "thumb"
      ],
      "keywords": [
        "scroll",
        "overflow",
        "viewport"
      ],
      "related": [
        "Table"
      ],
      "usage": {
        "description": "Use ScrollArea when a fixed region needs overflow behavior without changing page scroll.",
        "bestPractices": [
          "Constrain height explicitly.",
          "Avoid hiding important actions below a small scroll region."
        ]
      }
    },
    {
      "name": "segmented",
      "displayName": "Segmented",
      "category": "Data Entry",
      "description": "Selects one option from a compact accessible radio group.",
      "exports": [
        "Segmented"
      ],
      "source": "src/components/segmented/segmented.tsx",
      "story": "stories/segmented.stories.tsx",
      "tests": [
        "tests/segmented/segmented.test.tsx"
      ],
      "semanticParts": [
        "root",
        "item",
        "label",
        "icon"
      ],
      "usage": {
        "description": "Use Segmented for a small set of related views or modes."
      }
    },
    {
      "name": "select",
      "displayName": "Select",
      "category": "Data Entry",
      "description": "Chooses one value from a compact list of options.",
      "exports": [
        "Select"
      ],
      "source": "src/components/select/select.tsx",
      "story": "stories/select.stories.tsx",
      "tests": [
        "tests/select/select.test.tsx"
      ],
      "semanticParts": [
        "root",
        "prefix",
        "suffix",
        "placeholder",
        "clear",
        "popup",
        "search",
        "searchInput",
        "group",
        "groupLabel",
        "item",
        "itemIcon",
        "itemLabel",
        "itemDesc",
        "empty",
        "tag",
        "tagLabel",
        "tagClose",
        "tagRest",
        "values"
      ],
      "keywords": [
        "select",
        "combobox",
        "options"
      ],
      "related": [
        "Dropdown",
        "Radio"
      ],
      "usage": {
        "description": "Use Select when choices are known but too numerous or secondary to show as radios.",
        "bestPractices": [
          "Use RadioGroup when there are only a few important choices.",
          "Keep option labels stable and easy to scan."
        ],
        "avoid": [
          "Do not use Select for arbitrary text entry."
        ]
      }
    },
    {
      "name": "skeleton",
      "displayName": "Skeleton",
      "category": "Feedback",
      "description": "Displays theme-aware loading placeholders for content, avatars, controls and images.",
      "exports": [
        "Skeleton"
      ],
      "source": "src/components/skeleton/skeleton.tsx",
      "story": "stories/skeleton.stories.tsx",
      "tests": [
        "tests/skeleton/skeleton.test.tsx"
      ],
      "semanticParts": [
        "root",
        "header",
        "section",
        "avatar",
        "title",
        "paragraph"
      ],
      "keywords": [
        "skeleton",
        "feedback",
        "loading"
      ],
      "related": [
        "Spinner",
        "Progress"
      ],
      "usage": {
        "description": "Displays theme-aware loading placeholders for content, avatars, controls and images.",
        "bestPractices": [
          "Choose a shape that matches the content and available space.",
          "Provide meaningful labels and real loading state."
        ],
        "avoid": [
          "Do not show fabricated progress or leave loading states unresolved."
        ]
      }
    },
    {
      "name": "slider",
      "displayName": "Slider",
      "category": "Data Entry",
      "description": "Selects a numeric value or editable range using pointer, touch and keyboard input.",
      "exports": [
        "Slider"
      ],
      "source": "src/components/slider/slider.tsx",
      "story": "stories/slider.stories.tsx",
      "tests": [
        "tests/slider/slider.test.tsx"
      ],
      "semanticParts": [
        "root",
        "rail",
        "tracks",
        "track",
        "handle"
      ],
      "keywords": [
        "slider",
        "range",
        "number"
      ],
      "related": [
        "InputNumber",
        "Rate"
      ],
      "usage": {
        "description": "Adjust numeric values within explicit bounds.",
        "bestPractices": [
          "Label every handle and choose a meaningful step.",
          "Use onChangeComplete for expensive work after a drag finishes."
        ],
        "avoid": [
          "Do not use a slider when users need to enter an exact unbounded number."
        ]
      }
    },
    {
      "name": "sonner",
      "displayName": "Sonner",
      "category": "Feedback",
      "description": "Displays temporary toast notifications with optional actions and provider-aware theming.",
      "exports": [
        "Sonner",
        "toast"
      ],
      "source": "src/components/sonner/sonner.tsx",
      "story": "stories/sonner.stories.tsx",
      "tests": [
        "tests/sonner/sonner.test.tsx"
      ],
      "semanticParts": [
        "viewport",
        "toast",
        "content",
        "title",
        "description",
        "actions",
        "action",
        "cancel",
        "close"
      ],
      "keywords": [
        "toast",
        "notification",
        "sonner"
      ],
      "related": [
        "Modal",
        "Drawer",
        "Button"
      ],
      "usage": {
        "description": "Mount one Sonner near app root, then call toast() imperatively from event handlers. Supports toast.loading(), toast.promise(), and toast.custom() for richer async and custom notification flows.",
        "bestPractices": [
          "Prefer short, status-oriented messages with one primary action at most.",
          "Enable richColors when semantic status color should be visible."
        ],
        "avoid": [
          "Do not use toast notifications for blocking confirmations."
        ]
      }
    },
    {
      "name": "spinner",
      "displayName": "Spinner",
      "category": "Feedback",
      "description": "Indicates indeterminate loading activity.",
      "exports": [
        "Spinner"
      ],
      "source": "src/components/spinner/spinner.tsx",
      "story": "stories/spinner.stories.tsx",
      "tests": [
        "tests/spinner/spinner.test.tsx"
      ],
      "semanticParts": [
        "root",
        "indicator",
        "tip",
        "overlay"
      ],
      "keywords": [
        "loading",
        "progress",
        "busy"
      ],
      "related": [
        "Button"
      ],
      "usage": {
        "description": "Use Spinner for short indeterminate waits when progress cannot be measured.",
        "bestPractices": [
          "Prefer inline placement near the content that is loading.",
          "Use aria labels for standalone spinners."
        ],
        "avoid": [
          "Do not use Spinner for determinate progress."
        ]
      }
    },
    {
      "name": "splitter",
      "displayName": "Splitter",
      "category": "Layout",
      "description": "Creates resizable panes separated by draggable handles.",
      "exports": [
        "Splitter"
      ],
      "source": "src/components/splitter/splitter.tsx",
      "story": "stories/splitter.stories.tsx",
      "tests": [
        "tests/splitter/splitter.test.tsx"
      ],
      "semanticParts": [
        "root",
        "panel",
        "dragger"
      ],
      "keywords": [
        "resizable",
        "panes",
        "layout"
      ],
      "related": [
        "Stack",
        "FormLayout"
      ],
      "usage": {
        "description": "Use Splitter for work surfaces where users need to allocate space between adjacent panes.",
        "bestPractices": [
          "Set sensible min sizes.",
          "Persist sizes only when the layout is user-specific."
        ]
      }
    },
    {
      "name": "stack",
      "displayName": "Stack",
      "category": "Layout",
      "description": "Composes children in a flex row or column with consistent spacing.",
      "exports": [
        "Stack"
      ],
      "source": "src/layouts/stack/stack.tsx",
      "story": "stories/stack.stories.tsx",
      "tests": [
        "tests/layouts/stack/stack.test.tsx"
      ],
      "semanticParts": [
        "root"
      ],
      "keywords": [
        "layout",
        "flex",
        "spacing"
      ],
      "related": [
        "Splitter",
        "FormLayout"
      ],
      "usage": {
        "description": "Use Stack for simple one-dimensional layout and spacing.",
        "bestPractices": [
          "Prefer Stack over one-off margin rules for repeated spacing.",
          "Use semantic containers when the layout has richer meaning.",
          "Pass breakpoint maps (e.g. direction={{ xs: 'vertical', md: 'horizontal' }}) for responsive layouts."
        ]
      },
      "props": [
        {
          "name": "direction",
          "type": "TaoResponsiveValue<'vertical' | 'horizontal'>",
          "description": "Flex direction; accepts a breakpoint map resolved via useBreakpoint.",
          "defaultValue": "'vertical'"
        },
        {
          "name": "gap",
          "type": "TaoResponsiveValue<'sm' | 'md' | 'lg'>",
          "description": "Spacing between children; accepts a breakpoint map.",
          "defaultValue": "'md'"
        },
        {
          "name": "align",
          "type": "TaoResponsiveValue<'start' | 'center' | 'end' | 'stretch'>",
          "description": "Cross-axis alignment; accepts a breakpoint map.",
          "defaultValue": "'stretch'"
        }
      ]
    },
    {
      "name": "statistic",
      "displayName": "Statistic",
      "category": "Data Display",
      "description": "Formats metrics and live count-up or countdown timers.",
      "exports": [
        "Statistic"
      ],
      "source": "src/components/statistic/statistic.tsx",
      "story": "stories/statistic.stories.tsx",
      "tests": [
        "tests/statistic/statistic.test.tsx"
      ],
      "props": [
        {
          "name": "locale",
          "type": "string",
          "description": "BCP 47 numeric locale. Inherits TaoProvider numberLocale. Explicit separators and formatter take precedence; string precision and truncation semantics are preserved."
        }
      ],
      "semanticParts": [
        "root",
        "header",
        "title",
        "content",
        "value",
        "prefix",
        "suffix"
      ],
      "usage": {
        "description": "Use Statistic to emphasize a single metric with a clear title and unit."
      }
    },
    {
      "name": "steps",
      "displayName": "Steps",
      "category": "Navigation",
      "description": "Guides users through the ordered stages of a task.",
      "exports": [
        "Steps"
      ],
      "source": "src/components/steps/steps.tsx",
      "story": "stories/steps.stories.tsx",
      "tests": [
        "tests/steps/steps.test.tsx"
      ],
      "semanticParts": [
        "root",
        "item",
        "itemWrapper",
        "itemIcon",
        "itemSection",
        "itemHeader",
        "itemTitle",
        "itemSubtitle",
        "itemContent",
        "itemRail"
      ],
      "keywords": [
        "steps",
        "stepper",
        "wizard",
        "progress",
        "sequence",
        "multistep",
        "onboarding"
      ],
      "related": [
        "Tabs",
        "Breadcrumb",
        "Spinner"
      ],
      "usage": {
        "description": "Use Steps to show progress through a multi-stage task, or to let users jump back to a stage they already visited.",
        "bestPractices": [
          "Keep titles to one or two words and move detail into the content.",
          "Drive the whole bar from `current` and let status be derived from position.",
          "Provide `onChange` when revisiting a completed step is meaningful.",
          "Prefer `orientation=\"vertical\"` for long or narrow layouts."
        ],
        "avoid": [
          "Do not use Steps for peer views at the same level; use Tabs.",
          "Do not use Steps as a passive progress indicator for a single operation; use Spinner.",
          "Do not set `status` per item unless a step genuinely failed or was skipped."
        ]
      }
    },
    {
      "name": "switch",
      "displayName": "Switch",
      "category": "Data Entry",
      "description": "Toggles a setting on or off with immediate effect.",
      "exports": [
        "Switch"
      ],
      "source": "src/components/switch/switch.tsx",
      "story": "stories/switch.stories.tsx",
      "tests": [
        "tests/switch/switch.test.tsx"
      ],
      "semanticParts": [
        "root",
        "handle"
      ],
      "keywords": [
        "toggle",
        "setting",
        "boolean"
      ],
      "related": [
        "Checkbox"
      ],
      "usage": {
        "description": "Use Switch for settings that take effect immediately.",
        "bestPractices": [
          "Use labels that describe the enabled state.",
          "Use Checkbox when the value is submitted with a form."
        ]
      }
    },
    {
      "name": "table",
      "displayName": "Table",
      "category": "Data Display",
      "description": "Displays structured row and column data with selection, sorting, filtering, expandable rows, summary rows, a pinned header, and pagination hooks.",
      "exports": [
        "Table"
      ],
      "source": "src/components/table/table.tsx",
      "story": "stories/table.stories.tsx",
      "tests": [
        "tests/table/table.test.tsx"
      ],
      "semanticParts": [
        "root",
        "scroll",
        "table",
        "header.wrapper",
        "header.row",
        "header.cell",
        "header.content",
        "header.title",
        "body.row",
        "body.cell",
        "selection.cell",
        "expandedRow",
        "summary",
        "empty",
        "pagination"
      ],
      "keywords": [
        "data grid",
        "rows",
        "columns",
        "sorting"
      ],
      "related": [
        "Pagination",
        "ScrollArea"
      ],
      "usage": {
        "description": "Use Table for dense, comparable records that benefit from aligned columns.",
        "bestPractices": [
          "Keep columns focused on the task.",
          "Use stable row keys.",
          "Control sorting and pagination when data is remote.",
          "Gate secondary columns with column.responsive (e.g. ['lg']) instead of hand-rolled media queries."
        ],
        "avoid": [
          "Do not use Table for card-like content where comparison is not important."
        ]
      }
    },
    {
      "name": "tabs",
      "displayName": "Tabs",
      "category": "Navigation",
      "description": "Switches between peer panels within the same page context.",
      "exports": [
        "Tabs"
      ],
      "source": "src/components/tabs/tabs.tsx",
      "story": "stories/tabs.stories.tsx",
      "tests": [
        "tests/tabs/tabs.test.tsx"
      ],
      "semanticParts": [
        "root",
        "nav",
        "tab",
        "indicator",
        "panel"
      ],
      "keywords": [
        "tabs",
        "sections",
        "navigation"
      ],
      "related": [
        "Breadcrumb"
      ],
      "usage": {
        "description": "Use Tabs to separate peer views without navigating away from the current task.",
        "bestPractices": [
          "Use short tab labels.",
          "Keep tab panels at comparable hierarchy."
        ],
        "avoid": [
          "Do not use Tabs for sequential steps."
        ]
      }
    },
    {
      "name": "tag",
      "displayName": "Tag",
      "category": "Data Display",
      "description": "Displays compact labels, statuses, categories, or checkable chips.",
      "exports": [
        "Tag",
        "CheckableTag"
      ],
      "source": "src/components/tag/tag.tsx",
      "story": "stories/tag.stories.tsx",
      "tests": [
        "tests/tag/tag.test.tsx"
      ],
      "semanticParts": [
        "root",
        "icon",
        "content",
        "close"
      ],
      "keywords": [
        "badge",
        "chip",
        "status",
        "label"
      ],
      "related": [
        "Checkbox",
        "Table"
      ],
      "usage": {
        "description": "Use Tag for lightweight metadata or status markers. Use CheckableTag for compact filter choices.",
        "bestPractices": [
          "Use semantic colors consistently.",
          "Keep tag text short."
        ],
        "avoid": [
          "Do not encode critical state by color alone."
        ]
      }
    },
    {
      "name": "tao-provider",
      "displayName": "TaoProvider",
      "category": "Config",
      "description": "Provides global component defaults, 17 locales with date and number regional settings, portal scoping, and theme seed token overrides.",
      "exports": [
        "TaoProvider"
      ],
      "source": "src/provider/tao-provider.tsx",
      "story": "stories/provider.stories.tsx",
      "tests": [
        "tests/provider/tao-provider.test.tsx"
      ],
      "keywords": [
        "provider",
        "theme",
        "tokens",
        "size",
        "disabled",
        "locale",
        "internationalization"
      ],
      "related": [
        "Button",
        "Input",
        "tokenVar"
      ],
      "usage": {
        "description": "Wrap an app or subtree with TaoProvider to set size, disabled, variant, direction, and theme defaults.",
        "bestPractices": [
          "Prefer provider-level defaults for app-wide decisions.",
          "Use nested providers for scoped theme overrides."
        ],
        "avoid": [
          "Do not override derived CSS variables directly unless a theme token cannot express the change."
        ]
      },
      "props": [
        {
          "name": "locale",
          "type": "Partial<TaoLocale>",
          "defaultValue": "enUS",
          "description": "Component text, accessible names, form validation and regional date/number settings. Missing keys inherit from the parent; explicit component overrides win. Direction is independent."
        },
        {
          "name": "direction",
          "type": "'ltr' | 'rtl'",
          "description": "Text and interaction direction. Inherits the surrounding DOM when omitted; nested providers and component props can override it. Portals retain their source direction."
        },
        {
          "name": "size",
          "type": "TaoSize",
          "description": "Default component size for descendants."
        },
        {
          "name": "disabled",
          "type": "boolean",
          "description": "Default disabled state for descendants."
        },
        {
          "name": "variant",
          "type": "TaoVariant",
          "description": "Default field variant for descendants."
        },
        {
          "name": "theme",
          "type": "TaoThemeConfig",
          "description": "Seed token overrides for the provider scope; also carries mode, compact density, and per-component token overrides."
        },
        {
          "name": "theme.compact",
          "type": "boolean",
          "description": "Compact density: control height 32→28 and paddings one notch tighter, cascades like mode."
        },
        {
          "name": "theme.components",
          "type": "TaoComponentTokenMap",
          "description": "Per-component token overrides (Button/Input/FormField), serialized to --tao-{component}-* CSS variables."
        }
      ]
    },
    {
      "name": "textarea",
      "displayName": "Textarea",
      "category": "Data Entry",
      "description": "Multi-line text input with auto sizing, clearing and custom character counts; also available as Input.TextArea.",
      "exports": [
        "Textarea"
      ],
      "source": "src/components/textarea/textarea.tsx",
      "story": "stories/textarea.stories.tsx",
      "tests": [
        "tests/textarea/textarea.test.tsx"
      ],
      "semanticParts": [
        "root",
        "textarea",
        "clear",
        "count"
      ],
      "keywords": [
        "textarea",
        "multiline",
        "input"
      ],
      "related": [
        "Input",
        "FormField"
      ],
      "usage": {
        "description": "Use Textarea for longer freeform content such as descriptions, notes, and comments.",
        "bestPractices": [
          "Set rows or autoSize based on expected content length.",
          "Use maxLength when limits are strict."
        ]
      }
    },
    {
      "name": "timeline",
      "displayName": "Timeline",
      "category": "Data Display",
      "description": "Shows ordered events with timestamps, indicators and alternate layouts.",
      "exports": [
        "Timeline"
      ],
      "source": "src/components/timeline/timeline.tsx",
      "story": "stories/timeline.stories.tsx",
      "tests": [
        "tests/timeline/timeline.test.tsx"
      ],
      "semanticParts": [
        "root",
        "item",
        "itemWrapper",
        "itemIcon",
        "itemSection",
        "itemHeader",
        "itemTitle",
        "itemContent",
        "itemRail"
      ],
      "usage": {
        "description": "Use Timeline for chronological events and their current progress."
      }
    },
    {
      "name": "time-picker",
      "displayName": "TimePicker",
      "category": "Data Entry",
      "description": "Select or type a time, or a time range, with Day.js values and configurable precision.",
      "exports": [
        "TimePicker",
        "TimeRangePicker"
      ],
      "source": "src/components/time-picker/time-picker.tsx",
      "story": "stories/time-picker.stories.tsx",
      "tests": [
        "tests/time-picker/time-picker.test.tsx"
      ],
      "semanticParts": [
        "root",
        "prefix",
        "input",
        "suffix",
        "popup"
      ],
      "keywords": [
        "time",
        "hours",
        "minutes",
        "range",
        "dayjs"
      ],
      "related": [
        "DatePicker",
        "RangePicker"
      ],
      "usage": {
        "description": "Use TimePicker when a form needs a time without a calendar date; use TimePicker.RangePicker for start and end times.",
        "bestPractices": [
          "Use format and step intervals that match the task.",
          "Express unavailable times with disabledTime.",
          "Keep controlled values synchronized in onChange."
        ],
        "avoid": [
          "Do not treat a timezone-free time as a complete timestamp."
        ]
      }
    },
    {
      "name": "tooltip",
      "displayName": "Tooltip",
      "category": "Data Display",
      "description": "Shows a brief informational popup when hovering or focusing an element.",
      "exports": [
        "Tooltip"
      ],
      "source": "src/components/tooltip/tooltip.tsx",
      "story": "stories/tooltip.stories.tsx",
      "tests": [
        "tests/tooltip/tooltip.test.tsx"
      ],
      "semanticParts": [
        "content",
        "arrow"
      ],
      "keywords": [
        "hover",
        "hint",
        "popup",
        "infotip"
      ],
      "related": [
        "Dropdown",
        "Modal"
      ],
      "usage": {
        "description": "Use Tooltip for short contextual hints on hover or focus. The popup is portaled and inherits the TaoProvider theme.",
        "bestPractices": [
          "Keep tooltip text short and supplementary.",
          "Wrap exactly one focusable trigger element."
        ],
        "avoid": [
          "Do not put critical information or interactive content inside a Tooltip."
        ]
      },
      "props": [
        {
          "name": "title",
          "type": "ReactNode",
          "description": "Tooltip content; null, undefined or empty string disables the tooltip.",
          "required": true
        },
        {
          "name": "placement",
          "type": "'top' | 'bottom' | 'left' | 'right'",
          "description": "Popup side relative to the trigger.",
          "defaultValue": "'top'"
        },
        {
          "name": "arrow",
          "type": "boolean",
          "description": "Show the arrow pointing at the trigger.",
          "defaultValue": "true"
        },
        {
          "name": "mouseEnterDelay",
          "type": "number",
          "description": "Hover delay in seconds before opening.",
          "defaultValue": "0.1"
        },
        {
          "name": "mouseLeaveDelay",
          "type": "number",
          "description": "Delay in seconds before a pointer-leave closes the tooltip; re-entering cancels the close. Esc/blur closes stay immediate.",
          "defaultValue": "0.1"
        },
        {
          "name": "color",
          "type": "string",
          "description": "Custom content background color."
        }
      ]
    },
    {
      "name": "tour",
      "displayName": "Tour",
      "category": "Feedback",
      "description": "Guided steps anchored to page elements with a spotlight mask, custom content and accessible actions.",
      "exports": [
        "Tour"
      ],
      "source": "src/components/tour/tour.tsx",
      "story": "stories/tour.stories.tsx",
      "tests": [
        "tests/tour/tour.test.tsx"
      ],
      "semanticParts": [
        "root",
        "cover",
        "close",
        "mask",
        "section",
        "footer",
        "actions",
        "indicator",
        "indicators",
        "header",
        "title",
        "description"
      ],
      "usage": {
        "description": "Guided steps anchored to page elements with a spotlight mask, custom content and accessible actions.",
        "bestPractices": [
          "Provide meaningful labels and concise content.",
          "Keep controlled state synchronized through the change callbacks."
        ]
      }
    },
    {
      "name": "transfer",
      "displayName": "Transfer",
      "category": "Data Entry",
      "description": "Moves selected records between searchable, paginated source and target lists.",
      "exports": [
        "Transfer"
      ],
      "source": "src/components/transfer/transfer.tsx",
      "story": "stories/transfer.stories.tsx",
      "tests": [
        "tests/transfer/transfer.test.tsx"
      ],
      "semanticParts": [
        "root",
        "section",
        "header",
        "title",
        "body",
        "list",
        "item",
        "itemIcon",
        "itemContent",
        "footer",
        "actions"
      ],
      "keywords": [
        "transfer",
        "selection",
        "dual-list"
      ],
      "related": [
        "Checkbox",
        "List",
        "Table"
      ],
      "usage": {
        "description": "Assign records by moving them between source and target lists.",
        "bestPractices": [
          "Keep targetKeys controlled and update them in onChange.",
          "Use stable keys and searchable labels for large data sets."
        ],
        "avoid": [
          "Do not treat selectedKeys as assigned items; only targetKeys represents the target list."
        ]
      }
    },
    {
      "name": "tree",
      "displayName": "Tree",
      "category": "Data Display",
      "description": "Navigate, select and check hierarchical data with keyboard navigation, lazy loading and virtual scrolling.",
      "exports": [
        "Tree",
        "DirectoryTree"
      ],
      "source": "src/components/tree/tree.tsx",
      "story": "stories/tree.stories.tsx",
      "tests": [
        "tests/tree/tree.test.tsx"
      ],
      "semanticParts": [
        "root",
        "item",
        "itemIcon",
        "itemTitle",
        "itemSwitcher"
      ],
      "keywords": [
        "tree",
        "hierarchy",
        "directory",
        "files",
        "selection"
      ],
      "related": [
        "TreeSelect",
        "Cascader"
      ],
      "usage": {
        "description": "Use Tree for hierarchical information. DirectoryTree adds file-explorer selection with Ctrl/Command and Shift modifiers.",
        "bestPractices": [
          "Give every node a unique stable key.",
          "Use controlled expandedKeys when asynchronously supplied data needs expansion.",
          "Supply an accessible name and use height for large virtual trees."
        ],
        "avoid": [
          "Do not use defaultExpandAll to control data that arrives after mount.",
          "Do not assume parent and child checks are independent unless checkStrictly is enabled."
        ]
      }
    },
    {
      "name": "tree-select",
      "displayName": "TreeSelect",
      "category": "Data Entry",
      "description": "Select hierarchical values with search, checkable trees, lazy loading and virtual scrolling.",
      "exports": [
        "TreeSelect"
      ],
      "source": "src/components/tree-select/tree-select.tsx",
      "story": "stories/tree-select.stories.tsx",
      "tests": [
        "tests/tree-select/tree-select.test.tsx"
      ],
      "semanticParts": [
        "root",
        "prefix",
        "suffix",
        "input",
        "clear",
        "placeholder",
        "content",
        "item",
        "itemContent",
        "itemRemove",
        "popup.root",
        "popup.item",
        "popup.itemTitle",
        "popup.itemSwitcher"
      ],
      "keywords": [
        "tree",
        "select",
        "hierarchy",
        "search",
        "checkbox"
      ],
      "related": [
        "Tree",
        "Cascader",
        "Select"
      ],
      "usage": {
        "description": "Use TreeSelect when a form value comes from a hierarchy and users need to search or check multiple nodes.",
        "bestPractices": [
          "Give every node a unique value.",
          "Use showSearch.treeNodeFilterProp to search meaningful labels.",
          "Use treeCheckStrictly for independent parent and child values."
        ],
        "avoid": [
          "Do not use default expansion props to control asynchronously arriving data.",
          "Do not expect loadData to run while filtering."
        ]
      }
    },
    {
      "name": "upload",
      "displayName": "Upload",
      "category": "Data Entry",
      "description": "Select, transform, upload and manage files with real request progress and cancellation.",
      "exports": [
        "Upload"
      ],
      "source": "src/components/upload/upload.tsx",
      "story": "stories/upload.stories.tsx",
      "tests": [
        "tests/upload/upload.test.tsx"
      ],
      "semanticParts": [
        "root",
        "list",
        "item",
        "trigger"
      ],
      "keywords": [
        "upload",
        "file",
        "drop",
        "request",
        "progress"
      ],
      "related": [
        "Button",
        "Progress"
      ],
      "usage": {
        "description": "Provide an upload action or a customRequest transport, or return false from beforeUpload to manage files locally.",
        "bestPractices": [
          "Return Upload.LIST_IGNORE to keep rejected files out of the list.",
          "Use onChange to synchronize controlled fileList values.",
          "Return an abort handler from customRequest for cancellation."
        ],
        "avoid": [
          "Do not mark a file successful until the server confirms it."
        ]
      }
    },
    {
      "name": "watermark",
      "displayName": "Watermark",
      "category": "General",
      "description": "Repeats a text or image watermark over content and inherited dialog panels.",
      "exports": [
        "Watermark"
      ],
      "source": "src/components/watermark/watermark.tsx",
      "story": "stories/watermark.stories.tsx",
      "tests": [
        "tests/watermark/watermark.test.tsx"
      ],
      "semanticParts": [
        "root",
        "mark"
      ],
      "usage": {
        "description": "Repeats a text or image watermark over content and inherited dialog panels."
      }
    }
  ]
}
