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
@@ -19,12 +19,17 @@ try {
19
19
  assert(fileURLToPath(url).startsWith(fileURLToPath(root)));
20
20
  await route.fulfill({ contentType: 'text/javascript', body: await readFile(url, 'utf8') });
21
21
  });
22
- for (const [width, height] of [[844, 390], [667, 375], [932, 430], [914, 411], [1440, 900]]) {
22
+ // 219x290 is a game on castle.xyz in a short desktop window (Oct 26): the
23
+ // portrait corner's Quick chat and Emote stood on Sound there. Only the
24
+ // controls' own geometry is asserted at that size.
25
+ for (const [width, height] of [[844, 390], [667, 375], [932, 430], [914, 411], [1440, 900], [219, 290], [179, 250], [390, 400]]) {
23
26
  await page.setViewportSize({ width, height });
24
- for (const mode of ['legacy', 'overflow', 'safe', 'act']) for (const input of ['touch', 'keyboard']) {
27
+ const small = width < height;
28
+ for (const mode of small ? ['legacy', 'safe'] : ['legacy', 'overflow', 'safe', 'act']) for (const input of ['touch', 'keyboard']) {
29
+ const doors = true;
25
30
  await page.goto('http://layout.test/');
26
31
  await logRenderer(page, 'control layout');
27
- const result = await page.evaluate(async ({ mode, input, setup }) => {
32
+ const result = await page.evaluate(async ({ mode, input, setup, doors }) => {
28
33
  const { makeChrome } = await import('/kits/hub-game/code/client/chrome.js');
29
34
  const { overlaps } = await import('/kits/hub-game/code/client/safeLayout.js');
30
35
  const chrome = makeChrome({ avatarCount: 4, onBack() {}, onAvatar() {}, safeInsets: ['safe', 'act'].includes(mode) });
@@ -33,6 +38,10 @@ try {
33
38
  chrome.showPicker(true, 0);
34
39
  chrome.setEmotes([['wave', '👋']]); chrome.setSay({ reactions: [], phrases: [] });
35
40
  chrome.setHud({ title: 'Town', text: 'Your next step is here.' }, null);
41
+ // The Doors dock at the bottom left: a small view's rail and column
42
+ // wrap clear of it, and at 179x250, with no room beside it, it moves
43
+ // under the host's corner.
44
+ if (doors) {chrome.setDoors([{ id: 'cove', title: 'Cove' }]);}
36
45
  const { attachOrbitInput } = await import('/kits/physics-3d/engine3d/orbitinput.js');
37
46
  const canvas = document.createElement('canvas'); document.body.append(canvas);
38
47
  const runtime = { cameraControl: 'orbit', keys: new Set() };
@@ -74,7 +83,7 @@ try {
74
83
  const greeting = [...document.querySelectorAll('div')].find(node => node.textContent === "Hi, I'm Rowan!" && node.children.length === 0);
75
84
  const soundBox = document.querySelector('[data-hub="sound"]').getBoundingClientRect();
76
85
  const greetingHit = greeting && getComputedStyle(greeting).visibility !== 'hidden' && overlaps(greeting.getBoundingClientRect(), soundBox);
77
- const nodes = [...document.querySelectorAll('button')].filter(node => ['Character', 'Invite a friend'].includes(node.textContent) || /^(Emote|Quick chat|Shift lock|Sound:)/.test(node.getAttribute('aria-label') ?? '') || ['act', 'jump', 'prompt'].includes(node.dataset.hubAct));
86
+ const nodes = [...document.querySelectorAll('button')].filter(node => ['Character', 'Invite a friend', ...doors ? ['Doors'] : []].includes(node.textContent) || /^(Emote|Quick chat|Shift lock|Sound:)/.test(node.getAttribute('aria-label') ?? '') || ['act', 'jump', 'prompt'].includes(node.dataset.hubAct));
78
87
  const controls = nodes.filter(node => node.getBoundingClientRect().width > 0 && getComputedStyle(node).visibility !== 'hidden').map(node => ({ name: node.getAttribute('aria-label') || node.textContent, ...Object.fromEntries(['left','right','top','bottom','width','height'].map(key => [key, node.getBoundingClientRect()[key]])) }));
79
88
  const collisions = [];
80
89
  for (let i = 0; i < controls.length; i++) for (let j = i + 1; j < controls.length; j++) if (overlaps(controls[i], controls[j])) collisions.push([controls[i].name, controls[j].name]);
@@ -90,29 +99,67 @@ try {
90
99
  sound.dispatchEvent(new PointerEvent('pointerdown'));
91
100
  draw();
92
101
  chrome.flushSafeInsets?.();
102
+ // Further passes with the card open move no control: a dock it hides
103
+ // stays where it was (raised or not).
104
+ const boxes = () => JSON.stringify(nodes.map(node => { const r = node.getBoundingClientRect(); return [r.left, r.top, r.width, getComputedStyle(node).visibility]; }));
105
+ const settled = boxes();
106
+ let steady = true;
107
+ for (let pass = 0; pass < 2; pass++) {draw(); chrome.flushSafeInsets?.(); await paint(); steady &&= boxes() === settled;}
93
108
  const card = document.querySelector('[data-hub="sound-card"]');
94
109
  const popup = card.getBoundingClientRect();
110
+ const soundInside = popup.left >= -0.5 && popup.top >= -0.5 && popup.right <= innerWidth + 0.5 && popup.bottom <= innerHeight + 0.5;
95
111
  const popupHits = nodes.filter(node => node !== sound && node.getBoundingClientRect().width > 0 && getComputedStyle(node).visibility !== 'hidden' && overlaps(node.getBoundingClientRect(), popup)).map(node => node.getAttribute('aria-label') || node.textContent);
112
+ // Quick chat's card and the Emote row open inside the view.
113
+ const popupsOutside = [];
114
+ const shownDivs = () => new Set([...document.querySelectorAll('div')].filter(div => div.style.position === 'absolute' && getComputedStyle(div).display !== 'none' && div.getBoundingClientRect().width > 0));
115
+ for (const button of ['Quick chat', 'Emote']) {
116
+ const node = nodes.find(other => other.getAttribute('aria-label') === button);
117
+ const before = shownDivs();
118
+ node.dispatchEvent(new PointerEvent('pointerdown'));
119
+ // As it opens, and again once safeLayout has placed it: inside the
120
+ // view and never over its own button.
121
+ for (const when of ['open', 'placed']) {
122
+ draw();
123
+ if (when === 'placed') {chrome.flushSafeInsets?.();}
124
+ const opened = [...shownDivs()].filter(div => !before.has(div));
125
+ if (!opened.length) {popupsOutside.push([button, when, 'did not open']);}
126
+ const own = node.getBoundingClientRect();
127
+ for (const div of opened) {
128
+ const r = div.getBoundingClientRect();
129
+ if (r.left < -0.5 || r.right > innerWidth + 0.5 || r.top < -0.5 || r.bottom > innerHeight + 0.5) {popupsOutside.push([button, when, r.left, r.right, r.top, r.bottom]);}
130
+ if (overlaps(r, own)) {popupsOutside.push([button, when, 'covers its button']);}
131
+ }
132
+ }
133
+ node.dispatchEvent(new PointerEvent('pointerdown'));
134
+ }
96
135
  const mute = [...card.querySelectorAll('button')][0], volume = card.querySelector('input');
97
136
  const reachable = [mute, volume].every(node => { const r = node.getBoundingClientRect(); return node.contains(document.elementFromPoint(r.left + r.width / 2, r.top + r.height / 2)); });
98
137
  mute.dispatchEvent(new PointerEvent('pointerdown'));
99
138
  volume.value = '35'; volume.dispatchEvent(new Event('input'));
100
139
  sound.dispatchEvent(new PointerEvent('pointerdown'));
101
140
  engine.detach(); chrome.dispose(); canvas.remove();
102
- return { greetingHit: Boolean(greetingHit), controls, collisions, cornerHits, outside, hud, promptHits, popupHits, reachable, soundChanges, height: innerHeight };
103
- }, { mode, input, setup });
104
- assert.equal(result.controls.length, (mode === 'act' ? 9 : 6) - (input === 'touch' ? 1 : 0), `${mode}: required controls and talk pill measured`);
105
- assert.equal(result.controls.some(box => box.name.startsWith('Shift lock')), input === 'keyboard', 'Shift lock follows input modality');
141
+ return { steady, popupsOutside, soundInside, greetingHit: Boolean(greetingHit), controls, collisions, cornerHits, outside, hud, promptHits, popupHits, reachable, soundChanges, height: innerHeight };
142
+ }, { mode, input, setup, doors });
143
+ for (const name of ['Character', 'Emote', 'Quick chat', 'Sound: 70%', ...doors ? ['Doors'] : []]) {assert(result.controls.some(box => box.name === name), `${width}x${height} ${mode} ${input}: ${name} measured`);}
144
+ assert.deepEqual(result.popupsOutside, [], `${width}x${height} ${mode} ${input}: Quick chat and Emote popups stay in the view, off their buttons`);
106
145
  assert.deepEqual(result.collisions, [], `${width}x${height} ${mode} ${input}`);
107
146
  assert.deepEqual(result.cornerHits, [], 'reserved corners');
108
147
  assert.deepEqual(result.outside, [], 'viewport bounds');
148
+ assert.deepEqual(result.popupHits, [], 'Sound popup clears the control column');
149
+ assert(result.soundInside, 'Sound popup stays in the view');
150
+ assert(result.steady, `${width}x${height} ${mode} ${input}: controls hold still while the Sound card is open`);
151
+ assert(result.reachable, 'Mute and Volume receive taps');
152
+ if (small) {
153
+ console.log(`${width}x${height} ${mode} ${input}: ${result.controls.length} controls clear`);
154
+ continue;
155
+ }
156
+ assert.equal(result.controls.length, (mode === 'act' ? 9 : 6) - (input === 'touch' ? 1 : 0) + (doors ? 1 : 0), `${mode}: required controls and talk pill measured`);
157
+ assert.equal(result.controls.some(box => box.name.startsWith('Shift lock')), input === 'keyboard', 'Shift lock follows input modality');
109
158
  assert(result.hud.visible && result.hud.width > 0 && result.hud.height > 0, 'HUD prompt remains visible');
110
159
  assert.equal(result.hud.text, 'Your next step is here.');
111
160
  assert(result.hud.top > result.height / 2 && result.hud.bottom <= result.height - 54, 'HUD prompt retains its bottom band');
112
161
  assert.deepEqual(result.promptHits, [], 'HUD prompt clears the controls');
113
162
  assert.equal(result.greetingHit, false, 'Rowan greeting yields to Sound');
114
- assert.deepEqual(result.popupHits, [], 'Sound popup clears the control column');
115
- assert(result.reachable, 'Mute and Volume receive taps');
116
163
  assert.deepEqual(result.soundChanges, [['muted', true], ['volume', 0.35]]);
117
164
  console.log(`${width}x${height} ${mode} ${input}: ${result.controls.length} controls clear`);
118
165
  }
@@ -0,0 +1,268 @@
1
+ // The corner surface (`code/client/cornerSurface.js`) and its tree
2
+ // (`cornerTree.js`): the Horn, the invite button and the stats line as the
3
+ // `corner` UI tree root, with no DOM, for a native host. Checks that the
4
+ // trees validate, portrait and landscape; that bytes and binding ids do not
5
+ // move across rebuilds with fresh closures; that words, sizes, rail places
6
+ // and the stats lines are chrome.js's (run over a stand-in DOM); and that
7
+ // the Horn and the invite button call the host's handlers, which send.
8
+ import assert from 'node:assert/strict';
9
+ import { execFileSync } from 'node:child_process';
10
+ import { register } from 'node:module';
11
+ register(`data:text/javascript,${encodeURIComponent(`
12
+ export async function resolve(specifier, context, next) {
13
+ if (specifier === 'castle-web-sdk') return { url: ${JSON.stringify(new URL('./fixtures/sdk-stub.mjs', import.meta.url).href)}, shortCircuit: true };
14
+ return next(specifier, context);
15
+ }
16
+ `)}`);
17
+ const { dispatchUiEvent, resetUiTrees, serialize, setUiTreeSink, validate } = await import('../code/client/uiTree.js');
18
+ const { buildCorner, statsLines, RAIL_ORDER } = await import('../code/client/cornerTree.js');
19
+ const { makeCornerSurface } = await import('../code/client/cornerSurface.js');
20
+
21
+ let passed = 0;
22
+ const test = async (name, fn) => {
23
+ try {await fn();} catch (error) {error.message = `${name}: ${error.message}`; throw error;}
24
+ passed += 1;
25
+ };
26
+
27
+ const VIEWS = { portrait: { landscape: false, safeInsets: false, lift: 0 }, landscape: { landscape: true, safeInsets: false, lift: 0 } };
28
+ const STATS = '58 fps · 3 avatars · 212 MB\n2f956d40d1a2 · 2026-10-24T18:00:00Z · hub-game 1.100.0\nserver 7c1e2a9b0f11';
29
+ const NEAR = '+ Party · bo';
30
+ const noop = { horn() {}, near() {} };
31
+ const all = (view, extra = {}) => ({ view, horn: true, near: NEAR, stats: STATS, covered: false, ...extra });
32
+ function find(tree, k) {
33
+ if (!tree) {return null;}
34
+ if (tree.k === k) {return tree;}
35
+ for (const child of tree.c ?? []) {
36
+ const hit = find(child, k);
37
+ if (hit) {return hit;}
38
+ }
39
+ return null;
40
+ }
41
+ const words = (node) => node?.text ?? node?.c?.find((child) => child.t === 'text' && !child.k)?.text;
42
+
43
+ await test('trees validate, portrait and landscape', () => {
44
+ for (const view of [...Object.values(VIEWS), { landscape: false, safeInsets: true, lift: 40 }, { landscape: true, safeInsets: true, lift: 0 }]) {
45
+ for (const extra of [{}, { horn: false }, { near: null }, { stats: null }, { covered: true }, { horn: false, near: null, stats: null }, { stats: 'one line' }]) {
46
+ assert.deepEqual(validate(buildCorner(all(view, extra), noop), 'corner'), []);
47
+ assert.deepEqual(validate(buildCorner(all(view, extra)), 'corner'), []);
48
+ }
49
+ }
50
+ });
51
+
52
+ await test('bytes and binding ids do not move across rebuilds with fresh closures', () => {
53
+ for (const view of Object.values(VIEWS)) {
54
+ const one = serialize(buildCorner(all(view), { horn: () => 1, near: () => 1 }), 'corner');
55
+ const two = serialize(buildCorner(structuredClone(all(view)), { horn: () => 2, near: () => 2 }), 'corner');
56
+ assert.equal(one.json, two.json);
57
+ assert.deepEqual([...one.handlers.keys()], ['corner/horn#tap', 'corner/near#tap']);
58
+ assert.deepEqual([...two.handlers.keys()], ['corner/horn#tap', 'corner/near#tap']);
59
+ }
60
+ assert.equal(serialize(buildCorner(all(VIEWS.portrait, { horn: false, near: null, stats: null }), noop), 'corner').json, '{"t":"stack","k":"corner","s":{"font":"ui","size":15,"weight":600,"lh":1.3,"color":"#fff"}}');
61
+ });
62
+
63
+ // chrome.js over a stand-in DOM.
64
+ function fakeDom() {
65
+ const made = [];
66
+ function node(tag) {
67
+ const listeners = {};
68
+ const self = {
69
+ tag, children: [], parent: null, dataset: {}, attrs: {}, textContent: '', innerHTML: '',
70
+ appendChild(child) {child.parent = self; self.children.push(child); return child;},
71
+ insertBefore(child) {child.parent = self; self.children.push(child); return child;},
72
+ remove() {}, replaceChildren() {self.children = [];}, contains: () => false,
73
+ addEventListener: (type, fn) => (listeners[type] = fn), removeEventListener() {},
74
+ setAttribute: (key, value) => (self.attrs[key] = String(value)), getAttribute: (key) => self.attrs[key] ?? null,
75
+ fire: (type) => listeners[type]?.({ stopPropagation() {}, preventDefault() {} }),
76
+ focus() {}, blur() {}, getBoundingClientRect: () => ({ left: 0, right: 0, top: 0, bottom: 0, width: 0, height: 0 }),
77
+ offsetWidth: 100, offsetHeight: 40, offsetLeft: 0, offsetTop: 0,
78
+ };
79
+ self.style = new Proxy({}, { set(target, key, value) {target[key] = String(value); return true;} });
80
+ made.push(self);
81
+ return self;
82
+ }
83
+ globalThis.document = { body: node('body'), createElement: node, activeElement: null };
84
+ globalThis.window = { innerWidth: 390, innerHeight: 844 };
85
+ return { made };
86
+ }
87
+ const { makeChrome } = await import('../code/client/chrome.js');
88
+
89
+ await test('words, sizes, places and the stats lines are chrome.js\'s', () => {
90
+ const dom = fakeDom();
91
+ const chrome = makeChrome({ onBack() {}, onAvatar() {}, avatarCount: 4 });
92
+ chrome.hornPrompt(() => {});
93
+ chrome.nearPrompt(NEAR, () => {});
94
+ chrome.setStats(STATS);
95
+ const horn = dom.made.find((n) => n.tag === 'button' && n.textContent === 'Horn');
96
+ const near = dom.made.find((n) => n.tag === 'button' && n.textContent === NEAR);
97
+ const stats = dom.made.find((n) => n.textContent === STATS);
98
+ const tree = buildCorner(all(VIEWS.portrait), noop);
99
+ const tHorn = find(tree, 'horn');
100
+ assert.equal(words(tHorn), horn.textContent);
101
+ assert.deepEqual([`${tHorn.s.w}px`, `${tHorn.s.h}px`, `${tHorn.s.radius}px`], [horn.style.width, horn.style.height, horn.style.borderRadius]);
102
+ assert.equal(horn.style.bottom, 'max(60px, calc(env(safe-area-inset-bottom) + 50px))');
103
+ assert.deepEqual(tHorn.at, { anchor: 'bottomRight', right: 14, bottom: [60, 50], rail: { name: 'right', order: RAIL_ORDER.horn } });
104
+ assert.deepEqual([tHorn.s.size, tHorn.s.weight, tHorn.fire], [16, 800, 'down']);
105
+ const tNear = find(tree, 'near');
106
+ assert.equal(words(tNear), near.textContent);
107
+ assert.equal(near.style.bottom, 'max(160px, calc(env(safe-area-inset-bottom) + 150px))');
108
+ assert.deepEqual(tNear.at, { anchor: 'bottom', bottom: [160, 150] });
109
+ assert.deepEqual([tNear.s.maxW, tNear.s.lines, tNear.s.size, tNear.fire], [[{ vw: 80 }], 1, 13, 'down']);
110
+ // Stats: the DOM's one pre-wrapped node is one unwrapped text per line.
111
+ assert.equal(stats.style.whiteSpace, 'pre');
112
+ assert.equal(stats.style.font, '11px/1.3 ui-monospace, monospace');
113
+ const tStats = find(tree, 'stats');
114
+ assert.deepEqual(tStats.c.map((t) => t.text), STATS.split('\n'));
115
+ assert(tStats.c.every((t) => t.s.wrap === 'none'));
116
+ assert.deepEqual(tStats.at, { anchor: 'topRight', right: 8, top: [8, 0] });
117
+ assert.deepEqual([tStats.s.font, tStats.s.size, tStats.s.lh, tStats.s.opacity, tStats.s.talign, tStats.s.hit], ['mono', 11, 1.3, 0.7, 'end', 'none']);
118
+ assert.deepEqual(statsLines('60 fps · 1 avatars'), ['60 fps · 1 avatars']);
119
+ chrome.dispose();
120
+ // Landscape: the smaller Horn and the invite button in the rail.
121
+ const land = buildCorner(all(VIEWS.landscape), noop);
122
+ assert.deepEqual([find(land, 'horn').s.w, find(land, 'horn').s.radius], [56, 28]);
123
+ assert.deepEqual(find(land, 'near').at, { anchor: 'bottomRight', right: 12, bottom: [160, 150], rail: { name: 'right', order: RAIL_ORDER.near } });
124
+ assert.deepEqual(find(land, 'near').s.maxW, [{ vw: 38 }, { px: 160 }]);
125
+ // A safe-inset place with a Shift lock lift (upright only).
126
+ const lifted = buildCorner(all({ landscape: false, safeInsets: true, lift: 40 }), noop);
127
+ assert.deepEqual(find(lifted, 'horn').at, { anchor: 'bottomRight', right: [14, 0], bottom: [100, 90], rail: { name: 'right', order: 1 } });
128
+ assert.deepEqual(find(lifted, 'stats').at.right, [8, 0]);
129
+ // Under the open Character sheet: out of sight, still in place.
130
+ const covered = buildCorner(all(VIEWS.portrait, { covered: true }), noop);
131
+ assert.deepEqual([find(covered, 'horn').s.hidden, find(covered, 'near').s.hidden, find(covered, 'stats').s.hidden], [true, true, undefined]);
132
+ });
133
+
134
+ await test('events: the Horn and the invite button call the host\'s handlers, which send', () => {
135
+ resetUiTrees();
136
+ const roots = [];
137
+ setUiTreeSink((name, wire) => roots.push({ name, wire }), { dom: false });
138
+ const sent = [];
139
+ const net = { send: (msg) => sent.push(msg) };
140
+ let view = VIEWS.portrait;
141
+ const surface = makeCornerSurface({ view: () => view });
142
+ const wire = () => roots.filter((r) => r.name === 'corner').at(-1)?.wire ?? null;
143
+ const tap = (id) => dispatchUiEvent('corner', id, {});
144
+ surface.hornPrompt(() => net.send({ k: 'hub-horn' }));
145
+ surface.nearPrompt(NEAR, () => net.send({ k: 'hub-party', op: 'invite', player: 'p2' }));
146
+ surface.setStats(STATS);
147
+ assert.equal(tap('corner/horn#tap'), true);
148
+ assert.equal(tap('corner/near#tap'), true);
149
+ assert.deepEqual(sent.splice(0), [{ k: 'hub-horn' }, { k: 'hub-party', op: 'invite', player: 'p2' }]);
150
+ // Said every frame: nothing resent.
151
+ const posts = roots.length;
152
+ surface.nearPrompt(NEAR, () => net.send({ k: 'hub-party', op: 'invite', player: 'p2' }));
153
+ surface.setStats(STATS);
154
+ assert.equal(roots.length, posts);
155
+ // A list or card open: no invite button. Sent words change: 'Invited'.
156
+ surface.setBlocked(true);
157
+ assert.equal(find(wire(), 'near'), null);
158
+ assert.equal(tap('corner/near#tap'), false);
159
+ surface.setBlocked(false);
160
+ surface.nearPrompt('Invited · bo', () => {});
161
+ assert.equal(words(find(wire(), 'near')), 'Invited · bo');
162
+ surface.nearPrompt(null);
163
+ assert.equal(find(wire(), 'near'), null);
164
+ // grabPrompt takes the Horn away; turning the phone redraws the rail.
165
+ surface.grabPrompt(null);
166
+ assert.equal(find(wire(), 'horn'), null);
167
+ assert.equal(tap('corner/horn#tap'), false);
168
+ surface.hornPrompt(() => net.send({ k: 'hub-horn' }));
169
+ view = VIEWS.landscape;
170
+ surface.render();
171
+ assert.equal(find(wire(), 'horn').s.w, 56);
172
+ surface.setCovered(true);
173
+ assert.equal(find(wire(), 'horn').s.hidden, true);
174
+ surface.setStats(null);
175
+ assert.equal(find(wire(), 'stats'), null);
176
+ assert.deepEqual(sent, []);
177
+ surface.dispose();
178
+ assert.equal(wire(), null);
179
+ resetUiTrees();
180
+ });
181
+
182
+ await test('the Grab button: chrome.js\'s words, size, place and Throw colours, in the Horn\'s place', () => {
183
+ for (const view of [...Object.values(VIEWS), { landscape: false, safeInsets: true, lift: 40 }]) {
184
+ for (const extra of [{ horn: false, grab: 'Grab' }, { horn: false, grab: 'Throw' }, { grab: 'Grab' }, { horn: false, grab: 'Throw', covered: true }]) {
185
+ assert.deepEqual(validate(buildCorner(all(view, extra), noop), 'corner'), []);
186
+ }
187
+ }
188
+ const dom = fakeDom();
189
+ const chrome = makeChrome({ onBack() {}, onAvatar() {}, avatarCount: 4 });
190
+ chrome.grabPrompt('Throw');
191
+ const button = dom.made.find((n) => n.tag === 'button' && n.textContent === 'Throw');
192
+ const tree = buildCorner(all(VIEWS.portrait, { horn: false, grab: 'Throw' }), noop);
193
+ const tGrab = find(tree, 'grab');
194
+ assert.equal(words(tGrab), button.textContent);
195
+ assert.deepEqual([`${tGrab.s.w}px`, `${tGrab.s.h}px`, `${tGrab.s.radius}px`], [button.style.width, button.style.height, button.style.borderRadius]);
196
+ assert.deepEqual([tGrab.s.bg, tGrab.s.color], [button.style.background, button.style.color]);
197
+ assert.deepEqual(tGrab.at, find(buildCorner(all(VIEWS.portrait), noop), 'horn').at);
198
+ assert.equal(tGrab.at.rail.order, RAIL_ORDER.grab);
199
+ chrome.grabPrompt('Grab');
200
+ assert.equal(button.textContent, 'Grab');
201
+ const tPlain = find(buildCorner(all(VIEWS.portrait, { horn: false, grab: 'Grab' }), noop), 'grab');
202
+ assert.deepEqual([tPlain.s.bg, tPlain.s.color], ['copy', '#fff']);
203
+ chrome.dispose();
204
+ // The Horn takes the place: one button, as chrome.js's.
205
+ const both = buildCorner(all(VIEWS.portrait, { grab: 'Grab' }), noop);
206
+ assert.equal(find(both, 'grab'), null);
207
+ assert.ok(find(both, 'horn'));
208
+ assert.equal(find(buildCorner(all(VIEWS.landscape, { horn: false, grab: 'Grab' }), noop), 'grab').s.w, 56);
209
+ assert.equal(find(buildCorner(all(VIEWS.portrait, { horn: false, grab: 'Grab', covered: true }), noop), 'grab').s.hidden, true);
210
+ // Anything else is no button.
211
+ assert.equal(find(buildCorner(all(VIEWS.portrait, { horn: false, grab: 'Kick' }), noop), 'grab'), null);
212
+ });
213
+
214
+ await test('events: the Grab button calls grab.js\'s handler; the Horn and Act mode take it away', () => {
215
+ resetUiTrees();
216
+ const roots = [];
217
+ setUiTreeSink((name, wire) => roots.push({ name, wire }), { dom: false });
218
+ const surface = makeCornerSurface({ view: () => VIEWS.portrait });
219
+ const wire = () => roots.filter((r) => r.name === 'corner').at(-1)?.wire ?? null;
220
+ const tap = (id) => dispatchUiEvent('corner', id, {});
221
+ let presses = 0;
222
+ surface.onGrab(() => (presses += 1));
223
+ surface.grabPrompt('Grab');
224
+ assert.equal(words(find(wire(), 'grab')), 'Grab');
225
+ assert.equal(tap('corner/grab#tap'), true);
226
+ assert.equal(presses, 1);
227
+ surface.grabPrompt('Throw');
228
+ assert.equal(find(wire(), 'grab').s.bg, 'rgba(233,196,143,0.92)');
229
+ // Said every frame: nothing resent.
230
+ const posts = roots.length;
231
+ surface.grabPrompt('Throw');
232
+ assert.equal(roots.length, posts);
233
+ // The hub system's frame order: grabPrompt, then hornPrompt while driving.
234
+ surface.hornPrompt(() => {});
235
+ assert.equal(find(wire(), 'grab'), null);
236
+ assert.ok(find(wire(), 'horn'));
237
+ surface.grabPrompt(null);
238
+ assert.equal(find(wire(), 'horn'), null);
239
+ assert.equal(find(wire(), 'grab'), null);
240
+ // Act mode: the Act slot offers grabbing, never the corner.
241
+ surface.setActMode(true);
242
+ surface.grabPrompt('Grab');
243
+ assert.equal(find(wire(), 'grab'), null);
244
+ assert.equal(tap('corner/grab#tap'), false);
245
+ surface.setActMode(false);
246
+ surface.grabPrompt('Grab');
247
+ assert.ok(find(wire(), 'grab'));
248
+ surface.dispose();
249
+ resetUiTrees();
250
+ });
251
+
252
+ await test('the surface loads and runs in a process that never had a DOM', () => {
253
+ const probe = `
254
+ if (globalThis.document || globalThis.window) throw new Error('a DOM');
255
+ const { setUiTreeSink, dispatchUiEvent } = await import(${JSON.stringify(new URL('../code/client/uiTree.js', import.meta.url).href)});
256
+ const { makeCornerSurface } = await import(${JSON.stringify(new URL('../code/client/cornerSurface.js', import.meta.url).href)});
257
+ const seen = [];
258
+ setUiTreeSink((name, wire) => seen.push(name + ':' + (wire ? (wire.c ?? []).length : null)), { dom: false });
259
+ const surface = makeCornerSurface({ view: () => ({ landscape: false }) });
260
+ surface.hornPrompt(() => seen.push('honk'));
261
+ dispatchUiEvent('corner', 'corner/horn#tap', {});
262
+ surface.dispose();
263
+ console.log(seen.join(' '));
264
+ `;
265
+ assert.equal(execFileSync(process.execPath, ['--input-type=module', '-e', probe], { encoding: 'utf8' }).trim(), 'corner:0 corner:1 honk corner:null');
266
+ });
267
+
268
+ console.log(`corner surface: ${passed} checks passed`);
@@ -66,7 +66,7 @@ function specification() {
66
66
  { id: 'pot', tab: 'furniture', label: 'Pot', template: 'pot-template', w: 1, d: 1, layer: 'floor', count: 0 },
67
67
  ], placed: [{ key: 'copy', item: 'chair', x: 1, z: 1, rot: 0, layer: 'floor' }], swatches: [{ id: 'sage', tab: 'walls', label: 'Sage', color: '#779977' }] };
68
68
  }
69
- function rig(w = 360, h = 780) {
69
+ function rig(w = 360, h = 780, refuse = undefined) {
70
70
  State.clear();
71
71
  const dom = fakeDom(w, h), sent = [], calls = [];
72
72
  const camera = new THREE.PerspectiveCamera(50, w / h, 0.1, 1000);
@@ -86,13 +86,13 @@ function rig(w = 360, h = 780) {
86
86
  const mp = { net: { send(op) { sent.push(op); }, selfId: () => 'p1' }, joinState: () => 'joined' };
87
87
  const chrome = { decorRoot: () => dom.body, setDecorating(on) { calls.push(['decorating', on]); } };
88
88
  let made = 0, rendered = 0, disposed = 0, lost = 0;
89
- const ui = makeDecor(chrome, { renderer() {
89
+ const ui = makeDecor(chrome, { refuse, renderer() {
90
90
  made += 1;
91
91
  return { setPixelRatio() {}, setSize() {}, setClearColor() {}, render(scene, cam) { rendered += 1; assert.ok(scene.children.some((n) => n.isGroup)); assert.ok(cam.isOrthographicCamera); }, domElement: { toDataURL: () => `data:image/png;base64,thumb${rendered}` }, dispose() { disposed += 1; }, forceContextLoss() { lost += 1; } };
92
92
  } });
93
93
  const root = dom.body.children[0], worldInput = root.children[2];
94
94
  State.hub.place = { decor: { grid: { origin: 'floor', w: 8, d: 7, cell: 1 }, layers: ['rug', 'floor'] } };
95
- const receive = (spec = specification()) => hook.message({}, { k: 'hub-decor', button: 'Decorate', spec, ...(spec ? { grid } : {}) });
95
+ const receive = (spec = specification(), resolvedGrid = grid) => hook.message({}, { k: 'hub-decor', button: 'Decorate', spec, ...(spec ? { grid: resolvedGrid } : {}) });
96
96
  const frame = (can = true) => { world.scene.updateMatrixWorld(true); ui.frame(scene, mp, local, can); };
97
97
  const find = (text) => walk(root).find((n) => n.textContent === text);
98
98
  const tile = (label) => walk(root).find((n) => n.attrs['aria-label']?.startsWith(`${label} ·`));
@@ -229,6 +229,16 @@ test('button only creates no preview or thumbnail renderer and sends a private b
229
229
  assert.deepEqual(r.counts(), { made: 0, rendered: 0, disposed: 0, lost: 0 });
230
230
  r.find('Decorate').click(); assert.deepEqual(r.sent, [{ k: 'decor', op: 'button' }]); r.ui.dispose();
231
231
  });
232
+ test('v1.204: a decor press refused while catching up says why and sends nothing; the layer is marked to dim', () => {
233
+ let catching = true; const refusals = [];
234
+ const r = rig(360, 780, () => { if (!catching) {return false;} refusals.push(1); return true; });
235
+ r.receive(null); r.frame();
236
+ assert.equal(r.root.attrs['data-hub'], 'decor');
237
+ r.find('Decorate').click();
238
+ assert.deepEqual(r.sent, []); assert.equal(refusals.length, 1, 'one line per press');
239
+ catching = false; r.find('Decorate').click();
240
+ assert.deepEqual(r.sent, [{ k: 'decor', op: 'button' }]); r.ui.dispose();
241
+ });
232
242
  test('phone and desktop trays: thumbnail cache, count chips, exhausted/locked stock and labels', () => {
233
243
  for (const width of [360, 412, 1100]) {
234
244
  const r = rig(width); r.receive(); r.frame();
@@ -236,6 +246,10 @@ test('phone and desktop trays: thumbnail cache, count chips, exhausted/locked st
236
246
  assert.ok(r.find('Decorating')); assert.ok(r.find('Only you can change your house'));
237
247
  assert.ok(r.find('×2')); assert.equal(r.find('×0'), undefined); assert.equal(r.find('×1'), undefined); assert.ok(r.find('🔒')); assert.ok(r.find('120 ▲'));
238
248
  assert.equal(r.tile('Sofa').disabled, true); assert.equal(r.tile('Pot').disabled, true);
249
+ // A piece's name wraps to two lines instead of an ellipsis; only its unlock line may clip.
250
+ const name = r.tile('Sofa').children.find((n) => n.textContent === 'Sofa');
251
+ assert.equal(name.style.WebkitLineClamp, '2'); assert.equal(name.style.textOverflow, undefined); assert.equal(name.style.whiteSpace, undefined);
252
+ assert.equal(r.tile('Sofa').style.width, '72px');
239
253
  r.tile('Pot').click(); r.tile('Sofa').click();
240
254
  assert.equal(r.find('Cancel'), undefined); assert.deepEqual(r.sent, []);
241
255
  assert.equal(r.counts().rendered, 1);
@@ -305,6 +319,48 @@ test('overlap/outside previews are red and cannot confirm; valid cells are green
305
319
  assert.equal(r.find('✓').disabled, false); r.find('Cancel').click(); r.frame(); assert.equal(r.world.scene.children.length, 5);
306
320
  r.ui.dispose();
307
321
  });
322
+ test('a new resolved grid clears lifted and new ghosts, restores actors and redraws floor at new height', () => {
323
+ const r = rig(); r.receive(); r.frame();
324
+ const floor = r.world.scene.children.find((node) => node.children.some((child) => child.isLineSegments));
325
+ r.pointer('pointerdown', 1.5, 1.5); r.frame();
326
+ assert.equal(r.world.nodes.get('copy').node.visible, false);
327
+ const nextGrid = { ...grid, x: 12, y: 4, z: -8, w: 3, d: 2, cell: 0.5 };
328
+ r.receive(specification(), nextGrid); r.frame();
329
+ assert.equal(r.world.nodes.get('copy').node.visible, true);
330
+ assert.equal(r.find('Put away').parent.style.display, 'none');
331
+ assert.equal(floor.parent, null);
332
+ const lines = r.world.scene.children.flatMap((node) => node.children).find((node) => node.isLineSegments);
333
+ const vertices = [...lines.geometry.attributes.position.array];
334
+ assert.ok(Math.abs(vertices[1] - 4.025) < 0.00001);
335
+ assert.equal(vertices[0], 12); assert.equal(vertices[2], -8);
336
+ assert.equal(Math.max(...vertices.filter((_, i) => i % 3 === 0)), 13.5);
337
+ r.tile('Chair').click(); r.frame();
338
+ assert.equal(r.find('Cancel').parent.style.display, 'flex');
339
+ r.receive(specification()); r.frame();
340
+ assert.equal(r.find('Cancel').parent.style.display, 'none');
341
+ assert.equal(r.world.scene.children.length, 5, 'only the original actors and replacement grid remain');
342
+ r.ui.dispose();
343
+ });
344
+ test('action tiles send pick without stock or ghosts, hide count chips and retain locked price chrome', () => {
345
+ const r = rig(), spec = specification();
346
+ spec.items = [
347
+ { ...spec.items[0], id: 'build', label: 'Build', action: true, count: 0 },
348
+ { ...spec.items[1], action: true, count: 9 },
349
+ { ...spec.items[2], label: 'Rooms', action: true, count: 9 },
350
+ ];
351
+ r.receive(spec); r.frame();
352
+ assert.equal(r.tile('Build').disabled, false);
353
+ assert.equal(r.find('×9'), undefined);
354
+ assert.ok(r.find('🔒')); assert.ok(r.find('120 ▲'));
355
+ assert.equal(r.tile('Sofa').disabled, true);
356
+ r.tile('Sofa').click(); assert.deepEqual(r.sent, []);
357
+ r.tile('Build').click(); r.frame(); r.tile('Rooms').click(); r.frame();
358
+ assert.deepEqual(r.sent, [{ k: 'decor', op: 'pick', item: 'build' }, { k: 'decor', op: 'pick', item: 'pot' }]);
359
+ assert.equal(r.find('Cancel'), undefined);
360
+ assert.equal(r.world.scene.children.length, 5, 'action taps create no ghost');
361
+ assert.equal(r.world.nodes.get('copy').node.visible, true);
362
+ r.ui.dispose();
363
+ });
308
364
  test('swatch and Done are ids/close only; scene, disconnect and disposal clear all preview resources', () => {
309
365
  const r = rig(); r.receive(); r.frame(); r.find('Walls').click(); r.find('Sage').click();
310
366
  assert.deepEqual(r.sent.at(-1), { k: 'decor', op: 'swatch', swatch: 'sage' });
@@ -240,6 +240,33 @@ test('manifest refuses malformed bounds, layers, ids, unknown fields and house s
240
240
  assert.equal(Manifest.readManifest(json({ house })).manifest, null);
241
241
  }
242
242
  });
243
+ test('action tiles route pick without stock, refuse locked/non-action/missing ids and share the op budget', () => {
244
+ const r = boot({ decor });
245
+ r.say('p1', { k: 'decor', op: 'pick', item: 'build' });
246
+ r.hub.decor.open('p1', { ...spec(), items: [item, { ...item, id: 'build', action: true, count: 0 },
247
+ { ...item, id: 'locked', action: true, locked: { price: '120 ▲' } }] });
248
+ for (const id of ['chair', 'locked', 'missing']) r.say('p1', { k: 'decor', op: 'pick', item: id });
249
+ r.say('p2', { k: 'decor', op: 'pick', item: 'build' });
250
+ r.say('p1', { k: 'decor', op: 'pick', item: 'build', extra: true });
251
+ assert.deepEqual(r.ops, []);
252
+ r.say('p1', { k: 'decor', op: 'pick', item: 'build' });
253
+ assert.deepEqual(r.ops, [['p1', { op: 'pick', item: 'build' }]], 'zero stock still routes the action');
254
+ r.ops.length = 0;
255
+ r.tick(1000);
256
+ r.hub.decor.update('p1', { items: [{ ...item, id: 'build', action: true }] });
257
+ r.say('p1', { k: 'decor', op: 'place', item: 'build', x: 0, z: 0, rot: 0 });
258
+ assert.deepEqual(r.ops, [], 'actions cannot be placed even with stock');
259
+ for (let i = 0; i < 10; i++) r.say('p1', { k: 'decor', op: 'pick', item: 'build' });
260
+ assert.deepEqual(r.ops, Array.from({ length: 8 }, () => ['p1', { op: 'pick', item: 'build' }]));
261
+ r.say('p1', { k: 'decor', op: 'close' });
262
+ assert.equal(r.ops.length, 8, 'pick spends the ordinary budget');
263
+ r.tick(1000);
264
+ r.say('p1', { k: 'decor', op: 'pick', item: 'build' });
265
+ assert.equal(r.ops.length, 9);
266
+ for (const change of [{ action: false }, { action: 'true' }, { action: true, count: undefined }, { action: true, w: 0 }, { action: true, layer: 'missing' }]) {
267
+ assert.throws(() => r.hub.decor.open('p1', { ...spec(), items: [{ ...item, ...change }] }), TypeError);
268
+ }
269
+ });
243
270
  test('exact catalogue limits are accepted; malformed rotated bounds and duplicate ids are refused', () => {
244
271
  const h = { actors, place: { decor: { ...decor, grid: { ...decor.grid, w: 16, d: 16 } } }, spawned: new Map(Array.from({ length: 64 }, (_, i) => [`copy-${i}`, {}])) };
245
272
  const max = {
@@ -55,7 +55,10 @@ console.log('device class layout, edges, invalid inputs, presence and round trip
55
55
 
56
56
  // Run the actual hello method without loading the rendering engine.
57
57
  const source = readFileSync(new URL('../code/systems/hub.js', import.meta.url), 'utf8');
58
- const method = source.slice(source.indexOf(' sendHello(scene,'), source.indexOf('\n // Hide what the place hid'));
58
+ // The method alone: from its signature to its own closing brace, whatever
59
+ // the class puts after it.
60
+ const helloAt = source.indexOf(' sendHello(scene,');
61
+ const method = source.slice(helloAt, source.indexOf('\n }\n', helloAt) + 4);
59
62
  function hello(globals = {}, encoder = encode) {
60
63
  const messages = [];
61
64
  const context = { ...globals, encodeDeviceClass: encoder, Hub: { hub: {}, deck: {} },