@alexgorbatchev/shadcn 0.0.19 → 0.0.20

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

@@ -0,0 +1,87 @@
+# AgentStatus
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/native/agents-tasks/AgentStatus
+Source: src/components/stories/assistant-ui/native/agents-tasks/AgentStatus.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/native/agents-tasks/AgentStatus.stories.tsx)
+
+## Public imports
+
+```tsx
+import { AgentStatus } from "@alexgorbatchev/shadcn/assistant-ui/native";
+```
+
+## Default component
+
+```tsx
+AgentStatus
+```
+
+## Default render
+
+```tsx
+() => (<NativeRuntimeFixture initialMessages={[
+        {
+            role: "assistant",
+            status: { type: "running" },
+            content: [
+                {
+                    type: "tool-call",
+                    toolCallId: "review",
+                    toolName: "delegate",
+                    args: { description: "Review the page" },
+                    argsText: '{"description":"Review the page"}',
+                    messages: [],
+                },
+            ],
+        },
+    ]}>
+      <AgentStatus />
+    </NativeRuntimeFixture>)
+```
+
+## 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
+{}
+```
+
+### Finished
+
+```tsx
+{
+    render: () => (<NativeRuntimeFixture initialMessages={[
+            {
+                role: "assistant",
+                status: { type: "complete", reason: "stop" },
+                content: [
+                    {
+                        type: "tool-call",
+                        toolCallId: "review",
+                        toolName: "delegate",
+                        args: {},
+                        argsText: "{}",
+                        result: "Done",
+                        messages: [],
+                    },
+                ],
+            },
+        ]}>
+      <AgentStatus />
+    </NativeRuntimeFixture>)
+}
+```
+
+### NoTasks
+
+```tsx
+{
+    render: () => (<NativeRuntimeFixture>
+      <AgentStatus />
+    </NativeRuntimeFixture>)
+}
+```

package/llms/components/assistant-ui/native/agents-tasks/TaskCard.md

@@ -0,0 +1,111 @@
+# TaskCard
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/native/agents-tasks/TaskCard
+Source: src/components/stories/assistant-ui/native/agents-tasks/TaskCard.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/native/agents-tasks/TaskCard.stories.tsx)
+
+## Public imports
+
+```tsx
+import { TaskCard } from "@alexgorbatchev/shadcn/assistant-ui/native";
+```
+
+## Default component
+
+```tsx
+TaskCard
+```
+
+## Default render
+
+```tsx
+() => <NativeTaskFixture />
+```
+
+## 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.
+
+### Completed
+
+```tsx
+{}
+```
+
+### Failed
+
+```tsx
+{
+    render: () => <NativeTaskFixture state="failed"/>
+}
+```
+
+### Cancelled
+
+```tsx
+{
+    render: () => <NativeTaskFixture state="cancelled"/>
+}
+```
+
+### Waiting
+
+```tsx
+{
+    render: () => <NativeTaskFixture state="waiting"/>
+}
+```
+
+### CompactDark
+
+```tsx
+{
+    globals: { theme: "dark", density: "compact" }
+}
+```
+
+### ComfortableLight
+
+```tsx
+{
+    globals: { theme: "light", density: "comfortable" }
+}
+```
+
+### TextResultAndTiming
+
+```tsx
+{
+    render: () => (<TaskPartFixture part={{ result: "Review complete", timing: { startedAt: 1000, completedAt: 3500 } }}/>)
+}
+```
+
+### ErrorWithoutResult
+
+```tsx
+{
+    render: () => (<TaskPartFixture part={{ status: { type: "incomplete", reason: "error", error: "Review unavailable" } }}/>)
+}
+```
+
+### ApprovalRequest
+
+```tsx
+{
+    args: {},
+    render: () => (<TaskPartFixture part={{
+            status: { type: "requires-action", reason: "tool-calls" },
+            approval: { id: "task-review", prompt: "Review this change?" },
+            respondToApproval: fn(),
+        }}/>)
+}
+```
+
+### NestedTools
+
+```tsx
+{
+    render: () => <TaskPartFixture part={{ messages: fixture_nestedTaskMessages }}/>
+}
+```

package/llms/components/assistant-ui/native/agents-tasks/TaskGroup.md

@@ -0,0 +1,82 @@
+# TaskGroup
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/native/agents-tasks/TaskGroup
+Source: src/components/stories/assistant-ui/native/agents-tasks/TaskGroup.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/native/agents-tasks/TaskGroup.stories.tsx)
+
+## Public imports
+
+```tsx
+import { TaskGroup } from "@alexgorbatchev/shadcn/assistant-ui/native";
+```
+
+## Default component
+
+```tsx
+TaskGroup
+```
+
+## Default render
+
+```tsx
+() => <NativeTaskFixture group/>
+```
+
+## 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.
+
+### Paginated
+
+```tsx
+{}
+```
+
+### CompactDark
+
+```tsx
+{
+    globals: { theme: "dark", density: "compact" }
+}
+```
+
+### ComfortableLight
+
+```tsx
+{
+    globals: { theme: "light", density: "comfortable" }
+}
+```
+
+### Running
+
+```tsx
+{
+    render: () => <NativeTaskFixture group state="running" count={2}/>
+}
+```
+
+### Waiting
+
+```tsx
+{
+    render: () => <NativeTaskFixture group state="waiting" count={2}/>
+}
+```
+
+### Failed
+
+```tsx
+{
+    render: () => <NativeTaskFixture group state="failed" count={2}/>
+}
+```
+
+### SingleTask
+
+```tsx
+{
+    render: () => <NativeTaskFixture group count={1}/>
+}
+```

package/llms/components/assistant-ui/native/agents-tasks/TaskTray.md

@@ -0,0 +1,66 @@
+# TaskTray
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/native/agents-tasks/TaskTray
+Source: src/components/stories/assistant-ui/native/agents-tasks/TaskTray.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/native/agents-tasks/TaskTray.stories.tsx)
+
+## Public imports
+
+```tsx
+import { TaskTray } from "@alexgorbatchev/shadcn/assistant-ui/native";
+```
+
+## Default component
+
+```tsx
+TaskTray
+```
+
+## Default render
+
+```tsx
+() => <TaskTrayFixture />
+```
+
+## 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.
+
+### PaginationAndReopen
+
+```tsx
+{}
+```
+
+### Waiting
+
+```tsx
+{
+    render: () => <TaskTrayFixture state="waiting" count={1}/>
+}
+```
+
+### Failed
+
+```tsx
+{
+    render: () => <TaskTrayFixture state="failed" count={1}/>
+}
+```
+
+### MultipleRunning
+
+```tsx
+{
+    render: () => <TaskTrayFixture state="running" count={2}/>
+}
+```
+
+### Empty
+
+```tsx
+{
+    render: () => <TaskTrayFixture count={0}/>
+}
+```

package/llms/components/assistant-ui/native/code-diffs/SyntaxHighlighter.md

@@ -0,0 +1,48 @@
+# SyntaxHighlighter
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/native/code-diffs/SyntaxHighlighter
+Source: src/components/stories/assistant-ui/native/code-diffs/SyntaxHighlighter.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/native/code-diffs/SyntaxHighlighter.stories.tsx)
+
+## Public imports
+
+```tsx
+import { SyntaxHighlighter } from "@alexgorbatchev/shadcn/assistant-ui/native";
+```
+
+## Default component
+
+```tsx
+SyntaxHighlighter
+```
+
+## Default args
+
+```tsx
+{ code: "const ready = true;", language: "typescript" }
+```
+
+## Default render
+
+```tsx
+(args) => (<NativeMarkdownFixture text={`\`\`\`${args.language}\n${args.code}\n\`\`\``} components={{ SyntaxHighlighter }}/>)
+```
+
+## 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.
+
+### SettledCode
+
+```tsx
+{}
+```
+
+### UnknownLanguage
+
+```tsx
+{
+    args: { language: "unregistered-language", code: "plain content" }
+}
+```

package/llms/components/assistant-ui/native/composer/AttachmentPreview.md

@@ -0,0 +1,58 @@
+# AttachmentPreview
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/native/composer/AttachmentPreview
+Source: src/components/stories/assistant-ui/native/composer/AttachmentPreview.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/native/composer/AttachmentPreview.stories.tsx)
+
+## Public imports
+
+```tsx
+import { UserMessageAttachments } from "@alexgorbatchev/shadcn/assistant-ui/native";
+```
+
+## Default component
+
+```tsx
+UserMessageAttachments
+```
+
+## Default render
+
+```tsx
+() => <MessageAttachmentFixture />
+```
+
+## 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.
+
+### ImagePreview
+
+```tsx
+{}
+```
+
+### Document
+
+```tsx
+{
+    render: () => <MessageAttachmentFixture isImage={false}/>
+}
+```
+
+### ComposerRemove
+
+```tsx
+{
+    render: () => <ComposerAttachmentFixture />
+}
+```
+
+### UploadError
+
+```tsx
+{
+    render: () => <ComposerAttachmentFixture hasError/>
+}
+```

package/llms/components/assistant-ui/native/composer/ComposerTriggerPopover.md

@@ -0,0 +1,42 @@
+# ComposerTriggerPopover
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/native/composer/ComposerTriggerPopover
+Source: src/components/stories/assistant-ui/native/composer/ComposerTriggerPopover.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/native/composer/ComposerTriggerPopover.stories.tsx)
+
+## Supporting imports
+
+```tsx
+import { defaultDirectiveFormatter } from "@assistant-ui/react";
+```
+
+## Default component
+
+```tsx
+ComposerTriggerPopoverFixture
+```
+
+## Default args
+
+```tsx
+{ mode: "directive", onSelect: 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.
+
+### InsertDirective
+
+```tsx
+{}
+```
+
+### ExecuteAction
+
+```tsx
+{
+    args: { mode: "action" }
+}
+```

package/llms/components/assistant-ui/native/composer/FollowupSuggestionsRow.md

@@ -0,0 +1,36 @@
+# FollowupSuggestionsRow
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/native/composer/FollowupSuggestionsRow
+Source: src/components/stories/assistant-ui/native/composer/FollowupSuggestionsRow.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/native/composer/FollowupSuggestionsRow.stories.tsx)
+
+## Public imports
+
+```tsx
+import { ThreadFollowupSuggestions, Thread } from "@alexgorbatchev/shadcn/assistant-ui/native";
+```
+
+## Default component
+
+```tsx
+ThreadFollowupSuggestions
+```
+
+## Default render
+
+```tsx
+() => (<NativeRuntimeFixture options={{ adapters: { suggestion: fixture_suggestionAdapter } }}>
+      <Thread />
+    </NativeRuntimeFixture>)
+```
+
+## 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.
+
+### SendSuggestion
+
+```tsx
+{}
+```

