@copilotkit/shared 2.0.0-rc.5 → 2.0.0-rc.50

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 (569) hide show
  1. package/README.md +4 -15
  2. package/dist/a2ui-envelope.cjs +3 -3
  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 +3 -3
  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 +20 -7
  325. package/dist/generative-ui/types.d.cts.map +1 -1
  326. package/dist/generative-ui/types.d.mts +20 -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 +18 -17
  337. package/dist/index.d.cts.map +1 -1
  338. package/dist/index.d.mts +18 -17
  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 +5 -7
  383. package/dist/utils/index.d.cts.map +1 -1
  384. package/dist/utils/index.d.mts +5 -7
  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/dist/utils/types.cjs.map +1 -1
  413. package/dist/utils/types.d.cts +5 -12
  414. package/dist/utils/types.d.cts.map +1 -1
  415. package/dist/utils/types.d.mts +5 -12
  416. package/dist/utils/types.d.mts.map +1 -1
  417. package/dist/utils/types.mjs.map +1 -1
  418. package/package.json +19 -32
  419. package/scripts/verify-cjs-exports.cjs +1 -1
  420. package/src/__tests__/a2ui-envelope.test.ts +38 -13
  421. package/src/__tests__/a2ui-prompts.test.ts +47 -14
  422. package/src/__tests__/fixtures/prompt-goldens.json +354 -0
  423. package/src/__tests__/prompt-spec.test.ts +191 -0
  424. package/src/__tests__/root-entry-browser-safety.test.ts +5 -7
  425. package/src/__tests__/schema-render.test.ts +323 -0
  426. package/src/__tests__/standard-schema.test.ts +61 -101
  427. package/src/a2ui-envelope.ts +9 -7
  428. package/src/a2ui-prompts.ts +47 -96
  429. package/src/attachments/__tests__/utils.test.ts +22 -0
  430. package/src/attachments/types.ts +1 -3
  431. package/src/attachments/utils.ts +23 -5
  432. package/src/finalize-events.ts +16 -0
  433. package/src/generative-ui/__tests__/clone-value-differential.test.ts +480 -0
  434. package/src/generative-ui/__tests__/clone-value.test.ts +226 -0
  435. package/src/generative-ui/__tests__/render-ui-args.test.ts +7 -7
  436. package/src/generative-ui/__tests__/validate-operation.test.ts +19 -13
  437. package/src/generative-ui/base.ts +9 -0
  438. package/src/generative-ui/basic-functions.ts +1 -1
  439. package/src/generative-ui/catalog/catalog-export.ts +478 -0
  440. package/src/generative-ui/catalog/catalog.ts +1167 -0
  441. package/src/generative-ui/catalog/errors.ts +102 -0
  442. package/src/generative-ui/catalog/index.ts +6 -0
  443. package/src/generative-ui/catalog/json-schema.ts +14 -0
  444. package/src/generative-ui/catalog/refs.ts +87 -0
  445. package/src/generative-ui/catalog/schema.ts +107 -0
  446. package/src/generative-ui/child-refs.ts +5 -4
  447. package/src/generative-ui/clone-value.ts +511 -0
  448. package/src/generative-ui/compact-schema.ts +277 -0
  449. package/src/generative-ui/index.ts +14 -0
  450. package/src/generative-ui/is-record.ts +6 -1
  451. package/src/generative-ui/prompt-spec.ts +335 -0
  452. package/src/generative-ui/prompt.ts +25 -75
  453. package/src/generative-ui/render-ui-args.ts +3 -0
  454. package/src/generative-ui/schema-render.ts +378 -0
  455. package/src/generative-ui/standard/__tests__/standard-helpers.test.ts +407 -0
  456. package/src/generative-ui/standard/__tests__/theme.test.ts +61 -0
  457. package/src/generative-ui/standard/__tests__/tokens.test.ts +139 -0
  458. package/src/generative-ui/standard/chart-config.ts +434 -0
  459. package/src/generative-ui/standard/chart.ts +79 -0
  460. package/src/generative-ui/standard/checks.ts +98 -0
  461. package/src/generative-ui/standard/components.ts +35 -0
  462. package/src/generative-ui/standard/composites.ts +158 -0
  463. package/src/generative-ui/standard/data.ts +213 -0
  464. package/src/generative-ui/standard/declarations.ts +57 -0
  465. package/src/generative-ui/standard/feedback.ts +105 -0
  466. package/src/generative-ui/standard/index.ts +55 -0
  467. package/src/generative-ui/standard/inputs.ts +423 -0
  468. package/src/generative-ui/standard/layout.ts +312 -0
  469. package/src/generative-ui/standard/map-helpers.ts +155 -0
  470. package/src/generative-ui/standard/map.ts +32 -0
  471. package/src/generative-ui/standard/media.ts +265 -0
  472. package/src/generative-ui/standard/parameter-order.ts +155 -0
  473. package/src/generative-ui/standard/style-helpers.ts +170 -0
  474. package/src/generative-ui/standard/styles.ts +79 -0
  475. package/src/generative-ui/standard/text.ts +210 -0
  476. package/src/generative-ui/standard/theme.ts +198 -0
  477. package/src/generative-ui/standard/tokens.ts +317 -0
  478. package/src/generative-ui/standard/url.ts +51 -0
  479. package/src/generative-ui/thrown.ts +90 -0
  480. package/src/generative-ui/types.ts +23 -7
  481. package/src/generative-ui/validate-operation.ts +2 -2
  482. package/src/index.ts +9 -17
  483. package/src/standard-schema.ts +24 -27
  484. package/src/telemetry/lambda-client.ts +8 -3
  485. package/src/telemetry/model-host.test.ts +2 -5
  486. package/src/telemetry/telemetry-disabled.ts +0 -5
  487. package/src/types/message.ts +1 -19
  488. package/src/utils/__tests__/errors.test.ts +44 -0
  489. package/src/utils/__tests__/json-schema.test.ts +3 -479
  490. package/src/utils/__tests__/random-id.test.ts +37 -0
  491. package/src/utils/errors.ts +28 -85
  492. package/src/utils/index.ts +0 -2
  493. package/src/utils/inspector-visibility.test.ts +26 -0
  494. package/src/utils/inspector-visibility.ts +35 -3
  495. package/src/utils/json-schema.ts +5 -152
  496. package/src/utils/random-id.ts +17 -37
  497. package/src/utils/types.ts +4 -11
  498. package/tsconfig.json +3 -1
  499. package/tsdown.config.ts +2 -19
  500. package/dist/event-transforms/index.cjs +0 -15
  501. package/dist/event-transforms/index.d.cts +0 -4
  502. package/dist/event-transforms/index.d.mts +0 -4
  503. package/dist/event-transforms/index.mjs +0 -5
  504. package/dist/event-transforms/open-generative-ui-middleware.cjs +0 -286
  505. package/dist/event-transforms/open-generative-ui-middleware.cjs.map +0 -1
  506. package/dist/event-transforms/open-generative-ui-middleware.d.cts +0 -60
  507. package/dist/event-transforms/open-generative-ui-middleware.d.cts.map +0 -1
  508. package/dist/event-transforms/open-generative-ui-middleware.d.mts +0 -60
  509. package/dist/event-transforms/open-generative-ui-middleware.d.mts.map +0 -1
  510. package/dist/event-transforms/open-generative-ui-middleware.mjs +0 -283
  511. package/dist/event-transforms/open-generative-ui-middleware.mjs.map +0 -1
  512. package/dist/event-transforms/recorded-events.cjs +0 -59
  513. package/dist/event-transforms/recorded-events.cjs.map +0 -1
  514. package/dist/event-transforms/recorded-events.d.cts +0 -23
  515. package/dist/event-transforms/recorded-events.d.cts.map +0 -1
  516. package/dist/event-transforms/recorded-events.d.mts +0 -23
  517. package/dist/event-transforms/recorded-events.d.mts.map +0 -1
  518. package/dist/event-transforms/recorded-events.mjs +0 -58
  519. package/dist/event-transforms/recorded-events.mjs.map +0 -1
  520. package/dist/telemetry/events.d.cts +0 -72
  521. package/dist/telemetry/events.d.cts.map +0 -1
  522. package/dist/telemetry/events.d.mts +0 -72
  523. package/dist/telemetry/events.d.mts.map +0 -1
  524. package/dist/telemetry/index.cjs +0 -18
  525. package/dist/telemetry/index.d.cts +0 -5
  526. package/dist/telemetry/index.d.mts +0 -5
  527. package/dist/telemetry/index.mjs +0 -6
  528. package/dist/telemetry/telemetry-client.cjs +0 -165
  529. package/dist/telemetry/telemetry-client.cjs.map +0 -1
  530. package/dist/telemetry/telemetry-client.d.cts +0 -87
  531. package/dist/telemetry/telemetry-client.d.cts.map +0 -1
  532. package/dist/telemetry/telemetry-client.d.mts +0 -87
  533. package/dist/telemetry/telemetry-client.d.mts.map +0 -1
  534. package/dist/telemetry/telemetry-client.mjs +0 -164
  535. package/dist/telemetry/telemetry-client.mjs.map +0 -1
  536. package/dist/telemetry/utils.cjs +0 -14
  537. package/dist/telemetry/utils.cjs.map +0 -1
  538. package/dist/telemetry/utils.mjs +0 -13
  539. package/dist/telemetry/utils.mjs.map +0 -1
  540. package/dist/utils/conditions.cjs +0 -32
  541. package/dist/utils/conditions.cjs.map +0 -1
  542. package/dist/utils/conditions.d.cts +0 -31
  543. package/dist/utils/conditions.d.cts.map +0 -1
  544. package/dist/utils/conditions.d.mts +0 -31
  545. package/dist/utils/conditions.d.mts.map +0 -1
  546. package/dist/utils/conditions.mjs +0 -31
  547. package/dist/utils/conditions.mjs.map +0 -1
  548. package/dist/utils/console-styling.cjs +0 -91
  549. package/dist/utils/console-styling.cjs.map +0 -1
  550. package/dist/utils/console-styling.d.cts +0 -65
  551. package/dist/utils/console-styling.d.cts.map +0 -1
  552. package/dist/utils/console-styling.d.mts +0 -65
  553. package/dist/utils/console-styling.d.mts.map +0 -1
  554. package/dist/utils/console-styling.mjs +0 -85
  555. package/dist/utils/console-styling.mjs.map +0 -1
  556. package/src/__tests__/zod-regression.test.ts +0 -319
  557. package/src/event-transforms/index.ts +0 -5
  558. package/src/event-transforms/open-generative-ui-middleware.ts +0 -392
  559. package/src/event-transforms/recorded-events.test.ts +0 -166
  560. package/src/event-transforms/recorded-events.ts +0 -74
  561. package/src/telemetry/events.ts +0 -68
  562. package/src/telemetry/index.ts +0 -9
  563. package/src/telemetry/telemetry-blank-license-identity.test.ts +0 -128
  564. package/src/telemetry/telemetry-client.test.ts +0 -798
  565. package/src/telemetry/telemetry-client.ts +0 -328
  566. package/src/telemetry/utils.ts +0 -15
  567. package/src/utils/__tests__/conditions.test.ts +0 -161
  568. package/src/utils/conditions.ts +0 -116
  569. package/src/utils/console-styling.ts +0 -126
