@shivaedev/test-story 0.34.0 → 0.36.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 (395) hide show
  1. package/CHANGELOG.md +36 -0
  2. package/README.md +80 -47
  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}/callSite.d.ts.map +1 -1
  12. package/dist/server/{internal → adapters}/callSite.js.map +1 -1
  13. package/dist/server/adapters/declareGenre.d.ts +3 -0
  14. package/dist/server/adapters/declareGenre.d.ts.map +1 -0
  15. package/dist/server/adapters/declareGenre.js +20 -0
  16. package/dist/server/adapters/declareGenre.js.map +1 -0
  17. package/dist/server/{internal → adapters}/documentRedirect.d.ts.map +1 -1
  18. package/dist/server/{internal → adapters}/documentRedirect.js.map +1 -1
  19. package/dist/server/{internal → adapters}/documentRequest.d.ts.map +1 -1
  20. package/dist/server/{internal → adapters}/documentRequest.js.map +1 -1
  21. package/dist/server/{internal → adapters}/documentResponse.d.ts.map +1 -1
  22. package/dist/server/{internal → adapters}/documentResponse.js.map +1 -1
  23. package/dist/server/{internal → adapters}/documentTransport.d.ts.map +1 -1
  24. package/dist/server/{internal → adapters}/documentTransport.js +3 -3
  25. package/dist/server/{internal → adapters}/documentTransport.js.map +1 -1
  26. package/dist/server/adapters/domEnvironment.config.d.ts.map +1 -0
  27. package/dist/server/{domEnvironment.config.js → adapters/domEnvironment.config.js} +3 -3
  28. package/dist/server/adapters/domEnvironment.config.js.map +1 -0
  29. package/dist/server/adapters/engineSnapshot.d.ts +4 -0
  30. package/dist/server/adapters/engineSnapshot.d.ts.map +1 -0
  31. package/dist/server/{internal → adapters}/engineSnapshot.js +3 -3
  32. package/dist/server/{internal → adapters}/engineSnapshot.js.map +1 -1
  33. package/dist/server/{internal → adapters}/failureReport.d.ts +1 -1
  34. package/dist/server/{internal → adapters}/failureReport.d.ts.map +1 -1
  35. package/dist/server/{internal → adapters}/failureReport.js +4 -4
  36. package/dist/server/{internal → adapters}/failureReport.js.map +1 -1
  37. package/dist/server/{internal → adapters}/fakeHttpAnswer.d.ts +2 -2
  38. package/dist/server/adapters/fakeHttpAnswer.d.ts.map +1 -0
  39. package/dist/server/{internal → adapters}/fakeHttpAnswer.js +1 -1
  40. package/dist/server/{internal → adapters}/fakeHttpAnswer.js.map +1 -1
  41. package/dist/server/{internal → adapters}/fakeHttpReceive.d.ts +2 -2
  42. package/dist/server/{internal → adapters}/fakeHttpReceive.d.ts.map +1 -1
  43. package/dist/server/{internal → adapters}/fakeHttpReceive.js +2 -2
  44. package/dist/server/{internal → adapters}/fakeHttpReceive.js.map +1 -1
  45. package/dist/server/adapters/fakeHttpRuntime.d.ts +34 -0
  46. package/dist/server/adapters/fakeHttpRuntime.d.ts.map +1 -0
  47. package/dist/server/adapters/fakeHttpRuntime.js +19 -0
  48. package/dist/server/adapters/fakeHttpRuntime.js.map +1 -0
  49. package/dist/server/{internal → adapters}/fakeHttpSend.d.ts +2 -1
  50. package/dist/server/{internal → adapters}/fakeHttpSend.d.ts.map +1 -1
  51. package/dist/server/{internal → adapters}/fakeHttpSend.js +5 -0
  52. package/dist/server/{internal → adapters}/fakeHttpSend.js.map +1 -1
  53. package/dist/server/adapters/installOutbound.js +1 -1
  54. package/dist/server/adapters/installOutbound.js.map +1 -1
  55. package/dist/server/{internal → adapters}/loopback.d.ts.map +1 -1
  56. package/dist/server/{internal → adapters}/loopback.js.map +1 -1
  57. package/dist/server/adapters/makeForwardingProxy.d.ts +3 -1
  58. package/dist/server/adapters/makeForwardingProxy.d.ts.map +1 -1
  59. package/dist/server/adapters/makeForwardingProxy.js +5 -0
  60. package/dist/server/adapters/makeForwardingProxy.js.map +1 -1
  61. package/dist/server/{memberScreens.d.ts → adapters/memberScreens.d.ts} +1 -1
  62. package/dist/server/adapters/memberScreens.d.ts.map +1 -0
  63. package/dist/server/{memberScreens.js → adapters/memberScreens.js} +4 -4
  64. package/dist/server/adapters/memberScreens.js.map +1 -0
  65. package/dist/server/adapters/otlpProtobuf.d.ts.map +1 -0
  66. package/dist/server/{internal → adapters}/otlpProtobuf.js +1 -1
  67. package/dist/server/{internal → adapters}/otlpProtobuf.js.map +1 -1
  68. package/dist/server/{internal → adapters}/otlpWire.d.ts.map +1 -1
  69. package/dist/server/{internal → adapters}/otlpWire.js.map +1 -1
  70. package/dist/server/adapters/receiveOtlp.d.ts +4 -2
  71. package/dist/server/adapters/receiveOtlp.d.ts.map +1 -1
  72. package/dist/server/adapters/receiveOtlp.js +6 -1
  73. package/dist/server/adapters/receiveOtlp.js.map +1 -1
  74. package/dist/server/adapters/recordLines.d.ts +9 -0
  75. package/dist/server/adapters/recordLines.d.ts.map +1 -0
  76. package/dist/server/adapters/recordLines.js +15 -0
  77. package/dist/server/adapters/recordLines.js.map +1 -0
  78. package/dist/server/{internal → adapters}/screenAccessibility.d.ts +0 -2
  79. package/dist/server/adapters/screenAccessibility.d.ts.map +1 -0
  80. package/dist/server/{internal → adapters}/screenAccessibility.js +0 -5
  81. package/dist/server/adapters/screenAccessibility.js.map +1 -0
  82. package/dist/server/adapters/screenAct.d.ts +3 -1
  83. package/dist/server/adapters/screenAct.d.ts.map +1 -1
  84. package/dist/server/adapters/screenAct.js +7 -0
  85. package/dist/server/adapters/screenAct.js.map +1 -1
  86. package/dist/server/adapters/screenElements.d.ts +3 -2
  87. package/dist/server/adapters/screenElements.d.ts.map +1 -1
  88. package/dist/server/adapters/screenElements.js +16 -7
  89. package/dist/server/adapters/screenElements.js.map +1 -1
  90. package/dist/server/{internal → adapters}/screenLoading.d.ts.map +1 -1
  91. package/dist/server/{internal → adapters}/screenLoading.js +2 -2
  92. package/dist/server/{internal → adapters}/screenLoading.js.map +1 -1
  93. package/dist/server/adapters/screenMutations.js +1 -1
  94. package/dist/server/adapters/screenMutations.js.map +1 -1
  95. package/dist/server/adapters/screenQueries.d.ts +1 -1
  96. package/dist/server/adapters/screenQueries.d.ts.map +1 -1
  97. package/dist/server/adapters/screenQueries.js +3 -2
  98. package/dist/server/adapters/screenQueries.js.map +1 -1
  99. package/dist/server/adapters/seedCookies.d.ts.map +1 -0
  100. package/dist/server/adapters/seedCookies.js.map +1 -0
  101. package/dist/server/adapters/storyFailure.d.ts +1 -1
  102. package/dist/server/adapters/storyFailure.d.ts.map +1 -1
  103. package/dist/server/adapters/storyFailure.js +1 -1
  104. package/dist/server/adapters/storyFailure.js.map +1 -1
  105. package/dist/server/adapters/writeSnapshot.d.ts +1 -1
  106. package/dist/server/adapters/writeSnapshot.d.ts.map +1 -1
  107. package/dist/server/adapters/writeSnapshot.js +2 -2
  108. package/dist/server/adapters/writeSnapshot.js.map +1 -1
  109. package/dist/server/answers.d.ts +10 -0
  110. package/dist/server/answers.d.ts.map +1 -0
  111. package/dist/server/answers.js +47 -0
  112. package/dist/server/answers.js.map +1 -0
  113. package/dist/server/browserReads.js +1 -1
  114. package/dist/server/browserReads.js.map +1 -1
  115. package/dist/server/captureOutcome.d.ts +11 -0
  116. package/dist/server/captureOutcome.d.ts.map +1 -0
  117. package/dist/server/captureOutcome.js +15 -0
  118. package/dist/server/captureOutcome.js.map +1 -0
  119. package/dist/server/domPage.js +1 -1
  120. package/dist/server/domPage.js.map +1 -1
  121. package/dist/server/fakeHttpService.d.ts +11 -5
  122. package/dist/server/fakeHttpService.d.ts.map +1 -1
  123. package/dist/server/fakeHttpService.js +13 -25
  124. package/dist/server/fakeHttpService.js.map +1 -1
  125. package/dist/server/forwardingProxy.d.ts.map +1 -1
  126. package/dist/server/forwardingProxy.js +3 -4
  127. package/dist/server/forwardingProxy.js.map +1 -1
  128. package/dist/server/genreTags.js +1 -1
  129. package/dist/server/genreTags.js.map +1 -1
  130. package/dist/server/httpVisitor.d.ts +1 -1
  131. package/dist/server/httpVisitor.d.ts.map +1 -1
  132. package/dist/server/httpVisitor.js +3 -3
  133. package/dist/server/httpVisitor.js.map +1 -1
  134. package/dist/server/internal/browserReadObserver.d.ts +1 -1
  135. package/dist/server/internal/browserReadObserver.d.ts.map +1 -1
  136. package/dist/server/internal/browserReadObserver.js +1 -1
  137. package/dist/server/internal/browserReadObserver.js.map +1 -1
  138. package/dist/server/internal/compose.d.ts +2 -2
  139. package/dist/server/internal/compose.d.ts.map +1 -1
  140. package/dist/server/internal/compose.js +3 -3
  141. package/dist/server/internal/compose.js.map +1 -1
  142. package/dist/server/internal/compositionTypes.d.ts +3 -3
  143. package/dist/server/internal/compositionTypes.d.ts.map +1 -1
  144. package/dist/server/internal/errors.js +2 -2
  145. package/dist/server/internal/errors.js.map +1 -1
  146. package/dist/server/internal/fakeHttpControls.d.ts +13 -7
  147. package/dist/server/internal/fakeHttpControls.d.ts.map +1 -1
  148. package/dist/server/internal/fakeHttpControls.js +14 -17
  149. package/dist/server/internal/fakeHttpControls.js.map +1 -1
  150. package/dist/server/internal/fakeHttpGates.d.ts +7 -3
  151. package/dist/server/internal/fakeHttpGates.d.ts.map +1 -1
  152. package/dist/server/internal/fakeHttpGates.js +4 -4
  153. package/dist/server/internal/fakeHttpGates.js.map +1 -1
  154. package/dist/server/internal/fakeHttpScripts.d.ts +1 -1
  155. package/dist/server/internal/fakeHttpScripts.d.ts.map +1 -1
  156. package/dist/server/internal/fakeHttpScripts.js +1 -1
  157. package/dist/server/internal/fakeHttpScripts.js.map +1 -1
  158. package/dist/server/internal/fakeHttpSelection.d.ts +1 -1
  159. package/dist/server/internal/fakeHttpSelection.d.ts.map +1 -1
  160. package/dist/server/internal/fakeHttpSignals.d.ts +1 -1
  161. package/dist/server/internal/fakeHttpSignals.d.ts.map +1 -1
  162. package/dist/server/internal/fakeHttpSignals.js +1 -1
  163. package/dist/server/internal/fakeHttpSignals.js.map +1 -1
  164. package/dist/server/internal/genre.d.ts +1 -1
  165. package/dist/server/internal/genre.d.ts.map +1 -1
  166. package/dist/server/internal/hookInference.d.ts +9 -5
  167. package/dist/server/internal/hookInference.d.ts.map +1 -1
  168. package/dist/server/internal/narration.d.ts +1 -1
  169. package/dist/server/internal/narration.d.ts.map +1 -1
  170. package/dist/server/internal/narration.js +4 -4
  171. package/dist/server/internal/narration.js.map +1 -1
  172. package/dist/server/internal/nextScreenHint.d.ts +5 -0
  173. package/dist/server/internal/nextScreenHint.d.ts.map +1 -0
  174. package/dist/server/internal/{nextClientHint.js → nextScreenHint.js} +5 -5
  175. package/dist/server/internal/nextScreenHint.js.map +1 -0
  176. package/dist/server/internal/observeBrowser.d.ts +2 -2
  177. package/dist/server/internal/observeBrowser.d.ts.map +1 -1
  178. package/dist/server/internal/observeScreen.d.ts +9 -0
  179. package/dist/server/internal/observeScreen.d.ts.map +1 -0
  180. package/dist/server/internal/observeScreen.js +25 -0
  181. package/dist/server/internal/observeScreen.js.map +1 -0
  182. package/dist/server/internal/otlpReadout.d.ts +4 -4
  183. package/dist/server/internal/otlpReadout.js +2 -2
  184. package/dist/server/internal/otlpReadout.js.map +1 -1
  185. package/dist/server/internal/otlpReadouts.d.ts +2 -1
  186. package/dist/server/internal/otlpReadouts.d.ts.map +1 -1
  187. package/dist/server/internal/otlpReadouts.js +10 -6
  188. package/dist/server/internal/otlpReadouts.js.map +1 -1
  189. package/dist/server/internal/otlpTracing.d.ts +1 -1
  190. package/dist/server/internal/otlpTracing.d.ts.map +1 -1
  191. package/dist/server/internal/runUntil.d.ts +2 -2
  192. package/dist/server/internal/runUntil.d.ts.map +1 -1
  193. package/dist/server/internal/runUntil.js +2 -2
  194. package/dist/server/internal/runUntil.js.map +1 -1
  195. package/dist/server/internal/screenInteractions.d.ts +10 -0
  196. package/dist/server/internal/screenInteractions.d.ts.map +1 -0
  197. package/dist/server/internal/screenInteractions.js +25 -0
  198. package/dist/server/internal/screenInteractions.js.map +1 -0
  199. package/dist/server/internal/screenReadouts.d.ts +8 -1
  200. package/dist/server/internal/screenReadouts.d.ts.map +1 -1
  201. package/dist/server/internal/screenReadouts.js +15 -2
  202. package/dist/server/internal/screenReadouts.js.map +1 -1
  203. package/dist/server/internal/screenText.js +1 -1
  204. package/dist/server/internal/screenText.js.map +1 -1
  205. package/dist/server/internal/screenWaits.d.ts +2 -2
  206. package/dist/server/internal/screenWaits.d.ts.map +1 -1
  207. package/dist/server/internal/screenWaits.js +8 -7
  208. package/dist/server/internal/screenWaits.js.map +1 -1
  209. package/dist/server/internal/seed.d.ts +9 -9
  210. package/dist/server/internal/seed.d.ts.map +1 -1
  211. package/dist/server/internal/seed.js +17 -8
  212. package/dist/server/internal/seed.js.map +1 -1
  213. package/dist/server/internal/start.d.ts +3 -3
  214. package/dist/server/internal/start.d.ts.map +1 -1
  215. package/dist/server/internal/start.js +9 -9
  216. package/dist/server/internal/start.js.map +1 -1
  217. package/dist/server/internal/storyIt.d.ts +2 -2
  218. package/dist/server/internal/storyIt.d.ts.map +1 -1
  219. package/dist/server/internal/storyIt.js +9 -28
  220. package/dist/server/internal/storyIt.js.map +1 -1
  221. package/dist/server/internal/targetName.d.ts +3 -0
  222. package/dist/server/internal/targetName.d.ts.map +1 -0
  223. package/dist/server/internal/targetName.js +6 -0
  224. package/dist/server/internal/targetName.js.map +1 -0
  225. package/dist/server/internal/traits.js +1 -1
  226. package/dist/server/internal/traits.js.map +1 -1
  227. package/dist/server/internal/waitForScreen.d.ts +5 -3
  228. package/dist/server/internal/waitForScreen.d.ts.map +1 -1
  229. package/dist/server/internal/waitForScreen.js +9 -23
  230. package/dist/server/internal/waitForScreen.js.map +1 -1
  231. package/dist/server/internal/withWatchedClock.js +1 -1
  232. package/dist/server/internal/withWatchedClock.js.map +1 -1
  233. package/dist/server/lineSignals.d.ts +2 -2
  234. package/dist/server/lineSignals.d.ts.map +1 -1
  235. package/dist/server/lineSignals.js +3 -11
  236. package/dist/server/lineSignals.js.map +1 -1
  237. package/dist/server/mountApp.d.ts +13 -0
  238. package/dist/server/mountApp.d.ts.map +1 -0
  239. package/dist/server/mountApp.js +8 -0
  240. package/dist/server/mountApp.js.map +1 -0
  241. package/dist/server/otlpReceiver.d.ts +5 -4
  242. package/dist/server/otlpReceiver.d.ts.map +1 -1
  243. package/dist/server/otlpReceiver.js +7 -8
  244. package/dist/server/otlpReceiver.js.map +1 -1
  245. package/dist/server/outcomes.d.ts +1 -8
  246. package/dist/server/outcomes.d.ts.map +1 -1
  247. package/dist/server/outcomes.js +2 -2
  248. package/dist/server/outcomes.js.map +1 -1
  249. package/dist/server/routeOutbound.js +2 -2
  250. package/dist/server/routeOutbound.js.map +1 -1
  251. package/dist/server/screenDriver.d.ts +28 -11
  252. package/dist/server/screenDriver.d.ts.map +1 -1
  253. package/dist/server/screenDriver.js +18 -19
  254. package/dist/server/screenDriver.js.map +1 -1
  255. package/dist/server/screenSignal.d.ts +10 -0
  256. package/dist/server/screenSignal.d.ts.map +1 -0
  257. package/dist/server/screenSignal.js +2 -0
  258. package/dist/server/screenSignal.js.map +1 -0
  259. package/dist/server/storyKit.d.ts +7 -7
  260. package/dist/server/storyKit.d.ts.map +1 -1
  261. package/dist/server/storyKit.js +5 -5
  262. package/dist/server/storyKit.js.map +1 -1
  263. package/dist/server/until.js +1 -1
  264. package/dist/server/until.js.map +1 -1
  265. package/dist/server/watchedClock.d.ts +2 -2
  266. package/dist/server/watchedClock.d.ts.map +1 -1
  267. package/dist/server/watchedClock.js +1 -1
  268. package/dist/server/watchedClock.js.map +1 -1
  269. package/package.json +9 -14
  270. package/src/client/{react.ts → adapters/react.ts} +6 -27
  271. package/src/server/adapters/assertOutcomes.ts +16 -0
  272. package/src/server/adapters/declareGenre.ts +27 -0
  273. package/src/server/{internal → adapters}/documentTransport.ts +3 -3
  274. package/src/server/{domEnvironment.config.ts → adapters/domEnvironment.config.ts} +3 -3
  275. package/src/server/{internal → adapters}/engineSnapshot.ts +5 -5
  276. package/src/server/{internal → adapters}/failureReport.ts +5 -5
  277. package/src/server/{internal → adapters}/fakeHttpAnswer.ts +3 -3
  278. package/src/server/{internal → adapters}/fakeHttpReceive.ts +4 -4
  279. package/src/server/adapters/fakeHttpRuntime.ts +20 -0
  280. package/src/server/{internal → adapters}/fakeHttpSend.ts +7 -1
  281. package/src/server/adapters/installOutbound.ts +1 -1
  282. package/src/server/adapters/makeForwardingProxy.ts +7 -1
  283. package/src/server/{memberScreens.ts → adapters/memberScreens.ts} +4 -4
  284. package/src/server/{internal → adapters}/otlpProtobuf.ts +1 -1
  285. package/src/server/adapters/receiveOtlp.ts +8 -3
  286. package/src/server/adapters/recordLines.ts +19 -0
  287. package/src/server/{internal → adapters}/screenAccessibility.ts +0 -7
  288. package/src/server/adapters/screenAct.ts +11 -1
  289. package/src/server/adapters/screenElements.ts +19 -8
  290. package/src/server/{internal → adapters}/screenLoading.ts +2 -2
  291. package/src/server/adapters/screenMutations.ts +1 -1
  292. package/src/server/adapters/screenQueries.ts +4 -3
  293. package/src/server/adapters/storyFailure.ts +2 -2
  294. package/src/server/adapters/writeSnapshot.ts +3 -3
  295. package/src/server/answers.ts +55 -0
  296. package/src/server/browserReads.ts +1 -1
  297. package/src/server/captureOutcome.ts +29 -0
  298. package/src/server/domPage.ts +1 -1
  299. package/src/server/fakeHttpService.ts +16 -27
  300. package/src/server/forwardingProxy.ts +3 -4
  301. package/src/server/genreTags.ts +1 -1
  302. package/src/server/httpVisitor.ts +3 -3
  303. package/src/server/internal/browserReadObserver.ts +2 -2
  304. package/src/server/internal/browserSubscriptions.ts +1 -1
  305. package/src/server/internal/compose.ts +5 -5
  306. package/src/server/internal/compositionTypes.ts +3 -3
  307. package/src/server/internal/errors.ts +2 -2
  308. package/src/server/internal/fakeHttpControls.ts +22 -21
  309. package/src/server/internal/fakeHttpGates.ts +8 -6
  310. package/src/server/internal/fakeHttpScripts.ts +2 -2
  311. package/src/server/internal/fakeHttpSelection.ts +1 -1
  312. package/src/server/internal/fakeHttpSignals.ts +2 -2
  313. package/src/server/internal/genre.ts +1 -1
  314. package/src/server/internal/hookInference.ts +9 -5
  315. package/src/server/internal/narration.ts +4 -4
  316. package/src/server/internal/{nextClientHint.ts → nextScreenHint.ts} +6 -6
  317. package/src/server/internal/observeBrowser.ts +1 -1
  318. package/src/server/internal/observeScreen.ts +34 -0
  319. package/src/server/internal/otlpReadout.ts +2 -2
  320. package/src/server/internal/otlpReadouts.ts +11 -7
  321. package/src/server/internal/otlpTracing.ts +1 -1
  322. package/src/server/internal/runUntil.ts +3 -3
  323. package/src/server/internal/screenInteractions.ts +31 -0
  324. package/src/server/internal/screenReadouts.ts +16 -3
  325. package/src/server/internal/screenText.ts +1 -1
  326. package/src/server/internal/screenWaits.ts +10 -9
  327. package/src/server/internal/seed.ts +32 -14
  328. package/src/server/internal/start.ts +11 -11
  329. package/src/server/internal/storyIt.ts +10 -29
  330. package/src/server/internal/targetName.ts +7 -0
  331. package/src/server/internal/traits.ts +1 -1
  332. package/src/server/internal/waitForScreen.ts +13 -31
  333. package/src/server/internal/withWatchedClock.ts +1 -1
  334. package/src/server/lineSignals.ts +3 -14
  335. package/src/server/mountApp.ts +15 -0
  336. package/src/server/otlpReceiver.ts +9 -9
  337. package/src/server/outcomes.ts +2 -11
  338. package/src/server/routeOutbound.ts +2 -2
  339. package/src/server/screenDriver.ts +30 -27
  340. package/src/server/screenSignal.ts +9 -0
  341. package/src/server/storyKit.ts +10 -10
  342. package/src/server/until.ts +1 -1
  343. package/src/server/watchedClock.ts +1 -1
  344. package/dist/client/adapters/reactRendering.d.ts +0 -7
  345. package/dist/client/adapters/reactRendering.d.ts.map +0 -1
  346. package/dist/client/adapters/reactRendering.js +0 -4
  347. package/dist/client/adapters/reactRendering.js.map +0 -1
  348. package/dist/client/adapters/waitForReact.d.ts +0 -2
  349. package/dist/client/adapters/waitForReact.d.ts.map +0 -1
  350. package/dist/client/adapters/waitForReact.js +0 -8
  351. package/dist/client/adapters/waitForReact.js.map +0 -1
  352. package/dist/client/react.d.ts.map +0 -1
  353. package/dist/client/react.js.map +0 -1
  354. package/dist/server/domEnvironment.config.d.ts.map +0 -1
  355. package/dist/server/domEnvironment.config.js.map +0 -1
  356. package/dist/server/internal/engineSnapshot.d.ts +0 -4
  357. package/dist/server/internal/engineSnapshot.d.ts.map +0 -1
  358. package/dist/server/internal/fakeHttpAnswer.d.ts.map +0 -1
  359. package/dist/server/internal/nextClientHint.d.ts +0 -5
  360. package/dist/server/internal/nextClientHint.d.ts.map +0 -1
  361. package/dist/server/internal/nextClientHint.js.map +0 -1
  362. package/dist/server/internal/otlpProtobuf.d.ts.map +0 -1
  363. package/dist/server/internal/screenAccessibility.d.ts.map +0 -1
  364. package/dist/server/internal/screenAccessibility.js.map +0 -1
  365. package/dist/server/memberScreens.d.ts.map +0 -1
  366. package/dist/server/memberScreens.js.map +0 -1
  367. package/dist/server/seedCookies.d.ts.map +0 -1
  368. package/dist/server/seedCookies.js.map +0 -1
  369. package/src/client/adapters/reactRendering.ts +0 -5
  370. package/src/client/adapters/waitForReact.ts +0 -7
  371. /package/dist/server/{internal → adapters}/callSite.d.ts +0 -0
  372. /package/dist/server/{internal → adapters}/callSite.js +0 -0
  373. /package/dist/server/{internal → adapters}/documentRedirect.d.ts +0 -0
  374. /package/dist/server/{internal → adapters}/documentRedirect.js +0 -0
  375. /package/dist/server/{internal → adapters}/documentRequest.d.ts +0 -0
  376. /package/dist/server/{internal → adapters}/documentRequest.js +0 -0
  377. /package/dist/server/{internal → adapters}/documentResponse.d.ts +0 -0
  378. /package/dist/server/{internal → adapters}/documentResponse.js +0 -0
  379. /package/dist/server/{internal → adapters}/documentTransport.d.ts +0 -0
  380. /package/dist/server/{domEnvironment.config.d.ts → adapters/domEnvironment.config.d.ts} +0 -0
  381. /package/dist/server/{internal → adapters}/loopback.d.ts +0 -0
  382. /package/dist/server/{internal → adapters}/loopback.js +0 -0
  383. /package/dist/server/{internal → adapters}/otlpProtobuf.d.ts +0 -0
  384. /package/dist/server/{internal → adapters}/otlpWire.d.ts +0 -0
  385. /package/dist/server/{internal → adapters}/otlpWire.js +0 -0
  386. /package/dist/server/{internal → adapters}/screenLoading.d.ts +0 -0
  387. /package/dist/server/{seedCookies.d.ts → adapters/seedCookies.d.ts} +0 -0
  388. /package/dist/server/{seedCookies.js → adapters/seedCookies.js} +0 -0
  389. /package/src/server/{internal → adapters}/callSite.ts +0 -0
  390. /package/src/server/{internal → adapters}/documentRedirect.ts +0 -0
  391. /package/src/server/{internal → adapters}/documentRequest.ts +0 -0
  392. /package/src/server/{internal → adapters}/documentResponse.ts +0 -0
  393. /package/src/server/{internal → adapters}/loopback.ts +0 -0
  394. /package/src/server/{internal → adapters}/otlpWire.ts +0 -0
  395. /package/src/server/{seedCookies.ts → adapters/seedCookies.ts} +0 -0
