castle-web-cli 0.4.232 → 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 (355) 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/shell/assets/{index-D2tWM896.js → index-BjOxR-lW.js} +4 -4
  28. package/dist/shell/assets/index-MVLfNYd9.css +1 -0
  29. package/dist/shell/index.html +2 -2
  30. package/dist/taskSteer.d.ts +13 -0
  31. package/dist/taskSteer.js +22 -2
  32. package/kits/base/castle.json +1 -1
  33. package/kits/base/package-lock.json +1 -1
  34. package/kits/base/sdk/README.md +79 -2
  35. package/kits/base/sdk/avatar.d.ts +6 -2
  36. package/kits/base/sdk/avatar.js +12 -4
  37. package/kits/base/sdk/castle.d.ts +1 -1
  38. package/kits/base/sdk/commands.d.ts +14 -0
  39. package/kits/base/sdk/hub.d.ts +6 -2
  40. package/kits/base/sdk/hub.js +13 -0
  41. package/kits/base/sdk/multiplayer.js +17 -1
  42. package/kits/base/sdk/save.js +2 -1
  43. package/kits/base/sdk/server/hub.d.ts +87 -0
  44. package/kits/base/sdk/server/hub.js +70 -0
  45. package/kits/base/sdk/server/platformHandle.d.ts +31 -1
  46. package/kits/base/sdk/server/storage.d.ts +13 -0
  47. package/kits/base/sdk/server/storage.js +46 -0
  48. package/kits/base/sdk/server/wrapper.d.ts +36 -5
  49. package/kits/base/sdk/server/wrapper.js +83 -8
  50. package/kits/hub-game/CLAUDE.md +329 -11
  51. package/kits/hub-game/blueprints/avatar-10.scene +28 -0
  52. package/kits/hub-game/blueprints/avatar-11.scene +28 -0
  53. package/kits/hub-game/blueprints/avatar-12.scene +28 -0
  54. package/kits/hub-game/blueprints/avatar-13.scene +28 -0
  55. package/kits/hub-game/blueprints/avatar-14.scene +28 -0
  56. package/kits/hub-game/blueprints/avatar-15.scene +28 -0
  57. package/kits/hub-game/blueprints/avatar-4.scene +28 -0
  58. package/kits/hub-game/blueprints/avatar-5.scene +28 -0
  59. package/kits/hub-game/blueprints/avatar-6.scene +28 -0
  60. package/kits/hub-game/blueprints/avatar-7.scene +28 -0
  61. package/kits/hub-game/blueprints/avatar-8.scene +28 -0
  62. package/kits/hub-game/blueprints/avatar-9.scene +28 -0
  63. package/kits/hub-game/code/client/actorBudget.js +47 -0
  64. package/kits/hub-game/code/client/attention.js +11 -2
  65. package/kits/hub-game/code/client/avatar.js +309 -35
  66. package/kits/hub-game/code/client/avatarCap.js +228 -0
  67. package/kits/hub-game/code/client/avatarColors.js +70 -0
  68. package/kits/hub-game/code/client/avatarFaces.js +21 -0
  69. package/kits/hub-game/code/client/avatarShare.js +251 -0
  70. package/kits/hub-game/code/client/ballot.js +467 -0
  71. package/kits/hub-game/code/client/build.js +22 -0
  72. package/kits/hub-game/code/client/chrome.js +1144 -50
  73. package/kits/hub-game/code/client/companion.js +716 -0
  74. package/kits/hub-game/code/client/companionDress.js +99 -0
  75. package/kits/hub-game/code/client/decor.js +509 -0
  76. package/kits/hub-game/code/client/earned.js +131 -0
  77. package/kits/hub-game/code/client/emoteBubble.js +75 -0
  78. package/kits/hub-game/code/client/grab.js +339 -20
  79. package/kits/hub-game/code/client/hookLayer.js +299 -13
  80. package/kits/hub-game/code/client/idle.js +163 -22
  81. package/kits/hub-game/code/client/interestCap.js +81 -0
  82. package/kits/hub-game/code/client/keys.js +36 -0
  83. package/kits/hub-game/code/client/labelsNear.js +205 -0
  84. package/kits/hub-game/code/client/menuIcons.js +34 -0
  85. package/kits/hub-game/code/client/pack.js +6 -2
  86. package/kits/hub-game/code/client/packFormat.js +3 -3
  87. package/kits/hub-game/code/client/rehello.js +167 -0
  88. package/kits/hub-game/code/client/shot.js +92 -0
  89. package/kits/hub-game/code/client/sound.js +63 -8
  90. package/kits/hub-game/code/client/soundscape.js +1151 -0
  91. package/kits/hub-game/code/client/soundscapeActions.js +99 -0
  92. package/kits/hub-game/code/client/soundscapeAmbience.js +453 -0
  93. package/kits/hub-game/code/client/soundscapeBaked.js +143 -0
  94. package/kits/hub-game/code/client/soundscapeBusker.js +217 -0
  95. package/kits/hub-game/code/client/soundscapeCourt.js +200 -0
  96. package/kits/hub-game/code/client/soundscapeCrowd.js +331 -0
  97. package/kits/hub-game/code/client/soundscapeCues.js +362 -0
  98. package/kits/hub-game/code/client/soundscapeMap.js +181 -0
  99. package/kits/hub-game/code/client/soundscapeMarket.js +176 -0
  100. package/kits/hub-game/code/client/soundscapeMusic.js +126 -0
  101. package/kits/hub-game/code/client/soundscapeMusicEngine.js +460 -0
  102. package/kits/hub-game/code/client/soundscapeSimlish.js +737 -0
  103. package/kits/hub-game/code/client/soundscapeSongs.js +127 -0
  104. package/kits/hub-game/code/client/soundscapeSongsRound3.js +63 -0
  105. package/kits/hub-game/code/client/soundscapeSynthesis.js +168 -0
  106. package/kits/hub-game/code/client/soundscapeUi.js +211 -0
  107. package/kits/hub-game/code/client/soundscapeVoice.js +1209 -0
  108. package/kits/hub-game/code/client/soundscapeWaves.js +206 -0
  109. package/kits/hub-game/code/client/spin.js +101 -0
  110. package/kits/hub-game/code/client/state.js +109 -1
  111. package/kits/hub-game/code/client/stuck.js +259 -0
  112. package/kits/hub-game/code/client/talk.js +538 -47
  113. package/kits/hub-game/code/client/tiers.js +516 -27
  114. package/kits/hub-game/code/client/toastBand.js +37 -0
  115. package/kits/hub-game/code/client/together.js +32 -0
  116. package/kits/hub-game/code/client/visibility.js +43 -0
  117. package/kits/hub-game/code/client/wear.js +461 -170
  118. package/kits/hub-game/code/client/yours.js +199 -0
  119. package/kits/hub-game/code/companionSpec.js +45 -0
  120. package/kits/hub-game/code/privateText.js +7 -0
  121. package/kits/hub-game/code/server/actions.js +133 -0
  122. package/kits/hub-game/code/server/actors.js +9 -1
  123. package/kits/hub-game/code/server/ask.js +155 -0
  124. package/kits/hub-game/code/server/ballot.js +539 -0
  125. package/kits/hub-game/code/server/cells.js +100 -0
  126. package/kits/hub-game/code/server/companion.js +82 -0
  127. package/kits/hub-game/code/server/cues.js +70 -0
  128. package/kits/hub-game/code/server/decor.js +269 -0
  129. package/kits/hub-game/code/server/earned.js +461 -0
  130. package/kits/hub-game/code/server/friendBests.js +166 -0
  131. package/kits/hub-game/code/server/friendsAmong.js +232 -0
  132. package/kits/hub-game/code/server/history.js +5 -0
  133. package/kits/hub-game/code/server/hub.js +1254 -50
  134. package/kits/hub-game/code/server/idle.js +30 -11
  135. package/kits/hub-game/code/server/index.js +2 -2
  136. package/kits/hub-game/code/server/labels.js +28 -2
  137. package/kits/hub-game/code/server/manifest.js +378 -7
  138. package/kits/hub-game/code/server/menu.js +133 -0
  139. package/kits/hub-game/code/server/npcs.js +830 -80
  140. package/kits/hub-game/code/server/party.js +2 -2
  141. package/kits/hub-game/code/server/players.js +22 -0
  142. package/kits/hub-game/code/server/shot.js +110 -0
  143. package/kits/hub-game/code/server/standing.js +124 -0
  144. package/kits/hub-game/code/server/vis.js +113 -0
  145. package/kits/hub-game/code/server/wear.js +12 -0
  146. package/kits/hub-game/code/server/yours.js +59 -0
  147. package/kits/hub-game/code/shared/cues.js +9 -0
  148. package/kits/hub-game/code/shared/decor.js +41 -0
  149. package/kits/hub-game/code/shared/shot.js +19 -0
  150. package/kits/hub-game/code/shared/spin.js +57 -0
  151. package/kits/hub-game/code/systems/hub.js +845 -95
  152. package/kits/hub-game/docs/content-pack.md +1 -1
  153. package/kits/hub-game/docs/contract.md +2244 -61
  154. package/kits/hub-game/docs/home-pieces.md +64 -0
  155. package/kits/hub-game/models/avatar-10.pxmodel +28 -0
  156. package/kits/hub-game/models/avatar-11.pxmodel +28 -0
  157. package/kits/hub-game/models/avatar-12.pxmodel +27 -0
  158. package/kits/hub-game/models/avatar-13.pxmodel +24 -0
  159. package/kits/hub-game/models/avatar-14.pxmodel +29 -0
  160. package/kits/hub-game/models/avatar-15.pxmodel +24 -0
  161. package/kits/hub-game/models/avatar-4.pxmodel +29 -0
  162. package/kits/hub-game/models/avatar-5.pxmodel +27 -0
  163. package/kits/hub-game/models/avatar-6.pxmodel +26 -0
  164. package/kits/hub-game/models/avatar-7.pxmodel +25 -0
  165. package/kits/hub-game/models/avatar-8.pxmodel +24 -0
  166. package/kits/hub-game/models/avatar-9.pxmodel +30 -0
  167. package/kits/hub-game/models/earned/badge-round.pxmodel +100 -0
  168. package/kits/hub-game/models/earned/badge-shield.pxmodel +117 -0
  169. package/kits/hub-game/models/earned/badge-star.pxmodel +87 -0
  170. package/kits/hub-game/models/earned/belt-plain.pxmodel +72 -0
  171. package/kits/hub-game/models/earned/held-ball.pxmodel +43 -0
  172. package/kits/hub-game/models/earned/held-lantern.pxmodel +85 -0
  173. package/kits/hub-game/models/earned/held-net.pxmodel +57 -0
  174. package/kits/hub-game/models/earned/held-trophy.pxmodel +109 -0
  175. package/kits/hub-game/models/earned/pin-round.pxmodel +62 -0
  176. package/kits/hub-game/models/earned/sash-plain.pxmodel +66 -0
  177. package/kits/hub-game/models/earned/square/belt-plain.pxmodel +104 -0
  178. package/kits/hub-game/models/earned/square/sash-plain.pxmodel +98 -0
  179. package/kits/hub-game/models/hats/bat-clip.pxmodel +206 -0
  180. package/kits/hub-game/models/hats/beekeeper.pxmodel +149 -0
  181. package/kits/hub-game/models/hats/cap.pxmodel +162 -0
  182. package/kits/hub-game/models/hats/captain.pxmodel +178 -0
  183. package/kits/hub-game/models/hats/crooked-top.pxmodel +172 -0
  184. package/kits/hub-game/models/hats/flower-crown.pxmodel +451 -0
  185. package/kits/hub-game/models/hats/foam-crown.pxmodel +179 -0
  186. package/kits/hub-game/models/hats/lantern.pxmodel +230 -0
  187. package/kits/hub-game/models/hats/laurel.pxmodel +533 -0
  188. package/kits/hub-game/models/hats/lighthouse.pxmodel +96 -0
  189. package/kits/hub-game/models/hats/sailor.pxmodel +141 -0
  190. package/kits/hub-game/models/hats/souwester.pxmodel +131 -0
  191. package/kits/hub-game/models/hats/straw.pxmodel +139 -0
  192. package/kits/hub-game/models/hats/sunflower.pxmodel +406 -0
  193. package/kits/hub-game/models/hats/sweatband.pxmodel +112 -0
  194. package/kits/hub-game/models/hats/witch.pxmodel +147 -0
  195. package/kits/hub-game/package-lock.json +2 -0
  196. package/kits/hub-game/package.json +2 -1
  197. package/kits/hub-game/scripts/check.mjs +78 -11
  198. package/kits/hub-game/scripts/companion-follower-wire.json +1 -0
  199. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +121 -0
  200. package/kits/hub-game/scripts/fixtures/decor-keyless.json +293 -0
  201. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +23 -0
  202. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +107 -0
  203. package/kits/hub-game/scripts/fixtures/interest-legacy.json +385 -0
  204. package/kits/hub-game/scripts/fixtures/npc-notes-v1.77.jsonl +4 -0
  205. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -0
  206. package/kits/hub-game/scripts/gen-avatars.mjs +933 -16
  207. package/kits/hub-game/scripts/gen-earned.mjs +285 -0
  208. package/kits/hub-game/scripts/gen-hats.mjs +827 -0
  209. package/kits/hub-game/scripts/grab.before-orbit.mjs +400 -0
  210. package/kits/hub-game/scripts/soundscape-wave-analysis.mjs +125 -0
  211. package/kits/hub-game/scripts/test-actions-client.mjs +488 -0
  212. package/kits/hub-game/scripts/test-actions.mjs +298 -0
  213. package/kits/hub-game/scripts/test-actor-budget.mjs +44 -0
  214. package/kits/hub-game/scripts/test-actors.mjs +19 -17
  215. package/kits/hub-game/scripts/test-ask-client.mjs +358 -0
  216. package/kits/hub-game/scripts/test-ask.mjs +269 -0
  217. package/kits/hub-game/scripts/test-attention.mjs +10 -1
  218. package/kits/hub-game/scripts/test-avatar-cap.mjs +379 -0
  219. package/kits/hub-game/scripts/test-avatar-colors.mjs +72 -0
  220. package/kits/hub-game/scripts/test-avatar-models.mjs +181 -0
  221. package/kits/hub-game/scripts/test-avatar-share.mjs +318 -0
  222. package/kits/hub-game/scripts/test-avatar-wire.mjs +753 -0
  223. package/kits/hub-game/scripts/test-avatar.mjs +540 -7
  224. package/kits/hub-game/scripts/test-ballot.mjs +1001 -0
  225. package/kits/hub-game/scripts/test-build.mjs +31 -0
  226. package/kits/hub-game/scripts/test-cells.mjs +71 -0
  227. package/kits/hub-game/scripts/test-chat.mjs +662 -0
  228. package/kits/hub-game/scripts/test-classic.mjs +2 -0
  229. package/kits/hub-game/scripts/test-companion-chat.mjs +198 -0
  230. package/kits/hub-game/scripts/test-companion-client.mjs +1167 -0
  231. package/kits/hub-game/scripts/test-companion.mjs +259 -0
  232. package/kits/hub-game/scripts/test-decor-client.mjs +303 -0
  233. package/kits/hub-game/scripts/test-decor.mjs +457 -0
  234. package/kits/hub-game/scripts/test-earned-client.mjs +459 -0
  235. package/kits/hub-game/scripts/test-earned.mjs +1194 -0
  236. package/kits/hub-game/scripts/test-emote-bubble.mjs +110 -0
  237. package/kits/hub-game/scripts/test-friend-bests.mjs +435 -0
  238. package/kits/hub-game/scripts/test-grab-orbit.mjs +918 -0
  239. package/kits/hub-game/scripts/test-grab.mjs +7 -0
  240. package/kits/hub-game/scripts/test-hats.mjs +422 -168
  241. package/kits/hub-game/scripts/test-hub-leaving.mjs +203 -0
  242. package/kits/hub-game/scripts/test-hub-ops.mjs +439 -2
  243. package/kits/hub-game/scripts/test-hub-trip.mjs +716 -2
  244. package/kits/hub-game/scripts/test-hud-clear.mjs +328 -4
  245. package/kits/hub-game/scripts/test-idle.mjs +361 -1
  246. package/kits/hub-game/scripts/test-interest-cap.mjs +36 -0
  247. package/kits/hub-game/scripts/test-interest-cells.mjs +493 -0
  248. package/kits/hub-game/scripts/test-interest-client.mjs +118 -0
  249. package/kits/hub-game/scripts/test-keys.mjs +46 -1
  250. package/kits/hub-game/scripts/test-labels.mjs +596 -0
  251. package/kits/hub-game/scripts/test-manifest.mjs +207 -0
  252. package/kits/hub-game/scripts/test-menu-client.mjs +480 -0
  253. package/kits/hub-game/scripts/test-menu.mjs +296 -0
  254. package/kits/hub-game/scripts/test-npcs.mjs +1718 -12
  255. package/kits/hub-game/scripts/test-object-entry.mjs +76 -0
  256. package/kits/hub-game/scripts/test-pack.mjs +7 -0
  257. package/kits/hub-game/scripts/test-picker.mjs +314 -0
  258. package/kits/hub-game/scripts/test-rehello.mjs +1039 -0
  259. package/kits/hub-game/scripts/test-relations-among.mjs +222 -0
  260. package/kits/hub-game/scripts/test-relations-refresh.mjs +188 -0
  261. package/kits/hub-game/scripts/test-shot.mjs +756 -0
  262. package/kits/hub-game/scripts/test-soundscape.mjs +5432 -0
  263. package/kits/hub-game/scripts/test-spin.mjs +314 -0
  264. package/kits/hub-game/scripts/test-standing.mjs +416 -0
  265. package/kits/hub-game/scripts/test-stuck.mjs +1903 -0
  266. package/kits/hub-game/scripts/test-tier-cells.mjs +706 -0
  267. package/kits/hub-game/scripts/test-tiers-render.mjs +339 -0
  268. package/kits/hub-game/scripts/test-tiers.mjs +477 -2
  269. package/kits/hub-game/scripts/test-toast-band.mjs +61 -0
  270. package/kits/hub-game/scripts/test-try-on.mjs +22 -22
  271. package/kits/hub-game/scripts/test-vis.mjs +343 -0
  272. package/kits/hub-game/scripts/test-visibility.mjs +134 -0
  273. package/kits/hub-game/scripts/test-yours-chrome.mjs +166 -0
  274. package/kits/hub-game/scripts/test-yours.mjs +372 -0
  275. package/kits/multiplayer-3d/CLAUDE.md +50 -0
  276. package/kits/multiplayer-3d/castle.json +5 -5
  277. package/kits/multiplayer-3d/code/client/avatars.js +7 -0
  278. package/kits/multiplayer-3d/code/client/gait.js +65 -0
  279. package/kits/multiplayer-3d/code/client/nameTags.js +59 -4
  280. package/kits/multiplayer-3d/code/options.js +5 -0
  281. package/kits/multiplayer-3d/code/server/ownership.js +10 -2
  282. package/kits/multiplayer-3d/code/server/sceneBodies.js +12 -0
  283. package/kits/multiplayer-3d/code/server/world.js +7 -0
  284. package/kits/multiplayer-3d/code/systems/multiplayer.js +74 -4
  285. package/kits/multiplayer-3d/package.json +2 -1
  286. package/kits/multiplayer-3d/scripts/fixtures/README.md +11 -0
  287. package/kits/multiplayer-3d/scripts/fixtures/ownership-legacy.json +2 -0
  288. package/kits/multiplayer-3d/scripts/ownership-harness.mjs +102 -0
  289. package/kits/multiplayer-3d/scripts/ownership-loader.mjs +46 -0
  290. package/kits/multiplayer-3d/scripts/ownership-worker.mjs +15 -0
  291. package/kits/multiplayer-3d/scripts/record-ownership-session.mjs +98 -0
  292. package/kits/multiplayer-3d/scripts/test-eligible-claims.mjs +167 -0
  293. package/kits/multiplayer-3d/scripts/test-own-name-tag.mjs +247 -0
  294. package/kits/physics-2d/CLAUDE.md +9 -0
  295. package/kits/physics-2d/castle.json +2 -2
  296. package/kits/physics-2d/engine/scene.js +253 -1
  297. package/kits/physics-2d/engine/skyKey.js +129 -0
  298. package/kits/physics-2d/engine/stillClock.js +106 -0
  299. package/kits/physics-2d/engine/updateBudget.js +21 -0
  300. package/kits/physics-2d/scripts/test-skip-unchanged.mjs +326 -1
  301. package/kits/physics-3d/CLAUDE.md +1169 -30
  302. package/kits/physics-3d/behaviors/Player.jsx +629 -72
  303. package/kits/physics-3d/castle.json +3 -3
  304. package/kits/physics-3d/docs/pxmodel-format.md +8 -0
  305. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +69 -13
  306. package/kits/physics-3d/engine3d/actornode.js +86 -0
  307. package/kits/physics-3d/engine3d/animationBudget.js +23 -0
  308. package/kits/physics-3d/engine3d/editorWorld.js +6 -0
  309. package/kits/physics-3d/engine3d/emptynodes.js +232 -0
  310. package/kits/physics-3d/engine3d/framecap.js +96 -0
  311. package/kits/physics-3d/engine3d/gait.js +118 -0
  312. package/kits/physics-3d/engine3d/kithooks.js +47 -0
  313. package/kits/physics-3d/engine3d/look.js +507 -48
  314. package/kits/physics-3d/engine3d/lookbake.js +208 -0
  315. package/kits/physics-3d/engine3d/materialpresets.js +2 -0
  316. package/kits/physics-3d/engine3d/motion.js +39 -10
  317. package/kits/physics-3d/engine3d/nearshadows.js +37 -19
  318. package/kits/physics-3d/engine3d/optimize.js +9 -5
  319. package/kits/physics-3d/engine3d/orbitinput.js +487 -9
  320. package/kits/physics-3d/engine3d/orbitlens.js +48 -0
  321. package/kits/physics-3d/engine3d/ownmodel.js +213 -0
  322. package/kits/physics-3d/engine3d/pxmodel.js +42 -11
  323. package/kits/physics-3d/engine3d/shadowfade.js +882 -0
  324. package/kits/physics-3d/engine3d/sky.js +547 -0
  325. package/kits/physics-3d/engine3d/skylife.js +306 -0
  326. package/kits/physics-3d/engine3d/unchanged.js +11 -0
  327. package/kits/physics-3d/engine3d/viewrange.js +52 -0
  328. package/kits/physics-3d/engine3d/world3d.js +796 -69
  329. package/kits/physics-3d/main.jsx +5 -0
  330. package/kits/physics-3d/package.json +1 -1
  331. package/kits/physics-3d/scripts/look-baseline.mjs +155 -0
  332. package/kits/physics-3d/scripts/test-camera-orbit.mjs +2563 -80
  333. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +1 -1
  334. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +435 -0
  335. package/kits/physics-3d/scripts/test-frame-cap.mjs +452 -0
  336. package/kits/physics-3d/scripts/test-gait.mjs +387 -0
  337. package/kits/physics-3d/scripts/test-look-bake.mjs +1056 -0
  338. package/kits/physics-3d/scripts/test-model-parse-cache.mjs +92 -0
  339. package/kits/physics-3d/scripts/test-near-shadows.mjs +3 -0
  340. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +1920 -0
  341. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +545 -0
  342. package/kits/physics-3d/scripts/test-orbit-shot.mjs +583 -0
  343. package/kits/physics-3d/scripts/test-orbit-view.mjs +230 -0
  344. package/kits/physics-3d/scripts/test-skip-empty-nodes.mjs +845 -0
  345. package/kits/physics-3d/scripts/test-sky.mjs +2470 -0
  346. package/kits/physics-3d/scripts/test-static-actors.mjs +8 -1
  347. package/kits/physics-3d/scripts/test-static-scenery.mjs +2171 -0
  348. package/kits/physics-3d/scripts/test-steady-hover.mjs +2 -0
  349. package/kits/physics-3d/scripts/test-view-range.mjs +260 -0
  350. package/kits/physics-3d/systems/physics3d.js +383 -6
  351. package/kits/real-time/castle.json +2 -2
  352. package/kits/real-time/code/server/gameHooks.js +7 -0
  353. package/kits/real-time/code/server/session.js +97 -19
  354. package/package.json +2 -2
  355. package/dist/shell/assets/index-Cf61cNfT.css +0 -1
