@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
+ deleteWaitingRoomUserInterfaceFiles,
4
+ findWaitingRoomUserInterfaceReferences
5
+ } from "./cli-FYINNRML.js";
6
+ import "./cli-IUS2YCD3.js";
7
+ import "./cli-QUNIRH7A.js";
8
+ import "./cli-BYJWFFCF.js";
9
+ import {
10
+ loadPackageContext
11
+ } from "./cli-XSVGKI3R.js";
12
+ import "./cli-MBNMPVDC.js";
13
+ import "./cli-GFBGYFYD.js";
14
+ import {
15
+ operationError,
16
+ recordOperationResult
17
+ } from "./cli-UELGBQG7.js";
18
+ import {
19
+ confirmAction
20
+ } from "./cli-ZTWOE3ZT.js";
21
+ import {
22
+ generateCommand
23
+ } from "./cli-4BV45LBH.js";
24
+ import "./cli-4AKVLEC4.js";
25
+ import "./cli-VCKOC2EV.js";
26
+ import "./cli-E2NLWIFE.js";
27
+ import "./cli-25RWY5BQ.js";
28
+ import "./cli-QWQMPCL6.js";
29
+ import "./cli-SMFSZF2G.js";
30
+ import "./cli-F2D4GGUA.js";
31
+ import {
32
+ logger
33
+ } from "./cli-4YB3ROVR.js";
34
+ import "./cli-N6H6T2E2.js";
35
+
36
+ // cli/commands/resources/waiting-room/delete.ts
37
+ async function deleteWaitingRoomUserInterface(options) {
38
+ logger.info("\nDeleting waiting room user interface...\n");
39
+ const identifier = "waiting_room";
40
+ loadPackageContext(options.workingDir);
41
+ const references = findWaitingRoomUserInterfaceReferences({
42
+ packagePath: options.workingDir,
43
+ identifier
44
+ });
45
+ logger.info(`Waiting Room User Interface: ${identifier}`);
46
+ if (references.length > 0) {
47
+ logger.info("\nThis waiting room user interface is used in games:");
48
+ for (const ref of references) {
49
+ logger.info(` - ${ref}`);
50
+ }
51
+ logger.info("\nThese references will be removed.");
52
+ }
53
+ const confirmed = await confirmAction(
54
+ { message: "Are you sure you want to delete this waiting room user interface?" },
55
+ options.yes
56
+ );
57
+ if (!confirmed) {
58
+ logger.info("\nDeletion cancelled.\n");
59
+ return;
60
+ }
61
+ logger.info("");
62
+ const result = deleteWaitingRoomUserInterfaceFiles({
63
+ packagePath: options.workingDir,
64
+ identifier
65
+ });
66
+ if (!result.success) {
67
+ throw operationError(result, "Failed to delete waiting room user interface files");
68
+ }
69
+ recordOperationResult(result);
70
+ for (const file of result.filesDeleted || []) {
71
+ logger.info(` \u2713 Deleted: ${file}`);
72
+ }
73
+ for (const ref of result.referencesRemoved || []) {
74
+ logger.info(` \u2713 Removed reference from: ${ref}`);
75
+ }
76
+ logger.info(" \u2713 Updated seriousgaming.sdk.json");
77
+ logger.info("\nRegenerating TypeScript types...\n");
78
+ try {
79
+ await generateCommand({ workingDir: options.workingDir });
80
+ logger.success("TypeScript types regenerated successfully!");
81
+ } catch (error) {
82
+ logger.warn("\nWarning: Failed to regenerate TypeScript types:");
83
+ logger.warn(error instanceof Error ? error.message : "Unknown error");
84
+ }
85
+ logger.success("Waiting room user interface deleted successfully!");
86
+ }
87
+ export {
88
+ deleteWaitingRoomUserInterface
89
+ };
@@ -0,0 +1,23 @@
1
+ #!/usr/bin/env node
2
+
3
+ // cli/dev/blob-links.ts
4
+ function blobLinks(response, urlFor) {
5
+ const links = {};
6
+ const visit = (value) => {
7
+ if (typeof value === "string") {
8
+ if (value.startsWith("blob:") && value.length > "blob:".length) {
9
+ links[value] = urlFor(value.slice("blob:".length));
10
+ }
11
+ } else if (Array.isArray(value)) {
12
+ value.forEach(visit);
13
+ } else if (typeof value === "object" && value !== null) {
14
+ Object.values(value).forEach(visit);
15
+ }
16
+ };
17
+ visit(response);
18
+ return links;
19
+ }
20
+
21
+ export {
22
+ blobLinks
23
+ };
@@ -0,0 +1,37 @@
1
+ #!/usr/bin/env node
2
+ import {
3
+ createResourceFiles,
4
+ deleteResourceFiles,
5
+ findResourceReferences,
6
+ updateResourceFiles
7
+ } from "./cli-MBNMPVDC.js";
8
+ import {
9
+ getResourceMeta
10
+ } from "./cli-SMFSZF2G.js";
11
+
12
+ // cli/templating/scenario.ts
13
+ var scenarioMeta = getResourceMeta("scenario");
14
+ function createScenarioFiles(options) {
15
+ const { identifier: _named, ...authored } = options.definition;
16
+ return createResourceFiles(scenarioMeta, options, {
17
+ definition: authored,
18
+ rootDirectory: options.rootDirectory,
19
+ directories: ["assets/shared"]
20
+ });
21
+ }
22
+ function updateScenarioFiles(options) {
23
+ return updateResourceFiles(scenarioMeta, options);
24
+ }
25
+ function deleteScenarioFiles(options) {
26
+ return deleteResourceFiles(scenarioMeta, options);
27
+ }
28
+ function findScenarioReferences(options) {
29
+ return findResourceReferences(scenarioMeta, options);
30
+ }
31
+
32
+ export {
33
+ createScenarioFiles,
34
+ updateScenarioFiles,
35
+ deleteScenarioFiles,
36
+ findScenarioReferences
37
+ };
@@ -0,0 +1,43 @@
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/new.ts
25
+ async function newCommand(resourceType, definition, options) {
26
+ await runResourceCommand(
27
+ { command: "new", resourceType, packagePath: options.workingDir },
28
+ async () => {
29
+ const descriptor = RESOURCE_DESCRIPTORS_BY_TYPE.get(resourceType);
30
+ if (!descriptor?.create) {
31
+ throw new CliError(
32
+ "RESOURCE_TYPE_UNKNOWN",
33
+ `Resource type "${resourceType}" does not exist
34
+ Supported types: ${supportedTypes("new")}`
35
+ );
36
+ }
37
+ await descriptor.create(definition, options);
38
+ }
39
+ );
40
+ }
41
+ export {
42
+ newCommand
43
+ };
@@ -0,0 +1,42 @@
1
+ #!/usr/bin/env node
2
+ import {
3
+ stopLockedServer
4
+ } from "./cli-WU43JT4T.js";
5
+ import {
6
+ inspectLockFile,
7
+ readLockFile,
8
+ removeLockFile
9
+ } from "./cli-SRHBXZCN.js";
10
+ import {
11
+ reportResult
12
+ } from "./cli-N6H6T2E2.js";
13
+
14
+ // cli/commands/dev-control.ts
15
+ async function devStatusCommand(options) {
16
+ const inspection = await inspectLockFile(options.workingDir);
17
+ if (inspection.status === "stale") await removeLockFile(options.workingDir);
18
+ const lock = "lock" in inspection ? inspection.lock : null;
19
+ const responding = inspection.status === "live";
20
+ reportResult(
21
+ lock ? { running: true, responding, url: `http://localhost:${lock.port}`, ...lock } : { running: false },
22
+ () => console.log(
23
+ !lock ? "No dev server is running for this package." : responding ? `Running at http://localhost:${lock.port} (pid ${lock.pid}, since ${lock.startedAt})` : `Running at http://localhost:${lock.port} (pid ${lock.pid}, since ${lock.startedAt}), but not answering. Stop it with \`sdk dev stop\`.`
24
+ )
25
+ );
26
+ }
27
+ async function devStopCommand(options) {
28
+ const lock = await readLockFile(options.workingDir, { unresponsive: "accept" });
29
+ if (!lock) {
30
+ reportResult(
31
+ { stopped: false },
32
+ () => console.log("No dev server is running for this package.")
33
+ );
34
+ return;
35
+ }
36
+ await stopLockedServer(options.workingDir, lock);
37
+ reportResult({ stopped: true, pid: lock.pid }, () => console.log("Dev server stopped."));
38
+ }
39
+ export {
40
+ devStatusCommand,
41
+ devStopCommand
42
+ };
@@ -0,0 +1,46 @@
1
+ #!/usr/bin/env node
2
+ import {
3
+ CliError
4
+ } from "./cli-N6H6T2E2.js";
5
+
6
+ // cli/dev/default-port.ts
7
+ var DEV_PORT_ENV_VAR = "SERIOUSGAMING_DEV_PORT";
8
+ function defaultDevPort() {
9
+ return process.env[DEV_PORT_ENV_VAR] || "3000";
10
+ }
11
+ function parseDevPortOrAuto(value) {
12
+ return value.trim().toLowerCase() === "auto" ? 0 : parseDevPort(value);
13
+ }
14
+ function parseDevPort(value) {
15
+ const port = Number(value);
16
+ if (!Number.isInteger(port) || port < 1 || port > 65535) {
17
+ throw new CliError(
18
+ "USAGE_BAD_FLAG",
19
+ `"${value}" is not a port. Pass a whole number between 1 and 65535 (or \`auto\`) to --port, or in ${DEV_PORT_ENV_VAR}.`
20
+ );
21
+ }
22
+ return port;
23
+ }
24
+
25
+ // cli/dev/error-overlay.ts
26
+ var ERROR_OVERLAY_ENV_VAR = "SERIOUSGAMING_DEV_ERROR_OVERLAY";
27
+ function resolveErrorOverlay(flag, env = process.env) {
28
+ if (flag === false) return false;
29
+ const value = env[ERROR_OVERLAY_ENV_VAR]?.trim().toLowerCase();
30
+ if (!value) return true;
31
+ if (value === "false" || value === "0") return false;
32
+ if (value === "true" || value === "1") return true;
33
+ throw new CliError(
34
+ "USAGE_BAD_FLAG",
35
+ `${ERROR_OVERLAY_ENV_VAR}="${env[ERROR_OVERLAY_ENV_VAR]}" is neither true nor false.`
36
+ );
37
+ }
38
+
39
+ export {
40
+ DEV_PORT_ENV_VAR,
41
+ defaultDevPort,
42
+ parseDevPortOrAuto,
43
+ parseDevPort,
44
+ ERROR_OVERLAY_ENV_VAR,
45
+ resolveErrorOverlay
46
+ };