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
@@ -0,0 +1,233 @@
1
+ import { ensureActorModel } from './modelReady.js';
2
+ import * as THREE from 'three';
3
+ import { mergeGeometries } from 'three/addons/utils/BufferGeometryUtils.js';
4
+ import { lookOf, rigOf, sharedFor } from './avatarShare.js';
5
+
6
+ const PLAIN_RENDER = String(THREE.Object3D.prototype.onBeforeRender);
7
+
8
+ // Low-only, opt-in resting bodies for remote avatars beyond 12m. Animated
9
+ // rigs keep updating while hidden, so coming within 10m restores the current
10
+ // pose. Names and worn objects are siblings of the rig and are untouched.
11
+ // Every geometry here is owned; materials remain the kit's shared copies.
12
+ export function makeFarAvatars() {
13
+ const rows = new Map();
14
+ const cache = new Map();
15
+ let nextAt = -Infinity;
16
+ const here = new THREE.Vector3();
17
+ const there = new THREE.Vector3();
18
+
19
+ function release(id) {
20
+ const row = rows.get(id);
21
+ if (!row) {
22
+ return;
23
+ }
24
+ rows.delete(id);
25
+ row.node.removeEventListener('removed', row.removed);
26
+ row.rig.visible = row.visible;
27
+ row.proxy.removeFromParent();
28
+ row.built.users -= 1;
29
+ if (!row.built.users) {
30
+ for (const mesh of row.built.meshes) {
31
+ mesh.geometry.dispose();
32
+ }
33
+ cache.delete(row.template);
34
+ }
35
+ }
36
+
37
+ function build(template) {
38
+ // Deferred look baking owns geometry.clone while writing AO, including
39
+ // models without outlines. A merged buffer cannot follow those writes.
40
+ let waiting = false;
41
+ template.traverse((object) => {
42
+ if (
43
+ object.isMesh &&
44
+ (Array.isArray(object.material) ||
45
+ object.material?.visible === false ||
46
+ Object.hasOwn(object.geometry, 'clone'))
47
+ ) {
48
+ waiting = true;
49
+ }
50
+ });
51
+ if (waiting) {
52
+ return null;
53
+ }
54
+ const groups = new Map();
55
+ let supported = true;
56
+ template.updateMatrixWorld(true);
57
+ const inverse = template.matrixWorld.clone().invert();
58
+ template.traverseVisible((mesh) => {
59
+ if (!mesh.isMesh || mesh.userData.lookOutline) {
60
+ return;
61
+ }
62
+ const material = mesh.material;
63
+ const look = lookOf(material);
64
+ if (
65
+ String(mesh.onBeforeRender) !== PLAIN_RENDER ||
66
+ mesh.isSkinnedMesh ||
67
+ mesh.isInstancedMesh ||
68
+ !mesh.visible ||
69
+ look === null ||
70
+ material.transparent ||
71
+ material.opacity !== 1 ||
72
+ Object.keys(mesh.geometry.morphAttributes).length ||
73
+ mesh.geometry.drawRange.start !== 0 ||
74
+ mesh.geometry.drawRange.count !== Infinity
75
+ ) {
76
+ supported = false;
77
+ return;
78
+ }
79
+ let group = groups.get(look);
80
+ if (!group) {
81
+ group = { material: sharedFor(material), geometries: [] };
82
+ groups.set(look, group);
83
+ }
84
+ const matrix = inverse.clone().multiply(mesh.matrixWorld);
85
+ // Three corrects front faces for a reflected mesh transform. Baking
86
+ // that reflection into positions would lose the correction.
87
+ if (matrix.determinant() < 0) {
88
+ supported = false;
89
+ return;
90
+ }
91
+ const geometry = mesh.geometry.clone();
92
+ geometry.applyMatrix4(matrix);
93
+ group.geometries.push(geometry);
94
+ });
95
+ const meshes = [];
96
+ for (const group of groups.values()) {
97
+ const geometry = supported ? mergeGeometries(group.geometries) : null;
98
+ for (const part of group.geometries) {
99
+ part.dispose();
100
+ }
101
+ if (!geometry) {
102
+ supported = false;
103
+ continue;
104
+ }
105
+ const mesh = new THREE.Mesh(geometry, group.material);
106
+ mesh.castShadow = false;
107
+ mesh.receiveShadow = true;
108
+ mesh.userData.hubFarAvatarBody = true;
109
+ meshes.push(mesh);
110
+ }
111
+ if (!supported || !meshes.length) {
112
+ for (const mesh of meshes) {
113
+ mesh.geometry.dispose();
114
+ }
115
+ return null;
116
+ }
117
+ return { meshes, users: 0 };
118
+ }
119
+
120
+ function add(id, entry, rig, template) {
121
+ let built = cache.get(template);
122
+ if (!built) {
123
+ built = build(template);
124
+ if (!built) {
125
+ return;
126
+ }
127
+ cache.set(template, built);
128
+ }
129
+ const proxy = new THREE.Group();
130
+ proxy.name = 'hub-far-avatar';
131
+ proxy.position.copy(rig.position);
132
+ proxy.quaternion.copy(rig.quaternion);
133
+ proxy.scale.copy(rig.scale);
134
+ for (const mesh of built.meshes) {
135
+ proxy.add(mesh.clone());
136
+ }
137
+ const removed = () => release(id);
138
+ const row = { node: entry.node, rig, template, built, proxy, visible: rig.visible, removed };
139
+ rows.set(id, row);
140
+ built.users += 1;
141
+ entry.node.add(proxy);
142
+ entry.node.addEventListener('removed', removed);
143
+ rig.visible = false;
144
+ }
145
+
146
+ function clear() {
147
+ for (const id of [...rows.keys()]) {
148
+ release(id);
149
+ }
150
+ nextAt = -Infinity;
151
+ }
152
+
153
+ function update(scene, actorIds, localId, active, now, realLimit = Infinity) {
154
+ if (!active) {
155
+ clear();
156
+ return;
157
+ }
158
+ if (now < nextAt) {
159
+ return;
160
+ }
161
+ nextAt = now + 250;
162
+ const world = scene.three;
163
+ const local = world?.nodes?.get(localId)?.node;
164
+ if (!local) {
165
+ clear();
166
+ return;
167
+ }
168
+ local.getWorldPosition(here);
169
+ const ids = new Set(actorIds);
170
+ for (const id of ids) {ensureActorModel(world, id);}
171
+ for (const [id, row] of rows) {
172
+ if (
173
+ !ids.has(id) ||
174
+ id === localId ||
175
+ world.nodes.get(id)?.node !== row.node ||
176
+ rigOf(row.node) !== row.rig ||
177
+ world.models.get(world.nodes.get(id)?.modelKey)?.template !== row.template
178
+ ) {
179
+ release(id);
180
+ }
181
+ }
182
+ const distances = new Map();
183
+ if (Number.isFinite(realLimit)) {
184
+ for (const id of ids) {
185
+ const node = world.nodes.get(id)?.node;
186
+ if (id !== localId && node && rigOf(node)) {
187
+ distances.set(id, node.getWorldPosition(there).distanceTo(here));
188
+ }
189
+ }
190
+ }
191
+ const nearest = Number.isFinite(realLimit)
192
+ ? new Set(
193
+ [...distances]
194
+ .sort((a, b) => a[1] - b[1] || String(a[0]).localeCompare(String(b[0])))
195
+ .slice(0, realLimit)
196
+ .map(([id]) => id),
197
+ )
198
+ : null;
199
+ for (const id of ids) {
200
+ if (id === localId) {
201
+ continue;
202
+ }
203
+ const entry = world.nodes.get(id);
204
+ const rig = rigOf(entry?.node);
205
+ if (!rig) {
206
+ continue;
207
+ }
208
+ const distance = entry.node.getWorldPosition(there).distanceTo(here);
209
+ if (rows.has(id)) {
210
+ if ((!nearest || nearest.has(id)) && distance < 10) {
211
+ release(id);
212
+ }
213
+ } else if (
214
+ ((nearest && !nearest.has(id)) || distance > 12) &&
215
+ rig.visible &&
216
+ entry.node.parent
217
+ ) {
218
+ const template = world.models.get(entry.modelKey)?.template;
219
+ if (template) {
220
+ add(id, entry, rig, template);
221
+ }
222
+ }
223
+ }
224
+ }
225
+
226
+ return {
227
+ update,
228
+ clear,
229
+ get size() {
230
+ return rows.size;
231
+ },
232
+ };
233
+ }
@@ -8,7 +8,14 @@
8
8
  export function firstJoinFor(castleJson, multiplayer) {
9
9
  const npcs = castleJson?.hub?.npcs;
10
10
  if (typeof npcs?.route !== 'string' || multiplayer?.placeCharacters === true) {
11
- return undefined;
11
+ return pongJoin(undefined, castleJson?.hub?.pongTimeoutMs);
12
12
  }
13
- return { destination: { routeId: npcs.route, slot: typeof npcs.slot === 'string' ? npcs.slot : 'main' }, fallback: { mode: 'public' } };
13
+ return pongJoin({ destination: { routeId: npcs.route, slot: typeof npcs.slot === 'string' ? npcs.slot : 'main' }, fallback: { mode: 'public' } }, castleJson?.hub?.pongTimeoutMs);
14
+ }
15
+
16
+ // Client-only transport policy; absent/zero returns the exact original join.
17
+ export function pongJoin(join, ms) {
18
+ if (!Number.isInteger(ms) || ms <= 0 || ms > 2_147_483_647) { return join; }
19
+ if (join?.destination) { return { ...join, fallback: pongJoin(join.fallback, ms) }; }
20
+ return { ...(join ?? { mode: 'public' }), pongTimeoutMs: ms };
14
21
  }
