@alexgorbatchev/shadcn 0.0.20 → 0.0.22

package/llms/components/layout/AppShell.md

@@ -0,0 +1,63 @@
+# AppShell
+
+Story: @alexgorbatchev/shadcn/components/layout/AppShell
+Source: src/components/stories/layout/AppShell.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/layout/AppShell.stories.tsx)
+
+## Public imports
+
+```tsx
+import { AppShell, PageHeader, StatCard } from "@alexgorbatchev/shadcn";
+```
+
+## Default component
+
+```tsx
+AppShell
+```
+
+## Default args
+
+```tsx
+{
+    brand: "Acme",
+    height: 480,
+    header: "Workspace",
+    sidebarFooter: "Your account",
+    footer: "All changes saved",
+    navigation: [
+        { id: "overview", label: "Overview", href: "#overview", active: true },
+        { id: "settings", label: "Settings", href: "#settings" },
+    ],
+    children: (<>
+        <PageHeader title="Overview" description="Your workspace at a glance."/>
+        <StatCard label="Projects" value={24}/>
+        <p>Workspace content.</p>
+      </>),
+}
+```
+
+## Examples
+
+Storybook CSF excerpts. Default args and render apply unless overridden. Local helpers, fixtures, decorators, and providers may be required; these are reference excerpts, not standalone consumer modules. Interaction tests are omitted.
+
+### Default
+
+```tsx
+{}
+```
+
+### Scrolling
+
+```tsx
+{
+    args: {
+        sidebarFooter: undefined,
+        footer: undefined,
+        children: (<>
+        {Array.from({ length: 30 }, (_, i) => (<p key={i}>Project {i + 1}</p>))}
+      </>),
+    }
+}
+```

package/llms/components/layout/BillingUsage.md

@@ -0,0 +1,51 @@
+# BillingUsage
+
+Story: @alexgorbatchev/shadcn/components/layout/BillingUsage
+Source: src/components/stories/layout/BillingUsage.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/layout/BillingUsage.stories.tsx)
+
+## Public imports
+
+```tsx
+import { BillingUsage } from "@alexgorbatchev/shadcn";
+```
+
+## Default component
+
+```tsx
+BillingUsage
+```
+
+## Default args
+
+```tsx
+{
+    plan: "Team",
+    price: "$49",
+    period: "per month",
+    metrics: [
+        { id: "storage", label: "Storage", used: 42, limit: 100, unit: "GB" },
+        { id: "seats", label: "Seats", used: 8, limit: 10 },
+    ],
+    onManage: fn(),
+}
+```
+
+## Examples
+
+Storybook CSF excerpts. Default args and render apply unless overridden. Local helpers, fixtures, decorators, and providers may be required; these are reference excerpts, not standalone consumer modules. Interaction tests are omitted.
+
+### Default
+
+```tsx
+{}
+```
+
+### Pending
+
+```tsx
+{
+    args: { pending: true }
+}
+```

package/llms/components/layout/DashboardLayout.md

