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,183 @@
1
+ // Opt-in transport: capture packets when sent, then deliver each player's
2
+ // ordered packets together after the simulation tick. The unbatched handlers
3
+ // and session are returned unchanged when the deck does not opt in.
4
+ const PAYLOAD_BYTES = 60000;
5
+ const encoder = new TextEncoder();
6
+ // Host teardown precedes onShutdown. Commands that end/change a visit cannot
7
+ // sit behind replay. Controls use a reserved, paced lane ahead of snapshots.
8
+ const IMMEDIATE = new Set(['hub-frame-offer', 'hub-go', 'hub-end', 'hub-result', 'hub-home-unlock', 'hub-leaving', 'replaced', 'x']);
9
+
10
+ export function batchFrames(callbacks, enabled) {
11
+ if (!enabled) { return callbacks; }
12
+ const queues = new Map();
13
+ const controls = new Map();
14
+ // Reserve 192 KiB/s of the host's 1 MiB/s budget for storage/hub requests.
15
+ const normalBudget = { rate: 768 * 1024, tokens: 65500, at: Date.now() };
16
+ const controlBudget = { rate: 64 * 1024, tokens: 65500, at: Date.now() };
17
+ // Both lanes share a frame bucket, leaving host headroom for RPCs.
18
+ const frameBudget = { tokens: 20, at: Date.now() };
19
+ const sessions = new WeakMap();
20
+ const ready = new Set();
21
+ const offers = new Map();
22
+ let stopping = false;
23
+
24
+ function enqueue(session, id, data) {
25
+ if (stopping) { return; }
26
+ if (!session.players.some((p) => p.playerId === id)) { return; }
27
+ const json = JSON.stringify(data);
28
+ // Capture before another hook mutates the same object, as session.send does.
29
+ const packet = json === undefined ? 'null' : json;
30
+ // Reject a source packet that cannot fit a legal runtime frame; never
31
+ // bypass pacing or leave an undeliverable packet at the FIFO head.
32
+ if (encoder.encode(packet).length + 160 > 65500) { throw new RangeError('hub.frameBatch packet exceeds the runtime frame limit'); }
33
+ const lane = IMMEDIATE.has(data?.k) ? controls : queues;
34
+ const queue = lane.get(id) ?? [];
35
+ queue.push({ packet, bytes: encoder.encode(packet).length });
36
+ lane.set(id, queue);
37
+ if (lane === controls) { flushLane(session, controls, controlBudget, id); }
38
+ }
39
+
40
+ function wrapped(session) {
41
+ let proxy = sessions.get(session);
42
+ if (!proxy) {
43
+ proxy = new Proxy(session, {
44
+ get(target, key) {
45
+ if (key === 'send') { return (id, data) => enqueue(target, id, data); }
46
+ if (key === 'broadcast') {
47
+ return (data, options) => {
48
+ if (stopping) { return; }
49
+ // Serialize once even when this broadcast has many recipients.
50
+ const value = JSON.parse(JSON.stringify(data) ?? 'null');
51
+ for (const p of target.players) {
52
+ if (p.playerId !== options?.except) { enqueue(target, p.playerId, value); }
53
+ }
54
+ };
55
+ }
56
+ const value = Reflect.get(target, key, target);
57
+ return typeof value === 'function' ? value.bind(target) : value;
58
+ },
59
+ });
60
+ sessions.set(session, proxy);
61
+ }
62
+ return proxy;
63
+ }
64
+
65
+ function refill(budget) {
66
+ const now = Date.now();
67
+ budget.tokens = Math.min(65500, budget.tokens + Math.max(0, now - budget.at) * budget.rate / 1000);
68
+ budget.at = now;
69
+ }
70
+
71
+ function packetFor(queue, allowance) {
72
+ const packets = [];
73
+ let bytes = 160; // Envelope plus platform protocol/recipient overhead.
74
+ for (const row of queue) {
75
+ if (bytes + row.bytes + 1 > Math.min(PAYLOAD_BYTES, allowance)) { break; }
76
+ bytes += row.bytes + 1;
77
+ packets.push(row.packet);
78
+ }
79
+ if (!packets.length) {
80
+ // A valid large single packet gets its own paced envelope.
81
+ const row = queue[0];
82
+ if (row && row.bytes + 160 <= allowance) {
83
+ return { count: 1, bytes: row.bytes + 160, text: `{"k":"hub-frame","packets":[${row.packet}]}` };
84
+ }
85
+ return null;
86
+ }
87
+ return { count: packets.length, bytes,
88
+ text: `{"k":"hub-frame","packets":[${packets.join(',')}]}` };
89
+ }
90
+
91
+ function flushLane(session, lane, budget, only) {
92
+ refill(budget);
93
+ const players = new Set(session.players.map((p) => p.playerId));
94
+ const now = Date.now();
95
+ frameBudget.tokens = Math.min(20, frameBudget.tokens + Math.max(0, now - frameBudget.at) * 30 * players.size / 1000);
96
+ frameBudget.at = now;
97
+ for (const id of lane.keys()) { if (!players.has(id)) { lane.delete(id); } }
98
+ function delivered(id, count) {
99
+ const queue = lane.get(id);
100
+ queue.splice(0, count);
101
+ lane.delete(id);
102
+ if (queue.length) { lane.set(id, queue); } // Round-robin across ticks.
103
+ }
104
+ const shared = only === undefined && lane.size === players.size
105
+ ? [...lane].map(([id, queue]) => ({ id, row: packetFor(queue, budget.tokens) })) : [];
106
+ if (frameBudget.tokens >= 1 && shared.length && shared.every(({ row }) => row && row.text === shared[0].row.text)) {
107
+ frameBudget.tokens -= 1;
108
+ budget.tokens -= shared[0].row.bytes;
109
+ session.broadcast(JSON.parse(shared[0].row.text));
110
+ for (const { id, row } of shared) { delivered(id, row.count); }
111
+ return;
112
+ }
113
+ for (const [id, queue] of [...lane]) {
114
+ if (frameBudget.tokens < 1) { break; }
115
+ if (only !== undefined && id !== only) { continue; }
116
+ const row = packetFor(queue, budget.tokens);
117
+ if (!row) { continue; }
118
+ frameBudget.tokens -= 1;
119
+ budget.tokens -= row.bytes;
120
+ session.send(id, JSON.parse(row.text));
121
+ delivered(id, row.count);
122
+ }
123
+ }
124
+
125
+ function flush(session) {
126
+ flushLane(session, controls, controlBudget);
127
+ const held = new Map();
128
+ for (const id of controls.keys()) {
129
+ if (queues.has(id)) { held.set(id, queues.get(id)); queues.delete(id); }
130
+ }
131
+ flushLane(session, queues, normalBudget);
132
+ for (const [id, queue] of held) { queues.set(id, queue); }
133
+ }
134
+
135
+ const out = { ...callbacks };
136
+ for (const name of ['onStart']) {
137
+ if (callbacks[name]) { out[name] = (session, ...args) => callbacks[name](wrapped(session), ...args); }
138
+ }
139
+ out.onPlayerJoin = (session, player, ...args) => {
140
+ const id = player.playerId;
141
+ ready.delete(id); queues.delete(id); controls.delete(id);
142
+ offers.set(id, Date.now());
143
+ enqueue(session, id, { k: 'hub-frame-offer' });
144
+ return callbacks.onPlayerJoin?.(wrapped(session), player, ...args);
145
+ };
146
+ out.onPlayerLeave = (session, player, ...args) => {
147
+ ready.delete(player.playerId); offers.delete(player.playerId); queues.delete(player.playerId); controls.delete(player.playerId);
148
+ return callbacks.onPlayerLeave?.(wrapped(session), player, ...args);
149
+ };
150
+ out.onMessage = (session, player, data, ...args) => {
151
+ if (data?.k === 'hub-frame-ready') {
152
+ if (offers.has(player.playerId) && session.players.some((p) => p.playerId === player.playerId)) { ready.add(player.playerId); }
153
+ return;
154
+ }
155
+ return callbacks.onMessage?.(wrapped(session), player, data, ...args);
156
+ };
157
+ out.onTick = (session) => {
158
+ // ACK affects offer retries, never eligibility for the paced FIFO.
159
+ const now = Date.now();
160
+ const players = new Set(session.players.map((p) => p.playerId));
161
+ for (const id of ready) { if (!players.has(id)) { ready.delete(id); } }
162
+ for (const id of offers.keys()) { if (!players.has(id)) { offers.delete(id); } }
163
+ for (const id of players) {
164
+ if (!ready.has(id) && now - (offers.get(id) ?? -Infinity) >= 1000) {
165
+ offers.set(id, now);
166
+ enqueue(session, id, { k: 'hub-frame-offer' });
167
+ }
168
+ }
169
+ try { return callbacks.onTick?.(wrapped(session)); }
170
+ finally { flush(session); }
171
+ };
172
+ if (callbacks.onReplaced) {
173
+ out.onReplaced = (session) => {
174
+ callbacks.onReplaced(wrapped(session));
175
+ flush(session);
176
+ };
177
+ }
178
+ out.onShutdown = async (...args) => {
179
+ stopping = true; controls.clear(); queues.clear(); ready.clear(); offers.clear();
180
+ return callbacks.onShutdown?.(...args);
181
+ };
182
+ return out;
183
+ }
@@ -13,6 +13,7 @@ const FRIEND_MS = 10 * 60000;
13
13
  const MIN_READ_GAP_MS = 31000;
