castle-web-cli 0.4.231 → 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 (368) 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/serverBundle.js +5 -3
  28. package/dist/shell/assets/{index-D2tWM896.js → index-BjOxR-lW.js} +4 -4
  29. package/dist/shell/assets/index-MVLfNYd9.css +1 -0
  30. package/dist/shell/index.html +2 -2
  31. package/dist/taskSteer.d.ts +13 -0
  32. package/dist/taskSteer.js +22 -2
  33. package/kits/base/castle.json +1 -1
  34. package/kits/base/package-lock.json +1 -1
  35. package/kits/base/sdk/README.md +79 -2
  36. package/kits/base/sdk/avatar.d.ts +6 -2
  37. package/kits/base/sdk/avatar.js +12 -4
  38. package/kits/base/sdk/castle.d.ts +1 -1
  39. package/kits/base/sdk/commands.d.ts +14 -0
  40. package/kits/base/sdk/hub.d.ts +6 -2
  41. package/kits/base/sdk/hub.js +13 -0
  42. package/kits/base/sdk/multiplayer.js +17 -1
  43. package/kits/base/sdk/save.js +2 -1
  44. package/kits/base/sdk/server/hub.d.ts +87 -0
  45. package/kits/base/sdk/server/hub.js +70 -0
  46. package/kits/base/sdk/server/platformHandle.d.ts +31 -1
  47. package/kits/base/sdk/server/storage.d.ts +13 -0
  48. package/kits/base/sdk/server/storage.js +46 -0
  49. package/kits/base/sdk/server/wrapper.d.ts +36 -5
  50. package/kits/base/sdk/server/wrapper.js +83 -8
  51. package/kits/hub-game/CLAUDE.md +352 -12
  52. package/kits/hub-game/blueprints/avatar-10.scene +28 -0
  53. package/kits/hub-game/blueprints/avatar-11.scene +28 -0
  54. package/kits/hub-game/blueprints/avatar-12.scene +28 -0
  55. package/kits/hub-game/blueprints/avatar-13.scene +28 -0
  56. package/kits/hub-game/blueprints/avatar-14.scene +28 -0
  57. package/kits/hub-game/blueprints/avatar-15.scene +28 -0
  58. package/kits/hub-game/blueprints/avatar-4.scene +28 -0
  59. package/kits/hub-game/blueprints/avatar-5.scene +28 -0
  60. package/kits/hub-game/blueprints/avatar-6.scene +28 -0
  61. package/kits/hub-game/blueprints/avatar-7.scene +28 -0
  62. package/kits/hub-game/blueprints/avatar-8.scene +28 -0
  63. package/kits/hub-game/blueprints/avatar-9.scene +28 -0
  64. package/kits/hub-game/code/client/actorBudget.js +47 -0
  65. package/kits/hub-game/code/client/attention.js +11 -2
  66. package/kits/hub-game/code/client/avatar.js +345 -32
  67. package/kits/hub-game/code/client/avatarCap.js +228 -0
  68. package/kits/hub-game/code/client/avatarColors.js +70 -0
  69. package/kits/hub-game/code/client/avatarFaces.js +21 -0
  70. package/kits/hub-game/code/client/avatarShare.js +251 -0
  71. package/kits/hub-game/code/client/ballot.js +467 -0
  72. package/kits/hub-game/code/client/build.js +22 -0
  73. package/kits/hub-game/code/client/chat.js +12 -0
  74. package/kits/hub-game/code/client/chrome.js +1334 -50
  75. package/kits/hub-game/code/client/companion.js +716 -0
  76. package/kits/hub-game/code/client/companionDress.js +99 -0
  77. package/kits/hub-game/code/client/decor.js +509 -0
  78. package/kits/hub-game/code/client/earned.js +131 -0
  79. package/kits/hub-game/code/client/emoteBubble.js +75 -0
  80. package/kits/hub-game/code/client/grab.js +363 -20
  81. package/kits/hub-game/code/client/hats.js +26 -0
  82. package/kits/hub-game/code/client/hookLayer.js +328 -15
  83. package/kits/hub-game/code/client/hudClear.js +126 -0
  84. package/kits/hub-game/code/client/idle.js +163 -22
  85. package/kits/hub-game/code/client/interestCap.js +81 -0
  86. package/kits/hub-game/code/client/keys.js +36 -0
  87. package/kits/hub-game/code/client/labelsNear.js +205 -0
  88. package/kits/hub-game/code/client/menuIcons.js +34 -0
  89. package/kits/hub-game/code/client/pack.js +6 -2
  90. package/kits/hub-game/code/client/packFormat.js +3 -3
  91. package/kits/hub-game/code/client/rehello.js +167 -0
  92. package/kits/hub-game/code/client/shot.js +92 -0
  93. package/kits/hub-game/code/client/sound.js +63 -8
  94. package/kits/hub-game/code/client/soundscape.js +1151 -0
  95. package/kits/hub-game/code/client/soundscapeActions.js +99 -0
  96. package/kits/hub-game/code/client/soundscapeAmbience.js +453 -0
  97. package/kits/hub-game/code/client/soundscapeBaked.js +143 -0
  98. package/kits/hub-game/code/client/soundscapeBusker.js +217 -0
  99. package/kits/hub-game/code/client/soundscapeCourt.js +200 -0
  100. package/kits/hub-game/code/client/soundscapeCrowd.js +331 -0
  101. package/kits/hub-game/code/client/soundscapeCues.js +362 -0
  102. package/kits/hub-game/code/client/soundscapeMap.js +181 -0
  103. package/kits/hub-game/code/client/soundscapeMarket.js +176 -0
  104. package/kits/hub-game/code/client/soundscapeMusic.js +126 -0
  105. package/kits/hub-game/code/client/soundscapeMusicEngine.js +460 -0
  106. package/kits/hub-game/code/client/soundscapeSimlish.js +737 -0
  107. package/kits/hub-game/code/client/soundscapeSongs.js +127 -0
  108. package/kits/hub-game/code/client/soundscapeSongsRound3.js +63 -0
  109. package/kits/hub-game/code/client/soundscapeSynthesis.js +168 -0
  110. package/kits/hub-game/code/client/soundscapeUi.js +211 -0
  111. package/kits/hub-game/code/client/soundscapeVoice.js +1209 -0
  112. package/kits/hub-game/code/client/soundscapeWaves.js +206 -0
  113. package/kits/hub-game/code/client/spin.js +101 -0
  114. package/kits/hub-game/code/client/state.js +131 -1
  115. package/kits/hub-game/code/client/stuck.js +259 -0
  116. package/kits/hub-game/code/client/talk.js +538 -47
  117. package/kits/hub-game/code/client/tiers.js +541 -27
  118. package/kits/hub-game/code/client/toastBand.js +37 -0
  119. package/kits/hub-game/code/client/together.js +98 -1
  120. package/kits/hub-game/code/client/visibility.js +43 -0
  121. package/kits/hub-game/code/client/wear.js +470 -97
  122. package/kits/hub-game/code/client/yours.js +199 -0
  123. package/kits/hub-game/code/companionSpec.js +45 -0
  124. package/kits/hub-game/code/privateText.js +7 -0
  125. package/kits/hub-game/code/server/actions.js +133 -0
  126. package/kits/hub-game/code/server/actors.js +14 -1
  127. package/kits/hub-game/code/server/ask.js +155 -0
  128. package/kits/hub-game/code/server/ballot.js +539 -0
  129. package/kits/hub-game/code/server/cells.js +100 -0
  130. package/kits/hub-game/code/server/companion.js +82 -0
  131. package/kits/hub-game/code/server/cues.js +70 -0
  132. package/kits/hub-game/code/server/decor.js +269 -0
  133. package/kits/hub-game/code/server/earned.js +461 -0
  134. package/kits/hub-game/code/server/friendBests.js +166 -0
  135. package/kits/hub-game/code/server/friendsAmong.js +232 -0
  136. package/kits/hub-game/code/server/grab.js +296 -11
  137. package/kits/hub-game/code/server/history.js +5 -0
  138. package/kits/hub-game/code/server/hub.js +1317 -52
  139. package/kits/hub-game/code/server/idle.js +30 -11
  140. package/kits/hub-game/code/server/index.js +2 -2
  141. package/kits/hub-game/code/server/labels.js +28 -2
  142. package/kits/hub-game/code/server/manifest.js +424 -8
  143. package/kits/hub-game/code/server/menu.js +133 -0
  144. package/kits/hub-game/code/server/npcs.js +830 -80
  145. package/kits/hub-game/code/server/party.js +13 -2
  146. package/kits/hub-game/code/server/players.js +22 -0
  147. package/kits/hub-game/code/server/say.js +8 -2
  148. package/kits/hub-game/code/server/shot.js +110 -0
  149. package/kits/hub-game/code/server/standing.js +124 -0
  150. package/kits/hub-game/code/server/vis.js +113 -0
  151. package/kits/hub-game/code/server/wear.js +128 -11
  152. package/kits/hub-game/code/server/yours.js +59 -0
  153. package/kits/hub-game/code/shared/cues.js +9 -0
  154. package/kits/hub-game/code/shared/decor.js +41 -0
  155. package/kits/hub-game/code/shared/shot.js +19 -0
  156. package/kits/hub-game/code/shared/spin.js +57 -0
  157. package/kits/hub-game/code/systems/hub.js +1083 -85
  158. package/kits/hub-game/docs/content-pack.md +1 -1
  159. package/kits/hub-game/docs/contract.md +2440 -61
  160. package/kits/hub-game/docs/home-pieces.md +64 -0
  161. package/kits/hub-game/models/avatar-10.pxmodel +28 -0
  162. package/kits/hub-game/models/avatar-11.pxmodel +28 -0
  163. package/kits/hub-game/models/avatar-12.pxmodel +27 -0
  164. package/kits/hub-game/models/avatar-13.pxmodel +24 -0
  165. package/kits/hub-game/models/avatar-14.pxmodel +29 -0
  166. package/kits/hub-game/models/avatar-15.pxmodel +24 -0
  167. package/kits/hub-game/models/avatar-4.pxmodel +29 -0
  168. package/kits/hub-game/models/avatar-5.pxmodel +27 -0
  169. package/kits/hub-game/models/avatar-6.pxmodel +26 -0
  170. package/kits/hub-game/models/avatar-7.pxmodel +25 -0
  171. package/kits/hub-game/models/avatar-8.pxmodel +24 -0
  172. package/kits/hub-game/models/avatar-9.pxmodel +30 -0
  173. package/kits/hub-game/models/earned/badge-round.pxmodel +100 -0
  174. package/kits/hub-game/models/earned/badge-shield.pxmodel +117 -0
  175. package/kits/hub-game/models/earned/badge-star.pxmodel +87 -0
  176. package/kits/hub-game/models/earned/belt-plain.pxmodel +72 -0
  177. package/kits/hub-game/models/earned/held-ball.pxmodel +43 -0
  178. package/kits/hub-game/models/earned/held-lantern.pxmodel +85 -0
  179. package/kits/hub-game/models/earned/held-net.pxmodel +57 -0
  180. package/kits/hub-game/models/earned/held-trophy.pxmodel +109 -0
  181. package/kits/hub-game/models/earned/pin-round.pxmodel +62 -0
  182. package/kits/hub-game/models/earned/sash-plain.pxmodel +66 -0
  183. package/kits/hub-game/models/earned/square/belt-plain.pxmodel +104 -0
  184. package/kits/hub-game/models/earned/square/sash-plain.pxmodel +98 -0
  185. package/kits/hub-game/models/hats/bat-clip.pxmodel +206 -0
  186. package/kits/hub-game/models/hats/beekeeper.pxmodel +149 -0
  187. package/kits/hub-game/models/hats/cap.pxmodel +162 -0
  188. package/kits/hub-game/models/hats/captain.pxmodel +178 -0
  189. package/kits/hub-game/models/hats/crooked-top.pxmodel +172 -0
  190. package/kits/hub-game/models/hats/flower-crown.pxmodel +451 -0
  191. package/kits/hub-game/models/hats/foam-crown.pxmodel +179 -0
  192. package/kits/hub-game/models/hats/lantern.pxmodel +230 -0
  193. package/kits/hub-game/models/hats/laurel.pxmodel +533 -0
  194. package/kits/hub-game/models/hats/lighthouse.pxmodel +96 -0
  195. package/kits/hub-game/models/hats/sailor.pxmodel +141 -0
  196. package/kits/hub-game/models/hats/souwester.pxmodel +131 -0
  197. package/kits/hub-game/models/hats/straw.pxmodel +139 -0
  198. package/kits/hub-game/models/hats/sunflower.pxmodel +406 -0
  199. package/kits/hub-game/models/hats/sweatband.pxmodel +112 -0
  200. package/kits/hub-game/models/hats/witch.pxmodel +147 -0
  201. package/kits/hub-game/package-lock.json +2 -0
  202. package/kits/hub-game/package.json +2 -1
  203. package/kits/hub-game/scripts/check.mjs +78 -11
  204. package/kits/hub-game/scripts/companion-follower-wire.json +1 -0
  205. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +121 -0
  206. package/kits/hub-game/scripts/fixtures/decor-keyless.json +293 -0
  207. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +23 -0
  208. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +107 -0
  209. package/kits/hub-game/scripts/fixtures/interest-legacy.json +385 -0
  210. package/kits/hub-game/scripts/fixtures/npc-notes-v1.77.jsonl +4 -0
  211. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -0
  212. package/kits/hub-game/scripts/gen-avatars.mjs +933 -16
  213. package/kits/hub-game/scripts/gen-earned.mjs +285 -0
  214. package/kits/hub-game/scripts/gen-hats.mjs +827 -0
  215. package/kits/hub-game/scripts/grab.before-orbit.mjs +400 -0
  216. package/kits/hub-game/scripts/soundscape-wave-analysis.mjs +125 -0
  217. package/kits/hub-game/scripts/test-actions-client.mjs +488 -0
  218. package/kits/hub-game/scripts/test-actions.mjs +298 -0
  219. package/kits/hub-game/scripts/test-actor-budget.mjs +44 -0
  220. package/kits/hub-game/scripts/test-actors.mjs +19 -17
  221. package/kits/hub-game/scripts/test-ask-client.mjs +358 -0
  222. package/kits/hub-game/scripts/test-ask.mjs +269 -0
  223. package/kits/hub-game/scripts/test-attention.mjs +10 -1
  224. package/kits/hub-game/scripts/test-avatar-cap.mjs +379 -0
  225. package/kits/hub-game/scripts/test-avatar-colors.mjs +72 -0
  226. package/kits/hub-game/scripts/test-avatar-models.mjs +181 -0
  227. package/kits/hub-game/scripts/test-avatar-share.mjs +318 -0
  228. package/kits/hub-game/scripts/test-avatar-wire.mjs +753 -0
  229. package/kits/hub-game/scripts/test-avatar.mjs +540 -7
  230. package/kits/hub-game/scripts/test-ballot.mjs +1001 -0
  231. package/kits/hub-game/scripts/test-build.mjs +31 -0
  232. package/kits/hub-game/scripts/test-cells.mjs +71 -0
  233. package/kits/hub-game/scripts/test-chat.mjs +694 -0
  234. package/kits/hub-game/scripts/test-classic.mjs +2 -0
  235. package/kits/hub-game/scripts/test-companion-chat.mjs +198 -0
  236. package/kits/hub-game/scripts/test-companion-client.mjs +1167 -0
  237. package/kits/hub-game/scripts/test-companion.mjs +259 -0
  238. package/kits/hub-game/scripts/test-decor-client.mjs +303 -0
  239. package/kits/hub-game/scripts/test-decor.mjs +457 -0
  240. package/kits/hub-game/scripts/test-earned-client.mjs +459 -0
  241. package/kits/hub-game/scripts/test-earned.mjs +1194 -0
  242. package/kits/hub-game/scripts/test-emote-bubble.mjs +110 -0
  243. package/kits/hub-game/scripts/test-friend-bests.mjs +435 -0
  244. package/kits/hub-game/scripts/test-grab-client.mjs +186 -3
  245. package/kits/hub-game/scripts/test-grab-orbit.mjs +918 -0
  246. package/kits/hub-game/scripts/test-grab.mjs +864 -3
  247. package/kits/hub-game/scripts/test-hats.mjs +483 -0
  248. package/kits/hub-game/scripts/test-hub-leaving.mjs +203 -0
  249. package/kits/hub-game/scripts/test-hub-ops.mjs +439 -2
  250. package/kits/hub-game/scripts/test-hub-trip.mjs +1228 -1
  251. package/kits/hub-game/scripts/test-hud-clear.mjs +1000 -0
  252. package/kits/hub-game/scripts/test-idle.mjs +361 -1
  253. package/kits/hub-game/scripts/test-interest-cap.mjs +36 -0
  254. package/kits/hub-game/scripts/test-interest-cells.mjs +493 -0
  255. package/kits/hub-game/scripts/test-interest-client.mjs +118 -0
  256. package/kits/hub-game/scripts/test-keys.mjs +46 -1
  257. package/kits/hub-game/scripts/test-labels.mjs +596 -0
  258. package/kits/hub-game/scripts/test-manifest.mjs +282 -0
  259. package/kits/hub-game/scripts/test-menu-client.mjs +480 -0
  260. package/kits/hub-game/scripts/test-menu.mjs +296 -0
  261. package/kits/hub-game/scripts/test-npcs.mjs +1718 -12
  262. package/kits/hub-game/scripts/test-object-entry.mjs +76 -0
  263. package/kits/hub-game/scripts/test-pack.mjs +7 -0
  264. package/kits/hub-game/scripts/test-party.mjs +22 -1
  265. package/kits/hub-game/scripts/test-picker.mjs +314 -0
  266. package/kits/hub-game/scripts/test-rehello.mjs +1039 -0
  267. package/kits/hub-game/scripts/test-relations-among.mjs +222 -0
  268. package/kits/hub-game/scripts/test-relations-refresh.mjs +188 -0
  269. package/kits/hub-game/scripts/test-say.mjs +59 -2
  270. package/kits/hub-game/scripts/test-shot.mjs +756 -0
  271. package/kits/hub-game/scripts/test-soundscape.mjs +5432 -0
  272. package/kits/hub-game/scripts/test-spin.mjs +314 -0
  273. package/kits/hub-game/scripts/test-standing.mjs +416 -0
  274. package/kits/hub-game/scripts/test-stuck.mjs +1903 -0
  275. package/kits/hub-game/scripts/test-tier-cells.mjs +706 -0
  276. package/kits/hub-game/scripts/test-tiers-render.mjs +339 -0
  277. package/kits/hub-game/scripts/test-tiers.mjs +666 -3
  278. package/kits/hub-game/scripts/test-toast-band.mjs +61 -0
  279. package/kits/hub-game/scripts/test-try-on.mjs +940 -0
  280. package/kits/hub-game/scripts/test-vis.mjs +343 -0
  281. package/kits/hub-game/scripts/test-visibility.mjs +134 -0
  282. package/kits/hub-game/scripts/test-yours-chrome.mjs +166 -0
  283. package/kits/hub-game/scripts/test-yours.mjs +372 -0
  284. package/kits/multiplayer-3d/CLAUDE.md +50 -0
  285. package/kits/multiplayer-3d/castle.json +5 -5
  286. package/kits/multiplayer-3d/code/client/avatars.js +7 -0
  287. package/kits/multiplayer-3d/code/client/gait.js +65 -0
  288. package/kits/multiplayer-3d/code/client/nameTags.js +59 -4
  289. package/kits/multiplayer-3d/code/options.js +5 -0
  290. package/kits/multiplayer-3d/code/server/ownership.js +10 -2
  291. package/kits/multiplayer-3d/code/server/sceneBodies.js +12 -0
  292. package/kits/multiplayer-3d/code/server/world.js +7 -0
  293. package/kits/multiplayer-3d/code/systems/multiplayer.js +74 -4
  294. package/kits/multiplayer-3d/package.json +2 -1
  295. package/kits/multiplayer-3d/scripts/fixtures/README.md +11 -0
  296. package/kits/multiplayer-3d/scripts/fixtures/ownership-legacy.json +2 -0
  297. package/kits/multiplayer-3d/scripts/ownership-harness.mjs +102 -0
  298. package/kits/multiplayer-3d/scripts/ownership-loader.mjs +46 -0
  299. package/kits/multiplayer-3d/scripts/ownership-worker.mjs +15 -0
  300. package/kits/multiplayer-3d/scripts/record-ownership-session.mjs +98 -0
  301. package/kits/multiplayer-3d/scripts/test-eligible-claims.mjs +167 -0
  302. package/kits/multiplayer-3d/scripts/test-own-name-tag.mjs +247 -0
  303. package/kits/physics-2d/CLAUDE.md +9 -0
  304. package/kits/physics-2d/castle.json +2 -2
  305. package/kits/physics-2d/engine/scene.js +288 -1
  306. package/kits/physics-2d/engine/skyKey.js +129 -0
  307. package/kits/physics-2d/engine/stillClock.js +106 -0
  308. package/kits/physics-2d/engine/updateBudget.js +21 -0
  309. package/kits/physics-2d/scripts/test-skip-unchanged.mjs +370 -1
  310. package/kits/physics-3d/CLAUDE.md +1391 -0
  311. package/kits/physics-3d/behaviors/Player.jsx +921 -3
  312. package/kits/physics-3d/castle.json +3 -3
  313. package/kits/physics-3d/docs/pxmodel-format.md +12 -0
  314. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +98 -10
  315. package/kits/physics-3d/engine3d/actornode.js +86 -0
  316. package/kits/physics-3d/engine3d/animationBudget.js +23 -0
  317. package/kits/physics-3d/engine3d/editorWorld.js +6 -0
  318. package/kits/physics-3d/engine3d/emptynodes.js +232 -0
  319. package/kits/physics-3d/engine3d/framecap.js +96 -0
  320. package/kits/physics-3d/engine3d/gait.js +118 -0
  321. package/kits/physics-3d/engine3d/kithooks.js +47 -0
  322. package/kits/physics-3d/engine3d/look.js +507 -48
  323. package/kits/physics-3d/engine3d/lookbake.js +208 -0
  324. package/kits/physics-3d/engine3d/materialpresets.js +2 -0
  325. package/kits/physics-3d/engine3d/motion.js +39 -10
  326. package/kits/physics-3d/engine3d/nearshadows.js +37 -19
  327. package/kits/physics-3d/engine3d/optimize.js +58 -5
  328. package/kits/physics-3d/engine3d/orbitinput.js +755 -0
  329. package/kits/physics-3d/engine3d/orbitlens.js +48 -0
  330. package/kits/physics-3d/engine3d/ownmodel.js +213 -0
  331. package/kits/physics-3d/engine3d/pxmodel.js +42 -11
  332. package/kits/physics-3d/engine3d/shadowfade.js +882 -0
  333. package/kits/physics-3d/engine3d/sky.js +547 -0
  334. package/kits/physics-3d/engine3d/skylife.js +306 -0
  335. package/kits/physics-3d/engine3d/unchanged.js +11 -0
  336. package/kits/physics-3d/engine3d/viewrange.js +52 -0
  337. package/kits/physics-3d/engine3d/world3d.js +870 -87
  338. package/kits/physics-3d/main.jsx +5 -0
  339. package/kits/physics-3d/package.json +1 -1
  340. package/kits/physics-3d/scripts/Player.before-orbit.mjs +310 -0
  341. package/kits/physics-3d/scripts/Scene3DPlayer.before-orbit.jsx +337 -0
  342. package/kits/physics-3d/scripts/look-baseline.mjs +155 -0
  343. package/kits/physics-3d/scripts/test-camera-follow.mjs +12 -2
  344. package/kits/physics-3d/scripts/test-camera-orbit.mjs +4588 -0
  345. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +787 -0
  346. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +435 -0
  347. package/kits/physics-3d/scripts/test-frame-cap.mjs +452 -0
  348. package/kits/physics-3d/scripts/test-gait.mjs +387 -0
  349. package/kits/physics-3d/scripts/test-look-bake.mjs +1056 -0
  350. package/kits/physics-3d/scripts/test-model-parse-cache.mjs +92 -0
  351. package/kits/physics-3d/scripts/test-near-shadows.mjs +3 -0
  352. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +1920 -0
  353. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +545 -0
  354. package/kits/physics-3d/scripts/test-orbit-shot.mjs +583 -0
  355. package/kits/physics-3d/scripts/test-orbit-view.mjs +230 -0
  356. package/kits/physics-3d/scripts/test-skip-empty-nodes.mjs +845 -0
  357. package/kits/physics-3d/scripts/test-sky.mjs +2470 -0
  358. package/kits/physics-3d/scripts/test-static-actors.mjs +13 -1
  359. package/kits/physics-3d/scripts/test-static-passes.mjs +1 -1
  360. package/kits/physics-3d/scripts/test-static-scenery.mjs +2171 -0
  361. package/kits/physics-3d/scripts/test-steady-hover.mjs +635 -0
  362. package/kits/physics-3d/scripts/test-view-range.mjs +260 -0
  363. package/kits/physics-3d/systems/physics3d.js +474 -12
  364. package/kits/real-time/castle.json +2 -2
  365. package/kits/real-time/code/server/gameHooks.js +7 -0
  366. package/kits/real-time/code/server/session.js +97 -19
  367. package/package.json +2 -2
  368. package/dist/shell/assets/index-Cf61cNfT.css +0 -1
