castle-web-cli 0.4.232 → 0.4.234

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (587) hide show
  1. package/dist/agent-failures.d.ts +8 -0
  2. package/dist/agent-failures.js +19 -2
  3. package/dist/agent-prompts.d.ts +1 -1
  4. package/dist/agent-prompts.js +10 -3
  5. package/dist/agent.d.ts +64 -3
  6. package/dist/agent.js +170 -81
  7. package/dist/api.d.ts +11 -0
  8. package/dist/api.js +43 -0
  9. package/dist/bundle.d.ts +64 -0
  10. package/dist/bundle.js +558 -2
  11. package/dist/castle-host/host.d.ts +18 -2
  12. package/dist/castle-host/host.js +844 -39
  13. package/dist/castleJson.d.ts +23 -2
  14. package/dist/castleJson.js +46 -2
  15. package/dist/check.d.ts +3 -1
  16. package/dist/check.js +20 -3
  17. package/dist/chunkLoader.d.ts +3 -0
  18. package/dist/chunkLoader.js +111 -0
  19. package/dist/devParty.d.ts +26 -0
  20. package/dist/devParty.js +231 -0
  21. package/dist/devSaveStorage.js +4 -0
  22. package/dist/devSessionStorage.js +50 -2
  23. package/dist/devSocial.d.ts +24 -0
  24. package/dist/devSocial.js +70 -0
  25. package/dist/ide.d.ts +2 -0
  26. package/dist/ide.js +119 -15
  27. package/dist/importPinMismatch.d.ts +22 -0
  28. package/dist/importPinMismatch.js +77 -0
  29. package/dist/importRegression.js +3 -15
  30. package/dist/imports.d.ts +10 -3
  31. package/dist/imports.js +88 -20
  32. package/dist/index.js +11 -4
  33. package/dist/init.js +1 -1
  34. package/dist/platformDoc.js +22 -0
  35. package/dist/routerFences.d.ts +5 -0
  36. package/dist/routerFences.js +12 -2
  37. package/dist/save-deck.d.ts +25 -1
  38. package/dist/save-deck.js +178 -9
  39. package/dist/serve.js +32 -11
  40. package/dist/shell/assets/{index-D2tWM896.js → index-DulbYIJm.js} +97 -97
  41. package/dist/shell/assets/index-MVLfNYd9.css +1 -0
  42. package/dist/shell/index.html +2 -2
  43. package/dist/taskSteer.d.ts +13 -0
  44. package/dist/taskSteer.js +22 -2
  45. package/dist/vitePlugins.d.ts +2 -1
  46. package/dist/vitePlugins.js +13 -0
  47. package/kits/base/castle.json +1 -1
  48. package/kits/base/package-lock.json +1 -1
  49. package/kits/base/sdk/README.md +339 -5
  50. package/kits/base/sdk/avatar.d.ts +6 -2
  51. package/kits/base/sdk/avatar.js +12 -4
  52. package/kits/base/sdk/castle.d.ts +7 -3
  53. package/kits/base/sdk/castle.js +2 -0
  54. package/kits/base/sdk/commands.d.ts +176 -1
  55. package/kits/base/sdk/commands.js +3 -0
  56. package/kits/base/sdk/display.d.ts +3 -0
  57. package/kits/base/sdk/display.js +9 -3
  58. package/kits/base/sdk/hub.d.ts +37 -6
  59. package/kits/base/sdk/hub.js +63 -4
  60. package/kits/base/sdk/multiplayer.d.ts +7 -1
  61. package/kits/base/sdk/multiplayer.js +148 -32
  62. package/kits/base/sdk/multiplayerProtocol.d.ts +2 -0
  63. package/kits/base/sdk/party.d.ts +23 -0
  64. package/kits/base/sdk/party.js +91 -0
  65. package/kits/base/sdk/reconnectBudget.d.ts +23 -0
  66. package/kits/base/sdk/reconnectBudget.js +96 -0
  67. package/kits/base/sdk/save.d.ts +38 -1
  68. package/kits/base/sdk/save.js +81 -7
  69. package/kits/base/sdk/server/hub.d.ts +117 -0
  70. package/kits/base/sdk/server/hub.js +119 -2
  71. package/kits/base/sdk/server/platformHandle.d.ts +43 -1
  72. package/kits/base/sdk/server/storage.d.ts +17 -0
  73. package/kits/base/sdk/server/storage.js +65 -3
  74. package/kits/base/sdk/server/wrapper.d.ts +43 -6
  75. package/kits/base/sdk/server/wrapper.js +93 -9
  76. package/kits/base/sdk/social.d.ts +9 -0
  77. package/kits/base/sdk/social.js +5 -0
  78. package/kits/hub-game/CLAUDE.md +451 -13
  79. package/kits/hub-game/README.md +63 -0
  80. package/kits/hub-game/blueprints/avatar-10.scene +28 -0
  81. package/kits/hub-game/blueprints/avatar-11.scene +28 -0
  82. package/kits/hub-game/blueprints/avatar-12.scene +28 -0
  83. package/kits/hub-game/blueprints/avatar-13.scene +28 -0
  84. package/kits/hub-game/blueprints/avatar-14.scene +28 -0
  85. package/kits/hub-game/blueprints/avatar-15.scene +28 -0
  86. package/kits/hub-game/blueprints/avatar-4.scene +28 -0
  87. package/kits/hub-game/blueprints/avatar-5.scene +28 -0
  88. package/kits/hub-game/blueprints/avatar-6.scene +28 -0
  89. package/kits/hub-game/blueprints/avatar-7.scene +28 -0
  90. package/kits/hub-game/blueprints/avatar-8.scene +28 -0
  91. package/kits/hub-game/blueprints/avatar-9.scene +28 -0
  92. package/kits/hub-game/castle.json +5 -5
  93. package/kits/hub-game/code/client/act.js +312 -0
  94. package/kits/hub-game/code/client/actionLayout.js +147 -0
  95. package/kits/hub-game/code/client/actionOverflow.js +556 -0
  96. package/kits/hub-game/code/client/actorBudget.js +47 -0
  97. package/kits/hub-game/code/client/arrivalCamera.js +50 -0
  98. package/kits/hub-game/code/client/askSlot.js +117 -0
  99. package/kits/hub-game/code/client/attention.js +11 -2
  100. package/kits/hub-game/code/client/avatar.js +311 -35
  101. package/kits/hub-game/code/client/avatarCap.js +228 -0
  102. package/kits/hub-game/code/client/avatarColors.js +70 -0
  103. package/kits/hub-game/code/client/avatarFaces.js +21 -0
  104. package/kits/hub-game/code/client/avatarShare.js +253 -0
  105. package/kits/hub-game/code/client/backVisibility.js +13 -0
  106. package/kits/hub-game/code/client/ballot.js +472 -0
  107. package/kits/hub-game/code/client/build.js +38 -0
  108. package/kits/hub-game/code/client/chat.js +41 -5
  109. package/kits/hub-game/code/client/chatModeration.js +5 -0
  110. package/kits/hub-game/code/client/chrome.js +2144 -160
  111. package/kits/hub-game/code/client/companion.js +716 -0
  112. package/kits/hub-game/code/client/companionDress.js +99 -0
  113. package/kits/hub-game/code/client/crowdNames.js +241 -0
  114. package/kits/hub-game/code/client/decor.js +515 -0
  115. package/kits/hub-game/code/client/defaultEnvironment.js +194 -0
  116. package/kits/hub-game/code/client/doorErrors.js +39 -0
  117. package/kits/hub-game/code/client/earned.js +131 -0
  118. package/kits/hub-game/code/client/emoteBubble.js +75 -0
  119. package/kits/hub-game/code/client/fall.js +18 -0
  120. package/kits/hub-game/code/client/farAvatars.js +233 -0
  121. package/kits/hub-game/code/client/firstJoin.js +9 -2
  122. package/kits/hub-game/code/client/fpsTelemetry.js +50 -0
  123. package/kits/hub-game/code/client/frameBatch.js +5 -0
  124. package/kits/hub-game/code/client/grab.js +368 -29
  125. package/kits/hub-game/code/client/hookLayer.js +385 -20
  126. package/kits/hub-game/code/client/hudCopy.js +51 -0
  127. package/kits/hub-game/code/client/hudRate.js +20 -0
  128. package/kits/hub-game/code/client/idle.js +177 -24
  129. package/kits/hub-game/code/client/interestCap.js +81 -0
  130. package/kits/hub-game/code/client/invites.js +231 -0
  131. package/kits/hub-game/code/client/joinError.js +9 -0
  132. package/kits/hub-game/code/client/keys.js +36 -0
  133. package/kits/hub-game/code/client/labelsNear.js +234 -0
  134. package/kits/hub-game/code/client/landscapeLayout.js +17 -0
  135. package/kits/hub-game/code/client/layoutCache.js +264 -0
  136. package/kits/hub-game/code/client/loadTelemetry.js +20 -0
  137. package/kits/hub-game/code/client/loadingCover.js +148 -0
  138. package/kits/hub-game/code/client/loadingEntry.js +8 -0
  139. package/kits/hub-game/code/client/menuIcons.js +34 -0
  140. package/kits/hub-game/code/client/menuRows.js +43 -0
  141. package/kits/hub-game/code/client/modelReady.js +7 -0
  142. package/kits/hub-game/code/client/pack.js +6 -2
  143. package/kits/hub-game/code/client/packFormat.js +3 -3
  144. package/kits/hub-game/code/client/padCueArrival.js +23 -0
  145. package/kits/hub-game/code/client/padCues.js +112 -0
  146. package/kits/hub-game/code/client/padOccupancy.js +88 -0
  147. package/kits/hub-game/code/client/padReadability.js +26 -0
  148. package/kits/hub-game/code/client/padRings.js +69 -0
  149. package/kits/hub-game/code/client/pushVisit.js +14 -0
  150. package/kits/hub-game/code/client/quality.js +205 -0
  151. package/kits/hub-game/code/client/qualityEntry.js +55 -0
  152. package/kits/hub-game/code/client/rehello.js +167 -0
  153. package/kits/hub-game/code/client/safeLayout.js +338 -0
  154. package/kits/hub-game/code/client/safeStyle.js +42 -0
  155. package/kits/hub-game/code/client/say.js +12 -3
  156. package/kits/hub-game/code/client/shot.js +146 -0
  157. package/kits/hub-game/code/client/shotFit.js +56 -0
  158. package/kits/hub-game/code/client/signIn.js +28 -0
  159. package/kits/hub-game/code/client/sound.js +63 -8
  160. package/kits/hub-game/code/client/soundscape.js +1151 -0
  161. package/kits/hub-game/code/client/soundscapeActions.js +99 -0
  162. package/kits/hub-game/code/client/soundscapeAmbience.js +453 -0
  163. package/kits/hub-game/code/client/soundscapeBaked.js +143 -0
  164. package/kits/hub-game/code/client/soundscapeBusker.js +217 -0
  165. package/kits/hub-game/code/client/soundscapeCourt.js +200 -0
  166. package/kits/hub-game/code/client/soundscapeCrowd.js +331 -0
  167. package/kits/hub-game/code/client/soundscapeCues.js +362 -0
  168. package/kits/hub-game/code/client/soundscapeMap.js +181 -0
  169. package/kits/hub-game/code/client/soundscapeMarket.js +176 -0
  170. package/kits/hub-game/code/client/soundscapeMusic.js +126 -0
  171. package/kits/hub-game/code/client/soundscapeMusicEngine.js +460 -0
  172. package/kits/hub-game/code/client/soundscapeSimlish.js +737 -0
  173. package/kits/hub-game/code/client/soundscapeSongs.js +127 -0
  174. package/kits/hub-game/code/client/soundscapeSongsRound3.js +63 -0
  175. package/kits/hub-game/code/client/soundscapeSynthesis.js +168 -0
  176. package/kits/hub-game/code/client/soundscapeUi.js +211 -0
  177. package/kits/hub-game/code/client/soundscapeVoice.js +1209 -0
  178. package/kits/hub-game/code/client/soundscapeWaves.js +206 -0
  179. package/kits/hub-game/code/client/spin.js +101 -0
  180. package/kits/hub-game/code/client/state.js +162 -1
  181. package/kits/hub-game/code/client/stuck.js +259 -0
  182. package/kits/hub-game/code/client/talk.js +714 -59
  183. package/kits/hub-game/code/client/tiers.js +543 -52
  184. package/kits/hub-game/code/client/toastBand.js +37 -0
  185. package/kits/hub-game/code/client/together.js +39 -2
  186. package/kits/hub-game/code/client/visibility.js +43 -0
  187. package/kits/hub-game/code/client/weakestLookBake.js +92 -0
  188. package/kits/hub-game/code/client/weakestTier.js +295 -0
  189. package/kits/hub-game/code/client/wear.js +461 -170
  190. package/kits/hub-game/code/client/worldLabels.js +241 -0
  191. package/kits/hub-game/code/client/yours.js +200 -0
  192. package/kits/hub-game/code/companionSpec.js +45 -0
  193. package/kits/hub-game/code/npcDisplayText.js +55 -0
  194. package/kits/hub-game/code/privateText.js +7 -0
  195. package/kits/hub-game/code/server/act.js +124 -0
  196. package/kits/hub-game/code/server/actions.js +138 -0
  197. package/kits/hub-game/code/server/actors.js +11 -2
  198. package/kits/hub-game/code/server/analytics.js +83 -0
  199. package/kits/hub-game/code/server/anonymousEntry.js +49 -0
  200. package/kits/hub-game/code/server/arrivalPose.js +36 -0
  201. package/kits/hub-game/code/server/ask.js +155 -0
  202. package/kits/hub-game/code/server/ballot.js +539 -0
  203. package/kits/hub-game/code/server/cells.js +100 -0
  204. package/kits/hub-game/code/server/companion.js +107 -0
  205. package/kits/hub-game/code/server/cues.js +70 -0
  206. package/kits/hub-game/code/server/decor.js +269 -0
  207. package/kits/hub-game/code/server/doorAnalytics.js +52 -0
  208. package/kits/hub-game/code/server/earned.js +478 -0
  209. package/kits/hub-game/code/server/frameBatch.js +183 -0
  210. package/kits/hub-game/code/server/friendBests.js +166 -0
  211. package/kits/hub-game/code/server/friendsAmong.js +272 -0
  212. package/kits/hub-game/code/server/history.js +7 -0
  213. package/kits/hub-game/code/server/hub.js +2510 -95
  214. package/kits/hub-game/code/server/idle.js +60 -12
  215. package/kits/hub-game/code/server/index.js +28 -6
  216. package/kits/hub-game/code/server/invites.js +19 -0
  217. package/kits/hub-game/code/server/labels.js +36 -2
  218. package/kits/hub-game/code/server/loadAbandon.js +106 -0
  219. package/kits/hub-game/code/server/manifest.js +586 -7
  220. package/kits/hub-game/code/server/menu.js +161 -0
  221. package/kits/hub-game/code/server/npcs.js +1025 -113
  222. package/kits/hub-game/code/server/observe.js +408 -0
  223. package/kits/hub-game/code/server/padOccupancy.js +85 -0
  224. package/kits/hub-game/code/server/party.js +2 -2
  225. package/kits/hub-game/code/server/players.js +30 -0
  226. package/kits/hub-game/code/server/resumePose.js +152 -0
  227. package/kits/hub-game/code/server/say.js +1 -1
  228. package/kits/hub-game/code/server/shot.js +110 -0
  229. package/kits/hub-game/code/server/standing.js +123 -0
  230. package/kits/hub-game/code/server/storageLimit.js +187 -0
  231. package/kits/hub-game/code/server/vis.js +175 -0
  232. package/kits/hub-game/code/server/wear.js +12 -0
  233. package/kits/hub-game/code/server/yours.js +59 -0
  234. package/kits/hub-game/code/shared/act.js +35 -0
  235. package/kits/hub-game/code/shared/cues.js +9 -0
  236. package/kits/hub-game/code/shared/danceIdle.js +28 -0
  237. package/kits/hub-game/code/shared/decor.js +41 -0
  238. package/kits/hub-game/code/shared/loadStages.js +12 -0
  239. package/kits/hub-game/code/shared/quality.js +74 -0
  240. package/kits/hub-game/code/shared/say.js +2 -0
  241. package/kits/hub-game/code/shared/shot.js +53 -0
  242. package/kits/hub-game/code/shared/spin.js +57 -0
  243. package/kits/hub-game/code/systems/hub.js +1753 -202
  244. package/kits/hub-game/docs/analytics.md +279 -0
  245. package/kits/hub-game/docs/content-pack.md +1 -1
  246. package/kits/hub-game/docs/contract.md +3475 -77
  247. package/kits/hub-game/docs/home-pieces.md +71 -0
  248. package/kits/hub-game/docs/observed-progress.md +252 -0
  249. package/kits/hub-game/main.jsx +2 -0
  250. package/kits/hub-game/models/avatar-10.pxmodel +28 -0
  251. package/kits/hub-game/models/avatar-11.pxmodel +28 -0
  252. package/kits/hub-game/models/avatar-12.pxmodel +27 -0
  253. package/kits/hub-game/models/avatar-13.pxmodel +24 -0
  254. package/kits/hub-game/models/avatar-14.pxmodel +29 -0
  255. package/kits/hub-game/models/avatar-15.pxmodel +24 -0
  256. package/kits/hub-game/models/avatar-4.pxmodel +29 -0
  257. package/kits/hub-game/models/avatar-5.pxmodel +27 -0
  258. package/kits/hub-game/models/avatar-6.pxmodel +26 -0
  259. package/kits/hub-game/models/avatar-7.pxmodel +25 -0
  260. package/kits/hub-game/models/avatar-8.pxmodel +24 -0
  261. package/kits/hub-game/models/avatar-9.pxmodel +30 -0
  262. package/kits/hub-game/models/earned/badge-round.pxmodel +100 -0
  263. package/kits/hub-game/models/earned/badge-shield.pxmodel +117 -0
  264. package/kits/hub-game/models/earned/badge-star.pxmodel +87 -0
  265. package/kits/hub-game/models/earned/belt-plain.pxmodel +72 -0
  266. package/kits/hub-game/models/earned/held-ball.pxmodel +43 -0
  267. package/kits/hub-game/models/earned/held-lantern.pxmodel +85 -0
  268. package/kits/hub-game/models/earned/held-net.pxmodel +57 -0
  269. package/kits/hub-game/models/earned/held-trophy.pxmodel +109 -0
  270. package/kits/hub-game/models/earned/pin-round.pxmodel +62 -0
  271. package/kits/hub-game/models/earned/sash-plain.pxmodel +66 -0
  272. package/kits/hub-game/models/earned/square/belt-plain.pxmodel +104 -0
  273. package/kits/hub-game/models/earned/square/sash-plain.pxmodel +98 -0
  274. package/kits/hub-game/models/hats/bat-clip.pxmodel +206 -0
  275. package/kits/hub-game/models/hats/beekeeper.pxmodel +149 -0
  276. package/kits/hub-game/models/hats/cap.pxmodel +162 -0
  277. package/kits/hub-game/models/hats/captain.pxmodel +178 -0
  278. package/kits/hub-game/models/hats/crooked-top.pxmodel +172 -0
  279. package/kits/hub-game/models/hats/flower-crown.pxmodel +451 -0
  280. package/kits/hub-game/models/hats/foam-crown.pxmodel +179 -0
  281. package/kits/hub-game/models/hats/lantern.pxmodel +230 -0
  282. package/kits/hub-game/models/hats/laurel.pxmodel +533 -0
  283. package/kits/hub-game/models/hats/lighthouse.pxmodel +96 -0
  284. package/kits/hub-game/models/hats/sailor.pxmodel +141 -0
  285. package/kits/hub-game/models/hats/souwester.pxmodel +131 -0
  286. package/kits/hub-game/models/hats/straw.pxmodel +139 -0
  287. package/kits/hub-game/models/hats/sunflower.pxmodel +406 -0
  288. package/kits/hub-game/models/hats/sweatband.pxmodel +112 -0
  289. package/kits/hub-game/models/hats/witch.pxmodel +147 -0
  290. package/kits/hub-game/package-lock.json +10 -1
  291. package/kits/hub-game/package.json +6 -2
  292. package/kits/hub-game/play/player.js +142 -0
  293. package/kits/hub-game/play/registry.js +47 -0
  294. package/kits/hub-game/play.jsx +37 -0
  295. package/kits/hub-game/scripts/check.mjs +117 -16
  296. package/kits/hub-game/scripts/companion-follower-wire.json +1 -0
  297. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +132 -0
  298. package/kits/hub-game/scripts/fixtures/decor-keyless.json +293 -0
  299. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +26 -0
  300. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +123 -0
  301. package/kits/hub-game/scripts/fixtures/interest-legacy.json +385 -0
  302. package/kits/hub-game/scripts/fixtures/npc-notes-v1.77.jsonl +4 -0
  303. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -0
  304. package/kits/hub-game/scripts/gen-avatars.mjs +933 -16
  305. package/kits/hub-game/scripts/gen-earned.mjs +285 -0
  306. package/kits/hub-game/scripts/gen-hats.mjs +827 -0
  307. package/kits/hub-game/scripts/grab.before-orbit.mjs +400 -0
  308. package/kits/hub-game/scripts/pose-storage-fixture.mjs +46 -0
  309. package/kits/hub-game/scripts/soundscape-wave-analysis.mjs +125 -0
  310. package/kits/hub-game/scripts/test-act-client.mjs +186 -0
  311. package/kits/hub-game/scripts/test-act.mjs +171 -0
  312. package/kits/hub-game/scripts/test-action-layout.mjs +80 -0
  313. package/kits/hub-game/scripts/test-action-observers.mjs +46 -0
  314. package/kits/hub-game/scripts/test-actions-client.mjs +853 -0
  315. package/kits/hub-game/scripts/test-actions.mjs +298 -0
  316. package/kits/hub-game/scripts/test-actor-budget.mjs +44 -0
  317. package/kits/hub-game/scripts/test-actors.mjs +38 -23
  318. package/kits/hub-game/scripts/test-analytics.mjs +76 -0
  319. package/kits/hub-game/scripts/test-anonymous-entry.mjs +28 -0
  320. package/kits/hub-game/scripts/test-arrival-pose-server.mjs +196 -0
  321. package/kits/hub-game/scripts/test-arrival-pose.mjs +24 -0
  322. package/kits/hub-game/scripts/test-ask-client.mjs +358 -0
  323. package/kits/hub-game/scripts/test-ask-slot.mjs +85 -0
  324. package/kits/hub-game/scripts/test-ask.mjs +269 -0
  325. package/kits/hub-game/scripts/test-attention.mjs +10 -1
  326. package/kits/hub-game/scripts/test-avatar-cap.mjs +379 -0
  327. package/kits/hub-game/scripts/test-avatar-colors.mjs +72 -0
  328. package/kits/hub-game/scripts/test-avatar-models.mjs +181 -0
  329. package/kits/hub-game/scripts/test-avatar-share.mjs +318 -0
  330. package/kits/hub-game/scripts/test-avatar-wire.mjs +792 -0
  331. package/kits/hub-game/scripts/test-avatar.mjs +584 -7
  332. package/kits/hub-game/scripts/test-back-visibility.mjs +82 -0
  333. package/kits/hub-game/scripts/test-ballot.mjs +1008 -0
  334. package/kits/hub-game/scripts/test-ban-join.mjs +121 -13
  335. package/kits/hub-game/scripts/test-build.mjs +49 -0
  336. package/kits/hub-game/scripts/test-cells.mjs +71 -0
  337. package/kits/hub-game/scripts/test-chat.mjs +863 -0
  338. package/kits/hub-game/scripts/test-classic.mjs +2 -0
  339. package/kits/hub-game/scripts/test-companion-chat.mjs +216 -0
  340. package/kits/hub-game/scripts/test-companion-client.mjs +1167 -0
  341. package/kits/hub-game/scripts/test-companion.mjs +259 -0
  342. package/kits/hub-game/scripts/test-control-layout-dom.mjs +120 -0
  343. package/kits/hub-game/scripts/test-crowd-names.mjs +205 -0
  344. package/kits/hub-game/scripts/test-decor-client.mjs +344 -0
  345. package/kits/hub-game/scripts/test-decor.mjs +464 -0
  346. package/kits/hub-game/scripts/test-default-environment-root.mjs +95 -0
  347. package/kits/hub-game/scripts/test-default-environment.mjs +267 -0
  348. package/kits/hub-game/scripts/test-door-analytics.mjs +58 -0
  349. package/kits/hub-game/scripts/test-door-jump.mjs +100 -0
  350. package/kits/hub-game/scripts/test-earned-client.mjs +459 -0
  351. package/kits/hub-game/scripts/test-earned.mjs +1224 -0
  352. package/kits/hub-game/scripts/test-emote-bubble.mjs +110 -0
  353. package/kits/hub-game/scripts/test-far-avatars.mjs +340 -0
  354. package/kits/hub-game/scripts/test-fps-telemetry.mjs +112 -0
  355. package/kits/hub-game/scripts/test-frame-batch.mjs +252 -0
  356. package/kits/hub-game/scripts/test-fresh-friends.mjs +118 -0
  357. package/kits/hub-game/scripts/test-friend-bests.mjs +435 -0
  358. package/kits/hub-game/scripts/test-grab-orbit.mjs +961 -0
  359. package/kits/hub-game/scripts/test-grab.mjs +7 -0
  360. package/kits/hub-game/scripts/test-hats.mjs +422 -168
  361. package/kits/hub-game/scripts/test-high-only.mjs +170 -0
  362. package/kits/hub-game/scripts/test-hub-leaving.mjs +203 -0
  363. package/kits/hub-game/scripts/test-hub-ops.mjs +758 -2
  364. package/kits/hub-game/scripts/test-hub-trip.mjs +1594 -12
  365. package/kits/hub-game/scripts/test-hud-clear.mjs +484 -57
  366. package/kits/hub-game/scripts/test-hud-defects-dom.mjs +100 -0
  367. package/kits/hub-game/scripts/test-hud-rate.mjs +224 -0
  368. package/kits/hub-game/scripts/test-hud-safe-visibility-dom.mjs +83 -0
  369. package/kits/hub-game/scripts/test-idle.mjs +427 -1
  370. package/kits/hub-game/scripts/test-interest-cap.mjs +36 -0
  371. package/kits/hub-game/scripts/test-interest-cells.mjs +513 -0
  372. package/kits/hub-game/scripts/test-interest-client.mjs +118 -0
  373. package/kits/hub-game/scripts/test-interest.mjs +15 -0
  374. package/kits/hub-game/scripts/test-invites-client.mjs +430 -0
  375. package/kits/hub-game/scripts/test-invites.mjs +109 -0
  376. package/kits/hub-game/scripts/test-keys.mjs +46 -1
  377. package/kits/hub-game/scripts/test-labels.mjs +664 -0
  378. package/kits/hub-game/scripts/test-landscape-layout.mjs +194 -0
  379. package/kits/hub-game/scripts/test-list-scroll-dom.mjs +49 -0
  380. package/kits/hub-game/scripts/test-load-abandon.mjs +246 -0
  381. package/kits/hub-game/scripts/test-loading-cover.mjs +162 -0
  382. package/kits/hub-game/scripts/test-manifest.mjs +472 -0
  383. package/kits/hub-game/scripts/test-menu-client.mjs +585 -0
  384. package/kits/hub-game/scripts/test-menu.mjs +319 -0
  385. package/kits/hub-game/scripts/test-npcs.mjs +2528 -13
  386. package/kits/hub-game/scripts/test-object-entry.mjs +76 -0
  387. package/kits/hub-game/scripts/test-observed.mjs +745 -0
  388. package/kits/hub-game/scripts/test-pack.mjs +7 -0
  389. package/kits/hub-game/scripts/test-pad-cues.mjs +304 -0
  390. package/kits/hub-game/scripts/test-pad-occupancy.mjs +177 -0
  391. package/kits/hub-game/scripts/test-picker.mjs +541 -0
  392. package/kits/hub-game/scripts/test-placement-cache.mjs +690 -0
  393. package/kits/hub-game/scripts/test-progress-reset.mjs +559 -0
  394. package/kits/hub-game/scripts/test-push-visit.mjs +26 -0
  395. package/kits/hub-game/scripts/test-quality.mjs +385 -0
  396. package/kits/hub-game/scripts/test-rehello.mjs +1733 -0
  397. package/kits/hub-game/scripts/test-relations-among.mjs +222 -0
  398. package/kits/hub-game/scripts/test-relations-refresh.mjs +188 -0
  399. package/kits/hub-game/scripts/test-resume-action-order.mjs +598 -0
  400. package/kits/hub-game/scripts/test-resume-held.mjs +239 -0
  401. package/kits/hub-game/scripts/test-resume-pose.mjs +142 -0
  402. package/kits/hub-game/scripts/test-safe-events-dom.mjs +116 -0
  403. package/kits/hub-game/scripts/test-safe-layout.mjs +330 -0
  404. package/kits/hub-game/scripts/test-say.mjs +1 -1
  405. package/kits/hub-game/scripts/test-shot.mjs +901 -0
  406. package/kits/hub-game/scripts/test-signin-client.mjs +45 -0
  407. package/kits/hub-game/scripts/test-soundscape.mjs +5437 -0
  408. package/kits/hub-game/scripts/test-spin.mjs +314 -0
  409. package/kits/hub-game/scripts/test-standing.mjs +449 -0
  410. package/kits/hub-game/scripts/test-storage-limit.mjs +333 -0
  411. package/kits/hub-game/scripts/test-stuck.mjs +1904 -0
  412. package/kits/hub-game/scripts/test-talk-overlay-dom.mjs +130 -0
  413. package/kits/hub-game/scripts/test-tier-cells.mjs +706 -0
  414. package/kits/hub-game/scripts/test-tiers-render.mjs +412 -0
  415. package/kits/hub-game/scripts/test-tiers.mjs +476 -2
  416. package/kits/hub-game/scripts/test-toast-band.mjs +61 -0
  417. package/kits/hub-game/scripts/test-try-on.mjs +22 -22
  418. package/kits/hub-game/scripts/test-vis.mjs +770 -0
  419. package/kits/hub-game/scripts/test-visibility.mjs +134 -0
  420. package/kits/hub-game/scripts/test-weakest-tier.mjs +924 -0
  421. package/kits/hub-game/scripts/test-world-labels.mjs +367 -0
  422. package/kits/hub-game/scripts/test-yours-chrome.mjs +210 -0
  423. package/kits/hub-game/scripts/test-yours.mjs +403 -0
  424. package/kits/multiplayer-3d/CLAUDE.md +50 -0
  425. package/kits/multiplayer-3d/castle.json +5 -5
  426. package/kits/multiplayer-3d/code/client/avatars.js +7 -0
  427. package/kits/multiplayer-3d/code/client/gait.js +65 -0
  428. package/kits/multiplayer-3d/code/client/joinFailure.js +27 -0
  429. package/kits/multiplayer-3d/code/client/nameTags.js +59 -4
  430. package/kits/multiplayer-3d/code/client/resumeGate.js +139 -0
  431. package/kits/multiplayer-3d/code/options.js +5 -0
  432. package/kits/multiplayer-3d/code/server/ownership.js +10 -2
  433. package/kits/multiplayer-3d/code/server/sceneBodies.js +12 -0
  434. package/kits/multiplayer-3d/code/server/world.js +7 -0
  435. package/kits/multiplayer-3d/code/systems/multiplayer.js +443 -34
  436. package/kits/multiplayer-3d/package-lock.json +8 -1
  437. package/kits/multiplayer-3d/package.json +3 -1
  438. package/kits/multiplayer-3d/scripts/fixtures/README.md +11 -0
  439. package/kits/multiplayer-3d/scripts/fixtures/ownership-legacy.json +2 -0
  440. package/kits/multiplayer-3d/scripts/ownership-harness.mjs +102 -0
  441. package/kits/multiplayer-3d/scripts/ownership-loader.mjs +46 -0
  442. package/kits/multiplayer-3d/scripts/ownership-worker.mjs +15 -0
  443. package/kits/multiplayer-3d/scripts/record-ownership-session.mjs +98 -0
  444. package/kits/multiplayer-3d/scripts/test-eligible-claims.mjs +167 -0
  445. package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +436 -0
  446. package/kits/multiplayer-3d/scripts/test-own-name-tag.mjs +247 -0
  447. package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +624 -0
  448. package/kits/physics-2d/CLAUDE.md +19 -1
  449. package/kits/physics-2d/castle.json +2 -2
  450. package/kits/physics-2d/engine/frozenActors.js +233 -0
  451. package/kits/physics-2d/engine/scene.js +337 -3
  452. package/kits/physics-2d/engine/skyKey.js +129 -0
  453. package/kits/physics-2d/engine/stillClock.js +106 -0
  454. package/kits/physics-2d/engine/updateBudget.js +21 -0
  455. package/kits/physics-2d/eslint.config.js +1 -1
  456. package/kits/physics-2d/play/behaviors/AnalogStick.js +198 -0
  457. package/kits/physics-2d/play/behaviors/Camera.js +40 -0
  458. package/kits/physics-2d/play/behaviors/Collider.js +122 -0
  459. package/kits/physics-2d/play/behaviors/Draggable.js +115 -0
  460. package/kits/physics-2d/play/behaviors/Goal.js +46 -0
  461. package/kits/physics-2d/play/behaviors/Joints.js +126 -0
  462. package/kits/physics-2d/play/behaviors/Layout.js +71 -0
  463. package/kits/physics-2d/play/behaviors/RigidBody.js +57 -0
  464. package/kits/physics-2d/play/behaviors/Slingshot.js +142 -0
  465. package/kits/physics-2d/play/behaviors/SoundPlayer.js +263 -0
  466. package/kits/physics-2d/play/behaviors/Sprite.js +406 -0
  467. package/kits/physics-2d/play/behaviors/Style.js +209 -0
  468. package/kits/physics-2d/play/behaviors/Text.js +85 -0
  469. package/kits/physics-2d/play/behaviors/Video.js +93 -0
  470. package/kits/physics-2d/scripts/test-skip-unchanged.mjs +326 -1
  471. package/kits/physics-3d/CLAUDE.md +42 -529
  472. package/kits/physics-3d/behaviors/Body.jsx +3 -0
  473. package/kits/physics-3d/behaviors/Model.jsx +3 -0
  474. package/kits/physics-3d/behaviors/Player.jsx +661 -87
  475. package/kits/physics-3d/behaviors/Shape.jsx +3 -0
  476. package/kits/physics-3d/behaviors/Solid.jsx +3 -0
  477. package/kits/physics-3d/behaviors/Transform.jsx +3 -0
  478. package/kits/physics-3d/castle.json +3 -3
  479. package/kits/physics-3d/docs/engine-camera.md +542 -0
  480. package/kits/physics-3d/docs/engine-frame-cap.md +136 -0
  481. package/kits/physics-3d/docs/engine-load.md +149 -0
  482. package/kits/physics-3d/docs/engine-look.md +114 -0
  483. package/kits/physics-3d/docs/engine-shadows.md +372 -0
  484. package/kits/physics-3d/docs/engine-skip-work.md +187 -0
  485. package/kits/physics-3d/docs/engine-sky.md +198 -0
  486. package/kits/physics-3d/docs/engine-static-actors.md +226 -0
  487. package/kits/physics-3d/docs/engine-view.md +37 -0
  488. package/kits/physics-3d/docs/pxmodel-format.md +9 -1
  489. package/kits/physics-3d/engine3d/PlayOnly3D.jsx +5 -1
  490. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +19 -277
  491. package/kits/physics-3d/engine3d/actornode.js +87 -0
  492. package/kits/physics-3d/engine3d/animationBudget.js +23 -0
  493. package/kits/physics-3d/engine3d/branches.js +3 -13
  494. package/kits/physics-3d/engine3d/cage.js +2 -7
  495. package/kits/physics-3d/engine3d/cageops.js +2 -17
  496. package/kits/physics-3d/engine3d/dataBehaviors.js +12 -0
  497. package/kits/physics-3d/engine3d/editorWorld.js +6 -0
  498. package/kits/physics-3d/engine3d/emptynodes.js +232 -0
  499. package/kits/physics-3d/engine3d/framecap.js +99 -0
  500. package/kits/physics-3d/engine3d/frozenphysics.js +140 -0
  501. package/kits/physics-3d/engine3d/frozenstatics.js +273 -0
  502. package/kits/physics-3d/engine3d/gait.js +126 -0
  503. package/kits/physics-3d/engine3d/initialModelFiles.js +18 -0
  504. package/kits/physics-3d/engine3d/kithooks.js +47 -0
  505. package/kits/physics-3d/engine3d/look.js +514 -48
  506. package/kits/physics-3d/engine3d/lookbake.js +208 -0
  507. package/kits/physics-3d/engine3d/materialpresets.js +2 -0
  508. package/kits/physics-3d/engine3d/modelFiles.js +3 -17
  509. package/kits/physics-3d/engine3d/modelMath.js +49 -0
  510. package/kits/physics-3d/engine3d/modelready.js +16 -0
  511. package/kits/physics-3d/engine3d/motion.js +39 -10
  512. package/kits/physics-3d/engine3d/nearshadows.js +106 -21
  513. package/kits/physics-3d/engine3d/optimize.js +9 -5
  514. package/kits/physics-3d/engine3d/orbitinput.js +522 -10
  515. package/kits/physics-3d/engine3d/orbitlens.js +48 -0
  516. package/kits/physics-3d/engine3d/ownmodel.js +213 -0
  517. package/kits/physics-3d/engine3d/partgeometry.js +1 -16
  518. package/kits/physics-3d/engine3d/paths.js +1 -9
  519. package/kits/physics-3d/engine3d/playTimings.js +50 -0
  520. package/kits/physics-3d/engine3d/playerRun.js +372 -0
  521. package/kits/physics-3d/engine3d/pxmodel.js +42 -11
  522. package/kits/physics-3d/engine3d/rapier.js +27 -0
  523. package/kits/physics-3d/engine3d/scatter.js +1 -11
  524. package/kits/physics-3d/engine3d/shadowfade.js +890 -0
  525. package/kits/physics-3d/engine3d/sky.js +547 -0
  526. package/kits/physics-3d/engine3d/skylife.js +306 -0
  527. package/kits/physics-3d/engine3d/squarefirst.js +177 -0
  528. package/kits/physics-3d/engine3d/stillshadows.js +399 -0
  529. package/kits/physics-3d/engine3d/sweep.js +1 -25
  530. package/kits/physics-3d/engine3d/unchanged.js +11 -0
  531. package/kits/physics-3d/engine3d/viewrange.js +52 -0
  532. package/kits/physics-3d/engine3d/world3d.js +1253 -76
  533. package/kits/physics-3d/eslint.config.js +2 -1
  534. package/kits/physics-3d/main.jsx +10 -2
  535. package/kits/physics-3d/package-lock.json +7 -0
  536. package/kits/physics-3d/package.json +5 -1
  537. package/kits/physics-3d/play/behaviors/Body.js +31 -0
  538. package/kits/physics-3d/play/behaviors/Door.js +37 -0
  539. package/kits/physics-3d/play/behaviors/Lookable.js +16 -0
  540. package/kits/physics-3d/play/behaviors/Model.js +23 -0
  541. package/kits/physics-3d/play/behaviors/Pickup.js +46 -0
  542. package/kits/physics-3d/play/behaviors/Player.js +1204 -0
  543. package/kits/physics-3d/play/behaviors/Shape.js +47 -0
  544. package/kits/physics-3d/play/behaviors/Solid.js +16 -0
  545. package/kits/physics-3d/play/behaviors/Transform.js +29 -0
  546. package/kits/physics-3d/pnpm-lock.yaml +8 -0
  547. package/kits/physics-3d/scripts/bench-shadow-fade.mjs +37 -0
  548. package/kits/physics-3d/scripts/build-rapier-gz.mjs +56 -0
  549. package/kits/physics-3d/scripts/frozen-statics-fixture.mjs +141 -0
  550. package/kits/physics-3d/scripts/look-baseline.mjs +155 -0
  551. package/kits/physics-3d/scripts/test-camera-follow.mjs +5 -1
  552. package/kits/physics-3d/scripts/test-camera-orbit.mjs +2613 -82
  553. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +2 -2
  554. package/kits/physics-3d/scripts/test-empty-gait-hints.mjs +89 -0
  555. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +438 -0
  556. package/kits/physics-3d/scripts/test-frame-cap.mjs +452 -0
  557. package/kits/physics-3d/scripts/test-frozen-nested.mjs +49 -0
  558. package/kits/physics-3d/scripts/test-frozen-statics-legacy-physics2d.mjs +123 -0
  559. package/kits/physics-3d/scripts/test-frozen-statics.mjs +434 -0
  560. package/kits/physics-3d/scripts/test-gait.mjs +387 -0
  561. package/kits/physics-3d/scripts/test-look-bake.mjs +1056 -0
  562. package/kits/physics-3d/scripts/test-model-parse-cache.mjs +92 -0
  563. package/kits/physics-3d/scripts/test-near-shadows.mjs +5 -2
  564. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +2001 -0
  565. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +582 -0
  566. package/kits/physics-3d/scripts/test-orbit-shot.mjs +657 -0
  567. package/kits/physics-3d/scripts/test-orbit-view.mjs +230 -0
  568. package/kits/physics-3d/scripts/test-rapier-gz.mjs +106 -0
  569. package/kits/physics-3d/scripts/test-skip-empty-nodes.mjs +845 -0
  570. package/kits/physics-3d/scripts/test-sky.mjs +2470 -0
  571. package/kits/physics-3d/scripts/test-square-first.mjs +921 -0
  572. package/kits/physics-3d/scripts/test-static-actors.mjs +10 -1
  573. package/kits/physics-3d/scripts/test-static-physics.mjs +4 -1
  574. package/kits/physics-3d/scripts/test-static-scenery.mjs +2174 -0
  575. package/kits/physics-3d/scripts/test-steady-hover.mjs +7 -2
  576. package/kits/physics-3d/scripts/test-still-shadows.mjs +477 -0
  577. package/kits/physics-3d/scripts/test-view-range.mjs +260 -0
  578. package/kits/physics-3d/systems/physics3d.js +419 -9
  579. package/kits/real-time/castle.json +2 -2
  580. package/kits/real-time/code/client/connection.js +33 -10
  581. package/kits/real-time/code/client/gameHooks.js +2 -0
  582. package/kits/real-time/code/client/joinOverlay.js +9 -4
  583. package/kits/real-time/code/server/gameHooks.js +7 -0
  584. package/kits/real-time/code/server/session.js +102 -22
  585. package/kits/real-time/package-lock.json +1 -1
  586. package/package.json +2 -2
  587. package/dist/shell/assets/index-Cf61cNfT.css +0 -1
