@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,87 +1,138 @@
1
+ import HistoryRounded from '@mui/icons-material/HistoryRounded';
1
2
  import {
2
3
  Alert,
3
- AppBar,
4
4
  Box,
5
- Chip,
6
5
  CssBaseline,
7
6
  LinearProgress,
8
- Snackbar,
9
7
  Stack,
10
8
  ThemeProvider,
11
- Toolbar,
12
9
  Typography,
13
10
  useMediaQuery,
14
11
  useTheme,
15
12
  } from '@mui/material';
16
- import {
17
- useMutationReporter,
18
- useUserInterfaceOwnTeam,
19
- useUserInterfaceData,
20
- useUserInterfaceParticipant,
21
- useUserInterfaceValidationRejections,
22
- } from '@seriousgaming/sdk/ui';
13
+ import { alpha } from '@mui/material/styles';
14
+ import { useMutationReporter, useUserInterfaceData } from '@seriousgaming/sdk/ui';
15
+ import { useState } from 'react';
23
16
  import { useTranslation } from 'react-i18next';
24
17
 
18
+ import { Awning } from '../../shared/Awning';
25
19
  import type { Settings, Context } from '../types';
26
20
  import DayBar from './DayBar';
27
- import HistoryPanel from './HistoryPanel';
28
- import HostLogo from './HostLogo';
21
+ import { useDays, WEEK_LENGTH } from './days';
22
+ import DaysTable from './DaysTable';
23
+ import FirstDay from './FirstDay';
24
+ import Header, { type Phase } from './Header';
25
+ import Notices from './Notices';
26
+ import PastDay from './PastDay';
27
+ import Section from './Section';
29
28
  import { useAppTheme } from './theme';
30
- import ThemeToggle from './ThemeToggle';
31
29
  import TodayPanel from './TodayPanel';
30
+ import WeatherCard from './WeatherCard';
31
+ import WeekOver from './WeekOver';
32
32
  import { WriteContext } from './writes';
33
33
  import YesterdayPanel from './YesterdayPanel';
34
34
 
35
- /** Wide enough for the history table without letting a card run an ultrawide monitor. */
36
- const CONTENT_MAX_WIDTH = 900;
35
+ /** Wide enough for two columns on a laptop without letting them drift apart on an ultrawide monitor. */
36
+ const CONTENT_MAX_WIDTH = 1180;
37
37
 
