castle-web-cli 0.4.238 → 0.4.240

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 (404) hide show
  1. package/dist/agent.js +5 -1
  2. package/dist/api.d.ts +20 -0
  3. package/dist/api.js +57 -0
  4. package/dist/bundle.d.ts +38 -1
  5. package/dist/bundle.js +309 -13
  6. package/dist/castle-host/host.js +218 -11
  7. package/dist/castleJson.d.ts +10 -0
  8. package/dist/castleJson.js +46 -2
  9. package/dist/check.js +5 -2
  10. package/dist/devSessionServer.js +4 -1
  11. package/dist/devSessionStorage.d.ts +1 -0
  12. package/dist/devSessionStorage.js +32 -7
  13. package/dist/importOrder.d.ts +2 -0
  14. package/dist/importOrder.js +29 -0
  15. package/dist/index.js +22 -3
  16. package/dist/init.js +24 -2
  17. package/dist/multiplayerDoc.d.ts +1 -1
  18. package/dist/multiplayerDoc.js +9 -0
  19. package/dist/platformDoc.js +4 -2
  20. package/dist/playPagePolicy.d.ts +1 -0
  21. package/dist/playPagePolicy.js +12 -3
  22. package/dist/resetLeaderboards.d.ts +8 -1
  23. package/dist/resetLeaderboards.js +43 -8
  24. package/dist/roomLogs.d.ts +39 -0
  25. package/dist/roomLogs.js +166 -0
  26. package/dist/save-deck.d.ts +32 -2
  27. package/dist/save-deck.js +240 -39
  28. package/kits/base/CLAUDE.md +2 -1
  29. package/kits/base/castle.json +1 -1
  30. package/kits/base/sdk/README.md +240 -8
  31. package/kits/base/sdk/analytics.d.ts +8 -0
  32. package/kits/base/sdk/analytics.js +92 -0
  33. package/kits/base/sdk/castle.d.ts +8 -2
  34. package/kits/base/sdk/castle.js +3 -0
  35. package/kits/base/sdk/commands.d.ts +79 -0
  36. package/kits/base/sdk/commands.js +1 -0
  37. package/kits/base/sdk/debugConsole.d.ts +17 -0
  38. package/kits/base/sdk/debugConsole.js +154 -0
  39. package/kits/base/sdk/experiments.js +24 -1
  40. package/kits/base/sdk/hostRetry.d.ts +7 -0
  41. package/kits/base/sdk/hostRetry.js +57 -0
  42. package/kits/base/sdk/hub.d.ts +20 -2
  43. package/kits/base/sdk/hub.js +99 -13
  44. package/kits/base/sdk/multiplayer.d.ts +2 -0
  45. package/kits/base/sdk/multiplayer.js +198 -26
  46. package/kits/base/sdk/reconnectBudget.d.ts +6 -0
  47. package/kits/base/sdk/reconnectBudget.js +41 -1
  48. package/kits/base/sdk/rooms.d.ts +11 -0
  49. package/kits/base/sdk/rooms.js +22 -0
  50. package/kits/base/sdk/runtime.js +36 -19
  51. package/kits/base/sdk/server/hub.d.ts +19 -0
  52. package/kits/base/sdk/server/hub.js +12 -0
  53. package/kits/base/sdk/server/platformHandle.d.ts +1 -0
  54. package/kits/base/sdk/server/wrapper.d.ts +1 -1
  55. package/kits/base/sdk/server/wrapper.js +26 -1
  56. package/kits/base/sdk/store.d.ts +8 -2
  57. package/kits/base/sdk/store.js +5 -1
  58. package/kits/base/sdk/transport.d.ts +2 -1
  59. package/kits/base/sdk/transport.js +35 -0
  60. package/kits/hub-game/CLAUDE.md +66 -19
  61. package/kits/hub-game/castle.json +4 -4
  62. package/kits/hub-game/code/client/act.js +9 -6
  63. package/kits/hub-game/code/client/actCore.js +26 -6
  64. package/kits/hub-game/code/client/actGateLog.js +36 -0
  65. package/kits/hub-game/code/client/actionOverflow.js +29 -8
  66. package/kits/hub-game/code/client/actionRailSurface.js +186 -0
  67. package/kits/hub-game/code/client/actionRailTree.js +173 -0
  68. package/kits/hub-game/code/client/askSurface.js +85 -0
  69. package/kits/hub-game/code/client/askTree.js +51 -0
  70. package/kits/hub-game/code/client/attention.js +31 -6
  71. package/kits/hub-game/code/client/ballot.js +42 -5
  72. package/kits/hub-game/code/client/ballotSurface.js +115 -0
  73. package/kits/hub-game/code/client/ballotTree.js +180 -0
  74. package/kits/hub-game/code/client/catchingUp.js +19 -0
  75. package/kits/hub-game/code/client/celebrate.js +66 -0
  76. package/kits/hub-game/code/client/chrome.js +474 -53
  77. package/kits/hub-game/code/client/companion.js +93 -23
  78. package/kits/hub-game/code/client/companionDress.js +1 -1
  79. package/kits/hub-game/code/client/cornerSurface.js +106 -0
  80. package/kits/hub-game/code/client/cornerTree.js +83 -0
  81. package/kits/hub-game/code/client/decor.js +20 -11
  82. package/kits/hub-game/code/client/deviceStorage.js +121 -0
  83. package/kits/hub-game/code/client/disguise.js +23 -0
  84. package/kits/hub-game/code/client/disguiseDraw.js +87 -0
  85. package/kits/hub-game/code/client/dockSurface.js +206 -0
  86. package/kits/hub-game/code/client/dockTree.js +232 -0
  87. package/kits/hub-game/code/client/earned.js +29 -0
  88. package/kits/hub-game/code/client/emoteSurface.js +188 -0
  89. package/kits/hub-game/code/client/emoteTree.js +264 -0
  90. package/kits/hub-game/code/client/farAvatars.js +4 -3
  91. package/kits/hub-game/code/client/fpsTelemetry.js +3 -1
  92. package/kits/hub-game/code/client/grab.js +121 -50
  93. package/kits/hub-game/code/client/holdShow.js +19 -0
  94. package/kits/hub-game/code/client/hookLayer.js +96 -12
  95. package/kits/hub-game/code/client/hubControls.js +7 -1
  96. package/kits/hub-game/code/client/hudSurface.js +11 -3
  97. package/kits/hub-game/code/client/hudTree.js +7 -4
  98. package/kits/hub-game/code/client/idle.js +21 -3
  99. package/kits/hub-game/code/client/invites.js +24 -3
  100. package/kits/hub-game/code/client/keys.js +15 -0
  101. package/kits/hub-game/code/client/labelsNear.js +8 -1
  102. package/kits/hub-game/code/client/layoutCache.js +57 -8
  103. package/kits/hub-game/code/client/loadingCover.js +53 -4
  104. package/kits/hub-game/code/client/menuIcons.js +15 -0
  105. package/kits/hub-game/code/client/menuRows.js +8 -2
  106. package/kits/hub-game/code/client/menuSurface.js +102 -0
  107. package/kits/hub-game/code/client/menuTree.js +135 -0
  108. package/kits/hub-game/code/client/modelLook.js +41 -0
  109. package/kits/hub-game/code/client/pickerSurface.js +152 -0
  110. package/kits/hub-game/code/client/pickerTree.js +163 -0
  111. package/kits/hub-game/code/client/pushVisit.js +4 -2
  112. package/kits/hub-game/code/client/quality.js +188 -29
  113. package/kits/hub-game/code/client/qualityEntry.js +10 -1
  114. package/kits/hub-game/code/client/quickChatSurface.js +222 -0
  115. package/kits/hub-game/code/client/quickChatTree.js +201 -0
  116. package/kits/hub-game/code/client/rehello.js +75 -0
  117. package/kits/hub-game/code/client/renderVisibility.js +17 -0
  118. package/kits/hub-game/code/client/replay.js +118 -0
  119. package/kits/hub-game/code/client/role.js +3 -0
  120. package/kits/hub-game/code/client/safeLayout.js +441 -56
  121. package/kits/hub-game/code/client/safeStyle.js +13 -10
  122. package/kits/hub-game/code/client/say.js +2 -0
  123. package/kits/hub-game/code/client/soundSurface.js +77 -0
  124. package/kits/hub-game/code/client/soundTree.js +74 -0
  125. package/kits/hub-game/code/client/soundscape.js +12 -9
  126. package/kits/hub-game/code/client/soundscapeCues.js +1 -1
  127. package/kits/hub-game/code/client/state.js +67 -1
  128. package/kits/hub-game/code/client/stuckSurface.js +76 -0
  129. package/kits/hub-game/code/client/stuckTree.js +67 -0
  130. package/kits/hub-game/code/client/talk.js +42 -12
  131. package/kits/hub-game/code/client/talkTree.js +4 -2
  132. package/kits/hub-game/code/client/textAskSurface.js +147 -0
  133. package/kits/hub-game/code/client/textAskTree.js +67 -0
  134. package/kits/hub-game/code/client/tiers.js +252 -27
  135. package/kits/hub-game/code/client/together.js +4 -1
  136. package/kits/hub-game/code/client/uiDom.js +86 -8
  137. package/kits/hub-game/code/client/uiTree.js +33 -4
  138. package/kits/hub-game/code/client/vehicle.js +75 -52
  139. package/kits/hub-game/code/client/weakestTier.js +75 -31
  140. package/kits/hub-game/code/client/wear.js +159 -5
  141. package/kits/hub-game/code/client/worldLabels.js +215 -26
  142. package/kits/hub-game/code/companionSpec.js +4 -2
  143. package/kits/hub-game/code/server/act.js +3 -0
  144. package/kits/hub-game/code/server/actGate.js +83 -0
  145. package/kits/hub-game/code/server/actions.js +71 -15
  146. package/kits/hub-game/code/server/actors.js +20 -5
  147. package/kits/hub-game/code/server/analytics.js +40 -15
  148. package/kits/hub-game/code/server/ask.js +39 -3
  149. package/kits/hub-game/code/server/ballot.js +167 -4
  150. package/kits/hub-game/code/server/celebrate.js +64 -0
  151. package/kits/hub-game/code/server/companion.js +17 -2
  152. package/kits/hub-game/code/server/decor.js +11 -2
  153. package/kits/hub-game/code/server/disguise.js +63 -0
  154. package/kits/hub-game/code/server/doorAnalytics.js +2 -5
  155. package/kits/hub-game/code/server/earned.js +6 -2
  156. package/kits/hub-game/code/server/friendBests.js +13 -4
  157. package/kits/hub-game/code/server/friendsAmong.js +67 -8
  158. package/kits/hub-game/code/server/grab.js +12 -2
  159. package/kits/hub-game/code/server/heldOffers.js +142 -0
  160. package/kits/hub-game/code/server/holdShow.js +98 -0
  161. package/kits/hub-game/code/server/hub.js +854 -45
  162. package/kits/hub-game/code/server/idle.js +110 -9
  163. package/kits/hub-game/code/server/index.js +9 -0
  164. package/kits/hub-game/code/server/labels.js +13 -3
  165. package/kits/hub-game/code/server/loadAbandon.js +2 -5
  166. package/kits/hub-game/code/server/manifest.js +94 -6
  167. package/kits/hub-game/code/server/menu.js +26 -3
  168. package/kits/hub-game/code/server/npcs.js +55 -9
  169. package/kits/hub-game/code/server/observe.js +67 -6
  170. package/kits/hub-game/code/server/players.js +8 -1
  171. package/kits/hub-game/code/server/replay.js +135 -0
  172. package/kits/hub-game/code/server/storageLimit.js +4 -1
  173. package/kits/hub-game/code/server/townDay.js +74 -0
  174. package/kits/hub-game/code/server/trackQueue.js +29 -0
  175. package/kits/hub-game/code/server/vehicle.js +3 -0
  176. package/kits/hub-game/code/server/vis.js +26 -4
  177. package/kits/hub-game/code/server/wallet.js +677 -0
  178. package/kits/hub-game/code/server/wear.js +13 -3
  179. package/kits/hub-game/code/server/writerLease.js +191 -0
  180. package/kits/hub-game/code/shared/act.js +1 -1
  181. package/kits/hub-game/code/shared/expression.js +6 -0
  182. package/kits/hub-game/code/shared/replay.js +37 -0
  183. package/kits/hub-game/code/systems/hub.js +437 -57
  184. package/kits/hub-game/docs/analytics.md +20 -3
  185. package/kits/hub-game/docs/contract.md +942 -99
  186. package/kits/hub-game/docs/home-pieces.md +5 -6
  187. package/kits/hub-game/docs/observed-progress.md +49 -1
  188. package/kits/hub-game/docs/vehicle-preset.md +23 -0
  189. package/kits/hub-game/index.html +1 -0
  190. package/kits/hub-game/models/hats/baker-cap.pxmodel +3 -3
  191. package/kits/hub-game/models/hats/bat-clip.pxmodel +3 -3
  192. package/kits/hub-game/models/hats/beekeeper.pxmodel +3 -3
  193. package/kits/hub-game/models/hats/cap.pxmodel +3 -3
  194. package/kits/hub-game/models/hats/captain.pxmodel +3 -3
  195. package/kits/hub-game/models/hats/chef-toque.pxmodel +3 -3
  196. package/kits/hub-game/models/hats/crooked-top.pxmodel +3 -3
  197. package/kits/hub-game/models/hats/delivery-cap.pxmodel +3 -3
  198. package/kits/hub-game/models/hats/fire-helmet.pxmodel +3 -3
  199. package/kits/hub-game/models/hats/flower-crown.pxmodel +3 -3
  200. package/kits/hub-game/models/hats/foam-crown.pxmodel +3 -3
  201. package/kits/hub-game/models/hats/hard-hat.pxmodel +3 -3
  202. package/kits/hub-game/models/hats/lantern.pxmodel +3 -3
  203. package/kits/hub-game/models/hats/laurel.pxmodel +3 -3
  204. package/kits/hub-game/models/hats/lighthouse.pxmodel +3 -3
  205. package/kits/hub-game/models/hats/nurse-cap.pxmodel +3 -3
  206. package/kits/hub-game/models/hats/police-cap.pxmodel +3 -3
  207. package/kits/hub-game/models/hats/sailor.pxmodel +3 -3
  208. package/kits/hub-game/models/hats/souwester.pxmodel +3 -3
  209. package/kits/hub-game/models/hats/straw.pxmodel +3 -3
  210. package/kits/hub-game/models/hats/sunflower.pxmodel +3 -3
  211. package/kits/hub-game/models/hats/sweatband.pxmodel +3 -3
  212. package/kits/hub-game/models/hats/teacher-beret.pxmodel +3 -3
  213. package/kits/hub-game/models/hats/witch.pxmodel +3 -3
  214. package/kits/hub-game/models/hold-show/daisy.pxmodel +231 -0
  215. package/kits/hub-game/models/hold-show/moonflower.pxmodel +171 -0
  216. package/kits/hub-game/models/hold-show/rose.pxmodel +191 -0
  217. package/kits/hub-game/models/hold-show/square/daisy.pxmodel +233 -0
  218. package/kits/hub-game/models/hold-show/square/moonflower.pxmodel +173 -0
  219. package/kits/hub-game/models/hold-show/square/rose.pxmodel +193 -0
  220. package/kits/hub-game/models/hold-show/square/sunflower.pxmodel +313 -0
  221. package/kits/hub-game/models/hold-show/square/tulip.pxmodel +133 -0
  222. package/kits/hub-game/models/hold-show/sunflower.pxmodel +311 -0
  223. package/kits/hub-game/models/hold-show/tulip.pxmodel +131 -0
  224. package/kits/hub-game/package-lock.json +3 -3
  225. package/kits/hub-game/package.json +4 -3
  226. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +1 -0
  227. package/kits/hub-game/scripts/fixtures/hud-surface.json +12 -12
  228. package/kits/hub-game/scripts/fixtures/talk-surface.json +8 -8
  229. package/kits/hub-game/scripts/gen-hats.mjs +1 -1
  230. package/kits/hub-game/scripts/gen-hold-show.mjs +27 -0
  231. package/kits/hub-game/scripts/pack.mjs +89 -23
  232. package/kits/hub-game/scripts/test-act-client.mjs +5 -0
  233. package/kits/hub-game/scripts/test-act-core.mjs +32 -0
  234. package/kits/hub-game/scripts/test-act-gate.mjs +186 -0
  235. package/kits/hub-game/scripts/test-action-rail-crowded-dom.mjs +7 -1
  236. package/kits/hub-game/scripts/test-action-rail-default-dom.mjs +102 -0
  237. package/kits/hub-game/scripts/test-action-rail-never-silent-dom.mjs +50 -0
  238. package/kits/hub-game/scripts/test-action-rail-surface.mjs +368 -0
  239. package/kits/hub-game/scripts/test-action-rail-town-jobs-dom.mjs +118 -0
  240. package/kits/hub-game/scripts/test-actions-client.mjs +5 -3
  241. package/kits/hub-game/scripts/test-actions.mjs +24 -0
  242. package/kits/hub-game/scripts/test-actors.mjs +19 -0
  243. package/kits/hub-game/scripts/test-again-corner-dom.mjs +59 -0
  244. package/kits/hub-game/scripts/test-analytics.mjs +80 -1
  245. package/kits/hub-game/scripts/test-arrival-pose-server.mjs +25 -8
  246. package/kits/hub-game/scripts/test-ask-client.mjs +9 -0
  247. package/kits/hub-game/scripts/test-ask-surface.mjs +188 -0
  248. package/kits/hub-game/scripts/test-attention.mjs +43 -1
  249. package/kits/hub-game/scripts/test-ballot-sheet-dom.mjs +71 -0
  250. package/kits/hub-game/scripts/test-ballot-surface.mjs +276 -0
  251. package/kits/hub-game/scripts/test-ballot.mjs +420 -3
  252. package/kits/hub-game/scripts/test-ban-join.mjs +1 -1
  253. package/kits/hub-game/scripts/test-celebrate-client.mjs +62 -0
  254. package/kits/hub-game/scripts/test-celebrate.mjs +116 -0
  255. package/kits/hub-game/scripts/test-chat.mjs +73 -0
  256. package/kits/hub-game/scripts/test-companion-client.mjs +203 -21
  257. package/kits/hub-game/scripts/test-companion.mjs +110 -3
  258. package/kits/hub-game/scripts/test-control-layout-dom.mjs +57 -10
  259. package/kits/hub-game/scripts/test-corner-surface.mjs +268 -0
  260. package/kits/hub-game/scripts/test-decor-client.mjs +59 -3
  261. package/kits/hub-game/scripts/test-decor.mjs +27 -0
  262. package/kits/hub-game/scripts/test-device-class.mjs +4 -1
  263. package/kits/hub-game/scripts/test-disguise-client.mjs +281 -0
  264. package/kits/hub-game/scripts/test-disguise.mjs +176 -0
  265. package/kits/hub-game/scripts/test-dock-surface.mjs +404 -0
  266. package/kits/hub-game/scripts/test-door-analytics.mjs +1 -1
  267. package/kits/hub-game/scripts/test-door-stay-client.mjs +602 -0
  268. package/kits/hub-game/scripts/test-door-stay.mjs +613 -0
  269. package/kits/hub-game/scripts/test-earned-client.mjs +119 -0
  270. package/kits/hub-game/scripts/test-emote-surface.mjs +616 -0
  271. package/kits/hub-game/scripts/test-fps-telemetry.mjs +39 -4
  272. package/kits/hub-game/scripts/test-friend-bests.mjs +38 -12
  273. package/kits/hub-game/scripts/test-ghost-click-dom.mjs +75 -0
  274. package/kits/hub-game/scripts/test-grab-client.mjs +29 -2
  275. package/kits/hub-game/scripts/test-grab-orbit.mjs +260 -11
  276. package/kits/hub-game/scripts/test-grab.mjs +10 -1
  277. package/kits/hub-game/scripts/test-hats.mjs +28 -0
  278. package/kits/hub-game/scripts/test-held-offers.mjs +394 -0
  279. package/kits/hub-game/scripts/test-high-only.mjs +3 -3
  280. package/kits/hub-game/scripts/test-hold-show-client.mjs +175 -0
  281. package/kits/hub-game/scripts/test-hold-show.mjs +355 -0
  282. package/kits/hub-game/scripts/test-hub-controls.mjs +3 -1
  283. package/kits/hub-game/scripts/test-hub-idle.mjs +348 -0
  284. package/kits/hub-game/scripts/test-hub-leaving.mjs +21 -0
  285. package/kits/hub-game/scripts/test-hub-ops.mjs +147 -0
  286. package/kits/hub-game/scripts/test-hub-trip.mjs +260 -5
  287. package/kits/hub-game/scripts/test-hud-clear.mjs +83 -0
  288. package/kits/hub-game/scripts/test-hud-rate.mjs +2 -1
  289. package/kits/hub-game/scripts/test-idle.mjs +160 -0
  290. package/kits/hub-game/scripts/test-invites-client.mjs +53 -0
  291. package/kits/hub-game/scripts/test-labels.mjs +11 -0
  292. package/kits/hub-game/scripts/test-landscape-layout.mjs +20 -0
  293. package/kits/hub-game/scripts/test-load-abandon.mjs +2 -2
  294. package/kits/hub-game/scripts/test-loading-cover.mjs +67 -1
  295. package/kits/hub-game/scripts/test-manifest.mjs +27 -0
  296. package/kits/hub-game/scripts/test-menu-client.mjs +55 -6
  297. package/kits/hub-game/scripts/test-menu-surface.mjs +236 -0
  298. package/kits/hub-game/scripts/test-npcs.mjs +128 -0
  299. package/kits/hub-game/scripts/test-observed.mjs +171 -3
  300. package/kits/hub-game/scripts/test-pack.mjs +166 -0
  301. package/kits/hub-game/scripts/test-picker-surface.mjs +321 -0
  302. package/kits/hub-game/scripts/test-placeat-server.mjs +395 -0
  303. package/kits/hub-game/scripts/test-placement-cache.mjs +1 -1
  304. package/kits/hub-game/scripts/test-pointer-clear-dom.mjs +82 -0
  305. package/kits/hub-game/scripts/test-progress-reset.mjs +184 -6
  306. package/kits/hub-game/scripts/test-push-visit.mjs +9 -0
  307. package/kits/hub-game/scripts/test-quality.mjs +312 -9
  308. package/kits/hub-game/scripts/test-quick-chat-surface.mjs +511 -0
  309. package/kits/hub-game/scripts/test-rehello.mjs +237 -0
  310. package/kits/hub-game/scripts/test-rejoin-yaw.mjs +138 -0
  311. package/kits/hub-game/scripts/test-relations-among.mjs +13 -7
  312. package/kits/hub-game/scripts/test-relations-refresh.mjs +90 -2
  313. package/kits/hub-game/scripts/test-replay-client.mjs +110 -0
  314. package/kits/hub-game/scripts/test-replay.mjs +178 -0
  315. package/kits/hub-game/scripts/test-resume-held.mjs +13 -0
  316. package/kits/hub-game/scripts/test-resume-pose-server.mjs +43 -5
  317. package/kits/hub-game/scripts/test-resync.mjs +13 -0
  318. package/kits/hub-game/scripts/test-role-client.mjs +10 -3
  319. package/kits/hub-game/scripts/test-safe-act.mjs +233 -0
  320. package/kits/hub-game/scripts/test-safe-caption.mjs +364 -0
  321. package/kits/hub-game/scripts/test-safe-layout.mjs +79 -0
  322. package/kits/hub-game/scripts/test-safe-prompt.mjs +163 -0
  323. package/kits/hub-game/scripts/test-sound-surface.mjs +256 -0
  324. package/kits/hub-game/scripts/test-soundscape.mjs +85 -2
  325. package/kits/hub-game/scripts/test-stuck-surface.mjs +174 -0
  326. package/kits/hub-game/scripts/test-stuck.mjs +31 -0
  327. package/kits/hub-game/scripts/test-talk-surface.mjs +23 -6
  328. package/kits/hub-game/scripts/test-talk-walk-dom.mjs +123 -0
  329. package/kits/hub-game/scripts/test-text-ask-surface.mjs +273 -0
  330. package/kits/hub-game/scripts/test-tiers.mjs +453 -3
  331. package/kits/hub-game/scripts/test-toast-no-row-dom.mjs +71 -0
  332. package/kits/hub-game/scripts/test-together.mjs +11 -0
  333. package/kits/hub-game/scripts/test-town-day.mjs +90 -0
  334. package/kits/hub-game/scripts/test-track-queue.mjs +64 -0
  335. package/kits/hub-game/scripts/test-try-on.mjs +39 -0
  336. package/kits/hub-game/scripts/test-ui-dom-dom.mjs +49 -2
  337. package/kits/hub-game/scripts/test-ui-tree.mjs +28 -0
  338. package/kits/hub-game/scripts/test-vehicle-client.mjs +77 -1
  339. package/kits/hub-game/scripts/test-vis.mjs +145 -0
  340. package/kits/hub-game/scripts/test-wallet.mjs +650 -0
  341. package/kits/hub-game/scripts/test-weakest-tier.mjs +135 -1
  342. package/kits/hub-game/scripts/test-world-labels.mjs +380 -0
  343. package/kits/hub-game/scripts/test-writer-lease-server.mjs +234 -0
  344. package/kits/hub-game/scripts/test-writer-lease.mjs +281 -0
  345. package/kits/hub-game/scripts/writer-storage-fixture.mjs +37 -0
  346. package/kits/hub-game/tools/hubScene/export.mjs +6 -5
  347. package/kits/hub-game/tools/hubScene/hubdata.mjs +10 -0
  348. package/kits/hub-game/tools/hubScene/test/export-fixture.mjs +48 -2
  349. package/kits/hub-game/tools/hubScene/validate-manifest.mjs +21 -3
  350. package/kits/multiplayer-3d/castle.json +5 -5
  351. package/kits/multiplayer-3d/code/client/resumeGate.js +49 -2
  352. package/kits/multiplayer-3d/code/server/ownership.js +25 -6
  353. package/kits/multiplayer-3d/code/server/world.js +19 -4
  354. package/kits/multiplayer-3d/code/systems/multiplayer.js +67 -11
  355. package/kits/multiplayer-3d/package-lock.json +1 -1
  356. package/kits/multiplayer-3d/package.json +2 -1
  357. package/kits/multiplayer-3d/scripts/test-ground-half.mjs +56 -0
  358. package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +54 -3
  359. package/kits/multiplayer-3d/scripts/test-owned-moves.mjs +190 -0
  360. package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +191 -5
  361. package/kits/multiplayer-3d/scripts/test-resync-reconnect.mjs +68 -0
  362. package/kits/physics-2d/castle.json +2 -2
  363. package/kits/physics-2d/engine/scene.js +10 -2
  364. package/kits/physics-3d/CLAUDE.md +14 -0
  365. package/kits/physics-3d/behaviors/Player.jsx +39 -3
  366. package/kits/physics-3d/castle.json +3 -3
  367. package/kits/physics-3d/docs/engine-model-cache.md +109 -0
  368. package/kits/physics-3d/docs/engine-player.md +76 -0
  369. package/kits/physics-3d/docs/engine-skip-work.md +16 -0
  370. package/kits/physics-3d/docs/pxmodel-format.md +5 -1
  371. package/kits/physics-3d/engine3d/gait.js +16 -8
  372. package/kits/physics-3d/engine3d/groundsize.js +23 -0
  373. package/kits/physics-3d/engine3d/kithooks.js +50 -0
  374. package/kits/physics-3d/engine3d/look.js +110 -17
  375. package/kits/physics-3d/engine3d/lookbake.js +19 -1
  376. package/kits/physics-3d/engine3d/materialpresets.js +3 -2
  377. package/kits/physics-3d/engine3d/modelcache.js +280 -0
  378. package/kits/physics-3d/engine3d/modelcachedigest.js +37 -0
  379. package/kits/physics-3d/engine3d/modelcachegate.js +69 -0
  380. package/kits/physics-3d/engine3d/modelrefs.js +13 -0
  381. package/kits/physics-3d/engine3d/optimize.js +20 -9
  382. package/kits/physics-3d/engine3d/playerRun.js +26 -1
  383. package/kits/physics-3d/engine3d/pxmodel.js +7 -3
  384. package/kits/physics-3d/engine3d/templatecache.js +722 -0
  385. package/kits/physics-3d/engine3d/world3d.js +211 -17
  386. package/kits/physics-3d/package-lock.json +1 -1
  387. package/kits/physics-3d/package.json +2 -1
  388. package/kits/physics-3d/play/behaviors/Player.js +43 -3
  389. package/kits/physics-3d/scripts/render.mjs +56 -8
  390. package/kits/physics-3d/scripts/template-cache-fixtures.mjs +37 -0
  391. package/kits/physics-3d/scripts/template-cache-v1-bytes.json +49 -0
  392. package/kits/physics-3d/scripts/test-gait.mjs +53 -9
  393. package/kits/physics-3d/scripts/test-ground-half.mjs +120 -0
  394. package/kits/physics-3d/scripts/test-model-cache.mjs +600 -0
  395. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +1 -0
  396. package/kits/physics-3d/scripts/test-sleeping-models.mjs +384 -0
  397. package/kits/physics-3d/scripts/test-template-cache-minified.mjs +106 -0
  398. package/kits/physics-3d/scripts/test-template-cache.mjs +519 -0
  399. package/kits/physics-3d/scripts/test-wall-slide.mjs +272 -0
  400. package/kits/physics-3d/systems/physics3d.js +51 -2
  401. package/kits/real-time/castle.json +2 -2
  402. package/kits/real-time/code/client/connection.js +3 -0
  403. package/package.json +2 -2
  404. package/vendor/three/examples/jsm/libs/fflate.module.js +2672 -0
