@alexgorbatchev/shadcn 0.0.19 → 0.0.20

package/llms/components/assistant-ui/elements/context/ContextDisplayValue.md

@@ -0,0 +1,58 @@
+# ContextDisplayValue
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/context/ContextDisplayValue
+Source: src/components/stories/assistant-ui/elements/context/ContextDisplayValue.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/context/ContextDisplayValue.stories.tsx)
+
+## Public imports
+
+```tsx
+import { ContextDisplayValue, ContextDisplayRoot } from "@alexgorbatchev/shadcn/assistant-ui";
+```
+
+## Default component
+
+```tsx
+ContextDisplayValue
+```
+
+## Default args
+
+```tsx
+{ variant: "text" }
+```
+
+## Default render
+
+```tsx
+(args) => (<ContextDisplayRoot modelContextWindow={10000} usage={{ totalTokens: 7500 }}>
+      <ContextDisplayValue {...args}/>
+    </ContextDisplayRoot>)
+```
+
+## 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.
+
+### Text
+
+```tsx
+{}
+```
+
+### Ring
+
+```tsx
+{
+    args: { variant: "ring" }
+}
+```
+
+### Bar
+
+```tsx
+{
+    args: { variant: "bar" }
+}
+```

package/llms/components/assistant-ui/elements/context/MemoryChips.md

@@ -0,0 +1,57 @@
+# MemoryChips
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/context/MemoryChips
+Source: src/components/stories/assistant-ui/elements/context/MemoryChips.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/context/MemoryChips.stories.tsx)
+
+## Public imports
+
+```tsx
+import { MemoryChips } from "@alexgorbatchev/shadcn/assistant-ui";
+```
+
+## Default component
+
+```tsx
+MemoryChips
+```
+
+## Default args
+
+```tsx
+{
+    chips: [
+        { id: "language", text: "Prefers TypeScript", change: "added" },
+        { id: "theme", text: "Uses the dark theme", change: "updated" },
+        { id: "editor", text: "Uses Neovim", change: "existing" },
+    ],
+    onForget: 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.
+
+### Changes
+
+```tsx
+{}
+```
+
+### Existing
+
+```tsx
+{
+    args: { chips: [{ id: "editor", text: "Uses Neovim", change: "existing" }], onForget: undefined }
+}
+```
+
+### Empty
+
+```tsx
+{
+    args: { chips: [] }
+}
+```

package/llms/components/assistant-ui/elements/conversations/BackgroundInbox.md

@@ -0,0 +1,57 @@
+# BackgroundInbox
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/conversations/BackgroundInbox
+Source: src/components/stories/assistant-ui/elements/conversations/BackgroundInbox.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/conversations/BackgroundInbox.stories.tsx)
+
+## Public imports
+
+```tsx
+import { BackgroundInbox } from "@alexgorbatchev/shadcn/assistant-ui";
+```
+
+## Default component
+
+```tsx
+BackgroundInbox
+```
+
+## Default args
+
+```tsx
+{
+    runs: [
+        { id: "ready", title: "Review", state: "ready", elapsed: "12s", summary: "Three findings" },
+        { id: "running", title: "Build", state: "running", elapsed: "5s" },
+        { id: "failed", title: "Deploy", state: "failed", elapsed: "2s", summary: "Connection refused" },
+    ],
+    onCollect: 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.
+
+### Collect
+
+```tsx
+{}
+```
+
+### ReadOnly
+
+```tsx
+{
+    args: { onCollect: undefined }
+}
+```
+
+### Empty
+
+```tsx
+{
+    args: { runs: [] }
+}
+```

package/llms/components/assistant-ui/elements/conversations/CanvasSplit.md

@@ -0,0 +1,68 @@
+# CanvasSplit
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/conversations/CanvasSplit
+Source: src/components/stories/assistant-ui/elements/conversations/CanvasSplit.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/conversations/CanvasSplit.stories.tsx)
+
+## Public imports
+
+```tsx
+import { CanvasSplit, CanvasSplitBody, CanvasSplitDocument, CanvasSplitHeader, CanvasSplitLine, CanvasSplitMessage, CanvasSplitThread } from "@alexgorbatchev/shadcn/assistant-ui";
+```
+
+## Default component
+
+```tsx
+CanvasSplitHeader
+```
+
+## Default args
+
+```tsx
+{ title: "Service guide", version: 2, saved: true, onCopy: fn(), onClose: fn() }
+```
+
+## Default render
+
+```tsx
+(args) => (<CanvasSplit>
+      <CanvasSplitThread>
+        <CanvasSplitMessage speaker="user">Write a guide</CanvasSplitMessage>
+        <CanvasSplitMessage speaker="assistant">Here is the draft.</CanvasSplitMessage>
+      </CanvasSplitThread>
+      <CanvasSplitDocument>
+        <CanvasSplitHeader {...args}/>
+        <CanvasSplitBody writing={!args.saved}>
+          <CanvasSplitLine heading>Service operations</CanvasSplitLine>
+          <CanvasSplitLine>Inspect logs before restarting.</CanvasSplitLine>
+        </CanvasSplitBody>
+      </CanvasSplitDocument>
+    </CanvasSplit>)
+```
+
+## 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.
+
+### Actions
+
+```tsx
+{}
+```
+
+### Editing
+
+```tsx
+{
+    args: { saved: false }
+}
+```
+
+### ReadOnly
+
+```tsx
+{
+    args: { onCopy: undefined, onClose: undefined }
+}
+```

