@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,12 @@
1
+ import { GenerativeUIJSONSchema } from "../types.mjs";
2
+ import { StandardSchemaV1 } from "../../standard-schema.mjs";
3
+
4
+ //#region src/generative-ui/catalog/json-schema.d.ts
5
+ /**
6
+ * JSON Schema for a Standard Schema, without `$schema`. A prop marked by `child()` or `childList()`
7
+ * becomes an A2UI `$ref` to `ComponentId` or `ChildList`.
8
+ */
9
+ declare function toJsonSchema(schema: StandardSchemaV1): GenerativeUIJSONSchema;
10
+ //#endregion
11
+ export { toJsonSchema };
12
+ //# sourceMappingURL=json-schema.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"json-schema.d.mts","names":[],"sources":["../../../src/generative-ui/catalog/json-schema.ts"],"mappings":";;;;;;AASA;;iBAAgB,YAAA,CAAa,MAAA,EAAQ,gBAAA,GAAmB,sBAAA"}
@@ -0,0 +1,16 @@
1
+ import { schemaToJsonSchema } from "../../standard-schema.mjs";
2
+ import { applyChildRefMarks } from "../child-refs.mjs";
3
+
4
+ //#region src/generative-ui/catalog/json-schema.ts
5
+ /**
6
+ * JSON Schema for a Standard Schema, without `$schema`. A prop marked by `child()` or `childList()`
7
+ * becomes an A2UI `$ref` to `ComponentId` or `ChildList`.
8
+ */
9
+ function toJsonSchema(schema) {
10
+ const { $schema: _omit, ...rest } = schemaToJsonSchema(schema);
11
+ return applyChildRefMarks(rest);
12
+ }
13
+
14
+ //#endregion
15
+ export { toJsonSchema };
16
+ //# sourceMappingURL=json-schema.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"json-schema.mjs","names":[],"sources":["../../../src/generative-ui/catalog/json-schema.ts"],"sourcesContent":["import { schemaToJsonSchema } from \"../../standard-schema\";\nimport { applyChildRefMarks } from \"../base\";\nimport type { StandardSchemaV1 } from \"../../standard-schema\";\nimport type { GenerativeUIJSONSchema } from \"../base\";\n\n/**\n * JSON Schema for a Standard Schema, without `$schema`. A prop marked by `child()` or `childList()`\n * becomes an A2UI `$ref` to `ComponentId` or `ChildList`.\n */\nexport function toJsonSchema(schema: StandardSchemaV1): GenerativeUIJSONSchema {\n const json = schemaToJsonSchema(schema);\n const { $schema: _omit, ...rest } = json as Record<string, unknown>;\n return applyChildRefMarks(rest);\n}\n"],"mappings":";;;;;;;;AASA,SAAgB,aAAa,QAAkD;CAE7E,MAAM,EAAE,SAAS,OAAO,GAAG,SADd,mBAAmB,OAAO;AAEvC,QAAO,mBAAmB,KAAK"}
@@ -0,0 +1,21 @@
1
+ const require_runtime = require('../../_virtual/_rolldown/runtime.cjs');
2
+ const require_child_refs = require('../child-refs.cjs');
3
+ let zod = require("zod");
4
+ zod = require_runtime.__toESM(zod);
5
+
6
+ //#region src/generative-ui/catalog/refs.ts
7
+ const mark = (prefix, description) => description ? `${prefix} ${description}` : prefix;
8
+ function child(description) {
9
+ return zod.string().min(1).describe(mark(require_child_refs.A2UI_COMPONENT_ID_MARK, description)).transform((value) => value);
10
+ }
11
+ function childList(description) {
12
+ return zod.union([zod.array(zod.string().min(1)), zod.object({
13
+ componentId: zod.string().min(1),
14
+ path: zod.string().min(1)
15
+ })]).describe(mark(require_child_refs.A2UI_CHILD_LIST_MARK, description)).transform((value) => value);
16
+ }
17
+
18
+ //#endregion
19
+ exports.child = child;
20
+ exports.childList = childList;
21
+ //# sourceMappingURL=refs.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"refs.cjs","names":["z","A2UI_COMPONENT_ID_MARK","A2UI_CHILD_LIST_MARK"],"sources":["../../../src/generative-ui/catalog/refs.ts"],"sourcesContent":["import * as z from \"zod\";\nimport { A2UI_CHILD_LIST_MARK, A2UI_COMPONENT_ID_MARK } from \"../base\";\n\n/**\n * Schema helpers that mark a prop as a component reference, the way A2UI\n * 1.0 marks it with the `ComponentId` and `ChildList` common types. The\n * engine finds every marked prop in the props schema, at any depth, renders\n * the referenced components, and hands the component the rendered nodes in\n * place of the ids. The model sees the prop as `componentId` or as a list\n * of ids or a template.\n *\n * @example\n * ```ts\n * const tabsSchema = z.object({\n * tabs: z.array(z.object({ title: z.string(), child: child() })),\n * });\n * // A React component gets `tabs: { title: string; child: ReactNode }[]`.\n * ```\n *\n * `TNode` is the type of a rendered child in the framework that renders the\n * UI. Each framework package exports `child` and `childList` with it set.\n * Without it, the output is `GenerativeUIChildNode`, which\n * `GenerativeUIComponentProps` replaces with the node type of the framework.\n */\n\ndeclare const childNodeBrand: unique symbol;\n\n/**\n * A rendered child in a framework-free schema. `GenerativeUIComponentProps`\n * replaces it with the node type that the framework passes.\n */\nexport interface GenerativeUIChildNode {\n readonly [childNodeBrand]: true;\n}\n\ntype ChildListInput = z.ZodUnion<\n readonly [\n z.ZodArray<z.ZodString>,\n z.ZodObject<{ componentId: z.ZodString; path: z.ZodString }>,\n ]\n>;\ntype ChildSchema<TNode> = z.ZodPipe<z.ZodString, z.ZodTransform<TNode, string>>;\ntype ChildListSchema<TNode> = z.ZodPipe<\n ChildListInput,\n z.ZodTransform<TNode, z.output<ChildListInput>>\n>;\n\n// Without a type argument, `child()` gives `GenerativeUIChildNode`. A\n// generic default is not enough: inside `z.object({ ... })`, TypeScript\n// would infer `TNode` from the shape and give `any`.\n\nconst mark = (prefix: string, description: string | undefined) =>\n description ? `${prefix} ${description}` : prefix;\n\n/**\n * One component id. The component receives the rendered child. Pass the\n * description here, not with `.describe()`, which would replace the mark.\n */\nexport function child(description?: string): ChildSchema<GenerativeUIChildNode>;\nexport function child<TNode>(description?: string): ChildSchema<TNode>;\nexport function child(description?: string): ChildSchema<unknown> {\n return z\n .string()\n .min(1)\n .describe(mark(A2UI_COMPONENT_ID_MARK, description))\n .transform((value) => value as unknown);\n}\n\n/**\n * A list of component ids, or a template `{ componentId, path }` that\n * repeats one component for each item of the list at `path`. The\n * component receives the rendered children. Pass the description here,\n * not with `.describe()`.\n */\nexport function childList(\n description?: string,\n): ChildListSchema<GenerativeUIChildNode>;\nexport function childList<TNode>(description?: string): ChildListSchema<TNode>;\nexport function childList(description?: string): ChildListSchema<unknown> {\n return z\n .union([\n z.array(z.string().min(1)),\n z.object({ componentId: z.string().min(1), path: z.string().min(1) }),\n ])\n .describe(mark(A2UI_CHILD_LIST_MARK, description))\n .transform((value) => value as unknown);\n}\n"],"mappings":";;;;;;AAmDA,MAAM,QAAQ,QAAgB,gBAC5B,cAAc,GAAG,OAAO,GAAG,gBAAgB;AAQ7C,SAAgB,MAAM,aAA4C;AAChE,QAAOA,IACJ,QAAQ,CACR,IAAI,EAAE,CACN,SAAS,KAAKC,2CAAwB,YAAY,CAAC,CACnD,WAAW,UAAU,MAAiB;;AAa3C,SAAgB,UAAU,aAAgD;AACxE,QAAOD,IACJ,MAAM,CACLA,IAAE,MAAMA,IAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,EAC1BA,IAAE,OAAO;EAAE,aAAaA,IAAE,QAAQ,CAAC,IAAI,EAAE;EAAE,MAAMA,IAAE,QAAQ,CAAC,IAAI,EAAE;EAAE,CAAC,CACtE,CAAC,CACD,SAAS,KAAKE,yCAAsB,YAAY,CAAC,CACjD,WAAW,UAAU,MAAiB"}
@@ -0,0 +1,55 @@
1
+ import * as z$1 from "zod";
2
+
3
+ //#region src/generative-ui/catalog/refs.d.ts
4
+ /**
5
+ * Schema helpers that mark a prop as a component reference, the way A2UI
6
+ * 1.0 marks it with the `ComponentId` and `ChildList` common types. The
7
+ * engine finds every marked prop in the props schema, at any depth, renders
8
+ * the referenced components, and hands the component the rendered nodes in
9
+ * place of the ids. The model sees the prop as `componentId` or as a list
10
+ * of ids or a template.
11
+ *
12
+ * @example
13
+ * ```ts
14
+ * const tabsSchema = z.object({
15
+ * tabs: z.array(z.object({ title: z.string(), child: child() })),
16
+ * });
17
+ * // A React component gets `tabs: { title: string; child: ReactNode }[]`.
18
+ * ```
19
+ *
20
+ * `TNode` is the type of a rendered child in the framework that renders the
21
+ * UI. Each framework package exports `child` and `childList` with it set.
22
+ * Without it, the output is `GenerativeUIChildNode`, which
23
+ * `GenerativeUIComponentProps` replaces with the node type of the framework.
24
+ */
25
+ declare const childNodeBrand: unique symbol;
26
+ /**
27
+ * A rendered child in a framework-free schema. `GenerativeUIComponentProps`
28
+ * replaces it with the node type that the framework passes.
29
+ */
30
+ interface GenerativeUIChildNode {
31
+ readonly [childNodeBrand]: true;
32
+ }
33
+ type ChildListInput = z$1.ZodUnion<readonly [z$1.ZodArray<z$1.ZodString>, z$1.ZodObject<{
34
+ componentId: z$1.ZodString;
35
+ path: z$1.ZodString;
36
+ }>]>;
37
+ type ChildSchema<TNode> = z$1.ZodPipe<z$1.ZodString, z$1.ZodTransform<TNode, string>>;
38
+ type ChildListSchema<TNode> = z$1.ZodPipe<ChildListInput, z$1.ZodTransform<TNode, z$1.output<ChildListInput>>>;
39
+ /**
40
+ * One component id. The component receives the rendered child. Pass the
41
+ * description here, not with `.describe()`, which would replace the mark.
42
+ */
43
+ declare function child(description?: string): ChildSchema<GenerativeUIChildNode>;
44
+ declare function child<TNode>(description?: string): ChildSchema<TNode>;
45
+ /**
46
+ * A list of component ids, or a template `{ componentId, path }` that
47
+ * repeats one component for each item of the list at `path`. The
48
+ * component receives the rendered children. Pass the description here,
49
+ * not with `.describe()`.
50
+ */
51
+ declare function childList(description?: string): ChildListSchema<GenerativeUIChildNode>;
52
+ declare function childList<TNode>(description?: string): ChildListSchema<TNode>;
53
+ //#endregion
54
+ export { GenerativeUIChildNode, child, childList };
55
+ //# sourceMappingURL=refs.d.cts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"refs.d.cts","names":[],"sources":["../../../src/generative-ui/catalog/refs.ts"],"mappings":";;;;;AAAyB;;;;;AA+BzB;;;;;AAEC;;;;;;;;;cARa,cAAA;;;;;UAMG,qBAAA;EAAA,UACL,cAAA;AAAA;AAAA,KAGP,cAAA,GAAiB,GAAA,CAAE,QAAA,WAEpB,GAAA,CAAE,QAAA,CAAS,GAAA,CAAE,SAAA,GACb,GAAA,CAAE,SAAA;EAAY,WAAA,EAAa,GAAA,CAAE,SAAA;EAAW,IAAA,EAAM,GAAA,CAAE,SAAA;AAAA;AAAA,KAG/C,WAAA,UAAqB,GAAA,CAAE,OAAA,CAAQ,GAAA,CAAE,SAAA,EAAW,GAAA,CAAE,YAAA,CAAa,KAAA;AAAA,KAC3D,eAAA,UAAyB,GAAA,CAAE,OAAA,CAC9B,cAAA,EACA,GAAA,CAAE,YAAA,CAAa,KAAA,EAAO,GAAA,CAAE,MAAA,CAAO,cAAA;;AAN4B;;;iBAoB7C,KAAA,CAAM,WAAA,YAAuB,WAAA,CAAY,qBAAA;AAAA,iBACzC,KAAA,OAAA,CAAa,WAAA,YAAuB,WAAA,CAAY,KAAA;;;;;;;iBAehD,SAAA,CACd,WAAA,YACC,eAAA,CAAgB,qBAAA;AAAA,iBACH,SAAA,OAAA,CAAiB,WAAA,YAAuB,eAAA,CAAgB,KAAA"}
@@ -0,0 +1,55 @@
1
+ import * as z$1 from "zod";
2
+
3
+ //#region src/generative-ui/catalog/refs.d.ts
4
+ /**
5
+ * Schema helpers that mark a prop as a component reference, the way A2UI
6
+ * 1.0 marks it with the `ComponentId` and `ChildList` common types. The
7
+ * engine finds every marked prop in the props schema, at any depth, renders
8
+ * the referenced components, and hands the component the rendered nodes in
9
+ * place of the ids. The model sees the prop as `componentId` or as a list
10
+ * of ids or a template.
11
+ *
12
+ * @example
13
+ * ```ts
14
+ * const tabsSchema = z.object({
15
+ * tabs: z.array(z.object({ title: z.string(), child: child() })),
16
+ * });
17
+ * // A React component gets `tabs: { title: string; child: ReactNode }[]`.
18
+ * ```
19
+ *
20
+ * `TNode` is the type of a rendered child in the framework that renders the
21
+ * UI. Each framework package exports `child` and `childList` with it set.
22
+ * Without it, the output is `GenerativeUIChildNode`, which
23
+ * `GenerativeUIComponentProps` replaces with the node type of the framework.
24
+ */
25
+ declare const childNodeBrand: unique symbol;
26
+ /**
27
+ * A rendered child in a framework-free schema. `GenerativeUIComponentProps`
28
+ * replaces it with the node type that the framework passes.
29
+ */
30
+ interface GenerativeUIChildNode {
31
+ readonly [childNodeBrand]: true;
32
+ }
33
+ type ChildListInput = z$1.ZodUnion<readonly [z$1.ZodArray<z$1.ZodString>, z$1.ZodObject<{
34
+ componentId: z$1.ZodString;
35
+ path: z$1.ZodString;
36
+ }>]>;
37
+ type ChildSchema<TNode> = z$1.ZodPipe<z$1.ZodString, z$1.ZodTransform<TNode, string>>;
38
+ type ChildListSchema<TNode> = z$1.ZodPipe<ChildListInput, z$1.ZodTransform<TNode, z$1.output<ChildListInput>>>;
39
+ /**
40
+ * One component id. The component receives the rendered child. Pass the
41
+ * description here, not with `.describe()`, which would replace the mark.
42
+ */
43
+ declare function child(description?: string): ChildSchema<GenerativeUIChildNode>;
44
+ declare function child<TNode>(description?: string): ChildSchema<TNode>;
45
+ /**
46
+ * A list of component ids, or a template `{ componentId, path }` that
47
+ * repeats one component for each item of the list at `path`. The
48
+ * component receives the rendered children. Pass the description here,
49
+ * not with `.describe()`.
50
+ */
51
+ declare function childList(description?: string): ChildListSchema<GenerativeUIChildNode>;
52
+ declare function childList<TNode>(description?: string): ChildListSchema<TNode>;
53
+ //#endregion
54
+ export { GenerativeUIChildNode, child, childList };
55
+ //# sourceMappingURL=refs.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"refs.d.mts","names":[],"sources":["../../../src/generative-ui/catalog/refs.ts"],"mappings":";;;;;AAAyB;;;;;AA+BzB;;;;;AAEC;;;;;;;;;cARa,cAAA;;;;;UAMG,qBAAA;EAAA,UACL,cAAA;AAAA;AAAA,KAGP,cAAA,GAAiB,GAAA,CAAE,QAAA,WAEpB,GAAA,CAAE,QAAA,CAAS,GAAA,CAAE,SAAA,GACb,GAAA,CAAE,SAAA;EAAY,WAAA,EAAa,GAAA,CAAE,SAAA;EAAW,IAAA,EAAM,GAAA,CAAE,SAAA;AAAA;AAAA,KAG/C,WAAA,UAAqB,GAAA,CAAE,OAAA,CAAQ,GAAA,CAAE,SAAA,EAAW,GAAA,CAAE,YAAA,CAAa,KAAA;AAAA,KAC3D,eAAA,UAAyB,GAAA,CAAE,OAAA,CAC9B,cAAA,EACA,GAAA,CAAE,YAAA,CAAa,KAAA,EAAO,GAAA,CAAE,MAAA,CAAO,cAAA;;AAN4B;;;iBAoB7C,KAAA,CAAM,WAAA,YAAuB,WAAA,CAAY,qBAAA;AAAA,iBACzC,KAAA,OAAA,CAAa,WAAA,YAAuB,WAAA,CAAY,KAAA;;;;;;;iBAehD,SAAA,CACd,WAAA,YACC,eAAA,CAAgB,qBAAA;AAAA,iBACH,SAAA,OAAA,CAAiB,WAAA,YAAuB,eAAA,CAAgB,KAAA"}
@@ -0,0 +1,18 @@
1
+ import { A2UI_CHILD_LIST_MARK, A2UI_COMPONENT_ID_MARK } from "../child-refs.mjs";
2
+ import * as z$1 from "zod";
3
+
4
+ //#region src/generative-ui/catalog/refs.ts
5
+ const mark = (prefix, description) => description ? `${prefix} ${description}` : prefix;
6
+ function child(description) {
7
+ return z$1.string().min(1).describe(mark(A2UI_COMPONENT_ID_MARK, description)).transform((value) => value);
8
+ }
9
+ function childList(description) {
10
+ return z$1.union([z$1.array(z$1.string().min(1)), z$1.object({
11
+ componentId: z$1.string().min(1),
12
+ path: z$1.string().min(1)
13
+ })]).describe(mark(A2UI_CHILD_LIST_MARK, description)).transform((value) => value);
14
+ }
15
+
16
+ //#endregion
17
+ export { child, childList };
18
+ //# sourceMappingURL=refs.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"refs.mjs","names":["z"],"sources":["../../../src/generative-ui/catalog/refs.ts"],"sourcesContent":["import * as z from \"zod\";\nimport { A2UI_CHILD_LIST_MARK, A2UI_COMPONENT_ID_MARK } from \"../base\";\n\n/**\n * Schema helpers that mark a prop as a component reference, the way A2UI\n * 1.0 marks it with the `ComponentId` and `ChildList` common types. The\n * engine finds every marked prop in the props schema, at any depth, renders\n * the referenced components, and hands the component the rendered nodes in\n * place of the ids. The model sees the prop as `componentId` or as a list\n * of ids or a template.\n *\n * @example\n * ```ts\n * const tabsSchema = z.object({\n * tabs: z.array(z.object({ title: z.string(), child: child() })),\n * });\n * // A React component gets `tabs: { title: string; child: ReactNode }[]`.\n * ```\n *\n * `TNode` is the type of a rendered child in the framework that renders the\n * UI. Each framework package exports `child` and `childList` with it set.\n * Without it, the output is `GenerativeUIChildNode`, which\n * `GenerativeUIComponentProps` replaces with the node type of the framework.\n */\n\ndeclare const childNodeBrand: unique symbol;\n\n/**\n * A rendered child in a framework-free schema. `GenerativeUIComponentProps`\n * replaces it with the node type that the framework passes.\n */\nexport interface GenerativeUIChildNode {\n readonly [childNodeBrand]: true;\n}\n\ntype ChildListInput = z.ZodUnion<\n readonly [\n z.ZodArray<z.ZodString>,\n z.ZodObject<{ componentId: z.ZodString; path: z.ZodString }>,\n ]\n>;\ntype ChildSchema<TNode> = z.ZodPipe<z.ZodString, z.ZodTransform<TNode, string>>;\ntype ChildListSchema<TNode> = z.ZodPipe<\n ChildListInput,\n z.ZodTransform<TNode, z.output<ChildListInput>>\n>;\n\n// Without a type argument, `child()` gives `GenerativeUIChildNode`. A\n// generic default is not enough: inside `z.object({ ... })`, TypeScript\n// would infer `TNode` from the shape and give `any`.\n\nconst mark = (prefix: string, description: string | undefined) =>\n description ? `${prefix} ${description}` : prefix;\n\n/**\n * One component id. The component receives the rendered child. Pass the\n * description here, not with `.describe()`, which would replace the mark.\n */\nexport function child(description?: string): ChildSchema<GenerativeUIChildNode>;\nexport function child<TNode>(description?: string): ChildSchema<TNode>;\nexport function child(description?: string): ChildSchema<unknown> {\n return z\n .string()\n .min(1)\n .describe(mark(A2UI_COMPONENT_ID_MARK, description))\n .transform((value) => value as unknown);\n}\n\n/**\n * A list of component ids, or a template `{ componentId, path }` that\n * repeats one component for each item of the list at `path`. The\n * component receives the rendered children. Pass the description here,\n * not with `.describe()`.\n */\nexport function childList(\n description?: string,\n): ChildListSchema<GenerativeUIChildNode>;\nexport function childList<TNode>(description?: string): ChildListSchema<TNode>;\nexport function childList(description?: string): ChildListSchema<unknown> {\n return z\n .union([\n z.array(z.string().min(1)),\n z.object({ componentId: z.string().min(1), path: z.string().min(1) }),\n ])\n .describe(mark(A2UI_CHILD_LIST_MARK, description))\n .transform((value) => value as unknown);\n}\n"],"mappings":";;;;AAmDA,MAAM,QAAQ,QAAgB,gBAC5B,cAAc,GAAG,OAAO,GAAG,gBAAgB;AAQ7C,SAAgB,MAAM,aAA4C;AAChE,QAAOA,IACJ,QAAQ,CACR,IAAI,EAAE,CACN,SAAS,KAAK,wBAAwB,YAAY,CAAC,CACnD,WAAW,UAAU,MAAiB;;AAa3C,SAAgB,UAAU,aAAgD;AACxE,QAAOA,IACJ,MAAM,CACLA,IAAE,MAAMA,IAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,EAC1BA,IAAE,OAAO;EAAE,aAAaA,IAAE,QAAQ,CAAC,IAAI,EAAE;EAAE,MAAMA,IAAE,QAAQ,CAAC,IAAI,EAAE;EAAE,CAAC,CACtE,CAAC,CACD,SAAS,KAAK,sBAAsB,YAAY,CAAC,CACjD,WAAW,UAAU,MAAiB"}
@@ -0,0 +1,74 @@
1
+
2
+ //#region src/generative-ui/catalog/schema.ts
3
+ const ASYNC_ISSUE = { message: "the schema validates asynchronously; component props and state need a schema that validates synchronously" };
4
+ function toResult(result) {
5
+ return result.issues ? {
6
+ success: false,
7
+ issues: result.issues
8
+ } : {
9
+ success: true,
10
+ data: result.value
11
+ };
12
+ }
13
+ /**
14
+ * Validates `value` with `schema`. The result comes back at once when the
15
+ * schema validates synchronously, else as a promise.
16
+ */
17
+ function validateSchema(schema, value) {
18
+ const result = schema["~standard"].validate(value);
19
+ return result instanceof Promise ? result.then(toResult) : toResult(result);
20
+ }
21
+ /**
22
+ * Validates `value` synchronously, for code that runs during render. A
23
+ * schema that validates asynchronously fails with an issue that says so.
24
+ */
25
+ function validateSchemaSync(schema, value) {
26
+ const result = validateSchema(schema, value);
27
+ if (!(result instanceof Promise)) return result;
28
+ result.catch(() => {});
29
+ return {
30
+ success: false,
31
+ issues: [ASYNC_ISSUE]
32
+ };
33
+ }
34
+ /** True for the issue that `validateSchemaSync` gives for an async schema. */
35
+ function isAsyncIssue(issue) {
36
+ return issue === ASYNC_ISSUE;
37
+ }
38
+ /** The first key of an issue path: the prop the issue is about. */
39
+ function issueKey(issue) {
40
+ const first = issue.path?.[0];
41
+ const key = typeof first === "object" ? first.key : first;
42
+ return key === void 0 ? void 0 : String(key);
43
+ }
44
+ /**
45
+ * `props` without the top-level props whose `null` the schema rejected, or
46
+ * `undefined` when there are none. A model writes `null` for "not set" (an
47
+ * empty selection, a value it has not filled yet), and A2UI deletes a data
48
+ * model key that is set to `null`, so a rejected `null` is read as an unset
49
+ * prop. A prop whose schema accepts `null` keeps it.
50
+ */
51
+ function withoutRejectedNulls(props, issues) {
52
+ const rejected = /* @__PURE__ */ new Set();
53
+ for (const issue of issues) {
54
+ const key = issueKey(issue);
55
+ if (key !== void 0 && issue.path?.length === 1 && props[key] === null) rejected.add(key);
56
+ }
57
+ if (rejected.size === 0) return void 0;
58
+ return Object.fromEntries(Object.entries(props).filter(([key]) => !rejected.has(key)));
59
+ }
60
+ /** `"a.b: message; c: message"`. A path-less issue gets `fallback`. */
61
+ function formatIssues(issues, fallback = "props") {
62
+ return issues.map((issue) => {
63
+ return `${(issue.path ?? []).map((segment) => String(typeof segment === "object" ? segment.key : segment)).join(".") || fallback}: ${issue.message}`;
64
+ }).join("; ");
65
+ }
66
+
67
+ //#endregion
68
+ exports.formatIssues = formatIssues;
69
+ exports.isAsyncIssue = isAsyncIssue;
70
+ exports.issueKey = issueKey;
71
+ exports.validateSchema = validateSchema;
72
+ exports.validateSchemaSync = validateSchemaSync;
73
+ exports.withoutRejectedNulls = withoutRejectedNulls;
74
+ //# sourceMappingURL=schema.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema.cjs","names":[],"sources":["../../../src/generative-ui/catalog/schema.ts"],"sourcesContent":["import type { StandardSchemaV1 } from \"../../standard-schema\";\n\n/** Any Standard Schema: zod, Valibot, ArkType, and more. */\nexport type GenerativeUISchema = StandardSchemaV1;\n\n/** The output type of a schema: what validation gives back. */\nexport type SchemaOutput<Schema> =\n Schema extends StandardSchemaV1<any, infer Output> ? Output : never;\n\n/** The input type of a schema: what validation takes. */\nexport type SchemaInput<Schema> =\n Schema extends StandardSchemaV1<infer Input, any> ? Input : never;\n\nexport type ValidationResult =\n | { success: true; data: unknown }\n | { success: false; issues: readonly StandardSchemaV1.Issue[] };\n\nconst ASYNC_ISSUE: StandardSchemaV1.Issue = {\n message:\n \"the schema validates asynchronously; component props and state need a schema that validates synchronously\",\n};\n\nfunction toResult(result: StandardSchemaV1.Result<unknown>): ValidationResult {\n return result.issues\n ? { success: false, issues: result.issues }\n : { success: true, data: result.value };\n}\n\n/**\n * Validates `value` with `schema`. The result comes back at once when the\n * schema validates synchronously, else as a promise.\n */\nexport function validateSchema(\n schema: StandardSchemaV1,\n value: unknown,\n): ValidationResult | Promise<ValidationResult> {\n const result = schema[\"~standard\"].validate(value);\n return result instanceof Promise ? result.then(toResult) : toResult(result);\n}\n\n/**\n * Validates `value` synchronously, for code that runs during render. A\n * schema that validates asynchronously fails with an issue that says so.\n */\nexport function validateSchemaSync(\n schema: StandardSchemaV1,\n value: unknown,\n): ValidationResult {\n const result = validateSchema(schema, value);\n if (!(result instanceof Promise)) return result;\n // ponytail: the async result is dropped, because render cannot wait for it.\n result.catch(() => {});\n return { success: false, issues: [ASYNC_ISSUE] };\n}\n\n/** True for the issue that `validateSchemaSync` gives for an async schema. */\nexport function isAsyncIssue(issue: StandardSchemaV1.Issue) {\n return issue === ASYNC_ISSUE;\n}\n\n/** The first key of an issue path: the prop the issue is about. */\nexport function issueKey(issue: StandardSchemaV1.Issue) {\n const first = issue.path?.[0];\n const key = typeof first === \"object\" ? first.key : first;\n return key === undefined ? undefined : String(key);\n}\n\n/**\n * `props` without the top-level props whose `null` the schema rejected, or\n * `undefined` when there are none. A model writes `null` for \"not set\" (an\n * empty selection, a value it has not filled yet), and A2UI deletes a data\n * model key that is set to `null`, so a rejected `null` is read as an unset\n * prop. A prop whose schema accepts `null` keeps it.\n */\nexport function withoutRejectedNulls(\n props: Record<string, unknown>,\n issues: readonly StandardSchemaV1.Issue[],\n): Record<string, unknown> | undefined {\n const rejected = new Set<string>();\n for (const issue of issues) {\n const key = issueKey(issue);\n if (key !== undefined && issue.path?.length === 1 && props[key] === null) {\n rejected.add(key);\n }\n }\n if (rejected.size === 0) return undefined;\n return Object.fromEntries(\n Object.entries(props).filter(([key]) => !rejected.has(key)),\n );\n}\n\n/** `\"a.b: message; c: message\"`. A path-less issue gets `fallback`. */\nexport function formatIssues(\n issues: readonly StandardSchemaV1.Issue[],\n fallback = \"props\",\n) {\n return issues\n .map((issue) => {\n const path = (issue.path ?? [])\n .map((segment) =>\n String(typeof segment === \"object\" ? segment.key : segment),\n )\n .join(\".\");\n return `${path || fallback}: ${issue.message}`;\n })\n .join(\"; \");\n}\n"],"mappings":";;AAiBA,MAAM,cAAsC,EAC1C,SACE,6GACH;AAED,SAAS,SAAS,QAA4D;AAC5E,QAAO,OAAO,SACV;EAAE,SAAS;EAAO,QAAQ,OAAO;EAAQ,GACzC;EAAE,SAAS;EAAM,MAAM,OAAO;EAAO;;;;;;AAO3C,SAAgB,eACd,QACA,OAC8C;CAC9C,MAAM,SAAS,OAAO,aAAa,SAAS,MAAM;AAClD,QAAO,kBAAkB,UAAU,OAAO,KAAK,SAAS,GAAG,SAAS,OAAO;;;;;;AAO7E,SAAgB,mBACd,QACA,OACkB;CAClB,MAAM,SAAS,eAAe,QAAQ,MAAM;AAC5C,KAAI,EAAE,kBAAkB,SAAU,QAAO;AAEzC,QAAO,YAAY,GAAG;AACtB,QAAO;EAAE,SAAS;EAAO,QAAQ,CAAC,YAAY;EAAE;;;AAIlD,SAAgB,aAAa,OAA+B;AAC1D,QAAO,UAAU;;;AAInB,SAAgB,SAAS,OAA+B;CACtD,MAAM,QAAQ,MAAM,OAAO;CAC3B,MAAM,MAAM,OAAO,UAAU,WAAW,MAAM,MAAM;AACpD,QAAO,QAAQ,SAAY,SAAY,OAAO,IAAI;;;;;;;;;AAUpD,SAAgB,qBACd,OACA,QACqC;CACrC,MAAM,2BAAW,IAAI,KAAa;AAClC,MAAK,MAAM,SAAS,QAAQ;EAC1B,MAAM,MAAM,SAAS,MAAM;AAC3B,MAAI,QAAQ,UAAa,MAAM,MAAM,WAAW,KAAK,MAAM,SAAS,KAClE,UAAS,IAAI,IAAI;;AAGrB,KAAI,SAAS,SAAS,EAAG,QAAO;AAChC,QAAO,OAAO,YACZ,OAAO,QAAQ,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,SAAS,IAAI,IAAI,CAAC,CAC5D;;;AAIH,SAAgB,aACd,QACA,WAAW,SACX;AACA,QAAO,OACJ,KAAK,UAAU;AAMd,SAAO,IALO,MAAM,QAAQ,EAAE,EAC3B,KAAK,YACJ,OAAO,OAAO,YAAY,WAAW,QAAQ,MAAM,QAAQ,CAC5D,CACA,KAAK,IAAI,IACM,SAAS,IAAI,MAAM;GACrC,CACD,KAAK,KAAK"}
@@ -0,0 +1,43 @@
1
+ import { StandardSchemaV1 } from "../../standard-schema.cjs";
2
+
3
+ //#region src/generative-ui/catalog/schema.d.ts
4
+ /** Any Standard Schema: zod, Valibot, ArkType, and more. */
5
+ type GenerativeUISchema = StandardSchemaV1;
6
+ /** The output type of a schema: what validation gives back. */
7
+ type SchemaOutput<Schema> = Schema extends StandardSchemaV1<any, infer Output> ? Output : never;
8
+ /** The input type of a schema: what validation takes. */
9
+ type SchemaInput<Schema> = Schema extends StandardSchemaV1<infer Input, any> ? Input : never;
10
+ type ValidationResult = {
11
+ success: true;
12
+ data: unknown;
13
+ } | {
14
+ success: false;
15
+ issues: readonly StandardSchemaV1.Issue[];
16
+ };
17
+ /**
18
+ * Validates `value` with `schema`. The result comes back at once when the
19
+ * schema validates synchronously, else as a promise.
20
+ */
21
+ declare function validateSchema(schema: StandardSchemaV1, value: unknown): ValidationResult | Promise<ValidationResult>;
22
+ /**
23
+ * Validates `value` synchronously, for code that runs during render. A
24
+ * schema that validates asynchronously fails with an issue that says so.
25
+ */
26
+ declare function validateSchemaSync(schema: StandardSchemaV1, value: unknown): ValidationResult;
27
+ /** True for the issue that `validateSchemaSync` gives for an async schema. */
28
+ declare function isAsyncIssue(issue: StandardSchemaV1.Issue): boolean;
29
+ /** The first key of an issue path: the prop the issue is about. */
30
+ declare function issueKey(issue: StandardSchemaV1.Issue): string | undefined;
31
+ /**
32
+ * `props` without the top-level props whose `null` the schema rejected, or
33
+ * `undefined` when there are none. A model writes `null` for "not set" (an
34
+ * empty selection, a value it has not filled yet), and A2UI deletes a data
35
+ * model key that is set to `null`, so a rejected `null` is read as an unset
36
+ * prop. A prop whose schema accepts `null` keeps it.
37
+ */
38
+ declare function withoutRejectedNulls(props: Record<string, unknown>, issues: readonly StandardSchemaV1.Issue[]): Record<string, unknown> | undefined;
39
+ /** `"a.b: message; c: message"`. A path-less issue gets `fallback`. */
40
+ declare function formatIssues(issues: readonly StandardSchemaV1.Issue[], fallback?: string): string;
41
+ //#endregion
42
+ export { GenerativeUISchema, SchemaInput, SchemaOutput, ValidationResult, formatIssues, isAsyncIssue, issueKey, validateSchema, validateSchemaSync, withoutRejectedNulls };
43
+ //# sourceMappingURL=schema.d.cts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema.d.cts","names":[],"sources":["../../../src/generative-ui/catalog/schema.ts"],"mappings":";;;;KAGY,kBAAA,GAAqB,gBAAA;AAAjC;AAAA,KAGY,YAAA,WACV,MAAA,SAAe,gBAAA,sBAAsC,MAAA;;KAG3C,WAAA,WACV,MAAA,SAAe,gBAAA,qBAAqC,KAAA;AAAA,KAE1C,gBAAA;EACN,OAAA;EAAe,IAAA;AAAA;EACf,OAAA;EAAgB,MAAA,WAAiB,gBAAA,CAAiB,KAAA;AAAA;;;;;iBAiBxC,cAAA,CACd,MAAA,EAAQ,gBAAA,EACR,KAAA,YACC,gBAAA,GAAmB,OAAA,CAAQ,gBAAA;AAzB9B;;;;AAAA,iBAkCgB,kBAAA,CACd,MAAA,EAAQ,gBAAA,EACR,KAAA,YACC,gBAAA;;iBASa,YAAA,CAAa,KAAA,EAAO,gBAAA,CAAiB,KAAA;;iBAKrC,QAAA,CAAS,KAAA,EAAO,gBAAA,CAAiB,KAAA;;;AAhDjD;;;;;iBA6DgB,oBAAA,CACd,KAAA,EAAO,MAAA,mBACP,MAAA,WAAiB,gBAAA,CAAiB,KAAA,KACjC,MAAA;;iBAea,YAAA,CACd,MAAA,WAAiB,gBAAA,CAAiB,KAAA,IAClC,QAAA"}
@@ -0,0 +1,43 @@
1
+ import { StandardSchemaV1 } from "../../standard-schema.mjs";
2
+
3
+ //#region src/generative-ui/catalog/schema.d.ts
4
+ /** Any Standard Schema: zod, Valibot, ArkType, and more. */
5
+ type GenerativeUISchema = StandardSchemaV1;
6
+ /** The output type of a schema: what validation gives back. */
7
+ type SchemaOutput<Schema> = Schema extends StandardSchemaV1<any, infer Output> ? Output : never;
8
+ /** The input type of a schema: what validation takes. */
9
+ type SchemaInput<Schema> = Schema extends StandardSchemaV1<infer Input, any> ? Input : never;
10
+ type ValidationResult = {
11
+ success: true;
12
+ data: unknown;
13
+ } | {
14
+ success: false;
15
+ issues: readonly StandardSchemaV1.Issue[];
16
+ };
17
+ /**
18
+ * Validates `value` with `schema`. The result comes back at once when the
19
+ * schema validates synchronously, else as a promise.
20
+ */
21
+ declare function validateSchema(schema: StandardSchemaV1, value: unknown): ValidationResult | Promise<ValidationResult>;
22
+ /**
23
+ * Validates `value` synchronously, for code that runs during render. A
24
+ * schema that validates asynchronously fails with an issue that says so.
25
+ */
26
+ declare function validateSchemaSync(schema: StandardSchemaV1, value: unknown): ValidationResult;
27
+ /** True for the issue that `validateSchemaSync` gives for an async schema. */
28
+ declare function isAsyncIssue(issue: StandardSchemaV1.Issue): boolean;
29
+ /** The first key of an issue path: the prop the issue is about. */
30
+ declare function issueKey(issue: StandardSchemaV1.Issue): string | undefined;
31
+ /**
32
+ * `props` without the top-level props whose `null` the schema rejected, or
33
+ * `undefined` when there are none. A model writes `null` for "not set" (an
34
+ * empty selection, a value it has not filled yet), and A2UI deletes a data
35
+ * model key that is set to `null`, so a rejected `null` is read as an unset
36
+ * prop. A prop whose schema accepts `null` keeps it.
37
+ */
38
+ declare function withoutRejectedNulls(props: Record<string, unknown>, issues: readonly StandardSchemaV1.Issue[]): Record<string, unknown> | undefined;
39
+ /** `"a.b: message; c: message"`. A path-less issue gets `fallback`. */
40
+ declare function formatIssues(issues: readonly StandardSchemaV1.Issue[], fallback?: string): string;
41
+ //#endregion
42
+ export { GenerativeUISchema, SchemaInput, SchemaOutput, ValidationResult, formatIssues, isAsyncIssue, issueKey, validateSchema, validateSchemaSync, withoutRejectedNulls };
43
+ //# sourceMappingURL=schema.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema.d.mts","names":[],"sources":["../../../src/generative-ui/catalog/schema.ts"],"mappings":";;;;KAGY,kBAAA,GAAqB,gBAAA;AAAjC;AAAA,KAGY,YAAA,WACV,MAAA,SAAe,gBAAA,sBAAsC,MAAA;;KAG3C,WAAA,WACV,MAAA,SAAe,gBAAA,qBAAqC,KAAA;AAAA,KAE1C,gBAAA;EACN,OAAA;EAAe,IAAA;AAAA;EACf,OAAA;EAAgB,MAAA,WAAiB,gBAAA,CAAiB,KAAA;AAAA;;;;;iBAiBxC,cAAA,CACd,MAAA,EAAQ,gBAAA,EACR,KAAA,YACC,gBAAA,GAAmB,OAAA,CAAQ,gBAAA;AAzB9B;;;;AAAA,iBAkCgB,kBAAA,CACd,MAAA,EAAQ,gBAAA,EACR,KAAA,YACC,gBAAA;;iBASa,YAAA,CAAa,KAAA,EAAO,gBAAA,CAAiB,KAAA;;iBAKrC,QAAA,CAAS,KAAA,EAAO,gBAAA,CAAiB,KAAA;;;AAhDjD;;;;;iBA6DgB,oBAAA,CACd,KAAA,EAAO,MAAA,mBACP,MAAA,WAAiB,gBAAA,CAAiB,KAAA,KACjC,MAAA;;iBAea,YAAA,CACd,MAAA,WAAiB,gBAAA,CAAiB,KAAA,IAClC,QAAA"}
@@ -0,0 +1,68 @@
1
+ //#region src/generative-ui/catalog/schema.ts
2
+ const ASYNC_ISSUE = { message: "the schema validates asynchronously; component props and state need a schema that validates synchronously" };
3
+ function toResult(result) {
4
+ return result.issues ? {
5
+ success: false,
6
+ issues: result.issues
7
+ } : {
8
+ success: true,
9
+ data: result.value
10
+ };
11
+ }
12
+ /**
13
+ * Validates `value` with `schema`. The result comes back at once when the
14
+ * schema validates synchronously, else as a promise.
15
+ */
16
+ function validateSchema(schema, value) {
17
+ const result = schema["~standard"].validate(value);
18
+ return result instanceof Promise ? result.then(toResult) : toResult(result);
19
+ }
20
+ /**
21
+ * Validates `value` synchronously, for code that runs during render. A
22
+ * schema that validates asynchronously fails with an issue that says so.
23
+ */
24
+ function validateSchemaSync(schema, value) {
25
+ const result = validateSchema(schema, value);
26
+ if (!(result instanceof Promise)) return result;
27
+ result.catch(() => {});
28
+ return {
29
+ success: false,
30
+ issues: [ASYNC_ISSUE]
31
+ };
32
+ }
33
+ /** True for the issue that `validateSchemaSync` gives for an async schema. */
34
+ function isAsyncIssue(issue) {
35
+ return issue === ASYNC_ISSUE;
36
+ }
37
+ /** The first key of an issue path: the prop the issue is about. */
38
+ function issueKey(issue) {
39
+ const first = issue.path?.[0];
40
+ const key = typeof first === "object" ? first.key : first;
41
+ return key === void 0 ? void 0 : String(key);
42
+ }
43
+ /**
44
+ * `props` without the top-level props whose `null` the schema rejected, or
45
+ * `undefined` when there are none. A model writes `null` for "not set" (an
46
+ * empty selection, a value it has not filled yet), and A2UI deletes a data
47
+ * model key that is set to `null`, so a rejected `null` is read as an unset
48
+ * prop. A prop whose schema accepts `null` keeps it.
49
+ */
50
+ function withoutRejectedNulls(props, issues) {
51
+ const rejected = /* @__PURE__ */ new Set();
52
+ for (const issue of issues) {
53
+ const key = issueKey(issue);
54
+ if (key !== void 0 && issue.path?.length === 1 && props[key] === null) rejected.add(key);
55
+ }
56
+ if (rejected.size === 0) return void 0;
57
+ return Object.fromEntries(Object.entries(props).filter(([key]) => !rejected.has(key)));
58
+ }
59
+ /** `"a.b: message; c: message"`. A path-less issue gets `fallback`. */
60
+ function formatIssues(issues, fallback = "props") {
61
+ return issues.map((issue) => {
62
+ return `${(issue.path ?? []).map((segment) => String(typeof segment === "object" ? segment.key : segment)).join(".") || fallback}: ${issue.message}`;
63
+ }).join("; ");
64
+ }
65
+
66
+ //#endregion
67
+ export { formatIssues, isAsyncIssue, issueKey, validateSchema, validateSchemaSync, withoutRejectedNulls };
68
+ //# sourceMappingURL=schema.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema.mjs","names":[],"sources":["../../../src/generative-ui/catalog/schema.ts"],"sourcesContent":["import type { StandardSchemaV1 } from \"../../standard-schema\";\n\n/** Any Standard Schema: zod, Valibot, ArkType, and more. */\nexport type GenerativeUISchema = StandardSchemaV1;\n\n/** The output type of a schema: what validation gives back. */\nexport type SchemaOutput<Schema> =\n Schema extends StandardSchemaV1<any, infer Output> ? Output : never;\n\n/** The input type of a schema: what validation takes. */\nexport type SchemaInput<Schema> =\n Schema extends StandardSchemaV1<infer Input, any> ? Input : never;\n\nexport type ValidationResult =\n | { success: true; data: unknown }\n | { success: false; issues: readonly StandardSchemaV1.Issue[] };\n\nconst ASYNC_ISSUE: StandardSchemaV1.Issue = {\n message:\n \"the schema validates asynchronously; component props and state need a schema that validates synchronously\",\n};\n\nfunction toResult(result: StandardSchemaV1.Result<unknown>): ValidationResult {\n return result.issues\n ? { success: false, issues: result.issues }\n : { success: true, data: result.value };\n}\n\n/**\n * Validates `value` with `schema`. The result comes back at once when the\n * schema validates synchronously, else as a promise.\n */\nexport function validateSchema(\n schema: StandardSchemaV1,\n value: unknown,\n): ValidationResult | Promise<ValidationResult> {\n const result = schema[\"~standard\"].validate(value);\n return result instanceof Promise ? result.then(toResult) : toResult(result);\n}\n\n/**\n * Validates `value` synchronously, for code that runs during render. A\n * schema that validates asynchronously fails with an issue that says so.\n */\nexport function validateSchemaSync(\n schema: StandardSchemaV1,\n value: unknown,\n): ValidationResult {\n const result = validateSchema(schema, value);\n if (!(result instanceof Promise)) return result;\n // ponytail: the async result is dropped, because render cannot wait for it.\n result.catch(() => {});\n return { success: false, issues: [ASYNC_ISSUE] };\n}\n\n/** True for the issue that `validateSchemaSync` gives for an async schema. */\nexport function isAsyncIssue(issue: StandardSchemaV1.Issue) {\n return issue === ASYNC_ISSUE;\n}\n\n/** The first key of an issue path: the prop the issue is about. */\nexport function issueKey(issue: StandardSchemaV1.Issue) {\n const first = issue.path?.[0];\n const key = typeof first === \"object\" ? first.key : first;\n return key === undefined ? undefined : String(key);\n}\n\n/**\n * `props` without the top-level props whose `null` the schema rejected, or\n * `undefined` when there are none. A model writes `null` for \"not set\" (an\n * empty selection, a value it has not filled yet), and A2UI deletes a data\n * model key that is set to `null`, so a rejected `null` is read as an unset\n * prop. A prop whose schema accepts `null` keeps it.\n */\nexport function withoutRejectedNulls(\n props: Record<string, unknown>,\n issues: readonly StandardSchemaV1.Issue[],\n): Record<string, unknown> | undefined {\n const rejected = new Set<string>();\n for (const issue of issues) {\n const key = issueKey(issue);\n if (key !== undefined && issue.path?.length === 1 && props[key] === null) {\n rejected.add(key);\n }\n }\n if (rejected.size === 0) return undefined;\n return Object.fromEntries(\n Object.entries(props).filter(([key]) => !rejected.has(key)),\n );\n}\n\n/** `\"a.b: message; c: message\"`. A path-less issue gets `fallback`. */\nexport function formatIssues(\n issues: readonly StandardSchemaV1.Issue[],\n fallback = \"props\",\n) {\n return issues\n .map((issue) => {\n const path = (issue.path ?? [])\n .map((segment) =>\n String(typeof segment === \"object\" ? segment.key : segment),\n )\n .join(\".\");\n return `${path || fallback}: ${issue.message}`;\n })\n .join(\"; \");\n}\n"],"mappings":";AAiBA,MAAM,cAAsC,EAC1C,SACE,6GACH;AAED,SAAS,SAAS,QAA4D;AAC5E,QAAO,OAAO,SACV;EAAE,SAAS;EAAO,QAAQ,OAAO;EAAQ,GACzC;EAAE,SAAS;EAAM,MAAM,OAAO;EAAO;;;;;;AAO3C,SAAgB,eACd,QACA,OAC8C;CAC9C,MAAM,SAAS,OAAO,aAAa,SAAS,MAAM;AAClD,QAAO,kBAAkB,UAAU,OAAO,KAAK,SAAS,GAAG,SAAS,OAAO;;;;;;AAO7E,SAAgB,mBACd,QACA,OACkB;CAClB,MAAM,SAAS,eAAe,QAAQ,MAAM;AAC5C,KAAI,EAAE,kBAAkB,SAAU,QAAO;AAEzC,QAAO,YAAY,GAAG;AACtB,QAAO;EAAE,SAAS;EAAO,QAAQ,CAAC,YAAY;EAAE;;;AAIlD,SAAgB,aAAa,OAA+B;AAC1D,QAAO,UAAU;;;AAInB,SAAgB,SAAS,OAA+B;CACtD,MAAM,QAAQ,MAAM,OAAO;CAC3B,MAAM,MAAM,OAAO,UAAU,WAAW,MAAM,MAAM;AACpD,QAAO,QAAQ,SAAY,SAAY,OAAO,IAAI;;;;;;;;;AAUpD,SAAgB,qBACd,OACA,QACqC;CACrC,MAAM,2BAAW,IAAI,KAAa;AAClC,MAAK,MAAM,SAAS,QAAQ;EAC1B,MAAM,MAAM,SAAS,MAAM;AAC3B,MAAI,QAAQ,UAAa,MAAM,MAAM,WAAW,KAAK,MAAM,SAAS,KAClE,UAAS,IAAI,IAAI;;AAGrB,KAAI,SAAS,SAAS,EAAG,QAAO;AAChC,QAAO,OAAO,YACZ,OAAO,QAAQ,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,SAAS,IAAI,IAAI,CAAC,CAC5D;;;AAIH,SAAgB,aACd,QACA,WAAW,SACX;AACA,QAAO,OACJ,KAAK,UAAU;AAMd,SAAO,IALO,MAAM,QAAQ,EAAE,EAC3B,KAAK,YACJ,OAAO,OAAO,YAAY,WAAW,QAAQ,MAAM,QAAQ,CAC5D,CACA,KAAK,IAAI,IACM,SAAS,IAAI,MAAM;GACrC,CACD,KAAK,KAAK"}
@@ -101,8 +101,8 @@ function childIdsAtRefs(component, refs) {
101
101
  else if (require_is_record.isRecord(value) && typeof value.componentId === "string") ids.push(value.componentId);
102
102
  };