@@ -15,6 +15,22 @@
15
15
  // saves the traversal and matrix work as well as the draw. Nothing here
16
16
  // touches colliders, physics, the network, labels or anything another player
17
17
  // sees: it is this client's picture only.
18
+ // A deck may mark an actor in its scene file `"tier": "keep"` (beside `id`,
19
+ // not a component): it is drawn on every tier, whatever it would be called
20
+ // here -- a place's ground is often plain Transform/Shape/Model, and a place
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.
18
34
  //
19
35
  // Where a device starts: low if it was found slow here in the last week
20
36
  // (remembered in localStorage), or its GPU or memory says it is a weak phone;
@@ -23,6 +39,7 @@
23
39
  // over all of it.
24
40
 
25
41
  import { Box3, Sphere } from 'three';
42
+ import { hub, deck } from './state.js';
26
43
 
27
44
  export const TIERS = ['low', 'high'];
28
45
  export const MODES = ['auto', 'low', 'high'];
@@ -169,6 +186,15 @@ const GAMEPLAY = /^Hub|^Town|^Body$|^Ball$|^Player$/;
169
186
  const DECOR = new Set(['Transform', 'Shape', 'Model']);
170
187
  const SCENERY = new Set(['Transform', 'Shape', 'Model', 'Solid', 'Lookable']);
