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,340 @@
1
+ import assert from 'node:assert/strict';
2
+ import fs from 'node:fs';
3
+ import { register } from 'node:module';
4
+ import path from 'node:path';
5
+ import { fileURLToPath } from 'node:url';
6
+
7
+ const KIT = fileURLToPath(new URL('..', import.meta.url));
8
+ const engine = path.join(KIT, '..', 'physics-3d');
9
+ const art = path.join(KIT, '..', 'physics-2d');
10
+ register(
11
+ 'data:text/javascript,' +
12
+ encodeURIComponent(`
13
+ import {existsSync} from 'node:fs';
14
+ import {fileURLToPath,pathToFileURL} from 'node:url';
15
+ export async function resolve(specifier,context,next) {
16
+ if(specifier.startsWith('@imports/castle.physics-2d/')) specifier=pathToFileURL(${JSON.stringify(art)}+'/'+specifier.slice(27)).href;
17
+ if((specifier.startsWith('.')||specifier.startsWith('file:'))&&context.parentURL?.startsWith('file:')&&!/\\.(m?js|jsx|json)$/.test(specifier)) {
18
+ const base=new URL(specifier,context.parentURL).href;
19
+ for(const ext of ['.js','.jsx']) if(existsSync(fileURLToPath(base+ext))) return next(base+ext,context);
20
+ }
21
+ return next(specifier,context);
22
+ }`),
23
+ );
24
+ const THREE = await import('three');
25
+ const { makeFarAvatars } = await import('../code/client/farAvatars.js');
26
+ const { lookOf } = await import('../code/client/avatarShare.js');
27
+ const { buildModelNode, parseModel } = await import(path.join(engine, 'engine3d/pxmodel.js'));
28
+ const { copyModel } = await import(path.join(engine, 'engine3d/optimize.js'));
29
+
30
+ function fixture(template) {
31
+ const scene3d = new THREE.Scene(),
32
+ nodes = new Map(),
33
+ models = new Map([['avatar', { template, users: 2 }]]);
34
+ const make = (id, x) => {
35
+ const node = new THREE.Group(),
36
+ rig = copyModel(template),
37
+ hat = new THREE.Group();
38
+ rig.position.y = 0.25;
39
+ rig.scale.setScalar(1.5);
40
+ hat.name = 'wear';
41
+ node.add(rig, hat);
42
+ node.position.x = x;
43
+ scene3d.add(node);
44
+ const entry = { node, modelKey: 'avatar' };
45
+ nodes.set(id, entry);
46
+ return { entry, rig, hat };
47
+ };
48
+ return {
49
+ scene: { three: { scene: scene3d, nodes, models } },
50
+ local: make('self', 0),
51
+ remote: make('other', 13),
52
+ make,
53
+ };
54
+ }
55
+ const file = 'models/avatar-0.pxmodel';
56
+ const template = buildModelNode(
57
+ parseModel(fs.readFileSync(path.join(KIT, file), 'utf8')),
58
+ {},
59
+ {},
60
+ file,
61
+ [file],
62
+ { optimize: true },
63
+ );
64
+ const f = fixture(template),
65
+ lod = makeFarAvatars();
66
+ const original = f.remote.rig.children.slice();
67
+ lod.update(f.scene, ['self', 'other'], 'self', false, 0);
68
+ assert.equal(lod.size, 0);
69
+ assert.equal(f.remote.rig.visible, true);
70
+ assert.deepEqual(f.remote.rig.children, original);
71
+ lod.update(f.scene, ['self', 'other'], 'self', true, 0);
72
+ assert.equal(lod.size, 1);
73
+ assert.equal(f.local.rig.visible, true);
74
+ assert.equal(f.remote.rig.visible, false);
75
+ const proxy = f.remote.entry.node.getObjectByName('hub-far-avatar');
76
+ assert.ok(proxy);
77
+ assert.equal(f.remote.hat.visible, true);
78
+ assert.equal(proxy.position.y, 0.25);
79
+ assert.equal(proxy.scale.x, 1.5);
80
+ assert.ok(proxy.children.every((m) => m.userData.hubFarAvatarBody && !m.castShadow));
81
+ let bodyVertices = 0,
82
+ proxyVertices = 0;
83
+ template.traverse((o) => {
84
+ if (o.isMesh && !o.userData.lookOutline) bodyVertices += o.geometry.attributes.position.count;
85
+ });
86
+ for (const m of proxy.children) proxyVertices += m.geometry.attributes.position.count;
87
+ assert.equal(proxyVertices, bodyVertices);
88
+ assert.ok(proxy.children.length < 6);
89
+ // Hysteresis, current animation pose retained and no mutation to model data.
90
+ f.remote.rig.rotation.y = 0.8;
91
+ f.remote.entry.node.position.x = 11;
92
+ lod.update(f.scene, ['self', 'other'], 'self', true, 300);
93
+ assert.equal(lod.size, 1);
94
+ f.remote.entry.node.position.x = 9;
95
+ lod.update(f.scene, ['self', 'other'], 'self', true, 600);
96
+ assert.equal(lod.size, 0);
97
+ assert.equal(f.remote.rig.visible, true);
98
+ assert.equal(f.remote.rig.rotation.y, 0.8);
99
+ // Shared proxy geometries survive one user's removal, dispose after last.
100
+ f.remote.entry.node.position.x = 13;
101
+ const second = f.make('second', 14);
102
+ lod.update(f.scene, ['self', 'other', 'second'], 'self', true, 900);
103
+ assert.equal(lod.size, 2);
104
+ const g = f.remote.entry.node.getObjectByName('hub-far-avatar').children[0].geometry;
105
+ assert.equal(g, second.entry.node.getObjectByName('hub-far-avatar').children[0].geometry);
106
+ let disposed = 0;
107
+ g.addEventListener('dispose', () => disposed++);
108
+ f.remote.entry.node.removeFromParent();
109
+ assert.equal(lod.size, 1);
110
+ assert.equal(disposed, 0);
111
+ assert.equal(f.remote.rig.visible, true);
112
+ lod.update(f.scene, ['self', 'second'], 'self', false, 1000);
113
+ assert.equal(lod.size, 0);
114
+ assert.equal(disposed, 1);
115
+ assert.equal(second.rig.visible, true);
116
+ lod.clear();
117
+ assert.equal(disposed, 1);
118
+ // Unsupported textured or transparent materials always keep canonical rig.
119
+ for (const material of [
120
+ new THREE.MeshStandardMaterial({ transparent: true }),
121
+ new THREE.MeshStandardMaterial({ map: new THREE.Texture() }),
122
+ ]) {
123
+ const t = new THREE.Group();
124
+ t.userData.modelParts = new Map();
125
+ t.add(new THREE.Mesh(new THREE.BoxGeometry(), material));
126
+ const unsupported = fixture(t),
127
+ one = makeFarAvatars();
128
+ one.update(unsupported.scene, ['other'], 'self', true, 0);
129
+ assert.equal(one.size, 0);
130
+ assert.equal(unsupported.remote.rig.visible, true);
131
+ }
132
+ // A hidden body group stays hidden in the resting representation.
133
+ {
134
+ const t = new THREE.Group();
135
+ t.userData.modelParts = new Map();
136
+ const hidden = new THREE.Group();
137
+ hidden.visible = false;
138
+ hidden.add(
139
+ new THREE.Mesh(new THREE.BoxGeometry(), new THREE.MeshStandardMaterial({ color: 'red' })),
140
+ );
141
+ t.add(
142
+ hidden,
143
+ new THREE.Mesh(new THREE.BoxGeometry(), new THREE.MeshStandardMaterial({ color: 'blue' })),
144
+ );
145
+ const row = fixture(t),
146
+ one = makeFarAvatars();
147
+ one.update(row.scene, ['other'], 'self', true, 0);
148
+ const body = row.remote.entry.node.getObjectByName('hub-far-avatar');
149
+ assert.equal(body.children.length, 1);
150
+ assert.equal(body.children[0].material.color.getHex(), 0x0000ff);
151
+ one.clear();
152
+ // Custom per-mesh rendering is not compatible with a generic merged mesh.
153
+ t.children[1].onBeforeRender = () => {};
154
+ one.update(row.scene, ['other'], 'self', true, 0);
155
+ assert.equal(one.size, 0);
156
+ assert.equal(row.remote.rig.visible, true);
157
+ }
158
+ // Wait for deferred model baking before copying any vertex attributes.
159
+ {
160
+ const t = new THREE.Group();
161
+ t.userData.modelParts = new Map();
162
+ const outline = new THREE.Mesh(new THREE.BoxGeometry(), new THREE.MeshStandardMaterial());
163
+ outline.userData.lookOutline = true;
164
+ outline.material.visible = false;
165
+ t.add(new THREE.Mesh(new THREE.BoxGeometry(), new THREE.MeshStandardMaterial()), outline);
166
+ const row = fixture(t),
167
+ one = makeFarAvatars();
168
+ one.update(row.scene, ['other'], 'self', true, 0);
169
+ assert.equal(one.size, 0);
170
+ assert.equal(row.remote.rig.visible, true);
171
+ outline.material.visible = true;
172
+ one.update(row.scene, ['other'], 'self', true, 300);
173
+ assert.equal(one.size, 1);
174
+ one.clear();
175
+ }
176
+ // Reflected body transforms retain the canonical rig rather than flipping faces.
177
+ {
178
+ const t = new THREE.Group();
179
+ t.userData.modelParts = new Map();
180
+ const body = new THREE.Mesh(new THREE.BoxGeometry(), new THREE.MeshStandardMaterial());
181
+ body.scale.x = -1;
182
+ t.add(body);
183
+ const row = fixture(t),
184
+ one = makeFarAvatars();
185
+ one.update(row.scene, ['other'], 'self', true, 0);
186
+ assert.equal(one.size, 0);
187
+ assert.equal(row.remote.rig.visible, true);
188
+ }
189
+ // Actual AO-only deferred baking has no hidden outline as a readiness signal.
190
+ {
191
+ const { makeLookBake, stepLookBake } = await import(path.join(engine, 'engine3d/lookbake.js'));
192
+ const { bakingLater } = await import(path.join(engine, 'engine3d/look.js'));
193
+ const queue = makeLookBake();
194
+ const model = parseModel(
195
+ JSON.stringify({
196
+ format: 'pxmodel',
197
+ look: { outline: 0, ao: 0.6 },
198
+ parts: [
199
+ { id: 'body', kind: 'box', size: [1, 1, 1] },
200
+ { id: 'hat', kind: 'box', size: [1, 1, 1], position: [0, 0.5, 0] },
201
+ ],
202
+ }),
203
+ );
204
+ const t = bakingLater(queue, 'ao-only', () =>
205
+ buildModelNode(model, {}, {}, 'ao-only.pxmodel', ['ao-only.pxmodel'], { optimize: true }),
206
+ );
207
+ assert.ok(queue.pending > 0);
208
+ const row = fixture(t),
209
+ one = makeFarAvatars();
210
+ one.update(row.scene, ['other'], 'self', true, 0);
211
+ assert.equal(one.size, 0);
212
+ assert.equal(row.remote.rig.visible, true);
213
+ for (let i = 0; queue.pending && i < 1000; i++) stepLookBake(queue);
214
+ assert.equal(queue.pending, 0);
215
+ one.update(row.scene, ['other'], 'self', true, 300);
216
+ assert.equal(one.size, 1);
217
+ const sourceValues = [],
218
+ mergedValues = [];
219
+ t.traverse((mesh) => {
220
+ if (mesh.isMesh && !mesh.userData.lookOutline)
221
+ sourceValues.push(...(mesh.geometry.attributes.lookOcclusion?.array ?? []));
222
+ });
223
+ row.remote.entry.node.getObjectByName('hub-far-avatar').traverse((mesh) => {
224
+ if (mesh.isMesh) mergedValues.push(...(mesh.geometry.attributes.lookOcclusion?.array ?? []));
225
+ });
226
+ assert.deepEqual(mergedValues.sort(), sourceValues.sort());
227
+ assert.ok(sourceValues.some((value) => value < 1));
228
+ one.clear();
229
+ }
230
+ // All official toon bodies retain body vertices and color/normal attributes.
231
+ for (let i = 0; i < 16; i++) {
232
+ const name = `models/avatar-${i}.pxmodel`,
233
+ source = buildModelNode(
234
+ parseModel(fs.readFileSync(path.join(KIT, name), 'utf8')),
235
+ {},
236
+ {},
237
+ name,
238
+ [name],
239
+ { optimize: true },
240
+ );
241
+ const row = fixture(source),
242
+ one = makeFarAvatars();
243
+ one.update(row.scene, ['other'], 'self', true, 0);
244
+ assert.equal(one.size, 1, name);
245
+ const made = row.remote.entry.node.getObjectByName('hub-far-avatar');
246
+ let before = 0,
247
+ after = 0,
248
+ beforeColors = 0,
249
+ afterColors = 0;
250
+ const looks = new Set();
251
+ source.traverse((o) => {
252
+ if (o.isMesh && !o.userData.lookOutline) {
253
+ before += o.geometry.attributes.position.count;
254
+ beforeColors += o.geometry.attributes.color?.count ?? 0;
255
+ looks.add(lookOf(o.material));
256
+ }
257
+ });
258
+ for (const mesh of made.children) {
259
+ after += mesh.geometry.attributes.position.count;
260
+ afterColors += mesh.geometry.attributes.color?.count ?? 0;
261
+ assert.ok(mesh.geometry.attributes.normal, name);
262
+ assert.ok(looks.has(lookOf(mesh.material)), name);
263
+ }
264
+ const bounds = (root) => {
265
+ root.updateWorldMatrix(true, true);
266
+ const box = new THREE.Box3();
267
+ root.traverse((object) => {
268
+ if (!object.isMesh || object.userData.lookOutline) return;
269
+ const points = object.geometry.attributes.position;
270
+ for (let j = 0; j < points.count; j++)
271
+ box.expandByPoint(
272
+ new THREE.Vector3().fromBufferAttribute(points, j).applyMatrix4(object.matrixWorld),
273
+ );
274
+ });
275
+ return box;
276
+ };
277
+ const expected = bounds(row.remote.rig),
278
+ actual = bounds(made);
279
+ assert.ok(expected.min.distanceTo(actual.min) < 0.00001, name);
280
+ assert.ok(expected.max.distanceTo(actual.max) < 0.00001, name);
281
+ assert.equal(after, before, name);
282
+ assert.equal(afterColors, beforeColors, name);
283
+ one.clear();
284
+ assert.equal(row.remote.rig.visible, true);
285
+ }
286
+ console.log(
287
+ 'hub-game far avatars: default/near/High restore, shared ownership, fallback and16 official bodies passed',
288
+ );
289
+
290
+ // Weakest uses the same merged bodies even when more than twelve are near.
291
+ {
292
+ const model = parseModel(fs.readFileSync(path.join(KIT, file), 'utf8'));
293
+ const source = buildModelNode(model, {}, {}, file, [file], { optimize: true });
294
+ const row = fixture(source);
295
+ const ids = [];
296
+ for (let i = 0; i < 20; i++) {
297
+ const id = 'crowd-' + i;
298
+ row.make(id, 1 + i * 0.1);
299
+ ids.push(id);
300
+ }
301
+ const cap = makeFarAvatars();
302
+ cap.update(row.scene, ids, 'self', true, 0, 12);
303
+ assert.equal(cap.size, 8);
304
+ for (let i = 0; i < 20; i++) {
305
+ const rig = row.scene.three.nodes.get(ids[i]).node.children[0];
306
+ assert.equal(rig.visible, i < 12);
307
+ }
308
+ row.scene.three.nodes.get(ids[19]).node.position.x = 0.1;
309
+ cap.update(row.scene, ids, 'self', true, 250, 12);
310
+ assert.equal(cap.size, 8);
311
+ assert.equal(row.scene.three.nodes.get(ids[19]).node.children[0].visible, true);
312
+ cap.clear();
313
+ for (const id of ids) {
314
+ assert.equal(row.scene.three.nodes.get(id).node.children[0].visible, true);
315
+ }
316
+ }
317
+ console.log('weakest near crowd cap, nearest replacement and exact rig restoration passed');
318
+
319
+ // Weakest queues skip both unused optimizer outlines and AO, including
320
+ // procedural/worn models with no file-level look override. Default is intact.
321
+ {
322
+ const { bakingLater, LOOK_DEFAULTS } = await import(path.join(engine, 'engine3d/look.js'));
323
+ const { makeLookBake } = await import(path.join(engine, 'engine3d/lookbake.js'));
324
+ const before = { ...LOOK_DEFAULTS };
325
+ const queue = makeLookBake();
326
+ queue.skipSurfaceBakes = true;
327
+ const model = parseModel(fs.readFileSync(path.join(KIT, file), 'utf8'));
328
+ const root = bakingLater(queue, file, () =>
329
+ buildModelNode(model, {}, {}, file, [file], { optimize: true }),
330
+ );
331
+ root.traverse((o) => {
332
+ if (!o.isMesh) return;
333
+ assert.equal(Boolean(o.userData.lookOutline), false);
334
+ assert.equal(o.geometry.hasAttribute('lookOcclusion'), false);
335
+ assert.equal(o.geometry.hasAttribute('lookOutlineNormal'), false);
336
+ assert.equal(Object.hasOwn(o.geometry, 'clone'), false);
337
+ });
338
+ assert.deepEqual(LOOK_DEFAULTS, before);
339
+ }
340
+ console.log('weakest bake guard skips optimizer outlines/AO and preserves default look settings');
@@ -0,0 +1,112 @@
1
+ import assert from 'node:assert/strict';
2
+ import { readFileSync } from 'node:fs';
3
+ import { makeFpsTelemetry, fpsTelemetryFor, setFpsTelemetry } from '../code/client/fpsTelemetry.js';
4
+ import { fps } from '../code/server/analytics.js';
5
+ const messages = [], listeners = new Map(), doc = { hidden: false, addEventListener: (k, f) => listeners.set(k, f), removeEventListener: (k) => listeners.delete(k) };
6
+ const target = { addEventListener: doc.addEventListener, removeEventListener: doc.removeEventListener };
7
+ const context = { scene: 'scenes/main.scene', tier: 2, avatars: 4 };
8
+ const telemetry = makeFpsTelemetry({ send: (message) => messages.push(message), document: doc, target });
9
+ for (let n = 0; n < 3600; n++) telemetry.frame(n * 1000 / 60, context);
10
+ assert.equal(messages.length, 0, 'fractional seconds cannot emit early');
11
+ for (let n = 3600; n <= 3700; n++) telemetry.frame(n * 1000 / 60, context);
12
+ assert.equal(messages.length, 1);
13
+ assert.equal(messages[0].median, 600); assert.equal(messages[0].p10, 600);
14
+ assert.equal(messages[0].final, false);
15
+ doc.hidden = true; listeners.get('visibilitychange')();
16
+ telemetry.frame(900000, context);
17
+ doc.hidden = false;
18
+ telemetry.frame(900001, context); telemetry.frame(901001, context);
19
+ listeners.get('pagehide')(); telemetry.dispose();
20
+ assert.equal(messages.length, 2); assert.equal(messages[1].final, true);
21
+ assert.equal(messages[1].median, 10, 'hidden time is excluded');
22
+ assert.equal(listeners.size, 0);
23
+ const calls = [], h = { place: { analytics: true, fpsTelemetry: { scene: context.scene } }, sim: { timeMs: 60000 },
24
+ players: new Map([['p', { arrived: true }]]), session: { hub: { track: (id, event) => { calls.push([id, event]); return true; } } } };
25
+ const session = { players: [{ playerId: 'p' }] }, player = session.players[0];
26
+ assert.equal(fps(h, session, player, messages[0]), true);
27
+ assert.equal(calls[0][1].value, 600 * 4096 + 600);
28
+ assert.equal(fps(h, session, player, messages[0]), false, 'rate limited');
29
+ assert.equal(fps(h, session, player, { ...messages[0], final: true }), true, 'one departure flush');
30
+ assert.equal(fps(h, session, player, { ...messages[0], final: true }), false);
31
+ h.sim.timeMs += 60000;
32
+ for (const override of [{ median: NaN }, { p10: 601 }, { tier: 4 }, { avatars: 256 }, { userId: 'other' }, { scene: 'other' }]) {
33
+ assert.equal(fps(h, session, player, { ...messages[0], ...override }), false);
34
+ }
35
+ assert.equal(fps(h, { players: [] }, player, messages[0]), false);
36
+ h.players.get('p').arrived = false;
37
+ assert.equal(fps(h, session, player, messages[0]), false);
38
+ console.log('FPS windows, hidden time, leave flush, validation and rate limits: passed');
39
+
40
+ const slowMessages = [];
41
+ const slow = makeFpsTelemetry({ send: (message) => slowMessages.push(message), document: null, target: {} });
42
+ for (let n = 0; n <= 30; n++) slow.frame(n * 2000, context);
43
+ assert.equal(slowMessages.length, 1, 'sub-1fps still reports after one foreground minute');
44
+ assert.equal(slowMessages[0].median, 5);
45
+ slow.dispose();
46
+
47
+ // Exercise the real system method across mounted decks sharing the same scene path.
48
+ const source = readFileSync(new URL('../code/systems/hub.js', import.meta.url), 'utf8');
49
+ const method = source.slice(source.indexOf(' measure(scene, mp, now) {'), source.indexOf('\n dispose() {'));
50
+ const Hub = { hub: {}, deck: { fpsTelemetry: { scene: context.scene } } };
51
+ const measure = new Function('Hub', 'makeFpsTelemetry', 'fpsTelemetryFor', `return function ${method.trim()}`)(Hub,
52
+ (options) => makeFpsTelemetry({ ...options, document: null, target: {} }), fpsTelemetryFor);
53
+ const townMessages = [], gameMessages = [];
54
+ const town = { persistent: {}, multiplayer: { net: { send: (message) => townMessages.push(message) } } };
55
+ const game = { content: { sha256: 'destination' }, multiplayer: { net: { send: (message) => gameMessages.push(message) } } };
56
+ const system = { scene: town, scenePath: context.scene, stats: false, tripCount: 0, pendingEnd: null };
57
+ const tripMethod = source.slice(source.indexOf(' startTrip(scene, target, previousTrip = null) {'), source.indexOf('\n setTripCover('));
58
+ const startTrip = new Function('Hub', 'clearShot', 'heapMB', 'LEAVING_MS', `return function ${tripMethod.trim()}`)(Hub, () => {}, () => null, 1000);
59
+ assert.equal(fpsTelemetryFor(town.multiplayer.net), undefined);
60
+ setFpsTelemetry(town.multiplayer.net, { scene: context.scene });
61
+ measure.call(system, town, town.multiplayer, 0);
62
+ measure.call(system, town, town.multiplayer, 1000);
63
+ startTrip.call(system, town, {});
64
+ assert.equal(townMessages.length, 1, 'every actual startTrip flushes the pending town window');
65
+ startTrip.call(system, town, {});
66
+ assert.equal(townMessages.length, 1, 'duplicate startTrip is ignored');
67
+ system.scene = game;
68
+ for (let n = 2; n < 240; n++) measure.call(system, game, game.multiplayer, n * 1000);
69
+ assert.equal(system.fpsTelemetry, null);
70
+ assert.equal(gameMessages.length, 0, 'root opt-in never enables an unconfigured mounted destination');
71
+ system.trip = null;
72
+ setFpsTelemetry(game.multiplayer.net, { scene: context.scene });
73
+ for (let n = 240; n <= 302; n++) measure.call(system, game, game.multiplayer, n * 1000);
74
+ assert.equal(gameMessages.length, 1, 'an opted-in mounted game reports its own minute');
75
+ const gameNet = game.multiplayer.net;
76
+ measure.call(system, game, game.multiplayer, 304000);
77
+ const townCount = townMessages.length;
78
+ measure.call(system, town, town.multiplayer, 305000);
79
+ assert.equal(gameMessages.at(-1).final, true);
80
+ assert.equal(townMessages.length, townCount, 'destination samples never flush into town');
81
+ assert.equal(system.fpsNet, town.multiplayer.net);
82
+ setFpsTelemetry(gameNet, undefined);
83
+ assert.equal(fpsTelemetryFor(gameNet), undefined, 'a keyless snapshot revokes its transport opt-in');
84
+ system.scene = town; system.trip = {};
85
+ measure.call(system, town, town.multiplayer, 250000);
86
+ assert.equal(townMessages.length, 1, 'transition frames are omitted');
87
+ system.trip = null;
88
+ measure.call(system, town, town.multiplayer, 300000);
89
+ measure.call(system, town, town.multiplayer, 301000);
90
+ system.fpsTelemetry.leave();
91
+ assert.equal(townMessages.length, 2);
92
+ assert.equal(townMessages.at(-1).median, 10, 'away interval is not a slow frame');
93
+ system.fpsTelemetry.dispose();
94
+
95
+ // The active system's render tier survives replacement of the shared debug pointer.
96
+ const tierMethod = source.slice(source.indexOf(' deviceTier(scene, mp, now) {'), source.indexOf('\n interestFrame('));
97
+ const deviceTier = new Function('Hub', 'fpsTelemetryFor', `return function ${tierMethod.trim()}`)(Hub, fpsTelemetryFor);
98
+ const previousDebug = globalThis.__hub;
99
+ Hub.deck.tiers = true;
100
+ let observedTier;
101
+ system.fpsNet = town.multiplayer.net;
102
+ system.fpsTelemetry = { frame: (_now, next) => { observedTier = next.tier; } };
103
+ try {
104
+ for (const [current, weakest, code] of [['low', false, 1], ['high', false, 2], ['low', true, 3]]) {
105
+ system.tiers = { frame() {}, current: () => current, weakest: () => weakest, handle: { current } };
106
+ globalThis.__hub = {};
107
+ deviceTier.call(system, town, town.multiplayer, 400000);
108
+ globalThis.__hub = { tier: { current: 'unknown' } };
109
+ measure.call(system, town, town.multiplayer, 400001);
110
+ assert.equal(observedTier, code);
111
+ }
112
+ } finally { globalThis.__hub = previousDebug; }