castle-web-cli 0.4.233 → 0.4.235

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (383) hide show
  1. package/dist/api.d.ts +11 -0
  2. package/dist/api.js +43 -0
  3. package/dist/bundle.d.ts +64 -0
  4. package/dist/bundle.js +558 -2
  5. package/dist/castle-host/host.d.ts +17 -2
  6. package/dist/castle-host/host.js +793 -36
  7. package/dist/castleJson.d.ts +20 -1
  8. package/dist/castleJson.js +44 -2
  9. package/dist/check.js +9 -2
  10. package/dist/chunkLoader.d.ts +3 -0
  11. package/dist/chunkLoader.js +111 -0
  12. package/dist/devParty.d.ts +26 -0
  13. package/dist/devParty.js +231 -0
  14. package/dist/devSaveStorage.js +4 -0
  15. package/dist/devSessionStorage.js +3 -1
  16. package/dist/devSocial.d.ts +24 -0
  17. package/dist/devSocial.js +70 -0
  18. package/dist/ide.d.ts +2 -0
  19. package/dist/ide.js +119 -15
  20. package/dist/index.js +8 -2
  21. package/dist/init.js +1 -1
  22. package/dist/save-deck.d.ts +20 -1
  23. package/dist/save-deck.js +141 -5
  24. package/dist/serve.js +29 -11
  25. package/dist/shell/assets/{index-BjOxR-lW.js → index-DulbYIJm.js} +97 -97
  26. package/dist/shell/index.html +1 -1
  27. package/dist/vitePlugins.d.ts +2 -1
  28. package/dist/vitePlugins.js +13 -0
  29. package/kits/base/castle.json +1 -1
  30. package/kits/base/sdk/README.md +266 -3
  31. package/kits/base/sdk/castle.d.ts +7 -3
  32. package/kits/base/sdk/castle.js +2 -0
  33. package/kits/base/sdk/commands.d.ts +162 -1
  34. package/kits/base/sdk/commands.js +3 -0
  35. package/kits/base/sdk/display.d.ts +3 -0
  36. package/kits/base/sdk/display.js +9 -3
  37. package/kits/base/sdk/hub.d.ts +33 -6
  38. package/kits/base/sdk/hub.js +68 -5
  39. package/kits/base/sdk/hubRejoin.d.ts +4 -0
  40. package/kits/base/sdk/hubRejoin.js +15 -0
  41. package/kits/base/sdk/multiplayer.d.ts +7 -1
  42. package/kits/base/sdk/multiplayer.js +147 -40
  43. package/kits/base/sdk/multiplayerProtocol.d.ts +2 -0
  44. package/kits/base/sdk/party.d.ts +23 -0
  45. package/kits/base/sdk/party.js +91 -0
  46. package/kits/base/sdk/reconnectBudget.d.ts +23 -0
  47. package/kits/base/sdk/reconnectBudget.js +96 -0
  48. package/kits/base/sdk/save.d.ts +38 -1
  49. package/kits/base/sdk/save.js +79 -6
  50. package/kits/base/sdk/server/hub.d.ts +31 -1
  51. package/kits/base/sdk/server/hub.js +50 -3
  52. package/kits/base/sdk/server/platformHandle.d.ts +13 -1
  53. package/kits/base/sdk/server/storage.d.ts +4 -0
  54. package/kits/base/sdk/server/storage.js +19 -3
  55. package/kits/base/sdk/server/wrapper.d.ts +7 -1
  56. package/kits/base/sdk/server/wrapper.js +10 -1
  57. package/kits/base/sdk/social.d.ts +9 -0
  58. package/kits/base/sdk/social.js +5 -0
  59. package/kits/hub-game/CLAUDE.md +123 -3
  60. package/kits/hub-game/README.md +63 -0
  61. package/kits/hub-game/castle.json +5 -5
  62. package/kits/hub-game/code/client/act.js +312 -0
  63. package/kits/hub-game/code/client/actionLayout.js +147 -0
  64. package/kits/hub-game/code/client/actionOverflow.js +556 -0
  65. package/kits/hub-game/code/client/arrivalCamera.js +50 -0
  66. package/kits/hub-game/code/client/askSlot.js +117 -0
  67. package/kits/hub-game/code/client/avatar.js +4 -2
  68. package/kits/hub-game/code/client/avatarShare.js +2 -0
  69. package/kits/hub-game/code/client/backVisibility.js +13 -0
  70. package/kits/hub-game/code/client/ballot.js +15 -10
  71. package/kits/hub-game/code/client/build.js +16 -0
  72. package/kits/hub-game/code/client/chat.js +41 -5
  73. package/kits/hub-game/code/client/chatModeration.js +5 -0
  74. package/kits/hub-game/code/client/chrome.js +1148 -258
  75. package/kits/hub-game/code/client/crowdNames.js +241 -0
  76. package/kits/hub-game/code/client/decor.js +10 -4
  77. package/kits/hub-game/code/client/defaultEnvironment.js +194 -0
  78. package/kits/hub-game/code/client/doorErrors.js +39 -0
  79. package/kits/hub-game/code/client/fall.js +18 -0
  80. package/kits/hub-game/code/client/farAvatars.js +233 -0
  81. package/kits/hub-game/code/client/firstJoin.js +9 -2
  82. package/kits/hub-game/code/client/fpsTelemetry.js +50 -0
  83. package/kits/hub-game/code/client/frameBatch.js +5 -0
  84. package/kits/hub-game/code/client/grab.js +31 -11
  85. package/kits/hub-game/code/client/hookLayer.js +87 -8
  86. package/kits/hub-game/code/client/hudCopy.js +51 -0
  87. package/kits/hub-game/code/client/hudRate.js +20 -0
  88. package/kits/hub-game/code/client/idle.js +14 -2
  89. package/kits/hub-game/code/client/invites.js +231 -0
  90. package/kits/hub-game/code/client/joinError.js +9 -0
  91. package/kits/hub-game/code/client/labelsNear.js +31 -2
  92. package/kits/hub-game/code/client/landscapeLayout.js +17 -0
  93. package/kits/hub-game/code/client/layoutCache.js +264 -0
  94. package/kits/hub-game/code/client/loadTelemetry.js +20 -0
  95. package/kits/hub-game/code/client/loadingCover.js +148 -0
  96. package/kits/hub-game/code/client/loadingEntry.js +8 -0
  97. package/kits/hub-game/code/client/menuRows.js +43 -0
  98. package/kits/hub-game/code/client/modelReady.js +7 -0
  99. package/kits/hub-game/code/client/padCueArrival.js +23 -0
  100. package/kits/hub-game/code/client/padCues.js +112 -0
  101. package/kits/hub-game/code/client/padOccupancy.js +88 -0
  102. package/kits/hub-game/code/client/padReadability.js +26 -0
  103. package/kits/hub-game/code/client/padRings.js +69 -0
  104. package/kits/hub-game/code/client/pushVisit.js +14 -0
  105. package/kits/hub-game/code/client/quality.js +205 -0
  106. package/kits/hub-game/code/client/qualityEntry.js +55 -0
  107. package/kits/hub-game/code/client/safeLayout.js +338 -0
  108. package/kits/hub-game/code/client/safeStyle.js +42 -0
  109. package/kits/hub-game/code/client/say.js +12 -3
  110. package/kits/hub-game/code/client/shot.js +64 -10
  111. package/kits/hub-game/code/client/shotFit.js +56 -0
  112. package/kits/hub-game/code/client/signIn.js +28 -0
  113. package/kits/hub-game/code/client/state.js +53 -0
  114. package/kits/hub-game/code/client/talk.js +209 -45
  115. package/kits/hub-game/code/client/tiers.js +68 -66
  116. package/kits/hub-game/code/client/together.js +7 -2
  117. package/kits/hub-game/code/client/weakestLookBake.js +92 -0
  118. package/kits/hub-game/code/client/weakestTier.js +295 -0
  119. package/kits/hub-game/code/client/worldLabels.js +241 -0
  120. package/kits/hub-game/code/client/yours.js +10 -9
  121. package/kits/hub-game/code/npcDisplayText.js +55 -0
  122. package/kits/hub-game/code/server/act.js +124 -0
  123. package/kits/hub-game/code/server/actions.js +6 -1
  124. package/kits/hub-game/code/server/actors.js +2 -1
  125. package/kits/hub-game/code/server/analytics.js +83 -0
  126. package/kits/hub-game/code/server/anonymousEntry.js +49 -0
  127. package/kits/hub-game/code/server/arrivalPose.js +36 -0
  128. package/kits/hub-game/code/server/companion.js +28 -3
  129. package/kits/hub-game/code/server/doorAnalytics.js +52 -0
  130. package/kits/hub-game/code/server/earned.js +22 -5
  131. package/kits/hub-game/code/server/frameBatch.js +183 -0
  132. package/kits/hub-game/code/server/friendsAmong.js +49 -9
  133. package/kits/hub-game/code/server/history.js +2 -0
  134. package/kits/hub-game/code/server/hub.js +1306 -95
  135. package/kits/hub-game/code/server/idle.js +30 -1
  136. package/kits/hub-game/code/server/index.js +26 -4
  137. package/kits/hub-game/code/server/invites.js +19 -0
  138. package/kits/hub-game/code/server/labels.js +9 -1
  139. package/kits/hub-game/code/server/loadAbandon.js +106 -0
  140. package/kits/hub-game/code/server/manifest.js +211 -3
  141. package/kits/hub-game/code/server/menu.js +31 -3
  142. package/kits/hub-game/code/server/npcs.js +226 -64
  143. package/kits/hub-game/code/server/observe.js +408 -0
  144. package/kits/hub-game/code/server/padOccupancy.js +85 -0
  145. package/kits/hub-game/code/server/players.js +9 -1
  146. package/kits/hub-game/code/server/resumePose.js +152 -0
  147. package/kits/hub-game/code/server/say.js +1 -1
  148. package/kits/hub-game/code/server/standing.js +4 -5
  149. package/kits/hub-game/code/server/storageLimit.js +187 -0
  150. package/kits/hub-game/code/server/vis.js +67 -5
  151. package/kits/hub-game/code/shared/act.js +35 -0
  152. package/kits/hub-game/code/shared/danceIdle.js +28 -0
  153. package/kits/hub-game/code/shared/loadStages.js +12 -0
  154. package/kits/hub-game/code/shared/quality.js +74 -0
  155. package/kits/hub-game/code/shared/say.js +2 -0
  156. package/kits/hub-game/code/shared/shot.js +35 -1
  157. package/kits/hub-game/code/systems/hub.js +970 -169
  158. package/kits/hub-game/docs/analytics.md +279 -0
  159. package/kits/hub-game/docs/contract.md +1259 -42
  160. package/kits/hub-game/docs/home-pieces.md +9 -2
  161. package/kits/hub-game/docs/observed-progress.md +252 -0
  162. package/kits/hub-game/main.jsx +2 -0
  163. package/kits/hub-game/package-lock.json +10 -3
  164. package/kits/hub-game/package.json +6 -3
  165. package/kits/hub-game/play/player.js +142 -0
  166. package/kits/hub-game/play/registry.js +47 -0
  167. package/kits/hub-game/play.jsx +37 -0
  168. package/kits/hub-game/scripts/check.mjs +39 -5
  169. package/kits/hub-game/scripts/companion-follower-wire.json +1 -1
  170. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +11 -0
  171. package/kits/hub-game/scripts/fixtures/decor-keyless.json +5 -5
  172. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +3 -0
  173. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +19 -3
  174. package/kits/hub-game/scripts/fixtures/interest-legacy.json +3 -3
  175. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -1
  176. package/kits/hub-game/scripts/pose-storage-fixture.mjs +46 -0
  177. package/kits/hub-game/scripts/test-act-client.mjs +186 -0
  178. package/kits/hub-game/scripts/test-act.mjs +171 -0
  179. package/kits/hub-game/scripts/test-action-layout.mjs +80 -0
  180. package/kits/hub-game/scripts/test-action-observers.mjs +46 -0
  181. package/kits/hub-game/scripts/test-actions-client.mjs +367 -2
  182. package/kits/hub-game/scripts/test-actors.mjs +20 -7
  183. package/kits/hub-game/scripts/test-analytics.mjs +76 -0
  184. package/kits/hub-game/scripts/test-anonymous-entry.mjs +28 -0
  185. package/kits/hub-game/scripts/test-arrival-pose-server.mjs +196 -0
  186. package/kits/hub-game/scripts/test-arrival-pose.mjs +24 -0
  187. package/kits/hub-game/scripts/test-ask-slot.mjs +85 -0
  188. package/kits/hub-game/scripts/test-avatar-wire.mjs +49 -10
  189. package/kits/hub-game/scripts/test-avatar.mjs +44 -0
  190. package/kits/hub-game/scripts/test-back-visibility.mjs +82 -0
  191. package/kits/hub-game/scripts/test-ballot.mjs +11 -4
  192. package/kits/hub-game/scripts/test-ban-join.mjs +121 -13
  193. package/kits/hub-game/scripts/test-build.mjs +20 -2
  194. package/kits/hub-game/scripts/test-chat.mjs +206 -5
  195. package/kits/hub-game/scripts/test-companion-chat.mjs +20 -2
  196. package/kits/hub-game/scripts/test-control-layout-dom.mjs +120 -0
  197. package/kits/hub-game/scripts/test-crowd-names.mjs +205 -0
  198. package/kits/hub-game/scripts/test-decor-client.mjs +45 -4
  199. package/kits/hub-game/scripts/test-decor.mjs +7 -0
  200. package/kits/hub-game/scripts/test-default-environment-root.mjs +95 -0
  201. package/kits/hub-game/scripts/test-default-environment.mjs +267 -0
  202. package/kits/hub-game/scripts/test-door-analytics.mjs +58 -0
  203. package/kits/hub-game/scripts/test-door-jump.mjs +100 -0
  204. package/kits/hub-game/scripts/test-earned.mjs +33 -3
  205. package/kits/hub-game/scripts/test-far-avatars.mjs +340 -0
  206. package/kits/hub-game/scripts/test-fps-telemetry.mjs +112 -0
  207. package/kits/hub-game/scripts/test-frame-batch.mjs +252 -0
  208. package/kits/hub-game/scripts/test-fresh-friends.mjs +118 -0
  209. package/kits/hub-game/scripts/test-grab-orbit.mjs +47 -4
  210. package/kits/hub-game/scripts/test-high-only.mjs +170 -0
  211. package/kits/hub-game/scripts/test-hub-ops.mjs +321 -2
  212. package/kits/hub-game/scripts/test-hub-trip.mjs +879 -11
  213. package/kits/hub-game/scripts/test-hud-clear.mjs +162 -59
  214. package/kits/hub-game/scripts/test-hud-defects-dom.mjs +100 -0
  215. package/kits/hub-game/scripts/test-hud-rate.mjs +224 -0
  216. package/kits/hub-game/scripts/test-hud-safe-visibility-dom.mjs +83 -0
  217. package/kits/hub-game/scripts/test-idle.mjs +66 -0
  218. package/kits/hub-game/scripts/test-interest-cells.mjs +20 -0
  219. package/kits/hub-game/scripts/test-interest.mjs +15 -0
  220. package/kits/hub-game/scripts/test-invites-client.mjs +430 -0
  221. package/kits/hub-game/scripts/test-invites.mjs +109 -0
  222. package/kits/hub-game/scripts/test-labels.mjs +71 -3
  223. package/kits/hub-game/scripts/test-landscape-layout.mjs +194 -0
  224. package/kits/hub-game/scripts/test-list-scroll-dom.mjs +49 -0
  225. package/kits/hub-game/scripts/test-load-abandon.mjs +246 -0
  226. package/kits/hub-game/scripts/test-loading-cover.mjs +162 -0
  227. package/kits/hub-game/scripts/test-manifest.mjs +265 -0
  228. package/kits/hub-game/scripts/test-menu-client.mjs +105 -0
  229. package/kits/hub-game/scripts/test-menu.mjs +23 -0
  230. package/kits/hub-game/scripts/test-npcs.mjs +917 -10
  231. package/kits/hub-game/scripts/test-observed.mjs +745 -0
  232. package/kits/hub-game/scripts/test-pad-cues.mjs +304 -0
  233. package/kits/hub-game/scripts/test-pad-occupancy.mjs +177 -0
  234. package/kits/hub-game/scripts/test-picker.mjs +234 -7
  235. package/kits/hub-game/scripts/test-placement-cache.mjs +690 -0
  236. package/kits/hub-game/scripts/test-progress-reset.mjs +559 -0
  237. package/kits/hub-game/scripts/test-push-visit.mjs +26 -0
  238. package/kits/hub-game/scripts/test-quality.mjs +385 -0
  239. package/kits/hub-game/scripts/test-rehello.mjs +699 -5
  240. package/kits/hub-game/scripts/test-resume-action-order.mjs +598 -0
  241. package/kits/hub-game/scripts/test-resume-held.mjs +239 -0
  242. package/kits/hub-game/scripts/test-resume-pose.mjs +142 -0
  243. package/kits/hub-game/scripts/test-safe-events-dom.mjs +116 -0
  244. package/kits/hub-game/scripts/test-safe-layout.mjs +330 -0
  245. package/kits/hub-game/scripts/test-say.mjs +1 -1
  246. package/kits/hub-game/scripts/test-shot.mjs +145 -0
  247. package/kits/hub-game/scripts/test-signin-client.mjs +45 -0
  248. package/kits/hub-game/scripts/test-soundscape.mjs +22 -17
  249. package/kits/hub-game/scripts/test-standing.mjs +35 -2
  250. package/kits/hub-game/scripts/test-storage-limit.mjs +333 -0
  251. package/kits/hub-game/scripts/test-stuck.mjs +5 -4
  252. package/kits/hub-game/scripts/test-talk-overlay-dom.mjs +130 -0
  253. package/kits/hub-game/scripts/test-tiers-render.mjs +86 -13
  254. package/kits/hub-game/scripts/test-tiers.mjs +7 -8
  255. package/kits/hub-game/scripts/test-vis.mjs +433 -6
  256. package/kits/hub-game/scripts/test-weakest-tier.mjs +924 -0
  257. package/kits/hub-game/scripts/test-world-labels.mjs +367 -0
  258. package/kits/hub-game/scripts/test-yours-chrome.mjs +50 -6
  259. package/kits/hub-game/scripts/test-yours.mjs +39 -8
  260. package/kits/multiplayer-3d/castle.json +5 -5
  261. package/kits/multiplayer-3d/code/client/joinFailure.js +27 -0
  262. package/kits/multiplayer-3d/code/client/resumeGate.js +139 -0
  263. package/kits/multiplayer-3d/code/systems/multiplayer.js +369 -30
  264. package/kits/multiplayer-3d/package-lock.json +8 -1
  265. package/kits/multiplayer-3d/package.json +2 -1
  266. package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +436 -0
  267. package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +624 -0
  268. package/kits/physics-2d/CLAUDE.md +10 -1
  269. package/kits/physics-2d/castle.json +2 -2
  270. package/kits/physics-2d/engine/frozenActors.js +233 -0
  271. package/kits/physics-2d/engine/scene.js +87 -5
  272. package/kits/physics-2d/eslint.config.js +1 -1
  273. package/kits/physics-2d/play/behaviors/AnalogStick.js +198 -0
  274. package/kits/physics-2d/play/behaviors/Camera.js +40 -0
  275. package/kits/physics-2d/play/behaviors/Collider.js +122 -0
  276. package/kits/physics-2d/play/behaviors/Draggable.js +115 -0
  277. package/kits/physics-2d/play/behaviors/Goal.js +46 -0
  278. package/kits/physics-2d/play/behaviors/Joints.js +126 -0
  279. package/kits/physics-2d/play/behaviors/Layout.js +71 -0
  280. package/kits/physics-2d/play/behaviors/RigidBody.js +57 -0
  281. package/kits/physics-2d/play/behaviors/Slingshot.js +142 -0
  282. package/kits/physics-2d/play/behaviors/SoundPlayer.js +263 -0
  283. package/kits/physics-2d/play/behaviors/Sprite.js +406 -0
  284. package/kits/physics-2d/play/behaviors/Style.js +209 -0
  285. package/kits/physics-2d/play/behaviors/Text.js +85 -0
  286. package/kits/physics-2d/play/behaviors/Video.js +93 -0
  287. package/kits/physics-3d/CLAUDE.md +25 -1651
  288. package/kits/physics-3d/behaviors/Body.jsx +3 -0
  289. package/kits/physics-3d/behaviors/Model.jsx +3 -0
  290. package/kits/physics-3d/behaviors/Player.jsx +35 -18
  291. package/kits/physics-3d/behaviors/Shape.jsx +3 -0
  292. package/kits/physics-3d/behaviors/Solid.jsx +3 -0
  293. package/kits/physics-3d/behaviors/Transform.jsx +3 -0
  294. package/kits/physics-3d/castle.json +3 -3
  295. package/kits/physics-3d/docs/engine-camera.md +542 -0
  296. package/kits/physics-3d/docs/engine-frame-cap.md +136 -0
  297. package/kits/physics-3d/docs/engine-load.md +149 -0
  298. package/kits/physics-3d/docs/engine-look.md +114 -0
  299. package/kits/physics-3d/docs/engine-shadows.md +372 -0
  300. package/kits/physics-3d/docs/engine-skip-work.md +187 -0
  301. package/kits/physics-3d/docs/engine-sky.md +198 -0
  302. package/kits/physics-3d/docs/engine-static-actors.md +226 -0
  303. package/kits/physics-3d/docs/engine-view.md +37 -0
  304. package/kits/physics-3d/docs/pxmodel-format.md +1 -1
  305. package/kits/physics-3d/engine3d/PlayOnly3D.jsx +5 -1
  306. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +19 -333
  307. package/kits/physics-3d/engine3d/actornode.js +1 -0
  308. package/kits/physics-3d/engine3d/branches.js +3 -13
  309. package/kits/physics-3d/engine3d/cage.js +2 -7
  310. package/kits/physics-3d/engine3d/cageops.js +2 -17
  311. package/kits/physics-3d/engine3d/dataBehaviors.js +12 -0
  312. package/kits/physics-3d/engine3d/framecap.js +4 -1
  313. package/kits/physics-3d/engine3d/frozenphysics.js +140 -0
  314. package/kits/physics-3d/engine3d/frozenstatics.js +273 -0
  315. package/kits/physics-3d/engine3d/gait.js +8 -0
  316. package/kits/physics-3d/engine3d/initialModelFiles.js +18 -0
  317. package/kits/physics-3d/engine3d/look.js +7 -0
  318. package/kits/physics-3d/engine3d/modelFiles.js +3 -17
  319. package/kits/physics-3d/engine3d/modelMath.js +49 -0
  320. package/kits/physics-3d/engine3d/modelready.js +16 -0
  321. package/kits/physics-3d/engine3d/motion.js +3 -3
  322. package/kits/physics-3d/engine3d/nearshadows.js +77 -10
  323. package/kits/physics-3d/engine3d/orbitinput.js +59 -25
  324. package/kits/physics-3d/engine3d/partgeometry.js +1 -16
  325. package/kits/physics-3d/engine3d/paths.js +1 -9
  326. package/kits/physics-3d/engine3d/playTimings.js +50 -0
  327. package/kits/physics-3d/engine3d/playerRun.js +372 -0
  328. package/kits/physics-3d/engine3d/pxmodel.js +3 -3
  329. package/kits/physics-3d/engine3d/rapier.js +27 -0
  330. package/kits/physics-3d/engine3d/scatter.js +1 -11
  331. package/kits/physics-3d/engine3d/shadowfade.js +23 -15
  332. package/kits/physics-3d/engine3d/sky.js +1 -1
  333. package/kits/physics-3d/engine3d/squarefirst.js +177 -0
  334. package/kits/physics-3d/engine3d/stillshadows.js +399 -0
  335. package/kits/physics-3d/engine3d/sweep.js +1 -25
  336. package/kits/physics-3d/engine3d/world3d.js +468 -18
  337. package/kits/physics-3d/eslint.config.js +2 -1
  338. package/kits/physics-3d/main.jsx +6 -3
  339. package/kits/physics-3d/package-lock.json +7 -0
  340. package/kits/physics-3d/package.json +5 -1
  341. package/kits/physics-3d/play/behaviors/Body.js +31 -0
  342. package/kits/physics-3d/play/behaviors/Door.js +37 -0
  343. package/kits/physics-3d/play/behaviors/Lookable.js +16 -0
  344. package/kits/physics-3d/play/behaviors/Model.js +23 -0
  345. package/kits/physics-3d/play/behaviors/Pickup.js +46 -0
  346. package/kits/physics-3d/play/behaviors/Player.js +1204 -0
  347. package/kits/physics-3d/play/behaviors/Shape.js +47 -0
  348. package/kits/physics-3d/play/behaviors/Solid.js +16 -0
  349. package/kits/physics-3d/play/behaviors/Transform.js +29 -0
  350. package/kits/physics-3d/pnpm-lock.yaml +8 -0
  351. package/kits/physics-3d/scripts/bench-shadow-fade.mjs +37 -0
  352. package/kits/physics-3d/scripts/build-rapier-gz.mjs +56 -0
  353. package/kits/physics-3d/scripts/frozen-statics-fixture.mjs +141 -0
  354. package/kits/physics-3d/scripts/test-camera-follow.mjs +5 -1
  355. package/kits/physics-3d/scripts/test-camera-orbit.mjs +52 -4
  356. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +1 -1
  357. package/kits/physics-3d/scripts/test-empty-gait-hints.mjs +89 -0
  358. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +6 -3
  359. package/kits/physics-3d/scripts/test-frame-cap.mjs +1 -1
  360. package/kits/physics-3d/scripts/test-frozen-nested.mjs +49 -0
  361. package/kits/physics-3d/scripts/test-frozen-statics-legacy-physics2d.mjs +123 -0
  362. package/kits/physics-3d/scripts/test-frozen-statics.mjs +434 -0
  363. package/kits/physics-3d/scripts/test-look-bake.mjs +1 -1
  364. package/kits/physics-3d/scripts/test-near-shadows.mjs +2 -2
  365. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +88 -7
  366. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +40 -3
  367. package/kits/physics-3d/scripts/test-orbit-shot.mjs +75 -1
  368. package/kits/physics-3d/scripts/test-rapier-gz.mjs +106 -0
  369. package/kits/physics-3d/scripts/test-sky.mjs +1 -1
  370. package/kits/physics-3d/scripts/test-square-first.mjs +921 -0
  371. package/kits/physics-3d/scripts/test-static-actors.mjs +3 -1
  372. package/kits/physics-3d/scripts/test-static-physics.mjs +4 -1
  373. package/kits/physics-3d/scripts/test-static-scenery.mjs +5 -2
  374. package/kits/physics-3d/scripts/test-steady-hover.mjs +5 -2
  375. package/kits/physics-3d/scripts/test-still-shadows.mjs +477 -0
  376. package/kits/physics-3d/systems/physics3d.js +37 -4
  377. package/kits/real-time/castle.json +2 -2
  378. package/kits/real-time/code/client/connection.js +33 -10
  379. package/kits/real-time/code/client/gameHooks.js +2 -0
  380. package/kits/real-time/code/client/joinOverlay.js +9 -4
  381. package/kits/real-time/code/server/session.js +6 -4
  382. package/kits/real-time/package-lock.json +1 -1
  383. package/package.json +2 -2
