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
@@ -1,7 +1,8 @@
1
1
  // The companion (v1.71): private follower, public shoulder glows; no actors.
2
+ import { disguiseBody } from './disguise.js';
2
3
  import * as THREE from 'three';
3
4
  import { check } from '../companionSpec.js';
4
- import { paperSpecies, dressBird } from './companionDress.js';
5
+ import { paperSpecies, dressBird, TINTS } from './companionDress.js';
5
6
  import { orbitFov } from '@imports/castle.physics-3d/engine3d/orbitlens.js';
6
7
 
7
8
  // As wear.js: the avatar origin is the capsule centre, feet 0.7 m below it.
@@ -16,6 +17,17 @@ export function sanitise(c) {
16
17
  return null;
17
18
  }
18
19
  }
20
+ // The public tuple has no speech, target or pose; reject malformed enum rows.
21
+ export function chirpMap(rows) {
22
+ const out = new Map();
23
+ for (const row of rows) {
24
+ if (!Array.isArray(row) || row.length !== 4 || typeof row[0] !== 'string') { continue; }
25
+ const dress = Object.fromEntries(['species', 'wear', 'tint'].flatMap((key, i) => row[i + 1] === null ? [] : [[key, row[i + 1]]]));
26
+ const c = sanitise({ look: 'bird', dress });
27
+ if (c) { out.set(row[0], c.dress ?? {}); }
28
+ }
29
+ return out;
30
+ }
19
31
  // yaw and t are radians and seconds, respectively; facing is +z at yaw 0.
20
32
  // Pure motion history: a target or speed >= 0.2 m/s resets the still timer.
