castle-web-cli 0.4.233 → 0.4.235

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (383) hide show
  1. package/dist/api.d.ts +11 -0
  2. package/dist/api.js +43 -0
  3. package/dist/bundle.d.ts +64 -0
  4. package/dist/bundle.js +558 -2
  5. package/dist/castle-host/host.d.ts +17 -2
  6. package/dist/castle-host/host.js +793 -36
  7. package/dist/castleJson.d.ts +20 -1
  8. package/dist/castleJson.js +44 -2
  9. package/dist/check.js +9 -2
  10. package/dist/chunkLoader.d.ts +3 -0
  11. package/dist/chunkLoader.js +111 -0
  12. package/dist/devParty.d.ts +26 -0
  13. package/dist/devParty.js +231 -0
  14. package/dist/devSaveStorage.js +4 -0
  15. package/dist/devSessionStorage.js +3 -1
  16. package/dist/devSocial.d.ts +24 -0
  17. package/dist/devSocial.js +70 -0
  18. package/dist/ide.d.ts +2 -0
  19. package/dist/ide.js +119 -15
  20. package/dist/index.js +8 -2
  21. package/dist/init.js +1 -1
  22. package/dist/save-deck.d.ts +20 -1
  23. package/dist/save-deck.js +141 -5
  24. package/dist/serve.js +29 -11
  25. package/dist/shell/assets/{index-BjOxR-lW.js → index-DulbYIJm.js} +97 -97
  26. package/dist/shell/index.html +1 -1
  27. package/dist/vitePlugins.d.ts +2 -1
  28. package/dist/vitePlugins.js +13 -0
  29. package/kits/base/castle.json +1 -1
  30. package/kits/base/sdk/README.md +266 -3
  31. package/kits/base/sdk/castle.d.ts +7 -3
  32. package/kits/base/sdk/castle.js +2 -0
  33. package/kits/base/sdk/commands.d.ts +162 -1
  34. package/kits/base/sdk/commands.js +3 -0
  35. package/kits/base/sdk/display.d.ts +3 -0
  36. package/kits/base/sdk/display.js +9 -3
  37. package/kits/base/sdk/hub.d.ts +33 -6
  38. package/kits/base/sdk/hub.js +68 -5
  39. package/kits/base/sdk/hubRejoin.d.ts +4 -0
  40. package/kits/base/sdk/hubRejoin.js +15 -0
  41. package/kits/base/sdk/multiplayer.d.ts +7 -1
  42. package/kits/base/sdk/multiplayer.js +147 -40
  43. package/kits/base/sdk/multiplayerProtocol.d.ts +2 -0
  44. package/kits/base/sdk/party.d.ts +23 -0
  45. package/kits/base/sdk/party.js +91 -0
  46. package/kits/base/sdk/reconnectBudget.d.ts +23 -0
  47. package/kits/base/sdk/reconnectBudget.js +96 -0
  48. package/kits/base/sdk/save.d.ts +38 -1
  49. package/kits/base/sdk/save.js +79 -6
  50. package/kits/base/sdk/server/hub.d.ts +31 -1
  51. package/kits/base/sdk/server/hub.js +50 -3
  52. package/kits/base/sdk/server/platformHandle.d.ts +13 -1
  53. package/kits/base/sdk/server/storage.d.ts +4 -0
  54. package/kits/base/sdk/server/storage.js +19 -3
  55. package/kits/base/sdk/server/wrapper.d.ts +7 -1
  56. package/kits/base/sdk/server/wrapper.js +10 -1
  57. package/kits/base/sdk/social.d.ts +9 -0
  58. package/kits/base/sdk/social.js +5 -0
  59. package/kits/hub-game/CLAUDE.md +123 -3
  60. package/kits/hub-game/README.md +63 -0
  61. package/kits/hub-game/castle.json +5 -5
  62. package/kits/hub-game/code/client/act.js +312 -0
  63. package/kits/hub-game/code/client/actionLayout.js +147 -0
  64. package/kits/hub-game/code/client/actionOverflow.js +556 -0
  65. package/kits/hub-game/code/client/arrivalCamera.js +50 -0
  66. package/kits/hub-game/code/client/askSlot.js +117 -0
  67. package/kits/hub-game/code/client/avatar.js +4 -2
  68. package/kits/hub-game/code/client/avatarShare.js +2 -0
  69. package/kits/hub-game/code/client/backVisibility.js +13 -0
  70. package/kits/hub-game/code/client/ballot.js +15 -10
  71. package/kits/hub-game/code/client/build.js +16 -0
  72. package/kits/hub-game/code/client/chat.js +41 -5
  73. package/kits/hub-game/code/client/chatModeration.js +5 -0
  74. package/kits/hub-game/code/client/chrome.js +1148 -258
  75. package/kits/hub-game/code/client/crowdNames.js +241 -0
  76. package/kits/hub-game/code/client/decor.js +10 -4
  77. package/kits/hub-game/code/client/defaultEnvironment.js +194 -0
  78. package/kits/hub-game/code/client/doorErrors.js +39 -0
  79. package/kits/hub-game/code/client/fall.js +18 -0
  80. package/kits/hub-game/code/client/farAvatars.js +233 -0
  81. package/kits/hub-game/code/client/firstJoin.js +9 -2
  82. package/kits/hub-game/code/client/fpsTelemetry.js +50 -0
  83. package/kits/hub-game/code/client/frameBatch.js +5 -0
  84. package/kits/hub-game/code/client/grab.js +31 -11
  85. package/kits/hub-game/code/client/hookLayer.js +87 -8
  86. package/kits/hub-game/code/client/hudCopy.js +51 -0
  87. package/kits/hub-game/code/client/hudRate.js +20 -0
  88. package/kits/hub-game/code/client/idle.js +14 -2
  89. package/kits/hub-game/code/client/invites.js +231 -0
  90. package/kits/hub-game/code/client/joinError.js +9 -0
  91. package/kits/hub-game/code/client/labelsNear.js +31 -2
  92. package/kits/hub-game/code/client/landscapeLayout.js +17 -0
  93. package/kits/hub-game/code/client/layoutCache.js +264 -0
  94. package/kits/hub-game/code/client/loadTelemetry.js +20 -0
  95. package/kits/hub-game/code/client/loadingCover.js +148 -0
  96. package/kits/hub-game/code/client/loadingEntry.js +8 -0
  97. package/kits/hub-game/code/client/menuRows.js +43 -0
  98. package/kits/hub-game/code/client/modelReady.js +7 -0
  99. package/kits/hub-game/code/client/padCueArrival.js +23 -0
  100. package/kits/hub-game/code/client/padCues.js +112 -0
  101. package/kits/hub-game/code/client/padOccupancy.js +88 -0
  102. package/kits/hub-game/code/client/padReadability.js +26 -0
  103. package/kits/hub-game/code/client/padRings.js +69 -0
  104. package/kits/hub-game/code/client/pushVisit.js +14 -0
  105. package/kits/hub-game/code/client/quality.js +205 -0
  106. package/kits/hub-game/code/client/qualityEntry.js +55 -0
  107. package/kits/hub-game/code/client/safeLayout.js +338 -0
  108. package/kits/hub-game/code/client/safeStyle.js +42 -0
  109. package/kits/hub-game/code/client/say.js +12 -3
  110. package/kits/hub-game/code/client/shot.js +64 -10
  111. package/kits/hub-game/code/client/shotFit.js +56 -0
  112. package/kits/hub-game/code/client/signIn.js +28 -0
  113. package/kits/hub-game/code/client/state.js +53 -0
  114. package/kits/hub-game/code/client/talk.js +209 -45
  115. package/kits/hub-game/code/client/tiers.js +68 -66
  116. package/kits/hub-game/code/client/together.js +7 -2
  117. package/kits/hub-game/code/client/weakestLookBake.js +92 -0
  118. package/kits/hub-game/code/client/weakestTier.js +295 -0
  119. package/kits/hub-game/code/client/worldLabels.js +241 -0
  120. package/kits/hub-game/code/client/yours.js +10 -9
  121. package/kits/hub-game/code/npcDisplayText.js +55 -0
  122. package/kits/hub-game/code/server/act.js +124 -0
  123. package/kits/hub-game/code/server/actions.js +6 -1
  124. package/kits/hub-game/code/server/actors.js +2 -1
  125. package/kits/hub-game/code/server/analytics.js +83 -0
  126. package/kits/hub-game/code/server/anonymousEntry.js +49 -0
  127. package/kits/hub-game/code/server/arrivalPose.js +36 -0
  128. package/kits/hub-game/code/server/companion.js +28 -3
  129. package/kits/hub-game/code/server/doorAnalytics.js +52 -0
  130. package/kits/hub-game/code/server/earned.js +22 -5
  131. package/kits/hub-game/code/server/frameBatch.js +183 -0
  132. package/kits/hub-game/code/server/friendsAmong.js +49 -9
  133. package/kits/hub-game/code/server/history.js +2 -0
  134. package/kits/hub-game/code/server/hub.js +1306 -95
  135. package/kits/hub-game/code/server/idle.js +30 -1
  136. package/kits/hub-game/code/server/index.js +26 -4
  137. package/kits/hub-game/code/server/invites.js +19 -0
  138. package/kits/hub-game/code/server/labels.js +9 -1
  139. package/kits/hub-game/code/server/loadAbandon.js +106 -0
  140. package/kits/hub-game/code/server/manifest.js +211 -3
  141. package/kits/hub-game/code/server/menu.js +31 -3
  142. package/kits/hub-game/code/server/npcs.js +226 -64
  143. package/kits/hub-game/code/server/observe.js +408 -0
  144. package/kits/hub-game/code/server/padOccupancy.js +85 -0
  145. package/kits/hub-game/code/server/players.js +9 -1
  146. package/kits/hub-game/code/server/resumePose.js +152 -0
  147. package/kits/hub-game/code/server/say.js +1 -1
  148. package/kits/hub-game/code/server/standing.js +4 -5
  149. package/kits/hub-game/code/server/storageLimit.js +187 -0
  150. package/kits/hub-game/code/server/vis.js +67 -5
  151. package/kits/hub-game/code/shared/act.js +35 -0
  152. package/kits/hub-game/code/shared/danceIdle.js +28 -0
  153. package/kits/hub-game/code/shared/loadStages.js +12 -0
  154. package/kits/hub-game/code/shared/quality.js +74 -0
  155. package/kits/hub-game/code/shared/say.js +2 -0
  156. package/kits/hub-game/code/shared/shot.js +35 -1
  157. package/kits/hub-game/code/systems/hub.js +970 -169
  158. package/kits/hub-game/docs/analytics.md +279 -0
  159. package/kits/hub-game/docs/contract.md +1259 -42
  160. package/kits/hub-game/docs/home-pieces.md +9 -2
  161. package/kits/hub-game/docs/observed-progress.md +252 -0
  162. package/kits/hub-game/main.jsx +2 -0
  163. package/kits/hub-game/package-lock.json +10 -3
  164. package/kits/hub-game/package.json +6 -3
  165. package/kits/hub-game/play/player.js +142 -0
  166. package/kits/hub-game/play/registry.js +47 -0
  167. package/kits/hub-game/play.jsx +37 -0
  168. package/kits/hub-game/scripts/check.mjs +39 -5
  169. package/kits/hub-game/scripts/companion-follower-wire.json +1 -1
  170. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +11 -0
  171. package/kits/hub-game/scripts/fixtures/decor-keyless.json +5 -5
  172. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +3 -0
  173. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +19 -3
  174. package/kits/hub-game/scripts/fixtures/interest-legacy.json +3 -3
  175. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -1
  176. package/kits/hub-game/scripts/pose-storage-fixture.mjs +46 -0
  177. package/kits/hub-game/scripts/test-act-client.mjs +186 -0
  178. package/kits/hub-game/scripts/test-act.mjs +171 -0
  179. package/kits/hub-game/scripts/test-action-layout.mjs +80 -0
  180. package/kits/hub-game/scripts/test-action-observers.mjs +46 -0
  181. package/kits/hub-game/scripts/test-actions-client.mjs +367 -2
  182. package/kits/hub-game/scripts/test-actors.mjs +20 -7
  183. package/kits/hub-game/scripts/test-analytics.mjs +76 -0
  184. package/kits/hub-game/scripts/test-anonymous-entry.mjs +28 -0
  185. package/kits/hub-game/scripts/test-arrival-pose-server.mjs +196 -0
  186. package/kits/hub-game/scripts/test-arrival-pose.mjs +24 -0
  187. package/kits/hub-game/scripts/test-ask-slot.mjs +85 -0
  188. package/kits/hub-game/scripts/test-avatar-wire.mjs +49 -10
  189. package/kits/hub-game/scripts/test-avatar.mjs +44 -0
  190. package/kits/hub-game/scripts/test-back-visibility.mjs +82 -0
  191. package/kits/hub-game/scripts/test-ballot.mjs +11 -4
  192. package/kits/hub-game/scripts/test-ban-join.mjs +121 -13
  193. package/kits/hub-game/scripts/test-build.mjs +20 -2
  194. package/kits/hub-game/scripts/test-chat.mjs +206 -5
  195. package/kits/hub-game/scripts/test-companion-chat.mjs +20 -2
  196. package/kits/hub-game/scripts/test-control-layout-dom.mjs +120 -0
  197. package/kits/hub-game/scripts/test-crowd-names.mjs +205 -0
  198. package/kits/hub-game/scripts/test-decor-client.mjs +45 -4
  199. package/kits/hub-game/scripts/test-decor.mjs +7 -0
  200. package/kits/hub-game/scripts/test-default-environment-root.mjs +95 -0
  201. package/kits/hub-game/scripts/test-default-environment.mjs +267 -0
  202. package/kits/hub-game/scripts/test-door-analytics.mjs +58 -0
  203. package/kits/hub-game/scripts/test-door-jump.mjs +100 -0
  204. package/kits/hub-game/scripts/test-earned.mjs +33 -3
  205. package/kits/hub-game/scripts/test-far-avatars.mjs +340 -0
  206. package/kits/hub-game/scripts/test-fps-telemetry.mjs +112 -0
  207. package/kits/hub-game/scripts/test-frame-batch.mjs +252 -0
  208. package/kits/hub-game/scripts/test-fresh-friends.mjs +118 -0
  209. package/kits/hub-game/scripts/test-grab-orbit.mjs +47 -4
  210. package/kits/hub-game/scripts/test-high-only.mjs +170 -0
  211. package/kits/hub-game/scripts/test-hub-ops.mjs +321 -2
  212. package/kits/hub-game/scripts/test-hub-trip.mjs +879 -11
  213. package/kits/hub-game/scripts/test-hud-clear.mjs +162 -59
  214. package/kits/hub-game/scripts/test-hud-defects-dom.mjs +100 -0
  215. package/kits/hub-game/scripts/test-hud-rate.mjs +224 -0
  216. package/kits/hub-game/scripts/test-hud-safe-visibility-dom.mjs +83 -0
  217. package/kits/hub-game/scripts/test-idle.mjs +66 -0
  218. package/kits/hub-game/scripts/test-interest-cells.mjs +20 -0
  219. package/kits/hub-game/scripts/test-interest.mjs +15 -0
  220. package/kits/hub-game/scripts/test-invites-client.mjs +430 -0
  221. package/kits/hub-game/scripts/test-invites.mjs +109 -0
  222. package/kits/hub-game/scripts/test-labels.mjs +71 -3
  223. package/kits/hub-game/scripts/test-landscape-layout.mjs +194 -0
  224. package/kits/hub-game/scripts/test-list-scroll-dom.mjs +49 -0
  225. package/kits/hub-game/scripts/test-load-abandon.mjs +246 -0
  226. package/kits/hub-game/scripts/test-loading-cover.mjs +162 -0
  227. package/kits/hub-game/scripts/test-manifest.mjs +265 -0
  228. package/kits/hub-game/scripts/test-menu-client.mjs +105 -0
  229. package/kits/hub-game/scripts/test-menu.mjs +23 -0
  230. package/kits/hub-game/scripts/test-npcs.mjs +917 -10
  231. package/kits/hub-game/scripts/test-observed.mjs +745 -0
  232. package/kits/hub-game/scripts/test-pad-cues.mjs +304 -0
  233. package/kits/hub-game/scripts/test-pad-occupancy.mjs +177 -0
  234. package/kits/hub-game/scripts/test-picker.mjs +234 -7
  235. package/kits/hub-game/scripts/test-placement-cache.mjs +690 -0
  236. package/kits/hub-game/scripts/test-progress-reset.mjs +559 -0
  237. package/kits/hub-game/scripts/test-push-visit.mjs +26 -0
  238. package/kits/hub-game/scripts/test-quality.mjs +385 -0
  239. package/kits/hub-game/scripts/test-rehello.mjs +699 -5
  240. package/kits/hub-game/scripts/test-resume-action-order.mjs +598 -0
  241. package/kits/hub-game/scripts/test-resume-held.mjs +239 -0
  242. package/kits/hub-game/scripts/test-resume-pose.mjs +142 -0
  243. package/kits/hub-game/scripts/test-safe-events-dom.mjs +116 -0
  244. package/kits/hub-game/scripts/test-safe-layout.mjs +330 -0
  245. package/kits/hub-game/scripts/test-say.mjs +1 -1
  246. package/kits/hub-game/scripts/test-shot.mjs +145 -0
  247. package/kits/hub-game/scripts/test-signin-client.mjs +45 -0
  248. package/kits/hub-game/scripts/test-soundscape.mjs +22 -17
  249. package/kits/hub-game/scripts/test-standing.mjs +35 -2
  250. package/kits/hub-game/scripts/test-storage-limit.mjs +333 -0
  251. package/kits/hub-game/scripts/test-stuck.mjs +5 -4
  252. package/kits/hub-game/scripts/test-talk-overlay-dom.mjs +130 -0
  253. package/kits/hub-game/scripts/test-tiers-render.mjs +86 -13
  254. package/kits/hub-game/scripts/test-tiers.mjs +7 -8
  255. package/kits/hub-game/scripts/test-vis.mjs +433 -6
  256. package/kits/hub-game/scripts/test-weakest-tier.mjs +924 -0
  257. package/kits/hub-game/scripts/test-world-labels.mjs +367 -0
  258. package/kits/hub-game/scripts/test-yours-chrome.mjs +50 -6
  259. package/kits/hub-game/scripts/test-yours.mjs +39 -8
  260. package/kits/multiplayer-3d/castle.json +5 -5
  261. package/kits/multiplayer-3d/code/client/joinFailure.js +27 -0
  262. package/kits/multiplayer-3d/code/client/resumeGate.js +139 -0
  263. package/kits/multiplayer-3d/code/systems/multiplayer.js +369 -30
  264. package/kits/multiplayer-3d/package-lock.json +8 -1
  265. package/kits/multiplayer-3d/package.json +2 -1
  266. package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +436 -0
  267. package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +624 -0
  268. package/kits/physics-2d/CLAUDE.md +10 -1
  269. package/kits/physics-2d/castle.json +2 -2
  270. package/kits/physics-2d/engine/frozenActors.js +233 -0
  271. package/kits/physics-2d/engine/scene.js +87 -5
  272. package/kits/physics-2d/eslint.config.js +1 -1
  273. package/kits/physics-2d/play/behaviors/AnalogStick.js +198 -0
  274. package/kits/physics-2d/play/behaviors/Camera.js +40 -0
  275. package/kits/physics-2d/play/behaviors/Collider.js +122 -0
  276. package/kits/physics-2d/play/behaviors/Draggable.js +115 -0
  277. package/kits/physics-2d/play/behaviors/Goal.js +46 -0
  278. package/kits/physics-2d/play/behaviors/Joints.js +126 -0
  279. package/kits/physics-2d/play/behaviors/Layout.js +71 -0
  280. package/kits/physics-2d/play/behaviors/RigidBody.js +57 -0
  281. package/kits/physics-2d/play/behaviors/Slingshot.js +142 -0
  282. package/kits/physics-2d/play/behaviors/SoundPlayer.js +263 -0
  283. package/kits/physics-2d/play/behaviors/Sprite.js +406 -0
  284. package/kits/physics-2d/play/behaviors/Style.js +209 -0
  285. package/kits/physics-2d/play/behaviors/Text.js +85 -0
  286. package/kits/physics-2d/play/behaviors/Video.js +93 -0
  287. package/kits/physics-3d/CLAUDE.md +25 -1651
  288. package/kits/physics-3d/behaviors/Body.jsx +3 -0
  289. package/kits/physics-3d/behaviors/Model.jsx +3 -0
  290. package/kits/physics-3d/behaviors/Player.jsx +35 -18
  291. package/kits/physics-3d/behaviors/Shape.jsx +3 -0
  292. package/kits/physics-3d/behaviors/Solid.jsx +3 -0
  293. package/kits/physics-3d/behaviors/Transform.jsx +3 -0
  294. package/kits/physics-3d/castle.json +3 -3
  295. package/kits/physics-3d/docs/engine-camera.md +542 -0
  296. package/kits/physics-3d/docs/engine-frame-cap.md +136 -0
  297. package/kits/physics-3d/docs/engine-load.md +149 -0
  298. package/kits/physics-3d/docs/engine-look.md +114 -0
  299. package/kits/physics-3d/docs/engine-shadows.md +372 -0
  300. package/kits/physics-3d/docs/engine-skip-work.md +187 -0
  301. package/kits/physics-3d/docs/engine-sky.md +198 -0
  302. package/kits/physics-3d/docs/engine-static-actors.md +226 -0
  303. package/kits/physics-3d/docs/engine-view.md +37 -0
  304. package/kits/physics-3d/docs/pxmodel-format.md +1 -1
  305. package/kits/physics-3d/engine3d/PlayOnly3D.jsx +5 -1
  306. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +19 -333
  307. package/kits/physics-3d/engine3d/actornode.js +1 -0
  308. package/kits/physics-3d/engine3d/branches.js +3 -13
  309. package/kits/physics-3d/engine3d/cage.js +2 -7
  310. package/kits/physics-3d/engine3d/cageops.js +2 -17
  311. package/kits/physics-3d/engine3d/dataBehaviors.js +12 -0
  312. package/kits/physics-3d/engine3d/framecap.js +4 -1
  313. package/kits/physics-3d/engine3d/frozenphysics.js +140 -0
  314. package/kits/physics-3d/engine3d/frozenstatics.js +273 -0
  315. package/kits/physics-3d/engine3d/gait.js +8 -0
  316. package/kits/physics-3d/engine3d/initialModelFiles.js +18 -0
  317. package/kits/physics-3d/engine3d/look.js +7 -0
  318. package/kits/physics-3d/engine3d/modelFiles.js +3 -17
  319. package/kits/physics-3d/engine3d/modelMath.js +49 -0
  320. package/kits/physics-3d/engine3d/modelready.js +16 -0
  321. package/kits/physics-3d/engine3d/motion.js +3 -3
  322. package/kits/physics-3d/engine3d/nearshadows.js +77 -10
  323. package/kits/physics-3d/engine3d/orbitinput.js +59 -25
  324. package/kits/physics-3d/engine3d/partgeometry.js +1 -16
  325. package/kits/physics-3d/engine3d/paths.js +1 -9
  326. package/kits/physics-3d/engine3d/playTimings.js +50 -0
  327. package/kits/physics-3d/engine3d/playerRun.js +372 -0
  328. package/kits/physics-3d/engine3d/pxmodel.js +3 -3
  329. package/kits/physics-3d/engine3d/rapier.js +27 -0
  330. package/kits/physics-3d/engine3d/scatter.js +1 -11
  331. package/kits/physics-3d/engine3d/shadowfade.js +23 -15
  332. package/kits/physics-3d/engine3d/sky.js +1 -1
  333. package/kits/physics-3d/engine3d/squarefirst.js +177 -0
  334. package/kits/physics-3d/engine3d/stillshadows.js +399 -0
  335. package/kits/physics-3d/engine3d/sweep.js +1 -25
  336. package/kits/physics-3d/engine3d/world3d.js +468 -18
  337. package/kits/physics-3d/eslint.config.js +2 -1
  338. package/kits/physics-3d/main.jsx +6 -3
  339. package/kits/physics-3d/package-lock.json +7 -0
  340. package/kits/physics-3d/package.json +5 -1
  341. package/kits/physics-3d/play/behaviors/Body.js +31 -0
  342. package/kits/physics-3d/play/behaviors/Door.js +37 -0
  343. package/kits/physics-3d/play/behaviors/Lookable.js +16 -0
  344. package/kits/physics-3d/play/behaviors/Model.js +23 -0
  345. package/kits/physics-3d/play/behaviors/Pickup.js +46 -0
  346. package/kits/physics-3d/play/behaviors/Player.js +1204 -0
  347. package/kits/physics-3d/play/behaviors/Shape.js +47 -0
  348. package/kits/physics-3d/play/behaviors/Solid.js +16 -0
  349. package/kits/physics-3d/play/behaviors/Transform.js +29 -0
  350. package/kits/physics-3d/pnpm-lock.yaml +8 -0
  351. package/kits/physics-3d/scripts/bench-shadow-fade.mjs +37 -0
  352. package/kits/physics-3d/scripts/build-rapier-gz.mjs +56 -0
  353. package/kits/physics-3d/scripts/frozen-statics-fixture.mjs +141 -0
  354. package/kits/physics-3d/scripts/test-camera-follow.mjs +5 -1
  355. package/kits/physics-3d/scripts/test-camera-orbit.mjs +52 -4
  356. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +1 -1
  357. package/kits/physics-3d/scripts/test-empty-gait-hints.mjs +89 -0
  358. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +6 -3
  359. package/kits/physics-3d/scripts/test-frame-cap.mjs +1 -1
  360. package/kits/physics-3d/scripts/test-frozen-nested.mjs +49 -0
  361. package/kits/physics-3d/scripts/test-frozen-statics-legacy-physics2d.mjs +123 -0
  362. package/kits/physics-3d/scripts/test-frozen-statics.mjs +434 -0
  363. package/kits/physics-3d/scripts/test-look-bake.mjs +1 -1
  364. package/kits/physics-3d/scripts/test-near-shadows.mjs +2 -2
  365. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +88 -7
  366. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +40 -3
  367. package/kits/physics-3d/scripts/test-orbit-shot.mjs +75 -1
  368. package/kits/physics-3d/scripts/test-rapier-gz.mjs +106 -0
  369. package/kits/physics-3d/scripts/test-sky.mjs +1 -1
  370. package/kits/physics-3d/scripts/test-square-first.mjs +921 -0
  371. package/kits/physics-3d/scripts/test-static-actors.mjs +3 -1
  372. package/kits/physics-3d/scripts/test-static-physics.mjs +4 -1
  373. package/kits/physics-3d/scripts/test-static-scenery.mjs +5 -2
  374. package/kits/physics-3d/scripts/test-steady-hover.mjs +5 -2
  375. package/kits/physics-3d/scripts/test-still-shadows.mjs +477 -0
  376. package/kits/physics-3d/systems/physics3d.js +37 -4
  377. package/kits/real-time/castle.json +2 -2
  378. package/kits/real-time/code/client/connection.js +33 -10
  379. package/kits/real-time/code/client/gameHooks.js +2 -0
  380. package/kits/real-time/code/client/joinOverlay.js +9 -4
  381. package/kits/real-time/code/server/session.js +6 -4
  382. package/kits/real-time/package-lock.json +1 -1
  383. package/package.json +2 -2
