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
@@ -10,7 +10,7 @@
10
10
  <link rel="icon" type="image/png" sizes="32x32" href="/__castle/ide/favicon-32x32.png" />
11
11
  <link rel="icon" type="image/png" sizes="16x16" href="/__castle/ide/favicon-16x16.png" />
12
12
  <link rel="icon" href="/__castle/ide/favicon.ico" sizes="any" />
13
- <script type="module" crossorigin src="/__castle/ide/assets/index-BjOxR-lW.js"></script>
13
+ <script type="module" crossorigin src="/__castle/ide/assets/index-DulbYIJm.js"></script>
14
14
  <link rel="stylesheet" crossorigin href="/__castle/ide/assets/index-MVLfNYd9.css">
15
15
  </head>
16
16
  <body>
@@ -1,4 +1,5 @@
1
- import type { Plugin } from 'vite';
1
+ import type { Plugin, UserConfig } from 'vite';
2
+ export declare function castleWorkerOptions(): UserConfig["worker"];
2
3
  export declare function importsAliasPlugin(): Plugin;
3
4
  export declare function sdkAliasPlugin(): Plugin;
4
5
  export declare function singleFileBuildCompatPlugin(): Plugin;
@@ -9,6 +9,19 @@ import { resolveSdkSpecifier } from './sdkResolve.js';
9
9
  // resolution and the SDK's published types don't, and one short string is not
10
10
  // worth reconciling that.
11
11
  const IMPORTS_PREFIX = '@imports/';
12
+ // Workers resolve deck imports and forks in their own build environment.
13
+ export function castleWorkerOptions() {
14
+ return {
15
+ format: "iife",
16
+ plugins: () => [
17
+ forksOverlayPlugin(),
18
+ importsAliasPlugin(),
19
+ sdkAliasPlugin(),
20
+ sceneFilesPlugin(),
21
+ ],
22
+ rolldownOptions: { output: { codeSplitting: false } },
23
+ };
24
+ }
12
25
  // Safety net for `.scene` / `.drawing` / `.pxart` files imported as JS modules.
13
26
  //
14
27
  // These files are DATA (JSON), not modules. The blessed way to read them is the
@@ -82,7 +82,7 @@
82
82
  "title": "base",
83
83
  "deckId": "yRcmH4_aYllE",
84
84
  "cardId": "zkFdingmIm3m",
85
- "publishedVersion": "2026-10-08T10:40:20.107Z",
85
+ "publishedVersion": "2026-10-18T10:34:27.709Z",
86
86
  "provides": [
87
87
  "castle-web-sdk"
88
88
  ]