21
33
  export function restStep(previous, player, dt, pointing = false) {
@@ -46,12 +58,15 @@ export function frontTarget(player, camera, t, panel, view, project, reach = 1.3
46
58
  const dx = length > 0.0001 ? (camera?.forward?.x ?? 0) / length : Math.sin(player.yaw ?? 0);
47
59
  const dz = length > 0.0001 ? (camera?.forward?.z ?? 0) / length : Math.cos(player.yaw ?? 0);
48
60
  const target = { x: player.x + reach * dx, y: player.y - 0.7 + 1.55 + 0.04 * Math.sin(t * Math.PI), z: player.z + reach * dz };
49
- const base = target.y;
61
+ Object.assign(target, liftClear(target, camera, dx, dz, panel, view, project));
62
+ return { ...target, yaw: Math.atan2(player.x - target.x, player.z - target.z) };
63
+ }
64
+ function liftClear(start, camera, dx, dz, panel, view, project) {
50
65
  // A far orbit or a tall panel can leave every lift covered: then the
51
66
  // on-screen candidate highest above the panel wins, not the last one tried.
52
67
  let best = null, bestY = Infinity;
53
68
  for (let lift = 0; lift <= 10; lift++) {
54
- const at = { x: player.x + reach * dx, y: base + lift * 0.2, z: player.z + reach * dz };
69
+ const at = { x: start.x, y: start.y + lift * 0.2, z: start.z };
55
70
  // Recheck after lifting: a raised target can otherwise enter the camera.
56
71
  if (camera?.position && Math.hypot(at.x - camera.position.x, at.y - camera.position.y, at.z - camera.position.z) < 0.9) {
57
72
  at.x += dx * 1.8;
@@ -73,11 +88,34 @@ export function frontTarget(player, camera, t, panel, view, project, reach = 1.3
73
88
  }
74
89
  best ??= lift === 0 ? at : best;
75
90
  }
76
- Object.assign(target, best);
77
- return { ...target, yaw: Math.atan2(player.x - target.x, player.z - target.z) };
91
+ return best;
78
92
  }
79
- export function chatTarget(player, camera, t, panel, view, project) {
80
- return frontTarget(player, camera, t, panel, view, project);
93
+ // Chat holds the bird on the sightline from the camera to the player's face,
94
+ // at the depth where its paper is CHAT_SHARE of view height (as showTarget
95
+ // sizes the show pose): a spot past the player only shrinks with the orbit.
96
+ // Without a camera position, assume the 6 m orbit behind the camera forward.
97
+ export const CHAT_SHARE = 0.09;
98
+ export function chatTarget(player, camera, t, panel, view, project, size = 0.2) {
99
+ const length = Math.hypot(camera?.forward?.x ?? 0, camera?.forward?.z ?? 0);
100
+ const dx = length > 0.0001 ? (camera?.forward?.x ?? 0) / length : Math.sin(player.yaw ?? 0);
101
+ const dz = length > 0.0001 ? (camera?.forward?.z ?? 0) / length : Math.cos(player.yaw ?? 0);
102
+ const face = { x: player.x, y: player.y - 0.7 + 1.55 + 0.04 * Math.sin(t * Math.PI), z: player.z };
103
+ const eye = camera?.position ?? { x: face.x - 6 * dx, y: face.y, z: face.z - 6 * dz };
104
+ const sight = { x: face.x - eye.x, y: face.y - eye.y, z: face.z - eye.z };
105
+ const reach = Math.hypot(sight.x, sight.y, sight.z), flat = Math.hypot(sight.x, sight.z);
106
+ const tan = Math.tan((Number.isFinite(camera?.fov) ? camera.fov : 70) * Math.PI / 360);
107
+ // 1 m leaves a margin over liftClear's 0.9 m camera check; stop 0.9 m short
108
+ // of the player across the ground.
109
+ const minimum = Math.max(1, (camera?.near ?? 0.1) + 0.3);
110
+ const maximum = flat > 0.0001 ? (flat - 0.9) * reach / flat : 0;
111
+ // A camera tight behind the player, or looking away from them, has no room
112
+ // between: there the bird is small on screen anyway, so keep the old spot.
113
+ if (maximum < minimum || sight.x * dx + sight.z * dz <= 0) { return frontTarget(player, camera, t, panel, view, project); }
114
+ const d = Math.max(minimum, Math.min(maximum, size / (2 * tan * CHAT_SHARE)));
115
+ const start = { x: eye.x + d * sight.x / reach, y: eye.y + d * sight.y / reach, z: eye.z + d * sight.z / reach };
116
+ const target = liftClear(start, camera, dx, dz, panel, view, project);
117
+ // Face the lens, as the old spot past the player did.
118
+ return { ...target, yaw: Math.atan2(eye.x - target.x, eye.z - target.z) };
81
119
  }
82
120
  function showAxes(camera) {
83
121
  const forward = new THREE.Vector3(camera.forward.x, camera.forward.y ?? 0, camera.forward.z).normalize();
@@ -125,6 +163,21 @@ function showBounds(offsets, depth, side, lift, tan, aspect) {
125
163
  }
126
164
  return { left, right, bottom, top };
127
165
  }
166
+ // Where a player's left side projects, in view units: its centre less a body
167
+ // half-width at its depth. Landscape keeps the show box left of this, so a
168
+ // close menu camera (the wardrobe) never puts Chirp over the player.
169
+ const PLAYER_HALF_WIDTH = 0.4;
170
+ function playerLeft(from, forward, right, tan, aspect) {
171
+ const depth = from.dot(forward);
172
+ return (from.dot(right) - PLAYER_HALF_WIDTH) / (depth * tan * aspect);
173
+ }
174
+ // The landscape box's right edge: `margin` left of the player's left side,
175
+ // unless that leaves under 5% of view width beside the left inset (the
176
+ // player at the left edge), when the box keeps the inset-only edge.
177
+ function landscapeEdge(left, inset, margin) {
178
+ const edge = Math.min(inset, left - margin);
179
+ return edge + inset < 0.1 ? inset : edge;
180
+ }
128
181
  function showInside(pos, player, camera, view, vertices, t) {
129
182
  const { forward, right, up } = showAxes(camera);
130
183
  const offset = new THREE.Vector3(pos.x - camera.position.x, pos.y - camera.position.y, pos.z - camera.position.z);
@@ -135,7 +188,8 @@ function showInside(pos, player, camera, view, vertices, t) {
135
188
  Math.tan(camera.fov * Math.PI / 360), view.w / view.h);
136
189
  const playerOffset = new THREE.Vector3(player.x - camera.position.x, player.y - camera.position.y, player.z - camera.position.z);
137
190
  const playerX = playerOffset.dot(right) / (playerOffset.dot(forward) * Math.tan(camera.fov * Math.PI / 360) * view.w / view.h);
138
- const rightEdge = view.h > view.w ? Math.min(0.92, playerX - 0.04) : 0.92;
191
+ const rightEdge = view.h > view.w ? Math.min(0.92, playerX - 0.04)
192
+ : landscapeEdge(playerLeft(playerOffset, forward, right, Math.tan(camera.fov * Math.PI / 360), view.w / view.h), 0.92, 0.04);
139
193
  return b.left >= -0.92 && b.right <= rightEdge && b.bottom >= -0.92 && b.top <= 0.92;
140
194
  }
141
195
  // Fit paper and wear, excluding glow. Centre the projected box, not its origin:
@@ -144,7 +198,7 @@ export function showTarget(player, camera, view, size, radius = 0, vertices = nu
144
198
  const { forward, right, up } = showAxes(camera);
145
199
  const tan = Math.tan(camera.fov * Math.PI / 360), aspect = view.w / view.h;
146
200
  const portrait = view.h > view.w;
147
- const centreX = portrait ? -0.46 : -0.3;
201
+ let centreX = portrait ? -0.46 : -0.3;
148
202
  const centreY = portrait ? 0.2 : 0.1;
149
203
  let side = centreX * tan * aspect, lift = centreY * tan;
150
204
  const from = new THREE.Vector3(player.x - camera.position.x, player.y - camera.position.y, player.z - camera.position.z);
@@ -160,14 +214,22 @@ export function showTarget(player, camera, view, size, radius = 0, vertices = nu
160
214
  const offsets = showOffsets(camera, vertices, t, side, lift);
161
215
  const bounds = (depth) => showBounds(offsets, depth, side, lift, tan, aspect);
162
216
  // Keep the whole box inside the inset and left of the player by 2%
163
- // of view width in portrait; reduce height for a wider silhouette.
217
+ // of view width: of its centre in portrait, of its left side in
218
+ // landscape. Reduce height for a wider silhouette.
164
219
  const playerX = from.dot(right) / (from.dot(forward) * tan * aspect);
165
- const edge = view.h > view.w ? Math.min(0.919, playerX - 0.041) : 0.919;
166
- const width = 2 * Math.min(centreX + 0.919, edge - centreX);
220
+ const edge = view.h > view.w ? Math.min(0.919, playerX - 0.041) : landscapeEdge(playerLeft(from, forward, right, tan, aspect), 0.919, 0.041);
221
+ let width = 2 * Math.min(centreX + 0.919, edge - centreX);
167
222
  const fits = (depth) => {
168
223
  const b = bounds(depth);
169
224
  return b.top - b.bottom <= 0.66 && b.right - b.left <= width;
170
225
  };
226
+ // A close landscape shot leaves too little room right of the usual
227
+ // spot even at the farthest depth: centre the box in the strip left of
228
+ // the player instead.
229
+ if (!portrait && !fits(maximum) && centreX > (edge - 0.919) / 2) {
230
+ centreX = (edge - 0.919) / 2;
231
+ width = 2 * Math.min(centreX + 0.919, edge - centreX);
232
+ }
171
233
  if (fits(minimum)) { d = minimum; }
172
234
  else if (!fits(maximum)) { d = maximum; }
173
235
  else {
@@ -212,8 +274,8 @@ function safeShow(pos, player, camera, radius) {
212
274
  if (side.length() > room) { side.setLength(room); offset.copy(side).addScaledVector(forward, safeDepth); }
213
275
  return { x: camera.position.x + offset.x, y: camera.position.y + offset.y, z: camera.position.z + offset.z };
214
276
  }
215
- export function motionTarget(player, pointAt, t, resting, chat) {
216
- return chat ? chatTarget(player, chat.camera, t, chat.panel, chat.view, chat.project) : followTarget(player, pointAt, t, resting);
277
+ export function motionTarget(player, pointAt, t, resting, chat, size) {
278
+ return chat ? chatTarget(player, chat.camera, t, chat.panel, chat.view, chat.project, size) : followTarget(player, pointAt, t, resting);
217
279
  }
218
280
  export function leadTarget(player, pointAt, t) {
219
281
  if (!pointAt || Math.hypot(pointAt.x - player.x, pointAt.z - player.z) > LEASH) { return null; }
@@ -473,7 +535,7 @@ export function makeCompanion({ idle = false } = {}) {
473
535
  return {
474
536
  clear,
475
537
  dispose: clear,
476
- frame(scene, local, hub, dt, now, visible, chat = null, busy = false, framing = null) {
538
+ frame(scene, local, hub, dt, now, visible, chat = null, busy = false, framing = null, low = false) {
477
539
  if (world !== scene.three) {
478
540
  clear();
479
541
  world = scene.three;
@@ -562,7 +624,7 @@ export function makeCompanion({ idle = false } = {}) {
562
624
  const nextLeading = route?.id ?? null;
563
625
  if (nextLeading !== leading) { flightFrom = pos; leading = nextLeading; }
564
626
  const view = framing?.view ?? chat?.view ?? { w: cam?.aspect ?? 1, h: 1 };
565
- const target = show ? showTarget(player, camera, view, follower.userData.size, follower.userData.radius, follower.userData.showVertices, now / 1000) : route?.pos ?? motionTarget(player, pointAt, now / 1000, resting, talking);
627
+ const target = show ? showTarget(player, camera, view, follower.userData.size, follower.userData.radius, follower.userData.showVertices, now / 1000) : route?.pos ?? motionTarget(player, pointAt, now / 1000, resting, talking, follower.userData.size);
566
628
  const flying = Boolean(route || flightFrom);
567
629
  if (show && showHeld && showCamera && pos) { pos = carryShow(pos, showCamera, camera); }
568
630
  if (show && !showHeld) {
@@ -615,7 +677,8 @@ export function makeCompanion({ idle = false } = {}) {
615
677
  }
616
678
  const dx = !flying && pointAt ? pointAt.x - pos.x : before ? pos.x - before.x : 0;
617
679
  const dz = !flying && pointAt ? pointAt.z - pos.z : before ? pos.z - before.z : 0;
618
- if (talking) { ry = yawTo(pos, player); }
680
+ // Between the camera and the player, chat faces the lens (target.yaw).
681
+ if (talking) { ry = target.yaw ?? yawTo(pos, player); }
619
682
  else if (route) { ry = route.yaw; }
620
683
  else if (resting && !flying) { ry = player.yaw; }
621
684
  else if (Math.hypot(dx, dz) > 0.0001) { ry = Math.atan2(dx, dz); }
@@ -679,28 +742,35 @@ export function makeCompanion({ idle = false } = {}) {
679
742
  ));}
680
743
  }
681
744
  }
745
+ const others = new Set([...(hub.glow ?? []), ...(hub.chirp?.keys() ?? [])]);
746
+ // The viewer's avatar map already applies the blocked-pair rule. Drop
747
+ // decorations immediately even if an old avatar node is still fading.
748
+ for (const id of others) { if ((hub.avatars && !hub.avatars.has(id)) || disguiseBody(self, id)) { others.delete(id); } }
749
+ const publicLook = (id) => JSON.stringify([low, hub.chirp?.get(id) ?? null]);
682
750
  for (const [id, entry] of glows) {
683
751
  const actorId = scene.multiplayer?.avatars?.actors?.get(id);
684
- if (!hub.glow?.has(id) || id === self || nodes?.get(actorId)?.node !== entry.parent) {
752
+ if (!others.has(id) || id === self || nodes?.get(actorId)?.node !== entry.parent || entry.look !== publicLook(id)) {
685
753
  remove(entry.node);
686
754
  glows.delete(id);
687
755
  }
688
756
  }
689
- for (const id of hub.glow ?? []) {
757
+ for (const id of others) {
690
758
  const actorId = scene.multiplayer?.avatars?.actors?.get(id);
691
759
  const parent = id !== self && actorId ? nodes?.get(actorId)?.node : null;
692
760
  if (parent && !glows.has(id)) {
693
- const node = mesh(new THREE.OctahedronGeometry(0.09), '#ffd27a', true);
761
+ const dress = hub.chirp?.get(id);
762
+ const node = dress && !low ? build('bird', dress)
763
+ : mesh(new THREE.OctahedronGeometry(0.09), TINTS[dress?.tint] ?? '#ffd27a', true);
764
+ if (dress && !low) { node.scale.multiplyScalar(0.6); }
694
765
  node.position.set(0.4, HEIGHT, 0);
695
766
  parent.add(node);
696
- glows.set(id, { node, parent });
767
+ glows.set(id, { node, parent, look: publicLook(id) });
697
768
  }
698
769
  }
699
770
  for (const { node } of glows.values()) {
700
771
  node.visible = visible && hub.place?.companion === true;
701
772
  }
702
- // tiers.js only visits scene actors: these root/child nodes are neither
703
- // counted nor culled on Low; glows still hide with their avatar parent.
773
+ // Child nodes inherit avatar hiding, block removal and quality culling.
704
774
  },
705
775
  screen(cam, view, project) {
706
776
  return follower?.visible && pos ? project(cam, pos.x, pos.y, pos.z, view) : null;
@@ -1,6 +1,6 @@
1
1
  // v1.78: folded paper additions; the undressed songbird stays in companion.js.
2
2
  import * as THREE from 'three';
3
- const TINTS = { rose: '#ee91ad', mint: '#87d8b0', midnight: '#39436b', gold: '#eab94e' };
3
+ export const TINTS = { rose: '#ee91ad', mint: '#87d8b0', midnight: '#39436b', gold: '#eab94e' };
4
4
  const PAPER = { owl: '#98704b', parrot: '#4caf68', hummingbird: '#45bba1' };
5
5
 
6
6
  export function paperSpecies(group, species, mesh, triangle) {
@@ -0,0 +1,106 @@
1
+ // The corner surface: the Grab button, the Horn, the invite button and the
2
+ // stats line (`cornerTree.js`) with the behaviour `chrome.js` gives them in
3
+ // the DOM (`onGrab`, `grabPrompt`, `hornPrompt`, `nearPrompt`, `setStats`,
4
+ // `setActMode`), published as the
5
+ // `corner` UI tree root. No DOM and no window: a native host says these as
6
+ // the hub system says them to the chrome, and its own handlers stay the
7
+ // senders -- the Horn's `{ k: 'hub-horn' }`, the invite button's
8
+ // `{ k: 'hub-party', op: 'invite', player }`. The web chrome does not use it.
9
+ //
10
+ // makeCornerSurface({ view, draw }):
11
+ // view() the stage: { landscape, safeInsets, lift };
12
+ // draw(tree) called with each root built (only when it changed).
13
+ import { publishUiRoot } from './uiTree.js';
14
+ import { buildCorner } from './cornerTree.js';
15
+
16
+ export function makeCornerSurface({ view = () => ({}), draw = null } = {}) {
17
+ let hornHandler = null;
18
+ let grabHandler = () => {};
19
+ let grab = null;
20
+ let actMode = false;
21
+ let nearHandler = () => {};
22
+ let near = null;
23
+ let stats = null;
24
+ let blocked = false;
25
+ let covered = false;
26
+ let key = '';
27
+ let disposed = false;
28
+
29
+ const on = {
30
+ grab: () => grabHandler(),
31
+ horn: () => hornHandler?.(),
32
+ near: () => nearHandler(),
33
+ };
34
+
35
+ function render() {
36
+ if (disposed) {return;}
37
+ const v = view() ?? {};
38
+ const state = {
39
+ view: { landscape: Boolean(v.landscape), safeInsets: Boolean(v.safeInsets), lift: Number(v.lift) || 0 },
40
+ grab: hornHandler ? null : grab, horn: Boolean(hornHandler), near: near && !blocked ? near : null, stats, covered,
41
+ };
42
+ const next = JSON.stringify(state);
43
+ if (next === key) {return;}
44
+ key = next;
45
+ const tree = buildCorner(state, on);
46
+ publishUiRoot('corner', tree);
47
+ draw?.(tree);
48
+ }
49
+
50
+ render();
51
+ return {
52
+ // chrome `hornPrompt`: the Horn in the Grab button's place; a press
53
+ // calls `handler`. Any `grabPrompt` takes it away.
54
+ hornPrompt(handler) {
55
+ hornHandler = typeof handler === 'function' ? handler : null;
56
+ render();
57
+ },
58
+ // chrome `onGrab`: what a press of the Grab button calls (grab.js).
59
+ onGrab(handler) {
60
+ grabHandler = typeof handler === 'function' ? handler : () => {};
61
+ },
62
+ // chrome `grabPrompt`: the Grab button's words ("Grab" or "Throw"), or
63
+ // null to hide it; the Horn goes. Under Act (`setActMode`) the Act slot
64
+ // offers grabbing instead, and the button is never drawn.
65
+ grabPrompt(text) {
66
+ hornHandler = null;
67
+ grab = actMode || (text !== 'Grab' && text !== 'Throw') ? null : text;
68
+ render();
69
+ },
70
+ // chrome `setActMode`: a deck with `act` (v1.127) takes Grab off the corner.
71
+ setActMode(value) {
72
+ actMode = Boolean(value);
73
+ if (actMode) {grab = null;}
74
+ render();
75
+ },
76
+ // chrome `nearPrompt`: the invite button's words, or null to hide it; a
77
+ // press calls `handler`.
78
+ nearPrompt(text, handler) {
79
+ near = text ? String(text) : null;
80
+ if (text && typeof handler === 'function') {nearHandler = handler;}
81
+ render();
82
+ },
83
+ // chrome `setStats`: the stats text, or null / '' to hide it.
84
+ setStats(text) {
85
+ stats = text ? String(text) : null;
86
+ render();
87
+ },
88
+ // Quick chat, the emote row or wheel, or a People / Doors list is open:
89
+ // the invite button is not drawn over it.
90
+ setBlocked(value) {
91
+ blocked = Boolean(value);
92
+ render();
93
+ },
94
+ // The Character sheet is open over the rail.
95
+ setCovered(value) {
96
+ covered = Boolean(value);
97
+ render();
98
+ },
99
+ render,
100
+ dispose() {
101
+ if (disposed) {return;}
102
+ disposed = true;
103
+ publishUiRoot('corner', null);
104
+ },
105
+ };
106
+ }
@@ -0,0 +1,83 @@
1
+ // The corner's context buttons and the stats line (`chrome.js`
2
+ // `grabPrompt`, `hornPrompt`, `nearPrompt`, `setStats`) as a UI tree
3
+ // (schema v0): the Grab button (v1.3, "Grab" or "Throw", in a place with
4
+ // `grab` and no `act`), the Horn in its place while this player drives a car
5
+ // with one (the vehicle preset), the invite button for the player stood
6
+ // beside ("+ Party · name"), and the debug stats line top right. The same
7
+ // words, sizes and states as the DOM. Sit / Stand is the emote surface's
8
+ // (`emoteTree.js`). Pure: no DOM, no window; the web chrome still draws its
9
+ // own.
10
+ //
11
+ // The buttons sit in the right-hand rail (`at.rail`, as the HUD's Act/Jump
12
+ // pair does), in the chrome's rail order: the Horn in Grab's place (order
13
+ // 1), the invite button last (order 6) and, upright, centred above the
14
+ // Talk button where the DOM puts it.
15
+ //
16
+ // state = {
17
+ // view: { landscape, safeInsets, lift } (`lift` the Shift lock's lift of
18
+ // the corner, 0 without one);
19
+ // grab: null, or the Grab button's words ("Grab" or "Throw"); the Horn,
20
+ // when offered, takes its place (chrome.js's one button);
21
+ // horn: the Horn is offered;
22
+ // near: null or the invite button's words;
23
+ // stats: null or the stats text (lines split on '\n');
24
+ // covered: the Character sheet is open over the rail (the Horn and the
25
+ // invite button are out of sight, as layPicker hides them);
26
+ // }
27
+ // on = { grab(), horn(), near() }.
28
+ import { h } from './uiTree.js';
29
+
30
+ const ROOT = { font: 'ui', size: 15, weight: 600, lh: 1.3, color: '#fff' };
31
+ const edge = (safeInsets, px) => (safeInsets ? [px, 0] : px);
32
+ export const RAIL = 'right';
33
+ export const RAIL_ORDER = { grab: 1, horn: 1, near: 6 };
34
+ // chrome.js grabPrompt's Throw colours; Grab is the Horn's.
35
+ const THROW = { bg: 'rgba(233,196,143,0.92)', color: '#2b2118' };
36
+
37
+ // The stats text as its lines: the DOM's `white-space: pre` keeps each
38
+ // '\n' a line break and no line wraps; each line is one unwrapped text.
39
+ export const statsLines = (text) => String(text ?? '').split('\n');
40
+
41
+ export function buildCorner(state, on = {}) {
42
+ const view = state.view ?? {};
43
+ const landscape = Boolean(view.landscape);
44
+ const lift = landscape ? 0 : Number(view.lift) || 0;
45
+ const covered = Boolean(state.covered);
46
+ const round = landscape ? 56 : 76;
47
+ const grab = state.horn ? null : state.grab === 'Grab' || state.grab === 'Throw' ? state.grab : null;
48
+ return h('stack', { key: 'corner', style: ROOT },
49
+ grab ? h('button', {
50
+ key: 'grab', fire: 'down',
51
+ at: { anchor: 'bottomRight', right: edge(view.safeInsets, 14), bottom: [60 + lift, 50 + lift], rail: { name: RAIL, order: RAIL_ORDER.grab } },
52
+ style: {
53
+ box: 'border', w: round, h: round, radius: round / 2, border: { w: 2, c: 'rgba(255,255,255,0.55)' }, bg: 'copy', color: '#fff',
54
+ font: 'ui', size: 16, weight: 800, lh: 'normal', ...(grab === 'Throw' ? THROW : {}), ...(covered ? { hidden: true } : {}),
55
+ },
56
+ on: { tap: on.grab },
57
+ }, grab) : null,
58
+ state.horn ? h('button', {
59
+ key: 'horn', fire: 'down',
60
+ at: { anchor: 'bottomRight', right: edge(view.safeInsets, 14), bottom: [60 + lift, 50 + lift], rail: { name: RAIL, order: RAIL_ORDER.horn } },
61
+ style: {
62
+ box: 'border', w: round, h: round, radius: round / 2, border: { w: 2, c: 'rgba(255,255,255,0.55)' }, bg: 'copy', color: '#fff',
63
+ font: 'ui', size: 16, weight: 800, lh: 'normal', ...(covered ? { hidden: true } : {}),
64
+ },
65
+ on: { tap: on.horn },
66
+ }, 'Horn') : null,
67
+ state.near ? h('button', {
68
+ key: 'near', fire: 'down',
69
+ at: landscape
70
+ ? { anchor: 'bottomRight', right: edge(view.safeInsets, 12), bottom: [160, 150], rail: { name: RAIL, order: RAIL_ORDER.near } }
71
+ : { anchor: 'bottom', bottom: [160, 150] },
72
+ style: {
73
+ pad: [6, 14], radius: 16, border: { w: 1, c: 'line40' }, bg: 'copy', color: '#fff', font: 'ui', size: 13, weight: 600, lh: 'normal',
74
+ maxW: landscape ? [{ vw: 38 }, { px: 160 }] : [{ vw: 80 }], lines: 1, ...(covered ? { hidden: true } : {}),
75
+ },
76
+ on: { tap: on.near },
77
+ }, String(state.near)) : null,
78
+ state.stats ? h('column', {
79
+ key: 'stats',
80
+ at: { anchor: 'topRight', right: edge(view.safeInsets, 8), top: [8, 0] },
81
+ style: { font: 'mono', size: 11, weight: 400, lh: 1.3, opacity: 0.7, talign: 'end', align: 'end', hit: 'none' },
82
+ }, statsLines(state.stats).map((line, i) => h('text', { key: `l${i}`, text: line, style: { wrap: 'none' } }))) : null);
83
+ }
@@ -19,7 +19,9 @@ function el(tag, style, parent, text) {
19
19
  return node;
20
20
  }
21
21
 
22
- export function makeDecor(chrome, { renderer = () => new THREE.WebGLRenderer({ alpha: true, antialias: true, preserveDrawingBuffer: true }) } = {}) {
22
+ // `refuse` (v1.204) is true, having said why, when an edit must wait on the
23
+ // server's progress read.
24
+ export function makeDecor(chrome, { renderer = () => new THREE.WebGLRenderer({ alpha: true, antialias: true, preserveDrawingBuffer: true }), refuse = () => false } = {}) {
23
25
  const geometry = chrome.layoutGeometry?.();
24
26
  const listeners = new AbortController();
25
27
  function button(parent, label, action, style = {}) {
@@ -32,6 +34,7 @@ export function makeDecor(chrome, { renderer = () => new THREE.WebGLRenderer({ a
32
34
  return node;
33
35
  }
34
36
  const root = el('div', { position: 'absolute', inset: '0', pointerEvents: 'none', zIndex: '3', display: 'none', color: '#fff', font: FONT }, chrome.decorRoot());
37
+ root.setAttribute('data-hub', 'decor');
35
38
  const enter = button(root, '', () => send({ op: 'button' }), { position: 'absolute', right: '12px', bottom: 'max(76px, calc(env(safe-area-inset-bottom) + 66px))', background: PAINT.gold, pointerEvents: 'auto', fontSize: '16px', padding: '12px 20px' });
36
39
  const header = el('div', { position: 'absolute', top: 'max(14px, env(safe-area-inset-top))', left: '50%', transform: 'translateX(-50%)', borderRadius: '24px', padding: '9px 14px', background: PAINT.panel, maxWidth: 'calc(100% - 28px)', boxSizing: 'border-box', textAlign: 'center', pointerEvents: 'auto' }, root);
37
40
  el('div', { fontSize: '20px', fontWeight: '700', whiteSpace: 'nowrap' }, header, 'Decorating');
@@ -70,7 +73,7 @@ export function makeDecor(chrome, { renderer = () => new THREE.WebGLRenderer({ a
70
73
  const plane = new THREE.Plane(new THREE.Vector3(0, 1, 0), 0);
71
74
 
72
75
  function send(op) {
73
- if (t.net) {
76
+ if (t.net && !refuse()) {
74
77
  t.net.send({ k: 'decor', ...op });
75
78
  }
76
79
  }
@@ -302,10 +305,16 @@ export function makeDecor(chrome, { renderer = () => new THREE.WebGLRenderer({ a
302
305
  node.setAttribute('aria-pressed', String(t.tab === tab.id));
303
306
  }
304
307
  button(tabRow, 'Done ✓', () => send({ op: 'close' }), { background: PAINT.green, flex: 'none', minHeight: '28px', padding: '5px 6px', fontSize: '11px', whiteSpace: 'nowrap', touchAction: 'pan-x' });
305
- const tile = (label, action) => button(tiles, '', action, { position: 'relative', flex: '0 0 64px', width: '64px', height: '80px', boxSizing: 'border-box', padding: '0', overflow: 'hidden', borderRadius: '10px', background: PAINT.tile, color: '#fff', display: 'flex', flexDirection: 'column', alignItems: 'stretch', touchAction: 'pan-x', fontSize: '12px' });
308
+ // 72 px tiles with two 11 px label lines fit every House piece's name and
309
+ // its unlock line ("Ship in a bottle", "Autumn post") without an ellipsis.
310
+ const tile = (label, action) => button(tiles, '', action, { position: 'relative', flex: '0 0 72px', width: '72px', height: '80px', boxSizing: 'border-box', padding: '0', overflow: 'hidden', borderRadius: '10px', background: PAINT.tile, color: '#fff', display: 'flex', flexDirection: 'column', alignItems: 'stretch', touchAction: 'pan-x', fontSize: '12px' });
306
311
  for (const item of t.spec.items.filter((i) => i.tab === t.tab)) {
307
312
  const node = tile(item.label, () => {
308
- if (item.locked || item.count === 0) {
313
+ if (item.locked || (!item.action && item.count === 0)) {
314
+ return;
315
+ }
316
+ if (item.action) {
317
+ send({ op: 'pick', item: item.id });
309
318
  return;
310
319
  }
311
320
  const at = t.scene.actorWith('Player')?.components.Transform ?? {};
@@ -314,21 +323,21 @@ export function makeDecor(chrome, { renderer = () => new THREE.WebGLRenderer({ a
314
323
  // A full layer still lets the owner preview a red footprint.
315
324
  lift({ item: item.id, x: cell?.x ?? 0, z: cell?.z ?? 0, rot: 0, layer: item.layer });
316
325
  });
317
- node.setAttribute('aria-label', `${item.label}${item.locked ? ` · Locked · ${item.locked.price}` : ` · ${item.count} spare`}`);
318
- node.disabled = Boolean(item.locked || item.count === 0);
319
- node.style.opacity = item.locked || item.count === 0 ? '0.65' : '1';
320
- const image = el('img', { width: '64px', height: '54px', flex: 'none', objectFit: 'contain', pointerEvents: 'none' }, node);
326
+ node.setAttribute('aria-label', `${item.label}${item.locked ? ` · Locked · ${item.locked.price}` : item.action ? ' · Action' : ` · ${item.count} spare`}`);
327
+ node.disabled = Boolean(item.locked || (!item.action && item.count === 0));
328
+ node.style.opacity = node.disabled ? '0.65' : '1';
329
+ const image = el('img', { width: '72px', height: '54px', minHeight: '0', flex: '1 1 auto', objectFit: 'contain', pointerEvents: 'none' }, node);
321
330
  image.alt = '';
322
331
  t.images.set(image, item.template);
323
- if (!item.locked && item.count >= 2) {
332
+ if (!item.action && !item.locked && item.count >= 2) {
324
333
  el('span', { position: 'absolute', top: '4px', left: '4px', background: PAINT.green, color: '#17241b', borderRadius: '9px', padding: '1px 5px', fontSize: '11px' }, node, `×${item.count}`);
325
334
  }
326
335
  if (item.locked) {
327
336
  el('span', { position: 'absolute', right: '4px', top: '4px', fontSize: '13px' }, node, '🔒');
328
337
  }
329
- el('div', { padding: item.locked ? '0 3px' : '5px 3px', lineHeight: item.locked ? '14px' : '16px', flex: 'none', background: 'rgba(0,0,0,0.15)', overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap' }, node, item.label);
338
+ el('div', { padding: item.locked ? '0 3px' : '2px 3px', fontSize: '11px', lineHeight: '12px', flex: 'none', background: 'rgba(0,0,0,0.15)', overflow: 'hidden', display: '-webkit-box', WebkitBoxOrient: 'vertical', WebkitLineClamp: '2', overflowWrap: 'anywhere' }, node, item.label);
330
339
  if (item.locked) {
331
- el('div', { padding: '0 3px', flex: 'none', color: PAINT.gold, fontSize: '11px', lineHeight: '12px', overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap' }, node, item.locked.price);
340
+ el('div', { padding: '0 3px', flex: 'none', color: PAINT.gold, fontSize: '10px', lineHeight: '12px', overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap' }, node, item.locked.price);
332
341
  }
333
342
  }
334
343
  for (const swatch of (t.spec.swatches ?? []).filter((s) => s.tab === t.tab)) {
@@ -0,0 +1,121 @@
1
+ // Where the kit keeps the little it remembers on a device (the tier mark, the
2
+ // Graphics pick, the sound settings). Normally that is the page's own
3
+ // localStorage, used exactly as before. On castle.xyz the deck runs in a
4
+ // sandboxed frame with no origin of its own, where localStorage throws on
5
+ // every access; there the values live in memory for the visit and are written
6
+ // through to the SDK's LocalCache, which the host page keeps in castle.xyz's
7
+ // origin for this deck. LocalCache is asynchronous and the readers are not, so
8
+ // a stored value only arrives once `prime` has fetched it: a reader that
9
+ // cannot wait adopts it when it comes (tiers.js, soundscape.js), and one that
10
+ // can waits for it, briefly (qualityEntry.js, before the first scene load).
11
+ //
12
+ // The SDK is imported only when the fallback first needs it, so a page with
13
+ // a working localStorage never loads LocalCache's path at all; an SDK without
14
+ // LocalCache (or one that cannot be loaded) leaves the fallback in memory
15
+ // only, for the visit.
16
+ const sdkCache = () => import('castle-web-sdk').then((sdk) => sdk.LocalCache);
17
+
18
+ // The fallback's LocalCache keys are the storage keys under this prefix.
19
+ export const CACHE_PREFIX = 'hub-storage/';
20
+ const PROBE_KEY = 'castle.hub.probe';
21
+
22
+ // The page's localStorage if it can really be written (a set and a remove
23
+ // that do not throw), else null. Reading the property alone is not enough: a
24
+ // private window may hand out a Storage whose writes throw.
25
+ export function usableLocalStorage(scope = globalThis) {
26
+ try {
27
+ const storage = scope.localStorage;
28
+ if (!storage) {
29
+ return null;
30
+ }
31
+ storage.setItem(PROBE_KEY, '1');
32
+ storage.removeItem(PROBE_KEY);
33
+ return storage;
34
+ } catch {
35
+ return null;
36
+ }
37
+ }
38
+
39
+ // A Storage-like object over memory that writes through to the LocalCache
40
+ // `loadCache` resolves to (called once, on first use). `prime(keys)`
41
+ // fetches those keys' stored values once and resolves to the set of keys it
42
+ // adopted: a key written or removed here before its value came back keeps what
43
+ // was written, since that is the newer word.
44
+ export function makeCachedStorage(loadCache = sdkCache) {
45
+ const values = new Map();
46
+ const written = new Set();
47
+ const fetched = new Map();
48
+ let loaded = null;
49
+ let writes = Promise.resolve();
50
+ const cache = () => (loaded ??= Promise.resolve().then(loadCache));
51
+ // Each write waits for the one before it to finish, since LocalCache's own
52
+ // writes do not land in the order they were called: two quick picks would
53
+ // otherwise leave the older one stored. A write that fails does not stop
54
+ // the next. No cache, or one that throws: the value is kept for this visit
55
+ // only.
56
+ const send = (call) => {
57
+ writes = writes.then(() => cache().then(call)).catch(() => {});
58
+ };
59
+ const fetchOne = (key) => {
60
+ let pending = fetched.get(key);
61
+ if (!pending) {
62
+ pending = (async () => {
63
+ try {
64
+ const text = await (await cache()).getText(CACHE_PREFIX + key);
65
+ if (typeof text === 'string' && !written.has(key)) {
66
+ values.set(key, text);
67
+ return true;
68
+ }
69
+ } catch {
70
+ // A miss.
71
+ }
72
+ return false;
73
+ })();
74
+ fetched.set(key, pending);
75
+ }
76
+ return pending;
77
+ };
78
+ return {
79
+ getItem: (key) => (values.has(key) ? values.get(key) : null),
80
+ setItem(key, value) {
81
+ const text = String(value);
82
+ values.set(key, text);
83
+ written.add(key);
84
+ send((c) => c.set(CACHE_PREFIX + key, text));
85
+ },
86
+ removeItem(key) {
87
+ values.delete(key);
88
+ written.add(key);
89
+ send((c) => c.remove(CACHE_PREFIX + key));
90
+ },
91
+ async prime(keys) {
92
+ const adopted = await Promise.all(keys.map(fetchOne));
93
+ // Asked again after the values came: a key written since is the
94
+ // player's, not the stored one.
95
+ return new Set(keys.filter((key, i) => adopted[i] && !written.has(key)));
96
+ },
97
+ };
98
+ }
99
+
100
+ // The page's localStorage where it works, looked for on each use as the
101
+ // readers always did (never as a module loads: a deck without tiers or a
102
+ // soundscape never touches storage at all); otherwise the kit's one fallback,
103
+ // so the tiers, the soundscape and the quality entry's wait share its values.
104
+ let fallback = null;
105
+ export function deviceStorage() {
106
+ return usableLocalStorage() ?? (fallback ??= makeCachedStorage());
107
+ }
108
+
109
+ // Fetches `keys` into a storage that needs it, waiting at most `waitMs`.
110
+ // Null when there is nothing to wait for (the page's own localStorage, or a
111
+ // storage without `prime`), so a caller that can skip the wait does.
112
+ export function primeDeviceStorage(keys, { storage = deviceStorage(), waitMs = 1000 } = {}) {
113
+ if (typeof storage?.prime !== 'function') {
114
+ return null;
115
+ }
116
+ let timer;
117
+ const late = new Promise((resolve) => {
118
+ timer = setTimeout(() => resolve(new Set()), waitMs);
119
+ });
120
+ return Promise.race([storage.prime(keys), late]).finally(() => clearTimeout(timer));
121
+ }