@@ -1,6 +1,8 @@
1
1
  // v1.61: only an accepted orbit shot makes state or starts a watcher. There
2
2
  // is no frame hook. The timer stops on clear, travel, load or connection loss.
3
+ import { fittedDistance } from './shotFit.js';
3
4
  import { shotValue } from '../shared/shot.js';
5
+ import { cancelArrivalShot, seedArrivalShot } from './arrivalCamera.js';
4
6
 
5
7
  function nothing() {}
6
8
 
@@ -11,7 +13,15 @@ let active;
11
13
  let remembered;
12
14
 
13
15
  function equalPose(a, b) {
14
- return a.look.x === b.look.x && a.look.y === b.look.y && a.look.z === b.look.z && a.distance === b.distance && a.pitch === b.pitch && a.yaw === b.yaw;
16
+ return (
17
+ a.look.x === b.look.x &&
18
+ a.look.y === b.look.y &&
19
+ a.look.z === b.look.z &&
20
+ a.distance === b.distance &&
21
+ a.pitch === b.pitch &&
22
+ a.yaw === b.yaw &&
23
+ JSON.stringify(a.fit) === JSON.stringify(b.fit)
24
+ );
15
25
  }
16
26
 
17
27
  function clear(resumable = false) {
@@ -21,7 +31,13 @@ function clear(resumable = false) {
21
31
  if (active.scene.orbitShot === active.pose) {
22
32
  delete active.scene.orbitShot;
23
33
  }
24
- remembered = { scene: active.scene, pose: active.pose, path: active.path, key: active.key, resumable };
34
+ remembered = {
35
+ scene: active.scene,
36
+ pose: active.source,
37
+ path: active.path,
38
+ key: active.key,
39
+ resumable,
40
+ };
25
41
  active = undefined;
26
42
  } else if (remembered && !resumable) {
27
43
  remembered.resumable = false;
@@ -34,10 +50,23 @@ function checkActive() {
34
50
  }
35
51
  const { scene, pose, path, key, net, generation, lastRenewedAt } = active;
36
52
  // Ownership and place changes take priority over a simultaneous disconnect.
37
- if (scene.orbitShot !== pose || scene.cameraControl !== 'orbit' || scene.currentScenePath !== path || scene.sceneKey !== key) {
53
+ if (
54
+ scene.orbitShot !== pose ||
55
+ scene.cameraControl !== 'orbit' ||
56
+ scene.currentScenePath !== path ||
57
+ scene.sceneKey !== key
58
+ ) {
38
59
  clear();
39
- } else if (performance.now() - lastRenewedAt > 5000 || scene.multiplayer?.net !== net || scene.multiplayer?.generation !== generation || net?.closed?.() || (net?.status && net.status().state !== 'connected')) {
60
+ } else if (
61
+ performance.now() - lastRenewedAt > 5000 ||
62
+ scene.multiplayer?.net !== net ||
63
+ scene.multiplayer?.generation !== generation ||
64
+ net?.closed?.() ||
65
+ (net?.status && net.status().state !== 'connected')
66
+ ) {
40
67
  clear(true);
68
+ } else if (active.source.fit) {
69
+ pose.distance = fittedDistance(active.source, scene.three?.camera);
41
70
  }
42
71
  }
43
72
 
@@ -48,6 +77,7 @@ export function receiveShot(scene, value, lease = false) {
48
77
  const pose = shotValue(value);
49
78
  if (!pose) {
50
79
  if (!lease) {
80
+ cancelArrivalShot(scene);
51
81
  clearShot();
52
82
  }
53
83
  return;
@@ -56,14 +86,27 @@ export function receiveShot(scene, value, lease = false) {
56
86
  checkActive();
57
87
  if (lease) {
58
88
  if (active) {
59
- if (active.scene === scene && equalPose(active.pose, pose)) {
89
+ if (active.scene === scene && equalPose(active.source, pose)) {
60
90
  active.lastRenewedAt = performance.now();
61
91
  }
62
92
  return;
63
93
  }
64
- if (!remembered?.resumable || remembered.scene !== scene || scene.currentScenePath !== remembered.path || scene.sceneKey !== remembered.key || scene.orbitShot !== undefined || !equalPose(remembered.pose, pose)) {
94
+ if (
95
+ !remembered?.resumable ||
96
+ remembered.scene !== scene ||
97
+ scene.currentScenePath !== remembered.path ||
98
+ scene.sceneKey !== remembered.key ||
99
+ scene.orbitShot !== undefined ||
100
+ !equalPose(remembered.pose, pose)
101
+ ) {
65
102
  // A scene change or deck assignment during a disconnect also declines it.
66
- if (remembered && (remembered.scene !== scene || scene.currentScenePath !== remembered.path || scene.sceneKey !== remembered.key || scene.orbitShot !== undefined)) {
103
+ if (
104
+ remembered &&
105
+ (remembered.scene !== scene ||
106
+ scene.currentScenePath !== remembered.path ||
107
+ scene.sceneKey !== remembered.key ||
108
+ scene.orbitShot !== undefined)
109
+ ) {
67
110
  clear();
68
111
  }
69
112
  return;
@@ -74,15 +117,26 @@ export function receiveShot(scene, value, lease = false) {
74
117
  const generation = scene.multiplayer?.generation;
75
118
  const path = scene.currentScenePath;
76
119
  const key = scene.sceneKey;
77
- if (active?.scene === scene && scene.orbitShot === active.pose && active.net === net && active.generation === generation && active.path === path && active.key === key && equalPose(active.pose, pose)) {
120
+ if (
121
+ active?.scene === scene &&
122
+ scene.orbitShot === active.pose &&
123
+ active.net === net &&
124
+ active.generation === generation &&
125
+ active.path === path &&
126
+ active.key === key &&
127
+ equalPose(active.source, pose)
128
+ ) {
129
+ seedArrivalShot(scene, pose);
78
130
  active.lastRenewedAt = now;
79
131
  remembered = undefined;
80
132
  return;
81
133
  }
82
134
  clearShot();
83
135
  remembered = undefined;
84
- scene.orbitShot = pose;
85
- const own = { scene, pose, net, generation, path, key, lastRenewedAt: now };
136
+ const drawn = { ...pose, distance: fittedDistance(pose, scene.three?.camera) };
137
+ scene.orbitShot = drawn;
138
+ seedArrivalShot(scene, pose);
139
+ const own = { scene, pose: drawn, source: pose, net, generation, path, key, lastRenewedAt: now };
86
140
  active = own;
87
141
  clearShot = () => clear();
88
142
  // A transient socket loss need not end the session or produce a hub trip.
@@ -0,0 +1,56 @@
1
+ // v1.119: fit a world-space box inside the central 90% of the canvas.
2
+ // Solve the perspective inequalities at its eight vertices. Keep the wire
3
+ // distance as fallback until a usable lens exists; never change yaw or look.
4
+ export function fittedDistance(shot, camera) {
5
+ const fit = shot.fit;
6
+ const aspect = camera?.aspect,
7
+ fov = camera?.fov,
8
+ zoom = camera?.zoom ?? 1;
9
+ if (
10
+ !fit ||
11
+ !Number.isFinite(aspect) ||
12
+ aspect <= 0 ||
13
+ !Number.isFinite(fov) ||
14
+ fov <= 0 ||
15
+ fov >= 180 ||
16
+ !Number.isFinite(zoom) ||
17
+ zoom <= 0
18
+ ) {
19
+ return shot.distance;
20
+ }
21
+ const vertical = (Math.tan((fov * Math.PI) / 360) / zoom) * 0.9;
22
+ const horizontal = vertical * aspect;
23
+ const yaw = (shot.yaw * Math.PI) / 180,
24
+ pitch = (shot.pitch * Math.PI) / 180;
25
+ const sy = Math.sin(yaw),
26
+ cy = Math.cos(yaw),
27
+ sp = Math.sin(pitch),
28
+ cp = Math.cos(pitch);
29
+ let distance = fit.minDistance;
30
+ let farthest = -Infinity;
31
+ for (const x of [fit.min.x, fit.max.x]) {
32
+ for (const y of [fit.min.y, fit.max.y]) {
33
+ for (const z of [fit.min.z, fit.max.z]) {
34
+ const dx = x - shot.look.x,
35
+ dy = y - shot.look.y,
36
+ dz = z - shot.look.z;
37
+ const right = dx * cy + dz * sy;
38
+ const up = dx * sy * sp + dy * cp - dz * cy * sp;
39
+ const depth = dx * sy * cp - dy * sp - dz * cy * cp;
40
+ farthest = Math.max(farthest, depth);
41
+ distance = Math.max(
42
+ distance,
43
+ Math.abs(right) / horizontal - depth,
44
+ Math.abs(up) / vertical - depth,
45
+ (camera.near ?? 0.1) - depth,
46
+ );
47
+ }
48
+ }
49
+ }
50
+ // A box may fit the canvas only beyond the lens's far plane. There is
51
+ // no valid fitted pose then; keep the authored shot instead of zooming
52
+ // the entire subject out of the depth range. Leave a strict depth margin.
53
+ const far = camera.far;
54
+ const withinDepth = !Number.isFinite(far) || distance + farthest < far - 0.001;
55
+ return Number.isFinite(distance) && withinDepth ? distance : shot.distance;
56
+ }
@@ -0,0 +1,28 @@
1
+ // Host-owned authentication. Old SDKs and hosts leave the authored HUD text.
2
+ export const guestName = (name) => /^Guest\s*·/.test(String(name)) ? name : `Guest · ${name || 'player'}`;
3
+
4
+ export function makeSignIn({ api, signedIn = () => {} }) {
5
+ let unavailable = false;
6
+ let pending = false;
7
+ return {
8
+ items(place, hud, items) {
9
+ if (place?.anonymousEntry !== true || unavailable || typeof api?.signIn !== 'function' ||
10
+ !/Sign in to\b/i.test(hud?.text ?? '')) {return items;}
11
+ return [{ id: 'signin', label: 'Sign in' }, ...(items ?? []).filter((item) => item.id !== 'signin').slice(0, 2)];
12
+ },
13
+ async press(reason) {
14
+ if (pending || unavailable || typeof api?.signIn !== 'function') {return;}
15
+ pending = true;
16
+ try {
17
+ const answer = await api.signIn({ reason: String(reason).slice(0, 120) });
18
+ if (answer?.status === 'signedIn') {signedIn(answer);}
19
+ else if (answer?.status === 'unavailable') {unavailable = true;}
20
+ } catch (error) {
21
+ if (error?.code === 'UNKNOWN_COMMAND' || /unknown.command/i.test(error?.message ?? '')) {unavailable = true;}
22
+ } finally {
23
+ pending = false;
24
+ }
25
+ },
26
+ pending: () => pending,
27
+ };
28
+ }
@@ -4,16 +4,25 @@
4
4
  // session switch.
5
5
  import { clearShot } from './shot.js';
6
6
 
7
+ // The deck's own castle.json arrival for a place id, set by the hook layer;
8
+ // read only by the optional spawn ring (`engine.hubSpawnRing`), never sent.
9
+ export const localArrival = { for: () => undefined };
10
+
7
11
  // What the deck's own castle.json asks of the hub client, read once by the
8
12
  // hook layer (`hookLayer.js`) as the page loads. Not cleared on a session
9
13
  // switch: it is the page's deck, whichever place is playing.
10
14
  export const deck = {
15
+ // Root-only `hub.defaultEnvironment`: false disables the fallback picture
16
+ // and its fall fade for every scene this page visits, including packs.
17
+ defaultEnvironment: true,
11
18
  // `hub.tiers`: a cheaper picture on a slow device (`tiers.js`).
12
19
  tiers: false,
13
20
  // `hub.cues` (v1.23): a town says more about the friends and party a player
14
21
  // came with -- a friend already here, who reads chat, the door a friend
15
22
  // went to, who joined the party. Every such branch asks this first.
16
23
  cues: false,
24
+ // v1.122: friend/party play cards anywhere; strangers nearby and bounded.
25
+ playCards: false,
17
26
  // `hub.stuck` (v1.33): a town offers a player who walks and gets nowhere
18
27
  // the way back to its arrival (`stuck.js`). Every such branch asks this first.
19
28
  stuck: false,
@@ -110,6 +119,11 @@ export const hub = {
110
119
  // door, the invitation waiting on this player ({ from, username }) and the
111
120
  // door their party proposed ({ door, by, username, asked })
112
121
  party: { members: null, away: 0, invite: null, proposal: null },
122
+ // Client-local invitation occurrence. `inviteSeq` survives clear so an old
123
+ // lease can never collide with a later invitation in this page runtime.
124
+ // The current occurrence is advanced at each observable receipt boundary.
125
+ inviteSeq: 0,
126
+ inviteOccurrence: null,
113
127
  // what players said since the hub system last looked (`hub-said`, v1.11):
114
128
  // { player, r } (a reaction) or { player, p, door } (a phrase)
115
129
  saidEvents: [],
@@ -133,6 +147,10 @@ export const hub = {
133
147
  // the facing the place gave this player on arrival, or null until it has,
134
148
  // and whether the camera has been turned to it
135
149
  arrivedFacing: null,
150
+ // The post-arrival server placement for this client has reached the
151
+ // multiplayer layer. A returned Your games card waits for this so its
152
+ // first-display position is the town position, not the scene spawn.
153
+ arrivalPlaced: false,
136
154
  faced: false,
137
155
  // a command for the hub system: { kind: 'go' | 'end' | 'result', ... }
138
156
  commands: [],
@@ -152,6 +170,7 @@ export const hub = {
152
170
  npcEmotes: {},
153
171
  seated: {},
154
172
  sounds: {},
173
+ danceIdle: null,
155
174
  soundEvents: [],
156
175
  // v1.50, allocated only for soundscape.cues; private or actor one-shots.
157
176
  cueEvents: null,
@@ -166,6 +185,7 @@ export const hub = {
166
185
 
167
186
  export function clear() {
168
187
  hub.place = null;
188
+ delete hub.prompts;
169
189
  hub.menuClose?.();
170
190
  delete hub.menuClose;
171
191
  delete hub.menu;
@@ -200,6 +220,9 @@ export function clear() {
200
220
  hub.earnedAll.clear();
201
221
  hub.earnedMe.clear();
202
222
  hub.hud = null;
223
+ delete hub.guests;
224
+ delete hub.guestsAll;
225
+ delete hub.guestsMe;
203
226
  hub.hudMe = null;
204
227
  hub.leaving = null;
205
228
  hub.friendsWanted = false;
@@ -217,6 +240,7 @@ export function clear() {
217
240
  hub.whereAtAt = 0;
218
241
  hub.jumpedTo = null;
219
242
  hub.party = { members: null, away: 0, invite: null, proposal: null };
243
+ hub.inviteOccurrence = null;
220
244
  hub.marks = {};
221
245
  hub.spawned = {};
222
246
  hub.spawnTemplates = {};
@@ -233,12 +257,14 @@ export function clear() {
233
257
  hub.npcEmotes = {};
234
258
  hub.seated = {};
235
259
  hub.sounds = {};
260
+ hub.danceIdle = null;
236
261
  hub.soundEvents.length = 0;
237
262
  if (hub.cueEvents) {
238
263
  hub.cueEvents.length = 0;
239
264
  }
240
265
  hub.cabinets = {};
241
266
  hub.arrivedFacing = null;
267
+ hub.arrivalPlaced = false;
242
268
  hub.faced = false;
243
269
  hub.commands.length = 0;
244
270
  }
@@ -257,6 +283,33 @@ export function mergeHidden() {
257
283
  }
258
284
  }
259
285
 
286
+ export function receiveParty(msg) {
287
+ const invite = msg.invite ?? null;
288
+ if (!invite) {
289
+ hub.inviteOccurrence = null;
290
+ } else if (hub.inviteOccurrence?.from !== invite.from) {
291
+ hub.inviteOccurrence = { from: invite.from, n: ++hub.inviteSeq };
292
+ }
293
+ hub.party = {
294
+ members: Array.isArray(msg.members) ? msg.members : null,
295
+ away: Number(msg.away) || 0,
296
+ invite,
297
+ proposal: msg.proposal ?? null,
298
+ };
299
+ }
300
+
301
+ // Tests and older composed clients can provide party state directly. Normal
302
+ // runtime state already has an occurrence from `receiveParty`.
303
+ export function invitationOccurrence(invite) {
304
+ if (!invite) {
305
+ return null;
306
+ }
307
+ if (hub.inviteOccurrence?.from !== invite.from) {
308
+ hub.inviteOccurrence = { from: invite.from, n: ++hub.inviteSeq };
309
+ }
310
+ return hub.inviteOccurrence;
311
+ }
312
+
260
313
  // What earned item each player shows (v1.53): everyone's, with this
261
314
  // player's own over it.
262
315
  export function earnedNow() {