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
@@ -18,7 +18,18 @@
18
18
  // A deck may mark an actor in its scene file `"tier": "keep"` (beside `id`,
19
19
  // not a component): it is drawn on every tier, whatever it would be called
20
20
  // here -- a place's ground is often plain Transform/Shape/Model, and a place
21
- // drawn without it stands on nothing.
21
+ // drawn without it stands on nothing. `"tier": "near"` instead treats a non-NPC
22
+ // actor as scenery on Low, whatever its components: drawn within 30 m of its
23
+ // bounds, taken out beyond that. High draws it as authored; NPCs keep their
24
+ // own distance rule, and keep always wins over distance. `"tier": "low"`
25
+ // draws only on Low, at any distance; High takes its node out instead.
26
+ // Both tiers draw the kit sky when the scene declares `engine.sky`.
27
+ // A scene file may also carry visibility cells (`readCells` below): on Low an
28
+ // actor tagged with cells the camera's cell cannot see is not drawn, `keep`
29
+ // or not -- keep is about distance, a cell about what is in the way.
30
+ // Actors the place hides for this viewer are also taken out on Low, whatever
31
+ // their mark or components, except Player/avatar roots. High keeps the
32
+ // existing underground visibility path alone.
22
33
  //
23
34
  // Where a device starts: low if it was found slow here in the last week
24
35
  // (remembered in localStorage), or its GPU or memory says it is a weak phone;
@@ -27,6 +38,8 @@
27
38
  // over all of it.
28
39
 
29
40
  import { Box3, Sphere } from 'three';
41
+ import { classify } from '../shared/quality.js';
42
+ import { hub, deck } from './state.js';
30
43
 
31
44
  export const TIERS = ['low', 'high'];
32
45
  export const MODES = ['auto', 'low', 'high'];
@@ -63,6 +76,19 @@ const WEAK_GPUS = [
63
76
  /Adreno\D*(?:[34]\d\d|50\d)\b/i,
64
77
  ];
65
78
 
79
+ export function weakestGpu(renderer) {
80
+ // Moto's native WebView names the GE8320 driver Doma. Match that exact
81
+ // alias, not the unrelated numbered SGX family or other Doma variants.
82
+ return typeof renderer === 'string' && (
83
+ /PowerVR(?: Rogue)? GE8\d{2,3}\b/i.test(renderer) ||
84
+ /\bPowerVR SGX (?:Doma|\(Doma\))(?=\s*(?:[,)]|$))/i.test(renderer)
85
+ );
86
+ }
87
+
88
+ export function middleGpu(renderer) {
89
+ return typeof renderer === 'string' && /Mali-G52 MC[12]\b/i.test(renderer);
90
+ }
91
+
66
92
  export function weakGpu(renderer) {
67
93
  return typeof renderer === 'string' && WEAK_GPUS.some((re) => re.test(renderer));
68
94
  }
@@ -99,9 +125,9 @@ export function writeJson(storage, key, value) {
99
125
  }
100
126
  }
101
127
 
