@pretty-chitty/core 2.0.0 → 2.1.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 (318) hide show
  1. package/README.md +8 -0
  2. package/dist/components/ActionLogDisplay.d.ts.map +1 -1
  3. package/dist/components/ActionLogDisplay.js +1 -1
  4. package/dist/components/ActionLogDisplay.js.map +1 -1
  5. package/dist/components/BottomBarButton.d.ts +3 -1
  6. package/dist/components/BottomBarButton.d.ts.map +1 -1
  7. package/dist/components/BottomBarButton.js +3 -2
  8. package/dist/components/BottomBarButton.js.map +1 -1
  9. package/dist/components/ContextGalleryDisplay.d.ts.map +1 -1
  10. package/dist/components/ContextGalleryDisplay.js +1 -1
  11. package/dist/components/ContextGalleryDisplay.js.map +1 -1
  12. package/dist/components/DemoWrapper.d.ts +30 -2
  13. package/dist/components/DemoWrapper.d.ts.map +1 -1
  14. package/dist/components/DemoWrapper.js +79 -36
  15. package/dist/components/DemoWrapper.js.map +1 -1
  16. package/dist/components/FullScreenGalleryDisplay.d.ts.map +1 -1
  17. package/dist/components/FullScreenGalleryDisplay.js +2 -2
  18. package/dist/components/FullScreenGalleryDisplay.js.map +1 -1
  19. package/dist/components/Gallery/BuiltItem.d.ts +6 -2
  20. package/dist/components/Gallery/BuiltItem.d.ts.map +1 -1
  21. package/dist/components/Gallery/BuiltItem.js +28 -9
  22. package/dist/components/Gallery/BuiltItem.js.map +1 -1
  23. package/dist/components/Gallery/GalleryController.d.ts +18 -0
  24. package/dist/components/Gallery/GalleryController.d.ts.map +1 -1
  25. package/dist/components/Gallery/GalleryController.js +67 -0
  26. package/dist/components/Gallery/GalleryController.js.map +1 -1
  27. package/dist/components/Gallery/GalleryViewer.d.ts +6 -1
  28. package/dist/components/Gallery/GalleryViewer.d.ts.map +1 -1
  29. package/dist/components/Gallery/GalleryViewer.js +48 -10
  30. package/dist/components/Gallery/GalleryViewer.js.map +1 -1
  31. package/dist/components/Gallery/LayoutManager.d.ts +6 -0
  32. package/dist/components/Gallery/LayoutManager.d.ts.map +1 -1
  33. package/dist/components/Gallery/LayoutManager.js +23 -3
  34. package/dist/components/Gallery/LayoutManager.js.map +1 -1
  35. package/dist/components/Gallery/constants.d.ts +2 -0
  36. package/dist/components/Gallery/constants.d.ts.map +1 -1
  37. package/dist/components/Gallery/constants.js +2 -0
  38. package/dist/components/Gallery/constants.js.map +1 -1
  39. package/dist/components/Gallery/registry.d.ts +34 -0
  40. package/dist/components/Gallery/registry.d.ts.map +1 -0
  41. package/dist/components/Gallery/registry.js +17 -0
  42. package/dist/components/Gallery/registry.js.map +1 -0
  43. package/dist/components/GameDesigner.d.ts.map +1 -1
  44. package/dist/components/GameDesigner.js +42 -10
  45. package/dist/components/GameDesigner.js.map +1 -1
  46. package/dist/components/InlineGalleryDisplay.d.ts.map +1 -1
  47. package/dist/components/InlineGalleryDisplay.js +2 -2
  48. package/dist/components/InlineGalleryDisplay.js.map +1 -1
  49. package/dist/components/LiveButton.d.ts.map +1 -1
  50. package/dist/components/LiveButton.js +5 -2
  51. package/dist/components/LiveButton.js.map +1 -1
  52. package/dist/components/MatchViewer.d.ts +6 -1
  53. package/dist/components/MatchViewer.d.ts.map +1 -1
  54. package/dist/components/MatchViewer.js +9 -3
  55. package/dist/components/MatchViewer.js.map +1 -1
  56. package/dist/components/Panel/MultiPanel.d.ts.map +1 -1
  57. package/dist/components/Panel/MultiPanel.js +18 -0
  58. package/dist/components/Panel/MultiPanel.js.map +1 -1
  59. package/dist/components/Panel/PanelContents.d.ts.map +1 -1
  60. package/dist/components/Panel/PanelContents.js +92 -23
  61. package/dist/components/Panel/PanelContents.js.map +1 -1
  62. package/dist/components/Panel/PanelTabStack.d.ts.map +1 -1
  63. package/dist/components/Panel/PanelTabStack.js +1 -1
  64. package/dist/components/Panel/PanelTabStack.js.map +1 -1
  65. package/dist/components/PanelSpark.d.ts.map +1 -1
  66. package/dist/components/PanelSpark.js +3 -2
  67. package/dist/components/PanelSpark.js.map +1 -1
  68. package/dist/components/Playground.d.ts.map +1 -1
  69. package/dist/components/Playground.js +10 -4
  70. package/dist/components/Playground.js.map +1 -1
  71. package/dist/components/PromptControls.d.ts.map +1 -1
  72. package/dist/components/PromptControls.js +4 -2
  73. package/dist/components/PromptControls.js.map +1 -1
  74. package/dist/components/SparkLineChart.d.ts.map +1 -1
  75. package/dist/components/SparkLineChart.js +22 -26
  76. package/dist/components/SparkLineChart.js.map +1 -1
  77. package/dist/components/TimeControlBar.d.ts.map +1 -1
  78. package/dist/components/TimeControlBar.js +5 -3
  79. package/dist/components/TimeControlBar.js.map +1 -1
  80. package/dist/components/TokenizedMarkdown.d.ts +23 -0
  81. package/dist/components/TokenizedMarkdown.d.ts.map +1 -0
  82. package/dist/components/TokenizedMarkdown.js +144 -0
  83. package/dist/components/TokenizedMarkdown.js.map +1 -0
  84. package/dist/components/TokenizedMessage.d.ts +6 -0
  85. package/dist/components/TokenizedMessage.d.ts.map +1 -1
  86. package/dist/components/TokenizedMessage.js +20 -19
  87. package/dist/components/TokenizedMessage.js.map +1 -1
  88. package/dist/components/TopBarPlayers.d.ts.map +1 -1
  89. package/dist/components/TopBarPlayers.js +1 -1
  90. package/dist/components/TopBarPlayers.js.map +1 -1
  91. package/dist/components/Tutorial/BrowserNarration.d.ts +55 -0
  92. package/dist/components/Tutorial/BrowserNarration.d.ts.map +1 -0
  93. package/dist/components/Tutorial/BrowserNarration.js +240 -0
  94. package/dist/components/Tutorial/BrowserNarration.js.map +1 -0
  95. package/dist/components/Tutorial/TutorialBox.d.ts +26 -0
  96. package/dist/components/Tutorial/TutorialBox.d.ts.map +1 -0
  97. package/dist/components/Tutorial/TutorialBox.js +239 -0
  98. package/dist/components/Tutorial/TutorialBox.js.map +1 -0
  99. package/dist/components/Tutorial/TutorialDevPanel.d.ts +9 -0
  100. package/dist/components/Tutorial/TutorialDevPanel.d.ts.map +1 -0
  101. package/dist/components/Tutorial/TutorialDevPanel.js +92 -0
  102. package/dist/components/Tutorial/TutorialDevPanel.js.map +1 -0
  103. package/dist/components/Tutorial/TutorialOverlay.d.ts +7 -0
  104. package/dist/components/Tutorial/TutorialOverlay.d.ts.map +1 -0
  105. package/dist/components/Tutorial/TutorialOverlay.js +1132 -0
  106. package/dist/components/Tutorial/TutorialOverlay.js.map +1 -0
  107. package/dist/components/Tutorial/targetRects.d.ts +67 -0
  108. package/dist/components/Tutorial/targetRects.d.ts.map +1 -0
  109. package/dist/components/Tutorial/targetRects.js +241 -0
  110. package/dist/components/Tutorial/targetRects.js.map +1 -0
  111. package/dist/game/Chit.d.ts +7 -0
  112. package/dist/game/Chit.d.ts.map +1 -1
  113. package/dist/game/Chit.js +20 -5
  114. package/dist/game/Chit.js.map +1 -1
  115. package/dist/game/ClientTimeState.d.ts +14 -0
  116. package/dist/game/ClientTimeState.d.ts.map +1 -1
  117. package/dist/game/ClientTimeState.js +17 -0
  118. package/dist/game/ClientTimeState.js.map +1 -1
  119. package/dist/game/Game.d.ts +6 -0
  120. package/dist/game/Game.d.ts.map +1 -1
  121. package/dist/game/GameTheme.d.ts +3 -0
  122. package/dist/game/GameTheme.d.ts.map +1 -1
  123. package/dist/game/GameTheme.js +2 -0
  124. package/dist/game/GameTheme.js.map +1 -1
  125. package/dist/game/Match.d.ts +8 -2
  126. package/dist/game/Match.d.ts.map +1 -1
  127. package/dist/game/Match.js +4 -1
  128. package/dist/game/Match.js.map +1 -1
  129. package/dist/game/Pick.d.ts +2 -0
  130. package/dist/game/Pick.d.ts.map +1 -1
  131. package/dist/game/Pick.js +17 -1
  132. package/dist/game/Pick.js.map +1 -1
  133. package/dist/game/PlayerPromptStatusChit.d.ts +8 -0
  134. package/dist/game/PlayerPromptStatusChit.d.ts.map +1 -1
  135. package/dist/game/PlayerPromptStatusChit.js +5 -1
  136. package/dist/game/PlayerPromptStatusChit.js.map +1 -1
  137. package/dist/game/Prompt.d.ts +15 -0
  138. package/dist/game/Prompt.d.ts.map +1 -1
  139. package/dist/game/Prompt.js +16 -0
  140. package/dist/game/Prompt.js.map +1 -1
  141. package/dist/game/Turn.d.ts +15 -4
  142. package/dist/game/Turn.d.ts.map +1 -1
  143. package/dist/game/Turn.js +173 -60
  144. package/dist/game/Turn.js.map +1 -1
  145. package/dist/game/TurnState.d.ts +12 -1
  146. package/dist/game/TurnState.d.ts.map +1 -1
  147. package/dist/game/TurnState.js +15 -3
  148. package/dist/game/TurnState.js.map +1 -1
  149. package/dist/game/ai/AiClientPrompts.d.ts +20 -3
  150. package/dist/game/ai/AiClientPrompts.d.ts.map +1 -1
  151. package/dist/game/ai/AiClientPrompts.js +42 -6
  152. package/dist/game/ai/AiClientPrompts.js.map +1 -1
  153. package/dist/game/ai/AiPlayerView.js +2 -0
  154. package/dist/game/ai/AiPlayerView.js.map +1 -1
  155. package/dist/game/clientTransport/ClientPrompts.d.ts +20 -1
  156. package/dist/game/clientTransport/ClientPrompts.d.ts.map +1 -1
  157. package/dist/game/clientTransport/ClientPrompts.js +30 -1
  158. package/dist/game/clientTransport/ClientPrompts.js.map +1 -1
  159. package/dist/game/clientTransport/ClientTime.d.ts +13 -0
  160. package/dist/game/clientTransport/ClientTime.d.ts.map +1 -1
  161. package/dist/game/clientTransport/ClientTime.js +51 -11
  162. package/dist/game/clientTransport/ClientTime.js.map +1 -1
  163. package/dist/game/tutorial/TutorialController.d.ts +300 -0
  164. package/dist/game/tutorial/TutorialController.d.ts.map +1 -0
  165. package/dist/game/tutorial/TutorialController.js +1182 -0
  166. package/dist/game/tutorial/TutorialController.js.map +1 -0
  167. package/dist/game/tutorial/TutorialRuntime.d.ts +89 -0
  168. package/dist/game/tutorial/TutorialRuntime.d.ts.map +1 -0
  169. package/dist/game/tutorial/TutorialRuntime.js +261 -0
  170. package/dist/game/tutorial/TutorialRuntime.js.map +1 -0
  171. package/dist/game/tutorial/TutorialTheme.d.ts +28 -0
  172. package/dist/game/tutorial/TutorialTheme.d.ts.map +1 -0
  173. package/dist/game/tutorial/TutorialTheme.js +39 -0
  174. package/dist/game/tutorial/TutorialTheme.js.map +1 -0
  175. package/dist/game/tutorial/allowed.d.ts +2 -0
  176. package/dist/game/tutorial/allowed.d.ts.map +1 -0
  177. package/dist/game/tutorial/allowed.js +119 -0
  178. package/dist/game/tutorial/allowed.js.map +1 -0
  179. package/dist/game/tutorial/checks.d.ts +58 -0
  180. package/dist/game/tutorial/checks.d.ts.map +1 -0
  181. package/dist/game/tutorial/checks.js +144 -0
  182. package/dist/game/tutorial/checks.js.map +1 -0
  183. package/dist/game/tutorial/createDemoMatch.d.ts +47 -0
  184. package/dist/game/tutorial/createDemoMatch.d.ts.map +1 -0
  185. package/dist/game/tutorial/createDemoMatch.js +67 -0
  186. package/dist/game/tutorial/createDemoMatch.js.map +1 -0
  187. package/dist/game/tutorial/defineTutorial.d.ts +353 -0
  188. package/dist/game/tutorial/defineTutorial.d.ts.map +1 -0
  189. package/dist/game/tutorial/defineTutorial.js +86 -0
  190. package/dist/game/tutorial/defineTutorial.js.map +1 -0
  191. package/dist/game/tutorial/runTutorial.d.ts +63 -0
  192. package/dist/game/tutorial/runTutorial.d.ts.map +1 -0
  193. package/dist/game/tutorial/runTutorial.js +273 -0
  194. package/dist/game/tutorial/runTutorial.js.map +1 -0
  195. package/dist/hooks/usePanelNavigation.d.ts +28 -0
  196. package/dist/hooks/usePanelNavigation.d.ts.map +1 -0
  197. package/dist/hooks/usePanelNavigation.js +36 -0
  198. package/dist/hooks/usePanelNavigation.js.map +1 -0
  199. package/dist/hooks/useTimeController.d.ts +2 -1
  200. package/dist/hooks/useTimeController.d.ts.map +1 -1
  201. package/dist/hooks/useTimeController.js +6 -2
  202. package/dist/hooks/useTimeController.js.map +1 -1
  203. package/dist/hooks/useTutorial.d.ts +48 -0
  204. package/dist/hooks/useTutorial.d.ts.map +1 -0
  205. package/dist/hooks/useTutorial.js +16 -0
  206. package/dist/hooks/useTutorial.js.map +1 -0
  207. package/dist/index.d.ts +36 -0
  208. package/dist/index.d.ts.map +1 -1
  209. package/dist/index.html +12 -0
  210. package/dist/index.js +19 -2
  211. package/dist/index.js.map +1 -1
  212. package/dist/main.0792d734cde2c688d5f7.hot-update.js +16991 -0
  213. package/dist/main.0792d734cde2c688d5f7.hot-update.js.map +1 -0
  214. package/dist/main.0792d734cde2c688d5f7.hot-update.json +1 -0
  215. package/dist/pretty-chitty.js +204513 -0
  216. package/dist/pretty-chitty.js.map +1 -0
  217. package/dist/rendering/CameraWrapperPerspective.d.ts +5 -0
  218. package/dist/rendering/CameraWrapperPerspective.d.ts.map +1 -1
  219. package/dist/rendering/CameraWrapperPerspective.js +16 -0
  220. package/dist/rendering/CameraWrapperPerspective.js.map +1 -1
  221. package/dist/rendering/ChitGalleryItemInstance.d.ts +1 -0
  222. package/dist/rendering/ChitGalleryItemInstance.d.ts.map +1 -1
  223. package/dist/rendering/ChitGalleryItemInstance.js +12 -0
  224. package/dist/rendering/ChitGalleryItemInstance.js.map +1 -1
  225. package/dist/rendering/ChitRenderInstance.d.ts +9 -1
  226. package/dist/rendering/ChitRenderInstance.d.ts.map +1 -1
  227. package/dist/rendering/ChitRenderInstance.js +28 -0
  228. package/dist/rendering/ChitRenderInstance.js.map +1 -1
  229. package/dist/rendering/RootChitRenderInstance.d.ts +2 -0
  230. package/dist/rendering/RootChitRenderInstance.d.ts.map +1 -1
  231. package/dist/rendering/RootChitRenderInstance.js +29 -0
  232. package/dist/rendering/RootChitRenderInstance.js.map +1 -1
  233. package/dist/utilities/Annotations.d.ts +15 -0
  234. package/dist/utilities/Annotations.d.ts.map +1 -1
  235. package/dist/utilities/Annotations.js +31 -7
  236. package/dist/utilities/Annotations.js.map +1 -1
  237. package/dist/utilities/CanvasStack/CanvasStack.d.ts +2 -0
  238. package/dist/utilities/CanvasStack/CanvasStack.d.ts.map +1 -1
  239. package/dist/utilities/CanvasStack/CanvasStack.js +4 -0
  240. package/dist/utilities/CanvasStack/CanvasStack.js.map +1 -1
  241. package/dist/utilities/TokenizedText.d.ts +6 -0
  242. package/dist/utilities/TokenizedText.d.ts.map +1 -1
  243. package/dist/utilities/TokenizedText.js.map +1 -1
  244. package/dist/utilities/zIndex.d.ts +1 -0
  245. package/dist/utilities/zIndex.d.ts.map +1 -1
  246. package/dist/utilities/zIndex.js +1 -0
  247. package/dist/utilities/zIndex.js.map +1 -1
  248. package/package.json +3 -2
  249. package/src/library/components/ActionLogDisplay.tsx +1 -0
  250. package/src/library/components/BottomBarButton.tsx +5 -0
  251. package/src/library/components/ContextGalleryDisplay.tsx +2 -0
  252. package/src/library/components/DemoWrapper.tsx +147 -44
  253. package/src/library/components/FullScreenGalleryDisplay.tsx +3 -0
  254. package/src/library/components/Gallery/BuiltItem.ts +30 -9
  255. package/src/library/components/Gallery/GalleryController.ts +72 -1
  256. package/src/library/components/Gallery/GalleryViewer.tsx +54 -10
  257. package/src/library/components/Gallery/LayoutManager.ts +30 -6
  258. package/src/library/components/Gallery/constants.ts +2 -0
  259. package/src/library/components/Gallery/registry.ts +44 -0
  260. package/src/library/components/GameDesigner.tsx +121 -12
  261. package/src/library/components/InlineGalleryDisplay.tsx +5 -0
  262. package/src/library/components/LiveButton.tsx +8 -5
  263. package/src/library/components/MatchViewer.tsx +14 -3
  264. package/src/library/components/Panel/MultiPanel.tsx +21 -0
  265. package/src/library/components/Panel/PanelContents.tsx +70 -1
  266. package/src/library/components/Panel/PanelTabStack.tsx +1 -0
  267. package/src/library/components/PanelSpark.tsx +9 -4
  268. package/src/library/components/Playground.tsx +48 -21
  269. package/src/library/components/PromptControls.tsx +7 -3
  270. package/src/library/components/SparkLineChart.tsx +23 -27
  271. package/src/library/components/TimeControlBar.tsx +5 -3
  272. package/src/library/components/TokenizedMarkdown.tsx +224 -0
  273. package/src/library/components/TokenizedMessage.tsx +28 -32
  274. package/src/library/components/TopBarPlayers.tsx +12 -9
  275. package/src/library/components/Tutorial/BrowserNarration.ts +233 -0
  276. package/src/library/components/Tutorial/TutorialBox.tsx +506 -0
  277. package/src/library/components/Tutorial/TutorialDevPanel.tsx +297 -0
  278. package/src/library/components/Tutorial/TutorialOverlay.tsx +1301 -0
  279. package/src/library/components/Tutorial/targetRects.ts +273 -0
  280. package/src/library/game/Chit.ts +21 -5
  281. package/src/library/game/ClientTimeState.ts +18 -0
  282. package/src/library/game/Game.ts +7 -0
  283. package/src/library/game/GameTheme.ts +4 -0
  284. package/src/library/game/Match.ts +12 -2
  285. package/src/library/game/Pick.ts +16 -1
  286. package/src/library/game/PlayerPromptStatusChit.ts +5 -1
  287. package/src/library/game/Prompt.ts +20 -0
  288. package/src/library/game/Turn.ts +179 -61
  289. package/src/library/game/TurnState.ts +26 -3
  290. package/src/library/game/ai/AI_GUIDE.md +10 -0
  291. package/src/library/game/ai/AiClientPrompts.ts +60 -11
  292. package/src/library/game/ai/AiPlayerView.ts +2 -0
  293. package/src/library/game/clientTransport/ClientPrompts.ts +31 -1
  294. package/src/library/game/clientTransport/ClientTime.ts +54 -13
  295. package/src/library/game/serialize.test.ts +275 -0
  296. package/src/library/game/tutorial/TUTORIAL_GUIDE.md +411 -0
  297. package/src/library/game/tutorial/TutorialController.test.ts +731 -0
  298. package/src/library/game/tutorial/TutorialController.ts +1286 -0
  299. package/src/library/game/tutorial/TutorialRuntime.ts +311 -0
  300. package/src/library/game/tutorial/TutorialTheme.ts +67 -0
  301. package/src/library/game/tutorial/allowed.ts +145 -0
  302. package/src/library/game/tutorial/checks.ts +186 -0
  303. package/src/library/game/tutorial/createDemoMatch.ts +115 -0
  304. package/src/library/game/tutorial/defineTutorial.ts +414 -0
  305. package/src/library/game/tutorial/runTutorial.ts +331 -0
  306. package/src/library/game/undo.test.ts +282 -0
  307. package/src/library/hooks/usePanelNavigation.tsx +65 -0
  308. package/src/library/hooks/useTimeController.tsx +6 -2
  309. package/src/library/hooks/useTutorial.tsx +76 -0
  310. package/src/library/index.ts +57 -2
  311. package/src/library/rendering/CameraWrapperPerspective.ts +17 -0
  312. package/src/library/rendering/ChitGalleryItemInstance.ts +12 -0
  313. package/src/library/rendering/ChitRenderInstance.ts +34 -0
  314. package/src/library/rendering/RootChitRenderInstance.ts +30 -1
  315. package/src/library/utilities/Annotations.ts +35 -7
  316. package/src/library/utilities/CanvasStack/CanvasStack.ts +6 -1
  317. package/src/library/utilities/TokenizedText.ts +6 -0
  318. package/src/library/utilities/zIndex.ts +1 -0
