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
@@ -20,6 +20,7 @@ register(
20
20
  );
21
21
 
22
22
  const Avatar = await import('../code/client/avatar.js');
23
+ const { deck } = await import('../code/client/state.js');
23
24
 
24
25
  // A host whose answers the test releases by hand, in any order.
25
26
  function host() {
@@ -38,7 +39,7 @@ function host() {
38
39
  await new Promise((r) => setTimeout(r, 0));
39
40
  };
40
41
  return {
41
- api: { get: () => call('get'), set: (avatar) => call('set', avatar) },
42
+ api: { get: () => call('get'), set: (avatar, options) => call('set', options === undefined ? avatar : { avatar, ...options }) },
42
43
  calls,
43
44
  inFlight: () => pending.map((p) => (p.arg === undefined ? [p.name] : [p.name, p.arg])),
44
45
  reply: (value, pick) => settle(pick, (p) => p.resolve(value)),
@@ -75,7 +76,7 @@ await test("wears the account's avatar once the host answers, and reads it once"
75
76
  });
76
77
 
77
78
  await test('without a platform avatar the stand-in pick is worn and chosen', async () => {
78
- for (const settle of [(h) => h.reply(unavailable), (h) => h.fail({ code: 'UNKNOWN_COMMAND' }), (h) => h.reply(ok(Avatar.AVATARS))]) {
79
+ for (const settle of [(h) => h.reply(unavailable), (h) => h.reply(ok(Avatar.AVATARS))]) {
79
80
  const h = host();
80
81
  const scene = { persistent: { hubAvatar: 1 } };
81
82
  Avatar.resetPlatformForTests(h.api);
@@ -95,6 +96,298 @@ await test('without a platform avatar the stand-in pick is worn and chosen', asy
95
96
  assert.equal(Avatar.current(scene), 0);
96
97
  });
97
98
 
99
+ // Only the avatar module uses this clock; host settlement still flushes normally.
100
+ function fakeClock() {
101
+ let now = 0;
102
+ let id = 0;
103
+ const timers = new Map();
104
+ const flush = async () => { for (let i = 0; i < 8; i++) { await Promise.resolve(); } };
105
+ return {
106
+ now: () => now,
107
+ setTimeout(fn, delay) { const key = ++id; timers.set(key, { at: now + delay, fn }); return key; },
108
+ clearTimeout(key) { timers.delete(key); },
109
+ pending: () => timers.size,
110
+ async advance(ms) {
111
+ const end = now + ms;
112
+ await flush();
113
+ for (;;) {
114
+ const next = [...timers].sort((a, b) => a[1].at - b[1].at)[0];
115
+ if (!next || next[1].at > end) { break; }
116
+ now = next[1].at;
117
+ timers.delete(next[0]);
118
+ next[1].fn();
119
+ await flush();
120
+ }
121
+ now = end;
122
+ await flush();
123
+ },
124
+ };
125
+ }
126
+
127
+ await test('transport read failures retry once per runtime and write a pick after recovery', async () => {
128
+ const clock = fakeClock();
129
+ const h = host();
130
+ h.api.colors = true;
131
+ const scene = { persistent: { hubAvatar: 1 } };
132
+ const warn = console.warn;
133
+ const warnings = [];
134
+ console.warn = (...args) => warnings.push(args);
135
+ try {
136
+ Avatar.resetPlatformForTests(h.api, clock);
137
+ Avatar.load(scene);
138
+ await h.fail({ code: 'CASTLE_HOST_UNAVAILABLE' });
139
+ Avatar.choose(scene, 9);
140
+ Avatar.load(scene);
141
+ assert.equal(Avatar.diagnostics().state, 'loading');
142
+ assert.equal(Avatar.current(scene), 9);
143
+ assert.equal(scene.persistent.hubAvatar, 1);
144
+ assert.deepEqual(h.inFlight(), []);
145
+ await clock.advance(1999);
146
+ assert.equal(h.calls.length, 1);
147
+ await clock.advance(1);
148
+ assert.deepEqual(h.inFlight(), [['get']]);
149
+ Avatar.load(scene);
150
+ await clock.advance(4000);
151
+ assert.equal(h.calls.length, 2, 'no read overlaps a pending read');
152
+ await h.fail(new Error('timeout'));
153
+ await clock.advance(3999);
154
+ assert.equal(h.calls.length, 2);
155
+ await clock.advance(1);
156
+ await h.reply({ ...ok(2), color: 3 });
157
+ assert.equal(Avatar.diagnostics().state, 'ready');
158
+ assert.equal(Avatar.colorsAvailable(), true);
159
+ assert.equal(Avatar.diagnostics().color, 3);
160
+ assert.equal(Avatar.diagnostics().retries, 2);
161
+ assert.equal(Avatar.diagnostics().lastError, 'Error');
162
+ assert.equal(Object.isFrozen(Avatar.diagnostics()), true);
163
+ assert.deepEqual(h.inFlight(), [['set', 9]]);
164
+ await h.reply({ ...ok(9), color: 0 });
165
+ assert.equal(Avatar.current(scene), 9);
166
+ assert.equal(clock.pending(), 0);
167
+ assert.equal(warnings.length, 1, 'only the first failure warns');
168
+ assert.match(warnings[0][0], /^\[hub\] platform avatar /);
169
+ } finally { console.warn = warn; Avatar.resetPlatformForTests(null); }
170
+ });
171
+
172
+ await test('the default clock retries under browser timers that need a bare call', async () => {
173
+ // Browsers throw "Illegal invocation" when setTimeout is called with `this`
174
+ // set to another object; Node does not, so model that here.
175
+ const { setTimeout: realSet, clearTimeout: realClear } = globalThis;
176
+ const queued = new Map();
177
+ let id = 0;
178
+ function strict(self) {
179
+ if (self !== undefined && self !== globalThis) { throw new TypeError('Illegal invocation'); }
180
+ }
181
+ globalThis.setTimeout = function (fn, ms) {
182
+ strict(this);
183
+ if (ms < 1000) { return realSet(fn, ms); }
184
+ queued.set(++id, fn);
185
+ return id;
186
+ };
187
+ globalThis.clearTimeout = function (key) {
188
+ strict(this);
189
+ if (!queued.delete(key)) { realClear(key); }
190
+ };
191
+ const h = host();
192
+ const scene = { persistent: { hubAvatar: 1 } };
193
+ const warn = console.warn;
194
+ console.warn = () => {};
195
+ try {
196
+ Avatar.resetPlatformForTests(h.api);
197
+ Avatar.load(scene);
198
+ await h.fail({ code: 'CASTLE_HOST_UNAVAILABLE' });
199
+ assert.equal(queued.size, 1, 'a retry is scheduled');
200
+ const [[key, retry]] = queued;
201
+ queued.delete(key);
202
+ retry();
203
+ assert.deepEqual(h.inFlight(), [['get']]);
204
+ await h.reply(ok(2, false));
205
+ assert.equal(Avatar.diagnostics().state, 'ready');
206
+ assert.equal(Avatar.diagnostics().retries, 1);
207
+ assert.equal(Avatar.current(scene), 2);
208
+ } finally {
209
+ console.warn = warn;
210
+ Avatar.resetPlatformForTests(null);
211
+ globalThis.setTimeout = realSet;
212
+ globalThis.clearTimeout = realClear;
213
+ }
214
+ });
215
+
216
+ await test('read retry budget keeps the pick on give-up', async () => {
217
+ const clock = fakeClock();
218
+ const scene = { persistent: { hubAvatar: 1 } };
219
+ let reads = 0;
220
+ const warn = console.warn;
221
+ const warnings = [];
222
+ console.warn = (...args) => warnings.push(args);
223
+ try {
224
+ // A synchronous throw is a transport failure too.
225
+ Avatar.resetPlatformForTests({ get() { reads++; throw new Error('not listening'); } }, clock);
226
+ Avatar.load(scene);
227
+ Avatar.choose(scene, 3);
228
+ await clock.advance(179999);
229
+ assert.equal(Avatar.diagnostics().state, 'loading');
230
+ await clock.advance(1);
231
+ assert.equal(Avatar.diagnostics().state, 'none');
232
+ assert.equal(scene.persistent.hubAvatar, 3);
233
+ assert.equal(Avatar.current(scene), 3);
234
+ assert.equal(reads, 9);
235
+ assert.equal(clock.pending(), 0);
236
+ assert.equal(warnings.length, 2);
237
+ assert.match(warnings[1][0], /gave up/);
238
+ Avatar.load(scene);
239
+ await clock.advance(30000);
240
+ assert.equal(reads, 9, 'giving up ends the runtime read chain');
241
+ } finally { console.warn = warn; Avatar.resetPlatformForTests(null); }
242
+ });
243
+
244
+ await test('time spent awaiting a read counts against the retry budget', async () => {
245
+ const h = host();
246
+ const clock = fakeClock();
247
+ Avatar.resetPlatformForTests(h.api, clock);
248
+ Avatar.load({});
249
+ await clock.advance(179000);
250
+ await h.fail({ code: 'CASTLE_HOST_UNAVAILABLE' });
251
+ await clock.advance(999);
252
+ assert.equal(Avatar.diagnostics().state, 'loading');
253
+ await clock.advance(1);
254
+ assert.equal(Avatar.diagnostics().state, 'none');
255
+ assert.deepEqual(h.calls, [['get']]);
256
+ assert.equal(clock.pending(), 0);
257
+ });
258
+
259
+ await test('an unavailable answer ends read retries immediately', async () => {
260
+ const h = host();
261
+ const clock = fakeClock();
262
+ const scene = { persistent: {} };
263
+ Avatar.resetPlatformForTests(h.api, clock);
264
+ Avatar.load(scene);
265
+ Avatar.choose(scene, 2);
266
+ await h.reply(unavailable);
267
+ assert.equal(Avatar.diagnostics().state, 'none');
268
+ assert.equal(scene.persistent.hubAvatar, 2);
269
+ await clock.advance(180000);
270
+ assert.deepEqual(h.calls, [['get']]);
271
+ assert.equal(clock.pending(), 0);
272
+ });
273
+
274
+ await test('an UNKNOWN_COMMAND read uses the stand-in immediately without retrying', async () => {
275
+ const h = host();
276
+ const clock = fakeClock();
277
+ const scene = { persistent: { hubAvatar: 1 } };
278
+ Avatar.resetPlatformForTests(h.api, clock);
279
+ Avatar.load(scene);
280
+ Avatar.choose(scene, 2);
281
+ await h.fail({ code: 'UNKNOWN_COMMAND' });
282
+ assert.equal(Avatar.diagnostics().state, 'none');
283
+ assert.equal(Avatar.current(scene), 2);
284
+ assert.equal(scene.persistent.hubAvatar, 2);
285
+ assert.equal(clock.pending(), 0);
286
+ Avatar.load(scene);
287
+ await clock.advance(180000);
288
+ assert.deepEqual(h.calls, [['get']]);
289
+ });
290
+
291
+ for (const code of ['PERMISSION_DENIED', 'UNKNOWN_COMMAND']) {
292
+ await test(`a ${code} write undoes the pick without retrying and allows a newer pick`, async () => {
293
+ const h = host();
294
+ const clock = fakeClock();
295
+ const scene = { persistent: {} };
296
+ Avatar.resetPlatformForTests(h.api, clock);
297
+ Avatar.load(scene);
298
+ await h.reply(ok(1));
299
+ Avatar.choose(scene, 2);
300
+ assert.equal(Avatar.current(scene), 2);
301
+ await h.fail({ code });
302
+ assert.equal(Avatar.current(scene), 1);
303
+ assert.equal(Avatar.diagnostics().state, 'ready');
304
+ assert.equal(clock.pending(), 0);
305
+ assert.deepEqual(h.inFlight(), []);
306
+ Avatar.choose(scene, 3);
307
+ assert.deepEqual(h.inFlight(), [['set', 3]]);
308
+ await h.reply(ok(3));
309
+ assert.equal(Avatar.current(scene), 3);
310
+ await clock.advance(180000);
311
+ assert.deepEqual(h.calls, [['get'], ['set', 2], ['set', 3]]);
312
+ assert.equal(clock.pending(), 0);
313
+ });
314
+ }
315
+
316
+ await test('a CASTLE_HOST_UNAVAILABLE write succeeds on its next attempt', async () => {
317
+ const h = host();
318
+ const clock = fakeClock();
319
+ const scene = { persistent: {} };
320
+ Avatar.resetPlatformForTests(h.api, clock);
321
+ Avatar.load(scene);
322
+ await h.reply(ok(1));
323
+ Avatar.choose(scene, 2);
324
+ await h.fail({ code: 'CASTLE_HOST_UNAVAILABLE' });
325
+ assert.equal(Avatar.current(scene), 2);
326
+ assert.equal(clock.pending(), 1);
327
+ assert.deepEqual(h.inFlight(), []);
328
+ await clock.advance(1999);
329
+ assert.deepEqual(h.calls, [['get'], ['set', 2]]);
330
+ await clock.advance(1);
331
+ assert.deepEqual(h.inFlight(), [['set', 2]]);
332
+ await h.reply(ok(2));
333
+ assert.equal(Avatar.current(scene), 2);
334
+ assert.equal(clock.pending(), 0);
335
+ await clock.advance(180000);
336
+ assert.deepEqual(h.calls, [['get'], ['set', 2], ['set', 2]]);
337
+ });
338
+
339
+ await test('transport write retries preserve the exact character and colour with newer picks queued', async () => {
340
+ const h = host();
341
+ h.api.colors = true;
342
+ const clock = fakeClock();
343
+ const scene = { persistent: {} };
344
+ Avatar.resetPlatformForTests(h.api, clock);
345
+ Avatar.load(scene);
346
+ await h.reply({ ...ok(9), color: 2 });
347
+ Avatar.chooseColor(scene, 4);
348
+ await h.fail({ code: 'CASTLE_HOST_UNAVAILABLE' });
349
+ Avatar.choose(scene, 3);
350
+ assert.equal(Avatar.current(scene), 3);
351
+ assert.deepEqual(h.inFlight(), []);
352
+ await clock.advance(2000);
353
+ assert.deepEqual(h.inFlight(), [['set', { avatar: 9, color: 4 }]]);
354
+ await h.fail(new Error('timeout'));
355
+ await clock.advance(4000);
356
+ assert.deepEqual(h.inFlight(), [['set', { avatar: 9, color: 4 }]]);
357
+ await h.reply({ ...ok(9), color: 4 });
358
+ assert.deepEqual(h.inFlight(), [['set', 3]]);
359
+ await h.reply(ok(3));
360
+ assert.equal(Avatar.current(scene), 3);
361
+ assert.equal(clock.pending(), 0);
362
+ });
363
+
364
+ await test('write retries are bounded and an unavailable retry still keeps the stand-in', async () => {
365
+ const h = host();
366
+ const clock = fakeClock();
367
+ const scene = { persistent: {} };
368
+ Avatar.resetPlatformForTests(h.api, clock);
369
+ Avatar.load(scene);
370
+ await h.reply(ok(1));
371
+ const set = h.api.set;
372
+ let writes = 0;
373
+ h.api.set = () => { writes++; return Promise.reject(new Error('timeout')); };
374
+ Avatar.choose(scene, 2);
375
+ await clock.advance(179999);
376
+ assert.equal(Avatar.current(scene), 2);
377
+ await clock.advance(1);
378
+ assert.equal(Avatar.current(scene), 1, 'exhausted write restores the confirmed pick');
379
+ assert.equal(Avatar.diagnostics().state, 'ready');
380
+ assert.equal(writes, 9);
381
+ assert.equal(clock.pending(), 0);
382
+ h.api.set = set;
383
+ Avatar.choose(scene, 3);
384
+ await h.fail(new Error('timeout'));
385
+ await clock.advance(2000);
386
+ await h.reply(unavailable);
387
+ assert.equal(scene.persistent.hubAvatar, 3);
388
+ assert.equal(Avatar.diagnostics().state, 'none');
389
+ });
390
+
98
391
  await test("a pick is the account's: worn at once, kept as ghost answers", async () => {
99
392
  const h = host();
100
393
  const scene = { persistent: {} };
@@ -234,12 +527,15 @@ const at = (href) => {
234
527
  return { hostname: url.hostname, search: url.search };
235
528
  };
236
529
  const blueprintOf = (file) => JSON.stringify({ actors: [{ components: { Model: { file } } }] });
530
+ // Toon has all sixteen (v1.51); the other sets draw the first four.
531
+ const SET_AVATARS = 4;
532
+ const countIn = (style) => (style === 'toon' ? Avatar.AVATARS : SET_AVATARS);
237
533
  // A deck's files with the kit imported: toon and one more set.
238
534
  const deckFiles = (...styles) => {
239
535
  const files = {};
240
536
  for (const style of ['toon', ...styles]) {
241
537
  const dir = style === 'toon' ? '' : `${style}/`;
242
- for (let i = 0; i < Avatar.AVATARS; i++) {
538
+ for (let i = 0; i < countIn(style); i++) {
243
539
  files[`imports/castle.hub-game/blueprints/${dir}avatar-${i}.scene`] = blueprintOf(`models/${dir}avatar-${i}.pxmodel`);
244
540
  }
245
541
  }
@@ -252,14 +548,16 @@ await test('with nothing said the set is toon, and everything is where it was',
252
548
  Avatar.resetStyleForTests(undefined);
253
549
  assert.equal(Avatar.style(), 'toon');
254
550
  const files = deckFiles('blocky', 'bean', 'pixel');
255
- const toonTops = [1.38, 1.5, 1.42, 1.56];
551
+ const toonTops = [1.38, 1.5, 1.42, 1.56, 1.31, 1.39, 1.59, 1.29, 1.24, 1.37, 1.38, 1.51, 1.44, 1.38, 1.37, 1.37];
552
+ assert.equal(toonTops.length, Avatar.AVATARS);
256
553
  for (let i = 0; i < Avatar.AVATARS; i++) {
257
554
  assert.equal(Avatar.blueprint(files, i), `imports/castle.hub-game/blueprints/avatar-${i}.scene`);
258
555
  assert.equal(Avatar.model(files, i), `imports/castle.hub-game/models/avatar-${i}.pxmodel`);
259
556
  assert.equal(Avatar.top(i), toonTops[i]);
260
557
  assert.equal(Avatar.drawn(files, i), 'toon');
261
558
  }
262
- assert.equal(Avatar.top(9), 1.65);
559
+ assert.equal(Avatar.top(Avatar.AVATARS), 1.65);
560
+ assert.equal(Avatar.top(99), 1.65);
263
561
  assert.equal(Avatar.blueprint(null, 0), null);
264
562
  });
265
563
 
@@ -404,7 +702,7 @@ await test("a set these files do not have is drawn from toon's, at toon's height
404
702
  assert.equal(Avatar.drawn(null, 0), 'bean');
405
703
  });
406
704
 
407
- await test("every set has four blueprints shaped like toon's, models with the parts the walk moves, art it can find and a height", async () => {
705
+ await test("toon has sixteen blueprints and every other set four, shaped like toon's, with models that have the parts the walk moves, art they can find and a height", async () => {
408
706
  const kit = new URL('../', import.meta.url);
409
707
  const refs = (value, out = []) => {
410
708
  if (typeof value === 'string') {
@@ -416,7 +714,10 @@ await test("every set has four blueprints shaped like toon's, models with the pa
416
714
  };
417
715
  for (const style of Avatar.STYLES) {
418
716
  const dir = style === 'toon' ? '' : `${style}/`;
419
- for (let i = 0; i < Avatar.AVATARS; i++) {
717
+ // No file past a set's own: the kit ships nothing it does not draw.
718
+ await assert.rejects(readFile(new URL(`blueprints/${dir}avatar-${countIn(style)}.scene`, kit), 'utf8'), { code: 'ENOENT' });
719
+ await assert.rejects(readFile(new URL(`models/${dir}avatar-${countIn(style)}.pxmodel`, kit), 'utf8'), { code: 'ENOENT' });
720
+ for (let i = 0; i < countIn(style); i++) {
420
721
  const path = `blueprints/${dir}avatar-${i}.scene`;
421
722
  const text = await readFile(new URL(path, kit), 'utf8');
422
723
  const files = { [path]: text };
@@ -452,6 +753,145 @@ await test("every set has four blueprints shaped like toon's, models with the pa
452
753
  }
453
754
  });
454
755
 
756
+ // --- sixteen avatars (v1.51) ---
757
+
758
+ await test('sixteen avatars: every index has a blueprint, a model, a height and a hat fit', async () => {
759
+ assert.equal(Avatar.AVATARS, 16);
760
+ const kit = new URL('../', import.meta.url);
761
+ const files = {};
762
+ for (let i = 0; i < Avatar.AVATARS; i++) {
763
+ files[`blueprints/avatar-${i}.scene`] = await readFile(new URL(`blueprints/avatar-${i}.scene`, kit), 'utf8');
764
+ }
765
+ const models = new Set();
766
+ for (let i = 0; i < Avatar.AVATARS; i++) {
767
+ assert.equal(Avatar.blueprint(files, i, 'toon'), `blueprints/avatar-${i}.scene`);
768
+ const model = Avatar.model(files, i, 'toon');
769
+ assert.equal(model, `models/avatar-${i}.pxmodel`);
770
+ models.add(await readFile(new URL(model, kit), 'utf8'));
771
+ const top = Avatar.top(i, 'toon');
772
+ assert.ok(top >= 1.2 && top <= 1.75, `avatar ${i} top ${top}`);
773
+ const fit = Avatar.hatFit(i, 'toon');
774
+ assert.ok(Array.isArray(fit) && fit.length === 3 && fit.every(Number.isFinite), `avatar ${i} hat fit`);
775
+ assert.equal(Avatar.known(i), i);
776
+ // The body is the first avatar's: only the name and the model differ.
777
+ const { name, actors } = JSON.parse(files[`blueprints/avatar-${i}.scene`]);
778
+ assert.equal(name, `Avatar ${i + 1}`);
779
+ const first = JSON.parse(files['blueprints/avatar-0.scene']).actors;
780
+ first[0].components.Model.file = model;
781
+ assert.deepEqual(actors, first, `blueprints/avatar-${i}.scene`);
782
+ }
783
+ // Sixteen different characters.
784
+ assert.equal(models.size, Avatar.AVATARS);
785
+ // The place's server takes exactly the indexes the client draws.
786
+ const server = await readFile(new URL('code/server/hub.js', kit), 'utf8');
787
+ assert.equal(Number(/^export const AVATARS = (\d+);$/m.exec(server)[1]), Avatar.AVATARS);
788
+ });
789
+
790
+ await test("a set draws 4-15 from toon's blueprint, at toon's height and hat fit", () => {
791
+ const files = deckFiles('blocky', 'bean', 'pixel');
792
+ for (const style of ['blocky', 'bean', 'pixel']) {
793
+ Avatar.resetStyleForTests({ location: undefined, experiment: () => style });
794
+ assert.equal(Avatar.style(), style);
795
+ for (let i = 0; i < Avatar.AVATARS; i++) {
796
+ const own = i < SET_AVATARS;
797
+ const dir = own ? `${style}/` : '';
798
+ assert.equal(Avatar.blueprint(files, i), `imports/castle.hub-game/blueprints/${dir}avatar-${i}.scene`, `${style} ${i}`);
799
+ assert.equal(Avatar.model(files, i), `imports/castle.hub-game/models/${dir}avatar-${i}.pxmodel`, `${style} ${i}`);
800
+ assert.equal(Avatar.drawn(files, i), own ? style : 'toon', `${style} ${i}`);
801
+ // What the hub system asks: the height and fit of the set really drawn.
802
+ const drawn = Avatar.drawn(files, i);
803
+ assert.equal(Avatar.top(i, drawn), Avatar.top(i, own ? style : 'toon'));
804
+ assert.equal(Avatar.hatFit(i, drawn), Avatar.hatFit(i, own ? style : 'toon'));
805
+ // And asked of the set itself (before the files are known, `drawn` is
806
+ // the set asked for): toon's numbers for an index the set has no row
807
+ // for, never undefined.
808
+ assert.equal(Avatar.drawn(null, i), style);
809
+ const top = Avatar.top(i, style);
810
+ const fit = Avatar.hatFit(i, style);
811
+ assert.ok(Number.isFinite(top) && Array.isArray(fit) && fit.every(Number.isFinite), `${style} ${i}`);
812
+ if (!own) {
813
+ assert.equal(top, Avatar.top(i, 'toon'), `${style} ${i}`);
814
+ assert.equal(fit, Avatar.hatFit(i, 'toon'), `${style} ${i}`);
815
+ }
816
+ }
817
+ // The first four are the set's own, as they were.
818
+ assert.notDeepEqual([0, 1, 2, 3].map((i) => Avatar.top(i, style)), [0, 1, 2, 3].map((i) => Avatar.top(i, 'toon')));
819
+ }
820
+ Avatar.resetStyleForTests(undefined);
821
+ });
822
+
823
+ await test('a new stand-in can wear any known avatar; stored choices are kept', async () => {
824
+ const random = Math.random;
825
+ try {
826
+ // Every bucket's edges, including the top of the random range.
827
+ const seen = new Set();
828
+ for (let index = 0; index < Avatar.AVATARS; index++) {
829
+ for (const roll of [index / Avatar.AVATARS, (index + 1 - 0.000001) / Avatar.AVATARS]) {
830
+ Math.random = () => roll;
831
+ Avatar.resetPlatformForTests(null);
832
+ const scene = {};
833
+ Avatar.load(scene);
834
+ const worn = Avatar.current(scene);
835
+ assert.equal(worn, index, `roll ${roll} gave ${worn}`);
836
+ assert.equal(Avatar.known(worn), worn, 'the stand-in is always a known index');
837
+ assert.equal(scene.persistent.hubAvatar, worn);
838
+ assert.equal(Avatar.current(scene), worn, 'the local choice is kept');
839
+ seen.add(worn);
840
+ }
841
+ }
842
+ assert.deepEqual([...seen], Array.from({ length: 16 }, (_, index) => index));
843
+ } finally {
844
+ Math.random = random;
845
+ }
846
+ // One kept from before is kept, a new one included, and a pick of a new one is worn.
847
+ Avatar.resetPlatformForTests(null);
848
+ for (const kept of [0, 3, 4, 15]) {
849
+ assert.equal(Avatar.current({ persistent: { hubAvatar: kept } }), kept);
850
+ }
851
+ const scene = { persistent: { hubAvatar: 2 } };
852
+ Avatar.choose(scene, 15);
853
+ assert.equal(Avatar.current(scene), 15);
854
+ for (const bad of [16, -1, 4.5, '9', null, undefined, NaN, Infinity]) {
855
+ Avatar.choose(scene, bad);
856
+ assert.equal(Avatar.current(scene), 15, String(bad));
857
+ }
858
+ // The account's avatar may be a new one; the host is asked for it and told of a pick as before.
859
+ const h = host();
860
+ const account = { persistent: { hubAvatar: 1 } };
861
+ await ready(h, 9, account);
862
+ assert.equal(Avatar.current(account), 9);
863
+ Avatar.choose(account, 12);
864
+ assert.equal(Avatar.current(account), 12);
865
+ await h.reply(ok(12), setOf(12));
866
+ assert.equal(Avatar.current(account), 12);
867
+ assert.deepEqual(h.calls, [['get'], ['set', 12]]);
868
+ assert.equal(account.persistent.hubAvatar, 1, 'the stand-in is left alone');
869
+ });
870
+
871
+ await test('an index past this kit (a later kit) is drawn as one of the first four, and anything else as nobody', () => {
872
+ for (let i = 0; i < Avatar.AVATARS; i++) {
873
+ assert.equal(Avatar.known(i), i);
874
+ }
875
+ assert.deepEqual([16, 17, 18, 19, 20, 255, 1000].map(Avatar.known), [0, 1, 2, 3, 0, 3, 0]);
876
+ for (const bad of [-1, -16, 1.5, 16.5, '2', '16', null, undefined, NaN, Infinity, {}, true]) {
877
+ assert.equal(Avatar.known(bad), null, String(bad));
878
+ }
879
+ // Drawn and dressed by it: a blueprint these files have, toon's row for it.
880
+ const files = deckFiles('bean');
881
+ for (const which of ['toon', 'bean']) {
882
+ const index = Avatar.known(21);
883
+ assert.equal(index, 1);
884
+ assert.ok(Avatar.blueprint(files, index, which));
885
+ assert.ok(Number.isFinite(Avatar.top(index, Avatar.drawn(files, index, which))));
886
+ assert.ok(Array.isArray(Avatar.hatFit(index, Avatar.drawn(files, index, which))));
887
+ }
888
+ // The index itself has nothing here, and asking is safe.
889
+ assert.equal(Avatar.blueprint(files, 21), null);
890
+ assert.equal(Avatar.model(files, 21), null);
891
+ assert.equal(Avatar.top(21), 1.65);
892
+ assert.equal(Avatar.hatFit(21), null);
893
+ });
894
+
455
895
  Avatar.resetStyleForTests(undefined);
456
896
 
457
897
  await test('the pack exporter and the town overlay know every set, and only the sets', async () => {
@@ -469,4 +909,141 @@ await test('the pack exporter and the town overlay know every set, and only the
469
909
  }
470
910
  });
471
911
 
912
+ await test('an old host has no colour picker or colour writes, even with a stored stand-in colour', async () => {
913
+ const h = host();
914
+ const scene = { persistent: { hubAvatar: 2, hubAvatarColor: 3 } };
915
+ Avatar.resetPlatformForTests(h.api);
916
+ Avatar.load(scene);
917
+ assert.equal(Avatar.currentColor(scene), 0);
918
+ assert.equal(Avatar.colorsAvailable(), false);
919
+ await h.reply(ok(2));
920
+ Avatar.chooseColor(scene, 3);
921
+ assert.deepEqual(h.calls, [['get']]);
922
+ Avatar.choose(scene, 1);
923
+ await h.reply(ok(1));
924
+ assert.deepEqual(h.calls, [['get'], ['set', 1]]);
925
+ assert.equal(Avatar.currentColor(scene), 0);
926
+ });
927
+
928
+ await test('colours are confirmed, refused, and queued with character picks in order', async () => {
929
+ const h = host();
930
+ h.api.colors = true;
931
+ const scene = { persistent: {} };
932
+ Avatar.resetPlatformForTests(h.api);
933
+ Avatar.load(scene);
934
+ await h.reply({ ...ok(9), color: 2 });
935
+ assert.equal(Avatar.colorsAvailable(), true);
936
+ assert.equal(Avatar.currentColor(scene), 2);
937
+ Avatar.chooseColor(scene, 4);
938
+ assert.equal(Avatar.currentColor(scene), 4);
939
+ await h.reply({ ...ok(9), color: 3 });
940
+ assert.equal(Avatar.currentColor(scene), 3, 'ghost confirms what was actually kept');
941
+ Avatar.chooseColor(scene, 5);
942
+ await h.fail({ code: 'INVALID_ARGUMENT' });
943
+ assert.equal(Avatar.currentColor(scene), 3, 'refusal restores the confirmed colour');
944
+ Avatar.chooseColor(scene, 1);
945
+ Avatar.choose(scene, 2);
946
+ Avatar.chooseColor(scene, 4);
947
+ await h.reply({ ...ok(9), color: 1 });
948
+ assert.equal(Avatar.current(scene), 2);
949
+ assert.equal(Avatar.currentColor(scene), 4);
950
+ await h.reply({ ...ok(2), color: 4 });
951
+ Avatar.choose(scene, 1);
952
+ assert.equal(Avatar.currentColor(scene), 0);
953
+ await h.reply({ ...ok(1), color: 0 });
954
+ assert.deepEqual(h.calls, [['get'], ['set', { avatar: 9, color: 4 }], ['set', { avatar: 9, color: 5 }], ['set', { avatar: 9, color: 1 }], ['set', { avatar: 2, color: 4 }], ['set', 1]]);
955
+ });
956
+
957
+ await test('a colour host needs the exact SDK marker, even with manifest opt-in', async () => {
958
+ for (const marker of [undefined, false, 1, 'true', true]) {
959
+ for (const optIn of [false, true]) {
960
+ const h = host();
961
+ if (marker !== undefined) { h.api.colors = marker; }
962
+ deck.avatarColors = optIn;
963
+ const setArgs = [];
964
+ const set = h.api.set;
965
+ h.api.set = (...args) => { setArgs.push(args); return set(...args); };
966
+ const scene = { persistent: { hubAvatar: 9, hubAvatarColor: 3 } };
967
+ Avatar.resetPlatformForTests(h.api);
968
+ Avatar.load(scene);
969
+ await h.reply({ ...ok(9), color: 2 });
970
+ assert.equal(Avatar.colorsAvailable(), marker === true);
971
+ assert.equal(Avatar.currentColor(scene), marker === true ? 2 : 0);
972
+ Avatar.chooseColor(scene, 4);
973
+ if (marker === true) {
974
+ assert.deepEqual(setArgs, [[9, { color: 4 }]]);
975
+ await h.reply({ ...ok(9), color: 4 });
976
+ } else {
977
+ assert.deepEqual(setArgs, []);
978
+ }
979
+ Avatar.choose(scene, 1);
980
+ assert.deepEqual(setArgs.at(-1), [1], 'character picks retain one argument');
981
+ await h.reply({ ...ok(1), color: 0 });
982
+ }
983
+ }
984
+ delete deck.avatarColors;
985
+ });
986
+
987
+ await test('stand-in colours are dormant without an exact manifest opt-in', async () => {
988
+ for (const avatarColors of [undefined, false, 1, 'true']) {
989
+ if (avatarColors === undefined) {
990
+ delete deck.avatarColors;
991
+ } else {
992
+ deck.avatarColors = avatarColors;
993
+ }
994
+ const scene = { persistent: { hubAvatar: 9, hubAvatarColor: 3 } };
995
+ Avatar.resetPlatformForTests(null);
996
+ Avatar.load(scene);
997
+ assert.equal(Avatar.colorsAvailable(), false);
998
+ assert.equal(Avatar.currentColor(scene), 0);
999
+ Avatar.chooseColor(scene, 2);
1000
+ assert.deepEqual(scene.persistent, { hubAvatar: 9, hubAvatarColor: 3 });
1001
+ Avatar.choose(scene, 10);
1002
+ assert.deepEqual(scene.persistent, { hubAvatar: 10, hubAvatarColor: 3 });
1003
+ const empty = {};
1004
+ Avatar.chooseColor(empty, 2);
1005
+ assert.deepEqual(empty, {}, 'a dormant pick does not initialise an avatar');
1006
+ }
1007
+ delete deck.avatarColors;
1008
+ const h = host();
1009
+ const scene = { persistent: { hubAvatar: 9, hubAvatarColor: 3 } };
1010
+ Avatar.resetPlatformForTests(h.api);
1011
+ Avatar.load(scene);
1012
+ await h.reply(unavailable);
1013
+ assert.equal(Avatar.colorsAvailable(), false);
1014
+ Avatar.chooseColor(scene, 2);
1015
+ assert.equal(Avatar.currentColor(scene), 0);
1016
+ assert.deepEqual(scene.persistent, { hubAvatar: 9, hubAvatarColor: 3 });
1017
+ });
1018
+
1019
+ await test('opted-in stand-in colours persist and clear on a character change, including an unavailable write', async () => {
1020
+ deck.avatarColors = true;
1021
+ const scene = { persistent: { hubAvatar: 9 } };
1022
+ Avatar.resetPlatformForTests(null);
1023
+ Avatar.load(scene);
1024
+ assert.equal(Avatar.colorsAvailable(), true);
1025
+ Avatar.chooseColor(scene, 2);
1026
+ assert.equal(scene.persistent.hubAvatarColor, 2);
1027
+ for (const bad of [-1, 6, 1.5, '2', null]) {
1028
+ Avatar.chooseColor(scene, bad);
1029
+ assert.equal(Avatar.currentColor(scene), 2);
1030
+ }
1031
+ Avatar.choose(scene, 9);
1032
+ assert.equal(Avatar.currentColor(scene), 2);
1033
+ Avatar.choose(scene, 10);
1034
+ assert.equal(Avatar.currentColor(scene), 0);
1035
+ delete deck.avatarColors;
1036
+ const h = host();
1037
+ await ready(h, 10, scene);
1038
+ // Both get's colour field and the SDK marker unlock writes.
1039
+ h.api.colors = true;
1040
+ Avatar.resetPlatformForTests(h.api);
1041
+ Avatar.load(scene);
1042
+ await h.reply({ ...ok(10), color: 0 });
1043
+ Avatar.chooseColor(scene, 3);
1044
+ await h.reply(unavailable);
1045
+ assert.equal(scene.persistent.hubAvatarColor, 3);
1046
+ assert.equal(Avatar.currentColor(scene), 3);
1047
+ });
1048
+
472
1049
  console.log(`hub-game avatar: ${n} tests passed`);