@@ -3,14 +3,13 @@ import * as Context from "effect/Context";
3
3
  import * as Effect from "effect/Effect";
4
4
  import type * as Scope from "effect/Scope";
5
5
  import * as Tracer from "effect/Tracer";
6
- import type { AnyTestLayer } from "@shivaedev/test/anyTestLayer.ts";
7
- import type { EffectClock } from "@shivaedev/test/types.ts";
8
- import { refusal } from "#internal/errors.ts";
9
- import { type AnyEffect, type EffectHook, type Hook, hooked } from "#internal/hooked.ts";
10
- import { type Narration, tellGiven } from "#internal/narration.ts";
11
- import type { LooseRunHooks } from "#internal/runUntil.ts";
12
- import type { Parts } from "#internal/traits.ts";
13
- import type { RunUntilOptions } from "#storyKit.ts";
6
+ import type { AnyTestLayer, EffectClock } from "@shivaedev/test/types.ts";
7
+ import { refusal } from "#server/internal/errors.ts";
8
+ import { type AnyEffect, type EffectHook, type Hook, hooked } from "#server/internal/hooked.ts";
9
+ import { type Narration, tellGiven } from "#server/internal/narration.ts";
10
+ import type { LooseRunHooks } from "#server/internal/runUntil.ts";
11
+ import type { Parts } from "#server/internal/traits.ts";
12
+ import type { RunUntilOptions } from "#server/storyKit.ts";
14
13
 
