@alexgorbatchev/shadcn 0.0.18 → 0.0.20

package/llms/components/assistant-ui/native/sources-research/Sources.md

@@ -0,0 +1,145 @@
+# Sources
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/native/sources-research/Sources
+Source: src/components/stories/assistant-ui/native/sources-research/Sources.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/native/sources-research/Sources.stories.tsx)
+
+## Public imports
+
+```tsx
+import { Source, SourceIcon, Sources } from "@alexgorbatchev/shadcn/assistant-ui/native";
+```
+
+## Default component
+
+```tsx
+Source
+```
+
+## Default args
+
+```tsx
+{ href: "https://example.com/reference", children: "Source reference" }
+```
+
+## 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.
+
+### Outline
+
+```tsx
+{
+    args: { variant: "outline" }
+}
+```
+
+### Secondary
+
+```tsx
+{
+    args: { variant: "secondary" }
+}
+```
+
+### Muted
+
+```tsx
+{
+    args: { variant: "muted" }
+}
+```
+
+### Ghost
+
+```tsx
+{
+    args: { variant: "ghost" }
+}
+```
+
+### Info
+
+```tsx
+{
+    args: { variant: "info" }
+}
+```
+
+### Warning
+
+```tsx
+{
+    args: { variant: "warning" }
+}
+```
+
+### Success
+
+```tsx
+{
+    args: { variant: "success" }
+}
+```
+
+### Destructive
+
+```tsx
+{
+    args: { variant: "destructive" }
+}
+```
+
+### Document
+
+```tsx
+{
+    render: () => (<MessageMetadataFixture messages={[
+            {
+                role: "assistant",
+                content: [
+                    {
+                        type: "source",
+                        sourceType: "document",
+                        id: "manual",
+                        title: "Project manual",
+                        mediaType: "application/pdf",
+                    },
+                ],
+            },
+        ]} components={{ Source: Sources }}/>)
+}
+```
+
+### UnsafeUrl
+
+```tsx
+{
+    render: () => (<MessageMetadataFixture messages={[
+            {
+                role: "assistant",
+                content: [
+                    {
+                        type: "source",
+                        sourceType: "url",
+                        id: "untrusted",
+                        title: "Untrusted reference",
+                        url: "javascript:alert(1)",
+                    },
+                ],
+            },
+        ]} components={{ Source: Sources }}/>)
+}
+```
+
+### IconFallback
+
+```tsx
+{
+    render: () => (<Source href="https://example.com">
+      <SourceIcon url="https://example.com" faviconUrl={() => "data:image/png;base64,invalid"}/>
+      Example reference
+    </Source>)
+}
+```

package/llms/components/assistant-ui/native/text-formatting/DirectiveText.md

@@ -0,0 +1,42 @@
+# DirectiveText
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/native/text-formatting/DirectiveText
+Source: src/components/stories/assistant-ui/native/text-formatting/DirectiveText.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/native/text-formatting/DirectiveText.stories.tsx)
+
+## Public imports
+
+```tsx
+import { DirectiveText } from "@alexgorbatchev/shadcn/assistant-ui/native";
+```
+
+## Default component
+
+```tsx
+DirectiveText
+```
+
+## Default render
+
+```tsx
+() => (<MessageMetadataFixture messages={[{ role: "assistant", content: "Ask :agent[Reviewer]{name=review} about :file[src/main.ts] please." }]} components={{ Text: DirectiveText }}/>)
+```
+
+## 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.
+
+### Mentions
+
+```tsx
+{}
+```
+
+### PlainText
+
+```tsx
+{
+    render: () => (<MessageMetadataFixture messages={[{ role: "assistant", content: "Literal :unknown[ and preserved text" }]} components={{ Text: DirectiveText }}/>)
+}
+```

package/llms/components/assistant-ui/native/tools-approvals/McpConfigDialog.md

