@copilotkit/shared 2.0.0-rc.4 → 2.0.0-rc.41

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 (562) hide show
  1. package/README.md +4 -15
  2. package/dist/a2ui-envelope.cjs +2 -2
  3. package/dist/a2ui-envelope.cjs.map +1 -1
  4. package/dist/a2ui-envelope.d.cts +1 -1
  5. package/dist/a2ui-envelope.d.cts.map +1 -1
  6. package/dist/a2ui-envelope.d.mts +1 -1
  7. package/dist/a2ui-envelope.d.mts.map +1 -1
  8. package/dist/a2ui-envelope.mjs +2 -2
  9. package/dist/a2ui-envelope.mjs.map +1 -1
  10. package/dist/a2ui-prompts.cjs +21 -62
  11. package/dist/a2ui-prompts.cjs.map +1 -1
  12. package/dist/a2ui-prompts.d.cts +8 -1
  13. package/dist/a2ui-prompts.d.cts.map +1 -1
  14. package/dist/a2ui-prompts.d.mts +8 -1
  15. package/dist/a2ui-prompts.d.mts.map +1 -1
  16. package/dist/a2ui-prompts.mjs +22 -62
  17. package/dist/a2ui-prompts.mjs.map +1 -1
  18. package/dist/attachments/types.d.cts +1 -3
  19. package/dist/attachments/types.d.cts.map +1 -1
  20. package/dist/attachments/types.d.mts +1 -3
  21. package/dist/attachments/types.d.mts.map +1 -1
  22. package/dist/attachments/utils.cjs +16 -5
  23. package/dist/attachments/utils.cjs.map +1 -1
  24. package/dist/attachments/utils.d.cts +3 -1
  25. package/dist/attachments/utils.d.cts.map +1 -1
  26. package/dist/attachments/utils.d.mts +3 -1
  27. package/dist/attachments/utils.d.mts.map +1 -1
  28. package/dist/attachments/utils.mjs +16 -5
  29. package/dist/attachments/utils.mjs.map +1 -1
  30. package/dist/finalize-events.cjs +16 -0
  31. package/dist/finalize-events.cjs.map +1 -1
  32. package/dist/finalize-events.d.cts.map +1 -1
  33. package/dist/finalize-events.d.mts.map +1 -1
  34. package/dist/finalize-events.mjs +16 -0
  35. package/dist/finalize-events.mjs.map +1 -1
  36. package/dist/generative-ui/basic-functions.cjs +1 -1
  37. package/dist/generative-ui/basic-functions.cjs.map +1 -1
  38. package/dist/generative-ui/basic-functions.mjs +1 -1
  39. package/dist/generative-ui/basic-functions.mjs.map +1 -1
  40. package/dist/generative-ui/catalog/catalog-export.cjs +329 -0
  41. package/dist/generative-ui/catalog/catalog-export.cjs.map +1 -0
  42. package/dist/generative-ui/catalog/catalog-export.d.cts +92 -0
  43. package/dist/generative-ui/catalog/catalog-export.d.cts.map +1 -0
  44. package/dist/generative-ui/catalog/catalog-export.d.mts +92 -0
  45. package/dist/generative-ui/catalog/catalog-export.d.mts.map +1 -0
  46. package/dist/generative-ui/catalog/catalog-export.mjs +328 -0
  47. package/dist/generative-ui/catalog/catalog-export.mjs.map +1 -0
  48. package/dist/generative-ui/catalog/catalog.cjs +315 -0
  49. package/dist/generative-ui/catalog/catalog.cjs.map +1 -0
  50. package/dist/generative-ui/catalog/catalog.d.cts +407 -0
  51. package/dist/generative-ui/catalog/catalog.d.cts.map +1 -0
  52. package/dist/generative-ui/catalog/catalog.d.mts +407 -0
  53. package/dist/generative-ui/catalog/catalog.d.mts.map +1 -0
  54. package/dist/generative-ui/catalog/catalog.mjs +312 -0
  55. package/dist/generative-ui/catalog/catalog.mjs.map +1 -0
  56. package/dist/generative-ui/catalog/errors.cjs +13 -0
  57. package/dist/generative-ui/catalog/errors.cjs.map +1 -0
  58. package/dist/generative-ui/catalog/errors.d.cts +46 -0
  59. package/dist/generative-ui/catalog/errors.d.cts.map +1 -0
  60. package/dist/generative-ui/catalog/errors.d.mts +46 -0
  61. package/dist/generative-ui/catalog/errors.d.mts.map +1 -0
  62. package/dist/generative-ui/catalog/errors.mjs +12 -0
  63. package/dist/generative-ui/catalog/errors.mjs.map +1 -0
  64. package/dist/generative-ui/catalog/index.d.mts +6 -0
  65. package/dist/generative-ui/catalog/json-schema.cjs +16 -0
  66. package/dist/generative-ui/catalog/json-schema.cjs.map +1 -0
  67. package/dist/generative-ui/catalog/json-schema.d.cts +12 -0
  68. package/dist/generative-ui/catalog/json-schema.d.cts.map +1 -0
  69. package/dist/generative-ui/catalog/json-schema.d.mts +12 -0
  70. package/dist/generative-ui/catalog/json-schema.d.mts.map +1 -0
  71. package/dist/generative-ui/catalog/json-schema.mjs +16 -0
  72. package/dist/generative-ui/catalog/json-schema.mjs.map +1 -0
  73. package/dist/generative-ui/catalog/refs.cjs +21 -0
  74. package/dist/generative-ui/catalog/refs.cjs.map +1 -0
  75. package/dist/generative-ui/catalog/refs.d.cts +55 -0
  76. package/dist/generative-ui/catalog/refs.d.cts.map +1 -0
  77. package/dist/generative-ui/catalog/refs.d.mts +55 -0
  78. package/dist/generative-ui/catalog/refs.d.mts.map +1 -0
  79. package/dist/generative-ui/catalog/refs.mjs +18 -0
  80. package/dist/generative-ui/catalog/refs.mjs.map +1 -0
  81. package/dist/generative-ui/catalog/schema.cjs +74 -0
  82. package/dist/generative-ui/catalog/schema.cjs.map +1 -0
  83. package/dist/generative-ui/catalog/schema.d.cts +43 -0
  84. package/dist/generative-ui/catalog/schema.d.cts.map +1 -0
  85. package/dist/generative-ui/catalog/schema.d.mts +43 -0
  86. package/dist/generative-ui/catalog/schema.d.mts.map +1 -0
  87. package/dist/generative-ui/catalog/schema.mjs +68 -0
  88. package/dist/generative-ui/catalog/schema.mjs.map +1 -0
  89. package/dist/generative-ui/child-refs.cjs +3 -3
  90. package/dist/generative-ui/child-refs.cjs.map +1 -1
  91. package/dist/generative-ui/child-refs.d.cts.map +1 -1
  92. package/dist/generative-ui/child-refs.d.mts.map +1 -1
  93. package/dist/generative-ui/child-refs.mjs +3 -3
  94. package/dist/generative-ui/child-refs.mjs.map +1 -1
  95. package/dist/generative-ui/clone-value.cjs +364 -0
  96. package/dist/generative-ui/clone-value.cjs.map +1 -0
  97. package/dist/generative-ui/clone-value.d.cts +51 -0
  98. package/dist/generative-ui/clone-value.d.cts.map +1 -0
  99. package/dist/generative-ui/clone-value.d.mts +51 -0
  100. package/dist/generative-ui/clone-value.d.mts.map +1 -0
  101. package/dist/generative-ui/clone-value.mjs +363 -0
  102. package/dist/generative-ui/clone-value.mjs.map +1 -0
  103. package/dist/generative-ui/compact-schema.cjs +187 -0
  104. package/dist/generative-ui/compact-schema.cjs.map +1 -0
  105. package/dist/generative-ui/compact-schema.d.cts +55 -0
  106. package/dist/generative-ui/compact-schema.d.cts.map +1 -0
  107. package/dist/generative-ui/compact-schema.d.mts +55 -0
  108. package/dist/generative-ui/compact-schema.d.mts.map +1 -0
  109. package/dist/generative-ui/compact-schema.mjs +185 -0
  110. package/dist/generative-ui/compact-schema.mjs.map +1 -0
  111. package/dist/generative-ui/index.cjs +286 -0
  112. package/dist/generative-ui/index.d.cts +39 -0
  113. package/dist/generative-ui/index.d.mts +41 -0
  114. package/dist/generative-ui/index.mjs +40 -0
  115. package/dist/generative-ui/is-record.cjs +6 -1
  116. package/dist/generative-ui/is-record.cjs.map +1 -1
  117. package/dist/generative-ui/is-record.d.cts +8 -0
  118. package/dist/generative-ui/is-record.d.cts.map +1 -0
  119. package/dist/generative-ui/is-record.d.mts +8 -0
  120. package/dist/generative-ui/is-record.d.mts.map +1 -0
  121. package/dist/generative-ui/is-record.mjs +6 -2
  122. package/dist/generative-ui/is-record.mjs.map +1 -1
  123. package/dist/generative-ui/prompt-spec.cjs +225 -0
  124. package/dist/generative-ui/prompt-spec.cjs.map +1 -0
  125. package/dist/generative-ui/prompt-spec.d.cts +94 -0
  126. package/dist/generative-ui/prompt-spec.d.cts.map +1 -0
  127. package/dist/generative-ui/prompt-spec.d.mts +94 -0
  128. package/dist/generative-ui/prompt-spec.d.mts.map +1 -0
  129. package/dist/generative-ui/prompt-spec.mjs +220 -0
  130. package/dist/generative-ui/prompt-spec.mjs.map +1 -0
  131. package/dist/generative-ui/prompt.cjs +10 -36
  132. package/dist/generative-ui/prompt.cjs.map +1 -1
  133. package/dist/generative-ui/prompt.d.cts +2 -1
  134. package/dist/generative-ui/prompt.d.cts.map +1 -1
  135. package/dist/generative-ui/prompt.d.mts +2 -1
  136. package/dist/generative-ui/prompt.d.mts.map +1 -1
  137. package/dist/generative-ui/prompt.mjs +12 -38
  138. package/dist/generative-ui/prompt.mjs.map +1 -1
  139. package/dist/generative-ui/render-ui-args.cjs +1 -0
  140. package/dist/generative-ui/render-ui-args.cjs.map +1 -1
  141. package/dist/generative-ui/render-ui-args.d.cts.map +1 -1
  142. package/dist/generative-ui/render-ui-args.d.mts.map +1 -1
  143. package/dist/generative-ui/render-ui-args.mjs +1 -0
  144. package/dist/generative-ui/render-ui-args.mjs.map +1 -1
  145. package/dist/generative-ui/schema-render.cjs +243 -0
  146. package/dist/generative-ui/schema-render.cjs.map +1 -0
  147. package/dist/generative-ui/schema-render.d.cts +44 -0
  148. package/dist/generative-ui/schema-render.d.cts.map +1 -0
  149. package/dist/generative-ui/schema-render.d.mts +44 -0
  150. package/dist/generative-ui/schema-render.d.mts.map +1 -0
  151. package/dist/generative-ui/schema-render.mjs +240 -0
  152. package/dist/generative-ui/schema-render.mjs.map +1 -0
  153. package/dist/generative-ui/standard/chart-config.cjs +347 -0
  154. package/dist/generative-ui/standard/chart-config.cjs.map +1 -0
  155. package/dist/generative-ui/standard/chart-config.d.cts +97 -0
  156. package/dist/generative-ui/standard/chart-config.d.cts.map +1 -0
  157. package/dist/generative-ui/standard/chart-config.d.mts +97 -0
  158. package/dist/generative-ui/standard/chart-config.d.mts.map +1 -0
  159. package/dist/generative-ui/standard/chart-config.mjs +342 -0
  160. package/dist/generative-ui/standard/chart-config.mjs.map +1 -0
  161. package/dist/generative-ui/standard/chart.cjs +56 -0
  162. package/dist/generative-ui/standard/chart.cjs.map +1 -0
  163. package/dist/generative-ui/standard/chart.d.cts +62 -0
  164. package/dist/generative-ui/standard/chart.d.cts.map +1 -0
  165. package/dist/generative-ui/standard/chart.d.mts +62 -0
  166. package/dist/generative-ui/standard/chart.d.mts.map +1 -0
  167. package/dist/generative-ui/standard/chart.mjs +54 -0
  168. package/dist/generative-ui/standard/chart.mjs.map +1 -0
  169. package/dist/generative-ui/standard/checks.cjs +74 -0
  170. package/dist/generative-ui/standard/checks.cjs.map +1 -0
  171. package/dist/generative-ui/standard/checks.d.cts +56 -0
  172. package/dist/generative-ui/standard/checks.d.cts.map +1 -0
  173. package/dist/generative-ui/standard/checks.d.mts +56 -0
  174. package/dist/generative-ui/standard/checks.d.mts.map +1 -0
  175. package/dist/generative-ui/standard/checks.mjs +71 -0
  176. package/dist/generative-ui/standard/checks.mjs.map +1 -0
  177. package/dist/generative-ui/standard/components.cjs +23 -0
  178. package/dist/generative-ui/standard/components.cjs.map +1 -0
  179. package/dist/generative-ui/standard/components.d.cts +24 -0
  180. package/dist/generative-ui/standard/components.d.cts.map +1 -0
  181. package/dist/generative-ui/standard/components.d.mts +24 -0
  182. package/dist/generative-ui/standard/components.d.mts.map +1 -0
  183. package/dist/generative-ui/standard/components.mjs +22 -0
  184. package/dist/generative-ui/standard/components.mjs.map +1 -0
  185. package/dist/generative-ui/standard/composites.cjs +143 -0
  186. package/dist/generative-ui/standard/composites.cjs.map +1 -0
  187. package/dist/generative-ui/standard/composites.d.cts +233 -0
  188. package/dist/generative-ui/standard/composites.d.cts.map +1 -0
  189. package/dist/generative-ui/standard/composites.d.mts +233 -0
  190. package/dist/generative-ui/standard/composites.d.mts.map +1 -0
  191. package/dist/generative-ui/standard/composites.mjs +132 -0
  192. package/dist/generative-ui/standard/composites.mjs.map +1 -0
  193. package/dist/generative-ui/standard/data.cjs +176 -0
  194. package/dist/generative-ui/standard/data.cjs.map +1 -0
  195. package/dist/generative-ui/standard/data.d.cts +365 -0
  196. package/dist/generative-ui/standard/data.d.cts.map +1 -0
  197. package/dist/generative-ui/standard/data.d.mts +365 -0
  198. package/dist/generative-ui/standard/data.d.mts.map +1 -0
  199. package/dist/generative-ui/standard/data.mjs +167 -0
  200. package/dist/generative-ui/standard/data.mjs.map +1 -0
  201. package/dist/generative-ui/standard/declarations.cjs +40 -0
  202. package/dist/generative-ui/standard/declarations.cjs.map +1 -0
  203. package/dist/generative-ui/standard/declarations.d.cts +2570 -0
  204. package/dist/generative-ui/standard/declarations.d.cts.map +1 -0
  205. package/dist/generative-ui/standard/declarations.d.mts +2571 -0
  206. package/dist/generative-ui/standard/declarations.d.mts.map +1 -0
  207. package/dist/generative-ui/standard/declarations.mjs +39 -0
  208. package/dist/generative-ui/standard/declarations.mjs.map +1 -0
  209. package/dist/generative-ui/standard/feedback.cjs +97 -0
  210. package/dist/generative-ui/standard/feedback.cjs.map +1 -0
  211. package/dist/generative-ui/standard/feedback.d.cts +133 -0
  212. package/dist/generative-ui/standard/feedback.d.cts.map +1 -0
  213. package/dist/generative-ui/standard/feedback.d.mts +133 -0
  214. package/dist/generative-ui/standard/feedback.d.mts.map +1 -0
  215. package/dist/generative-ui/standard/feedback.mjs +90 -0
  216. package/dist/generative-ui/standard/feedback.mjs.map +1 -0
  217. package/dist/generative-ui/standard/index.d.mts +20 -0
  218. package/dist/generative-ui/standard/inputs.cjs +333 -0
  219. package/dist/generative-ui/standard/inputs.cjs.map +1 -0
  220. package/dist/generative-ui/standard/inputs.d.cts +1128 -0
  221. package/dist/generative-ui/standard/inputs.d.cts.map +1 -0
  222. package/dist/generative-ui/standard/inputs.d.mts +1128 -0
  223. package/dist/generative-ui/standard/inputs.d.mts.map +1 -0
  224. package/dist/generative-ui/standard/inputs.mjs +318 -0
  225. package/dist/generative-ui/standard/inputs.mjs.map +1 -0
  226. package/dist/generative-ui/standard/layout.cjs +289 -0
  227. package/dist/generative-ui/standard/layout.cjs.map +1 -0
  228. package/dist/generative-ui/standard/layout.d.cts +1974 -0
  229. package/dist/generative-ui/standard/layout.d.cts.map +1 -0
  230. package/dist/generative-ui/standard/layout.d.mts +1975 -0
  231. package/dist/generative-ui/standard/layout.d.mts.map +1 -0
  232. package/dist/generative-ui/standard/layout.mjs +269 -0
  233. package/dist/generative-ui/standard/layout.mjs.map +1 -0
  234. package/dist/generative-ui/standard/map-helpers.cjs +104 -0
  235. package/dist/generative-ui/standard/map-helpers.cjs.map +1 -0
  236. package/dist/generative-ui/standard/map-helpers.d.cts +88 -0
  237. package/dist/generative-ui/standard/map-helpers.d.cts.map +1 -0
  238. package/dist/generative-ui/standard/map-helpers.d.mts +88 -0
  239. package/dist/generative-ui/standard/map-helpers.d.mts.map +1 -0
  240. package/dist/generative-ui/standard/map-helpers.mjs +95 -0
  241. package/dist/generative-ui/standard/map-helpers.mjs.map +1 -0
  242. package/dist/generative-ui/standard/map.cjs +27 -0
  243. package/dist/generative-ui/standard/map.cjs.map +1 -0
  244. package/dist/generative-ui/standard/map.d.cts +31 -0
  245. package/dist/generative-ui/standard/map.d.cts.map +1 -0
  246. package/dist/generative-ui/standard/map.d.mts +31 -0
  247. package/dist/generative-ui/standard/map.d.mts.map +1 -0
  248. package/dist/generative-ui/standard/map.mjs +25 -0
  249. package/dist/generative-ui/standard/map.mjs.map +1 -0
  250. package/dist/generative-ui/standard/media.cjs +215 -0
  251. package/dist/generative-ui/standard/media.cjs.map +1 -0
  252. package/dist/generative-ui/standard/media.d.cts +396 -0
  253. package/dist/generative-ui/standard/media.d.cts.map +1 -0
  254. package/dist/generative-ui/standard/media.d.mts +396 -0
  255. package/dist/generative-ui/standard/media.d.mts.map +1 -0
  256. package/dist/generative-ui/standard/media.mjs +205 -0
  257. package/dist/generative-ui/standard/media.mjs.map +1 -0
  258. package/dist/generative-ui/standard/parameter-order.cjs +231 -0
  259. package/dist/generative-ui/standard/parameter-order.cjs.map +1 -0
  260. package/dist/generative-ui/standard/parameter-order.d.cts +84 -0
  261. package/dist/generative-ui/standard/parameter-order.d.cts.map +1 -0
  262. package/dist/generative-ui/standard/parameter-order.d.mts +84 -0
  263. package/dist/generative-ui/standard/parameter-order.d.mts.map +1 -0
  264. package/dist/generative-ui/standard/parameter-order.mjs +230 -0
  265. package/dist/generative-ui/standard/parameter-order.mjs.map +1 -0
  266. package/dist/generative-ui/standard/style-helpers.cjs +151 -0
  267. package/dist/generative-ui/standard/style-helpers.cjs.map +1 -0
  268. package/dist/generative-ui/standard/style-helpers.d.cts +56 -0
  269. package/dist/generative-ui/standard/style-helpers.d.cts.map +1 -0
  270. package/dist/generative-ui/standard/style-helpers.d.mts +56 -0
  271. package/dist/generative-ui/standard/style-helpers.d.mts.map +1 -0
  272. package/dist/generative-ui/standard/style-helpers.mjs +142 -0
  273. package/dist/generative-ui/standard/style-helpers.mjs.map +1 -0
  274. package/dist/generative-ui/standard/styles.cjs +62 -0
  275. package/dist/generative-ui/standard/styles.cjs.map +1 -0
  276. package/dist/generative-ui/standard/styles.d.cts +17 -0
  277. package/dist/generative-ui/standard/styles.d.cts.map +1 -0
  278. package/dist/generative-ui/standard/styles.d.mts +17 -0
  279. package/dist/generative-ui/standard/styles.d.mts.map +1 -0
  280. package/dist/generative-ui/standard/styles.mjs +60 -0
  281. package/dist/generative-ui/standard/styles.mjs.map +1 -0
  282. package/dist/generative-ui/standard/text.cjs +226 -0
  283. package/dist/generative-ui/standard/text.cjs.map +1 -0
  284. package/dist/generative-ui/standard/text.d.cts +522 -0
  285. package/dist/generative-ui/standard/text.d.cts.map +1 -0
  286. package/dist/generative-ui/standard/text.d.mts +522 -0
  287. package/dist/generative-ui/standard/text.d.mts.map +1 -0
  288. package/dist/generative-ui/standard/text.mjs +209 -0
  289. package/dist/generative-ui/standard/text.mjs.map +1 -0
  290. package/dist/generative-ui/standard/theme.cjs +115 -0
  291. package/dist/generative-ui/standard/theme.cjs.map +1 -0
  292. package/dist/generative-ui/standard/theme.d.cts +60 -0
  293. package/dist/generative-ui/standard/theme.d.cts.map +1 -0
  294. package/dist/generative-ui/standard/theme.d.mts +60 -0
  295. package/dist/generative-ui/standard/theme.d.mts.map +1 -0
  296. package/dist/generative-ui/standard/theme.mjs +112 -0
  297. package/dist/generative-ui/standard/theme.mjs.map +1 -0
  298. package/dist/generative-ui/standard/tokens.cjs +336 -0
  299. package/dist/generative-ui/standard/tokens.cjs.map +1 -0
  300. package/dist/generative-ui/standard/tokens.d.cts +76 -0
  301. package/dist/generative-ui/standard/tokens.d.cts.map +1 -0
  302. package/dist/generative-ui/standard/tokens.d.mts +76 -0
  303. package/dist/generative-ui/standard/tokens.d.mts.map +1 -0
  304. package/dist/generative-ui/standard/tokens.mjs +305 -0
  305. package/dist/generative-ui/standard/tokens.mjs.map +1 -0
  306. package/dist/generative-ui/standard/url.cjs +54 -0
  307. package/dist/generative-ui/standard/url.cjs.map +1 -0
  308. package/dist/generative-ui/standard/url.d.cts +32 -0
  309. package/dist/generative-ui/standard/url.d.cts.map +1 -0
  310. package/dist/generative-ui/standard/url.d.mts +32 -0
  311. package/dist/generative-ui/standard/url.d.mts.map +1 -0
  312. package/dist/generative-ui/standard/url.mjs +50 -0
  313. package/dist/generative-ui/standard/url.mjs.map +1 -0
  314. package/dist/generative-ui/thrown.cjs +69 -0
  315. package/dist/generative-ui/thrown.cjs.map +1 -0
  316. package/dist/generative-ui/thrown.d.cts +21 -0
  317. package/dist/generative-ui/thrown.d.cts.map +1 -0
  318. package/dist/generative-ui/thrown.d.mts +21 -0
  319. package/dist/generative-ui/thrown.d.mts.map +1 -0
  320. package/dist/generative-ui/thrown.mjs +67 -0
  321. package/dist/generative-ui/thrown.mjs.map +1 -0
  322. package/dist/generative-ui/types.cjs +2 -2
  323. package/dist/generative-ui/types.cjs.map +1 -1
  324. package/dist/generative-ui/types.d.cts +7 -7
  325. package/dist/generative-ui/types.d.cts.map +1 -1
  326. package/dist/generative-ui/types.d.mts +7 -7
  327. package/dist/generative-ui/types.d.mts.map +1 -1
  328. package/dist/generative-ui/types.mjs +2 -2
  329. package/dist/generative-ui/types.mjs.map +1 -1
  330. package/dist/generative-ui/validate-operation.cjs +2 -2
  331. package/dist/generative-ui/validate-operation.cjs.map +1 -1
  332. package/dist/generative-ui/validate-operation.mjs +2 -2
  333. package/dist/generative-ui/validate-operation.mjs.map +1 -1
  334. package/dist/index.cjs +18 -15
  335. package/dist/index.cjs.map +1 -1
  336. package/dist/index.d.cts +17 -16
  337. package/dist/index.d.cts.map +1 -1
  338. package/dist/index.d.mts +17 -16
  339. package/dist/index.d.mts.map +1 -1
  340. package/dist/index.mjs +10 -8
  341. package/dist/index.mjs.map +1 -1
  342. package/dist/index.umd.js +1233 -456
  343. package/dist/index.umd.js.map +1 -1
  344. package/dist/package.cjs +1 -1
  345. package/dist/package.mjs +1 -1
  346. package/dist/standard-schema.cjs +20 -7
  347. package/dist/standard-schema.cjs.map +1 -1
  348. package/dist/standard-schema.d.cts +15 -16
  349. package/dist/standard-schema.d.cts.map +1 -1
  350. package/dist/standard-schema.d.mts +15 -16
  351. package/dist/standard-schema.d.mts.map +1 -1
  352. package/dist/standard-schema.mjs +20 -8
  353. package/dist/standard-schema.mjs.map +1 -1
  354. package/dist/telemetry/lambda-client.cjs +1 -1
  355. package/dist/telemetry/lambda-client.cjs.map +1 -1
  356. package/dist/telemetry/lambda-client.d.cts.map +1 -1
  357. package/dist/telemetry/lambda-client.d.mts.map +1 -1
  358. package/dist/telemetry/lambda-client.mjs +1 -1
  359. package/dist/telemetry/lambda-client.mjs.map +1 -1
  360. package/dist/telemetry/telemetry-disabled.cjs +0 -5
  361. package/dist/telemetry/telemetry-disabled.cjs.map +1 -1
  362. package/dist/telemetry/telemetry-disabled.d.cts +0 -5
  363. package/dist/telemetry/telemetry-disabled.d.cts.map +1 -1
  364. package/dist/telemetry/telemetry-disabled.d.mts +0 -5
  365. package/dist/telemetry/telemetry-disabled.d.mts.map +1 -1
  366. package/dist/telemetry/telemetry-disabled.mjs +0 -5
  367. package/dist/telemetry/telemetry-disabled.mjs.map +1 -1
  368. package/dist/types/message.d.cts +1 -18
  369. package/dist/types/message.d.cts.map +1 -1
  370. package/dist/types/message.d.mts +1 -18
  371. package/dist/types/message.d.mts.map +1 -1
  372. package/dist/utils/errors.cjs +5 -42
  373. package/dist/utils/errors.cjs.map +1 -1
  374. package/dist/utils/errors.d.cts +16 -34
  375. package/dist/utils/errors.d.cts.map +1 -1
  376. package/dist/utils/errors.d.mts +16 -34
  377. package/dist/utils/errors.d.mts.map +1 -1
  378. package/dist/utils/errors.mjs +6 -41
  379. package/dist/utils/errors.mjs.map +1 -1
  380. package/dist/utils/index.cjs +0 -2
  381. package/dist/utils/index.cjs.map +1 -1
  382. package/dist/utils/index.d.cts +4 -6
  383. package/dist/utils/index.d.cts.map +1 -1
  384. package/dist/utils/index.d.mts +4 -6
  385. package/dist/utils/index.d.mts.map +1 -1
  386. package/dist/utils/index.mjs +4 -6
  387. package/dist/utils/index.mjs.map +1 -1
  388. package/dist/utils/inspector-visibility.cjs +25 -3
  389. package/dist/utils/inspector-visibility.cjs.map +1 -1
  390. package/dist/utils/inspector-visibility.d.cts +26 -3
  391. package/dist/utils/inspector-visibility.d.cts.map +1 -1
  392. package/dist/utils/inspector-visibility.d.mts +26 -3
  393. package/dist/utils/inspector-visibility.d.mts.map +1 -1
  394. package/dist/utils/inspector-visibility.mjs +25 -4
  395. package/dist/utils/inspector-visibility.mjs.map +1 -1
  396. package/dist/utils/json-schema.cjs +4 -79
  397. package/dist/utils/json-schema.cjs.map +1 -1
  398. package/dist/utils/json-schema.d.cts +1 -4
  399. package/dist/utils/json-schema.d.cts.map +1 -1
  400. package/dist/utils/json-schema.d.mts +1 -4
  401. package/dist/utils/json-schema.d.mts.map +1 -1
  402. package/dist/utils/json-schema.mjs +5 -78
  403. package/dist/utils/json-schema.mjs.map +1 -1
  404. package/dist/utils/random-id.cjs +13 -26
  405. package/dist/utils/random-id.cjs.map +1 -1
  406. package/dist/utils/random-id.d.cts +6 -3
  407. package/dist/utils/random-id.d.cts.map +1 -1
  408. package/dist/utils/random-id.d.mts +6 -3
  409. package/dist/utils/random-id.d.mts.map +1 -1
  410. package/dist/utils/random-id.mjs +14 -25
  411. package/dist/utils/random-id.mjs.map +1 -1
  412. package/package.json +19 -32
  413. package/scripts/verify-cjs-exports.cjs +1 -1
  414. package/src/__tests__/a2ui-envelope.test.ts +18 -13
  415. package/src/__tests__/a2ui-prompts.test.ts +47 -14
  416. package/src/__tests__/fixtures/prompt-goldens.json +354 -0
  417. package/src/__tests__/prompt-spec.test.ts +191 -0
  418. package/src/__tests__/root-entry-browser-safety.test.ts +5 -7
  419. package/src/__tests__/schema-render.test.ts +323 -0
  420. package/src/__tests__/standard-schema.test.ts +61 -101
  421. package/src/a2ui-envelope.ts +7 -6
  422. package/src/a2ui-prompts.ts +47 -96
  423. package/src/attachments/__tests__/utils.test.ts +22 -0
  424. package/src/attachments/types.ts +1 -3
  425. package/src/attachments/utils.ts +23 -5
  426. package/src/finalize-events.ts +16 -0
  427. package/src/generative-ui/__tests__/clone-value-differential.test.ts +480 -0
  428. package/src/generative-ui/__tests__/clone-value.test.ts +226 -0
  429. package/src/generative-ui/__tests__/render-ui-args.test.ts +7 -7
  430. package/src/generative-ui/__tests__/validate-operation.test.ts +19 -13
  431. package/src/generative-ui/base.ts +9 -0
  432. package/src/generative-ui/basic-functions.ts +1 -1
  433. package/src/generative-ui/catalog/catalog-export.ts +478 -0
  434. package/src/generative-ui/catalog/catalog.ts +1167 -0
  435. package/src/generative-ui/catalog/errors.ts +102 -0
  436. package/src/generative-ui/catalog/index.ts +6 -0
  437. package/src/generative-ui/catalog/json-schema.ts +14 -0
  438. package/src/generative-ui/catalog/refs.ts +87 -0
  439. package/src/generative-ui/catalog/schema.ts +107 -0
  440. package/src/generative-ui/child-refs.ts +5 -4
  441. package/src/generative-ui/clone-value.ts +511 -0
  442. package/src/generative-ui/compact-schema.ts +277 -0
  443. package/src/generative-ui/index.ts +14 -0
  444. package/src/generative-ui/is-record.ts +6 -1
  445. package/src/generative-ui/prompt-spec.ts +335 -0
  446. package/src/generative-ui/prompt.ts +25 -75
  447. package/src/generative-ui/render-ui-args.ts +3 -0
  448. package/src/generative-ui/schema-render.ts +378 -0
  449. package/src/generative-ui/standard/__tests__/standard-helpers.test.ts +407 -0
  450. package/src/generative-ui/standard/__tests__/theme.test.ts +61 -0
  451. package/src/generative-ui/standard/__tests__/tokens.test.ts +139 -0
  452. package/src/generative-ui/standard/chart-config.ts +434 -0
  453. package/src/generative-ui/standard/chart.ts +79 -0
  454. package/src/generative-ui/standard/checks.ts +98 -0
  455. package/src/generative-ui/standard/components.ts +35 -0
  456. package/src/generative-ui/standard/composites.ts +158 -0
  457. package/src/generative-ui/standard/data.ts +213 -0
  458. package/src/generative-ui/standard/declarations.ts +57 -0
  459. package/src/generative-ui/standard/feedback.ts +105 -0
  460. package/src/generative-ui/standard/index.ts +55 -0
  461. package/src/generative-ui/standard/inputs.ts +423 -0
  462. package/src/generative-ui/standard/layout.ts +312 -0
  463. package/src/generative-ui/standard/map-helpers.ts +155 -0
  464. package/src/generative-ui/standard/map.ts +32 -0
  465. package/src/generative-ui/standard/media.ts +265 -0
  466. package/src/generative-ui/standard/parameter-order.ts +155 -0
  467. package/src/generative-ui/standard/style-helpers.ts +170 -0
  468. package/src/generative-ui/standard/styles.ts +79 -0
  469. package/src/generative-ui/standard/text.ts +210 -0
  470. package/src/generative-ui/standard/theme.ts +198 -0
  471. package/src/generative-ui/standard/tokens.ts +317 -0
  472. package/src/generative-ui/standard/url.ts +51 -0
  473. package/src/generative-ui/thrown.ts +90 -0
  474. package/src/generative-ui/types.ts +10 -7
  475. package/src/generative-ui/validate-operation.ts +2 -2
  476. package/src/index.ts +9 -17
  477. package/src/standard-schema.ts +24 -27
  478. package/src/telemetry/lambda-client.ts +8 -3
  479. package/src/telemetry/model-host.test.ts +2 -5
  480. package/src/telemetry/telemetry-disabled.ts +0 -5
  481. package/src/types/message.ts +1 -19
  482. package/src/utils/__tests__/errors.test.ts +44 -0
  483. package/src/utils/__tests__/json-schema.test.ts +3 -479
  484. package/src/utils/__tests__/random-id.test.ts +37 -0
  485. package/src/utils/errors.ts +28 -85
  486. package/src/utils/index.ts +0 -2
  487. package/src/utils/inspector-visibility.test.ts +26 -0
  488. package/src/utils/inspector-visibility.ts +35 -3
  489. package/src/utils/json-schema.ts +5 -152
  490. package/src/utils/random-id.ts +17 -37
  491. package/tsconfig.json +3 -1
  492. package/tsdown.config.ts +2 -19
  493. package/dist/event-transforms/index.cjs +0 -15
  494. package/dist/event-transforms/index.d.cts +0 -4
  495. package/dist/event-transforms/index.d.mts +0 -4
  496. package/dist/event-transforms/index.mjs +0 -5
  497. package/dist/event-transforms/open-generative-ui-middleware.cjs +0 -286
  498. package/dist/event-transforms/open-generative-ui-middleware.cjs.map +0 -1
  499. package/dist/event-transforms/open-generative-ui-middleware.d.cts +0 -60
  500. package/dist/event-transforms/open-generative-ui-middleware.d.cts.map +0 -1
  501. package/dist/event-transforms/open-generative-ui-middleware.d.mts +0 -60
  502. package/dist/event-transforms/open-generative-ui-middleware.d.mts.map +0 -1
  503. package/dist/event-transforms/open-generative-ui-middleware.mjs +0 -283
  504. package/dist/event-transforms/open-generative-ui-middleware.mjs.map +0 -1
  505. package/dist/event-transforms/recorded-events.cjs +0 -59
  506. package/dist/event-transforms/recorded-events.cjs.map +0 -1
  507. package/dist/event-transforms/recorded-events.d.cts +0 -23
  508. package/dist/event-transforms/recorded-events.d.cts.map +0 -1
  509. package/dist/event-transforms/recorded-events.d.mts +0 -23
  510. package/dist/event-transforms/recorded-events.d.mts.map +0 -1
  511. package/dist/event-transforms/recorded-events.mjs +0 -58
  512. package/dist/event-transforms/recorded-events.mjs.map +0 -1
  513. package/dist/telemetry/events.d.cts +0 -72
  514. package/dist/telemetry/events.d.cts.map +0 -1
  515. package/dist/telemetry/events.d.mts +0 -72
  516. package/dist/telemetry/events.d.mts.map +0 -1
  517. package/dist/telemetry/index.cjs +0 -18
  518. package/dist/telemetry/index.d.cts +0 -5
  519. package/dist/telemetry/index.d.mts +0 -5
  520. package/dist/telemetry/index.mjs +0 -6
  521. package/dist/telemetry/telemetry-client.cjs +0 -165
  522. package/dist/telemetry/telemetry-client.cjs.map +0 -1
  523. package/dist/telemetry/telemetry-client.d.cts +0 -87
  524. package/dist/telemetry/telemetry-client.d.cts.map +0 -1
  525. package/dist/telemetry/telemetry-client.d.mts +0 -87
  526. package/dist/telemetry/telemetry-client.d.mts.map +0 -1
  527. package/dist/telemetry/telemetry-client.mjs +0 -164
  528. package/dist/telemetry/telemetry-client.mjs.map +0 -1
  529. package/dist/telemetry/utils.cjs +0 -14
  530. package/dist/telemetry/utils.cjs.map +0 -1
  531. package/dist/telemetry/utils.mjs +0 -13
  532. package/dist/telemetry/utils.mjs.map +0 -1
  533. package/dist/utils/conditions.cjs +0 -32
  534. package/dist/utils/conditions.cjs.map +0 -1
  535. package/dist/utils/conditions.d.cts +0 -31
  536. package/dist/utils/conditions.d.cts.map +0 -1
  537. package/dist/utils/conditions.d.mts +0 -31
  538. package/dist/utils/conditions.d.mts.map +0 -1
  539. package/dist/utils/conditions.mjs +0 -31
  540. package/dist/utils/conditions.mjs.map +0 -1
  541. package/dist/utils/console-styling.cjs +0 -91
  542. package/dist/utils/console-styling.cjs.map +0 -1
  543. package/dist/utils/console-styling.d.cts +0 -65
  544. package/dist/utils/console-styling.d.cts.map +0 -1
  545. package/dist/utils/console-styling.d.mts +0 -65
  546. package/dist/utils/console-styling.d.mts.map +0 -1
  547. package/dist/utils/console-styling.mjs +0 -85
  548. package/dist/utils/console-styling.mjs.map +0 -1
  549. package/src/__tests__/zod-regression.test.ts +0 -319
  550. package/src/event-transforms/index.ts +0 -5
  551. package/src/event-transforms/open-generative-ui-middleware.ts +0 -392
  552. package/src/event-transforms/recorded-events.test.ts +0 -166
  553. package/src/event-transforms/recorded-events.ts +0 -74
  554. package/src/telemetry/events.ts +0 -68
  555. package/src/telemetry/index.ts +0 -9
  556. package/src/telemetry/telemetry-blank-license-identity.test.ts +0 -128
  557. package/src/telemetry/telemetry-client.test.ts +0 -798
  558. package/src/telemetry/telemetry-client.ts +0 -328
  559. package/src/telemetry/utils.ts +0 -15
  560. package/src/utils/__tests__/conditions.test.ts +0 -161
  561. package/src/utils/conditions.ts +0 -116
  562. package/src/utils/console-styling.ts +0 -126
