castle-web-cli 0.4.233 → 0.4.235

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (383) hide show
  1. package/dist/api.d.ts +11 -0
  2. package/dist/api.js +43 -0
  3. package/dist/bundle.d.ts +64 -0
  4. package/dist/bundle.js +558 -2
  5. package/dist/castle-host/host.d.ts +17 -2
  6. package/dist/castle-host/host.js +793 -36
  7. package/dist/castleJson.d.ts +20 -1
  8. package/dist/castleJson.js +44 -2
  9. package/dist/check.js +9 -2
  10. package/dist/chunkLoader.d.ts +3 -0
  11. package/dist/chunkLoader.js +111 -0
  12. package/dist/devParty.d.ts +26 -0
  13. package/dist/devParty.js +231 -0
  14. package/dist/devSaveStorage.js +4 -0
  15. package/dist/devSessionStorage.js +3 -1
  16. package/dist/devSocial.d.ts +24 -0
  17. package/dist/devSocial.js +70 -0
  18. package/dist/ide.d.ts +2 -0
  19. package/dist/ide.js +119 -15
  20. package/dist/index.js +8 -2
  21. package/dist/init.js +1 -1
  22. package/dist/save-deck.d.ts +20 -1
  23. package/dist/save-deck.js +141 -5
  24. package/dist/serve.js +29 -11
  25. package/dist/shell/assets/{index-BjOxR-lW.js → index-DulbYIJm.js} +97 -97
  26. package/dist/shell/index.html +1 -1
  27. package/dist/vitePlugins.d.ts +2 -1
  28. package/dist/vitePlugins.js +13 -0
  29. package/kits/base/castle.json +1 -1
  30. package/kits/base/sdk/README.md +266 -3
  31. package/kits/base/sdk/castle.d.ts +7 -3
  32. package/kits/base/sdk/castle.js +2 -0
  33. package/kits/base/sdk/commands.d.ts +162 -1
  34. package/kits/base/sdk/commands.js +3 -0
  35. package/kits/base/sdk/display.d.ts +3 -0
  36. package/kits/base/sdk/display.js +9 -3
  37. package/kits/base/sdk/hub.d.ts +33 -6
  38. package/kits/base/sdk/hub.js +68 -5
  39. package/kits/base/sdk/hubRejoin.d.ts +4 -0
  40. package/kits/base/sdk/hubRejoin.js +15 -0
  41. package/kits/base/sdk/multiplayer.d.ts +7 -1
  42. package/kits/base/sdk/multiplayer.js +147 -40
  43. package/kits/base/sdk/multiplayerProtocol.d.ts +2 -0
  44. package/kits/base/sdk/party.d.ts +23 -0
  45. package/kits/base/sdk/party.js +91 -0
  46. package/kits/base/sdk/reconnectBudget.d.ts +23 -0
  47. package/kits/base/sdk/reconnectBudget.js +96 -0
  48. package/kits/base/sdk/save.d.ts +38 -1
  49. package/kits/base/sdk/save.js +79 -6
  50. package/kits/base/sdk/server/hub.d.ts +31 -1
  51. package/kits/base/sdk/server/hub.js +50 -3
  52. package/kits/base/sdk/server/platformHandle.d.ts +13 -1
  53. package/kits/base/sdk/server/storage.d.ts +4 -0
  54. package/kits/base/sdk/server/storage.js +19 -3
  55. package/kits/base/sdk/server/wrapper.d.ts +7 -1
  56. package/kits/base/sdk/server/wrapper.js +10 -1
  57. package/kits/base/sdk/social.d.ts +9 -0
  58. package/kits/base/sdk/social.js +5 -0
  59. package/kits/hub-game/CLAUDE.md +123 -3
  60. package/kits/hub-game/README.md +63 -0
  61. package/kits/hub-game/castle.json +5 -5
  62. package/kits/hub-game/code/client/act.js +312 -0
  63. package/kits/hub-game/code/client/actionLayout.js +147 -0
  64. package/kits/hub-game/code/client/actionOverflow.js +556 -0
  65. package/kits/hub-game/code/client/arrivalCamera.js +50 -0
  66. package/kits/hub-game/code/client/askSlot.js +117 -0
  67. package/kits/hub-game/code/client/avatar.js +4 -2
  68. package/kits/hub-game/code/client/avatarShare.js +2 -0
  69. package/kits/hub-game/code/client/backVisibility.js +13 -0
  70. package/kits/hub-game/code/client/ballot.js +15 -10
  71. package/kits/hub-game/code/client/build.js +16 -0
  72. package/kits/hub-game/code/client/chat.js +41 -5
  73. package/kits/hub-game/code/client/chatModeration.js +5 -0
  74. package/kits/hub-game/code/client/chrome.js +1148 -258
  75. package/kits/hub-game/code/client/crowdNames.js +241 -0
  76. package/kits/hub-game/code/client/decor.js +10 -4
  77. package/kits/hub-game/code/client/defaultEnvironment.js +194 -0
  78. package/kits/hub-game/code/client/doorErrors.js +39 -0
  79. package/kits/hub-game/code/client/fall.js +18 -0
  80. package/kits/hub-game/code/client/farAvatars.js +233 -0
  81. package/kits/hub-game/code/client/firstJoin.js +9 -2
  82. package/kits/hub-game/code/client/fpsTelemetry.js +50 -0
  83. package/kits/hub-game/code/client/frameBatch.js +5 -0
  84. package/kits/hub-game/code/client/grab.js +31 -11
  85. package/kits/hub-game/code/client/hookLayer.js +87 -8
  86. package/kits/hub-game/code/client/hudCopy.js +51 -0
  87. package/kits/hub-game/code/client/hudRate.js +20 -0
  88. package/kits/hub-game/code/client/idle.js +14 -2
  89. package/kits/hub-game/code/client/invites.js +231 -0
  90. package/kits/hub-game/code/client/joinError.js +9 -0
  91. package/kits/hub-game/code/client/labelsNear.js +31 -2
  92. package/kits/hub-game/code/client/landscapeLayout.js +17 -0
  93. package/kits/hub-game/code/client/layoutCache.js +264 -0
  94. package/kits/hub-game/code/client/loadTelemetry.js +20 -0
  95. package/kits/hub-game/code/client/loadingCover.js +148 -0
  96. package/kits/hub-game/code/client/loadingEntry.js +8 -0
  97. package/kits/hub-game/code/client/menuRows.js +43 -0
  98. package/kits/hub-game/code/client/modelReady.js +7 -0
  99. package/kits/hub-game/code/client/padCueArrival.js +23 -0
  100. package/kits/hub-game/code/client/padCues.js +112 -0
  101. package/kits/hub-game/code/client/padOccupancy.js +88 -0
  102. package/kits/hub-game/code/client/padReadability.js +26 -0
  103. package/kits/hub-game/code/client/padRings.js +69 -0
  104. package/kits/hub-game/code/client/pushVisit.js +14 -0
  105. package/kits/hub-game/code/client/quality.js +205 -0
  106. package/kits/hub-game/code/client/qualityEntry.js +55 -0
  107. package/kits/hub-game/code/client/safeLayout.js +338 -0
  108. package/kits/hub-game/code/client/safeStyle.js +42 -0
  109. package/kits/hub-game/code/client/say.js +12 -3
  110. package/kits/hub-game/code/client/shot.js +64 -10
  111. package/kits/hub-game/code/client/shotFit.js +56 -0
  112. package/kits/hub-game/code/client/signIn.js +28 -0
  113. package/kits/hub-game/code/client/state.js +53 -0
  114. package/kits/hub-game/code/client/talk.js +209 -45
  115. package/kits/hub-game/code/client/tiers.js +68 -66
  116. package/kits/hub-game/code/client/together.js +7 -2
  117. package/kits/hub-game/code/client/weakestLookBake.js +92 -0
  118. package/kits/hub-game/code/client/weakestTier.js +295 -0
  119. package/kits/hub-game/code/client/worldLabels.js +241 -0
  120. package/kits/hub-game/code/client/yours.js +10 -9
  121. package/kits/hub-game/code/npcDisplayText.js +55 -0
  122. package/kits/hub-game/code/server/act.js +124 -0
  123. package/kits/hub-game/code/server/actions.js +6 -1
  124. package/kits/hub-game/code/server/actors.js +2 -1
  125. package/kits/hub-game/code/server/analytics.js +83 -0
  126. package/kits/hub-game/code/server/anonymousEntry.js +49 -0
  127. package/kits/hub-game/code/server/arrivalPose.js +36 -0
  128. package/kits/hub-game/code/server/companion.js +28 -3
  129. package/kits/hub-game/code/server/doorAnalytics.js +52 -0
  130. package/kits/hub-game/code/server/earned.js +22 -5
  131. package/kits/hub-game/code/server/frameBatch.js +183 -0
  132. package/kits/hub-game/code/server/friendsAmong.js +49 -9
  133. package/kits/hub-game/code/server/history.js +2 -0
  134. package/kits/hub-game/code/server/hub.js +1306 -95
  135. package/kits/hub-game/code/server/idle.js +30 -1
  136. package/kits/hub-game/code/server/index.js +26 -4
  137. package/kits/hub-game/code/server/invites.js +19 -0
  138. package/kits/hub-game/code/server/labels.js +9 -1
  139. package/kits/hub-game/code/server/loadAbandon.js +106 -0
  140. package/kits/hub-game/code/server/manifest.js +211 -3
  141. package/kits/hub-game/code/server/menu.js +31 -3
  142. package/kits/hub-game/code/server/npcs.js +226 -64
  143. package/kits/hub-game/code/server/observe.js +408 -0
  144. package/kits/hub-game/code/server/padOccupancy.js +85 -0
  145. package/kits/hub-game/code/server/players.js +9 -1
  146. package/kits/hub-game/code/server/resumePose.js +152 -0
  147. package/kits/hub-game/code/server/say.js +1 -1
  148. package/kits/hub-game/code/server/standing.js +4 -5
  149. package/kits/hub-game/code/server/storageLimit.js +187 -0
  150. package/kits/hub-game/code/server/vis.js +67 -5
  151. package/kits/hub-game/code/shared/act.js +35 -0
  152. package/kits/hub-game/code/shared/danceIdle.js +28 -0
  153. package/kits/hub-game/code/shared/loadStages.js +12 -0
  154. package/kits/hub-game/code/shared/quality.js +74 -0
  155. package/kits/hub-game/code/shared/say.js +2 -0
  156. package/kits/hub-game/code/shared/shot.js +35 -1
  157. package/kits/hub-game/code/systems/hub.js +970 -169
  158. package/kits/hub-game/docs/analytics.md +279 -0
  159. package/kits/hub-game/docs/contract.md +1259 -42
  160. package/kits/hub-game/docs/home-pieces.md +9 -2
  161. package/kits/hub-game/docs/observed-progress.md +252 -0
  162. package/kits/hub-game/main.jsx +2 -0
  163. package/kits/hub-game/package-lock.json +10 -3
  164. package/kits/hub-game/package.json +6 -3
  165. package/kits/hub-game/play/player.js +142 -0
  166. package/kits/hub-game/play/registry.js +47 -0
  167. package/kits/hub-game/play.jsx +37 -0
  168. package/kits/hub-game/scripts/check.mjs +39 -5
  169. package/kits/hub-game/scripts/companion-follower-wire.json +1 -1
  170. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +11 -0
  171. package/kits/hub-game/scripts/fixtures/decor-keyless.json +5 -5
  172. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +3 -0
  173. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +19 -3
  174. package/kits/hub-game/scripts/fixtures/interest-legacy.json +3 -3
  175. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -1
  176. package/kits/hub-game/scripts/pose-storage-fixture.mjs +46 -0
  177. package/kits/hub-game/scripts/test-act-client.mjs +186 -0
  178. package/kits/hub-game/scripts/test-act.mjs +171 -0
  179. package/kits/hub-game/scripts/test-action-layout.mjs +80 -0
  180. package/kits/hub-game/scripts/test-action-observers.mjs +46 -0
  181. package/kits/hub-game/scripts/test-actions-client.mjs +367 -2
  182. package/kits/hub-game/scripts/test-actors.mjs +20 -7
  183. package/kits/hub-game/scripts/test-analytics.mjs +76 -0
  184. package/kits/hub-game/scripts/test-anonymous-entry.mjs +28 -0
  185. package/kits/hub-game/scripts/test-arrival-pose-server.mjs +196 -0
  186. package/kits/hub-game/scripts/test-arrival-pose.mjs +24 -0
  187. package/kits/hub-game/scripts/test-ask-slot.mjs +85 -0
  188. package/kits/hub-game/scripts/test-avatar-wire.mjs +49 -10
  189. package/kits/hub-game/scripts/test-avatar.mjs +44 -0
  190. package/kits/hub-game/scripts/test-back-visibility.mjs +82 -0
  191. package/kits/hub-game/scripts/test-ballot.mjs +11 -4
  192. package/kits/hub-game/scripts/test-ban-join.mjs +121 -13
  193. package/kits/hub-game/scripts/test-build.mjs +20 -2
  194. package/kits/hub-game/scripts/test-chat.mjs +206 -5
  195. package/kits/hub-game/scripts/test-companion-chat.mjs +20 -2
  196. package/kits/hub-game/scripts/test-control-layout-dom.mjs +120 -0
  197. package/kits/hub-game/scripts/test-crowd-names.mjs +205 -0
  198. package/kits/hub-game/scripts/test-decor-client.mjs +45 -4
  199. package/kits/hub-game/scripts/test-decor.mjs +7 -0
  200. package/kits/hub-game/scripts/test-default-environment-root.mjs +95 -0
  201. package/kits/hub-game/scripts/test-default-environment.mjs +267 -0
  202. package/kits/hub-game/scripts/test-door-analytics.mjs +58 -0
  203. package/kits/hub-game/scripts/test-door-jump.mjs +100 -0
  204. package/kits/hub-game/scripts/test-earned.mjs +33 -3
  205. package/kits/hub-game/scripts/test-far-avatars.mjs +340 -0
  206. package/kits/hub-game/scripts/test-fps-telemetry.mjs +112 -0
  207. package/kits/hub-game/scripts/test-frame-batch.mjs +252 -0
  208. package/kits/hub-game/scripts/test-fresh-friends.mjs +118 -0
  209. package/kits/hub-game/scripts/test-grab-orbit.mjs +47 -4
  210. package/kits/hub-game/scripts/test-high-only.mjs +170 -0
  211. package/kits/hub-game/scripts/test-hub-ops.mjs +321 -2
  212. package/kits/hub-game/scripts/test-hub-trip.mjs +879 -11
  213. package/kits/hub-game/scripts/test-hud-clear.mjs +162 -59
  214. package/kits/hub-game/scripts/test-hud-defects-dom.mjs +100 -0
  215. package/kits/hub-game/scripts/test-hud-rate.mjs +224 -0
  216. package/kits/hub-game/scripts/test-hud-safe-visibility-dom.mjs +83 -0
  217. package/kits/hub-game/scripts/test-idle.mjs +66 -0
  218. package/kits/hub-game/scripts/test-interest-cells.mjs +20 -0
  219. package/kits/hub-game/scripts/test-interest.mjs +15 -0
  220. package/kits/hub-game/scripts/test-invites-client.mjs +430 -0
  221. package/kits/hub-game/scripts/test-invites.mjs +109 -0
  222. package/kits/hub-game/scripts/test-labels.mjs +71 -3
  223. package/kits/hub-game/scripts/test-landscape-layout.mjs +194 -0
  224. package/kits/hub-game/scripts/test-list-scroll-dom.mjs +49 -0
  225. package/kits/hub-game/scripts/test-load-abandon.mjs +246 -0
  226. package/kits/hub-game/scripts/test-loading-cover.mjs +162 -0
  227. package/kits/hub-game/scripts/test-manifest.mjs +265 -0
  228. package/kits/hub-game/scripts/test-menu-client.mjs +105 -0
  229. package/kits/hub-game/scripts/test-menu.mjs +23 -0
  230. package/kits/hub-game/scripts/test-npcs.mjs +917 -10
  231. package/kits/hub-game/scripts/test-observed.mjs +745 -0
  232. package/kits/hub-game/scripts/test-pad-cues.mjs +304 -0
  233. package/kits/hub-game/scripts/test-pad-occupancy.mjs +177 -0
  234. package/kits/hub-game/scripts/test-picker.mjs +234 -7
  235. package/kits/hub-game/scripts/test-placement-cache.mjs +690 -0
  236. package/kits/hub-game/scripts/test-progress-reset.mjs +559 -0
  237. package/kits/hub-game/scripts/test-push-visit.mjs +26 -0
  238. package/kits/hub-game/scripts/test-quality.mjs +385 -0
  239. package/kits/hub-game/scripts/test-rehello.mjs +699 -5
  240. package/kits/hub-game/scripts/test-resume-action-order.mjs +598 -0
  241. package/kits/hub-game/scripts/test-resume-held.mjs +239 -0
  242. package/kits/hub-game/scripts/test-resume-pose.mjs +142 -0
  243. package/kits/hub-game/scripts/test-safe-events-dom.mjs +116 -0
  244. package/kits/hub-game/scripts/test-safe-layout.mjs +330 -0
  245. package/kits/hub-game/scripts/test-say.mjs +1 -1
  246. package/kits/hub-game/scripts/test-shot.mjs +145 -0
  247. package/kits/hub-game/scripts/test-signin-client.mjs +45 -0
  248. package/kits/hub-game/scripts/test-soundscape.mjs +22 -17
  249. package/kits/hub-game/scripts/test-standing.mjs +35 -2
  250. package/kits/hub-game/scripts/test-storage-limit.mjs +333 -0
  251. package/kits/hub-game/scripts/test-stuck.mjs +5 -4
  252. package/kits/hub-game/scripts/test-talk-overlay-dom.mjs +130 -0
  253. package/kits/hub-game/scripts/test-tiers-render.mjs +86 -13
  254. package/kits/hub-game/scripts/test-tiers.mjs +7 -8
  255. package/kits/hub-game/scripts/test-vis.mjs +433 -6
  256. package/kits/hub-game/scripts/test-weakest-tier.mjs +924 -0
  257. package/kits/hub-game/scripts/test-world-labels.mjs +367 -0
  258. package/kits/hub-game/scripts/test-yours-chrome.mjs +50 -6
  259. package/kits/hub-game/scripts/test-yours.mjs +39 -8
  260. package/kits/multiplayer-3d/castle.json +5 -5
  261. package/kits/multiplayer-3d/code/client/joinFailure.js +27 -0
  262. package/kits/multiplayer-3d/code/client/resumeGate.js +139 -0
  263. package/kits/multiplayer-3d/code/systems/multiplayer.js +369 -30
  264. package/kits/multiplayer-3d/package-lock.json +8 -1
  265. package/kits/multiplayer-3d/package.json +2 -1
  266. package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +436 -0
  267. package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +624 -0
  268. package/kits/physics-2d/CLAUDE.md +10 -1
  269. package/kits/physics-2d/castle.json +2 -2
  270. package/kits/physics-2d/engine/frozenActors.js +233 -0
  271. package/kits/physics-2d/engine/scene.js +87 -5
  272. package/kits/physics-2d/eslint.config.js +1 -1
  273. package/kits/physics-2d/play/behaviors/AnalogStick.js +198 -0
  274. package/kits/physics-2d/play/behaviors/Camera.js +40 -0
  275. package/kits/physics-2d/play/behaviors/Collider.js +122 -0
  276. package/kits/physics-2d/play/behaviors/Draggable.js +115 -0
  277. package/kits/physics-2d/play/behaviors/Goal.js +46 -0
  278. package/kits/physics-2d/play/behaviors/Joints.js +126 -0
  279. package/kits/physics-2d/play/behaviors/Layout.js +71 -0
  280. package/kits/physics-2d/play/behaviors/RigidBody.js +57 -0
  281. package/kits/physics-2d/play/behaviors/Slingshot.js +142 -0
  282. package/kits/physics-2d/play/behaviors/SoundPlayer.js +263 -0
  283. package/kits/physics-2d/play/behaviors/Sprite.js +406 -0
  284. package/kits/physics-2d/play/behaviors/Style.js +209 -0
  285. package/kits/physics-2d/play/behaviors/Text.js +85 -0
  286. package/kits/physics-2d/play/behaviors/Video.js +93 -0
  287. package/kits/physics-3d/CLAUDE.md +25 -1651
  288. package/kits/physics-3d/behaviors/Body.jsx +3 -0
  289. package/kits/physics-3d/behaviors/Model.jsx +3 -0
  290. package/kits/physics-3d/behaviors/Player.jsx +35 -18
  291. package/kits/physics-3d/behaviors/Shape.jsx +3 -0
  292. package/kits/physics-3d/behaviors/Solid.jsx +3 -0
  293. package/kits/physics-3d/behaviors/Transform.jsx +3 -0
  294. package/kits/physics-3d/castle.json +3 -3
  295. package/kits/physics-3d/docs/engine-camera.md +542 -0
  296. package/kits/physics-3d/docs/engine-frame-cap.md +136 -0
  297. package/kits/physics-3d/docs/engine-load.md +149 -0
  298. package/kits/physics-3d/docs/engine-look.md +114 -0
  299. package/kits/physics-3d/docs/engine-shadows.md +372 -0
  300. package/kits/physics-3d/docs/engine-skip-work.md +187 -0
  301. package/kits/physics-3d/docs/engine-sky.md +198 -0
  302. package/kits/physics-3d/docs/engine-static-actors.md +226 -0
  303. package/kits/physics-3d/docs/engine-view.md +37 -0
  304. package/kits/physics-3d/docs/pxmodel-format.md +1 -1
  305. package/kits/physics-3d/engine3d/PlayOnly3D.jsx +5 -1
  306. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +19 -333
  307. package/kits/physics-3d/engine3d/actornode.js +1 -0
  308. package/kits/physics-3d/engine3d/branches.js +3 -13
  309. package/kits/physics-3d/engine3d/cage.js +2 -7
  310. package/kits/physics-3d/engine3d/cageops.js +2 -17
  311. package/kits/physics-3d/engine3d/dataBehaviors.js +12 -0
  312. package/kits/physics-3d/engine3d/framecap.js +4 -1
  313. package/kits/physics-3d/engine3d/frozenphysics.js +140 -0
  314. package/kits/physics-3d/engine3d/frozenstatics.js +273 -0
  315. package/kits/physics-3d/engine3d/gait.js +8 -0
  316. package/kits/physics-3d/engine3d/initialModelFiles.js +18 -0
  317. package/kits/physics-3d/engine3d/look.js +7 -0
  318. package/kits/physics-3d/engine3d/modelFiles.js +3 -17
  319. package/kits/physics-3d/engine3d/modelMath.js +49 -0
  320. package/kits/physics-3d/engine3d/modelready.js +16 -0
  321. package/kits/physics-3d/engine3d/motion.js +3 -3
  322. package/kits/physics-3d/engine3d/nearshadows.js +77 -10
  323. package/kits/physics-3d/engine3d/orbitinput.js +59 -25
  324. package/kits/physics-3d/engine3d/partgeometry.js +1 -16
  325. package/kits/physics-3d/engine3d/paths.js +1 -9
  326. package/kits/physics-3d/engine3d/playTimings.js +50 -0
  327. package/kits/physics-3d/engine3d/playerRun.js +372 -0
  328. package/kits/physics-3d/engine3d/pxmodel.js +3 -3
  329. package/kits/physics-3d/engine3d/rapier.js +27 -0
  330. package/kits/physics-3d/engine3d/scatter.js +1 -11
  331. package/kits/physics-3d/engine3d/shadowfade.js +23 -15
  332. package/kits/physics-3d/engine3d/sky.js +1 -1
  333. package/kits/physics-3d/engine3d/squarefirst.js +177 -0
  334. package/kits/physics-3d/engine3d/stillshadows.js +399 -0
  335. package/kits/physics-3d/engine3d/sweep.js +1 -25
  336. package/kits/physics-3d/engine3d/world3d.js +468 -18
  337. package/kits/physics-3d/eslint.config.js +2 -1
  338. package/kits/physics-3d/main.jsx +6 -3
  339. package/kits/physics-3d/package-lock.json +7 -0
  340. package/kits/physics-3d/package.json +5 -1
  341. package/kits/physics-3d/play/behaviors/Body.js +31 -0
  342. package/kits/physics-3d/play/behaviors/Door.js +37 -0
  343. package/kits/physics-3d/play/behaviors/Lookable.js +16 -0
  344. package/kits/physics-3d/play/behaviors/Model.js +23 -0
  345. package/kits/physics-3d/play/behaviors/Pickup.js +46 -0
  346. package/kits/physics-3d/play/behaviors/Player.js +1204 -0
  347. package/kits/physics-3d/play/behaviors/Shape.js +47 -0
  348. package/kits/physics-3d/play/behaviors/Solid.js +16 -0
  349. package/kits/physics-3d/play/behaviors/Transform.js +29 -0
  350. package/kits/physics-3d/pnpm-lock.yaml +8 -0
  351. package/kits/physics-3d/scripts/bench-shadow-fade.mjs +37 -0
  352. package/kits/physics-3d/scripts/build-rapier-gz.mjs +56 -0
  353. package/kits/physics-3d/scripts/frozen-statics-fixture.mjs +141 -0
  354. package/kits/physics-3d/scripts/test-camera-follow.mjs +5 -1
  355. package/kits/physics-3d/scripts/test-camera-orbit.mjs +52 -4
  356. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +1 -1
  357. package/kits/physics-3d/scripts/test-empty-gait-hints.mjs +89 -0
  358. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +6 -3
  359. package/kits/physics-3d/scripts/test-frame-cap.mjs +1 -1
  360. package/kits/physics-3d/scripts/test-frozen-nested.mjs +49 -0
  361. package/kits/physics-3d/scripts/test-frozen-statics-legacy-physics2d.mjs +123 -0
  362. package/kits/physics-3d/scripts/test-frozen-statics.mjs +434 -0
  363. package/kits/physics-3d/scripts/test-look-bake.mjs +1 -1
  364. package/kits/physics-3d/scripts/test-near-shadows.mjs +2 -2
  365. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +88 -7
  366. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +40 -3
  367. package/kits/physics-3d/scripts/test-orbit-shot.mjs +75 -1
  368. package/kits/physics-3d/scripts/test-rapier-gz.mjs +106 -0
  369. package/kits/physics-3d/scripts/test-sky.mjs +1 -1
  370. package/kits/physics-3d/scripts/test-square-first.mjs +921 -0
  371. package/kits/physics-3d/scripts/test-static-actors.mjs +3 -1
  372. package/kits/physics-3d/scripts/test-static-physics.mjs +4 -1
  373. package/kits/physics-3d/scripts/test-static-scenery.mjs +5 -2
  374. package/kits/physics-3d/scripts/test-steady-hover.mjs +5 -2
  375. package/kits/physics-3d/scripts/test-still-shadows.mjs +477 -0
  376. package/kits/physics-3d/systems/physics3d.js +37 -4
  377. package/kits/real-time/castle.json +2 -2
  378. package/kits/real-time/code/client/connection.js +33 -10
  379. package/kits/real-time/code/client/gameHooks.js +2 -0
  380. package/kits/real-time/code/client/joinOverlay.js +9 -4
  381. package/kits/real-time/code/server/session.js +6 -4
  382. package/kits/real-time/package-lock.json +1 -1
  383. package/package.json +2 -2