@@ -0,0 +1,403 @@
1
+ import assert from 'node:assert/strict';
2
+ import { rowsFor, send, cleanHearts } from '../code/server/yours.js';
3
+ import { take } from '../code/server/history.js';
4
+ import { makeYours, toggleHeart, relativeDay } from '../code/client/yours.js';
5
+ import { ASK_SLOT_MS, makeAskSlot } from '../code/client/askSlot.js';
6
+ const flush = () => new Promise((r) => setImmediate(r));
7
+ const doors = Array.from({ length: 8 }, (_, i) => ({ id: `d${i}`, title: `Game ${i}`, to: `deck:game-${i}` }));
8
+ const boards = new Map(doors.map((d, i) => [d.id, { toDeckId: `game-${i}`, unit: 'points' }]));
9
+ const history = {
10
+ recent: [7, 6, 5, 4, 3, 2, 1, 0].map((i) => ({ deckId: `game-${i}`, place: 'main', at: '2026-10-02T12:00:00Z', score: 3 })),
11
+ records: [{ deckId: 'game-1', place: 'main', bestScore: 9, unit: 'ms', lastAt: '2026-10-04T20:00:00Z' }],
12
+ };
13
+ const rows = rowsFor(doors, boards, history, ['gone', 'd1', 'd0']);
14
+ assert.deepEqual(rows.map((r) => r.door), ['d1', 'd0', 'd7', 'd6', 'd5']);
15
+ assert.equal(rows[0].line, 'Best 9 points');
16
+ assert.equal(rows[0].lastAt, Date.parse('2026-10-04T20:00:00Z'));
17
+ assert.equal(rows[1].line, 'Last 3 points');
18
+ assert.equal(rows[1].lastAt, Date.parse('2026-10-02T12:00:00Z'));
19
+ assert.equal(rows[2].hearted, false);
20
+ assert.deepEqual(rowsFor(doors, boards, { recent: [{ deckId: 'elsewhere', place: 'main' }] }, []), []);
21
+ assert.equal(rowsFor(doors, boards, null, ['d2'])[0].line, '');
22
+ assert.equal(rowsFor(doors, boards, { records: [{ deckId: 'game-1', place: 'arena', bestScore: 400 }] }, ['d1'])[0].line, '');
23
+ assert.equal(rowsFor(doors, boards, { recent: [{ deckId: 'game-1', place: 'main', outcome: 'win', at: '2026-10-05T11:00:00Z' }] }, [])[0].line, 'win');
24
+ assert.equal(rowsFor(doors, boards, { recent: [{ deckId: 'game-1', place: 'arena', outcome: 'win', at: '2026-10-05T11:00:00Z' }] }, [])[0].door, 'd1', 'recent play maps by destination deck, including its subplaces');
25
+ assert.deepEqual(cleanHearts(['d1', 'd1', 1, '', 'd2']), ['d1', 'd2']);
26
+ const messages = [];
27
+ const entry = { history, hearts: ['d1'] };
28
+ const h = { manifest: { yourGames: true }, place: {}, boards, players: new Map([['p1', entry], ['guest', { history, hearts: ['d2'] }], ['empty', {}]]), session: { send: (id, msg) => messages.push([id, msg]) } };
29
+ const members = () => new Map([['u1', 'p1'], ['u2', 'empty']]);
30
+ send(h, doors, members);
31
+ assert.equal(messages.length, 1);
32
+ assert.equal(messages[0][0], 'p1');
33
+ assert.equal(messages[0][1].k, 'hub-yours');
34
+ send(h, doors, members);
35
+ assert.equal(messages.length, 1, 'latched');
36
+ entry.hearts = [];
37
+ entry.history = null;
38
+ send(h, doors, members);
39
+ assert.deepEqual(messages.at(-1), ['p1', { k: 'hub-yours', rows: [], hearts: [] }]);
40
+ h.place.result = {};
41
+ entry.hearts = ['d1'];
42
+ send(h, doors, members);
43
+ assert.equal(messages.length, 2, 'no game message');
44
+ h.place = {};
45
+ h.manifest = {};
46
+ send(h, doors, () => { throw new Error('keyless must not read members'); });
47
+ take(h, 'p1', { recent: [], records: [], get hearts() { throw new Error('keyless must not read hearts'); } });
48
+ assert.equal(messages.length, 2);
49
+ h.manifest.yourGames = true;
50
+ take(h, 'p1', { hearts: ['d2'], recent: [], records: [] }, Date.now() + 1);
51
+ assert.deepEqual(entry.hearts, ['d2']);
52
+
53
+ assert.deepEqual(toggleHeart(Array.from({ length: 8 }, (_, i) => `d${i}`), 'new'), ['d1', 'd2', 'd3', 'd4', 'd5', 'd6', 'd7', 'new']);
54
+ const writes = [], toasts = [];
55
+ let readCount = 0;
56
+ const api = { hearts: async () => { readCount++; return { status: 'ok', hearts: ['d1'] }; }, setHearts: (ids) => new Promise((resolve, reject) => writes.push({ ids, resolve, reject })) };
57
+ const client = makeYours(api, { getCurrent: async () => ({ userId: '1', isAnonymous: false }) }, (text) => toasts.push(text));
58
+ const state = { rows, hearts: ['d1'] };
59
+ client.frame(false, state, 100);
60
+ assert.equal(readCount, 0, 'no town, no command');
61
+ client.frame(true, state, 100);
62
+ await flush();
63
+ client.frame(true, state, 200);
64
+ assert.equal(readCount, 1, 'one read per visit');
65
+ const arrivalAsk = client.ask(state, doors, ['p2'], 200);
66
+ assert.equal(arrivalAsk.yes, 'Go together');
67
+ assert.equal(arrivalAsk.requiresArrivalPlacement, undefined, 'the ordinary arrival offer needs no return placement');
68
+ client.dismiss();
69
+ assert.equal(client.ask(state, doors, [], 300), null, 'once per visit');
70
+ client.returned('d0');
71
+ const solo = doors.map((d) => ({ ...d, solo: d.id === 'd0' }));
72
+ assert.equal(client.ask(state, solo, ['p2'], 300).yes, 'Go');
73
+ assert.equal(client.ask(state, solo, ['p2'], 300).requiresArrivalPlacement, true, 'a returned occurrence owns its placement requirement');
74
+ assert.equal(client.ask(state, solo, [], 300).heart, false);
75
+ assert.equal(client.ask(state, doors, [], 15301).kind, 'yours', 'the shared ask slot owns display expiry');
76
+ client.toggle('d0');
77
+ client.toggle('d2');
78
+ assert.deepEqual(client.controls().hearts, ['d1', 'd0', 'd2'], 'optimistic');
79
+ await flush();
80
+ assert.deepEqual(writes[0].ids, ['d1', 'd0']);
81
+ client.frame(true, { ...state, hearts: ['server-change'] }, 400);
82
+ assert.deepEqual(client.controls().hearts, ['d1', 'd0', 'd2'], 'snapshot during a write cannot undo queued optimistic hearts');
83
+ writes[0].reject(new Error('down'));
84
+ await flush();
85
+ assert.deepEqual(client.controls().hearts, ['d1', 'd2'], 'only failed toggle rolls back');
86
+ assert.deepEqual(writes[1].ids, ['d1', 'd2'], 'serialized after failure');
87
+ writes[1].resolve({ status: 'ok', hearts: ['d1', 'd2'] });
88
+ await flush();
89
+ assert.equal(toasts.length, 1);
90
+ client.frame(true, { ...state, hearts: ['d1'] }, 500);
91
+ assert.deepEqual(client.controls().hearts, ['d1', 'd2'], 'successful write stays authoritative over a stale snapshot');
92
+ client.frame(true, { ...state, hearts: ['d1', 'd2'] }, 600);
93
+ client.frame(true, { ...state, hearts: ['d0'] }, 700);
94
+ assert.deepEqual(client.controls().hearts, ['d1', 'd2'], 'a matching snapshot does not shorten the freshness window');
95
+ client.clear();
96
+ client.frame(true, state, 1000);
97
+ await flush();
98
+ assert.equal(readCount, 4, 'each toggle and the new visit read again');
99
+ for (const unavailable of [async () => { throw Object.assign(new Error(), { code: 'UNKNOWN_COMMAND' }); }, async () => ({ status: 'unavailable', hearts: [] })]) {
100
+ const old = makeYours({ hearts: unavailable }, { getCurrent: async () => ({ userId: '1' }) }, () => {});
101
+ old.frame(true, state, 0);
102
+ await flush();
103
+ assert.equal(old.controls(), null, 'old/unavailable host hides hearts');
104
+ }
105
+ const guest = makeYours(api, { getCurrent: async () => ({ userId: 'guest', isAnonymous: true }) }, () => {});
106
+ guest.frame(true, state, 0);
107
+ await flush();
108
+ assert.equal(readCount, 4, 'guest never asks hearts');
109
+ assert.equal(guest.ask(state, doors, [], 1), null);
110
+ assert.deepEqual(guest.rows(state, doors), []);
111
+ console.log('hub-game yours: rows, private latch, keyless no-read, visits, guests, old hosts, party/solo, optimistic queue passed');
112
+
113
+ // Late host/read answers must not repaint a newer visit, or hide a newly
114
+ // supported heart behind the ask card's unchanged key.
115
+ {
116
+ let finishRead;
117
+ const late = makeYours({ hearts: () => new Promise((resolve) => { finishRead = resolve; }) }, { getCurrent: async () => ({ userId: '1' }) }, () => {});
118
+ late.returned('d1');
119
+ late.frame(true, state, 100);
120
+ await flush();
121
+ const waiting = late.ask(state, doors, [], 200);
122
+ assert.equal(waiting.heart, undefined);
123
+ finishRead({ status: 'ok', hearts: ['d1'] });
124
+ await flush();
125
+ const ready = late.ask(state, doors, [], 200);
126
+ assert.equal(ready.heart, true);
127
+ assert.notEqual(ready.key, waiting.key, 'heart availability redraws the chip');
128
+ assert.equal(ready.slotKey, waiting.slotKey, 'heart availability keeps the arrival occurrence');
129
+ const partyReady = late.ask(state, doors, ['party'], 200);
130
+ assert.notEqual(ready.key, partyReady.key, 'party label redraws the chip');
131
+ assert.equal(ready.slotKey, partyReady.slotKey, 'party wording keeps the arrival occurrence');
132
+ late.frame(true, { ...state, hearts: ['old'] }, 300);
133
+ assert.deepEqual(late.controls().hearts, ['old'], 'later account snapshot is accepted without a matching confirmation');
134
+ const old = makeYours({ hearts: () => new Promise((resolve) => { finishRead = resolve; }) }, { getCurrent: async () => ({ userId: '1' }) }, () => {});
135
+ old.frame(true, state, 100);
136
+ await flush();
137
+ old.clear();
138
+ finishRead({ status: 'ok', hearts: ['d1'] });
139
+ await flush();
140
+ assert.equal(old.controls(), null, 'old visit read ignored');
141
+ }
142
+ console.log('hub-game yours late answers: host/read race, chip redraw, old visit isolation passed');
143
+
144
+ // Removing the selected first heart redraws to another door without minting
145
+ // a fresh lease for the same outside-arrival occurrence.
146
+ {
147
+ const heartState = { rows: state.rows, hearts: ['d0', 'd1'] };
148
+ const changing = makeYours({
149
+ hearts: async () => ({ status: 'ok', hearts: ['d0', 'd1'] }),
150
+ setHearts: async (hearts) => ({ status: 'ok', hearts }),
151
+ }, { getCurrent: async () => ({ userId: '1' }) }, () => {});
152
+ changing.frame(true, heartState, 0);
153
+ await flush();
154
+ const first = changing.ask(heartState, doors, [], 0);
155
+ assert.equal(first.door, 'd0');
156
+ const slot = makeAskSlot();
157
+ slot.display(first, { x: 0, z: 0 }, new Set(), 0);
158
+ slot.frame({ x: 0, z: 0 }, new Set(), ASK_SLOT_MS);
159
+ changing.toggle('d0');
160
+ const next = changing.ask(heartState, doors, [], ASK_SLOT_MS);
161
+ assert.equal(next.door, 'd1');
162
+ assert.notEqual(next.key, first.key, 'the changed row redraws chrome');
163
+ assert.equal(next.slotKey, first.slotKey, 'the selected door does not define the occurrence');
164
+ assert.equal(slot.display(next, { x: 0, z: 0 }, new Set(), ASK_SLOT_MS), null, 'the expired arrival offer does not resurrect on the next row');
165
+ }
166
+
167
+ // Each toggle reads ghost, even when the display still has another tab's old
168
+ // list. Removing, adding and trimming all operate on that fresh list.
169
+ {
170
+ let ghost = ['d1'];
171
+ const calls = [];
172
+ const fresh = makeYours({
173
+ hearts: async () => { calls.push('read'); return { status: 'ok', hearts: [...ghost] }; },
174
+ setHearts: async (ids) => { calls.push([...ids]); ghost = ids; return { status: 'ok', hearts: ids }; },
175
+ }, { getCurrent: async () => ({ userId: '1' }) }, () => {});
176
+ fresh.frame(true, state, 0);
177
+ await flush();
178
+ ghost = ['d2', 'd3']; // Another tab changed ghost without a snapshot here.
179
+ fresh.toggle('d1');
180
+ assert.deepEqual(fresh.controls().hearts, [], 'optimistic display uses confirmed hearts');
181
+ await flush();
182
+ assert.deepEqual(ghost, ['d2', 'd3', 'd1'], 'toggle uses fresh membership and preserves unseen hearts from the other tab');
183
+ ghost = ['d2', 'd4', 'd5'];
184
+ fresh.toggle('d4');
185
+ await flush();
186
+ assert.deepEqual(ghost, ['d2', 'd5'], 'removal also preserves the other tab change');
187
+ ghost = Array.from({ length: 8 }, (_, i) => `d${i}`);
188
+ fresh.toggle('new');
189
+ await flush();
190
+ assert.deepEqual(ghost, ['d1', 'd2', 'd3', 'd4', 'd5', 'd6', 'd7', 'new'], 'drop oldest from the fresh list, newest last');
191
+ assert.deepEqual(calls, ['read', 'read', ['d2', 'd3', 'd1'], 'read', ['d2', 'd5'], 'read', ghost], 'every write follows its own fresh read');
192
+ }
193
+
194
+ // A queued toggle cannot read until the previous write finishes. Its base is
195
+ // a new ghost read, and its optimistic display uses the setHearts response.
196
+ {
197
+ const reads = [], writes = [], toasts = [];
198
+ const queued = makeYours({
199
+ hearts: () => new Promise((resolve, reject) => reads.push({ resolve, reject })),
200
+ setHearts: (ids) => new Promise((resolve, reject) => writes.push({ ids, resolve, reject })),
201
+ }, { getCurrent: async () => ({ userId: '1' }) }, (text) => toasts.push(text));
202
+ queued.frame(true, state, 0);
203
+ await flush();
204
+ reads[0].resolve({ status: 'ok', hearts: ['d1'] });
205
+ await flush();
206
+ queued.toggle('d2');
207
+ queued.toggle('d3');
208
+ assert.equal(reads.length, 2, 'only the first queued toggle starts reading');
209
+ assert.equal(writes.length, 0, 'no write before its read completes');
210
+ queued.frame(true, { ...state, hearts: ['stale'] }, 100);
211
+ assert.deepEqual(queued.controls().hearts, ['d1', 'd2', 'd3'], 'snapshot cannot undo optimism while reading');
212
+ reads[1].resolve({ status: 'ok', hearts: ['d4'] });
213
+ await flush();
214
+ assert.deepEqual(writes[0].ids, ['d4', 'd2']);
215
+ assert.equal(reads.length, 2, 'next toggle still waits for the write');
216
+ writes[0].resolve({ status: 'ok', hearts: ['d4', 'd2', 'confirmed'] });
217
+ await flush();
218
+ assert.deepEqual(queued.controls().hearts, ['d4', 'd2', 'confirmed', 'd3'], 'response confirms the list, with the later toggle optimistic');
219
+ assert.equal(reads.length, 3, 'later toggle starts its own read after the write');
220
+ reads[2].resolve({ status: 'ok', hearts: ['d4', 'd2', 'd5'] });
221
+ await flush();
222
+ assert.deepEqual(writes[1].ids, ['d4', 'd2', 'd5', 'd3'], 'queued toggle preserves a change from another tab between writes');
223
+ writes[1].reject(new Error('down'));
224
+ await flush();
225
+ assert.deepEqual(queued.controls().hearts, ['d4', 'd2', 'confirmed'], 'failed write reverts to the last successful response, not the fresh read');
226
+ assert.deepEqual(toasts, ["Couldn't save that heart."]);
227
+ }
228
+
229
+ // Stale snapshots during and after a write cannot undo its response. Retain
230
+ // the latest ignored snapshot and reconsider it on frames without new data.
231
+ {
232
+ let now = 0;
233
+ let ghost = ['d1'];
234
+ const writes = [], toasts = [];
235
+ const bounded = makeYours({
236
+ hearts: async () => ({ status: 'ok', hearts: [...ghost] }),
237
+ setHearts: (ids) => new Promise((resolve, reject) => writes.push({ ids, resolve, reject })),
238
+ }, { getCurrent: async () => ({ userId: '1' }) }, (text) => toasts.push(text), () => now);
239
+ bounded.frame(true, state, now);
240
+ await flush();
241
+ bounded.toggle('d2');
242
+ await flush();
243
+ const stale = { ...state };
244
+ now = 300000;
245
+ bounded.frame(true, stale, now);
246
+ assert.deepEqual(bounded.controls().hearts, ['d1', 'd2'], 'in-flight write blocks snapshots even without a freshness window');
247
+ ghost = ['d1', 'd2'];
248
+ writes[0].resolve({ status: 'ok', hearts: ghost });
249
+ await flush();
250
+ bounded.frame(true, stale, now);
251
+ assert.deepEqual(bounded.controls().hearts, ghost, 'buffered stale snapshot cannot replace the successful response');
252
+ bounded.frame(true, { ...state }, now);
253
+ assert.deepEqual(bounded.controls().hearts, ghost, 'new stale snapshot is ignored too');
254
+ bounded.frame(true, { ...state, hearts: ghost }, now);
255
+ bounded.frame(true, { ...state }, now);
256
+ assert.deepEqual(bounded.controls().hearts, ghost, 'matching snapshot does not release protection early');
257
+ bounded.toggle('d3');
258
+ await flush();
259
+ assert.deepEqual(writes[1].ids, ['d1', 'd2', 'd3']);
260
+ now = 360000;
261
+ ghost = ['d1', 'd2', 'd3'];
262
+ writes[1].resolve({ status: 'ok', hearts: ghost });
263
+ await flush();
264
+ now = 480000;
265
+ const otherTab = { ...state, hearts: ['d4'] };
266
+ bounded.frame(true, otherTab, now);
267
+ assert.deepEqual(bounded.controls().hearts, ghost, 'each success restarts the three-minute window');
268
+ bounded.toggle('d5');
269
+ await flush();
270
+ now = 510000;
271
+ writes[2].reject(new Error('down'));
272
+ await flush();
273
+ assert.deepEqual(bounded.controls().hearts, ghost, 'failure rolls back without extending the last success window');
274
+ now = 539999;
275
+ bounded.frame(true, otherTab, now);
276
+ assert.deepEqual(bounded.controls().hearts, ghost, 'latest other-tab snapshot stays buffered just before the bound');
277
+ now = 540000;
278
+ bounded.frame(true, null, now);
279
+ assert.deepEqual(bounded.controls().hearts, ['d4'], 'other tab appears at the bound without any new snapshot');
280
+ assert.deepEqual(toasts, ["Couldn't save that heart."]);
281
+ bounded.clear();
282
+ bounded.frame(true, { ...state, hearts: ['d6'] }, now);
283
+ await flush();
284
+ assert.deepEqual(bounded.controls().hearts, ['d6'], 'new visit clears the freshness window and old snapshot');
285
+ }
286
+
287
+ // A failed fresh read must not write at all, and either API's non-ok answer
288
+ // follows the same rollback path as rejection. Later queued toggles still run.
289
+ for (const failure of ['read-reject', 'read-unavailable', 'write-unavailable']) {
290
+ let readCount = 0;
291
+ const writes = [], toasts = [];
292
+ const failed = makeYours({
293
+ hearts: async () => {
294
+ readCount++;
295
+ if (readCount === 2 && failure === 'read-reject') {
296
+ throw new Error('down');
297
+ }
298
+ return { status: readCount === 2 && failure === 'read-unavailable' ? 'unavailable' : 'ok', hearts: ['d1'] };
299
+ },
300
+ setHearts: async (ids) => { writes.push(ids); return { status: failure === 'write-unavailable' && writes.length === 1 ? 'unavailable' : 'ok', hearts: ids }; },
301
+ }, { getCurrent: async () => ({ userId: '1' }) }, (text) => toasts.push(text));
302
+ failed.frame(true, state, 0);
303
+ await flush();
304
+ failed.toggle('d2');
305
+ await flush();
306
+ assert.deepEqual(failed.controls().hearts, ['d1'], `${failure} reverts to the last confirmed list`);
307
+ assert.equal(writes.length, failure === 'write-unavailable' ? 1 : 0, 'failed read cannot write');
308
+ assert.deepEqual(toasts, ["Couldn't save that heart."]);
309
+ failed.toggle('d3');
310
+ await flush();
311
+ assert.deepEqual(failed.controls().hearts, ['d1', 'd3'], 'later toggle can still save after a failure');
312
+ }
313
+
314
+ // Clearing a visit while its fresh read is pending must not send a late write.
315
+ {
316
+ const reads = [], writes = [], toasts = [];
317
+ const old = makeYours({
318
+ hearts: () => new Promise((resolve) => reads.push(resolve)),
319
+ setHearts: async (ids) => { writes.push(ids); return { status: 'ok', hearts: ids }; },
320
+ }, { getCurrent: async () => ({ userId: '1' }) }, (text) => toasts.push(text));
321
+ old.frame(true, state, 0);
322
+ await flush();
323
+ reads[0]({ status: 'ok', hearts: ['d1'] });
324
+ await flush();
325
+ old.toggle('d2');
326
+ old.clear();
327
+ old.frame(true, { ...state, hearts: ['d3'] }, 100);
328
+ await flush();
329
+ reads[2]({ status: 'ok', hearts: ['d3'] });
330
+ reads[1]({ status: 'ok', hearts: ['d1'] });
331
+ await flush();
332
+ assert.deepEqual(writes, [], 'old visit read never writes into the new visit');
333
+ assert.deepEqual(old.controls().hearts, ['d3']);
334
+ assert.deepEqual(toasts, []);
335
+ }
336
+ console.log('hub-game yours hearts: fresh read before every write, serialized queue, response confirmation, failure rollback, stale snapshots, buffered snapshot at 3-minute bound, visit isolation passed');
337
+
338
+ // Identity and rows can each take time; once ready, the shared ask slot owns
339
+ // the display lease rather than this account-data controller.
340
+ {
341
+ let identify;
342
+ const slow = makeYours({ hearts: async () => ({ status: 'ok', hearts: [] }) }, {
343
+ getCurrent: () => new Promise((resolve) => { identify = resolve; }),
344
+ }, () => {});
345
+ slow.frame(true, null, 100);
346
+ assert.equal(slow.ask(null, doors, [], 20100), null);
347
+ identify({ userId: '1' });
348
+ await flush();
349
+ slow.frame(true, null, 20100);
350
+ assert.equal(slow.ask(null, doors, [], 30100), null);
351
+ slow.frame(true, state, 40100);
352
+ assert.equal(slow.ask(state, doors, [], 40100).kind, 'yours');
353
+ assert.equal(slow.ask(state, doors, [], 55099).kind, 'yours');
354
+ assert.equal(slow.ask(state, doors, [], 55100).kind, 'yours', 'source stays available while the slot retires its display');
355
+ slow.frame(true, { ...state }, 56000);
356
+ assert.equal(slow.ask(state, doors, [], 56000).kind, 'yours', 'row refresh does not create a source-side timer');
357
+
358
+ const empty = makeYours({ hearts: async () => ({ status: 'ok', hearts: [] }) }, { getCurrent: async () => ({ userId: '1' }) }, () => {});
359
+ empty.frame(true, null, 0);
360
+ await flush();
361
+ empty.frame(true, null, 60000);
362
+ assert.equal(empty.ask(state, doors, [], 60000), null, 'give up after 60 seconds without data');
363
+ empty.frame(true, state, 61000);
364
+ assert.equal(empty.ask(state, doors, [], 61000), null, 'late rows cannot revive the arrival offer');
365
+
366
+ const blocked = makeYours({}, { getCurrent: async () => ({ userId: '1' }) }, () => {});
367
+ blocked.frame(true, state, 0);
368
+ await flush();
369
+ blocked.frame(true, state, 100);
370
+ // Higher-priority invitations/proposals do not call ask. Ready rows can wait.
371
+ blocked.frame(true, state, 70000);
372
+ assert.equal(blocked.ask(state, doors, [], 70000).kind, 'yours');
373
+ assert.equal(blocked.ask(state, doors, [], 84999).kind, 'yours');
374
+ assert.equal(blocked.ask(state, doors, [], 85000).kind, 'yours');
375
+ }
376
+
377
+ // Local calendar days, including opposite UTC boundaries and DST transitions.
378
+ {
379
+ const originalTZ = process.env.TZ;
380
+ try {
381
+ process.env.TZ = 'Pacific/Honolulu';
382
+ assert.equal(relativeDay(Date.parse('2026-10-05T23:30:00Z'), Date.parse('2026-10-06T01:00:00Z')), 'today', 'same local date across UTC midnight');
383
+ assert.equal(relativeDay(Date.parse('2026-10-05T09:30:00Z'), Date.parse('2026-10-05T10:30:00Z')), 'yesterday', 'local midnight within one UTC day');
384
+ const local = makeYours({}, { getCurrent: async () => ({ userId: '1' }) }, () => {});
385
+ local.frame(true, state, 0);
386
+ await flush();
387
+ const formatted = local.rows(state, doors)[0];
388
+ assert.equal(formatted.line, `Best 9 points · ${relativeDay(rows[0].lastAt)}`);
389
+ assert.equal(local.ask(state, doors, [], 100).line, formatted.line, 'list and arrival chip use the same local wording');
390
+ assert.equal(relativeDay(null), '');
391
+ assert.equal(relativeDay(NaN), '');
392
+ assert.equal(rowsFor(doors, boards, { recent: [{ deckId: 'game-1', at: 'bad' }] }, [])[0].lastAt, null);
393
+ process.env.TZ = 'Asia/Tokyo';
394
+ assert.equal(relativeDay(Date.parse('2026-10-05T14:30:00Z'), Date.parse('2026-10-05T15:30:00Z')), 'yesterday');
395
+ process.env.TZ = 'America/Los_Angeles';
396
+ assert.equal(relativeDay(Date.parse('2026-03-08T08:30:00Z'), Date.parse('2026-03-09T07:30:00Z')), 'yesterday', '23-hour local calendar day');
397
+ assert.equal(relativeDay(Date.parse('2026-11-01T07:30:00Z'), Date.parse('2026-11-03T08:30:00Z')), '2 days ago', '49 hours span two local calendar days');
398
+ } finally {
399
+ if (originalTZ === undefined) delete process.env.TZ;
400
+ else process.env.TZ = originalTZ;
401
+ }
402
+ }
403
+ console.log('hub-game yours regressions: delayed arrival, 60s bound, local calendar and DST passed');
@@ -127,6 +127,42 @@ because only the browser reads it.
127
127
  "server": { "main": "imports/castle.multiplayer-3d/code/server/index.js" }
