castle-web-cli 0.4.232 → 0.4.234

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 (587) 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/api.d.ts +11 -0
  8. package/dist/api.js +43 -0
  9. package/dist/bundle.d.ts +64 -0
  10. package/dist/bundle.js +558 -2
  11. package/dist/castle-host/host.d.ts +18 -2
  12. package/dist/castle-host/host.js +844 -39
  13. package/dist/castleJson.d.ts +23 -2
  14. package/dist/castleJson.js +46 -2
  15. package/dist/check.d.ts +3 -1
  16. package/dist/check.js +20 -3
  17. package/dist/chunkLoader.d.ts +3 -0
  18. package/dist/chunkLoader.js +111 -0
  19. package/dist/devParty.d.ts +26 -0
  20. package/dist/devParty.js +231 -0
  21. package/dist/devSaveStorage.js +4 -0
  22. package/dist/devSessionStorage.js +50 -2
  23. package/dist/devSocial.d.ts +24 -0
  24. package/dist/devSocial.js +70 -0
  25. package/dist/ide.d.ts +2 -0
  26. package/dist/ide.js +119 -15
  27. package/dist/importPinMismatch.d.ts +22 -0
  28. package/dist/importPinMismatch.js +77 -0
  29. package/dist/importRegression.js +3 -15
  30. package/dist/imports.d.ts +10 -3
  31. package/dist/imports.js +88 -20
  32. package/dist/index.js +11 -4
  33. package/dist/init.js +1 -1
  34. package/dist/platformDoc.js +22 -0
  35. package/dist/routerFences.d.ts +5 -0
  36. package/dist/routerFences.js +12 -2
  37. package/dist/save-deck.d.ts +25 -1
  38. package/dist/save-deck.js +178 -9
  39. package/dist/serve.js +32 -11
  40. package/dist/shell/assets/{index-D2tWM896.js → index-DulbYIJm.js} +97 -97
  41. package/dist/shell/assets/index-MVLfNYd9.css +1 -0
  42. package/dist/shell/index.html +2 -2
  43. package/dist/taskSteer.d.ts +13 -0
  44. package/dist/taskSteer.js +22 -2
  45. package/dist/vitePlugins.d.ts +2 -1
  46. package/dist/vitePlugins.js +13 -0
  47. package/kits/base/castle.json +1 -1
  48. package/kits/base/package-lock.json +1 -1
  49. package/kits/base/sdk/README.md +339 -5
  50. package/kits/base/sdk/avatar.d.ts +6 -2
  51. package/kits/base/sdk/avatar.js +12 -4
  52. package/kits/base/sdk/castle.d.ts +7 -3
  53. package/kits/base/sdk/castle.js +2 -0
  54. package/kits/base/sdk/commands.d.ts +176 -1
  55. package/kits/base/sdk/commands.js +3 -0
  56. package/kits/base/sdk/display.d.ts +3 -0
  57. package/kits/base/sdk/display.js +9 -3
  58. package/kits/base/sdk/hub.d.ts +37 -6
  59. package/kits/base/sdk/hub.js +63 -4
  60. package/kits/base/sdk/multiplayer.d.ts +7 -1
  61. package/kits/base/sdk/multiplayer.js +148 -32
  62. package/kits/base/sdk/multiplayerProtocol.d.ts +2 -0
  63. package/kits/base/sdk/party.d.ts +23 -0
  64. package/kits/base/sdk/party.js +91 -0
  65. package/kits/base/sdk/reconnectBudget.d.ts +23 -0
  66. package/kits/base/sdk/reconnectBudget.js +96 -0
  67. package/kits/base/sdk/save.d.ts +38 -1
  68. package/kits/base/sdk/save.js +81 -7
  69. package/kits/base/sdk/server/hub.d.ts +117 -0
  70. package/kits/base/sdk/server/hub.js +119 -2
  71. package/kits/base/sdk/server/platformHandle.d.ts +43 -1
  72. package/kits/base/sdk/server/storage.d.ts +17 -0
  73. package/kits/base/sdk/server/storage.js +65 -3
  74. package/kits/base/sdk/server/wrapper.d.ts +43 -6
  75. package/kits/base/sdk/server/wrapper.js +93 -9
  76. package/kits/base/sdk/social.d.ts +9 -0
  77. package/kits/base/sdk/social.js +5 -0
  78. package/kits/hub-game/CLAUDE.md +451 -13
  79. package/kits/hub-game/README.md +63 -0
  80. package/kits/hub-game/blueprints/avatar-10.scene +28 -0
  81. package/kits/hub-game/blueprints/avatar-11.scene +28 -0
  82. package/kits/hub-game/blueprints/avatar-12.scene +28 -0
  83. package/kits/hub-game/blueprints/avatar-13.scene +28 -0
  84. package/kits/hub-game/blueprints/avatar-14.scene +28 -0
  85. package/kits/hub-game/blueprints/avatar-15.scene +28 -0
  86. package/kits/hub-game/blueprints/avatar-4.scene +28 -0
  87. package/kits/hub-game/blueprints/avatar-5.scene +28 -0
  88. package/kits/hub-game/blueprints/avatar-6.scene +28 -0
  89. package/kits/hub-game/blueprints/avatar-7.scene +28 -0
  90. package/kits/hub-game/blueprints/avatar-8.scene +28 -0
  91. package/kits/hub-game/blueprints/avatar-9.scene +28 -0
  92. package/kits/hub-game/castle.json +5 -5
  93. package/kits/hub-game/code/client/act.js +312 -0
  94. package/kits/hub-game/code/client/actionLayout.js +147 -0
  95. package/kits/hub-game/code/client/actionOverflow.js +556 -0
  96. package/kits/hub-game/code/client/actorBudget.js +47 -0
  97. package/kits/hub-game/code/client/arrivalCamera.js +50 -0
  98. package/kits/hub-game/code/client/askSlot.js +117 -0
  99. package/kits/hub-game/code/client/attention.js +11 -2
  100. package/kits/hub-game/code/client/avatar.js +311 -35
  101. package/kits/hub-game/code/client/avatarCap.js +228 -0
  102. package/kits/hub-game/code/client/avatarColors.js +70 -0
  103. package/kits/hub-game/code/client/avatarFaces.js +21 -0
  104. package/kits/hub-game/code/client/avatarShare.js +253 -0
  105. package/kits/hub-game/code/client/backVisibility.js +13 -0
  106. package/kits/hub-game/code/client/ballot.js +472 -0
  107. package/kits/hub-game/code/client/build.js +38 -0
  108. package/kits/hub-game/code/client/chat.js +41 -5
  109. package/kits/hub-game/code/client/chatModeration.js +5 -0
  110. package/kits/hub-game/code/client/chrome.js +2144 -160
  111. package/kits/hub-game/code/client/companion.js +716 -0
  112. package/kits/hub-game/code/client/companionDress.js +99 -0
  113. package/kits/hub-game/code/client/crowdNames.js +241 -0
  114. package/kits/hub-game/code/client/decor.js +515 -0
  115. package/kits/hub-game/code/client/defaultEnvironment.js +194 -0
  116. package/kits/hub-game/code/client/doorErrors.js +39 -0
  117. package/kits/hub-game/code/client/earned.js +131 -0
  118. package/kits/hub-game/code/client/emoteBubble.js +75 -0
  119. package/kits/hub-game/code/client/fall.js +18 -0
  120. package/kits/hub-game/code/client/farAvatars.js +233 -0
  121. package/kits/hub-game/code/client/firstJoin.js +9 -2
  122. package/kits/hub-game/code/client/fpsTelemetry.js +50 -0
  123. package/kits/hub-game/code/client/frameBatch.js +5 -0
  124. package/kits/hub-game/code/client/grab.js +368 -29
  125. package/kits/hub-game/code/client/hookLayer.js +385 -20
  126. package/kits/hub-game/code/client/hudCopy.js +51 -0
  127. package/kits/hub-game/code/client/hudRate.js +20 -0
  128. package/kits/hub-game/code/client/idle.js +177 -24
  129. package/kits/hub-game/code/client/interestCap.js +81 -0
  130. package/kits/hub-game/code/client/invites.js +231 -0
  131. package/kits/hub-game/code/client/joinError.js +9 -0
  132. package/kits/hub-game/code/client/keys.js +36 -0
  133. package/kits/hub-game/code/client/labelsNear.js +234 -0
  134. package/kits/hub-game/code/client/landscapeLayout.js +17 -0
  135. package/kits/hub-game/code/client/layoutCache.js +264 -0
  136. package/kits/hub-game/code/client/loadTelemetry.js +20 -0
  137. package/kits/hub-game/code/client/loadingCover.js +148 -0
  138. package/kits/hub-game/code/client/loadingEntry.js +8 -0
  139. package/kits/hub-game/code/client/menuIcons.js +34 -0
  140. package/kits/hub-game/code/client/menuRows.js +43 -0
  141. package/kits/hub-game/code/client/modelReady.js +7 -0
  142. package/kits/hub-game/code/client/pack.js +6 -2
  143. package/kits/hub-game/code/client/packFormat.js +3 -3
  144. package/kits/hub-game/code/client/padCueArrival.js +23 -0
  145. package/kits/hub-game/code/client/padCues.js +112 -0
  146. package/kits/hub-game/code/client/padOccupancy.js +88 -0
  147. package/kits/hub-game/code/client/padReadability.js +26 -0
  148. package/kits/hub-game/code/client/padRings.js +69 -0
  149. package/kits/hub-game/code/client/pushVisit.js +14 -0
  150. package/kits/hub-game/code/client/quality.js +205 -0
  151. package/kits/hub-game/code/client/qualityEntry.js +55 -0
  152. package/kits/hub-game/code/client/rehello.js +167 -0
  153. package/kits/hub-game/code/client/safeLayout.js +338 -0
  154. package/kits/hub-game/code/client/safeStyle.js +42 -0
  155. package/kits/hub-game/code/client/say.js +12 -3
  156. package/kits/hub-game/code/client/shot.js +146 -0
  157. package/kits/hub-game/code/client/shotFit.js +56 -0
  158. package/kits/hub-game/code/client/signIn.js +28 -0
  159. package/kits/hub-game/code/client/sound.js +63 -8
  160. package/kits/hub-game/code/client/soundscape.js +1151 -0
  161. package/kits/hub-game/code/client/soundscapeActions.js +99 -0
  162. package/kits/hub-game/code/client/soundscapeAmbience.js +453 -0
  163. package/kits/hub-game/code/client/soundscapeBaked.js +143 -0
  164. package/kits/hub-game/code/client/soundscapeBusker.js +217 -0
  165. package/kits/hub-game/code/client/soundscapeCourt.js +200 -0
  166. package/kits/hub-game/code/client/soundscapeCrowd.js +331 -0
  167. package/kits/hub-game/code/client/soundscapeCues.js +362 -0
  168. package/kits/hub-game/code/client/soundscapeMap.js +181 -0
  169. package/kits/hub-game/code/client/soundscapeMarket.js +176 -0
  170. package/kits/hub-game/code/client/soundscapeMusic.js +126 -0
  171. package/kits/hub-game/code/client/soundscapeMusicEngine.js +460 -0
  172. package/kits/hub-game/code/client/soundscapeSimlish.js +737 -0
  173. package/kits/hub-game/code/client/soundscapeSongs.js +127 -0
  174. package/kits/hub-game/code/client/soundscapeSongsRound3.js +63 -0
  175. package/kits/hub-game/code/client/soundscapeSynthesis.js +168 -0
  176. package/kits/hub-game/code/client/soundscapeUi.js +211 -0
  177. package/kits/hub-game/code/client/soundscapeVoice.js +1209 -0
  178. package/kits/hub-game/code/client/soundscapeWaves.js +206 -0
  179. package/kits/hub-game/code/client/spin.js +101 -0
  180. package/kits/hub-game/code/client/state.js +162 -1
  181. package/kits/hub-game/code/client/stuck.js +259 -0
  182. package/kits/hub-game/code/client/talk.js +714 -59
  183. package/kits/hub-game/code/client/tiers.js +543 -52
  184. package/kits/hub-game/code/client/toastBand.js +37 -0
  185. package/kits/hub-game/code/client/together.js +39 -2
  186. package/kits/hub-game/code/client/visibility.js +43 -0
  187. package/kits/hub-game/code/client/weakestLookBake.js +92 -0
  188. package/kits/hub-game/code/client/weakestTier.js +295 -0
  189. package/kits/hub-game/code/client/wear.js +461 -170
  190. package/kits/hub-game/code/client/worldLabels.js +241 -0
  191. package/kits/hub-game/code/client/yours.js +200 -0
  192. package/kits/hub-game/code/companionSpec.js +45 -0
  193. package/kits/hub-game/code/npcDisplayText.js +55 -0
  194. package/kits/hub-game/code/privateText.js +7 -0
  195. package/kits/hub-game/code/server/act.js +124 -0
  196. package/kits/hub-game/code/server/actions.js +138 -0
  197. package/kits/hub-game/code/server/actors.js +11 -2
  198. package/kits/hub-game/code/server/analytics.js +83 -0
  199. package/kits/hub-game/code/server/anonymousEntry.js +49 -0
  200. package/kits/hub-game/code/server/arrivalPose.js +36 -0
  201. package/kits/hub-game/code/server/ask.js +155 -0
  202. package/kits/hub-game/code/server/ballot.js +539 -0
  203. package/kits/hub-game/code/server/cells.js +100 -0
  204. package/kits/hub-game/code/server/companion.js +107 -0
  205. package/kits/hub-game/code/server/cues.js +70 -0
  206. package/kits/hub-game/code/server/decor.js +269 -0
  207. package/kits/hub-game/code/server/doorAnalytics.js +52 -0
  208. package/kits/hub-game/code/server/earned.js +478 -0
  209. package/kits/hub-game/code/server/frameBatch.js +183 -0
  210. package/kits/hub-game/code/server/friendBests.js +166 -0
  211. package/kits/hub-game/code/server/friendsAmong.js +272 -0
  212. package/kits/hub-game/code/server/history.js +7 -0
  213. package/kits/hub-game/code/server/hub.js +2510 -95
  214. package/kits/hub-game/code/server/idle.js +60 -12
  215. package/kits/hub-game/code/server/index.js +28 -6
  216. package/kits/hub-game/code/server/invites.js +19 -0
  217. package/kits/hub-game/code/server/labels.js +36 -2
  218. package/kits/hub-game/code/server/loadAbandon.js +106 -0
  219. package/kits/hub-game/code/server/manifest.js +586 -7
  220. package/kits/hub-game/code/server/menu.js +161 -0
  221. package/kits/hub-game/code/server/npcs.js +1025 -113
  222. package/kits/hub-game/code/server/observe.js +408 -0
  223. package/kits/hub-game/code/server/padOccupancy.js +85 -0
  224. package/kits/hub-game/code/server/party.js +2 -2
  225. package/kits/hub-game/code/server/players.js +30 -0
  226. package/kits/hub-game/code/server/resumePose.js +152 -0
  227. package/kits/hub-game/code/server/say.js +1 -1
  228. package/kits/hub-game/code/server/shot.js +110 -0
  229. package/kits/hub-game/code/server/standing.js +123 -0
  230. package/kits/hub-game/code/server/storageLimit.js +187 -0
  231. package/kits/hub-game/code/server/vis.js +175 -0
  232. package/kits/hub-game/code/server/wear.js +12 -0
  233. package/kits/hub-game/code/server/yours.js +59 -0
  234. package/kits/hub-game/code/shared/act.js +35 -0
  235. package/kits/hub-game/code/shared/cues.js +9 -0
  236. package/kits/hub-game/code/shared/danceIdle.js +28 -0
  237. package/kits/hub-game/code/shared/decor.js +41 -0
  238. package/kits/hub-game/code/shared/loadStages.js +12 -0
  239. package/kits/hub-game/code/shared/quality.js +74 -0
  240. package/kits/hub-game/code/shared/say.js +2 -0
  241. package/kits/hub-game/code/shared/shot.js +53 -0
  242. package/kits/hub-game/code/shared/spin.js +57 -0
  243. package/kits/hub-game/code/systems/hub.js +1753 -202
  244. package/kits/hub-game/docs/analytics.md +279 -0
  245. package/kits/hub-game/docs/content-pack.md +1 -1
  246. package/kits/hub-game/docs/contract.md +3475 -77
  247. package/kits/hub-game/docs/home-pieces.md +71 -0
  248. package/kits/hub-game/docs/observed-progress.md +252 -0
  249. package/kits/hub-game/main.jsx +2 -0
  250. package/kits/hub-game/models/avatar-10.pxmodel +28 -0
  251. package/kits/hub-game/models/avatar-11.pxmodel +28 -0
  252. package/kits/hub-game/models/avatar-12.pxmodel +27 -0
  253. package/kits/hub-game/models/avatar-13.pxmodel +24 -0
  254. package/kits/hub-game/models/avatar-14.pxmodel +29 -0
  255. package/kits/hub-game/models/avatar-15.pxmodel +24 -0
  256. package/kits/hub-game/models/avatar-4.pxmodel +29 -0
  257. package/kits/hub-game/models/avatar-5.pxmodel +27 -0
  258. package/kits/hub-game/models/avatar-6.pxmodel +26 -0
  259. package/kits/hub-game/models/avatar-7.pxmodel +25 -0
  260. package/kits/hub-game/models/avatar-8.pxmodel +24 -0
  261. package/kits/hub-game/models/avatar-9.pxmodel +30 -0
  262. package/kits/hub-game/models/earned/badge-round.pxmodel +100 -0
  263. package/kits/hub-game/models/earned/badge-shield.pxmodel +117 -0
  264. package/kits/hub-game/models/earned/badge-star.pxmodel +87 -0
  265. package/kits/hub-game/models/earned/belt-plain.pxmodel +72 -0
  266. package/kits/hub-game/models/earned/held-ball.pxmodel +43 -0
  267. package/kits/hub-game/models/earned/held-lantern.pxmodel +85 -0
  268. package/kits/hub-game/models/earned/held-net.pxmodel +57 -0
  269. package/kits/hub-game/models/earned/held-trophy.pxmodel +109 -0
  270. package/kits/hub-game/models/earned/pin-round.pxmodel +62 -0
  271. package/kits/hub-game/models/earned/sash-plain.pxmodel +66 -0
  272. package/kits/hub-game/models/earned/square/belt-plain.pxmodel +104 -0
  273. package/kits/hub-game/models/earned/square/sash-plain.pxmodel +98 -0
  274. package/kits/hub-game/models/hats/bat-clip.pxmodel +206 -0
  275. package/kits/hub-game/models/hats/beekeeper.pxmodel +149 -0
  276. package/kits/hub-game/models/hats/cap.pxmodel +162 -0
  277. package/kits/hub-game/models/hats/captain.pxmodel +178 -0
  278. package/kits/hub-game/models/hats/crooked-top.pxmodel +172 -0
  279. package/kits/hub-game/models/hats/flower-crown.pxmodel +451 -0
  280. package/kits/hub-game/models/hats/foam-crown.pxmodel +179 -0
  281. package/kits/hub-game/models/hats/lantern.pxmodel +230 -0
  282. package/kits/hub-game/models/hats/laurel.pxmodel +533 -0
  283. package/kits/hub-game/models/hats/lighthouse.pxmodel +96 -0
  284. package/kits/hub-game/models/hats/sailor.pxmodel +141 -0
  285. package/kits/hub-game/models/hats/souwester.pxmodel +131 -0
  286. package/kits/hub-game/models/hats/straw.pxmodel +139 -0
  287. package/kits/hub-game/models/hats/sunflower.pxmodel +406 -0
  288. package/kits/hub-game/models/hats/sweatband.pxmodel +112 -0
  289. package/kits/hub-game/models/hats/witch.pxmodel +147 -0
  290. package/kits/hub-game/package-lock.json +10 -1
  291. package/kits/hub-game/package.json +6 -2
  292. package/kits/hub-game/play/player.js +142 -0
  293. package/kits/hub-game/play/registry.js +47 -0
  294. package/kits/hub-game/play.jsx +37 -0
  295. package/kits/hub-game/scripts/check.mjs +117 -16
  296. package/kits/hub-game/scripts/companion-follower-wire.json +1 -0
  297. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +132 -0
  298. package/kits/hub-game/scripts/fixtures/decor-keyless.json +293 -0
  299. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +26 -0
  300. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +123 -0
  301. package/kits/hub-game/scripts/fixtures/interest-legacy.json +385 -0
  302. package/kits/hub-game/scripts/fixtures/npc-notes-v1.77.jsonl +4 -0
  303. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -0
  304. package/kits/hub-game/scripts/gen-avatars.mjs +933 -16
  305. package/kits/hub-game/scripts/gen-earned.mjs +285 -0
  306. package/kits/hub-game/scripts/gen-hats.mjs +827 -0
  307. package/kits/hub-game/scripts/grab.before-orbit.mjs +400 -0
  308. package/kits/hub-game/scripts/pose-storage-fixture.mjs +46 -0
  309. package/kits/hub-game/scripts/soundscape-wave-analysis.mjs +125 -0
  310. package/kits/hub-game/scripts/test-act-client.mjs +186 -0
  311. package/kits/hub-game/scripts/test-act.mjs +171 -0
  312. package/kits/hub-game/scripts/test-action-layout.mjs +80 -0
  313. package/kits/hub-game/scripts/test-action-observers.mjs +46 -0
  314. package/kits/hub-game/scripts/test-actions-client.mjs +853 -0
  315. package/kits/hub-game/scripts/test-actions.mjs +298 -0
  316. package/kits/hub-game/scripts/test-actor-budget.mjs +44 -0
  317. package/kits/hub-game/scripts/test-actors.mjs +38 -23
  318. package/kits/hub-game/scripts/test-analytics.mjs +76 -0
  319. package/kits/hub-game/scripts/test-anonymous-entry.mjs +28 -0
  320. package/kits/hub-game/scripts/test-arrival-pose-server.mjs +196 -0
  321. package/kits/hub-game/scripts/test-arrival-pose.mjs +24 -0
  322. package/kits/hub-game/scripts/test-ask-client.mjs +358 -0
  323. package/kits/hub-game/scripts/test-ask-slot.mjs +85 -0
  324. package/kits/hub-game/scripts/test-ask.mjs +269 -0
  325. package/kits/hub-game/scripts/test-attention.mjs +10 -1
  326. package/kits/hub-game/scripts/test-avatar-cap.mjs +379 -0
  327. package/kits/hub-game/scripts/test-avatar-colors.mjs +72 -0
  328. package/kits/hub-game/scripts/test-avatar-models.mjs +181 -0
  329. package/kits/hub-game/scripts/test-avatar-share.mjs +318 -0
  330. package/kits/hub-game/scripts/test-avatar-wire.mjs +792 -0
  331. package/kits/hub-game/scripts/test-avatar.mjs +584 -7
  332. package/kits/hub-game/scripts/test-back-visibility.mjs +82 -0
  333. package/kits/hub-game/scripts/test-ballot.mjs +1008 -0
  334. package/kits/hub-game/scripts/test-ban-join.mjs +121 -13
  335. package/kits/hub-game/scripts/test-build.mjs +49 -0
  336. package/kits/hub-game/scripts/test-cells.mjs +71 -0
  337. package/kits/hub-game/scripts/test-chat.mjs +863 -0
  338. package/kits/hub-game/scripts/test-classic.mjs +2 -0
  339. package/kits/hub-game/scripts/test-companion-chat.mjs +216 -0
  340. package/kits/hub-game/scripts/test-companion-client.mjs +1167 -0
  341. package/kits/hub-game/scripts/test-companion.mjs +259 -0
  342. package/kits/hub-game/scripts/test-control-layout-dom.mjs +120 -0
  343. package/kits/hub-game/scripts/test-crowd-names.mjs +205 -0
  344. package/kits/hub-game/scripts/test-decor-client.mjs +344 -0
  345. package/kits/hub-game/scripts/test-decor.mjs +464 -0
  346. package/kits/hub-game/scripts/test-default-environment-root.mjs +95 -0
  347. package/kits/hub-game/scripts/test-default-environment.mjs +267 -0
  348. package/kits/hub-game/scripts/test-door-analytics.mjs +58 -0
  349. package/kits/hub-game/scripts/test-door-jump.mjs +100 -0
  350. package/kits/hub-game/scripts/test-earned-client.mjs +459 -0
  351. package/kits/hub-game/scripts/test-earned.mjs +1224 -0
  352. package/kits/hub-game/scripts/test-emote-bubble.mjs +110 -0
  353. package/kits/hub-game/scripts/test-far-avatars.mjs +340 -0
  354. package/kits/hub-game/scripts/test-fps-telemetry.mjs +112 -0
  355. package/kits/hub-game/scripts/test-frame-batch.mjs +252 -0
  356. package/kits/hub-game/scripts/test-fresh-friends.mjs +118 -0
  357. package/kits/hub-game/scripts/test-friend-bests.mjs +435 -0
  358. package/kits/hub-game/scripts/test-grab-orbit.mjs +961 -0
  359. package/kits/hub-game/scripts/test-grab.mjs +7 -0
  360. package/kits/hub-game/scripts/test-hats.mjs +422 -168
  361. package/kits/hub-game/scripts/test-high-only.mjs +170 -0
  362. package/kits/hub-game/scripts/test-hub-leaving.mjs +203 -0
  363. package/kits/hub-game/scripts/test-hub-ops.mjs +758 -2
  364. package/kits/hub-game/scripts/test-hub-trip.mjs +1594 -12
  365. package/kits/hub-game/scripts/test-hud-clear.mjs +484 -57
  366. package/kits/hub-game/scripts/test-hud-defects-dom.mjs +100 -0
  367. package/kits/hub-game/scripts/test-hud-rate.mjs +224 -0
  368. package/kits/hub-game/scripts/test-hud-safe-visibility-dom.mjs +83 -0
  369. package/kits/hub-game/scripts/test-idle.mjs +427 -1
  370. package/kits/hub-game/scripts/test-interest-cap.mjs +36 -0
  371. package/kits/hub-game/scripts/test-interest-cells.mjs +513 -0
  372. package/kits/hub-game/scripts/test-interest-client.mjs +118 -0
  373. package/kits/hub-game/scripts/test-interest.mjs +15 -0
  374. package/kits/hub-game/scripts/test-invites-client.mjs +430 -0
  375. package/kits/hub-game/scripts/test-invites.mjs +109 -0
  376. package/kits/hub-game/scripts/test-keys.mjs +46 -1
  377. package/kits/hub-game/scripts/test-labels.mjs +664 -0
  378. package/kits/hub-game/scripts/test-landscape-layout.mjs +194 -0
  379. package/kits/hub-game/scripts/test-list-scroll-dom.mjs +49 -0
  380. package/kits/hub-game/scripts/test-load-abandon.mjs +246 -0
  381. package/kits/hub-game/scripts/test-loading-cover.mjs +162 -0
  382. package/kits/hub-game/scripts/test-manifest.mjs +472 -0
  383. package/kits/hub-game/scripts/test-menu-client.mjs +585 -0
  384. package/kits/hub-game/scripts/test-menu.mjs +319 -0
  385. package/kits/hub-game/scripts/test-npcs.mjs +2528 -13
  386. package/kits/hub-game/scripts/test-object-entry.mjs +76 -0
  387. package/kits/hub-game/scripts/test-observed.mjs +745 -0
  388. package/kits/hub-game/scripts/test-pack.mjs +7 -0
  389. package/kits/hub-game/scripts/test-pad-cues.mjs +304 -0
  390. package/kits/hub-game/scripts/test-pad-occupancy.mjs +177 -0
  391. package/kits/hub-game/scripts/test-picker.mjs +541 -0
  392. package/kits/hub-game/scripts/test-placement-cache.mjs +690 -0
  393. package/kits/hub-game/scripts/test-progress-reset.mjs +559 -0
  394. package/kits/hub-game/scripts/test-push-visit.mjs +26 -0
  395. package/kits/hub-game/scripts/test-quality.mjs +385 -0
  396. package/kits/hub-game/scripts/test-rehello.mjs +1733 -0
  397. package/kits/hub-game/scripts/test-relations-among.mjs +222 -0
  398. package/kits/hub-game/scripts/test-relations-refresh.mjs +188 -0
  399. package/kits/hub-game/scripts/test-resume-action-order.mjs +598 -0
  400. package/kits/hub-game/scripts/test-resume-held.mjs +239 -0
  401. package/kits/hub-game/scripts/test-resume-pose.mjs +142 -0
  402. package/kits/hub-game/scripts/test-safe-events-dom.mjs +116 -0
  403. package/kits/hub-game/scripts/test-safe-layout.mjs +330 -0
  404. package/kits/hub-game/scripts/test-say.mjs +1 -1
  405. package/kits/hub-game/scripts/test-shot.mjs +901 -0
  406. package/kits/hub-game/scripts/test-signin-client.mjs +45 -0
  407. package/kits/hub-game/scripts/test-soundscape.mjs +5437 -0
  408. package/kits/hub-game/scripts/test-spin.mjs +314 -0
  409. package/kits/hub-game/scripts/test-standing.mjs +449 -0
  410. package/kits/hub-game/scripts/test-storage-limit.mjs +333 -0
  411. package/kits/hub-game/scripts/test-stuck.mjs +1904 -0
  412. package/kits/hub-game/scripts/test-talk-overlay-dom.mjs +130 -0
  413. package/kits/hub-game/scripts/test-tier-cells.mjs +706 -0
  414. package/kits/hub-game/scripts/test-tiers-render.mjs +412 -0
  415. package/kits/hub-game/scripts/test-tiers.mjs +476 -2
  416. package/kits/hub-game/scripts/test-toast-band.mjs +61 -0
  417. package/kits/hub-game/scripts/test-try-on.mjs +22 -22
  418. package/kits/hub-game/scripts/test-vis.mjs +770 -0
  419. package/kits/hub-game/scripts/test-visibility.mjs +134 -0
  420. package/kits/hub-game/scripts/test-weakest-tier.mjs +924 -0
  421. package/kits/hub-game/scripts/test-world-labels.mjs +367 -0
  422. package/kits/hub-game/scripts/test-yours-chrome.mjs +210 -0
  423. package/kits/hub-game/scripts/test-yours.mjs +403 -0
  424. package/kits/multiplayer-3d/CLAUDE.md +50 -0
  425. package/kits/multiplayer-3d/castle.json +5 -5
  426. package/kits/multiplayer-3d/code/client/avatars.js +7 -0
  427. package/kits/multiplayer-3d/code/client/gait.js +65 -0
  428. package/kits/multiplayer-3d/code/client/joinFailure.js +27 -0
  429. package/kits/multiplayer-3d/code/client/nameTags.js +59 -4
  430. package/kits/multiplayer-3d/code/client/resumeGate.js +139 -0
  431. package/kits/multiplayer-3d/code/options.js +5 -0
  432. package/kits/multiplayer-3d/code/server/ownership.js +10 -2
  433. package/kits/multiplayer-3d/code/server/sceneBodies.js +12 -0
  434. package/kits/multiplayer-3d/code/server/world.js +7 -0
  435. package/kits/multiplayer-3d/code/systems/multiplayer.js +443 -34
  436. package/kits/multiplayer-3d/package-lock.json +8 -1
  437. package/kits/multiplayer-3d/package.json +3 -1
  438. package/kits/multiplayer-3d/scripts/fixtures/README.md +11 -0
  439. package/kits/multiplayer-3d/scripts/fixtures/ownership-legacy.json +2 -0
  440. package/kits/multiplayer-3d/scripts/ownership-harness.mjs +102 -0
  441. package/kits/multiplayer-3d/scripts/ownership-loader.mjs +46 -0
  442. package/kits/multiplayer-3d/scripts/ownership-worker.mjs +15 -0
  443. package/kits/multiplayer-3d/scripts/record-ownership-session.mjs +98 -0
  444. package/kits/multiplayer-3d/scripts/test-eligible-claims.mjs +167 -0
  445. package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +436 -0
  446. package/kits/multiplayer-3d/scripts/test-own-name-tag.mjs +247 -0
  447. package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +624 -0
  448. package/kits/physics-2d/CLAUDE.md +19 -1
  449. package/kits/physics-2d/castle.json +2 -2
  450. package/kits/physics-2d/engine/frozenActors.js +233 -0
  451. package/kits/physics-2d/engine/scene.js +337 -3
  452. package/kits/physics-2d/engine/skyKey.js +129 -0
  453. package/kits/physics-2d/engine/stillClock.js +106 -0
  454. package/kits/physics-2d/engine/updateBudget.js +21 -0
  455. package/kits/physics-2d/eslint.config.js +1 -1
  456. package/kits/physics-2d/play/behaviors/AnalogStick.js +198 -0
  457. package/kits/physics-2d/play/behaviors/Camera.js +40 -0
  458. package/kits/physics-2d/play/behaviors/Collider.js +122 -0
  459. package/kits/physics-2d/play/behaviors/Draggable.js +115 -0
  460. package/kits/physics-2d/play/behaviors/Goal.js +46 -0
  461. package/kits/physics-2d/play/behaviors/Joints.js +126 -0
  462. package/kits/physics-2d/play/behaviors/Layout.js +71 -0
  463. package/kits/physics-2d/play/behaviors/RigidBody.js +57 -0
  464. package/kits/physics-2d/play/behaviors/Slingshot.js +142 -0
  465. package/kits/physics-2d/play/behaviors/SoundPlayer.js +263 -0
  466. package/kits/physics-2d/play/behaviors/Sprite.js +406 -0
  467. package/kits/physics-2d/play/behaviors/Style.js +209 -0
  468. package/kits/physics-2d/play/behaviors/Text.js +85 -0
  469. package/kits/physics-2d/play/behaviors/Video.js +93 -0
  470. package/kits/physics-2d/scripts/test-skip-unchanged.mjs +326 -1
  471. package/kits/physics-3d/CLAUDE.md +42 -529
  472. package/kits/physics-3d/behaviors/Body.jsx +3 -0
  473. package/kits/physics-3d/behaviors/Model.jsx +3 -0
  474. package/kits/physics-3d/behaviors/Player.jsx +661 -87
  475. package/kits/physics-3d/behaviors/Shape.jsx +3 -0
  476. package/kits/physics-3d/behaviors/Solid.jsx +3 -0
  477. package/kits/physics-3d/behaviors/Transform.jsx +3 -0
  478. package/kits/physics-3d/castle.json +3 -3
  479. package/kits/physics-3d/docs/engine-camera.md +542 -0
  480. package/kits/physics-3d/docs/engine-frame-cap.md +136 -0
  481. package/kits/physics-3d/docs/engine-load.md +149 -0
  482. package/kits/physics-3d/docs/engine-look.md +114 -0
  483. package/kits/physics-3d/docs/engine-shadows.md +372 -0
  484. package/kits/physics-3d/docs/engine-skip-work.md +187 -0
  485. package/kits/physics-3d/docs/engine-sky.md +198 -0
  486. package/kits/physics-3d/docs/engine-static-actors.md +226 -0
  487. package/kits/physics-3d/docs/engine-view.md +37 -0
  488. package/kits/physics-3d/docs/pxmodel-format.md +9 -1
  489. package/kits/physics-3d/engine3d/PlayOnly3D.jsx +5 -1
  490. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +19 -277
  491. package/kits/physics-3d/engine3d/actornode.js +87 -0
  492. package/kits/physics-3d/engine3d/animationBudget.js +23 -0
  493. package/kits/physics-3d/engine3d/branches.js +3 -13
  494. package/kits/physics-3d/engine3d/cage.js +2 -7
  495. package/kits/physics-3d/engine3d/cageops.js +2 -17
  496. package/kits/physics-3d/engine3d/dataBehaviors.js +12 -0
  497. package/kits/physics-3d/engine3d/editorWorld.js +6 -0
  498. package/kits/physics-3d/engine3d/emptynodes.js +232 -0
  499. package/kits/physics-3d/engine3d/framecap.js +99 -0
  500. package/kits/physics-3d/engine3d/frozenphysics.js +140 -0
  501. package/kits/physics-3d/engine3d/frozenstatics.js +273 -0
  502. package/kits/physics-3d/engine3d/gait.js +126 -0
  503. package/kits/physics-3d/engine3d/initialModelFiles.js +18 -0
  504. package/kits/physics-3d/engine3d/kithooks.js +47 -0
  505. package/kits/physics-3d/engine3d/look.js +514 -48
  506. package/kits/physics-3d/engine3d/lookbake.js +208 -0
  507. package/kits/physics-3d/engine3d/materialpresets.js +2 -0
  508. package/kits/physics-3d/engine3d/modelFiles.js +3 -17
  509. package/kits/physics-3d/engine3d/modelMath.js +49 -0
  510. package/kits/physics-3d/engine3d/modelready.js +16 -0
  511. package/kits/physics-3d/engine3d/motion.js +39 -10
  512. package/kits/physics-3d/engine3d/nearshadows.js +106 -21
  513. package/kits/physics-3d/engine3d/optimize.js +9 -5
  514. package/kits/physics-3d/engine3d/orbitinput.js +522 -10
  515. package/kits/physics-3d/engine3d/orbitlens.js +48 -0
  516. package/kits/physics-3d/engine3d/ownmodel.js +213 -0
  517. package/kits/physics-3d/engine3d/partgeometry.js +1 -16
  518. package/kits/physics-3d/engine3d/paths.js +1 -9
  519. package/kits/physics-3d/engine3d/playTimings.js +50 -0
  520. package/kits/physics-3d/engine3d/playerRun.js +372 -0
  521. package/kits/physics-3d/engine3d/pxmodel.js +42 -11
  522. package/kits/physics-3d/engine3d/rapier.js +27 -0
  523. package/kits/physics-3d/engine3d/scatter.js +1 -11
  524. package/kits/physics-3d/engine3d/shadowfade.js +890 -0
  525. package/kits/physics-3d/engine3d/sky.js +547 -0
  526. package/kits/physics-3d/engine3d/skylife.js +306 -0
  527. package/kits/physics-3d/engine3d/squarefirst.js +177 -0
  528. package/kits/physics-3d/engine3d/stillshadows.js +399 -0
  529. package/kits/physics-3d/engine3d/sweep.js +1 -25
  530. package/kits/physics-3d/engine3d/unchanged.js +11 -0
  531. package/kits/physics-3d/engine3d/viewrange.js +52 -0
  532. package/kits/physics-3d/engine3d/world3d.js +1253 -76
  533. package/kits/physics-3d/eslint.config.js +2 -1
  534. package/kits/physics-3d/main.jsx +10 -2
  535. package/kits/physics-3d/package-lock.json +7 -0
  536. package/kits/physics-3d/package.json +5 -1
  537. package/kits/physics-3d/play/behaviors/Body.js +31 -0
  538. package/kits/physics-3d/play/behaviors/Door.js +37 -0
  539. package/kits/physics-3d/play/behaviors/Lookable.js +16 -0
  540. package/kits/physics-3d/play/behaviors/Model.js +23 -0
  541. package/kits/physics-3d/play/behaviors/Pickup.js +46 -0
  542. package/kits/physics-3d/play/behaviors/Player.js +1204 -0
  543. package/kits/physics-3d/play/behaviors/Shape.js +47 -0
  544. package/kits/physics-3d/play/behaviors/Solid.js +16 -0
  545. package/kits/physics-3d/play/behaviors/Transform.js +29 -0
  546. package/kits/physics-3d/pnpm-lock.yaml +8 -0
  547. package/kits/physics-3d/scripts/bench-shadow-fade.mjs +37 -0
  548. package/kits/physics-3d/scripts/build-rapier-gz.mjs +56 -0
  549. package/kits/physics-3d/scripts/frozen-statics-fixture.mjs +141 -0
  550. package/kits/physics-3d/scripts/look-baseline.mjs +155 -0
  551. package/kits/physics-3d/scripts/test-camera-follow.mjs +5 -1
  552. package/kits/physics-3d/scripts/test-camera-orbit.mjs +2613 -82
  553. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +2 -2
  554. package/kits/physics-3d/scripts/test-empty-gait-hints.mjs +89 -0
  555. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +438 -0
  556. package/kits/physics-3d/scripts/test-frame-cap.mjs +452 -0
  557. package/kits/physics-3d/scripts/test-frozen-nested.mjs +49 -0
  558. package/kits/physics-3d/scripts/test-frozen-statics-legacy-physics2d.mjs +123 -0
  559. package/kits/physics-3d/scripts/test-frozen-statics.mjs +434 -0
  560. package/kits/physics-3d/scripts/test-gait.mjs +387 -0
  561. package/kits/physics-3d/scripts/test-look-bake.mjs +1056 -0
  562. package/kits/physics-3d/scripts/test-model-parse-cache.mjs +92 -0
  563. package/kits/physics-3d/scripts/test-near-shadows.mjs +5 -2
  564. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +2001 -0
  565. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +582 -0
  566. package/kits/physics-3d/scripts/test-orbit-shot.mjs +657 -0
  567. package/kits/physics-3d/scripts/test-orbit-view.mjs +230 -0
  568. package/kits/physics-3d/scripts/test-rapier-gz.mjs +106 -0
  569. package/kits/physics-3d/scripts/test-skip-empty-nodes.mjs +845 -0
  570. package/kits/physics-3d/scripts/test-sky.mjs +2470 -0
  571. package/kits/physics-3d/scripts/test-square-first.mjs +921 -0
  572. package/kits/physics-3d/scripts/test-static-actors.mjs +10 -1
  573. package/kits/physics-3d/scripts/test-static-physics.mjs +4 -1
  574. package/kits/physics-3d/scripts/test-static-scenery.mjs +2174 -0
  575. package/kits/physics-3d/scripts/test-steady-hover.mjs +7 -2
  576. package/kits/physics-3d/scripts/test-still-shadows.mjs +477 -0
  577. package/kits/physics-3d/scripts/test-view-range.mjs +260 -0
  578. package/kits/physics-3d/systems/physics3d.js +419 -9
  579. package/kits/real-time/castle.json +2 -2
  580. package/kits/real-time/code/client/connection.js +33 -10
  581. package/kits/real-time/code/client/gameHooks.js +2 -0
  582. package/kits/real-time/code/client/joinOverlay.js +9 -4
  583. package/kits/real-time/code/server/gameHooks.js +7 -0
  584. package/kits/real-time/code/server/session.js +102 -22
  585. package/kits/real-time/package-lock.json +1 -1
  586. package/package.json +2 -2
  587. package/dist/shell/assets/index-Cf61cNfT.css +0 -1
