castle-web-cli 0.4.232 → 0.4.234

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 (587) hide show
  1. package/dist/agent-failures.d.ts +8 -0
  2. package/dist/agent-failures.js +19 -2
  3. package/dist/agent-prompts.d.ts +1 -1
  4. package/dist/agent-prompts.js +10 -3
  5. package/dist/agent.d.ts +64 -3
  6. package/dist/agent.js +170 -81
  7. package/dist/api.d.ts +11 -0
  8. package/dist/api.js +43 -0
  9. package/dist/bundle.d.ts +64 -0
  10. package/dist/bundle.js +558 -2
  11. package/dist/castle-host/host.d.ts +18 -2
  12. package/dist/castle-host/host.js +844 -39
  13. package/dist/castleJson.d.ts +23 -2
  14. package/dist/castleJson.js +46 -2
  15. package/dist/check.d.ts +3 -1
  16. package/dist/check.js +20 -3
  17. package/dist/chunkLoader.d.ts +3 -0
  18. package/dist/chunkLoader.js +111 -0
  19. package/dist/devParty.d.ts +26 -0
  20. package/dist/devParty.js +231 -0
  21. package/dist/devSaveStorage.js +4 -0
  22. package/dist/devSessionStorage.js +50 -2
  23. package/dist/devSocial.d.ts +24 -0
  24. package/dist/devSocial.js +70 -0
  25. package/dist/ide.d.ts +2 -0
  26. package/dist/ide.js +119 -15
  27. package/dist/importPinMismatch.d.ts +22 -0
  28. package/dist/importPinMismatch.js +77 -0
  29. package/dist/importRegression.js +3 -15
  30. package/dist/imports.d.ts +10 -3
  31. package/dist/imports.js +88 -20
  32. package/dist/index.js +11 -4
  33. package/dist/init.js +1 -1
  34. package/dist/platformDoc.js +22 -0
  35. package/dist/routerFences.d.ts +5 -0
  36. package/dist/routerFences.js +12 -2
  37. package/dist/save-deck.d.ts +25 -1
  38. package/dist/save-deck.js +178 -9
  39. package/dist/serve.js +32 -11
  40. package/dist/shell/assets/{index-D2tWM896.js → index-DulbYIJm.js} +97 -97
  41. package/dist/shell/assets/index-MVLfNYd9.css +1 -0
  42. package/dist/shell/index.html +2 -2
  43. package/dist/taskSteer.d.ts +13 -0
  44. package/dist/taskSteer.js +22 -2
  45. package/dist/vitePlugins.d.ts +2 -1
  46. package/dist/vitePlugins.js +13 -0
  47. package/kits/base/castle.json +1 -1
  48. package/kits/base/package-lock.json +1 -1
  49. package/kits/base/sdk/README.md +339 -5
  50. package/kits/base/sdk/avatar.d.ts +6 -2
  51. package/kits/base/sdk/avatar.js +12 -4
  52. package/kits/base/sdk/castle.d.ts +7 -3
  53. package/kits/base/sdk/castle.js +2 -0
  54. package/kits/base/sdk/commands.d.ts +176 -1
  55. package/kits/base/sdk/commands.js +3 -0
  56. package/kits/base/sdk/display.d.ts +3 -0
  57. package/kits/base/sdk/display.js +9 -3
  58. package/kits/base/sdk/hub.d.ts +37 -6
  59. package/kits/base/sdk/hub.js +63 -4
  60. package/kits/base/sdk/multiplayer.d.ts +7 -1
  61. package/kits/base/sdk/multiplayer.js +148 -32
  62. package/kits/base/sdk/multiplayerProtocol.d.ts +2 -0
  63. package/kits/base/sdk/party.d.ts +23 -0
  64. package/kits/base/sdk/party.js +91 -0
  65. package/kits/base/sdk/reconnectBudget.d.ts +23 -0
  66. package/kits/base/sdk/reconnectBudget.js +96 -0
  67. package/kits/base/sdk/save.d.ts +38 -1
  68. package/kits/base/sdk/save.js +81 -7
  69. package/kits/base/sdk/server/hub.d.ts +117 -0
  70. package/kits/base/sdk/server/hub.js +119 -2
  71. package/kits/base/sdk/server/platformHandle.d.ts +43 -1
  72. package/kits/base/sdk/server/storage.d.ts +17 -0
  73. package/kits/base/sdk/server/storage.js +65 -3
  74. package/kits/base/sdk/server/wrapper.d.ts +43 -6
  75. package/kits/base/sdk/server/wrapper.js +93 -9
  76. package/kits/base/sdk/social.d.ts +9 -0
  77. package/kits/base/sdk/social.js +5 -0
  78. package/kits/hub-game/CLAUDE.md +451 -13
  79. package/kits/hub-game/README.md +63 -0
  80. package/kits/hub-game/blueprints/avatar-10.scene +28 -0
  81. package/kits/hub-game/blueprints/avatar-11.scene +28 -0
  82. package/kits/hub-game/blueprints/avatar-12.scene +28 -0
  83. package/kits/hub-game/blueprints/avatar-13.scene +28 -0
  84. package/kits/hub-game/blueprints/avatar-14.scene +28 -0
  85. package/kits/hub-game/blueprints/avatar-15.scene +28 -0
  86. package/kits/hub-game/blueprints/avatar-4.scene +28 -0
  87. package/kits/hub-game/blueprints/avatar-5.scene +28 -0
  88. package/kits/hub-game/blueprints/avatar-6.scene +28 -0
  89. package/kits/hub-game/blueprints/avatar-7.scene +28 -0
  90. package/kits/hub-game/blueprints/avatar-8.scene +28 -0
  91. package/kits/hub-game/blueprints/avatar-9.scene +28 -0
  92. package/kits/hub-game/castle.json +5 -5
  93. package/kits/hub-game/code/client/act.js +312 -0
  94. package/kits/hub-game/code/client/actionLayout.js +147 -0
  95. package/kits/hub-game/code/client/actionOverflow.js +556 -0
  96. package/kits/hub-game/code/client/actorBudget.js +47 -0
  97. package/kits/hub-game/code/client/arrivalCamera.js +50 -0
  98. package/kits/hub-game/code/client/askSlot.js +117 -0
  99. package/kits/hub-game/code/client/attention.js +11 -2
  100. package/kits/hub-game/code/client/avatar.js +311 -35
  101. package/kits/hub-game/code/client/avatarCap.js +228 -0
  102. package/kits/hub-game/code/client/avatarColors.js +70 -0
  103. package/kits/hub-game/code/client/avatarFaces.js +21 -0
  104. package/kits/hub-game/code/client/avatarShare.js +253 -0
  105. package/kits/hub-game/code/client/backVisibility.js +13 -0
  106. package/kits/hub-game/code/client/ballot.js +472 -0
  107. package/kits/hub-game/code/client/build.js +38 -0
  108. package/kits/hub-game/code/client/chat.js +41 -5
  109. package/kits/hub-game/code/client/chatModeration.js +5 -0
  110. package/kits/hub-game/code/client/chrome.js +2144 -160
  111. package/kits/hub-game/code/client/companion.js +716 -0
  112. package/kits/hub-game/code/client/companionDress.js +99 -0
  113. package/kits/hub-game/code/client/crowdNames.js +241 -0
  114. package/kits/hub-game/code/client/decor.js +515 -0
  115. package/kits/hub-game/code/client/defaultEnvironment.js +194 -0
  116. package/kits/hub-game/code/client/doorErrors.js +39 -0
  117. package/kits/hub-game/code/client/earned.js +131 -0
  118. package/kits/hub-game/code/client/emoteBubble.js +75 -0
  119. package/kits/hub-game/code/client/fall.js +18 -0
  120. package/kits/hub-game/code/client/farAvatars.js +233 -0
  121. package/kits/hub-game/code/client/firstJoin.js +9 -2
  122. package/kits/hub-game/code/client/fpsTelemetry.js +50 -0
  123. package/kits/hub-game/code/client/frameBatch.js +5 -0
  124. package/kits/hub-game/code/client/grab.js +368 -29
  125. package/kits/hub-game/code/client/hookLayer.js +385 -20
  126. package/kits/hub-game/code/client/hudCopy.js +51 -0
  127. package/kits/hub-game/code/client/hudRate.js +20 -0
  128. package/kits/hub-game/code/client/idle.js +177 -24
  129. package/kits/hub-game/code/client/interestCap.js +81 -0
  130. package/kits/hub-game/code/client/invites.js +231 -0
  131. package/kits/hub-game/code/client/joinError.js +9 -0
  132. package/kits/hub-game/code/client/keys.js +36 -0
  133. package/kits/hub-game/code/client/labelsNear.js +234 -0
  134. package/kits/hub-game/code/client/landscapeLayout.js +17 -0
  135. package/kits/hub-game/code/client/layoutCache.js +264 -0
  136. package/kits/hub-game/code/client/loadTelemetry.js +20 -0
  137. package/kits/hub-game/code/client/loadingCover.js +148 -0
  138. package/kits/hub-game/code/client/loadingEntry.js +8 -0
  139. package/kits/hub-game/code/client/menuIcons.js +34 -0
  140. package/kits/hub-game/code/client/menuRows.js +43 -0
  141. package/kits/hub-game/code/client/modelReady.js +7 -0
  142. package/kits/hub-game/code/client/pack.js +6 -2
  143. package/kits/hub-game/code/client/packFormat.js +3 -3
  144. package/kits/hub-game/code/client/padCueArrival.js +23 -0
  145. package/kits/hub-game/code/client/padCues.js +112 -0
  146. package/kits/hub-game/code/client/padOccupancy.js +88 -0
  147. package/kits/hub-game/code/client/padReadability.js +26 -0
  148. package/kits/hub-game/code/client/padRings.js +69 -0
  149. package/kits/hub-game/code/client/pushVisit.js +14 -0
  150. package/kits/hub-game/code/client/quality.js +205 -0
  151. package/kits/hub-game/code/client/qualityEntry.js +55 -0
  152. package/kits/hub-game/code/client/rehello.js +167 -0
  153. package/kits/hub-game/code/client/safeLayout.js +338 -0
  154. package/kits/hub-game/code/client/safeStyle.js +42 -0
  155. package/kits/hub-game/code/client/say.js +12 -3
  156. package/kits/hub-game/code/client/shot.js +146 -0
  157. package/kits/hub-game/code/client/shotFit.js +56 -0
  158. package/kits/hub-game/code/client/signIn.js +28 -0
  159. package/kits/hub-game/code/client/sound.js +63 -8
  160. package/kits/hub-game/code/client/soundscape.js +1151 -0
  161. package/kits/hub-game/code/client/soundscapeActions.js +99 -0
  162. package/kits/hub-game/code/client/soundscapeAmbience.js +453 -0
  163. package/kits/hub-game/code/client/soundscapeBaked.js +143 -0
  164. package/kits/hub-game/code/client/soundscapeBusker.js +217 -0
  165. package/kits/hub-game/code/client/soundscapeCourt.js +200 -0
  166. package/kits/hub-game/code/client/soundscapeCrowd.js +331 -0
  167. package/kits/hub-game/code/client/soundscapeCues.js +362 -0
  168. package/kits/hub-game/code/client/soundscapeMap.js +181 -0
  169. package/kits/hub-game/code/client/soundscapeMarket.js +176 -0
  170. package/kits/hub-game/code/client/soundscapeMusic.js +126 -0
  171. package/kits/hub-game/code/client/soundscapeMusicEngine.js +460 -0
  172. package/kits/hub-game/code/client/soundscapeSimlish.js +737 -0
  173. package/kits/hub-game/code/client/soundscapeSongs.js +127 -0
  174. package/kits/hub-game/code/client/soundscapeSongsRound3.js +63 -0
  175. package/kits/hub-game/code/client/soundscapeSynthesis.js +168 -0
  176. package/kits/hub-game/code/client/soundscapeUi.js +211 -0
  177. package/kits/hub-game/code/client/soundscapeVoice.js +1209 -0
  178. package/kits/hub-game/code/client/soundscapeWaves.js +206 -0
  179. package/kits/hub-game/code/client/spin.js +101 -0
  180. package/kits/hub-game/code/client/state.js +162 -1
  181. package/kits/hub-game/code/client/stuck.js +259 -0
  182. package/kits/hub-game/code/client/talk.js +714 -59
  183. package/kits/hub-game/code/client/tiers.js +543 -52
  184. package/kits/hub-game/code/client/toastBand.js +37 -0
  185. package/kits/hub-game/code/client/together.js +39 -2
  186. package/kits/hub-game/code/client/visibility.js +43 -0
  187. package/kits/hub-game/code/client/weakestLookBake.js +92 -0
  188. package/kits/hub-game/code/client/weakestTier.js +295 -0
  189. package/kits/hub-game/code/client/wear.js +461 -170
  190. package/kits/hub-game/code/client/worldLabels.js +241 -0
  191. package/kits/hub-game/code/client/yours.js +200 -0
  192. package/kits/hub-game/code/companionSpec.js +45 -0
  193. package/kits/hub-game/code/npcDisplayText.js +55 -0
  194. package/kits/hub-game/code/privateText.js +7 -0
  195. package/kits/hub-game/code/server/act.js +124 -0
  196. package/kits/hub-game/code/server/actions.js +138 -0
  197. package/kits/hub-game/code/server/actors.js +11 -2
  198. package/kits/hub-game/code/server/analytics.js +83 -0
  199. package/kits/hub-game/code/server/anonymousEntry.js +49 -0
  200. package/kits/hub-game/code/server/arrivalPose.js +36 -0
  201. package/kits/hub-game/code/server/ask.js +155 -0
  202. package/kits/hub-game/code/server/ballot.js +539 -0
  203. package/kits/hub-game/code/server/cells.js +100 -0
  204. package/kits/hub-game/code/server/companion.js +107 -0
  205. package/kits/hub-game/code/server/cues.js +70 -0
  206. package/kits/hub-game/code/server/decor.js +269 -0
  207. package/kits/hub-game/code/server/doorAnalytics.js +52 -0
  208. package/kits/hub-game/code/server/earned.js +478 -0
  209. package/kits/hub-game/code/server/frameBatch.js +183 -0
  210. package/kits/hub-game/code/server/friendBests.js +166 -0
  211. package/kits/hub-game/code/server/friendsAmong.js +272 -0
  212. package/kits/hub-game/code/server/history.js +7 -0
  213. package/kits/hub-game/code/server/hub.js +2510 -95
  214. package/kits/hub-game/code/server/idle.js +60 -12
  215. package/kits/hub-game/code/server/index.js +28 -6
  216. package/kits/hub-game/code/server/invites.js +19 -0
  217. package/kits/hub-game/code/server/labels.js +36 -2
  218. package/kits/hub-game/code/server/loadAbandon.js +106 -0
  219. package/kits/hub-game/code/server/manifest.js +586 -7
  220. package/kits/hub-game/code/server/menu.js +161 -0
  221. package/kits/hub-game/code/server/npcs.js +1025 -113
  222. package/kits/hub-game/code/server/observe.js +408 -0
  223. package/kits/hub-game/code/server/padOccupancy.js +85 -0
  224. package/kits/hub-game/code/server/party.js +2 -2
  225. package/kits/hub-game/code/server/players.js +30 -0
  226. package/kits/hub-game/code/server/resumePose.js +152 -0
  227. package/kits/hub-game/code/server/say.js +1 -1
  228. package/kits/hub-game/code/server/shot.js +110 -0
  229. package/kits/hub-game/code/server/standing.js +123 -0
  230. package/kits/hub-game/code/server/storageLimit.js +187 -0
  231. package/kits/hub-game/code/server/vis.js +175 -0
  232. package/kits/hub-game/code/server/wear.js +12 -0
  233. package/kits/hub-game/code/server/yours.js +59 -0
  234. package/kits/hub-game/code/shared/act.js +35 -0
  235. package/kits/hub-game/code/shared/cues.js +9 -0
  236. package/kits/hub-game/code/shared/danceIdle.js +28 -0
  237. package/kits/hub-game/code/shared/decor.js +41 -0
  238. package/kits/hub-game/code/shared/loadStages.js +12 -0
  239. package/kits/hub-game/code/shared/quality.js +74 -0
  240. package/kits/hub-game/code/shared/say.js +2 -0
  241. package/kits/hub-game/code/shared/shot.js +53 -0
  242. package/kits/hub-game/code/shared/spin.js +57 -0
  243. package/kits/hub-game/code/systems/hub.js +1753 -202
  244. package/kits/hub-game/docs/analytics.md +279 -0
  245. package/kits/hub-game/docs/content-pack.md +1 -1
  246. package/kits/hub-game/docs/contract.md +3475 -77
  247. package/kits/hub-game/docs/home-pieces.md +71 -0
  248. package/kits/hub-game/docs/observed-progress.md +252 -0
  249. package/kits/hub-game/main.jsx +2 -0
  250. package/kits/hub-game/models/avatar-10.pxmodel +28 -0
  251. package/kits/hub-game/models/avatar-11.pxmodel +28 -0
  252. package/kits/hub-game/models/avatar-12.pxmodel +27 -0
  253. package/kits/hub-game/models/avatar-13.pxmodel +24 -0
  254. package/kits/hub-game/models/avatar-14.pxmodel +29 -0
  255. package/kits/hub-game/models/avatar-15.pxmodel +24 -0
  256. package/kits/hub-game/models/avatar-4.pxmodel +29 -0
  257. package/kits/hub-game/models/avatar-5.pxmodel +27 -0
  258. package/kits/hub-game/models/avatar-6.pxmodel +26 -0
  259. package/kits/hub-game/models/avatar-7.pxmodel +25 -0
  260. package/kits/hub-game/models/avatar-8.pxmodel +24 -0
  261. package/kits/hub-game/models/avatar-9.pxmodel +30 -0
  262. package/kits/hub-game/models/earned/badge-round.pxmodel +100 -0
  263. package/kits/hub-game/models/earned/badge-shield.pxmodel +117 -0
  264. package/kits/hub-game/models/earned/badge-star.pxmodel +87 -0
  265. package/kits/hub-game/models/earned/belt-plain.pxmodel +72 -0
  266. package/kits/hub-game/models/earned/held-ball.pxmodel +43 -0
  267. package/kits/hub-game/models/earned/held-lantern.pxmodel +85 -0
  268. package/kits/hub-game/models/earned/held-net.pxmodel +57 -0
  269. package/kits/hub-game/models/earned/held-trophy.pxmodel +109 -0
  270. package/kits/hub-game/models/earned/pin-round.pxmodel +62 -0
  271. package/kits/hub-game/models/earned/sash-plain.pxmodel +66 -0
  272. package/kits/hub-game/models/earned/square/belt-plain.pxmodel +104 -0
  273. package/kits/hub-game/models/earned/square/sash-plain.pxmodel +98 -0
  274. package/kits/hub-game/models/hats/bat-clip.pxmodel +206 -0
  275. package/kits/hub-game/models/hats/beekeeper.pxmodel +149 -0
  276. package/kits/hub-game/models/hats/cap.pxmodel +162 -0
  277. package/kits/hub-game/models/hats/captain.pxmodel +178 -0
  278. package/kits/hub-game/models/hats/crooked-top.pxmodel +172 -0
  279. package/kits/hub-game/models/hats/flower-crown.pxmodel +451 -0
  280. package/kits/hub-game/models/hats/foam-crown.pxmodel +179 -0
  281. package/kits/hub-game/models/hats/lantern.pxmodel +230 -0
  282. package/kits/hub-game/models/hats/laurel.pxmodel +533 -0
  283. package/kits/hub-game/models/hats/lighthouse.pxmodel +96 -0
  284. package/kits/hub-game/models/hats/sailor.pxmodel +141 -0
  285. package/kits/hub-game/models/hats/souwester.pxmodel +131 -0
  286. package/kits/hub-game/models/hats/straw.pxmodel +139 -0
  287. package/kits/hub-game/models/hats/sunflower.pxmodel +406 -0
  288. package/kits/hub-game/models/hats/sweatband.pxmodel +112 -0
  289. package/kits/hub-game/models/hats/witch.pxmodel +147 -0
  290. package/kits/hub-game/package-lock.json +10 -1
  291. package/kits/hub-game/package.json +6 -2
  292. package/kits/hub-game/play/player.js +142 -0
  293. package/kits/hub-game/play/registry.js +47 -0
  294. package/kits/hub-game/play.jsx +37 -0
  295. package/kits/hub-game/scripts/check.mjs +117 -16
  296. package/kits/hub-game/scripts/companion-follower-wire.json +1 -0
  297. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +132 -0
  298. package/kits/hub-game/scripts/fixtures/decor-keyless.json +293 -0
  299. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +26 -0
  300. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +123 -0
  301. package/kits/hub-game/scripts/fixtures/interest-legacy.json +385 -0
  302. package/kits/hub-game/scripts/fixtures/npc-notes-v1.77.jsonl +4 -0
  303. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -0
  304. package/kits/hub-game/scripts/gen-avatars.mjs +933 -16
  305. package/kits/hub-game/scripts/gen-earned.mjs +285 -0
  306. package/kits/hub-game/scripts/gen-hats.mjs +827 -0
  307. package/kits/hub-game/scripts/grab.before-orbit.mjs +400 -0
  308. package/kits/hub-game/scripts/pose-storage-fixture.mjs +46 -0
  309. package/kits/hub-game/scripts/soundscape-wave-analysis.mjs +125 -0
  310. package/kits/hub-game/scripts/test-act-client.mjs +186 -0
  311. package/kits/hub-game/scripts/test-act.mjs +171 -0
  312. package/kits/hub-game/scripts/test-action-layout.mjs +80 -0
  313. package/kits/hub-game/scripts/test-action-observers.mjs +46 -0
  314. package/kits/hub-game/scripts/test-actions-client.mjs +853 -0
  315. package/kits/hub-game/scripts/test-actions.mjs +298 -0
  316. package/kits/hub-game/scripts/test-actor-budget.mjs +44 -0
  317. package/kits/hub-game/scripts/test-actors.mjs +38 -23
  318. package/kits/hub-game/scripts/test-analytics.mjs +76 -0
  319. package/kits/hub-game/scripts/test-anonymous-entry.mjs +28 -0
  320. package/kits/hub-game/scripts/test-arrival-pose-server.mjs +196 -0
  321. package/kits/hub-game/scripts/test-arrival-pose.mjs +24 -0
  322. package/kits/hub-game/scripts/test-ask-client.mjs +358 -0
  323. package/kits/hub-game/scripts/test-ask-slot.mjs +85 -0
  324. package/kits/hub-game/scripts/test-ask.mjs +269 -0
  325. package/kits/hub-game/scripts/test-attention.mjs +10 -1
  326. package/kits/hub-game/scripts/test-avatar-cap.mjs +379 -0
  327. package/kits/hub-game/scripts/test-avatar-colors.mjs +72 -0
  328. package/kits/hub-game/scripts/test-avatar-models.mjs +181 -0
  329. package/kits/hub-game/scripts/test-avatar-share.mjs +318 -0
  330. package/kits/hub-game/scripts/test-avatar-wire.mjs +792 -0
  331. package/kits/hub-game/scripts/test-avatar.mjs +584 -7
  332. package/kits/hub-game/scripts/test-back-visibility.mjs +82 -0
  333. package/kits/hub-game/scripts/test-ballot.mjs +1008 -0
  334. package/kits/hub-game/scripts/test-ban-join.mjs +121 -13
  335. package/kits/hub-game/scripts/test-build.mjs +49 -0
  336. package/kits/hub-game/scripts/test-cells.mjs +71 -0
  337. package/kits/hub-game/scripts/test-chat.mjs +863 -0
  338. package/kits/hub-game/scripts/test-classic.mjs +2 -0
  339. package/kits/hub-game/scripts/test-companion-chat.mjs +216 -0
  340. package/kits/hub-game/scripts/test-companion-client.mjs +1167 -0
  341. package/kits/hub-game/scripts/test-companion.mjs +259 -0
  342. package/kits/hub-game/scripts/test-control-layout-dom.mjs +120 -0
  343. package/kits/hub-game/scripts/test-crowd-names.mjs +205 -0
  344. package/kits/hub-game/scripts/test-decor-client.mjs +344 -0
  345. package/kits/hub-game/scripts/test-decor.mjs +464 -0
  346. package/kits/hub-game/scripts/test-default-environment-root.mjs +95 -0
  347. package/kits/hub-game/scripts/test-default-environment.mjs +267 -0
  348. package/kits/hub-game/scripts/test-door-analytics.mjs +58 -0
  349. package/kits/hub-game/scripts/test-door-jump.mjs +100 -0
  350. package/kits/hub-game/scripts/test-earned-client.mjs +459 -0
  351. package/kits/hub-game/scripts/test-earned.mjs +1224 -0
  352. package/kits/hub-game/scripts/test-emote-bubble.mjs +110 -0
  353. package/kits/hub-game/scripts/test-far-avatars.mjs +340 -0
  354. package/kits/hub-game/scripts/test-fps-telemetry.mjs +112 -0
  355. package/kits/hub-game/scripts/test-frame-batch.mjs +252 -0
  356. package/kits/hub-game/scripts/test-fresh-friends.mjs +118 -0
  357. package/kits/hub-game/scripts/test-friend-bests.mjs +435 -0
  358. package/kits/hub-game/scripts/test-grab-orbit.mjs +961 -0
  359. package/kits/hub-game/scripts/test-grab.mjs +7 -0
  360. package/kits/hub-game/scripts/test-hats.mjs +422 -168
  361. package/kits/hub-game/scripts/test-high-only.mjs +170 -0
  362. package/kits/hub-game/scripts/test-hub-leaving.mjs +203 -0
  363. package/kits/hub-game/scripts/test-hub-ops.mjs +758 -2
  364. package/kits/hub-game/scripts/test-hub-trip.mjs +1594 -12
  365. package/kits/hub-game/scripts/test-hud-clear.mjs +484 -57
  366. package/kits/hub-game/scripts/test-hud-defects-dom.mjs +100 -0
  367. package/kits/hub-game/scripts/test-hud-rate.mjs +224 -0
  368. package/kits/hub-game/scripts/test-hud-safe-visibility-dom.mjs +83 -0
  369. package/kits/hub-game/scripts/test-idle.mjs +427 -1
  370. package/kits/hub-game/scripts/test-interest-cap.mjs +36 -0
  371. package/kits/hub-game/scripts/test-interest-cells.mjs +513 -0
  372. package/kits/hub-game/scripts/test-interest-client.mjs +118 -0
  373. package/kits/hub-game/scripts/test-interest.mjs +15 -0
  374. package/kits/hub-game/scripts/test-invites-client.mjs +430 -0
  375. package/kits/hub-game/scripts/test-invites.mjs +109 -0
  376. package/kits/hub-game/scripts/test-keys.mjs +46 -1
  377. package/kits/hub-game/scripts/test-labels.mjs +664 -0
  378. package/kits/hub-game/scripts/test-landscape-layout.mjs +194 -0
  379. package/kits/hub-game/scripts/test-list-scroll-dom.mjs +49 -0
  380. package/kits/hub-game/scripts/test-load-abandon.mjs +246 -0
  381. package/kits/hub-game/scripts/test-loading-cover.mjs +162 -0
  382. package/kits/hub-game/scripts/test-manifest.mjs +472 -0
  383. package/kits/hub-game/scripts/test-menu-client.mjs +585 -0
  384. package/kits/hub-game/scripts/test-menu.mjs +319 -0
  385. package/kits/hub-game/scripts/test-npcs.mjs +2528 -13
  386. package/kits/hub-game/scripts/test-object-entry.mjs +76 -0
  387. package/kits/hub-game/scripts/test-observed.mjs +745 -0
  388. package/kits/hub-game/scripts/test-pack.mjs +7 -0
  389. package/kits/hub-game/scripts/test-pad-cues.mjs +304 -0
  390. package/kits/hub-game/scripts/test-pad-occupancy.mjs +177 -0
  391. package/kits/hub-game/scripts/test-picker.mjs +541 -0
  392. package/kits/hub-game/scripts/test-placement-cache.mjs +690 -0
  393. package/kits/hub-game/scripts/test-progress-reset.mjs +559 -0
  394. package/kits/hub-game/scripts/test-push-visit.mjs +26 -0
  395. package/kits/hub-game/scripts/test-quality.mjs +385 -0
  396. package/kits/hub-game/scripts/test-rehello.mjs +1733 -0
  397. package/kits/hub-game/scripts/test-relations-among.mjs +222 -0
  398. package/kits/hub-game/scripts/test-relations-refresh.mjs +188 -0
  399. package/kits/hub-game/scripts/test-resume-action-order.mjs +598 -0
  400. package/kits/hub-game/scripts/test-resume-held.mjs +239 -0
  401. package/kits/hub-game/scripts/test-resume-pose.mjs +142 -0
  402. package/kits/hub-game/scripts/test-safe-events-dom.mjs +116 -0
  403. package/kits/hub-game/scripts/test-safe-layout.mjs +330 -0
  404. package/kits/hub-game/scripts/test-say.mjs +1 -1
  405. package/kits/hub-game/scripts/test-shot.mjs +901 -0
  406. package/kits/hub-game/scripts/test-signin-client.mjs +45 -0
  407. package/kits/hub-game/scripts/test-soundscape.mjs +5437 -0
  408. package/kits/hub-game/scripts/test-spin.mjs +314 -0
  409. package/kits/hub-game/scripts/test-standing.mjs +449 -0
  410. package/kits/hub-game/scripts/test-storage-limit.mjs +333 -0
  411. package/kits/hub-game/scripts/test-stuck.mjs +1904 -0
  412. package/kits/hub-game/scripts/test-talk-overlay-dom.mjs +130 -0
  413. package/kits/hub-game/scripts/test-tier-cells.mjs +706 -0
  414. package/kits/hub-game/scripts/test-tiers-render.mjs +412 -0
  415. package/kits/hub-game/scripts/test-tiers.mjs +476 -2
  416. package/kits/hub-game/scripts/test-toast-band.mjs +61 -0
  417. package/kits/hub-game/scripts/test-try-on.mjs +22 -22
  418. package/kits/hub-game/scripts/test-vis.mjs +770 -0
  419. package/kits/hub-game/scripts/test-visibility.mjs +134 -0
  420. package/kits/hub-game/scripts/test-weakest-tier.mjs +924 -0
  421. package/kits/hub-game/scripts/test-world-labels.mjs +367 -0
  422. package/kits/hub-game/scripts/test-yours-chrome.mjs +210 -0
  423. package/kits/hub-game/scripts/test-yours.mjs +403 -0
  424. package/kits/multiplayer-3d/CLAUDE.md +50 -0
  425. package/kits/multiplayer-3d/castle.json +5 -5
  426. package/kits/multiplayer-3d/code/client/avatars.js +7 -0
  427. package/kits/multiplayer-3d/code/client/gait.js +65 -0
  428. package/kits/multiplayer-3d/code/client/joinFailure.js +27 -0
  429. package/kits/multiplayer-3d/code/client/nameTags.js +59 -4
  430. package/kits/multiplayer-3d/code/client/resumeGate.js +139 -0
  431. package/kits/multiplayer-3d/code/options.js +5 -0
  432. package/kits/multiplayer-3d/code/server/ownership.js +10 -2
  433. package/kits/multiplayer-3d/code/server/sceneBodies.js +12 -0
  434. package/kits/multiplayer-3d/code/server/world.js +7 -0
  435. package/kits/multiplayer-3d/code/systems/multiplayer.js +443 -34
  436. package/kits/multiplayer-3d/package-lock.json +8 -1
  437. package/kits/multiplayer-3d/package.json +3 -1
  438. package/kits/multiplayer-3d/scripts/fixtures/README.md +11 -0
  439. package/kits/multiplayer-3d/scripts/fixtures/ownership-legacy.json +2 -0
  440. package/kits/multiplayer-3d/scripts/ownership-harness.mjs +102 -0
  441. package/kits/multiplayer-3d/scripts/ownership-loader.mjs +46 -0
  442. package/kits/multiplayer-3d/scripts/ownership-worker.mjs +15 -0
  443. package/kits/multiplayer-3d/scripts/record-ownership-session.mjs +98 -0
  444. package/kits/multiplayer-3d/scripts/test-eligible-claims.mjs +167 -0
  445. package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +436 -0
  446. package/kits/multiplayer-3d/scripts/test-own-name-tag.mjs +247 -0
  447. package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +624 -0
  448. package/kits/physics-2d/CLAUDE.md +19 -1
  449. package/kits/physics-2d/castle.json +2 -2
  450. package/kits/physics-2d/engine/frozenActors.js +233 -0
  451. package/kits/physics-2d/engine/scene.js +337 -3
  452. package/kits/physics-2d/engine/skyKey.js +129 -0
  453. package/kits/physics-2d/engine/stillClock.js +106 -0
  454. package/kits/physics-2d/engine/updateBudget.js +21 -0
  455. package/kits/physics-2d/eslint.config.js +1 -1
  456. package/kits/physics-2d/play/behaviors/AnalogStick.js +198 -0
  457. package/kits/physics-2d/play/behaviors/Camera.js +40 -0
  458. package/kits/physics-2d/play/behaviors/Collider.js +122 -0
  459. package/kits/physics-2d/play/behaviors/Draggable.js +115 -0
  460. package/kits/physics-2d/play/behaviors/Goal.js +46 -0
  461. package/kits/physics-2d/play/behaviors/Joints.js +126 -0
  462. package/kits/physics-2d/play/behaviors/Layout.js +71 -0
  463. package/kits/physics-2d/play/behaviors/RigidBody.js +57 -0
  464. package/kits/physics-2d/play/behaviors/Slingshot.js +142 -0
  465. package/kits/physics-2d/play/behaviors/SoundPlayer.js +263 -0
  466. package/kits/physics-2d/play/behaviors/Sprite.js +406 -0
  467. package/kits/physics-2d/play/behaviors/Style.js +209 -0
  468. package/kits/physics-2d/play/behaviors/Text.js +85 -0
  469. package/kits/physics-2d/play/behaviors/Video.js +93 -0
  470. package/kits/physics-2d/scripts/test-skip-unchanged.mjs +326 -1
  471. package/kits/physics-3d/CLAUDE.md +42 -529
  472. package/kits/physics-3d/behaviors/Body.jsx +3 -0
  473. package/kits/physics-3d/behaviors/Model.jsx +3 -0
  474. package/kits/physics-3d/behaviors/Player.jsx +661 -87
  475. package/kits/physics-3d/behaviors/Shape.jsx +3 -0
  476. package/kits/physics-3d/behaviors/Solid.jsx +3 -0
  477. package/kits/physics-3d/behaviors/Transform.jsx +3 -0
  478. package/kits/physics-3d/castle.json +3 -3
  479. package/kits/physics-3d/docs/engine-camera.md +542 -0
  480. package/kits/physics-3d/docs/engine-frame-cap.md +136 -0
  481. package/kits/physics-3d/docs/engine-load.md +149 -0
  482. package/kits/physics-3d/docs/engine-look.md +114 -0
  483. package/kits/physics-3d/docs/engine-shadows.md +372 -0
  484. package/kits/physics-3d/docs/engine-skip-work.md +187 -0
  485. package/kits/physics-3d/docs/engine-sky.md +198 -0
  486. package/kits/physics-3d/docs/engine-static-actors.md +226 -0
  487. package/kits/physics-3d/docs/engine-view.md +37 -0
  488. package/kits/physics-3d/docs/pxmodel-format.md +9 -1
  489. package/kits/physics-3d/engine3d/PlayOnly3D.jsx +5 -1
  490. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +19 -277
  491. package/kits/physics-3d/engine3d/actornode.js +87 -0
  492. package/kits/physics-3d/engine3d/animationBudget.js +23 -0
  493. package/kits/physics-3d/engine3d/branches.js +3 -13
  494. package/kits/physics-3d/engine3d/cage.js +2 -7
  495. package/kits/physics-3d/engine3d/cageops.js +2 -17
  496. package/kits/physics-3d/engine3d/dataBehaviors.js +12 -0
  497. package/kits/physics-3d/engine3d/editorWorld.js +6 -0
  498. package/kits/physics-3d/engine3d/emptynodes.js +232 -0
  499. package/kits/physics-3d/engine3d/framecap.js +99 -0
  500. package/kits/physics-3d/engine3d/frozenphysics.js +140 -0
  501. package/kits/physics-3d/engine3d/frozenstatics.js +273 -0
  502. package/kits/physics-3d/engine3d/gait.js +126 -0
  503. package/kits/physics-3d/engine3d/initialModelFiles.js +18 -0
  504. package/kits/physics-3d/engine3d/kithooks.js +47 -0
  505. package/kits/physics-3d/engine3d/look.js +514 -48
  506. package/kits/physics-3d/engine3d/lookbake.js +208 -0
  507. package/kits/physics-3d/engine3d/materialpresets.js +2 -0
  508. package/kits/physics-3d/engine3d/modelFiles.js +3 -17
  509. package/kits/physics-3d/engine3d/modelMath.js +49 -0
  510. package/kits/physics-3d/engine3d/modelready.js +16 -0
  511. package/kits/physics-3d/engine3d/motion.js +39 -10
  512. package/kits/physics-3d/engine3d/nearshadows.js +106 -21
  513. package/kits/physics-3d/engine3d/optimize.js +9 -5
  514. package/kits/physics-3d/engine3d/orbitinput.js +522 -10
  515. package/kits/physics-3d/engine3d/orbitlens.js +48 -0
  516. package/kits/physics-3d/engine3d/ownmodel.js +213 -0
  517. package/kits/physics-3d/engine3d/partgeometry.js +1 -16
  518. package/kits/physics-3d/engine3d/paths.js +1 -9
  519. package/kits/physics-3d/engine3d/playTimings.js +50 -0
  520. package/kits/physics-3d/engine3d/playerRun.js +372 -0
  521. package/kits/physics-3d/engine3d/pxmodel.js +42 -11
  522. package/kits/physics-3d/engine3d/rapier.js +27 -0
  523. package/kits/physics-3d/engine3d/scatter.js +1 -11
  524. package/kits/physics-3d/engine3d/shadowfade.js +890 -0
  525. package/kits/physics-3d/engine3d/sky.js +547 -0
  526. package/kits/physics-3d/engine3d/skylife.js +306 -0
  527. package/kits/physics-3d/engine3d/squarefirst.js +177 -0
  528. package/kits/physics-3d/engine3d/stillshadows.js +399 -0
  529. package/kits/physics-3d/engine3d/sweep.js +1 -25
  530. package/kits/physics-3d/engine3d/unchanged.js +11 -0
  531. package/kits/physics-3d/engine3d/viewrange.js +52 -0
  532. package/kits/physics-3d/engine3d/world3d.js +1253 -76
  533. package/kits/physics-3d/eslint.config.js +2 -1
  534. package/kits/physics-3d/main.jsx +10 -2
  535. package/kits/physics-3d/package-lock.json +7 -0
  536. package/kits/physics-3d/package.json +5 -1
  537. package/kits/physics-3d/play/behaviors/Body.js +31 -0
  538. package/kits/physics-3d/play/behaviors/Door.js +37 -0
  539. package/kits/physics-3d/play/behaviors/Lookable.js +16 -0
  540. package/kits/physics-3d/play/behaviors/Model.js +23 -0
  541. package/kits/physics-3d/play/behaviors/Pickup.js +46 -0
  542. package/kits/physics-3d/play/behaviors/Player.js +1204 -0
  543. package/kits/physics-3d/play/behaviors/Shape.js +47 -0
  544. package/kits/physics-3d/play/behaviors/Solid.js +16 -0
  545. package/kits/physics-3d/play/behaviors/Transform.js +29 -0
  546. package/kits/physics-3d/pnpm-lock.yaml +8 -0
  547. package/kits/physics-3d/scripts/bench-shadow-fade.mjs +37 -0
  548. package/kits/physics-3d/scripts/build-rapier-gz.mjs +56 -0
  549. package/kits/physics-3d/scripts/frozen-statics-fixture.mjs +141 -0
  550. package/kits/physics-3d/scripts/look-baseline.mjs +155 -0
  551. package/kits/physics-3d/scripts/test-camera-follow.mjs +5 -1
  552. package/kits/physics-3d/scripts/test-camera-orbit.mjs +2613 -82
  553. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +2 -2
  554. package/kits/physics-3d/scripts/test-empty-gait-hints.mjs +89 -0
  555. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +438 -0
  556. package/kits/physics-3d/scripts/test-frame-cap.mjs +452 -0
  557. package/kits/physics-3d/scripts/test-frozen-nested.mjs +49 -0
  558. package/kits/physics-3d/scripts/test-frozen-statics-legacy-physics2d.mjs +123 -0
  559. package/kits/physics-3d/scripts/test-frozen-statics.mjs +434 -0
  560. package/kits/physics-3d/scripts/test-gait.mjs +387 -0
  561. package/kits/physics-3d/scripts/test-look-bake.mjs +1056 -0
  562. package/kits/physics-3d/scripts/test-model-parse-cache.mjs +92 -0
  563. package/kits/physics-3d/scripts/test-near-shadows.mjs +5 -2
  564. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +2001 -0
  565. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +582 -0
  566. package/kits/physics-3d/scripts/test-orbit-shot.mjs +657 -0
  567. package/kits/physics-3d/scripts/test-orbit-view.mjs +230 -0
  568. package/kits/physics-3d/scripts/test-rapier-gz.mjs +106 -0
  569. package/kits/physics-3d/scripts/test-skip-empty-nodes.mjs +845 -0
  570. package/kits/physics-3d/scripts/test-sky.mjs +2470 -0
  571. package/kits/physics-3d/scripts/test-square-first.mjs +921 -0
  572. package/kits/physics-3d/scripts/test-static-actors.mjs +10 -1
  573. package/kits/physics-3d/scripts/test-static-physics.mjs +4 -1
  574. package/kits/physics-3d/scripts/test-static-scenery.mjs +2174 -0
  575. package/kits/physics-3d/scripts/test-steady-hover.mjs +7 -2
  576. package/kits/physics-3d/scripts/test-still-shadows.mjs +477 -0
  577. package/kits/physics-3d/scripts/test-view-range.mjs +260 -0
  578. package/kits/physics-3d/systems/physics3d.js +419 -9
  579. package/kits/real-time/castle.json +2 -2
  580. package/kits/real-time/code/client/connection.js +33 -10
  581. package/kits/real-time/code/client/gameHooks.js +2 -0
  582. package/kits/real-time/code/client/joinOverlay.js +9 -4
  583. package/kits/real-time/code/server/gameHooks.js +7 -0
  584. package/kits/real-time/code/server/session.js +102 -22
  585. package/kits/real-time/package-lock.json +1 -1
  586. package/package.json +2 -2
  587. package/dist/shell/assets/index-Cf61cNfT.css +0 -1
