castle-web-cli 0.4.233 → 0.4.234

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 (381) 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 +260 -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 +50 -4
  39. package/kits/base/sdk/multiplayer.d.ts +7 -1
  40. package/kits/base/sdk/multiplayer.js +140 -40
  41. package/kits/base/sdk/multiplayerProtocol.d.ts +2 -0
  42. package/kits/base/sdk/party.d.ts +23 -0
  43. package/kits/base/sdk/party.js +91 -0
  44. package/kits/base/sdk/reconnectBudget.d.ts +23 -0
  45. package/kits/base/sdk/reconnectBudget.js +96 -0
  46. package/kits/base/sdk/save.d.ts +38 -1
  47. package/kits/base/sdk/save.js +79 -6
  48. package/kits/base/sdk/server/hub.d.ts +31 -1
  49. package/kits/base/sdk/server/hub.js +50 -3
  50. package/kits/base/sdk/server/platformHandle.d.ts +13 -1
  51. package/kits/base/sdk/server/storage.d.ts +4 -0
  52. package/kits/base/sdk/server/storage.js +19 -3
  53. package/kits/base/sdk/server/wrapper.d.ts +7 -1
  54. package/kits/base/sdk/server/wrapper.js +10 -1
  55. package/kits/base/sdk/social.d.ts +9 -0
  56. package/kits/base/sdk/social.js +5 -0
  57. package/kits/hub-game/CLAUDE.md +123 -3
  58. package/kits/hub-game/README.md +63 -0
  59. package/kits/hub-game/castle.json +5 -5
  60. package/kits/hub-game/code/client/act.js +312 -0
  61. package/kits/hub-game/code/client/actionLayout.js +147 -0
  62. package/kits/hub-game/code/client/actionOverflow.js +556 -0
  63. package/kits/hub-game/code/client/arrivalCamera.js +50 -0
  64. package/kits/hub-game/code/client/askSlot.js +117 -0
  65. package/kits/hub-game/code/client/avatar.js +4 -2
  66. package/kits/hub-game/code/client/avatarShare.js +2 -0
  67. package/kits/hub-game/code/client/backVisibility.js +13 -0
  68. package/kits/hub-game/code/client/ballot.js +15 -10
  69. package/kits/hub-game/code/client/build.js +16 -0
  70. package/kits/hub-game/code/client/chat.js +41 -5
  71. package/kits/hub-game/code/client/chatModeration.js +5 -0
  72. package/kits/hub-game/code/client/chrome.js +1148 -258
  73. package/kits/hub-game/code/client/crowdNames.js +241 -0
  74. package/kits/hub-game/code/client/decor.js +10 -4
  75. package/kits/hub-game/code/client/defaultEnvironment.js +194 -0
  76. package/kits/hub-game/code/client/doorErrors.js +39 -0
  77. package/kits/hub-game/code/client/fall.js +18 -0
  78. package/kits/hub-game/code/client/farAvatars.js +233 -0
  79. package/kits/hub-game/code/client/firstJoin.js +9 -2
  80. package/kits/hub-game/code/client/fpsTelemetry.js +50 -0
  81. package/kits/hub-game/code/client/frameBatch.js +5 -0
  82. package/kits/hub-game/code/client/grab.js +31 -11
  83. package/kits/hub-game/code/client/hookLayer.js +87 -8
  84. package/kits/hub-game/code/client/hudCopy.js +51 -0
  85. package/kits/hub-game/code/client/hudRate.js +20 -0
  86. package/kits/hub-game/code/client/idle.js +14 -2
  87. package/kits/hub-game/code/client/invites.js +231 -0
  88. package/kits/hub-game/code/client/joinError.js +9 -0
  89. package/kits/hub-game/code/client/labelsNear.js +31 -2
  90. package/kits/hub-game/code/client/landscapeLayout.js +17 -0
  91. package/kits/hub-game/code/client/layoutCache.js +264 -0
  92. package/kits/hub-game/code/client/loadTelemetry.js +20 -0
  93. package/kits/hub-game/code/client/loadingCover.js +148 -0
  94. package/kits/hub-game/code/client/loadingEntry.js +8 -0
  95. package/kits/hub-game/code/client/menuRows.js +43 -0
  96. package/kits/hub-game/code/client/modelReady.js +7 -0
  97. package/kits/hub-game/code/client/padCueArrival.js +23 -0
  98. package/kits/hub-game/code/client/padCues.js +112 -0
  99. package/kits/hub-game/code/client/padOccupancy.js +88 -0
  100. package/kits/hub-game/code/client/padReadability.js +26 -0
  101. package/kits/hub-game/code/client/padRings.js +69 -0
  102. package/kits/hub-game/code/client/pushVisit.js +14 -0
  103. package/kits/hub-game/code/client/quality.js +205 -0
  104. package/kits/hub-game/code/client/qualityEntry.js +55 -0
  105. package/kits/hub-game/code/client/safeLayout.js +338 -0
  106. package/kits/hub-game/code/client/safeStyle.js +42 -0
  107. package/kits/hub-game/code/client/say.js +12 -3
  108. package/kits/hub-game/code/client/shot.js +64 -10
  109. package/kits/hub-game/code/client/shotFit.js +56 -0
  110. package/kits/hub-game/code/client/signIn.js +28 -0
  111. package/kits/hub-game/code/client/state.js +53 -0
  112. package/kits/hub-game/code/client/talk.js +209 -45
  113. package/kits/hub-game/code/client/tiers.js +68 -66
  114. package/kits/hub-game/code/client/together.js +7 -2
  115. package/kits/hub-game/code/client/weakestLookBake.js +92 -0
  116. package/kits/hub-game/code/client/weakestTier.js +295 -0
  117. package/kits/hub-game/code/client/worldLabels.js +241 -0
  118. package/kits/hub-game/code/client/yours.js +10 -9
  119. package/kits/hub-game/code/npcDisplayText.js +55 -0
  120. package/kits/hub-game/code/server/act.js +124 -0
  121. package/kits/hub-game/code/server/actions.js +6 -1
  122. package/kits/hub-game/code/server/actors.js +2 -1
  123. package/kits/hub-game/code/server/analytics.js +83 -0
  124. package/kits/hub-game/code/server/anonymousEntry.js +49 -0
  125. package/kits/hub-game/code/server/arrivalPose.js +36 -0
  126. package/kits/hub-game/code/server/companion.js +28 -3
  127. package/kits/hub-game/code/server/doorAnalytics.js +52 -0
  128. package/kits/hub-game/code/server/earned.js +22 -5
  129. package/kits/hub-game/code/server/frameBatch.js +183 -0
  130. package/kits/hub-game/code/server/friendsAmong.js +49 -9
  131. package/kits/hub-game/code/server/history.js +2 -0
  132. package/kits/hub-game/code/server/hub.js +1306 -95
  133. package/kits/hub-game/code/server/idle.js +30 -1
  134. package/kits/hub-game/code/server/index.js +26 -4
  135. package/kits/hub-game/code/server/invites.js +19 -0
  136. package/kits/hub-game/code/server/labels.js +9 -1
  137. package/kits/hub-game/code/server/loadAbandon.js +106 -0
  138. package/kits/hub-game/code/server/manifest.js +211 -3
  139. package/kits/hub-game/code/server/menu.js +31 -3
  140. package/kits/hub-game/code/server/npcs.js +226 -64
  141. package/kits/hub-game/code/server/observe.js +408 -0
  142. package/kits/hub-game/code/server/padOccupancy.js +85 -0
  143. package/kits/hub-game/code/server/players.js +9 -1
  144. package/kits/hub-game/code/server/resumePose.js +152 -0
  145. package/kits/hub-game/code/server/say.js +1 -1
  146. package/kits/hub-game/code/server/standing.js +4 -5
  147. package/kits/hub-game/code/server/storageLimit.js +187 -0
  148. package/kits/hub-game/code/server/vis.js +67 -5
  149. package/kits/hub-game/code/shared/act.js +35 -0
  150. package/kits/hub-game/code/shared/danceIdle.js +28 -0
  151. package/kits/hub-game/code/shared/loadStages.js +12 -0
  152. package/kits/hub-game/code/shared/quality.js +74 -0
  153. package/kits/hub-game/code/shared/say.js +2 -0
  154. package/kits/hub-game/code/shared/shot.js +35 -1
  155. package/kits/hub-game/code/systems/hub.js +970 -169
  156. package/kits/hub-game/docs/analytics.md +279 -0
  157. package/kits/hub-game/docs/contract.md +1257 -42
  158. package/kits/hub-game/docs/home-pieces.md +9 -2
  159. package/kits/hub-game/docs/observed-progress.md +252 -0
  160. package/kits/hub-game/main.jsx +2 -0
  161. package/kits/hub-game/package-lock.json +10 -3
  162. package/kits/hub-game/package.json +6 -3
  163. package/kits/hub-game/play/player.js +142 -0
  164. package/kits/hub-game/play/registry.js +47 -0
  165. package/kits/hub-game/play.jsx +37 -0
  166. package/kits/hub-game/scripts/check.mjs +39 -5
  167. package/kits/hub-game/scripts/companion-follower-wire.json +1 -1
  168. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +11 -0
  169. package/kits/hub-game/scripts/fixtures/decor-keyless.json +5 -5
  170. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +3 -0
  171. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +19 -3
  172. package/kits/hub-game/scripts/fixtures/interest-legacy.json +3 -3
  173. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -1
  174. package/kits/hub-game/scripts/pose-storage-fixture.mjs +46 -0
  175. package/kits/hub-game/scripts/test-act-client.mjs +186 -0
  176. package/kits/hub-game/scripts/test-act.mjs +171 -0
  177. package/kits/hub-game/scripts/test-action-layout.mjs +80 -0
  178. package/kits/hub-game/scripts/test-action-observers.mjs +46 -0
  179. package/kits/hub-game/scripts/test-actions-client.mjs +367 -2
  180. package/kits/hub-game/scripts/test-actors.mjs +20 -7
  181. package/kits/hub-game/scripts/test-analytics.mjs +76 -0
  182. package/kits/hub-game/scripts/test-anonymous-entry.mjs +28 -0
  183. package/kits/hub-game/scripts/test-arrival-pose-server.mjs +196 -0
  184. package/kits/hub-game/scripts/test-arrival-pose.mjs +24 -0
  185. package/kits/hub-game/scripts/test-ask-slot.mjs +85 -0
  186. package/kits/hub-game/scripts/test-avatar-wire.mjs +49 -10
  187. package/kits/hub-game/scripts/test-avatar.mjs +44 -0
  188. package/kits/hub-game/scripts/test-back-visibility.mjs +82 -0
  189. package/kits/hub-game/scripts/test-ballot.mjs +11 -4
  190. package/kits/hub-game/scripts/test-ban-join.mjs +121 -13
  191. package/kits/hub-game/scripts/test-build.mjs +20 -2
  192. package/kits/hub-game/scripts/test-chat.mjs +206 -5
  193. package/kits/hub-game/scripts/test-companion-chat.mjs +20 -2
  194. package/kits/hub-game/scripts/test-control-layout-dom.mjs +120 -0
  195. package/kits/hub-game/scripts/test-crowd-names.mjs +205 -0
  196. package/kits/hub-game/scripts/test-decor-client.mjs +45 -4
  197. package/kits/hub-game/scripts/test-decor.mjs +7 -0
  198. package/kits/hub-game/scripts/test-default-environment-root.mjs +95 -0
  199. package/kits/hub-game/scripts/test-default-environment.mjs +267 -0
  200. package/kits/hub-game/scripts/test-door-analytics.mjs +58 -0
  201. package/kits/hub-game/scripts/test-door-jump.mjs +100 -0
  202. package/kits/hub-game/scripts/test-earned.mjs +33 -3
  203. package/kits/hub-game/scripts/test-far-avatars.mjs +340 -0
  204. package/kits/hub-game/scripts/test-fps-telemetry.mjs +112 -0
  205. package/kits/hub-game/scripts/test-frame-batch.mjs +252 -0
  206. package/kits/hub-game/scripts/test-fresh-friends.mjs +118 -0
  207. package/kits/hub-game/scripts/test-grab-orbit.mjs +47 -4
  208. package/kits/hub-game/scripts/test-high-only.mjs +170 -0
  209. package/kits/hub-game/scripts/test-hub-ops.mjs +321 -2
  210. package/kits/hub-game/scripts/test-hub-trip.mjs +879 -11
  211. package/kits/hub-game/scripts/test-hud-clear.mjs +162 -59
  212. package/kits/hub-game/scripts/test-hud-defects-dom.mjs +100 -0
  213. package/kits/hub-game/scripts/test-hud-rate.mjs +224 -0
  214. package/kits/hub-game/scripts/test-hud-safe-visibility-dom.mjs +83 -0
  215. package/kits/hub-game/scripts/test-idle.mjs +66 -0
  216. package/kits/hub-game/scripts/test-interest-cells.mjs +20 -0
  217. package/kits/hub-game/scripts/test-interest.mjs +15 -0
  218. package/kits/hub-game/scripts/test-invites-client.mjs +430 -0
  219. package/kits/hub-game/scripts/test-invites.mjs +109 -0
  220. package/kits/hub-game/scripts/test-labels.mjs +71 -3
  221. package/kits/hub-game/scripts/test-landscape-layout.mjs +194 -0
  222. package/kits/hub-game/scripts/test-list-scroll-dom.mjs +49 -0
  223. package/kits/hub-game/scripts/test-load-abandon.mjs +246 -0
  224. package/kits/hub-game/scripts/test-loading-cover.mjs +162 -0
  225. package/kits/hub-game/scripts/test-manifest.mjs +265 -0
  226. package/kits/hub-game/scripts/test-menu-client.mjs +105 -0
  227. package/kits/hub-game/scripts/test-menu.mjs +23 -0
  228. package/kits/hub-game/scripts/test-npcs.mjs +819 -10
  229. package/kits/hub-game/scripts/test-observed.mjs +745 -0
  230. package/kits/hub-game/scripts/test-pad-cues.mjs +304 -0
  231. package/kits/hub-game/scripts/test-pad-occupancy.mjs +177 -0
  232. package/kits/hub-game/scripts/test-picker.mjs +234 -7
  233. package/kits/hub-game/scripts/test-placement-cache.mjs +690 -0
  234. package/kits/hub-game/scripts/test-progress-reset.mjs +559 -0
  235. package/kits/hub-game/scripts/test-push-visit.mjs +26 -0
  236. package/kits/hub-game/scripts/test-quality.mjs +385 -0
  237. package/kits/hub-game/scripts/test-rehello.mjs +699 -5
  238. package/kits/hub-game/scripts/test-resume-action-order.mjs +598 -0
  239. package/kits/hub-game/scripts/test-resume-held.mjs +239 -0
  240. package/kits/hub-game/scripts/test-resume-pose.mjs +142 -0
  241. package/kits/hub-game/scripts/test-safe-events-dom.mjs +116 -0
  242. package/kits/hub-game/scripts/test-safe-layout.mjs +330 -0
  243. package/kits/hub-game/scripts/test-say.mjs +1 -1
  244. package/kits/hub-game/scripts/test-shot.mjs +145 -0
  245. package/kits/hub-game/scripts/test-signin-client.mjs +45 -0
  246. package/kits/hub-game/scripts/test-soundscape.mjs +22 -17
  247. package/kits/hub-game/scripts/test-standing.mjs +35 -2
  248. package/kits/hub-game/scripts/test-storage-limit.mjs +333 -0
  249. package/kits/hub-game/scripts/test-stuck.mjs +5 -4
  250. package/kits/hub-game/scripts/test-talk-overlay-dom.mjs +130 -0
  251. package/kits/hub-game/scripts/test-tiers-render.mjs +86 -13
  252. package/kits/hub-game/scripts/test-tiers.mjs +7 -8
  253. package/kits/hub-game/scripts/test-vis.mjs +433 -6
  254. package/kits/hub-game/scripts/test-weakest-tier.mjs +924 -0
  255. package/kits/hub-game/scripts/test-world-labels.mjs +367 -0
  256. package/kits/hub-game/scripts/test-yours-chrome.mjs +50 -6
  257. package/kits/hub-game/scripts/test-yours.mjs +39 -8
  258. package/kits/multiplayer-3d/castle.json +5 -5
  259. package/kits/multiplayer-3d/code/client/joinFailure.js +27 -0
  260. package/kits/multiplayer-3d/code/client/resumeGate.js +139 -0
  261. package/kits/multiplayer-3d/code/systems/multiplayer.js +369 -30
  262. package/kits/multiplayer-3d/package-lock.json +8 -1
  263. package/kits/multiplayer-3d/package.json +2 -1
  264. package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +436 -0
  265. package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +624 -0
  266. package/kits/physics-2d/CLAUDE.md +10 -1
  267. package/kits/physics-2d/castle.json +2 -2
  268. package/kits/physics-2d/engine/frozenActors.js +233 -0
  269. package/kits/physics-2d/engine/scene.js +87 -5
  270. package/kits/physics-2d/eslint.config.js +1 -1
  271. package/kits/physics-2d/play/behaviors/AnalogStick.js +198 -0
  272. package/kits/physics-2d/play/behaviors/Camera.js +40 -0
  273. package/kits/physics-2d/play/behaviors/Collider.js +122 -0
  274. package/kits/physics-2d/play/behaviors/Draggable.js +115 -0
  275. package/kits/physics-2d/play/behaviors/Goal.js +46 -0
  276. package/kits/physics-2d/play/behaviors/Joints.js +126 -0
  277. package/kits/physics-2d/play/behaviors/Layout.js +71 -0
  278. package/kits/physics-2d/play/behaviors/RigidBody.js +57 -0
  279. package/kits/physics-2d/play/behaviors/Slingshot.js +142 -0
  280. package/kits/physics-2d/play/behaviors/SoundPlayer.js +263 -0
  281. package/kits/physics-2d/play/behaviors/Sprite.js +406 -0
  282. package/kits/physics-2d/play/behaviors/Style.js +209 -0
  283. package/kits/physics-2d/play/behaviors/Text.js +85 -0
  284. package/kits/physics-2d/play/behaviors/Video.js +93 -0
  285. package/kits/physics-3d/CLAUDE.md +25 -1651
  286. package/kits/physics-3d/behaviors/Body.jsx +3 -0
  287. package/kits/physics-3d/behaviors/Model.jsx +3 -0
  288. package/kits/physics-3d/behaviors/Player.jsx +35 -18
  289. package/kits/physics-3d/behaviors/Shape.jsx +3 -0
  290. package/kits/physics-3d/behaviors/Solid.jsx +3 -0
  291. package/kits/physics-3d/behaviors/Transform.jsx +3 -0
  292. package/kits/physics-3d/castle.json +3 -3
  293. package/kits/physics-3d/docs/engine-camera.md +542 -0
  294. package/kits/physics-3d/docs/engine-frame-cap.md +136 -0
  295. package/kits/physics-3d/docs/engine-load.md +149 -0
  296. package/kits/physics-3d/docs/engine-look.md +114 -0
  297. package/kits/physics-3d/docs/engine-shadows.md +372 -0
  298. package/kits/physics-3d/docs/engine-skip-work.md +187 -0
  299. package/kits/physics-3d/docs/engine-sky.md +198 -0
  300. package/kits/physics-3d/docs/engine-static-actors.md +226 -0
  301. package/kits/physics-3d/docs/engine-view.md +37 -0
  302. package/kits/physics-3d/docs/pxmodel-format.md +1 -1
  303. package/kits/physics-3d/engine3d/PlayOnly3D.jsx +5 -1
  304. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +19 -333
  305. package/kits/physics-3d/engine3d/actornode.js +1 -0
  306. package/kits/physics-3d/engine3d/branches.js +3 -13
  307. package/kits/physics-3d/engine3d/cage.js +2 -7
  308. package/kits/physics-3d/engine3d/cageops.js +2 -17
  309. package/kits/physics-3d/engine3d/dataBehaviors.js +12 -0
  310. package/kits/physics-3d/engine3d/framecap.js +4 -1
  311. package/kits/physics-3d/engine3d/frozenphysics.js +140 -0
  312. package/kits/physics-3d/engine3d/frozenstatics.js +273 -0
  313. package/kits/physics-3d/engine3d/gait.js +8 -0
  314. package/kits/physics-3d/engine3d/initialModelFiles.js +18 -0
  315. package/kits/physics-3d/engine3d/look.js +7 -0
  316. package/kits/physics-3d/engine3d/modelFiles.js +3 -17
  317. package/kits/physics-3d/engine3d/modelMath.js +49 -0
  318. package/kits/physics-3d/engine3d/modelready.js +16 -0
  319. package/kits/physics-3d/engine3d/motion.js +3 -3
  320. package/kits/physics-3d/engine3d/nearshadows.js +77 -10
  321. package/kits/physics-3d/engine3d/orbitinput.js +59 -25
  322. package/kits/physics-3d/engine3d/partgeometry.js +1 -16
  323. package/kits/physics-3d/engine3d/paths.js +1 -9
  324. package/kits/physics-3d/engine3d/playTimings.js +50 -0
  325. package/kits/physics-3d/engine3d/playerRun.js +372 -0
  326. package/kits/physics-3d/engine3d/pxmodel.js +3 -3
  327. package/kits/physics-3d/engine3d/rapier.js +27 -0
  328. package/kits/physics-3d/engine3d/scatter.js +1 -11
  329. package/kits/physics-3d/engine3d/shadowfade.js +23 -15
  330. package/kits/physics-3d/engine3d/sky.js +1 -1
  331. package/kits/physics-3d/engine3d/squarefirst.js +177 -0
  332. package/kits/physics-3d/engine3d/stillshadows.js +399 -0
  333. package/kits/physics-3d/engine3d/sweep.js +1 -25
  334. package/kits/physics-3d/engine3d/world3d.js +468 -18
  335. package/kits/physics-3d/eslint.config.js +2 -1
  336. package/kits/physics-3d/main.jsx +6 -3
  337. package/kits/physics-3d/package-lock.json +7 -0
  338. package/kits/physics-3d/package.json +5 -1
  339. package/kits/physics-3d/play/behaviors/Body.js +31 -0
  340. package/kits/physics-3d/play/behaviors/Door.js +37 -0
  341. package/kits/physics-3d/play/behaviors/Lookable.js +16 -0
  342. package/kits/physics-3d/play/behaviors/Model.js +23 -0
  343. package/kits/physics-3d/play/behaviors/Pickup.js +46 -0
  344. package/kits/physics-3d/play/behaviors/Player.js +1204 -0
  345. package/kits/physics-3d/play/behaviors/Shape.js +47 -0
  346. package/kits/physics-3d/play/behaviors/Solid.js +16 -0
  347. package/kits/physics-3d/play/behaviors/Transform.js +29 -0
  348. package/kits/physics-3d/pnpm-lock.yaml +8 -0
  349. package/kits/physics-3d/scripts/bench-shadow-fade.mjs +37 -0
  350. package/kits/physics-3d/scripts/build-rapier-gz.mjs +56 -0
  351. package/kits/physics-3d/scripts/frozen-statics-fixture.mjs +141 -0
  352. package/kits/physics-3d/scripts/test-camera-follow.mjs +5 -1
  353. package/kits/physics-3d/scripts/test-camera-orbit.mjs +52 -4
  354. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +1 -1
  355. package/kits/physics-3d/scripts/test-empty-gait-hints.mjs +89 -0
  356. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +6 -3
  357. package/kits/physics-3d/scripts/test-frame-cap.mjs +1 -1
  358. package/kits/physics-3d/scripts/test-frozen-nested.mjs +49 -0
  359. package/kits/physics-3d/scripts/test-frozen-statics-legacy-physics2d.mjs +123 -0
  360. package/kits/physics-3d/scripts/test-frozen-statics.mjs +434 -0
  361. package/kits/physics-3d/scripts/test-look-bake.mjs +1 -1
  362. package/kits/physics-3d/scripts/test-near-shadows.mjs +2 -2
  363. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +88 -7
  364. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +40 -3
  365. package/kits/physics-3d/scripts/test-orbit-shot.mjs +75 -1
  366. package/kits/physics-3d/scripts/test-rapier-gz.mjs +106 -0
  367. package/kits/physics-3d/scripts/test-sky.mjs +1 -1
  368. package/kits/physics-3d/scripts/test-square-first.mjs +921 -0
  369. package/kits/physics-3d/scripts/test-static-actors.mjs +3 -1
  370. package/kits/physics-3d/scripts/test-static-physics.mjs +4 -1
  371. package/kits/physics-3d/scripts/test-static-scenery.mjs +5 -2
  372. package/kits/physics-3d/scripts/test-steady-hover.mjs +5 -2
  373. package/kits/physics-3d/scripts/test-still-shadows.mjs +477 -0
  374. package/kits/physics-3d/systems/physics3d.js +37 -4
  375. package/kits/real-time/castle.json +2 -2
  376. package/kits/real-time/code/client/connection.js +33 -10
  377. package/kits/real-time/code/client/gameHooks.js +2 -0
  378. package/kits/real-time/code/client/joinOverlay.js +9 -4
  379. package/kits/real-time/code/server/session.js +6 -4
  380. package/kits/real-time/package-lock.json +1 -1
  381. package/package.json +2 -2
