@alexgorbatchev/shadcn 0.0.18 → 0.0.20

package/llms/components/assistant-ui/elements/composer/ComposerVoice.md

@@ -0,0 +1,58 @@
+# ComposerVoice
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/composer/ComposerVoice
+Source: src/components/stories/assistant-ui/elements/composer/ComposerVoice.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/composer/ComposerVoice.stories.tsx)
+
+## Public imports
+
+```tsx
+import { ComposerVoice } from "@alexgorbatchev/shadcn/assistant-ui";
+```
+
+## Default component
+
+```tsx
+ComposerVoice
+```
+
+## Default args
+
+```tsx
+{ recording: true, seconds: 7, audioLevels: fixture_composerAudioLevels }
+```
+
+## 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.
+
+### Recording
+
+```tsx
+{}
+```
+
+### LongRecording
+
+```tsx
+{
+    args: { seconds: 125 }
+}
+```
+
+### WithoutSamples
+
+```tsx
+{
+    args: { audioLevels: undefined }
+}
+```
+
+### Transcribing
+
+```tsx
+{
+    args: { recording: false }
+}
+```

package/llms/components/assistant-ui/elements/composer/ComposerVoiceButton.md

@@ -0,0 +1,50 @@
+# ComposerVoiceButton
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/composer/ComposerVoiceButton
+Source: src/components/stories/assistant-ui/elements/composer/ComposerVoiceButton.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/composer/ComposerVoiceButton.stories.tsx)
+
+## Public imports
+
+```tsx
+import { ComposerVoiceButton } from "@alexgorbatchev/shadcn/assistant-ui";
+```
+
+## Default component
+
+```tsx
+ComposerVoiceButton
+```
+
+## Default args
+
+```tsx
+{ active: false, onClick: 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.
+
+### Start
+
+```tsx
+{}
+```
+
+### Stop
+
+```tsx
+{
+    args: { active: true }
+}
+```
+
+### Disabled
+
+```tsx
+{
+    args: { disabled: true }
+}
+```

package/llms/components/assistant-ui/elements/composer/MobileComposer.md

@@ -0,0 +1,82 @@
+# MobileComposer
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/composer/MobileComposer
+Source: src/components/stories/assistant-ui/elements/composer/MobileComposer.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/composer/MobileComposer.stories.tsx)
+
+## Public imports
+
+```tsx
+import { MobileComposer } from "@alexgorbatchev/shadcn/assistant-ui";
+```
+
+## Supporting imports
+
+```tsx
+import { useState } from "react";
+```
+
+## Default component
+
+```tsx
+MobileComposer
+```
+
+## Default args
+
+```tsx
+{
+    value: "",
+    keyboardOpen: false,
+    running: false,
+    actions: ["Explain", "Summarize"],
+    onSend: fn(),
+    onStop: fn(),
+    onAttach: fn(),
+    onAction: fn(),
+    onValueChange: fn(),
+    onFocus: 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.
+
+### Compose
+
+```tsx
+{
+    render: function Render(args) {
+        const [value, setValue] = useState(args.value);
+        return (<MobileComposer {...args} value={value} onValueChange={(next) => {
+                setValue(next);
+                args.onValueChange?.(next);
+            }}/>);
+    }
+}
+```
+
+### Running
+
+```tsx
+{
+    args: { value: "Continue", running: true, keyboardOpen: true }
+}
+```
+
+### ReadOnly
+
+```tsx
+{
+    args: {
+        value: "Read only message",
+        onValueChange: undefined,
+        onAttach: undefined,
+        onAction: undefined,
+        onSend: undefined,
+        onStop: undefined,
+    }
+}
+```

package/llms/components/assistant-ui/elements/composer/PromptLibrary.md

@@ -0,0 +1,99 @@
+# PromptLibrary
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/composer/PromptLibrary
+Source: src/components/stories/assistant-ui/elements/composer/PromptLibrary.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/composer/PromptLibrary.stories.tsx)
+
+## Public imports
+
+```tsx
+import { PromptLibrary } from "@alexgorbatchev/shadcn/assistant-ui";
+```
+
+## Default component
+
+```tsx
+PromptLibrary
+```
+
+## Default render
+
+```tsx
+(args) => <PromptLibrary {...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: {
+        prompts: [{ id: "review", name: "Source review", body: "Review {{file}} for correctness", variables: ["file"] }],
+        query: "",
+        selectedId: "review",
+        onQueryChange: fn(),
+        onSelect: fn(),
+        onInsert: fn(),
+    }
+}
+```
+
+### LightTheme
+
+```tsx
+{
+    args: {
+        prompts: [{ id: "review", name: "Source review", body: "Review {{file}} for correctness", variables: ["file"] }],
+        query: "",
+        selectedId: "review",
+        onQueryChange: fn(),
+        onSelect: fn(),
+        onInsert: fn(),
+    },
+    globals: { theme: "light" }
+}
+```
+
+### DarkTheme
+
+```tsx
+{
+    args: {
+        prompts: [{ id: "review", name: "Source review", body: "Review {{file}} for correctness", variables: ["file"] }],
+        query: "",
+        selectedId: "review",
+        onQueryChange: fn(),
+        onSelect: fn(),
+        onInsert: fn(),
+    },
+    globals: { theme: "dark" }
+}
+```
+
+### KeyboardSearchAndInsert
+
+```tsx
+{
+    render: () => <PromptLibraryFixture />
+}
+```
+
+### InsertWithoutSelection
+
+```tsx
+{
+    args: { ...Default.args, onSelect: undefined, onQueryChange: undefined }
+}
+```
+
+### ReadOnly
+
+```tsx
+{
+    args: { ...Default.args, onSelect: undefined, onInsert: undefined, onQueryChange: undefined }
+}
+```

