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,26 @@
1
+ // The hats this kit draws (contract §11): a wearable whose `kind` is
2
+ // `hat-<id>` for an id here. Ids only, and nothing imported, so a place's
3
+ // server may read the list (`@imports/castle.hub-game/code/client/hats.js`)
4
+ // to offer exactly the hats every client can draw; how each one is built is
5
+ // `wear.js`'s.
6
+ export const HAT_PREFIX = 'hat-';
7
+
8
+ export const HAT_SETS = {
9
+ stadium: ['sweatband', 'cap', 'foam-crown', 'laurel'],
10
+ hollow: ['bat-clip', 'witch', 'lantern', 'crooked-top'],
11
+ sunny: ['straw', 'flower-crown', 'beekeeper', 'sunflower'],
12
+ harbour: ['sailor', 'souwester', 'captain', 'lighthouse'],
13
+ };
14
+
15
+ export const HATS = Object.values(HAT_SETS).flat();
16
+
17
+ // The wearable kind of a hat id, and the hat id of a kind (null for a kind
18
+ // that is not one of these hats).
19
+ export function hatKind(id) {
20
+ return `${HAT_PREFIX}${id}`;
21
+ }
22
+
23
+ export function hatId(kind) {
24
+ const id = typeof kind === 'string' && kind.startsWith(HAT_PREFIX) ? kind.slice(HAT_PREFIX.length) : null;
25
+ return HATS.includes(id) ? id : null;
26
+ }
@@ -7,13 +7,48 @@
7
7
  import * as castleSdk from 'castle-web-sdk';
8
8
  import * as Avatars from '@imports/castle.multiplayer-3d/code/client/avatars.js';
9
9
  import * as Avatar from './avatar.js';
10
+ import * as AvatarCap from './avatarCap.js';
11
+ import { mergeDictionary } from './interestCap.js';
10
12
  import * as Cabinets from './cabinets.js';
11
13
  import { firstJoinFor } from './firstJoin.js';
12
- import { deck, hub } from './state.js';
14
+ import { deck, earnedNow, hub, mergeHidden, wearingNow } from './state.js';
15
+ import { clearShot, receiveShot } from './shot.js';
16
+ import * as Ballot from './ballot.js';
17
+ import * as Rehello from './rehello.js';
18
+ import { sanitise, ownStamp } from './companion.js';
19
+ import { buildStamp } from './build.js';
13
20
 
14
21
  // Root-anchored: the deck's own castle.json once this kit is imported.
15
22
  const castleJson = Object.values(import.meta.glob('/castle.json', { eager: true, import: 'default' }))[0] ?? {};
23
+ // The assembly's build stamp beside it; an absent file matches nothing.
24
+ deck.build = buildStamp(Object.values(import.meta.glob('/build.json', { eager: true, import: 'default' }))[0]);
16
25
  deck.tiers = castleJson?.hub?.tiers === true;
26
+ if (castleJson?.hub?.lowActorDistance === true) { deck.lowActorDistance = true; }
27
+ else { delete deck.lowActorDistance; }
28
+ if (castleJson?.hub?.lowActorBudget === true) { deck.lowActorBudget = true; }
29
+ else { delete deck.lowActorBudget; }
30
+ if (castleJson?.hub?.companionIdle === true) { deck.companionIdle = true; }
31
+ else { delete deck.companionIdle; }
32
+ deck.cues = castleJson?.hub?.cues === true;
33
+ deck.yourGames = castleJson?.hub?.yourGames === true;
34
+ if (castleJson?.hub?.avatarColors === true) {
35
+ deck.avatarColors = true;
36
+ }
37
+ deck.stuck = castleJson?.hub?.stuck === true;
38
+ deck.labels = castleJson?.hub?.labels === 'near';
39
+ // `hub.soundscape`: true, or an object with optional ground, ambience and UI.
40
+ const soundscape = castleJson?.hub?.soundscape;
41
+ deck.soundscape = soundscape === true || (soundscape && typeof soundscape === 'object' && !Array.isArray(soundscape)) ? {
42
+ babble: soundscape.babble !== false,
43
+ steps: soundscape.steps && typeof soundscape.steps === 'object' && !Array.isArray(soundscape.steps) ? soundscape.steps : soundscape.steps !== false,
44
+ ...(typeof soundscape.zones === 'string' ? { zones: soundscape.zones } : {}),
45
+ ...(soundscape.ambience && typeof soundscape.ambience === 'object' && !Array.isArray(soundscape.ambience) ? { ambience: soundscape.ambience } : {}),
46
+ ...(Object.hasOwn(soundscape, 'ui') && typeof soundscape.ui === 'boolean' ? { ui: soundscape.ui } : {}),
47
+ ...(Object.hasOwn(soundscape, 'cues') && typeof soundscape.cues === 'boolean' ? { cues: soundscape.cues } : {}),
48
+ } : null;
49
+ if (deck.soundscape?.cues === true) {
50
+ hub.cueEvents = [];
51
+ }
17
52
 