@@ -0,0 +1,321 @@
1
+ // The avatar picker surface (`code/client/pickerSurface.js`) and its tree
2
+ // (`pickerTree.js`): the Character button and its sheet as the `picker` UI
3
+ // tree root, with no DOM, for a native host. Checks that the trees validate,
4
+ // portrait and landscape, lane sheet and strip; that bytes and binding ids do
5
+ // not move across rebuilds with fresh closures; that the tiles, names,
6
+ // labels, the worn ring, the colours and the strip's width are what
7
+ // chrome.js draws (run over a stand-in DOM); that the strip is chosen where
8
+ // fitPicker chooses it; and that every tap reaches the right action.
9
+ import assert from 'node:assert/strict';
10
+ import { execFileSync } from 'node:child_process';
11
+ import { register } from 'node:module';
12
+ register(`data:text/javascript,${encodeURIComponent(`
13
+ export async function resolve(specifier, context, next) {
14
+ if (specifier === 'castle-web-sdk') return { url: ${JSON.stringify(new URL('./fixtures/sdk-stub.mjs', import.meta.url).href)}, shortCircuit: true };
15
+ return next(specifier, context);
16
+ }
17
+ `)}`);
18
+ const { dispatchUiEvent, resetUiTrees, serialize, setUiTreeSink, validate } = await import('../code/client/uiTree.js');
19
+ const { buildPicker, pickerBodyHeight, pickerCompact, pickerSwatches, stripWidth } = await import('../code/client/pickerTree.js');
20
+ const { makeAvatarPickerSurface } = await import('../code/client/pickerSurface.js');
21
+ const { AVATAR_FACES } = await import('../code/client/avatarFaces.js');
22
+
23
+ let passed = 0;
24
+ const test = async (name, fn) => {
25
+ try {await fn();} catch (error) {error.message = `${name}: ${error.message}`; throw error;}
26
+ passed += 1;
27
+ };
28
+
29
+ const NO_INSETS = { top: 0, right: 0, bottom: 0, left: 0 };
30
+ const VIEWS = {
31
+ portrait: { landscape: false, safeInsets: false, w: 390, h: 844, lift: 0, insets: NO_INSETS },
32
+ landscape: { landscape: true, safeInsets: false, w: 844, h: 390, lift: 0, insets: NO_INSETS },
33
+ short: { landscape: true, safeInsets: false, w: 640, h: 290, lift: 0, insets: NO_INSETS },
34
+ };
35
+ const MODEL = 'models/avatar-2.pxmodel';
36
+ const COLORS = { available: true, style: 'toon', color: 3, files: { [MODEL]: JSON.stringify({ parts: [{ id: 'torso', color: '#123456' }] }) }, model: MODEL };
37
+ const SWATCHES = pickerSwatches(2, COLORS);
38
+ const noop = { toggle() {}, close() {}, avatar() {}, color() {}, invite() {} };
39
+ const base = (view, extra = {}) => ({ view, show: true, open: true, compact: false, selected: 2, avatars: 16, swatches: SWATCHES, invite: true, place: { toggle: null }, ...extra });
40
+ function find(tree, k) {
41
+ if (!tree) {return null;}
42
+ if (tree.k === k) {return tree;}
43
+ for (const child of tree.c ?? []) {
44
+ const hit = find(child, k);
45
+ if (hit) {return hit;}
46
+ }
47
+ return null;
48
+ }
49
+ const words = (node) => node?.text ?? node?.c?.find((child) => child.t === 'text' && !child.k)?.text;
50
+
51
+ await test('trees validate: shut, the lane sheet and the strip, portrait and landscape', () => {
52
+ for (const view of [...Object.values(VIEWS), { ...VIEWS.portrait, safeInsets: true, lift: 48 }]) {
53
+ for (const extra of [{ show: false }, { open: false }, {}, { compact: true }, { swatches: null }, { invite: false, compact: true }, { avatars: 3, selected: null }, { avatars: 20 }, { place: { toggle: { x: 700, y: 300, w: 110, h: 38 } } }]) {
54
+ assert.deepEqual(validate(buildPicker(base(view, extra), noop), 'picker'), [], JSON.stringify(extra));
55
+ assert.deepEqual(validate(buildPicker(base(view, extra)), 'picker'), []);
56
+ }
57
+ }
58
+ });
59
+
60
+ await test('bytes and binding ids do not move across rebuilds with fresh closures', () => {
61
+ const fresh = (n) => ({ toggle: () => n, close: () => n, avatar: () => n, color: () => n, invite: () => n });
62
+ for (const view of Object.values(VIEWS)) {
63
+ for (const compact of [false, true]) {
64
+ const one = serialize(buildPicker(base(view, { compact }), fresh(1)), 'picker');
65
+ const two = serialize(buildPicker(structuredClone(base(view, { compact })), fresh(2)), 'picker');
66
+ assert.equal(one.json, two.json);
67
+ assert.deepEqual([...one.handlers.keys()], [...two.handlers.keys()]);
68
+ }
69
+ }
70
+ const ids = [...serialize(buildPicker(base(VIEWS.portrait, { avatars: 2 }), noop), 'picker').handlers.keys()];
71
+ assert.deepEqual(ids, [
72
+ 'picker#cancel', 'picker/card/body/invite#tap', 'picker/card/body/tiles/a:0#tap', 'picker/card/body/tiles/a:1#tap',
73
+ ...[0, 1, 2, 3, 4, 5].map((c) => `picker/card/body/colors/c:${c}#tap`), 'picker/toggle#tap',
74
+ ]);
75
+ const strip = [...serialize(buildPicker(base(VIEWS.short, { avatars: 2, compact: true }), noop), 'picker').handlers.keys()];
76
+ assert.deepEqual(strip.slice(0, 5), ['picker#cancel', 'picker/card/head/invite#tap', 'picker/card/head/close#tap', 'picker/card/tiles/a:0#tap', 'picker/card/tiles/a:1#tap']);
77
+ // Shut: the button alone, no cancel.
78
+ assert.deepEqual([...serialize(buildPicker(base(VIEWS.portrait, { open: false }), noop), 'picker').handlers.keys()], ['picker/toggle#tap']);
79
+ });
80
+
81
+ // chrome.js over a stand-in DOM (scripts/test-picker.mjs's).
82
+ function fakeDom(view) {
83
+ const made = [];
84
+ function node(tag) {
85
+ const listeners = {};
86
+ const self = {
87
+ tag, children: [], parent: null, dataset: {}, attrs: {}, textContent: '', innerHTML: '',
88
+ appendChild(child) {child.parent = self; self.children.push(child); return child;},
89
+ insertBefore(child, before) {
90
+ child.parent = self;
91
+ const prior = self.children.indexOf(child);
92
+ if (prior >= 0) {self.children.splice(prior, 1);}
93
+ const at = self.children.indexOf(before);
94
+ self.children.splice(at < 0 ? self.children.length : at, 0, child);
95
+ return child;
96
+ },
97
+ remove() {}, replaceChildren() {self.children = [];},
98
+ addEventListener: (type, fn) => (listeners[type] = fn), removeEventListener() {},
99
+ setAttribute: (key, value) => (self.attrs[key] = String(value)), getAttribute: (key) => self.attrs[key] ?? null,
100
+ fire: (type) => listeners[type]?.({ stopPropagation() {}, preventDefault() {} }),
101
+ focus() {}, blur() {}, getBoundingClientRect: () => ({ left: 0, right: 0, top: 0, bottom: 0, width: 0, height: 0 }),
102
+ offsetWidth: 100, offsetHeight: 40, offsetLeft: 0, offsetTop: 0, scrollHeight: 0, clientHeight: 0,
103
+ };
104
+ self.style = new Proxy({}, { set(target, key, value) {target[key] = String(value); return true;} });
105
+ made.push(self);
106
+ return self;
107
+ }
108
+ globalThis.document = { body: node('body'), createElement: node, activeElement: null };
109
+ globalThis.window = { innerWidth: view.w, innerHeight: view.h };
110
+ globalThis.innerWidth = view.w;
111
+ globalThis.innerHeight = view.h;
112
+ return { made };
113
+ }
114
+ const { makeChrome } = await import('../code/client/chrome.js');
115
+
116
+ await test('the tiles, names, labels, worn ring and colours are what chrome.js draws', () => {
117
+ const dom = fakeDom({ w: 390, h: 844 });
118
+ const chrome = makeChrome({ onBack() {}, onAvatar() {}, avatarCount: 16 });
119
+ chrome.showPicker(true, 2, COLORS, { onPick() {} });
120
+ const cells = dom.made.filter((n) => n.attrs['aria-label']?.startsWith('Character'));
121
+ const tree = buildPicker(base(VIEWS.portrait), noop);
122
+ const tiles = find(tree, 'tiles').c;
123
+ assert.equal(tiles.length, 16);
124
+ assert.deepEqual(tiles.map((t) => t.label), cells.map((c) => c.attrs['aria-label']));
125
+ assert.deepEqual(tiles.map((t) => String(t.pressed)), cells.map((c) => c.attrs['aria-pressed']));
126
+ assert.deepEqual(tiles.map((t) => t.s.border.c), cells.map((c) => c.style.borderColor));
127
+ assert.deepEqual(tiles.map((t) => t.s.bg), cells.map((c) => c.style.background));
128
+ assert.deepEqual(tiles.map((t) => find(t, 'name').text), AVATAR_FACES.map(([name]) => name));
129
+ assert.deepEqual(tiles.map((t) => find(t, 'face').name), AVATAR_FACES.map((_, i) => `avatar-face-${i}`));
130
+ const dots = dom.made.filter((n) => n.attrs['aria-label']?.startsWith('Colour:'));
131
+ const swatches = find(tree, 'colors').c;
132
+ assert.deepEqual(swatches.map((s) => s.label), dots.map((d) => d.attrs['aria-label']));
133
+ assert.deepEqual(swatches.map((s) => s.s.bg), dots.map((d) => d.style.background));
134
+ assert.deepEqual(swatches.map((s) => s.s.border.c), dots.map((d) => d.style.borderColor));
135
+ assert.deepEqual(swatches.map((s) => String(s.pressed)), dots.map((d) => d.attrs['aria-pressed']));
136
+ assert.equal(SWATCHES.worn, 3);
137
+ // The lane sheet's order: handle, Invite, heading, tiles, colours.
138
+ assert.deepEqual(find(tree, 'body').c.map((c) => c.k), ['handle', 'invite', 'heading', 'tiles', 'colors']);
139
+ assert.equal(words(find(tree, 'invite')), 'Invite a friend');
140
+ assert.equal(find(tree, 'heading').text, 'Your character');
141
+ assert.deepEqual(find(tree, 'tiles').cols, { n: 4, px: 64 });
142
+ const card = find(tree, 'card');
143
+ assert.deepEqual(card.at, { anchor: 'bottomRight', right: 10, bottom: [64, 64] });
144
+ assert.deepEqual(card.s.maxW, [{ vw: 100, px: -20 }]);
145
+ assert.deepEqual(card.s.maxH, [{ dvh: 100, px: -80, safe: 'tb' }]);
146
+ assert.deepEqual(find(tree, 'toggle').at, { anchor: 'bottomRight', right: 10, bottom: [10, 0] });
147
+ // A character without a face is its number; no palette, no files: no colours.
148
+ assert.equal(find(buildPicker(base(VIEWS.portrait, { avatars: 18 }), noop), 'a:17').label, 'Character 18');
149
+ assert.equal(find(find(buildPicker(base(VIEWS.portrait, { avatars: 18 }), noop), 'a:17'), 'name').text, '18');
150
+ for (const colors of [{ ...COLORS, files: null }, { ...COLORS, available: false }, { ...COLORS, style: 'bean' }]) {assert.equal(pickerSwatches(2, colors), null);}
151
+ assert.equal(pickerSwatches(99, COLORS), null);
152
+ chrome.dispose();
153
+ });
154
+
155
+ await test('the strip: chosen where fitPicker chooses it, its width, Close beside Invite, the button out of sight', () => {
156
+ // Under 300 px tall on its side: always the strip; upright never.
157
+ assert.equal(pickerCompact(VIEWS.short, false, 0), true);
158
+ assert.equal(pickerCompact(VIEWS.portrait, true, 5000), false);
159
+ // On its side, open: the strip where the lane sheet would scroll.
160
+ const body = pickerBodyHeight({ avatars: 16, swatches: SWATCHES, invite: true });
161
+ assert.equal(body, 12 + 44 + 15.6 + (4 * 62 + 3 * 6) + 44 + 4 * 6);
162
+ assert.equal(pickerCompact(VIEWS.landscape, true, body), true, '844 x 390 cannot hold 16 tiles in the lane');
163
+ assert.equal(pickerCompact({ ...VIEWS.landscape, h: 600 }, true, body), false);
164
+ assert.equal(pickerCompact(VIEWS.landscape, false, body), false, 'shut, only the height decides');
165
+ // The width: whole tiles across the view less 26.
166
+ assert.deepEqual([stripWidth(640), stripWidth(844), stripWidth(90)], [8 * 70 - 6, 11 * 70 - 6, 64]);
167
+ const tree = buildPicker(base(VIEWS.short, { compact: true }), noop);
168
+ const card = find(tree, 'card');
169
+ assert.deepEqual(card.at, { anchor: 'bottom', bottom: [12, 0] });
170
+ assert.equal(card.s.w, stripWidth(640) + 8);
171
+ assert.deepEqual(card.s.maxH, [{ dvh: 100, px: -24, safe: 'tb' }]);
172
+ assert.deepEqual(find(card, 'head').c.map((c) => c.k), ['invite', 'close']);
173
+ assert.equal(find(card, 'close').label, 'Close character sheet');
174
+ assert.deepEqual([find(card, 'tiles').t, find(card, 'tiles').axis, find(card, 'tiles').s.w], ['scroll', 'x', stripWidth(640)]);
175
+ assert.equal(find(tree, 'toggle').s.hidden, true);
176
+ assert.equal(find(tree, 'heading'), null);
177
+ // Without Invite, Close still keeps the right-hand side.
178
+ assert.deepEqual(find(buildPicker(base(VIEWS.short, { compact: true, invite: false }), noop), 'head').c.map((c) => [c.k, c.t]), [['invite', 'spacer'], ['close', 'button']]);
179
+ // chrome.js chooses the strip at 640 x 290 too.
180
+ const dom = fakeDom({ w: 640, h: 290 });
181
+ const chrome = makeChrome({ onBack() {}, onAvatar() {}, avatarCount: 16 });
182
+ chrome.showPicker(true, 2);
183
+ dom.made.find((n) => n.tag === 'button' && n.textContent === 'Character').fire('pointerdown');
184
+ const domCard = dom.made.find((n) => n.style.gridTemplateColumns === '1fr auto');
185
+ assert(domCard, 'the DOM drew its strip');
186
+ assert.equal(domCard.style.width, `${stripWidth(640) + 8}px`);
187
+ chrome.dispose();
188
+ });
189
+
190
+ await test('events: the button, a character, a colour, Invite, Close and Back; the button going away', () => {
191
+ resetUiTrees();
192
+ const roots = [];
193
+ setUiTreeSink((name, wire) => roots.push({ name, wire }), { dom: false });
194
+ const calls = [];
195
+ let view = VIEWS.portrait;
196
+ const surface = makeAvatarPickerSurface({
197
+ view: () => view, avatars: 16,
198
+ onAvatar: (i) => calls.push(['avatar', i]), onColor: (c) => calls.push(['color', c]), onOpen: (open) => calls.push(['open', open]),
199
+ });
200
+ const wire = () => roots.filter((r) => r.name === 'picker').at(-1)?.wire ?? null;
201
+ const tap = (id) => dispatchUiEvent('picker', id, {});
202
+ assert.equal(wire().c, undefined, 'nothing until offered');
203
+ surface.set(true, 2, COLORS, { onPick: () => calls.push(['invite']) });
204
+ assert.equal(words(find(wire(), 'toggle')), 'Character');
205
+ tap('picker/toggle#tap');
206
+ assert.equal(surface.isOpen(), true);
207
+ tap('picker/card/body/colors/c:4#tap');
208
+ assert.equal(surface.isOpen(), true, 'a colour leaves the sheet open');
209
+ tap('picker/card/body/tiles/a:5#tap');
210
+ assert.equal(surface.isOpen(), false, 'a character shuts it');
211
+ tap('picker/toggle#tap');
212
+ tap('picker/card/body/invite#tap');
213
+ assert.equal(surface.isOpen(), false);
214
+ tap('picker/toggle#tap');
215
+ assert.equal(tap('picker#cancel'), true);
216
+ assert.equal(tap('picker#cancel'), false, 'a shut sheet binds no cancel');
217
+ tap('picker/toggle#tap');
218
+ tap('picker/toggle#tap');
219
+ // Asked every frame: nothing resent.
220
+ const posts = roots.length;
221
+ surface.set(true, 2, COLORS, { onPick: () => calls.push(['invite']) });
222
+ assert.equal(roots.length, posts);
223
+ // On its side with little room: the strip, its Close.
224
+ view = VIEWS.short;
225
+ surface.render();
226
+ tap('picker/toggle#tap');
227
+ assert.equal(surface.compact(), true);
228
+ assert.equal(find(wire(), 'toggle').s.hidden, true);
229
+ tap('picker/card/head/close#tap');
230
+ assert.equal(surface.isOpen(), false);
231
+ // A host's measurement decides the strip in a roomier landscape.
232
+ view = VIEWS.landscape;
233
+ surface.measure(200);
234
+ tap('picker/toggle#tap');
235
+ assert.equal(surface.compact(), false);
236
+ surface.measure(400);
237
+ assert.equal(surface.compact(), true);
238
+ // The button going away shuts the sheet.
239
+ surface.set(false, 2);
240
+ assert.equal(surface.isOpen(), false);
241
+ assert.equal(wire().c, undefined);
242
+ assert.deepEqual(calls, [
243
+ ['open', true], ['color', 4], ['open', false], ['avatar', 5],
244
+ ['open', true], ['open', false], ['invite'],
245
+ ['open', true], ['open', false],
246
+ ['open', true], ['open', false],
247
+ ['open', true], ['open', false],
248
+ ['open', true], ['open', false],
249
+ ]);
250
+ surface.dispose();
251
+ assert.equal(wire(), null);
252
+ resetUiTrees();
253
+ });
254
+
255
+ await test('a measurement holds only for the layout it was taken under: rotated, then Invite gone, the strip drops back to the sheet', () => {
256
+ resetUiTrees();
257
+ setUiTreeSink(() => {}, { dom: false });
258
+ let view = VIEWS.portrait;
259
+ const surface = makeAvatarPickerSurface({ view: () => view, avatars: 16 });
260
+ const invite = { onPick() {} };
261
+ surface.set(true, 2, COLORS, invite);
262
+ surface.measure(406);
263
+ assert.equal(surface.compact(), false, 'upright never takes the strip');
264
+ // Turned to 844 x 480: the lane holds 368 px; the measurement was taken
265
+ // upright, so the estimate (405.6 px with Invite) decides: the strip.
266
+ view = { ...VIEWS.landscape, h: 480 };
267
+ surface.render();
268
+ surface.set(true, 2, COLORS, invite);
269
+ surface.close();
270
+ surface.render();
271
+ assert.equal(pickerBodyHeight({ avatars: 16, swatches: SWATCHES, invite: true }) > 368, true);
272
+ dispatchUiEvent('picker', 'picker/toggle#tap', {});
273
+ assert.equal(surface.compact(), true);
274
+ // Invite goes: the content (355.6 px) fits the lane, and the strip, which
275
+ // has no body to report, drops back to the sheet.
276
+ surface.set(true, 2, COLORS, null);
277
+ assert.equal(pickerBodyHeight({ avatars: 16, swatches: SWATCHES, invite: false }) <= 368, true);
278
+ assert.equal(surface.compact(), false);
279
+ // A measurement taken now holds for this layout, and goes with the next
280
+ // change: colours gone.
281
+ surface.measure(380);
282
+ assert.equal(surface.compact(), true, 'measured over the room: the strip');
283
+ surface.set(true, 2, null, null);
284
+ assert.equal(surface.compact(), false, 'colours gone: the stale measurement no longer counts');
285
+ // The very layout it was taken under again (colours back): it is that
286
+ // layout's height, so it counts again.
287
+ surface.set(true, 2, COLORS, null);
288
+ assert.equal(surface.compact(), true);
289
+ // Every input invalidates it: the characters' count is fixed per surface;
290
+ // the view's insets and lift do.
291
+ surface.measure(380);
292
+ assert.equal(surface.compact(), true);
293
+ view = { ...view, insets: { ...NO_INSETS, bottom: 1 } };
294
+ surface.render();
295
+ assert.equal(surface.compact(), false);
296
+ surface.measure(380);
297
+ view = { ...view, lift: 4 };
298
+ surface.render();
299
+ assert.equal(surface.compact(), false);
300
+ surface.dispose();
301
+ resetUiTrees();
302
+ });
303
+
304
+ await test('the surface loads and runs in a process that never had a DOM', () => {
305
+ const probe = `
306
+ if (globalThis.document || globalThis.window) throw new Error('a DOM');
307
+ const { setUiTreeSink, dispatchUiEvent } = await import(${JSON.stringify(new URL('../code/client/uiTree.js', import.meta.url).href)});
308
+ const { makeAvatarPickerSurface } = await import(${JSON.stringify(new URL('../code/client/pickerSurface.js', import.meta.url).href)});
309
+ const seen = [];
310
+ setUiTreeSink((name, wire) => seen.push(name + ':' + (wire ? (wire.c ?? []).length : null)), { dom: false });
311
+ const surface = makeAvatarPickerSurface({ view: () => ({ w: 390, h: 844 }), avatars: 4, onAvatar: (i) => seen.push('a' + i) });
312
+ surface.set(true, 0, null, null);
313
+ dispatchUiEvent('picker', 'picker/toggle#tap', {});
314
+ dispatchUiEvent('picker', 'picker/card/body/tiles/a:3#tap', {});
315
+ surface.dispose();
316
+ console.log(seen.join(' '));
317
+ `;
318
+ assert.equal(execFileSync(process.execPath, ['--input-type=module', '-e', probe], { encoding: 'utf8' }).trim(), 'picker:0 picker:1 picker:2 picker:1 a3 picker:null');
319
+ });
320
+
321
+ console.log(`picker surface: ${passed} checks passed`);