package/llms/components/assistant-ui/native/context/ContextDisplay.md

@@ -0,0 +1,42 @@
+# ContextDisplay
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/native/context/ContextDisplay
+Source: src/components/stories/assistant-ui/native/context/ContextDisplay.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/native/context/ContextDisplay.stories.tsx)
+
+## Public imports
+
+```tsx
+import { ContextDisplay } from "@alexgorbatchev/shadcn/assistant-ui/native";
+import { ContextDisplayTrigger, ContextDisplayContent } from "@alexgorbatchev/shadcn/assistant-ui";
+```
+
+## Default component
+
+```tsx
+ContextDisplay
+```
+
+## Default args
+
+```tsx
+{ modelContextWindow: 10000 }
+```
+
+## Default render
+
+```tsx
+(args) => (<NativeRuntimeFixture initialMessages={[
+        { role: "assistant", content: "Complete", metadata: { custom: { usage: { totalTokens: 4500 } } } },
+    ]}>
+      <ContextDisplay {...args}>
+        <ContextDisplayTrigger aria-label="Context usage">Usage</ContextDisplayTrigger>
+        <ContextDisplayContent />
+      </ContextDisplay>
+    </NativeRuntimeFixture>)
+```
+
+## 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.

package/llms/components/assistant-ui/native/context/ContextDisplayBar.md

