@kitn.ai/ui 0.15.0 → 0.16.0

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 (366) hide show
  1. package/README.md +9 -0
  2. package/bin/mcp.js +22 -0
  3. package/dist/bash-InADTalH.js +6 -1
  4. package/dist/components/artifact.d.ts +58 -0
  5. package/dist/components/attachments.d.ts +67 -0
  6. package/dist/components/card-fallback.d.ts +10 -0
  7. package/dist/components/card-renderer.d.ts +13 -0
  8. package/dist/components/card.d.ts +28 -0
  9. package/dist/components/chain-of-thought.d.ts +29 -0
  10. package/dist/components/chat-container.d.ts +19 -0
  11. package/dist/components/chat-scope-picker.d.ts +9 -0
  12. package/dist/components/chat-thread.d.ts +93 -0
  13. package/dist/components/checkpoint.d.ts +20 -0
  14. package/dist/components/choice-card.d.ts +77 -0
  15. package/dist/components/code-block.d.ts +16 -0
  16. package/dist/components/confirm-card.d.ts +57 -0
  17. package/dist/components/context.d.ts +65 -0
  18. package/dist/components/conversation-item.d.ts +8 -0
  19. package/dist/components/conversation-list.d.ts +11 -0
  20. package/dist/components/embed.d.ts +21 -0
  21. package/dist/components/empty.d.ts +43 -0
  22. package/dist/components/feedback-bar.d.ts +45 -0
  23. package/dist/components/file-tree.d.ts +57 -0
  24. package/dist/components/file-upload.d.ts +16 -0
  25. package/dist/components/form-widgets.d.ts +31 -0
  26. package/dist/components/form.d.ts +103 -0
  27. package/dist/components/image.d.ts +12 -0
  28. package/dist/components/link-preview.d.ts +23 -0
  29. package/dist/components/loader.d.ts +60 -0
  30. package/dist/components/markdown.d.ts +8 -0
  31. package/dist/components/message-skills.d.ts +15 -0
  32. package/dist/components/message.d.ts +54 -0
  33. package/dist/components/model-switcher.d.ts +8 -0
  34. package/dist/components/prompt-input.d.ts +38 -0
  35. package/dist/components/prompt-suggestion.d.ts +13 -0
  36. package/dist/components/reasoning.d.ts +20 -0
  37. package/dist/components/response-stream.d.ts +14 -0
  38. package/dist/components/scroll-button.d.ts +7 -0
  39. package/dist/components/slash-command.d.ts +15 -0
  40. package/dist/components/source.d.ts +23 -0
  41. package/dist/components/tasks-card.d.ts +71 -0
  42. package/dist/components/text-shimmer.d.ts +9 -0
  43. package/dist/components/thinking-bar.d.ts +10 -0
  44. package/dist/components/tool.d.ts +16 -0
  45. package/dist/components/use-card-resolution.d.ts +12 -0
  46. package/dist/components/voice-input.d.ts +7 -0
  47. package/dist/core-AYMC6_lb.js +5874 -12
  48. package/dist/css-M7EaDHN_.js +6 -1
  49. package/dist/elements/artifact.d.ts +1 -0
  50. package/dist/elements/attachments.d.ts +1 -0
  51. package/dist/elements/card.d.ts +1 -0
  52. package/dist/elements/cards.d.ts +0 -0
  53. package/dist/elements/chain-of-thought.d.ts +13 -0
  54. package/dist/elements/chat-scope-picker.d.ts +1 -0
  55. package/dist/elements/chat-types.d.ts +41 -0
  56. package/dist/elements/chat-workspace.d.ts +1 -0
  57. package/dist/elements/chat.d.ts +1 -0
  58. package/dist/elements/checkpoint.d.ts +1 -0
  59. package/dist/elements/choice.d.ts +1 -0
  60. package/dist/elements/code-block.d.ts +1 -0
  61. package/dist/elements/confirm-card.d.ts +1 -0
  62. package/dist/elements/context-meter.d.ts +1 -0
  63. package/dist/elements/conversation-list.d.ts +11 -0
  64. package/dist/elements/css.d.ts +1 -0
  65. package/dist/elements/default-input.d.ts +40 -0
  66. package/dist/elements/define.d.ts +42 -0
  67. package/dist/elements/embed.d.ts +1 -0
  68. package/dist/elements/empty.d.ts +1 -0
  69. package/dist/elements/feedback-bar.d.ts +1 -0
  70. package/dist/elements/file-tree.d.ts +1 -0
  71. package/dist/elements/file-upload.d.ts +1 -0
  72. package/dist/elements/form.d.ts +1 -0
  73. package/dist/elements/image.d.ts +1 -0
  74. package/dist/elements/link-preview.d.ts +1 -0
  75. package/dist/elements/loader.d.ts +1 -0
  76. package/dist/elements/markdown.d.ts +1 -0
  77. package/dist/elements/message-skills.d.ts +17 -0
  78. package/dist/elements/message.d.ts +1 -0
  79. package/dist/elements/model-switcher.d.ts +11 -0
  80. package/dist/elements/popover.d.ts +1 -0
  81. package/dist/elements/prompt-input.d.ts +9 -0
  82. package/dist/elements/prompt-suggestions.d.ts +7 -0
  83. package/dist/elements/reasoning.d.ts +1 -0
  84. package/dist/elements/register-impl.d.ts +0 -0
  85. package/dist/elements/register.d.ts +3 -0
  86. package/dist/elements/remote.d.ts +1 -0
  87. package/dist/elements/resizable.d.ts +17 -0
  88. package/dist/elements/response-stream.d.ts +1 -0
  89. package/dist/elements/scroll-button.d.ts +1 -0
  90. package/dist/elements/source.d.ts +18 -0
  91. package/dist/elements/switch.d.ts +1 -0
  92. package/dist/elements/tasks.d.ts +1 -0
  93. package/dist/elements/text-shimmer.d.ts +1 -0
  94. package/dist/elements/thinking-bar.d.ts +1 -0
  95. package/dist/elements/tool.d.ts +1 -0
  96. package/dist/elements/voice-input.d.ts +1 -0
  97. package/dist/elements.d.ts +732 -0
  98. package/dist/engine-javascript-vq0WuIJl.js +2516 -14
  99. package/dist/github-dark-dimmed-DUshB20C.js +4 -1
  100. package/dist/github-light-JYsPkUQd.js +4 -1
  101. package/dist/html-CPZ3oZQ7.js +10 -1
  102. package/dist/index.d.ts +112 -2
  103. package/dist/index.js +13551 -0
  104. package/dist/javascript-C25yR2R2.js +6 -1
  105. package/dist/json-DxJze_jm.js +6 -1
  106. package/dist/kitn-chat.es.js +1 -77
  107. package/dist/llms/llms-full.txt +1 -1
  108. package/dist/llms/llms.txt +1 -1
  109. package/dist/mcp.es.js +2140 -0
  110. package/dist/primitives/card-contract.d.ts +103 -0
  111. package/dist/primitives/card-host.d.ts +12 -0
  112. package/dist/primitives/card-registry.d.ts +17 -0
  113. package/dist/primitives/card-resolution.d.ts +8 -0
  114. package/dist/primitives/card-routing.d.ts +12 -0
  115. package/dist/primitives/card-validate.d.ts +25 -0
  116. package/dist/primitives/chat-config.d.ts +31 -0
  117. package/dist/primitives/controllable.d.ts +13 -0
  118. package/dist/primitives/embed-providers.d.ts +65 -0
  119. package/dist/primitives/highlighter.d.ts +23 -0
  120. package/dist/primitives/link-preview.d.ts +47 -0
  121. package/dist/primitives/pdf-preview.d.ts +50 -0
  122. package/dist/primitives/use-auto-resize.d.ts +8 -0
  123. package/dist/primitives/use-resize-observer.d.ts +1 -0
  124. package/dist/primitives/use-stick-to-bottom.d.ts +5 -0
  125. package/dist/primitives/use-text-stream.d.ts +19 -0
  126. package/dist/primitives/use-voice-recorder.d.ts +9 -0
  127. package/dist/react/index.d.ts +1118 -0
  128. package/dist/react/runtime.d.ts +15 -0
  129. package/dist/react.js +265 -0
  130. package/dist/register-impl-wCsFPoh9.js +77 -0
  131. package/dist/register-ujhr1nBS.js +1 -0
  132. package/dist/remote/host-embed.d.ts +33 -0
  133. package/dist/remote/index.d.ts +2 -0
  134. package/dist/remote/origin.d.ts +5 -0
  135. package/dist/remote/provider-runtime.d.ts +27 -0
  136. package/dist/remote/provider.d.ts +2 -0
  137. package/dist/remote/validate.d.ts +4 -0
  138. package/dist/remote/version.d.ts +4 -0
  139. package/dist/remote/wire.d.ts +53 -0
  140. package/dist/svelte--5p79yCD.js +15 -1
  141. package/dist/tsx-B8rCNbgL.js +6 -1
  142. package/dist/types.d.ts +42 -0
  143. package/dist/typescript-RycA9KXf.js +6 -1
  144. package/dist/ui/action-icons.d.ts +11 -0
  145. package/dist/ui/avatar.d.ts +8 -0
  146. package/dist/ui/badge.d.ts +9 -0
  147. package/dist/ui/button.d.ts +10 -0
  148. package/dist/ui/collapsible.d.ts +27 -0
  149. package/dist/ui/dropdown.d.ts +20 -0
  150. package/dist/ui/hover-card.d.ts +28 -0
  151. package/dist/ui/overlay.d.ts +67 -0
  152. package/dist/ui/popover.d.ts +32 -0
  153. package/dist/ui/resizable.d.ts +76 -0
  154. package/dist/ui/scroll-area.d.ts +5 -0
  155. package/dist/ui/separator.d.ts +5 -0
  156. package/dist/ui/skeleton.d.ts +5 -0
  157. package/dist/ui/switch.d.ts +19 -0
  158. package/dist/ui/textarea.d.ts +6 -0
  159. package/dist/ui/tooltip.d.ts +8 -0
  160. package/dist/utils/cn.d.ts +2 -0
  161. package/dist/vue-BmIZj4XD.js +33 -1
  162. package/frameworks/react/index.tsx +4 -0
  163. package/frameworks/react/runtime.tsx +16 -2
  164. package/llms-full.txt +1 -1
  165. package/llms.txt +1 -1
  166. package/package.json +29 -11
  167. package/src/agent-tooling/archetypes.ts +46 -0
  168. package/src/agent-tooling/integrations/cloudflare.ts +88 -0
  169. package/src/agent-tooling/integrations/langgraph.ts +60 -0
  170. package/src/agent-tooling/integrations/mastra.ts +27 -0
  171. package/src/agent-tooling/integrations/mock.ts +34 -0
  172. package/src/agent-tooling/integrations/ollama.ts +47 -0
  173. package/src/agent-tooling/integrations/openrouter.ts +26 -0
  174. package/src/agent-tooling/integrations/pi.ts +40 -0
  175. package/src/agent-tooling/integrations/pydantic-ai.ts +52 -0
  176. package/src/agent-tooling/integrations/vercel-ai-sdk.ts +44 -0
  177. package/src/agent-tooling/mcp/manifest.ts +128 -0
  178. package/src/agent-tooling/mcp/server.ts +59 -0
  179. package/src/agent-tooling/mcp/stdio.ts +18 -0
  180. package/src/agent-tooling/mcp/tools/debug.ts +305 -0
  181. package/src/agent-tooling/mcp/tools/reference.ts +132 -0
  182. package/src/agent-tooling/mcp/tools/scaffold.ts +1627 -0
  183. package/src/agent-tooling/mcp/tools/theme.ts +340 -0
  184. package/src/agent-tooling/mcp/tools/types.ts +14 -0
  185. package/src/agent-tooling/registry.ts +41 -0
  186. package/src/agent-tooling/types.ts +30 -0
  187. package/src/elements/compiled.css +1 -1
  188. package/src/elements/define.tsx +7 -1
  189. package/src/elements/element-types.d.ts +2 -1
  190. package/src/elements/register-impl.ts +55 -0
  191. package/src/elements/register.ts +17 -51
  192. package/theme.css +4 -2
  193. package/src/components/artifact.stories.tsx +0 -138
  194. package/src/components/attachments.stories.tsx +0 -303
  195. package/src/components/attachments.test.tsx +0 -64
  196. package/src/components/chain-of-thought.stories.tsx +0 -211
  197. package/src/components/chat-container.stories.tsx +0 -187
  198. package/src/components/chat-thread.test.tsx +0 -58
  199. package/src/components/checkpoint.stories.tsx +0 -102
  200. package/src/components/code-block.stories.tsx +0 -150
  201. package/src/components/confirm-card.stories.tsx +0 -74
  202. package/src/components/context.stories.tsx +0 -229
  203. package/src/components/context.test.tsx +0 -133
  204. package/src/components/conversation-item.stories.tsx +0 -125
  205. package/src/components/conversation-list.stories.tsx +0 -133
  206. package/src/components/default-input.test.tsx +0 -111
  207. package/src/components/empty.stories.tsx +0 -434
  208. package/src/components/feedback-bar.stories.tsx +0 -138
  209. package/src/components/feedback-bar.test.tsx +0 -103
  210. package/src/components/file-tree.stories.tsx +0 -73
  211. package/src/components/file-upload.stories.tsx +0 -156
  212. package/src/components/image.stories.tsx +0 -89
  213. package/src/components/loader.stories.tsx +0 -181
  214. package/src/components/markdown.stories.tsx +0 -180
  215. package/src/components/message-action-bar.test.tsx +0 -128
  216. package/src/components/message-narrow.stories.tsx +0 -329
  217. package/src/components/message-skills.stories.tsx +0 -211
  218. package/src/components/message.stories.tsx +0 -281
  219. package/src/components/model-switcher.stories.tsx +0 -123
  220. package/src/components/model-switcher.test.tsx +0 -65
  221. package/src/components/prompt-input.stories.tsx +0 -222
  222. package/src/components/prompt-suggestion.stories.tsx +0 -142
  223. package/src/components/reasoning.stories.tsx +0 -140
  224. package/src/components/resizable.test.tsx +0 -226
  225. package/src/components/scroll-button.stories.tsx +0 -100
  226. package/src/components/slash-command.stories.tsx +0 -163
  227. package/src/components/source-list.test.tsx +0 -152
  228. package/src/components/source.stories.tsx +0 -124
  229. package/src/components/tasks-card.stories.tsx +0 -78
  230. package/src/components/text-shimmer.stories.tsx +0 -87
  231. package/src/components/thinking-bar.stories.tsx +0 -87
  232. package/src/components/tool.stories.tsx +0 -153
  233. package/src/components/voice-input.stories.tsx +0 -83
  234. package/src/elements/artifact.stories.tsx +0 -506
  235. package/src/elements/attachments.stories.tsx +0 -190
  236. package/src/elements/card.stories.tsx +0 -113
  237. package/src/elements/cards.stories.tsx +0 -59
  238. package/src/elements/catalog.stories.tsx +0 -491
  239. package/src/elements/chain-of-thought.declarative.test.tsx +0 -153
  240. package/src/elements/chain-of-thought.stories.tsx +0 -113
  241. package/src/elements/chat-scope-picker.stories.tsx +0 -73
  242. package/src/elements/chat-workspace.stories.tsx +0 -288
  243. package/src/elements/chat.stories.tsx +0 -151
  244. package/src/elements/checkpoint.stories.tsx +0 -72
  245. package/src/elements/choice.stories.tsx +0 -240
  246. package/src/elements/code-block.stories.tsx +0 -83
  247. package/src/elements/composed-shell.stories.tsx +0 -316
  248. package/src/elements/confirm-card.stories.tsx +0 -227
  249. package/src/elements/context-meter.stories.tsx +0 -151
  250. package/src/elements/conversation-list.declarative.test.tsx +0 -137
  251. package/src/elements/conversation-list.stories.tsx +0 -243
  252. package/src/elements/embed.stories.tsx +0 -213
  253. package/src/elements/empty.stories.tsx +0 -111
  254. package/src/elements/feedback-bar.stories.tsx +0 -114
  255. package/src/elements/file-tree.stories.tsx +0 -134
  256. package/src/elements/file-upload.stories.tsx +0 -82
  257. package/src/elements/form.stories.tsx +0 -248
  258. package/src/elements/image.stories.tsx +0 -71
  259. package/src/elements/link-preview.stories.tsx +0 -209
  260. package/src/elements/loader.stories.tsx +0 -88
  261. package/src/elements/markdown.stories.tsx +0 -76
  262. package/src/elements/message-skills.declarative.test.tsx +0 -104
  263. package/src/elements/message-skills.stories.tsx +0 -114
  264. package/src/elements/message.stories.tsx +0 -218
  265. package/src/elements/model-switcher.declarative.test.tsx +0 -130
  266. package/src/elements/model-switcher.stories.tsx +0 -198
  267. package/src/elements/popover.stories.tsx +0 -80
  268. package/src/elements/prompt-input-slash-command.test.tsx +0 -128
  269. package/src/elements/prompt-input-stoppable.test.tsx +0 -88
  270. package/src/elements/prompt-input-toolbar-actions.test.tsx +0 -120
  271. package/src/elements/prompt-input.stories.tsx +0 -331
  272. package/src/elements/prompt-suggestions.declarative.test.tsx +0 -164
  273. package/src/elements/prompt-suggestions.stories.tsx +0 -213
  274. package/src/elements/reasoning.stories.tsx +0 -77
  275. package/src/elements/remote.stories.tsx +0 -314
  276. package/src/elements/resizable.stories.tsx +0 -426
  277. package/src/elements/response-stream.stories.tsx +0 -79
  278. package/src/elements/scroll-button.stories.tsx +0 -202
  279. package/src/elements/scroll-button.test.tsx +0 -148
  280. package/src/elements/source-list.stories.tsx +0 -143
  281. package/src/elements/source.stories.tsx +0 -88
  282. package/src/elements/switch.stories.tsx +0 -56
  283. package/src/elements/tasks.stories.tsx +0 -237
  284. package/src/elements/text-shimmer.stories.tsx +0 -64
  285. package/src/elements/thinking-bar.stories.tsx +0 -72
  286. package/src/elements/tool.stories.tsx +0 -89
  287. package/src/elements/voice-input.stories.tsx +0 -88
  288. package/src/primitives/controllable.test.ts +0 -47
  289. package/src/stories/chat-panel-layout.stories.tsx +0 -145
  290. package/src/stories/chat-scene.tsx +0 -571
  291. package/src/stories/checkpoint-restore.stories.tsx +0 -256
  292. package/src/stories/context-usage.stories.tsx +0 -212
  293. package/src/stories/conversation-with-reasoning.stories.tsx +0 -182
  294. package/src/stories/conversation-with-sources.stories.tsx +0 -471
  295. package/src/stories/docs/Accessibility.mdx +0 -119
  296. package/src/stories/docs/ChildElements.mdx +0 -269
  297. package/src/stories/docs/ForAIAgents.mdx +0 -162
  298. package/src/stories/docs/GettingStarted.mdx +0 -65
  299. package/src/stories/docs/Installation.mdx +0 -83
  300. package/src/stories/docs/Introduction.mdx +0 -50
  301. package/src/stories/docs/SolidJsAdvanced.mdx +0 -17
  302. package/src/stories/docs/Theming.mdx +0 -85
  303. package/src/stories/docs/element-controls.ts +0 -121
  304. package/src/stories/docs/frameworks/Angular.mdx +0 -245
  305. package/src/stories/docs/frameworks/Html.mdx +0 -227
  306. package/src/stories/docs/frameworks/Overview.mdx +0 -47
  307. package/src/stories/docs/frameworks/React.mdx +0 -227
  308. package/src/stories/docs/frameworks/Solid.mdx +0 -173
  309. package/src/stories/docs/frameworks/Svelte.mdx +0 -194
  310. package/src/stories/docs/frameworks/Vue.mdx +0 -238
  311. package/src/stories/docs/generative-ui-overview.mdx +0 -186
  312. package/src/stories/docs/recipes/SpeechToText.mdx +0 -7
  313. package/src/stories/docs/recipes/Streaming.mdx +0 -68
  314. package/src/stories/docs/recipes/TextToSpeech.mdx +0 -35
  315. package/src/stories/docs/theme-editor/canvas.tsx +0 -32
  316. package/src/stories/docs/theme-editor/inspector.tsx +0 -66
  317. package/src/stories/docs/theme-editor/presets.test.ts +0 -32
  318. package/src/stories/docs/theme-editor/presets.ts +0 -64
  319. package/src/stories/docs/theme-editor/theme-css.test.ts +0 -19
  320. package/src/stories/docs/theme-editor/theme-css.ts +0 -15
  321. package/src/stories/docs/theme-editor/theme-editor.tsx +0 -146
  322. package/src/stories/docs/theme-tokens.tsx +0 -174
  323. package/src/stories/examples/ChoosingComponents.mdx +0 -106
  324. package/src/stories/examples/sample-data.ts +0 -79
  325. package/src/stories/examples/usage/checkpoint-restore.ts +0 -156
  326. package/src/stories/examples/usage/context-usage.ts +0 -591
  327. package/src/stories/examples/usage/conversation-with-reasoning.ts +0 -224
  328. package/src/stories/examples/usage/conversation-with-sources.ts +0 -589
  329. package/src/stories/examples/usage/empty-state.ts +0 -144
  330. package/src/stories/examples/usage/full-chat-app.ts +0 -277
  331. package/src/stories/examples/usage/index.ts +0 -63
  332. package/src/stories/examples/usage/message-actions.ts +0 -704
  333. package/src/stories/examples/usage/pattern-centered-conversation.ts +0 -446
  334. package/src/stories/examples/usage/pattern-chat-panel-layout.ts +0 -442
  335. package/src/stories/examples/usage/pattern-docked-widget.ts +0 -479
  336. package/src/stories/examples/usage/prompt-input-variants.ts +0 -1356
  337. package/src/stories/examples/usage/streaming-response.ts +0 -687
  338. package/src/stories/examples/usage/types.ts +0 -33
  339. package/src/stories/full-chat.stories.tsx +0 -18
  340. package/src/stories/message-actions.stories.tsx +0 -230
  341. package/src/stories/pattern-centered-conversation.stories.tsx +0 -93
  342. package/src/stories/pattern-docked-widget.stories.tsx +0 -93
  343. package/src/stories/pattern-empty-state.stories.tsx +0 -76
  344. package/src/stories/prompt-input-variants.stories.tsx +0 -456
  345. package/src/stories/streaming-response.stories.tsx +0 -438
  346. package/src/stories/theme-editor.stories.tsx +0 -16
  347. package/src/stories/token-reference.stories.tsx +0 -18
  348. package/src/stories/typography.stories.tsx +0 -78
  349. package/src/ui/avatar.stories.tsx +0 -103
  350. package/src/ui/badge.stories.tsx +0 -86
  351. package/src/ui/button.stories.tsx +0 -145
  352. package/src/ui/collapsible.stories.tsx +0 -69
  353. package/src/ui/dropdown.stories.tsx +0 -59
  354. package/src/ui/hover-card.stories.tsx +0 -77
  355. package/src/ui/hover-card.test.tsx +0 -30
  356. package/src/ui/overlay.stories.tsx +0 -115
  357. package/src/ui/popover.stories.tsx +0 -81
  358. package/src/ui/popover.test.tsx +0 -99
  359. package/src/ui/resizable.stories.tsx +0 -236
  360. package/src/ui/scroll-area.stories.tsx +0 -50
  361. package/src/ui/separator.stories.tsx +0 -81
  362. package/src/ui/skeleton.stories.tsx +0 -337
  363. package/src/ui/switch.stories.tsx +0 -51
  364. package/src/ui/switch.test.tsx +0 -59
  365. package/src/ui/textarea.stories.tsx +0 -76
  366. 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;