castle-web-cli 0.4.231 → 0.4.233

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 (368) hide show
  1. package/dist/agent-failures.d.ts +8 -0
  2. package/dist/agent-failures.js +19 -2
  3. package/dist/agent-prompts.d.ts +1 -1
  4. package/dist/agent-prompts.js +10 -3
  5. package/dist/agent.d.ts +64 -3
  6. package/dist/agent.js +170 -81
  7. package/dist/castle-host/host.d.ts +1 -0
  8. package/dist/castle-host/host.js +51 -3
  9. package/dist/castleJson.d.ts +4 -2
  10. package/dist/castleJson.js +2 -0
  11. package/dist/check.d.ts +3 -1
  12. package/dist/check.js +11 -1
  13. package/dist/devSessionStorage.js +47 -1
  14. package/dist/importPinMismatch.d.ts +22 -0
  15. package/dist/importPinMismatch.js +77 -0
  16. package/dist/importRegression.js +3 -15
  17. package/dist/imports.d.ts +10 -3
  18. package/dist/imports.js +88 -20
  19. package/dist/index.js +5 -4
  20. package/dist/init.js +1 -1
  21. package/dist/platformDoc.js +22 -0
  22. package/dist/routerFences.d.ts +5 -0
  23. package/dist/routerFences.js +12 -2
  24. package/dist/save-deck.d.ts +5 -0
  25. package/dist/save-deck.js +37 -4
  26. package/dist/serve.js +3 -0
  27. package/dist/serverBundle.js +5 -3
  28. package/dist/shell/assets/{index-D2tWM896.js → index-BjOxR-lW.js} +4 -4
  29. package/dist/shell/assets/index-MVLfNYd9.css +1 -0
  30. package/dist/shell/index.html +2 -2
  31. package/dist/taskSteer.d.ts +13 -0
  32. package/dist/taskSteer.js +22 -2
  33. package/kits/base/castle.json +1 -1
  34. package/kits/base/package-lock.json +1 -1
  35. package/kits/base/sdk/README.md +79 -2
  36. package/kits/base/sdk/avatar.d.ts +6 -2
  37. package/kits/base/sdk/avatar.js +12 -4
  38. package/kits/base/sdk/castle.d.ts +1 -1
  39. package/kits/base/sdk/commands.d.ts +14 -0
  40. package/kits/base/sdk/hub.d.ts +6 -2
  41. package/kits/base/sdk/hub.js +13 -0
  42. package/kits/base/sdk/multiplayer.js +17 -1
  43. package/kits/base/sdk/save.js +2 -1
  44. package/kits/base/sdk/server/hub.d.ts +87 -0
  45. package/kits/base/sdk/server/hub.js +70 -0
  46. package/kits/base/sdk/server/platformHandle.d.ts +31 -1
  47. package/kits/base/sdk/server/storage.d.ts +13 -0
  48. package/kits/base/sdk/server/storage.js +46 -0
  49. package/kits/base/sdk/server/wrapper.d.ts +36 -5
  50. package/kits/base/sdk/server/wrapper.js +83 -8
  51. package/kits/hub-game/CLAUDE.md +352 -12
  52. package/kits/hub-game/blueprints/avatar-10.scene +28 -0
  53. package/kits/hub-game/blueprints/avatar-11.scene +28 -0
  54. package/kits/hub-game/blueprints/avatar-12.scene +28 -0
  55. package/kits/hub-game/blueprints/avatar-13.scene +28 -0
  56. package/kits/hub-game/blueprints/avatar-14.scene +28 -0
  57. package/kits/hub-game/blueprints/avatar-15.scene +28 -0
  58. package/kits/hub-game/blueprints/avatar-4.scene +28 -0
  59. package/kits/hub-game/blueprints/avatar-5.scene +28 -0
  60. package/kits/hub-game/blueprints/avatar-6.scene +28 -0
  61. package/kits/hub-game/blueprints/avatar-7.scene +28 -0
  62. package/kits/hub-game/blueprints/avatar-8.scene +28 -0
  63. package/kits/hub-game/blueprints/avatar-9.scene +28 -0
  64. package/kits/hub-game/code/client/actorBudget.js +47 -0
  65. package/kits/hub-game/code/client/attention.js +11 -2
  66. package/kits/hub-game/code/client/avatar.js +345 -32
  67. package/kits/hub-game/code/client/avatarCap.js +228 -0
  68. package/kits/hub-game/code/client/avatarColors.js +70 -0
  69. package/kits/hub-game/code/client/avatarFaces.js +21 -0
  70. package/kits/hub-game/code/client/avatarShare.js +251 -0
  71. package/kits/hub-game/code/client/ballot.js +467 -0
  72. package/kits/hub-game/code/client/build.js +22 -0
  73. package/kits/hub-game/code/client/chat.js +12 -0
  74. package/kits/hub-game/code/client/chrome.js +1334 -50
  75. package/kits/hub-game/code/client/companion.js +716 -0
  76. package/kits/hub-game/code/client/companionDress.js +99 -0
  77. package/kits/hub-game/code/client/decor.js +509 -0
  78. package/kits/hub-game/code/client/earned.js +131 -0
  79. package/kits/hub-game/code/client/emoteBubble.js +75 -0
  80. package/kits/hub-game/code/client/grab.js +363 -20
  81. package/kits/hub-game/code/client/hats.js +26 -0
  82. package/kits/hub-game/code/client/hookLayer.js +328 -15
  83. package/kits/hub-game/code/client/hudClear.js +126 -0
  84. package/kits/hub-game/code/client/idle.js +163 -22
  85. package/kits/hub-game/code/client/interestCap.js +81 -0
  86. package/kits/hub-game/code/client/keys.js +36 -0
  87. package/kits/hub-game/code/client/labelsNear.js +205 -0
  88. package/kits/hub-game/code/client/menuIcons.js +34 -0
  89. package/kits/hub-game/code/client/pack.js +6 -2
  90. package/kits/hub-game/code/client/packFormat.js +3 -3
  91. package/kits/hub-game/code/client/rehello.js +167 -0
  92. package/kits/hub-game/code/client/shot.js +92 -0
  93. package/kits/hub-game/code/client/sound.js +63 -8
  94. package/kits/hub-game/code/client/soundscape.js +1151 -0
  95. package/kits/hub-game/code/client/soundscapeActions.js +99 -0
  96. package/kits/hub-game/code/client/soundscapeAmbience.js +453 -0
  97. package/kits/hub-game/code/client/soundscapeBaked.js +143 -0
  98. package/kits/hub-game/code/client/soundscapeBusker.js +217 -0
  99. package/kits/hub-game/code/client/soundscapeCourt.js +200 -0
  100. package/kits/hub-game/code/client/soundscapeCrowd.js +331 -0
  101. package/kits/hub-game/code/client/soundscapeCues.js +362 -0
  102. package/kits/hub-game/code/client/soundscapeMap.js +181 -0
  103. package/kits/hub-game/code/client/soundscapeMarket.js +176 -0
  104. package/kits/hub-game/code/client/soundscapeMusic.js +126 -0
  105. package/kits/hub-game/code/client/soundscapeMusicEngine.js +460 -0
  106. package/kits/hub-game/code/client/soundscapeSimlish.js +737 -0
  107. package/kits/hub-game/code/client/soundscapeSongs.js +127 -0
  108. package/kits/hub-game/code/client/soundscapeSongsRound3.js +63 -0
  109. package/kits/hub-game/code/client/soundscapeSynthesis.js +168 -0
  110. package/kits/hub-game/code/client/soundscapeUi.js +211 -0
  111. package/kits/hub-game/code/client/soundscapeVoice.js +1209 -0
  112. package/kits/hub-game/code/client/soundscapeWaves.js +206 -0
  113. package/kits/hub-game/code/client/spin.js +101 -0
  114. package/kits/hub-game/code/client/state.js +131 -1
  115. package/kits/hub-game/code/client/stuck.js +259 -0
  116. package/kits/hub-game/code/client/talk.js +538 -47
  117. package/kits/hub-game/code/client/tiers.js +541 -27
  118. package/kits/hub-game/code/client/toastBand.js +37 -0
  119. package/kits/hub-game/code/client/together.js +98 -1
  120. package/kits/hub-game/code/client/visibility.js +43 -0
  121. package/kits/hub-game/code/client/wear.js +470 -97
  122. package/kits/hub-game/code/client/yours.js +199 -0
  123. package/kits/hub-game/code/companionSpec.js +45 -0
  124. package/kits/hub-game/code/privateText.js +7 -0
  125. package/kits/hub-game/code/server/actions.js +133 -0
  126. package/kits/hub-game/code/server/actors.js +14 -1
  127. package/kits/hub-game/code/server/ask.js +155 -0
  128. package/kits/hub-game/code/server/ballot.js +539 -0
  129. package/kits/hub-game/code/server/cells.js +100 -0
  130. package/kits/hub-game/code/server/companion.js +82 -0
  131. package/kits/hub-game/code/server/cues.js +70 -0
  132. package/kits/hub-game/code/server/decor.js +269 -0
  133. package/kits/hub-game/code/server/earned.js +461 -0
  134. package/kits/hub-game/code/server/friendBests.js +166 -0
  135. package/kits/hub-game/code/server/friendsAmong.js +232 -0
  136. package/kits/hub-game/code/server/grab.js +296 -11
  137. package/kits/hub-game/code/server/history.js +5 -0
  138. package/kits/hub-game/code/server/hub.js +1317 -52
  139. package/kits/hub-game/code/server/idle.js +30 -11
  140. package/kits/hub-game/code/server/index.js +2 -2
  141. package/kits/hub-game/code/server/labels.js +28 -2
  142. package/kits/hub-game/code/server/manifest.js +424 -8
  143. package/kits/hub-game/code/server/menu.js +133 -0
  144. package/kits/hub-game/code/server/npcs.js +830 -80
  145. package/kits/hub-game/code/server/party.js +13 -2
  146. package/kits/hub-game/code/server/players.js +22 -0
  147. package/kits/hub-game/code/server/say.js +8 -2
  148. package/kits/hub-game/code/server/shot.js +110 -0
  149. package/kits/hub-game/code/server/standing.js +124 -0
  150. package/kits/hub-game/code/server/vis.js +113 -0
  151. package/kits/hub-game/code/server/wear.js +128 -11
  152. package/kits/hub-game/code/server/yours.js +59 -0
  153. package/kits/hub-game/code/shared/cues.js +9 -0
  154. package/kits/hub-game/code/shared/decor.js +41 -0
  155. package/kits/hub-game/code/shared/shot.js +19 -0
  156. package/kits/hub-game/code/shared/spin.js +57 -0
  157. package/kits/hub-game/code/systems/hub.js +1083 -85
  158. package/kits/hub-game/docs/content-pack.md +1 -1
  159. package/kits/hub-game/docs/contract.md +2440 -61
  160. package/kits/hub-game/docs/home-pieces.md +64 -0
  161. package/kits/hub-game/models/avatar-10.pxmodel +28 -0
  162. package/kits/hub-game/models/avatar-11.pxmodel +28 -0
  163. package/kits/hub-game/models/avatar-12.pxmodel +27 -0
  164. package/kits/hub-game/models/avatar-13.pxmodel +24 -0
  165. package/kits/hub-game/models/avatar-14.pxmodel +29 -0
  166. package/kits/hub-game/models/avatar-15.pxmodel +24 -0
  167. package/kits/hub-game/models/avatar-4.pxmodel +29 -0
  168. package/kits/hub-game/models/avatar-5.pxmodel +27 -0
  169. package/kits/hub-game/models/avatar-6.pxmodel +26 -0
  170. package/kits/hub-game/models/avatar-7.pxmodel +25 -0
  171. package/kits/hub-game/models/avatar-8.pxmodel +24 -0
  172. package/kits/hub-game/models/avatar-9.pxmodel +30 -0
  173. package/kits/hub-game/models/earned/badge-round.pxmodel +100 -0
  174. package/kits/hub-game/models/earned/badge-shield.pxmodel +117 -0
  175. package/kits/hub-game/models/earned/badge-star.pxmodel +87 -0
  176. package/kits/hub-game/models/earned/belt-plain.pxmodel +72 -0
  177. package/kits/hub-game/models/earned/held-ball.pxmodel +43 -0
  178. package/kits/hub-game/models/earned/held-lantern.pxmodel +85 -0
  179. package/kits/hub-game/models/earned/held-net.pxmodel +57 -0
  180. package/kits/hub-game/models/earned/held-trophy.pxmodel +109 -0
  181. package/kits/hub-game/models/earned/pin-round.pxmodel +62 -0
  182. package/kits/hub-game/models/earned/sash-plain.pxmodel +66 -0
  183. package/kits/hub-game/models/earned/square/belt-plain.pxmodel +104 -0
  184. package/kits/hub-game/models/earned/square/sash-plain.pxmodel +98 -0
  185. package/kits/hub-game/models/hats/bat-clip.pxmodel +206 -0
  186. package/kits/hub-game/models/hats/beekeeper.pxmodel +149 -0
  187. package/kits/hub-game/models/hats/cap.pxmodel +162 -0
  188. package/kits/hub-game/models/hats/captain.pxmodel +178 -0
  189. package/kits/hub-game/models/hats/crooked-top.pxmodel +172 -0
  190. package/kits/hub-game/models/hats/flower-crown.pxmodel +451 -0
  191. package/kits/hub-game/models/hats/foam-crown.pxmodel +179 -0
  192. package/kits/hub-game/models/hats/lantern.pxmodel +230 -0
  193. package/kits/hub-game/models/hats/laurel.pxmodel +533 -0
  194. package/kits/hub-game/models/hats/lighthouse.pxmodel +96 -0
  195. package/kits/hub-game/models/hats/sailor.pxmodel +141 -0
  196. package/kits/hub-game/models/hats/souwester.pxmodel +131 -0
  197. package/kits/hub-game/models/hats/straw.pxmodel +139 -0
  198. package/kits/hub-game/models/hats/sunflower.pxmodel +406 -0
  199. package/kits/hub-game/models/hats/sweatband.pxmodel +112 -0
  200. package/kits/hub-game/models/hats/witch.pxmodel +147 -0
  201. package/kits/hub-game/package-lock.json +2 -0
  202. package/kits/hub-game/package.json +2 -1
  203. package/kits/hub-game/scripts/check.mjs +78 -11
  204. package/kits/hub-game/scripts/companion-follower-wire.json +1 -0
  205. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +121 -0
  206. package/kits/hub-game/scripts/fixtures/decor-keyless.json +293 -0
  207. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +23 -0
  208. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +107 -0
  209. package/kits/hub-game/scripts/fixtures/interest-legacy.json +385 -0
  210. package/kits/hub-game/scripts/fixtures/npc-notes-v1.77.jsonl +4 -0
  211. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -0
  212. package/kits/hub-game/scripts/gen-avatars.mjs +933 -16
  213. package/kits/hub-game/scripts/gen-earned.mjs +285 -0
  214. package/kits/hub-game/scripts/gen-hats.mjs +827 -0
  215. package/kits/hub-game/scripts/grab.before-orbit.mjs +400 -0
  216. package/kits/hub-game/scripts/soundscape-wave-analysis.mjs +125 -0
  217. package/kits/hub-game/scripts/test-actions-client.mjs +488 -0
  218. package/kits/hub-game/scripts/test-actions.mjs +298 -0
  219. package/kits/hub-game/scripts/test-actor-budget.mjs +44 -0
  220. package/kits/hub-game/scripts/test-actors.mjs +19 -17
  221. package/kits/hub-game/scripts/test-ask-client.mjs +358 -0
  222. package/kits/hub-game/scripts/test-ask.mjs +269 -0
  223. package/kits/hub-game/scripts/test-attention.mjs +10 -1
  224. package/kits/hub-game/scripts/test-avatar-cap.mjs +379 -0
  225. package/kits/hub-game/scripts/test-avatar-colors.mjs +72 -0
  226. package/kits/hub-game/scripts/test-avatar-models.mjs +181 -0
  227. package/kits/hub-game/scripts/test-avatar-share.mjs +318 -0
  228. package/kits/hub-game/scripts/test-avatar-wire.mjs +753 -0
  229. package/kits/hub-game/scripts/test-avatar.mjs +540 -7
  230. package/kits/hub-game/scripts/test-ballot.mjs +1001 -0
  231. package/kits/hub-game/scripts/test-build.mjs +31 -0
  232. package/kits/hub-game/scripts/test-cells.mjs +71 -0
  233. package/kits/hub-game/scripts/test-chat.mjs +694 -0
  234. package/kits/hub-game/scripts/test-classic.mjs +2 -0
  235. package/kits/hub-game/scripts/test-companion-chat.mjs +198 -0
  236. package/kits/hub-game/scripts/test-companion-client.mjs +1167 -0
  237. package/kits/hub-game/scripts/test-companion.mjs +259 -0
  238. package/kits/hub-game/scripts/test-decor-client.mjs +303 -0
  239. package/kits/hub-game/scripts/test-decor.mjs +457 -0
  240. package/kits/hub-game/scripts/test-earned-client.mjs +459 -0
  241. package/kits/hub-game/scripts/test-earned.mjs +1194 -0
  242. package/kits/hub-game/scripts/test-emote-bubble.mjs +110 -0
  243. package/kits/hub-game/scripts/test-friend-bests.mjs +435 -0
  244. package/kits/hub-game/scripts/test-grab-client.mjs +186 -3
  245. package/kits/hub-game/scripts/test-grab-orbit.mjs +918 -0
  246. package/kits/hub-game/scripts/test-grab.mjs +864 -3
  247. package/kits/hub-game/scripts/test-hats.mjs +483 -0
  248. package/kits/hub-game/scripts/test-hub-leaving.mjs +203 -0
  249. package/kits/hub-game/scripts/test-hub-ops.mjs +439 -2
  250. package/kits/hub-game/scripts/test-hub-trip.mjs +1228 -1
  251. package/kits/hub-game/scripts/test-hud-clear.mjs +1000 -0
  252. package/kits/hub-game/scripts/test-idle.mjs +361 -1
  253. package/kits/hub-game/scripts/test-interest-cap.mjs +36 -0
  254. package/kits/hub-game/scripts/test-interest-cells.mjs +493 -0
  255. package/kits/hub-game/scripts/test-interest-client.mjs +118 -0
  256. package/kits/hub-game/scripts/test-keys.mjs +46 -1
  257. package/kits/hub-game/scripts/test-labels.mjs +596 -0
  258. package/kits/hub-game/scripts/test-manifest.mjs +282 -0
  259. package/kits/hub-game/scripts/test-menu-client.mjs +480 -0
  260. package/kits/hub-game/scripts/test-menu.mjs +296 -0
  261. package/kits/hub-game/scripts/test-npcs.mjs +1718 -12
  262. package/kits/hub-game/scripts/test-object-entry.mjs +76 -0
  263. package/kits/hub-game/scripts/test-pack.mjs +7 -0
  264. package/kits/hub-game/scripts/test-party.mjs +22 -1
  265. package/kits/hub-game/scripts/test-picker.mjs +314 -0
  266. package/kits/hub-game/scripts/test-rehello.mjs +1039 -0
  267. package/kits/hub-game/scripts/test-relations-among.mjs +222 -0
  268. package/kits/hub-game/scripts/test-relations-refresh.mjs +188 -0
  269. package/kits/hub-game/scripts/test-say.mjs +59 -2
  270. package/kits/hub-game/scripts/test-shot.mjs +756 -0
  271. package/kits/hub-game/scripts/test-soundscape.mjs +5432 -0
  272. package/kits/hub-game/scripts/test-spin.mjs +314 -0
  273. package/kits/hub-game/scripts/test-standing.mjs +416 -0
  274. package/kits/hub-game/scripts/test-stuck.mjs +1903 -0
  275. package/kits/hub-game/scripts/test-tier-cells.mjs +706 -0
  276. package/kits/hub-game/scripts/test-tiers-render.mjs +339 -0
  277. package/kits/hub-game/scripts/test-tiers.mjs +666 -3
  278. package/kits/hub-game/scripts/test-toast-band.mjs +61 -0
  279. package/kits/hub-game/scripts/test-try-on.mjs +940 -0
  280. package/kits/hub-game/scripts/test-vis.mjs +343 -0
  281. package/kits/hub-game/scripts/test-visibility.mjs +134 -0
  282. package/kits/hub-game/scripts/test-yours-chrome.mjs +166 -0
  283. package/kits/hub-game/scripts/test-yours.mjs +372 -0
  284. package/kits/multiplayer-3d/CLAUDE.md +50 -0
  285. package/kits/multiplayer-3d/castle.json +5 -5
  286. package/kits/multiplayer-3d/code/client/avatars.js +7 -0
  287. package/kits/multiplayer-3d/code/client/gait.js +65 -0
  288. package/kits/multiplayer-3d/code/client/nameTags.js +59 -4
  289. package/kits/multiplayer-3d/code/options.js +5 -0
  290. package/kits/multiplayer-3d/code/server/ownership.js +10 -2
  291. package/kits/multiplayer-3d/code/server/sceneBodies.js +12 -0
  292. package/kits/multiplayer-3d/code/server/world.js +7 -0
  293. package/kits/multiplayer-3d/code/systems/multiplayer.js +74 -4
  294. package/kits/multiplayer-3d/package.json +2 -1
  295. package/kits/multiplayer-3d/scripts/fixtures/README.md +11 -0
  296. package/kits/multiplayer-3d/scripts/fixtures/ownership-legacy.json +2 -0
  297. package/kits/multiplayer-3d/scripts/ownership-harness.mjs +102 -0
  298. package/kits/multiplayer-3d/scripts/ownership-loader.mjs +46 -0
  299. package/kits/multiplayer-3d/scripts/ownership-worker.mjs +15 -0
  300. package/kits/multiplayer-3d/scripts/record-ownership-session.mjs +98 -0
  301. package/kits/multiplayer-3d/scripts/test-eligible-claims.mjs +167 -0
  302. package/kits/multiplayer-3d/scripts/test-own-name-tag.mjs +247 -0
  303. package/kits/physics-2d/CLAUDE.md +9 -0
  304. package/kits/physics-2d/castle.json +2 -2
  305. package/kits/physics-2d/engine/scene.js +288 -1
  306. package/kits/physics-2d/engine/skyKey.js +129 -0
  307. package/kits/physics-2d/engine/stillClock.js +106 -0
  308. package/kits/physics-2d/engine/updateBudget.js +21 -0
  309. package/kits/physics-2d/scripts/test-skip-unchanged.mjs +370 -1
  310. package/kits/physics-3d/CLAUDE.md +1391 -0
  311. package/kits/physics-3d/behaviors/Player.jsx +921 -3
  312. package/kits/physics-3d/castle.json +3 -3
  313. package/kits/physics-3d/docs/pxmodel-format.md +12 -0
  314. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +98 -10
  315. package/kits/physics-3d/engine3d/actornode.js +86 -0
  316. package/kits/physics-3d/engine3d/animationBudget.js +23 -0
  317. package/kits/physics-3d/engine3d/editorWorld.js +6 -0
  318. package/kits/physics-3d/engine3d/emptynodes.js +232 -0
  319. package/kits/physics-3d/engine3d/framecap.js +96 -0
  320. package/kits/physics-3d/engine3d/gait.js +118 -0
  321. package/kits/physics-3d/engine3d/kithooks.js +47 -0
  322. package/kits/physics-3d/engine3d/look.js +507 -48
  323. package/kits/physics-3d/engine3d/lookbake.js +208 -0
  324. package/kits/physics-3d/engine3d/materialpresets.js +2 -0
  325. package/kits/physics-3d/engine3d/motion.js +39 -10
  326. package/kits/physics-3d/engine3d/nearshadows.js +37 -19
  327. package/kits/physics-3d/engine3d/optimize.js +58 -5
  328. package/kits/physics-3d/engine3d/orbitinput.js +755 -0
  329. package/kits/physics-3d/engine3d/orbitlens.js +48 -0
  330. package/kits/physics-3d/engine3d/ownmodel.js +213 -0
  331. package/kits/physics-3d/engine3d/pxmodel.js +42 -11
  332. package/kits/physics-3d/engine3d/shadowfade.js +882 -0
  333. package/kits/physics-3d/engine3d/sky.js +547 -0
  334. package/kits/physics-3d/engine3d/skylife.js +306 -0
  335. package/kits/physics-3d/engine3d/unchanged.js +11 -0
  336. package/kits/physics-3d/engine3d/viewrange.js +52 -0
  337. package/kits/physics-3d/engine3d/world3d.js +870 -87
  338. package/kits/physics-3d/main.jsx +5 -0
  339. package/kits/physics-3d/package.json +1 -1
  340. package/kits/physics-3d/scripts/Player.before-orbit.mjs +310 -0
  341. package/kits/physics-3d/scripts/Scene3DPlayer.before-orbit.jsx +337 -0
  342. package/kits/physics-3d/scripts/look-baseline.mjs +155 -0
  343. package/kits/physics-3d/scripts/test-camera-follow.mjs +12 -2
  344. package/kits/physics-3d/scripts/test-camera-orbit.mjs +4588 -0
  345. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +787 -0
  346. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +435 -0
  347. package/kits/physics-3d/scripts/test-frame-cap.mjs +452 -0
  348. package/kits/physics-3d/scripts/test-gait.mjs +387 -0
  349. package/kits/physics-3d/scripts/test-look-bake.mjs +1056 -0
  350. package/kits/physics-3d/scripts/test-model-parse-cache.mjs +92 -0
  351. package/kits/physics-3d/scripts/test-near-shadows.mjs +3 -0
  352. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +1920 -0
  353. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +545 -0
  354. package/kits/physics-3d/scripts/test-orbit-shot.mjs +583 -0
  355. package/kits/physics-3d/scripts/test-orbit-view.mjs +230 -0
  356. package/kits/physics-3d/scripts/test-skip-empty-nodes.mjs +845 -0
  357. package/kits/physics-3d/scripts/test-sky.mjs +2470 -0
  358. package/kits/physics-3d/scripts/test-static-actors.mjs +13 -1
  359. package/kits/physics-3d/scripts/test-static-passes.mjs +1 -1
  360. package/kits/physics-3d/scripts/test-static-scenery.mjs +2171 -0
  361. package/kits/physics-3d/scripts/test-steady-hover.mjs +635 -0
  362. package/kits/physics-3d/scripts/test-view-range.mjs +260 -0
  363. package/kits/physics-3d/systems/physics3d.js +474 -12
  364. package/kits/real-time/castle.json +2 -2
  365. package/kits/real-time/code/server/gameHooks.js +7 -0
  366. package/kits/real-time/code/server/session.js +97 -19
  367. package/package.json +2 -2
  368. package/dist/shell/assets/index-Cf61cNfT.css +0 -1
