castle-web-cli 0.4.233 → 0.4.234

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (381) hide show
  1. package/dist/api.d.ts +11 -0
  2. package/dist/api.js +43 -0
  3. package/dist/bundle.d.ts +64 -0
  4. package/dist/bundle.js +558 -2
  5. package/dist/castle-host/host.d.ts +17 -2
  6. package/dist/castle-host/host.js +793 -36
  7. package/dist/castleJson.d.ts +20 -1
  8. package/dist/castleJson.js +44 -2
  9. package/dist/check.js +9 -2
  10. package/dist/chunkLoader.d.ts +3 -0
  11. package/dist/chunkLoader.js +111 -0
  12. package/dist/devParty.d.ts +26 -0
  13. package/dist/devParty.js +231 -0
  14. package/dist/devSaveStorage.js +4 -0
  15. package/dist/devSessionStorage.js +3 -1
  16. package/dist/devSocial.d.ts +24 -0
  17. package/dist/devSocial.js +70 -0
  18. package/dist/ide.d.ts +2 -0
  19. package/dist/ide.js +119 -15
  20. package/dist/index.js +8 -2
  21. package/dist/init.js +1 -1
  22. package/dist/save-deck.d.ts +20 -1
  23. package/dist/save-deck.js +141 -5
  24. package/dist/serve.js +29 -11
  25. package/dist/shell/assets/{index-BjOxR-lW.js → index-DulbYIJm.js} +97 -97
  26. package/dist/shell/index.html +1 -1
  27. package/dist/vitePlugins.d.ts +2 -1
  28. package/dist/vitePlugins.js +13 -0
  29. package/kits/base/castle.json +1 -1
  30. package/kits/base/sdk/README.md +260 -3
  31. package/kits/base/sdk/castle.d.ts +7 -3
  32. package/kits/base/sdk/castle.js +2 -0
  33. package/kits/base/sdk/commands.d.ts +162 -1
  34. package/kits/base/sdk/commands.js +3 -0
  35. package/kits/base/sdk/display.d.ts +3 -0
  36. package/kits/base/sdk/display.js +9 -3
  37. package/kits/base/sdk/hub.d.ts +33 -6
  38. package/kits/base/sdk/hub.js +50 -4
  39. package/kits/base/sdk/multiplayer.d.ts +7 -1
  40. package/kits/base/sdk/multiplayer.js +140 -40
  41. package/kits/base/sdk/multiplayerProtocol.d.ts +2 -0
  42. package/kits/base/sdk/party.d.ts +23 -0
  43. package/kits/base/sdk/party.js +91 -0
  44. package/kits/base/sdk/reconnectBudget.d.ts +23 -0
  45. package/kits/base/sdk/reconnectBudget.js +96 -0
  46. package/kits/base/sdk/save.d.ts +38 -1
  47. package/kits/base/sdk/save.js +79 -6
  48. package/kits/base/sdk/server/hub.d.ts +31 -1
  49. package/kits/base/sdk/server/hub.js +50 -3
  50. package/kits/base/sdk/server/platformHandle.d.ts +13 -1
  51. package/kits/base/sdk/server/storage.d.ts +4 -0
  52. package/kits/base/sdk/server/storage.js +19 -3
  53. package/kits/base/sdk/server/wrapper.d.ts +7 -1
  54. package/kits/base/sdk/server/wrapper.js +10 -1
  55. package/kits/base/sdk/social.d.ts +9 -0
  56. package/kits/base/sdk/social.js +5 -0
  57. package/kits/hub-game/CLAUDE.md +123 -3
  58. package/kits/hub-game/README.md +63 -0
  59. package/kits/hub-game/castle.json +5 -5
  60. package/kits/hub-game/code/client/act.js +312 -0
  61. package/kits/hub-game/code/client/actionLayout.js +147 -0
  62. package/kits/hub-game/code/client/actionOverflow.js +556 -0
  63. package/kits/hub-game/code/client/arrivalCamera.js +50 -0
  64. package/kits/hub-game/code/client/askSlot.js +117 -0
  65. package/kits/hub-game/code/client/avatar.js +4 -2
  66. package/kits/hub-game/code/client/avatarShare.js +2 -0
  67. package/kits/hub-game/code/client/backVisibility.js +13 -0
  68. package/kits/hub-game/code/client/ballot.js +15 -10
  69. package/kits/hub-game/code/client/build.js +16 -0
  70. package/kits/hub-game/code/client/chat.js +41 -5
  71. package/kits/hub-game/code/client/chatModeration.js +5 -0
  72. package/kits/hub-game/code/client/chrome.js +1148 -258
  73. package/kits/hub-game/code/client/crowdNames.js +241 -0
  74. package/kits/hub-game/code/client/decor.js +10 -4
  75. package/kits/hub-game/code/client/defaultEnvironment.js +194 -0
  76. package/kits/hub-game/code/client/doorErrors.js +39 -0
  77. package/kits/hub-game/code/client/fall.js +18 -0
  78. package/kits/hub-game/code/client/farAvatars.js +233 -0
  79. package/kits/hub-game/code/client/firstJoin.js +9 -2
  80. package/kits/hub-game/code/client/fpsTelemetry.js +50 -0
  81. package/kits/hub-game/code/client/frameBatch.js +5 -0
  82. package/kits/hub-game/code/client/grab.js +31 -11
  83. package/kits/hub-game/code/client/hookLayer.js +87 -8
  84. package/kits/hub-game/code/client/hudCopy.js +51 -0
  85. package/kits/hub-game/code/client/hudRate.js +20 -0
  86. package/kits/hub-game/code/client/idle.js +14 -2
  87. package/kits/hub-game/code/client/invites.js +231 -0
  88. package/kits/hub-game/code/client/joinError.js +9 -0
  89. package/kits/hub-game/code/client/labelsNear.js +31 -2
  90. package/kits/hub-game/code/client/landscapeLayout.js +17 -0
  91. package/kits/hub-game/code/client/layoutCache.js +264 -0
  92. package/kits/hub-game/code/client/loadTelemetry.js +20 -0
  93. package/kits/hub-game/code/client/loadingCover.js +148 -0
  94. package/kits/hub-game/code/client/loadingEntry.js +8 -0
  95. package/kits/hub-game/code/client/menuRows.js +43 -0
  96. package/kits/hub-game/code/client/modelReady.js +7 -0
  97. package/kits/hub-game/code/client/padCueArrival.js +23 -0
  98. package/kits/hub-game/code/client/padCues.js +112 -0
  99. package/kits/hub-game/code/client/padOccupancy.js +88 -0
  100. package/kits/hub-game/code/client/padReadability.js +26 -0
  101. package/kits/hub-game/code/client/padRings.js +69 -0
  102. package/kits/hub-game/code/client/pushVisit.js +14 -0
  103. package/kits/hub-game/code/client/quality.js +205 -0
  104. package/kits/hub-game/code/client/qualityEntry.js +55 -0
  105. package/kits/hub-game/code/client/safeLayout.js +338 -0
  106. package/kits/hub-game/code/client/safeStyle.js +42 -0
  107. package/kits/hub-game/code/client/say.js +12 -3
  108. package/kits/hub-game/code/client/shot.js +64 -10
  109. package/kits/hub-game/code/client/shotFit.js +56 -0
  110. package/kits/hub-game/code/client/signIn.js +28 -0
  111. package/kits/hub-game/code/client/state.js +53 -0
  112. package/kits/hub-game/code/client/talk.js +209 -45
  113. package/kits/hub-game/code/client/tiers.js +68 -66
  114. package/kits/hub-game/code/client/together.js +7 -2
  115. package/kits/hub-game/code/client/weakestLookBake.js +92 -0
  116. package/kits/hub-game/code/client/weakestTier.js +295 -0
  117. package/kits/hub-game/code/client/worldLabels.js +241 -0
  118. package/kits/hub-game/code/client/yours.js +10 -9
  119. package/kits/hub-game/code/npcDisplayText.js +55 -0
  120. package/kits/hub-game/code/server/act.js +124 -0
  121. package/kits/hub-game/code/server/actions.js +6 -1
  122. package/kits/hub-game/code/server/actors.js +2 -1
  123. package/kits/hub-game/code/server/analytics.js +83 -0
  124. package/kits/hub-game/code/server/anonymousEntry.js +49 -0
  125. package/kits/hub-game/code/server/arrivalPose.js +36 -0
  126. package/kits/hub-game/code/server/companion.js +28 -3
  127. package/kits/hub-game/code/server/doorAnalytics.js +52 -0
  128. package/kits/hub-game/code/server/earned.js +22 -5
  129. package/kits/hub-game/code/server/frameBatch.js +183 -0
  130. package/kits/hub-game/code/server/friendsAmong.js +49 -9
  131. package/kits/hub-game/code/server/history.js +2 -0
  132. package/kits/hub-game/code/server/hub.js +1306 -95
  133. package/kits/hub-game/code/server/idle.js +30 -1
  134. package/kits/hub-game/code/server/index.js +26 -4
  135. package/kits/hub-game/code/server/invites.js +19 -0
  136. package/kits/hub-game/code/server/labels.js +9 -1
  137. package/kits/hub-game/code/server/loadAbandon.js +106 -0
  138. package/kits/hub-game/code/server/manifest.js +211 -3
  139. package/kits/hub-game/code/server/menu.js +31 -3
  140. package/kits/hub-game/code/server/npcs.js +226 -64
  141. package/kits/hub-game/code/server/observe.js +408 -0
  142. package/kits/hub-game/code/server/padOccupancy.js +85 -0
  143. package/kits/hub-game/code/server/players.js +9 -1
  144. package/kits/hub-game/code/server/resumePose.js +152 -0
  145. package/kits/hub-game/code/server/say.js +1 -1
  146. package/kits/hub-game/code/server/standing.js +4 -5
  147. package/kits/hub-game/code/server/storageLimit.js +187 -0
  148. package/kits/hub-game/code/server/vis.js +67 -5
  149. package/kits/hub-game/code/shared/act.js +35 -0
  150. package/kits/hub-game/code/shared/danceIdle.js +28 -0
  151. package/kits/hub-game/code/shared/loadStages.js +12 -0
  152. package/kits/hub-game/code/shared/quality.js +74 -0
  153. package/kits/hub-game/code/shared/say.js +2 -0
  154. package/kits/hub-game/code/shared/shot.js +35 -1
  155. package/kits/hub-game/code/systems/hub.js +970 -169
  156. package/kits/hub-game/docs/analytics.md +279 -0
  157. package/kits/hub-game/docs/contract.md +1257 -42
  158. package/kits/hub-game/docs/home-pieces.md +9 -2
  159. package/kits/hub-game/docs/observed-progress.md +252 -0
  160. package/kits/hub-game/main.jsx +2 -0
  161. package/kits/hub-game/package-lock.json +10 -3
  162. package/kits/hub-game/package.json +6 -3
  163. package/kits/hub-game/play/player.js +142 -0
  164. package/kits/hub-game/play/registry.js +47 -0
  165. package/kits/hub-game/play.jsx +37 -0
  166. package/kits/hub-game/scripts/check.mjs +39 -5
  167. package/kits/hub-game/scripts/companion-follower-wire.json +1 -1
  168. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +11 -0
  169. package/kits/hub-game/scripts/fixtures/decor-keyless.json +5 -5
  170. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +3 -0
  171. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +19 -3
  172. package/kits/hub-game/scripts/fixtures/interest-legacy.json +3 -3
  173. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -1
  174. package/kits/hub-game/scripts/pose-storage-fixture.mjs +46 -0
  175. package/kits/hub-game/scripts/test-act-client.mjs +186 -0
  176. package/kits/hub-game/scripts/test-act.mjs +171 -0
  177. package/kits/hub-game/scripts/test-action-layout.mjs +80 -0
  178. package/kits/hub-game/scripts/test-action-observers.mjs +46 -0
  179. package/kits/hub-game/scripts/test-actions-client.mjs +367 -2
  180. package/kits/hub-game/scripts/test-actors.mjs +20 -7
  181. package/kits/hub-game/scripts/test-analytics.mjs +76 -0
  182. package/kits/hub-game/scripts/test-anonymous-entry.mjs +28 -0
  183. package/kits/hub-game/scripts/test-arrival-pose-server.mjs +196 -0
  184. package/kits/hub-game/scripts/test-arrival-pose.mjs +24 -0
  185. package/kits/hub-game/scripts/test-ask-slot.mjs +85 -0
  186. package/kits/hub-game/scripts/test-avatar-wire.mjs +49 -10
  187. package/kits/hub-game/scripts/test-avatar.mjs +44 -0
  188. package/kits/hub-game/scripts/test-back-visibility.mjs +82 -0
  189. package/kits/hub-game/scripts/test-ballot.mjs +11 -4
  190. package/kits/hub-game/scripts/test-ban-join.mjs +121 -13
  191. package/kits/hub-game/scripts/test-build.mjs +20 -2
  192. package/kits/hub-game/scripts/test-chat.mjs +206 -5
  193. package/kits/hub-game/scripts/test-companion-chat.mjs +20 -2
  194. package/kits/hub-game/scripts/test-control-layout-dom.mjs +120 -0
  195. package/kits/hub-game/scripts/test-crowd-names.mjs +205 -0
  196. package/kits/hub-game/scripts/test-decor-client.mjs +45 -4
  197. package/kits/hub-game/scripts/test-decor.mjs +7 -0
  198. package/kits/hub-game/scripts/test-default-environment-root.mjs +95 -0
  199. package/kits/hub-game/scripts/test-default-environment.mjs +267 -0
  200. package/kits/hub-game/scripts/test-door-analytics.mjs +58 -0
  201. package/kits/hub-game/scripts/test-door-jump.mjs +100 -0
  202. package/kits/hub-game/scripts/test-earned.mjs +33 -3
  203. package/kits/hub-game/scripts/test-far-avatars.mjs +340 -0
  204. package/kits/hub-game/scripts/test-fps-telemetry.mjs +112 -0
  205. package/kits/hub-game/scripts/test-frame-batch.mjs +252 -0
  206. package/kits/hub-game/scripts/test-fresh-friends.mjs +118 -0
  207. package/kits/hub-game/scripts/test-grab-orbit.mjs +47 -4
  208. package/kits/hub-game/scripts/test-high-only.mjs +170 -0
  209. package/kits/hub-game/scripts/test-hub-ops.mjs +321 -2
  210. package/kits/hub-game/scripts/test-hub-trip.mjs +879 -11
  211. package/kits/hub-game/scripts/test-hud-clear.mjs +162 -59
  212. package/kits/hub-game/scripts/test-hud-defects-dom.mjs +100 -0
  213. package/kits/hub-game/scripts/test-hud-rate.mjs +224 -0
  214. package/kits/hub-game/scripts/test-hud-safe-visibility-dom.mjs +83 -0
  215. package/kits/hub-game/scripts/test-idle.mjs +66 -0
  216. package/kits/hub-game/scripts/test-interest-cells.mjs +20 -0
  217. package/kits/hub-game/scripts/test-interest.mjs +15 -0
  218. package/kits/hub-game/scripts/test-invites-client.mjs +430 -0
  219. package/kits/hub-game/scripts/test-invites.mjs +109 -0
  220. package/kits/hub-game/scripts/test-labels.mjs +71 -3
  221. package/kits/hub-game/scripts/test-landscape-layout.mjs +194 -0
  222. package/kits/hub-game/scripts/test-list-scroll-dom.mjs +49 -0
  223. package/kits/hub-game/scripts/test-load-abandon.mjs +246 -0
  224. package/kits/hub-game/scripts/test-loading-cover.mjs +162 -0
  225. package/kits/hub-game/scripts/test-manifest.mjs +265 -0
  226. package/kits/hub-game/scripts/test-menu-client.mjs +105 -0
  227. package/kits/hub-game/scripts/test-menu.mjs +23 -0
  228. package/kits/hub-game/scripts/test-npcs.mjs +819 -10
  229. package/kits/hub-game/scripts/test-observed.mjs +745 -0
  230. package/kits/hub-game/scripts/test-pad-cues.mjs +304 -0
  231. package/kits/hub-game/scripts/test-pad-occupancy.mjs +177 -0
  232. package/kits/hub-game/scripts/test-picker.mjs +234 -7
  233. package/kits/hub-game/scripts/test-placement-cache.mjs +690 -0
  234. package/kits/hub-game/scripts/test-progress-reset.mjs +559 -0
  235. package/kits/hub-game/scripts/test-push-visit.mjs +26 -0
  236. package/kits/hub-game/scripts/test-quality.mjs +385 -0
  237. package/kits/hub-game/scripts/test-rehello.mjs +699 -5
  238. package/kits/hub-game/scripts/test-resume-action-order.mjs +598 -0
  239. package/kits/hub-game/scripts/test-resume-held.mjs +239 -0
  240. package/kits/hub-game/scripts/test-resume-pose.mjs +142 -0
  241. package/kits/hub-game/scripts/test-safe-events-dom.mjs +116 -0
  242. package/kits/hub-game/scripts/test-safe-layout.mjs +330 -0
  243. package/kits/hub-game/scripts/test-say.mjs +1 -1
  244. package/kits/hub-game/scripts/test-shot.mjs +145 -0
  245. package/kits/hub-game/scripts/test-signin-client.mjs +45 -0
  246. package/kits/hub-game/scripts/test-soundscape.mjs +22 -17
  247. package/kits/hub-game/scripts/test-standing.mjs +35 -2
  248. package/kits/hub-game/scripts/test-storage-limit.mjs +333 -0
  249. package/kits/hub-game/scripts/test-stuck.mjs +5 -4
  250. package/kits/hub-game/scripts/test-talk-overlay-dom.mjs +130 -0
  251. package/kits/hub-game/scripts/test-tiers-render.mjs +86 -13
  252. package/kits/hub-game/scripts/test-tiers.mjs +7 -8
  253. package/kits/hub-game/scripts/test-vis.mjs +433 -6
  254. package/kits/hub-game/scripts/test-weakest-tier.mjs +924 -0
  255. package/kits/hub-game/scripts/test-world-labels.mjs +367 -0
  256. package/kits/hub-game/scripts/test-yours-chrome.mjs +50 -6
  257. package/kits/hub-game/scripts/test-yours.mjs +39 -8
  258. package/kits/multiplayer-3d/castle.json +5 -5
  259. package/kits/multiplayer-3d/code/client/joinFailure.js +27 -0
  260. package/kits/multiplayer-3d/code/client/resumeGate.js +139 -0
  261. package/kits/multiplayer-3d/code/systems/multiplayer.js +369 -30
  262. package/kits/multiplayer-3d/package-lock.json +8 -1
  263. package/kits/multiplayer-3d/package.json +2 -1
  264. package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +436 -0
  265. package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +624 -0
  266. package/kits/physics-2d/CLAUDE.md +10 -1
  267. package/kits/physics-2d/castle.json +2 -2
  268. package/kits/physics-2d/engine/frozenActors.js +233 -0
  269. package/kits/physics-2d/engine/scene.js +87 -5
  270. package/kits/physics-2d/eslint.config.js +1 -1
  271. package/kits/physics-2d/play/behaviors/AnalogStick.js +198 -0
  272. package/kits/physics-2d/play/behaviors/Camera.js +40 -0
  273. package/kits/physics-2d/play/behaviors/Collider.js +122 -0
  274. package/kits/physics-2d/play/behaviors/Draggable.js +115 -0
  275. package/kits/physics-2d/play/behaviors/Goal.js +46 -0
  276. package/kits/physics-2d/play/behaviors/Joints.js +126 -0
  277. package/kits/physics-2d/play/behaviors/Layout.js +71 -0
  278. package/kits/physics-2d/play/behaviors/RigidBody.js +57 -0
  279. package/kits/physics-2d/play/behaviors/Slingshot.js +142 -0
  280. package/kits/physics-2d/play/behaviors/SoundPlayer.js +263 -0
  281. package/kits/physics-2d/play/behaviors/Sprite.js +406 -0
  282. package/kits/physics-2d/play/behaviors/Style.js +209 -0
  283. package/kits/physics-2d/play/behaviors/Text.js +85 -0
  284. package/kits/physics-2d/play/behaviors/Video.js +93 -0
  285. package/kits/physics-3d/CLAUDE.md +25 -1651
  286. package/kits/physics-3d/behaviors/Body.jsx +3 -0
  287. package/kits/physics-3d/behaviors/Model.jsx +3 -0
  288. package/kits/physics-3d/behaviors/Player.jsx +35 -18
  289. package/kits/physics-3d/behaviors/Shape.jsx +3 -0
  290. package/kits/physics-3d/behaviors/Solid.jsx +3 -0
  291. package/kits/physics-3d/behaviors/Transform.jsx +3 -0
  292. package/kits/physics-3d/castle.json +3 -3
  293. package/kits/physics-3d/docs/engine-camera.md +542 -0
  294. package/kits/physics-3d/docs/engine-frame-cap.md +136 -0
  295. package/kits/physics-3d/docs/engine-load.md +149 -0
  296. package/kits/physics-3d/docs/engine-look.md +114 -0
  297. package/kits/physics-3d/docs/engine-shadows.md +372 -0
  298. package/kits/physics-3d/docs/engine-skip-work.md +187 -0
  299. package/kits/physics-3d/docs/engine-sky.md +198 -0
  300. package/kits/physics-3d/docs/engine-static-actors.md +226 -0
  301. package/kits/physics-3d/docs/engine-view.md +37 -0
  302. package/kits/physics-3d/docs/pxmodel-format.md +1 -1
  303. package/kits/physics-3d/engine3d/PlayOnly3D.jsx +5 -1
  304. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +19 -333
  305. package/kits/physics-3d/engine3d/actornode.js +1 -0
  306. package/kits/physics-3d/engine3d/branches.js +3 -13
  307. package/kits/physics-3d/engine3d/cage.js +2 -7
  308. package/kits/physics-3d/engine3d/cageops.js +2 -17
  309. package/kits/physics-3d/engine3d/dataBehaviors.js +12 -0
  310. package/kits/physics-3d/engine3d/framecap.js +4 -1
  311. package/kits/physics-3d/engine3d/frozenphysics.js +140 -0
  312. package/kits/physics-3d/engine3d/frozenstatics.js +273 -0
  313. package/kits/physics-3d/engine3d/gait.js +8 -0
  314. package/kits/physics-3d/engine3d/initialModelFiles.js +18 -0
  315. package/kits/physics-3d/engine3d/look.js +7 -0
  316. package/kits/physics-3d/engine3d/modelFiles.js +3 -17
  317. package/kits/physics-3d/engine3d/modelMath.js +49 -0
  318. package/kits/physics-3d/engine3d/modelready.js +16 -0
  319. package/kits/physics-3d/engine3d/motion.js +3 -3
  320. package/kits/physics-3d/engine3d/nearshadows.js +77 -10
  321. package/kits/physics-3d/engine3d/orbitinput.js +59 -25
  322. package/kits/physics-3d/engine3d/partgeometry.js +1 -16
  323. package/kits/physics-3d/engine3d/paths.js +1 -9
  324. package/kits/physics-3d/engine3d/playTimings.js +50 -0
  325. package/kits/physics-3d/engine3d/playerRun.js +372 -0
  326. package/kits/physics-3d/engine3d/pxmodel.js +3 -3
  327. package/kits/physics-3d/engine3d/rapier.js +27 -0
  328. package/kits/physics-3d/engine3d/scatter.js +1 -11
  329. package/kits/physics-3d/engine3d/shadowfade.js +23 -15
  330. package/kits/physics-3d/engine3d/sky.js +1 -1
  331. package/kits/physics-3d/engine3d/squarefirst.js +177 -0
  332. package/kits/physics-3d/engine3d/stillshadows.js +399 -0
  333. package/kits/physics-3d/engine3d/sweep.js +1 -25
  334. package/kits/physics-3d/engine3d/world3d.js +468 -18
  335. package/kits/physics-3d/eslint.config.js +2 -1
  336. package/kits/physics-3d/main.jsx +6 -3
  337. package/kits/physics-3d/package-lock.json +7 -0
  338. package/kits/physics-3d/package.json +5 -1
  339. package/kits/physics-3d/play/behaviors/Body.js +31 -0
  340. package/kits/physics-3d/play/behaviors/Door.js +37 -0
  341. package/kits/physics-3d/play/behaviors/Lookable.js +16 -0
  342. package/kits/physics-3d/play/behaviors/Model.js +23 -0
  343. package/kits/physics-3d/play/behaviors/Pickup.js +46 -0
  344. package/kits/physics-3d/play/behaviors/Player.js +1204 -0
  345. package/kits/physics-3d/play/behaviors/Shape.js +47 -0
  346. package/kits/physics-3d/play/behaviors/Solid.js +16 -0
  347. package/kits/physics-3d/play/behaviors/Transform.js +29 -0
  348. package/kits/physics-3d/pnpm-lock.yaml +8 -0
  349. package/kits/physics-3d/scripts/bench-shadow-fade.mjs +37 -0
  350. package/kits/physics-3d/scripts/build-rapier-gz.mjs +56 -0
  351. package/kits/physics-3d/scripts/frozen-statics-fixture.mjs +141 -0
  352. package/kits/physics-3d/scripts/test-camera-follow.mjs +5 -1
  353. package/kits/physics-3d/scripts/test-camera-orbit.mjs +52 -4
  354. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +1 -1
  355. package/kits/physics-3d/scripts/test-empty-gait-hints.mjs +89 -0
  356. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +6 -3
  357. package/kits/physics-3d/scripts/test-frame-cap.mjs +1 -1
  358. package/kits/physics-3d/scripts/test-frozen-nested.mjs +49 -0
  359. package/kits/physics-3d/scripts/test-frozen-statics-legacy-physics2d.mjs +123 -0
  360. package/kits/physics-3d/scripts/test-frozen-statics.mjs +434 -0
  361. package/kits/physics-3d/scripts/test-look-bake.mjs +1 -1
  362. package/kits/physics-3d/scripts/test-near-shadows.mjs +2 -2
  363. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +88 -7
  364. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +40 -3
  365. package/kits/physics-3d/scripts/test-orbit-shot.mjs +75 -1
  366. package/kits/physics-3d/scripts/test-rapier-gz.mjs +106 -0
  367. package/kits/physics-3d/scripts/test-sky.mjs +1 -1
  368. package/kits/physics-3d/scripts/test-square-first.mjs +921 -0
  369. package/kits/physics-3d/scripts/test-static-actors.mjs +3 -1
  370. package/kits/physics-3d/scripts/test-static-physics.mjs +4 -1
  371. package/kits/physics-3d/scripts/test-static-scenery.mjs +5 -2
  372. package/kits/physics-3d/scripts/test-steady-hover.mjs +5 -2
  373. package/kits/physics-3d/scripts/test-still-shadows.mjs +477 -0
  374. package/kits/physics-3d/systems/physics3d.js +37 -4
  375. package/kits/real-time/castle.json +2 -2
  376. package/kits/real-time/code/client/connection.js +33 -10
  377. package/kits/real-time/code/client/gameHooks.js +2 -0
  378. package/kits/real-time/code/client/joinOverlay.js +9 -4
  379. package/kits/real-time/code/server/session.js +6 -4
  380. package/kits/real-time/package-lock.json +1 -1
  381. package/package.json +2 -2
