castle-web-cli 0.4.232 → 0.4.234

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (587) hide show
  1. package/dist/agent-failures.d.ts +8 -0
  2. package/dist/agent-failures.js +19 -2
  3. package/dist/agent-prompts.d.ts +1 -1
  4. package/dist/agent-prompts.js +10 -3
  5. package/dist/agent.d.ts +64 -3
  6. package/dist/agent.js +170 -81
  7. package/dist/api.d.ts +11 -0
  8. package/dist/api.js +43 -0
  9. package/dist/bundle.d.ts +64 -0
  10. package/dist/bundle.js +558 -2
  11. package/dist/castle-host/host.d.ts +18 -2
  12. package/dist/castle-host/host.js +844 -39
  13. package/dist/castleJson.d.ts +23 -2
  14. package/dist/castleJson.js +46 -2
  15. package/dist/check.d.ts +3 -1
  16. package/dist/check.js +20 -3
  17. package/dist/chunkLoader.d.ts +3 -0
  18. package/dist/chunkLoader.js +111 -0
  19. package/dist/devParty.d.ts +26 -0
  20. package/dist/devParty.js +231 -0
  21. package/dist/devSaveStorage.js +4 -0
  22. package/dist/devSessionStorage.js +50 -2
  23. package/dist/devSocial.d.ts +24 -0
  24. package/dist/devSocial.js +70 -0
  25. package/dist/ide.d.ts +2 -0
  26. package/dist/ide.js +119 -15
  27. package/dist/importPinMismatch.d.ts +22 -0
  28. package/dist/importPinMismatch.js +77 -0
  29. package/dist/importRegression.js +3 -15
  30. package/dist/imports.d.ts +10 -3
  31. package/dist/imports.js +88 -20
  32. package/dist/index.js +11 -4
  33. package/dist/init.js +1 -1
  34. package/dist/platformDoc.js +22 -0
  35. package/dist/routerFences.d.ts +5 -0
  36. package/dist/routerFences.js +12 -2
  37. package/dist/save-deck.d.ts +25 -1
  38. package/dist/save-deck.js +178 -9
  39. package/dist/serve.js +32 -11
  40. package/dist/shell/assets/{index-D2tWM896.js → index-DulbYIJm.js} +97 -97
  41. package/dist/shell/assets/index-MVLfNYd9.css +1 -0
  42. package/dist/shell/index.html +2 -2
  43. package/dist/taskSteer.d.ts +13 -0
  44. package/dist/taskSteer.js +22 -2
  45. package/dist/vitePlugins.d.ts +2 -1
  46. package/dist/vitePlugins.js +13 -0
  47. package/kits/base/castle.json +1 -1
  48. package/kits/base/package-lock.json +1 -1
  49. package/kits/base/sdk/README.md +339 -5
  50. package/kits/base/sdk/avatar.d.ts +6 -2
  51. package/kits/base/sdk/avatar.js +12 -4
  52. package/kits/base/sdk/castle.d.ts +7 -3
  53. package/kits/base/sdk/castle.js +2 -0
  54. package/kits/base/sdk/commands.d.ts +176 -1
  55. package/kits/base/sdk/commands.js +3 -0
  56. package/kits/base/sdk/display.d.ts +3 -0
  57. package/kits/base/sdk/display.js +9 -3
  58. package/kits/base/sdk/hub.d.ts +37 -6
  59. package/kits/base/sdk/hub.js +63 -4
  60. package/kits/base/sdk/multiplayer.d.ts +7 -1
  61. package/kits/base/sdk/multiplayer.js +148 -32
  62. package/kits/base/sdk/multiplayerProtocol.d.ts +2 -0
  63. package/kits/base/sdk/party.d.ts +23 -0
  64. package/kits/base/sdk/party.js +91 -0
  65. package/kits/base/sdk/reconnectBudget.d.ts +23 -0
  66. package/kits/base/sdk/reconnectBudget.js +96 -0
  67. package/kits/base/sdk/save.d.ts +38 -1
  68. package/kits/base/sdk/save.js +81 -7
  69. package/kits/base/sdk/server/hub.d.ts +117 -0
  70. package/kits/base/sdk/server/hub.js +119 -2
  71. package/kits/base/sdk/server/platformHandle.d.ts +43 -1
  72. package/kits/base/sdk/server/storage.d.ts +17 -0
  73. package/kits/base/sdk/server/storage.js +65 -3
  74. package/kits/base/sdk/server/wrapper.d.ts +43 -6
  75. package/kits/base/sdk/server/wrapper.js +93 -9
  76. package/kits/base/sdk/social.d.ts +9 -0
  77. package/kits/base/sdk/social.js +5 -0
  78. package/kits/hub-game/CLAUDE.md +451 -13
  79. package/kits/hub-game/README.md +63 -0
  80. package/kits/hub-game/blueprints/avatar-10.scene +28 -0
  81. package/kits/hub-game/blueprints/avatar-11.scene +28 -0
  82. package/kits/hub-game/blueprints/avatar-12.scene +28 -0
  83. package/kits/hub-game/blueprints/avatar-13.scene +28 -0
  84. package/kits/hub-game/blueprints/avatar-14.scene +28 -0
  85. package/kits/hub-game/blueprints/avatar-15.scene +28 -0
  86. package/kits/hub-game/blueprints/avatar-4.scene +28 -0
  87. package/kits/hub-game/blueprints/avatar-5.scene +28 -0
  88. package/kits/hub-game/blueprints/avatar-6.scene +28 -0
  89. package/kits/hub-game/blueprints/avatar-7.scene +28 -0
  90. package/kits/hub-game/blueprints/avatar-8.scene +28 -0
  91. package/kits/hub-game/blueprints/avatar-9.scene +28 -0
  92. package/kits/hub-game/castle.json +5 -5
  93. package/kits/hub-game/code/client/act.js +312 -0
  94. package/kits/hub-game/code/client/actionLayout.js +147 -0
  95. package/kits/hub-game/code/client/actionOverflow.js +556 -0
  96. package/kits/hub-game/code/client/actorBudget.js +47 -0
  97. package/kits/hub-game/code/client/arrivalCamera.js +50 -0
  98. package/kits/hub-game/code/client/askSlot.js +117 -0
  99. package/kits/hub-game/code/client/attention.js +11 -2
  100. package/kits/hub-game/code/client/avatar.js +311 -35
  101. package/kits/hub-game/code/client/avatarCap.js +228 -0
  102. package/kits/hub-game/code/client/avatarColors.js +70 -0
  103. package/kits/hub-game/code/client/avatarFaces.js +21 -0
  104. package/kits/hub-game/code/client/avatarShare.js +253 -0
  105. package/kits/hub-game/code/client/backVisibility.js +13 -0
  106. package/kits/hub-game/code/client/ballot.js +472 -0
  107. package/kits/hub-game/code/client/build.js +38 -0
  108. package/kits/hub-game/code/client/chat.js +41 -5
  109. package/kits/hub-game/code/client/chatModeration.js +5 -0
  110. package/kits/hub-game/code/client/chrome.js +2144 -160
  111. package/kits/hub-game/code/client/companion.js +716 -0
  112. package/kits/hub-game/code/client/companionDress.js +99 -0
  113. package/kits/hub-game/code/client/crowdNames.js +241 -0
  114. package/kits/hub-game/code/client/decor.js +515 -0
  115. package/kits/hub-game/code/client/defaultEnvironment.js +194 -0
  116. package/kits/hub-game/code/client/doorErrors.js +39 -0
  117. package/kits/hub-game/code/client/earned.js +131 -0
  118. package/kits/hub-game/code/client/emoteBubble.js +75 -0
  119. package/kits/hub-game/code/client/fall.js +18 -0
  120. package/kits/hub-game/code/client/farAvatars.js +233 -0
  121. package/kits/hub-game/code/client/firstJoin.js +9 -2
  122. package/kits/hub-game/code/client/fpsTelemetry.js +50 -0
  123. package/kits/hub-game/code/client/frameBatch.js +5 -0
  124. package/kits/hub-game/code/client/grab.js +368 -29
  125. package/kits/hub-game/code/client/hookLayer.js +385 -20
  126. package/kits/hub-game/code/client/hudCopy.js +51 -0
  127. package/kits/hub-game/code/client/hudRate.js +20 -0
  128. package/kits/hub-game/code/client/idle.js +177 -24
  129. package/kits/hub-game/code/client/interestCap.js +81 -0
  130. package/kits/hub-game/code/client/invites.js +231 -0
  131. package/kits/hub-game/code/client/joinError.js +9 -0
  132. package/kits/hub-game/code/client/keys.js +36 -0
  133. package/kits/hub-game/code/client/labelsNear.js +234 -0
  134. package/kits/hub-game/code/client/landscapeLayout.js +17 -0
  135. package/kits/hub-game/code/client/layoutCache.js +264 -0
  136. package/kits/hub-game/code/client/loadTelemetry.js +20 -0
  137. package/kits/hub-game/code/client/loadingCover.js +148 -0
  138. package/kits/hub-game/code/client/loadingEntry.js +8 -0
  139. package/kits/hub-game/code/client/menuIcons.js +34 -0
  140. package/kits/hub-game/code/client/menuRows.js +43 -0
  141. package/kits/hub-game/code/client/modelReady.js +7 -0
  142. package/kits/hub-game/code/client/pack.js +6 -2
  143. package/kits/hub-game/code/client/packFormat.js +3 -3
  144. package/kits/hub-game/code/client/padCueArrival.js +23 -0
  145. package/kits/hub-game/code/client/padCues.js +112 -0
  146. package/kits/hub-game/code/client/padOccupancy.js +88 -0
  147. package/kits/hub-game/code/client/padReadability.js +26 -0
  148. package/kits/hub-game/code/client/padRings.js +69 -0
  149. package/kits/hub-game/code/client/pushVisit.js +14 -0
  150. package/kits/hub-game/code/client/quality.js +205 -0
  151. package/kits/hub-game/code/client/qualityEntry.js +55 -0
  152. package/kits/hub-game/code/client/rehello.js +167 -0
  153. package/kits/hub-game/code/client/safeLayout.js +338 -0
  154. package/kits/hub-game/code/client/safeStyle.js +42 -0
  155. package/kits/hub-game/code/client/say.js +12 -3
  156. package/kits/hub-game/code/client/shot.js +146 -0
  157. package/kits/hub-game/code/client/shotFit.js +56 -0
  158. package/kits/hub-game/code/client/signIn.js +28 -0
  159. package/kits/hub-game/code/client/sound.js +63 -8
  160. package/kits/hub-game/code/client/soundscape.js +1151 -0
  161. package/kits/hub-game/code/client/soundscapeActions.js +99 -0
  162. package/kits/hub-game/code/client/soundscapeAmbience.js +453 -0
  163. package/kits/hub-game/code/client/soundscapeBaked.js +143 -0
  164. package/kits/hub-game/code/client/soundscapeBusker.js +217 -0
  165. package/kits/hub-game/code/client/soundscapeCourt.js +200 -0
  166. package/kits/hub-game/code/client/soundscapeCrowd.js +331 -0
  167. package/kits/hub-game/code/client/soundscapeCues.js +362 -0
  168. package/kits/hub-game/code/client/soundscapeMap.js +181 -0
  169. package/kits/hub-game/code/client/soundscapeMarket.js +176 -0
  170. package/kits/hub-game/code/client/soundscapeMusic.js +126 -0
  171. package/kits/hub-game/code/client/soundscapeMusicEngine.js +460 -0
  172. package/kits/hub-game/code/client/soundscapeSimlish.js +737 -0
  173. package/kits/hub-game/code/client/soundscapeSongs.js +127 -0
  174. package/kits/hub-game/code/client/soundscapeSongsRound3.js +63 -0
  175. package/kits/hub-game/code/client/soundscapeSynthesis.js +168 -0
  176. package/kits/hub-game/code/client/soundscapeUi.js +211 -0
  177. package/kits/hub-game/code/client/soundscapeVoice.js +1209 -0
  178. package/kits/hub-game/code/client/soundscapeWaves.js +206 -0
  179. package/kits/hub-game/code/client/spin.js +101 -0
  180. package/kits/hub-game/code/client/state.js +162 -1
  181. package/kits/hub-game/code/client/stuck.js +259 -0
  182. package/kits/hub-game/code/client/talk.js +714 -59
  183. package/kits/hub-game/code/client/tiers.js +543 -52
  184. package/kits/hub-game/code/client/toastBand.js +37 -0
  185. package/kits/hub-game/code/client/together.js +39 -2
  186. package/kits/hub-game/code/client/visibility.js +43 -0
  187. package/kits/hub-game/code/client/weakestLookBake.js +92 -0
  188. package/kits/hub-game/code/client/weakestTier.js +295 -0
  189. package/kits/hub-game/code/client/wear.js +461 -170
  190. package/kits/hub-game/code/client/worldLabels.js +241 -0
  191. package/kits/hub-game/code/client/yours.js +200 -0
  192. package/kits/hub-game/code/companionSpec.js +45 -0
  193. package/kits/hub-game/code/npcDisplayText.js +55 -0
  194. package/kits/hub-game/code/privateText.js +7 -0
  195. package/kits/hub-game/code/server/act.js +124 -0
  196. package/kits/hub-game/code/server/actions.js +138 -0
  197. package/kits/hub-game/code/server/actors.js +11 -2
  198. package/kits/hub-game/code/server/analytics.js +83 -0
  199. package/kits/hub-game/code/server/anonymousEntry.js +49 -0
  200. package/kits/hub-game/code/server/arrivalPose.js +36 -0
  201. package/kits/hub-game/code/server/ask.js +155 -0
  202. package/kits/hub-game/code/server/ballot.js +539 -0
  203. package/kits/hub-game/code/server/cells.js +100 -0
  204. package/kits/hub-game/code/server/companion.js +107 -0
  205. package/kits/hub-game/code/server/cues.js +70 -0
  206. package/kits/hub-game/code/server/decor.js +269 -0
  207. package/kits/hub-game/code/server/doorAnalytics.js +52 -0
  208. package/kits/hub-game/code/server/earned.js +478 -0
  209. package/kits/hub-game/code/server/frameBatch.js +183 -0
  210. package/kits/hub-game/code/server/friendBests.js +166 -0
  211. package/kits/hub-game/code/server/friendsAmong.js +272 -0
  212. package/kits/hub-game/code/server/history.js +7 -0
  213. package/kits/hub-game/code/server/hub.js +2510 -95
  214. package/kits/hub-game/code/server/idle.js +60 -12
  215. package/kits/hub-game/code/server/index.js +28 -6
  216. package/kits/hub-game/code/server/invites.js +19 -0
  217. package/kits/hub-game/code/server/labels.js +36 -2
  218. package/kits/hub-game/code/server/loadAbandon.js +106 -0
  219. package/kits/hub-game/code/server/manifest.js +586 -7
  220. package/kits/hub-game/code/server/menu.js +161 -0
  221. package/kits/hub-game/code/server/npcs.js +1025 -113
  222. package/kits/hub-game/code/server/observe.js +408 -0
  223. package/kits/hub-game/code/server/padOccupancy.js +85 -0
  224. package/kits/hub-game/code/server/party.js +2 -2
  225. package/kits/hub-game/code/server/players.js +30 -0
  226. package/kits/hub-game/code/server/resumePose.js +152 -0
  227. package/kits/hub-game/code/server/say.js +1 -1
  228. package/kits/hub-game/code/server/shot.js +110 -0
  229. package/kits/hub-game/code/server/standing.js +123 -0
  230. package/kits/hub-game/code/server/storageLimit.js +187 -0
  231. package/kits/hub-game/code/server/vis.js +175 -0
  232. package/kits/hub-game/code/server/wear.js +12 -0
  233. package/kits/hub-game/code/server/yours.js +59 -0
  234. package/kits/hub-game/code/shared/act.js +35 -0
  235. package/kits/hub-game/code/shared/cues.js +9 -0
  236. package/kits/hub-game/code/shared/danceIdle.js +28 -0
  237. package/kits/hub-game/code/shared/decor.js +41 -0
  238. package/kits/hub-game/code/shared/loadStages.js +12 -0
  239. package/kits/hub-game/code/shared/quality.js +74 -0
  240. package/kits/hub-game/code/shared/say.js +2 -0
  241. package/kits/hub-game/code/shared/shot.js +53 -0
  242. package/kits/hub-game/code/shared/spin.js +57 -0
  243. package/kits/hub-game/code/systems/hub.js +1753 -202
  244. package/kits/hub-game/docs/analytics.md +279 -0
  245. package/kits/hub-game/docs/content-pack.md +1 -1
  246. package/kits/hub-game/docs/contract.md +3475 -77
  247. package/kits/hub-game/docs/home-pieces.md +71 -0
  248. package/kits/hub-game/docs/observed-progress.md +252 -0
  249. package/kits/hub-game/main.jsx +2 -0
  250. package/kits/hub-game/models/avatar-10.pxmodel +28 -0
  251. package/kits/hub-game/models/avatar-11.pxmodel +28 -0
  252. package/kits/hub-game/models/avatar-12.pxmodel +27 -0
  253. package/kits/hub-game/models/avatar-13.pxmodel +24 -0
  254. package/kits/hub-game/models/avatar-14.pxmodel +29 -0
  255. package/kits/hub-game/models/avatar-15.pxmodel +24 -0
  256. package/kits/hub-game/models/avatar-4.pxmodel +29 -0
  257. package/kits/hub-game/models/avatar-5.pxmodel +27 -0
  258. package/kits/hub-game/models/avatar-6.pxmodel +26 -0
  259. package/kits/hub-game/models/avatar-7.pxmodel +25 -0
  260. package/kits/hub-game/models/avatar-8.pxmodel +24 -0
  261. package/kits/hub-game/models/avatar-9.pxmodel +30 -0
  262. package/kits/hub-game/models/earned/badge-round.pxmodel +100 -0
  263. package/kits/hub-game/models/earned/badge-shield.pxmodel +117 -0
  264. package/kits/hub-game/models/earned/badge-star.pxmodel +87 -0
  265. package/kits/hub-game/models/earned/belt-plain.pxmodel +72 -0
  266. package/kits/hub-game/models/earned/held-ball.pxmodel +43 -0
  267. package/kits/hub-game/models/earned/held-lantern.pxmodel +85 -0
  268. package/kits/hub-game/models/earned/held-net.pxmodel +57 -0
  269. package/kits/hub-game/models/earned/held-trophy.pxmodel +109 -0
  270. package/kits/hub-game/models/earned/pin-round.pxmodel +62 -0
  271. package/kits/hub-game/models/earned/sash-plain.pxmodel +66 -0
  272. package/kits/hub-game/models/earned/square/belt-plain.pxmodel +104 -0
  273. package/kits/hub-game/models/earned/square/sash-plain.pxmodel +98 -0
  274. package/kits/hub-game/models/hats/bat-clip.pxmodel +206 -0
  275. package/kits/hub-game/models/hats/beekeeper.pxmodel +149 -0
  276. package/kits/hub-game/models/hats/cap.pxmodel +162 -0
  277. package/kits/hub-game/models/hats/captain.pxmodel +178 -0
  278. package/kits/hub-game/models/hats/crooked-top.pxmodel +172 -0
  279. package/kits/hub-game/models/hats/flower-crown.pxmodel +451 -0
  280. package/kits/hub-game/models/hats/foam-crown.pxmodel +179 -0
  281. package/kits/hub-game/models/hats/lantern.pxmodel +230 -0
  282. package/kits/hub-game/models/hats/laurel.pxmodel +533 -0
  283. package/kits/hub-game/models/hats/lighthouse.pxmodel +96 -0
  284. package/kits/hub-game/models/hats/sailor.pxmodel +141 -0
  285. package/kits/hub-game/models/hats/souwester.pxmodel +131 -0
  286. package/kits/hub-game/models/hats/straw.pxmodel +139 -0
  287. package/kits/hub-game/models/hats/sunflower.pxmodel +406 -0
  288. package/kits/hub-game/models/hats/sweatband.pxmodel +112 -0
  289. package/kits/hub-game/models/hats/witch.pxmodel +147 -0
  290. package/kits/hub-game/package-lock.json +10 -1
  291. package/kits/hub-game/package.json +6 -2
  292. package/kits/hub-game/play/player.js +142 -0
  293. package/kits/hub-game/play/registry.js +47 -0
  294. package/kits/hub-game/play.jsx +37 -0
  295. package/kits/hub-game/scripts/check.mjs +117 -16
  296. package/kits/hub-game/scripts/companion-follower-wire.json +1 -0
  297. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +132 -0
  298. package/kits/hub-game/scripts/fixtures/decor-keyless.json +293 -0
  299. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +26 -0
  300. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +123 -0
  301. package/kits/hub-game/scripts/fixtures/interest-legacy.json +385 -0
  302. package/kits/hub-game/scripts/fixtures/npc-notes-v1.77.jsonl +4 -0
  303. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -0
  304. package/kits/hub-game/scripts/gen-avatars.mjs +933 -16
  305. package/kits/hub-game/scripts/gen-earned.mjs +285 -0
  306. package/kits/hub-game/scripts/gen-hats.mjs +827 -0
  307. package/kits/hub-game/scripts/grab.before-orbit.mjs +400 -0
  308. package/kits/hub-game/scripts/pose-storage-fixture.mjs +46 -0
  309. package/kits/hub-game/scripts/soundscape-wave-analysis.mjs +125 -0
  310. package/kits/hub-game/scripts/test-act-client.mjs +186 -0
  311. package/kits/hub-game/scripts/test-act.mjs +171 -0
  312. package/kits/hub-game/scripts/test-action-layout.mjs +80 -0
  313. package/kits/hub-game/scripts/test-action-observers.mjs +46 -0
  314. package/kits/hub-game/scripts/test-actions-client.mjs +853 -0
  315. package/kits/hub-game/scripts/test-actions.mjs +298 -0
  316. package/kits/hub-game/scripts/test-actor-budget.mjs +44 -0
  317. package/kits/hub-game/scripts/test-actors.mjs +38 -23
  318. package/kits/hub-game/scripts/test-analytics.mjs +76 -0
  319. package/kits/hub-game/scripts/test-anonymous-entry.mjs +28 -0
  320. package/kits/hub-game/scripts/test-arrival-pose-server.mjs +196 -0
  321. package/kits/hub-game/scripts/test-arrival-pose.mjs +24 -0
  322. package/kits/hub-game/scripts/test-ask-client.mjs +358 -0
  323. package/kits/hub-game/scripts/test-ask-slot.mjs +85 -0
  324. package/kits/hub-game/scripts/test-ask.mjs +269 -0
  325. package/kits/hub-game/scripts/test-attention.mjs +10 -1
  326. package/kits/hub-game/scripts/test-avatar-cap.mjs +379 -0
  327. package/kits/hub-game/scripts/test-avatar-colors.mjs +72 -0
  328. package/kits/hub-game/scripts/test-avatar-models.mjs +181 -0
  329. package/kits/hub-game/scripts/test-avatar-share.mjs +318 -0
  330. package/kits/hub-game/scripts/test-avatar-wire.mjs +792 -0
  331. package/kits/hub-game/scripts/test-avatar.mjs +584 -7
  332. package/kits/hub-game/scripts/test-back-visibility.mjs +82 -0
  333. package/kits/hub-game/scripts/test-ballot.mjs +1008 -0
  334. package/kits/hub-game/scripts/test-ban-join.mjs +121 -13
  335. package/kits/hub-game/scripts/test-build.mjs +49 -0
  336. package/kits/hub-game/scripts/test-cells.mjs +71 -0
  337. package/kits/hub-game/scripts/test-chat.mjs +863 -0
  338. package/kits/hub-game/scripts/test-classic.mjs +2 -0
  339. package/kits/hub-game/scripts/test-companion-chat.mjs +216 -0
  340. package/kits/hub-game/scripts/test-companion-client.mjs +1167 -0
  341. package/kits/hub-game/scripts/test-companion.mjs +259 -0
  342. package/kits/hub-game/scripts/test-control-layout-dom.mjs +120 -0
  343. package/kits/hub-game/scripts/test-crowd-names.mjs +205 -0
  344. package/kits/hub-game/scripts/test-decor-client.mjs +344 -0
  345. package/kits/hub-game/scripts/test-decor.mjs +464 -0
  346. package/kits/hub-game/scripts/test-default-environment-root.mjs +95 -0
  347. package/kits/hub-game/scripts/test-default-environment.mjs +267 -0
  348. package/kits/hub-game/scripts/test-door-analytics.mjs +58 -0
  349. package/kits/hub-game/scripts/test-door-jump.mjs +100 -0
  350. package/kits/hub-game/scripts/test-earned-client.mjs +459 -0
  351. package/kits/hub-game/scripts/test-earned.mjs +1224 -0
  352. package/kits/hub-game/scripts/test-emote-bubble.mjs +110 -0
  353. package/kits/hub-game/scripts/test-far-avatars.mjs +340 -0
  354. package/kits/hub-game/scripts/test-fps-telemetry.mjs +112 -0
  355. package/kits/hub-game/scripts/test-frame-batch.mjs +252 -0
  356. package/kits/hub-game/scripts/test-fresh-friends.mjs +118 -0
  357. package/kits/hub-game/scripts/test-friend-bests.mjs +435 -0
  358. package/kits/hub-game/scripts/test-grab-orbit.mjs +961 -0
  359. package/kits/hub-game/scripts/test-grab.mjs +7 -0
  360. package/kits/hub-game/scripts/test-hats.mjs +422 -168
  361. package/kits/hub-game/scripts/test-high-only.mjs +170 -0
  362. package/kits/hub-game/scripts/test-hub-leaving.mjs +203 -0
  363. package/kits/hub-game/scripts/test-hub-ops.mjs +758 -2
  364. package/kits/hub-game/scripts/test-hub-trip.mjs +1594 -12
  365. package/kits/hub-game/scripts/test-hud-clear.mjs +484 -57
  366. package/kits/hub-game/scripts/test-hud-defects-dom.mjs +100 -0
  367. package/kits/hub-game/scripts/test-hud-rate.mjs +224 -0
  368. package/kits/hub-game/scripts/test-hud-safe-visibility-dom.mjs +83 -0
  369. package/kits/hub-game/scripts/test-idle.mjs +427 -1
  370. package/kits/hub-game/scripts/test-interest-cap.mjs +36 -0
  371. package/kits/hub-game/scripts/test-interest-cells.mjs +513 -0
  372. package/kits/hub-game/scripts/test-interest-client.mjs +118 -0
  373. package/kits/hub-game/scripts/test-interest.mjs +15 -0
  374. package/kits/hub-game/scripts/test-invites-client.mjs +430 -0
  375. package/kits/hub-game/scripts/test-invites.mjs +109 -0
  376. package/kits/hub-game/scripts/test-keys.mjs +46 -1
  377. package/kits/hub-game/scripts/test-labels.mjs +664 -0
  378. package/kits/hub-game/scripts/test-landscape-layout.mjs +194 -0
  379. package/kits/hub-game/scripts/test-list-scroll-dom.mjs +49 -0
  380. package/kits/hub-game/scripts/test-load-abandon.mjs +246 -0
  381. package/kits/hub-game/scripts/test-loading-cover.mjs +162 -0
  382. package/kits/hub-game/scripts/test-manifest.mjs +472 -0
  383. package/kits/hub-game/scripts/test-menu-client.mjs +585 -0
  384. package/kits/hub-game/scripts/test-menu.mjs +319 -0
  385. package/kits/hub-game/scripts/test-npcs.mjs +2528 -13
  386. package/kits/hub-game/scripts/test-object-entry.mjs +76 -0
  387. package/kits/hub-game/scripts/test-observed.mjs +745 -0
  388. package/kits/hub-game/scripts/test-pack.mjs +7 -0
  389. package/kits/hub-game/scripts/test-pad-cues.mjs +304 -0
  390. package/kits/hub-game/scripts/test-pad-occupancy.mjs +177 -0
  391. package/kits/hub-game/scripts/test-picker.mjs +541 -0
  392. package/kits/hub-game/scripts/test-placement-cache.mjs +690 -0
  393. package/kits/hub-game/scripts/test-progress-reset.mjs +559 -0
  394. package/kits/hub-game/scripts/test-push-visit.mjs +26 -0
  395. package/kits/hub-game/scripts/test-quality.mjs +385 -0
  396. package/kits/hub-game/scripts/test-rehello.mjs +1733 -0
  397. package/kits/hub-game/scripts/test-relations-among.mjs +222 -0
  398. package/kits/hub-game/scripts/test-relations-refresh.mjs +188 -0
  399. package/kits/hub-game/scripts/test-resume-action-order.mjs +598 -0
  400. package/kits/hub-game/scripts/test-resume-held.mjs +239 -0
  401. package/kits/hub-game/scripts/test-resume-pose.mjs +142 -0
  402. package/kits/hub-game/scripts/test-safe-events-dom.mjs +116 -0
  403. package/kits/hub-game/scripts/test-safe-layout.mjs +330 -0
  404. package/kits/hub-game/scripts/test-say.mjs +1 -1
  405. package/kits/hub-game/scripts/test-shot.mjs +901 -0
  406. package/kits/hub-game/scripts/test-signin-client.mjs +45 -0
  407. package/kits/hub-game/scripts/test-soundscape.mjs +5437 -0
  408. package/kits/hub-game/scripts/test-spin.mjs +314 -0
  409. package/kits/hub-game/scripts/test-standing.mjs +449 -0
  410. package/kits/hub-game/scripts/test-storage-limit.mjs +333 -0
  411. package/kits/hub-game/scripts/test-stuck.mjs +1904 -0
  412. package/kits/hub-game/scripts/test-talk-overlay-dom.mjs +130 -0
  413. package/kits/hub-game/scripts/test-tier-cells.mjs +706 -0
  414. package/kits/hub-game/scripts/test-tiers-render.mjs +412 -0
  415. package/kits/hub-game/scripts/test-tiers.mjs +476 -2
  416. package/kits/hub-game/scripts/test-toast-band.mjs +61 -0
  417. package/kits/hub-game/scripts/test-try-on.mjs +22 -22
  418. package/kits/hub-game/scripts/test-vis.mjs +770 -0
  419. package/kits/hub-game/scripts/test-visibility.mjs +134 -0
  420. package/kits/hub-game/scripts/test-weakest-tier.mjs +924 -0
  421. package/kits/hub-game/scripts/test-world-labels.mjs +367 -0
  422. package/kits/hub-game/scripts/test-yours-chrome.mjs +210 -0
  423. package/kits/hub-game/scripts/test-yours.mjs +403 -0
  424. package/kits/multiplayer-3d/CLAUDE.md +50 -0
  425. package/kits/multiplayer-3d/castle.json +5 -5
  426. package/kits/multiplayer-3d/code/client/avatars.js +7 -0
  427. package/kits/multiplayer-3d/code/client/gait.js +65 -0
  428. package/kits/multiplayer-3d/code/client/joinFailure.js +27 -0
  429. package/kits/multiplayer-3d/code/client/nameTags.js +59 -4
  430. package/kits/multiplayer-3d/code/client/resumeGate.js +139 -0
  431. package/kits/multiplayer-3d/code/options.js +5 -0
  432. package/kits/multiplayer-3d/code/server/ownership.js +10 -2
  433. package/kits/multiplayer-3d/code/server/sceneBodies.js +12 -0
  434. package/kits/multiplayer-3d/code/server/world.js +7 -0
  435. package/kits/multiplayer-3d/code/systems/multiplayer.js +443 -34
  436. package/kits/multiplayer-3d/package-lock.json +8 -1
  437. package/kits/multiplayer-3d/package.json +3 -1
  438. package/kits/multiplayer-3d/scripts/fixtures/README.md +11 -0
  439. package/kits/multiplayer-3d/scripts/fixtures/ownership-legacy.json +2 -0
  440. package/kits/multiplayer-3d/scripts/ownership-harness.mjs +102 -0
  441. package/kits/multiplayer-3d/scripts/ownership-loader.mjs +46 -0
  442. package/kits/multiplayer-3d/scripts/ownership-worker.mjs +15 -0
  443. package/kits/multiplayer-3d/scripts/record-ownership-session.mjs +98 -0
  444. package/kits/multiplayer-3d/scripts/test-eligible-claims.mjs +167 -0
  445. package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +436 -0
  446. package/kits/multiplayer-3d/scripts/test-own-name-tag.mjs +247 -0
  447. package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +624 -0
  448. package/kits/physics-2d/CLAUDE.md +19 -1
  449. package/kits/physics-2d/castle.json +2 -2
  450. package/kits/physics-2d/engine/frozenActors.js +233 -0
  451. package/kits/physics-2d/engine/scene.js +337 -3
  452. package/kits/physics-2d/engine/skyKey.js +129 -0
  453. package/kits/physics-2d/engine/stillClock.js +106 -0
  454. package/kits/physics-2d/engine/updateBudget.js +21 -0
  455. package/kits/physics-2d/eslint.config.js +1 -1
  456. package/kits/physics-2d/play/behaviors/AnalogStick.js +198 -0
  457. package/kits/physics-2d/play/behaviors/Camera.js +40 -0
  458. package/kits/physics-2d/play/behaviors/Collider.js +122 -0
  459. package/kits/physics-2d/play/behaviors/Draggable.js +115 -0
  460. package/kits/physics-2d/play/behaviors/Goal.js +46 -0
  461. package/kits/physics-2d/play/behaviors/Joints.js +126 -0
  462. package/kits/physics-2d/play/behaviors/Layout.js +71 -0
  463. package/kits/physics-2d/play/behaviors/RigidBody.js +57 -0
  464. package/kits/physics-2d/play/behaviors/Slingshot.js +142 -0
  465. package/kits/physics-2d/play/behaviors/SoundPlayer.js +263 -0
  466. package/kits/physics-2d/play/behaviors/Sprite.js +406 -0
  467. package/kits/physics-2d/play/behaviors/Style.js +209 -0
  468. package/kits/physics-2d/play/behaviors/Text.js +85 -0
  469. package/kits/physics-2d/play/behaviors/Video.js +93 -0
  470. package/kits/physics-2d/scripts/test-skip-unchanged.mjs +326 -1
  471. package/kits/physics-3d/CLAUDE.md +42 -529
  472. package/kits/physics-3d/behaviors/Body.jsx +3 -0
  473. package/kits/physics-3d/behaviors/Model.jsx +3 -0
  474. package/kits/physics-3d/behaviors/Player.jsx +661 -87
  475. package/kits/physics-3d/behaviors/Shape.jsx +3 -0
  476. package/kits/physics-3d/behaviors/Solid.jsx +3 -0
  477. package/kits/physics-3d/behaviors/Transform.jsx +3 -0
  478. package/kits/physics-3d/castle.json +3 -3
  479. package/kits/physics-3d/docs/engine-camera.md +542 -0
  480. package/kits/physics-3d/docs/engine-frame-cap.md +136 -0
  481. package/kits/physics-3d/docs/engine-load.md +149 -0
  482. package/kits/physics-3d/docs/engine-look.md +114 -0
  483. package/kits/physics-3d/docs/engine-shadows.md +372 -0
  484. package/kits/physics-3d/docs/engine-skip-work.md +187 -0
  485. package/kits/physics-3d/docs/engine-sky.md +198 -0
  486. package/kits/physics-3d/docs/engine-static-actors.md +226 -0
  487. package/kits/physics-3d/docs/engine-view.md +37 -0
  488. package/kits/physics-3d/docs/pxmodel-format.md +9 -1
  489. package/kits/physics-3d/engine3d/PlayOnly3D.jsx +5 -1
  490. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +19 -277
  491. package/kits/physics-3d/engine3d/actornode.js +87 -0
  492. package/kits/physics-3d/engine3d/animationBudget.js +23 -0
  493. package/kits/physics-3d/engine3d/branches.js +3 -13
  494. package/kits/physics-3d/engine3d/cage.js +2 -7
  495. package/kits/physics-3d/engine3d/cageops.js +2 -17
  496. package/kits/physics-3d/engine3d/dataBehaviors.js +12 -0
  497. package/kits/physics-3d/engine3d/editorWorld.js +6 -0
  498. package/kits/physics-3d/engine3d/emptynodes.js +232 -0
  499. package/kits/physics-3d/engine3d/framecap.js +99 -0
  500. package/kits/physics-3d/engine3d/frozenphysics.js +140 -0
  501. package/kits/physics-3d/engine3d/frozenstatics.js +273 -0
  502. package/kits/physics-3d/engine3d/gait.js +126 -0
  503. package/kits/physics-3d/engine3d/initialModelFiles.js +18 -0
  504. package/kits/physics-3d/engine3d/kithooks.js +47 -0
  505. package/kits/physics-3d/engine3d/look.js +514 -48
  506. package/kits/physics-3d/engine3d/lookbake.js +208 -0
  507. package/kits/physics-3d/engine3d/materialpresets.js +2 -0
  508. package/kits/physics-3d/engine3d/modelFiles.js +3 -17
  509. package/kits/physics-3d/engine3d/modelMath.js +49 -0
  510. package/kits/physics-3d/engine3d/modelready.js +16 -0
  511. package/kits/physics-3d/engine3d/motion.js +39 -10
  512. package/kits/physics-3d/engine3d/nearshadows.js +106 -21
  513. package/kits/physics-3d/engine3d/optimize.js +9 -5
  514. package/kits/physics-3d/engine3d/orbitinput.js +522 -10
  515. package/kits/physics-3d/engine3d/orbitlens.js +48 -0
  516. package/kits/physics-3d/engine3d/ownmodel.js +213 -0
  517. package/kits/physics-3d/engine3d/partgeometry.js +1 -16
  518. package/kits/physics-3d/engine3d/paths.js +1 -9
  519. package/kits/physics-3d/engine3d/playTimings.js +50 -0
  520. package/kits/physics-3d/engine3d/playerRun.js +372 -0
  521. package/kits/physics-3d/engine3d/pxmodel.js +42 -11
  522. package/kits/physics-3d/engine3d/rapier.js +27 -0
  523. package/kits/physics-3d/engine3d/scatter.js +1 -11
  524. package/kits/physics-3d/engine3d/shadowfade.js +890 -0
  525. package/kits/physics-3d/engine3d/sky.js +547 -0
  526. package/kits/physics-3d/engine3d/skylife.js +306 -0
  527. package/kits/physics-3d/engine3d/squarefirst.js +177 -0
  528. package/kits/physics-3d/engine3d/stillshadows.js +399 -0
  529. package/kits/physics-3d/engine3d/sweep.js +1 -25
  530. package/kits/physics-3d/engine3d/unchanged.js +11 -0
  531. package/kits/physics-3d/engine3d/viewrange.js +52 -0
  532. package/kits/physics-3d/engine3d/world3d.js +1253 -76
  533. package/kits/physics-3d/eslint.config.js +2 -1
  534. package/kits/physics-3d/main.jsx +10 -2
  535. package/kits/physics-3d/package-lock.json +7 -0
  536. package/kits/physics-3d/package.json +5 -1
  537. package/kits/physics-3d/play/behaviors/Body.js +31 -0
  538. package/kits/physics-3d/play/behaviors/Door.js +37 -0
  539. package/kits/physics-3d/play/behaviors/Lookable.js +16 -0
  540. package/kits/physics-3d/play/behaviors/Model.js +23 -0
  541. package/kits/physics-3d/play/behaviors/Pickup.js +46 -0
  542. package/kits/physics-3d/play/behaviors/Player.js +1204 -0
  543. package/kits/physics-3d/play/behaviors/Shape.js +47 -0
  544. package/kits/physics-3d/play/behaviors/Solid.js +16 -0
  545. package/kits/physics-3d/play/behaviors/Transform.js +29 -0
  546. package/kits/physics-3d/pnpm-lock.yaml +8 -0
  547. package/kits/physics-3d/scripts/bench-shadow-fade.mjs +37 -0
  548. package/kits/physics-3d/scripts/build-rapier-gz.mjs +56 -0
  549. package/kits/physics-3d/scripts/frozen-statics-fixture.mjs +141 -0
  550. package/kits/physics-3d/scripts/look-baseline.mjs +155 -0
  551. package/kits/physics-3d/scripts/test-camera-follow.mjs +5 -1
  552. package/kits/physics-3d/scripts/test-camera-orbit.mjs +2613 -82
  553. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +2 -2
  554. package/kits/physics-3d/scripts/test-empty-gait-hints.mjs +89 -0
  555. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +438 -0
  556. package/kits/physics-3d/scripts/test-frame-cap.mjs +452 -0
  557. package/kits/physics-3d/scripts/test-frozen-nested.mjs +49 -0
  558. package/kits/physics-3d/scripts/test-frozen-statics-legacy-physics2d.mjs +123 -0
  559. package/kits/physics-3d/scripts/test-frozen-statics.mjs +434 -0
  560. package/kits/physics-3d/scripts/test-gait.mjs +387 -0
  561. package/kits/physics-3d/scripts/test-look-bake.mjs +1056 -0
  562. package/kits/physics-3d/scripts/test-model-parse-cache.mjs +92 -0
  563. package/kits/physics-3d/scripts/test-near-shadows.mjs +5 -2
  564. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +2001 -0
  565. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +582 -0
  566. package/kits/physics-3d/scripts/test-orbit-shot.mjs +657 -0
  567. package/kits/physics-3d/scripts/test-orbit-view.mjs +230 -0
  568. package/kits/physics-3d/scripts/test-rapier-gz.mjs +106 -0
  569. package/kits/physics-3d/scripts/test-skip-empty-nodes.mjs +845 -0
  570. package/kits/physics-3d/scripts/test-sky.mjs +2470 -0
  571. package/kits/physics-3d/scripts/test-square-first.mjs +921 -0
  572. package/kits/physics-3d/scripts/test-static-actors.mjs +10 -1
  573. package/kits/physics-3d/scripts/test-static-physics.mjs +4 -1
  574. package/kits/physics-3d/scripts/test-static-scenery.mjs +2174 -0
  575. package/kits/physics-3d/scripts/test-steady-hover.mjs +7 -2
  576. package/kits/physics-3d/scripts/test-still-shadows.mjs +477 -0
  577. package/kits/physics-3d/scripts/test-view-range.mjs +260 -0
  578. package/kits/physics-3d/systems/physics3d.js +419 -9
  579. package/kits/real-time/castle.json +2 -2
  580. package/kits/real-time/code/client/connection.js +33 -10
  581. package/kits/real-time/code/client/gameHooks.js +2 -0
  582. package/kits/real-time/code/client/joinOverlay.js +9 -4
  583. package/kits/real-time/code/server/gameHooks.js +7 -0
  584. package/kits/real-time/code/server/session.js +102 -22
  585. package/kits/real-time/package-lock.json +1 -1
  586. package/package.json +2 -2
  587. package/dist/shell/assets/index-Cf61cNfT.css +0 -1
