castle-web-cli 0.4.233 → 0.4.234

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (381) hide show
  1. package/dist/api.d.ts +11 -0
  2. package/dist/api.js +43 -0
  3. package/dist/bundle.d.ts +64 -0
  4. package/dist/bundle.js +558 -2
  5. package/dist/castle-host/host.d.ts +17 -2
  6. package/dist/castle-host/host.js +793 -36
  7. package/dist/castleJson.d.ts +20 -1
  8. package/dist/castleJson.js +44 -2
  9. package/dist/check.js +9 -2
  10. package/dist/chunkLoader.d.ts +3 -0
  11. package/dist/chunkLoader.js +111 -0
  12. package/dist/devParty.d.ts +26 -0
  13. package/dist/devParty.js +231 -0
  14. package/dist/devSaveStorage.js +4 -0
  15. package/dist/devSessionStorage.js +3 -1
  16. package/dist/devSocial.d.ts +24 -0
  17. package/dist/devSocial.js +70 -0
  18. package/dist/ide.d.ts +2 -0
  19. package/dist/ide.js +119 -15
  20. package/dist/index.js +8 -2
  21. package/dist/init.js +1 -1
  22. package/dist/save-deck.d.ts +20 -1
  23. package/dist/save-deck.js +141 -5
  24. package/dist/serve.js +29 -11
  25. package/dist/shell/assets/{index-BjOxR-lW.js → index-DulbYIJm.js} +97 -97
  26. package/dist/shell/index.html +1 -1
  27. package/dist/vitePlugins.d.ts +2 -1
  28. package/dist/vitePlugins.js +13 -0
  29. package/kits/base/castle.json +1 -1
  30. package/kits/base/sdk/README.md +260 -3
  31. package/kits/base/sdk/castle.d.ts +7 -3
  32. package/kits/base/sdk/castle.js +2 -0
  33. package/kits/base/sdk/commands.d.ts +162 -1
  34. package/kits/base/sdk/commands.js +3 -0
  35. package/kits/base/sdk/display.d.ts +3 -0
  36. package/kits/base/sdk/display.js +9 -3
  37. package/kits/base/sdk/hub.d.ts +33 -6
  38. package/kits/base/sdk/hub.js +50 -4
  39. package/kits/base/sdk/multiplayer.d.ts +7 -1
  40. package/kits/base/sdk/multiplayer.js +140 -40
  41. package/kits/base/sdk/multiplayerProtocol.d.ts +2 -0
  42. package/kits/base/sdk/party.d.ts +23 -0
  43. package/kits/base/sdk/party.js +91 -0
  44. package/kits/base/sdk/reconnectBudget.d.ts +23 -0
  45. package/kits/base/sdk/reconnectBudget.js +96 -0
  46. package/kits/base/sdk/save.d.ts +38 -1
  47. package/kits/base/sdk/save.js +79 -6
  48. package/kits/base/sdk/server/hub.d.ts +31 -1
  49. package/kits/base/sdk/server/hub.js +50 -3
  50. package/kits/base/sdk/server/platformHandle.d.ts +13 -1
  51. package/kits/base/sdk/server/storage.d.ts +4 -0
  52. package/kits/base/sdk/server/storage.js +19 -3
  53. package/kits/base/sdk/server/wrapper.d.ts +7 -1
  54. package/kits/base/sdk/server/wrapper.js +10 -1
  55. package/kits/base/sdk/social.d.ts +9 -0
  56. package/kits/base/sdk/social.js +5 -0
  57. package/kits/hub-game/CLAUDE.md +123 -3
  58. package/kits/hub-game/README.md +63 -0
  59. package/kits/hub-game/castle.json +5 -5
  60. package/kits/hub-game/code/client/act.js +312 -0
  61. package/kits/hub-game/code/client/actionLayout.js +147 -0
  62. package/kits/hub-game/code/client/actionOverflow.js +556 -0
  63. package/kits/hub-game/code/client/arrivalCamera.js +50 -0
  64. package/kits/hub-game/code/client/askSlot.js +117 -0
  65. package/kits/hub-game/code/client/avatar.js +4 -2
  66. package/kits/hub-game/code/client/avatarShare.js +2 -0
  67. package/kits/hub-game/code/client/backVisibility.js +13 -0
  68. package/kits/hub-game/code/client/ballot.js +15 -10
  69. package/kits/hub-game/code/client/build.js +16 -0
  70. package/kits/hub-game/code/client/chat.js +41 -5
  71. package/kits/hub-game/code/client/chatModeration.js +5 -0
  72. package/kits/hub-game/code/client/chrome.js +1148 -258
  73. package/kits/hub-game/code/client/crowdNames.js +241 -0
  74. package/kits/hub-game/code/client/decor.js +10 -4
  75. package/kits/hub-game/code/client/defaultEnvironment.js +194 -0
  76. package/kits/hub-game/code/client/doorErrors.js +39 -0
  77. package/kits/hub-game/code/client/fall.js +18 -0
  78. package/kits/hub-game/code/client/farAvatars.js +233 -0
  79. package/kits/hub-game/code/client/firstJoin.js +9 -2
  80. package/kits/hub-game/code/client/fpsTelemetry.js +50 -0
  81. package/kits/hub-game/code/client/frameBatch.js +5 -0
  82. package/kits/hub-game/code/client/grab.js +31 -11
  83. package/kits/hub-game/code/client/hookLayer.js +87 -8
  84. package/kits/hub-game/code/client/hudCopy.js +51 -0
  85. package/kits/hub-game/code/client/hudRate.js +20 -0
  86. package/kits/hub-game/code/client/idle.js +14 -2
  87. package/kits/hub-game/code/client/invites.js +231 -0
  88. package/kits/hub-game/code/client/joinError.js +9 -0
  89. package/kits/hub-game/code/client/labelsNear.js +31 -2
  90. package/kits/hub-game/code/client/landscapeLayout.js +17 -0
  91. package/kits/hub-game/code/client/layoutCache.js +264 -0
  92. package/kits/hub-game/code/client/loadTelemetry.js +20 -0
  93. package/kits/hub-game/code/client/loadingCover.js +148 -0
  94. package/kits/hub-game/code/client/loadingEntry.js +8 -0
  95. package/kits/hub-game/code/client/menuRows.js +43 -0
  96. package/kits/hub-game/code/client/modelReady.js +7 -0
  97. package/kits/hub-game/code/client/padCueArrival.js +23 -0
  98. package/kits/hub-game/code/client/padCues.js +112 -0
  99. package/kits/hub-game/code/client/padOccupancy.js +88 -0
  100. package/kits/hub-game/code/client/padReadability.js +26 -0
  101. package/kits/hub-game/code/client/padRings.js +69 -0
  102. package/kits/hub-game/code/client/pushVisit.js +14 -0
  103. package/kits/hub-game/code/client/quality.js +205 -0
  104. package/kits/hub-game/code/client/qualityEntry.js +55 -0
  105. package/kits/hub-game/code/client/safeLayout.js +338 -0
  106. package/kits/hub-game/code/client/safeStyle.js +42 -0
  107. package/kits/hub-game/code/client/say.js +12 -3
  108. package/kits/hub-game/code/client/shot.js +64 -10
  109. package/kits/hub-game/code/client/shotFit.js +56 -0
  110. package/kits/hub-game/code/client/signIn.js +28 -0
  111. package/kits/hub-game/code/client/state.js +53 -0
  112. package/kits/hub-game/code/client/talk.js +209 -45
  113. package/kits/hub-game/code/client/tiers.js +68 -66
  114. package/kits/hub-game/code/client/together.js +7 -2
  115. package/kits/hub-game/code/client/weakestLookBake.js +92 -0
  116. package/kits/hub-game/code/client/weakestTier.js +295 -0
  117. package/kits/hub-game/code/client/worldLabels.js +241 -0
  118. package/kits/hub-game/code/client/yours.js +10 -9
  119. package/kits/hub-game/code/npcDisplayText.js +55 -0
  120. package/kits/hub-game/code/server/act.js +124 -0
  121. package/kits/hub-game/code/server/actions.js +6 -1
  122. package/kits/hub-game/code/server/actors.js +2 -1
  123. package/kits/hub-game/code/server/analytics.js +83 -0
  124. package/kits/hub-game/code/server/anonymousEntry.js +49 -0
  125. package/kits/hub-game/code/server/arrivalPose.js +36 -0
  126. package/kits/hub-game/code/server/companion.js +28 -3
  127. package/kits/hub-game/code/server/doorAnalytics.js +52 -0
  128. package/kits/hub-game/code/server/earned.js +22 -5
  129. package/kits/hub-game/code/server/frameBatch.js +183 -0
  130. package/kits/hub-game/code/server/friendsAmong.js +49 -9
  131. package/kits/hub-game/code/server/history.js +2 -0
  132. package/kits/hub-game/code/server/hub.js +1306 -95
  133. package/kits/hub-game/code/server/idle.js +30 -1
  134. package/kits/hub-game/code/server/index.js +26 -4
  135. package/kits/hub-game/code/server/invites.js +19 -0
  136. package/kits/hub-game/code/server/labels.js +9 -1
  137. package/kits/hub-game/code/server/loadAbandon.js +106 -0
  138. package/kits/hub-game/code/server/manifest.js +211 -3
  139. package/kits/hub-game/code/server/menu.js +31 -3
  140. package/kits/hub-game/code/server/npcs.js +226 -64
  141. package/kits/hub-game/code/server/observe.js +408 -0
  142. package/kits/hub-game/code/server/padOccupancy.js +85 -0
  143. package/kits/hub-game/code/server/players.js +9 -1
  144. package/kits/hub-game/code/server/resumePose.js +152 -0
  145. package/kits/hub-game/code/server/say.js +1 -1
  146. package/kits/hub-game/code/server/standing.js +4 -5
  147. package/kits/hub-game/code/server/storageLimit.js +187 -0
  148. package/kits/hub-game/code/server/vis.js +67 -5
  149. package/kits/hub-game/code/shared/act.js +35 -0
  150. package/kits/hub-game/code/shared/danceIdle.js +28 -0
  151. package/kits/hub-game/code/shared/loadStages.js +12 -0
  152. package/kits/hub-game/code/shared/quality.js +74 -0
  153. package/kits/hub-game/code/shared/say.js +2 -0
  154. package/kits/hub-game/code/shared/shot.js +35 -1
  155. package/kits/hub-game/code/systems/hub.js +970 -169
  156. package/kits/hub-game/docs/analytics.md +279 -0
  157. package/kits/hub-game/docs/contract.md +1257 -42
  158. package/kits/hub-game/docs/home-pieces.md +9 -2
  159. package/kits/hub-game/docs/observed-progress.md +252 -0
  160. package/kits/hub-game/main.jsx +2 -0
  161. package/kits/hub-game/package-lock.json +10 -3
  162. package/kits/hub-game/package.json +6 -3
  163. package/kits/hub-game/play/player.js +142 -0
  164. package/kits/hub-game/play/registry.js +47 -0
  165. package/kits/hub-game/play.jsx +37 -0
  166. package/kits/hub-game/scripts/check.mjs +39 -5
  167. package/kits/hub-game/scripts/companion-follower-wire.json +1 -1
  168. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +11 -0
  169. package/kits/hub-game/scripts/fixtures/decor-keyless.json +5 -5
  170. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +3 -0
  171. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +19 -3
  172. package/kits/hub-game/scripts/fixtures/interest-legacy.json +3 -3
  173. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -1
  174. package/kits/hub-game/scripts/pose-storage-fixture.mjs +46 -0
  175. package/kits/hub-game/scripts/test-act-client.mjs +186 -0
  176. package/kits/hub-game/scripts/test-act.mjs +171 -0
  177. package/kits/hub-game/scripts/test-action-layout.mjs +80 -0
  178. package/kits/hub-game/scripts/test-action-observers.mjs +46 -0
  179. package/kits/hub-game/scripts/test-actions-client.mjs +367 -2
  180. package/kits/hub-game/scripts/test-actors.mjs +20 -7
  181. package/kits/hub-game/scripts/test-analytics.mjs +76 -0
  182. package/kits/hub-game/scripts/test-anonymous-entry.mjs +28 -0
  183. package/kits/hub-game/scripts/test-arrival-pose-server.mjs +196 -0
  184. package/kits/hub-game/scripts/test-arrival-pose.mjs +24 -0
  185. package/kits/hub-game/scripts/test-ask-slot.mjs +85 -0
  186. package/kits/hub-game/scripts/test-avatar-wire.mjs +49 -10
  187. package/kits/hub-game/scripts/test-avatar.mjs +44 -0
  188. package/kits/hub-game/scripts/test-back-visibility.mjs +82 -0
  189. package/kits/hub-game/scripts/test-ballot.mjs +11 -4
  190. package/kits/hub-game/scripts/test-ban-join.mjs +121 -13
  191. package/kits/hub-game/scripts/test-build.mjs +20 -2
  192. package/kits/hub-game/scripts/test-chat.mjs +206 -5
  193. package/kits/hub-game/scripts/test-companion-chat.mjs +20 -2
  194. package/kits/hub-game/scripts/test-control-layout-dom.mjs +120 -0
  195. package/kits/hub-game/scripts/test-crowd-names.mjs +205 -0
  196. package/kits/hub-game/scripts/test-decor-client.mjs +45 -4
  197. package/kits/hub-game/scripts/test-decor.mjs +7 -0
  198. package/kits/hub-game/scripts/test-default-environment-root.mjs +95 -0
  199. package/kits/hub-game/scripts/test-default-environment.mjs +267 -0
  200. package/kits/hub-game/scripts/test-door-analytics.mjs +58 -0
  201. package/kits/hub-game/scripts/test-door-jump.mjs +100 -0
  202. package/kits/hub-game/scripts/test-earned.mjs +33 -3
  203. package/kits/hub-game/scripts/test-far-avatars.mjs +340 -0
  204. package/kits/hub-game/scripts/test-fps-telemetry.mjs +112 -0
  205. package/kits/hub-game/scripts/test-frame-batch.mjs +252 -0
  206. package/kits/hub-game/scripts/test-fresh-friends.mjs +118 -0
  207. package/kits/hub-game/scripts/test-grab-orbit.mjs +47 -4
  208. package/kits/hub-game/scripts/test-high-only.mjs +170 -0
  209. package/kits/hub-game/scripts/test-hub-ops.mjs +321 -2
  210. package/kits/hub-game/scripts/test-hub-trip.mjs +879 -11
  211. package/kits/hub-game/scripts/test-hud-clear.mjs +162 -59
  212. package/kits/hub-game/scripts/test-hud-defects-dom.mjs +100 -0
  213. package/kits/hub-game/scripts/test-hud-rate.mjs +224 -0
  214. package/kits/hub-game/scripts/test-hud-safe-visibility-dom.mjs +83 -0
  215. package/kits/hub-game/scripts/test-idle.mjs +66 -0
  216. package/kits/hub-game/scripts/test-interest-cells.mjs +20 -0
  217. package/kits/hub-game/scripts/test-interest.mjs +15 -0
  218. package/kits/hub-game/scripts/test-invites-client.mjs +430 -0
  219. package/kits/hub-game/scripts/test-invites.mjs +109 -0
  220. package/kits/hub-game/scripts/test-labels.mjs +71 -3
  221. package/kits/hub-game/scripts/test-landscape-layout.mjs +194 -0
  222. package/kits/hub-game/scripts/test-list-scroll-dom.mjs +49 -0
  223. package/kits/hub-game/scripts/test-load-abandon.mjs +246 -0
  224. package/kits/hub-game/scripts/test-loading-cover.mjs +162 -0
  225. package/kits/hub-game/scripts/test-manifest.mjs +265 -0
  226. package/kits/hub-game/scripts/test-menu-client.mjs +105 -0
  227. package/kits/hub-game/scripts/test-menu.mjs +23 -0
  228. package/kits/hub-game/scripts/test-npcs.mjs +819 -10
  229. package/kits/hub-game/scripts/test-observed.mjs +745 -0
  230. package/kits/hub-game/scripts/test-pad-cues.mjs +304 -0
  231. package/kits/hub-game/scripts/test-pad-occupancy.mjs +177 -0
  232. package/kits/hub-game/scripts/test-picker.mjs +234 -7
  233. package/kits/hub-game/scripts/test-placement-cache.mjs +690 -0
  234. package/kits/hub-game/scripts/test-progress-reset.mjs +559 -0
  235. package/kits/hub-game/scripts/test-push-visit.mjs +26 -0
  236. package/kits/hub-game/scripts/test-quality.mjs +385 -0
  237. package/kits/hub-game/scripts/test-rehello.mjs +699 -5
  238. package/kits/hub-game/scripts/test-resume-action-order.mjs +598 -0
  239. package/kits/hub-game/scripts/test-resume-held.mjs +239 -0
  240. package/kits/hub-game/scripts/test-resume-pose.mjs +142 -0
  241. package/kits/hub-game/scripts/test-safe-events-dom.mjs +116 -0
  242. package/kits/hub-game/scripts/test-safe-layout.mjs +330 -0
  243. package/kits/hub-game/scripts/test-say.mjs +1 -1
  244. package/kits/hub-game/scripts/test-shot.mjs +145 -0
  245. package/kits/hub-game/scripts/test-signin-client.mjs +45 -0
  246. package/kits/hub-game/scripts/test-soundscape.mjs +22 -17
  247. package/kits/hub-game/scripts/test-standing.mjs +35 -2
  248. package/kits/hub-game/scripts/test-storage-limit.mjs +333 -0
  249. package/kits/hub-game/scripts/test-stuck.mjs +5 -4
  250. package/kits/hub-game/scripts/test-talk-overlay-dom.mjs +130 -0
  251. package/kits/hub-game/scripts/test-tiers-render.mjs +86 -13
  252. package/kits/hub-game/scripts/test-tiers.mjs +7 -8
  253. package/kits/hub-game/scripts/test-vis.mjs +433 -6
  254. package/kits/hub-game/scripts/test-weakest-tier.mjs +924 -0
  255. package/kits/hub-game/scripts/test-world-labels.mjs +367 -0
  256. package/kits/hub-game/scripts/test-yours-chrome.mjs +50 -6
  257. package/kits/hub-game/scripts/test-yours.mjs +39 -8
  258. package/kits/multiplayer-3d/castle.json +5 -5
  259. package/kits/multiplayer-3d/code/client/joinFailure.js +27 -0
  260. package/kits/multiplayer-3d/code/client/resumeGate.js +139 -0
  261. package/kits/multiplayer-3d/code/systems/multiplayer.js +369 -30
  262. package/kits/multiplayer-3d/package-lock.json +8 -1
  263. package/kits/multiplayer-3d/package.json +2 -1
  264. package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +436 -0
  265. package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +624 -0
  266. package/kits/physics-2d/CLAUDE.md +10 -1
  267. package/kits/physics-2d/castle.json +2 -2
  268. package/kits/physics-2d/engine/frozenActors.js +233 -0
  269. package/kits/physics-2d/engine/scene.js +87 -5
  270. package/kits/physics-2d/eslint.config.js +1 -1
  271. package/kits/physics-2d/play/behaviors/AnalogStick.js +198 -0
  272. package/kits/physics-2d/play/behaviors/Camera.js +40 -0
  273. package/kits/physics-2d/play/behaviors/Collider.js +122 -0
  274. package/kits/physics-2d/play/behaviors/Draggable.js +115 -0
  275. package/kits/physics-2d/play/behaviors/Goal.js +46 -0
  276. package/kits/physics-2d/play/behaviors/Joints.js +126 -0
  277. package/kits/physics-2d/play/behaviors/Layout.js +71 -0
  278. package/kits/physics-2d/play/behaviors/RigidBody.js +57 -0
  279. package/kits/physics-2d/play/behaviors/Slingshot.js +142 -0
  280. package/kits/physics-2d/play/behaviors/SoundPlayer.js +263 -0
  281. package/kits/physics-2d/play/behaviors/Sprite.js +406 -0
  282. package/kits/physics-2d/play/behaviors/Style.js +209 -0
  283. package/kits/physics-2d/play/behaviors/Text.js +85 -0
  284. package/kits/physics-2d/play/behaviors/Video.js +93 -0
  285. package/kits/physics-3d/CLAUDE.md +25 -1651
  286. package/kits/physics-3d/behaviors/Body.jsx +3 -0
  287. package/kits/physics-3d/behaviors/Model.jsx +3 -0
  288. package/kits/physics-3d/behaviors/Player.jsx +35 -18
  289. package/kits/physics-3d/behaviors/Shape.jsx +3 -0
  290. package/kits/physics-3d/behaviors/Solid.jsx +3 -0
  291. package/kits/physics-3d/behaviors/Transform.jsx +3 -0
  292. package/kits/physics-3d/castle.json +3 -3
  293. package/kits/physics-3d/docs/engine-camera.md +542 -0
  294. package/kits/physics-3d/docs/engine-frame-cap.md +136 -0
  295. package/kits/physics-3d/docs/engine-load.md +149 -0
  296. package/kits/physics-3d/docs/engine-look.md +114 -0
  297. package/kits/physics-3d/docs/engine-shadows.md +372 -0
  298. package/kits/physics-3d/docs/engine-skip-work.md +187 -0
  299. package/kits/physics-3d/docs/engine-sky.md +198 -0
  300. package/kits/physics-3d/docs/engine-static-actors.md +226 -0
  301. package/kits/physics-3d/docs/engine-view.md +37 -0
  302. package/kits/physics-3d/docs/pxmodel-format.md +1 -1
  303. package/kits/physics-3d/engine3d/PlayOnly3D.jsx +5 -1
  304. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +19 -333
  305. package/kits/physics-3d/engine3d/actornode.js +1 -0
  306. package/kits/physics-3d/engine3d/branches.js +3 -13
  307. package/kits/physics-3d/engine3d/cage.js +2 -7
  308. package/kits/physics-3d/engine3d/cageops.js +2 -17
  309. package/kits/physics-3d/engine3d/dataBehaviors.js +12 -0
  310. package/kits/physics-3d/engine3d/framecap.js +4 -1
  311. package/kits/physics-3d/engine3d/frozenphysics.js +140 -0
  312. package/kits/physics-3d/engine3d/frozenstatics.js +273 -0
  313. package/kits/physics-3d/engine3d/gait.js +8 -0
  314. package/kits/physics-3d/engine3d/initialModelFiles.js +18 -0
  315. package/kits/physics-3d/engine3d/look.js +7 -0
  316. package/kits/physics-3d/engine3d/modelFiles.js +3 -17
  317. package/kits/physics-3d/engine3d/modelMath.js +49 -0
  318. package/kits/physics-3d/engine3d/modelready.js +16 -0
  319. package/kits/physics-3d/engine3d/motion.js +3 -3
  320. package/kits/physics-3d/engine3d/nearshadows.js +77 -10
  321. package/kits/physics-3d/engine3d/orbitinput.js +59 -25
  322. package/kits/physics-3d/engine3d/partgeometry.js +1 -16
  323. package/kits/physics-3d/engine3d/paths.js +1 -9
  324. package/kits/physics-3d/engine3d/playTimings.js +50 -0
  325. package/kits/physics-3d/engine3d/playerRun.js +372 -0
  326. package/kits/physics-3d/engine3d/pxmodel.js +3 -3
  327. package/kits/physics-3d/engine3d/rapier.js +27 -0
  328. package/kits/physics-3d/engine3d/scatter.js +1 -11
  329. package/kits/physics-3d/engine3d/shadowfade.js +23 -15
  330. package/kits/physics-3d/engine3d/sky.js +1 -1
  331. package/kits/physics-3d/engine3d/squarefirst.js +177 -0
  332. package/kits/physics-3d/engine3d/stillshadows.js +399 -0
  333. package/kits/physics-3d/engine3d/sweep.js +1 -25
  334. package/kits/physics-3d/engine3d/world3d.js +468 -18
  335. package/kits/physics-3d/eslint.config.js +2 -1
  336. package/kits/physics-3d/main.jsx +6 -3
  337. package/kits/physics-3d/package-lock.json +7 -0
  338. package/kits/physics-3d/package.json +5 -1
  339. package/kits/physics-3d/play/behaviors/Body.js +31 -0
  340. package/kits/physics-3d/play/behaviors/Door.js +37 -0
  341. package/kits/physics-3d/play/behaviors/Lookable.js +16 -0
  342. package/kits/physics-3d/play/behaviors/Model.js +23 -0
  343. package/kits/physics-3d/play/behaviors/Pickup.js +46 -0
  344. package/kits/physics-3d/play/behaviors/Player.js +1204 -0
  345. package/kits/physics-3d/play/behaviors/Shape.js +47 -0
  346. package/kits/physics-3d/play/behaviors/Solid.js +16 -0
  347. package/kits/physics-3d/play/behaviors/Transform.js +29 -0
  348. package/kits/physics-3d/pnpm-lock.yaml +8 -0
  349. package/kits/physics-3d/scripts/bench-shadow-fade.mjs +37 -0
  350. package/kits/physics-3d/scripts/build-rapier-gz.mjs +56 -0
  351. package/kits/physics-3d/scripts/frozen-statics-fixture.mjs +141 -0
  352. package/kits/physics-3d/scripts/test-camera-follow.mjs +5 -1
  353. package/kits/physics-3d/scripts/test-camera-orbit.mjs +52 -4
  354. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +1 -1
  355. package/kits/physics-3d/scripts/test-empty-gait-hints.mjs +89 -0
  356. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +6 -3
  357. package/kits/physics-3d/scripts/test-frame-cap.mjs +1 -1
  358. package/kits/physics-3d/scripts/test-frozen-nested.mjs +49 -0
  359. package/kits/physics-3d/scripts/test-frozen-statics-legacy-physics2d.mjs +123 -0
  360. package/kits/physics-3d/scripts/test-frozen-statics.mjs +434 -0
  361. package/kits/physics-3d/scripts/test-look-bake.mjs +1 -1
  362. package/kits/physics-3d/scripts/test-near-shadows.mjs +2 -2
  363. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +88 -7
  364. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +40 -3
  365. package/kits/physics-3d/scripts/test-orbit-shot.mjs +75 -1
  366. package/kits/physics-3d/scripts/test-rapier-gz.mjs +106 -0
  367. package/kits/physics-3d/scripts/test-sky.mjs +1 -1
  368. package/kits/physics-3d/scripts/test-square-first.mjs +921 -0
  369. package/kits/physics-3d/scripts/test-static-actors.mjs +3 -1
  370. package/kits/physics-3d/scripts/test-static-physics.mjs +4 -1
  371. package/kits/physics-3d/scripts/test-static-scenery.mjs +5 -2
  372. package/kits/physics-3d/scripts/test-steady-hover.mjs +5 -2
  373. package/kits/physics-3d/scripts/test-still-shadows.mjs +477 -0
  374. package/kits/physics-3d/systems/physics3d.js +37 -4
  375. package/kits/real-time/castle.json +2 -2
  376. package/kits/real-time/code/client/connection.js +33 -10
  377. package/kits/real-time/code/client/gameHooks.js +2 -0
  378. package/kits/real-time/code/client/joinOverlay.js +9 -4
  379. package/kits/real-time/code/server/session.js +6 -4
  380. package/kits/real-time/package-lock.json +1 -1
  381. package/package.json +2 -2