@@ -0,0 +1,416 @@
1
+ // Conservative standing defaults (v1.48), with the real multiplayer world,
2
+ // real-time session and hub layer. Only scene loading and import resolution
3
+ // are supplied by this harness. `npm run check` runs it with the other placement suites.
4
+ import assert from 'node:assert/strict';
5
+ import { register } from 'node:module';
6
+
7
+ const sceneStub = `
8
+ export const readScene = () => globalThis.__standingActors ?? [];
9
+ export const resolveScenePath = (path) => path ?? 'scenes/main.scene';
10
+ export const sceneGround = () => globalThis.__standingGround ?? {};
11
+ `;
12
+ const kitRoot = new URL('../../', import.meta.url).href;
13
+ const modules = {
14
+ '@dimforge/rapier3d-compat': new URL('../node_modules/@dimforge/rapier3d-compat/rapier.mjs', import.meta.url).href,
15
+ three: new URL('../node_modules/three/build/three.module.js', import.meta.url).href,
16
+ };
17
+ register(`data:text/javascript,${encodeURIComponent(`
18
+ export async function resolve(specifier, context, next) {
19
+ if (specifier.endsWith('/sceneBodies.js')) {
20
+ return { url: ${JSON.stringify('data:text/javascript,' + encodeURIComponent(sceneStub))}, shortCircuit: true };
21
+ }
22
+ const modules = ${JSON.stringify(modules)};
23
+ if (modules[specifier]) return { url: modules[specifier], shortCircuit: true };
24
+ if (specifier.startsWith('@imports/castle.')) {
25
+ return next(specifier.replace('@imports/castle.', ${JSON.stringify(kitRoot)}), context);
26
+ }
27
+ return next(specifier, context);
28
+ }
29
+ `)}`);
30
+ const World = await import('../../multiplayer-3d/code/server/world.js');
31
+ const Players = await import('../../multiplayer-3d/code/server/players.js');
32
+ const Poses = await import('../../multiplayer-3d/code/client/poses.js');
33
+ const Ownership = await import('../../multiplayer-3d/code/server/ownership.js');
34
+ const { makeSession } = await import('../../real-time/code/server/session.js');
35
+ const { WORLD } = await import('../../real-time/code/client/messages.js');
36
+ const { hubPlayers } = await import('../code/server/players.js');
37
+ const { layer } = await import('../code/server/hub.js');
38
+ const { standingY } = await import('../code/server/standing.js');
39
+ const Party = await import('../code/server/party.js');
40
+
41
+ const spawn = { id: 'spawn', components: {
42
+ Player: {}, Transform: { x: 0, y: 1, z: 0 },
43
+ Shape: { kind: 'capsule', height: 1.4, radius: 0.35 },
44
+ } };
45
+ const door = { id: 'door', components: {
46
+ HubDoor: { id: 'race', to: 'race' }, Transform: { x: 10, y: 1, z: 0 },
47
+ } };
48
+ const config = { server: { maxPlayers: 8 }, hub: { contract: 1, title: 'Town', stuck: true,
49
+ places: { race: { title: 'Race', scene: 'scenes/race.scene' } },
50
+ } };
51
+ const engine = { createBody: World.createBody, removeActor: World.removeActor };
52
+ const near = (actual, expected) => assert.ok(Math.abs(actual - expected) < 1e-5, `${actual} should be ${expected}`);
53
+ const box = (id, y, height, extra = {}) => ({ id, components: {
54
+ Transform: { x: 0, y, z: 0 }, Shape: { kind: 'box', width: 4, height, depth: 4, solid: true }, ...extra,
55
+ } });
56
+ const at = (y = 1.2) => ({ x: 0, y, z: 0 });
57
+ let n = 0;
58
+ async function test(name, fn) {
59
+ try { await fn(); } catch (error) { console.error(`not ok: ${name}`); throw error; }
60
+ n += 1;
61
+ }
62
+ async function boot({ actors = [], ground = {}, hooks = {} } = {}) {
63
+ globalThis.__standingActors = [spawn, door, ...actors];
64
+ globalThis.__standingGround = ground;
65
+ const sim = await World.createSimulation();
66
+ Players.addPlayer(sim, 'p1');
67
+ let ctx;
68
+ const h = layer(config, { ready(hub) { ctx = hub; }, ...hooks }, {}, () => true, () => ground, null, engine);
69
+ const session = { sessionId: 'dev:standing', players: [{ playerId: 'p1', username: 'ada' }], send() {}, broadcast() {} };
70
+ h.sceneFor(session);
71
+ h.ready(sim);
72
+ return { sim, h, session, ctx, body: sim.players.get('p1'), height: (point = at()) => h.standingY(sim, point) };
73
+ }
74
+ async function withBoot(options, fn) {
75
+ const b = await boot(options);
76
+ try { await fn(b); } finally { b.sim.world.free(); }
77
+ }
78
+ function arrive(b) {
79
+ b.h.message(b.session, { playerId: 'p1' }, { k: 'hub-hello', avatar: 1 });
80
+ b.h.place(b.sim);
81
+ }
82
+
83
+ // Real session admission: the hub resolves the place in sceneFor and reads
84
+ // its actors in ready, before admit calls the wrapper and before WORLD.
85
+ async function joined(pose, { actors = [], ground = {}, hooks = {} } = {}) {
86
+ globalThis.__standingActors = [spawn, door, ...actors];
87
+ globalThis.__standingGround = ground;
88
+ const sim = await World.createSimulation();
89
+ const hub = layer(config, hooks, {}, () => true, () => ground, null, engine);
90
+ const wrapped = hubPlayers(hub);
91
+ let steps = 0;
92
+ const realStep = sim.world.step.bind(sim.world);
93
+ sim.world.step = () => { steps += 1; realStep(); };
94
+ const sent = [];
95
+ const session = {
96
+ sessionId: 'standing-join', mode: 'private',
97
+ players: [{ playerId: 'p1', userId: '101', username: 'ada' }],
98
+ send(id, data) { sent.push(data); }, broadcast() {},
99
+ storage: { deck: {
100
+ async get() { return pose == null ? {} : { 'player:standing-join:101': { pose } }; },
101
+ async set() {},
102
+ } },
103
+ };
104
+ let added;
105
+ const handlers = makeSession({ label: 'standing-test', poses: Poses, ownership: Ownership,
106
+ world: { ...World, createSimulation: async () => sim },
107
+ // Enable reading a saved pose to exercise real-time's resume path. A hub
108
+ // normally disables disk persistence and resumes from a departed body.
109
+ game: { ...hub, persist: true },
110
+ players: { ...wrapped, addPlayer(world, id, saved) {
111
+ assert.equal(world.timeMs, 0);
112
+ assert.equal(steps, 0, 'fresh simulation has never stepped');
113
+ wrapped.addPlayer(world, id, saved);
114
+ assert.equal(steps, 0, 'standing height never steps physics');
115
+ const p = world.players.get(id);
116
+ added = { at: { ...p.at }, translation: { ...p.body.translation() },
117
+ facing: p.facing, movedAt: p.movedAt, settled: p.settled, clamped: p.clamped };
118
+ } },
119
+ });
120
+ try {
121
+ handlers.onPlayerJoin(session, session.players[0]);
122
+ await new Promise((resolve) => setImmediate(resolve));
123
+ handlers.onTick(session);
124
+ return { added, snapshot: sent.find((data) => data.k === WORLD) };
125
+ } finally { sim.world.free(); }
126
+ }
127
+
128
+ await test('first join of a fresh never-stepped hub starts at 0.76 and WORLD sends it', async () => {
129
+ const { added, snapshot } = await joined(null);
130
+ near(added.at.y, 0.76);
131
+ near(added.translation.y, 0.76);
132
+ assert.equal(added.at.x, spawn.components.Transform.x + 1.1);
133
+ assert.equal(added.at.z, spawn.components.Transform.z);
134
+ assert.equal(added.facing, 0);
135
+ assert.equal(added.movedAt, 0);
136
+ assert.equal(added.settled, false);
137
+ assert.equal(added.clamped, false);
138
+ near(snapshot.ps[0][2], 0.76);
139
+ });
140
+ await test('first join sees the actual scene solids and never raises the body', async () => {
141
+ const { added, snapshot } = await joined(null, { actors: [box('platform', 0.25, 0.5)] });
142
+ near(added.at.y, 1.2);
143
+ near(snapshot.ps[0][2], 1.2);
144
+ });
145
+ await test('ready hook spawns and hides are visible to the first joining body', async () => {
146
+ const template = box('template', 0.25, 0.5, { Transform: { x: 20, y: 0.25, z: 0 } });
147
+ const { added } = await joined(null, { actors: [template], hooks: { ready(hub) {
148
+ hub.hide('template');
149
+ assert.ok(hub.spawn('template', { x: 0, y: 0.25, z: 0 }));
150
+ } } });
151
+ near(added.at.y, 1.2);
152
+ });
153
+ await test('first join honours a scene without implicit ground', async () => {
154
+ const { added } = await joined(null, { ground: { none: true } });
155
+ near(added.at.y, 1.2);
156
+ });
157
+ await test('resumed join preserves saved position, facing and flags', async () => {
158
+ const { added, snapshot } = await joined([4, 2.3, -2, 0.5]);
159
+ assert.deepEqual(added.at, { x: 4, y: 2.3, z: -2 });
160
+ near(added.translation.y, 2.3);
161
+ assert.equal(added.facing, 0.5);
162
+ assert.equal(added.movedAt, 0);
163
+ assert.equal(added.settled, false);
164
+ assert.equal(added.clamped, false);
165
+ near(snapshot.ps[0][2], 2.3);
166
+ });
167
+ await test('unreadable resumed pose uses standing spawn', async () => {
168
+ const { added } = await joined([201, 3, 0, 0]);
169
+ near(added.at.y, 0.76);
170
+ assert.equal(added.at.x, 1.1);
171
+ assert.equal(added.at.z, 0);
172
+ });
173
+ await test('other Players exports pass through unchanged', () => {
174
+ const wrapped = hubPlayers({});
175
+ assert.deepEqual(Object.keys(wrapped).sort(), Object.keys(Players).sort());
176
+ for (const key of Object.keys(Players)) {
177
+ if (key !== 'addPlayer') assert.equal(wrapped[key], Players[key], key);
178
+ }
179
+ });
180
+ await test('uninitialised hub state cannot lower a body', async () => {
181
+ globalThis.__standingActors = [spawn];
182
+ globalThis.__standingGround = {};
183
+ const sim = await World.createSimulation();
184
+ const hub = layer(config, {}, {}, () => true);
185
+ try {
186
+ hubPlayers(hub).addPlayer(sim, 'p1');
187
+ near(sim.players.get('p1').at.y, 1.2);
188
+ } finally { sim.world.free(); }
189
+ });
190
+
191
+ await test('flat-ground arrival is 0.76', () => withBoot({}, (b) => {
192
+ arrive(b);
193
+ near(b.body.at.y, 0.76);
194
+ near(b.body.body.translation().y, 0.76);
195
+ }));
196
+ await test('platform top 0.5 gives 1.26 only when below the given height', () => withBoot({ actors: [box('platform', 0.25, 0.5)] }, (b) => {
197
+ near(b.height(at(2)), 1.26);
198
+ near(b.height(at(1.2)), 1.2);
199
+ arrive(b);
200
+ near(b.body.at.y, 1.2);
201
+ }));
202
+ await test('a narrow hole rim cannot lower the body into its side', () => withBoot({ ground: { none: true }, actors: [
203
+ box('rim-left', 0.5, 1, { Transform: { x: -0.5, y: 0.5, z: 0 }, Shape: { kind: 'box', width: 0.6, height: 1, depth: 4, solid: true } }),
204
+ box('rim-right', 0.5, 1, { Transform: { x: 0.5, y: 0.5, z: 0 }, Shape: { kind: 'box', width: 0.6, height: 1, depth: 4, solid: true } }),
205
+ ] }, (b) => near(b.height(), 1.2)));
206
+ await test('support at the edge of a hole is not proved by a padded footprint', () => withBoot({ ground: { none: true }, actors: [
207
+ box('edge', -0.25, 0.5, { Transform: { x: 0.6, y: -0.25, z: 0 }, Shape: { kind: 'box', width: 0.6, height: 0.5, depth: 4, solid: true } }),
208
+ ] }, (b) => near(b.height(), 1.2)));
209
+ await test('a 45 degree slope retains the given height', () => withBoot({ actors: [
210
+ box('slope', 0.2, 0.2, { Transform: { x: 0, y: 0.2, z: 0, rotationX: 45 } }),
211
+ ] }, (b) => near(b.height(), 1.2)));
212
+ await test('tilted geometry reaching outside its upright footprint is refused', () => withBoot({ actors: [
213
+ box('tilted-wall', 1, 3, { Transform: { x: 1, y: 1, z: 0, rotationZ: 45 }, Shape: { kind: 'box', width: 0.1, height: 3, depth: 0.1, solid: true } }),
214
+ ] }, (b) => near(b.height(), 1.2)));
215
+ await test('a low ceiling blocks lowering onto a platform', () => withBoot({ actors: [
216
+ box('platform', 0.25, 0.5), box('ceiling', 1.9, 0.2),
217
+ ] }, (b) => near(b.height(at(1.8)), 1.8)));
218
+ for (const kind of ['sphere', 'dynamic', 'kinematic']) {
219
+ await test(`${kind} solid at the spot keeps the given height`, () => withBoot({ actors: [
220
+ kind === 'sphere' ? box('ball', 0.2, 0.5, { Shape: { kind: 'sphere', radius: 0.2, solid: true } })
221
+ : box('moving', 0.25, 0.5, { Body: { type: kind } }),
222
+ ] }, (b) => near(b.height(), 1.2)));
223
+ }
224
+ await test('an upright cylinder provides support', () => withBoot({ actors: [
225
+ box('cylinder', 0.25, 0.5, { Shape: { kind: 'cylinder', radius: 2, height: 0.5, solid: true } }),
226
+ ] }, (b) => near(b.height(at(2)), 1.26)));
227
+ await test('HubPad sensors and player templates provide neither obstruction nor support', () => withBoot({ actors: [
228
+ box('pad', 0.9, 0.2, { Shape: { kind: 'box', width: 3, height: 0.2, depth: 3 }, HubPad: {} }),
229
+ ] }, (b) => {
230
+ Players.addPlayer(b.sim, 'p2', [0, 0.74, 0, 0]);
231
+ near(b.height(), 0.76);
232
+ }));
233
+ await test('no support leaves the given height unchanged', () => withBoot({ ground: { none: true } }, (b) => near(b.height(), 1.2)));
234
+ await test('sphere and authored capsule use their own standing envelope', () => withBoot({}, (b) => {
235
+ b.sim.template.shape = { kind: 'sphere', radius: 0.4 };
236
+ near(b.height(), 0.46);
237
+ b.sim.template.shape = { kind: 'capsule', height: 2, radius: 0.35 };
238
+ near(b.height(), 1.06);
239
+ b.sim.template = null;
240
+ near(b.height(), 0.76);
241
+ }));
242
+ await test('the private standing proof uses actual player dimensions', () => withBoot({ actors: [box('platform', 0.25, 0.5)] }, (b) => {
243
+ near(b.height(at(2)), 1.26);
244
+ near(b.height(at(0.76)), 0.76);
245
+ }));
246
+
247
+ await test('spawn, show, hide and despawn are seen immediately after the last step', () => withBoot({ actors: [
248
+ box('template', 0.25, 0.5, { Transform: { x: 20, y: 0.25, z: 0 } }),
249
+ ] }, (b) => {
250
+ b.sim.world.step();
251
+ b.sim.world.step = () => { throw new Error('no step allowed after actor changes'); };
252
+ b.sim.world.castRay = () => { throw new Error('no physics query allowed'); };
253
+ near(b.height(at(2)), 0.76);
254
+ b.ctx.hide('template');
255
+ const copy = b.ctx.spawn('template', { x: 0, y: 0.25, z: 0 });
256
+ assert.ok(copy);
257
+ near(b.height(at(2)), 1.26);
258
+ near(b.height(), 1.2);
259
+ b.ctx.hide(copy);
260
+ near(b.height(at(2)), 0.76);
261
+ b.ctx.show(copy);
262
+ near(b.height(at(2)), 1.26);
263
+ b.ctx.despawn(copy);
264
+ near(b.height(at(2)), 0.76);
265
+ }));
266
+ await test('spawned solids at body height are also included in clearance', () => withBoot({ actors: [
267
+ box('template', 1.3, 0.2, { Transform: { x: 20, y: 1.3, z: 0 } }),
268
+ ] }, (b) => {
269
+ const copy = b.ctx.spawn('template', { x: 0, y: 1.3, z: 0 });
270
+ assert.ok(copy);
271
+ near(b.height(), 1.2);
272
+ b.ctx.hide(copy);
273
+ near(b.height(), 0.76);
274
+ }));
275
+ await test('authored solids shown and hidden after the last step are seen immediately', () => withBoot({ actors: [box('platform', 0.25, 0.5)] }, (b) => {
276
+ b.sim.world.step();
277
+ b.sim.world.step = () => { throw new Error('no step allowed'); };
278
+ b.ctx.hide('platform');
279
+ near(b.height(at(2)), 0.76);
280
+ b.ctx.show('platform');
281
+ near(b.height(at(2)), 1.26);
282
+ }));
283
+ await test('never-stepped physics state is bit-identical after standing queries', () => withBoot({ actors: [
284
+ box('moving', 0.5, 1, { Body: { type: 'dynamic' } }),
285
+ box('sleeping', 0.5, 1, { Transform: { x: 10, y: 0.5, z: 0 }, Body: { type: 'dynamic' } }),
286
+ box('pending', 0.5, 1, { Transform: { x: 20, y: 0.5, z: 0 }, Body: { type: 'kinematic' } }),
287
+ ] }, (b) => {
288
+ const moving = b.sim.bodies.get('moving');
289
+ moving.setLinvel({ x: 1, y: -2, z: 3 }, true);
290
+ const sleeping = b.sim.bodies.get('sleeping');
291
+ sleeping.sleep();
292
+ const pending = b.sim.bodies.get('pending');
293
+ pending.setNextKinematicTranslation({ x: 21, y: 4, z: 1 });
294
+ const state = () => ({ velocity: { ...moving.linvel() }, sleeping: sleeping.isSleeping(),
295
+ position: { ...pending.translation() }, target: { ...pending.nextTranslation() }, timeMs: b.sim.timeMs, timestep: b.sim.world.timestep });
296
+ const before = state();
297
+ const snapshot = b.sim.world.takeSnapshot();
298
+ b.sim.world.step = () => { throw new Error('standing height must never step'); };
299
+ b.sim.world.castRay = () => { throw new Error('standing height must never query'); };
300
+ near(b.height(), 1.2);
301
+ near(b.height({ x: 5, y: 1.2, z: 0 }), 0.76);
302
+ assert.deepEqual(state(), before);
303
+ assert.deepEqual(b.sim.world.takeSnapshot(), snapshot);
304
+ }));
305
+
306
+ await test('hub.move is checked at its completed current body pose, without further steps', () => withBoot({ actors: [
307
+ box('mover', 0.2, 0.4, { Transform: { x: 20, y: 0.2, z: 0 }, Body: { type: 'kinematic' } }),
308
+ ] }, (b) => {
309
+ near(b.height(), 0.76);
310
+ assert.equal(b.ctx.move('mover', { x: 0 }), true);
311
+ b.h.place(b.sim);
312
+ // hub.move queues a kinematic target. Apply it through the normal physics
313
+ // step once, then prove both positions without refreshing any queries.
314
+ b.sim.world.step();
315
+ near(b.sim.bodies.get('mover').translation().x, 0);
316
+ b.sim.world.step = () => { throw new Error('no step between standing proofs'); };
317
+ b.sim.world.castRay = () => { throw new Error('no scene queries'); };
318
+ near(b.height(), 1.2);
319
+ near(b.height({ x: 20, y: 1.2, z: 0 }), 0.76);
320
+ }));
321
+ await test('a body moved directly is seen at once without a physics step', () => withBoot({ actors: [
322
+ box('mover', 0.2, 0.4, { Transform: { x: 20, y: 0.2, z: 0 }, Body: { type: 'kinematic' } }),
323
+ ] }, (b) => {
324
+ b.sim.bodies.get('mover').setTranslation({ x: 0, y: 0.2, z: 0 }, true);
325
+ b.sim.world.step = () => { throw new Error('no step after a pose change'); };
326
+ near(b.height(), 1.2);
327
+ near(b.height({ x: 20, y: 1.2, z: 0 }), 0.76);
328
+ }));
329
+ await test('current body tilt overrides the authored upright Transform', () => withBoot({ actors: [
330
+ box('mover', 0.25, 0.5),
331
+ ] }, (b) => {
332
+ b.sim.bodies.get('mover').setRotation({ x: Math.sin(Math.PI / 8), y: 0, z: 0, w: Math.cos(Math.PI / 8) }, true);
333
+ b.sim.world.step = () => { throw new Error('no step after rotation'); };
334
+ near(b.height(at(2)), 2);
335
+ }));
336
+ await test('current body yaw is used for a narrow box footprint', () => withBoot({ actors: [
337
+ box('bar', 0.2, 0.4, { Shape: { kind: 'box', width: 4, height: 0.4, depth: 0.1, solid: true } }),
338
+ ] }, (b) => {
339
+ const body = b.sim.bodies.get('bar');
340
+ near(b.height({ x: 0, y: 1.2, z: 1.2 }), 0.76);
341
+ body.setRotation({ x: 0, y: Math.sin(Math.PI / 4), z: 0, w: Math.cos(Math.PI / 4) }, true);
342
+ b.sim.world.step = () => { throw new Error('no step after yaw change'); };
343
+ near(b.height({ x: 0, y: 1.2, z: 1.2 }), 1.16);
344
+ near(b.height({ x: 1.2, y: 1.2, z: 0 }), 0.76);
345
+ }));
346
+ await test('a low kinematic platform is never support', () => withBoot({ actors: [
347
+ box('platform', 0.25, 0.5, { Body: { type: 'kinematic' } }),
348
+ ] }, (b) => near(b.height(at(2)), 2)));
349
+ for (const kind of ['high sphere', 'kinematic ceiling']) {
350
+ const roof = kind === 'high sphere'
351
+ ? box('roof', 10, 12, { Shape: { kind: 'sphere', radius: 6, solid: true } })
352
+ : box('roof', 4, 0.5, { Shape: { kind: 'box', width: 20, height: 0.5, depth: 20, solid: true }, Body: { type: 'kinematic' } });
353
+ await test(`${kind} leaves standing height and hub-goto unchanged`, () => withBoot({ actors: [roof] }, (b) => {
354
+ near(b.height(), 0.76);
355
+ // Bring both players through the real hub arrival path so hub-goto can
356
+ // act. Their initially separate positions make a silently refused goto
357
+ // distinguishable from a successful friend placement.
358
+ Players.addPlayer(b.sim, 'p2');
359
+ b.session.players.push({ playerId: 'p2', userId: '102', username: 'bo' });
360
+ for (const player of b.session.players) {
361
+ b.h.message(b.session, player, { k: 'hub-hello', avatar: 1 });
362
+ }
363
+ b.h.place(b.sim);
364
+ b.ctx.placeAt('p1', { x: -15, y: 1.2, z: 0 });
365
+ b.ctx.placeAt('p2', { x: 0, y: 0.76, z: 0 });
366
+ b.h.message(b.session, { playerId: 'p1' }, { k: 'hub-goto', player: 'p2' });
367
+ near(b.body.at.x, 1.6);
368
+ near(b.body.at.z, 0);
369
+ near(b.body.at.y, 0.76);
370
+ }));
371
+ await test(`${kind} leaves arrival beside a friend unchanged`, () => withBoot({ actors: [roof] }, (b) => {
372
+ Players.addPlayer(b.sim, 'p2');
373
+ b.session.players.push({ playerId: 'p2', userId: '102', username: 'bo' });
374
+ b.h.message(b.session, b.session.players[1], { k: 'hub-hello', avatar: 1 });
375
+ b.h.place(b.sim);
376
+ b.ctx.placeAt('p2', { x: 0, y: 0.76, z: 0 });
377
+ b.h.message(b.session, b.session.players[0], { k: 'hub-hello', avatar: 1, near: '102' });
378
+ b.h.place(b.sim);
379
+ near(b.body.at.x, 1.6);
380
+ near(b.body.at.z, 0);
381
+ near(b.body.at.y, 0.76);
382
+ }));
383
+ }
384
+
385
+ await test('door jump and its settle re-pin use the same standing height', () => withBoot({}, (b) => {
386
+ b.h.message(b.session, { playerId: 'p1' }, { k: 'hub-door-jump', door: 'race' });
387
+ near(b.body.at.y, 0.76);
388
+ const placed = { ...b.body.at };
389
+ b.body.at = { x: placed.x + 2, y: 1.2, z: placed.z };
390
+ b.h.place(b.sim);
391
+ assert.deepEqual(b.body.at, placed);
392
+ near(b.body.body.translation().y, 0.76);
393
+ }));
394
+ await test('explicit place and hold heights stay unchanged', () => withBoot({}, (b) => {
395
+ b.ctx.placeAt('p1', at(2.3));
396
+ near(b.body.at.y, 2.3);
397
+ b.ctx.hold('p1', at(1.7));
398
+ near(b.body.at.y, 1.7);
399
+ }));
400
+ for (const y of [undefined, 1.8]) {
401
+ await test(`unstick ${y === undefined ? 'default' : 'explicit'} height`, () => withBoot({ hooks: {
402
+ unstick: () => ({ x: 5, z: 0, ...(y === undefined ? {} : { y }) }),
403
+ } }, (b) => {
404
+ arrive(b);
405
+ b.h.message(b.session, { playerId: 'p1' }, { k: 'hub-unstick' });
406
+ near(b.body.at.y, y ?? 0.76);
407
+ }));
408
+ }
409
+ await test('party placement uses the same standing rule', () => withBoot({}, (b) => {
410
+ const state = { sim: b.sim, held: new Map(), actors: [], hidden: new Set(), session: b.session };
411
+ Party.toPad({ h: state, standingY, stand() {}, front: () => ({ x: 10, z: 0 }),
412
+ placeAt(h, id, point) { b.ctx.placeAt(id, point); },
413
+ }, 'p1', { id: 'race', t: door.components.Transform }, 0);
414
+ near(b.body.at.y, 0.76);
415
+ }));
416
+ console.log(`standing: ${n} tests passed`);