@seriousgaming/sdk-tools 1.4.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 (302) 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 +171 -42385
  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 +339 -56
  134. package/dist/core/session.d.ts +15 -1
  135. package/dist/dev/console/assets/{index-BvB-LFQZ.js → index-CuMOOH9m.js} +21 -21
  136. package/dist/dev/console/index.html +1 -1
  137. package/dist/dev/public-origins.d.ts +61 -0
  138. package/dist/dev/shell.d.ts +51 -4
  139. package/dist/dev/surfaces.d.ts +7 -0
  140. package/dist/docs/ai-agents.md +5 -0
  141. package/dist/docs/api/index.md +14 -12
  142. package/dist/docs/api/sdk-tools-client.md +29 -0
  143. package/dist/docs/api/sdk-tools-playwright.md +104 -0
  144. package/dist/docs/changelog-0.x.md +2 -2
  145. package/dist/docs/changelog.md +56 -4
  146. package/dist/docs/cli-and-dev-server.md +79 -0
  147. package/dist/docs/cli-error-codes.md +39 -36
  148. package/dist/docs/cli-reference.md +93 -32
  149. package/dist/docs/environment-variables.md +16 -5
  150. package/dist/docs/guides/ai-facilitation.md +2 -0
  151. package/dist/docs/guides/capabilities.md +2 -0
  152. package/dist/docs/guides/designing-a-game.md +31 -4
  153. package/dist/docs/guides/designing-screens.md +133 -0
  154. package/dist/docs/guides/endpoints.md +2 -0
  155. package/dist/docs/guides/engine-testing.md +5 -1
  156. package/dist/docs/guides/engine.md +2 -0
  157. package/dist/docs/guides/file-handling.md +3 -1
  158. package/dist/docs/guides/games.md +3 -1
  159. package/dist/docs/guides/global-settings.md +2 -0
  160. package/dist/docs/guides/guide.md +2 -0
  161. package/dist/docs/guides/hooks.md +2 -0
  162. package/dist/docs/guides/index.md +9 -0
  163. package/dist/docs/guides/internationalization.md +2 -0
  164. package/dist/docs/guides/llm-integration.md +4 -2
  165. package/dist/docs/guides/multi-team-games.md +3 -1
  166. package/dist/docs/guides/patterns.md +2 -0
  167. package/dist/docs/guides/presentation.md +1 -1
  168. package/dist/docs/guides/production-constraints.md +2 -0
  169. package/dist/docs/guides/scenario-editor.md +2 -0
  170. package/dist/docs/guides/scenarios.md +6 -2
  171. package/dist/docs/guides/session-game-flow.md +365 -0
  172. package/dist/docs/guides/session-hooks.md +205 -0
  173. package/dist/docs/guides/session.md +27 -565
  174. package/dist/docs/guides/settings.md +2 -0
  175. package/dist/docs/guides/setup.md +3 -1
  176. package/dist/docs/guides/speech-generation.md +2 -0
  177. package/dist/docs/guides/starter-game.md +63 -23
  178. package/dist/docs/guides/testing.md +35 -18
  179. package/dist/docs/guides/tick-controller.md +3 -1
  180. package/dist/docs/guides/type-safety.md +2 -0
  181. package/dist/docs/guides/ui-files-and-llms.md +328 -0
  182. package/dist/docs/guides/ui-participants.md +281 -0
  183. package/dist/docs/guides/ui-styling.md +263 -0
  184. package/dist/docs/guides/ui-ticks.md +247 -0
  185. package/dist/docs/guides/ui.md +11 -1092
  186. package/dist/docs/guides/upgrading.md +2 -0
  187. package/dist/docs/guides/validators.md +2 -0
  188. package/dist/docs/guides/waiting-room.md +1 -1
  189. package/dist/docs/index.md +2 -1
  190. package/dist/docs/page-index.md +146 -0
  191. package/dist/docs/recipes/adapt-a-game-for-walkthroughs.md +1 -1
  192. package/dist/docs/recipes/adapt-ui-for-observers.md +1 -1
  193. package/dist/docs/recipes/create-presentation.md +11 -0
  194. package/dist/docs/recipes/create-scenario-editor.md +1 -0
  195. package/dist/docs/recipes/create-session-ui.md +2 -1
  196. package/dist/docs/recipes/create-setup.md +1 -0
  197. package/dist/docs/recipes/create-user-interface.md +1 -0
  198. package/dist/docs/recipes/create-waiting-room-ui.md +1 -0
  199. package/dist/docs/recipes/design-state-for-concurrent-writes.md +1 -1
  200. package/dist/docs/recipes/e2e-testing.md +19 -20
  201. package/dist/docs/recipes/fix-duplicate-packages.md +2 -2
  202. package/dist/docs/recipes/index.md +3 -0
  203. package/dist/docs/recipes/screenshot-a-surface.md +80 -0
  204. package/dist/docs/recipes/test-a-multi-role-game.md +1 -1
  205. package/dist/docs/recipes/use-request-tick.md +2 -2
  206. package/dist/execution/config-resolver.d.ts +4 -1
  207. package/dist/playwright.js +32232 -0
  208. package/dist/runtime/manifest-version.d.ts +1 -1
  209. package/dist/runtime.js +1 -1
  210. package/dist/templates/package/CLAUDE.md.template +14 -5
  211. package/dist/templates/package/DESIGN.md.liquid +39 -7
  212. package/dist/templates/package/README.md.liquid +1 -1
  213. package/dist/templates/package/claude/rules/workflow-create-user-interface.md +1 -1
  214. package/dist/templates/package/claude/rules/workflow-test-engine-or-ui.md +1 -1
  215. package/dist/templates/package/global-setup.ts.template +7 -18
  216. package/dist/templates/package/playwright.config.ts.liquid +8 -11
  217. package/dist/templates/package/pnpm-workspace.yaml.template +13 -0
  218. package/dist/templates/starter-game/capabilities/pacing/capability.sdk.json +18 -0
  219. package/dist/templates/starter-game/package.json +2 -0
  220. package/dist/templates/starter-game/playwright.config.ts +8 -11
  221. package/dist/templates/starter-game/presentation/defaults.ts +52 -0
  222. package/dist/templates/starter-game/presentation/index.html +20 -0
  223. package/dist/templates/starter-game/presentation/presentation.sdk.json +10 -0
  224. package/dist/templates/starter-game/presentation/src/App.tsx +55 -0
  225. package/dist/templates/starter-game/presentation/src/Band.tsx +40 -0
  226. package/dist/templates/starter-game/presentation/src/Slides.tsx +415 -0
  227. package/dist/templates/starter-game/presentation/src/WeatherIcon.tsx +21 -0
  228. package/dist/templates/starter-game/presentation/src/i18n.ts +88 -0
  229. package/dist/templates/starter-game/presentation/src/main.tsx +15 -0
  230. package/dist/templates/starter-game/presentation/src/stalls.test.ts +196 -0
  231. package/dist/templates/starter-game/presentation/src/stalls.ts +199 -0
  232. package/dist/templates/starter-game/presentation/types.ts +94 -0
  233. package/dist/templates/starter-game/seriousgaming.sdk.json +2 -1
  234. package/dist/templates/starter-game/session/defaults.ts +6 -0
  235. package/dist/templates/starter-game/session/index.html +1 -1
  236. package/dist/templates/starter-game/session/session.sdk.json +2 -2
  237. package/dist/templates/starter-game/session/src/App.test.tsx +436 -115
  238. package/dist/templates/starter-game/session/src/App.tsx +372 -222
  239. package/dist/templates/starter-game/session/src/JoinCodes.tsx +184 -0
  240. package/dist/templates/starter-game/session/src/ManagePanel.tsx +188 -0
  241. package/dist/templates/starter-game/session/src/Results.tsx +340 -0
  242. package/dist/templates/starter-game/session/src/SessionBar.tsx +179 -0
  243. package/dist/templates/starter-game/session/src/SessionPanels.tsx +105 -0
  244. package/dist/templates/starter-game/session/src/SidePanel.tsx +89 -0
  245. package/dist/templates/starter-game/session/src/StallCard.tsx +253 -0
  246. package/dist/templates/starter-game/session/src/TopBar.tsx +36 -0
  247. package/dist/templates/starter-game/session/src/i18n.ts +91 -24
  248. package/dist/templates/starter-game/session/src/status.ts +28 -0
  249. package/dist/templates/starter-game/session/types.ts +8 -2
  250. package/dist/templates/starter-game/shared/Awning.tsx +31 -0
  251. package/dist/templates/starter-game/shared/HostLogo.test.tsx +38 -0
  252. package/dist/templates/starter-game/shared/HostLogo.tsx +48 -0
  253. package/dist/templates/starter-game/shared/StallIcons.tsx +83 -0
  254. package/dist/templates/starter-game/shared/days.ts +11 -0
  255. package/dist/templates/starter-game/shared/format.test.ts +13 -0
  256. package/dist/templates/starter-game/{ui/src → shared}/format.ts +1 -1
  257. package/dist/templates/starter-game/testing/e2e/game.spec.ts +43 -9
  258. package/dist/templates/starter-game/testing/e2e/global-setup.ts +7 -18
  259. package/dist/templates/starter-game/ui/defaults.ts +3 -0
  260. package/dist/templates/starter-game/ui/src/App.test.tsx +197 -29
  261. package/dist/templates/starter-game/ui/src/App.tsx +176 -99
  262. package/dist/templates/starter-game/ui/src/DayBar.test.tsx +50 -7
  263. package/dist/templates/starter-game/ui/src/DayBar.tsx +96 -38
  264. package/dist/templates/starter-game/ui/src/DaysTable.tsx +69 -0
  265. package/dist/templates/starter-game/ui/src/FirstDay.tsx +37 -0
  266. package/dist/templates/starter-game/ui/src/Header.tsx +257 -0
  267. package/dist/templates/starter-game/ui/src/Lesson.tsx +63 -0
  268. package/dist/templates/starter-game/ui/src/MakeRow.tsx +98 -71
  269. package/dist/templates/starter-game/ui/src/Notices.tsx +59 -0
  270. package/dist/templates/starter-game/ui/src/PastDay.tsx +88 -0
  271. package/dist/templates/starter-game/ui/src/Section.tsx +26 -26
  272. package/dist/templates/starter-game/ui/src/ThemeToggle.tsx +25 -11
  273. package/dist/templates/starter-game/ui/src/TodayPanel.test.tsx +37 -33
  274. package/dist/templates/starter-game/ui/src/TodayPanel.tsx +66 -52
  275. package/dist/templates/starter-game/ui/src/WeatherCard.tsx +47 -0
  276. package/dist/templates/starter-game/ui/src/WeekOver.tsx +145 -0
  277. package/dist/templates/starter-game/ui/src/YesterdayPanel.tsx +65 -114
  278. package/dist/templates/starter-game/ui/src/days.ts +58 -0
  279. package/dist/templates/starter-game/ui/src/i18n.ts +86 -32
  280. package/dist/templates/starter-game/ui/src/test-helpers.ts +1 -0
  281. package/dist/templates/starter-game/ui/src/theme.ts +8 -8
  282. package/dist/templates/starter-game/ui/types.ts +6 -0
  283. package/dist/templates/starter-game/ui/ui.sdk.json +1 -1
  284. package/dist/templates/starter-game/validators/daylimit/defaults.ts +13 -0
  285. package/dist/templates/starter-game/validators/daylimit/logic/logic.test.ts +20 -0
  286. package/dist/templates/starter-game/validators/daylimit/logic/logic.ts +23 -0
  287. package/dist/templates/starter-game/validators/daylimit/types.ts +23 -0
  288. package/dist/templates/starter-game/validators/daylimit/validator.sdk.json +10 -0
  289. package/dist/templates/starter-game/waiting_room/src/App.test.tsx +83 -5
  290. package/dist/templates/starter-game/waiting_room/src/App.tsx +262 -119
  291. package/dist/templates/starter-game/waiting_room/src/i18n.ts +8 -4
  292. package/dist/utils/error-codes.d.ts +12 -0
  293. package/dist/utils/prompt.d.ts +5 -5
  294. package/dist/utils/resource-scan.d.ts +39 -0
  295. package/package.json +15 -4
  296. package/dist/templates/starter-game/session/src/Section.tsx +0 -37
  297. package/dist/templates/starter-game/session/src/TeamDoor.tsx +0 -96
  298. package/dist/templates/starter-game/session/src/format.ts +0 -8
  299. package/dist/templates/starter-game/ui/src/HistoryPanel.test.tsx +0 -74
  300. package/dist/templates/starter-game/ui/src/HistoryPanel.tsx +0 -120
  301. package/dist/templates/starter-game/ui/src/HostLogo.test.tsx +0 -25
  302. package/dist/templates/starter-game/ui/src/HostLogo.tsx +0 -38