@@ -0,0 +1,50 @@
1
+ // Snapshot configuration belongs to a transport, never the page's root deck.
2
+ // Allocate nothing until an opted-in server snapshot arrives.
3
+ let sessions;
4
+ export function setFpsTelemetry(net, config) {
5
+ if (!net) {return;}
6
+ if (config) {
7
+ sessions ??= new WeakMap();
8
+ sessions.set(net, config);
9
+ } else {sessions?.delete(net);}
10
+ }
11
+ export function fpsTelemetryFor(net) {return net ? sessions?.get(net) : undefined;}
12
+
13
+ // Bounded one-second foreground samples; delivery is best effort.
14
+ export function makeFpsTelemetry({ send, document: doc = globalThis.document, target = globalThis }) {
15
+ let last = null, frames = 0, elapsed = 0, samples = [], context = null;
16
+ const flush = (final = false) => {
17
+ if (!samples.length || !context) {return;}
18
+ const sorted = [...samples].sort((a, b) => a - b);
19
+ const quantile = (q) => Math.min(4095, Math.max(0, Math.round(sorted[Math.max(0, Math.ceil(q * sorted.length) - 1)] * 10)));
20
+ const message = { k: 'hub-fps', median: quantile(0.5), p10: quantile(0.1), ...context, final };
21
+ samples = []; elapsed = 0;
22
+ try { send(message); } catch { /* Never interrupt a departure. */ }
23
+ };
24
+ const hide = () => { if (doc?.hidden) {last = null; frames = 0;} };
25
+ const pause = () => { last = null; frames = 0; elapsed = 0; samples = []; context = null; };
26
+ const leave = () => { flush(true); pause(); };
27
+ doc?.addEventListener?.('visibilitychange', hide);
28
+ target.addEventListener?.('pagehide', leave);
29
+ return {
30
+ leave,
31
+ pause,
32
+ frame(now, next) {
33
+ if (doc?.hidden) {last = null; frames = 0; return;}
34
+ if (context && context.scene !== next.scene) {flush(true); last = null; frames = 0;}
35
+ context = next;
36
+ if (last === null) {last = now; return;}
37
+ frames += 1;
38
+ if (now - last < 1000) {return;}
39
+ elapsed += now - last;
40
+ samples.push(frames * 1000 / (now - last));
41
+ last = now; frames = 0;
42
+ if (samples.length >= 60 || elapsed >= 60000) {flush();}
43
+ },
44
+ dispose() {
45
+ flush(true);
46
+ doc?.removeEventListener?.('visibilitychange', hide);
47
+ target.removeEventListener?.('pagehide', leave);
48
+ },
49
+ };
50
+ }
@@ -0,0 +1,5 @@
1
+ // Expand before WORLD/STATE dispatch and arrival hooks. Every packet in a
2
+ // transport frame shares its arrival time and retains its original order.
3
+ export function unpackFrame(data) {
4
+ return data?.k === 'hub-frame' && Array.isArray(data.packets) ? data.packets : [data];
5
+ }
@@ -25,7 +25,7 @@
25
25
  // the camera looks rather than where the character happens to face: see
