@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,89 @@
1
+ #!/usr/bin/env node
2
+ import {
3
+ resolvePatchedDefinition
4
+ } from "./cli-UJ4UCL2Z.js";
5
+ import "./cli-S5IVGDDD.js";
6
+ import {
7
+ readAuthoredBundle
8
+ } from "./cli-YVVXUD2G.js";
9
+ import {
10
+ resolveInputSource
11
+ } from "./cli-4UWFQNGF.js";
12
+ import {
13
+ updateScenarioFiles
14
+ } from "./cli-BYJWFFCF.js";
15
+ import {
16
+ loadPackageContext
17
+ } from "./cli-XSVGKI3R.js";
18
+ import "./cli-MBNMPVDC.js";
19
+ import "./cli-GFBGYFYD.js";
20
+ import {
21
+ operationError,
22
+ printOperationResult
23
+ } from "./cli-UELGBQG7.js";
24
+ import "./cli-4BV45LBH.js";
25
+ import "./cli-4AKVLEC4.js";
26
+ import "./cli-VCKOC2EV.js";
27
+ import "./cli-E2NLWIFE.js";
28
+ import "./cli-25RWY5BQ.js";
29
+ import "./cli-QWQMPCL6.js";
30
+ import {
31
+ validateSDKScenario
32
+ } from "./cli-SMFSZF2G.js";
33
+ import "./cli-F2D4GGUA.js";
34
+ import {
35
+ logger
36
+ } from "./cli-4YB3ROVR.js";
37
+ import {
38
+ CliError
39
+ } from "./cli-N6H6T2E2.js";
40
+
41
+ // cli/commands/resources/scenario/update.ts
42
+ async function updateScenario(identifier, definitionInput, options) {
43
+ logger.info("\nUpdating scenario...\n");
44
+ loadPackageContext(options.workingDir);
45
+ let jsonDefinition = null;
46
+ if (options.patch) {
47
+ jsonDefinition = resolvePatchedDefinition({
48
+ patch: options.patch,
49
+ workingDir: options.workingDir,
50
+ type: "scenario",
51
+ identifier,
52
+ resourceLabel: "Scenario"
53
+ });
54
+ } else {
55
+ const inputSource = await resolveInputSource(definitionInput, options.file);
56
+ if (inputSource.kind === "json") jsonDefinition = inputSource.json;
57
+ }
58
+ if (jsonDefinition) {
59
+ const scenarioInput = readAuthoredBundle({
60
+ json: jsonDefinition,
61
+ type: "scenario",
62
+ command: "update",
63
+ validate: validateSDKScenario,
64
+ identifier
65
+ });
66
+ logger.info("Updating scenario files...\n");
67
+ const result = updateScenarioFiles({
68
+ packagePath: options.workingDir,
69
+ oldIdentifier: identifier,
70
+ newDefinition: scenarioInput.definition,
71
+ newIdentifier: scenarioInput.definition?.identifier
72
+ });
73
+ if (!result.success) {
74
+ throw operationError(result, "Failed to update scenario files");
75
+ }
76
+ logger.success("Scenario updated successfully!");
77
+ printOperationResult(result);
78
+ return;
79
+ }
80
+ throw new CliError(
81
+ "USAGE_MISSING_INPUT",
82
+ `JSON definition or --patch is required for scenario updates.
83
+ Usage: sdk update scenario <id> '{"definition": {...}}'
84
+ or: sdk update scenario <id> --patch '[{"op":"replace","path":"/definition/locales/en/name","value":"New Name"}]'`
85
+ );
86
+ }
87
+ export {
88
+ updateScenario
89
+ };
@@ -0,0 +1,76 @@
1
+ #!/usr/bin/env node
2
+ import {
3
+ beginOperationCapture,
4
+ endOperationCapture
5
+ } from "./cli-UELGBQG7.js";
6
+ import {
7
+ setPromptUsage
8
+ } from "./cli-ZTWOE3ZT.js";
9
+ import {
10
+ reportResult
11
+ } from "./cli-N6H6T2E2.js";
12
+
13
+ // cli/commands/resources/shared/resource-command.ts
14
+ import { isAbsolute, relative, resolve, sep } from "path";
15
+ function mergeChanges(results, packagePath) {
16
+ const root = resolve(packagePath);
17
+ const local = (path) => isAbsolute(path) ? relative(root, path).split(sep).join("/") : path;
18
+ const locals = (paths) => (paths ?? []).map(local);
19
+ const changes = {
20
+ filesCreated: [],
21
+ filesUpdated: [],
22
+ filesDeleted: [],
23
+ referencesUpdated: [],
24
+ referencesRemoved: [],
25
+ directoriesRenamed: []
26
+ };
27
+ for (const result of results) {
28
+ changes.filesCreated.push(...locals(result.filesCreated));
29
+ changes.filesUpdated.push(...locals(result.filesUpdated));
30
+ changes.filesDeleted.push(...locals(result.filesDeleted));
31
+ changes.referencesUpdated.push(...result.referencesUpdated ?? []);
32
+ changes.referencesRemoved.push(...result.referencesRemoved ?? []);
33
+ changes.directoriesRenamed.push(
34
+ ...(result.directoriesRenamed ?? []).map(({ from, to }) => ({
35
+ from: local(from),
36
+ to: local(to)
37
+ }))
38
+ );
39
+ }
40
+ return changes;
41
+ }
42
+ function usageFor({
43
+ command,
44
+ resourceType,
45
+ identifier
46
+ }) {
47
+ switch (command) {
48
+ case "new":
49
+ return `seriousgaming-sdk new ${resourceType} '{...}'`;
50
+ case "update":
51
+ return identifier ? `seriousgaming-sdk update ${resourceType} ${identifier} --patch '[...]'` : `seriousgaming-sdk update ${resourceType} '{...}'`;
52
+ case "delete":
53
+ return void 0;
54
+ }
55
+ }
56
+ async function runResourceCommand(context, run) {
57
+ setPromptUsage(usageFor(context));
58
+ beginOperationCapture();
59
+ let results;
60
+ try {
61
+ await run();
62
+ } finally {
63
+ results = endOperationCapture();
64
+ setPromptUsage(void 0);
65
+ }
66
+ const result = {
67
+ resourceType: context.resourceType,
68
+ ...context.identifier ? { identifier: context.identifier } : {},
69
+ ...mergeChanges(results, context.packagePath)
70
+ };
71
+ reportResult(result);
72
+ }
73
+
74
+ export {
75
+ runResourceCommand
76
+ };
@@ -0,0 +1,143 @@
1
+ #!/usr/bin/env node
2
+ import {
3
+ promptForSettings
4
+ } from "./cli-UKQYZYFK.js";
5
+ import {
6
+ loadResourceIdentifiers
7
+ } from "./cli-GGPDQNM3.js";
8
+ import {
9
+ readAuthoredBundle
10
+ } from "./cli-YVVXUD2G.js";
11
+ import {
12
+ resolveInputSource
13
+ } from "./cli-4UWFQNGF.js";
14
+ import {
15
+ createEngineFiles
16
+ } from "./cli-FYINNRML.js";
17
+ import "./cli-IUS2YCD3.js";
18
+ import "./cli-QUNIRH7A.js";
19
+ import "./cli-BYJWFFCF.js";
20
+ import {
21
+ loadPackageContext
22
+ } from "./cli-XSVGKI3R.js";
23
+ import "./cli-MBNMPVDC.js";
24
+ import "./cli-GFBGYFYD.js";
25
+ import {
26
+ BUILD_COMMAND,
27
+ generateTypes,
28
+ operationError,
29
+ printOperationResult
30
+ } from "./cli-UELGBQG7.js";
31
+ import {
32
+ checkbox
33
+ } from "./cli-ZTWOE3ZT.js";
34
+ import "./cli-4BV45LBH.js";
35
+ import "./cli-4AKVLEC4.js";
36
+ import "./cli-VCKOC2EV.js";
37
+ import "./cli-E2NLWIFE.js";
38
+ import "./cli-25RWY5BQ.js";
39
+ import "./cli-QWQMPCL6.js";
40
+ import {
41
+ validateSDKEngine
42
+ } from "./cli-SMFSZF2G.js";
43
+ import "./cli-F2D4GGUA.js";
44
+ import {
45
+ logger
46
+ } from "./cli-4YB3ROVR.js";
47
+ import "./cli-N6H6T2E2.js";
48
+
49
+ // cli/commands/resources/engine/new.ts
50
+ async function createEngine(definitionInput, options) {
51
+ logger.info("\nCreating the engine...\n");
52
+ const aggregate = options.aggregate === true;
53
+ loadPackageContext(options.workingDir, {
54
+ suggestNewPackage: true
55
+ });
56
+ const inputSource = await resolveInputSource(definitionInput, options.file);
57
+ const jsonDefinition = inputSource.kind === "json" ? inputSource.json : null;
58
+ if (jsonDefinition) {
59
+ const engineInput = readAuthoredBundle({
60
+ json: jsonDefinition,
61
+ type: "engine",
62
+ command: "new",
63
+ validate: validateSDKEngine
64
+ });
65
+ const definition = engineInput.definition;
66
+ const reads2 = definition.reads || [];
67
+ const writes2 = definition.writes || [];
68
+ const uses = definition.uses || [];
69
+ const settings2 = definition.settings || [];
70
+ logger.info("Creating engine files...\n");
71
+ const result2 = await createEngineFiles({
72
+ packagePath: options.workingDir,
73
+ reads: reads2,
74
+ writes: writes2,
75
+ uses,
76
+ settings: settings2,
77
+ aggregate
78
+ });
79
+ if (!result2.success) {
80
+ throw operationError(result2, "Failed to create engine files");
81
+ }
82
+ logger.success("Engine created successfully!");
83
+ printOperationResult(result2);
84
+ await generateTypes(options.workingDir);
85
+ logger.info("Next steps:");
86
+ logger.info(" 1. Edit the logic file: engine/logic.ts");
87
+ logger.info(` 2. Run "${BUILD_COMMAND}" to build your package`);
88
+ return;
89
+ }
90
+ logger.info("No JSON definition provided. Starting interactive mode...\n");
91
+ const availableCapabilities = loadResourceIdentifiers(options.workingDir, "capability");
92
+ const reads = [];
93
+ const writes = [];
94
+ if (availableCapabilities.length > 0) {
95
+ logger.info("Select capabilities for the engine.\n");
96
+ logger.info("Tip: Use arrow keys to navigate, space to select, enter to continue.\n");
97
+ const readCapabilities = await checkbox({
98
+ message: "Capabilities the engine reads from:",
99
+ choices: availableCapabilities.map((id) => ({
100
+ name: id,
101
+ value: id
102
+ })),
103
+ pageSize: 10
104
+ });
105
+ reads.push(...readCapabilities);
106
+ const remainingForWrites = availableCapabilities.filter(
107
+ (id) => !readCapabilities.includes(id)
108
+ );
109
+ if (remainingForWrites.length > 0) {
110
+ const writeCapabilities = await checkbox({
111
+ message: "Capabilities the engine writes to (provides):",
112
+ choices: remainingForWrites.map((id) => ({
113
+ name: id,
114
+ value: id
115
+ })),
116
+ pageSize: 10
117
+ });
118
+ writes.push(...writeCapabilities);
119
+ }
120
+ logger.info("");
121
+ } else {
122
+ logger.info("No existing capabilities found in this package.");
123
+ logger.info('You can add capabilities using "seriousgaming-sdk new capability".\n');
124
+ }
125
+ const settings = await promptForSettings(options.workingDir, "engine");
126
+ logger.info("Creating engine files...\n");
127
+ const result = await createEngineFiles({
128
+ packagePath: options.workingDir,
129
+ reads,
130
+ writes,
131
+ settings,
132
+ aggregate
133
+ });
134
+ if (!result.success) {
135
+ throw operationError(result, "Failed to create engine files");
136
+ }
137
+ logger.success("Engine created successfully!");
138
+ printOperationResult(result);
139
+ await generateTypes(options.workingDir);
140
+ }
141
+ export {
142
+ createEngine
143
+ };