14
14
  const ARRIVAL_MS = 60000;
15
15
  const CHECK_MS = 5000;
16
+ const FRESH_READ_MS = 900;
16
17
  const diagnostics = new WeakMap();
17
18
  // The refusals a host or ghost answers with, by name; anything else is 'other'.
18
19
  const REFUSAL_CODES = new Set([
@@ -69,7 +70,14 @@ export async function friendsAmong(h, playerId, userIds, userIdOf) {
69
70
  }
70
71
  }
71
72
  let entry = cache.get(playerId);
72
- if (h.cells) {
73
+ const freshUser = h.place?.freshFriends === true ? userIdOf(h, playerId) : null;
74
+ if (freshUser && entry && entry.userId !== freshUser) {
75
+ if (entry.pending || now - entry.at < MIN_READ_GAP_MS) {
76
+ return [];
77
+ }
78
+ entry = null;
79
+ }
80
+ if (h.cells || h.place?.freshFriends === true) {
73
81
  if (entry) {
74
82
  entry.deckIds = ids;
75
83
  }
@@ -85,7 +93,7 @@ export async function friendsAmong(h, playerId, userIds, userIdOf) {
85
93
  const placeIds = placeUsers(h, playerId, userIdOf);
86
94
  if (!entry || (!entry.pending && readAt - entry.at >= MIN_READ_GAP_MS &&
87
95
  (stale(entry, readAt, placeIds) || (hasNew(entry, ids) && !(entry.refused && readAt - entry.at < entry.ttl))))) {
88
- entry = startRead(h, playerId, [...new Set([...ids, ...placeIds])].slice(0, 100), readAt);
96
+ entry = startRead(h, playerId, [...new Set([...ids, ...placeIds])].slice(0, 100), readAt, freshUser);
89
97
  }
90
98
  entry.deckIds = ids;
91
99
  } else if (!entry || (!entry.pending && now - entry.at >= entry.ttl)) {
@@ -93,6 +101,10 @@ export async function friendsAmong(h, playerId, userIds, userIdOf) {
93
101
  entry = startRead(h, playerId, ids, now);
94
102
  }
95
103
  await entry.pending;
104
+ if (h.place?.freshFriends === true &&
105
+ (!h.sim?.players.has(playerId) || userIdOf(h, playerId) !== entry.userId || Date.now() - entry.at >= entry.ttl)) {
106
+ return [];
107
+ }
96
108
  return ids.filter((id) => entry.ids.includes(id));
97
109
  } catch {
98
110
  return [];
@@ -116,23 +128,41 @@ function stale(entry, now, placeIds) {
116
128
  return age >= entry.ttl || (age >= ARRIVAL_MS && hasNew(entry, placeIds));
117
129
  }
118
130
 
119
- function startRead(h, playerId, ids, now) {
131
+ function startRead(h, playerId, ids, now, userId = null) {
132
+ const fresh = h.place?.freshFriends === true;
120
133
  const entry = {
121
- at: now, ttl: EMPTY_MS, ids: [], follows: [], followedBy: [], asked: ids, pending: null,
134
+ ...(fresh ? { userId } : {}),
135
+ at: now, ttl: fresh ? MIN_READ_GAP_MS : EMPTY_MS, ids: [], follows: [], followedBy: [], asked: ids, pending: null,
122
136
  };
123
137
  (h.friendsCache ??= new Map()).set(playerId, entry);
124
138
  // Latch before awaiting: deck asks and background primes share this read.
125
- entry.pending = read(h, playerId, ids).then((answer) => {
139
+ entry.pending = (fresh ? freshRead(h, playerId, ids) : read(h, playerId, ids)).then((answer) => {
126
140
  entry.ids = answer.friends;
127
141
  entry.follows = answer.follows;
128
142
  entry.followedBy = answer.followedBy;
129
- entry.ttl = answer.friends.length ? FRIEND_MS : EMPTY_MS;
143
+ entry.ttl = fresh ? MIN_READ_GAP_MS : answer.friends.length ? FRIEND_MS : EMPTY_MS;
130
144
  entry.refused = answer.refused === true;
131
145
  entry.pending = null;
132
146
  });
133
147
  return entry;
134
148
  }
135
149
 
150
+ // A timeout clears permission rather than retaining a stale yes. Late platform
151
+ // replies cannot populate this entry; the shared latch and rate timestamp survive.
152
+ async function freshRead(h, playerId, ids) {
153
+ let timer;
154
+ try {
155
+ return await Promise.race([
156
+ read(h, playerId, ids),
157
+ new Promise((resolve) => {
158
+ timer = setTimeout(() => resolve({ friends: [], follows: [], followedBy: [], refused: true }), FRESH_READ_MS);
159
+ }),
160
+ ]);
161
+ } finally {
162
+ clearTimeout(timer);
163
+ }
164
+ }
165
+
136
166
  // Called after hello, and from the throttled tick check for early hellos/arrivals.
137
167
  export function prime(h, playerId, userIdOf, placeIds) {
138
168
  if (!h.cells || !h.players.get(playerId)?.hello || !h.sim?.players.has(playerId) ||
@@ -152,7 +182,7 @@ export function prime(h, playerId, userIdOf, placeIds) {
152
182
  }
153
183
  const ids = [...new Set([...(entry?.deckIds ?? []), ...placeIds])].slice(0, 100);
154
184
  if (ids.length) {
155
- const fresh = startRead(h, playerId, ids, now);
185
+ const fresh = startRead(h, playerId, ids, now, userIdOf(h, playerId));
156
186
  fresh.deckIds = entry?.deckIds ?? [];
157
187
  }
158
188
  }
@@ -190,8 +220,15 @@ async function read(h, playerId, ids) {
190
220
  ? { ...empty, friends: ids }
191
221
  : empty;
192
222
  }
193
- if (h.cells && typeof h.session.hub.relationsAmong === 'function') {
194
- const answer = await h.session.hub.relationsAmong(playerId, ids);
223
+ const fresh = h.place?.freshFriends === true;
224
+ if ((h.cells || fresh) && typeof h.session.hub.relationsAmong === 'function') {
225
+ const answer = fresh
226
+ ? await h.session.hub.relationsAmong(playerId, ids, { strict: true })
227
+ : await h.session.hub.relationsAmong(playerId, ids);
228
+ if (fresh && (answer?.validated !== true || ['friends', 'follows', 'followedBy'].some((key) =>
229
+ !Array.isArray(answer[key]) || answer[key].some((id) => typeof id !== 'string' || !USER_ID.test(id))))) {
230
+ return { ...empty, refused: true };
231
+ }
195
232
  const list = (value) => Array.isArray(value) ? ids.filter((id) => value.includes(id)) : [];
196
233
  const relations = {
197
234
  friends: list(answer?.friends),
@@ -203,6 +240,9 @@ async function read(h, playerId, ids) {
203
240
  }
204
241
  return relations;
205
242
  }
243
+ if (fresh) {
244
+ return { ...empty, refused: true };
245
+ }
206
246
  const answer = await h.session.hub.friendsAmong?.(playerId, ids);
207
247
  const friends = Array.isArray(answer) ? ids.filter((id) => answer.includes(id)) : [];
208
248
  if (Array.isArray(answer)) {
@@ -81,9 +81,11 @@ export function refresh(h, hub, membersOf, refused) {
81
81
  const ids = [...users.keys()].slice(0, MAX_USERS);
82
82
  h.historyReading = true;
83
83
  const startedAt = now;
84
+ const epoch = h.historyEpoch ?? 0;
84
85
  hub
85
86
  .readResults({ userIds: ids })
86
87
  .then((read) => {
88
+ if ((h.historyEpoch ?? 0) !== epoch) { return; }
87
89
  for (const userId of ids) {
88
90
  take(h, users.get(userId), read?.players?.[userId], startedAt);
89
91
  }