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
@@ -2,17 +2,22 @@
2
2
  // GPU, its memory, a slow visit remembered for a week), the frame-time judge
3
3
  // (median windows, never back up, hidden pages and swaps ignored), storage that
4
4
  // throws, the player's own Auto / Low / High winning, and the low picture's
5
- // levers put on and taken off exactly on a fake physics-3d world. Last, the hub
5
+ // levers put on and taken off exactly on a fake physics-3d world (with the
6
+ // scene file's `"tier": "keep"` mark: an actor drawn on every tier). Last, the hub
6
7
  // system with the deck's `hub.tiers` absent: nothing of the tiers is made, run
7
8
  // or read. `npm run check` runs this.
8
9
 
9
10
  import assert from 'node:assert/strict';
10
11
  import fs from 'node:fs';
11
12
  import { register } from 'node:module';
13
+ import { clear as clearState, hub, mergeHidden } from '../code/client/state.js';
12
14
  import {
13
15
  CHECK_EVERY_MS,
14
16
  FIRST_WINDOW_MS,
17
+ KEEP,
18
+ LOW,
15
19
  MODE_KEY,
20
+ NEAR,
16
21
  REMEMBER_MS,
17
22
  TIER_KEY,
18
23
  WINDOW_MS,
@@ -358,7 +363,8 @@ function fakeWorld(actors) {
358
363
  content: null,
359
364
  data: {},
360
365
  scenePath: 'scenes/main.scene',
361
- readFromFile: () => ({ actors: actors.filter((a) => !a.spawned).map((a) => ({ id: a.id })) }),
366
+ // The scene file: an actor's id and, where it has one, its `tier` mark.
367
+ readFromFile: () => ({ actors: actors.filter((a) => !a.spawned).map((a) => ('tier' in a ? { id: a.id, tier: a.tier } : { id: a.id })) }),
362
368
  getActor: (id) => byId.get(id),
363
369
  };
364
370
  return { world, scene, sun, sky, touched, parents: () => new Map([...world.nodes].map(([id, e]) => [id, e.node.parent])) };
@@ -579,6 +585,439 @@ test('levers: a hidden node the engine rebuilds in place is taken out at once (r
579
585
  assert.equal(drawn(world, 'npc-far'), false);
580
586
  });
581
587
 