128
128
  ```
129
129
 
130
+ ### Walk cadence option
131
+
132
+ Top-level `"gait": "model"` in the deck's own `castle.json` enables
133
+ physics-3d's scale-aware gait and remote speed hints from timestamped tracks
134
+ before pose smoothing (players and interpolated objects). Held poses target
135
+ zero; teleports are ignored. Hints are read by physics-3d versions that have
136
+ `engine3d/gait.js`; older physics-3d versions safely ignore them. Multiplayer-3d
137
+ reads the key independently and imports no physics-3d gait module. Without the
138
+ key the existing gait is unchanged.
139
+
140
+ ### Ownership option
141
+
142
+ A deck may set `"multiplayer": { "eligibleClaims": true }` at the root of a
143
+ scene file. `code/options.js` checks the active `scene.data` on the client;
144
+ `server/world.js` reads that session's scene through `sceneBodies.sceneOptions`
145
+ and sets `sim.eligibleClaims` for `server/ownership.js`. Scene data already
146
+ travels in hub content packs, so entering this scene from a town enables the
147
+ option without enabling it for the town or other places. Only literal `true`
148
+ enables it; absent or false preserves the existing claims, grants, and wire messages.
149
+
150
+ With this option, client proximity asks include only actors whose resolved
151
+ `Body.type` is `dynamic`. Owned poses and releases still use the full object
152
+ list, including any owned body that no longer passes that filter. The server
153
+ skips unknown ids, unclaimable objects, this player's objects, and objects
154
+ outside reach before spending its eight candidate checks. A contested eligible
155
+ candidate still spends a check, even when the existing takeover rule refuses
156
+ it. Each message scans at most 256 ids: this bounds lookups and reach tests on
157
+ malformed or oversized requests while allowing a dense scene's ineligible
158
+ bodies to be skipped. Ids beyond that scan bound are ignored; repeated oversized lists can still
159
+ starve their tail.
160
+ Reach, nearest-owner priority, grant hold, epochs, and handovers are unchanged.
161
+ Temporary server claimability (such as a hub reset hold) stays server-side;
162
+ a dynamic actor may still be asked for during that hold. No new wire fields.
163
+
164
+ ### Deck hooks
165
+
130
166
  and then, all optional, all found by root-anchored glob in
131
167
  `code/server/gameHooks.js`:
132
168
 
@@ -287,6 +323,20 @@ Map())` — and the next `showPlayer` respawns it.
287
323
 
