@seriousgaming/sdk-tools 1.4.0 → 1.6.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 (302) hide show
  1. package/dist/bundling/ui-bundler.d.ts +12 -0
  2. package/dist/cli-25RWY5BQ.js +41 -0
  3. package/dist/cli-272KBNJH.js +97 -0
  4. package/dist/cli-2BH7FX27.js +52 -0
  5. package/dist/cli-2GOFEW26.js +81 -0
  6. package/dist/cli-3E3MD5U4.js +21 -0
  7. package/dist/cli-3HE4AVZG.js +115 -0
  8. package/dist/cli-4AKVLEC4.js +1387 -0
  9. package/dist/cli-4BV45LBH.js +126 -0
  10. package/dist/cli-4LKXZQ2B.js +48 -0
  11. package/dist/cli-4UWFQNGF.js +54 -0
  12. package/dist/cli-4YB3ROVR.js +78 -0
  13. package/dist/cli-57RXC3HQ.js +36 -0
  14. package/dist/cli-5JEGTVTG.js +96 -0
  15. package/dist/cli-6AMT3BUO.js +97 -0
  16. package/dist/cli-6RRVEGFB.js +80 -0
  17. package/dist/cli-6WXLXJVX.js +36 -0
  18. package/dist/cli-7OGYADZ3.js +97 -0
  19. package/dist/cli-AK7OIPWY.js +229 -0
  20. package/dist/cli-B4TN6PJP.js +124 -0
  21. package/dist/cli-B6YHEKIJ.js +248 -0
  22. package/dist/cli-BPYMTOUL.js +89 -0
  23. package/dist/cli-BWX5E7TQ.js +23 -0
  24. package/dist/cli-BYJWFFCF.js +37 -0
  25. package/dist/cli-C3NVCKO6.js +43 -0
  26. package/dist/cli-C47GJATR.js +42 -0
  27. package/dist/cli-C5QOJJWX.js +46 -0
  28. package/dist/cli-C6TH5S7K.js +6417 -0
  29. package/dist/cli-DL2CVMRF.js +89 -0
  30. package/dist/cli-DMW2OQIJ.js +76 -0
  31. package/dist/cli-DZW3XD5F.js +143 -0
  32. package/dist/cli-E2NLWIFE.js +1331 -0
  33. package/dist/cli-E33CJRRQ.js +36 -0
  34. package/dist/cli-E6DJIMYD.js +142 -0
  35. package/dist/cli-EEFJKIGL.js +151 -0
  36. package/dist/cli-EVFS55WN.js +185 -0
  37. package/dist/cli-F2D4GGUA.js +549 -0
  38. package/dist/cli-FBTRTIZJ.js +226 -0
  39. package/dist/cli-FWFRKQNE.js +11 -0
  40. package/dist/cli-FYINNRML.js +760 -0
  41. package/dist/cli-G522CPRL.js +88 -0
  42. package/dist/cli-G6KELFSX.js +2847 -0
  43. package/dist/cli-G6UE5NL4.js +90 -0
  44. package/dist/cli-GBFM76BF.js +16 -0
  45. package/dist/cli-GDQ6ILJY.js +101 -0
  46. package/dist/cli-GFBGYFYD.js +50 -0
  47. package/dist/cli-GGPDQNM3.js +35 -0
  48. package/dist/cli-GTSGLN3Z.js +307 -0
  49. package/dist/cli-GUXKQMJ7.js +13641 -0
  50. package/dist/cli-GXD36NF2.js +60 -0
  51. package/dist/cli-HCRTYQQS.js +16 -0
  52. package/dist/cli-HYY64SUD.js +185 -0
  53. package/dist/cli-I355WTAF.js +463 -0
  54. package/dist/cli-IDKYF5XB.js +59 -0
  55. package/dist/cli-ILKCQNM6.js +8 -0
  56. package/dist/cli-IRZ5KB7D.js +36 -0
  57. package/dist/cli-IUS2YCD3.js +31 -0
  58. package/dist/cli-J4DKUUTK.js +138 -0
  59. package/dist/cli-JFU22EJ2.js +187 -0
  60. package/dist/cli-JMZLT65J.js +226 -0
  61. package/dist/cli-JZM7XTNV.js +89 -0
  62. package/dist/cli-K2B6WHKA.js +81 -0
  63. package/dist/cli-KL3756X6.js +126 -0
  64. package/dist/cli-KNOOKGYW.js +88 -0
  65. package/dist/cli-LFGRFIEO.js +226 -0
  66. package/dist/cli-LFM7GJHI.js +0 -0
  67. package/dist/cli-LMDJCHHD.js +304 -0
  68. package/dist/cli-LXYPE3L5.js +99 -0
  69. package/dist/cli-M6BCQRID.js +153 -0
  70. package/dist/cli-MBNMPVDC.js +367 -0
  71. package/dist/cli-MJUYJIEP.js +13 -0
  72. package/dist/cli-MMN4BPO4.js +145 -0
  73. package/dist/cli-MYJGMA6U.js +40 -0
  74. package/dist/cli-N6H6T2E2.js +616 -0
  75. package/dist/cli-O5KP4OVN.js +61 -0
  76. package/dist/cli-O6PWMJTZ.js +25 -0
  77. package/dist/cli-ORIG557O.js +141 -0
  78. package/dist/cli-PFFCNGHI.js +243 -0
  79. package/dist/cli-PNLYX6R6.js +131 -0
  80. package/dist/cli-PQBXVLEU.js +649 -0
  81. package/dist/cli-PTT5RGKO.js +62 -0
  82. package/dist/cli-Q2XJF5AS.js +127 -0
  83. package/dist/cli-QEVDDBNO.js +60 -0
  84. package/dist/cli-QEVE5HUM.js +167 -0
  85. package/dist/cli-QUIJCBYB.js +391 -0
  86. package/dist/cli-QUNIRH7A.js +57 -0
  87. package/dist/cli-QVASWX2A.js +187 -0
  88. package/dist/cli-QWQMPCL6.js +253 -0
  89. package/dist/cli-R4PCG5YX.js +131 -0
  90. package/dist/cli-RA673NGF.js +53 -0
  91. package/dist/cli-RN6IWTL2.js +36 -0
  92. package/dist/cli-ROT3DRKU.js +145 -0
  93. package/dist/cli-RZITKPJX.js +367 -0
  94. package/dist/cli-S5IVGDDD.js +32 -0
  95. package/dist/cli-S5QDONIQ.js +218 -0
  96. package/dist/cli-SIPDUBFL.js +36 -0
  97. package/dist/cli-SMFSZF2G.js +4009 -0
  98. package/dist/cli-SRHBXZCN.js +159 -0
  99. package/dist/cli-TCY5LJ7E.js +88 -0
  100. package/dist/cli-TDSQSCX4.js +131 -0
  101. package/dist/cli-TIDQ4WUE.js +257 -0
  102. package/dist/cli-TLLA6KAP.js +79 -0
  103. package/dist/cli-TPU4TUR6.js +132 -0
  104. package/dist/cli-U2UE7I7J.js +30 -0
  105. package/dist/cli-UELGBQG7.js +101 -0
  106. package/dist/cli-UHSZBKYO.js +97 -0
  107. package/dist/cli-UJ4UCL2Z.js +38 -0
  108. package/dist/cli-UKQYZYFK.js +31 -0
  109. package/dist/cli-UMFFURZ7.js +81 -0
  110. package/dist/cli-UNAJ2OTE.js +15 -0
  111. package/dist/cli-UNJ5X6BU.js +89 -0
  112. package/dist/cli-UTJU4IYG.js +117 -0
  113. package/dist/cli-V4GHRWOV.js +1837 -0
  114. package/dist/cli-VCI3CG36.js +73 -0
  115. package/dist/cli-VCKOC2EV.js +256 -0
  116. package/dist/cli-VL2P354N.js +46 -0
  117. package/dist/cli-WAE26SVW.js +72 -0
  118. package/dist/cli-WOGIAU2E.js +100 -0
  119. package/dist/cli-WU43JT4T.js +52 -0
  120. package/dist/cli-XCO2VQOH.js +122 -0
  121. package/dist/cli-XSVGKI3R.js +39 -0
  122. package/dist/cli-YOTGR3NB.js +82 -0
  123. package/dist/cli-YVVXUD2G.js +197 -0
  124. package/dist/cli-ZISJ36MM.js +89 -0
  125. package/dist/cli-ZTWOE3ZT.js +65 -0
  126. package/dist/cli-ZVSFYDPQ.js +205 -0
  127. package/dist/cli-ZWPYIXNI.js +68 -0
  128. package/dist/cli.js +171 -42385
  129. package/dist/client/build-surfaces.d.ts +33 -0
  130. package/dist/client/dev-server.d.ts +6 -0
  131. package/dist/client/index.d.ts +1 -0
  132. package/dist/client/playwright.d.ts +62 -0
  133. package/dist/client.js +339 -56
  134. package/dist/core/session.d.ts +15 -1
  135. package/dist/dev/console/assets/{index-BvB-LFQZ.js → index-CuMOOH9m.js} +21 -21
  136. package/dist/dev/console/index.html +1 -1
  137. package/dist/dev/public-origins.d.ts +61 -0
  138. package/dist/dev/shell.d.ts +51 -4
  139. package/dist/dev/surfaces.d.ts +7 -0
  140. package/dist/docs/ai-agents.md +5 -0
  141. package/dist/docs/api/index.md +14 -12
  142. package/dist/docs/api/sdk-tools-client.md +29 -0
  143. package/dist/docs/api/sdk-tools-playwright.md +104 -0
  144. package/dist/docs/changelog-0.x.md +2 -2
  145. package/dist/docs/changelog.md +56 -4
  146. package/dist/docs/cli-and-dev-server.md +79 -0
  147. package/dist/docs/cli-error-codes.md +39 -36
  148. package/dist/docs/cli-reference.md +93 -32
  149. package/dist/docs/environment-variables.md +16 -5
  150. package/dist/docs/guides/ai-facilitation.md +2 -0
  151. package/dist/docs/guides/capabilities.md +2 -0
  152. package/dist/docs/guides/designing-a-game.md +31 -4
  153. package/dist/docs/guides/designing-screens.md +133 -0
  154. package/dist/docs/guides/endpoints.md +2 -0
  155. package/dist/docs/guides/engine-testing.md +5 -1
  156. package/dist/docs/guides/engine.md +2 -0
  157. package/dist/docs/guides/file-handling.md +3 -1
  158. package/dist/docs/guides/games.md +3 -1
  159. package/dist/docs/guides/global-settings.md +2 -0
  160. package/dist/docs/guides/guide.md +2 -0
  161. package/dist/docs/guides/hooks.md +2 -0
  162. package/dist/docs/guides/index.md +9 -0
  163. package/dist/docs/guides/internationalization.md +2 -0
  164. package/dist/docs/guides/llm-integration.md +4 -2
  165. package/dist/docs/guides/multi-team-games.md +3 -1
  166. package/dist/docs/guides/patterns.md +2 -0
  167. package/dist/docs/guides/presentation.md +1 -1
  168. package/dist/docs/guides/production-constraints.md +2 -0
  169. package/dist/docs/guides/scenario-editor.md +2 -0
  170. package/dist/docs/guides/scenarios.md +6 -2
  171. package/dist/docs/guides/session-game-flow.md +365 -0
  172. package/dist/docs/guides/session-hooks.md +205 -0
  173. package/dist/docs/guides/session.md +27 -565
  174. package/dist/docs/guides/settings.md +2 -0
  175. package/dist/docs/guides/setup.md +3 -1
  176. package/dist/docs/guides/speech-generation.md +2 -0
  177. package/dist/docs/guides/starter-game.md +63 -23
  178. package/dist/docs/guides/testing.md +35 -18
  179. package/dist/docs/guides/tick-controller.md +3 -1
  180. package/dist/docs/guides/type-safety.md +2 -0
  181. package/dist/docs/guides/ui-files-and-llms.md +328 -0
  182. package/dist/docs/guides/ui-participants.md +281 -0
  183. package/dist/docs/guides/ui-styling.md +263 -0
  184. package/dist/docs/guides/ui-ticks.md +247 -0
  185. package/dist/docs/guides/ui.md +11 -1092
  186. package/dist/docs/guides/upgrading.md +2 -0
  187. package/dist/docs/guides/validators.md +2 -0
  188. package/dist/docs/guides/waiting-room.md +1 -1
  189. package/dist/docs/index.md +2 -1
  190. package/dist/docs/page-index.md +146 -0
  191. package/dist/docs/recipes/adapt-a-game-for-walkthroughs.md +1 -1
  192. package/dist/docs/recipes/adapt-ui-for-observers.md +1 -1
  193. package/dist/docs/recipes/create-presentation.md +11 -0
  194. package/dist/docs/recipes/create-scenario-editor.md +1 -0
  195. package/dist/docs/recipes/create-session-ui.md +2 -1
  196. package/dist/docs/recipes/create-setup.md +1 -0
  197. package/dist/docs/recipes/create-user-interface.md +1 -0
  198. package/dist/docs/recipes/create-waiting-room-ui.md +1 -0
  199. package/dist/docs/recipes/design-state-for-concurrent-writes.md +1 -1
  200. package/dist/docs/recipes/e2e-testing.md +19 -20
  201. package/dist/docs/recipes/fix-duplicate-packages.md +2 -2
  202. package/dist/docs/recipes/index.md +3 -0
  203. package/dist/docs/recipes/screenshot-a-surface.md +80 -0
  204. package/dist/docs/recipes/test-a-multi-role-game.md +1 -1
  205. package/dist/docs/recipes/use-request-tick.md +2 -2
  206. package/dist/execution/config-resolver.d.ts +4 -1
  207. package/dist/playwright.js +32232 -0
  208. package/dist/runtime/manifest-version.d.ts +1 -1
  209. package/dist/runtime.js +1 -1
  210. package/dist/templates/package/CLAUDE.md.template +14 -5
  211. package/dist/templates/package/DESIGN.md.liquid +39 -7
  212. package/dist/templates/package/README.md.liquid +1 -1
  213. package/dist/templates/package/claude/rules/workflow-create-user-interface.md +1 -1
  214. package/dist/templates/package/claude/rules/workflow-test-engine-or-ui.md +1 -1
  215. package/dist/templates/package/global-setup.ts.template +7 -18
  216. package/dist/templates/package/playwright.config.ts.liquid +8 -11
  217. package/dist/templates/package/pnpm-workspace.yaml.template +13 -0
  218. package/dist/templates/starter-game/capabilities/pacing/capability.sdk.json +18 -0
  219. package/dist/templates/starter-game/package.json +2 -0
  220. package/dist/templates/starter-game/playwright.config.ts +8 -11
  221. package/dist/templates/starter-game/presentation/defaults.ts +52 -0
  222. package/dist/templates/starter-game/presentation/index.html +20 -0
  223. package/dist/templates/starter-game/presentation/presentation.sdk.json +10 -0
  224. package/dist/templates/starter-game/presentation/src/App.tsx +55 -0
  225. package/dist/templates/starter-game/presentation/src/Band.tsx +40 -0
  226. package/dist/templates/starter-game/presentation/src/Slides.tsx +415 -0
  227. package/dist/templates/starter-game/presentation/src/WeatherIcon.tsx +21 -0
  228. package/dist/templates/starter-game/presentation/src/i18n.ts +88 -0
  229. package/dist/templates/starter-game/presentation/src/main.tsx +15 -0
  230. package/dist/templates/starter-game/presentation/src/stalls.test.ts +196 -0
  231. package/dist/templates/starter-game/presentation/src/stalls.ts +199 -0
  232. package/dist/templates/starter-game/presentation/types.ts +94 -0
  233. package/dist/templates/starter-game/seriousgaming.sdk.json +2 -1
  234. package/dist/templates/starter-game/session/defaults.ts +6 -0
  235. package/dist/templates/starter-game/session/index.html +1 -1
  236. package/dist/templates/starter-game/session/session.sdk.json +2 -2
  237. package/dist/templates/starter-game/session/src/App.test.tsx +436 -115
  238. package/dist/templates/starter-game/session/src/App.tsx +372 -222
  239. package/dist/templates/starter-game/session/src/JoinCodes.tsx +184 -0
  240. package/dist/templates/starter-game/session/src/ManagePanel.tsx +188 -0
  241. package/dist/templates/starter-game/session/src/Results.tsx +340 -0
  242. package/dist/templates/starter-game/session/src/SessionBar.tsx +179 -0
  243. package/dist/templates/starter-game/session/src/SessionPanels.tsx +105 -0
  244. package/dist/templates/starter-game/session/src/SidePanel.tsx +89 -0
  245. package/dist/templates/starter-game/session/src/StallCard.tsx +253 -0
  246. package/dist/templates/starter-game/session/src/TopBar.tsx +36 -0
  247. package/dist/templates/starter-game/session/src/i18n.ts +91 -24
  248. package/dist/templates/starter-game/session/src/status.ts +28 -0
  249. package/dist/templates/starter-game/session/types.ts +8 -2
  250. package/dist/templates/starter-game/shared/Awning.tsx +31 -0
  251. package/dist/templates/starter-game/shared/HostLogo.test.tsx +38 -0
  252. package/dist/templates/starter-game/shared/HostLogo.tsx +48 -0
  253. package/dist/templates/starter-game/shared/StallIcons.tsx +83 -0
  254. package/dist/templates/starter-game/shared/days.ts +11 -0
  255. package/dist/templates/starter-game/shared/format.test.ts +13 -0
  256. package/dist/templates/starter-game/{ui/src → shared}/format.ts +1 -1
  257. package/dist/templates/starter-game/testing/e2e/game.spec.ts +43 -9
  258. package/dist/templates/starter-game/testing/e2e/global-setup.ts +7 -18
  259. package/dist/templates/starter-game/ui/defaults.ts +3 -0
  260. package/dist/templates/starter-game/ui/src/App.test.tsx +197 -29
  261. package/dist/templates/starter-game/ui/src/App.tsx +176 -99
  262. package/dist/templates/starter-game/ui/src/DayBar.test.tsx +50 -7
  263. package/dist/templates/starter-game/ui/src/DayBar.tsx +96 -38
  264. package/dist/templates/starter-game/ui/src/DaysTable.tsx +69 -0
  265. package/dist/templates/starter-game/ui/src/FirstDay.tsx +37 -0
  266. package/dist/templates/starter-game/ui/src/Header.tsx +257 -0
  267. package/dist/templates/starter-game/ui/src/Lesson.tsx +63 -0
  268. package/dist/templates/starter-game/ui/src/MakeRow.tsx +98 -71
  269. package/dist/templates/starter-game/ui/src/Notices.tsx +59 -0
  270. package/dist/templates/starter-game/ui/src/PastDay.tsx +88 -0
  271. package/dist/templates/starter-game/ui/src/Section.tsx +26 -26
  272. package/dist/templates/starter-game/ui/src/ThemeToggle.tsx +25 -11
  273. package/dist/templates/starter-game/ui/src/TodayPanel.test.tsx +37 -33
  274. package/dist/templates/starter-game/ui/src/TodayPanel.tsx +66 -52
  275. package/dist/templates/starter-game/ui/src/WeatherCard.tsx +47 -0
  276. package/dist/templates/starter-game/ui/src/WeekOver.tsx +145 -0
  277. package/dist/templates/starter-game/ui/src/YesterdayPanel.tsx +65 -114
  278. package/dist/templates/starter-game/ui/src/days.ts +58 -0
  279. package/dist/templates/starter-game/ui/src/i18n.ts +86 -32
  280. package/dist/templates/starter-game/ui/src/test-helpers.ts +1 -0
  281. package/dist/templates/starter-game/ui/src/theme.ts +8 -8
  282. package/dist/templates/starter-game/ui/types.ts +6 -0
  283. package/dist/templates/starter-game/ui/ui.sdk.json +1 -1
  284. package/dist/templates/starter-game/validators/daylimit/defaults.ts +13 -0
  285. package/dist/templates/starter-game/validators/daylimit/logic/logic.test.ts +20 -0
  286. package/dist/templates/starter-game/validators/daylimit/logic/logic.ts +23 -0
  287. package/dist/templates/starter-game/validators/daylimit/types.ts +23 -0
  288. package/dist/templates/starter-game/validators/daylimit/validator.sdk.json +10 -0
  289. package/dist/templates/starter-game/waiting_room/src/App.test.tsx +83 -5
  290. package/dist/templates/starter-game/waiting_room/src/App.tsx +262 -119
  291. package/dist/templates/starter-game/waiting_room/src/i18n.ts +8 -4
  292. package/dist/utils/error-codes.d.ts +12 -0
  293. package/dist/utils/prompt.d.ts +5 -5
  294. package/dist/utils/resource-scan.d.ts +39 -0
  295. package/package.json +15 -4
  296. package/dist/templates/starter-game/session/src/Section.tsx +0 -37
  297. package/dist/templates/starter-game/session/src/TeamDoor.tsx +0 -96
  298. package/dist/templates/starter-game/session/src/format.ts +0 -8
  299. package/dist/templates/starter-game/ui/src/HistoryPanel.test.tsx +0 -74
  300. package/dist/templates/starter-game/ui/src/HistoryPanel.tsx +0 -120
  301. package/dist/templates/starter-game/ui/src/HostLogo.test.tsx +0 -25
  302. package/dist/templates/starter-game/ui/src/HostLogo.tsx +0 -38
