@seriousgaming/sdk-tools 1.4.0 → 1.5.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 (157) hide show
  1. package/dist/cli.js +830 -99
  2. package/dist/client.js +114 -11
  3. package/dist/dev/console/assets/{index-BvB-LFQZ.js → index-BVF8exas.js} +21 -21
  4. package/dist/dev/console/index.html +1 -1
  5. package/dist/dev/public-origins.d.ts +61 -0
  6. package/dist/dev/shell.d.ts +32 -4
  7. package/dist/docs/ai-agents.md +5 -0
  8. package/dist/docs/changelog-0.x.md +2 -2
  9. package/dist/docs/changelog.md +37 -4
  10. package/dist/docs/cli-and-dev-server.md +58 -0
  11. package/dist/docs/cli-error-codes.md +39 -36
  12. package/dist/docs/cli-reference.md +68 -21
  13. package/dist/docs/environment-variables.md +10 -5
  14. package/dist/docs/guides/ai-facilitation.md +2 -0
  15. package/dist/docs/guides/capabilities.md +2 -0
  16. package/dist/docs/guides/designing-a-game.md +2 -0
  17. package/dist/docs/guides/designing-screens.md +133 -0
  18. package/dist/docs/guides/endpoints.md +2 -0
  19. package/dist/docs/guides/engine-testing.md +5 -1
  20. package/dist/docs/guides/engine.md +2 -0
  21. package/dist/docs/guides/file-handling.md +3 -1
  22. package/dist/docs/guides/games.md +3 -1
  23. package/dist/docs/guides/global-settings.md +2 -0
  24. package/dist/docs/guides/guide.md +2 -0
  25. package/dist/docs/guides/hooks.md +2 -0
  26. package/dist/docs/guides/index.md +9 -0
  27. package/dist/docs/guides/internationalization.md +2 -0
  28. package/dist/docs/guides/llm-integration.md +4 -2
  29. package/dist/docs/guides/multi-team-games.md +3 -1
  30. package/dist/docs/guides/patterns.md +2 -0
  31. package/dist/docs/guides/presentation.md +1 -1
  32. package/dist/docs/guides/production-constraints.md +2 -0
  33. package/dist/docs/guides/scenario-editor.md +2 -0
  34. package/dist/docs/guides/scenarios.md +6 -2
  35. package/dist/docs/guides/session-game-flow.md +365 -0
  36. package/dist/docs/guides/session-hooks.md +205 -0
  37. package/dist/docs/guides/session.md +27 -565
  38. package/dist/docs/guides/settings.md +2 -0
  39. package/dist/docs/guides/setup.md +3 -1
  40. package/dist/docs/guides/speech-generation.md +2 -0
  41. package/dist/docs/guides/starter-game.md +61 -21
  42. package/dist/docs/guides/testing.md +2 -0
  43. package/dist/docs/guides/tick-controller.md +3 -1
  44. package/dist/docs/guides/type-safety.md +2 -0
  45. package/dist/docs/guides/ui-files-and-llms.md +328 -0
  46. package/dist/docs/guides/ui-participants.md +281 -0
  47. package/dist/docs/guides/ui-styling.md +263 -0
  48. package/dist/docs/guides/ui-ticks.md +247 -0
  49. package/dist/docs/guides/ui.md +11 -1092
  50. package/dist/docs/guides/upgrading.md +2 -0
  51. package/dist/docs/guides/validators.md +2 -0
  52. package/dist/docs/guides/waiting-room.md +1 -1
  53. package/dist/docs/index.md +2 -1
  54. package/dist/docs/page-index.md +145 -0
  55. package/dist/docs/recipes/adapt-a-game-for-walkthroughs.md +1 -1
  56. package/dist/docs/recipes/adapt-ui-for-observers.md +1 -1
  57. package/dist/docs/recipes/create-presentation.md +11 -0
  58. package/dist/docs/recipes/create-scenario-editor.md +1 -0
  59. package/dist/docs/recipes/create-session-ui.md +2 -1
  60. package/dist/docs/recipes/create-setup.md +1 -0
  61. package/dist/docs/recipes/create-user-interface.md +1 -0
  62. package/dist/docs/recipes/create-waiting-room-ui.md +1 -0
  63. package/dist/docs/recipes/design-state-for-concurrent-writes.md +1 -1
  64. package/dist/docs/recipes/fix-duplicate-packages.md +2 -2
  65. package/dist/docs/recipes/index.md +3 -0
  66. package/dist/docs/recipes/screenshot-a-surface.md +80 -0
  67. package/dist/docs/recipes/test-a-multi-role-game.md +1 -1
  68. package/dist/docs/recipes/use-request-tick.md +2 -2
  69. package/dist/execution/config-resolver.d.ts +4 -1
  70. package/dist/runtime/manifest-version.d.ts +1 -1
  71. package/dist/runtime.js +1 -1
  72. package/dist/templates/package/CLAUDE.md.template +14 -5
  73. package/dist/templates/package/DESIGN.md.liquid +39 -7
  74. package/dist/templates/package/README.md.liquid +1 -1
  75. package/dist/templates/package/claude/rules/workflow-create-user-interface.md +1 -1
  76. package/dist/templates/package/pnpm-workspace.yaml.template +13 -0
  77. package/dist/templates/starter-game/capabilities/pacing/capability.sdk.json +18 -0
  78. package/dist/templates/starter-game/package.json +2 -0
  79. package/dist/templates/starter-game/presentation/defaults.ts +52 -0
  80. package/dist/templates/starter-game/presentation/index.html +20 -0
  81. package/dist/templates/starter-game/presentation/presentation.sdk.json +10 -0
  82. package/dist/templates/starter-game/presentation/src/App.tsx +55 -0
  83. package/dist/templates/starter-game/presentation/src/Band.tsx +40 -0
  84. package/dist/templates/starter-game/presentation/src/Slides.tsx +415 -0
  85. package/dist/templates/starter-game/presentation/src/WeatherIcon.tsx +21 -0
  86. package/dist/templates/starter-game/presentation/src/i18n.ts +88 -0
  87. package/dist/templates/starter-game/presentation/src/main.tsx +15 -0
  88. package/dist/templates/starter-game/presentation/src/stalls.test.ts +196 -0
  89. package/dist/templates/starter-game/presentation/src/stalls.ts +199 -0
  90. package/dist/templates/starter-game/presentation/types.ts +94 -0
  91. package/dist/templates/starter-game/seriousgaming.sdk.json +2 -1
  92. package/dist/templates/starter-game/session/defaults.ts +6 -0
  93. package/dist/templates/starter-game/session/index.html +1 -1
  94. package/dist/templates/starter-game/session/session.sdk.json +2 -2
  95. package/dist/templates/starter-game/session/src/App.test.tsx +436 -115
  96. package/dist/templates/starter-game/session/src/App.tsx +372 -222
  97. package/dist/templates/starter-game/session/src/JoinCodes.tsx +184 -0
  98. package/dist/templates/starter-game/session/src/ManagePanel.tsx +188 -0
  99. package/dist/templates/starter-game/session/src/Results.tsx +340 -0
  100. package/dist/templates/starter-game/session/src/SessionBar.tsx +179 -0
  101. package/dist/templates/starter-game/session/src/SessionPanels.tsx +105 -0
  102. package/dist/templates/starter-game/session/src/SidePanel.tsx +89 -0
  103. package/dist/templates/starter-game/session/src/StallCard.tsx +253 -0
  104. package/dist/templates/starter-game/session/src/TopBar.tsx +36 -0
  105. package/dist/templates/starter-game/session/src/i18n.ts +91 -24
  106. package/dist/templates/starter-game/session/src/status.ts +28 -0
  107. package/dist/templates/starter-game/session/types.ts +8 -2
  108. package/dist/templates/starter-game/shared/Awning.tsx +31 -0
  109. package/dist/templates/starter-game/shared/HostLogo.test.tsx +38 -0
  110. package/dist/templates/starter-game/shared/HostLogo.tsx +48 -0
  111. package/dist/templates/starter-game/shared/StallIcons.tsx +83 -0
  112. package/dist/templates/starter-game/shared/days.ts +11 -0
  113. package/dist/templates/starter-game/shared/format.test.ts +13 -0
  114. package/dist/templates/starter-game/{ui/src → shared}/format.ts +1 -1
  115. package/dist/templates/starter-game/testing/e2e/game.spec.ts +42 -8
  116. package/dist/templates/starter-game/ui/defaults.ts +3 -0
  117. package/dist/templates/starter-game/ui/src/App.test.tsx +197 -29
  118. package/dist/templates/starter-game/ui/src/App.tsx +176 -99
  119. package/dist/templates/starter-game/ui/src/DayBar.test.tsx +50 -7
  120. package/dist/templates/starter-game/ui/src/DayBar.tsx +96 -38
  121. package/dist/templates/starter-game/ui/src/DaysTable.tsx +69 -0
  122. package/dist/templates/starter-game/ui/src/FirstDay.tsx +37 -0
  123. package/dist/templates/starter-game/ui/src/Header.tsx +257 -0
  124. package/dist/templates/starter-game/ui/src/Lesson.tsx +63 -0
  125. package/dist/templates/starter-game/ui/src/MakeRow.tsx +98 -71
  126. package/dist/templates/starter-game/ui/src/Notices.tsx +59 -0
  127. package/dist/templates/starter-game/ui/src/PastDay.tsx +88 -0
  128. package/dist/templates/starter-game/ui/src/Section.tsx +26 -26
  129. package/dist/templates/starter-game/ui/src/ThemeToggle.tsx +25 -11
  130. package/dist/templates/starter-game/ui/src/TodayPanel.test.tsx +37 -33
  131. package/dist/templates/starter-game/ui/src/TodayPanel.tsx +66 -52
  132. package/dist/templates/starter-game/ui/src/WeatherCard.tsx +47 -0
  133. package/dist/templates/starter-game/ui/src/WeekOver.tsx +145 -0
  134. package/dist/templates/starter-game/ui/src/YesterdayPanel.tsx +65 -114
  135. package/dist/templates/starter-game/ui/src/days.ts +58 -0
  136. package/dist/templates/starter-game/ui/src/i18n.ts +86 -32
  137. package/dist/templates/starter-game/ui/src/test-helpers.ts +1 -0
  138. package/dist/templates/starter-game/ui/src/theme.ts +8 -8
  139. package/dist/templates/starter-game/ui/types.ts +6 -0
  140. package/dist/templates/starter-game/ui/ui.sdk.json +1 -1
  141. package/dist/templates/starter-game/validators/daylimit/defaults.ts +13 -0
  142. package/dist/templates/starter-game/validators/daylimit/logic/logic.test.ts +20 -0
  143. package/dist/templates/starter-game/validators/daylimit/logic/logic.ts +23 -0
  144. package/dist/templates/starter-game/validators/daylimit/types.ts +23 -0
  145. package/dist/templates/starter-game/validators/daylimit/validator.sdk.json +10 -0
  146. package/dist/templates/starter-game/waiting_room/src/App.test.tsx +83 -5
  147. package/dist/templates/starter-game/waiting_room/src/App.tsx +262 -119
  148. package/dist/templates/starter-game/waiting_room/src/i18n.ts +8 -4
  149. package/dist/utils/error-codes.d.ts +12 -0
  150. package/package.json +11 -4
  151. package/dist/templates/starter-game/session/src/Section.tsx +0 -37
  152. package/dist/templates/starter-game/session/src/TeamDoor.tsx +0 -96
  153. package/dist/templates/starter-game/session/src/format.ts +0 -8
  154. package/dist/templates/starter-game/ui/src/HistoryPanel.test.tsx +0 -74
  155. package/dist/templates/starter-game/ui/src/HistoryPanel.tsx +0 -120
  156. package/dist/templates/starter-game/ui/src/HostLogo.test.tsx +0 -25
  157. package/dist/templates/starter-game/ui/src/HostLogo.tsx +0 -38