103
103
  const visit = (value, path) => {
104
- if (path.length === 0) return collect(value);
105
104
  const [head, ...rest] = path;
105
+ if (head === void 0) return collect(value);
106
106
  if (head === "*") {
107
107
  if (Array.isArray(value)) value.forEach((item) => visit(item, rest));
108
108
  return;
@@ -121,8 +121,8 @@ function hasBoundChildRef(component, refs) {
121
121
  const isDynamic = (value) => require_is_record.isRecord(value) && ("@path" in value || "@call" in value);
122
122
  const visit = (value, path) => {
123
123
  if (isDynamic(value)) return true;
124
- if (path.length === 0) return false;
125
124
  const [head, ...rest] = path;
125
+ if (head === void 0) return false;
126
126
  if (head === "*") return Array.isArray(value) && value.some((item) => visit(item, rest));
127
127
  return require_is_record.isRecord(value) && Object.prototype.hasOwnProperty.call(value, head) && visit(value[head], rest);
128
128
  };
@@ -134,8 +134,8 @@ function hasBoundChildRef(component, refs) {
134
134
  * else keeps its identity. Missing keys are left alone.
135
135
  */
136
136
  function mapAtChildRef(value, path, replace) {
137
- if (path.length === 0) return replace(value);
138
137
  const [head, ...rest] = path;
138
+ if (head === void 0) return replace(value);
139
139
  if (head === "*") {
140
140
  if (!Array.isArray(value)) return value;
141
141
  return value.map((item) => mapAtChildRef(item, rest, replace));
@@ -1 +1 @@
1
- {"version":3,"file":"child-refs.cjs","names":["isRecord"],"sources":["../../src/generative-ui/child-refs.ts"],"sourcesContent":["import type { GenerativeUIJSONSchema } from \"./types\";\nimport { isRecord } from \"./is-record\";\n\n/**\n * How A2UI 1.0 marks a prop that holds a component reference: the JSON\n * Schema of the prop is a `$ref` to one of these two common types.\n * Validators and renderers find the children of a component by these refs,\n * at any depth of the props schema.\n */\nexport const A2UI_COMPONENT_ID_REF = \"common_types.json#/$defs/ComponentId\";\nexport const A2UI_CHILD_LIST_REF = \"common_types.json#/$defs/ChildList\";\n\n/**\n * The start of the `description` that marks a schema as a component\n * reference before it is turned into JSON Schema. `child()` and\n * `childList()` set it; a schema from another library can set a description\n * that starts with the same mark to get the same effect. What follows the\n * mark (after a space) stays as the description of the reference.\n */\nexport const A2UI_COMPONENT_ID_MARK = \"@a2ui/ComponentId\";\nexport const A2UI_CHILD_LIST_MARK = \"@a2ui/ChildList\";\n\nexport type ChildRefKind = \"single\" | \"multiple\";\n\n/** One component reference in a props schema. */\nexport interface ChildRef {\n /**\n * The keys from the props root to the reference. `\"*\"` stands for the\n * items of an array. `[\"tabs\", \"*\", \"child\"]` is the `child` of each\n * entry of `tabs`.\n */\n path: readonly string[];\n kind: ChildRefKind;\n}\n\n/** The ref kind of a JSON Schema node, or `undefined` for a plain value. */\nexport function childRefKind(\n schema: GenerativeUIJSONSchema,\n): ChildRefKind | undefined {\n const ref = schema.$ref;\n if (ref === A2UI_COMPONENT_ID_REF) return \"single\";\n if (ref === A2UI_CHILD_LIST_REF) return \"multiple\";\n return undefined;\n}\n\n/**\n * Turns the reference marks of a JSON Schema into A2UI `$ref`s, in place of\n * the marked node. The mark is the `description` set by `child()` and\n * `childList()`; after this, the node is `{ \"$ref\": \"common_types.json#/...\" }`.\n */\nexport function applyChildRefMarks(\n schema: GenerativeUIJSONSchema,\n): GenerativeUIJSONSchema {\n const marked = (description: unknown, mark: string, ref: string) => {\n if (typeof description !== \"string\" || !description.startsWith(mark)) {\n return undefined;\n }\n const rest = description.slice(mark.length).trim();\n return rest === \"\" ? { $ref: ref } : { $ref: ref, description: rest };\n };\n const visit = (node: unknown): unknown => {\n if (Array.isArray(node)) return node.map(visit);\n if (!isRecord(node)) return node;\n const reference =\n marked(node.description, A2UI_COMPONENT_ID_MARK, A2UI_COMPONENT_ID_REF) ??\n marked(node.description, A2UI_CHILD_LIST_MARK, A2UI_CHILD_LIST_REF);\n if (reference) return reference;\n return Object.fromEntries(\n Object.entries(node).map(([key, value]) => [key, visit(value)]),\n );\n };\n return visit(schema) as GenerativeUIJSONSchema;\n}\n\n/**\n * Every component reference in a props schema, with its path. Walks\n * `properties`, array `items`, and the variants of `anyOf` / `oneOf` /\n * `allOf`. A union counts as a reference only when every alternative is\n * one of the same kind: a prop that is text in one branch and a child in\n * another cannot be told apart from its value, so it stays data.\n */\nexport function collectChildRefs(schema: GenerativeUIJSONSchema): ChildRef[] {\n const refs: ChildRef[] = [];\n const seen = new Set<string>();\n const add = (path: string[], kind: ChildRefKind) => {\n const key = path.join(\"\\u0000\");\n if (seen.has(key)) return;\n seen.add(key);\n refs.push({ path, kind });\n };\n const visit = (node: unknown, path: string[]) => {\n if (!isRecord(node)) return;\n const kind = childRefKind(node);\n if (kind) return add(path, kind);\n for (const list of [node.anyOf, node.oneOf]) {\n if (!Array.isArray(list) || list.length === 0) continue;\n const kinds = list.map((variant) =>\n isRecord(variant) ? childRefKind(variant) : undefined,\n );\n const [first] = kinds;\n if (first && kinds.every((k) => k === first)) add(path, first);\n else if (kinds.every((k) => k === undefined)) {\n // Objects in a union: a nested reference counts only when every\n // alternative has it at the same path with the same kind.\n const perVariant = list.map((variant) =>\n collectChildRefs(variant as GenerativeUIJSONSchema),\n );\n const key = (ref: ChildRef) =>\n `${ref.kind}\\u0000${ref.path.join(\"\\u0000\")}`;\n const shared = perVariant[0].filter((ref) =>\n perVariant.every((refs) => refs.some((r) => key(r) === key(ref))),\n );\n shared.forEach((ref) => add([...path, ...ref.path], ref.kind));\n }\n }\n if (Array.isArray(node.allOf)) {\n node.allOf.forEach((variant) => visit(variant, path));\n }\n if (isRecord(node.properties)) {\n for (const [key, value] of Object.entries(node.properties)) {\n visit(value, [...path, key]);\n }\n }\n if (isRecord(node.items)) visit(node.items, [...path, \"*\"]);\n };\n visit(schema, []);\n return refs;\n}\n\n/**\n * The component ids at the references of one component node: a string id,\n * a list of ids, or the `componentId` of a template, at every ref path.\n * Bound or computed values are not ids and are left out.\n */\nexport function childIdsAtRefs(\n component: Record<string, unknown>,\n refs: readonly ChildRef[],\n): string[] {\n const ids: string[] = [];\n const collect = (value: unknown) => {\n if (typeof value === \"string\") ids.push(value);\n else if (Array.isArray(value)) {\n value.forEach((id) => typeof id === \"string\" && ids.push(id));\n } else if (isRecord(value) && typeof value.componentId === \"string\") {\n ids.push(value.componentId);\n }\n };\n const visit = (value: unknown, path: readonly string[]) => {\n if (path.length === 0) return collect(value);\n const [head, ...rest] = path;\n if (head === \"*\") {\n if (Array.isArray(value)) value.forEach((item) => visit(item, rest));\n return;\n }\n if (isRecord(value) && Object.prototype.hasOwnProperty.call(value, head)) {\n visit(value[head], rest);\n }\n };\n for (const ref of refs) visit(component, ref.path);\n return ids;\n}\n\n/**\n * True when a reference of the component is bound or computed (`{\"@path\"}`,\n * `{\"@call\"}`) at the ref itself or above it, so its ids are known only\n * at render time.\n */\nexport function hasBoundChildRef(\n component: Record<string, unknown>,\n refs: readonly ChildRef[],\n): boolean {\n const isDynamic = (value: unknown) =>\n isRecord(value) && (\"@path\" in value || \"@call\" in value);\n const visit = (value: unknown, path: readonly string[]): boolean => {\n if (isDynamic(value)) return true;\n if (path.length === 0) return false;\n const [head, ...rest] = path;\n if (head === \"*\") {\n return Array.isArray(value) && value.some((item) => visit(item, rest));\n }\n return (\n isRecord(value) &&\n Object.prototype.hasOwnProperty.call(value, head) &&\n visit(value[head], rest)\n );\n };\n return refs.some((ref) => visit(component, ref.path));\n}\n\n/**\n * Walks `value` along a ref path and replaces what sits at the end with\n * `replace(found)`. Objects and arrays on the way are copied; everything\n * else keeps its identity. Missing keys are left alone.\n */\nexport function mapAtChildRef(\n value: unknown,\n path: readonly string[],\n replace: (found: unknown) => unknown,\n): unknown {\n if (path.length === 0) return replace(value);\n const [head, ...rest] = path;\n if (head === \"*\") {\n if (!Array.isArray(value)) return value;\n return value.map((item) => mapAtChildRef(item, rest, replace));\n }\n if (!isRecord(value) || !Object.prototype.hasOwnProperty.call(value, head)) {\n return value;\n }\n return { ...value, [head]: mapAtChildRef(value[head], rest, replace) };\n}\n"],"mappings":";;;;;;;;;AASA,MAAa,wBAAwB;AACrC,MAAa,sBAAsB;;;;;;;;AASnC,MAAa,yBAAyB;AACtC,MAAa,uBAAuB;;AAgBpC,SAAgB,aACd,QAC0B;CAC1B,MAAM,MAAM,OAAO;AACnB,KAAI,QAAQ,sBAAuB,QAAO;AAC1C,KAAI,QAAQ,oBAAqB,QAAO;;;;;;;AAS1C,SAAgB,mBACd,QACwB;CACxB,MAAM,UAAU,aAAsB,MAAc,QAAgB;AAClE,MAAI,OAAO,gBAAgB,YAAY,CAAC,YAAY,WAAW,KAAK,CAClE;EAEF,MAAM,OAAO,YAAY,MAAM,KAAK,OAAO,CAAC,MAAM;AAClD,SAAO,SAAS,KAAK,EAAE,MAAM,KAAK,GAAG;GAAE,MAAM;GAAK,aAAa;GAAM;;CAEvE,MAAM,SAAS,SAA2B;AACxC,MAAI,MAAM,QAAQ,KAAK,CAAE,QAAO,KAAK,IAAI,MAAM;AAC/C,MAAI,CAACA,2BAAS,KAAK,CAAE,QAAO;EAC5B,MAAM,YACJ,OAAO,KAAK,aAAa,wBAAwB,sBAAsB,IACvE,OAAO,KAAK,aAAa,sBAAsB,oBAAoB;AACrE,MAAI,UAAW,QAAO;AACtB,SAAO,OAAO,YACZ,OAAO,QAAQ,KAAK,CAAC,KAAK,CAAC,KAAK,WAAW,CAAC,KAAK,MAAM,MAAM,CAAC,CAAC,CAChE;;AAEH,QAAO,MAAM,OAAO;;;;;;;;;AAUtB,SAAgB,iBAAiB,QAA4C;CAC3E,MAAM,OAAmB,EAAE;CAC3B,MAAM,uBAAO,IAAI,KAAa;CAC9B,MAAM,OAAO,MAAgB,SAAuB;EAClD,MAAM,MAAM,KAAK,KAAK,KAAS;AAC/B,MAAI,KAAK,IAAI,IAAI,CAAE;AACnB,OAAK,IAAI,IAAI;AACb,OAAK,KAAK;GAAE;GAAM;GAAM,CAAC;;CAE3B,MAAM,SAAS,MAAe,SAAmB;AAC/C,MAAI,CAACA,2BAAS,KAAK,CAAE;EACrB,MAAM,OAAO,aAAa,KAAK;AAC/B,MAAI,KAAM,QAAO,IAAI,MAAM,KAAK;AAChC,OAAK,MAAM,QAAQ,CAAC,KAAK,OAAO,KAAK,MAAM,EAAE;AAC3C,OAAI,CAAC,MAAM,QAAQ,KAAK,IAAI,KAAK,WAAW,EAAG;GAC/C,MAAM,QAAQ,KAAK,KAAK,YACtBA,2BAAS,QAAQ,GAAG,aAAa,QAAQ,GAAG,OAC7C;GACD,MAAM,CAAC,SAAS;AAChB,OAAI,SAAS,MAAM,OAAO,MAAM,MAAM,MAAM,CAAE,KAAI,MAAM,MAAM;YACrD,MAAM,OAAO,MAAM,MAAM,OAAU,EAAE;IAG5C,MAAM,aAAa,KAAK,KAAK,YAC3B,iBAAiB,QAAkC,CACpD;IACD,MAAM,OAAO,QACX,GAAG,IAAI,KAAK,QAAQ,IAAI,KAAK,KAAK,KAAS;AAI7C,IAHe,WAAW,GAAG,QAAQ,QACnC,WAAW,OAAO,SAAS,KAAK,MAAM,MAAM,IAAI,EAAE,KAAK,IAAI,IAAI,CAAC,CAAC,CAClE,CACM,SAAS,QAAQ,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,KAAK,EAAE,IAAI,KAAK,CAAC;;;AAGlE,MAAI,MAAM,QAAQ,KAAK,MAAM,CAC3B,MAAK,MAAM,SAAS,YAAY,MAAM,SAAS,KAAK,CAAC;AAEvD,MAAIA,2BAAS,KAAK,WAAW,CAC3B,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,KAAK,WAAW,CACxD,OAAM,OAAO,CAAC,GAAG,MAAM,IAAI,CAAC;AAGhC,MAAIA,2BAAS,KAAK,MAAM,CAAE,OAAM,KAAK,OAAO,CAAC,GAAG,MAAM,IAAI,CAAC;;AAE7D,OAAM,QAAQ,EAAE,CAAC;AACjB,QAAO;;;;;;;AAQT,SAAgB,eACd,WACA,MACU;CACV,MAAM,MAAgB,EAAE;CACxB,MAAM,WAAW,UAAmB;AAClC,MAAI,OAAO,UAAU,SAAU,KAAI,KAAK,MAAM;WACrC,MAAM,QAAQ,MAAM,CAC3B,OAAM,SAAS,OAAO,OAAO,OAAO,YAAY,IAAI,KAAK,GAAG,CAAC;WACpDA,2BAAS,MAAM,IAAI,OAAO,MAAM,gBAAgB,SACzD,KAAI,KAAK,MAAM,YAAY;;CAG/B,MAAM,SAAS,OAAgB,SAA4B;AACzD,MAAI,KAAK,WAAW,EAAG,QAAO,QAAQ,MAAM;EAC5C,MAAM,CAAC,MAAM,GAAG,QAAQ;AACxB,MAAI,SAAS,KAAK;AAChB,OAAI,MAAM,QAAQ,MAAM,CAAE,OAAM,SAAS,SAAS,MAAM,MAAM,KAAK,CAAC;AACpE;;AAEF,MAAIA,2BAAS,MAAM,IAAI,OAAO,UAAU,eAAe,KAAK,OAAO,KAAK,CACtE,OAAM,MAAM,OAAO,KAAK;;AAG5B,MAAK,MAAM,OAAO,KAAM,OAAM,WAAW,IAAI,KAAK;AAClD,QAAO;;;;;;;AAQT,SAAgB,iBACd,WACA,MACS;CACT,MAAM,aAAa,UACjBA,2BAAS,MAAM,KAAK,WAAW,SAAS,WAAW;CACrD,MAAM,SAAS,OAAgB,SAAqC;AAClE,MAAI,UAAU,MAAM,CAAE,QAAO;AAC7B,MAAI,KAAK,WAAW,EAAG,QAAO;EAC9B,MAAM,CAAC,MAAM,GAAG,QAAQ;AACxB,MAAI,SAAS,IACX,QAAO,MAAM,QAAQ,MAAM,IAAI,MAAM,MAAM,SAAS,MAAM,MAAM,KAAK,CAAC;AAExE,SACEA,2BAAS,MAAM,IACf,OAAO,UAAU,eAAe,KAAK,OAAO,KAAK,IACjD,MAAM,MAAM,OAAO,KAAK;;AAG5B,QAAO,KAAK,MAAM,QAAQ,MAAM,WAAW,IAAI,KAAK,CAAC;;;;;;;AAQvD,SAAgB,cACd,OACA,MACA,SACS;AACT,KAAI,KAAK,WAAW,EAAG,QAAO,QAAQ,MAAM;CAC5C,MAAM,CAAC,MAAM,GAAG,QAAQ;AACxB,KAAI,SAAS,KAAK;AAChB,MAAI,CAAC,MAAM,QAAQ,MAAM,CAAE,QAAO;AAClC,SAAO,MAAM,KAAK,SAAS,cAAc,MAAM,MAAM,QAAQ,CAAC;;AAEhE,KAAI,CAACA,2BAAS,MAAM,IAAI,CAAC,OAAO,UAAU,eAAe,KAAK,OAAO,KAAK,CACxE,QAAO;AAET,QAAO;EAAE,GAAG;GAAQ,OAAO,cAAc,MAAM,OAAO,MAAM,QAAQ;EAAE"}
1
+ {"version":3,"file":"child-refs.cjs","names":["isRecord"],"sources":["../../src/generative-ui/child-refs.ts"],"sourcesContent":["import type { GenerativeUIJSONSchema } from \"./types\";\nimport { isRecord } from \"./is-record\";\n\n/**\n * How A2UI 1.0 marks a prop that holds a component reference: the JSON\n * Schema of the prop is a `$ref` to one of these two common types.\n * Validators and renderers find the children of a component by these refs,\n * at any depth of the props schema.\n */\nexport const A2UI_COMPONENT_ID_REF = \"common_types.json#/$defs/ComponentId\";\nexport const A2UI_CHILD_LIST_REF = \"common_types.json#/$defs/ChildList\";\n\n/**\n * The start of the `description` that marks a schema as a component\n * reference before it is turned into JSON Schema. `child()` and\n * `childList()` set it; a schema from another library can set a description\n * that starts with the same mark to get the same effect. What follows the\n * mark (after a space) stays as the description of the reference.\n */\nexport const A2UI_COMPONENT_ID_MARK = \"@a2ui/ComponentId\";\nexport const A2UI_CHILD_LIST_MARK = \"@a2ui/ChildList\";\n\nexport type ChildRefKind = \"single\" | \"multiple\";\n\n/** One component reference in a props schema. */\nexport interface ChildRef {\n /**\n * The keys from the props root to the reference. `\"*\"` stands for the\n * items of an array. `[\"tabs\", \"*\", \"child\"]` is the `child` of each\n * entry of `tabs`.\n */\n path: readonly string[];\n kind: ChildRefKind;\n}\n\n/** The ref kind of a JSON Schema node, or `undefined` for a plain value. */\nexport function childRefKind(\n schema: GenerativeUIJSONSchema,\n): ChildRefKind | undefined {\n const ref = schema.$ref;\n if (ref === A2UI_COMPONENT_ID_REF) return \"single\";\n if (ref === A2UI_CHILD_LIST_REF) return \"multiple\";\n return undefined;\n}\n\n/**\n * Turns the reference marks of a JSON Schema into A2UI `$ref`s, in place of\n * the marked node. The mark is the `description` set by `child()` and\n * `childList()`; after this, the node is `{ \"$ref\": \"common_types.json#/...\" }`.\n */\nexport function applyChildRefMarks(\n schema: GenerativeUIJSONSchema,\n): GenerativeUIJSONSchema {\n const marked = (description: unknown, mark: string, ref: string) => {\n if (typeof description !== \"string\" || !description.startsWith(mark)) {\n return undefined;\n }\n const rest = description.slice(mark.length).trim();\n return rest === \"\" ? { $ref: ref } : { $ref: ref, description: rest };\n };\n const visit = (node: unknown): unknown => {\n if (Array.isArray(node)) return node.map(visit);\n if (!isRecord(node)) return node;\n const reference =\n marked(node.description, A2UI_COMPONENT_ID_MARK, A2UI_COMPONENT_ID_REF) ??\n marked(node.description, A2UI_CHILD_LIST_MARK, A2UI_CHILD_LIST_REF);\n if (reference) return reference;\n return Object.fromEntries(\n Object.entries(node).map(([key, value]) => [key, visit(value)]),\n );\n };\n return visit(schema) as GenerativeUIJSONSchema;\n}\n\n/**\n * Every component reference in a props schema, with its path. Walks\n * `properties`, array `items`, and the variants of `anyOf` / `oneOf` /\n * `allOf`. A union counts as a reference only when every alternative is\n * one of the same kind: a prop that is text in one branch and a child in\n * another cannot be told apart from its value, so it stays data.\n */\nexport function collectChildRefs(schema: GenerativeUIJSONSchema): ChildRef[] {\n const refs: ChildRef[] = [];\n const seen = new Set<string>();\n const add = (path: string[], kind: ChildRefKind) => {\n const key = path.join(\"\\u0000\");\n if (seen.has(key)) return;\n seen.add(key);\n refs.push({ path, kind });\n };\n const visit = (node: unknown, path: string[]) => {\n if (!isRecord(node)) return;\n const kind = childRefKind(node);\n if (kind) return add(path, kind);\n for (const list of [node.anyOf, node.oneOf]) {\n if (!Array.isArray(list) || list.length === 0) continue;\n const kinds = list.map((variant) =>\n isRecord(variant) ? childRefKind(variant) : undefined,\n );\n const [first] = kinds;\n if (first && kinds.every((k) => k === first)) add(path, first);\n else if (kinds.every((k) => k === undefined)) {\n // Objects in a union: a nested reference counts only when every\n // alternative has it at the same path with the same kind.\n const perVariant = list.map((variant) =>\n collectChildRefs(variant as GenerativeUIJSONSchema),\n );\n const key = (ref: ChildRef) =>\n `${ref.kind}\\u0000${ref.path.join(\"\\u0000\")}`;\n // `list` is not empty (checked above), so `perVariant` is not empty.\n const shared = perVariant[0]!.filter((ref) =>\n perVariant.every((refs) => refs.some((r) => key(r) === key(ref))),\n );\n shared.forEach((ref) => add([...path, ...ref.path], ref.kind));\n }\n }\n if (Array.isArray(node.allOf)) {\n node.allOf.forEach((variant) => visit(variant, path));\n }\n if (isRecord(node.properties)) {\n for (const [key, value] of Object.entries(node.properties)) {\n visit(value, [...path, key]);\n }\n }\n if (isRecord(node.items)) visit(node.items, [...path, \"*\"]);\n };\n visit(schema, []);\n return refs;\n}\n\n/**\n * The component ids at the references of one component node: a string id,\n * a list of ids, or the `componentId` of a template, at every ref path.\n * Bound or computed values are not ids and are left out.\n */\nexport function childIdsAtRefs(\n component: Record<string, unknown>,\n refs: readonly ChildRef[],\n): string[] {\n const ids: string[] = [];\n const collect = (value: unknown) => {\n if (typeof value === \"string\") ids.push(value);\n else if (Array.isArray(value)) {\n value.forEach((id) => typeof id === \"string\" && ids.push(id));\n } else if (isRecord(value) && typeof value.componentId === \"string\") {\n ids.push(value.componentId);\n }\n };\n const visit = (value: unknown, path: readonly string[]) => {\n const [head, ...rest] = path;\n if (head === undefined) return collect(value);\n if (head === \"*\") {\n if (Array.isArray(value)) value.forEach((item) => visit(item, rest));\n return;\n }\n if (isRecord(value) && Object.prototype.hasOwnProperty.call(value, head)) {\n visit(value[head], rest);\n }\n };\n for (const ref of refs) visit(component, ref.path);\n return ids;\n}\n\n/**\n * True when a reference of the component is bound or computed (`{\"@path\"}`,\n * `{\"@call\"}`) at the ref itself or above it, so its ids are known only\n * at render time.\n */\nexport function hasBoundChildRef(\n component: Record<string, unknown>,\n refs: readonly ChildRef[],\n): boolean {\n const isDynamic = (value: unknown) =>\n isRecord(value) && (\"@path\" in value || \"@call\" in value);\n const visit = (value: unknown, path: readonly string[]): boolean => {\n if (isDynamic(value)) return true;\n const [head, ...rest] = path;\n if (head === undefined) return false;\n if (head === \"*\") {\n return Array.isArray(value) && value.some((item) => visit(item, rest));\n }\n return (\n isRecord(value) &&\n Object.prototype.hasOwnProperty.call(value, head) &&\n visit(value[head], rest)\n );\n };\n return refs.some((ref) => visit(component, ref.path));\n}\n\n/**\n * Walks `value` along a ref path and replaces what sits at the end with\n * `replace(found)`. Objects and arrays on the way are copied; everything\n * else keeps its identity. Missing keys are left alone.\n */\nexport function mapAtChildRef(\n value: unknown,\n path: readonly string[],\n replace: (found: unknown) => unknown,\n): unknown {\n const [head, ...rest] = path;\n if (head === undefined) return replace(value);\n if (head === \"*\") {\n if (!Array.isArray(value)) return value;\n return value.map((item) => mapAtChildRef(item, rest, replace));\n }\n if (!isRecord(value) || !Object.prototype.hasOwnProperty.call(value, head)) {\n return value;\n }\n return { ...value, [head]: mapAtChildRef(value[head], rest, replace) };\n}\n"],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"child-refs.d.cts","names":[],"sources":["../../src/generative-ui/child-refs.ts"],"mappings":";;;;;AASA;;;;cAAa,qBAAA;AAAA,cACA,mBAAA;;;;;AASb;;;cAAa,sBAAA;AAAA,cACA,oBAAA;AAAA,KAED,YAAA;;UAGK,QAAA;EALgB;;AAEjC;;;EASE,IAAA;EACA,IAAA,EAAM,YAAA;AAAA;;iBAIQ,YAAA,CACd,MAAA,EAAQ,sBAAA,GACP,YAAA;;;;;;iBAYa,kBAAA,CACd,MAAA,EAAQ,sBAAA,GACP,sBAAA;AAhBH;;;;;;;AAAA,iBA6CgB,gBAAA,CAAiB,MAAA,EAAQ,sBAAA,GAAyB,QAAA;;AA/BlE;;;;iBAoFgB,cAAA,CACd,SAAA,EAAW,MAAA,mBACX,IAAA,WAAe,QAAA;;;;;AAvDjB;iBAsFgB,gBAAA,CACd,SAAA,EAAW,MAAA,mBACX,IAAA,WAAe,QAAA;;;;;;iBAyBD,aAAA,CACd,KAAA,WACA,IAAA,qBACA,OAAA,GAAU,KAAA"}
1
+ {"version":3,"file":"child-refs.d.cts","names":[],"sources":["../../src/generative-ui/child-refs.ts"],"mappings":";;;;;AASA;;;;cAAa,qBAAA;AAAA,cACA,mBAAA;;;;;AASb;;;cAAa,sBAAA;AAAA,cACA,oBAAA;AAAA,KAED,YAAA;;UAGK,QAAA;EALgB;;AAEjC;;;EASE,IAAA;EACA,IAAA,EAAM,YAAA;AAAA;;iBAIQ,YAAA,CACd,MAAA,EAAQ,sBAAA,GACP,YAAA;;;;;;iBAYa,kBAAA,CACd,MAAA,EAAQ,sBAAA,GACP,sBAAA;AAhBH;;;;;;;AAAA,iBA6CgB,gBAAA,CAAiB,MAAA,EAAQ,sBAAA,GAAyB,QAAA;;AA/BlE;;;;iBAqFgB,cAAA,CACd,SAAA,EAAW,MAAA,mBACX,IAAA,WAAe,QAAA;;;;;AAxDjB;iBAuFgB,gBAAA,CACd,SAAA,EAAW,MAAA,mBACX,IAAA,WAAe,QAAA;;;;;;iBAyBD,aAAA,CACd,KAAA,WACA,IAAA,qBACA,OAAA,GAAU,KAAA"}
@@ -1 +1 @@
1
- {"version":3,"file":"child-refs.d.mts","names":[],"sources":["../../src/generative-ui/child-refs.ts"],"mappings":";;;;;AASA;;;;cAAa,qBAAA;AAAA,cACA,mBAAA;;;;;AASb;;;cAAa,sBAAA;AAAA,cACA,oBAAA;AAAA,KAED,YAAA;;UAGK,QAAA;EALgB;;AAEjC;;;EASE,IAAA;EACA,IAAA,EAAM,YAAA;AAAA;;iBAIQ,YAAA,CACd,MAAA,EAAQ,sBAAA,GACP,YAAA;;;;;;iBAYa,kBAAA,CACd,MAAA,EAAQ,sBAAA,GACP,sBAAA;AAhBH;;;;;;;AAAA,iBA6CgB,gBAAA,CAAiB,MAAA,EAAQ,sBAAA,GAAyB,QAAA;;AA/BlE;;;;iBAoFgB,cAAA,CACd,SAAA,EAAW,MAAA,mBACX,IAAA,WAAe,QAAA;;;;;AAvDjB;iBAsFgB,gBAAA,CACd,SAAA,EAAW,MAAA,mBACX,IAAA,WAAe,QAAA;;;;;;iBAyBD,aAAA,CACd,KAAA,WACA,IAAA,qBACA,OAAA,GAAU,KAAA"}
1
+ {"version":3,"file":"child-refs.d.mts","names":[],"sources":["../../src/generative-ui/child-refs.ts"],"mappings":";;;;;AASA;;;;cAAa,qBAAA;AAAA,cACA,mBAAA;;;;;AASb;;;cAAa,sBAAA;AAAA,cACA,oBAAA;AAAA,KAED,YAAA;;UAGK,QAAA;EALgB;;AAEjC;;;EASE,IAAA;EACA,IAAA,EAAM,YAAA;AAAA;;iBAIQ,YAAA,CACd,MAAA,EAAQ,sBAAA,GACP,YAAA;;;;;;iBAYa,kBAAA,CACd,MAAA,EAAQ,sBAAA,GACP,sBAAA;AAhBH;;;;;;;AAAA,iBA6CgB,gBAAA,CAAiB,MAAA,EAAQ,sBAAA,GAAyB,QAAA;;AA/BlE;;;;iBAqFgB,cAAA,CACd,SAAA,EAAW,MAAA,mBACX,IAAA,WAAe,QAAA;;;;;AAxDjB;iBAuFgB,gBAAA,CACd,SAAA,EAAW,MAAA,mBACX,IAAA,WAAe,QAAA;;;;;;iBAyBD,aAAA,CACd,KAAA,WACA,IAAA,qBACA,OAAA,GAAU,KAAA"}
@@ -101,8 +101,8 @@ function childIdsAtRefs(component, refs) {
101
101
  else if (isRecord(value) && typeof value.componentId === "string") ids.push(value.componentId);
102
102
  };
103
103
  const visit = (value, path) => {
104
- if (path.length === 0) return collect(value);
105
104
  const [head, ...rest] = path;
105
+ if (head === void 0) return collect(value);
106
106
  if (head === "*") {
107
107
  if (Array.isArray(value)) value.forEach((item) => visit(item, rest));
108
108
  return;
@@ -121,8 +121,8 @@ function hasBoundChildRef(component, refs) {
121
121
  const isDynamic = (value) => isRecord(value) && ("@path" in value || "@call" in value);
122
122
  const visit = (value, path) => {
123
123
  if (isDynamic(value)) return true;
124
- if (path.length === 0) return false;
125
124
  const [head, ...rest] = path;
125
+ if (head === void 0) return false;
126
126
  if (head === "*") return Array.isArray(value) && value.some((item) => visit(item, rest));
127
127
  return isRecord(value) && Object.prototype.hasOwnProperty.call(value, head) && visit(value[head], rest);
128
128
  };
@@ -134,8 +134,8 @@ function hasBoundChildRef(component, refs) {
134
134
  * else keeps its identity. Missing keys are left alone.
135
135
  */
136
136
  function mapAtChildRef(value, path, replace) {
137
- if (path.length === 0) return replace(value);
138
137
  const [head, ...rest] = path;
138
+ if (head === void 0) return replace(value);
139
139
  if (head === "*") {
140
140
  if (!Array.isArray(value)) return value;
141
141
  return value.map((item) => mapAtChildRef(item, rest, replace));