castle-web-cli 0.4.233 → 0.4.235

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (383) hide show
  1. package/dist/api.d.ts +11 -0
  2. package/dist/api.js +43 -0
  3. package/dist/bundle.d.ts +64 -0
  4. package/dist/bundle.js +558 -2
  5. package/dist/castle-host/host.d.ts +17 -2
  6. package/dist/castle-host/host.js +793 -36
  7. package/dist/castleJson.d.ts +20 -1
  8. package/dist/castleJson.js +44 -2
  9. package/dist/check.js +9 -2
  10. package/dist/chunkLoader.d.ts +3 -0
  11. package/dist/chunkLoader.js +111 -0
  12. package/dist/devParty.d.ts +26 -0
  13. package/dist/devParty.js +231 -0
  14. package/dist/devSaveStorage.js +4 -0
  15. package/dist/devSessionStorage.js +3 -1
  16. package/dist/devSocial.d.ts +24 -0
  17. package/dist/devSocial.js +70 -0
  18. package/dist/ide.d.ts +2 -0
  19. package/dist/ide.js +119 -15
  20. package/dist/index.js +8 -2
  21. package/dist/init.js +1 -1
  22. package/dist/save-deck.d.ts +20 -1
  23. package/dist/save-deck.js +141 -5
  24. package/dist/serve.js +29 -11
  25. package/dist/shell/assets/{index-BjOxR-lW.js → index-DulbYIJm.js} +97 -97
  26. package/dist/shell/index.html +1 -1
  27. package/dist/vitePlugins.d.ts +2 -1
  28. package/dist/vitePlugins.js +13 -0
  29. package/kits/base/castle.json +1 -1
  30. package/kits/base/sdk/README.md +266 -3
  31. package/kits/base/sdk/castle.d.ts +7 -3
  32. package/kits/base/sdk/castle.js +2 -0
  33. package/kits/base/sdk/commands.d.ts +162 -1
  34. package/kits/base/sdk/commands.js +3 -0
  35. package/kits/base/sdk/display.d.ts +3 -0
  36. package/kits/base/sdk/display.js +9 -3
  37. package/kits/base/sdk/hub.d.ts +33 -6
  38. package/kits/base/sdk/hub.js +68 -5
  39. package/kits/base/sdk/hubRejoin.d.ts +4 -0
  40. package/kits/base/sdk/hubRejoin.js +15 -0
  41. package/kits/base/sdk/multiplayer.d.ts +7 -1
  42. package/kits/base/sdk/multiplayer.js +147 -40
  43. package/kits/base/sdk/multiplayerProtocol.d.ts +2 -0
  44. package/kits/base/sdk/party.d.ts +23 -0
  45. package/kits/base/sdk/party.js +91 -0
  46. package/kits/base/sdk/reconnectBudget.d.ts +23 -0
  47. package/kits/base/sdk/reconnectBudget.js +96 -0
  48. package/kits/base/sdk/save.d.ts +38 -1
  49. package/kits/base/sdk/save.js +79 -6
  50. package/kits/base/sdk/server/hub.d.ts +31 -1
  51. package/kits/base/sdk/server/hub.js +50 -3
  52. package/kits/base/sdk/server/platformHandle.d.ts +13 -1
  53. package/kits/base/sdk/server/storage.d.ts +4 -0
  54. package/kits/base/sdk/server/storage.js +19 -3
  55. package/kits/base/sdk/server/wrapper.d.ts +7 -1
  56. package/kits/base/sdk/server/wrapper.js +10 -1
  57. package/kits/base/sdk/social.d.ts +9 -0
  58. package/kits/base/sdk/social.js +5 -0
  59. package/kits/hub-game/CLAUDE.md +123 -3
  60. package/kits/hub-game/README.md +63 -0
  61. package/kits/hub-game/castle.json +5 -5
  62. package/kits/hub-game/code/client/act.js +312 -0
  63. package/kits/hub-game/code/client/actionLayout.js +147 -0
  64. package/kits/hub-game/code/client/actionOverflow.js +556 -0
  65. package/kits/hub-game/code/client/arrivalCamera.js +50 -0
  66. package/kits/hub-game/code/client/askSlot.js +117 -0
  67. package/kits/hub-game/code/client/avatar.js +4 -2
  68. package/kits/hub-game/code/client/avatarShare.js +2 -0
  69. package/kits/hub-game/code/client/backVisibility.js +13 -0
  70. package/kits/hub-game/code/client/ballot.js +15 -10
  71. package/kits/hub-game/code/client/build.js +16 -0
  72. package/kits/hub-game/code/client/chat.js +41 -5
  73. package/kits/hub-game/code/client/chatModeration.js +5 -0
  74. package/kits/hub-game/code/client/chrome.js +1148 -258
  75. package/kits/hub-game/code/client/crowdNames.js +241 -0
  76. package/kits/hub-game/code/client/decor.js +10 -4
  77. package/kits/hub-game/code/client/defaultEnvironment.js +194 -0
  78. package/kits/hub-game/code/client/doorErrors.js +39 -0
  79. package/kits/hub-game/code/client/fall.js +18 -0
  80. package/kits/hub-game/code/client/farAvatars.js +233 -0
  81. package/kits/hub-game/code/client/firstJoin.js +9 -2
  82. package/kits/hub-game/code/client/fpsTelemetry.js +50 -0
  83. package/kits/hub-game/code/client/frameBatch.js +5 -0
  84. package/kits/hub-game/code/client/grab.js +31 -11
  85. package/kits/hub-game/code/client/hookLayer.js +87 -8
  86. package/kits/hub-game/code/client/hudCopy.js +51 -0
  87. package/kits/hub-game/code/client/hudRate.js +20 -0
  88. package/kits/hub-game/code/client/idle.js +14 -2
  89. package/kits/hub-game/code/client/invites.js +231 -0
  90. package/kits/hub-game/code/client/joinError.js +9 -0
  91. package/kits/hub-game/code/client/labelsNear.js +31 -2
  92. package/kits/hub-game/code/client/landscapeLayout.js +17 -0
  93. package/kits/hub-game/code/client/layoutCache.js +264 -0
  94. package/kits/hub-game/code/client/loadTelemetry.js +20 -0
  95. package/kits/hub-game/code/client/loadingCover.js +148 -0
  96. package/kits/hub-game/code/client/loadingEntry.js +8 -0
  97. package/kits/hub-game/code/client/menuRows.js +43 -0
  98. package/kits/hub-game/code/client/modelReady.js +7 -0
  99. package/kits/hub-game/code/client/padCueArrival.js +23 -0
  100. package/kits/hub-game/code/client/padCues.js +112 -0
  101. package/kits/hub-game/code/client/padOccupancy.js +88 -0
  102. package/kits/hub-game/code/client/padReadability.js +26 -0
  103. package/kits/hub-game/code/client/padRings.js +69 -0
  104. package/kits/hub-game/code/client/pushVisit.js +14 -0
  105. package/kits/hub-game/code/client/quality.js +205 -0
  106. package/kits/hub-game/code/client/qualityEntry.js +55 -0
  107. package/kits/hub-game/code/client/safeLayout.js +338 -0
  108. package/kits/hub-game/code/client/safeStyle.js +42 -0
  109. package/kits/hub-game/code/client/say.js +12 -3
  110. package/kits/hub-game/code/client/shot.js +64 -10
  111. package/kits/hub-game/code/client/shotFit.js +56 -0
  112. package/kits/hub-game/code/client/signIn.js +28 -0
  113. package/kits/hub-game/code/client/state.js +53 -0
  114. package/kits/hub-game/code/client/talk.js +209 -45
  115. package/kits/hub-game/code/client/tiers.js +68 -66
  116. package/kits/hub-game/code/client/together.js +7 -2
  117. package/kits/hub-game/code/client/weakestLookBake.js +92 -0
  118. package/kits/hub-game/code/client/weakestTier.js +295 -0
  119. package/kits/hub-game/code/client/worldLabels.js +241 -0
  120. package/kits/hub-game/code/client/yours.js +10 -9
  121. package/kits/hub-game/code/npcDisplayText.js +55 -0
  122. package/kits/hub-game/code/server/act.js +124 -0
  123. package/kits/hub-game/code/server/actions.js +6 -1
  124. package/kits/hub-game/code/server/actors.js +2 -1
  125. package/kits/hub-game/code/server/analytics.js +83 -0
  126. package/kits/hub-game/code/server/anonymousEntry.js +49 -0
  127. package/kits/hub-game/code/server/arrivalPose.js +36 -0
  128. package/kits/hub-game/code/server/companion.js +28 -3
  129. package/kits/hub-game/code/server/doorAnalytics.js +52 -0
  130. package/kits/hub-game/code/server/earned.js +22 -5
  131. package/kits/hub-game/code/server/frameBatch.js +183 -0
  132. package/kits/hub-game/code/server/friendsAmong.js +49 -9
  133. package/kits/hub-game/code/server/history.js +2 -0
  134. package/kits/hub-game/code/server/hub.js +1306 -95
  135. package/kits/hub-game/code/server/idle.js +30 -1
  136. package/kits/hub-game/code/server/index.js +26 -4
  137. package/kits/hub-game/code/server/invites.js +19 -0
  138. package/kits/hub-game/code/server/labels.js +9 -1
  139. package/kits/hub-game/code/server/loadAbandon.js +106 -0
  140. package/kits/hub-game/code/server/manifest.js +211 -3
  141. package/kits/hub-game/code/server/menu.js +31 -3
  142. package/kits/hub-game/code/server/npcs.js +226 -64
  143. package/kits/hub-game/code/server/observe.js +408 -0
  144. package/kits/hub-game/code/server/padOccupancy.js +85 -0
  145. package/kits/hub-game/code/server/players.js +9 -1
  146. package/kits/hub-game/code/server/resumePose.js +152 -0
  147. package/kits/hub-game/code/server/say.js +1 -1
  148. package/kits/hub-game/code/server/standing.js +4 -5
  149. package/kits/hub-game/code/server/storageLimit.js +187 -0
  150. package/kits/hub-game/code/server/vis.js +67 -5
  151. package/kits/hub-game/code/shared/act.js +35 -0
  152. package/kits/hub-game/code/shared/danceIdle.js +28 -0
  153. package/kits/hub-game/code/shared/loadStages.js +12 -0
  154. package/kits/hub-game/code/shared/quality.js +74 -0
  155. package/kits/hub-game/code/shared/say.js +2 -0
  156. package/kits/hub-game/code/shared/shot.js +35 -1
  157. package/kits/hub-game/code/systems/hub.js +970 -169
  158. package/kits/hub-game/docs/analytics.md +279 -0
  159. package/kits/hub-game/docs/contract.md +1259 -42
  160. package/kits/hub-game/docs/home-pieces.md +9 -2
  161. package/kits/hub-game/docs/observed-progress.md +252 -0
  162. package/kits/hub-game/main.jsx +2 -0
  163. package/kits/hub-game/package-lock.json +10 -3
  164. package/kits/hub-game/package.json +6 -3
  165. package/kits/hub-game/play/player.js +142 -0
  166. package/kits/hub-game/play/registry.js +47 -0
  167. package/kits/hub-game/play.jsx +37 -0
  168. package/kits/hub-game/scripts/check.mjs +39 -5
  169. package/kits/hub-game/scripts/companion-follower-wire.json +1 -1
  170. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +11 -0
  171. package/kits/hub-game/scripts/fixtures/decor-keyless.json +5 -5
  172. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +3 -0
  173. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +19 -3
  174. package/kits/hub-game/scripts/fixtures/interest-legacy.json +3 -3
  175. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -1
  176. package/kits/hub-game/scripts/pose-storage-fixture.mjs +46 -0
  177. package/kits/hub-game/scripts/test-act-client.mjs +186 -0
  178. package/kits/hub-game/scripts/test-act.mjs +171 -0
  179. package/kits/hub-game/scripts/test-action-layout.mjs +80 -0
  180. package/kits/hub-game/scripts/test-action-observers.mjs +46 -0
  181. package/kits/hub-game/scripts/test-actions-client.mjs +367 -2
  182. package/kits/hub-game/scripts/test-actors.mjs +20 -7
  183. package/kits/hub-game/scripts/test-analytics.mjs +76 -0
  184. package/kits/hub-game/scripts/test-anonymous-entry.mjs +28 -0
  185. package/kits/hub-game/scripts/test-arrival-pose-server.mjs +196 -0
  186. package/kits/hub-game/scripts/test-arrival-pose.mjs +24 -0
  187. package/kits/hub-game/scripts/test-ask-slot.mjs +85 -0
  188. package/kits/hub-game/scripts/test-avatar-wire.mjs +49 -10
  189. package/kits/hub-game/scripts/test-avatar.mjs +44 -0
  190. package/kits/hub-game/scripts/test-back-visibility.mjs +82 -0
  191. package/kits/hub-game/scripts/test-ballot.mjs +11 -4
  192. package/kits/hub-game/scripts/test-ban-join.mjs +121 -13
  193. package/kits/hub-game/scripts/test-build.mjs +20 -2
  194. package/kits/hub-game/scripts/test-chat.mjs +206 -5
  195. package/kits/hub-game/scripts/test-companion-chat.mjs +20 -2
  196. package/kits/hub-game/scripts/test-control-layout-dom.mjs +120 -0
  197. package/kits/hub-game/scripts/test-crowd-names.mjs +205 -0
  198. package/kits/hub-game/scripts/test-decor-client.mjs +45 -4
  199. package/kits/hub-game/scripts/test-decor.mjs +7 -0
  200. package/kits/hub-game/scripts/test-default-environment-root.mjs +95 -0
  201. package/kits/hub-game/scripts/test-default-environment.mjs +267 -0
  202. package/kits/hub-game/scripts/test-door-analytics.mjs +58 -0
  203. package/kits/hub-game/scripts/test-door-jump.mjs +100 -0
  204. package/kits/hub-game/scripts/test-earned.mjs +33 -3
  205. package/kits/hub-game/scripts/test-far-avatars.mjs +340 -0
  206. package/kits/hub-game/scripts/test-fps-telemetry.mjs +112 -0
  207. package/kits/hub-game/scripts/test-frame-batch.mjs +252 -0
  208. package/kits/hub-game/scripts/test-fresh-friends.mjs +118 -0
  209. package/kits/hub-game/scripts/test-grab-orbit.mjs +47 -4
  210. package/kits/hub-game/scripts/test-high-only.mjs +170 -0
  211. package/kits/hub-game/scripts/test-hub-ops.mjs +321 -2
  212. package/kits/hub-game/scripts/test-hub-trip.mjs +879 -11
  213. package/kits/hub-game/scripts/test-hud-clear.mjs +162 -59
  214. package/kits/hub-game/scripts/test-hud-defects-dom.mjs +100 -0
  215. package/kits/hub-game/scripts/test-hud-rate.mjs +224 -0
  216. package/kits/hub-game/scripts/test-hud-safe-visibility-dom.mjs +83 -0
  217. package/kits/hub-game/scripts/test-idle.mjs +66 -0
  218. package/kits/hub-game/scripts/test-interest-cells.mjs +20 -0
  219. package/kits/hub-game/scripts/test-interest.mjs +15 -0
  220. package/kits/hub-game/scripts/test-invites-client.mjs +430 -0
  221. package/kits/hub-game/scripts/test-invites.mjs +109 -0
  222. package/kits/hub-game/scripts/test-labels.mjs +71 -3
  223. package/kits/hub-game/scripts/test-landscape-layout.mjs +194 -0
  224. package/kits/hub-game/scripts/test-list-scroll-dom.mjs +49 -0
  225. package/kits/hub-game/scripts/test-load-abandon.mjs +246 -0
  226. package/kits/hub-game/scripts/test-loading-cover.mjs +162 -0
  227. package/kits/hub-game/scripts/test-manifest.mjs +265 -0
  228. package/kits/hub-game/scripts/test-menu-client.mjs +105 -0
  229. package/kits/hub-game/scripts/test-menu.mjs +23 -0
  230. package/kits/hub-game/scripts/test-npcs.mjs +917 -10
  231. package/kits/hub-game/scripts/test-observed.mjs +745 -0
  232. package/kits/hub-game/scripts/test-pad-cues.mjs +304 -0
  233. package/kits/hub-game/scripts/test-pad-occupancy.mjs +177 -0
  234. package/kits/hub-game/scripts/test-picker.mjs +234 -7
  235. package/kits/hub-game/scripts/test-placement-cache.mjs +690 -0
  236. package/kits/hub-game/scripts/test-progress-reset.mjs +559 -0
  237. package/kits/hub-game/scripts/test-push-visit.mjs +26 -0
  238. package/kits/hub-game/scripts/test-quality.mjs +385 -0
  239. package/kits/hub-game/scripts/test-rehello.mjs +699 -5
  240. package/kits/hub-game/scripts/test-resume-action-order.mjs +598 -0
  241. package/kits/hub-game/scripts/test-resume-held.mjs +239 -0
  242. package/kits/hub-game/scripts/test-resume-pose.mjs +142 -0
  243. package/kits/hub-game/scripts/test-safe-events-dom.mjs +116 -0
  244. package/kits/hub-game/scripts/test-safe-layout.mjs +330 -0
  245. package/kits/hub-game/scripts/test-say.mjs +1 -1
  246. package/kits/hub-game/scripts/test-shot.mjs +145 -0
  247. package/kits/hub-game/scripts/test-signin-client.mjs +45 -0
  248. package/kits/hub-game/scripts/test-soundscape.mjs +22 -17
  249. package/kits/hub-game/scripts/test-standing.mjs +35 -2
  250. package/kits/hub-game/scripts/test-storage-limit.mjs +333 -0
  251. package/kits/hub-game/scripts/test-stuck.mjs +5 -4
  252. package/kits/hub-game/scripts/test-talk-overlay-dom.mjs +130 -0
  253. package/kits/hub-game/scripts/test-tiers-render.mjs +86 -13
  254. package/kits/hub-game/scripts/test-tiers.mjs +7 -8
  255. package/kits/hub-game/scripts/test-vis.mjs +433 -6
  256. package/kits/hub-game/scripts/test-weakest-tier.mjs +924 -0
  257. package/kits/hub-game/scripts/test-world-labels.mjs +367 -0
  258. package/kits/hub-game/scripts/test-yours-chrome.mjs +50 -6
  259. package/kits/hub-game/scripts/test-yours.mjs +39 -8
  260. package/kits/multiplayer-3d/castle.json +5 -5
  261. package/kits/multiplayer-3d/code/client/joinFailure.js +27 -0
  262. package/kits/multiplayer-3d/code/client/resumeGate.js +139 -0
  263. package/kits/multiplayer-3d/code/systems/multiplayer.js +369 -30
  264. package/kits/multiplayer-3d/package-lock.json +8 -1
  265. package/kits/multiplayer-3d/package.json +2 -1
  266. package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +436 -0
  267. package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +624 -0
  268. package/kits/physics-2d/CLAUDE.md +10 -1
  269. package/kits/physics-2d/castle.json +2 -2
  270. package/kits/physics-2d/engine/frozenActors.js +233 -0
  271. package/kits/physics-2d/engine/scene.js +87 -5
  272. package/kits/physics-2d/eslint.config.js +1 -1
  273. package/kits/physics-2d/play/behaviors/AnalogStick.js +198 -0
  274. package/kits/physics-2d/play/behaviors/Camera.js +40 -0
  275. package/kits/physics-2d/play/behaviors/Collider.js +122 -0
  276. package/kits/physics-2d/play/behaviors/Draggable.js +115 -0
  277. package/kits/physics-2d/play/behaviors/Goal.js +46 -0
  278. package/kits/physics-2d/play/behaviors/Joints.js +126 -0
  279. package/kits/physics-2d/play/behaviors/Layout.js +71 -0
  280. package/kits/physics-2d/play/behaviors/RigidBody.js +57 -0
  281. package/kits/physics-2d/play/behaviors/Slingshot.js +142 -0
  282. package/kits/physics-2d/play/behaviors/SoundPlayer.js +263 -0
  283. package/kits/physics-2d/play/behaviors/Sprite.js +406 -0
  284. package/kits/physics-2d/play/behaviors/Style.js +209 -0
  285. package/kits/physics-2d/play/behaviors/Text.js +85 -0
  286. package/kits/physics-2d/play/behaviors/Video.js +93 -0
  287. package/kits/physics-3d/CLAUDE.md +25 -1651
  288. package/kits/physics-3d/behaviors/Body.jsx +3 -0
  289. package/kits/physics-3d/behaviors/Model.jsx +3 -0
  290. package/kits/physics-3d/behaviors/Player.jsx +35 -18
  291. package/kits/physics-3d/behaviors/Shape.jsx +3 -0
  292. package/kits/physics-3d/behaviors/Solid.jsx +3 -0
  293. package/kits/physics-3d/behaviors/Transform.jsx +3 -0
  294. package/kits/physics-3d/castle.json +3 -3
  295. package/kits/physics-3d/docs/engine-camera.md +542 -0
  296. package/kits/physics-3d/docs/engine-frame-cap.md +136 -0
  297. package/kits/physics-3d/docs/engine-load.md +149 -0
  298. package/kits/physics-3d/docs/engine-look.md +114 -0
  299. package/kits/physics-3d/docs/engine-shadows.md +372 -0
  300. package/kits/physics-3d/docs/engine-skip-work.md +187 -0
  301. package/kits/physics-3d/docs/engine-sky.md +198 -0
  302. package/kits/physics-3d/docs/engine-static-actors.md +226 -0
  303. package/kits/physics-3d/docs/engine-view.md +37 -0
  304. package/kits/physics-3d/docs/pxmodel-format.md +1 -1
  305. package/kits/physics-3d/engine3d/PlayOnly3D.jsx +5 -1
  306. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +19 -333
  307. package/kits/physics-3d/engine3d/actornode.js +1 -0
  308. package/kits/physics-3d/engine3d/branches.js +3 -13
  309. package/kits/physics-3d/engine3d/cage.js +2 -7
  310. package/kits/physics-3d/engine3d/cageops.js +2 -17
  311. package/kits/physics-3d/engine3d/dataBehaviors.js +12 -0
  312. package/kits/physics-3d/engine3d/framecap.js +4 -1
  313. package/kits/physics-3d/engine3d/frozenphysics.js +140 -0
  314. package/kits/physics-3d/engine3d/frozenstatics.js +273 -0
  315. package/kits/physics-3d/engine3d/gait.js +8 -0
  316. package/kits/physics-3d/engine3d/initialModelFiles.js +18 -0
  317. package/kits/physics-3d/engine3d/look.js +7 -0
  318. package/kits/physics-3d/engine3d/modelFiles.js +3 -17
  319. package/kits/physics-3d/engine3d/modelMath.js +49 -0
  320. package/kits/physics-3d/engine3d/modelready.js +16 -0
  321. package/kits/physics-3d/engine3d/motion.js +3 -3
  322. package/kits/physics-3d/engine3d/nearshadows.js +77 -10
  323. package/kits/physics-3d/engine3d/orbitinput.js +59 -25
  324. package/kits/physics-3d/engine3d/partgeometry.js +1 -16
  325. package/kits/physics-3d/engine3d/paths.js +1 -9
  326. package/kits/physics-3d/engine3d/playTimings.js +50 -0
  327. package/kits/physics-3d/engine3d/playerRun.js +372 -0
  328. package/kits/physics-3d/engine3d/pxmodel.js +3 -3
  329. package/kits/physics-3d/engine3d/rapier.js +27 -0
  330. package/kits/physics-3d/engine3d/scatter.js +1 -11
  331. package/kits/physics-3d/engine3d/shadowfade.js +23 -15
  332. package/kits/physics-3d/engine3d/sky.js +1 -1
  333. package/kits/physics-3d/engine3d/squarefirst.js +177 -0
  334. package/kits/physics-3d/engine3d/stillshadows.js +399 -0
  335. package/kits/physics-3d/engine3d/sweep.js +1 -25
  336. package/kits/physics-3d/engine3d/world3d.js +468 -18
  337. package/kits/physics-3d/eslint.config.js +2 -1
  338. package/kits/physics-3d/main.jsx +6 -3
  339. package/kits/physics-3d/package-lock.json +7 -0
  340. package/kits/physics-3d/package.json +5 -1
  341. package/kits/physics-3d/play/behaviors/Body.js +31 -0
  342. package/kits/physics-3d/play/behaviors/Door.js +37 -0
  343. package/kits/physics-3d/play/behaviors/Lookable.js +16 -0
  344. package/kits/physics-3d/play/behaviors/Model.js +23 -0
  345. package/kits/physics-3d/play/behaviors/Pickup.js +46 -0
  346. package/kits/physics-3d/play/behaviors/Player.js +1204 -0
  347. package/kits/physics-3d/play/behaviors/Shape.js +47 -0
  348. package/kits/physics-3d/play/behaviors/Solid.js +16 -0
  349. package/kits/physics-3d/play/behaviors/Transform.js +29 -0
  350. package/kits/physics-3d/pnpm-lock.yaml +8 -0
  351. package/kits/physics-3d/scripts/bench-shadow-fade.mjs +37 -0
  352. package/kits/physics-3d/scripts/build-rapier-gz.mjs +56 -0
  353. package/kits/physics-3d/scripts/frozen-statics-fixture.mjs +141 -0
  354. package/kits/physics-3d/scripts/test-camera-follow.mjs +5 -1
  355. package/kits/physics-3d/scripts/test-camera-orbit.mjs +52 -4
  356. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +1 -1
  357. package/kits/physics-3d/scripts/test-empty-gait-hints.mjs +89 -0
  358. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +6 -3
  359. package/kits/physics-3d/scripts/test-frame-cap.mjs +1 -1
  360. package/kits/physics-3d/scripts/test-frozen-nested.mjs +49 -0
  361. package/kits/physics-3d/scripts/test-frozen-statics-legacy-physics2d.mjs +123 -0
  362. package/kits/physics-3d/scripts/test-frozen-statics.mjs +434 -0
  363. package/kits/physics-3d/scripts/test-look-bake.mjs +1 -1
  364. package/kits/physics-3d/scripts/test-near-shadows.mjs +2 -2
  365. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +88 -7
  366. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +40 -3
  367. package/kits/physics-3d/scripts/test-orbit-shot.mjs +75 -1
  368. package/kits/physics-3d/scripts/test-rapier-gz.mjs +106 -0
  369. package/kits/physics-3d/scripts/test-sky.mjs +1 -1
  370. package/kits/physics-3d/scripts/test-square-first.mjs +921 -0
  371. package/kits/physics-3d/scripts/test-static-actors.mjs +3 -1
  372. package/kits/physics-3d/scripts/test-static-physics.mjs +4 -1
  373. package/kits/physics-3d/scripts/test-static-scenery.mjs +5 -2
  374. package/kits/physics-3d/scripts/test-steady-hover.mjs +5 -2
  375. package/kits/physics-3d/scripts/test-still-shadows.mjs +477 -0
  376. package/kits/physics-3d/systems/physics3d.js +37 -4
  377. package/kits/real-time/castle.json +2 -2
  378. package/kits/real-time/code/client/connection.js +33 -10
  379. package/kits/real-time/code/client/gameHooks.js +2 -0
  380. package/kits/real-time/code/client/joinOverlay.js +9 -4
  381. package/kits/real-time/code/server/session.js +6 -4
  382. package/kits/real-time/package-lock.json +1 -1
  383. package/package.json +2 -2
