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,745 @@
1
+ // Observed progress (contract v1.141, docs/observed-progress.md): the kit's
2
+ // once-a-tick look at every body, the stations a place declares and the dwell
3
+ // it reads, against the real multiplayer-3d world (Rapier), its players'
4
+ // `setPose` and the hub layer's `place` and `step`, ticked by hand with a
5
+ // wall clock the test drives. Only scene loading and import resolution are
6
+ // supplied by this harness. `npm run check` runs it.
7
+ import assert from 'node:assert/strict';
8
+ import { register } from 'node:module';
9
+
10
+ const sceneStub = `
11
+ export const readScene = () => globalThis.__observedActors ?? [];
12
+ export const resolveScenePath = (path) => path ?? 'scenes/main.scene';
13
+ export const sceneGround = () => ({});
14
+ `;
15
+ const kitRoot = new URL('../../', import.meta.url).href;
16
+ const modules = {
17
+ '@dimforge/rapier3d-compat': new URL('../node_modules/@dimforge/rapier3d-compat/rapier.mjs', import.meta.url).href,
18
+ three: new URL('../node_modules/three/build/three.module.js', import.meta.url).href,
19
+ };
20
+ register(`data:text/javascript,${encodeURIComponent(`
21
+ export async function resolve(specifier, context, next) {
22
+ if (specifier.endsWith('/sceneBodies.js')) {
23
+ return { url: ${JSON.stringify('data:text/javascript,' + encodeURIComponent(sceneStub))}, shortCircuit: true };
24
+ }
25
+ const modules = ${JSON.stringify(modules)};
26
+ if ((specifier.startsWith('.') || specifier.startsWith('file:')) && new URL(specifier, context.parentURL).href.endsWith('/kits/physics-3d/engine3d/rapier.js')) {
27
+ return { url: modules['@dimforge/rapier3d-compat'], shortCircuit: true };
28
+ }
29
+ if (modules[specifier]) return { url: modules[specifier], shortCircuit: true };
30
+ if (specifier.startsWith('@imports/castle.')) {
31
+ return next(specifier.replace('@imports/castle.', ${JSON.stringify(kitRoot)}), context);
32
+ }
33
+ return next(specifier, context);
34
+ }
35
+ `)}`);
36
+ const World = await import('../../multiplayer-3d/code/server/world.js');
37
+ const Players = await import('../../multiplayer-3d/code/server/players.js');
38
+ const { layer } = await import('../code/server/hub.js');
39
+ const Observe = await import('../code/server/observe.js');
40
+ const Limits = await import('../../multiplayer-3d/code/server/limits.js');
41
+ assert.deepEqual(Observe.BOUNDS, Limits.BOUNDS, 'the mirrored world bounds match multiplayer-3d');
42
+
43
+ const spawn = { id: 'spawn', components: {
44
+ Player: {}, Transform: { x: 0, y: 1, z: 0 },
45
+ Shape: { kind: 'capsule', height: 1.4, radius: 0.35 },
46
+ } };
47
+ const door = { id: 'door', components: {
48
+ HubDoor: { id: 'race', to: 'race' }, Transform: { x: 30, y: 1, z: 0 },
49
+ } };
50
+ const config = { server: { maxPlayers: 8 }, hub: { contract: 1, title: 'Town',
51
+ places: { race: { title: 'Race', scene: 'scenes/race.scene' } },
52
+ } };
53
+ const TICK = 50;
54
+ let n = 0;
55
+ async function test(name, fn) {
56
+ try { await fn(); } catch (error) { console.error(`not ok: ${name}`); throw error; }
57
+ n += 1;
58
+ }
59
+
60
+ // A town with one player, arrived and settled, ticked by hand. `hooks` are the
61
+ // place's own; `ctx` is its `hub`.
62
+ async function boot({ hooks = {}, use = true, hub = {} } = {}) {
63
+ globalThis.__observedActors = [spawn, door];
64
+ const sim = await World.createSimulation();
65
+ Players.addPlayer(sim, 'p1');
66
+ const clock = { wall: 1_000_000 };
67
+ const engine = { createBody: World.createBody, removeActor: World.removeActor, maxSpeed: () => 12, wallNow: () => clock.wall };
68
+ let ctx;
69
+ const h = layer({ ...config, hub: { ...config.hub, ...hub } }, { ...hooks, ready(hub) { ctx = hub; hooks.ready?.(hub); } }, {}, () => true, () => ({}), null, engine);
70
+ const session = { sessionId: 'dev:observed', players: [{ playerId: 'p1', userId: '101', username: 'ada', isAnonymous: false }], send() {}, broadcast() {} };
71
+ h.sceneFor(session);
72
+ h.ready(sim);
73
+ const b = { sim, h, session, ctx, clock, entry: () => sim.players.get('p1'), origin: null };
74
+ h.message(session, { playerId: 'p1' }, { k: 'hub-hello', avatar: 1 });
75
+ tick(b);
76
+ if (use) {
77
+ // Observation starts here: a reset where the body stands, from now.
78
+ b.origin = { at: ctx.observed('p1').at, wall: clock.wall };
79
+ }
80
+ // The client agrees with where the arrival put it, which ends the settle.
81
+ report(b, here(b));
82
+ tick(b);
83
+ return b;
84
+ }
85
+ async function withBoot(options, fn) {
86
+ const b = await boot(options);
87
+ try { await fn(b); } finally { b.sim.world.free(); }
88
+ }
89
+
90
+ // One server tick: the reports delivered since the last, then real-time's
91
+ // order (place, physics, step). `simMs` is what real time let the sim advance
92
+ // (capped at 250 ms), `wallMs` what the wall clock did.
93
+ function tick(b, { simMs = TICK, wallMs = simMs } = {}) {
94
+ b.h.place(b.sim);
95
+ World.step(b.sim, simMs / 1000);
96
+ b.clock.wall += wallMs;
97
+ b.h.step(b.sim, []);
98
+ }
99
+ function report(b, at, id = 'p1') {
100
+ Players.setPose(b.sim, id, { p: [at.x, at.y, at.z, 0] });
101
+ }
102
+ function here(b) {
103
+ return { ...b.entry().at };
104
+ }
105
+ const flat = (a, c) => Math.hypot(a.x - c.x, a.z - c.z);
106
+
107
+ // A client walking from where its body is to `to` at `speed` m/s, reporting
108
+ // every `every` ms. `stall` withholds the reports of a window `{ at, ms }` of
109
+ // client time and delivers them together at its end. `each(t)` runs after
110
+ // every tick. Returns how long it took (ms).
111
+ function walk(b, to, { speed = 6, every = 100, stall = null, after = 0, each = () => {} } = {}) {
112
+ const from = here(b);
113
+ const length = flat(from, to);
114
+ const duration = (length / speed) * 1000;
115
+ const point = (t) => {
116
+ const f = Math.min(1, (speed * t) / 1000 / length);
117
+ return { x: from.x + (to.x - from.x) * f, y: from.y, z: from.z + (to.z - from.z) * f };
118
+ };
119
+ let sent = 0;
120
+ let held = [];
121
+ const end = duration + after;
122
+ for (let t = TICK; t <= end + every; t += TICK) {
123
+ while (sent + every <= t) {
124
+ sent += every;
125
+ const p = point(sent);
126
+ if (stall && sent > stall.at && sent <= stall.at + stall.ms) {
127
+ held.push(p);
128
+ } else {
129
+ held.push(p);
130
+ for (const q of held) {
131
+ report(b, q);
132
+ }
133
+ held = [];
134
+ }
135
+ }
136
+ tick(b);
137
+ each(t);
138
+ }
139
+ return end;
140
+ }
141
+ // Stand still for `ms`, reporting where the body is.
142
+ function stand(b, ms, each = () => {}) {
143
+ for (let t = TICK; t <= ms; t += TICK) {
144
+ report(b, here(b));
145
+ tick(b);
146
+ each(t);
147
+ }
148
+ }
149
+
150
+ // The doc's invariant: at a funded observation, the displacement since the
151
+ // last reset is at most the allowance times the credit clock since then, plus
152
+ // the cap. The credit clock never runs ahead of the test's wall clock. For
153
+ // tests with no placement after boot, whose last reset is observation's start.
154
+ function invariant(b) {
155
+ const o = b.ctx.observed('p1');
156
+ if (!o.ok || (o.step.x === 0 && o.step.z === 0)) {
157
+ return;
158
+ }
159
+ const T = (b.clock.wall - b.origin.wall) / 1000;
160
+ const cap = 0.4 * o.speed + 0.3;
161
+ const moved = flat(o.at, b.origin.at);
162
+ assert.ok(moved <= o.speed * T + cap + 1e-6, `displacement ${moved} m in ${T} s`);
163
+ assert.ok(o.travel <= o.speed * T + cap + 1e-6, `travel ${o.travel} m in ${T} s`);
164
+ }
165
+
166
+ const station = (x, radius = 1.5) => ({ at: { x, y: 1, z: 0 }, radius });
167
+
168
+ // --- 1, 4: walking in -------------------------------------------------------
169
+
170
+ for (const speed of [6, 4]) {
171
+ for (const every of [50, 100, 150, 200]) {
172
+ await test(`walking at ${speed} m/s, reports every ${every} ms, enters and dwells`, () => withBoot({}, (b) => {
173
+ assert.equal(b.ctx.station('goal', station(12)), true);
174
+ tick(b);
175
+ assert.deepEqual(b.ctx.dwell('p1', 'goal'), { inside: false, entered: false, ms: 0 });
176
+ const oks = [];
177
+ walk(b, { x: 12, y: here(b).y, z: 0 }, { speed, every, after: 300, each: () => { oks.push(b.ctx.observed('p1').ok); invariant(b); } });
178
+ assert.ok(oks.every(Boolean), 'ok holds throughout');
179
+ const d = b.ctx.dwell('p1', 'goal');
180
+ assert.equal(d.inside, true);
181
+ assert.equal(d.entered, true);
182
+ const before = d.ms;
183
+ stand(b, 1000);
184
+ assert.ok(b.ctx.dwell('p1', 'goal').ms >= before + 999, `ms grows: ${before} -> ${b.ctx.dwell('p1', 'goal').ms}`);
185
+ const o = b.ctx.observed('p1');
186
+ assert.ok(o.travel > 10 && o.travel < 13, `travel ${o.travel}`);
187
+ assert.equal(o.speed, 6 * 1.25);
188
+ }));
189
+ }
190
+ await test(`walking at ${speed} m/s with a three-report burst after a 300 ms stall enters`, () => withBoot({}, (b) => {
191
+ b.ctx.station('goal', station(12));
192
+ tick(b);
193
+ const oks = [];
194
+ walk(b, { x: 12, y: here(b).y, z: 0 }, { speed, every: 100, stall: { at: 700, ms: 300 }, after: 300, each: () => oks.push(b.ctx.observed('p1').ok) });
195
+ assert.ok(oks.every(Boolean));
196
+ assert.equal(b.ctx.dwell('p1', 'goal').entered, true);
197
+ assert.ok(b.ctx.observed('p1').travel > 10, 'the burst was walked, not resynced');
198
+ }));
199
+ }
200
+
201
+ await test('4 m/s with 50 ms reports enters through the hysteresis band', () => withBoot({}, (b) => {
202
+ b.ctx.station('goal', station(8, 1));
203
+ tick(b);
204
+ let inBand = 0;
205
+ walk(b, { x: 8, y: here(b).y, z: 0 }, { speed: 4, every: 50, after: 200, each: () => {
206
+ const x = b.ctx.observed('p1').at.x;
207
+ if (8 - x > 1 && 8 - x <= 1.25) {
208
+ inBand += 1;
209
+ assert.equal(b.ctx.dwell('p1', 'goal').entered, false, 'the band itself does not enter');
210
+ }
211
+ } });
212
+ assert.ok(inBand >= 1, `a tick in the band: ${inBand}`);
213
+ assert.equal(b.ctx.dwell('p1', 'goal').entered, true);
214
+ // Back out to the band: still in. Beyond it: out, and dwell ends.
215
+ walk(b, { x: 6.9, y: here(b).y, z: 0 }, { speed: 4, every: 50 });
216
+ assert.equal(b.ctx.dwell('p1', 'goal').entered, true);
217
+ assert.equal(b.ctx.dwell('p1', 'goal').inside, true);
218
+ walk(b, { x: 6, y: here(b).y, z: 0 }, { speed: 4, every: 50 });
219
+ assert.deepEqual(b.ctx.dwell('p1', 'goal'), { inside: false, entered: false, ms: 0 });
220
+ }));
221
+
222
+ // --- 2, 3: moves a walker cannot make ---------------------------------------
223
+
224
+ await test('bounded MOVE stuffing after 2 s idle never enters', () => withBoot({}, (b) => {
225
+ const start = here(b);
226
+ b.ctx.station('goal', station(start.x + 6, 1));
227
+ stand(b, 2000);
228
+ assert.equal(b.ctx.dwell('p1', 'goal').entered, false);
229
+ // Ten in-bound reports in one tick, 0.6 m each: setPose takes them all.
230
+ for (let i = 1; i <= 10; i += 1) {
231
+ report(b, { x: start.x + 0.6 * i, y: start.y, z: start.z });
232
+ }
233
+ assert.ok(Math.abs(here(b).x - (start.x + 6)) < 1e-6, 'setPose took the stuffed reports');
234
+ const travel = b.ctx.observed('p1').travel;
235
+ tick(b);
236
+ assert.equal(b.ctx.dwell('p1', 'goal').entered, false, 'the jump enters nothing');
237
+ assert.equal(b.ctx.observed('p1').travel, travel, 'and earns no travel');
238
+ stand(b, 1000);
239
+ assert.equal(b.ctx.dwell('p1', 'goal').entered, false, 'standing there does not enter');
240
+ assert.equal(b.ctx.dwell('p1', 'goal').ms, 0);
241
+ // Out past the exit band, and back in: entered.
242
+ walk(b, { x: start.x + 3, y: start.y, z: start.z });
243
+ walk(b, { x: start.x + 6, y: start.y, z: start.z }, { after: 200 });
244
+ assert.equal(b.ctx.dwell('p1', 'goal').entered, true);
245
+ }));
246
+
247
+ await test('stuffing while walking is rejected, then resyncs, and never enters', () => withBoot({}, (b) => {
248
+ const start = here(b);
249
+ b.ctx.station('goal', station(start.x + 9, 1));
250
+ walk(b, { x: start.x + 2, y: start.y, z: 0 });
251
+ stand(b, 50);
252
+ for (let i = 1; i <= 12; i += 1) {
253
+ report(b, { x: start.x + 2 + 0.6 * i, y: start.y, z: 0 });
254
+ }
255
+ tick(b);
256
+ const o = b.ctx.observed('p1');
257
+ assert.equal(o.ok, false, 'unreachable: rejected');
258
+ assert.deepEqual(o.step, { x: 0, y: 0, z: 0 });
259
+ assert.ok(Math.abs(o.at.x - (start.x + 2)) < 0.05, `held where it was: ${JSON.stringify(start)} ${JSON.stringify(o.at)}`);
260
+ let entered = false;
261
+ stand(b, 2000, () => { entered ||= b.ctx.dwell('p1', 'goal').entered; });
262
+ assert.equal(entered, false);
263
+ assert.equal(b.ctx.observed('p1').ok, true, 'resynced once walking time passed');
264
+ assert.ok(flat(b.ctx.observed('p1').at, here(b)) < 1e-6);
265
+ }));
266
+
267
+ await test('12 m/s reports never enter and earn no travel beyond the credit cap', () => withBoot({}, (b) => {
268
+ const start = here(b);
269
+ b.ctx.station('goal', station(start.x + 20, 1.5));
270
+ stand(b, 1000);
271
+ const travel0 = b.ctx.observed('p1').travel;
272
+ let entered = false;
273
+ for (const every of [100]) {
274
+ walk(b, { x: start.x + 20, y: start.y, z: 0 }, { speed: 12, every, after: 500, each: () => { entered ||= b.ctx.dwell('p1', 'goal').entered; invariant(b); } });
275
+ }
276
+ assert.ok(Math.abs(here(b).x - (start.x + 20)) < 1e-6, 'setPose let 12 m/s through');
277
+ assert.equal(entered, false);
278
+ const credited = b.ctx.observed('p1').travel - travel0;
279
+ assert.ok(credited <= 3.3 + 7.5 * 1.5, `credited ${credited} of 20 m`);
280
+ assert.ok(credited < 15, `credited ${credited} of 20 m`);
281
+ // And at 200 ms reports, too fast for a resync each time.
282
+ stand(b, 1000);
283
+ const back = b.ctx.observed('p1').travel;
284
+ walk(b, { x: start.x, y: start.y, z: 0 }, { speed: 12, every: 200, after: 500 });
285
+ assert.ok(b.ctx.observed('p1').travel - back < 15);
286
+ }));
287
+
288
+ // --- 5, 6: placements and bodies ------------------------------------------------
289
+
290
+ await test('hub.placeAt onto a station resets: inside, not entered, ms 0; out and in enters', () => withBoot({}, (b) => {
291
+ const start = here(b);
292
+ b.ctx.station('goal', station(start.x + 10, 1.5));
293
+ walk(b, { x: start.x + 4, y: start.y, z: 0 });
294
+ assert.ok(b.ctx.observed('p1').travel > 3.9);
295
+ b.ctx.placeAt('p1', { x: start.x + 10, y: start.y, z: 0 });
296
+ // At once, before any pass.
297
+ assert.equal(b.ctx.observed('p1').ok, false);
298
+ assert.equal(b.ctx.observed('p1').travel, 0);
299
+ assert.deepEqual(b.ctx.dwell('p1', 'goal'), { inside: false, entered: false, ms: 0 });
300
+ tick(b);
301
+ const o = b.ctx.observed('p1');
302
+ assert.equal(o.ok, true);
303
+ assert.equal(o.travel, 0);
304
+ assert.equal(o.since, b.sim.timeMs);
305
+ assert.ok(Math.abs(o.at.x - (start.x + 10)) < 1e-6);
306
+ report(b, here(b));
307
+ stand(b, 1000);
308
+ assert.deepEqual(b.ctx.dwell('p1', 'goal'), { inside: true, entered: false, ms: 0 });
309
+ walk(b, { x: start.x + 7, y: start.y, z: 0 });
310
+ walk(b, { x: start.x + 10, y: start.y, z: 0 }, { after: 300 });
311
+ assert.equal(b.ctx.dwell('p1', 'goal').entered, true);
312
+ assert.ok(b.ctx.dwell('p1', 'goal').ms > 0);
313
+ }));
314
+
315
+ await test('an arrival onto a station is a reset', () => withBoot({ hooks: { ready(hub) {
316
+ hub.station('spawn', { at: { x: 0, y: 1, z: 0 }, radius: 3 });
317
+ } } }, (b) => {
318
+ stand(b, 1000);
319
+ assert.deepEqual(b.ctx.dwell('p1', 'spawn'), { inside: true, entered: false, ms: 0 });
320
+ walk(b, { x: 5, y: here(b).y, z: 0 });
321
+ walk(b, { x: 0, y: here(b).y, z: 0 }, { after: 300 });
322
+ assert.equal(b.ctx.dwell('p1', 'spawn').entered, true);
323
+ }));
324
+
325
+ await test('a door jump is a reset', () => withBoot({}, (b) => {
326
+ // The jump puts a player in front of the door, at +z.
327
+ b.ctx.station('door', { at: { x: 30, y: 1, z: 4 }, radius: 6 });
328
+ walk(b, { x: 22, y: here(b).y, z: 0 });
329
+ walk(b, { x: 29, y: here(b).y, z: 3 }, { after: 200 });
330
+ assert.equal(b.ctx.dwell('p1', 'door').entered, true);
331
+ walk(b, { x: 0, y: here(b).y, z: 0 }, { speed: 6 });
332
+ assert.equal(b.ctx.dwell('p1', 'door').entered, false);
333
+ const before = here(b);
334
+ b.h.message(b.session, { playerId: 'p1' }, { k: 'hub-door-jump', door: 'race' });
335
+ tick(b);
336
+ assert.ok(flat(here(b), before) > 10, 'the jump moved the body');
337
+ const d = b.ctx.dwell('p1', 'door');
338
+ assert.equal(d.entered, false);
339
+ assert.equal(d.ms, 0);
340
+ assert.equal(d.inside, true, `the jump lands inside: ${JSON.stringify(here(b))}`);
341
+ assert.equal(b.ctx.observed('p1').travel, 0);
342
+ }));
343
+
344
+ await test('a same-spot placement is not a reset', () => withBoot({}, (b) => {
345
+ b.ctx.station('goal', station(10, 1.5));
346
+ walk(b, { x: 10, y: here(b).y, z: 0 }, { after: 500 });
347
+ const d = b.ctx.dwell('p1', 'goal');
348
+ assert.equal(d.entered, true);
349
+ const o = b.ctx.observed('p1');
350
+ b.ctx.placeAt('p1', { ...o.at, x: o.at.x + 0.03 });
351
+ assert.equal(b.ctx.observed('p1').ok, true);
352
+ tick(b);
353
+ assert.equal(b.ctx.dwell('p1', 'goal').entered, true);
354
+ assert.ok(b.ctx.dwell('p1', 'goal').ms > d.ms);
355
+ assert.equal(b.ctx.observed('p1').travel >= o.travel, true);
356
+ }));
357
+
358
+ await test('a retained resume on the same body is not a reset; a placement in the hook invalidates at once', async () => {
359
+ const seen = [];
360
+ let move = false;
361
+ await withBoot({ hooks: { resume(hub, { playerId }) {
362
+ seen.push({ before: hub.dwell(playerId, 'goal') });
363
+ if (move) {
364
+ hub.placeAt(playerId, { x: 0, y: 0.76, z: 5 });
365
+ seen.at(-1).after = hub.dwell(playerId, 'goal');
366
+ seen.at(-1).ok = hub.observed(playerId).ok;
367
+ }
368
+ } } }, (b) => {
369
+ b.ctx.station('goal', station(10, 1.5));
370
+ walk(b, { x: 10, y: here(b).y, z: 0 }, { after: 500 });
371
+ const ms = b.ctx.dwell('p1', 'goal').ms;
372
+ const entry = b.entry();
373
+ b.h.message(b.session, { playerId: 'p1' }, { k: 'hub-hello', avatar: 1, party: 1, resume: true });
374
+ tick(b);
375
+ assert.equal(seen.length, 1, 'the resume hook ran');
376
+ assert.equal(seen[0].before.entered, true);
377
+ assert.equal(b.entry(), entry, 'same body');
378
+ report(b, here(b));
379
+ tick(b);
380
+ assert.equal(b.ctx.dwell('p1', 'goal').entered, true, 'not a reset');
381
+ assert.ok(b.ctx.dwell('p1', 'goal').ms > ms, 'dwell goes on');
382
+ move = true;
383
+ b.h.message(b.session, { playerId: 'p1' }, { k: 'hub-hello', avatar: 1, party: 1, resume: true });
384
+ tick(b);
385
+ assert.equal(seen.length, 2);
386
+ assert.equal(seen[1].before.entered, true);
387
+ assert.deepEqual(seen[1].after, { inside: false, entered: false, ms: 0 }, 'invalidated in the same hook');
388
+ assert.equal(seen[1].ok, false);
389
+ });
390
+ });
391
+
392
+ await test('a replacement body, and a new sim entry, are resets', () => withBoot({}, (b) => {
393
+ b.ctx.station('goal', station(10, 1.5));
394
+ walk(b, { x: 10, y: here(b).y, z: 0 }, { after: 500 });
395
+ assert.equal(b.ctx.dwell('p1', 'goal').entered, true);
396
+ // A new capsule for the same entry.
397
+ const entry = b.entry();
398
+ b.sim.world.removeRigidBody(entry.body);
399
+ entry.body = World.createBody(b.sim, { components: { Solid: {} } }, { ...entry.at, rotationX: 0, rotationY: 0, rotationZ: 0 }, b.sim.template?.shape ?? { kind: 'capsule', radius: 0.35, height: 1.4 }, { type: 'kinematic', friction: 0 });
400
+ tick(b);
401
+ assert.deepEqual(b.ctx.dwell('p1', 'goal'), { inside: true, entered: false, ms: 0 });
402
+ assert.equal(b.ctx.observed('p1').travel, 0);
403
+ walk(b, { x: 6, y: here(b).y, z: 0 });
404
+ walk(b, { x: 10, y: here(b).y, z: 0 }, { after: 300 });
405
+ assert.equal(b.ctx.dwell('p1', 'goal').entered, true);
406
+ // A new sim entry where the old one stood.
407
+ const at = here(b);
408
+ Players.removePlayer(b.sim, 'p1');
409
+ tick(b);
410
+ assert.equal(b.ctx.observed('p1'), null, 'gone from the sim: no record');
411
+ assert.equal(b.ctx.dwell('p1', 'goal'), null);
412
+ Players.addPlayer(b.sim, 'p1', [at.x, at.y, at.z, 0]);
413
+ tick(b);
414
+ assert.deepEqual(b.ctx.dwell('p1', 'goal'), { inside: true, entered: false, ms: 0 });
415
+ }));
416
+
417
+ await test('a retained return puts the same body back on its spot: not a reset', async () => {
418
+ const resumed = [];
419
+ await withBoot({
420
+ hub: { result: { score: { unit: 's', better: 'lower' } }, resume: { keep: true }, resumeVisibility: true },
421
+ hooks: { resume(hub, { playerId }) { resumed.push(hub.dwell(playerId, 'goal')); } },
422
+ }, (b) => {
423
+ b.ctx.station('goal', station(10, 1.5));
424
+ walk(b, { x: 10, y: here(b).y, z: 0 }, { after: 500 });
425
+ assert.equal(b.ctx.dwell('p1', 'goal').entered, true);
426
+ const entry = b.entry();
427
+ const at = here(b);
428
+ const ms = b.ctx.dwell('p1', 'goal').ms;
429
+ // The roster row goes; real time keeps the body. No reports while away.
430
+ const players = b.session.players;
431
+ b.session.players = [];
432
+ for (let i = 0; i < 10; i += 1) {tick(b);}
433
+ assert.equal(b.ctx.dwell('p1', 'goal').ms, ms, 'nothing added while away');
434
+ assert.equal(b.ctx.dwell('p1', 'goal').entered, true, 'nothing zeroed while away');
435
+ entry.clamped = false;
436
+ b.session.players = players;
437
+ tick(b);
438
+ assert.equal(entry.clamped, true, 'the retained return ran moveBody');
439
+ assert.equal(b.entry(), entry, 'the same body');
440
+ assert.ok(flat(here(b), at) < 1e-6, 'onto the same spot');
441
+ assert.equal(resumed.length, 1, 'the retained resume hook ran');
442
+ assert.equal(resumed[0].entered, true, 'not a reset, inside the hook');
443
+ report(b, here(b));
444
+ tick(b);
445
+ const d = b.ctx.dwell('p1', 'goal');
446
+ assert.equal(d.entered, true, 'not a reset');
447
+ assert.ok(d.ms > ms, 'dwell goes on');
448
+ assert.ok(b.ctx.observed('p1').travel > 9, 'travel kept');
449
+ });
450
+ });
451
+
452
+ // --- review regressions (Sol, f7dfac5d4) ---------------------------------------
453
+
454
+ await test('P1: reports stuffed after hub.placeAt and before the pass are not the reset origin', () => withBoot({}, (b) => {
455
+ b.ctx.station('goal', station(20, 1.5));
456
+ walk(b, { x: 4, y: here(b).y, z: 0 });
457
+ const y = here(b).y;
458
+ b.ctx.placeAt('p1', { x: 10, y, z: 0 });
459
+ // Before the next pass: in-bound reports from the placement to x=18.2.
460
+ for (let x = 10.6; x < 18.2; x += 0.6) {
461
+ report(b, { x, y, z: 0 });
462
+ }
463
+ report(b, { x: 18.2, y, z: 0 });
464
+ assert.ok(Math.abs(here(b).x - 18.2) < 1e-6, 'setPose took them');
465
+ tick(b);
466
+ const o = b.ctx.observed('p1');
467
+ assert.ok(Math.abs(o.at.x - 10) < 1e-6, `reset at the placement, not the reports: ${o.at.x}`);
468
+ assert.equal(o.ok, false, 'the stuffed move is admitted from the placement: rejected');
469
+ // Then the 0.3 m step into the station, and standing there.
470
+ report(b, { x: 18.5, y, z: 0 });
471
+ let entered = false;
472
+ tick(b);
473
+ entered ||= b.ctx.dwell('p1', 'goal').entered;
474
+ stand(b, 4000, () => { entered ||= b.ctx.dwell('p1', 'goal').entered; });
475
+ assert.equal(entered, false);
476
+ assert.equal(b.ctx.observed('p1').travel, 0);
477
+ }));
478
+
479
+ await test('P1: 3 s idle, a resync to x=18.2 and a 0.3 m step never enter (the deficit)', () => withBoot({}, (b) => {
480
+ b.ctx.station('goal', station(20, 1.5));
481
+ stand(b, 3000);
482
+ const y = here(b).y;
483
+ const from = here(b).x;
484
+ for (let x = from + 0.6; x < 18.2; x += 0.6) {
485
+ report(b, { x, y, z: 0 });
486
+ }
487
+ report(b, { x: 18.2, y, z: 0 });
488
+ assert.ok(Math.abs(here(b).x - 18.2) < 1e-6);
489
+ tick(b);
490
+ const o = b.ctx.observed('p1');
491
+ assert.equal(o.ok, true, 'resynced');
492
+ assert.ok(Math.abs(o.at.x - 18.2) < 1e-6);
493
+ report(b, { x: 18.5, y, z: 0 });
494
+ tick(b);
495
+ assert.ok(Math.abs(b.ctx.observed('p1').at.x - 18.5) < 1e-6, 'the 0.3 m step is adopted, unfunded');
496
+ let entered = false;
497
+ stand(b, 4000, () => { entered ||= b.ctx.dwell('p1', 'goal').entered; });
498
+ assert.equal(entered, false, 'neither the step nor standing there enters');
499
+ // A step out past the exit band while credit is negative sets nothing either.
500
+ walk(b, { x: 17, y, z: 0 }, { speed: 6 });
501
+ walk(b, { x: 19, y, z: 0 }, { speed: 6, after: 200 });
502
+ assert.equal(b.ctx.dwell('p1', 'goal').entered, true, 'credit back, out and back in enters');
503
+ }));
504
+
505
+ await test('P1: a resync owes its walking time after the jump, idle or not', () => withBoot({}, (b) => {
506
+ b.ctx.station('goal', station(20, 1.5));
507
+ stand(b, 3000);
508
+ const y = here(b).y;
509
+ for (let x = here(b).x + 0.6; x < 12; x += 0.6) {
510
+ report(b, { x, y, z: 0 });
511
+ }
512
+ report(b, { x: 12, y, z: 0 });
513
+ tick(b);
514
+ // 12 m owed at 7.5 m/s: 1.6 s. Walking straight in at once (1.1 s) is too soon.
515
+ walk(b, { x: 19, y, z: 0 }, { speed: 6, after: 0 });
516
+ assert.equal(b.ctx.dwell('p1', 'goal').entered, false);
517
+ }));
518
+
519
+ await test('P1 round 2: a deficit and walking share one allowance (idle 3 s, resync to x=12, walk at 6 m/s to a station at x=26)', () => withBoot({}, (b) => {
520
+ b.ctx.station('goal', station(26, 1.5));
521
+ const y = here(b).y;
522
+ const x0 = here(b).x;
523
+ stand(b, 3000);
524
+ // Measured from the jump: entry may come no sooner than a walker at the
525
+ // allowance could get there, plus the credit cap and the reach slack.
526
+ const jumpWall = b.clock.wall;
527
+ for (let x = x0 + 0.6; x < 12; x += 0.6) {
528
+ report(b, { x, y, z: 0 });
529
+ }
530
+ report(b, { x: 12, y, z: 0 });
531
+ tick(b);
532
+ assert.equal(b.ctx.observed('p1').ok, true, 'resynced');
533
+ assert.ok(Math.abs(b.ctx.observed('p1').at.x - 12) < 1e-6);
534
+ const allowance = 7.5;
535
+ const bound = (wall) => allowance * (wall - jumpWall) / 1000 + 0.4 * allowance + 0.3 + 0.5;
536
+ let entry = null;
537
+ const watch = () => {
538
+ invariant(b);
539
+ if (!entry && b.ctx.dwell('p1', 'goal').entered) {
540
+ entry = { x: b.ctx.observed('p1').at.x, wall: b.clock.wall };
541
+ }
542
+ };
543
+ // Straight through the station and past it at 6 m/s.
544
+ walk(b, { x: 30, y, z: 0 }, { speed: 6, every: 100, each: watch });
545
+ if (entry) {
546
+ assert.ok(entry.x - x0 <= bound(entry.wall), `entered at x=${entry.x} ${(entry.wall - jumpWall) / 1000} s after the jump`);
547
+ }
548
+ assert.equal(entry, null, 'walking straight through after the jump never enters');
549
+ // Credit back, out and back in enters, and still within the walker bound.
550
+ stand(b, 3000, watch);
551
+ walk(b, { x: 26, y, z: 0 }, { speed: 6, every: 100, after: 200, each: watch });
552
+ assert.ok(entry, 'entered once the credit was back');
553
+ assert.ok(entry.x - x0 <= bound(entry.wall), `entered at x=${entry.x} ${(entry.wall - jumpWall) / 1000} s after the jump`);
554
+ }));
555
+
556
+ await test('P1: one clock: 40 ms ticks over 10 s wall count 10 s, not the sum of per-tick maxima', () => withBoot({}, (b) => {
557
+ b.ctx.station('goal', station(10, 1.5));
558
+ walk(b, { x: 10, y: here(b).y, z: 0 }, { after: 300 });
559
+ assert.equal(b.ctx.dwell('p1', 'goal').entered, true);
560
+ const ms = b.ctx.dwell('p1', 'goal').ms;
561
+ for (let t = 40; t <= 10000; t += 40) {
562
+ report(b, here(b));
563
+ tick(b, { simMs: 40, wallMs: 40 });
564
+ }
565
+ const grew = b.ctx.dwell('p1', 'goal').ms - ms;
566
+ assert.ok(grew <= 10000 + 40 + 1e-6, `dwell grew ${grew} ms in 10 s`);
567
+ assert.ok(grew >= 10000 - 40 - 1e-6, `dwell grew ${grew} ms in 10 s`);
568
+ }));
569
+
570
+ await test('P1: 8.2 m/s reports at 40 ms ticks earn at most allowance x T + the credit cap', () => withBoot({}, (b) => {
571
+ stand(b, 1000);
572
+ const start = here(b);
573
+ const travel0 = b.ctx.observed('p1').travel;
574
+ const wall0 = b.clock.wall;
575
+ for (let t = 40; t <= 10000; t += 40) {
576
+ report(b, { x: start.x + 8.2 * t / 1000, y: start.y, z: 0 });
577
+ tick(b, { simMs: 40, wallMs: 40 });
578
+ invariant(b);
579
+ }
580
+ assert.ok(here(b).x - start.x > 81, 'setPose let 8.2 m/s through');
581
+ const T = (b.clock.wall - wall0) / 1000;
582
+ const credited = b.ctx.observed('p1').travel - travel0;
583
+ assert.ok(credited <= 7.5 * T + 3.3 + 1e-6, `credited ${credited} m in ${T} s`);
584
+ }));
585
+
586
+ // --- 7: stalls ----------------------------------------------------------------
587
+
588
+ await test('a 3 s network stall then a burst resyncs: ok, not entered, no travel for the gap', () => withBoot({}, (b) => {
589
+ const start = here(b);
590
+ b.ctx.station('goal', station(start.x + 22, 1.5));
591
+ let travelBefore = null;
592
+ const oks = [];
593
+ walk(b, { x: start.x + 22, y: start.y, z: 0 }, { speed: 6, every: 100, stall: { at: 400, ms: 3000 }, after: 300, each: (t) => {
594
+ if (t === 400) {travelBefore = b.ctx.observed('p1').travel;}
595
+ oks.push(b.ctx.observed('p1').ok);
596
+ } });
597
+ assert.ok(oks.every(Boolean), 'never rejected');
598
+ assert.equal(b.ctx.dwell('p1', 'goal').entered, false, 'resynced into the station: not entered');
599
+ assert.ok(b.ctx.dwell('p1', 'goal').inside);
600
+ const travel = b.ctx.observed('p1').travel;
601
+ // 2.4 m walked before the stall, about 18 m in the gap (none credited), the rest after.
602
+ assert.ok(travel - travelBefore < 22 - 2.4 - 17, `travel ${travelBefore} -> ${travel}`);
603
+ }));
604
+
605
+ await test('a 1 s server stall with sim time capped, then legit reports, is never rejected', () => withBoot({}, (b) => {
606
+ const start = here(b);
607
+ // Far enough on that the stall's 2.7 m deficit is paid back (1.8 s at 6 m/s) before it.
608
+ b.ctx.station('goal', station(start.x + 30, 1.5));
609
+ const oks = [];
610
+ walk(b, { x: start.x + 4, y: start.y, z: 0 }, { each: () => oks.push(b.ctx.observed('p1').ok) });
611
+ // The client walks on for a second the server does not tick; its ten
612
+ // reports are taken at once, then real time steps the sim 250 ms.
613
+ const from = here(b);
614
+ for (let i = 1; i <= 10; i += 1) {
615
+ report(b, { x: from.x + 0.6 * i, y: from.y, z: 0 });
616
+ }
617
+ tick(b, { simMs: 250, wallMs: 1000 });
618
+ oks.push(b.ctx.observed('p1').ok);
619
+ walk(b, { x: start.x + 30, y: start.y, z: 0 }, { after: 300, each: () => { oks.push(b.ctx.observed('p1').ok); invariant(b); } });
620
+ assert.ok(oks.every(Boolean), 'never rejected');
621
+ assert.equal(b.ctx.dwell('p1', 'goal').entered, true, 'walked on and in after the stall, without stopping');
622
+ }));
623
+
624
+ // Sol round 3: after a 1 s server stall a walker who never stops recovers. The
625
+ // stall's deficit (its jump less the credit cap) is paid back at the allowance
626
+ // less the walking speed, then travel grows again and the station is entered.
627
+ for (const speed of [6, 4]) {
628
+ for (const every of [50, 100, 150, 200]) {
629
+ await test(`a 1 s server stall then walking on at ${speed} m/s, reports every ${every} ms, recovers and enters`, () => withBoot({}, (b) => {
630
+ const start = here(b);
631
+ b.ctx.station('goal', station(80, 1.5));
632
+ walk(b, { x: start.x + 4, y: start.y, z: 0 }, { speed, every: 100, after: 400 });
633
+ const from = here(b);
634
+ // The client walks on through a second the server does not tick.
635
+ for (let i = 1; i <= 10; i += 1) {
636
+ report(b, { x: from.x + speed * 0.1 * i, y: from.y, z: 0 });
637
+ }
638
+ tick(b, { simMs: 250, wallMs: 1000 });
639
+ const jump = speed;
640
+ const deficit = jump - (0.4 * 7.5 + 0.3);
641
+ const stallWall = b.clock.wall;
642
+ const travel0 = b.ctx.observed('p1').travel;
643
+ let regrew = null;
644
+ const oks = [];
645
+ walk(b, { x: 80, y: from.y, z: 0 }, { speed, every, after: 300, each: () => {
646
+ const o = b.ctx.observed('p1');
647
+ oks.push(o.ok);
648
+ invariant(b);
649
+ if (regrew === null && o.travel > travel0 + 1e-6) {
650
+ regrew = (b.clock.wall - stallWall) / 1000;
651
+ }
652
+ } });
653
+ assert.ok(oks.every(Boolean), 'never rejected');
654
+ const expect = Math.max(0, deficit) / (7.5 - speed);
655
+ assert.ok(regrew !== null, 'travel grows again');
656
+ assert.ok(regrew <= expect + every / 1000 + 0.15, `travel regrew after ${regrew} s, deficit ${deficit} m pays back in ${expect} s`);
657
+ assert.ok(regrew >= expect - every / 1000 - 0.15, `travel regrew after ${regrew} s, not before ${expect} s`);
658
+ assert.equal(b.ctx.dwell('p1', 'goal').entered, true, 'entered without stopping');
659
+ const after = 80 - from.x - jump - speed * regrew;
660
+ assert.ok(b.ctx.observed('p1').travel - travel0 >= after - 2, `credited the walk after recovery: ${b.ctx.observed('p1').travel - travel0} of ${after} m`);
661
+ }));
662
+ }
663
+ }
664
+
665
+ // --- 8 and the API's edges ------------------------------------------------------
666
+
667
+ await test('a place that never calls the API keeps no observation state', () => withBoot({ use: false }, (b) => {
668
+ walk(b, { x: 10, y: here(b).y, z: 0 });
669
+ b.ctx.placeAt('p1', { x: 0, y: here(b).y, z: 3 });
670
+ tick(b);
671
+ assert.equal(b.ctx.dwell('p1', 'goal'), null);
672
+ // The first call starts it here, from nothing: a reset now.
673
+ const o = b.ctx.observed('p1');
674
+ assert.equal(o.travel, 0);
675
+ assert.equal(o.since, b.sim.timeMs);
676
+ // The pass and the placement hook keep nothing without it.
677
+ const bare = { observe: null, sim: b.sim, session: b.session };
678
+ Observe.pass(bare);
679
+ Observe.placed(bare, 'p1', { x: 9, y: 1, z: 9 });
680
+ assert.equal(bare.observe, null);
681
+ }));
682
+
683
+ await test('station and dwell refuse bad calls and keep shapes', () => withBoot({}, (b) => {
684
+ const warn = console.warn;
685
+ const warned = [];
686
+ console.warn = (text) => warned.push(text);
687
+ try {
688
+ assert.equal(b.ctx.station('', station(1)), false);
689
+ assert.equal(b.ctx.station('x'.repeat(65), station(1)), false);
690
+ assert.equal(b.ctx.station('a', { at: { x: NaN, y: 0, z: 0 }, radius: 1 }), false);
691
+ assert.equal(b.ctx.station('a', { at: { x: 0, y: 0, z: 0 }, radius: 0 }), false);
692
+ assert.equal(b.ctx.station('a', { at: { x: 0, y: 0, z: 0 }, radius: 500 }), false);
693
+ assert.equal(b.ctx.station('a', { at: { x: 0, y: 0, z: 0 }, radius: 1, height: -1 }), false);
694
+ assert.equal(b.ctx.station('a', 'nope'), false);
695
+ assert.equal(b.ctx.observed(7), null);
696
+ assert.equal(b.ctx.dwell('p1', 'nope'), null);
697
+ assert.equal(b.ctx.dwell('nobody', 'a'), null);
698
+ for (let i = 0; i < Observe.MAX_STATIONS; i += 1) {
699
+ assert.equal(b.ctx.station(`s${i}`, station(i)), true);
700
+ }
701
+ assert.equal(b.ctx.station('one-more', station(1)), false);
702
+ assert.equal(b.ctx.station('s0', null), true);
703
+ assert.equal(b.ctx.dwell('p1', 's0'), null);
704
+ assert.equal(b.ctx.station('one-more', station(1)), true);
705
+ } finally {
706
+ console.warn = warn;
707
+ }
708
+ assert.ok(warned.length >= 3 && warned.length <= 5, `warned once each: ${warned.length}`);
709
+ // Same shape: nothing changes. A new shape: that station's dwell starts over.
710
+ assert.equal(b.ctx.station('one-more', null), true);
711
+ assert.equal(b.ctx.station('goal', station(10)), true);
712
+ walk(b, { x: 10, y: here(b).y, z: 0 }, { after: 500 });
713
+ const ms = b.ctx.dwell('p1', 'goal').ms;
714
+ assert.ok(ms > 0);
715
+ b.ctx.station('goal', station(10));
716
+ assert.equal(b.ctx.dwell('p1', 'goal').ms, ms);
717
+ b.ctx.station('goal', station(10, 2));
718
+ assert.deepEqual(b.ctx.dwell('p1', 'goal'), { inside: true, entered: false, ms: 0 });
719
+ // Values are copies.
720
+ const o = b.ctx.observed('p1');
721
+ o.at.x = 99;
722
+ assert.notEqual(b.ctx.observed('p1').at.x, 99);
723
+ }));
724
+
725
+ await test('a tuned player gets their own allowance; an absent tick adds nothing and zeroes nothing', () => withBoot({}, (b) => {
726
+ b.ctx.tune('p1', { speed: 2 });
727
+ tick(b);
728
+ assert.equal(b.ctx.observed('p1').speed, 6 * 2 * 1.25);
729
+ b.ctx.station('goal', station(15, 1.5));
730
+ const oks = [];
731
+ walk(b, { x: 15, y: here(b).y, z: 0 }, { speed: 12, every: 100, after: 300, each: () => oks.push(b.ctx.observed('p1').ok) });
732
+ assert.ok(oks.every(Boolean));
733
+ assert.equal(b.ctx.dwell('p1', 'goal').entered, true);
734
+ const ms = b.ctx.dwell('p1', 'goal').ms;
735
+ const players = b.session.players;
736
+ b.session.players = [];
737
+ stand(b, 500);
738
+ assert.equal(b.ctx.dwell('p1', 'goal').ms, ms, 'absent: nothing added');
739
+ assert.equal(b.ctx.dwell('p1', 'goal').entered, true, 'and nothing zeroed');
740
+ b.session.players = players;
741
+ stand(b, 500);
742
+ assert.ok(b.ctx.dwell('p1', 'goal').ms > ms);
743
+ }));
744
+
745
+ console.log(`test-observed: ${n} passed`);