package/llms/components/assistant-ui/elements/composer/Suggestions.md

@@ -0,0 +1,62 @@
+# Suggestions
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/composer/Suggestions
+Source: src/components/stories/assistant-ui/elements/composer/Suggestions.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/composer/Suggestions.stories.tsx)
+
+## Public imports
+
+```tsx
+import { Suggestions } from "@alexgorbatchev/shadcn/assistant-ui";
+```
+
+## Default component
+
+```tsx
+Suggestions
+```
+
+## Default render
+
+```tsx
+(args) => <Suggestions {...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: { suggestions: ["Review the source", "Run the tests"], selectedSuggestion: null, cycle: 0, onSuggestion: fn() }
+}
+```
+
+### List
+
+```tsx
+{
+    args: { ...Default.args, variant: "list" }
+}
+```
+
+### LightTheme
+
+```tsx
+{
+    args: { suggestions: ["Review the source", "Run the tests"], selectedSuggestion: null, cycle: 0, onSuggestion: fn() },
+    globals: { theme: "light" }
+}
+```
+
+### DarkTheme
+
+```tsx
+{
+    args: { suggestions: ["Review the source", "Run the tests"], selectedSuggestion: null, cycle: 0, onSuggestion: fn() },
+    globals: { theme: "dark" }
+}
+```

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

@@ -0,0 +1,58 @@
+# ContextBreakdown
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/context/ContextBreakdown
+Source: src/components/stories/assistant-ui/elements/context/ContextBreakdown.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/context/ContextBreakdown.stories.tsx)
+
+## Public imports
+
+```tsx
+import { ContextBreakdown } from "@alexgorbatchev/shadcn/assistant-ui";
+```
+
+## Default component
+
+```tsx
+ContextBreakdown
+```
+
+## Default args
+
+```tsx
+{
+    limit: 1000,
+    segments: [
+        { label: "Conversation", tokens: 400, tone: "primary" },
+        { label: "Files", tokens: 250, tone: "success" },
+        { label: "Instructions", tokens: 100, tone: "warning" },
+        { label: "Tools", tokens: 50, tone: "muted" },
+    ],
+}
+```
+
+## 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.
+
+### Used
+
+```tsx
+{}
+```
+
+### AboveCapacity
+
+```tsx
+{
+    args: { segments: [{ label: "Conversation", tokens: 1200, tone: "warning" }] }
+}
+```
+
+### Empty
+
+```tsx
+{
+    args: { limit: 0, segments: [] }
+}
+```

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

