@pretty-chitty/core 1.2.18 → 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 (378) 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/ClientTrustMatchViewer.d.ts +14 -1
  10. package/dist/components/ClientTrustMatchViewer.d.ts.map +1 -1
  11. package/dist/components/ClientTrustMatchViewer.js +25 -2
  12. package/dist/components/ClientTrustMatchViewer.js.map +1 -1
  13. package/dist/components/ContextGalleryDisplay.d.ts.map +1 -1
  14. package/dist/components/ContextGalleryDisplay.js +1 -1
  15. package/dist/components/ContextGalleryDisplay.js.map +1 -1
  16. package/dist/components/DemoWrapper.d.ts +30 -2
  17. package/dist/components/DemoWrapper.d.ts.map +1 -1
  18. package/dist/components/DemoWrapper.js +79 -43
  19. package/dist/components/DemoWrapper.js.map +1 -1
  20. package/dist/components/FullScreenGalleryDisplay.d.ts.map +1 -1
  21. package/dist/components/FullScreenGalleryDisplay.js +2 -2
  22. package/dist/components/FullScreenGalleryDisplay.js.map +1 -1
  23. package/dist/components/Gallery/BuiltItem.d.ts +6 -2
  24. package/dist/components/Gallery/BuiltItem.d.ts.map +1 -1
  25. package/dist/components/Gallery/BuiltItem.js +31 -9
  26. package/dist/components/Gallery/BuiltItem.js.map +1 -1
  27. package/dist/components/Gallery/GalleryController.d.ts +18 -0
  28. package/dist/components/Gallery/GalleryController.d.ts.map +1 -1
  29. package/dist/components/Gallery/GalleryController.js +70 -1
  30. package/dist/components/Gallery/GalleryController.js.map +1 -1
  31. package/dist/components/Gallery/GalleryViewer.d.ts +6 -1
  32. package/dist/components/Gallery/GalleryViewer.d.ts.map +1 -1
  33. package/dist/components/Gallery/GalleryViewer.js +48 -10
  34. package/dist/components/Gallery/GalleryViewer.js.map +1 -1
  35. package/dist/components/Gallery/LayoutManager.d.ts +6 -0
  36. package/dist/components/Gallery/LayoutManager.d.ts.map +1 -1
  37. package/dist/components/Gallery/LayoutManager.js +23 -3
  38. package/dist/components/Gallery/LayoutManager.js.map +1 -1
  39. package/dist/components/Gallery/constants.d.ts +2 -0
  40. package/dist/components/Gallery/constants.d.ts.map +1 -1
  41. package/dist/components/Gallery/constants.js +2 -0
  42. package/dist/components/Gallery/constants.js.map +1 -1
  43. package/dist/components/Gallery/registry.d.ts +34 -0
  44. package/dist/components/Gallery/registry.d.ts.map +1 -0
  45. package/dist/components/Gallery/registry.js +17 -0
  46. package/dist/components/Gallery/registry.js.map +1 -0
  47. package/dist/components/GameDesigner.d.ts.map +1 -1
  48. package/dist/components/GameDesigner.js +42 -10
  49. package/dist/components/GameDesigner.js.map +1 -1
  50. package/dist/components/InlineGalleryDisplay.d.ts.map +1 -1
  51. package/dist/components/InlineGalleryDisplay.js +2 -2
  52. package/dist/components/InlineGalleryDisplay.js.map +1 -1
  53. package/dist/components/LiveButton.d.ts.map +1 -1
  54. package/dist/components/LiveButton.js +5 -2
  55. package/dist/components/LiveButton.js.map +1 -1
  56. package/dist/components/MatchViewer.d.ts +6 -1
  57. package/dist/components/MatchViewer.d.ts.map +1 -1
  58. package/dist/components/MatchViewer.js +9 -3
  59. package/dist/components/MatchViewer.js.map +1 -1
  60. package/dist/components/Panel/MultiPanel.d.ts.map +1 -1
  61. package/dist/components/Panel/MultiPanel.js +18 -0
  62. package/dist/components/Panel/MultiPanel.js.map +1 -1
  63. package/dist/components/Panel/PanelContents.d.ts.map +1 -1
  64. package/dist/components/Panel/PanelContents.js +92 -23
  65. package/dist/components/Panel/PanelContents.js.map +1 -1
  66. package/dist/components/Panel/PanelTabStack.d.ts.map +1 -1
  67. package/dist/components/Panel/PanelTabStack.js +1 -1
  68. package/dist/components/Panel/PanelTabStack.js.map +1 -1
  69. package/dist/components/PanelSpark.d.ts.map +1 -1
  70. package/dist/components/PanelSpark.js +3 -2
  71. package/dist/components/PanelSpark.js.map +1 -1
  72. package/dist/components/Playground.d.ts.map +1 -1
  73. package/dist/components/Playground.js +46 -14
  74. package/dist/components/Playground.js.map +1 -1
  75. package/dist/components/PromptControls.d.ts.map +1 -1
  76. package/dist/components/PromptControls.js +4 -2
  77. package/dist/components/PromptControls.js.map +1 -1
  78. package/dist/components/SparkLineChart.d.ts.map +1 -1
  79. package/dist/components/SparkLineChart.js +22 -26
  80. package/dist/components/SparkLineChart.js.map +1 -1
  81. package/dist/components/TimeControlBar.d.ts.map +1 -1
  82. package/dist/components/TimeControlBar.js +5 -3
  83. package/dist/components/TimeControlBar.js.map +1 -1
  84. package/dist/components/TokenizedMarkdown.d.ts +23 -0
  85. package/dist/components/TokenizedMarkdown.d.ts.map +1 -0
  86. package/dist/components/TokenizedMarkdown.js +144 -0
  87. package/dist/components/TokenizedMarkdown.js.map +1 -0
  88. package/dist/components/TokenizedMessage.d.ts +8 -6
  89. package/dist/components/TokenizedMessage.d.ts.map +1 -1
  90. package/dist/components/TokenizedMessage.js +21 -54
  91. package/dist/components/TokenizedMessage.js.map +1 -1
  92. package/dist/components/TopBarPlayers.d.ts.map +1 -1
  93. package/dist/components/TopBarPlayers.js +2 -2
  94. package/dist/components/TopBarPlayers.js.map +1 -1
  95. package/dist/components/Tutorial/BrowserNarration.d.ts +55 -0
  96. package/dist/components/Tutorial/BrowserNarration.d.ts.map +1 -0
  97. package/dist/components/Tutorial/BrowserNarration.js +240 -0
  98. package/dist/components/Tutorial/BrowserNarration.js.map +1 -0
  99. package/dist/components/Tutorial/TutorialBox.d.ts +26 -0
  100. package/dist/components/Tutorial/TutorialBox.d.ts.map +1 -0
  101. package/dist/components/Tutorial/TutorialBox.js +239 -0
  102. package/dist/components/Tutorial/TutorialBox.js.map +1 -0
  103. package/dist/components/Tutorial/TutorialDevPanel.d.ts +9 -0
  104. package/dist/components/Tutorial/TutorialDevPanel.d.ts.map +1 -0
  105. package/dist/components/Tutorial/TutorialDevPanel.js +92 -0
  106. package/dist/components/Tutorial/TutorialDevPanel.js.map +1 -0
  107. package/dist/components/Tutorial/TutorialOverlay.d.ts +7 -0
  108. package/dist/components/Tutorial/TutorialOverlay.d.ts.map +1 -0
  109. package/dist/components/Tutorial/TutorialOverlay.js +1132 -0
  110. package/dist/components/Tutorial/TutorialOverlay.js.map +1 -0
  111. package/dist/components/Tutorial/targetRects.d.ts +67 -0
  112. package/dist/components/Tutorial/targetRects.d.ts.map +1 -0
  113. package/dist/components/Tutorial/targetRects.js +241 -0
  114. package/dist/components/Tutorial/targetRects.js.map +1 -0
  115. package/dist/game/Chit.d.ts +7 -0
  116. package/dist/game/Chit.d.ts.map +1 -1
  117. package/dist/game/Chit.js +22 -7
  118. package/dist/game/Chit.js.map +1 -1
  119. package/dist/game/ClientTimeState.d.ts +14 -0
  120. package/dist/game/ClientTimeState.d.ts.map +1 -1
  121. package/dist/game/ClientTimeState.js +17 -0
  122. package/dist/game/ClientTimeState.js.map +1 -1
  123. package/dist/game/ConnectionTransport.d.ts +3 -0
  124. package/dist/game/ConnectionTransport.d.ts.map +1 -1
  125. package/dist/game/ConnectionTransport.js +13 -4
  126. package/dist/game/ConnectionTransport.js.map +1 -1
  127. package/dist/game/Game.d.ts +14 -1
  128. package/dist/game/Game.d.ts.map +1 -1
  129. package/dist/game/GameTheme.d.ts +3 -0
  130. package/dist/game/GameTheme.d.ts.map +1 -1
  131. package/dist/game/GameTheme.js +2 -0
  132. package/dist/game/GameTheme.js.map +1 -1
  133. package/dist/game/Match.d.ts +74 -2
  134. package/dist/game/Match.d.ts.map +1 -1
  135. package/dist/game/Match.js +155 -4
  136. package/dist/game/Match.js.map +1 -1
  137. package/dist/game/MatchStorage.d.ts +8 -1
  138. package/dist/game/MatchStorage.d.ts.map +1 -1
  139. package/dist/game/MatchStorage.js +11 -3
  140. package/dist/game/MatchStorage.js.map +1 -1
  141. package/dist/game/Pick.d.ts +16 -0
  142. package/dist/game/Pick.d.ts.map +1 -1
  143. package/dist/game/Pick.js +32 -1
  144. package/dist/game/Pick.js.map +1 -1
  145. package/dist/game/PlayerChit.d.ts +3 -0
  146. package/dist/game/PlayerChit.d.ts.map +1 -1
  147. package/dist/game/PlayerChit.js +3 -0
  148. package/dist/game/PlayerChit.js.map +1 -1
  149. package/dist/game/PlayerInfo.d.ts +8 -0
  150. package/dist/game/PlayerInfo.d.ts.map +1 -1
  151. package/dist/game/PlayerInfo.js +6 -3
  152. package/dist/game/PlayerInfo.js.map +1 -1
  153. package/dist/game/PlayerPromptStatusChit.d.ts +8 -0
  154. package/dist/game/PlayerPromptStatusChit.d.ts.map +1 -1
  155. package/dist/game/PlayerPromptStatusChit.js +8 -2
  156. package/dist/game/PlayerPromptStatusChit.js.map +1 -1
  157. package/dist/game/Prompt.d.ts +15 -0
  158. package/dist/game/Prompt.d.ts.map +1 -1
  159. package/dist/game/Prompt.js +16 -0
  160. package/dist/game/Prompt.js.map +1 -1
  161. package/dist/game/Turn.d.ts +20 -4
  162. package/dist/game/Turn.d.ts.map +1 -1
  163. package/dist/game/Turn.js +191 -67
  164. package/dist/game/Turn.js.map +1 -1
  165. package/dist/game/TurnState.d.ts +20 -1
  166. package/dist/game/TurnState.d.ts.map +1 -1
  167. package/dist/game/TurnState.js +22 -3
  168. package/dist/game/TurnState.js.map +1 -1
  169. package/dist/game/ai/AiClientPrompts.d.ts +177 -0
  170. package/dist/game/ai/AiClientPrompts.d.ts.map +1 -0
  171. package/dist/game/ai/AiClientPrompts.js +561 -0
  172. package/dist/game/ai/AiClientPrompts.js.map +1 -0
  173. package/dist/game/ai/AiLiveView.d.ts +2 -0
  174. package/dist/game/ai/AiLiveView.d.ts.map +1 -0
  175. package/dist/game/ai/AiLiveView.js +48 -0
  176. package/dist/game/ai/AiLiveView.js.map +1 -0
  177. package/dist/game/ai/AiPlayerView.d.ts +2 -0
  178. package/dist/game/ai/AiPlayerView.d.ts.map +1 -0
  179. package/dist/game/ai/AiPlayerView.js +91 -0
  180. package/dist/game/ai/AiPlayerView.js.map +1 -0
  181. package/dist/game/ai/connectAiPlayer.d.ts +43 -0
  182. package/dist/game/ai/connectAiPlayer.d.ts.map +1 -0
  183. package/dist/game/ai/connectAiPlayer.js +58 -0
  184. package/dist/game/ai/connectAiPlayer.js.map +1 -0
  185. package/dist/game/ai/defineAi.d.ts +119 -0
  186. package/dist/game/ai/defineAi.d.ts.map +1 -0
  187. package/dist/game/ai/defineAi.js +122 -0
  188. package/dist/game/ai/defineAi.js.map +1 -0
  189. package/dist/game/ai/simulateMatches.d.ts +62 -0
  190. package/dist/game/ai/simulateMatches.d.ts.map +1 -0
  191. package/dist/game/ai/simulateMatches.js +108 -0
  192. package/dist/game/ai/simulateMatches.js.map +1 -0
  193. package/dist/game/badAiTransport/BadAIClientPrompts.d.ts +3 -0
  194. package/dist/game/badAiTransport/BadAIClientPrompts.d.ts.map +1 -1
  195. package/dist/game/badAiTransport/BadAIClientPrompts.js +3 -0
  196. package/dist/game/badAiTransport/BadAIClientPrompts.js.map +1 -1
  197. package/dist/game/clientTransport/ClientPrompts.d.ts +20 -1
  198. package/dist/game/clientTransport/ClientPrompts.d.ts.map +1 -1
  199. package/dist/game/clientTransport/ClientPrompts.js +30 -1
  200. package/dist/game/clientTransport/ClientPrompts.js.map +1 -1
  201. package/dist/game/clientTransport/ClientTime.d.ts +13 -0
  202. package/dist/game/clientTransport/ClientTime.d.ts.map +1 -1
  203. package/dist/game/clientTransport/ClientTime.js +51 -11
  204. package/dist/game/clientTransport/ClientTime.js.map +1 -1
  205. package/dist/game/tutorial/TutorialController.d.ts +300 -0
  206. package/dist/game/tutorial/TutorialController.d.ts.map +1 -0
  207. package/dist/game/tutorial/TutorialController.js +1182 -0
  208. package/dist/game/tutorial/TutorialController.js.map +1 -0
  209. package/dist/game/tutorial/TutorialRuntime.d.ts +89 -0
  210. package/dist/game/tutorial/TutorialRuntime.d.ts.map +1 -0
  211. package/dist/game/tutorial/TutorialRuntime.js +261 -0
  212. package/dist/game/tutorial/TutorialRuntime.js.map +1 -0
  213. package/dist/game/tutorial/TutorialTheme.d.ts +28 -0
  214. package/dist/game/tutorial/TutorialTheme.d.ts.map +1 -0
  215. package/dist/game/tutorial/TutorialTheme.js +39 -0
  216. package/dist/game/tutorial/TutorialTheme.js.map +1 -0
  217. package/dist/game/tutorial/allowed.d.ts +2 -0
  218. package/dist/game/tutorial/allowed.d.ts.map +1 -0
  219. package/dist/game/tutorial/allowed.js +119 -0
  220. package/dist/game/tutorial/allowed.js.map +1 -0
  221. package/dist/game/tutorial/checks.d.ts +58 -0
  222. package/dist/game/tutorial/checks.d.ts.map +1 -0
  223. package/dist/game/tutorial/checks.js +144 -0
  224. package/dist/game/tutorial/checks.js.map +1 -0
  225. package/dist/game/tutorial/createDemoMatch.d.ts +47 -0
  226. package/dist/game/tutorial/createDemoMatch.d.ts.map +1 -0
  227. package/dist/game/tutorial/createDemoMatch.js +67 -0
  228. package/dist/game/tutorial/createDemoMatch.js.map +1 -0
  229. package/dist/game/tutorial/defineTutorial.d.ts +353 -0
  230. package/dist/game/tutorial/defineTutorial.d.ts.map +1 -0
  231. package/dist/game/tutorial/defineTutorial.js +86 -0
  232. package/dist/game/tutorial/defineTutorial.js.map +1 -0
  233. package/dist/game/tutorial/runTutorial.d.ts +63 -0
  234. package/dist/game/tutorial/runTutorial.d.ts.map +1 -0
  235. package/dist/game/tutorial/runTutorial.js +273 -0
  236. package/dist/game/tutorial/runTutorial.js.map +1 -0
  237. package/dist/hooks/usePanelNavigation.d.ts +28 -0
  238. package/dist/hooks/usePanelNavigation.d.ts.map +1 -0
  239. package/dist/hooks/usePanelNavigation.js +36 -0
  240. package/dist/hooks/usePanelNavigation.js.map +1 -0
  241. package/dist/hooks/useTimeController.d.ts +2 -1
  242. package/dist/hooks/useTimeController.d.ts.map +1 -1
  243. package/dist/hooks/useTimeController.js +6 -2
  244. package/dist/hooks/useTimeController.js.map +1 -1
  245. package/dist/hooks/useTokenMap.d.ts +2 -4
  246. package/dist/hooks/useTokenMap.d.ts.map +1 -1
  247. package/dist/hooks/useTokenMap.js +2 -5
  248. package/dist/hooks/useTokenMap.js.map +1 -1
  249. package/dist/hooks/useTutorial.d.ts +48 -0
  250. package/dist/hooks/useTutorial.d.ts.map +1 -0
  251. package/dist/hooks/useTutorial.js +16 -0
  252. package/dist/hooks/useTutorial.js.map +1 -0
  253. package/dist/index.d.ts +57 -1
  254. package/dist/index.d.ts.map +1 -1
  255. package/dist/index.html +12 -0
  256. package/dist/index.js +27 -3
  257. package/dist/index.js.map +1 -1
  258. package/dist/main.0792d734cde2c688d5f7.hot-update.js +16991 -0
  259. package/dist/main.0792d734cde2c688d5f7.hot-update.js.map +1 -0
  260. package/dist/main.0792d734cde2c688d5f7.hot-update.json +1 -0
  261. package/dist/pretty-chitty.js +204513 -0
  262. package/dist/pretty-chitty.js.map +1 -0
  263. package/dist/rendering/CameraWrapperPerspective.d.ts +5 -0
  264. package/dist/rendering/CameraWrapperPerspective.d.ts.map +1 -1
  265. package/dist/rendering/CameraWrapperPerspective.js +16 -0
  266. package/dist/rendering/CameraWrapperPerspective.js.map +1 -1
  267. package/dist/rendering/ChitGalleryItemInstance.d.ts +1 -0
  268. package/dist/rendering/ChitGalleryItemInstance.d.ts.map +1 -1
  269. package/dist/rendering/ChitGalleryItemInstance.js +12 -0
  270. package/dist/rendering/ChitGalleryItemInstance.js.map +1 -1
  271. package/dist/rendering/ChitRenderInstance.d.ts +9 -1
  272. package/dist/rendering/ChitRenderInstance.d.ts.map +1 -1
  273. package/dist/rendering/ChitRenderInstance.js +28 -0
  274. package/dist/rendering/ChitRenderInstance.js.map +1 -1
  275. package/dist/rendering/RootChitRenderInstance.d.ts +2 -0
  276. package/dist/rendering/RootChitRenderInstance.d.ts.map +1 -1
  277. package/dist/rendering/RootChitRenderInstance.js +29 -0
  278. package/dist/rendering/RootChitRenderInstance.js.map +1 -1
  279. package/dist/utilities/Annotations.d.ts +15 -0
  280. package/dist/utilities/Annotations.d.ts.map +1 -1
  281. package/dist/utilities/Annotations.js +31 -7
  282. package/dist/utilities/Annotations.js.map +1 -1
  283. package/dist/utilities/CanvasStack/CanvasStack.d.ts +13 -0
  284. package/dist/utilities/CanvasStack/CanvasStack.d.ts.map +1 -1
  285. package/dist/utilities/CanvasStack/CanvasStack.js +66 -15
  286. package/dist/utilities/CanvasStack/CanvasStack.js.map +1 -1
  287. package/dist/utilities/TokenizedText.d.ts +55 -0
  288. package/dist/utilities/TokenizedText.d.ts.map +1 -0
  289. package/dist/utilities/TokenizedText.js +47 -0
  290. package/dist/utilities/TokenizedText.js.map +1 -0
  291. package/dist/utilities/zIndex.d.ts +1 -0
  292. package/dist/utilities/zIndex.d.ts.map +1 -1
  293. package/dist/utilities/zIndex.js +1 -0
  294. package/dist/utilities/zIndex.js.map +1 -1
  295. package/package.json +3 -2
  296. package/src/library/components/ActionLogDisplay.tsx +1 -0
  297. package/src/library/components/BottomBarButton.tsx +5 -0
  298. package/src/library/components/ClientTrustMatchViewer.tsx +32 -2
  299. package/src/library/components/ContextGalleryDisplay.tsx +2 -0
  300. package/src/library/components/DemoWrapper.tsx +147 -52
  301. package/src/library/components/FullScreenGalleryDisplay.tsx +3 -0
  302. package/src/library/components/Gallery/BuiltItem.ts +34 -9
  303. package/src/library/components/Gallery/GalleryController.ts +75 -2
  304. package/src/library/components/Gallery/GalleryViewer.tsx +54 -10
  305. package/src/library/components/Gallery/LayoutManager.ts +30 -6
  306. package/src/library/components/Gallery/constants.ts +2 -0
  307. package/src/library/components/Gallery/registry.ts +44 -0
  308. package/src/library/components/GameDesigner.tsx +121 -12
  309. package/src/library/components/InlineGalleryDisplay.tsx +5 -0
  310. package/src/library/components/LiveButton.tsx +8 -5
  311. package/src/library/components/MatchViewer.tsx +14 -3
  312. package/src/library/components/Panel/MultiPanel.tsx +21 -0
  313. package/src/library/components/Panel/PanelContents.tsx +70 -1
  314. package/src/library/components/Panel/PanelTabStack.tsx +1 -0
  315. package/src/library/components/PanelSpark.tsx +9 -4
  316. package/src/library/components/Playground.tsx +125 -33
  317. package/src/library/components/PromptControls.tsx +7 -3
  318. package/src/library/components/SparkLineChart.tsx +23 -27
  319. package/src/library/components/TimeControlBar.tsx +5 -3
  320. package/src/library/components/TokenizedMarkdown.tsx +224 -0
  321. package/src/library/components/TokenizedMessage.tsx +30 -95
  322. package/src/library/components/TopBarPlayers.tsx +18 -10
  323. package/src/library/components/Tutorial/BrowserNarration.ts +233 -0
  324. package/src/library/components/Tutorial/TutorialBox.tsx +506 -0
  325. package/src/library/components/Tutorial/TutorialDevPanel.tsx +297 -0
  326. package/src/library/components/Tutorial/TutorialOverlay.tsx +1301 -0
  327. package/src/library/components/Tutorial/targetRects.ts +273 -0
  328. package/src/library/game/Chit.ts +23 -7
  329. package/src/library/game/ClientTimeState.ts +18 -0
  330. package/src/library/game/ConnectionTransport.ts +12 -3
  331. package/src/library/game/Game.ts +16 -1
  332. package/src/library/game/GameTheme.ts +4 -0
  333. package/src/library/game/Match.ts +174 -5
  334. package/src/library/game/MatchStorage.ts +14 -4
  335. package/src/library/game/Pick.ts +36 -1
  336. package/src/library/game/PlayerChit.ts +4 -1
  337. package/src/library/game/PlayerInfo.ts +13 -3
  338. package/src/library/game/PlayerPromptStatusChit.ts +8 -2
  339. package/src/library/game/Prompt.ts +20 -0
  340. package/src/library/game/Turn.ts +198 -68
  341. package/src/library/game/TurnState.ts +34 -3
  342. package/src/library/game/ai/AI_GUIDE.md +444 -0
  343. package/src/library/game/ai/AiClientPrompts.ts +730 -0
  344. package/src/library/game/ai/AiLiveView.ts +63 -0
  345. package/src/library/game/ai/AiPlayerView.ts +114 -0
  346. package/src/library/game/ai/ai.test.ts +475 -0
  347. package/src/library/game/ai/connectAiPlayer.ts +88 -0
  348. package/src/library/game/ai/defineAi.ts +230 -0
  349. package/src/library/game/ai/simulateMatches.ts +172 -0
  350. package/src/library/game/badAiTransport/BadAIClientPrompts.ts +3 -0
  351. package/src/library/game/clientTransport/ClientPrompts.ts +31 -1
  352. package/src/library/game/clientTransport/ClientTime.ts +54 -13
  353. package/src/library/game/serialize.test.ts +275 -0
  354. package/src/library/game/tutorial/TUTORIAL_GUIDE.md +411 -0
  355. package/src/library/game/tutorial/TutorialController.test.ts +731 -0
  356. package/src/library/game/tutorial/TutorialController.ts +1286 -0
  357. package/src/library/game/tutorial/TutorialRuntime.ts +311 -0
  358. package/src/library/game/tutorial/TutorialTheme.ts +67 -0
  359. package/src/library/game/tutorial/allowed.ts +145 -0
  360. package/src/library/game/tutorial/checks.ts +186 -0
  361. package/src/library/game/tutorial/createDemoMatch.ts +115 -0
  362. package/src/library/game/tutorial/defineTutorial.ts +414 -0
  363. package/src/library/game/tutorial/runTutorial.ts +331 -0
  364. package/src/library/game/undo.test.ts +282 -0
  365. package/src/library/hooks/usePanelNavigation.tsx +65 -0
  366. package/src/library/hooks/useTimeController.tsx +6 -2
  367. package/src/library/hooks/useTokenMap.ts +2 -6
  368. package/src/library/hooks/useTutorial.tsx +76 -0
  369. package/src/library/index.ts +91 -4
  370. package/src/library/rendering/CameraWrapperPerspective.ts +17 -0
  371. package/src/library/rendering/ChitGalleryItemInstance.ts +12 -0
  372. package/src/library/rendering/ChitRenderInstance.ts +34 -0
  373. package/src/library/rendering/RootChitRenderInstance.ts +30 -1
  374. package/src/library/utilities/Annotations.ts +35 -7
  375. package/src/library/utilities/CanvasStack/CanvasStack.ts +74 -29
  376. package/src/library/utilities/TokenizedText.test.ts +32 -0
  377. package/src/library/utilities/TokenizedText.ts +103 -0
  378. package/src/library/utilities/zIndex.ts +1 -0
