@xemahq/ui-kernel 0.9.0 → 0.9.2

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 (444) hide show
  1. package/README.md +2 -2
  2. package/dist/index.d.ts +1 -0
  3. package/dist/index.d.ts.map +1 -1
  4. package/dist/index.js +1 -0
  5. package/dist/index.js.map +1 -1
  6. package/dist/lib/biome-host/biome-builders.d.ts.map +1 -1
  7. package/dist/lib/biome-host/biome-builders.js +3 -1
  8. package/dist/lib/biome-host/biome-builders.js.map +1 -1
  9. package/dist/lib/biome-host/biome-registry.d.ts.map +1 -1
  10. package/dist/lib/biome-host/biome-registry.js +14 -9
  11. package/dist/lib/biome-host/biome-registry.js.map +1 -1
  12. package/dist/lib/biome-host/biome-scope-hooks.d.ts +11 -0
  13. package/dist/lib/biome-host/biome-scope-hooks.d.ts.map +1 -0
  14. package/dist/lib/biome-host/biome-scope-hooks.js +25 -0
  15. package/dist/lib/biome-host/biome-scope-hooks.js.map +1 -0
  16. package/dist/lib/biome-host/biome-scope.d.ts +1 -10
  17. package/dist/lib/biome-host/biome-scope.d.ts.map +1 -1
  18. package/dist/lib/biome-host/biome-scope.js +1 -24
  19. package/dist/lib/biome-host/biome-scope.js.map +1 -1
  20. package/dist/lib/biome-host/biome-scoped-query.d.ts +1 -1
  21. package/dist/lib/biome-host/biome-scoped-query.d.ts.map +1 -1
  22. package/dist/lib/biome-host/biome-scoped-query.js +1 -1
  23. package/dist/lib/biome-host/biome-scoped-query.js.map +1 -1
  24. package/dist/lib/biome-host/create-biome-orval-config.js +2 -2
  25. package/dist/lib/biome-host/create-biome-orval-config.js.map +1 -1
  26. package/dist/lib/biome-host/errors.js.map +1 -1
  27. package/dist/lib/biome-host/index.d.ts +1 -1
  28. package/dist/lib/biome-host/index.d.ts.map +1 -1
  29. package/dist/lib/biome-host/index.js +1 -1
  30. package/dist/lib/biome-host/index.js.map +1 -1
  31. package/dist/lib/biome-host/session-profiles.d.ts.map +1 -1
  32. package/dist/lib/biome-host/session-profiles.js +4 -1
  33. package/dist/lib/biome-host/session-profiles.js.map +1 -1
  34. package/dist/lib/capabilities/capability-context.d.ts +9 -0
  35. package/dist/lib/capabilities/capability-context.d.ts.map +1 -0
  36. package/dist/lib/capabilities/capability-context.js +13 -0
  37. package/dist/lib/capabilities/capability-context.js.map +1 -0
  38. package/dist/lib/capabilities/capability-provider.d.ts +2 -8
  39. package/dist/lib/capabilities/capability-provider.d.ts.map +1 -1
  40. package/dist/lib/capabilities/capability-provider.js +1 -12
  41. package/dist/lib/capabilities/capability-provider.js.map +1 -1
  42. package/dist/lib/capabilities/index.d.ts +1 -0
  43. package/dist/lib/capabilities/index.d.ts.map +1 -1
  44. package/dist/lib/capabilities/index.js +1 -0
  45. package/dist/lib/capabilities/index.js.map +1 -1
  46. package/dist/lib/capabilities/use-capability.d.ts.map +1 -1
  47. package/dist/lib/capabilities/use-capability.js +1 -1
  48. package/dist/lib/capabilities/use-capability.js.map +1 -1
  49. package/dist/lib/contribution-registry/contribution-registry.d.ts +24 -0
  50. package/dist/lib/contribution-registry/contribution-registry.d.ts.map +1 -0
  51. package/dist/lib/contribution-registry/contribution-registry.js +67 -0
  52. package/dist/lib/contribution-registry/contribution-registry.js.map +1 -0
  53. package/dist/lib/contribution-registry/index.d.ts +3 -0
  54. package/dist/lib/contribution-registry/index.d.ts.map +1 -0
  55. package/dist/lib/contribution-registry/index.js +3 -0
  56. package/dist/lib/contribution-registry/index.js.map +1 -0
  57. package/dist/lib/contribution-registry/renderable-registry.d.ts +33 -0
  58. package/dist/lib/contribution-registry/renderable-registry.d.ts.map +1 -0
  59. package/dist/lib/contribution-registry/renderable-registry.js +51 -0
  60. package/dist/lib/contribution-registry/renderable-registry.js.map +1 -0
  61. package/dist/lib/system-bus/deeplink.js.map +1 -1
  62. package/dist/lib/system-bus/host-ports.d.ts +2 -1
  63. package/dist/lib/system-bus/host-ports.d.ts.map +1 -1
  64. package/dist/lib/system-bus/intent-registry.d.ts.map +1 -1
  65. package/dist/lib/system-bus/intent-registry.js.map +1 -1
  66. package/dist/offline/index.d.ts +2 -1
  67. package/dist/offline/index.d.ts.map +1 -1
  68. package/dist/offline/index.js +2 -1
  69. package/dist/offline/index.js.map +1 -1
  70. package/dist/offline/offline-status-badge.js +1 -1
  71. package/dist/offline/offline-status-badge.js.map +1 -1
  72. package/dist/offline/outbox.js.map +1 -1
  73. package/dist/offline/react-hooks.d.ts +7 -0
  74. package/dist/offline/react-hooks.d.ts.map +1 -0
  75. package/dist/offline/react-hooks.js +25 -0
  76. package/dist/offline/react-hooks.js.map +1 -0
  77. package/dist/offline/react.d.ts +0 -4
  78. package/dist/offline/react.d.ts.map +1 -1
  79. package/dist/offline/react.js +2 -24
  80. package/dist/offline/react.js.map +1 -1
  81. package/dist/offline/storage.d.ts.map +1 -1
  82. package/dist/offline/storage.js +8 -5
  83. package/dist/offline/storage.js.map +1 -1
  84. package/dist/registry/index.d.ts +1 -0
  85. package/dist/registry/index.d.ts.map +1 -1
  86. package/dist/registry/index.js +1 -0
  87. package/dist/registry/index.js.map +1 -1
  88. package/dist/registry/lib/primitives/SessionEventCard.d.ts.map +1 -1
  89. package/dist/registry/lib/primitives/SessionEventCard.js +1 -1
  90. package/dist/registry/lib/primitives/SessionEventCard.js.map +1 -1
  91. package/dist/registry/lib/session-context-provider.d.ts +1 -3
  92. package/dist/registry/lib/session-context-provider.d.ts.map +1 -1
  93. package/dist/registry/lib/session-context-provider.js +2 -15
  94. package/dist/registry/lib/session-context-provider.js.map +1 -1
  95. package/dist/registry/lib/session-context.d.ts +5 -0
  96. package/dist/registry/lib/session-context.d.ts.map +1 -0
  97. package/dist/registry/lib/session-context.js +15 -0
  98. package/dist/registry/lib/session-context.js.map +1 -0
  99. package/dist/registry/lib/session-selectors.d.ts.map +1 -1
  100. package/dist/registry/lib/session-selectors.js +3 -1
  101. package/dist/registry/lib/session-selectors.js.map +1 -1
  102. package/dist/ui/branding/app-branding-context.d.ts +9 -0
  103. package/dist/ui/branding/app-branding-context.d.ts.map +1 -0
  104. package/dist/ui/branding/app-branding-context.js +10 -0
  105. package/dist/ui/branding/app-branding-context.js.map +1 -0
  106. package/dist/ui/branding/app-branding-provider.d.ts +0 -6
  107. package/dist/ui/branding/app-branding-provider.d.ts.map +1 -1
  108. package/dist/ui/branding/app-branding-provider.js +1 -8
  109. package/dist/ui/branding/app-branding-provider.js.map +1 -1
  110. package/dist/ui/capture/field-spec-to-zod.d.ts +1 -0
  111. package/dist/ui/capture/field-spec-to-zod.d.ts.map +1 -1
  112. package/dist/ui/capture/field-spec-to-zod.js +19 -0
  113. package/dist/ui/capture/field-spec-to-zod.js.map +1 -1
  114. package/dist/ui/capture/field-spec-validate.d.ts +4 -0
  115. package/dist/ui/capture/field-spec-validate.d.ts.map +1 -0
  116. package/dist/ui/capture/field-spec-validate.js +129 -0
  117. package/dist/ui/capture/field-spec-validate.js.map +1 -0
  118. package/dist/ui/capture/field-spec.d.ts +13 -1
  119. package/dist/ui/capture/field-spec.d.ts.map +1 -1
  120. package/dist/ui/capture/field-spec.js +25 -0
  121. package/dist/ui/capture/field-spec.js.map +1 -1
  122. package/dist/ui/capture/index.d.ts +4 -2
  123. package/dist/ui/capture/index.d.ts.map +1 -1
  124. package/dist/ui/capture/index.js +4 -2
  125. package/dist/ui/capture/index.js.map +1 -1
  126. package/dist/ui/capture/schema-field-input.d.ts.map +1 -1
  127. package/dist/ui/capture/schema-field-input.js +40 -13
  128. package/dist/ui/capture/schema-field-input.js.map +1 -1
  129. package/dist/ui/capture/submit-values.d.ts +6 -0
  130. package/dist/ui/capture/submit-values.d.ts.map +1 -0
  131. package/dist/ui/capture/submit-values.js +28 -0
  132. package/dist/ui/capture/submit-values.js.map +1 -0
  133. package/dist/ui/capture/use-prefill.d.ts.map +1 -1
  134. package/dist/ui/capture/use-prefill.js +3 -1
  135. package/dist/ui/capture/use-prefill.js.map +1 -1
  136. package/dist/ui/capture/use-wizard.d.ts +1 -1
  137. package/dist/ui/capture/use-wizard.d.ts.map +1 -1
  138. package/dist/ui/capture/use-wizard.js +1 -1
  139. package/dist/ui/capture/use-wizard.js.map +1 -1
  140. package/dist/ui/capture/wizard.d.ts.map +1 -1
  141. package/dist/ui/capture/wizard.js.map +1 -1
  142. package/dist/ui/index.d.ts +6 -1
  143. package/dist/ui/index.d.ts.map +1 -1
  144. package/dist/ui/index.js +6 -1
  145. package/dist/ui/index.js.map +1 -1
  146. package/dist/ui/primitives/alert-dialog.js +1 -1
  147. package/dist/ui/primitives/alert-dialog.js.map +1 -1
  148. package/dist/ui/primitives/badge-variants.d.ts +4 -0
  149. package/dist/ui/primitives/badge-variants.d.ts.map +1 -0
  150. package/dist/ui/primitives/badge-variants.js +15 -0
  151. package/dist/ui/primitives/badge-variants.js.map +1 -0
  152. package/dist/ui/primitives/badge.d.ts +3 -5
  153. package/dist/ui/primitives/badge.d.ts.map +1 -1
  154. package/dist/ui/primitives/badge.js +2 -15
  155. package/dist/ui/primitives/badge.js.map +1 -1
  156. package/dist/ui/primitives/button-variants.d.ts +5 -0
  157. package/dist/ui/primitives/button-variants.d.ts.map +1 -0
  158. package/dist/ui/primitives/button-variants.js +24 -0
  159. package/dist/ui/primitives/button-variants.js.map +1 -0
  160. package/dist/ui/primitives/button.d.ts +3 -6
  161. package/dist/ui/primitives/button.d.ts.map +1 -1
  162. package/dist/ui/primitives/button.js +2 -24
  163. package/dist/ui/primitives/button.js.map +1 -1
  164. package/dist/ui/primitives/form-stepper.d.ts +1 -13
  165. package/dist/ui/primitives/form-stepper.d.ts.map +1 -1
  166. package/dist/ui/primitives/form-stepper.js +1 -6
  167. package/dist/ui/primitives/form-stepper.js.map +1 -1
  168. package/dist/ui/primitives/form-stepper.types.d.ts +14 -0
  169. package/dist/ui/primitives/form-stepper.types.d.ts.map +1 -0
  170. package/dist/ui/primitives/form-stepper.types.js +7 -0
  171. package/dist/ui/primitives/form-stepper.types.js.map +1 -0
  172. package/dist/ui/primitives/overflow-tabs.d.ts +5 -0
  173. package/dist/ui/primitives/overflow-tabs.d.ts.map +1 -1
  174. package/dist/ui/primitives/overflow-tabs.js +4 -4
  175. package/dist/ui/primitives/overflow-tabs.js.map +1 -1
  176. package/dist/ui/primitives/preview-device-frame.js +1 -1
  177. package/dist/ui/primitives/preview-device-frame.js.map +1 -1
  178. package/dist/ui/primitives/tag-multi-select.d.ts.map +1 -1
  179. package/dist/ui/primitives/tag-multi-select.js +1 -1
  180. package/dist/ui/primitives/tag-multi-select.js.map +1 -1
  181. package/dist/ui/primitives/url-preview-chrome.d.ts +8 -0
  182. package/dist/ui/primitives/url-preview-chrome.d.ts.map +1 -0
  183. package/dist/ui/primitives/url-preview-chrome.js +40 -0
  184. package/dist/ui/primitives/url-preview-chrome.js.map +1 -0
  185. package/dist/vista/GenericCatalogueSurface.d.ts +10 -0
  186. package/dist/vista/GenericCatalogueSurface.d.ts.map +1 -0
  187. package/dist/vista/GenericCatalogueSurface.js +80 -0
  188. package/dist/vista/GenericCatalogueSurface.js.map +1 -0
  189. package/dist/vista/SurfaceFallbackCard.d.ts +9 -0
  190. package/dist/vista/SurfaceFallbackCard.d.ts.map +1 -0
  191. package/dist/vista/SurfaceFallbackCard.js +44 -0
  192. package/dist/vista/SurfaceFallbackCard.js.map +1 -0
  193. package/dist/vista/VistaPanel.d.ts +21 -0
  194. package/dist/vista/VistaPanel.d.ts.map +1 -0
  195. package/dist/vista/VistaPanel.js +31 -0
  196. package/dist/vista/VistaPanel.js.map +1 -0
  197. package/dist/vista/html/CustomUiFrame.d.ts +20 -0
  198. package/dist/vista/html/CustomUiFrame.d.ts.map +1 -0
  199. package/dist/vista/html/CustomUiFrame.js +69 -0
  200. package/dist/vista/html/CustomUiFrame.js.map +1 -0
  201. package/dist/vista/html/custom-ui-frame-bridge.d.ts +13 -0
  202. package/dist/vista/html/custom-ui-frame-bridge.d.ts.map +1 -0
  203. package/dist/vista/html/custom-ui-frame-bridge.js +30 -0
  204. package/dist/vista/html/custom-ui-frame-bridge.js.map +1 -0
  205. package/dist/vista/html/custom-ui-frame-contract.d.ts +29 -0
  206. package/dist/vista/html/custom-ui-frame-contract.d.ts.map +1 -0
  207. package/dist/vista/html/custom-ui-frame-contract.js +16 -0
  208. package/dist/vista/html/custom-ui-frame-contract.js.map +1 -0
  209. package/dist/vista/html/custom-ui-intents.d.ts +20 -0
  210. package/dist/vista/html/custom-ui-intents.d.ts.map +1 -0
  211. package/dist/vista/html/custom-ui-intents.js +57 -0
  212. package/dist/vista/html/custom-ui-intents.js.map +1 -0
  213. package/dist/vista/html/custom-ui-srcdoc.d.ts +17 -0
  214. package/dist/vista/html/custom-ui-srcdoc.d.ts.map +1 -0
  215. package/dist/vista/html/custom-ui-srcdoc.js +70 -0
  216. package/dist/vista/html/custom-ui-srcdoc.js.map +1 -0
  217. package/dist/vista/html/index.d.ts +6 -0
  218. package/dist/vista/html/index.d.ts.map +1 -0
  219. package/dist/vista/html/index.js +6 -0
  220. package/dist/vista/html/index.js.map +1 -0
  221. package/dist/vista/index.d.ts +22 -0
  222. package/dist/vista/index.d.ts.map +1 -0
  223. package/dist/vista/index.js +22 -0
  224. package/dist/vista/index.js.map +1 -0
  225. package/dist/vista/surface-catalogue.d.ts +5 -0
  226. package/dist/vista/surface-catalogue.d.ts.map +1 -0
  227. package/dist/vista/surface-catalogue.js +30 -0
  228. package/dist/vista/surface-catalogue.js.map +1 -0
  229. package/dist/vista/surface-icons.d.ts +7 -0
  230. package/dist/vista/surface-icons.d.ts.map +1 -0
  231. package/dist/vista/surface-icons.js +26 -0
  232. package/dist/vista/surface-icons.js.map +1 -0
  233. package/dist/vista/surface-registry.d.ts +7 -0
  234. package/dist/vista/surface-registry.d.ts.map +1 -0
  235. package/dist/vista/surface-registry.js +7 -0
  236. package/dist/vista/surface-registry.js.map +1 -0
  237. package/dist/vista/surfaces/ChartSurface.d.ts +4 -0
  238. package/dist/vista/surfaces/ChartSurface.d.ts.map +1 -0
  239. package/dist/vista/surfaces/ChartSurface.js +17 -0
  240. package/dist/vista/surfaces/ChartSurface.js.map +1 -0
  241. package/dist/vista/surfaces/FilesSurface.d.ts +4 -0
  242. package/dist/vista/surfaces/FilesSurface.d.ts.map +1 -0
  243. package/dist/vista/surfaces/FilesSurface.js +77 -0
  244. package/dist/vista/surfaces/FilesSurface.js.map +1 -0
  245. package/dist/vista/surfaces/FormSurface.d.ts +4 -0
  246. package/dist/vista/surfaces/FormSurface.d.ts.map +1 -0
  247. package/dist/vista/surfaces/FormSurface.js +124 -0
  248. package/dist/vista/surfaces/FormSurface.js.map +1 -0
  249. package/dist/vista/surfaces/HtmlSurface.d.ts +4 -0
  250. package/dist/vista/surfaces/HtmlSurface.d.ts.map +1 -0
  251. package/dist/vista/surfaces/HtmlSurface.js +11 -0
  252. package/dist/vista/surfaces/HtmlSurface.js.map +1 -0
  253. package/dist/vista/surfaces/TableSurface.d.ts +4 -0
  254. package/dist/vista/surfaces/TableSurface.d.ts.map +1 -0
  255. package/dist/vista/surfaces/TableSurface.js +42 -0
  256. package/dist/vista/surfaces/TableSurface.js.map +1 -0
  257. package/dist/vista/surfaces/UrlSurface.d.ts +4 -0
  258. package/dist/vista/surfaces/UrlSurface.d.ts.map +1 -0
  259. package/dist/vista/surfaces/UrlSurface.js +7 -0
  260. package/dist/vista/surfaces/UrlSurface.js.map +1 -0
  261. package/dist/vista/surfaces/blob-surfaces.d.ts +6 -0
  262. package/dist/vista/surfaces/blob-surfaces.d.ts.map +1 -0
  263. package/dist/vista/surfaces/blob-surfaces.js +38 -0
  264. package/dist/vista/surfaces/blob-surfaces.js.map +1 -0
  265. package/dist/vista/surfaces/elicitation-transport.d.ts +27 -0
  266. package/dist/vista/surfaces/elicitation-transport.d.ts.map +1 -0
  267. package/dist/vista/surfaces/elicitation-transport.js +193 -0
  268. package/dist/vista/surfaces/elicitation-transport.js.map +1 -0
  269. package/dist/vista/surfaces/file-surface-utils.d.ts +13 -0
  270. package/dist/vista/surfaces/file-surface-utils.d.ts.map +1 -0
  271. package/dist/vista/surfaces/file-surface-utils.js +46 -0
  272. package/dist/vista/surfaces/file-surface-utils.js.map +1 -0
  273. package/dist/vista/surfaces/index.d.ts +12 -0
  274. package/dist/vista/surfaces/index.d.ts.map +1 -0
  275. package/dist/vista/surfaces/index.js +12 -0
  276. package/dist/vista/surfaces/index.js.map +1 -0
  277. package/dist/vista/surfaces/register-surfaces.d.ts +2 -0
  278. package/dist/vista/surfaces/register-surfaces.d.ts.map +1 -0
  279. package/dist/vista/surfaces/register-surfaces.js +80 -0
  280. package/dist/vista/surfaces/register-surfaces.js.map +1 -0
  281. package/dist/vista/surfaces/text-surfaces.d.ts +8 -0
  282. package/dist/vista/surfaces/text-surfaces.d.ts.map +1 -0
  283. package/dist/vista/surfaces/text-surfaces.js +54 -0
  284. package/dist/vista/surfaces/text-surfaces.js.map +1 -0
  285. package/dist/vista/use-vista-tabs.d.ts +30 -0
  286. package/dist/vista/use-vista-tabs.d.ts.map +1 -0
  287. package/dist/vista/use-vista-tabs.js +77 -0
  288. package/dist/vista/use-vista-tabs.js.map +1 -0
  289. package/dist/vista/vista-code-renderer-context.d.ts +9 -0
  290. package/dist/vista/vista-code-renderer-context.d.ts.map +1 -0
  291. package/dist/vista/vista-code-renderer-context.js +6 -0
  292. package/dist/vista/vista-code-renderer-context.js.map +1 -0
  293. package/dist/vista/vista-code-renderer.d.ts +7 -0
  294. package/dist/vista/vista-code-renderer.d.ts.map +1 -0
  295. package/dist/vista/vista-code-renderer.js +6 -0
  296. package/dist/vista/vista-code-renderer.js.map +1 -0
  297. package/dist/vista/vista-file-context.d.ts +8 -0
  298. package/dist/vista/vista-file-context.d.ts.map +1 -0
  299. package/dist/vista/vista-file-context.js +6 -0
  300. package/dist/vista/vista-file-context.js.map +1 -0
  301. package/dist/vista/vista-file-source.d.ts +15 -0
  302. package/dist/vista/vista-file-source.d.ts.map +1 -0
  303. package/dist/vista/vista-file-source.js +66 -0
  304. package/dist/vista/vista-file-source.js.map +1 -0
  305. package/dist/vista/vista-form-context.d.ts +13 -0
  306. package/dist/vista/vista-form-context.d.ts.map +1 -0
  307. package/dist/vista/vista-form-context.js +6 -0
  308. package/dist/vista/vista-form-context.js.map +1 -0
  309. package/dist/vista/vista-form-host.d.ts +7 -0
  310. package/dist/vista/vista-form-host.d.ts.map +1 -0
  311. package/dist/vista/vista-form-host.js +6 -0
  312. package/dist/vista/vista-form-host.js.map +1 -0
  313. package/dist/vista/vista-model.d.ts +12 -0
  314. package/dist/vista/vista-model.d.ts.map +1 -0
  315. package/dist/vista/vista-model.js +72 -0
  316. package/dist/vista/vista-model.js.map +1 -0
  317. package/dist/vista/vista-open-context.d.ts +7 -0
  318. package/dist/vista/vista-open-context.d.ts.map +1 -0
  319. package/dist/vista/vista-open-context.js +6 -0
  320. package/dist/vista/vista-open-context.js.map +1 -0
  321. package/dist/vista/vista-open-state.d.ts +5 -0
  322. package/dist/vista/vista-open-state.d.ts.map +1 -0
  323. package/dist/vista/vista-open-state.js +6 -0
  324. package/dist/vista/vista-open-state.js.map +1 -0
  325. package/dist/vista/vista-payloads.d.ts +106 -0
  326. package/dist/vista/vista-payloads.d.ts.map +1 -0
  327. package/dist/vista/vista-payloads.js +302 -0
  328. package/dist/vista/vista-payloads.js.map +1 -0
  329. package/dist/vista/vista-tabs-manifest.d.ts +17 -0
  330. package/dist/vista/vista-tabs-manifest.d.ts.map +1 -0
  331. package/dist/vista/vista-tabs-manifest.js +60 -0
  332. package/dist/vista/vista-tabs-manifest.js.map +1 -0
  333. package/dist/vista/vista-tools.d.ts +41 -0
  334. package/dist/vista/vista-tools.d.ts.map +1 -0
  335. package/dist/vista/vista-tools.js +113 -0
  336. package/dist/vista/vista-tools.js.map +1 -0
  337. package/package.json +4 -4
  338. package/src/index.ts +5 -0
  339. package/src/lib/biome-host/biome-builders.ts +4 -1
  340. package/src/lib/biome-host/biome-registry.ts +31 -12
  341. package/src/lib/biome-host/biome-scope-hooks.ts +39 -0
  342. package/src/lib/biome-host/biome-scope.tsx +1 -68
  343. package/src/lib/biome-host/biome-scoped-query.ts +4 -1
  344. package/src/lib/biome-host/create-biome-orval-config.ts +2 -2
  345. package/src/lib/biome-host/errors.ts +1 -1
  346. package/src/lib/biome-host/index.ts +1 -1
  347. package/src/lib/biome-host/session-profiles.ts +7 -1
  348. package/src/lib/capabilities/capability-context.ts +25 -0
  349. package/src/lib/capabilities/capability-provider.tsx +5 -34
  350. package/src/lib/capabilities/index.ts +1 -0
  351. package/src/lib/capabilities/use-capability.ts +4 -1
  352. package/src/lib/contribution-registry/contribution-registry.spec.ts +141 -0
  353. package/src/lib/contribution-registry/contribution-registry.ts +202 -0
  354. package/src/lib/contribution-registry/index.ts +9 -0
  355. package/src/lib/contribution-registry/renderable-registry.ts +142 -0
  356. package/src/lib/system-bus/deeplink.ts +1 -1
  357. package/src/lib/system-bus/host-ports.ts +2 -1
  358. package/src/lib/system-bus/intent-registry.ts +1 -2
  359. package/src/offline/index.ts +4 -2
  360. package/src/offline/offline-status-badge.tsx +1 -1
  361. package/src/offline/outbox.test.ts +23 -16
  362. package/src/offline/outbox.ts +1 -1
  363. package/src/offline/react-hooks.ts +37 -0
  364. package/src/offline/react.tsx +1 -40
  365. package/src/offline/storage.ts +11 -6
  366. package/src/registry/index.ts +1 -0
  367. package/src/registry/lib/primitives/SessionEventCard.tsx +4 -2
  368. package/src/registry/lib/session-context-provider.tsx +8 -25
  369. package/src/registry/lib/session-context.ts +21 -0
  370. package/src/registry/lib/session-selectors.ts +3 -1
  371. package/src/ui/branding/app-branding-context.ts +20 -0
  372. package/src/ui/branding/app-branding-provider.tsx +5 -27
  373. package/src/ui/capture/field-spec-to-zod.ts +22 -0
  374. package/src/ui/capture/field-spec-validate.ts +147 -0
  375. package/src/ui/capture/field-spec.ts +62 -0
  376. package/src/ui/capture/index.ts +9 -1
  377. package/src/ui/capture/schema-field-input.tsx +141 -15
  378. package/src/ui/capture/submit-values.test.ts +70 -0
  379. package/src/ui/capture/submit-values.ts +63 -0
  380. package/src/ui/capture/use-prefill.ts +4 -1
  381. package/src/ui/capture/use-wizard.ts +2 -2
  382. package/src/ui/capture/wizard.tsx +2 -1
  383. package/src/ui/index.ts +11 -2
  384. package/src/ui/primitives/alert-dialog.tsx +1 -1
  385. package/src/ui/primitives/badge-variants.ts +21 -0
  386. package/src/ui/primitives/badge.tsx +3 -19
  387. package/src/ui/primitives/button-variants.ts +31 -0
  388. package/src/ui/primitives/button.tsx +3 -28
  389. package/src/ui/primitives/form-stepper.tsx +1 -16
  390. package/src/ui/primitives/form-stepper.types.ts +15 -0
  391. package/src/ui/primitives/overflow-tabs.tsx +24 -4
  392. package/src/ui/primitives/preview-device-frame.tsx +1 -1
  393. package/src/ui/primitives/tag-multi-select.tsx +3 -4
  394. package/src/ui/primitives/url-preview-chrome.tsx +102 -0
  395. package/src/vista/GenericCatalogueSurface.tsx +177 -0
  396. package/src/vista/SurfaceFallbackCard.tsx +109 -0
  397. package/src/vista/VistaPanel.tsx +155 -0
  398. package/src/vista/form-payload.spec.ts +139 -0
  399. package/src/vista/html/CustomUiFrame.spec.tsx +125 -0
  400. package/src/vista/html/CustomUiFrame.tsx +204 -0
  401. package/src/vista/html/custom-ui-frame-bridge.spec.ts +191 -0
  402. package/src/vista/html/custom-ui-frame-bridge.ts +92 -0
  403. package/src/vista/html/custom-ui-frame-contract.ts +88 -0
  404. package/src/vista/html/custom-ui-intents.spec.ts +133 -0
  405. package/src/vista/html/custom-ui-intents.ts +151 -0
  406. package/src/vista/html/custom-ui-srcdoc.spec.ts +151 -0
  407. package/src/vista/html/custom-ui-srcdoc.ts +193 -0
  408. package/src/vista/html/index.ts +13 -0
  409. package/src/vista/index.ts +52 -0
  410. package/src/vista/surface-catalogue.spec.ts +140 -0
  411. package/src/vista/surface-catalogue.ts +84 -0
  412. package/src/vista/surface-icons.ts +57 -0
  413. package/src/vista/surface-registry.ts +56 -0
  414. package/src/vista/surfaces/ChartSurface.tsx +34 -0
  415. package/src/vista/surfaces/FilesSurface.tsx +202 -0
  416. package/src/vista/surfaces/FormSurface.tsx +363 -0
  417. package/src/vista/surfaces/HtmlSurface.tsx +43 -0
  418. package/src/vista/surfaces/TableSurface.tsx +99 -0
  419. package/src/vista/surfaces/UrlSurface.tsx +40 -0
  420. package/src/vista/surfaces/blob-surfaces.tsx +129 -0
  421. package/src/vista/surfaces/elicitation-transport.spec.ts +369 -0
  422. package/src/vista/surfaces/elicitation-transport.ts +353 -0
  423. package/src/vista/surfaces/file-surface-utils.ts +62 -0
  424. package/src/vista/surfaces/index.ts +24 -0
  425. package/src/vista/surfaces/register-surfaces.tsx +137 -0
  426. package/src/vista/surfaces/text-surfaces.tsx +119 -0
  427. package/src/vista/use-vista-tabs.ts +188 -0
  428. package/src/vista/vista-code-renderer-context.ts +16 -0
  429. package/src/vista/vista-code-renderer.tsx +34 -0
  430. package/src/vista/vista-file-context.ts +14 -0
  431. package/src/vista/vista-file-source.tsx +140 -0
  432. package/src/vista/vista-form-context.ts +20 -0
  433. package/src/vista/vista-form-host.tsx +53 -0
  434. package/src/vista/vista-model.ts +130 -0
  435. package/src/vista/vista-open-context.tsx +32 -0
  436. package/src/vista/vista-open-state.ts +11 -0
  437. package/src/vista/vista-payloads.ts +512 -0
  438. package/src/vista/vista-tabs-manifest.ts +123 -0
  439. package/src/vista/vista-tools.ts +220 -0
  440. package/dist/lib/biome-host/response-envelope.d.ts +0 -3
  441. package/dist/lib/biome-host/response-envelope.d.ts.map +0 -1
  442. package/dist/lib/biome-host/response-envelope.js +0 -21
  443. package/dist/lib/biome-host/response-envelope.js.map +0 -1
  444. package/src/lib/biome-host/response-envelope.ts +0 -69