38
+ /**
39
+ * One screen, decision first.
40
+ *
41
+ * Top to bottom: the stall's sign, the forecast, what to make, then how
42
+ * yesterday went. The order is the order a team thinks in at the start of a
43
+ * day, and it puts the controls under the thumb before any results. At laptop
44
+ * width the results move to a column of their own beside the decision rather
45
+ * than below it, because a team round one screen reads both at once.
46
+ *
47
+ * The screen has four states, each designed rather than left to fall out of
48
+ * the data: before the first day, mid-week, looking back at a past day, and
49
+ * after the last day.
50
+ */
38
51
  function Shell() {
39
- const { data, settings, completedTicks, isRoundProcessing } = useUserInterfaceData<
40
- Context,
41
- Settings
42
- >();
43
- const participant = useUserInterfaceParticipant();
44
- const ownTeam = useUserInterfaceOwnTeam();
45
- const { rejections, clearRejections } = useUserInterfaceValidationRejections();
52
+ const { data, completedTicks, isRoundProcessing } = useUserInterfaceData<Context, Settings>();
46
53
  const reporter = useMutationReporter();
47
54
  const { t } = useTranslation();
48
55
  const theme = useTheme();
49
- const compact = useMediaQuery(theme.breakpoints.down('sm'));
56
+ const wide = useMediaQuery(theme.breakpoints.up('md'));
57
+ const { days } = useDays();
58
+ const [lookingAtChoice, setLookingAt] = useState<number | null>(null);
50
59
 
51
- const looksAfter = participant ? data.roles.LooksAfter[participant.id] : undefined;
52
- const yourItem = looksAfter ? settings.menu.Menu[looksAfter]?.Name : undefined;
60
+ const phase: Phase =
61
+ completedTicks >= WEEK_LENGTH ? 'over' : completedTicks === 0 ? 'first' : 'week';
62
+ const day = completedTicks + 1;
63
+ const held = day > data.pacing.LastOpenDay;
53
64
  const briefing = data.briefing.Message;
54
65
 
55
- // A validator refusal arrives twice: here as a `validation-rejected`
56
- // outcome, and through the rejection channel below, which carries the
57
- // validator's own message and is the better thing to show. Rendering both
58
- // would put a generic notice on top of a specific one.
59
- const unexplained =
60
- reporter.failure && reporter.failure.outcome.kind !== 'validation-rejected'
61
- ? reporter.failure
66
+ // An undo can take away the day being looked at; the screen then simply
67
+ // comes back to today rather than showing a day that no longer happened.
68
+ const lookingAt =
69
+ phase === 'week' && lookingAtChoice !== null && lookingAtChoice <= completedTicks
70
+ ? lookingAtChoice
62
71
  : null;
63
72
 
73
+ const decision = (
74
+ <Stack spacing={3}>
75
+ <WeatherCard />
76
+ <TodayPanel wide={wide} />
77
+ </Stack>
78
+ );
79
+
80
+ let main;
81
+ if (lookingAt !== null) {
82
+ main = (
83
+ <Box sx={{ maxWidth: 640, mx: 'auto', width: '100%' }}>
84
+ <PastDay results={days.find((d) => d.Day === lookingAt)} />
85
+ </Box>
86
+ );
87
+ } else if (phase === 'over') {
88
+ main = (
89
+ <Box sx={{ maxWidth: 760, mx: 'auto', width: '100%' }}>
90
+ <WeekOver days={days} wide={wide} />
91
+ </Box>
92
+ );
93
+ } else if (phase === 'first') {
94
+ main = wide ? (
95
+ <Columns left={decision} right={<FirstDay held={held} />} />
96
+ ) : (
97
+ <Stack spacing={3}>
98
+ <FirstDay held={held} />
99
+ {decision}
100
+ </Stack>
101
+ );
102
+ } else {
103
+ main = wide ? (
104
+ <Columns
105
+ left={decision}
106
+ right={
107
+ <Stack spacing={2}>
108
+ <YesterdayPanel days={days} wide />
109
+ <Section title={t('history.title')}>
110
+ <DaysTable days={days} wide />
111
+ </Section>
112
+ </Stack>
113
+ }
114
+ />
115
+ ) : (
116
+ <Stack spacing={3}>
117
+ {decision}
118
+ <YesterdayPanel days={days} />
119
+ </Stack>
120
+ );
121
+ }
122
+
64
123
  return (
65
124
  <WriteContext.Provider value={reporter}>
66
125
  <Box sx={{ display: 'flex', flexDirection: 'column', height: '100vh' }}>
67
- <AppBar position="static" color="default" elevation={0}>
68
- <Toolbar sx={{ gap: 1 }}>
69
- <HostLogo />
70
- <Typography variant="h6" component="h1" sx={{ flexGrow: 1 }} noWrap>
71
- {ownTeam?.name ?? t('shell.untitledTeam')}
72
- </Typography>
73
- {yourItem && !compact && (
74
- <Chip size="small" label={t('shell.looksAfter', { item: yourItem })} />
75
- )}
76
- <Chip
77
- size="small"
78
- color="primary"
79
- label={t('shell.day', { day: completedTicks + 1 })}
80
- data-testid="day"
81
- />
82
- <ThemeToggle />
83
- </Toolbar>
84
- </AppBar>
126
+ <Box sx={{ flex: '0 0 auto' }}>
127
+ <Header
128
+ phase={phase}
129
+ held={held}
130
+ lookingAt={lookingAt}
131
+ onLook={setLookingAt}
132
+ wide={wide}
133
+ />
134
+ <Awning depth={14} />
135
+ </Box>
85
136
 
86
137
  {/* One band per reason the screen is not simply waiting for the
87
138
  team. Each says which reason it is: a surface that only greys
@@ -109,62 +160,88 @@ function Shell() {
109
160
  </Alert>
110
161
  )}
111
162
 
112
- <Box sx={{ flex: 1, minHeight: 0, overflowY: 'auto', py: 3 }}>
113
- <Stack spacing={3} sx={{ maxWidth: CONTENT_MAX_WIDTH, mx: 'auto', px: 2 }}>
114
- <TodayPanel />
115
- <YesterdayPanel />
116
- <HistoryPanel />
163
+ <Box
164
+ component="main"
165
+ sx={{ flex: 1, minHeight: 0, overflowY: 'auto', pt: 1, pb: 3 }}
166
+ >
167
+ <Stack
168
+ spacing={2.25}
169
+ sx={{ maxWidth: CONTENT_MAX_WIDTH, mx: 'auto', px: wide ? 4 : 2 }}
170
+ >
171
+ {/* After the last day there is no bar to carry them. */}
172
+ {phase === 'over' && <Notices />}
173
+ {lookingAt !== null && <LookingBack day={lookingAt} today={day} />}
174
+ {main}
117
175
  </Stack>
118
176
  </Box>
119
177
 
120
- <DayBar />
121
-
122
- {/* The validator's own message, which is the one that says what
123
- the rule was and who else was changing something. */}
124
- <Snackbar
125
- open={rejections.length > 0}
126
- onClose={clearRejections}
127
- autoHideDuration={8000}
128
- anchorOrigin={{ vertical: 'bottom', horizontal: 'center' }}
129
- >
130
- <Alert severity="warning" onClose={clearRejections}>
131
- {rejections.map((rejection) => rejection.message).join(' ')}
132
- </Alert>
133
- </Snackbar>
134
-
135
- {/* What nothing else reports: denied, tick-failed, conflict, error. */}
136
- <Snackbar
137
- open={unexplained !== null}
138
- onClose={reporter.dismiss}
139
- autoHideDuration={8000}
140
- anchorOrigin={{ vertical: 'bottom', horizontal: 'center' }}
141
- >
142
- <Alert severity="error" onClose={reporter.dismiss}>
143
- {unexplained?.outcome.kind === 'tick-failed'
144
- ? t('shell.weekOver')
145
- : t('shell.writeFailed')}
146
- </Alert>
147
- </Snackbar>
148
-
149
- {/* Not a failure. The change landed, but in the day after the one
150
- they were looking at, and nothing else on screen says so. */}
151
- <Snackbar
152
- open={reporter.late !== null}
153
- onClose={reporter.dismiss}
154
- autoHideDuration={8000}
155
- anchorOrigin={{ vertical: 'bottom', horizontal: 'center' }}
156
- >
157
- <Alert severity="info" onClose={reporter.dismiss}>
158
- {t('shell.countedNextDay', {
159
- day: (reporter.late?.committedAtTick ?? 0) + 1,
160
- })}
161
- </Alert>
162
- </Snackbar>
178
+ {phase !== 'over' && (
179
+ <Box
180
+ component="footer"
181
+ sx={{
182
+ flex: '0 0 auto',
183
+ bgcolor: 'background.paper',
184
+ borderTop: 1,
185
+ borderColor: 'divider',
186
+ px: wide ? 4 : 2,
187
+ pt: 1.5,
188
+ pb: 2.5,
189
+ }}
190
+ >
191
+ <Box sx={{ maxWidth: CONTENT_MAX_WIDTH, mx: 'auto' }}>
192
+ <Notices />
193
+ <DayBar
194
+ lookingAt={lookingAt}
195
+ onBack={() => setLookingAt(null)}
196
+ wide={wide}
197
+ />
198
+ </Box>
199
+ </Box>
200
+ )}
163
201
  </Box>
164
202
  </WriteContext.Provider>
165
203
  );
166
204
  }
