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,493 @@
1
+ // Drive the real hub + real-time paths with an authored scene and physics stand-ins.
2
+ import assert from 'node:assert/strict';
3
+ import { register } from 'node:module';
4
+ import fs from 'node:fs';
5
+ const stub = `export const readScene = () => ['sign','other','ball','far'].map(id => ({id, components:{Transform:{x:0,y:0,z:0},...(id==='sign'||id==='other'?{Shape:{type:'box'}}:{Body:{type:'dynamic'}})}})); export const sceneCells = () => globalThis.__cells;`;
6
+ register(
7
+ `data:text/javascript,${encodeURIComponent(`export async function resolve(s,c,n){if(s==='@imports/castle.multiplayer-3d/code/server/sceneBodies.js')return {url:${JSON.stringify('data:text/javascript,' + encodeURIComponent(stub))},shortCircuit:true};return n(s,c);}`)}`,
8
+ );
9
+ const { layer } = await import('../code/server/hub.js');
10
+ const { makeSession } = await import('../../real-time/code/server/session.js');
11
+ const { readManifest, publicPlace } = await import('../code/server/manifest.js');
12
+ const cells = {
13
+ version: 1,
14
+ hysteresis: 2.5,
15
+ cells: [
16
+ {
17
+ id: 'near',
18
+ outline: [
19
+ [-40, -40],
20
+ [40, -40],
21
+ [40, 40],
22
+ [-40, 40],
23
+ ],
24
+ sees: ['near'],
25
+ },
26
+ {
27
+ id: 'far',
28
+ outline: [
29
+ [40, -40],
30
+ [140, -40],
31
+ [140, 40],
32
+ [40, 40],
33
+ ],
34
+ sees: ['far'],
35
+ },
36
+ ],
37
+ };
38
+ const manifest = (on = false, extra = {}) => ({
39
+ server: { tickRate: 30, maxPlayers: 24 },
40
+ hub: { contract: 1, title: 'Town', ...(on ? { interest: 'cells' } : {}), ...extra },
41
+ });
42
+ assert.equal(readManifest(manifest()).manifest.places.main.nearestPlayers, 30);
43
+ assert.equal(readManifest(manifest(true)).manifest.places.main.nearestPlayers, 48);
44
+ assert.equal(
45
+ readManifest(manifest(true, { nearestPlayers: 7 })).manifest.places.main.nearestPlayers,
46
+ 7,
47
+ );
48
+ assert.ok(!('interest' in publicPlace('main', readManifest(manifest()).manifest.places.main)));
49
+ assert.deepEqual(readManifest(manifest(false, { interest: 'bad' })).errors, [
50
+ 'hub.interest must be "cells" (or left out).',
51
+ ]);
52
+ let wall = 10000;
53
+ Date.now = () => wall;
54
+ const log = console.log;
55
+ console.log = () => {};
56
+ const warnings = [];
57
+ console.warn = (line) => warnings.push(line);
58
+ async function room({
59
+ on = true,
60
+ table = cells,
61
+ hidden = false,
62
+ extra = {},
63
+ ids = ['a', 'b', 'c'],
64
+ objectHook,
65
+ hubOps = {},
66
+ } = {}) {
67
+ globalThis.__cells = table;
68
+ let sim;
69
+ let ctx;
70
+ const hooks = layer(
71
+ manifest(on, extra),
72
+ {
73
+ ready(h) {
74
+ ctx = h;
75
+ },
76
+ },
77
+ {},
78
+ () => true,
79
+ );
80
+ if (objectHook) hooks.objectInterest = objectHook;
81
+ const sent = [];
82
+ const traffic = [];
83
+ const world = {
84
+ async createSimulation(scenePath) {
85
+ sim = { scenePath, timeMs: 0, players: new Map(), objects: new Map(), bodies: new Map() };
86
+ for (const [id, x] of [
87
+ ['ball', 5],
88
+ ['far', 100],
89
+ ]) {
90
+ const object = { at: { x, y: 0, z: 0 }, owner: null, claimable: true, epoch: 0 };
91
+ object.body = {
92
+ translation: () => object.at,
93
+ setTranslation: (p) => (object.at = { ...p }),
94
+ setLinvel() {},
95
+ setAngvel() {},
96
+ };
97
+ sim.objects.set(id, object);
98
+ sim.bodies.set(id, object.body);
99
+ }
100
+ return sim;
101
+ },
102
+ step(s) {
103
+ s.timeMs += 33;
104
+ },
105
+ objectPoses: (s) => [...s.objects].map(([id, o]) => [id, o.at.x, 0, 0, 0, 0, 0, 1, 0]),
106
+ restorePoses: () => 0,
107
+ };
108
+ const players = {
109
+ addPlayer(s, id) {
110
+ s.players.set(id, {
111
+ at: { x: id === 'c' ? 100 : id === 'b' ? 5 : 0, y: 0, z: 0 },
112
+ facing: 0,
113
+ body: { setTranslation() {} },
114
+ });
115
+ },
116
+ removePlayer(s, id) {
117
+ s.players.delete(id);
118
+ },
119
+ setPose() {},
120
+ playerPoses: (s) => [...s.players].map(([id, p]) => [id, p.at.x, 0, p.at.z, 0, 0]),
121
+ };
122
+ const roster = ids.map((playerId, i) => ({
123
+ playerId,
124
+ userId: String(101 + i),
125
+ username: playerId,
126
+ }));
127
+ const session = {
128
+ sessionId: 'dev:cells',
129
+ players: roster,
130
+ hub: {
131
+ place: 'main',
132
+ arrival: () => null,
133
+ readResults: async () => ({ players: {}, boards: {} }),
134
+ hiddenPair: (a, b) =>
135
+ hidden && new Set([a, b]).size === 2 && [a, b].every((id) => id === 'a' || id === 'b'),
136
+ friendsAmong: async () => ['103'],
137
+ ...hubOps,
138
+ },
139
+ send: (to, msg) => { sent.push({ to, msg }); traffic.push({ to, msg }); },
140
+ broadcast: (msg) => { sent.push({ to: '*', msg }); traffic.push({ to: '*', msg }); },
141
+ };
142
+ const server = makeSession({
143
+ label: 'test',
144
+ game: hooks,
145
+ world,
146
+ players,
147
+ poses: { PLAYER_GEOMETRY: 4, epsilonAt: () => 0.001 },
148
+ ownership: {
149
+ claim() {},
150
+ release() {},
151
+ setObjectPoses() {},
152
+ sweepOwners() {},
153
+ ownerships: () => [],
154
+ },
155
+ });
156
+ server.onTick(session);
157
+ await new Promise((resolve) => setTimeout(resolve, 10));
158
+ return {
159
+ sim,
160
+ ctx,
161
+ hooks,
162
+ session,
163
+ server,
164
+ sent,
165
+ traffic,
166
+ tick() {
167
+ wall += 300;
168
+ sent.length = 0;
169
+ server.onTick(session);
170
+ return structuredClone(sent);
171
+ },
172
+ cap(n) {
173
+ server.onMessage(session, roster[0], { k: 'hub-cap', n });
174
+ },
175
+ rejoin() {
176
+ server.onPlayerJoin(session, roster[0]);
177
+ },
178
+ };
179
+ }
180
+ const forA = (messages) =>
181
+ messages.filter(({ to }) => to === 'a' || to === '*').map(({ msg }) => msg);
182
+ const states = (messages) => forA(messages).filter((m) => m.k === 's');
183
+ const idsOf = (messages) => {
184
+ const map = new Map();
185
+ const ids = [];
186
+ for (const msg of forA(messages)) {
187
+ for (const [n, id] of msg.idm ?? []) map.set(n, id);
188
+ ids.push(
189
+ ...(msg.ps ?? []).map(([id]) => (typeof id === 'number' ? map.get(id) : id)),
190
+ ...(msg.in ?? []),
191
+ );
192
+ }
193
+ return ids;
194
+ };
195
+ let r = await room();
196
+ let first = r.tick();
197
+ assert.ok(!idsOf(first).includes('c'), 'outside players never have pose rows');
198
+ assert.ok(idsOf(first).includes('b'));
199
+ assert.equal(forA(first).find((m) => m.hubPlace).os.length, 2, 'WORLD keeps all objects');
200
+ r.sim.objects.get('far').at.x = 101;
201
+ assert.ok(
202
+ states(r.tick()).every((m) => !m.os.some(([id]) => id === 'far')),
203
+ 'moving far object omitted',
204
+ );
205
+ r.sim.players.get('c').at.x = 10;
206
+ let entering = states(r.tick());
207
+ assert.ok(
208
+ entering.some(
209
+ (m) => m.in?.includes('c') && m.ps.some((row) => row.length === 6 && row[1] === 10),
210
+ ),
211
+ 'in carries full row',
212
+ );
213
+ r.sim.objects.get('far').at.x = 10;
214
+ entering = states(r.tick());
215
+ assert.ok(
216
+ entering.some(
217
+ (m) =>
218
+ m.oin?.includes('far') &&
219
+ m.os.some((row) => row[0] === 'far' && row.length === 9 && row[1] === 10),
220
+ ),
221
+ );
222
+ r.sim.objects.get('far').at.x = 100;
223
+ r.tick();
224
+ r.sim.objects.get('far').owner = 'a';
225
+ assert.ok(
226
+ states(r.tick()).some((m) => m.oin?.includes('far')),
227
+ 'owned object always included',
228
+ );
229
+ r.sim.objects.get('far').owner = null;
230
+ r.tick();
231
+ r.rejoin();
232
+ assert.equal(
233
+ forA(r.tick()).find((m) => m.hubPlace).os.length,
234
+ 2,
235
+ 'rejoin resets object knowledge via whole WORLD',
236
+ );
237
+ // A real grab establishes the hold, which remains included after the object moves away.
238
+ r = await room({ extra: { grab: true } });
239
+ r.tick();
240
+ r.session.hub = null;
241
+ r.server.onMessage(r.session, r.session.players[0], { k: 'hub-hello', avatar: 0 });
242
+ r.tick();
243
+ r.sim.objects.get('ball').at.x = 1;
244
+ r.sim.objects.get('ball').owner = 'a';
245
+ r.server.onMessage(r.session, r.session.players[0], { k: 'hub-grab', op: 'grab', actor: 'ball' });
246
+ assert.equal(r.ctx.holding('a'), 'ball');
247
+ r.sim.objects.get('ball').owner = null;
248
+ r.sim.objects.get('ball').at.x = 100;
249
+ assert.ok(
250
+ r.hooks.objectInterest(r.sim).get('a').has('ball'),
251
+ 'hub-held object included even without owner',
252
+ );
253
+ // No SDK relations helper still falls back to this viewer's mutual friends.
254
+ r = await room();
255
+ r.tick();
256
+ r.sim.players.get('c').at.x = 20;
257
+ r.tick();
258
+ r.cap(1);
259
+ assert.deepEqual([...r.hooks.interest(r.sim, new Map()).get('a')], ['b']);
260
+ await r.ctx.friendsAmong('a', ['102', '103']);
261
+ assert.deepEqual([...r.hooks.interest(r.sim, new Map()).get('a')], ['c']);
262
+ assert.deepEqual([...r.hooks.interest(r.sim, new Map()).get('b')], ['a', 'c']);
263
+ wall += 300;
264
+ r.cap(1000);
265
+ assert.equal(r.hooks.interest(r.sim, new Map()).get('a').size, 2);
266
+ wall += 300;
267
+ r.cap(-2);
268
+ assert.equal(r.hooks.interest(r.sim, new Map()).get('a').size, 1);
269
+ wall += 300;
270
+ r.cap(1.5);
271
+ r.cap('2');
272
+ assert.equal(r.hooks.interest(r.sim, new Map()).get('a').size, 1);
273
+ r.sim.players.get('c').at.x = 500;
274
+ r.tick();
275
+ assert.ok(
276
+ r.hooks.interest(r.sim, new Map()).get('a').has('c'),
277
+ 'unresolved candidate cells fail open',
278
+ );
279
+ r.sim.players.get('c').at.x = 20;
280
+ r.tick();
281
+ // Leave forgets the cap.
282
+ r.session.players = r.session.players.filter((p) => p.playerId !== 'a');
283
+ r.tick();
284
+ r.session.players.push({ playerId: 'a', userId: '101', username: 'a' });
285
+ r.tick();
286
+ assert.equal(r.hooks.interest(r.sim, new Map()).get('a').size, 2);
287
+ r = await room({ extra: { nearestPlayers: 2 } });
288
+ r.tick();
289
+ r.sim.players.get('c').at.x = 6;
290
+ r.tick();
291
+ for (const n of [1, 2, 1, 2, 1]) {
292
+ r.cap(n);
293
+ }
294
+ assert.equal(
295
+ r.hooks.interest(r.sim, new Map()).get('a').size,
296
+ 2,
297
+ 'fifth request in one second is ignored',
298
+ );
299
+ wall += 1001;
300
+ r.cap(1);
301
+ assert.equal(r.hooks.interest(r.sim, new Map()).get('a').size, 1);
302
+ // Already-known candidates keep the old KEEP_NEARER distance preference.
303
+ r.sim.players.get('b').at.x = 5.5;
304
+ r.sim.players.get('c').at.x = 5;
305
+ r.tick();
306
+ assert.deepEqual([...r.hooks.interest(r.sim, new Map([['a', new Set(['b'])]])).get('a')], ['b']);
307
+ r = await room({ hidden: true });
308
+ assert.ok(!idsOf(r.tick()).includes('b'));
309
+ r.sim.players.get('a').at.x = 500;
310
+ r.tick();
311
+ assert.ok(
312
+ !r.hooks.interest(r.sim, new Map()).get('a').has('b'),
313
+ 'outside all cells still respects blocks',
314
+ );
315
+ // Both follow directions are server-only priorities ahead of a nearer stranger.
316
+ const relationCalls = [];
317
+ let settlePrime;
318
+ r = await room({
319
+ ids: ['a', 'b', 'c', 'd'],
320
+ hubOps: {
321
+ friendsAmong: () => assert.fail('cells use the single relations read'),
322
+ relationsAmong: (playerId, userIds) => {
323
+ relationCalls.push([playerId, userIds]);
324
+ return playerId === 'a'
325
+ ? new Promise((resolve) => { settlePrime = resolve; })
326
+ : Promise.resolve({ friends: [], follows: [], followedBy: [] });
327
+ },
328
+ },
329
+ });
330
+ assert.equal(relationCalls.length, 0, 'no priming before hello');
331
+ for (const player of r.session.players) {
332
+ r.server.onMessage(r.session, player, { k: 'hub-hello', avatar: 0 });
333
+ }
334
+ assert.equal(relationCalls.length, 0, 'early hellos wait for their bodies');
335
+ r.tick();
336
+ assert.deepEqual(relationCalls.find(([id]) => id === 'a'), ['a', ['102', '103', '104']]);
337
+ const duringPrime = r.ctx.friendsAmong('a', ['103', '999']);
338
+ r.tick();
339
+ assert.equal(relationCalls.filter(([id]) => id === 'a').length, 1);
340
+ settlePrime({ friends: [], follows: ['103'], followedBy: ['104'] });
341
+ assert.deepEqual(await duringPrime, [], 'one-way follows never become public friends');
342
+ await new Promise((resolve) => setImmediate(resolve));
343
+ r.sim.players.get('c').at.x = 20;
344
+ r.sim.players.get('d').at.x = 25;
345
+ r.tick();
346
+ r.cap(2);
347
+ r.server.onMessage(r.session, r.session.players[1], { k: 'hub-cap', n: 1 });
348
+ assert.deepEqual([...r.hooks.interest(r.sim, new Map()).get('a')], ['c', 'd']);
349
+ assert.ok(!r.hooks.interest(r.sim, new Map()).get('b').has('c'), 'viewer cache cannot prioritize another viewer');
350
+ for (const { msg } of r.traffic) {
351
+ assert.ok(!/"(?:follows|followedBy)"\s*:/.test(JSON.stringify(msg)), 'relations never enter client messages');
352
+ }
353
+ // Old ghost's userIds-only answer (mapped by relationsAmong) keeps friends first.
354
+ r = await room({ hubOps: { relationsAmong: async () => ({ friends: ['103'], follows: [], followedBy: [] }) } });
355
+ for (const player of r.session.players) {
356
+ r.server.onMessage(r.session, player, { k: 'hub-hello', avatar: 0 });
357
+ }
358
+ r.tick();
359
+ await new Promise((resolve) => setImmediate(resolve));
360
+ r.sim.players.get('c').at.x = 20;
361
+ r.tick();
362
+ r.cap(1);
363
+ assert.deepEqual([...r.hooks.interest(r.sim, new Map()).get('a')], ['c']);
364
+ assert.deepEqual(await r.ctx.friendsAmong('a', ['102', '103']), ['103']);
365
+ assert.ok(r.traffic.every(({ msg }) => !/"(?:follows|followedBy)"\s*:/.test(JSON.stringify(msg))));
366
+ // An unfollow cannot retain expired priority, even while the refresh is pending.
367
+ let unfollowed = false;
368
+ let settleUnfollow;
369
+ r = await room({ hubOps: { relationsAmong: async (playerId) => {
370
+ if (unfollowed && playerId === 'a') {
371
+ return new Promise((resolve) => { settleUnfollow = resolve; });
372
+ }
373
+ return { friends: [], follows: playerId === 'a' ? ['103'] : [], followedBy: [] };
374
+ } } });
375
+ r.tick();
376
+ for (const player of r.session.players) {
377
+ r.server.onMessage(r.session, player, { k: 'hub-hello', avatar: 0 });
378
+ }
379
+ await new Promise((resolve) => setImmediate(resolve));
380
+ r.sim.players.get('c').at.x = 20;
381
+ r.tick();
382
+ r.cap(1);
383
+ assert.deepEqual([...r.hooks.interest(r.sim, new Map()).get('a')], ['c']);
384
+ unfollowed = true;
385
+ wall += 40000;
386
+ assert.deepEqual([...r.hooks.interest(r.sim, new Map()).get('a')], ['b'], 'expired follows lose priority before refresh');
387
+ r.tick();
388
+ assert.equal(typeof settleUnfollow, 'function', 'unchanged roster refreshes at expiry');
389
+ assert.deepEqual([...r.hooks.interest(r.sim, new Map()).get('a')], ['b'], 'pending refresh cannot reuse stale priority');
390
+ settleUnfollow({ friends: [], follows: [], followedBy: [] });
391
+ await new Promise((resolve) => setImmediate(resolve));
392
+ assert.deepEqual([...r.hooks.interest(r.sim, new Map()).get('a')], ['b'], 'unfollowed player remains below nearer stranger');
393
+ r = await room({
394
+ objectHook: () => {
395
+ throw Error('fixture');
396
+ },
397
+ });
398
+ const error = console.error;
399
+ console.error = () => {};
400
+ assert.equal(forA(r.tick()).find((m) => m.hubPlace).os.length, 2);
401
+ assert.ok(states(r.tick()).every((m) => m.os.length === 0));
402
+ r.sim.objects.get('far').at.x = 110;
403
+ assert.ok(states(r.tick()).some((m) => m.os.some(([id]) => id === 'far')));
404
+ console.error = error;
405
+ r = await room();
406
+ r.tick();
407
+ r.hooks.objectInterest = () => {
408
+ throw Error('fixture');
409
+ };
410
+ console.error = () => {};
411
+ assert.ok(
412
+ states(r.tick()).some((m) => m.oin?.includes('far') && m.os.some(([id]) => id === 'far')),
413
+ 'throw restores omitted objects with full entry rows',
414
+ );
415
+ console.error = error;
416
+ r = await room({
417
+ on: false,
418
+ objectHook: () => new Map(['a', 'b', 'c'].map((id) => [id, new Set(['ball'])])),
419
+ });
420
+ delete r.hooks.interest;
421
+ first = r.tick();
422
+ assert.ok(
423
+ states(first).every((m) => !m.os.some(([id]) => id === 'far')),
424
+ 'object-only hook filters without player interest',
425
+ );
426
+ r.hooks.objectInterest = () => new Map();
427
+ first = r.tick();
428
+ assert.ok(
429
+ first.some(({ to, msg }) => to === '*' && msg.oin?.includes('far')),
430
+ 'identical object entry payloads broadcast once',
431
+ );
432
+
433
+ // Dictionary patches diff the privacy-filtered common block, never private replies.
434
+ r = await room();
435
+ r.ctx.label('sign', 'one');
436
+ r.ctx.label('other', 'two');
437
+ first = r.tick();
438
+ assert.deepEqual(Object.keys(forA(first).find((m) => m.hubPlace).labels), ['sign', 'other']);
439
+ r.ctx.label('sign', 'new');
440
+ let patch = states(r.tick()).find((m) => m.labelsD)?.labelsD;
441
+ assert.deepEqual(Object.keys(patch), ['sign']);
442
+ assert.equal(patch.sign.text, 'new');
443
+ r.ctx.label('sign', null);
444
+ assert.equal(
445
+ JSON.stringify(states(r.tick()).find((m) => m.labelsD)?.labelsD),
446
+ JSON.stringify({ sign: null }),
447
+ );
448
+ r.ctx.label('sign', 'secret', { to: ['a'] });
449
+ assert.ok(
450
+ !states(r.tick()).some((m) => m.labelsD?.sign),
451
+ 'private labels stay out of common patches',
452
+ );
453
+ r.ctx.tint('sign', '#aabbcc');
454
+ assert.equal(states(r.tick()).find((m) => m.tintsD)?.tintsD.sign, '#aabbcc');
455
+ r.ctx.tint('sign', null);
456
+ assert.equal(states(r.tick()).find((m) => m.tintsD)?.tintsD.sign, null);
457
+ r.server.onMessage(r.session, r.session.players[0], { k: 'hub-hello', avatar: 0 });
458
+ r.ctx.mark('a', { text: 'Here', color: '#abcdef' });
459
+ assert.equal(states(r.tick()).find((m) => m.marksD)?.marksD.a.text, 'Here');
460
+ r.ctx.mark('a', null);
461
+ assert.equal(states(r.tick()).find((m) => m.marksD)?.marksD.a, null);
462
+ // Legacy traffic is pinned to hooks/session/manifest at b3d90564 (before v1.65).
463
+ // The fixture was checked byte-for-byte by running those original modules.
464
+ async function legacy(on = false, table = cells) {
465
+ const q = await room({ on, table });
466
+ q.ctx.label('sign', 'one');
467
+ const all = [...q.tick()];
468
+ q.sim.players.get('b').at.x = 7;
469
+ q.sim.objects.get('ball').at.x = 6;
470
+ all.push(...q.tick());
471
+ q.ctx.label('sign', 'two');
472
+ all.push(...q.tick());
473
+ q.ctx.label('sign', null);
474
+ all.push(...q.tick());
475
+ return all;
476
+ }
477
+ const goldenFile = new URL('./fixtures/interest-legacy.json', import.meta.url);
478
+ const legacyMessages = await legacy();
479
+ assert.equal(
480
+ JSON.stringify(await legacy(true, null)),
481
+ JSON.stringify(legacyMessages),
482
+ 'invalid table has byte-identical legacy behavior',
483
+ );
484
+ assert.equal(
485
+ JSON.stringify(legacyMessages),
486
+ JSON.stringify(JSON.parse(fs.readFileSync(goldenFile, 'utf8'))),
487
+ 'key absent matches pre-change golden bytes',
488
+ );
489
+ assert.equal(warnings.filter((w) => w.startsWith('[hub] interest: cells table')).length, 1);
490
+ console.log = log;
491
+ console.log(
492
+ 'test-interest-cells: manifest, cells, entry, relations, priming, privacy, caps, blocks, objects, patches and legacy golden passed',
493
+ );
@@ -0,0 +1,118 @@
1
+ // Real hook-layer patch arrivals and hub cap wiring, without a browser.
2
+ import assert from 'node:assert/strict';
3
+ import { readFileSync } from 'node:fs';
4
+ import { register } from 'node:module';
5
+ import { makeInterestCap } from '../code/client/interestCap.js';
6
+ register(
7
+ `data:text/javascript,${encodeURIComponent(`
8
+ import {readFile} from 'node:fs/promises';
9
+ const stubs={
10
+ 'castle-web-sdk':${JSON.stringify(new URL('./fixtures/sdk-stub.mjs', import.meta.url).href)},
11
+ '@imports/castle.multiplayer-3d/code/client/avatars.js':'data:text/javascript,export function dropMissing(){}',
12
+ };
13
+ export async function resolve(s,c,n){
14
+ if(['pxmodel','optimize','look','lookbake'].some(m=>s==='@imports/castle.physics-3d/engine3d/'+m)) return {url:${JSON.stringify(new URL('./fixtures/engine-models-stub.mjs', import.meta.url).href)},shortCircuit:true};
15
+ if (s === '@imports/castle.physics-3d/engine3d/orbitlens.js') return { url: ${JSON.stringify(new URL('../../physics-3d/engine3d/orbitlens.js', import.meta.url).href)}, shortCircuit: true };
16
+ if(stubs[s]) return {url:stubs[s],shortCircuit:true};
17
+ return n(s,c);
18
+ }
19
+ export async function load(u,c,n){
20
+ if(u.endsWith('/code/client/hookLayer.js')) return {format:'module',source:(await readFile(new URL(u),'utf8')).replaceAll('import.meta.glob(','(() => ({}))('),shortCircuit:true};
21
+ return n(u,c);
22
+ }
23
+ `)}`,
24
+ );
25
+ const hook = (await import('../code/client/hookLayer.js')).default;
26
+ const State = await import('../code/client/state.js');
27
+ State.clear();
28
+ hook.state(
29
+ {},
30
+ {
31
+ labels: { a: { text: 'one' }, b: { text: 'two' } },
32
+ tints: { a: '#ffffff' },
33
+ marks: { a: { text: 'here' } },
34
+ },
35
+ null,
36
+ );
37
+ State.hub.labelsMe = { a: { text: 'private' } };
38
+ hook.state(
39
+ {},
40
+ {
41
+ labelsD: { a: { text: 'new' }, b: null },
42
+ tintsD: { a: null, b: '#abcdef' },
43
+ marksD: { a: null, b: { text: 'there' } },
44
+ },
45
+ null,
46
+ );
47
+ assert.deepEqual(State.hub.labels, { a: { text: 'new' } });
48
+ assert.deepEqual(State.hub.labelsMe, { a: { text: 'private' } });
49
+ assert.deepEqual(State.hub.tints, { b: '#abcdef' });
50
+ assert.deepEqual(State.hub.marks, { b: { text: 'there' } });
51
+ hook.state({}, { labels: { fresh: { text: 'WORLD' } }, tints: {}, marks: {} }, null);
52
+ assert.deepEqual(
53
+ State.hub.labels,
54
+ { fresh: { text: 'WORLD' } },
55
+ 'whole snapshots replace merged dictionaries',
56
+ );
57
+
58
+ // v1.81: every label arrival path preserves the optional hint key.
59
+ const hint = { text: 'Hats', style: 'goal', edge: false };
60
+ const triggered = { text: 'Home', style: 'goal' };
61
+ hook.state({}, { labels: { shop: hint, home: triggered } }, null);
62
+ assert.deepEqual(State.hub.labels, { shop: hint, home: triggered });
63
+ hook.state({}, { labelsD: { shop: { ...hint, text: 'New hats' }, home: null } }, null);
64
+ assert.deepEqual(State.hub.labels, { shop: { ...hint, text: 'New hats' } });
65
+ hook.message({}, { k: 'hub-labels', labels: { shop: hint, home: triggered } });
66
+ assert.deepEqual(State.hub.labelsMe, { shop: hint, home: triggered });
67
+ hook.message({}, { k: 'hub-labels', labels: { shop: triggered } });
68
+ assert.deepEqual(State.hub.labelsMe, { shop: triggered }, 'changing to triggered drops the old edge key');
69
+
70
+ // Read the actual small system methods, following test-tiers' stand-in harness.
71
+ const source = readFileSync(new URL('../code/systems/hub.js', import.meta.url), 'utf8');
72
+ const method = (name) => {
73
+ const start = source.indexOf(` ${name}(scene,`);
74
+ assert.ok(start >= 0);
75
+ return source.slice(start, source.indexOf('\n }\n', start) + 5);
76
+ };
77
+ const registerStart = source.indexOf(' registerInterest(scene) {');
78
+ const registerMethod = source.slice(registerStart, source.indexOf('\n }\n', registerStart) + 5);
79
+ const System = Function(
80
+ 'Hub',
81
+ 'makeInterestCap',
82
+ `return class {${method('interestFrame')}\n${registerMethod}}`,
83
+ )(State, makeInterestCap);
84
+ const system = new System();
85
+ const sent = [];
86
+ const registered = [];
87
+ const scene = {
88
+ registerSystem: (s) => registered.push(s),
89
+ multiplayer: { placed: () => true, net: { send: (m) => sent.push(m) } },
90
+ };
91
+ system.trip = null;
92
+ system.pendingEnd = null;
93
+ State.hub.place = { id: 'main' };
94
+ system.registerInterest(scene);
95
+ system.interestFrame(scene, 0);
96
+ assert.deepEqual(sent, []);
97
+ assert.deepEqual(registered, []);
98
+ State.hub.place = { id: 'main', interest: 'cells', nearestPlayers: 48 };
99
+ system.registerInterest(scene);
100
+ system.registerInterest(scene);
101
+ assert.equal(registered.length, 1, 'one hook per resident scene');
102
+ system.interestTier = 'low';
103
+ system.interestFrame(scene, 20);
104
+ assert.deepEqual(sent.pop(), { k: 'hub-cap', n: 16 });
105
+ system.interestTier = 'high';
106
+ system.interestFrame(scene, 40);
107
+ assert.deepEqual(sent.pop(), { k: 'hub-cap', n: 48 });
108
+ system.interestFrame(scene, 60);
109
+ assert.deepEqual(sent, []);
110
+ State.hub.place = { id: 'main', interest: 'cells', nearestPlayers: 7 };
111
+ system.interestFrame(scene, 80);
112
+ assert.deepEqual(sent.pop(), { k: 'hub-cap', n: 7 }, 'fresh WORLD resets and resends place cap');
113
+ State.hub.place = { id: 'classic' };
114
+ system.interestFrame(scene, 100);
115
+ assert.deepEqual(sent, []);
116
+ console.log(
117
+ 'test-interest-client: real patch merge, private precedence, public opt-in, tiers, join reset and resident hook passed',
118
+ );
@@ -3,7 +3,7 @@
3
3
  // browser shortcuts pass. `npm run check` runs this.