@@ -0,0 +1,210 @@
1
+ import { z } from "zod";
2
+ import { CHILDREN_SLOT, sizeValue, weightProp } from "./layout";
3
+ import { TEXT_COLORS, TEXT_SIZES, TITLE_SIZES, WEIGHTS } from "./tokens";
4
+
5
+ // ---- Schemas ----
6
+
7
+ const colorProp = z
8
+ .string()
9
+ .optional()
10
+ .describe(`One of ${TEXT_COLORS.join("|")} or a CSS color`);
11
+ const fontWeight = z.enum(WEIGHTS).optional();
12
+ const textAlign = z.enum(["start", "center", "end"]).optional();
13
+
14
+ const typographyProps = {
15
+ color: colorProp,
16
+ fontWeight,
17
+ textAlign,
18
+ italic: z.boolean().optional(),
19
+ truncate: z.boolean().optional(),
20
+ maxLines: z.number().optional(),
21
+ tabularNums: z.boolean().optional(),
22
+ width: sizeValue.optional(),
23
+ };
24
+
25
+ export const typographySchema = z.object(typographyProps);
26
+ export const titleSchema = z.object({
27
+ ...typographyProps,
28
+ text: z.string().describe("Heading text"),
29
+ size: z.enum(TITLE_SIZES).optional().describe('Default "md"'),
30
+ strong: z.boolean().optional().describe("Default true"),
31
+ });
32
+ export const textSchema = z.object({
33
+ ...typographyProps,
34
+ weight: weightProp,
35
+ text: z
36
+ .union([z.string(), z.number()])
37
+ .optional()
38
+ .describe("Text with inline markdown. A bound number shows as text"),
39
+ size: z.enum(TEXT_SIZES).optional().describe('Default "md"'),
40
+ fontSize: sizeValue
41
+ .optional()
42
+ .describe("Pixels when a number. Wins over size"),
43
+ lineHeight: z
44
+ .union([z.number(), z.string()])
45
+ .optional()
46
+ .describe("A unitless ratio, or CSS"),
47
+ minLines: z
48
+ .number()
49
+ .optional()
50
+ .describe("Reserves the height of this many lines"),
51
+ strong: z.boolean().optional().describe("Default false"),
52
+ underline: z.boolean().optional(),
53
+ lineThrough: z.boolean().optional(),
54
+ inline: z.boolean().optional(),
55
+ preserveWhitespace: z.boolean().optional(),
56
+ highlight: z
57
+ .union([z.enum(["green", "orange", "pink"]), z.boolean()])
58
+ .optional(),
59
+ });
60
+ export const CAPTION_SIZES = ["sm", "md", "lg"] as const;
61
+ export const captionSchema = z.object({
62
+ text: z.union([z.string(), z.number()]).describe("Caption text"),
63
+ color: colorProp,
64
+ size: z.enum(CAPTION_SIZES).optional().describe('Default "lg"'),
65
+ fontWeight: fontWeight.describe('Default "normal"'),
66
+ textAlign,
67
+ truncate: z.boolean().optional(),
68
+ maxLines: z.number().optional(),
69
+ });
70
+ export const labelSchema = z.object({
71
+ text: z.union([z.string(), z.number()]).describe("Label text"),
72
+ htmlFor: z.string().optional(),
73
+ color: colorProp,
74
+ size: z.enum(TEXT_SIZES).optional().describe('Default "sm"'),
75
+ fontWeight: fontWeight.describe('Default "medium"'),
76
+ textAlign,
77
+ truncate: z.boolean().optional(),
78
+ width: sizeValue.optional(),
79
+ });
80
+ export const boldSchema = z.object({ text: z.string(), fontWeight });
81
+ export const inlineTextSchema = z.object({ text: z.string() });
82
+ export const blockquoteSchema = z.object({
83
+ text: z.string().describe("The quoted text, with inline markdown"),
84
+ });
85
+ export const BADGE_SIZES = ["sm", "md", "lg"] as const;
86
+ export const badgeSchema = z.object({
87
+ label: z.string().describe("Badge text"),
88
+ color: z
89
+ .enum(["secondary", "success", "danger", "warning", "info", "discovery"])
90
+ .optional()
91
+ .describe('Default "secondary"'),
92
+ size: z.enum(BADGE_SIZES).optional().describe('Default "md"'),
93
+ pill: z.boolean().optional().describe("Default true"),
94
+ variant: z
95
+ .enum(["soft", "solid", "outline"])
96
+ .optional()
97
+ .describe('Default "soft"'),
98
+ fontWeight: fontWeight.describe('Default "medium"'),
99
+ maxWidth: sizeValue.optional(),
100
+ padding: sizeValue.optional(),
101
+ });
102
+ export const codeSchema = z.object({
103
+ text: z.string().describe("Source code"),
104
+ language: z.string().optional(),
105
+ });
106
+ export const markdownSchema = z.object({
107
+ text: z.string().describe("Markdown source"),
108
+ streaming: z.boolean().optional().describe("Default false"),
109
+ });
110
+ export const mathSchema = z.object({
111
+ value: z.string().describe("TeX source"),
112
+ block: z.boolean().optional().describe("Default false"),
113
+ });
114
+ export const shimmerSchema = z.object({
115
+ ...typographyProps,
116
+ text: z.string(),
117
+ size: z.enum(TEXT_SIZES).optional().describe('Default "md"'),
118
+ lineThrough: z.boolean().optional(),
119
+ });
120
+ export const linkSchema = z.object({
121
+ text: z.string().describe("Link text"),
122
+ href: z.string().describe("URL"),
123
+ title: z.string().optional(),
124
+ });
125
+
126
+ /**
127
+ * The standard text components, without their framework components.
128
+ *
129
+ * - Text has a "multiple" `children` slot. The children render inline
130
+ * after the text.
131
+ * - Tooltip has two "single" slots: `trigger` and `content`.
132
+ * - Link is a plain link. It opens http, https and mailto URLs only.
133
+ */
134
+ export const textDeclarations = {
135
+ Title: {
136
+ description:
137
+ 'A heading in a Card or next to another component; a heading alone is markdown. Size "2xl" at most once per surface, "lg" for sections. "sm" is an h4, "md"/"lg" an h3 (default "md"), "xl" and up an h2. Bold unless strong is false.',
138
+ props: titleSchema,
139
+ },
140
+ Text: {
141
+ description:
142
+ 'Body text in a Card or next to another component; a paragraph alone is markdown outside the fence. Color "default" or "secondary". `text` takes inline markdown (**bold**, *italic*, ~~strike~~, ++underline++, `code`, [link](url)). `children` ids render inline after it, e.g. a Badge.',
143
+ props: textSchema,
144
+ slots: CHILDREN_SLOT,
145
+ },
146
+ Caption: {
147
+ description:
148
+ "Small secondary text: a hint under a control, or a label in a Row. `text` can have inline markdown.",
149
+ props: captionSchema,
150
+ },
151
+ Label: {
152
+ description: "The label of a form field.",
153
+ props: labelSchema,
154
+ },
155
+ Bold: {
156
+ description: "Bold inline text.",
157
+ props: boldSchema,
158
+ },
159
+ Italic: {
160
+ description: "Italic inline text.",
161
+ props: inlineTextSchema,
162
+ },
163
+ Underline: {
164
+ description: "Underlined inline text.",
165
+ props: inlineTextSchema,
166
+ },
167
+ Strikethrough: {
168
+ description: "Struck-through inline text.",
169
+ props: inlineTextSchema,
170
+ },
171
+ Badge: {
172
+ description:
173
+ "A small status pill. Use the colors success, danger and warning only to show a status, not for decoration.",
174
+ props: badgeSchema,
175
+ },
176
+ Blockquote: {
177
+ description:
178
+ "A block quotation with a line on the left. `text` can have inline markdown.",
179
+ props: blockquoteSchema,
180
+ },
181
+ Code: {
182
+ description: "A block of code in a monospace font.",
183
+ props: codeSchema,
184
+ },
185
+ Markdown: {
186
+ description:
187
+ "A block of GitHub-flavored markdown. Use it only next to other components, for example in a table cell or next to a chart. Markdown alone goes outside the fence.",
188
+ props: markdownSchema,
189
+ },
190
+ Math: {
191
+ description:
192
+ "A TeX math formula, typeset with KaTeX. Set block to true for a centered formula on its own line.",
193
+ props: mathSchema,
194
+ },
195
+ ShimmerText: {
196
+ description:
197
+ "Text with a moving shimmer. It shows that something is loading or pending.",
198
+ props: shimmerSchema,
199
+ },
200
+ Link: {
201
+ description:
202
+ "A link. Only http, https and mailto URLs work. It opens in a new tab.",
203
+ props: linkSchema,
204
+ },
205
+ Tooltip: {
206
+ description:
207
+ "Shows `content` when the user points at or focuses `trigger`. `trigger`: one child id, a Text, Icon or Badge (not a Button or Link). `content`: one child id of short text, no links or buttons.",
208
+ slots: { trigger: "single", content: "single" } as const,
209
+ },
210
+ };
@@ -0,0 +1,198 @@
1
+ import type { BACKGROUNDS, BORDER_COLORS, RADII, TEXT_COLORS } from "./tokens";
2
+
3
+ type TextColor = (typeof TEXT_COLORS)[number];
4
+ type BorderColor = (typeof BORDER_COLORS)[number];
5
+ type Background = (typeof BACKGROUNDS)[number];
6
+ type Radius = Exclude<(typeof RADII)[number], "full">;
7
+ type Tint = "info" | "warning" | "caution" | "success" | "danger" | "discovery";
8
+ type ChartSeries = 1 | 2 | 3 | 4 | 5 | 6;
9
+
10
+ /** Every CSS variable that the standard components read. */
11
+ export type GenerativeUIThemeVariable =
12
+ | `--a2ui-color-text-${TextColor}`
13
+ | `--a2ui-color-${Background}`
14
+ | `--a2ui-color-border-${BorderColor}`
15
+ | `--a2ui-color-${Tint}-soft`
16
+ | `--a2ui-radius-${Radius}`
17
+ | `--a2ui-chart-${ChartSeries}`
18
+ | "--a2ui-color-accent"
19
+ | "--a2ui-color-on-accent"
20
+ | "--a2ui-color-panel"
21
+ | "--a2ui-color-control"
22
+ | "--a2ui-color-focus"
23
+ | "--a2ui-color-shimmer"
24
+ | "--a2ui-color-chart-cursor"
25
+ | "--a2ui-color-slider-track"
26
+ | "--a2ui-color-badge-secondary"
27
+ | "--a2ui-color-border-control"
28
+ | "--a2ui-color-highlight-green"
29
+ | "--a2ui-color-highlight-orange"
30
+ | "--a2ui-color-highlight-pink"
31
+ | "--a2ui-color-backdrop"
32
+ | "--a2ui-color-overlay"
33
+ | "--a2ui-color-rating"
34
+ | "--a2ui-shadow-xs"
35
+ | "--a2ui-shadow-sm"
36
+ | "--a2ui-shadow-soft"
37
+ | "--a2ui-shadow-md"
38
+ | "--a2ui-font-family"
39
+ | "--a2ui-heading-margin"
40
+ | "--a2ui-block-margin";
41
+
42
+ /** Values for the theme variables. A name that is not one is a type error. */
43
+ export type GenerativeUIThemeVariables = {
44
+ [Variable in GenerativeUIThemeVariable]?: string;
45
+ };
46
+
47
+ /** The values of one color scheme, plus the map style of that scheme. */
48
+ export type GenerativeUIThemeValues = GenerativeUIThemeVariables & {
49
+ /** A MapLibre style URL for the Map component. */
50
+ mapStyle?: string;
51
+ };
52
+
53
+ /**
54
+ * The look of generated UI. Values at the top level apply in light and in
55
+ * dark mode. Values in `dark` replace them in dark mode. Dark mode is on
56
+ * when an ancestor of the surface has the `dark` class, like the CopilotKit
57
+ * chat.
58
+ *
59
+ * @example
60
+ * ```ts
61
+ * const theme: GenerativeUITheme = {
62
+ * "--a2ui-color-accent": "#d97706",
63
+ * "--a2ui-font-family": "Inter, sans-serif",
64
+ * dark: { "--a2ui-color-panel": "#1f2937" },
65
+ * };
66
+ * ```
67
+ */
68
+ export type GenerativeUITheme = GenerativeUIThemeValues & {
69
+ dark?: GenerativeUIThemeValues;
70
+ };
71
+
72
+ /**
73
+ * The built-in dark values. The light values are the fallbacks in the
74
+ * components, so a surface is light when no variable is set.
75
+ */
76
+ export const DARK_THEME: GenerativeUIThemeVariables = {
77
+ "--a2ui-color-text-default": "#ececec",
78
+ "--a2ui-color-text-prose": "#ececec",
79
+ "--a2ui-color-text-primary": "#ececec",
80
+ "--a2ui-color-text-emphasis": "#fff",
81
+ "--a2ui-color-text-secondary": "#b4b4b4",
82
+ "--a2ui-color-text-tertiary": "#8e8e8e",
83
+ "--a2ui-color-text-success": "#4fd1a5",
84
+ "--a2ui-color-text-info": "#6cb6ff",
85
+ "--a2ui-color-text-warning": "#e3b341",
86
+ "--a2ui-color-text-caution": "#e3b341",
87
+ "--a2ui-color-text-danger": "#ff7b72",
88
+ "--a2ui-color-text-discovery": "#bc9cff",
89
+ "--a2ui-color-surface": "#1f1f1f",
90
+ "--a2ui-color-surface-secondary": "#2a2a2a",
91
+ "--a2ui-color-surface-tertiary": "#3a3a3a",
92
+ "--a2ui-color-surface-elevated": "#262626",
93
+ "--a2ui-color-surface-elevated-secondary": "#2f2f2f",
94
+ "--a2ui-color-surface-inverted": "#f2f2f2",
95
+ "--a2ui-color-surface-soft": "#232323",
96
+ "--a2ui-color-info": "rgba(80, 160, 255, 0.14)",
97
+ "--a2ui-color-warning": "rgba(240, 180, 60, 0.14)",
98
+ "--a2ui-color-caution": "rgba(240, 180, 60, 0.14)",
99
+ "--a2ui-color-success": "rgba(60, 200, 150, 0.14)",
100
+ "--a2ui-color-danger": "rgba(255, 110, 100, 0.14)",
101
+ "--a2ui-color-discovery": "rgba(170, 130, 255, 0.14)",
102
+ "--a2ui-color-info-soft": "rgba(80, 160, 255, 0.08)",
103
+ "--a2ui-color-warning-soft": "rgba(240, 180, 60, 0.08)",
104
+ "--a2ui-color-caution-soft": "rgba(240, 180, 60, 0.08)",
105
+ "--a2ui-color-success-soft": "rgba(60, 200, 150, 0.08)",
106
+ "--a2ui-color-danger-soft": "rgba(255, 110, 100, 0.08)",
107
+ "--a2ui-color-discovery-soft": "rgba(170, 130, 255, 0.08)",
108
+ "--a2ui-color-info-solid": "#3b8eea",
109
+ "--a2ui-color-warning-solid": "#c99a2e",
110
+ "--a2ui-color-caution-solid": "#c99a2e",
111
+ "--a2ui-color-success-solid": "#2fae86",
112
+ "--a2ui-color-danger-solid": "#e5534b",
113
+ "--a2ui-color-discovery-solid": "#9a6ff0",
114
+ "--a2ui-color-border-default": "rgba(255, 255, 255, 0.12)",
115
+ "--a2ui-color-border-subtle": "rgba(255, 255, 255, 0.06)",
116
+ "--a2ui-color-border-strong": "#4a4a4a",
117
+ "--a2ui-color-border-info": "#2f5f8f",
118
+ "--a2ui-color-border-warning": "#6b5420",
119
+ "--a2ui-color-border-caution": "#6b5420",
120
+ "--a2ui-color-border-success": "#1f5f4b",
121
+ "--a2ui-color-border-danger": "#7a2f2b",
122
+ "--a2ui-color-border-discovery": "#4f3a80",
123
+ "--a2ui-color-border-control": "rgba(255, 255, 255, 0.2)",
124
+ "--a2ui-color-accent": "#f2f2f2",
125
+ "--a2ui-color-on-accent": "#0d0d0d",
126
+ "--a2ui-color-panel": "#262626",
127
+ "--a2ui-color-control": "#2f2f2f",
128
+ "--a2ui-color-focus": "#3b9bff",
129
+ "--a2ui-color-shimmer": "rgba(255, 255, 255, 0.12)",
130
+ "--a2ui-color-chart-cursor": "rgba(255, 255, 255, 0.06)",
131
+ "--a2ui-color-slider-track": "rgba(255, 255, 255, 0.1)",
132
+ "--a2ui-color-badge-secondary": "rgba(255, 255, 255, 0.08)",
133
+ "--a2ui-color-highlight-green": "#1d4a37",
134
+ "--a2ui-color-highlight-orange": "#4d3418",
135
+ "--a2ui-color-highlight-pink": "#4d2338",
136
+ "--a2ui-shadow-xs": "0 1px 2px rgba(0, 0, 0, 0.5)",
137
+ "--a2ui-shadow-sm": "0 1px 3px rgba(0, 0, 0, 0.5)",
138
+ "--a2ui-shadow-soft": "0 1px 3px rgba(0, 0, 0, 0.3)",
139
+ "--a2ui-shadow-md": "0 4px 12px rgba(0, 0, 0, 0.4)",
140
+ };
141
+
142
+ const VARIABLE_NAME = /^--a2ui-[a-z0-9-]+$/;
143
+ // A value goes into a stylesheet, so it must not be able to end the rule or
144
+ // the element.
145
+ const UNSAFE_VALUE = /[{};<>]/;
146
+
147
+ /** Matches the `dark` class on an ancestor of a surface, or on the surface. */
148
+ const DARK = ":where(.dark)";
149
+
150
+ /** The default dark values, as a rule that any theme rule beats. */
151
+ export const DARK_THEME_CSS = `:where(.dark .a2ui-surface,.a2ui-surface.dark){${declarations(DARK_THEME)}}`;
152
+
153
+ function declarations(values: GenerativeUIThemeValues | undefined) {
154
+ return Object.entries(values ?? {})
155
+ .filter(
156
+ ([name, value]) =>
157
+ VARIABLE_NAME.test(name) &&
158
+ typeof value === "string" &&
159
+ !UNSAFE_VALUE.test(value),
160
+ )
161
+ .map(([name, value]) => `${name}:${value}`)
162
+ .join(";");
163
+ }
164
+
165
+ /** A short, stable id for a stylesheet. */
166
+ function hashOf(text: string) {
167
+ let hash = 5381;
168
+ for (let index = 0; index < text.length; index++) {
169
+ hash = (hash * 33) ^ text.charCodeAt(index);
170
+ }
171
+ return `t${(hash >>> 0).toString(36)}`;
172
+ }
173
+
174
+ /**
175
+ * The stylesheet of a theme: its values on the surfaces that carry its id,
176
+ * then its dark values in dark mode. `undefined` when the theme sets no
177
+ * variable. Values that could break out of the rule are left out.
178
+ *
179
+ * @example
180
+ * ```ts
181
+ * themeStyleSheet({ "--a2ui-color-accent": "red" });
182
+ * // { id: "t…", css: '.a2ui-surface[data-a2ui-theme="t…"]{--a2ui-color-accent:red}' }
183
+ * ```
184
+ */
185
+ export function themeStyleSheet(theme: GenerativeUITheme | undefined) {
186
+ const { dark, ...base } = theme ?? {};
187
+ const both = declarations(base);
188
+ const darkOnly = declarations(dark);
189
+ if (!both && !darkOnly) return undefined;
190
+ const id = hashOf(`${both}|${darkOnly}`);
191
+ // The class makes these rules win over an app rule on `.a2ui-surface`.
192
+ const self = `.a2ui-surface[data-a2ui-theme="${id}"]`;
193
+ const rules = [
194
+ both && `${self}{${both}}`,
195
+ darkOnly && `${DARK} ${self},${self}${DARK}{${darkOnly}}`,
196
+ ].filter(Boolean);
197
+ return { id, css: rules.join("") };
198
+ }