@@ -0,0 +1,297 @@
1
+ import React, { useEffect, useState } from "react";
2
+ import {
3
+ Box,
4
+ Button,
5
+ Checkbox,
6
+ Chip,
7
+ Divider,
8
+ FormControlLabel,
9
+ List,
10
+ ListItemButton,
11
+ ListItemText,
12
+ Stack,
13
+ Tooltip,
14
+ Typography,
15
+ } from "@mui/material";
16
+ import { useTutorial } from "../../hooks/useTutorial";
17
+ import { useEventChannelState } from "../../hooks/useEventChannelState";
18
+ import { TutorialController, TutorialStatus } from "../../game/tutorial/TutorialController";
19
+ import { EventChannel } from "../../utilities/EventChannel";
20
+
21
+ const mono = { fontFamily: "monospace", fontSize: 11 } as const;
22
+
23
+ function copy(text: string) {
24
+ void navigator.clipboard?.writeText(text).catch(() => {});
25
+ }
26
+
27
+ /**
28
+ * The Playground's tutorial workbench: step list with jump-to, live check result and hint, the RNG
29
+ * and bot-decision logs with step attribution, warnings, a sentence-timing recorder and a few toggles.
30
+ * Mount it next to a `DemoWrapper` that has a tutorial.
31
+ */
32
+ export function TutorialDevPanel({ onRestart }: { onRestart?: (startAt: number) => void }) {
33
+ const tutorial = useTutorial();
34
+ const [controller] = useEventChannelState(tutorial?.controller ?? DUMMY);
35
+ if (!tutorial) {
36
+ return (
37
+ <Box sx={{ p: 2 }}>
38
+ <Typography variant="body2">No tutorial running.</Typography>
39
+ </Box>
40
+ );
41
+ }
42
+ return <Inner controller={controller} onRestart={onRestart} />;
43
+ }
44
+
45
+ const DUMMY = new EventChannel<TutorialController<any, any> | undefined>(undefined);
46
+ const DUMMY_CHECK = new EventChannel<boolean | string | undefined>(undefined);
47
+ const DUMMY_HINT = new EventChannel<string | undefined>(undefined);
48
+
49
+ function Inner({
50
+ controller,
51
+ onRestart,
52
+ }: {
53
+ controller: TutorialController<any, any> | undefined;
54
+ onRestart?: (startAt: number) => void;
55
+ }) {
56
+ const tutorial = useTutorial()!;
57
+ const { runtime, spec } = tutorial;
58
+ const [rngLog] = useEventChannelState(runtime.rngLog);
59
+ const [decisions] = useEventChannelState(runtime.decisionLog);
60
+ const [warnings] = useEventChannelState(runtime.warnings);
61
+ const [activeStep] = useEventChannelState(runtime.activeStep);
62
+ const [dev, setDev] = useEventChannelState(tutorial.dev);
63
+ const [muted, setMuted] = useEventChannelState(tutorial.muted);
64
+ const [index] = useEventChannelState(controller?.index ?? DUMMY_NUM);
65
+ const [status] = useEventChannelState(controller?.status ?? DUMMY_STR);
66
+ const [check] = useEventChannelState(controller?.check ?? DUMMY_CHECK);
67
+ const [hint] = useEventChannelState(controller?.hint ?? DUMMY_HINT);
68
+ const [time] = useEventChannelState(controller?.narrationTime ?? DUMMY_NUM);
69
+ const [sentence] = useEventChannelState(controller?.sentence ?? DUMMY_NUM);
70
+ const [boardClock] = useEventChannelState(controller?.boardClock ?? DUMMY_NUM);
71
+ const [timelineHold] = useEventChannelState(controller?.timelineHold ?? DUMMY_HOLD);
72
+ const [fastTarget] = useEventChannelState(controller?.fastForwardTarget ?? DUMMY_HOLD);
73
+ const [marks, setMarks] = useState<number[]>([]);
74
+ const [recording, setRecording] = useState(false);
75
+
76
+ // Sentence-timing recorder: press space while the narration plays
77
+ useEffect(() => {
78
+ if (!recording) return;
79
+ const onKey = (e: KeyboardEvent) => {
80
+ if (e.code === "Space") {
81
+ e.preventDefault();
82
+ setMarks((m) => [...m, Math.round((controller?.narrationTime.value ?? 0) * 100) / 100]);
83
+ }
84
+ };
85
+ // Capture phase, so the mark claims the space before the tutorial's play/pause shortcut sees it
86
+ window.addEventListener("keydown", onKey, true);
87
+ return () => window.removeEventListener("keydown", onKey, true);
88
+ }, [recording, controller]);
89
+
90
+ const step = controller?.step;
91
+ const rngByStep = (stepId: string) =>
92
+ rngLog
93
+ .filter((e) => e.activeStep === stepId)
94
+ .map((e) => (e.count === 1 ? e.values[0] : e.values))
95
+ .map((v) => (Array.isArray(v) ? `[${v.map((n) => n.toFixed(3)).join(", ")}]` : v.toFixed(3)));
96
+
97
+ return (
98
+ <Stack sx={{ height: "100%", overflow: "hidden", minWidth: 320 }}>
99
+ <Box sx={{ p: 1.5, pb: 1 }}>
100
+ <Typography variant="subtitle2">
101
+ {spec.title} <Chip size="small" label={spec.locale} sx={{ ml: 0.5 }} />
102
+ </Typography>
103
+ <Typography variant="caption" sx={{ opacity: 0.7 }}>
104
+ {controller ? status : "loading"} · active step: {activeStep} · rng left: {runtime.rngRemaining}
105
+ </Typography>
106
+ <Typography variant="caption" component="div" sx={{ opacity: 0.7 }}>
107
+ board clock: {boardClock}
108
+ {timelineHold !== undefined ? ` · held at ${timelineHold}` : " · playing"}
109
+ {fastTarget !== undefined ? ` · fast-forwarding to step ${fastTarget + 1}` : ""}
110
+ </Typography>
111
+ <Stack direction="row" spacing={1} sx={{ mt: 1 }} flexWrap="wrap" useFlexGap>
112
+ <Button size="small" variant="outlined" onClick={() => onRestart?.(0)}>
113
+ Restart
114
+ </Button>
115
+ <Button size="small" variant="outlined" disabled={!step} onClick={() => onRestart?.(index)}>
116
+ Restart at step
117
+ </Button>
118
+ <Button size="small" variant="outlined" disabled={!controller} onClick={() => controller?.next()}>
119
+ Force next
120
+ </Button>
121
+ </Stack>
122
+ <Stack direction="row" flexWrap="wrap" useFlexGap>
123
+ <FormControlLabel
124
+ control={<Checkbox size="small" checked={muted} onChange={(e) => setMuted(e.target.checked)} />}
125
+ label={<Typography variant="caption">Mute (reading clock)</Typography>}
126
+ />
127
+ <FormControlLabel
128
+ control={
129
+ <Checkbox
130
+ size="small"
131
+ checked={dev.showTargetRects}
132
+ onChange={(e) => setDev({ ...dev, showTargetRects: e.target.checked })}
133
+ />
134
+ }
135
+ label={<Typography variant="caption">Show target rects</Typography>}
136
+ />
137
+ </Stack>
138
+ </Box>
139
+ <Divider />
140
+
141
+ <Box sx={{ flex: 1, overflowY: "auto" }}>
142
+ <Typography variant="overline" sx={{ px: 1.5, opacity: 0.7 }}>
143
+ Steps
144
+ </Typography>
145
+ <List dense disablePadding>
146
+ {spec.steps.map((s, i) => {
147
+ const values = rngByStep(s.id);
148
+ return (
149
+ <ListItemButton
150
+ key={s.id}
151
+ selected={i === index}
152
+ onClick={(e) => {
153
+ // Straight to the step, the game as it was there (played ahead headlessly when needed);
154
+ // Shift-click plays through to it on screen; Alt-click jumps and leaves the game as is
155
+ if (!controller) return;
156
+ if (e.altKey) controller.jumpTo(i);
157
+ else if (e.shiftKey && i > index) controller.fastForwardTo(i);
158
+ else controller.skipTo(i);
159
+ }}
160
+ title="Click: go to this step · Shift-click: play through to it on screen · Alt-click: jump, leaving the game as it is"
161
+ sx={{ py: 0.25 }}
162
+ >
163
+ <ListItemText
164
+ primary={
165
+ <Stack direction="row" spacing={0.5} alignItems="center">
166
+ <Typography variant="body2" sx={{ flex: 1 }}>
167
+ {i + 1}. {s.id}
168
+ </Typography>
169
+ {s.waitFor && <Chip size="small" label="do it" variant="outlined" />}
170
+ {s.waitFor && !s.allow && <Chip size="small" color="error" label="no allow" variant="outlined" />}
171
+ {s.rng && <Chip size="small" label={`rng ${s.rng.length}`} variant="outlined" />}
172
+ {s.ai && <Chip size="small" label="ai" variant="outlined" />}
173
+ {values.length > 0 && (
174
+ <Tooltip title={`Copy rng: [${values.join(", ")}]`}>
175
+ <Button
176
+ size="small"
177
+ sx={{ minWidth: 0, px: 0.5, ...mono }}
178
+ onClick={(e) => {
179
+ e.stopPropagation();
180
+ copy(`rng: [${values.join(", ")}],`);
181
+ }}
182
+ >
183
+ copy rng
184
+ </Button>
185
+ </Tooltip>
186
+ )}
187
+ </Stack>
188
+ }
189
+ secondary={
190
+ i === index ? (
191
+ <Typography variant="caption" component="div">
192
+ check: {check === undefined ? "—" : String(check)}
193
+ {hint ? ` · hint: ${hint}` : ""}
194
+ </Typography>
195
+ ) : undefined
196
+ }
197
+ />
198
+ </ListItemButton>
199
+ );
200
+ })}
201
+ </List>
202
+
203
+ <Divider sx={{ my: 1 }} />
204
+ <Box sx={{ px: 1.5 }}>
205
+ <Typography variant="overline" sx={{ opacity: 0.7 }}>
206
+ Narration
207
+ </Typography>
208
+ <Typography variant="caption" component="div">
209
+ t = {time.toFixed(2)}s · sentence {sentence}
210
+ </Typography>
211
+ <Stack direction="row" spacing={1} alignItems="center" sx={{ mt: 0.5 }}>
212
+ <Button
213
+ size="small"
214
+ variant={recording ? "contained" : "outlined"}
215
+ onClick={() => {
216
+ if (!recording) setMarks([]);
217
+ setRecording(!recording);
218
+ }}
219
+ >
220
+ {recording ? "Stop (space = mark)" : "Record sentence times"}
221
+ </Button>
222
+ {marks.length > 0 && (
223
+ <Button size="small" onClick={() => copy(`sentenceTimes: [${marks.join(", ")}],`)}>
224
+ copy {marks.length}
225
+ </Button>
226
+ )}
227
+ </Stack>
228
+ {marks.length > 0 && (
229
+ <Typography component="div" sx={{ ...mono, mt: 0.5 }}>
230
+ sentenceTimes: [{marks.join(", ")}]
231
+ </Typography>
232
+ )}
233
+ </Box>
234
+
235
+ <Divider sx={{ my: 1 }} />
236
+ <Box sx={{ px: 1.5 }}>
237
+ <Typography variant="overline" sx={{ opacity: 0.7 }}>
238
+ RNG log
239
+ </Typography>
240
+ {rngLog.length === 0 && (
241
+ <Typography variant="caption" component="div">
242
+ no draws yet
243
+ </Typography>
244
+ )}
245
+ {rngLog.map((e) => (
246
+ <Typography
247
+ key={e.index}
248
+ component="div"
249
+ sx={{ ...mono, color: e.mismatch ? "error.main" : e.source === "random" ? "warning.main" : undefined }}
250
+ >
251
+ #{e.index} {e.count === 1 ? e.values[0]?.toFixed(3) : `[${e.values.map((v) => v.toFixed(3)).join(", ")}]`}{" "}
252
+ · {e.source === "script" ? `from ${e.declaredBy}` : "random"} · during {e.activeStep}
253
+ </Typography>
254
+ ))}
255
+ </Box>
256
+
257
+ <Divider sx={{ my: 1 }} />
258
+ <Box sx={{ px: 1.5 }}>
259
+ <Typography variant="overline" sx={{ opacity: 0.7 }}>
260
+ Bot decisions
261
+ </Typography>
262
+ {decisions.length === 0 && (
263
+ <Typography variant="caption" component="div">
264
+ none yet
265
+ </Typography>
266
+ )}
267
+ {decisions.map((d, i) => (
268
+ <Typography key={i} component="div" sx={{ ...mono, color: d.mismatch ? "error.main" : undefined }}>
269
+ {d.playerId} · {d.activeStep} · {d.chosen}
270
+ {d.forced ? ` · forced: ${d.forced} (${d.declaredBy})` : ""}
271
+ </Typography>
272
+ ))}
273
+ </Box>
274
+
275
+ {warnings.length > 0 && (
276
+ <>
277
+ <Divider sx={{ my: 1 }} />
278
+ <Box sx={{ px: 1.5, pb: 2 }}>
279
+ <Typography variant="overline" color="error">
280
+ Warnings
281
+ </Typography>
282
+ {warnings.map((w, i) => (
283
+ <Typography key={i} component="div" sx={{ ...mono, color: "error.main" }}>
284
+ {w}
285
+ </Typography>
286
+ ))}
287
+ </Box>
288
+ </>
289
+ )}
290
+ </Box>
291
+ </Stack>
292
+ );
293
+ }
294
+
295
+ const DUMMY_NUM = new EventChannel<number>(-1);
296
+ const DUMMY_HOLD = new EventChannel<number | undefined>(undefined);
297
+ const DUMMY_STR = new EventChannel<TutorialStatus>("idle");