@@ -1,27 +1,49 @@
1
- // Hats (contract §11): a wearable kind `hat-<id>` is drawn as a few matte
2
- // Shapes on the avatar's head (code/client/wear.js, hats.js, avatar.js
3
- // `hatFit`), and every other wearable is drawn exactly as it was before hats.
4
- // castle-web-sdk is stubbed (scripts/fixtures/sdk-stub.mjs). `npm run check`
5
- // runs this.
1
+ // What players wear (contract §11, drawn this way since v1.41): a wearable is
2
+ // drawn under its avatar's own node (code/client/wear.js), so it moves, turns
3
+ // and is hidden with the avatar. A hat `hat-<id>` is the kit's model of it
4
+ // (models/hats/<id>.pxmodel, scripts/gen-hats.mjs) fitted to each avatar's head
5
+ // (avatar.js `hatFit`); a halo, aura and orbit glow in the wearable's colour.
6
+ // The models are built here by physics-3d's own builder. castle-web-sdk is
7
+ // stubbed (scripts/fixtures/sdk-stub.mjs). `npm run check` runs this.
6
8
 
7
9
  import assert from 'node:assert/strict';
10
+ import fs from 'node:fs';
8
11
  import { register } from 'node:module';
9
12
 
10
- register(
11
- 'data:text/javascript,' +
12
- encodeURIComponent(`
13
- export async function resolve(specifier, context, next) {
14
- if (specifier === 'castle-web-sdk') {
15
- return { url: ${JSON.stringify(new URL('./fixtures/sdk-stub.mjs', import.meta.url).href)}, shortCircuit: true };
16
- }
17
- return next(specifier, context);
18
- }`),
19
- );
13
+ // The engine's modules are written for the bundler: imports without
14
+ // extensions, and the other kits by their aliases.
15
+ const hooks = `
16
+ import { existsSync } from 'node:fs';
17
+ import { fileURLToPath } from 'node:url';
18
+ const SDK = ${JSON.stringify(new URL('./fixtures/sdk-stub.mjs', import.meta.url).href)};
19
+ const KITS = ${JSON.stringify(new URL('../../', import.meta.url).href)};
20
+ export async function resolve(specifier, context, next) {
21
+ if (specifier === 'castle-web-sdk') {
22
+ return { url: SDK, shortCircuit: true };
23
+ }
24
+ for (const kit of ['physics-2d', 'physics-3d']) {
25
+ if (specifier.startsWith('@imports/castle.' + kit + '/')) {
26
+ specifier = KITS + kit + '/' + specifier.slice(('@imports/castle.' + kit + '/').length);
27
+ }
28
+ }
29
+ const parent = context.parentURL ?? '';
30
+ if ((specifier.startsWith('.') || specifier.startsWith('file:')) && parent.includes('/kits/') && !/\\.(m?js|jsx|json)$/.test(specifier)) {
31
+ const base = new URL(specifier, parent).href;
32
+ for (const ext of ['.js', '.jsx']) if (existsSync(fileURLToPath(base + ext))) return next(base + ext, context);
33
+ }
34
+ return next(specifier, context);
35
+ }`;
36
+ register(`data:text/javascript,${encodeURIComponent(hooks)}`);
20
37
 