@@ -1,5 +1,5 @@
1
1
  // Pointer, wheel and right-button input for a scene that set `"engine": {
2
- // "camera": { "follow": "rigid", "control": "orbit" } }` (the kit's CLAUDE.md
2
+ // "camera": { "follow": "rigid", "control": "orbit" } }` (docs/engine-camera.md
3
3
  // has the terms): the player turns, tilts and zooms the Player's camera.
4
4
  // Scene3DPlayer's `attachInput` makes this the first time a pointer goes down
5
5
  // under the key, Shift is pressed there, or a Player runs under it (`runtime.orbitInput()`), hands
@@ -300,6 +300,7 @@ export function attachOrbitInput(canvas, runtime, stick, onTap, tuning, onLost)
300
300
  },
301
301
  toggle() {
302
302
  if (runtime.cameraControl !== 'orbit') return;
303
+ control.useKeyboard();
303
304
  control.show();
304
305
  lock.shiftLock.toggle(control.available());
305
306
  },
@@ -351,12 +352,36 @@ export function attachOrbitInput(canvas, runtime, stick, onTap, tuning, onLost)
351
352
  return input;
352
353
  }
353
354
 
354
- // Made only by an orbit input, and its DOM only on a keyed desktop frame or toggle.
355
+ // Made only by an orbit input; its DOM appears after hardware keyboard input.
355
356
  // It lives beside the canvas so it never enters the canvas's pointer path.
