castle-web-cli 0.4.232 → 0.4.233

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 (355) 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/castle-host/host.d.ts +1 -0
  8. package/dist/castle-host/host.js +51 -3
  9. package/dist/castleJson.d.ts +4 -2
  10. package/dist/castleJson.js +2 -0
  11. package/dist/check.d.ts +3 -1
  12. package/dist/check.js +11 -1
  13. package/dist/devSessionStorage.js +47 -1
  14. package/dist/importPinMismatch.d.ts +22 -0
  15. package/dist/importPinMismatch.js +77 -0
  16. package/dist/importRegression.js +3 -15
  17. package/dist/imports.d.ts +10 -3
  18. package/dist/imports.js +88 -20
  19. package/dist/index.js +5 -4
  20. package/dist/init.js +1 -1
  21. package/dist/platformDoc.js +22 -0
  22. package/dist/routerFences.d.ts +5 -0
  23. package/dist/routerFences.js +12 -2
  24. package/dist/save-deck.d.ts +5 -0
  25. package/dist/save-deck.js +37 -4
  26. package/dist/serve.js +3 -0
  27. package/dist/shell/assets/{index-D2tWM896.js → index-BjOxR-lW.js} +4 -4
  28. package/dist/shell/assets/index-MVLfNYd9.css +1 -0
  29. package/dist/shell/index.html +2 -2
  30. package/dist/taskSteer.d.ts +13 -0
  31. package/dist/taskSteer.js +22 -2
  32. package/kits/base/castle.json +1 -1
  33. package/kits/base/package-lock.json +1 -1
  34. package/kits/base/sdk/README.md +79 -2
  35. package/kits/base/sdk/avatar.d.ts +6 -2
  36. package/kits/base/sdk/avatar.js +12 -4
  37. package/kits/base/sdk/castle.d.ts +1 -1
  38. package/kits/base/sdk/commands.d.ts +14 -0
  39. package/kits/base/sdk/hub.d.ts +6 -2
  40. package/kits/base/sdk/hub.js +13 -0
  41. package/kits/base/sdk/multiplayer.js +17 -1
  42. package/kits/base/sdk/save.js +2 -1
  43. package/kits/base/sdk/server/hub.d.ts +87 -0
  44. package/kits/base/sdk/server/hub.js +70 -0
  45. package/kits/base/sdk/server/platformHandle.d.ts +31 -1
  46. package/kits/base/sdk/server/storage.d.ts +13 -0
  47. package/kits/base/sdk/server/storage.js +46 -0
  48. package/kits/base/sdk/server/wrapper.d.ts +36 -5
  49. package/kits/base/sdk/server/wrapper.js +83 -8
  50. package/kits/hub-game/CLAUDE.md +329 -11
  51. package/kits/hub-game/blueprints/avatar-10.scene +28 -0
  52. package/kits/hub-game/blueprints/avatar-11.scene +28 -0
  53. package/kits/hub-game/blueprints/avatar-12.scene +28 -0
  54. package/kits/hub-game/blueprints/avatar-13.scene +28 -0
  55. package/kits/hub-game/blueprints/avatar-14.scene +28 -0
  56. package/kits/hub-game/blueprints/avatar-15.scene +28 -0
  57. package/kits/hub-game/blueprints/avatar-4.scene +28 -0
  58. package/kits/hub-game/blueprints/avatar-5.scene +28 -0
  59. package/kits/hub-game/blueprints/avatar-6.scene +28 -0
  60. package/kits/hub-game/blueprints/avatar-7.scene +28 -0
  61. package/kits/hub-game/blueprints/avatar-8.scene +28 -0
  62. package/kits/hub-game/blueprints/avatar-9.scene +28 -0
  63. package/kits/hub-game/code/client/actorBudget.js +47 -0
  64. package/kits/hub-game/code/client/attention.js +11 -2
  65. package/kits/hub-game/code/client/avatar.js +309 -35
  66. package/kits/hub-game/code/client/avatarCap.js +228 -0
  67. package/kits/hub-game/code/client/avatarColors.js +70 -0
  68. package/kits/hub-game/code/client/avatarFaces.js +21 -0
  69. package/kits/hub-game/code/client/avatarShare.js +251 -0
  70. package/kits/hub-game/code/client/ballot.js +467 -0
  71. package/kits/hub-game/code/client/build.js +22 -0
  72. package/kits/hub-game/code/client/chrome.js +1144 -50
  73. package/kits/hub-game/code/client/companion.js +716 -0
  74. package/kits/hub-game/code/client/companionDress.js +99 -0
  75. package/kits/hub-game/code/client/decor.js +509 -0
  76. package/kits/hub-game/code/client/earned.js +131 -0
  77. package/kits/hub-game/code/client/emoteBubble.js +75 -0
  78. package/kits/hub-game/code/client/grab.js +339 -20
  79. package/kits/hub-game/code/client/hookLayer.js +299 -13
  80. package/kits/hub-game/code/client/idle.js +163 -22
  81. package/kits/hub-game/code/client/interestCap.js +81 -0
  82. package/kits/hub-game/code/client/keys.js +36 -0
  83. package/kits/hub-game/code/client/labelsNear.js +205 -0
  84. package/kits/hub-game/code/client/menuIcons.js +34 -0
  85. package/kits/hub-game/code/client/pack.js +6 -2
  86. package/kits/hub-game/code/client/packFormat.js +3 -3
  87. package/kits/hub-game/code/client/rehello.js +167 -0
  88. package/kits/hub-game/code/client/shot.js +92 -0
  89. package/kits/hub-game/code/client/sound.js +63 -8
  90. package/kits/hub-game/code/client/soundscape.js +1151 -0
  91. package/kits/hub-game/code/client/soundscapeActions.js +99 -0
  92. package/kits/hub-game/code/client/soundscapeAmbience.js +453 -0
  93. package/kits/hub-game/code/client/soundscapeBaked.js +143 -0
  94. package/kits/hub-game/code/client/soundscapeBusker.js +217 -0
  95. package/kits/hub-game/code/client/soundscapeCourt.js +200 -0
  96. package/kits/hub-game/code/client/soundscapeCrowd.js +331 -0
  97. package/kits/hub-game/code/client/soundscapeCues.js +362 -0
  98. package/kits/hub-game/code/client/soundscapeMap.js +181 -0
  99. package/kits/hub-game/code/client/soundscapeMarket.js +176 -0
  100. package/kits/hub-game/code/client/soundscapeMusic.js +126 -0
  101. package/kits/hub-game/code/client/soundscapeMusicEngine.js +460 -0
  102. package/kits/hub-game/code/client/soundscapeSimlish.js +737 -0
  103. package/kits/hub-game/code/client/soundscapeSongs.js +127 -0
  104. package/kits/hub-game/code/client/soundscapeSongsRound3.js +63 -0
  105. package/kits/hub-game/code/client/soundscapeSynthesis.js +168 -0
  106. package/kits/hub-game/code/client/soundscapeUi.js +211 -0
  107. package/kits/hub-game/code/client/soundscapeVoice.js +1209 -0
  108. package/kits/hub-game/code/client/soundscapeWaves.js +206 -0
  109. package/kits/hub-game/code/client/spin.js +101 -0
  110. package/kits/hub-game/code/client/state.js +109 -1
  111. package/kits/hub-game/code/client/stuck.js +259 -0
  112. package/kits/hub-game/code/client/talk.js +538 -47
  113. package/kits/hub-game/code/client/tiers.js +516 -27
  114. package/kits/hub-game/code/client/toastBand.js +37 -0
  115. package/kits/hub-game/code/client/together.js +32 -0
  116. package/kits/hub-game/code/client/visibility.js +43 -0
  117. package/kits/hub-game/code/client/wear.js +461 -170
  118. package/kits/hub-game/code/client/yours.js +199 -0
  119. package/kits/hub-game/code/companionSpec.js +45 -0
  120. package/kits/hub-game/code/privateText.js +7 -0
  121. package/kits/hub-game/code/server/actions.js +133 -0
  122. package/kits/hub-game/code/server/actors.js +9 -1
  123. package/kits/hub-game/code/server/ask.js +155 -0
  124. package/kits/hub-game/code/server/ballot.js +539 -0
  125. package/kits/hub-game/code/server/cells.js +100 -0
  126. package/kits/hub-game/code/server/companion.js +82 -0
  127. package/kits/hub-game/code/server/cues.js +70 -0
  128. package/kits/hub-game/code/server/decor.js +269 -0
  129. package/kits/hub-game/code/server/earned.js +461 -0
  130. package/kits/hub-game/code/server/friendBests.js +166 -0
  131. package/kits/hub-game/code/server/friendsAmong.js +232 -0
  132. package/kits/hub-game/code/server/history.js +5 -0
  133. package/kits/hub-game/code/server/hub.js +1254 -50
  134. package/kits/hub-game/code/server/idle.js +30 -11
  135. package/kits/hub-game/code/server/index.js +2 -2
  136. package/kits/hub-game/code/server/labels.js +28 -2
  137. package/kits/hub-game/code/server/manifest.js +378 -7
  138. package/kits/hub-game/code/server/menu.js +133 -0
  139. package/kits/hub-game/code/server/npcs.js +830 -80
  140. package/kits/hub-game/code/server/party.js +2 -2
  141. package/kits/hub-game/code/server/players.js +22 -0
  142. package/kits/hub-game/code/server/shot.js +110 -0
  143. package/kits/hub-game/code/server/standing.js +124 -0
  144. package/kits/hub-game/code/server/vis.js +113 -0
  145. package/kits/hub-game/code/server/wear.js +12 -0
  146. package/kits/hub-game/code/server/yours.js +59 -0
  147. package/kits/hub-game/code/shared/cues.js +9 -0
  148. package/kits/hub-game/code/shared/decor.js +41 -0
  149. package/kits/hub-game/code/shared/shot.js +19 -0
  150. package/kits/hub-game/code/shared/spin.js +57 -0
  151. package/kits/hub-game/code/systems/hub.js +845 -95
  152. package/kits/hub-game/docs/content-pack.md +1 -1
  153. package/kits/hub-game/docs/contract.md +2244 -61
  154. package/kits/hub-game/docs/home-pieces.md +64 -0
  155. package/kits/hub-game/models/avatar-10.pxmodel +28 -0
  156. package/kits/hub-game/models/avatar-11.pxmodel +28 -0
  157. package/kits/hub-game/models/avatar-12.pxmodel +27 -0
  158. package/kits/hub-game/models/avatar-13.pxmodel +24 -0
  159. package/kits/hub-game/models/avatar-14.pxmodel +29 -0
  160. package/kits/hub-game/models/avatar-15.pxmodel +24 -0
  161. package/kits/hub-game/models/avatar-4.pxmodel +29 -0
  162. package/kits/hub-game/models/avatar-5.pxmodel +27 -0
  163. package/kits/hub-game/models/avatar-6.pxmodel +26 -0
  164. package/kits/hub-game/models/avatar-7.pxmodel +25 -0
  165. package/kits/hub-game/models/avatar-8.pxmodel +24 -0
  166. package/kits/hub-game/models/avatar-9.pxmodel +30 -0
  167. package/kits/hub-game/models/earned/badge-round.pxmodel +100 -0
  168. package/kits/hub-game/models/earned/badge-shield.pxmodel +117 -0
  169. package/kits/hub-game/models/earned/badge-star.pxmodel +87 -0
  170. package/kits/hub-game/models/earned/belt-plain.pxmodel +72 -0
  171. package/kits/hub-game/models/earned/held-ball.pxmodel +43 -0
  172. package/kits/hub-game/models/earned/held-lantern.pxmodel +85 -0
  173. package/kits/hub-game/models/earned/held-net.pxmodel +57 -0
  174. package/kits/hub-game/models/earned/held-trophy.pxmodel +109 -0
  175. package/kits/hub-game/models/earned/pin-round.pxmodel +62 -0
  176. package/kits/hub-game/models/earned/sash-plain.pxmodel +66 -0
  177. package/kits/hub-game/models/earned/square/belt-plain.pxmodel +104 -0
  178. package/kits/hub-game/models/earned/square/sash-plain.pxmodel +98 -0
  179. package/kits/hub-game/models/hats/bat-clip.pxmodel +206 -0
  180. package/kits/hub-game/models/hats/beekeeper.pxmodel +149 -0
  181. package/kits/hub-game/models/hats/cap.pxmodel +162 -0
  182. package/kits/hub-game/models/hats/captain.pxmodel +178 -0
  183. package/kits/hub-game/models/hats/crooked-top.pxmodel +172 -0
  184. package/kits/hub-game/models/hats/flower-crown.pxmodel +451 -0
  185. package/kits/hub-game/models/hats/foam-crown.pxmodel +179 -0
  186. package/kits/hub-game/models/hats/lantern.pxmodel +230 -0
  187. package/kits/hub-game/models/hats/laurel.pxmodel +533 -0
  188. package/kits/hub-game/models/hats/lighthouse.pxmodel +96 -0
  189. package/kits/hub-game/models/hats/sailor.pxmodel +141 -0
  190. package/kits/hub-game/models/hats/souwester.pxmodel +131 -0
  191. package/kits/hub-game/models/hats/straw.pxmodel +139 -0
  192. package/kits/hub-game/models/hats/sunflower.pxmodel +406 -0
  193. package/kits/hub-game/models/hats/sweatband.pxmodel +112 -0
  194. package/kits/hub-game/models/hats/witch.pxmodel +147 -0
  195. package/kits/hub-game/package-lock.json +2 -0
  196. package/kits/hub-game/package.json +2 -1
  197. package/kits/hub-game/scripts/check.mjs +78 -11
  198. package/kits/hub-game/scripts/companion-follower-wire.json +1 -0
  199. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +121 -0
  200. package/kits/hub-game/scripts/fixtures/decor-keyless.json +293 -0
  201. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +23 -0
  202. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +107 -0
  203. package/kits/hub-game/scripts/fixtures/interest-legacy.json +385 -0
  204. package/kits/hub-game/scripts/fixtures/npc-notes-v1.77.jsonl +4 -0
  205. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -0
  206. package/kits/hub-game/scripts/gen-avatars.mjs +933 -16
  207. package/kits/hub-game/scripts/gen-earned.mjs +285 -0
  208. package/kits/hub-game/scripts/gen-hats.mjs +827 -0
  209. package/kits/hub-game/scripts/grab.before-orbit.mjs +400 -0
  210. package/kits/hub-game/scripts/soundscape-wave-analysis.mjs +125 -0
  211. package/kits/hub-game/scripts/test-actions-client.mjs +488 -0
  212. package/kits/hub-game/scripts/test-actions.mjs +298 -0
  213. package/kits/hub-game/scripts/test-actor-budget.mjs +44 -0
  214. package/kits/hub-game/scripts/test-actors.mjs +19 -17
  215. package/kits/hub-game/scripts/test-ask-client.mjs +358 -0
  216. package/kits/hub-game/scripts/test-ask.mjs +269 -0
  217. package/kits/hub-game/scripts/test-attention.mjs +10 -1
  218. package/kits/hub-game/scripts/test-avatar-cap.mjs +379 -0
  219. package/kits/hub-game/scripts/test-avatar-colors.mjs +72 -0
  220. package/kits/hub-game/scripts/test-avatar-models.mjs +181 -0
  221. package/kits/hub-game/scripts/test-avatar-share.mjs +318 -0
  222. package/kits/hub-game/scripts/test-avatar-wire.mjs +753 -0
  223. package/kits/hub-game/scripts/test-avatar.mjs +540 -7
  224. package/kits/hub-game/scripts/test-ballot.mjs +1001 -0
  225. package/kits/hub-game/scripts/test-build.mjs +31 -0
  226. package/kits/hub-game/scripts/test-cells.mjs +71 -0
  227. package/kits/hub-game/scripts/test-chat.mjs +662 -0
  228. package/kits/hub-game/scripts/test-classic.mjs +2 -0
  229. package/kits/hub-game/scripts/test-companion-chat.mjs +198 -0
  230. package/kits/hub-game/scripts/test-companion-client.mjs +1167 -0
  231. package/kits/hub-game/scripts/test-companion.mjs +259 -0
  232. package/kits/hub-game/scripts/test-decor-client.mjs +303 -0
  233. package/kits/hub-game/scripts/test-decor.mjs +457 -0
  234. package/kits/hub-game/scripts/test-earned-client.mjs +459 -0
  235. package/kits/hub-game/scripts/test-earned.mjs +1194 -0
  236. package/kits/hub-game/scripts/test-emote-bubble.mjs +110 -0
  237. package/kits/hub-game/scripts/test-friend-bests.mjs +435 -0
  238. package/kits/hub-game/scripts/test-grab-orbit.mjs +918 -0
  239. package/kits/hub-game/scripts/test-grab.mjs +7 -0
  240. package/kits/hub-game/scripts/test-hats.mjs +422 -168
  241. package/kits/hub-game/scripts/test-hub-leaving.mjs +203 -0
  242. package/kits/hub-game/scripts/test-hub-ops.mjs +439 -2
  243. package/kits/hub-game/scripts/test-hub-trip.mjs +716 -2
  244. package/kits/hub-game/scripts/test-hud-clear.mjs +328 -4
  245. package/kits/hub-game/scripts/test-idle.mjs +361 -1
  246. package/kits/hub-game/scripts/test-interest-cap.mjs +36 -0
  247. package/kits/hub-game/scripts/test-interest-cells.mjs +493 -0
  248. package/kits/hub-game/scripts/test-interest-client.mjs +118 -0
  249. package/kits/hub-game/scripts/test-keys.mjs +46 -1
  250. package/kits/hub-game/scripts/test-labels.mjs +596 -0
  251. package/kits/hub-game/scripts/test-manifest.mjs +207 -0
  252. package/kits/hub-game/scripts/test-menu-client.mjs +480 -0
  253. package/kits/hub-game/scripts/test-menu.mjs +296 -0
  254. package/kits/hub-game/scripts/test-npcs.mjs +1718 -12
  255. package/kits/hub-game/scripts/test-object-entry.mjs +76 -0
  256. package/kits/hub-game/scripts/test-pack.mjs +7 -0
  257. package/kits/hub-game/scripts/test-picker.mjs +314 -0
  258. package/kits/hub-game/scripts/test-rehello.mjs +1039 -0
  259. package/kits/hub-game/scripts/test-relations-among.mjs +222 -0
  260. package/kits/hub-game/scripts/test-relations-refresh.mjs +188 -0
  261. package/kits/hub-game/scripts/test-shot.mjs +756 -0
  262. package/kits/hub-game/scripts/test-soundscape.mjs +5432 -0
  263. package/kits/hub-game/scripts/test-spin.mjs +314 -0
  264. package/kits/hub-game/scripts/test-standing.mjs +416 -0
  265. package/kits/hub-game/scripts/test-stuck.mjs +1903 -0
  266. package/kits/hub-game/scripts/test-tier-cells.mjs +706 -0
  267. package/kits/hub-game/scripts/test-tiers-render.mjs +339 -0
  268. package/kits/hub-game/scripts/test-tiers.mjs +477 -2
  269. package/kits/hub-game/scripts/test-toast-band.mjs +61 -0
  270. package/kits/hub-game/scripts/test-try-on.mjs +22 -22
  271. package/kits/hub-game/scripts/test-vis.mjs +343 -0
  272. package/kits/hub-game/scripts/test-visibility.mjs +134 -0
  273. package/kits/hub-game/scripts/test-yours-chrome.mjs +166 -0
  274. package/kits/hub-game/scripts/test-yours.mjs +372 -0
  275. package/kits/multiplayer-3d/CLAUDE.md +50 -0
  276. package/kits/multiplayer-3d/castle.json +5 -5
  277. package/kits/multiplayer-3d/code/client/avatars.js +7 -0
  278. package/kits/multiplayer-3d/code/client/gait.js +65 -0
  279. package/kits/multiplayer-3d/code/client/nameTags.js +59 -4
  280. package/kits/multiplayer-3d/code/options.js +5 -0
  281. package/kits/multiplayer-3d/code/server/ownership.js +10 -2
  282. package/kits/multiplayer-3d/code/server/sceneBodies.js +12 -0
  283. package/kits/multiplayer-3d/code/server/world.js +7 -0
  284. package/kits/multiplayer-3d/code/systems/multiplayer.js +74 -4
  285. package/kits/multiplayer-3d/package.json +2 -1
  286. package/kits/multiplayer-3d/scripts/fixtures/README.md +11 -0
  287. package/kits/multiplayer-3d/scripts/fixtures/ownership-legacy.json +2 -0
  288. package/kits/multiplayer-3d/scripts/ownership-harness.mjs +102 -0
  289. package/kits/multiplayer-3d/scripts/ownership-loader.mjs +46 -0
  290. package/kits/multiplayer-3d/scripts/ownership-worker.mjs +15 -0
  291. package/kits/multiplayer-3d/scripts/record-ownership-session.mjs +98 -0
  292. package/kits/multiplayer-3d/scripts/test-eligible-claims.mjs +167 -0
  293. package/kits/multiplayer-3d/scripts/test-own-name-tag.mjs +247 -0
  294. package/kits/physics-2d/CLAUDE.md +9 -0
  295. package/kits/physics-2d/castle.json +2 -2
  296. package/kits/physics-2d/engine/scene.js +253 -1
  297. package/kits/physics-2d/engine/skyKey.js +129 -0
  298. package/kits/physics-2d/engine/stillClock.js +106 -0
  299. package/kits/physics-2d/engine/updateBudget.js +21 -0
  300. package/kits/physics-2d/scripts/test-skip-unchanged.mjs +326 -1
  301. package/kits/physics-3d/CLAUDE.md +1169 -30
  302. package/kits/physics-3d/behaviors/Player.jsx +629 -72
  303. package/kits/physics-3d/castle.json +3 -3
  304. package/kits/physics-3d/docs/pxmodel-format.md +8 -0
  305. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +69 -13
  306. package/kits/physics-3d/engine3d/actornode.js +86 -0
  307. package/kits/physics-3d/engine3d/animationBudget.js +23 -0
  308. package/kits/physics-3d/engine3d/editorWorld.js +6 -0
  309. package/kits/physics-3d/engine3d/emptynodes.js +232 -0
  310. package/kits/physics-3d/engine3d/framecap.js +96 -0
  311. package/kits/physics-3d/engine3d/gait.js +118 -0
  312. package/kits/physics-3d/engine3d/kithooks.js +47 -0
  313. package/kits/physics-3d/engine3d/look.js +507 -48
  314. package/kits/physics-3d/engine3d/lookbake.js +208 -0
  315. package/kits/physics-3d/engine3d/materialpresets.js +2 -0
  316. package/kits/physics-3d/engine3d/motion.js +39 -10
  317. package/kits/physics-3d/engine3d/nearshadows.js +37 -19
  318. package/kits/physics-3d/engine3d/optimize.js +9 -5
  319. package/kits/physics-3d/engine3d/orbitinput.js +487 -9
  320. package/kits/physics-3d/engine3d/orbitlens.js +48 -0
  321. package/kits/physics-3d/engine3d/ownmodel.js +213 -0
  322. package/kits/physics-3d/engine3d/pxmodel.js +42 -11
  323. package/kits/physics-3d/engine3d/shadowfade.js +882 -0
  324. package/kits/physics-3d/engine3d/sky.js +547 -0
  325. package/kits/physics-3d/engine3d/skylife.js +306 -0
  326. package/kits/physics-3d/engine3d/unchanged.js +11 -0
  327. package/kits/physics-3d/engine3d/viewrange.js +52 -0
  328. package/kits/physics-3d/engine3d/world3d.js +796 -69
  329. package/kits/physics-3d/main.jsx +5 -0
  330. package/kits/physics-3d/package.json +1 -1
  331. package/kits/physics-3d/scripts/look-baseline.mjs +155 -0
  332. package/kits/physics-3d/scripts/test-camera-orbit.mjs +2563 -80
  333. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +1 -1
  334. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +435 -0
  335. package/kits/physics-3d/scripts/test-frame-cap.mjs +452 -0
  336. package/kits/physics-3d/scripts/test-gait.mjs +387 -0
  337. package/kits/physics-3d/scripts/test-look-bake.mjs +1056 -0
  338. package/kits/physics-3d/scripts/test-model-parse-cache.mjs +92 -0
  339. package/kits/physics-3d/scripts/test-near-shadows.mjs +3 -0
  340. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +1920 -0
  341. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +545 -0
  342. package/kits/physics-3d/scripts/test-orbit-shot.mjs +583 -0
  343. package/kits/physics-3d/scripts/test-orbit-view.mjs +230 -0
  344. package/kits/physics-3d/scripts/test-skip-empty-nodes.mjs +845 -0
  345. package/kits/physics-3d/scripts/test-sky.mjs +2470 -0
  346. package/kits/physics-3d/scripts/test-static-actors.mjs +8 -1
  347. package/kits/physics-3d/scripts/test-static-scenery.mjs +2171 -0
  348. package/kits/physics-3d/scripts/test-steady-hover.mjs +2 -0
  349. package/kits/physics-3d/scripts/test-view-range.mjs +260 -0
  350. package/kits/physics-3d/systems/physics3d.js +383 -6
  351. package/kits/real-time/castle.json +2 -2
  352. package/kits/real-time/code/server/gameHooks.js +7 -0
  353. package/kits/real-time/code/server/session.js +97 -19
  354. package/package.json +2 -2
  355. package/dist/shell/assets/index-Cf61cNfT.css +0 -1
