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,279 @@
1
+ # Server analytics — optional contracts v1.93 and v1.111
2
+
3
+ Set `hub.analytics: true` in castle.json to opt the main place into server analytics.
4
+ A place without the key creates no analytics state, browser listeners or new wire
5
+ fields. Its public place description is byte-identical. Player UI is unchanged.
6
+ The town and house opt in; other decks retain their existing behavior.
7
+
8
+ Contract v1.111 adds `hub.analyticsV111: true`, valid only beside
9
+ `hub.analytics: true`. It enables Ghost-owned invite and admission events. The
10
+ flag is stored in the saved server config and immutable session pin, but never
11
+ extends the host's three-key hub spec or any client wire shape. Existing saved
12
+ towns stay off until a named saver explicitly adds it. Kinds 21–25 cannot be
13
+ sent through authored `hub.track` calls.
14
+
15
+ The server context gains `hub.track(playerId, eventName, properties = {})`.
16
+ It returns whether a best-effort delivery was attempted. Delivery failures never
17
+ interrupt gameplay. Older SDKs/hosts silently do nothing. Numeric properties are
18
+ `subject` (0..65535), `value` (0..2147483647), `result` (0..255), and `flags` (0..3).
19
+ Unknown fields, strings, nulls, nonintegers, other identities and unknown players
20
+ are refused. The platform stamps identity and town attribution and owns flags;
21
+ callers cannot label a house guest as its owner. No typed text, furniture or pet
22
+ name, NPC reply, or other player's id is sent.
23
+
24
+ The SDK method is `session.hub.track(playerId, { kind, subject?, value?, result?, flags? })`.
25
+ It uses the existing generic storage platform channel (`hubTrack`), so the runtime
26
+ image and web/app hosts need no change. The cauldron host-agent must support the
27
+ operation; its deployment requires an AMI rollout. Ghost accepts it only for an
28
+ opted-in immutable session pin. The three-key hub spec stays unchanged.
29
+
30
+ ClickHouse writes built-in `event_type_id=9` (Hub Event), with integer properties
31
+ in this order: kind, subject, value, result, flags. `deck_id` is the town's id,
32
+ including house events whose pinned owner door leads from that town. Creator plays
33
+ and anonymous accounts are excluded. Counts use `sum(event_count)`. Flags bit 1
34
+ means own house; bit 0 is set only on the platform-generated first-use marker.
35
+
36
+ | Kind | Event | Meaning |
37
+ | --- | --- | --- |
38
+ | 1 | arrive | Town arrival; result 1 direct/unknown source, 2 door return; reconnect separate |
39
+ | 2 | door_enter | First successful fenced transition commit; result 1 game, 2 owner-house, 3 classic cabinet |
40
+ | 3 | door_exit | Successful back transition; value is trip ms, result 0 means duration unknown |
41
+ | 4 | game_result | Successfully persisted platform result; result 1 win, 2 lose, 3 draw; rounded nonnegative score in value |
42
+ | 5 / 6 | activity_start / activity_end | Accepted interaction span; duration is last minus first interaction |
43
+ | 7 | outcome | Validated activity action; result vocabulary below |
44
+ | 8 | first_play | Platform first use of a door/activity per town/account/subject within 90 days |
45
+ | 9 | pointer_stage | First-visit flow stage: subject 0 home, 1 like, 2 play, 3 stamp, 4 done |
46
+ | 10 | reconnect | Restored connection; never another first arrival |
47
+ | 11 | session_end | Connected segment duration; reason unknown (0) |
48
+ | 12 / 13 | furniture_placed / furniture_moved | Accepted owner layout mutation; count in value |
49
+ | 14 | pet_named | Accepted save name change; only a count, never the name |
50
+ | 15 | guestbook_signed | Confirmed stamp write; no stamp image, name or text |
51
+ | 16 / 17 | house_visit / house_time | Entry and connected segment duration, subject 10; owner flag stamped by platform |
52
+ | 18 | npc_chat_count | Accepted NPC conversation opened; count only |
53
+ | 19 / 20 | token_earned / token_spent | Confirmed positive amount; no raw transaction strings |
54
+ | 21 | invite_sent | An invite row committed and its link was made; subject 0 town or 10 house; value 1, result 0 |
55
+ | 22 | invite_opened | First successful resolution of a token by this invitee; subject is the resolved town/house destination; value 1, result 0 |
56
+ | 23 | invite_joined | First verified arrival completion for the resolved invite; subject is the admitted town/house; value 1, result 0 |
57
+ | 24 | arrival_source | Successful platform admission; subject 0 town or 10 house; value 1; source is in result |
58
+ | 25 | join_failed | Refused/failed public town admission at Ghost's outer resolver boundary; subject 0 town or 10 house; value 0; fixed reason is in result |
59
+ | 27 | load_abandoned | v1.138 `loadTelemetry`: a town connection that never arrived; subject is the load stage, value ms from connect (≤ 120000), result 1 closed, 2 timeout; never an arrival |
60
+
61
+ Arrival-source results: 0 unknown, 1 direct, 2 invite, 3 door return, 4 return
62
+ from an owner house, 5 push, 6 explore. Push is reserved and is not emitted: Ghost has no
63
+ trusted push evidence today, so it never infers push from caller input. Explore is
64
+ a direct town admission that consumes the stamp Ghost's own Explore panel tap
65
+ mutation left for that user in the previous two minutes; an invite outranks it. Direct
66
+ means a successful public root-town admission, not an arbitrary child-deck join.
67
+ Door/house returns emit only after the fenced transition commit. This is a
68
+ platform admission event; kinds 1 and 16 remain the later, actual kit avatar
69
+ arrival.
70
+
71
+ Join-failure results: 0 unknown, 1 cancelled, 2 full, 3 unavailable, 4 not
72
+ found, 5 forbidden, 6 party required, 7 account required, 8 gated, 9 banned,
73
+ 10 rate limited, 11 invite invalid, 12 invite expired, 13 invite exhausted,
74
+ 14 invite not resolved, 15 invite not in session. The boundary includes Ghost
75
+ gate, ban, rate and invite refusals, and emits once after all internal layer
76
+ probes. It does not claim browser load, network, app launch or client-rendering
77
+ failures that Ghost cannot observe. An unauthenticated refusal has no trusted
78
+ user identity and therefore cannot become a creator event; code 7 is reserved
79
+ for authenticated account-state refusals.
80
+
81
+ Invite retries use the committed arrival row: `invite_opened` and
82
+ `invite_joined` each emit only on its first state transition. Public admission
83
+ source is deduplicated for ten minutes by player, admitted session and source;
84
+ a new register nonce in the same session cannot replay it, while a later invite
85
+ admission remains distinct from an earlier direct admission. Callback and
86
+ ClickHouse delivery failures never alter invite or join responses.
87
+
88
+ Subjects: 0 town; 1 tag (reserved for an overworld tag activity); 2 garden;
89
+ 3 boat; 4 fishing; 5 jobs; 6 lanterns; 7 stamps; 8 market; 9 NPC;
90
+ 10 house. Door subjects are `100 + cauldron_hub_door_id`, a stable platform row
91
+ identity, not a hash or sorted index. Join that dictionary for display names.
92
+ The existing tag door's wins are game_result/win for that door subject; there is
93
+ no separate overworld tag module in the current town to emit a second outcome.
94
+ Results use the player's committed visit and return ticket, including shared layers
95
+ and rotating game doors. A mismatched/expired trip is omitted. Classic cabinet
96
+ scores are outside this server result path.
97
+
98
+ Outcome results: garden 1 planted / 2 harvested (value yield); boat 1 voyage sent /
99
+ 2 returned and claimed; fishing 1 caught; jobs 1 completed; lanterns 1 found;
100
+ stamps 1 awarded; market 1 confirmed purchase (value price). Fishing starts on an accepted cast; jobs start on a confirmed progress save.
101
+ Other spans start with their first accepted outcome. Activity spans end
102
+ after 30s without an accepted interaction or on departure. Their reported duration
103
+ excludes that idle tail. One interaction has zero span duration. NPC count and
104
+ house visits are separate event kinds, not fabricated activity spans.
105
+
106
+ First-arrival cohorts use the earliest town-arrival row with prior_play_count=0
107
+ and exclude pre-existing players from the new-user denominator. Audience history
108
+ is the existing platform's eventual play-history context; it is not a new exact
109
+ first-ever counter. First-use markers use a bounded 90-day Redis key: telemetry
110
+ loss can lose a marker, so analytical first use is derived from start/enter rows.
111
+ ClickHouse itself expires history after three months; dashboards must disclose
112
+ that horizon and the instrumentation launch date.
113
+
114
+ Durations are connected/interaction time, not active foreground time. Shutdown,
115
+ crash and lost telemetry may censor a segment. Reconnects may split it. Do not
116
+ interpret missing end events as zero or claim causal retention lift from observed
117
+ engagement. Early exposure and house-investment windows close before D7 outcomes.
118
+
119
+ Town/house opt-ins ship via the named SAVE 11 saver. This card does not save either
120
+ production deck. Validate QA ingestion only after Ghost and the new host capability
121
+ are live; a silent old host is a compatibility check, not successful ingestion QA.
122
+
123
+ Query templates and read instructions: `experiments/hub-town/analytics/` in the repository.
124
+
125
+ ## FPS summaries (optional)
126
+
127
+ The main place may add `hub.fpsTelemetry` beside `analytics: true`:
128
+
129
+ ```json
130
+ "fpsTelemetry": {
131
+ "buildSha": "0123456789abcdef0123456789abcdef01234567",
132
+ "scene": "scenes/main.scene"
133
+ }
134
+ ```
135
+
136
+ The saver must stamp the exact source commit being assembled and the main scene.
137
+ Ghost pins both strings with the session; clients cannot supply build attribution.
138
+ Absent configuration adds no FPS listeners, messages or measurement state. This is
139
+ independent of `?hubstats`; that query parameter still controls only the local HUD/log.
140
+ Deploy Ghost's kind-26 support and a host-agent AMI whose analytics broker accepts
141
+ kind 26 before enabling this configuration in a saved deck. Older host brokers
142
+ reject it and the SDK returns false without interrupting gameplay.
143
+
144
+ The browser collects at most 60 one-second foreground FPS samples, sends one summary
145
+ per foreground minute (at most 60 samples), and flushes remaining whole-second samples before a kit hub trip,
146
+ on pagehide or disposal. Hidden intervals do not contribute samples. A departure
147
+ with no remaining samples sends nothing. Collection pauses during trips. Each town,
148
+ House or mounted door game must enable its own saved configuration. The current
149
+ server snapshot supplies that opt-in, bound to its multiplayer transport; a town's
150
+ configuration never enables a destination, even if their scene paths match.
151
+ Changing transports starts a fresh timing interval and keeps pending reports on
152
+ the original connection. Closing/crashing or a lost socket may
153
+ lose the final report; delivery is best effort. The kit authenticates the sender,
154
+ requires an arrived player, validates all fields, and accepts at most one periodic
155
+ and one final report per player per 60 seconds. Reports contain no user-supplied text.
156
+
157
+ Kind 26 uses subject for render tier (0 unknown, 1 low, 2 high, 3 weakest), value
158
+ for `medianTenths * 4096 + p10Tenths`, and result for the last visible avatar count
159
+ (including self, clamped to 255). Each percentile is the nearest-rank percentile of
160
+ one-second rates, rounded to tenths and capped at 409.5 FPS. The tier is the render
161
+ profile at the end of the window, including manual graphics choices; it is not a
162
+ hardware model or immutable device classification. Flags retain their existing
163
+ platform meaning. Ghost adds `hub:build_sha` and `hub:scene` in the existing event
164
+ variants map, preserving experiment assignments. Source provenance uses
165
+ `hub:source_deck_id` (the immutable session pin's deck) and `hub:source_kind`
166
+ (`town`, `house`, or `door`). A committed game trip also supplies
167
+ `hub:door_subject`, including rotating/shared doors. No database migration is required.
168
+
169
+ The readout separates exact source decks and town/House/door rows, then groups by
170
+ exact build SHA, render tier and scene, with a separate QA
171
+ mode. Its FPS columns are the median of window medians and median of window p10s,
172
+ weighted by event_count. They are summaries of windows, not reconstructed global
173
+ frame percentiles; short departure windows carry equal weight. Reports, users,
174
+ and average nearby-avatar count expose the sample size and load. Missing rows
175
+ are not zero FPS. See `experiments/hub-town/analytics/fps.sql`.
176
+
177
+ ## Door analytics (v1.133)
178
+
179
+ Door sessions send four numeric kinds through `session.hub.track`. Ghost uses the
180
+ player's current committed visit and top return ticket to stamp the town and door
181
+ subject (`100 + row id`); callers leave subject absent. Shared layers and rotating
182
+ doors use that ticket rather than the door's current destination. Classic and house
183
+ tickets are excluded. The originating town must have `hub.analytics: true`. A
184
+ standalone door without a committed trip records nothing. No migration is needed.
185
+
186
+ | Kind | Event | Value | Result |
187
+ | --- | --- | --- | --- |
188
+ | 28 | round_start | Actual admitted group size (1–256) | 0 |
189
+ | 29 | round_end | Rounded connected simulation seconds | 1 finished, 2 quit, 3 disconnect |
190
+ | 30 | door_progress | Positive coin amount or unlock count | 1 coins, 2 unlocks |
191
+ | 31 | door_error | Count (1–60) | 1 visible render stall, 2 client exception |
192
+
193
+ Result places automatically start a per-player round at arrival and finish it at
194
+ the first accepted result or `hub.end`/duration limit. A later end/leave does not
195
+ emit a second end. Leave without an end is disconnect; the kit Back control reports
196
+ quit to its current server before travel. A lost quit message may be censored or
197
+ appear as disconnect. A resumed connection starts a new connected segment; these
198
+ are visit segments, including gathering/countdown time, rather than competitive
199
+ round boundaries. They must not be presented as exact active play time.
200
+
201
+ Server `hub.track` also accepts these names in places without the legacy analytics
202
+ opt-in. Custom round loops call it twice for each participating player:
203
+
204
+ ```js
205
+ hub.track(playerId, 'round_start', { value: admittedPlayers.length });
206
+ // On completion (or result 2 quit / 3 disconnect):
207
+ hub.track(playerId, 'round_end', { result: 1 });
208
+ ```
209
+
210
+ Start is ignored while a segment is open; end computes duration on the server.
211
+ Set `hub.analyticsRounds: 'authored'` on a custom-loop deck to suppress the
212
+ automatic arrival start and generic result/end completion. The game closes each
213
+ round explicitly; kit Back/disconnect still close interrupted rounds. Nightwatch, Market Sneaks and Color Call opt into this mode
214
+ and call at their own round enrollment and settlement boundaries. Other result
215
+ doors retain the automatic visit segment; continuous non-result places have no
216
+ inferred round. Repeated-round telemetry is not automatically inferred from HUD
217
+ text, timers, or scene changes. Coins use an explicit server call after a confirmed
218
+ award: `hub.track(playerId, 'door_progress', { value: amount, result: 1 })`.
219
+ A new saved `hub.unlock` emits one unlock automatically; retries, existing items,
220
+ guest/session-only unlocks and receipts for a replaced player emit none.
221
+
222
+ The kit reports client `error`/`unhandledrejection` categories and visible render
223
+ gaps of at least two seconds in result places. It never reads or sends error
224
+ messages, stacks, URLs or arbitrary properties. Hidden-tab gaps are ignored.
225
+ Client and server both limit errors to one per ten seconds per connection/player;
226
+ Ghost's existing per-user/session budgets still apply. Client telemetry is a
227
+ reported symptom, not a trusted crash count. Listener disposal follows the current
228
+ place and system lifecycle. Older hosts fail silently and cannot prove ingestion.
229
+
230
+ First-visit v1.134 uses the existing arrive (1) and pointer_stage (9) flags:
231
+ 1 home, 2 door, 3 npc, 0 pre-switch/unassigned. These values are local to these
232
+ kinds and do not change door or FPS telemetry. Opted-in arrivals wait for the
233
+ first-visit storage read; stage events describe the five control stages, not
234
+ the door/NPC intro. Assignment is persisted independently of the current live set.
235
+
236
+ ## Load abandoned (v1.138)
237
+
238
+ `hub.loadTelemetry: true` on the main place, beside `analytics: true` and
239
+ `analyticsV111: true`, adds kind 27 `load_abandoned`. Ghost already records the
240
+ admission (kind 24) and the kit the arrival (kind 1); kind 27 explains a connection
241
+ in between that never arrived. Houses do not emit it. Ghost accepts it only for a
242
+ root town session whose immutable pin carries v1.111, with the strict shape below,
243
+ and keeps at most one per player and session per minute. It is not in the authored
244
+ `hub.track` vocabulary: the kit server sends it through `session.hub.track` like kind 26.
245
+
246
+ Connections follow the transport's own join and leave callbacks (wired in
247
+ `code/server/index.js`), not roster sampling, so a leave and rejoin of one player id
248
+ between two ticks is two connections. The timeout check runs on every transport tick,
249
+ including before the simulation exists, so a world that never finishes building
250
+ still reports. Each connection emits once: result 1 `closed` when the transport
251
+ reports its leave before it arrived, or result 2 `timeout` when it is still connected
252
+ and not arrived 30 seconds (`LOAD_ABANDON_TIMEOUT_MS`) after it joined. A timeout
253
+ suppresses the later close; an arrival suppresses both; a join for an id whose previous
254
+ connection never reported a leave closes that one first; a place or session switch
255
+ drops pending connections without emitting. Value is milliseconds from join to
256
+ abandonment, clamped to 120000. Flags are 0 (Ghost may still stamp the house-owner bit,
257
+ which a town never has).
258
+
259
+ Stages (subject), the furthest milestone reached:
260
+
261
+ | Stage | Name | Observed by |
262
+ | --- | --- | --- |
263
+ | 1 | connected | Server: the transport joined it, no hello yet (the browser is still booting or loading the world) |
264
+ | 2 | hello | Server: `hub-hello` received (recorded on receipt, before any reconcile) |
265
+ | 3 | body | Server: hello and a body; waiting to place the player (group window or storage reads) |
266
+ | 4 | placed | Browser: its own body is placed and it is waiting for `hub-arrived` |
267
+
268
+ Only stage 4 is browser-reported, as `{ k: 'hub-load', stage: 4 }`, once per transport
269
+ and only when the snapshot carried `hubPlace.loadTelemetry`. The server accepts it only
270
+ from a connection in the roster that has not arrived, only as a raise, at most once per
271
+ second, with no other fields. Server stages never lower a reported stage. Stages 3 and 4
272
+ need not happen in that order; the value is the highest reached, not a sequence.
273
+
274
+ A page that never connected to the game server (app launch, page load, network,
275
+ `MULTIPLAYER_CONNECTION_FAILED`) is invisible to the kit. Ghost's kind 24 admissions
276
+ with neither a kind 27 nor an arrival cover it; `join-not-arrived.sql` splits them.
277
+ Anonymous players and players the host no longer resolves are dropped by the host
278
+ broker, which must also accept kind 27 (and treat result 1 like other terminal kinds,
279
+ after the socket closed) before any row flows. Delivery is best effort.