@dreamboard-games/cli 0.1.30-alpha.2 → 0.1.30-alpha.20

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 (136) hide show
  1. package/README.md +25 -107
  2. package/dist/agent-verifier/agent-workspace-verifier.mjs +1682 -0
  3. package/dist/agent-verifier/agent-workspace-verifier.mjs.map +1 -0
  4. package/dist/agent-verifier/chunk-4I2WWAPK.mjs +399 -0
  5. package/dist/agent-verifier/chunk-4I2WWAPK.mjs.map +1 -0
  6. package/dist/agent-verifier/chunk-BWBN2TDJ.mjs +2811 -0
  7. package/dist/agent-verifier/chunk-BWBN2TDJ.mjs.map +1 -0
  8. package/dist/agent-verifier/chunk-DQUYBIGQ.mjs +353 -0
  9. package/dist/agent-verifier/chunk-DQUYBIGQ.mjs.map +1 -0
  10. package/dist/agent-verifier/chunk-F2DIOJJZ.mjs +302 -0
  11. package/dist/agent-verifier/chunk-F2DIOJJZ.mjs.map +1 -0
  12. package/dist/agent-verifier/chunk-GCFGAFYC.mjs +720 -0
  13. package/dist/agent-verifier/chunk-GCFGAFYC.mjs.map +1 -0
  14. package/dist/agent-verifier/chunk-GWRZRWCF.mjs +107 -0
  15. package/dist/agent-verifier/chunk-GWRZRWCF.mjs.map +1 -0
  16. package/dist/agent-verifier/chunk-H6XDQJ3N.mjs +11 -0
  17. package/dist/agent-verifier/chunk-HUBV22JQ.mjs +89 -0
  18. package/dist/agent-verifier/chunk-HUBV22JQ.mjs.map +1 -0
  19. package/dist/agent-verifier/chunk-IWB4L2HV.mjs +273 -0
  20. package/dist/agent-verifier/chunk-IWB4L2HV.mjs.map +1 -0
  21. package/dist/agent-verifier/chunk-JZTH3EMV.mjs +14523 -0
  22. package/dist/agent-verifier/chunk-JZTH3EMV.mjs.map +1 -0
  23. package/dist/agent-verifier/chunk-KDAQ4CZY.mjs +192 -0
  24. package/dist/agent-verifier/chunk-KDAQ4CZY.mjs.map +1 -0
  25. package/dist/agent-verifier/chunk-M7UVBANQ.mjs +58 -0
  26. package/dist/agent-verifier/chunk-M7UVBANQ.mjs.map +1 -0
  27. package/dist/agent-verifier/chunk-MYMVXTZT.mjs +766 -0
  28. package/dist/agent-verifier/chunk-MYMVXTZT.mjs.map +1 -0
  29. package/dist/agent-verifier/chunk-OJFZVGEL.mjs +492 -0
  30. package/dist/agent-verifier/chunk-OJFZVGEL.mjs.map +1 -0
  31. package/dist/agent-verifier/chunk-QD4SQNUP.mjs +75 -0
  32. package/dist/agent-verifier/chunk-QD4SQNUP.mjs.map +1 -0
  33. package/dist/agent-verifier/chunk-RDYXWXXC.mjs +47 -0
  34. package/dist/agent-verifier/chunk-RDYXWXXC.mjs.map +1 -0
  35. package/dist/agent-verifier/chunk-TIDX3YLW.mjs +158 -0
  36. package/dist/agent-verifier/chunk-TIDX3YLW.mjs.map +1 -0
  37. package/dist/agent-verifier/chunk-TTB7AIHZ.mjs +214 -0
  38. package/dist/agent-verifier/chunk-TTB7AIHZ.mjs.map +1 -0
  39. package/dist/agent-verifier/chunk-UXGTT25Q.mjs +59 -0
  40. package/dist/agent-verifier/chunk-UXGTT25Q.mjs.map +1 -0
  41. package/dist/agent-verifier/chunk-YE7UAO3T.mjs +129 -0
  42. package/dist/agent-verifier/chunk-YE7UAO3T.mjs.map +1 -0
  43. package/dist/agent-verifier/chunk-ZEELHSY3.mjs +20 -0
  44. package/dist/agent-verifier/chunk-ZEELHSY3.mjs.map +1 -0
  45. package/dist/agent-verifier/global-config-IXZLY4BS.mjs +19 -0
  46. package/dist/agent-verifier/keychain-backend-UF3Z26JM.mjs +140 -0
  47. package/dist/agent-verifier/keychain-backend-UF3Z26JM.mjs.map +1 -0
  48. package/dist/agent-verifier/local-files-OF4QFISU.mjs +45 -0
  49. package/dist/agent-verifier/local-files-OF4QFISU.mjs.map +1 -0
  50. package/dist/agent-verifier/local-typecheck-DHVLM37Z.mjs +150 -0
  51. package/dist/agent-verifier/local-typecheck-DHVLM37Z.mjs.map +1 -0
  52. package/dist/agent-verifier/materialize-workspace-VS5RHSBO.mjs +90 -0
  53. package/dist/agent-verifier/materialize-workspace-VS5RHSBO.mjs.map +1 -0
  54. package/dist/agent-verifier/project-state-XKUSCFSV.mjs +33 -0
  55. package/dist/agent-verifier/project-state-XKUSCFSV.mjs.map +1 -0
  56. package/dist/agent-verifier/prompt-VKHMCQT6.mjs +756 -0
  57. package/dist/agent-verifier/prompt-VKHMCQT6.mjs.map +1 -0
  58. package/dist/agent-verifier/reducer-bundle-preflight-GLUJKTWU.mjs +312 -0
  59. package/dist/agent-verifier/reducer-bundle-preflight-GLUJKTWU.mjs.map +1 -0
  60. package/dist/agent-verifier/reducer-contract-preflight-WVQQPW5F.mjs +46 -0
  61. package/dist/agent-verifier/reducer-contract-preflight-WVQQPW5F.mjs.map +1 -0
  62. package/dist/agent-verifier/reducer-native-test-harness-H6G6RBRY.mjs +3436 -0
  63. package/dist/agent-verifier/reducer-native-test-harness-H6G6RBRY.mjs.map +1 -0
  64. package/dist/agent-verifier/static-scaffold-C36KROJA.mjs +24 -0
  65. package/dist/agent-verifier/static-scaffold-C36KROJA.mjs.map +1 -0
  66. package/dist/agent-verifier/workspace-codegen-SPPVHURX.mjs +10 -0
  67. package/dist/agent-verifier/workspace-codegen-SPPVHURX.mjs.map +1 -0
  68. package/dist/agent-verifier/workspace-dependencies-5HEEKZFP.mjs +17 -0
  69. package/dist/agent-verifier/workspace-dependencies-5HEEKZFP.mjs.map +1 -0
  70. package/dist/authoring-compatibility-internal.js +12 -0
  71. package/dist/authoring-compatibility-internal.js.map +1 -0
  72. package/dist/chunk-2H7UOFLK.js +11 -0
  73. package/dist/chunk-2H7UOFLK.js.map +1 -0
  74. package/dist/chunk-5PJWUB6W.js +4281 -0
  75. package/dist/chunk-5PJWUB6W.js.map +1 -0
  76. package/dist/{chunk-TAQKH67O.js → chunk-EJGB3IR7.js} +2700 -7338
  77. package/dist/chunk-EJGB3IR7.js.map +1 -0
  78. package/dist/chunk-EQNBQVIW.js +204 -0
  79. package/dist/chunk-EQNBQVIW.js.map +1 -0
  80. package/dist/chunk-UI7NWSYA.js +334 -0
  81. package/dist/chunk-UI7NWSYA.js.map +1 -0
  82. package/dist/{global-config-S4ZIPECE.js → global-config-GK2UC2X6.js} +4 -3
  83. package/dist/global-config-GK2UC2X6.js.map +1 -0
  84. package/dist/index.js +3411 -6433
  85. package/dist/index.js.map +1 -1
  86. package/dist/internal.js +15 -9
  87. package/dist/{keychain-backend-HDF4TZDL.js → keychain-backend-GO34KGTG.js} +12 -7
  88. package/dist/keychain-backend-GO34KGTG.js.map +1 -0
  89. package/dist/{prompt-NDV3AE5L.js → prompt-GMZABCJC.js} +2 -2
  90. package/package.json +11 -20
  91. package/release/authoring-release-set.json +38 -0
  92. package/skills/dreamboard/SKILL.md +30 -28
  93. package/skills/dreamboard/references/building-your-first-game.md +15 -15
  94. package/skills/dreamboard/references/cli.md +48 -47
  95. package/skills/dreamboard/references/manifest-authoring.md +11 -3
  96. package/skills/dreamboard/references/quickstart.md +16 -13
  97. package/skills/dreamboard/references/testing.md +10 -10
  98. package/dist/chunk-N7XPNNUI.js +0 -432
  99. package/dist/chunk-N7XPNNUI.js.map +0 -1
  100. package/dist/chunk-SEGVTWSK.js +0 -44
  101. package/dist/chunk-TAQKH67O.js.map +0 -1
  102. package/dist/dev-host/components/drawer.tsx +0 -132
  103. package/dist/dev-host/components/input.tsx +0 -21
  104. package/dist/dev-host/dev-api-proxy-plugin.ts +0 -328
  105. package/dist/dev-host/dev-author-dom-warnings.ts +0 -100
  106. package/dist/dev-host/dev-diagnostics.ts +0 -62
  107. package/dist/dev-host/dev-fallback-stylesheet.ts +0 -53
  108. package/dist/dev-host/dev-hmr-guard-plugin.ts +0 -47
  109. package/dist/dev-host/dev-host-controller.ts +0 -674
  110. package/dist/dev-host/dev-host-player-query.ts +0 -17
  111. package/dist/dev-host/dev-host-session-transport.ts +0 -52
  112. package/dist/dev-host/dev-host-storage.ts +0 -56
  113. package/dist/dev-host/dev-log-relay-plugin.ts +0 -510
  114. package/dist/dev-host/dev-runtime-config.ts +0 -14
  115. package/dist/dev-host/dev-runtime-platform.ts +0 -335
  116. package/dist/dev-host/dev-virtual-modules-plugin.ts +0 -64
  117. package/dist/dev-host/host-main.css +0 -224
  118. package/dist/dev-host/host-main.tsx +0 -948
  119. package/dist/dev-host/index.html +0 -56
  120. package/dist/dev-host/lib/utils.ts +0 -6
  121. package/dist/dev-host/plugin-main.ts +0 -61
  122. package/dist/dev-host/plugin.html +0 -24
  123. package/dist/dev-host/shared-styles.css +0 -144
  124. package/dist/dev-host/start-dev-server.ts +0 -140
  125. package/dist/dev-host/virtual-modules.d.ts +0 -27
  126. package/dist/keychain-backend-HDF4TZDL.js.map +0 -1
  127. package/skills/dreamboard/scripts/events-extract.mjs +0 -218
  128. /package/dist/{chunk-SEGVTWSK.js.map → agent-verifier/chunk-H6XDQJ3N.mjs.map} +0 -0
  129. /package/dist/{global-config-S4ZIPECE.js.map → agent-verifier/global-config-IXZLY4BS.mjs.map} +0 -0
  130. /package/dist/{prompt-NDV3AE5L.js.map → prompt-GMZABCJC.js.map} +0 -0
  131. /package/{dist/scaffold → scaffold}/assets/static/app/tsconfig.framework.json +0 -0
  132. /package/{dist/scaffold → scaffold}/assets/static/app/tsconfig.json +0 -0
  133. /package/{dist/scaffold → scaffold}/assets/static/ui/index.tsx +0 -0
  134. /package/{dist/scaffold → scaffold}/assets/static/ui/style.css +0 -0
  135. /package/{dist/scaffold → scaffold}/assets/static/ui/tsconfig.framework.json +0 -0
  136. /package/{dist/scaffold → scaffold}/assets/static/ui/tsconfig.json +0 -0