package/llms/components/assistant-ui/elements/conversations/ChatPanel.md

@@ -0,0 +1,82 @@
+# ChatPanel
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/conversations/ChatPanel
+Source: src/components/stories/assistant-ui/elements/conversations/ChatPanel.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/conversations/ChatPanel.stories.tsx)
+
+## Public imports
+
+```tsx
+import { ChatPanel, ChatPanelAssistantMessage, ChatPanelComposer, ChatPanelMessages, ChatPanelTyping, ChatPanelUserMessage } from "@alexgorbatchev/shadcn/assistant-ui";
+```
+
+## Supporting imports
+
+```tsx
+import { useState } from "react";
+```
+
+## Default component
+
+```tsx
+ChatPanelComposer
+```
+
+## Default args
+
+```tsx
+{ placeholder: "Ask about the service", onSend: fn() }
+```
+
+## Default render
+
+```tsx
+function Conversation(args) {
+    const [value, setValue] = useState("");
+    const [submitted, setSubmitted] = useState("");
+    return (<ChatPanel>
+        <ChatPanelMessages>
+          <ChatPanelUserMessage>Inspect the service</ChatPanelUserMessage>
+          <ChatPanelAssistantMessage>The service is healthy.</ChatPanelAssistantMessage>
+          {submitted ? <ChatPanelUserMessage>{submitted}</ChatPanelUserMessage> : null}
+        </ChatPanelMessages>
+        <ChatPanelComposer {...args} value={value} onValueChange={setValue} onSend={() => {
+            args.onSend?.();
+            setSubmitted(value);
+            setValue("");
+        }}/>
+      </ChatPanel>);
+}
+```
+
+## 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.
+
+### Submit
+
+```tsx
+{}
+```
+
+### Typing
+
+```tsx
+{
+    render: () => (<ChatPanel>
+      <ChatPanelMessages>
+        <ChatPanelUserMessage>Hello</ChatPanelUserMessage>
+        <ChatPanelTyping />
+      </ChatPanelMessages>
+    </ChatPanel>)
+}
+```
+
+### Unavailable
+
+```tsx
+{
+    render: (args) => <ChatPanelComposer {...args} value="Ready to send" onSend={undefined}/>
+}
+```

package/llms/components/assistant-ui/elements/conversations/CheckpointHistory.md

