@alexgorbatchev/shadcn 0.0.19 → 0.0.21

package/llms/components/actions/ToggleGroup.md

@@ -0,0 +1,161 @@
+# ToggleGroup
+
+Story: @alexgorbatchev/shadcn/components/actions/ToggleGroup
+Source: src/components/stories/actions/ToggleGroup.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/actions/ToggleGroup.stories.tsx)
+
+## Public imports
+
+```tsx
+import { ToggleGroup, ToggleGroupItem, DirectionProvider, Field, FieldLabel, FieldDescription } from "@alexgorbatchev/shadcn";
+```
+
+## Supporting imports
+
+```tsx
+import { useState } from "react";
+```
+
+## Default component
+
+```tsx
+ToggleGroup
+```
+
+## Story controls
+
+```tsx
+{
+    variant: { control: "select", options: ["default", "outline"] },
+    orientation: { control: "select", options: ["horizontal", "vertical"] },
+    spacing: { control: "number" },
+}
+```
+
+## Default args
+
+```tsx
+{ "aria-label": "Text formatting", defaultValue: ["bold"], onValueChange: fn() }
+```
+
+## Default render
+
+```tsx
+(args) => (<ToggleGroup {...args}>
+      <ToggleGroupItem value="bold">Bold</ToggleGroupItem>
+      <ToggleGroupItem value="italic">Italic</ToggleGroupItem>
+      <ToggleGroupItem value="underline" disabled>
+        Underline
+      </ToggleGroupItem>
+    </ToggleGroup>)
+```
+
+## 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.
+
+### Single
+
+```tsx
+{}
+```
+
+### Multiple
+
+```tsx
+{
+    args: { multiple: true }
+}
+```
+
+### JoinedOutline
+
+```tsx
+{
+    args: { spacing: 0, variant: "outline", size: "sm" }
+}
+```
+
+### Vertical
+
+```tsx
+{
+    args: { orientation: "vertical", size: "lg" }
+}
+```
+
+### StateCallback
+
+```tsx
+{
+    args: { className: fn(() => ""), style: fn(() => ({ gap: "8px" })) }
+}
+```
+
+### JoinedVertical
+
+```tsx
+{
+    args: { orientation: "vertical", spacing: 0, variant: "outline" }
+}
+```
+
+### Spacing
+
+```tsx
+{
+    args: { spacing: 4, variant: "outline" }
+}
+```
+
+### Disabled
+
+```tsx
+{
+    args: { disabled: true }
+}
+```
+
+### Custom
+
+```tsx
+{
+    render: function Render() {
+        const [weight, setWeight] = useState("normal");
+        return (<Field>
+        <FieldLabel id="font-weight-label">Font weight</FieldLabel>
+        <ToggleGroup aria-labelledby="font-weight-label" value={[weight]} onValueChange={(value) => setWeight(value[0] ?? "normal")} variant="outline" spacing={2} size="lg">
+          <ToggleGroupItem value="light" aria-label="Light" className="flex size-16 flex-col">
+            <span>Aa</span>
+            <span>Light</span>
+          </ToggleGroupItem>
+          <ToggleGroupItem value="normal" aria-label="Normal" className="flex size-16 flex-col">
+            <span>Aa</span>
+            <span>Normal</span>
+          </ToggleGroupItem>
+          <ToggleGroupItem value="bold" aria-label="Bold" className="flex size-16 flex-col">
+            <span>Aa</span>
+            <span>Bold</span>
+          </ToggleGroupItem>
+        </ToggleGroup>
+        <FieldDescription>Selected weight: {weight}</FieldDescription>
+      </Field>);
+    }
+}
+```
+
+### RightToLeft
+
+```tsx
+{
+    args: { spacing: 0, variant: "outline" },
+    render: (args) => (<DirectionProvider direction="rtl">
+      <ToggleGroup {...args} dir="rtl">
+        <ToggleGroupItem value="bold">Bold</ToggleGroupItem>
+        <ToggleGroupItem value="italic">Italic</ToggleGroupItem>
+        <ToggleGroupItem value="underline">Underline</ToggleGroupItem>
+      </ToggleGroup>
+    </DirectionProvider>)
+}
+```

package/llms/components/actions/Toolbar.md