356
357
  function makeShiftLockControl(canvas, runtime, lock, toggle) {
357
358
  const doc = canvas.ownerDocument;
358
359
  let media;
359
360
  let button = null;
361
+ let keyboardInput = false;
362
+ let observing = false;
363
+ const view = doc?.defaultView;
364
+ const onKeyDown = (event) => {
365
+ if (event.isComposing || event.altKey || event.ctrlKey || event.metaKey ||
366
+ event.target?.isContentEditable || event.target?.closest?.('input, textarea, select')) return;
367
+ if (/^(Key[WASDEF]|Arrow(Up|Down|Left|Right)|Space|Enter|Tab|ShiftLeft|ShiftRight)$/.test(event.code)) {
368
+ keyboardInput = true;
369
+ show();
370
+ }
371
+ };
372
+ const onPointerDown = (event) => {
373
+ if (event.pointerType !== 'touch' && event.pointerType !== 'pen') return;
374
+ keyboardInput = false;
375
+ lock.drop();
376
+ show();
377
+ };
378
+ const unobserve = () => {
379
+ keyboardInput = false;
380
+ if (!observing) return;
381
+ view?.removeEventListener('keydown', onKeyDown, true);
382
+ view?.removeEventListener('pointerdown', onPointerDown, true);
383
+ observing = false;
384
+ };
360
385
  const available = () => {
361
386
  if (typeof canvas.requestPointerLock !== 'function' || typeof doc?.exitPointerLock !== 'function') return false;
362
387
  media ??= doc.defaultView?.matchMedia?.('(hover: hover) and (pointer: fine)');
@@ -377,36 +402,45 @@ function makeShiftLockControl(canvas, runtime, lock, toggle) {
377
402
  canvas.focus();
378
403
  toggle();
379
404
  };
405
+ function show() {
406
+ if (!observing) {
407
+ view?.addEventListener('keydown', onKeyDown, true);
408
+ view?.addEventListener('pointerdown', onPointerDown, true);
409
+ observing = true;
410
+ }
411
+ const visible = runtime.cameraControl === 'orbit' && keyboardInput && available();
412
+ if (visible && button === null && canvas.parentElement) {
413
+ button = doc.createElement('button');
414
+ button.type = 'button';
415
+ button.title = 'Shift lock (Shift)';
416
+ button.setAttribute('aria-label', button.title);
417
+ button.innerHTML = '<svg width="22" height="22" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" aria-hidden="true"><rect x="5" y="10" width="14" height="11" rx="3"/><path d="M8 10V7a4 4 0 0 1 8 0v3"/><path d="M12 14v3"/></svg>';
418
+ Object.assign(button.style, {
419
+ position: 'absolute', right: '16px', bottom: '16px', width: '44px', height: '44px',
420
+ border: '1px solid rgba(230, 230, 226, 0.3)', borderRadius: '10px', padding: '0',
421
+ alignItems: 'center', justifyContent: 'center', cursor: 'pointer', zIndex: '1',
422
+ touchAction: 'none',
423
+ });
424
+ button.addEventListener('pointerdown', onDown);
425
+ button.addEventListener('click', onClick);
426
+ canvas.parentElement.appendChild(button);
427
+ update();
428
+ }
429
+ // Called every keyed frame: the style is written only when it changes.
430
+ const display = visible ? 'flex' : 'none';
431
+ if (button !== null && button.style.display !== display) button.style.display = display;
432
+ }
380
433
  return {
381
434
  available,
382
435
  update,
383
- show() {
384
- const visible = runtime.cameraControl === 'orbit' && available();
385
- if (visible && button === null && canvas.parentElement) {
386
- button = doc.createElement('button');
387
- button.type = 'button';
388
- button.title = 'Shift lock (Shift)';
389
- button.setAttribute('aria-label', button.title);
390
- button.innerHTML = '<svg width="22" height="22" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" aria-hidden="true"><rect x="5" y="10" width="14" height="11" rx="3"/><path d="M8 10V7a4 4 0 0 1 8 0v3"/><path d="M12 14v3"/></svg>';
391
- Object.assign(button.style, {
392
- position: 'absolute', right: '16px', bottom: '16px', width: '44px', height: '44px',
393
- border: '1px solid rgba(230, 230, 226, 0.3)', borderRadius: '10px', padding: '0',
394
- alignItems: 'center', justifyContent: 'center', cursor: 'pointer', zIndex: '1',
395
- touchAction: 'none',
396
- });
397
- button.addEventListener('pointerdown', onDown);
398
- button.addEventListener('click', onClick);
399
- canvas.parentElement.appendChild(button);
400
- update();
401
- }
402
- // Called every keyed frame: the style is written only when it changes.
403
- const display = visible ? 'flex' : 'none';
404
- if (button !== null && button.style.display !== display) button.style.display = display;
405
- },
436
+ useKeyboard() { keyboardInput = true; },
437
+ show,
406
438
  hide() {
439
+ unobserve();
407
440
  if (button !== null && button.style.display !== 'none') button.style.display = 'none';
408
441
  },
409
442
  detach() {
443
+ unobserve();
410
444
  if (button === null) return;
411
445
  button.removeEventListener('pointerdown', onDown);
412
446
  button.removeEventListener('click', onClick);
@@ -7,6 +7,7 @@
7
7
  // doc describes, or null when the part's fields cannot make one, in which case
8
8
  // the caller falls back to the plain shape.
9
9
 
10
+ import { points2, clampInt } from './modelMath';
10
11
  import { objCage } from './objtext';
11
12
  import * as THREE from 'three';
12
13
  import { RoundedBoxGeometry } from 'three/examples/jsm/geometries/RoundedBoxGeometry.js';
@@ -64,15 +65,6 @@ export function needsModelGeometry(part) {
64
65
  return part.kind === 'cylinder' || part.kind === 'sphere' || part.kind === 'capsule';
65
66
  }
66
67
 
67
- function points2(list) {
68
- if (!Array.isArray(list)) {
69
- return [];
70
- }
71
- return list
72
- .filter((p) => Array.isArray(p) && Number.isFinite(p[0]) && Number.isFinite(p[1]))
73
- .map((p) => new THREE.Vector2(p[0], p[1]));
74
- }
75
-
76
68
  //
77
69
  // Lathe
78
70
  //
@@ -334,13 +326,6 @@ function sphereGeometry(part) {
334
326
  return new THREE.SphereGeometry(part.radius, around, Math.max(3, Math.round(around * 0.67)));
335
327
  }
336
328
 
337
- function clampInt(value, min, max, fallback) {
338
- if (!Number.isFinite(value)) {
339
- return fallback;
340
- }
341
- return Math.max(min, Math.min(max, Math.round(value)));
342
- }
343
-
344
329
  // Sculpt strokes (sculpt.js) apply to the finished shape before the
345
330
  // deformers, in the same space as a cage's vertices.
346
331
  export function buildPartGeometry(part) {
@@ -7,6 +7,7 @@
7
7
  // Copies and helix coils sit in frames that follow the line and turn only as
8
8
  // much as it does, so they never flip.
9
9
 
10
+ import { points3 } from './modelMath';
10
11
  import * as THREE from 'three';
11
12
 
12
13
  const DEG = Math.PI / 180;
@@ -15,15 +16,6 @@ const MAX_HELIX_POINTS = 600;
15
16
  const X = new THREE.Vector3(1, 0, 0);
16
17
  const Z = new THREE.Vector3(0, 0, 1);
17
18
 
18
- function points3(list) {
19
- if (!Array.isArray(list)) {
20
- return [];
21
- }
22
- return list
23
- .filter((p) => Array.isArray(p) && p.slice(0, 3).every(Number.isFinite))
24
- .map((p) => new THREE.Vector3(p[0], p[1], p[2]));
25
- }
26
-
27
19
  function numberOr(value, fallback) {
28
20
  return Number.isFinite(value) ? value : fallback;
29
21
  }
@@ -0,0 +1,50 @@
1
+ // Optional load probe, shared by both entries. Decode promise timing includes
2
+ // loading/queueing as well as decoding; it is not a CPU-only decode measure.
3
+ export function makePlayTimings(enabled) {
4
+ if (enabled !== true) return undefined;
5
+ const state = { events: [], imageCount: 0, imageFailures: 0 };
6
+ globalThis.__hubLoadTimings = state;
7
+ const mark = (name) => state.events.push({ name, at: performance.now() });
8
+ mark('entry-ready');
9
+ mark.assets = (sprites) => {
10
+ const images = [
11
+ ...new Set(
12
+ Object.values(sprites)
13
+ .filter((art) => art.kind === 'image')
14
+ .map((art) => art.image)
15
+ ),
16
+ ];
17
+ state.imageCount = images.length;
18
+ mark('assets:decode-start');
19
+ Promise.allSettled(
20
+ images.map((image) =>
21
+ typeof image.decode === 'function'
22
+ ? image.decode()
23
+ : Promise.reject(new Error('decode unavailable'))
24
+ )
25
+ ).then((results) => {
26
+ state.imageFailures = results.filter((r) => r.status === 'rejected').length;
27
+ mark('assets:decoded');
28
+ });
29
+ };
30
+ const start = performance.now();
31
+ const timer = setInterval(() => {
32
+ const mp = globalThis.__hub?.scene?.multiplayer;
33
+ if (mp && !state.joinObserved) {
34
+ state.joinObserved = true;
35
+ mark('multiplayer:observed');
36
+ }
37
+ if (mp?.net?.status()?.state === 'connected' && !state.connected) {
38
+ state.connected = true;
39
+ mark('join:connected');
40
+ }
41
+ if (mp?.placed()) {
42
+ mark('placement:observed');
43
+ clearInterval(timer);
44
+ } else if (performance.now() - start > 90000) {
45
+ mark('placement:timeout');
46
+ clearInterval(timer);
47
+ }
48
+ }, 50);
49
+ return mark;
50
+ }
@@ -0,0 +1,372 @@
1
+ // Shared imperative player used by React and the opt-in runtime-only entry.
2
+ import { makeScene } from '@imports/castle.physics-2d/engine/scene';
3
+ import {
4
+ makeWorld3D,
5
+ resizeWorld,
6
+ syncActors,
7
+ renderWorld,
8
+ disposeWorld,
9
+ updatePhysicsDebug,
10
+ } from './world3d';
11
+ import { prepareEmptyNodes, loadEmptyScene } from './emptynodes';
12
+ import { attachOrbitInput } from './orbitinput';
13
+ import { renderHidingOwnModel } from './ownmodel';
14
+ import { makeFrameClock, makeInputLatch, nextFrame, updateLending } from './framecap';
15
+ import { prepareModelConsumers } from './modelready.js';
16
+
17
+ export function mountScene3D({
18
+ canvas,
19
+ sceneData,
20
+ sprites,
21
+ files,
22
+ behaviorClasses,
23
+ scenePath,
24
+ onFirstFrame,
25
+ onLoopError,
26
+ hudRefs,
27
+ onStage,
28
+ }) {
29
+ onStage?.('runtime:start');
30
+ const runtime = makeScene(sceneData, behaviorClasses, sprites, files, scenePath);
31
+ onStage?.('runtime:built');
32
+ const world = makeWorld3D(canvas);
33
+ if (onStage) world.onStage = onStage;
34
+ onStage?.('world:built');
35
+ runtime.three = world;
36
+ if (runtime.skipsEmptyNodes) prepareEmptyNodes(world, runtime);
37
+ // The first load precedes world creation; later loads initialize at the latch.
38
+ if (runtime.cameraControl === 'orbit') world.ownModelWith ??= new Set();
39
+ runtime.hud = {};
40
+ // Scene-independent state: survives `loadFromFile` (the scene data is
41
+ // replaced, the runtime instance is not). Player score/inventory and the
42
+ // camera angle live here so they cross scene switches.
43
+ runtime.persistent = {};
44
+ runtime.currentScenePath = scenePath ?? 'scenes/main.scene';
45
+ // This loop applies `requestedContent` with `requestedScene` (another
46
+ // deck's content, mounted as data); a caller checks before asking.
47
+ runtime.mountsContent = true;
48
+
49
+ // What went down between capped frames, for the next one that runs.
50
+ const latch = makeInputLatch();
51
+ const detachInput = attachInput(canvas, runtime, world, latch);
52
+ const stopResize = attachResize(canvas, world);
53
+ const stopLoop = startLoop(
54
+ runtime,
55
+ world,
56
+ sprites,
57
+ hudRefs,
58
+ onFirstFrame,
59
+ onLoopError,
60
+ latch,
61
+ onStage
62
+ );
63
+ return () => {
64
+ stopLoop();
65
+ stopResize();
66
+ detachInput();
67
+ runtime.dispose();
68
+ disposeWorld(world);
69
+ };
70
+ }
71
+
72
+ function attachInput(canvas, runtime, world, latch) {
73
+ const onKeyDown = (event) => {
74
+ // Space is gameplay (jump); keep it from scrolling the page.
75
+ if (event.code === 'Space' && event.target === canvas) event.preventDefault();
76
+ if (event.code === 'KeyP' && !event.repeat) {
77
+ world.debugLines.visible = !world.debugLines.visible;
78
+ }
79
+ if (
80
+ runtime.cameraControl === 'orbit' &&
81
+ event.key === 'Shift' &&
82
+ !event.repeat &&
83
+ !event.isComposing && !event.altKey && !event.ctrlKey && !event.metaKey &&
84
+ !event.target?.isContentEditable &&
85
+ !event.target?.closest?.('input, textarea, select')
86
+ ) {
87
+ runtime.orbitInput().shiftLock.toggle();
88
+ }
89
+ runtime.keys.add(event.code);
90
+ runtime.keys.add(event.key);
91
+ // A key's auto-repeat is not a new press: it is held, and a frame that
92
+ // runs sees it held.
93
+ if (runtime.maxFps > 0 && !event.repeat) {
94
+ latch.keys.add(event.code);
95
+ latch.keys.add(event.key);
96
+ }
97
+ };
98
+ const onKeyUp = (event) => {
99
+ runtime.keys.delete(event.code);
100
+ runtime.keys.delete(event.key);
101
+ };
102
+ // Pointer (mouse or touch) input is multitouch, tracked per pointerId:
103
+ // - a DRAG is the virtual stick -- the offset from where the drag started
104
+ // maps to a walk direction (drag up = forward). The first pointer to
105
+ // travel past the tap slop owns the stick until it lifts.
106
+ // - a TAP (down and up quickly without moving much) is a jump, even while
107
+ // another finger is dragging. `moveInput.consumeJump()` hands the
108
+ // pending tap to the Player behavior exactly once.
109
+ // `runtime.moveInput` is what the Player behavior reads.
110
+ const STICK_RADIUS_PX = 56;
111
+ const TAP_SLOP_PX = 12;
112
+ const TAP_MS = 300;
113
+ const pointers = new Map();
114
+ let stickId = null;
115
+ let jumpPending = false;
116
+ const move = {
117
+ x: 0,
118
+ y: 0,
119
+ active: false,
120
+ consumeJump() {
121
+ const had = jumpPending;
122
+ jumpPending = false;
123
+ return had;
124
+ },
125
+ };
126
+ runtime.moveInput = move;
127
+ const clearStick = () => {
128
+ stickId = null;
129
+ move.active = false;
130
+ move.x = 0;
131
+ move.y = 0;
132
+ };
133
+ // A scene that set `"engine": { "camera": { "control": "orbit" } }` beside
134
+ // `"follow": "rigid"`: a pointer that goes down in it is orbitinput.js's
135
+ // from then until it lifts (or a scene loads). It is made the first time
136
+ // a pointer goes down under the key, Shift is pressed there, or a Player runs under it
137
+ // (`runtime.orbitInput()`), never in a runtime that does not meet the key.
138
+ // Without the key each handler below reads one property and goes on as it
139
+ // always did.
140
+ let orbit = null;
141
+ runtime.orbitInput = () =>
142
+ (orbit ??= attachOrbitInput(
143
+ canvas,
144
+ runtime,
145
+ move,
146
+ () => {
147
+ jumpPending = true;
148
+ },
149
+ { stickRadius: STICK_RADIUS_PX, tapSlop: TAP_SLOP_PX, tapMs: TAP_MS },
150
+ // A pointer that came up unseen while a lock of the orbit input's
151
+ // was on: a pointercancel for it, through the handler below.
152
+ (event) => onPointerUp(event)
153
+ ));
154
+ const onPointerDown = (event) => {
155
+ if (runtime.cameraControl === 'orbit') {
156
+ // Fingers that went down before the key (a scene without it was
157
+ // loaded then) are let go of here, so they and orbitinput.js never
158
+ // both write the stick: the handlers below ignore them from now on.
159
+ if (pointers.size > 0 || stickId !== null) {
160
+ pointers.clear();
161
+ clearStick();
162
+ }
163
+ return runtime.orbitInput().down(event);
164
+ }
165
+ canvas.focus();
166
+ pointers.set(event.pointerId, {
167
+ x: event.clientX,
168
+ y: event.clientY,
169
+ time: performance.now(),
170
+ moved: false,
171
+ });
172
+ // A runtime that has met the key: the orbit input gives this pointer
173
+ // its capture back if a lock of its own ends while it is down.
174
+ orbit?.pointer(event);
175
+ canvas.setPointerCapture(event.pointerId);
176
+ };
177
+ const onPointerMove = (event) => {
178
+ if (orbit?.active && orbit.move(event)) {
179
+ // The orbit input writes its stick into `move` too: under a cap it is
180
+ // lent like the stick below, so a drag that ends between two capped
181
+ // frames is still seen.
182
+ if (runtime.maxFps > 0 && move.active) latch.stick = { x: move.x, y: move.y };
183
+ return;
184
+ }
185
+ const p = pointers.get(event.pointerId);
186
+ if (!p) return;
187
+ const dx = event.clientX - p.x;
188
+ const dy = event.clientY - p.y;
189
+ if (!p.moved && Math.hypot(dx, dy) > TAP_SLOP_PX) p.moved = true;
190
+ // A pointer claims the stick once it is clearly a drag (and nothing else
191
+ // holds it) -- so a tapping finger never yanks the walk direction.
192
+ if (p.moved && stickId === null) stickId = event.pointerId;
193
+ if (stickId !== event.pointerId) return;
194
+ const nx = dx / STICK_RADIUS_PX;
195
+ const ny = dy / STICK_RADIUS_PX;
196
+ const len = Math.hypot(nx, ny);
197
+ const scale = len > 1 ? 1 / len : 1;
198
+ move.active = true;
199
+ move.x = nx * scale;
200
+ move.y = ny * scale;
201
+ if (runtime.maxFps > 0) latch.stick = { x: move.x, y: move.y };
202
+ };
203
+ const onPointerUp = (event) => {
204
+ if (orbit?.busy && orbit.up(event)) return;
205
+ orbit?.pointer(event);
206
+ const p = pointers.get(event.pointerId);
207
+ pointers.delete(event.pointerId);
208
+ if (stickId === event.pointerId) clearStick();
209
+ if (event.type === 'pointercancel' || !p) return;
210
+ if (!p.moved && performance.now() - p.time < TAP_MS) jumpPending = true;
211
+ };
212
+ window.addEventListener('keydown', onKeyDown);
213
+ window.addEventListener('keyup', onKeyUp);
214
+ canvas.addEventListener('pointerdown', onPointerDown);
215
+ canvas.addEventListener('pointermove', onPointerMove);
216
+ canvas.addEventListener('pointerup', onPointerUp);
217
+ canvas.addEventListener('pointercancel', onPointerUp);
218
+ if (document.hasFocus() || window.parent === window) canvas.focus();
219
+ return () => {
220
+ window.removeEventListener('keydown', onKeyDown);
221
+ window.removeEventListener('keyup', onKeyUp);
222
+ canvas.removeEventListener('pointerdown', onPointerDown);
223
+ canvas.removeEventListener('pointermove', onPointerMove);
224
+ canvas.removeEventListener('pointerup', onPointerUp);
225
+ canvas.removeEventListener('pointercancel', onPointerUp);
226
+ orbit?.detach();
227
+ };
228
+ }
229
+
230
+ function attachResize(canvas, world) {
231
+ const fit = () => resizeWorld(world, canvas.clientWidth, canvas.clientHeight);
232
+ const observer = new ResizeObserver(fit);
233
+ observer.observe(canvas);
234
+ fit();
235
+ return () => observer.disconnect();
236
+ }
237
+
238
+ function startLoop(runtime, world, sprites, hudRefs, onFirstFrame, onError, latch, onStage) {
239
+ let raf = 0;
240
+ const clock = makeFrameClock(performance.now());
241
+ let firstFrameSignaled = false;
242
+ const tick = (now) => {
243
+ // A scene that set `engine.maxFps` skips an animation frame that comes
244
+ // too soon after the last frame that ran (`framecap.js`); without it
245
+ // every animation frame runs, handed what it always was.
246
+ const maxFps = runtime.maxFps;
247
+ const dt = nextFrame(clock, now, maxFps);
248
+ if (dt === null) {
249
+ raf = requestAnimationFrame(tick);
250
+ return;
251
+ }
252
+ const stage = firstFrameSignaled ? undefined : onStage;
253
+ try {
254
+ stage?.('first-update:start');
255
+ // A capped frame also sees what went down while frames were skipped.
256
+ if (maxFps > 0) updateLending(runtime, latch, dt);
257
+ else {
258
+ // Nothing noted under a cap outlives it: a frame without one drops it.
259
+ if (latch.keys.size > 0 || latch.stick) {
260
+ latch.keys.clear();
261
+ latch.stick = null;
262
+ }
263
+ prepareModelConsumers(world, runtime);
264
+ runtime.update(dt);
265
+ }
266
+ stage?.('first-update:end');
267
+ // A behavior may have requested a scene switch; apply it here, between
268
+ // frames, never mid physics dispatch. The load resets
269
+ // registered systems -- the rapier world frees and lazily rebuilds --
270
+ // while `runtime.persistent` carries the player's cross-scene state.
271
+ if (runtime.requestedScene) {
272
+ const next = world.emptyNodesOwned
273
+ ? loadEmptyScene(world, runtime, loadRequestedScene)
274
+ : loadRequestedScene(runtime);
275
+ if (runtime.skipsEmptyNodes) prepareEmptyNodes(world, runtime);
276
+ runtime.currentScenePath = next;
277
+ runtime.persistent.sceneChangeGraceUntil = runtime.time + 1;
278
+ }
279
+ stage?.('scene-build:start');
280
+ syncActors(world, runtime, runtime.sprites ?? sprites, dt);
281
+ stage?.('scene-build:end');
282
+ if (world.debugLines.visible) updatePhysicsDebug(world, runtime.physics3d?.debugRender());
283
+ // Under the orbit camera key the Player names its actor for this
284
+ // frame's draw, which leaves that model out when the camera is inside
285
+ // it (ownmodel.js). Without the key the field is never set and this
286
+ // is the call it always was.
287
+ stage?.('first-render:start');
288
+ if (runtime.orbitOwnModel !== undefined) renderHidingOwnModel(world, runtime, renderWorld);
289
+ else renderWorld(world, runtime);
290
+ stage?.('first-render:end');
291
+ updateHud(runtime, hudRefs);
292
+ } catch (err) {
293
+ onError?.(err);
294
+ return;
295
+ }
296
+ if (!firstFrameSignaled) {
297
+ firstFrameSignaled = true;
298
+ requestAnimationFrame(() => {
299
+ onStage?.('first-frame');
300
+ onFirstFrame?.();
301
+ });
302
+ }
303
+ raf = requestAnimationFrame(tick);
304
+ };
305
+ raf = requestAnimationFrame(tick);
306
+ return () => cancelAnimationFrame(raf);
307
+ }
308
+
309
+ // Load the scene a behavior asked for, with the content it comes from when
310
+ // that is another deck's (a hub content pack; `null` puts this deck's own
311
+ // back). Content that fails to load puts the scene that was running back and
312
+ // leaves the error on `runtime.mountError` for the asker. Returns the path now
313
+ // loaded.
314
+ function loadRequestedScene(runtime) {
315
+ const next = runtime.requestedScene;
316
+ runtime.requestedScene = null;
317
+ if (runtime.requestedContent === undefined) {
318
+ runtime.loadFromFile(next);
319
+ return next;
320
+ }
321
+ const before = { content: runtime.content ?? null, path: runtime.currentScenePath };
322
+ runtime.setContent(runtime.requestedContent);
323
+ runtime.requestedContent = undefined;
324
+ try {
325
+ runtime.loadFromFile(next);
326
+ return next;
327
+ } catch (err) {
328
+ console.error('[engine] content failed to load; staying where we were', err);
329
+ runtime.setContent(before.content);
330
+ runtime.loadFromFile(before.path);
331
+ runtime.mountError = err;
332
+ return before.path;
333
+ }
334
+ }
335
+
336
+ // Behaviors write `scene.hud = { score, look }`; the loop pushes it into the
337
+ // overlay divs imperatively (no react re-render at frame rate).
338
+ function updateHud(runtime, hudRefs) {
339
+ const hud = runtime.hud ?? {};
340
+ const scoreText = hud.score ? String(hud.score) : '';
341
+ const lookText = hud.look ?? '';
342
+ if (hudRefs.score.current && hudRefs.score.current.textContent !== scoreText) {
343
+ hudRefs.score.current.textContent = scoreText;
344
+ }
345
+ if (hudRefs.look.current && hudRefs.look.current.textContent !== lookText) {
346
+ hudRefs.look.current.textContent = lookText;
347
+ }
348
+ }
349
+
350
+ export const hudStyles = {
351
+ score: {
352
+ position: 'absolute',
353
+ top: 14,
354
+ left: 16,
355
+ color: '#7bd9ed',
356
+ font: "16px/1.4 'SFMono-Regular', Consolas, monospace",
357
+ textShadow: '0 1px 2px rgba(0,0,0,0.8)',
358
+ pointerEvents: 'none',
359
+ },
360
+ look: {
361
+ position: 'absolute',
362
+ bottom: 22,
363
+ left: 0,
364
+ right: 0,
365
+ textAlign: 'center',
366
+ color: '#e6e6e2',
367
+ fontStyle: 'italic',
368
+ font: 'italic 15px/1.4 Georgia, serif',
369
+ textShadow: '0 1px 3px rgba(0,0,0,0.9)',
370
+ pointerEvents: 'none',
371
+ },
372
+ };
@@ -17,7 +17,7 @@ import { applyLook, lookIsEnabled } from './look';
17
17
  import { applyArtObjects, applyMaterialExtras, partArtRefs } from './artobjects';
18
18
  import { coarsenParts, detailFor, optimizeModel, referenceBudget } from './optimize';
19
19
  import { airSpeed, modelAnimation } from './motion';
20
- import { modelWalk, takeWalkSpeedHint, walkGait } from './gait.js';
20
+ import { modelWalk, takeWalkSpeedHint, takeWalkSpeedHintIfPresent, walkGait } from './gait.js';
21
21
 
22
22
  const DEG = Math.PI / 180;
23
23
 
@@ -643,9 +643,9 @@ export function modelArtSignature(model, sprites) {
643
643
  // Walk animation by part-id convention (legL/legR/armL/armR/torso), driven by
644
644
  // observed motion: speed from position deltas, air from vertical speed, lean
645
645
  // from yaw rate. dt of 0 (editor views) holds the neutral pose.
646
- export function animateModelParts(entry, dt, world) {
646
+ export function animateModelParts(entry, dt, world, skipEmptyHints = false) {
647
647
  if (walkGait() === 'model') {
648
- entry.walkFrameHint = takeWalkSpeedHint(entry.node);
648
+ entry.walkFrameHint = (skipEmptyHints ? takeWalkSpeedHintIfPresent(entry.node) : takeWalkSpeedHint(entry.node));
649
649
  }
650
650
  const partGroups = entry.node.userData.modelParts;
651
651
  if (!partGroups) return;