@@ -8,6 +8,11 @@
8
8
 
9
9
  import assert from 'node:assert/strict';
10
10
  import { register } from 'node:module';
11
+ import fs from 'node:fs';
12
+ import os from 'node:os';
13
+ import path from 'node:path';
14
+ import { Group, Vector3 } from 'three';
15
+ import check from './check.mjs';
11
16
 
12
17
  const sceneStub = 'export const readScene = () => globalThis.__hubTestActors ?? [];';
13
18
  register(
@@ -24,6 +29,8 @@ const { layer } = await import('../code/server/hub.js');
24
29
  const Idle = await import('../code/server/idle.js');
25
30
  const Manifest = await import('../code/server/manifest.js');
26
31
  const ClientIdle = await import('../code/client/idle.js');
32
+ const { hub: clientHub, clear: clearClient } = await import('../code/client/state.js');
33
+ const { CUE_NAMES } = await import('../code/server/cues.js');
27
34
 
28
35
  const bench = { kind: 'box', width: 2.4, height: 0.5, depth: 0.6 };
29
36
  globalThis.__hubTestActors = [
@@ -48,6 +55,7 @@ function boot(options = {}) {
48
55
  hub: {
49
56
  contract: 1,
50
57
  title: 'Town',
58
+ ...(options.soundscape === undefined ? {} : { soundscape: options.soundscape }),
51
59
  ...(idle === undefined ? {} : { idle }),
52
60
  places: { game: { title: 'Game', scene: 'scenes/game.scene', result: {} } },
53
61
  },
@@ -75,7 +83,7 @@ function boot(options = {}) {
75
83
  ['p1', body()],
76
84
  ['p2', body()],
77
85
  ]),
78
- bodies: new Map(),
86
+ bodies: new Map(options.bodies ?? []),
79
87
  objects: new Map(),
80
88
  scenePath: 'scenes/main.scene',
81
89
  };
@@ -84,6 +92,13 @@ function boot(options = {}) {
84
92
  h.message(session, p, { k: 'hub-hello', avatar: 0, party: 2 });
85
93
  }
86
94
  h.place(world);
95
+ // (and the moment an arrival is kept where it was put, v1.40, is over)
96
+ {
97
+ const realNow = Date.now;
98
+ Date.now = () => realNow() + 700;
99
+ h.place(world);
100
+ Date.now = realNow;
101
+ }
87
102
  for (const p of world.players.values()) {
88
103
  p.at = { x: 0, y: 1, z: 0 };
89
104
  }
@@ -111,6 +126,100 @@ function test(name, fn) {
111
126
  n += 1;
112
127
  }
113
128
 
129
+ test('cue: chosen names, private delivery and actor broadcasts need explicit opt-in', () => {
130
+ const { hub, sent, broadcasts } = boot({ soundscape: { cues: true } });
131
+ const from = sent.length;
132
+ assert.equal(hub.cue({ player: 'p1' }, 'token'), true);
133
+ assert.deepEqual(sent.slice(from), [['p1', { k: 'hub-cue', cue: 'token' }]]);
134
+ assert.equal(hub.cue({ actor: 'lamp' }, 'kick'), true);
135
+ assert.deepEqual(broadcasts.at(-1), { k: 'hub-cue', cue: 'kick', actor: 'lamp', radius: 12 });
136
+ assert.equal(hub.cue({ actor: 'jukebox', radius: 60 }, 'pad-go'), true);
137
+ assert.equal(broadcasts.at(-1).radius, 60);
138
+ assert.ok(Object.isFrozen(CUE_NAMES));
139
+ for (const soundscape of [undefined, true, false, { cues: false }]) {
140
+ const r = boot({ soundscape });
141
+ const before = r.sent.length;
142
+ assert.equal(r.hub.cue({ player: 'p1' }, 'goal'), false);
143
+ assert.equal(r.hub.cue({ actor: 'lamp' }, 'goal'), false);
144
+ assert.equal(r.sent.length, before);
145
+ assert.equal(r.broadcasts.length, 0);
146
+ }
147
+ });
148
+
149
+ test('cue: all four court names deliver privately or near an actor with the existing API', () => {
150
+ const r = boot({ soundscape: { cues: true } });
151
+ const names = ['court-chime', 'court-bell', 'court-splash', 'court-flutter'];
152
+ assert.deepEqual(CUE_NAMES.filter((name) => name.startsWith('court-')), names);
153
+ const from = r.sent.length;
154
+ for (const name of names) {
155
+ assert.equal(r.hub.cue({ player: 'p1' }, name), true);
156
+ assert.equal(r.hub.cue({ actor: 'lamp' }, name), true);
157
+ }
158
+ assert.deepEqual(r.sent.slice(from), names.map((cue) => ['p1', { k: 'hub-cue', cue }]));
159
+ assert.deepEqual(r.broadcasts, names.map((cue) => ({ k: 'hub-cue', cue, actor: 'lamp', radius: 12 })));
160
+ });
161
+
162
+ test('v1.60: both busker names use the existing opt-in, validation and budgets', () => {
163
+ const r = boot({ soundscape: { cues: true } });
164
+ const names = ['busker-jig', 'busker-waltz'];
165
+ assert.deepEqual(CUE_NAMES.slice(-2), names);
166
+ const from = r.sent.length;
167
+ for (const name of names) {
168
+ assert.equal(r.hub.cue({ player: 'p1' }, name), true);
169
+ assert.equal(r.hub.cue({ actor: 'lamp', radius: 20 }, name), true);
170
+ assert.equal(r.hub.cue({ actor: 'lamp', radius: 61 }, name), false);
171
+ assert.equal(r.hub.cue({ player: 'missing' }, name), false);
172
+ for (const soundscape of [undefined, true, { cues: false }]) {
173
+ assert.equal(boot({ soundscape }).hub.cue({ actor: 'lamp' }, name), false);
174
+ }
175
+ }
176
+ assert.deepEqual(r.sent.slice(from), names.map((cue) => ['p1', { k: 'hub-cue', cue }]));
177
+ assert.deepEqual(r.broadcasts, names.map((cue) => ({ k: 'hub-cue', cue, actor: 'lamp', radius: 20 })));
178
+ for (let i = 0; i < 4; i += 1) { assert.equal(r.hub.cue({ actor: 'lamp' }, names[i % 2]), true); }
179
+ assert.equal(r.hub.cue({ actor: 'lamp' }, names[0]), false, 'same six-token actor bucket');
180
+ });
181
+
182
+ test('cue: malformed targets, names, disconnected players and radii send nothing, warn once and never throw', () => {
183
+ const r = boot({ soundscape: { cues: true } });
184
+ const from = r.sent.length;
185
+ for (const target of [null, [], 'p1', {}, { player: 'missing' }, { actor: 'missing' }, { player: 'p1', actor: 'lamp' }, { player: 'p1', radius: 12 }, { actor: 'lamp', extra: 1 }, Object.create({ player: 'p1' }), { player: Symbol('bad') }, { get actor() { throw new Error('bad'); } }]) {
186
+ assert.equal(r.hub.cue(target, 'kick'), false);
187
+ }
188
+ for (const name of ['unknown', 'constructor', '__proto__', 'toString', null, 1, Symbol('bad')]) {
189
+ assert.equal(r.hub.cue({ player: 'p1' }, name), false);
190
+ }
191
+ for (const radius of [0, 61, NaN, Infinity, null, '12']) {
192
+ assert.equal(r.hub.cue({ actor: 'lamp', radius }, 'kick'), false);
193
+ }
194
+ r.session.players = r.session.players.filter((p) => p.playerId !== 'p2');
195
+ assert.equal(r.hub.cue({ player: 'p2' }, 'kick'), false, 'disconnected even before the next simulation reconciliation');
196
+ r.world.players.delete('p1');
197
+ assert.equal(r.hub.cue({ player: 'p1' }, 'kick'), false);
198
+ assert.equal(r.sent.length, from);
199
+ assert.equal(r.broadcasts.length, 0);
200
+ const before = warned.length;
201
+ assert.equal(r.hub.cue({ actor: 'missing' }, 'kick'), false);
202
+ assert.equal(warned.length, before, 'same refusal does not warn twice');
203
+ });
204
+
205
+ test('cue: player buckets are independent and all actor broadcasts share a six-per-second budget', () => {
206
+ const r = boot({ soundscape: { cues: true } });
207
+ for (let i = 0; i < 6; i += 1) {
208
+ assert.equal(r.hub.cue({ player: 'p1' }, 'kick'), true);
209
+ assert.equal(r.hub.cue({ actor: i % 2 ? 'lamp' : 'jukebox' }, 'goal'), true);
210
+ }
211
+ assert.equal(r.hub.cue({ player: 'p1' }, 'kick'), false);
212
+ assert.equal(r.hub.cue({ actor: 'lamp' }, 'goal'), false);
213
+ assert.equal(r.hub.cue({ player: 'p2' }, 'kick'), true);
214
+ r.world.timeMs += 500;
215
+ for (let i = 0; i < 3; i += 1) {
216
+ assert.equal(r.hub.cue({ player: 'p1' }, 'kick'), true);
217
+ assert.equal(r.hub.cue({ actor: 'lamp' }, 'goal'), true);
218
+ }
219
+ assert.equal(r.hub.cue({ player: 'p1' }, 'kick'), false);
220
+ assert.equal(r.hub.cue({ actor: 'lamp' }, 'goal'), false);
221
+ });
222
+
114
223
  // --- the manifest -------------------------------------------------------------
115
224
 
116
225
  test('idle: true is emotes and seats; an object turns each part on; absent is no key at all', () => {
@@ -494,6 +603,34 @@ test('sounds: a place that declares none refuses them', () => {
494
603
 
495
604
  // --- the client's drawing -------------------------------------------------------
496
605
 
606
+ test('v1.47: joins and deltas stay unchanged until an NPC reacts, then latch its emote and expiry', () => {
607
+ const plain = boot();
608
+ const actors = globalThis.__hubTestActors;
609
+ const body = { translation: () => ({ x: 0, y: 1, z: 1 }), setNextKinematicRotation() {}, setNextKinematicTranslation() {} };
610
+ try {
611
+ globalThis.__hubTestActors = [...actors, { id: 'greeter', components: { HubNpc: {}, Transform: { x: 0, y: 1, z: 1 }, Body: { type: 'kinematic' } } }];
612
+ let allow = false;
613
+ const w = boot({ bodies: [['greeter', body]], hooks: { npcReact: () => allow ? { line: null } : false } });
614
+ assert.deepEqual(w.h.join(), plain.h.join());
615
+ assert.deepEqual(w.h.delta(), plain.h.delta());
616
+ w.say('p1', { k: 'hub-emote', id: 'wave' });
617
+ plain.say('p1', { k: 'hub-emote', id: 'wave' });
618
+ assert.deepEqual(w.h.join(), plain.h.join());
619
+ assert.deepEqual(w.h.delta(), plain.h.delta());
620
+ allow = true;
621
+ w.world.timeMs = 4000;
622
+ w.say('p1', { k: 'hub-emote', id: 'wave' });
623
+ assert.deepEqual(w.h.join().hubNpcEmotes, { greeter: { id: 'wave', at: 4000, until: 4000 + Idle.EMOTES.wave } });
624
+ assert.deepEqual(w.h.delta().hubNpcEmotes, w.h.join().hubNpcEmotes);
625
+ assert.equal('hubNpcEmotes' in (w.h.delta() ?? {}), false, 'unchanged emotes are not resent');
626
+ w.world.timeMs = 4000 + Idle.EMOTES.wave;
627
+ assert.deepEqual(w.h.delta().hubNpcEmotes, {});
628
+ assert.equal('hubNpcEmotes' in (w.h.delta() ?? {}), false, 'expiry is sent once');
629
+ } finally {
630
+ globalThis.__hubTestActors = actors;
631
+ }
632
+ });
633
+
497
634
  test('every emote starts and ends at rest, and moves between', () => {
498
635
  for (const [id] of ClientIdle.EMOTES) {
499
636
  const seconds = Idle.EMOTES[id] / 1000;
@@ -514,5 +651,228 @@ test('every emote starts and ends at rest, and moves between', () => {
514
651
  assert.equal(ClientIdle.emotePose('moonwalk', 0.5, 1), null);
515
652
  });
516
653
 
654
+ test('v1.47: NPC and player emotes draw the same motion and emoji, then restore their rigs', () => {
655
+ const now = performance.now();
656
+ const rig = () => ({ userData: {}, position: { y: 2 }, rotation: { x: 0, y: 0, z: 0, set(x, y, z) { Object.assign(this, { x, y, z }); } } });
657
+ const playerRig = rig();
658
+ const npcRig = rig();
659
+ const actors = new Map([
660
+ ['player', { id: 'player', components: { Transform: { x: 0, y: 1, z: 0 } } }],
661
+ ['npc', { id: 'npc', components: { Transform: { x: 1, y: 1, z: 0 } } }],
662
+ ]);
663
+ const scene = {
664
+ multiplayer: { net: { selfId: () => 'p1' } },
665
+ getActor: (id) => actors.get(id),
666
+ three: { nodes: new Map([['player', { node: { children: [playerRig] } }], ['npc', { node: { children: [npcRig] } }]]) },
667
+ };
668
+ const idle = ClientIdle.makeIdle({});
669
+ try {
670
+ clearClient();
671
+ clientHub.lastT = 800;
672
+ clientHub.lastTAt = now;
673
+ clientHub.emotes = { p1: { id: 'dance', at: 0, until: 2400 } };
674
+ clientHub.npcEmotes = { npc: { ...clientHub.emotes.p1 } };
675
+ idle.draw(scene, actors.get('player'));
676
+ assert.ok(playerRig.position.y > 2);
677
+ assert.equal(npcRig.position.y, playerRig.position.y);
678
+ assert.equal(npcRig.rotation.y, playerRig.rotation.y);
679
+ const labels = idle.labels(scene, actors.get('player'), null, null, (_cam, x, y) => ({ x, y }));
680
+ assert.deepEqual(labels.map((l) => [l.id, l.text]), [['emote:p1', '💃'], ['npc-emote:npc', '💃']]);
681
+ assert.equal(labels[0].y, labels[1].y);
682
+ clientHub.emotes = {};
683
+ clientHub.npcEmotes = {};
684
+ idle.draw(scene, actors.get('player'));
685
+ assert.equal(npcRig.position.y, 2);
686
+ assert.equal(npcRig.rotation.y, 0);
687
+ assert.equal(playerRig.position.y, 2);
688
+ clientHub.npcEmotes = { npc: { id: 'wave', at: 0, until: 2000 } };
689
+ clearClient();
690
+ assert.deepEqual(clientHub.npcEmotes, {}, 'a session switch clears NPC emotes');
691
+ } finally {
692
+ idle.dispose();
693
+ clearClient();
694
+ }
695
+ });
696
+
697
+ const { BoxGeometry, Mesh, MeshBasicMaterial } = await import('three');
698
+ test('an emote is placed on the drawn head first, and nothing that is not finite reaches the chrome', () => {
699
+ const now = performance.now();
700
+ const model = () => {
701
+ const m = new Mesh(new BoxGeometry(1, 1.4, 1), new MeshBasicMaterial());
702
+ m.position.set(0, 0.7, 0);
703
+ return m;
704
+ };
705
+ let rig = model();
706
+ const actors = new Map([['player', { id: 'player', components: { Transform: { x: 0, y: 1, z: 0 } } }]]);
707
+ const scene = {
708
+ multiplayer: { net: { selfId: () => 'p1' } },
709
+ getActor: (id) => actors.get(id),
710
+ three: { nodes: { get: (id) => (id === 'player' ? { node: { children: [rig] } } : undefined) } },
711
+ };
712
+ // A close camera looking down: anything above 2.5 m is behind it.
713
+ const close = (_cam, x, y) => (y > 2.5 ? null : { x: 200 + x * 100, y: 600 - y * 100 });
714
+ const idle = ClientIdle.makeIdle({});
715
+ try {
716
+ clearClient();
717
+ clientHub.lastT = 800;
718
+ clientHub.lastTAt = now;
719
+ clientHub.emotes = { p1: { id: 'wave', at: 0, until: 2800 } };
720
+ // The old point (2.25 m over the body) is behind the camera; the head is not.
721
+ let labels = idle.labels(scene, actors.get('player'), null, null, close);
722
+ assert.equal(labels.length, 1, 'drawn although the old point is behind the camera');
723
+ assert.ok(labels[0].head, 'placed on the head');
724
+ assert.ok(Math.abs(labels[0].head.top - (600 - 1.4 * 100)) < 1e-3, 'the top of the drawn model');
725
+ assert.ok([labels[0].x, labels[0].y, ...Object.values(labels[0].head)].every(Number.isFinite));
726
+ // Projections that are not finite: no label at all.
727
+ labels = idle.labels(scene, actors.get('player'), null, null, () => ({ x: NaN, y: NaN }));
728
+ assert.deepEqual(labels, [], 'NaN never reaches the chrome');
729
+ // Bounds that are not finite: the old point instead, with no head.
730
+ rig = model();
731
+ rig.position.set(NaN, NaN, NaN);
732
+ labels = idle.labels(scene, actors.get('player'), null, null, (_cam, x, y) => ({ x: 200 + x, y: 600 - y }));
733
+ assert.equal(labels.length, 1);
734
+ assert.equal(labels[0].head, undefined, 'a model with NaN bounds is no head');
735
+ assert.ok(Number.isFinite(labels[0].x) && Number.isFinite(labels[0].y));
736
+ // Neither the head nor the old point: nothing.
737
+ labels = idle.labels(scene, actors.get('player'), null, null, () => null);
738
+ assert.deepEqual(labels, []);
739
+ } finally {
740
+ idle.dispose();
741
+ clearClient();
742
+ }
743
+ });
744
+
745
+ test('a lying emote tracks the local head end; standing keeps its exact world-box rect', () => {
746
+ clearClient();
747
+ const rig = new Group();
748
+ const part = new Group();
749
+ part.position.y = 1;
750
+ part.add(new Mesh(new BoxGeometry(0.5, 2, 0.5), new MeshBasicMaterial()));
751
+ rig.add(part);
752
+ const node = new Group();
753
+ node.add(rig);
754
+ const local = { id: 'player', components: { Transform: { x: 0, y: 0, z: 0 } } };
755
+ const seat = { components: { HubSeat: { pose: 'lie' } } };
756
+ const scene = {
757
+ multiplayer: { net: { selfId: () => 'p1' } },
758
+ getActor: (id) => id === 'bed' ? seat : local,
759
+ three: { nodes: new Map([['player', { node }]]) },
760
+ };
761
+ const idle = ClientIdle.makeIdle({});
762
+ const label = (project) => {
763
+ clientHub.lastT = 800;
764
+ clientHub.lastTAt = performance.now();
765
+ clientHub.emotes = { p1: { id: 'wave', at: 0, until: 2800 } };
766
+ return idle.labels(scene, local, null, null, project)[0];
767
+ };
768
+ const front = (_cam, x, y) => ({ x: 200 + x * 100, y: 600 - y * 100 });
769
+ const overhead = (_cam, x, _y, z) => ({ x: 200 + x * 100, y: 600 + z * 100 });
770
+ try {
771
+ const standing = label(front).head;
772
+ assert.deepEqual(standing, { left: 175, right: 225, top: 400, bottom: 480 });
773
+ clientHub.emotes = {};
774
+ clientHub.seated = { p1: 'bed' };
775
+ idle.draw(scene, local);
776
+ assert.equal(rig.userData.hubIdleLie, true);
777
+ // The head occupies Z [-1.3, -0.5], rather than the whole body [-1.3, 0.7].
778
+ const head = label(overhead).head;
779
+ for (const [key, expected] of Object.entries({ left: 175, right: 225, top: 470, bottom: 550 })) {
780
+ assert.ok(Math.abs(head[key] - expected) < 1e-9, `${key}: head end only`);
781
+ }
782
+ // A translated, turned, scaled actor still projects the same local head.
783
+ node.position.set(3, 4, 5);
784
+ node.rotation.y = Math.PI / 2;
785
+ node.scale.set(2, 2, 2);
786
+ const turned = label(overhead).head;
787
+ for (const [key, expected] of Object.entries({ left: 240, right: 400, top: 1100, bottom: 1150 })) {
788
+ assert.ok(Math.abs(turned[key] - expected) < 1e-9, `${key}: parent world matrix`);
789
+ }
790
+ assert.equal(label(() => ({ x: NaN, y: NaN })), undefined);
791
+ clientHub.emotes = {};
792
+ clientHub.seated = {};
793
+ idle.draw(scene, local);
794
+ assert.equal(rig.userData.hubIdleLie, undefined, 'restore clears the lie marker');
795
+ node.position.set(0, 0, 0);
796
+ node.rotation.y = 0;
797
+ node.scale.set(1, 1, 1);
798
+ node.updateMatrixWorld(true);
799
+ assert.deepEqual(label(front).head, standing, 'standing after lying is byte-for-byte unchanged');
800
+ clientHub.emotes = {};
801
+ clientHub.seated = { p1: 'bed' };
802
+ idle.draw(scene, local);
803
+ seat.components.HubSeat.pose = 'sit';
804
+ idle.draw(scene, local);
805
+ assert.equal(rig.userData.hubIdleLie, false, 'lie to sit clears the active lie pose');
806
+ } finally {
807
+ idle.dispose();
808
+ clearClient();
809
+ }
810
+ });
811
+
812
+ // v1.82 validates the authored component, including blueprint seats.
813
+ const checkDir = fs.mkdtempSync(path.join(os.tmpdir(), 'hub-seat-check-'));
814
+ fs.mkdirSync(path.join(checkDir, 'scenes'));
815
+ fs.mkdirSync(path.join(checkDir, 'blueprints'));
816
+ fs.writeFileSync(path.join(checkDir, 'castle.json'), JSON.stringify({ server: { main: 'code/server/index.js' }, hub: { contract: 1, title: 'Seats' } }));
817
+ for (const [props, valid] of [[{}, true], [{ pose: 'sit' }, true], [{ pose: 'lie' }, true], [{ pose: 'sleep' }, false], [{ pose: null }, false], [{ pose: 90 }, false], [{ pose: '' }, false], [{ pose: false }, false], [{ pose: {} }, false], [{ recline: true }, false]]) {
818
+ for (const blueprint of [false, true]) {
819
+ fs.writeFileSync(path.join(checkDir, 'blueprints/bed.scene'), JSON.stringify({ actors: [{ components: { HubSeat: props } }] }));
820
+ fs.writeFileSync(path.join(checkDir, 'scenes/main.scene'), JSON.stringify({ actors: [
821
+ { id: 'player', components: { Player: {} } },
822
+ { id: 'bed', ...(blueprint ? { blueprint: 'blueprints/bed.scene' } : {}), components: { Transform: {}, ...(blueprint ? {} : { HubSeat: props }) } },
823
+ ] }));
824
+ const result = await check({ deckDir: checkDir, self: true });
825
+ test(`v1.82: check ${valid ? 'accepts' : 'refuses'} ${JSON.stringify(props)}, blueprint=${blueprint}`, () => {
826
+ if (valid) { assert.deepEqual(result.errors, []); }
827
+ else { assert.match(result.errors.join(), /HubSeat\.(pose|recline)/); }
828
+ });
829
+ }
830
+ }
831
+
832
+ test('v1.82: Sit stays exact; Lie down draws self and others face-up, centred, restores and keeps Stand', () => {
833
+ for (const pose of [undefined, 'sit', 'lie']) {
834
+ clearClient();
835
+ clientHub.place = { idle: { seats: true } };
836
+ const seat = { id: 'bed', components: { HubSeat: { ...(pose ? { pose } : {}) }, Transform: { x: 0, y: 0, z: 0 }, Shape: { width: 1, depth: 2 } } };
837
+ const local = { id: 'player', components: { Transform: { x: 0, z: 0 } } };
838
+ const rigs = new Map(['player', 'other'].map((id) => { const rig = new Group(); rig.position.set(0, -0.7, 0); return [id, rig]; }));
839
+ const nodes = new Map([...rigs].map(([id, rig]) => { const node = new Group(); node.add(rig); return [id, { node }]; }));
840
+ let prompt, press;
841
+ const sent = [];
842
+ const mp = { net: { selfId: () => 'self', send: (op) => sent.push(op) }, avatars: { actors: new Map([['guest', 'other']]) } };
843
+ const scene = { multiplayer: mp, getActor: (id) => id === 'bed' ? seat : local, getActors: () => [seat], three: { nodes } };
844
+ const idle = ClientIdle.makeIdle({ onSit: (fn) => { press = fn; }, sitPrompt: (label) => { prompt = label; } });
845
+ idle.frame(scene, mp, local, true, 'house');
846
+ assert.equal(prompt, pose === 'lie' ? 'Lie down' : 'Sit');
847
+ press(); idle.frame(scene, mp, local, true, 'house');
848
+ assert.deepEqual(sent, [{ k: 'hub-sit', seat: 'bed' }]);
849
+ clientHub.seated = { self: 'bed', guest: 'bed' };
850
+ idle.frame(scene, mp, local, true, 'house'); assert.equal(prompt, 'Stand');
851
+ idle.draw(scene, local);
852
+ for (const rig of rigs.values()) {
853
+ assert.deepEqual(rig.position.toArray(), pose === 'lie' ? [0, -0.6, 0.7] : [0, -0.7 - ClientIdle.SEAT_DROP_M, 0]);
854
+ assert.deepEqual([rig.rotation.x, rig.rotation.y, rig.rotation.z], [pose === 'lie' ? -Math.PI / 2 : -0.1, 0, 0]);
855
+ if (pose === 'lie') {
856
+ const head = new Vector3(0, 1.4, 0).applyEuler(rig.rotation).add(rig.position);
857
+ const front = new Vector3(0, 0, 1).applyEuler(rig.rotation);
858
+ assert.ok(Math.abs(head.z + 0.7) < 1e-9, 'head at back/pillow');
859
+ assert.ok(front.y > 0.999, 'face up');
860
+ // The parent yaw turns both the offset and the head/feet axis.
861
+ for (const yaw of [0, Math.PI / 2, Math.PI, -Math.PI / 2]) {
862
+ rig.parent.rotation.y = yaw; rig.parent.updateMatrixWorld(true);
863
+ const centre = rig.localToWorld(new Vector3(0, 0.7, 0));
864
+ assert.ok(Math.hypot(centre.x, centre.z) < 1e-9, 'length stays centred at every facing');
865
+ }
866
+ }
867
+ }
868
+ // A lie -> sit swap resets the additional offset without releasing the rig.
869
+ seat.components.HubSeat.pose = 'sit'; idle.draw(scene, local);
870
+ for (const rig of rigs.values()) { assert.equal(rig.position.z, 0); assert.equal(rig.position.y, -0.7 - ClientIdle.SEAT_DROP_M); }
871
+ clientHub.seated = {}; idle.draw(scene, local);
872
+ for (const rig of rigs.values()) { assert.deepEqual(rig.position.toArray(), [0, -0.7, 0]); assert.equal(rig.rotation.x, 0); }
873
+ idle.dispose(); clearClient();
874
+ }
875
+ });
876
+
517
877
  console.warn = warn;
518
878
  console.log(`test-idle: ${n} passed`);
@@ -0,0 +1,36 @@
1
+ import assert from 'node:assert/strict';
2
+ import { makeInterestCap, mergeDictionary } from '../code/client/interestCap.js';
3
+ let cap = makeInterestCap(48);
4
+ assert.equal(cap.frame(0, 'high'), 48);
5
+ let changes = [];
6
+ for (let t = 50; t <= 14000; t += 50) {
7
+ const n = cap.frame(t, 'high');
8
+ if (n !== null) changes.push([t, n]);
9
+ }
10
+ assert.deepEqual(changes, [[3050, 16]]);
11
+ for (let t = 14020; t <= 42000; t += 20) {
12
+ const n = cap.frame(t, 'high');
13
+ if (n !== null) changes.push([t, n]);
14
+ }
15
+ assert.equal(changes.length, 2);
16
+ assert.equal(changes[1][1], 48);
17
+ assert.ok(changes[1][0] >= 35000, 'requires twenty sustained seconds after slow samples expire');
18
+ assert.equal(cap.frame(42020, 'low'), 16);
19
+ assert.equal(cap.frame(42040, 'high'), 48);
20
+ cap = makeInterestCap();
21
+ assert.equal(cap.frame(0, 'low'), 16);
22
+ for (let t = 20; t <= 30000; t += 20) assert.equal(cap.frame(t, 'low'), null);
23
+ assert.equal(cap.frame(30020, 'high'), 1000);
24
+ cap = makeInterestCap(48);
25
+ cap.frame(0, 'high');
26
+ for (let t = 50; t < 10000; t += 50) cap.frame(t, 'high', false);
27
+ assert.equal(cap.frame(10000, 'high'), null, 'transition/hidden frames are not counted');
28
+ const original = { a: { text: 'one' }, b: { text: 'two' } };
29
+ assert.deepEqual(mergeDictionary(original, { a: { text: 'new' }, b: null, c: 'three' }), {
30
+ a: { text: 'new' },
31
+ c: 'three',
32
+ });
33
+ assert.equal(original.b.text, 'two');
34
+ console.log(
35
+ 'test-interest-cap: tiers, p95 guard, cooldown, recovery and dictionary merging passed',
36
+ );