banhaten 0.1.3 → 0.3.0

package/registry.json

@@ -10,6 +10,7 @@
       "description": "Banhaten base utilities, direction hook, and generated token stylesheet required by registry components.",
       "author": "Ahmad Galal",
       "dependencies": [
+        "@fontsource/ibm-plex-sans-arabic@^5.2.9",
         "@fontsource/inter@^5.2.8",
         "class-variance-authority@^0.7.1",
         "clsx@^2.1.1",
@@ -26,6 +27,11 @@
           "type": "registry:hook",
           "target": "@hooks/use-direction.ts"
         },
+        {
+          "path": "registry/guidance/USAGE.md",
+          "type": "registry:file",
+          "target": ".banhaten/USAGE.md"
+        },
         {
           "path": "registry/styles/globals.css",
           "type": "registry:style",
@@ -172,7 +178,8 @@
       "description": "Accessible button primitive with semantic variants, size scale, loading composition, and RTL-safe icon behavior.",
       "author": "Ahmad Galal",
       "registryDependencies": [
-        "base"
+        "base",
+        "spinner"
       ],
       "dependencies": [
         "@radix-ui/react-slot@^1.2.3",
@@ -183,11 +190,6 @@
           "path": "registry/components/button.tsx",
           "type": "registry:component",
           "target": "@ui/button.tsx"
-        },
-        {
-          "path": "registry/components/spinner.tsx",
-          "type": "registry:component",
-          "target": "@ui/spinner.tsx"
         }
       ]
     },
@@ -264,7 +266,7 @@
       "name": "button-group",
       "type": "registry:component",
       "title": "Button Group",
-      "description": "Connected Button Group primitive with seven-item default and icon-only layouts, md/sm/xs size scale, reusable surface shadow, dividers, RTL-safe content spacing, native hover/focus/pressed styling, and active/disabled states.",
+      "description": "Connected Button Group and Toggle Group primitives with semantic control density, fixed or content-width items, reusable surface styling, RTL-safe spacing, and accessible pressed states.",
       "author": "Ahmad Galal",
       "registryDependencies": [
         "base"
@@ -281,6 +283,25 @@
         }
       ]
     },
