@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,60 @@
1
+ #!/usr/bin/env node
2
+ import {
3
+ runResourceCommand
4
+ } from "./cli-DMW2OQIJ.js";
5
+ import {
6
+ RESOURCE_DESCRIPTORS_BY_TYPE,
7
+ supportedTypes
8
+ } from "./cli-LMDJCHHD.js";
9
+ import "./cli-UELGBQG7.js";
10
+ import "./cli-ZTWOE3ZT.js";
11
+ import "./cli-4BV45LBH.js";
12
+ import "./cli-4AKVLEC4.js";
13
+ import "./cli-VCKOC2EV.js";
14
+ import "./cli-E2NLWIFE.js";
15
+ import "./cli-25RWY5BQ.js";
16
+ import "./cli-QWQMPCL6.js";
17
+ import "./cli-SMFSZF2G.js";
18
+ import "./cli-F2D4GGUA.js";
19
+ import "./cli-4YB3ROVR.js";
20
+ import {
21
+ CliError
22
+ } from "./cli-N6H6T2E2.js";
23
+
24
+ // cli/commands/delete.ts
25
+ async function deleteCommand(resourceType, identifier, options) {
26
+ const descriptor = RESOURCE_DESCRIPTORS_BY_TYPE.get(resourceType);
27
+ const isUnidentified = descriptor?.delete?.kind === "unidentified";
28
+ await runResourceCommand(
29
+ {
30
+ command: "delete",
31
+ resourceType,
32
+ packagePath: options.workingDir,
33
+ identifier: isUnidentified ? void 0 : identifier
34
+ },
35
+ async () => {
36
+ if (!descriptor || !descriptor.delete) {
37
+ throw new CliError(
38
+ "RESOURCE_TYPE_UNKNOWN",
39
+ `Resource type "${resourceType}" is not supported for deletion
40
+ Supported types: ${supportedTypes("delete")}`
41
+ );
42
+ }
43
+ if (descriptor.delete.kind === "unidentified") {
44
+ await descriptor.delete.run(options);
45
+ return;
46
+ }
47
+ if (!identifier) {
48
+ throw new CliError(
49
+ "USAGE_MISSING_ARGUMENT",
50
+ `Resource identifier is required.
51
+ Usage: seriousgaming-sdk delete ${resourceType} <identifier>`
52
+ );
53
+ }
54
+ await descriptor.delete.run(identifier, options);
55
+ }
56
+ );
57
+ }
58
+ export {
59
+ deleteCommand
60
+ };
@@ -0,0 +1,16 @@
1
+ #!/usr/bin/env node
2
+ import {
3
+ readSdkToolsVersion
4
+ } from "./cli-IUS2YCD3.js";
5
+ import {
6
+ reportResult
7
+ } from "./cli-N6H6T2E2.js";
8
+
9
+ // cli/commands/version.ts
10
+ async function versionCommand() {
11
+ const version = readSdkToolsVersion();
12
+ reportResult({ version }, () => console.log(version));
13
+ }
14
+ export {
15
+ versionCommand
16
+ };
@@ -0,0 +1,185 @@
1
+ #!/usr/bin/env node
2
+ import {
3
+ assertEveryPropertyHasDefault
4
+ } from "./cli-O6PWMJTZ.js";
5
+ import {
6
+ reviewSchemaProperties
7
+ } from "./cli-RZITKPJX.js";
8
+ import {
9
+ resolvePatchedDefinition
10
+ } from "./cli-UJ4UCL2Z.js";
11
+ import "./cli-S5IVGDDD.js";
12
+ import {
13
+ getResourceIdentifierError,
14
+ readAuthoredBundle
15
+ } from "./cli-YVVXUD2G.js";
16
+ import {
17
+ resolveInputSource
18
+ } from "./cli-4UWFQNGF.js";
19
+ import {
20
+ updateSettingsFiles
21
+ } from "./cli-FYINNRML.js";
22
+ import "./cli-IUS2YCD3.js";
23
+ import {
24
+ extractSchemaProperties
25
+ } from "./cli-QUNIRH7A.js";
26
+ import "./cli-BYJWFFCF.js";
27
+ import {
28
+ loadPackageContext
29
+ } from "./cli-XSVGKI3R.js";
30
+ import "./cli-MBNMPVDC.js";
31
+ import {
32
+ findBundleFile
33
+ } from "./cli-GFBGYFYD.js";
34
+ import {
35
+ operationError,
36
+ printOperationResult,
37
+ regenerateTypes
38
+ } from "./cli-UELGBQG7.js";
39
+ import {
40
+ confirmAction,
41
+ input
42
+ } from "./cli-ZTWOE3ZT.js";
43
+ import "./cli-4BV45LBH.js";
44
+ import "./cli-4AKVLEC4.js";
45
+ import "./cli-VCKOC2EV.js";
46
+ import "./cli-E2NLWIFE.js";
47
+ import "./cli-25RWY5BQ.js";
48
+ import "./cli-QWQMPCL6.js";
49
+ import {
50
+ validateSDKSettings
51
+ } from "./cli-SMFSZF2G.js";
52
+ import "./cli-F2D4GGUA.js";
53
+ import {
54
+ logger
55
+ } from "./cli-4YB3ROVR.js";
56
+ import {
57
+ CliError
58
+ } from "./cli-N6H6T2E2.js";
59
+
60
+ // cli/commands/resources/settings/update.ts
61
+ import { readFileSync } from "fs";
62
+ async function updateSettings(identifier, definitionInput, options) {
63
+ logger.info("\nUpdating settings...\n");
64
+ loadPackageContext(options.workingDir);
65
+ let jsonDefinition = null;
66
+ if (options.patch) {
67
+ jsonDefinition = resolvePatchedDefinition({
68
+ patch: options.patch,
69
+ workingDir: options.workingDir,
70
+ type: "settings",
71
+ identifier,
72
+ resourceLabel: "Settings"
73
+ });
74
+ } else {
75
+ const inputSource = await resolveInputSource(definitionInput, options.file);
76
+ if (inputSource.kind === "json") jsonDefinition = inputSource.json;
77
+ }
78
+ if (jsonDefinition) {
79
+ const settingsInput = readAuthoredBundle({
80
+ json: jsonDefinition,
81
+ type: "settings",
82
+ command: "update",
83
+ validate: validateSDKSettings,
84
+ identifier,
85
+ validationHint: "Full replacement requires all fields to be specified."
86
+ });
87
+ assertEveryPropertyHasDefault(settingsInput.definition.settingsSchema);
88
+ logger.info("Updating settings files...\n");
89
+ const result2 = updateSettingsFiles({
90
+ packagePath: options.workingDir,
91
+ oldIdentifier: identifier,
92
+ newDefinition: settingsInput.definition,
93
+ newIdentifier: settingsInput.definition.identifier
94
+ });
95
+ if (!result2.success) {
96
+ throw operationError(result2, "Failed to update settings files");
97
+ }
98
+ logger.success("Settings updated successfully!");
99
+ printOperationResult(result2);
100
+ await regenerateTypes(options.workingDir);
101
+ return;
102
+ }
103
+ logger.info("No JSON definition provided. Starting interactive mode...\n");
104
+ const bundlePath = findBundleFile(options.workingDir, "settings", identifier);
105
+ if (!bundlePath) {
106
+ throw new CliError("RESOURCE_NOT_FOUND", `Settings "${identifier}" not found
107
+ `);
108
+ }
109
+ let existingBundle;
110
+ try {
111
+ existingBundle = JSON.parse(readFileSync(bundlePath, "utf-8"));
112
+ } catch (error) {
113
+ throw new CliError(
114
+ "BUNDLE_INVALID",
115
+ "Could not read settings file\n" + (error instanceof Error ? error.message : "Unknown error")
116
+ );
117
+ }
118
+ const existingDef = { ...existingBundle.definition, identifier };
119
+ const validation = validateSDKSettings({ ...existingBundle, definition: existingDef });
120
+ if (!validation.valid) {
121
+ throw new CliError("BUNDLE_INVALID", `Invalid settings file format
122
+ ${validation.errors}`);
123
+ }
124
+ const existingProps = extractSchemaProperties(existingDef.settingsSchema);
125
+ logger.info("Current settings:");
126
+ logger.info(` Identifier: ${identifier}`);
127
+ logger.info(` Properties: ${Object.keys(existingProps).length} defined`);
128
+ for (const [name, property] of Object.entries(existingProps)) {
129
+ logger.info(` - ${name} (${property?.type ?? "unknown"})`);
130
+ }
131
+ logger.info("");
132
+ const newIdentifier = await input({
133
+ message: "Settings name:",
134
+ default: identifier,
135
+ validate: (value) => getResourceIdentifierError(value) || true
136
+ });
137
+ if (newIdentifier !== identifier) {
138
+ logger.info(
139
+ "\n\u26A0\uFE0F WARNING: Changing the identifier will update every resource that reads these settings, the setup UI and scenario editor if they edit them, and every scenario that overrides them.\n"
140
+ );
141
+ }
142
+ const { properties, changes } = await reviewSchemaProperties(existingProps, {
143
+ allowDelete: true,
144
+ allowAdd: true,
145
+ context: "setting"
146
+ });
147
+ logger.info("\nChanges to be made:");
148
+ logger.info(
149
+ newIdentifier !== identifier ? ` Identifier: ${identifier} \u2192 ${newIdentifier} (CHANGED)` : ` Identifier: ${identifier} (unchanged)`
150
+ );
151
+ logger.info(" Properties:");
152
+ for (const name of changes.kept) logger.info(` - ${name}: UNCHANGED`);
153
+ for (const mod of changes.modified) logger.info(` - ${mod.name}: MODIFIED (${mod.changes})`);
154
+ for (const name of changes.deleted) logger.info(` - ${name}: DELETED`);
155
+ for (const name of changes.added) logger.info(` + ${name}: ADDED`);
156
+ logger.info("");
157
+ const confirmed = await confirmAction({ message: "Continue with update?", default: true });
158
+ if (!confirmed) {
159
+ logger.info("\nUpdate cancelled.\n");
160
+ return;
161
+ }
162
+ const settingsSchema = {
163
+ ...existingDef.settingsSchema,
164
+ type: "object",
165
+ properties,
166
+ additionalProperties: false
167
+ };
168
+ assertEveryPropertyHasDefault(settingsSchema);
169
+ logger.info("\nUpdating settings files...\n");
170
+ const result = updateSettingsFiles({
171
+ packagePath: options.workingDir,
172
+ oldIdentifier: identifier,
173
+ newDefinition: { settingsSchema },
174
+ newIdentifier
175
+ });
176
+ if (!result.success) {
177
+ throw operationError(result, "Failed to update settings files");
178
+ }
179
+ logger.success("Settings updated successfully!");
180
+ printOperationResult(result);
181
+ await regenerateTypes(options.workingDir);
182
+ }
183
+ export {
184
+ updateSettings
185
+ };