@@ -0,0 +1,57 @@
+# CheckpointHistory
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/conversations/CheckpointHistory
+Source: src/components/stories/assistant-ui/elements/conversations/CheckpointHistory.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/conversations/CheckpointHistory.stories.tsx)
+
+## Public imports
+
+```tsx
+import { CheckpointHistory } from "@alexgorbatchev/shadcn/assistant-ui";
+```
+
+## Default component
+
+```tsx
+CheckpointHistory
+```
+
+## Default args
+
+```tsx
+{
+    checkpoints: [
+        { id: "initial", label: "Before edit", at: "10:00", files: 2 },
+        { id: "edited", label: "After edit", at: "10:05", files: 3 },
+    ],
+    currentId: "edited",
+    onRestore: 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.
+
+### Restore
+
+```tsx
+{}
+```
+
+### ReadOnly
+
+```tsx
+{
+    args: { onRestore: undefined }
+}
+```
+
+### Empty
+
+```tsx
+{
+    args: { checkpoints: [] }
+}
+```

package/llms/components/assistant-ui/elements/conversations/ConversationMap.md

@@ -0,0 +1,59 @@
+# ConversationMap
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/conversations/ConversationMap
+Source: src/components/stories/assistant-ui/elements/conversations/ConversationMap.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/conversations/ConversationMap.stories.tsx)
+
+## Public imports
+
+```tsx
+import { ConversationMap } from "@alexgorbatchev/shadcn/assistant-ui";
+```
+
+## Default component
+
+```tsx
+ConversationMap
+```
+
+## Default args
+
+```tsx
+{
+    entries: [
+        { id: "start", title: "Planning", preview: "Gather the requirements." },
+        { id: "middle", title: "Implementation", preview: "Build the requested feature." },
+        { id: "end", title: "Verification", preview: "Check the result." },
+    ],
+    activeId: "middle",
+    visibleIds: ["start", "middle"],
+    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.
+
+### Navigate
+
+```tsx
+{}
+```
+
+### PreviewOnly
+
+```tsx
+{
+    args: { onSelect: undefined, side: "left" }
+}
+```
+
+### Empty
+
+```tsx
+{
+    args: { entries: [], activeId: undefined }
+}
+```

package/llms/components/assistant-ui/elements/conversations/ConversationSearch.md

@@ -0,0 +1,83 @@
+# ConversationSearch
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/conversations/ConversationSearch
+Source: src/components/stories/assistant-ui/elements/conversations/ConversationSearch.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/conversations/ConversationSearch.stories.tsx)
+
+## Public imports
+
+```tsx
+import { ConversationSearch } from "@alexgorbatchev/shadcn/assistant-ui";
+```
+
+## Supporting imports
+
+```tsx
+import { useState } from "react";
+```
+
+## Default component
+
+```tsx
+ConversationSearch
+```
+
+## Default args
+
+```tsx
+{
+    query: "keyboard",
+    activeIndex: 0,
+    hits: [
+        { id: "first", before: "Review the ", match: "keyboard", after: " controls.", position: 25 },
+        { id: "second", before: "Test the ", match: "keyboard", after: " focus.", position: 75 },
+    ],
+    onQueryChange: fn(),
+    onStep: fn(),
+}
+```
+
+## Default render
+
+```tsx
+function Interactive(args) {
+    const [query, setQuery] = useState(args.query);
+    const [activeIndex, setActiveIndex] = useState(args.activeIndex);
+    return (<ConversationSearch {...args} query={query} activeIndex={activeIndex} onQueryChange={args.onQueryChange &&
+            ((value) => {
+                args.onQueryChange?.(value);
+                setQuery(value);
+            })} onStep={args.onStep &&
+            ((delta) => {
+                args.onStep?.(delta);
+                setActiveIndex((index) => (index + delta + args.hits.length) % args.hits.length);
+            })}/>);
+}
+```
+
+## 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.
+
+### Matches
+
+```tsx
+{}
+```
+
+### Empty
+
+```tsx
+{
+    args: { hits: [] }
+}
+```
+
+### ReadOnly
+
+```tsx
+{
+    args: { onQueryChange: undefined, onStep: undefined }
+}
+```

package/llms/components/assistant-ui/elements/conversations/DaySeparator.md

@@ -0,0 +1,44 @@
+# DaySeparator
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/conversations/DaySeparator
+Source: src/components/stories/assistant-ui/elements/conversations/DaySeparator.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/conversations/DaySeparator.stories.tsx)
+
+## Public imports
+
+```tsx
+import { DaySeparator } from "@alexgorbatchev/shadcn/assistant-ui";
+```
+
+## Default component
+
+```tsx
+DaySeparator
+```
+
+## 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.
+
+### Conversation
+
+```tsx
+{
+    args: {
+        messages: [
+            { id: "request", day: "Today", time: "09:00", role: "user", text: "Review the component" },
+            { id: "reply", day: "Today", time: "09:01", role: "assistant", text: "The component is accessible." },
+            { id: "follow-up", day: "Tomorrow", time: "10:00", role: "user", text: "Add keyboard coverage" },
+        ],
+    }
+}
+```
+
+### Empty
+
+```tsx
+{
+    args: { messages: [] }
+}
+```

package/llms/components/assistant-ui/elements/conversations/DraftRestore.md

@@ -0,0 +1,48 @@
+# DraftRestore
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/conversations/DraftRestore
+Source: src/components/stories/assistant-ui/elements/conversations/DraftRestore.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/conversations/DraftRestore.stories.tsx)
+
+## Public imports
+
+```tsx
+import { DraftRestore } from "@alexgorbatchev/shadcn/assistant-ui";
+```
+
+## Default component
+
+```tsx
+DraftRestore
+```
+
+## Default args
+
+```tsx
+{ draft: "Review the keyboard interaction", savedAt: "09:30", onRestore: fn(), onDiscard: 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.
+
+### Restore
+
+```tsx
+{}
+```
+
+### Discard
+
+```tsx
+{}
+```
+
+### ReadOnly
+
+```tsx
+{
+    args: { onRestore: undefined, onDiscard: undefined }
+}
+```