+    {
+      "name": "segmented-control",
+      "type": "registry:component",
+      "title": "Segmented Control",
+      "description": "Content-width single or multiple selection control with semantic density, an optional non-interactive label segment, keyboard navigation, pressed states, and RTL support.",
+      "author": "Ahmad Galal",
+      "registryDependencies": [
+        "base",
+        "button-group"
+      ],
+      "dependencies": [],
+      "files": [
+        {
+          "path": "registry/components/segmented-control.tsx",
+          "type": "registry:component",
+          "target": "@ui/segmented-control.tsx"
+        }
+      ]
+    },
     {
       "name": "toggle",
       "type": "registry:component",
@@ -292,7 +313,8 @@
       ],
       "dependencies": [
         "@radix-ui/react-switch@^1.3.0",
-        "class-variance-authority@^0.7.1"
+        "class-variance-authority@^0.7.1",
+        "lucide-react@^1.17.0"
       ],
       "files": [
         {
@@ -416,17 +438,10 @@
       "description": "Token-built popover primitive with click, focus, and hover-capable triggers, positioned content, optional arrow, alignment and offset controls, close affordance, small to large surfaces, and RTL-safe composition.",
       "author": "Ahmad Galal",
       "registryDependencies": [
-        "base",
-        "badge",
-        "button",
-        "checkbox",
-        "input",
-        "menu",
-        "select",
-        "toggle"
+        "base"
       ],
       "dependencies": [
-        "@radix-ui/react-slot@^1.2.3",
+        "@radix-ui/react-popover@^1.1.19",
         "class-variance-authority@^0.7.1",
         "lucide-react@^1.17.0"
       ],
@@ -518,7 +533,8 @@
       ],
       "dependencies": [
         "@radix-ui/react-checkbox@^1.3.3",
-        "class-variance-authority@^0.7.1"
+        "class-variance-authority@^0.7.1",
+        "lucide-react@^1.17.0"
       ],
       "files": [
         {
@@ -579,7 +595,8 @@
         "base"
       ],
       "dependencies": [
-        "class-variance-authority@^0.7.1"
+        "class-variance-authority@^0.7.1",
+        "lucide-react@^1.17.0"
       ],
       "files": [
         {
@@ -613,15 +630,21 @@
       "name": "pagination",
       "type": "registry:component",
       "title": "Pagination",
-      "description": "Figma-matched pagination primitive with numeric, simple, and summary layouts, soft and ghost styles, exact 32px controls, caption variants, and RTL labels.",
+      "description": "Figma-matched pagination primitive with numeric, simple, and summary layouts, soft and ghost styles, exact 32px controls, caption variants, and explicit localized messages.",
       "author": "Ahmad Galal",
       "registryDependencies": [
         "base"
       ],
       "dependencies": [
-        "class-variance-authority@^0.7.1"
+        "class-variance-authority@^0.7.1",
+        "lucide-react@^1.17.0"
       ],
       "files": [
+        {
+          "path": "registry/components/pagination.css",
+          "type": "registry:style",
+          "target": "@ui/pagination.css"
+        },
         {
           "path": "registry/components/pagination.tsx",
           "type": "registry:component",
@@ -636,7 +659,8 @@
       "description": "Figma Filter Toolbar primitive with eight filter/action styles, search fields, select triggers, icon actions, chips, selected-count badges, desktop/mobile wrapping, and RTL-safe composition.",
       "author": "Ahmad Galal",
       "registryDependencies": [
-        "base"
+        "base",
+        "kbd"
       ],
       "dependencies": [
         "@radix-ui/react-slot@^1.2.3",
@@ -655,14 +679,15 @@
       "name": "social-button",
       "type": "registry:component",
       "title": "Social Button",
-      "description": "Social sign-in button primitive with Figma-matched platform styles, solid and outlined variants, icon-only mode, native focus-visible styling, and RTL labels.",
+      "description": "Social sign-in button primitive with Figma-matched platform styles, solid and outlined variants, icon-only mode, native focus-visible styling, and explicit localized messages.",
       "author": "Ahmad Galal",
       "registryDependencies": [
         "base"
       ],
       "dependencies": [
         "@radix-ui/react-slot@^1.2.3",
-        "class-variance-authority@^0.7.1"
+        "class-variance-authority@^0.7.1",
+        "lucide-react@^1.17.0"
       ],
       "files": [
         {
@@ -676,13 +701,15 @@
       "name": "input",
       "type": "registry:component",
       "title": "Input",
-      "description": "Figma-matched input field with labels, helper and error text, add-ons, shortcuts, tags, dropdown/button/quantity adornments, default and soft styles, md/lg sizes, and RTL states.",
+      "description": "Tokenized input field with semantic control density, labels, helper and error text, explicit icons, shared keyboard shortcuts, add-ons, tags, default and soft styles, and RTL states.",
       "author": "Ahmad Galal",
       "registryDependencies": [
-        "base"
+        "base",
+        "kbd"
       ],
       "dependencies": [
-        "class-variance-authority@^0.7.1"
+        "class-variance-authority@^0.7.1",
+        "lucide-react@^1.17.0"
       ],
       "files": [
         {
@@ -744,7 +771,7 @@
       "name": "kbd",
       "type": "registry:component",
       "title": "Kbd",
-      "description": "Keyboard hint primitive for shortcuts, command rows, and form help text with tokenized border, soft surface, and body-xs typography.",
+      "description": "Keyboard key and platform-aware shortcut primitives for search fields, command rows, and help text with shared tokenized surfaces.",
       "author": "Ahmad Galal",
       "registryDependencies": [
         "base"
@@ -760,6 +787,27 @@
         }
       ]
     },
+    {
+      "name": "item",
+      "type": "registry:component",
+      "title": "Item",
+      "description": "Composable Banhaten list item with media, content, title, description, actions, grouping, separators, three surface variants, three sizes, and RTL-safe logical layout.",
+      "author": "Ahmad Galal",
+      "registryDependencies": [
+        "base"
+      ],
+      "dependencies": [
+        "@radix-ui/react-slot@^1.2.3",
+        "class-variance-authority@^0.7.1"
+      ],
+      "files": [
+        {
+          "path": "registry/components/item.tsx",
+          "type": "registry:component",
+          "target": "@ui/item.tsx"
+        }
+      ]
+    },
     {
       "name": "field",
       "type": "registry:component",
@@ -806,7 +854,7 @@
       "name": "select",
       "type": "registry:component",
       "title": "Select",
-      "description": "Radix Select-backed, Figma-matched select field and menu item primitives with default and soft trigger styles, lg/md sizes, error/filled/disabled states, menu surface, checkbox and check selection, and item media for text, icons, avatars, company, payment, and status dots.",
+      "description": "Radix Select-backed field and menu primitives with semantic control density, default and soft trigger styles, error/filled/disabled states, checkbox and check selection, and rich item media.",
       "author": "Ahmad Galal",
       "registryDependencies": [
         "base"
@@ -965,6 +1013,7 @@
       "registryDependencies": [
         "base",
         "input",
+        "popover",
         "select",
         "tag"
       ],
@@ -983,10 +1032,11 @@
       "name": "date-picker",
       "type": "registry:component",
       "title": "Date Picker",
-      "description": "Figma-matched Calendar, Range Calendar, Date Picker, and Date Range Picker suite with single, month/year, double calendar, preset list, open/closed, time row, range selection, and RTL use cases.",
+      "description": "Calendar, Range Calendar, Date Picker, and Date Range Picker suite with semantic trigger density, explicit calendar affordances, presets, time, range selection, and RTL support.",
       "author": "Ahmad Galal",
       "registryDependencies": [
-        "base"
+        "base",
+        "popover"
       ],
       "dependencies": [
         "class-variance-authority@^0.7.1",
@@ -1078,7 +1128,8 @@
         "base"
       ],
       "dependencies": [
-        "class-variance-authority@^0.7.1"
+        "class-variance-authority@^0.7.1",
+        "lucide-react@^1.17.0"
       ],
       "files": [
         {
@@ -1180,6 +1231,29 @@
         }
       ]
     },
+    {
+      "name": "activity-heatmap",
+      "type": "registry:block",
+      "title": "Activity Heatmap",
+      "description": "Token-only calendar activity heatmap with seven-day columns, five semantic intensity levels, responsive horizontal overflow, cell labels, and RTL support.",
+      "author": "Ahmad Galal",
+      "registryDependencies": [
+        "base"
+      ],
+      "dependencies": [],
+      "files": [
+        {
+          "path": "registry/components/expanded/activityHeatmap.css",
+          "type": "registry:style",
+          "target": "@ui/expanded/activityHeatmap.css"
+        },
+        {
+          "path": "registry/components/expanded/ActivityHeatmap.tsx",
+          "type": "registry:component",
+          "target": "@ui/expanded/ActivityHeatmap.tsx"
+        }
+      ]
+    },
     {
       "name": "alert",
       "type": "registry:component",
@@ -1187,10 +1261,12 @@
       "description": "Contextual feedback primitive with danger, success, warning, info, neutral, compact, expandable, action, close, and RTL variants.",
       "author": "Ahmad Galal",
       "registryDependencies": [
-        "base"
+        "base",
+        "button"
       ],
       "dependencies": [
-        "class-variance-authority@^0.7.1"
+        "class-variance-authority@^0.7.1",
+        "lucide-react@^1.17.0"
       ],
       "files": [
         {
@@ -1211,7 +1287,9 @@
         "button",
         "input"
       ],
-      "dependencies": [],
+      "dependencies": [
+        "lucide-react@^1.17.0"
+      ],
       "files": [
         {
           "path": "registry/components/expanded/banner.css",
@@ -1222,11 +1300,6 @@
           "path": "registry/components/expanded/Banner.tsx",
           "type": "registry:component",
           "target": "@ui/expanded/Banner.tsx"
-        },
-        {
-          "path": "registry/components/expanded/BannerBoard.tsx",
-          "type": "registry:component",
-          "target": "@ui/expanded/BannerBoard.tsx"
         }
       ]
     },
@@ -1234,26 +1307,20 @@
       "name": "catalog-components",
       "type": "registry:block",
       "title": "Catalog Components",
-      "description": "Expanded catalog showcase with breadcrumbs, catalog-only content dividers, catalog tag previews, file upload states, and table previews.",
+      "description": "Expanded catalog showcase with breadcrumbs, catalog-only content dividers, tag previews, file upload states, and table previews.",
       "author": "Ahmad Galal",
       "registryDependencies": [
         "base",
-        "button"
+        "breadcrumbs",
+        "button",
+        "file-upload",
+        "table",
+        "tag"
       ],
       "dependencies": [
         "lucide-react@^1.17.0"
       ],
       "files": [
-        {
-          "path": "registry/components/expanded/breadcrumbs.css",
-          "type": "registry:style",
-          "target": "@ui/expanded/breadcrumbs.css"
-        },
-        {
-          "path": "registry/components/expanded/Breadcrumbs.tsx",
-          "type": "registry:component",
-          "target": "@ui/expanded/Breadcrumbs.tsx"
-        },
         {
           "path": "registry/components/expanded/catalogComponentsShowcase.css",
           "type": "registry:style",
@@ -1273,36 +1340,6 @@
           "path": "registry/components/expanded/CatalogDivider.tsx",
           "type": "registry:component",
           "target": "@ui/expanded/CatalogDivider.tsx"
-        },
-        {
-          "path": "registry/components/expanded/fileUpload.css",
-          "type": "registry:style",
-          "target": "@ui/expanded/fileUpload.css"
-        },
-        {
-          "path": "registry/components/expanded/FileUpload.tsx",
-          "type": "registry:component",
-          "target": "@ui/expanded/FileUpload.tsx"
-        },
-        {
-          "path": "registry/components/expanded/table.css",
-          "type": "registry:style",
-          "target": "@ui/expanded/table.css"
-        },
-        {
-          "path": "registry/components/expanded/Table.tsx",
-          "type": "registry:component",
-          "target": "@ui/expanded/Table.tsx"
-        },
-        {
-          "path": "registry/components/expanded/tag.css",
-          "type": "registry:style",
-          "target": "@ui/expanded/tag.css"
-        },
-        {
-          "path": "registry/components/expanded/CatalogTag.tsx",
-          "type": "registry:component",
-          "target": "@ui/expanded/CatalogTag.tsx"
         }
       ]
     },
@@ -1315,7 +1352,9 @@
       "registryDependencies": [
         "base"
       ],
-      "dependencies": [],
+      "dependencies": [
+        "lucide-react@^1.17.0"
+      ],
       "files": [
         {
           "path": "registry/components/expanded/breadcrumbs.css",
@@ -1363,11 +1402,20 @@
       "author": "Ahmad Galal",
       "registryDependencies": [
         "base",
-        "toolbar",
+        "avatar",
+        "badge",
+        "button",
+        "checkbox",
         "pagination",
-        "spinner"
+        "progress",
+        "spinner",
+        "tag",
+        "toggle",
+        "toolbar"
+      ],
+      "dependencies": [
+        "lucide-react@^1.17.0"
       ],
-      "dependencies": [],
       "files": [
         {
           "path": "registry/components/expanded/table.css",
@@ -1378,32 +1426,11 @@
           "path": "registry/components/expanded/Table.tsx",
           "type": "registry:component",
           "target": "@ui/expanded/Table.tsx"
-        }
-      ]
-    },
-    {
-      "name": "command-bar",
-      "type": "registry:block",
-      "title": "Command Bar",
-      "description": "Expanded command bar composition for default, recent, results, and empty command-palette states across desktop, mobile, LTR, and RTL.",
-      "author": "Ahmad Galal",
-      "registryDependencies": [
-        "base",
-        "button"
-      ],
-      "dependencies": [
-        "lucide-react@^1.17.0"
-      ],
-      "files": [
-        {
-          "path": "registry/components/expanded/commandBar.css",
-          "type": "registry:style",
-          "target": "@ui/expanded/commandBar.css"
         },
         {
-          "path": "registry/components/expanded/CommandBar.tsx",
+          "path": "registry/components/table-elements.tsx",
           "type": "registry:component",
-          "target": "@ui/expanded/CommandBar.tsx"
+          "target": "@ui/table-elements.tsx"
         }
       ]
     },
@@ -1433,34 +1460,6 @@
         }
       ]
     },
-    {
-      "name": "icons",
-      "type": "registry:block",
-      "title": "Icons",
-      "description": "Expanded icon explorer for open-source icon pack review, semantic mapping, shortlist comparison, and Iconify catalog inspection.",
-      "author": "Ahmad Galal",
-      "registryDependencies": [
-        "base"
-      ],
-      "dependencies": [],
-      "files": [
-        {
-          "path": "registry/components/expanded/iconExplorer.css",
-          "type": "registry:style",
-          "target": "@ui/expanded/iconExplorer.css"
-        },
-        {
-          "path": "registry/components/expanded/iconPacks.ts",
-          "type": "registry:component",
-          "target": "@ui/expanded/iconPacks.ts"
-        },
-        {
-          "path": "registry/components/expanded/IconExplorer.tsx",
-          "type": "registry:component",
-          "target": "@ui/expanded/IconExplorer.tsx"
-        }
-      ]
-    },
     {
       "name": "onboarding-step",
       "type": "registry:block",
@@ -1470,7 +1469,9 @@
       "registryDependencies": [
         "base"
       ],
-      "dependencies": [],
+      "dependencies": [
+        "lucide-react@^1.17.0"
+      ],
       "files": [
         {
           "path": "registry/components/expanded/onboardingStepListItem.css",
@@ -1492,9 +1493,13 @@
       "author": "Ahmad Galal",
       "registryDependencies": [
         "base",
+        "breadcrumbs",
+        "button",
         "tabs"
       ],
-      "dependencies": [],
+      "dependencies": [
+        "lucide-react@^1.17.0"
+      ],
       "files": [
         {
           "path": "registry/components/expanded/pageHeader.css",
@@ -1512,12 +1517,15 @@
       "name": "slideout",
       "type": "registry:block",
       "title": "Slideout",
-      "description": "Expanded slideout panel with desktop and mobile breakpoints, header and footer actions, slotted content, and RTL coverage.",
+      "description": "Expanded presentational slideout panel with desktop and mobile breakpoints, header and footer actions, slotted content, and RTL coverage. Use Sheet or Modal when overlay behavior is required.",
       "author": "Ahmad Galal",
       "registryDependencies": [
-        "base"
+        "base",
+        "button"
+      ],
+      "dependencies": [
+        "lucide-react@^1.17.0"
       ],
-      "dependencies": [],
       "files": [
         {
           "path": "registry/components/expanded/slideout.css",
@@ -1541,7 +1549,9 @@
         "base",
         "button"
       ],
-      "dependencies": [],
+      "dependencies": [
+        "lucide-react@^1.17.0"
+      ],
       "files": [
         {
           "path": "registry/components/expanded/steps.css",
@@ -1589,7 +1599,9 @@
       "registryDependencies": [
         "base"
       ],
-      "dependencies": [],
+      "dependencies": [
+        "lucide-react@^1.17.0"
+      ],
       "files": [
         {
           "path": "registry/components/expanded/timeline.css",
@@ -1600,11 +1612,6 @@
           "path": "registry/components/expanded/Timeline.tsx",
           "type": "registry:component",
           "target": "@ui/expanded/Timeline.tsx"
-        },
-        {
-          "path": "registry/components/expanded/TimelineShowcase.tsx",
-          "type": "registry:component",
-          "target": "@ui/expanded/TimelineShowcase.tsx"
         }
       ]
     }

package/schema/config.schema.json

@@ -3,43 +3,46 @@
   "$id": "urn:banhaten:schema:config",
   "title": "Banhaten CLI config",
   "type": "object",
+  "required": ["tailwind", "aliases"],
   "additionalProperties": false,
   "properties": {
     "$schema": {
       "type": "string"
     },
-    "style": {
-      "type": "string",
-      "default": "default"
-    },
-    "tsx": {
-      "type": "boolean",
-      "default": true
-    },
     "tailwind": {
       "type": "object",
+      "required": ["css"],
       "additionalProperties": false,
       "properties": {
         "css": {
           "type": "string",
+          "minLength": 1,
+          "pattern": "^\\S(?:.*\\S)?$",
           "description": "Path to the global CSS file that imports Tailwind and receives Banhaten tokens."
         }
       }
     },
     "aliases": {
       "type": "object",
+      "required": ["ui", "utils", "hooks"],
       "additionalProperties": false,
       "properties": {
         "ui": {
           "type": "string",
+          "minLength": 1,
+          "pattern": "^\\S(?:.*\\S)?$",
           "description": "Import alias where Banhaten UI components are installed."
         },
         "utils": {
           "type": "string",
+          "minLength": 1,
+          "pattern": "^\\S(?:.*\\S)?$",
           "description": "Import alias for the cn utility file."
         },
         "hooks": {
           "type": "string",
+          "minLength": 1,
+          "pattern": "^\\S(?:.*\\S)?$",
           "description": "Import alias for generated hooks."
         }
       }