@alexgorbatchev/shadcn 0.0.19 → 0.0.20

package/llms/components/assistant-ui/elements/tools-approvals/ComputerUse.md

@@ -0,0 +1,58 @@
+# ComputerUse
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/tools-approvals/ComputerUse
+Source: src/components/stories/assistant-ui/elements/tools-approvals/ComputerUse.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/tools-approvals/ComputerUse.stories.tsx)
+
+## Public imports
+
+```tsx
+import { ComputerUse } from "@alexgorbatchev/shadcn/assistant-ui";
+```
+
+## Default component
+
+```tsx
+ComputerUse
+```
+
+## Default args
+
+```tsx
+{
+    url: "https://example.com",
+    steps: [
+        { id: "open", action: "Click", target: "Open settings", x: 20, y: 30 },
+        { id: "save", action: "Click", target: "Save settings", x: 70, y: 60 },
+    ],
+    activeIndex: 1,
+    children: <p>Application preview</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.
+
+### ActiveStep
+
+```tsx
+{}
+```
+
+### OutOfBounds
+
+```tsx
+{
+    args: { activeIndex: 100 }
+}
+```
+
+### Empty
+
+```tsx
+{
+    args: { steps: [] }
+}
+```

package/llms/components/assistant-ui/elements/tools-approvals/GuardrailNotice.md

@@ -0,0 +1,78 @@
+# GuardrailNotice
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/tools-approvals/GuardrailNotice
+Source: src/components/stories/assistant-ui/elements/tools-approvals/GuardrailNotice.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/tools-approvals/GuardrailNotice.stories.tsx)
+
+## Public imports
+
+```tsx
+import { GuardrailNotice } from "@alexgorbatchev/shadcn/assistant-ui";
+```
+
+## Default component
+
+```tsx
+GuardrailNotice
+```
+
+## Default args
+
+```tsx
+{
+    title: "Protected branch",
+    explanation: "Changes require a review before merging.",
+    policy: "Review policy",
+    alternatives: ["Create a review branch"],
+    onPick: fn(),
+}
+```
+
+## Default render
+
+```tsx
+(args) => <GuardrailNotice {...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.
+
+### Alternatives
+
+```tsx
+{}
+```
+
+### ReadOnly
+
+```tsx
+{
+    args: { onPick: undefined }
+}
+```
+
+### NoAlternatives
+
+```tsx
+{
+    args: { alternatives: [] }
+}
+```
+
+### LightTheme
+
+```tsx
+{
+    globals: { theme: "light" }
+}
+```
+
+### DarkTheme
+
+```tsx
+{
+    globals: { theme: "dark" }
+}
+```

package/llms/components/assistant-ui/elements/tools-approvals/McpServerPanel.md

@@ -0,0 +1,73 @@
+# McpServerPanel
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/tools-approvals/McpServerPanel
+Source: src/components/stories/assistant-ui/elements/tools-approvals/McpServerPanel.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/tools-approvals/McpServerPanel.stories.tsx)
+
+## Public imports
+
+```tsx
+import { McpServerPanel } from "@alexgorbatchev/shadcn/assistant-ui";
+```
+
+## Supporting imports
+
+```tsx
+import { useState } from "react";
+```
+
+## Default component
+
+```tsx
+McpServerPanel
+```
+
+## Default args
+
+```tsx
+{
+    servers: [
+        { id: "files", name: "Files", transport: "stdio", status: "connected", tools: ["read_file", "write_file"] },
+        { id: "remote", name: "Remote", transport: "http", status: "needs-auth", tools: ["search"] },
+        { id: "pending", name: "Pending", transport: "http", status: "connecting", tools: [] },
+        { id: "failed", name: "Unavailable", transport: "http", status: "failed", tools: [] },
+    ],
+    onToggle: fn(),
+    onAuthorize: 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.
+
+### BrowseAndAuthorize
+
+```tsx
+{
+    render: function Render(args) {
+        const [expandedId, setExpandedId] = useState(args.expandedId);
+        return (<McpServerPanel {...args} expandedId={expandedId} onToggle={(id) => {
+                args.onToggle?.(id);
+                setExpandedId((current) => (current === id ? undefined : id));
+            }}/>);
+    }
+}
+```
+
+### ReadOnly
+
+```tsx
+{
+    args: { expandedId: "files", onToggle: undefined, onAuthorize: undefined }
+}
+```
+
+### Empty
+
+```tsx
+{
+    args: { servers: [] }
+}
+```

package/llms/components/assistant-ui/elements/tools-approvals/PermissionGrant.md

@@ -0,0 +1,104 @@
+# PermissionGrant
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/tools-approvals/PermissionGrant
+Source: src/components/stories/assistant-ui/elements/tools-approvals/PermissionGrant.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/tools-approvals/PermissionGrant.stories.tsx)
+
+## Public imports
+
+```tsx
+import { PermissionGrant } from "@alexgorbatchev/shadcn/assistant-ui";
+```
+
+## Default component
+
+```tsx
+PermissionGrant
+```
+
+## Default render
+
+```tsx
+(args) => <PermissionGrant {...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: {
+        capability: "Read project files",
+        requester: "Research agent",
+        reach: ["Project source files"],
+        scope: "pending",
+        onGrant: fn(),
+    }
+}
+```
+
+### Session
+
+```tsx
+{
+    args: { ...Default.args, scope: "session" }
+}
+```
+
+### Always
+
+```tsx
+{
+    args: { ...Default.args, scope: "always" }
+}
+```
+
+### Denied
+
+```tsx
+{
+    args: { ...Default.args, scope: "denied" }
+}
+```
+
+### PendingReadOnly
+
+```tsx
+{
+    args: { ...Default.args, onGrant: undefined }
+}
+```
+
+### LightTheme
+
+```tsx
+{
+    args: {
+        capability: "Read project files",
+        requester: "Research agent",
+        reach: ["Project source files"],
+        scope: "pending",
+        onGrant: fn(),
+    },
+    globals: { theme: "light" }
+}
+```
+
+### DarkTheme
+
+```tsx
+{
+    args: {
+        capability: "Read project files",
+        requester: "Research agent",
+        reach: ["Project source files"],
+        scope: "pending",
+        onGrant: fn(),
+    },
+    globals: { theme: "dark" }
+}
+```

package/llms/components/assistant-ui/elements/tools-approvals/ToolCall.md

@@ -0,0 +1,81 @@
+# ToolCall
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/tools-approvals/ToolCall
+Source: src/components/stories/assistant-ui/elements/tools-approvals/ToolCall.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/tools-approvals/ToolCall.stories.tsx)
+
+## Public imports
+
+```tsx
+import { ToolCall } from "@alexgorbatchev/shadcn/assistant-ui";
+```
+
+## Default component
+
+```tsx
+ToolCall
+```
+
+## Default render
+
+```tsx
+(args) => <ToolCall {...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: {
+        label: "Read source",
+        activeLabel: "Reading source",
+        query: "package.json",
+        request: "Read the package manifest",
+        result: "3 dependencies",
+        running: false,
+        open: true,
+        onOpenChange: fn(),
+    }
+}
+```
+
+### LightTheme
+
+```tsx
+{
+    args: {
+        label: "Read source",
+        activeLabel: "Reading source",
+        query: "package.json",
+        request: "Read the package manifest",
+        result: "3 dependencies",
+        running: false,
+        open: true,
+        onOpenChange: fn(),
+    },
+    globals: { theme: "light" }
+}
+```
+
+### DarkTheme
+
+```tsx
+{
+    args: {
+        label: "Read source",
+        activeLabel: "Reading source",
+        query: "package.json",
+        request: "Read the package manifest",
+        result: "3 dependencies",
+        running: false,
+        open: true,
+        onOpenChange: fn(),
+    },
+    globals: { theme: "dark" }
+}
+```

package/llms/components/assistant-ui/elements/tools-approvals/ToolError.md

@@ -0,0 +1,89 @@
+# ToolError
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/tools-approvals/ToolError
+Source: src/components/stories/assistant-ui/elements/tools-approvals/ToolError.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/tools-approvals/ToolError.stories.tsx)
+
+## Public imports
+
+```tsx
+import { ToolError } from "@alexgorbatchev/shadcn/assistant-ui";
+```
+
+## Default component
+
+```tsx
+ToolError
+```
+
+## Default render
+
+```tsx
+(args) => <ToolError {...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: {
+        name: "read_file",
+        target: "package.json",
+        message: "Access denied",
+        attempt: 1,
+        maxAttempts: 3,
+        retrying: false,
+        onRetry: fn(),
+        onSkip: fn(),
+    }
+}
+```
+
+### Retrying
+
+```tsx
+{
+    args: { ...Default.args, retrying: true }
+}
+```
+
+### LightTheme
+
+```tsx
+{
+    args: {
+        name: "read_file",
+        target: "package.json",
+        message: "Access denied",
+        attempt: 1,
+        maxAttempts: 3,
+        retrying: false,
+        onRetry: fn(),
+        onSkip: fn(),
+    },
+    globals: { theme: "light" }
+}
+```
+
+### DarkTheme
+
+```tsx
+{
+    args: {
+        name: "read_file",
+        target: "package.json",
+        message: "Access denied",
+        attempt: 1,
+        maxAttempts: 3,
+        retrying: false,
+        onRetry: fn(),
+        onSkip: fn(),
+    },
+    globals: { theme: "dark" }
+}
+```

package/llms/components/assistant-ui/elements/tools-approvals/ToolGroup.md

@@ -0,0 +1,101 @@
+# ToolGroup
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/tools-approvals/ToolGroup
+Source: src/components/stories/assistant-ui/elements/tools-approvals/ToolGroup.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/tools-approvals/ToolGroup.stories.tsx)
+
+## Public imports
+
+```tsx
+import { ToolGroup } from "@alexgorbatchev/shadcn/assistant-ui";
+```
+
+## Default component
+
+```tsx
+ToolGroup
+```
+
+## Default render
+
+```tsx
+(args) => <ToolGroup {...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: {
+        label: "Workspace inspection",
+        tools: [{ id: "one", name: "read_file", target: "package.json", state: "done", durationMs: 100 }],
+        open: false,
+        onOpenChange: fn(),
+    }
+}
+```
+
+### LightTheme
+
+```tsx
+{
+    args: {
+        label: "Workspace inspection",
+        tools: [{ id: "one", name: "read_file", target: "package.json", state: "done", durationMs: 100 }],
+        open: false,
+        onOpenChange: fn(),
+    },
+    globals: { theme: "light" }
+}
+```
+
+### DarkTheme
+
+```tsx
+{
+    args: {
+        label: "Workspace inspection",
+        tools: [{ id: "one", name: "read_file", target: "package.json", state: "done", durationMs: 100 }],
+        open: false,
+        onOpenChange: fn(),
+    },
+    globals: { theme: "dark" }
+}
+```
+
+### RunningTools
+
+```tsx
+{
+    args: {
+        label: "Workspace inspection",
+        open: true,
+        tools: [
+            { id: "read", name: "read_file", target: "package.json", state: "done", durationMs: 100 },
+            { id: "test", name: "test", target: "Browser checks", state: "running" },
+            { id: "lint", name: "lint", target: "Source checks", state: "failed" },
+        ],
+    }
+}
+```
+
+### FailedTools
+
+```tsx
+{
+    args: { ...RunningTools.args, tools: [{ id: "lint", name: "lint", target: "Source checks", state: "failed" }] }
+}
+```
+
+### CompletedTools
+
+```tsx
+{
+    args: { ...RunningTools.args, tools: [{ id: "read", name: "read_file", target: "package.json", state: "done" }] }
+}
+```

package/llms/components/assistant-ui/elements/tools-approvals/ToolTimeline.md

@@ -0,0 +1,87 @@
+# ToolTimeline
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/tools-approvals/ToolTimeline
+Source: src/components/stories/assistant-ui/elements/tools-approvals/ToolTimeline.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/tools-approvals/ToolTimeline.stories.tsx)
+
+## Public imports
+
+```tsx
+import { ToolTimeline } from "@alexgorbatchev/shadcn/assistant-ui";
+```
+
+## Supporting imports
+
+```tsx
+import { FileTextIcon } from "lucide-react";
+```
+
+## Default component
+
+```tsx
+ToolTimeline
+```
+
+## Default render
+
+```tsx
+(args) => <ToolTimeline {...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: {
+        steps: [{ id: "one", verb: "Read", chip: "package.json", icon: FileTextIcon }],
+        visibleSteps: 1,
+        streaming: false,
+        open: true,
+        onOpenChange: fn(),
+        restingLabel: "Source reviewed",
+        activeLabel: "Reviewing source",
+        stats: [{ file: "workspace.ts", added: 2, removed: 1 }],
+    }
+}
+```
+
+### LightTheme
+
+```tsx
+{
+    args: {
+        steps: [{ id: "one", verb: "Read", chip: "package.json", icon: FileTextIcon }],
+        visibleSteps: 1,
+        streaming: false,
+        open: true,
+        onOpenChange: fn(),
+        restingLabel: "Source reviewed",
+        activeLabel: "Reviewing source",
+        stats: [{ file: "workspace.ts", added: 2, removed: 1 }],
+    },
+    globals: { theme: "light" }
+}
+```
+
+### DarkTheme
+
+```tsx
+{
+    args: {
+        steps: [{ id: "one", verb: "Read", chip: "package.json", icon: FileTextIcon }],
+        visibleSteps: 1,
+        streaming: false,
+        open: true,
+        onOpenChange: fn(),
+        restingLabel: "Source reviewed",
+        activeLabel: "Reviewing source",
+        stats: [{ file: "workspace.ts", added: 2, removed: 1 }],
+    },
+    globals: { theme: "dark" }
+}
+```