@@ -0,0 +1,273 @@
1
+ import * as THREE from 'three';
2
+ import { ActorNode } from './actornode.js';
3
+
4
+ // One world owns these bindings, and drops them on a scene switch/dispose.
5
+ // Writes thaw immediately (including a draw between the write and the next
6
+ // sync); placement/rebuild waits for the next sync's independent dirty queue.
7
+ export class FrozenStatics {
8
+ constructor(world, runtime) {
9
+ this.world = world;
10
+ this.runtime = runtime;
11
+ this.owner = runtime.frozenActors;
12
+ this.records = new Map();
13
+ this.reconcileNodes = true;
14
+ // A watched actor needs broad invalidation once until it is visited or
15
+ // watched again. Node builds can call out repeatedly within one pass.
16
+ this.invalidatable = new Set();
17
+ this.live = new Set();
18
+ // The actors the current sync took because they changed, not merely live.
19
+ this.dirty = new Set();
20
+ this.assetUsers = { assets: new Map(), arts: new Map() };
21
+ this.pending = this.owner.consumer(actor => this.thawActor(actor), () => {
22
+ this.dispose();
23
+ if (world.frozenStatics === this) delete world.frozenStatics;
24
+ });
25
+ this.sceneRestores = [];
26
+ const sceneChanged = () => {
27
+ for (const record of this.records.values()) this.changed(record);
28
+ };
29
+ watchTransform(world.scene, sceneChanged, this.sceneRestores);
30
+ for (const key of ['parent', 'matrixAutoUpdate', 'matrixWorldAutoUpdate', 'updateMatrix', 'updateMatrixWorld']) {
31
+ watchValue(world.scene, key, sceneChanged, this.sceneRestores);
32
+ }
33
+ for (const matrix of [world.scene.matrix, world.scene.matrixWorld]) {
34
+ for (let i = 0; i < 16; i++) watchValue(matrix.elements, String(i), sceneChanged, this.sceneRestores);
35
+ }
36
+ this.shared = null;
37
+ }
38
+
39
+ thawActor(actor) {
40
+ const record = this.records.get(actor);
41
+ if (record) this.thaw(record);
42
+ }
43
+
44
+ changed(record) {
45
+ if (record.writing) return;
46
+ this.pending.dirty.add(record.actor);
47
+ this.thaw(record);
48
+ // A parent can have another actor under it; changing its local transform
49
+ // changes those world matrices even if their own components did not move.
50
+ const pending = [record.node], seen = new Set();
51
+ while (pending.length) {
52
+ const object = pending.pop();
53
+ // Array.splice/reverse can notify between its individual writes.
54
+ if (!object || seen.has(object)) continue;
55
+ seen.add(object);
56
+ const actor = this.runtime.getActor(object.userData.actorId);
57
+ if (actor && actor !== record.actor) { this.pending.dirty.add(actor); this.thawActor(actor); }
58
+ pending.push(...object.children);
59
+ }
60
+ }
61
+
62
+ thaw(record) {
63
+ if (!record.frozen) return;
64
+ record.writing = true;
65
+ record.node.frozenStatic = false;
66
+ for (const object of record.objects) {
67
+ object.matrixAutoUpdate = true;
68
+ object.matrixWorldAutoUpdate = true;
69
+ }
70
+ record.node.computedFrom = null;
71
+ record.frozen = false;
72
+ record.writing = false;
73
+ }
74
+
75
+ forget(actor) {
76
+ this.invalidatable.delete(actor);
77
+ const record = this.records.get(actor);
78
+ if (record) {
79
+ this.thaw(record);
80
+ for (const restore of record.restores.reverse()) restore();
81
+ delete record.node.frozenStatic;
82
+ for (const [table, key] of record.assets ?? []) {
83
+ const count = this.assetUsers[table].get(key) - 1;
84
+ if (count) this.assetUsers[table].set(key, count);
85
+ else { this.assetUsers[table].delete(key); this[table].delete(key); }
86
+ }
87
+ this.records.delete(actor);
88
+ }
89
+ this.live.delete(actor);
90
+ }
91
+
92
+ rememberAsset(actor, table, key, signature) {
93
+ const record = this.records.get(actor);
94
+ if (!record || this.live.has(actor)) return;
95
+ const refs = record.assets ??= [];
96
+ if (!refs.some(([kind, ref]) => kind === table && ref === key)) {
97
+ refs.push([table, key]);
98
+ this.assetUsers[table].set(key, (this.assetUsers[table].get(key) ?? 0) + 1);
99
+ }
100
+ this[table].set(key, signature);
101
+ }
102
+
103
+ watch(actor, node) {
104
+ this.forget(actor);
105
+ const record = { actor, node, objects: [], restores: [], frozen: false, writing: false, safe: node instanceof ActorNode };
106
+ this.records.set(actor, record);
107
+ this.invalidatable.add(actor);
108
+ const changed = () => this.changed(record);
109
+ const visit = object => {
110
+ if (object !== node && object.userData.actorId) { record.safe = false; return; }
111
+ record.objects.push(object);
112
+ if (object.updateMatrix !== THREE.Object3D.prototype.updateMatrix ||
113
+ (object !== node && object.updateMatrixWorld !== THREE.Object3D.prototype.updateMatrixWorld) ||
114
+ !object.matrixAutoUpdate || !object.matrixWorldAutoUpdate) record.safe = false;
115
+ watchTransform(object, changed, record.restores);
116
+ for (const key of ['visible', 'parent']) watchValue(object, key, changed, record.restores);
117
+ for (const event of ['added', 'removed', 'childadded', 'childremoved']) {
118
+ object.addEventListener(event, changed);
119
+ record.restores.push(() => object.removeEventListener(event, changed));
120
+ }
121
+ const originalChildren = object.children;
122
+ const watchedChildren = new Proxy(originalChildren, {
123
+ set(target, key, value) { const ok = Reflect.set(target, key, value); changed(); return ok; },
124
+ deleteProperty(target, key) { const ok = Reflect.deleteProperty(target, key); changed(); return ok; },
125
+ });
126
+ object.children = watchedChildren;
127
+ record.restores.push(() => { if (object.children === watchedChildren) object.children = originalChildren; });
128
+ // Decor previews clone actor nodes. A clone needs normal update flags so
129
+ // it can move independently; thaw the source before three.js copies it.
130
+ const ownClone = Object.getOwnPropertyDescriptor(object, 'clone');
131
+ const originalClone = object.clone;
132
+ const clone = function (...args) { changed(); return originalClone.apply(this, args); };
133
+ object.clone = clone;
134
+ record.restores.push(() => {
135
+ if (object.clone !== clone) return;
136
+ if (ownClone) Object.defineProperty(object, 'clone', ownClone);
137
+ else delete object.clone;
138
+ });
139
+ // Raw matrix writes are observable too. Consumers retaining an elements
140
+ // array still write the same array, so no Proxy or replacement is needed.
141
+ for (const matrix of [object.matrix, object.matrixWorld]) {
142
+ for (let i = 0; i < 16; i++) watchValue(matrix.elements, String(i), changed, record.restores);
143
+ watchValue(matrix, 'elements', () => { if (!record.writing) { record.safe = false; changed(); } }, record.restores);
144
+ }
145
+ for (const key of ['matrixAutoUpdate', 'matrixWorldAutoUpdate']) {
146
+ watchValue(object, key, next => {
147
+ if (record.writing) return;
148
+ record.safe = false;
149
+ changed();
150
+ // Thaw restores the mode's flags. Preserve the controller's newly
151
+ // requested flag, including an explicit write of the frozen false.
152
+ record.writing = true;
153
+ try { object[key] = next; } finally { record.writing = false; }
154
+ }, record.restores, true);
155
+ }
156
+ for (const key of ['updateMatrix', 'updateMatrixWorld']) {
157
+ watchValue(object, key, () => { if (!record.writing) { record.safe = false; changed(); } }, record.restores);
158
+ }
159
+ for (const key of ['children', 'matrix', 'matrixWorld']) {
160
+ watchValue(object, key, () => { if (!record.writing) { record.safe = false; changed(); } }, record.restores);
161
+ }
162
+ for (const child of object.children) visit(child);
163
+ };
164
+ visit(node);
165
+ return record;
166
+ }
167
+
168
+ // Every ancestor must be a static actor (ordinary model groups within its
169
+ // subtree are fine). An unknown parent/controller stays on the old walk.
170
+ canFreeze(actor, record) {
171
+ if (!record.safe || !this.owner.isStatic(actor)) return false;
172
+ for (let parent = record.node.parent; parent && parent !== this.world.scene; parent = parent.parent) {
173
+ const ancestor = this.runtime.getActor(parent.userData.actorId);
174
+ const watched = this.records.get(ancestor);
175
+ if (!ancestor || !this.owner.isStatic(ancestor) || !watched || watched.node !== parent || !watched.safe || this.live.has(ancestor)) return false;
176
+ }
177
+ // A transformed external parent of the scene is not owned by this mode.
178
+ const scene = this.world.scene;
179
+ return scene.parent === null && scene.matrixAutoUpdate && scene.matrixWorldAutoUpdate &&
180
+ scene.updateMatrix === THREE.Object3D.prototype.updateMatrix && scene.updateMatrixWorld === THREE.Object3D.prototype.updateMatrixWorld;
181
+ }
182
+
183
+ freeze(actor, entry) {
184
+ if (!this.owner.isStatic(actor)) { this.forget(actor); return; }
185
+ let record = this.records.get(actor);
186
+ // Rewatch on a dirty sync so added/removed descendants are covered too.
187
+ if (record?.safe === false && record.node === entry.node) { this.live.add(actor); return; }
188
+ // A live actor resynced only because an ancestor cannot freeze keeps its
189
+ // watch: nothing under it changed, so re-walking it every frame buys nothing.
190
+ // Changes noticed after take() (another actor's rebuild in this sync)
191
+ // count too: they are queued for the next sync but the watch is stale now.
192
+ if (record?.node !== entry.node || this.dirty.has(actor) || this.pending.dirty.has(actor)) record = this.watch(actor, entry.node);
193
+ if (!this.canFreeze(actor, record)) { this.live.add(actor); return; }
194
+ this.live.delete(actor);
195
+ // Hidden roots are not traversed by the old renderer. Keep their matrices
196
+ // at that same last-rendered pose; reattachment queues a fresh sync.
197
+ if (!entry.node.parent && !entry.node.emptyDetached) return;
198
+ record.writing = true;
199
+ try {
200
+ entry.node.computedFrom = null;
201
+ entry.node.updateWorldMatrix(true, true);
202
+ for (const object of record.objects) {
203
+ object.matrixAutoUpdate = false;
204
+ object.matrixWorldAutoUpdate = false;
205
+ }
206
+ entry.node.frozenStatic = true;
207
+ record.frozen = true;
208
+ } finally { record.writing = false; }
209
+ }
210
+
211
+ take() {
212
+ this.dirty = new Set(this.pending.take());
213
+ const actors = new Set(this.dirty);
214
+ for (const actor of this.live) actors.add(actor);
215
+ // A consumed notification must be armed again before any later callout.
216
+ for (const actor of actors) if (this.records.has(actor)) this.invalidatable.add(actor);
217
+ return [...actors].sort((a, b) => (a.components.Layout?.z ?? 0) - (b.components.Layout?.z ?? 0) ||
218
+ (this.owner.records.get(a)?.order ?? -1) - (this.owner.records.get(b)?.order ?? -1));
219
+ }
220
+
221
+ invalidate() {
222
+ const actors = [...this.invalidatable];
223
+ this.invalidatable.clear();
224
+ for (const actor of actors) this.owner.mark(actor);
225
+ }
226
+
227
+ dispose() {
228
+ this.pending.dispose();
229
+ for (const actor of this.records.keys()) this.forget(actor);
230
+ for (const restore of this.sceneRestores.reverse()) restore();
231
+ }
232
+ }
233
+
234
+ function watchTransform(object, changed, restores) {
235
+ for (const [value, keys] of [[object.position, ['x', 'y', 'z']], [object.scale, ['x', 'y', 'z']],
236
+ [object.quaternion, ['_x', '_y', '_z', '_w']], [object.rotation, ['_x', '_y', '_z', '_order']]]) {
237
+ for (const key of keys) watchValue(value, key, changed, restores);
238
+ }
239
+ }
240
+
241
+ function watchValue(object, key, changed, restores, notifySame = false) {
242
+ const own = Object.getOwnPropertyDescriptor(object, key);
243
+ if (own && (!own.configurable || !('value' in own))) return;
244
+ let value = object[key];
245
+ const get = () => value;
246
+ Object.defineProperty(object, key, {
247
+ configurable: true, enumerable: own?.enumerable ?? false, get,
248
+ set(next) { if (notifySame || !Object.is(value, next)) { value = next; changed(next); } },
249
+ });
250
+ restores.push(() => {
251
+ if (Object.getOwnPropertyDescriptor(object, key)?.get !== get) return;
252
+ if (own) Object.defineProperty(object, key, { ...own, value });
253
+ else { delete object[key]; if (value !== undefined) object[key] = value; }
254
+ });
255
+ }
256
+
257
+ export function frozenNodeState(world) {
258
+ const state = [];
259
+ for (const [id, entry] of world.nodes) {
260
+ const matrices = [];
261
+ entry.node.traverse(object => matrices.push([...object.matrixWorld.elements]));
262
+ state.push([id, entry.sig, matrices]);
263
+ }
264
+ return frozenState(state);
265
+ }
266
+
267
+ export function frozenState(value) {
268
+ return JSON.stringify(value, (key, item) => Object.is(item, -0) ? '-0' : item);
269
+ }
270
+
271
+ export function assertFrozenEqual(before, after, what) {
272
+ if (before !== after) throw new Error(`frozenStatics audit: ${what} differ from the full unchanged pass`);
273
+ }
@@ -26,6 +26,14 @@ export function takeWalkSpeedHint(node, now = typeof performance === 'undefined'
26
26
  return Number.isFinite(speed) ? { speed: Math.max(0, speed), time } : undefined;
27
27
  }