@@ -0,0 +1,37 @@
1
+ import { Box, Typography } from '@mui/material';
2
+ import { alpha } from '@mui/material/styles';
3
+ import { useTranslation } from 'react-i18next';
4
+
5
+ import { WEEK_LENGTH } from './days';
6
+
7
+ /**
8
+ * Before the first day: what the game is and what to do first, in place of a
9
+ * 'yesterday' that has not happened. A results card full of zeroes would teach
10
+ * the reader to ignore that card for the rest of the week.
11
+ */
12
+ export default function FirstDay({ held }: { held: boolean }) {
13
+ const { t } = useTranslation();
14
+
15
+ return (
16
+ <Box
17
+ component="section"
18
+ aria-labelledby="first-day-heading"
19
+ data-testid="first-day"
20
+ sx={(theme) => ({
21
+ display: 'flex',
22
+ flexDirection: 'column',
23
+ gap: 1,
24
+ bgcolor: alpha(theme.palette.primary.main, 0.07),
25
+ borderRadius: '16px',
26
+ p: 2,
27
+ })}
28
+ >
29
+ <Typography id="first-day-heading" variant="h6" component="h2" sx={{ fontWeight: 600 }}>
30
+ {t('firstDay.title', { days: WEEK_LENGTH })}
31
+ </Typography>
32
+ <Typography>
33
+ {t('firstDay.body')} {held ? t('firstDay.held') : t('firstDay.ready')}
34
+ </Typography>
35
+ </Box>
36
+ );
37
+ }
@@ -0,0 +1,257 @@
1
+ import { Box, ButtonBase, Typography } from '@mui/material';
2
+ import { alpha, type Theme } from '@mui/material/styles';
3
+ import {
4
+ useUserInterfaceData,
5
+ useUserInterfaceOwnTeam,
6
+ useUserInterfaceParticipant,
7
+ } from '@seriousgaming/sdk/ui';
8
+ import { Trans, useTranslation } from 'react-i18next';
9
+
10
+ import HostLogo from '../../shared/HostLogo';
11
+ import type { Context, Settings } from '../types';
12
+ import { WEEK_LENGTH } from './days';
13
+ import ThemeToggle from './ThemeToggle';
14
+
15
+ export type Phase = 'first' | 'week' | 'over';
16
+
17
+ type Props = {
18
+ phase: Phase;
19
+ /** The facilitator has not opened the next day yet. */
20
+ held: boolean;
21
+ lookingAt: number | null;
22
+ onLook: (day: number | null) => void;
23
+ wide: boolean;
24
+ };
25
+
26
+ /**
27
+ * The stall's sign: whose stall this is, what the reader looks after, and where
28
+ * the week has got to.
29
+ *
30
+ * The timeline is the week at a glance and the way back into it. Each day
31
+ * already played is a button that opens that day; today is outlined; the days
32
+ * still to come are there but quiet, so the reader can see how much of the week
33
+ * is left without counting.
34
+ */
35
+ export default function Header({ phase, held, lookingAt, onLook, wide }: Props) {
36
+ const { data, settings, completedTicks } = useUserInterfaceData<Context, Settings>();
37
+ const participant = useUserInterfaceParticipant();
38
+ const ownTeam = useUserInterfaceOwnTeam();
39
+ const { t } = useTranslation();
40
+
41
+ const looksAfter = participant ? data.roles.LooksAfter[participant.id] : undefined;
42
+ const yourItem = looksAfter ? settings.menu.Menu[looksAfter]?.Name : undefined;
43
+ const day = completedTicks + 1;
44
+
45
+ const where =
46
+ phase === 'over' ? (
47
+ t('shell.closed')
48
+ ) : phase === 'first' && held ? (
49
+ t('shell.notOpenYet')
50
+ ) : (
51
+ <Trans
52
+ i18nKey="shell.dayOf"
53
+ values={{ day, days: WEEK_LENGTH }}
54
+ components={[<span key="day" data-testid="day" />]}
55
+ />
56
+ );
57
+
58
+ const subtitle =
59
+ phase === 'over'
60
+ ? t('shell.tradingDone', { days: WEEK_LENGTH })
61
+ : yourItem
62
+ ? t('shell.looksAfter', { item: yourItem })
63
+ : undefined;
64
+
65
+ const name = (
66
+ <Box sx={{ minWidth: 0 }}>
67
+ <Typography
68
+ variant={wide ? 'h5' : 'h4'}
69
+ component="h1"
70
+ noWrap
71
+ sx={{ fontWeight: 700, lineHeight: 1.15, fontSize: wide ? '1.5rem' : '1.6rem' }}
72
+ >
73
+ {ownTeam?.name ?? t('shell.untitledTeam')}
74
+ </Typography>
75
+ {subtitle && (
76
+ <Typography variant="body2" sx={{ opacity: 0.9, mt: 0.5 }}>
77
+ {subtitle}
78
+ </Typography>
79
+ )}
80
+ </Box>
81
+ );
82
+
83
+ const timeline = phase === 'week' && (
84
+ <Timeline day={day} lookingAt={lookingAt} onLook={onLook} wide={wide} />
85
+ );
86
+
87
+ return (
88
+ <Box
89
+ component="header"
90
+ sx={(theme) => ({
91
+ bgcolor: 'primary.main',
92
+ color: 'primary.contrastText',
93
+ px: wide ? 4 : 2,
94
+ pt: 1.75,
95
+ pb: wide ? 2.25 : 2.75,
96
+ display: 'flex',
97
+ flexDirection: wide ? 'row' : 'column',
98
+ alignItems: wide ? 'center' : 'stretch',
99
+ gap: wide ? 2.5 : 1.75,
100
+ '& a, & button': { fontFamily: theme.typography.fontFamily },
101
+ })}
102
+ >
103
+ {wide ? (
104
+ <>
105
+ <HostLogo />
106
+ <Box sx={{ flex: 1, minWidth: 0 }}>{name}</Box>
107
+ <Typography sx={{ fontWeight: 600, fontVariantNumeric: 'tabular-nums' }}>
108
+ {where}
109
+ </Typography>
110
+ {timeline}
111
+ <ThemeToggle />
112
+ </>
113
+ ) : (
114
+ <>
115
+ <Box sx={{ display: 'flex', alignItems: 'center', gap: 1 }}>
116
+ <HostLogo />
117
+ <Box sx={{ flex: 1 }} />
118
+ <Typography
119
+ component="span"
120
+ variant="body2"
121
+ sx={(theme) => ({
122
+ fontWeight: 600,
123
+ fontVariantNumeric: 'tabular-nums',
124
+ bgcolor: alpha(theme.palette.primary.contrastText, 0.18),
125
+ borderRadius: 999,
126
+ px: 1.5,
127
+ py: 0.5,
128
+ })}
129
+ >
130
+ {where}
131
+ </Typography>
132
+ <ThemeToggle />
133
+ </Box>
134
+ {name}
135
+ {timeline}
136
+ </>
137
+ )}
138
+ </Box>
139
+ );
140
+ }
141
+
142
+ type TimelineProps = {
143
+ /** The day about to be played. */
144
+ day: number;
145
+ lookingAt: number | null;
146
+ onLook: (day: number | null) => void;
147
+ wide: boolean;
148
+ };
149
+
150
+ function Timeline({ day, lookingAt, onLook, wide }: TimelineProps) {
151
+ const { t } = useTranslation();
152
+ const days = Array.from({ length: WEEK_LENGTH }, (_, index) => index + 1);
153
+
154
+ return (
155
+ <Box
156
+ component="nav"
157
+ aria-label={t('timeline.label')}
158
+ data-testid="timeline"
159
+ sx={{ display: 'flex', gap: '5px', flex: wide ? 'none' : undefined }}
160
+ >
161
+ {days.map((d) => {
162
+ const size = wide
163
+ ? { width: 30, height: 30 }
164
+ : { flex: 1, minWidth: 0, height: 28 };
165
+ const base = {
166
+ ...size,
167
+ borderRadius: '8px',
168
+ fontSize: '0.8rem',
169
+ fontWeight: 600,
170
+ fontVariantNumeric: 'tabular-nums',
171
+ display: 'grid',
172
+ placeItems: 'center',
173
+ };
174
+
175
+ if (d < day) {
176
+ const showing = d === lookingAt;
177
+ return (
178
+ <ButtonBase
179
+ key={d}
180
+ aria-label={
181
+ showing
182
+ ? t('timeline.showing', { day: d })
183
+ : t('timeline.lookBack', { day: d })
184
+ }
185
+ aria-current={showing ? 'page' : undefined}
186
+ onClick={() => onLook(d)}
187
+ sx={(theme: Theme) => ({
188
+ ...base,
189
+ ...(showing
190
+ ? {
191
+ bgcolor: 'secondary.main',
192
+ color: 'secondary.contrastText',
193
+ boxShadow: `inset 0 0 0 2px ${theme.palette.primary.contrastText}`,
194
+ }
195
+ : {
196
+ bgcolor: alpha(theme.palette.primary.contrastText, 0.95),
197
+ color: 'primary.dark',
198
+ }),
199
+ '&.Mui-focusVisible': {
200
+ outline: `2px solid ${theme.palette.primary.contrastText}`,
201
+ outlineOffset: 2,
202
+ },
203
+ })}
204
+ >
205
+ {d}
206
+ </ButtonBase>
207
+ );
208
+ }
209
+
210
+ if (d === day) {
211
+ const outlined = (theme: Theme) => ({
212
+ ...base,
213
+ color: 'primary.contrastText',
214
+ boxShadow: `inset 0 0 0 2px ${theme.palette.primary.contrastText}`,
215
+ });
216
+ return lookingAt !== null ? (
217
+ <ButtonBase
218
+ key={d}
219
+ aria-label={t('timeline.backTo', { day: d })}
220
+ onClick={() => onLook(null)}
221
+ sx={outlined}
222
+ >
223
+ {d}
224
+ </ButtonBase>
225
+ ) : (
226
+ <Box
227
+ key={d}
228
+ component="span"
229
+ aria-current="step"
230
+ aria-label={t('timeline.today', { day: d })}
231
+ role="img"
232
+ sx={outlined}
233
+ >
234
+ {d}
235
+ </Box>
236
+ );
237
+ }
238
+
239
+ return (
240
+ <Box
241
+ key={d}
242
+ component="span"
243
+ role="img"
244
+ aria-label={t('timeline.notYet', { day: d })}
245
+ sx={(theme) => ({
246
+ ...base,
247
+ bgcolor: alpha(theme.palette.primary.contrastText, 0.16),
248
+ color: alpha(theme.palette.primary.contrastText, 0.8),
249
+ })}
250
+ >
251
+ {d}
252
+ </Box>
253
+ );
254
+ })}
255
+ </Box>
256
+ );
257
+ }
@@ -0,0 +1,63 @@
1
+ import CheckCircleRounded from '@mui/icons-material/CheckCircleRounded';
2
+ import DeleteOutlineRounded from '@mui/icons-material/DeleteOutlineRounded';
3
+ import GroupOffRounded from '@mui/icons-material/GroupOffRounded';
4
+ import { Box, Typography } from '@mui/material';
5
+ import { alpha, useTheme } from '@mui/material/styles';
6
+ import { useTranslation } from 'react-i18next';
7
+
8
+ import { type DayResults, totalsOf } from './days';
9
+
10
+ /**
11
+ * The one thing a day teaches, in a sentence.
12
+ *
13
+ * A day can go wrong two ways, and they cost differently: people turned away
14
+ * is money the stall never took, and stock left over is money it spent for
15
+ * nothing. The table of every number is a tap away; this line is what the
16
+ * reader takes into the next decision, so it names the bigger mistake first.
17
+ */
18
+ export default function Lesson({ results }: { results: DayResults }) {
19
+ const { t } = useTranslation();
20
+ const theme = useTheme();
21
+ const { turnedAway, pouredAway, soldOut } = totalsOf(results);
22
+
23
+ let Icon = CheckCircleRounded;
24
+ let headline: string;
25
+ let rest = '';
26
+ let tone = theme.palette.success.main;
27
+
28
+ if (turnedAway > 0) {
29
+ Icon = GroupOffRounded;
30
+ tone = theme.palette.warning.main;
31
+ headline = t('lesson.turnedAway', { count: turnedAway });
32
+ if (soldOut) rest = t('lesson.soldOut');
33
+ else if (pouredAway > 0) rest = t('lesson.alsoUnsold', { count: pouredAway });
34
+ } else if (pouredAway > 0) {
35
+ Icon = DeleteOutlineRounded;
36
+ tone = theme.palette.warning.main;
37
+ headline = t('lesson.unsold', { count: pouredAway });
38
+ rest = t('lesson.nobodyTurnedAway');
39
+ } else {
40
+ headline = t('lesson.spotOn');
41
+ }
42
+
43
+ return (
44
+ <Box
45
+ data-testid="lesson"
46
+ sx={{
47
+ display: 'flex',
48
+ gap: 1.25,
49
+ alignItems: 'flex-start',
50
+ bgcolor: alpha(tone, 0.12),
51
+ borderRadius: '12px',
52
+ px: 1.5,
53
+ py: 1.25,
54
+ }}
55
+ >
56
+ <Icon aria-hidden sx={{ fontSize: 20, color: tone, flex: 'none', mt: '1px' }} />
57
+ <Typography variant="body2">
58
+ <strong>{headline}</strong>
59
+ {rest && ` ${rest}`}
60
+ </Typography>
61
+ </Box>
62
+ );
63
+ }
@@ -1,9 +1,11 @@
1
- import { Box, Chip, IconButton, Slider, Stack, Typography } from '@mui/material';
2
- import { useEffect, useRef, useState } from 'react';
1
+ import AddRounded from '@mui/icons-material/AddRounded';
2
+ import RemoveRounded from '@mui/icons-material/RemoveRounded';
3
+ import { Box, Chip, IconButton, Stack, Typography } from '@mui/material';
3
4
  import { useTranslation } from 'react-i18next';