@@ -0,0 +1,89 @@
+# Toolbar
+
+Story: @alexgorbatchev/shadcn/components/actions/Toolbar
+Source: src/components/stories/actions/Toolbar.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/actions/Toolbar.stories.tsx)
+
+## Public imports
+
+```tsx
+import { Toolbar, ToolbarButton, ToolbarGroup, ToolbarInput, ToolbarLink, ToolbarSeparator } from "@alexgorbatchev/shadcn";
+```
+
+## Default component
+
+```tsx
+Toolbar
+```
+
+## Default args
+
+```tsx
+{ "aria-label": "Document actions" }
+```
+
+## Default render
+
+```tsx
+(args) => (<Toolbar {...args}>
+      <ToolbarGroup aria-label="Editing">
+        <ToolbarButton onClick={fn()}>Undo</ToolbarButton>
+        <ToolbarButton>Redo</ToolbarButton>
+      </ToolbarGroup>
+      <ToolbarSeparator />
+      <ToolbarInput aria-label="Document title" defaultValue="Untitled"/>
+      <ToolbarLink href="#toolbar-help">Help</ToolbarLink>
+    </Toolbar>)
+```
+
+## 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
+{}
+```
+
+### Vertical
+
+```tsx
+{
+    args: { orientation: "vertical" }
+}
+```
+
+### NativeStateCallbacks
+
+```tsx
+{
+    render: (args) => (<Toolbar {...args} className={toolbarClasses} style={(state) => ({ opacity: state.orientation === "vertical" ? 0.9 : 1 })}>
+      <ToolbarGroup className={toolbarClasses}>
+        <ToolbarButton className={toolbarClasses} disabled style={(state) => ({ opacity: state.disabled ? 0.5 : 1 })}>
+          Unavailable
+        </ToolbarButton>
+        <ToolbarButton className={toolbarClasses}>Enabled</ToolbarButton>
+      </ToolbarGroup>
+      <ToolbarSeparator className={toolbarClasses}/>
+      <ToolbarInput className={toolbarClasses} aria-label="Title"/>
+      <ToolbarLink className={toolbarClasses} href="#help">
+        Help
+      </ToolbarLink>
+    </Toolbar>)
+}
+```
+
+### DisabledState
+
+```tsx
+{
+    render: (args) => (<Toolbar {...args}>
+      <ToolbarButton disabled onClick={disabledAction}>
+        Unavailable
+      </ToolbarButton>
+      <ToolbarButton>Enabled</ToolbarButton>
+    </Toolbar>)
+}
+```

package/llms/components/assistant-ui/elements/agents-tasks/AgentCard.md

@@ -0,0 +1,60 @@
+# AgentCard
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/agents-tasks/AgentCard
+Source: src/components/stories/assistant-ui/elements/agents-tasks/AgentCard.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/agents-tasks/AgentCard.stories.tsx)
+
+## Public imports
+
+```tsx
+import { AgentCard } from "@alexgorbatchev/shadcn/assistant-ui";
+```
+
+## Default component
+
+```tsx
+AgentCard
+```
+
+## Default args
+
+```tsx
+{
+    name: "Code reviewer",
+    description: "Reviews changes for accessibility.",
+    provider: "Local agent",
+    version: "1.0",
+    model: "Reviewer",
+    endpoint: "/agents/reviewer",
+    skills: [{ name: "Review", description: "Inspect a change" }],
+    connected: false,
+    onConnect: 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.
+
+### Available
+
+```tsx
+{}
+```
+
+### Connected
+
+```tsx
+{
+    args: { connected: true }
+}
+```
+
+### Unavailable
+
+```tsx
+{
+    args: { onConnect: undefined, skills: [] }
+}
+```

package/llms/components/assistant-ui/elements/agents-tasks/AgentHandoff.md

@@ -0,0 +1,78 @@
+# AgentHandoff
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/agents-tasks/AgentHandoff
+Source: src/components/stories/assistant-ui/elements/agents-tasks/AgentHandoff.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/agents-tasks/AgentHandoff.stories.tsx)
+
+## Public imports
+
+```tsx
+import { AgentHandoff } from "@alexgorbatchev/shadcn/assistant-ui";
+```
+
+## Default component
+
+```tsx
+AgentHandoff
+```
+
+## Default args
+
+```tsx
+{
+    from: "Planner",
+    to: "Reviewer",
+    reason: "Review the proposed changes",
+    carried: ["Three packages inspected"],
+    settled: false,
+}
+```
+
+## Default render
+
+```tsx
+(args) => <AgentHandoff {...args}/>
+```
+
+## 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.
+
+### Transferring
+
+```tsx
+{}
+```
+
+### Settled
+
+```tsx
+{
+    args: { settled: true }
+}
+```
+
+### NoCarriedContext
+
+```tsx
+{
+    args: { carried: [] }
+}
+```
+
+### LightTheme
+
+```tsx
+{
+    globals: { theme: "light" }
+}
+```
+
+### DarkTheme
+
+```tsx
+{
+    globals: { theme: "dark" }
+}
+```

package/llms/components/assistant-ui/elements/agents-tasks/AgentPlan.md

@@ -0,0 +1,57 @@
+# AgentPlan
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/agents-tasks/AgentPlan
+Source: src/components/stories/assistant-ui/elements/agents-tasks/AgentPlan.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/agents-tasks/AgentPlan.stories.tsx)
+
+## Public imports
+
+```tsx
+import { AgentPlan } from "@alexgorbatchev/shadcn/assistant-ui";
+```
+
+## Default component
+
+```tsx
+AgentPlan
+```
+
+## Default args
+
+```tsx
+{
+    steps: [
+        { id: "inspect", label: "Inspect", description: "Read the request" },
+        { id: "implement", label: "Implement", description: "Apply the change" },
+        "Verify",
+    ],
+    activeIndex: 1,
+}
+```
+
+## 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.
+
+### InProgress
+
+```tsx
+{}
+```
+
+### Completed
+
+```tsx
+{
+    args: { activeIndex: 100 }
+}
+```
+
+### Empty
+
+```tsx
+{
+    args: { steps: [], activeIndex: 0 }
+}
+```

