castle-web-cli 0.4.233 → 0.4.235

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 (383) 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 +266 -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 +68 -5
  39. package/kits/base/sdk/hubRejoin.d.ts +4 -0
  40. package/kits/base/sdk/hubRejoin.js +15 -0
  41. package/kits/base/sdk/multiplayer.d.ts +7 -1
  42. package/kits/base/sdk/multiplayer.js +147 -40
  43. package/kits/base/sdk/multiplayerProtocol.d.ts +2 -0
  44. package/kits/base/sdk/party.d.ts +23 -0
  45. package/kits/base/sdk/party.js +91 -0
  46. package/kits/base/sdk/reconnectBudget.d.ts +23 -0
  47. package/kits/base/sdk/reconnectBudget.js +96 -0
  48. package/kits/base/sdk/save.d.ts +38 -1
  49. package/kits/base/sdk/save.js +79 -6
  50. package/kits/base/sdk/server/hub.d.ts +31 -1
  51. package/kits/base/sdk/server/hub.js +50 -3
  52. package/kits/base/sdk/server/platformHandle.d.ts +13 -1
  53. package/kits/base/sdk/server/storage.d.ts +4 -0
  54. package/kits/base/sdk/server/storage.js +19 -3
  55. package/kits/base/sdk/server/wrapper.d.ts +7 -1
  56. package/kits/base/sdk/server/wrapper.js +10 -1
  57. package/kits/base/sdk/social.d.ts +9 -0
  58. package/kits/base/sdk/social.js +5 -0
  59. package/kits/hub-game/CLAUDE.md +123 -3
  60. package/kits/hub-game/README.md +63 -0
  61. package/kits/hub-game/castle.json +5 -5
  62. package/kits/hub-game/code/client/act.js +312 -0
  63. package/kits/hub-game/code/client/actionLayout.js +147 -0
  64. package/kits/hub-game/code/client/actionOverflow.js +556 -0
  65. package/kits/hub-game/code/client/arrivalCamera.js +50 -0
  66. package/kits/hub-game/code/client/askSlot.js +117 -0
  67. package/kits/hub-game/code/client/avatar.js +4 -2
  68. package/kits/hub-game/code/client/avatarShare.js +2 -0
  69. package/kits/hub-game/code/client/backVisibility.js +13 -0
  70. package/kits/hub-game/code/client/ballot.js +15 -10
  71. package/kits/hub-game/code/client/build.js +16 -0
  72. package/kits/hub-game/code/client/chat.js +41 -5
  73. package/kits/hub-game/code/client/chatModeration.js +5 -0
  74. package/kits/hub-game/code/client/chrome.js +1148 -258
  75. package/kits/hub-game/code/client/crowdNames.js +241 -0
  76. package/kits/hub-game/code/client/decor.js +10 -4
  77. package/kits/hub-game/code/client/defaultEnvironment.js +194 -0
  78. package/kits/hub-game/code/client/doorErrors.js +39 -0
  79. package/kits/hub-game/code/client/fall.js +18 -0
  80. package/kits/hub-game/code/client/farAvatars.js +233 -0
  81. package/kits/hub-game/code/client/firstJoin.js +9 -2
  82. package/kits/hub-game/code/client/fpsTelemetry.js +50 -0
  83. package/kits/hub-game/code/client/frameBatch.js +5 -0
  84. package/kits/hub-game/code/client/grab.js +31 -11
  85. package/kits/hub-game/code/client/hookLayer.js +87 -8
  86. package/kits/hub-game/code/client/hudCopy.js +51 -0
  87. package/kits/hub-game/code/client/hudRate.js +20 -0
  88. package/kits/hub-game/code/client/idle.js +14 -2
  89. package/kits/hub-game/code/client/invites.js +231 -0
  90. package/kits/hub-game/code/client/joinError.js +9 -0
  91. package/kits/hub-game/code/client/labelsNear.js +31 -2
  92. package/kits/hub-game/code/client/landscapeLayout.js +17 -0
  93. package/kits/hub-game/code/client/layoutCache.js +264 -0
  94. package/kits/hub-game/code/client/loadTelemetry.js +20 -0
  95. package/kits/hub-game/code/client/loadingCover.js +148 -0
  96. package/kits/hub-game/code/client/loadingEntry.js +8 -0
  97. package/kits/hub-game/code/client/menuRows.js +43 -0
  98. package/kits/hub-game/code/client/modelReady.js +7 -0
  99. package/kits/hub-game/code/client/padCueArrival.js +23 -0
  100. package/kits/hub-game/code/client/padCues.js +112 -0
  101. package/kits/hub-game/code/client/padOccupancy.js +88 -0
  102. package/kits/hub-game/code/client/padReadability.js +26 -0
  103. package/kits/hub-game/code/client/padRings.js +69 -0
  104. package/kits/hub-game/code/client/pushVisit.js +14 -0
  105. package/kits/hub-game/code/client/quality.js +205 -0
  106. package/kits/hub-game/code/client/qualityEntry.js +55 -0
  107. package/kits/hub-game/code/client/safeLayout.js +338 -0
  108. package/kits/hub-game/code/client/safeStyle.js +42 -0
  109. package/kits/hub-game/code/client/say.js +12 -3
  110. package/kits/hub-game/code/client/shot.js +64 -10
  111. package/kits/hub-game/code/client/shotFit.js +56 -0
  112. package/kits/hub-game/code/client/signIn.js +28 -0
  113. package/kits/hub-game/code/client/state.js +53 -0
  114. package/kits/hub-game/code/client/talk.js +209 -45
  115. package/kits/hub-game/code/client/tiers.js +68 -66
  116. package/kits/hub-game/code/client/together.js +7 -2
  117. package/kits/hub-game/code/client/weakestLookBake.js +92 -0
  118. package/kits/hub-game/code/client/weakestTier.js +295 -0
  119. package/kits/hub-game/code/client/worldLabels.js +241 -0
  120. package/kits/hub-game/code/client/yours.js +10 -9
  121. package/kits/hub-game/code/npcDisplayText.js +55 -0
  122. package/kits/hub-game/code/server/act.js +124 -0
  123. package/kits/hub-game/code/server/actions.js +6 -1
  124. package/kits/hub-game/code/server/actors.js +2 -1
  125. package/kits/hub-game/code/server/analytics.js +83 -0
  126. package/kits/hub-game/code/server/anonymousEntry.js +49 -0
  127. package/kits/hub-game/code/server/arrivalPose.js +36 -0
  128. package/kits/hub-game/code/server/companion.js +28 -3
  129. package/kits/hub-game/code/server/doorAnalytics.js +52 -0
  130. package/kits/hub-game/code/server/earned.js +22 -5
  131. package/kits/hub-game/code/server/frameBatch.js +183 -0
  132. package/kits/hub-game/code/server/friendsAmong.js +49 -9
  133. package/kits/hub-game/code/server/history.js +2 -0
  134. package/kits/hub-game/code/server/hub.js +1306 -95
  135. package/kits/hub-game/code/server/idle.js +30 -1
  136. package/kits/hub-game/code/server/index.js +26 -4
  137. package/kits/hub-game/code/server/invites.js +19 -0
  138. package/kits/hub-game/code/server/labels.js +9 -1
  139. package/kits/hub-game/code/server/loadAbandon.js +106 -0
  140. package/kits/hub-game/code/server/manifest.js +211 -3
  141. package/kits/hub-game/code/server/menu.js +31 -3
  142. package/kits/hub-game/code/server/npcs.js +226 -64
  143. package/kits/hub-game/code/server/observe.js +408 -0
  144. package/kits/hub-game/code/server/padOccupancy.js +85 -0
  145. package/kits/hub-game/code/server/players.js +9 -1
  146. package/kits/hub-game/code/server/resumePose.js +152 -0
  147. package/kits/hub-game/code/server/say.js +1 -1
  148. package/kits/hub-game/code/server/standing.js +4 -5
  149. package/kits/hub-game/code/server/storageLimit.js +187 -0
  150. package/kits/hub-game/code/server/vis.js +67 -5
  151. package/kits/hub-game/code/shared/act.js +35 -0
  152. package/kits/hub-game/code/shared/danceIdle.js +28 -0
  153. package/kits/hub-game/code/shared/loadStages.js +12 -0
  154. package/kits/hub-game/code/shared/quality.js +74 -0
  155. package/kits/hub-game/code/shared/say.js +2 -0
  156. package/kits/hub-game/code/shared/shot.js +35 -1
  157. package/kits/hub-game/code/systems/hub.js +970 -169
  158. package/kits/hub-game/docs/analytics.md +279 -0
  159. package/kits/hub-game/docs/contract.md +1259 -42
  160. package/kits/hub-game/docs/home-pieces.md +9 -2
  161. package/kits/hub-game/docs/observed-progress.md +252 -0
  162. package/kits/hub-game/main.jsx +2 -0
  163. package/kits/hub-game/package-lock.json +10 -3
  164. package/kits/hub-game/package.json +6 -3
  165. package/kits/hub-game/play/player.js +142 -0
  166. package/kits/hub-game/play/registry.js +47 -0
  167. package/kits/hub-game/play.jsx +37 -0
  168. package/kits/hub-game/scripts/check.mjs +39 -5
  169. package/kits/hub-game/scripts/companion-follower-wire.json +1 -1
  170. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +11 -0
  171. package/kits/hub-game/scripts/fixtures/decor-keyless.json +5 -5
  172. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +3 -0
  173. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +19 -3
  174. package/kits/hub-game/scripts/fixtures/interest-legacy.json +3 -3
  175. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -1
  176. package/kits/hub-game/scripts/pose-storage-fixture.mjs +46 -0
  177. package/kits/hub-game/scripts/test-act-client.mjs +186 -0
  178. package/kits/hub-game/scripts/test-act.mjs +171 -0
  179. package/kits/hub-game/scripts/test-action-layout.mjs +80 -0
  180. package/kits/hub-game/scripts/test-action-observers.mjs +46 -0
  181. package/kits/hub-game/scripts/test-actions-client.mjs +367 -2
  182. package/kits/hub-game/scripts/test-actors.mjs +20 -7
  183. package/kits/hub-game/scripts/test-analytics.mjs +76 -0
  184. package/kits/hub-game/scripts/test-anonymous-entry.mjs +28 -0
  185. package/kits/hub-game/scripts/test-arrival-pose-server.mjs +196 -0
  186. package/kits/hub-game/scripts/test-arrival-pose.mjs +24 -0
  187. package/kits/hub-game/scripts/test-ask-slot.mjs +85 -0
  188. package/kits/hub-game/scripts/test-avatar-wire.mjs +49 -10
  189. package/kits/hub-game/scripts/test-avatar.mjs +44 -0
  190. package/kits/hub-game/scripts/test-back-visibility.mjs +82 -0
  191. package/kits/hub-game/scripts/test-ballot.mjs +11 -4
  192. package/kits/hub-game/scripts/test-ban-join.mjs +121 -13
  193. package/kits/hub-game/scripts/test-build.mjs +20 -2
  194. package/kits/hub-game/scripts/test-chat.mjs +206 -5
  195. package/kits/hub-game/scripts/test-companion-chat.mjs +20 -2
  196. package/kits/hub-game/scripts/test-control-layout-dom.mjs +120 -0
  197. package/kits/hub-game/scripts/test-crowd-names.mjs +205 -0
  198. package/kits/hub-game/scripts/test-decor-client.mjs +45 -4
  199. package/kits/hub-game/scripts/test-decor.mjs +7 -0
  200. package/kits/hub-game/scripts/test-default-environment-root.mjs +95 -0
  201. package/kits/hub-game/scripts/test-default-environment.mjs +267 -0
  202. package/kits/hub-game/scripts/test-door-analytics.mjs +58 -0
  203. package/kits/hub-game/scripts/test-door-jump.mjs +100 -0
  204. package/kits/hub-game/scripts/test-earned.mjs +33 -3
  205. package/kits/hub-game/scripts/test-far-avatars.mjs +340 -0
  206. package/kits/hub-game/scripts/test-fps-telemetry.mjs +112 -0
  207. package/kits/hub-game/scripts/test-frame-batch.mjs +252 -0
  208. package/kits/hub-game/scripts/test-fresh-friends.mjs +118 -0
  209. package/kits/hub-game/scripts/test-grab-orbit.mjs +47 -4
  210. package/kits/hub-game/scripts/test-high-only.mjs +170 -0
  211. package/kits/hub-game/scripts/test-hub-ops.mjs +321 -2
  212. package/kits/hub-game/scripts/test-hub-trip.mjs +879 -11
  213. package/kits/hub-game/scripts/test-hud-clear.mjs +162 -59
  214. package/kits/hub-game/scripts/test-hud-defects-dom.mjs +100 -0
  215. package/kits/hub-game/scripts/test-hud-rate.mjs +224 -0
  216. package/kits/hub-game/scripts/test-hud-safe-visibility-dom.mjs +83 -0
  217. package/kits/hub-game/scripts/test-idle.mjs +66 -0
  218. package/kits/hub-game/scripts/test-interest-cells.mjs +20 -0
  219. package/kits/hub-game/scripts/test-interest.mjs +15 -0
  220. package/kits/hub-game/scripts/test-invites-client.mjs +430 -0
  221. package/kits/hub-game/scripts/test-invites.mjs +109 -0
  222. package/kits/hub-game/scripts/test-labels.mjs +71 -3
  223. package/kits/hub-game/scripts/test-landscape-layout.mjs +194 -0
  224. package/kits/hub-game/scripts/test-list-scroll-dom.mjs +49 -0
  225. package/kits/hub-game/scripts/test-load-abandon.mjs +246 -0
  226. package/kits/hub-game/scripts/test-loading-cover.mjs +162 -0
  227. package/kits/hub-game/scripts/test-manifest.mjs +265 -0
  228. package/kits/hub-game/scripts/test-menu-client.mjs +105 -0
  229. package/kits/hub-game/scripts/test-menu.mjs +23 -0
  230. package/kits/hub-game/scripts/test-npcs.mjs +917 -10
  231. package/kits/hub-game/scripts/test-observed.mjs +745 -0
  232. package/kits/hub-game/scripts/test-pad-cues.mjs +304 -0
  233. package/kits/hub-game/scripts/test-pad-occupancy.mjs +177 -0
  234. package/kits/hub-game/scripts/test-picker.mjs +234 -7
  235. package/kits/hub-game/scripts/test-placement-cache.mjs +690 -0
  236. package/kits/hub-game/scripts/test-progress-reset.mjs +559 -0
  237. package/kits/hub-game/scripts/test-push-visit.mjs +26 -0
  238. package/kits/hub-game/scripts/test-quality.mjs +385 -0
  239. package/kits/hub-game/scripts/test-rehello.mjs +699 -5
  240. package/kits/hub-game/scripts/test-resume-action-order.mjs +598 -0
  241. package/kits/hub-game/scripts/test-resume-held.mjs +239 -0
  242. package/kits/hub-game/scripts/test-resume-pose.mjs +142 -0
  243. package/kits/hub-game/scripts/test-safe-events-dom.mjs +116 -0
  244. package/kits/hub-game/scripts/test-safe-layout.mjs +330 -0
  245. package/kits/hub-game/scripts/test-say.mjs +1 -1
  246. package/kits/hub-game/scripts/test-shot.mjs +145 -0
  247. package/kits/hub-game/scripts/test-signin-client.mjs +45 -0
  248. package/kits/hub-game/scripts/test-soundscape.mjs +22 -17
  249. package/kits/hub-game/scripts/test-standing.mjs +35 -2
  250. package/kits/hub-game/scripts/test-storage-limit.mjs +333 -0
  251. package/kits/hub-game/scripts/test-stuck.mjs +5 -4
  252. package/kits/hub-game/scripts/test-talk-overlay-dom.mjs +130 -0
  253. package/kits/hub-game/scripts/test-tiers-render.mjs +86 -13
  254. package/kits/hub-game/scripts/test-tiers.mjs +7 -8
  255. package/kits/hub-game/scripts/test-vis.mjs +433 -6
  256. package/kits/hub-game/scripts/test-weakest-tier.mjs +924 -0
  257. package/kits/hub-game/scripts/test-world-labels.mjs +367 -0
  258. package/kits/hub-game/scripts/test-yours-chrome.mjs +50 -6
  259. package/kits/hub-game/scripts/test-yours.mjs +39 -8
  260. package/kits/multiplayer-3d/castle.json +5 -5
  261. package/kits/multiplayer-3d/code/client/joinFailure.js +27 -0
  262. package/kits/multiplayer-3d/code/client/resumeGate.js +139 -0
  263. package/kits/multiplayer-3d/code/systems/multiplayer.js +369 -30
  264. package/kits/multiplayer-3d/package-lock.json +8 -1
  265. package/kits/multiplayer-3d/package.json +2 -1
  266. package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +436 -0
  267. package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +624 -0
  268. package/kits/physics-2d/CLAUDE.md +10 -1
  269. package/kits/physics-2d/castle.json +2 -2
  270. package/kits/physics-2d/engine/frozenActors.js +233 -0
  271. package/kits/physics-2d/engine/scene.js +87 -5
  272. package/kits/physics-2d/eslint.config.js +1 -1
  273. package/kits/physics-2d/play/behaviors/AnalogStick.js +198 -0
  274. package/kits/physics-2d/play/behaviors/Camera.js +40 -0
  275. package/kits/physics-2d/play/behaviors/Collider.js +122 -0
  276. package/kits/physics-2d/play/behaviors/Draggable.js +115 -0
  277. package/kits/physics-2d/play/behaviors/Goal.js +46 -0
  278. package/kits/physics-2d/play/behaviors/Joints.js +126 -0
  279. package/kits/physics-2d/play/behaviors/Layout.js +71 -0
  280. package/kits/physics-2d/play/behaviors/RigidBody.js +57 -0
  281. package/kits/physics-2d/play/behaviors/Slingshot.js +142 -0
  282. package/kits/physics-2d/play/behaviors/SoundPlayer.js +263 -0
  283. package/kits/physics-2d/play/behaviors/Sprite.js +406 -0
  284. package/kits/physics-2d/play/behaviors/Style.js +209 -0
  285. package/kits/physics-2d/play/behaviors/Text.js +85 -0
  286. package/kits/physics-2d/play/behaviors/Video.js +93 -0
  287. package/kits/physics-3d/CLAUDE.md +25 -1651
  288. package/kits/physics-3d/behaviors/Body.jsx +3 -0
  289. package/kits/physics-3d/behaviors/Model.jsx +3 -0
  290. package/kits/physics-3d/behaviors/Player.jsx +35 -18
  291. package/kits/physics-3d/behaviors/Shape.jsx +3 -0
  292. package/kits/physics-3d/behaviors/Solid.jsx +3 -0
  293. package/kits/physics-3d/behaviors/Transform.jsx +3 -0
  294. package/kits/physics-3d/castle.json +3 -3
  295. package/kits/physics-3d/docs/engine-camera.md +542 -0
  296. package/kits/physics-3d/docs/engine-frame-cap.md +136 -0
  297. package/kits/physics-3d/docs/engine-load.md +149 -0
  298. package/kits/physics-3d/docs/engine-look.md +114 -0
  299. package/kits/physics-3d/docs/engine-shadows.md +372 -0
  300. package/kits/physics-3d/docs/engine-skip-work.md +187 -0
  301. package/kits/physics-3d/docs/engine-sky.md +198 -0
  302. package/kits/physics-3d/docs/engine-static-actors.md +226 -0
  303. package/kits/physics-3d/docs/engine-view.md +37 -0
  304. package/kits/physics-3d/docs/pxmodel-format.md +1 -1
  305. package/kits/physics-3d/engine3d/PlayOnly3D.jsx +5 -1
  306. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +19 -333
  307. package/kits/physics-3d/engine3d/actornode.js +1 -0
  308. package/kits/physics-3d/engine3d/branches.js +3 -13
  309. package/kits/physics-3d/engine3d/cage.js +2 -7
  310. package/kits/physics-3d/engine3d/cageops.js +2 -17
  311. package/kits/physics-3d/engine3d/dataBehaviors.js +12 -0
  312. package/kits/physics-3d/engine3d/framecap.js +4 -1
  313. package/kits/physics-3d/engine3d/frozenphysics.js +140 -0
  314. package/kits/physics-3d/engine3d/frozenstatics.js +273 -0
  315. package/kits/physics-3d/engine3d/gait.js +8 -0
  316. package/kits/physics-3d/engine3d/initialModelFiles.js +18 -0
  317. package/kits/physics-3d/engine3d/look.js +7 -0
  318. package/kits/physics-3d/engine3d/modelFiles.js +3 -17
  319. package/kits/physics-3d/engine3d/modelMath.js +49 -0
  320. package/kits/physics-3d/engine3d/modelready.js +16 -0
  321. package/kits/physics-3d/engine3d/motion.js +3 -3
  322. package/kits/physics-3d/engine3d/nearshadows.js +77 -10
  323. package/kits/physics-3d/engine3d/orbitinput.js +59 -25
  324. package/kits/physics-3d/engine3d/partgeometry.js +1 -16
  325. package/kits/physics-3d/engine3d/paths.js +1 -9
  326. package/kits/physics-3d/engine3d/playTimings.js +50 -0
  327. package/kits/physics-3d/engine3d/playerRun.js +372 -0
  328. package/kits/physics-3d/engine3d/pxmodel.js +3 -3
  329. package/kits/physics-3d/engine3d/rapier.js +27 -0
  330. package/kits/physics-3d/engine3d/scatter.js +1 -11
  331. package/kits/physics-3d/engine3d/shadowfade.js +23 -15
  332. package/kits/physics-3d/engine3d/sky.js +1 -1
  333. package/kits/physics-3d/engine3d/squarefirst.js +177 -0
  334. package/kits/physics-3d/engine3d/stillshadows.js +399 -0
  335. package/kits/physics-3d/engine3d/sweep.js +1 -25
  336. package/kits/physics-3d/engine3d/world3d.js +468 -18
  337. package/kits/physics-3d/eslint.config.js +2 -1
  338. package/kits/physics-3d/main.jsx +6 -3
  339. package/kits/physics-3d/package-lock.json +7 -0
  340. package/kits/physics-3d/package.json +5 -1
  341. package/kits/physics-3d/play/behaviors/Body.js +31 -0
  342. package/kits/physics-3d/play/behaviors/Door.js +37 -0
  343. package/kits/physics-3d/play/behaviors/Lookable.js +16 -0
  344. package/kits/physics-3d/play/behaviors/Model.js +23 -0
  345. package/kits/physics-3d/play/behaviors/Pickup.js +46 -0
  346. package/kits/physics-3d/play/behaviors/Player.js +1204 -0
  347. package/kits/physics-3d/play/behaviors/Shape.js +47 -0
  348. package/kits/physics-3d/play/behaviors/Solid.js +16 -0
  349. package/kits/physics-3d/play/behaviors/Transform.js +29 -0
  350. package/kits/physics-3d/pnpm-lock.yaml +8 -0
  351. package/kits/physics-3d/scripts/bench-shadow-fade.mjs +37 -0
  352. package/kits/physics-3d/scripts/build-rapier-gz.mjs +56 -0
  353. package/kits/physics-3d/scripts/frozen-statics-fixture.mjs +141 -0
  354. package/kits/physics-3d/scripts/test-camera-follow.mjs +5 -1
  355. package/kits/physics-3d/scripts/test-camera-orbit.mjs +52 -4
  356. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +1 -1
  357. package/kits/physics-3d/scripts/test-empty-gait-hints.mjs +89 -0
  358. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +6 -3
  359. package/kits/physics-3d/scripts/test-frame-cap.mjs +1 -1
  360. package/kits/physics-3d/scripts/test-frozen-nested.mjs +49 -0
  361. package/kits/physics-3d/scripts/test-frozen-statics-legacy-physics2d.mjs +123 -0
  362. package/kits/physics-3d/scripts/test-frozen-statics.mjs +434 -0
  363. package/kits/physics-3d/scripts/test-look-bake.mjs +1 -1
  364. package/kits/physics-3d/scripts/test-near-shadows.mjs +2 -2
  365. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +88 -7
  366. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +40 -3
  367. package/kits/physics-3d/scripts/test-orbit-shot.mjs +75 -1
  368. package/kits/physics-3d/scripts/test-rapier-gz.mjs +106 -0
  369. package/kits/physics-3d/scripts/test-sky.mjs +1 -1
  370. package/kits/physics-3d/scripts/test-square-first.mjs +921 -0
  371. package/kits/physics-3d/scripts/test-static-actors.mjs +3 -1
  372. package/kits/physics-3d/scripts/test-static-physics.mjs +4 -1
  373. package/kits/physics-3d/scripts/test-static-scenery.mjs +5 -2
  374. package/kits/physics-3d/scripts/test-steady-hover.mjs +5 -2
  375. package/kits/physics-3d/scripts/test-still-shadows.mjs +477 -0
  376. package/kits/physics-3d/systems/physics3d.js +37 -4
  377. package/kits/real-time/castle.json +2 -2
  378. package/kits/real-time/code/client/connection.js +33 -10
  379. package/kits/real-time/code/client/gameHooks.js +2 -0
  380. package/kits/real-time/code/client/joinOverlay.js +9 -4
  381. package/kits/real-time/code/server/session.js +6 -4
  382. package/kits/real-time/package-lock.json +1 -1
  383. package/package.json +2 -2
