@kitn.ai/ui 0.14.1 → 0.15.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (179) hide show
  1. package/dist/kitn-chat.es.js +1 -1
  2. package/package.json +6 -1
  3. package/src/components/component-meta.json +10 -10
  4. package/src/elements/compiled.css +1 -1
  5. package/src/remote/host-embed.ts +1 -1
  6. package/src/components/artifact.stories.tsx +0 -138
  7. package/src/components/attachments.stories.tsx +0 -303
  8. package/src/components/attachments.test.tsx +0 -64
  9. package/src/components/chain-of-thought.stories.tsx +0 -211
  10. package/src/components/chat-container.stories.tsx +0 -187
  11. package/src/components/chat-thread.test.tsx +0 -58
  12. package/src/components/checkpoint.stories.tsx +0 -102
  13. package/src/components/code-block.stories.tsx +0 -150
  14. package/src/components/confirm-card.stories.tsx +0 -74
  15. package/src/components/context.stories.tsx +0 -229
  16. package/src/components/context.test.tsx +0 -133
  17. package/src/components/conversation-item.stories.tsx +0 -125
  18. package/src/components/conversation-list.stories.tsx +0 -133
  19. package/src/components/default-input.test.tsx +0 -111
  20. package/src/components/empty.stories.tsx +0 -434
  21. package/src/components/feedback-bar.stories.tsx +0 -138
  22. package/src/components/feedback-bar.test.tsx +0 -103
  23. package/src/components/file-tree.stories.tsx +0 -73
  24. package/src/components/file-upload.stories.tsx +0 -156
  25. package/src/components/image.stories.tsx +0 -89
  26. package/src/components/loader.stories.tsx +0 -181
  27. package/src/components/markdown.stories.tsx +0 -180
  28. package/src/components/message-action-bar.test.tsx +0 -128
  29. package/src/components/message-narrow.stories.tsx +0 -329
  30. package/src/components/message-skills.stories.tsx +0 -211
  31. package/src/components/message.stories.tsx +0 -281
  32. package/src/components/model-switcher.stories.tsx +0 -123
  33. package/src/components/model-switcher.test.tsx +0 -65
  34. package/src/components/prompt-input.stories.tsx +0 -222
  35. package/src/components/prompt-suggestion.stories.tsx +0 -142
  36. package/src/components/reasoning.stories.tsx +0 -140
  37. package/src/components/resizable.test.tsx +0 -226
  38. package/src/components/scroll-button.stories.tsx +0 -100
  39. package/src/components/slash-command.stories.tsx +0 -163
  40. package/src/components/source-list.test.tsx +0 -152
  41. package/src/components/source.stories.tsx +0 -124
  42. package/src/components/tasks-card.stories.tsx +0 -78
  43. package/src/components/text-shimmer.stories.tsx +0 -87
  44. package/src/components/thinking-bar.stories.tsx +0 -87
  45. package/src/components/tool.stories.tsx +0 -153
  46. package/src/components/voice-input.stories.tsx +0 -83
  47. package/src/elements/artifact.stories.tsx +0 -506
  48. package/src/elements/attachments.stories.tsx +0 -190
  49. package/src/elements/card.stories.tsx +0 -113
  50. package/src/elements/cards.stories.tsx +0 -59
  51. package/src/elements/catalog.stories.tsx +0 -491
  52. package/src/elements/chain-of-thought.declarative.test.tsx +0 -153
  53. package/src/elements/chain-of-thought.stories.tsx +0 -113
  54. package/src/elements/chat-scope-picker.stories.tsx +0 -73
  55. package/src/elements/chat-workspace.stories.tsx +0 -288
  56. package/src/elements/chat.stories.tsx +0 -151
  57. package/src/elements/checkpoint.stories.tsx +0 -72
  58. package/src/elements/choice.stories.tsx +0 -240
  59. package/src/elements/code-block.stories.tsx +0 -83
  60. package/src/elements/composed-shell.stories.tsx +0 -316
  61. package/src/elements/confirm-card.stories.tsx +0 -227
  62. package/src/elements/context-meter.stories.tsx +0 -151
  63. package/src/elements/conversation-list.declarative.test.tsx +0 -137
  64. package/src/elements/conversation-list.stories.tsx +0 -243
  65. package/src/elements/embed.stories.tsx +0 -213
  66. package/src/elements/empty.stories.tsx +0 -111
  67. package/src/elements/feedback-bar.stories.tsx +0 -114
  68. package/src/elements/file-tree.stories.tsx +0 -134
  69. package/src/elements/file-upload.stories.tsx +0 -82
  70. package/src/elements/form.stories.tsx +0 -248
  71. package/src/elements/image.stories.tsx +0 -71
  72. package/src/elements/link-preview.stories.tsx +0 -209
  73. package/src/elements/loader.stories.tsx +0 -88
  74. package/src/elements/markdown.stories.tsx +0 -76
  75. package/src/elements/message-skills.declarative.test.tsx +0 -104
  76. package/src/elements/message-skills.stories.tsx +0 -114
  77. package/src/elements/message.stories.tsx +0 -218
  78. package/src/elements/model-switcher.declarative.test.tsx +0 -130
  79. package/src/elements/model-switcher.stories.tsx +0 -198
  80. package/src/elements/popover.stories.tsx +0 -80
  81. package/src/elements/prompt-input-slash-command.test.tsx +0 -128
  82. package/src/elements/prompt-input-stoppable.test.tsx +0 -88
  83. package/src/elements/prompt-input-toolbar-actions.test.tsx +0 -120
  84. package/src/elements/prompt-input.stories.tsx +0 -331
  85. package/src/elements/prompt-suggestions.declarative.test.tsx +0 -164
  86. package/src/elements/prompt-suggestions.stories.tsx +0 -213
  87. package/src/elements/reasoning.stories.tsx +0 -77
  88. package/src/elements/remote.stories.tsx +0 -314
  89. package/src/elements/resizable.stories.tsx +0 -426
  90. package/src/elements/response-stream.stories.tsx +0 -79
  91. package/src/elements/scroll-button.stories.tsx +0 -202
  92. package/src/elements/scroll-button.test.tsx +0 -148
  93. package/src/elements/source-list.stories.tsx +0 -143
  94. package/src/elements/source.stories.tsx +0 -88
  95. package/src/elements/switch.stories.tsx +0 -56
  96. package/src/elements/tasks.stories.tsx +0 -237
  97. package/src/elements/text-shimmer.stories.tsx +0 -64
  98. package/src/elements/thinking-bar.stories.tsx +0 -72
  99. package/src/elements/tool.stories.tsx +0 -89
  100. package/src/elements/voice-input.stories.tsx +0 -88
  101. package/src/primitives/controllable.test.ts +0 -47
  102. package/src/stories/chat-panel-layout.stories.tsx +0 -145
  103. package/src/stories/chat-scene.tsx +0 -571
  104. package/src/stories/checkpoint-restore.stories.tsx +0 -256
  105. package/src/stories/context-usage.stories.tsx +0 -212
  106. package/src/stories/conversation-with-reasoning.stories.tsx +0 -182
  107. package/src/stories/conversation-with-sources.stories.tsx +0 -471
  108. package/src/stories/docs/Accessibility.mdx +0 -119
  109. package/src/stories/docs/ChildElements.mdx +0 -269
  110. package/src/stories/docs/ForAIAgents.mdx +0 -162
  111. package/src/stories/docs/GettingStarted.mdx +0 -65
  112. package/src/stories/docs/Installation.mdx +0 -83
  113. package/src/stories/docs/Introduction.mdx +0 -50
  114. package/src/stories/docs/SolidJsAdvanced.mdx +0 -17
  115. package/src/stories/docs/Theming.mdx +0 -85
  116. package/src/stories/docs/element-controls.ts +0 -121
  117. package/src/stories/docs/frameworks/Angular.mdx +0 -245
  118. package/src/stories/docs/frameworks/Html.mdx +0 -227
  119. package/src/stories/docs/frameworks/Overview.mdx +0 -47
  120. package/src/stories/docs/frameworks/React.mdx +0 -227
  121. package/src/stories/docs/frameworks/Solid.mdx +0 -173
  122. package/src/stories/docs/frameworks/Svelte.mdx +0 -194
  123. package/src/stories/docs/frameworks/Vue.mdx +0 -238
  124. package/src/stories/docs/generative-ui-overview.mdx +0 -186
  125. package/src/stories/docs/recipes/SpeechToText.mdx +0 -7
  126. package/src/stories/docs/recipes/Streaming.mdx +0 -68
  127. package/src/stories/docs/recipes/TextToSpeech.mdx +0 -35
  128. package/src/stories/docs/theme-editor/canvas.tsx +0 -32
  129. package/src/stories/docs/theme-editor/inspector.tsx +0 -66
  130. package/src/stories/docs/theme-editor/presets.test.ts +0 -32
  131. package/src/stories/docs/theme-editor/presets.ts +0 -64
  132. package/src/stories/docs/theme-editor/theme-css.test.ts +0 -19
  133. package/src/stories/docs/theme-editor/theme-css.ts +0 -15
  134. package/src/stories/docs/theme-editor/theme-editor.tsx +0 -146
  135. package/src/stories/docs/theme-tokens.tsx +0 -174
  136. package/src/stories/examples/ChoosingComponents.mdx +0 -106
  137. package/src/stories/examples/sample-data.ts +0 -79
  138. package/src/stories/examples/usage/checkpoint-restore.ts +0 -156
  139. package/src/stories/examples/usage/context-usage.ts +0 -591
  140. package/src/stories/examples/usage/conversation-with-reasoning.ts +0 -224
  141. package/src/stories/examples/usage/conversation-with-sources.ts +0 -589
  142. package/src/stories/examples/usage/empty-state.ts +0 -144
  143. package/src/stories/examples/usage/full-chat-app.ts +0 -277
  144. package/src/stories/examples/usage/index.ts +0 -63
  145. package/src/stories/examples/usage/message-actions.ts +0 -704
  146. package/src/stories/examples/usage/pattern-centered-conversation.ts +0 -446
  147. package/src/stories/examples/usage/pattern-chat-panel-layout.ts +0 -442
  148. package/src/stories/examples/usage/pattern-docked-widget.ts +0 -479
  149. package/src/stories/examples/usage/prompt-input-variants.ts +0 -1356
  150. package/src/stories/examples/usage/streaming-response.ts +0 -687
  151. package/src/stories/examples/usage/types.ts +0 -33
  152. package/src/stories/full-chat.stories.tsx +0 -18
  153. package/src/stories/message-actions.stories.tsx +0 -230
  154. package/src/stories/pattern-centered-conversation.stories.tsx +0 -93
  155. package/src/stories/pattern-docked-widget.stories.tsx +0 -93
  156. package/src/stories/pattern-empty-state.stories.tsx +0 -76
  157. package/src/stories/prompt-input-variants.stories.tsx +0 -456
  158. package/src/stories/streaming-response.stories.tsx +0 -438
  159. package/src/stories/theme-editor.stories.tsx +0 -16
  160. package/src/stories/token-reference.stories.tsx +0 -18
  161. package/src/stories/typography.stories.tsx +0 -78
  162. package/src/ui/avatar.stories.tsx +0 -103
  163. package/src/ui/badge.stories.tsx +0 -86
  164. package/src/ui/button.stories.tsx +0 -145
  165. package/src/ui/collapsible.stories.tsx +0 -69
  166. package/src/ui/dropdown.stories.tsx +0 -59
  167. package/src/ui/hover-card.stories.tsx +0 -77
  168. package/src/ui/hover-card.test.tsx +0 -30
  169. package/src/ui/overlay.stories.tsx +0 -115
  170. package/src/ui/popover.stories.tsx +0 -81
  171. package/src/ui/popover.test.tsx +0 -99
  172. package/src/ui/resizable.stories.tsx +0 -236
  173. package/src/ui/scroll-area.stories.tsx +0 -50
  174. package/src/ui/separator.stories.tsx +0 -81
  175. package/src/ui/skeleton.stories.tsx +0 -337
  176. package/src/ui/switch.stories.tsx +0 -51
  177. package/src/ui/switch.test.tsx +0 -59
  178. package/src/ui/textarea.stories.tsx +0 -76
  179. package/src/ui/tooltip.stories.tsx +0 -74
