castle-web-cli 0.4.239 → 0.4.241

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 (396) 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 +163 -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 +6 -3
  16. package/dist/init.js +24 -2
  17. package/dist/multiplayerDoc.d.ts +1 -1
  18. package/dist/multiplayerDoc.js +2 -0
  19. package/dist/platformDoc.js +3 -2
  20. package/dist/playPagePolicy.js +5 -1
  21. package/dist/resetLeaderboards.d.ts +8 -1
  22. package/dist/resetLeaderboards.js +43 -8
  23. package/dist/roomLogs.d.ts +1 -0
  24. package/dist/roomLogs.js +30 -6
  25. package/dist/save-deck.d.ts +32 -2
  26. package/dist/save-deck.js +240 -39
  27. package/kits/base/CLAUDE.md +1 -1
  28. package/kits/base/castle.json +1 -1
  29. package/kits/base/sdk/README.md +174 -6
  30. package/kits/base/sdk/analytics.d.ts +8 -0
  31. package/kits/base/sdk/analytics.js +92 -0
  32. package/kits/base/sdk/castle.d.ts +5 -1
  33. package/kits/base/sdk/castle.js +2 -0
  34. package/kits/base/sdk/commands.d.ts +48 -0
  35. package/kits/base/sdk/commands.js +1 -0
  36. package/kits/base/sdk/debugConsole.d.ts +17 -0
  37. package/kits/base/sdk/debugConsole.js +154 -0
  38. package/kits/base/sdk/experiments.js +24 -1
  39. package/kits/base/sdk/hostRetry.d.ts +7 -0
  40. package/kits/base/sdk/hostRetry.js +57 -0
  41. package/kits/base/sdk/hub.d.ts +20 -2
  42. package/kits/base/sdk/hub.js +99 -13
  43. package/kits/base/sdk/multiplayer.d.ts +2 -0
  44. package/kits/base/sdk/multiplayer.js +168 -26
  45. package/kits/base/sdk/reconnectBudget.d.ts +6 -0
  46. package/kits/base/sdk/reconnectBudget.js +41 -1
  47. package/kits/base/sdk/runtime.js +36 -19
  48. package/kits/base/sdk/server/hub.d.ts +19 -0
  49. package/kits/base/sdk/server/hub.js +12 -0
  50. package/kits/base/sdk/server/platformHandle.d.ts +1 -0
  51. package/kits/base/sdk/server/wrapper.d.ts +1 -1
  52. package/kits/base/sdk/server/wrapper.js +26 -1
  53. package/kits/base/sdk/transport.d.ts +2 -1
  54. package/kits/base/sdk/transport.js +35 -0
  55. package/kits/hub-game/CLAUDE.md +66 -19
  56. package/kits/hub-game/code/client/act.js +9 -6
  57. package/kits/hub-game/code/client/actCore.js +26 -6
  58. package/kits/hub-game/code/client/actGateLog.js +36 -0
  59. package/kits/hub-game/code/client/actionOverflow.js +29 -8
  60. package/kits/hub-game/code/client/actionRailSurface.js +186 -0
  61. package/kits/hub-game/code/client/actionRailTree.js +173 -0
  62. package/kits/hub-game/code/client/askSurface.js +85 -0
  63. package/kits/hub-game/code/client/askTree.js +51 -0
  64. package/kits/hub-game/code/client/attention.js +31 -6
  65. package/kits/hub-game/code/client/ballot.js +42 -5
  66. package/kits/hub-game/code/client/ballotSurface.js +115 -0
  67. package/kits/hub-game/code/client/ballotTree.js +180 -0
  68. package/kits/hub-game/code/client/catchingUp.js +19 -0
  69. package/kits/hub-game/code/client/celebrate.js +66 -0
  70. package/kits/hub-game/code/client/chrome.js +481 -57
  71. package/kits/hub-game/code/client/companion.js +93 -23
  72. package/kits/hub-game/code/client/companionDress.js +1 -1
  73. package/kits/hub-game/code/client/cornerSurface.js +106 -0
  74. package/kits/hub-game/code/client/cornerTree.js +83 -0
  75. package/kits/hub-game/code/client/decor.js +20 -11
  76. package/kits/hub-game/code/client/deviceStorage.js +121 -0
  77. package/kits/hub-game/code/client/disguise.js +23 -0
  78. package/kits/hub-game/code/client/disguiseDraw.js +87 -0
  79. package/kits/hub-game/code/client/dockSurface.js +206 -0
  80. package/kits/hub-game/code/client/dockTree.js +232 -0
  81. package/kits/hub-game/code/client/earned.js +29 -0
  82. package/kits/hub-game/code/client/emoteSurface.js +188 -0
  83. package/kits/hub-game/code/client/emoteTree.js +264 -0
  84. package/kits/hub-game/code/client/farAvatars.js +4 -3
  85. package/kits/hub-game/code/client/fpsTelemetry.js +3 -1
  86. package/kits/hub-game/code/client/grab.js +121 -50
  87. package/kits/hub-game/code/client/holdShow.js +19 -0
  88. package/kits/hub-game/code/client/hookLayer.js +96 -12
  89. package/kits/hub-game/code/client/hubControls.js +7 -1
  90. package/kits/hub-game/code/client/hudSurface.js +11 -3
  91. package/kits/hub-game/code/client/hudTree.js +7 -4
  92. package/kits/hub-game/code/client/idle.js +21 -3
  93. package/kits/hub-game/code/client/invites.js +24 -3
  94. package/kits/hub-game/code/client/keys.js +15 -0
  95. package/kits/hub-game/code/client/labelsNear.js +8 -1
  96. package/kits/hub-game/code/client/layoutCache.js +57 -8
  97. package/kits/hub-game/code/client/loadingCover.js +53 -4
  98. package/kits/hub-game/code/client/menuIcons.js +15 -0
  99. package/kits/hub-game/code/client/menuSurface.js +102 -0
  100. package/kits/hub-game/code/client/menuTree.js +135 -0
  101. package/kits/hub-game/code/client/modelLook.js +41 -0
  102. package/kits/hub-game/code/client/padCues.js +11 -7
  103. package/kits/hub-game/code/client/padReadability.js +3 -3
  104. package/kits/hub-game/code/client/pickerSurface.js +152 -0
  105. package/kits/hub-game/code/client/pickerTree.js +163 -0
  106. package/kits/hub-game/code/client/pushVisit.js +4 -2
  107. package/kits/hub-game/code/client/quality.js +188 -29
  108. package/kits/hub-game/code/client/qualityEntry.js +10 -1
  109. package/kits/hub-game/code/client/quickChatSurface.js +222 -0
  110. package/kits/hub-game/code/client/quickChatTree.js +201 -0
  111. package/kits/hub-game/code/client/rehello.js +75 -0
  112. package/kits/hub-game/code/client/renderVisibility.js +17 -0
  113. package/kits/hub-game/code/client/replay.js +118 -0
  114. package/kits/hub-game/code/client/role.js +3 -0
  115. package/kits/hub-game/code/client/safeLayout.js +441 -56
  116. package/kits/hub-game/code/client/safeStyle.js +13 -10
  117. package/kits/hub-game/code/client/say.js +2 -0
  118. package/kits/hub-game/code/client/soundSurface.js +77 -0
  119. package/kits/hub-game/code/client/soundTree.js +74 -0
  120. package/kits/hub-game/code/client/soundscape.js +12 -9
  121. package/kits/hub-game/code/client/soundscapeCues.js +1 -1
  122. package/kits/hub-game/code/client/state.js +67 -1
  123. package/kits/hub-game/code/client/stuckSurface.js +76 -0
  124. package/kits/hub-game/code/client/stuckTree.js +67 -0
  125. package/kits/hub-game/code/client/talk.js +42 -12
  126. package/kits/hub-game/code/client/talkTree.js +4 -2
  127. package/kits/hub-game/code/client/textAskSurface.js +147 -0
  128. package/kits/hub-game/code/client/textAskTree.js +67 -0
  129. package/kits/hub-game/code/client/tiers.js +252 -27
  130. package/kits/hub-game/code/client/together.js +4 -1
  131. package/kits/hub-game/code/client/uiDom.js +86 -8
  132. package/kits/hub-game/code/client/uiTree.js +33 -4
  133. package/kits/hub-game/code/client/vehicle.js +72 -51
  134. package/kits/hub-game/code/client/weakestTier.js +75 -31
  135. package/kits/hub-game/code/client/wear.js +159 -5
  136. package/kits/hub-game/code/client/worldLabels.js +205 -25
  137. package/kits/hub-game/code/companionSpec.js +4 -2
  138. package/kits/hub-game/code/server/act.js +3 -0
  139. package/kits/hub-game/code/server/actGate.js +83 -0
  140. package/kits/hub-game/code/server/actions.js +71 -15
  141. package/kits/hub-game/code/server/actors.js +20 -5
  142. package/kits/hub-game/code/server/analytics.js +35 -3
  143. package/kits/hub-game/code/server/ask.js +39 -3
  144. package/kits/hub-game/code/server/ballot.js +167 -4
  145. package/kits/hub-game/code/server/celebrate.js +64 -0
  146. package/kits/hub-game/code/server/companion.js +17 -2
  147. package/kits/hub-game/code/server/decor.js +11 -2
  148. package/kits/hub-game/code/server/disguise.js +63 -0
  149. package/kits/hub-game/code/server/earned.js +6 -2
  150. package/kits/hub-game/code/server/friendBests.js +13 -4
  151. package/kits/hub-game/code/server/friendsAmong.js +67 -8
  152. package/kits/hub-game/code/server/grab.js +12 -2
  153. package/kits/hub-game/code/server/heldOffers.js +142 -0
  154. package/kits/hub-game/code/server/holdShow.js +98 -0
  155. package/kits/hub-game/code/server/hub.js +991 -72
  156. package/kits/hub-game/code/server/idle.js +110 -9
  157. package/kits/hub-game/code/server/index.js +9 -0
  158. package/kits/hub-game/code/server/labels.js +13 -3
  159. package/kits/hub-game/code/server/manifest.js +94 -6
  160. package/kits/hub-game/code/server/menu.js +26 -3
  161. package/kits/hub-game/code/server/npcs.js +55 -9
  162. package/kits/hub-game/code/server/observe.js +67 -6
  163. package/kits/hub-game/code/server/players.js +14 -2
  164. package/kits/hub-game/code/server/replay.js +135 -0
  165. package/kits/hub-game/code/server/standing.js +7 -3
  166. package/kits/hub-game/code/server/storageLimit.js +4 -1
  167. package/kits/hub-game/code/server/townDay.js +74 -0
  168. package/kits/hub-game/code/server/vehicle.js +3 -0
  169. package/kits/hub-game/code/server/vis.js +26 -4
  170. package/kits/hub-game/code/server/wallet.js +677 -0
  171. package/kits/hub-game/code/server/wear.js +13 -3
  172. package/kits/hub-game/code/server/writerLease.js +191 -0
  173. package/kits/hub-game/code/shared/act.js +1 -1
  174. package/kits/hub-game/code/shared/expression.js +6 -0
  175. package/kits/hub-game/code/shared/replay.js +37 -0
  176. package/kits/hub-game/code/systems/hub.js +429 -55
  177. package/kits/hub-game/docs/analytics.md +16 -2
  178. package/kits/hub-game/docs/contract.md +956 -101
  179. package/kits/hub-game/docs/home-pieces.md +5 -6
  180. package/kits/hub-game/docs/observed-progress.md +49 -1
  181. package/kits/hub-game/docs/vehicle-preset.md +23 -0
  182. package/kits/hub-game/index.html +1 -0
  183. package/kits/hub-game/models/hats/baker-cap.pxmodel +3 -3
  184. package/kits/hub-game/models/hats/bat-clip.pxmodel +3 -3
  185. package/kits/hub-game/models/hats/beekeeper.pxmodel +3 -3
  186. package/kits/hub-game/models/hats/cap.pxmodel +3 -3
  187. package/kits/hub-game/models/hats/captain.pxmodel +3 -3
  188. package/kits/hub-game/models/hats/chef-toque.pxmodel +3 -3
  189. package/kits/hub-game/models/hats/crooked-top.pxmodel +3 -3
  190. package/kits/hub-game/models/hats/delivery-cap.pxmodel +3 -3
  191. package/kits/hub-game/models/hats/fire-helmet.pxmodel +3 -3
  192. package/kits/hub-game/models/hats/flower-crown.pxmodel +3 -3
  193. package/kits/hub-game/models/hats/foam-crown.pxmodel +3 -3
  194. package/kits/hub-game/models/hats/hard-hat.pxmodel +3 -3
  195. package/kits/hub-game/models/hats/lantern.pxmodel +3 -3
  196. package/kits/hub-game/models/hats/laurel.pxmodel +3 -3
  197. package/kits/hub-game/models/hats/lighthouse.pxmodel +3 -3
  198. package/kits/hub-game/models/hats/nurse-cap.pxmodel +3 -3
  199. package/kits/hub-game/models/hats/police-cap.pxmodel +3 -3
  200. package/kits/hub-game/models/hats/sailor.pxmodel +3 -3
  201. package/kits/hub-game/models/hats/souwester.pxmodel +3 -3
  202. package/kits/hub-game/models/hats/straw.pxmodel +3 -3
  203. package/kits/hub-game/models/hats/sunflower.pxmodel +3 -3
  204. package/kits/hub-game/models/hats/sweatband.pxmodel +3 -3
  205. package/kits/hub-game/models/hats/teacher-beret.pxmodel +3 -3
  206. package/kits/hub-game/models/hats/witch.pxmodel +3 -3
  207. package/kits/hub-game/models/hold-show/daisy.pxmodel +231 -0
  208. package/kits/hub-game/models/hold-show/moonflower.pxmodel +171 -0
  209. package/kits/hub-game/models/hold-show/rose.pxmodel +191 -0
  210. package/kits/hub-game/models/hold-show/square/daisy.pxmodel +233 -0
  211. package/kits/hub-game/models/hold-show/square/moonflower.pxmodel +173 -0
  212. package/kits/hub-game/models/hold-show/square/rose.pxmodel +193 -0
  213. package/kits/hub-game/models/hold-show/square/sunflower.pxmodel +313 -0
  214. package/kits/hub-game/models/hold-show/square/tulip.pxmodel +133 -0
  215. package/kits/hub-game/models/hold-show/sunflower.pxmodel +311 -0
  216. package/kits/hub-game/models/hold-show/tulip.pxmodel +131 -0
  217. package/kits/hub-game/package-lock.json +3 -3
  218. package/kits/hub-game/package.json +4 -3
  219. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +1 -0
  220. package/kits/hub-game/scripts/fixtures/hud-surface.json +12 -12
  221. package/kits/hub-game/scripts/fixtures/talk-surface.json +8 -8
  222. package/kits/hub-game/scripts/gen-hats.mjs +1 -1
  223. package/kits/hub-game/scripts/gen-hold-show.mjs +27 -0
  224. package/kits/hub-game/scripts/pack.mjs +89 -23
  225. package/kits/hub-game/scripts/test-act-client.mjs +5 -0
  226. package/kits/hub-game/scripts/test-act-core.mjs +32 -0
  227. package/kits/hub-game/scripts/test-act-gate.mjs +186 -0
  228. package/kits/hub-game/scripts/test-action-rail-crowded-dom.mjs +7 -1
  229. package/kits/hub-game/scripts/test-action-rail-default-dom.mjs +102 -0
  230. package/kits/hub-game/scripts/test-action-rail-never-silent-dom.mjs +50 -0
  231. package/kits/hub-game/scripts/test-action-rail-surface.mjs +368 -0
  232. package/kits/hub-game/scripts/test-action-rail-town-jobs-dom.mjs +118 -0
  233. package/kits/hub-game/scripts/test-actions-client.mjs +5 -3
  234. package/kits/hub-game/scripts/test-actions.mjs +24 -0
  235. package/kits/hub-game/scripts/test-actors.mjs +19 -0
  236. package/kits/hub-game/scripts/test-again-corner-dom.mjs +59 -0
  237. package/kits/hub-game/scripts/test-analytics.mjs +79 -0
  238. package/kits/hub-game/scripts/test-arrival-pose-server.mjs +25 -8
  239. package/kits/hub-game/scripts/test-ask-client.mjs +9 -0
  240. package/kits/hub-game/scripts/test-ask-surface.mjs +188 -0
  241. package/kits/hub-game/scripts/test-attention.mjs +43 -1
  242. package/kits/hub-game/scripts/test-ballot-sheet-dom.mjs +71 -0
  243. package/kits/hub-game/scripts/test-ballot-surface.mjs +276 -0
  244. package/kits/hub-game/scripts/test-ballot.mjs +421 -4
  245. package/kits/hub-game/scripts/test-ban-join.mjs +1 -1
  246. package/kits/hub-game/scripts/test-celebrate-client.mjs +62 -0
  247. package/kits/hub-game/scripts/test-celebrate.mjs +116 -0
  248. package/kits/hub-game/scripts/test-chat.mjs +73 -0
  249. package/kits/hub-game/scripts/test-companion-client.mjs +203 -21
  250. package/kits/hub-game/scripts/test-companion.mjs +110 -3
  251. package/kits/hub-game/scripts/test-control-layout-dom.mjs +57 -10
  252. package/kits/hub-game/scripts/test-corner-surface.mjs +268 -0
  253. package/kits/hub-game/scripts/test-decor-client.mjs +59 -3
  254. package/kits/hub-game/scripts/test-decor.mjs +27 -0
  255. package/kits/hub-game/scripts/test-device-class.mjs +4 -1
  256. package/kits/hub-game/scripts/test-disguise-client.mjs +281 -0
  257. package/kits/hub-game/scripts/test-disguise.mjs +176 -0
  258. package/kits/hub-game/scripts/test-dock-surface.mjs +404 -0
  259. package/kits/hub-game/scripts/test-door-stay-client.mjs +602 -0
  260. package/kits/hub-game/scripts/test-door-stay.mjs +613 -0
  261. package/kits/hub-game/scripts/test-earned-client.mjs +119 -0
  262. package/kits/hub-game/scripts/test-emote-surface.mjs +616 -0
  263. package/kits/hub-game/scripts/test-fps-telemetry.mjs +39 -4
  264. package/kits/hub-game/scripts/test-friend-bests.mjs +38 -12
  265. package/kits/hub-game/scripts/test-ghost-click-dom.mjs +75 -0
  266. package/kits/hub-game/scripts/test-grab-client.mjs +29 -2
  267. package/kits/hub-game/scripts/test-grab-orbit.mjs +260 -11
  268. package/kits/hub-game/scripts/test-grab.mjs +10 -1
  269. package/kits/hub-game/scripts/test-hats.mjs +28 -0
  270. package/kits/hub-game/scripts/test-held-offers.mjs +394 -0
  271. package/kits/hub-game/scripts/test-high-only.mjs +3 -3
  272. package/kits/hub-game/scripts/test-hold-show-client.mjs +175 -0
  273. package/kits/hub-game/scripts/test-hold-show.mjs +355 -0
  274. package/kits/hub-game/scripts/test-hub-controls.mjs +3 -1
  275. package/kits/hub-game/scripts/test-hub-idle.mjs +348 -0
  276. package/kits/hub-game/scripts/test-hub-leaving.mjs +21 -0
  277. package/kits/hub-game/scripts/test-hub-ops.mjs +119 -0
  278. package/kits/hub-game/scripts/test-hub-trip.mjs +240 -4
  279. package/kits/hub-game/scripts/test-hud-clear.mjs +83 -0
  280. package/kits/hub-game/scripts/test-hud-rate.mjs +2 -1
  281. package/kits/hub-game/scripts/test-idle.mjs +160 -0
  282. package/kits/hub-game/scripts/test-invites-client.mjs +53 -0
  283. package/kits/hub-game/scripts/test-labels.mjs +11 -0
  284. package/kits/hub-game/scripts/test-landscape-layout.mjs +20 -0
  285. package/kits/hub-game/scripts/test-loading-cover.mjs +67 -1
  286. package/kits/hub-game/scripts/test-manifest.mjs +27 -0
  287. package/kits/hub-game/scripts/test-menu-client.mjs +54 -5
  288. package/kits/hub-game/scripts/test-menu-surface.mjs +236 -0
  289. package/kits/hub-game/scripts/test-npcs.mjs +128 -0
  290. package/kits/hub-game/scripts/test-observed.mjs +171 -3
  291. package/kits/hub-game/scripts/test-pack.mjs +166 -0
  292. package/kits/hub-game/scripts/test-pad-cues.mjs +39 -0
  293. package/kits/hub-game/scripts/test-picker-surface.mjs +321 -0
  294. package/kits/hub-game/scripts/test-placeat-server.mjs +648 -0
  295. package/kits/hub-game/scripts/test-placement-cache.mjs +1 -1
  296. package/kits/hub-game/scripts/test-pointer-clear-dom.mjs +82 -0
  297. package/kits/hub-game/scripts/test-progress-reset.mjs +184 -6
  298. package/kits/hub-game/scripts/test-push-visit.mjs +9 -0
  299. package/kits/hub-game/scripts/test-quality.mjs +312 -9
  300. package/kits/hub-game/scripts/test-quick-chat-surface.mjs +511 -0
  301. package/kits/hub-game/scripts/test-rehello.mjs +242 -3
  302. package/kits/hub-game/scripts/test-rejoin-yaw.mjs +138 -0
  303. package/kits/hub-game/scripts/test-relations-among.mjs +13 -7
  304. package/kits/hub-game/scripts/test-relations-refresh.mjs +90 -2
  305. package/kits/hub-game/scripts/test-replay-client.mjs +110 -0
  306. package/kits/hub-game/scripts/test-replay.mjs +178 -0
  307. package/kits/hub-game/scripts/test-resume-held.mjs +13 -0
  308. package/kits/hub-game/scripts/test-resume-pose-server.mjs +43 -5
  309. package/kits/hub-game/scripts/test-role-client.mjs +2 -1
  310. package/kits/hub-game/scripts/test-safe-act.mjs +233 -0
  311. package/kits/hub-game/scripts/test-safe-caption.mjs +364 -0
  312. package/kits/hub-game/scripts/test-safe-layout.mjs +79 -0
  313. package/kits/hub-game/scripts/test-safe-prompt.mjs +163 -0
  314. package/kits/hub-game/scripts/test-sound-surface.mjs +256 -0
  315. package/kits/hub-game/scripts/test-soundscape.mjs +85 -2
  316. package/kits/hub-game/scripts/test-standing.mjs +135 -2
  317. package/kits/hub-game/scripts/test-stuck-surface.mjs +174 -0
  318. package/kits/hub-game/scripts/test-stuck.mjs +36 -1
  319. package/kits/hub-game/scripts/test-talk-surface.mjs +23 -6
  320. package/kits/hub-game/scripts/test-talk-walk-dom.mjs +123 -0
  321. package/kits/hub-game/scripts/test-text-ask-surface.mjs +273 -0
  322. package/kits/hub-game/scripts/test-tiers.mjs +453 -3
  323. package/kits/hub-game/scripts/test-toast-no-row-dom.mjs +71 -0
  324. package/kits/hub-game/scripts/test-together.mjs +11 -0
  325. package/kits/hub-game/scripts/test-town-day.mjs +90 -0
  326. package/kits/hub-game/scripts/test-try-on.mjs +39 -0
  327. package/kits/hub-game/scripts/test-ui-dom-dom.mjs +49 -2
  328. package/kits/hub-game/scripts/test-ui-tree.mjs +28 -0
  329. package/kits/hub-game/scripts/test-vehicle-client.mjs +68 -1
  330. package/kits/hub-game/scripts/test-vis.mjs +145 -0
  331. package/kits/hub-game/scripts/test-wallet.mjs +650 -0
  332. package/kits/hub-game/scripts/test-weakest-tier.mjs +135 -1
  333. package/kits/hub-game/scripts/test-world-labels.mjs +340 -0
  334. package/kits/hub-game/scripts/test-writer-lease-server.mjs +234 -0
  335. package/kits/hub-game/scripts/test-writer-lease.mjs +281 -0
  336. package/kits/hub-game/scripts/writer-storage-fixture.mjs +37 -0
  337. package/kits/hub-game/tools/hubScene/export.mjs +6 -5
  338. package/kits/hub-game/tools/hubScene/hubdata.mjs +10 -0
  339. package/kits/hub-game/tools/hubScene/test/export-fixture.mjs +36 -2
  340. package/kits/hub-game/tools/hubScene/validate-manifest.mjs +10 -2
  341. package/kits/multiplayer-3d/castle.json +5 -5
  342. package/kits/multiplayer-3d/code/client/resumeGate.js +66 -2
  343. package/kits/multiplayer-3d/code/server/ownership.js +25 -6
  344. package/kits/multiplayer-3d/code/server/world.js +19 -4
  345. package/kits/multiplayer-3d/code/systems/multiplayer.js +108 -18
  346. package/kits/multiplayer-3d/package-lock.json +1 -1
  347. package/kits/multiplayer-3d/package.json +2 -1
  348. package/kits/multiplayer-3d/scripts/test-ground-half.mjs +56 -0
  349. package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +54 -3
  350. package/kits/multiplayer-3d/scripts/test-owned-moves.mjs +190 -0
  351. package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +417 -5
  352. package/kits/multiplayer-3d/scripts/test-resync-reconnect.mjs +68 -0
  353. package/kits/physics-2d/castle.json +2 -2
  354. package/kits/physics-2d/engine/scene.js +10 -2
  355. package/kits/physics-3d/CLAUDE.md +14 -0
  356. package/kits/physics-3d/behaviors/Player.jsx +39 -3
  357. package/kits/physics-3d/castle.json +3 -3
  358. package/kits/physics-3d/docs/engine-model-cache.md +109 -0
  359. package/kits/physics-3d/docs/engine-player.md +76 -0
  360. package/kits/physics-3d/docs/engine-skip-work.md +16 -0
  361. package/kits/physics-3d/docs/pxmodel-format.md +5 -1
  362. package/kits/physics-3d/engine3d/gait.js +16 -8
  363. package/kits/physics-3d/engine3d/groundsize.js +23 -0
  364. package/kits/physics-3d/engine3d/kithooks.js +50 -0
  365. package/kits/physics-3d/engine3d/look.js +110 -17
  366. package/kits/physics-3d/engine3d/lookbake.js +19 -1
  367. package/kits/physics-3d/engine3d/materialpresets.js +3 -2
  368. package/kits/physics-3d/engine3d/modelcache.js +280 -0
  369. package/kits/physics-3d/engine3d/modelcachedigest.js +37 -0
  370. package/kits/physics-3d/engine3d/modelcachegate.js +69 -0
  371. package/kits/physics-3d/engine3d/modelrefs.js +13 -0
  372. package/kits/physics-3d/engine3d/optimize.js +20 -9
  373. package/kits/physics-3d/engine3d/playerRun.js +26 -1
  374. package/kits/physics-3d/engine3d/pxmodel.js +7 -3
  375. package/kits/physics-3d/engine3d/templatecache.js +722 -0
  376. package/kits/physics-3d/engine3d/world3d.js +211 -17
  377. package/kits/physics-3d/package-lock.json +1 -1
  378. package/kits/physics-3d/package.json +2 -1
  379. package/kits/physics-3d/play/behaviors/Player.js +43 -3
  380. package/kits/physics-3d/scripts/render.mjs +56 -8
  381. package/kits/physics-3d/scripts/template-cache-fixtures.mjs +37 -0
  382. package/kits/physics-3d/scripts/template-cache-v1-bytes.json +49 -0
  383. package/kits/physics-3d/scripts/test-coaxial-escape.mjs +176 -0
  384. package/kits/physics-3d/scripts/test-gait.mjs +53 -9
  385. package/kits/physics-3d/scripts/test-ground-half.mjs +120 -0
  386. package/kits/physics-3d/scripts/test-model-cache.mjs +600 -0
  387. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +1 -0
  388. package/kits/physics-3d/scripts/test-sleeping-models.mjs +384 -0
  389. package/kits/physics-3d/scripts/test-template-cache-minified.mjs +106 -0
  390. package/kits/physics-3d/scripts/test-template-cache.mjs +519 -0
  391. package/kits/physics-3d/scripts/test-wall-slide.mjs +272 -0
  392. package/kits/physics-3d/systems/physics3d.js +59 -2
  393. package/kits/real-time/castle.json +2 -2
  394. package/kits/real-time/code/client/connection.js +3 -0
  395. package/package.json +2 -2
  396. package/vendor/three/examples/jsm/libs/fflate.module.js +2672 -0