38
+ const THREE = await import('three');
21
39
  const Avatar = await import('../code/client/avatar.js');
22
40
  const { HATS, HAT_SETS, hatId, hatKind } = await import('../code/client/hats.js');
23
- const { HAT_IDS, makeWear, pieces } = await import('../code/client/wear.js');
41
+ const { DEFAULT_TOP, hatFile, look, makeWear } = await import('../code/client/wear.js');
24
42
  const Wear = await import('../code/server/wear.js');
43
+ const Gen = await import('./gen-hats.mjs');
44
+ const { buildModelNode, parseModel, visibleBounds } =
45
+ await import('../../physics-3d/engine3d/pxmodel.js');
46
+ const { makeLookBake } = await import('../../physics-3d/engine3d/lookbake.js');
25
47
 
26
48
  let n = 0;
27
49
  function test(name, fn) {
@@ -29,72 +51,81 @@ function test(name, fn) {
29
51
  n += 1;
30
52
  }
31
53
 
32
- const round = (p) => Object.fromEntries(Object.entries(p).map(([k, v]) => [k, Math.round(v * 1e6) / 1e6]));
33
- const seen = (parts) => parts && parts.map((piece) => ({ keys: Object.keys(piece), shape: piece.shape, at0: round(piece.at(0)), at1: round(piece.at(1.3)) }));
34
-
35
- test('every wearable from before hats is drawn exactly as it was', () => {
36
- // Captured by running `pieces` as it was before hats: the Shape of each
37
- // piece, field for field, and where it is at t = 0 and t = 1.3.
38
- const glow = (kind, size, color, emissiveIntensity) => ({ kind, ...size, color, emissive: color, emissiveIntensity, roughness: 0.4, metalness: 0.1, solid: false });
39
- const piece = (shape, at0, at1) => ({ keys: ['shape', 'at'], shape, at0, at1 });
40
- const orb = glow('sphere', { radius: 0.09450000000000001 }, '#00ff88', 1.65);
41
- const before = [
42
- [[null], null],
43
- [[undefined], null],
44
- [[{ kind: 'halo', color: '#FFD700', rarity: 0 }], [piece(glow('cylinder', { radius: 0.35, height: 0.04 }, '#ffd700', 0.6), { x: 0, y: 1.1, z: 0 }, { x: 0, y: 1.115465, z: 0 })]],
45
- [[{ kind: 'halo', color: '#ffd700', rarity: 4 }, 1.38], [piece(glow('cylinder', { radius: 0.42, height: 0.04 }, '#ffd700', 1.2), { x: 0, y: 0.83, z: 0 }, { x: 0, y: 0.845465, z: 0 })]],
46
- [[{ kind: 'aura', color: '#9b5cff', rarity: 6 }, 1.5], [piece(glow('cylinder', { radius: 0.78, height: 0.02 }, '#9b5cff', 1.5), { x: 0, y: -0.83, z: 0 }, { x: 0, y: -0.83, z: 0 })]],
47
- [[{ kind: 'orbit', color: '#00ff88', rarity: 0 }], [piece(glow('sphere', { radius: 0.07 }, '#00ff88', 0.6), { x: 0.5, y: 0.95, z: 0 }, { x: -0.243741, y: 0.907436, z: 0.436566 })]],
48
- [
49
- [{ kind: 'orbit', color: '#00ff88', rarity: 7 }, 1.7],
50
- [
51
- piece(orb, { x: 0.5, y: 1, z: 0 }, { x: -0.494266, y: 0.985072, z: 0.075506 }),
52
- piece(orb, { x: -0.25, y: 0.956699, z: 0.433013 }, { x: 0.181743, y: 0.966138, z: -0.4658 }),
53
- piece(orb, { x: -0.25, y: 1.043301, z: -0.433013 }, { x: 0.312523, y: 1.04879, z: 0.390294 }),
54
- ],
55
- ],
56
- [[{ kind: 'crown', color: '#ffd700', rarity: 1 }], null],
57
- [[{ kind: 'halo', color: 'red', rarity: 1 }], null],
58
- [[{ kind: 'halo', color: '#ffd700' }, 1.31], [piece(glow('cylinder', { radius: 0.35, height: 0.04 }, '#ffd700', 0.6), { x: 0, y: 0.76, z: 0 }, { x: 0, y: 0.775465, z: 0 })]],
59
- [[{ kind: 'aura', color: '#123456', rarity: 99 }], [piece(glow('cylinder', { radius: 0.87, height: 0.02 }, '#123456', 1.9499999999999997), { x: 0, y: -0.83, z: 0 }, { x: 0, y: -0.83, z: 0 })]],
60
- ];
61
- for (const [args, expected] of before) {
62
- assert.deepStrictEqual(seen(pieces(...args)), expected, JSON.stringify(args));
63
- // A hat's fit changes nothing for a wearable that is not a hat.
64
- assert.deepStrictEqual(seen(pieces(args[0], args[1], [1.2, 0.5, 0.1])), expected, JSON.stringify(args));
65
- }
66
- });
54
+ const MODEL_FEET_Y = -0.7;
55
+ // The name tag is 1.25 m over the avatar's origin (multiplayer-3d `nameTags.js`).
56
+ const NAME_TAG_Y = 1.25;
57
+ const read = (id) => fs.readFileSync(new URL(`../${hatFile(id)}`, import.meta.url), 'utf8');
67
58
 
68
- test('the list a server reads is the catalogue the client draws', () => {
69
- assert.deepEqual(HATS, HAT_IDS);
59
+ test('the list a server reads is the hats the kit has models of', () => {
70
60
  assert.equal(HATS.length, 16);
71
61
  assert.equal(new Set(HATS).size, 16);
72
62
  assert.deepEqual(Object.keys(HAT_SETS), ['stadium', 'hollow', 'sunny', 'harbour']);
63
+ assert.deepEqual([...Gen.HAT_IDS].sort(), [...HATS].sort());
73
64
  for (const id of HATS) {
74
65
  const kind = hatKind(id);
75
- assert.equal(kind, `hat-${id}`);
76
66
  assert.equal(hatId(kind), id);
77
67
  // The kit's server and ghost take the kind as they take any other.
78
68
  assert.ok(Wear.KIND.test(kind), kind);
79
- assert.deepEqual(Wear.cleanWearable({ kind, color: '#AA3322', rarity: 3 }), { kind, color: '#aa3322', rarity: 3 });
69
+ assert.deepEqual(Wear.cleanWearable({ kind, color: '#AA3322', rarity: 3 }), {
70
+ kind,
71
+ color: '#aa3322',
72
+ rarity: 3,
73
+ });
80
74
  }
81
75
  });
82
76
 
83
- test('a kind that is not one of the hats is not drawn', () => {
84
- for (const kind of ['hat-nope', 'hat-', 'hat', 'hat-constructor', 'hat-toString', 'hat-cap-2', 'cap', 'Hat-cap', 7, null, undefined]) {
85
- assert.equal(pieces({ kind, color: '#ffd700', rarity: 1 }), null, String(kind));
86
- assert.equal(hatId(kind), null, String(kind));
77
+ test("every hat model is the generator's, small, and fits on a head under its name tag", () => {
78
+ let bytes = 0;
79
+ const sizes = [];
80
+ for (const id of HATS) {
81
+ const text = read(id);
82
+ bytes += text.length;
83
+ // The files are what scripts/gen-hats.mjs writes now.
84
+ assert.equal(
85
+ text,
86
+ `${JSON.stringify(Gen.hatModel(id), null, 1)}\n`,
87
+ `${id}: run node scripts/gen-hats.mjs`,
88
+ );
89
+ const model = parseModel(text);
90
+ assert.ok(model, id);
91
+ assert.ok(
92
+ model.parts.length >= 2 && model.parts.length <= 30,
93
+ `${id}: ${model.parts.length} parts`,
94
+ );
95
+ assert.ok(text.length <= 6000, `${id}: ${text.length} bytes`);
96
+ // Its main colour is a part's colour: the colour a place sends is the hat's.
97
+ assert.ok(
98
+ model.parts.some((part) => part.color === Gen.MAIN[id]),
99
+ id,
100
+ );
101
+ // Built as a game builds it, it stays within a head's reach of its seat
102
+ // (and, shown 1.5 times its size on a shop's post 1.1 m behind the mat,
103
+ // off the 0.5 m a player stands on: town_hats.py),
104
+ // and within its triangle budget.
105
+ const root = buildModelNode(model, null, { [hatFile(id)]: text }, hatFile(id), [hatFile(id)], {
106
+ optimize: true,
107
+ });
108
+ const box = visibleBounds(root);
109
+ assert.ok(box.max.y <= 0.45 && box.min.y >= -0.17, `${id}: ${box.min.y}..${box.max.y} high`);
110
+ assert.ok(
111
+ Math.max(-box.min.x, box.max.x, -box.min.z, box.max.z) <= 0.39,
112
+ `${id}: ${JSON.stringify(box)} wide`,
113
+ );
114
+ let triangles = 0;
115
+ root.traverse((object) => {
116
+ if (object.isMesh && !object.userData.lookOutline) {
117
+ const g = object.geometry;
118
+ triangles += (g.index ? g.index.count : g.attributes.position.count) / 3;
119
+ }
120
+ });
121
+ assert.ok(process.env.HAT_SIZES || triangles <= 1000, `${id}: ${triangles} triangles`);
122
+ sizes.push(`${id} ${text.length} B, ${model.parts.length} parts, ${triangles} tris`);
87
123
  }
88
- assert.equal(pieces({ kind: 'hat-cap', color: 'javascript:', rarity: 1 }), null);
124
+ assert.ok(bytes <= 48000, `all hats ${bytes} bytes`);
125
+ if (process.env.HAT_SIZES) console.log(`${sizes.join('\n')}\nall ${bytes} B`);
89
126
  });
90
127
 
91
- const COLOR = /^#[0-9a-f]{6}$/;
92
- // The avatar's origin is 0.7 m over its model's feet, and its name tag 1.25 m
93
- // over the origin (multiplayer-3d `nameTags.js`).
94
- const MODEL_FEET_Y = -0.7;
95
- const NAME_TAG_Y = 1.25;
96
-
97
- test('every hat is one to three matte Shapes on the head of every avatar in every set', () => {
128
+ test('a hat sits on the head of every avatar in every set, under its name tag', () => {
98
129
  for (const id of HATS) {
99
130
  for (const style of Avatar.STYLES) {
100
131
  for (let index = 0; index < Avatar.AVATARS; index += 1) {
@@ -102,128 +133,351 @@ test('every hat is one to three matte Shapes on the head of every avatar in ever
102
133
  const fit = Avatar.hatFit(index, style);
103
134
  const top = Avatar.top(index, style);
104
135
  const [seat, scale, rise] = fit;
105
- // The seat is on the model, never over its top.
106
- assert.ok(seat > 1 && seat <= top && scale >= 0.5 && scale <= 1.3 && rise >= 0 && rise <= 0.12, where);
107
- const parts = pieces({ kind: `hat-${id}`, color: '#3AA0FF', rarity: 0 }, top, fit);
108
- assert.ok(Array.isArray(parts) && parts.length >= 1 && parts.length <= 3, where);
109
- let main = 0;
110
- for (const part of parts) {
111
- const s = part.shape;
112
- assert.deepEqual(Object.keys(part), ['shape', 'at', 'turns', 'tilt'], where);
113
- assert.ok(s.kind === 'cylinder' || s.kind === 'box', where);
114
- const sizes = s.kind === 'cylinder' ? [s.radius, s.height] : [s.width, s.height, s.depth];
115
- assert.deepEqual(Object.keys(s).sort(), [...(s.kind === 'cylinder' ? ['radius', 'height'] : ['width', 'height', 'depth']), 'kind', 'color', 'roughness', 'metalness', 'solid'].sort(), where);
116
- assert.ok(sizes.every((v) => Number.isFinite(v) && v > 0 && v <= 0.8), where);
117
- assert.ok(COLOR.test(s.color), where);
118
- // Matte: no glow, and never solid.
119
- assert.equal('emissive' in s || 'emissiveIntensity' in s, false, where);
120
- assert.equal(s.solid, false, where);
121
- assert.equal(part.turns, true, where);
122
- assert.ok(Number.isFinite(part.tilt) && Math.abs(part.tilt) <= 20, where);
123
- main += s.color === '#3aa0ff' ? 1 : 0;
124
- // It stays where it is put (nothing bobs), within reach of the head,
125
- // on it rather than in it, and under the name tag.
126
- const at = part.at(0);
127
- assert.deepEqual(part.at(7.5), at, where);
128
- assert.ok(Math.hypot(at.x, at.z) <= 0.3 * scale, where);
129
- const reach = (s.kind === 'cylinder' ? s.radius : Math.hypot(s.width, s.depth) / 2) * Math.sin((Math.abs(part.tilt) * Math.PI) / 180);
130
- const low = at.y - s.height / 2 - reach;
131
- const high = at.y + s.height / 2 + reach;
132
- assert.ok(low >= MODEL_FEET_Y + seat - 0.06 * scale, `${where}: sinks`);
133
- assert.ok(high <= MODEL_FEET_Y + seat + 0.36 * scale + rise + 1e-9, `${where}: too tall`);
134
- assert.ok(high < NAME_TAG_Y - 0.08, `${where}: reaches the name tag`);
135
- }
136
- // The wearable's colour is the hat's main colour.
137
- assert.ok(main >= 1, where);
138
- // The lowest piece rests at the seat: the hat does not float.
139
- const floor = Math.min(...parts.map((part) => part.at(0).y - part.shape.height / 2));
140
- assert.ok(floor <= MODEL_FEET_Y + seat + rise + 0.05 * scale, `${where}: floats`);
136
+ assert.ok(
137
+ seat > 1 && seat <= top && scale >= 0.8 && scale <= 1.3 && rise >= 0 && rise <= 0.2,
138
+ where,
139
+ );
140
+ const spec = look({ kind: `hat-${id}`, color: '#3AA0FF', rarity: 0 }, top, fit);
141
+ assert.deepEqual(Object.keys(spec), ['kind', 'id', 'y', 'scale'], where);
142
+ assert.equal(spec.kind, 'hat');
143
+ assert.equal(spec.scale, scale);
144
+ const perched = Gen.PERCHED.includes(id);
145
+ assert.ok(Math.abs(spec.y - (MODEL_FEET_Y + seat + (perched ? rise : 0))) < 1e-9, where);
146
+ // The tallest hat (0.45 m at most) reaches at most the name tag's
147
+ // lower edge, which is drawn over it.
148
+ assert.ok(spec.y + 0.45 * scale < NAME_TAG_Y + 0.05, `${where}: reaches the name tag`);
141
149
  }
142
150
  }
143
151
  }
152
+ // Rarity changes nothing; an avatar this kit has no fit for wears it just under its top.
153
+ const plain = look({ kind: 'hat-straw', color: '#e8c96a', rarity: 0 }, 1.38, [1.31, 1, 0.05]);
154
+ assert.deepEqual(
155
+ look({ kind: 'hat-straw', color: '#e8c96a', rarity: 9 }, 1.38, [1.31, 1, 0.05]),
156
+ plain,
157
+ );
158
+ assert.equal(Avatar.hatFit(Avatar.AVATARS, 'toon'), null);
159
+ assert.equal(Avatar.hatFit(99, 'toon'), null);
160
+ // A set draws 4-15 as toon's models (v1.51): the hat fits as it does on toon.
161
+ for (const style of ['blocky', 'bean', 'pixel']) {
162
+ for (let index = 4; index < Avatar.AVATARS; index += 1) {
163
+ assert.equal(Avatar.hatFit(index, style), Avatar.hatFit(index, 'toon'), `${style} ${index}`);
164
+ assert.equal(Avatar.top(index, style), Avatar.top(index, 'toon'), `${style} ${index}`);
165
+ }
166
+ }
167
+ assert.deepEqual(look({ kind: 'hat-straw', color: '#e8c96a', rarity: 0 }), {
168
+ kind: 'hat',
169
+ id: 'straw',
170
+ y: MODEL_FEET_Y + DEFAULT_TOP - 0.1,
171
+ scale: 1,
172
+ });
173
+ // Star wears a full-size hat over its top point now, not a small one on it.
174
+ assert.deepEqual(Avatar.hatFit(3, 'toon'), [1.38, 1, 0.14]);
144
175
  });
145
176
 
146
- test('rarity and an unknown avatar change nothing a hat needs', () => {
147
- const plain = seen(pieces({ kind: 'hat-straw', color: '#e8c96a', rarity: 0 }, 1.38, [1.31, 1, 0.05]));
148
- assert.deepEqual(seen(pieces({ kind: 'hat-straw', color: '#e8c96a', rarity: 9 }, 1.38, [1.31, 1, 0.05])), plain);
149
- // An avatar this kit has no fit for wears it just under its top.
150
- assert.equal(Avatar.hatFit(9, 'toon'), null);
151
- assert.equal(Avatar.hatFit(0, 'nope'), Avatar.hatFit(0, 'toon'));
152
- const unknown = pieces({ kind: 'hat-straw', color: '#e8c96a', rarity: 0 });
153
- assert.equal(unknown.length, 2);
154
- assert.ok(unknown.every((part) => part.at(0).y > 0.8 && part.at(0).y < 1.1));
155
- // The toon Star wears a smaller one.
156
- const star = pieces({ kind: 'hat-straw', color: '#e8c96a', rarity: 0 }, 1.56, Avatar.hatFit(3, 'toon'));
157
- assert.ok(star[0].shape.radius < plain[0].shape.radius);
177
+ test('a halo is a ring with an open middle over the head, as wide as the head; an aura a ring at the feet', () => {
178
+ const fit = Avatar.hatFit(0, 'toon');
179
+ const halo = look({ kind: 'halo', color: '#F08A3C', rarity: 2 }, 1.38, fit);
180
+ assert.equal(halo.kind, 'halo');
181
+ assert.equal(halo.color, '#f08a3c');
182
+ // Open: the tube is a small part of the ring.
183
+ assert.ok(halo.tube * 4 < halo.radius);
184
+ // Over the head, not on it, and as wide as the head it is over.
185
+ assert.ok(halo.y > MODEL_FEET_Y + 1.38 + 0.05);
186
+ assert.ok(halo.radius > 0.2 * fit[1] && halo.radius < 0.2 * fit[1] * 1.6);
187
+ // A smaller head wears a smaller one; rarity grows it and its glow a little.
188
+ const small = look({ kind: 'halo', color: '#f08a3c', rarity: 2 }, 1.38, [1.3, 0.8, 0]);
189
+ assert.ok(small.radius < halo.radius);
190
+ const rare = look({ kind: 'halo', color: '#f08a3c', rarity: 9 }, 1.38, fit);
191
+ assert.ok(rare.radius > halo.radius && rare.glow > halo.glow);
192
+ const aura = look({ kind: 'aura', color: '#9b5cff', rarity: 0 });
193
+ // On the ground the feet stand on, not under it.
194
+ assert.ok(aura.y > MODEL_FEET_Y && aura.y < MODEL_FEET_Y + 0.08 && aura.tube * 4 < aura.radius);
195
+ const orbit = look({ kind: 'orbit', color: '#00ff88', rarity: 6 });
196
+ assert.equal(orbit.n, 3);
197
+ // Kinds and colours this kit does not draw are not drawn.
198
+ for (const kind of [
199
+ 'hat-nope',
200
+ 'hat-',
201
+ 'hat',
202
+ 'hat-constructor',
203
+ 'hat-toString',
204
+ 'cap',
205
+ 'Hat-cap',
206
+ 'sparkle',
207
+ 7,
208
+ null,
209
+ undefined,
210
+ ]) {
211
+ assert.equal(look({ kind, color: '#ffd700', rarity: 1 }), null, String(kind));
212
+ }
213
+ assert.equal(look({ kind: 'halo', color: 'javascript:', rarity: 1 }), null);
158
214
  });
159
215
 
160
- // A scene that keeps actors by id, as the hub system's does.
161
- function fakeScene(actors) {
162
- const all = new Map(actors.map((actor) => [actor.id, actor]));
163
- const calls = { spawned: [], despawned: [] };
216
+ // A scene as the hub system hands `frame`: the world's nodes by actor id, the
217
+ // files map, and who is who.
218
+ function fakeScene() {
219
+ const world = new THREE.Scene();
220
+ const nodes = new Map();
221
+ const files = {};
222
+ for (const id of HATS) {
223
+ files[`imports/castle.hub-game/${hatFile(id)}`] = read(id);
224
+ }
225
+ const place = (actorId, x, z, turn) => {
226
+ const node = new THREE.Group();
227
+ node.position.set(x, 1, z);
228
+ node.rotation.y = (turn * Math.PI) / 180;
229
+ world.add(node);
230
+ nodes.set(actorId, { node });
231
+ return node;
232
+ };
164
233
  return {
165
- calls,
166
- multiplayer: { net: { selfId: () => 'me' }, avatars: { actors: new Map([['p2', 'body-p2']]), retired: new Set() } },
167
- getActor: (id) => all.get(id) ?? null,
168
- spawnActor(actor) {
169
- const made = { id: actor.id, components: { ...actor.components, Transform: { x: 0, y: 0, z: 0, rotationX: 0, rotationY: 0, rotationZ: 0, ...actor.components.Transform } } };
170
- all.set(made.id, made);
171
- calls.spawned.push(actor);
172
- },
173
- despawnActor(id) {
174
- all.delete(id);
175
- calls.despawned.push(id);
176
- },
234
+ world,
235
+ place,
236
+ files,
237
+ three: { nodes },
238
+ multiplayer: { net: { selfId: () => 'me' }, avatars: { actors: new Map([['p2', 'body-p2']]) } },
177
239
  };
178
240
  }
241
+ const worldAt = (object) => object.getWorldPosition(new THREE.Vector3());
179
242
 
180
- test('a hat follows its wearer and faces the way they face; a halo is moved as it was', () => {
181
- const local = { id: 'me-body', components: { Transform: { x: 10, y: 1, z: 20, rotationY: 0 } } };
182
- const other = { id: 'body-p2', components: { Transform: { x: -3, y: 1, z: 4, rotationY: 90 } } };
183
- const scene = fakeScene([local, other]);
243
+ test("what is worn hangs under the avatar's node: it turns and walks with it, and is hidden with it", () => {
244
+ const scene = fakeScene();
245
+ const mine = scene.place('me-body', 10, 20, 0);
246
+ const theirs = scene.place('body-p2', -3, 4, 90);
184
247
  const wear = makeWear();
185
248
  const wearing = new Map([
186
249
  ['me', { kind: 'halo', color: '#ffd700', rarity: 0 }],
187
- ['p2', { kind: 'hat-cap', color: '#d1453b', rarity: 0 }],
250
+ ['p2', { kind: 'hat-cap', color: '#2f6fd0', rarity: 0 }],
188
251
  ]);
252
+ const local = { id: 'me-body' };
189
253
  const asked = [];
190
254
  const fitOf = (playerId) => {
191
255
  asked.push(playerId);
192
- return Avatar.hatFit(1, 'blocky');
256
+ return Avatar.hatFit(1, 'toon');
193
257
  };
194
- wear.frame(scene, local, wearing, () => 1.66, 0, fitOf);
195
- // Only the hat's wearer is asked for a fit.
196
- assert.deepEqual(asked, ['p2']);
197
- assert.deepEqual(
198
- scene.calls.spawned.map((a) => a.id),
199
- ['wear:me:0', 'wear:p2:0', 'wear:p2:1'],
258
+ wear.frame(scene, local, wearing, () => 1.5, 0, fitOf);
259
+ // A hat's and a halo's wearers are asked for a fit (a halo is as wide as the head).
260
+ assert.deepEqual(asked.sort(), ['me', 'p2']);
261
+ const halo = mine.children.find((child) => child.name === 'wear:halo');
262
+ const cap = theirs.children.find((child) => child.name === 'wear:hat');
263
+ assert.ok(halo && cap);
264
+ // Nothing went anywhere but under the two nodes: no actors, nothing loose in the world.
265
+ assert.equal(scene.world.children.length, 2);
266
+ // The cap is the model, scaled to the head and seated on it.
267
+ const model = cap.children[0];
268
+ assert.equal(model.scale.x, 1.1);
269
+ assert.ok(Math.abs(model.position.y - (MODEL_FEET_Y + 1.21)) < 1e-9);
270
+ // The halo is one ring with an open middle, in the wearable's colour.
271
+ const turn = halo.children[0];
272
+ const ring = turn.children[0];
273
+ assert.equal(ring.geometry.type, 'TorusGeometry');
274
+ assert.equal(`#${ring.material.color.getHexString()}`, '#ffd700');
275
+ // They turn and walk: what is worn goes with them, made once.
276
+ theirs.rotation.y = Math.PI;
277
+ theirs.position.x = 5;
278
+ scene.world.updateMatrixWorld(true);
279
+ assert.ok(Math.abs(worldAt(model).x - 5) < 1e-9);
280
+ wear.frame(scene, local, wearing, () => 1.5, 16, fitOf);
281
+ assert.equal(
282
+ theirs.children.find((child) => child.name === 'wear:hat'),
283
+ cap,
200
284
  );
201
- // The halo's actor is spawned with the fields it always had.
202
- assert.deepEqual(Object.keys(scene.calls.spawned[0].components.Transform), ['x', 'y', 'z']);
203
- const halo = scene.getActor('wear:me:0').components.Transform;
204
- assert.deepEqual([halo.x, halo.z, halo.rotationY], [10, 20, 0]);
205
- // The cap's peak is in front of the head (0.27 m, times this avatar's 1.1):
206
- // the wearer faces +x at 90 degrees, so it is there, turned with them.
207
- const reach = 0.27 * 1.1;
208
- const crown = scene.getActor('wear:p2:0').components.Transform;
209
- const peak = scene.getActor('wear:p2:1').components.Transform;
210
- assert.ok(Math.abs(crown.x + 3) < 1e-9 && Math.abs(crown.z - 4) < 1e-9);
211
- assert.ok(Math.abs(peak.x - (-3 + reach)) < 1e-9 && Math.abs(peak.z - 4) < 1e-9);
212
- assert.equal(peak.rotationY, 90);
213
- assert.ok(Math.abs(crown.y - (1 + MODEL_FEET_Y + 1.48 + 0.075 * 1.1)) < 1e-3);
214
- // They turn and walk: the hat goes with them, and nothing is spawned again.
215
- other.components.Transform.rotationY = 180;
216
- other.components.Transform.x = 0;
217
- wear.frame(scene, local, wearing, () => 1.66, 16, fitOf);
218
- assert.equal(scene.calls.spawned.length, 3);
219
- assert.ok(Math.abs(peak.x) < 1e-9 && Math.abs(peak.z - (4 - reach)) < 1e-9);
220
- // Another avatar set fits it again; taking it off takes the pieces down.
221
- wear.frame(scene, local, wearing, () => 1.66, 32, () => Avatar.hatFit(1, 'toon'));
222
- assert.deepEqual(scene.calls.despawned, ['wear:p2:0', 'wear:p2:1']);
285
+ // The halo bobs; nothing else of it changes.
286
+ wear.frame(scene, local, wearing, () => 1.5, 800, fitOf);
287
+ assert.notEqual(halo.position.y, 0);
288
+ // Hidden with the body: the orbit camera's hide sets the node's visible false.
289
+ mine.visible = false;
290
+ let drawn = 0;
291
+ scene.world.traverseVisible((object) => (drawn += object === ring ? 1 : 0));
292
+ assert.equal(drawn, 0);
293
+ mine.visible = true;
294
+ // A node rebuilt (another avatar) is worn on again; another fit makes it again.
295
+ scene.world.remove(theirs);
296
+ const rebuilt = scene.place('body-p2', 5, 4, 180);
297
+ wear.frame(scene, local, wearing, () => 1.5, 32, fitOf);
298
+ assert.ok(rebuilt.children.some((child) => child.name === 'wear:hat'));
299
+ wear.frame(
300
+ scene,
301
+ local,
302
+ wearing,
303
+ () => 1.5,
304
+ 48,
305
+ () => Avatar.hatFit(0, 'toon'),
306
+ );
307
+ const refit = rebuilt.children.find((child) => child.name === 'wear:hat');
308
+ assert.equal(refit.children[0].scale.x, 1.3);
309
+ // Taking it off takes it down, and frees what the halo made.
310
+ // (The new fit made the halo again, as wide as the new head.)
311
+ const now = mine.children.find((child) => child.name === 'wear:halo').children[0].children[0];
312
+ assert.notEqual(now, ring);
313
+ assert.ok(now.geometry.parameters.radius > ring.geometry.parameters.radius);
314
+ let freed = 0;
315
+ now.geometry.addEventListener('dispose', () => (freed += 1));
316
+ wearing.delete('me');
223
317
  wearing.delete('p2');
224
- wear.frame(scene, local, wearing, () => 1.66, 48, fitOf);
225
- assert.equal(scene.getActor('wear:p2:0'), null);
226
- assert.ok(scene.getActor('wear:me:0'));
318
+ wear.frame(scene, local, wearing, () => 1.5, 64, fitOf);
319
+ assert.equal(mine.children.length, 0);
320
+ assert.equal(rebuilt.children.length, 0);
321
+ assert.equal(freed, 1);
322
+ });
323
+
324
+ test('a hat model is built once per world and text, shared, given back by its last wearer, and baked later where the world bakes later', () => {
325
+ const scene = fakeScene();
326
+ const a = scene.place('me-body', 0, 0, 0);
327
+ const b = scene.place('body-p2', 2, 0, 0);
328
+ const wear = makeWear();
329
+ const cap = { kind: 'hat-cap', color: '#2f6fd0', rarity: 0 };
330
+ const wearing = new Map([['me', cap], ['p2', cap]]);
331
+ wear.frame(scene, { id: 'me-body' }, wearing, () => 1.5, 0, () => Avatar.hatFit(0, 'toon'));
332
+ const meshes = (node) => {
333
+ const out = [];
334
+ node.traverse((object) => object.isMesh && out.push(object));
335
+ return out;
336
+ };
337
+ const [mine, theirs] = [meshes(a), meshes(b)];
338
+ assert.ok(mine.length > 0 && mine.length === theirs.length);
339
+ assert.ok(mine.every((mesh, i) => mesh.geometry === theirs[i].geometry), 'one build, shared');
340
+ // A pack mounted with the engine's same hat files: a new files map, the same text, nothing built again.
341
+ scene.files = { ...scene.files };
342
+ wearing.set('p2', { ...cap, rarity: 1 });
343
+ wear.frame(scene, { id: 'me-body' }, wearing, () => 1.5, 16, () => Avatar.hatFit(0, 'toon'));
344
+ assert.equal(meshes(b)[0].geometry, mine[0].geometry);
345
+ // The first wearer leaving frees nothing; the last one frees the build, once.
346
+ let freed = 0;
347
+ mine[0].geometry.addEventListener('dispose', () => (freed += 1));
348
+ // Refitted (another avatar set), it keeps the build.
349
+ wear.frame(scene, { id: 'me-body' }, wearing, () => 1.5, 24, () => Avatar.hatFit(1, 'toon'));
350
+ assert.equal(freed, 0);
351
+ assert.equal(meshes(a)[0].geometry, mine[0].geometry);
352
+ wearing.delete('me');
353
+ wear.frame(scene, { id: 'me-body' }, wearing, () => 1.5, 32, () => Avatar.hatFit(1, 'toon'));
354
+ assert.equal(freed, 0);
355
+ wear.clear();
356
+ assert.equal(freed, 1);
357
+ // A world that bakes looks later (physics-3d `bakesLookLater`) gets the hat's
358
+ // bake queued, as its placed models' are, not done inside the frame.
359
+ const later = fakeScene();
360
+ later.three.bakesLookLater = true;
361
+ later.three.lookBake = makeLookBake();
362
+ later.place('me-body', 0, 0, 0);
363
+ makeWear().frame(later, { id: 'me-body' }, new Map([['me', cap]]), () => 1.5, 0, () => null);
364
+ assert.ok(later.three.lookBake.tasks.length > 0, 'queued');
365
+ // A world that would bake later but has no queue yet (nothing deferred so
366
+ // far) bakes the hat now and makes no queue of its own.
367
+ const early = fakeScene();
368
+ early.three.bakesLookLater = true;
369
+ early.place('me-body', 0, 0, 0);
370
+ makeWear().frame(early, { id: 'me-body' }, new Map([['me', cap]]), () => 1.5, 0, () => null);
371
+ assert.equal(early.three.lookBake, undefined);
372
+ assert.ok(early.three.nodes.get('me-body').node.children.length === 1);
373
+ });
374
+
375
+ test('a new world builds its own hat; a disposed hub system gives back what is worn', () => {
376
+ const scene = fakeScene();
377
+ scene.place('me-body', 0, 0, 0);
378
+ const wear = makeWear();
379
+ const wearing = new Map([['me', { kind: 'hat-cap', color: '#2f6fd0', rarity: 0 }]]);
380
+ wear.frame(scene, { id: 'me-body' }, wearing, () => 1.5, 0, () => null);
381
+ const first = scene.three.nodes.get('me-body').node.children[0];
382
+ let freed = 0;
383
+ first.traverse((object) => object.isMesh && object.geometry.addEventListener('dispose', () => (freed += 1)));
384
+ // The runtime is made again over another world, the same avatar and hat.
385
+ const next = fakeScene();
386
+ const node = next.place('me-body', 0, 0, 0);
387
+ wear.frame(next, { id: 'me-body' }, wearing, () => 1.5, 16, () => null);
388
+ const second = node.children[0];
389
+ assert.notEqual(second, first);
390
+ let geometry = null;
391
+ second.traverse((object) => object.isMesh && !geometry && (geometry = object.geometry));
392
+ let mine = null;
393
+ first.traverse((object) => object.isMesh && !mine && (mine = object.geometry));
394
+ assert.notEqual(geometry, mine, 'its own build');
395
+ assert.ok(freed > 0, 'the old world\'s share given back');
396
+ wear.clear();
397
+ assert.equal(node.children.length, 0);
398
+ });
399
+
400
+ test('with nothing worn nothing is made, added or changed on any node (a place that wears nothing draws as before)', () => {
401
+ const scene = fakeScene();
402
+ const nodes = ['me-body', 'body-p2'].map((id, i) => scene.place(id, i, 0, 0));
403
+ const before = JSON.stringify(scene.world.toJSON());
404
+ const wear = makeWear();
405
+ for (let t = 0; t < 10; t += 1) {
406
+ wear.frame(scene, { id: 'me-body' }, new Map(), () => 1.5, t * 16, () => {
407
+ throw new Error('no fit is asked for');
408
+ });
409
+ }
410
+ // A kind the kit does not draw is drawn as nothing too.
411
+ wear.frame(scene, { id: 'me-body' }, new Map([['p2', { kind: 'crown', color: '#ffd700', rarity: 1 }]]), () => 1.5, 200, () => null);
412
+ assert.ok(nodes.every((node) => node.children.length === 0));
413
+ assert.equal(JSON.stringify(scene.world.toJSON()), before);
414
+ wear.clear();
415
+ wear.forget();
416
+ });
417
+
418
+ test('a halo faces the camera that draws it and leans back toward it, read from the avatar\'s Transform, not its node', () => {
419
+ const scene = fakeScene();
420
+ const node = scene.place('me-body', 0, 0, 90);
421
+ const local = { id: 'me-body', components: { Transform: { x: 0, y: 1, z: 0, rotationY: 90 } } };
422
+ scene.three.camera = new THREE.PerspectiveCamera();
423
+ scene.three.camera.position.set(0, 3, 4);
424
+ const wear = makeWear();
425
+ const wearing = new Map([['me', { kind: 'halo', color: '#f08a3c', rarity: 2 }]]);
426
+ wear.frame(scene, local, wearing, () => 1.5, 0, () => null);
427
+ const halo = node.children.find((child) => child.name === 'wear:halo');
428
+ const ring = halo.children[0].children[0];
429
+ const face = () => {
430
+ scene.world.updateMatrixWorld(true);
431
+ return new THREE.Vector3(0, 0, 1).transformDirection(ring.matrixWorld);
432
+ };
433
+ const toCamera = () => scene.three.camera.position.clone().sub(ring.getWorldPosition(new THREE.Vector3())).setY(0).normalize();
434
+ // The ring's face (its torus axis) points up and toward the camera.
435
+ assert.ok(face().y > 0.7 && face().y < 0.9, `leans ${face().y}`);
436
+ assert.ok(face().setY(0).normalize().dot(toCamera()) > 0.99, 'toward the camera');
437
+ // The avatar turns: wear runs before the engine moves the node (syncActors),
438
+ // so the facing comes from the Transform, and is right once the node follows.
439
+ local.components.Transform.rotationY = 180;
440
+ wear.frame(scene, local, wearing, () => 1.5, 16, () => null);
441
+ node.rotation.y = Math.PI;
442
+ assert.ok(face().setY(0).normalize().dot(toCamera()) > 0.99, 'right on the frame of the turn');
443
+ // The camera goes round: the halo follows it.
444
+ scene.three.camera.position.set(-4, 3, 0);
445
+ wear.frame(scene, local, wearing, () => 1.5, 32, () => null);
446
+ assert.ok(face().setY(0).normalize().x < -0.99, 'turned to the new camera');
447
+ });
448
+
449
+ test('an avatar with no node yet wears nothing until it has one; an orbit circles the head', () => {
450
+ const scene = fakeScene();
451
+ const wear = makeWear();
452
+ const wearing = new Map([['p2', { kind: 'orbit', color: '#00ff88', rarity: 3 }]]);
453
+ wear.frame(scene, null, wearing, () => 1.5, 0);
454
+ const node = scene.place('body-p2', 0, 0, 0);
455
+ wear.frame(scene, null, wearing, () => 1.5, 1000);
456
+ const orbit = node.children.find((child) => child.name === 'wear:orbit');
457
+ assert.equal(orbit.children.length, 2);
458
+ const [a, b] = orbit.children.map((bead) => bead.position.clone());
459
+ assert.ok(Math.abs(Math.hypot(a.x, a.z) - 0.5) < 1e-9 && a.distanceTo(b) > 0.5);
460
+ wear.frame(scene, null, wearing, () => 1.5, 1500);
461
+ assert.ok(orbit.children[0].position.distanceTo(a) > 0.1);
462
+ });
463
+
464
+ test('hub.wearing reads what a player here owns, a copy, never a try-on', () => {
465
+ const h = {
466
+ players: new Map([
467
+ ['p1', {}],
468
+ ['p2', {}],
469
+ ]),
470
+ wearing: new Map([['p1', { kind: 'halo', color: '#f08a3c', rarity: 2 }]]),
471
+ trying: new Map([['p2', { kind: 'hat-cap', color: '#2f6fd0', rarity: 0 }]]),
472
+ };
473
+ const got = Wear.wearing(h, 'p1');
474
+ assert.deepEqual(got, { kind: 'halo', color: '#f08a3c', rarity: 2 });
475
+ got.kind = 'aura';
476
+ assert.equal(h.wearing.get('p1').kind, 'halo');
477
+ assert.equal(Wear.wearing(h, 'p2'), null);
478
+ assert.equal(Wear.wearing(h, 'nobody'), null);
479
+ h.wearing.set('gone', { kind: 'aura', color: '#ffffff', rarity: 0 });
480
+ assert.equal(Wear.wearing(h, 'gone'), null);
227
481
  });
228
482
 
229
483
  console.log(`test-hats: ${n} passed`);