package/llms/components/assistant-ui/elements/agents-tasks/AgentStatus.md

@@ -0,0 +1,88 @@
+# AgentStatus
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/agents-tasks/AgentStatus
+Source: src/components/stories/assistant-ui/elements/agents-tasks/AgentStatus.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/agents-tasks/AgentStatus.stories.tsx)
+
+## Public imports
+
+```tsx
+import { AgentStatus } from "@alexgorbatchev/shadcn/assistant-ui";
+```
+
+## Default component
+
+```tsx
+AgentStatus
+```
+
+## Default args
+
+```tsx
+{ state: "working", label: "Inspecting source", elapsed: "2.4s" }
+```
+
+## Default render
+
+```tsx
+(args) => <AgentStatus {...args}/>
+```
+
+## 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.
+
+### Working
+
+```tsx
+{}
+```
+
+### Waiting
+
+```tsx
+{
+    args: { state: "waiting" }
+}
+```
+
+### Done
+
+```tsx
+{
+    args: { state: "done" }
+}
+```
+
+### Failed
+
+```tsx
+{
+    args: { state: "failed" }
+}
+```
+
+### NoElapsedTime
+
+```tsx
+{
+    args: { elapsed: undefined }
+}
+```
+
+### LightTheme
+
+```tsx
+{
+    globals: { theme: "light" }
+}
+```
+
+### DarkTheme
+
+```tsx
+{
+    globals: { theme: "dark" }
+}
+```

package/llms/components/assistant-ui/elements/agents-tasks/JobProgress.md

@@ -0,0 +1,84 @@
+# JobProgress
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/agents-tasks/JobProgress
+Source: src/components/stories/assistant-ui/elements/agents-tasks/JobProgress.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/agents-tasks/JobProgress.stories.tsx)
+
+## Public imports
+
+```tsx
+import { JobProgress } from "@alexgorbatchev/shadcn/assistant-ui";
+```
+
+## Default component
+
+```tsx
+JobProgress
+```
+
+## Default args
+
+```tsx
+{
+    title: "Build",
+    stages: [
+        { name: "Read", weight: 1 },
+        { name: "Write", weight: 3, description: "Updating files" },
+    ],
+    stageIndex: 1,
+    stageProgress: 0.5,
+    eta: "30s remaining",
+    onCancel: 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.
+
+### Running
+
+```tsx
+{}
+```
+
+### Success
+
+```tsx
+{
+    args: { outcome: { status: "success", summary: "Build completed" }, elapsedMs: 125000 }
+}
+```
+
+### Partial
+
+```tsx
+{
+    args: { outcome: { status: "partial", summary: "One file skipped" } }
+}
+```
+
+### Failed
+
+```tsx
+{
+    args: { outcome: { status: "failed", summary: "Compiler error" } }
+}
+```
+
+### Cancelled
+
+```tsx
+{
+    args: { outcome: { status: "cancelled" } }
+}
+```
+
+### Finished
+
+```tsx
+{
+    args: { stageIndex: 2 }
+}
+```

package/llms/components/assistant-ui/elements/agents-tasks/RunActivity.md

@@ -0,0 +1,75 @@
+# RunActivity
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/agents-tasks/RunActivity
+Source: src/components/stories/assistant-ui/elements/agents-tasks/RunActivity.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/agents-tasks/RunActivity.stories.tsx)
+
+## Public imports
+
+```tsx
+import { RunActivity } from "@alexgorbatchev/shadcn/assistant-ui";
+```
+
+## Default component
+
+```tsx
+RunActivity
+```
+
+## Default render
+
+```tsx
+(args) => <RunActivity {...args}/>
+```
+
+## 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
+{
+    args: {
+        status: "complete",
+        statusLabel: "Review complete",
+        durationLabel: "2 seconds",
+        entries: [{ id: "one", kind: "tool", label: "Read package manifests", content: "3 packages found" }],
+        open: true,
+        onOpenChange: fn(),
+    }
+}
+```
+
+### LightTheme
+
+```tsx
+{
+    args: {
+        status: "complete",
+        statusLabel: "Review complete",
+        durationLabel: "2 seconds",
+        entries: [{ id: "one", kind: "tool", label: "Read package manifests", content: "3 packages found" }],
+        open: true,
+        onOpenChange: fn(),
+    },
+    globals: { theme: "light" }
+}
+```
+
+### DarkTheme
+
+```tsx
+{
+    args: {
+        status: "complete",
+        statusLabel: "Review complete",
+        durationLabel: "2 seconds",
+        entries: [{ id: "one", kind: "tool", label: "Read package manifests", content: "3 packages found" }],
+        open: true,
+        onOpenChange: fn(),
+    },
+    globals: { theme: "dark" }
+}
+```