26
26
  // `aimThrow`. Without the key every throw runs the code it always did.
27
27
 
28
- import { hub } from './state.js';
28
+ import { deck, hub } from './state.js';
29
29
 
30
30
  const DEG = Math.PI / 180;
31
31
  // An object is offered when its near side is this close to the player
@@ -136,7 +136,7 @@ export function makeGrab(chrome) {
136
136
  // E or F on a keyboard. Typing in the talk panel never reaches here (its
137
137
  // input stops its keys), nor does any other text field.
138
138
  const onKey = (event) => {
139
- if (event.repeat || (event.code !== 'KeyE' && event.code !== 'KeyF')) {
139
+ if (deck.act === true || event.repeat || (event.code !== 'KeyE' && event.code !== 'KeyF')) {
140
140
  return;
141
141
  }
142
142
  const target = event.target;
@@ -151,13 +151,29 @@ export function makeGrab(chrome) {
151
151
  };
152
152
  globalThis.addEventListener?.('keydown', onKey);
153
153
  return {
154
- frame: (scene, mp, local, idle) => frame(t, scene, mp, local, idle),
154
+ frame: (scene, mp, local, idle, pauseCarry = false) => frame(t, scene, mp, local, idle, pauseCarry),
155
155
  holding: () => t.held?.id ?? null,
156
+ perform(id, scene, mp, local, op, onThrow) {
157
+ const body = scene.physics3d?.bodyOf(id), actor = scene.getActor(id);
158
+ if (!body || !actor || !mp.own?.mine?.has(id)) {return false;}
159
+ const config = hub.place?.grab;
160
+ if (op === 'throw' && t.held?.id === id) {
161
+ if (t.held.aim) {return false;}
162
+ t.held.actThrow = onThrow;
163
+ if (scene.cameraControl === 'orbit') {aimThrow(t, scene, mp, body, local, config, 0, performance.now());}
164
+ else {throwHeld(t, scene, body, local, config, { send() {} }, performance.now());}
165
+ } else if (op === 'grab' && !t.held) {
166
+ const at = body.translation(), size = sizeOf(actor.components.Shape);
167
+ t.held = { id, ...size, at: { ...at } };
168
+ carry(t, scene, body, local, config, 0);
169
+ }
170
+ return true;
171
+ },
156
172
  dispose: () => globalThis.removeEventListener?.('keydown', onKey),
157
173
  };
158
174
  }
159
175
 
160
- function frame(t, scene, mp, local, idle) {
176
+ function frame(t, scene, mp, local, idle, pauseCarry) {
161
177
  const now = performance.now();
162
178
  const dt = Math.min(0.1, Math.max(0, (now - (t.lastAt || now)) / 1000));
163
179
  t.lastAt = now;
@@ -176,9 +192,11 @@ function frame(t, scene, mp, local, idle) {
176
192
  const config = hub.place?.grab ?? null;
177
193
  const phys = scene.physics3d;
178
194
  const self = net?.selfId?.();
179
- const can = Boolean(
180
- config && idle && net && local?.components.Transform && phys?.ready?.() && !hub.held.has(self),
181
- );
195
+ const ready = Boolean(config && net && local?.components.Transform && phys?.ready?.() && !hub.held.has(self));
196
+ const can = ready && idle;
197
+ // A temporary sheet cancels an Act throw, but preserves the carry shared
198
+ // with the server. Closing it can then start a new throw normally.
199
+ const paused = deck.act === true && ready && pauseCarry;
182
200
 
183
201
  if (t.held) {
184
202
  const id = t.held.id;
@@ -188,7 +206,7 @@ function frame(t, scene, mp, local, idle) {
188
206
  // object to someone else or back to the server, when the place hides it,
189
207
  // or when the player cannot act (a trip, held still, a game's end).
190
208
  if (
191
- !can ||
209
+ (!can && !paused) ||
192
210
  told ||
193
211
  !mp.own?.mine?.has(id) ||
194
212
  hub.hidden.has(id) ||
@@ -197,6 +215,7 @@ function frame(t, scene, mp, local, idle) {
197
215
  ) {
198
216
  t.held = null;
199
217
  } else {
218
+ if (paused) {delete t.held.aim; delete t.held.actThrow;}
200
219
  if (scene.cameraControl === 'orbit') {
201
220
  // What this client has told the server of the hold, for a throw's
202
221
  // swing to keep inside (`reach`); it changes nothing here.
@@ -204,9 +223,9 @@ function frame(t, scene, mp, local, idle) {
204
223
  }
205
224
  if (t.held.aim) {
206
225
  aimFrame(t, scene, mp, body, local, config, net, now, dt);
207
- } else if (pressed && scene.cameraControl === 'orbit') {
226
+ } else if (can && pressed && scene.cameraControl === 'orbit') {
208
227
  aimThrow(t, scene, mp, body, local, config, dt, now);
209
- } else if (pressed) {
228
+ } else if (can && pressed) {
210
229
  throwHeld(t, scene, body, local, config, net, now);
211
230
  } else {
212
231
  carry(t, scene, body, local, config, dt);
@@ -464,7 +483,8 @@ function throwHeld(
464
483
  ) {
465
484
  const speed = config.throwSpeed;
466
485
  body.setLinvel({ x: Math.sin(f) * speed, y: speed * THROW_UP, z: Math.cos(f) * speed }, true);
467
- net.send({ k: 'hub-grab', actor: t.held.id, op: 'throw' });
486
+ if (t.held.actThrow) {t.held.actThrow();}
487
+ else {net.send({ k: 'hub-grab', actor: t.held.id, op: 'throw' });}
468
488
  t.held = null;
469
489
  t.quietUntil = now + REGRAB_MS;
470
490
  }
@@ -11,25 +11,61 @@ import * as AvatarCap from './avatarCap.js';
11
11
  import { mergeDictionary } from './interestCap.js';
12
12
  import * as Cabinets from './cabinets.js';
13
13
  import { firstJoinFor } from './firstJoin.js';
14
- import { deck, earnedNow, hub, mergeHidden, wearingNow } from './state.js';
14
+ import { deck, earnedNow, hub, localArrival, mergeHidden, receiveParty, wearingNow } from './state.js';
15
15
  import { clearShot, receiveShot } from './shot.js';
16
16
  import * as Ballot from './ballot.js';
17
17
  import * as Rehello from './rehello.js';
18
+ import { guestName } from './signIn.js';
18
19
  import { sanitise, ownStamp } from './companion.js';
19
20
  import { buildStamp } from './build.js';
21
+ import { unpackFrame } from './frameBatch.js';
22
+ import { setFpsTelemetry } from './fpsTelemetry.js';
23
+ import { setLoadTelemetry } from './loadTelemetry.js';
24
+ import { readQuality } from '../shared/quality.js';
25
+ import { noteQualityInteraction } from './quality.js';
26
+ import { readDanceIdle } from '../shared/danceIdle.js';
20
27
 
21
28
  // Root-anchored: the deck's own castle.json once this kit is imported.
22
29
  const castleJson = Object.values(import.meta.glob('/castle.json', { eager: true, import: 'default' }))[0] ?? {};
30
+ deck.title = typeof castleJson.title === 'string' ? castleJson.title : '';
31
+ // Read only when a scene opts into the spawn locator; never sent or saved.
32
+ localArrival.for = (id) => (id === 'main' ? castleJson.hub?.places?.main ?? castleJson.hub : castleJson.hub?.places?.[id])?.arrival;
23
33
  // The assembly's build stamp beside it; an absent file matches nothing.
24
34
  deck.build = buildStamp(Object.values(import.meta.glob('/build.json', { eager: true, import: 'default' }))[0]);
35
+ // Read the installed copy's identity, rather than the assembly's requested pin.
36
+ const kitBuild = Object.values(import.meta.glob('/imports/castle.hub-game/.castle-import-version.json', { eager: true, import: 'default', exhaustive: true }))[0];
37
+ if (deck.build && kitBuild?.source === 'builtin' && typeof kitBuild.version === 'string') {
38
+ deck.build = Object.freeze({ ...deck.build, hubGameBuiltinVersion: kitBuild.version,
39
+ ...(typeof kitBuild.digest === 'string' ? { hubGameBuiltinDigest: kitBuild.digest } : {}) });
40
+ }
41
+
42
+ if (castleJson?.hub?.pongTimeoutMs > 0) { deck.pongTimeoutMs = castleJson.hub.pongTimeoutMs; }
43
+ else { delete deck.pongTimeoutMs; }
44
+ deck.invite = (castleJson?.hub?.places?.main?.invite ?? castleJson?.hub?.invite) === true;
45
+ deck.defaultEnvironment = castleJson?.hub?.defaultEnvironment !== false;
25
46
  deck.tiers = castleJson?.hub?.tiers === true;
47
+ if (castleJson?.hub?.highOnly === true && deck.tiers) { deck.highOnly = true; }
48
+ else { delete deck.highOnly; }
49
+ if (castleJson?.hub?.quality !== undefined && deck.tiers) { deck.quality = readQuality(castleJson.hub.quality, true, []); }
50
+ else { delete deck.quality; }
51
+ if (castleJson?.hub?.safeInsets === true) { deck.safeInsets = true; }
52
+ else { delete deck.safeInsets; }
53
+ if (castleJson?.hub?.weakestTier === true) { deck.weakestTier = true; }
54
+ else { delete deck.weakestTier; }
55
+ if (castleJson?.hub?.weakestLookBake === true) { deck.weakestLookBake = true; }
56
+ else { delete deck.weakestLookBake; }
57
+ if (castleJson?.hub?.mergeFarAvatars === true) { deck.mergeFarAvatars = true; }
58
+ else { delete deck.mergeFarAvatars; }
26
59
  if (castleJson?.hub?.lowActorDistance === true) { deck.lowActorDistance = true; }
27
60
  else { delete deck.lowActorDistance; }
28
61
  if (castleJson?.hub?.lowActorBudget === true) { deck.lowActorBudget = true; }
29
62
  else { delete deck.lowActorBudget; }
30
63
  if (castleJson?.hub?.companionIdle === true) { deck.companionIdle = true; }
31
64
  else { delete deck.companionIdle; }
65
+ if (castleJson?.hub?.act === true) {deck.act = true;}
66
+ else {delete deck.act;}
32
67
  deck.cues = castleJson?.hub?.cues === true;
68
+ deck.playCards = castleJson?.hub?.playCards === true;
33
69
  deck.yourGames = castleJson?.hub?.yourGames === true;
34
70
  if (castleJson?.hub?.avatarColors === true) {
35
71
  deck.avatarColors = true;
@@ -143,6 +179,8 @@ function wearMap(value) {
143
179
  }
144
180
 
145
181
  export default {
182
+ // Travel retains these hooks: decode offers from any opted-in destination.
183
+ unpack: unpackFrame,
146
184
  // A place whose NPCs have minds (`hub.npcs`, contract §13) is joined like any
147
185
  // other, on one of its public layers, when the SDK can address the place's
148
186
  // characters from a layer (`Multiplayer.placeCharacters`): ghost and the host
@@ -159,6 +197,12 @@ export default {
159
197
  // from a session the connection has since left is dropped (`rehello.js`).
160
198
  // Handles nothing: it goes on to the queue as before.
161
199
  arrive(msg, system) {
200
+ if (msg.k === 'hub-frame-offer') {
201
+ if (system?.net?.unpacks === true) {
202
+ system.net.send({ k: 'hub-frame-ready' });
203
+ }
204
+ return true;
205
+ }
162
206
  Rehello.tag(msg, system?.net ?? null);
163
207
  return false;
164
208
  },
@@ -185,6 +229,11 @@ export default {
185
229
  hub.ask = msg.id === null ? { id: null, n: msg.n } : { id: msg.id, title: msg.title, max: msg.max, n: msg.n };
186
230
  }
187
231
  break;
232
+ case 'hub-prompts':
233
+ if (deck.act === true && Array.isArray(msg.items)) {
234
+ hub.prompts = msg.items.filter(item => item && typeof item.id === 'string' && typeof item.verb === 'string' && typeof item.hold === 'boolean');
235
+ }
236
+ break;
188
237
  case 'hub-actions':
189
238
  // Buffer before WORLD; nothing draws until the place is known to opt in.
190
239
  // A WORLD naming a keyless place drops this private offer.
@@ -202,6 +251,9 @@ export default {
202
251
  case 'hub-home-unlock':
203
252
  hub.commands.push(msg);
204
253
  break;
254
+ case 'hub-invite':
255
+ if (hub.place?.invite === true) {hub.commands.push({ k: 'hub-invite', ...(msg.share === true ? { share: true } : {}) });}
256
+ break;
205
257
  case 'hub-go':
206
258
  case 'hub-end':
207
259
  case 'hub-result':
@@ -257,6 +309,7 @@ export default {
257
309
  }
258
310
  break;
259
311
  case 'hub-said':
312
+ if (deck.quality) {noteQualityInteraction(scene, msg.player);}
260
313
  if (hub.saidEvents.length < 64) {
261
314
  hub.saidEvents.push(msg);
262
315
  }
@@ -270,14 +323,13 @@ export default {
270
323
  hub.friendsWanted = true;
271
324
  break;
272
325
  case 'hub-party':
273
- hub.party = {
274
- members: Array.isArray(msg.members) ? msg.members : null,
275
- away: Number(msg.away) || 0,
276
- invite: msg.invite ?? null,
277
- proposal: msg.proposal ?? null,
278
- };
326
+ receiveParty(msg);
279
327
  break;
280
328
  case 'hub-av':
329
+ if (hub.place?.anonymousEntry === true && Array.isArray(msg.hubGuests)) {
330
+ hub.guestsMe = new Set(msg.hubGuests.filter((id) => typeof id === 'string'));
331
+ hub.guests = new Set([...(hub.guestsAll ?? []), ...hub.guestsMe]);
332
+ }
281
333
  hub.avatarsMe = new Map(Object.entries(msg.hubAv && typeof msg.hubAv === 'object' ? msg.hubAv : {}));
282
334
  // The message is whole: without `hubAv2`, none of them wears a later avatar.
283
335
  hub.avatars2Me = realAvatars(msg.hubAv2);
@@ -355,7 +407,22 @@ export default {
355
407
  hub.lastT = msg.t;
356
408
  hub.lastTAt = msg.localMs ?? performance.now();
357
409
  }
410
+ // `hub-arrived` is sent before the state block containing the server's
411
+ // own-player clamp. Multiplayer applies that clamp after this hook, so
412
+ // the hub system observes this latch on the following frame, once the
413
+ // corrected position has reached Transform. A later WORLD is equivalent
414
+ // on reconnect; the initial WORLD cannot qualify before hub-arrived.
415
+ if (!hub.arrivalPlaced && hub.arrivedFacing !== null && (
416
+ msg.k === 'w' ||
417
+ // Match multiplayer's clamp acceptance exactly. `packPlayer` puts 1/0
418
+ // on the wire, while older composed fixtures may still carry true.
419
+ (msg.ps ?? []).some((row) => row?.[0] === system?.net?.selfId?.() && Boolean(row[5]))
420
+ )) {
421
+ hub.arrivalPlaced = true;
422
+ }
358
423
  if (msg.hubPlace) {
424
+ setFpsTelemetry(system?.net, msg.hubPlace.fpsTelemetry);
425
+ setLoadTelemetry(system?.net, msg.hubPlace.loadTelemetry);
359
426
  if (Object.hasOwn(hub, 'menu') && hub.place && hub.place.id !== msg.hubPlace.id) {
360
427
  hub.menuClose?.();
361
428
  delete hub.menu;
@@ -365,6 +432,11 @@ export default {
365
432
  delete hub.ask;
366
433
  }
367
434
  hub.place = msg.hubPlace;
435
+ if (hub.place.anonymousEntry !== true) {
436
+ delete hub.guests;
437
+ delete hub.guestsAll;
438
+ delete hub.guestsMe;
439
+ }
368
440
  if (hub.place.menu !== true) {
369
441
  hub.menuClose?.();
370
442
  delete hub.menuClose;
@@ -385,6 +457,10 @@ export default {
385
457
  delete hub.decor;
386
458
  }
387
459
  }
460
+ if (hub.place?.anonymousEntry === true && Array.isArray(msg.hubGuests)) {
461
+ hub.guestsAll = new Set(msg.hubGuests.filter((id) => typeof id === 'string'));
462
+ hub.guests = new Set([...hub.guestsAll, ...(hub.guestsMe ?? [])]);
463
+ }
388
464
  // v1.68: a card the gate held before the place was known is kept or
389
465
  // dropped by it. Nothing unless the gate held one.
390
466
  if (msg.hubPlace && Ballot.held) {
@@ -522,6 +598,9 @@ export default {
522
598
  if (msg.hubSounds && typeof msg.hubSounds === 'object') {
523
599
  hub.sounds = msg.hubSounds;
524
600
  }
601
+ if (Object.hasOwn(msg, 'hubDanceIdle')) {
602
+ hub.danceIdle = readDanceIdle(msg.hubDanceIdle);
603
+ }
525
604
  },
526
605
 
527
606
  // Everyone is drawn as their avatar; until a player's hello has reached the
@@ -533,7 +612,7 @@ export default {
533
612
  // Or its stand-in while the cap has this player as one (`avatarCap.js`).
534
613
  const index = AvatarCap.shown(playerId);
535
614
  const blueprint = index === null ? null : Avatar.blueprint(files, index, Avatar.style(), AvatarCap.shownColor(playerId));
536
- return blueprint ? { blueprint, username } : null;
615
+ return blueprint ? { blueprint, username: hub.guests?.has(playerId) ? guestName(username) : username } : null;
537
616
  },
538
617
 
539
618
  presence(status) {
@@ -0,0 +1,51 @@
1
+ // v1.131: title above the world and one next-action sentence below it.
2
+ // Door authors shorten prompts to about 48 characters; layout QA flags wrapping.
3
+ export const HUD_COPY_STYLE = {
4
+ background: 'rgba(20,16,12,0.78)',
5
+ borderRadius: '14px',
6
+ padding: '4px 8px',
7
+ boxSizing: 'border-box',
8
+ width: 'max-content',
9
+ maxWidth: '100%',
10
+ margin: '0 auto',
11
+ lineHeight: '1.3',
12
+ whiteSpace: 'normal',
13
+ overflowWrap: 'anywhere',
14
+ overflow: 'hidden',
15
+ };
16
+
17
+ const checked = new WeakMap();
18
+ // Called only in dev serving. Check again when copy or viewport changes, so a
19
+ // timer frame never repeats an author's warning. Effective width includes
20
+ // safe-inset reconciliation, which can narrow a row after setHud.
21
+ export function warnHudCopy(node, row, lines = 2) {
22
+ const key = [node.textContent, window.innerWidth, window.innerHeight, node.clientWidth, lines].join('\u0001');
23
+ if (checked.get(node) === key) { return; }
24
+ checked.set(node, key);
25
+ if (!node.textContent) { return; }
26
+ const style = getComputedStyle(node);
27
+ const room = lines * parseFloat(style.lineHeight) + parseFloat(style.paddingTop) + parseFloat(style.paddingBottom);
28
+ if (node.scrollHeight > Math.ceil(room)) {
29
+ console.warn(`[hub HUD] ${row} exceeds ${lines === 1 ? 'one line' : 'two lines'} at ${window.innerWidth}x${window.innerHeight}; shorten door copy (check at 844x390):`, node.textContent);
30
+ }
31
+ }
32
+
33
+ // Preserve authored bytes on the wire; only presentation takes the first
34
+ // sentence. Decimal points are not sentence endings. Never add an ellipsis.
35
+ export function firstPromptSentence(text) {
36
+ const words = String(text ?? '').trim();
37
+ for (const end of words.matchAll(/[.!?](?:["'”’)]*)(?=\s|$)/gu)) {
38
+ const before = words.slice(0, end.index);
39
+ // A person's title is not the end of the action naming them.
40
+ if (end[0] === '.' && /\b(?:Mr|Mrs|Ms|Dr|Prof|St)$/i.test(before)) {continue;}
41
+ return words.slice(0, end.index + end[0].length);
42
+ }
43
+ return words;
44
+ }
45
+
46
+ // A projected label crossing the bottom prompt moves just above it. The top
47
+ // HUD keeps its existing downward clearance; the prompt is a separate band.
48
+ export function promptShift(box, prompt) {
49
+ if (!prompt || box.right <= prompt.left || box.left >= prompt.right || box.bottom <= prompt.top || box.top >= prompt.bottom) { return 0; }
50
+ return Math.max(-box.top, prompt.top - 6 - box.bottom);
51
+ }
@@ -0,0 +1,20 @@
1
+ const INPUT_EVENTS = ['pointerdown', 'pointerup', 'touchstart', 'touchend', 'keydown', 'keyup'];
2
+
3
+ // Only panels rest on alternate Weakest frames; motion and input never do.
4
+ export function makeHudRate(target = globalThis.window) {
5
+ let input = false, skip = false, previous;
6
+ const onInput = () => { input = true; };
7
+ for (const type of INPUT_EVENTS) {target?.addEventListener?.(type, onInput, true);}
8
+ return {
9
+ frame(weakest, signature) {
10
+ const tick = !weakest || input || signature !== previous || !skip;
11
+ previous = signature;
12
+ if (tick) {input = false;}
13
+ skip = weakest && tick;
14
+ return tick;
15
+ },
16
+ dispose() {
17
+ for (const type of INPUT_EVENTS) {target?.removeEventListener?.(type, onInput, true);}
18
+ },
19
+ };
20
+ }