@@ -18,7 +18,19 @@
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
+ // Low also draws no kit sky (`engine.sky`): while Low the runtime's `sky`
27
+ // reads null (`skyOff` below), so the engine makes no dome and uploads no art.
28
+ // A scene file may also carry visibility cells (`readCells` below): on Low an
29
+ // actor tagged with cells the camera's cell cannot see is not drawn, `keep`
30
+ // or not -- keep is about distance, a cell about what is in the way.
31
+ // Actors the place hides for this viewer are also taken out on Low, whatever
32
+ // their mark or components, except Player/avatar roots. High keeps the
33
+ // existing underground visibility path alone.
22
34
  //
23
35
  // Where a device starts: low if it was found slow here in the last week
24
36
  // (remembered in localStorage), or its GPU or memory says it is a weak phone;
@@ -27,6 +39,7 @@
27
39
  // over all of it.
28
40
 
29
41
  import { Box3, Sphere } from 'three';
42
+ import { hub, deck } from './state.js';
30
43
 
31
44
  export const TIERS = ['low', 'high'];
32
45
  export const MODES = ['auto', 'low', 'high'];
@@ -175,8 +188,12 @@ const SCENERY = new Set(['Transform', 'Shape', 'Model', 'Solid', 'Lookable']);
175
188
 