28
28
 
29
+ // Play-only opt-in for ordinary userData objects. Presence (including an
30
+ // inherited or undefined field) keeps the original consumption path intact.
31
+ export function takeWalkSpeedHintIfPresent(node, now) {
32
+ const data = node.userData;
33
+ if (!('walkSpeedHint' in data) && !('walkTimeHint' in data) && !('walkHintAt' in data)) return undefined;
34
+ return takeWalkSpeedHint(node, now);
35
+ }
36
+
29
37
  // Bounds of visible geometry only (outlines and hidden pattern parts excluded).
30
38
  function boundsOf(node) {
31
39
  const bounds = new THREE.Box3();
@@ -0,0 +1,18 @@
1
+ // The immutable file map shared by play and the live editor.
2
+ import { initialFiles } from '@imports/castle.physics-2d/engine/files';
3
+
4
+ // Both the deck's own models and every import's -- same shape as the imported
5
+ // engine's own file globs: when this kit is itself an import, its models live
6
+ // under imports/<alias>/models/ in the deck being served, and a map without
7
+ // them can't resolve a kit blueprint's Model ref.
8
+ const modelModules = import.meta.glob(
9
+ ['/**/*.pxmodel', '!/node_modules/**', '!/dist/**', '!/.castle/**'],
10
+ { query: '?raw', import: 'default', eager: true }
11
+ );
12
+
13
+ export const initialFiles3D = {
14
+ ...initialFiles,
15
+ ...Object.fromEntries(
16
+ Object.entries(modelModules).map(([globPath, text]) => [globPath.replace(/^\//, ''), text])
17
+ ),
18
+ };
@@ -73,6 +73,12 @@ function partLooks(model) {
73
73
  for (const part of model.parts) {
74
74
  looks.set(part.id, readLook(part.look, base));
75
75
  }
76
+ if (later?.queue?.skipSurfaceBakes === true) {
77
+ return {
78
+ base: { ...base, outline: 0, ao: 0 },
79
+ looks: new Map([...looks].map(([id, look]) => [id, look ? { ...look, outline: 0, ao: 0 } : null])),
80
+ };
81
+ }
76
82
  return { base, looks };
77
83
  }
78
84
 
@@ -383,6 +389,7 @@ function setOutlineAttributes(geometry, { positions, slots, smooth, bySlot }) {
383
389
  // returned says where each part will lie in the merged geometry
384
390
  // (`outlineMergedLater`).
385
391
  export function outlinePartByPart(geometries) {
392
+ if (later?.queue?.skipSurfaceBakes === true) return null;
386
393
  if (!later) {
387
394
  geometries.forEach(addOutlineAttributes);
388
395
  return null;
@@ -6,28 +6,14 @@
6
6
  // the files API instead of forcing a context reload (the glob puts models in
7
7
  // vite's module graph, which the imported hook would read as "code changed").
8
8
  import { useEffect, useRef, useState } from 'react';
9
+ import { initialFiles3D } from './initialModelFiles';
10
+ export { initialFiles3D } from './initialModelFiles';
9
11
  import { onFilesChanged } from 'castle-web-sdk';
10
- import { initialFiles, initialMedia, isImageFile } from '@imports/castle.physics-2d/engine/files';
12
+ import { initialMedia, isImageFile } from '@imports/castle.physics-2d/engine/files';
11
13
  import { hydrateDeclaredFiles } from '@imports/castle.physics-2d/engine/liveReload';
12
14
  import { parseFull } from '@imports/castle.physics-2d/engine/pxart';
13
15
  import { imageArt } from '@imports/castle.physics-2d/engine/art';
14
16
 
15
- // Both the deck's own models and every import's -- same shape as the imported
16
- // engine's own file globs: when this kit is itself an import, its models live
17
- // under imports/<alias>/models/ in the deck being served, and a map without
18
- // them can't resolve a kit blueprint's Model ref.
19
- const modelModules = import.meta.glob(
20
- ['/**/*.pxmodel', '!/node_modules/**', '!/dist/**', '!/.castle/**'],
21
- { query: '?raw', import: 'default', eager: true }
22
- );
23
-
24
- export const initialFiles3D = {
25
- ...initialFiles,
26
- ...Object.fromEntries(
27
- Object.entries(modelModules).map(([globPath, text]) => [globPath.replace(/^\//, ''), text])
28
- ),
29
- };
30
-
31
17
  const DATA_EXTS = ['.scene', '.sprite', '.pxart', '.drawing', '.pxmodel'];
32
18
  const CODE_EXTS = ['.js', '.jsx', '.ts', '.tsx', '.css'];
33
19
 
@@ -0,0 +1,49 @@
1
+ // Shared numeric and point helpers for procedural model geometry.
2
+ import * as THREE from 'three';
3
+
4
+ export function points2(list) {
5
+ if (!Array.isArray(list)) {
6
+ return [];
7
+ }
8
+ return list
9
+ .filter((p) => Array.isArray(p) && Number.isFinite(p[0]) && Number.isFinite(p[1]))
10
+ .map((p) => new THREE.Vector2(p[0], p[1]));
11
+ }
12
+
13
+ export function points3(list) {
14
+ if (!Array.isArray(list)) {
15
+ return [];
16
+ }
17
+ return list
18
+ .filter((p) => Array.isArray(p) && p.slice(0, 3).every(Number.isFinite))
19
+ .map((p) => new THREE.Vector3(p[0], p[1], p[2]));
20
+ }
21
+
22
+ export function clampInt(value, min, max, fallback) {
23
+ if (!Number.isFinite(value)) {
24
+ return fallback;
25
+ }
26
+ return Math.max(min, Math.min(max, Math.round(value)));
27
+ }
28
+
29
+ // Cage UVs may have only two coordinates; cage operations keep their strict Z policy.
30
+ export function average(points, fillMissingZ = false) {
31
+ const sum = [0, 0, 0];
32
+ for (const point of points) {
33
+ sum[0] += point[0];
34
+ sum[1] += point[1];
35
+ sum[2] += fillMissingZ ? (point[2] ?? 0) : point[2];
36
+ }
37
+ return sum.map((value) => value / Math.max(1, points.length));
38
+ }
39
+
40
+ // Mulberry32; branches retain their original +17 seed offset.
41
+ export function seededRandom(seed, offset = 0) {
42
+ let state = Math.round(seed * 9973 + offset) | 0;
43
+ return () => {
44
+ state = (state + 0x6d2b79f5) | 0;
45
+ let t = Math.imul(state ^ (state >>> 15), 1 | state);
46
+ t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
47
+ return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
48
+ };
49
+ }
@@ -0,0 +1,16 @@
1
+ // Call before retaining, cloning or measuring an actor's model. A waiting
2
+ // actor's whole shared key fills synchronously through the usual fill path.
3
+ // Dormant without engine.load; callers must look up the entry again because
4
+ // a signature edit can replace it. This module pulls no renderer into readers.
5
+ export function ensureActorModel(world, actorId) {
6
+ world?.modelLoad?.ensureActor(actorId);
7
+ }
8
+
9
+ // Legacy physics-2d has no per-consumer fence. Check at every dispatch
10
+ // boundary physics-3d owns; absent keys and capable runtimes do no work here.
11
+ // actorId restricts a collision check to that actor's waiting entry.
12
+ export function prepareModelConsumers(world, runtime, actorId) {
13
+ if (runtime.callsBeforeBehavior === true) return;
14
+ const load = world?.modelLoad;
15
+ if (load?.runtime === runtime && load.pending.size) load.prepareConsumers(actorId);
16
+ }
@@ -7,7 +7,7 @@
7
7
  // and sets its channels outright; motion here adds to what it leaves.
8
8
 
9
9
  import { checkEmptyPass } from './emptynodes.js';
10
- import { modelWalk, takeWalkSpeedHint, walkGait } from './gait.js';
10
+ import { modelWalk, takeWalkSpeedHint, takeWalkSpeedHintIfPresent, walkGait } from './gait.js';
11
11
 
12
12
  const DEG = Math.PI / 180;
13
13
  const TAU = Math.PI * 2;
@@ -559,10 +559,10 @@ function setupMotion(entry, actor) {
559
559
  // animateModelParts, with the actor whose clips to play (optional). dt of 0
560
560
  // (editor views) leaves the model in its rest pose. The first call finds the
561
561
  // parts and moves nothing.
562
- export function animateMotion(entry, dt, actor = null, world) {
562
+ export function animateMotion(entry, dt, actor = null, world, skipEmptyHints = false) {
563
563
  let hint;
564
564
  if (walkGait() === 'model') {
565
- hint = entry.walkFrameHint ?? takeWalkSpeedHint(entry.node);
565
+ hint = entry.walkFrameHint ?? (skipEmptyHints ? takeWalkSpeedHintIfPresent(entry.node) : takeWalkSpeedHint(entry.node));
566
566
  delete entry.walkFrameHint;
567
567
  }
568
568
  if (!(dt > 0)) {
@@ -145,7 +145,56 @@
145
145
  // drops it all. The map, and a
146
146
  // blur map were there ever one, are taken off the shadow before they are
147
147
  // disposed, once.
148
+ //
149
+ // Optional `"cacheStill": true` under the same `engine.shadows` object:
150
+ //
151
+ // The existing whole-texel box placement is unchanged. Still casters are
152
+ // under this runtime's adopted/frozen ActorNodes; touched, thawed, spawned,
153
+ // skinned, morphed, instanced or texture-dependent depth casters stay live.
154
+ // stillshadows.js keeps an extra packed-depth target with a hardware depth
155
+ // texture. Its key is the snapped matrix, projection, runtime/still
156
+ // version, frozen epoch, render camera/scene/layers, and selected still
157
+ // casters (including matrices, geometry and depth material). A changed
158
+ // key draws the ordinary pass: no copy or still-map rebuild. Only after
159
+ // STABLE_FRAMES (3) consecutive engine frames with the same complete key
160
+ // does it build, then reuse, the still map. Repeated renders in one frame
161
+ // do not advance that count. Key buffers and selection arrays are reused;
162
+ // existing casters need no descriptor allocations to compute the key.
163
+ // Continuous movement therefore adds key computation only, rather than a
164
+ // depth pass and copy each frame. Checking the selection preserves
165
+ // exact view-slice culling, even past `distance`; it can invalidate inside
166
+ // one snapped box. Caching the full box would change that picture.
167
+ //
168
+ // r180 WebGLShadowMap clears unconditionally, but calls updateMatrices
169
+ // after clearing/setting the viewport and before drawing. There the cache
170
+ // draws one fullscreen triangle copying BOTH packed colour and hardware
171
+ // depth into the live map on a hit or the qualified build frame. Movers
172
+ // draw normally without another clear. Once a key qualifies, a nested
173
+ // shadow-only pass builds the still target first;
174
+ // it saves/restores the live target and uses the same viewport size. No
175
+ // receiver shader changes or renderer settings. Another three revision,
176
+ // reversed/logarithmic depth, or an unhookable pass draws ordinary near
177
+ // shadows. Custom shadow callbacks or unwritable cast flags make the frame
178
+ // uncached, as do custom depth rules whose result depends on draw order.
179
+ //
180
+ // Only with this extra key, a shadowMap.render hook wraps the fade's hook
181
+ // during that one render call. It calls the original pass per light,
182
+ // and bypasses the cache for a different actual render camera or scene:
183
+ // those renders draw the ordinary pass and do not alter the primary key.
184
+ // Selection and rebuild use the hook's actual camera and scene. It restores
185
+ // temporarily suppressed castShadow flags before the next light
186
+ // or colour pass. The fade puts original materials back before both depth
187
+ // passes; receiver variants and shaders are unchanged. A private triangle
188
+ // with an invisible material is attached before a build can qualify, with
189
+ // all layers enabled, so any camera's object walk uploads and tracks its
190
+ // geometry without submitting a colour draw. It detaches at the primary
191
+ // shadow pass; unrelated renders leave it for that walk. giveBack
192
+ // removes it and the hooks and restores flags before disposal or a plain
193
+ // nested frame. All cache resources detach and free with the near shadow
194
+ // on every exit, throw and dispose, including removal of cacheStill itself.
195
+ // Absent/false acquires no cache objects, maps, hooks, walks or shaders.
148
196
  import * as THREE from 'three';
197
+ import { StillShadows, canCacheStill } from './stillshadows.js';
149
198
 
150
199
  // How far from the point it shades three.js's shader may read the shadow map,
151
200
  // across the light: what the outline is pushed out by and the box made wider
@@ -276,6 +325,9 @@ function defineNearShadow(DirectionalLightShadow) {
276
325
  points.push([point.dot(axisX), point.dot(axisY)]);
277
326
  }
278
327
  outlineSides(this.slice.sides, points, axisX, axisY, this.margin);
328
+ // WebGLShadowMap has cleared and set the viewport, but has not drawn
329
+ // any casters yet. The optional cache seeds colour AND hardware depth.
330
+ this.stillCache?.draw(light);
279
331
  }
280
332
 
281
333
  // The camera at `target + offset` looking at `target`, and the matrices that
@@ -290,19 +342,24 @@ function defineNearShadow(DirectionalLightShadow) {
290
342
  // have made) off before disposing it, so nothing that runs from its
291
343
  // `dispose` finds it here.
292
344
  release() {
293
- const { map, mapPass } = this;
345
+ const { map, mapPass, stillCache } = this;
294
346
  this.map = null;
295
347
  this.mapPass = null;
348
+ this.stillCache = null;
296
349
  // Both are off the shadow before either is disposed, and a `dispose`
297
350
  // listener that throws does not keep the other from being freed.
298
351
  // One bracket spans both maps and all their listeners. Empty releases
299
352
  // and unchanged frames neither call out nor allocate this operation.
300
- if (!map && !mapPass) return;
353
+ if (!map && !mapPass && !stillCache) return;
301
354
  const dispose = () => {
302
355
  try {
303
- if (map) map.dispose();
356
+ stillCache?.dispose();
304
357
  } finally {
305
- if (mapPass) mapPass.dispose();
358
+ try {
359
+ if (map) map.dispose();
360
+ } finally {
361
+ if (mapPass) mapPass.dispose();
362
+ }
306
363
  }
307
364
  };
308
365
  if (this.onCallout) this.onCallout(dispose);
@@ -342,7 +399,8 @@ function shadowSettings(world) {
342
399
  function giveBack(state) {
343
400
  const frame = state.frame;
344
401
  state.frame = null;
345
- if (frame && frame.sun.shadow === frame.near) frame.sun.shadow = frame.own;
402
+ if (frame && (frame.sun.shadow === frame.near || frame.sun.shadow === frame.cache?.shadow)) frame.sun.shadow = frame.own;
403
+ frame?.cache?.end();
346
404
  if (frame?.fade) frame.fade.end();
347
405
  }
348
406
 
@@ -378,7 +436,7 @@ export function dropNearShadows(world) {
378
436
  // release operation when a map's disposal can run listeners. `fade` (the
379
437
  // scene has the orbit camera key as well, shadowfade.js) fades the far edge
380
438
  // of a frame the mode draws; a plain frame is drawn the same either way.
381
- export function renderWithNearShadows(world, distance, fitBias, render, onCallout, fade) {
439
+ export function renderWithNearShadows(world, distance, fitBias, render, onCallout, fade, runtime) {
382
440
  const state = world.nearShadows ?? newState(world, onCallout);
383
441
  if (state.depth > 0) {
384
442
  // Term 2: entered from inside another call. Plain, and nothing is made.
@@ -394,7 +452,7 @@ export function renderWithNearShadows(world, distance, fitBias, render, onCallou
394
452
  let returned = false;
395
453
  try {
396
454
  try {
397
- drawn = guardedFrame(world, state, distance, fitBias, render, fade);
455
+ drawn = guardedFrame(world, state, distance, fitBias, render, fade, runtime);
398
456
  returned = true;
399
457
  } finally {
400
458
  // First what must happen whatever follows and cannot call out: the sun
@@ -418,7 +476,7 @@ function newState(world, onCallout) {
418
476
  }
419
477
 
420
478
  // The frame, inside the guard. True when the mode drew it.
421
- function guardedFrame(world, state, distance, fitBias, render, fade) {
479
+ function guardedFrame(world, state, distance, fitBias, render, fade, runtime) {
422
480
  if (!(distance > 0) || world.disposed === true || state.off) {
423
481
  leaveMode(state);
424
482
  fitBias();
@@ -431,7 +489,7 @@ function guardedFrame(world, state, distance, fitBias, render, fade) {
431
489
  const due = type !== undefined && state.lastType === type;
432
490
  state.lastType = undefined;
433
491
  fitBias();
434
- const drawn = due && nearFrame(world, state, distance, render, fade);
492
+ const drawn = due && nearFrame(world, state, distance, render, fade, runtime);
435
493
  if (!drawn) {
436
494
  leaveMode(state);
437
495
  render();
@@ -442,7 +500,7 @@ function guardedFrame(world, state, distance, fitBias, render, fade) {
442
500
 
443
501
  // Draws the frame with the mode's own shadow on the sun, if the terms hold.
444
502
  // False when they do not and nothing has been drawn.
445
- function nearFrame(world, state, distance, render, fade) {
503
+ function nearFrame(world, state, distance, render, fade, runtime) {
446
504
  const sun = sunOf(world);
447
505
  if (!sun) return false;
448
506
  state.shadow ??= makeNearShadow(state.onCallout);
@@ -451,11 +509,20 @@ function nearFrame(world, state, distance, render, fade) {
451
509
  // Fitting may free a map of the wrong size, whose `dispose` runs someone
452
510
  // else's code: a call from there has left the mode.
453
511
  if (!fit(frame.near, frame.own, world, distance) || state.frame !== frame) return false;
512
+ const cacheStill = runtime?.data?.engine?.shadows?.cacheStill === true && canCacheStill(world.renderer, world.scene);
513
+ if (!cacheStill && frame.near.stillCache) frame.near.release();
514
+ if (state.frame !== frame) return false;
515
+ if (cacheStill) {
516
+ frame.cache = frame.near.stillCache ??= new StillShadows(world, frame.near);
517
+ }
454
518
  sun.shadow = frame.near;
455
519
  if (fade) {
456
520
  frame.fade = fade;
457
521
  fade.begin(frame.near.reach, sun);
458
522
  }
523
+ // Outside the fade's hook, so it restores originals before either depth
524
+ // pass, and giveBack removes the two hooks in the opposite order.
525
+ frame.cache?.begin(frame, runtime);
459
526
  render();
460
527
  return true;
461
528
  }