@@ -10,11 +10,14 @@
10
10
  import assert from 'node:assert/strict';
11
11
  import fs from 'node:fs';
12
12
  import { register } from 'node:module';
13
+ import { clear as clearState, hub, mergeHidden } from '../code/client/state.js';
13
14
  import {
14
15
  CHECK_EVERY_MS,
15
16
  FIRST_WINDOW_MS,
16
17
  KEEP,
18
+ LOW,
17
19
  MODE_KEY,
20
+ NEAR,
18
21
  REMEMBER_MS,
19
22
  TIER_KEY,
20
23
  WINDOW_MS,
@@ -597,7 +600,7 @@ const MARKED = [
597
600
  { id: 'wall-near', components: WALL, at: [10, 0, 0] },
598
601
  { id: 'wall-far', components: WALL, at: [60, 0, 0] },
599
602
  { id: 'npc-far', components: NPC, at: [0, 0, 25] },
600
- { id: 'vase', components: GROUND, at: [2, 0, 2], tier: 'low' },
603
+ { id: 'vase', components: GROUND, at: [2, 0, 2], tier: 'unknown' },
601
604
  { id: 'urn', components: GROUND, at: [2, 0, 4], tier: true },
602
605
  { id: 'pot', components: GROUND, at: [2, 0, 6], tier: 'Keep' },
603
606
  { id: 'bush', components: GROUND, at: [2, 0, 8], tier: null },
@@ -767,6 +770,253 @@ test('keep: a reload that adds the mark puts the node back on the very next fram
767
770
  assert.equal(drawn(world, 'wall-far'), true);
768
771
  });
769
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 retains the kit sky', () => {
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, SKY_KEY, 'Low retains the kit sky');
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 keeps kit sky through scene changes and door content', () => {
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, SKY_KEY);
934
+ // A load to a keyless scene and back reads each scene key on either tier.
935
+ s.key = null;
936
+ t.frame(s, true, FIRST_WINDOW_MS + 16);
937
+ assert.equal(s.sky, null);
938
+ s.key = SKY_KEY;
939
+ assert.equal(s.sky, SKY_KEY, 'a keyed scene loaded on Low keeps its sky');
940
+ s.content = {};
941
+ t.frame(s, true, FIRST_WINDOW_MS + 32);
942
+ assert.equal(s.sky, SKY_KEY, 'Low retains a game scene sky too');
943
+ t.set('high');
944
+ t.frame(s, true, FIRST_WINDOW_MS + 48);
945
+ assert.equal(drawn(world, 'cone'), true, 'another deck content is not tier-mark culled');
946
+ assert.equal(s.sky, SKY_KEY);
947
+ assert.equal(Object.hasOwn(s, 'sky'), false);
948
+ });
949
+
950
+ test('low: shared model instances also stop drawing on High and restore authored visibility on Low', () => {
951
+ const { world, scene } = fakeWorld([{ id: 'cone', tier: LOW, components: GROUND }]);
952
+ const entry = world.nodes.get('cone');
953
+ entry.instancedRig = {};
954
+ entry.node.visible = true;
955
+ const t = makeTiers({ storage: memoryStorage(), deviceMemory: 8, levers: makeLevers({ boundsOf: bounds(0) }) });
956
+ const s = { ...scene, three: world };
957
+ t.set('high');
958
+ t.frame(s, true, 0);
959
+ assert.equal(drawn(world, 'cone'), false);
960
+ assert.equal(entry.node.visible, false, 'shared instances read ancestor visibility outside the graph');
961
+ entry.node.visible = true;
962
+ t.frame(s, true, 8);
963
+ assert.equal(entry.node.visible, false, 'caught within the look interval');
964
+ t.set('low');
965
+ t.frame(s, true, 16);
966
+ assert.equal(drawn(world, 'cone'), true);
967
+ assert.equal(entry.node.visible, true);
968
+ entry.node.visible = false;
969
+ t.set('high');
970
+ t.frame(s, true, 32);
971
+ t.set('low');
972
+ t.frame(s, true, 48);
973
+ assert.equal(entry.node.visible, false, 'an authored invisible root stays invisible');
974
+ });
975
+
976
+ test('low: the actor mark works without engine.sky; spawned marks remain untouched', () => {
977
+ const { world, scene } = fakeWorld([
978
+ { id: 'cone', tier: LOW, components: GROUND, at: [900, 0, 0] },
979
+ { id: 'spawned', tier: LOW, components: GROUND, spawned: true },
980
+ ]);
981
+ const t = makeTiers({ storage: memoryStorage(), deviceMemory: 8, levers: makeLevers({ boundsOf: bounds(0) }) });
982
+ const s = { ...scene, three: world };
983
+ t.set('high');
984
+ t.frame(s, true, 0);
985
+ assert.equal(drawn(world, 'cone'), false);
986
+ assert.equal(drawn(world, 'spawned'), true);
987
+ t.set('low');
988
+ t.frame(s, true, 16);
989
+ assert.equal(drawn(world, 'cone'), true);
990
+ assert.equal(drawn(world, 'spawned'), true);
991
+ });
992
+
993
+ test('low: keyless, unmarked scenes have the previous graph and no world flag', () => {
994
+ const old = fakeWorld(TOWN);
995
+ const next = fakeWorld(TOWN);
996
+ const lv = makeLevers({ boundsOf: bounds(0) });
997
+ const t = makeTiers({
998
+ storage: memoryStorage(),
999
+ deviceMemory: 8,
1000
+ levers: makeLevers({ boundsOf: bounds(0) }),
1001
+ });
1002
+ const s = keyedScene(next.scene, next.world, null);
1003
+ const picture = (world) => [...world.nodes].map(([id, e]) => [id, Boolean(e.node.parent)]);
1004
+ t.frame(s, true, 0);
1005
+ assert.deepEqual(picture(next.world), picture(old.world), 'High has the original graph');
1006
+ t.set('low');
1007
+ t.frame(s, true, 16);
1008
+ lv.apply(old.world, old.scene, 16);
1009
+ assert.deepEqual(picture(next.world), picture(old.world), 'Low has the same culling');
1010
+ assert.equal(t.levers.low, null);
1011
+ assert.equal(s.sky, null, 'a keyless scene reads no sky, as before');
1012
+ assert.deepEqual(Object.keys(s), Object.keys(keyedScene(next.scene, next.world, null)), 'nothing enumerable is added');
1013
+ t.set('high');
1014
+ t.frame(s, true, 32);
1015
+ lv.restore(old.world);
1016
+ assert.deepEqual(picture(next.world), picture(old.world), 'restored High has the same graph');
1017
+ assert.equal(Object.hasOwn(s, 'sky'), false, 'and the runtime is as it was');
1018
+ });
1019
+
770
1020
  // The hub system with `hub.tiers` absent: never a call into tiers.js, never a