4
4
 
5
5
  import assert from 'node:assert/strict';
6
- import { guardScrollKeys, swallowsScroll } from '../code/client/keys.js';
6
+ import { guardScrollKeys, swallowsScroll, takeKeys, wantsKeys } from '../code/client/keys.js';
7
7
 
8
8
  const key = (code, extra = {}) => ({ code, target: { tagName: 'CANVAS' }, defaultPrevented: false, ...extra });
9
9
 
@@ -47,4 +47,49 @@ assert.equal(prevented, 2);
47
47
  remove();
48
48
  assert.equal(listeners.has('keydown'), false);
49
49
 
50
+ // Taking the keyboard: only Castle's web player, on the deck's own page, with a
51
+ // mouse, and only when the frame does not have it already.
52
+ const frame = (over = {}) => {
53
+ const top = {};
54
+ const win = {
55
+ CastleEmbed: { edit: false, host: 'web' },
56
+ parent: top,
57
+ top,
58
+ matchMedia: (query) => ({ matches: query === '(pointer: fine)' }),
59
+ document: { hasFocus: () => false },
60
+ focused: 0,
61
+ focus() {
62
+ this.focused++;
63
+ },
64
+ ...over,
65
+ };
66
+ return win;
67
+ };
68
+ assert.equal(wantsKeys(frame()), true, 'the deck page on a desktop');
69
+ assert.equal(wantsKeys(frame({ CastleEmbed: { edit: false, host: 'dev' } })), false, 'the CLI and the editor');
70
+ assert.equal(wantsKeys(frame({ CastleEmbed: { edit: true, host: 'web' } })), false, 'editing');
71
+ assert.equal(wantsKeys(frame({ CastleEmbed: { edit: false, host: 'mobile' } })), false, 'the app');
72
+ assert.equal(wantsKeys(frame({ CastleEmbed: undefined })), false, 'no host');
73
+ assert.equal(wantsKeys(frame({ top: {} })), false, 'an embed or a Discord activity: the deck page is itself framed');
74
+ const alone = frame();
75
+ alone.parent = alone;
76
+ alone.top = alone;
77
+ assert.equal(wantsKeys(alone), false, 'not framed at all');
78
+ assert.equal(wantsKeys(frame({ matchMedia: () => ({ matches: false }) })), false, 'a phone');
79
+ assert.equal(wantsKeys(frame({ matchMedia: undefined })), false, 'no matchMedia');
80
+ assert.equal(wantsKeys(frame({ document: { hasFocus: () => true } })), false, 'already has the keyboard');
81
+
82
+ const asked = frame();
83
+ assert.equal(takeKeys(asked), true);
84
+ assert.equal(asked.focused, 1);
85
+ const phone = frame({ matchMedia: () => ({ matches: false }) });
86
+ assert.equal(takeKeys(phone), false);
87
+ assert.equal(phone.focused, 0);
88
+ const refuses = frame({
89
+ focus() {
90
+ throw new Error('blocked');
91
+ },
92
+ });
93
+ assert.equal(takeKeys(refuses), false);
94
+
50
95
  console.log('keys: all passed');