@@ -0,0 +1,117 @@
1
+ // One client-side lease for every question card in the town's shared ask
2
+ // slot. The server owns each offer; this only decides how long a displayed
3
+ // card remains actionable on this client.
4
+ export const ASK_SLOT_MS = 12_000;
5
+ export const ASK_SLOT_DISTANCE_M = 3;
6
+
7
+ const finiteAt = (at) => at && Number.isFinite(at.x) && Number.isFinite(at.z) ? { x: at.x, z: at.z } : null;
8
+
9
+ export function askSlotKey(ask) {
10
+ if (typeof ask?.slotKey === 'string') {
11
+ return ask.slotKey;
12
+ }
13
+ if (!ask || typeof ask.key !== 'string') {
14
+ return null;
15
+ }
16
+ return ask.key;
17
+ }
18
+
19
+ export function padsAt(scene, at, hidden = new Set()) {
20
+ const point = finiteAt(at);
21
+ if (!point || typeof scene?.getActors !== 'function') {
22
+ return new Set();
23
+ }
24
+ const pads = new Set();
25
+ for (const actor of scene.getActors()) {
26
+ if (hidden.has(actor?.id)) {
27
+ continue;
28
+ }
29
+ const pad = actor?.components?.HubPad;
30
+ const t = actor?.components?.Transform;
31
+ if (!pad || !Number.isFinite(t?.x) || !Number.isFinite(t?.z)) {
32
+ continue;
33
+ }
34
+ const radius = pad.radius ?? actor.components.Shape?.radius ?? 2.3;
35
+ if (Number.isFinite(radius) && radius >= 0 && Math.hypot(point.x - t.x, point.z - t.z) <= radius) {
36
+ pads.add(actor.id);
37
+ }
38
+ }
39
+ return pads;
40
+ }
41
+
42
+ export function makeAskSlot() {
43
+ const shown = new Map();
44
+
45
+ function frame(at, pads, now) {
46
+ const point = finiteAt(at);
47
+ const on = pads instanceof Set ? pads : new Set(pads ?? []);
48
+ for (const record of shown.values()) {
49
+ if (record.expired) {
50
+ continue;
51
+ }
52
+ const enteredPad = [...on].some((id) => !record.pads.has(id));
53
+ if (now - record.shownAt >= ASK_SLOT_MS ||
54
+ (point && record.at && Math.hypot(point.x - record.at.x, point.z - record.at.z) >= ASK_SLOT_DISTANCE_M) ||
55
+ enteredPad) {
56
+ record.expired = true;
57
+ }
58
+ record.pads = new Set(on);
59
+ }
60
+ }
61
+
62
+ function display(ask, at, pads, now) {
63
+ frame(at, pads, now);
64
+ const key = askSlotKey(ask);
65
+ if (!key) {
66
+ return null;
67
+ }
68
+ let record = shown.get(key);
69
+ if (!record) {
70
+ // Each producer can have only one current occurrence. Replacing an
71
+ // occurrence of that kind bounds retention without evicting a still
72
+ // eligible lower-priority kind (for example an expired Your games card
73
+ // hidden by many later invitations).
74
+ for (const [oldKey, old] of shown) {
75
+ if (old.kind === ask.kind) {
76
+ shown.delete(oldKey);
77
+ }
78
+ }
79
+ record = { kind: ask.kind, shownAt: now, at: finiteAt(at), pads: new Set(pads ?? []), expired: false };
80
+ shown.set(key, record);
81
+ }
82
+ return record.expired ? null : ask;
83
+ }
84
+
85
+ function accepts(ask, at, pads, now) {
86
+ frame(at, pads, now);
87
+ const record = shown.get(askSlotKey(ask));
88
+ return Boolean(record && !record.expired);
89
+ }
90
+
91
+ function retire(ask) {
92
+ const record = shown.get(askSlotKey(ask));
93
+ if (record) {
94
+ record.expired = true;
95
+ }
96
+ }
97
+
98
+ function known(ask) {
99
+ return shown.has(askSlotKey(ask));
100
+ }
101
+
102
+ function expired(ask) {
103
+ return shown.get(askSlotKey(ask))?.expired === true;
104
+ }
105
+
106
+ return {
107
+ frame,
108
+ display,
109
+ accepts,
110
+ retire,
111
+ known,
112
+ expired,
113
+ clear() {
114
+ shown.clear();
115
+ },
116
+ };
117
+ }
@@ -192,7 +192,9 @@ function transportFailure(error) {
192
192
  return typeof code !== 'string' || code === 'CASTLE_HOST_UNAVAILABLE';
193
193
  }
