@kitn.ai/ui 0.14.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 (370) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +394 -0
  3. package/dist/bash-InADTalH.js +1 -0
  4. package/dist/core-AYMC6_lb.js +12 -0
  5. package/dist/css-M7EaDHN_.js +1 -0
  6. package/dist/custom-elements.json +4739 -0
  7. package/dist/engine-javascript-vq0WuIJl.js +141 -0
  8. package/dist/github-dark-dimmed-DUshB20C.js +1 -0
  9. package/dist/github-light-JYsPkUQd.js +1 -0
  10. package/dist/host-embed.d.ts +33 -0
  11. package/dist/html-CPZ3oZQ7.js +1 -0
  12. package/dist/index.d.ts +2 -0
  13. package/dist/javascript-C25yR2R2.js +1 -0
  14. package/dist/json-DxJze_jm.js +1 -0
  15. package/dist/kitn-chat-provider.d.ts +2 -0
  16. package/dist/kitn-chat-provider.es.js +240 -0
  17. package/dist/kitn-chat.es.js +77 -0
  18. package/dist/llms/llms-full.txt +1018 -0
  19. package/dist/llms/llms.txt +104 -0
  20. package/dist/origin.d.ts +5 -0
  21. package/dist/provider-runtime.d.ts +27 -0
  22. package/dist/schemas/card-envelope.schema.json +14 -0
  23. package/dist/schemas/card-event.schema.json +12 -0
  24. package/dist/schemas/choice.schema.json +70 -0
  25. package/dist/schemas/confirm.schema.json +65 -0
  26. package/dist/schemas/embed.schema.json +65 -0
  27. package/dist/schemas/form.result.schema.json +7 -0
  28. package/dist/schemas/form.schema.json +33 -0
  29. package/dist/schemas/link.schema.json +56 -0
  30. package/dist/schemas/tasks.result.schema.json +16 -0
  31. package/dist/schemas/tasks.schema.json +78 -0
  32. package/dist/svelte--5p79yCD.js +1 -0
  33. package/dist/theme.tokens.css +176 -0
  34. package/dist/tsx-B8rCNbgL.js +1 -0
  35. package/dist/typescript-RycA9KXf.js +1 -0
  36. package/dist/validate.d.ts +4 -0
  37. package/dist/version.d.ts +4 -0
  38. package/dist/vue-BmIZj4XD.js +1 -0
  39. package/dist/wire.d.ts +53 -0
  40. package/frameworks/react/index.tsx +948 -0
  41. package/frameworks/react/runtime.tsx +94 -0
  42. package/llms-full.txt +1018 -0
  43. package/llms.txt +104 -0
  44. package/package.json +141 -0
  45. package/src/components/artifact.stories.tsx +138 -0
  46. package/src/components/artifact.tsx +743 -0
  47. package/src/components/attachments.stories.tsx +303 -0
  48. package/src/components/attachments.test.tsx +64 -0
  49. package/src/components/attachments.tsx +399 -0
  50. package/src/components/card-fallback.tsx +28 -0
  51. package/src/components/card-renderer.tsx +52 -0
  52. package/src/components/card.tsx +110 -0
  53. package/src/components/chain-of-thought.stories.tsx +211 -0
  54. package/src/components/chain-of-thought.tsx +139 -0
  55. package/src/components/chat-container.stories.tsx +187 -0
  56. package/src/components/chat-container.tsx +82 -0
  57. package/src/components/chat-scope-picker.tsx +47 -0
  58. package/src/components/chat-thread.test.tsx +58 -0
  59. package/src/components/chat-thread.tsx +249 -0
  60. package/src/components/checkpoint.stories.tsx +102 -0
  61. package/src/components/checkpoint.tsx +88 -0
  62. package/src/components/choice-card.tsx +569 -0
  63. package/src/components/code-block.stories.tsx +150 -0
  64. package/src/components/code-block.tsx +105 -0
  65. package/src/components/component-meta.json +3735 -0
  66. package/src/components/confirm-card.stories.tsx +74 -0
  67. package/src/components/confirm-card.tsx +315 -0
  68. package/src/components/context.stories.tsx +229 -0
  69. package/src/components/context.test.tsx +133 -0
  70. package/src/components/context.tsx +363 -0
  71. package/src/components/conversation-item.stories.tsx +125 -0
  72. package/src/components/conversation-item.tsx +16 -0
  73. package/src/components/conversation-list.stories.tsx +133 -0
  74. package/src/components/conversation-list.tsx +101 -0
  75. package/src/components/default-input.test.tsx +111 -0
  76. package/src/components/embed.tsx +196 -0
  77. package/src/components/empty.stories.tsx +434 -0
  78. package/src/components/empty.tsx +166 -0
  79. package/src/components/feedback-bar.stories.tsx +138 -0
  80. package/src/components/feedback-bar.test.tsx +103 -0
  81. package/src/components/feedback-bar.tsx +166 -0
  82. package/src/components/file-tree.stories.tsx +73 -0
  83. package/src/components/file-tree.tsx +383 -0
  84. package/src/components/file-upload.stories.tsx +156 -0
  85. package/src/components/file-upload.tsx +161 -0
  86. package/src/components/form-widgets.tsx +461 -0
  87. package/src/components/form.tsx +873 -0
  88. package/src/components/image.stories.tsx +89 -0
  89. package/src/components/image.tsx +67 -0
  90. package/src/components/link-preview.tsx +194 -0
  91. package/src/components/loader.stories.tsx +181 -0
  92. package/src/components/loader.tsx +333 -0
  93. package/src/components/markdown.stories.tsx +180 -0
  94. package/src/components/markdown.tsx +81 -0
  95. package/src/components/message-action-bar.test.tsx +128 -0
  96. package/src/components/message-narrow.stories.tsx +329 -0
  97. package/src/components/message-skills.stories.tsx +211 -0
  98. package/src/components/message-skills.tsx +36 -0
  99. package/src/components/message.stories.tsx +281 -0
  100. package/src/components/message.tsx +227 -0
  101. package/src/components/model-switcher.stories.tsx +123 -0
  102. package/src/components/model-switcher.test.tsx +65 -0
  103. package/src/components/model-switcher.tsx +87 -0
  104. package/src/components/prompt-input.stories.tsx +222 -0
  105. package/src/components/prompt-input.tsx +211 -0
  106. package/src/components/prompt-suggestion.stories.tsx +142 -0
  107. package/src/components/prompt-suggestion.tsx +115 -0
  108. package/src/components/reasoning.stories.tsx +140 -0
  109. package/src/components/reasoning.tsx +156 -0
  110. package/src/components/resizable.test.tsx +226 -0
  111. package/src/components/response-stream.tsx +103 -0
  112. package/src/components/scroll-button.stories.tsx +100 -0
  113. package/src/components/scroll-button.tsx +34 -0
  114. package/src/components/slash-command.stories.tsx +163 -0
  115. package/src/components/slash-command.tsx +232 -0
  116. package/src/components/source-list.test.tsx +152 -0
  117. package/src/components/source.stories.tsx +124 -0
  118. package/src/components/source.tsx +129 -0
  119. package/src/components/tasks-card.stories.tsx +78 -0
  120. package/src/components/tasks-card.tsx +432 -0
  121. package/src/components/text-shimmer.stories.tsx +87 -0
  122. package/src/components/text-shimmer.tsx +37 -0
  123. package/src/components/thinking-bar.stories.tsx +87 -0
  124. package/src/components/thinking-bar.tsx +50 -0
  125. package/src/components/tool.stories.tsx +153 -0
  126. package/src/components/tool.tsx +184 -0
  127. package/src/components/use-card-resolution.ts +28 -0
  128. package/src/components/voice-input.stories.tsx +83 -0
  129. package/src/components/voice-input.tsx +107 -0
  130. package/src/elements/artifact.stories.tsx +506 -0
  131. package/src/elements/artifact.tsx +137 -0
  132. package/src/elements/attachments.stories.tsx +190 -0
  133. package/src/elements/attachments.tsx +136 -0
  134. package/src/elements/card.stories.tsx +113 -0
  135. package/src/elements/card.tsx +40 -0
  136. package/src/elements/cards.stories.tsx +59 -0
  137. package/src/elements/cards.tsx +97 -0
  138. package/src/elements/catalog.stories.tsx +491 -0
  139. package/src/elements/chain-of-thought.declarative.test.tsx +153 -0
  140. package/src/elements/chain-of-thought.stories.tsx +113 -0
  141. package/src/elements/chain-of-thought.tsx +92 -0
  142. package/src/elements/chat-scope-picker.stories.tsx +73 -0
  143. package/src/elements/chat-scope-picker.tsx +36 -0
  144. package/src/elements/chat-types.ts +42 -0
  145. package/src/elements/chat-workspace.stories.tsx +288 -0
  146. package/src/elements/chat-workspace.tsx +161 -0
  147. package/src/elements/chat.stories.tsx +151 -0
  148. package/src/elements/chat.tsx +80 -0
  149. package/src/elements/checkpoint.stories.tsx +72 -0
  150. package/src/elements/checkpoint.tsx +47 -0
  151. package/src/elements/choice.stories.tsx +240 -0
  152. package/src/elements/choice.tsx +48 -0
  153. package/src/elements/code-block.stories.tsx +83 -0
  154. package/src/elements/code-block.tsx +42 -0
  155. package/src/elements/compiled.css +2 -0
  156. package/src/elements/composed-shell.stories.tsx +316 -0
  157. package/src/elements/confirm-card.stories.tsx +227 -0
  158. package/src/elements/confirm-card.tsx +51 -0
  159. package/src/elements/context-meter.stories.tsx +151 -0
  160. package/src/elements/context-meter.tsx +121 -0
  161. package/src/elements/conversation-list.declarative.test.tsx +137 -0
  162. package/src/elements/conversation-list.stories.tsx +243 -0
  163. package/src/elements/conversation-list.tsx +80 -0
  164. package/src/elements/css.ts +5 -0
  165. package/src/elements/default-input.tsx +247 -0
  166. package/src/elements/define.tsx +171 -0
  167. package/src/elements/element-meta.json +3314 -0
  168. package/src/elements/element-types.d.ts +710 -0
  169. package/src/elements/embed.stories.tsx +213 -0
  170. package/src/elements/embed.tsx +35 -0
  171. package/src/elements/empty.stories.tsx +111 -0
  172. package/src/elements/empty.tsx +29 -0
  173. package/src/elements/feedback-bar.stories.tsx +114 -0
  174. package/src/elements/feedback-bar.tsx +61 -0
  175. package/src/elements/file-tree.stories.tsx +134 -0
  176. package/src/elements/file-tree.tsx +52 -0
  177. package/src/elements/file-upload.stories.tsx +82 -0
  178. package/src/elements/file-upload.tsx +44 -0
  179. package/src/elements/form.stories.tsx +248 -0
  180. package/src/elements/form.tsx +43 -0
  181. package/src/elements/framework-usage.json +563 -0
  182. package/src/elements/image.stories.tsx +71 -0
  183. package/src/elements/image.tsx +32 -0
  184. package/src/elements/link-preview.stories.tsx +209 -0
  185. package/src/elements/link-preview.tsx +34 -0
  186. package/src/elements/loader.stories.tsx +88 -0
  187. package/src/elements/loader.tsx +25 -0
  188. package/src/elements/markdown.stories.tsx +76 -0
  189. package/src/elements/markdown.tsx +38 -0
  190. package/src/elements/message-skills.declarative.test.tsx +104 -0
  191. package/src/elements/message-skills.stories.tsx +114 -0
  192. package/src/elements/message-skills.tsx +85 -0
  193. package/src/elements/message.stories.tsx +218 -0
  194. package/src/elements/message.tsx +162 -0
  195. package/src/elements/model-switcher.declarative.test.tsx +130 -0
  196. package/src/elements/model-switcher.stories.tsx +198 -0
  197. package/src/elements/model-switcher.tsx +93 -0
  198. package/src/elements/popover.stories.tsx +80 -0
  199. package/src/elements/popover.tsx +59 -0
  200. package/src/elements/prompt-input-slash-command.test.tsx +128 -0
  201. package/src/elements/prompt-input-stoppable.test.tsx +88 -0
  202. package/src/elements/prompt-input-toolbar-actions.test.tsx +120 -0
  203. package/src/elements/prompt-input.stories.tsx +331 -0
  204. package/src/elements/prompt-input.tsx +185 -0
  205. package/src/elements/prompt-suggestions.declarative.test.tsx +164 -0
  206. package/src/elements/prompt-suggestions.stories.tsx +213 -0
  207. package/src/elements/prompt-suggestions.tsx +94 -0
  208. package/src/elements/reasoning.stories.tsx +77 -0
  209. package/src/elements/reasoning.tsx +50 -0
  210. package/src/elements/register.ts +56 -0
  211. package/src/elements/remote.stories.tsx +314 -0
  212. package/src/elements/remote.tsx +221 -0
  213. package/src/elements/resizable.d.ts +27 -0
  214. package/src/elements/resizable.stories.tsx +426 -0
  215. package/src/elements/resizable.tsx +553 -0
  216. package/src/elements/response-stream.stories.tsx +79 -0
  217. package/src/elements/response-stream.tsx +40 -0
  218. package/src/elements/scroll-button.stories.tsx +202 -0
  219. package/src/elements/scroll-button.test.tsx +148 -0
  220. package/src/elements/scroll-button.tsx +126 -0
  221. package/src/elements/source-list.stories.tsx +143 -0
  222. package/src/elements/source.stories.tsx +88 -0
  223. package/src/elements/source.tsx +120 -0
  224. package/src/elements/styles.css +199 -0
  225. package/src/elements/switch.stories.tsx +56 -0
  226. package/src/elements/switch.tsx +43 -0
  227. package/src/elements/tasks.stories.tsx +237 -0
  228. package/src/elements/tasks.tsx +46 -0
  229. package/src/elements/text-shimmer.stories.tsx +64 -0
  230. package/src/elements/text-shimmer.tsx +28 -0
  231. package/src/elements/thinking-bar.stories.tsx +72 -0
  232. package/src/elements/thinking-bar.tsx +34 -0
  233. package/src/elements/tool.stories.tsx +89 -0
  234. package/src/elements/tool.tsx +23 -0
  235. package/src/elements/voice-input.stories.tsx +88 -0
  236. package/src/elements/voice-input.tsx +41 -0
  237. package/src/index.ts +253 -0
  238. package/src/primitives/card-contract.ts +71 -0
  239. package/src/primitives/card-host.tsx +35 -0
  240. package/src/primitives/card-registry.tsx +67 -0
  241. package/src/primitives/card-resolution.ts +36 -0
  242. package/src/primitives/card-routing.ts +79 -0
  243. package/src/primitives/card-schemas/card-envelope.schema.json +14 -0
  244. package/src/primitives/card-schemas/card-event.schema.json +12 -0
  245. package/src/primitives/card-schemas/choice.schema.json +70 -0
  246. package/src/primitives/card-schemas/confirm.schema.json +65 -0
  247. package/src/primitives/card-schemas/embed.schema.json +65 -0
  248. package/src/primitives/card-schemas/form.result.schema.json +7 -0
  249. package/src/primitives/card-schemas/form.schema.json +33 -0
  250. package/src/primitives/card-schemas/link.schema.json +56 -0
  251. package/src/primitives/card-schemas/tasks.result.schema.json +16 -0
  252. package/src/primitives/card-schemas/tasks.schema.json +78 -0
  253. package/src/primitives/card-validate.ts +95 -0
  254. package/src/primitives/chat-config.tsx +76 -0
  255. package/src/primitives/controllable.test.ts +47 -0
  256. package/src/primitives/controllable.ts +21 -0
  257. package/src/primitives/embed-providers.ts +254 -0
  258. package/src/primitives/highlighter.ts +157 -0
  259. package/src/primitives/link-preview.ts +87 -0
  260. package/src/primitives/pdf-preview.ts +121 -0
  261. package/src/primitives/use-auto-resize.ts +31 -0
  262. package/src/primitives/use-resize-observer.ts +12 -0
  263. package/src/primitives/use-stick-to-bottom.ts +43 -0
  264. package/src/primitives/use-text-stream.ts +112 -0
  265. package/src/primitives/use-voice-recorder.ts +50 -0
  266. package/src/remote/host-embed.ts +345 -0
  267. package/src/remote/index.ts +2 -0
  268. package/src/remote/origin.ts +30 -0
  269. package/src/remote/provider-runtime.ts +259 -0
  270. package/src/remote/provider.ts +2 -0
  271. package/src/remote/validate.ts +22 -0
  272. package/src/remote/version.ts +12 -0
  273. package/src/remote/wire.ts +48 -0
  274. package/src/stories/chat-panel-layout.stories.tsx +145 -0
  275. package/src/stories/chat-scene.tsx +571 -0
  276. package/src/stories/checkpoint-restore.stories.tsx +256 -0
  277. package/src/stories/context-usage.stories.tsx +212 -0
  278. package/src/stories/conversation-with-reasoning.stories.tsx +182 -0
  279. package/src/stories/conversation-with-sources.stories.tsx +471 -0
  280. package/src/stories/docs/Accessibility.mdx +119 -0
  281. package/src/stories/docs/ChildElements.mdx +269 -0
  282. package/src/stories/docs/ForAIAgents.mdx +162 -0
  283. package/src/stories/docs/GettingStarted.mdx +65 -0
  284. package/src/stories/docs/Installation.mdx +83 -0
  285. package/src/stories/docs/Introduction.mdx +50 -0
  286. package/src/stories/docs/SolidJsAdvanced.mdx +17 -0
  287. package/src/stories/docs/Theming.mdx +85 -0
  288. package/src/stories/docs/element-controls.ts +121 -0
  289. package/src/stories/docs/frameworks/Angular.mdx +245 -0
  290. package/src/stories/docs/frameworks/Html.mdx +227 -0
  291. package/src/stories/docs/frameworks/Overview.mdx +47 -0
  292. package/src/stories/docs/frameworks/React.mdx +227 -0
  293. package/src/stories/docs/frameworks/Solid.mdx +173 -0
  294. package/src/stories/docs/frameworks/Svelte.mdx +194 -0
  295. package/src/stories/docs/frameworks/Vue.mdx +238 -0
  296. package/src/stories/docs/generative-ui-overview.mdx +186 -0
  297. package/src/stories/docs/recipes/SpeechToText.mdx +7 -0
  298. package/src/stories/docs/recipes/Streaming.mdx +68 -0
  299. package/src/stories/docs/recipes/TextToSpeech.mdx +35 -0
  300. package/src/stories/docs/theme-editor/canvas.tsx +32 -0
  301. package/src/stories/docs/theme-editor/inspector.tsx +66 -0
  302. package/src/stories/docs/theme-editor/presets.test.ts +32 -0
  303. package/src/stories/docs/theme-editor/presets.ts +64 -0
  304. package/src/stories/docs/theme-editor/theme-css.test.ts +19 -0
  305. package/src/stories/docs/theme-editor/theme-css.ts +15 -0
  306. package/src/stories/docs/theme-editor/theme-editor.tsx +146 -0
  307. package/src/stories/docs/theme-tokens.tsx +174 -0
  308. package/src/stories/examples/ChoosingComponents.mdx +106 -0
  309. package/src/stories/examples/sample-data.ts +79 -0
  310. package/src/stories/examples/usage/checkpoint-restore.ts +156 -0
  311. package/src/stories/examples/usage/context-usage.ts +591 -0
  312. package/src/stories/examples/usage/conversation-with-reasoning.ts +224 -0
  313. package/src/stories/examples/usage/conversation-with-sources.ts +589 -0
  314. package/src/stories/examples/usage/empty-state.ts +144 -0
  315. package/src/stories/examples/usage/full-chat-app.ts +277 -0
  316. package/src/stories/examples/usage/index.ts +63 -0
  317. package/src/stories/examples/usage/message-actions.ts +704 -0
  318. package/src/stories/examples/usage/pattern-centered-conversation.ts +446 -0
  319. package/src/stories/examples/usage/pattern-chat-panel-layout.ts +442 -0
  320. package/src/stories/examples/usage/pattern-docked-widget.ts +479 -0
  321. package/src/stories/examples/usage/prompt-input-variants.ts +1356 -0
  322. package/src/stories/examples/usage/streaming-response.ts +687 -0
  323. package/src/stories/examples/usage/types.ts +33 -0
  324. package/src/stories/full-chat.stories.tsx +18 -0
  325. package/src/stories/message-actions.stories.tsx +230 -0
  326. package/src/stories/pattern-centered-conversation.stories.tsx +93 -0
  327. package/src/stories/pattern-docked-widget.stories.tsx +93 -0
  328. package/src/stories/pattern-empty-state.stories.tsx +76 -0
  329. package/src/stories/prompt-input-variants.stories.tsx +456 -0
  330. package/src/stories/streaming-response.stories.tsx +438 -0
  331. package/src/stories/theme-editor.stories.tsx +16 -0
  332. package/src/stories/token-reference.stories.tsx +18 -0
  333. package/src/stories/typography.stories.tsx +78 -0
  334. package/src/types.ts +47 -0
  335. package/src/ui/action-icons.ts +52 -0
  336. package/src/ui/avatar.stories.tsx +103 -0
  337. package/src/ui/avatar.tsx +23 -0
  338. package/src/ui/badge.stories.tsx +86 -0
  339. package/src/ui/badge.tsx +21 -0
  340. package/src/ui/button.stories.tsx +145 -0
  341. package/src/ui/button.tsx +38 -0
  342. package/src/ui/collapsible.stories.tsx +69 -0
  343. package/src/ui/collapsible.tsx +125 -0
  344. package/src/ui/dropdown.stories.tsx +59 -0
  345. package/src/ui/dropdown.tsx +196 -0
  346. package/src/ui/hover-card.stories.tsx +77 -0
  347. package/src/ui/hover-card.test.tsx +30 -0
  348. package/src/ui/hover-card.tsx +172 -0
  349. package/src/ui/overlay.stories.tsx +115 -0
  350. package/src/ui/overlay.tsx +158 -0
  351. package/src/ui/popover.stories.tsx +81 -0
  352. package/src/ui/popover.test.tsx +99 -0
  353. package/src/ui/popover.tsx +92 -0
  354. package/src/ui/resizable.stories.tsx +236 -0
  355. package/src/ui/resizable.tsx +576 -0
  356. package/src/ui/scroll-area.stories.tsx +50 -0
  357. package/src/ui/scroll-area.tsx +15 -0
  358. package/src/ui/separator.stories.tsx +81 -0
  359. package/src/ui/separator.tsx +10 -0
  360. package/src/ui/skeleton.stories.tsx +337 -0
  361. package/src/ui/skeleton.tsx +16 -0
  362. package/src/ui/switch.stories.tsx +51 -0
  363. package/src/ui/switch.test.tsx +59 -0
  364. package/src/ui/switch.tsx +62 -0
  365. package/src/ui/textarea.stories.tsx +76 -0
  366. package/src/ui/textarea.tsx +21 -0
  367. package/src/ui/tooltip.stories.tsx +74 -0
  368. package/src/ui/tooltip.tsx +68 -0
  369. package/src/utils/cn.ts +24 -0
  370. package/theme.css +187 -0