15
14
  export type LooseTrait = Parts<string, (engine: unknown) => Effect.Effect<void, unknown, unknown>>;
16
15
 
@@ -22,7 +21,7 @@ export interface LooseStory {
22
21
  }
23
22
 
24
23
  export interface LooseDefinition {
25
- readonly after?: Readonly<Partial<Record<string, EffectHook<[engine: unknown], AnyEffect, void>>>>;
24
+ readonly after?: Readonly<Partial<Record<string, EffectHook<[engine: unknown], AnyEffect, unknown>>>>;
26
25
  readonly around?: <A, E, R>(effect: Effect.Effect<A, E, R>) => Effect.Effect<A, unknown, R | Scope.Scope>;
27
26
  readonly clock?: EffectClock;
28
27
  readonly create: EffectHook<[], AnyEffect, unknown>;
@@ -37,12 +36,19 @@ export interface LooseDefinition {
37
36
  readonly verbs: (engine: unknown, story: LooseStory) => object;
38
37
  }
39
38
 
40
- export const seed = Effect.fnUntraced(function* (definition: LooseDefinition, engine: unknown, narration: Narration, given: readonly LooseTrait[]) {
39
+ export const seed = Effect.fnUntraced(function* (
40
+ definition: LooseDefinition,
41
+ engine: unknown,
42
+ narration: Narration,
43
+ given: readonly LooseTrait[],
44
+ body: Effect.Effect<unknown, unknown, unknown>,
45
+ onFailure: (cause: Cause.Cause<unknown>) => Effect.Effect<unknown, never, unknown>,
46
+ ) {
41
47
  const parts = given.flatMap((each) => each.parts);
42
48
  tellGiven(narration, parts);
43
- for (const stage of definition.stages) {
49
+ const stage = Effect.fnUntraced(function* (name: string) {
44
50
  for (const [index, part] of parts.entries()) {
45
- if (part.stage === stage) {
51
+ if (part.stage === name) {
46
52
  yield* Effect.suspend(() => part.apply(engine)).pipe(
47
53
  Effect.catchCause((cause) => {
48
54
  if (Cause.hasInterruptsOnly(cause)) {
@@ -55,9 +61,21 @@ export const seed = Effect.fnUntraced(function* (definition: LooseDefinition, en
55
61
  );
56
62
  }
57
63
  }
58
- const after = definition.after?.[stage];
64
+ const after = definition.after?.[name];
59
65
  if (after !== undefined) {
60
- yield* hooked(() => after(engine)).pipe(Effect.updateContext(Context.omit(Tracer.ParentSpan)));
66
+ return yield* hooked(() => after(engine)).pipe(Effect.updateContext(Context.omit(Tracer.ParentSpan)));
61
67
  }
68
+ return undefined;
69
+ });
70
+ function remaining(index: number): Effect.Effect<unknown, unknown, unknown> {
71
+ const name = definition.stages[index];
72
+ if (name === undefined) {
73
+ return body.pipe(Effect.tapCause(onFailure));
74
+ }
75
+ return stage(name).pipe(
76
+ Effect.tapCause(onFailure),
77
+ Effect.flatMap((services) => (Context.isContext(services) ? remaining(index + 1).pipe(Effect.provideContext(services)) : remaining(index + 1))),
78
+ );
62
79
  }
80
+ return yield* remaining(0);
63
81
  });
@@ -2,17 +2,17 @@ import * as Cause from "effect/Cause";
2
2
  import * as Context from "effect/Context";
3
3
  import * as Effect from "effect/Effect";
4
4
  import * as Tracer from "effect/Tracer";
5
- import type { TestContext } from "vitest";
6
- import { callSite } from "#internal/callSite.ts";
7
- import { hooked } from "#internal/hooked.ts";
8
- import { narrate, narrateCreation } from "#internal/narration.ts";
9
- import { runUntil } from "#internal/runUntil.ts";
10
- import { type LooseDefinition, type LooseStory, type LooseTrait, seed } from "#internal/seed.ts";
5
+ import { callSite } from "#server/adapters/callSite.ts";
6
+ import type { FailureContext } from "#server/adapters/storyFailure.ts";
7
+ import { hooked } from "#server/internal/hooked.ts";
8
+ import { narrate, narrateCreation } from "#server/internal/narration.ts";
9
+ import { runUntil } from "#server/internal/runUntil.ts";
10
+ import { type LooseDefinition, type LooseStory, type LooseTrait, seed } from "#server/internal/seed.ts";
11
11
 
12
12
  export const start = Effect.fnUntraced(function* (
13
13
  definition: LooseDefinition,
14
14
  given: readonly LooseTrait[],
15
- context: TestContext,
15
+ context: FailureContext,
16
16
  body: (told: object) => Effect.Effect<unknown, unknown, unknown>,
17
17
  ) {
18
18
  const engine = yield* hooked(definition.create).pipe(
@@ -20,8 +20,7 @@ export const start = Effect.fnUntraced(function* (
20
20
  Effect.tapCause(() => narrateCreation(definition.name, context)),
21
21
  );
22
22
  const { narration, captureFailure } = yield* narrate({ engine, inspect: definition.inspect, name: definition.name }, context);
23
- return yield* Effect.gen(function* () {
24
- yield* seed(definition, engine, narration, given);
23
+ const bodyEffect = Effect.suspend(() => {
25
24
  const story: LooseStory = {
26
25
  engine,
27
26
  lines: narration.lines,
@@ -32,7 +31,7 @@ export const start = Effect.fnUntraced(function* (
32
31
  },
33
32
  tell: narration.tell,
34
33
  };
35
- return yield* body(
34
+ return body(
36
35
  Object.defineProperties(
37
36
  {},
38
37
  {
@@ -41,5 +40,6 @@ export const start = Effect.fnUntraced(function* (
41
40
  },
42
41
  ),
43
42
  );
44
- }).pipe(Effect.tapCause((cause) => captureFailure(Cause.prettyErrors(cause)[0]?.stack)));
43
+ });
44
+ return yield* seed(definition, engine, narration, given, bodyEffect, (cause) => captureFailure(Cause.prettyErrors(cause)[0]?.stack));
45
45
  });
@@ -3,15 +3,16 @@ import type { TestContext } from "@effect/vitest";
3
3
  import * as Effect from "effect/Effect";
4
4
  import * as Layer from "effect/Layer";
5
5
  import * as TestCrypto from "effect/testing/TestCrypto";
6
- import { makeEffectIt } from "@shivaedev/test/makeEffectIt.ts";
6
+ import { makeEffectIt } from "@shivaedev/test/adapters/makeEffectIt.ts";
7
7
  import type { EffectTest, EffectTestOptions } from "@shivaedev/test/types.ts";
8
- import { freshDocument, inDom } from "#internal/domDocument.ts";
9
- import { type Genre, genreOf } from "#internal/genre.ts";
10
- import { type AnyEffect, hooked } from "#internal/hooked.ts";
11
- import type { LooseDefinition, LooseTrait } from "#internal/seed.ts";
12
- import { start } from "#internal/start.ts";
13
- import { withWatchedClock } from "#internal/withWatchedClock.ts";
14
- import { routeOutbound } from "#routeOutbound.ts";
8
+ import { declareGenre } from "#server/adapters/declareGenre.ts";
9
+ import { freshDocument, inDom } from "#server/internal/domDocument.ts";
10
+ import { type Genre, genreOf } from "#server/internal/genre.ts";
11
+ import { type AnyEffect, hooked } from "#server/internal/hooked.ts";
12
+ import type { LooseDefinition, LooseTrait } from "#server/internal/seed.ts";
13
+ import { start } from "#server/internal/start.ts";
14
+ import { withWatchedClock } from "#server/internal/withWatchedClock.ts";
15
+ import { routeOutbound } from "#server/routeOutbound.ts";
15
16
 
16
17
  type LooseBody = (told: object, context: TestContext) => Generator<AnyEffect, unknown, never> | undefined;
17
18
 
@@ -25,34 +26,14 @@ export interface LooseIt extends LooseTest {
25
26
  readonly skipIf: (condition: unknown) => LooseTest;
26
27
  }
27
28
 
28
- function withTags(options: number | EffectTestOptions | undefined, tags: readonly string[]): EffectTestOptions {
29
- if (typeof options === "number") {
30
- return { tags: [...tags], timeout: options };
31
- }
32
- const own = options?.tags ?? [];
33
- return { ...options, tags: [...tags, ...(typeof own === "string" ? [own] : own)] };
34
- }
35
-
36
29
  function storyOf(definition: LooseDefinition, given: readonly LooseTrait[], body: LooseBody | undefined) {
37
30
  return function* story(_harness: unknown, context: TestContext) {
38
31
  return yield* start(definition, given, context, (told) => hooked(() => body?.(told, context)));
39
32
  };
40
33
  }
41
34
 
42
- // Vitest refuses a tag its config does not declare, so a genre the config leaves out names the test without tagging it.
43
35
  function declaring(definition: LooseDefinition, genre: Genre, declare: EffectTest<unknown, unknown>): LooseTest {
44
- return (name, given, body, options) => {
45
- const title = `${genre.title}: ${name}`;
46
- const story = storyOf(definition, given, body);
47
- try {
48
- declare(title, story, withTags(options, [genre.tag.name]));
49
- } catch (error) {
50
- if (!(error instanceof Error && error.message.includes(`"${genre.tag.name}"`))) {
51
- throw error;
52
- }
53
- declare(title, story, withTags(options, []));
54
- }
55
- };
36
+ return (name, given, body, options) => declareGenre(declare, `${genre.title}: ${name}`, storyOf(definition, given, body), options, genre.tag.name);
56
37
  }
57
38
 
58
39
  export function storyIt(definition: LooseDefinition): LooseIt {
@@ -0,0 +1,7 @@
1
+ import type { ScreenTarget } from "#server/screenDriver.ts";
2
+
3
+ export function targetName(target: ScreenTarget): string {
4
+ return typeof target === "string"
5
+ ? target
6
+ : `${target.role} named ${typeof target.name === "string" ? JSON.stringify(target.name) : String(target.name)}`;
7
+ }
@@ -1,4 +1,4 @@
1
- import { callSite } from "#internal/callSite.ts";
1
+ import { callSite } from "#server/adapters/callSite.ts";
2
2
 
3
3
  export interface TraitPart<TStage extends string, TApply> {
4
4
  readonly apply: TApply;
@@ -1,44 +1,26 @@
1
1
  import * as Effect from "effect/Effect";
2
2
  import * as Queue from "effect/Queue";
3
3
  import * as Result from "effect/Result";
4
- import * as Stream from "effect/Stream";
5
- import { isClientIdle } from "@shivaedev/contract/clientActivity.ts";
6
- import { screenAct } from "#adapters/screenAct.ts";
7
- import { screenMutations } from "#adapters/screenMutations.ts";
8
- import type { ScreenDriverOptions } from "#screenDriver.ts";
4
+ import { screenAct } from "#server/adapters/screenAct.ts";
5
+ import { screenMutations } from "#server/adapters/screenMutations.ts";
6
+ import type { ScreenDriverOptions } from "#server/screenDriver.ts";
7
+ import { observeScreen } from "./observeScreen.ts";
9
8
 
10
9
  type WaitOptions = Required<Pick<ScreenDriverOptions, "act">> & {
11
- readonly pending: ScreenDriverOptions["pending"];
10
+ readonly activity?: ScreenDriverOptions["activity"];
11
+ readonly pending?: ScreenDriverOptions["pending"];
12
+ readonly transport?: ScreenDriverOptions["transport"];
12
13
  readonly root: () => HTMLElement;
13
14
  };
14
15
 
15
- const observePending = Effect.fnUntraced(function* (pending: ScreenDriverOptions["pending"], changes: Queue.Queue<void>) {
16
- if (pending === undefined) {
17
- return Effect.succeed(false);
18
- }
19
- if (typeof pending === "function") {
20
- return Effect.sync(pending);
21
- }
22
- let busy = true;
23
- const states = "current" in pending ? Stream.map(pending, (state) => !isClientIdle(state)) : pending;
24
- yield* states.pipe(
25
- Stream.runForEach((value) =>
26
- Effect.sync(() => {
27
- busy = value;
28
- Queue.offerUnsafe(changes, undefined);
29
- }),
30
- ),
31
- Effect.forkScoped,
32
- );
33
- return "current" in pending ? Effect.map(pending.current, (state) => !isClientIdle(state)) : Effect.sync(() => busy);
34
- });
35
-
36
- export const waitForScreen = Effect.fnUntraced(function* <A, E>({ act, pending, root }: WaitOptions, read: Effect.Effect<A, E>) {
16
+ export const waitForScreen = Effect.fnUntraced(function* <A, E>(options: WaitOptions, read: Effect.Effect<A, E>) {
17
+ const { act, root } = options;
18
+ const supplied = options.pending !== undefined || options.activity !== undefined || options.transport !== undefined;
37
19
  const changes = yield* Queue.sliding<void>(1);
38
20
  yield* screenMutations(root(), () => Queue.offerUnsafe(changes, undefined));
39
- const isBusy = yield* observePending(pending, changes);
21
+ const isBusy = yield* observeScreen(options, changes);
40
22
  do {
41
- if (pending !== undefined) {
23
+ if (supplied) {
42
24
  yield* screenAct(act, Effect.void);
43
25
  }
44
26
  if (!(yield* isBusy)) {
@@ -47,6 +29,6 @@ export const waitForScreen = Effect.fnUntraced(function* <A, E>({ act, pending,
47
29
  return result.success;
48
30
  }
49
31
  }
50
- yield* pending === undefined ? Queue.take(changes) : screenAct(act, Queue.take(changes));
32
+ yield* supplied ? screenAct(act, Queue.take(changes)) : Queue.take(changes);
51
33
  } while (true);
52
34
  }, Effect.scoped);
@@ -1,6 +1,6 @@
1
1
  import * as Clock from "effect/Clock";
2
2
  import * as Effect from "effect/Effect";
3
- import { watchedClock } from "#watchedClock.ts";
3
+ import { watchedClock } from "#server/watchedClock.ts";
4
4
 
5
5
  export function withWatchedClock<A, E, R>(effect: Effect.Effect<A, E, R>) {
6
6
  return Clock.clockWith((clock) =>
@@ -1,21 +1,10 @@
1
- import { createInterface } from "node:readline";
2
1
  import type { Readable } from "node:stream";
3
2
  import * as Effect from "effect/Effect";
4
- import { recordedSignals } from "#internal/recordedSignals.ts";
5
- import { type UntilOptions, until } from "#until.ts";
3
+ import { recordLines } from "#server/adapters/recordLines.ts";
4
+ import { type UntilOptions, until } from "#server/until.ts";
6
5
 
7
6
  export const lineSignals = Effect.fnUntraced(function* (output: Readable) {
8
- const signals = recordedSignals<string, Error>();
9
- yield* Effect.acquireRelease(
10
- Effect.sync(() => {
11
- const reader = createInterface({ crlfDelay: Number.POSITIVE_INFINITY, input: output });
12
- reader.on("line", signals.push);
13
- reader.once("close", () => signals.end());
14
- reader.on("error", signals.end);
15
- return reader;
16
- }),
17
- (reader) => Effect.sync(() => reader.close()),
18
- );
7
+ const signals = yield* recordLines(output);
19
8
  return {
20
9
  get lines(): readonly string[] {
21
10
  return signals.values.slice();
@@ -0,0 +1,15 @@
1
+ import * as Effect from "effect/Effect";
2
+ import type { ReactNode } from "react";
3
+
4
+ export const mountApp = Effect.fn("BrowserStory.mountApp")(function* <A, E, R>(options: {
5
+ readonly create: Effect.Effect<A, E, R>;
6
+ readonly render: (app: A) => ReactNode;
7
+ }) {
8
+ const app = yield* options.create;
9
+ const { render } = yield* Effect.promise(() => import("#client/adapters/react.ts"));
10
+ const view = yield* Effect.acquireRelease(
11
+ Effect.promise(() => render(options.render(app))),
12
+ (mounted) => Effect.promise(mounted.unmount),
13
+ );
14
+ return { app, ...view };
15
+ });
@@ -1,11 +1,11 @@
1
- import { createServer, type IncomingHttpHeaders } from "node:http";
1
+ import type { IncomingHttpHeaders } from "node:http";
2
2
  import * as Effect from "effect/Effect";
3
3
  import type { OtlpTracer } from "effect/observability";
4
- import { receiveOtlp } from "#adapters/receiveOtlp.ts";
5
- import { loopbackServer } from "#internal/loopback.ts";
6
- import type { otlpReadout } from "#internal/otlpReadout.ts";
7
- import { recordedSignals } from "#internal/recordedSignals.ts";
8
- import { type UntilOptions, until } from "#until.ts";
4
+ import { loopbackServer } from "#server/adapters/loopback.ts";
5
+ import { otlpServer } from "#server/adapters/receiveOtlp.ts";
6
+ import type { otlpReadout } from "#server/internal/otlpReadout.ts";
7
+ import { recordedSignals } from "#server/internal/recordedSignals.ts";
8
+ import { type UntilOptions, until } from "#server/until.ts";
9
9
 
10
10
  export type OtlpSpan = ReturnType<typeof otlpReadout>[number];
11
11
  export type OtlpTracerOptions = Omit<Parameters<typeof OtlpTracer.layer>[0], "url" | "compression">;
@@ -24,10 +24,10 @@ export interface OtlpReceiverOptions {
24
24
  export const otlpReceiver = Effect.fnUntraced(function* (options: OtlpReceiverOptions = {}) {
25
25
  const requests: OtlpExport[] = [];
26
26
  const signals = recordedSignals<OtlpSpan>();
27
- const server = createServer((request, response) => receiveOtlp(request, response, requests, signals.push, options));
27
+ const server = yield* otlpServer(requests, signals.push, options);
28
28
  const url = yield* loopbackServer(server);
29
- const { otlpTracing } = yield* Effect.promise(() => import("#internal/otlpTracing.ts"));
30
- const { errors, exportsSecret, queries } = yield* Effect.promise(() => import("#internal/otlpReadouts.ts"));
29
+ const { otlpTracing } = yield* Effect.promise(() => import("#server/internal/otlpTracing.ts"));
30
+ const { errors, exportsSecret, queries } = yield* Effect.promise(() => import("#server/internal/otlpReadouts.ts"));
31
31
  yield* Effect.addFinalizer(() => Effect.sync(() => signals.end()));
32
32
  return {
33
33
  ...otlpTracing(`${url}${options.path ?? "/v1/traces"}`, signals.stream),
@@ -1,16 +1,7 @@
1
1
  import * as Effect from "effect/Effect";
2
- import { type DeeplyAllowMatchers, expect } from "vitest";
3
- import type { NumericBound } from "#adapters/outcomeMatchers.ts";
2
+ import { assertOutcomes, type Expected } from "#server/adapters/assertOutcomes.ts";
4
3
 
5
4
  type AnyReadout = Effect.Effect<unknown, unknown, unknown>;
6
- type NativeMatcher = Exclude<DeeplyAllowMatchers<number>, number>;
7
- type Expected<T> =
8
- | NativeMatcher
9
- | (T extends readonly unknown[]
10
- ? { readonly [TKey in keyof T]: Expected<T[TKey]> }
11
- : T extends object
12
- ? { readonly [TKey in keyof T]?: Expected<T[TKey]> }
13
- : T | (T extends number ? NumericBound : never));
14
5
 
15
6
  export const outcomes = Effect.fn("Story.outcomes")(check);
16
7
 
@@ -26,5 +17,5 @@ function* check(rows: readonly (readonly [string, () => AnyReadout, unknown])[])
26
17
  actual.push({ [label]: yield* Effect.suspend(readout) });
27
18
  expected.push({ [label]: value });
28
19
  }
29
- expect(actual).toMatchObject(expected);
20
+ yield* assertOutcomes(actual, expected);
30
21
  }
@@ -1,6 +1,6 @@
1
1
  import * as Effect from "effect/Effect";
2
- import { installOutbound } from "#adapters/installOutbound.ts";
3
- import { inDom } from "#internal/domDocument.ts";
2
+ import { installOutbound } from "#server/adapters/installOutbound.ts";
3
+ import { inDom } from "#server/internal/domDocument.ts";
4
4
 
5
5
  export function routeOutbound(routes: Readonly<Record<string, string>>, options: { readonly passthrough?: boolean } = {}) {
6
6
  return Effect.acquireRelease(
@@ -1,35 +1,38 @@
1
1
  import * as Data from "effect/Data";
2
2
  import * as Effect from "effect/Effect";
3
3
  import type * as Stream from "effect/Stream";
4
- import type { ClientActivity } from "@shivaedev/contract/clientActivity.ts";
5
4
  import { withLive } from "@shivaedev/test/withLive.ts";
6
- import { screenAct } from "#adapters/screenAct.ts";
7
- import { screenElements } from "#adapters/screenElements.ts";
8
- import { nextClientHint } from "#internal/nextClientHint.ts";
9
- import { targetName } from "#internal/screenAccessibility.ts";
10
- import { screenReadouts } from "#internal/screenReadouts.ts";
11
- import { screenWaits } from "#internal/screenWaits.ts";
12
- import type { SignalNotReceived } from "#until.ts";
5
+ import { directScreenAct, screenAct, screenPerform } from "#server/adapters/screenAct.ts";
6
+ import { screenElements } from "#server/adapters/screenElements.ts";
7
+ import { nextScreenHint } from "#server/internal/nextScreenHint.ts";
8
+ import { screenInteractions } from "#server/internal/screenInteractions.ts";
9
+ import { screenReadouts } from "#server/internal/screenReadouts.ts";
10
+ import { screenWaits } from "#server/internal/screenWaits.ts";
11
+ import { targetName } from "#server/internal/targetName.ts";
12
+ import type { ScreenSignal } from "#server/screenSignal.ts";
13
+ import type { SignalNotReceived } from "#server/until.ts";
13
14
 
14
15
  export type ScreenTarget = string | { readonly role: string; readonly name: string | RegExp };
15
16
 
16
17
  export interface ScreenDriverOptions {
17
18
  readonly act?: (action: () => Promise<void>) => PromiseLike<void>;
19
+ readonly activity?: ScreenSignal;
18
20
  readonly loadingTimeoutMs?: number;
19
- readonly pending?: (() => boolean) | Stream.Stream<boolean> | ClientActivity;
21
+ readonly pending?: (() => boolean) | Stream.Stream<boolean> | ScreenSignal;
20
22
  readonly root: HTMLElement | (() => HTMLElement);
21
23
  readonly tell: (line: string) => void;
22
24
  readonly timeoutMs?: number;
25
+ readonly transport?: ScreenDriverOptions["pending"];
23
26
  }
24
27
 
25
28
  export class MissingScreenPending extends Data.TaggedError("MissingScreenPending") {
26
29
  override readonly message =
27
- "Cannot settle the screen without the pending option.\nhelp: Supply pending: () => boolean that reads the application's pending work and stays true until its resulting screen work is ready to render.";
30
+ "Cannot settle the screen without a completion signal.\nhelp: Supply pending, activity or transport that stays busy until the resulting screen work is ready to render.";
28
31
  }
29
32
 
30
33
  export class MissingClientActivity extends Data.TaggedError("MissingClientActivity") {
31
34
  override readonly message =
32
- "Cannot wait for a live hint without client activity.\nhelp: Supply pending: clientActivity(client) from @shivaedev/contract/clientActivity.ts.";
35
+ "Cannot wait for a live hint without client activity.\nhelp: Supply activity or pending: a ScreenSignal with current pending work and a hint sequence.";
33
36
  }
34
37
 
35
38
  export type ScreenDriver<E = never, THintError = MissingClientActivity | SignalNotReceived> = Omit<
@@ -42,8 +45,13 @@ export type ScreenDriver<E = never, THintError = MissingClientActivity | SignalN
42
45
  within: (container: ScreenTarget | HTMLElement) => ScreenDriver<E, THintError>;
43
46
  };
44
47
 
45
- export function screenDriver(options: ScreenDriverOptions & { readonly pending: ClientActivity }): ScreenDriver<never, SignalNotReceived>;
46
- export function screenDriver(options: ScreenDriverOptions & { readonly pending: (() => boolean) | Stream.Stream<boolean> }): ScreenDriver;
48
+ export function screenDriver(
49
+ options: ScreenDriverOptions & ({ readonly pending: ScreenSignal } | { readonly activity: ScreenSignal }),
50
+ ): ScreenDriver<never, SignalNotReceived>;
51
+ export function screenDriver(
52
+ options: ScreenDriverOptions &
53
+ ({ readonly pending: (() => boolean) | Stream.Stream<boolean> } | { readonly transport: NonNullable<ScreenDriverOptions["transport"]> }),
54
+ ): ScreenDriver;
47
55
  export function screenDriver(options: ScreenDriverOptions): ScreenDriver<MissingScreenPending>;
48
56
  export function screenDriver(options: ScreenDriverOptions): ScreenDriver<MissingScreenPending> {
49
57
  return makeDriver(options, true);
@@ -74,22 +82,16 @@ function makeDriver(options: ScreenDriverOptions, dialogs: boolean, dialogOwner?
74
82
  };
75
83
  }
76
84
 
77
- function makeScreenActions(
78
- { root, pending, tell, act = (action) => action(), timeoutMs = 3000, loadingTimeoutMs = 10_000 }: ScreenDriverOptions,
79
- dialogs: boolean,
80
- ) {
85
+ function makeScreenActions(options: ScreenDriverOptions, dialogs: boolean) {
86
+ const { root, pending, activity, transport, tell, act = directScreenAct, timeoutMs = 3000, loadingTimeoutMs = 10_000 } = options;
81
87
  const currentRoot = typeof root === "function" ? root : () => root;
82
88
  const elements = screenElements(currentRoot, dialogs);
83
- const waits = screenWaits({ act, loadingTimeoutMs, pending, root: currentRoot, tell, timeoutMs }, elements, dialogs);
84
- function perform(line: string, action: () => void) {
85
- return Effect.promise(async () => {
86
- tell(line);
87
- await act(async () => action());
88
- });
89
- }
89
+ const waits = screenWaits({ ...options, act, loadingTimeoutMs, pending, root: currentRoot, timeoutMs }, elements, dialogs);
90
+ const perform = screenPerform(act, tell);
90
91
 
91
92
  return {
92
93
  ...screenReadouts(currentRoot, tell, dialogs),
94
+ ...screenInteractions(elements, perform),
93
95
  ...waits,
94
96
  click: (selector: ScreenTarget) =>
95
97
  perform(`click ${targetName(selector)}`, () => {
@@ -100,15 +102,16 @@ function makeScreenActions(
100
102
  }),
101
103
  enter: (selector: ScreenTarget, value: string) => perform(`enter a value in ${targetName(selector)}`, () => elements.enter(selector, value)),
102
104
  nextLiveHint: () => {
103
- if (pending === undefined || typeof pending === "function" || !("current" in pending)) {
105
+ const signal = activity ?? pending;
106
+ if (signal === undefined || typeof signal === "function" || !("current" in signal)) {
104
107
  return Effect.fail(new MissingClientActivity());
105
108
  }
106
- return withLive(Effect.sync(() => tell("wait for the next live hint")).pipe(Effect.andThen(screenAct(act, nextClientHint(pending)))));
109
+ return withLive(Effect.sync(() => tell("wait for the next live hint")).pipe(Effect.andThen(screenAct(act, nextScreenHint(signal)))));
107
110
  },
108
111
  select: (selector: ScreenTarget, value: string) =>
109
112
  perform(`select ${JSON.stringify(value)} in ${targetName(selector)}`, () => elements.select(selector, value)),
110
113
  settle: (settings?: { readonly timeoutMs?: number }) =>
111
- pending === undefined ? Effect.fail(new MissingScreenPending()) : waits.settle(settings),
114
+ pending === undefined && activity === undefined && transport === undefined ? Effect.fail(new MissingScreenPending()) : waits.settle(settings),
112
115
  submit: (selector: ScreenTarget = "form") => perform(`submit ${targetName(selector)}`, () => elements.form(selector).requestSubmit()),
113
116
  };
114
117
  }
@@ -0,0 +1,9 @@
1
+ import type * as Effect from "effect/Effect";
2
+ import type * as Stream from "effect/Stream";
3
+
4
+ export interface ScreenSignalState {
5
+ readonly hints: number;
6
+ readonly pending: boolean;
7
+ }
8
+
9
+ export type ScreenSignal = Stream.Stream<ScreenSignalState> & { readonly current: Effect.Effect<ScreenSignalState> };
@@ -1,13 +1,13 @@
1
1
  import type { TestContext } from "@effect/vitest";
2
2
  import type { Crypto, Effect, Layer, Scope } from "effect";
3
3
  import type { EffectClock, EffectTestOptions } from "@shivaedev/test/types.ts";
4
- import { compose } from "#internal/compose.ts";
5
- import { type ComposedKit, type Composition, type KitDefinition, type KitList, kitDefinition } from "#internal/compositionTypes.ts";
6
- import { type AnyEffect, type EffectHook, type ErrorOf, type Hook, type HookValue, hooked, type ServicesOf } from "#internal/hooked.ts";
7
- import type { AfterResults, InferredDefinition } from "#internal/hookInference.ts";
8
- import type { LooseDefinition } from "#internal/seed.ts";
9
- import { storyIt } from "#internal/storyIt.ts";
10
- import { type Parts, trait, traits } from "#internal/traits.ts";
4
+ import { compose } from "#server/internal/compose.ts";
5
+ import { type ComposedKit, type Composition, type KitDefinition, type KitList, kitDefinition } from "#server/internal/compositionTypes.ts";
6
+ import { type AnyEffect, type EffectHook, type ErrorOf, type Hook, type HookValue, hooked, type ServicesOf } from "#server/internal/hooked.ts";
7
+ import type { AfterResults, AfterServices, InferredDefinition } from "#server/internal/hookInference.ts";
8
+ import type { LooseDefinition } from "#server/internal/seed.ts";
9
+ import { storyIt } from "#server/internal/storyIt.ts";
10
+ import { type Parts, trait, traits } from "#server/internal/traits.ts";
11
11
 
12
12
  export type Trait<TEngine, TStage extends string, R = never> = Parts<TStage, (engine: TEngine) => Effect.Effect<void, unknown, R>>;
13
13
 
@@ -47,7 +47,7 @@ export interface StoryKitDefinition<
47
47
  TFailed extends AnyEffect,
48
48
  TDiagnose extends AnyEffect,
49
49
  > {
50
- readonly after?: { readonly [TKey in keyof TAfter]: EffectHook<[engine: TEngine], TAfter[TKey] & AnyEffect, void> };
50
+ readonly after?: { readonly [TKey in keyof TAfter]: EffectHook<[engine: TEngine], TAfter[TKey] & AnyEffect, unknown> };
51
51
  readonly around?: <A, E, R>(effect: Effect.Effect<A, E, R>) => Effect.Effect<A, unknown, R | NoInfer<TProvided> | Crypto.Crypto | Scope.Scope>;
52
52
  readonly clock?: EffectClock;
53
53
  readonly create: EffectHook<[], TCreate, TEngine>;
@@ -115,7 +115,7 @@ export function storyKit<
115
115
  TInspect extends (engine: HookValue<ReturnType<TCreate>>) => unknown = (engine: HookValue<ReturnType<TCreate>>) => unknown,
116
116
  >(
117
117
  definition: InferredDefinition<TCreate, TStage, TVerbs, TProvided, TAfter, TStep, TFailed, TDiagnose, TInspect>,
118
- ): StoryKit<HookValue<ReturnType<TCreate>>, TStage, TVerbs, TStep | TFailed | TDiagnose, TProvided>;
118
+ ): StoryKit<HookValue<ReturnType<TCreate>>, TStage, TVerbs, TStep | TFailed | TDiagnose, TProvided | AfterServices<TAfter>>;
119
119
  export function storyKit<const TKits extends KitList>(definition: Composition<TKits>): ComposedKit<TKits>;
120
120
  // TypeScript reports the last overload's error, so it must check both definition shapes.
121
121
  export function storyKit<
@@ -131,7 +131,7 @@ export function storyKit<
131
131
  const TKits extends KitList = KitList,
132
132
  >(
133
133
  definition: InferredDefinition<TCreate, TStage, TVerbs, TProvided, TAfter, TStep, TFailed, TDiagnose, TInspect> | Composition<TKits>,
134
- ): StoryKit<HookValue<ReturnType<TCreate>>, TStage, TVerbs, TStep | TFailed | TDiagnose, TProvided> | ComposedKit<TKits>;
134
+ ): StoryKit<HookValue<ReturnType<TCreate>>, TStage, TVerbs, TStep | TFailed | TDiagnose, TProvided | AfterServices<TAfter>> | ComposedKit<TKits>;
135
135
  export function storyKit(input: LooseDefinition | Composition<KitList>): unknown {
136
136
  const definition = "extends" in input ? compose(input.name, input.extends) : input;
137
137
  return {
@@ -4,7 +4,7 @@ import * as Effect from "effect/Effect";
4
4
  import * as Option from "effect/Option";
5
5
  import * as Stream from "effect/Stream";
6
6
  import { withLive } from "@shivaedev/test/withLive.ts";
7
- import { describeValue } from "#internal/render.ts";
7
+ import { describeValue } from "#server/internal/render.ts";
8
8
 
9
9
  export interface UntilOptions {
10
10
  readonly name: string;
@@ -4,7 +4,7 @@ import * as Effect from "effect/Effect";
4
4
  import * as Queue from "effect/Queue";
5
5
  import * as Stream from "effect/Stream";
6
6
  import * as TestClock from "effect/testing/TestClock";
7
- import { type UntilOptions, until } from "#until.ts";
7
+ import { type UntilOptions, until } from "#server/until.ts";
8
8
 
9
9
  export interface WatchedClock extends TestClock.TestClock {
10
10
  readonly sleeps: Stream.Stream<Duration.Duration>;
@@ -1,7 +0,0 @@
1
- export declare function reactRendering(): Promise<[
2
- typeof import("@effect/atom-react"),
3
- typeof import("effect/reactivity/AtomRegistry"),
4
- typeof import("react-dom/client"),
5
- typeof import("react")
6
- ]>;
7
- //# sourceMappingURL=reactRendering.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"reactRendering.d.ts","sourceRoot":"","sources":["../../../src/client/adapters/reactRendering.ts"],"names":[],"mappings":"AAAA,wBAAgB,cAAc,IAAI,OAAO,CACxC;IAAC,cAAc,oBAAoB,CAAC;IAAE,cAAc,gCAAgC,CAAC;IAAE,cAAc,kBAAkB,CAAC;IAAE,cAAc,OAAO,CAAC;CAAC,CACjJ,CAEA"}
@@ -1,4 +0,0 @@
1
- export function reactRendering() {
2
- return Promise.all([import("@effect/atom-react"), import("effect/reactivity/AtomRegistry"), import("react-dom/client"), import("react")]);
3
- }
4
- //# sourceMappingURL=reactRendering.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"reactRendering.js","sourceRoot":"","sources":["../../../src/client/adapters/reactRendering.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,cAAc;IAG7B,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC,gCAAgC,CAAC,EAAE,MAAM,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAC3I,CAAC"}
@@ -1,2 +0,0 @@
1
- export declare function waitForReact(): Promise<void>;
2
- //# sourceMappingURL=waitForReact.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"waitForReact.d.ts","sourceRoot":"","sources":["../../../src/client/adapters/waitForReact.ts"],"names":[],"mappings":"AAAA,wBAAsB,YAAY,kBAMjC"}
@@ -1,8 +0,0 @@
1
- export async function waitForReact() {
2
- const { act } = await import("react");
3
- // Responses and React updates must settle together inside act.
4
- await act(async () => {
5
- await new Promise((resolve) => setTimeout(resolve, 10));
6
- });
7
- }
8
- //# sourceMappingURL=waitForReact.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"waitForReact.js","sourceRoot":"","sources":["../../../src/client/adapters/waitForReact.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,KAAK,UAAU,YAAY;IACjC,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;IACtC,+DAA+D;IAC/D,MAAM,GAAG,CAAC,KAAK,IAAI,EAAE;QACpB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;AACJ,CAAC"}