@@ -0,0 +1,312 @@
1
+ import { z } from "zod";
2
+ import { child } from "../catalog/refs";
3
+ import { ALIGN, BORDER_COLORS, JUSTIFY, RADII, WRAP } from "./tokens";
4
+
5
+ /** A number is a count of 4px steps. A string is raw CSS. */
6
+ export const sizeValue = z.union([z.number(), z.string()]);
7
+
8
+ /** The A2UI `weight`: how much of the free space of a Row or Column to take. */
9
+ export const weightProp = z
10
+ .number()
11
+ .optional()
12
+ .describe("flex-grow in a Row or Column");
13
+
14
+ export const radiusValue = z.union([
15
+ z.enum(RADII),
16
+ z.number(),
17
+ z.string(),
18
+ z.object({
19
+ topLeft: z.string().optional(),
20
+ topRight: z.string().optional(),
21
+ bottomLeft: z.string().optional(),
22
+ bottomRight: z.string().optional(),
23
+ }),
24
+ ]);
25
+
26
+ /**
27
+ * The layout props of every container. Spread them into a props schema:
28
+ * `z.object({ ...layoutProps, variant: ... })`. The children of a container
29
+ * are a slot, not a prop.
30
+ */
31
+ export const layoutProps = {
32
+ align: z.enum(ALIGN).optional(),
33
+ justify: z.enum(JUSTIFY).optional(),
34
+ wrap: z.enum(WRAP).optional(),
35
+ gap: sizeValue.optional().describe("4px steps when a number"),
36
+ rowGap: sizeValue.optional(),
37
+ columnGap: sizeValue.optional(),
38
+ padding: sizeValue.optional().describe("4px steps when a number"),
39
+ background: z
40
+ .string()
41
+ .optional()
42
+ .describe(
43
+ 'Leave it unset. A surface token such as surface, surface-secondary, info, success, warning, danger, discovery, or one with -solid, or a CSS color. Only one summary panel in a Card uses "surface-secondary"',
44
+ ),
45
+ border: z.boolean().optional(),
46
+ borderColor: z.enum(BORDER_COLORS).optional(),
47
+ radius: radiusValue.optional(),
48
+ width: sizeValue.optional(),
49
+ height: sizeValue.optional(),
50
+ minWidth: sizeValue.optional(),
51
+ maxWidth: sizeValue.optional(),
52
+ minHeight: sizeValue.optional(),
53
+ maxHeight: sizeValue.optional(),
54
+ flex: z.number().optional(),
55
+ weight: weightProp,
56
+ aspectRatio: z.string().optional(),
57
+ scrollable: z.boolean().optional(),
58
+ clip: z.boolean().optional(),
59
+ shadow: z.boolean().optional(),
60
+ inline: z.boolean().optional(),
61
+ role: z.string().optional().describe("ARIA role"),
62
+ flush: z.boolean().optional().describe("No padding"),
63
+ minSize: sizeValue.optional().describe("Minimum width and height"),
64
+ maxSize: sizeValue.optional().describe("Maximum width and height"),
65
+ disableAutoSpacing: z
66
+ .boolean()
67
+ .optional()
68
+ .describe("No default gap between children"),
69
+ };
70
+
71
+ const layoutSchema = z.object(layoutProps);
72
+
73
+ /** The arguments of a click or visibility event: none. */
74
+ export const NO_ARGS = z.object({});
75
+
76
+ /**
77
+ * The `onVisible` event of every container: sent once, the first time the
78
+ * container scrolls into view.
79
+ */
80
+ export const VISIBLE_EVENT = {
81
+ onVisible: {
82
+ description:
83
+ "Sent once, the first time the container scrolls into view. Use it to load more content lazily.",
84
+ parameters: NO_ARGS,
85
+ },
86
+ } as const;
87
+
88
+ export type LayoutProps = z.output<typeof layoutSchema>;
89
+
90
+ /** The slot of every container: a list of children or a template. */
91
+ export const CHILDREN_SLOT = { children: "multiple" } as const;
92
+
93
+ export const boxSchema = z.object({
94
+ ...layoutProps,
95
+ direction: z.enum(["col", "row"]).optional().describe('Default "col"'),
96
+ });
97
+ export const gridSchema = z.object({
98
+ ...layoutProps,
99
+ columns: z
100
+ .union([z.number(), z.string()])
101
+ .optional()
102
+ .describe("Column count or CSS template. Default 2"),
103
+ minChildWidth: sizeValue.optional(),
104
+ rows: z.union([z.number(), z.string()]).optional(),
105
+ });
106
+ export const gridItemSchema = z.object({
107
+ ...layoutProps,
108
+ span: z.number().optional(),
109
+ rowSpan: z.number().optional(),
110
+ });
111
+ export const cardSchema = z.object({
112
+ ...layoutProps,
113
+ variant: z
114
+ .enum(["default", "outline", "section", "soft", "elevated", "transparent"])
115
+ .optional(),
116
+ shadowStyle: z
117
+ .enum(["none", "sm", "md"])
118
+ .optional()
119
+ .describe("Overrides the shadow of the variant"),
120
+ size: z
121
+ .enum(["sm", "md", "lg"])
122
+ .optional()
123
+ .describe('The padding preset: 8, 16 or 24px. Default "md"'),
124
+ });
125
+ export const flowSchema = z.object({
126
+ ...layoutProps,
127
+ columns: z.number().optional(),
128
+ rows: z.number().optional(),
129
+ layout: z.enum(["pack", "fixed"]).optional().describe('Default "pack"'),
130
+ });
131
+ export const flowItemSchema = z.object({
132
+ ...layoutProps,
133
+ span: z.number().optional(),
134
+ rowSpan: z.number().optional(),
135
+ aspectRatio: z.string().optional().describe('Default "1 / 1"'),
136
+ aspectMode: z.enum(["soft", "fixed"]).optional(),
137
+ });
138
+ export const carouselSchema = z.object({
139
+ ...layoutProps,
140
+ label: z
141
+ .string()
142
+ .optional()
143
+ .describe("A short name of the carousel for screen readers"),
144
+ visibleItems: z.number().optional(),
145
+ showArrows: z.boolean().optional().describe("Default true"),
146
+ activeIndex: z
147
+ .number()
148
+ .optional()
149
+ .describe(
150
+ 'The index of the slide in view. Bind it with { "@path": "/x" } to read or set it',
151
+ ),
152
+ previousLabel: z.string().optional().describe('Default "Previous"'),
153
+ nextLabel: z.string().optional().describe('Default "Next"'),
154
+ snap: z.enum(["none", "proximity", "mandatory"]).optional(),
155
+ snapAlign: z.enum(["start", "center", "end"]).optional(),
156
+ });
157
+ export const CAROUSEL_MEDIA_SIZES = ["sm", "md", "lg"] as const;
158
+ export const carouselMediaItemSchema = z.object({
159
+ ...layoutProps,
160
+ url: z.string().describe("Image URL"),
161
+ description: z
162
+ .string()
163
+ .optional()
164
+ .describe("What the image shows, for screen readers"),
165
+ size: z
166
+ .enum(CAROUSEL_MEDIA_SIZES)
167
+ .optional()
168
+ .describe('The width: "sm" 160px, "md" 240px, "lg" 320px. Default "md"'),
169
+ aspectRatio: z.string().optional().describe('Default "4 / 3"'),
170
+ href: z.string().optional().describe("Opens this URL in a new tab"),
171
+ lightbox: z
172
+ .boolean()
173
+ .optional()
174
+ .describe("Default true: a click opens all slides full-screen"),
175
+ });
176
+ export const spacerSchema = z.object({ minSize: sizeValue.optional() });
177
+ export const tabsSchema = z.object({
178
+ tabs: z
179
+ .array(
180
+ z.object({
181
+ title: z.string().describe("The tab title"),
182
+ child: child("The id of the panel component"),
183
+ }),
184
+ )
185
+ .describe("One entry per tab"),
186
+ selectedIndex: z
187
+ .number()
188
+ .optional()
189
+ .describe(
190
+ 'The open tab. Default 0. Bind it with { "@path": "/x" } to read it',
191
+ ),
192
+ weight: weightProp,
193
+ });
194
+ export const dividerSchema = z.object({
195
+ axis: z
196
+ .enum(["horizontal", "vertical"])
197
+ .optional()
198
+ .describe('Default "horizontal"'),
199
+ weight: weightProp,
200
+ color: z.enum(BORDER_COLORS).optional(),
201
+ size: z.number().optional(),
202
+ spacing: sizeValue.optional(),
203
+ flush: z.boolean().optional(),
204
+ });
205
+
206
+ /**
207
+ * The standard layout components, without their framework components:
208
+ * containers, Spacer and Divider. Every container has a "multiple"
209
+ * `children` slot, so it takes a list of child ids or a template
210
+ * `{ componentId, path }`.
211
+ */
212
+ export const layoutDeclarations = {
213
+ Box: {
214
+ description:
215
+ 'A flex container. It stacks its children in a column (direction "row" puts them in a row). Use it to group children with gap, padding, border, radius or background.',
216
+ props: boxSchema,
217
+ events: VISIBLE_EVENT,
218
+ slots: CHILDREN_SLOT,
219
+ },
220
+ Column: {
221
+ description:
222
+ "A vertical flex container. Its default gap already separates sections, so do not add padding, background or a Spacer for space.",
223
+ props: layoutSchema,
224
+ events: VISIBLE_EVENT,
225
+ slots: CHILDREN_SLOT,
226
+ },
227
+ Row: {
228
+ description:
229
+ 'A horizontal flex container. Label and value pair: justify "spaceBetween", a Caption left and a Text with fontWeight "medium" right. Buttons go in a Row at the bottom of a Card: one variant "primary", the others default or "borderless".',
230
+ props: layoutSchema,
231
+ events: VISIBLE_EVENT,
232
+ slots: CHILDREN_SLOT,
233
+ },
234
+ Grid: {
235
+ description:
236
+ "A CSS grid container. On a narrow screen, its columns collapse towards one column.",
237
+ props: gridSchema,
238
+ events: VISIBLE_EVENT,
239
+ slots: CHILDREN_SLOT,
240
+ },
241
+ GridItem: {
242
+ description:
243
+ "A cell of a Grid, with an optional span. A span that covers all rendered columns fills the row.",
244
+ props: gridItemSchema,
245
+ events: VISIBLE_EVENT,
246
+ slots: CHILDREN_SLOT,
247
+ },
248
+ Card: {
249
+ description:
250
+ 'A bordered panel, only for an interactive panel (controls, a form, a configurator); tables, charts and text need none. Give it a Title and a Caption. Separate groups with a Divider or the gap, never a nested Card or bordered Box. Variant "section": no box; "outline": always a box. In markdown mode, without controls it renders as "section" unless variant or border is set.',
251
+ props: cardSchema,
252
+ events: VISIBLE_EVENT,
253
+ slots: { child: "single", children: "multiple" } as const,
254
+ },
255
+ Flow: {
256
+ description:
257
+ "A masonry-like grid that packs cells of different sizes. Put FlowItem children in it.",
258
+ props: flowSchema,
259
+ events: VISIBLE_EVENT,
260
+ slots: CHILDREN_SLOT,
261
+ },
262
+ FlowItem: {
263
+ description: "A cell of a Flow, with an optional span.",
264
+ props: flowItemSchema,
265
+ events: VISIBLE_EVENT,
266
+ slots: CHILDREN_SLOT,
267
+ },
268
+ Carousel: {
269
+ description:
270
+ "A horizontally scrolling row that snaps to its CarouselItem or CarouselMediaItem children, with arrows. Bind activeIndex to read or set the slide in view.",
271
+ props: carouselSchema,
272
+ events: VISIBLE_EVENT,
273
+ slots: CHILDREN_SLOT,
274
+ writable: ["activeIndex"] as const,
275
+ },
276
+ CarouselItem: {
277
+ description: "A slide of a Carousel.",
278
+ props: layoutSchema,
279
+ events: VISIBLE_EVENT,
280
+ slots: CHILDREN_SLOT,
281
+ },
282
+ CarouselMediaItem: {
283
+ description:
284
+ 'A Carousel slide: an image with its children (a Caption, a Text) under it. size "sm" 160px, "md" 240px (default), "lg" 320px wide. A click opens all slides full-screen, unless href or onClick is set.',
285
+ props: carouselMediaItemSchema,
286
+ events: {
287
+ ...VISIBLE_EVENT,
288
+ onClick: {
289
+ description:
290
+ "Sent when the user clicks the image. It replaces the full-screen view.",
291
+ parameters: NO_ARGS,
292
+ },
293
+ },
294
+ slots: CHILDREN_SLOT,
295
+ },
296
+ Spacer: {
297
+ description:
298
+ "Flexible empty space. You almost never need it: use the default gap.",
299
+ props: spacerSchema,
300
+ },
301
+ Divider: {
302
+ description:
303
+ 'A line between two groups: horizontal, or vertical with axis "vertical" in a Row.',
304
+ props: dividerSchema,
305
+ },
306
+ Tabs: {
307
+ description:
308
+ 'Tabs that show one panel at a time. Each tab has a title and the id of its panel component: "tabs":[{"title":"Specs","child":"specs"}].',
309
+ props: tabsSchema,
310
+ writable: ["selectedIndex"] as const,
311
+ },
312
+ };
@@ -0,0 +1,155 @@
1
+ // Framework-free map helpers of the standard Map component. The maplibre-gl
2
+ // parts are typed structurally, so maplibre-gl stays an optional peer of
3
+ // each framework package.
4
+ import type { MapMarker } from "./map";
5
+
6
+ /**
7
+ * The default basemap: the Positron style of OpenFreeMap. It is a keyless
8
+ * OpenStreetMap vector style with streets and labels at city zoom. A host
9
+ * sets another style with `theme: { mapStyle: "<style url>" }`, and a
10
+ * dark one with `theme: { dark: { mapStyle: "<style url>" } }`.
11
+ */
12
+ export const DEFAULT_MAP_STYLE =
13
+ "https://tiles.openfreemap.org/styles/positron";
14
+
15
+ /** The default basemap in dark mode: the Dark style of OpenFreeMap. */
16
+ export const DEFAULT_DARK_MAP_STYLE =
17
+ "https://tiles.openfreemap.org/styles/dark";
18
+
19
+ const ORDERING_OPS = new Set(["<", "<=", ">", ">="]);
20
+
21
+ // guardNumericFilter keeps its return type: the function calls itself, so
22
+ // TypeScript cannot infer it.
23
+ /**
24
+ * A filter expression with every numeric comparison of a feature property
25
+ * guarded by `["has", property]`.
26
+ *
27
+ * MapLibre adds a number assertion to `["get", key]` in a comparison with a
28
+ * number. The assertion logs a warning for each feature without the
29
+ * property. OpenFreeMap styles compare `ref_length` on roads that mostly do
30
+ * not have it. The comparison is false for a missing property in both
31
+ * cases, so the guard changes no result.
32
+ *
33
+ * @param filter - A MapLibre filter expression, at any depth.
34
+ */
35
+ export function guardNumericFilter(filter: unknown): unknown {
36
+ if (!Array.isArray(filter)) return filter;
37
+ const [op, left, right] = filter;
38
+ const isPropertyComparison =
39
+ typeof op === "string" &&
40
+ ORDERING_OPS.has(op) &&
41
+ Array.isArray(left) &&
42
+ left[0] === "get" &&
43
+ typeof left[1] === "string" &&
44
+ typeof right === "number";
45
+ if (isPropertyComparison) return ["all", ["has", left[1]], filter];
46
+ return filter.map((part) => guardNumericFilter(part));
47
+ }
48
+
49
+ /**
50
+ * The style with `guardNumericFilter` applied to the filter of each layer.
51
+ * Pass it as the `transformStyle` of MapLibre's `setStyle`.
52
+ *
53
+ * @param style - A MapLibre style object.
54
+ */
55
+ export function guardStyleFilters<Style extends { layers?: readonly object[] }>(
56
+ style: Style,
57
+ ) {
58
+ const layers = style.layers;
59
+ if (layers === undefined) return style;
60
+ const guarded = layers.map((layer) =>
61
+ "filter" in layer
62
+ ? { ...layer, filter: guardNumericFilter(layer.filter) }
63
+ : layer,
64
+ );
65
+ // The guard only wraps a comparison in ["all", ["has", key], comparison],
66
+ // which is a valid filter, so each layer keeps its type.
67
+ return { ...style, layers: guarded } as Style;
68
+ }
69
+
70
+ /** The id of the map stylesheet (`MAP_CSS`) in the document. */
71
+ export const MAP_STYLE_ID = "a2ui-standard-map";
72
+
73
+ /** The source and layer id of the route line between the markers. */
74
+ export const ROUTE_SOURCE = "a2ui-route";
75
+
76
+ /**
77
+ * The few maplibre-gl rules that markers and popups need, so a host does not
78
+ * have to import maplibre-gl.css. The list of places is hidden while the map
79
+ * shows. It shows when a keyboard user moves focus into it.
80
+ */
81
+ export const MAP_CSS = [
82
+ ".maplibregl-map{position:relative;overflow:hidden}",
83
+ ".maplibregl-canvas{position:absolute;left:0;top:0}",
84
+ ".maplibregl-canvas-container{width:100%;height:100%}",
85
+ ".maplibregl-marker{position:absolute;top:0;left:0;will-change:transform;cursor:pointer}",
86
+ ".maplibregl-popup{position:absolute;top:0;left:0;display:flex;will-change:transform;pointer-events:none}",
87
+ ".maplibregl-popup-content{position:relative;background:var(--a2ui-color-surface-elevated, #fff);color:var(--a2ui-color-text-default, #0d0d0d);border-radius:6px;padding:6px 10px;font:12px/1.4 system-ui,sans-serif;box-shadow:var(--a2ui-shadow-sm, 0 1px 4px rgba(0,0,0,.2));pointer-events:auto}",
88
+ ".maplibregl-popup-tip{display:none}",
89
+ ".maplibregl-popup-close-button{display:none}",
90
+ ".maplibregl-ctrl-attrib{font:10px system-ui,sans-serif;position:absolute;right:0;bottom:0;background:color-mix(in srgb, var(--a2ui-color-surface, #fff) 70%, transparent);color:var(--a2ui-color-text-secondary, #5d5d5d);padding:0 4px}",
91
+ ".maplibregl-ctrl-attrib a{color:inherit}",
92
+ // The cooperative-gesture hint is hidden until MapLibre adds `maplibregl-show`.
93
+ ".maplibregl-cooperative-gesture-screen{align-items:center;background:rgba(0,0,0,.4);color:#fff;display:flex;font:14px/1.3 system-ui,sans-serif;inset:0;justify-content:center;opacity:0;padding:1rem;pointer-events:none;position:absolute;text-align:center;transition:opacity 1s ease 1s;z-index:2}",
94
+ ".maplibregl-cooperative-gesture-screen.maplibregl-show{opacity:1;transition:opacity .05s}",
95
+ ".maplibregl-cooperative-gesture-screen .maplibregl-mobile-message{display:none}",
96
+ "@media (hover:none){.maplibregl-cooperative-gesture-screen .maplibregl-desktop-message{display:none}.maplibregl-cooperative-gesture-screen .maplibregl-mobile-message{display:block}}",
97
+ ".a2ui-std-map-places[data-collapsed]:not(:focus-within){position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0 0 0 0);white-space:nowrap;border:0}",
98
+ ].join("\n");
99
+
100
+ /** The part of a maplibre-gl `Map` that the standard Map component uses. */
101
+ export interface MapLibreMap {
102
+ setStyle(
103
+ style: string,
104
+ options: {
105
+ transformStyle: (
106
+ previous: unknown,
107
+ next: { layers?: readonly object[] },
108
+ ) => unknown;
109
+ },
110
+ ): void;
111
+ on(
112
+ event: string,
113
+ handler: (event: { originalEvent?: unknown }) => void,
114
+ ): void;
115
+ fitBounds(bounds: unknown, options: Record<string, unknown>): void;
116
+ getSource(id: string): unknown;
117
+ addSource(id: string, source: Record<string, unknown>): void;
118
+ addLayer(layer: Record<string, unknown>): void;
119
+ remove(): void;
120
+ }
121
+
122
+ /** The part of a maplibre-gl `Marker` that the standard Map component uses. */
123
+ export interface MapLibreMarker {
124
+ setLngLat(position: [number, number]): MapLibreMarker;
125
+ setPopup(popup: unknown): MapLibreMarker;
126
+ addTo(map: MapLibreMap): MapLibreMarker;
127
+ getElement(): HTMLElement;
128
+ }
129
+
130
+ /** The part of the maplibre-gl module that the standard Map component uses. */
131
+ export interface MapLibre {
132
+ Map: new (options: Record<string, unknown>) => MapLibreMap;
133
+ Marker: new () => MapLibreMarker;
134
+ Popup: new (options: Record<string, unknown>) => {
135
+ setText(text: string): unknown;
136
+ };
137
+ LngLatBounds: new () => { extend(position: [number, number]): void };
138
+ }
139
+
140
+ /**
141
+ * True when `value` looks like the maplibre-gl module: it has a `Map`
142
+ * constructor. Use it on the module that a map loader resolves.
143
+ */
144
+ export function isMapLibre(value: unknown): value is MapLibre {
145
+ return (
146
+ typeof value === "object" &&
147
+ value !== null &&
148
+ "Map" in value &&
149
+ typeof value.Map === "function"
150
+ );
151
+ }
152
+
153
+ /** True when the marker has finite coordinates, so the map can place it. */
154
+ export const isValidMarker = (marker: MapMarker) =>
155
+ Number.isFinite(marker.lat) && Number.isFinite(marker.lng);
@@ -0,0 +1,32 @@
1
+ import { z } from "zod";
2
+
3
+ // ---- Schema ----
4
+
5
+ export const mapMarker = z.object({
6
+ label: z.string(),
7
+ lat: z.number(),
8
+ lng: z.number(),
9
+ category: z.string().optional(),
10
+ icon: z.string().optional(),
11
+ });
12
+ export type MapMarker = z.output<typeof mapMarker>;
13
+
14
+ export const mapSchema = z.object({
15
+ markers: z.array(mapMarker).optional(),
16
+ route: z
17
+ .boolean()
18
+ .optional()
19
+ .describe("Draws a line through the markers in order"),
20
+ selected: z
21
+ .string()
22
+ .optional()
23
+ .describe(
24
+ 'The label of the selected marker. Bind it with { "@path": "/x" } to read the choice of the user',
25
+ ),
26
+ height: z.number().optional().describe("Pixels. Default 240"),
27
+ zoom: z
28
+ .number()
29
+ .optional()
30
+ .describe("With two or more markers, only the highest zoom of the fit"),
31
+ center: z.object({ lat: z.number(), lng: z.number() }).optional(),
32
+ });