288
324
  ## The name tags
289
325
 
326
+ Under the physics-3d orbit camera key only, the local player's `self` sprite
327
+ is registered in `scene.three.ownModelWith` (when that is a Set) and hides
328
+ for the same render as the own avatar when the camera is pressed close
329
+ (within 1 m, shown again past 1.2 m). nameTags.js keeps the set and the
330
+ sprite registered in a private WeakMap, so a replaced sprite or set is
331
+ swapped, disposal deletes the registered one without reading the world, and
332
+ a tag never registered is disposed reading nothing new. The engine restores
333
+ each object it hid only if it is still false and leaves already hidden
334
+ objects alone.
335
+ Without the key nothing is registered and nothing reads the set. Accepted: a
336
+ deck-defined `visible` setter on the sprite that throws on the restore and
337
+ rejects it leaves the sprite hidden; and `showSelf` reads the runtime's own
338
+ `cameraControl` field without the key too (the gate).
339
+
290
340
  A `THREE.Sprite`'s apparent size is its world scale over its distance, so a fixed
291
341
  scale is right at one distance and wrong everywhere else — the label covered a
292
342
  large part of the card whenever a camera got close, which every camera in this
@@ -7,26 +7,26 @@
7
7
  "imports": {
8
8
  "castle.real-time": {
9
9
  "deckId": "xFVr-afOLuUQ",
10
- "version": "2026-10-03T11:33:47.833Z"
10
+ "version": "2026-10-18T06:38:41.691Z"
11
11
  },
12
12
  "castle.physics-3d": {
13
13
  "deckId": "JH0SclbPVP0y",
14
- "version": "2026-10-03T09:17:32.572Z"
14
+ "version": "2026-10-18T06:40:58.918Z"
15
15
  },
16
16
  "castle.physics-2d": {
17
17
  "deckId": "ckRZGFW4iPrx",
18
- "version": "2026-10-03T04:25:18.207Z",
18
+ "version": "2026-10-17T06:02:29.713Z",
19
19
  "via": "castle.physics-3d"
20
20
  },
21
21
  "castle.base": {
22
22
  "deckId": "yRcmH4_aYllE",
23
- "version": "2026-10-03T11:33:43.975Z"
23
+ "version": "2026-10-18T06:37:02.597Z"
24
24
  }
25
25
  },