@@ -0,0 +1,78 @@
+# DashboardLayout
+
+Story: @alexgorbatchev/shadcn/components/layout/DashboardLayout
+Source: src/components/stories/layout/DashboardLayout.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/layout/DashboardLayout.stories.tsx)
+
+## Public imports
+
+```tsx
+import { DashboardLayout, Card, CardHeader, CardTitle, CardContent, Button, BarList } from "@alexgorbatchev/shadcn";
+import { AnalyticsChart } from "@alexgorbatchev/shadcn/chart";
+```
+
+## Default component
+
+```tsx
+DashboardLayout
+```
+
+## Default args
+
+```tsx
+{
+    title: "Overview",
+    description: "Your workspace at a glance.",
+    actions: <Button onClick={exportReport}>Export report</Button>,
+    stats: [
+        { id: "revenue", label: "Revenue", value: "$24,580", change: "+12%", changeIntent: "positive" },
+        { id: "customers", label: "Customers", value: "1,240", change: "+8%", changeIntent: "positive" },
+        { id: "churn", label: "Churn", value: "2.1%", change: "-0.4%", changeIntent: "positive" },
+        { id: "uptime", label: "Uptime", value: "99.99%" },
+    ],
+    children: (<div className="grid min-w-0 gap-4 lg:grid-cols-2">
+        <Card>
+          <CardHeader>
+            <CardTitle>Revenue</CardTitle>
+          </CardHeader>
+          <CardContent>
+            <AnalyticsChart label="Monthly revenue" data={[
+            { month: "Jan", value: 10 },
+            { month: "Feb", value: 20 },
+        ]} index="month" series={[{ key: "value", label: "Revenue", type: "area" }]}/>
+          </CardContent>
+        </Card>
+        <Card>
+          <CardHeader>
+            <CardTitle>Top channels</CardTitle>
+          </CardHeader>
+          <CardContent>
+            <BarList label="Channels" items={[
+            { id: "direct", label: "Direct", value: 300 },
+            { id: "search", label: "Search", value: 180 },
+        ]}/>
+          </CardContent>
+        </Card>
+      </div>),
+    footer: <p className="text-sm text-muted-foreground">Updated just now</p>,
+}
+```
+
+## Examples
+
+Storybook CSF excerpts. Default args and render apply unless overridden. Local helpers, fixtures, decorators, and providers may be required; these are reference excerpts, not standalone consumer modules. Interaction tests are omitted.
+
+### Default
+
+```tsx
+{}
+```
+
+### EmptyStats
+
+```tsx
+{
+    args: { stats: [], description: undefined, actions: undefined, footer: undefined }
+}
+```

package/llms/components/layout/PageHeader.md

@@ -0,0 +1,49 @@
+# PageHeader
+
+Story: @alexgorbatchev/shadcn/components/layout/PageHeader
+Source: src/components/stories/layout/PageHeader.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/layout/PageHeader.stories.tsx)
+
+## Public imports
+
+```tsx
+import { PageHeader, Button } from "@alexgorbatchev/shadcn";
+```
+
+## Default component
+
+```tsx
+PageHeader
+```
+
+## Default args
+
+```tsx
+{
+    title: "Projects",
+    description: "Manage your team's work.",
+    breadcrumbs: (<nav aria-label="Breadcrumb">
+        <a href="#home">Home</a>
+      </nav>),
+    actions: <Button onClick={action}>New project</Button>,
+}
+```
+
+## Examples
+
+Storybook CSF excerpts. Default args and render apply unless overridden. Local helpers, fixtures, decorators, and providers may be required; these are reference excerpts, not standalone consumer modules. Interaction tests are omitted.
+
+### Default
+
+```tsx
+{}
+```
+
+### TitleOnly
+
+```tsx
+{
+    args: { description: undefined, breadcrumbs: undefined, actions: undefined }
+}
+```

package/llms/components/navigation/AccountMenu.md

@@ -0,0 +1,42 @@
+# AccountMenu
+
+Story: @alexgorbatchev/shadcn/components/navigation/AccountMenu
+Source: src/components/stories/navigation/AccountMenu.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/navigation/AccountMenu.stories.tsx)
+
+## Public imports
+
+```tsx
+import { AccountMenu } from "@alexgorbatchev/shadcn";
+```
+
+## Default component
+
+```tsx
+AccountMenu
+```
+
+## Default args
+
+```tsx
+{ name: "Alex", email: "alex@example.com", onAction: fn() }
+```
+
+## Examples
+
+Storybook CSF excerpts. Default args and render apply unless overridden. Local helpers, fixtures, decorators, and providers may be required; these are reference excerpts, not standalone consumer modules. Interaction tests are omitted.
+
+### Default
+
+```tsx
+{}
+```
+
+### NameOnly
+
+```tsx
+{
+    args: { email: undefined }
+}
+```

package/llms/components/navigation/Tree.md

@@ -0,0 +1,51 @@
+# Tree
+
+Story: @alexgorbatchev/shadcn/components/navigation/Tree
+Source: src/components/stories/navigation/Tree.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/navigation/Tree.stories.tsx)
+
+## Public imports
+
+```tsx
+import { Tree, TreeItem, useTree, syncDataLoaderFeature, hotkeysCoreFeature, selectionFeature } from "@alexgorbatchev/shadcn/tree";
+import { Button, ContextMenu, ContextMenuTrigger, ContextMenuContent, ContextMenuGroup, ContextMenuItem, InlineEdit } from "@alexgorbatchev/shadcn";
+```
+
+## Supporting imports
+
+```tsx
+import { useState } from "react";
+```
+
+## Default render
+
+```tsx
+() => <Example />
+```
+
+## Examples
+
+Storybook CSF excerpts. Default args and render apply unless overridden. Local helpers, fixtures, decorators, and providers may be required; these are reference excerpts, not standalone consumer modules. Interaction tests are omitted.
+
+### Default
+
+```tsx
+{}
+```
+
+### ComposedRows
+
+```tsx
+{
+    render: () => <Example isComposed/>
+}
+```
+
+### EditableRows
+
+```tsx
+{
+    render: () => <EditableExample />
+}
+```

