@alexgorbatchev/shadcn 0.0.19 → 0.0.20

package/llms/components/assistant-ui/elements/states-settings/EmptyStateSuggestion.md

@@ -0,0 +1,66 @@
+# EmptyStateSuggestion
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/states-settings/EmptyStateSuggestion
+Source: src/components/stories/assistant-ui/elements/states-settings/EmptyStateSuggestion.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/states-settings/EmptyStateSuggestion.stories.tsx)
+
+## Public imports
+
+```tsx
+import { EmptyStateSuggestion, EmptyStateSuggestions } from "@alexgorbatchev/shadcn/assistant-ui";
+```
+
+## Default component
+
+```tsx
+EmptyStateSuggestion
+```
+
+## Default args
+
+```tsx
+{ children: "Review files", onClick: fn() }
+```
+
+## Default render
+
+```tsx
+(args) => (<EmptyStateSuggestions>
+      <EmptyStateSuggestion {...args}/>
+    </EmptyStateSuggestions>)
+```
+
+## 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
+{}
+```
+
+### LightTheme
+
+```tsx
+{
+    globals: { theme: "light" }
+}
+```
+
+### DarkTheme
+
+```tsx
+{
+    globals: { theme: "dark" }
+}
+```
+
+### ReducedMotion
+
+```tsx
+{
+    args: { index: 3 }
+}
+```

package/llms/components/assistant-ui/elements/states-settings/EmptyStateSuggestions.md

@@ -0,0 +1,61 @@
+# EmptyStateSuggestions
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/states-settings/EmptyStateSuggestions
+Source: src/components/stories/assistant-ui/elements/states-settings/EmptyStateSuggestions.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/states-settings/EmptyStateSuggestions.stories.tsx)
+
+## Public imports
+
+```tsx
+import { EmptyStateSuggestions, EmptyStateSuggestion } from "@alexgorbatchev/shadcn/assistant-ui";
+```
+
+## Default component
+
+```tsx
+EmptyStateSuggestions
+```
+
+## Default args
+
+```tsx
+{
+    children: (<>
+        <EmptyStateSuggestion>Review files</EmptyStateSuggestion>
+        <EmptyStateSuggestion index={1}>Explain changes</EmptyStateSuggestion>
+      </>),
+}
+```
+
+## Default render
+
+```tsx
+(args) => <EmptyStateSuggestions {...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
+{}
+```
+
+### LightTheme
+
+```tsx
+{
+    globals: { theme: "light" }
+}
+```
+
+### DarkTheme
+
+```tsx
+{
+    globals: { theme: "dark" }
+}
+```

package/llms/components/assistant-ui/elements/states-settings/ErrorState.md

@@ -0,0 +1,47 @@
+# ErrorState
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/states-settings/ErrorState
+Source: src/components/stories/assistant-ui/elements/states-settings/ErrorState.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/states-settings/ErrorState.stories.tsx)
+
+## Public imports
+
+```tsx
+import { ErrorState } from "@alexgorbatchev/shadcn/assistant-ui";
+```
+
+## Default component
+
+```tsx
+ErrorState
+```
+
+## Default args
+
+```tsx
+{
+    title: "Request failed",
+    detail: "The connection closed before the response arrived.",
+    retrying: false,
+    onRetry: 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.
+
+### Failed
+
+```tsx
+{}
+```
+
+### Retrying
+
+```tsx
+{
+    args: { retrying: true }
+}
+```

package/llms/components/assistant-ui/elements/states-settings/EveAskQuestion.md

@@ -0,0 +1,166 @@
+# EveAskQuestion
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/states-settings/EveAskQuestion
+Source: src/components/stories/assistant-ui/elements/states-settings/EveAskQuestion.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/states-settings/EveAskQuestion.stories.tsx)
+
+## Public imports
+
+```tsx
+import { EveAskQuestion } from "@alexgorbatchev/shadcn/assistant-ui";
+```
+
+## Default component
+
+```tsx
+EveAskQuestion
+```
+
+## Default args
+
+```tsx
+{
+    type: "tool-call",
+    toolCallId: "question-1",
+    toolName: "ask_question",
+    args: { question: "Which environment?" },
+    argsText: "{}",
+    status: { type: "complete" },
+    addResult: fn(),
+    resume: fn(),
+    respondToApproval: fn(async () => { }),
+    result: { status: "answered", answer: "Staging" },
+}
+```
+
+## Default render
+
+```tsx
+(args) => (<NativeRuntimeFixture>
+      <EveAskQuestion {...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.
+
+### Answered
+
+```tsx
+{}
+```
+
+### Skipped
+
+```tsx
+{
+    args: { result: { interrupted: true } }
+}
+```
+
+### Unavailable
+
+```tsx
+{
+    args: { result: { status: "unavailable" } }
+}
+```
+
+### Error
+
+```tsx
+{
+    args: { result: { error: "Connection lost" }, isError: true }
+}
+```
+
+### UnknownResult
+
+```tsx
+{
+    args: { result: { reason: "Custom response" } }
+}
+```
+
+### Pending
+
+```tsx
+{
+    args: { result: undefined, status: { type: "running" } }
+}
+```
+
+### Approval
+
+```tsx
+{
+    args: {
+        result: undefined,
+        status: { type: "requires-action", reason: "tool-calls" },
+        approval: {
+            id: "approval-1",
+            prompt: "Which environment?",
+            display: "select",
+            options: [{ id: "staging", label: "Staging", kind: "allow-once" }],
+        },
+    }
+}
+```
+
+### AnsweredReceipt
+
+```tsx
+{
+    args: { approval: { id: "answered-question", approved: true } }
+}
+```
+
+### NativeReceiptText
+
+```tsx
+{
+    args: { approval: { id: "native-answer", approved: true, text: "User supplied answer" } }
+}
+```
+
+### DeniedErrorReceipt
+
+```tsx
+{
+    args: { approval: { id: "denied-question", approved: false }, isError: true, result: { error: "Permission denied" } }
+}
+```
+
+### ExecutionErrorAfterApproval
+
+```tsx
+{
+    args: { approval: { id: "failed-question", approved: true }, isError: true, result: { error: "Connection lost" } }
+}
+```
+
+### UnsettledResult
+
+```tsx
+{
+    args: { approval: { id: "pending-native-receipt", prompt: "Native prompt" } }
+}
+```
+
+### Cancelled
+
+```tsx
+{
+    args: { result: undefined, approval: { id: "cancelled-question", resolution: "cancelled" } }
+}
+```
+
+### NoPrompt
+
+```tsx
+{
+    args: { args: {} }
+}
+```

package/llms/components/assistant-ui/elements/states-settings/FeedbackDialog.md

@@ -0,0 +1,85 @@
+# FeedbackDialog
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/states-settings/FeedbackDialog
+Source: src/components/stories/assistant-ui/elements/states-settings/FeedbackDialog.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/states-settings/FeedbackDialog.stories.tsx)
+
+## Public imports
+
+```tsx
+import { FeedbackDialog } from "@alexgorbatchev/shadcn/assistant-ui";
+```
+
+## Supporting imports
+
+```tsx
+import { useState } from "react";
+```
+
+## Default component
+
+```tsx
+FeedbackDialog
+```
+
+## Default args
+
+```tsx
+{
+    reasons: ["Incorrect", "Incomplete", "Unclear"],
+    selected: [],
+    note: "",
+    sent: false,
+    onToggleReason: fn(),
+    onNoteChange: fn(),
+    onSubmit: fn(),
+}
+```
+
+## Default render
+
+```tsx
+function Interactive(args) {
+    const [selected, setSelected] = useState([...args.selected]);
+    const [note, setNote] = useState(args.note);
+    const [sent, setSent] = useState(args.sent);
+    return (<FeedbackDialog {...args} selected={selected} note={note} sent={sent} onToggleReason={(reason) => {
+            args.onToggleReason?.(reason);
+            setSelected((current) => current.includes(reason) ? current.filter((value) => value !== reason) : [...current, reason]);
+        }} onNoteChange={(value) => {
+            args.onNoteChange?.(value);
+            setNote(value);
+        }} onSubmit={() => {
+            args.onSubmit?.();
+            setSent(true);
+        }}/>);
+}
+```
+
+## 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.
+
+### SelectAndSend
+
+```tsx
+{}
+```
+
+### ReadOnly
+
+```tsx
+{
+    args: { selected: ["Incorrect"], onToggleReason: undefined, onNoteChange: undefined, onSubmit: undefined },
+    render: (args) => <FeedbackDialog {...args}/>
+}
+```
+
+### Sent
+
+```tsx
+{
+    args: { sent: true }
+}
+```

package/llms/components/assistant-ui/elements/states-settings/Onboarding.md

@@ -0,0 +1,84 @@
+# Onboarding
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/states-settings/Onboarding
+Source: src/components/stories/assistant-ui/elements/states-settings/Onboarding.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/states-settings/Onboarding.stories.tsx)
+
+## Public imports
+
+```tsx
+import { Onboarding } from "@alexgorbatchev/shadcn/assistant-ui";
+```
+
+## Default component
+
+```tsx
+Onboarding
+```
+
+## Default render
+
+```tsx
+(args) => <Onboarding {...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: [{ title: "Connect a workspace", body: "Choose a folder to begin.", example: "devhost run" }],
+        index: 0,
+        onNext: fn(),
+        onSkip: fn(),
+    }
+}
+```
+
+### FirstStep
+
+```tsx
+{
+    args: {
+        ...Default.args,
+        steps: [
+            { title: "Connect a workspace", body: "Choose a folder to begin.", example: "devhost run" },
+            { title: "Review results", body: "Inspect the output.", example: "devhost status" },
+        ],
+        index: 0,
+    }
+}
+```
+
+### LightTheme
+
+```tsx
+{
+    args: {
+        steps: [{ title: "Connect a workspace", body: "Choose a folder to begin.", example: "devhost run" }],
+        index: 0,
+        onNext: fn(),
+        onSkip: fn(),
+    },
+    globals: { theme: "light" }
+}
+```
+
+### DarkTheme
+
+```tsx
+{
+    args: {
+        steps: [{ title: "Connect a workspace", body: "Choose a folder to begin.", example: "devhost run" }],
+        index: 0,
+        onNext: fn(),
+        onSkip: fn(),
+    },
+    globals: { theme: "dark" }
+}
+```

package/llms/components/assistant-ui/elements/states-settings/OptionList.md

@@ -0,0 +1,74 @@
+# OptionList
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/states-settings/OptionList
+Source: src/components/stories/assistant-ui/elements/states-settings/OptionList.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/states-settings/OptionList.stories.tsx)
+
+## Public imports
+
+```tsx
+import { OptionList } from "@alexgorbatchev/shadcn/assistant-ui";
+```
+
+## Default component
+
+```tsx
+OptionList
+```
+
+## Default args
+
+```tsx
+{
+    "aria-label": "Layout choice",
+    options: [
+        { id: "compact", label: "Compact", description: "Keep the page visible" },
+        { id: "wide", label: "Wide" },
+        { id: "disabled", label: "Unavailable", disabled: true },
+    ],
+    onConfirm: 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.
+
+### Single
+
+```tsx
+{}
+```
+
+### Multiple
+
+```tsx
+{
+    args: { selectionMode: "multiple", minSelections: 1, maxSelections: 1 }
+}
+```
+
+### FailedSubmission
+
+```tsx
+{
+    args: { onConfirm: fn(() => Promise.reject(new Error("Harness disconnected"))) }
+}
+```
+
+### ReadOnly
+
+```tsx
+{
+    args: { onConfirm: undefined }
+}
+```
+
+### EmptyReceipt
+
+```tsx
+{
+    args: { choice: [] }
+}
+```

package/llms/components/assistant-ui/elements/states-settings/OptionText.md

@@ -0,0 +1,38 @@
+# OptionText
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/states-settings/OptionText
+Source: src/components/stories/assistant-ui/elements/states-settings/OptionText.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/states-settings/OptionText.stories.tsx)
+
+## Public imports
+
+```tsx
+import { OptionText } from "@alexgorbatchev/shadcn/assistant-ui";
+```
+
+## Default component
+
+```tsx
+OptionText
+```
+
+## 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.
+
+### Label
+
+```tsx
+{
+    args: { option: { id: "compact", label: "Compact" } }
+}
+```
+
+### WithDescription
+
+```tsx
+{
+    args: { option: { id: "compact", label: "Compact", description: "Keep the page visible" }, isPadded: true }
+}
+```

