@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-centered-conversation.ts ADDED
@@ -0,0 +1,446 @@
1
+ import type { ExampleUsage, StoryUsage } from './types';
2
+
3
+ /**
4
+ * Focused — full-window, single-column reading layout (Claude.ai-style).
5
+ * A `max-w` measure centered in the viewport; user messages right-aligned,
6
+ * assistant messages left-aligned, composer pinned below.
7
+ */
8
+ const focused: StoryUsage = {
9
+ intro:
10
+ 'Use **Centered Conversation** for a full-window, distraction-free chat — the Claude.ai layout. A `max-w` reading column is centered in the viewport: user messages align right inside pill bubbles, assistant responses align left with markdown + hover action bar, and the `PromptInput` composer is pinned to the bottom, also constrained to the same max-width. Prefer this over the Chat Panel Layout when the chat *is* the page, not a widget embedded inside one.',
11
+ snippets: {
12
+ html: `<!-- Register the elements once (CDN or bundler) -->
13
+ <script type="module">
14
+ import 'https://cdn.jsdelivr.net/npm/@kitn.ai/ui/dist/kitn-chat.es.js';
15
+ </script>
16
+
17
+ <!-- Outer shell: full-height flex column, rounded card for demo; in
18
+ production this is typically the <body> / a top-level <main>. -->
19
+ <div class="flex flex-col overflow-hidden bg-background" style="height:100dvh">
20
+
21
+ <!-- Optional header (model switcher, title, etc.) -->
22
+ <header class="flex h-14 shrink-0 items-center justify-between border-b px-5">
23
+ <span class="text-sm font-semibold">New conversation</span>
24
+ </header>
25
+
26
+ <!-- Scrollable message area -->
27
+ <kai-chat-container id="thread" class="relative flex-1 overflow-y-auto">
28
+ <div class="space-y-6 px-5 py-6">
29
+
30
+ <!-- User message: right-aligned pill bubble -->
31
+ <kai-message class="mx-auto flex w-full max-w-2xl flex-col items-end">
32
+ <kai-message-content
33
+ class="bg-muted text-primary max-w-[85%] rounded-3xl px-5 py-2.5"
34
+ >Why is SolidJS reactivity fast?</kai-message-content>
35
+ </kai-message>
36
+
37
+ <!-- Assistant message: left-aligned, markdown prose + hover actions -->
38
+ <kai-message class="mx-auto flex w-full max-w-2xl flex-col items-start">
39
+ <div class="group flex w-full flex-col">
40
+ <kai-message-content markdown class="bg-transparent p-0 text-foreground">
41
+ Signals are fine-grained — only the DOM nodes that read a signal update.
42
+ </kai-message-content>
43
+ <kai-message-actions class="-ml-2.5 flex gap-0 opacity-0 transition-opacity group-hover:opacity-100">
44
+ <button aria-label="Copy message"><!-- icon --></button>
45
+ <button aria-label="Good response"><!-- icon --></button>
46
+ </kai-message-actions>
47
+ </div>
48
+ </kai-message>
49
+
50
+ </div>
51
+ </kai-chat-container>
52
+
53
+ <!-- Composer: same max-width as messages, pinned to bottom -->
54
+ <div class="shrink-0 px-5 pb-5">
55
+ <div class="mx-auto max-w-2xl">
56
+ <kai-prompt-input id="composer">
57
+ <kai-prompt-input-textarea placeholder="Reply…"></kai-prompt-input-textarea>
58
+ <kai-prompt-input-actions class="mt-2 flex w-full items-center justify-end gap-2 px-3 pb-3">
59
+ <button aria-label="Send message"><!-- icon --></button>
60
+ </kai-prompt-input-actions>
61
+ </kai-prompt-input>
62
+ </div>
63
+ </div>
64
+ </div>
65
+
66
+ <script type="module">
67
+ document.getElementById('composer').addEventListener('kai-submit', (e) => {
68
+ console.log('send', e.detail.value);
69
+ });
70
+ </script>`,
71
+
72
+ react: `import { useState } from 'react';
73
+ import {
74
+ ChatConfig, ChatContainer, ChatContainerContent, ChatContainerScrollAnchor,
75
+ Message, MessageContent, MessageActions,
76
+ PromptInput, PromptInputTextarea, PromptInputActions,
77
+ Button,
78
+ } from '@kitn.ai/ui/react';
79
+
80
+ /**
81
+ * Centered Conversation — full-window single reading column.
82
+ * User messages right-aligned; assistant messages left-aligned with
83
+ * markdown + hover actions. Composer constrained to the same max-width.
84
+ */
85
+ export function CenteredConversation() {
86
+ const [input, setInput] = useState('');
87
+
88
+ return (
89
+ <ChatConfig proseSize="base">
90
+ <div className="flex h-dvh flex-col overflow-hidden bg-background">
91
+ {/* Optional header */}
92
+ <header className="flex h-14 shrink-0 items-center border-b px-5">
93
+ <span className="text-sm font-semibold">New conversation</span>
94
+ </header>
95
+
96
+ {/* Scrollable thread */}
97
+ <div className="relative flex-1 overflow-y-auto">
98
+ <ChatContainer className="h-full">
99
+ <ChatContainerContent className="space-y-6 px-5 py-6">
100
+ {/* User message — right-aligned bubble */}
101
+ <Message className="mx-auto flex w-full max-w-2xl flex-col items-end">
102
+ <MessageContent className="bg-muted text-primary max-w-[85%] rounded-3xl px-5 py-2.5">
103
+ Why is SolidJS reactivity fast?
104
+ </MessageContent>
105
+ </Message>
106
+
107
+ {/* Assistant message — left-aligned with hover actions */}
108
+ <Message className="mx-auto flex w-full max-w-2xl flex-col items-start">
109
+ <div className="group flex w-full flex-col">
110
+ <MessageContent markdown className="bg-transparent p-0 text-foreground">
111
+ Signals are fine-grained — only the DOM nodes that read a signal update.
112
+ </MessageContent>
113
+ <MessageActions className="-ml-2.5 flex gap-0 opacity-0 transition-opacity group-hover:opacity-100">
114
+ <Button variant="ghost" size="icon-sm" className="rounded-full" aria-label="Copy">
115
+ {/* icon */}
116
+ </Button>
117
+ </MessageActions>
118
+ </div>
119
+ </Message>
120
+ <ChatContainerScrollAnchor />
121
+ </ChatContainerContent>
122
+ </ChatContainer>
123
+ </div>
124
+
125
+ {/* Composer — same max-width as messages */}
126
+ <div className="shrink-0 px-5 pb-5">
127
+ <div className="mx-auto max-w-2xl">
128
+ <PromptInput value={input} onValueChange={setInput} onSubmit={() => setInput('')}>
129
+ <PromptInputTextarea placeholder="Reply…" className="min-h-[44px] pt-3 pl-4" />
130
+ <PromptInputActions className="mt-2 flex w-full items-center justify-end gap-2 px-3 pb-3">
131
+ <Button size="icon-sm" className="rounded-full" disabled={!input.trim()} aria-label="Send">
132
+ {/* icon */}
133
+ </Button>
134
+ </PromptInputActions>
135
+ </PromptInput>
136
+ </div>
137
+ </div>
138
+ </div>
139
+ </ChatConfig>
140
+ );
141
+ }`,
142
+
143
+ vue: `<script setup>
144
+ import '@kitn.ai/ui/elements';
145
+ import { ref } from 'vue';
146
+
147
+ const input = ref('');
148
+
149
+ function onSubmit(e) {
150
+ console.log('send', e.detail.value);
151
+ input.value = '';
152
+ }
153
+ </script>
154
+
155
+ <!--
156
+ Centered Conversation — full-window single reading column.
157
+ User messages right-aligned; assistant messages left-aligned with
158
+ markdown + hover actions. Composer constrained to the same max-width.
159
+ -->
160
+ <template>
161
+ <div class="flex h-dvh flex-col overflow-hidden bg-background">
162
+
163
+ <!-- Optional header -->
164
+ <header class="flex h-14 shrink-0 items-center border-b px-5">
165
+ <span class="text-sm font-semibold">New conversation</span>
166
+ </header>
167
+
168
+ <!-- Scrollable thread -->
169
+ <kai-chat-container class="relative flex-1 overflow-y-auto">
170
+ <div class="space-y-6 px-5 py-6">
171
+
172
+ <!-- User message — right-aligned bubble -->
173
+ <kai-message class="mx-auto flex w-full max-w-2xl flex-col items-end">
174
+ <kai-message-content class="bg-muted text-primary max-w-[85%] rounded-3xl px-5 py-2.5">
175
+ Why is SolidJS reactivity fast?
176
+ </kai-message-content>
177
+ </kai-message>
178
+
179
+ <!-- Assistant message — left-aligned, markdown, hover actions -->
180
+ <kai-message class="mx-auto flex w-full max-w-2xl flex-col items-start">
181
+ <div class="group flex w-full flex-col">
182
+ <kai-message-content markdown class="bg-transparent p-0 text-foreground">
183
+ Signals are fine-grained — only the DOM nodes that read a signal update.
184
+ </kai-message-content>
185
+ <kai-message-actions class="-ml-2.5 flex gap-0 opacity-0 transition-opacity group-hover:opacity-100">
186
+ <button aria-label="Copy"><!-- icon --></button>
187
+ </kai-message-actions>
188
+ </div>
189
+ </kai-message>
190
+
191
+ </div>
192
+ </kai-chat-container>
193
+
194
+ <!-- Composer — same max-width as messages -->
195
+ <div class="shrink-0 px-5 pb-5">
196
+ <div class="mx-auto max-w-2xl">
197
+ <kai-prompt-input
198
+ :value="input"
199
+ @kai-value-change="input = $event.detail.value"
200
+ @kai-submit="onSubmit"
201
+ >
202
+ <kai-prompt-input-textarea placeholder="Reply…"></kai-prompt-input-textarea>
203
+ <kai-prompt-input-actions class="mt-2 flex w-full items-center justify-end gap-2 px-3 pb-3">
204
+ <button :disabled="!input.trim()" aria-label="Send"><!-- icon --></button>
205
+ </kai-prompt-input-actions>
206
+ </kai-prompt-input>
207
+ </div>
208
+ </div>
209
+ </div>
210
+ </template>`,
211
+
212
+ svelte: `<script>
213
+ import '@kitn.ai/ui/elements';
214
+ let input = '';
215
+ </script>
216
+
217
+ <!--
218
+ Centered Conversation — full-window single reading column.
219
+ User messages right-aligned; assistant messages left-aligned with
220
+ markdown + hover actions. Composer constrained to the same max-width.
221
+ -->
222
+ <div class="flex h-dvh flex-col overflow-hidden bg-background">
223
+
224
+ <!-- Optional header -->
225
+ <header class="flex h-14 shrink-0 items-center border-b px-5">
226
+ <span class="text-sm font-semibold">New conversation</span>
227
+ </header>
228
+
229
+ <!-- Scrollable thread -->
230
+ <kai-chat-container class="relative flex-1 overflow-y-auto">
231
+ <div class="space-y-6 px-5 py-6">
232
+
233
+ <!-- User message — right-aligned bubble -->
234
+ <kai-message class="mx-auto flex w-full max-w-2xl flex-col items-end">
235
+ <kai-message-content class="bg-muted text-primary max-w-[85%] rounded-3xl px-5 py-2.5">
236
+ Why is SolidJS reactivity fast?
237
+ </kai-message-content>
238
+ </kai-message>
239
+
240
+ <!-- Assistant message — left-aligned, markdown, hover actions -->
241
+ <kai-message class="mx-auto flex w-full max-w-2xl flex-col items-start">
242
+ <div class="group flex w-full flex-col">
243
+ <kai-message-content markdown class="bg-transparent p-0 text-foreground">
244
+ Signals are fine-grained — only the DOM nodes that read a signal update.
245
+ </kai-message-content>
246
+ <kai-message-actions class="-ml-2.5 flex gap-0 opacity-0 transition-opacity group-hover:opacity-100">
247
+ <button aria-label="Copy"><!-- icon --></button>
248
+ </kai-message-actions>
249
+ </div>
250
+ </kai-message>
251
+
252
+ </div>
253
+ </kai-chat-container>
254
+
255
+ <!-- Composer — same max-width as messages -->
256
+ <div class="shrink-0 px-5 pb-5">
257
+ <div class="mx-auto max-w-2xl">
258
+ <kai-prompt-input
259
+ value={input}
260
+ on:kai-value-change={(e) => (input = e.detail.value)}
261
+ on:kai-submit={() => (input = '')}
262
+ >
263
+ <kai-prompt-input-textarea placeholder="Reply…"></kai-prompt-input-textarea>
264
+ <kai-prompt-input-actions class="mt-2 flex w-full items-center justify-end gap-2 px-3 pb-3">
265
+ <button disabled={!input.trim()} aria-label="Send"><!-- icon --></button>
266
+ </kai-prompt-input-actions>
267
+ </kai-prompt-input>
268
+ </div>
269
+ </div>
270
+ </div>`,
271
+
272
+ angular: `// main.ts: import '@kitn.ai/ui/elements' before bootstrapApplication,
273
+ // and add CUSTOM_ELEMENTS_SCHEMA to the component.
274
+ import { Component, CUSTOM_ELEMENTS_SCHEMA } from '@angular/core';
275
+ import { FormsModule } from '@angular/forms';
276
+
277
+ /**
278
+ * Centered Conversation — full-window single reading column.
279
+ * User messages right-aligned; assistant messages left-aligned with
280
+ * markdown + hover actions. Composer constrained to the same max-width.
281
+ */
282
+ @Component({
283
+ selector: 'app-centered-conversation',
284
+ standalone: true,
285
+ imports: [FormsModule],
286
+ schemas: [CUSTOM_ELEMENTS_SCHEMA],
287
+ template: \`
288
+ <div class="flex h-dvh flex-col overflow-hidden bg-background">
289
+
290
+ <!-- Optional header -->
291
+ <header class="flex h-14 shrink-0 items-center border-b px-5">
292
+ <span class="text-sm font-semibold">New conversation</span>
293
+ </header>
294
+
295
+ <!-- Scrollable thread -->
296
+ <kai-chat-container class="relative flex-1 overflow-y-auto">
297
+ <div class="space-y-6 px-5 py-6">
298
+
299
+ <!-- User message — right-aligned bubble -->
300
+ <kai-message class="mx-auto flex w-full max-w-2xl flex-col items-end">
301
+ <kai-message-content class="bg-muted text-primary max-w-[85%] rounded-3xl px-5 py-2.5">
302
+ Why is SolidJS reactivity fast?
303
+ </kai-message-content>
304
+ </kai-message>
305
+
306
+ <!-- Assistant message — left-aligned, markdown, hover actions -->
307
+ <kai-message class="mx-auto flex w-full max-w-2xl flex-col items-start">
308
+ <div class="group flex w-full flex-col">
309
+ <kai-message-content markdown class="bg-transparent p-0 text-foreground">
310
+ Signals are fine-grained — only the DOM nodes that read a signal update.
311
+ </kai-message-content>
312
+ <kai-message-actions class="-ml-2.5 flex gap-0 opacity-0 transition-opacity group-hover:opacity-100">
313
+ <button aria-label="Copy"><!-- icon --></button>
314
+ </kai-message-actions>
315
+ </div>
316
+ </kai-message>
317
+
318
+ </div>
319
+ </kai-chat-container>
320
+
321
+ <!-- Composer — same max-width as messages -->
322
+ <div class="shrink-0 px-5 pb-5">
323
+ <div class="mx-auto max-w-2xl">
324
+ <kai-prompt-input
325
+ [value]="input"
326
+ (kai-value-change)="input = $event.detail.value"
327
+ (kai-submit)="input = ''"
328
+ >
329
+ <kai-prompt-input-textarea placeholder="Reply…"></kai-prompt-input-textarea>
330
+ <kai-prompt-input-actions class="mt-2 flex w-full items-center justify-end gap-2 px-3 pb-3">
331
+ <button [disabled]="!input.trim()" aria-label="Send"><!-- icon --></button>
332
+ </kai-prompt-input-actions>
333
+ </kai-prompt-input>
334
+ </div>
335
+ </div>
336
+ </div>
337
+ \`,
338
+ })
339
+ export class CenteredConversationComponent {
340
+ input = '';
341
+ }`,
342
+
343
+ solid: `import { createSignal } from 'solid-js';
344
+ import {
345
+ ChatConfig, ChatContainer, ChatContainerContent, ChatContainerScrollAnchor,
346
+ Message, MessageContent, MessageActions,
347
+ PromptInput, PromptInputTextarea, PromptInputActions,
348
+ ModelSwitcher, Button,
349
+ } from '@kitn.ai/ui';
350
+ import type { ModelOption } from '@kitn.ai/ui';
351
+ import { Copy, ThumbsUp, ArrowUp } from 'lucide-solid';
352
+
353
+ const models: ModelOption[] = [
354
+ { id: 'claude-4', name: 'Claude 4 Opus', provider: 'Anthropic' },
355
+ { id: 'gpt-4o', name: 'GPT-4o', provider: 'OpenAI' },
356
+ ];
357
+
358
+ /**
359
+ * Centered Conversation — full-window single reading column.
360
+ * User messages right-aligned; assistant messages left-aligned with
361
+ * markdown + hover actions. Composer constrained to the same max-width.
362
+ */
363
+ export function CenteredConversation() {
364
+ const [input, setInput] = createSignal('');
365
+ const [model, setModel] = createSignal('claude-4');
366
+
367
+ return (
368
+ <ChatConfig proseSize="base">
369
+ <div class="flex h-dvh flex-col overflow-hidden bg-background">
370
+
371
+ {/* Optional header */}
372
+ <header class="flex h-14 shrink-0 items-center justify-between border-b border-border px-5">
373
+ <span class="text-sm font-semibold text-foreground">New conversation</span>
374
+ <ModelSwitcher models={models} currentModelId={model()} onModelChange={setModel} />
375
+ </header>
376
+
377
+ {/* Scrollable thread */}
378
+ <div class="relative flex-1 overflow-y-auto">
379
+ <ChatContainer class="h-full">
380
+ <ChatContainerContent class="space-y-6 px-5 py-6">
381
+
382
+ {/* User message — right-aligned bubble */}
383
+ <Message class="mx-auto flex w-full max-w-2xl flex-col items-end">
384
+ <MessageContent class="bg-muted text-primary max-w-[85%] rounded-3xl px-5 py-2.5">
385
+ Why is SolidJS reactivity fast?
386
+ </MessageContent>
387
+ </Message>
388
+
389
+ {/* Assistant message — left-aligned, markdown, hover actions */}
390
+ <Message class="mx-auto flex w-full max-w-2xl flex-col items-start">
391
+ <div class="group flex w-full flex-col">
392
+ <MessageContent markdown class="bg-transparent p-0 text-foreground">
393
+ Signals are fine-grained — only the DOM nodes that read a signal update.
394
+ </MessageContent>
395
+ <MessageActions class="-ml-2.5 flex gap-0 opacity-0 transition-opacity duration-150 group-hover:opacity-100">
396
+ <Button variant="ghost" size="icon-sm" class="rounded-full" aria-label="Copy message">
397
+ <Copy class="size-3.5" />
398
+ </Button>
399
+ <Button variant="ghost" size="icon-sm" class="rounded-full" aria-label="Good response">
400
+ <ThumbsUp class="size-3.5" />
401
+ </Button>
402
+ </MessageActions>
403
+ </div>
404
+ </Message>
405
+
406
+ <ChatContainerScrollAnchor />
407
+ </ChatContainerContent>
408
+ </ChatContainer>
409
+ </div>
410
+
411
+ {/* Composer — constrained to the same max-width as messages */}
412
+ <div class="shrink-0 px-5 pb-5">
413
+ <div class="mx-auto max-w-2xl">
414
+ <PromptInput value={input()} onValueChange={setInput} onSubmit={() => setInput('')}>
415
+ <PromptInputTextarea placeholder="Reply…" class="min-h-[44px] pt-3 pl-4" />
416
+ <PromptInputActions class="mt-2 flex w-full items-center justify-end gap-2 px-3 pb-3">
417
+ <Button size="icon-sm" class="rounded-full" disabled={!input().trim()} aria-label="Send message">
418
+ <ArrowUp class="size-4" />
419
+ </Button>
420
+ </PromptInputActions>
421
+ </PromptInput>
422
+ </div>
423
+ </div>
424
+ </div>
425
+ </ChatConfig>
426
+ );
427
+ }`,
428
+ },
429
+ };
430
+
431
+ /**
432
+ * Pattern: Centered Conversation — full-window, single-column reading layout
433
+ * (Claude.ai-style). `max-w` measure centered in the viewport; user bubbles
434
+ * right-aligned, assistant prose left-aligned with hover action bar, composer
435
+ * pinned to the bottom. Per-story: the Usage tab shows the snippet for the
436
+ * story you're on; the example-level fields below are the fallback.
437
+ */
438
+ const centeredConversation: ExampleUsage = {
439
+ title: 'Patterns/Centered Conversation',
440
+ ...focused,
441
+ stories: {
442
+ Focused: focused,
443
+ },
444
+ };
445
+
446
+ export default centeredConversation;