@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,304 @@
1
+ #!/usr/bin/env node
2
+
3
+ // cli/utils/lazy.ts
4
+ function lazy(load, name) {
5
+ return (...args) => load().then((module) => module[name](...args));
6
+ }
7
+
8
+ // cli/commands/resources/registry.ts
9
+ var deleteCapability = lazy(() => import("./cli-6RRVEGFB.js"), "deleteCapability");
10
+ var createCapability = lazy(() => import("./cli-ROT3DRKU.js"), "createCapability");
11
+ var updateCapability = lazy(() => import("./cli-LFGRFIEO.js"), "updateCapability");
12
+ var deleteEndpoint = lazy(() => import("./cli-KNOOKGYW.js"), "deleteEndpoint");
13
+ var createEndpoint = lazy(() => import("./cli-EVFS55WN.js"), "createEndpoint");
14
+ var updateEndpoint = lazy(() => import("./cli-PNLYX6R6.js"), "updateEndpoint");
15
+ var deleteEngine = lazy(() => import("./cli-K2B6WHKA.js"), "deleteEngine");
16
+ var createEngine = lazy(() => import("./cli-DZW3XD5F.js"), "createEngine");
17
+ var updateEngine = lazy(() => import("./cli-ZVSFYDPQ.js"), "updateEngine");
18
+ var deleteFacilitatorGuide = lazy(() => import("./cli-VCI3CG36.js"), "deleteFacilitatorGuide");
19
+ var createFacilitatorGuide = lazy(() => import("./cli-5JEGTVTG.js"), "createFacilitatorGuide");
20
+ var updateFacilitatorGuide = lazy(() => import("./cli-G6UE5NL4.js"), "updateFacilitatorGuide");
21
+ var deleteHook = lazy(() => import("./cli-TCY5LJ7E.js"), "deleteHook");
22
+ var createHook = lazy(() => import("./cli-M6BCQRID.js"), "createHook");
23
+ var updateHook = lazy(() => import("./cli-TPU4TUR6.js"), "updateHook");
24
+ var createPackage = lazy(() => import("./cli-QEVE5HUM.js"), "createPackage");
25
+ var updatePackage = lazy(() => import("./cli-JFU22EJ2.js"), "updatePackage");
26
+ var deletePresentation = lazy(() => import("./cli-UNJ5X6BU.js"), "deletePresentation");
27
+ var createPresentation = lazy(() => import("./cli-KL3756X6.js"), "createPresentation");
28
+ var updatePresentation = lazy(() => import("./cli-272KBNJH.js"), "updatePresentation");
29
+ var deleteScenarioEditor = lazy(
30
+ () => import("./cli-SIPDUBFL.js"),
31
+ "deleteScenarioEditor"
32
+ );
33
+ var createScenarioEditor = lazy(() => import("./cli-IRZ5KB7D.js"), "createScenarioEditor");
34
+ var updateScenarioEditor = lazy(
35
+ () => import("./cli-57RXC3HQ.js"),
36
+ "updateScenarioEditor"
37
+ );
38
+ var deleteScenario = lazy(() => import("./cli-WAE26SVW.js"), "deleteScenario");
39
+ var createScenario = lazy(() => import("./cli-UTJU4IYG.js"), "createScenario");
40
+ var updateScenario = lazy(() => import("./cli-DL2CVMRF.js"), "updateScenario");
41
+ var deleteSessionUserInterface = lazy(
42
+ () => import("./cli-JZM7XTNV.js"),
43
+ "deleteSessionUserInterface"
44
+ );
45
+ var createSessionUserInterface = lazy(
46
+ () => import("./cli-E6DJIMYD.js"),
47
+ "createSessionUserInterface"
48
+ );
49
+ var updateSessionUserInterface = lazy(
50
+ () => import("./cli-6AMT3BUO.js"),
51
+ "updateSessionUserInterface"
52
+ );
53
+ var deleteSettings = lazy(() => import("./cli-TLLA6KAP.js"), "deleteSettings");
54
+ var createSettings = lazy(() => import("./cli-XCO2VQOH.js"), "createSettings");
55
+ var updateSettings = lazy(() => import("./cli-HYY64SUD.js"), "updateSettings");
56
+ var deleteSetup = lazy(() => import("./cli-RN6IWTL2.js"), "deleteSetup");
57
+ var createSetup = lazy(() => import("./cli-6WXLXJVX.js"), "createSetup");
58
+ var updateSetup = lazy(() => import("./cli-E33CJRRQ.js"), "updateSetup");
59
+ var deleteTickController = lazy(
60
+ () => import("./cli-ZISJ36MM.js"),
61
+ "deleteTickController"
62
+ );
63
+ var createTickController = lazy(() => import("./cli-3HE4AVZG.js"), "createTickController");
64
+ var updateTickController = lazy(
65
+ () => import("./cli-7OGYADZ3.js"),
66
+ "updateTickController"
67
+ );
68
+ var deleteUserInterface = lazy(() => import("./cli-UMFFURZ7.js"), "deleteUserInterface");
69
+ var createUserInterface = lazy(() => import("./cli-EEFJKIGL.js"), "createUserInterface");
70
+ var updateUserInterface = lazy(() => import("./cli-LXYPE3L5.js"), "updateUserInterface");
71
+ var deleteValidator = lazy(() => import("./cli-G522CPRL.js"), "deleteValidator");
72
+ var createValidator = lazy(() => import("./cli-Q2XJF5AS.js"), "createValidator");
73
+ var updateValidator = lazy(() => import("./cli-R4PCG5YX.js"), "updateValidator");
74
+ var deleteWaitingRoomUserInterface = lazy(
75
+ () => import("./cli-BPYMTOUL.js"),
76
+ "deleteWaitingRoomUserInterface"
77
+ );
78
+ var createWaitingRoomUserInterface = lazy(
79
+ () => import("./cli-ORIG557O.js"),
80
+ "createWaitingRoomUserInterface"
81
+ );
82
+ var updateWaitingRoomUserInterface = lazy(
83
+ () => import("./cli-UHSZBKYO.js"),
84
+ "updateWaitingRoomUserInterface"
85
+ );
86
+ var RESOURCE_DESCRIPTORS = [
87
+ {
88
+ type: "package",
89
+ create: createPackage,
90
+ update: { kind: "unidentified", run: updatePackage },
91
+ updateSupportsPatch: true,
92
+ help: {
93
+ typeLabel: "package",
94
+ updateSummary: "Edits seriousgaming.sdk.json: the package identifier and the game's\nsettings. A full update replaces the whole file, so restate every\nsetting you want to keep. Resources are not listed here at all: they\nare discovered from the directories on disk.",
95
+ updateWarning: "WARNING: The package identifier names the game everywhere it is published.\nA new identifier is a new game to a runtime, not a new version of this one.",
96
+ patchExample: '[{"op":"replace","path":"/maxTicks","value":50}]'
97
+ },
98
+ configureNewOptions: (cmd) => {
99
+ cmd.option("--empty", "skip the starter game: package files and CLAUDE.md only").option(
100
+ "--skip-install",
101
+ "skip running pnpm install after creating the package"
102
+ );
103
+ }
104
+ },
105
+ {
106
+ type: "capability",
107
+ create: createCapability,
108
+ update: { kind: "identified", run: updateCapability },
109
+ delete: { kind: "identified", run: deleteCapability },
110
+ help: {
111
+ typeLabel: "capability",
112
+ sampleId: "price",
113
+ newExtraExamples: " # Create a shared capability without writing JSON\n $ seriousgaming-sdk new capability --scope shared",
114
+ deleteSummary: "Deletes the capability and removes every read and write of it, from\nwhichever resources declared them."
115
+ },
116
+ configureNewOptions: (cmd) => {
117
+ cmd.option(
118
+ "--scope <scope>",
119
+ "cross-team visibility: 'team' (default), 'team-readable', 'shared' or 'private'"
120
+ );
121
+ }
122
+ },
123
+ {
124
+ type: "settings",
125
+ create: createSettings,
126
+ update: { kind: "identified", run: updateSettings },
127
+ delete: { kind: "identified", run: deleteSettings },
128
+ help: {
129
+ typeLabel: "settings resource",
130
+ sampleId: "demand",
131
+ intro: 'Named, read-only parameters: a schema whose every property declares a\ndefault. A resource reads it by listing it in its "settings", a\nsetup UI or scenario editor edits it by listing it in "configures", and a\nscenario overrides it under "settings", keyed by its identifier.',
132
+ deleteSummary: `Deletes the settings and removes every reference to them: from each
133
+ resource's "settings", the setup UI's and scenario editor's "configures",
134
+ and each scenario's "settings".`
135
+ }
136
+ },
137
+ {
138
+ type: "engine",
139
+ create: createEngine,
140
+ update: { kind: "unidentified", run: updateEngine },
141
+ delete: { kind: "unidentified", run: deleteEngine },
142
+ updateSupportsPatch: true,
143
+ help: {
144
+ typeLabel: "engine",
145
+ article: "an",
146
+ newExtraExamples: " # Scaffold an engine that runs once across every team\n $ seriousgaming-sdk new engine --aggregate"
147
+ },
148
+ configureNewOptions: (cmd) => {
149
+ cmd.option(
150
+ "--aggregate",
151
+ "scaffold logic exporting InitAggregate and RunAggregate, for an engine that runs once across all teams"
152
+ );
153
+ }
154
+ },
155
+ {
156
+ type: "ui",
157
+ create: createUserInterface,
158
+ update: { kind: "unidentified", run: updateUserInterface },
159
+ delete: { kind: "unidentified", run: deleteUserInterface },
160
+ updateSupportsPatch: true,
161
+ help: {
162
+ typeLabel: "user interface"
163
+ }
164
+ },
165
+ {
166
+ type: "setup",
167
+ create: createSetup,
168
+ update: { kind: "unidentified", run: updateSetup },
169
+ delete: { kind: "unidentified", run: deleteSetup },
170
+ updateSupportsPatch: true,
171
+ help: {
172
+ typeLabel: "setup user interface",
173
+ intro: "A small form a facilitator fills in when creating a session. It names\nthe settings resources it configures, and its changes apply to that\nsession only. A game with one holds each session at a setup step until\nPlay."
174
+ }
175
+ },
176
+ {
177
+ type: "scenario_editor",
178
+ create: createScenarioEditor,
179
+ update: { kind: "unidentified", run: updateScenarioEditor },
180
+ delete: { kind: "unidentified", run: deleteScenarioEditor },
181
+ updateSupportsPatch: true,
182
+ help: {
183
+ typeLabel: "scenario editor",
184
+ intro: "An authoring screen for building a new scenario, used at any time and\nwith no session. It names the settings resources it configures; the host\nsaves what it edits as a scenario. Optional: customScenarios.supported is\nwhat switches custom scenarios on."
185
+ }
186
+ },
187
+ {
188
+ type: "tick_controller",
189
+ create: createTickController,
190
+ update: { kind: "unidentified", run: updateTickController },
191
+ delete: { kind: "unidentified", run: deleteTickController },
192
+ updateSupportsPatch: true,
193
+ help: {
194
+ typeLabel: "tick controller"
195
+ }
196
+ },
197
+ {
198
+ type: "session",
199
+ create: createSessionUserInterface,
200
+ update: { kind: "unidentified", run: updateSessionUserInterface },
201
+ delete: { kind: "unidentified", run: deleteSessionUserInterface },
202
+ updateSupportsPatch: true,
203
+ help: {
204
+ typeLabel: "session user interface",
205
+ intro: "A facilitator-facing UI for modifying a live session's game context."
206
+ }
207
+ },
208
+ {
209
+ type: "waiting_room",
210
+ create: createWaitingRoomUserInterface,
211
+ update: { kind: "unidentified", run: updateWaitingRoomUserInterface },
212
+ delete: { kind: "unidentified", run: deleteWaitingRoomUserInterface },
213
+ updateSupportsPatch: true,
214
+ help: {
215
+ typeLabel: "waiting room user interface",
216
+ intro: "The holding screen players see instead of the game UIs while the\nsession's waiting room is open. It is a player user interface in a\ndifferent display context: the same reads, writes, endpoints, hooks and\ncallbacks are available, and it renders under UserInterfaceWrapper."
217
+ }
218
+ },
219
+ {
220
+ type: "presentation",
221
+ create: createPresentation,
222
+ update: { kind: "unidentified", run: updatePresentation },
223
+ delete: { kind: "unidentified", run: deletePresentation },
224
+ updateSupportsPatch: true,
225
+ help: {
226
+ typeLabel: "presentation",
227
+ intro: "The facilitator's slide deck. It is read-only, renders with or without\na session, and exports to PDF, PowerPoint and PNG."
228
+ }
229
+ },
230
+ {
231
+ type: "scenario",
232
+ create: createScenario,
233
+ update: { kind: "identified", run: updateScenario },
234
+ delete: { kind: "identified", run: deleteScenario },
235
+ help: {
236
+ typeLabel: "scenario",
237
+ sampleId: "hard_mode",
238
+ patchExample: '[{"op":"replace","path":"/definition/locales/en/name","value":"Hard Mode v2"}]'
239
+ }
240
+ },
241
+ {
242
+ type: "guide",
243
+ create: createFacilitatorGuide,
244
+ update: { kind: "unidentified", run: updateFacilitatorGuide },
245
+ delete: { kind: "unidentified", run: deleteFacilitatorGuide },
246
+ updateSupportsPatch: true,
247
+ help: {
248
+ typeLabel: "facilitator guide",
249
+ patchExample: '[{"op":"replace","path":"/definition/locales/en/name","value":"Cheat sheet"}]',
250
+ deleteSummary: "Deletes the facilitator guide, including its content and assets."
251
+ }
252
+ },
253
+ {
254
+ type: "hook",
255
+ create: createHook,
256
+ update: { kind: "identified", run: updateHook },
257
+ delete: { kind: "identified", run: deleteHook },
258
+ help: {
259
+ typeLabel: "hook",
260
+ sampleId: "assignroles",
261
+ intro: "A hook reacts to an out-of-tick lifecycle signal (e.g. participantJoin).\nEach hook subscribes to exactly one signal and runs after the runtime\napplies the change."
262
+ }
263
+ },
264
+ {
265
+ type: "validator",
266
+ create: createValidator,
267
+ update: { kind: "identified", run: updateValidator },
268
+ delete: { kind: "identified", run: deleteValidator },
269
+ help: {
270
+ typeLabel: "validator",
271
+ sampleId: "decisionlimit",
272
+ intro: "A validator is a read-only check that runs on UI-submitted state\nmutations before they are applied. Validators reject-only; they never\nmodify the proposed state. A validator runs when a mutation changes a\ncapability it reads (one that reads nothing runs on every mutation), and\nevery failure is collected and returned to the UI."
273
+ }
274
+ },
275
+ {
276
+ type: "endpoint",
277
+ create: createEndpoint,
278
+ update: { kind: "identified", run: updateEndpoint },
279
+ delete: { kind: "identified", run: deleteEndpoint },
280
+ help: {
281
+ typeLabel: "endpoint",
282
+ article: "an",
283
+ sampleId: "summarise",
284
+ intro: "An endpoint is a named, server-side handler that user interfaces invoke\nby identifier. The author owns the request and response schemas; the UI\npasses structured parameters and receives a typed response. An endpoint\nthat declares writes may also change those capabilities, by returning\n{ response, capabilities }; it may invoke declared runtime callbacks\n(e.g. generateText, writeBlob).",
285
+ note: 'Note: The endpoint is declared by user interfaces that may call it:\n "endpoints": ["summarise"]',
286
+ deleteSummary: "Deletes the endpoint, deregisters it from the package, and removes\nreferences to it from user interfaces."
287
+ }
288
+ }
289
+ ];
290
+ var RESOURCE_DESCRIPTORS_BY_TYPE = new Map(
291
+ RESOURCE_DESCRIPTORS.map((descriptor) => [descriptor.type, descriptor])
292
+ );
293
+ function supportedTypes(command) {
294
+ return RESOURCE_DESCRIPTORS.filter(
295
+ (descriptor) => command === "new" ? descriptor.create !== void 0 : command === "delete" ? descriptor.delete !== void 0 : true
296
+ ).map((descriptor) => descriptor.type).join(", ");
297
+ }
298
+
299
+ export {
300
+ lazy,
301
+ RESOURCE_DESCRIPTORS,
302
+ RESOURCE_DESCRIPTORS_BY_TYPE,
303
+ supportedTypes
304
+ };
@@ -0,0 +1,99 @@
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
+ updateUserInterfaceFiles
14
+ } from "./cli-FYINNRML.js";
15
+ import "./cli-IUS2YCD3.js";
16
+ import "./cli-QUNIRH7A.js";
17
+ import "./cli-BYJWFFCF.js";
18
+ import {
19
+ loadPackageContext
20
+ } from "./cli-XSVGKI3R.js";
21
+ import "./cli-MBNMPVDC.js";
22
+ import "./cli-GFBGYFYD.js";
23
+ import {
24
+ operationError,
25
+ printOperationResult,
26
+ regenerateTypes
27
+ } from "./cli-UELGBQG7.js";
28
+ import "./cli-4BV45LBH.js";
29
+ import "./cli-4AKVLEC4.js";
30
+ import "./cli-VCKOC2EV.js";
31
+ import "./cli-E2NLWIFE.js";
32
+ import "./cli-25RWY5BQ.js";
33
+ import "./cli-QWQMPCL6.js";
34
+ import {
35
+ validateSDKUserInterface
36
+ } from "./cli-SMFSZF2G.js";
37
+ import "./cli-F2D4GGUA.js";
38
+ import {
39
+ logger
40
+ } from "./cli-4YB3ROVR.js";
41
+ import {
42
+ CliError
43
+ } from "./cli-N6H6T2E2.js";
44
+
45
+ // cli/commands/resources/ui/update.ts
46
+ async function updateUserInterface(definitionInput, options) {
47
+ logger.info("\nUpdating user interface...\n");
48
+ const identifier = "ui";
49
+ loadPackageContext(options.workingDir);
50
+ let jsonDefinition = null;
51
+ if (options.patch) {
52
+ jsonDefinition = resolvePatchedDefinition({
53
+ patch: options.patch,
54
+ workingDir: options.workingDir,
55
+ type: "ui",
56
+ identifier,
57
+ resourceLabel: "User interface"
58
+ });
59
+ } else {
60
+ const inputSource = await resolveInputSource(definitionInput, options.file);
61
+ if (inputSource.kind === "json") jsonDefinition = inputSource.json;
62
+ }
63
+ if (jsonDefinition) {
64
+ const uiInput = readAuthoredBundle({
65
+ json: jsonDefinition,
66
+ type: "ui",
67
+ command: "update",
68
+ validate: validateSDKUserInterface,
69
+ identifier,
70
+ validationHint: "Full replacement requires all fields to be specified."
71
+ });
72
+ logger.info("Updating user interface files...\n");
73
+ const result = updateUserInterfaceFiles({
74
+ packagePath: options.workingDir,
75
+ oldIdentifier: identifier,
76
+ newDefinition: uiInput.definition
77
+ });
78
+ if (!result.success) {
79
+ throw operationError(result, "Failed to update user interface files");
80
+ }
81
+ logger.success("User interface updated successfully!");
82
+ printOperationResult(result);
83
+ await regenerateTypes(options.workingDir);
84
+ logger.info("");
85
+ return;
86
+ }
87
+ throw new CliError(
88
+ "USAGE_MISSING_INPUT",
89
+ `A user interface takes no interactive input: a game holds one, so there is
90
+ nothing to name and nothing to pick.
91
+
92
+ Edit it with a definition or a patch:
93
+ $ seriousgaming-sdk update user-interface '{"definition":{...}}'
94
+ $ seriousgaming-sdk update user-interface --patch '[...]'`
95
+ );
96
+ }
97
+ export {
98
+ updateUserInterface
99
+ };
@@ -0,0 +1,153 @@
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
+ createHookFiles
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
+ input,
34
+ select
35
+ } from "./cli-ZTWOE3ZT.js";
36
+ import "./cli-4BV45LBH.js";
37
+ import "./cli-4AKVLEC4.js";
38
+ import "./cli-VCKOC2EV.js";
39
+ import "./cli-E2NLWIFE.js";
40
+ import "./cli-25RWY5BQ.js";
41
+ import "./cli-QWQMPCL6.js";
42
+ import {
43
+ validateSDKHook
44
+ } from "./cli-SMFSZF2G.js";
45
+ import "./cli-F2D4GGUA.js";
46
+ import {
47
+ logger
48
+ } from "./cli-4YB3ROVR.js";
49
+ import "./cli-N6H6T2E2.js";
50
+
51
+ // cli/commands/resources/hook/new.ts
52
+ var HOOK_SIGNALS = ["participantJoin", "participantMove"];
53
+ async function createHook(definitionInput, options) {
54
+ logger.info("\nCreating new hook...\n");
55
+ loadPackageContext(options.workingDir);
56
+ const inputSource = await resolveInputSource(definitionInput, options.file);
57
+ const jsonDefinition = inputSource.kind === "json" ? inputSource.json : null;
58
+ if (jsonDefinition) {
59
+ const hookInput = readAuthoredBundle({
60
+ json: jsonDefinition,
61
+ type: "hook",
62
+ command: "new",
63
+ validate: validateSDKHook
64
+ });
65
+ const identifier2 = hookInput.definition.identifier;
66
+ const signal2 = hookInput.definition.signal;
67
+ const reads2 = hookInput.definition.reads || [];
68
+ const writes2 = hookInput.definition.writes || [];
69
+ const uses = hookInput.definition.uses || [];
70
+ const settings2 = hookInput.definition.settings || [];
71
+ logger.info("Creating hook files...\n");
72
+ const result2 = await createHookFiles({
73
+ packagePath: options.workingDir,
74
+ identifier: identifier2,
75
+ signal: signal2,
76
+ reads: reads2,
77
+ writes: writes2,
78
+ uses,
79
+ settings: settings2
80
+ });
81
+ if (!result2.success) {
82
+ throw operationError(result2, "Failed to create hook files");
83
+ }
84
+ logger.success("Hook created successfully!");
85
+ printOperationResult(result2);
86
+ await generateTypes(options.workingDir);
87
+ return;
88
+ }
89
+ logger.info("No JSON definition provided. Starting interactive mode...\n");
90
+ const shortIdentifier = await input({
91
+ message: 'Hook identifier (short name, e.g., "assignroles"):',
92
+ validate: (value) => {
93
+ if (!value.trim()) return "Identifier is required";
94
+ if (value.includes(".")) {
95
+ return 'In interactive mode, use short identifier (e.g., "assignroles" instead of "com.example.assignroles")';
96
+ }
97
+ if (!/^[a-z][a-z0-9_]*$/.test(value)) {
98
+ return "Identifier must start with lowercase letter and contain only lowercase letters, numbers, and underscores";
99
+ }
100
+ return true;
101
+ }
102
+ });
103
+ const identifier = shortIdentifier.trim();
104
+ const signal = await select({
105
+ message: "Lifecycle signal this hook fires on:",
106
+ choices: HOOK_SIGNALS.map((s) => ({ name: s, value: s }))
107
+ });
108
+ const availableCapabilities = loadResourceIdentifiers(options.workingDir, "capability");
109
+ const reads = [];
110
+ const writes = [];
111
+ if (availableCapabilities.length > 0) {
112
+ const readCapabilities = await checkbox({
113
+ message: "Capabilities this hook reads from:",
114
+ choices: availableCapabilities.map((id) => ({ name: id, value: id })),
115
+ pageSize: 10
116
+ });
117
+ reads.push(...readCapabilities);
118
+ const remainingForWrites = availableCapabilities.filter(
119
+ (id) => !readCapabilities.includes(id)
120
+ );
121
+ if (remainingForWrites.length > 0) {
122
+ const writeCapabilities = await checkbox({
123
+ message: "Capabilities this hook writes to:",
124
+ choices: remainingForWrites.map((id) => ({ name: id, value: id })),
125
+ pageSize: 10
126
+ });
127
+ writes.push(...writeCapabilities);
128
+ }
129
+ logger.info("");
130
+ }
131
+ const settings = await promptForSettings(options.workingDir, "hook");
132
+ logger.info("Creating hook files...\n");
133
+ const result = await createHookFiles({
134
+ packagePath: options.workingDir,
135
+ identifier,
136
+ signal,
137
+ reads,
138
+ writes,
139
+ settings
140
+ });
141
+ if (!result.success) {
142
+ throw operationError(result, "Failed to create hook files");
143
+ }
144
+ logger.success("Hook created successfully!");
145
+ printOperationResult(result);
146
+ await generateTypes(options.workingDir);
147
+ logger.info("Next steps:");
148
+ logger.info(` 1. Edit the hook logic: hooks/${identifier}/logic/logic.ts`);
149
+ logger.info(` 2. Run "${BUILD_COMMAND}" to build your package`);
150
+ }
151
+ export {
152
+ createHook
153
+ };