castle-web-cli 0.4.233 → 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 (381) hide show
  1. package/dist/api.d.ts +11 -0
  2. package/dist/api.js +43 -0
  3. package/dist/bundle.d.ts +64 -0
  4. package/dist/bundle.js +558 -2
  5. package/dist/castle-host/host.d.ts +17 -2
  6. package/dist/castle-host/host.js +793 -36
  7. package/dist/castleJson.d.ts +20 -1
  8. package/dist/castleJson.js +44 -2
  9. package/dist/check.js +9 -2
  10. package/dist/chunkLoader.d.ts +3 -0
  11. package/dist/chunkLoader.js +111 -0
  12. package/dist/devParty.d.ts +26 -0
  13. package/dist/devParty.js +231 -0
  14. package/dist/devSaveStorage.js +4 -0
  15. package/dist/devSessionStorage.js +3 -1
  16. package/dist/devSocial.d.ts +24 -0
  17. package/dist/devSocial.js +70 -0
  18. package/dist/ide.d.ts +2 -0
  19. package/dist/ide.js +119 -15
  20. package/dist/index.js +8 -2
  21. package/dist/init.js +1 -1
  22. package/dist/save-deck.d.ts +20 -1
  23. package/dist/save-deck.js +141 -5
  24. package/dist/serve.js +29 -11
  25. package/dist/shell/assets/{index-BjOxR-lW.js → index-DulbYIJm.js} +97 -97
  26. package/dist/shell/index.html +1 -1
  27. package/dist/vitePlugins.d.ts +2 -1
  28. package/dist/vitePlugins.js +13 -0
  29. package/kits/base/castle.json +1 -1
  30. package/kits/base/sdk/README.md +260 -3
  31. package/kits/base/sdk/castle.d.ts +7 -3
  32. package/kits/base/sdk/castle.js +2 -0
  33. package/kits/base/sdk/commands.d.ts +162 -1
  34. package/kits/base/sdk/commands.js +3 -0
  35. package/kits/base/sdk/display.d.ts +3 -0
  36. package/kits/base/sdk/display.js +9 -3
  37. package/kits/base/sdk/hub.d.ts +33 -6
  38. package/kits/base/sdk/hub.js +50 -4
  39. package/kits/base/sdk/multiplayer.d.ts +7 -1
  40. package/kits/base/sdk/multiplayer.js +140 -40
  41. package/kits/base/sdk/multiplayerProtocol.d.ts +2 -0
  42. package/kits/base/sdk/party.d.ts +23 -0
  43. package/kits/base/sdk/party.js +91 -0
  44. package/kits/base/sdk/reconnectBudget.d.ts +23 -0
  45. package/kits/base/sdk/reconnectBudget.js +96 -0
  46. package/kits/base/sdk/save.d.ts +38 -1
  47. package/kits/base/sdk/save.js +79 -6
  48. package/kits/base/sdk/server/hub.d.ts +31 -1
  49. package/kits/base/sdk/server/hub.js +50 -3
  50. package/kits/base/sdk/server/platformHandle.d.ts +13 -1
  51. package/kits/base/sdk/server/storage.d.ts +4 -0
  52. package/kits/base/sdk/server/storage.js +19 -3
  53. package/kits/base/sdk/server/wrapper.d.ts +7 -1
  54. package/kits/base/sdk/server/wrapper.js +10 -1
  55. package/kits/base/sdk/social.d.ts +9 -0
  56. package/kits/base/sdk/social.js +5 -0
  57. package/kits/hub-game/CLAUDE.md +123 -3
  58. package/kits/hub-game/README.md +63 -0
  59. package/kits/hub-game/castle.json +5 -5
  60. package/kits/hub-game/code/client/act.js +312 -0
  61. package/kits/hub-game/code/client/actionLayout.js +147 -0
  62. package/kits/hub-game/code/client/actionOverflow.js +556 -0
  63. package/kits/hub-game/code/client/arrivalCamera.js +50 -0
  64. package/kits/hub-game/code/client/askSlot.js +117 -0
  65. package/kits/hub-game/code/client/avatar.js +4 -2
  66. package/kits/hub-game/code/client/avatarShare.js +2 -0
  67. package/kits/hub-game/code/client/backVisibility.js +13 -0
  68. package/kits/hub-game/code/client/ballot.js +15 -10
  69. package/kits/hub-game/code/client/build.js +16 -0
  70. package/kits/hub-game/code/client/chat.js +41 -5
  71. package/kits/hub-game/code/client/chatModeration.js +5 -0
  72. package/kits/hub-game/code/client/chrome.js +1148 -258
  73. package/kits/hub-game/code/client/crowdNames.js +241 -0
  74. package/kits/hub-game/code/client/decor.js +10 -4
  75. package/kits/hub-game/code/client/defaultEnvironment.js +194 -0
  76. package/kits/hub-game/code/client/doorErrors.js +39 -0
  77. package/kits/hub-game/code/client/fall.js +18 -0
  78. package/kits/hub-game/code/client/farAvatars.js +233 -0
  79. package/kits/hub-game/code/client/firstJoin.js +9 -2
  80. package/kits/hub-game/code/client/fpsTelemetry.js +50 -0
  81. package/kits/hub-game/code/client/frameBatch.js +5 -0
  82. package/kits/hub-game/code/client/grab.js +31 -11
  83. package/kits/hub-game/code/client/hookLayer.js +87 -8
  84. package/kits/hub-game/code/client/hudCopy.js +51 -0
  85. package/kits/hub-game/code/client/hudRate.js +20 -0
  86. package/kits/hub-game/code/client/idle.js +14 -2
  87. package/kits/hub-game/code/client/invites.js +231 -0
  88. package/kits/hub-game/code/client/joinError.js +9 -0
  89. package/kits/hub-game/code/client/labelsNear.js +31 -2
  90. package/kits/hub-game/code/client/landscapeLayout.js +17 -0
  91. package/kits/hub-game/code/client/layoutCache.js +264 -0
  92. package/kits/hub-game/code/client/loadTelemetry.js +20 -0
  93. package/kits/hub-game/code/client/loadingCover.js +148 -0
  94. package/kits/hub-game/code/client/loadingEntry.js +8 -0
  95. package/kits/hub-game/code/client/menuRows.js +43 -0
  96. package/kits/hub-game/code/client/modelReady.js +7 -0
  97. package/kits/hub-game/code/client/padCueArrival.js +23 -0
  98. package/kits/hub-game/code/client/padCues.js +112 -0
  99. package/kits/hub-game/code/client/padOccupancy.js +88 -0
  100. package/kits/hub-game/code/client/padReadability.js +26 -0
  101. package/kits/hub-game/code/client/padRings.js +69 -0
  102. package/kits/hub-game/code/client/pushVisit.js +14 -0
  103. package/kits/hub-game/code/client/quality.js +205 -0
  104. package/kits/hub-game/code/client/qualityEntry.js +55 -0
  105. package/kits/hub-game/code/client/safeLayout.js +338 -0
  106. package/kits/hub-game/code/client/safeStyle.js +42 -0
  107. package/kits/hub-game/code/client/say.js +12 -3
  108. package/kits/hub-game/code/client/shot.js +64 -10
  109. package/kits/hub-game/code/client/shotFit.js +56 -0
  110. package/kits/hub-game/code/client/signIn.js +28 -0
  111. package/kits/hub-game/code/client/state.js +53 -0
  112. package/kits/hub-game/code/client/talk.js +209 -45
  113. package/kits/hub-game/code/client/tiers.js +68 -66
  114. package/kits/hub-game/code/client/together.js +7 -2
  115. package/kits/hub-game/code/client/weakestLookBake.js +92 -0
  116. package/kits/hub-game/code/client/weakestTier.js +295 -0
  117. package/kits/hub-game/code/client/worldLabels.js +241 -0
  118. package/kits/hub-game/code/client/yours.js +10 -9
  119. package/kits/hub-game/code/npcDisplayText.js +55 -0
  120. package/kits/hub-game/code/server/act.js +124 -0
  121. package/kits/hub-game/code/server/actions.js +6 -1
  122. package/kits/hub-game/code/server/actors.js +2 -1
  123. package/kits/hub-game/code/server/analytics.js +83 -0
  124. package/kits/hub-game/code/server/anonymousEntry.js +49 -0
  125. package/kits/hub-game/code/server/arrivalPose.js +36 -0
  126. package/kits/hub-game/code/server/companion.js +28 -3
  127. package/kits/hub-game/code/server/doorAnalytics.js +52 -0
  128. package/kits/hub-game/code/server/earned.js +22 -5
  129. package/kits/hub-game/code/server/frameBatch.js +183 -0
  130. package/kits/hub-game/code/server/friendsAmong.js +49 -9
  131. package/kits/hub-game/code/server/history.js +2 -0
  132. package/kits/hub-game/code/server/hub.js +1306 -95
  133. package/kits/hub-game/code/server/idle.js +30 -1
  134. package/kits/hub-game/code/server/index.js +26 -4
  135. package/kits/hub-game/code/server/invites.js +19 -0
  136. package/kits/hub-game/code/server/labels.js +9 -1
  137. package/kits/hub-game/code/server/loadAbandon.js +106 -0
  138. package/kits/hub-game/code/server/manifest.js +211 -3
  139. package/kits/hub-game/code/server/menu.js +31 -3
  140. package/kits/hub-game/code/server/npcs.js +226 -64
  141. package/kits/hub-game/code/server/observe.js +408 -0
  142. package/kits/hub-game/code/server/padOccupancy.js +85 -0
  143. package/kits/hub-game/code/server/players.js +9 -1
  144. package/kits/hub-game/code/server/resumePose.js +152 -0
  145. package/kits/hub-game/code/server/say.js +1 -1
  146. package/kits/hub-game/code/server/standing.js +4 -5
  147. package/kits/hub-game/code/server/storageLimit.js +187 -0
  148. package/kits/hub-game/code/server/vis.js +67 -5
  149. package/kits/hub-game/code/shared/act.js +35 -0
  150. package/kits/hub-game/code/shared/danceIdle.js +28 -0
  151. package/kits/hub-game/code/shared/loadStages.js +12 -0
  152. package/kits/hub-game/code/shared/quality.js +74 -0
  153. package/kits/hub-game/code/shared/say.js +2 -0
  154. package/kits/hub-game/code/shared/shot.js +35 -1
  155. package/kits/hub-game/code/systems/hub.js +970 -169
  156. package/kits/hub-game/docs/analytics.md +279 -0
  157. package/kits/hub-game/docs/contract.md +1257 -42
  158. package/kits/hub-game/docs/home-pieces.md +9 -2
  159. package/kits/hub-game/docs/observed-progress.md +252 -0
  160. package/kits/hub-game/main.jsx +2 -0
  161. package/kits/hub-game/package-lock.json +10 -3
  162. package/kits/hub-game/package.json +6 -3
  163. package/kits/hub-game/play/player.js +142 -0
  164. package/kits/hub-game/play/registry.js +47 -0
  165. package/kits/hub-game/play.jsx +37 -0
  166. package/kits/hub-game/scripts/check.mjs +39 -5
  167. package/kits/hub-game/scripts/companion-follower-wire.json +1 -1
  168. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +11 -0
  169. package/kits/hub-game/scripts/fixtures/decor-keyless.json +5 -5
  170. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +3 -0
  171. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +19 -3
  172. package/kits/hub-game/scripts/fixtures/interest-legacy.json +3 -3
  173. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -1
  174. package/kits/hub-game/scripts/pose-storage-fixture.mjs +46 -0
  175. package/kits/hub-game/scripts/test-act-client.mjs +186 -0
  176. package/kits/hub-game/scripts/test-act.mjs +171 -0
  177. package/kits/hub-game/scripts/test-action-layout.mjs +80 -0
  178. package/kits/hub-game/scripts/test-action-observers.mjs +46 -0
  179. package/kits/hub-game/scripts/test-actions-client.mjs +367 -2
  180. package/kits/hub-game/scripts/test-actors.mjs +20 -7
  181. package/kits/hub-game/scripts/test-analytics.mjs +76 -0
  182. package/kits/hub-game/scripts/test-anonymous-entry.mjs +28 -0
  183. package/kits/hub-game/scripts/test-arrival-pose-server.mjs +196 -0
  184. package/kits/hub-game/scripts/test-arrival-pose.mjs +24 -0
  185. package/kits/hub-game/scripts/test-ask-slot.mjs +85 -0
  186. package/kits/hub-game/scripts/test-avatar-wire.mjs +49 -10
  187. package/kits/hub-game/scripts/test-avatar.mjs +44 -0
  188. package/kits/hub-game/scripts/test-back-visibility.mjs +82 -0
  189. package/kits/hub-game/scripts/test-ballot.mjs +11 -4
  190. package/kits/hub-game/scripts/test-ban-join.mjs +121 -13
  191. package/kits/hub-game/scripts/test-build.mjs +20 -2
  192. package/kits/hub-game/scripts/test-chat.mjs +206 -5
  193. package/kits/hub-game/scripts/test-companion-chat.mjs +20 -2
  194. package/kits/hub-game/scripts/test-control-layout-dom.mjs +120 -0
  195. package/kits/hub-game/scripts/test-crowd-names.mjs +205 -0
  196. package/kits/hub-game/scripts/test-decor-client.mjs +45 -4
  197. package/kits/hub-game/scripts/test-decor.mjs +7 -0
  198. package/kits/hub-game/scripts/test-default-environment-root.mjs +95 -0
  199. package/kits/hub-game/scripts/test-default-environment.mjs +267 -0
  200. package/kits/hub-game/scripts/test-door-analytics.mjs +58 -0
  201. package/kits/hub-game/scripts/test-door-jump.mjs +100 -0
  202. package/kits/hub-game/scripts/test-earned.mjs +33 -3
  203. package/kits/hub-game/scripts/test-far-avatars.mjs +340 -0
  204. package/kits/hub-game/scripts/test-fps-telemetry.mjs +112 -0
  205. package/kits/hub-game/scripts/test-frame-batch.mjs +252 -0
  206. package/kits/hub-game/scripts/test-fresh-friends.mjs +118 -0
  207. package/kits/hub-game/scripts/test-grab-orbit.mjs +47 -4
  208. package/kits/hub-game/scripts/test-high-only.mjs +170 -0
  209. package/kits/hub-game/scripts/test-hub-ops.mjs +321 -2
  210. package/kits/hub-game/scripts/test-hub-trip.mjs +879 -11
  211. package/kits/hub-game/scripts/test-hud-clear.mjs +162 -59
  212. package/kits/hub-game/scripts/test-hud-defects-dom.mjs +100 -0
  213. package/kits/hub-game/scripts/test-hud-rate.mjs +224 -0
  214. package/kits/hub-game/scripts/test-hud-safe-visibility-dom.mjs +83 -0
  215. package/kits/hub-game/scripts/test-idle.mjs +66 -0
  216. package/kits/hub-game/scripts/test-interest-cells.mjs +20 -0
  217. package/kits/hub-game/scripts/test-interest.mjs +15 -0
  218. package/kits/hub-game/scripts/test-invites-client.mjs +430 -0
  219. package/kits/hub-game/scripts/test-invites.mjs +109 -0
  220. package/kits/hub-game/scripts/test-labels.mjs +71 -3
  221. package/kits/hub-game/scripts/test-landscape-layout.mjs +194 -0
  222. package/kits/hub-game/scripts/test-list-scroll-dom.mjs +49 -0
  223. package/kits/hub-game/scripts/test-load-abandon.mjs +246 -0
  224. package/kits/hub-game/scripts/test-loading-cover.mjs +162 -0
  225. package/kits/hub-game/scripts/test-manifest.mjs +265 -0
  226. package/kits/hub-game/scripts/test-menu-client.mjs +105 -0
  227. package/kits/hub-game/scripts/test-menu.mjs +23 -0
  228. package/kits/hub-game/scripts/test-npcs.mjs +819 -10
  229. package/kits/hub-game/scripts/test-observed.mjs +745 -0
  230. package/kits/hub-game/scripts/test-pad-cues.mjs +304 -0
  231. package/kits/hub-game/scripts/test-pad-occupancy.mjs +177 -0
  232. package/kits/hub-game/scripts/test-picker.mjs +234 -7
  233. package/kits/hub-game/scripts/test-placement-cache.mjs +690 -0
  234. package/kits/hub-game/scripts/test-progress-reset.mjs +559 -0
  235. package/kits/hub-game/scripts/test-push-visit.mjs +26 -0
  236. package/kits/hub-game/scripts/test-quality.mjs +385 -0
  237. package/kits/hub-game/scripts/test-rehello.mjs +699 -5
  238. package/kits/hub-game/scripts/test-resume-action-order.mjs +598 -0
  239. package/kits/hub-game/scripts/test-resume-held.mjs +239 -0
  240. package/kits/hub-game/scripts/test-resume-pose.mjs +142 -0
  241. package/kits/hub-game/scripts/test-safe-events-dom.mjs +116 -0
  242. package/kits/hub-game/scripts/test-safe-layout.mjs +330 -0
  243. package/kits/hub-game/scripts/test-say.mjs +1 -1
  244. package/kits/hub-game/scripts/test-shot.mjs +145 -0
  245. package/kits/hub-game/scripts/test-signin-client.mjs +45 -0
  246. package/kits/hub-game/scripts/test-soundscape.mjs +22 -17
  247. package/kits/hub-game/scripts/test-standing.mjs +35 -2
  248. package/kits/hub-game/scripts/test-storage-limit.mjs +333 -0
  249. package/kits/hub-game/scripts/test-stuck.mjs +5 -4
  250. package/kits/hub-game/scripts/test-talk-overlay-dom.mjs +130 -0
  251. package/kits/hub-game/scripts/test-tiers-render.mjs +86 -13
  252. package/kits/hub-game/scripts/test-tiers.mjs +7 -8
  253. package/kits/hub-game/scripts/test-vis.mjs +433 -6
  254. package/kits/hub-game/scripts/test-weakest-tier.mjs +924 -0
  255. package/kits/hub-game/scripts/test-world-labels.mjs +367 -0
  256. package/kits/hub-game/scripts/test-yours-chrome.mjs +50 -6
  257. package/kits/hub-game/scripts/test-yours.mjs +39 -8
  258. package/kits/multiplayer-3d/castle.json +5 -5
  259. package/kits/multiplayer-3d/code/client/joinFailure.js +27 -0
  260. package/kits/multiplayer-3d/code/client/resumeGate.js +139 -0
  261. package/kits/multiplayer-3d/code/systems/multiplayer.js +369 -30
  262. package/kits/multiplayer-3d/package-lock.json +8 -1
  263. package/kits/multiplayer-3d/package.json +2 -1
  264. package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +436 -0
  265. package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +624 -0
  266. package/kits/physics-2d/CLAUDE.md +10 -1
  267. package/kits/physics-2d/castle.json +2 -2
  268. package/kits/physics-2d/engine/frozenActors.js +233 -0
  269. package/kits/physics-2d/engine/scene.js +87 -5
  270. package/kits/physics-2d/eslint.config.js +1 -1
  271. package/kits/physics-2d/play/behaviors/AnalogStick.js +198 -0
  272. package/kits/physics-2d/play/behaviors/Camera.js +40 -0
  273. package/kits/physics-2d/play/behaviors/Collider.js +122 -0
  274. package/kits/physics-2d/play/behaviors/Draggable.js +115 -0
  275. package/kits/physics-2d/play/behaviors/Goal.js +46 -0
  276. package/kits/physics-2d/play/behaviors/Joints.js +126 -0
  277. package/kits/physics-2d/play/behaviors/Layout.js +71 -0
  278. package/kits/physics-2d/play/behaviors/RigidBody.js +57 -0
  279. package/kits/physics-2d/play/behaviors/Slingshot.js +142 -0
  280. package/kits/physics-2d/play/behaviors/SoundPlayer.js +263 -0
  281. package/kits/physics-2d/play/behaviors/Sprite.js +406 -0
  282. package/kits/physics-2d/play/behaviors/Style.js +209 -0
  283. package/kits/physics-2d/play/behaviors/Text.js +85 -0
  284. package/kits/physics-2d/play/behaviors/Video.js +93 -0
  285. package/kits/physics-3d/CLAUDE.md +25 -1651
  286. package/kits/physics-3d/behaviors/Body.jsx +3 -0
  287. package/kits/physics-3d/behaviors/Model.jsx +3 -0
  288. package/kits/physics-3d/behaviors/Player.jsx +35 -18
  289. package/kits/physics-3d/behaviors/Shape.jsx +3 -0
  290. package/kits/physics-3d/behaviors/Solid.jsx +3 -0
  291. package/kits/physics-3d/behaviors/Transform.jsx +3 -0
  292. package/kits/physics-3d/castle.json +3 -3
  293. package/kits/physics-3d/docs/engine-camera.md +542 -0
  294. package/kits/physics-3d/docs/engine-frame-cap.md +136 -0
  295. package/kits/physics-3d/docs/engine-load.md +149 -0
  296. package/kits/physics-3d/docs/engine-look.md +114 -0
  297. package/kits/physics-3d/docs/engine-shadows.md +372 -0
  298. package/kits/physics-3d/docs/engine-skip-work.md +187 -0
  299. package/kits/physics-3d/docs/engine-sky.md +198 -0
  300. package/kits/physics-3d/docs/engine-static-actors.md +226 -0
  301. package/kits/physics-3d/docs/engine-view.md +37 -0
  302. package/kits/physics-3d/docs/pxmodel-format.md +1 -1
  303. package/kits/physics-3d/engine3d/PlayOnly3D.jsx +5 -1
  304. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +19 -333
  305. package/kits/physics-3d/engine3d/actornode.js +1 -0
  306. package/kits/physics-3d/engine3d/branches.js +3 -13
  307. package/kits/physics-3d/engine3d/cage.js +2 -7
  308. package/kits/physics-3d/engine3d/cageops.js +2 -17
  309. package/kits/physics-3d/engine3d/dataBehaviors.js +12 -0
  310. package/kits/physics-3d/engine3d/framecap.js +4 -1
  311. package/kits/physics-3d/engine3d/frozenphysics.js +140 -0
  312. package/kits/physics-3d/engine3d/frozenstatics.js +273 -0
  313. package/kits/physics-3d/engine3d/gait.js +8 -0
  314. package/kits/physics-3d/engine3d/initialModelFiles.js +18 -0
  315. package/kits/physics-3d/engine3d/look.js +7 -0
  316. package/kits/physics-3d/engine3d/modelFiles.js +3 -17
  317. package/kits/physics-3d/engine3d/modelMath.js +49 -0
  318. package/kits/physics-3d/engine3d/modelready.js +16 -0
  319. package/kits/physics-3d/engine3d/motion.js +3 -3
  320. package/kits/physics-3d/engine3d/nearshadows.js +77 -10
  321. package/kits/physics-3d/engine3d/orbitinput.js +59 -25
  322. package/kits/physics-3d/engine3d/partgeometry.js +1 -16
  323. package/kits/physics-3d/engine3d/paths.js +1 -9
  324. package/kits/physics-3d/engine3d/playTimings.js +50 -0
  325. package/kits/physics-3d/engine3d/playerRun.js +372 -0
  326. package/kits/physics-3d/engine3d/pxmodel.js +3 -3
  327. package/kits/physics-3d/engine3d/rapier.js +27 -0
  328. package/kits/physics-3d/engine3d/scatter.js +1 -11
  329. package/kits/physics-3d/engine3d/shadowfade.js +23 -15
  330. package/kits/physics-3d/engine3d/sky.js +1 -1
  331. package/kits/physics-3d/engine3d/squarefirst.js +177 -0
  332. package/kits/physics-3d/engine3d/stillshadows.js +399 -0
  333. package/kits/physics-3d/engine3d/sweep.js +1 -25
  334. package/kits/physics-3d/engine3d/world3d.js +468 -18
  335. package/kits/physics-3d/eslint.config.js +2 -1
  336. package/kits/physics-3d/main.jsx +6 -3
  337. package/kits/physics-3d/package-lock.json +7 -0
  338. package/kits/physics-3d/package.json +5 -1
  339. package/kits/physics-3d/play/behaviors/Body.js +31 -0
  340. package/kits/physics-3d/play/behaviors/Door.js +37 -0
  341. package/kits/physics-3d/play/behaviors/Lookable.js +16 -0
  342. package/kits/physics-3d/play/behaviors/Model.js +23 -0
  343. package/kits/physics-3d/play/behaviors/Pickup.js +46 -0
  344. package/kits/physics-3d/play/behaviors/Player.js +1204 -0
  345. package/kits/physics-3d/play/behaviors/Shape.js +47 -0
  346. package/kits/physics-3d/play/behaviors/Solid.js +16 -0
  347. package/kits/physics-3d/play/behaviors/Transform.js +29 -0
  348. package/kits/physics-3d/pnpm-lock.yaml +8 -0
  349. package/kits/physics-3d/scripts/bench-shadow-fade.mjs +37 -0
  350. package/kits/physics-3d/scripts/build-rapier-gz.mjs +56 -0
  351. package/kits/physics-3d/scripts/frozen-statics-fixture.mjs +141 -0
  352. package/kits/physics-3d/scripts/test-camera-follow.mjs +5 -1
  353. package/kits/physics-3d/scripts/test-camera-orbit.mjs +52 -4
  354. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +1 -1
  355. package/kits/physics-3d/scripts/test-empty-gait-hints.mjs +89 -0
  356. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +6 -3
  357. package/kits/physics-3d/scripts/test-frame-cap.mjs +1 -1
  358. package/kits/physics-3d/scripts/test-frozen-nested.mjs +49 -0
  359. package/kits/physics-3d/scripts/test-frozen-statics-legacy-physics2d.mjs +123 -0
  360. package/kits/physics-3d/scripts/test-frozen-statics.mjs +434 -0
  361. package/kits/physics-3d/scripts/test-look-bake.mjs +1 -1
  362. package/kits/physics-3d/scripts/test-near-shadows.mjs +2 -2
  363. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +88 -7
  364. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +40 -3
  365. package/kits/physics-3d/scripts/test-orbit-shot.mjs +75 -1
  366. package/kits/physics-3d/scripts/test-rapier-gz.mjs +106 -0
  367. package/kits/physics-3d/scripts/test-sky.mjs +1 -1
  368. package/kits/physics-3d/scripts/test-square-first.mjs +921 -0
  369. package/kits/physics-3d/scripts/test-static-actors.mjs +3 -1
  370. package/kits/physics-3d/scripts/test-static-physics.mjs +4 -1
  371. package/kits/physics-3d/scripts/test-static-scenery.mjs +5 -2
  372. package/kits/physics-3d/scripts/test-steady-hover.mjs +5 -2
  373. package/kits/physics-3d/scripts/test-still-shadows.mjs +477 -0
  374. package/kits/physics-3d/systems/physics3d.js +37 -4
  375. package/kits/real-time/castle.json +2 -2
  376. package/kits/real-time/code/client/connection.js +33 -10
  377. package/kits/real-time/code/client/gameHooks.js +2 -0
  378. package/kits/real-time/code/client/joinOverlay.js +9 -4
  379. package/kits/real-time/code/server/session.js +6 -4
  380. package/kits/real-time/package-lock.json +1 -1
  381. package/package.json +2 -2