@@ -26,12 +26,15 @@ import { setup, initCard, Store, Leaderboard } from "castle-web-sdk";
26
26
  - [Pass](#pass)
27
27
  - [Snapshot](#snapshot)
28
28
  - [Portal](#portal)
29
+ - [Social](#social)
30
+ - [Party](#party)
29
31
  - [Hub](#hub)
30
32
  - [Decks](#decks)
31
33
  - [Clipboard](#clipboard)
32
34
  - [Haptics](#haptics)
33
35
  - [Agent](#agent)
34
36
  - [Lifecycle](#lifecycle)
37
+ - [Display](#display)
35
38
  - [Multiplayer](#multiplayer)
36
39
  - [Setup](#setup)
37
40
  - [Saving files](#writefilepath-contents-promisevoid)
@@ -64,7 +67,25 @@ Named rooms use `{ mode: "named", key: "room-name" }`; party sessions use
64
67
  reconnects temporary socket drops automatically. `onStateChange` reports
65
68
  `acquiring`, `connecting`, `connected`, `reconnecting`, and `closed`; its optional
66
69
  metadata distinguishes a server `bye`, a replaced server version, an explicit
67
- `leave`, and connection failures.
70
+ `leave`, and connection failures. The reconnect retry budget counts 30 seconds
71
+ of foreground time; time while the page is hidden or frozen does not spend it,
72
+ and a stall of the page's JavaScript (a debugger pause, an app pausing its web
73
+ view) spends at most two seconds. After any return the SDK tries the reconnect
74
+ credential at least once before giving up on it. Retries wait for the page to
75
+ become visible and resume. A server rejecting the
76
+ credential or confirming the session ended can still trigger a fresh join sooner.
77
+
78
+ `connection.serverBundleId` and `connection.serverBundleSha256` identify the server publication running the connected session. These read-only diagnostics are `null` before a live connection, while disconnected, in solo mode, or when the host does not provide them. The ID identifies a publication; the SHA-256 identifies its code bytes, so two publications can share a hash. Read the values again after a reconnect or a destination join. They describe the running server, not the client bundle or the deck’s newest save.
79
+
80
+ Experimental: `Multiplayer.join({ mode: "public", pongTimeoutMs: 10_000 })`
81
+ reconnects if a keepalive ping receives no pong within the given milliseconds.
82
+ Omitting the option (or passing `0`) preserves the existing keepalive behavior.
83
+ The deadline starts at a ping, normally sent every 25 seconds; it is not a
84
+ deadline for game messages. A deadline callback delayed by more than one second (for example during page
85
+ suspension) sends one fresh ping and waits a full deadline before reconnecting. Only one
86
+ such extension is allowed without a pong, so repeated timer throttling cannot
87
+ postpone recovery indefinitely.
88
+
68
89
  During local development, reloading a Play panel restores that panel's session
69
90
  when its dev server is still running. A separate Play panel joins separately.
70
91
 
@@ -147,6 +168,13 @@ export default {
147
168
 
148
169
  `session.storage.deck` is shared by everyone playing.
149
170
  `session.storage.user(userId)` is one player's public data.
171
+ `await session.storage.playthrough(userId)` opens that player's generation-bound
172
+ game state. Its `resetGeneration` is present only after an administrator has
173
+ reset that player's progress for this deck. It is a monotonic reset marker,
174
+ separate from the handle's `generation`, which fences playthrough operations.
175
+ Deck-scope storage writes are not fenced by either generation; a server using
176
+ `session.storage.deck` must discard its own stale queued writes and cached
177
+ per-player values when it observes a newer reset marker.
150
178
  `session.storage.board(name)` is a leaderboard. The root and its buckets also
151
179
  support the [atomic save API](#atomic-saves). Each scope has the same
152
180
  `get`, `set`, `remove`, `increment` and `list` as `Store`.
@@ -196,10 +224,22 @@ dev serve.
196
224
 
197
225
  - `session.hub.place`, `.title` and `.result` are the place and the result shape
198
226
  as published (`result` is `null` for a place that reports none, such as a town).
227
+ - `session.hub.reconnectWindowMs`, when present, is Castle's pinned hub-place
228
+ reconnect grace in milliseconds, inclusive at the deadline. It is absent on
229
+ sessions without a pinned grace and older hosts. Kits use it to match visit retention to the
230
+ transport window; deck code does not choose it.
199
231
  - `session.hub.arrival(playerId)` is how a player came in when Castle placed them
200
232
  through a hub door: `{ fromDeckId, doorId }` (`doorId` is `null` when the door
201
233
  names none), else `null`. It is Castle's word, never a client's, and it is also
202
234
  the third argument of `onPlayerJoin`.
235
+ - `session.hub.push` is optional, present only for a place declaring
236
+ `hub.push: { version: 1 }` on a capable runtime. Its
237
+ `visit(playerId, { userId, timezone })` reports a visit with the captured
238
+ authenticated account and an IANA timezone. It returns a boolean acknowledgement.
239
+ Ghost derives the three-day come-back reminder and checks consent, answered
240
+ age, experiments, quiet hours and delivery limits. Reporting a visit does not
241
+ opt the player in or promise a notification. No crop reporting or queue
242
+ reconciliation API is exposed.
203
243
  - `session.hub.reportResult(playerId, { outcome?, score?, stats? })` records a
204
244
  signed-in player's result for this visit, once. The host checks it against the
205
245
  published shape and Castle keeps it only for a place behind a curated door;
@@ -257,6 +297,9 @@ dev serve.
257
297
  ids. Missing lists are empty on older hosts. Mutual friends keep the chat age
258
298
  and block rules; follows in either direction require no block, with no age rule.
259
299
  These lists belong to the viewer only and must never go to another client.
300
+ Optional third argument `{ strict: true }` rejects malformed raw lists before
301
+ normalization and adds `validated: true` to a successful result. Without it,
302
+ the existing response shape and older-host behavior remain unchanged.
260
303
  - `session.hub.hiddenPair(playerIdA, playerIdB)` is true when a block hides these
261
304
  two players from each other (either one blocked the other). Never send either
262
305
  one the other's pose, avatar or name. The block lists themselves never reach
@@ -625,6 +668,72 @@ claim can fail with writer loss while `committed === true` and its original
625
668
  receipt; it never takes ownership again. Transport ambiguity keeps the outcome
626
669
  unknown until receipt lookup or identical replay settles it.
627
670
 
671
+ ### Conditional writes and recovery (gated)
672
+
673
+ `Store.conditionalWrite(input)` and `session.storage.conditionalWrite(input)`
674
+ use the same request and receipt as `transaction`. Read with `snapshot`, then
675
+ pass its `access` and each target's `revision` as `expectedAccess` and
676
+ `expectedRevision`. Use `null` to create an absent target. A revision belongs
677
+ to a **prefix**, so changing any key in it changes the revision. For an
678
+ independent value, give it a separate, non-overlapping prefix.
679
+
680
+ This additive API is off by default. The platform must enable conditional
681
+ storage for the deck after its database index and host support are ready.
682
+ Older hosts and the dev memory store do not support it. Keep a dependent
683
+ feature off when the API is unavailable; never fall back to ordinary writes.
684
+ Existing `get`, `set` and save methods keep their behavior.
685
+
686
+ Session servers can read `session.storage.resetGeneration(userId)` (zero before
687
+ the first reset) and pass `resetFences: [{ playerId, resetGeneration }]` to
688
+ `conditionalWrite`. Supply one or two unique numeric account IDs and integer
689
+ generations from 0 through 2147483647. Read generations before the snapshot used
690
+ to build the write. A reset that commits first refuses the write with
691
+ `CAULDRON_STORAGE_STALE_RESET_GENERATION`, `committed: false`, and
692
+ `playerId`, `expectedResetGeneration`, and current `resetGeneration` on the
693
+ `SaveError` and its `extensions`. A write that commits first retains its receipt;
694
+ recovery must check current generations before adopting it. Clients cannot send
695
+ reset fences. Omitting them preserves the existing request.
696
+
697
+ One call changes up to eight targets, with up to eight explicit key changes
698
+ per target, across the same deck and at most two players. Every target needs
699
+ its expected revision. A read-only `check` can use `expectedRevision: null`
700
+ to require absence without creating that target. All changes commit together. Clients may address their
701
+ own user/private targets and writable deck targets; only the deck server can
702
+ condition on another player's user target. Servers cannot access private data.
703
+ Existing quota, byte and rate allowances still apply. A prefix replacement
704
+ also removes its previous rows, subject to those allowances.
705
+
706
+ On a revision conflict, `SaveError.code` is
707
+ `CAULDRON_STORAGE_REVISION_CONFLICT`, `committed` is `false`, and `current`
708
+ contains the current values and revisions read at the failed comparison.
709
+ If that full snapshot exceeds the byte allowance, the call fails with
710
+ `CAULDRON_STORAGE_TOO_LARGE`; no changes commit. Keep the player's proposed
711
+ change and reload before offering another choice.
712
+
713
+ Use a unique `operationId` for each action. Retrying the **identical request**
714
+ after a lost reply returns its original committed receipt, even if values
715
+ have since changed. Reusing the ID with different input is refused. Failed
716
+ comparisons do not create receipts. Receipts have no automatic expiry and
717
+ are retained beyond 24 hours; an explicit data/account reset may remove them.
718
+ Never reuse old operation IDs or access tokens after a reset.
719
+
720
+ `recentOperations({ limit?, cursor? })`, on both root APIs, discovers the
721
+ caller's committed operation IDs after a restart. It returns
722
+ `{ operations: [{ operationId, committedAt, receipt }], cursor }`, newest
723
+ first. `limit` defaults to 16 and is at most 32; pass the returned cursor for
724
+ the next page. This lists existing save receipts too. Client and server
725
+ histories are separate; all layers of the same deck share the server history.
726
+ Use a smaller limit if the reply exceeds the byte allowance. A history page
727
+ is discovery, not a snapshot of current values: reload with `snapshot` before
728
+ building the next change. `operation(id)` still looks up a known ID.
729
+
730
+ Pairing can atomically create a project and reserve both players' recovery
731
+ entries. The game server must still validate consent, membership and editing
732
+ leases. A market sale can atomically update stock, the daily cap and the
733
+ purse, once **every** writer of those values uses the managed targets.
734
+ Durable game recovery entries belong in those targets; recent operation
735
+ receipts alone do not define permanent project ownership or sale policy.
736
+
628
737
  ### Save coordinator
629
738
 
630
739
  `createSaveCoordinator`, from `castle-web-sdk` or `castle-web-sdk/server`,
@@ -1075,14 +1184,128 @@ Snapshot.onTaken(() => {
1075
1184
  });
1076
1185
  ```
1077
1186
 
1187
+ ## Social
1188
+
1189
+ `Social` gives a Cauldron deck the signed-in player's mutual Castle follows.
1190
+ The host supplies the player and current deck from trusted play context; a deck
1191
+ cannot ask about another account or deck. A host from before Social rejects with
1192
+ `CastleError` code `UNKNOWN_COMMAND`.
1193
+
1194
+ - `Social.friends()` returns at most 20 mutual follows as
1195
+ `{ userId, username, photoUrl? }`. A one-way follow is not a friend here.
1196
+ - `Social.presence()` returns the mutual friends playing this deck now as
1197
+ `{ userId, username, photoUrl?, sessionId, routeId?, slot?, updatedAt }`.
1198
+ Castle's now-playing privacy and multiplayer gates apply. It fails closed to
1199
+ `[]` when presence is gated or unavailable.
1200
+
1201
+ Presence has no event in v1. Poll `Social.presence()` when the game needs to
1202
+ refresh its list; do not treat `updatedAt` as a durable offline record.
1203
+
1204
+ ```js
1205
+ import { Social } from "castle-web-sdk";
1206
+
1207
+ const friends = await Social.friends();
1208
+ const playingHere = await Social.presence();
1209
+ ```
1210
+
1211
+ ## Party
1212
+
1213
+ `Party` creates and drives Castle parties with the signed-in player's account.
1214
+ Castle still enforces membership, roles, age and party permissions; refusals are
1215
+ `CastleError`s carrying the server's code. Party and user-id arrays are bounded
1216
+ to 32 users.
1217
+
1218
+ - `Party.current()` returns the party this play was launched with as
1219
+ `{ partyId, name, status, hasUnreadMessages }`, or `null`. The party id comes
1220
+ only from trusted host context, and no request is made when the play has none.
1221
+ - `Party.create(userIds)` creates a party containing those users and the
1222
+ signed-in player. It never sets an initial deck. Creating one does not change
1223
+ `Party.current()` or the launch party used by
1224
+ `Multiplayer.join({ mode: "party" })`.
1225
+ - `Party.invite(partyId, userIds)` invites more users.
1226
+ - `Party.respond(partyId, accept)` accepts or rejects an invitation.
1227
+ - `Party.members(partyId)` returns
1228
+ `{ userId, username, photoUrl?, status, role }` rows. `role` is `member`,
1229
+ `host` or `owner`.
1230
+ - `Party.leave(partyId)` leaves the party.
1231
+ - `Party.messages(partyId, cursor?)` returns
1232
+ `{ messages, cursor }`. Messages are newest first; pass the cursor to load
1233
+ **older** history (the opposite direction from `Hub.chat(after)`). Each message
1234
+ has `{ id, fromUserId, fromUsername, body, text, createdAt }`. `body` is the
1235
+ Castle chat JSON; `text` is non-null only when that body is plain text with no
1236
+ tags, links or embeds.
1237
+ - `Party.say(partyId, text)` sends plain text to the party. The host trims it
1238
+ and caps it at 1,000 characters, then returns the stored `PartyMessage`.
1239
+
1240
+ ```js
1241
+ import { Party } from "castle-web-sdk";
1242
+
1243
+ const party = await Party.current();
1244
+ if (party) {
1245
+ const page = await Party.messages(party.partyId);
1246
+ await Party.say(party.partyId, "Meet by the gate!");
1247
+ }
1248
+ ```
1249
+
1078
1250
  ## Hub
1079
1251
 
1252
+ Hub contract v1.95 adds optional invites. A place declaring `hub.invite: true`
1253
+ can call `hub.invite(playerId)` on its server to offer **Invite a friend**.
1254
+ As of contract v1.124, `Hub.invite()` makes one link for up to five friends,
1255
+ expiring within 24 hours. The kit opens it directly with native Share when
1256
+ supported and an explicit Copy link action. `Hub.invite({ crew: false })`
1257
+ retains the one-use option for callers that need it. Hosts without invite
1258
+ support return `unavailable`.
1259
+
1260
+ `Hub.canInvite()` answers `{ status: 'ok', canInvite }`: whether the host will
1261
+ make a link for this player, by Castle's invite rule for the account (signed
1262
+ in, over 13, in the invite audience). The kit offers **Invite a friend** only on
1263
+ `canInvite: true`. Hosts without hub support answer `unavailable`, and a host
1264
+ older than the command rejects it, so treat anything else as no.
1265
+ With `canInvite: true`, newer hosts also name the account the links belong to
1266
+ (`userId`, a guest's included); the kit offers the action only while that
1267
+ account is the player's own, and checks `User.getCurrent()` when a host names
1268
+ none.
1269
+
1270
+ The trusted host resolves the link after sign-in, retains its token, and requests
1271
+ the inviter's layer when it has room. If resolution refuses the invite, the host
1272
+ discards it for that visit and joins normally. Transient resolution failures
1273
+ retry with backoff; after five failures the host also discards the invite.
1274
+ Anonymous players join normally without using the invite.
1275
+ An invite can also route through the
1276
+ existing `Hub.inviteArrival()` result `{ status: 'route', doorId }` to the
1277
+ inviter's house or active run behind a curated door that allows late joins.
1278
+ Contract v1.113 active-run routing requires root `hub.bringFriend: true`
1279
+ in addition to `invite: true` on both the town and destination. The destination
1280
+ also declares `hub.bringFriend: true` so its saved bundle and fresh pin retain
1281
+ the invite capability;
1282
+ it admits only to the matching live run while the inviter is present. A full,
1283
+ ended or unavailable run is refused rather than recreated. The kit calls
1284
+ `Hub.inviteArrival()` after joining that destination. Ghost verifies arrival
1285
+ before creating mutual follows between each eligible
1286
+ over-13 arrival and the inviter. New arrivals do not follow one another;
1287
+ existing pairs from earlier links remain available for Undo. Under-13 arrivals create no follows. The arrival
1288
+ surface shows an authored now-friends line and `Hub.undoInvite(userId)` removes
1289
+ both follow directions for that pair. No player-entered message travels with a link.
1290
+ These operations retain the existing hub access gates. Link creation and arrival
1291
+ completion wait up to 16 seconds when the server presence roster is still catching
1292
+ up with the game connection.
1293
+
1080
1294
  `Hub` moves a player between hub places: every deck built on the hub-game kit is
1081
1295
  a place, and a door is a row in Castle's curated door table. A deck names only a
1082
1296
  door; the host supplies the current place, the session it joined there and the
1083
1297
  party, and calls Castle with the player's own account. Hosts without hub support
1084
1298
  answer `unavailable`; older hosts reject with `CastleError` code `UNKNOWN_COMMAND`.
1085
1299
 
1300
+ `Hub.signIn({ reason })` asks the host to open its native sign-in flow for an
1301
+ anonymous player. `reason` is the short explanation shown to the player (at most
1302
+ 200 characters and 512 UTF-8 bytes). It resolves to
1303
+ `{ status: 'signedIn', userId? }`, `{ status: 'dismissed' }`, or
1304
+ `{ status: 'unavailable' }`. `userId` is present only when the host can return
1305
+ the signed-in account id. A new host without native sign-in support returns
1306
+ `unavailable`; an older host that does not know this command rejects with
1307
+ `UNKNOWN_COMMAND`.
1308
+
1086
1309
  - `Hub.doors()` reads the current place's doors and who is inside them:
1087
1310
  `{ status: "ok", doors }` or `{ status: "unavailable", doors: null }`. A row has
1088
1311
  `doorId`, `launcherKind` (`door`, `table`, `cabinet`, `gate`), `placementKind`
@@ -1091,6 +1314,10 @@ answer `unavailable`; older hosts reject with `CastleError` code `UNKNOWN_COMMAN
1091
1314
  - `Hub.go(doorId)` acquires the destination behind a door of the current place.
1092
1315
  A door used within seconds of arriving can take up to 15 seconds to answer
1093
1316
  while Castle catches up with the arrival.
1317
+ `Hub.go(doorId, { ownerUserId })` on a House door visits that friend's House
1318
+ (the `ownerUserId` `Hub.friends()` gives a friend at home); Castle admits it
1319
+ only while the two are connected and the owner is home. A host that predates
1320
+ it ignores `ownerUserId` and acquires the player's own House.
1094
1321
  - `Hub.back()` acquires the way back through the door the player came in by: the
1095
1322
  layer they left if it has room, else their party's, else the usual pick. The
1096
1323
  deck cannot choose where it leads; `not_found` when there is no way back.
@@ -1099,7 +1326,9 @@ answer `unavailable`; older hosts reject with `CastleError` code `UNKNOWN_COMMAN
1099
1326
  20): `{ status: "ok", friends: [{ userId, username, here, door }] }` or
1100
1327
  `{ status: "unavailable", friends: null }`. `here` is true for a friend in the
1101
1328
  player's own layer; `door` is set instead for a friend inside the place behind
1102
- one of this place's doors (that door's id), and null otherwise.
1329
+ one of this place's doors (that door's id), and null otherwise. A friend
1330
+ inside their own House behind that door also has `home: true` and
1331
+ `ownerUserId`, which `Hub.go` takes to visit them.
1103
1332
  - `Hub.jump(userId)` acquires the layer of the current place that friend is in:
1104
1333
  the same place in another session, joined exactly like a door's. The way back
1105
1334
  does not change. `not_found` when the friend is not in another layer of it.
@@ -1120,7 +1349,13 @@ answer `unavailable`; older hosts reject with `CastleError` code `UNKNOWN_COMMAN
1120
1349
  send it to), `refused`, `limited` (said too fast) or `unavailable`.
1121
1350
  - `Hub.reportChat(messageId)` reports a chat message the player was returned to
1122
1351
  Castle's moderators. The host names the place and session. `{ status: "ok" }`
1123
- or `unavailable`. Hub chrome only.
1352
+ or `unavailable`. Pass `{ block: true }` as a second argument to also block
1353
+ the sender of that stored message. The host asks for confirmation naming the
1354
+ sender; dismissing it, or using a host without confirmation support, reports
1355
+ the message without blocking. Hosts limit confirmation prompts to one per
1356
+ minute; another request during that window reports without blocking. Only `{ status: "ok", blocked: true }`
1357
+ confirms both actions; older hosts can report without confirming a block.
1358
+ Blocks prevent chat between the pair in either direction. Hub chrome only.
1124
1359
  - `Hub.cancel()` gives back an acquisition the deck will not join. Optional: one
1125
1360
  that is never joined expires within two minutes.
1126
1361
  - `Hub.onBack(listener)` hears the host's Back control, which a game cannot hide.
@@ -1137,6 +1372,12 @@ destination session's content pack hash) and `contentUrl` (that pack's immutable
1137
1372
  URL, or null when the destination has none), or `cancelled`, `full`,
1138
1373
  `unavailable`, `not_found`, `forbidden` or `party_required` with those fields null.
1139
1374
 
1375
+ Castle lists a player at a door only once it has seen them in the place's
1376
+ session, which can take up to 15 seconds after they arrive or after their
1377
+ connection comes back from a break (an app switch, a network drop). In that
1378
+ window `go` and `jump` keep asking and answer once the player is listed, so a
1379
+ `forbidden` they return is final.
1380
+
1140
1381
  A door can also lead to a cabinet: a classic Castle deck the host plays itself.
1141
1382
  `Hub.go` then answers `status: "ok"` with `kind: "classic"` and null `url`, `nonce`
1142
1383
  and `sessionId`: there is no session to join, and the trip is already committed.
@@ -1511,6 +1752,13 @@ startGame(saved ?? newGame());
1511
1752
  Lifecycle.ready();
1512
1753
  ```
1513
1754
 
1755
+ ## Display
1756
+
1757
+ `getDisplay()` returns a `DeckDisplay`. Its optional `orientation` field is the
1758
+ deck's preferred display orientation: `landscape`, `portrait`, or `any`.
1759
+ Missing or unrecognized preferences mean `any`; read the value as
1760
+ `display.orientation ?? "any"`.
1761
+
1514
1762
  ## Setup
1515
1763
 
1516
1764
  Startup, editor-mode check, and a file-write call for editor UI.
@@ -1653,6 +1901,12 @@ load its assets through the bundler instead.
1653
1901
 
1654
1902
  ## CastleError
1655
1903
 
1904
+ A multiplayer socket closed before its first hello reports its WebSocket close
1905
+ code in `error.extensions.closeCode` when available. Code `4404` means the
1906
+ play proxy could not route the session (`not_running`); it does not prove the
1907
+ runtime ended. A failed hub join cancels its handoff, so retrying a door requires
1908
+ a fresh `Hub.go` acquisition.
1909
+
1656
1910
  Every error the SDK throws is a `CastleError`. Check `code` to tell
1657
1911
  the kinds apart.
1658
1912
 
@@ -1702,3 +1956,12 @@ places may save hearts. Guests and unavailable hosts return
1702
1956
  `{ status: 'unavailable', hearts: [] }`; older hosts throw `UNKNOWN_COMMAND`.
1703
1957
  Invalid lists throw `INVALID_ARGUMENT`, and other host failures use `CastleError`.
1704
1958
  The dev serve keeps hearts per account in memory until it stops.
1959
+
1960
+ Server hub analytics (hub-game contract v1.93): `session.hub.track(playerId,
1961
+ { kind, subject?, value?, result?, flags? })` sends a numeric event through the
1962
+ server's authenticated platform channel. It returns `Promise<boolean>`: `true`
1963
+ acknowledges queueing, while unsupported hosts and refused delivery return `false`.
1964
+ It never throws. Only opted-in hub bundles are recorded; Ghost stamps the player
1965
+ and town from the session and door pin and excludes the town creator's own plays.
1966
+ The hub-game kit exposes `hub.track(playerId, eventName, properties)` only on
1967
+ places declaring `hub.analytics: true`; see its contract for the numeric vocabulary.
@@ -13,7 +13,11 @@ export { deckPrefixOf, IMPORTS_DIR, IMPORTS_PREFIX, isImportedFile, resolveDeckF
13
13
  export { Haptics } from "./haptics";
14
14
  export type { CastleHapticsApi, HapticsResult, HapticsStatus, HapticStyle } from "./haptics";
15
15
  export { Hub } from "./hub";
16
- export type { CastleHubApi, HubBackResult, HubCancelResult, HubCancelStatus, HubChatMessage, HubChatResult, HubDoor, HubDoorsResult, HubFriend, HubFriendsResult, HubHeartsResult, HubGoParams, HubGoResult, HubHandoffResult, HubHandoffStatus, HubJumpResult, HubPlacementKind, HubReportResult, HubSayResult, } from "./hub";
16
+ export type { CastleHubApi, HubBackResult, HubCancelResult, HubCancelStatus, HubChatMessage, HubChatResult, HubDoor, HubDoorsResult, HubFriend, HubFriendsResult, HubInviteResult, HubCanInviteResult, HubInviteArrivalResult, HubHeartsResult, HubGoParams, HubSignInParams, HubSignInResult, HubGoResult, HubHandoffResult, HubHandoffStatus, HubJumpResult, HubPlacementKind, HubReportResult, HubSayResult, } from "./hub";
17
+ export { Social } from "./social";
18
+ export type { CastleSocialApi, SocialFriend, SocialPresence } from "./social";
19
+ export { Party } from "./party";
20
+ export type { CastlePartyApi, PartyMember, PartyMessage, PartyMessagesResult, PartyStatus, PartySummary, } from "./party";
17
21
  export { Leaderboard } from "./leaderboard";
18
22
  export type { LeaderboardData, LeaderboardEntry, LeaderboardOptions, LeaderboardScope, LeaderboardShowOptions, LeaderboardShowResult, LeaderboardShowStatus, LeaderboardSort, } from "./leaderboard";
19
23
  export { Lifecycle } from "./lifecycle";
@@ -35,7 +39,7 @@ export type { CastlePortalApi, PortalOpenResult, PortalOpenStatus, PortalPrefetc
35
39
  export { CARD_RATIO, deleteFile, fileUrl, initCard, onBeforeRestart, onFilesChanged, onSaveReloadState, openFile, renameFile, requestReload, setup, takeReloadState, writeFileOnce, } from "./runtime";
36
40
  export type { FileChange, FilesChangedEvent } from "./runtime";
37
41
  export { cardUnit, fitStage, fovForAspect, getDisplay } from "./display";
38
- export type { DeckDisplay, DeckLayout } from "./display";
42
+ export type { DeckDisplay, DeckLayout, DeckOrientation } from "./display";
39
43
  export { flushSaves, hasPendingSave, onSaveState, writeFile, } from "./saveQueue";
40
44
  export type { SaveState } from "./saveQueue";
41
45
  export { SharedStorage, Storage } from "./storage";
@@ -49,4 +53,4 @@ export type { CastleUser, CastleUserApi } from "./user";
49
53
  export { createSaveCoordinator } from "./saveCoordinator";
50
54
  export type { CoordinatedChange, CoordinatedSave, SaveCoordinator, SaveStatus, } from "./saveCoordinator";
51
55
  export { SaveError } from "./save";
52
- export type { SaveApi, SaveBucketApi, SaveBucketRead, SaveChange, SaveCheck, SaveClaimed, SaveClaimInput, SaveErrorEnvelope, SaveInitial, SaveInitializeInput, SaveOpened, SaveOperation, SaveReadTarget, SaveReceipt, SaveRevision, SaveRows, SaveScope, SaveSelection, SaveSnapshot, SaveTarget, SaveTransactionInput, SaveWriter, } from "./save";
56
+ export type { SaveApi, SaveBucketApi, SaveBucketRead, SaveChange, SaveCheck, SaveConditionalCheck, SaveConditionalWriteInput, SaveClaimed, SaveClaimInput, SaveErrorEnvelope, SaveInitial, SaveInitializeInput, SaveOpened, SaveOperation, SaveReadTarget, SaveReceipt, SaveRecentOperationsInput, SaveRecentOperationsPage, SaveRevision, SaveRows, SaveScope, SaveSelection, SaveSnapshot, SaveTarget, SaveTransactionInput, SaveWriter, } from "./save";
@@ -9,6 +9,8 @@ export { experiment, experiments, experimentsReady } from "./experiments";
9
9
  export { deckPrefixOf, IMPORTS_DIR, IMPORTS_PREFIX, isImportedFile, resolveDeckFile, } from "./files";
10
10
  export { Haptics } from "./haptics";
11
11
  export { Hub } from "./hub";
12
+ export { Social } from "./social";
13
+ export { Party } from "./party";
12
14
  export { Leaderboard } from "./leaderboard";
13
15
  export { Lifecycle } from "./lifecycle";
14
16
  export { Multiplayer } from "./multiplayer";