@@ -0,0 +1,304 @@
1
+ import assert from 'node:assert/strict';
2
+ import { readFile } from 'node:fs/promises';
3
+ import { register } from 'node:module';
4
+ import * as THREE from 'three';
5
+ import { collectPadCues, makePadCueTracker, padArrivalPoint, padContextText, padCuesEnabled, selectPadCue, validatePadCue } from '../code/client/padCues.js';
6
+ import { makePadRings, ringGeometry, spawnRingOverlaps } from '../code/client/padRings.js';
7
+ import { makePadReadability } from '../code/client/padReadability.js';
8
+ import { fakeDom } from './fixtures/fake-dom.mjs';
9
+
10
+ const actor = (id, components) => ({ id, components });
11
+ const pad = (id, x = 0, extras = {}) => actor(id, { Transform: { x, y: 0.1, z: 0 }, HubPad: { door: 'door', radius: 0.6 }, ...extras });
12
+ const door = actor('door-actor', { HubDoor: { id: 'door', title: 'The Stadium' } });
13
+ const cues = (actors, hidden = new Set()) => collectPadCues(actors, hidden);
14
+ const body = (x, z = 0) => ({ x, z });
15
+ const close = (actual, expected) => assert.ok(Math.abs(actual - expected) < 1e-5, `${actual} ≈ ${expected}`);
16
+
17
+ for (const radius of [undefined, null, NaN, Infinity, -1, 0.29, 6.01, '1']) {
18
+ assert.equal(validatePadCue({ radius, title: 'Quick pad' }), null);
19
+ }
20
+ for (const radius of [0.3, 6]) {assert.deepEqual(validatePadCue({ radius }), { radius });}
21
+ assert.deepEqual(validatePadCue({ radius: 0.6, title: ' Quick pad ', other: 2 }), { radius: 0.6, title: 'Quick pad' });
22
+ assert.equal(validatePadCue({ radius: 1, title: '🌕'.repeat(24) }).title, '🌕'.repeat(24));
23
+ for (const title of ['', ' ', 'x'.repeat(25), 'a\nb', '\tStir ring', 'a\u007fb', 'a\u0085b', 24]) {
24
+ assert.deepEqual(validatePadCue({ radius: 0.6, title }), { radius: 0.6 });
25
+ }
26
+
27
+ const a = pad('a'), b = pad('b', 0.2);
28
+ assert.equal(cues([a, door])[0].title, 'The Stadium', 'HubDoor.id resolves the title, not actor id');
29
+ assert.equal(cues([a])[0].title, undefined);
30
+ assert.equal(cues([a, door], new Set(['a'])).length, 0);
31
+ assert.equal(cues([a, door], new Set(['door-actor']))[0].title, 'The Stadium', 'cue visibility belongs to the pad actor');
32
+ const explicit = pad('station', 1, { HubPadCue: { radius: 1.2, title: 'Fancy pad' } });
33
+ assert.equal(cues([explicit, door])[0].radius, 1.2);
34
+ assert.equal(cues([explicit, door])[0].door, false);
35
+ explicit.components.HubPadCue.title = '\nbad';
36
+ assert.equal(cues([explicit, door])[0].title, undefined, 'invalid explicit title does not fall back to the door');
37
+ explicit.components.HubPadCue.radius = Infinity;
38
+ assert.equal(cues([explicit, door]).length, 0, 'invalid explicit radius excludes a dual-component actor');
39
+
40
+ const pair = cues([b, a, door]);
41
+ let active = selectPadCue(pair, body(0));
42
+ assert.equal(active.cue.id, 'a', 'overlapping footprints tie by stable id');
43
+ assert.equal(active.on, true);
44
+ active = selectPadCue(pair, body(0.2), { cue: pair[0], on: true });
45
+ assert.equal(active.cue.id, 'b', 'a valid standing incumbent survives the id tie');
46
+ active = selectPadCue(cues([a]), body(2.1));
47
+ assert.equal(active.on, false);
48
+ assert.equal(selectPadCue(cues([a]), body(2.101)), null, 'new near cue must be within 1.5 m of edge');
49
+ assert.equal(selectPadCue(cues([a]), body(2.59), active).cue.id, 'a');
50
+ assert.equal(selectPadCue(cues([a]), body(2.601), active), null);
51
+ assert.equal(selectPadCue(cues([a], new Set(['a'])), body(0), active), null);
52
+ assert.equal(selectPadCue(pair, body(2)).cue.id, 'b', 'nearest edge wins');
53
+ assert.equal(selectPadCue(cues([pad('b', 1), pad('a', -1)]), body(0)).cue.id, 'a', 'equal edge distances tie by id');
54
+ assert.equal(selectPadCue(cues([a, pad('inside', 2.4)]), body(2.4), active).cue.id, 'inside', 'standing beats a retained near cue');
55
+ assert.equal(selectPadCue(pair, null), null);
56
+
57
+ const tracked = new Map([[a.id, a], [door.id, door]]), hidden = new Set();
58
+ const tracker = makePadCueTracker();
59
+ const first = tracker.frame(tracked, hidden, body(0));
60
+ assert.equal(tracker.frame(tracked, hidden, body(0.04)), first, 'under 5 cm returns the same allocation');
61
+ assert.notEqual(tracker.frame(tracked, hidden, body(0.051)), first, 'over 5 cm reselects');
62
+ door.components.HubDoor.title = 'New title';
63
+ assert.equal(tracker.frame(tracked, hidden, body(0.051)).cue.title, 'New title', 'in-place cue text edits invalidate');
64
+ hidden.add('a');
65
+ assert.equal(tracker.frame(tracked, hidden, body(0.051)), null, 'in-place private hide revokes immediately');
66
+ hidden.clear();
67
+ assert.ok(tracker.frame(tracked, hidden, body(0.051)));
68
+ tracked.delete('a');
69
+ assert.equal(tracker.frame(tracked, hidden, body(0.051)), null, 'actor removal revokes');
70
+ const invalid = pad('invalid', 0, { HubPadCue: { radius: NaN } });
71
+ const invalidTracker = makePadCueTracker(), withInvalid = new Map([['a', a], ['invalid', invalid]]);
72
+ const cached = invalidTracker.frame(withInvalid, hidden, body(0));
73
+ assert.equal(invalidTracker.frame(withInvalid, hidden, body(0)), cached, 'invalid NaN fields do not force frame allocations/reselection');
74
+ assert.equal(invalidTracker.frame(withInvalid, hidden, body(NaN)), null, 'an unavailable local body clears selection');
75
+ assert.ok(invalidTracker.frame(withInvalid, hidden, body(0)), 'selection recovers after an unavailable local body');
76
+
77
+ const named = cues([pad('caption'), door])[0];
78
+ assert.deepEqual(padContextText({ cue: named, on: false }), { id: 'caption', title: 'New title', secondary: 'Step on to join' });
79
+ assert.equal(padContextText({ cue: named, on: true }).secondary, '');
80
+ assert.equal(padContextText({ cue: { ...named, door: false }, on: false }).secondary, '');
81
+ assert.equal(padContextText({ cue: { ...named, title: undefined }, on: true }), null);
82
+ assert.equal(padContextText(null), null);
83
+
84
+ // Actual enable gate: even accessing options would create client resources.
85
+ const forbidden = new Proxy({}, { get() {throw new Error('disabled path touched a resource');} });
86
+ for (const engine of [undefined, {}, { hubPadContext: false, hubPadRing: false, hubSpawnRing: false }, { hubPadRing: 1 }]) {
87
+ assert.equal(padCuesEnabled(engine), false);
88
+ assert.equal(makePadReadability(engine, forbidden), null);
89
+ }
90
+
91
+ function radii(geometry) {
92
+ const p = geometry.attributes.position, out = [];
93
+ for (let i = 0; i < p.count; i += 1) {close(p.getY(i), 0); out.push(Math.hypot(p.getX(i), p.getZ(i)));}
94
+ return [Math.min(...out), Math.max(...out)];
95
+ }
96
+ const geometry = ringGeometry(0.65, 0.12);
97
+ radii(geometry).forEach((r, i) => close(r, [0.65, 0.77][i]));
98
+ assert.equal(geometry.attributes.position.count, 64 * 6);
99
+ geometry.dispose();
100
+ const segmented = ringGeometry(1.2, 0.12, 8);
101
+ assert.equal(segmented.attributes.position.count, 8 * 8 * 6);
102
+ assert.equal(segmented.groups.length, 0, 'segments share a single draw call');
103
+ for (let i = 0; i < 8; i += 1) {
104
+ const p = segmented.attributes.position;
105
+ const index = i * 8 * 6;
106
+ close(Math.atan2(p.getZ(index), p.getX(index)), Math.atan2(Math.sin(i * Math.PI / 4), Math.cos(i * Math.PI / 4)));
107
+ const last = index + 8 * 6 - 1;
108
+ const expected = i * Math.PI / 4 + Math.PI / 4 * 0.75;
109
+ close(p.getX(last), Math.cos(expected) * 1.32);
110
+ close(p.getZ(last), Math.sin(expected) * 1.32);
111
+ }
112
+ segmented.dispose();
113
+
114
+ const raised = cues([pad('raised', 0, { Shape: { kind: 'cylinder', height: 0.2, color: '#123456' } })])[0];
115
+ close(raised.y, 0.23);
116
+ close(named.y, 0.13);
117
+ assert.equal(named.color, '#d9a441');
118
+ assert.equal(raised.color, '#123456');
119
+ const world = new THREE.Scene();
120
+ const rings = makePadRings(world, { active: true, arrival: null });
121
+ assert.equal(world.children.length, 0, 'B creates its mesh lazily');
122
+ rings.frame(raised);
123
+ assert.equal(world.children.length, 1);
124
+ const mesh = world.children[0], buffer = mesh.geometry.attributes.position;
125
+ assert.equal(mesh.material.type, 'MeshBasicMaterial');
126
+ assert.equal(mesh.material.transparent, false);
127
+ assert.equal(mesh.material.opacity, 1);
128
+ assert.equal(mesh.castShadow, false);
129
+ assert.equal(mesh.receiveShadow, false);
130
+ assert.equal(mesh.material.color.getHexString(), '123456');
131
+ close(mesh.position.y, 0.23);
132
+ rings.frame({ ...named, radius: 3, x: 4 });
133
+ assert.equal(world.children[0], mesh);
134
+ assert.equal(mesh.geometry.attributes.position, buffer, 'radius changes reuse the position buffer');
135
+ radii(mesh.geometry).forEach((r, i) => close(r, [3.05, 3.17][i]));
136
+ assert.equal(mesh.material.color.getHexString(), 'd9a441');
137
+ assert.equal(mesh.position.x, 4);
138
+ rings.frame(null);
139
+ assert.equal(mesh.visible, false);
140
+ rings.frame(raised);
141
+ assert.equal(world.children.length, 1);
142
+ let disposed = 0;
143
+ mesh.geometry.addEventListener('dispose', () => disposed++);
144
+ mesh.material.addEventListener('dispose', () => disposed++);
145
+ rings.dispose();
146
+ assert.equal(disposed, 2);
147
+ assert.equal(world.children.length, 0);
148
+
149
+ const arrival = { x: 0, y: 0, z: 0 };
150
+ assert.equal(spawnRingOverlaps({ x: 1.8, z: 0, radius: 0.6 }, arrival), true);
151
+ assert.equal(spawnRingOverlaps({ x: 1.801, z: 0, radius: 0.6 }, arrival), false);
152
+ const both = makePadRings(world, { active: true, arrival });
153
+ assert.equal(world.children.length, 1);
154
+ const spawn = world.children[0];
155
+ assert.equal(spawn.material.color.getHexString(), '7fc9b8');
156
+ close(spawn.position.y, 0.03);
157
+ both.frame(raised);
158
+ assert.equal(world.children.length, 1, 'overlap never creates a second mesh unnecessarily');
159
+ both.frame({ ...raised, x: 5 });
160
+ assert.equal(world.children.length, 2);
161
+ both.frame(raised);
162
+ assert.equal(world.children[1].visible, false);
163
+ assert.equal(spawn.visible, true);
164
+ both.dispose();
165
+
166
+ // Each marker alone creates only its own affordance, on every graphics tier.
167
+ const noChrome = new Proxy({}, { get() {throw new Error('ring marker touched chrome');} });
168
+ const justSpawn = makePadReadability({ hubSpawnRing: true }, { world, arrival, chrome: noChrome });
169
+ justSpawn.frame(forbidden, forbidden, null, false);
170
+ assert.equal(world.children.length, 1);
171
+ justSpawn.dispose();
172
+ const justActive = makePadReadability({ hubPadRing: true }, { world, chrome: noChrome });
173
+ justActive.frame(tracked, hidden, body(0), false);
174
+ assert.equal(world.children.length, 0, 'ring marker has no locator and no active pad');
175
+ justActive.frame(new Map([['a', a]]), hidden, body(0), false);
176
+ assert.equal(world.children.length, 1);
177
+ justActive.dispose();
178
+
179
+ const spawnActor = actor('player', { Player: {}, Shape: {}, Transform: { x: 5, y: 1, z: 9 } });
180
+ const arrivalActor = actor('arrival', { Transform: { x: 2, y: 0, z: 3 } });
181
+ assert.deepEqual(padArrivalPoint([spawnActor, arrivalActor], { actor: 'arrival' }), { x: 2, y: 0, z: 3 });
182
+ assert.deepEqual(padArrivalPoint([spawnActor], null), { x: 5, y: 1, z: 9 });
183
+ assert.deepEqual(padArrivalPoint([spawnActor], { actor: 'missing' }), { x: 5, y: 1, z: 9 });
184
+ assert.deepEqual(padArrivalPoint([], null), { x: 0, y: 1, z: 0 });
185
+
186
+ // Resolve the browser-only blueprint boundary as existing client tests do.
187
+ register(`data:text/javascript,${encodeURIComponent(`
188
+ export async function resolve(specifier, context, next) {
189
+ if (specifier === '@imports/castle.physics-2d/engine/blueprint') return {
190
+ url: 'data:text/javascript,' + encodeURIComponent('export const mergeComponents = (a,b) => Object.fromEntries([...new Set([...Object.keys(a??{}),...Object.keys(b??{})])].map(k=>[k,{...a?.[k],...b?.[k]}])); export const getBlueprintTemplate = (files,ref) => ({components:JSON.parse(files[ref]).actors[0].components});'), shortCircuit: true };
191
+ return next(specifier, context);
192
+ }
193
+ `)}`);
194
+ const { readPadArrival } = await import('../code/client/padCueArrival.js');
195
+ const scene = { currentScenePath: 'scenes/main.scene', files: { 'scenes/main.scene': JSON.stringify({ actors: [spawnActor, arrivalActor] }) }, data: { actors: [pad('moving-player', 99)] } };
196
+ assert.deepEqual(readPadArrival(scene, { id: 'main' }, { actor: 'arrival' }), { x: 2, y: 0, z: 3 }, 'local manifest uses authored arrival, never moving runtime transforms');
197
+ scene.content = { places: { main: { arrival: { actor: 'player' } } } };
198
+ assert.deepEqual(readPadArrival(scene, { id: 'main' }, { actor: 'arrival' }), { x: 5, y: 1, z: 9 }, 'mounted manifest overrides root manifest');
199
+ scene.files['scenes/main.scene'] = JSON.stringify({ actors: [{ id: 'blue', blueprint: 'blueprints/spawn.scene', components: { Transform: { x: 7 } } }] });
200
+ scene.files['blueprints/spawn.scene'] = JSON.stringify({ actors: [{ components: spawnActor.components }] });
201
+ assert.deepEqual(readPadArrival(scene, { id: 'main' }, { actor: 'arrival' }), { x: 7, y: 1, z: 9 }, 'blueprint Player spawn resolves authored overrides');
202
+ assert.equal(readPadArrival({ ...scene, files: {} }, { id: 'main' }), null, 'missing authored data never invents a locator from runtime positions');
203
+ for (const bad of ['{', '{"actors":{}}', 'null', '{"actors":[null,7]}']) {
204
+ assert.doesNotThrow(() => readPadArrival({ ...scene, files: { 'scenes/main.scene': bad } }, { id: 'main' }, { actor: 'arrival' }), `malformed source ${bad} stays out of the frame loop`);
205
+ }
206
+ assert.equal(readPadArrival({ ...scene, files: { 'scenes/main.scene': '{' } }, { id: 'main' }), null, 'malformed source omits the locator');
207
+
208
+ const dom = fakeDom({ viewW: 844, viewH: 390 });
209
+ const { makeChrome } = await import('../code/client/chrome.js');
210
+ const chrome = makeChrome({ onBack() {throw new Error('caption dispatched Back');}, onAvatar() {throw new Error('caption dispatched avatar');}, avatarCount: 4 });
211
+ assert.equal(dom.made.some((n) => n.dataset.hub === 'pad-context'), false);
212
+ chrome.setPadContext(null);
213
+ assert.equal(dom.made.some((n) => n.dataset.hub === 'pad-context'), false);
214
+ const text = { id: 'a', title: 'Fancy pad', secondary: '' };
215
+ chrome.setPadContext(text);
216
+ const caption = dom.made.find((n) => n.dataset.hub === 'pad-context');
217
+ assert.ok(caption);
218
+ assert.equal(caption.tag, 'div');
219
+ assert.equal(caption.style.pointerEvents, 'none');
220
+ assert.equal(caption.attrs.tabindex, undefined);
221
+ assert.equal(caption.attrs['aria-label'], 'Fancy pad');
222
+ assert.equal(caption.attrs.title, 'Fancy pad');
223
+ assert.equal(caption.children[0].style.fontSize, '16px');
224
+ assert.equal(caption.children[0].style.webkitLineClamp, '2');
225
+ assert.equal(caption.children[0].style.textOverflow, 'ellipsis');
226
+ assert.equal(caption.children[1].style.fontSize, '13px');
227
+ assert.equal(caption.children[1].style.display, 'none');
228
+ assert.ok([caption, ...caption.children].every((n) => n.tag !== 'button' && Object.keys(n.handlers).length === 0), 'caption creates no buttons, listeners or dispatch path');
229
+ const before = dom.log.length;
230
+ chrome.setPadContext(text);
231
+ assert.ok(dom.log.slice(before).every((line) => !line.includes(' text=') && !line.includes(' style.')), 'identical caption/layout performs no DOM writes');
232
+ chrome.beginLayoutFrame?.();
233
+ assert.doesNotThrow(() => chrome.setPadContext({ ...text, id: 'layout-frame' }), 'caption reads safe insets inside an active layout frame');
234
+ chrome.endLayoutFrame?.();
235
+ chrome.setPadContext(text);
236
+ chrome.setPadContext({ ...text, secondary: 'Step on to join' });
237
+ assert.equal(caption.children[1].textContent, 'Step on to join');
238
+ assert.equal(caption.children[1].style.display, 'block');
239
+ caption.size = { w: 180, h: 70 };
240
+ const obstacle = document.createElement('div');
241
+ obstacle.rect = { left: 0, right: 844, top: 0, bottom: 390 };
242
+ chrome.safeSurface('full-screen-hud', obstacle, 'text');
243
+ chrome.setPadContext(text);
244
+ assert.equal(caption.style.visibility, 'hidden', 'no slot suppresses the caption');
245
+ chrome.safeSurface('full-screen-hud', null);
246
+ chrome.setPadContext(text);
247
+ assert.equal(caption.style.visibility, '');
248
+ const panel = document.createElement('div');
249
+ panel.rect = { left: 0, right: 100, top: 0, bottom: 100 };
250
+ chrome.safeSurface('invite-dialog', panel, 'card');
251
+ chrome.setPadContext(text);
252
+ assert.equal(caption.style.visibility, 'hidden', 'any registered open panel hides the caption');
253
+ chrome.safeSurface('invite-dialog', null);
254
+ // Exact phone viewports use the shared final-rectangle placement, including
255
+ // action rails, joystick space, HUD and both host-reserved corners.
256
+ const overlaps = (a, b) => a.left < b.right && a.right > b.left && a.top < b.bottom && a.bottom > b.top;
257
+ const rail = document.createElement('div');
258
+ for (const [w, h] of [[844, 390], [352, 526], [509, 218]]) {
259
+ window.innerWidth = w; window.innerHeight = h;
260
+ rail.rect = { left: w - 110, right: w - 8, top: h - 100, bottom: h - 8 };
261
+ chrome.safeSurface('test-action-rail', rail, 'control');
262
+ chrome.setPadContext(text);
263
+ assert.equal(caption.style.visibility, '', `${w}x${h} has a clear caption slot`);
264
+ const left = parseFloat(caption.style.left), top = parseFloat(caption.style.top);
265
+ const rect = { left, right: left + 180, top, bottom: top + 70 };
266
+ assert.ok(rect.left >= 8 && rect.right <= w - 8 && rect.top >= 8 && rect.bottom <= h - 8);
267
+ const corners = [{ left: 0, right: 64, top: 0, bottom: 56 }, { left: w - 64, right: w, top: 0, bottom: 56 }];
268
+ const joystick = w > h ? { left: 0, right: w / 2, top: h / 2, bottom: h } : { left: 0, right: 112, top: h - 112, bottom: h };
269
+ assert.ok([...corners, joystick, rail.rect].every((obstacle) => !overlaps(rect, obstacle)));
270
+ }
271
+ chrome.safeSurface('test-action-rail', null);
272
+ // The caption runs after the stuck chip in a frame, so a chip shown this
273
+ // frame is already a final rect the caption keeps clear of.
274
+ {
275
+ window.innerWidth = 844; window.innerHeight = 390;
276
+ chrome.setPadContext(text);
277
+ const left = parseFloat(caption.style.left), top = parseFloat(caption.style.top);
278
+ chrome.stuckPrompt('Stuck? Tap to go back to the start', () => {});
279
+ const chip = dom.made.find((n) => n.dataset?.hub === 'stuck');
280
+ assert.ok(chip, 'the stuck chip exists');
281
+ chip.rect = { left: left + 20, right: left + 80, top: top + 10, bottom: top + 40 };
282
+ chrome.setPadContext(text);
283
+ const l2 = parseFloat(caption.style.left), t2 = parseFloat(caption.style.top);
284
+ const placed = { left: l2, right: l2 + 180, top: t2, bottom: t2 + 70 };
285
+ assert.ok(caption.style.visibility === 'hidden' || !overlaps(placed, chip.rect), 'a shown stuck chip is never under the caption');
286
+ chrome.stuckPrompt(null);
287
+ }
288
+ const runtime = makePadReadability({ hubPadContext: true }, { world, chrome });
289
+ runtime.frame(new Map([['a', a], ['door', door]]), new Set(), body(0), false);
290
+ assert.equal(caption.style.visibility, '');
291
+ runtime.frame(new Map([['a', a], ['door', door]]), new Set(), body(0), false, true);
292
+ assert.equal(caption.style.visibility, 'hidden', 'decorating and other system-owned sheets hide captions');
293
+ runtime.frame(new Map([['a', a]]), new Set(), body(0), true);
294
+ assert.equal(caption.style.visibility, 'hidden', 'travel hides the caption');
295
+ runtime.dispose();
296
+ assert.equal(caption.parent.children.includes(caption), false);
297
+ chrome.dispose();
298
+
299
+ const source = await readFile(new URL('../code/systems/hub.js', import.meta.url), 'utf8');
300
+ assert.match(source, /if \(padCuesEnabled\(scene\.data\?\.engine\) \|\| this\.padReadability\)/, 'production frame respects the same enable gate');
301
+ assert.match(source, /enterScene\(scene\) \{\s*this\.clearPadReadability\(\)/);
302
+ assert.match(source, /reset\(scene\) \{\s*this\.clearPadReadability\(\)/);
303
+ assert.match(source, /dispose\(\) \{\s*this\.clearPadReadability\(\)/);
304
+ console.log('pad cues: validation, selection/cache/privacy, disabled gate, captions, merged/reused rings and authored arrival passed');
@@ -0,0 +1,177 @@
1
+ import assert from 'node:assert/strict';
2
+ import { addOccupancy, makePadOccupancy, occupancyLine, selectedPad } from '../code/server/padOccupancy.js';
3
+ import { bodyBox, clearBox, occupancyText, placeLabels } from '../code/client/padOccupancy.js';
4
+ import { fakeDom } from './fixtures/fake-dom.mjs';
5
+
6
+ const pad = { id: 'pad', components: { HubPad: { door: 'door' }, Transform: { x: 0, z: 0 } } };
7
+ function fixture(n) {
8
+ const ids = ['self', ...Array.from({ length: n }, (_, i) => `p${i}`)];
9
+ const h = {
10
+ sim: { timeMs: 1000, players: new Map(ids.map((id) => [id, { at: { x: 0, z: 0 } }])) },
11
+ session: { players: ids.map((playerId) => ({ playerId })) },
12
+ hidden: new Set(), labels: new Map([['pad', { text: 'Station', style: 'tag' }]]),
13
+ padDoors: new Map([['door', new Set(ids)]]), padOccupancy: makePadOccupancy([pad]),
14
+ };
15
+ h.padOccupancy.reportedAt.set('door', 1000);
16
+ h.padOccupancy.knownAt = 1000;
17
+ h.padOccupancy.known = new Map([['self', new Set(ids.slice(1))]]);
18
+ return h;
19
+ }
20
+ for (const n of [0, 3, 11]) {
21
+ const h = fixture(n);
22
+ assert.equal(occupancyLine(h, pad, 'self'), `you + ${n} more`);
23
+ h.padDoors.get('door').delete('self');
24
+ assert.equal(occupancyLine(h, pad, 'self'), `${n} here`, 'departure excludes self immediately');
25
+ }
26
+ {
27
+ const h = fixture(3);
28
+ const blocked = new Set(['p0']);
29
+ assert.equal(occupancyLine(h, pad, 'self', blocked), 'you + 2 more');
30
+ h.hidden.add('p1');
31
+ assert.equal(occupancyLine(h, pad, 'self', blocked), 'you + 1 more');
32
+ h.padOccupancy.known.get('self').delete('p2');
33
+ assert.equal(occupancyLine(h, pad, 'self', blocked), 'you + 0 more', 'undisclosed occupants never contribute');
34
+ h.padOccupancy.known.get('self').add('p2');
35
+ h.session.players = h.session.players.filter((p) => p.playerId !== 'p2');
36
+ assert.equal(occupancyLine(h, pad, 'self', blocked), 'you + 0 more', 'disconnected body retention never contributes');
37
+ h.sim.timeMs = 1501;
38
+ assert.equal(occupancyLine(h, pad, 'self', blocked), 'occupancy unavailable');
39
+ h.sim.timeMs = 1000;
40
+ h.padOccupancy.known = null;
41
+ assert.equal(occupancyLine(h, pad, 'self', blocked), 'occupancy unavailable');
42
+ h.padOccupancy.known = new Map([['self', new Set(['p0'])]]);
43
+ h.padOccupancy.ambiguous.add('door');
44
+ assert.equal(occupancyLine(h, pad, 'self', blocked), 'occupancy unavailable', 'a door-level set cannot disambiguate two pads');
45
+ }
46
+ {
47
+ const h = fixture(3);
48
+ const out = {};
49
+ addOccupancy(h, 'self', out);
50
+ assert.deepEqual(out, { pad: { text: 'Station\nyou + 3 more', style: 'tag' } });
51
+ assert.equal(h.labels.get('pad').text, 'Station', 'shared label is unchanged');
52
+ const redacted = {};
53
+ addOccupancy(h, 'self', redacted, new Set(['p0']), () => ({ text: 'redacted station', style: 'tag' }));
54
+ assert.equal(redacted.pad.text, 'redacted station\nyou + 2 more');
55
+ const refused = {};
56
+ addOccupancy(h, 'self', refused, new Set(['p0']), () => null);
57
+ assert.deepEqual(refused, {}, 'a hidden label is never reconstructed from the raw shared text');
58
+ const privateOverride = { pad: { text: 'Your personal record', style: 'tag' } };
59
+ addOccupancy(h, 'self', privateOverride);
60
+ assert.equal(privateOverride.pad.text, 'Your personal record\nyou + 3 more');
61
+ const goal = { pad: { text: 'Your quest', style: 'goal' } };
62
+ addOccupancy(h, 'self', goal);
63
+ assert.equal(goal.pad.text, 'Your quest');
64
+ h.labels.set('pad', { text: 'x'.repeat(64), style: 'tag' });
65
+ const long = {};
66
+ addOccupancy(h, 'self', long);
67
+ assert.equal(long.pad.text, 'you + 3 more', 'occupancy wins over an unfit decorative duplicate');
68
+ }
69
+ {
70
+ const h = fixture(0);
71
+ const other = { id: 'other', components: { HubPad: { door: 'second' }, Transform: { x: 0.1, z: 0 } } };
72
+ h.padOccupancy.pads.push(other);
73
+ h.labels.set('other', { text: 'Second', style: 'tag' });
74
+ h.padDoors.set('second', new Set(['self']));
75
+ h.padOccupancy.reportedAt.set('second', 1000);
76
+ assert.equal(selectedPad(h, 'self').id, 'pad');
77
+ h.sim.players.get('self').at.x = 0.1;
78
+ assert.equal(selectedPad(h, 'self').id, 'pad', 'overlap retains a valid identity');
79
+ h.padDoors.get('door').delete('self');
80
+ assert.equal(selectedPad(h, 'self').id, 'other', 'membership on another pad wins');
81
+ h.visMe = new Map([['self', new Map([['other', true]])]]);
82
+ assert.equal(selectedPad(h, 'self').id, 'pad', 'private pad hide revokes selection immediately');
83
+ h.sim.players.get('self').at.x = 8;
84
+ assert.equal(selectedPad(h, 'self'), null);
85
+ }
86
+
87
+ const touching = (a, b) => a.left < b.right && b.left < a.right && a.top < b.bottom && b.top < a.bottom;
88
+ const measure = (text) => ({ w: Math.max(...text.split('\n').map((s) => s.length)) * 7 + 20, h: text.split('\n').length * 18 + 8 });
89
+ for (const [w, h] of [[844, 390], [352, 526], [509, 218]]) {
90
+ const own = { left: w / 2 - 45, right: w / 2 + 45, top: 76, bottom: h - 68 };
91
+ const controls = [{ left: 0, right: w, top: 0, bottom: 56 }, { left: 0, right: w, top: h - 56, bottom: h }];
92
+ const text = 'The Stadium\nyou + 3 more';
93
+ const size = measure(text);
94
+ const item = { id: 'pad', padOccupancy: true, text, x: w / 2, y: h / 2, box: { left: w / 2 - size.w / 2, right: w / 2 + size.w / 2, top: h / 2 - size.h, bottom: h / 2 } };
95
+ const out = placeLabels([item], own, controls, { w, h }, measure);
96
+ assert.equal(out.length, 1, `${w}x${h} has a clear pad label`);
97
+ for (const obstacle of [...controls, own]) {assert.equal(touching(out[0].box, obstacle), false);}
98
+ assert.equal(out[0].x, (out[0].box.left + out[0].box.right) / 2);
99
+ assert.equal(out[0].y, out[0].box.bottom);
100
+ const stale = placeLabels([item], own, controls, { w, h }, measure, true);
101
+ assert.ok(stale.every((i) => !/\d+ (more|here)/.test(i.text)), 'stale client never draws a number');
102
+ assert.deepEqual(placeLabels([item], own, [{ left: 0, right: w, top: 0, bottom: h }], { w, h }, measure), [], 'no room suppresses text');
103
+ }
104
+ assert.equal(occupancyText('You + 3 more needed'), null);
105
+ {
106
+ const own = { left: 90, right: 130, top: 60, bottom: 110 };
107
+ const obstacles = [own, { left: 0, right: 85, top: 50, bottom: 110 }, { left: 135, right: 240, top: 50, bottom: 110 }, { left: 75, right: 145, top: 0, bottom: 55 }, { left: 0, right: 240, top: 115, bottom: 150 }];
108
+ const placed = clearBox({ left: 80, right: 140, top: 65, bottom: 85 }, obstacles, { w: 240, h: 150 }, own);
109
+ assert.ok(placed, 'a free corner is used when every cardinal direction is blocked');
110
+ assert.ok(obstacles.every((o) => !touching(placed, o)));
111
+ }
112
+ assert.equal(occupancyText('Station\nyou + 11 more'), 'you + 11 more');
113
+ const body = bodyBox({ x: 0, y: 0, z: 0 }, 2, 0.7, (x, y) => ({ x: 100 + x * 10, y: 100 - y * 10 }));
114
+ assert.deepEqual(body, { left: 85, right: 115, top: 72, bottom: 108 });
115
+ const lowered = bodyBox({ x: 0, y: 0.7, z: 0 }, 2, 0.7, (x, y) => ({ x: 100 + x * 10, y: 100 - y * 10 }), -0.7);
116
+ assert.deepEqual(lowered, body, 'drawn rig offset includes feet below the collider centre');
117
+ assert.equal(bodyBox({ x: 0, y: 0, z: 0 }, 2, 0.7, () => null).right, Infinity);
118
+ const dom = fakeDom({ viewW: 844, viewH: 390 });
119
+ const { makeChrome } = await import('../code/client/chrome.js');
120
+ const chrome = makeChrome({ onBack() {}, onAvatar() {}, avatarCount: 4 });
121
+ assert.ok(Array.isArray(chrome.padOccupancyControls()), 'actual chrome control pass is callable');
122
+ chrome.setCabinet({ id: 'cabinet', rev: 1, x: 200, y: 125, opacity: 1, card: { title: 'Cabinet', top: [{ username: 'QA', score: 42 }] } }, () => null);
123
+ const cabinet = dom.made.find((node) => node.attrs['aria-label'] === 'Cabinet: show the scores');
124
+ assert.ok(cabinet);
125
+ cabinet.rect = { left: 120, right: 280, top: 60, bottom: 125 };
126
+ const rail = document.createElement('div');
127
+ rail.dataset.hub = 'action-rail';
128
+ rail.rect = { left: 400, right: 500, top: 240, bottom: 284 };
129
+ cabinet.parent.appendChild(rail);
130
+ const controls = chrome.padOccupancyControls();
131
+ assert.ok(controls.some((rect) => rect.left === 400 && rect.right === 500), 'final action overflow rail is reserved');
132
+ assert.ok(controls.some((rect) => rect.left === 120 && rect.right === 280 && rect.top === 60 && rect.bottom === 125), 'rendered cabinet card is reserved');
133
+ const beside = placeLabels([{ id: 'pad', padOccupancy: true, text: 'you + 0 more', x: 200, y: 110, box: { left: 150, right: 250, top: 80, bottom: 110 } }], null, controls, { w: 844, h: 390 }, measure);
134
+ assert.equal(beside.length, 1);
135
+ assert.equal(touching(beside[0].box, cabinet.rect), false, 'pad text clears the actual cabinet target');
136
+ chrome.setLabels([{ id: 'pad', x: 200, y: 120, text: 'Station\nyou + 3 more', padOccupancy: true, box: { left: 130, right: 270, top: 80, bottom: 120 } }]);
137
+ const label = dom.made.find((node) => node.dataset.padOccupancy === '1');
138
+ assert.equal(label.style.left, '200px');
139
+ assert.equal(label.style.top, '120px');
140
+ assert.equal(label.style.whiteSpace, 'pre-line');
141
+ label.rect = { left: 130, right: 270, top: 80, bottom: 120 };
142
+ assert.deepEqual(chrome.crowdNameLabelBoxes(), [label.rect], 'crowd pass reads the final rendered label rectangle');
143
+ chrome.setLabels([{ id: 'pad', x: 200, y: 120, text: 'Station' }]);
144
+ assert.equal(label.style.whiteSpace, 'nowrap', 'OFF restores any reused opted-in label');
145
+ // With both HUD clearance and crowd names opted in, the late summary setter
146
+ // must preserve the actual final position of an ordinary unboxed label.
147
+ const hud = dom.made.find((node) => node.styles.textShadow?.includes('rgba(0,0,0,0.95)'));
148
+ dom.made.find(node => node.dataset.hub === 'hud-prompt').rect = { left: 200, right: 600, top: 310, bottom: 336, width: 400, height: 26 };
149
+ hud.rect = { left: 90, right: 360, top: 12, bottom: 106 };
150
+ chrome.setHudClear(true);
151
+ chrome.setHud({ title: 'Town', big: '12', text: 'Players nearby' }, null);
152
+ chrome.setLabels([{ id: 'ordinary', x: 200, y: 90, text: 'Start here' }]);
153
+ chrome.flushHudClear();
154
+ const ordinary = dom.made.find((node) => node.textContent === 'Start here');
155
+ const clearedTop = ordinary.style.top;
156
+ assert.notEqual(clearedTop, '90px', 'hud.clear moves the ordinary label before the late crowd pass');
157
+ chrome.setCrowdNameSummary({ id: 'crowd:summary', text: '+2 more', box: { left: 170, right: 230, top: 120, bottom: 144 } });
158
+ assert.equal(ordinary.style.top, clearedTop, 'crowd summary preserves the ordinary label final DOM position');
159
+ const summaryNode = dom.made.find((node) => node.textContent === '+2 more');
160
+ assert.equal(summaryNode.style.top, '144px');
161
+ chrome.setLabels([{ id: 'ordinary', x: 200, y: 90, text: 'Start here' }], true);
162
+ chrome.setCrowdNameSummary({ id: 'crowd:summary', text: '+3 more', box: { left: 180, right: 240, top: 122, bottom: 146 } });
163
+ assert.equal(dom.made.find((node) => node.textContent === '+3 more'), summaryNode, 'consecutive opted-in frames reuse the one summary node');
164
+ chrome.setLabels([{ id: 'ordinary', x: 200, y: 90, text: 'Start here' }]);
165
+ assert.equal(summaryNode.parent.children.includes(summaryNode), false, 'the ordinary OFF path destroys the retained summary node');
166
+ rail.remove();
167
+ chrome.setActions([{ id: 'one', label: 'Play' }, { id: 'two', label: 'Watch' }, { id: 'three', label: 'Details' }], () => {}, true, 1, true);
168
+ const launcher = dom.made.find((node) => node.attrs['aria-haspopup'] === 'dialog');
169
+ assert.ok(launcher);
170
+ launcher.style.display = 'block';
171
+ launcher.handlers.click({ stopPropagation() {} });
172
+ const sheet = dom.made.find((node) => node.dataset.hub === 'action-sheet');
173
+ assert.equal(sheet.parent.dataset.hub, 'action-backdrop');
174
+ sheet.rect = { left: 200, right: 760, top: 140, bottom: 390 };
175
+ assert.ok(chrome.padOccupancyControls().some((rect) => rect.left === 200 && rect.top === 140 && rect.right === 760), 'actual nested open action sheet is reserved');
176
+ chrome.dispose();
177
+ console.log('pad occupancy: eligible counts, privacy, stale state, override precedence, overlap and exact viewport clearance passed');