package/llms/components/assistant-ui/elements/states-settings/QuestionFlow.md

@@ -0,0 +1,85 @@
+# QuestionFlow
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/states-settings/QuestionFlow
+Source: src/components/stories/assistant-ui/elements/states-settings/QuestionFlow.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/states-settings/QuestionFlow.stories.tsx)
+
+## Public imports
+
+```tsx
+import { QuestionFlow } from "@alexgorbatchev/shadcn/assistant-ui";
+```
+
+## Default component
+
+```tsx
+QuestionFlow
+```
+
+## Default args
+
+```tsx
+{
+    steps: [
+        {
+            id: "harness",
+            question: "Choose a harness",
+            options: [
+                { id: "codex", label: "Codex" },
+                { id: "claude", label: "Claude" },
+            ],
+        },
+        {
+            id: "context",
+            question: "Choose context",
+            selectionMode: "multiple",
+            options: [
+                { id: "page", label: "Page" },
+                { id: "selection", label: "Selection" },
+            ],
+        },
+    ],
+    onComplete: 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.
+
+### Complete
+
+```tsx
+{}
+```
+
+### Back
+
+```tsx
+{}
+```
+
+### FailedSubmission
+
+```tsx
+{
+    args: { onComplete: fn(() => Promise.reject(new Error("Session unavailable"))) }
+}
+```
+
+### ReadOnly
+
+```tsx
+{
+    args: { onComplete: undefined }
+}
+```
+
+### Receipt
+
+```tsx
+{
+    args: { choice: { harness: ["claude"], context: ["page", "selection"] } }
+}
+```