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,233 @@
1
+ // Mutation notifications for the opt-in frozen-statics path. Each consumer
2
+ // owns its pending set: physics consuming a write must not hide it from drawing.
3
+ // Only scene-owned plain data can be observed completely. An externally
4
+ // supplied object can still be written through its original reference, so its
5
+ // actor falls back to the ordinary checks for the rest of this load.
6
+ const rawValues = new WeakMap();
7
+ const rawOwners = new WeakMap();
8
+ const ACTS = ['update', 'onEnable', 'onDisable'];
9
+
10
+ export class FrozenActors {
11
+ constructor(scene) {
12
+ this.scene = scene;
13
+ this.records = new Map();
14
+ this.live = new Set();
15
+ this.consumers = new Set();
16
+ this.serial = 0;
17
+ this.writingPhysics = 0;
18
+ }
19
+
20
+ add(actor, spawned = false) {
21
+ const record = { actor, order: this.serial++, unsafe: false, proxies: new WeakMap() };
22
+ this.records.set(actor, record);
23
+ const changed = () => this.mark(actor);
24
+ const external = () => this.release(actor);
25
+ const componentExternal = () => { record.componentsUnsafe = true; external(); };
26
+ const observe = value => observeData(value, record, changed, componentExternal);
27
+ // Spawn merges own props shallowly; nested objects may still belong to
28
+ // the caller. They need the ordinary per-frame check for retained aliases.
29
+ if (spawned && Object.values(actor.components).some(props => Object.values(props ?? {}).some(value => value && typeof value === 'object'))) {
30
+ record.unsafe = true;
31
+ }
32
+ for (const [name, props] of Object.entries(actor.components)) {
33
+ const defaults = this.scene.behaviors.get(name)?.defaultProps;
34
+ if (Object.entries(props ?? {}).some(([key, value]) => value && typeof value === 'object' && value === defaults?.[key])) record.unsafe = true;
35
+ }
36
+ observeSlot(actor, 'components', observe, changed, componentExternal);
37
+ record.componentsUnsafe = record.unsafe;
38
+ observeSlot(actor, 'static', value => value, changed, external);
39
+ // Runtime is deliberately not serialized, but physics/network quaternion
40
+ // writes and tier render-sleep changes affect placement just like Transform.
41
+ observeSlot(actor, 'runtime', value => observeRuntime(value, record, changed, external), changed, external);
42
+ this.mark(actor);
43
+ }
44
+
45
+ remove(actor) {
46
+ this.records.delete(actor);
47
+ this.live.delete(actor);
48
+ for (const consumer of this.consumers) consumer.dirty.add(actor);
49
+ }
50
+
51
+ isStatic(actor, physics = false) {
52
+ const record = this.records.get(actor);
53
+ if (!record || (physics ? record.componentsUnsafe : record.unsafe) || actor.static !== true) return false;
54
+ if (['dynamic', 'kinematic'].includes(actor.components.Body?.type)) return false;
55
+ return !Object.keys(actor.components).some(name => ACTS.some(hook => typeof this.scene.behaviors.get(name)?.prototype?.[hook] === 'function'));
56
+ }
57
+
58
+ mark(actor) {
59
+ if (!this.records.has(actor)) return;
60
+ if (this.isStatic(actor)) this.live.delete(actor);
61
+ else this.live.add(actor);
62
+ for (const consumer of this.consumers) {
63
+ if (consumer.physics && this.writingPhysics > 0) continue;
64
+ consumer.dirty.add(actor);
65
+ consumer.changed?.(actor);
66
+ }
67
+ }
68
+
69
+ release(actor) {
70
+ const record = this.records.get(actor);
71
+ if (!record) return;
72
+ record.unsafe = true;
73
+ this.mark(actor);
74
+ }
75
+
76
+ markAll() {
77
+ for (const actor of this.records.keys()) this.mark(actor);
78
+ }
79
+
80
+ consumer(changed, reset, physics = false) {
81
+ const owner = this;
82
+ const consumer = {
83
+ dirty: new Set(this.records.keys()), changed, reset, physics,
84
+ take(withLive = true) {
85
+ const actors = new Set(this.dirty);
86
+ this.dirty.clear();
87
+ if (withLive) for (const actor of owner.live) actors.add(actor);
88
+ return [...actors].sort((a, b) => (a.components.Layout?.z ?? 0) - (b.components.Layout?.z ?? 0) ||
89
+ (owner.records.get(a)?.order ?? -1) - (owner.records.get(b)?.order ?? -1));
90
+ },
91
+ dispose() { owner.consumers.delete(this); this.dirty.clear(); this.changed = null; this.reset = null; },
92
+ };
93
+ this.consumers.add(consumer);
94
+ return consumer;
95
+ }
96
+
97
+ dispose() {
98
+ for (const consumer of [...this.consumers]) { consumer.reset?.(); consumer.dispose(); }
99
+ this.records.clear();
100
+ this.live.clear();
101
+ }
102
+ }
103
+
104
+ function observeRuntime(runtime, record, changed, external) {
105
+ if (!runtime || typeof runtime !== 'object' || ![Object.prototype, null].includes(Object.getPrototypeOf(runtime))) { external(); return runtime; }
106
+ const watched = key => key === 'quat' || key === 'renderSleep';
107
+ return new Proxy(runtime, {
108
+ get(target, key, receiver) {
109
+ const value = Reflect.get(target, key, receiver);
110
+ return key === 'quat' ? observeData(value, record, changed, external) : value;
111
+ },
112
+ set(target, key, value) {
113
+ const previous = target[key];
114
+ const ok = Reflect.set(target, key, value);
115
+ if (ok && watched(key) && !Object.is(previous, value)) {
116
+ if (value && typeof value === 'object') external();
117
+ changed();
118
+ }
119
+ return ok;
120
+ },
121
+ deleteProperty(target, key) {
122
+ const ok = Reflect.deleteProperty(target, key);
123
+ if (ok && watched(key)) changed();
124
+ return ok;
125
+ },
126
+ defineProperty(target, key, descriptor) {
127
+ const ok = Reflect.defineProperty(target, key, descriptor);
128
+ if (ok && watched(key)) { external(); changed(); }
129
+ return ok;
130
+ },
131
+ });
132
+ }
133
+
134
+ function observeSlot(object, key, observe, changed, external) {
135
+ let value = observe(object[key]);
136
+ const enumerable = Object.prototype.propertyIsEnumerable.call(object, key);
137
+ Object.defineProperty(object, key, {
138
+ configurable: true, enumerable,
139
+ get: () => value,
140
+ set(next) {
141
+ if (Object.is(value, next)) return;
142
+ if (next && typeof next === 'object') external();
143
+ value = observe(next);
144
+ changed();
145
+ },
146
+ });
147
+ }
148
+
149
+ function observeData(value, record, changed, external, depth = 0) {
150
+ if (!value || typeof value !== 'object') return value;
151
+ value = rawValues.get(value) ?? value;
152
+ if (record.proxies.has(value)) return record.proxies.get(value);
153
+ const proto = Object.getPrototypeOf(value);
154
+ const descriptors = Object.getOwnPropertyDescriptors(value);
155
+ if (depth >= 32 || (proto !== Object.prototype && proto !== Array.prototype && proto !== null) ||
156
+ 'toJSON' in value || Reflect.ownKeys(descriptors).some(key =>
157
+ !('value' in descriptors[key]) || (!descriptors[key].configurable && !(Array.isArray(value) && key === 'length')))) {
158
+ record.unsafe = true;
159
+ return value;
160
+ }
161
+ const previous = rawOwners.get(value);
162
+ if (previous && previous !== external) { previous(); external(); }
163
+ rawOwners.set(value, external);
164
+ const proxy = new Proxy(value, {
165
+ get(target, key, receiver) {
166
+ const descriptor = Reflect.getOwnPropertyDescriptor(target, key);
167
+ if (descriptor && !descriptor.configurable && descriptor.writable === false) return descriptor.value;
168
+ return observeData(Reflect.get(target, key, receiver), record, changed, external, depth + 1);
169
+ },
170
+ getOwnPropertyDescriptor(target, key) {
171
+ const descriptor = Reflect.getOwnPropertyDescriptor(target, key);
172
+ if (descriptor?.configurable && 'value' in descriptor) descriptor.value = observeData(descriptor.value, record, changed, external, depth + 1);
173
+ return descriptor;
174
+ },
175
+ set(target, key, next) {
176
+ if (Object.is(target[key], next)) return true;
177
+ if (next && typeof next === 'object') external();
178
+ const ok = Reflect.set(target, key, rawValues.get(next) ?? next);
179
+ if (ok) changed();
180
+ return ok;
181
+ },
182
+ deleteProperty(target, key) {
183
+ const had = key in target;
184
+ const ok = Reflect.deleteProperty(target, key);
185
+ if (had && ok) changed();
186
+ return ok;
187
+ },
188
+ defineProperty(target, key, descriptor) {
189
+ // Descriptors can install accessors or make future observation illegal.
190
+ external();
191
+ const ok = Reflect.defineProperty(target, key, descriptor);
192
+ if (ok) changed();
193
+ return ok;
194
+ },
195
+ setPrototypeOf(target, next) { external(); return Reflect.setPrototypeOf(target, next); },
196
+ preventExtensions(target) { external(); return Reflect.preventExtensions(target); },
197
+ });
198
+ record.proxies.set(value, proxy);
199
+ rawValues.set(proxy, value);
200
+ // Discover unsupported nested data now, before deciding this actor can freeze.
201
+ for (const key of Object.keys(value)) observeData(value[key], record, changed, external, depth + 1);
202
+ return proxy;
203
+ }
204
+
205
+ // structuredClone cannot consume a Proxy. Strip only our wrappers before the
206
+ // usual clone, retaining aliases/cycles and leaving other structured data alone.
207
+ export function cloneFrozenData(value) {
208
+ const seen = new Map();
209
+ function plain(item) {
210
+ item = rawValues.get(item) ?? item;
211
+ if (!item || typeof item !== 'object') return item;
212
+ if (seen.has(item)) return seen.get(item);
213
+ if (item instanceof Map) {
214
+ const copy = new Map();
215
+ seen.set(item, copy);
216
+ for (const [key, value] of item) copy.set(plain(key), plain(value));
217
+ return copy;
218
+ }
219
+ if (item instanceof Set) {
220
+ const copy = new Set();
221
+ seen.set(item, copy);
222
+ for (const value of item) copy.add(plain(value));
223
+ return copy;
224
+ }
225
+ const proto = Object.getPrototypeOf(item);
226
+ if (!Array.isArray(item) && proto !== Object.prototype && proto !== null) return item;
227
+ const copy = Array.isArray(item) ? new Array(item.length) : {};
228
+ seen.set(item, copy);
229
+ for (const key of Object.keys(item)) Object.defineProperty(copy, key, { value: plain(item[key]), enumerable: true, configurable: true, writable: true });
230
+ return copy;
231
+ }
232
+ return structuredClone(plain(value));
233
+ }
@@ -10,6 +10,7 @@ import { updateTaps } from './tap';
10
10
  import { nextStillVersion, stillClock, StillKeeper } from './stillClock';