18
53
  let files = null;
19
54
  // The scene and multiplayer system of the newest snapshot, for a message that
@@ -24,27 +59,83 @@ let drawnStyle = null;
24
59
 
25
60
  // Everyone's avatars with this player's own over them. A player whose avatar
26
61
  // changed is dropped and respawns in the new one.
62
+ // A `hubAv2` block (v1.51) as a map, or an empty one for anything else.
63
+ function realAvatars(block) {
64
+ return new Map(Object.entries(block && typeof block === 'object' ? block : {}));
65
+ }
66
+
27
67
  function setAvatars(scene, system) {
28
68
  const next = new Map([...hub.avatarsAll, ...hub.avatarsMe]);
69
+ // v1.51: `hubAv` carries a stand-in from the first four for a player who
70
+ // wears a later avatar, for clients from before them; the one really worn
71
+ // is in `hubAv2`, and is the one drawn here. Only for a player `hubAv`
72
+ // lists, and only an avatar index.
73
+ // A viewer's block only names players omitted from the shared one. For a
74
+ // shared player, its real index (or its absence) wins over a stale message.
75
+ const own = [...hub.avatars2Me].filter(([playerId]) => !hub.avatarsAll.has(playerId));
76
+ for (const [playerId, avatar] of [...hub.avatars2All, ...own]) {
77
+ if (next.has(playerId) && Number.isInteger(avatar) && avatar >= 0) {
78
+ next.set(playerId, avatar);
79
+ }
80
+ }
81
+ const colors = new Map();
82
+ const ownColors = [...hub.avatarColorsMe].filter(([playerId]) => !hub.avatarsAll.has(playerId));
83
+ for (const [playerId, color] of [...hub.avatarColorsAll, ...ownColors]) {
84
+ if (next.has(playerId) && Number.isInteger(color) && color > 0 && color < 16) {
85
+ colors.set(playerId, color);
86
+ }
87
+ }
29
88
  if (system) {
30
- const keep = new Map(system.net?.others() ?? []);
31
- let changed = false;
89
+ const changed = [];
90
+ const later = new Set();
32
91
  for (const [playerId, avatar] of next) {
33
- if (hub.avatars.has(playerId) && hub.avatars.get(playerId) !== avatar) {
34
- keep.delete(playerId);
35
- changed = true;
92
+ const colorChanged = (hub.avatarColors.get(playerId) ?? 0) !== (colors.get(playerId) ?? 0);
93
+ if (hub.avatars.has(playerId) && (hub.avatars.get(playerId) !== avatar || colorChanged)) {
94
+ changed.push(playerId);
95
+ // Changes involving a later avatar must not restore its old fading
96
+ // actor. The first four keep their original fade behavior.
97
+ if (colorChanged || Avatar.known(hub.avatars.get(playerId)) >= Avatar.DEFAULT_AVATARS || Avatar.known(avatar) >= Avatar.DEFAULT_AVATARS) {
98
+ later.add(playerId);
99
+ }
36
100
  }
37
101
  }
38
- if (changed) {
39
- Avatars.dropMissing(system.avatars, scene, keep);
40
- }
102
+ redraw(scene, system, changed, later);
41
103
  }
42
104
  hub.avatars = next;
105
+ hub.avatarColors = colors;
43
106
  }
44
107
 
45
- // Everyone's wearables with this player's own over them (v1.4).
108
+ // Drops `playerIds`' bodies so each respawns in the avatar it is drawn as
109
+ // now (`hooks.avatar`). One of them still fading out in `fading` is taken
110
+ // down too, so it cannot come back as it was.
111
+ function redraw(scene, system, playerIds, fading) {
112
+ if (playerIds.length === 0) {
113
+ return;
114
+ }
115
+ const keep = new Map(system.net?.others() ?? []);
116
+ for (const playerId of playerIds) {
117
+ keep.delete(playerId);
118
+ const leaving = system.avatars.leaving.get(playerId);
119
+ if (leaving && fading.has(playerId)) {
120
+ if (scene.getActor(leaving.actorId)) {
121
+ system.avatars.retired?.add(leaving.actorId);
122
+ scene.despawnActor(leaving.actorId);
123
+ }
124
+ system.avatars.leaving.delete(playerId);
125
+ }
126
+ }
127
+ Avatars.dropMissing(system.avatars, scene, keep);
128
+ }
129
+
130
+ // Everyone's wearables with this player's own over them (v1.4), and over
131
+ // those whatever the place is showing on a player (v1.28, `hub.tryOn`).
46
132
  function setWearing() {
47
- hub.wearing = new Map([...hub.wearAll, ...hub.wearMe]);
133
+ hub.wearing = wearingNow();
134
+ }
135
+
136
+ // `{ spot, to }` of a place's word on "Stuck?" (v1.39).
137
+ function stuckAnswer(msg) {
138
+ return { spot: msg.spot === true, to: typeof msg.to === 'string' && msg.to ? msg.to.slice(0, 40) : null };
48
139
  }
49
140
 
50
141
  function wearMap(value) {
@@ -64,17 +155,67 @@ export default {
64
155
  return firstJoinFor(castleJson, castleSdk.Multiplayer);
65
156
  },
66
157
 
158
+ // Each deck message is marked with the player id it arrived under, so one
159
+ // from a session the connection has since left is dropped (`rehello.js`).
160
+ // Handles nothing: it goes on to the queue as before.
161
+ arrive(msg, system) {
162
+ Rehello.tag(msg, system?.net ?? null);
163
+ return false;
164
+ },
165
+
67
166
  message(scene, msg) {
68
167
  files = scene.files ?? files;
69
168
  switch (msg.k) {
169
+ case 'hub-companion':
170
+ // As actions: keep a private message before WORLD until its gate is known.
171
+ if ((!hub.place || hub.place.companion === true) && Number.isSafeInteger(msg.n) && msg.n >= 0) {
172
+ hub.companion = { c: sanitise(msg.c), n: msg.n, ...(hub.companion?.stamps !== undefined ? { stamps: hub.companion.stamps } : {}) };
173
+ }
174
+ break;
175
+ case 'hub-menu':
176
+ if ((!hub.place || hub.place.menu === true) && Number.isSafeInteger(msg.n) && msg.n >= 0 &&
177
+ (!hub.menu || msg.n > hub.menu.n)) {
178
+ hub.menu = { spec: msg.spec, n: msg.n };
179
+ }
180
+ break;
181
+ case 'hub-ask':
182
+ // Buffer before WORLD; a known keyless place keeps nothing.
183
+ if ((!hub.place || hub.place.ask === true) && Number.isSafeInteger(msg.n) &&
184
+ (!hub.ask || msg.n > hub.ask.n)) {
185
+ hub.ask = msg.id === null ? { id: null, n: msg.n } : { id: msg.id, title: msg.title, max: msg.max, n: msg.n };
186
+ }
187
+ break;
188
+ case 'hub-actions':
189
+ // Buffer before WORLD; nothing draws until the place is known to opt in.
190
+ // A WORLD naming a keyless place drops this private offer.
191
+ if (!hub.place || hub.place.actions === true) {
192
+ hub.actions = { items: msg.items ?? null, n: msg.n };
193
+ }
194
+ break;
195
+ case 'hub-decor':
196
+ hub.decor = { button: msg.button ?? null, spec: msg.spec ?? null, grid: msg.grid ?? null };
197
+ break;
198
+ case 'hub-shot':
199
+ // Accepted lease renewals refresh a held or resumable shot.
200
+ receiveShot(scene, msg.shot, msg.lease === true);
201
+ break;
202
+ case 'hub-home-unlock':
203
+ hub.commands.push(msg);
204
+ break;
70
205
  case 'hub-go':
71
206
  case 'hub-end':
72
207
  case 'hub-result':
208
+ if (msg.k !== 'hub-result') {
209
+ clearShot();
210
+ }
73
211
  hub.commands.push(msg);
74
212
  break;
75
213
  case 'hub-tune':
76
214
  hub.tune = msg.tune && typeof msg.tune === 'object' ? msg.tune : null;
77
215
  break;
216
+ case 'hub-leaving':
217
+ hub.leaving = typeof msg.text === 'string' ? msg.text.trim().slice(0, 120) || null : null;
218
+ break;
78
219
  case 'hub-hud':
79
220
  hub.hudMe = msg.hud ?? null;
80
221
  break;
@@ -85,11 +226,25 @@ export default {
85
226
  // A jump to a door: the camera turns to look at it.
86
227
  if (typeof msg.facing === 'number') {
87
228
  (scene.persistent ??= {}).camAngle = Math.PI - msg.facing;
229
+ // Under the engine's orbit camera key the facing is asked for.
230
+ if (scene.cameraControl === 'orbit') {
231
+ scene.faceRequest = msg.facing;
232
+ }
88
233
  }
89
234
  // Beside a player: the hub system says whom (a start next to a friend).
90
235
  if (typeof msg.to === 'string') {
91
236
  hub.jumpedTo = msg.to;
92
237
  }
238
+ // v1.39, after "Stuck?" in a place with the `unstick` hook: where it put this player.
239
+ if (deck.stuck && msg.stuck && typeof msg.stuck === 'object') {
240
+ hub.unstuck = stuckAnswer(msg.stuck);
241
+ }
242
+ break;
243
+ case 'hub-unstick-to':
244
+ // v1.39: what a tap on the chip would do now. Only a deck with `hub.stuck` asks.
245
+ if (deck.stuck) {
246
+ hub.stuckTo = stuckAnswer(msg);
247
+ }
93
248
  break;
94
249
  case 'hub-where':
95
250
  // Laid over what is known: one answer covers at most twelve players.
@@ -106,6 +261,14 @@ export default {
106
261
  hub.saidEvents.push(msg);
107
262
  }
108
263
  break;
264
+ case 'hub-yours':
265
+ if (deck.yourGames) {
266
+ hub.yours = { rows: Array.isArray(msg.rows) ? msg.rows.slice(0, 5) : [], hearts: Array.isArray(msg.hearts) ? msg.hearts.slice(0, 8) : [] };
267
+ }
268
+ return;
269
+ case 'hub-friends-wanted':
270
+ hub.friendsWanted = true;
271
+ break;
109
272
  case 'hub-party':
110
273
  hub.party = {
111
274
  members: Array.isArray(msg.members) ? msg.members : null,
@@ -116,18 +279,43 @@ export default {
116
279
  break;
117
280
  case 'hub-av':
118
281
  hub.avatarsMe = new Map(Object.entries(msg.hubAv && typeof msg.hubAv === 'object' ? msg.hubAv : {}));
282
+ // The message is whole: without `hubAv2`, none of them wears a later avatar.
283
+ hub.avatars2Me = realAvatars(msg.hubAv2);
284
+ hub.avatarColorsMe = realAvatars(msg.hubAvC);
119
285
  setAvatars(netSystem?.scene ?? scene, netSystem?.system ?? null);
120
286
  break;
121
287
  case 'hub-wear':
122
288
  hub.wearMe = wearMap(msg.hubWear);
123
289
  setWearing();
124
290
  break;
291
+ case 'hub-earned':
292
+ // v1.53: earned items of players in a hidden pair this player may see.
293
+ hub.earnedMe = wearMap(msg.hubEarned);
294
+ hub.earned = earnedNow();
295
+ break;
296
+ case 'hub-try':
297
+ // v1.28: try-ons of players in a hidden pair this player may see.
298
+ hub.tryMe = wearMap(msg.hubTry);
299
+ setWearing();
300
+ break;
301
+ case 'hub-ballot-card':
302
+ // v1.68: the one entry to the choice card (`ballot.js` `gate`).
303
+ Ballot.gate(hub.place, scene?.multiplayer?.net ?? null, msg.card);
304
+ break;
125
305
  case 'hub-labels':
126
306
  hub.labelsMe = msg.labels && typeof msg.labels === 'object' ? msg.labels : {};
127
307
  break;
308
+ case 'hub-vis':
309
+ hub.hiddenMe = new Set(Array.isArray(msg.hide) ? msg.hide : []);
310
+ hub.shownMe = new Set(Array.isArray(msg.show) ? msg.show : []);
311
+ mergeHidden();
312
+ break;
128
313
  case 'hub-npc':
129
314
  case 'hub-npc-line':
315
+ case 'hub-npc-opening':
130
316
  case 'hub-npc-notes':
317
+ case 'hub-npc-preferred':
318
+ case 'hub-npc-hooks':
131
319
  hub.npcEvents.push(msg);
132
320
  break;
133
321
  case 'hub-grab-deny':
@@ -140,10 +328,22 @@ export default {
140
328
  break;
141
329
  case 'hub-sound':
142
330
  // At most a few unplayed one-shots wait: a backgrounded tab plays none late.
143
- if (hub.soundEvents.length < 8) {
331
+ if (hub.soundEvents.length < 8 && (!hub.soundGate || hub.soundGate())) {
144
332
  hub.soundEvents.push(msg);
145
333
  }
146
334
  break;
335
+ case 'hub-cue':
336
+ // Independent of audio mute/gesture gates; private transport only.
337
+ if (hub.place?.companion === true && hub.companion?.c && ownStamp(msg)) {
338
+ hub.companion.stamps = (hub.companion.stamps ?? 0) + 1;
339
+ }
340
+ if (deck.soundscape?.cues === true && (!hub.soundGate || hub.soundGate())) {
341
+ const events = (hub.cueEvents ??= []);
342
+ if (events.length < 8) {
343
+ events.push(msg);
344
+ }
345
+ }
346
+ break;
147
347
  default:
148
348
  break;
149
349
  }
@@ -156,7 +356,45 @@ export default {
156
356
  hub.lastTAt = msg.localMs ?? performance.now();
157
357
  }
158
358
  if (msg.hubPlace) {
359
+ if (Object.hasOwn(hub, 'menu') && hub.place && hub.place.id !== msg.hubPlace.id) {
360
+ hub.menuClose?.();
361
+ delete hub.menu;
362
+ }
363
+ if (Object.hasOwn(hub, 'ask') && hub.place && hub.place.id !== msg.hubPlace.id) {
364
+ hub.askClose?.();
365
+ delete hub.ask;
366
+ }
159
367
  hub.place = msg.hubPlace;
368
+ if (hub.place.menu !== true) {
369
+ hub.menuClose?.();
370
+ delete hub.menuClose;
371
+ delete hub.menu;
372
+ }
373
+ if (hub.place.actions !== true && Object.hasOwn(hub, 'actions')) {
374
+ delete hub.actions;
375
+ }
376
+ if (hub.place.companion !== true) {
377
+ delete hub.companion;
378
+ delete hub.glow;
379
+ }
380
+ if (hub.place.ask !== true && Object.hasOwn(hub, 'ask')) {
381
+ hub.askClose?.();
382
+ delete hub.ask;
383
+ }
384
+ if (!hub.place.decor) {
385
+ delete hub.decor;
386
+ }
387
+ }
388
+ // v1.68: a card the gate held before the place was known is kept or
389
+ // dropped by it. Nothing unless the gate held one.
390
+ if (msg.hubPlace && Ballot.held) {
391
+ Ballot.settle(msg.hubPlace);
392
+ }
393
+ // v1.33: a snapshot (it carries `hubPlace`) says whether this place takes
394
+ // "Stuck?". Read only in a deck with `hub.stuck`.
395
+ if (deck.stuck && msg.hubPlace) {
396
+ const to = msg.hubStuck && typeof msg.hubStuck === 'object' ? msg.hubStuck.to : undefined;
397
+ hub.stuck = to === undefined ? null : { to: typeof to === 'string' && to ? to.slice(0, 40) : null, ...(msg.hubStuck.hook === true ? { hook: true } : {}) };
160
398
  }
161
399
  netSystem = { scene, system };
162
400
  // The viewer's set changed under a running page (the experiment answered
@@ -174,29 +412,83 @@ export default {
174
412
  system.avatars.leaving.clear();
175
413
  }
176
414
  drawnStyle = style;
415
+ // v1.51: `hubAv2` comes only from a place where someone wears a later
416
+ // avatar, `{}` once when the last is gone; a snapshot (it carries
417
+ // `hubPlace`) without it means nobody does.
418
+ const hadColors = hub.avatarColorsAll.size > 0;
419
+ if (msg.hubAvC && typeof msg.hubAvC === 'object') {
420
+ hub.avatarColorsAll = realAvatars(msg.hubAvC);
421
+ } else if (msg.hubPlace) {
422
+ hub.avatarColorsAll = new Map();
423
+ }
424
+ const hadReal = hub.avatars2All.size > 0;
425
+ if (msg.hubAv2 && typeof msg.hubAv2 === 'object') {
426
+ hub.avatars2All = realAvatars(msg.hubAv2);
427
+ } else if (msg.hubPlace && hadReal) {
428
+ hub.avatars2All = new Map();
429
+ }
177
430
  if (msg.hubAv) {
178
431
  hub.avatarsAll = new Map(Object.entries(msg.hubAv));
432
+ }
433
+ if (msg.hubAv || msg.hubAv2 || msg.hubAvC || (msg.hubPlace && (hadReal || hadColors))) {
179
434
  setAvatars(scene, system);
180
435
  }
436
+ // The farthest of too many different characters are drawn as their
437
+ // stand-ins (`avatarCap.js`); a change is a later avatar's either way.
438
+ if (system?.avatars) {
439
+ const swapped = AvatarCap.frame(scene, system);
440
+ redraw(scene, system, swapped, new Set(swapped));
441
+ }
442
+ if (hub.place?.companion === true) {
443
+ if (Array.isArray(msg.hubGlow)) {
444
+ hub.glow = new Set(msg.hubGlow.filter((id) => typeof id === 'string'));
445
+ } else if (msg.hubPlace) {
446
+ delete hub.glow;
447
+ }
448
+ }
181
449
  if (msg.hubWear) {
182
450
  hub.wearAll = wearMap(msg.hubWear);
183
451
  setWearing();
184
452
  }
453
+ // v1.53: only a place where someone shows an earned item sends this.
454
+ if (msg.hubEarned) {
455
+ hub.earnedAll = wearMap(msg.hubEarned);
456
+ hub.earned = earnedNow();
457
+ }
458
+ // v1.28: only a place that shows a try-on sends this. A snapshot (it
459
+ // carries `hubPlace`) without one means none is up. `tryMe` is not the
460
+ // snapshot's to clear: the place sends `hub-try` on the tick before a
461
+ // joiner's snapshot, and sends it again, empty or not, to a client that
462
+ // rejoins.
463
+ if (msg.hubTry && typeof msg.hubTry === 'object') {
464
+ hub.tryAll = wearMap(msg.hubTry);
465
+ setWearing();
466
+ } else if (msg.hubPlace && hub.tryAll.size > 0) {
467
+ hub.tryAll = new Map();
468
+ setWearing();
469
+ }
185
470
  if ('hud' in msg) {
186
471
  hub.hud = msg.hud ?? null;
187
472
  }
188
473
  if (msg.hidden) {
189
- hub.hidden = new Set(msg.hidden);
474
+ hub.hiddenAll = new Set(msg.hidden);
475
+ mergeHidden();
190
476
  }
191
477
  if (msg.tints) {
192
478
  hub.tints = msg.tints;
193
479
  }
480
+ if (msg.tintsD) {
481
+ hub.tints = mergeDictionary(hub.tints, msg.tintsD);
482
+ }
194
483
  if (msg.hubDoors) {
195
484
  hub.doors = msg.hubDoors;
196
485
  }
197
486
  if (msg.marks) {
198
487
  hub.marks = msg.marks;
199
488
  }
489
+ if (msg.marksD) {
490
+ hub.marks = mergeDictionary(hub.marks, msg.marksD);
491
+ }
200
492
  if (msg.spawnTemplates) {
201
493
  hub.spawnTemplates = msg.spawnTemplates;
202
494
  }
@@ -209,10 +501,21 @@ export default {
209
501
  if (msg.labels) {
210
502
  hub.labels = msg.labels;
211
503
  }
504
+ if (msg.labelsD) {
505
+ hub.labels = mergeDictionary(hub.labels, msg.labelsD);
506
+ }
507
+ // v1.27: only a place that keeps an object for a player sends this.
508
+ if (msg.hubKept && typeof msg.hubKept === 'object') {
509
+ hub.keptFor = new Map(Object.entries(msg.hubKept));
510
+ }
212
511
  // v1.6: only a place that turns idle play on sends these.
213
512
  if (msg.hubEmotes && typeof msg.hubEmotes === 'object') {
214
513
  hub.emotes = msg.hubEmotes;
215
514
  }
515
+ // v1.47: only a place where an NPC has emoted sends this.
516
+ if (msg.hubNpcEmotes && typeof msg.hubNpcEmotes === 'object') {
517
+ hub.npcEmotes = msg.hubNpcEmotes;
518
+ }
216
519
  if (msg.hubSeated && typeof msg.hubSeated === 'object') {
217
520
  hub.seated = msg.hubSeated;
218
521
  }
@@ -225,12 +528,22 @@ export default {
225
528
  // place they are not drawn, so nobody flashes in a default body. The set
226
529
  // is this viewer's own (`Avatar.style`).
227
530
  avatar(playerId, username) {
228
- const index = hub.avatars.has(playerId) ? hub.avatars.get(playerId) : null;
229
- const blueprint = index === null ? null : Avatar.blueprint(files, index);
531
+ // An index past this kit's own (a later kit's character) is drawn as one
532
+ // of the first four (`Avatar.known`), never left out.
533
+ // Or its stand-in while the cap has this player as one (`avatarCap.js`).
534
+ const index = AvatarCap.shown(playerId);
535
+ const blueprint = index === null ? null : Avatar.blueprint(files, index, Avatar.style(), AvatarCap.shownColor(playerId));
230
536
  return blueprint ? { blueprint, username } : null;
231
537
  },
232
538
 
233
539
  presence(status) {
234
540
  return status.solo ? 'solo' : `${status.others + 1} here`;
235
541
  },
542
+
543
+ reset() {
544
+ clearShot();
545
+ },
546
+ dispose() {
547
+ clearShot();
548
+ },
236
549
  };
@@ -0,0 +1,126 @@
1
+ // A clear HUD (contract v1.26, a place's `hud: { clear: true }`): the sizes
2
+ // and the geometry, with no DOM in them so `scripts/test-hud-clear.mjs` can
3
+ // hold them. The chrome (`chrome.js`) calls these only in a place that asks;
4
+ // a place that does not is drawn by the code it always was.
5
+ //
6
+ // Three rules. (1) A big line with a text line under it is drawn smaller, and
7
+ // always on one line, so the text stays in view; a big line alone keeps its
8
+ // 56 px. (2) What the chrome places over the world (labels, speech, marks,
9
+ // pointers, a cabinet's card, the result ribbon) is moved to just under the
10
+ // HUD's box when it would lie over it, never hidden and never off the bottom
11
+ // of the view. (3) On a short view (a
12
+ // phone on its side) the text keeps to two lines and the box to a share of
13
+ // the height.
14
+
15
+ // The big line as it always was, and as it is alone.
16
+ export const BIG_PX = 56;
17
+ // The big line over a text line, on a tall view and on a short one.
18
+ export const BIG_WITH_TEXT_PX = 32;
19
+ export const BIG_WITH_TEXT_SHORT_PX = 28;
20
+ // A long big line shrinks to fit, never below this; past it the line is cut
21
+ // with an ellipsis rather than wrapped.
22
+ export const BIG_MIN_PX = 18;
23
+ // The HUD box's own widest (`maxWidth: 70vw`) and its width when nothing in
24
+ // it is wider (it hangs from the middle of the screen, so half the view).
25
+ const HUD_MAX_SHARE = 0.7;
26
+ const HUD_MIN_SHARE = 0.5;
27
+ // A view this short or shorter, and wider than it is tall, is a phone on its
28
+ // side. (Not height alone: the web player's portrait card on a 360 px phone is
29
+ // about 475 px tall, and is a tall view.)
30
+ export const SHORT_VIEW_H = 480;
31
+ export const SHORT_TEXT_LINES = 2;
32
+ export const SHORT_HUD_SHARE = 0.4;
33
+ // Clear air kept between the HUD's box and what is moved under it.
34
+ export const HUD_GAP = 6;
35
+
36
+ // How wide a string is at weight 800 in the system face, in ems. An estimate
37
+ // on the wide side: the chrome measures the drawn line after and shrinks it
38
+ // again if this fell short (`fitPx`).
39
+ export function bigEms(text) {
40
+ let ems = 0;
41
+ for (const ch of String(text)) {
42
+ if (ch === ' ') {
43
+ ems += 0.3;
44
+ } else if (/[.,:;!'|]/.test(ch)) {
45
+ ems += 0.34;
46
+ } else if (/[0-9]/.test(ch)) {
47
+ ems += 0.64;
48
+ } else if (/[MW@%]/.test(ch) || ch.codePointAt(0) > 0x2000) {
49
+ ems += 1;
50
+ } else if (/[a-z]/.test(ch)) {
51
+ ems += 0.6;
52
+ } else {
53
+ ems += 0.74;
54
+ }
55
+ }
56
+ return ems;
57
+ }
58
+
59
+ // The HUD's layout for what it shows. `viewW`/`viewH` are the view in CSS
60
+ // pixels; `reserve` is the width taken at each side of the big line's row (the
61
+ // Back button and its margin), 0 for none.
62
+ // bigPx the big line's font size
63
+ // bigOneLine whether it is held to one line (cut with an ellipsis)
64
+ // bigMaxWidth the widest the big line may be, or null for no limit
65
+ // textLines how many lines the text keeps to, or null for no limit
66
+ // maxHeight the tallest the box may be, or null for no limit
67
+ export function hudLayout({ big, text, viewW, viewH, reserve = 0 }) {
68
+ const short = viewH <= SHORT_VIEW_H && viewW > viewH;
69
+ const layout = {
70
+ bigPx: BIG_PX,
71
+ bigOneLine: false,
72
+ bigMaxWidth: null,
73
+ textLines: short ? SHORT_TEXT_LINES : null,
74
+ maxHeight: short ? Math.round(viewH * SHORT_HUD_SHARE) : null,
75
+ };
76
+ if (!big || !text) {
77
+ return layout;
78
+ }
79
+ const avail = Math.max(
80
+ Math.round(viewW * HUD_MIN_SHARE),
81
+ Math.min(Math.round(viewW * HUD_MAX_SHARE), Math.floor(viewW - 2 * reserve)),
82
+ );
83
+ const base = short ? BIG_WITH_TEXT_SHORT_PX : BIG_WITH_TEXT_PX;
84
+ const ems = bigEms(big);
85
+ layout.bigPx = ems * base <= avail ? base : Math.max(BIG_MIN_PX, Math.floor(avail / ems));
86
+ layout.bigOneLine = true;
87
+ layout.bigMaxWidth = avail;
88
+ return layout;
89
+ }
90
+
91
+ // A line drawn at `px` that needs `needed` pixels where it has `room`: the
92
+ // size at which it fits, never below the least.
93
+ export function fitPx(px, room, needed) {
94
+ if (!(needed > room) || !(room > 0)) {
95
+ return px;
96
+ }
97
+ return Math.max(BIG_MIN_PX, Math.min(px, Math.floor((px * room) / needed)));
98
+ }
99
+
100
+ // The box of something the chrome hangs from a point: `anchor` "bottom" is
101
+ // centred over the point with its bottom edge on it (a label, a chip over a
102
+ // friend), "center" is centred on it (a chip at the screen's edge).
103
+ export function boxAt(x, y, width, height, anchor = 'bottom') {
104
+ const top = anchor === 'center' ? y - height / 2 : y - height;
105
+ return { left: x - width / 2, right: x + width / 2, top, bottom: top + height };
106
+ }
107
+
108
+ // How far down `box` must move to lie clear under the HUD's box (`hud`, or
109
+ // null while no HUD is drawn): 0 when it is beside it, over it or already
110
+ // under it. Both are { left, right, top, bottom } in CSS pixels. Nothing is
111
+ // pushed off the bottom of the view (`viewH`, when given): a box too tall to
112
+ // lie both under the HUD and whole on screen moves only as far as keeps its
113
+ // bottom edge in view, the HUD left over its top, and one already at or past
114
+ // the bottom is not moved.
115
+ export function pushBelow(box, hud, gap = HUD_GAP, viewH = Infinity) {
116
+ if (!hud) {
117
+ return 0;
118
+ }
119
+ if (box.right <= hud.left || box.left >= hud.right) {
120
+ return 0;
121
+ }
122
+ if (box.bottom <= hud.top || box.top >= hud.bottom + gap) {
123
+ return 0;
124
+ }
125
+ return Math.max(0, Math.min(hud.bottom + gap - box.top, viewH - box.bottom));
126
+ }