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
@@ -3,19 +3,7 @@
3
3
  // Behaviors update, the physics3d system steps rapier, then Transforms sync to
4
4
  // three nodes and the composer renders. No game logic here.
5
5
  import React, { useCallback, useEffect, useRef, useState } from 'react';
6
- import { makeScene } from '@imports/castle.physics-2d/engine/scene';
7
- import {
8
- makeWorld3D,
9
- resizeWorld,
10
- syncActors,
11
- renderWorld,
12
- disposeWorld,
13
- updatePhysicsDebug,
14
- } from './world3d';
15
- import { prepareEmptyNodes, loadEmptyScene } from './emptynodes';
16
- import { attachOrbitInput } from './orbitinput';
17
- import { renderHidingOwnModel } from './ownmodel';
18
- import { makeFrameClock, makeInputLatch, nextFrame, updateLending } from './framecap';
6
+ import { mountScene3D, hudStyles } from './playerRun';
19
7
 
20
8
  export function Scene3DPlayer({
21
9
  sceneData,
@@ -24,6 +12,7 @@ export function Scene3DPlayer({
24
12
  behaviorClasses,
25
13
  scenePath,
26
14
  onFirstFrame,
15
+ onStage,
27
16
  }) {
28
17
  const canvasRef = useRef(null);
29
18
  const scoreRef = useRef(null);
@@ -34,39 +23,21 @@ export function Scene3DPlayer({
34
23
  useEffect(() => {
35
24
  const canvas = canvasRef.current;
36
25
  if (!canvas) return undefined;
37
- const runtime = makeScene(sceneData, behaviorClasses, sprites, files, scenePath);
38
- const world = makeWorld3D(canvas);
39
- runtime.three = world;
40
- if (runtime.skipsEmptyNodes) prepareEmptyNodes(world, runtime);
41
- // The first load precedes world creation; later loads initialize at the latch.
42
- if (runtime.cameraControl === 'orbit') world.ownModelWith ??= new Set();
43
- runtime.hud = {};
44
- // Scene-independent state: survives `loadFromFile` (the scene data is
45
- // replaced, the runtime instance is not). Player score/inventory and the
46
- // camera angle live here so they cross scene switches.
47
- runtime.persistent = {};
48
- runtime.currentScenePath = scenePath ?? 'scenes/main.scene';
49
- // This loop applies `requestedContent` with `requestedScene` (another
50
- // deck's content, mounted as data); a caller checks before asking.
51
- runtime.mountsContent = true;
52
-
53
- // What went down between capped frames, for the next one that runs.
54
- const latch = makeInputLatch();
55
- const detachInput = attachInput(canvas, runtime, world, latch);
56
- const stopResize = attachResize(canvas, world);
57
- const onLoopError = (err) => {
58
- console.error(err);
59
- setError(err);
60
- };
61
- const hudRefs = { score: scoreRef, look: lookRef };
62
- const stopLoop = startLoop(runtime, world, sprites, hudRefs, onFirstFrame, onLoopError, latch);
63
- return () => {
64
- stopLoop();
65
- stopResize();
66
- detachInput();
67
- runtime.dispose();
68
- disposeWorld(world);
69
- };
26
+ return mountScene3D({
27
+ canvas,
28
+ sceneData,
29
+ sprites,
30
+ files,
31
+ behaviorClasses,
32
+ scenePath,
33
+ onFirstFrame,
34
+ onStage,
35
+ hudRefs: { score: scoreRef, look: lookRef },
36
+ onLoopError: (err) => {
37
+ console.error(err);
38
+ setError(err);
39
+ },
40
+ });
70
41
  // eslint-disable-next-line react-hooks/exhaustive-deps
71
42
  }, [runId]);
72
43
 
@@ -91,298 +62,13 @@ export function Scene3DPlayer({
91
62
  WebkitTouchCallout: 'none',
92
63
  }}
93
64
  />
94
- <div ref={scoreRef} style={hudStyles.score} />
95
- <div ref={lookRef} style={hudStyles.look} />
65
+ <div ref={scoreRef} data-engine-hud="score" style={hudStyles.score} />
66
+ <div ref={lookRef} data-engine-hud="look" style={hudStyles.look} />
96
67
  {error ? <LoopErrorOverlay error={error} onRestart={onRestart} /> : null}
97
68
  </div>
98
69
  );
99
70
  }
100
71
 
101
- function attachInput(canvas, runtime, world, latch) {
102
- const onKeyDown = (event) => {
103
- // Space is gameplay (jump); keep it from scrolling the page.
104
- if (event.code === 'Space' && event.target === canvas) event.preventDefault();
105
- if (event.code === 'KeyP' && !event.repeat) {
106
- world.debugLines.visible = !world.debugLines.visible;
107
- }
108
- if (runtime.cameraControl === 'orbit' && event.key === 'Shift' && !event.repeat &&
109
- !event.target?.isContentEditable && !event.target?.closest?.('input, textarea, select')) {
110
- runtime.orbitInput().shiftLock.toggle();
111
- }
112
- runtime.keys.add(event.code);
113
- runtime.keys.add(event.key);
114
- // A key's auto-repeat is not a new press: it is held, and a frame that
115
- // runs sees it held.
116
- if (runtime.maxFps > 0 && !event.repeat) {
117
- latch.keys.add(event.code);
118
- latch.keys.add(event.key);
119
- }
120
- };
121
- const onKeyUp = (event) => {
122
- runtime.keys.delete(event.code);
123
- runtime.keys.delete(event.key);
124
- };
125
- // Pointer (mouse or touch) input is multitouch, tracked per pointerId:
126
- // - a DRAG is the virtual stick -- the offset from where the drag started
127
- // maps to a walk direction (drag up = forward). The first pointer to
128
- // travel past the tap slop owns the stick until it lifts.
129
- // - a TAP (down and up quickly without moving much) is a jump, even while
130
- // another finger is dragging. `moveInput.consumeJump()` hands the
131
- // pending tap to the Player behavior exactly once.
132
- // `runtime.moveInput` is what the Player behavior reads.
133
- const STICK_RADIUS_PX = 56;
134
- const TAP_SLOP_PX = 12;
135
- const TAP_MS = 300;
136
- const pointers = new Map();
137
- let stickId = null;
138
- let jumpPending = false;
139
- const move = {
140
- x: 0,
141
- y: 0,
142
- active: false,
143
- consumeJump() {
144
- const had = jumpPending;
145
- jumpPending = false;
146
- return had;
147
- },
148
- };
149
- runtime.moveInput = move;
150
- const clearStick = () => {
151
- stickId = null;
152
- move.active = false;
153
- move.x = 0;
154
- move.y = 0;
155
- };
156
- // A scene that set `"engine": { "camera": { "control": "orbit" } }` beside
157
- // `"follow": "rigid"`: a pointer that goes down in it is orbitinput.js's
158
- // from then until it lifts (or a scene loads). It is made the first time
159
- // a pointer goes down under the key, Shift is pressed there, or a Player runs under it
160
- // (`runtime.orbitInput()`), never in a runtime that does not meet the key.
161
- // Without the key each handler below reads one property and goes on as it
162
- // always did.
163
- let orbit = null;
164
- runtime.orbitInput = () =>
165
- (orbit ??= attachOrbitInput(
166
- canvas,
167
- runtime,
168
- move,
169
- () => {
170
- jumpPending = true;
171
- },
172
- { stickRadius: STICK_RADIUS_PX, tapSlop: TAP_SLOP_PX, tapMs: TAP_MS },
173
- // A pointer that came up unseen while a lock of the orbit input's
174
- // was on: a pointercancel for it, through the handler below.
175
- (event) => onPointerUp(event)
176
- ));
177
- const onPointerDown = (event) => {
178
- if (runtime.cameraControl === 'orbit') {
179
- // Fingers that went down before the key (a scene without it was
180
- // loaded then) are let go of here, so they and orbitinput.js never
181
- // both write the stick: the handlers below ignore them from now on.
182
- if (pointers.size > 0 || stickId !== null) {
183
- pointers.clear();
184
- clearStick();
185
- }
186
- return runtime.orbitInput().down(event);
187
- }
188
- canvas.focus();
189
- pointers.set(event.pointerId, {
190
- x: event.clientX,
191
- y: event.clientY,
192
- time: performance.now(),
193
- moved: false,
194
- });
195
- // A runtime that has met the key: the orbit input gives this pointer
196
- // its capture back if a lock of its own ends while it is down.
197
- orbit?.pointer(event);
198
- canvas.setPointerCapture(event.pointerId);
199
- };
200
- const onPointerMove = (event) => {
201
- if (orbit?.active && orbit.move(event)) {
202
- // The orbit input writes its stick into `move` too: under a cap it is
203
- // lent like the stick below, so a drag that ends between two capped
204
- // frames is still seen.
205
- if (runtime.maxFps > 0 && move.active) latch.stick = { x: move.x, y: move.y };
206
- return;
207
- }
208
- const p = pointers.get(event.pointerId);
209
- if (!p) return;
210
- const dx = event.clientX - p.x;
211
- const dy = event.clientY - p.y;
212
- if (!p.moved && Math.hypot(dx, dy) > TAP_SLOP_PX) p.moved = true;
213
- // A pointer claims the stick once it is clearly a drag (and nothing else
214
- // holds it) -- so a tapping finger never yanks the walk direction.
215
- if (p.moved && stickId === null) stickId = event.pointerId;
216
- if (stickId !== event.pointerId) return;
217
- const nx = dx / STICK_RADIUS_PX;
218
- const ny = dy / STICK_RADIUS_PX;
219
- const len = Math.hypot(nx, ny);
220
- const scale = len > 1 ? 1 / len : 1;
221
- move.active = true;
222
- move.x = nx * scale;
223
- move.y = ny * scale;
224
- if (runtime.maxFps > 0) latch.stick = { x: move.x, y: move.y };
225
- };
226
- const onPointerUp = (event) => {
227
- if (orbit?.busy && orbit.up(event)) return;
228
- orbit?.pointer(event);
229
- const p = pointers.get(event.pointerId);
230
- pointers.delete(event.pointerId);
231
- if (stickId === event.pointerId) clearStick();
232
- if (event.type === 'pointercancel' || !p) return;
233
- if (!p.moved && performance.now() - p.time < TAP_MS) jumpPending = true;
234
- };
235
- window.addEventListener('keydown', onKeyDown);
236
- window.addEventListener('keyup', onKeyUp);
237
- canvas.addEventListener('pointerdown', onPointerDown);
238
- canvas.addEventListener('pointermove', onPointerMove);
239
- canvas.addEventListener('pointerup', onPointerUp);
240
- canvas.addEventListener('pointercancel', onPointerUp);
241
- if (document.hasFocus() || window.parent === window) canvas.focus();
242
- return () => {
243
- window.removeEventListener('keydown', onKeyDown);
244
- window.removeEventListener('keyup', onKeyUp);
245
- canvas.removeEventListener('pointerdown', onPointerDown);
246
- canvas.removeEventListener('pointermove', onPointerMove);
247
- canvas.removeEventListener('pointerup', onPointerUp);
248
- canvas.removeEventListener('pointercancel', onPointerUp);
249
- orbit?.detach();
250
- };
251
- }
252
-
253
- function attachResize(canvas, world) {
254
- const fit = () => resizeWorld(world, canvas.clientWidth, canvas.clientHeight);
255
- const observer = new ResizeObserver(fit);
256
- observer.observe(canvas);
257
- fit();
258
- return () => observer.disconnect();
259
- }
260
-
261
- function startLoop(runtime, world, sprites, hudRefs, onFirstFrame, onError, latch) {
262
- let raf = 0;
263
- const clock = makeFrameClock(performance.now());
264
- let firstFrameSignaled = false;
265
- const tick = (now) => {
266
- // A scene that set `engine.maxFps` skips an animation frame that comes
267
- // too soon after the last frame that ran (`framecap.js`); without it
268
- // every animation frame runs, handed what it always was.
269
- const maxFps = runtime.maxFps;
270
- const dt = nextFrame(clock, now, maxFps);
271
- if (dt === null) {
272
- raf = requestAnimationFrame(tick);
273
- return;
274
- }
275
- try {
276
- // A capped frame also sees what went down while frames were skipped.
277
- if (maxFps > 0) updateLending(runtime, latch, dt);
278
- else {
279
- // Nothing noted under a cap outlives it: a frame without one drops it.
280
- if (latch.keys.size > 0 || latch.stick) {
281
- latch.keys.clear();
282
- latch.stick = null;
283
- }
284
- runtime.update(dt);
285
- }
286
- // A behavior may have requested a scene switch; apply it here, between
287
- // frames, never mid physics dispatch. The load resets
288
- // registered systems -- the rapier world frees and lazily rebuilds --
289
- // while `runtime.persistent` carries the player's cross-scene state.
290
- if (runtime.requestedScene) {
291
- const next = world.emptyNodesOwned
292
- ? loadEmptyScene(world, runtime, loadRequestedScene)
293
- : loadRequestedScene(runtime);
294
- if (runtime.skipsEmptyNodes) prepareEmptyNodes(world, runtime);
295
- runtime.currentScenePath = next;
296
- runtime.persistent.sceneChangeGraceUntil = runtime.time + 1;
297
- }
298
- syncActors(world, runtime, runtime.sprites ?? sprites, dt);
299
- if (world.debugLines.visible) updatePhysicsDebug(world, runtime.physics3d?.debugRender());
300
- // Under the orbit camera key the Player names its actor for this
301
- // frame's draw, which leaves that model out when the camera is inside
302
- // it (ownmodel.js). Without the key the field is never set and this
303
- // is the call it always was.
304
- if (runtime.orbitOwnModel !== undefined) renderHidingOwnModel(world, runtime, renderWorld);
305
- else renderWorld(world, runtime);
306
- updateHud(runtime, hudRefs);
307
- } catch (err) {
308
- onError?.(err);
309
- return;
310
- }
311
- if (!firstFrameSignaled) {
312
- firstFrameSignaled = true;
313
- requestAnimationFrame(() => onFirstFrame?.());
314
- }
315
- raf = requestAnimationFrame(tick);
316
- };
317
- raf = requestAnimationFrame(tick);
318
- return () => cancelAnimationFrame(raf);
319
- }
320
-
321
- // Load the scene a behavior asked for, with the content it comes from when
322
- // that is another deck's (a hub content pack; `null` puts this deck's own
323
- // back). Content that fails to load puts the scene that was running back and
324
- // leaves the error on `runtime.mountError` for the asker. Returns the path now
325
- // loaded.
326
- function loadRequestedScene(runtime) {
327
- const next = runtime.requestedScene;
328
- runtime.requestedScene = null;
329
- if (runtime.requestedContent === undefined) {
330
- runtime.loadFromFile(next);
331
- return next;
332
- }
333
- const before = { content: runtime.content ?? null, path: runtime.currentScenePath };
334
- runtime.setContent(runtime.requestedContent);
335
- runtime.requestedContent = undefined;
336
- try {
337
- runtime.loadFromFile(next);
338
- return next;
339
- } catch (err) {
340
- console.error('[engine] content failed to load; staying where we were', err);
341
- runtime.setContent(before.content);
342
- runtime.loadFromFile(before.path);
343
- runtime.mountError = err;
344
- return before.path;
345
- }
346
- }
347
-
348
- // Behaviors write `scene.hud = { score, look }`; the loop pushes it into the
349
- // overlay divs imperatively (no react re-render at frame rate).
350
- function updateHud(runtime, hudRefs) {
351
- const hud = runtime.hud ?? {};
352
- const scoreText = hud.score ? String(hud.score) : '';
353
- const lookText = hud.look ?? '';
354
- if (hudRefs.score.current && hudRefs.score.current.textContent !== scoreText) {
355
- hudRefs.score.current.textContent = scoreText;
356
- }
357
- if (hudRefs.look.current && hudRefs.look.current.textContent !== lookText) {
358
- hudRefs.look.current.textContent = lookText;
359
- }
360
- }
361
-
362
- const hudStyles = {
363
- score: {
364
- position: 'absolute',
365
- top: 14,
366
- left: 16,
367
- color: '#7bd9ed',
368
- font: "16px/1.4 'SFMono-Regular', Consolas, monospace",
369
- textShadow: '0 1px 2px rgba(0,0,0,0.8)',
370
- pointerEvents: 'none',
371
- },
372
- look: {
373
- position: 'absolute',
374
- bottom: 22,
375
- left: 0,
376
- right: 0,
377
- textAlign: 'center',
378
- color: '#e6e6e2',
379
- fontStyle: 'italic',
380
- font: 'italic 15px/1.4 Georgia, serif',
381
- textShadow: '0 1px 3px rgba(0,0,0,0.9)',
382
- pointerEvents: 'none',
383
- },
384
- };
385
-
386
72
  function LoopErrorOverlay({ error, onRestart }) {
387
73
  return (
388
74
  <div
@@ -59,6 +59,7 @@ export class ActorNode extends THREE.Group {
59
59
  }
60
60
 
61
61
  updateMatrixWorld(force) {
62
+ if (this.frozenStatic === true) return;
62
63
  // While the scene playing did not ask it is Group's method, after one
63
64
  // test; a record left from a scene that did is dropped on the way.
64
65
  if (!this.skipping.on) {
@@ -6,6 +6,7 @@
6
6
  // Every random choice comes from a generator seeded by `seed`, so the same
7
7
  // fields always give the same shape.
8
8
 
9
+ import { seededRandom } from './modelMath';
9
10
  import * as THREE from 'three';
10
11
 
11
12
  const DEG = Math.PI / 180;
@@ -18,17 +19,6 @@ const CONTROL_SEGMENTS = 4;
18
19
  // A branch is `points` (its control points), `radiusStart` and `radiusEnd`,
19
20
  // its `level` (0 for the trunk) and `fork`, true when it splits at its end.
20
21
 
21
- // A small seeded random number generator (mulberry32) returning [0, 1).
22
- function seededRandom(seed) {
23
- let state = Math.round(seed * 9973 + 17) | 0;
24
- return () => {
25
- state = (state + 0x6d2b79f5) | 0;
26
- let t = Math.imul(state ^ (state >>> 15), 1 | state);
27
- t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
28
- return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
29
- };
30
- }
31
-
32
22
  function number(value, fallback, min, max) {
33
23
  if (!Number.isFinite(value)) {
34
24
  return fallback;
@@ -90,7 +80,7 @@ function turnAway(direction, angle, azimuth) {
90
80
  // last level, it forks into `split` children spread evenly around it at about
91
81
  // `spread` from its direction.
92
82
  export function growBranches(settings) {
93
- const random = seededRandom(settings.seed);
83
+ const random = seededRandom(settings.seed, 17);
94
84
  const branches = [];
95
85
  const queue = [
96
86
  {
@@ -273,7 +263,7 @@ export function placeTips(part, group, groups, copyOf) {
273
263
  return;
274
264
  }
275
265
  mesh.updateMatrix();
276
- const random = seededRandom((Number.isFinite(part.seed) ? part.seed : 1) + 101);
266
+ const random = seededRandom((Number.isFinite(part.seed) ? part.seed : 1) + 101, 17);
277
267
  const spin = new THREE.Quaternion();
278
268
  for (const tip of tips) {
279
269
  const holder = new THREE.Group();
@@ -9,6 +9,7 @@
9
9
  // Catmull-Clark rule that many times, and the result becomes an indexed
10
10
  // geometry with shared, smoothly shaded vertices.
11
11
 
12
+ import { average as averagePoints } from './modelMath';
12
13
  import * as THREE from 'three';
13
14
  import { SEAM, applyOps, boxCage, creaseEdges, edgeKey } from './cageops';
14
15
  import { subdivideSteps } from './optimize';
@@ -297,13 +298,7 @@ function mix(a, b, t) {
297
298
  }
298
299
 
299
300
  function average(points) {
300
- const sum = [0, 0, 0];
301
- for (const point of points) {
302
- sum[0] += point[0];
303
- sum[1] += point[1];
304
- sum[2] += point[2] ?? 0;
305
- }
306
- return sum.map((value) => value / Math.max(1, points.length));
301
+ return averagePoints(points, true);
307
302
  }
308
303
 
309
304
  //
@@ -7,6 +7,8 @@
7
7
  // nothing.
8
8
 
9
9
  // Points closer than this to x = 0 are on the mirror seam of a symmetric cage.
10
+ import { average, clampInt } from './modelMath';
11
+
10
12
  export const SEAM = 1e-4;
11
13
 
12
14
  // A hard crease stays sharp for this many subdivision steps, more than a part
@@ -466,16 +468,6 @@ function eachEdge(face, visit) {
466
468
  face.forEach((a, i) => visit(a, face[(i + 1) % face.length]));
467
469
  }
468
470
 
469
- function average(points) {
470
- const sum = [0, 0, 0];
471
- for (const point of points) {
472
- sum[0] += point[0];
473
- sum[1] += point[1];
474
- sum[2] += point[2];
475
- }
476
- return sum.map((value) => value / Math.max(1, points.length));
477
- }
478
-
479
471
  function normalize(v) {
480
472
  const length = Math.hypot(v[0], v[1], v[2]);
481
473
  return length > 0 ? v.map((value) => value / length) : [0, 0, 0];
@@ -507,10 +499,3 @@ function scaleVector(value) {
507
499
  }
508
500
  return vector3(value, [1, 1, 1]);
509
501
  }
510
-
511
- function clampInt(value, min, max, fallback) {
512
- if (!Number.isFinite(value)) {
513
- return fallback;
514
- }
515
- return Math.max(min, Math.min(max, Math.round(value)));
516
- }
@@ -0,0 +1,12 @@
1
+ // Canonical data behaviours and their generated play mirrors register their
2
+ // exact classes here. The mirror generator preserves module-level calls and
3
+ // relocates their imports to this same module, without importing inspectors.
4
+ const dataBehaviors = new WeakSet();
5
+
6
+ export function registerDataBehavior(Behavior) {
7
+ dataBehaviors.add(Behavior);
8
+ }
9
+
10
+ export function isDataBehavior(name, Behavior) {
11
+ return dataBehaviors.has(Behavior) && Behavior.behaviorName === name;
12
+ }
@@ -1,7 +1,7 @@
1
1
  // The player's clock: which animation frames run a frame, and the dt each one
2
2
  // that runs is handed. Without a cap (`runtime.maxFps` 0) every animation
3
3
  // frame runs and is handed the time since the last one, at most 0.033 s, as
4
- // the loop always did. With `"engine": { "maxFps": n }` (the kit's CLAUDE.md
4
+ // the loop always did. With `"engine": { "maxFps": n }` (docs/engine-frame-cap.md
5
5
  // has the terms) a frame runs only once at least RUN_SHARE of 1/n seconds has
6
6
  // passed since the last frame that ran -- by time, never by counting frames --
7
7
  // and is handed all the time since that frame, so nothing skipped is lost:
@@ -9,6 +9,8 @@
9
9
  // and let go, or a drag begun and ended, between two frames that run is lent
10
10
  // to the next one, `updateLending`).
11
11
 
12
+ import { prepareModelConsumers } from './modelready.js';
13
+
12
14
  // The longest step a frame is handed without a cap, in seconds.
13
15
  export const MAX_DT = 0.033;
14
16
 
@@ -84,6 +86,7 @@ export function updateLending(runtime, latch, dt) {
84
86
  move.y = stick.y;
85
87
  }
86
88
  try {
89
+ prepareModelConsumers(runtime.three, runtime);
87
90
  runtime.update(dt);
88
91
  } finally {
89
92
  for (const code of lent) keys.delete(code);
@@ -0,0 +1,140 @@
1
+ import * as RAPIER from './rapier.js';
2
+ import { assertFrozenEqual, frozenState } from './frozenstatics.js';
3
+
4
+ export class FrozenPhysics {
5
+ constructor(system, scene) {
6
+ this.system = system;
7
+ this.scene = scene;
8
+ this.owner = scene.frozenActors;
9
+ this.pending = this.owner.consumer(undefined, () => {
10
+ this.dispose();
11
+ if (system.frozenPhysics === this) system.frozenPhysics = null;
12
+ }, true);
13
+ // Only unsafe or exposed actors need unconditional per-frame visits.
14
+ // Observed writes arrive through pending; awake dynamics come from Rapier.
15
+ this.moving = new Map();
16
+ this.settling = new Map();
17
+ this.sampled = new Map();
18
+ // Rapier's active island list does not include a newly created/woken body
19
+ // until the next step. Keep it pending until its first pre-step snapshot.
20
+ this.newDynamics = new Map();
21
+ this.exposed = new Set();
22
+ }
23
+
24
+ forgetMotion(id, entry) {
25
+ for (const cache of [this.settling, this.sampled, this.newDynamics]) {
26
+ if (entry === undefined || cache.get(id) === entry) cache.delete(id);
27
+ }
28
+ }
29
+
30
+ forgetBody(id) {
31
+ this.forgetMotion(id);
32
+ this.moving.delete(id);
33
+ this.exposed.delete(id);
34
+ }
35
+
36
+ active() {
37
+ const entries = new Map();
38
+ this.system.world.forEachActiveRigidBody(body => {
39
+ if (body.bodyType() !== RAPIER.RigidBodyType.Dynamic || body.isSleeping()) return;
40
+ const entry = this.system.bodies.get(body.userData);
41
+ if (entry?.body.handle === body.handle) entries.set(body.userData, entry);
42
+ });
43
+ return entries;
44
+ }
45
+
46
+ // Rapier supplies awake dynamics. The last moving pose is sampled once
47
+ // more after sleep, so interpolation settles exactly as in the full loop.
48
+ stepEntries() {
49
+ const entries = new Map([...this.settling, ...this.newDynamics, ...this.active()]);
50
+ this.newDynamics.clear();
51
+ for (const [id, entry] of entries) {
52
+ if (this.system.bodies.get(id) !== entry || entry.body.bodyType() !== RAPIER.RigidBodyType.Dynamic) {
53
+ this.forgetMotion(id, entry);
54
+ entries.delete(id);
55
+ continue;
56
+ }
57
+ this.sampled.set(id, entry);
58
+ }
59
+ return entries.values();
60
+ }
61
+
62
+ simulate(dt) {
63
+ const { system, scene } = this;
64
+ this.sampled.clear();
65
+ const actors = new Set(this.pending.take(false));
66
+ for (const actor of this.moving.values()) actors.add(actor);
67
+ for (const id of this.active().keys()) {
68
+ const actor = scene.getActor(id);
69
+ if (actor) actors.add(actor);
70
+ }
71
+ const live = [];
72
+ const ordered = [...actors].sort((a, b) => (a.components.Layout?.z ?? 0) - (b.components.Layout?.z ?? 0) ||
73
+ (this.owner.records.get(a)?.order ?? -1) - (this.owner.records.get(b)?.order ?? -1));
74
+ for (const actor of ordered) {
75
+ if (scene.getActor(actor.id) !== actor || scene.isActorSleeping(actor) || !actor.components.Transform) {
76
+ if (scene.getActor(actor.id) && scene.getActor(actor.id) !== actor) continue;
77
+ system.removeBody(actor.id);
78
+ this.moving.delete(actor.id);
79
+ this.settling.delete(actor.id);
80
+ continue;
81
+ }
82
+ const previous = system.bodies.get(actor.id);
83
+ const entry = system.bodyFor(actor);
84
+ const type = entry.body.bodyType();
85
+ if (type === RAPIER.RigidBodyType.Dynamic && (entry !== previous || !entry.body.isSleeping())) this.newDynamics.set(actor.id, entry);
86
+ if (type !== RAPIER.RigidBodyType.Dynamic) this.forgetMotion(actor.id);
87
+ const unsafe = this.owner.records.get(actor)?.componentsUnsafe || this.exposed.has(actor.id);
88
+ if (unsafe) this.moving.set(actor.id, actor);
89
+ else this.moving.delete(actor.id);
90
+ live.push(actor);
91
+ if (system.frozenPhysicsVisits) system.frozenPhysicsVisits(actor);
92
+ }
93
+ system.pushUnchanged(live);
94
+ system.step(dt);
95
+ const dynamic = new Map([...this.settling, ...this.sampled, ...this.active()]);
96
+ for (const actor of live) {
97
+ const entry = system.bodies.get(actor.id);
98
+ if (entry?.body.bodyType() === RAPIER.RigidBodyType.Dynamic) dynamic.set(actor.id, entry);
99
+ }
100
+ const write = [];
101
+ for (const [id, entry] of dynamic) {
102
+ const actor = scene.getActor(id);
103
+ if (!actor || system.bodies.get(id) !== entry) continue;
104
+ write.push(actor);
105
+ const prev = entry.prev;
106
+ const p = entry.body.translation(), q = entry.body.rotation();
107
+ if (prev && (prev.x !== p.x || prev.y !== p.y || prev.z !== p.z || prev.qx !== q.x || prev.qy !== q.y || prev.qz !== q.z || prev.qw !== q.w)) this.settling.set(id, entry);
108
+ else this.settling.delete(id);
109
+ }
110
+ write.sort((a, b) => (a.components.Layout?.z ?? 0) - (b.components.Layout?.z ?? 0) || this.owner.records.get(a).order - this.owner.records.get(b).order);
111
+ this.owner.writingPhysics++;
112
+ try { system.writeBack({ getActors: () => write }); }
113
+ finally { this.owner.writingPhysics--; }
114
+ if (scene.three?.auditFrozenStatics === true) this.audit();
115
+ system.dispatchCallbacks(scene);
116
+ }
117
+
118
+ audit() {
119
+ const { system, scene } = this;
120
+ const before = bodyState(system);
121
+ const all = scene.getActors();
122
+ system.reconcileUnchanged(all);
123
+ system.pushUnchanged(all);
124
+ assertFrozenEqual(before, bodyState(system), 'body signatures/poses');
125
+ }
126
+
127
+ dispose() {
128
+ this.pending.dispose();
129
+ this.moving.clear();
130
+ this.settling.clear();
131
+ this.sampled.clear();
132
+ this.newDynamics.clear();
133
+ this.exposed.clear();
134
+ }
135
+ }
136
+
137
+ function bodyState(system) {
138
+ return frozenState([...system.bodies].map(([id, entry]) =>
139
+ [id, entry.sig, entry.body.bodyType(), entry.body.translation(), entry.body.rotation()]));
140
+ }