@@ -1,6 +1,7 @@
1
1
  // v1.71 companion: real place hooks, private delivery and public presence.
2
2
  import assert from 'node:assert/strict';
3
3
  import { register } from 'node:module';
4
+ import { readFileSync } from 'node:fs';
4
5
 
5
6
  register(`data:text/javascript,${encodeURIComponent(`
6
7
  import { readFile } from 'node:fs/promises';
@@ -9,7 +10,7 @@ register(`data:text/javascript,${encodeURIComponent(`
9
10
  if (url.endsWith('/code/server/hub.js?without-companion')) {
10
11
  let source = await readFile(fileURLToPath(url), 'utf8');
11
12
  source = source.split('\\n').filter((line) => !line.includes('import * as Companion') && !line.includes('...(' + 'h.place.companion')).join('\\n');
12
- source = source.replace(/\\s*if \\(h.place.companion === true(?: && h.companionUsed)?\\) \\{[^{}]*\\}(?: else \\{[^{}]*\\})?/g, '');
13
+ source = source.replace(/\\s*if \\(h.place.companion === true(?: && h.companion(?:Shown)?Used)?\\) \\{[^{}]*\\}(?: else \\{[^{}]*\\})?/g, '');
13
14
  if (source.includes('Companion.')) throw new Error('baseline still has a companion code path');
14
15
  return { format: 'module', source, shortCircuit: true };
15
16
  }
@@ -48,7 +49,7 @@ function boot(keys = {}, options = {}) {
48
49
  removeActor(sim, id) { sim.bodies.delete(id); sim.objects.delete(id); },
49
50
  };
50
51
  globalThis.__hubTestActors = structuredClone(actors);
51
- const server = (options.layer ?? layer)(json(keys), hooks, {}, () => true, () => null, null, engine);
52
+ const server = (options.layer ?? layer)(json({ ...(options.title ? { title: options.title } : {}), ...keys }), hooks, {}, () => true, () => null, null, engine);
52
53
  const session = { sessionId: options.sessionId ?? 'dev', players: [...players], hub: options.platform ?? null, send(id, msg) { sent.push([id, structuredClone(msg)]); }, broadcast(msg) { sent.push(['all', structuredClone(msg)]); } };
53
54
  const world = { timeMs: 0, scenePath: 'scenes/main.scene', objects: new Map(), bodies: new Map(), players: new Map(players.map((p) => [p.playerId, { at: { x: 0, y: 1, z: 0 }, facing: 0, body: { setTranslation() {} } }])) };
54
55
  server.sceneFor(session);
@@ -116,6 +117,112 @@ await test('v1.78 show pose validates privately and absent pose preserves litera
116
117
  assert.throws(() => r.hub.companion('p1', { look: 'bird', pose: 'bad' }), TypeError);
117
118
  assert.deepEqual(offer(r).c, { look: 'bird', pose: 'show' });
118
119
  });
120
+
121
+ await test('v1.181 shown is bird-only, true-only, copied and read once', async () => {
122
+ const { check } = await import('../code/companionSpec.js');
123
+ assert.deepEqual(check({ look: 'bird', shown: true }), { look: 'bird', shown: true });
124
+ for (const shown of [undefined, null, false, 0, 1, '', 'true', [], {}]) {
125
+ assert.throws(() => check({ look: 'bird', shown }), TypeError);
126
+ }
127
+ assert.throws(() => check({ look: 'lantern', shown: true }), TypeError);
128
+ let reads = 0;
129
+ check({ look: 'bird', get shown() { reads++; return true; } });
130
+ assert.equal(reads, 1);
131
+ assert.deepEqual(check(Object.assign(Object.create(null), { look: 'bird', shown: true })), { look: 'bird', shown: true });
132
+ const r = boot({ companion: true });
133
+ assert.equal(r.hub.companionShown, true);
134
+ assert(!Object.hasOwn(boot().hub, 'companionShown'));
135
+ const c = { look: 'bird', shown: true, dress: { species: 'owl', wear: 'bow', tint: 'mint' } };
136
+ r.hub.companion('p1', c); c.dress.tint = 'rose'; r.tick(250);
137
+ for (const bad of [false, undefined, null]) {
138
+ assert.throws(() => r.hub.companion('p1', { look: 'bird', shown: bad }), TypeError);
139
+ }
140
+ assert.deepEqual(r.server.join().hubChirp, [['p1', 'owl', 'bow', 'mint']]);
141
+ assert.deepEqual(offer(r).c, { look: 'bird', dress: { species: 'owl', wear: 'bow', tint: 'mint' } });
142
+ assert(!Object.hasOwn(offer(r).c, 'shown'), 'old clients receive the same private spec shape');
143
+ const flags = r.server.join().hubPlace;
144
+ assert(!Object.hasOwn(flags, 'companionShown'));
145
+ });
146
+ await test('v1.181 public dress sorts, latches, coalesces at four/s and never carries private fields', () => {
147
+ const r = boot({ companion: true });
148
+ assert(!Object.hasOwn(r.server.join(), 'hubChirp'));
149
+ assert(!Object.hasOwn(r.server.delta(), 'hubChirp'));
150
+ r.hub.companion('p2', { look: 'bird', shown: true });
151
+ r.hub.companion('p1', { look: 'bird', shown: true, dress: { species: 'owl', wear: 'bow', tint: 'mint' }, say: 'private words', at: 'private-target', pose: 'show' });
152
+ r.tick(250);
153
+ const rows = [['p1', 'owl', 'bow', 'mint'], ['p2', null, null, null]];
154
+ assert.deepEqual(r.server.join().hubChirp, rows);
155
+ assert.deepEqual(r.server.delta().hubChirp, rows);
156
+ assert.equal(r.server.delta(), null);
157
+ // Words, pose and target may change privately without a public delta.
158
+ r.hub.companion('p1', { look: 'bird', shown: true, dress: { species: 'owl', wear: 'bow', tint: 'mint' } }); r.tick(250);
159
+ assert.equal(r.server.delta(), null);
160
+ for (let i = 0; i < 24; i++) {
161
+ r.hub.companion('p1', { look: 'bird', shown: true, dress: { tint: i % 2 ? 'gold' : 'rose' } });
162
+ r.tick(10);
163
+ assert.equal(r.server.delta(), null);
164
+ assert.deepEqual(r.server.join().hubChirp, rows);
165
+ }
166
+ r.tick(10);
167
+ assert.deepEqual(r.server.delta().hubChirp, [['p1', null, null, 'gold'], rows[1]]);
168
+ assert.equal(r.server.delta(), null);
169
+ // An unsent intermediate dress never becomes public.
170
+ r.hub.companion('p1', { look: 'bird', shown: true, dress: { tint: 'rose' } });
171
+ r.hub.companion('p1', { look: 'bird', shown: true, dress: { tint: 'gold' } }); r.tick(250);
172
+ assert.equal(r.server.delta(), null);
173
+ r.hub.companion('p1', { look: 'bird' }); r.tick(250);
174
+ assert.deepEqual(r.server.delta().hubChirp, [rows[1]]);
175
+ r.hub.companion('p2', null); r.tick(250);
176
+ assert.deepEqual(r.server.join().hubChirp, []);
177
+ assert.deepEqual(r.server.delta().hubChirp, []);
178
+ assert.equal(r.server.delta(), null);
179
+ });
180
+ await test('v1.181 shown is cleared on leave, end and shutdown; empty snapshots stay latched', async () => {
181
+ for (const end of ['leave', 'end', 'shutdown']) {
182
+ const r = boot({ companion: true });
183
+ r.hub.companion('p1', { look: 'bird', shown: true }); r.tick(250); r.server.delta();
184
+ if (end === 'leave') { r.session.players = [players[1]]; r.world.players.delete('p1'); r.tick(); }
185
+ if (end === 'end') { r.hub.end(['p1']); r.tick(); }
186
+ if (end === 'shutdown') { await r.server.shutdown(); }
187
+ assert.deepEqual(r.server.join().hubChirp, []);
188
+ assert.deepEqual(r.server.delta().hubChirp, []);
189
+ }
190
+ });
191
+ await test('v1.181 resumePose replays shown to the same account and clears it for another', () => {
192
+ for (const changed of [false, true]) {
193
+ const r = boot({ companion: true, resumePose: true });
194
+ r.hub.companion('p1', { look: 'bird', shown: true, dress: { species: 'owl' } }); r.tick(250); r.server.delta();
195
+ const body = r.world.players.get('p1');
196
+ r.session.players = [players[1]]; r.world.players.delete('p1'); r.tick(30000);
197
+ assert.deepEqual(r.server.delta().hubChirp, []);
198
+ assert.equal(r.hub.companion('p1', { look: 'bird', shown: true, dress: { tint: 'mint' } }), true);
199
+ r.tick(30000);
200
+ assert.deepEqual(r.server.join().hubChirp, []);
201
+ const returning = { ...players[0], ...(changed ? { userId: '999', username: 'Other' } : {}) };
202
+ r.session.players.push(returning); r.world.players.set('p1', body); r.sent.length = 0;
203
+ r.say('p1', { k: 'hub-hello', resume: true }); r.tick();
204
+ assert.deepEqual(offer(r).c, changed ? null : { look: 'bird', dress: { tint: 'mint' } });
205
+ assert.deepEqual(r.server.join().hubChirp, changed ? [] : [['p1', null, null, 'mint']]);
206
+ if (!changed) {
207
+ r.session.players[r.session.players.findIndex(p => p.playerId === 'p1')] = { ...returning, userId: '999' };
208
+ r.tick(); assert.deepEqual(r.server.join().hubChirp, []);
209
+ }
210
+ }
211
+ });
212
+ await test('v1.181 absent shown preserves the literal pre-existing follower wire fixture', () => {
213
+ const captured = readFileSync(new URL('./companion-follower-wire.json', import.meta.url), 'utf8').trim();
214
+ for (const dress of [undefined, {}, { species: 'songbird' }]) {
215
+ const r = boot({ companion: true }, { title: 'Town' });
216
+ const states = [r.server.join(), r.server.delta()];
217
+ r.hub.companion('p1', { look: 'bird', say: 'Follow me', ...(dress ? { dress } : {}) }); r.tick(250);
218
+ states.push(r.server.join(), r.server.delta());
219
+ r.say('p1', { k: 'hub-npc-open', npc: 'companion:p1' });
220
+ r.say('p1', { k: 'hub-npc-say', npc: 'companion:p1', text: 'question' }); r.tick(250);
221
+ states.push(r.server.join(), r.server.delta());
222
+ assert.equal(JSON.stringify({ sent: r.sent, states }), captured);
223
+ }
224
+ });
225
+
119
226
  await test('manifest: place-only true or absent, including explicit undefined', () => {
120
227
  for (const named of [false, true]) {
121
228
  for (const value of [true, false, null, 0, 1, '', 'true', [], {}, undefined]) {
@@ -246,7 +353,6 @@ await test('keyless trace is byte-identical to a session with all companion bran
246
353
  const now = Date.now; Date.now = () => 100000;
247
354
  try { assert.equal(trace(layer), trace(baseline)); } finally { Date.now = now; }
248
355
  });
249
- console.log(`${passed} companion tests passed`);
250
356
 
251
357
  await test('an ended visit drops the follower: nothing of it is replayed on a later hello', () => {
252
358
  const r = boot({ companion: true });
@@ -257,3 +363,4 @@ await test('an ended visit drops the follower: nothing of it is replayed on a la
257
363
  assert.deepEqual(wire(r).filter(([, m]) => m.k === 'hub-companion'), []);
258
364
  assert.deepEqual(r.server.delta().hubGlow ?? [], []);
259
365
  });
366
+ console.log(`${passed} companion tests passed`);
@@ -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' });