@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.
- package/README.md +8 -0
- package/dist/components/ActionLogDisplay.d.ts.map +1 -1
- package/dist/components/ActionLogDisplay.js +1 -1
- package/dist/components/ActionLogDisplay.js.map +1 -1
- package/dist/components/BottomBarButton.d.ts +3 -1
- package/dist/components/BottomBarButton.d.ts.map +1 -1
- package/dist/components/BottomBarButton.js +3 -2
- package/dist/components/BottomBarButton.js.map +1 -1
- package/dist/components/ContextGalleryDisplay.d.ts.map +1 -1
- package/dist/components/ContextGalleryDisplay.js +1 -1
- package/dist/components/ContextGalleryDisplay.js.map +1 -1
- package/dist/components/DemoWrapper.d.ts +30 -2
- package/dist/components/DemoWrapper.d.ts.map +1 -1
- package/dist/components/DemoWrapper.js +79 -36
- package/dist/components/DemoWrapper.js.map +1 -1
- package/dist/components/FullScreenGalleryDisplay.d.ts.map +1 -1
- package/dist/components/FullScreenGalleryDisplay.js +2 -2
- package/dist/components/FullScreenGalleryDisplay.js.map +1 -1
- package/dist/components/Gallery/BuiltItem.d.ts +6 -2
- package/dist/components/Gallery/BuiltItem.d.ts.map +1 -1
- package/dist/components/Gallery/BuiltItem.js +28 -9
- package/dist/components/Gallery/BuiltItem.js.map +1 -1
- package/dist/components/Gallery/GalleryController.d.ts +18 -0
- package/dist/components/Gallery/GalleryController.d.ts.map +1 -1
- package/dist/components/Gallery/GalleryController.js +67 -0
- package/dist/components/Gallery/GalleryController.js.map +1 -1
- package/dist/components/Gallery/GalleryViewer.d.ts +6 -1
- package/dist/components/Gallery/GalleryViewer.d.ts.map +1 -1
- package/dist/components/Gallery/GalleryViewer.js +48 -10
- package/dist/components/Gallery/GalleryViewer.js.map +1 -1
- package/dist/components/Gallery/LayoutManager.d.ts +6 -0
- package/dist/components/Gallery/LayoutManager.d.ts.map +1 -1
- package/dist/components/Gallery/LayoutManager.js +23 -3
- package/dist/components/Gallery/LayoutManager.js.map +1 -1
- package/dist/components/Gallery/constants.d.ts +2 -0
- package/dist/components/Gallery/constants.d.ts.map +1 -1
- package/dist/components/Gallery/constants.js +2 -0
- package/dist/components/Gallery/constants.js.map +1 -1
- package/dist/components/Gallery/registry.d.ts +34 -0
- package/dist/components/Gallery/registry.d.ts.map +1 -0
- package/dist/components/Gallery/registry.js +17 -0
- package/dist/components/Gallery/registry.js.map +1 -0
- package/dist/components/GameDesigner.d.ts.map +1 -1
- package/dist/components/GameDesigner.js +42 -10
- package/dist/components/GameDesigner.js.map +1 -1
- package/dist/components/InlineGalleryDisplay.d.ts.map +1 -1
- package/dist/components/InlineGalleryDisplay.js +2 -2
- package/dist/components/InlineGalleryDisplay.js.map +1 -1
- package/dist/components/LiveButton.d.ts.map +1 -1
- package/dist/components/LiveButton.js +5 -2
- package/dist/components/LiveButton.js.map +1 -1
- package/dist/components/MatchViewer.d.ts +6 -1
- package/dist/components/MatchViewer.d.ts.map +1 -1
- package/dist/components/MatchViewer.js +9 -3
- package/dist/components/MatchViewer.js.map +1 -1
- package/dist/components/Panel/MultiPanel.d.ts.map +1 -1
- package/dist/components/Panel/MultiPanel.js +18 -0
- package/dist/components/Panel/MultiPanel.js.map +1 -1
- package/dist/components/Panel/PanelContents.d.ts.map +1 -1
- package/dist/components/Panel/PanelContents.js +92 -23
- package/dist/components/Panel/PanelContents.js.map +1 -1
- package/dist/components/Panel/PanelTabStack.d.ts.map +1 -1
- package/dist/components/Panel/PanelTabStack.js +1 -1
- package/dist/components/Panel/PanelTabStack.js.map +1 -1
- package/dist/components/PanelSpark.d.ts.map +1 -1
- package/dist/components/PanelSpark.js +3 -2
- package/dist/components/PanelSpark.js.map +1 -1
- package/dist/components/Playground.d.ts.map +1 -1
- package/dist/components/Playground.js +10 -4
- package/dist/components/Playground.js.map +1 -1
- package/dist/components/PromptControls.d.ts.map +1 -1
- package/dist/components/PromptControls.js +4 -2
- package/dist/components/PromptControls.js.map +1 -1
- package/dist/components/SparkLineChart.d.ts.map +1 -1
- package/dist/components/SparkLineChart.js +22 -26
- package/dist/components/SparkLineChart.js.map +1 -1
- package/dist/components/TimeControlBar.d.ts.map +1 -1
- package/dist/components/TimeControlBar.js +5 -3
- package/dist/components/TimeControlBar.js.map +1 -1
- package/dist/components/TokenizedMarkdown.d.ts +23 -0
- package/dist/components/TokenizedMarkdown.d.ts.map +1 -0
- package/dist/components/TokenizedMarkdown.js +144 -0
- package/dist/components/TokenizedMarkdown.js.map +1 -0
- package/dist/components/TokenizedMessage.d.ts +6 -0
- package/dist/components/TokenizedMessage.d.ts.map +1 -1
- package/dist/components/TokenizedMessage.js +20 -19
- package/dist/components/TokenizedMessage.js.map +1 -1
- package/dist/components/TopBarPlayers.d.ts.map +1 -1
- package/dist/components/TopBarPlayers.js +1 -1
- package/dist/components/TopBarPlayers.js.map +1 -1
- package/dist/components/Tutorial/BrowserNarration.d.ts +55 -0
- package/dist/components/Tutorial/BrowserNarration.d.ts.map +1 -0
- package/dist/components/Tutorial/BrowserNarration.js +240 -0
- package/dist/components/Tutorial/BrowserNarration.js.map +1 -0
- package/dist/components/Tutorial/TutorialBox.d.ts +26 -0
- package/dist/components/Tutorial/TutorialBox.d.ts.map +1 -0
- package/dist/components/Tutorial/TutorialBox.js +239 -0
- package/dist/components/Tutorial/TutorialBox.js.map +1 -0
- package/dist/components/Tutorial/TutorialDevPanel.d.ts +9 -0
- package/dist/components/Tutorial/TutorialDevPanel.d.ts.map +1 -0
- package/dist/components/Tutorial/TutorialDevPanel.js +92 -0
- package/dist/components/Tutorial/TutorialDevPanel.js.map +1 -0
- package/dist/components/Tutorial/TutorialOverlay.d.ts +7 -0
- package/dist/components/Tutorial/TutorialOverlay.d.ts.map +1 -0
- package/dist/components/Tutorial/TutorialOverlay.js +1132 -0
- package/dist/components/Tutorial/TutorialOverlay.js.map +1 -0
- package/dist/components/Tutorial/targetRects.d.ts +67 -0
- package/dist/components/Tutorial/targetRects.d.ts.map +1 -0
- package/dist/components/Tutorial/targetRects.js +241 -0
- package/dist/components/Tutorial/targetRects.js.map +1 -0
- package/dist/game/Chit.d.ts +7 -0
- package/dist/game/Chit.d.ts.map +1 -1
- package/dist/game/Chit.js +20 -5
- package/dist/game/Chit.js.map +1 -1
- package/dist/game/ClientTimeState.d.ts +14 -0
- package/dist/game/ClientTimeState.d.ts.map +1 -1
- package/dist/game/ClientTimeState.js +17 -0
- package/dist/game/ClientTimeState.js.map +1 -1
- package/dist/game/Game.d.ts +6 -0
- package/dist/game/Game.d.ts.map +1 -1
- package/dist/game/GameTheme.d.ts +3 -0
- package/dist/game/GameTheme.d.ts.map +1 -1
- package/dist/game/GameTheme.js +2 -0
- package/dist/game/GameTheme.js.map +1 -1
- package/dist/game/Match.d.ts +8 -2
- package/dist/game/Match.d.ts.map +1 -1
- package/dist/game/Match.js +4 -1
- package/dist/game/Match.js.map +1 -1
- package/dist/game/Pick.d.ts +2 -0
- package/dist/game/Pick.d.ts.map +1 -1
- package/dist/game/Pick.js +17 -1
- package/dist/game/Pick.js.map +1 -1
- package/dist/game/PlayerPromptStatusChit.d.ts +8 -0
- package/dist/game/PlayerPromptStatusChit.d.ts.map +1 -1
- package/dist/game/PlayerPromptStatusChit.js +5 -1
- package/dist/game/PlayerPromptStatusChit.js.map +1 -1
- package/dist/game/Prompt.d.ts +15 -0
- package/dist/game/Prompt.d.ts.map +1 -1
- package/dist/game/Prompt.js +16 -0
- package/dist/game/Prompt.js.map +1 -1
- package/dist/game/Turn.d.ts +15 -4
- package/dist/game/Turn.d.ts.map +1 -1
- package/dist/game/Turn.js +173 -60
- package/dist/game/Turn.js.map +1 -1
- package/dist/game/TurnState.d.ts +12 -1
- package/dist/game/TurnState.d.ts.map +1 -1
- package/dist/game/TurnState.js +15 -3
- package/dist/game/TurnState.js.map +1 -1
- package/dist/game/ai/AiClientPrompts.d.ts +20 -3
- package/dist/game/ai/AiClientPrompts.d.ts.map +1 -1
- package/dist/game/ai/AiClientPrompts.js +42 -6
- package/dist/game/ai/AiClientPrompts.js.map +1 -1
- package/dist/game/ai/AiPlayerView.js +2 -0
- package/dist/game/ai/AiPlayerView.js.map +1 -1
- package/dist/game/clientTransport/ClientPrompts.d.ts +20 -1
- package/dist/game/clientTransport/ClientPrompts.d.ts.map +1 -1
- package/dist/game/clientTransport/ClientPrompts.js +30 -1
- package/dist/game/clientTransport/ClientPrompts.js.map +1 -1
- package/dist/game/clientTransport/ClientTime.d.ts +13 -0
- package/dist/game/clientTransport/ClientTime.d.ts.map +1 -1
- package/dist/game/clientTransport/ClientTime.js +51 -11
- package/dist/game/clientTransport/ClientTime.js.map +1 -1
- package/dist/game/tutorial/TutorialController.d.ts +300 -0
- package/dist/game/tutorial/TutorialController.d.ts.map +1 -0
- package/dist/game/tutorial/TutorialController.js +1182 -0
- package/dist/game/tutorial/TutorialController.js.map +1 -0
- package/dist/game/tutorial/TutorialRuntime.d.ts +89 -0
- package/dist/game/tutorial/TutorialRuntime.d.ts.map +1 -0
- package/dist/game/tutorial/TutorialRuntime.js +261 -0
- package/dist/game/tutorial/TutorialRuntime.js.map +1 -0
- package/dist/game/tutorial/TutorialTheme.d.ts +28 -0
- package/dist/game/tutorial/TutorialTheme.d.ts.map +1 -0
- package/dist/game/tutorial/TutorialTheme.js +39 -0
- package/dist/game/tutorial/TutorialTheme.js.map +1 -0
- package/dist/game/tutorial/allowed.d.ts +2 -0
- package/dist/game/tutorial/allowed.d.ts.map +1 -0
- package/dist/game/tutorial/allowed.js +119 -0
- package/dist/game/tutorial/allowed.js.map +1 -0
- package/dist/game/tutorial/checks.d.ts +58 -0
- package/dist/game/tutorial/checks.d.ts.map +1 -0
- package/dist/game/tutorial/checks.js +144 -0
- package/dist/game/tutorial/checks.js.map +1 -0
- package/dist/game/tutorial/createDemoMatch.d.ts +47 -0
- package/dist/game/tutorial/createDemoMatch.d.ts.map +1 -0
- package/dist/game/tutorial/createDemoMatch.js +67 -0
- package/dist/game/tutorial/createDemoMatch.js.map +1 -0
- package/dist/game/tutorial/defineTutorial.d.ts +353 -0
- package/dist/game/tutorial/defineTutorial.d.ts.map +1 -0
- package/dist/game/tutorial/defineTutorial.js +86 -0
- package/dist/game/tutorial/defineTutorial.js.map +1 -0
- package/dist/game/tutorial/runTutorial.d.ts +63 -0
- package/dist/game/tutorial/runTutorial.d.ts.map +1 -0
- package/dist/game/tutorial/runTutorial.js +273 -0
- package/dist/game/tutorial/runTutorial.js.map +1 -0
- package/dist/hooks/usePanelNavigation.d.ts +28 -0
- package/dist/hooks/usePanelNavigation.d.ts.map +1 -0
- package/dist/hooks/usePanelNavigation.js +36 -0
- package/dist/hooks/usePanelNavigation.js.map +1 -0
- package/dist/hooks/useTimeController.d.ts +2 -1
- package/dist/hooks/useTimeController.d.ts.map +1 -1
- package/dist/hooks/useTimeController.js +6 -2
- package/dist/hooks/useTimeController.js.map +1 -1
- package/dist/hooks/useTutorial.d.ts +48 -0
- package/dist/hooks/useTutorial.d.ts.map +1 -0
- package/dist/hooks/useTutorial.js +16 -0
- package/dist/hooks/useTutorial.js.map +1 -0
- package/dist/index.d.ts +36 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.html +12 -0
- package/dist/index.js +19 -2
- package/dist/index.js.map +1 -1
- package/dist/main.0792d734cde2c688d5f7.hot-update.js +16991 -0
- package/dist/main.0792d734cde2c688d5f7.hot-update.js.map +1 -0
- package/dist/main.0792d734cde2c688d5f7.hot-update.json +1 -0
- package/dist/pretty-chitty.js +204513 -0
- package/dist/pretty-chitty.js.map +1 -0
- package/dist/rendering/CameraWrapperPerspective.d.ts +5 -0
- package/dist/rendering/CameraWrapperPerspective.d.ts.map +1 -1
- package/dist/rendering/CameraWrapperPerspective.js +16 -0
- package/dist/rendering/CameraWrapperPerspective.js.map +1 -1
- package/dist/rendering/ChitGalleryItemInstance.d.ts +1 -0
- package/dist/rendering/ChitGalleryItemInstance.d.ts.map +1 -1
- package/dist/rendering/ChitGalleryItemInstance.js +12 -0
- package/dist/rendering/ChitGalleryItemInstance.js.map +1 -1
- package/dist/rendering/ChitRenderInstance.d.ts +9 -1
- package/dist/rendering/ChitRenderInstance.d.ts.map +1 -1
- package/dist/rendering/ChitRenderInstance.js +28 -0
- package/dist/rendering/ChitRenderInstance.js.map +1 -1
- package/dist/rendering/RootChitRenderInstance.d.ts +2 -0
- package/dist/rendering/RootChitRenderInstance.d.ts.map +1 -1
- package/dist/rendering/RootChitRenderInstance.js +29 -0
- package/dist/rendering/RootChitRenderInstance.js.map +1 -1
- package/dist/utilities/Annotations.d.ts +15 -0
- package/dist/utilities/Annotations.d.ts.map +1 -1
- package/dist/utilities/Annotations.js +31 -7
- package/dist/utilities/Annotations.js.map +1 -1
- package/dist/utilities/CanvasStack/CanvasStack.d.ts +2 -0
- package/dist/utilities/CanvasStack/CanvasStack.d.ts.map +1 -1
- package/dist/utilities/CanvasStack/CanvasStack.js +4 -0
- package/dist/utilities/CanvasStack/CanvasStack.js.map +1 -1
- package/dist/utilities/TokenizedText.d.ts +6 -0
- package/dist/utilities/TokenizedText.d.ts.map +1 -1
- package/dist/utilities/TokenizedText.js.map +1 -1
- package/dist/utilities/zIndex.d.ts +1 -0
- package/dist/utilities/zIndex.d.ts.map +1 -1
- package/dist/utilities/zIndex.js +1 -0
- package/dist/utilities/zIndex.js.map +1 -1
- package/package.json +3 -2
- package/src/library/components/ActionLogDisplay.tsx +1 -0
- package/src/library/components/BottomBarButton.tsx +5 -0
- package/src/library/components/ContextGalleryDisplay.tsx +2 -0
- package/src/library/components/DemoWrapper.tsx +147 -44
- package/src/library/components/FullScreenGalleryDisplay.tsx +3 -0
- package/src/library/components/Gallery/BuiltItem.ts +30 -9
- package/src/library/components/Gallery/GalleryController.ts +72 -1
- package/src/library/components/Gallery/GalleryViewer.tsx +54 -10
- package/src/library/components/Gallery/LayoutManager.ts +30 -6
- package/src/library/components/Gallery/constants.ts +2 -0
- package/src/library/components/Gallery/registry.ts +44 -0
- package/src/library/components/GameDesigner.tsx +121 -12
- package/src/library/components/InlineGalleryDisplay.tsx +5 -0
- package/src/library/components/LiveButton.tsx +8 -5
- package/src/library/components/MatchViewer.tsx +14 -3
- package/src/library/components/Panel/MultiPanel.tsx +21 -0
- package/src/library/components/Panel/PanelContents.tsx +70 -1
- package/src/library/components/Panel/PanelTabStack.tsx +1 -0
- package/src/library/components/PanelSpark.tsx +9 -4
- package/src/library/components/Playground.tsx +48 -21
- package/src/library/components/PromptControls.tsx +7 -3
- package/src/library/components/SparkLineChart.tsx +23 -27
- package/src/library/components/TimeControlBar.tsx +5 -3
- package/src/library/components/TokenizedMarkdown.tsx +224 -0
- package/src/library/components/TokenizedMessage.tsx +28 -32
- package/src/library/components/TopBarPlayers.tsx +12 -9
- package/src/library/components/Tutorial/BrowserNarration.ts +233 -0
- package/src/library/components/Tutorial/TutorialBox.tsx +506 -0
- package/src/library/components/Tutorial/TutorialDevPanel.tsx +297 -0
- package/src/library/components/Tutorial/TutorialOverlay.tsx +1301 -0
- package/src/library/components/Tutorial/targetRects.ts +273 -0
- package/src/library/game/Chit.ts +21 -5
- package/src/library/game/ClientTimeState.ts +18 -0
- package/src/library/game/Game.ts +7 -0
- package/src/library/game/GameTheme.ts +4 -0
- package/src/library/game/Match.ts +12 -2
- package/src/library/game/Pick.ts +16 -1
- package/src/library/game/PlayerPromptStatusChit.ts +5 -1
- package/src/library/game/Prompt.ts +20 -0
- package/src/library/game/Turn.ts +179 -61
- package/src/library/game/TurnState.ts +26 -3
- package/src/library/game/ai/AI_GUIDE.md +10 -0
- package/src/library/game/ai/AiClientPrompts.ts +60 -11
- package/src/library/game/ai/AiPlayerView.ts +2 -0
- package/src/library/game/clientTransport/ClientPrompts.ts +31 -1
- package/src/library/game/clientTransport/ClientTime.ts +54 -13
- package/src/library/game/serialize.test.ts +275 -0
- package/src/library/game/tutorial/TUTORIAL_GUIDE.md +411 -0
- package/src/library/game/tutorial/TutorialController.test.ts +731 -0
- package/src/library/game/tutorial/TutorialController.ts +1286 -0
- package/src/library/game/tutorial/TutorialRuntime.ts +311 -0
- package/src/library/game/tutorial/TutorialTheme.ts +67 -0
- package/src/library/game/tutorial/allowed.ts +145 -0
- package/src/library/game/tutorial/checks.ts +186 -0
- package/src/library/game/tutorial/createDemoMatch.ts +115 -0
- package/src/library/game/tutorial/defineTutorial.ts +414 -0
- package/src/library/game/tutorial/runTutorial.ts +331 -0
- package/src/library/game/undo.test.ts +282 -0
- package/src/library/hooks/usePanelNavigation.tsx +65 -0
- package/src/library/hooks/useTimeController.tsx +6 -2
- package/src/library/hooks/useTutorial.tsx +76 -0
- package/src/library/index.ts +57 -2
- package/src/library/rendering/CameraWrapperPerspective.ts +17 -0
- package/src/library/rendering/ChitGalleryItemInstance.ts +12 -0
- package/src/library/rendering/ChitRenderInstance.ts +34 -0
- package/src/library/rendering/RootChitRenderInstance.ts +30 -1
- package/src/library/utilities/Annotations.ts +35 -7
- package/src/library/utilities/CanvasStack/CanvasStack.ts +6 -1
- package/src/library/utilities/TokenizedText.ts +6 -0
- package/src/library/utilities/zIndex.ts +1 -0
|
@@ -0,0 +1,186 @@
|
|
|
1
|
+
import { Chit } from "../Chit";
|
|
2
|
+
import { PlayerChit } from "../PlayerChit";
|
|
3
|
+
import { RootChit } from "../RootChit";
|
|
4
|
+
import { CheckResult, Checker, ChitSelector, TutorialContext, selectChits } from "./defineTutorial";
|
|
5
|
+
|
|
6
|
+
type P_ = PlayerChit;
|
|
7
|
+
type R_ = RootChit<any>;
|
|
8
|
+
|
|
9
|
+
function make<P extends P_, R extends R_>(
|
|
10
|
+
fn: (ctx: TutorialContext<P, R>) => CheckResult,
|
|
11
|
+
reset?: (ctx: TutorialContext<P, R>) => void,
|
|
12
|
+
): Checker<P, R> {
|
|
13
|
+
const result = fn as Checker<P, R>;
|
|
14
|
+
if (reset) result.reset = reset;
|
|
15
|
+
return result;
|
|
16
|
+
}
|
|
17
|
+
|
|
18
|
+
function count<P extends P_, R extends R_>(sel: ChitSelector<P, R>, ctx: TutorialContext<P, R>) {
|
|
19
|
+
return selectChits(sel, ctx.root, ctx.me).length;
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
/**
|
|
23
|
+
* Building blocks for `TutorialStep.waitFor`. Every check is a plain predicate on the state the
|
|
24
|
+
* player sees, so "did they do it" tolerates order and alternatives by construction. Return a string
|
|
25
|
+
* from your own checker to explain why not yet; the box shows it as the hint.
|
|
26
|
+
*
|
|
27
|
+
* ```ts
|
|
28
|
+
* waitFor: checks.all(checks.countChanged((r, me) => me.hand, 1), checks.promptFor("none"))
|
|
29
|
+
* ```
|
|
30
|
+
*
|
|
31
|
+
* @group Tutorials
|
|
32
|
+
*/
|
|
33
|
+
export const checks = {
|
|
34
|
+
/** Every check passes. Hints come from the first one that fails. */
|
|
35
|
+
all<P extends P_, R extends R_>(...list: Checker<P, R>[]): Checker<P, R> {
|
|
36
|
+
return make(
|
|
37
|
+
(ctx) => {
|
|
38
|
+
for (const c of list) {
|
|
39
|
+
const r = c(ctx);
|
|
40
|
+
if (r !== true) return r;
|
|
41
|
+
}
|
|
42
|
+
return true;
|
|
43
|
+
},
|
|
44
|
+
(ctx) => list.forEach((c) => c.reset?.(ctx)),
|
|
45
|
+
);
|
|
46
|
+
},
|
|
47
|
+
|
|
48
|
+
/** Any one check passes. The hint is the last failing one's. */
|
|
49
|
+
any<P extends P_, R extends R_>(...list: Checker<P, R>[]): Checker<P, R> {
|
|
50
|
+
return make(
|
|
51
|
+
(ctx) => {
|
|
52
|
+
let last: CheckResult = false;
|
|
53
|
+
for (const c of list) {
|
|
54
|
+
const r = c(ctx);
|
|
55
|
+
if (r === true) return true;
|
|
56
|
+
last = r;
|
|
57
|
+
}
|
|
58
|
+
return last;
|
|
59
|
+
},
|
|
60
|
+
(ctx) => list.forEach((c) => c.reset?.(ctx)),
|
|
61
|
+
);
|
|
62
|
+
},
|
|
63
|
+
|
|
64
|
+
not<P extends P_, R extends R_>(c: Checker<P, R>, hint?: string): Checker<P, R> {
|
|
65
|
+
return make(
|
|
66
|
+
(ctx) => (c(ctx) === true ? (hint ?? false) : true),
|
|
67
|
+
(ctx) => c.reset?.(ctx),
|
|
68
|
+
);
|
|
69
|
+
},
|
|
70
|
+
|
|
71
|
+
/** The selector returns `delta` more chits (negative: fewer) than when the step started. */
|
|
72
|
+
countChanged<P extends P_, R extends R_>(sel: ChitSelector<P, R>, delta: number, hint?: string): Checker<P, R> {
|
|
73
|
+
let start = 0;
|
|
74
|
+
return make(
|
|
75
|
+
(ctx) => {
|
|
76
|
+
const now = count(sel, ctx);
|
|
77
|
+
if (delta >= 0 ? now - start >= delta : now - start <= delta) return true;
|
|
78
|
+
return hint ?? false;
|
|
79
|
+
},
|
|
80
|
+
(ctx) => {
|
|
81
|
+
start = count(sel, ctx);
|
|
82
|
+
},
|
|
83
|
+
);
|
|
84
|
+
},
|
|
85
|
+
|
|
86
|
+
/** The selector returns at least `n` chits (default 1). */
|
|
87
|
+
exists<P extends P_, R extends R_>(sel: ChitSelector<P, R>, n = 1, hint?: string): Checker<P, R> {
|
|
88
|
+
return make((ctx) => (count(sel, ctx) >= n ? true : (hint ?? false)));
|
|
89
|
+
},
|
|
90
|
+
|
|
91
|
+
/** Every chit the selector returns now lives under a chit the parent selector returns (or has that outlet name). */
|
|
92
|
+
moved<P extends P_, R extends R_>(
|
|
93
|
+
sel: ChitSelector<P, R>,
|
|
94
|
+
parent: ChitSelector<P, R> | string,
|
|
95
|
+
hint?: string,
|
|
96
|
+
): Checker<P, R> {
|
|
97
|
+
return make((ctx) => {
|
|
98
|
+
const chits = selectChits(sel, ctx.root, ctx.me);
|
|
99
|
+
if (chits.length === 0) return hint ?? false;
|
|
100
|
+
const ok = chits.every((c) => {
|
|
101
|
+
if (typeof parent === "string") return c.parentOutlet === parent;
|
|
102
|
+
const parents = selectChits(parent, ctx.root, ctx.me);
|
|
103
|
+
return parents.some((p) => c.parent === p);
|
|
104
|
+
});
|
|
105
|
+
return ok ? true : (hint ?? false);
|
|
106
|
+
});
|
|
107
|
+
},
|
|
108
|
+
|
|
109
|
+
/** A property on the chit(s) the selector returns satisfies `pred` (every chit, if several). */
|
|
110
|
+
prop<P extends P_, R extends R_, C extends Chit = Chit>(
|
|
111
|
+
sel: ChitSelector<P, R>,
|
|
112
|
+
pred: (chit: C) => boolean,
|
|
113
|
+
hint?: string,
|
|
114
|
+
): Checker<P, R> {
|
|
115
|
+
return make((ctx) => {
|
|
116
|
+
const chits = selectChits(sel, ctx.root, ctx.me) as C[];
|
|
117
|
+
return chits.length > 0 && chits.every(pred) ? true : (hint ?? false);
|
|
118
|
+
});
|
|
119
|
+
},
|
|
120
|
+
|
|
121
|
+
/** A value derived from the state satisfies `pred`. The simplest escape hatch. */
|
|
122
|
+
state<P extends P_, R extends R_>(pred: (root: R, me: P) => boolean, hint?: string): Checker<P, R> {
|
|
123
|
+
return make((ctx) => (pred(ctx.root, ctx.me) ? true : (hint ?? false)));
|
|
124
|
+
},
|
|
125
|
+
|
|
126
|
+
/** Whose turn it is: "me" (the player has a prompt), "none" (they do not). */
|
|
127
|
+
promptFor<P extends P_, R extends R_>(who: "me" | "none", hint?: string): Checker<P, R> {
|
|
128
|
+
return make((ctx) => {
|
|
129
|
+
const mine = !!ctx.prompt;
|
|
130
|
+
return (who === "me") === mine ? true : (hint ?? false);
|
|
131
|
+
});
|
|
132
|
+
},
|
|
133
|
+
|
|
134
|
+
/** The player's current prompt message matches. */
|
|
135
|
+
promptMessage<P extends P_, R extends R_>(re: RegExp, hint?: string): Checker<P, R> {
|
|
136
|
+
return make((ctx) => (ctx.prompt && re.test(ctx.prompt.message) ? true : (hint ?? false)));
|
|
137
|
+
},
|
|
138
|
+
|
|
139
|
+
/** One of the prompt's buttons has this label (e.g. the engine's Confirm). */
|
|
140
|
+
promptHasButton<P extends P_, R extends R_>(label: string, hint?: string): Checker<P, R> {
|
|
141
|
+
return make((ctx) =>
|
|
142
|
+
ctx.prompt?.buttons.some((b) => b.label.toLowerCase() === label.toLowerCase()) ? true : (hint ?? false),
|
|
143
|
+
);
|
|
144
|
+
},
|
|
145
|
+
|
|
146
|
+
/** A log line written since the step started matches. */
|
|
147
|
+
logged<P extends P_, R extends R_>(re: RegExp, hint?: string): Checker<P, R> {
|
|
148
|
+
return make((ctx) => (ctx.recentLog.some((l) => re.test(l)) ? true : (hint ?? false)));
|
|
149
|
+
},
|
|
150
|
+
|
|
151
|
+
/** The clock moved on by at least `n` (default 1) since the step started. */
|
|
152
|
+
clockAdvanced<P extends P_, R extends R_>(n = 1, hint?: string): Checker<P, R> {
|
|
153
|
+
return make((ctx) => (ctx.clock - ctx.stepStartClock >= n ? true : (hint ?? false)));
|
|
154
|
+
},
|
|
155
|
+
|
|
156
|
+
/**
|
|
157
|
+
* A gallery is open: any, or one showing a container's children (`of`), or one in a given mode.
|
|
158
|
+
* `of` matches a gallery opened from that container, or one that shows exactly its children.
|
|
159
|
+
*/
|
|
160
|
+
galleryOpen<P extends P_, R extends R_>(
|
|
161
|
+
opts: { of?: ChitSelector<P, R>; mode?: "inline" | "fullscreen" } = {},
|
|
162
|
+
hint?: string,
|
|
163
|
+
): Checker<P, R> {
|
|
164
|
+
return make((ctx) => {
|
|
165
|
+
const of = opts.of ? selectChits(opts.of, ctx.root, ctx.me)[0] : undefined;
|
|
166
|
+
const ok = ctx.galleries.some((g) => {
|
|
167
|
+
if (opts.mode && g.mode !== opts.mode) return false;
|
|
168
|
+
if (!of) return true;
|
|
169
|
+
if (g.of === of.id) return true;
|
|
170
|
+
const children = of.children.map((c) => c.id);
|
|
171
|
+
return children.length > 0 && children.every((id) => id && g.chitIds.includes(id));
|
|
172
|
+
});
|
|
173
|
+
return ok ? true : (hint ?? false);
|
|
174
|
+
});
|
|
175
|
+
},
|
|
176
|
+
|
|
177
|
+
/** No gallery is open */
|
|
178
|
+
galleryClosed<P extends P_, R extends R_>(hint?: string): Checker<P, R> {
|
|
179
|
+
return make((ctx) => (ctx.galleries.length === 0 ? true : (hint ?? false)));
|
|
180
|
+
},
|
|
181
|
+
|
|
182
|
+
/** Passes right away. For a "do it" step that only exists to pause the bots or run `onEnter`. */
|
|
183
|
+
always<P extends P_, R extends R_>(): Checker<P, R> {
|
|
184
|
+
return make(() => true);
|
|
185
|
+
},
|
|
186
|
+
};
|
|
@@ -0,0 +1,115 @@
|
|
|
1
|
+
import { Game } from "../Game";
|
|
2
|
+
import { Match, SeatAiPlayersOptions } from "../Match";
|
|
3
|
+
import { EphemeralMatchStorage, IMatchStorage } from "../MatchStorage";
|
|
4
|
+
import { PlayerChit } from "../PlayerChit";
|
|
5
|
+
import { PlayerInfo } from "../PlayerInfo";
|
|
6
|
+
import { RootChit } from "../RootChit";
|
|
7
|
+
import { connectAiPlayer, AiPlayerHandle } from "../ai/connectAiPlayer";
|
|
8
|
+
import { TutorialSpec } from "./defineTutorial";
|
|
9
|
+
import { TutorialRuntime } from "./TutorialRuntime";
|
|
10
|
+
|
|
11
|
+
let DEMO_COUNTER = 0;
|
|
12
|
+
|
|
13
|
+
export type DemoMatch<P extends PlayerChit, R extends RootChit<P>> = {
|
|
14
|
+
/** Unique per built match (a React key for the viewer) */
|
|
15
|
+
key: string;
|
|
16
|
+
match: Match<P, R>;
|
|
17
|
+
/** The seat the person plays */
|
|
18
|
+
playerId: string;
|
|
19
|
+
players: PlayerInfo[];
|
|
20
|
+
runtime: TutorialRuntime<P, R>;
|
|
21
|
+
bots: AiPlayerHandle[];
|
|
22
|
+
/**
|
|
23
|
+
* Puts the running match back to a saved state in place: the match reruns from it (the same path
|
|
24
|
+
* another tab's moves take in client-trust mode) and connected viewers animate to the new board
|
|
25
|
+
* instead of remounting.
|
|
26
|
+
*/
|
|
27
|
+
replaceState: (state: unknown) => Promise<void>;
|
|
28
|
+
};
|
|
29
|
+
|
|
30
|
+
export type CreateDemoMatchOptions = {
|
|
31
|
+
storage?: IMatchStorage;
|
|
32
|
+
/** Overrides the spec's bot options (think time, logging…) */
|
|
33
|
+
ai?: SeatAiPlayersOptions;
|
|
34
|
+
/** Headless runs: see `Match.immediateNotify` */
|
|
35
|
+
immediateNotify?: boolean;
|
|
36
|
+
/** Name for the human seat when the spec does not list players. Default "You" */
|
|
37
|
+
humanName?: string;
|
|
38
|
+
/** Rebuilding after a rewind: keep this runtime (its queues were rewound by `restoreSnapshot`) */
|
|
39
|
+
runtime?: TutorialRuntime<any, any>;
|
|
40
|
+
/** Rebuilding after a rewind: the saved match state to replay up to */
|
|
41
|
+
state?: unknown;
|
|
42
|
+
};
|
|
43
|
+
|
|
44
|
+
/**
|
|
45
|
+
* Builds the match a demo or a tutorial runs: ephemeral storage, one human seat, a bot in every other
|
|
46
|
+
* seat, the spec's match options and pinned draws, and the bots' forced moves. With no spec this is
|
|
47
|
+
* exactly what the demo did before tutorials existed. The match is loaded and seated but not started.
|
|
48
|
+
*
|
|
49
|
+
* @group Tutorials
|
|
50
|
+
*/
|
|
51
|
+
export async function createDemoMatch<P extends PlayerChit, R extends RootChit<P>>(
|
|
52
|
+
game: Game<P, R>,
|
|
53
|
+
spec?: TutorialSpec<P, R>,
|
|
54
|
+
options: CreateDemoMatchOptions = {},
|
|
55
|
+
): Promise<DemoMatch<P, R>> {
|
|
56
|
+
const tempRoot = new game.chitLibrary.Root() as R;
|
|
57
|
+
const defaultCount = tempRoot.setupDemoGame();
|
|
58
|
+
const matchOptions = spec?.match?.options ?? tempRoot.getCurrentlySelectedMatchOptions();
|
|
59
|
+
|
|
60
|
+
const seats = spec?.match?.players;
|
|
61
|
+
const humanSeat = spec?.match?.humanSeat ?? 0;
|
|
62
|
+
const players: PlayerInfo[] = [];
|
|
63
|
+
if (seats && seats.length > 0) {
|
|
64
|
+
seats.forEach((seat, i) => {
|
|
65
|
+
const info = new PlayerInfo(`p${i}`, seat.name);
|
|
66
|
+
info.imageUrl = seat.imageUrl ?? info.imageUrl;
|
|
67
|
+
info.ai = i === humanSeat ? undefined : (seat.ai ?? {});
|
|
68
|
+
players.push(info);
|
|
69
|
+
});
|
|
70
|
+
} else {
|
|
71
|
+
for (let i = 0; i < defaultCount; i++) {
|
|
72
|
+
const info = new PlayerInfo(`p${i}`, i === humanSeat ? (options.humanName ?? "You") : `Robot ${i}`);
|
|
73
|
+
info.ai = i === humanSeat ? undefined : {};
|
|
74
|
+
players.push(info);
|
|
75
|
+
}
|
|
76
|
+
}
|
|
77
|
+
const playerId = players[Math.min(humanSeat, players.length - 1)].id;
|
|
78
|
+
|
|
79
|
+
const runtime = (options.runtime as TutorialRuntime<P, R> | undefined) ?? new TutorialRuntime<P, R>(spec);
|
|
80
|
+
const storage = options.storage ?? new EphemeralMatchStorage(`demo-${spec?.id ?? "game"}-${Date.now()}`);
|
|
81
|
+
if (options.state !== undefined) {
|
|
82
|
+
await storage.saveState(options.state, [], "active");
|
|
83
|
+
}
|
|
84
|
+
const match = new Match<P, R>(game, players, storage, matchOptions, { rngSource: runtime.rngSource });
|
|
85
|
+
if (options.immediateNotify) {
|
|
86
|
+
match.immediateNotify = true;
|
|
87
|
+
}
|
|
88
|
+
await match.load();
|
|
89
|
+
|
|
90
|
+
const aiOptions: SeatAiPlayersOptions = {
|
|
91
|
+
temperature: 0,
|
|
92
|
+
thinkMs: [500, 900],
|
|
93
|
+
...(spec?.match?.ai ?? {}),
|
|
94
|
+
...(options.ai ?? {}),
|
|
95
|
+
};
|
|
96
|
+
const bots = players
|
|
97
|
+
.filter((p) => p.ai)
|
|
98
|
+
.map((p) =>
|
|
99
|
+
connectAiPlayer(match, p.id, {
|
|
100
|
+
...aiOptions,
|
|
101
|
+
...runtime.aiOptionsFor(p.id),
|
|
102
|
+
difficulty: p.ai?.difficulty,
|
|
103
|
+
}),
|
|
104
|
+
);
|
|
105
|
+
runtime.attachBots(bots);
|
|
106
|
+
|
|
107
|
+
const replaceState = async (state: unknown) => {
|
|
108
|
+
const notifying = storage as IMatchStorage & {
|
|
109
|
+
saveState(s: any, p: any[], m: "active" | "finished", w?: any[], notify?: boolean): Promise<void>;
|
|
110
|
+
};
|
|
111
|
+
await notifying.saveState(JSON.parse(JSON.stringify(state)), [], "active", undefined, true);
|
|
112
|
+
};
|
|
113
|
+
|
|
114
|
+
return { key: `demo-${++DEMO_COUNTER}`, match, playerId, players, runtime, bots, replaceState };
|
|
115
|
+
}
|