@seriousgaming/sdk-tools 1.5.0 → 1.6.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 (160) hide show
  1. package/dist/bundling/ui-bundler.d.ts +12 -0
  2. package/dist/cli-25RWY5BQ.js +41 -0
  3. package/dist/cli-272KBNJH.js +97 -0
  4. package/dist/cli-2BH7FX27.js +52 -0
  5. package/dist/cli-2GOFEW26.js +81 -0
  6. package/dist/cli-3E3MD5U4.js +21 -0
  7. package/dist/cli-3HE4AVZG.js +115 -0
  8. package/dist/cli-4AKVLEC4.js +1387 -0
  9. package/dist/cli-4BV45LBH.js +126 -0
  10. package/dist/cli-4LKXZQ2B.js +48 -0
  11. package/dist/cli-4UWFQNGF.js +54 -0
  12. package/dist/cli-4YB3ROVR.js +78 -0
  13. package/dist/cli-57RXC3HQ.js +36 -0
  14. package/dist/cli-5JEGTVTG.js +96 -0
  15. package/dist/cli-6AMT3BUO.js +97 -0
  16. package/dist/cli-6RRVEGFB.js +80 -0
  17. package/dist/cli-6WXLXJVX.js +36 -0
  18. package/dist/cli-7OGYADZ3.js +97 -0
  19. package/dist/cli-AK7OIPWY.js +229 -0
  20. package/dist/cli-B4TN6PJP.js +124 -0
  21. package/dist/cli-B6YHEKIJ.js +248 -0
  22. package/dist/cli-BPYMTOUL.js +89 -0
  23. package/dist/cli-BWX5E7TQ.js +23 -0
  24. package/dist/cli-BYJWFFCF.js +37 -0
  25. package/dist/cli-C3NVCKO6.js +43 -0
  26. package/dist/cli-C47GJATR.js +42 -0
  27. package/dist/cli-C5QOJJWX.js +46 -0
  28. package/dist/cli-C6TH5S7K.js +6417 -0
  29. package/dist/cli-DL2CVMRF.js +89 -0
  30. package/dist/cli-DMW2OQIJ.js +76 -0
  31. package/dist/cli-DZW3XD5F.js +143 -0
  32. package/dist/cli-E2NLWIFE.js +1331 -0
  33. package/dist/cli-E33CJRRQ.js +36 -0
  34. package/dist/cli-E6DJIMYD.js +142 -0
  35. package/dist/cli-EEFJKIGL.js +151 -0
  36. package/dist/cli-EVFS55WN.js +185 -0
  37. package/dist/cli-F2D4GGUA.js +549 -0
  38. package/dist/cli-FBTRTIZJ.js +226 -0
  39. package/dist/cli-FWFRKQNE.js +11 -0
  40. package/dist/cli-FYINNRML.js +760 -0
  41. package/dist/cli-G522CPRL.js +88 -0
  42. package/dist/cli-G6KELFSX.js +2847 -0
  43. package/dist/cli-G6UE5NL4.js +90 -0
  44. package/dist/cli-GBFM76BF.js +16 -0
  45. package/dist/cli-GDQ6ILJY.js +101 -0
  46. package/dist/cli-GFBGYFYD.js +50 -0
  47. package/dist/cli-GGPDQNM3.js +35 -0
  48. package/dist/cli-GTSGLN3Z.js +307 -0
  49. package/dist/cli-GUXKQMJ7.js +13641 -0
  50. package/dist/cli-GXD36NF2.js +60 -0
  51. package/dist/cli-HCRTYQQS.js +16 -0
  52. package/dist/cli-HYY64SUD.js +185 -0
  53. package/dist/cli-I355WTAF.js +463 -0
  54. package/dist/cli-IDKYF5XB.js +59 -0
  55. package/dist/cli-ILKCQNM6.js +8 -0
  56. package/dist/cli-IRZ5KB7D.js +36 -0
  57. package/dist/cli-IUS2YCD3.js +31 -0
  58. package/dist/cli-J4DKUUTK.js +138 -0
  59. package/dist/cli-JFU22EJ2.js +187 -0
  60. package/dist/cli-JMZLT65J.js +226 -0
  61. package/dist/cli-JZM7XTNV.js +89 -0
  62. package/dist/cli-K2B6WHKA.js +81 -0
  63. package/dist/cli-KL3756X6.js +126 -0
  64. package/dist/cli-KNOOKGYW.js +88 -0
  65. package/dist/cli-LFGRFIEO.js +226 -0
  66. package/dist/cli-LFM7GJHI.js +0 -0
  67. package/dist/cli-LMDJCHHD.js +304 -0
  68. package/dist/cli-LXYPE3L5.js +99 -0
  69. package/dist/cli-M6BCQRID.js +153 -0
  70. package/dist/cli-MBNMPVDC.js +367 -0
  71. package/dist/cli-MJUYJIEP.js +13 -0
  72. package/dist/cli-MMN4BPO4.js +145 -0
  73. package/dist/cli-MYJGMA6U.js +40 -0
  74. package/dist/cli-N6H6T2E2.js +616 -0
  75. package/dist/cli-O5KP4OVN.js +61 -0
  76. package/dist/cli-O6PWMJTZ.js +25 -0
  77. package/dist/cli-ORIG557O.js +141 -0
  78. package/dist/cli-PFFCNGHI.js +243 -0
  79. package/dist/cli-PNLYX6R6.js +131 -0
  80. package/dist/cli-PQBXVLEU.js +649 -0
  81. package/dist/cli-PTT5RGKO.js +62 -0
  82. package/dist/cli-Q2XJF5AS.js +127 -0
  83. package/dist/cli-QEVDDBNO.js +60 -0
  84. package/dist/cli-QEVE5HUM.js +167 -0
  85. package/dist/cli-QUIJCBYB.js +391 -0
  86. package/dist/cli-QUNIRH7A.js +57 -0
  87. package/dist/cli-QVASWX2A.js +187 -0
  88. package/dist/cli-QWQMPCL6.js +253 -0
  89. package/dist/cli-R4PCG5YX.js +131 -0
  90. package/dist/cli-RA673NGF.js +53 -0
  91. package/dist/cli-RN6IWTL2.js +36 -0
  92. package/dist/cli-ROT3DRKU.js +145 -0
  93. package/dist/cli-RZITKPJX.js +367 -0
  94. package/dist/cli-S5IVGDDD.js +32 -0
  95. package/dist/cli-S5QDONIQ.js +218 -0
  96. package/dist/cli-SIPDUBFL.js +36 -0
  97. package/dist/cli-SMFSZF2G.js +4009 -0
  98. package/dist/cli-SRHBXZCN.js +159 -0
  99. package/dist/cli-TCY5LJ7E.js +88 -0
  100. package/dist/cli-TDSQSCX4.js +131 -0
  101. package/dist/cli-TIDQ4WUE.js +257 -0
  102. package/dist/cli-TLLA6KAP.js +79 -0
  103. package/dist/cli-TPU4TUR6.js +132 -0
  104. package/dist/cli-U2UE7I7J.js +30 -0
  105. package/dist/cli-UELGBQG7.js +101 -0
  106. package/dist/cli-UHSZBKYO.js +97 -0
  107. package/dist/cli-UJ4UCL2Z.js +38 -0
  108. package/dist/cli-UKQYZYFK.js +31 -0
  109. package/dist/cli-UMFFURZ7.js +81 -0
  110. package/dist/cli-UNAJ2OTE.js +15 -0
  111. package/dist/cli-UNJ5X6BU.js +89 -0
  112. package/dist/cli-UTJU4IYG.js +117 -0
  113. package/dist/cli-V4GHRWOV.js +1837 -0
  114. package/dist/cli-VCI3CG36.js +73 -0
  115. package/dist/cli-VCKOC2EV.js +256 -0
  116. package/dist/cli-VL2P354N.js +46 -0
  117. package/dist/cli-WAE26SVW.js +72 -0
  118. package/dist/cli-WOGIAU2E.js +100 -0
  119. package/dist/cli-WU43JT4T.js +52 -0
  120. package/dist/cli-XCO2VQOH.js +122 -0
  121. package/dist/cli-XSVGKI3R.js +39 -0
  122. package/dist/cli-YOTGR3NB.js +82 -0
  123. package/dist/cli-YVVXUD2G.js +197 -0
  124. package/dist/cli-ZISJ36MM.js +89 -0
  125. package/dist/cli-ZTWOE3ZT.js +65 -0
  126. package/dist/cli-ZVSFYDPQ.js +205 -0
  127. package/dist/cli-ZWPYIXNI.js +68 -0
  128. package/dist/cli.js +148 -43093
  129. package/dist/client/build-surfaces.d.ts +33 -0
  130. package/dist/client/dev-server.d.ts +6 -0
  131. package/dist/client/index.d.ts +1 -0
  132. package/dist/client/playwright.d.ts +62 -0
  133. package/dist/client.js +228 -48
  134. package/dist/core/session.d.ts +15 -1
  135. package/dist/dev/console/assets/{index-BVF8exas.js → index-CuMOOH9m.js} +1 -1
  136. package/dist/dev/console/index.html +1 -1
  137. package/dist/dev/shell.d.ts +19 -0
  138. package/dist/dev/surfaces.d.ts +7 -0
  139. package/dist/docs/api/index.md +14 -12
  140. package/dist/docs/api/sdk-tools-client.md +29 -0
  141. package/dist/docs/api/sdk-tools-playwright.md +104 -0
  142. package/dist/docs/changelog.md +19 -0
  143. package/dist/docs/cli-and-dev-server.md +21 -0
  144. package/dist/docs/cli-reference.md +45 -31
  145. package/dist/docs/environment-variables.md +6 -0
  146. package/dist/docs/guides/designing-a-game.md +29 -4
  147. package/dist/docs/guides/starter-game.md +2 -2
  148. package/dist/docs/guides/testing.md +33 -18
  149. package/dist/docs/page-index.md +8 -7
  150. package/dist/docs/recipes/e2e-testing.md +19 -20
  151. package/dist/playwright.js +32232 -0
  152. package/dist/templates/package/claude/rules/workflow-test-engine-or-ui.md +1 -1
  153. package/dist/templates/package/global-setup.ts.template +7 -18
  154. package/dist/templates/package/playwright.config.ts.liquid +8 -11
  155. package/dist/templates/starter-game/playwright.config.ts +8 -11
  156. package/dist/templates/starter-game/testing/e2e/game.spec.ts +1 -1
  157. package/dist/templates/starter-game/testing/e2e/global-setup.ts +7 -18
  158. package/dist/utils/prompt.d.ts +5 -5
  159. package/dist/utils/resource-scan.d.ts +39 -0
  160. package/package.json +7 -3