588
+ // `"tier": "keep"` on an actor in the scene file: drawn on every tier.
589
+
590
+ const GROUND = { Transform: {}, Shape: {}, Model: {} };
591
+ const WALL = { Transform: {}, Shape: {}, Solid: {} };
592
+ const NPC = { Transform: {}, Body: {}, HubNpc: {}, Model: {} };
593
+ const MARKED = [
594
+ { id: 'paving', components: GROUND, at: [0, 0, 0], tier: 'keep' },
595
+ { id: 'grass-far', components: GROUND, at: [90, 0, 0], tier: 'keep' },
596
+ { id: 'tower-far', components: WALL, at: [70, 0, 0], tier: 'keep' },
597
+ { id: 'guide-far', components: NPC, at: [0, 0, 40], tier: 'keep' },
598
+ // Unmarked, and marked with something that is no mark: as before.
599
+ { id: 'lamp', components: GROUND, at: [3, 0, 3] },
600
+ { id: 'wall-near', components: WALL, at: [10, 0, 0] },
601
+ { id: 'wall-far', components: WALL, at: [60, 0, 0] },
602
+ { id: 'npc-far', components: NPC, at: [0, 0, 25] },
603
+ { id: 'vase', components: GROUND, at: [2, 0, 2], tier: 'unknown' },
604
+ { id: 'urn', components: GROUND, at: [2, 0, 4], tier: true },
605
+ { id: 'pot', components: GROUND, at: [2, 0, 6], tier: 'Keep' },
606
+ { id: 'bush', components: GROUND, at: [2, 0, 8], tier: null },
607
+ // A spawned actor is not in the file: never hidden, mark or none.
608
+ { id: 'wear:p1:0', components: GROUND, at: [1, 0, 1], spawned: true },
609
+ ];
610
+
611
+ test('keep: a marked actor is drawn on Low whatever it is; unmarked ones and other values are as before', () => {
612
+ assert.equal(KEEP, 'keep');
613
+ const { world, scene } = fakeWorld(MARKED);
614
+ const lv = makeLevers({ boundsOf: bounds(0) });
615
+ lv.apply(world, scene, 0);
616
+ assert.equal(drawn(world, 'paving'), true, 'marked decor is drawn');
617
+ assert.equal(drawn(world, 'grass-far'), true, 'at any distance');
618
+ assert.equal(drawn(world, 'tower-far'), true, 'marked scenery past 30 m stays');
619
+ assert.equal(drawn(world, 'guide-far'), true, 'a marked NPC body past 20 m stays');
620
+ assert.equal(drawn(world, 'lamp'), false);
621
+ assert.equal(drawn(world, 'wall-near'), true);
622
+ assert.equal(drawn(world, 'wall-far'), false);
623
+ assert.equal(drawn(world, 'npc-far'), false);
624
+ for (const id of ['vase', 'urn', 'pot', 'bush']) {
625
+ assert.equal(drawn(world, id), false, `${id}: only "keep" is the mark`);
626
+ }
627
+ assert.equal(drawn(world, 'wear:p1:0'), true);
628
+ assert.equal(lv.hidden, 7);
629
+ assert.deepEqual([...lv.kept].sort(), ['grass-far', 'guide-far', 'paving', 'tower-far']);
630
+ // The next looks keep them, from wherever the camera stands.
631
+ world.camera.position = { x: -200, y: 2, z: -200 };
632
+ lv.apply(world, scene, CHECK_EVERY_MS + 1);
633
+ for (const id of ['paving', 'grass-far', 'tower-far', 'guide-far']) {
634
+ assert.equal(drawn(world, id), true, id);
635
+ }
636
+ assert.equal(drawn(world, 'wall-near'), false, 'unmarked scenery now far is not');
637
+ });
638
+
639
+ test('keep: High, Low, High leaves every node attached where it was', () => {
640
+ const { world, scene, parents } = fakeWorld(MARKED);
641
+ const before = parents();
642
+ const t = makeTiers({ storage: memoryStorage(), deviceMemory: 8, levers: makeLevers({ boundsOf: bounds(0) }) });
643
+ const s = { ...scene, three: world };
644
+ let now = 0;
645
+ const frames = () => {
646
+ for (let i = 0; i < 3; i += 1) {
647
+ t.frame(s, true, (now += 16));
648
+ }
649
+ };
650
+ t.handle.set('high');
651
+ frames();
652
+ assert.deepEqual(parents(), before);
653
+ t.handle.set('low');
654
+ frames();
655
+ assert.equal(drawn(world, 'paving'), true);
656
+ assert.equal(drawn(world, 'tower-far'), true);
657
+ assert.equal(drawn(world, 'lamp'), false);
658
+ assert.equal(t.handle.hidden, 7);
659
+ t.handle.set('high');
660
+ frames();
661
+ assert.deepEqual(parents(), before, 'everything attached again');
662
+ assert.equal(t.handle.hidden, 0);
663
+ });
664
+
665
+ test('keep: a scene with no marks keeps no list and reads its file as often as before', () => {
666
+ const { world, scene } = fakeWorld(TOWN);
667
+ let reads = 0;
668
+ scene.readFromFile = ((read) => (path) => {
669
+ reads += 1;
670
+ return read(path);
671
+ })(scene.readFromFile);
672
+ const lv = makeLevers({ boundsOf: bounds(0) });
673
+ lv.apply(world, scene, 0);
674
+ assert.equal(lv.kept, null, 'no set is made');
675
+ assert.equal(lv.hidden, 3, 'what the town hid before');
676
+ for (let i = 1; i <= 5; i += 1) {
677
+ lv.apply(world, scene, i * (CHECK_EVERY_MS + 1));
678
+ }
679
+ assert.equal(reads, 1, 'the file is read once per scene, marks and ids together');
680
+ assert.equal(lv.kept, null);
681
+ // A scene whose file cannot be read hides nothing and keeps no list.
682
+ const broken = fakeWorld(MARKED);
683
+ broken.scene.readFromFile = () => {
684
+ throw new Error('scene file not found');
685
+ };
686
+ const lv2 = makeLevers({ boundsOf: bounds(0) });
687
+ lv2.apply(broken.world, broken.scene, 0);
688
+ assert.equal(lv2.hidden, 0);
689
+ assert.equal(lv2.kept, null);
690
+ });
691
+
692
+ test('keep: the marks follow the scene -- one hidden is put back when marked, another scene has its own, another world none', () => {
693
+ const actors = MARKED.map((a) => ({ ...a }));
694
+ const { world, scene } = fakeWorld(actors);
695
+ let reads = 0;
696
+ scene.readFromFile = ((read) => (path) => {
697
+ reads += 1;
698
+ return read(path);
699
+ })(scene.readFromFile);
700
+ const lv = makeLevers({ boundsOf: bounds(0) });
701
+ lv.apply(world, scene, 0);
702
+ assert.equal(drawn(world, 'lamp'), false);
703
+ assert.equal(drawn(world, 'paving'), true);
704
+ // The scene loaded again (new scene data) with the marks moved: the lamp
705
+ // gains one and is put back, the paving loses its and goes.
706
+ actors.find((a) => a.id === 'lamp').tier = 'keep';
707
+ delete actors.find((a) => a.id === 'paving').tier;
708
+ lv.apply(world, scene, CHECK_EVERY_MS + 1);
709
+ assert.equal(drawn(world, 'lamp'), false, 'the same scene data: the file is not read again');
710
+ assert.equal(reads, 1);
711
+ scene.data = {};
712
+ lv.apply(world, scene, 2 * (CHECK_EVERY_MS + 1));
713
+ assert.equal(reads, 2);
714
+ assert.equal(drawn(world, 'lamp'), true, 'hidden before, marked now: put back');
715
+ assert.equal(drawn(world, 'paving'), false, 'no longer marked: decor again');
716
+ assert.equal(drawn(world, 'tower-far'), true);
717
+ // Another scene with no marks at all: the list is dropped.
718
+ for (const a of actors) {
719
+ delete a.tier;
720
+ }
721
+ scene.data = {};
722
+ world.scenePath = 'scenes/other.scene';
723
+ lv.apply(world, scene, 3 * (CHECK_EVERY_MS + 1));
724
+ assert.equal(lv.kept, null);
725
+ assert.equal(drawn(world, 'lamp'), false);
726
+ assert.equal(drawn(world, 'tower-far'), false);
727
+ assert.equal(drawn(world, 'guide-far'), false);
728
+ // A game through a door (another deck's content) hides nothing either way.
729
+ lv.apply(world, scene, 4 * (CHECK_EVERY_MS + 1), { actors: false });
730
+ assert.equal(lv.hidden, 0);
731
+ // Another world starts with no marks remembered.
732
+ const other = fakeWorld(TOWN);
733
+ lv.kept = new Set(['lamp']);
734
+ lv.apply(other.world, other.scene, 5 * (CHECK_EVERY_MS + 1));
735
+ assert.equal(lv.kept, null);
736
+ assert.equal(drawn(other.world, 'lamp'), false);
737
+ });
738
+
739
+ test('keep: a reload that adds the mark puts the node back on the very next frame, not at the next look (review P2)', () => {
740
+ const actors = MARKED.map((a) => ({ ...a }));
741
+ const { world, scene } = fakeWorld(actors);
742
+ const lv = makeLevers({ boundsOf: bounds(0) });
743
+ lv.apply(world, scene, 0);
744
+ assert.equal(drawn(world, 'lamp'), false);
745
+ assert.equal(drawn(world, 'paving'), true);
746
+ const nodes = world.nodes;
747
+ const size = nodes.size;
748
+ // The same scene loaded again: the same path, the same nodes map and
749
+ // nodes, new scene data, and the file now marks the lamp and not the paving.
750
+ actors.find((a) => a.id === 'lamp').tier = 'keep';
751
+ delete actors.find((a) => a.id === 'paving').tier;
752
+ scene.data = {};
753
+ lv.apply(world, scene, 16);
754
+ assert.equal(world.nodes, nodes);
755
+ assert.equal(world.nodes.size, size);
756
+ assert.equal(drawn(world, 'lamp'), true, 'back 16 ms later, well inside the 500 ms');
757
+ assert.equal(drawn(world, 'paving'), false, 'and the one no longer marked is out');
758
+ // With the scene data unchanged the next frames wait for the look as before.
759
+ let reads = 0;
760
+ scene.readFromFile = ((read) => (path) => {
761
+ reads += 1;
762
+ return read(path);
763
+ })(scene.readFromFile);
764
+ world.camera.position = { x: 60, y: 2, z: 0 };
765
+ lv.apply(world, scene, 32);
766
+ lv.apply(world, scene, 48);
767
+ assert.equal(drawn(world, 'wall-far'), false, 'no look between looks');
768
+ assert.equal(reads, 0);
769
+ lv.apply(world, scene, 16 + CHECK_EVERY_MS + 1);
770
+ assert.equal(drawn(world, 'wall-far'), true);
771
+ });
772
+
773
+ test('near: gameplay uses the sized 30 m test on Low, an identical unmarked actor stays drawn', () => {
774
+ const components = { Transform: {}, Shape: {}, TownStatue: {} };
775
+ assert.equal(classify(components), 'game');
776
+ const { world, scene } = fakeWorld([
777
+ { id: 'marked', tier: NEAR, components, at: [40, 2, 0] },
778
+ { id: 'plain', components, at: [40, 2, 0] },
779
+ ]);
780
+ const lv = makeLevers({ boundsOf: bounds(5) });
781
+ lv.apply(world, scene, 0);
782
+ assert.equal(drawn(world, 'marked'), false, 'bounds are 35 m away');
783
+ assert.equal(drawn(world, 'plain'), true);
784
+ world.camera.position.x = 5;
785
+ lv.apply(world, scene, CHECK_EVERY_MS);
786
+ assert.equal(drawn(world, 'marked'), true, 'bounds exactly 30 m away are drawn');
787
+ assert.equal(drawn(world, 'plain'), true);
788
+ world.camera.position.x = 10;
789
+ lv.apply(world, scene, 2 * CHECK_EVERY_MS);
790
+ assert.equal(drawn(world, 'marked'), true, 'bounds within 30 m');
791
+ world.camera.position.x = 0;
792
+ lv.apply(world, scene, 3 * CHECK_EVERY_MS);
793
+ assert.equal(drawn(world, 'marked'), false, 'walking away takes it out again');
794
+ assert.equal(drawn(world, 'plain'), true);
795
+ });
796
+
797
+ test('near: High never hides it and restores it after Low', () => {
798
+ const { world, scene, parents } = fakeWorld([
799
+ { id: 'marked', tier: NEAR, components: { Transform: {}, TownStatue: {} }, at: [80, 2, 0] },
800
+ ]);
801
+ const before = parents();
802
+ const t = makeTiers({ storage: memoryStorage(), deviceMemory: 8, levers: makeLevers({ boundsOf: bounds(0) }) });
803
+ const s = { ...scene, three: world };
804
+ t.handle.set('high');
805
+ t.frame(s, true, 0);
806
+ assert.deepEqual(parents(), before);
807
+ t.handle.set('low');
808
+ t.frame(s, true, 16);
809
+ assert.equal(drawn(world, 'marked'), false);
810
+ t.handle.set('high');
811
+ t.frame(s, true, 32);
812
+ assert.deepEqual(parents(), before);
813
+ t.frame(s, true, 1000);
814
+ assert.deepEqual(parents(), before);
815
+ });
816
+
817
+ test('near: decor becomes scenery, NPCs keep their own distance rule, keep wins', () => {
818
+ const actors = [
819
+ { id: 'decor', tier: NEAR, components: { Transform: {}, Model: {} }, at: [10, 2, 0] },
820
+ { id: 'npc', tier: NEAR, components: { HubNpc: {} }, at: [25, 2, 0] },
821
+ { id: 'kept', tier: KEEP, components: { TownStatue: {} }, at: [80, 2, 0] },
822
+ ];
823
+ const { world, scene } = fakeWorld(actors);
824
+ const lv = makeLevers({ boundsOf: bounds(10) });
825
+ lv.apply(world, scene, 0);
826
+ assert.equal(drawn(world, 'decor'), true, 'near decor is drawn');
827
+ assert.equal(drawn(world, 'npc'), false, 'NPCs still use 20 m without a sized test');
828
+ assert.equal(drawn(world, 'kept'), true);
829
+ assert.equal(lv.near.has('kept'), false, 'the scene mark is keep or near, never both');
830
+ // Even overlapping internal lists must not hide a kept actor.
831
+ lv.near.add('kept');
832
+ lv.apply(world, scene, CHECK_EVERY_MS);
833
+ assert.equal(drawn(world, 'kept'), true);
834
+ actors[0].tier = KEEP;
835
+ scene.data = {};
836
+ world.camera.position.x = -100;
837
+ lv.apply(world, scene, CHECK_EVERY_MS + 16);
838
+ assert.equal(drawn(world, 'decor'), true, 'a reload replaces near with keep');
839
+ assert.equal(lv.near.has('decor'), false);
840
+ });
841
+
842
+ test('near: lists are absent without marks, cleared after a read failure and on a new world', () => {
843
+ const actors = [{ id: 'marked', tier: NEAR, components: { TownStatue: {} }, at: [80, 2, 0] }];
844
+ const { world, scene } = fakeWorld(actors);
845
+ const lv = makeLevers({ boundsOf: bounds(0) });
846
+ lv.apply(world, scene, 0);
847
+ assert.equal(drawn(world, 'marked'), false);
848
+ scene.data = {};
849
+ scene.readFromFile = () => { throw new Error('unreadable'); };
850
+ lv.apply(world, scene, 16);
851
+ assert.equal(lv.near, null);
852
+ assert.equal(drawn(world, 'marked'), true);
853
+ const other = fakeWorld(TOWN);
854
+ lv.near = new Set(['door']);
855
+ lv.apply(other.world, other.scene, 32);
856
+ assert.equal(lv.near, null);
857
+ assert.equal(drawn(other.world, 'door'), true);
858
+ });
859
+
860
+ // As SceneRuntime has it: `sky` a getter on the prototype, never an own field.
861
+ const SKY_KEY = { zones: [] };
862
+ function keyedScene(scene, world, key = SKY_KEY) {
863
+ const s = Object.create({
864
+ get sky() {
865
+ return this.key;
866
+ },
867
+ });
868
+ return Object.assign(s, scene, { three: world, key });
869
+ }
870
+
871
+ test('low: High removes only the low actor; Low draws it at any distance and skips the kit sky in the same frame', () => {
872
+ const { world, scene, sun } = fakeWorld([
873
+ { id: 'cone', tier: LOW, components: GROUND, at: [900, 0, 0] },
874
+ { id: 'kept', tier: KEEP, components: GROUND, at: [900, 0, 0] },
875
+ { id: 'near', tier: NEAR, components: WALL, at: [80, 0, 0] },
876
+ { id: 'plain', components: GROUND },
877
+ ]);
878
+ const parent = world.nodes.get('cone').node.parent;
879
+ const t = makeTiers({
880
+ storage: memoryStorage(),
881
+ deviceMemory: 8,
882
+ levers: makeLevers({ boundsOf: bounds(0) }),
883
+ });
884
+ const s = keyedScene(scene, world);
885
+ t.set('high');
886
+ t.frame(s, true, 0);
887
+ assert.equal(drawn(world, 'cone'), false);
888
+ for (const id of ['kept', 'near', 'plain']) assert.equal(drawn(world, id), true, id);
889
+ assert.equal(s.sky, SKY_KEY);
890
+ assert.equal(Object.hasOwn(s, 'sky'), false, 'High puts nothing on the runtime');
891
+ assert.equal(sun.castShadow, true);
892
+ t.set('low');
893
+ t.frame(s, true, 16);
894
+ assert.equal(
895
+ world.nodes.get('cone').node.parent,
896
+ parent,
897
+ 'original parent restored inside the look interval',
898
+ );
899
+ assert.equal(s.sky, null, 'kit sky skipped the same frame');
900
+ assert.equal(drawn(world, 'kept'), true);
901
+ assert.equal(drawn(world, 'near'), false);
902
+ assert.equal(drawn(world, 'plain'), false);
903
+ t.set('high');
904
+ t.frame(s, true, 32);
905
+ assert.equal(drawn(world, 'cone'), false);
906
+ assert.equal(s.sky, SKY_KEY, 'the getter answers again');
907
+ assert.equal(Object.hasOwn(s, 'sky'), false);
908
+ for (const id of ['kept', 'near', 'plain']) assert.equal(drawn(world, id), true, id);
909
+ // Actor rebuilds and parked nodes put back by the engine are caught on High.
910
+ world.nodes.get('cone').node = new Obj('rebuilt');
911
+ world.scene.add(world.nodes.get('cone').node);
912
+ t.frame(s, true, 48);
913
+ assert.equal(drawn(world, 'cone'), false);
914
+ s.data = {};
915
+ s.readFromFile = () => ({ actors: [{ id: 'cone', tier: KEEP }] });
916
+ t.frame(s, true, 64);
917
+ assert.equal(drawn(world, 'cone'), true, 'a reload dropping the low mark restores it');
918
+ });
919
+
920
+ test('low: auto judge flips cone and kit sky together; keyed scene changes and door content do not leak the flag', () => {
921
+ const { world, scene } = fakeWorld([{ id: 'cone', tier: LOW, components: GROUND }]);
922
+ const t = makeTiers({
923
+ storage: memoryStorage(),
924
+ deviceMemory: 8,
925
+ levers: makeLevers({ boundsOf: bounds(0) }),
926
+ });
927
+ const s = keyedScene(scene, world);
928
+ t.frame(s, true, 0);
929
+ assert.equal(drawn(world, 'cone'), false);
930
+ for (let now = 50; now <= FIRST_WINDOW_MS; now += 50) t.frame(s, true, now);
931
+ assert.equal(t.current(), 'low');
932
+ assert.equal(drawn(world, 'cone'), true);
933
+ assert.equal(s.sky, null);
934
+ // A load to a keyless scene and back to a keyed one: off throughout, so
935
+ // the frame of the keyed load (drawn before tiers run again) has no sky.
936
+ s.key = null;
937
+ t.frame(s, true, FIRST_WINDOW_MS + 16);
938
+ assert.equal(s.sky, null);
939
+ s.key = SKY_KEY;
940
+ assert.equal(s.sky, null, 'a keyed scene loaded on Low has no sky before tiers run again');
941
+ s.content = {};
942
+ t.frame(s, true, FIRST_WINDOW_MS + 32);
943
+ assert.equal(s.sky, null, 'Low skips a game scene sky too');
944
+ t.set('high');
945
+ t.frame(s, true, FIRST_WINDOW_MS + 48);
946
+ assert.equal(drawn(world, 'cone'), true, 'another deck content is not tier-mark culled');
947
+ assert.equal(s.sky, SKY_KEY);
948
+ assert.equal(Object.hasOwn(s, 'sky'), false);
949
+ });
950
+
951
+ test('low: shared model instances also stop drawing on High and restore authored visibility on Low', () => {
952
+ const { world, scene } = fakeWorld([{ id: 'cone', tier: LOW, components: GROUND }]);
953
+ const entry = world.nodes.get('cone');
954
+ entry.instancedRig = {};
955
+ entry.node.visible = true;
956
+ const t = makeTiers({ storage: memoryStorage(), deviceMemory: 8, levers: makeLevers({ boundsOf: bounds(0) }) });
957
+ const s = { ...scene, three: world };
958
+ t.set('high');
959
+ t.frame(s, true, 0);
960
+ assert.equal(drawn(world, 'cone'), false);
961
+ assert.equal(entry.node.visible, false, 'shared instances read ancestor visibility outside the graph');
962
+ entry.node.visible = true;
963
+ t.frame(s, true, 8);
964
+ assert.equal(entry.node.visible, false, 'caught within the look interval');
965
+ t.set('low');
966
+ t.frame(s, true, 16);
967
+ assert.equal(drawn(world, 'cone'), true);
968
+ assert.equal(entry.node.visible, true);
969
+ entry.node.visible = false;
970
+ t.set('high');
971
+ t.frame(s, true, 32);
972
+ t.set('low');
973
+ t.frame(s, true, 48);
974
+ assert.equal(entry.node.visible, false, 'an authored invisible root stays invisible');
975
+ });
976
+
977
+ test('low: the actor mark works without engine.sky; spawned marks remain untouched', () => {
978
+ const { world, scene } = fakeWorld([
979
+ { id: 'cone', tier: LOW, components: GROUND, at: [900, 0, 0] },
980
+ { id: 'spawned', tier: LOW, components: GROUND, spawned: true },
981
+ ]);
982
+ const t = makeTiers({ storage: memoryStorage(), deviceMemory: 8, levers: makeLevers({ boundsOf: bounds(0) }) });
983
+ const s = { ...scene, three: world };
984
+ t.set('high');
985
+ t.frame(s, true, 0);
986
+ assert.equal(drawn(world, 'cone'), false);
987
+ assert.equal(drawn(world, 'spawned'), true);
988
+ t.set('low');
989
+ t.frame(s, true, 16);
990
+ assert.equal(drawn(world, 'cone'), true);
991
+ assert.equal(drawn(world, 'spawned'), true);
992
+ });
993
+
994
+ test('low: keyless, unmarked scenes have the previous graph and no world flag', () => {
995
+ const old = fakeWorld(TOWN);
996
+ const next = fakeWorld(TOWN);
997
+ const lv = makeLevers({ boundsOf: bounds(0) });
998
+ const t = makeTiers({
999
+ storage: memoryStorage(),
1000
+ deviceMemory: 8,
1001
+ levers: makeLevers({ boundsOf: bounds(0) }),
1002
+ });
1003
+ const s = keyedScene(next.scene, next.world, null);
1004
+ const picture = (world) => [...world.nodes].map(([id, e]) => [id, Boolean(e.node.parent)]);
1005
+ t.frame(s, true, 0);
1006
+ assert.deepEqual(picture(next.world), picture(old.world), 'High has the original graph');
1007
+ t.set('low');
1008
+ t.frame(s, true, 16);
1009
+ lv.apply(old.world, old.scene, 16);
1010
+ assert.deepEqual(picture(next.world), picture(old.world), 'Low has the same culling');
1011
+ assert.equal(t.levers.low, null);
1012
+ assert.equal(s.sky, null, 'a keyless scene reads no sky, as before');
1013
+ assert.deepEqual(Object.keys(s), Object.keys(keyedScene(next.scene, next.world, null)), 'nothing enumerable is added');
1014
+ t.set('high');
1015
+ t.frame(s, true, 32);
1016
+ lv.restore(old.world);
1017
+ assert.deepEqual(picture(next.world), picture(old.world), 'restored High has the same graph');
1018
+ assert.equal(Object.hasOwn(s, 'sky'), false, 'and the runtime is as it was');
1019
+ });
1020
+
582
1021
  // The hub system with `hub.tiers` absent: never a call into tiers.js, never a