@@ -1,704 +0,0 @@
1
- import type { ExampleUsage, StoryUsage } from './types';
2
-
3
- // Shared assistant reply used across the snippets.
4
- const REPLY = 'Async functions return Result, and the ? operator propagates errors.';
5
-
6
- /** Actions on Hover — the bar reveals on hover via the actions-reveal prop. */
7
- const hover: StoryUsage = {
8
- intro:
9
- 'Render an assistant message with an action bar that reveals on hover. Declare each button as a `<kai-action id icon tooltip>` child of `<kai-message>` and set `actions-reveal="hover"` — the element owns the fade (no consumer CSS). React passes the `actions` array instead; the Solid demo uses the primitives with `group`/`group-hover`.',
10
- snippets: {
11
- html: `<script type="module">
12
- import 'https://cdn.jsdelivr.net/npm/@kitn.ai/ui/dist/kitn-chat.es.js';
13
- </script>
14
-
15
- <kai-message id="msg" role="assistant" avatar-fallback="AI" content="${REPLY}" actions-reveal="hover">
16
- <kai-action id="copy" icon="copy" tooltip="Copy"></kai-action>
17
- <kai-action id="like" icon="like" tooltip="Good response"></kai-action>
18
- <kai-action id="dislike" icon="dislike" tooltip="Bad response"></kai-action>
19
- <kai-action id="regenerate" icon="regenerate" tooltip="Regenerate"></kai-action>
20
- </kai-message>
21
-
22
- <script type="module">
23
- document.getElementById('msg').addEventListener('kai-message-action', (e) => {
24
- const { messageId, action } = e.detail;
25
- console.log(messageId, action);
26
- });
27
- </script>`,
28
-
29
- react: `import { Message } from '@kitn.ai/ui/react';
30
-
31
- export function AssistantReply() {
32
- return (
33
- <Message
34
- actionsReveal="hover"
35
- message={{
36
- id: 'm1',
37
- role: 'assistant',
38
- content: '${REPLY}',
39
- actions: ['copy', 'like', 'dislike', 'regenerate'],
40
- }}
41
- onMessageAction={(e) => {
42
- const { messageId, action } = e.detail;
43
- console.log(messageId, action);
44
- }}
45
- />
46
- );
47
- }`,
48
-
49
- vue: `<script setup>
50
- import '@kitn.ai/ui/elements';
51
-
52
- function onAction(e) {
53
- const { messageId, action } = e.detail;
54
- console.log(messageId, action);
55
- }
56
- </script>
57
-
58
- <template>
59
- <kai-message role="assistant" avatar-fallback="AI" content="${REPLY}" actions-reveal="hover" @kai-message-action="onAction">
60
- <kai-action id="copy" icon="copy" tooltip="Copy"></kai-action>
61
- <kai-action id="like" icon="like" tooltip="Good response"></kai-action>
62
- <kai-action id="dislike" icon="dislike" tooltip="Bad response"></kai-action>
63
- <kai-action id="regenerate" icon="regenerate" tooltip="Regenerate"></kai-action>
64
- </kai-message>
65
- </template>`,
66
-
67
- svelte: `<script>
68
- import '@kitn.ai/ui/elements';
69
-
70
- function onAction(e) {
71
- const { messageId, action } = e.detail;
72
- console.log(messageId, action);
73
- }
74
- </script>
75
-
76
- <kai-message role="assistant" avatar-fallback="AI" content="${REPLY}" actions-reveal="hover" on:kai-message-action={onAction}>
77
- <kai-action id="copy" icon="copy" tooltip="Copy"></kai-action>
78
- <kai-action id="like" icon="like" tooltip="Good response"></kai-action>
79
- <kai-action id="dislike" icon="dislike" tooltip="Bad response"></kai-action>
80
- <kai-action id="regenerate" icon="regenerate" tooltip="Regenerate"></kai-action>
81
- </kai-message>`,
82
-
83
- angular: `import { Component, CUSTOM_ELEMENTS_SCHEMA } from '@angular/core';
84
-
85
- @Component({
86
- selector: 'app-reply',
87
- standalone: true,
88
- schemas: [CUSTOM_ELEMENTS_SCHEMA],
89
- template: \`
90
- <kai-message role="assistant" avatar-fallback="AI" content="${REPLY}" actions-reveal="hover" (kai-message-action)="onAction($event)">
91
- <kai-action id="copy" icon="copy" tooltip="Copy"></kai-action>
92
- <kai-action id="like" icon="like" tooltip="Good response"></kai-action>
93
- <kai-action id="dislike" icon="dislike" tooltip="Bad response"></kai-action>
94
- <kai-action id="regenerate" icon="regenerate" tooltip="Regenerate"></kai-action>
95
- </kai-message>
96
- \`,
97
- })
98
- export class ReplyComponent {
99
- onAction(e: CustomEvent<{ messageId: string; action: string }>) {
100
- console.log(e.detail.messageId, e.detail.action);
101
- }
102
- }`,
103
-
104
- solid: `import { Message, MessageAvatar, MessageContent, MessageActions, Button, Tooltip } from '@kitn.ai/ui';
105
- import { Copy, ThumbsUp, ThumbsDown, RefreshCw } from 'lucide-solid';
106
-
107
- export function AssistantReply() {
108
- return (
109
- <Message>
110
- <MessageAvatar src="" fallback="AI" alt="Assistant" />
111
- {/* group + group-hover reveals the bar on row hover */}
112
- <div class="group flex-1 space-y-2">
113
- <MessageContent markdown>${REPLY}</MessageContent>
114
- <MessageActions class="opacity-0 group-hover:opacity-100 transition-opacity">
115
- <Tooltip content="Copy"><Button variant="ghost" size="icon-sm" aria-label="Copy"><Copy class="size-3.5" /></Button></Tooltip>
116
- <Tooltip content="Good response"><Button variant="ghost" size="icon-sm" aria-label="Good response"><ThumbsUp class="size-3.5" /></Button></Tooltip>
117
- <Tooltip content="Bad response"><Button variant="ghost" size="icon-sm" aria-label="Bad response"><ThumbsDown class="size-3.5" /></Button></Tooltip>
118
- <Tooltip content="Regenerate"><Button variant="ghost" size="icon-sm" aria-label="Regenerate"><RefreshCw class="size-3.5" /></Button></Tooltip>
119
- </MessageActions>
120
- </div>
121
- </Message>
122
- );
123
- }`,
124
- },
125
- };
126
-
127
- /** Always Visible Actions — bar always shown; custom actions via descriptor objects. */
128
- const alwaysVisible: StoryUsage = {
129
- intro:
130
- "Keep the bar always visible (the default). Declare each button as a `<kai-action id icon tooltip>` child — built-in-style (copy/like/…) and custom (share/bookmark) are all just `<kai-action>` elements, and `<kai-message>` fires `messageaction` with the id. (React passes them as the `actions` array.)",
131
- snippets: {
132
- html: `<script type="module">
133
- import 'https://cdn.jsdelivr.net/npm/@kitn.ai/ui/dist/kitn-chat.es.js';
134
- </script>
135
-
136
- <kai-message id="msg" role="assistant" avatar-fallback="AI" content="${REPLY}">
137
- <kai-action id="copy" icon="copy" tooltip="Copy"></kai-action>
138
- <kai-action id="like" icon="like" tooltip="Good response"></kai-action>
139
- <kai-action id="dislike" icon="dislike" tooltip="Bad response"></kai-action>
140
- <kai-action id="regenerate" icon="regenerate" tooltip="Regenerate"></kai-action>
141
- <kai-action id="share" icon="share" tooltip="Share"></kai-action>
142
- <kai-action id="bookmark" icon="bookmark" tooltip="Bookmark"></kai-action>
143
- </kai-message>
144
-
145
- <script type="module">
146
- document.getElementById('msg').addEventListener('kai-message-action', (e) => console.log(e.detail));
147
- </script>`,
148
-
149
- react: `import { Message } from '@kitn.ai/ui/react';
150
-
151
- export function AssistantReply() {
152
- return (
153
- <Message
154
- message={{
155
- id: 'm1',
156
- role: 'assistant',
157
- content: '${REPLY}',
158
- actions: [
159
- 'copy', 'like', 'dislike', 'regenerate',
160
- { id: 'share', label: 'Share', icon: 'share' },
161
- { id: 'bookmark', label: 'Bookmark', icon: 'bookmark' },
162
- ],
163
- }}
164
- onMessageAction={(e) => console.log(e.detail)}
165
- />
166
- );
167
- }`,
168
-
169
- vue: `<script setup>
170
- import '@kitn.ai/ui/elements';
171
- </script>
172
-
173
- <template>
174
- <kai-message role="assistant" avatar-fallback="AI" content="${REPLY}" @kai-message-action="(e) => console.log(e.detail)">
175
- <kai-action id="copy" icon="copy" tooltip="Copy"></kai-action>
176
- <kai-action id="like" icon="like" tooltip="Good response"></kai-action>
177
- <kai-action id="dislike" icon="dislike" tooltip="Bad response"></kai-action>
178
- <kai-action id="regenerate" icon="regenerate" tooltip="Regenerate"></kai-action>
179
- <kai-action id="share" icon="share" tooltip="Share"></kai-action>
180
- <kai-action id="bookmark" icon="bookmark" tooltip="Bookmark"></kai-action>
181
- </kai-message>
182
- </template>`,
183
-
184
- svelte: `<script>
185
- import '@kitn.ai/ui/elements';
186
- </script>
187
-
188
- <kai-message role="assistant" avatar-fallback="AI" content="${REPLY}" on:kai-message-action={(e) => console.log(e.detail)}>
189
- <kai-action id="copy" icon="copy" tooltip="Copy"></kai-action>
190
- <kai-action id="like" icon="like" tooltip="Good response"></kai-action>
191
- <kai-action id="dislike" icon="dislike" tooltip="Bad response"></kai-action>
192
- <kai-action id="regenerate" icon="regenerate" tooltip="Regenerate"></kai-action>
193
- <kai-action id="share" icon="share" tooltip="Share"></kai-action>
194
- <kai-action id="bookmark" icon="bookmark" tooltip="Bookmark"></kai-action>
195
- </kai-message>`,
196
-
197
- angular: `import { Component, CUSTOM_ELEMENTS_SCHEMA } from '@angular/core';
198
-
199
- @Component({
200
- selector: 'app-reply',
201
- standalone: true,
202
- schemas: [CUSTOM_ELEMENTS_SCHEMA],
203
- template: \`
204
- <kai-message role="assistant" avatar-fallback="AI" content="${REPLY}" (kai-message-action)="log($event)">
205
- <kai-action id="copy" icon="copy" tooltip="Copy"></kai-action>
206
- <kai-action id="like" icon="like" tooltip="Good response"></kai-action>
207
- <kai-action id="dislike" icon="dislike" tooltip="Bad response"></kai-action>
208
- <kai-action id="regenerate" icon="regenerate" tooltip="Regenerate"></kai-action>
209
- <kai-action id="share" icon="share" tooltip="Share"></kai-action>
210
- <kai-action id="bookmark" icon="bookmark" tooltip="Bookmark"></kai-action>
211
- </kai-message>
212
- \`,
213
- })
214
- export class ReplyComponent {
215
- log(e: CustomEvent) { console.log(e.detail); }
216
- }`,
217
-
218
- solid: `import { Message, MessageAvatar, MessageContent, MessageActions, Button, Tooltip } from '@kitn.ai/ui';
219
- import { Copy, ThumbsUp, ThumbsDown, RefreshCw, Share, Bookmark } from 'lucide-solid';
220
-
221
- export function AssistantReply() {
222
- return (
223
- <Message>
224
- <MessageAvatar src="" fallback="AI" alt="Assistant" />
225
- <div class="flex-1 space-y-2">
226
- <MessageContent markdown>${REPLY}</MessageContent>
227
- <MessageActions>
228
- <Tooltip content="Copy"><Button variant="ghost" size="icon-sm" aria-label="Copy"><Copy class="size-3.5" /></Button></Tooltip>
229
- <Tooltip content="Good response"><Button variant="ghost" size="icon-sm" aria-label="Good response"><ThumbsUp class="size-3.5" /></Button></Tooltip>
230
- <Tooltip content="Bad response"><Button variant="ghost" size="icon-sm" aria-label="Bad response"><ThumbsDown class="size-3.5" /></Button></Tooltip>
231
- <Tooltip content="Regenerate"><Button variant="ghost" size="icon-sm" aria-label="Regenerate"><RefreshCw class="size-3.5" /></Button></Tooltip>
232
- <Tooltip content="Share"><Button variant="ghost" size="icon-sm" aria-label="Share"><Share class="size-3.5" /></Button></Tooltip>
233
- <Tooltip content="Bookmark"><Button variant="ghost" size="icon-sm" aria-label="Bookmark"><Bookmark class="size-3.5" /></Button></Tooltip>
234
- </MessageActions>
235
- </div>
236
- </Message>
237
- );
238
- }`,
239
- },
240
- };
241
-
242
- /** Copy with Confirmation — the copy action swaps to a check for 2s. */
243
- const copyConfirm: StoryUsage = {
244
- intro:
245
- 'Listen for `messageaction` with `action: "copy"` and write to the clipboard yourself — `<kai-message>` only emits the event; it does not touch the clipboard. In SolidJS you can also swap the icon to a check for 2 seconds as a visual confirmation (see the Solid tab).',
246
- snippets: {
247
- html: `<script type="module">
248
- import 'https://cdn.jsdelivr.net/npm/@kitn.ai/ui/dist/kitn-chat.es.js';
249
- </script>
250
-
251
- <kai-message id="msg" role="assistant" avatar-fallback="AI" content="${REPLY}">
252
- <kai-action id="copy" icon="copy" tooltip="Copy"></kai-action>
253
- <kai-action id="like" icon="like" tooltip="Good response"></kai-action>
254
- <kai-action id="dislike" icon="dislike" tooltip="Bad response"></kai-action>
255
- </kai-message>
256
-
257
- <script type="module">
258
- const msg = document.getElementById('msg');
259
- msg.addEventListener('kai-message-action', (e) => {
260
- if (e.detail.action === 'copy') navigator.clipboard.writeText(msg.content);
261
- });
262
- </script>`,
263
-
264
- react: `import { Message } from '@kitn.ai/ui/react';
265
-
266
- const content = '${REPLY}';
267
-
268
- export function AssistantReply() {
269
- return (
270
- <Message
271
- message={{ id: 'm1', role: 'assistant', content, actions: ['copy', 'like', 'dislike'] }}
272
- onMessageAction={(e) => {
273
- if (e.detail.action === 'copy') navigator.clipboard.writeText(content);
274
- }}
275
- />
276
- );
277
- }`,
278
-
279
- vue: `<script setup>
280
- import '@kitn.ai/ui/elements';
281
-
282
- const content = '${REPLY}';
283
-
284
- function onAction(e) {
285
- if (e.detail.action === 'copy') navigator.clipboard.writeText(content);
286
- }
287
- </script>
288
-
289
- <template>
290
- <kai-message role="assistant" avatar-fallback="AI" :content="content" @kai-message-action="onAction">
291
- <kai-action id="copy" icon="copy" tooltip="Copy"></kai-action>
292
- <kai-action id="like" icon="like" tooltip="Good response"></kai-action>
293
- <kai-action id="dislike" icon="dislike" tooltip="Bad response"></kai-action>
294
- </kai-message>
295
- </template>`,
296
-
297
- svelte: `<script>
298
- import '@kitn.ai/ui/elements';
299
-
300
- const content = '${REPLY}';
301
-
302
- function onAction(e) {
303
- if (e.detail.action === 'copy') navigator.clipboard.writeText(content);
304
- }
305
- </script>
306
-
307
- <kai-message role="assistant" avatar-fallback="AI" {content} on:kai-message-action={onAction}>
308
- <kai-action id="copy" icon="copy" tooltip="Copy"></kai-action>
309
- <kai-action id="like" icon="like" tooltip="Good response"></kai-action>
310
- <kai-action id="dislike" icon="dislike" tooltip="Bad response"></kai-action>
311
- </kai-message>`,
312
-
313
- angular: `import { Component, CUSTOM_ELEMENTS_SCHEMA } from '@angular/core';
314
-
315
- @Component({
316
- selector: 'app-reply',
317
- standalone: true,
318
- schemas: [CUSTOM_ELEMENTS_SCHEMA],
319
- template: \`
320
- <kai-message role="assistant" avatar-fallback="AI" [content]="content" (kai-message-action)="onAction($event)">
321
- <kai-action id="copy" icon="copy" tooltip="Copy"></kai-action>
322
- <kai-action id="like" icon="like" tooltip="Good response"></kai-action>
323
- <kai-action id="dislike" icon="dislike" tooltip="Bad response"></kai-action>
324
- </kai-message>
325
- \`,
326
- })
327
- export class ReplyComponent {
328
- content = '${REPLY}';
329
- onAction(e: CustomEvent<{ messageId: string; action: string }>) {
330
- if (e.detail.action === 'copy') navigator.clipboard.writeText(this.content);
331
- }
332
- }`,
333
-
334
- solid: `import { createSignal } from 'solid-js';
335
- import { Message, MessageAvatar, MessageContent, MessageActions, Button, Tooltip } from '@kitn.ai/ui';
336
- import { Copy, Check, ThumbsUp, ThumbsDown } from 'lucide-solid';
337
-
338
- export function AssistantReply() {
339
- const [copied, setCopied] = createSignal(false);
340
- const copy = () => { setCopied(true); setTimeout(() => setCopied(false), 2000); };
341
-
342
- return (
343
- <Message>
344
- <MessageAvatar src="" fallback="AI" alt="Assistant" />
345
- <div class="flex-1 space-y-2">
346
- <MessageContent>${REPLY}</MessageContent>
347
- <MessageActions>
348
- <Tooltip content={copied() ? 'Copied!' : 'Copy'}>
349
- <Button variant="ghost" size="icon-sm" aria-label={copied() ? 'Copied' : 'Copy'} onClick={copy}>
350
- {copied() ? <Check class="size-3.5 text-green-500" /> : <Copy class="size-3.5" />}
351
- </Button>
352
- </Tooltip>
353
- <Tooltip content="Good response">
354
- <Button variant="ghost" size="icon-sm" aria-label="Good response"><ThumbsUp class="size-3.5" /></Button>
355
- </Tooltip>
356
- <Tooltip content="Bad response">
357
- <Button variant="ghost" size="icon-sm" aria-label="Bad response"><ThumbsDown class="size-3.5" /></Button>
358
- </Tooltip>
359
- </MessageActions>
360
- </div>
361
- </Message>
362
- );
363
- }`,
364
- },
365
- };
366
-
367
- /** Feedback Bar — the self-contained ask → optional detail → thanks flow. */
368
- const feedbackBar: StoryUsage = {
369
- intro:
370
- 'Ask for feedback under a reply. `<kai-feedback-bar>` owns the whole flow — it asks, optionally collects a category + comment on a not-helpful vote (`collect-detail`), then confirms with a thank-you **in place** (it does not disappear on a vote; only `close` removes it). It fires `feedback` (`{ value }`), `feedbackdetail` (`{ value, category?, comment? }`), and `close`.',
371
- snippets: {
372
- html: `<script type="module">
373
- import 'https://cdn.jsdelivr.net/npm/@kitn.ai/ui/dist/kitn-chat.es.js';
374
- </script>
375
-
376
- <kai-feedback-bar id="fb" bar-title="Was this response helpful?" collect-detail></kai-feedback-bar>
377
-
378
- <script type="module">
379
- const fb = document.getElementById('fb');
380
- fb.categories = ['Inaccurate', 'Not helpful', 'Unsafe', 'Other']; // chips (a JS property)
381
- fb.addEventListener('kai-feedback', (e) => console.log(e.detail.value)); // 'helpful' | 'not-helpful'
382
- fb.addEventListener('kai-feedback-detail', (e) => console.log(e.detail)); // { value, category?, comment? }
383
- fb.addEventListener('kai-close', () => fb.remove());
384
- </script>`,
385
-
386
- react: `import { FeedbackBar } from '@kitn.ai/ui/react';
387
-
388
- <FeedbackBar
389
- barTitle="Was this response helpful?"
390
- collectDetail
391
- categories={['Inaccurate', 'Not helpful', 'Unsafe', 'Other']}
392
- onFeedback={(e) => console.log(e.detail.value)}
393
- onFeedbackDetail={(e) => console.log(e.detail)} // { value, category?, comment? }
394
- onClose={() => {/* dismiss */}}
395
- />`,
396
-
397
- vue: `<script setup>
398
- import '@kitn.ai/ui/elements';
399
- function onFeedback(e) { console.log(e.detail.value); }
400
- function onDetail(e) { console.log(e.detail); }
401
- </script>
402
-
403
- <template>
404
- <kai-feedback-bar
405
- bar-title="Was this response helpful?"
406
- collect-detail
407
- :categories.prop="['Inaccurate', 'Not helpful', 'Unsafe', 'Other']"
408
- @kai-feedback="onFeedback"
409
- @kai-feedback-detail="onDetail"
410
- />
411
- </template>`,
412
-
413
- svelte: `<script>
414
- import '@kitn.ai/ui/elements';
415
- let fb;
416
- $: if (fb) fb.categories = ['Inaccurate', 'Not helpful', 'Unsafe', 'Other'];
417
- function onFeedback(e) { console.log(e.detail.value); }
418
- function onDetail(e) { console.log(e.detail); }
419
- </script>
420
-
421
- <kai-feedback-bar
422
- bind:this={fb}
423
- bar-title="Was this response helpful?"
424
- collect-detail
425
- on:kai-feedback={onFeedback}
426
- on:kai-feedback-detail={onDetail}
427
- />`,
428
-
429
- angular: `import { Component, CUSTOM_ELEMENTS_SCHEMA } from '@angular/core';
430
-
431
- @Component({
432
- selector: 'app-feedback',
433
- standalone: true,
434
- schemas: [CUSTOM_ELEMENTS_SCHEMA],
435
- template: \`
436
- <kai-feedback-bar
437
- bar-title="Was this response helpful?"
438
- collect-detail
439
- [categories]="categories"
440
- (kai-feedback)="onFeedback($event)"
441
- (kai-feedback-detail)="onDetail($event)">
442
- </kai-feedback-bar>
443
- \`,
444
- })
445
- export class FeedbackComponent {
446
- categories = ['Inaccurate', 'Not helpful', 'Unsafe', 'Other'];
447
- onFeedback(e: CustomEvent<{ value: 'helpful' | 'not-helpful' }>) { console.log(e.detail.value); }
448
- onDetail(e: CustomEvent<{ value: 'helpful' | 'not-helpful'; category?: string; comment?: string }>) { console.log(e.detail); }
449
- }`,
450
-
451
- solid: `import { createSignal, Show } from 'solid-js';
452
- import { Message, MessageAvatar, MessageContent, FeedbackBar } from '@kitn.ai/ui';
453
-
454
- export function AssistantReply() {
455
- const [show, setShow] = createSignal(true);
456
- return (
457
- <Message>
458
- <MessageAvatar src="" fallback="AI" alt="Assistant" />
459
- <div class="flex-1 space-y-3">
460
- <MessageContent markdown>${REPLY}</MessageContent>
461
- <Show when={show()}>
462
- <FeedbackBar
463
- title="Was this response helpful?"
464
- collectDetail
465
- categories={['Inaccurate', 'Not helpful', 'Unsafe', 'Other']}
466
- onFeedback={(value) => console.log(value)}
467
- onSubmitDetail={(d) => console.log(d)}
468
- onClose={() => setShow(false)}
469
- />
470
- </Show>
471
- </div>
472
- </Message>
473
- );
474
- }`,
475
- },
476
- };
477
-
478
- /** Full Example — all stories combined: avatar + markdown + built-in/custom actions
479
- * + copy-to-clipboard with confirmation + a Feedback Bar. */
480
- const fullExample: StoryUsage = {
481
- intro:
482
- 'Every feature combined: avatar, markdown content, the action bar (copy/regenerate plus custom **Share**/**Bookmark** with tooltips), a copy→clipboard handler with visual confirmation, and a **Feedback Bar** below. Like/dislike are omitted since the Feedback Bar covers that. Icon-only buttons get tooltips automatically; override the text with a `tooltip` field on custom actions. In SolidJS wrap each button with `<Tooltip>` (see the Solid tab).',
483
- snippets: {
484
- html: `<script type="module">
485
- import 'https://cdn.jsdelivr.net/npm/@kitn.ai/ui/dist/kitn-chat.es.js';
486
- </script>
487
-
488
- <div style="max-width:42rem; padding:1rem; display:flex; flex-direction:column; gap:0.5rem">
489
- <kai-message
490
- id="msg"
491
- role="assistant"
492
- avatar-fallback="AI"
493
- content="Use anyhow::Result for apps and thiserror for libraries."
494
- >
495
- <kai-action id="copy" icon="copy" tooltip="Copy to clipboard"></kai-action>
496
- <kai-action id="regenerate" icon="regenerate" tooltip="Regenerate"></kai-action>
497
- <kai-action id="share" icon="share" tooltip="Share this response">Share</kai-action>
498
- <kai-action id="bookmark" icon="bookmark" tooltip="Save for later">Bookmark</kai-action>
499
- </kai-message>
500
- <kai-feedback-bar id="fb" bar-title="Was this response helpful?"></kai-feedback-bar>
501
- </div>
502
-
503
- <script type="module">
504
- const msg = document.getElementById('msg');
505
- const fb = document.getElementById('fb');
506
-
507
- msg.addEventListener('kai-message-action', (e) => {
508
- const { action } = e.detail;
509
- if (action === 'copy') navigator.clipboard.writeText(msg.content);
510
- console.log(e.detail);
511
- });
512
-
513
- // The bar confirms in place on a vote; only close removes it.
514
- fb.addEventListener('kai-feedback', (e) => console.log('feedback:', e.detail.value));
515
- fb.addEventListener('kai-close', () => fb.remove());
516
- </script>`,
517
-
518
- react: `import { useState } from 'react';
519
- import { Message, FeedbackBar } from '@kitn.ai/ui/react';
520
-
521
- export function AssistantReply() {
522
- const [showFeedback, setShowFeedback] = useState(true);
523
- const content = 'Use anyhow::Result for apps and thiserror for libraries.';
524
-
525
- return (
526
- <div style={{ display: 'flex', flexDirection: 'column', gap: '0.5rem', maxWidth: '42rem' }}>
527
- <Message
528
- message={{
529
- id: 'm1',
530
- role: 'assistant',
531
- content,
532
- avatar: { fallback: 'AI', alt: 'Assistant' },
533
- actions: [
534
- 'copy', 'regenerate',
535
- { id: 'share', label: 'Share', icon: 'share', tooltip: 'Share this response' },
536
- { id: 'bookmark', label: 'Bookmark', icon: 'bookmark', tooltip: 'Save for later' },
537
- ],
538
- }}
539
- onMessageAction={(e) => {
540
- if (e.detail.action === 'copy') navigator.clipboard.writeText(content);
541
- }}
542
- />
543
- {showFeedback && (
544
- <FeedbackBar
545
- barTitle="Was this response helpful?"
546
- onClose={() => setShowFeedback(false)}
547
- />
548
- )}
549
- </div>
550
- );
551
- }`,
552
-
553
- vue: `<script setup>
554
- import { ref } from 'vue';
555
- import '@kitn.ai/ui/elements';
556
-
557
- const content = 'Use anyhow::Result for apps and thiserror for libraries.';
558
- const showFeedback = ref(true);
559
-
560
- function onAction(e) {
561
- if (e.detail.action === 'copy') navigator.clipboard.writeText(content);
562
- }
563
- </script>
564
-
565
- <template>
566
- <div style="display:flex; flex-direction:column; gap:0.5rem; max-width:42rem">
567
- <kai-message role="assistant" avatar-fallback="AI" :content="content" @kai-message-action="onAction">
568
- <kai-action id="copy" icon="copy" tooltip="Copy to clipboard"></kai-action>
569
- <kai-action id="regenerate" icon="regenerate" tooltip="Regenerate"></kai-action>
570
- <kai-action id="share" icon="share" tooltip="Share this response">Share</kai-action>
571
- <kai-action id="bookmark" icon="bookmark" tooltip="Save for later">Bookmark</kai-action>
572
- </kai-message>
573
- <kai-feedback-bar
574
- v-if="showFeedback"
575
- bar-title="Was this response helpful?"
576
- @kai-close="showFeedback = false"
577
- />
578
- </div>
579
- </template>`,
580
-
581
- svelte: `<script>
582
- import '@kitn.ai/ui/elements';
583
-
584
- const content = 'Use anyhow::Result for apps and thiserror for libraries.';
585
- let showFeedback = true;
586
-
587
- function onAction(e) {
588
- if (e.detail.action === 'copy') navigator.clipboard.writeText(content);
589
- }
590
- </script>
591
-
592
- <div style="display:flex; flex-direction:column; gap:0.5rem; max-width:42rem">
593
- <kai-message role="assistant" avatar-fallback="AI" {content} on:kai-message-action={onAction}>
594
- <kai-action id="copy" icon="copy" tooltip="Copy to clipboard"></kai-action>
595
- <kai-action id="regenerate" icon="regenerate" tooltip="Regenerate"></kai-action>
596
- <kai-action id="share" icon="share" tooltip="Share this response">Share</kai-action>
597
- <kai-action id="bookmark" icon="bookmark" tooltip="Save for later">Bookmark</kai-action>
598
- </kai-message>
599
- {#if showFeedback}
600
- <kai-feedback-bar
601
- bar-title="Was this response helpful?"
602
- on:kai-close={() => (showFeedback = false)}
603
- />
604
- {/if}
605
- </div>`,
606
-
607
- angular: `import { Component, CUSTOM_ELEMENTS_SCHEMA, signal } from '@angular/core';
608
-
609
- @Component({
610
- selector: 'app-reply',
611
- standalone: true,
612
- schemas: [CUSTOM_ELEMENTS_SCHEMA],
613
- template: \`
614
- <div style="display:flex; flex-direction:column; gap:0.5rem; max-width:42rem">
615
- <kai-message role="assistant" avatar-fallback="AI" [content]="content" (kai-message-action)="onAction($event)">
616
- <kai-action id="copy" icon="copy" tooltip="Copy to clipboard"></kai-action>
617
- <kai-action id="regenerate" icon="regenerate" tooltip="Regenerate"></kai-action>
618
- <kai-action id="share" icon="share" tooltip="Share this response">Share</kai-action>
619
- <kai-action id="bookmark" icon="bookmark" tooltip="Save for later">Bookmark</kai-action>
620
- </kai-message>
621
- @if (showFeedback()) {
622
- <kai-feedback-bar
623
- bar-title="Was this response helpful?"
624
- (kai-close)="showFeedback.set(false)">
625
- </kai-feedback-bar>
626
- }
627
- </div>
628
- \`,
629
- })
630
- export class ReplyComponent {
631
- showFeedback = signal(true);
632
- content = 'Use anyhow::Result for apps and thiserror for libraries.';
633
- onAction(e: CustomEvent<{ messageId: string; action: string }>) {
634
- if (e.detail.action === 'copy') navigator.clipboard.writeText(this.content);
635
- }
636
- }`,
637
-
638
- solid: `import { createSignal, Show } from 'solid-js';
639
- import { Message, MessageAvatar, MessageContent, MessageActions, FeedbackBar, Button, Tooltip } from '@kitn.ai/ui';
640
- import { Copy, Check, RefreshCw, Share, Bookmark } from 'lucide-solid';
641
-
642
- export function AssistantReply() {
643
- const content = 'Use anyhow::Result for apps and thiserror for libraries.';
644
- const [copied, setCopied] = createSignal(false);
645
- const [showFeedback, setShowFeedback] = createSignal(true);
646
-
647
- const handleCopy = () => {
648
- navigator.clipboard.writeText(content);
649
- setCopied(true);
650
- setTimeout(() => setCopied(false), 2000);
651
- };
652
-
653
- return (
654
- <Message>
655
- <MessageAvatar src="" fallback="AI" alt="Assistant" />
656
- <div class="flex-1 space-y-2">
657
- <MessageContent markdown>{content}</MessageContent>
658
- <MessageActions>
659
- <Tooltip content={copied() ? 'Copied!' : 'Copy'}>
660
- <Button variant="ghost" size="icon-sm" aria-label={copied() ? 'Copied' : 'Copy'} onClick={handleCopy}>
661
- {copied() ? <Check class="size-3.5 text-green-500" /> : <Copy class="size-3.5" />}
662
- </Button>
663
- </Tooltip>
664
- <Tooltip content="Regenerate">
665
- <Button variant="ghost" size="icon-sm" aria-label="Regenerate"><RefreshCw class="size-3.5" /></Button>
666
- </Tooltip>
667
- <Tooltip content="Share this response">
668
- <Button variant="ghost" size="icon-sm" aria-label="Share"><Share class="size-3.5" /></Button>
669
- </Tooltip>
670
- <Tooltip content="Save for later">
671
- <Button variant="ghost" size="icon-sm" aria-label="Bookmark"><Bookmark class="size-3.5" /></Button>
672
- </Tooltip>
673
- </MessageActions>
674
- <Show when={showFeedback()}>
675
- <FeedbackBar
676
- title="Was this response helpful?"
677
- onClose={() => setShowFeedback(false)}
678
- />
679
- </Show>
680
- </div>
681
- </Message>
682
- );
683
- }`,
684
- },
685
- };
686
-
687
- /**
688
- * Example: Message Actions — copy / like / dislike / regenerate (and a feedback
689
- * bar) on an assistant message. Per-story: the Usage tab shows the snippet for
690
- * the story you're on; the example-level fields below are the fallback.
691
- */
692
- const messageActions: ExampleUsage = {
693
- title: 'Examples/Message Actions',
694
- ...hover, // example-level fallback = the headline "Actions on Hover"
695
- stories: {
696
- 'Actions on Hover': hover,
697
- 'Always Visible Actions': alwaysVisible,
698
- 'Copy with Confirmation': copyConfirm,
699
- 'Feedback Bar': feedbackBar,
700
- 'Full Example': fullExample,
701
- },
702
- };
703
-
704
- export default messageActions;