@@ -0,0 +1,205 @@
1
+ #!/usr/bin/env node
2
+ import {
3
+ promptForSettings
4
+ } from "./cli-UKQYZYFK.js";
5
+ import {
6
+ loadResourceIdentifiers,
7
+ promptForCapabilities
8
+ } from "./cli-GGPDQNM3.js";
9
+ import {
10
+ resolvePatchedDefinition
11
+ } from "./cli-UJ4UCL2Z.js";
12
+ import "./cli-S5IVGDDD.js";
13
+ import {
14
+ readAuthoredBundle
15
+ } from "./cli-YVVXUD2G.js";
16
+ import {
17
+ resolveInputSource
18
+ } from "./cli-4UWFQNGF.js";
19
+ import {
20
+ updateEngineFiles
21
+ } from "./cli-FYINNRML.js";
22
+ import "./cli-IUS2YCD3.js";
23
+ import "./cli-QUNIRH7A.js";
24
+ import "./cli-BYJWFFCF.js";
25
+ import {
26
+ loadPackageContext
27
+ } from "./cli-XSVGKI3R.js";
28
+ import "./cli-MBNMPVDC.js";
29
+ import {
30
+ findBundleFile
31
+ } from "./cli-GFBGYFYD.js";
32
+ import {
33
+ operationError,
34
+ printOperationResult,
35
+ regenerateTypes
36
+ } from "./cli-UELGBQG7.js";
37
+ import {
38
+ confirmAction
39
+ } from "./cli-ZTWOE3ZT.js";
40
+ import "./cli-4BV45LBH.js";
41
+ import "./cli-4AKVLEC4.js";
42
+ import "./cli-VCKOC2EV.js";
43
+ import "./cli-E2NLWIFE.js";
44
+ import "./cli-25RWY5BQ.js";
45
+ import "./cli-QWQMPCL6.js";
46
+ import {
47
+ validateSDKEngine
48
+ } from "./cli-SMFSZF2G.js";
49
+ import "./cli-F2D4GGUA.js";
50
+ import {
51
+ logger
52
+ } from "./cli-4YB3ROVR.js";
53
+ import {
54
+ CliError
55
+ } from "./cli-N6H6T2E2.js";
56
+
57
+ // cli/commands/resources/engine/update.ts
58
+ import { readFileSync } from "fs";
59
+ function logReadWriteChanges(label, existing, updated) {
60
+ const added = updated.filter((id) => !existing.includes(id));
61
+ const removed = existing.filter((id) => !updated.includes(id));
62
+ if (added.length === 0 && removed.length === 0) {
63
+ logger.info(` ${label}: unchanged`);
64
+ return;
65
+ }
66
+ logger.info(` ${label}: CHANGED`);
67
+ for (const id of added) {
68
+ logger.info(` + ${id}`);
69
+ }
70
+ for (const id of removed) {
71
+ logger.info(` - ${id}`);
72
+ }
73
+ }
74
+ async function updateEngine(definitionInput, options) {
75
+ logger.info("\nUpdating engine...\n");
76
+ const identifier = "engine";
77
+ loadPackageContext(options.workingDir);
78
+ let jsonDefinition = null;
79
+ if (options.patch) {
80
+ jsonDefinition = resolvePatchedDefinition({
81
+ patch: options.patch,
82
+ workingDir: options.workingDir,
83
+ type: "engine",
84
+ identifier,
85
+ resourceLabel: "Engine"
86
+ });
87
+ } else {
88
+ const inputSource = await resolveInputSource(definitionInput, options.file);
89
+ if (inputSource.kind === "json") jsonDefinition = inputSource.json;
90
+ }
91
+ if (jsonDefinition) {
92
+ const engineInput = readAuthoredBundle({
93
+ json: jsonDefinition,
94
+ type: "engine",
95
+ command: "update",
96
+ validate: validateSDKEngine,
97
+ identifier,
98
+ validationHint: "Full replacement requires all fields to be specified."
99
+ });
100
+ logger.info("Updating engine files...\n");
101
+ const result2 = updateEngineFiles({
102
+ packagePath: options.workingDir,
103
+ oldIdentifier: identifier,
104
+ newDefinition: engineInput.definition
105
+ });
106
+ if (!result2.success) {
107
+ throw operationError(result2, "Failed to update engine files");
108
+ }
109
+ logger.success("Engine updated successfully!");
110
+ printOperationResult(result2);
111
+ await regenerateTypes(options.workingDir);
112
+ logger.info("");
113
+ return;
114
+ }
115
+ logger.info("No JSON definition provided. Starting interactive mode...\n");
116
+ const enginePath = findBundleFile(options.workingDir, "engine", identifier);
117
+ if (!enginePath) {
118
+ throw new CliError("RESOURCE_NOT_FOUND", `Engine "${identifier}" not found
119
+ `);
120
+ }
121
+ let existingBundle;
122
+ try {
123
+ const engineContent = readFileSync(enginePath, "utf-8");
124
+ existingBundle = JSON.parse(engineContent);
125
+ } catch (error) {
126
+ throw new CliError(
127
+ "BUNDLE_INVALID",
128
+ "Could not read engine file\n" + (error instanceof Error ? error.message : "Unknown error")
129
+ );
130
+ }
131
+ const validation = validateSDKEngine({
132
+ ...existingBundle,
133
+ definition: { ...existingBundle.definition, identifier }
134
+ });
135
+ if (!validation.valid) {
136
+ throw new CliError("BUNDLE_INVALID", `Invalid engine file format
137
+ ${validation.errors}`);
138
+ }
139
+ const existingDef = { ...existingBundle.definition, identifier };
140
+ logger.info("Current engine values:");
141
+ logger.info(` Identifier: ${existingDef.identifier}`);
142
+ const existingReads = existingDef.reads || [];
143
+ logger.info(` Read Capabilities: ${existingReads.length}`);
144
+ for (const read of existingReads) {
145
+ logger.info(` - ${read}`);
146
+ }
147
+ const existingWrites = existingDef.writes || [];
148
+ logger.info(` Written Capabilities: ${existingWrites.length}`);
149
+ for (const write of existingWrites) {
150
+ logger.info(` - ${write}`);
151
+ }
152
+ const existingSettings = existingDef.settings || [];
153
+ logger.info(` Settings: ${existingSettings.length}`);
154
+ for (const id of existingSettings) {
155
+ logger.info(` - ${id}`);
156
+ }
157
+ logger.info("");
158
+ const availableCapabilities = loadResourceIdentifiers(options.workingDir, "capability");
159
+ logger.info("");
160
+ const newReadCapabilities = await promptForCapabilities(
161
+ "Select capabilities the engine reads (use space to select, enter to confirm):",
162
+ availableCapabilities,
163
+ existingReads
164
+ );
165
+ logger.info("");
166
+ const newWriteCapabilities = await promptForCapabilities(
167
+ "Select capabilities the engine writes (use space to select, enter to confirm):",
168
+ availableCapabilities,
169
+ existingWrites
170
+ );
171
+ logger.info("");
172
+ const newSettings = await promptForSettings(options.workingDir, "engine", existingSettings);
173
+ logger.info("\nChanges to be made:");
174
+ logReadWriteChanges("Read Capabilities", existingReads, newReadCapabilities);
175
+ logReadWriteChanges("Written Capabilities", existingWrites, newWriteCapabilities);
176
+ logReadWriteChanges("Settings", existingSettings, newSettings);
177
+ logger.info("\nThis will update 1 file and may update references in games.");
178
+ logger.info("");
179
+ const confirmed = await confirmAction({ message: "Continue with update?", default: true });
180
+ if (!confirmed) {
181
+ logger.info("\nUpdate cancelled.\n");
182
+ return;
183
+ }
184
+ logger.info("\nUpdating engine files...\n");
185
+ const newEngineDefinition = {
186
+ identifier: existingDef.identifier,
187
+ ...newReadCapabilities.length > 0 && { reads: newReadCapabilities },
188
+ ...newWriteCapabilities.length > 0 && { writes: newWriteCapabilities },
189
+ ...newSettings.length > 0 && { settings: newSettings }
190
+ };
191
+ const result = updateEngineFiles({
192
+ packagePath: options.workingDir,
193
+ oldIdentifier: existingDef.identifier,
194
+ newDefinition: newEngineDefinition
195
+ });
196
+ if (!result.success) {
197
+ throw operationError(result, "Failed to update engine files");
198
+ }
199
+ logger.success("Engine updated successfully!");
200
+ printOperationResult(result);
201
+ await regenerateTypes(options.workingDir);
202
+ }
203
+ export {
204
+ updateEngine
205
+ };
@@ -0,0 +1,68 @@
1
+ #!/usr/bin/env node
2
+ import {
3
+ resolveSession
4
+ } from "./cli-GTSGLN3Z.js";
5
+ import "./cli-WU43JT4T.js";
6
+ import {
7
+ emit,
8
+ participantsFromArgument,
9
+ raiseIfRefused,
10
+ requireScenario,
11
+ sessionSummary,
12
+ teamCountFromFlag,
13
+ tickReport
14
+ } from "./cli-PFFCNGHI.js";
15
+ import "./cli-LFM7GJHI.js";
16
+ import "./cli-C6TH5S7K.js";
17
+ import "./cli-TDSQSCX4.js";
18
+ import "./cli-SRHBXZCN.js";
19
+ import "./cli-GUXKQMJ7.js";
20
+ import "./cli-4LKXZQ2B.js";
21
+ import "./cli-MMN4BPO4.js";
22
+ import "./cli-QUNIRH7A.js";
23
+ import "./cli-E2NLWIFE.js";
24
+ import "./cli-25RWY5BQ.js";
25
+ import "./cli-QWQMPCL6.js";
26
+ import "./cli-SMFSZF2G.js";
27
+ import "./cli-F2D4GGUA.js";
28
+ import "./cli-4YB3ROVR.js";
29
+ import "./cli-N6H6T2E2.js";
30
+
31
+ // cli/commands/init.ts
32
+ import dotenv from "dotenv";
33
+ dotenv.config({ path: ".env", debug: false, quiet: true });
34
+ async function initCommand(options) {
35
+ const participants = options.participants === void 0 ? void 0 : participantsFromArgument(options.participants);
36
+ const teams = options.teams === void 0 ? void 0 : teamCountFromFlag(options.teams);
37
+ const scenarioId = options.scenario === void 0 ? void 0 : requireScenario(options.workingDir, options.scenario);
38
+ const session = await resolveSession({
39
+ packagePath: options.workingDir,
40
+ ...options.walkthrough ? { runKind: "walkthrough" } : {},
41
+ ...options.server === false ? { noServer: true } : {},
42
+ ...teams === void 0 ? {} : { teams },
43
+ ...participants === void 0 ? {} : { participants },
44
+ ...scenarioId === void 0 ? {} : { scenarioId },
45
+ ...options.locale === void 0 ? {} : { locale: options.locale }
46
+ });
47
+ try {
48
+ if (!session.ephemeral) {
49
+ raiseIfRefused(
50
+ await session.send({
51
+ type: "reinitialise",
52
+ ...teams === void 0 ? {} : { teams },
53
+ ...participants === void 0 ? {} : { participants },
54
+ ...scenarioId === void 0 ? {} : { scenarioId },
55
+ ...options.locale === void 0 ? {} : { locale: options.locale }
56
+ })
57
+ );
58
+ }
59
+ const state = await session.state();
60
+ const report = options.summary ? sessionSummary(state) : tickReport(state);
61
+ emit({ ...report, scenario: state.game.scenarioId });
62
+ } finally {
63
+ await session.close();
64
+ }
65
+ }
66
+ export {
67
+ initCommand
68
+ };