@@ -0,0 +1,302 @@
1
+ #!/usr/bin/env node
2
+
3
+ // src/templates/testing-types-content.ts
4
+ var DEFAULT_REJECTION_CODES = [
5
+ "NOT_YOUR_TURN",
6
+ "action-unavailable",
7
+ "invalid-action-params",
8
+ "prompt-not-owned"
9
+ ];
10
+ function renderLiteralUnion(values) {
11
+ if (values.length === 0) {
12
+ return "never";
13
+ }
14
+ return values.map((value) => JSON.stringify(value)).join(" | ");
15
+ }
16
+ var REDUCER_TESTING_TYPES_WRAPPER_CONTENT = `// Generated by dreamboard \u2014 do not edit by hand.
17
+ import game from "../app/game";
18
+ import {
19
+ contractFingerprint,
20
+ createReducerBundle,
21
+ } from "@dreamboard-games/sdk/reducer";
22
+ import { createTestRuntime as createDreamboardTestRuntime } from "@dreamboard-games/sdk/testing";
23
+ import type { CreateTestRuntimeOptions } from "@dreamboard-games/sdk/testing";
24
+ import { literals } from "../shared/manifest-contract";
25
+ import type { PhaseName } from "../shared/generated/ui-contract";
26
+ import {
27
+ BASE_STATES,
28
+ BASE_STATES_CONTRACT_FINGERPRINT,
29
+ } from "./generated/base-states.generated";
30
+ import type {
31
+ BaseDefinition,
32
+ ScenarioDefinition,
33
+ TestRunner,
34
+ } from "./generated/testing-contract";
35
+
36
+ export * from "./generated/testing-contract";
37
+
38
+ /**
39
+ * Workspace-narrowed \`defineBase\` wrapper. Accepts the generated
40
+ * \`BaseDefinition\` so \`setup({ seat, game })\` is typed against the
41
+ * workspace's player ids and interaction contract.
42
+ */
43
+ export function defineBase<const Definition extends BaseDefinition>(
44
+ definition: Definition,
45
+ ): Definition {
46
+ return definition;
47
+ }
48
+
49
+ /**
50
+ * Workspace-narrowed \`defineScenario\` wrapper. The generated
51
+ * \`ScenarioDefinition\` narrows \`ctx.view(playerId)\` in \`then\` based on
52
+ * the declared \`phase\`, keeps \`when\` union-typed, and constrains
53
+ * \`phase\` / \`stage\` to the manifest-derived literal types.
54
+ */
55
+ export function defineScenario<
56
+ const Runners extends readonly TestRunner[] = readonly ["reducer"],
57
+ const Phase extends PhaseName | undefined = undefined,
58
+ >(
59
+ definition: ScenarioDefinition<Runners, Phase>,
60
+ ): ScenarioDefinition<Runners, Phase> {
61
+ return definition;
62
+ }
63
+
64
+ export function createTestRuntime(options: {
65
+ baseId: keyof typeof BASE_STATES & string;
66
+ phase?: PhaseName;
67
+ controllingPlayerId?: (typeof literals.playerIds)[number];
68
+ userId?: string | null;
69
+ }) {
70
+ const reducerBundle =
71
+ createReducerBundle(game) satisfies CreateTestRuntimeOptions["bundle"];
72
+ const baseStates =
73
+ BASE_STATES satisfies CreateTestRuntimeOptions["baseStates"];
74
+ const runtime = createDreamboardTestRuntime({
75
+ baseId: options.baseId,
76
+ baseStates,
77
+ bundle: reducerBundle,
78
+ contractFingerprint: contractFingerprint(game).value,
79
+ expectedBaseStateFingerprint: BASE_STATES_CONTRACT_FINGERPRINT,
80
+ phase: options.phase,
81
+ userId: options.userId ?? "test-user",
82
+ playerIds: literals.playerIds.slice(
83
+ 0,
84
+ BASE_STATES[options.baseId]?.fingerprint.players ?? literals.playerIds.length,
85
+ ),
86
+ });
87
+
88
+ if (options.controllingPlayerId) {
89
+ runtime.setControllingPlayer(options.controllingPlayerId);
90
+ }
91
+
92
+ return runtime;
93
+ }
94
+ `;
95
+ function buildReducerTestingContractContent(options = {}) {
96
+ const rejectionCodes = Array.from(
97
+ /* @__PURE__ */ new Set([...options.rejectionCodes ?? [], ...DEFAULT_REJECTION_CODES])
98
+ ).sort((left, right) => left.localeCompare(right));
99
+ return `// Generated by dreamboard \u2014 do not edit by hand.
100
+ import type game from "../../app/game";
101
+ import { literals, type SetupProfileId } from "../../shared/manifest-contract";
102
+ import {
103
+ type GameView,
104
+ type InteractionId,
105
+ type InteractionKey,
106
+ type InteractionParamsOf,
107
+ type PhaseName,
108
+ type StageName as WorkspaceStageName,
109
+ } from "../../shared/generated/ui-contract";
110
+ import type {
111
+ ExpectFn as SharedExpectFn,
112
+ TestRunner as SharedTestRunner,
113
+ } from "@dreamboard-games/sdk/testing";
114
+ import type { InteractionDescriptor } from "@dreamboard-games/sdk/runtime";
115
+ import { BASE_STATES } from "./base-states.generated";
116
+
117
+ export type GameDefinition = typeof game;
118
+ export type PlayerId = (typeof literals.playerIds)[number];
119
+ export type StateName = PhaseName;
120
+ export type BaseId = keyof typeof BASE_STATES & string;
121
+ export type InteractionDescriptorFor<Id extends string = string> =
122
+ InteractionDescriptor<Id>;
123
+ export type InteractionExplanation = {
124
+ interactionId: string;
125
+ phase: string;
126
+ step: string | null;
127
+ availability:
128
+ | "available"
129
+ | "notYourTurn"
130
+ | "wrongPhase"
131
+ | "wrongStep"
132
+ | "blocked";
133
+ rules: ReadonlyArray<{
134
+ ruleId: string;
135
+ outcome: "passed" | "failed" | "notEvaluated";
136
+ errorCode?: string;
137
+ message?: string;
138
+ }>;
139
+ actor: { required: readonly string[]; playerIsActor: boolean };
140
+ inputs: ReadonlyArray<{
141
+ key: string;
142
+ kind: string;
143
+ eligibleCount: number | "lazy";
144
+ }>;
145
+ };
146
+ export type TestRunner = SharedTestRunner;
147
+ export type ExpectFn = SharedExpectFn;
148
+ export type KnownRejectionCode = ${renderLiteralUnion(rejectionCodes)};
149
+ export type RejectionCode = [KnownRejectionCode] extends [never]
150
+ ? string
151
+ : KnownRejectionCode;
152
+
153
+ type DefaultRunners = readonly ["reducer"];
154
+ type PhaseTaggedView<Phase extends PhaseName> = Extract<
155
+ GameView,
156
+ { phase: Phase } | { currentPhase: Phase } | { state: Phase }
157
+ >;
158
+ type NarrowedView<Phase extends PhaseName> = [PhaseTaggedView<Phase>] extends [never]
159
+ ? GameView
160
+ : PhaseTaggedView<Phase>;
161
+
162
+ export type ViewByPhase = {
163
+ [Phase in PhaseName]: NarrowedView<Phase>;
164
+ };
165
+
166
+ type InteractionKeyForId<Id extends InteractionId> = Extract<
167
+ InteractionKey,
168
+ \`\${string}.\${Id}\`
169
+ >;
170
+ type InteractionParamsForKey<Key extends InteractionKey> =
171
+ Key extends InteractionKey ? InteractionParamsOf<Key> : never;
172
+ type InteractionParamsOfId<Id extends InteractionId> =
173
+ InteractionParamsForKey<InteractionKeyForId<Id>>;
174
+
175
+ export interface BrowserRunnerSnapshot {
176
+ sessionId: string | null;
177
+ shortCode: string | null;
178
+ version: number;
179
+ currentPhase: string | null;
180
+ controllingPlayerId: string;
181
+ controllablePlayerIds: string[];
182
+ view: unknown;
183
+ availableInteractions?: string[];
184
+ }
185
+
186
+ export interface BrowserRunnerBridge {
187
+ snapshot(): Promise<BrowserRunnerSnapshot>;
188
+ submitInteraction(
189
+ playerId: PlayerId,
190
+ interactionId: string,
191
+ params: unknown,
192
+ ): Promise<void>;
193
+ }
194
+
195
+ export interface BrowserRunnerDriver {
196
+ onReady?(bridge: BrowserRunnerBridge): Promise<void> | void;
197
+ interaction?(
198
+ bridge: BrowserRunnerBridge,
199
+ input: { playerId: PlayerId; interactionId: string; params: unknown },
200
+ ): Promise<boolean | void> | boolean | void;
201
+ }
202
+
203
+ export interface ScenarioGameApi {
204
+ start(): Promise<void>;
205
+ /**
206
+ * Patch the reducer snapshot for deterministic setup-heavy scenarios.
207
+ * This is limited to reducer snapshot materialization and is rejected by
208
+ * live replay/browser runners so authored gameplay verification still
209
+ * submits real interactions.
210
+ */
211
+ patchState(mutator: (state: Record<string, unknown>) => void): Promise<void>;
212
+ /**
213
+ * Submit a player interaction (action-kind or prompt-kind) to the game.
214
+ * The \`interactionId\` matches an \`InteractionId\` from the generated
215
+ * \`ui-contract\`; \`params\` is typed per interaction id.
216
+ */
217
+ submit<Id extends InteractionId>(
218
+ playerId: PlayerId,
219
+ interactionId: Id,
220
+ params?: InteractionParamsOfId<Id>,
221
+ ): Promise<void>;
222
+ }
223
+
224
+ export interface BaseContext {
225
+ game: ScenarioGameApi;
226
+ players(): readonly PlayerId[];
227
+ /**
228
+ * Resolve the seat at \`index\` in the base's players list.
229
+ * Throws if the index is out of range. Prefer \`seat(0)\`/\`seat(1)\` over
230
+ * literal player ids so bases stay portable across player counts and
231
+ * we never hard-code wire-shape assumptions like "player-1".
232
+ */
233
+ seat(index: number): PlayerId;
234
+ }
235
+
236
+ export interface SharedScenarioContext {
237
+ game: ScenarioGameApi;
238
+ players(): readonly PlayerId[];
239
+ /**
240
+ * Resolve the seat at \`index\` in the current scenario's players list.
241
+ * Throws if the index is out of range. Prefer \`seat(0)\`/\`seat(1)\` over
242
+ * literal player ids so scenarios stay portable across player counts and
243
+ * we never hard-code wire-shape assumptions like "player-1".
244
+ */
245
+ seat(index: number): PlayerId;
246
+ state(): StateName;
247
+ view(playerId: PlayerId): GameView;
248
+ interactions(playerId: PlayerId): readonly InteractionDescriptorFor[];
249
+ explain(playerId: PlayerId, interactionId: InteractionId): InteractionExplanation;
250
+ expect: ExpectFn;
251
+ }
252
+
253
+ export type ScenarioContext<
254
+ Phase extends PhaseName | undefined = undefined,
255
+ > = Omit<SharedScenarioContext, "state" | "view"> & {
256
+ state(): Phase extends PhaseName ? Phase : StateName;
257
+ view(playerId: PlayerId): Phase extends PhaseName ? ViewByPhase[Phase] : GameView;
258
+ };
259
+
260
+ export type ScenarioThenContext<
261
+ _Runners extends readonly TestRunner[] = DefaultRunners,
262
+ Phase extends PhaseName | undefined = undefined,
263
+ > = ScenarioContext<Phase>;
264
+
265
+ export interface BaseDefinition {
266
+ id: string;
267
+ seed?: number;
268
+ players?: number;
269
+ setupProfileId?: SetupProfileId;
270
+ extends?: BaseId | string;
271
+ setup: (ctx: BaseContext) => void | Promise<void>;
272
+ }
273
+
274
+ export interface ScenarioDefinition<
275
+ Runners extends readonly TestRunner[] = DefaultRunners,
276
+ Phase extends PhaseName | undefined = undefined,
277
+ > {
278
+ id: string;
279
+ description?: string;
280
+ from: BaseId | string;
281
+ runners?: Runners;
282
+ phase?: Phase;
283
+ stage?: Phase extends PhaseName ? WorkspaceStageName<Phase> : never;
284
+ when: (ctx: ScenarioContext<Phase>) => void | Promise<void>;
285
+ then: (ctx: ScenarioThenContext<Runners, Phase>) => void | Promise<void>;
286
+ }
287
+
288
+ export type {
289
+ GameView,
290
+ InteractionId,
291
+ InteractionParamsOf,
292
+ PhaseName,
293
+ WorkspaceStageName,
294
+ };
295
+ `;
296
+ }
297
+
298
+ export {
299
+ REDUCER_TESTING_TYPES_WRAPPER_CONTENT,
300
+ buildReducerTestingContractContent
301
+ };
302
+ //# sourceMappingURL=chunk-F2DIOJJZ.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/templates/testing-types-content.ts"],"sourcesContent":["const DEFAULT_REJECTION_CODES = [\n \"NOT_YOUR_TURN\",\n \"action-unavailable\",\n \"invalid-action-params\",\n \"prompt-not-owned\",\n] as const;\n\nfunction renderLiteralUnion(values: readonly string[]): string {\n if (values.length === 0) {\n return \"never\";\n }\n return values.map((value) => JSON.stringify(value)).join(\" | \");\n}\n\nexport const REDUCER_TESTING_TYPES_WRAPPER_CONTENT = `\\\n// Generated by dreamboard — do not edit by hand.\nimport game from \"../app/game\";\nimport {\n contractFingerprint,\n createReducerBundle,\n} from \"@dreamboard-games/sdk/reducer\";\nimport { createTestRuntime as createDreamboardTestRuntime } from \"@dreamboard-games/sdk/testing\";\nimport type { CreateTestRuntimeOptions } from \"@dreamboard-games/sdk/testing\";\nimport { literals } from \"../shared/manifest-contract\";\nimport type { PhaseName } from \"../shared/generated/ui-contract\";\nimport {\n BASE_STATES,\n BASE_STATES_CONTRACT_FINGERPRINT,\n} from \"./generated/base-states.generated\";\nimport type {\n BaseDefinition,\n ScenarioDefinition,\n TestRunner,\n} from \"./generated/testing-contract\";\n\nexport * from \"./generated/testing-contract\";\n\n/**\n * Workspace-narrowed \\`defineBase\\` wrapper. Accepts the generated\n * \\`BaseDefinition\\` so \\`setup({ seat, game })\\` is typed against the\n * workspace's player ids and interaction contract.\n */\nexport function defineBase<const Definition extends BaseDefinition>(\n definition: Definition,\n): Definition {\n return definition;\n}\n\n/**\n * Workspace-narrowed \\`defineScenario\\` wrapper. The generated\n * \\`ScenarioDefinition\\` narrows \\`ctx.view(playerId)\\` in \\`then\\` based on\n * the declared \\`phase\\`, keeps \\`when\\` union-typed, and constrains\n * \\`phase\\` / \\`stage\\` to the manifest-derived literal types.\n */\nexport function defineScenario<\n const Runners extends readonly TestRunner[] = readonly [\"reducer\"],\n const Phase extends PhaseName | undefined = undefined,\n>(\n definition: ScenarioDefinition<Runners, Phase>,\n): ScenarioDefinition<Runners, Phase> {\n return definition;\n}\n\nexport function createTestRuntime(options: {\n baseId: keyof typeof BASE_STATES & string;\n phase?: PhaseName;\n controllingPlayerId?: (typeof literals.playerIds)[number];\n userId?: string | null;\n}) {\n const reducerBundle =\n createReducerBundle(game) satisfies CreateTestRuntimeOptions[\"bundle\"];\n const baseStates =\n BASE_STATES satisfies CreateTestRuntimeOptions[\"baseStates\"];\n const runtime = createDreamboardTestRuntime({\n baseId: options.baseId,\n baseStates,\n bundle: reducerBundle,\n contractFingerprint: contractFingerprint(game).value,\n expectedBaseStateFingerprint: BASE_STATES_CONTRACT_FINGERPRINT,\n phase: options.phase,\n userId: options.userId ?? \"test-user\",\n playerIds: literals.playerIds.slice(\n 0,\n BASE_STATES[options.baseId]?.fingerprint.players ?? literals.playerIds.length,\n ),\n });\n\n if (options.controllingPlayerId) {\n runtime.setControllingPlayer(options.controllingPlayerId);\n }\n\n return runtime;\n}\n`;\n\nexport function buildReducerTestingContractContent(\n options: {\n rejectionCodes?: readonly string[];\n } = {},\n): string {\n const rejectionCodes = Array.from(\n new Set([...(options.rejectionCodes ?? []), ...DEFAULT_REJECTION_CODES]),\n ).sort((left, right) => left.localeCompare(right));\n\n return `\\\n// Generated by dreamboard — do not edit by hand.\nimport type game from \"../../app/game\";\nimport { literals, type SetupProfileId } from \"../../shared/manifest-contract\";\nimport {\n type GameView,\n type InteractionId,\n type InteractionKey,\n type InteractionParamsOf,\n type PhaseName,\n type StageName as WorkspaceStageName,\n} from \"../../shared/generated/ui-contract\";\nimport type {\n ExpectFn as SharedExpectFn,\n TestRunner as SharedTestRunner,\n} from \"@dreamboard-games/sdk/testing\";\nimport type { InteractionDescriptor } from \"@dreamboard-games/sdk/runtime\";\nimport { BASE_STATES } from \"./base-states.generated\";\n\nexport type GameDefinition = typeof game;\nexport type PlayerId = (typeof literals.playerIds)[number];\nexport type StateName = PhaseName;\nexport type BaseId = keyof typeof BASE_STATES & string;\nexport type InteractionDescriptorFor<Id extends string = string> =\n InteractionDescriptor<Id>;\nexport type InteractionExplanation = {\n interactionId: string;\n phase: string;\n step: string | null;\n availability:\n | \"available\"\n | \"notYourTurn\"\n | \"wrongPhase\"\n | \"wrongStep\"\n | \"blocked\";\n rules: ReadonlyArray<{\n ruleId: string;\n outcome: \"passed\" | \"failed\" | \"notEvaluated\";\n errorCode?: string;\n message?: string;\n }>;\n actor: { required: readonly string[]; playerIsActor: boolean };\n inputs: ReadonlyArray<{\n key: string;\n kind: string;\n eligibleCount: number | \"lazy\";\n }>;\n};\nexport type TestRunner = SharedTestRunner;\nexport type ExpectFn = SharedExpectFn;\nexport type KnownRejectionCode = ${renderLiteralUnion(rejectionCodes)};\nexport type RejectionCode = [KnownRejectionCode] extends [never]\n ? string\n : KnownRejectionCode;\n\ntype DefaultRunners = readonly [\"reducer\"];\ntype PhaseTaggedView<Phase extends PhaseName> = Extract<\n GameView,\n { phase: Phase } | { currentPhase: Phase } | { state: Phase }\n>;\ntype NarrowedView<Phase extends PhaseName> = [PhaseTaggedView<Phase>] extends [never]\n ? GameView\n : PhaseTaggedView<Phase>;\n\nexport type ViewByPhase = {\n [Phase in PhaseName]: NarrowedView<Phase>;\n};\n\ntype InteractionKeyForId<Id extends InteractionId> = Extract<\n InteractionKey,\n \\`\\${string}.\\${Id}\\`\n>;\ntype InteractionParamsForKey<Key extends InteractionKey> =\n Key extends InteractionKey ? InteractionParamsOf<Key> : never;\ntype InteractionParamsOfId<Id extends InteractionId> =\n InteractionParamsForKey<InteractionKeyForId<Id>>;\n\nexport interface BrowserRunnerSnapshot {\n sessionId: string | null;\n shortCode: string | null;\n version: number;\n currentPhase: string | null;\n controllingPlayerId: string;\n controllablePlayerIds: string[];\n view: unknown;\n availableInteractions?: string[];\n}\n\nexport interface BrowserRunnerBridge {\n snapshot(): Promise<BrowserRunnerSnapshot>;\n submitInteraction(\n playerId: PlayerId,\n interactionId: string,\n params: unknown,\n ): Promise<void>;\n}\n\nexport interface BrowserRunnerDriver {\n onReady?(bridge: BrowserRunnerBridge): Promise<void> | void;\n interaction?(\n bridge: BrowserRunnerBridge,\n input: { playerId: PlayerId; interactionId: string; params: unknown },\n ): Promise<boolean | void> | boolean | void;\n}\n\nexport interface ScenarioGameApi {\n start(): Promise<void>;\n /**\n * Patch the reducer snapshot for deterministic setup-heavy scenarios.\n * This is limited to reducer snapshot materialization and is rejected by\n * live replay/browser runners so authored gameplay verification still\n * submits real interactions.\n */\n patchState(mutator: (state: Record<string, unknown>) => void): Promise<void>;\n /**\n * Submit a player interaction (action-kind or prompt-kind) to the game.\n * The \\`interactionId\\` matches an \\`InteractionId\\` from the generated\n * \\`ui-contract\\`; \\`params\\` is typed per interaction id.\n */\n submit<Id extends InteractionId>(\n playerId: PlayerId,\n interactionId: Id,\n params?: InteractionParamsOfId<Id>,\n ): Promise<void>;\n}\n\nexport interface BaseContext {\n game: ScenarioGameApi;\n players(): readonly PlayerId[];\n /**\n * Resolve the seat at \\`index\\` in the base's players list.\n * Throws if the index is out of range. Prefer \\`seat(0)\\`/\\`seat(1)\\` over\n * literal player ids so bases stay portable across player counts and\n * we never hard-code wire-shape assumptions like \"player-1\".\n */\n seat(index: number): PlayerId;\n}\n\nexport interface SharedScenarioContext {\n game: ScenarioGameApi;\n players(): readonly PlayerId[];\n /**\n * Resolve the seat at \\`index\\` in the current scenario's players list.\n * Throws if the index is out of range. Prefer \\`seat(0)\\`/\\`seat(1)\\` over\n * literal player ids so scenarios stay portable across player counts and\n * we never hard-code wire-shape assumptions like \"player-1\".\n */\n seat(index: number): PlayerId;\n state(): StateName;\n view(playerId: PlayerId): GameView;\n interactions(playerId: PlayerId): readonly InteractionDescriptorFor[];\n explain(playerId: PlayerId, interactionId: InteractionId): InteractionExplanation;\n expect: ExpectFn;\n}\n\nexport type ScenarioContext<\n Phase extends PhaseName | undefined = undefined,\n> = Omit<SharedScenarioContext, \"state\" | \"view\"> & {\n state(): Phase extends PhaseName ? Phase : StateName;\n view(playerId: PlayerId): Phase extends PhaseName ? ViewByPhase[Phase] : GameView;\n};\n\nexport type ScenarioThenContext<\n _Runners extends readonly TestRunner[] = DefaultRunners,\n Phase extends PhaseName | undefined = undefined,\n> = ScenarioContext<Phase>;\n\nexport interface BaseDefinition {\n id: string;\n seed?: number;\n players?: number;\n setupProfileId?: SetupProfileId;\n extends?: BaseId | string;\n setup: (ctx: BaseContext) => void | Promise<void>;\n}\n\nexport interface ScenarioDefinition<\n Runners extends readonly TestRunner[] = DefaultRunners,\n Phase extends PhaseName | undefined = undefined,\n> {\n id: string;\n description?: string;\n from: BaseId | string;\n runners?: Runners;\n phase?: Phase;\n stage?: Phase extends PhaseName ? WorkspaceStageName<Phase> : never;\n when: (ctx: ScenarioContext<Phase>) => void | Promise<void>;\n then: (ctx: ScenarioThenContext<Runners, Phase>) => void | Promise<void>;\n}\n\nexport type {\n GameView,\n InteractionId,\n InteractionParamsOf,\n PhaseName,\n WorkspaceStageName,\n};\n`;\n}\n"],"mappings":";;;AAAA,IAAM,0BAA0B;AAAA,EAC9B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEA,SAAS,mBAAmB,QAAmC;AAC7D,MAAI,OAAO,WAAW,GAAG;AACvB,WAAO;AAAA,EACT;AACA,SAAO,OAAO,IAAI,CAAC,UAAU,KAAK,UAAU,KAAK,CAAC,EAAE,KAAK,KAAK;AAChE;AAEO,IAAM,wCAAwC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAiF9C,SAAS,mCACd,UAEI,CAAC,GACG;AACR,QAAM,iBAAiB,MAAM;AAAA,IAC3B,oBAAI,IAAI,CAAC,GAAI,QAAQ,kBAAkB,CAAC,GAAI,GAAG,uBAAuB,CAAC;AAAA,EACzE,EAAE,KAAK,CAAC,MAAM,UAAU,KAAK,cAAc,KAAK,CAAC;AAEjD,SAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mCAkD0B,mBAAmB,cAAc,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAoJrE;","names":[]}