@shivaedev/test-story 0.33.0 → 0.35.0

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 (367) hide show
  1. package/CHANGELOG.md +45 -0
  2. package/README.md +121 -53
  3. package/dist/client/{react.d.ts → adapters/react.d.ts} +0 -1
  4. package/dist/client/adapters/react.d.ts.map +1 -0
  5. package/dist/client/{react.js → adapters/react.js} +6 -18
  6. package/dist/client/adapters/react.js.map +1 -0
  7. package/dist/server/adapters/assertOutcomes.d.ts +12 -0
  8. package/dist/server/adapters/assertOutcomes.d.ts.map +1 -0
  9. package/dist/server/adapters/assertOutcomes.js +6 -0
  10. package/dist/server/adapters/assertOutcomes.js.map +1 -0
  11. package/dist/server/{internal → adapters}/documentRedirect.d.ts.map +1 -1
  12. package/dist/server/{internal → adapters}/documentRedirect.js.map +1 -1
  13. package/dist/server/{internal → adapters}/documentRequest.d.ts.map +1 -1
  14. package/dist/server/{internal → adapters}/documentRequest.js.map +1 -1
  15. package/dist/server/{internal → adapters}/documentResponse.d.ts.map +1 -1
  16. package/dist/server/{internal → adapters}/documentResponse.js.map +1 -1
  17. package/dist/server/{internal → adapters}/documentTransport.d.ts.map +1 -1
  18. package/dist/server/{internal → adapters}/documentTransport.js +3 -3
  19. package/dist/server/{internal → adapters}/documentTransport.js.map +1 -1
  20. package/dist/server/adapters/domEnvironment.config.d.ts.map +1 -0
  21. package/dist/server/{domEnvironment.config.js → adapters/domEnvironment.config.js} +3 -3
  22. package/dist/server/adapters/domEnvironment.config.js.map +1 -0
  23. package/dist/server/adapters/installOutbound.d.ts.map +1 -0
  24. package/dist/server/{internal → adapters}/installOutbound.js +39 -13
  25. package/dist/server/adapters/installOutbound.js.map +1 -0
  26. package/dist/server/adapters/makeForwardingProxy.d.ts +1 -1
  27. package/dist/server/adapters/makeForwardingProxy.d.ts.map +1 -1
  28. package/dist/server/{memberScreens.d.ts → adapters/memberScreens.d.ts} +1 -1
  29. package/dist/server/adapters/memberScreens.d.ts.map +1 -0
  30. package/dist/server/{memberScreens.js → adapters/memberScreens.js} +5 -4
  31. package/dist/server/adapters/memberScreens.js.map +1 -0
  32. package/dist/server/adapters/receiveOtlp.d.ts +1 -1
  33. package/dist/server/adapters/receiveOtlp.d.ts.map +1 -1
  34. package/dist/server/adapters/receiveOtlp.js +1 -1
  35. package/dist/server/adapters/receiveOtlp.js.map +1 -1
  36. package/dist/server/{internal → adapters}/screenAccessibility.d.ts +0 -2
  37. package/dist/server/adapters/screenAccessibility.d.ts.map +1 -0
  38. package/dist/server/{internal → adapters}/screenAccessibility.js +0 -5
  39. package/dist/server/adapters/screenAccessibility.js.map +1 -0
  40. package/dist/server/adapters/screenAct.d.ts +2 -2
  41. package/dist/server/adapters/screenAct.d.ts.map +1 -1
  42. package/dist/server/adapters/screenAct.js.map +1 -1
  43. package/dist/server/adapters/screenDialogs.d.ts +2 -0
  44. package/dist/server/adapters/screenDialogs.d.ts.map +1 -0
  45. package/dist/server/adapters/screenDialogs.js +9 -0
  46. package/dist/server/adapters/screenDialogs.js.map +1 -0
  47. package/dist/server/adapters/screenElements.d.ts +6 -2
  48. package/dist/server/adapters/screenElements.d.ts.map +1 -1
  49. package/dist/server/adapters/screenElements.js +25 -7
  50. package/dist/server/adapters/screenElements.js.map +1 -1
  51. package/dist/server/{internal → adapters}/screenLoading.d.ts.map +1 -1
  52. package/dist/server/{internal → adapters}/screenLoading.js +2 -2
  53. package/dist/server/{internal → adapters}/screenLoading.js.map +1 -1
  54. package/dist/server/adapters/screenQueries.d.ts +3 -1
  55. package/dist/server/adapters/screenQueries.d.ts.map +1 -1
  56. package/dist/server/adapters/screenQueries.js +30 -5
  57. package/dist/server/adapters/screenQueries.js.map +1 -1
  58. package/dist/server/adapters/seedCookies.d.ts.map +1 -0
  59. package/dist/server/adapters/seedCookies.js.map +1 -0
  60. package/dist/server/adapters/storyFailure.d.ts +1 -1
  61. package/dist/server/adapters/storyFailure.d.ts.map +1 -1
  62. package/dist/server/adapters/storyFailure.js +1 -1
  63. package/dist/server/adapters/storyFailure.js.map +1 -1
  64. package/dist/server/adapters/writeSnapshot.d.ts +3 -0
  65. package/dist/server/adapters/writeSnapshot.d.ts.map +1 -0
  66. package/dist/server/adapters/writeSnapshot.js +24 -0
  67. package/dist/server/adapters/writeSnapshot.js.map +1 -0
  68. package/dist/server/answers.d.ts +10 -0
  69. package/dist/server/answers.d.ts.map +1 -0
  70. package/dist/server/answers.js +47 -0
  71. package/dist/server/answers.js.map +1 -0
  72. package/dist/server/browserReads.d.ts +2 -2
  73. package/dist/server/browserReads.d.ts.map +1 -1
  74. package/dist/server/browserReads.js +1 -1
  75. package/dist/server/browserReads.js.map +1 -1
  76. package/dist/server/captureOutcome.d.ts +11 -0
  77. package/dist/server/captureOutcome.d.ts.map +1 -0
  78. package/dist/server/captureOutcome.js +15 -0
  79. package/dist/server/captureOutcome.js.map +1 -0
  80. package/dist/server/domPage.js +1 -1
  81. package/dist/server/domPage.js.map +1 -1
  82. package/dist/server/fakeHttpService.d.ts +4 -2
  83. package/dist/server/fakeHttpService.d.ts.map +1 -1
  84. package/dist/server/fakeHttpService.js +11 -9
  85. package/dist/server/fakeHttpService.js.map +1 -1
  86. package/dist/server/forwardingProxy.js +2 -2
  87. package/dist/server/forwardingProxy.js.map +1 -1
  88. package/dist/server/genreTags.js +1 -1
  89. package/dist/server/genreTags.js.map +1 -1
  90. package/dist/server/httpVisitor.d.ts +1 -1
  91. package/dist/server/httpVisitor.d.ts.map +1 -1
  92. package/dist/server/httpVisitor.js +3 -3
  93. package/dist/server/httpVisitor.js.map +1 -1
  94. package/dist/server/internal/browserReadObserver.d.ts +2 -2
  95. package/dist/server/internal/browserReadObserver.d.ts.map +1 -1
  96. package/dist/server/internal/browserReadObserver.js +16 -2
  97. package/dist/server/internal/browserReadObserver.js.map +1 -1
  98. package/dist/server/internal/browserSubscriptions.d.ts +2 -1
  99. package/dist/server/internal/browserSubscriptions.d.ts.map +1 -1
  100. package/dist/server/internal/browserSubscriptions.js +11 -3
  101. package/dist/server/internal/browserSubscriptions.js.map +1 -1
  102. package/dist/server/internal/compose.d.ts +2 -2
  103. package/dist/server/internal/compose.d.ts.map +1 -1
  104. package/dist/server/internal/compose.js +3 -3
  105. package/dist/server/internal/compose.js.map +1 -1
  106. package/dist/server/internal/compositionTypes.d.ts +3 -3
  107. package/dist/server/internal/compositionTypes.d.ts.map +1 -1
  108. package/dist/server/internal/engineSnapshot.d.ts +2 -2
  109. package/dist/server/internal/engineSnapshot.d.ts.map +1 -1
  110. package/dist/server/internal/engineSnapshot.js +4 -15
  111. package/dist/server/internal/engineSnapshot.js.map +1 -1
  112. package/dist/server/internal/errors.js +2 -2
  113. package/dist/server/internal/errors.js.map +1 -1
  114. package/dist/server/internal/failureReport.d.ts +1 -1
  115. package/dist/server/internal/failureReport.d.ts.map +1 -1
  116. package/dist/server/internal/failureReport.js +9 -6
  117. package/dist/server/internal/failureReport.js.map +1 -1
  118. package/dist/server/internal/fakeHttpAnswer.d.ts +2 -2
  119. package/dist/server/internal/fakeHttpAnswer.d.ts.map +1 -1
  120. package/dist/server/internal/fakeHttpAnswer.js +13 -5
  121. package/dist/server/internal/fakeHttpAnswer.js.map +1 -1
  122. package/dist/server/internal/fakeHttpControls.d.ts +5 -5
  123. package/dist/server/internal/fakeHttpControls.d.ts.map +1 -1
  124. package/dist/server/internal/fakeHttpControls.js +6 -6
  125. package/dist/server/internal/fakeHttpControls.js.map +1 -1
  126. package/dist/server/internal/fakeHttpGates.d.ts +2 -2
  127. package/dist/server/internal/fakeHttpGates.d.ts.map +1 -1
  128. package/dist/server/internal/fakeHttpGates.js +1 -1
  129. package/dist/server/internal/fakeHttpGates.js.map +1 -1
  130. package/dist/server/internal/fakeHttpReceive.d.ts +3 -3
  131. package/dist/server/internal/fakeHttpReceive.d.ts.map +1 -1
  132. package/dist/server/internal/fakeHttpReceive.js +6 -9
  133. package/dist/server/internal/fakeHttpReceive.js.map +1 -1
  134. package/dist/server/internal/fakeHttpScripts.d.ts +1 -1
  135. package/dist/server/internal/fakeHttpScripts.d.ts.map +1 -1
  136. package/dist/server/internal/fakeHttpScripts.js +1 -1
  137. package/dist/server/internal/fakeHttpScripts.js.map +1 -1
  138. package/dist/server/internal/fakeHttpSelection.d.ts +1 -1
  139. package/dist/server/internal/fakeHttpSelection.d.ts.map +1 -1
  140. package/dist/server/internal/fakeHttpSend.d.ts +1 -1
  141. package/dist/server/internal/fakeHttpSend.d.ts.map +1 -1
  142. package/dist/server/internal/fakeHttpSignals.d.ts +10 -0
  143. package/dist/server/internal/fakeHttpSignals.d.ts.map +1 -0
  144. package/dist/server/internal/fakeHttpSignals.js +26 -0
  145. package/dist/server/internal/fakeHttpSignals.js.map +1 -0
  146. package/dist/server/internal/genre.d.ts +1 -1
  147. package/dist/server/internal/genre.d.ts.map +1 -1
  148. package/dist/server/internal/hookInference.d.ts +9 -5
  149. package/dist/server/internal/hookInference.d.ts.map +1 -1
  150. package/dist/server/internal/narration.d.ts +1 -1
  151. package/dist/server/internal/narration.d.ts.map +1 -1
  152. package/dist/server/internal/narration.js +4 -4
  153. package/dist/server/internal/narration.js.map +1 -1
  154. package/dist/server/internal/nextScreenHint.d.ts +5 -0
  155. package/dist/server/internal/nextScreenHint.d.ts.map +1 -0
  156. package/dist/server/internal/nextScreenHint.js +14 -0
  157. package/dist/server/internal/nextScreenHint.js.map +1 -0
  158. package/dist/server/internal/observeBrowser.d.ts +3 -3
  159. package/dist/server/internal/observeBrowser.d.ts.map +1 -1
  160. package/dist/server/internal/observeScreen.d.ts +9 -0
  161. package/dist/server/internal/observeScreen.d.ts.map +1 -0
  162. package/dist/server/internal/observeScreen.js +25 -0
  163. package/dist/server/internal/observeScreen.js.map +1 -0
  164. package/dist/server/internal/otlpProtobuf.js +1 -1
  165. package/dist/server/internal/otlpProtobuf.js.map +1 -1
  166. package/dist/server/internal/otlpReadout.d.ts +4 -4
  167. package/dist/server/internal/otlpReadout.js +2 -2
  168. package/dist/server/internal/otlpReadout.js.map +1 -1
  169. package/dist/server/internal/otlpReadouts.d.ts +2 -1
  170. package/dist/server/internal/otlpReadouts.d.ts.map +1 -1
  171. package/dist/server/internal/otlpReadouts.js +10 -6
  172. package/dist/server/internal/otlpReadouts.js.map +1 -1
  173. package/dist/server/internal/otlpTracing.d.ts +1 -1
  174. package/dist/server/internal/otlpTracing.d.ts.map +1 -1
  175. package/dist/server/internal/runUntil.d.ts +2 -2
  176. package/dist/server/internal/runUntil.d.ts.map +1 -1
  177. package/dist/server/internal/runUntil.js +2 -2
  178. package/dist/server/internal/runUntil.js.map +1 -1
  179. package/dist/server/internal/screenInteractions.d.ts +10 -0
  180. package/dist/server/internal/screenInteractions.d.ts.map +1 -0
  181. package/dist/server/internal/screenInteractions.js +25 -0
  182. package/dist/server/internal/screenInteractions.js.map +1 -0
  183. package/dist/server/internal/screenReadouts.d.ts +10 -1
  184. package/dist/server/internal/screenReadouts.d.ts.map +1 -1
  185. package/dist/server/internal/screenReadouts.js +27 -2
  186. package/dist/server/internal/screenReadouts.js.map +1 -1
  187. package/dist/server/internal/screenText.js +1 -1
  188. package/dist/server/internal/screenText.js.map +1 -1
  189. package/dist/server/internal/screenWaits.d.ts +2 -2
  190. package/dist/server/internal/screenWaits.d.ts.map +1 -1
  191. package/dist/server/internal/screenWaits.js +8 -7
  192. package/dist/server/internal/screenWaits.js.map +1 -1
  193. package/dist/server/internal/seed.d.ts +9 -9
  194. package/dist/server/internal/seed.d.ts.map +1 -1
  195. package/dist/server/internal/seed.js +17 -8
  196. package/dist/server/internal/seed.js.map +1 -1
  197. package/dist/server/internal/start.d.ts +3 -3
  198. package/dist/server/internal/start.d.ts.map +1 -1
  199. package/dist/server/internal/start.js +9 -9
  200. package/dist/server/internal/start.js.map +1 -1
  201. package/dist/server/internal/storyIt.d.ts +2 -2
  202. package/dist/server/internal/storyIt.d.ts.map +1 -1
  203. package/dist/server/internal/storyIt.js +7 -7
  204. package/dist/server/internal/storyIt.js.map +1 -1
  205. package/dist/server/internal/targetName.d.ts +3 -0
  206. package/dist/server/internal/targetName.d.ts.map +1 -0
  207. package/dist/server/internal/targetName.js +6 -0
  208. package/dist/server/internal/targetName.js.map +1 -0
  209. package/dist/server/internal/traits.js +1 -1
  210. package/dist/server/internal/traits.js.map +1 -1
  211. package/dist/server/internal/waitForScreen.d.ts +5 -3
  212. package/dist/server/internal/waitForScreen.d.ts.map +1 -1
  213. package/dist/server/internal/waitForScreen.js +9 -23
  214. package/dist/server/internal/waitForScreen.js.map +1 -1
  215. package/dist/server/internal/withWatchedClock.js +1 -1
  216. package/dist/server/internal/withWatchedClock.js.map +1 -1
  217. package/dist/server/lineSignals.d.ts +2 -2
  218. package/dist/server/lineSignals.d.ts.map +1 -1
  219. package/dist/server/lineSignals.js +2 -2
  220. package/dist/server/lineSignals.js.map +1 -1
  221. package/dist/server/mountApp.d.ts +13 -0
  222. package/dist/server/mountApp.d.ts.map +1 -0
  223. package/dist/server/mountApp.js +8 -0
  224. package/dist/server/mountApp.js.map +1 -0
  225. package/dist/server/otlpReceiver.d.ts +4 -3
  226. package/dist/server/otlpReceiver.d.ts.map +1 -1
  227. package/dist/server/otlpReceiver.js +6 -6
  228. package/dist/server/otlpReceiver.js.map +1 -1
  229. package/dist/server/outcomes.d.ts +1 -8
  230. package/dist/server/outcomes.d.ts.map +1 -1
  231. package/dist/server/outcomes.js +2 -2
  232. package/dist/server/outcomes.js.map +1 -1
  233. package/dist/server/routeOutbound.js +2 -2
  234. package/dist/server/routeOutbound.js.map +1 -1
  235. package/dist/server/screenDriver.d.ts +33 -12
  236. package/dist/server/screenDriver.d.ts.map +1 -1
  237. package/dist/server/screenDriver.js +28 -14
  238. package/dist/server/screenDriver.js.map +1 -1
  239. package/dist/server/screenSignal.d.ts +10 -0
  240. package/dist/server/screenSignal.d.ts.map +1 -0
  241. package/dist/server/screenSignal.js +2 -0
  242. package/dist/server/screenSignal.js.map +1 -0
  243. package/dist/server/storyKit.d.ts +7 -7
  244. package/dist/server/storyKit.d.ts.map +1 -1
  245. package/dist/server/storyKit.js +5 -5
  246. package/dist/server/storyKit.js.map +1 -1
  247. package/dist/server/until.js +1 -1
  248. package/dist/server/until.js.map +1 -1
  249. package/dist/server/watchedClock.d.ts +2 -2
  250. package/dist/server/watchedClock.d.ts.map +1 -1
  251. package/dist/server/watchedClock.js +1 -1
  252. package/dist/server/watchedClock.js.map +1 -1
  253. package/package.json +9 -14
  254. package/src/client/{react.ts → adapters/react.ts} +6 -27
  255. package/src/server/adapters/assertOutcomes.ts +16 -0
  256. package/src/server/{internal → adapters}/documentTransport.ts +3 -3
  257. package/src/server/{domEnvironment.config.ts → adapters/domEnvironment.config.ts} +3 -3
  258. package/src/server/{internal → adapters}/installOutbound.ts +48 -13
  259. package/src/server/adapters/makeForwardingProxy.ts +1 -1
  260. package/src/server/{memberScreens.ts → adapters/memberScreens.ts} +5 -4
  261. package/src/server/adapters/receiveOtlp.ts +2 -2
  262. package/src/server/{internal → adapters}/screenAccessibility.ts +0 -7
  263. package/src/server/adapters/screenAct.ts +4 -4
  264. package/src/server/adapters/screenDialogs.ts +12 -0
  265. package/src/server/adapters/screenElements.ts +28 -8
  266. package/src/server/{internal → adapters}/screenLoading.ts +2 -2
  267. package/src/server/adapters/screenQueries.ts +35 -8
  268. package/src/server/adapters/storyFailure.ts +2 -2
  269. package/src/server/adapters/writeSnapshot.ts +25 -0
  270. package/src/server/answers.ts +55 -0
  271. package/src/server/browserReads.ts +2 -2
  272. package/src/server/captureOutcome.ts +29 -0
  273. package/src/server/domPage.ts +1 -1
  274. package/src/server/fakeHttpService.ts +11 -9
  275. package/src/server/forwardingProxy.ts +2 -2
  276. package/src/server/genreTags.ts +1 -1
  277. package/src/server/httpVisitor.ts +3 -3
  278. package/src/server/internal/browserReadObserver.ts +17 -3
  279. package/src/server/internal/browserSubscriptions.ts +12 -4
  280. package/src/server/internal/compose.ts +5 -5
  281. package/src/server/internal/compositionTypes.ts +3 -3
  282. package/src/server/internal/engineSnapshot.ts +6 -24
  283. package/src/server/internal/errors.ts +2 -2
  284. package/src/server/internal/failureReport.ts +11 -7
  285. package/src/server/internal/fakeHttpAnswer.ts +14 -7
  286. package/src/server/internal/fakeHttpControls.ts +7 -7
  287. package/src/server/internal/fakeHttpGates.ts +2 -2
  288. package/src/server/internal/fakeHttpReceive.ts +8 -11
  289. package/src/server/internal/fakeHttpScripts.ts +2 -2
  290. package/src/server/internal/fakeHttpSelection.ts +1 -1
  291. package/src/server/internal/fakeHttpSend.ts +1 -1
  292. package/src/server/internal/fakeHttpSignals.ts +28 -0
  293. package/src/server/internal/genre.ts +1 -1
  294. package/src/server/internal/hookInference.ts +9 -5
  295. package/src/server/internal/narration.ts +4 -4
  296. package/src/server/internal/nextScreenHint.ts +21 -0
  297. package/src/server/internal/observeBrowser.ts +1 -1
  298. package/src/server/internal/observeScreen.ts +34 -0
  299. package/src/server/internal/otlpProtobuf.ts +1 -1
  300. package/src/server/internal/otlpReadout.ts +2 -2
  301. package/src/server/internal/otlpReadouts.ts +11 -7
  302. package/src/server/internal/otlpTracing.ts +1 -1
  303. package/src/server/internal/runUntil.ts +3 -3
  304. package/src/server/internal/screenInteractions.ts +31 -0
  305. package/src/server/internal/screenReadouts.ts +28 -3
  306. package/src/server/internal/screenText.ts +1 -1
  307. package/src/server/internal/screenWaits.ts +10 -9
  308. package/src/server/internal/seed.ts +32 -14
  309. package/src/server/internal/start.ts +11 -11
  310. package/src/server/internal/storyIt.ts +8 -8
  311. package/src/server/internal/targetName.ts +7 -0
  312. package/src/server/internal/traits.ts +1 -1
  313. package/src/server/internal/waitForScreen.ts +13 -31
  314. package/src/server/internal/withWatchedClock.ts +1 -1
  315. package/src/server/lineSignals.ts +2 -2
  316. package/src/server/mountApp.ts +15 -0
  317. package/src/server/otlpReceiver.ts +7 -7
  318. package/src/server/outcomes.ts +2 -11
  319. package/src/server/routeOutbound.ts +2 -2
  320. package/src/server/screenDriver.ts +54 -26
  321. package/src/server/screenSignal.ts +9 -0
  322. package/src/server/storyKit.ts +10 -10
  323. package/src/server/until.ts +1 -1
  324. package/src/server/watchedClock.ts +1 -1
  325. package/dist/client/adapters/reactRendering.d.ts +0 -7
  326. package/dist/client/adapters/reactRendering.d.ts.map +0 -1
  327. package/dist/client/adapters/reactRendering.js +0 -4
  328. package/dist/client/adapters/reactRendering.js.map +0 -1
  329. package/dist/client/adapters/waitForReact.d.ts +0 -2
  330. package/dist/client/adapters/waitForReact.d.ts.map +0 -1
  331. package/dist/client/adapters/waitForReact.js +0 -8
  332. package/dist/client/adapters/waitForReact.js.map +0 -1
  333. package/dist/client/react.d.ts.map +0 -1
  334. package/dist/client/react.js.map +0 -1
  335. package/dist/server/domEnvironment.config.d.ts.map +0 -1
  336. package/dist/server/domEnvironment.config.js.map +0 -1
  337. package/dist/server/internal/installOutbound.d.ts.map +0 -1
  338. package/dist/server/internal/installOutbound.js.map +0 -1
  339. package/dist/server/internal/nextClientHint.d.ts +0 -4
  340. package/dist/server/internal/nextClientHint.d.ts.map +0 -1
  341. package/dist/server/internal/nextClientHint.js +0 -7
  342. package/dist/server/internal/nextClientHint.js.map +0 -1
  343. package/dist/server/internal/screenAccessibility.d.ts.map +0 -1
  344. package/dist/server/internal/screenAccessibility.js.map +0 -1
  345. package/dist/server/memberScreens.d.ts.map +0 -1
  346. package/dist/server/memberScreens.js.map +0 -1
  347. package/dist/server/seedCookies.d.ts.map +0 -1
  348. package/dist/server/seedCookies.js.map +0 -1
  349. package/src/client/adapters/reactRendering.ts +0 -5
  350. package/src/client/adapters/waitForReact.ts +0 -7
  351. package/src/server/internal/nextClientHint.ts +0 -12
  352. /package/dist/server/{internal → adapters}/documentRedirect.d.ts +0 -0
  353. /package/dist/server/{internal → adapters}/documentRedirect.js +0 -0
  354. /package/dist/server/{internal → adapters}/documentRequest.d.ts +0 -0
  355. /package/dist/server/{internal → adapters}/documentRequest.js +0 -0
  356. /package/dist/server/{internal → adapters}/documentResponse.d.ts +0 -0
  357. /package/dist/server/{internal → adapters}/documentResponse.js +0 -0
  358. /package/dist/server/{internal → adapters}/documentTransport.d.ts +0 -0
  359. /package/dist/server/{domEnvironment.config.d.ts → adapters/domEnvironment.config.d.ts} +0 -0
  360. /package/dist/server/{internal → adapters}/installOutbound.d.ts +0 -0
  361. /package/dist/server/{internal → adapters}/screenLoading.d.ts +0 -0
  362. /package/dist/server/{seedCookies.d.ts → adapters/seedCookies.d.ts} +0 -0
  363. /package/dist/server/{seedCookies.js → adapters/seedCookies.js} +0 -0
  364. /package/src/server/{internal → adapters}/documentRedirect.ts +0 -0
  365. /package/src/server/{internal → adapters}/documentRequest.ts +0 -0
  366. /package/src/server/{internal → adapters}/documentResponse.ts +0 -0
  367. /package/src/server/{seedCookies.ts → adapters/seedCookies.ts} +0 -0
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@shivaedev/test-story",
3
- "version": "0.33.0",
3
+ "version": "0.35.0",
4
4
  "description": "Tests that read like stories over the real engine: a story kit per engine with its own it, traits per feature, and a failure that prints the story, where it stopped and the engine's state",