package/dist/imports.js CHANGED
@@ -55,8 +55,14 @@ export function readImportVersion(deckDir, alias) {
55
55
  // version string does, so a deck's copy is stamped with a digest of the kit's
56
56
  // files, and a CLI of the same version whose own copy differs replaces it
57
57
  // (`refreshStaleBuiltinImports`) before the deck is installed, served or saved
58
- // -- otherwise a save ships whatever kit the deck happened to copy first. A copy
59
- // from another CLI version is left alone: that is never a move to make silently.
58
+ // -- otherwise a save ships whatever kit the deck happened to copy first.
59
+ //
60
+ // A copy from another CLI version is left alone while installing and serving:
61
+ // what the editor shows does not change under anyone. Saving is different. A
62
+ // pin OLDER than this CLI is moved forward on save -- the copy replaced with
63
+ // this CLI's kit and the pin rewritten to this CLI's version, said out loud --
64
+ // because otherwise every save after a CLI update ships the old kit and nothing
65
+ // says so. A pin NEWER than this CLI is never moved: that would be a move back.
60
66
  const BUILTIN_COPY_EXCLUDE = new Set(['node_modules', '.castle', 'dist', '.git']);
61
67
  function builtinCopyFilter(kitDir) {
62
68
  // The kit's own `imports/` is derived state, re-placed at the deck root.
@@ -106,11 +112,56 @@ export function copyBuiltinKit(kitDir, destDir, kit, version) {
106
112
  fs.cpSync(kitDir, destDir, { recursive: true, verbatimSymlinks: true, filter: builtinCopyFilter(kitDir) });
107
113
  writeBuiltinStamp(destDir, { source: 'builtin', kit, version, digest: builtinKitDigest(kitDir) });
108
114
  }
115
+ const errorText = (e) => (e instanceof Error ? e.message : String(e));
116
+ // The `onUpdate` a builtin kit declares -- this CLI's copy or the deck's -- when
117
+ // it has one. Moving such a pin without running it would leave the deck's data
118
+ // unmigrated under new code.
119
+ function builtinUpdateHook(kitDir, destDir) {
120
+ for (const dir of [kitDir, destDir]) {
121
+ const declared = tryReadCastleJson(dir)?.onUpdate;
122
+ if (typeof declared === 'string' && declared.trim())
123
+ return declared.trim();
124
+ }
125
+ return null;
126
+ }
127
+ // Staged beside the old copy and swapped in whole, so a failed copy leaves the
128
+ // deck's import as it was, and no half-copied stage behind.
129
+ function swapInBuiltinKit(kitDir, destDir, kit, version) {
130
+ const staged = `${destDir}.refresh-${process.pid}`;
131
+ fs.rmSync(staged, { recursive: true, force: true });
132
+ try {
133
+ copyBuiltinKit(kitDir, staged, kit, version);
134
+ }
135
+ catch (e) {
136
+ if (fs.existsSync(staged))
137
+ unlockImportTree(staged);
138
+ fs.rmSync(staged, { recursive: true, force: true });
139
+ throw e;
140
+ }
141
+ unlockImportTree(destDir);
142
+ fs.rmSync(destDir, { recursive: true, force: true });
143
+ fs.renameSync(staged, destDir);
144
+ lockImportTree(destDir);
145
+ }
146
+ /** Whether x.y.z version `a` is older than `b`; false when either is not one. */
147
+ export function versionOlder(a, b) {
148
+ const parts = (version) => /^(\d+)\.(\d+)\.(\d+)/.exec(version)?.slice(1, 4).map(Number) ?? null;
149
+ const x = parts(a);
150
+ const y = parts(b);
151
+ if (!x || !y)
152
+ return false;
153
+ for (let i = 0; i < 3; i += 1)
154
+ if (x[i] !== y[i])
155
+ return x[i] < y[i];
156
+ return false;
157
+ }
109
158
  /**
110
159
  * Builtin imports whose copy differs from this CLI's kit of the same version,
111
- * replaced with this CLI's. Returns the aliases replaced.
160
+ * replaced with this CLI's. With `olderPins` (save-deck only), a builtin pinned
161
+ * at an older CLI version is replaced too and its pin moved to this CLI's
162
+ * version. Returns the aliases replaced.
112
163
  */
113
- export async function refreshStaleBuiltinImports(deckDir, log = (message) => console.log(message)) {
164
+ export async function refreshStaleBuiltinImports(deckDir, log = (message) => console.log(message), options = {}) {
114
165
  const pins = tryReadCastleJson(deckDir)?.imports ?? {};
115
166
  const { getCliVersion } = await import('./init.js');
116
167
  const cliVersion = getCliVersion();
@@ -118,38 +169,51 @@ export async function refreshStaleBuiltinImports(deckDir, log = (message) => con
118
169
  // Never throws: a kit that cannot be refreshed is left as it is and named,
119
170
  // and the ones that were are still returned (serve invalidates on them).
120
171
  for (const [alias, pin] of Object.entries(pins)) {
121
- if (pin?.source !== 'builtin' || pin.version !== cliVersion)
172
+ if (pin?.source !== 'builtin')
173
+ continue;
174
+ const movePin = pin.version !== cliVersion;
175
+ if (movePin && !(options.olderPins && versionOlder(pin.version, cliVersion)))
122
176
  continue;
123
177
  const destDir = path.join(deckDir, IMPORTS_DIR, alias);
124
178
  const kitDir = path.join(getKitsDir(), pin.kit ?? alias);
125
179
  try {
126
180
  if (!fs.existsSync(destDir) || !fs.existsSync(kitDir))
127
181
  continue;
182
+ const hook = movePin ? builtinUpdateHook(kitDir, destDir) : null;
183
+ if (hook) {
184
+ log(`Left ${alias} at ${pin.version}, older than this CLI (${cliVersion}): the kit migrates a deck when its pin moves ` +
185
+ `(onUpdate: ${hook}), and no castle-web command runs that for a kit the CLI ships. Move it deliberately: run ` +
186
+ `imports/${alias}/${hook} on this deck (its header names the arguments it needs), then set the pin's version in castle.json to ${cliVersion}; the next save copies this CLI's kit.`);
187
+ continue;
188
+ }
128
189
  const digest = builtinKitDigest(kitDir);
129
190
  const stamp = readBuiltinStamp(destDir);
130
- if (stamp?.digest === digest)
191
+ if (!movePin && stamp?.digest === digest)
131
192
  continue;
132
- if (!stamp && builtinKitDigest(destDir) === digest) {
193
+ if (!movePin && !stamp && builtinKitDigest(destDir) === digest) {
133
194
  // A copy from before stamps, already this kit: stamp it and move on.
134
195
  unlockImportTree(destDir);
135
196
  writeBuiltinStamp(destDir, { source: 'builtin', kit: pin.kit ?? alias, version: cliVersion, digest });
136
197
  lockImportTree(destDir);
137
198
  continue;
138
199
  }
139
- // Staged beside the old copy and swapped in whole, so a failed copy
140
- // leaves the deck's import as it was.
141
- const staged = `${destDir}.refresh-${process.pid}`;
142
- fs.rmSync(staged, { recursive: true, force: true });
143
- copyBuiltinKit(kitDir, staged, pin.kit ?? alias, cliVersion);
144
- unlockImportTree(destDir);
145
- fs.rmSync(destDir, { recursive: true, force: true });
146
- fs.renameSync(staged, destDir);
147
- lockImportTree(destDir);
200
+ swapInBuiltinKit(kitDir, destDir, pin.kit ?? alias, cliVersion);
148
201
  refreshed.push(alias);
149
- log(`Refreshed ${alias}: this deck's copy differed from the ${pin.kit ?? alias} kit this CLI (${cliVersion}) ships.`);
202
+ if (!movePin) {
203
+ log(`Refreshed ${alias}: this deck's copy differed from the ${pin.kit ?? alias} kit this CLI (${cliVersion}) ships.`);
204
+ continue;
205
+ }
206
+ try {
207
+ writeImportPin(deckDir, alias, { ...pin, version: cliVersion });
208
+ }
209
+ catch (e) {
210
+ log(`Replaced ${alias}'s files with this CLI's kit (${cliVersion}), but its pin was NOT moved from ${pin.version}: ${errorText(e)}`);
211
+ continue;
212
+ }
213
+ log(`Refreshed ${alias}: pinned at ${pin.version}, older than this CLI (${cliVersion}); now this CLI's kit, pin moved to ${cliVersion}.`);
150
214
  }
151
215
  catch (e) {
152
- log(`Left ${alias} as it is: ${e instanceof Error ? e.message : String(e)}`);
216
+ log(`Left ${alias} as it is: ${errorText(e)}`);
153
217
  }
154
218
  }
155
219
  if (refreshed.length) {
@@ -266,7 +330,7 @@ export async function resolveDeckRef(raw) {
266
330
  }
267
331
  // Only the `imports` key is ours; everything else in castle.json (deck identity,
268
332
  // editor config) is preserved as-is.
269
- function writeImportPin(dir, alias, pin) {
333
+ export function writeImportPin(dir, alias, pin) {
270
334
  const existing = readCastleJson(dir) ?? {};
271
335
  // Forks belong to the DECK, not to the pin: the files live in its own forks/
272
336
  // and an import update or restore doesn't touch them. Writing a fresh pin over
@@ -477,6 +541,10 @@ export async function restoreMissingImports(deckDir) {
477
541
  // truth: the pin stays as committed, and publish-kits compares the two
478
542
  // to refuse bundling against files no pin describes.
479
543
  writeImportVersion(destDir, { deckId: pin.deckId, version: source.updatedAt });
544
+ if (source.updatedAt !== pin.version) {
545
+ console.warn(`Import "${alias}" is pinned at ${pin.version}, but the server only has ${source.updatedAt}, so that is what was placed. ` +
546
+ '`castle-web check` and `save-deck` refuse until the two agree (see `--pin-installed-imports`).');
547
+ }
480
548
  }
481
549
  else if (pin?.source === 'builtin') {
482
550
  // Scaffolded from the kit shipped with the CLI: the same copy is still
@@ -1077,7 +1145,7 @@ export async function updateImport(dir, options = {}) {
1077
1145
  if (!pin.deckId) {
1078
1146
  // A kit copied from the CLI updates with the CLI, not from the server.
1079
1147
  if (options.alias)
1080
- console.log(`"${alias}" came with this CLI; it updates when the CLI does.`);
1148
+ console.log(`"${alias}" came with this CLI; it moves to a newer CLI's kit when the deck is saved with that CLI.`);
1081
1149
  continue;
1082
1150
  }
1083
1151
  const source = await api.webDeckSource(pin.deckId).catch(() => null);
package/dist/index.js CHANGED
@@ -38,6 +38,7 @@ const FLAGS_WITH_VALUES = new Set([
38
38
  '-m',
39
39
  '--reason',
40
40
  '--remote',
41
+ '--base-url',
41
42
  ]);
42
43
  // `--foo` is always a flag; a single dash only when it is one we know (`-m`).
43
44
  // Anything else starting with `-` is a positional -- a path can begin with one,
@@ -184,7 +185,7 @@ function usage() {
184
185
  castle-web serve [dir] [--port PORT] [--host HOST] [--open] [--detach]
185
186
  castle-web restart [--port PORT]
186
187
  castle-web screenshot [--out FILE] [--port PORT]
187
- castle-web save-deck [dir] [--title TITLE] [--caption TEXT] [--visibility unlisted|private] [--force] (--force: save over a newer saved copy)
188
+ castle-web save-deck [dir] [--title TITLE] [--caption TEXT] [--visibility unlisted|private] [--force] [--pin-installed-imports] [--chunked-bundle] (--force: save over a newer saved copy; --pin-installed-imports: move import pins to the versions imports/ holds instead of refusing; --chunked-bundle: publish the JS as cacheable classic-script chunks, as castle.json "bundle": { "chunks": "classic" } does)
188
189
  castle-web get-deck [dir] [--deck-id ID] [--force] (replaces the source if the deck is already there)
189
190
  castle-web get-deck <dir> --side [--deck-id ID] [--json] (fetches the saved copy into <dir>/.castle/agent/saved-source/<stamp>/, touching nothing else)
190
191
  castle-web source-status <dir> [--adopt] [--notify] [--json] (whether the deck's saved copy is newer than this folder)
@@ -195,7 +196,8 @@ function usage() {
195
196
  castle-web revert-import-file <imports/...> [dir]
196
197
  castle-web update-import [alias] [dir] [--check] [--revert] (re-fetches imports; no alias means all)
197
198
  castle-web install [dir]
198
- castle-web check [dir] (bundles the deck and its server, then runs each import's onCheck -- the same gates save-deck runs)
199
+ castle-web check [dir] [--pin-installed-imports] (bundles the deck and its server, then runs each import's onCheck -- the same gates save-deck runs)
200
+ castle-web bundle-chunks [dir] --out DIR [--base-url URL] (writes the classic chunked bundle: index.html plus <sha256>.js chunks named at URL, default ./)
199
201
  castle-web save-version [-m MESSAGE] [paths...] [--dir DIR] (no paths saves the whole deck)
200
202
  castle-web list-versions [version] [--dir DIR] (defaults to the latest version)
201
203
  castle-web show-version <version> [--dir DIR] (diffs of the files that version changed)
@@ -555,7 +557,9 @@ async function main() {
555
557
  const title = getFlagValue('--title');
556
558
  const caption = getFlagValue('--caption');
557
559
  const visibility = getFlagValue('--visibility');
558
- await saveDeck(dir, { title, caption, visibility, force: hasFlag('--force') });
560
+ const pinInstalledImports = hasFlag('--pin-installed-imports');
561
+ const chunkedBundle = hasFlag('--chunked-bundle');
562
+ await saveDeck(dir, { title, caption, visibility, force: hasFlag('--force'), pinInstalledImports, chunkedBundle });
559
563
  break;
560
564
  }
561
565
  case 'get-deck': {
@@ -633,9 +637,12 @@ async function main() {
633
637
  break;
634
638
  }
635
639
  case 'check': {
636
- await check(findPositionalDir());
640
+ await check(findPositionalDir(), { pinInstalledImports: hasFlag('--pin-installed-imports') });
637
641
  break;
638
642
  }
643
+ case 'bundle-chunks':
644
+ await (await import('./bundle.js')).bundleChunksCommand(findPositionalDir(), getFlagValue('--out'), getFlagValue('--base-url'));
645
+ break;
639
646
  // The version commands spend their positionals on their own arguments --
640
647
  // paths to save, a version to list from or restore to -- so the deck dir is
641
648
  // `--dir`, defaulting to the cwd.
package/dist/init.js CHANGED
@@ -64,7 +64,7 @@ const BARE_SCAFFOLDS = [
64
64
  // Registry version of castle-web-sdk to inject when scaffolding from a
65
65
  // globally-installed castle-web (not from inside the workspace). Bumped
66
66
  // alongside cli/sdk version bumps.
67
- const PUBLISHED_SDK_VERSION = '0.4.46';
67
+ const PUBLISHED_SDK_VERSION = '0.4.49';
68
68
  // Range, not a pin: `castle-web-fonts` is its own package precisely so a tenth
69
69
  // face can ship without a cli release, and a caret range means an existing
70
70
  // deck's next install picks it up. Nothing here has to move when it does.
@@ -239,6 +239,28 @@ const COMMON_SECTIONS = `## Imports are read-only
239
239
  - Exception: deliberate pixel art wants a fixed low-resolution backing store with \`image-rendering: pixelated\` CSS instead — don't DPR-scale that; the crisp chunky look is the point.
240
240
  - **A WebGL canvas must be created with \`preserveDrawingBuffer: true\`, or every in-page capture of the deck comes back blank** — the Play panel's Snap and \`npm run screenshot\` both read the canvas after the frame has been shown, and by then the browser has cleared it, so the image is just the card's background. Pass it through whatever library makes the canvas: \`new THREE.WebGLRenderer({ preserveDrawingBuffer: true })\`, PixiJS \`app.init({ preserveDrawingBuffer: true })\`, or \`canvas.getContext('webgl2', { preserveDrawingBuffer: true })\`. A 2D canvas needs nothing, and kit decks already set it.
241
241
 
242
+ ## Game clock
243
+
244
+ - **The deck is hidden and resumed in place, and the clock keeps running while it is hidden.** When the player leaves the feed, Castle keeps the deck alive but stops its \`requestAnimationFrame\` callbacks; \`Date.now()\` and \`performance.now()\` keep advancing, so on return the first frame and every clock reading jump by the whole absence -- minutes, or longer.
245
+ - **Drive simulation from the rAF timestamp with a clamped dt; the cap is the point.** A fixed-timestep accumulator needs the same cap on the time it accumulates. When a kit runs the loop and hands your code a \`dt\`, use that \`dt\` rather than reading a clock.
246
+
247
+ \`\`\`js
248
+ let last = performance.now();
249
+ function frame(now) {
250
+ const dt = Math.min(0.05, (now - last) / 1000);
251
+ last = now;
252
+ update(dt); // roundTime -= dt; cooldown = Math.max(0, cooldown - dt);
253
+ requestAnimationFrame(frame);
254
+ }
255
+ requestAnimationFrame(frame);
256
+ document.addEventListener('visibilitychange', () => {
257
+ if (!document.hidden) last = performance.now();
258
+ });
259
+ \`\`\`
260
+
261
+ - **Game time -- round timers, countdowns, cooldowns, respawns, a survival score -- is accumulated from that clamped dt, never from \`Date.now()\` or \`performance.now()\` minus a stored stamp.** \`performance.now() - roundStart\` or \`Date.now() < endsAt\` ends the round or expires the cooldown while nobody is looking. \`Date.now()\` is still right for what should track real time: daily rewards, ids, logs. This is about time the deck keeps itself: a server-authoritative clock (a multiplayer match timer, the hub's server simulation time) comes from the server the way the kit guides describe, and the server keeps running for the other players.
262
+ - **Pause what should not run while hidden** (music, a spawner on its own \`setInterval\`) on \`visibilitychange\`, and resume it when \`document.hidden\` is false again.
263
+
242
264
  ## Multiplayer
243
265
 
244
266
  - **Read \`${MULTIPLAYER_DOC_REL}\` before writing or changing a server entry or client netcode by hand.** It carries what this section leaves out: the outbound frame budget in practice, the snapshot pattern, self-healing events, and the reconnect and disconnect handling a hand-rolled session gets wrong. A deck built on the \`castle.multiplayer-2d\` / \`castle.multiplayer-3d\` (or \`castle.turn-based\`) kits already does all of that and normally writes nothing against the raw session API.
@@ -6,6 +6,10 @@ export interface TaskDirective {
6
6
  hold?: true;
7
7
  prompt: string;
8
8
  }
9
+ export interface AnswerDirective {
10
+ target: string;
11
+ answer: string;
12
+ }
9
13
  export interface BoardTask {
10
14
  id: string;
11
15
  title: string;
@@ -21,6 +25,7 @@ export declare function extractDirectives(full: string, opts?: {
21
25
  directives: TaskDirective[];
22
26
  checkoffs: string[];
23
27
  stops: string[];
28
+ answers: AnswerDirective[];
24
29
  prefs: string[];
25
30
  sends: SendDirective[];
26
31
  plan?: string;
@@ -116,6 +116,7 @@ opts = {}) {
116
116
  const sends = [];
117
117
  const checkoffs = [];
118
118
  const stops = [];
119
+ const answers = [];
119
120
  const prefs = [];
120
121
  const listFence = (source, name, into) => {
121
122
  const re = new RegExp('```' + name + '[ \\t]*\\r?\\n([\\s\\S]*?)```', 'g');
@@ -130,14 +131,22 @@ opts = {}) {
130
131
  };
131
132
  const { plan, rest } = takePlanFence(full);
132
133
  const withoutLists = listFence(listFence(listFence(rest, 'castle-done', checkoffs), 'castle-stop', stops), 'castle-pref', prefs);
134
+ const withoutAnswers = withoutLists.replace(/```castle-answer[ \t]*\r?\n([\s\S]*?)```/g, (_match, body) => {
135
+ const lines = body.replace(/\r/g, '').trim().split('\n');
136
+ const target = (lines.shift() ?? '').trim();
137
+ const answer = lines.join('\n').trim();
138
+ if (target && answer)
139
+ answers.push({ target, answer });
140
+ return '';
141
+ });
133
142
  const withoutSends = opts.sends
134
- ? withoutLists.replace(sendFenceRegex(), (_match, body) => {
143
+ ? withoutAnswers.replace(sendFenceRegex(), (_match, body) => {
135
144
  const send = parseSendFenceBody(String(body));
136
145
  if (send)
137
146
  sends.push(send);
138
147
  return '';
139
148
  })
140
- : withoutLists;
149
+ : withoutAnswers;
141
150
  const cleaned = withoutSends.replace(taskFenceRegex(), (_match, body) => {
142
151
  const directive = parseTaskFenceBody(String(body));
143
152
  if (directive)
@@ -149,6 +158,7 @@ opts = {}) {
149
158
  directives,
150
159
  checkoffs,
151
160
  stops,
161
+ answers,
152
162
  prefs,
153
163
  sends,
154
164
  plan,
@@ -1,11 +1,12 @@
1
1
  import * as api from './api.js';
2
+ import { type BundleChunk } from './bundle.js';
2
3
  import { type ExperimentConfig } from './castleJson.js';
3
4
  import { type SavePrecondition } from './webSourceSync.js';
4
5
  export { DeckTooLargeError, MAX_SCENE_DATA_BYTES, MAX_SOURCE_ARCHIVE_BYTES, sceneTooLargeMessage, sourceTooLargeMessage, } from './saveFailure.js';
5
6
  export declare const SOURCE_ARCHIVE_EXCLUDES: string[];
6
7
  export declare const SAVE_STAGE_TELEMETRY_PREFIX = "CASTLE_SAVE_TELEMETRY ";
7
8
  export declare const SAVE_COVER_SELECTION_TELEMETRY_PREFIX = "CASTLE_SAVE_COVER_SELECTION ";
8
- export type SaveStage = 'bundle' | 'cover' | 'scene_upload_config' | 'scene_upload' | 'content_publish' | 'server_publish' | 'source_archive' | 'source_upload_config' | 'source_upload' | 'source_commit';
9
+ export type SaveStage = 'bundle' | 'cover' | 'chunk_upload' | 'scene_upload_config' | 'scene_upload' | 'content_publish' | 'server_publish' | 'source_archive' | 'source_upload_config' | 'source_upload' | 'source_commit';
9
10
  export declare function runTar(args: string[], opts?: {
10
11
  capture?: boolean;
11
12
  }): Promise<string>;
@@ -33,6 +34,22 @@ export declare const EXPERIMENTS_CLEAR_SETTLE_MS = 2000;
33
34
  export declare function startClearingExperiments(deckId: string): {
34
35
  settle(capMs?: number): Promise<void>;
35
36
  };
37
+ export declare const BUNDLE_CHUNK_BASE_URL: string;
38
+ export declare const MAX_BUNDLE_CHUNK_BYTES: number;
39
+ export declare const CHUNK_BUSY_RETRY_MS: number[];
40
+ /**
41
+ * Puts every chunk at its content-addressed URL: a chunk already there (HEAD
42
+ * 200) is skipped, any other is uploaded and stored. Throws on the first chunk
43
+ * that cannot be stored, so the page naming them is never published without
44
+ * them. Exported for the tests.
45
+ */
46
+ export declare function uploadBundleChunks(deckId: string, chunks: BundleChunk[], baseUrl?: string, { busyRetryMs }?: {
47
+ busyRetryMs?: number[];
48
+ }): Promise<{
49
+ uploaded: number;
50
+ skipped: number;
51
+ bytesUploaded: number;
52
+ }>;
36
53
  export type SaveVisibility = 'unlisted' | 'private';
37
54
  export interface SaveDeckOptions {
38
55
  title?: string;
@@ -40,5 +57,12 @@ export interface SaveDeckOptions {
40
57
  visibility?: SaveVisibility;
41
58
  /** Save even when the deck's saved copy is newer than this folder. */
42
59
  force?: boolean;
60
+ /** Move import pins to the versions imports/ holds, rather than refuse. */
61
+ pinInstalledImports?: boolean;
62
+ /** Publish a classic chunked bundle, as castle.json `"bundle": { "chunks": "classic" }` does. */
63
+ chunkedBundle?: boolean;
43
64
  }
44
65
  export declare function saveDeck(dir: string, opts?: SaveDeckOptions): Promise<void>;
66
+ export declare function builtinRefreshOptions(env?: NodeJS.ProcessEnv): {
67
+ olderPins: boolean;
68
+ };
package/dist/save-deck.js CHANGED
@@ -5,14 +5,16 @@ import { spawn } from 'child_process';
5
5
  import { nanoid } from 'nanoid';
6
6
  import * as api from './api.js';
7
7
  import * as config from './config.js';
8
- import { bundleProject } from './bundle.js';
9
- import { resolveServerConfig, validateExperiments } from './castleJson.js';
8
+ import { bundleProject, bundleProjectChunked } from './bundle.js';
9
+ import { resolveBundleChunks, resolveServerConfig, validateExperiments, } from './castleJson.js';
10
10
  import { importChecksFailedMessage, runImportChecks } from './importCheckHook.js';
11
11
  import { selectSaveCover } from './saveCover.js';
12
12
  import { COVER_FILE } from './localPaths.js';
13
13
  import { buildServerBundle } from './serverBundle.js';
14
14
  import { buildContentPack } from './contentPack.js';
15
15
  import { importRegressionMessage, importRegressions, savedDeckImportPins } from './importRegression.js';
16
+ import { isSandboxEnv } from './cloudGit.js';
17
+ import { settleImportPins } from './importPinMismatch.js';
16
18
  import { refreshStaleBuiltinImports } from './imports.js';
17
19
  import { decideSavePrecondition, EXIT_IMPORTS_OLDER, EXIT_SAVED_DECK_NEWER, fetchServerSourceVersion, readSyncMarker, saveRefusedLine, saveRefusedMessage, WEB_DECK_SOURCE_STALE_CODE, writeSyncMarker, } from './webSourceSync.js';
18
20
  import { DeckTooLargeError, MAX_SCENE_DATA_BYTES, MAX_SOURCE_ARCHIVE_BYTES, SAVE_FAILURE_ENV, classifySaveFailure, saveFailedLine, sceneTooLargeMessage, sourceTooLargeMessage, } from './saveFailure.js';
@@ -378,6 +380,127 @@ async function uploadContentPack(deckId, pack) {
378
380
  await uploadPresignedFile(config, new Blob([new Uint8Array(pack.bytes)], { type: 'application/json' }), 'application/json', LARGE_UPLOAD_TIMEOUT_MS, 'Content pack upload');
379
381
  return config.uploadId;
380
382
  }
383
+ // Where a chunked bundle's chunks are served from (ghost-server stores them
384
+ // there, at `<sha256>.js`). The override is for tests against a fake API.
385
+ export const BUNDLE_CHUNK_BASE_URL = process.env.CASTLE_BUNDLE_CHUNK_BASE_URL || 'https://hosted.castle.games/cauldron-chunks/';
386
+ // Ghost's per-chunk cap, uncompressed.
387
+ export const MAX_BUNDLE_CHUNK_BYTES = 8 * 1024 * 1024;
388
+ // Ghost stores at most two chunks at once per app process (Amendment 2 of the
389
+ // chunk contract); more in flight only buys CAULDRON_BUNDLE_CHUNK_BUSY retries.
390
+ const CHUNK_UPLOAD_CONCURRENCY = 2;
391
+ async function chunkAlreadyStored(url) {
392
+ try {
393
+ const res = await fetch(url, { method: 'HEAD', signal: AbortSignal.timeout(15_000) });
394
+ return res.status === 200;
395
+ }
396
+ catch {
397
+ // Unknown is "not there": uploading again is harmless, the bytes are the same.
398
+ return false;
399
+ }
400
+ }
401
+ // Ghost spends an upload grant before it reads the upload, so a grant that
402
+ // turned out invalid can only be retried from a new upload config.
403
+ const UPLOAD_GRANT_INVALID = 'CAULDRON_SERVER_BUNDLE_UPLOAD_GRANT_INVALID';
404
+ // Ghost is storing as many chunks as it will at once. Nothing was spent: the
405
+ // same upload is stored again after a wait, these waits, then the save fails.
406
+ const CHUNK_BUSY = 'CAULDRON_BUNDLE_CHUNK_BUSY';
407
+ export const CHUNK_BUSY_RETRY_MS = [500, 1000, 2000, 4000];
408
+ const errorCode = (e) => e?.extensions?.code;
409
+ async function storeWhenNotBusy(store, retryMs) {
410
+ for (let attempt = 0;; attempt++) {
411
+ try {
412
+ return await store();
413
+ }
414
+ catch (e) {
415
+ if (errorCode(e) !== CHUNK_BUSY || attempt >= retryMs.length)
416
+ throw e;
417
+ await new Promise((resolve) => setTimeout(resolve, retryMs[attempt]));
418
+ }
419
+ }
420
+ }
421
+ async function storeBundleChunk(deckId, chunk, busyRetryMs) {
422
+ const contentType = chunk.kind === 'wasm' ? 'application/wasm' : 'application/javascript';
423
+ const attempt = async () => {
424
+ const config = await api.createCauldronBundleChunkUploadConfig(deckId);
425
+ // FormData wants a Blob; copy so it does not share the Buffer's pool.
426
+ const view = new Uint8Array(chunk.bytes.byteLength);
427
+ view.set(chunk.bytes);
428
+ await uploadPresignedFile(config, new Blob([view], { type: contentType }), contentType, LARGE_UPLOAD_TIMEOUT_MS, `Chunk upload (${chunk.name})`);
429
+ const kind = chunk.kind === 'wasm' ? 'WASM' : 'JS';
430
+ return storeWhenNotBusy(() => api.storeCauldronBundleChunk(deckId, config.uploadId, chunk.sha256, kind), busyRetryMs);
431
+ };
432
+ try {
433
+ return await attempt();
434
+ }
435
+ catch (e) {
436
+ if (errorCode(e) !== UPLOAD_GRANT_INVALID)
437
+ throw e;
438
+ return attempt();
439
+ }
440
+ }
441
+ /**
442
+ * Puts every chunk at its content-addressed URL: a chunk already there (HEAD
443
+ * 200) is skipped, any other is uploaded and stored. Throws on the first chunk
444
+ * that cannot be stored, so the page naming them is never published without
445
+ * them. Exported for the tests.
446
+ */
447
+ export async function uploadBundleChunks(deckId, chunks, baseUrl = BUNDLE_CHUNK_BASE_URL, { busyRetryMs = CHUNK_BUSY_RETRY_MS } = {}) {
448
+ for (const chunk of chunks) {
449
+ const bytes = chunk.bytes.byteLength;
450
+ if (bytes > MAX_BUNDLE_CHUNK_BYTES) {
451
+ throw new Error(`Chunk ${chunk.name} is ${(bytes / 1024 / 1024).toFixed(1)}MB; Castle stores chunks of at most ` +
452
+ `${MAX_BUNDLE_CHUNK_BYTES / 1024 / 1024}MB. Nothing was published.`);
453
+ }
454
+ }
455
+ const result = { uploaded: 0, skipped: 0, bytesUploaded: 0 };
456
+ const queue = [...chunks];
457
+ // The first failure fails the save: the other workers take no new chunk.
458
+ let failed = false;
459
+ const worker = async () => {
460
+ for (let chunk = queue.shift(); chunk && !failed; chunk = queue.shift()) {
461
+ const url = `${baseUrl}${chunk.fileName}`;
462
+ if (await chunkAlreadyStored(url)) {
463
+ result.skipped++;
464
+ continue;
465
+ }
466
+ const stored = await storeBundleChunk(deckId, chunk, busyRetryMs);
467
+ if (stored?.sha256 !== chunk.sha256 || stored.url !== url) {
468
+ throw new Error(`Chunk ${chunk.name} was stored as ${stored?.url ?? 'nothing'} (sha256 ${stored?.sha256 ?? 'none'}), ` +
469
+ `not ${url}. Nothing was published.`);
470
+ }
471
+ result.uploaded++;
472
+ result.bytesUploaded += chunk.bytes.byteLength;
473
+ }
474
+ };
475
+ const guarded = () => worker().catch((e) => {
476
+ failed = true;
477
+ throw e;
478
+ });
479
+ await Promise.all(Array.from({ length: Math.min(CHUNK_UPLOAD_CONCURRENCY, chunks.length) }, guarded));
480
+ return result;
481
+ }
482
+ function reportChunks(page) {
483
+ const chunkBytes = page.chunks.reduce((sum, c) => sum + c.bytes.byteLength, 0);
484
+ const initial = page.chunks.filter((c) => c.initial).length;
485
+ const wasm = page.chunks.filter((c) => c.kind === 'wasm').length;
486
+ console.log(`Chunks: ${page.chunks.length} (${initial} loaded at start${wasm ? `, ${wasm} wasm` : ''}), ` +
487
+ `${(chunkBytes / 1024).toFixed(1)}KB.`);
488
+ for (const warning of page.warnings)
489
+ console.warn(`Warning: ${warning}`);
490
+ }
491
+ async function storeChunks(deckId, chunks) {
492
+ const stored = await traceSaveStage('chunk_upload', () => uploadBundleChunks(deckId, chunks), (value) => ({ bytes: value.bytesUploaded }));
493
+ console.log(`Chunks stored: ${stored.uploaded} uploaded, ${stored.skipped} already there.`);
494
+ }
495
+ // Checked before anything is bundled or published, like the experiments block.
496
+ function checkedBundleChunks(castleJson, opts) {
497
+ try {
498
+ return resolveBundleChunks(castleJson, opts.chunkedBundle === true);
499
+ }
500
+ catch (e) {
501
+ throw new Error(`${e instanceof Error ? e.message : String(e)} Nothing was saved.`);
502
+ }
503
+ }
381
504
  async function uploadLocalCover(projectDir) {
382
505
  try {
383
506
  const selected = await selectSaveCover(projectDir, { onProgress: (message) => console.log(message) });
@@ -463,14 +586,52 @@ export async function saveDeck(dir, opts = {}) {
463
586
  throw error;
464
587
  }
465
588
  }
589
+ // A save from castle-www or from inside a cloud sandbox: decks there save
590
+ // exactly as they did, with these checks only warning.
591
+ function cloudSave(env) {
592
+ return env[SAVE_FAILURE_ENV] === '1' || isSandboxEnv(env);
593
+ }
594
+ // How save-deck refreshes builtin kits: a pin older than this CLI moves to its
595
+ // kit -- except in a cloud save, where decks save exactly as they did.
596
+ export function builtinRefreshOptions(env = process.env) {
597
+ return { olderPins: !cloudSave(env) };
598
+ }
599
+ // False (exit code set) when save-deck must stop because imports/ holds other
600
+ // versions than castle.json pins. castle-www's cloud save understands only its
601
+ // own refusal and cannot pass the flag, so in a cloud save this is a warning, as
602
+ // an import regression is (and as `check` in a sandbox does).
603
+ function importPinsSettled(dir, projectDir, opts) {
604
+ if (settleImportPins(projectDir, dir, 'save-deck', opts.pinInstalledImports === true))
605
+ return true;
606
+ if (cloudSave(process.env)) {
607
+ console.error('Saving anyway (cloud save).');
608
+ return true;
609
+ }
610
+ process.exitCode = 1;
611
+ return false;
612
+ }
466
613
  async function saveDeckAfterValidation(dir, opts, projectDir, visibility) {
467
- // A builtin kit that changed under the same CLI version is this CLI's again
468
- // before anything is read, packed or bundled: a save never ships a stale copy
469
- // of it, and the pins a refreshed kit adds are in the castle.json read here.
470
- await refreshStaleBuiltinImports(projectDir);
614
+ // First, before anything is changed or the network touched: imports/ holding
615
+ // other versions than the pins is a deck no pin describes.
616
+ if (!importPinsSettled(dir, projectDir, opts))
617
+ return;
618
+ // A builtin kit that changed under the same CLI version, or is pinned at an
619
+ // older CLI, is this CLI's again before anything is read, packed or bundled: a
620
+ // save never ships a stale copy, and the pins a refreshed kit adds are read here.
621
+ const refreshed = await refreshStaleBuiltinImports(projectDir, undefined, builtinRefreshOptions());
622
+ // A refresh can restore a kit's new imports, at whatever the server has now.
623
+ if (refreshed.length > 0 && !importPinsSettled(dir, projectDir, opts))
624
+ return;
471
625
  const castleJson = readCastleJson(projectDir);
472
626
  const existingDeckId = typeof castleJson?.deckId === 'string' && castleJson.deckId ? castleJson.deckId : null;
473
627
  const experiments = checkedExperiments(castleJson);
628
+ const chunked = checkedBundleChunks(castleJson, opts);
629
+ if (chunked && !existingDeckId) {
630
+ // Ghost grants chunk uploads for a deck that exists; a new one is created
631
+ // by the publish itself, after the chunks must already be stored.
632
+ throw new Error('A chunked bundle can only be saved to a deck that already exists. Save once without ' +
633
+ '--chunked-bundle (or "bundle.chunks" in castle.json) first. Nothing was saved.');
634
+ }
474
635
  // A deck without an id is new: the source commit sends no precondition, as before.
475
636
  let expectedS3Key;
476
637
  let markerVia = 'save-deck';
@@ -514,17 +675,22 @@ async function saveDeckAfterValidation(dir, opts, projectDir, visibility) {
514
675
  // build, as far as publishing is concerned (and as castle-www's failed_at
515
676
  // reports it).
516
677
  const built = await traceSaveStage('bundle', async () => {
517
- const built = await bundleProject(projectDir);
678
+ const page = chunked ? await bundleProjectChunked(projectDir) : null;
679
+ const html = page ? page.renderHtml(BUNDLE_CHUNK_BASE_URL) : await bundleProject(projectDir);
518
680
  const { errors } = await runImportChecks(projectDir);
519
681
  if (errors.length > 0)
520
682
  throw new Error(importChecksFailedMessage(errors));
521
- return { html: built, pack: await buildContentPack(projectDir) };
683
+ return { html, page, pack: await buildContentPack(projectDir) };
522
684
  }, (value) => ({ bytes: Buffer.byteLength(value.html) }));
523
- const { html: bundle, pack } = built;
685
+ const { html: bundle, page: chunkedPage, pack } = built;
524
686
  if (pack)
525
687
  console.log(`Content pack: ${pack.summary ?? `${pack.bytes.byteLength} bytes`} (${pack.sha256.slice(0, 12)}).`);
688
+ // In chunked mode this is the page alone: the chunks load as separate,
689
+ // cacheable scripts and are reported on their own line.
526
690
  const sizeKB = bundle.length / 1024;
527
691
  console.log(`Bundle size: ${sizeKB.toFixed(1)}KB`);
692
+ if (chunkedPage)
693
+ reportChunks(chunkedPage);
528
694
  if (sizeKB > 1024) {
529
695
  console.warn(`Warning: Bundle is ${(sizeKB / 1024).toFixed(1)}MB. Large bundles may load slowly.`);
530
696
  }
@@ -548,6 +714,9 @@ async function saveDeckAfterValidation(dir, opts, projectDir, visibility) {
548
714
  // transferred. The promise is deliberately non-throwing: a thumbnail must never make the
549
715
  // content upload fail or create an unhandled rejection if that upload exits early.
550
716
  const backgroundImageFileIdPromise = traceSaveStage('cover', () => uploadLocalCover(projectDir), (value) => ({ coverUploaded: value !== null }));
717
+ // Every chunk the page names is stored before the page itself is uploaded.
718
+ if (chunkedPage)
719
+ await storeChunks(deckId, chunkedPage.chunks);
551
720
  // Upload scene data to S3
552
721
  const configs = await traceSaveStage('scene_upload_config', async () => {
553
722
  const result = await api.createSceneDataUploadConfig([cardId]);