102
- export function readMode(storage) {
128
+ export function readMode(storage, weakest = false) {
103
129
  const mode = readJson(storage, MODE_KEY);
104
- return MODES.includes(mode) ? mode : 'auto';
130
+ return MODES.includes(mode) || (weakest && mode === 'weakest') ? mode : 'auto';
105
131
  }
106
132
 
107
133
  // Where a device starts: found slow here within the week, then its hints.
@@ -169,31 +195,166 @@ export function makeJudge() {
169
195
  // (scenery: those plus Solid or Lookable, or a Shape with `solid`) or 'game'
170
196
  // (anything else, never
171
197
  // touched: doors, pads, players, balls, the town's own pieces).
172
- const GAMEPLAY = /^Hub|^Town|^Body$|^Ball$|^Player$/;
173
- const DECOR = new Set(['Transform', 'Shape', 'Model']);
174
- const SCENERY = new Set(['Transform', 'Shape', 'Model', 'Solid', 'Lookable']);
198
+ export { classify } from '../shared/quality.js';
175
199
 
176
200
  // The mark a scene file puts on an actor (`"tier": "keep"`, a field of the
177
201
  // actor beside `id`) to have it drawn on every tier whatever `classify` says
178
- // of it. Any other value is no mark.
202
+ // of it. `"tier": "near"` makes a non-NPC actor scenery on Low (the sized
203
+ // 30 m test), whatever its components. `"tier": "low"` is drawn only on Low,
204
+ // exempt from distance/decor there. Other values are no mark.
179
205
  export const KEEP = 'keep';
206
+ export const NEAR = 'near';
207
+ export const LOW = 'low';
208
+ // High-only decor remains ordinary decor in the Low pass below, never kept
209
+ // or near scenery and never a protected actor for visibility cells.
210
+ export const HIGH = 'high';
211
+
212
+ // Visibility cells: a scene file may cut its ground into cells and say, for
213
+ // each, which cells can be seen from somewhere in it (a top-level `cells`
214
+ // key beside `engine` and `actors`; experiments/hub-town town_cells.py
215
+ // writes the 4x world's), and tag still actors with the cell their footprint
216
+ // is in (`"cell": "n-plaza"`, or a list when it spans several, beside `id`
217
+ // like `tier`). On Low an actor none of whose cells is seen from the
218
+ // camera's cell is taken out, wherever it is and whatever else is said of it:
219
+ // it is behind buildings, so the distance rules and `keep` do not apply. The
220
+ // table is read strictly: anything off and there is no table, and the scene
221
+ // is drawn as it would be without one.
222
+ export const CELLS_VERSION = 1;
223
+ // Which tagged actors the cells may take out, by an invariant: an actor is
224
+ // out for its cell only if (i) none of its components reacts to a player or
225
+ // the server (an interaction, a pad, a door, a seat, a wardrobe, a shop, a
226
+ // label writer, a mover, a body), (ii) nothing moves it, and (iii) that is
227
+ // decided again from its components every time it is needed, never
228
+ // remembered by id: the engine may replace an actor under the same id (a
229
+ // Body, a HubDoor) and the scene may add a component while playing.
230
+ // So: every component of the actor as it is now is one of CELL_INERT --
231
+ // a Lookable's words are read from the scene data by the client whether or
232
+ // not the node is drawn, and RouteAnchor and WalkSurface are data -- and
233
+ // none is CELL_PROTECTED, a backstop for what a player must see to find their
234
+ // way or play. An actor with no components, or none to be found, is drawn.
235
+ // Taking a node out stops its drawing and nothing else.
236
+ export const CELL_INERT = new Set(['Transform', 'Shape', 'Model', 'Solid', 'Lookable', 'RouteAnchor', 'WalkSurface']);
237
+ export const CELL_PROTECTED = new Set([
238
+ 'HubDoor',
239
+ 'HubPad',
240
+ 'HubNpc',
241
+ 'Body',
242
+ 'Player',
243
+ 'Ball',
244
+ 'HubSpin',
245
+ 'TownHats',
246
+ 'TownStamp',
247
+ 'TownHatMat',
248
+ 'TownWardrobeMat',
249
+ 'TownWardrobeItem',
250
+ 'TownWardrobe',
251
+ ]);
252
+
253
+ // Whether an actor's current components let the cells take it out.
254
+ export function cellInert(components) {
255
+ const names = components && typeof components === 'object' ? Object.keys(components) : [];
256
+ return names.length > 0 && names.every((name) => CELL_INERT.has(name) && !CELL_PROTECTED.has(name));
257
+ }
258
+
259
+ const finitePair = (p) => Array.isArray(p) && p.length === 2 && Number.isFinite(p[0]) && Number.isFinite(p[1]);
260
+
261
+ // The scene file's `cells` key as { eyeMax, hysteresis, cells: [{ id,
262
+ // outline, sees: Set }], byId }, or null when it is absent or malformed.
263
+ export function readCells(value) {
264
+ if (!value || typeof value !== 'object' || value.version !== CELLS_VERSION || !Array.isArray(value.cells) || !value.cells.length) {
265
+ return null;
266
+ }
267
+ if (!Number.isFinite(value.eyeMax) || !Number.isFinite(value.hysteresis) || value.hysteresis < 0) {
268
+ return null;
269
+ }
270
+ const byId = new Map();
271
+ for (const c of value.cells) {
272
+ if (!c || typeof c.id !== 'string' || !c.id || byId.has(c.id)) {
273
+ return null;
274
+ }
275
+ if (!Array.isArray(c.outline) || c.outline.length < 3 || !c.outline.every(finitePair) || !Array.isArray(c.sees)) {
276
+ return null;
277
+ }
278
+ byId.set(c.id, { id: c.id, outline: c.outline.map(([x, z]) => [x, z]), sees: c.sees });
279
+ }
280
+ for (const c of byId.values()) {
281
+ // A row that does not see itself is a mistake in the table, not a cell
282
+ // whose own ground is hidden: no table.
283
+ if (!c.sees.includes(c.id) || !c.sees.every((id) => typeof id === 'string' && byId.has(id))) {
284
+ return null;
285
+ }
286
+ c.sees = new Set(c.sees);
287
+ }
288
+ return { eyeMax: value.eyeMax, hysteresis: value.hysteresis, cells: [...byId.values()], byId };
289
+ }
290
+
291
+ // An actor's `cell` field as a list of the table's ids, or null: a string or
292
+ // a non-empty list of strings, every one a cell of the table. Anything else
293
+ // is no cell, and the actor is never taken out for it.
294
+ export function actorCells(value, table) {
295
+ const list = typeof value === 'string' ? [value] : value;
296
+ if (!table || !Array.isArray(list) || !list.length) {
297
+ return null;
298
+ }
299
+ return list.every((id) => typeof id === 'string' && table.byId.has(id)) ? list : null;
300
+ }
301
+
302
+ export function insideOutline(outline, x, z) {
303
+ let inside = false;
304
+ for (let i = 0, j = outline.length - 1; i < outline.length; j = i++) {
305
+ const [xi, zi] = outline[i];
306
+ const [xj, zj] = outline[j];
307
+ if (zi > z !== zj > z && x < ((xj - xi) * (z - zi)) / (zj - zi) + xi) {
308
+ inside = !inside;
309
+ }
310
+ }
311
+ return inside;
312
+ }
180
313
 
181
- export function classify(components) {
182
- const names = Object.keys(components ?? {});
183
- // physics-3d makes an actor's collider block when it has `Solid` or its
184
- // Shape says `solid` (physics3d.js `isSolid`); either way it is scenery that
185
- // stops a player, never decor.
186
- const solid = names.includes('Solid') || Boolean(components?.Shape?.solid);
187
- if (names.includes('HubNpc')) {
188
- return 'npc';
314
+ // How far a point is from an outline's nearest edge.
315
+ export function outlineDistance(outline, x, z) {
316
+ let best = Infinity;
317
+ for (let i = 0, j = outline.length - 1; i < outline.length; j = i++) {
318
+ const [ax, az] = outline[j];
319
+ const [bx, bz] = outline[i];
320
+ const dx = bx - ax;
321
+ const dz = bz - az;
322
+ const len = dx * dx + dz * dz;
323
+ const t = len > 0 ? Math.max(0, Math.min(1, ((x - ax) * dx + (z - az) * dz) / len)) : 0;
324
+ best = Math.min(best, Math.hypot(ax + t * dx - x, az + t * dz - z));
189
325
  }
190
- if (names.some((name) => GAMEPLAY.test(name))) {
191
- return 'game';
326
+ return best;
327
+ }
328
+
329
+ // The cell the eye at (x, z) is in, given the one it was in. Outside every
330
+ // outline, and at no finite place, there is no cell (null), first and
331
+ // whatever the hysteresis: the cells hide nothing rather than keep hiding
332
+ // what a cell the eye has left could not see. Inside some outline, the cell
333
+ // it was in is kept while the eye is inside it or within the table's
334
+ // hysteresis of it, so a border walked along does not flicker; otherwise the
335
+ // cell whose outline holds the eye.
336
+ export function eyeCell(table, current, x, z) {
337
+ if (!Number.isFinite(x) || !Number.isFinite(z)) {
338
+ return null;
192
339
  }
193
- if (!solid && names.every((name) => DECOR.has(name))) {
194
- return 'decor';
340
+ const was = current === null ? null : table.byId.get(current);
341
+ // The cell it was in first: inside it is the common case, one outline.
342
+ if (was && insideOutline(was.outline, x, z)) {
343
+ return current;
344
+ }
345
+ const holder = table.cells.find((c) => c !== was && insideOutline(c.outline, x, z));
346
+ if (!holder) {
347
+ return null;
348
+ }
349
+ return was && outlineDistance(was.outline, x, z) <= table.hysteresis ? current : holder.id;
350
+ }
351
+
352
+ function cellsDebugUrl() {
353
+ try {
354
+ return new URLSearchParams(globalThis.location?.search ?? '').get('hubcells') === '1';
355
+ } catch {
356
+ return false;
195
357
  }
196
- return names.every((name) => SCENERY.has(name)) ? 'static' : 'game';
197
358
  }
198
359
 
199
360
  // A node's bounds once, as its middle's offset from the node's position and a
@@ -214,7 +375,7 @@ function nodeBounds(node) {
214
375
  // replaces nodes (a scene load, a door trip and the way back, the town's nodes
215
376
  // parked and put back: world3d.js `swapSceneNodes` adds a parked node back to
216
377
  // the scene); `restore` puts back exactly what it changed.
217
- export function makeLevers({ boundsOf = nodeBounds } = {}) {
378
+ export function makeLevers({ boundsOf = nodeBounds, onLayout } = {}) {
218
379
  const lv = {
219
380
  world: null,
220
381
  active: false,
@@ -222,16 +383,39 @@ export function makeLevers({ boundsOf = nodeBounds } = {}) {
222
383
  lights: new Set(),
223
384
  // node -> the parent it was taken out of.
224
385
  removed: new WeakMap(),
386
+ // Shared model instances draw outside the actor graph: hide their
387
+ // detached Low-only root too, preserving its authored visibility.
388
+ visibility: new WeakMap(),
225
389
  hidden: 0,
226
390
  bounds: new WeakMap(),
227
391
  // The authored actors of the scene playing: only these are ever hidden
228
- // (never a player's avatar, what they wear, or what the place spawned).
392
+ // for scenery/cells (never a player's avatar or what they wear). The
393
+ // place's merged hidden set also takes out spawned non-player actors.
229
394
  authored: null,
395
+ distances: null,
230
396
  authoredFor: null,
231
- // Of those, the ids the scene file marks `"tier": "keep"`: never hidden.
397
+ // Of those, the ids marked `"tier": "keep"`: exempt from distance/decor.
232
398
  // null when the file marks none.
233
399
  kept: null,
400
+ // The ids marked `"tier": "near"`: scenery on Low, except NPCs.
401
+ near: null,
402
+ // The ids drawn only on Low, exempt from distance/decor there.
403
+ low: null,
234
404
  seen: { path: undefined, nodes: null, size: -1 },
405
+ // The scene file's visibility cells (`readCells`) and, by actor id, the
406
+ // cells each authored actor is tagged with; null when the file has none.
407
+ cells: null,
408
+ actorCells: null,
409
+ // The rule on or off (the harness's A/B), the eye's cell (hysteresis
410
+ // keeps it), the cell the last look drew from (null: everything), how
411
+ // many nodes are out for cells alone, and the last change of cell.
412
+ cellsOn: true,
413
+ cell: null,
414
+ cellKey: null,
415
+ cellHidden: 0,
416
+ pop: null,
417
+ overlay: null,
418
+ debugUrl: undefined,
235
419
  // The entries taken out on the last look, [actor id, entry]: the engine
236
420
  // replaces an entry in the same map when an actor's look changes
237
421
  // (world3d.js `ensureActorNode`), and the new node is drawn, so these are
@@ -240,15 +424,30 @@ export function makeLevers({ boundsOf = nodeBounds } = {}) {
240
424
  nextAt: 0,
241
425
  };
242
426
 
427
+ const sleeping = new Set();
428
+ const wakeSleeping = () => {
429
+ for (const actor of sleeping) {delete actor.runtime.renderSleep;}
430
+ sleeping.clear();
431
+ };
243
432
  const adopt = (world) => {
244
433
  if (lv.world !== world) {
434
+ wakeSleeping();
245
435
  // A new world: nothing changed on the old one is put back there.
246
436
  lv.world = world;
247
437
  lv.lights = new Set();
248
438
  lv.removed = new WeakMap();
439
+ lv.visibility = new WeakMap();
249
440
  lv.authored = null;
250
441
  lv.authoredFor = null;
251
442
  lv.kept = null;
443
+ lv.near = null;
444
+ lv.low = null;
445
+ lv.cells = null;
446
+ lv.actorCells = null;
447
+ lv.cell = null;
448
+ lv.cellKey = null;
449
+ lv.cellHidden = 0;
450
+ lv.pop = null;
252
451
  lv.seen = { path: undefined, nodes: null, size: -1 };
253
452
  lv.watch = [];
254
453
  lv.nextAt = 0;
@@ -271,28 +470,66 @@ export function makeLevers({ boundsOf = nodeBounds } = {}) {
271
470
  if (lv.authoredFor === scene.data && lv.authored) {
272
471
  return lv.authored;
273
472
  }
473
+ wakeSleeping();
274
474
  lv.authoredFor = scene.data;
275
475
  const ids = new Set();
276
476
  let kept = null;
477
+ let near = null;
478
+ let low = null;
479
+ let cells = null;
480
+ let tagged = null;
481
+ const distances = new Map();
277
482
  try {
278
483
  const file = scene.readFromFile(scene.scenePath);
484
+ cells = file?.cells === undefined ? null : readCells(file.cells);
279
485
  for (const a of file?.actors ?? []) {
280
486
  ids.add(a.id);
487
+ if (Number.isFinite(a.lowDrawDistance) && a.lowDrawDistance > 0) {
488
+ distances.set(a.id, a.lowDrawDistance);
489
+ }
281
490
  if (a.tier === KEEP) {
282
491
  (kept ??= new Set()).add(a.id);
492
+ } else if (a.tier === NEAR) {
493
+ (near ??= new Set()).add(a.id);
494
+ } else if (a.tier === LOW) {
495
+ (low ??= new Set()).add(a.id);
496
+ }
497
+ const list = cells && actorCells(a.cell, cells);
498
+ if (list) {
499
+ (tagged ??= new Map()).set(a.id, list);
283
500
  }
284
501
  }
285
502
  } catch {
286
503
  // A scene that cannot be read has no authored actors: nothing is hidden.
287
504
  ids.clear();
505
+ distances.clear();
288
506
  kept = null;
507
+ near = null;
508
+ low = null;
509
+ cells = null;
510
+ tagged = null;
289
511
  }
290
512
  lv.authored = ids;
513
+ lv.distances = distances;
291
514
  lv.kept = kept;
515
+ lv.near = near;
516
+ lv.low = low;
517
+ if (lv.cells !== cells) {
518
+ // Another table: the eye's cell is found again in it.
519
+ lv.cell = null;
520
+ }
521
+ lv.cells = cells;
522
+ lv.actorCells = tagged;
292
523
  return lv.authored;
293
524
  };
294
525
 
295
- const hide = (node) => {
526
+ const hide = (node, instanced = false) => {
527
+ if (instanced) {
528
+ if (!lv.visibility.has(node)) {
529
+ lv.visibility.set(node, node.visible);
530
+ }
531
+ node.visible = false;
532
+ }
296
533
  if (node.parent) {
297
534
  lv.removed.set(node, node.parent);
298
535
  node.parent.remove(node);
@@ -300,6 +537,10 @@ export function makeLevers({ boundsOf = nodeBounds } = {}) {
300
537
  };
301
538
 
302
539
  const unhide = (node) => {
540
+ if (lv.visibility.has(node)) {
541
+ node.visible = lv.visibility.get(node);
542
+ lv.visibility.delete(node);
543
+ }
303
544
  const parent = lv.removed.get(node);
304
545
  if (parent && !node.parent) {
305
546
  parent.add(node);
@@ -307,8 +548,24 @@ export function makeLevers({ boundsOf = nodeBounds } = {}) {
307
548
  lv.removed.delete(node);
308
549
  };
309
550
 
310
- const far = (node, near, cam, sized) => {
311
- const p = node.position;
551
+ // Deferred model fills preserve node identity, so bounds cached for an
552
+ // empty rig must be forgotten. Classification itself is read every pass.
553
+ // Only subscribe in an engine.load world; keyless worlds stay untouched.
554
+ let modelFillScene = null;
555
+ const modelFilled = ({ node }) => {
556
+ lv.bounds.delete(node);
557
+ lv.nextAt = 0;
558
+ };
559
+ const watchModelFills = (world) => {
560
+ const scene = world?.modelLoad ? world.scene : null;
561
+ if (scene === modelFillScene) {return;}
562
+ modelFillScene?.removeEventListener('modelfilled', modelFilled);
563
+ modelFillScene = scene;
564
+ modelFillScene?.addEventListener('modelfilled', modelFilled);
565
+ };
566
+
567
+ const far = (node, near, cam, sized, at) => {
568
+ const p = at && [at.x, at.y, at.z].every(Number.isFinite) ? at : node.position;
312
569
  let b = { dx: 0, dy: 0, dz: 0, r: 0 };
313
570
  if (sized) {
314
571
  b = lv.bounds.get(node);
@@ -321,66 +578,261 @@ export function makeLevers({ boundsOf = nodeBounds } = {}) {
321
578
  return d > near;
322
579
  };
323
580
 
581
+ // The cell whose table row decides what is drawn, or null when the cells
582
+ // decide nothing (no table, the rule off, the eye in no cell yet or above
583
+ // the roofs). Moves the eye's cell along as a side effect.
584
+ const eyeKey = (world) => {
585
+ const table = lv.cells;
586
+ const p = world.camera?.position;
587
+ if (!table || !p) {
588
+ return null;
589
+ }
590
+ lv.cell = eyeCell(table, lv.cell, p.x, p.z);
591
+ return lv.cellsOn && Number.isFinite(p.y) && p.y <= table.eyeMax ? lv.cell : null;
592
+ };
593
+
594
+ // An authored actor tagged with cells none of which is seen from `visible`,
595
+ // and inert as it is now (`cellInert`, read on every look that asks).
596
+ const unseen = (id, visible, scene) => {
597
+ const tagged = lv.actorCells?.get(id);
598
+ if (!tagged || tagged.some((c) => visible.has(c))) {
599
+ return false;
600
+ }
601
+ return cellInert(scene.getActor?.(id)?.components);
602
+ };
603
+
604
+ const cellsDebug = () => {
605
+ if (globalThis.__hubCellsDebug === true) {
606
+ return true;
607
+ }
608
+ lv.debugUrl ??= cellsDebugUrl();
609
+ return lv.debugUrl;
610
+ };
611
+
612
+ const dropOverlay = () => {
613
+ try {
614
+ lv.overlay?.remove();
615
+ } catch {
616
+ // A node already gone is as good as removed.
617
+ }
618
+ lv.overlay = null;
619
+ onLayout?.(null);
620
+ };
621
+
622
+ // The tuning overlay (`?hubcells=1`): which cell the eye is in, what is out
623
+ // and why, and what the last change of cell put back and took out.
624
+ const showCells = (world, now) => {
625
+ if (!lv.cells || !cellsDebug()) {
626
+ dropOverlay();
627
+ return;
628
+ }
629
+ try {
630
+ if (!lv.overlay) {
631
+ const el = globalThis.document.createElement('div');
632
+ el.style.cssText = 'position:fixed;top:4px;left:4px;z-index:2147483647;pointer-events:none;font:11px/1.35 monospace;color:#fff;background:rgba(0,0,0,.65);padding:4px 6px;white-space:pre;border-radius:3px';
633
+ globalThis.document.body.appendChild(el);
634
+ lv.overlay = el;
635
+ onLayout?.(el);
636
+ }
637
+ const y = world.camera?.position?.y;
638
+ const pop = lv.pop;
639
+ lv.overlay.textContent = [
640
+ `cell ${lv.cellKey ?? (lv.cell ? `${lv.cell} (all drawn)` : 'none/all')}`,
641
+ `eye y ${Number.isFinite(y) ? y.toFixed(1) : '?'} (all over ${lv.cells.eyeMax})`,
642
+ `out: cells ${lv.cellHidden}, other ${lv.hidden - lv.cellHidden}`,
643
+ pop ? `pop ${pop.from ?? 'all'} -> ${pop.to ?? 'all'}: +${pop.back} back, -${pop.out} out, ${((now - pop.at) / 1000).toFixed(1)}s ago` : 'pop none yet',
644
+ ].join('\n');
645
+ } catch {
646
+ // No document (a worker, a test): no overlay.
647
+ lv.overlay = null;
648
+ }
649
+ };
650
+
324
651
  // One look at every node: what should not be drawn is taken out, what should
325
652
  // be is put back.
326
- const pass = (world, scene, actors) => {
327
- lightsOff(world);
653
+ const pass = (world, scene, actors, now = 0, tier = LOW) => {
654
+ const isLow = tier === LOW;
655
+ wakeSleeping();
656
+ if (isLow) {
657
+ lightsOff(world);
658
+ }
328
659
  const authored = actors ? authoredIds(scene) : null;
329
660
  const cam = world.camera?.position ?? { x: 0, y: 0, z: 0 };
661
+ // The cells seen from the eye's cell, or null: the cell rule is off.
662
+ const key = isLow && actors ? eyeKey(world) : null;
663
+ const visible = key === null ? null : lv.cells.byId.get(key).sees;
664
+ // Remote avatars have no Player component. Their roots carry wearables
665
+ // and shared model rigs; ownmodel handles the local Player's visibility.
666
+ const avatars = new Set(scene.multiplayer?.avatars?.actors?.values() ?? []);
330
667
  const watch = [];
668
+ let cellHidden = 0;
669
+ let back = 0;
670
+ let out = 0;
331
671
  for (const [id, entry] of world.nodes) {
332
672
  const node = entry?.node;
333
- if (!node || entry.instancedRig) {
673
+ if (!node) {
334
674
  continue;
335
675
  }
336
676
  let want = false;
337
- if (authored?.has(id) && !lv.kept?.has(id)) {
338
- const kind = classify(scene.getActor?.(id)?.components);
677
+ const distance = actors && deck.lowActorDistance === true ? lv.distances?.get(id) : undefined;
678
+ const components = scene.getActor?.(id)?.components;
679
+ const placeHidden = hub.hidden.has(id) && !('Player' in (components ?? {})) && !avatars.has(id) && id !== scene.orbitOwnModel;
680
+ // applyVisibility has lifted the Transform already, but syncActors
681
+ // writes the node later, before rendering. Judge a newly shown actor
682
+ // at its lifted pose, not last frame's underground node position.
683
+ const shownAt = lv.removed.has(node) && !hub.hidden.has(id) ? components?.Transform : null;
684
+ // Not seen from the eye's cell: out, whatever the rules below say,
685
+ // `keep` and `near` included.
686
+ const cellOut =
687
+ (!entry.instancedRig || lv.low?.has(id)) && visible !== null && authored?.has(id) && unseen(id, visible, scene);
688
+ if (!isLow) {
689
+ want = actors && lv.low?.has(id);
690
+ } else if (placeHidden || cellOut) {
691
+ want = true;
692
+ } else if (
693
+ !entry.instancedRig &&
694
+ authored?.has(id) &&
695
+ !lv.kept?.has(id) &&
696
+ !lv.low?.has(id)
697
+ ) {
698
+ let kind = classify(components);
699
+ if (kind !== 'npc' && lv.near?.has(id)) {
700
+ kind = 'static';
701
+ }
339
702
  want =
340
703
  kind === 'decor' ||
341
- (kind === 'static' && far(node, SCENERY_NEAR_M, cam, true)) ||
342
- (kind === 'npc' && far(node, NPC_NEAR_M, cam, false));
704
+ (kind === 'static' && far(node, distance ?? SCENERY_NEAR_M, cam, true, shownAt)) ||
705
+ (kind === 'npc' && far(node, distance ?? NPC_NEAR_M, cam, false, shownAt));
706
+ }
707
+ if (isLow && distance && !lv.kept?.has(id) && !lv.low?.has(id) && !avatars.has(id) && !components?.Player) {
708
+ want ||= far(node, distance, cam, !components?.HubNpc, shownAt);
709
+ }
710
+ const actor = scene.getActor?.(id);
711
+ if (actor && distance) {
712
+ if (isLow && want && !entry.instancedRig && !avatars.has(id) && !components?.Player) {
713
+ actor.runtime.renderSleep = true;
714
+ sleeping.add(actor);
715
+ } else {
716
+ delete actor.runtime.renderSleep;
717
+ sleeping.delete(actor);
718
+ }
343
719
  }
344
720
  if (want) {
345
- hide(node);
721
+ if (node.parent) {
722
+ out += 1;
723
+ }
724
+ hide(node, entry.instancedRig && (!isLow || lv.low?.has(id)));
346
725
  if (!node.parent) {
347
726
  watch.push([id, entry]);
727
+ cellHidden += cellOut ? 1 : 0;
348
728
  }
349
729
  } else if (lv.removed.has(node)) {
730
+ back += node.parent ? 0 : 1;
350
731
  unhide(node);
351
732
  }
352
733
  }
353
734
  lv.watch = watch;
354
735
  lv.hidden = watch.length;
736
+ lv.cellHidden = cellHidden;
737
+ if (key !== lv.cellKey) {
738
+ lv.pop = { from: lv.cellKey, to: key, back, out, at: now };
739
+ lv.cellKey = key;
740
+ }
741
+ if (lv.cells || lv.overlay) {
742
+ showCells(world, now);
743
+ }
355
744
  };
356
745
 
357
746
  // Whether a node taken out was replaced (a rebuild) or put back since.
358
747
  const watchBroken = (world) => {
359
748
  for (const [id, entry] of lv.watch) {
360
- if (world.nodes.get(id) !== entry || entry.node.parent) {
749
+ if (world.nodes.get(id) !== entry || entry.node.parent || (lv.visibility.has(entry.node) && entry.node.visible !== false)) {
361
750
  return true;
362
751
  }
363
752
  }
364
753
  return false;
365
754
  };
366
755
 
367
- // Each frame while low. The nodes are looked at every CHECK_EVERY_MS, and at
756
+ // Each frame: Low applies its rules; High hides only low-marked actors.
757
+ // tiers run in the runtime's update, before the player loads a requested
758
+ // scene and builds its nodes: a low-marked node built in a frame is drawn
759
+ // on High for that one frame (a scene load, or the actor's rebuild).
760
+ // The nodes are looked at every CHECK_EVERY_MS, and at
368
761
  // once when the engine swapped or rebuilt them (another scene, nodes parked
369
762
  // or put back, actors come or gone, the scene loaded again: new scene data
370
763
  // may carry other `tier` marks over the same nodes). `actors` false (a game reached through
371
- // a door: another deck's content) puts every node back and keeps only the
372
- // shadow lever.
373
- lv.apply = (world, scene, now, { actors = true } = {}) => {
764
+ // a door: another deck's content) puts scenery back and keeps only the
765
+ // shadow lever and the place's own hidden actors.
766
+ const update = (world, scene, now, { actors = true, tier = LOW } = {}) => {
374
767
  adopt(world);
375
- lv.active = true;
768
+ watchModelFills(world);
769
+ const isLow = tier === LOW;
770
+ lv.active = isLow;
771
+ const loading = Boolean(scene.requestedScene);
772
+ if (!isLow) {
773
+ if (loading) {
774
+ // And the load may reuse a node for the next scene's actor of the
775
+ // same id, marked or not: what High took out goes back in first.
776
+ // Only nodes the world still has: one the engine released since
777
+ // (the actor's rebuild) stays out for good.
778
+ for (const [id, entry] of lv.watch) {
779
+ if (world.nodes.get(id) === entry) {
780
+ unhide(entry.node);
781
+ }
782
+ }
783
+ lv.watch = [];
784
+ lv.seen = { path: undefined, nodes: null, size: -1 };
785
+ return;
786
+ }
787
+ if (actors) {
788
+ authoredIds(scene);
789
+ }
790
+ if ((!actors || !lv.low) && !lv.watch.length) {
791
+ return;
792
+ }
793
+ }
376
794
  const seen = lv.seen;
377
- const changed = world.scenePath !== seen.path || world.nodes !== seen.nodes || world.nodes.size !== seen.size || scene.data !== seen.data || watchBroken(world);
378
- if (!changed && now < lv.nextAt && actors === seen.actors) {
795
+ // mergeHidden replaces the per-viewer set. clear empties it in place on
796
+ // a session switch, so remember its size too. Either runs this frame.
797
+ const changed =
798
+ world.scenePath !== seen.path ||
799
+ world.nodes !== seen.nodes ||
800
+ world.nodes.size !== seen.size ||
801
+ scene.data !== seen.data ||
802
+ hub.hidden !== seen.hidden ||
803
+ hub.hidden.size !== seen.hiddenSize ||
804
+ watchBroken(world) ||
805
+ tier !== seen.tier;
806
+ // The eye's cell every frame (one or two small outlines; null and done
807
+ // in a scene without cells): a new cell is looked at at once, not at the
808
+ // next look, so what it sees is not missing for half a second.
809
+ const crossed = isLow && lv.cells !== null && actors && eyeKey(world) !== lv.cellKey;
810
+ if (!changed && !crossed && now < lv.nextAt && actors === seen.actors) {
379
811
  return;
380
812
  }
381
- lv.seen = { path: world.scenePath, nodes: world.nodes, size: world.nodes.size, data: scene.data, actors };
813
+ lv.seen = {
814
+ path: world.scenePath,
815
+ nodes: world.nodes,
816
+ size: world.nodes.size,
817
+ data: scene.data,
818
+ actors,
819
+ tier,
820
+ hidden: hub.hidden,
821
+ hiddenSize: hub.hidden.size,
822
+ };
382
823
  lv.nextAt = now + CHECK_EVERY_MS;
383
- pass(world, scene, actors);
824
+ pass(world, scene, actors, now, tier);
825
+ return true;
826
+ };
827
+
828
+ lv.apply = (world, scene, now, options) => update(world, scene, now, options);
829
+ lv.high = (world, scene, now, options) => update(world, scene, now, { ...options, tier: 'high' });
830
+
831
+ // The cell rule off or on at runtime (the harness's A/B); the next frame
832
+ // looks at every node again.
833
+ lv.setCells = (on) => {
834
+ lv.cellsOn = Boolean(on);
835
+ lv.nextAt = 0;
384
836
  };
385
837
 
386
838
  // Back to the picture as authored: every node taken out of the scene put
@@ -388,17 +840,25 @@ export function makeLevers({ boundsOf = nodeBounds } = {}) {
388
840
  // left to the engine), every shadow on again.
389
841
  lv.restore = (world) => {
390
842
  adopt(world);
843
+ watchModelFills(null);
844
+ wakeSleeping();
391
845
  for (const entry of world.nodes.values()) {
392
846
  if (entry?.node && lv.removed.has(entry.node)) {
393
847
  unhide(entry.node);
394
848
  }
395
849
  }
396
850
  lv.removed = new WeakMap();
851
+ lv.visibility = new WeakMap();
397
852
  for (const light of lv.lights) {
398
853
  light.castShadow = true;
399
854
  }
400
855
  lv.lights.clear();
401
856
  lv.hidden = 0;
857
+ lv.cellHidden = 0;
858
+ lv.cell = null;
859
+ lv.cellKey = null;
860
+ lv.pop = null;
861
+ dropOverlay();
402
862
  lv.watch = [];
403
863
  lv.active = false;
404
864
  lv.seen = { path: undefined, nodes: null, size: -1 };
@@ -432,20 +892,24 @@ function pageStorage() {
432
892
 
433
893
  // The hub system's tiers: `frame(scene, counts, now)` each frame. `counts` is
434
894
  // whether this frame says how the device draws the place (see `makeJudge`).
435
- export function makeTiers({ storage = pageStorage(), clock = () => Date.now(), deviceMemory = globalThis.navigator?.deviceMemory ?? null, levers = makeLevers() } = {}) {
895
+ export function makeTiers({ storage = pageStorage(), clock = () => Date.now(), deviceMemory = globalThis.navigator?.deviceMemory ?? null, onLayout, levers = makeLevers({ onLayout }), weakest = false } = {}) {
436
896
  const t = {
437
- mode: readMode(storage),
897
+ mode: readMode(storage, weakest),
438
898
  auto: null,
439
899
  judge: makeJudge(),
440
900
  levers,
441
901
  last: null,
902
+ weakestDevice: false,
903
+ middleDevice: false,
442
904
  };
443
905
 
444
- t.current = () => (t.mode === 'auto' ? (t.auto?.tier ?? 'high') : t.mode);
906
+ t.current = () => (t.mode === 'weakest' ? 'low' : t.mode === 'auto' ? (t.auto?.tier ?? 'high') : t.mode);
907
+ t.weakest = () => weakest && t.current() === 'low' && (t.mode === 'weakest' || t.weakestDevice);
908
+ t.middle = () => weakest && t.current() === 'low' && t.middleDevice && !t.weakest();
445
909
  t.reason = () => (t.mode === 'auto' ? (t.auto?.reason ?? 'auto') : 'manual');
446
910
 
447
911
  t.set = (mode) => {
448
- if (!MODES.includes(mode)) {
912
+ if (!MODES.includes(mode) && !(weakest && mode === 'weakest')) {
449
913
  return false;
450
914
  }
451
915
  t.mode = mode;
@@ -455,13 +919,25 @@ export function makeTiers({ storage = pageStorage(), clock = () => Date.now(), d
455
919
  return true;
456
920
  };
457
921
 
922
+ // Also used before load by the quality entry; frame timing still starts on frame one.
923
+ t.pick = (renderer) => {
924
+ // Hints are read once, from the renderer the place is drawn with.
925
+ if (t.auto === null) {
926
+ const gpu = gpuOf(renderer);
927
+ t.weakestDevice = weakest && weakestGpu(gpu);
928
+ t.middleDevice = weakest && middleGpu(gpu);
929
+ t.auto = initialTier({ storage, now: clock(), gpu, deviceMemory });
930
+ if (t.weakestDevice) { t.auto = { tier: 'low', reason: 'gpu' }; }
931
+ }
932
+ return t.current();
933
+ };
934
+
458
935
  t.frame = (scene, counts, now) => {
459
936
  const world = scene.three;
460
937
  if (!world) {
461
938
  return;
462
939
  }
463
- // Hints are read once, from the renderer the place is drawn with.
464
- t.auto ??= initialTier({ storage, now: clock(), gpu: gpuOf(world.renderer), deviceMemory });
940
+ t.pick(world.renderer);
465
941
  const dt = t.last === null ? 0 : now - t.last;
466
942
  t.last = now;
467
943
  if (t.mode === 'auto' && t.auto.tier === 'high') {
@@ -477,11 +953,14 @@ export function makeTiers({ storage = pageStorage(), clock = () => Date.now(), d
477
953
  }
478
954
  if (t.current() === 'low') {
479
955
  levers.apply(world, scene, now, { actors: !scene.content });
480
- } else if (levers.active) {
956
+ } else {
481
957
  // Low to High costs a one-off stall (about 1 s on the phones measured)
482
958
  // as three.js recompiles its shader programs for the shadows coming
483
959
  // back. Acceptable: auto never moves up, only a player's pick does.
484
- levers.restore(world);
960
+ if (levers.active) {
961
+ levers.restore(world);
962
+ }
963
+ levers.high?.(world, scene, now, { actors: !scene.content });
485
964
  }
486
965
  };
487
966
 
@@ -499,7 +978,19 @@ export function makeTiers({ storage = pageStorage(), clock = () => Date.now(), d
499
978
  get hidden() {
500
979
  return levers.hidden;
501
980
  },
981
+ // The visibility cells: the eye's cell, how many nodes are out for cells
982
+ // alone, and the rule off or on for an A/B.
983
+ get cell() {
984
+ return levers.cell ?? null;
985
+ },
986
+ get cellHidden() {
987
+ return levers.cellHidden ?? 0;
988
+ },
989
+ cells: (on) => levers.setCells?.(on),
502
990
  set: (mode) => t.set(mode),
503
991
  };
992
+ // Local diagnostics only until the analytics transport preserves quality.
993
+ if (deck.quality) {Object.defineProperty(t.handle, 'quality', { enumerable: true, get: () => deck.quality?.low.decor });}
994
+ if (weakest) { Object.defineProperty(t.handle, 'profile', { enumerable: true, get: () => t.weakest() ? 'weakest' : t.middle() ? 'middle' : t.current() }); }
504
995
  return t;
505
996
  }