583
1022
  // storage read, no harness handle. tiers.js is stubbed for hub.js so any call
584
1023
  // is counted.
@@ -594,6 +1033,8 @@ const url = (src) => 'data:text/javascript,' + encodeURIComponent(src);
594
1033
  register(
595
1034
  url(`
596
1035
  export async function resolve(specifier, context, next) {
1036
+ if (['pxmodel', 'optimize', 'look', 'lookbake'].some((m) => specifier === '@imports/castle.physics-3d/engine3d/' + m)) return { url: ${JSON.stringify(new URL('./fixtures/engine-models-stub.mjs', import.meta.url).href)}, shortCircuit: true };
1037
+ if (specifier === '@imports/castle.physics-3d/engine3d/orbitlens.js') return { url: ${JSON.stringify(new URL('../../physics-3d/engine3d/orbitlens.js', import.meta.url).href)}, shortCircuit: true };
597
1038
  if (specifier === 'castle-web-sdk') return { url: ${JSON.stringify(url(sdkStub))}, shortCircuit: true };
598
1039
  if (specifier.startsWith('@imports/castle.physics-2d/engine/')) return { url: ${JSON.stringify(url(mediaStub))}, shortCircuit: true };
599
1040
  if (specifier === '../client/pack.js') return { url: ${JSON.stringify(url(packStub))}, shortCircuit: true };
@@ -604,6 +1045,219 @@ register(
604
1045
  const { installSystem } = await import('../code/systems/hub.js');
605
1046
  const { deck } = await import('../code/client/state.js');
606
1047
 
1048
+ // Match the frame order: applyVisibility lifts/drops the actor Transform,
1049
+ // tiers decide attachment, then the engine syncs node positions for drawing.
1050
+ function visibilityWorld(actors, mode = 'low') {
1051
+ const setup = fakeWorld(actors);
1052
+ const scene = { ...setup.scene, three: setup.world };
1053
+ let system;
1054
+ installSystem({ registerSystem: (s) => (system = s) });
1055
+ system.stash = new Map();
1056
+ const lv = makeLevers({ boundsOf: bounds(0) });
1057
+ const tiers = makeTiers({ storage: memoryStorage(), deviceMemory: 8, levers: lv });
1058
+ tiers.set(mode);
1059
+ const frame = (now) => {
1060
+ system.applyVisibility(scene);
1061
+ tiers.frame(scene, true, now);
1062
+ for (const [id, { node }] of setup.world.nodes) {
1063
+ const at = scene.getActor(id)?.components.Transform;
1064
+ if (at) {
1065
+ node.position = { ...node.position, ...at };
1066
+ }
1067
+ }
1068
+ };
1069
+ return { ...setup, scene, lv, tiers, frame };
1070
+ }
1071
+
1072
+ function visibilityTest(name, fn) {
1073
+ test(name, () => {
1074
+ clearState();
1075
+ try {
1076
+ fn();
1077
+ } finally {
1078
+ clearState();
1079
+ }
1080
+ });
1081
+ }
1082
+
1083
+ const hiddenActor = (id, extra = {}, at = [10, 2, 0]) => ({
1084
+ id,
1085
+ at,
1086
+ components: { Transform: { x: at[0], y: at[1], z: at[2] }, Shape: {}, Solid: {}, ...extra },
1087
+ });
1088
+
1089
+ visibilityTest('place hidden: out then back to the same parent in the frame of each merge', () => {
1090
+ const actor = hiddenActor('trophy', { TownWardrobeItem: {} });
1091
+ assert.equal(classify(actor.components), 'game');
1092
+ const { world, scene, lv, frame } = visibilityWorld([actor]);
1093
+ const node = world.nodes.get(actor.id).node;
1094
+ const parent = new Obj('wardrobe');
1095
+ world.scene.add(parent);
1096
+ parent.add(node);
1097
+ node.add(new Obj('model'));
1098
+ frame(0);
1099
+ assert.equal(node.parent, parent);
1100
+ hub.hiddenAll.add(actor.id);
1101
+ mergeHidden();
1102
+ frame(16);
1103
+ assert.equal(node.parent, null, 'out inside the periodic look interval');
1104
+ assert.equal(parent.children.includes(node), false, 'whole subtree leaves the graph');
1105
+ assert.equal(lv.removed.get(node), parent);
1106
+ assert.equal(actor.components.Transform.y, -9998);
1107
+ hub.hiddenAll.clear();
1108
+ mergeHidden();
1109
+ frame(32);
1110
+ assert.equal(node.parent, parent, 'back in the frame applyVisibility lifts it');
1111
+ assert.equal(actor.components.Transform.y, 2);
1112
+ assert.equal(node.position.y, 2);
1113
+ assert.equal(lv.removed.has(node), false);
1114
+ assert.equal(scene.getActor(actor.id), actor, 'actor and its components remain');
1115
+ });
1116
+
1117
+ visibilityTest('place hidden: a shared hide overridden by shownMe stays in, a private hide takes it out', () => {
1118
+ const { world, frame } = visibilityWorld([hiddenActor('trophy')]);
1119
+ frame(0);
1120
+ hub.hiddenAll.add('trophy');
1121
+ hub.shownMe.add('trophy');
1122
+ mergeHidden();
1123
+ frame(16);
1124
+ assert.equal(drawn(world, 'trophy'), true);
1125
+ hub.hiddenMe.add('trophy');
1126
+ mergeHidden();
1127
+ frame(32);
1128
+ assert.equal(drawn(world, 'trophy'), false, 'private hide wins the merge');
1129
+ hub.hiddenMe.clear();
1130
+ mergeHidden();
1131
+ frame(48);
1132
+ assert.equal(drawn(world, 'trophy'), true);
1133
+ });
1134
+
1135
+ visibilityTest('place hidden: keep and NPCs go out, then retain their existing rules when shown', () => {
1136
+ const { world, frame } = visibilityWorld([
1137
+ { ...hiddenActor('kept', {}, [80, 2, 0]), tier: KEEP },
1138
+ hiddenActor('npc', { HubNpc: {}, Body: {} }),
1139
+ ]);
1140
+ frame(0);
1141
+ hub.hiddenAll = new Set(['kept', 'npc']);
1142
+ mergeHidden();
1143
+ frame(16);
1144
+ assert.equal(drawn(world, 'kept'), false);
1145
+ assert.equal(drawn(world, 'npc'), false);
1146
+ hub.hiddenAll.clear();
1147
+ mergeHidden();
1148
+ frame(32);
1149
+ assert.equal(drawn(world, 'kept'), true, 'keep exempts distance again');
1150
+ assert.equal(drawn(world, 'npc'), true, 'near NPC lifted this frame');
1151
+ });
1152
+
1153
+ visibilityTest('place hidden: showing while far stays out, showing within range uses the lifted Transform', () => {
1154
+ const actor = hiddenActor('wall', {}, [60, 2, 0]);
1155
+ const { world, frame } = visibilityWorld([actor]);
1156
+ frame(0);
1157
+ hub.hiddenAll.add(actor.id);
1158
+ mergeHidden();
1159
+ frame(16);
1160
+ assert.equal(drawn(world, actor.id), false);
1161
+ hub.hiddenAll.clear();
1162
+ mergeHidden();
1163
+ frame(32);
1164
+ assert.equal(drawn(world, actor.id), false, 'shown but still far');
1165
+ hub.hiddenAll.add(actor.id);
1166
+ mergeHidden();
1167
+ frame(48);
1168
+ world.camera.position.x = 60;
1169
+ hub.hiddenAll.clear();
1170
+ mergeHidden();
1171
+ assert.equal(world.nodes.get(actor.id).node.position.y, -9998, 'node pose still underground');
1172
+ frame(64);
1173
+ assert.equal(drawn(world, actor.id), true, 'lifted near pose wins this frame');
1174
+ });
1175
+
1176
+ visibilityTest('place hidden: High never takes it out, and restores after Low even while hidden', () => {
1177
+ const { world, tiers, frame } = visibilityWorld([hiddenActor('trophy')], 'high');
1178
+ frame(0);
1179
+ hub.hiddenAll.add('trophy');
1180
+ mergeHidden();
1181
+ frame(16);
1182
+ assert.equal(drawn(world, 'trophy'), true);
1183
+ tiers.set('low');
1184
+ frame(32);
1185
+ assert.equal(drawn(world, 'trophy'), false);
1186
+ tiers.set('high');
1187
+ frame(48);
1188
+ assert.equal(drawn(world, 'trophy'), true);
1189
+ hub.hiddenAll.clear();
1190
+ mergeHidden();
1191
+ frame(64);
1192
+ assert.equal(drawn(world, 'trophy'), true);
1193
+ });
1194
+
1195
+ visibilityTest('place hidden: Player, remote avatar and orbit own body roots stay attached', () => {
1196
+ const { world, scene, frame } = visibilityWorld([
1197
+ hiddenActor('self', { Player: {}, Body: {} }),
1198
+ { ...hiddenActor('remote', { Body: {} }), spawned: true },
1199
+ hiddenActor('own', { Body: {} }),
1200
+ { ...hiddenActor('spawned-prop', { TownWardrobeItem: {} }), spawned: true },
1201
+ ]);
1202
+ scene.multiplayer = { avatars: { actors: new Map([['p2', 'remote']]) } };
1203
+ scene.orbitOwnModel = 'own';
1204
+ const wear = new Obj('hat');
1205
+ world.nodes.get('remote').node.add(wear);
1206
+ frame(0);
1207
+ hub.hiddenAll = new Set(['self', 'remote', 'own', 'spawned-prop']);
1208
+ mergeHidden();
1209
+ frame(16);
1210
+ for (const id of ['self', 'remote', 'own']) {
1211
+ assert.equal(drawn(world, id), true, id);
1212
+ }
1213
+ assert.equal(wear.parent, world.nodes.get('remote').node);
1214
+ assert.equal(drawn(world, 'spawned-prop'), false, 'hidden spawned gameplay prop also goes out');
1215
+ });
1216
+
1217
+ visibilityTest('place hidden: clearing the session in place restores inside the look interval', () => {
1218
+ const { world, frame } = visibilityWorld([hiddenActor('trophy')]);
1219
+ hub.hiddenAll.add('trophy');
1220
+ mergeHidden();
1221
+ frame(0);
1222
+ const merged = hub.hidden;
1223
+ clearState();
1224
+ assert.equal(hub.hidden, merged, 'clear empties the set in place');
1225
+ frame(16);
1226
+ assert.equal(drawn(world, 'trophy'), true);
1227
+ });
1228
+
1229
+ visibilityTest('place hidden: instanced actor roots go out and back, otherwise retain their exemption', () => {
1230
+ const { world, frame } = visibilityWorld([hiddenActor('trophy', {}, [80, 2, 0])]);
1231
+ const entry = world.nodes.get('trophy');
1232
+ entry.instancedRig = new Obj('instance-rig');
1233
+ entry.node.add(entry.instancedRig);
1234
+ frame(0);
1235
+ assert.equal(drawn(world, 'trophy'), true, 'instancing still exempts the far rule');
1236
+ hub.hiddenAll.add('trophy');
1237
+ mergeHidden();
1238
+ frame(16);
1239
+ assert.equal(drawn(world, 'trophy'), false, 'root and rig leave the scene graph');
1240
+ assert.equal(entry.instancedRig.parent, entry.node);
1241
+ hub.hiddenAll.clear();
1242
+ mergeHidden();
1243
+ frame(32);
1244
+ assert.equal(drawn(world, 'trophy'), true, 'back while far, as before');
1245
+ });
1246
+
1247
+ visibilityTest('place hidden: a game through a door keeps only the place hide and shadow levers', () => {
1248
+ const { world, scene, frame } = visibilityWorld([hiddenActor('trophy')]);
1249
+ scene.content = {};
1250
+ frame(0);
1251
+ hub.hiddenAll.add('trophy');
1252
+ mergeHidden();
1253
+ frame(16);
1254
+ assert.equal(drawn(world, 'trophy'), false);
1255
+ hub.hiddenAll.clear();
1256
+ mergeHidden();
1257
+ frame(32);
1258
+ assert.equal(drawn(world, 'trophy'), true);
1259
+ });
1260
+
607
1261
  {
608
1262
  let storageReads = 0;
609
1263
  Object.defineProperty(globalThis, 'localStorage', {
@@ -618,10 +1272,16 @@ const { deck } = await import('../code/client/state.js');
618
1272
  let graphics = 0;
619
1273
  system.chrome = { setGraphics: () => (graphics += 1) };
620
1274
  const scene = { three: { renderer: {} }, content: null };
1275
+ const offRoot = new Obj('scene');
1276
+ const offNode = new Obj('hidden-trophy');
1277
+ offRoot.add(offNode);
1278
+ scene.three.nodes = new Map([['hidden-trophy', { node: offNode }]]);
621
1279
  const mp = { placed: () => true };
622
1280
  globalThis.__hub = {};
623
1281
  test('hub.tiers absent: no tiers system is registered, nothing made, run or read', () => {
624
1282
  assert.equal(deck.tiers, false, 'off unless castle.json says so');
1283
+ hub.hiddenAll.add('hidden-trophy');
1284
+ mergeHidden();
625
1285
  const late = [];
626
1286
  system.registerLate({ registerSystem: (s) => late.push(s) });
627
1287
  assert.equal(late.length, 1, 'only the late system the hub always had');
@@ -634,6 +1294,8 @@ const { deck } = await import('../code/client/state.js');
634
1294
  // deviceTier itself is guarded as well.
635
1295
  system.deviceTier(scene, mp, 0);
636
1296
  assert.equal(globalThis.__tiersMade, undefined);
1297
+ assert.equal(offNode.parent, offRoot, 'a place hide does not detach with tiers off');
1298
+ clearState();
637
1299
  });
638
1300
  test('hub.tiers true: a system of its own, made once, run each frame, a harness handle', () => {
639
1301
  deck.tiers = true;
@@ -656,7 +1318,7 @@ test('hub.js reaches the tiers only through a system registered behind the opt-i
656
1318
  assert.equal(src.match(/makeTiers\(/g)?.length, 1);
657
1319
  assert.equal(src.match(/this\.deviceTier\(/g)?.length, 1);
658
1320
  assert.match(src, /\n {4}if \(Hub\.deck\.tiers\) \{\n {6}scene\.registerSystem\(\{ afterBehaviors: \(s\) => this\.deviceTier\(/);
659
- const afterBehaviors = src.slice(src.indexOf(' afterBehaviors(scene) {'), src.indexOf('\n }\n', src.indexOf(' afterBehaviors(scene) {')));
1321
+ const afterBehaviors = src.slice(src.indexOf(' afterBehaviors(scene, dt) {'), src.indexOf('\n }\n', src.indexOf(' afterBehaviors(scene, dt) {')));
660
1322
  assert.doesNotMatch(afterBehaviors, /deviceTier|tiers/i, 'the per-frame update is the one it was');
661
1323
  const body = src.slice(src.indexOf(' deviceTier(scene, mp, now) {'));
662
1324
  assert.match(body, /^ {2}deviceTier\(scene, mp, now\) \{\n {4}if \(!Hub\.deck\.tiers\) \{\n {6}return;\n {4}\}/);
@@ -664,3 +1326,4 @@ test('hub.js reaches the tiers only through a system registered behind the opt-i
664
1326
  });
665
1327
 
666
1328
  console.log(`test-tiers: ${n} passed`);
1329
+ await import('./test-tiers-render.mjs');