@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
@@ -0,0 +1,145 @@
1
+ import { Box, Button, Typography } from '@mui/material';
2
+ import { alpha } from '@mui/material/styles';
3
+ import { useUserInterfaceData } from '@seriousgaming/sdk/ui';
4
+ import { useState } from 'react';
5
+ import { useTranslation } from 'react-i18next';
6
+
7
+ import { count, money } from '../../shared/format';
8
+ import type { Context, Settings } from '../types';
9
+ import { type DayResults, totalsOf, WEEK_LENGTH } from './days';
10
+ import DaysTable from './DaysTable';
11
+
12
+ /** How many days the table shows before the reader asks for the rest. */
13
+ const RECENT = 3;
14
+
15
+ /**
16
+ * After the last day: the result, and what to bring to the debrief.
17
+ *
18
+ * No live controls, because nothing is left to decide. The jar is the one
19
+ * figure that sums up the week, so it leads; the highlights are the questions
20
+ * a facilitator tends to ask the room ('when did you do best?', 'how many did
21
+ * you send away?') answered before they are asked.
22
+ */
23
+ export default function WeekOver({ days, wide = false }: { days: DayResults[]; wide?: boolean }) {
24
+ const { data, settings } = useUserInterfaceData<Context, Settings>();
25
+ const { t } = useTranslation();
26
+ const [all, setAll] = useState(false);
27
+ const symbol = settings.ui.CurrencySymbol;
28
+
29
+ const best = days.reduce<DayResults | undefined>(
30
+ (top, day) => (!top || day.Profit > top.Profit ? day : top),
31
+ undefined
32
+ );
33
+ const totals = days.map(totalsOf);
34
+ const turnedAway = totals.reduce((sum, day) => sum + day.turnedAway, 0);
35
+ const unsold = totals.reduce((sum, day) => sum + day.pouredAway, 0);
36
+ const soldById = new Map<string, number>();
37
+ for (const day of days) {
38
+ for (const [id, line] of Object.entries(day.Lines)) {
39
+ soldById.set(id, (soldById.get(id) ?? 0) + line.Sold);
40
+ }
41
+ }
42
+ const bestSellerId = [...soldById.entries()].sort((a, b) => b[1] - a[1])[0]?.[0];
43
+ const bestSeller = bestSellerId ? settings.menu.Menu[bestSellerId]?.Name : undefined;
44
+
45
+ const shown = all ? days : days.slice(-RECENT);
46
+
47
+ return (
48
+ <Box sx={{ display: 'flex', flexDirection: 'column', gap: 2.5 }}>
49
+ <Box component="section" sx={{ textAlign: 'center', py: 1 }}>
50
+ <Typography variant="body2" color="text.secondary">
51
+ {t('final.jar', { days: WEEK_LENGTH })}
52
+ </Typography>
53
+ <Typography
54
+ component="p"
55
+ data-testid="final-purse"
56
+ sx={{
57
+ fontSize: '3rem',
58
+ fontWeight: 700,
59
+ lineHeight: 1.1,
60
+ fontVariantNumeric: 'tabular-nums',
61
+ }}
62
+ >
63
+ {money(symbol, data.results.Purse)}
64
+ </Typography>
65
+ <Typography variant="body2" color="text.secondary">
66
+ {t('final.debrief')}
67
+ </Typography>
68
+ </Box>
69
+
70
+ <Box
71
+ component="section"
72
+ sx={{
73
+ display: 'grid',
74
+ gridTemplateColumns: {
75
+ xs: 'repeat(2, minmax(0, 1fr))',
76
+ md: 'repeat(4, minmax(0, 1fr))',
77
+ },
78
+ gap: 1.5,
79
+ }}
80
+ >
81
+ {best && (
82
+ <Highlight
83
+ label={t('final.bestDay')}
84
+ value={t('final.bestDayValue', {
85
+ day: best.Day,
86
+ profit: money(symbol, best.Profit),
87
+ })}
88
+ />
89
+ )}
90
+ <Highlight
91
+ label={t('final.turnedAway')}
92
+ value={t('final.turnedAwayValue', { count: turnedAway })}
93
+ />
94
+ <Highlight label={t('final.unsold')} value={count(unsold)} />
95
+ {bestSeller && <Highlight label={t('final.bestSeller')} value={bestSeller} />}
96
+ </Box>
97
+
98
+ {days.length > 0 && (
99
+ <Box component="section" aria-labelledby="every-day-heading">
100
+ <Typography
101
+ id="every-day-heading"
102
+ variant="subtitle1"
103
+ component="h2"
104
+ sx={{ fontWeight: 600 }}
105
+ >
106
+ {t('history.allTitle')}
107
+ </Typography>
108
+ <DaysTable days={shown} wide={wide} />
109
+ {days.length > RECENT && (
110
+ <Button
111
+ variant="text"
112
+ aria-expanded={all}
113
+ onClick={() => setAll((was) => !was)}
114
+ sx={{ mt: 1, px: 0, minWidth: 0 }}
115
+ >
116
+ {all
117
+ ? t('history.showFewer')
118
+ : t('history.showAll', { count: days.length })}
119
+ </Button>
120
+ )}
121
+ </Box>
122
+ )}
123
+ </Box>
124
+ );
125
+ }
126
+
127
+ function Highlight({ label, value }: { label: string; value: string }) {
128
+ return (
129
+ <Box
130
+ sx={(theme) => ({
131
+ bgcolor: alpha(theme.palette.primary.main, 0.07),
132
+ borderRadius: '14px',
133
+ px: 1.75,
134
+ py: 1.5,
135
+ })}
136
+ >
137
+ <Typography variant="body2" color="text.secondary">
138
+ {label}
139
+ </Typography>
140
+ <Typography sx={{ fontWeight: 600, fontVariantNumeric: 'tabular-nums' }}>
141
+ {value}
142
+ </Typography>
143
+ </Box>
144
+ );
145
+ }
@@ -1,141 +1,92 @@
1
- import {
2
- Alert,
3
- Box,
4
- Stack,
5
- Table,
6
- TableBody,
7
- TableCell,
8
- TableHead,
9
- TableRow,
10
- Typography,
11
- } from '@mui/material';
1
+ import { Box, Button, Collapse, Typography } from '@mui/material';
12
2
  import { useUserInterfaceData } from '@seriousgaming/sdk/ui';