11
11
  import { readSkyKey } from './skyKey';
12
12
  import { actorUpdateDt } from './updateBudget';
13
+ import { FrozenActors, cloneFrozenData } from './frozenActors';
13
14
 
14
15
  const CARD_WIDTH = 500;
15
16
  const CARD_HEIGHT = 700;
@@ -141,6 +142,13 @@ function sceneKeepsStaticActors(data) {
141
142
  return data?.engine?.staticActors === true && data?.engine?.skipUnchangedActors === true;
142
143
  }
143
144
 
145
+ function sceneFreezesStatics(data) {
146
+ if (data?.engine?.frozenStatics !== true) return false;
147
+ if (sceneKeepsStaticActors(data)) return true;
148
+ console.warn('frozenStatics requires skipUnchangedActors and staticActors; ignoring frozenStatics');
149
+ return false;
150
+ }
151
+
144
152
  // What a behaviour class does on its own, frame by frame or when switched on
145
153
  // or off. An actor with a component of such a class is never still.
146
154
  const ACTS = ['update', 'onEnable', 'onDisable'];
@@ -262,6 +270,16 @@ export class SceneRuntime {
262
270
  return this.#keepsStatic;
263
271
  }
264
272
 
273
+ #frozen = null;
274
+ #frozenUpdates = null;
275
+
276
+ get frozenActors() { return this.#frozen; }
277
+ get freezesStatics() { return this.#frozen !== null; }
278
+
279
+ // Capability, independent of scene keys. Older published runtimes have no
280
+ // fence; kits must check this marker before installing beforeBehavior.
281
+ get callsBeforeBehavior() { return true; }
282
+
265
283
  // For a scene that asked: the actors that are still, or null for a scene
266
284
  // that did not. An actor is still when its scene file marked it
267
285
  // `"static": true`, it has no `Body`, none of its components' classes acts on
@@ -309,6 +327,11 @@ export class SceneRuntime {
309
327
  // from the frame of the touch on. Costs nothing for an actor that is not
310
328
  // still, and does nothing in a scene that did not ask for `staticActors`.
311
329
  touch(actorOrId) {
330
+ if (this.#frozen) {
331
+ const actor = typeof actorOrId === 'string' ? this.actors.get(actorOrId) : actorOrId;
332
+ if (actor) this.#frozen.mark(actor);
333
+ return;
334
+ }
312
335
  if (this.#still === null) return;
313
336
  const actor = typeof actorOrId === 'string' ? this.actors.get(actorOrId) : actorOrId;
314
337
  if (!actor) return;
@@ -320,6 +343,7 @@ export class SceneRuntime {
320
343
  // load. For a world that cannot leave actors alone (the 3d kit's scene
321
344
  // editor, a world drawing copies of a model together).
322
345
  releaseStill() {
346
+ if (this.#frozen) for (const actor of this.actors.values()) this.#frozen.release(actor);
323
347
  if (this.#still === null || this.#still.size === 0) return;
324
348
  for (const actor of this.#still) this.#touched.add(actor.id);
325
349
  this.#noneStill();
@@ -359,20 +383,22 @@ export class SceneRuntime {
359
383
  // and returned, with no update entered from inside it and the still set
360
384
  // unmoved; a throw anywhere in it, or an update inside it, leaves nothing
361
385
  // adopted.
362
- #updateHoldingStill(dt) {
386
+ #updateHoldingStill(dt, frozenPass) {
363
387
  const keeper = this.#keeper;
364
388
  const pass = keeper.begin(this.#stillVersion);
365
389
  let completed = false;
366
390
  try {
367
391
  this.time += dt;
368
392
  updateTaps(this);
369
- for (const actor of this.getActors()) {
393
+ for (const actor of frozenPass ? frozenPass.take() : this.getActors()) {
370
394
  // A still actor has no component that updates or is told of being
371
395
  // switched on or off, and was run with the rest by the update that
372
396
  // adopted. Once this update is no longer alone (a behaviour updated
373
397
  // the scene from inside it) or the set has changed (one touched an
374
398
  // actor, or loaded a scene), the rest of the loop runs every actor.
375
- if (pass.settled && keeper.alone(pass, this.#stillVersion) && this.#still.has(actor)) continue;
399
+ if (frozenPass) {
400
+ if (this.actors.get(actor.id) !== actor || this.isActorSleeping(actor)) continue;
401
+ } else if (pass.settled && keeper.alone(pass, this.#stillVersion) && this.#still.has(actor)) continue;
376
402
  const actorDt = actorUpdateDt(actor, dt);
377
403
  if (actorDt === null) continue;
378
404
  this.#syncEnabled(actor);
@@ -490,6 +516,7 @@ export class SceneRuntime {
490
516
  // the difference that matters to a system holding something the browser keeps
491
517
  // doing on its own -- a playing sound outlives its scene otherwise.
492
518
  dispose() {
519
+ this.#frozen?.dispose();
493
520
  for (const system of this.systems) system.dispose?.(this);
494
521
  }
495
522
 
@@ -527,6 +554,9 @@ export class SceneRuntime {
527
554
  // (`setBehaviors` doesn't touch the cache directly; a stale entry is simply
528
555
  // caught here on next access).
529
556
  #instanceFor(actor, name, Behavior, props) {
557
+ // Optional kit fence before constructors or any consumer callback. It
558
+ // also covers collisions, taps, enabled transitions and direct behavior().
559
+ this.beforeBehavior?.(actor, name);
530
560
  const cache = (actor.runtime.$behaviors ??= new Map());
531
561
  const cached = cache.get(name);
532
562
  if (cached && cached.constructor === Behavior) return cached;
@@ -564,9 +594,44 @@ export class SceneRuntime {
564
594
  }
565
595
  // A class may have gained or lost an `update`.
566
596
  if (this.#still !== null) this.#findStill();
597
+ this.#frozen?.markAll();
567
598
  }
568
599
 
600
+ // Lazily allocated by a kit that streams a scene. Sleeping actors retain
601
+ // ID lookup, components, behavior state and serialization; live passes only
602
+ // visit awake actors. Spawns wake their ID and loads discard the sleep set.
603
+ #awakeActors = null;
604
+ #sleepingActors = null;
605
+
606
+ setActorSleeping(actorOrId, sleeping) {
607
+ const actor = typeof actorOrId === 'string' ? this.actors.get(actorOrId) : actorOrId;
608
+ if (!actor || this.actors.get(actor.id) !== actor) return false;
609
+ this.#frozen?.mark(actor);
610
+ if (!sleeping && !this.#awakeActors) return true;
611
+ this.#awakeActors ??= new Map(this.actors);
612
+ this.#sleepingActors ??= new Set();
613
+ if (sleeping) {
614
+ this.touch(actor);
615
+ this.#awakeActors.delete(actor.id);
616
+ this.#sleepingActors.add(actor.id);
617
+ } else {
618
+ this.#sleepingActors.delete(actor.id);
619
+ this.#awakeActors.set(actor.id, actor);
620
+ if (!this.#sleepingActors.size) {
621
+ this.#awakeActors = null;
622
+ this.#sleepingActors = null;
623
+ }
624
+ }
625
+ return true;
626
+ }
627
+
628
+ isActorSleeping(actor) { return this.#sleepingActors?.has(actor.id) === true; }
629
+
569
630
  load(sceneData) {
631
+ if (this.#frozen) sceneData = cloneFrozenData(sceneData);
632
+ this.#frozen?.dispose();
633
+ this.#frozen = null;
634
+ this.#frozenUpdates = null;
570
635
  // No actor of the scene being left is still from here on, whether or not
571
636
  // the load completes.
572
637
  if (this.#still !== null) {
@@ -580,6 +645,8 @@ export class SceneRuntime {
580
645
  // simulation state (body positions, joints) would carry it across the load.
581
646
  // No-op on the constructor's first load, before any system is registered.
582
647
  for (const system of this.systems) system.reset?.(this);
648
+ this.#awakeActors = null;
649
+ this.#sleepingActors = null;
583
650
  this.data = structuredClone(sceneData);
584
651
  this.#skipUnchanged = sceneSkipsUnchangedActors(this.data);
585
652
  this.#nearShadowDistance = sceneNearShadowDistance(this.data);
@@ -617,6 +684,10 @@ export class SceneRuntime {
617
684
  this.#touched = new Set();
618
685
  this.#findStill();
619
686
  }
687
+ if (sceneFreezesStatics(this.data)) {
688
+ this.#frozen = new FrozenActors(this);
689
+ for (const actor of this.actors.values()) this.#frozen.add(actor);
690
+ }
620
691
  }
621
692
 
622
693
  // Read and parse a scene file by name, returning its scene data. Use this
@@ -673,6 +744,7 @@ export class SceneRuntime {
673
744
  }
674
745
 
675
746
  serialize() {
747
+ if (this.#frozen) return cloneFrozenData(this.data);
676
748
  return structuredClone(this.data);
677
749
  }
678
750
 
@@ -689,7 +761,7 @@ export class SceneRuntime {
689
761
 
690
762
  getActors() {
691
763
  if (this.#skipUnchanged) return this.#actorsSkippingSort();
692
- return [...this.actors.values()].sort((a, b) => {
764
+ return [...(this.#awakeActors ?? this.actors).values()].sort((a, b) => {
693
765
  const az = getLayout(a)?.z ?? 0;
694
766
  const bz = getLayout(b)?.z ?? 0;
695
767
  return az - bz;
@@ -699,7 +771,7 @@ export class SceneRuntime {
699
771
  // `getActors` for a scene that set `skipUnchangedActors`: the same list,
700
772
  // sorted only when it is not already in order.
701
773
  #actorsSkippingSort() {
702
- const actors = [...this.actors.values()];
774
+ const actors = [...(this.#awakeActors ?? this.actors).values()];
703
775
  if (alreadyInLayoutOrder(actors)) return actors;
704
776
  return actors.sort((a, b) => (getLayout(a)?.z ?? 0) - (getLayout(b)?.z ?? 0));
705
777
  }
@@ -763,6 +835,9 @@ export class SceneRuntime {
763
835
  this.#initActor(next);
764
836
  this.data.actors.push(next);
765
837
  this.actors.set(id, next);
838
+ this.#sleepingActors?.delete(id);
839
+ this.#awakeActors?.set(id, next);
840
+ this.#frozen?.add(next, true);
766
841
  return next;
767
842
  }
768
843
 
@@ -779,8 +854,11 @@ export class SceneRuntime {
779
854
  despawnActor(actorId) {
780
855
  const actor = this.actors.get(actorId);
781
856
  if (!actor) return false;
857
+ this.#frozen?.remove(actor);
782
858
  if (this.#still !== null && this.#still.delete(actor)) this.#stillVersion = nextStillVersion();
783
859
  this.actors.delete(actorId);
860
+ this.#sleepingActors?.delete(actorId);
861
+ this.#awakeActors?.delete(actorId);
784
862
  const idx = this.data.actors.findIndex((a) => a.id === actorId);
785
863
  if (idx !== -1) this.data.actors.splice(idx, 1);
786
864
  return true;
@@ -928,6 +1006,10 @@ export class SceneRuntime {
928
1006
  }
929
1007
 
930
1008
  update(dt) {
1009
+ if (this.#frozen) {
1010
+ this.#updateHoldingStill(dt, this.#frozenUpdates ??= this.#frozen.consumer());
1011
+ return;
1012
+ }
931
1013
  // A scene that holds actors still (`"engine": { "staticActors": true }`).
932
1014
  if (this.#still !== null) {
933
1015
  this.#updateHoldingStill(dt);
@@ -28,7 +28,7 @@ export default [
28
28
  },
29
29
  },
30
30
  {
31
- files: ['engine/**/*.{js,jsx}', 'editors/**/*.{js,jsx}', 'behaviors/**/*.{js,jsx}', '*.js', '*.jsx'],
31
+ files: ['play/**/*.{js,jsx}', 'engine/**/*.{js,jsx}', 'editors/**/*.{js,jsx}', 'behaviors/**/*.{js,jsx}', '*.js', '*.jsx'],
32
32
  languageOptions: {
33
33
  ecmaVersion: 'latest',
34
34
  sourceType: 'module',
@@ -0,0 +1,198 @@
1
+ // Generated from ../../behaviors/AnalogStick.jsx; run npm run sync:play-behaviors.
2
+ import { acquirePress, GREEDY_CLAIM, length, clampLength } from '../../engine/physics/controls';
3
+
4
+ // AnalogStick: on-screen virtual joystick (press anywhere) that drives the
5
+ // actor with OG-style force mode — ramp in, hard top speed, idle-only brake.
6
+ // Screen-fixed: the ring stays under the thumb while a Camera scrolls, and does
7
+ // not rotate with the actor. Needs a RigidBody (dynamic) + Collider. Never
8
+ // touches an undriven axis.
9
+ //
10
+ // speed -> top speed at full deflection (px per fixed step).
11
+ // rampTime -> seconds from rest to speed at full deflection (0 = instant).
12
+ // slowDown -> deceleration while idle, speed units lost per second (0 = coast).
13
+ // turnBoost -> extra accel when velocity points away from the stick (OG turnFriction).
14
+ // maxRadius -> stick throw radius in pixels.
15
+ // axes -> 'horizontal' / 'vertical' / 'both'.
16
+ //
17
+ // Sibling hooks (fired on this actor only): onAnalogStickBegin / onAnalogStickEnd
18
+ // (actor, scene) — begin on first nonzero deflection, end on release or disable.
19
+ //
20
+ // Force-mode math lives here (only consumer): stickDrive / stickBrake return
21
+ // velocity deltas via applyImpulse — mass-independent, composable, and
22
+ // restricted to driven axes so gravity on an undriven axis is never clamped.
23
+ // Stick displacement from origin, clamped to maxRadius.
24
+ function stickVector(pointer, origin, maxRadius = 60) {
25
+ return clampLength({ x: pointer.x - origin.x, y: pointer.y - origin.y }, maxRadius);
26
+ }
27
+ // Card coords before the camera — for screen-fixed controls reading a pointer.
28
+ function screenPoint(pointer) {
29
+ return { x: pointer.screenX, y: pointer.screenY };
30
+ }
31
+ // Keep only the axes the stick is allowed to drive. An undriven axis (gravity
32
+ // in a platformer) must never be clamped or braked by the stick.
33
+ function drivenAxes(v, axes) {
34
+ return {
35
+ x: axes === 'vertical' ? 0 : v.x,
36
+ y: axes === 'horizontal' ? 0 : v.y,
37
+ };
38
+ }
39
+ // Smallest signed angle from `from` to `to`, wrapped into [−π, π].
40
+ function angleDelta(from, to) {
41
+ let d = Math.atan2(to.y, to.x) - Math.atan2(from.y, from.x);
42
+ if (d > Math.PI)
43
+ d -= 2 * Math.PI;
44
+ if (d < -Math.PI)
45
+ d += 2 * Math.PI;
46
+ return d;
47
+ }
48
+ // Velocity delta while held: accelerate toward deflection × speed with turn
49
+ // boost on reversals, then clamp driven axes to `speed`. Impulse only.
50
+ function stickDrive(velocity, deflection, props = {}, dt) {
51
+ const speed = props.speed ?? 6;
52
+ const rampTime = props.rampTime ?? 0.2;
53
+ const turnBoost = props.turnBoost ?? 3;
54
+ const axes = props.axes ?? 'both';
55
+ const vDriven = drivenAxes(velocity, axes);
56
+ let boost = 1;
57
+ if (turnBoost > 0 && length(velocity) > 0 && length(deflection) > 0) {
58
+ boost = 1 + turnBoost * (Math.abs(angleDelta(velocity, deflection)) / Math.PI);
59
+ }
60
+ let delta;
61
+ if (rampTime <= 0) {
62
+ const target = drivenAxes({ x: deflection.x * speed, y: deflection.y * speed }, axes);
63
+ delta = { x: target.x - vDriven.x, y: target.y - vDriven.y };
64
+ }
65
+ else {
66
+ const accel = speed / rampTime;
67
+ delta = drivenAxes({ x: deflection.x * accel * boost * dt, y: deflection.y * accel * boost * dt }, axes);
68
+ const capped = clampLength({ x: vDriven.x + delta.x, y: vDriven.y + delta.y }, speed);
69
+ delta = { x: capped.x - vDriven.x, y: capped.y - vDriven.y };
70
+ }
71
+ return delta;
72
+ }
73
+ // Velocity delta while idle: Coulomb brake on driven axes only.
74
+ // `slowDown` is speed units lost per second (px/step per second). 0 = coast.
75
+ function stickBrake(velocity, props = {}, dt) {
76
+ const slowDown = props.slowDown ?? 20;
77
+ if (slowDown <= 0)
78
+ return { x: 0, y: 0 };
79
+ const axes = props.axes ?? 'both';
80
+ const vDriven = drivenAxes(velocity, axes);
81
+ const len = length(vDriven);
82
+ if (len === 0)
83
+ return { x: 0, y: 0 };
84
+ const reduce = Math.min(len, slowDown * dt);
85
+ const s = -reduce / len;
86
+ return { x: vDriven.x * s, y: vDriven.y * s };
87
+ }
88
+ function fireStickHook(actor, scene, hook) {
89
+ scene.forEachBehavior(actor, (inst) => inst[hook]?.(actor, scene));
90
+ }
91
+ function resetStick(state) {
92
+ state.began = false;
93
+ state.pointerId = null;
94
+ state.origin = null;
95
+ state.knob = null;
96
+ }
97
+ class AnalogStick {
98
+ static behaviorName = 'AnalogStick';
99
+ // Drives a body, so it needs one: Collider + dynamic RigidBody.
100
+ static expectedSiblings = ['Collider', 'RigidBody'];
101
+ static defaultProps = {
102
+ speed: 6,
103
+ rampTime: 0.2,
104
+ slowDown: 20,
105
+ turnBoost: 3,
106
+ maxRadius: 60,
107
+ axes: 'both',
108
+ };
109
+ // `maxRadius` is the stick's travel in px; below ~10 the knob has no usable
110
+ // throw and the control reads as broken. slowDown humanizes to "Slow Down".
111
+ static propertyMeta = {
112
+ speed: { min: 0, step: 0.5 },
113
+ rampTime: { min: 0, step: 0.05 },
114
+ slowDown: { min: 0, step: 1 },
115
+ turnBoost: { min: 0, step: 0.5 },
116
+ maxRadius: { min: 10, step: 5 },
117
+ };
118
+ static initialState = { began: false, pointerId: null, origin: null, knob: null };
119
+ constructor(props) {
120
+ this.props = props;
121
+ }
122
+ // The finger this stick is following, placing it on a fresh press if it isn't
123
+ // following one yet. The stick stays with the finger that placed it, so a
124
+ // second finger elsewhere (another stick, a drag) never yanks it -- and it
125
+ // gives the pointer up if a targeted control outranks its claim.
126
+ trackedPointer(actor, scene) {
127
+ const state = this.state;
128
+ if (state.pointerId != null && scene.ownsPointer(state.pointerId, actor.id)) {
129
+ const held = scene.pointers.get(state.pointerId);
130
+ if (held?.down)
131
+ return held;
132
+ }
133
+ state.pointerId = null;
134
+ // Any fresh press will do -- the stick is placed wherever you touch -- but
135
+ // only one nobody more specific wants.
136
+ const press = acquirePress(scene, actor.id, () => GREEDY_CLAIM);
137
+ if (!press)
138
+ return null;
139
+ state.pointerId = press.id;
140
+ state.origin = { x: press.screenX, y: press.screenY };
141
+ return press;
142
+ }
143
+ update(actor, scene, dt) {
144
+ const state = this.state;
145
+ const p = this.trackedPointer(actor, scene);
146
+ if (p?.down && state.origin) {
147
+ const maxRadius = this.props.maxRadius ?? 60;
148
+ const sp = screenPoint(p);
149
+ const knob = stickVector(sp, state.origin, maxRadius);
150
+ state.knob = knob;
151
+ const deflection = { x: knob.x / maxRadius, y: knob.y / maxRadius };
152
+ const vel = scene.physics.getVelocity(actor);
153
+ scene.physics.applyImpulse(actor, stickDrive(vel, deflection, this.props, dt));
154
+ // OG fires on first movement, not on a still press.
155
+ if (!state.began && length(deflection) > 0) {
156
+ state.began = true;
157
+ fireStickHook(actor, scene, 'onAnalogStickBegin');
158
+ }
159
+ return;
160
+ }
161
+ if (state.began) {
162
+ fireStickHook(actor, scene, 'onAnalogStickEnd');
163
+ }
164
+ resetStick(state);
165
+ // Idle every frame: brake on driven axes only (gravity/momentum elsewhere stay).
166
+ const vel = scene.physics.getVelocity(actor);
167
+ scene.physics.applyImpulse(actor, stickBrake(vel, this.props, dt));
168
+ }
169
+ // Switched off mid-hold: fire end and drop runtime state. `update` stops
170
+ // running once disabled, so this is the only chance to release the gesture.
171
+ onDisable(actor, scene) {
172
+ const state = this.state;
173
+ if (state.began)
174
+ fireStickHook(actor, scene, 'onAnalogStickEnd');
175
+ resetStick(state);
176
+ }
177
+ // Drawn in screen space (drawUi) so the ring stays under the thumb while the
178
+ // camera scrolls, and doesn't rotate with the actor.
179
+ drawUi(actor, scene, ctx) {
180
+ const state = this.state;
181
+ if (!state.origin)
182
+ return;
183
+ const o = state.origin;
184
+ const k = state.knob ?? { x: 0, y: 0 };
185
+ const radius = this.props.maxRadius ?? 60;
186
+ ctx.strokeStyle = 'rgba(255, 255, 255, 0.5)';
187
+ ctx.lineWidth = 3;
188
+ ctx.beginPath();
189
+ ctx.arc(o.x, o.y, radius, 0, Math.PI * 2);
190
+ ctx.stroke();
191
+ ctx.fillStyle = 'rgba(255, 255, 255, 0.85)';
192
+ ctx.beginPath();
193
+ ctx.arc(o.x + k.x, o.y + k.y, 20, 0, Math.PI * 2);
194
+ ctx.fill();
195
+ }
196
+ }
197
+
198
+ export { AnalogStick };