@@ -0,0 +1,139 @@
1
+ /**
2
+ * Guards `validateFormPayload` — the structural half of "the value never
3
+ * reaches the agent".
4
+ *
5
+ * The payload has no network authority: it carries only a base64url opaque ref,
6
+ * while the trusted service base URL comes from `VistaFormHost`.
7
+ */
8
+ import { describe, expect, it } from 'vitest';
9
+
10
+ import { validateFormPayload } from './vista-payloads';
11
+ import { CaptureFieldType } from '../ui/capture/field-spec';
12
+
13
+ const BASE = {
14
+ ref: 'ref-1',
15
+ purpose: 'Connect Acme so I can read your tickets.',
16
+ fields: [
17
+ {
18
+ key: 'apiKey',
19
+ label: 'API key',
20
+ type: CaptureFieldType.String,
21
+ required: true,
22
+ isSecret: true,
23
+ transform: 'trim',
24
+ },
25
+ {
26
+ key: 'baseUrl',
27
+ label: 'Base URL',
28
+ type: CaptureFieldType.Url,
29
+ required: true,
30
+ isSecret: false,
31
+ },
32
+ ],
33
+ };
34
+
35
+ describe('validateFormPayload', () => {
36
+ it('accepts a well-formed field-mode payload and preserves declared secrecy', () => {
37
+ const payload = validateFormPayload(BASE);
38
+ expect(payload).not.toBeNull();
39
+ expect(payload?.fields).toHaveLength(2);
40
+ expect(payload?.fields[0]?.isSecret).toBe(true);
41
+ expect(payload?.fields[1]?.isSecret).toBe(false);
42
+ expect(payload?.fields[0]?.transform).toBe('trim');
43
+ });
44
+
45
+ it('rejects old or malicious payload-selected submit/status authorities', () => {
46
+ for (const target of [
47
+ 'https://evil.example/steal',
48
+ 'https://trusted.example@evil.example/steal',
49
+ '//evil.example/steal',
50
+ '/credential-elicitations/ref-1/submit',
51
+ 'javascript:alert(1)',
52
+ ]) {
53
+ expect(validateFormPayload({ ...BASE, submitUrl: target })).toBeNull();
54
+ expect(validateFormPayload({ ...BASE, statusUrl: target })).toBeNull();
55
+ }
56
+ });
57
+
58
+ it('accepts an EMPTY field schema — the service is the authority, not the client', () => {
59
+ const payload = validateFormPayload({ ...BASE, fields: [] });
60
+ expect(payload).not.toBeNull();
61
+ expect(payload?.fields).toEqual([]);
62
+ });
63
+
64
+ it('rejects a malformed field spec rather than half-rendering it', () => {
65
+ expect(
66
+ validateFormPayload({
67
+ ...BASE,
68
+ fields: [{ key: 'a', label: 'A', type: 'nope' }],
69
+ }),
70
+ ).toBeNull();
71
+ expect(
72
+ validateFormPayload({ ...BASE, fields: [{ key: 'a', label: 'A' }] }),
73
+ ).toBeNull();
74
+ expect(
75
+ validateFormPayload({
76
+ ...BASE,
77
+ fields: [
78
+ {
79
+ key: 'a',
80
+ label: 'A',
81
+ type: CaptureFieldType.String,
82
+ isSecret: 'yes',
83
+ },
84
+ ],
85
+ }),
86
+ ).toBeNull();
87
+ expect(validateFormPayload({ ...BASE, fields: {} })).toBeNull();
88
+ });
89
+
90
+ it('accepts a launch payload with a root-relative trusted-service path', () => {
91
+ const payload = validateFormPayload({
92
+ ...BASE,
93
+ fields: [],
94
+ launch: {
95
+ path: '/oauth/authorize?x=1',
96
+ label: 'Continue to Acme',
97
+ hint: 'h',
98
+ },
99
+ });
100
+ expect(payload?.launch).toEqual({
101
+ path: '/oauth/authorize?x=1',
102
+ label: 'Continue to Acme',
103
+ hint: 'h',
104
+ });
105
+ });
106
+
107
+ it('rejects launch authority/scheme confusion and malformed paths', () => {
108
+ for (const path of [
109
+ 'authorize',
110
+ '//evil.example/authorize',
111
+ 'https://evil.example/authorize',
112
+ 'javascript:alert(1)',
113
+ '\\\\evil.example\\authorize',
114
+ ]) {
115
+ expect(
116
+ validateFormPayload({ ...BASE, launch: { path, label: 'Go' } }),
117
+ ).toBeNull();
118
+ }
119
+ expect(
120
+ validateFormPayload({
121
+ ...BASE,
122
+ launch: { url: 'https://evil.example/a', label: 'Go' },
123
+ }),
124
+ ).toBeNull();
125
+ expect(
126
+ validateFormPayload({
127
+ ...BASE,
128
+ launch: { path: '/authorize', label: '' },
129
+ }),
130
+ ).toBeNull();
131
+ });
132
+
133
+ it('rejects missing refs and path-traversal/encoding input', () => {
134
+ for (const ref of ['', '.', '..', '../steal', 'a/b', '%2e%2e', 'réf']) {
135
+ expect(validateFormPayload({ ...BASE, ref })).toBeNull();
136
+ }
137
+ expect(validateFormPayload({ ...BASE, ref: undefined })).toBeNull();
138
+ });
139
+ });
@@ -0,0 +1,125 @@
1
+ /**
2
+ * CustomUiFrame — the executes-author-code security surface.
3
+ *
4
+ * Asserts the opaque-origin posture on the rendered iframe: sandbox is
5
+ * `allow-scripts` with NO `allow-same-origin`, the srcdoc pins the server SRI
6
+ * hash as the CSP script-src, and the chunk bytes are the inline module script.
7
+ * The static-document form is asserted too: same containment, `script-src
8
+ * 'none'`, so an authored `<script>` can never run.
9
+ *
10
+ * The final block MUTATION-tests the sandbox invariant IN ISOLATION: it proves
11
+ * the suite goes RED if `allow-same-origin` is ever added to the sandbox token
12
+ * (which would dissolve the origin boundary), independent of the CSP-hash
13
+ * mutation proof in `custom-ui-srcdoc.spec.ts`.
14
+ *
15
+ * Migrated from `app-forge-web` when the frame was promoted into the UI kernel;
16
+ * runs under the host-web vitest mirror (this package carries no vitest dep).
17
+ */
18
+ import { renderToStaticMarkup } from 'react-dom/server';
19
+ import { describe, expect, it, vi } from 'vitest';
20
+
21
+ import {
22
+ createNavigateIntentSet,
23
+ CustomUiIntentKind,
24
+ NO_CUSTOM_UI_INTENTS,
25
+ } from './custom-ui-intents';
26
+ import { CustomUiFrame } from './CustomUiFrame';
27
+
28
+ const INTEGRITY = 'sha384-AbC123def456Ghi789jklMnoPqr';
29
+ const COMPILED = 'export default function C(){return null}';
30
+ // The style import is a HOST concern (the kernel defaults to its own reset) —
31
+ // this test is about the security surface, so it pins a trivial stylesheet.
32
+ const STYLE_CSS = ':root{--x:1}';
33
+
34
+ function parseIframe(markup: string): Element {
35
+ const doc = new DOMParser().parseFromString(markup, 'text/html');
36
+ const iframe = doc.querySelector('iframe');
37
+ if (!iframe) throw new Error('no iframe rendered');
38
+ return iframe;
39
+ }
40
+
41
+ function renderFrame() {
42
+ return parseIframe(
43
+ renderToStaticMarkup(
44
+ <CustomUiFrame
45
+ content={{ compiledOutput: COMPILED, integrity: INTEGRITY }}
46
+ componentProps={{ records: [] }}
47
+ intents={createNavigateIntentSet({
48
+ [CustomUiIntentKind.Navigate]: vi.fn(),
49
+ })}
50
+ styleCss={STYLE_CSS}
51
+ title="Test custom view"
52
+ />,
53
+ ),
54
+ );
55
+ }
56
+
57
+ function renderDocumentFrame(document: string) {
58
+ return parseIframe(
59
+ renderToStaticMarkup(
60
+ <CustomUiFrame
61
+ content={{ document }}
62
+ intents={NO_CUSTOM_UI_INTENTS}
63
+ styleCss={STYLE_CSS}
64
+ title="Test static document"
65
+ />,
66
+ ),
67
+ );
68
+ }
69
+
70
+ describe('CustomUiFrame security posture', () => {
71
+ it('renders an opaque-origin sandbox: allow-scripts, NO allow-same-origin', () => {
72
+ const iframe = renderFrame();
73
+ expect(iframe.getAttribute('sandbox')).toBe('allow-scripts');
74
+ expect(iframe.getAttribute('sandbox')).not.toContain('allow-same-origin');
75
+ });
76
+
77
+ it('pins the server integrity as the CSP script-src in the srcdoc', () => {
78
+ const srcdoc = renderFrame().getAttribute('srcdoc') ?? '';
79
+ expect(srcdoc).toContain(`script-src '${INTEGRITY}'`);
80
+ expect(srcdoc).toContain(`default-src 'none'`);
81
+ });
82
+
83
+ it('inlines the chunk bytes as the one module script', () => {
84
+ const srcdoc = renderFrame().getAttribute('srcdoc') ?? '';
85
+ expect(srcdoc).toContain(`<script type="module">${COMPILED}</script>`);
86
+ expect(srcdoc).toContain('<div id="root"></div>');
87
+ });
88
+
89
+ // ── MUTATION TEST (sandbox invariant, isolated) ────────────────────────────
90
+ // Prove the assertion is load-bearing: if the component were changed to
91
+ // `sandbox="allow-scripts allow-same-origin"`, THIS exact assertion fails.
92
+ it('MUTATION: adding allow-same-origin to the sandbox token is caught', () => {
93
+ const sandbox = renderFrame().getAttribute('sandbox') ?? '';
94
+ // Exact-match pin: any extra token (e.g. allow-same-origin) breaks equality.
95
+ expect(sandbox).toBe('allow-scripts');
96
+ // And the explicit negative guard the mutation would trip.
97
+ const mutated = 'allow-scripts allow-same-origin';
98
+ expect(sandbox).not.toBe(mutated);
99
+ });
100
+ });
101
+
102
+ describe('CustomUiFrame static-document form', () => {
103
+ it("renders an untrusted document with script-src 'none' in the same sandbox", () => {
104
+ const iframe = renderDocumentFrame('<h1>Report</h1>');
105
+ expect(iframe.getAttribute('sandbox')).toBe('allow-scripts');
106
+ const srcdoc = iframe.getAttribute('srcdoc') ?? '';
107
+ expect(srcdoc).toContain(`script-src 'none'`);
108
+ expect(srcdoc).toContain(`default-src 'none'`);
109
+ expect(srcdoc).toContain('<h1>Report</h1>');
110
+ });
111
+
112
+ it('renders a visible notice (no iframe) when the document cannot be built safely', () => {
113
+ const markup = renderToStaticMarkup(
114
+ <CustomUiFrame
115
+ content={{ document: '<p>x</p></script><script>alert(1)</script>' }}
116
+ intents={NO_CUSTOM_UI_INTENTS}
117
+ styleCss={STYLE_CSS}
118
+ title="Unsafe document"
119
+ />,
120
+ );
121
+ expect(markup).toContain('role="alert"');
122
+ expect(markup).toContain('could not be prepared safely');
123
+ expect(markup).not.toContain('<iframe');
124
+ });
125
+ });
@@ -0,0 +1,204 @@
1
+ /**
2
+ * `CustomUiFrame` — the reusable, security-hardened renderer for untrusted UI.
3
+ * It runs author-/agent-authored content inside an OPAQUE-ORIGIN sandbox iframe
4
+ * and bridges it to the host over the frozen `postMessage` contract.
5
+ *
6
+ * Promoted from `app-forge-web` into the UI kernel (Canopy §8.3) so App Forge's
7
+ * runtime views and the Vista `html` surface share ONE hardened frame. The
8
+ * intent set is now supplied by the mounting surface
9
+ * ({@link CustomUiIntentSet}); everything below is carried over verbatim.
10
+ *
11
+ * Security posture (NON-NEGOTIABLE — this renders untrusted content):
12
+ * • sandbox="allow-scripts" and NO allow-same-origin → the frame runs in a
13
+ * unique opaque origin and cannot reach host DOM, cookies, localStorage or
14
+ * tokens.
15
+ * • srcdoc with a `<meta>` CSP that pins the chunk's server SRI hash as the
16
+ * sole script-src (or `'none'` for a static document) and sets default-src
17
+ * 'none' → no network, only the exact pinned bytes execute. See
18
+ * {@link buildCustomUiSrcDoc} / {@link buildUntrustedHtmlSrcDoc}.
19
+ * • Every inbound message is validated by {@link classifyFrameMessage}
20
+ * (source-window identity + protocol + closed type set) before the host
21
+ * acts. Intents are validated against a closed set and performed by the
22
+ * host — the frame never acts with the user's authority.
23
+ *
24
+ * The host pushes read-only props on `frameReady` (and re-pushes when they
25
+ * change), performs validated intents, and surfaces a render error the frame
26
+ * reports — never a blank frame.
27
+ */
28
+ import { AlertTriangle } from 'lucide-react';
29
+ import { useEffect, useMemo, useRef, useState, type ReactElement } from 'react';
30
+
31
+ import { classifyFrameMessage } from './custom-ui-frame-bridge';
32
+ import {
33
+ hostPropsMessage,
34
+ type CustomUiComponentProps,
35
+ } from './custom-ui-frame-contract';
36
+ import { type CustomUiIntentSet } from './custom-ui-intents';
37
+ import {
38
+ CUSTOM_UI_FRAME_RESET_CSS,
39
+ buildCustomUiSrcDoc,
40
+ buildUntrustedHtmlSrcDoc,
41
+ } from './custom-ui-srcdoc';
42
+ import { cn } from '../../ui/cn';
43
+
44
+ /** What the frame renders. Exactly one of the two forms. */
45
+ export type CustomUiFrameContent =
46
+ | {
47
+ /** A server-compiled, SRI-pinned, self-mounting ESM chunk. */
48
+ readonly compiledOutput: string;
49
+ /** Server SRI/CSP token (`sha384-<base64>`) pinning the chunk bytes. */
50
+ readonly integrity: string;
51
+ }
52
+ | {
53
+ /** An untrusted HTML document. Rendered with `script-src 'none'`. */
54
+ readonly document: string;
55
+ };
56
+
57
+ export interface CustomUiFrameProps<TIntent> {
58
+ /** The content to render. */
59
+ readonly content: CustomUiFrameContent;
60
+ /** Read-only, serializable props handed to a compiled component. */
61
+ readonly componentProps?: CustomUiComponentProps;
62
+ /** The CLOSED intent set this frame may exercise against the host. */
63
+ readonly intents: CustomUiIntentSet<TIntent>;
64
+ /**
65
+ * CSS inlined into the frame (the frame cannot fetch a stylesheet — its CSP
66
+ * is `default-src 'none'`). Defaults to {@link CUSTOM_UI_FRAME_RESET_CSS};
67
+ * hosts prepend it to their own design-token CSS.
68
+ */
69
+ readonly styleCss?: string;
70
+ /** Accessible title for the iframe. */
71
+ readonly title: string;
72
+ readonly className?: string;
73
+ }
74
+
75
+ const EMPTY_PROPS: CustomUiComponentProps = {};
76
+
77
+ export function CustomUiFrame<TIntent>({
78
+ content,
79
+ componentProps = EMPTY_PROPS,
80
+ intents,
81
+ styleCss = CUSTOM_UI_FRAME_RESET_CSS,
82
+ title,
83
+ className,
84
+ }: CustomUiFrameProps<TIntent>): ReactElement {
85
+ const iframeRef = useRef<HTMLIFrameElement | null>(null);
86
+ const [frameError, setFrameError] = useState<string | null>(null);
87
+
88
+ // Latest props/intent set, read by the message listener without
89
+ // re-subscribing (the listener is attached once; a props re-render is handled
90
+ // by a dedicated effect below).
91
+ const propsRef = useRef(componentProps);
92
+ propsRef.current = componentProps;
93
+ const intentsRef = useRef(intents);
94
+ intentsRef.current = intents;
95
+ const readyRef = useRef(false);
96
+
97
+ // The srcdoc is a pure function of the content identity + inlined styles — it
98
+ // does NOT depend on props (props flow over postMessage, not by re-mounting
99
+ // the frame). Recomputing only on content change avoids reloading the frame
100
+ // on every prop update.
101
+ // The builders throw on content that would truncate the inline module (a
102
+ // `</script`-bearing body) — surface it as a visible error rather than
103
+ // white-screening. `null` srcDoc ⇒ render the notice, no iframe.
104
+ const isCompiled = 'compiledOutput' in content;
105
+ const compiledOutput = isCompiled ? content.compiledOutput : null;
106
+ const integrity = isCompiled ? content.integrity : null;
107
+ const document = isCompiled ? null : content.document;
108
+ const srcDoc = useMemo<string | null>(() => {
109
+ try {
110
+ return compiledOutput !== null && integrity !== null
111
+ ? buildCustomUiSrcDoc({ compiledOutput, integrity, styleCss })
112
+ : buildUntrustedHtmlSrcDoc({ document: document ?? '', styleCss });
113
+ } catch {
114
+ return null;
115
+ }
116
+ }, [compiledOutput, integrity, document, styleCss]);
117
+
118
+ // Fresh content is a fresh frame lifecycle — reset ready + error state.
119
+ useEffect(() => {
120
+ readyRef.current = false;
121
+ setFrameError(null);
122
+ }, [srcDoc]);
123
+
124
+ useEffect(() => {
125
+ function onMessage(event: MessageEvent): void {
126
+ const frameWindow = iframeRef.current?.contentWindow ?? null;
127
+ const classified = classifyFrameMessage(
128
+ event,
129
+ frameWindow,
130
+ intentsRef.current.parse,
131
+ );
132
+ switch (classified.kind) {
133
+ case 'ready':
134
+ readyRef.current = true;
135
+ setFrameError(null);
136
+ frameWindow?.postMessage(hostPropsMessage(propsRef.current), '*');
137
+ return;
138
+ case 'intent':
139
+ intentsRef.current.perform(classified.intent);
140
+ return;
141
+ case 'error':
142
+ setFrameError(classified.message);
143
+ return;
144
+ case 'ignored':
145
+ return;
146
+ }
147
+ }
148
+ window.addEventListener('message', onMessage);
149
+ return () => window.removeEventListener('message', onMessage);
150
+ }, []);
151
+
152
+ // Re-push props to an already-ready frame when they change (repeatable
153
+ // re-render, per the HostProps contract). Before ready, the frameReady
154
+ // handler above pushes the current props — so no update is lost.
155
+ useEffect(() => {
156
+ if (!readyRef.current) return;
157
+ iframeRef.current?.contentWindow?.postMessage(
158
+ hostPropsMessage(componentProps),
159
+ '*',
160
+ );
161
+ }, [componentProps]);
162
+
163
+ if (srcDoc === null) {
164
+ return (
165
+ <div className={className}>
166
+ <div
167
+ role="alert"
168
+ className="flex items-start gap-2 rounded border border-destructive/40 bg-destructive/5 p-3 text-sm text-destructive"
169
+ >
170
+ <AlertTriangle className="mt-0.5 h-4 w-4 shrink-0" />
171
+ <span>
172
+ This custom view could not be prepared safely and was not rendered.
173
+ </span>
174
+ </div>
175
+ </div>
176
+ );
177
+ }
178
+
179
+ return (
180
+ <div className={cn('flex h-full min-h-0 flex-col', className)}>
181
+ {frameError !== null ? (
182
+ <div
183
+ role="alert"
184
+ className="mb-2 flex items-start gap-2 rounded border border-destructive/40 bg-destructive/5 p-3 text-sm text-destructive"
185
+ >
186
+ <AlertTriangle className="mt-0.5 h-4 w-4 shrink-0" />
187
+ <span>This custom view failed to render: {frameError}</span>
188
+ </div>
189
+ ) : null}
190
+ <iframe
191
+ ref={iframeRef}
192
+ title={title}
193
+ // OPAQUE ORIGIN: allow-scripts ONLY. Adding allow-same-origin would
194
+ // dissolve the origin boundary and give author code access to host
195
+ // cookies/DOM/tokens — never add it.
196
+ sandbox="allow-scripts"
197
+ srcDoc={srcDoc}
198
+ className="min-h-[24rem] w-full flex-1 rounded border border-rule bg-paper"
199
+ />
200
+ </div>
201
+ );
202
+ }
203
+
204
+ export default CustomUiFrame;
@@ -0,0 +1,191 @@
1
+ /**
2
+ * The host-side inbound-message classifier — the security gate for every
3
+ * message the host acts on. Proves it REJECTS a wrong-source message, a
4
+ * wrong-protocol message, an unknown type, and a well-formed envelope carrying
5
+ * an unknown intent; and that it correctly classifies frameReady / a valid
6
+ * intent / a render error. Also proves frameReady is answered with a hostProps
7
+ * message (via the paired builder), and that a frame mounted with the EMPTY
8
+ * intent set can never get an intent performed.
9
+ *
10
+ * Migrated from `app-forge-web` when the frame was promoted into the UI kernel
11
+ * (the intent parser is now an argument instead of a hard-wired import — every
12
+ * gate is otherwise unchanged); runs under the host-web vitest mirror.
13
+ */
14
+ import { describe, expect, it } from 'vitest';
15
+
16
+ import { classifyFrameMessage } from './custom-ui-frame-bridge';
17
+ import {
18
+ CUSTOM_UI_FRAME_PROTOCOL,
19
+ CustomUiFrameMessageType,
20
+ hostPropsMessage,
21
+ } from './custom-ui-frame-contract';
22
+ import {
23
+ CustomUiIntentKind,
24
+ NO_CUSTOM_UI_INTENTS,
25
+ parseCustomUiIntent,
26
+ } from './custom-ui-intents';
27
+
28
+ // A stand-in for the iframe's contentWindow — identity is all the gate checks.
29
+ const FRAME_WINDOW = { name: 'frame' } as unknown as Window;
30
+ const OTHER_WINDOW = { name: 'other' } as unknown as Window;
31
+
32
+ function evt(
33
+ data: unknown,
34
+ source: Window | null,
35
+ ): Pick<MessageEvent, 'source' | 'data'> {
36
+ return { data, source };
37
+ }
38
+
39
+ describe('classifyFrameMessage', () => {
40
+ it('classifies a valid frameReady', () => {
41
+ const result = classifyFrameMessage(
42
+ evt(
43
+ {
44
+ type: CustomUiFrameMessageType.FrameReady,
45
+ protocol: CUSTOM_UI_FRAME_PROTOCOL,
46
+ },
47
+ FRAME_WINDOW,
48
+ ),
49
+ FRAME_WINDOW,
50
+ parseCustomUiIntent,
51
+ );
52
+ expect(result).toEqual({ kind: 'ready' });
53
+ });
54
+
55
+ it('classifies a valid frameIntent into a typed intent', () => {
56
+ const result = classifyFrameMessage(
57
+ evt(
58
+ {
59
+ type: CustomUiFrameMessageType.FrameIntent,
60
+ protocol: CUSTOM_UI_FRAME_PROTOCOL,
61
+ intent: { kind: 'navigate', href: '/apps/x/page' },
62
+ },
63
+ FRAME_WINDOW,
64
+ ),
65
+ FRAME_WINDOW,
66
+ parseCustomUiIntent,
67
+ );
68
+ expect(result).toEqual({
69
+ kind: 'intent',
70
+ intent: { kind: CustomUiIntentKind.Navigate, href: '/apps/x/page' },
71
+ });
72
+ });
73
+
74
+ it('classifies a frameError, surfacing the message', () => {
75
+ const result = classifyFrameMessage(
76
+ evt(
77
+ {
78
+ type: CustomUiFrameMessageType.FrameError,
79
+ protocol: CUSTOM_UI_FRAME_PROTOCOL,
80
+ message: 'boom',
81
+ },
82
+ FRAME_WINDOW,
83
+ ),
84
+ FRAME_WINDOW,
85
+ parseCustomUiIntent,
86
+ );
87
+ expect(result).toEqual({ kind: 'error', message: 'boom' });
88
+ });
89
+
90
+ it('REJECTS a message from the wrong source window', () => {
91
+ const result = classifyFrameMessage(
92
+ evt(
93
+ {
94
+ type: CustomUiFrameMessageType.FrameReady,
95
+ protocol: CUSTOM_UI_FRAME_PROTOCOL,
96
+ },
97
+ OTHER_WINDOW,
98
+ ),
99
+ FRAME_WINDOW,
100
+ parseCustomUiIntent,
101
+ );
102
+ expect(result).toEqual({ kind: 'ignored' });
103
+ });
104
+
105
+ it('REJECTS a message with the wrong protocol', () => {
106
+ const result = classifyFrameMessage(
107
+ evt(
108
+ { type: CustomUiFrameMessageType.FrameReady, protocol: 999 },
109
+ FRAME_WINDOW,
110
+ ),
111
+ FRAME_WINDOW,
112
+ parseCustomUiIntent,
113
+ );
114
+ expect(result).toEqual({ kind: 'ignored' });
115
+ });
116
+
117
+ it('REJECTS an unknown message type', () => {
118
+ const result = classifyFrameMessage(
119
+ evt(
120
+ {
121
+ type: 'xema.customui.somethingElse',
122
+ protocol: CUSTOM_UI_FRAME_PROTOCOL,
123
+ },
124
+ FRAME_WINDOW,
125
+ ),
126
+ FRAME_WINDOW,
127
+ parseCustomUiIntent,
128
+ );
129
+ expect(result).toEqual({ kind: 'ignored' });
130
+ });
131
+
132
+ it('REJECTS a well-formed envelope carrying an unknown intent', () => {
133
+ const result = classifyFrameMessage(
134
+ evt(
135
+ {
136
+ type: CustomUiFrameMessageType.FrameIntent,
137
+ protocol: CUSTOM_UI_FRAME_PROTOCOL,
138
+ intent: { kind: 'wipe-db' },
139
+ },
140
+ FRAME_WINDOW,
141
+ ),
142
+ FRAME_WINDOW,
143
+ parseCustomUiIntent,
144
+ );
145
+ expect(result).toEqual({ kind: 'ignored' });
146
+ });
147
+
148
+ it('REJECTS when no frame window is mounted yet', () => {
149
+ const result = classifyFrameMessage(
150
+ evt(
151
+ {
152
+ type: CustomUiFrameMessageType.FrameReady,
153
+ protocol: CUSTOM_UI_FRAME_PROTOCOL,
154
+ },
155
+ FRAME_WINDOW,
156
+ ),
157
+ null,
158
+ parseCustomUiIntent,
159
+ );
160
+ expect(result).toEqual({ kind: 'ignored' });
161
+ });
162
+
163
+ // The intent set is now supplied by the mounting surface — a frame mounted
164
+ // with the EMPTY set has no authority, so even a perfectly-formed navigate
165
+ // envelope is ignored.
166
+ it('REJECTS every intent when mounted with the EMPTY intent set', () => {
167
+ const result = classifyFrameMessage(
168
+ evt(
169
+ {
170
+ type: CustomUiFrameMessageType.FrameIntent,
171
+ protocol: CUSTOM_UI_FRAME_PROTOCOL,
172
+ intent: { kind: 'navigate', href: '/apps/x/page' },
173
+ },
174
+ FRAME_WINDOW,
175
+ ),
176
+ FRAME_WINDOW,
177
+ NO_CUSTOM_UI_INTENTS.parse,
178
+ );
179
+ expect(result).toEqual({ kind: 'ignored' });
180
+ });
181
+
182
+ it('answers frameReady with a hostProps message (paired builder)', () => {
183
+ const props = { records: [{ id: 'r1' }] };
184
+ const message = hostPropsMessage(props);
185
+ expect(message).toEqual({
186
+ type: CustomUiFrameMessageType.HostProps,
187
+ protocol: CUSTOM_UI_FRAME_PROTOCOL,
188
+ props,
189
+ });
190
+ });
191
+ });