@@ -0,0 +1,624 @@
1
+ // Run with: node kits/multiplayer-3d/scripts/test-resume-gate.mjs
2
+ //
3
+ // A player who went away (an app switch, a short drop) and came back to the
4
+ // same session must never see the room as it was, nor anything easing from it
5
+ // to where it is now. This drives the real client system, interpolation,
6
+ // clock, smoothing and pose codec frame by frame through such returns and
7
+ // checks every frame the page would show: either the cover is up, or every
8
+ // object and player is drawn at its current pose.
9
+ //
10
+ // `RESUME_BASELINE=<path to an older multiplayer.js>` runs the same returns
11
+ // against that file and prints how many wrong frames it shows instead of
12
+ // failing (the old file has no gate to check).
13
+ import assert from 'node:assert/strict';
14
+ import { register } from 'node:module';
15
+ import { pathToFileURL } from 'node:url';
16
+
17
+ const kits = new URL('../../', import.meta.url).href;
18
+ const baseline = process.env.RESUME_BASELINE ? pathToFileURL(process.env.RESUME_BASELINE).href : null;
19
+ const stubs = {
20
+ '../client/avatars.js': `
21
+ export const makeAvatars = () => ({ actors: new Map(), leaving: new Map(), retired: new Set() });
22
+ export const showPlayer = (avatars, scene, id, name, pose) => {
23
+ (globalThis.__drawnPlayers ??= new Map()).set(id, pose.slice());
24
+ return { id: 'avatar-' + id };
25
+ };
26
+ export const showSelf = () => {}; export const enter = () => {}; export const retire = () => {};
27
+ export const dropMissing = () => {}; export const animate = () => {}; export const clearAvatars = () => {};`,
28
+ '../client/steer.js': 'export const makeState = () => ({}); export const LIVE_RADIUS = 3;',
29
+ '@imports/castle.real-time/code/client/connection.js':
30
+ 'export const connectSession = async (options) => { globalThis.__connect = options; return globalThis.__net; };',
31
+ '@imports/castle.real-time/code/client/soloBadge.js': 'export const showSoloBadge = () => {}; export const updateSoloBadge = () => {};',
32
+ '@imports/castle.real-time/code/client/joinOverlay.js':
33
+ 'export const showJoinOverlay = (visible, text) => { globalThis.__cover = visible ? (text ?? "Joining…") : null; };',
34
+ '@imports/castle.real-time/code/client/gameHooks.js': 'export const game = {};',
35
+ };
36
+ register(
37
+ `data:text/javascript,${encodeURIComponent(`
38
+ import { readFile } from 'node:fs/promises';
39
+ const stubs = ${JSON.stringify(stubs)};
40
+ const kits = ${JSON.stringify(kits)};
41
+ const baseline = ${JSON.stringify(baseline)};
42
+ export async function resolve(s, c, next) {
43
+ if (c.parentURL?.endsWith('/systems/multiplayer.js') && stubs[s]) {
44
+ return { url: 'data:text/javascript,' + encodeURIComponent(stubs[s]), shortCircuit: true };
45
+ }
46
+ if (s.startsWith('@imports/castle.real-time/')) {
47
+ return next(kits + 'real-time/' + s.slice('@imports/castle.real-time/'.length), c);
48
+ }
49
+ // A baseline file elsewhere still imports the kit's own client modules.
50
+ if (baseline && c.parentURL === baseline && s.startsWith('../')) {
51
+ return next(new URL(s, kits + 'multiplayer-3d/code/systems/multiplayer.js').href, c);
52
+ }
53
+ return next(s, c);
54
+ }
55
+ export async function load(u, c, next) {
56
+ if (u.endsWith('/systems/multiplayer.js') || u === baseline) {
57
+ const file = new URL(baseline && u.endsWith('/systems/multiplayer.js') ? baseline : u);
58
+ const source = (await readFile(file, 'utf8')).replace(/import.meta.glob\\([^)]*\\)/g, '({})');
59
+ return { format: 'module', source, shortCircuit: true };
60
+ }
61
+ return next(u, c);
62
+ }
63
+ `)}`,
64
+ );
65
+
66
+ // The page clock and document the system reads.
67
+ let pageMs = 0;
68
+ Object.defineProperty(globalThis, 'performance', { value: { now: () => pageMs }, configurable: true, writable: true });
69
+ const listeners = new Map();
70
+ globalThis.document = {
71
+ hidden: false,
72
+ addEventListener: (type, fn) => listeners.set(type, fn),
73
+ removeEventListener: (type) => listeners.delete(type),
74
+ };
75
+ const quiet = console.log;
76
+ console.log = (...args) => (String(args[0]).startsWith('[multiplayer]') ? undefined : quiet(...args));
77
+ console.warn = (...args) => (String(args[0]).startsWith('[multiplayer]') ? undefined : quiet(...args));
78
+
79
+ const { installSystem } = await import('../code/systems/multiplayer.js');
80
+
81
+ // Prism Post's beam that a partner turned while this player was away: the
82
+ // pose drawn before the away, and the one the session has now
83
+ // (dot-build-prism-post render-smoothing-proof.json).
84
+ const Q = [0, 0.7071067811865476, 0, 0.7071067811865476];
85
+ const BEAM_OLD = [-10.2, 0.08, 2.7, ...Q];
86
+ const BEAM_NOW = [-10.2, 0.08, 0.9, ...Q];
87
+ // Prism's own tolerance for a drawn pose against the current one.
88
+ const TOLERANCE = 0.035;
89
+
90
+ const FRAME_MS = 1000 / 60;
91
+ const TICK_MS = 1000 / 30;
92
+ // Simulation time is page time less this; each message spends TRANSIT_MS in transit.
93
+ const OFFSET_MS = 5000;
94
+ const TRANSIT_MS = 20;
95
+
96
+ // One client in a room. `objects` and `players` are the session's current
97
+ // poses; `send` decides what reaches the client and when.
98
+ async function makeRoom({ objects, players = {} }) {
99
+ pageMs = 10000;
100
+ document.hidden = false;
101
+ listeners.clear();
102
+ globalThis.__cover = null;
103
+ globalThis.__drawnPlayers = new Map();
104
+ const system = installSystem({ registerSystem() {} });
105
+ const room = {
106
+ system,
107
+ objects: { ...objects },
108
+ players: { ...players },
109
+ state: 'connected',
110
+ inbox: [],
111
+ // Whether the transport delivers broadcasts as they are sent.
112
+ socket: true,
113
+ // Each changed object since the last broadcast this client received.
114
+ sentObjects: new Map(),
115
+ sentPlayers: new Map(),
116
+ nextTick: pageMs,
117
+ actors: new Map(),
118
+ frames: [],
119
+ };
120
+ for (const id of Object.keys(objects)) {
121
+ room.actors.set(id, { id, components: { Transform: { x: 0, y: 0, z: 0 } } });
122
+ }
123
+ globalThis.__net = {
124
+ selfId: () => 'self',
125
+ drain: () => room.inbox.splice(0),
126
+ status: () => ({ state: room.state, solo: false, others: Object.keys(room.players).length, you: 'me' }),
127
+ others: () => new Map(Object.keys(room.players).map((id) => [id, id])),
128
+ roster: () => new Map(),
129
+ userId: () => null,
130
+ sendMove: () => false,
131
+ send: () => {},
132
+ closed: () => false,
133
+ close() {},
134
+ };
135
+ // This player, whose body the session's WORLD placement moves.
136
+ const local = { id: 'local', components: { Transform: { x: 0, y: 0, z: 0 } } };
137
+ let at = { x: 0, y: 0, z: 0 };
138
+ const body = {
139
+ setTranslation: (p) => (at = { ...p }),
140
+ translation: () => at,
141
+ rotation: () => ({ x: 0, y: 0, z: 0, w: 1 }),
142
+ setLinvel() {},
143
+ linvel: () => ({ x: 0, y: 0, z: 0 }),
144
+ angvel: () => ({ x: 0, y: 0, z: 0 }),
145
+ };
146
+ room.scene = {
147
+ actorWith: () => local,
148
+ physics3d: { bodyOf: (actor) => (actor === local ? body : null) },
149
+ data: {},
150
+ getActor: (id) => room.actors.get(id),
151
+ actors: room.actors,
152
+ systems: [],
153
+ touch() {},
154
+ despawnActor() {},
155
+ hud: {},
156
+ };
157
+ await system.start(room.scene);
158
+ assert.equal(system.net, globalThis.__net);
159
+ return room;
160
+ }
161
+
162
+ // The transport's own report that the connection is back.
163
+ function reconnect(room, { event = true } = {}) {
164
+ room.state = 'connected';
165
+ room.socket = true;
166
+ if (event) {
167
+ globalThis.__connect.onConnected();
168
+ }
169
+ }
170
+
171
+ function simNow() {
172
+ return pageMs - OFFSET_MS;
173
+ }
174
+
175
+ // One message as the client queues it, `localMs` its arrival.
176
+ function deliver(room, msg, arriveAt = pageMs + TRANSIT_MS) {
177
+ room.inbox.push({ ...msg, localMs: arriveAt });
178
+ }
179
+
180
+ // What a session broadcasts each tick: the poses that changed since the last
181
+ // broadcast, which a client that missed a tick never gets again.
182
+ function broadcast(room) {
183
+ const os = [];
184
+ for (const [id, pose] of Object.entries(room.objects)) {
185
+ if (room.sentObjects.get(id) !== pose.join()) {
186
+ room.sentObjects.set(id, pose.join());
187
+ os.push([id, ...pose, 0]);
188
+ }
189
+ }
190
+ const ps = [];
191
+ for (const [id, pose] of Object.entries(room.players)) {
192
+ if (room.sentPlayers.get(id) !== pose.join()) {
193
+ room.sentPlayers.set(id, pose.join());
194
+ ps.push([id, ...pose]);
195
+ }
196
+ }
197
+ return { k: 's', t: simNow(), os, ps, own: [] };
198
+ }
199
+
200
+ function world(room) {
201
+ return {
202
+ k: 'w',
203
+ t: simNow(),
204
+ os: Object.entries(room.objects).map(([id, pose]) => [id, ...pose, 0]),
205
+ ps: [...Object.entries(room.players).map(([id, pose]) => [id, ...pose]), ['self', 0, 0, 0, 0]],
206
+ own: [],
207
+ };
208
+ }
209
+
210
+ // Advance the page to `until`, ticking the session and drawing frames while
211
+ // the page is shown. `deliverTicks` says whether broadcasts reach the client.
212
+ function run(room, until) {
213
+ while (pageMs < until) {
214
+ pageMs = Math.min(until, pageMs + FRAME_MS / 4);
215
+ if (pageMs >= room.nextTick) {
216
+ room.nextTick += TICK_MS;
217
+ const msg = broadcast(room);
218
+ if (room.socket) {
219
+ deliver(room, msg);
220
+ }
221
+ }
222
+ if (!document.hidden && pageMs >= (room.lastFrame ?? 0) + FRAME_MS) {
223
+ frame(room);
224
+ }
225
+ }
226
+ }
227
+
228
+ // One drawn frame, and what the page shows of it.
229
+ function frame(room) {
230
+ room.lastFrame = pageMs;
231
+ room.system.afterBehaviors(room.scene, FRAME_MS / 1000);
232
+ const drawn = {};
233
+ for (const [id, actor] of room.actors) {
234
+ const t = actor.components.Transform;
235
+ drawn[id] = [t.x, t.y, t.z];
236
+ }
237
+ for (const [id, pose] of globalThis.__drawnPlayers) {
238
+ drawn[id] = pose.slice(0, 3);
239
+ }
240
+ room.frames.push({ at: pageMs, cover: globalThis.__cover, drawn, armed: room.system.resume?.armed });
241
+ }
242
+
243
+ function hide(room) {
244
+ document.hidden = true;
245
+ listeners.get('visibilitychange')?.();
246
+ room.hiddenAt = pageMs;
247
+ }
248
+
249
+ // The page shown again: the first thing composited is whatever the DOM holds
250
+ // now, before any frame runs.
251
+ function show(room) {
252
+ document.hidden = false;
253
+ listeners.get('visibilitychange')?.();
254
+ room.shownAt = pageMs;
255
+ room.frames.push({ at: pageMs, cover: globalThis.__cover, drawn: null, composited: true });
256
+ }
257
+
258
+ function offBy(drawn, current) {
259
+ return Math.hypot(drawn[0] - current[0], drawn[1] - current[1], drawn[2] - current[2]);
260
+ }
261
+
262
+ // Every shown frame from the return on: covered, or every pose current. The
263
+ // uncovered frames before the away are not judged.
264
+ function wrongFrames(room) {
265
+ const wrong = [];
266
+ for (const f of room.frames) {
267
+ if ((f.at <= room.shownAt && !f.composited) || f.cover) {
268
+ continue;
269
+ }
270
+ if (!f.drawn) {
271
+ wrong.push({ at: f.at - room.shownAt, why: 'composited the old canvas' });
272
+ continue;
273
+ }
274
+ const current = { ...room.objects, ...room.players };
275
+ for (const [id, pose] of Object.entries(current)) {
276
+ const off = offBy(f.drawn[id] ?? [Infinity, 0, 0], pose);
277
+ if (off > TOLERANCE) {
278
+ wrong.push({ at: Math.round(f.at - room.shownAt), id, off: Number(off.toFixed(3)) });
279
+ }
280
+ }
281
+ }
282
+ return wrong;
283
+ }
284
+
285
+ function uncoveredAt(room) {
286
+ return room.frames.find((f) => f.at > room.shownAt && !f.cover && f.drawn)?.at - room.shownAt;
287
+ }
288
+
289
+ const results = [];
290
+ function check(name, room, { uncoverBy } = {}) {
291
+ const wrong = wrongFrames(room);
292
+ const uncover = uncoveredAt(room);
293
+ results.push({ name, wrong: wrong.length, uncoveredMs: Math.round(uncover), first: wrong[0] ?? null });
294
+ if (baseline) {
295
+ return;
296
+ }
297
+ assert.deepEqual(wrong, [], `${name}: no frame shows the old room or a path from it`);
298
+ assert.ok(Number.isFinite(uncover), `${name}: the room is shown again`);
299
+ if (uncoverBy !== undefined) {
300
+ assert.ok(uncover <= uncoverBy, `${name}: uncovered ${uncover} ms after the return, by ${uncoverBy}`);
301
+ }
302
+ assert.equal(room.system.resume.armed, false, `${name}: the gate released`);
303
+ // A live body placed on release reaches its Transform at the next physics
304
+ // step, so the frame that releases is still covered.
305
+ room.frames.forEach((f, i) => {
306
+ if (i > 0 && room.frames[i - 1].armed && f.armed === false) {
307
+ assert.ok(f.cover, `${name}: the releasing frame stays covered`);
308
+ }
309
+ });
310
+ }
311
+
312
+ // Prism's return: the app goes to the background, its socket closes, a
313
+ // partner turns the beam, and the app comes back after `awayMs`. The
314
+ // connection reconnects to the same identity, ordinary broadcasts start
315
+ // reaching it, and the session's WORLD arrives 914 ms after the page shows.
316
+ async function prismReturn(awayMs, { reconnectEvent = true } = {}) {
317
+ const room = await makeRoom({ objects: { 'b0-beam-3': BEAM_OLD } });
318
+ deliver(room, world(room), pageMs);
319
+ run(room, pageMs + 2000);
320
+ const before = room.frames.at(-1);
321
+ assert.ok(offBy(before.drawn['b0-beam-3'], BEAM_OLD) < 1e-9 && !before.cover, 'the old route is drawn before the away');
322
+
323
+ hide(room);
324
+ if (!baseline) {
325
+ assert.equal(globalThis.__cover, 'Reconnecting…', 'the cover is up before the page goes');
326
+ }
327
+ run(room, pageMs + 500);
328
+ room.socket = false;
329
+ room.state = 'reconnecting';
330
+ run(room, pageMs + awayMs / 2);
331
+ room.objects['b0-beam-3'] = BEAM_NOW;
332
+ run(room, room.hiddenAt + awayMs);
333
+
334
+ show(room);
335
+ run(room, pageMs + 400);
336
+ reconnect(room, { event: reconnectEvent });
337
+ run(room, room.shownAt + 914);
338
+ deliver(room, world(room));
339
+ run(room, pageMs + 1500);
340
+ return room;
341
+ }
342
+
343
+ // 30 s and 3 min, with and without the transport's reconnect event.
344
+ check('prism 30s return', await prismReturn(30000), { uncoverBy: 914 + 3 * FRAME_MS + TRANSIT_MS });
345
+ check('prism 3min return', await prismReturn(180000), { uncoverBy: 914 + 3 * FRAME_MS + TRANSIT_MS });
346
+ check('prism 30s return, drop seen only by frames', await prismReturn(30000, { reconnectEvent: false }), {
347
+ uncoverBy: 914 + 3 * FRAME_MS + TRANSIT_MS,
348
+ });
349
+
350
+ // A desktop tab hidden 30 s whose socket stays up: broadcasts keep arriving
351
+ // while it is hidden, including the turned beam. The room is current on the
352
+ // first frame back.
353
+ {
354
+ const room = await makeRoom({ objects: { 'b0-beam-3': BEAM_OLD } });
355
+ deliver(room, world(room), pageMs);
356
+ run(room, pageMs + 2000);
357
+ hide(room);
358
+ run(room, pageMs + 10000);
359
+ room.objects['b0-beam-3'] = BEAM_NOW;
360
+ run(room, room.hiddenAt + 30000);
361
+ show(room);
362
+ run(room, pageMs + 1000);
363
+ check('socket kept, hidden 30s', room, { uncoverBy: 2 * FRAME_MS });
364
+ }
365
+
366
+ // A socket that died at the suspension with frames still in its buffer: they
367
+ // arrive in a burst on the return, a moment old by their simulation time, and
368
+ // say nothing of the beam turned since. They must not release the cover; the
369
+ // drop is then seen and the WORLD after the reconnect does.
370
+ {
371
+ const room = await makeRoom({ objects: { 'b0-beam-3': BEAM_OLD } });
372
+ deliver(room, world(room), pageMs);
373
+ run(room, pageMs + 2000);
374
+ hide(room);
375
+ const stale = [];
376
+ room.socket = false;
377
+ for (let i = 0; i < 6; i += 1) {
378
+ run(room, pageMs + TICK_MS);
379
+ stale.push(broadcast(room));
380
+ }
381
+ run(room, pageMs + 10000);
382
+ room.objects['b0-beam-3'] = BEAM_NOW;
383
+ run(room, room.hiddenAt + 30000);
384
+ show(room);
385
+ for (const msg of stale) {
386
+ deliver(room, msg, pageMs);
387
+ }
388
+ run(room, pageMs + 300);
389
+ if (!baseline) {
390
+ assert.equal(room.system.resume.armed, true, 'a stale buffered burst keeps the cover');
391
+ }
392
+ room.state = 'reconnecting';
393
+ run(room, pageMs + 300);
394
+ reconnect(room);
395
+ run(room, pageMs + 200);
396
+ deliver(room, world(room));
397
+ run(room, pageMs + 1000);
398
+ check('stale buffer, then reconnect', room, { uncoverBy: 1000 });
399
+ }
400
+
401
+ // An ordinary hub door: several objects and another player. The connection
402
+ // drops for 2 s with the page shown; meanwhile the other player walks off
403
+ // and a crate is pushed. Ordinary broadcasts arrive before the WORLD the
404
+ // filtering session sends to a body it kept.
405
+ {
406
+ const crate = [3, 0.5, 3, 0, 0, 0, 1];
407
+ const ball = [-4, 0.5, 1, 0, 0, 0, 1];
408
+ const room = await makeRoom({ objects: { crate, ball }, players: { partner: [1, 0, 1, 0] } });
409
+ deliver(room, world(room), pageMs);
410
+ run(room, pageMs + 2000);
411
+ room.socket = false;
412
+ room.state = 'reconnecting';
413
+ room.shownAt = pageMs;
414
+ run(room, pageMs + 1000);
415
+ room.objects.crate = [4.2, 0.5, 2.1, 0, 0, 0, 1];
416
+ room.players.partner = [2.5, 0, -0.5, 1.2];
417
+ run(room, pageMs + 1000);
418
+ reconnect(room);
419
+ run(room, pageMs + 120);
420
+ deliver(room, world(room));
421
+ run(room, pageMs + 1500);
422
+ check('hub door, 2s drop while shown', room, { uncoverBy: 2000 + 120 + 3 * FRAME_MS + TRANSIT_MS });
423
+ }
424
+
425
+ if (baseline) {
426
+ console.table(results);
427
+ console.log('test-resume-gate: baseline run; wrong frames are reported, not asserted');
428
+ process.exit(0);
429
+ }
430
+
431
+ // A session that never answers after the return gives up after the wait, so
432
+ // the deck is not hidden for good.
433
+ {
434
+ const room = await makeRoom({ objects: { 'b0-beam-3': BEAM_OLD } });
435
+ deliver(room, world(room), pageMs);
436
+ run(room, pageMs + 2000);
437
+ hide(room);
438
+ room.socket = false;
439
+ run(room, pageMs + 30000);
440
+ show(room);
441
+ run(room, pageMs + 9000);
442
+ assert.equal(room.system.resume.armed, true, 'still waiting before the give-up');
443
+ assert.equal(room.system.placed(), false, 'not placed while the gate holds');
444
+ run(room, pageMs + 1100);
445
+ assert.equal(room.system.resume.armed, false, 'gives up after the wait');
446
+ assert.equal(globalThis.__cover, null);
447
+ assert.equal(room.system.placed(), true, 'placed again once released');
448
+ }
449
+
450
+ // A frame gap with no hidden event (a suspended webview, a debugger pause)
451
+ // arms the gate on the first frame back; the next current broadcast releases it.
452
+ // The beam turned during the 1.1 s gap is drawn where it is, not part way along
453
+ // an interpolation from the pose before the gap.
454
+ {
455
+ const room = await makeRoom({ objects: { 'b0-beam-3': BEAM_OLD } });
456
+ deliver(room, world(room), pageMs);
457
+ run(room, pageMs + 2000);
458
+ // The last pose before the gap arrives on the very tick of the last frame,
459
+ // so its simulation time is exactly where the away begins.
460
+ room.objects['b0-beam-3'] = [-10.2, 0.08, 2.6, ...Q];
461
+ deliver(room, broadcast(room), pageMs);
462
+ room.lastFrame = pageMs - FRAME_MS;
463
+ frame(room);
464
+ assert.equal(room.system.clock.offset, OFFSET_MS, 'that arrival set the clock offset');
465
+ room.socket = false;
466
+ pageMs += 1100;
467
+ room.nextTick = pageMs;
468
+ room.objects['b0-beam-3'] = BEAM_NOW;
469
+ room.socket = true;
470
+ room.shownAt = pageMs;
471
+ run(room, pageMs + 600);
472
+ check('1.1 s frame stall', room, { uncoverBy: 200 });
473
+ }
474
+
475
+ // A dropped connection that comes back with ordinary broadcasts and no WORLD
476
+ // (a session from before the kept-body WORLD) is never uncovered on them, since
477
+ // they say nothing of what moved while it was gone; the wait gives up instead.
478
+ {
479
+ const room = await makeRoom({ objects: { 'b0-beam-3': BEAM_OLD } });
480
+ deliver(room, world(room), pageMs);
481
+ run(room, pageMs + 2000);
482
+ room.socket = false;
483
+ room.state = 'reconnecting';
484
+ run(room, pageMs + 1000);
485
+ room.objects['b0-beam-3'] = BEAM_NOW;
486
+ run(room, pageMs + 1000);
487
+ reconnect(room);
488
+ run(room, pageMs + 6000);
489
+ assert.equal(room.system.resume.armed, true, 'broadcasts after a drop do not release the cover');
490
+ assert.ok(room.frames.slice(-300).every((f) => f.cover), 'covered throughout');
491
+ }
492
+
493
+ // A give-up during a long disconnect stays given up until the connection is
494
+ // back, rather than covering again on the next frame; the return then arms
495
+ // the gate afresh and its WORLD releases it.
496
+ {
497
+ const room = await makeRoom({ objects: { 'b0-beam-3': BEAM_OLD } });
498
+ deliver(room, world(room), pageMs);
499
+ run(room, pageMs + 2000);
500
+ room.socket = false;
501
+ room.state = 'reconnecting';
502
+ run(room, pageMs + 10500);
503
+ assert.equal(room.system.resume.armed, false, 'gave up');
504
+ run(room, pageMs + 3000);
505
+ assert.equal(room.system.resume.armed, false, 'and does not cover again while still disconnected');
506
+ assert.ok(room.frames.slice(-60).every((f) => !f.cover));
507
+ room.objects['b0-beam-3'] = BEAM_NOW;
508
+ reconnect(room);
509
+ room.shownAt = pageMs;
510
+ assert.equal(room.system.resume.armed, true, 'the return arms the gate');
511
+ run(room, pageMs + 200);
512
+ deliver(room, world(room));
513
+ run(room, pageMs + 800);
514
+ check('give-up, then reconnect', room, { uncoverBy: 200 + 3 * FRAME_MS + TRANSIT_MS });
515
+ }
516
+
517
+ // A WORLD from a reconnect while the page was hidden, followed by another drop,
518
+ // does not release the return after the later reconnect: only a WORLD since it does.
519
+ {
520
+ const room = await makeRoom({ objects: { 'b0-beam-3': BEAM_OLD } });
521
+ deliver(room, world(room), pageMs);
522
+ run(room, pageMs + 2000);
523
+ hide(room);
524
+ room.socket = false;
525
+ room.state = 'reconnecting';
526
+ run(room, pageMs + 5000);
527
+ reconnect(room);
528
+ deliver(room, world(room));
529
+ run(room, pageMs + 100);
530
+ room.socket = false;
531
+ room.state = 'reconnecting';
532
+ run(room, pageMs + 5000);
533
+ room.objects['b0-beam-3'] = BEAM_NOW;
534
+ run(room, pageMs + 5000);
535
+ show(room);
536
+ run(room, pageMs + 300);
537
+ reconnect(room);
538
+ run(room, pageMs + 400);
539
+ assert.equal(room.system.resume.armed, true, 'the earlier WORLD does not count');
540
+ deliver(room, world(room));
541
+ run(room, pageMs + 800);
542
+ check('WORLD from an earlier hidden reconnect', room, { uncoverBy: 700 + 3 * FRAME_MS + TRANSIT_MS });
543
+ }
544
+
545
+ {
546
+ const room = await makeRoom({ objects: { 'b0-beam-3': BEAM_OLD } });
547
+ deliver(room, world(room), pageMs);
548
+ run(room, pageMs + 2000);
549
+ const paused = pageMs;
550
+ room.socket = false;
551
+ room.objects['b0-beam-3'] = BEAM_NOW;
552
+ pageMs += 5000;
553
+ room.nextTick = pageMs;
554
+ room.socket = true;
555
+ room.lastFrame = pageMs - FRAME_MS;
556
+ frame(room);
557
+ assert.equal(room.system.resume.armed, true, 'a long frame gap arms the gate');
558
+ assert.equal(globalThis.__cover, 'Reconnecting…');
559
+ assert.equal(room.system.resume.since, paused);
560
+ room.sentObjects.clear();
561
+ run(room, pageMs + 200);
562
+ assert.equal(room.system.resume.armed, false, 'a current broadcast releases it');
563
+ }
564
+
565
+ // An expired return: the session the player left ended while they were away,
566
+ // and closes under the cover. The caller leaving the place reads `returning`
567
+ // to go straight under its own cover, whichever of the two systems sees the
568
+ // close first; it stops counting a moment after the cover comes off, and at
569
+ // the next session.
570
+ {
571
+ const room = await makeRoom({ objects: { 'b0-beam-3': BEAM_OLD } });
572
+ deliver(room, world(room), pageMs);
573
+ run(room, pageMs + 2000);
574
+ assert.equal(room.system.returning(), false, 'an ordinary frame is not a return');
575
+ hide(room);
576
+ room.socket = false;
577
+ room.state = 'reconnecting';
578
+ run(room, pageMs + 180000);
579
+ show(room);
580
+ run(room, pageMs + 1100);
581
+ assert.equal(room.system.returning(), true, 'behind the cover');
582
+ room.system.net.closed = () => true;
583
+ assert.equal(room.system.returning(), true, 'a close not yet seen by the system');
584
+ frame(room);
585
+ assert.equal(room.system.net, null, 'the system saw the close');
586
+ assert.equal(room.system.returning(), true, 'a close under the cover still counts');
587
+ pageMs += 1900;
588
+ assert.equal(room.system.returning(), true);
589
+ pageMs += 200;
590
+ assert.equal(room.system.returning(), false, 'not after the moment has passed');
591
+ pageMs -= 2000;
592
+ room.system.switchSession(room.scene, { mode: 'public' }, { quiet: true });
593
+ assert.equal(room.system.returning(), false, 'not in the next session');
594
+
595
+ // Released by a snapshot just before the close: still a return.
596
+ const again = await makeRoom({ objects: { 'b0-beam-3': BEAM_OLD } });
597
+ deliver(again, world(again), pageMs);
598
+ run(again, pageMs + 2000);
599
+ hide(again);
600
+ run(again, pageMs + 30000);
601
+ show(again);
602
+ run(again, pageMs + 500);
603
+ assert.equal(again.system.resume.armed, false, 'released');
604
+ assert.equal(again.system.returning(), true, 'just released');
605
+ run(again, pageMs + 2100);
606
+ assert.equal(again.system.returning(), false);
607
+ }
608
+
609
+ {
610
+ const room = await makeRoom({ objects: { 'b0-beam-3': BEAM_OLD } });
611
+ hide(room);
612
+ assert.equal(room.system.resume.armed, false, 'an unplaced player is covered by the join overlay instead');
613
+ show(room);
614
+ // An unplaced public join is refreshed on return before its WORLD arrives.
615
+ await Promise.resolve();
616
+ deliver(room, world(room), pageMs);
617
+ run(room, pageMs + 500);
618
+ room.system.net.status = () => ({ state: 'connected', solo: true, others: 0, you: 'me' });
619
+ hide(room);
620
+ assert.equal(room.system.resume.armed, false, 'solo play has nothing to wait for');
621
+ }
622
+
623
+ console.table(results);
624
+ console.log('test-resume-gate: every return covered until current, then drawn at current poses with no easing');
@@ -30,7 +30,16 @@ Do you already know what you want to make, or do you want to figure it out toget
30
30
  - Two render hooks: `draw(ctx)` is world space and scrolls with `Camera`; `drawUi(ctx)` is screen space (card units, camera-free). On-screen controls, gauges and HUD go in `drawUi`, never `draw`. The React `ui()` hook is deprecated — prefer `drawUi`.
