@maestro-js/components 1.0.0-alpha.0

package/registry.json

@@ -0,0 +1,1445 @@
+[
+  {
+    "name": "button",
+    "title": "Button",
+    "description": "A polymorphic button with variants, colors, sizes, shapes, toggle state, and built-in async click handling with a delayed spinner.",
+    "files": [
+      {
+        "path": "src/components/button.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/icon.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/spinner.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/helpers/button-context.ts",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/components/helpers/get-button-classes.ts",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/components/helpers/headless-button.tsx",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/utils/compose-refs.ts",
+        "type": "utils"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      },
+      {
+        "path": "src/utils/use-prevent-default.ts",
+        "type": "utils"
+      },
+      {
+        "path": "src/utils/use-render-props.ts",
+        "type": "utils"
+      },
+      {
+        "path": "src/utils/use-spin-delay.ts",
+        "type": "utils"
+      },
+      {
+        "path": "src/utils/use-stable-accessor.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "icon",
+    "title": "Icon",
+    "description": "An SVG icon component that renders icons from a sprite sheet.",
+    "files": [
+      {
+        "path": "src/components/icon.tsx",
+        "type": "components"
+      }
+    ]
+  },
+  {
+    "name": "headless-file-input",
+    "title": "Headless File Input",
+    "description": "A headless file input with drag-and-drop, multiple file support, controlled/uncontrolled state, file preview, and form submission for both files and URLs.",
+    "files": [
+      {
+        "path": "src/components/headless-file-input.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/utils/compose-refs.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "button-link",
+    "title": "Button Link",
+    "description": "A React Router Link styled as a button with variants, colors, sizes, shapes, and a loading spinner for pending navigation.",
+    "files": [
+      {
+        "path": "src/components/button-link.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/icon.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/spinner.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/helpers/button-context.ts",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/components/helpers/get-button-classes.ts",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      },
+      {
+        "path": "src/utils/use-spin-delay.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "button-group",
+    "title": "Button Group",
+    "description": "A container for grouping buttons with configurable orientation, alignment, sizing, and full-width support.",
+    "files": [
+      {
+        "path": "src/components/button-group.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "toggle-button-group",
+    "title": "Toggle Button Group",
+    "description": "A radio-style group of toggle buttons with horizontal/vertical layout, keyboard navigation, and size variants.",
+    "files": [
+      {
+        "path": "src/components/toggle-button-group.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/helpers/get-button-classes.ts",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "date-picker",
+    "title": "Date Picker",
+    "description": "An accessible date picker with calendar popup, month/year navigation, form validation integration, and ISO date string handling.",
+    "files": [
+      {
+        "path": "src/components/date-picker.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/icon.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/helpers/animated-popover.tsx",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/components/helpers/calendar-month-year-picker.tsx",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/components/helpers/form-field.tsx",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "text-field",
+    "title": "Text Field",
+    "description": "A text input with type variants (email, password, url, etc.), trailing addon support, shape options, form validation integration, and accessible labeling.",
+    "files": [
+      {
+        "path": "src/components/text-field.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/helpers/form-field.tsx",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/components/helpers/headless-button.tsx",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/utils/compose-refs.ts",
+        "type": "utils"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      },
+      {
+        "path": "src/utils/use-render-props.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "text-area",
+    "title": "Text Area",
+    "description": "A multi-line text input with auto-resize, min/max rows, resize control, form validation integration, and accessible labeling.",
+    "files": [
+      {
+        "path": "src/components/text-area.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/helpers/form-field.tsx",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "number-field",
+    "title": "Number Field",
+    "description": "A numeric input with min/max/step constraints, Intl.NumberFormat formatting, form validation integration, and accessible labeling.",
+    "files": [
+      {
+        "path": "src/components/number-field.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/helpers/form-field.tsx",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      },
+      {
+        "path": "src/utils/use-number-input.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "currency-field",
+    "title": "Currency Field",
+    "description": "A dollar/cents currency input with Intl.NumberFormat formatting, cents-to-dollars conversion, form validation integration, and accessible labeling.",
+    "files": [
+      {
+        "path": "src/components/currency-field.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/helpers/form-field.tsx",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      },
+      {
+        "path": "src/utils/use-number-input.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "percentage-field",
+    "title": "Percentage Field",
+    "description": "A percentage input with integer/decimal unit conversion, Intl.NumberFormat percent formatting, form validation integration, and accessible labeling.",
+    "files": [
+      {
+        "path": "src/components/percentage-field.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/helpers/form-field.tsx",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      },
+      {
+        "path": "src/utils/use-number-input.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "phone-number-field",
+    "title": "Phone Number Field",
+    "description": "A phone number input with auto-formatting for US/CA/international numbers, form validation integration, and accessible labeling.",
+    "files": [
+      {
+        "path": "src/components/phone-number-field.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/helpers/form-field.tsx",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "tag-field",
+    "title": "Tag Field",
+    "description": "A string tag input with custom separators, duplicate prevention, tag validation/transformation, max tag limits, and form integration.",
+    "files": [
+      {
+        "path": "src/components/tag-field.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/icon.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/helpers/form-field.tsx",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "numeric-tag-field",
+    "title": "Numeric Tag Field",
+    "description": "A tag input for numeric values with min/max bounds, duplicate prevention, tag validation/transformation, and form integration.",
+    "files": [
+      {
+        "path": "src/components/numeric-tag-field.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/icon.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/helpers/form-field.tsx",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "date-input",
+    "title": "Date Input",
+    "description": "An accessible inline date field (no popup) with min/max constraints, form validation integration, and ISO date string handling.",
+    "files": [
+      {
+        "path": "src/components/date-input.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/helpers/form-field.tsx",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "date-range-picker",
+    "title": "Date Range Picker",
+    "description": "An accessible date range picker with dual calendar popover, preset ranges, form validation integration, and ISO date string handling.",
+    "files": [
+      {
+        "path": "src/components/date-range-picker.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/icon.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/helpers/animated-popover.tsx",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/components/helpers/form-field.tsx",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "date-time-picker",
+    "title": "Date Time Picker",
+    "description": "An accessible combined date and time picker with calendar popup, month/year navigation, 12/24-hour format, form validation integration, and ISO datetime string handling.",
+    "files": [
+      {
+        "path": "src/components/date-time-picker.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/icon.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/helpers/animated-popover.tsx",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/components/helpers/calendar-month-year-picker.tsx",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/components/helpers/form-field.tsx",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "time-input",
+    "title": "Time Input",
+    "description": "An accessible time picker with 12/24-hour format, min/max constraints, form validation integration, and ISO time string handling.",
+    "files": [
+      {
+        "path": "src/components/time-input.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/helpers/form-field.tsx",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "month-day-input",
+    "title": "Month Day Input",
+    "description": "An accessible month-day input (--MM-DD format) with year segment hidden, form validation integration, and ISO month-day string handling.",
+    "files": [
+      {
+        "path": "src/components/month-day-input.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/helpers/form-field.tsx",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "year-month-input",
+    "title": "Year Month Input",
+    "description": "An accessible year-month input (YYYY-MM format) with day segment hidden, form validation integration, and ISO year-month string handling.",
+    "files": [
+      {
+        "path": "src/components/year-month-input.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/helpers/form-field.tsx",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "select",
+    "title": "Select",
+    "description": "A single-select dropdown with colored options, custom rendering, keyboard navigation, form validation integration, and accessible labeling.",
+    "files": [
+      {
+        "path": "src/components/select.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/icon.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/helpers/animated-popover.tsx",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/components/helpers/form-field.tsx",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/utils/colors.ts",
+        "type": "utils"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "boolean-select",
+    "title": "Boolean Select",
+    "description": "A Yes/No dropdown with optional null state, customizable labels, and form validation integration. Built on the Select component.",
+    "files": [
+      {
+        "path": "src/components/boolean-select.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/icon.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/select.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/helpers/animated-popover.tsx",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/components/helpers/form-field.tsx",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/utils/colors.ts",
+        "type": "utils"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "autocomplete",
+    "title": "Autocomplete",
+    "description": "A searchable single-select dropdown with matchSorter filtering, colored options, custom rendering, form validation integration, and accessible labeling.",
+    "files": [
+      {
+        "path": "src/components/autocomplete.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/icon.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/helpers/animated-popover.tsx",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/components/helpers/form-field.tsx",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/utils/colors.ts",
+        "type": "utils"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "autosuggest",
+    "title": "Autosuggest",
+    "description": "A text input with suggestions that allows custom (non-option) values, matchSorter filtering, form validation integration, and accessible labeling.",
+    "files": [
+      {
+        "path": "src/components/autosuggest.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/icon.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/helpers/animated-popover.tsx",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/components/helpers/form-field.tsx",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "multiselect",
+    "title": "Multiselect",
+    "description": "A multi-select dropdown with chip display, optional select all, colored options, custom rendering, form validation integration, and accessible labeling.",
+    "files": [
+      {
+        "path": "src/components/multiselect.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/icon.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/helpers/animated-popover.tsx",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/components/helpers/form-field.tsx",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/utils/colors.ts",
+        "type": "utils"
+      },
+      {
+        "path": "src/utils/compose-refs.ts",
+        "type": "utils"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      },
+      {
+        "path": "src/utils/use-element-size.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "multicomplete",
+    "title": "Multicomplete",
+    "description": "A multi-select with search filtering, colored chips, matchSorter filtering, custom rendering, form validation integration, and accessible labeling.",
+    "files": [
+      {
+        "path": "src/components/multicomplete.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/icon.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/helpers/animated-popover.tsx",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/components/helpers/form-field.tsx",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/utils/colors.ts",
+        "type": "utils"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "multisuggest",
+    "title": "Multisuggest",
+    "description": "A multi-select autocomplete with suggestions that allows adding custom values not in the options list, chip display, matchSorter filtering, form validation integration, and accessible labeling.",
+    "files": [
+      {
+        "path": "src/components/multisuggest.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/icon.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/helpers/animated-popover.tsx",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/components/helpers/form-field.tsx",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "checkbox",
+    "title": "Checkbox",
+    "description": "A single checkbox with plain and labeled variants, indeterminate state support, form validation integration, and accessible keyboard navigation.",
+    "files": [
+      {
+        "path": "src/components/checkbox.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/icon.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/helpers/form-field.tsx",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "checkbox-group",
+    "title": "Checkbox Group",
+    "description": "A group of checkboxes with select all, min/max selection constraints, horizontal/vertical orientation, form validation integration, and accessible labeling.",
+    "files": [
+      {
+        "path": "src/components/checkbox-group.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/checkbox.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/icon.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/helpers/form-field.tsx",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "radio",
+    "title": "Radio",
+    "description": "A single radio option with plain and labeled variants, optional description text, and accessible keyboard navigation.",
+    "files": [
+      {
+        "path": "src/components/radio.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "radio-group",
+    "title": "Radio Group",
+    "description": "A mutually exclusive radio group with horizontal/vertical/grid orientation, form validation integration, and accessible labeling.",
+    "files": [
+      {
+        "path": "src/components/radio-group.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/helpers/form-field.tsx",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "switch",
+    "title": "Switch",
+    "description": "A boolean toggle switch with plain and labeled variants, description text, label positioning, form validation integration, and accessible keyboard navigation.",
+    "files": [
+      {
+        "path": "src/components/switch.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/helpers/form-field.tsx",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "file-input",
+    "title": "File Input",
+    "description": "A single file upload with drag-and-drop zone, file type and size validation, custom preview rendering, form validation integration, and accessible labeling.",
+    "files": [
+      {
+        "path": "src/components/file-input.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/headless-file-input.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/icon.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/helpers/form-field.tsx",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/utils/compose-refs.ts",
+        "type": "utils"
+      },
+      {
+        "path": "src/utils/file-input.ts",
+        "type": "utils"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "multi-file-input",
+    "title": "Multi File Input",
+    "description": "A multi-file upload with drag-and-drop zone, file list display, per-file type and size validation, max file count, form validation integration, and accessible labeling.",
+    "files": [
+      {
+        "path": "src/components/multi-file-input.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/headless-file-input.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/icon.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/helpers/form-field.tsx",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/utils/compose-refs.ts",
+        "type": "utils"
+      },
+      {
+        "path": "src/utils/file-input.ts",
+        "type": "utils"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "image-input",
+    "title": "Image Input",
+    "description": "A single image upload with drag-and-drop zone, image preview with gradient overlay, file type and size validation, custom preview rendering, form validation integration, and accessible labeling.",
+    "files": [
+      {
+        "path": "src/components/image-input.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/headless-file-input.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/icon.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/helpers/form-field.tsx",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/utils/compose-refs.ts",
+        "type": "utils"
+      },
+      {
+        "path": "src/utils/file-input.ts",
+        "type": "utils"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "multi-image-input",
+    "title": "Multi Image Input",
+    "description": "A multi-image upload with grid display, drag-and-drop, optional reordering, per-image type and size validation, max image count, custom preview rendering, form validation integration, and accessible labeling.",
+    "files": [
+      {
+        "path": "src/components/multi-image-input.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/headless-file-input.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/icon.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/helpers/form-field.tsx",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/utils/compose-refs.ts",
+        "type": "utils"
+      },
+      {
+        "path": "src/utils/file-input.ts",
+        "type": "utils"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "pdf-input",
+    "title": "PDF Input",
+    "description": "A single PDF upload with drag-and-drop zone, PDF preview using the Pdf component, file size validation, custom preview rendering, form validation integration, and accessible labeling.",
+    "files": [
+      {
+        "path": "src/components/pdf-input.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/headless-file-input.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/icon.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/pdf.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/helpers/form-field.tsx",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/utils/compose-refs.ts",
+        "type": "utils"
+      },
+      {
+        "path": "src/utils/file-input.ts",
+        "type": "utils"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      },
+      {
+        "path": "src/utils/use-pagination.ts",
+        "type": "utils"
+      },
+      {
+        "path": "src/components/helpers/pdf-dist.client.ts",
+        "type": "components/helpers"
+      }
+    ]
+  },
+  {
+    "name": "dialog",
+    "title": "Dialog",
+    "description": "A centered modal dialog with size variants, animated entry/exit, close button, and accessible keyboard navigation.",
+    "files": [
+      {
+        "path": "src/components/dialog.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/icon.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/helpers/headless-button.tsx",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/utils/compose-refs.ts",
+        "type": "utils"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      },
+      {
+        "path": "src/utils/use-render-props.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "drawer",
+    "title": "Drawer",
+    "description": "A slide-out drawer built on vaul with left/right/top/bottom positioning, drag-to-dismiss, size variants, actions slot, and close button.",
+    "files": [
+      {
+        "path": "src/components/drawer.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/icon.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/helpers/headless-button.tsx",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/utils/compose-refs.ts",
+        "type": "utils"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      },
+      {
+        "path": "src/utils/use-render-props.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "alert-dialog",
+    "title": "Alert Dialog",
+    "description": "An alert modal with 5 variants (info/positive/warning/negative/notice), icon display, animated entry/exit, cancel button, and accessible keyboard navigation.",
+    "files": [
+      {
+        "path": "src/components/alert-dialog.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/button-group.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/button.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/icon.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/spinner.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/helpers/button-context.ts",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/components/helpers/get-button-classes.ts",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/components/helpers/headless-button.tsx",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/utils/compose-refs.ts",
+        "type": "utils"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      },
+      {
+        "path": "src/utils/use-prevent-default.ts",
+        "type": "utils"
+      },
+      {
+        "path": "src/utils/use-render-props.ts",
+        "type": "utils"
+      },
+      {
+        "path": "src/utils/use-spin-delay.ts",
+        "type": "utils"
+      },
+      {
+        "path": "src/utils/use-stable-accessor.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "menu",
+    "title": "Menu",
+    "description": "A dropdown menu with keyboard navigation, groups, link items, separator support, and accessible ARIA attributes.",
+    "files": [
+      {
+        "path": "src/components/menu.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/helpers/animated-popover.tsx",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "tabs",
+    "title": "Tabs",
+    "description": "A tab group with animated underline indicator, color variants (blue/forest/sand/dune), keyboard navigation, and accessible ARIA attributes.",
+    "files": [
+      {
+        "path": "src/components/tabs.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      },
+      {
+        "path": "src/utils/use-tab-indicator.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "link-tabs",
+    "title": "Link Tabs",
+    "description": "Router-based tab navigation with animated underline indicator, color variants (blue/forest/sand/dune), and accessible ARIA attributes.",
+    "files": [
+      {
+        "path": "src/components/link-tabs.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      },
+      {
+        "path": "src/utils/use-tab-indicator.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "stepper",
+    "title": "Stepper",
+    "description": "A step indicator with horizontal/vertical orientation, error/completed states, connecting lines, and accessible progress semantics.",
+    "files": [
+      {
+        "path": "src/components/stepper.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/icon.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "avatar",
+    "title": "Avatar",
+    "description": "A user profile image with initials fallback, shape variants (circle/rounded/square), and error handling for broken image sources.",
+    "files": [
+      {
+        "path": "src/components/avatar.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "chip",
+    "title": "Chip",
+    "description": "An inline badge with optional remove button, color variants, size options, light/dark color modes, and a clickable ChipButton variant.",
+    "files": [
+      {
+        "path": "src/components/chip.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/icon.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "enum-chip",
+    "title": "Enum Chip",
+    "description": "A colored chip for enum values with automatic color assignment based on option index or string hash.",
+    "files": [
+      {
+        "path": "src/components/enum-chip.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/chip.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/icon.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/utils/colors.ts",
+        "type": "utils"
+      },
+      {
+        "path": "src/utils/enum-colors.ts",
+        "type": "utils"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "img",
+    "title": "Img",
+    "description": "An image element with object-fit variants (cover, contain, fill, none, scale-down) and shape variants (rounded, rectangle, circle).",
+    "files": [
+      {
+        "path": "src/components/img.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "labeled-value",
+    "title": "Labeled Value",
+    "description": "A read-only display component with smart type detection for strings, numbers, booleans, dates, times, durations, and ranges, with configurable label orientation and alignment.",
+    "files": [
+      {
+        "path": "src/components/labeled-value.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "inline-alert",
+    "title": "Inline Alert",
+    "description": "An inline notification with 5 variants (info/positive/warning/negative/notice), default icons per variant, optional title, description, and actions slot.",
+    "files": [
+      {
+        "path": "src/components/inline-alert.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/icon.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "pdf",
+    "title": "Pdf",
+    "description": "A PDF viewer with canvas-based rendering via pdfjs-dist, pagination controls with page navigation, and responsive width handling.",
+    "files": [
+      {
+        "path": "src/components/pdf.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/icon.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      },
+      {
+        "path": "src/utils/use-pagination.ts",
+        "type": "utils"
+      },
+      {
+        "path": "src/components/helpers/pdf-dist.client.ts",
+        "type": "components/helpers"
+      }
+    ]
+  },
+  {
+    "name": "container",
+    "title": "Container",
+    "description": "A layout wrapper with padding, border, and elevation variants. Includes ContainerSection with label/actions header, and a plain Section component.",
+    "files": [
+      {
+        "path": "src/components/container.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "disclosure",
+    "title": "Disclosure",
+    "description": "A collapsible section with size variants, animated expand/collapse, chevron indicator, and accordion group support via React Aria.",
+    "files": [
+      {
+        "path": "src/components/disclosure.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/container.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/icon.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "use-pagination",
+    "title": "usePagination",
+    "description": "Hook that generates pagination page arrays with ellipsis, prev/next logic, and selected-page tracking for paginated UIs.",
+    "files": [
+      {
+        "path": "src/utils/use-pagination.ts",
+        "type": "utils"
+      }
+    ]
+  },
+  {
+    "name": "form",
+    "title": "Form",
+    "description": "A React Router form wrapper with client-side and server-side validation, hidden inputs, controlled state management, and validation error helpers.",
+    "files": [
+      {
+        "path": "src/components/form.tsx",
+        "type": "components"
+      }
+    ]
+  },
+  {
+    "name": "toast",
+    "title": "Toast",
+    "description": "A toast notification system with 5 variants (info/positive/warning/negative/notice), auto-dismiss timeout, close button, and slide-in animation. Includes ToastRegion (render once at app root) and showToast function.",
+    "files": [
+      {
+        "path": "src/components/toast.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/icon.tsx",
+        "type": "components"
+      },
+      {
+        "path": "src/components/helpers/headless-button.tsx",
+        "type": "components/helpers"
+      },
+      {
+        "path": "src/utils/compose-refs.ts",
+        "type": "utils"
+      },
+      {
+        "path": "src/utils/tw.ts",
+        "type": "utils"
+      },
+      {
+        "path": "src/utils/use-render-props.ts",
+        "type": "utils"
+      }
+    ]
+  }
+]