@@ -1,4 +1,5 @@
1
1
  import {
2
+ createMockParticipant,
2
3
  createMockSharedState,
3
4
  createMockTeam,
4
5
  createMockTeamState,
@@ -23,8 +24,33 @@ const settings: Settings = {
23
24
  session: { ShowJoinLinks: true, CurrencySymbol: '£' },
24
25
  };
25
26
 
26
- const teamContext = (over: Partial<TeamContext> = {}): TeamContext => ({
27
- plan: { Make: { lemonade: 40, icedtea: 20 } },
27
+ type Day = { day: number; purse: number; profit: number; sold: number; turned: number };
28
+
29
+ /** A stall's context after it has traded `day`, with its numbers on one line. */
30
+ const after = ({ day, purse, profit, sold, turned }: Day): TeamContext => ({
31
+ plan: { Make: { lemonade: 40 } },
32
+ results: {
33
+ Day: day,
34
+ Weather: 'sunny',
35
+ Lines: {
36
+ lemonade: {
37
+ Made: sold,
38
+ Wanted: sold + turned,
39
+ Sold: sold,
40
+ PouredAway: 0,
41
+ TurnedAway: turned,
42
+ },
43
+ },
44
+ Takings: profit + 500,
45
+ Spent: 500,
46
+ Profit: profit,
47
+ Purse: purse,
48
+ },
49
+ roles: { LooksAfter: {} },
50
+ });
51
+
52
+ const fresh: TeamContext = {
53
+ plan: { Make: {} },
28
54
  results: {
29
55
  Day: 0,
30
56
  Weather: 'sunny',
@@ -35,40 +61,8 @@ const teamContext = (over: Partial<TeamContext> = {}): TeamContext => ({
35
61
  Purse: 0,
36
62
  },
37
63
  roles: { LooksAfter: {} },
38
- ...over,
39
- });
40
-
41
- /** A team that traded yesterday and has not touched its numbers since. */
42
- const traded = (made: { lemonade: number; icedtea: number }, plan = made): TeamContext =>
43
- teamContext({
44
- plan: { Make: { ...plan } },
45
- results: {
46
- Day: 1,
47
- Weather: 'sunny',
48
- Lines: {
49
- lemonade: {
50
- Made: made.lemonade,
51
- Wanted: 60,
52
- Sold: made.lemonade,
53
- PouredAway: 0,
54
- TurnedAway: 0,
55
- },
56
- icedtea: {
57
- Made: made.icedtea,
58
- Wanted: 30,
59
- Sold: made.icedtea,
60
- PouredAway: 0,
61
- TurnedAway: 0,
62
- },
63
- },
64
- Takings: 3200,
65
- Spent: 1000,
66
- Profit: 2200,
67
- Purse: 2200,
68
- },
69
- });
64
+ };
70
65
 
71
- // Only what the screen shows: the helper fills the rest of the session in.
72
66
  const sessionMeta = { name: 'Tuesday cohort' };
73
67
 
74
68
  const links = [
@@ -84,9 +78,14 @@ const links = [
84
78
  },
85
79
  ];
86
80
 
87
- const shared: SharedContext = { briefing: { Message: '' } };
81
+ const shared = (lastOpenDay = 10): SharedContext => ({
82
+ briefing: { Message: '' },
83
+ pacing: { LastOpenDay: lastOpenDay },
84
+ });
88
85
 
89
- const render = (options: RenderSessionUserInterfaceOptions<SessionData> = {}) =>
86
+ const render = (
87
+ options: RenderSessionUserInterfaceOptions<SessionData> & { lastOpenDay?: number } = {}
88
+ ) =>
90
89
  renderSessionUserInterface<SessionData>(<App />, {
91
90
  settings,
92
91
  sessionMeta,
@@ -98,14 +97,13 @@ const render = (options: RenderSessionUserInterfaceOptions<SessionData> = {}) =>
98
97
  ...options,
99
98
  // A case names only the half it is about; the other keeps its default.
100
99
  sessionData: {
101
- shared: createMockSharedState<SharedContext>({ context: shared }),
100
+ shared: createMockSharedState<SharedContext>({
101
+ context: shared(options.lastOpenDay),
102
+ }),
102
103
  teams: {
103
- 'team-1': createMockTeamState<TeamContext>({
104
- context: teamContext(),
105
- completedTicks: 0,
106
- }),
104
+ 'team-1': createMockTeamState<TeamContext>({ context: fresh, completedTicks: 0 }),
107
105
  'team-2': createMockTeamState<TeamContext>({
108
- context: teamContext(),
106
+ context: after({ day: 2, purse: 3300, profit: 1800, sold: 90, turned: 12 }),
109
107
  completedTicks: 2,
110
108
  }),
111
109
  },
@@ -113,103 +111,138 @@ const render = (options: RenderSessionUserInterfaceOptions<SessionData> = {}) =>
113
111
  },
114
112
  });
115
113
 
116
- describe('the stalls table', () => {
117
- it('says what each stall is making against what it can make', () => {
114
+ const card = (teamId: string) => screen.getByTestId(`team-${teamId}`);
115
+
116
+ describe('the day limit', () => {
117
+ it('shows how far the stalls may go', () => {
118
+ render({ lastOpenDay: 3 });
119
+
120
+ const group = screen.getByRole('group', { name: 'Day limit' });
121
+ expect(group).toHaveTextContent('Day 3');
122
+ expect(screen.getByText('of 10')).toBeInTheDocument();
123
+ });
124
+
125
+ /**
126
+ * A shared write: one value for the session, which the day-limit
127
+ * validator reads before it lets any stall open a day.
128
+ */
129
+ it('opens the next day for every stall at once', async () => {
130
+ const setData = vi.fn().mockResolvedValue(undefined);
131
+ render({ lastOpenDay: 3, setData });
132
+
133
+ fireEvent.click(screen.getByRole('button', { name: 'Open day 4' }));
134
+
135
+ await waitFor(() => expect(setData).toHaveBeenCalledWith({ pacing: { LastOpenDay: 4 } }));
136
+ });
137
+
138
+ it('holds the room at an earlier day', async () => {
139
+ const setData = vi.fn().mockResolvedValue(undefined);
140
+ render({ lastOpenDay: 3, setData });
141
+
142
+ fireEvent.click(screen.getByRole('button', { name: 'Hold at day 2' }));
143
+
144
+ await waitFor(() => expect(setData).toHaveBeenCalledWith({ pacing: { LastOpenDay: 2 } }));
145
+ });
146
+
147
+ it('goes no further than the last day of the week', () => {
118
148
  render();
119
149
 
120
- expect(screen.getByTestId('team-team-1')).toHaveTextContent('60 of 120');
150
+ expect(screen.getByRole('button', { name: 'Open day 11' })).toBeDisabled();
121
151
  });
152
+ });
122
153
 
123
- it('counts the day each stall is about to trade', () => {
154
+ describe('the stalls', () => {
155
+ it('says which day each stall is playing', () => {
124
156
  render();
125
157
 
126
- expect(screen.getByTestId('team-team-2')).toHaveTextContent('3');
158
+ expect(card('team-1')).toHaveTextContent('Playing day 1');
159
+ expect(card('team-2')).toHaveTextContent('Playing day 3');
127
160
  });
128
161
 
129
- /**
130
- * There is no 'we are ready' button on a player's screen, and adding one
131
- * would be a commit step by another name. Comparing today's plan against
132
- * what was actually made yesterday answers the same question for free.
133
- */
134
- it('flags a stall still sitting on yesterday’s numbers', () => {
162
+ it('says when a stall has caught up with the day limit', () => {
163
+ render({ lastOpenDay: 2 });
164
+
165
+ expect(card('team-2')).toHaveTextContent('Waiting for day 3');
166
+ });
167
+
168
+ it('says when a stall has finished the week', () => {
135
169
  render({
136
170
  sessionData: {
137
171
  teams: {
138
172
  'team-1': createMockTeamState<TeamContext>({
139
- context: traded({ lemonade: 40, icedtea: 20 }),
140
- completedTicks: 1,
141
- }),
142
- 'team-2': createMockTeamState<TeamContext>({
143
- context: traded(
144
- { lemonade: 40, icedtea: 20 },
145
- { lemonade: 55, icedtea: 20 }
146
- ),
147
- completedTicks: 1,
173
+ context: fresh,
174
+ completedTicks: 10,
148
175
  }),
149
176
  },
150
177
  },
151
178
  });
152
179
 
153
- expect(screen.getByTestId('team-team-1')).toHaveTextContent('Same as yesterday');
154
- expect(screen.getByTestId('team-team-2')).toHaveTextContent('Changed');
155
- expect(screen.getByText('1 of 2 have changed their numbers today')).toBeInTheDocument();
180
+ expect(card('team-1')).toHaveTextContent('Finished');
156
181
  });
157
182
 
158
- // The stalls open their own days. A facilitator who could run one would end
159
- // up running it for a group that had not finished deciding.
160
- it('offers no way to run a stall’s day', () => {
183
+ it('shows what is in the jar', () => {
161
184
  render();
162
185
 
163
- expect(screen.queryByRole('button', { name: /Run/ })).not.toBeInTheDocument();
186
+ expect(card('team-2')).toHaveTextContent('In the jar £33.00');
187
+ });
188
+
189
+ it('shows who is there, and who has stepped away', () => {
190
+ render({
191
+ participants: [
192
+ createMockParticipant({ id: 'p1', name: 'Nadia Okafor', teamId: 'team-1' }),
193
+ createMockParticipant({
194
+ id: 'p2',
195
+ name: 'Gareth Hughes',
196
+ teamId: 'team-1',
197
+ connected: false,
198
+ }),
199
+ ],
200
+ });
201
+
202
+ const people = within(card('team-1'));
203
+ expect(people.getByRole('img', { name: 'Nadia Okafor' })).toHaveTextContent('NO');
204
+ expect(people.getByRole('img', { name: 'Gareth Hughes (away)' })).toBeInTheDocument();
205
+ expect(card('team-2')).toHaveTextContent('Nobody yet');
164
206
  });
165
207
 
166
- it('will not undo a stall that has not traded', () => {
208
+ // The stalls open their own days. A facilitator who could run one would end
209
+ // up running it for a group that had not finished deciding.
210
+ it('offers no way to run a stall’s day', () => {
167
211
  render();
168
212
 
169
- const row = screen.getByTestId('team-team-1');
170
- expect(within(row).getByRole('button', { name: 'Undo' })).toBeDisabled();
213
+ expect(
214
+ screen.queryByRole('button', { name: /Run|Open the stall/ })
215
+ ).not.toBeInTheDocument();
171
216
  });
172
217
  });
173
218
 
174
- describe('getting into a team', () => {
219
+ describe('getting into a stall', () => {
175
220
  /**
176
- * Both are one click and both open a tab of their own: a session surface
177
- * owns the whole canvas, so navigating this frame would leave the
178
- * facilitator with no way back.
221
+ * Observing opens a tab of its own: a session surface owns the whole
222
+ * canvas, so navigating this frame would leave the facilitator with no way
223
+ * back.
179
224
  */
180
225
  it('offers a way to observe a stall without joining it', () => {
181
226
  render();
182
227
 
183
- const observe = within(screen.getByTestId('team-team-1')).getByRole('link', {
184
- name: 'Observe',
185
- });
228
+ const observe = within(card('team-1')).getByRole('link', { name: 'Observe' });
186
229
 
187
230
  expect(observe).toHaveAttribute('href', 'https://example.test/observe/one');
188
231
  expect(observe).toHaveAttribute('target', '_blank');
189
232
  expect(observe).toHaveAttribute('rel', expect.stringContaining('noopener'));
190
233
  });
191
234
 
192
- it('offers a way to join a stall as a player', () => {
193
- render();
194
-
195
- const join = within(screen.getByTestId('team-team-2')).getByRole('link', { name: 'Join' });
196
-
197
- expect(join).toHaveAttribute('href', 'https://example.test/join/two');
198
- expect(join).toHaveAttribute('target', '_blank');
199
- });
200
-
201
235
  it('copies a join link, for handing out', async () => {
202
236
  const writeText = vi.fn().mockResolvedValue(undefined);
203
237
  Object.assign(navigator, { clipboard: { writeText } });
204
238
  render();
205
239
 
206
- const row = screen.getByTestId('team-team-1');
207
- fireEvent.click(within(row).getByRole('button', { name: /Copy the join link/ }));
240
+ fireEvent.click(within(card('team-1')).getByRole('button', { name: /Copy the join link/ }));
208
241
 
209
242
  await waitFor(() =>
210
243
  expect(writeText).toHaveBeenCalledWith('https://example.test/join/one')
211
244
  );
212
- expect(await within(row).findByText('Copied')).toBeInTheDocument();
245
+ expect(await within(card('team-1')).findByText('Copied')).toBeInTheDocument();
213
246
  });
214
247
 
215
248
  // Permissions Policy is implemented unevenly, so a button that silently
@@ -219,10 +252,9 @@ describe('getting into a team', () => {
219
252
  Object.assign(navigator, { clipboard: { writeText } });
220
253
  render();
221
254
 
222
- const row = screen.getByTestId('team-team-1');
223
- fireEvent.click(within(row).getByRole('button', { name: /Copy the join link/ }));
255
+ fireEvent.click(within(card('team-1')).getByRole('button', { name: /Copy the join link/ }));
224
256
 
225
- expect(await within(row).findByText('https://example.test/join/one')).toBeInTheDocument();
257
+ expect(await screen.findByText('https://example.test/join/one')).toBeInTheDocument();
226
258
  });
227
259
 
228
260
  it('offers nothing before the host has delivered the links', () => {
@@ -236,15 +268,236 @@ describe('getting into a team', () => {
236
268
  settings: { ...settings, session: { ...settings.session, ShowJoinLinks: false } },
237
269
  });
238
270
 
239
- expect(screen.queryByRole('link', { name: 'Join' })).not.toBeInTheDocument();
271
+ expect(screen.queryByRole('link', { name: 'Observe' })).not.toBeInTheDocument();
272
+ expect(screen.queryByRole('button', { name: 'Show join codes' })).not.toBeInTheDocument();
273
+ });
274
+ });
275
+
276
+ describe('managing a stall', () => {
277
+ it('opens beside the stalls, with no backdrop', () => {
278
+ render();
279
+
280
+ fireEvent.click(screen.getByRole('button', { name: 'Manage Kestrel' }));
281
+
282
+ const panel = screen.getByRole('complementary', { name: 'Kestrel' });
283
+ expect(panel).toBeInTheDocument();
284
+ expect(document.querySelector('.MuiBackdrop-root')).toBeNull();
285
+ expect(screen.getByRole('tab', { name: 'Teams' })).toBeVisible();
286
+ });
287
+
288
+ it('asks before undoing a day, in place of the button', async () => {
289
+ const undoTick = vi.fn().mockResolvedValue(undefined);
290
+ render({ callbacks: { undoTick } });
291
+
292
+ fireEvent.click(screen.getByRole('button', { name: 'Manage Kestrel' }));
293
+ const panel = within(screen.getByRole('complementary', { name: 'Kestrel' }));
294
+ fireEvent.click(panel.getByRole('button', { name: 'Undo day 2' }));
295
+
296
+ expect(panel.getByRole('alert')).toHaveTextContent(
297
+ 'Take Kestrel back to the start of day 2?'
298
+ );
299
+ expect(undoTick).not.toHaveBeenCalled();
300
+
301
+ fireEvent.click(panel.getByRole('button', { name: 'Undo day 2' }));
302
+
303
+ await waitFor(() => expect(undoTick).toHaveBeenCalledWith('team-2'));
304
+ });
305
+
306
+ it('keeps the day when the facilitator thinks better of it', () => {
307
+ const undoTick = vi.fn().mockResolvedValue(undefined);
308
+ render({ callbacks: { undoTick } });
309
+
310
+ fireEvent.click(screen.getByRole('button', { name: 'Manage Kestrel' }));
311
+ const panel = within(screen.getByRole('complementary', { name: 'Kestrel' }));
312
+ fireEvent.click(panel.getByRole('button', { name: 'Undo day 2' }));
313
+ fireEvent.click(panel.getByRole('button', { name: 'Keep it' }));
314
+
315
+ expect(panel.queryByRole('alert')).not.toBeInTheDocument();
316
+ expect(undoTick).not.toHaveBeenCalled();
317
+ });
318
+
319
+ it('has nothing to undo before a stall has played', () => {
320
+ render();
321
+
322
+ fireEvent.click(screen.getByRole('button', { name: 'Manage Bluebird' }));
323
+
324
+ expect(screen.queryByRole('button', { name: /Undo day/ })).not.toBeInTheDocument();
325
+ });
326
+
327
+ it('renames a stall through the host', async () => {
328
+ const renameTeam = vi.fn().mockResolvedValue(undefined);
329
+ render({ callbacks: { renameTeam } });
330
+
331
+ fireEvent.click(screen.getByRole('button', { name: 'Manage Kestrel' }));
332
+ const field = screen.getByLabelText('Stall name');
333
+ fireEvent.change(field, { target: { value: 'The Lemon Tree' } });
334
+ fireEvent.keyDown(field, { key: 'Enter' });
335
+
336
+ await waitFor(() => expect(renameTeam).toHaveBeenCalledWith('team-2', 'The Lemon Tree'));
337
+ });
338
+
339
+ it('moves a person to another stall', async () => {
340
+ const moveParticipant = vi.fn().mockResolvedValue(undefined);
341
+ render({
342
+ callbacks: { moveParticipant },
343
+ participants: [createMockParticipant({ id: 'p1', name: 'Nadia', teamId: 'team-1' })],
344
+ });
345
+
346
+ fireEvent.click(screen.getByRole('button', { name: 'Manage Bluebird' }));
347
+ fireEvent.click(screen.getByRole('button', { name: 'Move Nadia to another stall' }));
348
+ fireEvent.click(screen.getByRole('menuitem', { name: 'Move to Kestrel' }));
349
+
350
+ await waitFor(() => expect(moveParticipant).toHaveBeenCalledWith('p1', 'team-2'));
351
+ });
352
+ });
353
+
354
+ describe('the results', () => {
355
+ const fourStalls = {
356
+ teams: [
357
+ createMockTeam({ name: 'Bluebird' }),
358
+ createMockTeam({ index: 1, name: 'Kestrel' }),
359
+ createMockTeam({ index: 2, name: 'Wren' }),
360
+ ],
361
+ sessionData: {
362
+ teams: {
363
+ 'team-1': createMockTeamState<TeamContext>({
364
+ context: after({ day: 2, purse: 4120, profit: 2410, sold: 96, turned: 31 }),
365
+ completedTicks: 2,
366
+ }),
367
+ 'team-2': createMockTeamState<TeamContext>({
368
+ context: after({ day: 2, purse: 3300, profit: 1860, sold: 111, turned: 12 }),
369
+ completedTicks: 2,
370
+ }),
371
+ 'team-3': createMockTeamState<TeamContext>({
372
+ context: after({ day: 1, purse: 1710, profit: 1710, sold: 70, turned: 0 }),
373
+ completedTicks: 1,
374
+ }),
375
+ },
376
+ },
377
+ };
378
+
379
+ it('opens on the latest day, and says which stalls have not reached it', () => {
380
+ render(fourStalls);
381
+
382
+ fireEvent.click(screen.getByRole('tab', { name: 'Results' }));
383
+
384
+ expect(screen.getByText('After day 2')).toBeInTheDocument();
385
+ expect(screen.getByTestId('result-team-3')).toHaveTextContent('Not played yet');
386
+ expect(screen.getByText('2 of 3 stalls have played day 2')).toBeInTheDocument();
387
+ expect(screen.getByText('£37.10')).toBeInTheDocument();
388
+ expect(screen.getByText('£33.00 to £41.20')).toBeInTheDocument();
389
+ });
390
+
391
+ it('sorts by what is in the jar, and by any other column', () => {
392
+ render(fourStalls);
393
+ fireEvent.click(screen.getByRole('tab', { name: 'Results' }));
394
+
395
+ const order = () =>
396
+ screen.getAllByTestId(/^result-/).map((row) => row.getAttribute('data-testid'));
397
+ expect(order()).toEqual(['result-team-1', 'result-team-2', 'result-team-3']);
398
+
399
+ fireEvent.click(screen.getByRole('button', { name: 'Sold' }));
400
+
401
+ expect(order()).toEqual(['result-team-2', 'result-team-1', 'result-team-3']);
402
+ });
403
+
404
+ it('steps back to a day a stall has played past, from its past state', async () => {
405
+ const getPastState = vi.fn().mockResolvedValue([
406
+ {
407
+ teamId: 'team-1',
408
+ index: 0,
409
+ name: 'Bluebird',
410
+ tick: 1,
411
+ recordedAt: 0,
412
+ complete: false,
413
+ context: after({ day: 1, purse: 1710, profit: 1710, sold: 60, turned: 5 }),
414
+ },
415
+ {
416
+ teamId: 'team-2',
417
+ index: 1,
418
+ name: 'Kestrel',
419
+ tick: 1,
420
+ recordedAt: 0,
421
+ complete: false,
422
+ context: after({ day: 1, purse: 1440, profit: 1440, sold: 55, turned: 3 }),
423
+ },
424
+ ]);
425
+ render({ ...fourStalls, callbacks: { getPastState } });
426
+ fireEvent.click(screen.getByRole('tab', { name: 'Results' }));
427
+
428
+ fireEvent.click(screen.getByRole('button', { name: 'Show day 1' }));
429
+
430
+ expect(screen.getByText('After day 1')).toBeInTheDocument();
431
+ expect(getPastState).toHaveBeenCalledWith(
432
+ expect.objectContaining({ fromTick: 1, teams: 'all' })
433
+ );
434
+ expect(await screen.findByText('3 of 3 stalls have played day 1')).toBeInTheDocument();
435
+ expect(screen.getByTestId('result-team-2')).toHaveTextContent('£14.40');
436
+ });
437
+
438
+ it('waits for the first day before showing anything', () => {
439
+ render({
440
+ sessionData: {
441
+ teams: {
442
+ 'team-1': createMockTeamState<TeamContext>({
443
+ context: fresh,
444
+ completedTicks: 0,
445
+ }),
446
+ },
447
+ },
448
+ teams: [createMockTeam({ name: 'Bluebird' })],
449
+ });
450
+
451
+ fireEvent.click(screen.getByRole('tab', { name: 'Results' }));
452
+
453
+ expect(screen.getByText(/once a stall has played its first day/)).toBeInTheDocument();
454
+ });
455
+ });
456
+
457
+ describe('join codes', () => {
458
+ it('shows one stall at a time, large, and steps through them', () => {
459
+ render();
460
+
461
+ fireEvent.click(screen.getByRole('button', { name: 'Show join codes' }));
462
+
463
+ const view = within(screen.getByRole('dialog'));
464
+ expect(view.getByText('Stall 1 of 2')).toBeInTheDocument();
465
+ expect(view.getByRole('heading', { name: 'Bluebird' })).toBeInTheDocument();
466
+ expect(view.getByTestId('join-link')).toHaveTextContent('https://example.test/join/one');
467
+ expect(view.getByRole('button', { name: 'Previous stall' })).toBeDisabled();
468
+
469
+ fireEvent.click(view.getByRole('button', { name: 'Next stall' }));
470
+
471
+ expect(view.getByRole('heading', { name: 'Kestrel' })).toBeInTheDocument();
472
+ expect(view.getByTestId('join-link')).toHaveTextContent('https://example.test/join/two');
473
+ expect(view.getByRole('button', { name: 'Next stall' })).toBeDisabled();
474
+ });
475
+
476
+ it('shows the session PIN when the session has one', () => {
477
+ render({ sessionMeta: { ...sessionMeta, joinPin: '4821' } });
478
+
479
+ fireEvent.click(screen.getByRole('button', { name: 'Show join codes' }));
480
+
481
+ expect(within(screen.getByRole('dialog')).getByText('4821')).toBeInTheDocument();
482
+ });
483
+
484
+ it('closes with Done', async () => {
485
+ render();
486
+
487
+ fireEvent.click(screen.getByRole('button', { name: 'Show join codes' }));
488
+ fireEvent.click(screen.getByRole('button', { name: 'Done' }));
489
+
490
+ await waitFor(() => expect(screen.queryByRole('dialog')).not.toBeInTheDocument());
240
491
  });
241
492
  });
242
493
 
243
- describe('the notice', () => {
244
- it('is a shared write, so it goes to every stall at once', async () => {
494
+ describe('the more menu', () => {
495
+ it('sends the notice to every stall at once', async () => {
245
496
  const setData = vi.fn().mockResolvedValue(undefined);
246
497
  render({ setData });
247
498
 
499
+ fireEvent.click(screen.getByRole('button', { name: 'More' }));
500
+ fireEvent.click(screen.getByRole('menuitem', { name: 'Notice to the room' }));
248
501
  fireEvent.change(screen.getByLabelText('Message'), {
249
502
  target: { value: 'Ten minutes left' },
250
503
  });
@@ -254,50 +507,118 @@ describe('the notice', () => {
254
507
  expect(setData).toHaveBeenCalledWith({ briefing: { Message: 'Ten minutes left' } })
255
508
  );
256
509
  });
510
+
511
+ it('offers the host’s print sheets only when it has them', async () => {
512
+ const openHostOverlay = vi.fn().mockResolvedValue(undefined);
513
+ render({ hostOverlays: ['print-sheets'], callbacks: { openHostOverlay } });
514
+
515
+ fireEvent.click(screen.getByRole('button', { name: 'More' }));
516
+ fireEvent.click(screen.getByRole('menuitem', { name: 'Print join sheets' }));
517
+
518
+ await waitFor(() => expect(openHostOverlay).toHaveBeenCalledWith('print-sheets'));
519
+ });
520
+
521
+ it('adds a stall until the session is full', async () => {
522
+ const createTeam = vi.fn().mockResolvedValue(undefined);
523
+ render({ callbacks: { createTeam } });
524
+
525
+ fireEvent.click(screen.getByRole('button', { name: 'More' }));
526
+ fireEvent.click(screen.getByRole('menuitem', { name: 'Add a stall' }));
527
+
528
+ await waitFor(() => expect(createTeam).toHaveBeenCalled());
529
+ });
530
+
531
+ it('will not add a stall past the host’s maximum', () => {
532
+ render({ teamConfiguration: { max: 2 } });
533
+
534
+ fireEvent.click(screen.getByRole('button', { name: 'More' }));
535
+
536
+ expect(screen.getByRole('menuitem', { name: 'Add a stall' })).toHaveAttribute(
537
+ 'aria-disabled',
538
+ 'true'
539
+ );
540
+ });
541
+
542
+ it('asks before starting the session again', async () => {
543
+ const resetGame = vi.fn().mockResolvedValue(undefined);
544
+ render({ callbacks: { resetGame } });
545
+
546
+ fireEvent.click(screen.getByRole('button', { name: 'More' }));
547
+ fireEvent.click(screen.getByRole('menuitem', { name: 'Start the session again' }));
548
+ expect(resetGame).not.toHaveBeenCalled();
549
+
550
+ fireEvent.click(screen.getByRole('button', { name: 'Start again' }));
551
+
552
+ await waitFor(() => expect(resetGame).toHaveBeenCalledWith());
553
+ });
257
554
  });
258
555
 
259
556
  describe('host-owned things', () => {
260
- it('offers the guide only when the host says it has one', () => {
557
+ it('offers the guide and the slides only when the host has them', () => {
261
558
  render();
262
559
 
263
560
  expect(screen.queryByRole('button', { name: 'Facilitator guide' })).not.toBeInTheDocument();
561
+ expect(screen.queryByRole('button', { name: 'Slides' })).not.toBeInTheDocument();
264
562
  });
265
563
 
266
- it('asks the host to open the guide', async () => {
564
+ it('asks the host to open the guide and the slides', async () => {
267
565
  const openHostOverlay = vi.fn().mockResolvedValue(undefined);
268
- render({ hostOverlays: ['facilitator-guide'], callbacks: { openHostOverlay } });
566
+ render({
567
+ hostOverlays: ['facilitator-guide', 'presentation'],
568
+ callbacks: { openHostOverlay },
569
+ });
269
570
 
270
571
  fireEvent.click(screen.getByRole('button', { name: 'Facilitator guide' }));
572
+ fireEvent.click(screen.getByRole('button', { name: 'Slides' }));
271
573
 
272
574
  await waitFor(() => expect(openHostOverlay).toHaveBeenCalledWith('facilitator-guide'));
575
+ expect(openHostOverlay).toHaveBeenCalledWith('presentation');
273
576
  });
274
577
 
275
578
  it('parks the session through the host rather than a flag of its own', async () => {
276
579
  const setWaitingRoom = vi.fn().mockResolvedValue(undefined);
277
580
  render({ callbacks: { setWaitingRoom } });
278
581
 
279
- fireEvent.click(screen.getByRole('switch', { name: 'Waiting room' }));
582
+ const toggle = screen.getByRole('button', { name: 'Waiting room closed' });
583
+ expect(toggle).toHaveAttribute('aria-pressed', 'false');
584
+ fireEvent.click(toggle);
280
585
 
281
586
  await waitFor(() => expect(setWaitingRoom).toHaveBeenCalledWith(true));
282
587
  });
588
+
589
+ it('lets the room back in from an open waiting room', async () => {
590
+ const setWaitingRoom = vi.fn().mockResolvedValue(undefined);
591
+ render({
592
+ sessionMeta: { ...sessionMeta, waitingRoomOpen: true },
593
+ callbacks: { setWaitingRoom },
594
+ });
595
+
596
+ const toggle = screen.getByRole('button', { name: 'Waiting room open' });
597
+ expect(toggle).toHaveAttribute('aria-pressed', 'true');
598
+ fireEvent.click(toggle);
599
+
600
+ await waitFor(() => expect(setWaitingRoom).toHaveBeenCalledWith(false));
601
+ });
602
+
603
+ it('reports a refusal rather than failing silently', async () => {
604
+ const setWaitingRoom = vi.fn().mockRejectedValue(new Error('The session is frozen'));
605
+ render({ callbacks: { setWaitingRoom } });
606
+
607
+ fireEvent.click(screen.getByRole('button', { name: 'Waiting room closed' }));
608
+
609
+ expect(await screen.findByText('The session is frozen')).toBeInTheDocument();
610
+ });
283
611
  });
284
612
 
285
613
  describe('a read-only session', () => {
286
614
  it('says why, instead of offering controls the host will refuse', () => {
287
- render({
288
- sessionMeta: { ...sessionMeta, readOnly: true },
289
- sessionData: {
290
- teams: {
291
- 'team-1': createMockTeamState<TeamContext>({
292
- context: teamContext(),
293
- completedTicks: 1,
294
- }),
295
- },
296
- },
297
- teams: [createMockTeam({ name: 'Bluebird' })],
298
- });
615
+ render({ sessionMeta: { ...sessionMeta, readOnly: true } });
299
616
 
300
617
  expect(screen.getByText(/read only/)).toBeInTheDocument();
301
- expect(screen.getByRole('button', { name: 'Undo' })).toBeDisabled();
618
+ expect(screen.getByRole('button', { name: 'Waiting room closed' })).toBeDisabled();
619
+ expect(screen.getByRole('button', { name: 'Hold at day 9' })).toBeDisabled();
620
+
621
+ fireEvent.click(screen.getByRole('button', { name: 'Manage Kestrel' }));
622
+ expect(screen.getByRole('button', { name: 'Undo day 2' })).toBeDisabled();
302
623
  });
303
624
  });