castle-web-cli 0.4.232 → 0.4.233

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (355) hide show
  1. package/dist/agent-failures.d.ts +8 -0
  2. package/dist/agent-failures.js +19 -2
  3. package/dist/agent-prompts.d.ts +1 -1
  4. package/dist/agent-prompts.js +10 -3
  5. package/dist/agent.d.ts +64 -3
  6. package/dist/agent.js +170 -81
  7. package/dist/castle-host/host.d.ts +1 -0
  8. package/dist/castle-host/host.js +51 -3
  9. package/dist/castleJson.d.ts +4 -2
  10. package/dist/castleJson.js +2 -0
  11. package/dist/check.d.ts +3 -1
  12. package/dist/check.js +11 -1
  13. package/dist/devSessionStorage.js +47 -1
  14. package/dist/importPinMismatch.d.ts +22 -0
  15. package/dist/importPinMismatch.js +77 -0
  16. package/dist/importRegression.js +3 -15
  17. package/dist/imports.d.ts +10 -3
  18. package/dist/imports.js +88 -20
  19. package/dist/index.js +5 -4
  20. package/dist/init.js +1 -1
  21. package/dist/platformDoc.js +22 -0
  22. package/dist/routerFences.d.ts +5 -0
  23. package/dist/routerFences.js +12 -2
  24. package/dist/save-deck.d.ts +5 -0
  25. package/dist/save-deck.js +37 -4
  26. package/dist/serve.js +3 -0
  27. package/dist/shell/assets/{index-D2tWM896.js → index-BjOxR-lW.js} +4 -4
  28. package/dist/shell/assets/index-MVLfNYd9.css +1 -0
  29. package/dist/shell/index.html +2 -2
  30. package/dist/taskSteer.d.ts +13 -0
  31. package/dist/taskSteer.js +22 -2
  32. package/kits/base/castle.json +1 -1
  33. package/kits/base/package-lock.json +1 -1
  34. package/kits/base/sdk/README.md +79 -2
  35. package/kits/base/sdk/avatar.d.ts +6 -2
  36. package/kits/base/sdk/avatar.js +12 -4
  37. package/kits/base/sdk/castle.d.ts +1 -1
  38. package/kits/base/sdk/commands.d.ts +14 -0
  39. package/kits/base/sdk/hub.d.ts +6 -2
  40. package/kits/base/sdk/hub.js +13 -0
  41. package/kits/base/sdk/multiplayer.js +17 -1
  42. package/kits/base/sdk/save.js +2 -1
  43. package/kits/base/sdk/server/hub.d.ts +87 -0
  44. package/kits/base/sdk/server/hub.js +70 -0
  45. package/kits/base/sdk/server/platformHandle.d.ts +31 -1
  46. package/kits/base/sdk/server/storage.d.ts +13 -0
  47. package/kits/base/sdk/server/storage.js +46 -0
  48. package/kits/base/sdk/server/wrapper.d.ts +36 -5
  49. package/kits/base/sdk/server/wrapper.js +83 -8
  50. package/kits/hub-game/CLAUDE.md +329 -11
  51. package/kits/hub-game/blueprints/avatar-10.scene +28 -0
  52. package/kits/hub-game/blueprints/avatar-11.scene +28 -0
  53. package/kits/hub-game/blueprints/avatar-12.scene +28 -0
  54. package/kits/hub-game/blueprints/avatar-13.scene +28 -0
  55. package/kits/hub-game/blueprints/avatar-14.scene +28 -0
  56. package/kits/hub-game/blueprints/avatar-15.scene +28 -0
  57. package/kits/hub-game/blueprints/avatar-4.scene +28 -0
  58. package/kits/hub-game/blueprints/avatar-5.scene +28 -0
  59. package/kits/hub-game/blueprints/avatar-6.scene +28 -0
  60. package/kits/hub-game/blueprints/avatar-7.scene +28 -0
  61. package/kits/hub-game/blueprints/avatar-8.scene +28 -0
  62. package/kits/hub-game/blueprints/avatar-9.scene +28 -0
  63. package/kits/hub-game/code/client/actorBudget.js +47 -0
  64. package/kits/hub-game/code/client/attention.js +11 -2
  65. package/kits/hub-game/code/client/avatar.js +309 -35
  66. package/kits/hub-game/code/client/avatarCap.js +228 -0
  67. package/kits/hub-game/code/client/avatarColors.js +70 -0
  68. package/kits/hub-game/code/client/avatarFaces.js +21 -0
  69. package/kits/hub-game/code/client/avatarShare.js +251 -0
  70. package/kits/hub-game/code/client/ballot.js +467 -0
  71. package/kits/hub-game/code/client/build.js +22 -0
  72. package/kits/hub-game/code/client/chrome.js +1144 -50
  73. package/kits/hub-game/code/client/companion.js +716 -0
  74. package/kits/hub-game/code/client/companionDress.js +99 -0
  75. package/kits/hub-game/code/client/decor.js +509 -0
  76. package/kits/hub-game/code/client/earned.js +131 -0
  77. package/kits/hub-game/code/client/emoteBubble.js +75 -0
  78. package/kits/hub-game/code/client/grab.js +339 -20
  79. package/kits/hub-game/code/client/hookLayer.js +299 -13
  80. package/kits/hub-game/code/client/idle.js +163 -22
  81. package/kits/hub-game/code/client/interestCap.js +81 -0
  82. package/kits/hub-game/code/client/keys.js +36 -0
  83. package/kits/hub-game/code/client/labelsNear.js +205 -0
  84. package/kits/hub-game/code/client/menuIcons.js +34 -0
  85. package/kits/hub-game/code/client/pack.js +6 -2
  86. package/kits/hub-game/code/client/packFormat.js +3 -3
  87. package/kits/hub-game/code/client/rehello.js +167 -0
  88. package/kits/hub-game/code/client/shot.js +92 -0
  89. package/kits/hub-game/code/client/sound.js +63 -8
  90. package/kits/hub-game/code/client/soundscape.js +1151 -0
  91. package/kits/hub-game/code/client/soundscapeActions.js +99 -0
  92. package/kits/hub-game/code/client/soundscapeAmbience.js +453 -0
  93. package/kits/hub-game/code/client/soundscapeBaked.js +143 -0
  94. package/kits/hub-game/code/client/soundscapeBusker.js +217 -0
  95. package/kits/hub-game/code/client/soundscapeCourt.js +200 -0
  96. package/kits/hub-game/code/client/soundscapeCrowd.js +331 -0
  97. package/kits/hub-game/code/client/soundscapeCues.js +362 -0
  98. package/kits/hub-game/code/client/soundscapeMap.js +181 -0
  99. package/kits/hub-game/code/client/soundscapeMarket.js +176 -0
  100. package/kits/hub-game/code/client/soundscapeMusic.js +126 -0
  101. package/kits/hub-game/code/client/soundscapeMusicEngine.js +460 -0
  102. package/kits/hub-game/code/client/soundscapeSimlish.js +737 -0
  103. package/kits/hub-game/code/client/soundscapeSongs.js +127 -0
  104. package/kits/hub-game/code/client/soundscapeSongsRound3.js +63 -0
  105. package/kits/hub-game/code/client/soundscapeSynthesis.js +168 -0
  106. package/kits/hub-game/code/client/soundscapeUi.js +211 -0
  107. package/kits/hub-game/code/client/soundscapeVoice.js +1209 -0
  108. package/kits/hub-game/code/client/soundscapeWaves.js +206 -0
  109. package/kits/hub-game/code/client/spin.js +101 -0
  110. package/kits/hub-game/code/client/state.js +109 -1
  111. package/kits/hub-game/code/client/stuck.js +259 -0
  112. package/kits/hub-game/code/client/talk.js +538 -47
  113. package/kits/hub-game/code/client/tiers.js +516 -27
  114. package/kits/hub-game/code/client/toastBand.js +37 -0
  115. package/kits/hub-game/code/client/together.js +32 -0
  116. package/kits/hub-game/code/client/visibility.js +43 -0
  117. package/kits/hub-game/code/client/wear.js +461 -170
  118. package/kits/hub-game/code/client/yours.js +199 -0
  119. package/kits/hub-game/code/companionSpec.js +45 -0
  120. package/kits/hub-game/code/privateText.js +7 -0
  121. package/kits/hub-game/code/server/actions.js +133 -0
  122. package/kits/hub-game/code/server/actors.js +9 -1
  123. package/kits/hub-game/code/server/ask.js +155 -0
  124. package/kits/hub-game/code/server/ballot.js +539 -0
  125. package/kits/hub-game/code/server/cells.js +100 -0
  126. package/kits/hub-game/code/server/companion.js +82 -0
  127. package/kits/hub-game/code/server/cues.js +70 -0
  128. package/kits/hub-game/code/server/decor.js +269 -0
  129. package/kits/hub-game/code/server/earned.js +461 -0
  130. package/kits/hub-game/code/server/friendBests.js +166 -0
  131. package/kits/hub-game/code/server/friendsAmong.js +232 -0
  132. package/kits/hub-game/code/server/history.js +5 -0
  133. package/kits/hub-game/code/server/hub.js +1254 -50
  134. package/kits/hub-game/code/server/idle.js +30 -11
  135. package/kits/hub-game/code/server/index.js +2 -2
  136. package/kits/hub-game/code/server/labels.js +28 -2
  137. package/kits/hub-game/code/server/manifest.js +378 -7
  138. package/kits/hub-game/code/server/menu.js +133 -0
  139. package/kits/hub-game/code/server/npcs.js +830 -80
  140. package/kits/hub-game/code/server/party.js +2 -2
  141. package/kits/hub-game/code/server/players.js +22 -0
  142. package/kits/hub-game/code/server/shot.js +110 -0
  143. package/kits/hub-game/code/server/standing.js +124 -0
  144. package/kits/hub-game/code/server/vis.js +113 -0
  145. package/kits/hub-game/code/server/wear.js +12 -0
  146. package/kits/hub-game/code/server/yours.js +59 -0
  147. package/kits/hub-game/code/shared/cues.js +9 -0
  148. package/kits/hub-game/code/shared/decor.js +41 -0
  149. package/kits/hub-game/code/shared/shot.js +19 -0
  150. package/kits/hub-game/code/shared/spin.js +57 -0
  151. package/kits/hub-game/code/systems/hub.js +845 -95
  152. package/kits/hub-game/docs/content-pack.md +1 -1
  153. package/kits/hub-game/docs/contract.md +2244 -61
  154. package/kits/hub-game/docs/home-pieces.md +64 -0
  155. package/kits/hub-game/models/avatar-10.pxmodel +28 -0
  156. package/kits/hub-game/models/avatar-11.pxmodel +28 -0
  157. package/kits/hub-game/models/avatar-12.pxmodel +27 -0
  158. package/kits/hub-game/models/avatar-13.pxmodel +24 -0
  159. package/kits/hub-game/models/avatar-14.pxmodel +29 -0
  160. package/kits/hub-game/models/avatar-15.pxmodel +24 -0
  161. package/kits/hub-game/models/avatar-4.pxmodel +29 -0
  162. package/kits/hub-game/models/avatar-5.pxmodel +27 -0
  163. package/kits/hub-game/models/avatar-6.pxmodel +26 -0
  164. package/kits/hub-game/models/avatar-7.pxmodel +25 -0
  165. package/kits/hub-game/models/avatar-8.pxmodel +24 -0
  166. package/kits/hub-game/models/avatar-9.pxmodel +30 -0
  167. package/kits/hub-game/models/earned/badge-round.pxmodel +100 -0
  168. package/kits/hub-game/models/earned/badge-shield.pxmodel +117 -0
  169. package/kits/hub-game/models/earned/badge-star.pxmodel +87 -0
  170. package/kits/hub-game/models/earned/belt-plain.pxmodel +72 -0
  171. package/kits/hub-game/models/earned/held-ball.pxmodel +43 -0
  172. package/kits/hub-game/models/earned/held-lantern.pxmodel +85 -0
  173. package/kits/hub-game/models/earned/held-net.pxmodel +57 -0
  174. package/kits/hub-game/models/earned/held-trophy.pxmodel +109 -0
  175. package/kits/hub-game/models/earned/pin-round.pxmodel +62 -0
  176. package/kits/hub-game/models/earned/sash-plain.pxmodel +66 -0
  177. package/kits/hub-game/models/earned/square/belt-plain.pxmodel +104 -0
  178. package/kits/hub-game/models/earned/square/sash-plain.pxmodel +98 -0
  179. package/kits/hub-game/models/hats/bat-clip.pxmodel +206 -0
  180. package/kits/hub-game/models/hats/beekeeper.pxmodel +149 -0
  181. package/kits/hub-game/models/hats/cap.pxmodel +162 -0
  182. package/kits/hub-game/models/hats/captain.pxmodel +178 -0
  183. package/kits/hub-game/models/hats/crooked-top.pxmodel +172 -0
  184. package/kits/hub-game/models/hats/flower-crown.pxmodel +451 -0
  185. package/kits/hub-game/models/hats/foam-crown.pxmodel +179 -0
  186. package/kits/hub-game/models/hats/lantern.pxmodel +230 -0
  187. package/kits/hub-game/models/hats/laurel.pxmodel +533 -0
  188. package/kits/hub-game/models/hats/lighthouse.pxmodel +96 -0
  189. package/kits/hub-game/models/hats/sailor.pxmodel +141 -0
  190. package/kits/hub-game/models/hats/souwester.pxmodel +131 -0
  191. package/kits/hub-game/models/hats/straw.pxmodel +139 -0
  192. package/kits/hub-game/models/hats/sunflower.pxmodel +406 -0
  193. package/kits/hub-game/models/hats/sweatband.pxmodel +112 -0
  194. package/kits/hub-game/models/hats/witch.pxmodel +147 -0
  195. package/kits/hub-game/package-lock.json +2 -0
  196. package/kits/hub-game/package.json +2 -1
  197. package/kits/hub-game/scripts/check.mjs +78 -11
  198. package/kits/hub-game/scripts/companion-follower-wire.json +1 -0
  199. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +121 -0
  200. package/kits/hub-game/scripts/fixtures/decor-keyless.json +293 -0
  201. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +23 -0
  202. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +107 -0
  203. package/kits/hub-game/scripts/fixtures/interest-legacy.json +385 -0
  204. package/kits/hub-game/scripts/fixtures/npc-notes-v1.77.jsonl +4 -0
  205. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -0
  206. package/kits/hub-game/scripts/gen-avatars.mjs +933 -16
  207. package/kits/hub-game/scripts/gen-earned.mjs +285 -0
  208. package/kits/hub-game/scripts/gen-hats.mjs +827 -0
  209. package/kits/hub-game/scripts/grab.before-orbit.mjs +400 -0
  210. package/kits/hub-game/scripts/soundscape-wave-analysis.mjs +125 -0
  211. package/kits/hub-game/scripts/test-actions-client.mjs +488 -0
  212. package/kits/hub-game/scripts/test-actions.mjs +298 -0
  213. package/kits/hub-game/scripts/test-actor-budget.mjs +44 -0
  214. package/kits/hub-game/scripts/test-actors.mjs +19 -17
  215. package/kits/hub-game/scripts/test-ask-client.mjs +358 -0
  216. package/kits/hub-game/scripts/test-ask.mjs +269 -0
  217. package/kits/hub-game/scripts/test-attention.mjs +10 -1
  218. package/kits/hub-game/scripts/test-avatar-cap.mjs +379 -0
  219. package/kits/hub-game/scripts/test-avatar-colors.mjs +72 -0
  220. package/kits/hub-game/scripts/test-avatar-models.mjs +181 -0
  221. package/kits/hub-game/scripts/test-avatar-share.mjs +318 -0
  222. package/kits/hub-game/scripts/test-avatar-wire.mjs +753 -0
  223. package/kits/hub-game/scripts/test-avatar.mjs +540 -7
  224. package/kits/hub-game/scripts/test-ballot.mjs +1001 -0
  225. package/kits/hub-game/scripts/test-build.mjs +31 -0
  226. package/kits/hub-game/scripts/test-cells.mjs +71 -0
  227. package/kits/hub-game/scripts/test-chat.mjs +662 -0
  228. package/kits/hub-game/scripts/test-classic.mjs +2 -0
  229. package/kits/hub-game/scripts/test-companion-chat.mjs +198 -0
  230. package/kits/hub-game/scripts/test-companion-client.mjs +1167 -0
  231. package/kits/hub-game/scripts/test-companion.mjs +259 -0
  232. package/kits/hub-game/scripts/test-decor-client.mjs +303 -0
  233. package/kits/hub-game/scripts/test-decor.mjs +457 -0
  234. package/kits/hub-game/scripts/test-earned-client.mjs +459 -0
  235. package/kits/hub-game/scripts/test-earned.mjs +1194 -0
  236. package/kits/hub-game/scripts/test-emote-bubble.mjs +110 -0
  237. package/kits/hub-game/scripts/test-friend-bests.mjs +435 -0
  238. package/kits/hub-game/scripts/test-grab-orbit.mjs +918 -0
  239. package/kits/hub-game/scripts/test-grab.mjs +7 -0
  240. package/kits/hub-game/scripts/test-hats.mjs +422 -168
  241. package/kits/hub-game/scripts/test-hub-leaving.mjs +203 -0
  242. package/kits/hub-game/scripts/test-hub-ops.mjs +439 -2
  243. package/kits/hub-game/scripts/test-hub-trip.mjs +716 -2
  244. package/kits/hub-game/scripts/test-hud-clear.mjs +328 -4
  245. package/kits/hub-game/scripts/test-idle.mjs +361 -1
  246. package/kits/hub-game/scripts/test-interest-cap.mjs +36 -0
  247. package/kits/hub-game/scripts/test-interest-cells.mjs +493 -0
  248. package/kits/hub-game/scripts/test-interest-client.mjs +118 -0
  249. package/kits/hub-game/scripts/test-keys.mjs +46 -1
  250. package/kits/hub-game/scripts/test-labels.mjs +596 -0
  251. package/kits/hub-game/scripts/test-manifest.mjs +207 -0
  252. package/kits/hub-game/scripts/test-menu-client.mjs +480 -0
  253. package/kits/hub-game/scripts/test-menu.mjs +296 -0
  254. package/kits/hub-game/scripts/test-npcs.mjs +1718 -12
  255. package/kits/hub-game/scripts/test-object-entry.mjs +76 -0
  256. package/kits/hub-game/scripts/test-pack.mjs +7 -0
  257. package/kits/hub-game/scripts/test-picker.mjs +314 -0
  258. package/kits/hub-game/scripts/test-rehello.mjs +1039 -0
  259. package/kits/hub-game/scripts/test-relations-among.mjs +222 -0
  260. package/kits/hub-game/scripts/test-relations-refresh.mjs +188 -0
  261. package/kits/hub-game/scripts/test-shot.mjs +756 -0
  262. package/kits/hub-game/scripts/test-soundscape.mjs +5432 -0
  263. package/kits/hub-game/scripts/test-spin.mjs +314 -0
  264. package/kits/hub-game/scripts/test-standing.mjs +416 -0
  265. package/kits/hub-game/scripts/test-stuck.mjs +1903 -0
  266. package/kits/hub-game/scripts/test-tier-cells.mjs +706 -0
  267. package/kits/hub-game/scripts/test-tiers-render.mjs +339 -0
  268. package/kits/hub-game/scripts/test-tiers.mjs +477 -2
  269. package/kits/hub-game/scripts/test-toast-band.mjs +61 -0
  270. package/kits/hub-game/scripts/test-try-on.mjs +22 -22
  271. package/kits/hub-game/scripts/test-vis.mjs +343 -0
  272. package/kits/hub-game/scripts/test-visibility.mjs +134 -0
  273. package/kits/hub-game/scripts/test-yours-chrome.mjs +166 -0
  274. package/kits/hub-game/scripts/test-yours.mjs +372 -0
  275. package/kits/multiplayer-3d/CLAUDE.md +50 -0
  276. package/kits/multiplayer-3d/castle.json +5 -5
  277. package/kits/multiplayer-3d/code/client/avatars.js +7 -0
  278. package/kits/multiplayer-3d/code/client/gait.js +65 -0
  279. package/kits/multiplayer-3d/code/client/nameTags.js +59 -4
  280. package/kits/multiplayer-3d/code/options.js +5 -0
  281. package/kits/multiplayer-3d/code/server/ownership.js +10 -2
  282. package/kits/multiplayer-3d/code/server/sceneBodies.js +12 -0
  283. package/kits/multiplayer-3d/code/server/world.js +7 -0
  284. package/kits/multiplayer-3d/code/systems/multiplayer.js +74 -4
  285. package/kits/multiplayer-3d/package.json +2 -1
  286. package/kits/multiplayer-3d/scripts/fixtures/README.md +11 -0
  287. package/kits/multiplayer-3d/scripts/fixtures/ownership-legacy.json +2 -0
  288. package/kits/multiplayer-3d/scripts/ownership-harness.mjs +102 -0
  289. package/kits/multiplayer-3d/scripts/ownership-loader.mjs +46 -0
  290. package/kits/multiplayer-3d/scripts/ownership-worker.mjs +15 -0
  291. package/kits/multiplayer-3d/scripts/record-ownership-session.mjs +98 -0
  292. package/kits/multiplayer-3d/scripts/test-eligible-claims.mjs +167 -0
  293. package/kits/multiplayer-3d/scripts/test-own-name-tag.mjs +247 -0
  294. package/kits/physics-2d/CLAUDE.md +9 -0
  295. package/kits/physics-2d/castle.json +2 -2
  296. package/kits/physics-2d/engine/scene.js +253 -1
  297. package/kits/physics-2d/engine/skyKey.js +129 -0
  298. package/kits/physics-2d/engine/stillClock.js +106 -0
  299. package/kits/physics-2d/engine/updateBudget.js +21 -0
  300. package/kits/physics-2d/scripts/test-skip-unchanged.mjs +326 -1
  301. package/kits/physics-3d/CLAUDE.md +1169 -30
  302. package/kits/physics-3d/behaviors/Player.jsx +629 -72
  303. package/kits/physics-3d/castle.json +3 -3
  304. package/kits/physics-3d/docs/pxmodel-format.md +8 -0
  305. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +69 -13
  306. package/kits/physics-3d/engine3d/actornode.js +86 -0
  307. package/kits/physics-3d/engine3d/animationBudget.js +23 -0
  308. package/kits/physics-3d/engine3d/editorWorld.js +6 -0
  309. package/kits/physics-3d/engine3d/emptynodes.js +232 -0
  310. package/kits/physics-3d/engine3d/framecap.js +96 -0
  311. package/kits/physics-3d/engine3d/gait.js +118 -0
  312. package/kits/physics-3d/engine3d/kithooks.js +47 -0
  313. package/kits/physics-3d/engine3d/look.js +507 -48
  314. package/kits/physics-3d/engine3d/lookbake.js +208 -0
  315. package/kits/physics-3d/engine3d/materialpresets.js +2 -0
  316. package/kits/physics-3d/engine3d/motion.js +39 -10
  317. package/kits/physics-3d/engine3d/nearshadows.js +37 -19
  318. package/kits/physics-3d/engine3d/optimize.js +9 -5
  319. package/kits/physics-3d/engine3d/orbitinput.js +487 -9
  320. package/kits/physics-3d/engine3d/orbitlens.js +48 -0
  321. package/kits/physics-3d/engine3d/ownmodel.js +213 -0
  322. package/kits/physics-3d/engine3d/pxmodel.js +42 -11
  323. package/kits/physics-3d/engine3d/shadowfade.js +882 -0
  324. package/kits/physics-3d/engine3d/sky.js +547 -0
  325. package/kits/physics-3d/engine3d/skylife.js +306 -0
  326. package/kits/physics-3d/engine3d/unchanged.js +11 -0
  327. package/kits/physics-3d/engine3d/viewrange.js +52 -0
  328. package/kits/physics-3d/engine3d/world3d.js +796 -69
  329. package/kits/physics-3d/main.jsx +5 -0
  330. package/kits/physics-3d/package.json +1 -1
  331. package/kits/physics-3d/scripts/look-baseline.mjs +155 -0
  332. package/kits/physics-3d/scripts/test-camera-orbit.mjs +2563 -80
  333. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +1 -1
  334. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +435 -0
  335. package/kits/physics-3d/scripts/test-frame-cap.mjs +452 -0
  336. package/kits/physics-3d/scripts/test-gait.mjs +387 -0
  337. package/kits/physics-3d/scripts/test-look-bake.mjs +1056 -0
  338. package/kits/physics-3d/scripts/test-model-parse-cache.mjs +92 -0
  339. package/kits/physics-3d/scripts/test-near-shadows.mjs +3 -0
  340. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +1920 -0
  341. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +545 -0
  342. package/kits/physics-3d/scripts/test-orbit-shot.mjs +583 -0
  343. package/kits/physics-3d/scripts/test-orbit-view.mjs +230 -0
  344. package/kits/physics-3d/scripts/test-skip-empty-nodes.mjs +845 -0
  345. package/kits/physics-3d/scripts/test-sky.mjs +2470 -0
  346. package/kits/physics-3d/scripts/test-static-actors.mjs +8 -1
  347. package/kits/physics-3d/scripts/test-static-scenery.mjs +2171 -0
  348. package/kits/physics-3d/scripts/test-steady-hover.mjs +2 -0
  349. package/kits/physics-3d/scripts/test-view-range.mjs +260 -0
  350. package/kits/physics-3d/systems/physics3d.js +383 -6
  351. package/kits/real-time/castle.json +2 -2
  352. package/kits/real-time/code/server/gameHooks.js +7 -0
  353. package/kits/real-time/code/server/session.js +97 -19
  354. package/package.json +2 -2
  355. package/dist/shell/assets/index-Cf61cNfT.css +0 -1