@@ -0,0 +1,37 @@
+# ContextDisplay
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/context/ContextDisplay
+Source: src/components/stories/assistant-ui/elements/context/ContextDisplay.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/context/ContextDisplay.stories.tsx)
+
+## Public imports
+
+```tsx
+import { ContextDisplay } from "@alexgorbatchev/shadcn/assistant-ui";
+```
+
+## Default component
+
+```tsx
+ContextDisplay
+```
+
+## Default args
+
+```tsx
+{ modelContextWindow: 10000, usage: { totalTokens: 9000 } }
+```
+
+## Default render
+
+```tsx
+(args) => (<ContextDisplay {...args}>
+      <ContextDisplay.Trigger aria-label="Context usage">Usage</ContextDisplay.Trigger>
+      <ContextDisplay.Content />
+    </ContextDisplay>)
+```
+
+## 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/elements/context/ContextDisplayBar.md

@@ -0,0 +1,28 @@
+# ContextDisplayBar
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/context/ContextDisplayBar
+Source: src/components/stories/assistant-ui/elements/context/ContextDisplayBar.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/context/ContextDisplayBar.stories.tsx)
+
+## Public imports
+
+```tsx
+import { ContextDisplayBar } from "@alexgorbatchev/shadcn/assistant-ui";
+```
+
+## Default component
+
+```tsx
+ContextDisplayBar
+```
+
+## Default args
+
+```tsx
+{ modelContextWindow: 10000, usage: { totalTokens: 7500 } }
+```
+
+## 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/elements/context/ContextDisplayContent.md

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

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

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

@@ -0,0 +1,54 @@
+# ContextDisplayRoot
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/context/ContextDisplayRoot
+Source: src/components/stories/assistant-ui/elements/context/ContextDisplayRoot.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/context/ContextDisplayRoot.stories.tsx)
+
+## Public imports
+
+```tsx
+import { ContextDisplayRoot, ContextDisplayTrigger, ContextDisplayContent } from "@alexgorbatchev/shadcn/assistant-ui";
+```
+
+## Default component
+
+```tsx
+ContextDisplayRoot
+```
+
+## Default args
+
+```tsx
+{
+    modelContextWindow: 10000,
+    usage: { totalTokens: 7500, inputTokens: 6000, cachedInputTokens: 4000, outputTokens: 1500 },
+}
+```
+
+## Default render
+
+```tsx
+(args) => (<ContextDisplayRoot {...args}>
+      <ContextDisplayTrigger aria-label="Context usage">Usage</ContextDisplayTrigger>
+      <ContextDisplayContent />
+    </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.
+
+### Usage
+
+```tsx
+{}
+```
+
+### NoUsage
+
+```tsx
+{
+    args: { usage: undefined }
+}
+```

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

@@ -0,0 +1,28 @@
+# ContextDisplayText
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/context/ContextDisplayText
+Source: src/components/stories/assistant-ui/elements/context/ContextDisplayText.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/context/ContextDisplayText.stories.tsx)
+
+## Public imports
+
+```tsx
+import { ContextDisplayText } from "@alexgorbatchev/shadcn/assistant-ui";
+```
+
+## Default component
+
+```tsx
+ContextDisplayText
+```
+
+## Default args
+
+```tsx
+{ modelContextWindow: 10000, usage: { totalTokens: 7500 } }
+```
+
+## 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/elements/context/ContextDisplayTrigger.md

@@ -0,0 +1,51 @@
+# ContextDisplayTrigger
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/context/ContextDisplayTrigger
+Source: src/components/stories/assistant-ui/elements/context/ContextDisplayTrigger.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/context/ContextDisplayTrigger.stories.tsx)
+
+## Public imports
+
+```tsx
+import { ContextDisplayTrigger, ContextDisplayRoot, ContextDisplayContent } from "@alexgorbatchev/shadcn/assistant-ui";
+```
+
+## Default component
+
+```tsx
+ContextDisplayTrigger
+```
+
+## Default args
+
+```tsx
+{ children: "Usage" }
+```
+
+## Default render
+
+```tsx
+(args) => (<ContextDisplayRoot modelContextWindow={10000} usage={{ totalTokens: 7500 }}>
+      <ContextDisplayTrigger {...args}/>
+      <ContextDisplayContent />
+    </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.
+
+### Keyboard
+
+```tsx
+{}
+```
+
+### Disabled
+
+```tsx
+{
+    args: { disabled: true }
+}
+```