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
@@ -6,23 +6,13 @@
6
6
  // the part's own position and rotation apply inside that frame. The same seed
7
7
  // always gives the same placement.
8
8
 
9
+ import { seededRandom } from './modelMath';
9
10
  import * as THREE from 'three';
10
11
  import { MeshSurfaceSampler } from 'three/examples/jsm/math/MeshSurfaceSampler.js';
11
12
 
12
13
  const MAX_COPIES = 200;
13
14
  const UP = new THREE.Vector3(0, 1, 0);
14
15
 
15
- // A small seeded random number generator (mulberry32) returning [0, 1).
16
- function seededRandom(seed) {
17
- let state = Math.round(seed * 9973) | 0;
18
- return () => {
19
- state = (state + 0x6d2b79f5) | 0;
20
- let t = Math.imul(state ^ (state >>> 15), 1 | state);
21
- t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
22
- return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
23
- };
24
- }
25
-
26
16
  // Points and normals in the parent's space: on the `on` part's mesh, area
27
17
  // weighted, or inside the `within` box centered on the parent's pivot.
28
18
  function scatterPoints(settings, parent, groups, count, random) {
@@ -100,6 +100,15 @@
100
100
  // keeps its variant, which reads and writes the original, until then.
101
101
  // A variant the fade has let go of (dropped, or the fade itself gone)
102
102
  // is inert: it keys and compiles as its original, with no fade.
103
+ // - The visible walk and the descriptor checks stay live each frame:
104
+ // neither three's material version nor the still clock sees every
105
+ // write to a mesh's material, callbacks or visibility. The checks use
106
+ // Object.getOwnPropertyDescriptor and Object.hasOwn, including on the
107
+ // way back: the same descriptors, without calling a getter, with no
108
+ // Reflect descriptor lookup in the per-mesh path. The assignments and
109
+ // their verification stay guarded, even for a mesh changed inside the
110
+ // render. No bounds test drops a receiver: beyond `reach` the patch
111
+ // forces the shadow off, where the unfaded map may still shadow it.
103
112
  //
104
113
  // So no material and nothing of another world is written by the fade, and
105
114
  // whatever deck code writes through a variant lands where it would without
@@ -173,7 +182,7 @@ function lit(material) {
173
182
  return material !== null && typeof material === 'object' && LIT_CLASSES.has(Object.getPrototypeOf(material));
174
183
  }
175
184
 
176
- const own = (object, key) => Object.prototype.hasOwnProperty.call(object, key);
185
+ const own = (object, key) => Object.hasOwn(object, key);
177
186
 
178
187
  // Whether a material gets a variant: lit, and its shader hook, key function
179
188
  // and draw callback are three's own or the kit's (kithooks.js), none of which
@@ -203,7 +212,7 @@ const ACCESSOR = Symbol('accessor');
203
212
  // cannot take an own property).
204
213
  function writableValue(object, key) {
205
214
  for (let level = object; level !== null && level !== undefined; level = Object.getPrototypeOf(level)) {
206
- const descriptor = Reflect.getOwnPropertyDescriptor(level, key);
215
+ const descriptor = Object.getOwnPropertyDescriptor(level, key);
207
216
  if (!descriptor) continue;
208
217
  if (!('value' in descriptor) || descriptor.writable !== true) return ACCESSOR;
209
218
  if (level !== object && !Object.isExtensible(object)) return ACCESSOR;
@@ -217,14 +226,14 @@ function writableValue(object, key) {
217
226
  // ACCESSOR otherwise (an inherited material too: the swap would leave the
218
227
  // mesh an own property in place of the inherited one).
219
228
  function ownMaterial(mesh) {
220
- const descriptor = Reflect.getOwnPropertyDescriptor(mesh, 'material');
229
+ const descriptor = Object.getOwnPropertyDescriptor(mesh, 'material');
221
230
  if (!descriptor || !('value' in descriptor) || descriptor.writable !== true || descriptor.configurable !== true) return ACCESSOR;
222
231
  return descriptor.value;
223
232
  }
224
233
 
225
234
  function dataValue(object, key) {
226
235
  for (let level = object; level !== null && level !== undefined; level = Object.getPrototypeOf(level)) {
227
- const descriptor = Reflect.getOwnPropertyDescriptor(level, key);
236
+ const descriptor = Object.getOwnPropertyDescriptor(level, key);
228
237
  if (descriptor) return 'value' in descriptor ? descriptor.value : ACCESSOR;
229
238
  }
230
239
  return undefined;
@@ -235,8 +244,7 @@ function dataValue(object, key) {
235
244
  const OBJECT_BEFORE = THREE.Object3D.prototype.onBeforeRender;
236
245
  const OBJECT_AFTER = THREE.Object3D.prototype.onAfterRender;
237
246
  function plainObject(object, protos) {
238
- const hasOwn = Object.prototype.hasOwnProperty;
239
- if (hasOwn.call(object, 'onBeforeRender') || hasOwn.call(object, 'onAfterRender') || !protos) {
247
+ if (own(object, 'onBeforeRender') || own(object, 'onAfterRender') || !protos) {
240
248
  return dataValue(object, 'onBeforeRender') === OBJECT_BEFORE && dataValue(object, 'onAfterRender') === OBJECT_AFTER;
241
249
  }
242
250
  // Neither is the object's own: what its prototype has, looked at once a
@@ -406,7 +414,7 @@ function originalBelow(proto, shared) {
406
414
  get(target, key, receiver) {
407
415
  const original = ownOriginal(receiver);
408
416
  if (!original) return Reflect.get(target, key, receiver);
409
- if (!Object.prototype.hasOwnProperty.call(shared, key)) Object.defineProperty(shared, key, forwarding(key, false));
417
+ if (!own(shared, key)) Object.defineProperty(shared, key, forwarding(key, false));
410
418
  return Reflect.get(original, key, original);
411
419
  },
412
420
  set(target, key, value, receiver) {
@@ -417,12 +425,12 @@ function originalBelow(proto, shared) {
417
425
  }
418
426
 
419
427
  function ownOriginal(object) {
420
- return object !== null && typeof object === 'object' && Object.prototype.hasOwnProperty.call(object, ORIGINAL) ? object[ORIGINAL] : undefined;
428
+ return object !== null && typeof object === 'object' && own(object, ORIGINAL) ? object[ORIGINAL] : undefined;
421
429
  }
422
430
 
423
431
  function ownKeysWith(object, into) {
424
432
  for (const key of Reflect.ownKeys(object)) {
425
- if (!into.has(key)) into.set(key, Reflect.getOwnPropertyDescriptor(object, key).enumerable === true);
433
+ if (!into.has(key)) into.set(key, Object.getOwnPropertyDescriptor(object, key).enumerable === true);
426
434
  }
427
435
  }
428
436
 
@@ -440,7 +448,7 @@ function forwarderFor(original) {
440
448
  // read every draw: forwarded, they run on the original.
441
449
  for (let level = proto; level && level !== Object.prototype; level = Object.getPrototypeOf(level)) {
442
450
  for (const key of Reflect.ownKeys(level)) {
443
- const descriptor = Reflect.getOwnPropertyDescriptor(level, key);
451
+ const descriptor = Object.getOwnPropertyDescriptor(level, key);
444
452
  if (!keys.has(key) && (descriptor.get || descriptor.set)) keys.set(key, false);
445
453
  }
446
454
  }
@@ -538,7 +546,7 @@ function makeVariant(original, uniform, rendererListener, properties) {
538
546
  entryOfOriginal = entry;
539
547
  for (const name of Reflect.ownKeys(variant)) {
540
548
  if (OWN.has(name)) continue;
541
- Reflect.defineProperty(original, name, Reflect.getOwnPropertyDescriptor(variant, name));
549
+ Reflect.defineProperty(original, name, Object.getOwnPropertyDescriptor(variant, name));
542
550
  if (!Reflect.deleteProperty(variant, name)) return false;
543
551
  }
544
552
  return true;
@@ -563,14 +571,14 @@ export function shadowFadeOriginal(material) {
563
571
  // be (read-only and not configurable): the mesh keeps the variant, which
564
572
  // reads and writes its original, until it can.
565
573
  function putBack(mesh, put, had) {
566
- const descriptor = Reflect.getOwnPropertyDescriptor(mesh, 'material');
574
+ const descriptor = Object.getOwnPropertyDescriptor(mesh, 'material');
567
575
  // Gone from the mesh (deleted, or inherited now): not ours to touch.
568
576
  if (!descriptor) return true;
569
577
  if ('value' in descriptor) {
570
578
  if (descriptor.value !== put) return true;
571
- if (Reflect.set(mesh, 'material', had) && Reflect.getOwnPropertyDescriptor(mesh, 'material')?.value === had) return true;
579
+ if (Reflect.set(mesh, 'material', had) && Object.getOwnPropertyDescriptor(mesh, 'material')?.value === had) return true;
572
580
  if (descriptor.configurable !== true) return false;
573
- return Reflect.defineProperty(mesh, 'material', { ...descriptor, value: had }) && Reflect.getOwnPropertyDescriptor(mesh, 'material')?.value === had;
581
+ return Reflect.defineProperty(mesh, 'material', { ...descriptor, value: had }) && Object.getOwnPropertyDescriptor(mesh, 'material')?.value === had;
574
582
  }
575
583
  // An accessor a deck put there during the render: what it holds cannot be
576
584
  // read without calling its getter, which the fade never does. With a
@@ -712,7 +720,7 @@ class ShadowFade {
712
720
  if (!Reflect.set(pass, 'render', hook.had)) {
713
721
  // Made read-only during the frame but still configurable: put the
714
722
  // pass back with the deck's attributes and the function it had.
715
- const descriptor = Reflect.getOwnPropertyDescriptor(pass, 'render');
723
+ const descriptor = Object.getOwnPropertyDescriptor(pass, 'render');
716
724
  if (descriptor?.configurable && 'value' in descriptor) {
717
725
  Reflect.defineProperty(pass, 'render', { ...descriptor, value: hook.had });
718
726
  }
@@ -1,5 +1,5 @@
1
1
  // Scenes that set `"engine": { "sky": { ... } }` (physics-2d engine/skyKey.js
2
- // reads the key and has its shape; CLAUDE.md has the terms).
2
+ // reads the key and has its shape; docs/engine-sky.md has the terms).
3
3
  //
4
4
  // The engine clears to black and has no sky. For a scene that asks, a sky is
5
5
  // drawn behind everything: the sky of the zone the player stands in, one
@@ -0,0 +1,177 @@
1
+ // The dormant engine.load key. Invalid settings leave the old path alone.
2
+ import { parseModelCached } from './pxmodel';
3
+ import { modelAnimation } from './motion';
4
+ import { resolveModelRef, MAX_MODEL_DEPTH } from './modelrefs';
5
+ import { isDataBehavior } from './dataBehaviors.js';
6
+ import { Vector3 } from 'three';
7
+
8
+ export function readLoadKey(data) {
9
+ const load = data?.engine?.load;
10
+ if (!load || typeof load !== 'object' || Array.isArray(load) ||
11
+ Object.keys(load).some(key => !['first', 'sliceMs', 'inert', 'horizon'].includes(key))) return null;
12
+ if (load.inert !== undefined && (!Array.isArray(load.inert) ||
13
+ !load.inert.every(name => typeof name === 'string' && name.length > 0))) return null;
14
+ const inert = load.inert === undefined ? {} : { inert: [...load.inert] };
15
+ const sliceMs = load.sliceMs === undefined ? 8 : load.sliceMs;
16
+ if (!Number.isFinite(sliceMs) || sliceMs < 1 || sliceMs > 50) return null;
17
+ const horizon = load.horizon === undefined ? 45 : load.horizon;
18
+ if (!Number.isFinite(horizon) || horizon < 0) return null;
19
+ const first = load.first;
20
+ if (Array.isArray(first)) {
21
+ return first.every(id => typeof id === 'string' && id.length > 0) ? { first: [...first], sliceMs, horizon, ...inert } : null;
22
+ }
23
+ if (!first || typeof first !== 'object' || Object.keys(first).length !== 1 ||
24
+ !Number.isFinite(first.radius) || first.radius <= 0) return null;
25
+ return { first: { radius: first.radius }, sliceMs, horizon, ...inert };
26
+ }
27
+
28
+ const BIPED_PARTS = new Set(['legL', 'legR', 'armL', 'armR', 'torso']);
29
+
30
+ function modelMayWait(model, files, path, chain = [path]) {
31
+ if (modelAnimation(model)) return false;
32
+ for (const part of model.parts) {
33
+ if (BIPED_PARTS.has(part.id) || part.keep || part.tint || part.id.startsWith('slot-')) return false;
34
+ if (part.kind !== 'model') continue;
35
+ const ref = resolveModelRef(part.src, path);
36
+ if (chain.includes(ref) || chain.length > MAX_MODEL_DEPTH) continue;
37
+ const inner = parseModelCached(files?.[ref]);
38
+ if (inner && !modelMayWait(inner, files, ref, [...chain, ref])) return false;
39
+ }
40
+ return true;
41
+ }
42
+
43
+ function componentsMayWait(runtime, actor, inert, names) {
44
+ if (!actor.components.Transform || 'Player' in actor.components ||
45
+ actor.id === runtime.orbitOwnModel || actor.id === runtime.followCamera?.id || actor.runtime?.modelClip) return false;
46
+ for (const name of names) {
47
+ const Behavior = runtime.behaviors?.get(name);
48
+ // SceneRuntime skips an unregistered component entirely. Registered
49
+ // custom classes block even if disabled or constructor-only, unless the
50
+ // deck explicitly promises they never consume this actor's visual.
51
+ if (!Behavior || inert.includes(name)) continue;
52
+ if (!isDataBehavior(name, Behavior)) return false;
53
+ }
54
+ return true;
55
+ }
56
+
57
+ export function actorMayWait(world, runtime, actor, inert = []) {
58
+ if (!componentsMayWait(runtime, actor, inert, Object.keys(actor.components))) return false;
59
+ const file = actor.components.Model?.file;
60
+ const model = file && parseModelCached(runtime.files?.[file]);
61
+ if (!model || !modelMayWait(model, runtime.files, file)) return false;
62
+ for (const object of world.ownModelWith ?? []) {
63
+ for (let node = object; node; node = node.parent) if (node.userData?.actorId === actor.id) return false;
64
+ }
65
+ return true;
66
+ }
67
+
68
+ // Track broad registry changes as well as each waiter's own class identities:
69
+ // a remove+add can change registrations without changing Map identity or size.
70
+ // A revision lets pair checks update one waiter independently of the others.
71
+ export function consumerRegistryVersion(load) {
72
+ const registry = load.runtime.behaviors;
73
+ if (registry !== load.consumerRegistry || registry?.size !== load.consumerRegistrySize) {
74
+ load.consumerRegistry = registry;
75
+ load.consumerRegistrySize = registry?.size;
76
+ load.consumerRevision++;
77
+ }
78
+ return load.consumerRevision;
79
+ }
80
+
81
+ export function rememberModelConsumer(load, actor) {
82
+ const names = Object.keys(actor.components);
83
+ return { names, classes: names.map(name => load.runtime.behaviors?.get(name)),
84
+ count: names.length, revision: consumerRegistryVersion(load) };
85
+ }
86
+
87
+ // This dispatch fence reads component membership, never model contents or
88
+ // render signatures. Unchanged frames allocate no arrays; class identity costs
89
+ // only one Map lookup per captured component, including unregistered names.
90
+ export function modelConsumerChanged(load, wait, revision) {
91
+ const { actor, consumer } = wait;
92
+ const c = actor.components, runtime = load.runtime;
93
+ if (!c.Transform || 'Player' in c || actor.id === runtime.orbitOwnModel ||
94
+ actor.id === runtime.followCamera?.id || actor.runtime?.modelClip) return true;
95
+ let count = 0;
96
+ for (const name in c) if (Object.hasOwn(c, name)) count++;
97
+ // A remove+add can preserve the count. Promote conservatively if an old key
98
+ // vanished, without allocating a new list just to discover its replacement.
99
+ if (count === consumer.count) for (const name of consumer.names) if (!Object.hasOwn(c, name)) return true;
100
+ let classesChanged = false;
101
+ for (let i = 0; i < consumer.names.length; i++) {
102
+ if (runtime.behaviors?.get(consumer.names[i]) !== consumer.classes[i]) classesChanged = true;
103
+ }
104
+ if (count === consumer.count && revision === consumer.revision && !classesChanged) return false;
105
+ const names = Object.keys(c);
106
+ consumer.names = names; consumer.classes = names.map(name => runtime.behaviors?.get(name));
107
+ consumer.count = count; consumer.revision = revision;
108
+ return !componentsMayWait(runtime, actor, load.inert ?? [], names);
109
+ }
110
+
111
+ const playerTransform = actors => actors.find(actor => 'Player' in actor.components)?.components.Transform;
112
+
113
+ // Cache eligibility until the focus moves over 1 m or pending membership /
114
+ // placement changes. Dynamic and tier-detached moves invalidate during sync.
115
+ export function nearModelKeys(world, load) {
116
+ const previous = load.nearCache;
117
+ if (load.horizon === 0 || !load.pending.size) {
118
+ if (previous?.revision === load.pendingRevision) return previous.near;
119
+ const near = new Set(load.pending.keys());
120
+ load.nearCache = { near, revision: load.pendingRevision };
121
+ return near;
122
+ }
123
+ const actors = load.runtime.actors;
124
+ let player = previous?.player;
125
+ if (!player || !previous || previous.revision !== load.pendingRevision || previous.actors !== actors ||
126
+ previous.actorCount !== actors?.size || (player &&
127
+ (load.runtime.getActor(player.id) !== player || !('Player' in player.components)))) {
128
+ player = load.runtime.getActors().find(actor => 'Player' in actor.components);
129
+ }
130
+ const centre = player?.components.Transform ?? world.camera.getWorldPosition(load.horizonCamera ??= new Vector3());
131
+ if (previous && previous.revision === load.pendingRevision && previous.player === player &&
132
+ Math.hypot(centre.x - previous.x, centre.z - previous.z) <= 1) {
133
+ previous.actors = actors; previous.actorCount = actors?.size;
134
+ return previous.near;
135
+ }
136
+ const near = new Set();
137
+ for (const [key, waits] of load.pending) {
138
+ for (const wait of waits) {
139
+ const t = wait.actor.components.Transform;
140
+ if (t && Math.hypot(t.x - centre.x, t.z - centre.z) <= load.horizon) {
141
+ near.add(key);
142
+ break;
143
+ }
144
+ }
145
+ }
146
+ load.nearCache = { near, revision: load.pendingRevision, player, actors, actorCount: actors?.size, x: centre.x, z: centre.z };
147
+ return near;
148
+ }
149
+
150
+ export function makeModelLoad(world, runtime, setting) {
151
+ const actors = runtime.getActors();
152
+ // Player is a component/behaviour, as in Door/Pickup and the Player itself.
153
+ const centre = playerTransform(actors) ?? { x: 0, z: 0 };
154
+ const ids = Array.isArray(setting.first) ? new Set(setting.first) : null;
155
+ const firstFiles = new Set();
156
+ for (const actor of actors) {
157
+ const t = actor.components.Transform;
158
+ if (!t) continue;
159
+ const selected = ids ? ids.has(actor.id) : Math.hypot(t.x - centre.x, t.z - centre.z) <= setting.first.radius;
160
+ if (selected || world.instanceModels || !actorMayWait(world, runtime, actor, setting.inert)) firstFiles.add(actor.components.Model?.file);
161
+ }
162
+ return {
163
+ runtime, data: runtime.data, sceneKey: runtime.sceneKey ?? runtime.scenePath,
164
+ setting: JSON.stringify(setting), sliceMs: setting.sliceMs, horizon: setting.horizon, inert: setting.inert, firstFiles,
165
+ pending: new Map(), built: new Set(), firstKeys: new Set(), deferredKeys: new Set(),
166
+ pendingRevision: 0, nearCache: null,
167
+ consumerRegistry: runtime.behaviors, consumerRegistrySize: runtime.behaviors?.size, consumerRevision: 0,
168
+ synced: false, drawn: false, restMarked: false, draining: false,
169
+ drawnAt: null, frameIntervals: [], skippedFrames: 0,
170
+ now: () => performance.now(),
171
+ };
172
+ }
173
+
174
+ export function loadSummary(load, world) {
175
+ return Object.freeze({ pending: load.pending.size, near: nearModelKeys(world, load).size, built: load.built.size,
176
+ firstKeys: load.firstKeys.size, deferredKeys: load.deferredKeys.size });
177
+ }