4
5
 
6
+ import { money } from '../../shared/format';
7
+ import { ItemIcon } from '../../shared/StallIcons';
5
8
  import type { MenuItem } from '../types';
6
- import { money } from './format';
7
9
 
8
10
  type Props = {
9
11
  id: string;
@@ -18,6 +20,8 @@ type Props = {
18
20
  /** True when this is the item the reader was put in charge of. */
19
21
  yours: boolean;
20
22
  disabled: boolean;
23
+ /** Room for the long description, at laptop width. */
24
+ wide?: boolean;
21
25
  onChange: (next: number) => void;
22
26
  };
23
27
 
@@ -29,10 +33,11 @@ type Props = {
29
33
  * is what makes two people working at once safe here, and it is a decision
30
34
  * about the shape of the state rather than anything clever in this file.
31
35
  *
32
- * The slider keeps a local value while it is being dragged and writes once, on
33
- * release. Writing on every frame of a drag would put fifty messages on the
34
- * wire for one decision, and a broadcast arriving mid-drag would fight the
35
- * reader's thumb.
36
+ * Two big buttons rather than a slider: a phone held in one hand at a stall
37
+ * hits a 44px target first time, and each press is one deliberate write of a
38
+ * whole step, where a drag is fifty frames of a number the reader did not mean.
39
+ * The number shown is always the game's, so a team-mate's change to this item
40
+ * appears here as soon as it lands.
36
41
  */
37
42
  export default function MakeRow({
38
43
  id,
@@ -44,86 +49,108 @@ export default function MakeRow({
44
49
  currencySymbol,
45
50
  yours,
46
51
  disabled,
52
+ wide = false,
47
53
  onChange,
48
54
  }: Props) {
49
55
  const { t } = useTranslation();
50
- const [dragging, setDragging] = useState(false);
51
- const [draft, setDraft] = useState(value);
52
- const draggingRef = useRef(dragging);
53
- draggingRef.current = dragging;
54
-
55
- // Follow the game except while this reader is mid-drag, so a team-mate's
56
- // change to this item still shows up.
57
- useEffect(() => {
58
- if (!draggingRef.current) setDraft(value);
59
- }, [value]);
60
-
61
- const shown = dragging ? draft : value;
62
- const nudge = (by: number) => onChange(Math.max(0, Math.min(max, shown + by)));
56
+ const nudge = (by: number) => onChange(Math.max(0, Math.min(max, value + by)));
63
57
 
64
58
  return (
65
- <Box data-testid={`make-${id}`}>
66
- <Stack
67
- direction="row"
68
- spacing={1}
69
- sx={{ alignItems: 'baseline', justifyContent: 'space-between' }}
70
- >
71
- <Stack direction="row" spacing={1} sx={{ alignItems: 'baseline' }}>
72
- <Typography variant="subtitle1">{item.Name}</Typography>
73
- {yours && <Chip size="small" color="primary" label={t('make.yours')} />}
59
+ <Box
60
+ data-testid={`make-${id}`}
61
+ sx={{
62
+ display: 'flex',
63
+ alignItems: 'center',
64
+ gap: { xs: 1.25, md: 1.75 },
65
+ px: { xs: 1.5, md: 2 },
66
+ py: 1.75,
67
+ }}
68
+ >
69
+ <ItemIcon id={id} />
70
+ <Box sx={{ flex: 1, minWidth: 0 }}>
71
+ <Stack direction="row" spacing={0.75} sx={{ alignItems: 'center' }}>
72
+ <Typography sx={{ fontWeight: 600 }}>{item.Name}</Typography>
73
+ {yours && (
74
+ <Chip
75
+ size="small"
76
+ color="primary"
77
+ variant="outlined"
78
+ label={t('make.yours')}
79
+ sx={{ height: 20, fontSize: '0.7rem', fontWeight: 600 }}
80
+ />
81
+ )}
74
82
  </Stack>
75
83
  <Typography
76
- variant="h5"
84
+ variant="body2"
85
+ color="text.secondary"
77
86
  sx={{ fontVariantNumeric: 'tabular-nums' }}
78
- data-testid={`made-${id}`}
79
87
  >
80
- {shown}
88
+ {t(wide ? 'make.lineWide' : 'make.line', {
89
+ price: money(currencySymbol, item.Price),
90
+ cost: money(currencySymbol, item.Cost),
91
+ expected,
92
+ })}
81
93
  </Typography>
82
- </Stack>
83
-
84
- <Typography variant="caption" color="text.secondary" component="p">
85
- {t('make.line', {
86
- price: money(currencySymbol, item.Price),
87
- cost: money(currencySymbol, item.Cost),
88
- expected,
89
- })}
90
- </Typography>
91
-
92
- <Stack direction="row" spacing={1} sx={{ alignItems: 'center' }}>
93
- <IconButton
94
- size="small"
95
- aria-label={t('make.fewer', { name: item.Name })}
96
- disabled={disabled || shown === 0}
94
+ </Box>
95
+ <Stack direction="row" spacing={0.75} sx={{ alignItems: 'center', flex: 'none' }}>
96
+ <Stepper
97
+ label={t('make.fewer', { name: item.Name })}
98
+ disabled={disabled || value <= 0}
97
99
  onClick={() => nudge(-step)}
98
100
  >
99
- <Typography component="span">−</Typography>
100
- </IconButton>
101
- <Slider
102
- aria-label={item.Name}
103
- value={shown}
104
- min={0}
105
- max={max}
106
- step={1}
107
- disabled={disabled}
108
- valueLabelDisplay="auto"
109
- onChange={(_, next) => {
110
- setDragging(true);
111
- setDraft(next as number);
112
- }}
113
- onChangeCommitted={(_, next) => {
114
- setDragging(false);
115
- onChange(next as number);
101
+ <RemoveRounded />
102
+ </Stepper>
103
+ <Typography
104
+ component="span"
105
+ data-testid={`made-${id}`}
106
+ sx={{
107
+ minWidth: 36,
108
+ textAlign: 'center',
109
+ fontSize: '1.25rem',
110
+ fontWeight: 600,
111
+ fontVariantNumeric: 'tabular-nums',
116
112
  }}
117
- />
118
- <IconButton
119
- size="small"
120
- aria-label={t('make.more', { name: item.Name })}
121
- disabled={disabled || shown >= max}
113
+ >
114
+ {value}
115
+ </Typography>
116
+ <Stepper
117
+ label={t('make.more', { name: item.Name })}
118
+ disabled={disabled || value >= max}
122
119
  onClick={() => nudge(step)}
123
120
  >
124
- <Typography component="span">+</Typography>
125
- </IconButton>
121
+ <AddRounded />
122
+ </Stepper>
126
123
  </Stack>
127
124
  </Box>
128
125
  );
129
126
  }
127
+
128
+ function Stepper({
129
+ label,
130
+ disabled,
131
+ onClick,
132
+ children,
133
+ }: {
134
+ label: string;
135
+ disabled: boolean;
136
+ onClick: () => void;
137
+ children: React.ReactNode;
138
+ }) {
139
+ return (
140
+ <IconButton
141
+ aria-label={label}
142
+ disabled={disabled}
143
+ onClick={onClick}
144
+ color="primary"
145
+ sx={{
146
+ width: 44,
147
+ height: 44,
148
+ borderRadius: '12px',
149
+ border: 1.5,
150
+ borderColor: 'divider',
151
+ }}
152
+ >
153
+ {children}
154
+ </IconButton>
155
+ );
156
+ }
@@ -0,0 +1,59 @@
1
+ import { Alert, Stack } from '@mui/material';
2
+ import { useUserInterfaceValidationRejections } from '@seriousgaming/sdk/ui';
3
+ import { useTranslation } from 'react-i18next';
4
+
5
+ import { useWrite } from './writes';
6
+
7
+ /**
8
+ * What came back from the last write, said beside the button that made it.
9
+ *
10
+ * These sit in the bottom bar, above the open button, rather than in a toast
11
+ * laid over the page: a toast covers the menu it is talking about, and goes
12
+ * before a person who looked away has read it. Each stays until it is
13
+ * dismissed or the next write replaces it.
14
+ */
15
+ export default function Notices() {
16
+ const { rejections, clearRejections } = useUserInterfaceValidationRejections();
17
+ const reporter = useWrite();
18
+ const { t } = useTranslation();
19
+
20
+ // A validator refusal arrives twice: here as a `validation-rejected`
21
+ // outcome, and through the rejection channel, which carries the
22
+ // validator's own message and is the better thing to show. Rendering both
23
+ // would put a generic notice on top of a specific one.
24
+ const unexplained =
25
+ reporter.failure && reporter.failure.outcome.kind !== 'validation-rejected'
26
+ ? reporter.failure
27
+ : null;
28
+
29
+ if (rejections.length === 0 && !unexplained && !reporter.late) return null;
30
+
31
+ return (
32
+ <Stack spacing={1} sx={{ mb: 1.5 }} role="status">
33
+ {/* The validator's own message, which is the one that says what the
34
+ rule was and who else was changing something. */}
35
+ {rejections.length > 0 && (
36
+ <Alert severity="warning" onClose={clearRejections}>
37
+ {rejections.map((rejection) => rejection.message).join(' ')}
38
+ </Alert>
39
+ )}
40
+
41
+ {/* What nothing else reports: denied, tick-failed, conflict, error. */}
42
+ {unexplained && (
43
+ <Alert severity="error" onClose={reporter.dismiss}>
44
+ {unexplained.outcome.kind === 'tick-failed'
45
+ ? t('shell.weekOver')
46
+ : t('shell.writeFailed')}
47
+ </Alert>
48
+ )}
49
+
50
+ {/* Not a failure. The change landed, but in the day after the one
51
+ they were looking at, and nothing else on screen says so. */}
52
+ {reporter.late && (
53
+ <Alert severity="info" onClose={reporter.dismiss}>
54
+ {t('shell.countedNextDay', { day: (reporter.late.committedAtTick ?? 0) + 1 })}
55
+ </Alert>
56
+ )}
57
+ </Stack>
58
+ );
59
+ }