@@ -0,0 +1,205 @@
1
+ // Opt-in client budgets. State belongs to the runtime, never the transport or
2
+ // authored files. The load entry installs the filter before SceneRuntime.load.
3
+ import { deck, hub } from './state.js';
4
+ import { skippableDecor } from '../shared/quality.js';
5
+
6
+ const visits = new WeakMap();
7
+ // Gameplay lookups and caches need sleeping district actors too; getActors()
8
+ // is the runtime's awake-only list for live update and animation work.
9
+ export const allActors = (scene) => scene.actors ? [...scene.actors.values()] : scene.getActors();
10
+ export const qualityFor = (scene) => visits.get(scene);
11
+ export const lowQuality = (scene) => !scene.content && qualityFor(scene)?.tiers.current() === 'low' ? deck.quality?.low : null;
12
+ const distance = (a, b) => a && b ? Math.hypot((a.x ?? 0) - (b.x ?? 0), (a.z ?? 0) - (b.z ?? 0)) : Infinity;
13
+
14
+ export function noteQualityInteraction(scene, playerId, now = performance.now()) {
15
+ const q = qualityFor(scene);
16
+ if (q && playerId) {q.recent.set(playerId, now + 10000);}
17
+ }
18
+
19
+ // Existing winners count as 2 m nearer. Exemptions consume no slots.
20
+ export function choosePlayers(players, most, previous = new Set()) {
21
+ const exempt = players.filter((p) => p.exempt);
22
+ const ranked = players.filter((p) => !p.exempt).sort((a, b) =>
23
+ (a.distance - (previous.has(a.id) ? 2 : 0)) - (b.distance - (previous.has(b.id) ? 2 : 0)) || String(a.id).localeCompare(String(b.id)));
24
+ return new Set([...exempt, ...ranked.slice(0, most)].map((p) => p.id));
25
+ }
26
+
27
+ export function samePad(scene, here, there, pads = allActors(scene)) {
28
+ if (!here || !there) {return false;}
29
+ return pads.some((actor) => {
30
+ const c = actor.components;
31
+ if (!c?.HubPad || !c.Transform) {return false;}
32
+ if (hub.hidden.has(actor.id)) {return false;}
33
+ const radius = c.HubPad.radius ?? c.Shape?.radius ?? 2.3;
34
+ return distance(c.Transform, here) <= radius && distance(c.Transform, there) <= radius;
35
+ });
36
+ }
37
+
38
+ export function makeQualityVisit(tiers) {
39
+ return { tiers, skipped: [], drawn: new Set(), hidden: new Map(), recent: new Map(), emotes: new Map(), nextMind: new Map(), culled: new Set() };
40
+ }
41
+
42
+ export function resetQualityVisit(q) {
43
+ q.skipped = [];
44
+ q.drawn.clear(); q.culled.clear(); q.recent.clear(); q.emotes.clear(); q.nextMind.clear();
45
+ q.npcData = null; q.padData = null;
46
+ restorePlayers(q);
47
+ }
48
+
49
+ export function filterQualityScene(scene, data, q, componentsOf = (actor) => actor.components, protectedIds = new Set()) {
50
+ visits.set(scene, q);
51
+ resetQualityVisit(q);
52
+ if (deck.quality && !q.warned && !(data.actors ?? []).some((actor) => actor.decor === true)) {
53
+ console.warn('[hub] hub.quality.low.spawned has no decor: true templates; the cap has no effect.');
54
+ q.warned = true;
55
+ }
56
+ if (scene.content || q.tiers.current() !== 'low') {return data;}
57
+ const skipDecor = deck.quality?.low.decor === 'skip';
58
+ if (!skipDecor && !deck.highOnly) {return data;}
59
+ const actors = (data.actors ?? []).filter((actor) => {
60
+ const components = componentsOf(actor);
61
+ const highOnly = deck.highOnly === true && actor.tier === 'high';
62
+ if (!highOnly && (!skipDecor || protectedIds.has(actor.id) || !skippableDecor(actor, components))) {return true;}
63
+ q.skipped.push({ ...actor, components });
64
+ return false;
65
+ });
66
+ return { ...data, actors };
67
+ }
68
+
69
+ // Cooperative 8 ms slice including the engine's synchronous node build. No
70
+ // further actor is admitted after the budget; synchronous engine work cannot
71
+ // be preempted halfway through a single model.
72
+ export function restoreDecor(scene, q, build, clock = () => performance.now()) {
73
+ if (q.tiers.current() !== 'high' || !q.skipped.length || scene.content) {return;}
74
+ const start = clock();
75
+ let cost = 0;
76
+ while (q.skipped.length && clock() - start + cost < 8) {
77
+ const before = clock();
78
+ const actor = q.skipped.shift();
79
+ if (!scene.getActor(actor.id)) {
80
+ scene.spawnActor(structuredClone(actor));
81
+ build(scene);
82
+ }
83
+ cost = Math.max(cost, clock() - before);
84
+ }
85
+ }
86
+
87
+ function restorePlayers(q) {
88
+ for (const [node, visible] of q.hidden) {node.visible = visible;}
89
+ q.hidden.clear();
90
+ }
91
+
92
+ export function qualityPlayers(scene, q, now) {
93
+ restorePlayers(q);
94
+ const low = lowQuality(scene);
95
+ q.culled.clear();
96
+ if (!low) { q.drawn.clear(); applyPlayerVisibility(scene, q); return; }
97
+ const mp = scene.multiplayer;
98
+ const here = scene.actorWith('Player')?.components.Transform;
99
+ const players = [];
100
+ const self = mp?.net?.selfId?.();
101
+ if (q.padData !== scene.data || q.padMap !== scene.actors || q.padCount !== scene.actors?.size) {
102
+ q.padData = scene.data; q.padMap = scene.actors; q.padCount = scene.actors?.size;
103
+ q.pads = allActors(scene).filter((actor) => actor.components?.HubPad);
104
+ }
105
+ for (const [id, actorId] of mp?.avatars?.actors ?? []) {
106
+ if (id === self) {continue;}
107
+ const there = scene.getActor(actorId)?.components.Transform;
108
+ const emote = hub.emotes[id];
109
+ if (emote && q.emotes.get(id) !== emote.at) {
110
+ q.emotes.set(id, emote.at);
111
+ // Snapshot playback is not a new action: the simulation timestamp
112
+ // bounds the exemption even when joining or reconnecting.
113
+ const age = Math.max(0, (hub.lastT ?? 0) - emote.at);
114
+ if (age < 10000) {q.recent.set(id, now + 10000 - age);}
115
+ }
116
+ players.push({ id, actorId, distance: distance(here, there), exempt: hub.party.members?.includes(id) === true ||
117
+ samePad(scene, here, there, q.pads) || (q.recent.get(id) ?? -Infinity) > now });
118
+ }
119
+ q.drawn = choosePlayers(players, low.players, q.drawn);
120
+ for (const player of players) {
121
+ if (q.drawn.has(player.id)) {continue;}
122
+ q.culled.add(player.actorId);
123
+ }
124
+ applyPlayerVisibility(scene, q);
125
+ // The engine builds/replaces nodes after systems run. Scene.onBeforeRender
126
+ // is called before Three collects its draw list, so a newly built bystander
127
+ // never flashes for a frame. Existing avatar-cap/far-avatar state stays live.
128
+ const root = scene.three?.scene;
129
+ if (root && q.renderRoot !== root) {
130
+ const previous = root.onBeforeRender;
131
+ root.onBeforeRender = function (...args) {
132
+ previous?.apply(this, args);
133
+ applyPlayerVisibility(scene, q);
134
+ };
135
+ q.renderRoot = root;
136
+ }
137
+ for (const [id, until] of q.recent) {if (until <= now) {q.recent.delete(id);}}
138
+ }
139
+
140
+ export function applyPlayerVisibility(scene, q) {
141
+ restorePlayers(q);
142
+ const nodes = new Set();
143
+ for (const id of q.culled) {
144
+ const node = scene.three?.nodes?.get(id)?.node;
145
+ if (node) { q.hidden.set(node, node.visible); node.visible = false; nodes.add(node); }
146
+ }
147
+ if (nodes.size !== q.culledNodes?.size || [...nodes].some((node) => !q.culledNodes?.has(node))) {
148
+ // Shared instances live outside avatar roots. Their matrices were gathered
149
+ // by syncActors before Scene.onBeforeRender, so refresh on a changed cap
150
+ // (including a newly built/replaced node), never every unchanged frame.
151
+ q.culledNodes = nodes;
152
+ q.refreshInstances?.(scene);
153
+ }
154
+ }
155
+
156
+ export function talkActors(scene) {
157
+ const q = qualityFor(scene);
158
+ if (!lowQuality(scene)) {return scene.getActors();}
159
+ if (q.npcData !== scene.data || q.npcMap !== scene.actors || q.npcCount !== scene.actors?.size) {
160
+ q.npcData = scene.data; q.npcMap = scene.actors; q.npcCount = scene.actors?.size;
161
+ q.npcs = allActors(scene).filter((actor) => actor.components?.HubNpc);
162
+ }
163
+ return q.npcs.map((actor) => scene.getActor(actor.id)).filter(Boolean);
164
+ }
165
+
166
+ // Apply after the existing label rule, so its three slots and 12/14 m edge
167
+ // still win. Pointers never enter this list. Party labels consume no slots.
168
+ export function capLabels(items, most, distanceOf, exempt = () => false) {
169
+ const keep = new Set(items.filter((item) => item.kind === 'pointer' || exempt(item)).map((item) => item.id));
170
+ const ranked = items.filter((item) => !keep.has(item.id)).sort((a, b) => distanceOf(a) - distanceOf(b) || String(a.id).localeCompare(String(b.id)));
171
+ for (const item of ranked.slice(0, most)) {keep.add(item.id);}
172
+ return items.filter((item) => keep.has(item.id));
173
+ }
174
+
175
+ // Rendering ids can change with label style; actorId always names the world
176
+ // anchor. Captions admitted by the existing near-label rule consume no slots.
177
+ export function capWorldLabels(items, placed, local, most, party) {
178
+ const anchors = new Map(placed.map(({ id, at }) => [id, at]));
179
+ const actorId = (item) => item.actorId ?? item.id;
180
+ return capLabels(items, most, (item) => distance(local, anchors.get(actorId(item))),
181
+ (item) => item.qualityNear === true || party.has(actorId(item)));
182
+ }
183
+
184
+ export function qualitySpawnIds(want, templates, here, most) {
185
+ const decor = Object.entries(want).filter(([, copy]) => templates[copy.from]?.decor === true)
186
+ .sort((a, b) => distance(here, a[1]) - distance(here, b[1]) || a[0].localeCompare(b[0]));
187
+ return new Set([...Object.entries(want).filter(([, copy]) => templates[copy.from]?.decor !== true).map(([id]) => id),
188
+ ...decor.slice(0, most).map(([id]) => id)]);
189
+ }
190
+
191
+ // Only the far NPC's prompt descriptor work is throttled; event draining,
192
+ // panel work and nearby/conversing NPCs always run in the current frame.
193
+ export function mindDue(scene, actor, local, talking, now) {
194
+ const low = lowQuality(scene);
195
+ if (!low) {return true;}
196
+ const props = actor.components?.HubNpc;
197
+ const at = actor.components?.Transform;
198
+ const d = distance(local, at);
199
+ const edge = deck.lowActorDistance && Number.isFinite(actor.lowDrawDistance) && actor.lowDrawDistance > 0 ? actor.lowDrawDistance : 20;
200
+ if (actor.id === talking || d <= edge || d <= (props?.talkRange ?? 3.5)) {return true;}
201
+ const q = qualityFor(scene);
202
+ if (now < (q.nextMind.get(actor.id) ?? -Infinity)) {return false;}
203
+ q.nextMind.set(actor.id, now + 1000 / low.farMindsHz);
204
+ return true;
205
+ }
@@ -0,0 +1,55 @@
1
+ // Both hub entries evaluate this after the engine modules, before mounting a
2
+ // player. A system installer is too late: the constructor already called load.
3
+ import { isEdit } from 'castle-web-sdk';
4
+ import { SceneRuntime } from '@imports/castle.physics-2d/engine/scene';
5
+ import { getBlueprintTemplate, mergeComponents } from '@imports/castle.physics-2d/engine/blueprint';
6
+ import { drawInstances } from '@imports/castle.physics-3d/engine3d/optimize';
7
+ import { syncActors } from '@imports/castle.physics-3d/engine3d/world3d';
8
+ import { deck } from './state.js';
9
+ import { makeTiers } from './tiers.js';
10
+ import { readQuality } from '../shared/quality.js';
11
+ import { filterQualityScene, makeQualityVisit, qualityFor, resetQualityVisit } from './quality.js';
12
+
13
+ const config = Object.values(import.meta.glob('/castle.json', { eager: true, import: 'default' }))[0] ?? {};
14
+
15
+ // Before the player's renderer exists, a short-lived context gives exactly the
16
+ // same GPU string. Release it immediately so it consumes no persistent context.
17
+ function pickBeforeBuild(tiers, renderer) {
18
+ if (renderer) {return tiers.pick(renderer);}
19
+ let gl;
20
+ try {
21
+ const canvas = globalThis.document?.createElement?.('canvas');
22
+ gl = canvas?.getContext?.('webgl2') ?? canvas?.getContext?.('webgl');
23
+ return tiers.pick({ getContext: () => gl });
24
+ } catch { return tiers.pick(null); }
25
+ finally { try { gl?.getExtension?.('WEBGL_lose_context')?.loseContext(); } catch { /* Optional hint context. */ } }
26
+ }
27
+
28
+ export function installQualityLoad(Runtime, { make = makeTiers, componentsOf, protectedIds = new Set(), pick = pickBeforeBuild, build = (scene) => syncActors(scene.three, scene, scene.sprites, 0) } = {}) {
29
+ if (!deck.quality && !deck.highOnly) {return () => {};}
30
+ const original = Runtime.prototype.load;
31
+ Runtime.prototype.load = function (data) {
32
+ if (!deck.quality && !deck.highOnly) {return original.call(this, data);}
33
+ if (this.content) {
34
+ const q = qualityFor(this);
35
+ if (q) {resetQualityVisit(q);}
36
+ return original.call(this, data);
37
+ }
38
+ const q = qualityFor(this) ?? makeQualityVisit(make({ weakest: deck.weakestTier === true }));
39
+ pick(q.tiers, this.three?.renderer);
40
+ q.build = build;
41
+ q.refreshInstances = (scene) => {
42
+ for (const instances of scene.three?.instances?.values() ?? []) {drawInstances(instances, scene.three.camera);}
43
+ };
44
+ const resolve = componentsOf ? (actor) => componentsOf(this, actor) : (actor) => mergeComponents(
45
+ actor.blueprint ? getBlueprintTemplate(this.files, actor.blueprint, this.scenePath)?.components : null, actor.components);
46
+ return original.call(this, filterQualityScene(this, data, q, resolve, protectedIds));
47
+ };
48
+ return () => { Runtime.prototype.load = original; };
49
+ }
50
+
51
+ if ((config.hub?.quality !== undefined || config.hub?.highOnly === true) && config.hub?.tiers === true && !isEdit()) {
52
+ if (config.hub.quality !== undefined) {deck.quality = readQuality(config.hub.quality, true, []);}
53
+ if (config.hub.highOnly === true) {deck.highOnly = true;}
54
+ installQualityLoad(SceneRuntime);
55
+ }
@@ -0,0 +1,338 @@
1
+ // v1.123: optional client-only safe edges and host-owned corners. Geometry is
2
+ // shared with HUD clearance; the DOM controller runs only for hub.safeInsets.
3
+ import { pushBelow } from './hudClear.js';
4
+ import { makeSafeStyle } from './safeStyle.js';
5
+
6
+ export const overlaps = (a, b) => a.left < b.right && a.right > b.left && a.top < b.bottom && a.bottom > b.top;
7
+ const rect = (x, y, w, h) => ({ left: x, top: y, right: x + w, bottom: y + h });
8
+ const finite = (n) => Number.isFinite(n) ? Math.max(0, n) : 0;
9
+
10
+ export function reservedCorners({ w, insets }) {
11
+ return [
12
+ { id: 'host-back', x: insets.left, y: insets.top, w: 64, h: 56 },
13
+ { id: 'host-camera', x: w - insets.right - 64, y: insets.top, w: 64, h: 56 },
14
+ ];
15
+ }
16
+
17
+ export function safePlacement(box, view, margin = {}, bands = []) {
18
+ const bounds = {
19
+ left: Math.max(margin.left ?? 6, view.insets.left),
20
+ right: view.w - Math.max(margin.right ?? 6, view.insets.right),
21
+ top: Math.max(margin.top ?? 6, view.insets.top),
22
+ bottom: view.h - Math.max(margin.bottom ?? 6, view.insets.bottom),
23
+ };
24
+ const w = Math.min(box.right - box.left, Math.max(0, bounds.right - bounds.left));
25
+ let h = Math.min(box.bottom - box.top, Math.max(0, bounds.bottom - bounds.top));
26
+ const x = Math.max(bounds.left, Math.min(box.left, bounds.right - w));
27
+ let y = Math.max(bounds.top, Math.min(box.top, bounds.bottom - h));
28
+ // All moves out from under a band go straight down, exactly as HUD v1.26.
29
+ // Sorting also handles a control immediately below a reserved corner.
30
+ for (const band of [...bands].sort((a, b) => a.bottom - b.bottom)) {
31
+ const desired = pushBelow(rect(x, y, w, h), band, 6);
32
+ if (desired && y + desired + h > bounds.bottom && band.bottom + 6 < bounds.bottom) {
33
+ h = Math.min(h, bounds.bottom - band.bottom - 6);
34
+ y = band.bottom + 6;
35
+ }
36
+ y += pushBelow(rect(x, y, w, h), band, 6, bounds.bottom);
37
+ }
38
+ return { x, y, w, h };
39
+ }
40
+
41
+ // A modal/card may scroll in a free vertical interval instead of covering the
42
+ // controls it leaves visible. Unlike a projected label, it has no world anchor.
43
+ export function panelPlacement(box, view, margin = {}, bands = []) {
44
+ const base = safePlacement(box, view, margin);
45
+ const top = Math.max(margin.top ?? 6, view.insets.top);
46
+ const bottom = view.h - Math.max(margin.bottom ?? 6, view.insets.bottom);
47
+ const left = Math.max(margin.left ?? 6, view.insets.left);
48
+ const right = view.w - Math.max(margin.right ?? 6, view.insets.right);
49
+ const candidates = [];
50
+ // A narrow, wrapped card can use a side lane when the full-width card has
51
+ // only a sliver left between controls. Never shrink height below its padding
52
+ // when a wider vertical interval is available alongside the column.
53
+ const starts = [base.x, left, ...bands.map((band) => band.right + 6)].filter((x) => x >= left && x < right);
54
+ for (const x of starts) {
55
+ const widths = [Math.min(base.w, right - x), ...bands.map((band) => Math.min(base.w, band.left - 6 - x))].filter((w) => w >= Math.min(160, base.w));
56
+ for (const w of widths) {
57
+ let intervals = [[top, bottom]];
58
+ for (const band of bands) {
59
+ if (x >= band.right || x + w <= band.left) {continue;}
60
+ intervals = intervals.flatMap(([a, b]) => {
61
+ if (band.bottom + 6 <= a || band.top - 6 >= b) {return [[a, b]];}
62
+ return [[a, Math.min(b, band.top - 6)], [Math.max(a, band.bottom + 6), b]].filter(([lo, hi]) => hi > lo);
63
+ });
64
+ }
65
+ for (const [a, b] of intervals) {
66
+ const h = Math.min(base.h, b - a);
67
+ const y = Math.max(a, Math.min(base.y, b - h));
68
+ candidates.push({ x, y, w, h, distance: Math.abs(y - base.y) + Math.abs(x - base.x) });
69
+ }
70
+ }
71
+ }
72
+ if (!candidates.length) {return safePlacement(box, view, margin, bands);}
73
+ candidates.sort((a, b) => Number(b.h >= base.h) - Number(a.h >= base.h) || b.w * b.h - a.w * a.h || a.distance - b.distance);
74
+ const { distance, ...placed } = candidates[0];
75
+ return placed;
76
+ }
77
+
78
+ // One bottom-up column for controls that formerly had independent offsets.
79
+ // A short view starts another column to the left rather than covering a peer.
80
+ export function stackPlacement(sizes, view, ceiling, gap = 6) {
81
+ const bottom = view.h - Math.max(10, view.insets.bottom);
82
+ const right = view.w - Math.max(12, view.insets.right);
83
+ let edge = right, y = bottom, width = 0;
84
+ return sizes.map(({ w, h }) => {
85
+ if (y !== bottom && y - h < ceiling) {edge -= width + gap; y = bottom; width = 0;}
86
+ y -= h;
87
+ const placed = { x: edge - w, y, w, h };
88
+ width = Math.max(width, w); y -= gap;
89
+ return placed;
90
+ });
91
+ }
92
+
93
+ const visibleRect = (node) => {
94
+ if (!node?.getBoundingClientRect || node.isConnected === false) {return null;}
95
+ for (let parent = node; parent; parent = parent.parentElement ?? parent.parent) {
96
+ const style = globalThis.getComputedStyle?.(parent) ?? parent.style;
97
+ if (style?.display === 'none' || style?.visibility === 'hidden' || style?.opacity === '0') {return null;}
98
+ }
99
+ const box = node.getBoundingClientRect();
100
+ return box.width > 0 && box.height > 0 ? box : null;
101
+ };
102
+
103
+ export function makeSafeLayout({ root, entries, view = globalThis.window, hud = () => null, onLayout = () => {} }) {
104
+ const probe = document.createElement('div');
105
+ probe.style.cssText = 'position:fixed;inset:0;visibility:hidden;pointer-events:none;padding-top:env(safe-area-inset-top);padding-right:env(safe-area-inset-right);padding-bottom:env(safe-area-inset-bottom);padding-left:env(safe-area-inset-left)';
106
+ root.appendChild(probe);
107
+ const corrections = makeSafeStyle(root);
108
+ const write = corrections.write;
109
+ let cachedView = null, insetsDirty = true;
110
+ let checkedAt = -Infinity, timer = null;
111
+ let disposed = false, last = null, forced = false;
112
+ const observers = new Map(), pending = new Map();
113
+ let projected = new WeakSet();
114
+ const readView = () => {
115
+ const css = globalThis.getComputedStyle?.(probe);
116
+ const insets = Object.fromEntries(['top', 'right', 'bottom', 'left'].map((side) => [side, finite(Number.parseFloat(css?.[`padding${side[0].toUpperCase()}${side.slice(1)}`]))]));
117
+ insetsDirty = false;
118
+ for (const [side, value] of Object.entries(insets)) {if (typeof root.style.setProperty === 'function') {root.style.setProperty(`--hub-safe-inset-${side}`, `${value}px`);}}
119
+ return cachedView = { w: view.innerWidth, h: view.innerHeight, insets };
120
+ };
121
+ const watch = (node) => {
122
+ if (!node || observers.has(node) || !globalThis.MutationObserver) {return;}
123
+ if (node !== root && root.contains?.(node)) {return;}
124
+ const observer = new globalThis.MutationObserver(schedule);
125
+ observers.set(node, observer);
126
+ observer.observe(node, { subtree: true, childList: true, attributes: true, characterData: true, attributeOldValue: true, characterDataOldValue: true });
127
+ };
128
+ // Observer delivery only queues records. In particular it never walks DOM
129
+ // or reads styles while the renderer is updating a frame.
130
+ function schedule(records) {
131
+ if (disposed) {return;}
132
+ if (records?.length) {
133
+ for (const record of records) {
134
+ if (record.target && projected.has(record.target)) {continue;}
135
+ if (!pending.has(record.target)) {pending.set(record.target, new Map());}
136
+ const changes = pending.get(record.target);
137
+ const key = record.type === 'attributes' ? record.attributeName : record.type;
138
+ if (!changes.has(key)) {changes.set(key, record);}
139
+ }
140
+ } else {forced = true;}
141
+ if (timer === null) {
142
+ timer = setTimeout(() => {timer = null; update();}, Math.max(0, 500 - (performance.now() - checkedAt)));
143
+ }
144
+ }
145
+ function update() {
146
+ if (disposed) {return last;}
147
+ checkedAt = performance.now();
148
+ let dirty = forced;
149
+ for (const [node, changes] of pending) {
150
+ for (const record of changes.values()) {
151
+ if (record.type === 'attributes') {
152
+ if (record.oldValue !== node.getAttribute?.(record.attributeName)) {dirty = true;}
153
+ } else if (record.type === 'characterData') {
154
+ if (record.oldValue !== node.data) {dirty = true;}
155
+ } else {dirty = true;}
156
+ }
157
+ }
158
+ pending.clear(); forced = false;
159
+ return dirty ? flush() : last;
160
+ }
161
+ function flush() {
162
+ if (disposed) {return last;}
163
+ clearTimeout(timer); timer = null;
164
+ pending.clear(); forced = false;
165
+ checkedAt = performance.now();
166
+ for (const observer of observers.values()) {observer.disconnect();}
167
+ corrections.clear();
168
+ const current = entries().filter((entry) => entry.node);
169
+ projected = new WeakSet(current.filter(entry => entry.projected).map(entry => entry.node));
170
+ const viewport = insetsDirty || !cachedView ? readView() : { ...cachedView, w: view.innerWidth, h: view.innerHeight };
171
+ const reserved = reservedCorners(viewport);
172
+ const corners = reserved.map((box) => rect(box.x, box.y, box.w, box.h));
173
+ // Measure the current connected controls together after restoring all
174
+ // baselines. A picker's button moves its parent so its card stays attached.
175
+ const stack = current.filter((entry) => entry.stack !== undefined)
176
+ .sort((a, b) => a.stack - b.stack)
177
+ .map((entry) => ({ entry, box: visibleRect(entry.node) })).filter((item) => item.box);
178
+ const ceiling = Math.max(viewport.insets.top + 62,
179
+ ...current.filter((entry) => entry.id === 'sound').map((entry) => {
180
+ const box = visibleRect(entry.node); return box ? Math.max(box.bottom, viewport.insets.top + 56 + box.height) + 6 : 0;
181
+ }));
182
+ const placements = stackPlacement(stack.map(({ box }) => ({ w: box.width, h: box.height })), viewport, ceiling);
183
+ stack.forEach(({ entry, box }, index) => {
184
+ const at = placements[index];
185
+ write(entry.stackNode ?? entry.node, 'translate', `${at.x - box.left}px ${at.y - box.top}px`);
186
+ });
187
+ const controls = [];
188
+ const transient = [];
189
+ // Controls are placed before transient text, which yields to their boxes.
190
+ const priority = (entry) => entry.transient ? 2 : entry.kind === 'card' ? 1 : 0;
191
+ current.sort((a, b) => priority(a) - priority(b));
192
+ for (const entry of current) {
193
+ if (entry.projected) {continue;}
194
+ const { node, kind, margin } = entry;
195
+ let box = visibleRect(node);
196
+ if (!box) {continue;}
197
+ const bands = [...corners];
198
+ if (entry.transient) {
199
+ const hudBox = visibleRect(hud());
200
+ if (hudBox && node !== hud()) {bands.push(hudBox);}
201
+ bands.push(...controls);
202
+ bands.push(...transient);
203
+ }
204
+ if (kind === 'card') {
205
+ bands.push(...controls);
206
+ const hudBox = visibleRect(hud());
207
+ if (hudBox) {bands.push(hudBox);}
208
+ }
209
+ const place = (value) => kind === 'card' ? panelPlacement(value, viewport, margin, bands) : safePlacement(value, viewport, margin, bands);
210
+ let placed = place(box);
211
+ // The centered HUD title row has a lane between both native corners.
212
+ if (kind === 'hud' && box.top < viewport.insets.top + 56) {
213
+ const lane = Math.max(0, viewport.w - viewport.insets.left - viewport.insets.right - 128);
214
+ placed.w = Math.min(placed.w, lane);
215
+ }
216
+ if (box.width > placed.w || node.scrollWidth > node.clientWidth + 1) {
217
+ write(node, 'boxSizing', 'border-box');
218
+ write(node, 'maxWidth', `${placed.w}px`);
219
+ write(node, 'whiteSpace', 'normal');
220
+ write(node, 'overflowWrap', 'anywhere');
221
+ }
222
+ if (kind === 'hud') {
223
+ for (const child of node.children) {
224
+ // The clear-HUD path may have clamped or ellipsized an inner line.
225
+ // The opted-in rule keeps those words reachable instead.
226
+ write(child, 'maxWidth', `${placed.w}px`);
227
+ write(child, 'whiteSpace', 'normal');
228
+ write(child, 'overflowWrap', 'anywhere');
229
+ // Copy rows own their two-line clipping and empty-row visibility.
230
+ if (child.dataset?.hubCopy) {continue;}
231
+ write(child, 'overflow', 'visible');
232
+ write(child, 'textOverflow', '');
233
+ write(child, 'webkitLineClamp', '');
234
+ }
235
+ }
236
+ if (box.height > placed.h) {
237
+ write(node, 'boxSizing', 'border-box');
238
+ write(node, 'maxHeight', `${placed.h}px`);
239
+ write(node, 'overflowY', 'auto');
240
+ }
241
+ box = visibleRect(node);
242
+ if (!box) {continue;}
243
+ placed = place(box);
244
+ if (box.height > placed.h) {
245
+ write(node, 'boxSizing', 'border-box');
246
+ write(node, 'maxHeight', `${placed.h}px`);
247
+ write(node, 'overflowY', 'auto');
248
+ box = visibleRect(node);
249
+ if (!box) {continue;}
250
+ placed = place(box);
251
+ }
252
+ // CSS translate is independent of the renderer's anchoring transform.
253
+ const dx = placed.x - box.left, dy = placed.y - box.top;
254
+ if (dx || dy) {write(node, 'translate', `${dx}px ${dy}px`);}
255
+ const final = visibleRect(node);
256
+ if (final && !entry.transient && kind !== 'hud' && kind !== 'label' && kind !== 'pointer') {controls.push(final);}
257
+ if (final && entry.transient) {transient.push(final);}
258
+ }
259
+ const boxes = [];
260
+ for (const entry of current) {
261
+ const reported = entry.reportNodes?.() ?? [{ node: entry.node, id: entry.id, kind: entry.kind }];
262
+ for (const item of reported) {
263
+ const box = visibleRect(item.node);
264
+ if (box) {boxes.push({ id: item.id, kind: item.kind, x: box.left, y: box.top, w: box.width, h: box.height });}
265
+ }
266
+ }
267
+ last = { view: viewport, reserved, boxes };
268
+ sizes?.disconnect();
269
+ sizes?.observe(root);
270
+ sizes?.observe(probe);
271
+ for (const entry of current) {
272
+ watch(entry.node);
273
+ if (!entry.projected) {sizes?.observe(entry.node);}
274
+ }
275
+ const watched = new Set([root, ...current.map((entry) => entry.node).filter((node) => !root.contains?.(node))]);
276
+ for (const [node, observer] of observers) {
277
+ if (node.isConnected === false || !watched.has(node)) {observer.disconnect(); observers.delete(node);}
278
+ else {observer.observe(node, { subtree: true, childList: true, attributes: true, characterData: true, attributeOldValue: true, characterDataOldValue: true });}
279
+ }
280
+
281
+ onLayout();
282
+ return last;
283
+ }
284
+ watch(root);
285
+ // Cover and viewport changes are explicit events, never frame work.
286
+ const coverObserver = globalThis.MutationObserver && document.documentElement
287
+ ? new globalThis.MutationObserver(() => {queueMicrotask(() => {if (!disposed) {flush();}});}) : null;
288
+ coverObserver?.observe(document.documentElement, { attributes: true, attributeFilter: ['data-hub-loading'] });
289
+ const resize = () => {insetsDirty = true; schedule();};
290
+ const ancestorObserver = globalThis.MutationObserver ? new globalThis.MutationObserver(schedule) : null;
291
+ for (let parent = root.parentElement ?? root.parent; parent; parent = parent.parentElement ?? parent.parent) {
292
+ ancestorObserver?.observe(parent, { attributes: true, attributeOldValue: true });
293
+ }
294
+ const dimensions = new WeakMap();
295
+ const sizes = globalThis.ResizeObserver ? new globalThis.ResizeObserver((records) => {
296
+ let different = false;
297
+ for (const { target, contentRect } of records) {
298
+ const key = `${contentRect.width}:${contentRect.height}`;
299
+ if (dimensions.get(target) !== key) {different = true; dimensions.set(target, key);}
300
+ }
301
+ if (different) {schedule();}
302
+ }) : null;
303
+ sizes?.observe(root);
304
+ sizes?.observe(probe);
305
+ const fonts = globalThis.document?.fonts;
306
+ fonts?.addEventListener?.('loadingdone', schedule);
307
+ view.addEventListener?.('resize', resize);
308
+ view.addEventListener?.('orientationchange', resize);
309
+ view.visualViewport?.addEventListener?.('resize', resize);
310
+ view.visualViewport?.addEventListener?.('scroll', resize);
311
+ readView();
312
+ return {
313
+ view: () => cachedView,
314
+ watch,
315
+ schedule,
316
+ begin: () => {},
317
+ flush,
318
+ frame: () => {},
319
+ report: () => JSON.parse(JSON.stringify(flush())),
320
+ dispose() {
321
+ disposed = true;
322
+ clearTimeout(timer);
323
+ coverObserver?.disconnect();
324
+ ancestorObserver?.disconnect();
325
+ sizes?.disconnect();
326
+ fonts?.removeEventListener?.('loadingdone', schedule);
327
+ for (const observer of observers.values()) {observer.disconnect();}
328
+ observers.clear();
329
+ corrections.clear();
330
+ corrections.dispose();
331
+ probe.remove();
332
+ view.removeEventListener?.('resize', resize);
333
+ view.removeEventListener?.('orientationchange', resize);
334
+ view.visualViewport?.removeEventListener?.('resize', resize);
335
+ view.visualViewport?.removeEventListener?.('scroll', resize);
336
+ },
337
+ };
338
+ }
@@ -0,0 +1,42 @@
1
+ // Persistent CSS wins over the renderer's normal inline declarations. The
2
+ // renderer can keep writing its baseline without a per-frame restore/reapply.
3
+ const properties = ['translate', 'boxSizing', 'maxWidth', 'whiteSpace', 'overflowWrap', 'overflow', 'textOverflow', 'webkitLineClamp', 'display', 'maxHeight', 'overflowY'];
4
+ const cssName = key => key.replace(/[A-Z]/g, letter => `-${letter.toLowerCase()}`).replace(/^webkit-/, '-webkit-');
5
+ export function makeSafeStyle(root) {
6
+ const sheet = document.createElement('style');
7
+ sheet.textContent = properties.map(key => {
8
+ const name = cssName(key);
9
+ return `[data-hub-safe-${name}]{${name}:var(--hub-safe-${name})!important}`;
10
+ }).join('\n');
11
+ root.appendChild(sheet);
12
+ const changed = new Map();
13
+ return {
14
+ write(node, key, value) {
15
+ let keys = changed.get(node);
16
+ if (!keys) {changed.set(node, keys = new Map());}
17
+ if (typeof node.style.setProperty === 'function') {
18
+ keys.set(key, null);
19
+ const name = cssName(key);
20
+ node.style.setProperty(`--hub-safe-${name}`, value || 'revert');
21
+ node.setAttribute(`data-hub-safe-${name}`, '');
22
+ } else {
23
+ // Minimal DOM adapters used by the geometry tests have no CSS cascade.
24
+ if (!keys.has(key)) {keys.set(key, node.style[key]);}
25
+ node.style[key] = value;
26
+ }
27
+ },
28
+ clear() {
29
+ for (const [node, keys] of changed) {
30
+ for (const [key, before] of keys) {
31
+ if (typeof node.style.removeProperty === 'function') {
32
+ const name = cssName(key);
33
+ node.style.removeProperty(`--hub-safe-${name}`);
34
+ node.removeAttribute(`data-hub-safe-${name}`);
35
+ } else {node.style[key] = before;}
36
+ }
37
+ }
38
+ changed.clear();
39
+ },
40
+ dispose() {this.clear(); sheet.remove();},
41
+ };
42
+ }
@@ -109,15 +109,24 @@ export function makeSay() {
109
109
  // player here, and in the feed; another player's line can be reported.
110
110
  chat(now, playerId, name, message, bubbleMs) {
111
111
  if (playerId) {
112
- bubbles.set(playerId, { text: message.text, emoji: null, until: now + bubbleMs });
112
+ bubbles.set(playerId, { text: message.text, emoji: null, until: now + bubbleMs, userId: message.fromUserId });
113
113
  }
114
- feed.push({ text: `${name}: ${message.text}`, until: now + FEED_MS + bubbleMs, id: message.mine ? null : (message.id ?? null) });
114
+ feed.push({ text: `${name}: ${message.text}`, until: now + FEED_MS + bubbleMs, id: message.mine ? null : (message.id ?? null), userId: message.fromUserId ?? null });
115
115
  feed = feed.slice(-FEED_MAX);
116
116
  },
117
117
 
118
118
  // The feed's lines, oldest first: `{ text, id }`, `id` a chat message
119
119
  // that may be reported, or null.
120
- feed: () => feed.map((line) => ({ text: line.text, id: line.id ?? null })),
120
+ feed: () => feed.map((line) => ({ text: line.text, id: line.id ?? null, ...(line.userId ? { userId: line.userId } : {}) })),
121
+
122
+ hideUser(userId) {
123
+ feed = feed.filter((line) => String(line.userId) !== String(userId));
124
+ for (const [playerId, bubble] of bubbles) {
125
+ if (String(bubble.userId) === String(userId)) {
126
+ bubbles.delete(playerId);
127
+ }
128
+ }
129
+ },
121
130
 
122
131
  clear() {
123
132
  bubbles.clear();