package/llms/components/navigation/WorkspaceSwitcher.md

@@ -0,0 +1,48 @@
+# WorkspaceSwitcher
+
+Story: @alexgorbatchev/shadcn/components/navigation/WorkspaceSwitcher
+Source: src/components/stories/navigation/WorkspaceSwitcher.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/navigation/WorkspaceSwitcher.stories.tsx)
+
+## Public imports
+
+```tsx
+import { WorkspaceSwitcher } from "@alexgorbatchev/shadcn";
+```
+
+## Default component
+
+```tsx
+WorkspaceSwitcher
+```
+
+## Default args
+
+```tsx
+{
+    workspaces: [
+        { value: "personal", label: "Personal" },
+        { value: "team", label: "Team" },
+    ],
+    onValueChange: fn(),
+}
+```
+
+## Examples
+
+Storybook CSF excerpts. Default args and render apply unless overridden. Local helpers, fixtures, decorators, and providers may be required; these are reference excerpts, not standalone consumer modules. Interaction tests are omitted.
+
+### Default
+
+```tsx
+{}
+```
+
+### Disabled
+
+```tsx
+{
+    args: { disabled: true }
+}
+```

package/llms/components/planning/EventCalendar.md

@@ -0,0 +1,67 @@
+# EventCalendar
+
+Story: @alexgorbatchev/shadcn/components/planning/EventCalendar
+Source: src/components/stories/planning/EventCalendar.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/planning/EventCalendar.stories.tsx)
+
+## Public imports
+
+```tsx
+import { EventCalendar } from "@alexgorbatchev/shadcn/event-calendar";
+```
+
+## Default component
+
+```tsx
+EventCalendar
+```
+
+## Default args
+
+```tsx
+{
+    label: "Team calendar",
+    events,
+    defaultDate: new Date(2026, 9, 22),
+    defaultView: "month",
+    views: ["month", "week", "day", "agenda"],
+    onSelectEvent: fn(),
+    onView: fn(),
+    onNavigate: fn(),
+}
+```
+
+## Examples
+
+Storybook CSF excerpts. Default args and render apply unless overridden. Local helpers, fixtures, decorators, and providers may be required; these are reference excerpts, not standalone consumer modules. Interaction tests are omitted.
+
+### Default
+
+```tsx
+{}
+```
+
+### KeyboardSelection
+
+```tsx
+{}
+```
+
+### CustomMessages
+
+```tsx
+{
+    args: {
+        messages: {
+            previous: "Précédent",
+            next: "Suivant",
+            today: "Aujourd’hui",
+            month: "Mois",
+            week: "Semaine",
+            day: "Jour",
+            agenda: "Agenda",
+        },
+    }
+}
+```

package/llms/components/planning/Gantt.md