771
1021
  // storage read, no harness handle. tiers.js is stubbed for hub.js so any call
772
1022
  // is counted.
@@ -782,6 +1032,8 @@ const url = (src) => 'data:text/javascript,' + encodeURIComponent(src);
782
1032
  register(
783
1033
  url(`
784
1034
  export async function resolve(specifier, context, next) {
1035
+ 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 };
1036
+ 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 };
785
1037
  if (specifier === 'castle-web-sdk') return { url: ${JSON.stringify(url(sdkStub))}, shortCircuit: true };
786
1038
  if (specifier.startsWith('@imports/castle.physics-2d/engine/')) return { url: ${JSON.stringify(url(mediaStub))}, shortCircuit: true };
787
1039
  if (specifier === '../client/pack.js') return { url: ${JSON.stringify(url(packStub))}, shortCircuit: true };
@@ -792,6 +1044,219 @@ register(
792
1044
  const { installSystem } = await import('../code/systems/hub.js');
793
1045
  const { deck } = await import('../code/client/state.js');
794
1046
 
1047
+ // Match the frame order: applyVisibility lifts/drops the actor Transform,
1048
+ // tiers decide attachment, then the engine syncs node positions for drawing.
1049
+ function visibilityWorld(actors, mode = 'low') {
1050
+ const setup = fakeWorld(actors);
1051
+ const scene = { ...setup.scene, three: setup.world };
1052
+ let system;
1053
+ installSystem({ registerSystem: (s) => (system = s) });
1054
+ system.stash = new Map();
1055
+ const lv = makeLevers({ boundsOf: bounds(0) });
1056
+ const tiers = makeTiers({ storage: memoryStorage(), deviceMemory: 8, levers: lv });
1057
+ tiers.set(mode);
1058
+ const frame = (now) => {
1059
+ system.applyVisibility(scene);
1060
+ tiers.frame(scene, true, now);
1061
+ for (const [id, { node }] of setup.world.nodes) {
1062
+ const at = scene.getActor(id)?.components.Transform;
1063
+ if (at) {
1064
+ node.position = { ...node.position, ...at };
1065
+ }
1066
+ }
1067
+ };
1068
+ return { ...setup, scene, lv, tiers, frame };
1069
+ }
1070
+
1071
+ function visibilityTest(name, fn) {
1072
+ test(name, () => {
1073
+ clearState();
1074
+ try {
1075
+ fn();
1076
+ } finally {
1077
+ clearState();
1078
+ }
1079
+ });
1080
+ }
1081
+
1082
+ const hiddenActor = (id, extra = {}, at = [10, 2, 0]) => ({
1083
+ id,
1084
+ at,
1085
+ components: { Transform: { x: at[0], y: at[1], z: at[2] }, Shape: {}, Solid: {}, ...extra },
1086
+ });
1087
+
1088
+ visibilityTest('place hidden: out then back to the same parent in the frame of each merge', () => {
1089
+ const actor = hiddenActor('trophy', { TownWardrobeItem: {} });
1090
+ assert.equal(classify(actor.components), 'game');
1091
+ const { world, scene, lv, frame } = visibilityWorld([actor]);
1092
+ const node = world.nodes.get(actor.id).node;
1093
+ const parent = new Obj('wardrobe');
1094
+ world.scene.add(parent);
1095
+ parent.add(node);
1096
+ node.add(new Obj('model'));
1097
+ frame(0);
1098
+ assert.equal(node.parent, parent);
1099
+ hub.hiddenAll.add(actor.id);
1100
+ mergeHidden();
1101
+ frame(16);
1102
+ assert.equal(node.parent, null, 'out inside the periodic look interval');
1103
+ assert.equal(parent.children.includes(node), false, 'whole subtree leaves the graph');
1104
+ assert.equal(lv.removed.get(node), parent);
1105
+ assert.equal(actor.components.Transform.y, -9998);
1106
+ hub.hiddenAll.clear();
1107
+ mergeHidden();
1108
+ frame(32);
1109
+ assert.equal(node.parent, parent, 'back in the frame applyVisibility lifts it');
1110
+ assert.equal(actor.components.Transform.y, 2);
1111
+ assert.equal(node.position.y, 2);
1112
+ assert.equal(lv.removed.has(node), false);
1113
+ assert.equal(scene.getActor(actor.id), actor, 'actor and its components remain');
1114
+ });
1115
+
1116
+ visibilityTest('place hidden: a shared hide overridden by shownMe stays in, a private hide takes it out', () => {
1117
+ const { world, frame } = visibilityWorld([hiddenActor('trophy')]);
1118
+ frame(0);
1119
+ hub.hiddenAll.add('trophy');
1120
+ hub.shownMe.add('trophy');
1121
+ mergeHidden();
1122
+ frame(16);
1123
+ assert.equal(drawn(world, 'trophy'), true);
1124
+ hub.hiddenMe.add('trophy');
1125
+ mergeHidden();
1126
+ frame(32);
1127
+ assert.equal(drawn(world, 'trophy'), false, 'private hide wins the merge');
1128
+ hub.hiddenMe.clear();
1129
+ mergeHidden();
1130
+ frame(48);
1131
+ assert.equal(drawn(world, 'trophy'), true);
1132
+ });
1133
+
1134
+ visibilityTest('place hidden: keep and NPCs go out, then retain their existing rules when shown', () => {
1135
+ const { world, frame } = visibilityWorld([
1136
+ { ...hiddenActor('kept', {}, [80, 2, 0]), tier: KEEP },
1137
+ hiddenActor('npc', { HubNpc: {}, Body: {} }),
1138
+ ]);
1139
+ frame(0);
1140
+ hub.hiddenAll = new Set(['kept', 'npc']);
1141
+ mergeHidden();
1142
+ frame(16);
1143
+ assert.equal(drawn(world, 'kept'), false);
1144
+ assert.equal(drawn(world, 'npc'), false);
1145
+ hub.hiddenAll.clear();
1146
+ mergeHidden();
1147
+ frame(32);
1148
+ assert.equal(drawn(world, 'kept'), true, 'keep exempts distance again');
1149
+ assert.equal(drawn(world, 'npc'), true, 'near NPC lifted this frame');
1150
+ });
1151
+
1152
+ visibilityTest('place hidden: showing while far stays out, showing within range uses the lifted Transform', () => {
1153
+ const actor = hiddenActor('wall', {}, [60, 2, 0]);
1154
+ const { world, frame } = visibilityWorld([actor]);
1155
+ frame(0);
1156
+ hub.hiddenAll.add(actor.id);
1157
+ mergeHidden();
1158
+ frame(16);
1159
+ assert.equal(drawn(world, actor.id), false);
1160
+ hub.hiddenAll.clear();
1161
+ mergeHidden();
1162
+ frame(32);
1163
+ assert.equal(drawn(world, actor.id), false, 'shown but still far');
1164
+ hub.hiddenAll.add(actor.id);
1165
+ mergeHidden();
1166
+ frame(48);
1167
+ world.camera.position.x = 60;
1168
+ hub.hiddenAll.clear();
1169
+ mergeHidden();
1170
+ assert.equal(world.nodes.get(actor.id).node.position.y, -9998, 'node pose still underground');
1171
+ frame(64);
1172
+ assert.equal(drawn(world, actor.id), true, 'lifted near pose wins this frame');
1173
+ });
1174
+
1175
+ visibilityTest('place hidden: High never takes it out, and restores after Low even while hidden', () => {
1176
+ const { world, tiers, frame } = visibilityWorld([hiddenActor('trophy')], 'high');
1177
+ frame(0);
1178
+ hub.hiddenAll.add('trophy');
1179
+ mergeHidden();
1180
+ frame(16);
1181
+ assert.equal(drawn(world, 'trophy'), true);
1182
+ tiers.set('low');
1183
+ frame(32);
1184
+ assert.equal(drawn(world, 'trophy'), false);
1185
+ tiers.set('high');
1186
+ frame(48);
1187
+ assert.equal(drawn(world, 'trophy'), true);
1188
+ hub.hiddenAll.clear();
1189
+ mergeHidden();
1190
+ frame(64);
1191
+ assert.equal(drawn(world, 'trophy'), true);
1192
+ });
1193
+
1194
+ visibilityTest('place hidden: Player, remote avatar and orbit own body roots stay attached', () => {
1195
+ const { world, scene, frame } = visibilityWorld([
1196
+ hiddenActor('self', { Player: {}, Body: {} }),
1197
+ { ...hiddenActor('remote', { Body: {} }), spawned: true },
1198
+ hiddenActor('own', { Body: {} }),
1199
+ { ...hiddenActor('spawned-prop', { TownWardrobeItem: {} }), spawned: true },
1200
+ ]);
1201
+ scene.multiplayer = { avatars: { actors: new Map([['p2', 'remote']]) } };
1202
+ scene.orbitOwnModel = 'own';
1203
+ const wear = new Obj('hat');
1204
+ world.nodes.get('remote').node.add(wear);
1205
+ frame(0);
1206
+ hub.hiddenAll = new Set(['self', 'remote', 'own', 'spawned-prop']);
1207
+ mergeHidden();
1208
+ frame(16);
1209
+ for (const id of ['self', 'remote', 'own']) {
1210
+ assert.equal(drawn(world, id), true, id);
1211
+ }
1212
+ assert.equal(wear.parent, world.nodes.get('remote').node);
1213
+ assert.equal(drawn(world, 'spawned-prop'), false, 'hidden spawned gameplay prop also goes out');
1214
+ });
1215
+
1216
+ visibilityTest('place hidden: clearing the session in place restores inside the look interval', () => {
1217
+ const { world, frame } = visibilityWorld([hiddenActor('trophy')]);
1218
+ hub.hiddenAll.add('trophy');
1219
+ mergeHidden();
1220
+ frame(0);
1221
+ const merged = hub.hidden;
1222
+ clearState();
1223
+ assert.equal(hub.hidden, merged, 'clear empties the set in place');
1224
+ frame(16);
1225
+ assert.equal(drawn(world, 'trophy'), true);
1226
+ });
1227
+
1228
+ visibilityTest('place hidden: instanced actor roots go out and back, otherwise retain their exemption', () => {
1229
+ const { world, frame } = visibilityWorld([hiddenActor('trophy', {}, [80, 2, 0])]);
1230
+ const entry = world.nodes.get('trophy');
1231
+ entry.instancedRig = new Obj('instance-rig');
1232
+ entry.node.add(entry.instancedRig);
1233
+ frame(0);
1234
+ assert.equal(drawn(world, 'trophy'), true, 'instancing still exempts the far rule');
1235
+ hub.hiddenAll.add('trophy');
1236
+ mergeHidden();
1237
+ frame(16);
1238
+ assert.equal(drawn(world, 'trophy'), false, 'root and rig leave the scene graph');
1239
+ assert.equal(entry.instancedRig.parent, entry.node);
1240
+ hub.hiddenAll.clear();
1241
+ mergeHidden();
1242
+ frame(32);
1243
+ assert.equal(drawn(world, 'trophy'), true, 'back while far, as before');
1244
+ });
1245
+
1246
+ visibilityTest('place hidden: a game through a door keeps only the place hide and shadow levers', () => {
1247
+ const { world, scene, frame } = visibilityWorld([hiddenActor('trophy')]);
1248
+ scene.content = {};
1249
+ frame(0);
1250
+ hub.hiddenAll.add('trophy');
1251
+ mergeHidden();
1252
+ frame(16);
1253
+ assert.equal(drawn(world, 'trophy'), false);
1254
+ hub.hiddenAll.clear();
1255
+ mergeHidden();
1256
+ frame(32);
1257
+ assert.equal(drawn(world, 'trophy'), true);
1258
+ });
1259
+
795
1260
  {
796
1261
  let storageReads = 0;
797
1262
  Object.defineProperty(globalThis, 'localStorage', {
@@ -806,10 +1271,16 @@ const { deck } = await import('../code/client/state.js');
806
1271
  let graphics = 0;
807
1272
  system.chrome = { setGraphics: () => (graphics += 1) };
808
1273
  const scene = { three: { renderer: {} }, content: null };
1274
+ const offRoot = new Obj('scene');
1275
+ const offNode = new Obj('hidden-trophy');
1276
+ offRoot.add(offNode);
1277
+ scene.three.nodes = new Map([['hidden-trophy', { node: offNode }]]);
809
1278
  const mp = { placed: () => true };
810
1279
  globalThis.__hub = {};
811
1280
  test('hub.tiers absent: no tiers system is registered, nothing made, run or read', () => {
812
1281
  assert.equal(deck.tiers, false, 'off unless castle.json says so');
1282
+ hub.hiddenAll.add('hidden-trophy');
1283
+ mergeHidden();
813
1284
  const late = [];
814
1285
  system.registerLate({ registerSystem: (s) => late.push(s) });
815
1286
  assert.equal(late.length, 1, 'only the late system the hub always had');
@@ -822,6 +1293,8 @@ const { deck } = await import('../code/client/state.js');
822
1293
  // deviceTier itself is guarded as well.
823
1294
  system.deviceTier(scene, mp, 0);
824
1295
  assert.equal(globalThis.__tiersMade, undefined);
1296
+ assert.equal(offNode.parent, offRoot, 'a place hide does not detach with tiers off');
1297
+ clearState();
825
1298
  });
826
1299
  test('hub.tiers true: a system of its own, made once, run each frame, a harness handle', () => {
827
1300
  deck.tiers = true;
@@ -844,7 +1317,7 @@ test('hub.js reaches the tiers only through a system registered behind the opt-i
844
1317
  assert.equal(src.match(/makeTiers\(/g)?.length, 1);
845
1318
  assert.equal(src.match(/this\.deviceTier\(/g)?.length, 1);
846
1319
  assert.match(src, /\n {4}if \(Hub\.deck\.tiers\) \{\n {6}scene\.registerSystem\(\{ afterBehaviors: \(s\) => this\.deviceTier\(/);
847
- const afterBehaviors = src.slice(src.indexOf(' afterBehaviors(scene) {'), src.indexOf('\n }\n', src.indexOf(' afterBehaviors(scene) {')));
1320
+ const afterBehaviors = src.slice(src.indexOf(' afterBehaviors(scene, dt) {'), src.indexOf('\n }\n', src.indexOf(' afterBehaviors(scene, dt) {')));
848
1321
  assert.doesNotMatch(afterBehaviors, /deviceTier|tiers/i, 'the per-frame update is the one it was');
849
1322
  const body = src.slice(src.indexOf(' deviceTier(scene, mp, now) {'));
850
1323
  assert.match(body, /^ {2}deviceTier\(scene, mp, now\) \{\n {4}if \(!Hub\.deck\.tiers\) \{\n {6}return;\n {4}\}/);
@@ -852,3 +1325,4 @@ test('hub.js reaches the tiers only through a system registered behind the opt-i
852
1325
  });
853
1326
 
854
1327
  console.log(`test-tiers: ${n} passed`);
1328
+ await import('./test-tiers-render.mjs');
@@ -0,0 +1,61 @@
1
+ // The toast's band, held without a DOM.
2
+ import test from 'node:test';
3
+ import assert from 'node:assert/strict';
4
+ import { toastBand } from '../code/client/toastBand.js';
5
+
6
+ const view = { desktop: false, viewW: 360, viewH: 800, width: 200, height: 36, gap: 6 };
7
+ const wide = { ...view, desktop: true };
8
+ const rect = (top, bottom, left = 60, right = 300) => ({ left, right, top, bottom });
9
+
10
+ test('phone: under the HUD, and under a question too', () => {
11
+ assert.deepEqual(toastBand({ ...view, rects: [rect(12, 100)] }), { top: 106 });
12
+ assert.deepEqual(toastBand({ ...view, rects: [rect(12, 100), rect(92, 154)] }), { top: 160 });
13
+ });
14
+ test('a phone toast starts under the safe area, and is kept clear of a HUD that starts there too', () => {
15
+ assert.deepEqual(toastBand({ ...view, start: 59 }), { top: 59 });
16
+ assert.deepEqual(toastBand({ ...view, start: 59, rects: [rect(59, 135)] }), { top: 141 });
17
+ assert.deepEqual(toastBand({ ...wide, start: 59 }), { bottom: 64 }, 'a desktop toast starts from the bottom');
18
+ });
19
+ test('nothing in the way keeps the phone and desktop starts', () => {
20
+ assert.deepEqual(toastBand(view), { top: 12 });
21
+ assert.deepEqual(toastBand(wide), { bottom: 64 });
22
+ assert.deepEqual(toastBand({ ...view, rects: [rect(700, 736)] }), { top: 12 }, 'Talk at the bottom is not in a phone toast\'s way');
23
+ assert.deepEqual(toastBand({ ...wide, rects: [rect(12, 52)] }), { bottom: 64 }, 'a top Back is not in a desktop toast\'s way');
24
+ });
25
+ test('desktop: above Talk, then above Talk, Sit, Near and the chip', () => {
26
+ const rects = [rect(700, 736), rect(648, 688), rect(610, 640), rect(564, 598)];
27
+ assert.deepEqual(toastBand({ ...wide, rects: rects.slice(0, 1) }), { bottom: 106 });
28
+ assert.deepEqual(toastBand({ ...wide, rects }), { bottom: 242 });
29
+ });
30
+ test('only what crosses the toast\'s span is in its way', () => {
31
+ const beside = [rect(0, 790, 0, 80), rect(0, 790, 280, 360)];
32
+ assert.deepEqual(toastBand({ ...view, rects: beside }), { top: 12 });
33
+ assert.deepEqual(toastBand({ ...wide, rects: beside }), { bottom: 64 });
34
+ assert.deepEqual(toastBand({ ...view, rects: [...beside, rect(12, 90)] }), { top: 96 });
35
+ });
36
+ test('a phone on its side: under a question the toast is moved past the invite button too', () => {
37
+ const side = { ...view, viewW: 800, viewH: 360 };
38
+ const hud = rect(12, 60, 300, 500);
39
+ const ask = rect(92, 154, 240, 560);
40
+ const near = rect(170, 200, 280, 520);
41
+ assert.deepEqual(toastBand({ ...side, rects: [hud, ask] }), { top: 160 });
42
+ assert.deepEqual(toastBand({ ...side, rects: [hud, ask, near] }), { top: 206 });
43
+ // No clear place at all: the last place tried that the view holds, under
44
+ // the question and the invite button.
45
+ const talk = rect(230, 296, 280, 520);
46
+ assert.deepEqual(toastBand({ ...side, rects: [hud, ask, near, talk, rect(300, 360, 0, 800)] }), { top: 302 });
47
+ });
48
+ test('a desktop toast with no clear place stays at the last place tried that the view holds', () => {
49
+ const short = { ...wide, viewW: 700, viewH: 200, width: 600 };
50
+ const back = rect(12, 52, 12, 100);
51
+ const talk = rect(100, 136, 250, 450);
52
+ assert.deepEqual(toastBand({ ...short, rects: [talk] }), { bottom: 106 });
53
+ assert.deepEqual(toastBand({ ...short, rects: [back, talk] }), { bottom: 106 }, 'the place over Talk meets Back and nothing higher is in the view');
54
+ assert.deepEqual(toastBand({ ...short, viewH: 400, rects: [rect(12, 52, 12, 100), rect(300, 336, 250, 450)] }), { bottom: 106 });
55
+ });
56
+ test('the box is kept in the view where it fits', () => {
57
+ assert.deepEqual(toastBand({ ...view, rects: [rect(12, 799)] }), { top: 764 });
58
+ assert.deepEqual(toastBand({ ...wide, rects: [rect(1, 790)] }), { bottom: 764 });
59
+ assert.deepEqual(toastBand({ ...view, viewH: 20 }), { top: 0 });
60
+ assert.deepEqual(toastBand({ ...wide, viewH: 20 }), { bottom: 0 });
61
+ });