171
188
 
189
+ // The mark a scene file puts on an actor (`"tier": "keep"`, a field of the
190
+ // actor beside `id`) to have it drawn on every tier whatever `classify` says
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.
194
+ export const KEEP = 'keep';
195
+ export const NEAR = 'near';
196
+ export const LOW = 'low';
197
+
172
198
  export function classify(components) {
173
199
  const names = Object.keys(components ?? {});
174
200
  // physics-3d makes an actor's collider block when it has `Solid` or its
@@ -187,6 +213,154 @@ export function classify(components) {
187
213
  return names.every((name) => SCENERY.has(name)) ? 'static' : 'game';
188
214
  }
189
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
+
190
364
  // A node's bounds once, as its middle's offset from the node's position and a
191
365
  // radius: scenery does not change shape, and the offset follows a node the
192
366
  // place moves (a hidden actor waits far below the ground).
@@ -213,13 +387,41 @@ export function makeLevers({ boundsOf = nodeBounds } = {}) {
213
387
  lights: new Set(),
214
388
  // node -> the parent it was taken out of.
215
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(),
216
395
  hidden: 0,
217
396
  bounds: new WeakMap(),
218
397
  // The authored actors of the scene playing: only these are ever hidden
219
- // (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.
220
400
  authored: null,
401
+ distances: null,
221
402
  authoredFor: null,
403
+ // Of those, the ids marked `"tier": "keep"`: exempt from distance/decor.
404
+ // null when the file marks none.
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,
222
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,
223
425
  // The entries taken out on the last look, [actor id, entry]: the engine
224
426
  // replaces an entry in the same map when an actor's look changes
225
427
  // (world3d.js `ensureActorNode`), and the new node is drawn, so these are
@@ -228,14 +430,30 @@ export function makeLevers({ boundsOf = nodeBounds } = {}) {
228
430
  nextAt: 0,
229
431
  };
230
432
 
433
+ const sleeping = new Set();
434
+ const wakeSleeping = () => {
435
+ for (const actor of sleeping) {delete actor.runtime.renderSleep;}
436
+ sleeping.clear();
437
+ };
231
438
  const adopt = (world) => {
232
439
  if (lv.world !== world) {
440
+ wakeSleeping();
233
441
  // A new world: nothing changed on the old one is put back there.
234
442
  lv.world = world;
235
443
  lv.lights = new Set();
236
444
  lv.removed = new WeakMap();
445
+ lv.visibility = new WeakMap();
237
446
  lv.authored = null;
238
447
  lv.authoredFor = null;
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;
239
457
  lv.seen = { path: undefined, nodes: null, size: -1 };
240
458
  lv.watch = [];
241
459
  lv.nextAt = 0;
@@ -258,17 +476,66 @@ export function makeLevers({ boundsOf = nodeBounds } = {}) {
258
476
  if (lv.authoredFor === scene.data && lv.authored) {
259
477
  return lv.authored;
260
478
  }
479
+ wakeSleeping();
261
480
  lv.authoredFor = scene.data;
481
+ const ids = new Set();
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();
262
488
  try {
263
489
  const file = scene.readFromFile(scene.scenePath);
264
- lv.authored = new Set((file?.actors ?? []).map((a) => a.id));
490
+ cells = file?.cells === undefined ? null : readCells(file.cells);
491
+ for (const a of file?.actors ?? []) {
492
+ ids.add(a.id);
493
+ if (Number.isFinite(a.lowDrawDistance) && a.lowDrawDistance > 0) {
494
+ distances.set(a.id, a.lowDrawDistance);
495
+ }
496
+ if (a.tier === KEEP) {
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);
506
+ }
507
+ }
265
508
  } catch {
266
- lv.authored = new Set();
509
+ // A scene that cannot be read has no authored actors: nothing is hidden.
510
+ ids.clear();
511
+ distances.clear();
512
+ kept = null;
513
+ near = null;
514
+ low = null;
515
+ cells = null;
516
+ tagged = null;
517
+ }
518
+ lv.authored = ids;
519
+ lv.distances = distances;
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;
267
526
  }
527
+ lv.cells = cells;
528
+ lv.actorCells = tagged;
268
529
  return lv.authored;
269
530
  };
270
531
 
271
- 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
+ }
272
539
  if (node.parent) {
273
540
  lv.removed.set(node, node.parent);
274
541
  node.parent.remove(node);
@@ -276,6 +543,10 @@ export function makeLevers({ boundsOf = nodeBounds } = {}) {
276
543
  };
277
544
 
278
545
  const unhide = (node) => {
546
+ if (lv.visibility.has(node)) {
547
+ node.visible = lv.visibility.get(node);
548
+ lv.visibility.delete(node);
549
+ }
279
550
  const parent = lv.removed.get(node);
280
551
  if (parent && !node.parent) {
281
552
  parent.add(node);
@@ -283,8 +554,8 @@ export function makeLevers({ boundsOf = nodeBounds } = {}) {
283
554
  lv.removed.delete(node);
284
555
  };
285
556
 
286
- const far = (node, near, cam, sized) => {
287
- 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;
288
559
  let b = { dx: 0, dy: 0, dz: 0, r: 0 };
289
560
  if (sized) {
290
561
  b = lv.bounds.get(node);
@@ -297,65 +568,288 @@ export function makeLevers({ boundsOf = nodeBounds } = {}) {
297
568
  return d > near;
298
569
  };
299
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
+
300
639
  // One look at every node: what should not be drawn is taken out, what should
301
640
  // be is put back.
302
- const pass = (world, scene, actors) => {
303
- 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
+ }
304
647
  const authored = actors ? authoredIds(scene) : null;
305
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() ?? []);
306
655
  const watch = [];
656
+ let cellHidden = 0;
657
+ let back = 0;
658
+ let out = 0;
307
659
  for (const [id, entry] of world.nodes) {
308
660
  const node = entry?.node;
309
- if (!node || entry.instancedRig) {
661
+ if (!node) {
310
662
  continue;
311
663
  }
312
664
  let want = false;
313
- if (authored?.has(id)) {
314
- 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
+ }
315
690
  want =
316
691
  kind === 'decor' ||
317
- (kind === 'static' && far(node, SCENERY_NEAR_M, cam, true)) ||
318
- (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
+ }
319
707
  }
320
708
  if (want) {
321
- hide(node);
709
+ if (node.parent) {
710
+ out += 1;
711
+ }
712
+ hide(node, entry.instancedRig && (!isLow || lv.low?.has(id)));
322
713
  if (!node.parent) {
323
714
  watch.push([id, entry]);
715
+ cellHidden += cellOut ? 1 : 0;
324
716
  }
325
717
  } else if (lv.removed.has(node)) {
718
+ back += node.parent ? 0 : 1;
326
719
  unhide(node);
327
720
  }
328
721
  }
329
722
  lv.watch = watch;
330
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
+ }
331
732
  };
332
733
 
333
734
  // Whether a node taken out was replaced (a rebuild) or put back since.
334
735
  const watchBroken = (world) => {
335
736
  for (const [id, entry] of lv.watch) {
336
- 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)) {
337
738
  return true;
338
739
  }
339
740
  }
340
741
  return false;
341
742
  };
342
743
 
343
- // 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
344
772
  // once when the engine swapped or rebuilt them (another scene, nodes parked
345
- // or put back, actors come or gone). `actors` false (a game reached through
346
- // a door: another deck's content) puts every node back and keeps only the
347
- // shadow lever.
348
- lv.apply = (world, scene, now, { actors = true } = {}) => {
773
+ // or put back, actors come or gone, the scene loaded again: new scene data
774
+ // may carry other `tier` marks over the same nodes). `actors` false (a game reached through
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 } = {}) => {
349
778
  adopt(world);
350
- 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
+ }
351
811
  const seen = lv.seen;
