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,142 @@
1
+ // Generated from ../../behaviors/Slingshot.jsx; run npm run sync:play-behaviors.
2
+ import { PIXELS } from '../../engine/propertyRanges';
3
+ import { acquirePress, TARGETED_CLAIM, GREEDY_CLAIM, slingLaunch, slingPull, inActorWorldSpace } from '../../engine/physics/controls';
4
+
5
+ // Slingshot: pull back and release to fling the actor the opposite way
6
+ // (angry-birds style) -- the physics feel of castle-client's Sling. While
7
+ // aiming it draws an arrow showing the launch direction and power. Needs a
8
+ // RigidBody (dynamic) + Collider.
9
+ //
10
+ // speed -> launch velocity per pixel of pull.
11
+ // maxDrag -> pull distance cap (also caps launch power).
12
+ // grabAnywhere -> start the sling from a press ANYWHERE on screen (default,
13
+ // like castle-client); set false to require pressing the actor.
14
+ class Slingshot {
15
+ static behaviorName = 'Slingshot';
16
+ // Launches a body, so it needs one: Collider + dynamic RigidBody.
17
+ static expectedSiblings = ['Collider', 'RigidBody'];
18
+ static defaultProps = {
19
+ speed: 0.08,
20
+ maxDrag: 160,
21
+ grabAnywhere: true,
22
+ };
23
+ // `speed` is a small multiplier (0.08 default), so whole-number steps were
24
+ // useless here. `maxDrag` is pixels of pull.
25
+ static propertyMeta = {
26
+ speed: { min: 0, step: 0.01 },
27
+ maxDrag: PIXELS,
28
+ };
29
+ static initialState = { slinging: false, pointerId: null, anchor: null, aim: null };
30
+ constructor(props) {
31
+ this.props = props;
32
+ }
33
+ update(actor, scene) {
34
+ const state = this.state;
35
+ if (!state.slinging) {
36
+ const grabAnywhere = this.props.grabAnywhere ?? true;
37
+ const press = acquirePress(scene, actor.id, (p) => {
38
+ // Collider-accurate, at the body's live orientation -- the same pick
39
+ // Draggable uses, so the two agree on what "on this actor" means.
40
+ const onSelf = scene.physics.actorAtPoint(p.x, p.y)?.id === actor.id;
41
+ if (!grabAnywhere && !onSelf)
42
+ return null;
43
+ // Pressing the body itself is an unambiguous aim; taking any press
44
+ // anywhere is not, so it yields to a control that was actually targeted.
45
+ return onSelf ? TARGETED_CLAIM : GREEDY_CLAIM;
46
+ });
47
+ if (press) {
48
+ state.pointerId = press.id;
49
+ state.slinging = true;
50
+ // Anchor at the press point (like castle-client): the aim/launch depends
51
+ // on the drag gesture, not where the press landed relative to the actor.
52
+ state.anchor = { x: press.x, y: press.y };
53
+ // A same-frame tap (down already false) is not an aim — cancel before we
54
+ // can launch with a zero pull. A TARGETED control that updates later this
55
+ // frame may still steal a greedy claim; we must not freeze velocity yet.
56
+ if (!press.down) {
57
+ state.slinging = false;
58
+ state.pointerId = null;
59
+ return;
60
+ }
61
+ }
62
+ }
63
+ if (!state.slinging)
64
+ return;
65
+ const p = scene.pointers.get(state.pointerId);
66
+ // Outranked mid-aim, or the contact was cancelled: drop the shot rather than
67
+ // launching from an anchor the player has stopped steering.
68
+ if (!p || !scene.ownsPointer(state.pointerId, actor.id)) {
69
+ state.slinging = false;
70
+ state.pointerId = null;
71
+ state.aim = null;
72
+ return;
73
+ }
74
+ if (p.down) {
75
+ // Hold still while aiming — but not on the press frame. A greedy claim can
76
+ // still lose to a higher claim that hasn't updated yet (e.g. a Draggable
77
+ // on the pressed body); freezing here would hitch a mid-air body for one frame
78
+ // and then drop the shot with no launch. Matches claimPointer's contract
79
+ // that the press frame costs a greedy control nothing visible.
80
+ if (!p.justPressed)
81
+ scene.physics.setVelocity(actor, { x: 0, y: 0 });
82
+ state.aim = { x: p.x, y: p.y };
83
+ }
84
+ else {
85
+ scene.physics.setVelocity(actor, slingLaunch(state.anchor, p, this.props));
86
+ state.slinging = false;
87
+ state.pointerId = null;
88
+ state.aim = null;
89
+ }
90
+ }
91
+ // Aim overlay in the castle-client style: a translucent grab circle plus a
92
+ // line + arrowhead pointing in the launch direction (opposite the pull).
93
+ draw(actor, scene, ctx) {
94
+ const state = this.state;
95
+ if (!state.slinging || !state.aim)
96
+ return;
97
+ const a = state.anchor;
98
+ const pull = slingPull(a, state.aim, this.props.maxDrag ?? 160);
99
+ const len = Math.hypot(pull.x, pull.y);
100
+ if (len < 0.001)
101
+ return;
102
+ const dir = { x: -pull.x / len, y: -pull.y / len }; // launch direction (opposite pull)
103
+ const end = { x: a.x - pull.x * 0.8, y: a.y - pull.y * 0.8 };
104
+ // Aim is drawn in world space because the anchor is on the actor.
105
+ inActorWorldSpace(ctx, actor.components.Layout, (c) => drawSling(c, a, end, dir));
106
+ }
107
+ }
108
+ // castle-client's sling overlay: a white grab circle (solid outline + faint
109
+ // fill) at `start`, a line to the base of a filled triangle arrowhead at `end`,
110
+ // pointing along `dir`. Sizes mirror sling.cpp (circle 18, arrowhead 25x10).
111
+ function drawSling(ctx, start, end, dir) {
112
+ const radius = 18;
113
+ const triLen = 25;
114
+ const triW = 10;
115
+ const baseX = end.x - dir.x * triLen;
116
+ const baseY = end.y - dir.y * triLen;
117
+ const perpX = -dir.y;
118
+ const perpY = dir.x;
119
+ ctx.lineWidth = 1.5;
120
+ // Grab circle.
121
+ ctx.fillStyle = 'rgba(255, 255, 255, 0.3)';
122
+ ctx.strokeStyle = 'rgba(255, 255, 255, 0.8)';
123
+ ctx.beginPath();
124
+ ctx.arc(start.x, start.y, radius, 0, Math.PI * 2);
125
+ ctx.fill();
126
+ ctx.stroke();
127
+ // Line from the grab circle to the arrowhead base.
128
+ ctx.beginPath();
129
+ ctx.moveTo(start.x, start.y);
130
+ ctx.lineTo(baseX, baseY);
131
+ ctx.stroke();
132
+ // Filled triangle arrowhead.
133
+ ctx.fillStyle = 'rgba(255, 255, 255, 0.8)';
134
+ ctx.beginPath();
135
+ ctx.moveTo(end.x, end.y);
136
+ ctx.lineTo(baseX + perpX * triW, baseY + perpY * triW);
137
+ ctx.lineTo(baseX - perpX * triW, baseY - perpY * triW);
138
+ ctx.closePath();
139
+ ctx.fill();
140
+ }
141
+
142
+ export { Slingshot };
@@ -0,0 +1,263 @@
1
+ // Generated from ../../behaviors/SoundPlayer.jsx; run npm run sync:play-behaviors.
2
+ import { resolveDeckFile } from 'castle-web-sdk';
3
+ import { mediaElement, setMediaPlaybackRate, setMediaPan, stopMedia, playMedia } from '../../engine/media';
4
+ import { isPreloadedPath, playSound } from '../../engine/sound';
5
+ import { PAN, UNIT } from '../../engine/propertyRanges';
6
+
7
+ // Plays one audio file (.mp3 / .wav / .m4a) from an actor.
8
+ //
9
+ // `stream` picks HOW it plays, which is the only real decision here:
10
+ //
11
+ // stream: false the sound is already decoded in memory, and plays instantly.
12
+ // Copies overlap. This is what a sound effect wants, and it is
13
+ // the default. Preloaded only if the file lives in
14
+ // `assets/sounds/` -- see engine/sound.js.
15
+ // stream: true an <audio> element, decoded as it plays. Nothing is held in
16
+ // memory, so this is what a music track or a long ambience
17
+ // wants -- a minute of audio is ~21MB decoded. One at a time:
18
+ // playing again restarts it rather than overlapping.
19
+ //
20
+ // Set `playOnStart` and it plays when the scene starts. Either way you can
21
+ // trigger it from a behavior:
22
+ //
23
+ // scene.getActor('music').behaviors.SoundPlayer.play();
24
+ // await actor.behaviors.SoundPlayer.play(); // ...and wait for it to end
25
+ // actor.behaviors.SoundPlayer.stop();
26
+ //
27
+ // `actor.runtime.soundPlayer` still holds the handle too (the older spelling,
28
+ // still written every `update`):
29
+ //
30
+ // scene.getActor('music').runtime.soundPlayer.play();
31
+ //
32
+ // To fire a sound effect that no actor owns -- most of them -- don't place one of
33
+ // these at all. `scene.sound.play('hit')` needs no actor and no import.
34
+ //
35
+ // Sound only plays during play, never in the editor: `update` is what wires it
36
+ // up, and the editor doesn't run it. Pressing Stop silences everything, as does
37
+ // `scene.sound.stopAll()` (see systems/media.js).
38
+ //
39
+ // Browsers refuse to play audio until the player has touched the page. A sound
40
+ // that starts before that isn't lost -- it's queued and starts on the first tap
41
+ // or key, which for a game is usually the first input anyway.
42
+ class SoundPlayer {
43
+ static behaviorName = 'SoundPlayer';
44
+ static defaultProps = {
45
+ file: '',
46
+ stream: false,
47
+ volume: 1,
48
+ playbackRate: 1,
49
+ pan: 0,
50
+ loop: false,
51
+ playOnStart: true,
52
+ };
53
+ // Mirrors the clamps `readSettings` already applies at runtime, so the
54
+ // inspector can't author a value the sound would silently ignore -- including
55
+ // playbackRate's 0.01..10, where the classic editor's ceiling lives.
56
+ static propertyMeta = {
57
+ stream: { hint: streamHint },
58
+ volume: UNIT,
59
+ playbackRate: { min: 0.01, max: 10, step: 0.05 },
60
+ pan: PAN,
61
+ };
62
+ static initialState = { handle: null };
63
+ constructor(props) {
64
+ this.props = props;
65
+ }
66
+ update(actor) {
67
+ if (actor.runtime.collected)
68
+ return;
69
+ const file = resolveDeckFile(this.props.file);
70
+ const settings = readSettings(this.props);
71
+ const previous = this.state.handle;
72
+ const handle = settings.stream
73
+ ? streamHandleFor(actor.id, file, settings, previous)
74
+ : bufferHandleFor(file, settings, previous);
75
+ this.state.handle = handle;
76
+ // Kept as the older spelling -- `scene.getActor('music').runtime.soundPlayer`
77
+ // still works alongside `.behaviors.SoundPlayer`.
78
+ actor.runtime.soundPlayer = handle;
79
+ // Only a NEW handle starts itself: this runs every frame, and `playOnStart`
80
+ // means the start of the scene, not the start of each one.
81
+ if (handle && handle !== previous && this.props.playOnStart)
82
+ void handle.play();
83
+ }
84
+ // Instance methods so `actor.behaviors.SoundPlayer.play()` works, delegating
85
+ // to whatever handle `update` last built. Before the first `update()` runs
86
+ // (frame 0, before any `update` has ticked -- see engine/scene.js's ordering,
87
+ // taps are processed before per-actor updates) `this.state.handle` is still
88
+ // null, so these are no-ops that frame; a pre-existing race (the old code had
89
+ // the identical gap via `actor.runtime.soundPlayer` being undefined until the
90
+ // first `update`), not a regression.
91
+ play() {
92
+ return this.state.handle?.play();
93
+ }
94
+ stop() {
95
+ this.state.handle?.stop();
96
+ }
97
+ pause() {
98
+ this.state.handle?.pause();
99
+ }
100
+ resume() {
101
+ this.state.handle?.resume();
102
+ }
103
+ get playing() {
104
+ return this.state.handle?.playing ?? false;
105
+ }
106
+ }
107
+ // What `stream` means, in the inspector, for the setting it is actually on --
108
+ // a note describing both halves of the toggle at once would say less than the
109
+ // prop's own name does. The third case is the one that bites: a sound outside
110
+ // assets/sounds/ plays, but not the first time it is asked for, and nothing else
111
+ // in the editor would ever tell you that.
112
+ function streamHint(on, component) {
113
+ if (on)
114
+ return 'Music and long sounds. Streamed, so nothing is held in memory.';
115
+ const file = resolveDeckFile(component?.file ?? '');
116
+ if (file && !isPreloadedPath(file)) {
117
+ return 'Short sfx. Move this file into assets/sounds/ to preload before first play, otherwise first play is silent.';
118
+ }
119
+ return 'Short sfx. Preloaded, so they fire instantly and overlap.';
120
+ }
121
+ function clamp(value, min, max, fallback) {
122
+ return Number.isFinite(value) ? Math.min(max, Math.max(min, value)) : fallback;
123
+ }
124
+ function readSettings(props) {
125
+ return {
126
+ stream: Boolean(props.stream),
127
+ volume: clamp(props.volume, 0, 1, 1),
128
+ // The same ceiling the classic editor used: past 10x a sound is a click.
129
+ playbackRate: clamp(props.playbackRate, 0.01, 10, 1),
130
+ pan: clamp(props.pan, -1, 1, 0),
131
+ loop: Boolean(props.loop),
132
+ };
133
+ }
134
+ function applyStreamSettings(element, settings) {
135
+ element.volume = settings.volume;
136
+ // Not a plain assignment: an element time-stretches by default, so this is
137
+ // what makes `playbackRate` mean the same retune on both paths. See
138
+ // engine/media.js.
139
+ setMediaPlaybackRate(element, settings.playbackRate);
140
+ element.loop = settings.loop;
141
+ if (settings.pan !== 0)
142
+ setMediaPan(element, settings.pan);
143
+ }
144
+ const warnedStreamOnly = new Set();
145
+ function streamOnly(method) {
146
+ if (warnedStreamOnly.has(method))
147
+ return;
148
+ warnedStreamOnly.add(method);
149
+ console.warn(`[SoundPlayer] ${method}() needs "stream" on -- a decoded sound has no playhead to hold. Ignored.`);
150
+ }
151
+ // Asking the pool for this actor's element EVERY frame is what keeps it alive:
152
+ // an entry nobody asks for is reaped as a despawned actor's leftovers (see
153
+ // engine/media.js). Skipping the ask on frames where the handle already matched
154
+ // meant a track went on sounding while its entry was reaped out from under the
155
+ // pool, past the reach of `stopAll`.
156
+ //
157
+ // A different file is a different pool entry, so comparing elements is also how
158
+ // a changed `file` prop gets a new handle.
159
+ function streamHandleFor(actorId, file, settings, previous) {
160
+ const element = mediaElement(actorId, 'audio', file);
161
+ if (!element)
162
+ return null;
163
+ // Props are live: turning the volume down or the pitch up in the inspector
164
+ // takes effect on the sound already playing.
165
+ applyStreamSettings(element, settings);
166
+ if (previous && previous.element === element) {
167
+ previous.settings = settings;
168
+ return previous;
169
+ }
170
+ return makeStreamHandle(file, element, settings);
171
+ }
172
+ function bufferHandleFor(file, settings, previous) {
173
+ if (previous && !previous.stream && previous.file === file) {
174
+ previous.settings = settings;
175
+ return previous;
176
+ }
177
+ return makeBufferHandle(file, settings);
178
+ }
179
+ // The <audio> handle: one element, reused. `play()` resolves when the sound ends,
180
+ // so a behavior can `await` one before doing the next thing. A looping sound
181
+ // resolves right away rather than never -- awaiting something that by definition
182
+ // doesn't end would hang the caller forever, and that is never what was meant.
183
+ function makeStreamHandle(file, element, settings) {
184
+ const handle = {
185
+ file,
186
+ stream: true,
187
+ settings,
188
+ element,
189
+ play() {
190
+ applyStreamSettings(element, handle.settings);
191
+ try {
192
+ element.currentTime = 0;
193
+ }
194
+ catch {
195
+ // Not seekable yet (still loading) -- it plays from the start anyway.
196
+ }
197
+ playMedia(element);
198
+ if (handle.settings.loop)
199
+ return Promise.resolve();
200
+ return new Promise((resolve) => {
201
+ const done = () => resolve();
202
+ element.addEventListener('ended', done, { once: true });
203
+ element.addEventListener('error', done, { once: true });
204
+ });
205
+ },
206
+ resume() {
207
+ playMedia(element);
208
+ },
209
+ pause() {
210
+ element.pause();
211
+ },
212
+ stop() {
213
+ stopMedia(element);
214
+ },
215
+ get playing() {
216
+ return !element.paused;
217
+ },
218
+ };
219
+ return handle;
220
+ }
221
+ // The decoded handle: every `play()` is its own voice, so they overlap. `stop()`
222
+ // stops the one most recently started -- the others are already on their way out,
223
+ // and `scene.sound.stopAll()` is the blunt instrument for all of them at once.
224
+ //
225
+ // `play()` resolves immediately when nothing played: an unknown file, or a sound
226
+ // still decoding. Never hanging is the point -- see playSound in engine/sound.js.
227
+ function makeBufferHandle(file, settings) {
228
+ const handle = {
229
+ file,
230
+ stream: false,
231
+ settings,
232
+ element: null,
233
+ voice: null,
234
+ play() {
235
+ const s = handle.settings;
236
+ const voice = playSound(file, { volume: s.volume, pan: s.pan, playbackRate: s.playbackRate });
237
+ handle.voice = voice;
238
+ if (!voice)
239
+ return Promise.resolve();
240
+ void voice.finished.then(() => {
241
+ if (handle.voice === voice)
242
+ handle.voice = null;
243
+ });
244
+ return voice.finished;
245
+ },
246
+ resume() {
247
+ streamOnly('resume');
248
+ },
249
+ pause() {
250
+ streamOnly('pause');
251
+ },
252
+ stop() {
253
+ handle.voice?.stop();
254
+ handle.voice = null;
255
+ },
256
+ get playing() {
257
+ return handle.voice !== null;
258
+ },
259
+ };
260
+ return handle;
261
+ }
262
+
263
+ export { SoundPlayer };