@@ -0,0 +1,52 @@
+# ContextDisplayBar
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/native/context/ContextDisplayBar
+Source: src/components/stories/assistant-ui/native/context/ContextDisplayBar.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/native/context/ContextDisplayBar.stories.tsx)
+
+## Public imports
+
+```tsx
+import { ContextDisplayBar } from "@alexgorbatchev/shadcn/assistant-ui/native";
+```
+
+## Default component
+
+```tsx
+ContextDisplayBar
+```
+
+## Default args
+
+```tsx
+{ modelContextWindow: 10000 }
+```
+
+## Default render
+
+```tsx
+(args) => (<NativeRuntimeFixture initialMessages={[
+        { role: "assistant", content: "Complete", metadata: { custom: { usage: { totalTokens: 7500 } } } },
+    ]}>
+      <ContextDisplayBar {...args}/>
+    </NativeRuntimeFixture>)
+```
+
+## 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.
+
+### RuntimeUsage
+
+```tsx
+{}
+```
+
+### ExplicitUsage
+
+```tsx
+{
+    args: { usage: { totalTokens: 2000 } }
+}
+```

package/llms/components/assistant-ui/native/context/ContextDisplayRing.md

@@ -0,0 +1,52 @@
+# ContextDisplayRing
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/native/context/ContextDisplayRing
+Source: src/components/stories/assistant-ui/native/context/ContextDisplayRing.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/native/context/ContextDisplayRing.stories.tsx)
+
+## Public imports
+
+```tsx
+import { ContextDisplayRing } from "@alexgorbatchev/shadcn/assistant-ui/native";
+```
+
+## Default component
+
+```tsx
+ContextDisplayRing
+```
+
+## Default args
+
+```tsx
+{ modelContextWindow: 10000 }
+```
+
+## Default render
+
+```tsx
+(args) => (<NativeRuntimeFixture initialMessages={[
+        { role: "assistant", content: "Complete", metadata: { custom: { usage: { totalTokens: 7500 } } } },
+    ]}>
+      <ContextDisplayRing {...args}/>
+    </NativeRuntimeFixture>)
+```
+
+## 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.
+
+### RuntimeUsage
+
+```tsx
+{}
+```
+
+### ExplicitUsage
+
+```tsx
+{
+    args: { usage: { totalTokens: 2000 } }
+}
+```