@@ -0,0 +1,399 @@
1
+ // The opt-in still-caster cache of nearshadows.js. All work happens inside
2
+ // its one renderer.render call. Receivers keep three's ordinary PCF shader.
3
+ import * as THREE from 'three';
4
+ import { ActorNode, isFrozen } from './actornode.js';
5
+
6
+ // Misses draw normally; pay to build only after the complete key settles.
7
+ export const STABLE_FRAMES = 3;
8
+
9
+ // The ordering this uses is pinned to r180 WebGLShadowMap: clear, viewport,
10
+ // updateMatrices, getFrustum, draw. A different renderer draws uncached.
11
+ export function canCacheStill(renderer, scene) {
12
+ const descriptor = Object.getOwnPropertyDescriptor(renderer.shadowMap, 'render');
13
+ return THREE.REVISION === '180' && typeof renderer.renderBufferDirect === 'function' &&
14
+ !renderer.capabilities.reversedDepthBuffer && !renderer.capabilities.logarithmicDepthBuffer &&
15
+ descriptor?.writable === true && descriptor.configurable === true && typeof descriptor.value === 'function' &&
16
+ scene.onBeforeRender === THREE.Object3D.prototype.onBeforeRender && Object.isExtensible(scene.children);
17
+ }
18
+
19
+ // A still node does not promise that a shader, skin or morph stands still.
20
+ // Those casters remain movers. Alpha/displacement also depend on textures
21
+ // whose upload/readiness can change without touching an actor.
22
+ function plainDepthMaterial(material) {
23
+ return material && !material.alphaTest && !material.alphaHash && !material.alphaToCoverage &&
24
+ !material.displacementMap && !material.clippingPlanes?.length && !material.wireframe;
25
+ }
26
+
27
+ function plainDepth(object) {
28
+ if (object.isSkinnedMesh || object.isInstancedMesh || object.morphTargetInfluences?.length || object.customDepthMaterial) return false;
29
+ const material = object.material;
30
+ return Array.isArray(material) ? material.every(plainDepthMaterial) : plainDepthMaterial(material);
31
+ }
32
+
33
+ // Reordering a depth-only caster around the cached ones is sound only for
34
+ // an ordinary nearest-depth winner. Custom blending/write/test rules can
35
+ // make draw order significant, so those frames use the original pass.
36
+ function mergeableDepth(object) {
37
+ const depth = object.customDepthMaterial;
38
+ return !depth || (depth.depthTest === true && depth.depthWrite === true && depth.colorWrite === true &&
39
+ depth.depthFunc === THREE.LessEqualDepth && depth.onBeforeCompile === THREE.Material.prototype.onBeforeCompile &&
40
+ (depth.blending === THREE.NoBlending || (depth.blending === THREE.NormalBlending && depth.transparent === false)));
41
+ }
42
+
43
+ function passHook(had) {
44
+ const hook = {
45
+ had, cache: null,
46
+ render(lights, scene, camera) { return hook.cache ? hook.cache.render(lights, scene, camera) : had.call(this, lights, scene, camera); },
47
+ };
48
+ return hook;
49
+ }
50
+
51
+ function sameNumbers(a, b) {
52
+ if (a.length !== b.length) return false;
53
+ for (let i = 0; i < a.length; i++) if (a[i] !== b[i]) return false;
54
+ return true;
55
+ }
56
+
57
+ export class StillShadows {
58
+ constructor(world, near) {
59
+ this.world = world;
60
+ this.near = near;
61
+ this.shadow = new THREE.DirectionalLight().shadow;
62
+ // The sun's actual position is never used to place this second camera.
63
+ this.shadow.updateMatrices = () => {};
64
+ this.shadow.getFrustum = () => near.getFrustum();
65
+ this.oneLight = [];
66
+ this.casters = [];
67
+ this.stillFlags = [];
68
+ this.writableFlags = new WeakMap();
69
+ this.hidden = [];
70
+ this.hiddenCount = 0;
71
+ this.was = [];
72
+ this.now = [];
73
+ this.stableFrames = 0;
74
+ this.frameNumber = 0;
75
+ this.observedAt = 0;
76
+ this.valid = false;
77
+ this.frame = null;
78
+ this.inSun = false;
79
+ this.hook = null;
80
+ }
81
+
82
+ begin(frame, runtime) {
83
+ this.frame = frame;
84
+ this.frameNumber += 1;
85
+ this.runtime = runtime;
86
+ this.pass = this.world.renderer.shadowMap;
87
+ this.had = this.pass.render;
88
+ if (this.hook?.had !== this.had) this.hook = passHook(this.had);
89
+ this.hook.cache = this;
90
+ this.pass.render = this.hook.render;
91
+ if (this.valid || this.stableFrames !== STABLE_FRAMES - 1) return;
92
+ this.makeCopy();
93
+ // Register/upload the geometry through three's ordinary object walk.
94
+ // An invisible material submits no colour draw; renderBufferDirect
95
+ // below still draws it. Attach/detach without dispatching deck events.
96
+ this.triangle.parent = this.world.scene;
97
+ this.world.scene.children.push(this.triangle);
98
+ }
99
+
100
+ // Split only the shadow pass, preserving its light order. Cast flags are
101
+ // restored before any other light or the colour pass sees the scene.
102
+ // The held fade hook restores original materials before either depth pass.
103
+ render(lights, scene, camera) {
104
+ if (!this.frame) return this.had.call(this.pass, lights, scene, camera);
105
+ // A nested render may use this renderer and sun with another view. It
106
+ // must neither seed from nor change the primary view's candidate key.
107
+ if (scene !== this.world.scene || camera !== this.near.view) {
108
+ const inSun = this.inSun;
109
+ this.inSun = false;
110
+ try { return this.had.call(this.pass, lights, scene, camera); }
111
+ finally { this.inSun = inSun; }
112
+ }
113
+ this.renderScene = scene;
114
+ this.renderCamera = camera;
115
+ // Geometry registration is done; no deck's shadow/colour callback sees
116
+ // the private upload mesh in the scene graph.
117
+ this.detach();
118
+ for (let i = 0; i < lights.length; i++) {
119
+ const light = lights[i];
120
+ this.oneLight[0] = light;
121
+ this.inSun = light === this.frame?.sun;
122
+ try {
123
+ this.had.call(this.pass, this.oneLight, scene, camera);
124
+ } finally {
125
+ this.restore();
126
+ this.inSun = false;
127
+ }
128
+ }
129
+ this.oneLight[0] = null;
130
+ }
131
+
132
+ current() {
133
+ return this.frame && this.world.nearShadows?.frame === this.frame && this.frame.sun.shadow === this.near;
134
+ }
135
+
136
+ // Called after the live map's clear. A nested WebGLShadowMap pass saves
137
+ // and restores that target, and uses exactly the same size and viewport;
138
+ // the outer pass re-reads its frustum immediately after this returns.
139
+ draw(light) {
140
+ if (!this.inSun || !this.current()) return;
141
+ this.casterCount = 0;
142
+ this.stillCount = 0;
143
+ this.keyLength = 0;
144
+ const runtime = this.runtime;
145
+ const now = this.now;
146
+ now[this.keyLength++] = runtime;
147
+ now[this.keyLength++] = runtime.stillVersion;
148
+ now[this.keyLength++] = this.world.skipping?.epoch;
149
+ now[this.keyLength++] = light;
150
+ now[this.keyLength++] = this.renderScene;
151
+ now[this.keyLength++] = this.renderCamera;
152
+ now[this.keyLength++] = this.renderCamera.layers.mask;
153
+ this.recordMatrix(this.near.matrix);
154
+ this.recordMatrix(this.near.camera.projectionMatrix);
155
+ this.frustum = this.near.getFrustum();
156
+ const eligible = this.collect(this.renderScene, false);
157
+ this.casters.length = this.stillFlags.length = this.casterCount;
158
+ now.length = this.keyLength;
159
+ if (!eligible || this.stillCount === 0) {
160
+ this.valid = false;
161
+ this.stableFrames = 0;
162
+ this.was.length = this.now.length = 0;
163
+ return;
164
+ }
165
+ const lostMap = this.valid && this.shadow.map && this.world.renderer.properties?.has && !this.world.renderer.properties.has(this.shadow.map.texture);
166
+ const sameFrame = this.observedAt === this.frameNumber;
167
+ if (lostMap || !sameNumbers(now, this.was) || (!sameFrame && this.observedAt !== this.frameNumber - 1)) {
168
+ this.valid = false;
169
+ this.stableFrames = 1;
170
+ this.observedAt = this.frameNumber;
171
+ this.now = this.was;
172
+ this.was = now;
173
+ return; // A miss costs only key computation over the ordinary pass.
174
+ }
175
+ if (!sameFrame) {
176
+ this.observedAt = this.frameNumber;
177
+ this.stableFrames = Math.min(STABLE_FRAMES, this.stableFrames + 1);
178
+ }
179
+ if (!this.valid) {
180
+ if (this.stableFrames < STABLE_FRAMES) return;
181
+ if (!this.mask(true)) return this.refuse();
182
+ this.allocate();
183
+ this.shadow.camera.copy(this.near.camera);
184
+ this.shadow.matrix.copy(this.near.matrix);
185
+ this.shadow.mapSize.copy(this.near.mapSize);
186
+ const renderer = this.world.renderer;
187
+ const target = renderer.getRenderTarget();
188
+ const face = renderer.getActiveCubeFace();
189
+ const mip = renderer.getActiveMipmapLevel();
190
+ light.shadow = this.shadow;
191
+ try {
192
+ this.had.call(this.pass, this.oneLight, this.renderScene, this.renderCamera);
193
+ } finally {
194
+ this.restore();
195
+ // A re-entry/dispose already gave the sun back: never undo it.
196
+ if (this.frame && light.shadow === this.shadow) light.shadow = this.near;
197
+ // WebGLShadowMap itself restores the target only on success.
198
+ if (this.current()) renderer.setRenderTarget(target, face, mip);
199
+ }
200
+ if (!this.current()) return;
201
+ this.valid = true;
202
+ }
203
+ if (!this.current()) return;
204
+ if (!this.mask(false)) return this.refuse();
205
+ const renderer = this.world.renderer;
206
+ renderer.renderBufferDirect(this.near.camera, null, this.geometry, this.material, this.triangle, null);
207
+ }
208
+
209
+ refuse() {
210
+ this.restore();
211
+ this.valid = false;
212
+ this.stableFrames = 0;
213
+ this.was.length = 0;
214
+ }
215
+
216
+ // Cache precisely the still casters the ordinary slice would draw. In
217
+ // addition to box/version changes, a changed selection invalidates it:
218
+ // caching the full box instead could add shadows beyond the view slice.
219
+ collect(object, frozen) {
220
+ if (!object.visible) return true;
221
+ if (object instanceof ActorNode) {
222
+ const adopted = this.world.stillKeeper?.adopted;
223
+ frozen = (this.world.frozenStatics?.runtime === this.runtime && object.frozenStatic === true) ||
224
+ (this.runtime.keepsStaticActors === true && this.world.stillKeeper?.running === 0 &&
225
+ adopted?.version === this.runtime.stillVersion && isFrozen(object));
226
+ }
227
+ if (object.castShadow && (object.isMesh || object.isLine || object.isPoints) && object.layers.test(this.renderCamera.layers)) {
228
+ // Inspect a new caster once. Later flag locks are caught by mask's
229
+ // Reflect.set before any copy/draw, without allocating descriptors in
230
+ // every key computation.
231
+ let writable = this.writableFlags.get(object);
232
+ if (writable === undefined) {
233
+ const descriptor = Object.getOwnPropertyDescriptor(object, 'castShadow');
234
+ writable = descriptor?.writable === true && descriptor.value === true;
235
+ this.writableFlags.set(object, writable);
236
+ }
237
+ // Callbacks could observe the temporary flags or mutate other casters.
238
+ // Draw this frame uncached rather than change their behaviour.
239
+ if (!writable || object.castShadow !== true ||
240
+ object.onBeforeShadow !== THREE.Object3D.prototype.onBeforeShadow ||
241
+ object.onAfterShadow !== THREE.Object3D.prototype.onAfterShadow || !mergeableDepth(object)) return false;
242
+ const index = this.casterCount++;
243
+ this.casters[index] = object;
244
+ const still = frozen && plainDepth(object) && (!object.frustumCulled || this.frustum.intersectsObject(object));
245
+ this.stillFlags[index] = still;
246
+ if (still) {
247
+ this.stillCount += 1;
248
+ this.record(object);
249
+ }
250
+ }
251
+ for (let i = 0; i < object.children.length; i++) if (!this.collect(object.children[i], frozen)) return false;
252
+ return true;
253
+ }
254
+
255
+ record(object) {
256
+ const geometry = object.geometry;
257
+ const position = geometry.attributes.position;
258
+ const index = geometry.index;
259
+ const now = this.now;
260
+ let at = this.keyLength;
261
+ now[at++] = object;
262
+ now[at++] = geometry;
263
+ now[at++] = position;
264
+ now[at++] = position?.version;
265
+ now[at++] = position?.data?.version;
266
+ now[at++] = index;
267
+ now[at++] = index?.version;
268
+ now[at++] = geometry.drawRange.start;
269
+ now[at++] = geometry.drawRange.count;
270
+ now[at++] = geometry.groups.length;
271
+ for (let i = 0; i < geometry.groups.length; i++) {
272
+ const group = geometry.groups[i];
273
+ now[at++] = group.start;
274
+ now[at++] = group.count;
275
+ now[at++] = group.materialIndex;
276
+ }
277
+ this.keyLength = at;
278
+ this.recordMatrix(object.matrixWorld);
279
+ const material = object.material;
280
+ if (Array.isArray(material)) {
281
+ now[this.keyLength++] = material.length;
282
+ for (let i = 0; i < material.length; i++) this.recordMaterial(material[i]);
283
+ } else {
284
+ now[this.keyLength++] = 1;
285
+ this.recordMaterial(material);
286
+ }
287
+ }
288
+
289
+ recordMaterial(material) {
290
+ const now = this.now;
291
+ let at = this.keyLength;
292
+ now[at++] = material;
293
+ now[at++] = material?.version;
294
+ now[at++] = material?.visible;
295
+ now[at++] = material?.side;
296
+ now[at++] = material?.shadowSide;
297
+ this.keyLength = at;
298
+ }
299
+
300
+ recordMatrix(matrix) {
301
+ for (let i = 0; i < 16; i++) this.now[this.keyLength++] = matrix.elements[i];
302
+ }
303
+
304
+ mask(stillPass) {
305
+ for (let i = 0; i < this.casterCount; i++) {
306
+ if (this.stillFlags[i] === stillPass) continue;
307
+ const object = this.casters[i];
308
+ this.hidden[this.hiddenCount++] = object;
309
+ if (!Reflect.set(object, 'castShadow', false) || object.castShadow !== false) return false;
310
+ }
311
+ return true;
312
+ }
313
+
314
+ restore() {
315
+ for (let i = 0; i < this.hiddenCount; i++) {
316
+ const object = this.hidden[i];
317
+ this.hidden[i] = null;
318
+ // A callback installed mid-pass may have locked/redefined a flag.
319
+ // Restore every other object even when that one cannot be restored.
320
+ try {
321
+ if (object.castShadow !== false || Reflect.set(object, 'castShadow', true)) continue;
322
+ const descriptor = Object.getOwnPropertyDescriptor(object, 'castShadow');
323
+ if (descriptor?.value === false && descriptor.configurable) Object.defineProperty(object, 'castShadow', { ...descriptor, value: true });
324
+ } catch { /* Keep the remaining restorations and cleanup total. */ }
325
+ }
326
+ this.hiddenCount = 0;
327
+ }
328
+
329
+ allocate() {
330
+ if (this.shadow.map) return;
331
+ const { x, y } = this.near.mapSize;
332
+ this.shadow.map = new THREE.WebGLRenderTarget(x, y, {
333
+ minFilter: THREE.NearestFilter, magFilter: THREE.NearestFilter,
334
+ depthTexture: new THREE.DepthTexture(x, y, THREE.UnsignedIntType),
335
+ });
336
+ this.material.uniforms.cachedColor.value = this.shadow.map.texture;
337
+ this.material.uniforms.cachedDepth.value = this.shadow.map.depthTexture;
338
+ }
339
+
340
+ makeCopy() {
341
+ if (this.triangle) return;
342
+ this.geometry = new THREE.BufferGeometry();
343
+ this.geometry.setAttribute('position', new THREE.Float32BufferAttribute([-1, -1, 0, 3, -1, 0, -1, 3, 0], 3));
344
+ this.material = new THREE.ShaderMaterial({
345
+ uniforms: { cachedColor: { value: null }, cachedDepth: { value: null } },
346
+ vertexShader: 'varying vec2 vUv; void main() { vUv = position.xy * 0.5 + 0.5; gl_Position = vec4(position, 1.0); }',
347
+ fragmentShader: `uniform sampler2D cachedColor;
348
+ uniform sampler2D cachedDepth;
349
+ varying vec2 vUv;
350
+ void main() {
351
+ gl_FragColor = texture2D(cachedColor, vUv);
352
+ gl_FragDepth = texture2D(cachedDepth, vUv).x;
353
+ }`,
354
+ blending: THREE.NoBlending, depthTest: true, depthWrite: true, depthFunc: THREE.AlwaysDepth, toneMapped: false, visible: false,
355
+ });
356
+ this.triangle = new THREE.Mesh(this.geometry, this.material);
357
+ this.triangle.frustumCulled = false;
358
+ this.triangle.layers.enableAll();
359
+ }
360
+
361
+ end() {
362
+ this.restore();
363
+ this.frame = null;
364
+ this.runtime = null;
365
+ this.inSun = false;
366
+ if (this.hook) this.hook.cache = null;
367
+ this.detach();
368
+ const descriptor = this.pass && Object.getOwnPropertyDescriptor(this.pass, 'render');
369
+ if (descriptor?.value === this.hook?.render) {
370
+ if (descriptor.writable) this.pass.render = this.had;
371
+ else if (descriptor.configurable) Object.defineProperty(this.pass, 'render', { ...descriptor, value: this.had });
372
+ }
373
+ this.oneLight[0] = null;
374
+ this.renderScene = this.renderCamera = null;
375
+ }
376
+
377
+ detach() {
378
+ if (this.triangle?.parent !== this.world.scene) return;
379
+ const index = this.world.scene.children.indexOf(this.triangle);
380
+ if (index >= 0) this.world.scene.children.splice(index, 1);
381
+ this.triangle.parent = null;
382
+ }
383
+
384
+ dispose() {
385
+ this.end();
386
+ const resources = [this.shadow.map, this.geometry, this.material];
387
+ this.shadow.map = null;
388
+ this.geometry = this.material = this.triangle = null;
389
+ this.was.length = this.now.length = 0;
390
+ this.casters.length = this.stillFlags.length = this.hidden.length = 0;
391
+ this.writableFlags = null;
392
+ this.valid = false;
393
+ let failure;
394
+ for (const resource of resources) {
395
+ try { resource?.dispose(); } catch (error) { failure ??= { error }; }
396
+ }
397
+ if (failure) throw failure.error;
398
+ }
399
+ }
@@ -5,37 +5,13 @@
5
5
  // Both return a THREE.BufferGeometry, or null when the part's fields cannot
6
6
  // make one.
7
7
 
8
+ import { clampInt, points2, points3 } from './modelMath';
8
9
  import * as THREE from 'three';
9
10
  import { partPath } from './paths';
10
11
  import { circleSides, lengthSteps } from './optimize';
11
12
 
12
13
  const DEG = Math.PI / 180;
13
14
 
14
- function clampInt(value, min, max, fallback) {
15
- if (!Number.isFinite(value)) {
16
- return fallback;
17
- }
18
- return Math.max(min, Math.min(max, Math.round(value)));
19
- }
20
-
21
- function points2(list) {
22
- if (!Array.isArray(list)) {
23
- return [];
24
- }
25
- return list
26
- .filter((p) => Array.isArray(p) && Number.isFinite(p[0]) && Number.isFinite(p[1]))
27
- .map((p) => new THREE.Vector2(p[0], p[1]));
28
- }
29
-
30
- function points3(list) {
31
- if (!Array.isArray(list)) {
32
- return [];
33
- }
34
- return list
35
- .filter((p) => Array.isArray(p) && p.slice(0, 3).every(Number.isFinite))
36
- .map((p) => new THREE.Vector3(p[0], p[1], p[2]));
37
- }
38
-
39
15
  //
40
16
  // Sweep
41
17
  //