castle-web-cli 0.4.233 → 0.4.235

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 (383) hide show
  1. package/dist/api.d.ts +11 -0
  2. package/dist/api.js +43 -0
  3. package/dist/bundle.d.ts +64 -0
  4. package/dist/bundle.js +558 -2
  5. package/dist/castle-host/host.d.ts +17 -2
  6. package/dist/castle-host/host.js +793 -36
  7. package/dist/castleJson.d.ts +20 -1
  8. package/dist/castleJson.js +44 -2
  9. package/dist/check.js +9 -2
  10. package/dist/chunkLoader.d.ts +3 -0
  11. package/dist/chunkLoader.js +111 -0
  12. package/dist/devParty.d.ts +26 -0
  13. package/dist/devParty.js +231 -0
  14. package/dist/devSaveStorage.js +4 -0
  15. package/dist/devSessionStorage.js +3 -1
  16. package/dist/devSocial.d.ts +24 -0
  17. package/dist/devSocial.js +70 -0
  18. package/dist/ide.d.ts +2 -0
  19. package/dist/ide.js +119 -15
  20. package/dist/index.js +8 -2
  21. package/dist/init.js +1 -1
  22. package/dist/save-deck.d.ts +20 -1
  23. package/dist/save-deck.js +141 -5
  24. package/dist/serve.js +29 -11
  25. package/dist/shell/assets/{index-BjOxR-lW.js → index-DulbYIJm.js} +97 -97
  26. package/dist/shell/index.html +1 -1
  27. package/dist/vitePlugins.d.ts +2 -1
  28. package/dist/vitePlugins.js +13 -0
  29. package/kits/base/castle.json +1 -1
  30. package/kits/base/sdk/README.md +266 -3
  31. package/kits/base/sdk/castle.d.ts +7 -3
  32. package/kits/base/sdk/castle.js +2 -0
  33. package/kits/base/sdk/commands.d.ts +162 -1
  34. package/kits/base/sdk/commands.js +3 -0
  35. package/kits/base/sdk/display.d.ts +3 -0
  36. package/kits/base/sdk/display.js +9 -3
  37. package/kits/base/sdk/hub.d.ts +33 -6
  38. package/kits/base/sdk/hub.js +68 -5
  39. package/kits/base/sdk/hubRejoin.d.ts +4 -0
  40. package/kits/base/sdk/hubRejoin.js +15 -0
  41. package/kits/base/sdk/multiplayer.d.ts +7 -1
  42. package/kits/base/sdk/multiplayer.js +147 -40
  43. package/kits/base/sdk/multiplayerProtocol.d.ts +2 -0
  44. package/kits/base/sdk/party.d.ts +23 -0
  45. package/kits/base/sdk/party.js +91 -0
  46. package/kits/base/sdk/reconnectBudget.d.ts +23 -0
  47. package/kits/base/sdk/reconnectBudget.js +96 -0
  48. package/kits/base/sdk/save.d.ts +38 -1
  49. package/kits/base/sdk/save.js +79 -6
  50. package/kits/base/sdk/server/hub.d.ts +31 -1
  51. package/kits/base/sdk/server/hub.js +50 -3
  52. package/kits/base/sdk/server/platformHandle.d.ts +13 -1
  53. package/kits/base/sdk/server/storage.d.ts +4 -0
  54. package/kits/base/sdk/server/storage.js +19 -3
  55. package/kits/base/sdk/server/wrapper.d.ts +7 -1
  56. package/kits/base/sdk/server/wrapper.js +10 -1
  57. package/kits/base/sdk/social.d.ts +9 -0
  58. package/kits/base/sdk/social.js +5 -0
  59. package/kits/hub-game/CLAUDE.md +123 -3
  60. package/kits/hub-game/README.md +63 -0
  61. package/kits/hub-game/castle.json +5 -5
  62. package/kits/hub-game/code/client/act.js +312 -0
  63. package/kits/hub-game/code/client/actionLayout.js +147 -0
  64. package/kits/hub-game/code/client/actionOverflow.js +556 -0
  65. package/kits/hub-game/code/client/arrivalCamera.js +50 -0
  66. package/kits/hub-game/code/client/askSlot.js +117 -0
  67. package/kits/hub-game/code/client/avatar.js +4 -2
  68. package/kits/hub-game/code/client/avatarShare.js +2 -0
  69. package/kits/hub-game/code/client/backVisibility.js +13 -0
  70. package/kits/hub-game/code/client/ballot.js +15 -10
  71. package/kits/hub-game/code/client/build.js +16 -0
  72. package/kits/hub-game/code/client/chat.js +41 -5
  73. package/kits/hub-game/code/client/chatModeration.js +5 -0
  74. package/kits/hub-game/code/client/chrome.js +1148 -258
  75. package/kits/hub-game/code/client/crowdNames.js +241 -0
  76. package/kits/hub-game/code/client/decor.js +10 -4
  77. package/kits/hub-game/code/client/defaultEnvironment.js +194 -0
  78. package/kits/hub-game/code/client/doorErrors.js +39 -0
  79. package/kits/hub-game/code/client/fall.js +18 -0
  80. package/kits/hub-game/code/client/farAvatars.js +233 -0
  81. package/kits/hub-game/code/client/firstJoin.js +9 -2
  82. package/kits/hub-game/code/client/fpsTelemetry.js +50 -0
  83. package/kits/hub-game/code/client/frameBatch.js +5 -0
  84. package/kits/hub-game/code/client/grab.js +31 -11
  85. package/kits/hub-game/code/client/hookLayer.js +87 -8
  86. package/kits/hub-game/code/client/hudCopy.js +51 -0
  87. package/kits/hub-game/code/client/hudRate.js +20 -0
  88. package/kits/hub-game/code/client/idle.js +14 -2
  89. package/kits/hub-game/code/client/invites.js +231 -0
  90. package/kits/hub-game/code/client/joinError.js +9 -0
  91. package/kits/hub-game/code/client/labelsNear.js +31 -2
  92. package/kits/hub-game/code/client/landscapeLayout.js +17 -0
  93. package/kits/hub-game/code/client/layoutCache.js +264 -0
  94. package/kits/hub-game/code/client/loadTelemetry.js +20 -0
  95. package/kits/hub-game/code/client/loadingCover.js +148 -0
  96. package/kits/hub-game/code/client/loadingEntry.js +8 -0
  97. package/kits/hub-game/code/client/menuRows.js +43 -0
  98. package/kits/hub-game/code/client/modelReady.js +7 -0
  99. package/kits/hub-game/code/client/padCueArrival.js +23 -0
  100. package/kits/hub-game/code/client/padCues.js +112 -0
  101. package/kits/hub-game/code/client/padOccupancy.js +88 -0
  102. package/kits/hub-game/code/client/padReadability.js +26 -0
  103. package/kits/hub-game/code/client/padRings.js +69 -0
  104. package/kits/hub-game/code/client/pushVisit.js +14 -0
  105. package/kits/hub-game/code/client/quality.js +205 -0
  106. package/kits/hub-game/code/client/qualityEntry.js +55 -0
  107. package/kits/hub-game/code/client/safeLayout.js +338 -0
  108. package/kits/hub-game/code/client/safeStyle.js +42 -0
  109. package/kits/hub-game/code/client/say.js +12 -3
  110. package/kits/hub-game/code/client/shot.js +64 -10
  111. package/kits/hub-game/code/client/shotFit.js +56 -0
  112. package/kits/hub-game/code/client/signIn.js +28 -0
  113. package/kits/hub-game/code/client/state.js +53 -0
  114. package/kits/hub-game/code/client/talk.js +209 -45
  115. package/kits/hub-game/code/client/tiers.js +68 -66
  116. package/kits/hub-game/code/client/together.js +7 -2
  117. package/kits/hub-game/code/client/weakestLookBake.js +92 -0
  118. package/kits/hub-game/code/client/weakestTier.js +295 -0
  119. package/kits/hub-game/code/client/worldLabels.js +241 -0
  120. package/kits/hub-game/code/client/yours.js +10 -9
  121. package/kits/hub-game/code/npcDisplayText.js +55 -0
  122. package/kits/hub-game/code/server/act.js +124 -0
  123. package/kits/hub-game/code/server/actions.js +6 -1
  124. package/kits/hub-game/code/server/actors.js +2 -1
  125. package/kits/hub-game/code/server/analytics.js +83 -0
  126. package/kits/hub-game/code/server/anonymousEntry.js +49 -0
  127. package/kits/hub-game/code/server/arrivalPose.js +36 -0
  128. package/kits/hub-game/code/server/companion.js +28 -3
  129. package/kits/hub-game/code/server/doorAnalytics.js +52 -0
  130. package/kits/hub-game/code/server/earned.js +22 -5
  131. package/kits/hub-game/code/server/frameBatch.js +183 -0
  132. package/kits/hub-game/code/server/friendsAmong.js +49 -9
  133. package/kits/hub-game/code/server/history.js +2 -0
  134. package/kits/hub-game/code/server/hub.js +1306 -95
  135. package/kits/hub-game/code/server/idle.js +30 -1
  136. package/kits/hub-game/code/server/index.js +26 -4
  137. package/kits/hub-game/code/server/invites.js +19 -0
  138. package/kits/hub-game/code/server/labels.js +9 -1
  139. package/kits/hub-game/code/server/loadAbandon.js +106 -0
  140. package/kits/hub-game/code/server/manifest.js +211 -3
  141. package/kits/hub-game/code/server/menu.js +31 -3
  142. package/kits/hub-game/code/server/npcs.js +226 -64
  143. package/kits/hub-game/code/server/observe.js +408 -0
  144. package/kits/hub-game/code/server/padOccupancy.js +85 -0
  145. package/kits/hub-game/code/server/players.js +9 -1
  146. package/kits/hub-game/code/server/resumePose.js +152 -0
  147. package/kits/hub-game/code/server/say.js +1 -1
  148. package/kits/hub-game/code/server/standing.js +4 -5
  149. package/kits/hub-game/code/server/storageLimit.js +187 -0
  150. package/kits/hub-game/code/server/vis.js +67 -5
  151. package/kits/hub-game/code/shared/act.js +35 -0
  152. package/kits/hub-game/code/shared/danceIdle.js +28 -0
  153. package/kits/hub-game/code/shared/loadStages.js +12 -0
  154. package/kits/hub-game/code/shared/quality.js +74 -0
  155. package/kits/hub-game/code/shared/say.js +2 -0
  156. package/kits/hub-game/code/shared/shot.js +35 -1
  157. package/kits/hub-game/code/systems/hub.js +970 -169
  158. package/kits/hub-game/docs/analytics.md +279 -0
  159. package/kits/hub-game/docs/contract.md +1259 -42
  160. package/kits/hub-game/docs/home-pieces.md +9 -2
  161. package/kits/hub-game/docs/observed-progress.md +252 -0
  162. package/kits/hub-game/main.jsx +2 -0
  163. package/kits/hub-game/package-lock.json +10 -3
  164. package/kits/hub-game/package.json +6 -3
  165. package/kits/hub-game/play/player.js +142 -0
  166. package/kits/hub-game/play/registry.js +47 -0
  167. package/kits/hub-game/play.jsx +37 -0
  168. package/kits/hub-game/scripts/check.mjs +39 -5
  169. package/kits/hub-game/scripts/companion-follower-wire.json +1 -1
  170. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +11 -0
  171. package/kits/hub-game/scripts/fixtures/decor-keyless.json +5 -5
  172. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +3 -0
  173. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +19 -3
  174. package/kits/hub-game/scripts/fixtures/interest-legacy.json +3 -3
  175. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -1
  176. package/kits/hub-game/scripts/pose-storage-fixture.mjs +46 -0
  177. package/kits/hub-game/scripts/test-act-client.mjs +186 -0
  178. package/kits/hub-game/scripts/test-act.mjs +171 -0
  179. package/kits/hub-game/scripts/test-action-layout.mjs +80 -0
  180. package/kits/hub-game/scripts/test-action-observers.mjs +46 -0
  181. package/kits/hub-game/scripts/test-actions-client.mjs +367 -2
  182. package/kits/hub-game/scripts/test-actors.mjs +20 -7
  183. package/kits/hub-game/scripts/test-analytics.mjs +76 -0
  184. package/kits/hub-game/scripts/test-anonymous-entry.mjs +28 -0
  185. package/kits/hub-game/scripts/test-arrival-pose-server.mjs +196 -0
  186. package/kits/hub-game/scripts/test-arrival-pose.mjs +24 -0
  187. package/kits/hub-game/scripts/test-ask-slot.mjs +85 -0
  188. package/kits/hub-game/scripts/test-avatar-wire.mjs +49 -10
  189. package/kits/hub-game/scripts/test-avatar.mjs +44 -0
  190. package/kits/hub-game/scripts/test-back-visibility.mjs +82 -0
  191. package/kits/hub-game/scripts/test-ballot.mjs +11 -4
  192. package/kits/hub-game/scripts/test-ban-join.mjs +121 -13
  193. package/kits/hub-game/scripts/test-build.mjs +20 -2
  194. package/kits/hub-game/scripts/test-chat.mjs +206 -5
  195. package/kits/hub-game/scripts/test-companion-chat.mjs +20 -2
  196. package/kits/hub-game/scripts/test-control-layout-dom.mjs +120 -0
  197. package/kits/hub-game/scripts/test-crowd-names.mjs +205 -0
  198. package/kits/hub-game/scripts/test-decor-client.mjs +45 -4
  199. package/kits/hub-game/scripts/test-decor.mjs +7 -0
  200. package/kits/hub-game/scripts/test-default-environment-root.mjs +95 -0
  201. package/kits/hub-game/scripts/test-default-environment.mjs +267 -0
  202. package/kits/hub-game/scripts/test-door-analytics.mjs +58 -0
  203. package/kits/hub-game/scripts/test-door-jump.mjs +100 -0
  204. package/kits/hub-game/scripts/test-earned.mjs +33 -3
  205. package/kits/hub-game/scripts/test-far-avatars.mjs +340 -0
  206. package/kits/hub-game/scripts/test-fps-telemetry.mjs +112 -0
  207. package/kits/hub-game/scripts/test-frame-batch.mjs +252 -0
  208. package/kits/hub-game/scripts/test-fresh-friends.mjs +118 -0
  209. package/kits/hub-game/scripts/test-grab-orbit.mjs +47 -4
  210. package/kits/hub-game/scripts/test-high-only.mjs +170 -0
  211. package/kits/hub-game/scripts/test-hub-ops.mjs +321 -2
  212. package/kits/hub-game/scripts/test-hub-trip.mjs +879 -11
  213. package/kits/hub-game/scripts/test-hud-clear.mjs +162 -59
  214. package/kits/hub-game/scripts/test-hud-defects-dom.mjs +100 -0
  215. package/kits/hub-game/scripts/test-hud-rate.mjs +224 -0
  216. package/kits/hub-game/scripts/test-hud-safe-visibility-dom.mjs +83 -0
  217. package/kits/hub-game/scripts/test-idle.mjs +66 -0
  218. package/kits/hub-game/scripts/test-interest-cells.mjs +20 -0
  219. package/kits/hub-game/scripts/test-interest.mjs +15 -0
  220. package/kits/hub-game/scripts/test-invites-client.mjs +430 -0
  221. package/kits/hub-game/scripts/test-invites.mjs +109 -0
  222. package/kits/hub-game/scripts/test-labels.mjs +71 -3
  223. package/kits/hub-game/scripts/test-landscape-layout.mjs +194 -0
  224. package/kits/hub-game/scripts/test-list-scroll-dom.mjs +49 -0
  225. package/kits/hub-game/scripts/test-load-abandon.mjs +246 -0
  226. package/kits/hub-game/scripts/test-loading-cover.mjs +162 -0
  227. package/kits/hub-game/scripts/test-manifest.mjs +265 -0
  228. package/kits/hub-game/scripts/test-menu-client.mjs +105 -0
  229. package/kits/hub-game/scripts/test-menu.mjs +23 -0
  230. package/kits/hub-game/scripts/test-npcs.mjs +917 -10
  231. package/kits/hub-game/scripts/test-observed.mjs +745 -0
  232. package/kits/hub-game/scripts/test-pad-cues.mjs +304 -0
  233. package/kits/hub-game/scripts/test-pad-occupancy.mjs +177 -0
  234. package/kits/hub-game/scripts/test-picker.mjs +234 -7
  235. package/kits/hub-game/scripts/test-placement-cache.mjs +690 -0
  236. package/kits/hub-game/scripts/test-progress-reset.mjs +559 -0
  237. package/kits/hub-game/scripts/test-push-visit.mjs +26 -0
  238. package/kits/hub-game/scripts/test-quality.mjs +385 -0
  239. package/kits/hub-game/scripts/test-rehello.mjs +699 -5
  240. package/kits/hub-game/scripts/test-resume-action-order.mjs +598 -0
  241. package/kits/hub-game/scripts/test-resume-held.mjs +239 -0
  242. package/kits/hub-game/scripts/test-resume-pose.mjs +142 -0
  243. package/kits/hub-game/scripts/test-safe-events-dom.mjs +116 -0
  244. package/kits/hub-game/scripts/test-safe-layout.mjs +330 -0
  245. package/kits/hub-game/scripts/test-say.mjs +1 -1
  246. package/kits/hub-game/scripts/test-shot.mjs +145 -0
  247. package/kits/hub-game/scripts/test-signin-client.mjs +45 -0
  248. package/kits/hub-game/scripts/test-soundscape.mjs +22 -17
  249. package/kits/hub-game/scripts/test-standing.mjs +35 -2
  250. package/kits/hub-game/scripts/test-storage-limit.mjs +333 -0
  251. package/kits/hub-game/scripts/test-stuck.mjs +5 -4
  252. package/kits/hub-game/scripts/test-talk-overlay-dom.mjs +130 -0
  253. package/kits/hub-game/scripts/test-tiers-render.mjs +86 -13
  254. package/kits/hub-game/scripts/test-tiers.mjs +7 -8
  255. package/kits/hub-game/scripts/test-vis.mjs +433 -6
  256. package/kits/hub-game/scripts/test-weakest-tier.mjs +924 -0
  257. package/kits/hub-game/scripts/test-world-labels.mjs +367 -0
  258. package/kits/hub-game/scripts/test-yours-chrome.mjs +50 -6
  259. package/kits/hub-game/scripts/test-yours.mjs +39 -8
  260. package/kits/multiplayer-3d/castle.json +5 -5
  261. package/kits/multiplayer-3d/code/client/joinFailure.js +27 -0
  262. package/kits/multiplayer-3d/code/client/resumeGate.js +139 -0
  263. package/kits/multiplayer-3d/code/systems/multiplayer.js +369 -30
  264. package/kits/multiplayer-3d/package-lock.json +8 -1
  265. package/kits/multiplayer-3d/package.json +2 -1
  266. package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +436 -0
  267. package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +624 -0
  268. package/kits/physics-2d/CLAUDE.md +10 -1
  269. package/kits/physics-2d/castle.json +2 -2
  270. package/kits/physics-2d/engine/frozenActors.js +233 -0
  271. package/kits/physics-2d/engine/scene.js +87 -5
  272. package/kits/physics-2d/eslint.config.js +1 -1
  273. package/kits/physics-2d/play/behaviors/AnalogStick.js +198 -0
  274. package/kits/physics-2d/play/behaviors/Camera.js +40 -0
  275. package/kits/physics-2d/play/behaviors/Collider.js +122 -0
  276. package/kits/physics-2d/play/behaviors/Draggable.js +115 -0
  277. package/kits/physics-2d/play/behaviors/Goal.js +46 -0
  278. package/kits/physics-2d/play/behaviors/Joints.js +126 -0
  279. package/kits/physics-2d/play/behaviors/Layout.js +71 -0
  280. package/kits/physics-2d/play/behaviors/RigidBody.js +57 -0
  281. package/kits/physics-2d/play/behaviors/Slingshot.js +142 -0
  282. package/kits/physics-2d/play/behaviors/SoundPlayer.js +263 -0
  283. package/kits/physics-2d/play/behaviors/Sprite.js +406 -0
  284. package/kits/physics-2d/play/behaviors/Style.js +209 -0
  285. package/kits/physics-2d/play/behaviors/Text.js +85 -0
  286. package/kits/physics-2d/play/behaviors/Video.js +93 -0
  287. package/kits/physics-3d/CLAUDE.md +25 -1651
  288. package/kits/physics-3d/behaviors/Body.jsx +3 -0
  289. package/kits/physics-3d/behaviors/Model.jsx +3 -0
  290. package/kits/physics-3d/behaviors/Player.jsx +35 -18
  291. package/kits/physics-3d/behaviors/Shape.jsx +3 -0
  292. package/kits/physics-3d/behaviors/Solid.jsx +3 -0
  293. package/kits/physics-3d/behaviors/Transform.jsx +3 -0
  294. package/kits/physics-3d/castle.json +3 -3
  295. package/kits/physics-3d/docs/engine-camera.md +542 -0
  296. package/kits/physics-3d/docs/engine-frame-cap.md +136 -0
  297. package/kits/physics-3d/docs/engine-load.md +149 -0
  298. package/kits/physics-3d/docs/engine-look.md +114 -0
  299. package/kits/physics-3d/docs/engine-shadows.md +372 -0
  300. package/kits/physics-3d/docs/engine-skip-work.md +187 -0
  301. package/kits/physics-3d/docs/engine-sky.md +198 -0
  302. package/kits/physics-3d/docs/engine-static-actors.md +226 -0
  303. package/kits/physics-3d/docs/engine-view.md +37 -0
  304. package/kits/physics-3d/docs/pxmodel-format.md +1 -1
  305. package/kits/physics-3d/engine3d/PlayOnly3D.jsx +5 -1
  306. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +19 -333
  307. package/kits/physics-3d/engine3d/actornode.js +1 -0
  308. package/kits/physics-3d/engine3d/branches.js +3 -13
  309. package/kits/physics-3d/engine3d/cage.js +2 -7
  310. package/kits/physics-3d/engine3d/cageops.js +2 -17
  311. package/kits/physics-3d/engine3d/dataBehaviors.js +12 -0
  312. package/kits/physics-3d/engine3d/framecap.js +4 -1
  313. package/kits/physics-3d/engine3d/frozenphysics.js +140 -0
  314. package/kits/physics-3d/engine3d/frozenstatics.js +273 -0
  315. package/kits/physics-3d/engine3d/gait.js +8 -0
  316. package/kits/physics-3d/engine3d/initialModelFiles.js +18 -0
  317. package/kits/physics-3d/engine3d/look.js +7 -0
  318. package/kits/physics-3d/engine3d/modelFiles.js +3 -17
  319. package/kits/physics-3d/engine3d/modelMath.js +49 -0
  320. package/kits/physics-3d/engine3d/modelready.js +16 -0
  321. package/kits/physics-3d/engine3d/motion.js +3 -3
  322. package/kits/physics-3d/engine3d/nearshadows.js +77 -10
  323. package/kits/physics-3d/engine3d/orbitinput.js +59 -25
  324. package/kits/physics-3d/engine3d/partgeometry.js +1 -16
  325. package/kits/physics-3d/engine3d/paths.js +1 -9
  326. package/kits/physics-3d/engine3d/playTimings.js +50 -0
  327. package/kits/physics-3d/engine3d/playerRun.js +372 -0
  328. package/kits/physics-3d/engine3d/pxmodel.js +3 -3
  329. package/kits/physics-3d/engine3d/rapier.js +27 -0
  330. package/kits/physics-3d/engine3d/scatter.js +1 -11
  331. package/kits/physics-3d/engine3d/shadowfade.js +23 -15
  332. package/kits/physics-3d/engine3d/sky.js +1 -1
  333. package/kits/physics-3d/engine3d/squarefirst.js +177 -0
  334. package/kits/physics-3d/engine3d/stillshadows.js +399 -0
  335. package/kits/physics-3d/engine3d/sweep.js +1 -25
  336. package/kits/physics-3d/engine3d/world3d.js +468 -18
  337. package/kits/physics-3d/eslint.config.js +2 -1
  338. package/kits/physics-3d/main.jsx +6 -3
  339. package/kits/physics-3d/package-lock.json +7 -0
  340. package/kits/physics-3d/package.json +5 -1
  341. package/kits/physics-3d/play/behaviors/Body.js +31 -0
  342. package/kits/physics-3d/play/behaviors/Door.js +37 -0
  343. package/kits/physics-3d/play/behaviors/Lookable.js +16 -0
  344. package/kits/physics-3d/play/behaviors/Model.js +23 -0
  345. package/kits/physics-3d/play/behaviors/Pickup.js +46 -0
  346. package/kits/physics-3d/play/behaviors/Player.js +1204 -0
  347. package/kits/physics-3d/play/behaviors/Shape.js +47 -0
  348. package/kits/physics-3d/play/behaviors/Solid.js +16 -0
  349. package/kits/physics-3d/play/behaviors/Transform.js +29 -0
  350. package/kits/physics-3d/pnpm-lock.yaml +8 -0
  351. package/kits/physics-3d/scripts/bench-shadow-fade.mjs +37 -0
  352. package/kits/physics-3d/scripts/build-rapier-gz.mjs +56 -0
  353. package/kits/physics-3d/scripts/frozen-statics-fixture.mjs +141 -0
  354. package/kits/physics-3d/scripts/test-camera-follow.mjs +5 -1
  355. package/kits/physics-3d/scripts/test-camera-orbit.mjs +52 -4
  356. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +1 -1
  357. package/kits/physics-3d/scripts/test-empty-gait-hints.mjs +89 -0
  358. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +6 -3
  359. package/kits/physics-3d/scripts/test-frame-cap.mjs +1 -1
  360. package/kits/physics-3d/scripts/test-frozen-nested.mjs +49 -0
  361. package/kits/physics-3d/scripts/test-frozen-statics-legacy-physics2d.mjs +123 -0
  362. package/kits/physics-3d/scripts/test-frozen-statics.mjs +434 -0
  363. package/kits/physics-3d/scripts/test-look-bake.mjs +1 -1
  364. package/kits/physics-3d/scripts/test-near-shadows.mjs +2 -2
  365. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +88 -7
  366. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +40 -3
  367. package/kits/physics-3d/scripts/test-orbit-shot.mjs +75 -1
  368. package/kits/physics-3d/scripts/test-rapier-gz.mjs +106 -0
  369. package/kits/physics-3d/scripts/test-sky.mjs +1 -1
  370. package/kits/physics-3d/scripts/test-square-first.mjs +921 -0
  371. package/kits/physics-3d/scripts/test-static-actors.mjs +3 -1
  372. package/kits/physics-3d/scripts/test-static-physics.mjs +4 -1
  373. package/kits/physics-3d/scripts/test-static-scenery.mjs +5 -2
  374. package/kits/physics-3d/scripts/test-steady-hover.mjs +5 -2
  375. package/kits/physics-3d/scripts/test-still-shadows.mjs +477 -0
  376. package/kits/physics-3d/systems/physics3d.js +37 -4
  377. package/kits/real-time/castle.json +2 -2
  378. package/kits/real-time/code/client/connection.js +33 -10
  379. package/kits/real-time/code/client/gameHooks.js +2 -0
  380. package/kits/real-time/code/client/joinOverlay.js +9 -4
  381. package/kits/real-time/code/server/session.js +6 -4
  382. package/kits/real-time/package-lock.json +1 -1
  383. package/package.json +2 -2