5
5
  "homepage": "https://github.com/ShivaeDev/platform/tree/main/packages/test-story#readme",
6
6
  "bugs": {
@@ -17,14 +17,9 @@
17
17
  "imports": {
18
18
  "#test/*": "./src/test-support/*",
19
19
  "#*.ts": {
20
- "source": "./src/server/*.ts",
21
- "types": "./dist/server/*.d.ts",
22
- "default": "./dist/server/*.js"
23
- },
24
- "#client/*.ts": {
25
- "source": "./src/client/*.ts",
26
- "types": "./dist/client/*.d.ts",
27
- "default": "./dist/client/*.js"
20
+ "source": "./src/*.ts",
21
+ "types": "./dist/*.d.ts",
22
+ "default": "./dist/*.js"
28
23
  }
29
24
  },
30
25
  "exports": {
@@ -47,9 +42,9 @@
47
42
  "README.md"
48
43
  ],
49
44
  "dependencies": {
50
- "@shivaedev/contract": "0.30.2",
51
- "@shivaedev/test": "0.12.1",
52
- "@shivaedev/test-sql": "0.16.1",
45
+ "@shivaedev/contract": "0.32.0",
46
+ "@shivaedev/test": "0.14.0",
47
+ "@shivaedev/test-sql": "0.17.0",
53
48
  "dom-accessibility-api": "0.7.1"
54
49
  },
55
50
  "devDependencies": {
@@ -57,8 +52,8 @@
57
52
  "@effect/platform-node": "4.0.6",
58
53
  "@effect/sql-pg": "4.0.6",
59
54
  "@effect/vitest": "4.0.6",
60
- "@shivaedev/quality": "0.55.0",
61
- "@shivaedev/react": "0.33.0",
55
+ "@shivaedev/quality": "0.57.0",
56
+ "@shivaedev/react": "0.35.0",
62
57
  "@types/node": "24.19.2",
63
58
  "@types/react": "19.3.0",
64
59
  "@types/react-dom": "19.3.0",
@@ -1,4 +1,3 @@
1
- import * as Clock from "effect/Clock";
2
1
  import * as Effect from "effect/Effect";
3
2
  import * as Exit from "effect/Exit";
4
3
  import type * as AtomRegistry from "effect/reactivity/AtomRegistry";
@@ -6,10 +5,6 @@ import * as Scope from "effect/Scope";
6
5
  import type { ReactNode } from "react";
7
6
  import type { RootOptions } from "react-dom/client";
8
7
  import { beforeEach, expect, vi } from "vitest";
9
- import { eventually as retry } from "@shivaedev/test/eventually.ts";
10
- import { withLive } from "@shivaedev/test/withLive.ts";
11
- import { reactRendering } from "#client/adapters/reactRendering.ts";
12
- import { waitForReact } from "#client/adapters/waitForReact.ts";
13
8
 
14
9
  type CaughtErrorHandler = NonNullable<RootOptions["onCaughtError"]>;
15
10
 
@@ -84,27 +79,6 @@ export function expectNoReactWarnings() {
84
79
  },
85
80
  };
86
81
  }