@@ -0,0 +1,54 @@
+# McpConfigDialog
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/native/tools-approvals/McpConfigDialog
+Source: src/components/stories/assistant-ui/native/tools-approvals/McpConfigDialog.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/native/tools-approvals/McpConfigDialog.stories.tsx)
+
+## Public imports
+
+```tsx
+import { McpConfigDialog } from "@alexgorbatchev/shadcn/assistant-ui/native";
+```
+
+## Default component
+
+```tsx
+McpConfigDialog
+```
+
+## Default render
+
+```tsx
+(args) => (<NativeRuntimeFixture config={fixture_mcpConfig}>
+      <McpConfigDialog {...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.
+
+### CancelForm
+
+```tsx
+{}
+```
+
+### AuthFields
+
+```tsx
+{}
+```
+
+### Validation
+
+```tsx
+{}
+```
+
+### AddAndRemove
+
+```tsx
+{}
+```

package/llms/components/assistant-ui/native/tools-approvals/ToolFallbackApproval.md

@@ -0,0 +1,352 @@
+# ToolFallbackApproval
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/native/tools-approvals/ToolFallbackApproval
+Source: src/components/stories/assistant-ui/native/tools-approvals/ToolFallbackApproval.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/native/tools-approvals/ToolFallbackApproval.stories.tsx)
+
+## Public imports
+
+```tsx
+import { ToolFallbackApproval } from "@alexgorbatchev/shadcn/assistant-ui/native";
+```
+
+## Default component
+
+```tsx
+ToolFallbackApproval
+```
+
+## Default render
+
+```tsx
+(args) => <ApprovalFixture approval={args.approval ?? { id: "decision", prompt: "Run deployment?" }}/>
+```
+
+## 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.
+
+### AllowDecision
+
+```tsx
+{}
+```
+
+### DenyWithNote
+
+```tsx
+{
+    args: { approval: { id: "deny-note", prompt: "Run deployment?", allowFreeform: true } }
+}
+```
+
+### ConfirmPersistentPermission
+
+```tsx
+{
+    args: {
+        approval: {
+            id: "persistent",
+            prompt: "Allow repository writes?",
+            options: [
+                {
+                    id: "always",
+                    kind: "allow-always",
+                    confirm: { title: "Save repository permission?", description: "Applies to future writes" },
+                    grants: ["repository:write"],
+                },
+                { id: "never", kind: "reject-always" },
+            ],
+        },
+    }
+}
+```
+
+### CustomChoice
+
+```tsx
+{
+    args: {
+        approval: {
+            id: "choice",
+            prompt: "Choose target",
+            display: "select",
+            options: [{ id: "staging", kind: "_target", label: "Staging" }],
+        },
+    }
+}
+```
+
+### TextAnswer
+
+```tsx
+{
+    args: { approval: { id: "text", prompt: "What should change?", display: "text", dismissible: true } }
+}
+```
+
+### DismissQuestion
+
+```tsx
+{
+    args: { approval: { id: "dismiss", prompt: "Choose target", display: "select", dismissible: true } }
+}
+```
+
+### FailedResponseRetry
+
+```tsx
+{
+    render: () => <ApprovalFixture approval={{ id: "retry", prompt: "Run deployment?" }} shouldRejectFirst/>
+}
+```
+
+### MultipleQuestions
+
+```tsx
+{
+    args: {
+        approval: {
+            id: "questions",
+            prompt: "Configure deployment",
+            display: "questions",
+            dismissible: true,
+            questions: [
+                {
+                    id: "targets",
+                    header: "Targets",
+                    prompt: "Select regions",
+                    multiple: true,
+                    allowFreeform: true,
+                    options: [
+                        { id: "eu", label: "Europe", description: "European region" },
+                        { id: "us", label: "America", description: "American region" },
+                    ],
+                },
+                { id: "reason", prompt: "Why deploy?" },
+            ],
+        },
+    }
+}
+```
+
+### SingleQuestionChoice
+
+```tsx
+{
+    args: {
+        approval: {
+            id: "single",
+            display: "questions",
+            questions: [
+                {
+                    id: "target",
+                    prompt: "Target",
+                    options: [
+                        { id: "a", label: "Alpha" },
+                        { id: "b", label: "Beta" },
+                    ],
+                },
+            ],
+        },
+    }
+}
+```
+
+### CancelledReceipt
+
+```tsx
+{
+    args: { approval: { id: "cancelled", prompt: "Run deployment?", resolution: "cancelled" } }
+}
+```
+
+### ExpiredReceipt
+
+```tsx
+{
+    args: { approval: { id: "expired", resolution: "expired" } }
+}
+```
+
+### AutomaticReceipt
+
+```tsx
+{
+    args: {
+        approval: {
+            id: "automatic",
+            approved: true,
+            isAutomatic: true,
+            optionId: "removed-rule",
+            reason: "Trusted repository",
+            text: "Trusted repository",
+        },
+    }
+}
+```
+
+### DeclaredDenial
+
+```tsx
+{
+    args: { approval: { id: "declared-denial", options: [{ id: "never", kind: "reject-always" }] } }
+}
+```
+
+### DefaultDenialWithCustomOption
+
+```tsx
+{
+    args: { approval: { id: "fallback-denial", options: [{ id: "custom-action", kind: "_action" }] } }
+}
+```
+
+### SimpleConfirmation
+
+```tsx
+{
+    args: {
+        approval: {
+            id: "confirmation",
+            options: [{ id: "once", kind: "allow-once", confirm: true, description: "Executes once" }],
+        },
+    }
+}
+```
+
+### DismissQuestionsWithoutSubmittingDraft
+
+```tsx
+{
+    args: {
+        approval: {
+            id: "dismiss-questions",
+            display: "questions",
+            dismissible: true,
+            questions: [{ id: "draft", prompt: "Why deploy?" }],
+        },
+    }
+}
+```
+
+### DismissTextWithoutSubmittingDraft
+
+```tsx
+{
+    args: { approval: { id: "dismiss-text", display: "text", prompt: "Why deploy?", dismissible: true } }
+}
+```
+
+### EmptyQuestionList
+
+```tsx
+{
+    args: { approval: { id: "empty-questions", display: "questions", questions: [] } }
+}
+```
+
+### LegacyAllow
+
+```tsx
+{
+    args: { status: { type: "requires-action", reason: "tool-calls" }, addResult: fn() },
+    render: (args) => <ApprovalSurfaceFixture {...args}/>
+}
+```
+
+### LegacyDeny
+
+```tsx
+{
+    args: { status: { type: "requires-action", reason: "tool-calls" }, addResult: fn() },
+    render: (args) => <ApprovalSurfaceFixture {...args}/>
+}
+```
+
+### ResumeInterrupt
+
+```tsx
+{
+    args: {
+        status: { type: "requires-action", reason: "interrupt" },
+        interrupt: { type: "human", payload: "Confirm" },
+        resume: fn(),
+    },
+    render: (args) => <ApprovalSurfaceFixture {...args}/>
+}
+```
+
+### MissingInterrupt
+
+```tsx
+{
+    args: { status: { type: "requires-action", reason: "interrupt" } },
+    render: (args) => <ApprovalSurfaceFixture {...args}/>
+}
+```
+
+### ReadonlyRequest
+
+```tsx
+{
+    args: {
+        approval: { id: "readonly", prompt: "Awaiting another reviewer" },
+        status: { type: "requires-action", reason: "tool-calls" },
+    },
+    render: (args) => <ReadonlyApprovalFixture {...args}/>
+}
+```
+
+### ReadonlyWithoutPrompt
+
+```tsx
+{
+    args: { ...ReadonlyRequest.args, approval: { id: "readonly-empty" } },
+    render: (args) => <ReadonlyApprovalFixture {...args}/>
+}
+```
+
+### MissingQuestionList
+
+```tsx
+{
+    args: { approval: { id: "missing-list", display: "questions" } }
+}
+```
+
+### BlankTextAnswer
+
+```tsx
+{
+    args: { approval: { id: "blank", display: "text" } }
+}
+```
+
+### HistoricalAnswers
+
+```tsx
+{
+    args: {
+        approval: {
+            id: "history",
+            approved: true,
+            display: "questions",
+            questions: [
+                { id: "choice", prompt: "Target", options: [{ id: "old", label: "Old choice" }] },
+                { id: "unanswered", prompt: "Skipped" },
+            ],
+            answers: { choice: { optionIds: ["deleted-choice"] } },
+        },
+    }
+}
+```
+
+### RequestLifecycle
+
+```tsx
+{
+    render: () => <ApprovalLifecycleFixture />
+}
+```

package/llms/components/assistant-ui/native/tools-approvals/ToolFallbackRoot.md

@@ -0,0 +1,84 @@
+# ToolFallbackRoot
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/native/tools-approvals/ToolFallbackRoot
+Source: src/components/stories/assistant-ui/native/tools-approvals/ToolFallbackRoot.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/native/tools-approvals/ToolFallbackRoot.stories.tsx)
+
+## Public imports
+
+```tsx
+import { ToolFallbackRoot, Thread } from "@alexgorbatchev/shadcn/assistant-ui/native";
+```
+
+## Default component
+
+```tsx
+ToolFallbackRoot
+```
+
+## Default render
+
+```tsx
+() => (<NativeRuntimeFixture initialMessages={fixture_toolCallMessages}>
+      <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.
+
+### InspectToolResult
+
+```tsx
+{}
+```
+
+### Running
+
+```tsx
+{
+    render: () => <ToolFallbackFixture status={{ type: "running" }} argsText="Inspect the workspace" durationMs={500}/>
+}
+```
+
+### Waiting
+
+```tsx
+{
+    render: () => (<ToolFallbackFixture status={{ type: "requires-action", reason: "tool-calls" }} result="Waiting for review" durationMs={1500}/>)
+}
+```
+
+### Cancelled
+
+```tsx
+{
+    render: () => (<ToolFallbackFixture status={{ type: "incomplete", reason: "cancelled", error: "Cancelled by operator" }} durationMs={12000}/>)
+}
+```
+
+### Failed
+
+```tsx
+{
+    render: () => (<ToolFallbackFixture status={{ type: "incomplete", reason: "error", error: new Error("Inspection failed") }} durationMs={61000}/>)
+}
+```
+
+### Queued
+
+```tsx
+{
+    render: () => <ToolFallbackFixture responseDeliveryStatus="queued"/>
+}
+```
+
+### FailedWithoutDetails
+
+```tsx
+{
+    render: () => <ToolFallbackFixture status={{ type: "incomplete", reason: "error", error: null }}/>
+}
+```