3
+ import { useId, useState } from 'react';
13
4
  import { useTranslation } from 'react-i18next';
14
5
 
6
+ import { money } from '../../shared/format';
15
7
  import type { Settings, Context } from '../types';
16
- import { count, money } from './format';
17
- import { menuOf } from './menu';
8
+ import type { DayResults } from './days';
9
+ import DaysTable from './DaysTable';
10
+ import Lesson from './Lesson';
18
11
  import Section from './Section';
19
12
 
20
- function Stat({
21
- id,
22
- label,
23
- value,
24
- tone,
25
- }: {
26
- id: string;
27
- label: string;
28
- value: string;
29
- tone?: 'good' | 'bad';
30
- }) {
13
+ /** The one figure that says how a day went, and what it was made of. */
14
+ export function ProfitFigure({ results }: { results: DayResults }) {
15
+ const { settings } = useUserInterfaceData<Context, Settings>();
16
+ const { t } = useTranslation();
17
+ const symbol = settings.ui.CurrencySymbol;
18
+
31
19
  return (
32
- <Box sx={{ minWidth: 110 }} data-testid={`stat-${id}`}>
33
- <Typography variant="overline" color="text.secondary" component="p">
34
- {label}
35
- </Typography>
20
+ <Box>
36
21
  <Typography
37
- variant="h6"
38
22
  component="p"
39
- sx={{ fontVariantNumeric: 'tabular-nums' }}
40
- color={tone === 'good' ? 'success.main' : tone === 'bad' ? 'error.main' : undefined}
23
+ data-testid="stat-profit"
24
+ sx={{
25
+ fontSize: '2.1rem',
26
+ fontWeight: 700,
27
+ lineHeight: 1.1,
28
+ fontVariantNumeric: 'tabular-nums',
29
+ color: results.Profit < 0 ? 'error.main' : 'text.primary',
30
+ }}
41
31
  >
42
- {value}
32
+ {money(symbol, results.Profit)}
33
+ </Typography>
34
+ <Typography variant="body2" color="text.secondary">
35
+ {t(results.Profit < 0 ? 'yesterday.loss' : 'yesterday.profit', {
36
+ takings: money(symbol, results.Takings),
37
+ spent: money(symbol, results.Spent),
38
+ })}
43
39
  </Typography>
44
40
  </Box>
45
41
  );
46
42
  }
47
43
 
48
- /** How the last day actually went, item by item. */
49
- export default function YesterdayPanel() {
50
- const { data, settings } = useUserInterfaceData<Context, Settings>();
44
+ type Props = {
45
+ days: DayResults[];
46
+ /** At laptop width every day has its own card beside this one, so no disclosure. */
47
+ wide?: boolean;
48
+ };
49
+
50
+ /**
51
+ * How the last day went, cut to what the next decision needs: one figure and
52
+ * one lesson. The item-by-item breakdown is a tap on that day in the timeline,
53
+ * and every day so far is behind the link, so the decision above stays the
54
+ * first thing on the screen.
55
+ */
56
+ export default function YesterdayPanel({ days, wide = false }: Props) {
57
+ const { data } = useUserInterfaceData<Context, Settings>();
51
58
  const { t } = useTranslation();
52
- const symbol = settings.ui.CurrencySymbol;
59
+ const [open, setOpen] = useState(false);
60
+ const tableId = useId();
53
61
  const results = data.results;
54
62
 
55
- if (results.Day === 0) {
56
- return (
57
- <Section title={t('yesterday.title')} hint={t('yesterday.none')}>
58
- <Alert severity="info">{t('yesterday.firstDay')}</Alert>
59
- </Section>
60
- );
61
- }
62
-
63
- const pouredAway = Object.values(results.Lines).reduce((sum, l) => sum + l.PouredAway, 0);
64
- const turnedAway = Object.values(results.Lines).reduce((sum, l) => sum + l.TurnedAway, 0);
65
-
66
63
  return (
67
64
  <Section
68
65
  title={t('yesterday.title')}
69
- hint={t('yesterday.on', {
66
+ aside={t('yesterday.on', {
70
67
  day: results.Day,
71
- weather: t(`weather.${results.Weather}Short`),
68
+ weather: t(`weather.${results.Weather}Lower`),
72
69
  })}
73
70
  >
74
- <Stack direction="row" spacing={3} useFlexGap sx={{ flexWrap: 'wrap', mb: 3 }}>
75
- <Stat
76
- id="takings"
77
- label={t('yesterday.takings')}
78
- value={money(symbol, results.Takings)}
79
- />
80
- <Stat
81
- id="spent"
82
- label={t('yesterday.spent')}
83
- value={money(symbol, results.Spent)}
84
- />
85
- <Stat
86
- id="profit"
87
- label={t('yesterday.profit')}
88
- value={money(symbol, results.Profit)}
89
- tone={results.Profit >= 0 ? 'good' : 'bad'}
90
- />
91
- <Stat
92
- id="purse"
93
- label={t('yesterday.purse')}
94
- value={money(symbol, results.Purse)}
95
- />
96
- <Stat
97
- id="pouredaway"
98
- label={t('yesterday.pouredAway')}
99
- value={count(pouredAway)}
100
- tone={pouredAway > 0 ? 'bad' : undefined}
101
- />
102
- <Stat
103
- id="turnedaway"
104
- label={t('yesterday.turnedAway')}
105
- value={count(turnedAway)}
106
- tone={turnedAway > 0 ? 'bad' : undefined}
107
- />
108
- </Stack>
109
-
110
- <Box sx={{ overflowX: 'auto' }}>
111
- <Table size="small">
112
- <TableHead>
113
- <TableRow>
114
- <TableCell>{t('yesterday.item')}</TableCell>
115
- <TableCell align="right">{t('yesterday.made')}</TableCell>
116
- <TableCell align="right">{t('yesterday.wanted')}</TableCell>
117
- <TableCell align="right">{t('yesterday.sold')}</TableCell>
118
- <TableCell align="right">{t('yesterday.pouredAway')}</TableCell>
119
- <TableCell align="right">{t('yesterday.turnedAway')}</TableCell>
120
- </TableRow>
121
- </TableHead>
122
- <TableBody>
123
- {menuOf(settings.menu).map(({ id, item }) => {
124
- const line = results.Lines[id];
125
- if (!line) return null;
126
- return (
127
- <TableRow key={id} data-testid={`line-${id}`}>
128
- <TableCell>{item.Name}</TableCell>
129
- <TableCell align="right">{count(line.Made)}</TableCell>
130
- <TableCell align="right">{count(line.Wanted)}</TableCell>
131
- <TableCell align="right">{count(line.Sold)}</TableCell>
132
- <TableCell align="right">{count(line.PouredAway)}</TableCell>
133
- <TableCell align="right">{count(line.TurnedAway)}</TableCell>
134
- </TableRow>
135
- );
136
- })}
137
- </TableBody>
138
- </Table>
71
+ <Box sx={{ display: 'flex', flexDirection: 'column', gap: 1.5 }}>
72
+ <ProfitFigure results={results} />
73
+ <Lesson results={results} />
74
+ {!wide && (
75
+ <>
76
+ <Button
77
+ variant="text"
78
+ aria-expanded={open}
79
+ aria-controls={tableId}
80
+ onClick={() => setOpen((was) => !was)}
81
+ sx={{ alignSelf: 'flex-start', px: 0, minWidth: 0 }}
82
+ >
83
+ {open ? t('yesterday.hideDays') : t('yesterday.showDays')}
84
+ </Button>
85
+ <Collapse in={open} id={tableId} unmountOnExit>
86
+ <DaysTable days={days} />
87
+ </Collapse>
88
+ </>
89
+ )}
139
90
  </Box>
140
91
  </Section>
141
92
  );
@@ -0,0 +1,58 @@
1
+ import { usePastState, useUserInterfaceData } from '@seriousgaming/sdk/ui';
2
+
3
+ import { LAST_DAY } from '../../shared/days';
4
+ import type { Context, Settings } from '../types';
5
+
6
+ export type DayResults = Context['results'];
7
+
8
+ /** How many days the stall trades for: the manifest's `maxTicks`, which a participant surface is not told. */
9
+ export const WEEK_LENGTH = LAST_DAY;
10
+
11
+ /**
12
+ * Every day the stall has traded, oldest first, read back from the host's history.
13
+ *
14
+ * The engine keeps only the latest day's `results` in context. Each earlier day
15
+ * is in the round the team closed, which `getPastState` returns, so this asks
16
+ * for those and adds the latest from live context. Nothing grows in context as
17
+ * the days go by, which is what keeps a long session cheap.
18
+ *
19
+ * `usePastState` reads again when the query changes, and the query is keyed on
20
+ * `completedTicks`, which moves when a day is played and when one is undone.
21
+ * The filter on `Day` drops a day an undo has taken back while the new read is
22
+ * still on its way.
23
+ *
24
+ * History is a nice-to-have on this screen: a failed read leaves the latest day
25
+ * on its own rather than an error.
26
+ */
27
+ export function useDays(): { days: DayResults[]; loading: boolean } {
28
+ const { data, completedTicks } = useUserInterfaceData<Context, Settings>();
29
+ const { entries, error, loading } = usePastState<Context>(
30
+ completedTicks < 2
31
+ ? null
32
+ : { fromTick: 1, toTick: completedTicks, capabilityIds: ['results'] }
33
+ );
34
+
35
+ const past = error ? [] : entries.map((entry) => entry.context.results);
36
+ const byDay = new Map<number, DayResults>();
37
+ for (const results of [...past, data.results]) {
38
+ if (results && results.Day > 0 && results.Day <= completedTicks) {
39
+ byDay.set(results.Day, results);
40
+ }
41
+ }
42
+ return {
43
+ days: [...byDay.values()].sort((a, b) => a.Day - b.Day),
44
+ loading: loading && completedTicks >= 2,
45
+ };
46
+ }
47
+
48
+ /** The day's lines, added up across the menu. */
49
+ export function totalsOf(results: DayResults) {
50
+ const lines = Object.values(results.Lines);
51
+ return {
52
+ made: lines.reduce((sum, line) => sum + line.Made, 0),
53
+ sold: lines.reduce((sum, line) => sum + line.Sold, 0),
54
+ pouredAway: lines.reduce((sum, line) => sum + line.PouredAway, 0),
55
+ turnedAway: lines.reduce((sum, line) => sum + line.TurnedAway, 0),
56
+ soldOut: lines.length > 0 && lines.every((line) => line.Made > 0 && line.Sold >= line.Made),
57
+ };
58
+ }
@@ -6,6 +6,10 @@ import { initReactI18next } from 'react-i18next';
6
6
  * translate. A game that reaches a second locale by hunting for hard-coded
7
7
  * strings finds about two thirds of them.
8
8
  *
9
+ * The words are the stall's, not the software's: 'Open the stall' rather than
10
+ * 'Submit', 'In the jar' rather than 'Balance'. The setting carries the lesson,
11
+ * and a screen that slips into form language loses it.
12
+ *
9
13
  * The host tells the surface which locale the session is in, and `main.tsx`
10
14
  * hands that to i18next. Adding a locale is a key in `resources` plus an entry
11
15
  * in `supportedLocales` in the manifest.
@@ -16,62 +20,112 @@ const resources = {
16
20
  shell: {
17
21
  untitledTeam: 'Your stall',
18
22
  looksAfter: 'You look after the {{item}}',
19
- day: 'Day {{day}}',
23
+ dayOf: '<0>Day {{day}}</0> of {{days}}',
24
+ notOpenYet: 'Not open yet',
25
+ closed: 'Closed for good',
26
+ tradingDone: 'All {{days}} days of trading are done',
20
27
  processing: 'The day is being played out',
21
28
  briefing: 'Notice',
22
29
  writeFailed: 'That did not reach the stall. Try again.',
23
30
  weekOver: 'The week is over. Nothing left to open.',
24
31
  countedNextDay: 'The day turned as you changed that, so it counts for day {{day}}.',
32
+ dismiss: 'Dismiss',
33
+ },
34
+ timeline: {
35
+ label: 'Days',
36
+ lookBack: 'Look back at day {{day}}',
37
+ showing: 'Day {{day}}, showing',
38
+ today: 'Day {{day}}, today',
39
+ backTo: 'Back to day {{day}}',
40
+ notYet: 'Day {{day}}, not played yet',
41
+ },
42
+ lookingBack: {
43
+ notice: 'You are looking back at day {{day}}, so nothing here can be changed. Your plan for day {{today}} is kept.',
44
+ made: 'What you made',
25
45
  },
26
46
  weather: {
27
- sunny: 'Sunny today. It is going to be busy.',
28
- cloudy: 'Cloudy today. An ordinary sort of day.',
29
- rainy: 'Rain today. Not many people about.',
30
47
  sunnyShort: 'Sunny',
31
48
  cloudyShort: 'Cloudy',
32
49
  rainyShort: 'Rainy',
50
+ sunnyLower: 'sunny',
51
+ cloudyLower: 'cloudy',
52
+ rainyLower: 'rainy',
53
+ today: '{{weather}} today',
54
+ onDay: '{{weather}} on day {{day}}',
55
+ sunny: 'It is going to be busy.',
56
+ cloudy: 'An ordinary sort of day.',
57
+ rainy: 'Not many people about.',
33
58
  },
34
- day: {
35
- making: 'Making {{planned}} of a possible {{capacity}}',
36
- ready: 'Open up, and day {{day}} plays out',
37
- tooMany: 'Take something off before you open up',
38
- nothing: 'Decide what to make first',
39
- open: 'Open the stall',
40
- },
41
- today: {
42
- title: 'What shall we make today?',
43
- capacity: '{{planned}} of {{capacity}}',
44
- room: 'Room for {{room}} more. The stall can make {{capacity}} things in a day.',
45
- over: 'That is {{over}} more than the stall can make. Somebody needs to take some off.',
46
- observing: 'You are watching this stall rather than working on it.',
59
+ firstDay: {
60
+ title: 'Your stall opens for {{days}} days',
61
+ body: 'Each day, decide how many of each thing to make. Make too few and people go away; make too many and it goes to waste.',
62
+ held: 'Your facilitator opens the first day.',
63
+ ready: 'Open the stall when your team is ready.',
47
64
  },
48
65
  make: {
66
+ title: 'What shall we make?',
67
+ count: '<0>{{planned}}</0> of {{capacity}}',
68
+ countLabel: '{{planned}} of {{capacity}} planned',
49
69
  yours: 'Yours',
50
- line: '{{price}} each, costs {{cost}} to make. About {{expected}} people will want one today.',
70
+ line: '{{price}} · costs {{cost}} · about {{expected}} want one',
71
+ lineWide:
72
+ '{{price}} each · costs {{cost}} to make · about {{expected}} people will want one',
51
73
  more: 'Make more {{name}}',
52
74
  fewer: 'Make less {{name}}',
75
+ observing: 'You are watching this stall rather than working on it.',
76
+ },
77
+ day: {
78
+ open: 'Open the stall for day {{day}}',
79
+ held: 'Your facilitator opens day {{day}}',
80
+ room: 'Room for {{room}} more before you open',
81
+ full: 'The stall is making all it can',
82
+ tooMany: 'That is {{over}} more than the stall can make. Take some off first.',
83
+ nothing: 'Decide what to make first',
84
+ saved: 'Your numbers are saved as you change them',
53
85
  },
54
86
  yesterday: {
55
- title: 'How yesterday went',
56
- on: 'Day {{day}}, {{weather}}',
57
- none: 'Nothing sold yet',
58
- firstDay: 'Set your numbers, and the stall opens when the facilitator says so.',
87
+ title: 'Yesterday',
88
+ on: 'Day {{day}} · {{weather}}',
89
+ profit: 'profit, from {{takings}} taken and {{spent}} spent',
90
+ loss: 'lost, from {{takings}} taken and {{spent}} spent',
91
+ showDays: 'See every day so far',
92
+ hideDays: 'Hide the days',
93
+ },
94
+ lesson: {
95
+ turnedAway_one: '{{count}} person was turned away.',
96
+ turnedAway_other: '{{count}} people were turned away.',
97
+ soldOut: 'You sold out of everything.',
98
+ alsoUnsold_one: 'And {{count}} went unsold.',
99
+ alsoUnsold_other: 'And {{count}} went unsold.',
100
+ unsold_one: '{{count}} went unsold.',
101
+ unsold_other: '{{count}} went unsold.',
102
+ nobodyTurnedAway: 'Nobody was turned away.',
103
+ spotOn: 'Everything sold, and nobody went without.',
104
+ },
105
+ history: {
106
+ title: 'Every day so far',
107
+ allTitle: 'Every day',
108
+ day: 'Day',
109
+ weather: 'Weather',
59
110
  item: 'Item',
60
111
  made: 'Made',
61
112
  wanted: 'Wanted',
62
113
  sold: 'Sold',
63
- pouredAway: 'Poured away',
64
114
  turnedAway: 'Turned away',
65
- takings: 'Took',
66
- spent: 'Spent',
67
- profit: 'Made',
68
- purse: 'In the jar',
115
+ profit: 'Profit',
116
+ showAll: 'Show all {{count}} days',
117
+ showFewer: 'Show fewer',
69
118
  },
70
- history: {
71
- title: 'Every day so far',
72
- hint: 'What you made, what people wanted, and what was left.',
73
- day: 'Day',
74
- weather: 'Weather',
119
+ final: {
120
+ jar: 'In the jar after {{days}} days',
121
+ debrief: 'Your facilitator will talk through how every stall did',
122
+ bestDay: 'Best day',
123
+ bestDayValue: 'Day {{day}} · {{profit}}',
124
+ turnedAway: 'Turned away',
125
+ turnedAwayValue_one: '{{count}} person',
126
+ turnedAwayValue_other: '{{count}} people',
127
+ unsold: 'Went unsold',
128
+ bestSeller: 'Best seller',
75
129
  },
76
130
  theme: {
77
131
  label: 'Light or dark',
@@ -22,6 +22,7 @@ export const baseContext: Context = {
22
22
  },
23
23
  roles: { LooksAfter: {} },
24
24
  briefing: { Message: '' },
25
+ pacing: { LastOpenDay: 10 },
25
26
  };
26
27
 
27
28
  /** A day that has been played, for the panels that only appear once one has. */
@@ -14,21 +14,21 @@ export const useAppTheme = () => {
14
14
  return useMemo(
15
15
  () =>
16
16
  createTheme(createSurfaceTheme(theme, { fonts: { body: 'Work Sans Variable' } }), {
17
- shape: { borderRadius: 10 },
17
+ shape: { borderRadius: 12 },
18
18
  components: {
19
- MuiButton: { styleOverrides: { root: { textTransform: 'none' } } },
19
+ MuiButton: {
20
+ styleOverrides: { root: { textTransform: 'none', fontWeight: 600 } },
21
+ },
22
+ MuiCard: { styleOverrides: { root: { borderRadius: 16 } } },
20
23
  MuiTab: {
21
24
  styleOverrides: { root: { textTransform: 'none', fontSize: '0.95rem' } },
22
25
  },
23
26
  MuiToggleButton: { styleOverrides: { root: { textTransform: 'none' } } },
24
27
  MuiTableCell: {
25
28
  styleOverrides: {
26
- head: {
27
- fontSize: '0.75rem',
28
- fontWeight: 700,
29
- letterSpacing: '0.07em',
30
- textTransform: 'uppercase',
31
- },
29
+ root: { paddingLeft: 0, paddingRight: 8 },
30
+ head: { fontSize: '0.75rem', fontWeight: 600 },
31
+ body: { fontVariantNumeric: 'tabular-nums' },
32
32
  },
33
33
  },
34
34
  },
@@ -68,6 +68,12 @@ export interface Context {
68
68
  */
69
69
  Message: string;
70
70
  };
71
+ pacing: {
72
+ /**
73
+ * The last day a stall may open. The facilitator lowers it to hold the room at a day, and raises it to let them on; the default opens all ten
74
+ */
75
+ LastOpenDay: number;
76
+ };
71
77
  }
72
78
  export interface DayLine {
73
79
  Made: number;
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "definition": {
3
- "reads": ["plan", "weather", "results", "roles", "briefing"],
3
+ "reads": ["plan", "weather", "results", "roles", "briefing", "pacing"],
4
4
  "writes": ["plan"],
5
5
  "settings": ["menu", "ui"]
6
6
  },
@@ -0,0 +1,13 @@
1
+ // This file is auto-generated from the schemas the resource declares: the values
2
+ // a session starts with, for use as test fixtures.
3
+ // Do not edit this file directly. It will be regenerated on build.
4
+
5
+ import type { Context, Settings } from './types';
6
+
7
+ export const defaultContext: Context = {
8
+ pacing: {
9
+ LastOpenDay: 10,
10
+ },
11
+ };
12
+
13
+ export const defaultSettings: Settings = {};