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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (569) hide show
  1. package/README.md +4 -15
  2. package/dist/a2ui-envelope.cjs +3 -3
  3. package/dist/a2ui-envelope.cjs.map +1 -1
  4. package/dist/a2ui-envelope.d.cts +1 -1
  5. package/dist/a2ui-envelope.d.cts.map +1 -1
  6. package/dist/a2ui-envelope.d.mts +1 -1
  7. package/dist/a2ui-envelope.d.mts.map +1 -1
  8. package/dist/a2ui-envelope.mjs +3 -3
  9. package/dist/a2ui-envelope.mjs.map +1 -1
  10. package/dist/a2ui-prompts.cjs +21 -62
  11. package/dist/a2ui-prompts.cjs.map +1 -1
  12. package/dist/a2ui-prompts.d.cts +8 -1
  13. package/dist/a2ui-prompts.d.cts.map +1 -1
  14. package/dist/a2ui-prompts.d.mts +8 -1
  15. package/dist/a2ui-prompts.d.mts.map +1 -1
  16. package/dist/a2ui-prompts.mjs +22 -62
  17. package/dist/a2ui-prompts.mjs.map +1 -1
  18. package/dist/attachments/types.d.cts +1 -3
  19. package/dist/attachments/types.d.cts.map +1 -1
  20. package/dist/attachments/types.d.mts +1 -3
  21. package/dist/attachments/types.d.mts.map +1 -1
  22. package/dist/attachments/utils.cjs +16 -5
  23. package/dist/attachments/utils.cjs.map +1 -1
  24. package/dist/attachments/utils.d.cts +3 -1
  25. package/dist/attachments/utils.d.cts.map +1 -1
  26. package/dist/attachments/utils.d.mts +3 -1
  27. package/dist/attachments/utils.d.mts.map +1 -1
  28. package/dist/attachments/utils.mjs +16 -5
  29. package/dist/attachments/utils.mjs.map +1 -1
  30. package/dist/finalize-events.cjs +16 -0
  31. package/dist/finalize-events.cjs.map +1 -1
  32. package/dist/finalize-events.d.cts.map +1 -1
  33. package/dist/finalize-events.d.mts.map +1 -1
  34. package/dist/finalize-events.mjs +16 -0
  35. package/dist/finalize-events.mjs.map +1 -1
  36. package/dist/generative-ui/basic-functions.cjs +1 -1
  37. package/dist/generative-ui/basic-functions.cjs.map +1 -1
  38. package/dist/generative-ui/basic-functions.mjs +1 -1
  39. package/dist/generative-ui/basic-functions.mjs.map +1 -1
  40. package/dist/generative-ui/catalog/catalog-export.cjs +329 -0
  41. package/dist/generative-ui/catalog/catalog-export.cjs.map +1 -0
  42. package/dist/generative-ui/catalog/catalog-export.d.cts +92 -0
  43. package/dist/generative-ui/catalog/catalog-export.d.cts.map +1 -0
  44. package/dist/generative-ui/catalog/catalog-export.d.mts +92 -0
  45. package/dist/generative-ui/catalog/catalog-export.d.mts.map +1 -0
  46. package/dist/generative-ui/catalog/catalog-export.mjs +328 -0
  47. package/dist/generative-ui/catalog/catalog-export.mjs.map +1 -0
  48. package/dist/generative-ui/catalog/catalog.cjs +315 -0
  49. package/dist/generative-ui/catalog/catalog.cjs.map +1 -0
  50. package/dist/generative-ui/catalog/catalog.d.cts +407 -0
  51. package/dist/generative-ui/catalog/catalog.d.cts.map +1 -0
  52. package/dist/generative-ui/catalog/catalog.d.mts +407 -0
  53. package/dist/generative-ui/catalog/catalog.d.mts.map +1 -0
  54. package/dist/generative-ui/catalog/catalog.mjs +312 -0
  55. package/dist/generative-ui/catalog/catalog.mjs.map +1 -0
  56. package/dist/generative-ui/catalog/errors.cjs +13 -0
  57. package/dist/generative-ui/catalog/errors.cjs.map +1 -0
  58. package/dist/generative-ui/catalog/errors.d.cts +46 -0
  59. package/dist/generative-ui/catalog/errors.d.cts.map +1 -0
  60. package/dist/generative-ui/catalog/errors.d.mts +46 -0
  61. package/dist/generative-ui/catalog/errors.d.mts.map +1 -0
  62. package/dist/generative-ui/catalog/errors.mjs +12 -0
  63. package/dist/generative-ui/catalog/errors.mjs.map +1 -0
  64. package/dist/generative-ui/catalog/index.d.mts +6 -0
  65. package/dist/generative-ui/catalog/json-schema.cjs +16 -0
  66. package/dist/generative-ui/catalog/json-schema.cjs.map +1 -0
  67. package/dist/generative-ui/catalog/json-schema.d.cts +12 -0
  68. package/dist/generative-ui/catalog/json-schema.d.cts.map +1 -0
  69. package/dist/generative-ui/catalog/json-schema.d.mts +12 -0
  70. package/dist/generative-ui/catalog/json-schema.d.mts.map +1 -0
  71. package/dist/generative-ui/catalog/json-schema.mjs +16 -0
  72. package/dist/generative-ui/catalog/json-schema.mjs.map +1 -0
  73. package/dist/generative-ui/catalog/refs.cjs +21 -0
  74. package/dist/generative-ui/catalog/refs.cjs.map +1 -0
  75. package/dist/generative-ui/catalog/refs.d.cts +55 -0
  76. package/dist/generative-ui/catalog/refs.d.cts.map +1 -0
  77. package/dist/generative-ui/catalog/refs.d.mts +55 -0
  78. package/dist/generative-ui/catalog/refs.d.mts.map +1 -0
  79. package/dist/generative-ui/catalog/refs.mjs +18 -0
  80. package/dist/generative-ui/catalog/refs.mjs.map +1 -0
  81. package/dist/generative-ui/catalog/schema.cjs +74 -0
  82. package/dist/generative-ui/catalog/schema.cjs.map +1 -0
  83. package/dist/generative-ui/catalog/schema.d.cts +43 -0
  84. package/dist/generative-ui/catalog/schema.d.cts.map +1 -0
  85. package/dist/generative-ui/catalog/schema.d.mts +43 -0
  86. package/dist/generative-ui/catalog/schema.d.mts.map +1 -0
  87. package/dist/generative-ui/catalog/schema.mjs +68 -0
  88. package/dist/generative-ui/catalog/schema.mjs.map +1 -0
  89. package/dist/generative-ui/child-refs.cjs +3 -3
  90. package/dist/generative-ui/child-refs.cjs.map +1 -1
  91. package/dist/generative-ui/child-refs.d.cts.map +1 -1
  92. package/dist/generative-ui/child-refs.d.mts.map +1 -1
  93. package/dist/generative-ui/child-refs.mjs +3 -3
  94. package/dist/generative-ui/child-refs.mjs.map +1 -1
  95. package/dist/generative-ui/clone-value.cjs +364 -0
  96. package/dist/generative-ui/clone-value.cjs.map +1 -0
  97. package/dist/generative-ui/clone-value.d.cts +51 -0
  98. package/dist/generative-ui/clone-value.d.cts.map +1 -0
  99. package/dist/generative-ui/clone-value.d.mts +51 -0
  100. package/dist/generative-ui/clone-value.d.mts.map +1 -0
  101. package/dist/generative-ui/clone-value.mjs +363 -0
  102. package/dist/generative-ui/clone-value.mjs.map +1 -0
  103. package/dist/generative-ui/compact-schema.cjs +187 -0
  104. package/dist/generative-ui/compact-schema.cjs.map +1 -0
  105. package/dist/generative-ui/compact-schema.d.cts +55 -0
  106. package/dist/generative-ui/compact-schema.d.cts.map +1 -0
  107. package/dist/generative-ui/compact-schema.d.mts +55 -0
  108. package/dist/generative-ui/compact-schema.d.mts.map +1 -0
  109. package/dist/generative-ui/compact-schema.mjs +185 -0
  110. package/dist/generative-ui/compact-schema.mjs.map +1 -0
  111. package/dist/generative-ui/index.cjs +286 -0
  112. package/dist/generative-ui/index.d.cts +39 -0
  113. package/dist/generative-ui/index.d.mts +41 -0
  114. package/dist/generative-ui/index.mjs +40 -0
  115. package/dist/generative-ui/is-record.cjs +6 -1
  116. package/dist/generative-ui/is-record.cjs.map +1 -1
  117. package/dist/generative-ui/is-record.d.cts +8 -0
  118. package/dist/generative-ui/is-record.d.cts.map +1 -0
  119. package/dist/generative-ui/is-record.d.mts +8 -0
  120. package/dist/generative-ui/is-record.d.mts.map +1 -0
  121. package/dist/generative-ui/is-record.mjs +6 -2
  122. package/dist/generative-ui/is-record.mjs.map +1 -1
  123. package/dist/generative-ui/prompt-spec.cjs +225 -0
  124. package/dist/generative-ui/prompt-spec.cjs.map +1 -0
  125. package/dist/generative-ui/prompt-spec.d.cts +94 -0
  126. package/dist/generative-ui/prompt-spec.d.cts.map +1 -0
  127. package/dist/generative-ui/prompt-spec.d.mts +94 -0
  128. package/dist/generative-ui/prompt-spec.d.mts.map +1 -0
  129. package/dist/generative-ui/prompt-spec.mjs +220 -0
  130. package/dist/generative-ui/prompt-spec.mjs.map +1 -0
  131. package/dist/generative-ui/prompt.cjs +10 -36
  132. package/dist/generative-ui/prompt.cjs.map +1 -1
  133. package/dist/generative-ui/prompt.d.cts +2 -1
  134. package/dist/generative-ui/prompt.d.cts.map +1 -1
  135. package/dist/generative-ui/prompt.d.mts +2 -1
  136. package/dist/generative-ui/prompt.d.mts.map +1 -1
  137. package/dist/generative-ui/prompt.mjs +12 -38
  138. package/dist/generative-ui/prompt.mjs.map +1 -1
  139. package/dist/generative-ui/render-ui-args.cjs +1 -0
  140. package/dist/generative-ui/render-ui-args.cjs.map +1 -1
  141. package/dist/generative-ui/render-ui-args.d.cts.map +1 -1
  142. package/dist/generative-ui/render-ui-args.d.mts.map +1 -1
  143. package/dist/generative-ui/render-ui-args.mjs +1 -0
  144. package/dist/generative-ui/render-ui-args.mjs.map +1 -1
  145. package/dist/generative-ui/schema-render.cjs +243 -0
  146. package/dist/generative-ui/schema-render.cjs.map +1 -0
  147. package/dist/generative-ui/schema-render.d.cts +44 -0
  148. package/dist/generative-ui/schema-render.d.cts.map +1 -0
  149. package/dist/generative-ui/schema-render.d.mts +44 -0
  150. package/dist/generative-ui/schema-render.d.mts.map +1 -0
  151. package/dist/generative-ui/schema-render.mjs +240 -0
  152. package/dist/generative-ui/schema-render.mjs.map +1 -0
  153. package/dist/generative-ui/standard/chart-config.cjs +347 -0
  154. package/dist/generative-ui/standard/chart-config.cjs.map +1 -0
  155. package/dist/generative-ui/standard/chart-config.d.cts +97 -0
  156. package/dist/generative-ui/standard/chart-config.d.cts.map +1 -0
  157. package/dist/generative-ui/standard/chart-config.d.mts +97 -0
  158. package/dist/generative-ui/standard/chart-config.d.mts.map +1 -0
  159. package/dist/generative-ui/standard/chart-config.mjs +342 -0
  160. package/dist/generative-ui/standard/chart-config.mjs.map +1 -0
  161. package/dist/generative-ui/standard/chart.cjs +56 -0
  162. package/dist/generative-ui/standard/chart.cjs.map +1 -0
  163. package/dist/generative-ui/standard/chart.d.cts +62 -0
  164. package/dist/generative-ui/standard/chart.d.cts.map +1 -0
  165. package/dist/generative-ui/standard/chart.d.mts +62 -0
  166. package/dist/generative-ui/standard/chart.d.mts.map +1 -0
  167. package/dist/generative-ui/standard/chart.mjs +54 -0
  168. package/dist/generative-ui/standard/chart.mjs.map +1 -0
  169. package/dist/generative-ui/standard/checks.cjs +74 -0
  170. package/dist/generative-ui/standard/checks.cjs.map +1 -0
  171. package/dist/generative-ui/standard/checks.d.cts +56 -0
  172. package/dist/generative-ui/standard/checks.d.cts.map +1 -0
  173. package/dist/generative-ui/standard/checks.d.mts +56 -0
  174. package/dist/generative-ui/standard/checks.d.mts.map +1 -0
  175. package/dist/generative-ui/standard/checks.mjs +71 -0
  176. package/dist/generative-ui/standard/checks.mjs.map +1 -0
  177. package/dist/generative-ui/standard/components.cjs +23 -0
  178. package/dist/generative-ui/standard/components.cjs.map +1 -0
  179. package/dist/generative-ui/standard/components.d.cts +24 -0
  180. package/dist/generative-ui/standard/components.d.cts.map +1 -0
  181. package/dist/generative-ui/standard/components.d.mts +24 -0
  182. package/dist/generative-ui/standard/components.d.mts.map +1 -0
  183. package/dist/generative-ui/standard/components.mjs +22 -0
  184. package/dist/generative-ui/standard/components.mjs.map +1 -0
  185. package/dist/generative-ui/standard/composites.cjs +143 -0
  186. package/dist/generative-ui/standard/composites.cjs.map +1 -0
  187. package/dist/generative-ui/standard/composites.d.cts +233 -0
  188. package/dist/generative-ui/standard/composites.d.cts.map +1 -0
  189. package/dist/generative-ui/standard/composites.d.mts +233 -0
  190. package/dist/generative-ui/standard/composites.d.mts.map +1 -0
  191. package/dist/generative-ui/standard/composites.mjs +132 -0
  192. package/dist/generative-ui/standard/composites.mjs.map +1 -0
  193. package/dist/generative-ui/standard/data.cjs +176 -0
  194. package/dist/generative-ui/standard/data.cjs.map +1 -0
  195. package/dist/generative-ui/standard/data.d.cts +365 -0
  196. package/dist/generative-ui/standard/data.d.cts.map +1 -0
  197. package/dist/generative-ui/standard/data.d.mts +365 -0
  198. package/dist/generative-ui/standard/data.d.mts.map +1 -0
  199. package/dist/generative-ui/standard/data.mjs +167 -0
  200. package/dist/generative-ui/standard/data.mjs.map +1 -0
  201. package/dist/generative-ui/standard/declarations.cjs +40 -0
  202. package/dist/generative-ui/standard/declarations.cjs.map +1 -0
  203. package/dist/generative-ui/standard/declarations.d.cts +2570 -0
  204. package/dist/generative-ui/standard/declarations.d.cts.map +1 -0
  205. package/dist/generative-ui/standard/declarations.d.mts +2571 -0
  206. package/dist/generative-ui/standard/declarations.d.mts.map +1 -0
  207. package/dist/generative-ui/standard/declarations.mjs +39 -0
  208. package/dist/generative-ui/standard/declarations.mjs.map +1 -0
  209. package/dist/generative-ui/standard/feedback.cjs +97 -0
  210. package/dist/generative-ui/standard/feedback.cjs.map +1 -0
  211. package/dist/generative-ui/standard/feedback.d.cts +133 -0
  212. package/dist/generative-ui/standard/feedback.d.cts.map +1 -0
  213. package/dist/generative-ui/standard/feedback.d.mts +133 -0
  214. package/dist/generative-ui/standard/feedback.d.mts.map +1 -0
  215. package/dist/generative-ui/standard/feedback.mjs +90 -0
  216. package/dist/generative-ui/standard/feedback.mjs.map +1 -0
  217. package/dist/generative-ui/standard/index.d.mts +20 -0
  218. package/dist/generative-ui/standard/inputs.cjs +333 -0
  219. package/dist/generative-ui/standard/inputs.cjs.map +1 -0
  220. package/dist/generative-ui/standard/inputs.d.cts +1128 -0
  221. package/dist/generative-ui/standard/inputs.d.cts.map +1 -0
  222. package/dist/generative-ui/standard/inputs.d.mts +1128 -0
  223. package/dist/generative-ui/standard/inputs.d.mts.map +1 -0
  224. package/dist/generative-ui/standard/inputs.mjs +318 -0
  225. package/dist/generative-ui/standard/inputs.mjs.map +1 -0
  226. package/dist/generative-ui/standard/layout.cjs +289 -0
  227. package/dist/generative-ui/standard/layout.cjs.map +1 -0
  228. package/dist/generative-ui/standard/layout.d.cts +1974 -0
  229. package/dist/generative-ui/standard/layout.d.cts.map +1 -0
  230. package/dist/generative-ui/standard/layout.d.mts +1975 -0
  231. package/dist/generative-ui/standard/layout.d.mts.map +1 -0
  232. package/dist/generative-ui/standard/layout.mjs +269 -0
  233. package/dist/generative-ui/standard/layout.mjs.map +1 -0
  234. package/dist/generative-ui/standard/map-helpers.cjs +104 -0
  235. package/dist/generative-ui/standard/map-helpers.cjs.map +1 -0
  236. package/dist/generative-ui/standard/map-helpers.d.cts +88 -0
  237. package/dist/generative-ui/standard/map-helpers.d.cts.map +1 -0
  238. package/dist/generative-ui/standard/map-helpers.d.mts +88 -0
  239. package/dist/generative-ui/standard/map-helpers.d.mts.map +1 -0
  240. package/dist/generative-ui/standard/map-helpers.mjs +95 -0
  241. package/dist/generative-ui/standard/map-helpers.mjs.map +1 -0
  242. package/dist/generative-ui/standard/map.cjs +27 -0
  243. package/dist/generative-ui/standard/map.cjs.map +1 -0
  244. package/dist/generative-ui/standard/map.d.cts +31 -0
  245. package/dist/generative-ui/standard/map.d.cts.map +1 -0
  246. package/dist/generative-ui/standard/map.d.mts +31 -0
  247. package/dist/generative-ui/standard/map.d.mts.map +1 -0
  248. package/dist/generative-ui/standard/map.mjs +25 -0
  249. package/dist/generative-ui/standard/map.mjs.map +1 -0
  250. package/dist/generative-ui/standard/media.cjs +215 -0
  251. package/dist/generative-ui/standard/media.cjs.map +1 -0
  252. package/dist/generative-ui/standard/media.d.cts +396 -0
  253. package/dist/generative-ui/standard/media.d.cts.map +1 -0
  254. package/dist/generative-ui/standard/media.d.mts +396 -0
  255. package/dist/generative-ui/standard/media.d.mts.map +1 -0
  256. package/dist/generative-ui/standard/media.mjs +205 -0
  257. package/dist/generative-ui/standard/media.mjs.map +1 -0
  258. package/dist/generative-ui/standard/parameter-order.cjs +231 -0
  259. package/dist/generative-ui/standard/parameter-order.cjs.map +1 -0
  260. package/dist/generative-ui/standard/parameter-order.d.cts +84 -0
  261. package/dist/generative-ui/standard/parameter-order.d.cts.map +1 -0
  262. package/dist/generative-ui/standard/parameter-order.d.mts +84 -0
  263. package/dist/generative-ui/standard/parameter-order.d.mts.map +1 -0
  264. package/dist/generative-ui/standard/parameter-order.mjs +230 -0
  265. package/dist/generative-ui/standard/parameter-order.mjs.map +1 -0
  266. package/dist/generative-ui/standard/style-helpers.cjs +151 -0
  267. package/dist/generative-ui/standard/style-helpers.cjs.map +1 -0
  268. package/dist/generative-ui/standard/style-helpers.d.cts +56 -0
  269. package/dist/generative-ui/standard/style-helpers.d.cts.map +1 -0
  270. package/dist/generative-ui/standard/style-helpers.d.mts +56 -0
  271. package/dist/generative-ui/standard/style-helpers.d.mts.map +1 -0
  272. package/dist/generative-ui/standard/style-helpers.mjs +142 -0
  273. package/dist/generative-ui/standard/style-helpers.mjs.map +1 -0
  274. package/dist/generative-ui/standard/styles.cjs +62 -0
  275. package/dist/generative-ui/standard/styles.cjs.map +1 -0
  276. package/dist/generative-ui/standard/styles.d.cts +17 -0
  277. package/dist/generative-ui/standard/styles.d.cts.map +1 -0
  278. package/dist/generative-ui/standard/styles.d.mts +17 -0
  279. package/dist/generative-ui/standard/styles.d.mts.map +1 -0
  280. package/dist/generative-ui/standard/styles.mjs +60 -0
  281. package/dist/generative-ui/standard/styles.mjs.map +1 -0
  282. package/dist/generative-ui/standard/text.cjs +226 -0
  283. package/dist/generative-ui/standard/text.cjs.map +1 -0
  284. package/dist/generative-ui/standard/text.d.cts +522 -0
  285. package/dist/generative-ui/standard/text.d.cts.map +1 -0
  286. package/dist/generative-ui/standard/text.d.mts +522 -0
  287. package/dist/generative-ui/standard/text.d.mts.map +1 -0
  288. package/dist/generative-ui/standard/text.mjs +209 -0
  289. package/dist/generative-ui/standard/text.mjs.map +1 -0
  290. package/dist/generative-ui/standard/theme.cjs +115 -0
  291. package/dist/generative-ui/standard/theme.cjs.map +1 -0
  292. package/dist/generative-ui/standard/theme.d.cts +60 -0
  293. package/dist/generative-ui/standard/theme.d.cts.map +1 -0
  294. package/dist/generative-ui/standard/theme.d.mts +60 -0
  295. package/dist/generative-ui/standard/theme.d.mts.map +1 -0
  296. package/dist/generative-ui/standard/theme.mjs +112 -0
  297. package/dist/generative-ui/standard/theme.mjs.map +1 -0
  298. package/dist/generative-ui/standard/tokens.cjs +336 -0
  299. package/dist/generative-ui/standard/tokens.cjs.map +1 -0
  300. package/dist/generative-ui/standard/tokens.d.cts +76 -0
  301. package/dist/generative-ui/standard/tokens.d.cts.map +1 -0
  302. package/dist/generative-ui/standard/tokens.d.mts +76 -0
  303. package/dist/generative-ui/standard/tokens.d.mts.map +1 -0
  304. package/dist/generative-ui/standard/tokens.mjs +305 -0
  305. package/dist/generative-ui/standard/tokens.mjs.map +1 -0
  306. package/dist/generative-ui/standard/url.cjs +54 -0
  307. package/dist/generative-ui/standard/url.cjs.map +1 -0
  308. package/dist/generative-ui/standard/url.d.cts +32 -0
  309. package/dist/generative-ui/standard/url.d.cts.map +1 -0
  310. package/dist/generative-ui/standard/url.d.mts +32 -0
  311. package/dist/generative-ui/standard/url.d.mts.map +1 -0
  312. package/dist/generative-ui/standard/url.mjs +50 -0
  313. package/dist/generative-ui/standard/url.mjs.map +1 -0
  314. package/dist/generative-ui/thrown.cjs +69 -0
  315. package/dist/generative-ui/thrown.cjs.map +1 -0
  316. package/dist/generative-ui/thrown.d.cts +21 -0
  317. package/dist/generative-ui/thrown.d.cts.map +1 -0
  318. package/dist/generative-ui/thrown.d.mts +21 -0
  319. package/dist/generative-ui/thrown.d.mts.map +1 -0
  320. package/dist/generative-ui/thrown.mjs +67 -0
  321. package/dist/generative-ui/thrown.mjs.map +1 -0
  322. package/dist/generative-ui/types.cjs +2 -2
  323. package/dist/generative-ui/types.cjs.map +1 -1
  324. package/dist/generative-ui/types.d.cts +20 -7
  325. package/dist/generative-ui/types.d.cts.map +1 -1
  326. package/dist/generative-ui/types.d.mts +20 -7
  327. package/dist/generative-ui/types.d.mts.map +1 -1
  328. package/dist/generative-ui/types.mjs +2 -2
  329. package/dist/generative-ui/types.mjs.map +1 -1
  330. package/dist/generative-ui/validate-operation.cjs +2 -2
  331. package/dist/generative-ui/validate-operation.cjs.map +1 -1
  332. package/dist/generative-ui/validate-operation.mjs +2 -2
  333. package/dist/generative-ui/validate-operation.mjs.map +1 -1
  334. package/dist/index.cjs +18 -15
  335. package/dist/index.cjs.map +1 -1
  336. package/dist/index.d.cts +18 -17
  337. package/dist/index.d.cts.map +1 -1
  338. package/dist/index.d.mts +18 -17
  339. package/dist/index.d.mts.map +1 -1
  340. package/dist/index.mjs +10 -8
  341. package/dist/index.mjs.map +1 -1
  342. package/dist/index.umd.js +1233 -456
  343. package/dist/index.umd.js.map +1 -1
  344. package/dist/package.cjs +1 -1
  345. package/dist/package.mjs +1 -1
  346. package/dist/standard-schema.cjs +20 -7
  347. package/dist/standard-schema.cjs.map +1 -1
  348. package/dist/standard-schema.d.cts +15 -16
  349. package/dist/standard-schema.d.cts.map +1 -1
  350. package/dist/standard-schema.d.mts +15 -16
  351. package/dist/standard-schema.d.mts.map +1 -1
  352. package/dist/standard-schema.mjs +20 -8
  353. package/dist/standard-schema.mjs.map +1 -1
  354. package/dist/telemetry/lambda-client.cjs +1 -1
  355. package/dist/telemetry/lambda-client.cjs.map +1 -1
  356. package/dist/telemetry/lambda-client.d.cts.map +1 -1
  357. package/dist/telemetry/lambda-client.d.mts.map +1 -1
  358. package/dist/telemetry/lambda-client.mjs +1 -1
  359. package/dist/telemetry/lambda-client.mjs.map +1 -1
  360. package/dist/telemetry/telemetry-disabled.cjs +0 -5
  361. package/dist/telemetry/telemetry-disabled.cjs.map +1 -1
  362. package/dist/telemetry/telemetry-disabled.d.cts +0 -5
  363. package/dist/telemetry/telemetry-disabled.d.cts.map +1 -1
  364. package/dist/telemetry/telemetry-disabled.d.mts +0 -5
  365. package/dist/telemetry/telemetry-disabled.d.mts.map +1 -1
  366. package/dist/telemetry/telemetry-disabled.mjs +0 -5
  367. package/dist/telemetry/telemetry-disabled.mjs.map +1 -1
  368. package/dist/types/message.d.cts +1 -18
  369. package/dist/types/message.d.cts.map +1 -1
  370. package/dist/types/message.d.mts +1 -18
  371. package/dist/types/message.d.mts.map +1 -1
  372. package/dist/utils/errors.cjs +5 -42
  373. package/dist/utils/errors.cjs.map +1 -1
  374. package/dist/utils/errors.d.cts +16 -34
  375. package/dist/utils/errors.d.cts.map +1 -1
  376. package/dist/utils/errors.d.mts +16 -34
  377. package/dist/utils/errors.d.mts.map +1 -1
  378. package/dist/utils/errors.mjs +6 -41
  379. package/dist/utils/errors.mjs.map +1 -1
  380. package/dist/utils/index.cjs +0 -2
  381. package/dist/utils/index.cjs.map +1 -1
  382. package/dist/utils/index.d.cts +5 -7
  383. package/dist/utils/index.d.cts.map +1 -1
  384. package/dist/utils/index.d.mts +5 -7
  385. package/dist/utils/index.d.mts.map +1 -1
  386. package/dist/utils/index.mjs +4 -6
  387. package/dist/utils/index.mjs.map +1 -1
  388. package/dist/utils/inspector-visibility.cjs +25 -3
  389. package/dist/utils/inspector-visibility.cjs.map +1 -1
  390. package/dist/utils/inspector-visibility.d.cts +26 -3
  391. package/dist/utils/inspector-visibility.d.cts.map +1 -1
  392. package/dist/utils/inspector-visibility.d.mts +26 -3
  393. package/dist/utils/inspector-visibility.d.mts.map +1 -1
  394. package/dist/utils/inspector-visibility.mjs +25 -4
  395. package/dist/utils/inspector-visibility.mjs.map +1 -1
  396. package/dist/utils/json-schema.cjs +4 -79
  397. package/dist/utils/json-schema.cjs.map +1 -1
  398. package/dist/utils/json-schema.d.cts +1 -4
  399. package/dist/utils/json-schema.d.cts.map +1 -1
  400. package/dist/utils/json-schema.d.mts +1 -4
  401. package/dist/utils/json-schema.d.mts.map +1 -1
  402. package/dist/utils/json-schema.mjs +5 -78
  403. package/dist/utils/json-schema.mjs.map +1 -1
  404. package/dist/utils/random-id.cjs +13 -26
  405. package/dist/utils/random-id.cjs.map +1 -1
  406. package/dist/utils/random-id.d.cts +6 -3
  407. package/dist/utils/random-id.d.cts.map +1 -1
  408. package/dist/utils/random-id.d.mts +6 -3
  409. package/dist/utils/random-id.d.mts.map +1 -1
  410. package/dist/utils/random-id.mjs +14 -25
  411. package/dist/utils/random-id.mjs.map +1 -1
  412. package/dist/utils/types.cjs.map +1 -1
  413. package/dist/utils/types.d.cts +5 -12
  414. package/dist/utils/types.d.cts.map +1 -1
  415. package/dist/utils/types.d.mts +5 -12
  416. package/dist/utils/types.d.mts.map +1 -1
  417. package/dist/utils/types.mjs.map +1 -1
  418. package/package.json +19 -32
  419. package/scripts/verify-cjs-exports.cjs +1 -1
  420. package/src/__tests__/a2ui-envelope.test.ts +38 -13
  421. package/src/__tests__/a2ui-prompts.test.ts +47 -14
  422. package/src/__tests__/fixtures/prompt-goldens.json +354 -0
  423. package/src/__tests__/prompt-spec.test.ts +191 -0
  424. package/src/__tests__/root-entry-browser-safety.test.ts +5 -7
  425. package/src/__tests__/schema-render.test.ts +323 -0
  426. package/src/__tests__/standard-schema.test.ts +61 -101
  427. package/src/a2ui-envelope.ts +9 -7
  428. package/src/a2ui-prompts.ts +47 -96
  429. package/src/attachments/__tests__/utils.test.ts +22 -0
  430. package/src/attachments/types.ts +1 -3
  431. package/src/attachments/utils.ts +23 -5
  432. package/src/finalize-events.ts +16 -0
  433. package/src/generative-ui/__tests__/clone-value-differential.test.ts +480 -0
  434. package/src/generative-ui/__tests__/clone-value.test.ts +226 -0
  435. package/src/generative-ui/__tests__/render-ui-args.test.ts +7 -7
  436. package/src/generative-ui/__tests__/validate-operation.test.ts +19 -13
  437. package/src/generative-ui/base.ts +9 -0
  438. package/src/generative-ui/basic-functions.ts +1 -1
  439. package/src/generative-ui/catalog/catalog-export.ts +478 -0
  440. package/src/generative-ui/catalog/catalog.ts +1167 -0
  441. package/src/generative-ui/catalog/errors.ts +102 -0
  442. package/src/generative-ui/catalog/index.ts +6 -0
  443. package/src/generative-ui/catalog/json-schema.ts +14 -0
  444. package/src/generative-ui/catalog/refs.ts +87 -0
  445. package/src/generative-ui/catalog/schema.ts +107 -0
  446. package/src/generative-ui/child-refs.ts +5 -4
  447. package/src/generative-ui/clone-value.ts +511 -0
  448. package/src/generative-ui/compact-schema.ts +277 -0
  449. package/src/generative-ui/index.ts +14 -0
  450. package/src/generative-ui/is-record.ts +6 -1
  451. package/src/generative-ui/prompt-spec.ts +335 -0
  452. package/src/generative-ui/prompt.ts +25 -75
  453. package/src/generative-ui/render-ui-args.ts +3 -0
  454. package/src/generative-ui/schema-render.ts +378 -0
  455. package/src/generative-ui/standard/__tests__/standard-helpers.test.ts +407 -0
  456. package/src/generative-ui/standard/__tests__/theme.test.ts +61 -0
  457. package/src/generative-ui/standard/__tests__/tokens.test.ts +139 -0
  458. package/src/generative-ui/standard/chart-config.ts +434 -0
  459. package/src/generative-ui/standard/chart.ts +79 -0
  460. package/src/generative-ui/standard/checks.ts +98 -0
  461. package/src/generative-ui/standard/components.ts +35 -0
  462. package/src/generative-ui/standard/composites.ts +158 -0
  463. package/src/generative-ui/standard/data.ts +213 -0
  464. package/src/generative-ui/standard/declarations.ts +57 -0
  465. package/src/generative-ui/standard/feedback.ts +105 -0
  466. package/src/generative-ui/standard/index.ts +55 -0
  467. package/src/generative-ui/standard/inputs.ts +423 -0
  468. package/src/generative-ui/standard/layout.ts +312 -0
  469. package/src/generative-ui/standard/map-helpers.ts +155 -0
  470. package/src/generative-ui/standard/map.ts +32 -0
  471. package/src/generative-ui/standard/media.ts +265 -0
  472. package/src/generative-ui/standard/parameter-order.ts +155 -0
  473. package/src/generative-ui/standard/style-helpers.ts +170 -0
  474. package/src/generative-ui/standard/styles.ts +79 -0
  475. package/src/generative-ui/standard/text.ts +210 -0
  476. package/src/generative-ui/standard/theme.ts +198 -0
  477. package/src/generative-ui/standard/tokens.ts +317 -0
  478. package/src/generative-ui/standard/url.ts +51 -0
  479. package/src/generative-ui/thrown.ts +90 -0
  480. package/src/generative-ui/types.ts +23 -7
  481. package/src/generative-ui/validate-operation.ts +2 -2
  482. package/src/index.ts +9 -17
  483. package/src/standard-schema.ts +24 -27
  484. package/src/telemetry/lambda-client.ts +8 -3
  485. package/src/telemetry/model-host.test.ts +2 -5
  486. package/src/telemetry/telemetry-disabled.ts +0 -5
  487. package/src/types/message.ts +1 -19
  488. package/src/utils/__tests__/errors.test.ts +44 -0
  489. package/src/utils/__tests__/json-schema.test.ts +3 -479
  490. package/src/utils/__tests__/random-id.test.ts +37 -0
  491. package/src/utils/errors.ts +28 -85
  492. package/src/utils/index.ts +0 -2
  493. package/src/utils/inspector-visibility.test.ts +26 -0
  494. package/src/utils/inspector-visibility.ts +35 -3
  495. package/src/utils/json-schema.ts +5 -152
  496. package/src/utils/random-id.ts +17 -37
  497. package/src/utils/types.ts +4 -11
  498. package/tsconfig.json +3 -1
  499. package/tsdown.config.ts +2 -19
  500. package/dist/event-transforms/index.cjs +0 -15
  501. package/dist/event-transforms/index.d.cts +0 -4
  502. package/dist/event-transforms/index.d.mts +0 -4
  503. package/dist/event-transforms/index.mjs +0 -5
  504. package/dist/event-transforms/open-generative-ui-middleware.cjs +0 -286
  505. package/dist/event-transforms/open-generative-ui-middleware.cjs.map +0 -1
  506. package/dist/event-transforms/open-generative-ui-middleware.d.cts +0 -60
  507. package/dist/event-transforms/open-generative-ui-middleware.d.cts.map +0 -1
  508. package/dist/event-transforms/open-generative-ui-middleware.d.mts +0 -60
  509. package/dist/event-transforms/open-generative-ui-middleware.d.mts.map +0 -1
  510. package/dist/event-transforms/open-generative-ui-middleware.mjs +0 -283
  511. package/dist/event-transforms/open-generative-ui-middleware.mjs.map +0 -1
  512. package/dist/event-transforms/recorded-events.cjs +0 -59
  513. package/dist/event-transforms/recorded-events.cjs.map +0 -1
  514. package/dist/event-transforms/recorded-events.d.cts +0 -23
  515. package/dist/event-transforms/recorded-events.d.cts.map +0 -1
  516. package/dist/event-transforms/recorded-events.d.mts +0 -23
  517. package/dist/event-transforms/recorded-events.d.mts.map +0 -1
  518. package/dist/event-transforms/recorded-events.mjs +0 -58
  519. package/dist/event-transforms/recorded-events.mjs.map +0 -1
  520. package/dist/telemetry/events.d.cts +0 -72
  521. package/dist/telemetry/events.d.cts.map +0 -1
  522. package/dist/telemetry/events.d.mts +0 -72
  523. package/dist/telemetry/events.d.mts.map +0 -1
  524. package/dist/telemetry/index.cjs +0 -18
  525. package/dist/telemetry/index.d.cts +0 -5
  526. package/dist/telemetry/index.d.mts +0 -5
  527. package/dist/telemetry/index.mjs +0 -6
  528. package/dist/telemetry/telemetry-client.cjs +0 -165
  529. package/dist/telemetry/telemetry-client.cjs.map +0 -1
  530. package/dist/telemetry/telemetry-client.d.cts +0 -87
  531. package/dist/telemetry/telemetry-client.d.cts.map +0 -1
  532. package/dist/telemetry/telemetry-client.d.mts +0 -87
  533. package/dist/telemetry/telemetry-client.d.mts.map +0 -1
  534. package/dist/telemetry/telemetry-client.mjs +0 -164
  535. package/dist/telemetry/telemetry-client.mjs.map +0 -1
  536. package/dist/telemetry/utils.cjs +0 -14
  537. package/dist/telemetry/utils.cjs.map +0 -1
  538. package/dist/telemetry/utils.mjs +0 -13
  539. package/dist/telemetry/utils.mjs.map +0 -1
  540. package/dist/utils/conditions.cjs +0 -32
  541. package/dist/utils/conditions.cjs.map +0 -1
  542. package/dist/utils/conditions.d.cts +0 -31
  543. package/dist/utils/conditions.d.cts.map +0 -1
  544. package/dist/utils/conditions.d.mts +0 -31
  545. package/dist/utils/conditions.d.mts.map +0 -1
  546. package/dist/utils/conditions.mjs +0 -31
  547. package/dist/utils/conditions.mjs.map +0 -1
  548. package/dist/utils/console-styling.cjs +0 -91
  549. package/dist/utils/console-styling.cjs.map +0 -1
  550. package/dist/utils/console-styling.d.cts +0 -65
  551. package/dist/utils/console-styling.d.cts.map +0 -1
  552. package/dist/utils/console-styling.d.mts +0 -65
  553. package/dist/utils/console-styling.d.mts.map +0 -1
  554. package/dist/utils/console-styling.mjs +0 -85
  555. package/dist/utils/console-styling.mjs.map +0 -1
  556. package/src/__tests__/zod-regression.test.ts +0 -319
  557. package/src/event-transforms/index.ts +0 -5
  558. package/src/event-transforms/open-generative-ui-middleware.ts +0 -392
  559. package/src/event-transforms/recorded-events.test.ts +0 -166
  560. package/src/event-transforms/recorded-events.ts +0 -74
  561. package/src/telemetry/events.ts +0 -68
  562. package/src/telemetry/index.ts +0 -9
  563. package/src/telemetry/telemetry-blank-license-identity.test.ts +0 -128
  564. package/src/telemetry/telemetry-client.test.ts +0 -798
  565. package/src/telemetry/telemetry-client.ts +0 -328
  566. package/src/telemetry/utils.ts +0 -15
  567. package/src/utils/__tests__/conditions.test.ts +0 -161
  568. package/src/utils/conditions.ts +0 -116
  569. package/src/utils/console-styling.ts +0 -126