@@ -0,0 +1,66 @@
+# Gantt
+
+Story: @alexgorbatchev/shadcn/components/planning/Gantt
+Source: src/components/stories/planning/Gantt.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/planning/Gantt.stories.tsx)
+
+## Public imports
+
+```tsx
+import { Gantt, type GanttTask } from "@alexgorbatchev/shadcn/gantt";
+```
+
+## Supporting imports
+
+```tsx
+import { useState } from "react";
+```
+
+## Default render
+
+```tsx
+() => <Example />
+```
+
+## Examples
+
+Storybook CSF excerpts. Default args and render apply unless overridden. Local helpers, fixtures, decorators, and providers may be required; these are reference excerpts, not standalone consumer modules. Interaction tests are omitted.
+
+### Default
+
+```tsx
+{}
+```
+
+### ReadOnly
+
+```tsx
+{
+    render: () => <Example readOnly/>
+}
+```
+
+### Empty
+
+```tsx
+{
+    render: () => (<Gantt label="Empty plan" tasks={[]} startDate={new Date(2026, 9, 20)} days={7} onTaskSelect={select}/>)
+}
+```
+
+### DaylightSaving
+
+```tsx
+{
+    render: () => {
+        const [value, setValue] = useState([
+            { id: "dst", title: "DST task", start: new Date("2026-03-07T17:00:00Z"), end: new Date("2026-03-08T16:00:00Z") },
+        ]);
+        return (<>
+        <Gantt label="DST plan" tasks={value} startDate={new Date("2026-03-06T08:00:00Z")} days={7} timeZone="America/Los_Angeles" onTaskSelect={select} onTaskChange={(task) => setValue([task])}/>
+        <output aria-label="Start instant">{value[0]?.start.toISOString()}</output>
+      </>);
+    }
+}
+```

package/llms/components/planning/Kanban.md

@@ -0,0 +1,50 @@
+# Kanban
+
+Story: @alexgorbatchev/shadcn/components/planning/Kanban
+Source: src/components/stories/planning/Kanban.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/planning/Kanban.stories.tsx)
+
+## Public imports
+
+```tsx
+import { Kanban, type KanbanItem } from "@alexgorbatchev/shadcn";
+```
+
+## Supporting imports
+
+```tsx
+import { useState } from "react";
+```
+
+## Default render
+
+```tsx
+() => <Example />
+```
+
+## Examples
+
+Storybook CSF excerpts. Default args and render apply unless overridden. Local helpers, fixtures, decorators, and providers may be required; these are reference excerpts, not standalone consumer modules. Interaction tests are omitted.
+
+### Default
+
+```tsx
+{}
+```
+
+### Disabled
+
+```tsx
+{
+    render: () => <Example disabled/>
+}
+```
+
+### Restricted
+
+```tsx
+{
+    render: () => <Example restricted/>
+}
+```

package/llms/components/planning/Roadmap.md

@@ -0,0 +1,34 @@
+# Roadmap
+
+Story: @alexgorbatchev/shadcn/components/planning/Roadmap
+Source: src/components/stories/planning/Roadmap.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/planning/Roadmap.stories.tsx)
+
+## Public imports
+
+```tsx
+import { Roadmap, type RoadmapItem } from "@alexgorbatchev/shadcn/gantt";
+```
+
+## Supporting imports
+
+```tsx
+import { useState } from "react";
+```
+
+## Default render
+
+```tsx
+() => <Example />
+```
+
+## Examples
+
+Storybook CSF excerpts. Default args and render apply unless overridden. Local helpers, fixtures, decorators, and providers may be required; these are reference excerpts, not standalone consumer modules. Interaction tests are omitted.
+
+### Default
+
+```tsx
+{}
+```

package/llms/setup.md