176
189
  // The mark a scene file puts on an actor (`"tier": "keep"`, a field of the
177
190
  // actor beside `id`) to have it drawn on every tier whatever `classify` says
178
- // of it. Any other value is no mark.
191
+ // of it. `"tier": "near"` makes a non-NPC actor scenery on Low (the sized
192
+ // 30 m test), whatever its components. `"tier": "low"` is drawn only on Low,
193
+ // exempt from distance/decor there. Other values are no mark.
179
194
  export const KEEP = 'keep';
195
+ export const NEAR = 'near';
196
+ export const LOW = 'low';
180
197
 
181
198
  export function classify(components) {
182
199
  const names = Object.keys(components ?? {});
@@ -196,6 +213,154 @@ export function classify(components) {
196
213
  return names.every((name) => SCENERY.has(name)) ? 'static' : 'game';
197
214
  }
198
215
 
216
+ // Visibility cells: a scene file may cut its ground into cells and say, for
217
+ // each, which cells can be seen from somewhere in it (a top-level `cells`
218
+ // key beside `engine` and `actors`; experiments/hub-town town_cells.py
219
+ // writes the 4x world's), and tag still actors with the cell their footprint
220
+ // is in (`"cell": "n-plaza"`, or a list when it spans several, beside `id`
221
+ // like `tier`). On Low an actor none of whose cells is seen from the
222
+ // camera's cell is taken out, wherever it is and whatever else is said of it:
223
+ // it is behind buildings, so the distance rules and `keep` do not apply. The
224
+ // table is read strictly: anything off and there is no table, and the scene
225
+ // is drawn as it would be without one.
226
+ export const CELLS_VERSION = 1;
227
+ // Which tagged actors the cells may take out, by an invariant: an actor is
228
+ // out for its cell only if (i) none of its components reacts to a player or
229
+ // the server (an interaction, a pad, a door, a seat, a wardrobe, a shop, a
230
+ // label writer, a mover, a body), (ii) nothing moves it, and (iii) that is
231
+ // decided again from its components every time it is needed, never
232
+ // remembered by id: the engine may replace an actor under the same id (a
233
+ // Body, a HubDoor) and the scene may add a component while playing.
234
+ // So: every component of the actor as it is now is one of CELL_INERT --
235
+ // a Lookable's words are read from the scene data by the client whether or
236
+ // not the node is drawn, and RouteAnchor and WalkSurface are data -- and
237
+ // none is CELL_PROTECTED, a backstop for what a player must see to find their
238
+ // way or play. An actor with no components, or none to be found, is drawn.
239
+ // Taking a node out stops its drawing and nothing else.
240
+ export const CELL_INERT = new Set(['Transform', 'Shape', 'Model', 'Solid', 'Lookable', 'RouteAnchor', 'WalkSurface']);
241
+ export const CELL_PROTECTED = new Set([
242
+ 'HubDoor',
243
+ 'HubPad',
244
+ 'HubNpc',
245
+ 'Body',
246
+ 'Player',
247
+ 'Ball',
248
+ 'HubSpin',
249
+ 'TownHats',
250
+ 'TownStamp',
251
+ 'TownHatMat',
252
+ 'TownWardrobeMat',
253
+ 'TownWardrobeItem',
254
+ 'TownWardrobe',
255
+ ]);
256
+
257
+ // Whether an actor's current components let the cells take it out.
258
+ export function cellInert(components) {
259
+ const names = components && typeof components === 'object' ? Object.keys(components) : [];
260
+ return names.length > 0 && names.every((name) => CELL_INERT.has(name) && !CELL_PROTECTED.has(name));
261
+ }
262
+
263
+ const finitePair = (p) => Array.isArray(p) && p.length === 2 && Number.isFinite(p[0]) && Number.isFinite(p[1]);
264
+
265
+ // The scene file's `cells` key as { eyeMax, hysteresis, cells: [{ id,
266
+ // outline, sees: Set }], byId }, or null when it is absent or malformed.
267
+ export function readCells(value) {
268
+ if (!value || typeof value !== 'object' || value.version !== CELLS_VERSION || !Array.isArray(value.cells) || !value.cells.length) {
269
+ return null;
270
+ }
271
+ if (!Number.isFinite(value.eyeMax) || !Number.isFinite(value.hysteresis) || value.hysteresis < 0) {
272
+ return null;
273
+ }
274
+ const byId = new Map();
275
+ for (const c of value.cells) {
276
+ if (!c || typeof c.id !== 'string' || !c.id || byId.has(c.id)) {
277
+ return null;
278
+ }
279
+ if (!Array.isArray(c.outline) || c.outline.length < 3 || !c.outline.every(finitePair) || !Array.isArray(c.sees)) {
280
+ return null;
281
+ }
282
+ byId.set(c.id, { id: c.id, outline: c.outline.map(([x, z]) => [x, z]), sees: c.sees });
283
+ }
284
+ for (const c of byId.values()) {
285
+ // A row that does not see itself is a mistake in the table, not a cell
286
+ // whose own ground is hidden: no table.
287
+ if (!c.sees.includes(c.id) || !c.sees.every((id) => typeof id === 'string' && byId.has(id))) {
288
+ return null;
289
+ }
290
+ c.sees = new Set(c.sees);
291
+ }
292
+ return { eyeMax: value.eyeMax, hysteresis: value.hysteresis, cells: [...byId.values()], byId };
293
+ }
294
+
295
+ // An actor's `cell` field as a list of the table's ids, or null: a string or
296
+ // a non-empty list of strings, every one a cell of the table. Anything else
297
+ // is no cell, and the actor is never taken out for it.
298
+ export function actorCells(value, table) {
299
+ const list = typeof value === 'string' ? [value] : value;
300
+ if (!table || !Array.isArray(list) || !list.length) {
301
+ return null;
302
+ }
303
+ return list.every((id) => typeof id === 'string' && table.byId.has(id)) ? list : null;
304
+ }
305
+
306
+ export function insideOutline(outline, x, z) {
307
+ let inside = false;
308
+ for (let i = 0, j = outline.length - 1; i < outline.length; j = i++) {
309
+ const [xi, zi] = outline[i];
310
+ const [xj, zj] = outline[j];
311
+ if (zi > z !== zj > z && x < ((xj - xi) * (z - zi)) / (zj - zi) + xi) {
312
+ inside = !inside;
313
+ }
314
+ }
315
+ return inside;
316
+ }
317
+
318
+ // How far a point is from an outline's nearest edge.
319
+ export function outlineDistance(outline, x, z) {
320
+ let best = Infinity;
321
+ for (let i = 0, j = outline.length - 1; i < outline.length; j = i++) {
322
+ const [ax, az] = outline[j];
323
+ const [bx, bz] = outline[i];
324
+ const dx = bx - ax;
325
+ const dz = bz - az;
326
+ const len = dx * dx + dz * dz;
327
+ const t = len > 0 ? Math.max(0, Math.min(1, ((x - ax) * dx + (z - az) * dz) / len)) : 0;
328
+ best = Math.min(best, Math.hypot(ax + t * dx - x, az + t * dz - z));
329
+ }
330
+ return best;
331
+ }
332
+
333
+ // The cell the eye at (x, z) is in, given the one it was in. Outside every
334
+ // outline, and at no finite place, there is no cell (null), first and
335
+ // whatever the hysteresis: the cells hide nothing rather than keep hiding
336
+ // what a cell the eye has left could not see. Inside some outline, the cell
337
+ // it was in is kept while the eye is inside it or within the table's
338
+ // hysteresis of it, so a border walked along does not flicker; otherwise the
339
+ // cell whose outline holds the eye.
340
+ export function eyeCell(table, current, x, z) {
341
+ if (!Number.isFinite(x) || !Number.isFinite(z)) {
342
+ return null;
343
+ }
344
+ const was = current === null ? null : table.byId.get(current);
345
+ // The cell it was in first: inside it is the common case, one outline.
346
+ if (was && insideOutline(was.outline, x, z)) {
347
+ return current;
348
+ }
349
+ const holder = table.cells.find((c) => c !== was && insideOutline(c.outline, x, z));
350
+ if (!holder) {
351
+ return null;
352
+ }
353
+ return was && outlineDistance(was.outline, x, z) <= table.hysteresis ? current : holder.id;
354
+ }
355
+
356
+ function cellsDebugUrl() {
357
+ try {
358
+ return new URLSearchParams(globalThis.location?.search ?? '').get('hubcells') === '1';
359
+ } catch {
360
+ return false;
361
+ }
362
+ }
363
+
199
364
  // A node's bounds once, as its middle's offset from the node's position and a
200
365
  // radius: scenery does not change shape, and the offset follows a node the
201
366
  // place moves (a hidden actor waits far below the ground).
@@ -222,16 +387,41 @@ export function makeLevers({ boundsOf = nodeBounds } = {}) {
222
387
  lights: new Set(),
223
388
  // node -> the parent it was taken out of.
224
389
  removed: new WeakMap(),
390
+ // The runtime whose `sky` reads null for Low (`skyOff`), or null.
391
+ skyOff: null,
392
+ // Shared model instances draw outside the actor graph: hide their
393
+ // detached Low-only root too, preserving its authored visibility.
394
+ visibility: new WeakMap(),
225
395
  hidden: 0,
226
396
  bounds: new WeakMap(),
227
397
  // 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).
398
+ // for scenery/cells (never a player's avatar or what they wear). The
399
+ // place's merged hidden set also takes out spawned non-player actors.
229
400
  authored: null,
401
+ distances: null,
230
402
  authoredFor: null,
231
- // Of those, the ids the scene file marks `"tier": "keep"`: never hidden.
403
+ // Of those, the ids marked `"tier": "keep"`: exempt from distance/decor.
232
404
  // null when the file marks none.
233
405
  kept: null,
406
+ // The ids marked `"tier": "near"`: scenery on Low, except NPCs.
407
+ near: null,
408
+ // The ids drawn only on Low, exempt from distance/decor there.
409
+ low: null,
234
410
  seen: { path: undefined, nodes: null, size: -1 },
411
+ // The scene file's visibility cells (`readCells`) and, by actor id, the
412
+ // cells each authored actor is tagged with; null when the file has none.
413
+ cells: null,
414
+ actorCells: null,
415
+ // The rule on or off (the harness's A/B), the eye's cell (hysteresis
416
+ // keeps it), the cell the last look drew from (null: everything), how
417
+ // many nodes are out for cells alone, and the last change of cell.
418
+ cellsOn: true,
419
+ cell: null,
420
+ cellKey: null,
421
+ cellHidden: 0,
422
+ pop: null,
423
+ overlay: null,
424
+ debugUrl: undefined,
235
425
  // The entries taken out on the last look, [actor id, entry]: the engine
236
426
  // replaces an entry in the same map when an actor's look changes
237
427
  // (world3d.js `ensureActorNode`), and the new node is drawn, so these are
@@ -240,15 +430,30 @@ export function makeLevers({ boundsOf = nodeBounds } = {}) {
240
430
  nextAt: 0,
241
431
  };
242
432
 
433
+ const sleeping = new Set();
434
+ const wakeSleeping = () => {
435
+ for (const actor of sleeping) {delete actor.runtime.renderSleep;}
436
+ sleeping.clear();
437
+ };
243
438
  const adopt = (world) => {
244
439
  if (lv.world !== world) {
440
+ wakeSleeping();
245
441
  // A new world: nothing changed on the old one is put back there.
246
442
  lv.world = world;
247
443
  lv.lights = new Set();
248
444
  lv.removed = new WeakMap();
445
+ lv.visibility = new WeakMap();
249
446
  lv.authored = null;
250
447
  lv.authoredFor = null;
251
448
  lv.kept = null;
449
+ lv.near = null;
450
+ lv.low = null;
451
+ lv.cells = null;
452
+ lv.actorCells = null;
453
+ lv.cell = null;
454
+ lv.cellKey = null;
455
+ lv.cellHidden = 0;
456
+ lv.pop = null;
252
457
  lv.seen = { path: undefined, nodes: null, size: -1 };
253
458
  lv.watch = [];
254
459
  lv.nextAt = 0;
@@ -271,28 +476,66 @@ export function makeLevers({ boundsOf = nodeBounds } = {}) {
271
476
  if (lv.authoredFor === scene.data && lv.authored) {
272
477
  return lv.authored;
273
478
  }
479
+ wakeSleeping();
274
480
  lv.authoredFor = scene.data;
275
481
  const ids = new Set();
276
482
  let kept = null;
483
+ let near = null;
484
+ let low = null;
485
+ let cells = null;
486
+ let tagged = null;
487
+ const distances = new Map();
277
488
  try {
278
489
  const file = scene.readFromFile(scene.scenePath);
490
+ cells = file?.cells === undefined ? null : readCells(file.cells);
279
491
  for (const a of file?.actors ?? []) {
280
492
  ids.add(a.id);
493
+ if (Number.isFinite(a.lowDrawDistance) && a.lowDrawDistance > 0) {
494
+ distances.set(a.id, a.lowDrawDistance);
495
+ }
281
496
  if (a.tier === KEEP) {
282
497
  (kept ??= new Set()).add(a.id);
498
+ } else if (a.tier === NEAR) {
499
+ (near ??= new Set()).add(a.id);
500
+ } else if (a.tier === LOW) {
501
+ (low ??= new Set()).add(a.id);
502
+ }
503
+ const list = cells && actorCells(a.cell, cells);
504
+ if (list) {
505
+ (tagged ??= new Map()).set(a.id, list);
283
506
  }
284
507
  }
285
508
  } catch {
286
509
  // A scene that cannot be read has no authored actors: nothing is hidden.
287
510
  ids.clear();
511
+ distances.clear();
288
512
  kept = null;
513
+ near = null;
514
+ low = null;
515
+ cells = null;
516
+ tagged = null;
289
517
  }
290
518
  lv.authored = ids;
519
+ lv.distances = distances;
291
520
  lv.kept = kept;
521
+ lv.near = near;
522
+ lv.low = low;
523
+ if (lv.cells !== cells) {
524
+ // Another table: the eye's cell is found again in it.
525
+ lv.cell = null;
526
+ }
527
+ lv.cells = cells;
528
+ lv.actorCells = tagged;
292
529
  return lv.authored;
293
530
  };
294
531
 
295
- const hide = (node) => {
532
+ const hide = (node, instanced = false) => {
533
+ if (instanced) {
534
+ if (!lv.visibility.has(node)) {
535
+ lv.visibility.set(node, node.visible);
536
+ }
537
+ node.visible = false;
538
+ }
296
539
  if (node.parent) {
297
540
  lv.removed.set(node, node.parent);
298
541
  node.parent.remove(node);
@@ -300,6 +543,10 @@ export function makeLevers({ boundsOf = nodeBounds } = {}) {
300
543
  };
301
544
 
302
545
  const unhide = (node) => {
546
+ if (lv.visibility.has(node)) {
547
+ node.visible = lv.visibility.get(node);
548
+ lv.visibility.delete(node);
549
+ }
303
550
  const parent = lv.removed.get(node);
304
551
  if (parent && !node.parent) {
305
552
  parent.add(node);
@@ -307,8 +554,8 @@ export function makeLevers({ boundsOf = nodeBounds } = {}) {
307
554
  lv.removed.delete(node);
308
555
  };
309
556
 
310
- const far = (node, near, cam, sized) => {
311
- const p = node.position;
557
+ const far = (node, near, cam, sized, at) => {
558
+ const p = at && [at.x, at.y, at.z].every(Number.isFinite) ? at : node.position;
312
559
  let b = { dx: 0, dy: 0, dz: 0, r: 0 };
313
560
  if (sized) {
314
561
  b = lv.bounds.get(node);
@@ -321,66 +568,288 @@ export function makeLevers({ boundsOf = nodeBounds } = {}) {
321
568
  return d > near;
322
569
  };
323
570
 
571
+ // The cell whose table row decides what is drawn, or null when the cells
572
+ // decide nothing (no table, the rule off, the eye in no cell yet or above
573
+ // the roofs). Moves the eye's cell along as a side effect.
574
+ const eyeKey = (world) => {
575
+ const table = lv.cells;
576
+ const p = world.camera?.position;
577
+ if (!table || !p) {
578
+ return null;
579
+ }
580
+ lv.cell = eyeCell(table, lv.cell, p.x, p.z);
581
+ return lv.cellsOn && Number.isFinite(p.y) && p.y <= table.eyeMax ? lv.cell : null;
582
+ };
583
+
584
+ // An authored actor tagged with cells none of which is seen from `visible`,
585
+ // and inert as it is now (`cellInert`, read on every look that asks).
586
+ const unseen = (id, visible, scene) => {
587
+ const tagged = lv.actorCells?.get(id);
588
+ if (!tagged || tagged.some((c) => visible.has(c))) {
589
+ return false;
590
+ }
591
+ return cellInert(scene.getActor?.(id)?.components);
592
+ };
593
+
594
+ const cellsDebug = () => {
595
+ if (globalThis.__hubCellsDebug === true) {
596
+ return true;
597
+ }
598
+ lv.debugUrl ??= cellsDebugUrl();
599
+ return lv.debugUrl;
600
+ };
601
+
602
+ const dropOverlay = () => {
603
+ try {
604
+ lv.overlay?.remove();
605
+ } catch {
606
+ // A node already gone is as good as removed.
607
+ }
608
+ lv.overlay = null;
609
+ };
610
+
611
+ // The tuning overlay (`?hubcells=1`): which cell the eye is in, what is out
612
+ // and why, and what the last change of cell put back and took out.
613
+ const showCells = (world, now) => {
614
+ if (!lv.cells || !cellsDebug()) {
615
+ dropOverlay();
616
+ return;
617
+ }
618
+ try {
619
+ if (!lv.overlay) {
620
+ const el = globalThis.document.createElement('div');
621
+ 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';
622
+ globalThis.document.body.appendChild(el);
623
+ lv.overlay = el;
624
+ }
625
+ const y = world.camera?.position?.y;
626
+ const pop = lv.pop;
627
+ lv.overlay.textContent = [
628
+ `cell ${lv.cellKey ?? (lv.cell ? `${lv.cell} (all drawn)` : 'none/all')}`,
629
+ `eye y ${Number.isFinite(y) ? y.toFixed(1) : '?'} (all over ${lv.cells.eyeMax})`,
630
+ `out: cells ${lv.cellHidden}, other ${lv.hidden - lv.cellHidden}`,
631
+ 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',
632
+ ].join('\n');
633
+ } catch {
634
+ // No document (a worker, a test): no overlay.
635
+ lv.overlay = null;
636
+ }
637
+ };
638
+
324
639
  // One look at every node: what should not be drawn is taken out, what should
325
640
  // be is put back.
326
- const pass = (world, scene, actors) => {
327
- lightsOff(world);
641
+ const pass = (world, scene, actors, now = 0, tier = LOW) => {
642
+ const isLow = tier === LOW;
643
+ wakeSleeping();
644
+ if (isLow) {
645
+ lightsOff(world);
646
+ }
328
647
  const authored = actors ? authoredIds(scene) : null;
329
648
  const cam = world.camera?.position ?? { x: 0, y: 0, z: 0 };
649
+ // The cells seen from the eye's cell, or null: the cell rule is off.
650
+ const key = isLow && actors ? eyeKey(world) : null;
651
+ const visible = key === null ? null : lv.cells.byId.get(key).sees;
652
+ // Remote avatars have no Player component. Their roots carry wearables
653
+ // and shared model rigs; ownmodel handles the local Player's visibility.
654
+ const avatars = new Set(scene.multiplayer?.avatars?.actors?.values() ?? []);
330
655
  const watch = [];
656
+ let cellHidden = 0;
657
+ let back = 0;
658
+ let out = 0;
331
659
  for (const [id, entry] of world.nodes) {
332
660
  const node = entry?.node;
333
- if (!node || entry.instancedRig) {
661
+ if (!node) {
334
662
  continue;
335
663
  }
336
664
  let want = false;
337
- if (authored?.has(id) && !lv.kept?.has(id)) {
338
- const kind = classify(scene.getActor?.(id)?.components);
665
+ const distance = actors && deck.lowActorDistance === true ? lv.distances?.get(id) : undefined;
666
+ const components = scene.getActor?.(id)?.components;
667
+ const placeHidden = hub.hidden.has(id) && !('Player' in (components ?? {})) && !avatars.has(id) && id !== scene.orbitOwnModel;
668
+ // applyVisibility has lifted the Transform already, but syncActors
669
+ // writes the node later, before rendering. Judge a newly shown actor
670
+ // at its lifted pose, not last frame's underground node position.
671
+ const shownAt = lv.removed.has(node) && !hub.hidden.has(id) ? components?.Transform : null;
672
+ // Not seen from the eye's cell: out, whatever the rules below say,
673
+ // `keep` and `near` included.
674
+ const cellOut =
675
+ (!entry.instancedRig || lv.low?.has(id)) && visible !== null && authored?.has(id) && unseen(id, visible, scene);
676
+ if (!isLow) {
677
+ want = actors && lv.low?.has(id);
678
+ } else if (placeHidden || cellOut) {
679
+ want = true;
680
+ } else if (
681
+ !entry.instancedRig &&
682
+ authored?.has(id) &&
683
+ !lv.kept?.has(id) &&
684
+ !lv.low?.has(id)
685
+ ) {
686
+ let kind = classify(components);
687
+ if (kind !== 'npc' && lv.near?.has(id)) {
688
+ kind = 'static';
689
+ }
339
690
  want =
340
691
  kind === 'decor' ||
341
- (kind === 'static' && far(node, SCENERY_NEAR_M, cam, true)) ||
342
- (kind === 'npc' && far(node, NPC_NEAR_M, cam, false));
692
+ (kind === 'static' && far(node, distance ?? SCENERY_NEAR_M, cam, true, shownAt)) ||
693
+ (kind === 'npc' && far(node, distance ?? NPC_NEAR_M, cam, false, shownAt));
694
+ }
695
+ if (isLow && distance && !lv.kept?.has(id) && !lv.low?.has(id) && !avatars.has(id) && !components?.Player) {
696
+ want ||= far(node, distance, cam, !components?.HubNpc, shownAt);
697
+ }
698
+ const actor = scene.getActor?.(id);
699
+ if (actor && distance) {
700
+ if (isLow && want && !entry.instancedRig && !avatars.has(id) && !components?.Player) {
701
+ actor.runtime.renderSleep = true;
702
+ sleeping.add(actor);
703
+ } else {
704
+ delete actor.runtime.renderSleep;
705
+ sleeping.delete(actor);
706
+ }
343
707
  }
344
708
  if (want) {
345
- hide(node);
709
+ if (node.parent) {
710
+ out += 1;
711
+ }
712
+ hide(node, entry.instancedRig && (!isLow || lv.low?.has(id)));
346
713
  if (!node.parent) {
347
714
  watch.push([id, entry]);
715
+ cellHidden += cellOut ? 1 : 0;
348
716
  }
349
717
  } else if (lv.removed.has(node)) {
718
+ back += node.parent ? 0 : 1;
350
719
  unhide(node);
351
720
  }
352
721
  }
353
722
  lv.watch = watch;
354
723
  lv.hidden = watch.length;
724
+ lv.cellHidden = cellHidden;
725
+ if (key !== lv.cellKey) {
726
+ lv.pop = { from: lv.cellKey, to: key, back, out, at: now };
727
+ lv.cellKey = key;
728
+ }
729
+ if (lv.cells || lv.overlay) {
730
+ showCells(world, now);
731
+ }
355
732
  };
356
733
 
357
734
  // Whether a node taken out was replaced (a rebuild) or put back since.
358
735
  const watchBroken = (world) => {
359
736
  for (const [id, entry] of lv.watch) {
360
- if (world.nodes.get(id) !== entry || entry.node.parent) {
737
+ if (world.nodes.get(id) !== entry || entry.node.parent || (lv.visibility.has(entry.node) && entry.node.visible !== false)) {
361
738
  return true;
362
739
  }
363
740
  }
364
741
  return false;
365
742
  };
366
743
 
367
- // Each frame while low. The nodes are looked at every CHECK_EVERY_MS, and at
744
+ // The kit sky off while Low. physics-3d draws what the runtime's `sky`
745
+ // getter answers (the scene's parsed `engine.sky`, or null) and reads it
746
+ // afresh every frame, releasing a dome whose key is gone; it has no switch
747
+ // of its own. So Low puts an own `sky` of null on the runtime, over the
748
+ // getter, and leaving Low deletes it: the getter answers again and the
749
+ // next frame makes the sky. `skyZone` is not touched (nothing steps it).
750
+ // Never on High, so a deck that is never Low has no such property.
751
+ const skyOff = (scene) => {
752
+ const held = lv.skyOff;
753
+ if (held && held !== scene) {
754
+ if (Object.getOwnPropertyDescriptor(held, 'sky')?.value === null) {
755
+ delete held.sky;
756
+ }
757
+ lv.skyOff = null;
758
+ }
759
+ if (scene && !lv.skyOff) {
760
+ if (!Object.hasOwn(scene, 'sky')) {
761
+ Object.defineProperty(scene, 'sky', { value: null, configurable: true, enumerable: false });
762
+ }
763
+ lv.skyOff = scene;
764
+ }
765
+ };
766
+
767
+ // Each frame: Low applies its rules; High hides only low-marked actors.
768
+ // tiers run in the runtime's update, before the player loads a requested
769
+ // scene and builds its nodes: a low-marked node built in a frame is drawn
770
+ // on High for that one frame (a scene load, or the actor's rebuild).
771
+ // The nodes are looked at every CHECK_EVERY_MS, and at
368
772
  // once when the engine swapped or rebuilt them (another scene, nodes parked
369
773
  // or put back, actors come or gone, the scene loaded again: new scene data
370
774
  // 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 } = {}) => {
775
+ // a door: another deck's content) puts scenery back and keeps only the
776
+ // shadow lever, the sky off and the place's own hidden actors.
777
+ const update = (world, scene, now, { actors = true, tier = LOW } = {}) => {
374
778
  adopt(world);
375
- lv.active = true;
779
+ const isLow = tier === LOW;
780
+ lv.active = isLow;
781
+ // Whatever scene plays, a game reached through a door included. It
782
+ // stays over a scene load, so a keyed scene loaded on Low never draws
783
+ // or uploads its sky, not even for the frame of the load.
784
+ // A scene load asked for this frame runs right after this update, before
785
+ // the draw. Its reset releases a sky made on High by the key it reads, so
786
+ // Low does not start hiding the key in that frame, only from the next.
787
+ const loading = Boolean(scene.requestedScene);
788
+ skyOff(isLow && (lv.skyOff === scene || !loading) ? scene : null);
789
+ if (!isLow) {
790
+ if (loading) {
791
+ // And the load may reuse a node for the next scene's actor of the
792
+ // same id, marked or not: what High took out goes back in first.
793
+ // Only nodes the world still has: one the engine released since
794
+ // (the actor's rebuild) stays out for good.
795
+ for (const [id, entry] of lv.watch) {
796
+ if (world.nodes.get(id) === entry) {
797
+ unhide(entry.node);
798
+ }
799
+ }
800
+ lv.watch = [];
801
+ lv.seen = { path: undefined, nodes: null, size: -1 };
802
+ return;
803
+ }
804
+ if (actors) {
805
+ authoredIds(scene);
806
+ }
807
+ if ((!actors || !lv.low) && !lv.watch.length) {
808
+ return;
809
+ }
810
+ }
376
811
  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) {
812
+ // mergeHidden replaces the per-viewer set. clear empties it in place on
813
+ // a session switch, so remember its size too. Either runs this frame.
814
+ const changed =
815
+ world.scenePath !== seen.path ||
816
+ world.nodes !== seen.nodes ||
817
+ world.nodes.size !== seen.size ||
818
+ scene.data !== seen.data ||
819
+ hub.hidden !== seen.hidden ||
820
+ hub.hidden.size !== seen.hiddenSize ||
821
+ watchBroken(world) ||
822
+ tier !== seen.tier;
823
+ // The eye's cell every frame (one or two small outlines; null and done
824
+ // in a scene without cells): a new cell is looked at at once, not at the
825
+ // next look, so what it sees is not missing for half a second.
826
+ const crossed = isLow && lv.cells !== null && actors && eyeKey(world) !== lv.cellKey;
827
+ if (!changed && !crossed && now < lv.nextAt && actors === seen.actors) {
379
828
  return;
380
829
  }
381
- lv.seen = { path: world.scenePath, nodes: world.nodes, size: world.nodes.size, data: scene.data, actors };
830
+ lv.seen = {
831
+ path: world.scenePath,
832
+ nodes: world.nodes,
833
+ size: world.nodes.size,
834
+ data: scene.data,
835
+ actors,
836
+ tier,
837
+ hidden: hub.hidden,
838
+ hiddenSize: hub.hidden.size,
839
+ };
382
840
  lv.nextAt = now + CHECK_EVERY_MS;
383
- pass(world, scene, actors);
841
+ pass(world, scene, actors, now, tier);
842
+ return true;
843
+ };
844
+
845
+ lv.apply = (world, scene, now, options) => update(world, scene, now, options);
846
+ lv.high = (world, scene, now, options) => update(world, scene, now, { ...options, tier: 'high' });
847
+
848
+ // The cell rule off or on at runtime (the harness's A/B); the next frame
849
+ // looks at every node again.
850
+ lv.setCells = (on) => {
851
+ lv.cellsOn = Boolean(on);
852
+ lv.nextAt = 0;
384
853
  };
385
854
 
386
855
  // Back to the picture as authored: every node taken out of the scene put
@@ -388,17 +857,25 @@ export function makeLevers({ boundsOf = nodeBounds } = {}) {
388
857
  // left to the engine), every shadow on again.
389
858
  lv.restore = (world) => {
390
859
  adopt(world);
860
+ wakeSleeping();
861
+ skyOff(null);
391
862
  for (const entry of world.nodes.values()) {
392
863
  if (entry?.node && lv.removed.has(entry.node)) {
393
864
  unhide(entry.node);
394
865
  }
395
866
  }
396
867
  lv.removed = new WeakMap();
868
+ lv.visibility = new WeakMap();
397
869
  for (const light of lv.lights) {
398
870
  light.castShadow = true;
399
871
  }
400
872
  lv.lights.clear();
401
873
  lv.hidden = 0;
874
+ lv.cellHidden = 0;
875
+ lv.cell = null;
876
+ lv.cellKey = null;
877
+ lv.pop = null;
878
+ dropOverlay();
402
879
  lv.watch = [];
403
880
  lv.active = false;
404
881
  lv.seen = { path: undefined, nodes: null, size: -1 };
@@ -477,11 +954,14 @@ export function makeTiers({ storage = pageStorage(), clock = () => Date.now(), d
477
954
  }
478
955
  if (t.current() === 'low') {
479
956
  levers.apply(world, scene, now, { actors: !scene.content });
480
- } else if (levers.active) {
957
+ } else {
481
958
  // Low to High costs a one-off stall (about 1 s on the phones measured)
482
959
  // as three.js recompiles its shader programs for the shadows coming
483
960
  // back. Acceptable: auto never moves up, only a player's pick does.
484
- levers.restore(world);
961
+ if (levers.active) {
962
+ levers.restore(world);
963
+ }
964
+ levers.high?.(world, scene, now, { actors: !scene.content });
485
965
  }
486
966
  };
487
967
 
@@ -499,6 +979,15 @@ export function makeTiers({ storage = pageStorage(), clock = () => Date.now(), d
499
979
  get hidden() {
500
980
  return levers.hidden;
501
981
  },
982
+ // The visibility cells: the eye's cell, how many nodes are out for cells
983
+ // alone, and the rule off or on for an A/B.
984
+ get cell() {
985
+ return levers.cell ?? null;
986
+ },
987
+ get cellHidden() {
988
+ return levers.cellHidden ?? 0;
989
+ },
990
+ cells: (on) => levers.setCells?.(on),
502
991
  set: (mode) => t.set(mode),
503
992
  };
504
993
  return t;