@@ -0,0 +1,480 @@
1
+ import { afterEach, beforeEach, describe, expect, it } from "vitest";
2
+ import { cloneValue } from "../clone-value";
3
+
4
+ // The local copy of cloneValue runs where there is no global
5
+ // structuredClone (Hermes). It must give what the native structuredClone
6
+ // gives: the same value, or the same DataCloneError. This test runs every
7
+ // input of one table through both and compares the results. Each case that
8
+ // differs must be in KNOWN_DIVERGENCES, with the reason it cannot match.
9
+
10
+ type Outcome =
11
+ | { kind: "value"; fingerprint: unknown }
12
+ | { kind: "throws"; name: string; errorClass: string };
13
+
14
+ /** Everything structuredClone keeps, as plain data that toEqual compares. */
15
+ function fingerprint(
16
+ value: unknown,
17
+ seen = new Map<object, number>(),
18
+ ): unknown {
19
+ if (typeof value === "number") {
20
+ return Object.is(value, -0) ? "number:-0" : `number:${value}`;
21
+ }
22
+ if (typeof value === "bigint") return `bigint:${value}`;
23
+ if (typeof value !== "object" || value === null) {
24
+ return `${typeof value}:${String(value)}`;
25
+ }
26
+ const ref = seen.get(value);
27
+ if (ref !== undefined) return `ref:${ref}`;
28
+ seen.set(value, seen.size);
29
+ const proto = Object.getPrototypeOf(value) as {
30
+ constructor?: { name?: string };
31
+ } | null;
32
+ const result: Record<string, unknown> = {
33
+ tag: Object.prototype.toString.call(value),
34
+ proto: proto === null ? "null" : (proto.constructor?.name ?? "?"),
35
+ };
36
+ const own = (key: string) => Object.prototype.hasOwnProperty.call(value, key);
37
+ if (value instanceof Error) {
38
+ const error = value as Error & { cause?: unknown; code?: unknown };
39
+ result.name = error.name;
40
+ result.message = error.message;
41
+ result.ownMessage = own("message");
42
+ result.ownCause = own("cause");
43
+ if (own("cause")) result.cause = fingerprint(error.cause, seen);
44
+ result.stack = error.stack;
45
+ if (typeof DOMException === "function" && value instanceof DOMException) {
46
+ result.code = error.code;
47
+ }
48
+ }
49
+ if (value instanceof Date) result.time = value.getTime();
50
+ if (value instanceof RegExp) {
51
+ result.source = value.source;
52
+ result.flags = value.flags;
53
+ result.lastIndex = value.lastIndex;
54
+ }
55
+ if (value instanceof Map) {
56
+ result.entries = [...value].map(([k, v]) => [
57
+ fingerprint(k, seen),
58
+ fingerprint(v, seen),
59
+ ]);
60
+ }
61
+ if (value instanceof Set) {
62
+ result.entries = [...value].map((v) => fingerprint(v, seen));
63
+ }
64
+ if (value instanceof ArrayBuffer) {
65
+ result.bytes = [...new Uint8Array(value)];
66
+ const resizable = value as ArrayBuffer & {
67
+ resizable?: boolean;
68
+ maxByteLength?: number;
69
+ };
70
+ result.resizable = resizable.resizable;
71
+ result.maxByteLength = resizable.maxByteLength;
72
+ }
73
+ if (ArrayBuffer.isView(value)) {
74
+ result.byteOffset = value.byteOffset;
75
+ result.byteLength = value.byteLength;
76
+ result.buffer = fingerprint(value.buffer, seen);
77
+ }
78
+ if (typeof Blob === "function" && value instanceof Blob) {
79
+ result.size = value.size;
80
+ result.type = value.type;
81
+ if (typeof File === "function" && value instanceof File) {
82
+ result.fileName = value.name;
83
+ result.lastModified = value.lastModified;
84
+ }
85
+ }
86
+ for (const Boxed of [Number, String, Boolean, BigInt] as const) {
87
+ try {
88
+ const primitive = (
89
+ Boxed.prototype.valueOf as (this: unknown) => unknown
90
+ ).call(value);
91
+ result.boxed = fingerprint(primitive, seen);
92
+ } catch {
93
+ // Not this kind of boxed primitive.
94
+ }
95
+ }
96
+ if (Array.isArray(value)) {
97
+ result.length = value.length;
98
+ result.holes = value
99
+ .map((_entry, index) => index)
100
+ .filter((index) => !(index in value)).length;
101
+ }
102
+ const keys = Object.keys(value).filter(
103
+ // A boxed String has its indices as keys; they are its characters.
104
+ (key) => !(result.boxed !== undefined && /^\d+$/.test(key)),
105
+ );
106
+ result.keys = Object.fromEntries(
107
+ keys.map((key) => [
108
+ key,
109
+ fingerprint((value as Record<string, unknown>)[key], seen),
110
+ ]),
111
+ );
112
+ return result;
113
+ }
114
+
115
+ function outcome(run: () => unknown): Outcome {
116
+ try {
117
+ return { kind: "value", fingerprint: fingerprint(run()) };
118
+ } catch (error) {
119
+ const named = error as { name?: string; constructor?: { name?: string } };
120
+ return {
121
+ kind: "throws",
122
+ name: String(named.name),
123
+ errorClass: named.constructor?.name ?? "?",
124
+ };
125
+ }
126
+ }
127
+
128
+ const sab =
129
+ typeof SharedArrayBuffer === "function"
130
+ ? new SharedArrayBuffer(4)
131
+ : undefined;
132
+
133
+ /** Each entry gives a fresh input, so a case cannot see another's copy. */
134
+ const CORPUS: Record<string, () => unknown> = {
135
+ "plain JSON": () => ({ a: [1, { b: "x" }], c: null, d: true }),
136
+ "nested undefined": () => ({ a: undefined, b: [undefined] }),
137
+ "-0, NaN, Infinity": () => [-0, Number.NaN, -Infinity],
138
+ bigint: () => ({ n: BigInt(12) }),
139
+ "trailing hole": () => {
140
+ // eslint-disable-next-line no-sparse-arrays
141
+ return [1, ,];
142
+ },
143
+ "middle hole": () => {
144
+ // eslint-disable-next-line no-sparse-arrays
145
+ return [1, , 3];
146
+ },
147
+ "array with an own non-index key": () =>
148
+ Object.assign([1, 2], { extra: "x" }),
149
+ "own __proto__ key (JSON.parse)": () =>
150
+ JSON.parse('{"__proto__":{"polluted":1},"a":1}'),
151
+ "null prototype": () => Object.assign(Object.create(null), { a: 1 }),
152
+ "class instance": () => {
153
+ class Point {
154
+ x = 1;
155
+ y = 2;
156
+ }
157
+ return new Point();
158
+ },
159
+ "own Symbol.toStringTag": () => ({ a: 1, [Symbol.toStringTag]: "Custom" }),
160
+ "class with a toStringTag getter": () => {
161
+ class Money {
162
+ amount = 3;
163
+ get [Symbol.toStringTag]() {
164
+ return "Money";
165
+ }
166
+ }
167
+ return new Money();
168
+ },
169
+ 'toStringTag "String" (spoofed boxed string)': () => ({
170
+ a: 1,
171
+ [Symbol.toStringTag]: "String",
172
+ }),
173
+ 'toStringTag "Arguments"': () => ({
174
+ a: 1,
175
+ [Symbol.toStringTag]: "Arguments",
176
+ }),
177
+ 'toStringTag "Error"': () => ({ a: 1, [Symbol.toStringTag]: "Error" }),
178
+ "Object.create(Date.prototype)": () => Object.create(Date.prototype),
179
+ "Object.create(Map.prototype)": () => Object.create(Map.prototype),
180
+ "Object.create(Error.prototype)": () => Object.create(Error.prototype),
181
+ "Map with Object.prototype": () =>
182
+ Object.setPrototypeOf(new Map([["a", 1]]), Object.prototype),
183
+ "Set with a null prototype": () => Object.setPrototypeOf(new Set([1]), null),
184
+ "Date with Object.prototype": () =>
185
+ Object.setPrototypeOf(new Date(7), Object.prototype),
186
+ "Error with Object.prototype": () =>
187
+ Object.setPrototypeOf(new Error("x"), Object.prototype),
188
+ "symbol keys and non-enumerable keys": () =>
189
+ Object.defineProperty({ [Symbol("k")]: 1, a: 1 }, "hidden", {
190
+ value: 2,
191
+ enumerable: false,
192
+ }),
193
+ "shared reference": () => {
194
+ const shared = { n: 1 };
195
+ return { a: shared, b: shared };
196
+ },
197
+ cycle: () => {
198
+ const value: Record<string, unknown> = { n: 1 };
199
+ value.self = value;
200
+ return value;
201
+ },
202
+ Date: () => new Date(86_400_000),
203
+ "Date with an extra key": () => Object.assign(new Date(0), { extra: 1 }),
204
+ "RegExp with lastIndex": () => {
205
+ const pattern = /a+/gi;
206
+ pattern.lastIndex = 2;
207
+ return pattern;
208
+ },
209
+ "Map with object keys": () => {
210
+ const key = { k: 1 };
211
+ return new Map<unknown, unknown>([
212
+ [key, key],
213
+ ["s", new Set([1])],
214
+ ]);
215
+ },
216
+ "Set with a cycle": () => {
217
+ const set = new Set<unknown>();
218
+ set.add(set);
219
+ return set;
220
+ },
221
+ "Map with an extra key": () => Object.assign(new Map(), { extra: 1 }),
222
+ "boxed Number": () => new Number(3),
223
+ "boxed String": () => new String("ab"),
224
+ "boxed Boolean": () => new Boolean(false),
225
+ "boxed BigInt": () => Object(BigInt(5)),
226
+ "boxed Symbol": () => Object(Symbol("s")),
227
+ Error: () => new Error("boom"),
228
+ "Error without a message": () => new Error(),
229
+ "Error with a cause": () => new Error("boom", { cause: { reason: "x" } }),
230
+ "Error with an undefined cause": () =>
231
+ new Error("boom", { cause: undefined }),
232
+ "Error with an assigned cause": () =>
233
+ Object.assign(new Error("boom"), { cause: 5 }),
234
+ "Error whose cause is itself": () => {
235
+ const error = new Error("self");
236
+ (error as { cause?: unknown }).cause = error;
237
+ return error;
238
+ },
239
+ "Error with an accessor cause": () =>
240
+ Object.defineProperty(new Error("boom"), "cause", { get: () => 1 }),
241
+ "Error with an accessor message": () =>
242
+ Object.defineProperty(new Error("boom"), "message", { get: () => "g" }),
243
+ "Error with a numeric message": () =>
244
+ Object.assign(new Error("boom"), { message: 42 }),
245
+ "Error with a custom name": () =>
246
+ Object.assign(new TypeError("t"), { name: "Custom" }),
247
+ "Error with extra keys": () => Object.assign(new Error("x"), { code: 7 }),
248
+ "Error with a set stack": () =>
249
+ Object.assign(new Error("x"), { stack: "STACK" }),
250
+ "RangeError subclass": () => {
251
+ class MyError extends RangeError {}
252
+ return new MyError("x");
253
+ },
254
+ AggregateError: () => new AggregateError([1], "agg"),
255
+ DOMException: () => new DOMException("d", "AbortError"),
256
+ "DOMException with a custom name": () => new DOMException("m", "Whatever"),
257
+ ArrayBuffer: () => new Uint8Array([1, 2, 3]).buffer,
258
+ "resizable ArrayBuffer": () =>
259
+ new ArrayBuffer(4, { maxByteLength: 16 } as never),
260
+ Uint8Array: () => new Uint8Array([1, 2]),
261
+ "typed subarray (byteOffset 1)": () =>
262
+ new Uint8Array([1, 2, 3, 4]).subarray(1, 3),
263
+ "typed array subclass": () => {
264
+ class Bytes extends Uint8Array {}
265
+ return new Bytes([1, 2]);
266
+ },
267
+ BigInt64Array: () => new BigInt64Array([BigInt(1)]),
268
+ DataView: () => new DataView(new ArrayBuffer(8), 2, 4),
269
+ "two views on one buffer": () => {
270
+ const buffer = new ArrayBuffer(8);
271
+ return [new Uint8Array(buffer, 1, 2), new DataView(buffer)];
272
+ },
273
+ arguments: function () {
274
+ // eslint-disable-next-line prefer-rest-params
275
+ return (function (..._args: unknown[]) {
276
+ // eslint-disable-next-line prefer-rest-params
277
+ return arguments;
278
+ })(1, 2);
279
+ },
280
+ "Proxy of an object": () => new Proxy({ a: 1 }, {}),
281
+ "Proxy of an array": () => new Proxy([1], {}),
282
+ function: () => ({ run: () => 1 }),
283
+ symbol: () => Symbol("s"),
284
+ WeakMap: () => new WeakMap(),
285
+ WeakSet: () => new WeakSet(),
286
+ WeakRef: () => new WeakRef({}),
287
+ Promise: () => Promise.resolve(1),
288
+ "Map iterator": () => new Map([[1, 2]]).entries(),
289
+ generator: () =>
290
+ (function* () {
291
+ yield 1;
292
+ })(),
293
+ URL: () => new URL("https://example.com/a"),
294
+ URLSearchParams: () => new URLSearchParams("a=1"),
295
+ Headers: () => new Headers(),
296
+ Blob: () => new Blob(["x"], { type: "text/plain" }),
297
+ File: () => new File(["x"], "f.txt", { lastModified: 1 }),
298
+ "getter that throws": () => ({
299
+ get a(): never {
300
+ throw new TypeError("boom");
301
+ },
302
+ }),
303
+ ...(sab ? { SharedArrayBuffer: () => sab } : {}),
304
+ };
305
+
306
+ /**
307
+ * The inputs the local copy cannot clone the native way, and why. A case
308
+ * here must still differ: when it starts to match, remove it.
309
+ */
310
+ /**
311
+ * The native structuredClone is only a valid oracle where it follows the
312
+ * current serialization rules. Node 20's clones URL, Headers and
313
+ * DOMException into plain objects, mishandles an Error whose cause is
314
+ * itself, and so on; there the comparison is skipped (the unit tests in
315
+ * clone-value.test.ts still check cloneValue on every version).
316
+ */
317
+ const NODE_MAJOR =
318
+ typeof process !== "undefined" && process.versions?.node
319
+ ? Number(process.versions.node.split(".")[0])
320
+ : Infinity;
321
+ const NATIVE_IS_ORACLE = NODE_MAJOR >= 22;
322
+
323
+ /**
324
+ * Node 22's structuredClone turns a File into a plain Blob (name and
325
+ * lastModified are lost); browsers and Node 24 keep a File, as the HTML
326
+ * serialization spec requires. The local copy follows the spec, so on a
327
+ * runtime that drops File the comparison is skipped and the spec behaviour
328
+ * is checked on its own below.
329
+ */
330
+ const NATIVE_KEEPS_FILE =
331
+ typeof File !== "function" ||
332
+ structuredClone(new File(["x"], "f.txt")) instanceof File;
333
+
334
+ const KNOWN_DIVERGENCES: Record<string, string> = {
335
+ "Proxy of an object":
336
+ "No JavaScript-visible way tells a Proxy from its target; native V8 rejects it, the local copy reads it through its traps.",
337
+ "Proxy of an array":
338
+ "Same as a Proxy of an object: Array.isArray sees through the Proxy.",
339
+ "Map with Object.prototype":
340
+ "The plain-object fast path runs no brand check (each failed one throws, slow on Hermes), and only a brand check finds the Map slot once the prototype is Object.prototype: native V8 copies a Map, the local copy a plain object.",
341
+ "Set with a null prototype":
342
+ "Same as a Map with Object.prototype: the fast path cannot see the Set slot.",
343
+ ...(NATIVE_KEEPS_FILE
344
+ ? {}
345
+ : {
346
+ File: "This runtime's structuredClone returns a Blob for a File (Node 22); the local copy keeps the File, as the spec and browsers do.",
347
+ }),
348
+ };
349
+
350
+ function withoutGlobal<T>(name: string, run: () => T): T {
351
+ const saved = Object.getOwnPropertyDescriptor(globalThis, name);
352
+ delete (globalThis as Record<string, unknown>)[name];
353
+ try {
354
+ return run();
355
+ } finally {
356
+ if (saved) Object.defineProperty(globalThis, name, saved);
357
+ }
358
+ }
359
+
360
+ // Both run on the same input, so an Error has the same stack in both.
361
+ const local = (input: unknown) =>
362
+ outcome(() => withoutGlobal("structuredClone", () => cloneValue(input)));
363
+ const native = (input: unknown) => outcome(() => structuredClone(input));
364
+
365
+ describe("cloneValue without a global structuredClone, against the native one", () => {
366
+ it("runs the local copy only when the global is gone", () => {
367
+ withoutGlobal("structuredClone", () => {
368
+ expect(typeof globalThis.structuredClone).toBe("undefined");
369
+ });
370
+ expect(typeof globalThis.structuredClone).toBe("function");
371
+ });
372
+
373
+ it("uses the global structuredClone when there is one", () => {
374
+ const saved = Object.getOwnPropertyDescriptor(
375
+ globalThis,
376
+ "structuredClone",
377
+ )!;
378
+ const calls: unknown[] = [];
379
+ Object.defineProperty(globalThis, "structuredClone", {
380
+ ...saved,
381
+ value: (value: unknown) => {
382
+ calls.push(value);
383
+ return saved.value(value);
384
+ },
385
+ });
386
+ try {
387
+ const input = { a: 1 };
388
+ expect(cloneValue(input)).toEqual(input);
389
+ expect(calls).toEqual([input]);
390
+ } finally {
391
+ Object.defineProperty(globalThis, "structuredClone", saved);
392
+ }
393
+ });
394
+
395
+ it.runIf(typeof File === "function")(
396
+ "keeps a File a File, with its name and lastModified",
397
+ () => {
398
+ const copy = withoutGlobal("structuredClone", () =>
399
+ cloneValue(new File(["x"], "f.txt", { lastModified: 1 })),
400
+ );
401
+ expect(copy).toBeInstanceOf(File);
402
+ expect((copy as File).name).toBe("f.txt");
403
+ expect((copy as File).lastModified).toBe(1);
404
+ },
405
+ );
406
+
407
+ it
408
+ .runIf(NATIVE_IS_ORACLE)
409
+ .each(Object.keys(CORPUS).filter((name) => !(name in KNOWN_DIVERGENCES)))(
410
+ "%s: gives what structuredClone gives",
411
+ (name) => {
412
+ const input = CORPUS[name]!();
413
+ expect(local(input)).toEqual(native(input));
414
+ },
415
+ );
416
+
417
+ it.runIf(NATIVE_IS_ORACLE).each(Object.keys(KNOWN_DIVERGENCES))(
418
+ "%s: still differs (else drop it from KNOWN_DIVERGENCES)",
419
+ (name) => {
420
+ const input = CORPUS[name]!();
421
+ expect(local(input)).not.toEqual(native(input));
422
+ },
423
+ );
424
+
425
+ it("never returns an object of the input, except a SharedArrayBuffer", () => {
426
+ for (const [name, make] of Object.entries(CORPUS)) {
427
+ if (name === "SharedArrayBuffer" || name in KNOWN_DIVERGENCES) continue;
428
+ const input = make();
429
+ if (typeof input !== "object" || input === null) continue;
430
+ let copy: unknown;
431
+ try {
432
+ copy = withoutGlobal("structuredClone", () => cloneValue(input));
433
+ } catch {
434
+ continue;
435
+ }
436
+ expect(copy, name).not.toBe(input);
437
+ }
438
+ });
439
+ });
440
+
441
+ describe("cloneValue on Hermes globals (no structuredClone, no DOMException)", () => {
442
+ let saved: Record<string, PropertyDescriptor | undefined>;
443
+
444
+ beforeEach(() => {
445
+ saved = {};
446
+ for (const name of ["structuredClone", "DOMException"]) {
447
+ saved[name] = Object.getOwnPropertyDescriptor(globalThis, name);
448
+ delete (globalThis as Record<string, unknown>)[name];
449
+ }
450
+ });
451
+
452
+ afterEach(() => {
453
+ for (const [name, descriptor] of Object.entries(saved)) {
454
+ if (descriptor) Object.defineProperty(globalThis, name, descriptor);
455
+ }
456
+ });
457
+
458
+ it("throws an Error named DataCloneError", () => {
459
+ expect(typeof globalThis.DOMException).toBe("undefined");
460
+ let thrown: unknown;
461
+ try {
462
+ cloneValue({ run: () => 1 });
463
+ } catch (error) {
464
+ thrown = error;
465
+ }
466
+ expect(thrown).toBeInstanceOf(Error);
467
+ expect((thrown as Error).name).toBe("DataCloneError");
468
+ expect((thrown as Error).message).toMatch(/could not be cloned/);
469
+ });
470
+
471
+ it("copies an Error with its cause", () => {
472
+ const copy = cloneValue(new TypeError("t", { cause: { n: 1 } }));
473
+ expect(copy).toBeInstanceOf(TypeError);
474
+ expect(copy.message).toBe("t");
475
+ expect(copy.cause).toEqual({ n: 1 });
476
+ expect(Object.getOwnPropertyDescriptor(copy, "cause")?.enumerable).toBe(
477
+ false,
478
+ );
479
+ });
480
+ });
@@ -0,0 +1,226 @@
1
+ import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
2
+ import { cloneValue } from "../clone-value";
3
+
4
+ // The local deep clone runs only when there is no global structuredClone
5
+ // (Hermes). Each case runs in both modes against the same expectations;
6
+ // clone-value-differential.test.ts compares the two modes with each other.
7
+ const modes = [
8
+ ["without a global structuredClone", false],
9
+ ["with the global structuredClone", true],
10
+ ] as const;
11
+
12
+ describe.each(modes)("cloneValue %s", (_name, withGlobal) => {
13
+ let saved: PropertyDescriptor | undefined;
14
+
15
+ beforeEach(() => {
16
+ saved = Object.getOwnPropertyDescriptor(globalThis, "structuredClone");
17
+ if (!withGlobal) {
18
+ delete (globalThis as { structuredClone?: unknown }).structuredClone;
19
+ }
20
+ });
21
+
22
+ afterEach(() => {
23
+ if (saved) Object.defineProperty(globalThis, "structuredClone", saved);
24
+ });
25
+
26
+ it("runs in the mode it says", () => {
27
+ expect(typeof globalThis.structuredClone).toBe(
28
+ withGlobal ? "function" : "undefined",
29
+ );
30
+ });
31
+
32
+ it("keeps undefined, null and primitives", () => {
33
+ expect(cloneValue(undefined)).toBeUndefined();
34
+ expect(cloneValue(null)).toBeNull();
35
+ expect(cloneValue("s")).toBe("s");
36
+ expect(cloneValue(true)).toBe(true);
37
+ expect(cloneValue(Number.NaN)).toBeNaN();
38
+ expect(cloneValue(Number.POSITIVE_INFINITY)).toBe(Infinity);
39
+ expect(cloneValue(Number.NEGATIVE_INFINITY)).toBe(-Infinity);
40
+ expect(Object.is(cloneValue(-0), -0)).toBe(true);
41
+ expect(cloneValue(BigInt(42))).toBe(BigInt(42));
42
+ });
43
+
44
+ it("deep-copies plain objects and arrays", () => {
45
+ const value = { a: [1, { b: 2 }], c: { d: undefined, e: null } };
46
+ const copy = cloneValue(value);
47
+ expect(copy).toEqual(value);
48
+ expect(copy).not.toBe(value);
49
+ expect(copy.a).not.toBe(value.a);
50
+ expect(copy.a[1]).not.toBe(value.a[1]);
51
+ expect(copy.c).not.toBe(value.c);
52
+ expect("d" in copy.c).toBe(true);
53
+ // A sparse array keeps its length and its hole.
54
+ // eslint-disable-next-line no-sparse-arrays
55
+ const sparse = cloneValue([1, , 3]);
56
+ expect(sparse).toHaveLength(3);
57
+ expect(1 in sparse).toBe(false);
58
+ });
59
+
60
+ it("drops the prototype of a class instance, like structuredClone", () => {
61
+ class Point {
62
+ constructor(
63
+ public x: number,
64
+ public y: number,
65
+ ) {}
66
+ }
67
+ const copy = cloneValue(new Point(1, 2));
68
+ expect(Object.getPrototypeOf(copy)).toBe(Object.prototype);
69
+ expect(copy).toEqual({ x: 1, y: 2 });
70
+ });
71
+
72
+ it("copies Date, Map, Set, RegExp and boxed primitives", () => {
73
+ const date = new Date(1234);
74
+ const key = { k: 1 };
75
+ const map = new Map<unknown, unknown>([[key, { v: 1 }]]);
76
+ const set = new Set([{ s: 1 }]);
77
+ const regexp = /a+b/gi;
78
+ const copy = cloneValue({ date, map, set, regexp, boxed: Object("x") });
79
+ expect(copy.date).toBeInstanceOf(Date);
80
+ expect(copy.date).not.toBe(date);
81
+ expect(copy.date.getTime()).toBe(1234);
82
+ expect(copy.map).toBeInstanceOf(Map);
83
+ expect(copy.map).not.toBe(map);
84
+ const [[copiedKey, copiedValue]] = [...copy.map];
85
+ expect(copiedKey).toEqual(key);
86
+ expect(copiedKey).not.toBe(key);
87
+ expect(copiedValue).toEqual({ v: 1 });
88
+ expect(copy.set).toBeInstanceOf(Set);
89
+ expect([...copy.set][0]).toEqual({ s: 1 });
90
+ expect([...copy.set][0]).not.toBe([...set][0]);
91
+ expect(copy.regexp).toBeInstanceOf(RegExp);
92
+ expect(copy.regexp).not.toBe(regexp);
93
+ expect(copy.regexp.source).toBe("a+b");
94
+ expect(copy.regexp.flags).toBe("gi");
95
+ expect(copy.boxed).toBeInstanceOf(String);
96
+ expect(String(copy.boxed)).toBe("x");
97
+ });
98
+
99
+ it("copies typed arrays and their buffer", () => {
100
+ const bytes = new Uint8Array([1, 2, 3]);
101
+ const copy = cloneValue(bytes);
102
+ expect(copy).toBeInstanceOf(Uint8Array);
103
+ expect(copy.buffer).not.toBe(bytes.buffer);
104
+ expect([...copy]).toEqual([1, 2, 3]);
105
+ });
106
+
107
+ it("copies an Error with its name and message", () => {
108
+ const copy = cloneValue(new TypeError("bad"));
109
+ expect(copy).toBeInstanceOf(TypeError);
110
+ expect(copy.name).toBe("TypeError");
111
+ expect(copy.message).toBe("bad");
112
+ });
113
+
114
+ it("keeps cycles and shared references", () => {
115
+ type Node = { name: string; self?: Node; peer?: object; list?: object[] };
116
+ const shared = { s: 1 };
117
+ const value: Node = { name: "n", peer: shared, list: [shared] };
118
+ value.self = value;
119
+ const copy = cloneValue(value);
120
+ expect(copy).not.toBe(value);
121
+ expect(copy.self).toBe(copy);
122
+ expect(copy.peer).not.toBe(shared);
123
+ expect(copy.list![0]).toBe(copy.peer);
124
+ const map = new Map<string, unknown>();
125
+ map.set("me", map);
126
+ const mapCopy = cloneValue(map);
127
+ expect(mapCopy.get("me")).toBe(mapCopy);
128
+ });
129
+
130
+ it("throws a DataCloneError for functions, symbols, WeakMap and Promise", () => {
131
+ for (const value of [
132
+ () => 1,
133
+ { nested: { fn: () => 1 } },
134
+ Symbol("s"),
135
+ [Symbol("s")],
136
+ new WeakMap(),
137
+ Promise.resolve(),
138
+ ]) {
139
+ expect(() => cloneValue(value)).toThrow(
140
+ expect.objectContaining({ name: "DataCloneError" }),
141
+ );
142
+ }
143
+ });
144
+ });
145
+
146
+ describe("cloneValue exports", () => {
147
+ it("is the same function on the package root and the generative UI entry", async () => {
148
+ const root = await import("../../index");
149
+ const entry = await import("../index");
150
+ expect(root.cloneValue).toBe(cloneValue);
151
+ expect(entry.cloneValue).toBe(cloneValue);
152
+ });
153
+ });
154
+
155
+ /**
156
+ * Spies on the first brand checks that a non-array object reaches. Each
157
+ * one that fails throws and catches an exception, slow on Hermes.
158
+ */
159
+ function spyOnBrandChecks() {
160
+ return [
161
+ vi.spyOn(Date.prototype, "getTime"),
162
+ vi.spyOn(Map.prototype, "has"),
163
+ vi.spyOn(Set.prototype, "has"),
164
+ ];
165
+ }
166
+ const calls = (spies: { mock: { calls: unknown[] } }[]) =>
167
+ spies.reduce((sum, spy) => sum + spy.mock.calls.length, 0);
168
+
169
+ describe("cloneValue without a global structuredClone, on plain data", () => {
170
+ let saved: PropertyDescriptor | undefined;
171
+
172
+ beforeEach(() => {
173
+ saved = Object.getOwnPropertyDescriptor(globalThis, "structuredClone");
174
+ delete (globalThis as { structuredClone?: unknown }).structuredClone;
175
+ });
176
+
177
+ afterEach(() => {
178
+ if (saved) Object.defineProperty(globalThis, "structuredClone", saved);
179
+ vi.restoreAllMocks();
180
+ });
181
+
182
+ it("runs no brand check, so throws no exception, for plain objects and arrays", () => {
183
+ // A streamed surface: a few hundred nested plain objects.
184
+ const tree = {
185
+ components: Array.from({ length: 300 }, (_, index) => ({
186
+ id: `c${index}`,
187
+ props: { label: { text: `Item ${index}` }, style: { gap: index } },
188
+ children: [{ ref: `c${index + 1}` }],
189
+ })),
190
+ meta: Object.assign(Object.create(null), { n: 1 }),
191
+ };
192
+ const spies = spyOnBrandChecks();
193
+ const copy = cloneValue(tree);
194
+ expect(calls(spies)).toBe(0);
195
+ expect(copy).toEqual(tree);
196
+ expect(copy.components[0]).not.toBe(tree.components[0]);
197
+ });
198
+
199
+ it("still runs the brand checks for other objects", () => {
200
+ class Point {
201
+ x = 1;
202
+ }
203
+ const spies = spyOnBrandChecks();
204
+ expect(cloneValue({ when: new Date(5), at: new Point() })).toEqual({
205
+ when: new Date(5),
206
+ at: { x: 1 },
207
+ });
208
+ expect(calls(spies)).toBeGreaterThan(0);
209
+ });
210
+
211
+ it("does not take the fast path for arguments, Errors or boxed values", () => {
212
+ const args = (function () {
213
+ // eslint-disable-next-line prefer-rest-params
214
+ return arguments;
215
+ })();
216
+ expect(() => cloneValue(args)).toThrow(
217
+ expect.objectContaining({ name: "DataCloneError" }),
218
+ );
219
+ const error = Object.setPrototypeOf(new Error("x"), Object.prototype);
220
+ expect(cloneValue(error)).toBeInstanceOf(Error);
221
+ const boxed = Object.setPrototypeOf(new Number(3), null);
222
+ expect(Number.prototype.valueOf.call(cloneValue(boxed))).toBe(3);
223
+ const view = Object.setPrototypeOf(new Uint8Array([1]), Object.prototype);
224
+ expect(cloneValue(view)).toBeInstanceOf(Uint8Array);
225
+ });
226
+ });