package/src/stories/examples/usage/pattern-docked-widget.ts ADDED
@@ -0,0 +1,479 @@
1
+ import type { ExampleUsage, StoryUsage } from './types';
2
+
3
+ /**
4
+ * Support Assistant — a compact chat bubble docked to the bottom-right corner
5
+ * of the host page, absolutely positioned over any app content.
6
+ */
7
+ const supportAssistant: StoryUsage = {
8
+ intro:
9
+ 'Use **Docked Widget** for a support or assistant chat that floats over any page — the classic bottom-right widget. The widget is an absolutely-positioned card (`position:absolute; bottom:…; right:…`) layered over a relative-positioned host wrapper. Same `ChatContainer` + `Message` + `PromptInput` building blocks as the other patterns, just smaller (`proseSize="sm"`, compact padding) and sized to ~360 × 460 px. Shadow-DOM isolation means zero CSS bleed onto the host page.',
10
+ snippets: {
11
+ html: `<!-- Register the elements once (CDN or bundler) -->
12
+ <script type="module">
13
+ import 'https://cdn.jsdelivr.net/npm/@kitn.ai/ui/dist/kitn-chat.es.js';
14
+ </script>
15
+
16
+ <!--
17
+ Docked Widget — position this relative wrapper at the page / app root.
18
+ In production the host wrapper is typically <body> or a top-level <div>.
19
+ -->
20
+ <div class="relative" style="height:100dvh; overflow:hidden">
21
+
22
+ <!-- Your page content here -->
23
+ <main><!-- ... --></main>
24
+
25
+ <!-- Widget: absolutely docked to the bottom-right corner -->
26
+ <div id="chat-widget"
27
+ class="absolute bottom-5 right-5 flex flex-col overflow-hidden rounded-2xl border border-border bg-card shadow-xl"
28
+ style="width:360px; height:460px">
29
+
30
+ <!-- Widget header -->
31
+ <header class="flex flex-shrink-0 items-center justify-between border-b border-border px-4 py-3">
32
+ <div class="flex items-center gap-2">
33
+ <span class="size-2 rounded-full bg-green-500"></span>
34
+ <span class="text-sm font-semibold">Support</span>
35
+ </div>
36
+ <button aria-label="Close widget"><!-- × icon --></button>
37
+ </header>
38
+
39
+ <!-- Scrollable thread -->
40
+ <div class="relative flex-1 overflow-y-auto">
41
+ <kai-chat-container class="h-full">
42
+ <div class="space-y-3 px-3 py-3">
43
+
44
+ <!-- Assistant greeting -->
45
+ <kai-message>
46
+ <kai-message-avatar src="" alt="AI" fallback="AI"></kai-message-avatar>
47
+ <kai-message-content markdown class="bg-transparent p-0 pt-1">
48
+ Hi! 👋 How can I help you today?
49
+ </kai-message-content>
50
+ </kai-message>
51
+
52
+ <!-- User message -->
53
+ <kai-message class="flex-col items-end">
54
+ <kai-message-content class="bg-muted text-primary max-w-[85%] rounded-xl px-3.5 py-2">
55
+ How do I reset my password?
56
+ </kai-message-content>
57
+ </kai-message>
58
+
59
+ <!-- Assistant reply -->
60
+ <kai-message>
61
+ <kai-message-avatar src="" alt="AI" fallback="AI"></kai-message-avatar>
62
+ <kai-message-content markdown class="bg-transparent p-0 pt-1">
63
+ Head to **Settings → Security** and click **Reset password**.
64
+ </kai-message-content>
65
+ </kai-message>
66
+
67
+ </div>
68
+ </kai-chat-container>
69
+ </div>
70
+
71
+ <!-- Composer -->
72
+ <div class="flex-shrink-0 px-3 pb-3">
73
+ <kai-prompt-input id="widget-composer">
74
+ <kai-prompt-input-textarea placeholder="Message support…"></kai-prompt-input-textarea>
75
+ <kai-prompt-input-actions class="mt-1.5 flex w-full items-center justify-end gap-2 px-2.5 pb-2.5">
76
+ <button aria-label="Send"><!-- icon --></button>
77
+ </kai-prompt-input-actions>
78
+ </kai-prompt-input>
79
+ </div>
80
+ </div>
81
+
82
+ </div>
83
+
84
+ <script type="module">
85
+ document.getElementById('widget-composer').addEventListener('kai-submit', (e) => {
86
+ console.log('send', e.detail.value);
87
+ });
88
+ </script>`,
89
+
90
+ react: `import { useState } from 'react';
91
+ import {
92
+ ChatConfig, ChatContainer, ChatContainerContent, ChatContainerScrollAnchor,
93
+ Message, MessageAvatar, MessageContent,
94
+ PromptInput, PromptInputTextarea, PromptInputActions,
95
+ Button,
96
+ } from '@kitn.ai/ui/react';
97
+
98
+ /**
99
+ * Docked Widget — a compact chat bubble docked to the bottom-right of the page.
100
+ * Render this inside a relative-positioned root wrapper so the absolute
101
+ * positioning stays within your app boundary.
102
+ */
103
+ export function DockedWidget() {
104
+ const [input, setInput] = useState('');
105
+ const [open, setOpen] = useState(true);
106
+
107
+ if (!open) return null;
108
+
109
+ return (
110
+ <ChatConfig proseSize="sm">
111
+ {/* Widget: docked bottom-right — size to taste */}
112
+ <div
113
+ className="absolute bottom-5 right-5 flex flex-col overflow-hidden rounded-2xl border border-border bg-card shadow-xl"
114
+ style={{ width: 360, height: 460 }}
115
+ >
116
+ {/* Header */}
117
+ <header className="flex flex-shrink-0 items-center justify-between border-b border-border px-4 py-3">
118
+ <div className="flex items-center gap-2">
119
+ <span className="size-2 rounded-full bg-green-500" />
120
+ <span className="text-sm font-semibold">Support</span>
121
+ </div>
122
+ <Button variant="ghost" size="icon-sm" onClick={() => setOpen(false)} aria-label="Close">
123
+ {/* × icon */}
124
+ </Button>
125
+ </header>
126
+
127
+ {/* Scrollable thread */}
128
+ <div className="relative flex-1 overflow-y-auto">
129
+ <ChatContainer className="h-full">
130
+ <ChatContainerContent className="space-y-3 px-3 py-3">
131
+ <Message>
132
+ <MessageAvatar src="" alt="AI" fallback="AI" />
133
+ <MessageContent markdown className="bg-transparent p-0 pt-1">
134
+ Hi! 👋 How can I help you today?
135
+ </MessageContent>
136
+ </Message>
137
+ <Message className="flex-col items-end">
138
+ <MessageContent className="bg-muted text-primary max-w-[85%] rounded-xl px-3.5 py-2">
139
+ How do I reset my password?
140
+ </MessageContent>
141
+ </Message>
142
+ <Message>
143
+ <MessageAvatar src="" alt="AI" fallback="AI" />
144
+ <MessageContent markdown className="bg-transparent p-0 pt-1">
145
+ Head to **Settings → Security** and click **Reset password**.
146
+ </MessageContent>
147
+ </Message>
148
+ <ChatContainerScrollAnchor />
149
+ </ChatContainerContent>
150
+ </ChatContainer>
151
+ </div>
152
+
153
+ {/* Composer */}
154
+ <div className="flex-shrink-0 px-3 pb-3">
155
+ <PromptInput value={input} onValueChange={setInput} onSubmit={() => setInput('')}>
156
+ <PromptInputTextarea placeholder="Message support…" className="min-h-[40px] pt-2.5 pl-3.5" />
157
+ <PromptInputActions className="mt-1.5 flex w-full items-center justify-end gap-2 px-2.5 pb-2.5">
158
+ <Button size="icon-sm" className="rounded-full" disabled={!input.trim()} aria-label="Send">
159
+ {/* icon */}
160
+ </Button>
161
+ </PromptInputActions>
162
+ </PromptInput>
163
+ </div>
164
+ </div>
165
+ </ChatConfig>
166
+ );
167
+ }`,
168
+
169
+ vue: `<script setup>
170
+ import '@kitn.ai/ui/elements';
171
+ import { ref } from 'vue';
172
+
173
+ const input = ref('');
174
+ const open = ref(true);
175
+
176
+ function onSubmit(e) {
177
+ console.log('send', e.detail.value);
178
+ input.value = '';
179
+ }
180
+ </script>
181
+
182
+ <!--
183
+ Docked Widget — render inside a relative-positioned root.
184
+ The widget is absolutely positioned to the bottom-right corner.
185
+ -->
186
+ <template>
187
+ <div v-if="open"
188
+ class="absolute bottom-5 right-5 flex flex-col overflow-hidden rounded-2xl border border-border bg-card shadow-xl"
189
+ style="width:360px; height:460px">
190
+
191
+ <!-- Header -->
192
+ <header class="flex flex-shrink-0 items-center justify-between border-b border-border px-4 py-3">
193
+ <div class="flex items-center gap-2">
194
+ <span class="size-2 rounded-full bg-green-500"></span>
195
+ <span class="text-sm font-semibold">Support</span>
196
+ </div>
197
+ <button @click="open = false" aria-label="Close"><!-- × --></button>
198
+ </header>
199
+
200
+ <!-- Scrollable thread -->
201
+ <div class="relative flex-1 overflow-y-auto">
202
+ <kai-chat-container class="h-full">
203
+ <div class="space-y-3 px-3 py-3">
204
+ <kai-message>
205
+ <kai-message-avatar src="" alt="AI" fallback="AI"></kai-message-avatar>
206
+ <kai-message-content markdown class="bg-transparent p-0 pt-1">
207
+ Hi! 👋 How can I help you today?
208
+ </kai-message-content>
209
+ </kai-message>
210
+ <kai-message class="flex-col items-end">
211
+ <kai-message-content class="bg-muted text-primary max-w-[85%] rounded-xl px-3.5 py-2">
212
+ How do I reset my password?
213
+ </kai-message-content>
214
+ </kai-message>
215
+ <kai-message>
216
+ <kai-message-avatar src="" alt="AI" fallback="AI"></kai-message-avatar>
217
+ <kai-message-content markdown class="bg-transparent p-0 pt-1">
218
+ Head to **Settings → Security** and click **Reset password**.
219
+ </kai-message-content>
220
+ </kai-message>
221
+ </div>
222
+ </kai-chat-container>
223
+ </div>
224
+
225
+ <!-- Composer -->
226
+ <div class="flex-shrink-0 px-3 pb-3">
227
+ <kai-prompt-input
228
+ :value="input"
229
+ @kai-value-change="input = $event.detail.value"
230
+ @kai-submit="onSubmit"
231
+ >
232
+ <kai-prompt-input-textarea placeholder="Message support…"></kai-prompt-input-textarea>
233
+ <kai-prompt-input-actions class="mt-1.5 flex w-full items-center justify-end gap-2 px-2.5 pb-2.5">
234
+ <button :disabled="!input.trim()" aria-label="Send"><!-- icon --></button>
235
+ </kai-prompt-input-actions>
236
+ </kai-prompt-input>
237
+ </div>
238
+
239
+ </div>
240
+ </template>`,
241
+
242
+ svelte: `<script>
243
+ import '@kitn.ai/ui/elements';
244
+ let input = '';
245
+ let open = true;
246
+ </script>
247
+
248
+ <!--
249
+ Docked Widget — render inside a relative-positioned root.
250
+ The widget is absolutely positioned to the bottom-right corner.
251
+ -->
252
+ {#if open}
253
+ <div class="absolute bottom-5 right-5 flex flex-col overflow-hidden rounded-2xl border border-border bg-card shadow-xl"
254
+ style="width:360px; height:460px">
255
+
256
+ <!-- Header -->
257
+ <header class="flex flex-shrink-0 items-center justify-between border-b border-border px-4 py-3">
258
+ <div class="flex items-center gap-2">
259
+ <span class="size-2 rounded-full bg-green-500"></span>
260
+ <span class="text-sm font-semibold">Support</span>
261
+ </div>
262
+ <button on:click={() => (open = false)} aria-label="Close"><!-- × --></button>
263
+ </header>
264
+
265
+ <!-- Scrollable thread -->
266
+ <div class="relative flex-1 overflow-y-auto">
267
+ <kai-chat-container class="h-full">
268
+ <div class="space-y-3 px-3 py-3">
269
+ <kai-message>
270
+ <kai-message-avatar src="" alt="AI" fallback="AI"></kai-message-avatar>
271
+ <kai-message-content markdown class="bg-transparent p-0 pt-1">
272
+ Hi! 👋 How can I help you today?
273
+ </kai-message-content>
274
+ </kai-message>
275
+ <kai-message class="flex-col items-end">
276
+ <kai-message-content class="bg-muted text-primary max-w-[85%] rounded-xl px-3.5 py-2">
277
+ How do I reset my password?
278
+ </kai-message-content>
279
+ </kai-message>
280
+ <kai-message>
281
+ <kai-message-avatar src="" alt="AI" fallback="AI"></kai-message-avatar>
282
+ <kai-message-content markdown class="bg-transparent p-0 pt-1">
283
+ Head to **Settings → Security** and click **Reset password**.
284
+ </kai-message-content>
285
+ </kai-message>
286
+ </div>
287
+ </kai-chat-container>
288
+ </div>
289
+
290
+ <!-- Composer -->
291
+ <div class="flex-shrink-0 px-3 pb-3">
292
+ <kai-prompt-input
293
+ value={input}
294
+ on:kai-value-change={(e) => (input = e.detail.value)}
295
+ on:kai-submit={() => (input = '')}
296
+ >
297
+ <kai-prompt-input-textarea placeholder="Message support…"></kai-prompt-input-textarea>
298
+ <kai-prompt-input-actions class="mt-1.5 flex w-full items-center justify-end gap-2 px-2.5 pb-2.5">
299
+ <button disabled={!input.trim()} aria-label="Send"><!-- icon --></button>
300
+ </kai-prompt-input-actions>
301
+ </kai-prompt-input>
302
+ </div>
303
+
304
+ </div>
305
+ {/if}`,
306
+
307
+ angular: `// main.ts: import '@kitn.ai/ui/elements' before bootstrapApplication,
308
+ // and add CUSTOM_ELEMENTS_SCHEMA to the component.
309
+ import { Component, CUSTOM_ELEMENTS_SCHEMA } from '@angular/core';
310
+ import { NgIf } from '@angular/common';
311
+
312
+ /**
313
+ * Docked Widget — a compact chat bubble docked to the bottom-right.
314
+ * Render inside a relative-positioned host so absolute positioning works.
315
+ */
316
+ @Component({
317
+ selector: 'app-docked-widget',
318
+ standalone: true,
319
+ imports: [NgIf],
320
+ schemas: [CUSTOM_ELEMENTS_SCHEMA],
321
+ styles: [':host { display: contents; }'],
322
+ template: \`
323
+ <div *ngIf="open"
324
+ class="absolute bottom-5 right-5 flex flex-col overflow-hidden rounded-2xl border border-border bg-card shadow-xl"
325
+ style="width:360px; height:460px">
326
+
327
+ <!-- Header -->
328
+ <header class="flex flex-shrink-0 items-center justify-between border-b border-border px-4 py-3">
329
+ <div class="flex items-center gap-2">
330
+ <span class="size-2 rounded-full bg-green-500"></span>
331
+ <span class="text-sm font-semibold">Support</span>
332
+ </div>
333
+ <button (click)="open = false" aria-label="Close"><!-- × --></button>
334
+ </header>
335
+
336
+ <!-- Scrollable thread -->
337
+ <div class="relative flex-1 overflow-y-auto">
338
+ <kai-chat-container class="h-full">
339
+ <div class="space-y-3 px-3 py-3">
340
+ <kai-message>
341
+ <kai-message-avatar src="" alt="AI" fallback="AI"></kai-message-avatar>
342
+ <kai-message-content markdown class="bg-transparent p-0 pt-1">
343
+ Hi! How can I help you today?
344
+ </kai-message-content>
345
+ </kai-message>
346
+ <kai-message class="flex-col items-end">
347
+ <kai-message-content class="bg-muted text-primary max-w-[85%] rounded-xl px-3.5 py-2">
348
+ How do I reset my password?
349
+ </kai-message-content>
350
+ </kai-message>
351
+ <kai-message>
352
+ <kai-message-avatar src="" alt="AI" fallback="AI"></kai-message-avatar>
353
+ <kai-message-content markdown class="bg-transparent p-0 pt-1">
354
+ Head to **Settings → Security** and click **Reset password**.
355
+ </kai-message-content>
356
+ </kai-message>
357
+ </div>
358
+ </kai-chat-container>
359
+ </div>
360
+
361
+ <!-- Composer -->
362
+ <div class="flex-shrink-0 px-3 pb-3">
363
+ <kai-prompt-input
364
+ [value]="input"
365
+ (kai-value-change)="input = $event.detail.value"
366
+ (kai-submit)="input = ''"
367
+ >
368
+ <kai-prompt-input-textarea placeholder="Message support…"></kai-prompt-input-textarea>
369
+ <kai-prompt-input-actions class="mt-1.5 flex w-full items-center justify-end gap-2 px-2.5 pb-2.5">
370
+ <button [disabled]="!input.trim()" aria-label="Send"><!-- icon --></button>
371
+ </kai-prompt-input-actions>
372
+ </kai-prompt-input>
373
+ </div>
374
+
375
+ </div>
376
+ \`,
377
+ })
378
+ export class DockedWidgetComponent {
379
+ open = true;
380
+ input = '';
381
+ }`,
382
+
383
+ solid: `import { createSignal } from 'solid-js';
384
+ import {
385
+ ChatConfig, ChatContainer, ChatContainerContent, ChatContainerScrollAnchor,
386
+ Message, MessageAvatar, MessageContent,
387
+ PromptInput, PromptInputTextarea, PromptInputActions,
388
+ Button,
389
+ } from '@kitn.ai/ui';
390
+ import { ArrowUp, X } from 'lucide-solid';
391
+
392
+ /**
393
+ * Docked Widget — a compact support assistant docked to the bottom-right.
394
+ * Render this inside a relative-positioned host element.
395
+ * proseSize="sm" gives tighter line-heights suitable for the compact size.
396
+ */
397
+ export function DockedWidget() {
398
+ const [input, setInput] = createSignal('');
399
+ const [open, setOpen] = createSignal(true);
400
+
401
+ return (
402
+ <ChatConfig proseSize="sm">
403
+ {/* Widget: absolutely docked — size to taste */}
404
+ <div
405
+ style={{ width: '360px', height: '460px' }}
406
+ class="absolute bottom-5 right-5 flex flex-col overflow-hidden rounded-2xl border border-border bg-card shadow-xl"
407
+ >
408
+ {/* Header */}
409
+ <header class="flex shrink-0 items-center justify-between border-b border-border px-4 py-3">
410
+ <div class="flex items-center gap-2">
411
+ <span class="size-2 rounded-full bg-green-500" />
412
+ <span class="text-sm font-semibold text-foreground">Support</span>
413
+ </div>
414
+ <Button variant="ghost" size="icon-sm" onClick={() => setOpen(false)} aria-label="Close">
415
+ <X class="size-4" />
416
+ </Button>
417
+ </header>
418
+
419
+ {/* Scrollable thread */}
420
+ <div class="relative flex-1 overflow-y-auto">
421
+ <ChatContainer class="h-full">
422
+ <ChatContainerContent class="space-y-3 px-3 py-3">
423
+ <Message>
424
+ <MessageAvatar src="" alt="AI" fallback="AI" />
425
+ <MessageContent markdown class="bg-transparent p-0 pt-1">
426
+ Hi! 👋 How can I help you today?
427
+ </MessageContent>
428
+ </Message>
429
+ <Message class="flex-col items-end">
430
+ <MessageContent class="bg-muted text-primary max-w-[85%] rounded-xl px-3.5 py-2">
431
+ How do I reset my password?
432
+ </MessageContent>
433
+ </Message>
434
+ <Message>
435
+ <MessageAvatar src="" alt="AI" fallback="AI" />
436
+ <MessageContent markdown class="bg-transparent p-0 pt-1">
437
+ Head to **Settings → Security** and click **Reset password**.
438
+ </MessageContent>
439
+ </Message>
440
+ <ChatContainerScrollAnchor />
441
+ </ChatContainerContent>
442
+ </ChatContainer>
443
+ </div>
444
+
445
+ {/* Composer */}
446
+ <div class="shrink-0 px-3 pb-3">
447
+ <PromptInput value={input()} onValueChange={setInput} onSubmit={() => setInput('')}>
448
+ <PromptInputTextarea placeholder="Message support…" class="min-h-[40px] pt-2.5 pl-3.5" />
449
+ <PromptInputActions class="mt-1.5 flex w-full items-center justify-end gap-2 px-2.5 pb-2.5">
450
+ <Button size="icon-sm" class="rounded-full" disabled={!input().trim()} aria-label="Send message">
451
+ <ArrowUp class="size-4" />
452
+ </Button>
453
+ </PromptInputActions>
454
+ </PromptInput>
455
+ </div>
456
+ </div>
457
+ </ChatConfig>
458
+ );
459
+ }`,
460
+ },
461
+ };
462
+
463
+ /**
464
+ * Pattern: Docked Widget — a compact floating assistant docked to the
465
+ * bottom-right corner of the host page. Same building blocks as the other
466
+ * patterns (`ChatContainer` + `Message` + `PromptInput`) at compact sizing;
467
+ * absolutely positioned over the host so zero CSS bleed. Per-story: the Usage
468
+ * tab shows the snippet for the story you're on; the example-level fields below
469
+ * are the fallback.
470
+ */
471
+ const dockedWidget: ExampleUsage = {
472
+ title: 'Patterns/Docked Widget',
473
+ ...supportAssistant,
474
+ stories: {
475
+ 'Support Assistant': supportAssistant,
476
+ },
477
+ };
478
+
479
+ export default dockedWidget;