@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,196 @@
1
+ import { createMockSharedState, createMockTeamState } from '@seriousgaming/sdk/ui/testing';
2
+ import { describe, expect, it } from 'vitest';
3
+
4
+ import { defaultTeamContext } from '../defaults';
5
+ import type { DayLine, PresentationSession, SharedContext, TeamContext } from '../types';
6
+ import {
7
+ collectBoards,
8
+ forecastFor,
9
+ forecastsByStall,
10
+ roomOnDay,
11
+ roomSoFar,
12
+ stallsOnDay,
13
+ standings,
14
+ type BoardContext,
15
+ type PastBoard,
16
+ type Weather,
17
+ } from './stalls';
18
+
19
+ const line = (TurnedAway: number): DayLine => ({
20
+ Made: 0,
21
+ Wanted: 0,
22
+ Sold: 0,
23
+ PouredAway: 0,
24
+ TurnedAway,
25
+ });
26
+
27
+ /** A stall's state after `day`: that day's results, and tomorrow's forecast. */
28
+ function after(
29
+ day: number,
30
+ { profit = 0, purse = 0, turnedAway = 0, tomorrow = 'sunny' as Weather } = {}
31
+ ): BoardContext {
32
+ return {
33
+ weather: { Today: tomorrow, Expected: {} },
34
+ results: {
35
+ ...defaultTeamContext.results,
36
+ Day: day,
37
+ Profit: profit,
38
+ Purse: purse,
39
+ Lines: { lemonade: line(turnedAway) },
40
+ },
41
+ };
42
+ }
43
+
44
+ const live = (completedTicks: number, context: BoardContext) =>
45
+ createMockTeamState<TeamContext>({
46
+ completedTicks,
47
+ context: { ...defaultTeamContext, ...context },
48
+ });
49
+
50
+ function session(teams: Record<string, ReturnType<typeof live>>): PresentationSession {
51
+ return {
52
+ id: 'session-1',
53
+ name: 'Tuesday',
54
+ completedTicks: Math.max(0, ...Object.values(teams).map((team) => team.completedTicks)),
55
+ data: { shared: createMockSharedState<SharedContext>(), teams },
56
+ teams: Object.keys(teams).map((teamId, index) => ({
57
+ teamId,
58
+ index,
59
+ name: `Stall ${index + 1}`,
60
+ })),
61
+ };
62
+ }
63
+
64
+ describe('gathering the boards', () => {
65
+ it('has nothing to show without a session', () => {
66
+ expect(collectBoards(null, [])).toEqual([]);
67
+ });
68
+
69
+ // A stall's latest day is live state; history holds the days before it.
70
+ it('takes earlier days from history and the latest from live state', () => {
71
+ const room = session({ 'team-1': live(2, after(2, { profit: 900 })) });
72
+ const past: PastBoard[] = [
73
+ { teamId: 'team-1', tick: 1, context: after(1, { profit: 400 }) },
74
+ { teamId: 'team-1', tick: 2, context: after(2, { profit: -1 }) },
75
+ ];
76
+
77
+ const boards = collectBoards(room, past);
78
+
79
+ expect(boards.map((board) => [board.tick, board.context.results.Profit])).toEqual([
80
+ [1, 400],
81
+ [2, 900],
82
+ ]);
83
+ });
84
+
85
+ it('drops history for a stall the session no longer has', () => {
86
+ const room = session({ 'team-1': live(1, after(1)) });
87
+
88
+ expect(collectBoards(room, [{ teamId: 'gone', tick: 1, context: after(1) }])).toHaveLength(
89
+ 1
90
+ );
91
+ });
92
+ });
93
+
94
+ describe('a day’s forecast', () => {
95
+ it('counts the weather each stall that has reached the day will face', () => {
96
+ const room = session({
97
+ 'team-1': live(2, after(2, { tomorrow: 'rainy' })),
98
+ 'team-2': live(2, after(2, { tomorrow: 'sunny' })),
99
+ 'team-3': live(2, after(2, { tomorrow: 'rainy' })),
100
+ 'team-4': live(1, after(1)),
101
+ });
102
+ const boards = collectBoards(room, []);
103
+
104
+ expect(forecastFor(boards, 3)).toEqual({ rainy: 2, sunny: 1 });
105
+ expect(forecastsByStall(boards, 3)).toEqual([
106
+ { name: 'Stall 1', weather: 'rainy' },
107
+ { name: 'Stall 2', weather: 'sunny' },
108
+ { name: 'Stall 3', weather: 'rainy' },
109
+ ]);
110
+ });
111
+
112
+ it('includes a stall that has already played the day, from its history', () => {
113
+ const room = session({ 'team-1': live(4, after(4)) });
114
+ const boards = collectBoards(room, [
115
+ { teamId: 'team-1', tick: 2, context: after(2, { tomorrow: 'cloudy' }) },
116
+ ]);
117
+
118
+ expect(forecastFor(boards, 3)).toEqual({ cloudy: 1 });
119
+ });
120
+
121
+ it('is empty for a day no stall has reached', () => {
122
+ const boards = collectBoards(session({ 'team-1': live(1, after(1)) }), []);
123
+
124
+ expect(forecastFor(boards, 5)).toEqual({});
125
+ });
126
+ });
127
+
128
+ describe('a day across the room', () => {
129
+ const room = session({
130
+ 'team-1': live(2, after(2, { profit: 1860, turnedAway: 40 })),
131
+ 'team-2': live(2, after(2, { profit: 2410, turnedAway: 8 })),
132
+ 'team-3': live(3, after(3, { profit: 9999 })),
133
+ 'team-4': live(1, after(1, { profit: 500 })),
134
+ });
135
+ const boards = collectBoards(room, [
136
+ { teamId: 'team-3', tick: 2, context: after(2, { profit: 2030, turnedAway: 60 }) },
137
+ ]);
138
+
139
+ // Stalls ahead count from their history; stalls behind are left out.
140
+ it('counts only the stalls that have played that day', () => {
141
+ expect(roomOnDay(boards, 2)).toEqual({
142
+ profit: { stalls: 3, average: 2100, lowest: 1860, highest: 2410 },
143
+ turnedAway: 108,
144
+ });
145
+ });
146
+
147
+ it('has no figures for a day no stall has played', () => {
148
+ expect(roomOnDay(boards, 4)).toBeNull();
149
+ expect(roomOnDay(boards, 0)).toBeNull();
150
+ });
151
+
152
+ it('keeps each stall’s own figures for the speaker notes, richest first', () => {
153
+ expect(stallsOnDay(boards, 2)).toEqual([
154
+ { name: 'Stall 2', profit: 2410, turnedAway: 8 },
155
+ { name: 'Stall 3', profit: 2030, turnedAway: 60 },
156
+ { name: 'Stall 1', profit: 1860, turnedAway: 40 },
157
+ ]);
158
+ });
159
+ });
160
+
161
+ describe('the results slide', () => {
162
+ it('ranks the stalls that have opened by what is in the purse', () => {
163
+ const room = session({
164
+ 'team-1': live(3, after(3, { purse: 1200 })),
165
+ 'team-2': live(5, after(5, { purse: 4500 })),
166
+ 'team-3': live(0, after(0)),
167
+ });
168
+
169
+ expect(standings(collectBoards(room, []))).toEqual([
170
+ { name: 'Stall 2', days: 5, purse: 4500 },
171
+ { name: 'Stall 1', days: 3, purse: 1200 },
172
+ ]);
173
+ });
174
+
175
+ it('sums the room across every day played, and says when stalls have days left', () => {
176
+ const room = session({
177
+ 'team-1': live(2, after(2, { purse: 1000, turnedAway: 5 })),
178
+ 'team-2': live(2, after(2, { purse: 3000, turnedAway: 1 })),
179
+ });
180
+ const boards = collectBoards(room, [
181
+ { teamId: 'team-1', tick: 1, context: after(1, { turnedAway: 10 }) },
182
+ { teamId: 'team-2', tick: 1, context: after(1, { turnedAway: 2 }) },
183
+ ]);
184
+
185
+ expect(roomSoFar(boards, 2)).toEqual({
186
+ purse: { stalls: 2, average: 2000, lowest: 1000, highest: 3000 },
187
+ turnedAway: 18,
188
+ unfinished: false,
189
+ });
190
+ expect(roomSoFar(boards, 10)?.unfinished).toBe(true);
191
+ });
192
+
193
+ it('has nothing to show before any stall has opened', () => {
194
+ expect(roomSoFar(collectBoards(null, []), 10)).toBeNull();
195
+ });
196
+ });
@@ -0,0 +1,199 @@
1
+ import type { PresentationSession, TeamContext } from '../types';
2
+
3
+ /**
4
+ * What the slides show of the room, worked out away from the slides so it can
5
+ * be tested without a deck.
6
+ *
7
+ * Two rules shape everything here:
8
+ *
9
+ * 1. The projector shows the room, never a stall. Every figure a slide shows
10
+ * is a count, an average or a range across stalls; what each stall did by
11
+ * name goes in the speaker notes, for the facilitator alone
12
+ * 2. The stalls run their own days, so on any one day some stalls have played
13
+ * it and the rest have not. A day's figures count only the stalls that have
14
+ * played it, and say how many that is, rather than assuming the room is in
15
+ * step
16
+ *
17
+ * A stall's live state holds only its latest day, so earlier days come from
18
+ * `getPastState`. The two are merged into one list of boards, one per stall
19
+ * per day, and every helper reads that list.
20
+ */
21
+
22
+ export type Weather = TeamContext['weather']['Today'];
23
+
24
+ /** What a slide reads of a stall's state. */
25
+ export type BoardContext = Pick<TeamContext, 'weather' | 'results'>;
26
+
27
+ /**
28
+ * One stall as it stood after `tick` days: the results of day `tick`, and the
29
+ * forecast for day `tick + 1`.
30
+ */
31
+ export interface Board {
32
+ teamId: string;
33
+ name: string;
34
+ tick: number;
35
+ context: BoardContext;
36
+ }
37
+
38
+ /** A past board, as `getPastState` returns one. */
39
+ export interface PastBoard {
40
+ teamId: string;
41
+ tick: number;
42
+ context: BoardContext;
43
+ }
44
+
45
+ /**
46
+ * Every board the deck can see: each stall's past days, and its live state as
47
+ * the latest. A stall's own latest day is live state rather than history, so
48
+ * where both carry the same day the live one wins.
49
+ */
50
+ export function collectBoards(
51
+ session: PresentationSession | null,
52
+ past: readonly PastBoard[]
53
+ ): Board[] {
54
+ if (!session) return [];
55
+ const names = new Map(session.teams.map((team) => [team.teamId, team.name]));
56
+ const boards = new Map<string, Board>();
57
+ for (const entry of past) {
58
+ const name = names.get(entry.teamId);
59
+ if (name === undefined) continue;
60
+ boards.set(`${entry.teamId}:${entry.tick}`, { ...entry, name });
61
+ }
62
+ for (const team of session.teams) {
63
+ const state = session.data.teams[team.teamId];
64
+ if (!state) continue;
65
+ boards.set(`${team.teamId}:${state.completedTicks}`, {
66
+ teamId: team.teamId,
67
+ name: team.name,
68
+ tick: state.completedTicks,
69
+ context: state.context,
70
+ });
71
+ }
72
+ return [...boards.values()];
73
+ }
74
+
75
+ /** How many stalls face each kind of weather on `day`, among those that have reached it. */
76
+ export type Forecast = Partial<Record<Weather, number>>;
77
+
78
+ export function forecastFor(boards: readonly Board[], day: number): Forecast {
79
+ const forecast: Forecast = {};
80
+ for (const board of boards) {
81
+ if (board.tick !== day - 1) continue;
82
+ const weather = board.context.weather.Today;
83
+ forecast[weather] = (forecast[weather] ?? 0) + 1;
84
+ }
85
+ return forecast;
86
+ }
87
+
88
+ /** Each stall that has reached `day`, with its forecast. For the speaker notes. */
89
+ export function forecastsByStall(
90
+ boards: readonly Board[],
91
+ day: number
92
+ ): { name: string; weather: Weather }[] {
93
+ return boards
94
+ .filter((board) => board.tick === day - 1)
95
+ .map((board) => ({ name: board.name, weather: board.context.weather.Today }));
96
+ }
97
+
98
+ export interface StallDay {
99
+ name: string;
100
+ /** In pence, as the engine keeps it. */
101
+ profit: number;
102
+ turnedAway: number;
103
+ }
104
+
105
+ const turnedAway = (context: BoardContext) =>
106
+ Object.values(context.results.Lines).reduce((sum, line) => sum + line.TurnedAway, 0);
107
+
108
+ /** What each stall that has played `day` did on it, richest first. For the speaker notes. */
109
+ export function stallsOnDay(boards: readonly Board[], day: number): StallDay[] {
110
+ if (day < 1) return [];
111
+ return boards
112
+ .filter((board) => board.tick === day)
113
+ .map((board) => ({
114
+ name: board.name,
115
+ profit: board.context.results.Profit,
116
+ turnedAway: turnedAway(board.context),
117
+ }))
118
+ .sort((a, b) => b.profit - a.profit);
119
+ }
120
+
121
+ export interface Spread {
122
+ /** How many stalls the figures come from. */
123
+ stalls: number;
124
+ /** In pence, rounded to the nearest penny. */
125
+ average: number;
126
+ lowest: number;
127
+ highest: number;
128
+ }
129
+
130
+ function spread(values: readonly number[]): Spread | null {
131
+ if (values.length === 0) return null;
132
+ const total = values.reduce((sum, value) => sum + value, 0);
133
+ return {
134
+ stalls: values.length,
135
+ average: Math.round(total / values.length),
136
+ lowest: Math.min(...values),
137
+ highest: Math.max(...values),
138
+ };
139
+ }
140
+
141
+ export interface RoomDay {
142
+ profit: Spread;
143
+ /** People who wanted something and went away without it, across the room. */
144
+ turnedAway: number;
145
+ }
146
+
147
+ /** The room's figures for `day`, from the stalls that have played it; null before any has. */
148
+ export function roomOnDay(boards: readonly Board[], day: number): RoomDay | null {
149
+ const played = stallsOnDay(boards, day);
150
+ const profit = spread(played.map((stall) => stall.profit));
151
+ if (!profit) return null;
152
+ return { profit, turnedAway: played.reduce((sum, stall) => sum + stall.turnedAway, 0) };
153
+ }
154
+
155
+ export interface Standing {
156
+ name: string;
157
+ days: number;
158
+ /** In pence, as the engine keeps it. */
159
+ purse: number;
160
+ }
161
+
162
+ /** Every stall that has opened at least once, by its latest day, richest first. */
163
+ export function standings(boards: readonly Board[]): Standing[] {
164
+ const latest = new Map<string, Board>();
165
+ for (const board of boards) {
166
+ if (board.tick < 1) continue;
167
+ const seen = latest.get(board.teamId);
168
+ if (!seen || board.tick > seen.tick) latest.set(board.teamId, board);
169
+ }
170
+ return [...latest.values()]
171
+ .map((board) => ({
172
+ name: board.name,
173
+ days: board.tick,
174
+ purse: board.context.results.Purse,
175
+ }))
176
+ .sort((a, b) => b.purse - a.purse);
177
+ }
178
+
179
+ export interface RoomSoFar {
180
+ purse: Spread;
181
+ /** Everyone turned away on every day any stall has played. */
182
+ turnedAway: number;
183
+ /** Whether any stall that has opened still has days to play. */
184
+ unfinished: boolean;
185
+ }
186
+
187
+ /** The room so far, for the results slide; null before any stall has opened. */
188
+ export function roomSoFar(boards: readonly Board[], days: number): RoomSoFar | null {
189
+ const table = standings(boards);
190
+ const purse = spread(table.map((stall) => stall.purse));
191
+ if (!purse) return null;
192
+ return {
193
+ purse,
194
+ turnedAway: boards
195
+ .filter((board) => board.tick >= 1)
196
+ .reduce((sum, board) => sum + turnedAway(board.context), 0),
197
+ unfinished: table.some((stall) => stall.days < days),
198
+ };
199
+ }
@@ -0,0 +1,94 @@
1
+ // This file is auto-generated from the presentation's capability definitions.
2
+ // Do not edit this file directly. It will be regenerated on build.
3
+
4
+ export interface Context {
5
+ plan: {
6
+ /**
7
+ * How many of each menu item to make today, keyed by item id. Keyed rather than a flat set of fields so that two people changing two different items write different keys, and the host's merge keeps both.
8
+ */
9
+ Make: {
10
+ [k: string]: number;
11
+ };
12
+ };
13
+ weather: {
14
+ /**
15
+ * The forecast for the day about to be played
16
+ */
17
+ Today: 'sunny' | 'cloudy' | 'rainy';
18
+ /**
19
+ * Roughly how many of each item people will want today, keyed by item id. A forecast, not a promise: the day lands somewhere near it.
20
+ */
21
+ Expected: {
22
+ [k: string]: number;
23
+ };
24
+ };
25
+ results: {
26
+ /**
27
+ * The day these results are for
28
+ */
29
+ Day: number;
30
+ /**
31
+ * What the weather actually did
32
+ */
33
+ Weather: string;
34
+ /**
35
+ * What happened to each menu item, keyed by item id
36
+ */
37
+ Lines: {
38
+ [k: string]: DayLine;
39
+ };
40
+ /**
41
+ * Money in, in pence
42
+ */
43
+ Takings: number;
44
+ /**
45
+ * Cost of everything made, in pence
46
+ */
47
+ Spent: number;
48
+ /**
49
+ * Takings less spend, in pence
50
+ */
51
+ Profit: number;
52
+ /**
53
+ * Everything made so far, in pence
54
+ */
55
+ Purse: number;
56
+ };
57
+ }
58
+ export interface DayLine {
59
+ Made: number;
60
+ /**
61
+ * How many people asked for one
62
+ */
63
+ Wanted: number;
64
+ Sold: number;
65
+ /**
66
+ * Made and not sold
67
+ */
68
+ PouredAway: number;
69
+ /**
70
+ * Asked for and not available
71
+ */
72
+ TurnedAway: number;
73
+ }
74
+
75
+ export type TeamContext = Pick<Context, 'plan' | 'weather' | 'results'>;
76
+
77
+ export type SharedContext = Record<string, never>;
78
+
79
+ import type { PresentationSession as SurfacePresentationSession } from '@seriousgaming/sdk/ui';
80
+
81
+ export type PresentationSession = SurfacePresentationSession<TeamContext, SharedContext>;
82
+
83
+ export interface Settings {
84
+ session: {
85
+ /**
86
+ * Whether the session surface offers the per-team join and observe links
87
+ */
88
+ ShowJoinLinks: boolean;
89
+ /**
90
+ * Symbol for money on the session surface. Prices are the same numbers whichever symbol is shown
91
+ */
92
+ CurrencySymbol: '£' | '$' | '€';
93
+ };
94
+ }
@@ -19,5 +19,6 @@
19
19
  "waitingRoom": {
20
20
  "openOnStart": true
21
21
  },