167
205
 
206
+ function Columns({ left, right }: { left: React.ReactNode; right: React.ReactNode }) {
207
+ return (
208
+ <Box
209
+ sx={{
210
+ display: 'grid',
211
+ gridTemplateColumns: 'minmax(0, 7fr) minmax(0, 5fr)',
212
+ gap: 4,
213
+ alignItems: 'start',
214
+ }}
215
+ >
216
+ <Box>{left}</Box>
217
+ <Box component="aside">{right}</Box>
218
+ </Box>
219
+ );
220
+ }
221
+
222
+ /** Says, before anything else on the page, that this is the past and cannot be touched. */
223
+ function LookingBack({ day, today }: { day: number; today: number }) {
224
+ const { t } = useTranslation();
225
+ return (
226
+ <Box
227
+ role="status"
228
+ data-testid="looking-back"
229
+ sx={(theme) => ({
230
+ display: 'flex',
231
+ gap: 1.25,
232
+ alignItems: 'flex-start',
233
+ bgcolor: alpha(theme.palette.info.main, 0.12),
234
+ borderRadius: '12px',
235
+ px: 1.5,
236
+ py: 1.25,
237
+ })}
238
+ >
239
+ <HistoryRounded aria-hidden sx={{ fontSize: 20, color: 'info.main', flex: 'none' }} />
240
+ <Typography variant="body2">{t('lookingBack.notice', { day, today })}</Typography>
241
+ </Box>
242
+ );
243
+ }
244
+
168
245
  export default function App() {
169
246
  const theme = useAppTheme();
170
247
 
@@ -8,8 +8,11 @@ import { baseSettings, baseContext } from './test-helpers';
8
8
 
9
9
  const ada = createMockParticipant({ id: 'participant-1', name: 'Ada' });
10
10
 
11
- const render = (options: Parameters<typeof renderUserInterface>[1] = {}) =>
12
- renderUserInterface(<DayBar />, {
11
+ const render = (
12
+ options: Parameters<typeof renderUserInterface>[1] = {},
13
+ props: Partial<Parameters<typeof DayBar>[0]> = {}
14
+ ) =>
15
+ renderUserInterface(<DayBar lookingAt={null} onBack={() => {}} {...props} />, {
13
16
  data: baseContext,
14
17
  settings: baseSettings,
15
18
  participant: ada,
@@ -32,16 +35,16 @@ describe('opening the stall', () => {
32
35
  await waitFor(() => expect(requestTick).toHaveBeenCalled());
33
36
  });
34
37
 
35
- it('says which day is about to play out', () => {
38
+ it('says which day it opens', () => {
36
39
  render({ completedTicks: 4 });
37
40
 
38
- expect(screen.getByText(/day 5 plays out/)).toBeInTheDocument();
41
+ expect(screen.getByTestId('open-stall')).toHaveTextContent('Open the stall for day 5');
39
42
  });
40
43
 
41
- it('says what the stall is making, against what it could', () => {
44
+ it('says how much room is left before opening', () => {
42
45
  render();
43
46
 
44
- expect(screen.getByText('Making 70 of a possible 120')).toBeInTheDocument();
47
+ expect(screen.getByText('Room for 50 more before you open')).toBeInTheDocument();
45
48
  });
46
49
 
47
50
  it('will not open a stall that has decided nothing', () => {
@@ -65,7 +68,7 @@ describe('opening the stall', () => {
65
68
  });
66
69
 
67
70
  expect(screen.getByTestId('open-stall')).toBeDisabled();
68
- expect(screen.getByText('Take something off before you open up')).toBeInTheDocument();
71
+ expect(screen.getByText(/30 more than the stall can make/)).toBeInTheDocument();
69
72
  });
70
73
 
71
74
  // An observer has no participant identity, so there is nothing for the
@@ -76,3 +79,43 @@ describe('opening the stall', () => {
76
79
  expect(screen.getByTestId('open-stall')).toBeDisabled();
77
80
  });
78
81
  });
82
+
83
+ describe('when the facilitator is holding the room', () => {
84
+ /**
85
+ * `validators/daylimit` refuses the tick on the server whatever the button
86
+ * does. The button reads the same limit so it can say why, rather than
87
+ * letting the stall press it and be refused.
88
+ */
89
+ it('says who opens the next day, and does not offer to open it', () => {
90
+ render({
91
+ completedTicks: 3,
92
+ data: { ...baseContext, pacing: { LastOpenDay: 3 } },
93
+ });
94
+
95
+ expect(screen.getByTestId('open-stall')).toBeDisabled();
96
+ expect(screen.getByTestId('open-stall')).toHaveTextContent('Your facilitator opens day 4');
97
+ expect(screen.getByText('Your numbers are saved as you change them')).toBeInTheDocument();
98
+ });
99
+
100
+ it('opens the day the facilitator has let them reach', () => {
101
+ render({
102
+ completedTicks: 2,
103
+ data: { ...baseContext, pacing: { LastOpenDay: 3 } },
104
+ });
105
+
106
+ expect(screen.getByTestId('open-stall')).toBeEnabled();
107
+ expect(screen.getByTestId('open-stall')).toHaveTextContent('Open the stall for day 3');
108
+ });
109
+ });
110
+
111
+ describe('looking back at a past day', () => {
112
+ it('offers the way back to today instead of opening the stall', () => {
113
+ const onBack = vi.fn();
114
+ render({ completedTicks: 2 }, { lookingAt: 1, onBack });
115
+
116
+ expect(screen.queryByTestId('open-stall')).not.toBeInTheDocument();
117
+ fireEvent.click(screen.getByRole('button', { name: 'Back to day 3' }));
118
+
119
+ expect(onBack).toHaveBeenCalled();
120
+ });
121
+ });
@@ -1,4 +1,4 @@
1
- import { Box, Button, Paper, Stack, Typography } from '@mui/material';
1
+ import { Box, Button, Typography } from '@mui/material';
2
2
  import {
3
3
  useUserInterfaceCallbacks,
4
4
  useUserInterfaceData,
@@ -10,6 +10,13 @@ import type { Settings, Context } from '../types';
10
10
  import { totalPlanned } from './menu';
11
11
  import { useWrite } from './writes';
12
12
 
13
+ type Props = {
14
+ /** The past day being looked at, when the reader is looking back. */
15
+ lookingAt: number | null;
16
+ onBack: () => void;
17
+ wide?: boolean;
18
+ };
19
+
13
20
  /**
14
21
  * The stall opens its own day.
15
22
  *
@@ -18,55 +25,106 @@ import { useWrite } from './writes';
18
25
  * with it instead of waiting for the room. The facilitator watches, and can
19
26
  * undo a day, but does not drive the session.
20
27
  *
28
+ * What the facilitator can do is hold the room at a day. `pacing.LastOpenDay`
29
+ * is theirs, and `validators/daylimit` refuses a stall that asks for a later
30
+ * one. The button reads the same number so it can say why it will not open,
31
+ * rather than letting the stall press it and be told off: the validator is the
32
+ * rule, and this is the courtesy.
33
+ *
21
34
  * It is a shared control with no lock on it, which is deliberate. Somebody can
22
- * open the stall while a team-mate is still moving a slider, and when that
23
- * happens the change lands on the following day rather than being lost: that is
24
- * what `reporter.late` reports, and why the notice for it exists.
35
+ * open the stall while a team-mate is still changing a number, and when that
36
+ * happens the change lands on the following day rather than being lost: that
37
+ * is what `reporter.late` reports, and why the notice for it exists.
38
+ *
39
+ * The bar is part of the page's layout, not laid over it, so it never covers
40
+ * the last item on the menu.
25
41
  */
26
- export default function DayBar() {
42
+ export default function DayBar({ lookingAt, onBack, wide = false }: Props) {
27
43
  const { data, settings, completedTicks } = useUserInterfaceData<Context, Settings>();
28
44
  const participant = useUserInterfaceParticipant();
29
45
  const { requestTick } = useUserInterfaceCallbacks();
30
46
  const { run, pending } = useWrite();
31
47
  const { t } = useTranslation();
32
48
 
33
- const planned = totalPlanned(data.plan.Make);
34
- const over = planned > settings.menu.Capacity;
35
- const empty = planned === 0;
49
+ const day = completedTicks + 1;
36
50
 
37
- return (
38
- <Paper
39
- square
40
- elevation={3}
41
- sx={{ flex: '0 0 auto', borderTop: 1, borderColor: 'divider', px: 2, py: 1.5 }}
42
- >
43
- <Stack
44
- direction="row"
45
- spacing={2}
46
- sx={{ alignItems: 'center', justifyContent: 'space-between', mx: 'auto' }}
47
- >
48
- <Box>
49
- <Typography variant="subtitle2">
50
- {t('day.making', { planned, capacity: settings.menu.Capacity })}
51
- </Typography>
52
- <Typography variant="caption" color="text.secondary">
53
- {over
54
- ? t('day.tooMany')
55
- : empty
56
- ? t('day.nothing')
57
- : t('day.ready', { day: completedTicks + 1 })}
58
- </Typography>
59
- </Box>
51
+ if (lookingAt !== null) {
52
+ return (
53
+ <Bar wide={wide}>
60
54
  <Button
61
- variant="contained"
55
+ variant="outlined"
62
56
  size="large"
63
- disabled={!participant || pending || over || empty}
64
- data-testid="open-stall"
65
- onClick={() => void run(() => requestTick(), 'open-stall')}
57
+ onClick={onBack}
58
+ data-testid="back-to-today"
59
+ sx={{
60
+ height: 52,
61
+ borderRadius: '14px',
62
+ fontSize: '1.05rem',
63
+ ...barButton(wide),
64
+ }}
66
65
  >
67
- {t('day.open')}
66
+ {t('timeline.backTo', { day })}
68
67
  </Button>
69
- </Stack>
70
- </Paper>
68
+ </Bar>
69
+ );
70
+ }
71
+
72
+ const planned = totalPlanned(data.plan.Make);
73
+ const room = settings.menu.Capacity - planned;
74
+ const held = day > data.pacing.LastOpenDay;
75
+
76
+ const status =
77
+ room < 0
78
+ ? t('day.tooMany', { over: -room })
79
+ : planned === 0
80
+ ? t('day.nothing')
81
+ : held
82
+ ? t('day.saved')
83
+ : room === 0
84
+ ? t('day.full')
85
+ : t('day.room', { room });
86
+
87
+ return (
88
+ <Bar wide={wide}>
89
+ <Button
90
+ variant="contained"
91
+ size="large"
92
+ disableElevation
93
+ disabled={!participant || pending || held || room < 0 || planned === 0}
94
+ data-testid="open-stall"
95
+ onClick={() => void run(() => requestTick(), 'open-stall')}
96
+ sx={{ height: 52, borderRadius: '14px', fontSize: '1.05rem', ...barButton(wide) }}
97
+ >
98
+ {held ? t('day.held', { day }) : t('day.open', { day })}
99
+ </Button>
100
+ <Typography
101
+ variant="body2"
102
+ color={room < 0 ? 'error.main' : 'text.secondary'}
103
+ data-testid="day-status"
104
+ sx={{ textAlign: 'center', fontVariantNumeric: 'tabular-nums' }}
105
+ >
106
+ {status}
107
+ </Typography>
108
+ </Bar>
109
+ );
110
+ }
111
+
112
+ const barButton = (wide: boolean) => (wide ? { px: 3.5 } : { width: '100%' });
113
+
114
+ function Bar({ wide, children }: { wide: boolean; children: React.ReactNode }) {
115
+ return (
116
+ <Box
117
+ sx={{
118
+ display: 'flex',
119
+ // At laptop width the status reads first and the button sits
120
+ // at the end of the line, where the eye finishes.
121
+ flexDirection: wide ? 'row-reverse' : 'column',
122
+ alignItems: wide ? 'center' : 'stretch',
123
+ justifyContent: wide ? 'flex-start' : undefined,
124
+ gap: wide ? 2.5 : 1,
125
+ }}
126
+ >
127
+ {children}
128
+ </Box>
71
129
  );
72
130
  }
@@ -0,0 +1,69 @@
1
+ import { Table, TableBody, TableCell, TableHead, TableRow } from '@mui/material';
2
+ import { useUserInterfaceData } from '@seriousgaming/sdk/ui';
3
+ import { useTranslation } from 'react-i18next';
4
+
5
+ import { count, money } from '../../shared/format';
6
+ import type { Context, Settings } from '../types';
7
+ import { type DayResults, totalsOf } from './days';
8
+
9
+ type Props = {
10
+ days: DayResults[];
11
+ /** Room for the 'Turned away' column, at laptop width. */
12
+ wide?: boolean;
13
+ };
14
+
15
+ /**
16
+ * Every day so far, newest first, so the day the team is thinking about is at
17
+ * the top.
18
+ *
19
+ * Four columns on a phone and five on a laptop. A table that scrolls sideways
20
+ * on a phone hides the column the reader wanted behind the one they did not,
21
+ * so the narrow version drops a column rather than shrinking the type.
22
+ * Everything a day holds is one tap away in the timeline above.
23
+ */
24
+ export default function DaysTable({ days, wide = false }: Props) {
25
+ const { settings } = useUserInterfaceData<Context, Settings>();
26
+ const { t } = useTranslation();
27
+ const symbol = settings.ui.CurrencySymbol;
28
+ const best = Math.max(...days.map((day) => day.Profit));
29
+
30
+ return (
31
+ <Table size="small" sx={{ tableLayout: 'fixed', width: '100%' }}>
32
+ <TableHead>
33
+ <TableRow>
34
+ <TableCell sx={{ width: '16%' }}>{t('history.day')}</TableCell>
35
+ <TableCell>{t('history.weather')}</TableCell>
36
+ <TableCell align="right">{t('history.sold')}</TableCell>
37
+ {wide && <TableCell align="right">{t('history.turnedAway')}</TableCell>}
38
+ <TableCell align="right" sx={{ pr: 0 }}>
39
+ {t('history.profit')}
40
+ </TableCell>
41
+ </TableRow>
42
+ </TableHead>
43
+ <TableBody>
44
+ {[...days].reverse().map((day) => {
45
+ const totals = totalsOf(day);
46
+ return (
47
+ <TableRow key={day.Day} data-testid={`day-${day.Day}`}>
48
+ <TableCell>{day.Day}</TableCell>
49
+ <TableCell>{t(`weather.${day.Weather}Short`)}</TableCell>
50
+ <TableCell align="right">{count(totals.sold)}</TableCell>
51
+ {wide && (
52
+ <TableCell align="right">{count(totals.turnedAway)}</TableCell>
53
+ )}
54
+ <TableCell
55
+ align="right"
56
+ sx={{
57
+ pr: 0,
58
+ fontWeight: days.length > 1 && day.Profit === best ? 700 : 400,
59
+ }}
60
+ >
61
+ {money(symbol, day.Profit)}
62
+ </TableCell>
63
+ </TableRow>
64
+ );
65
+ })}
66
+ </TableBody>
67
+ </Table>
68
+ );
69
+ }