@@ -0,0 +1,91 @@
1
+ import { Chit } from "../Chit";
2
+ import { ConnectionObject } from "../ConnectionObject";
3
+ import { hashString } from "./defineAi";
4
+ /**
5
+ * A headless stand-in for ClientTime, registered as "ClientTime" on an AI player's connection.
6
+ *
7
+ * It rebuilds the chit tree from exactly what the server sends this seat (`serializeDelta`, which
8
+ * applies `Chit.fixVisibility`), so the AI can only see what a human in that seat could see.
9
+ * There is no animation or timeline scrubbing: it jumps straight to the requested clock.
10
+ *
11
+ * @internal
12
+ */
13
+ export class AiPlayerView extends ConnectionObject {
14
+ constructor(connection, game) {
15
+ super();
16
+ this.game = game;
17
+ this.serverTime = undefined;
18
+ this.chitLookup = {};
19
+ this.lastSerializedState = {};
20
+ this.states = {};
21
+ this.queue = Promise.resolve();
22
+ this.maxClock = { clock: 0, pass: -1 };
23
+ this.root = undefined;
24
+ /** Hash of the visible board at the last sync; equal hashes mean an identical view */
25
+ this.signature = "";
26
+ this.findChit = (id) => this.chitLookup[id];
27
+ this.serverTime = connection.get("ServerTime");
28
+ }
29
+ // Called by ServerTime
30
+ async newMaxClock(clock) {
31
+ this.maxClock = clock;
32
+ }
33
+ // Called by ServerTime; replays are irrelevant to a bot
34
+ async setStartTime() { }
35
+ /** Brings the view up to `clock` (or the latest clock this seat may see). Calls are serialized. */
36
+ sync(clock) {
37
+ const run = this.queue.then(() => this.load(clock ?? this.maxClock.clock));
38
+ this.queue = run.catch(() => undefined);
39
+ return run;
40
+ }
41
+ async load(clock) {
42
+ const response = await this.serverTime.serializeDelta(Math.max(1, clock));
43
+ if (!response) {
44
+ return;
45
+ }
46
+ Object.assign(this.states, response.newStates);
47
+ const serialized = {};
48
+ Object.entries(response.chits).forEach(([id, stateId]) => {
49
+ serialized[id] = this.states[stateId];
50
+ });
51
+ this.signature = hashString(Object.keys(response.chits)
52
+ .sort()
53
+ .map((id) => `${id}=${response.chits[id]}`)
54
+ .join(","));
55
+ // Same steps as ClientTime.processNewTargetClock: create first (chits reference each other),
56
+ // detach chits that no longer exist, then deserialize what changed.
57
+ Object.entries(serialized).forEach(([id, value]) => {
58
+ if (!this.chitLookup[id]) {
59
+ const chit = Chit.deflate(value, this.game);
60
+ if (chit) {
61
+ this.chitLookup[id] = chit;
62
+ }
63
+ }
64
+ });
65
+ Object.values(this.chitLookup).forEach((chit) => {
66
+ if (chit.id && !serialized[chit.id] && this.lastSerializedState[chit.id] !== undefined) {
67
+ // Back into its bag if it came from one; otherwise gone, as a visible fallback would keep it drawn
68
+ chit.forgetFallbackUnlessHidden();
69
+ if (chit.parentFallback) {
70
+ chit.beginDeserializing();
71
+ chit.setParent(chit.parentFallback, chit.parentOutlet ?? "graveyard");
72
+ chit.doneDeserializing();
73
+ }
74
+ else {
75
+ chit.removeFromParent();
76
+ }
77
+ delete this.lastSerializedState[chit.id];
78
+ }
79
+ });
80
+ const changed = Object.entries(serialized).filter(([id, value]) => this.chitLookup[id] && this.lastSerializedState[id] !== value);
81
+ const strictFind = (id) => this.chitLookup[id];
82
+ changed.forEach(([id]) => this.chitLookup[id].beginDeserializing());
83
+ changed.forEach(([id, value]) => {
84
+ this.chitLookup[id].deserialize(value, strictFind);
85
+ this.lastSerializedState[id] = value;
86
+ });
87
+ changed.forEach(([id]) => this.chitLookup[id].doneDeserializing());
88
+ this.root = this.chitLookup["root"];
89
+ }
90
+ }
91
+ //# sourceMappingURL=AiPlayerView.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"AiPlayerView.js","sourceRoot":"","sources":["../../../src/library/game/ai/AiPlayerView.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,43 @@
1
+ import type { Match } from "../Match";
2
+ import { PlayerChit } from "../PlayerChit";
3
+ import { RootChit } from "../RootChit";
4
+ import { ClientStatus } from "../clientTransport/ClientStatus";
5
+ import { AiClientPrompts, AiPlayerOptions } from "./AiClientPrompts";
6
+ export type ConnectAiPlayerOptions = AiPlayerOptions & {
7
+ /** Max simulated transport latency in ms. Default 0 (the bot is in-process) */
8
+ latencyMs?: number;
9
+ /**
10
+ * How the bot reads the board. "live" (the default, unless the game's AI sets `serializedView`)
11
+ * reads the match's own objects in place: fast, but rules can see hidden information.
12
+ * "serialized" rebuilds exactly what the server sends this seat: fair, but every prompt costs a
13
+ * full redacted snapshot.
14
+ */
15
+ view?: "live" | "serialized";
16
+ };
17
+ export type AiPlayerHandle = {
18
+ playerId: string;
19
+ prompts: AiClientPrompts<any, any, any>;
20
+ status: ClientStatus<any, any>;
21
+ dispose: () => void;
22
+ };
23
+ /**
24
+ * Seats an AI player in a match. The bot connects like any other client, so it only ever sees
25
+ * what the server sends to `playerId`. Uses `match.game.ai` rules if the game defines them.
26
+ *
27
+ * This is the low-level primitive: it seats exactly one bot with exactly these options, which is
28
+ * what harnesses want (forced moves, per-seat params, a different AI per seat). Hosts that just
29
+ * want every seat flagged `ai` on its `PlayerInfo` played by the engine call
30
+ * {@link Match.seatAiPlayers} instead; it calls this for each such seat and skips seats already
31
+ * taken by a bot connected here.
32
+ *
33
+ * The bot's plan memory is kept in the match's saved state (see `AiMemoryStore`), so a bot
34
+ * re-seated after a reload continues its plan. It also follows `match.ai.enabled`.
35
+ *
36
+ * ```ts
37
+ * connectAiPlayer(match, "p2", { params: { weights }, onDecision: log });
38
+ * ```
39
+ *
40
+ * @group AI
41
+ */
42
+ export declare function connectAiPlayer<P extends PlayerChit, R extends RootChit<P>>(match: Match<P, R>, playerId: string, options?: ConnectAiPlayerOptions): AiPlayerHandle;
43
+ //# sourceMappingURL=connectAiPlayer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"connectAiPlayer.d.ts","sourceRoot":"","sources":["../../../src/library/game/ai/connectAiPlayer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAIrE,MAAM,MAAM,sBAAsB,GAAG,eAAe,GAAG;IACrD,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IACxC,MAAM,EAAE,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC/B,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,UAAU,EAAE,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,EACzE,KAAK,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,sBAA2B,GACnC,cAAc,CAmChB"}
@@ -0,0 +1,58 @@
1
+ import { Connection } from "../Connection";
2
+ import { LocalConnectionTransport } from "../ConnectionTransport";
3
+ import { ClientStatus } from "../clientTransport/ClientStatus";
4
+ import { AiClientPrompts } from "./AiClientPrompts";
5
+ import { AiPlayerView } from "./AiPlayerView";
6
+ import { AiLiveView } from "./AiLiveView";
7
+ /**
8
+ * Seats an AI player in a match. The bot connects like any other client, so it only ever sees
9
+ * what the server sends to `playerId`. Uses `match.game.ai` rules if the game defines them.
10
+ *
11
+ * This is the low-level primitive: it seats exactly one bot with exactly these options, which is
12
+ * what harnesses want (forced moves, per-seat params, a different AI per seat). Hosts that just
13
+ * want every seat flagged `ai` on its `PlayerInfo` played by the engine call
14
+ * {@link Match.seatAiPlayers} instead; it calls this for each such seat and skips seats already
15
+ * taken by a bot connected here.
16
+ *
17
+ * The bot's plan memory is kept in the match's saved state (see `AiMemoryStore`), so a bot
18
+ * re-seated after a reload continues its plan. It also follows `match.ai.enabled`.
19
+ *
20
+ * ```ts
21
+ * connectAiPlayer(match, "p2", { params: { weights }, onDecision: log });
22
+ * ```
23
+ *
24
+ * @group AI
25
+ */
26
+ export function connectAiPlayer(match, playerId, options = {}) {
27
+ const latency = options.latencyMs ?? 0;
28
+ const serverSide = new LocalConnectionTransport(latency);
29
+ const clientSide = new LocalConnectionTransport(latency);
30
+ const connection = new Connection(clientSide);
31
+ const mode = options.view ?? (match.game.ai?.serializedView ? "serialized" : "live");
32
+ const view = mode === "live" ? new AiLiveView(match) : new AiPlayerView(connection, match.game);
33
+ const status = new ClientStatus(connection);
34
+ const prompts = new AiClientPrompts(playerId, connection, match.game, view, {
35
+ ...options,
36
+ difficulty: options.difficulty ?? match.players.find((p) => p.id === playerId)?.ai?.difficulty,
37
+ memoryStore: options.memoryStore === undefined ? match.aiMemoryStore(playerId) : options.memoryStore,
38
+ disabled: options.disabled || !match.ai.enabled,
39
+ });
40
+ connection.register(view, "ClientTime");
41
+ connection.register(status, "ClientStatus");
42
+ connection.register(prompts, "ClientPrompts");
43
+ clientSide.connect(serverSide);
44
+ const serverConnection = match.connect(serverSide, playerId);
45
+ const handle = {
46
+ playerId,
47
+ prompts,
48
+ status,
49
+ dispose: () => {
50
+ match.ai.unregister(handle);
51
+ connection.dispose();
52
+ serverConnection.dispose();
53
+ },
54
+ };
55
+ match.ai.register(handle);
56
+ return handle;
57
+ }
58
+ //# sourceMappingURL=connectAiPlayer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"connectAiPlayer.js","sourceRoot":"","sources":["../../../src/library/game/ai/connectAiPlayer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAIlE,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAmB,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAqB1C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAkB,EAClB,QAAgB,EAChB,UAAkC,EAAE;IAEpC,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,IAAI,CAAC,CAAC;IACvC,MAAM,UAAU,GAAG,IAAI,wBAAwB,CAAC,OAAO,CAAC,CAAC;IACzD,MAAM,UAAU,GAAG,IAAI,wBAAwB,CAAC,OAAO,CAAC,CAAC;IACzD,MAAM,UAAU,GAAG,IAAI,UAAU,CAAC,UAAU,CAAC,CAAC;IAE9C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,cAAc,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACrF,MAAM,IAAI,GAAG,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,YAAY,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAChG,MAAM,MAAM,GAAG,IAAI,YAAY,CAAW,UAAU,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,IAAI,eAAe,CAAO,QAAQ,EAAE,UAAU,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE;QAChF,GAAG,OAAO;QACV,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,EAAE,EAAE,EAAE,UAAU;QAC9F,WAAW,EAAE,OAAO,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW;QACpG,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO;KAChD,CAAC,CAAC;IAEH,UAAU,CAAC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IACxC,UAAU,CAAC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC5C,UAAU,CAAC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;IAE9C,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/B,MAAM,gBAAgB,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAE7D,MAAM,MAAM,GAAmB;QAC7B,QAAQ;QACR,OAAO;QACP,MAAM;QACN,OAAO,EAAE,GAAG,EAAE;YACZ,KAAK,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;YAC5B,UAAU,CAAC,OAAO,EAAE,CAAC;YACrB,gBAAgB,CAAC,OAAO,EAAE,CAAC;QAC7B,CAAC;KACF,CAAC;IACF,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC1B,OAAO,MAAM,CAAC;AAChB,CAAC"}
@@ -0,0 +1,119 @@
1
+ import { Chit } from "../Chit";
2
+ import { GameButton } from "../GameButton";
3
+ import { PickType } from "../Pick";
4
+ import { PlayerChit } from "../PlayerChit";
5
+ import { RootChit } from "../RootChit";
6
+ /** Where an option came from. */
7
+ export type AiPickInfo = {
8
+ /** Index of the pick within the prompt */
9
+ index: number;
10
+ type: PickType;
11
+ message?: string;
12
+ help?: string;
13
+ context?: Chit;
14
+ /** Class name of the button, for ButtonPicks (e.g. "Confirm") */
15
+ buttonType?: string;
16
+ };
17
+ type AiOptionBase = {
18
+ /** The key passed to `.ai(key)` on the pick, if any */
19
+ key?: string;
20
+ /** The data passed to `.ai(key, data)` on the pick, if any */
21
+ data?: unknown;
22
+ pick: AiPickInfo;
23
+ };
24
+ /** Clicking a chit (from `Chit.pick`). `chit` comes from the AI player's own view of the board. */
25
+ export type AiChitOption = AiOptionBase & {
26
+ kind: "chit";
27
+ chit: Chit;
28
+ };
29
+ /** Dragging `chit` onto `target` (from `Chit.dragPick`). */
30
+ export type AiDragOption = AiOptionBase & {
31
+ kind: "drag";
32
+ chit: Chit;
33
+ target: Chit;
34
+ };
35
+ /** Pressing a button. */
36
+ export type AiButtonOption = AiOptionBase & {
37
+ kind: "button";
38
+ button: GameButton;
39
+ };
40
+ /** A single legal answer to the current prompt. */
41
+ export type AiOption = AiChitOption | AiDragOption | AiButtonOption;
42
+ export type AiContext<P extends PlayerChit, R extends RootChit<P>, M> = {
43
+ /**
44
+ * The board exactly as this player sees it: rebuilt from what the server sends this seat, so any
45
+ * property hidden by `hiddenPropertiesForSerialization` is `undefined`.
46
+ */
47
+ view: R;
48
+ /** This player's PlayerChit inside `view` */
49
+ me: P;
50
+ /** Every legal option in this prompt (useful for comparing against alternatives) */
51
+ options: AiOption[];
52
+ prompt: {
53
+ message?: string;
54
+ help?: string;
55
+ };
56
+ /** Per-bot random number generator in [0, 1) */
57
+ random: () => number;
58
+ /** The plan committed by earlier winning options. Read-only; change it by returning a `plan`. */
59
+ memory: Readonly<M>;
60
+ /** Look up a chit in `view` by id (e.g. an id stored in memory). Undefined if it no longer exists. */
61
+ find: (id: string) => Chit | undefined;
62
+ /** `params` from `connectAiPlayer` for this seat (per-seat weights, a personality…); undefined if none */
63
+ params: any;
64
+ };
65
+ /**
66
+ * What a rule returns: a plain score, or a score plus a plan. Higher scores are better, and
67
+ * `-Infinity` means "never pick this unless nothing else is possible". The plan is only
68
+ * committed to memory if this option is the one chosen. Pass a whole new memory value, or a
69
+ * function that updates the previous one.
70
+ */
71
+ export type AiScore<M> = number | {
72
+ score: number;
73
+ plan?: M | ((prev: M) => M);
74
+ };
75
+ export type AiRule<P extends PlayerChit, R extends RootChit<P>, M> = (option: AiOption, ctx: AiContext<P, R, M>) => AiScore<M>;
76
+ export interface GameAi<P extends PlayerChit, R extends RootChit<P>, M = Record<string, never>> {
77
+ /** Starting memory for each bot. Memory must be JSON-serializable: store chit ids, not chits. */
78
+ initialMemory?: () => M;
79
+ /** Rules keyed by the name passed to `.ai(key)` on a pick */
80
+ rules?: {
81
+ [key: string]: AiRule<P, R, M>;
82
+ };
83
+ /**
84
+ * Scores options from untagged picks (or tags with no matching rule). If it is not supplied,
85
+ * those options score 0 when mixed with tagged picks, and a prompt with no tagged picks at all
86
+ * is answered at random, weighted by `Game.demoPickWeight`.
87
+ */
88
+ default?: AiRule<P, R, M>;
89
+ /**
90
+ * Read the board through the serialized, per-seat view instead of the live game objects. The
91
+ * live view (the default) is much faster but lets rules read hidden fields and other players'
92
+ * unfinished simultaneous moves; set this when your rules would otherwise use information the
93
+ * seat should not have.
94
+ */
95
+ serializedView?: boolean;
96
+ /**
97
+ * Default for `connectAiPlayer`'s `temperature` (softmax over scores, in score units) for every
98
+ * bot of this game, including demo and Playground bots. Unset: the `difficulty` noise.
99
+ */
100
+ temperature?: number;
101
+ }
102
+ /**
103
+ * Declares a game's AI. Set it as `ai` on your Game class.
104
+ *
105
+ * ```ts
106
+ * export const ai = defineAi<MyPlayer, MyRoot, { target?: string }>({
107
+ * initialMemory: () => ({}),
108
+ * rules: {
109
+ * "market.buy": (opt, { me }) => ({ score: value(opt.chit as Card, me), plan: { target: opt.chit.id } }),
110
+ * "pass": () => 0,
111
+ * },
112
+ * });
113
+ * ```
114
+ *
115
+ * @group AI
116
+ */
117
+ export declare function defineAi<P extends PlayerChit, R extends RootChit<P>, M = Record<string, never>>(ai: GameAi<P, R, M>): GameAi<P, R, M>;
118
+ export {};
119
+ //# sourceMappingURL=defineAi.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"defineAi.d.ts","sourceRoot":"","sources":["../../../src/library/game/ai/defineAi.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,122 @@
1
+ /**
2
+ * Declares a game's AI. Set it as `ai` on your Game class.
3
+ *
4
+ * ```ts
5
+ * export const ai = defineAi<MyPlayer, MyRoot, { target?: string }>({
6
+ * initialMemory: () => ({}),
7
+ * rules: {
8
+ * "market.buy": (opt, { me }) => ({ score: value(opt.chit as Card, me), plan: { target: opt.chit.id } }),
9
+ * "pass": () => 0,
10
+ * },
11
+ * });
12
+ * ```
13
+ *
14
+ * @group AI
15
+ */
16
+ export function defineAi(ai) {
17
+ return ai;
18
+ }
19
+ /** @internal */
20
+ export function normalizeScore(score) {
21
+ if (typeof score === "number") {
22
+ return { score: Number.isNaN(score) ? 0 : score };
23
+ }
24
+ return { score: Number.isNaN(score?.score) ? 0 : (score?.score ?? 0), plan: score?.plan };
25
+ }
26
+ /** @internal */
27
+ export function applyPlan(memory, plan) {
28
+ if (plan === undefined) {
29
+ return memory;
30
+ }
31
+ return typeof plan === "function" ? plan(memory) : plan;
32
+ }
33
+ /**
34
+ * Picks an index from scored entries: the best score wins, near-ties are broken at random, and
35
+ * `noise` (0 = none, 1 = a lot) blurs the scores so bots aren't perfectly predictable. Entries
36
+ * scoring -Infinity are only chosen when nothing else is available.
37
+ * @internal
38
+ */
39
+ export function chooseIndex(scores, noise, random) {
40
+ if (scores.length === 0) {
41
+ return -1;
42
+ }
43
+ let candidates = scores.map((score, index) => ({ score, index })).filter((s) => s.score !== -Infinity);
44
+ if (candidates.length === 0) {
45
+ candidates = scores.map((score, index) => ({ score: 0, index }));
46
+ }
47
+ const finite = candidates.map((c) => c.score).filter((s) => Number.isFinite(s));
48
+ const spread = finite.length > 1 ? Math.max(...finite) - Math.min(...finite) : 0;
49
+ const scale = (spread || 1) * Math.max(0, noise);
50
+ const jittered = candidates.map((c) => ({ ...c, score: c.score + (random() - 0.5) * scale }));
51
+ const best = Math.max(...jittered.map((c) => c.score));
52
+ const epsilon = Number.isFinite(best) ? Math.max(1e-9, Math.abs(best) * 1e-9) : 0;
53
+ const top = jittered.filter((c) => (Number.isFinite(best) ? best - c.score <= epsilon : c.score === best));
54
+ return top[Math.floor(random() * top.length)].index;
55
+ }
56
+ /**
57
+ * Softmax choice: probability ∝ exp((score − best) / temperature). `-Infinity` options are only
58
+ * chosen when nothing else is possible; temperature ≤ 0 picks the best (ties at random).
59
+ * @internal
60
+ */
61
+ export function chooseSoftmax(scores, temperature, random) {
62
+ if (scores.length === 0)
63
+ return -1;
64
+ let idx = scores.map((s, i) => i).filter((i) => scores[i] !== -Infinity);
65
+ if (idx.length === 0)
66
+ idx = scores.map((_, i) => i);
67
+ const vals = idx.map((i) => (Number.isFinite(scores[i]) ? scores[i] : scores[i] > 0 ? Number.MAX_VALUE : 0));
68
+ const best = Math.max(...vals);
69
+ if (!(temperature > 0)) {
70
+ const top = idx.filter((_, k) => vals[k] === best);
71
+ return top[Math.floor(random() * top.length)];
72
+ }
73
+ const w = vals.map((v) => Math.exp((v - best) / temperature));
74
+ const total = w.reduce((a, b) => a + b, 0);
75
+ let r = random() * total;
76
+ for (let k = 0; k < idx.length; k++) {
77
+ r -= w[k];
78
+ if (r <= 0)
79
+ return idx[k];
80
+ }
81
+ return idx[idx.length - 1];
82
+ }
83
+ /**
84
+ * Chooses an index with probability proportional to its weight. Used when a prompt has no AI
85
+ * rules at all, and matches the old "bad AI" demo behaviour.
86
+ * @internal
87
+ */
88
+ export function chooseWeighted(weights, random) {
89
+ const total = weights.reduce((sum, w) => sum + Math.max(0, w), 0);
90
+ if (total <= 0) {
91
+ return Math.floor(random() * weights.length);
92
+ }
93
+ let roll = random() * total;
94
+ for (let i = 0; i < weights.length; i++) {
95
+ roll -= Math.max(0, weights[i]);
96
+ if (roll < 0) {
97
+ return i;
98
+ }
99
+ }
100
+ return weights.length - 1;
101
+ }
102
+ /** Small seedable PRNG (mulberry32). @internal */
103
+ export function createRandom(seed = Math.floor(Math.random() * 2 ** 32)) {
104
+ let a = seed >>> 0;
105
+ return () => {
106
+ a = (a + 0x6d2b79f5) >>> 0;
107
+ let t = a;
108
+ t = Math.imul(t ^ (t >>> 15), t | 1);
109
+ t ^= t + Math.imul(t ^ (t >>> 7), t | 61);
110
+ return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
111
+ };
112
+ }
113
+ /** FNV-1a string hash, used for situation fingerprints. @internal */
114
+ export function hashString(s) {
115
+ let h = 0x811c9dc5;
116
+ for (let i = 0; i < s.length; i++) {
117
+ h ^= s.charCodeAt(i);
118
+ h = Math.imul(h, 0x01000193);
119
+ }
120
+ return (h >>> 0).toString(36) + ":" + s.length.toString(36);
121
+ }
122
+ //# sourceMappingURL=defineAi.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"defineAi.js","sourceRoot":"","sources":["../../../src/library/game/ai/defineAi.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,62 @@
1
+ import { Game } from "../Game";
2
+ import { PlayerChit } from "../PlayerChit";
3
+ import { RootChit } from "../RootChit";
4
+ import { AiPlayerStats } from "./AiClientPrompts";
5
+ export type SimulateMatchesOptions = {
6
+ /** Number of seats. Default: whatever `Root.setupDemoGame()` returns */
7
+ players?: number;
8
+ /** Number of matches to play. Default 1 */
9
+ games?: number;
10
+ /** Stop a match after this many answered prompts (all bots combined). Default 5000 */
11
+ maxPrompts?: number;
12
+ /** Stop a match if nothing happens for this long. Default 5000ms */
13
+ stallMs?: number;
14
+ /** Stop a match after this long. Default 120000ms */
15
+ timeoutMs?: number;
16
+ /** Options passed to the match. Default: `Root.getCurrentlySelectedMatchOptions()` after `setupDemoGame()` */
17
+ matchOptions?: any;
18
+ difficulty?: number;
19
+ /** Let bots log untagged prompts and warnings. Default false */
20
+ log?: boolean;
21
+ /** How the bots read the board (see ConnectAiPlayerOptions.view). Default: the game's choice */
22
+ view?: "live" | "serialized";
23
+ };
24
+ export type SimulatedMatch = {
25
+ outcome: "finished" | "stalled" | "error" | "maxPrompts" | "timeout";
26
+ prompts: number;
27
+ durationMs: number;
28
+ winners: string[];
29
+ error?: string;
30
+ stats: {
31
+ [playerId: string]: AiPlayerStats;
32
+ };
33
+ };
34
+ export type SimulationReport = {
35
+ matches: SimulatedMatch[];
36
+ finished: number;
37
+ averagePrompts: number;
38
+ stepBacks: number;
39
+ rejections: number;
40
+ stalls: number;
41
+ stuck: number;
42
+ ruleErrors: number;
43
+ /** Untagged pick messages the bots hit, with counts: a to-do list for writing rules */
44
+ untagged: {
45
+ [message: string]: number;
46
+ };
47
+ };
48
+ /**
49
+ * Plays whole matches with an AI in every seat, headlessly, and reports whether they finish.
50
+ * Use it in a test to check that a game's AI never gets stuck:
51
+ *
52
+ * ```ts
53
+ * test("bots can finish a game", async () => {
54
+ * const report = await simulateMatches(new MyGame(), { players: 3, games: 5 });
55
+ * expect(report.finished).toBe(5);
56
+ * });
57
+ * ```
58
+ *
59
+ * @group AI
60
+ */
61
+ export declare function simulateMatches<P extends PlayerChit, R extends RootChit<P>>(game: Game<P, R>, options?: SimulateMatchesOptions): Promise<SimulationReport>;
62
+ //# sourceMappingURL=simulateMatches.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"simulateMatches.d.ts","sourceRoot":"","sources":["../../../src/library/game/ai/simulateMatches.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAG/B,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGlD,MAAM,MAAM,sBAAsB,GAAG;IACnC,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sFAAsF;IACtF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8GAA8G;IAC9G,YAAY,CAAC,EAAE,GAAG,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,gGAAgG;IAChG,IAAI,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,YAAY,GAAG,SAAS,CAAC;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE;QAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CAAA;KAAE,CAAC;CAC9C,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,uFAAuF;IACvF,QAAQ,EAAE;QAAE,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;CACzC,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,wBAAsB,eAAe,CAAC,CAAC,SAAS,UAAU,EAAE,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,EAC/E,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,EAChB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,gBAAgB,CAAC,CAwB3B"}
@@ -0,0 +1,108 @@
1
+ import { Match } from "../Match";
2
+ import { EphemeralMatchStorage } from "../MatchStorage";
3
+ import { PlayerInfo } from "../PlayerInfo";
4
+ import { connectAiPlayer } from "./connectAiPlayer";
5
+ /**
6
+ * Plays whole matches with an AI in every seat, headlessly, and reports whether they finish.
7
+ * Use it in a test to check that a game's AI never gets stuck:
8
+ *
9
+ * ```ts
10
+ * test("bots can finish a game", async () => {
11
+ * const report = await simulateMatches(new MyGame(), { players: 3, games: 5 });
12
+ * expect(report.finished).toBe(5);
13
+ * });
14
+ * ```
15
+ *
16
+ * @group AI
17
+ */
18
+ export async function simulateMatches(game, options = {}) {
19
+ const matches = [];
20
+ for (let i = 0; i < (options.games ?? 1); i++) {
21
+ matches.push(await simulateOne(game, options, i));
22
+ }
23
+ const all = matches.flatMap((m) => Object.values(m.stats));
24
+ const sum = (f) => all.reduce((acc, s) => acc + f(s), 0);
25
+ const untagged = {};
26
+ all.forEach((s) => Object.entries(s.untagged).forEach(([message, count]) => (untagged[message] = (untagged[message] ?? 0) + count)));
27
+ return {
28
+ matches,
29
+ finished: matches.filter((m) => m.outcome === "finished").length,
30
+ averagePrompts: matches.length ? matches.reduce((acc, m) => acc + m.prompts, 0) / matches.length : 0,
31
+ stepBacks: sum((s) => s.stepBacks),
32
+ rejections: sum((s) => s.rejections),
33
+ stalls: sum((s) => s.stalls),
34
+ stuck: sum((s) => s.stuck),
35
+ ruleErrors: sum((s) => s.ruleErrors),
36
+ untagged,
37
+ };
38
+ }
39
+ async function simulateOne(game, options, index) {
40
+ const started = Date.now();
41
+ const tempRoot = new game.chitLibrary.Root();
42
+ const defaultPlayers = tempRoot.setupDemoGame();
43
+ const matchOptions = options.matchOptions ?? tempRoot.getCurrentlySelectedMatchOptions();
44
+ const players = [];
45
+ for (let i = 0; i < (options.players ?? defaultPlayers); i++) {
46
+ const info = new PlayerInfo(`p${i}`, `Bot ${i + 1}`);
47
+ info.ai = { difficulty: options.difficulty };
48
+ players.push(info);
49
+ }
50
+ const match = new Match(game, players, new EphemeralMatchStorage(`simulation-${index}`, true), matchOptions);
51
+ match.immediateNotify = true; // headless: see Match.immediateNotify
52
+ await match.load();
53
+ const stallMs = options.stallMs ?? 5000;
54
+ const bots = players.map((p) => connectAiPlayer(match, p.id, { log: options.log ?? false, stallWarningMs: stallMs, view: options.view }));
55
+ const prompts = () => bots.reduce((acc, b) => acc + b.prompts.stats.promptsAnswered, 0);
56
+ const progress = () => bots.reduce((acc, b) => acc + b.prompts.stats.promptsAnswered + b.prompts.stats.stepBacks, 0);
57
+ let error;
58
+ const run = match.start().catch((e) => {
59
+ error = e instanceof Error ? e.message : String(e);
60
+ });
61
+ const outcome = await new Promise((resolve) => {
62
+ let lastProgress = -1;
63
+ let lastProgressAt = Date.now();
64
+ const timer = setInterval(() => {
65
+ const finish = (o) => {
66
+ clearInterval(timer);
67
+ resolve(o);
68
+ };
69
+ if (match.result.value)
70
+ return finish("finished");
71
+ if (error || match.errorState.value)
72
+ return finish("error");
73
+ if (prompts() > (options.maxPrompts ?? 5000))
74
+ return finish("maxPrompts");
75
+ if (Date.now() - started > (options.timeoutMs ?? 120000))
76
+ return finish("timeout");
77
+ const p = progress();
78
+ if (p !== lastProgress) {
79
+ lastProgress = p;
80
+ lastProgressAt = Date.now();
81
+ }
82
+ else if (Date.now() - lastProgressAt > stallMs && bots.every((b) => b.prompts.idle || b.prompts.stalled)) {
83
+ // Idle bots have nothing to answer; stalled ones answered and the server never reacted
84
+ return finish("stalled");
85
+ }
86
+ }, 20);
87
+ });
88
+ if (outcome === "finished") {
89
+ await run;
90
+ }
91
+ // Let in-flight answers settle so disposing doesn't reject them mid-flight
92
+ const settleUntil = Date.now() + 1000;
93
+ while (Date.now() < settleUntil && !bots.every((b) => b.prompts.idle || b.prompts.stalled)) {
94
+ await new Promise((resolve) => setTimeout(resolve, 10));
95
+ }
96
+ await new Promise((resolve) => setTimeout(resolve, 10));
97
+ const result = {
98
+ outcome,
99
+ prompts: prompts(),
100
+ durationMs: Date.now() - started,
101
+ winners: match.result.value?.winners.map((w) => w.id ?? "") ?? [],
102
+ error: error ?? match.errorState.value,
103
+ stats: Object.fromEntries(bots.map((b) => [b.playerId, b.prompts.stats])),
104
+ };
105
+ bots.forEach((b) => b.dispose());
106
+ return result;
107
+ }
108
+ //# sourceMappingURL=simulateMatches.js.map