194
194
  const RETRY_BUDGET = 180000;
195
- let retryClock = { now: () => Date.now(), setTimeout, clearTimeout };
195
+ // Wrapped, not passed through: browser timers throw "Illegal invocation" when called as a method of another object.
196
+ const realClock = { now: () => Date.now(), setTimeout: (fn, ms) => setTimeout(fn, ms), clearTimeout: (id) => clearTimeout(id) };
197
+ let retryClock = realClock;
196
198
  const retryChains = new Set();
197
199
 
198
200
  // A chain holds its read/write slot during backoff as well as during requests.
@@ -425,7 +427,7 @@ function write(scene) {
425
427
  // Tests only.
426
428
  export function resetPlatformForTests(api, clock) {
427
429
  for (const cancel of retryChains) { cancel(); }
428
- retryClock = clock ?? { now: () => Date.now(), setTimeout, clearTimeout };
430
+ retryClock = clock ?? realClock;
429
431
  apiOverride = api;
430
432
  Object.assign(platform, { state: 'idle', confirmed: null, color: 0, colors: false, desiredColor: null, desired: null, writing: null, retries: 0, lastError: null });
431
433
  }
@@ -1,3 +1,4 @@
1
+ import { ensureActorModel } from './modelReady.js';
1
2
  // Players drawn from different avatar models share their materials.
2
3
  //
3
4
  // The engine builds each model file once and every actor placing it shares
@@ -238,6 +239,7 @@ export function share(scene, actorIds) {
238
239
  return;
239
240
  }
240
241
  for (const actorId of actorIds) {
242
+ ensureActorModel(scene.three, actorId);
241
243
  const rig = rigOf(nodes.get(actorId)?.node);
242
244
  if (rig) {
243
245
  shareRig(rig);
@@ -0,0 +1,13 @@
1
+ import { landscapeViewport } from './landscapeLayout.js';
2
+
3
+ // Old Android hosts replace their hub Back with Exit deck in landscape.
4
+ // New hosts advertise the capability before content starts and after loading.
5
+ // All other hosts retain the original division of Back controls.
6
+ export function kitBackNeeded(view = globalThis.window) {
7
+ return (
8
+ view?.CastleEmbed?.host === 'mobile' &&
9
+ view.CastleEmbed.hubBackInLandscape !== true &&
10
+ /Android/i.test(view.navigator?.userAgent ?? '') &&
11
+ landscapeViewport(view)
12
+ );
13
+ }
@@ -68,6 +68,7 @@ export function tapMessage(card, ids) {
68
68
  const own = (obj, id) => (obj && typeof obj === 'object' && Object.hasOwn(obj, id) ? obj[id] : undefined);
69
69
 
70
70
  import { AVATAR_FACES } from './avatarFaces.js';
71
+ import { landscapeViewport } from './landscapeLayout.js';
71
72
 
72
73
  const Z = 2147480001;
73
74
  const GOLD = '#ffd84a';
@@ -227,7 +228,7 @@ function el(tag, style, parent) {
227
228
  }
228
229
 
229
230
  // `send(ids)` sends a tap; `onChip()` (optional) is the soundscape's chip tap.
230
- export function makeBallot({ send, onChip }) {
231
+ export function makeBallot({ safeInsets = false, send, onChip }) {
231
232
  let root = null;
232
233
  let sheet = null;
233
234
  let countdown = null;
@@ -323,13 +324,16 @@ export function makeBallot({ send, onChip }) {
323
324
  // scrolling on its own, so the chips stay in view whatever the faces do.
324
325
  // `focus` (a face was just picked) brings the chips or Vote into view.
325
326
  function draw(card, landscape, now, maxH, focus) {
326
- const scrolls = [...sheet.children].map((child) => child.scrollTop);
327
+ const scrollBox = (child) => Array.from(child.children ?? []).find((node) => node.dataset.ballotScroll === 'true') ?? child;
328
+ const scrolls = [...sheet.children].map((child) => scrollBox(child).scrollTop);
327
329
  const scroll = sheet.scrollTop;
328
330
  sheet.replaceChildren();
329
- Object.assign(sheet.style, landscape ? { flexDirection: 'row', overflowY: 'hidden', gap: '12px' } : { flexDirection: 'column', overflowY: 'auto', gap: '10px' });
330
- const column = (flex) => el('div', { flex, minWidth: '0', maxHeight: `${Math.round(maxH - 24)}px`, overflowY: 'auto', overscrollBehavior: 'contain', display: 'flex', flexDirection: 'column', gap: '8px' }, sheet);
331
+ Object.assign(sheet.style, landscape ? { height: `${Math.round(maxH)}px`, flexDirection: 'row', overflowY: 'hidden', gap: '12px' } : { height: '', flexDirection: 'column', overflowY: 'auto', gap: '10px' });
332
+ const column = (flex, scrollable = true) => el('div', { flex, minWidth: '0', minHeight: '0', overflowY: scrollable ? 'auto' : 'hidden', overscrollBehavior: 'contain', display: 'flex', flexDirection: 'column', gap: '8px' }, sheet);
331
333
  const left = landscape ? column('1 1 56%') : sheet;
332
- const right = landscape ? column('1 1 44%') : sheet;
334
+ const right = landscape ? column('1 1 44%', false) : sheet;
335
+ const rightBody = landscape ? el('div', { flex: '1 1 auto', minHeight: '0', overflowY: 'auto', overscrollBehavior: 'contain', display: 'flex', flexDirection: 'column', gap: '8px' }, right) : right;
336
+ if (landscape) {rightBody.dataset.ballotScroll = 'true';}
333
337
  const head = el('div', { display: 'flex', alignItems: 'center', gap: '10px', flex: 'none' }, left);
334
338
  const title = el('div', { flex: '1', minWidth: '0', font: '800 17px/1.25 system-ui, sans-serif' }, head);
335
339
  title.textContent = card.title ?? '';
@@ -350,7 +354,7 @@ export function makeBallot({ send, onChip }) {
350
354
  }
351
355
  const hint = hintOf(card, lines, sel, selfId);
352
356
  if (hint) {
353
- el('div', { flex: 'none', font: '600 15px/1.3 system-ui, sans-serif', color: '#e9c48f' }, landscape ? right : left).textContent = hint;
357
+ el('div', { flex: 'none', font: '600 15px/1.3 system-ui, sans-serif', color: '#e9c48f' }, landscape ? rightBody : left).textContent = hint;
354
358
  }
355
359
  if (card.faces.length) {
356
360
  const grid = el('div', { flex: 'none', display: 'grid', gridTemplateColumns: `repeat(auto-fill, minmax(${landscape ? 70 : 72}px, 1fr))`, gap: '8px' }, left);
@@ -358,7 +362,7 @@ export function makeBallot({ send, onChip }) {
358
362
  faceCell(grid, card, face, landscape);
359
363
  }
360
364
  }
361
- const chips = el('div', { flex: 'none', display: 'flex', flexWrap: 'wrap', gap: '8px' }, right);
365
+ const chips = el('div', { flex: 'none', display: 'flex', flexWrap: 'wrap', gap: '8px' }, rightBody);
362
366
  if (card.mode === 'talk') {
363
367
  for (const id of card.lines) {
364
368
  const line = lineOf(lines, id);
@@ -395,7 +399,7 @@ export function makeBallot({ send, onChip }) {
395
399
  }
396
400
  if (landscape) {
397
401
  [...sheet.children].forEach((child, i) => {
398
- child.scrollTop = scrolls[i] ?? 0;
402
+ scrollBox(child).scrollTop = scrolls[i] ?? 0;
399
403
  });
400
404
  } else {
401
405
  sheet.scrollTop = scroll;
@@ -412,6 +416,7 @@ export function makeBallot({ send, onChip }) {
412
416
  }
413
417
 
414
418
  return {
419
+ surface: () => root ? sheet : null,
415
420
  // `card` is this player's card (`hub-ballot-card`) or null; `placeLines`
416
421
  // the place's manifest lines; `simNow` the simulation time now;
417
422
  // `hudBottom` the bottom of a clear HUD's box in CSS px, or 0 (the card
@@ -436,10 +441,10 @@ export function makeBallot({ send, onChip }) {
436
441
  const now = performance.now();
437
442
  const w = window.innerWidth;
438
443
  const h = window.innerHeight;
439
- const landscape = w > h && h < 520;
444
+ const landscape = landscapeViewport(window);
440
445
  const maxH = Math.max(160, Math.min(h * 0.6, h - hudBottom - 8));
441
446
  sheet.style.maxHeight = `${Math.round(maxH)}px`;
442
- sheet.style.width = landscape ? 'min(100%, 820px)' : 'min(100%, 560px)';
447
+ sheet.style.width = landscape ? 'min(56vw, max(220px, calc(100vw - 344px)), 560px)' : 'min(100%, 560px)';
443
448
  const pending = sel.pending !== null && now - sel.pending < PENDING_MS;
444
449
  const next = JSON.stringify([card, sel.face, sel.option, pending, lines, selfId, landscape, Math.round(maxH)]);
445
450
  if (next !== key) {
@@ -20,3 +20,19 @@ export function buildStamp(json) {
20
20
  ...(json.dirty === true ? { dirty: true } : {}),
21
21
  });
22
22
  }
23
+
24
+ // Hidden page evidence for QA, independent of the player's visible HUD.
25
+ // Missing stamps leave the DOM exactly as it was.
26
+ export function showBuildStamp(stamp, doc = globalThis.document) {
27
+ if (!stamp || !doc?.body) {return;}
28
+ let node = doc.getElementById('hub-build-stamp');
29
+ if (!node) {
30
+ node = doc.createElement('script');
31
+ node.id = 'hub-build-stamp';
32
+ node.type = 'application/json';
33
+ node.hidden = true;
34
+ doc.body.appendChild(node);
35
+ }
36
+ const json = JSON.stringify(stamp);
37
+ if (node.textContent !== json) {node.textContent = json;}
38
+ }
@@ -26,6 +26,7 @@ export function makeChat() {
26
26
  // Counts sessions: an answer that lands after a reset belongs to the last
27
27
  // session and is dropped.
28
28
  let generation = 0;
29
+ const blocked = new Set();
29
30
  const c = {
30
31
  // Whether this player may chat at all, and the user ids here they may
31
32
  // chat with; null until the host has answered.
@@ -34,7 +35,8 @@ export function makeChat() {
34
35
  // Messages not yet shown: [{ id, fromUserId, fromUsername, text, mine }].
35
36
  incoming: [],
36
37
 
37
- available: () => !off && typeof castleSdk.Hub?.chat === 'function' && typeof castleSdk.Hub?.say === 'function',
38
+ available: () =>
39
+ !off && typeof castleSdk.Hub?.chat === 'function' && typeof castleSdk.Hub?.say === 'function',
38
40
 
39
41
  // Asks the host what there is to read, on its cadence. `active` is false
40
42
  // during a trip or away from any place.
@@ -62,10 +64,14 @@ export function makeChat() {
62
64
  // player arrived is not replayed.
63
65
  const first = cursor === null && c.peers === null;
64
66
  c.canChat = answer.canChat === true;
65
- c.peers = Array.isArray(answer.peers) ? answer.peers.map(String) : [];
67
+ c.peers = Array.isArray(answer.peers)
68
+ ? answer.peers.map(String).filter((id) => !blocked.has(id))
69
+ : [];
66
70
  if (!first) {
67
71
  for (const m of answer.messages ?? []) {
68
- c.incoming.push({ ...m, mine: false });
72
+ if (!blocked.has(String(m.fromUserId))) {
73
+ c.incoming.push({ ...m, mine: false });
74
+ }
69
75
  }
70
76
  }
71
77
  cursor = answer.cursor ?? cursor;
@@ -99,7 +105,9 @@ export function makeChat() {
99
105
  // Sends `text`; `done(status)` hears ghost's answer: "sent", "none"
100
106
  // (nobody here may read it), "limited", "refused" or "unavailable".
101
107
  send(text, done = () => {}) {
102
- const words = String(text ?? '').trim().slice(0, 200);
108
+ const words = String(text ?? '')
109
+ .trim()
110
+ .slice(0, 200);
103
111
  if (!words || sending || !c.available()) {
104
112
  return;
105
113
  }
@@ -111,7 +119,13 @@ export function makeChat() {
111
119
  return;
112
120
  }
113
121
  if (answer?.status === 'sent') {
114
- c.incoming.push({ id: answer.id ?? null, fromUserId: null, fromUsername: null, text: words, mine: true });
122
+ c.incoming.push({
123
+ id: answer.id ?? null,
124
+ fromUserId: null,
125
+ fromUsername: null,
126
+ text: words,
127
+ mine: true,
128
+ });
115
129
  }
116
130
  done(answer?.status ?? 'unavailable');
117
131
  })
@@ -131,6 +145,28 @@ export function makeChat() {
131
145
  .catch(() => done(false));
132
146
  },
133
147
 
148
+ reportAndBlock(messageId, userId, done = () => {}) {
149
+ if (typeof castleSdk.Hub?.reportChat !== 'function' || !messageId || !userId) {
150
+ done(false);
151
+ return;
152
+ }
153
+ const asked = generation;
154
+ Promise.resolve(castleSdk.Hub.reportChat(messageId, { block: true }))
155
+ .then((answer) => {
156
+ if (asked !== generation) {
157
+ return;
158
+ }
159
+ const ok = answer?.status === 'ok' && answer.blocked === true;
160
+ if (ok) {
161
+ blocked.add(String(userId));
162
+ c.peers = c.peers?.filter((id) => String(id) !== String(userId)) ?? null;
163
+ c.incoming = c.incoming.filter((m) => String(m.fromUserId) !== String(userId));
164
+ }
165
+ done(ok);
166
+ })
167
+ .catch(() => asked === generation && done(false));
168
+ },
169
+
134
170
  // Another session: the cursor and what was read belong to the last one.
135
171
  reset() {
136
172
  generation += 1;
@@ -0,0 +1,5 @@
1
+ // A scene opt-in; existing scenes retain their report-only chat controls.
2
+ export function chatModerationEnabled(scene) {
3
+ const marker = scene?.getActor?.('hub-chat-moderation')?.components?.HubChatModeration;
4
+ return marker?.v === 1 && Object.keys(marker).length === 1;
5
+ }