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,205 @@
1
+ // Opt-in client budgets. State belongs to the runtime, never the transport or
2
+ // authored files. The load entry installs the filter before SceneRuntime.load.
3
+ import { deck, hub } from './state.js';
4
+ import { skippableDecor } from '../shared/quality.js';
5
+
6
+ const visits = new WeakMap();
7
+ // Gameplay lookups and caches need sleeping district actors too; getActors()
8
+ // is the runtime's awake-only list for live update and animation work.
9
+ export const allActors = (scene) => scene.actors ? [...scene.actors.values()] : scene.getActors();
10
+ export const qualityFor = (scene) => visits.get(scene);
11
+ export const lowQuality = (scene) => !scene.content && qualityFor(scene)?.tiers.current() === 'low' ? deck.quality?.low : null;
12
+ const distance = (a, b) => a && b ? Math.hypot((a.x ?? 0) - (b.x ?? 0), (a.z ?? 0) - (b.z ?? 0)) : Infinity;
13
+
14
+ export function noteQualityInteraction(scene, playerId, now = performance.now()) {
15
+ const q = qualityFor(scene);
16
+ if (q && playerId) {q.recent.set(playerId, now + 10000);}
17
+ }
18
+
19
+ // Existing winners count as 2 m nearer. Exemptions consume no slots.
20
+ export function choosePlayers(players, most, previous = new Set()) {
21
+ const exempt = players.filter((p) => p.exempt);
22
+ const ranked = players.filter((p) => !p.exempt).sort((a, b) =>
23
+ (a.distance - (previous.has(a.id) ? 2 : 0)) - (b.distance - (previous.has(b.id) ? 2 : 0)) || String(a.id).localeCompare(String(b.id)));
24
+ return new Set([...exempt, ...ranked.slice(0, most)].map((p) => p.id));
25
+ }
26
+
27
+ export function samePad(scene, here, there, pads = allActors(scene)) {
28
+ if (!here || !there) {return false;}
29
+ return pads.some((actor) => {
30
+ const c = actor.components;
31
+ if (!c?.HubPad || !c.Transform) {return false;}
32
+ if (hub.hidden.has(actor.id)) {return false;}
33
+ const radius = c.HubPad.radius ?? c.Shape?.radius ?? 2.3;
34
+ return distance(c.Transform, here) <= radius && distance(c.Transform, there) <= radius;
35
+ });
36
+ }
37
+
38
+ export function makeQualityVisit(tiers) {
39
+ return { tiers, skipped: [], drawn: new Set(), hidden: new Map(), recent: new Map(), emotes: new Map(), nextMind: new Map(), culled: new Set() };
40
+ }
41
+
42
+ export function resetQualityVisit(q) {
43
+ q.skipped = [];
44
+ q.drawn.clear(); q.culled.clear(); q.recent.clear(); q.emotes.clear(); q.nextMind.clear();
45
+ q.npcData = null; q.padData = null;
46
+ restorePlayers(q);
47
+ }
48
+
49
+ export function filterQualityScene(scene, data, q, componentsOf = (actor) => actor.components, protectedIds = new Set()) {
50
+ visits.set(scene, q);
51
+ resetQualityVisit(q);
52
+ if (deck.quality && !q.warned && !(data.actors ?? []).some((actor) => actor.decor === true)) {
53
+ console.warn('[hub] hub.quality.low.spawned has no decor: true templates; the cap has no effect.');
54
+ q.warned = true;
55
+ }
56
+ if (scene.content || q.tiers.current() !== 'low') {return data;}
57
+ const skipDecor = deck.quality?.low.decor === 'skip';
58
+ if (!skipDecor && !deck.highOnly) {return data;}
59
+ const actors = (data.actors ?? []).filter((actor) => {
60
+ const components = componentsOf(actor);
61
+ const highOnly = deck.highOnly === true && actor.tier === 'high';
62
+ if (!highOnly && (!skipDecor || protectedIds.has(actor.id) || !skippableDecor(actor, components))) {return true;}
63
+ q.skipped.push({ ...actor, components });
64
+ return false;
65
+ });
66
+ return { ...data, actors };
67
+ }
68
+
69
+ // Cooperative 8 ms slice including the engine's synchronous node build. No
70
+ // further actor is admitted after the budget; synchronous engine work cannot
71
+ // be preempted halfway through a single model.
72
+ export function restoreDecor(scene, q, build, clock = () => performance.now()) {
73
+ if (q.tiers.current() !== 'high' || !q.skipped.length || scene.content) {return;}
74
+ const start = clock();
75
+ let cost = 0;
76
+ while (q.skipped.length && clock() - start + cost < 8) {
77
+ const before = clock();
78
+ const actor = q.skipped.shift();
79
+ if (!scene.getActor(actor.id)) {
80
+ scene.spawnActor(structuredClone(actor));
81
+ build(scene);
82
+ }
83
+ cost = Math.max(cost, clock() - before);
84
+ }
85
+ }
86
+
87
+ function restorePlayers(q) {
88
+ for (const [node, visible] of q.hidden) {node.visible = visible;}
89
+ q.hidden.clear();
90
+ }
91
+
92
+ export function qualityPlayers(scene, q, now) {
93
+ restorePlayers(q);
94
+ const low = lowQuality(scene);
95
+ q.culled.clear();
96
+ if (!low) { q.drawn.clear(); applyPlayerVisibility(scene, q); return; }
97
+ const mp = scene.multiplayer;
98
+ const here = scene.actorWith('Player')?.components.Transform;
99
+ const players = [];
100
+ const self = mp?.net?.selfId?.();
101
+ if (q.padData !== scene.data || q.padMap !== scene.actors || q.padCount !== scene.actors?.size) {
102
+ q.padData = scene.data; q.padMap = scene.actors; q.padCount = scene.actors?.size;
103
+ q.pads = allActors(scene).filter((actor) => actor.components?.HubPad);
104
+ }
105
+ for (const [id, actorId] of mp?.avatars?.actors ?? []) {
106
+ if (id === self) {continue;}
107
+ const there = scene.getActor(actorId)?.components.Transform;
108
+ const emote = hub.emotes[id];
109
+ if (emote && q.emotes.get(id) !== emote.at) {
110
+ q.emotes.set(id, emote.at);
111
+ // Snapshot playback is not a new action: the simulation timestamp
112
+ // bounds the exemption even when joining or reconnecting.
113
+ const age = Math.max(0, (hub.lastT ?? 0) - emote.at);
114
+ if (age < 10000) {q.recent.set(id, now + 10000 - age);}
115
+ }
116
+ players.push({ id, actorId, distance: distance(here, there), exempt: hub.party.members?.includes(id) === true ||
117
+ samePad(scene, here, there, q.pads) || (q.recent.get(id) ?? -Infinity) > now });
118
+ }
119
+ q.drawn = choosePlayers(players, low.players, q.drawn);
120
+ for (const player of players) {
121
+ if (q.drawn.has(player.id)) {continue;}
122
+ q.culled.add(player.actorId);
123
+ }
124
+ applyPlayerVisibility(scene, q);
125
+ // The engine builds/replaces nodes after systems run. Scene.onBeforeRender
126
+ // is called before Three collects its draw list, so a newly built bystander
127
+ // never flashes for a frame. Existing avatar-cap/far-avatar state stays live.
128
+ const root = scene.three?.scene;
129
+ if (root && q.renderRoot !== root) {
130
+ const previous = root.onBeforeRender;
131
+ root.onBeforeRender = function (...args) {
132
+ previous?.apply(this, args);
133
+ applyPlayerVisibility(scene, q);
134
+ };
135
+ q.renderRoot = root;
136
+ }
137
+ for (const [id, until] of q.recent) {if (until <= now) {q.recent.delete(id);}}
138
+ }
139
+
140
+ export function applyPlayerVisibility(scene, q) {
141
+ restorePlayers(q);
142
+ const nodes = new Set();
143
+ for (const id of q.culled) {
144
+ const node = scene.three?.nodes?.get(id)?.node;
145
+ if (node) { q.hidden.set(node, node.visible); node.visible = false; nodes.add(node); }
146
+ }
147
+ if (nodes.size !== q.culledNodes?.size || [...nodes].some((node) => !q.culledNodes?.has(node))) {
148
+ // Shared instances live outside avatar roots. Their matrices were gathered
149
+ // by syncActors before Scene.onBeforeRender, so refresh on a changed cap
150
+ // (including a newly built/replaced node), never every unchanged frame.
151
+ q.culledNodes = nodes;
152
+ q.refreshInstances?.(scene);
153
+ }
154
+ }
155
+
156
+ export function talkActors(scene) {
157
+ const q = qualityFor(scene);
158
+ if (!lowQuality(scene)) {return scene.getActors();}
159
+ if (q.npcData !== scene.data || q.npcMap !== scene.actors || q.npcCount !== scene.actors?.size) {
160
+ q.npcData = scene.data; q.npcMap = scene.actors; q.npcCount = scene.actors?.size;
161
+ q.npcs = allActors(scene).filter((actor) => actor.components?.HubNpc);
162
+ }
163
+ return q.npcs.map((actor) => scene.getActor(actor.id)).filter(Boolean);
164
+ }
165
+
166
+ // Apply after the existing label rule, so its three slots and 12/14 m edge
167
+ // still win. Pointers never enter this list. Party labels consume no slots.
168
+ export function capLabels(items, most, distanceOf, exempt = () => false) {
169
+ const keep = new Set(items.filter((item) => item.kind === 'pointer' || exempt(item)).map((item) => item.id));
170
+ const ranked = items.filter((item) => !keep.has(item.id)).sort((a, b) => distanceOf(a) - distanceOf(b) || String(a.id).localeCompare(String(b.id)));
171
+ for (const item of ranked.slice(0, most)) {keep.add(item.id);}
172
+ return items.filter((item) => keep.has(item.id));
173
+ }
174
+
175
+ // Rendering ids can change with label style; actorId always names the world
176
+ // anchor. Captions admitted by the existing near-label rule consume no slots.
177
+ export function capWorldLabels(items, placed, local, most, party) {
178
+ const anchors = new Map(placed.map(({ id, at }) => [id, at]));
179
+ const actorId = (item) => item.actorId ?? item.id;
180
+ return capLabels(items, most, (item) => distance(local, anchors.get(actorId(item))),
181
+ (item) => item.qualityNear === true || party.has(actorId(item)));
182
+ }
183
+
184
+ export function qualitySpawnIds(want, templates, here, most) {
185
+ const decor = Object.entries(want).filter(([, copy]) => templates[copy.from]?.decor === true)
186
+ .sort((a, b) => distance(here, a[1]) - distance(here, b[1]) || a[0].localeCompare(b[0]));
187
+ return new Set([...Object.entries(want).filter(([, copy]) => templates[copy.from]?.decor !== true).map(([id]) => id),
188
+ ...decor.slice(0, most).map(([id]) => id)]);
189
+ }
190
+
191
+ // Only the far NPC's prompt descriptor work is throttled; event draining,
192
+ // panel work and nearby/conversing NPCs always run in the current frame.
193
+ export function mindDue(scene, actor, local, talking, now) {
194
+ const low = lowQuality(scene);
195
+ if (!low) {return true;}
196
+ const props = actor.components?.HubNpc;
197
+ const at = actor.components?.Transform;
198
+ const d = distance(local, at);
199
+ const edge = deck.lowActorDistance && Number.isFinite(actor.lowDrawDistance) && actor.lowDrawDistance > 0 ? actor.lowDrawDistance : 20;
200
+ if (actor.id === talking || d <= edge || d <= (props?.talkRange ?? 3.5)) {return true;}
201
+ const q = qualityFor(scene);
202
+ if (now < (q.nextMind.get(actor.id) ?? -Infinity)) {return false;}
203
+ q.nextMind.set(actor.id, now + 1000 / low.farMindsHz);
204
+ return true;
205
+ }
@@ -0,0 +1,55 @@
1
+ // Both hub entries evaluate this after the engine modules, before mounting a
2
+ // player. A system installer is too late: the constructor already called load.
3
+ import { isEdit } from 'castle-web-sdk';
4
+ import { SceneRuntime } from '@imports/castle.physics-2d/engine/scene';
5
+ import { getBlueprintTemplate, mergeComponents } from '@imports/castle.physics-2d/engine/blueprint';
6
+ import { drawInstances } from '@imports/castle.physics-3d/engine3d/optimize';
7
+ import { syncActors } from '@imports/castle.physics-3d/engine3d/world3d';
8
+ import { deck } from './state.js';
9
+ import { makeTiers } from './tiers.js';
10
+ import { readQuality } from '../shared/quality.js';
11
+ import { filterQualityScene, makeQualityVisit, qualityFor, resetQualityVisit } from './quality.js';
12
+
13
+ const config = Object.values(import.meta.glob('/castle.json', { eager: true, import: 'default' }))[0] ?? {};
14
+
15
+ // Before the player's renderer exists, a short-lived context gives exactly the
16
+ // same GPU string. Release it immediately so it consumes no persistent context.
17
+ function pickBeforeBuild(tiers, renderer) {
18
+ if (renderer) {return tiers.pick(renderer);}
19
+ let gl;
20
+ try {
21
+ const canvas = globalThis.document?.createElement?.('canvas');
22
+ gl = canvas?.getContext?.('webgl2') ?? canvas?.getContext?.('webgl');
23
+ return tiers.pick({ getContext: () => gl });
24
+ } catch { return tiers.pick(null); }
25
+ finally { try { gl?.getExtension?.('WEBGL_lose_context')?.loseContext(); } catch { /* Optional hint context. */ } }
26
+ }
27
+
28
+ export function installQualityLoad(Runtime, { make = makeTiers, componentsOf, protectedIds = new Set(), pick = pickBeforeBuild, build = (scene) => syncActors(scene.three, scene, scene.sprites, 0) } = {}) {
29
+ if (!deck.quality && !deck.highOnly) {return () => {};}
30
+ const original = Runtime.prototype.load;
31
+ Runtime.prototype.load = function (data) {
32
+ if (!deck.quality && !deck.highOnly) {return original.call(this, data);}
33
+ if (this.content) {
34
+ const q = qualityFor(this);
35
+ if (q) {resetQualityVisit(q);}
36
+ return original.call(this, data);
37
+ }
38
+ const q = qualityFor(this) ?? makeQualityVisit(make({ weakest: deck.weakestTier === true }));
39
+ pick(q.tiers, this.three?.renderer);
40
+ q.build = build;
41
+ q.refreshInstances = (scene) => {
42
+ for (const instances of scene.three?.instances?.values() ?? []) {drawInstances(instances, scene.three.camera);}
43
+ };
44
+ const resolve = componentsOf ? (actor) => componentsOf(this, actor) : (actor) => mergeComponents(
45
+ actor.blueprint ? getBlueprintTemplate(this.files, actor.blueprint, this.scenePath)?.components : null, actor.components);
46
+ return original.call(this, filterQualityScene(this, data, q, resolve, protectedIds));
47
+ };
48
+ return () => { Runtime.prototype.load = original; };
49
+ }
50
+
51
+ if ((config.hub?.quality !== undefined || config.hub?.highOnly === true) && config.hub?.tiers === true && !isEdit()) {
52
+ if (config.hub.quality !== undefined) {deck.quality = readQuality(config.hub.quality, true, []);}
53
+ if (config.hub.highOnly === true) {deck.highOnly = true;}
54
+ installQualityLoad(SceneRuntime);
55
+ }
@@ -0,0 +1,167 @@
1
+ // Whether this client's connection came back to a session that let it go.
2
+ //
3
+ // A phone app switch drops the socket long enough for the platform to report a
4
+ // leave: the real-time server removes the body and the place forgets the
5
+ // player. The SDK then resumes the connection, usually on the same net object
6
+ // this client already greeted, so `sayHello` (which greets a new net) would
7
+ // never greet again and the player would stay a ghost: no HUD, no doors.
8
+ //
9
+ // The signal is the session's own: the real-time server sends a WORLD
10
+ // snapshot to a connection each time it gives it a body (`admit` in the
11
+ // real-time kit's session.js), and only then (or, on a deck that filters, to a
12
+ // client that came back to a body it still had). A second WORLD on a net this
13
+ // client already greeted is a re-admission. It is read off the transport's
14
+ // queue, so it holds while the page was hidden and its frames stopped: the
15
+ // snapshot waits in the queue and is seen on the first frame back. Every
16
+ // version of a place's server sends it, so a re-saved town fixes every place.
17
+ //
18
+ // The same connection under a new player id (the SDK re-acquired a session)
19
+ // is a re-admission too, and is reported by `selfId`. It is also another
20
+ // session: what the old one sent this player alone (HUD, tune, decor, a card)
21
+ // is not the new one's. The watch's `onIdentity` runs once at that boundary,
22
+ // before the new session's packets are applied: from the drain that would hand
23
+ // them over, or from `resumed` if this client sees the id first.
24
+
25
+ // The real-time kit's WORLD kind (`code/client/messages.js` there).
26
+ const WORLD = 'w';
27
+
28
+ const watches = new WeakMap();
29
+
30
+ // The player id each deck message arrived under, set the moment it arrives
31
+ // (`tag`, from the hook layer's `arrive`, which runs with or without frames).
32
+ // A message queued under an id the connection no longer has belongs to the
33
+ // session it left: the drain drops it, so an old HUD, tune or card queued
34
+ // while the page was hidden does not come back after the identity reset. One
35
+ // that arrived before the client had a net is untagged and kept, as are
36
+ // snapshots (WORLD/STATE), which never pass `arrive`; the new session's WORLD
37
+ // replaces the shared state whole.
38
+ const tags = new WeakMap();
39
+
40
+ export function tag(msg, net) {
41
+ const id = net ? selfIdOf(net) : null;
42
+ if (id && msg && typeof msg === 'object') {
43
+ tags.set(msg, id);
44
+ }
45
+ }
46
+
47
+ // The watch over one net: how many re-admitting snapshots it has drained. The
48
+ // first snapshot is the join's own; when the multiplayer kit has already
49
+ // drained it (it says `joined`), every later one counts.
50
+ export function watch(mp, net, onIdentity = null) {
51
+ let w = watches.get(net);
52
+ if (w) {
53
+ w.onIdentity = onIdentity ?? w.onIdentity;
54
+ return w;
55
+ }
56
+ w = { seen: mp?.joined === true, again: 0, selfId: selfIdOf(net), onIdentity };
57
+ watches.set(net, w);
58
+ const drain = net.drain;
59
+ if (typeof drain === 'function') {
60
+ net.drain = (...args) => {
61
+ let messages = drain.apply(net, args);
62
+ identity(net, w);
63
+ const id = selfIdOf(net);
64
+ if (id && Array.isArray(messages)) {
65
+ messages = messages.filter((msg) => {
66
+ const at = tags.get(msg);
67
+ return at === undefined || at === id;
68
+ });
69
+ }
70
+ for (const msg of messages ?? []) {
71
+ if (msg?.k === WORLD) {
72
+ if (w.seen) {
73
+ w.again += 1;
74
+ } else {
75
+ w.seen = true;
76
+ }
77
+ }
78
+ }
79
+ return messages;
80
+ };
81
+ }
82
+ return w;
83
+ }
84
+
85
+ // A mark of where a connection stands when a hello goes out: a later
86
+ // `resumed` against it says whether the session has let this client go and
87
+ // taken it back since.
88
+ export function mark(mp, net, onIdentity = null) {
89
+ const w = watch(mp, net, onIdentity);
90
+ identity(net, w);
91
+ return { again: w.again, selfId: selfIdOf(net) };
92
+ }
93
+
94
+ // The identity boundary: a net whose player id changed since the watch last
95
+ // looked runs `onIdentity` once.
96
+ function identity(net, w) {
97
+ const id = selfIdOf(net);
98
+ if (!id || id === w.selfId) {
99
+ return;
100
+ }
101
+ const was = w.selfId;
102
+ w.selfId = id;
103
+ if (was) {
104
+ try {
105
+ w.onIdentity?.();
106
+ } catch (err) {
107
+ console.warn(`[hub] resetting for a new session failed: ${err?.message ?? err}`);
108
+ }
109
+ }
110
+ }
111
+
112
+ // 'self' when the connection now has another player id (another session, or a
113
+ // session that started this player afresh), 'world' when the session sent this
114
+ // connection the world again, else null.
115
+ export function resumed(mp, net, at) {
116
+ if (!at) {
117
+ return null;
118
+ }
119
+ const w = watch(mp, net);
120
+ identity(net, w);
121
+ const id = selfIdOf(net);
122
+ if (id && at.selfId && id !== at.selfId) {
123
+ return 'self';
124
+ }
125
+ return w.again !== at.again ? 'world' : null;
126
+ }
127
+
128
+ // Which hello a connection that came back (`resumed`'s answer) says:
129
+ // 'none' nothing came back, or a game (a place with `result`) back under
130
+ // the same player id that did not opt in to `resume`: its round
131
+ // and result belong to the visit that left, so the place keeps it
132
+ // as it was (no re-arrival);
133
+ // 'fresh' a game back under a NEW player id: a session that has never
134
+ // arrived this player, so an ordinary first hello (a party of one,
135
+ // nothing carried), or the player stays a ghost for the visit;
136
+ // 'resume' any other place, or a game whose place says `resume: true`
137
+ // (v1.72) back under the same id: the resume hello, which
138
+ // re-arrives a player the place let go and is idempotent for one
139
+ // it still has.
140
+ export function helloAfter(back, isGame, resumes = false) {
141
+ if (!back) {
142
+ return 'none';
143
+ }
144
+ if (isGame) {
145
+ if (back === 'self') {
146
+ return 'fresh';
147
+ }
148
+ return resumes === true ? 'resume' : 'none';
149
+ }
150
+ return 'resume';
151
+ }
152
+
153
+ // Whether a `hub-end` starts this client's end. One a resume place says again
154
+ // (v1.72, `again: true`, to a client a drop may have kept it from) is taken
155
+ // only by a client not already ending in that session, so a repeat never
156
+ // restarts its pause; every other end is taken, as it always was.
157
+ export function takesEnd(msg, pendingEnd, endSession, session) {
158
+ return !(msg?.again === true && pendingEnd !== null && endSession === session);
159
+ }
160
+
161
+ function selfIdOf(net) {
162
+ try {
163
+ return net.selfId?.() || null;
164
+ } catch {
165
+ return null;
166
+ }
167
+ }