22
- "scenarioFormat": 1
22
+ "scenarioFormat": 1,
23
+ "requires": ["presentation-overlay"]
23
24
  }
@@ -23,6 +23,9 @@ export const defaultContext: Context = {
23
23
  briefing: {
24
24
  Message: '',
25
25
  },
26
+ pacing: {
27
+ LastOpenDay: 10,
28
+ },
26
29
  };
27
30
 
28
31
  export const defaultTeamContext: TeamContext = {
@@ -47,6 +50,9 @@ export const defaultSharedContext: SharedContext = {
47
50
  briefing: {
48
51
  Message: '',
49
52
  },
53
+ pacing: {
54
+ LastOpenDay: 10,
55
+ },
50
56
  };
51
57
 
52
58
  export const defaultSettings: Settings = {
@@ -3,7 +3,7 @@
3
3
  <head>
4
4
  <meta charset="UTF-8" />
5
5
  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
6
- <title>Allocation</title>
6
+ <title>Lemonade Stand</title>
7
7
  </head>
8
8
  <body>
9
9
  <div id="root"></div>
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "definition": {
3
- "reads": ["plan", "results", "roles", "briefing"],
4
- "writes": ["briefing"],
3
+ "reads": ["plan", "results", "roles", "briefing", "pacing"],
4
+ "writes": ["briefing", "pacing"],
5
5
  "settings": ["menu", "session"]
6
6
  },
7
7
  "ui": {