@@ -50,20 +50,30 @@ Package preparation and contributor commands are documented in [AGENTS.md](https
 
 Import shared controls and providers from `@alexgorbatchev/shadcn`. Import the following features from their dedicated entry points and install only the peers you use. These features, their hooks, and their types are not exported from the package root.
 
-| Import path suffix  | Components                                              | Install alongside the package                                 |
-| ------------------- | ------------------------------------------------------- | ------------------------------------------------------------- |
-| `/chart`            | Chart components, ChartStyle, useChart, and chart types | `bun add recharts@3.8.0 cssesc@3.0.0 es-toolkit@1.52.0`       |
-| `/calendar`         | Calendar, CalendarDayButton                             | `bun add @daypicker/react@^10.0.2`                            |
-| `/persian-calendar` | PersianCalendar                                         | `bun add @daypicker/persian@^10.0.2 @daypicker/react@^10.0.2` |
-| `/carousel`         | Carousel components, useCarousel, and carousel types    | `bun add embla-carousel-react@^8.6.0`                         |
-| `/command`          | Command components, including CommandDialog             | `bun add cmdk@^1.1.1`                                         |
-| `/resizable`        | Resizable components and SplitView                      | `bun add react-resizable-panels@^4.14.3`                      |
-| `/fonts.css`        | JetBrains Mono font stylesheet                          | `bun add @fontsource-variable/jetbrains-mono@^5.3.0`          |
-| `/sonner`           | Sonner, SonnerToaster, Toaster, toast, useSonner        | No additional install; patched implementation is bundled      |
-| `/input-otp`        | InputOTP components                                     | No additional install; patched implementation is bundled      |
-| `/virtual-table`    | VirtualTable and row measurement props                  | `@tanstack/react-virtual@3.14.13`                             |
-| `/message-scroller` | MessageScroller components, hooks, and types            | No additional install; patched implementation is bundled      |
-| `/questionnaire`    | Questionnaire components and types                      | No additional install; patched implementation is bundled      |
+| Import path suffix  | Components                                               | Install alongside the package                                                                                    |
+| ------------------- | -------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
+| `/chart`            | Chart parts, AnalyticsChart, Sparkline, hooks and types  | `bun add recharts@3.8.0 cssesc@3.0.0 es-toolkit@1.52.0`                                                          |
+| `/calendar`         | Calendar, CalendarDayButton, DatePicker, DateRangePicker | `bun add @daypicker/react@^10.0.2`                                                                               |
+| `/persian-calendar` | PersianCalendar                                          | `bun add @daypicker/persian@^10.0.2 @daypicker/react@^10.0.2`                                                    |
+| `/carousel`         | Carousel components, useCarousel, and carousel types     | `bun add embla-carousel-react@^8.6.0`                                                                            |
+| `/command`          | Command components, including CommandDialog              | `bun add cmdk@^1.1.1`                                                                                            |
+| `/resizable`        | Resizable components and SplitView                       | `bun add react-resizable-panels@^4.14.3`                                                                         |
+| `/fonts.css`        | JetBrains Mono font stylesheet                           | `bun add @fontsource-variable/jetbrains-mono@^5.3.0`                                                             |
+| `/sonner`           | Sonner, SonnerToaster, Toaster, toast, useSonner         | No additional install; patched implementation is bundled                                                         |
+| `/input-otp`        | InputOTP components                                      | No additional install; patched implementation is bundled                                                         |
+| `/virtual-table`    | VirtualTable and row measurement props                   | `@tanstack/react-virtual@3.14.13`                                                                                |
+| `/message-scroller` | MessageScroller components, hooks, and types             | No additional install; patched implementation is bundled                                                         |
+| `/questionnaire`    | Questionnaire components and types                       | No additional install; patched implementation is bundled                                                         |
+| `/data-grid`        | DataGrid and native table helpers                        | `bun add @tanstack/react-table@9.2.8`                                                                            |
+| `/file-upload`      | FileUpload selection and validation                      | `bun add react-dropzone@^20.1.4`                                                                                 |
+| `/color-picker`     | ColorPicker                                              | `bun add react-colorful@^5.8.1`                                                                                  |
+| `/image-crop`       | ImageCrop and native export helpers                      | `bun add react-image-crop@^11.1.2`                                                                               |
+| `/tree`             | Tree, native hooks and features                          | `bun add @headless-tree/core@^1.8.0 @headless-tree/react@^1.8.0`                                                 |
+| `/editor`           | RichTextEditor, native Tiptap hooks and StarterKit       | `bun add @tiptap/core@^3.32.0 @tiptap/react@^3.32.0 @tiptap/pm@^3.32.0 @tiptap/starter-kit@^3.32.0`              |
+| `/event-calendar`   | EventCalendar, EventForm and native calendar APIs        | `bun add react-big-calendar@^1.20.0 date-fns@^4.4.0`; TypeScript: `bun add -d @types/react-big-calendar@^1.16.3` |
+| `/gantt`            | Gantt and Roadmap                                        | `bun add date-fns@^4.4.0 @date-fns/tz@^1.5.0`                                                                    |
+
+Import `@alexgorbatchev/shadcn/event-calendar.css` for EventCalendar, and `react-image-crop/dist/ReactCrop.css` for ImageCrop. The root also provides application shells, dashboard and billing layouts, authentication/settings forms, account/workspace controls, Kanban, facets, tags, number fields, toolbars, meters, stat cards and status displays. See the [component catalog reference](https://github.com/alexgorbatchev/shadcn/blob/main/docs/internal/component-catalog.md) for source groups, native APIs, dependency costs and consumer responsibilities.
 
 For example: