@alexgorbatchev/shadcn 0.0.18 → 0.0.20

package/llms/components/assistant-ui/elements/data-visualization/GenerativeUi.md

@@ -0,0 +1,110 @@
+# GenerativeUi
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/data-visualization/GenerativeUi
+Source: src/components/stories/assistant-ui/elements/data-visualization/GenerativeUi.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/data-visualization/GenerativeUi.stories.tsx)
+
+## Public imports
+
+```tsx
+import { GenerativeUi } from "@alexgorbatchev/shadcn/assistant-ui";
+```
+
+## Default component
+
+```tsx
+GenerativeUi
+```
+
+## Default args
+
+```tsx
+{
+    node: {
+        _type: "Markdown",
+        value: "## Release notes\n\n- **Verified** rendering\n- [Guide](https://example.com/guide)",
+    },
+}
+```
+
+## 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.
+
+### Markdown
+
+```tsx
+{}
+```
+
+### Diagram
+
+```tsx
+{
+    args: { node: { _type: "Diagram", title: "Build pipeline", code: "graph LR\n A[Read] --> B[Build]" } }
+}
+```
+
+### Empty
+
+```tsx
+{
+    args: { node: null }
+}
+```
+
+### MapRoute
+
+```tsx
+{
+    args: {
+        node: {
+            _type: "Map",
+            route: true,
+            places: [
+                { label: "London", lat: 51.5, lng: -0.12, detail: "First stop" },
+                { label: "Paris", lat: 48.85, lng: 2.35 },
+                null,
+                "pending",
+                { label: "Missing coordinates" },
+                { label: 42, lat: 0, lng: 0 },
+                { label: "Invalid latitude", lat: "north", lng: 0 },
+                { label: "Invalid longitude", lat: 0, lng: "east" },
+            ],
+        },
+    }
+}
+```
+
+### MapWithoutRoute
+
+```tsx
+{
+    args: { node: { _type: "Map", places: [{ label: "Origin", lat: 0, lng: 0, detail: 42 }] } }
+}
+```
+
+### EmptyMap
+
+```tsx
+{
+    args: { node: { _type: "Map", route: true } }
+}
+```
+
+### StreamingMarkdown
+
+```tsx
+{
+    args: { node: { _type: "Markdown" }, context: { status: "streaming" } }
+}
+```
+
+### UntitledDiagram
+
+```tsx
+{
+    args: { node: { _type: "Diagram", code: "graph LR\n A[Read] --> B[Build]" } }
+}
+```

package/llms/components/assistant-ui/elements/data-visualization/GenerativeUiTheme.md

@@ -0,0 +1,67 @@
+# GenerativeUiTheme
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/data-visualization/GenerativeUiTheme
+Source: src/components/stories/assistant-ui/elements/data-visualization/GenerativeUiTheme.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/data-visualization/GenerativeUiTheme.stories.tsx)
+
+## Public imports
+
+```tsx
+import { GenerativeUi } from "@alexgorbatchev/shadcn/assistant-ui";
+import { Button, DensityProvider } from "@alexgorbatchev/shadcn";
+```
+
+## Supporting imports
+
+```tsx
+import type { ReactElement } from "react";
+import { useState } from "react";
+```
+
+## Default component
+
+```tsx
+GenerativeUi
+```
+
+## Default args
+
+```tsx
+{
+    node: {
+        $type: "Form",
+        $action: { type: "save" },
+        children: [
+            { $type: "Input", label: "Workspace", name: "workspace" },
+            { $type: "Button", label: "Save plan", buttonStyle: "primary", submit: true },
+        ],
+    },
+    context: { status: "done", dispatch: fn() },
+}
+```
+
+## Default render
+
+```tsx
+function Render(args): ReactElement {
+    const [isCompact, setIsCompact] = useState(false);
+    return (<DensityProvider density={isCompact ? "compact" : "comfortable"}>
+        <div className="flex flex-col gap-4">
+          <GenerativeUi {...args}/>
+          <Button aria-label="Density reference">Native reference</Button>
+          <Button onClick={() => setIsCompact(true)}>Compact density</Button>
+        </div>
+      </DensityProvider>);
+}
+```
+
+## 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.
+
+### NativeFormDensity
+
+```tsx
+{}
+```

package/llms/components/assistant-ui/elements/data-visualization/GeoMap.md

@@ -0,0 +1,91 @@
+# GeoMap
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/data-visualization/GeoMap
+Source: src/components/stories/assistant-ui/elements/data-visualization/GeoMap.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/data-visualization/GeoMap.stories.tsx)
+
+## Public imports
+
+```tsx
+import { GeoMap } from "@alexgorbatchev/shadcn/assistant-ui";
+```
+
+## Default component
+
+```tsx
+GeoMap
+```
+
+## Default args
+
+```tsx
+{
+    places: [
+        { id: "london", lat: 51.5, lng: -0.12, label: "London", description: "First stop" },
+        { id: "paris", lat: 48.85, lng: 2.35, label: "Paris", description: "Second stop" },
+    ],
+    routes: [
+        {
+            id: "trip",
+            points: [
+                [51.5, -0.12],
+                [48.85, 2.35],
+            ],
+        },
+    ],
+    tileUrl: "data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='256' height='256'%3E%3Crect width='256' height='256' fill='lightgray'/%3E%3C/svg%3E",
+    attribution: "Deterministic map fixture",
+    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.
+
+### Selection
+
+```tsx
+{}
+```
+
+### RouteLabel
+
+```tsx
+{
+    args: {
+        routes: [
+            {
+                id: "named-trip",
+                label: "London to Paris",
+                points: [
+                    [51.5, -0.12],
+                    [48.85, 2.35],
+                ],
+            },
+        ],
+    }
+}
+```
+
+### InvalidCoordinates
+
+```tsx
+{
+    args: {
+        places: [
+            { id: "bad", lat: 91, lng: 0, label: "Invalid" },
+            { id: "valid", lat: 0, lng: 0, label: "Origin" },
+        ],
+    }
+}
+```
+
+### Empty
+
+```tsx
+{
+    args: { places: [], routes: [] }
+}
+```

package/llms/components/assistant-ui/elements/data-visualization/HeatGraph.md

@@ -0,0 +1,57 @@
+# HeatGraph
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/data-visualization/HeatGraph
+Source: src/components/stories/assistant-ui/elements/data-visualization/HeatGraph.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/data-visualization/HeatGraph.stories.tsx)
+
+## Public imports
+
+```tsx
+import { HeatGraph } from "@alexgorbatchev/shadcn/assistant-ui";
+```
+
+## Default component
+
+```tsx
+HeatGraph
+```
+
+## Default args
+
+```tsx
+{
+    start: "2026-10-01",
+    end: "2026-10-20",
+    data: [
+        { date: "2026-10-12", count: 4 },
+        { date: "2026-10-13", count: 2 },
+    ],
+}
+```
+
+## 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.
+
+### Contributions
+
+```tsx
+{}
+```
+
+### Compact
+
+```tsx
+{
+    args: { density: "compact", showMonths: false }
+}
+```
+
+### Empty
+
+```tsx
+{
+    args: { data: [] }
+}
+```

package/llms/components/assistant-ui/elements/data-visualization/MapAnswer.md

@@ -0,0 +1,58 @@
+# MapAnswer
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/data-visualization/MapAnswer
+Source: src/components/stories/assistant-ui/elements/data-visualization/MapAnswer.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/data-visualization/MapAnswer.stories.tsx)
+
+## Public imports
+
+```tsx
+import { MapAnswer } from "@alexgorbatchev/shadcn/assistant-ui";
+```
+
+## Default component
+
+```tsx
+MapAnswer
+```
+
+## Default args
+
+```tsx
+{
+    pins: [
+        { id: "first", label: "Station", detail: "Start", x: 20, y: 30 },
+        { id: "last", label: "Office", detail: "Destination", x: 80, y: 70 },
+    ],
+    activeId: "first",
+    route: true,
+    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.
+
+### SelectPin
+
+```tsx
+{}
+```
+
+### ReadOnly
+
+```tsx
+{
+    args: { onSelect: undefined }
+}
+```
+
+### Empty
+
+```tsx
+{
+    args: { pins: [] }
+}
+```

package/llms/components/assistant-ui/elements/data-visualization/MermaidDiagram.md

@@ -0,0 +1,66 @@
+# MermaidDiagram
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/data-visualization/MermaidDiagram
+Source: src/components/stories/assistant-ui/elements/data-visualization/MermaidDiagram.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/data-visualization/MermaidDiagram.stories.tsx)
+
+## Public imports
+
+```tsx
+import { MermaidDiagram } from "@alexgorbatchev/shadcn/assistant-ui/mermaid-diagram";
+import { PortalProvider } from "@alexgorbatchev/shadcn";
+```
+
+## Supporting imports
+
+```tsx
+import { useState } from "react";
+```
+
+## Default component
+
+```tsx
+MermaidDiagram
+```
+
+## Default args
+
+```tsx
+{ code: "graph LR\n  A[Read] --> B[Build]\n  B --> C[Verify]" }
+```
+
+## 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.
+
+### ExpandAndZoom
+
+```tsx
+{
+    render: function Render(args) {
+        const [container, setContainer] = useState<HTMLElement | null>(null);
+        return (<section aria-label="Diagram portal" ref={setContainer}>
+        <PortalProvider container={container}>
+          <MermaidDiagram {...args}/>
+        </PortalProvider>
+      </section>);
+    }
+}
+```
+
+### Streaming
+
+```tsx
+{
+    args: { streaming: true, code: "graph LR\n A -->" }
+}
+```
+
+### Invalid
+
+```tsx
+{
+    args: { code: "graph LR\n A -->" }
+}
+```

package/llms/components/assistant-ui/elements/data-visualization/NumberRoll.md

@@ -0,0 +1,88 @@
+# NumberRoll
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/data-visualization/NumberRoll
+Source: src/components/stories/assistant-ui/elements/data-visualization/NumberRoll.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/data-visualization/NumberRoll.stories.tsx)
+
+## Public imports
+
+```tsx
+import { NumberRoll } from "@alexgorbatchev/shadcn/assistant-ui";
+```
+
+## Default component
+
+```tsx
+NumberRoll
+```
+
+## Default args
+
+```tsx
+{ value: 99, locales: "en-US", duration: 5000 }
+```
+
+## Default render
+
+```tsx
+(args) => <NumberRollScene {...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.
+
+### Changing
+
+```tsx
+{}
+```
+
+### Currency
+
+```tsx
+{
+    args: { format: { style: "currency", currency: "USD" }, prefix: "~", suffix: " total", duration: 0 }
+}
+```
+
+### Localized
+
+```tsx
+{
+    args: { value: -12.5, locales: "ar-EG", duration: 0 }
+}
+```
+
+### UpwardTrend
+
+```tsx
+{
+    args: { value: 1000, trend: "up" }
+}
+```
+
+### DownwardTrend
+
+```tsx
+{
+    args: { trend: "down", duration: 0 }
+}
+```
+
+### DefaultDuration
+
+```tsx
+{
+    render: () => <NumberRollScene value={99} locales="en-US"/>
+}
+```
+
+### InvalidDuration
+
+```tsx
+{
+    args: { duration: Number.NaN }
+}
+```

package/llms/components/assistant-ui/elements/data-visualization/NumberRollDigit.md

@@ -0,0 +1,28 @@
+# NumberRollDigit
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/data-visualization/NumberRollDigit
+Source: src/components/stories/assistant-ui/elements/data-visualization/NumberRollDigit.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/data-visualization/NumberRollDigit.stories.tsx)
+
+## Default component
+
+```tsx
+NumberRollDigit
+```
+
+## Default args
+
+```tsx
+{ digit: 9, direction: 1, duration: 500 }
+```
+
+## Default render
+
+```tsx
+(args) => <NumberRollDigitScene {...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.

package/llms/components/assistant-ui/elements/data-visualization/NumberRollPart.md

@@ -0,0 +1,28 @@
+# NumberRollPart
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/data-visualization/NumberRollPart
+Source: src/components/stories/assistant-ui/elements/data-visualization/NumberRollPart.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/data-visualization/NumberRollPart.stories.tsx)
+
+## Default component
+
+```tsx
+NumberRollPart
+```
+
+## Default args
+
+```tsx
+{ part: { type: "symbol", key: "currency", value: "$" }, direction: -1, duration: 300 }
+```
+
+## Default render
+
+```tsx
+(args) => <NumberRollPartScene {...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.

package/llms/components/assistant-ui/elements/data-visualization/NumberTicker.md

@@ -0,0 +1,87 @@
+# NumberTicker
+
+Story: @alexgorbatchev/shadcn/components/assistant-ui/elements/data-visualization/NumberTicker
+Source: src/components/stories/assistant-ui/elements/data-visualization/NumberTicker.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/assistant-ui/elements/data-visualization/NumberTicker.stories.tsx)
+
+## Public imports
+
+```tsx
+import { NumberTicker } from "@alexgorbatchev/shadcn/assistant-ui";
+```
+
+## Default component
+
+```tsx
+NumberTicker
+```
+
+## Default render
+
+```tsx
+(args) => <NumberTicker {...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: { value: 1234, label: "Tokens generated" }
+}
+```
+
+### LightTheme
+
+```tsx
+{
+    args: { value: 1234, label: "Tokens generated" },
+    globals: { theme: "light" }
+}
+```
+
+### DarkTheme
+
+```tsx
+{
+    args: { value: 1234, label: "Tokens generated" },
+    globals: { theme: "dark" }
+}
+```
+
+### Zero
+
+```tsx
+{
+    args: { ...Default.args, value: 0 }
+}
+```
+
+### Negative
+
+```tsx
+{
+    args: { ...Default.args, value: -12 }
+}
+```
+
+### Decimal
+
+```tsx
+{
+    args: { ...Default.args, value: 1234.5 }
+}
+```
+
+### Incrementing
+
+```tsx
+{
+    args: { ...Default.args, value: 999 },
+    render: (args) => <NumberTickerFixture key={args.value} value={args.value} label={args.label}/>
+}
+```