352
- const changed = world.scenePath !== seen.path || world.nodes !== seen.nodes || world.nodes.size !== seen.size || watchBroken(world);
353
- 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) {
354
828
  return;
355
829
  }
356
- lv.seen = { path: world.scenePath, nodes: world.nodes, size: world.nodes.size, 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
+ };
357
840
  lv.nextAt = now + CHECK_EVERY_MS;
358
- 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;
359
853
  };
360
854
 
361
855
  // Back to the picture as authored: every node taken out of the scene put
@@ -363,17 +857,25 @@ export function makeLevers({ boundsOf = nodeBounds } = {}) {
363
857
  // left to the engine), every shadow on again.
364
858
  lv.restore = (world) => {
365
859
  adopt(world);
860
+ wakeSleeping();
861
+ skyOff(null);
366
862
  for (const entry of world.nodes.values()) {
367
863
  if (entry?.node && lv.removed.has(entry.node)) {
368
864
  unhide(entry.node);
369
865
  }
370
866
  }
371
867
  lv.removed = new WeakMap();
868
+ lv.visibility = new WeakMap();
372
869
  for (const light of lv.lights) {
373
870
  light.castShadow = true;
374
871
  }
375
872
  lv.lights.clear();
376
873
  lv.hidden = 0;
874
+ lv.cellHidden = 0;
875
+ lv.cell = null;
876
+ lv.cellKey = null;
877
+ lv.pop = null;
878
+ dropOverlay();
377
879
  lv.watch = [];
378
880
  lv.active = false;
379
881
  lv.seen = { path: undefined, nodes: null, size: -1 };
@@ -452,11 +954,14 @@ export function makeTiers({ storage = pageStorage(), clock = () => Date.now(), d
452
954
  }
453
955
  if (t.current() === 'low') {
454
956
  levers.apply(world, scene, now, { actors: !scene.content });
455
- } else if (levers.active) {
957
+ } else {
456
958
  // Low to High costs a one-off stall (about 1 s on the phones measured)
457
959
  // as three.js recompiles its shader programs for the shadows coming
458
960
  // back. Acceptable: auto never moves up, only a player's pick does.
459
- levers.restore(world);
961
+ if (levers.active) {
962
+ levers.restore(world);
963
+ }
964
+ levers.high?.(world, scene, now, { actors: !scene.content });
460
965
  }
461
966
  };
462
967
 
@@ -474,6 +979,15 @@ export function makeTiers({ storage = pageStorage(), clock = () => Date.now(), d
474
979
  get hidden() {
475
980
  return levers.hidden;
476
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),
477
991
  set: (mode) => t.set(mode),
478
992
  };
479
993
  return t;