package/dist/ide.js CHANGED
@@ -241,6 +241,83 @@ const FILES_IGNORE_DIRS = new Set(['.git', '.castle', 'node_modules', 'dist', FO
241
241
  // read-only and unlocking around writes races with concurrent processes, gets
242
242
  // clobbered by tools, and still would not stop a raw shell write.
243
243
  const PROTECTED_WRITE_DIRS = new Set(['.castle']);
244
+ // Deck-root files the files API will not delete or rename away, nor let another
245
+ // file be moved over. Without `castle.json` a deck is not a deck: every cloud save
246
+ // is refused until it comes back. The bootstrap binding is what ties a cloud deck
247
+ // to its owner. Writing new contents into either stays an ordinary edit.
248
+ const DECK_ROOT_ANCHORS = new Map([
249
+ ['castle.json', "castle.json defines this deck and can't be deleted or renamed."],
250
+ [
251
+ '.castle-cloud-bootstrap-binding',
252
+ ".castle-cloud-bootstrap-binding ties this cloud deck to its owner and can't be deleted or renamed.",
253
+ ],
254
+ ]);
255
+ // Where a path lands on disk with every symlinked DIRECTORY on the way resolved,
256
+ // but not the last component: a delete or rename acts on that entry itself (a
257
+ // symlink is removed or moved, never followed). Parents that don't exist yet --
258
+ // a rename destination -- resolve through their nearest existing ancestor.
259
+ function physicalPath(abs) {
260
+ const tail = [path.basename(abs)];
261
+ let dir = path.dirname(abs);
262
+ for (;;) {
263
+ try {
264
+ return path.join(fs.realpathSync(dir), ...tail);
265
+ }
266
+ catch {
267
+ const parent = path.dirname(dir);
268
+ if (parent === dir)
269
+ return abs;
270
+ tail.unshift(path.basename(dir));
271
+ dir = parent;
272
+ }
273
+ }
274
+ }
275
+ function realOrSelf(abs) {
276
+ try {
277
+ return fs.realpathSync(abs);
278
+ }
279
+ catch {
280
+ return abs;
281
+ }
282
+ }
283
+ // The refusal for a resolved deck path that IS one of the anchors (or the deck
284
+ // root), or null. `rel` is already normalized by resolveDeckPath (`./castle.json`,
285
+ // `castle.json/` and `a/../castle.json` all arrive as `castle.json`), but it is
286
+ // lexical: `alias/castle.json` with `alias -> .` names the same file, so the
287
+ // comparison is made on the physical path. The inode check also catches another
288
+ // spelling of the name on a case-insensitive filesystem.
289
+ function deckRootAnchorRefusal(deckDir, target) {
290
+ const deckReal = realOrSelf(deckDir);
291
+ if (realOrSelf(target.abs) === deckReal) {
292
+ return `${target.rel} is the deck folder itself and can't be deleted or renamed.`;
293
+ }
294
+ const physical = physicalPath(target.abs);
295
+ const atRoot = path.dirname(physical) === deckReal;
296
+ const base = path.basename(physical);
297
+ for (const [name, refusal] of DECK_ROOT_ANCHORS) {
298
+ if (target.rel === name)
299
+ return refusal;
300
+ if (!atRoot)
301
+ continue;
302
+ if (base === name)
303
+ return refusal;
304
+ if (base.toLowerCase() === name && isSameFile(physical, path.join(deckReal, name))) {
305
+ return refusal;
306
+ }
307
+ }
308
+ return null;
309
+ }
310
+ // One `[files] ...` line in the deck's log per files API mutation, so a file that
311
+ // vanished can be traced to the editor. Best-effort: a failed log write never
312
+ // fails the request.
313
+ function logFilesMutation(log, line) {
314
+ try {
315
+ log?.(`[files] ${line}\n`);
316
+ }
317
+ catch {
318
+ // logging must never fail a files request
319
+ }
320
+ }
244
321
  // Ceiling on one uploaded file. A deck is saved whole (source tar + bundle), so
245
322
  // a huge asset is a problem for the deck long before it is a problem here --
246
323
  // refuse it at the door with a message rather than let it land and break `save`.
@@ -305,7 +382,9 @@ export function resolveDeckPath(deckDir, requestedPath, opts = {}) {
305
382
  }
306
383
  const abs = path.resolve(deckDir, normalized);
307
384
  const rel = path.relative(deckDir, abs);
308
- if (rel.startsWith('..') || path.isAbsolute(rel)) {
385
+ // `./` and `sub/../` normalize to `./`, not `.`, so the check above misses
386
+ // them; resolved, they are the deck root -- which a delete would remove whole.
387
+ if (rel === '' || rel.startsWith('..') || path.isAbsolute(rel)) {
309
388
  return { ok: false, error: `Path outside the deck: ${requestedPath}` };
310
389
  }
311
390
  const relPosix = rel.split(path.sep).join('/');
@@ -607,7 +686,7 @@ async function gitPanelAction(res, args, deckDir, onSuccess) {
607
686
  // over whatever landed in between, and the Parameters panel is the one that
608
687
  // needs it (it splices against its last read and ignores external changes while
609
688
  // its own write is in flight).
610
- function handleFilesWrite(deckDir, req, res, ledger) {
689
+ function handleFilesWrite(deckDir, req, res, ledger, log) {
611
690
  withMutationPath(deckDir, req, res, (target, body) => {
612
691
  if (typeof body.contents !== 'string') {
613
692
  return sendJson(res, 400, { error: 'File contents must be a string.' });
@@ -626,10 +705,14 @@ function handleFilesWrite(deckDir, req, res, ledger) {
626
705
  });
627
706
  }
628
707
  recordParamsWrite(deckDir, target.rel, body.tuned);
708
+ // A tune is a Parameters slider writing many times a second; the watcher's
709
+ // `[watch] ... tuned` line already covers it without flooding the log.
710
+ if (!body.tuned)
711
+ logFilesMutation(log, `write ${target.rel}`);
629
712
  sendJson(res, 200, { ok: true, path: target.rel });
630
713
  });
631
714
  }
632
- function handleFilesMkdir(deckDir, req, res) {
715
+ function handleFilesMkdir(deckDir, req, res, log) {
633
716
  withMutationPath(deckDir, req, res, (target) => {
634
717
  try {
635
718
  fs.mkdirSync(target.abs, { recursive: true });
@@ -637,6 +720,7 @@ function handleFilesMkdir(deckDir, req, res) {
637
720
  catch (err) {
638
721
  return sendFailure(res, 'create folder', target.rel, err);
639
722
  }
723
+ logFilesMutation(log, `mkdir ${target.rel}`);
640
724
  sendJson(res, 200, { ok: true, path: target.rel });
641
725
  });
642
726
  }
@@ -671,7 +755,7 @@ function handleCoverApi(deckDir, req, res) {
671
755
  });
672
756
  return true;
673
757
  }
674
- function handleFilesUpload(deckDir, req, res) {
758
+ function handleFilesUpload(deckDir, req, res, log) {
675
759
  const url = new URL(req.url ?? '/', 'http://localhost');
676
760
  const target = resolveDeckPath(deckDir, url.searchParams.get('path'), {
677
761
  mutation: true,
@@ -698,6 +782,7 @@ function handleFilesUpload(deckDir, req, res) {
698
782
  catch (err) {
699
783
  return sendFailure(res, 'upload', target.rel, err);
700
784
  }
785
+ logFilesMutation(log, `upload ${target.rel}`);
701
786
  sendJson(res, 200, { ok: true, path: target.rel });
702
787
  }, (err) => {
703
788
  if (err instanceof RangeError)
@@ -769,7 +854,7 @@ function isBinary(bytes) {
769
854
  }
770
855
  // Copy a file byte-for-byte. The Files panel's Duplicate goes through this
771
856
  // rather than read-then-write, which would corrupt anything binary.
772
- function handleFilesCopy(deckDir, req, res) {
857
+ function handleFilesCopy(deckDir, req, res, log) {
773
858
  withJsonBody(req, res, (body) => {
774
859
  const from = resolveDeckPath(deckDir, body.from);
775
860
  if (!from.ok)
@@ -786,6 +871,7 @@ function handleFilesCopy(deckDir, req, res) {
786
871
  try {
787
872
  fs.mkdirSync(path.dirname(to.abs), { recursive: true });
788
873
  fs.copyFileSync(from.abs, to.abs);
874
+ logFilesMutation(log, `copy ${from.rel} -> ${to.rel}`);
789
875
  sendJson(res, 200, { ok: true, path: to.rel });
790
876
  }
791
877
  catch (err) {
@@ -805,7 +891,7 @@ function isSameFile(a, b) {
805
891
  return false;
806
892
  }
807
893
  }
808
- function handleFilesRename(deckDir, req, res) {
894
+ function handleFilesRename(deckDir, req, res, log) {
809
895
  withJsonBody(req, res, (body) => {
810
896
  const from = resolveDeckPath(deckDir, body.from, { mutation: true });
811
897
  if (!from.ok)
@@ -813,6 +899,15 @@ function handleFilesRename(deckDir, req, res) {
813
899
  const to = resolveDeckPath(deckDir, body.to, { mutation: true });
814
900
  if (!to.ok)
815
901
  return sendJson(res, 400, { error: to.error });
902
+ // Renaming an anchor away loses it as surely as deleting it; moving another
903
+ // file over one replaces it. Moving a file INTO an anchor's empty slot is
904
+ // allowed -- that is how a lost castle.json comes back.
905
+ const anchorRefusal = deckRootAnchorRefusal(deckDir, from) ??
906
+ (fs.existsSync(to.abs) ? deckRootAnchorRefusal(deckDir, to) : null);
907
+ if (anchorRefusal) {
908
+ logFilesMutation(log, `refused rename ${from.rel} -> ${to.rel}`);
909
+ return sendJson(res, 400, { error: anchorRefusal });
910
+ }
816
911
  if (!fs.existsSync(from.abs)) {
817
912
  return sendJson(res, 404, { error: `Not found: ${from.rel}` });
818
913
  }
@@ -826,6 +921,7 @@ function handleFilesRename(deckDir, req, res) {
826
921
  try {
827
922
  fs.mkdirSync(path.dirname(to.abs), { recursive: true });
828
923
  fs.renameSync(from.abs, to.abs);
924
+ logFilesMutation(log, `rename ${from.rel} -> ${to.rel}`);
829
925
  sendJson(res, 200, { ok: true, path: to.rel });
830
926
  }
831
927
  catch (err) {
@@ -833,13 +929,21 @@ function handleFilesRename(deckDir, req, res) {
833
929
  }
834
930
  });
835
931
  }
836
- function handleFilesDelete(deckDir, req, res) {
932
+ function handleFilesDelete(deckDir, req, res, log) {
837
933
  withMutationPath(deckDir, req, res, (target) => {
934
+ // resolveDeckPath refuses the deck root by name; a symlink into it (to the
935
+ // root itself, or to a folder that holds an anchor) is caught here.
936
+ const anchorRefusal = deckRootAnchorRefusal(deckDir, target);
937
+ if (anchorRefusal) {
938
+ logFilesMutation(log, `refused delete ${target.rel}`);
939
+ return sendJson(res, 400, { error: anchorRefusal });
940
+ }
838
941
  if (!fs.existsSync(target.abs)) {
839
942
  return sendJson(res, 404, { error: `Not found: ${target.rel}` });
840
943
  }
841
944
  try {
842
945
  fs.rmSync(target.abs, { recursive: true, force: true });
946
+ logFilesMutation(log, `delete ${target.rel}`);
843
947
  sendJson(res, 200, { ok: true, path: target.rel });
844
948
  }
845
949
  catch (err) {
@@ -856,7 +960,7 @@ function playSnapEnabled() {
856
960
  // The builtin Files + code-editor backend: list / read / write deck files and
857
961
  // report kit-owned editor extensions. Paths are deck-relative; resolveDeckPath
858
962
  // rejects traversal and protected dirs.
859
- function handleFilesApi(deckDir, req, res, reqPath, restart, invalidate, tuneLedger) {
963
+ function handleFilesApi(deckDir, req, res, reqPath, restart, invalidate, tuneLedger, log) {
860
964
  const action = reqPath.slice(FILES_API_PREFIX.length);
861
965
  if (action === 'info') {
862
966
  const config = readEditorConfig(deckDir);
@@ -1023,27 +1127,27 @@ function handleFilesApi(deckDir, req, res, reqPath, restart, invalidate, tuneLed
1023
1127
  return true;
1024
1128
  }
1025
1129
  if (action === 'copy') {
1026
- handleFilesCopy(deckDir, req, res);
1130
+ handleFilesCopy(deckDir, req, res, log);
1027
1131
  return true;
1028
1132
  }
1029
1133
  if (action === 'write') {
1030
- handleFilesWrite(deckDir, req, res, tuneLedger);
1134
+ handleFilesWrite(deckDir, req, res, tuneLedger, log);
1031
1135
  return true;
1032
1136
  }
1033
1137
  if (action === 'rename') {
1034
- handleFilesRename(deckDir, req, res);
1138
+ handleFilesRename(deckDir, req, res, log);
1035
1139
  return true;
1036
1140
  }
1037
1141
  if (action === 'delete') {
1038
- handleFilesDelete(deckDir, req, res);
1142
+ handleFilesDelete(deckDir, req, res, log);
1039
1143
  return true;
1040
1144
  }
1041
1145
  if (action === 'mkdir') {
1042
- handleFilesMkdir(deckDir, req, res);
1146
+ handleFilesMkdir(deckDir, req, res, log);
1043
1147
  return true;
1044
1148
  }
1045
1149
  if (action === 'upload') {
1046
- handleFilesUpload(deckDir, req, res);
1150
+ handleFilesUpload(deckDir, req, res, log);
1047
1151
  return true;
1048
1152
  }
1049
1153
  if (action === 'raw') {
@@ -1281,7 +1385,7 @@ export function createIdeServer(opts) {
1281
1385
  return handleCoverApi(deckDir, req, res);
1282
1386
  }
1283
1387
  if (reqPath.startsWith(FILES_API_PREFIX)) {
1284
- return handleFilesApi(deckDir, req, res, reqPath, opts.restart, opts.invalidate, opts.tuneLedger);
1388
+ return handleFilesApi(deckDir, req, res, reqPath, opts.restart, opts.invalidate, opts.tuneLedger, opts.log);
1285
1389
  }
1286
1390
  if (reqPath.startsWith(IMPORT_API_PREFIX)) {
1287
1391
  return handleImportApi(deckDir, req, res, reqPath, opts.restart);
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] [--pin-installed-imports] (--force: save over a newer saved copy; --pin-installed-imports: move import pins to the versions imports/ holds instead of refusing)
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)
@@ -196,6 +197,7 @@ function usage() {
196
197
  castle-web update-import [alias] [dir] [--check] [--revert] (re-fetches imports; no alias means all)
197
198
  castle-web install [dir]
198
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)
@@ -556,7 +558,8 @@ async function main() {
556
558
  const caption = getFlagValue('--caption');
557
559
  const visibility = getFlagValue('--visibility');
558
560
  const pinInstalledImports = hasFlag('--pin-installed-imports');
559
- await saveDeck(dir, { title, caption, visibility, force: hasFlag('--force'), pinInstalledImports });
561
+ const chunkedBundle = hasFlag('--chunked-bundle');
562
+ await saveDeck(dir, { title, caption, visibility, force: hasFlag('--force'), pinInstalledImports, chunkedBundle });
560
563
  break;
561
564
  }
562
565
  case 'get-deck': {
@@ -637,6 +640,9 @@ async function main() {
637
640
  await check(findPositionalDir(), { pinInstalledImports: hasFlag('--pin-installed-imports') });
638
641
  break;
639
642
  }
643
+ case 'bundle-chunks':
644
+ await (await import('./bundle.js')).bundleChunksCommand(findPositionalDir(), getFlagValue('--out'), getFlagValue('--base-url'));
645
+ break;
640
646
  // The version commands spend their positionals on their own arguments --
641
647
  // paths to save, a version to list from or restore to -- so the deck dir is
642
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.47';
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.
@@ -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;
@@ -42,6 +59,8 @@ export interface SaveDeckOptions {
42
59
  force?: boolean;
43
60
  /** Move import pins to the versions imports/ holds, rather than refuse. */
44
61
  pinInstalledImports?: boolean;
62
+ /** Publish a classic chunked bundle, as castle.json `"bundle": { "chunks": "classic" }` does. */
63
+ chunkedBundle?: boolean;
45
64
  }
46
65
  export declare function saveDeck(dir: string, opts?: SaveDeckOptions): Promise<void>;
47
66
  export declare function builtinRefreshOptions(env?: NodeJS.ProcessEnv): {
package/dist/save-deck.js CHANGED
@@ -5,8 +5,8 @@ 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';
@@ -380,6 +380,127 @@ async function uploadContentPack(deckId, pack) {
380
380
  await uploadPresignedFile(config, new Blob([new Uint8Array(pack.bytes)], { type: 'application/json' }), 'application/json', LARGE_UPLOAD_TIMEOUT_MS, 'Content pack upload');
381
381
  return config.uploadId;
382
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
+ }
383
504
  async function uploadLocalCover(projectDir) {
384
505
  try {
385
506
  const selected = await selectSaveCover(projectDir, { onProgress: (message) => console.log(message) });
@@ -504,6 +625,13 @@ async function saveDeckAfterValidation(dir, opts, projectDir, visibility) {
504
625
  const castleJson = readCastleJson(projectDir);
505
626
  const existingDeckId = typeof castleJson?.deckId === 'string' && castleJson.deckId ? castleJson.deckId : null;
506
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
+ }
507
635
  // A deck without an id is new: the source commit sends no precondition, as before.
508
636
  let expectedS3Key;
509
637
  let markerVia = 'save-deck';
@@ -547,17 +675,22 @@ async function saveDeckAfterValidation(dir, opts, projectDir, visibility) {
547
675
  // build, as far as publishing is concerned (and as castle-www's failed_at
548
676
  // reports it).
549
677
  const built = await traceSaveStage('bundle', async () => {
550
- 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);
551
680
  const { errors } = await runImportChecks(projectDir);
552
681
  if (errors.length > 0)
553
682
  throw new Error(importChecksFailedMessage(errors));
554
- return { html: built, pack: await buildContentPack(projectDir) };
683
+ return { html, page, pack: await buildContentPack(projectDir) };
555
684
  }, (value) => ({ bytes: Buffer.byteLength(value.html) }));
556
- const { html: bundle, pack } = built;
685
+ const { html: bundle, page: chunkedPage, pack } = built;
557
686
  if (pack)
558
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.
559
690
  const sizeKB = bundle.length / 1024;
560
691
  console.log(`Bundle size: ${sizeKB.toFixed(1)}KB`);
692
+ if (chunkedPage)
693
+ reportChunks(chunkedPage);
561
694
  if (sizeKB > 1024) {
562
695
  console.warn(`Warning: Bundle is ${(sizeKB / 1024).toFixed(1)}MB. Large bundles may load slowly.`);
563
696
  }
@@ -581,6 +714,9 @@ async function saveDeckAfterValidation(dir, opts, projectDir, visibility) {
581
714
  // transferred. The promise is deliberately non-throwing: a thumbnail must never make the
582
715
  // content upload fail or create an unhandled rejection if that upload exits early.
583
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);
584
720
  // Upload scene data to S3
585
721
  const configs = await traceSaveStage('scene_upload_config', async () => {
586
722
  const result = await api.createSceneDataUploadConfig([cardId]);