31
31
  - Do not read `engine/`, `editors/`, or built-in behaviors (`Layout.jsx`, `Sprite.jsx`, `Text.jsx`, `Style.jsx`, `Collider.jsx`, `Camera.jsx`, and the physics ones — `RigidBody.jsx`, `Joints.jsx`, `Draggable.jsx`, `Slingshot.jsx`, `AnalogStick.jsx`) to build a game. Their public API is documented below. Forking is the exception: when you're deliberately copying a kit file into the deck to change it — an editor (see `## Editors`) or a behavior you're shadowing — read the original. `engine/` stays off-limits either way.
32
32
  - An editor is for content FILES the creator keeps coming back to (catalogs, dialogue, level tables) that nothing already opens. Scenes, sprites and themes have editors; per-actor settings belong on behavior props in the inspector — not in a new editor.
33
- - Details below: `## Behavior shape`, `## Scene file`, `## Blueprints`, `## Built-in behaviors`, `## Creating pixel art`, `## SceneRuntime API`, and `## Input shortcuts`.
33
+ - Details below: `## Behavior shape`, `## Scene file`, `## Blueprints`, `## Built-in behaviors`, `## Creating pixel art`, `## SceneRuntime API
34
+
35
+ `scene.setActorSleeping(actorOrId, sleeping)` is an optional streaming primitive:
36
+ `true` pauses an actor's behavior/draw passes and omits it from `getActors()`
37
+ (and systems that reconcile that list, including colliders). Components, behavior
38
+ instances, runtime state, ID lookup and serialized source remain intact.
39
+ `false` wakes the same object. Spawning an ID wakes its replacement; despawn
40
+ removes it and scene load clears the sleep set. No sleep map exists until used.
41
+ `actorWith` still searches the full scene; `actorsWith` uses the live list.
42
+ `, and `## Input shortcuts`.
34
43
 
35
44
  ## Editors
36
45
 
@@ -68,11 +68,11 @@
68
68
  "onUpdate": "scripts/onUpdate.mjs",
69
69
  "title": "physics-2d",
70
70
  "description": "Scene Editor. Works like classic Castle: actors, blueprints, behaviors and drawing tools, with physics built in.",
71
- "publishedVersion": "2026-10-08T15:09:06.913Z",
71
+ "publishedVersion": "2026-10-17T06:02:29.713Z",
72
72
  "imports": {
73
73
  "castle.base": {
74
74
  "deckId": "yRcmH4_aYllE",
75
- "version": "2026-10-08T10:40:20.107Z"
75
+ "version": "2026-10-16T11:44:02.771Z"
76
76
  }
77
77
  }
78
78
  }