@@ -154,15 +154,19 @@ audio.Ctor = FakeContext;
154
154
  // A page: listeners counted by target, storage counted by call.
155
155
  function fakeTarget() {
156
156
  const listeners = [];
157
+ const removeEventListener = (type, fn) => {
158
+ const at = listeners.findIndex(([t, f]) => t === type && f === fn);
159
+ if (at >= 0) {
160
+ listeners.splice(at, 1);
161
+ }
162
+ };
157
163
  return {
158
164
  listeners,
159
- addEventListener: (type, fn) => listeners.push([type, fn]),
160
- removeEventListener: (type, fn) => {
161
- const at = listeners.findIndex(([t, f]) => t === type && f === fn);
162
- if (at >= 0) {
163
- listeners.splice(at, 1);
164
- }
165
+ addEventListener: (type, fn, options) => {
166
+ listeners.push([type, fn]);
167
+ options?.signal?.addEventListener('abort', () => removeEventListener(type, fn), { once: true });
165
168
  },
169
+ removeEventListener,
166
170
  fire: (type) => listeners.filter(([t]) => t === type).forEach(([, fn]) => fn({})),
167
171
  };
168
172
  }
@@ -250,7 +254,7 @@ register(
250
254
  const { fileURLToPath } = await import('node:url');
251
255
  const source = await readFile(fileURLToPath(url.split('?')[0]), 'utf8');
252
256
  const deck = new URL(url).searchParams.get('deck');
253
- return { format: 'module', source: source.replace("import.meta.glob('/build.json'", "(() => ({}))('/build.json'").replace('import.meta.glob(', '(() => ({ "/castle.json": globalThis.__castleJson[' + JSON.stringify(deck) + '] }))('), shortCircuit: true };
257
+ return { format: 'module', source: source.replace("import.meta.glob('/imports/castle.hub-game/.castle-import-version.json'", "(() => ({}))('/imports/castle.hub-game/.castle-import-version.json'").replace("import.meta.glob('/build.json'", "(() => ({}))('/build.json'").replace('import.meta.glob(', '(() => ({ "/castle.json": globalThis.__castleJson[' + JSON.stringify(deck) + '] }))('), shortCircuit: true };
254
258
  }
255
259
  return next(url, context);
256
260
  }`),
@@ -516,7 +520,7 @@ const VISIT_TRACE = [
516
520
  assert.deepEqual(partsDeck.soundscape, { babble: true, steps: false });
517
521
  assert.equal(wrongDeck.soundscape, null, 'what the manifest refuses is not on');
518
522
  assert.equal(State.deck.soundscape, null, 'the keyless deck, read last: the page\'s deck now');
519
- assert.deepEqual(State.deck, { tiers: false, cues: false, stuck: false, labels: false, yourGames: false, soundscape: null, build: null });
523
+ assert.deepEqual(State.deck, { defaultEnvironment: true, tiers: false, cues: false, playCards: false, stuck: false, labels: false, yourGames: false, invite: false, soundscape: null, build: null, title: '' });
520
524
  });
521
525
 
522
526
  test('a keyless deck, real frames: no context, no resume, no listener of ours, no storage, no control, and the place\'s sounds as they always were', () => {
@@ -534,7 +538,7 @@ const VISIT_TRACE = [
534
538
  assert.equal(globalThis.__buskerCalls, undefined, 'keyless runs no busker statements');
535
539
  assert.equal(r.system.soundscape, undefined);
536
540
  assert.equal(r.system.soundHandlers, undefined);
537
- assert.deepEqual(page(r), { contexts: 0, resumes: 0, window: [], document: [], scope: ['keydown', 'keydown'], storage: 0 }, 'the two key listeners are the chrome\'s scroll guard and Grab\'s, as before');
541
+ assert.deepEqual(page(r), { contexts: 0, resumes: 0, window: ['pagehide', 'pageshow', 'resize', 'orientationchange'], document: ['visibilitychange'], scope: ['keydown', 'keydown'], storage: 0 }, 'only chrome lifecycle, layout, and key listeners exist; soundscape adds none');
538
542
  assert.equal(r.find('sound'), null);
539
543
  assert.equal(r.find('sound-card'), null);
540
544
  assert.equal(r.made.filter((c) => c.tag === 'input' && c.type === 'range').length, 0);
@@ -542,6 +546,7 @@ const VISIT_TRACE = [
542
546
  assert.deepEqual(globalThis.__mediaTrace, VISIT_TRACE);
543
547
  r.system.dispose();
544
548
  assert.deepEqual(scope.listeners, []);
549
+ assert.deepEqual(win.listeners, [], 'chrome layout listeners are removed');
545
550
  assert.deepEqual(page(r).contexts, 0);
546
551
  });
547
552
 
@@ -2225,7 +2230,7 @@ test('the place\'s own sound files wait for the gesture too: nothing is started
2225
2230
  });
2226
2231
  }
2227
2232
 
2228
- test('the control: a speaker in the top right corner, a card with Mute and a slider, and what a tap says', () => {
2233
+ test('the control: a speaker below the native camera corner, a card with Mute and a slider, and what a tap says', () => {
2229
2234
  const r = build();
2230
2235
  const heard = [];
2231
2236
  const handlers = { onVolume: (v) => heard.push(['volume', v]), onMuted: (m) => heard.push(['muted', m]) };
@@ -2235,7 +2240,7 @@ test('the place\'s own sound files wait for the gesture too: nothing is started
2235
2240
  assert.equal(button.tag, 'button');
2236
2241
  assert.equal(button.style.display, 'block');
2237
2242
  assert.equal(button.style.right, '12px');
2238
- assert.equal(button.style.top, 'max(12px, env(safe-area-inset-top))');
2243
+ assert.equal(button.style.top, 'max(64px, calc(env(safe-area-inset-top) + 64px))');
2239
2244
  assert.equal(button.style.background, 'rgba(20,16,12,0.72)', 'the dark pill of the other buttons');
2240
2245
  assert.equal(button.textContent, '🔊');
2241
2246
  assert.equal(button.attrs['aria-label'], 'Sound: 70%');
@@ -2280,7 +2285,7 @@ test('the place\'s own sound files wait for the gesture too: nothing is started
2280
2285
  // Under the frame-rate readout where that is up.
2281
2286
  r.chrome.setStats('30 fps');
2282
2287
  r.chrome.soundControl(true, { volume: 0.9, muted: false }, handlers);
2283
- assert.equal(button.style.top, '54px');
2288
+ assert.equal(button.style.top, 'max(54px, max(64px, calc(env(safe-area-inset-top) + 64px)))');
2284
2289
  });
2285
2290
  }
2286
2291
 
@@ -2356,10 +2361,10 @@ test('the place\'s own sound files wait for the gesture too: nothing is started
2356
2361
  assert.deepEqual(globalThis.__mediaTrace, [], 'no <audio>, no play asked of the engine to wait for the gesture');
2357
2362
  assert.equal(ctx.nodes.length, from);
2358
2363
  assert.equal(State.hub.soundEvents.length, 0, 'the one-shots were dropped');
2359
- assert.deepEqual(win.listeners.slice(before).map(([type]) => type), ['pointerdown', 'keydown']);
2364
+ assert.deepEqual(win.listeners.slice(before).map(([type]) => type), ['pagehide', 'pageshow', 'resize', 'orientationchange', 'pointerdown', 'keydown']);
2360
2365
  // The gesture.
2361
2366
  win.fire('pointerdown');
2362
- assert.equal(win.listeners.length, before);
2367
+ assert.deepEqual(win.listeners.slice(before).map(([type]) => type), ['pagehide', 'pageshow', 'resize', 'orientationchange']);
2363
2368
  r.frame();
2364
2369
  assert.deepEqual(globalThis.__mediaTrace.slice(0, 3), [['new', 'media:juke'], ['volume', 'media:juke', 0], ['playMedia', 'media:juke']], 'the loop starts now');
2365
2370
  assert.deepEqual(globalThis.__mediaTrace.filter(([op]) => op === 'play'), [], 'none of the earlier one-shots');
@@ -4715,19 +4720,19 @@ test('v1.49: animal voices never overlap, end on the audio clock, and scheduled
4715
4720
  }));
4716
4721
 
4717
4722
  test('arrival C: dispose and rebuild without userActivation preserves the page gesture', () => withTown((r, ctx, page) => {
4718
- assert.deepEqual(page.listeners.map(([type]) => type), ['pointerdown', 'keydown']);
4723
+ assert.deepEqual(page.listeners.map(([type]) => type), ['pagehide', 'pageshow', 'resize', 'orientationchange', 'pointerdown', 'keydown']);
4719
4724
  r.system.dispose();
4720
4725
  assert.deepEqual(page.listeners, [], 'dispose before a gesture removes both listeners');
4721
4726
  r.frame();
4722
4727
  assert.equal(r.system.soundscape.live(), false);
4723
4728
  page.fire('keydown');
4724
- assert.deepEqual(page.listeners, [], 'first gesture removes both listeners');
4729
+ assert.deepEqual(page.listeners.map(([type]) => type), ['pagehide', 'pageshow', 'resize', 'orientationchange'], 'first gesture removes both sound listeners');
4725
4730
  const first = r.system.soundscape;
4726
4731
  r.system.dispose();
4727
4732
  r.frame();
4728
4733
  assert.notEqual(r.system.soundscape, first);
4729
4734
  assert.equal(r.system.soundscape.live(), true, 'rebuilt instance is activated without another gesture');
4730
- assert.deepEqual(page.listeners, [], 'rebuilt instance needs no gesture listener');
4735
+ assert.deepEqual(page.listeners.map(([type]) => type), ['pagehide', 'pageshow', 'resize', 'orientationchange'], 'rebuilt instance needs no gesture listener');
4731
4736
  const from = ctx.nodes.length;
4732
4737
  open(r, 'Still here, still listening.');
4733
4738
  r.frame();
@@ -20,6 +20,9 @@ register(`data:text/javascript,${encodeURIComponent(`
20
20
  return { url: ${JSON.stringify('data:text/javascript,' + encodeURIComponent(sceneStub))}, shortCircuit: true };
21
21
  }
22
22
  const modules = ${JSON.stringify(modules)};
23
+ if ((specifier.startsWith('.') || specifier.startsWith('file:')) && new URL(specifier, context.parentURL).href.endsWith('/kits/physics-3d/engine3d/rapier.js')) {
24
+ return { url: modules['@dimforge/rapier3d-compat'], shortCircuit: true };
25
+ }
23
26
  if (modules[specifier]) return { url: modules[specifier], shortCircuit: true };
24
27
  if (specifier.startsWith('@imports/castle.')) {
25
28
  return next(specifier.replace('@imports/castle.', ${JSON.stringify(kitRoot)}), context);
@@ -129,7 +132,7 @@ await test('first join of a fresh never-stepped hub starts at 0.76 and WORLD sen
129
132
  const { added, snapshot } = await joined(null);
130
133
  near(added.at.y, 0.76);
131
134
  near(added.translation.y, 0.76);
132
- assert.equal(added.at.x, spawn.components.Transform.x + 1.1);
135
+ assert.equal(added.at.x, spawn.components.Transform.x, 'on the spawn, not the ring');
133
136
  assert.equal(added.at.z, spawn.components.Transform.z);
134
137
  assert.equal(added.facing, 0);
135
138
  assert.equal(added.movedAt, 0);
@@ -167,9 +170,39 @@ await test('resumed join preserves saved position, facing and flags', async () =
167
170
  await test('unreadable resumed pose uses standing spawn', async () => {
168
171
  const { added } = await joined([201, 3, 0, 0]);
169
172
  near(added.at.y, 0.76);
170
- assert.equal(added.at.x, 1.1);
173
+ assert.equal(added.at.x, 0);
171
174
  assert.equal(added.at.z, 0);
172
175
  });
176
+ // Oct 17, live Town: the ring put a joiner 1.1 m off the spawn (slot 1 at
177
+ // -0.14, +1.09), the client snapped there with WORLD, and the arrival row at
178
+ // the spawn then reached it as a correction under the client's 4 m snap, eased
179
+ // a quarter of the way a frame: a 1.1 m glide after the cover lifted.
180
+ await test('joiners wait on the spawn and the arrival row moves nothing', async () => {
181
+ const town = { id: 'spawn', components: { ...spawn.components, Transform: { x: 0, y: 1, z: 9 } } };
182
+ globalThis.__standingActors = [town, door];
183
+ globalThis.__standingGround = {};
184
+ const sim = await World.createSimulation();
185
+ sim.spawn = { x: 0, y: 1, z: 9 };
186
+ const sent = [];
187
+ const h = layer(config, {}, {}, () => true, () => ({}), null, engine);
188
+ const session = { sessionId: 'dev:ring', players: [{ playerId: 'p1', username: 'ada' }, { playerId: 'p2', username: 'bo' }],
189
+ send(id, data) { sent.push([id, data]); }, broadcast() {} };
190
+ h.sceneFor(session);
191
+ h.ready(sim);
192
+ const wrapped = hubPlayers(h);
193
+ try {
194
+ for (const id of ['p1', 'p2']) {
195
+ wrapped.addPlayer(sim, id);
196
+ const waiting = { ...sim.players.get(id).at };
197
+ assert.deepEqual([waiting.x, waiting.z], [0, 9], `${id} waits on the spawn`);
198
+ h.message(session, { playerId: id }, { k: 'hub-hello', avatar: 1 });
199
+ h.place(sim);
200
+ assert.ok(sent.some(([to, data]) => to === id && data.k === 'hub-arrived'), `${id} arrived`);
201
+ const body = sim.players.get(id);
202
+ assert.deepEqual([body.at.x, body.at.z], [waiting.x, waiting.z], `${id}: the arrival row is where WORLD put them`);
203
+ }
204
+ } finally { sim.world.free(); }
205
+ });
173
206
  await test('other Players exports pass through unchanged', () => {
174
207
  const wrapped = hubPlayers({});
175
208
  assert.deepEqual(Object.keys(wrapped).sort(), Object.keys(Players).sort());
@@ -0,0 +1,333 @@
1
+ import assert from 'node:assert/strict';
2
+ import { register } from 'node:module';
3
+ import { limitSession, limitCallbacks, MAX_IN_FLIGHT, RETRY_MS } from '../code/server/storageLimit.js';
4
+
5
+ // A broker stand-in: at most 8 requests in flight, the rest refused before
6
+ // they run, as host-agent's storageBroker does.
7
+ function broker(cap = 8) {
8
+ const b = { inFlight: 0, peak: 0, refused: 0, sent: 0 };
9
+ b.request = async (answer, ms = 5) => {
10
+ if (b.inFlight >= cap) {
11
+ b.refused += 1;
12
+ throw Object.assign(new Error('too many requests in flight'), { code: 'CAULDRON_STORAGE_RATE_LIMITED' });
13
+ }
14
+ b.inFlight += 1;
15
+ b.sent += 1;
16
+ b.peak = Math.max(b.peak, b.inFlight);
17
+ try {
18
+ await new Promise((resolve) => setTimeout(resolve, ms));
19
+ return answer;
20
+ } finally {
21
+ b.inFlight -= 1;
22
+ }
23
+ };
24
+ return b;
25
+ }
26
+
27
+ function fakeSession(b) {
28
+ const scope = (name) => ({
29
+ async get(keys) { return b.request({ scope: name, keys }); },
30
+ async set() { await b.request(null); },
31
+ });
32
+ const playthrough = (id) => ({
33
+ characters: Object.freeze({ async send(input) { return b.request({ id, input }); } }),
34
+ async get(keys) { return b.request({ id, keys }); },
35
+ });
36
+ const players = [];
37
+ const hub = {
38
+ owner: 'owner-1',
39
+ place: 'main',
40
+ arrival: () => ({ from: 'door' }),
41
+ async readResults(ids) { return b.request({ players: ids }); },
42
+ async track() { return true; },
43
+ };
44
+ Object.defineProperty(hub, 'track', { enumerable: false });
45
+ return {
46
+ sessionId: 's-1',
47
+ get players() { return players; },
48
+ players_: players,
49
+ storage: {
50
+ deck: scope('deck'),
51
+ user: (id) => scope(`user:${id}`),
52
+ async playthrough(id) { await b.request(null); return playthrough(id); },
53
+ },
54
+ hub: Object.freeze(hub),
55
+ send() {},
56
+ };
57
+ }
58
+
59
+ // A Town arrival's burst: thirteen requests in one tick stay under the cap.
60
+ {
61
+ const b = broker();
62
+ const raw = fakeSession(b);
63
+ const session = limitSession(raw);
64
+ const calls = [
65
+ session.hub.readResults(['u1']),
66
+ session.storage.playthrough('u1'),
67
+ ...Array.from({ length: 11 }, (_, i) => session.storage.user('u1').get([`k${i}`])),
68
+ ];
69
+ const results = await Promise.all(calls);
70
+ assert.equal(results.length, 13);
71
+ assert.equal(b.refused, 0, 'no request reached a full broker');
72
+ assert.ok(b.peak <= MAX_IN_FLIGHT, `peak ${b.peak} stays within ${MAX_IN_FLIGHT}`);
73
+ assert.deepEqual(results[2], { scope: 'user:u1', keys: ['k0'] });
74
+ // The playthrough handle it returns queues too, frozen children included.
75
+ const pt = results[1];
76
+ assert.ok(Object.isFrozen(pt.characters));
77
+ const sends = await Promise.all(Array.from({ length: 12 }, (_, i) => pt.characters.send(i)));
78
+ assert.equal(sends.length, 12);
79
+ assert.equal(b.refused, 0);
80
+ }
81
+
82
+ // One session, one queue, one set of handles.
83
+ {
84
+ const b = broker();
85
+ const raw = fakeSession(b);
86
+ const session = limitSession(raw);
87
+ assert.equal(limitSession(raw), session);
88
+ assert.equal(limitSession(session), session);
89
+ assert.equal(session.storage, session.storage);
90
+ assert.equal(session.storage.deck, session.storage.deck);
91
+ assert.equal(session.hub, session.hub);
92
+ assert.ok(Object.isFrozen(session.hub));
93
+ assert.equal(session.hub.owner, 'owner-1');
94
+ assert.deepEqual(session.hub.arrival(), { from: 'door' });
95
+ assert.equal(Object.keys(session.hub).includes('track'), false, 'track stays non-enumerable');
96
+ assert.equal(session.sessionId, 's-1');
97
+ raw.players_.push({ playerId: 'p1' });
98
+ assert.equal(session.players.length, 1, 'players stays live');
99
+ // Analytics has its own broker pool: track never waits behind a full queue.
100
+ const blockers = Array.from({ length: MAX_IN_FLIGHT + 2 }, () => session.storage.deck.get(['x']));
101
+ let tracked = false;
102
+ await Promise.race([
103
+ session.hub.track('p1', { kind: 1 }).then((v) => { tracked = v; }),
104
+ new Promise((resolve) => setTimeout(resolve, 3)),
105
+ ]);
106
+ assert.equal(tracked, true);
107
+ await Promise.all(blockers);
108
+ }
109
+
110
+ // A refusal from outside the queue is sent again; other errors are not.
111
+ {
112
+ let calls = 0;
113
+ const raw = {
114
+ sessionId: 's-2',
115
+ storage: {
116
+ deck: {
117
+ async get() {
118
+ calls += 1;
119
+ if (calls < 3) {
120
+ throw Object.assign(new Error('busy'), { code: 'CAULDRON_STORAGE_RATE_LIMITED' });
121
+ }
122
+ return { ok: true };
123
+ },
124
+ async set() {
125
+ calls += 1;
126
+ throw Object.assign(new Error('nope'), { code: 'CAULDRON_STORAGE_FORBIDDEN' });
127
+ },
128
+ },
129
+ },
130
+ };
131
+ const warned = [];
132
+ const warn = console.warn;
133
+ console.warn = (msg) => warned.push(msg);
134
+ try {
135
+ const session = limitSession(raw);
136
+ assert.deepEqual(await session.storage.deck.get(['a']), { ok: true });
137
+ assert.equal(calls, 3);
138
+ calls = 0;
139
+ await assert.rejects(session.storage.deck.set({ a: 1 }), { code: 'CAULDRON_STORAGE_FORBIDDEN' });
140
+ assert.equal(calls, 1);
141
+ } finally {
142
+ console.warn = warn;
143
+ }
144
+ assert.equal(warned.length, 1, 'the retry is logged once per session');
145
+ assert.match(warned[0], /storage busy/);
146
+ }
147
+
148
+ // A broker that stays full: the refusal reaches the caller after the retries.
149
+ {
150
+ let calls = 0;
151
+ const raw = {
152
+ sessionId: 's-3',
153
+ storage: {
154
+ deck: {
155
+ async get() {
156
+ calls += 1;
157
+ throw Object.assign(new Error('busy'), { code: 'CAULDRON_STORAGE_RATE_LIMITED' });
158
+ },
159
+ },
160
+ },
161
+ };
162
+ const warn = console.warn;
163
+ console.warn = () => {};
164
+ try {
165
+ await assert.rejects(limitSession(raw).storage.deck.get(['a']), { code: 'CAULDRON_STORAGE_RATE_LIMITED' });
166
+ } finally {
167
+ console.warn = warn;
168
+ }
169
+ assert.equal(calls, RETRY_MS.length + 1);
170
+ }
171
+
172
+ // Callbacks get the limited session wherever the platform passes it.
173
+ {
174
+ const b = broker();
175
+ const raw = fakeSession(b);
176
+ const seen = [];
177
+ const cbs = limitCallbacks({
178
+ onPlayerJoin(session, player) { seen.push(session, player); },
179
+ async onWorldCharacterTool(request, session) { seen.push(request, session); return 'ok'; },
180
+ flag: true,
181
+ });
182
+ cbs.onPlayerJoin(raw, { playerId: 'p1' });
183
+ assert.equal(await cbs.onWorldCharacterTool({ tool: 'x' }, raw), 'ok');
184
+ assert.equal(seen[0], limitSession(raw));
185
+ assert.deepEqual(seen[1], { playerId: 'p1' });
186
+ assert.deepEqual(seen[2], { tool: 'x' });
187
+ assert.equal(seen[3], limitSession(raw));
188
+ assert.equal(cbs.flag, true);
189
+ }
190
+
191
+ // Save verbs are plain functions, and queue too; catchUp runs author code and
192
+ // is never queued; a write past one request is never replayed.
193
+ {
194
+ let inFlight = 0;
195
+ let peak = 0;
196
+ const slow = async () => {
197
+ inFlight += 1;
198
+ peak = Math.max(peak, inFlight);
199
+ await new Promise((resolve) => setTimeout(resolve, 5));
200
+ inFlight -= 1;
201
+ };
202
+ let catchUps = 0;
203
+ let setCalls = 0;
204
+ let refuseSet = 0;
205
+ const raw = {
206
+ sessionId: 's-4',
207
+ storage: {
208
+ deck: {
209
+ snapshot: () => slow(),
210
+ transaction: () => slow(),
211
+ async set() {
212
+ setCalls += 1;
213
+ if (refuseSet > 0) {
214
+ refuseSet -= 1;
215
+ throw Object.assign(new Error('busy'), { code: 'CAULDRON_STORAGE_RATE_LIMITED' });
216
+ }
217
+ },
218
+ },
219
+ },
220
+ world: { async catchUp({ apply }) { catchUps += 1; return apply(); } },
221
+ };
222
+ const warn = console.warn;
223
+ console.warn = () => {};
224
+ try {
225
+ const session = limitSession(raw);
226
+ await Promise.all(Array.from({ length: 10 }, (_, i) => (i % 2 ? session.storage.deck.snapshot() : session.storage.deck.transaction())));
227
+ assert.ok(peak <= MAX_IN_FLIGHT && peak > 0, `save verbs queue (peak ${peak})`);
228
+ // A catchUp whose apply awaits a queued read finishes even with every slot taken.
229
+ const holders = Array.from({ length: MAX_IN_FLIGHT }, () => session.storage.deck.snapshot());
230
+ assert.equal(await session.world.catchUp({ apply: () => session.storage.deck.transaction().then(() => 'applied') }), 'applied');
231
+ assert.equal(catchUps, 1);
232
+ await Promise.all(holders);
233
+ refuseSet = 1;
234
+ await session.storage.deck.set({ a: 1, b: 2 });
235
+ assert.equal(setCalls, 2, 'a one-request write is sent again');
236
+ setCalls = 0;
237
+ refuseSet = 1;
238
+ const many = Object.fromEntries(Array.from({ length: 40 }, (_, i) => [`k${i}`, i]));
239
+ await assert.rejects(session.storage.deck.set(many), { code: 'CAULDRON_STORAGE_RATE_LIMITED' });
240
+ assert.equal(setCalls, 1, 'a chunked write is never replayed');
241
+ setCalls = 0;
242
+ refuseSet = 1;
243
+ await assert.rejects(session.storage.deck.set({ big: 'x'.repeat(300 * 1024) }), { code: 'CAULDRON_STORAGE_RATE_LIMITED' });
244
+ assert.equal(setCalls, 1, 'a write that may split by bytes is never replayed');
245
+ setCalls = 0;
246
+ refuseSet = 1;
247
+ // Small as JSON, but each quote is escaped twice on the way to the platform.
248
+ await assert.rejects(session.storage.deck.set({ a: '"'.repeat(60000), b: '"'.repeat(60000) }), { code: 'CAULDRON_STORAGE_RATE_LIMITED' });
249
+ assert.equal(setCalls, 1, 'a write measured as the SDK encodes it is never replayed');
250
+ } finally {
251
+ console.warn = warn;
252
+ }
253
+ }
254
+
255
+ // The real SDK boot: a hub session built by createCastleSessionBoot over a platform
256
+ // handle that refuses a 9th request in flight, as host-agent's broker does.
257
+ {
258
+ // The built SDK imports its siblings without extensions, as the bundler allows.
259
+ register(
260
+ 'data:text/javascript,' +
261
+ encodeURIComponent(
262
+ "export async function resolve(s, c, next) { try { return await next(s, c); } catch (e) { if (e?.code === 'ERR_MODULE_NOT_FOUND' && /^\\.\\.?\\//.test(s) && !s.endsWith('.js')) return next(s + '.js', c); throw e; } }",
263
+ ),
264
+ );
265
+ const { createCastleSessionBoot } = await import('../../base/sdk/server/wrapper.js');
266
+ const b = { inFlight: 0, peak: 0, refused: 0, sent: 0 };
267
+ const request = async (answer) => {
268
+ if (b.inFlight >= 8) {
269
+ b.refused += 1;
270
+ throw Object.assign(new Error('too many requests in flight'), { code: 'CAULDRON_STORAGE_RATE_LIMITED' });
271
+ }
272
+ b.inFlight += 1;
273
+ b.sent += 1;
274
+ b.peak = Math.max(b.peak, b.inFlight);
275
+ try {
276
+ await new Promise((resolve) => setTimeout(resolve, 5));
277
+ return answer;
278
+ } finally {
279
+ b.inFlight -= 1;
280
+ }
281
+ };
282
+ const on = {};
283
+ const answers = { playthroughOpen: '{"generation":1}', increment: '1' };
284
+ const handle = {
285
+ config: { sessionId: 'boot-1', deckId: 'deck-1', mode: 'public', place: 'main' },
286
+ storageEnabled: true,
287
+ hub: { place: 'main', owner: null },
288
+ on(name, fn) { on[name] = fn; },
289
+ send() {},
290
+ broadcast() {},
291
+ storage: (op) => request(answers[op] ?? '[]'),
292
+ hubResult: () => request('{}'),
293
+ hubPadUpdate: () => request('{}'),
294
+ hubResultsRead: () => request('{"players":{}}'),
295
+ hubUnlocksRead: () => request('{"players":{}}'),
296
+ hubFriendsAmong: () => request('{"friends":[]}'),
297
+ };
298
+ let joined = null;
299
+ const callbacks = {
300
+ async onPlayerJoin(session) {
301
+ // A Town arrival's burst: letters, news, unlocks, jobs, trade, ledger,
302
+ // memory reads and saves, results, the playthrough and pose.
303
+ const user = session.storage.user('u1');
304
+ joined = await Promise.allSettled([
305
+ session.hub.readResults(['u1']),
306
+ session.hub.readUnlocks(['u1']),
307
+ session.storage.playthrough('u1'),
308
+ session.storage.town('u1').get(['tokens:u1']),
309
+ session.storage.deck.snapshot({ prefix: 'hub:resumePose:' }),
310
+ ...Array.from({ length: 6 }, (_, i) => user.get([`k${i}`])),
311
+ ...Array.from({ length: 4 }, (_, i) => user.snapshot({ prefix: `bond:${i}:` })),
312
+ user.increment('visits'),
313
+ ]);
314
+ },
315
+ };
316
+ // Control: the same burst without the queue reaches a full broker.
317
+ await createCastleSessionBoot(callbacks)(handle);
318
+ await on.join('c0', JSON.stringify({ playerId: 'p0', userId: 'u1' }));
319
+ assert.ok(b.refused > 0, 'without the queue the burst is refused');
320
+ Object.assign(b, { inFlight: 0, peak: 0, refused: 0, sent: 0 });
321
+ joined = null;
322
+ const boot = createCastleSessionBoot(limitCallbacks(callbacks));
323
+ await boot(handle);
324
+ await on.join('c1', JSON.stringify({ playerId: 'p1', userId: 'u1' }));
325
+ assert.ok(joined, 'the join callback ran');
326
+ assert.equal(b.refused, 0, 'the broker refused nothing');
327
+ assert.ok(b.peak <= MAX_IN_FLIGHT, `peak ${b.peak} at the platform boundary stays within ${MAX_IN_FLIGHT}`);
328
+ assert.equal(b.sent, 16, 'every request reached the platform once');
329
+ const codes = joined.filter((r) => r.status === 'rejected').map((r) => r.reason?.code);
330
+ assert.equal(codes.includes('CAULDRON_STORAGE_RATE_LIMITED'), false);
331
+ }
332
+
333
+ console.log('storage limit ok');
@@ -786,7 +786,7 @@ function rig(view = PORTRAIT) {
786
786
  const chrome = makeChrome({ onBack() {}, onAvatar() {}, avatarCount: 4 });
787
787
  const by = (test) => dom.made.find((c) => test(c.style));
788
788
  const nodes = {
789
- hud: by((st) => st.maxWidth === '70vw'),
789
+ hud: by((st) => st.textShadow?.includes('rgba(0,0,0,0.95)')),
790
790
  ask: by((st) => st.width === 'min(86vw, 320px)'),
791
791
  near: by((st) => String(st.bottom).startsWith('max(160px')),
792
792
  sit: by((st) => String(st.bottom).startsWith('max(112px')),
@@ -795,7 +795,7 @@ function rig(view = PORTRAIT) {
795
795
  const mid = view.w / 2;
796
796
  const centred = (w, top, h) => ({ left: mid - w / 2, right: mid + w / 2, top, bottom: top + h });
797
797
  const lay = {
798
- hud: (h, w = Math.min(0.7 * view.w, 400)) => (nodes.hud.rect = centred(w, 12, h)),
798
+ hud: (h, w = Math.min((view.w > view.h ? 0.42 : 0.7) * view.w, view.w > view.h ? 420 : 400)) => (nodes.hud.rect = centred(w, 12, h)),
799
799
  ask: (h) => (nodes.ask.rect = centred(Math.min(0.86 * view.w, 320), 92, h)),
800
800
  near: () => (nodes.near.rect = centred(180, view.h - 160 - 30, 30)),
801
801
  sit: () => (nodes.sit.rect = centred(90, view.h - 112 - 40, 40)),
@@ -1020,7 +1020,7 @@ test('the hub system places the chip last: after every setter and after the flus
1020
1020
  assert.ok(offer > body.lastIndexOf('chrome.flushHudClear'), 'after the flush');
1021
1021
  assert.equal(/chrome\.\w+\??\.?\(/.test(body.slice(offer)), false, 'and no chrome call after it');
1022
1022
  // Without the key the frame ends as it did: the flush is its last call.
1023
- assert.match(body, /\n {4}if \(this\.hudClear\) \{\n {6}chrome\.flushHudClear\?\.\(\);\n {4}\}\n(?: {4}\/\/.*\n)* {4}if \(Hub\.deck\.stuck\) \{\n {6}this\.offerUnstick\(scene, local, town, now\);\n {4}\}$/);
1023
+ assert.match(body, /\n {4}if \(this\.hudClear\) \{\n {6}chrome\.flushHudClear\?\.\(\);\n {4}\}\n(?: {4}\/\/.*\n)* {4}if \(Hub\.deck\.stuck\) \{\n {6}this\.offerUnstick\(scene, local, town, now\);\n {4}\}(?:\n(?: {4}\/\/.*\n)* {4}if \(padCuesEnabled\(scene\.data\?\.engine\) \|\| this\.padReadability\) \{\n {6}this\.drawPadReadability\(scene, local\);\n {4}\})?$/);
1024
1024
  });
1025
1025
 
1026
1026
  test('no room for the chip: the Doors row is still there', () => {
@@ -1042,11 +1042,12 @@ test('the Doors list: a "Stuck?" row over the doors, and its press', () => {
1042
1042
  r.chrome.setDoors(DOORS, 'Go', { where: 'Back to the square', onPick: () => (picks += 1) });
1043
1043
  const row = r.made.find((c) => c.dataset.hub === 'stuck-row');
1044
1044
  const list = row.parent;
1045
+ const scrollList = list.parent;
1045
1046
  assert.equal(list.children[0], row, 'first in the list');
1046
1047
  assert.deepEqual(texts(list), ['Stuck?', 'Back to the square', 'Go', 'Foot Race', 'Go', 'Gem Rush', 'solo', 'Go']);
1047
1048
  row.children.find((c) => c.tag === 'button').press();
1048
1049
  assert.equal(picks, 1);
1049
- assert.equal(list.style.display, 'none', 'the list closes, as for a door');
1050
+ assert.equal(scrollList.style.display, 'none', 'the list closes, as for a door');
1050
1051
  // The same list again is not rebuilt; without the row it is, as it always was.
1051
1052
  const made = r.made.length;
1052
1053
  r.chrome.setDoors(DOORS, 'Go', { where: 'Back to the square', onPick: () => (picks += 1) });