@@ -0,0 +1,367 @@
1
+ #!/usr/bin/env node
2
+ import {
3
+ bundlePaths
4
+ } from "./cli-GFBGYFYD.js";
5
+ import {
6
+ MANIFEST_REFERRER,
7
+ RESOURCE_METADATA_BY_MANIFEST_KEY
8
+ } from "./cli-SMFSZF2G.js";
9
+
10
+ // cli/templating/renderer.ts
11
+ import { writeFileSync, copyFileSync, existsSync } from "fs";
12
+ import { join, dirname } from "path";
13
+ import { fileURLToPath } from "url";
14
+ import { Liquid } from "liquidjs";
15
+ function getTemplatesDirectory() {
16
+ const currentFilePath = fileURLToPath(import.meta.url);
17
+ const currentDir = dirname(currentFilePath);
18
+ const isDev = currentFilePath.includes("/cli/templating/") || currentFilePath.includes("\\cli\\templating\\");
19
+ return isDev ? join(currentDir, "../templates") : join(currentDir, "./templates");
20
+ }
21
+ var templatesDir = getTemplatesDirectory();
22
+ var liquid = new Liquid({
23
+ root: templatesDir,
24
+ extname: ".liquid"
25
+ });
26
+ async function renderTemplate(templatePath, data) {
27
+ return await liquid.renderFile(templatePath, data);
28
+ }
29
+ function copyStaticFile(templatePath, destPath) {
30
+ const sourcePath = join(templatesDir, templatePath);
31
+ if (!existsSync(sourcePath)) {
32
+ throw new Error(`Template file not found: ${templatePath}`);
33
+ }
34
+ copyFileSync(sourcePath, destPath);
35
+ }
36
+ async function renderAndWriteTemplate(templatePath, destPath, data) {
37
+ const rendered = await renderTemplate(templatePath, data);
38
+ writeFileSync(destPath, rendered, "utf-8");
39
+ }
40
+ function writeJsonFile(destPath, content) {
41
+ writeFileSync(destPath, JSON.stringify(content, null, 4) + "\n", "utf-8");
42
+ }
43
+
44
+ // cli/templating/resource-engine.ts
45
+ import { existsSync as existsSync2, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync as writeFileSync2 } from "fs";
46
+ import { dirname as dirname2, join as join2 } from "path";
47
+ function readJson(file) {
48
+ try {
49
+ if (!existsSync2(file)) return null;
50
+ return JSON.parse(readFileSync(file, "utf-8"));
51
+ } catch {
52
+ return null;
53
+ }
54
+ }
55
+ function writeJson(file, value) {
56
+ writeFileSync2(file, JSON.stringify(value, null, 4) + "\n", "utf-8");
57
+ }
58
+ function renameInDefinition(def, shape, oldId, newId) {
59
+ switch (shape.kind) {
60
+ case "stringArray": {
61
+ const arr = def[shape.path];
62
+ if (!Array.isArray(arr)) return false;
63
+ let modified = false;
64
+ def[shape.path] = arr.map((id) => {
65
+ if (id === oldId) {
66
+ modified = true;
67
+ return newId;
68
+ }
69
+ return id;
70
+ });
71
+ return modified;
72
+ }
73
+ case "keyedMap": {
74
+ const map = def[shape.path];
75
+ if (!map || typeof map !== "object") return false;
76
+ if (!(oldId in map)) return false;
77
+ const value = map[oldId];
78
+ delete map[oldId];
79
+ map[newId] = value;
80
+ return true;
81
+ }
82
+ }
83
+ }
84
+ function removeFromDefinition(def, shape, id) {
85
+ switch (shape.kind) {
86
+ case "stringArray": {
87
+ const arr = def[shape.path];
88
+ if (!Array.isArray(arr)) return false;
89
+ const filtered = arr.filter((x) => x !== id);
90
+ if (filtered.length < arr.length) {
91
+ def[shape.path] = filtered;
92
+ return true;
93
+ }
94
+ return false;
95
+ }
96
+ case "keyedMap": {
97
+ const map = def[shape.path];
98
+ if (!map || typeof map !== "object" || !(id in map)) return false;
99
+ delete map[id];
100
+ if (Object.keys(map).length === 0) delete def[shape.path];
101
+ return true;
102
+ }
103
+ }
104
+ }
105
+ function definitionReferences(def, shape, id) {
106
+ switch (shape.kind) {
107
+ case "stringArray": {
108
+ const arr = def[shape.path];
109
+ return Array.isArray(arr) && arr.includes(id);
110
+ }
111
+ case "keyedMap": {
112
+ const map = def[shape.path];
113
+ return !!map && typeof map === "object" && id in map;
114
+ }
115
+ }
116
+ }
117
+ function referenceLabel(referrerLabel, identifier, shape) {
118
+ const suffix = shape.kind === "stringArray" && shape.labelSuffix ? ` (${shape.labelSuffix})` : "";
119
+ return `${referrerLabel}: ${identifier}${suffix}`;
120
+ }
121
+ function rewriteReferences(packagePath, config, meta, oldId, newId) {
122
+ const labels = [];
123
+ const files = [];
124
+ for (const site of meta.referenceSites) {
125
+ for (const referrerKey of site.referrerKeys) {
126
+ if (referrerKey === MANIFEST_REFERRER) {
127
+ const manifest = config;
128
+ const modified = newId === null ? removeFromDefinition(manifest, site.shape, oldId) : renameInDefinition(manifest, site.shape, oldId, newId);
129
+ if (modified) {
130
+ const file = configFile(packagePath);
131
+ writeJson(file, config);
132
+ files.push(file);
133
+ labels.push(referenceLabel("Game", gameIdentifier(config), site.shape));
134
+ }
135
+ continue;
136
+ }
137
+ const referrerMeta = RESOURCE_METADATA_BY_MANIFEST_KEY.get(referrerKey);
138
+ const referrerLabel = referrerMeta?.label ?? referrerKey;
139
+ for (const relPath of bundlePaths(packagePath, referrerMeta ?? meta)) {
140
+ const file = join2(packagePath, relPath);
141
+ const bundle = readJson(file);
142
+ const def = bundle?.definition;
143
+ if (!def) continue;
144
+ const modified = newId === null ? removeFromDefinition(def, site.shape, oldId) : renameInDefinition(def, site.shape, oldId, newId);
145
+ if (modified) {
146
+ writeJson(file, bundle);
147
+ files.push(file);
148
+ labels.push(
149
+ referenceLabel(
150
+ referrerLabel,
151
+ nameFromPath(referrerMeta ?? meta, relPath),
152
+ site.shape
153
+ )
154
+ );
155
+ }
156
+ }
157
+ }
158
+ }
159
+ return { labels, files };
160
+ }
161
+ function resourceDirFromPath(packagePath, meta, relPath) {
162
+ return join2(packagePath, relPath.replace(`/${meta.bundleFile}`, ""));
163
+ }
164
+ function nameFromPath(meta, relPath) {
165
+ return meta.slot ?? relPath.split("/")[1];
166
+ }
167
+ function findBundlePath(packagePath, meta, identifier) {
168
+ return bundlePaths(packagePath, meta).find(
169
+ (relPath) => nameFromPath(meta, relPath) === identifier
170
+ );
171
+ }
172
+ function configFile(packagePath) {
173
+ return join2(packagePath, "seriousgaming.sdk.json");
174
+ }
175
+ function gameIdentifier(config) {
176
+ return `${config.identifier ?? "(unknown)"}.game`;
177
+ }
178
+ async function createResourceFiles(meta, options, scaffold) {
179
+ const filesCreated = [];
180
+ try {
181
+ if (!existsSync2(configFile(options.packagePath))) {
182
+ return {
183
+ success: false,
184
+ error: "seriousgaming.sdk.json not found. This command must be run in a Serious Gaming package directory."
185
+ };
186
+ }
187
+ const dir = meta.slot ? join2(options.packagePath, meta.slot) : join2(options.packagePath, meta.pluralDir, requireIdentifier(meta, options));
188
+ if (existsSync2(dir)) {
189
+ return {
190
+ success: false,
191
+ error: scaffold.alreadyExists?.(dir) ?? `${meta.label} directory already exists: ${dir}`
192
+ };
193
+ }
194
+ mkdirSync(dir, { recursive: true });
195
+ for (const directory of scaffold.directories ?? []) {
196
+ mkdirSync(join2(dir, directory), { recursive: true });
197
+ }
198
+ const rootDirectory = meta.layout ? "." : scaffold.rootDirectory;
199
+ const bundlePath = join2(dir, meta.bundleFile);
200
+ writeJsonFile(bundlePath, {
201
+ definition: scaffold.definition,
202
+ ...meta.layout,
203
+ ...rootDirectory !== void 0 && { rootDirectory }
204
+ });
205
+ filesCreated.push(bundlePath);
206
+ for (const file of scaffold.files ?? []) {
207
+ const path = join2(dir, file.path);
208
+ mkdirSync(dirname2(path), { recursive: true });
209
+ await renderAndWriteTemplate(file.template, path, file.data ?? {});
210
+ filesCreated.push(path);
211
+ }
212
+ return { success: true, filesCreated };
213
+ } catch (error) {
214
+ return {
215
+ success: false,
216
+ error: error instanceof Error ? error.message : "Unknown error occurred",
217
+ filesCreated
218
+ };
219
+ }
220
+ }
221
+ function requireIdentifier(meta, options) {
222
+ if (!options.identifier) throw new Error(`A ${meta.label.toLowerCase()} needs a name`);
223
+ return options.identifier;
224
+ }
225
+ function presentFields(fields) {
226
+ return Object.fromEntries(
227
+ Object.entries(fields).filter(([, value]) => {
228
+ if (value === void 0 || value === "") return false;
229
+ if (Array.isArray(value)) return value.length > 0;
230
+ if (typeof value === "object" && value !== null) return Object.keys(value).length > 0;
231
+ return true;
232
+ })
233
+ );
234
+ }
235
+ function updateResourceFiles(meta, options) {
236
+ try {
237
+ const configPath = configFile(options.packagePath);
238
+ const config = readJson(configPath);
239
+ if (!config) return { success: false, error: "seriousgaming.sdk.json not found" };
240
+ const bundlePath = findBundlePath(options.packagePath, meta, options.oldIdentifier);
241
+ if (!bundlePath) {
242
+ return { success: false, error: `${meta.label} not found in package configuration` };
243
+ }
244
+ const bundleFilePath = join2(options.packagePath, bundlePath);
245
+ const bundle = readJson(bundleFilePath);
246
+ if (!bundle) return { success: false, error: `Could not read ${meta.label} file` };
247
+ bundle.definition = meta.mergeDefinition ? { ...bundle.definition, ...options.newDefinition } : options.newDefinition;
248
+ delete bundle.definition.identifier;
249
+ const filesUpdated = [];
250
+ const referencesUpdated = [];
251
+ const directoriesRenamed = [];
252
+ const newIdentifier = options.newIdentifier ?? options.oldIdentifier;
253
+ if (newIdentifier !== options.oldIdentifier) {
254
+ if (meta.slot) {
255
+ return {
256
+ success: false,
257
+ error: `A game holds one ${meta.label.toLowerCase()}, so it lives in the "${meta.slot}" slot and has no name to change.`
258
+ };
259
+ }
260
+ const { labels } = rewriteReferences(
261
+ options.packagePath,
262
+ config,
263
+ meta,
264
+ options.oldIdentifier,
265
+ newIdentifier
266
+ );
267
+ referencesUpdated.push(...labels);
268
+ const oldDir = resourceDirFromPath(options.packagePath, meta, bundlePath);
269
+ const newDir = join2(options.packagePath, meta.pluralDir, newIdentifier);
270
+ if (!existsSync2(dirname2(newDir))) mkdirSync(dirname2(newDir), { recursive: true });
271
+ renameSync(oldDir, newDir);
272
+ directoriesRenamed.push({ from: oldDir, to: newDir });
273
+ const newBundleFile = join2(newDir, meta.bundleFile);
274
+ writeJson(newBundleFile, bundle);
275
+ filesUpdated.push(newBundleFile);
276
+ } else {
277
+ writeJson(bundleFilePath, bundle);
278
+ filesUpdated.push(bundleFilePath);
279
+ }
280
+ return {
281
+ success: true,
282
+ filesUpdated,
283
+ referencesUpdated: referencesUpdated.length > 0 ? referencesUpdated : void 0,
284
+ directoriesRenamed: directoriesRenamed.length > 0 ? directoriesRenamed : void 0
285
+ };
286
+ } catch (error) {
287
+ return {
288
+ success: false,
289
+ error: error instanceof Error ? error.message : "Unknown error occurred"
290
+ };
291
+ }
292
+ }
293
+ function deleteResourceFiles(meta, options) {
294
+ try {
295
+ const configPath = configFile(options.packagePath);
296
+ const config = readJson(configPath);
297
+ if (!config) return { success: false, error: "seriousgaming.sdk.json not found" };
298
+ const bundlePath = findBundlePath(options.packagePath, meta, options.identifier);
299
+ if (!bundlePath) {
300
+ return { success: false, error: `${meta.label} not found in package configuration` };
301
+ }
302
+ const dir = resourceDirFromPath(options.packagePath, meta, bundlePath);
303
+ if (!existsSync2(dir)) {
304
+ return { success: false, error: `${meta.label} directory not found: ${dir}` };
305
+ }
306
+ const { labels } = rewriteReferences(
307
+ options.packagePath,
308
+ config,
309
+ meta,
310
+ options.identifier,
311
+ null
312
+ );
313
+ rmSync(dir, { recursive: true });
314
+ return {
315
+ success: true,
316
+ filesDeleted: [dir],
317
+ referencesRemoved: labels
318
+ };
319
+ } catch (error) {
320
+ return {
321
+ success: false,
322
+ error: error instanceof Error ? error.message : "Unknown error occurred"
323
+ };
324
+ }
325
+ }
326
+ function findResourceReferences(meta, options) {
327
+ const config = readJson(configFile(options.packagePath));
328
+ if (!config) return [];
329
+ const references = [];
330
+ for (const site of meta.referenceSites) {
331
+ for (const referrerKey of site.referrerKeys) {
332
+ if (referrerKey === MANIFEST_REFERRER) {
333
+ if (definitionReferences(config, site.shape, options.identifier)) {
334
+ references.push(referenceLabel("Game", gameIdentifier(config), site.shape));
335
+ }
336
+ continue;
337
+ }
338
+ const referrerMeta = RESOURCE_METADATA_BY_MANIFEST_KEY.get(referrerKey);
339
+ const referrerLabel = referrerMeta?.label ?? referrerKey;
340
+ for (const relPath of bundlePaths(options.packagePath, referrerMeta ?? meta)) {
341
+ const bundle = readJson(join2(options.packagePath, relPath));
342
+ const def = bundle?.definition;
343
+ if (def && definitionReferences(def, site.shape, options.identifier)) {
344
+ references.push(
345
+ referenceLabel(
346
+ referrerLabel,
347
+ nameFromPath(referrerMeta ?? meta, relPath),
348
+ site.shape
349
+ )
350
+ );
351
+ }
352
+ }
353
+ }
354
+ }
355
+ return references;
356
+ }
357
+
358
+ export {
359
+ copyStaticFile,
360
+ renderAndWriteTemplate,
361
+ writeJsonFile,
362
+ createResourceFiles,
363
+ presentFields,
364
+ updateResourceFiles,
365
+ deleteResourceFiles,
366
+ findResourceReferences
367
+ };
@@ -0,0 +1,13 @@
1
+ #!/usr/bin/env node
2
+ import {
3
+ bundlePackage,
4
+ includeBundleEntry,
5
+ packageBundleCommand
6
+ } from "./cli-J4DKUUTK.js";
7
+ import "./cli-4YB3ROVR.js";
8
+ import "./cli-N6H6T2E2.js";
9
+ export {
10
+ bundlePackage,
11
+ includeBundleEntry,
12
+ packageBundleCommand
13
+ };
@@ -0,0 +1,145 @@
1
+ #!/usr/bin/env node
2
+ import {
3
+ CliError
4
+ } from "./cli-N6H6T2E2.js";
5
+
6
+ // cli/utils/global-settings.ts
7
+ import {
8
+ chmodSync,
9
+ existsSync,
10
+ mkdirSync,
11
+ readFileSync,
12
+ renameSync,
13
+ rmSync,
14
+ writeFileSync
15
+ } from "fs";
16
+ import { homedir } from "os";
17
+ import { dirname, isAbsolute, join } from "path";
18
+ var GLOBAL_SETTINGS_ENV_VAR = "SERIOUSGAMING_SDK_CONFIG";
19
+ var SECRETS_FILE_MODE = 384;
20
+ var GLOBAL_SETTINGS_KEYS = [
21
+ "elevenLabs.apiKey",
22
+ "platform.apiHost",
23
+ "platform.apiKey",
24
+ "platform.defaultPublisher"
25
+ ];
26
+ function resolveGlobalSettingsPath() {
27
+ const override = process.env[GLOBAL_SETTINGS_ENV_VAR];
28
+ if (override) {
29
+ if (!isAbsolute(override)) {
30
+ throw new CliError(
31
+ "SETTINGS_FILE_INVALID",
32
+ `${GLOBAL_SETTINGS_ENV_VAR} must be an absolute path, received: ${override}`
33
+ );
34
+ }
35
+ return override;
36
+ }
37
+ return join(homedir(), ".seriousgaming-sdk", "config.json");
38
+ }
39
+ function loadGlobalSettings(path = resolveGlobalSettingsPath()) {
40
+ if (!existsSync(path)) {
41
+ return {};
42
+ }
43
+ try {
44
+ const content = readFileSync(path, "utf-8");
45
+ const parsed = JSON.parse(content);
46
+ if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
47
+ console.warn(`Warning: ${path} is not a JSON object; ignoring global settings.`);
48
+ return {};
49
+ }
50
+ return parsed;
51
+ } catch (error) {
52
+ console.warn(
53
+ `Warning: Failed to read global settings at ${path}:`,
54
+ error instanceof Error ? error.message : "Unknown error"
55
+ );
56
+ return {};
57
+ }
58
+ }
59
+ function loadGlobalSettingsForWrite(path = resolveGlobalSettingsPath()) {
60
+ if (!existsSync(path)) {
61
+ return {};
62
+ }
63
+ let parsed;
64
+ try {
65
+ parsed = JSON.parse(readFileSync(path, "utf-8"));
66
+ } catch (error) {
67
+ throw new CliError(
68
+ "SETTINGS_FILE_INVALID",
69
+ `${path} could not be parsed: ${error instanceof Error ? error.message : "Unknown error"}
70
+ Refusing to write, because that would discard the settings already in the file. Fix or remove the file, then try again.`
71
+ );
72
+ }
73
+ if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
74
+ throw new CliError(
75
+ "SETTINGS_FILE_INVALID",
76
+ `${path} is not a JSON object.
77
+ Refusing to write, because that would discard the contents of the file. Fix or remove the file, then try again.`
78
+ );
79
+ }
80
+ return parsed;
81
+ }
82
+ function saveGlobalSettings(settings, path = resolveGlobalSettingsPath()) {
83
+ mkdirSync(dirname(path), { recursive: true });
84
+ const content = JSON.stringify(settings, null, 4) + "\n";
85
+ const temporaryPath = `${path}.${process.pid}.tmp`;
86
+ try {
87
+ if (process.platform === "win32") {
88
+ writeFileSync(temporaryPath, content, "utf-8");
89
+ } else {
90
+ writeFileSync(temporaryPath, content, {
91
+ encoding: "utf-8",
92
+ mode: SECRETS_FILE_MODE
93
+ });
94
+ chmodSync(temporaryPath, SECRETS_FILE_MODE);
95
+ }
96
+ renameSync(temporaryPath, path);
97
+ } catch (error) {
98
+ rmSync(temporaryPath, { force: true });
99
+ throw error;
100
+ }
101
+ }
102
+ function assertKnownKey(key) {
103
+ if (!GLOBAL_SETTINGS_KEYS.includes(key)) {
104
+ throw new CliError(
105
+ "USAGE_BAD_ARGUMENT",
106
+ `Unknown setting "${key}". Valid keys: ${GLOBAL_SETTINGS_KEYS.join(", ")}`
107
+ );
108
+ }
109
+ }
110
+ function getGlobalSetting(settings, key) {
111
+ assertKnownKey(key);
112
+ let node = settings;
113
+ for (const segment of key.split(".")) {
114
+ if (typeof node !== "object" || node === null) {
115
+ return void 0;
116
+ }
117
+ node = node[segment];
118
+ }
119
+ return typeof node === "string" ? node : void 0;
120
+ }
121
+ function setGlobalSetting(settings, key, value) {
122
+ assertKnownKey(key);
123
+ const segments = key.split(".");
124
+ const leaf = segments.pop() ?? key;
125
+ const next = structuredClone(settings);
126
+ let node = next;
127
+ for (const segment of segments) {
128
+ const existing = node[segment];
129
+ if (typeof existing !== "object" || existing === null) {
130
+ node[segment] = {};
131
+ }
132
+ node = node[segment];
133
+ }
134
+ node[leaf] = value;
135
+ return next;
136
+ }
137
+
138
+ export {
139
+ resolveGlobalSettingsPath,
140
+ loadGlobalSettings,
141
+ loadGlobalSettingsForWrite,
142
+ saveGlobalSettings,
143
+ getGlobalSetting,
144
+ setGlobalSetting
145
+ };
@@ -0,0 +1,40 @@
1
+ #!/usr/bin/env node
2
+ import {
3
+ resolveDocsPath
4
+ } from "./cli-UNAJ2OTE.js";
5
+ import {
6
+ CliError,
7
+ reportResult
8
+ } from "./cli-N6H6T2E2.js";
9
+
10
+ // cli/commands/docs-export.ts
11
+ import { cpSync, existsSync } from "fs";
12
+ import { resolve } from "path";
13
+ async function docsExportCommand(outputDir) {
14
+ const targetDir = outputDir || ".seriousgaming-sdk/docs";
15
+ const docsPath = resolveDocsPath();
16
+ if (!existsSync(docsPath)) {
17
+ throw new CliError(
18
+ "SDK_INCOMPLETE",
19
+ "Documentation files not found. Make sure the SDK is properly installed."
20
+ );
21
+ }
22
+ console.error(`Exporting documentation to ${targetDir}...`);
23
+ try {
24
+ cpSync(docsPath, targetDir, { recursive: true });
25
+ } catch (error) {
26
+ throw new CliError(
27
+ "WRITE_FAILED",
28
+ `Error exporting documentation: ${error.message}`,
29
+ { cause: error }
30
+ );
31
+ }
32
+ reportResult({ directory: resolve(targetDir) }, () => {
33
+ console.log(`\u2713 Documentation exported successfully to ${targetDir}`);
34
+ console.log(`
35
+ You can now use these docs with Claude Code for context.`);
36
+ });
37
+ }
38
+ export {
39
+ docsExportCommand
40
+ };