@@ -0,0 +1,459 @@
1
+ // Earned items (contract §11, v1.53), the client half: the models
2
+ // (models/earned/<shape>.pxmodel, scripts/gen-earned.mjs), where each class
3
+ // sits on every avatar (avatar.js `earnedFit`, measured here against the
4
+ // avatar models built by physics-3d's own builder), the item's colour on the
5
+ // main materials only, and `makeEarned` drawing under the avatar's own node.
6
+ // An unknown shape, or one of another class, is kept and not drawn.
7
+ // castle-web-sdk is stubbed (scripts/fixtures/sdk-stub.mjs). `npm run check`
8
+ // runs this.
9
+
10
+ import assert from 'node:assert/strict';
11
+ import fs from 'node:fs';
12
+ import { register } from 'node:module';
13
+
14
+ const hooks = `
15
+ import { existsSync } from 'node:fs';
16
+ import { fileURLToPath } from 'node:url';
17
+ const SDK = ${JSON.stringify(new URL('./fixtures/sdk-stub.mjs', import.meta.url).href)};
18
+ const KITS = ${JSON.stringify(new URL('../../', import.meta.url).href)};
19
+ export async function resolve(specifier, context, next) {
20
+ if (specifier === 'castle-web-sdk') {
21
+ return { url: SDK, shortCircuit: true };
22
+ }
23
+ for (const kit of ['physics-2d', 'physics-3d']) {
24
+ if (specifier.startsWith('@imports/castle.' + kit + '/')) {
25
+ specifier = KITS + kit + '/' + specifier.slice(('@imports/castle.' + kit + '/').length);
26
+ }
27
+ }
28
+ const parent = context.parentURL ?? '';
29
+ if ((specifier.startsWith('.') || specifier.startsWith('file:')) && parent.includes('/kits/') && !/\\.(m?js|jsx|json)$/.test(specifier)) {
30
+ const base = new URL(specifier, parent).href;
31
+ for (const ext of ['.js', '.jsx']) if (existsSync(fileURLToPath(base + ext))) return next(base + ext, context);
32
+ }
33
+ return next(specifier, context);
34
+ }`;
35
+ register(`data:text/javascript,${encodeURIComponent(hooks)}`);
36
+
37
+ const THREE = await import('three');
38
+ const Avatar = await import('../code/client/avatar.js');
39
+ const Earned = await import('../code/client/earned.js');
40
+ const { makeEarned } = await import('../code/client/wear.js');
41
+ const ServerEarned = await import('../code/server/earned.js');
42
+ const Gen = await import('./gen-earned.mjs');
43
+ const { buildModelNode, parseModel, visibleBounds } = await import('../../physics-3d/engine3d/pxmodel.js');
44
+
45
+ let n = 0;
46
+ function test(name, fn) {
47
+ fn();
48
+ n += 1;
49
+ console.log(`ok: ${name}`);
50
+ }
51
+
52
+ const MODEL_FEET_Y = -0.7;
53
+ const read = (shape) => fs.readFileSync(new URL(`../${Earned.earnedFile(shape)}`, import.meta.url), 'utf8');
54
+ const build = (file, text, optimize = true) => {
55
+ const root = buildModelNode(parseModel(text), null, { [file]: text }, file, [file], { optimize });
56
+ root.updateMatrixWorld(true);
57
+ return root;
58
+ };
59
+ const colorsOf = (root) => {
60
+ const out = new Set();
61
+ root.traverse((o) => {
62
+ if (o.isMesh && !o.userData.lookOutline) {
63
+ for (const m of Array.isArray(o.material) ? o.material : [o.material]) {
64
+ out.add(`#${m.color.getHexString()}`);
65
+ }
66
+ }
67
+ });
68
+ return out;
69
+ };
70
+
71
+ test('the shapes a server reads are the models the kit has, the generator writes them, small', () => {
72
+ assert.deepEqual(Earned.EARNED_SHAPES, Gen.SHAPE_IDS);
73
+ assert.deepEqual(Earned.EARNED_SHAPES, [
74
+ 'badge-round',
75
+ 'badge-star',
76
+ 'badge-shield',
77
+ 'pin-round',
78
+ 'belt-plain',
79
+ 'sash-plain',
80
+ 'held-lantern',
81
+ 'held-trophy',
82
+ 'held-net',
83
+ 'held-ball',
84
+ ]);
85
+ assert.deepEqual(Earned.EARNED_CLASSES, ServerEarned.EARNED_CLASSES);
86
+ for (const shape of Earned.EARNED_SHAPES) {
87
+ const text = read(shape);
88
+ assert.equal(text, `${JSON.stringify(Gen.earnedModel(shape), null, 1)}\n`, `${shape}: run node scripts/gen-earned.mjs`);
89
+ assert.ok(ServerEarned.ITEM_ID.test(shape));
90
+ assert.ok(Earned.EARNED_CLASSES.includes(Earned.EARNED_SHAPE_CLASS[shape]));
91
+ const model = parseModel(text);
92
+ assert.ok(model && text.length <= 2000, `${shape}: ${text.length} bytes`);
93
+ assert.equal(model.look.outline > 0, true, 'the avatars\' outline look');
94
+ // Its main colour is a part's colour, and something else is a trim.
95
+ assert.ok(model.parts.some((p) => p.color === Earned.EARNED_MAIN), shape);
96
+ assert.ok(model.parts.some((p) => p.color !== Earned.EARNED_MAIN), shape);
97
+ const root = build(Earned.earnedFile(shape), text);
98
+ let triangles = 0;
99
+ root.traverse((o) => {
100
+ if (o.isMesh && !o.userData.lookOutline) {
101
+ const g = o.geometry;
102
+ triangles += (g.index ? g.index.count : g.attributes.position.count) / 3;
103
+ }
104
+ });
105
+ assert.ok(triangles <= 400, `${shape}: ${triangles} triangles`);
106
+ // Small: a chest item within 15 cm (drawn 1.3 times that), a held one within 65 cm.
107
+ const box = visibleBounds(root);
108
+ const size = box.getSize(new THREE.Vector3());
109
+ const cls = Earned.EARNED_SHAPE_CLASS[shape];
110
+ if (cls === 'badge' || cls === 'pin') {
111
+ assert.ok(Math.max(size.x, size.y) <= 0.15 && size.z <= 0.04 && box.min.z >= -0.001, `${shape}: ${JSON.stringify(size)}`);
112
+ } else if (cls === 'held') {
113
+ assert.ok(Math.max(size.x, size.y, size.z) <= 0.65, `${shape}: ${JSON.stringify(size)}`);
114
+ } else {
115
+ assert.ok(Math.abs(box.max.x - 0.216) < 0.03, `${shape} goes round the 0.2 m ring`);
116
+ }
117
+ }
118
+ });
119
+
120
+ test('the square belt and sash are the generator\'s, for a boxy body, and lie flat on a box', () => {
121
+ assert.deepEqual(Earned.SQUARE_SHAPES, Object.keys(Gen.SQUARE));
122
+ for (const shape of Earned.SQUARE_SHAPES) {
123
+ const file = Earned.earnedFile(shape, true);
124
+ assert.equal(file, `models/earned/square/${shape}.pxmodel`);
125
+ const text = fs.readFileSync(new URL(`../${file}`, import.meta.url), 'utf8');
126
+ assert.equal(text, `${JSON.stringify(Gen.earnedModel(shape, true), null, 1)}\n`, `${shape}: run node scripts/gen-earned.mjs`);
127
+ const model = parseModel(text);
128
+ assert.ok(model.parts.some((p) => p.color === Earned.EARNED_MAIN));
129
+ const box = visibleBounds(build(file, text));
130
+ // Its sides stand 0.2 m out, flat: as wide at a corner as at a side.
131
+ assert.ok(Math.abs(box.max.x - 0.216) < 0.01 && Math.abs(box.min.z + 0.216) < 0.01, shape);
132
+ }
133
+ });
134
+
135
+ test("the item's colour takes the main materials; trims keep theirs; the glow badge glows in it", () => {
136
+ const color = '#c03050';
137
+ for (const shape of Earned.EARNED_SHAPES) {
138
+ const text = read(shape);
139
+ const trims = new Set(parseModel(text).parts.map((p) => p.color).filter((c) => c !== Earned.EARNED_MAIN));
140
+ const tinted = Earned.tinted(text, color.toUpperCase());
141
+ assert.ok(!tinted.includes(Earned.EARNED_MAIN), shape);
142
+ const colors = colorsOf(build(Earned.earnedFile(shape), tinted, false));
143
+ assert.ok(colors.has(color), `${shape}: ${[...colors]}`);
144
+ for (const trim of trims) {
145
+ assert.ok(colors.has(trim.toLowerCase()), `${shape}: trim ${trim} kept`);
146
+ }
147
+ }
148
+ const glow = parseModel(Earned.tinted(read('badge-round'), color)).parts.filter((p) => p.emissive === color);
149
+ // The glow badge's face glows a little in its colour; the soft glow behind
150
+ // every badge is the client's (`wear.js`), not a hard-edged disc in a model.
151
+ assert.ok(glow.length >= 1 && glow.every((p) => p.emissiveIntensity > 0 && p.emissiveIntensity <= 1));
152
+ for (const shape of ['badge-round', 'badge-star', 'badge-shield']) {
153
+ const wide = parseModel(read(shape)).parts.filter((p) => ['cylinder', 'torus', 'sphere'].includes(p.kind) && p.radius > 0.07).map((p) => `${p.id} ${p.radius}`);
154
+ assert.deepEqual(wide, [], `${shape}: no disc wider than the badge`);
155
+ }
156
+ });
157
+
158
+ // Every avatar, measured: its body (torso and head meshes), its face's lowest
159
+ // point and its right hand.
160
+ function measure(style, index) {
161
+ // The other sets draw 4-15 from toon's model (v1.51).
162
+ if (style !== 'toon' && index >= 4) {
163
+ return measure('toon', index);
164
+ }
165
+ const file = `models/${style === 'toon' ? '' : `${style}/`}avatar-${index}.pxmodel`;
166
+ const root = build(file, fs.readFileSync(new URL(`../${file}`, import.meta.url), 'utf8'), false);
167
+ const body = [];
168
+ const hand = [];
169
+ const face = new THREE.Box3();
170
+ root.traverse((o) => {
171
+ if (!o.isMesh || o.userData.lookOutline) {
172
+ return;
173
+ }
174
+ const id = o.userData.partMesh ?? '';
175
+ if (id === 'torso' || id === 'head') {
176
+ body.push(o);
177
+ }
178
+ if (id === 'handR' || id === 'armR') {
179
+ hand.push(o);
180
+ }
181
+ if (/eye|pupil|mouth|smile|cheek|glint|face|tongue/.test(id)) {
182
+ face.union(new THREE.Box3().setFromObject(o));
183
+ }
184
+ });
185
+ // Castle (pixel 0) has its eye drawn on its body: rows 2-7 of 12 from the
186
+ // top of a body 0.28-1.12 m, the columns on its left (+x) of the middle.
187
+ if (style === 'pixel' && index === 0) {
188
+ face.set(new THREE.Vector3(-0.07, 0.56, 0.3), new THREE.Vector3(0.39, 0.98, 0.4));
189
+ }
190
+ // Toon's one-eyed Blob: its `head` is the white of its eye.
191
+ if (style === 'toon' && index === 0) {
192
+ body.filter((o) => o.userData.partMesh === 'head').forEach((o) => face.expandByObject(o));
193
+ }
194
+ if (face.isEmpty()) {
195
+ // A pixel avatar's face is drawn on its head, inside a pixel of its sides.
196
+ const head = new THREE.Box3();
197
+ body.filter((o) => o.userData.partMesh === 'head').forEach((o) => head.expandByObject(o));
198
+ face.copy(head).expandByVector(new THREE.Vector3(-0.07, 0, 0));
199
+ }
200
+ const ray = new THREE.Raycaster();
201
+ const hit = (from, dir) => {
202
+ ray.set(from, dir);
203
+ return ray.intersectObjects(body, false)[0]?.point ?? null;
204
+ };
205
+ const handBox = new THREE.Box3();
206
+ hand.forEach((o) => handBox.expandByObject(o));
207
+ // A head that stands over the body (not a one-piece body's, whose head is
208
+ // its face or the whole of it): its lowest point.
209
+ const onePiece = style === 'bean' || (index === 0 && style !== 'bean');
210
+ const head = new THREE.Box3();
211
+ body.filter((o) => o.userData.partMesh === 'head').forEach((o) => head.expandByObject(o));
212
+ const headBottom = onePiece || head.isEmpty() ? Infinity : head.min.y;
213
+ return { face, hit, handBox, headBottom };
214
+ }
215
+
216
+ // How far a badge and a pin reach from their middle as drawn (the largest of
217
+ // their shapes).
218
+ const reach = (cls, k) =>
219
+ Math.max(
220
+ ...Earned.EARNED_SHAPES.filter((shape) => Earned.EARNED_SHAPE_CLASS[shape] === cls).map((shape) => {
221
+ const box = visibleBounds(build(Earned.earnedFile(shape), read(shape)));
222
+ return Math.max(-box.min.x, box.max.x, -box.min.y, box.max.y) * k;
223
+ }),
224
+ );
225
+ const BADGE_REACH = reach('badge', Earned.BADGE_SCALE);
226
+ const PIN_REACH = reach('pin', Earned.PIN_SCALE);
227
+
228
+ // What a held thing covers, drawn at its fit: its model's box, scaled about
229
+ // the grip and moved to the hand.
230
+ const heldBoxes = Object.fromEntries(
231
+ Earned.EARNED_SHAPES.filter((shape) => Earned.EARNED_SHAPE_CLASS[shape] === 'held').map((shape) => [
232
+ shape,
233
+ visibleBounds(build(Earned.earnedFile(shape), read(shape))),
234
+ ]),
235
+ );
236
+
237
+ test('each class sits where it belongs on every avatar, measured against its model, and never on the face', () => {
238
+ for (const style of Avatar.STYLES) {
239
+ for (let index = 0; index < Avatar.AVATARS; index += 1) {
240
+ const where = `${style} ${index}`;
241
+ const fit = Avatar.earnedFit(index, style);
242
+ const { face, hit, handBox, headBottom } = measure(style, index);
243
+ const fromSide = (y) => Math.max(hit(new THREE.Vector3(3, y, 0), new THREE.Vector3(-1, 0, 0))?.x ?? 0, -(hit(new THREE.Vector3(-3, y, 0), new THREE.Vector3(1, 0, 0))?.x ?? 0));
244
+ const fromFront = (y) => hit(new THREE.Vector3(0, y, 3), new THREE.Vector3(0, 0, -1))?.z ?? 0;
245
+ // Chest: on the front of the body, left of its middle, and no part of
246
+ // the body under it standing through it; the badge as drawn (about 2.6
247
+ // times its model) clear of the face and of a head over the body.
248
+ const [x, y, z, yaw, size = 1] = fit.chest;
249
+ const front = hit(new THREE.Vector3(x, y, 3), new THREE.Vector3(0, 0, -1));
250
+ assert.ok(front && z >= front.z + 0.005 && z <= front.z + 0.08, `${where}: chest on the body (${front?.z} vs ${z})`);
251
+ assert.ok(x > 0 && yaw >= 0 && yaw <= 40, `${where}: on the wearer's left`);
252
+ const badge = BADGE_REACH * size;
253
+ assert.ok(badge > 0.13 && PIN_REACH > 0.07 && PIN_REACH < badge, `${where}: badge ${badge}, pin ${PIN_REACH}`);
254
+ for (let dy = -badge; dy <= badge + 1e-9; dy += badge / 4) {
255
+ for (let dx = -badge * 0.8; dx <= badge * 0.8 + 1e-9; dx += badge * 0.4) {
256
+ const under = hit(new THREE.Vector3(x + dx, y + dy, 3), new THREE.Vector3(0, 0, -1))?.z;
257
+ if (under !== undefined) {
258
+ assert.ok(under + dx * Math.tan((yaw * Math.PI) / 180) <= z + 1e-6, `${where}: the body stands through the badge at ${dx},${dy}`);
259
+ }
260
+ }
261
+ }
262
+ assert.ok(y + badge < face.min.y || x - badge > face.max.x, `${where}: the badge clears the face`);
263
+ assert.ok(y + badge < headBottom, `${where}: the badge clears the head`);
264
+ // Belt: round the outside of the body, 2 cm out.
265
+ const [wy, rx, rz] = fit.waist;
266
+ assert.ok(Math.abs(rx - fromSide(wy) - 0.02) < 0.012, `${where}: belt width ${rx} vs ${fromSide(wy)}`);
267
+ assert.ok(Math.abs(rz - fromFront(wy) - 0.02) < 0.012, `${where}: belt depth ${rz} vs ${fromFront(wy)}`);
268
+ assert.ok(wy + 0.03 < face.min.y, `${where}: the belt under the face`);
269
+ // Sash: tilted 36-45 degrees to the right shoulder (45 where a head
270
+ // stands over the body), outside the body at its middle, its line across
271
+ // the front clear under the face.
272
+ const [sy, a, sz, tilt] = fit.sash;
273
+ assert.ok(tilt >= 36 && tilt <= 45, `${where}: sash tilt ${tilt}`);
274
+ const t = (tilt * Math.PI) / 180;
275
+ assert.ok(Math.abs(a * Math.cos(t) - fromSide(sy) - 0.02) < 0.012, `${where}: sash reach ${a} vs ${fromSide(sy)}`);
276
+ assert.ok(sz >= fromFront(sy) + 0.015, `${where}: sash depth ${sz} vs ${fromFront(sy)}`);
277
+ assert.ok(sy - face.min.x * Math.tan(t) <= face.min.y + 0.01, `${where}: the sash passes under the face`);
278
+ // Square rings on the boxy bodies.
279
+ assert.equal(fit.square === true, index < 4 && (style === 'blocky' || (style === 'pixel' && index !== 0)), `${where}: square`);
280
+ // Held: at the right hand (the end of the arm where it has none).
281
+ const [hx, hy, hz] = fit.hand;
282
+ const centre = handBox.getCenter(new THREE.Vector3());
283
+ assert.ok(hx < 0 && Math.abs(hx - centre.x) < 0.06, `${where}: hand x ${hx} vs ${centre.x}`);
284
+ assert.ok(hy >= handBox.min.y - 0.01 && hy <= handBox.max.y, `${where}: hand y ${hy} in ${handBox.min.y}..${handBox.max.y}`);
285
+ // Every held thing, as big as it is drawn, stays off the face, and its
286
+ // foot no more than 4 cm into the ground.
287
+ for (const [shape, box] of Object.entries(heldBoxes)) {
288
+ const s = Earned.HELD_SCALE;
289
+ const x0 = hx + box.min.x * s;
290
+ const x1 = hx + box.max.x * s;
291
+ const y0 = hy + box.min.y * s;
292
+ const y1 = hy + box.max.y * s;
293
+ assert.ok(x1 < face.min.x || y1 < face.min.y || x0 > face.max.x || y0 > face.max.y, `${where}: ${shape} clears the face`);
294
+ assert.ok(y0 > -0.04, `${where}: ${shape} stands ${y0} m over the ground`);
295
+ }
296
+ // The description puts each where its fit says.
297
+ const look = Earned.earnedLook({ class: 'badge', shape: 'badge-star', color: '#ABCDEF' }, fit);
298
+ assert.deepEqual(look, {
299
+ shape: 'badge-star',
300
+ file: 'models/earned/badge-star.pxmodel',
301
+ color: '#abcdef',
302
+ position: [x, Math.round((MODEL_FEET_Y + y) * 1000) / 1000, z],
303
+ yaw,
304
+ tilt: 0,
305
+ scale: Array(3).fill(Math.round(Earned.BADGE_SCALE * size * 1000) / 1000),
306
+ glow: Math.round(Earned.BADGE_GLOW_R * size * 1000) / 1000,
307
+ });
308
+ const pin = Earned.earnedLook({ class: 'pin', shape: 'pin-round', color: '#abcdef' }, fit);
309
+ assert.deepEqual(pin.scale, Array(3).fill(Math.round(Earned.PIN_SCALE * size * 1000) / 1000));
310
+ assert.equal('glow' in pin, false, 'a pin has no glow');
311
+ const belt = Earned.earnedLook({ class: 'belt', shape: 'belt-plain', color: '#abcdef' }, fit);
312
+ assert.equal(belt.file, Earned.earnedFile('belt-plain', fit.square === true));
313
+ assert.ok(Math.abs(belt.scale[0] * 0.2 - rx) < 0.001 && Math.abs(belt.scale[2] * 0.2 - rz) < 0.001);
314
+ const sash = Earned.earnedLook({ class: 'sash', shape: 'sash-plain', color: '#abcdef' }, fit);
315
+ assert.equal(sash.file, Earned.earnedFile('sash-plain', fit.square === true));
316
+ assert.equal(sash.tilt, -tilt, 'rising to the right shoulder (-x)');
317
+ assert.ok(Math.abs(sash.scale[0] * 0.2 - a) < 0.001 && Math.abs(sash.scale[2] * 0.2 - sz) < 0.001);
318
+ const held = Earned.earnedLook({ class: 'held', shape: 'held-net', color: '#abcdef' }, fit);
319
+ assert.deepEqual(held.position, [hx, Math.round((MODEL_FEET_Y + hy) * 1000) / 1000, hz]);
320
+ assert.deepEqual(held.scale, [Earned.HELD_SCALE, Earned.HELD_SCALE, Earned.HELD_SCALE]);
321
+ }
322
+ }
323
+ assert.equal(Avatar.earnedFit(Avatar.AVATARS, 'toon'), null);
324
+ assert.equal(Avatar.earnedFit(9, 'blocky'), Avatar.earnedFit(9, 'toon'));
325
+ assert.equal(Avatar.earnedFit(0, 'nope'), Avatar.earnedFit(0, 'toon'));
326
+ });
327
+
328
+ test('an unknown shape, a shape of another class or a bad colour is kept and not drawn', () => {
329
+ const ok = { class: 'badge', shape: 'badge-round', color: '#3aa0d8' };
330
+ assert.ok(Earned.earnedLook(ok));
331
+ // Without a fit: a body about toon's.
332
+ assert.deepEqual(Earned.earnedLook(ok).position, [0.09, -0.1, 0.2]);
333
+ // A badge's shape may be pinned and a pin's worn as a badge.
334
+ assert.ok(Earned.earnedLook({ ...ok, class: 'pin' }));
335
+ assert.ok(Earned.earnedLook({ ...ok, shape: 'pin-round' }));
336
+ for (const bad of [
337
+ { ...ok, shape: 'badge-hexagon' },
338
+ { ...ok, shape: 'constructor' },
339
+ { ...ok, shape: undefined },
340
+ { ...ok, class: 'held' },
341
+ { ...ok, class: 'belt' },
342
+ { ...ok, class: 'hat' },
343
+ { ...ok, class: 'furniture', piece: 'planter' },
344
+ { ...ok, class: 'deed', piece: 'yard' },
345
+ { ...ok, class: 'pet', piece: 'pet-cat' },
346
+ { ...ok, shape: 'held-net' },
347
+ { ...ok, color: 'blue' },
348
+ { ...ok, color: undefined },
349
+ null,
350
+ undefined,
351
+ ]) {
352
+ assert.equal(Earned.earnedLook(bad), null, JSON.stringify(bad));
353
+ }
354
+ });
355
+
356
+ function fakeScene() {
357
+ const world = new THREE.Scene();
358
+ const nodes = new Map();
359
+ const files = {};
360
+ for (const shape of Earned.EARNED_SHAPES) {
361
+ files[`imports/castle.hub-game/${Earned.earnedFile(shape)}`] = read(shape);
362
+ }
363
+ const place = (actorId) => {
364
+ const node = new THREE.Group();
365
+ world.add(node);
366
+ nodes.set(actorId, { node });
367
+ return node;
368
+ };
369
+ return {
370
+ place,
371
+ files,
372
+ three: { nodes },
373
+ multiplayer: { net: { selfId: () => 'me' }, avatars: { actors: new Map([['p2', 'body-p2']]) } },
374
+ };
375
+ }
376
+
377
+ test("makeEarned draws under the avatar's own node, in the item's colour, and takes it down; nothing while nobody has one", () => {
378
+ const scene = fakeScene();
379
+ const mine = scene.place('me-body');
380
+ const theirs = scene.place('body-p2');
381
+ const local = { id: 'me-body' };
382
+ const earned = makeEarned();
383
+ const fit = Avatar.earnedFit(1, 'toon');
384
+ // Nobody shows one: nothing is looked at at all.
385
+ const untouchable = new Proxy({}, { get: () => { throw new Error('read'); } });
386
+ earned.frame(untouchable, local, new Map());
387
+ const shown = new Map([
388
+ ['me', { class: 'badge', shape: 'badge-round', color: '#c03050', name: 'Cove Ace' }],
389
+ ['p2', { class: 'held', shape: 'held-lantern', color: '#30c050', name: 'Night Lamp' }],
390
+ ['p3', { class: 'belt', shape: 'belt-plain', color: '#3050c0', name: 'No body yet' }],
391
+ ]);
392
+ earned.frame(scene, local, shown, () => fit);
393
+ assert.deepEqual(mine.children.map((c) => c.name), ['earned:badge-round']);
394
+ assert.deepEqual(theirs.children.map((c) => c.name), ['earned:held-lantern']);
395
+ const placed = mine.children[0].children[0];
396
+ assert.deepEqual(placed.position.toArray(), [fit.chest[0], MODEL_FEET_Y + fit.chest[1], fit.chest[2]].map((v) => Math.round(v * 1000) / 1000));
397
+ assert.ok(Math.abs(placed.rotation.y - (fit.chest[3] * Math.PI) / 180) < 1e-9 && placed.rotation.z === 0);
398
+ assert.deepEqual(placed.children[0].scale.toArray(), [Earned.BADGE_SCALE, Earned.BADGE_SCALE, Earned.BADGE_SCALE]);
399
+ // Its soft glow: a disc in its colour fading to nothing, behind nothing,
400
+ // never written to depth.
401
+ const glow = placed.children.find((c) => c.name === 'earned:glow');
402
+ assert.ok(glow && glow.material.transparent && !glow.material.depthWrite);
403
+ assert.equal(`#${glow.material.color.getHexString()}`, '#c03050');
404
+ assert.equal(glow.geometry.parameters.width, Earned.BADGE_GLOW_R * 2);
405
+ const alpha = glow.material.map.image.data;
406
+ const n = glow.material.map.image.width;
407
+ assert.equal(alpha[((n / 2) * n + n / 2) * 4 + 3] > 240, true, 'full in the middle');
408
+ assert.equal(alpha[((n / 2) * n + 0) * 4 + 3], 0, 'nothing at the edge');
409
+ // The held lantern has none.
410
+ assert.equal(theirs.children[0].children[0].children.some((c) => c.name === 'earned:glow'), false);
411
+ // Built from the model tinted to the item's colour (merged into vertex
412
+ // colours by the game build, so read from the text it was built from).
413
+ const key = mine.children[0].userData.hatKey;
414
+ assert.ok(key.startsWith('imports/castle.hub-game/models/earned/badge-round.pxmodel\n'));
415
+ assert.ok(key.includes('"#c03050"') && !key.includes(Earned.EARNED_MAIN));
416
+ assert.ok(theirs.children[0].userData.hatKey.includes('"#30c050"'));
417
+ // The same again builds nothing new.
418
+ earned.frame(scene, local, shown, () => fit);
419
+ assert.equal(mine.children[0].children[0], placed);
420
+ // An unknown shape is not drawn, and replaces what was.
421
+ shown.set('me', { class: 'badge', shape: 'badge-moon', color: '#c03050', name: 'x' });
422
+ earned.frame(scene, local, shown, () => fit);
423
+ assert.equal(mine.children.length, 0);
424
+ // Gone from the map: taken down, the build given back.
425
+ let freed = 0;
426
+ theirs.traverse((o) => o.geometry?.addEventListener('dispose', () => (freed += 1)));
427
+ shown.clear();
428
+ earned.frame(scene, local, shown, () => fit);
429
+ assert.equal(theirs.children.length, 0);
430
+ assert.ok(freed > 0);
431
+ assert.equal(earned.size, 0);
432
+ // A sash is scaled to the body, then tilted; a boxy body's is the square one.
433
+ scene.files['imports/castle.hub-game/models/earned/square/sash-plain.pxmodel'] = fs.readFileSync(new URL('../models/earned/square/sash-plain.pxmodel', import.meta.url), 'utf8');
434
+ const blocky = Avatar.earnedFit(1, 'blocky');
435
+ earned.frame(scene, local, new Map([['me', { class: 'sash', shape: 'sash-plain', color: '#111111' }]]), () => blocky);
436
+ assert.deepEqual(mine.children.map((c) => c.name), ['earned:sash-plain']);
437
+ const tilted = mine.children[0].children[0];
438
+ assert.ok(Math.abs(tilted.rotation.z + (blocky.sash[3] * Math.PI) / 180) < 1e-9);
439
+ assert.ok(Math.abs(tilted.children[0].scale.x * 0.2 - blocky.sash[1]) < 1e-6);
440
+ assert.ok(mine.children[0].userData.hatKey.startsWith('imports/castle.hub-game/models/earned/square/sash-plain.pxmodel\n'));
441
+ // Home items draw nothing, even if an invalid sender adds a wearable shape.
442
+ earned.frame(scene, local, new Map([
443
+ ['me', { class: 'furniture', piece: 'planter', shape: 'badge-round', color: '#111111' }],
444
+ ['p2', { class: 'deed', piece: 'yard', shape: 'held-lantern', color: '#111111' }],
445
+ ]), () => fit);
446
+ assert.equal(mine.children.length, 0);
447
+ assert.equal(theirs.children.length, 0);
448
+ earned.frame(scene, local, new Map([
449
+ ['me', { class: 'pet', piece: 'pet-cat', shape: 'badge-round', color: '#111111' }],
450
+ ['p2', { class: 'pet', piece: 'pet-cat', shape: 'held-lantern', color: '#111111' }],
451
+ ]), () => fit);
452
+ assert.equal(mine.children.length, 0);
453
+ assert.equal(theirs.children.length, 0);
454
+ // clear() takes everything down.
455
+ earned.clear();
456
+ assert.equal(mine.children.length, 0);
457
+ });
458
+
459
+ console.log(`test-earned-client: ${n} passed`);