87
- export function eventually(assert: () => void) {
88
- return withLive(
89
- Effect.gen(function* () {
90
- const started = yield* Clock.currentTimeMillis;
91
- return yield* retry(Effect.try({ catch: (error) => error, try: assert }), {
92
- timeout: "3 seconds",
93
- wait: Effect.promise(waitForReact),
94
- }).pipe(
95
- Effect.catch((error) =>
96
- Effect.gen(function* () {
97
- const elapsed = (yield* Clock.currentTimeMillis) - started;
98
- return yield* Effect.fail(
99
- new Error(`Assertion did not pass after ${elapsed}ms: ${error instanceof Error ? error.message : String(error)}`, { cause: error }),
100
- );
101
- }),
102
- ),
103
- );
104
- }),
105
- );
106
- }
107
-
108
82
  export interface Rendered {
109
83
  readonly container: HTMLDivElement;
110
84
  readonly registry: AtomRegistry.AtomRegistry;
@@ -112,7 +86,12 @@ export interface Rendered {
112
86
  readonly unmount: () => Promise<void>;
113
87
  }
114
88
  export async function render(node: ReactNode, options?: RootOptions): Promise<Rendered> {
115
- const [{ RegistryContext }, registryModule, { createRoot }, { act, createElement }] = await reactRendering();
89
+ const [{ RegistryContext }, registryModule, { createRoot }, { act, createElement }] = await Promise.all([
90
+ import("@effect/atom-react"),
91
+ import("effect/reactivity/AtomRegistry"),
92
+ import("react-dom/client"),
93
+ import("react"),
94
+ ]);
116
95
  const registry = registryModule.make();
117
96
  const container = document.createElement("div");
118
97
  document.body.append(container);
@@ -0,0 +1,16 @@
1
+ import * as Effect from "effect/Effect";
2
+ import { type DeeplyAllowMatchers, expect } from "vitest";
3
+ import type { NumericBound } from "./outcomeMatchers.ts";
4
+
5
+ type NativeMatcher = Exclude<DeeplyAllowMatchers<number>, number>;
6
+ export type Expected<T> =
7
+ | NativeMatcher
8
+ | (T extends readonly unknown[]
9
+ ? { readonly [TKey in keyof T]: Expected<T[TKey]> }
10
+ : T extends object
11
+ ? { readonly [TKey in keyof T]?: Expected<T[TKey]> }
12
+ : T | (T extends number ? NumericBound : never));
13
+
14
+ export const assertOutcomes = Effect.fnUntraced(function* (actual: readonly Record<string, unknown>[], expected: readonly Record<string, unknown>[]) {
15
+ yield* Effect.sync(() => expect(actual).toMatchObject(expected));
16
+ });
@@ -2,9 +2,9 @@ import * as HttpStatus from "effect/http/HttpStatus";
2
2
  import type { IFetchInterceptor } from "happy-dom";
3
3
  import FetchRequestHeaderUtility from "happy-dom/lib/fetch/utilities/FetchRequestHeaderUtility.js";
4
4
  import WindowBrowserContext from "happy-dom/lib/window/WindowBrowserContext.js";
5
- import { documentRedirect } from "#internal/documentRedirect.ts";
6
- import { documentRequest } from "#internal/documentRequest.ts";
7
- import { documentResponse, documentResponseHeaders } from "#internal/documentResponse.ts";
5
+ import { documentRedirect } from "#server/adapters/documentRedirect.ts";
6
+ import { documentRequest } from "#server/adapters/documentRequest.ts";
7
+ import { documentResponse, documentResponseHeaders } from "#server/adapters/documentResponse.ts";
8
8
 
9
9
  export function documentTransport(fetch: typeof globalThis.fetch): IFetchInterceptor {
10
10
  return {
@@ -8,9 +8,9 @@ const domEnvironment: Environment = {
8
8
  async setup(global: typeof globalThis, { happyDOM = {} }) {
9
9
  // Vitest loads environments outside the project's source resolution conditions.
10
10
  const load = createRequire(import.meta.url);
11
- const { documentTransport }: typeof import("#internal/documentTransport.ts") = load("#internal/documentTransport.ts");
12
- const { installOutbound }: typeof import("#internal/installOutbound.ts") = load("#internal/installOutbound.ts");
13
- const { installDomTimers }: typeof import("#internal/installDomTimers.ts") = load("#internal/installDomTimers.ts");
11
+ const { documentTransport }: typeof import("#server/adapters/documentTransport.ts") = load("#server/adapters/documentTransport.ts");
12
+ const { installOutbound }: typeof import("#server/adapters/installOutbound.ts") = load("#server/adapters/installOutbound.ts");
13
+ const { installDomTimers }: typeof import("#server/internal/installDomTimers.ts") = load("#server/internal/installDomTimers.ts");
14
14
  const native = Object.fromEntries(
15
15
  ["fetch", "AbortController", "AbortSignal", "Headers", "Request", "Response"].map((name) => [name, Reflect.get(global, name)]),
16
16
  );
@@ -1,5 +1,5 @@
1
1
  import { isIP } from "node:net";
2
- import { unrouted } from "#internal/errors.ts";
2
+ import { unrouted } from "#server/internal/errors.ts";
3
3
 
4
4
  interface DispatchOptions {
5
5
  readonly origin: string | URL;
@@ -13,11 +13,28 @@ function isDispatcher(value: unknown): value is Dispatcher {
13
13
  return typeof value === "object" && value !== null && "dispatch" in value && typeof value.dispatch === "function";
14
14
  }
15
15
 
16
- export async function installOutbound(routes: Readonly<Record<string, string>>, strict = true) {
17
- const origins = new Map(Object.entries(routes).map(([hostname, target]) => [hostname, new URL(target).origin]));
18
- let refused: Error | undefined;
19
- // A data URL initializes Node's bundled Undici without sending an HTTP request.
20
- await fetch("data:,");
16
+ interface Registration {
17
+ readonly origins: ReadonlyMap<string, string>;
18
+ refused?: Error;
19
+ readonly strict: boolean;
20
+ }
21
+
22
+ const registrations = new Set<Registration>();
23
+ let restoreDispatchers: (() => void) | undefined;
24
+
25
+ function routingFor(hostname: string) {
26
+ let target: string | undefined;
27
+ let strict: Registration | undefined;
28
+ for (const registration of registrations) {
29
+ target = registration.origins.get(hostname) ?? target;
30
+ if (registration.strict) {
31
+ strict = registration;
32
+ }
33
+ }
34
+ return { strict, target };
35
+ }
36
+
37
+ function installDispatchers() {
21
38
  const slots = ["undici.globalDispatcher.1", "undici.globalDispatcher.2"].flatMap((name) => {
22
39
  const key = Symbol.for(name);
23
40
  const previous: unknown = Reflect.get(globalThis, key);
@@ -36,15 +53,15 @@ export async function installOutbound(routes: Readonly<Record<string, string>>,
36
53
  const router: Dispatcher = {
37
54
  dispatch(options, handler) {
38
55
  const hostname = new URL(options.origin).hostname;
39
- const target = origins.get(hostname);
56
+ const { strict, target } = routingFor(hostname);
40
57
  if (
41
- strict
58
+ strict !== undefined
42
59
  && target === undefined
43
60
  && !["localhost", "[::1]"].includes(hostname)
44
61
  && !(isIP(hostname) === 4 && hostname.startsWith("127."))
45
62
  ) {
46
- refused = unrouted(hostname);
47
- throw refused;
63
+ strict.refused = unrouted(hostname);
64
+ throw strict.refused;
48
65
  }
49
66
  return previous.dispatch(target === undefined ? options : { ...options, origin: target }, handler);
50
67
  },
@@ -55,10 +72,28 @@ export async function installOutbound(routes: Readonly<Record<string, string>>,
55
72
  restore();
56
73
  throw error;
57
74
  }
75
+ return restore;
76
+ }
77
+
78
+ export async function installOutbound(routes: Readonly<Record<string, string>>, strict = true) {
79
+ const registration: Registration = {
80
+ origins: new Map(Object.entries(routes).map(([hostname, target]) => [hostname, new URL(target).origin])),
81
+ strict,
82
+ };
83
+ // A data URL initializes Node's bundled Undici without sending an HTTP request.
84
+ await fetch("data:,");
85
+ if (restoreDispatchers === undefined) {
86
+ restoreDispatchers = installDispatchers();
87
+ }
88
+ registrations.add(registration);
58
89
  return () => {
59
- restore();
60
- if (refused !== undefined) {
61
- throw refused;
90
+ registrations.delete(registration);
91
+ if (registrations.size === 0) {
92
+ restoreDispatchers?.();
93
+ restoreDispatchers = undefined;
94
+ }
95
+ if (registration.refused !== undefined) {
96
+ throw registration.refused;
62
97
  }
63
98
  };
64
99
  }
@@ -1,7 +1,7 @@
1
1
  import { createServer, type IncomingMessage, request } from "node:http";
2
2
  import { isIP } from "node:net";
3
3
  import * as HttpStatus from "effect/http/HttpStatus";
4
- import type { ForwardingProxyOptions } from "#forwardingProxy.ts";
4
+ import type { ForwardingProxyOptions } from "#server/forwardingProxy.ts";
5
5
  import { proxyConnections } from "./proxyConnections.ts";
6
6
 
7
7
  export function makeForwardingProxy(upstream: string, options: ForwardingProxyOptions) {
@@ -2,9 +2,9 @@ import * as Effect from "effect/Effect";
2
2
  import * as Option from "effect/Option";
3
3
  import type * as AtomRegistry from "effect/reactivity/AtomRegistry";
4
4
  import type * as Scope from "effect/Scope";
5
- import { domFetch } from "#domFetch.ts";
6
- import { memberFetch } from "#internal/adapters/memberFetch.ts";
7
- import { type DomCookie, seedCookies } from "#seedCookies.ts";
5
+ import { type DomCookie, seedCookies } from "#server/adapters/seedCookies.ts";
6
+ import { domFetch } from "#server/domFetch.ts";
7
+ import { memberFetch } from "#server/internal/adapters/memberFetch.ts";
8
8
 
9
9
  export interface MemberScreen {
10
10
  readonly fetch: typeof globalThis.fetch;
@@ -22,7 +22,7 @@ export function memberScreens<E, R, TVerbs>(options: {
22
22
  return {
23
23
  open: Effect.fnUntraced(function* (name: string, cookies: readonly DomCookie[]) {
24
24
  const [{ GlobalWindow }, registryModule, { documentTransport }] = yield* Effect.promise(() =>
25
- Promise.all([import("happy-dom"), import("effect/reactivity/AtomRegistry"), import("#internal/documentTransport.ts")]),
25
+ Promise.all([import("happy-dom"), import("effect/reactivity/AtomRegistry"), import("#server/adapters/documentTransport.ts")]),
26
26
  );
27
27
  const browser = yield* Effect.acquireRelease(
28
28
  Effect.sync(() => new GlobalWindow({ url: options.baseUrl })),
@@ -33,6 +33,7 @@ export function memberScreens<E, R, TVerbs>(options: {
33
33
  const member = yield* Effect.acquireRelease(
34
34
  Effect.sync(() => {
35
35
  const root = document.createElement("div");
36
+ root.setAttribute("data-story-member", name);
36
37
  document.body.append(root);
37
38
  return {
38
39
  fetch: domFetch(options.baseUrl, { fetch: memberFetch(browser), location: browser.location }),
@@ -1,6 +1,6 @@
1
1
  import type { IncomingMessage, ServerResponse } from "node:http";
2
2
  import * as HttpStatus from "effect/http/HttpStatus";
3
- import type { OtlpExport, OtlpReceiverOptions, OtlpSpan } from "#otlpReceiver.ts";
3
+ import type { OtlpExport, OtlpReceiverOptions, OtlpSpan } from "#server/otlpReceiver.ts";
4
4
 
5
5
  export async function receiveOtlp(
6
6
  request: IncomingMessage,
@@ -25,7 +25,7 @@ export async function receiveOtlp(
25
25
  response.writeHead(HttpStatus.fromLiteral("UnsupportedMediaType")).end();
26
26
  return;
27
27
  }
28
- const { otlpReadout } = await import("#internal/otlpReadout.ts");
28
+ const { otlpReadout } = await import("#server/internal/otlpReadout.ts");
29
29
  for (const span of otlpReadout(body, contentType)) {
30
30
  record(span);
31
31
  }
@@ -1,16 +1,9 @@
1
1
  import { computeAccessibleName, getRole } from "dom-accessibility-api";
2
- import type { ScreenTarget } from "#screenDriver.ts";
3
2
 
4
3
  export function accessibility(element: Element) {
5
4
  return { name: computeAccessibleName(element), role: getRole(element) };
6
5
  }
7
6
 
8
- export function targetName(target: ScreenTarget): string {
9
- return typeof target === "string"
10
- ? target
11
- : `${target.role} named ${typeof target.name === "string" ? JSON.stringify(target.name) : String(target.name)}`;
12
- }
13
-
14
7
  export function isRendered(found: HTMLElement) {
15
8
  const visibility = getComputedStyle(found).visibility;
16
9
  if (visibility === "hidden" || visibility === "collapse") {
@@ -1,10 +1,10 @@
1
1
  import * as Effect from "effect/Effect";
2
2
  import * as Exit from "effect/Exit";
3
- import type { ScreenDriverOptions } from "#screenDriver.ts";
3
+ import type { ScreenDriverOptions } from "#server/screenDriver.ts";
4
4
 
5
- export function screenAct(act: NonNullable<ScreenDriverOptions["act"]>, action: Effect.Effect<void>) {
6
- return Effect.callback<void>((resume, signal) => {
7
- let outcome: Exit.Exit<void> = Exit.void;
5
+ export function screenAct<E>(act: NonNullable<ScreenDriverOptions["act"]>, action: Effect.Effect<void, E>) {
6
+ return Effect.callback<void, E>((resume, signal) => {
7
+ let outcome: Exit.Exit<void, E> = Exit.void;
8
8
  const completed = Promise.resolve(
9
9
  act(async () => {
10
10
  // A rejected callback leaves React's act queue open, so deliver failure after act closes.
@@ -0,0 +1,12 @@
1
+ const DIALOG_SELECTOR = 'dialog,[role="dialog"],[role="alertdialog"]';
2
+
3
+ export function screenDialogs(root: HTMLElement) {
4
+ const member = root.closest("[data-story-member]");
5
+ const controls = member
6
+ ? [...member.querySelectorAll("[aria-controls]")].flatMap((element) => element.getAttribute("aria-controls")?.split(/\s+/u) ?? [])
7
+ : [];
8
+ return [...root.ownerDocument.body.querySelectorAll<HTMLElement>(DIALOG_SELECTOR)].filter(
9
+ (dialog) =>
10
+ !dialog.matches("dialog:not([open])") && (member === null || member.contains(dialog) || (dialog.id !== "" && controls.includes(dialog.id))),
11
+ );
12
+ }
@@ -1,11 +1,17 @@
1
- import { isRendered, targetName } from "#internal/screenAccessibility.ts";
2
- import { screenText } from "#internal/screenText.ts";
3
- import type { ScreenTarget } from "#screenDriver.ts";
1
+ import { screenText } from "#server/internal/screenText.ts";
2
+ import { targetName } from "#server/internal/targetName.ts";
3
+ import type { ScreenTarget } from "#server/screenDriver.ts";
4
+ import { isRendered } from "./screenAccessibility.ts";
4
5
  import { screenQueries } from "./screenQueries.ts";
5
6
 
6
7
  export function screenElements(root: () => HTMLElement, dialogs = true) {
7
8
  const queries = screenQueries(root, dialogs);
8
9
  function rendered(found: HTMLElement, selector: string) {
10
+ if (!found.isConnected) {
11
+ throw new Error(
12
+ `The screen's ${selector} is detached from the document.\nhelp: Find the target again in the current screen before acting on or reading it.`,
13
+ );
14
+ }
9
15
  if (!isRendered(found)) {
10
16
  throw new Error(`The screen's ${selector} is not rendered.\nhelp: Reveal the target and its ancestors before acting on or reading it.`);
11
17
  }
@@ -13,7 +19,7 @@ export function screenElements(root: () => HTMLElement, dialogs = true) {
13
19
  }
14
20
  function element(selector: ScreenTarget) {
15
21
  if (typeof selector !== "string") {
16
- return queries.roleElement(selector);
22
+ return rendered(queries.roleElement(selector), targetName(selector));
17
23
  }
18
24
  const matches = queries.query(selector);
19
25
  const found = matches[0];
@@ -38,7 +44,15 @@ export function screenElements(root: () => HTMLElement, dialogs = true) {
38
44
  throw new Error(`The screen's ${targetName(selector)} is disabled.\nhelp: Wait for the app to enable the control before acting on it.`);
39
45
  }
40
46
  }
47
+ function selectField(selector: ScreenTarget) {
48
+ const field = element(selector);
49
+ if (!(field instanceof HTMLSelectElement)) {
50
+ throw new Error(`The screen's ${targetName(selector)} is not a select.\nhelp: Select a rendered select control.`);
51
+ }
52
+ return field;
53
+ }
41
54
  return {
55
+ dialog: queries.dialogElement,
42
56
  element,
43
57
  enabled,
44
58
  enter: (selector: ScreenTarget, value: string) => {
@@ -62,13 +76,11 @@ export function screenElements(root: () => HTMLElement, dialogs = true) {
62
76
  return found;
63
77
  },
64
78
  input,
79
+ labelled: queries.labelledElement,
65
80
  matches: queries.matches,
66
81
  rendered,
67
82
  select: (selector: ScreenTarget, value: string) => {
68
- const field = element(selector);
69
- if (!(field instanceof HTMLSelectElement)) {
70
- throw new Error(`The screen's ${targetName(selector)} is not a select.\nhelp: Select a rendered select control.`);
71
- }
83
+ const field = selectField(selector);
72
84
  enabled(field, selector);
73
85
  if (!Array.from(field.options).some((option) => option.value === value)) {
74
86
  throw new Error(`The screen's ${targetName(selector)} has no option ${JSON.stringify(value)}.\nhelp: Choose an available option value.`);
@@ -77,6 +89,14 @@ export function screenElements(root: () => HTMLElement, dialogs = true) {
77
89
  field.value = value;
78
90
  field.dispatchEvent(new Event("change", { bubbles: true }));
79
91
  },
92
+ selectField,
93
+ table: (selector: ScreenTarget) => {
94
+ const found = element(selector);
95
+ if (!(found instanceof HTMLTableElement)) {
96
+ throw new Error(`The screen's ${targetName(selector)} is not an HTML table.\nhelp: Select a native table to read its rows and cells.`);
97
+ }
98
+ return found;
99
+ },
80
100
  text: screenText,
81
101
  textElement: queries.textElement,
82
102
  };
@@ -1,7 +1,7 @@
1
1
  import { isInaccessible } from "dom-accessibility-api";
2
- import { screenQueries } from "#adapters/screenQueries.ts";
2
+ import { screenText } from "#server/internal/screenText.ts";
3
3
  import { isRendered } from "./screenAccessibility.ts";
4
- import { screenText } from "./screenText.ts";
4
+ import { screenQueries } from "./screenQueries.ts";
5
5
 
6
6
  export function screenLoading(root: () => HTMLElement, dialogs: boolean) {
7
7
  const queries = screenQueries(root, dialogs);
@@ -1,7 +1,9 @@
1
1
  import { isInaccessible } from "dom-accessibility-api";
2
- import { accessibility, isRendered, targetName } from "#internal/screenAccessibility.ts";
3
- import { screenText } from "#internal/screenText.ts";
4
- import type { ScreenTarget } from "#screenDriver.ts";
2
+ import { screenText } from "#server/internal/screenText.ts";
3
+ import { targetName } from "#server/internal/targetName.ts";
4
+ import type { ScreenTarget } from "#server/screenDriver.ts";
5
+ import { accessibility, isRendered } from "./screenAccessibility.ts";
6
+ import { screenDialogs } from "./screenDialogs.ts";
5
7
 
6
8
  function matchesText(value: string, expected: string | RegExp) {
7
9
  return typeof expected === "string" ? value === expected : new RegExp(expected.source, expected.flags).test(value);
@@ -11,11 +13,7 @@ export function screenQueries(root: () => HTMLElement, dialogs: boolean) {
11
13
  function query(selector: string) {
12
14
  const current = root();
13
15
  const found = new Set(current.querySelectorAll<HTMLElement>(selector));
14
- const portals = dialogs
15
- ? [...current.ownerDocument.querySelectorAll<HTMLElement>('dialog,[role="dialog"],[role="alertdialog"]')].filter(
16
- (dialog) => !current.contains(dialog),
17
- )
18
- : [];
16
+ const portals = dialogs ? screenDialogs(current).filter((dialog) => !current.contains(dialog)) : [];
19
17
  for (const dialog of portals) {
20
18
  if (dialog.matches(selector)) {
21
19
  found.add(dialog);
@@ -39,6 +37,35 @@ export function screenQueries(root: () => HTMLElement, dialogs: boolean) {
39
37
  return candidates().filter(({ role, name }) => role === target.role && matchesText(name, target.name));
40
38
  }
41
39
  return {
40
+ dialogElement: (target: ScreenTarget) => {
41
+ const matches = screenDialogs(root()).filter((dialog) => {
42
+ if (!isRendered(dialog) || isInaccessible(dialog)) {
43
+ return false;
44
+ }
45
+ if (typeof target === "string") {
46
+ return dialog.matches(target);
47
+ }
48
+ const { name, role } = accessibility(dialog);
49
+ return role === target.role && matchesText(name, target.name);
50
+ });
51
+ const found = matches[0];
52
+ if (matches.length !== 1 || found === undefined) {
53
+ throw new Error(
54
+ `The screen has ${matches.length} dialogs for ${targetName(target)}.\nhelp: Identify exactly one visible dialog owned by this screen; link body portals from the member's trigger with aria-controls.`,
55
+ );
56
+ }
57
+ return found;
58
+ },
59
+ labelledElement: (name: string | RegExp) => {
60
+ const matches = query("[aria-label],[aria-labelledby],button,input,textarea,select,output,meter,progress").filter(
61
+ (element) => isRendered(element) && !isInaccessible(element) && matchesText(accessibility(element).name, name),
62
+ );
63
+ const found = matches[0];
64
+ if (matches.length !== 1 || found === undefined) {
65
+ throw new Error(`The screen has ${matches.length} elements labelled ${String(name)}.\nhelp: Use a label for exactly one visible readout.`);
66
+ }
67
+ return found;
68
+ },
42
69
  matches: (target: ScreenTarget) =>
43
70
  (typeof target === "string" ? query(target).filter(isRendered) : roles(target).map(({ element }) => element)).filter(
44
71
  (element) => element.isConnected,
@@ -1,7 +1,7 @@
1
1
  import * as Effect from "effect/Effect";
2
2
  import type { TestContext } from "vitest";
3
- import type { FailedTest } from "#internal/failureReport.ts";
4
- import { describeFailure } from "#internal/render.ts";
3
+ import type { FailedTest } from "#server/internal/failureReport.ts";
4
+ import { describeFailure } from "#server/internal/render.ts";
5
5
 
6
6
  export type FailureContext = Pick<TestContext, "onTestFailed" | "task">;
7
7
 
@@ -0,0 +1,25 @@
1
+ import { mkdirSync, writeFileSync } from "node:fs";
2
+ import { basename, dirname, join, relative } from "node:path";
3
+ import process from "node:process";
4
+ import type { FailedTest } from "#server/internal/failureReport.ts";
5
+ import { describeValue, toJson } from "#server/internal/render.ts";
6
+ import { wrap } from "#server/internal/wrap.ts";
7
+
8
+ function slug(text: string): string {
9
+ return text
10
+ .toLowerCase()
11
+ .replaceAll(/[^a-z0-9.]+/gu, "-")
12
+ .slice(0, 80);
13
+ }
14
+
15
+ export function writeSnapshot(name: string, test: FailedTest, value: unknown, characters: number): string[] {
16
+ const heading = `The ${name} when the test failed`;
17
+ const file = join(process.cwd(), "node_modules", ".cache", "test-story", `${slug(basename(test.file))}--${slug(test.name)}--${slug(name)}.json`);
18
+ try {
19
+ mkdirSync(dirname(file), { recursive: true });
20
+ writeFileSync(file, toJson(value, 2));
21
+ } catch (error) {
22
+ return wrap(`${heading} could not be written to ${relative(process.cwd(), file)}: ${describeValue(error)}`);
23
+ }
24
+ return wrap(`${heading} is ${characters} characters of JSON, too long to print here. Read it in ${relative(process.cwd(), file)}`);
25
+ }
@@ -0,0 +1,55 @@
1
+ import { type Cause, type Effect, Exit, Predicate, Result } from "effect";
2
+ import { captureOutcome, renderOutcome } from "#server/captureOutcome.ts";
3
+
4
+ export function words(name: string): string {
5
+ return name
6
+ .replace(/(?<before>[a-z0-9])(?<after>[A-Z])/gu, "$<before> $<after>")
7
+ .replace(/(?<acronym>[A-Z]+)(?<word>[A-Z][a-z])/gu, "$<acronym> $<word>")
8
+ .toLowerCase();
9
+ }
10
+
11
+ export function errorWords(error: unknown): string {
12
+ if (Predicate.hasProperty(error, "_tag") && typeof error._tag === "string") {
13
+ return words(error._tag);
14
+ }
15
+ if (error instanceof Error) {
16
+ return error.name === "Error" ? error.message : words(error.name);
17
+ }
18
+ return String(error);
19
+ }
20
+
21
+ export function decodedErrorWords(error: unknown): string {
22
+ return error instanceof Error ? errorWords(error) : `${errorWords(error)}, left as an undecoded object`;
23
+ }
24
+
25
+ function renderers<A>(explain: (error: unknown) => string) {
26
+ return {
27
+ onDefect: (defect: unknown) => `died with ${explain(defect)}`,
28
+ onFailure: (error: unknown) => `failed with ${explain(error)}`,
29
+ onInterrupt: () => "interrupted",
30
+ onSuccess: (value: A) => value,
31
+ };
32
+ }
33
+
34
+ export function causeWords(cause: Cause.Cause<unknown>, explain: (error: unknown) => string = errorWords): string {
35
+ return renderOutcome(Exit.failCause(cause), renderers<never>(explain));
36
+ }
37
+
38
+ export function answerOf<A>(exit: Exit.Exit<A, unknown>, explain: (error: unknown) => string = errorWords): A | string {
39
+ return renderOutcome(exit, renderers<A>(explain));
40
+ }
41
+
42
+ export function resultOf<A>(result: Result.Result<A, unknown>, explain: (error: unknown) => string = errorWords): A | string {
43
+ return Result.isSuccess(result) ? result.success : `failed with ${explain(result.failure)}`;
44
+ }
45
+
46
+ export function answered<A, E, R>(effect: Effect.Effect<A, E, R>, explain: (error: unknown) => string = errorWords) {
47
+ return captureOutcome(effect, renderers<A>(explain));
48
+ }
49
+
50
+ export function countWords(count: number, thing: string): string {
51
+ if (count === 0) {
52
+ return `no ${thing}s`;
53
+ }
54
+ return count === 1 ? `one ${thing}` : `${count} ${thing}s`;
55
+ }
@@ -5,7 +5,7 @@ import type * as Socket from "effect/socket/Socket";
5
5
  export type BrowserSubscription = {
6
6
  readonly payload: unknown;
7
7
  readonly tag: string;
8
- } & ({ readonly state: "open" | "answered" } | { readonly state: "refused"; readonly refusalTag: string });
8
+ } & ({ readonly state: "open" | "answered" | "closed" } | { readonly state: "refused"; readonly refusalTag: string });
9
9
 
10
10
  export interface BrowserRead {
11
11
  readonly kind: "query" | "subscription";
@@ -23,6 +23,6 @@ export interface BrowserReadsOptions {
23
23
  }
24
24
 
25
25
  export const browserReads = Effect.fn("BrowserStory.browserReads")(function* (options: BrowserReadsOptions) {
26
- const { observeBrowser } = yield* Effect.promise(() => import("#internal/observeBrowser.ts"));
26
+ const { observeBrowser } = yield* Effect.promise(() => import("#server/internal/observeBrowser.ts"));
27
27
  return yield* observeBrowser(options);
28
28
  });
@@ -0,0 +1,29 @@
1
+ import { Cause, Effect, Exit, Option } from "effect";
2
+
3
+ interface Renderers<A, E, TSuccess, TFailure, TDefect, TInterrupt> {
4
+ readonly onDefect: (defect: unknown, cause: Cause.Cause<E>) => TDefect;
5
+ readonly onFailure: (error: E) => TFailure;
6
+ readonly onInterrupt: () => TInterrupt;
7
+ readonly onSuccess: (value: A) => TSuccess;
8
+ }
9
+
10
+ export function renderOutcome<A, E, TSuccess, TFailure, TDefect, TInterrupt>(
11
+ exit: Exit.Exit<A, E>,
12
+ renderers: Renderers<A, E, TSuccess, TFailure, TDefect, TInterrupt>,
13
+ ): TSuccess | TFailure | TDefect | TInterrupt {
14
+ if (Exit.isSuccess(exit)) {
15
+ return renderers.onSuccess(exit.value);
16
+ }
17
+ const failure = Cause.findErrorOption(exit.cause);
18
+ if (Option.isSome(failure)) {
19
+ return renderers.onFailure(failure.value);
20
+ }
21
+ return Cause.hasInterruptsOnly(exit.cause) ? renderers.onInterrupt() : renderers.onDefect(Cause.squash(exit.cause), exit.cause);
22
+ }
23
+
24
+ export function captureOutcome<A, E, R, TSuccess, TFailure, TDefect, TInterrupt>(
25
+ effect: Effect.Effect<A, E, R>,
26
+ renderers: Renderers<A, E, TSuccess, TFailure, TDefect, TInterrupt>,
27
+ ): Effect.Effect<TSuccess | TFailure | TDefect | TInterrupt, never, R> {
28
+ return Effect.map(Effect.exit(effect), (exit) => renderOutcome(exit, renderers));
29
+ }
@@ -1,6 +1,6 @@
1
1
  import * as Effect from "effect/Effect";
2
2
  import * as SubscriptionRef from "effect/SubscriptionRef";
3
- import { pageFetch } from "#internal/adapters/pageFetch.ts";
3
+ import { pageFetch } from "#server/internal/adapters/pageFetch.ts";
4
4
 
5
5
  export const domPage = Effect.fn("BrowserStory.domPage")(function* (url: string) {
6
6
  const pending = yield* SubscriptionRef.make(false);