26
26
  "autoUpdateWhenImported": true,
27
27
  "deckId": "ZwA_P_-VO-Qh",
28
28
  "cardId": "bvRmCzyUpt_a",
29
- "publishedVersion": "2026-10-03T13:23:59.648Z",
29
+ "publishedVersion": "2026-10-18T06:47:00.410Z",
30
30
  "main": "main.jsx",
31
31
  "server": {
32
32
  "main": "code/server/index.js",
@@ -230,6 +230,13 @@ function showTag(avatars, scene, key, username, transform, tagHeight) {
230
230
  avatars.tags.set(key, tag);
231
231
  }
232
232
 
233
+ // Under the orbit camera key only, the own tag's sprite follows the own
234
+ // model's hide (physics-3d ownmodel.js); nameTags.js keeps the
235
+ // registration, swaps a replaced sprite and undoes it on disposal.
236
+ if (key === 'self' && scene.cameraControl === 'orbit') {
237
+ NameTags.registerOwnNameTag(tag, scene.three?.ownModelWith);
238
+ }
239
+
233
240
  // A label's drawn size follows its distance to the camera (`nameTags.js`).
234
241
  NameTags.moveNameTag(tag, transform, scene.three?.camera, tagHeight);
235
242
  }
@@ -0,0 +1,65 @@
1
+ // Cadence follows timestamped network motion, before render-pose smoothing.
2
+ // Player poses have no wire velocity. Object samples may supply `velocity`.
3
+ const HOLD_MS = 250;
4
+ const PAUSE_MS = 250;
5
+ const STOP_SPEED = 0.05;
6
+
7
+ // Called once per active system frame. A resumed frame starts a new clock,
8
+ // matching the wall-clock pause reset in easeWalkSpeed.
9
+ export function walkFrameTime(frame, wall = performance.now()) {
10
+ const elapsed = wall - frame.wall;
11
+ frame.wall = wall;
12
+ return Number.isFinite(elapsed) && elapsed >= 0 && elapsed <= PAUSE_MS
13
+ ? Math.max(0, Math.min(elapsed / 1000, 0.25)) : 0;
14
+ }
15
+
16
+ function segmentSpeed(before, after) {
17
+ if (!before || !after) {return 0;}
18
+ const span = (after.simMs - before.simMs) / 1000;
19
+ const distance = Math.hypot(...[0, 1, 2].map((i) => after.pose[i] - before.pose[i]));
20
+ if (!(span > 0) || !Number.isFinite(span) || !Number.isFinite(distance) || distance > 4) {return 0;}
21
+ const velocity = after.velocity;
22
+ const speed = velocity ? Math.hypot(velocity[0], velocity[2])
23
+ : Math.hypot(after.pose[0] - before.pose[0], after.pose[2] - before.pose[2]) / span;
24
+ return Number.isFinite(speed) ? speed : 0;
25
+ }
26
+
27
+ export function trackWalkSpeed(track, at) {
28
+ const samples = track.samples;
29
+ if (!Number.isFinite(at) || samples.length < 2 || at <= samples[0].simMs) {return 0;}
30
+ const newest = samples.at(-1);
31
+ if (at > newest.simMs) {
32
+ const over = at - newest.simMs;
33
+ return segmentSpeed(samples.at(-2), newest) * Math.max(0, 1 - over / HOLD_MS);
34
+ }
35
+ // Same newest-first bracketing search as real-time's sampleAt.
36
+ for (let i = samples.length - 1; i > 0; i -= 1) {
37
+ const before = samples[i - 1];
38
+ const after = samples[i];
39
+ if (before.simMs <= at && at <= after.simMs) {
40
+ const span = after.simMs - before.simMs;
41
+ if (!(span > 0)) {return 0;}
42
+ // sampleAt draws linearly within this segment. Smoothing belongs in
43
+ // easeWalkSpeed: previous motion must not animate a stationary segment.
44
+ return segmentSpeed(before, after);
45
+ }
46
+ }
47
+ return 0;
48
+ }
49
+
50
+ export function easeWalkSpeed(speeds, id, track, at, dt, wall = performance.now()) {
51
+ const target = trackWalkSpeed(track, at);
52
+ const previous = speeds.get(id);
53
+ // Frame dt may be capped after a suspension. Use actual wall/render time
54
+ // and track identity so old motion cannot leak into a fresh or held pose.
55
+ const reset = !previous || previous.track !== track
56
+ || !Number.isFinite(at) || !Number.isFinite(wall)
57
+ || !Number.isFinite(previous.at) || !Number.isFinite(previous.wall)
58
+ || at < previous.at || at - previous.at > 500
59
+ || wall < previous.wall || wall - previous.wall > PAUSE_MS;
60
+ const ease = Number.isFinite(dt) && dt > 0 ? 1 - Math.exp(-dt / 0.1) : 0;
61
+ const eased = reset ? target : previous.speed + (target - previous.speed) * ease;
62
+ const speed = target === 0 && eased < STOP_SPEED ? 0 : eased;
63
+ speeds.set(id, { speed, track, at, wall });
64
+ return speed;
65
+ }
@@ -0,0 +1,27 @@
1
+ // Match the real-time join overlay's quiet full-page surface. Mount on body:
2
+ // the Town cover is body-owned, outside the engine's transformed card root.
3
+ export function joinPlaceName(title) {
4
+ const name = typeof title === 'string' ? title.trim() : '';
5
+ return name === 'Town' ? 'the Town' : name;
6
+ }
7
+
8
+ export function showJoinFailure(name, retry, doc = globalThis.document) {
9
+ if (!doc?.createElement) { return null; }
10
+ const panel = doc.createElement('div');
11
+ panel.setAttribute('data-multiplayer-join-failure', '');
12
+ panel.setAttribute('role', 'alertdialog');
13
+ panel.setAttribute('aria-modal', 'true');
14
+ panel.style.cssText = 'position:fixed;inset:0;z-index:2147482500;display:flex;flex-direction:column;align-items:center;justify-content:center;gap:20px;background:#0a0a0a;color:#fff;font:500 15px/1.4 system-ui,sans-serif;padding:24px;text-align:center;cursor:auto';
15
+ const message = doc.createElement('div');
16
+ message.textContent = name ? `Couldn't join ${name}` : "Couldn't join";
17
+ panel.setAttribute('aria-label', message.textContent);
18
+ const button = doc.createElement('button');
19
+ button.type = 'button';
20
+ button.textContent = 'Retry';
21
+ button.style.cssText = 'font:inherit;color:#0a0a0a;background:#fff;border:0;border-radius:8px;padding:12px 24px;cursor:pointer';
22
+ button.addEventListener('click', retry);
23
+ panel.append(message, button);
24
+ doc.body.append(panel);
25
+ button.focus();
26
+ return () => { button.removeEventListener('click', retry); panel.remove(); };
27
+ }