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
@@ -0,0 +1,706 @@
1
+ // Tests over the visibility cells of device tiers (code/client/tiers.js): the
2
+ // scene file's `cells` table read strictly (anything malformed is no table),
3
+ // an actor's `cell` field (a string or a list, known ids only), the eye's cell
4
+ // with hysteresis and eyeMax, and on a fake physics-3d world the Low levers
5
+ // taking out what the eye's cell does not see -- `"tier": "keep"` and gameplay
6
+ // actors included, a list drawn when any of its cells is seen -- at once on a
7
+ // change of cell, never in a game through a door, and a scene without the key
8
+ // drawn exactly as before. Last the harness handle's A/B, restore, and the
9
+ // opt-in overlay. `npm run check` runs this.
10
+
11
+ import assert from 'node:assert/strict';
12
+ import {
13
+ CHECK_EVERY_MS,
14
+ CELL_INERT,
15
+ CELL_PROTECTED,
16
+ cellInert,
17
+ actorCells,
18
+ eyeCell,
19
+ insideOutline,
20
+ makeLevers,
21
+ makeTiers,
22
+ outlineDistance,
23
+ readCells,
24
+ } from '../code/client/tiers.js';
25
+
26
+ let n = 0;
27
+ function test(name, fn) {
28
+ try {
29
+ fn();
30
+ } catch (err) {
31
+ console.error(`not ok: ${name}`);
32
+ throw err;
33
+ }
34
+ n += 1;
35
+ }
36
+
37
+ // Three cells in a row along x: a [-10, 0], b [0, 10], c [10, 20], z [-10, 10].
38
+ // a sees b, b sees both, c sees b.
39
+ const box = (x0, x1) => [[x0, -10], [x1, -10], [x1, 10], [x0, 10]];
40
+ const CELLS = () => ({
41
+ version: 1,
42
+ eyeMax: 14,
43
+ hysteresis: 2,
44
+ cells: [
45
+ { id: 'a', outline: box(-10, 0), sees: ['a', 'b'], why: 'test' },
46
+ { id: 'b', outline: box(0, 10), sees: ['a', 'b', 'c'] },
47
+ { id: 'c', outline: box(10, 20), sees: ['b', 'c'] },
48
+ ],
49
+ });
50
+
51
+ const GROUND = { Transform: {}, Shape: {}, Model: {} };
52
+ const WALL = { Transform: {}, Shape: {}, Solid: {} };
53
+ const SEAT = { Transform: {}, Shape: {}, HubSeat: {} };
54
+ const ACTORS = [
55
+ { id: 'wall-a', components: WALL, at: [-5, 0, 0], cell: 'a' },
56
+ { id: 'wall-b', components: WALL, at: [5, 0, 0], cell: 'b' },
57
+ { id: 'wall-c', components: WALL, at: [15, 0, 0], cell: 'c' },
58
+ { id: 'paving-c', components: GROUND, at: [15, 0, 0], cell: 'c', tier: 'keep' },
59
+ { id: 'seat-c', components: SEAT, at: [15, 0, 0], cell: 'c' },
60
+ { id: 'arch-ac', components: WALL, at: [5, 0, 0], cell: ['a', 'c'] },
61
+ { id: 'wall-unknown', components: WALL, at: [15, 0, 0], cell: 'zz' },
62
+ { id: 'wall-mixed', components: WALL, at: [15, 0, 0], cell: ['c', 'zz'] },
63
+ { id: 'wall-empty', components: WALL, at: [15, 0, 0], cell: [] },
64
+ { id: 'wall-number', components: WALL, at: [15, 0, 0], cell: 3 },
65
+ // Untagged: the old rules alone.
66
+ { id: 'lamp', components: GROUND, at: [3, 0, 3] },
67
+ { id: 'wall-far', components: WALL, at: [60, 0, 0] },
68
+ { id: 'npc-far', components: { Transform: {}, Body: {}, HubNpc: {}, Model: {} }, at: [0, 0, 25] },
69
+ { id: 'wear:p1:0', components: GROUND, at: [1, 0, 1], spawned: true, cell: 'c' },
70
+ ];
71
+
72
+ class Obj {
73
+ constructor(name, at = [0, 0, 0]) {
74
+ this.name = name;
75
+ this.parent = null;
76
+ this.children = [];
77
+ this.position = { x: at[0], y: at[1], z: at[2] };
78
+ }
79
+ add(o) {
80
+ o.parent?.remove(o);
81
+ o.parent = this;
82
+ this.children.push(o);
83
+ return this;
84
+ }
85
+ remove(o) {
86
+ const i = this.children.indexOf(o);
87
+ if (i >= 0) {
88
+ this.children.splice(i, 1);
89
+ o.parent = null;
90
+ }
91
+ return this;
92
+ }
93
+ }
94
+
95
+ // `cells`: the file's `cells` key (undefined: none). `fields`: whether actors
96
+ // carry their `cell` field in the file.
97
+ function fakeWorld(actors, opts = {}) {
98
+ const { fields = true, eye = [-5, 2, 0] } = opts;
99
+ const cells = 'cells' in opts ? opts.cells : CELLS();
100
+ const root = new Obj('scene');
101
+ const world = {
102
+ scene: root,
103
+ camera: { position: { x: eye[0], y: eye[1], z: eye[2] } },
104
+ nodes: new Map(),
105
+ scenePath: 'scenes/main.scene',
106
+ };
107
+ for (const a of actors) {
108
+ const node = new Obj(a.id, a.at);
109
+ root.add(node);
110
+ world.nodes.set(a.id, { node });
111
+ }
112
+ const byId = new Map(actors.map((a) => [a.id, a]));
113
+ const file = () => {
114
+ const out = {
115
+ actors: actors
116
+ .filter((a) => !a.spawned)
117
+ .map((a) => {
118
+ const f = { id: a.id };
119
+ if ('tier' in a) {
120
+ f.tier = a.tier;
121
+ }
122
+ if (fields && 'cell' in a) {
123
+ f.cell = a.cell;
124
+ }
125
+ return f;
126
+ }),
127
+ };
128
+ if (cells !== undefined) {
129
+ out.cells = cells;
130
+ }
131
+ return out;
132
+ };
133
+ let reads = 0;
134
+ const scene = {
135
+ content: null,
136
+ data: {},
137
+ scenePath: 'scenes/main.scene',
138
+ readFromFile: () => {
139
+ reads += 1;
140
+ return file();
141
+ },
142
+ getActor: (id) => byId.get(id),
143
+ };
144
+ const eyeAt = (x, y, z) => {
145
+ world.camera.position = { x, y, z };
146
+ };
147
+ return { world, scene, eyeAt, reads: () => reads };
148
+ }
149
+
150
+ const bounds = () => ({ dx: 0, dy: 0, dz: 0, r: 0 });
151
+ const drawn = (world, id) => world.nodes.get(id).node.parent === world.scene;
152
+ const out = (world) => [...world.nodes].filter(([, e]) => e.node.parent !== world.scene).map(([id]) => id).sort();
153
+
154
+ // The table.
155
+
156
+ test('readCells: a good table', () => {
157
+ const t = readCells(CELLS());
158
+ assert.deepEqual([t.eyeMax, t.hysteresis], [14, 2]);
159
+ assert.deepEqual(t.cells.map((c) => c.id), ['a', 'b', 'c']);
160
+ assert.ok(t.byId.get('b').sees instanceof Set);
161
+ assert.deepEqual([...t.byId.get('c').sees], ['b', 'c']);
162
+ assert.equal(readCells({ ...CELLS(), hysteresis: 0 }).hysteresis, 0);
163
+ });
164
+
165
+ test('readCells: anything malformed is no table', () => {
166
+ const bad = (edit) => {
167
+ const v = CELLS();
168
+ edit(v);
169
+ return v;
170
+ };
171
+ const cases = {
172
+ 'not an object': 'cells',
173
+ null: null,
174
+ 'version 2': bad((v) => (v.version = 2)),
175
+ 'version "1"': bad((v) => (v.version = '1')),
176
+ 'no version': bad((v) => delete v.version),
177
+ 'no cells array': bad((v) => delete v.cells),
178
+ 'cells an object': bad((v) => (v.cells = { a: v.cells[0] })),
179
+ 'no cells': bad((v) => (v.cells = [])),
180
+ 'eyeMax missing': bad((v) => delete v.eyeMax),
181
+ 'eyeMax NaN': bad((v) => (v.eyeMax = NaN)),
182
+ 'eyeMax a string': bad((v) => (v.eyeMax = '14')),
183
+ 'hysteresis Infinity': bad((v) => (v.hysteresis = Infinity)),
184
+ 'hysteresis negative': bad((v) => (v.hysteresis = -1)),
185
+ 'a null cell': bad((v) => (v.cells[1] = null)),
186
+ 'id a number': bad((v) => (v.cells[1].id = 2)),
187
+ 'id empty': bad((v) => (v.cells[1].id = '')),
188
+ 'duplicate id': bad((v) => (v.cells[2].id = 'a')),
189
+ 'outline missing': bad((v) => delete v.cells[0].outline),
190
+ 'outline of two points': bad((v) => (v.cells[0].outline = [[0, 0], [1, 1]])),
191
+ 'outline point of three numbers': bad((v) => (v.cells[0].outline[1] = [0, 0, 0])),
192
+ 'outline point NaN': bad((v) => (v.cells[0].outline[2] = [NaN, 0])),
193
+ 'outline point a string': bad((v) => (v.cells[0].outline[2] = ['1', 0])),
194
+ 'outline point an object': bad((v) => (v.cells[0].outline[2] = { x: 0, z: 0 })),
195
+ 'sees missing': bad((v) => delete v.cells[0].sees),
196
+ 'sees a string': bad((v) => (v.cells[0].sees = 'a')),
197
+ 'sees an unknown id': bad((v) => v.cells[0].sees.push('zz')),
198
+ 'sees nothing (review P2)': bad((v) => (v.cells[1].sees = [])),
199
+ 'sees others but not itself (review P2)': bad((v) => (v.cells[2].sees = ['b'])),
200
+ 'sees a number': bad((v) => v.cells[0].sees.push(1)),
201
+ };
202
+ for (const [name, value] of Object.entries(cases)) {
203
+ assert.equal(readCells(value), null, name);
204
+ }
205
+ });
206
+
207
+ test('actorCells: a string, a list, and anything else is no cell', () => {
208
+ const t = readCells(CELLS());
209
+ assert.deepEqual(actorCells('a', t), ['a']);
210
+ assert.deepEqual(actorCells(['a', 'c'], t), ['a', 'c']);
211
+ assert.equal(actorCells('zz', t), null, 'an unknown id');
212
+ assert.equal(actorCells(['a', 'zz'], t), null, 'one unknown id in a list');
213
+ assert.equal(actorCells([], t), null, 'an empty list');
214
+ assert.equal(actorCells('', t), null);
215
+ assert.equal(actorCells(['a', 3], t), null);
216
+ assert.equal(actorCells(3, t), null);
217
+ assert.equal(actorCells(undefined, t), null);
218
+ assert.equal(actorCells({ a: true }, t), null);
219
+ assert.equal(actorCells('a', null), null, 'no table');
220
+ });
221
+
222
+ // The eye.
223
+
224
+ test('insideOutline and outlineDistance', () => {
225
+ const sq = box(0, 10);
226
+ assert.equal(insideOutline(sq, 5, 0), true);
227
+ assert.equal(insideOutline(sq, 11, 0), false);
228
+ assert.equal(insideOutline(sq, 5, 11), false);
229
+ // A concave L: the notch is outside.
230
+ const l = [[0, 0], [10, 0], [10, 4], [4, 4], [4, 10], [0, 10]];
231
+ assert.equal(insideOutline(l, 2, 8), true);
232
+ assert.equal(insideOutline(l, 8, 8), false);
233
+ assert.equal(outlineDistance(sq, 12, 0), 2);
234
+ assert.equal(outlineDistance(sq, 13, 14), 5);
235
+ assert.equal(outlineDistance(sq, 5, 0), 5);
236
+ });
237
+
238
+ test('eyeCell: hysteresis keeps a cell across a border by less than its width, switches past it', () => {
239
+ const t = readCells(CELLS());
240
+ assert.equal(eyeCell(t, null, 5, 0), 'b');
241
+ assert.equal(eyeCell(t, 'b', 11, 0), 'b', '1 m into c: still b');
242
+ assert.equal(eyeCell(t, 'b', 12, 0), 'b', '2 m into c: still b');
243
+ assert.equal(eyeCell(t, 'b', 12.5, 0), 'c', '2.5 m into c: c');
244
+ assert.equal(eyeCell(t, 'c', 9, 0), 'c', 'and back 1 m into b: still c');
245
+ assert.equal(eyeCell(t, 'c', 7.5, 0), 'b');
246
+ assert.equal(eyeCell(t, 'c', 21.5, 0), null, 'outside every outline, even within the hysteresis: no cell (review round 2)');
247
+ assert.equal(eyeCell(t, 'c', 19.9, 0), 'c', 'just inside the outer edge: c');
248
+ assert.equal(eyeCell(t, 'b', 50, 0), null, 'outside every outline: no cell (review P1)');
249
+ assert.equal(eyeCell(t, 'c', 23, 0), null, 'just past the hysteresis off the table: no cell');
250
+ assert.equal(eyeCell(t, null, 50, 0), null, 'never found: none');
251
+ assert.equal(eyeCell(t, null, NaN, 0), null);
252
+ for (const [x, z] of [[NaN, 0], [0, NaN], [Infinity, 0], [0, -Infinity], [undefined, 0]]) {
253
+ assert.equal(eyeCell(t, 'a', x, z), null, `non-finite eye ${x}, ${z}: no cell`);
254
+ }
255
+ assert.equal(eyeCell(t, 'gone', 5, 0), 'b', 'a cell not in the table is found again');
256
+ });
257
+
258
+ // The levers.
259
+
260
+ test('Low: what the eye cell does not see is out, keep-marked inert scenery included, a seat never; a list is drawn when any cell is seen', () => {
261
+ const { world, scene, eyeAt } = fakeWorld(ACTORS);
262
+ const lv = makeLevers({ boundsOf: bounds });
263
+ lv.apply(world, scene, 0);
264
+ assert.equal(lv.cell, 'a');
265
+ // From a: c is not seen.
266
+ assert.deepEqual(out(world), ['lamp', 'npc-far', 'paving-c', 'wall-c', 'wall-far']);
267
+ assert.equal(drawn(world, 'seat-c'), true, 'a seat reacts to players: never out for its cell');
268
+ assert.equal(lv.cellHidden, 2);
269
+ assert.equal(lv.hidden, 5);
270
+ assert.equal(drawn(world, 'arch-ac'), true, 'a list with a seen cell is drawn');
271
+ for (const id of ['wall-unknown', 'wall-mixed', 'wall-empty', 'wall-number']) {
272
+ assert.equal(drawn(world, id), true, `${id}: no cell, never out for cells`);
273
+ }
274
+ assert.equal(drawn(world, 'wear:p1:0'), true, 'a spawned actor is never out');
275
+ // Into c (past the hysteresis): a goes, c comes back, at once.
276
+ eyeAt(15, 2, 0);
277
+ lv.apply(world, scene, 16);
278
+ assert.equal(lv.cell, 'c');
279
+ assert.deepEqual(out(world), ['lamp', 'npc-far', 'wall-a', 'wall-far']);
280
+ assert.equal(drawn(world, 'arch-ac'), true);
281
+ assert.equal(lv.cellHidden, 1);
282
+ assert.deepEqual(lv.pop, { from: 'a', to: 'c', back: 2, out: 1, at: 16 });
283
+ // From b everything is seen: only the old rules.
284
+ eyeAt(5, 2, 0);
285
+ lv.apply(world, scene, 32);
286
+ assert.deepEqual(out(world), ['lamp', 'npc-far', 'wall-far']);
287
+ assert.equal(lv.cellHidden, 0);
288
+ });
289
+
290
+ test('Low: near and cells compose: either takes a node out, it comes back only when neither does', () => {
291
+ // Pure scenery (decor: always out on Low unmarked) marked near, in cells c and b.
292
+ const actors = [
293
+ { id: 'flag-near-c', components: GROUND, at: [15, 0, 0], cell: 'c', tier: 'near' },
294
+ { id: 'flag-near-b', components: GROUND, at: [5, 0, 0], cell: 'b', tier: 'near' },
295
+ ];
296
+ const { world, scene, eyeAt } = fakeWorld(actors);
297
+ const lv = makeLevers({ boundsOf: bounds });
298
+ // Eye in a, within 30 m of both: c is not seen, so the near one in c is out for cells.
299
+ lv.apply(world, scene, 0);
300
+ assert.deepEqual(out(world), ['flag-near-c']);
301
+ assert.equal(lv.cellHidden, 1);
302
+ // Eye in b, which sees c: near and seen, back.
303
+ eyeAt(5, 2, 0);
304
+ lv.apply(world, scene, 16);
305
+ assert.deepEqual(out(world), []);
306
+ // Both moved 60 m off while the eye stays in b: out for near, none for cells.
307
+ eyeAt(5, 2, 0);
308
+ world.nodes.get('flag-near-c').node.position.z = 60;
309
+ world.nodes.get('flag-near-b').node.position.z = 60;
310
+ lv.apply(world, scene, 1200);
311
+ assert.deepEqual(out(world), ['flag-near-b', 'flag-near-c']);
312
+ assert.equal(lv.cellHidden, 0);
313
+ // Near again: neither rule applies, both back.
314
+ world.nodes.get('flag-near-c').node.position.z = 0;
315
+ world.nodes.get('flag-near-b').node.position.z = 0;
316
+ lv.apply(world, scene, 1800);
317
+ assert.deepEqual(out(world), []);
318
+ });
319
+
320
+ test('Low: a list is out only when none of its cells is seen', () => {
321
+ const t = CELLS();
322
+ t.cells[1].sees = ['b'];
323
+ const { world, scene, eyeAt } = fakeWorld(ACTORS, { cells: t, eye: [5, 2, 0] });
324
+ const lv = makeLevers({ boundsOf: bounds });
325
+ lv.apply(world, scene, 0);
326
+ assert.equal(drawn(world, 'arch-ac'), false);
327
+ assert.equal(drawn(world, 'wall-b'), true);
328
+ eyeAt(-5, 2, 0);
329
+ lv.apply(world, scene, 16);
330
+ assert.equal(drawn(world, 'arch-ac'), true);
331
+ });
332
+
333
+ test('Low: over eyeMax everything is drawn for cells; back down, the cell decides again at once', () => {
334
+ const { world, scene, eyeAt } = fakeWorld(ACTORS);
335
+ const lv = makeLevers({ boundsOf: bounds });
336
+ lv.apply(world, scene, 0);
337
+ assert.equal(drawn(world, 'wall-c'), false);
338
+ eyeAt(-5, 20, 0);
339
+ lv.apply(world, scene, 16);
340
+ assert.equal(lv.cellKey, null);
341
+ assert.equal(lv.cell, 'a', 'the cell is still followed');
342
+ assert.equal(drawn(world, 'wall-c'), true);
343
+ assert.equal(drawn(world, 'paving-c'), true);
344
+ assert.equal(lv.cellHidden, 0);
345
+ eyeAt(-5, 2, 0);
346
+ lv.apply(world, scene, 32);
347
+ assert.equal(drawn(world, 'wall-c'), false);
348
+ });
349
+
350
+ test('Low: no cell found yet (the eye outside every outline) draws everything; the border wobble does not re-look', () => {
351
+ const { world, scene, eyeAt, reads } = fakeWorld(ACTORS, { eye: [100, 2, 0] });
352
+ const lv = makeLevers({ boundsOf: bounds });
353
+ lv.apply(world, scene, 0);
354
+ assert.equal(lv.cell, null);
355
+ assert.equal(lv.cellHidden, 0);
356
+ eyeAt(5, 2, 0);
357
+ lv.apply(world, scene, 16);
358
+ assert.equal(lv.cell, 'b');
359
+ // Walking about inside b's hysteresis: no new look before CHECK_EVERY_MS.
360
+ let passes = 0;
361
+ const nodes = world.nodes;
362
+ world.nodes = new Proxy(nodes, {
363
+ get(target, key) {
364
+ if (key === Symbol.iterator) {
365
+ passes += 1;
366
+ }
367
+ const v = Reflect.get(target, key, target);
368
+ return typeof v === 'function' ? v.bind(target) : v;
369
+ },
370
+ });
371
+ // Keep the map the levers saw, so this is not a swap.
372
+ lv.seen.nodes = world.nodes;
373
+ for (let i = 0; i < 10; i += 1) {
374
+ eyeAt(11 + (i % 2), 2, 0);
375
+ lv.apply(world, scene, 20 + i);
376
+ }
377
+ assert.equal(passes, 0);
378
+ assert.equal(reads(), 1);
379
+ world.nodes = nodes;
380
+ });
381
+
382
+ test('Low: a game through a door hides nothing for cells', () => {
383
+ const { world, scene } = fakeWorld(ACTORS);
384
+ const lv = makeLevers({ boundsOf: bounds });
385
+ lv.apply(world, scene, 0);
386
+ assert.equal(lv.cellHidden, 2);
387
+ lv.apply(world, scene, 16, { actors: false });
388
+ assert.deepEqual(out(world), []);
389
+ assert.equal(lv.cellHidden, 0);
390
+ });
391
+
392
+ test('a scene without the key is drawn exactly as before, `cell` fields or none, and so is a malformed table', () => {
393
+ const look = (opts, eye) => {
394
+ const { world, scene, eyeAt } = fakeWorld(ACTORS, opts);
395
+ const lv = makeLevers({ boundsOf: bounds });
396
+ const sets = [];
397
+ for (const [i, [x, y, z]] of eye.entries()) {
398
+ eyeAt(x, y, z);
399
+ lv.apply(world, scene, i * (CHECK_EVERY_MS + 1));
400
+ sets.push(out(world));
401
+ }
402
+ return { sets, lv };
403
+ };
404
+ const walk = [[-5, 2, 0], [15, 2, 0], [5, 2, 0], [55, 2, 0]];
405
+ const plain = look({ cells: undefined, fields: false }, walk);
406
+ const tagged = look({ cells: undefined, fields: true }, walk);
407
+ const broken = look({ cells: { ...CELLS(), version: 2 }, fields: true }, walk);
408
+ assert.deepEqual(tagged.sets, plain.sets);
409
+ assert.deepEqual(broken.sets, plain.sets);
410
+ assert.deepEqual(plain.sets[0], ['lamp', 'npc-far', 'wall-far']);
411
+ for (const { lv } of [plain, tagged, broken]) {
412
+ assert.equal(lv.cells, null);
413
+ assert.equal(lv.actorCells, null);
414
+ assert.equal(lv.cell, null);
415
+ assert.equal(lv.cellHidden, 0);
416
+ assert.equal(lv.pop, null);
417
+ }
418
+ });
419
+
420
+ test('handle: cell, cellHidden, and cells(false) puts cell-hidden nodes back on the next frame', () => {
421
+ const { world, scene, eyeAt } = fakeWorld(ACTORS);
422
+ const t = makeTiers({ storage: null, deviceMemory: 1, levers: makeLevers({ boundsOf: bounds }) });
423
+ const s = { ...scene, three: world };
424
+ t.frame(s, true, 0);
425
+ assert.equal(t.handle.current, 'low');
426
+ assert.equal(t.handle.cell, 'a');
427
+ assert.equal(t.handle.cellHidden, 2);
428
+ assert.equal(t.handle.hidden, 5);
429
+ t.handle.cells(false);
430
+ t.frame(s, true, 16);
431
+ assert.deepEqual(out(world), ['lamp', 'npc-far', 'wall-far']);
432
+ assert.equal(t.handle.cellHidden, 0);
433
+ assert.equal(t.handle.cell, 'a', 'the eye is still followed');
434
+ eyeAt(15, 2, 0);
435
+ t.frame(s, true, 32);
436
+ assert.equal(t.handle.cell, 'c');
437
+ assert.equal(drawn(world, 'wall-a'), true, 'off stays off');
438
+ t.handle.cells(true);
439
+ t.frame(s, true, 48);
440
+ assert.equal(drawn(world, 'wall-a'), false);
441
+ assert.equal(t.handle.cellHidden, 1);
442
+ // High: everything back, the cell forgotten.
443
+ t.handle.set('high');
444
+ t.frame(s, true, 64);
445
+ assert.deepEqual(out(world), []);
446
+ assert.equal(t.handle.cell, null);
447
+ assert.equal(t.handle.cellHidden, 0);
448
+ });
449
+
450
+ // The overlay: a fake document that counts what is made.
451
+ function fakeDocument() {
452
+ const made = [];
453
+ const body = { children: [], appendChild: (el) => body.children.push(el) };
454
+ const doc = {
455
+ body,
456
+ made,
457
+ createElement: (tag) => {
458
+ const el = {
459
+ tag,
460
+ style: {},
461
+ textContent: '',
462
+ remove: () => {
463
+ body.children = body.children.filter((c) => c !== el);
464
+ },
465
+ };
466
+ made.push(el);
467
+ return el;
468
+ },
469
+ };
470
+ return doc;
471
+ }
472
+
473
+ function withGlobals(globals, fn) {
474
+ const before = new Map(Object.keys(globals).map((k) => [k, Object.getOwnPropertyDescriptor(globalThis, k)]));
475
+ for (const [k, v] of Object.entries(globals)) {
476
+ Object.defineProperty(globalThis, k, { configurable: true, writable: true, value: v });
477
+ }
478
+ try {
479
+ fn();
480
+ } finally {
481
+ for (const [k, d] of before) {
482
+ if (d) {
483
+ Object.defineProperty(globalThis, k, d);
484
+ } else {
485
+ delete globalThis[k];
486
+ }
487
+ }
488
+ }
489
+ }
490
+
491
+ test('overlay: never made without the opt-in', () => {
492
+ const doc = fakeDocument();
493
+ withGlobals({ document: doc, location: { search: '?foo=1&hubcells=0' } }, () => {
494
+ const { world, scene, eyeAt } = fakeWorld(ACTORS);
495
+ const lv = makeLevers({ boundsOf: bounds });
496
+ lv.apply(world, scene, 0);
497
+ eyeAt(15, 2, 0);
498
+ lv.apply(world, scene, 16);
499
+ lv.restore(world);
500
+ });
501
+ assert.equal(doc.made.length, 0);
502
+ });
503
+
504
+ test('overlay: ?hubcells=1 shows the cell, what is out and the last pop; restore removes it', () => {
505
+ const doc = fakeDocument();
506
+ withGlobals({ document: doc, location: { search: '?hubcells=1' } }, () => {
507
+ const { world, scene, eyeAt } = fakeWorld(ACTORS);
508
+ const lv = makeLevers({ boundsOf: bounds });
509
+ lv.apply(world, scene, 0);
510
+ assert.equal(doc.made.length, 1);
511
+ assert.equal(doc.body.children.length, 1);
512
+ const el = doc.made[0];
513
+ assert.match(el.style.cssText, /pointer-events:none/);
514
+ assert.match(el.textContent, /^cell a\n/);
515
+ assert.match(el.textContent, /out: cells 2, other 3/);
516
+ eyeAt(15, 2, 0);
517
+ lv.apply(world, scene, 1016);
518
+ assert.match(el.textContent, /pop a -> c: \+2 back, -1 out, 0\.0s ago/);
519
+ eyeAt(15, 30, 0);
520
+ lv.apply(world, scene, 1032);
521
+ assert.match(el.textContent, /^cell c \(all drawn\)/);
522
+ assert.equal(doc.made.length, 1, 'made once');
523
+ lv.restore(world);
524
+ assert.equal(doc.body.children.length, 0, 'gone with restore');
525
+ assert.deepEqual(out(world), []);
526
+ });
527
+ });
528
+
529
+ test('overlay: globalThis.__hubCellsDebug, and a scene without the key makes none', () => {
530
+ const doc = fakeDocument();
531
+ withGlobals({ document: doc, __hubCellsDebug: true }, () => {
532
+ const plain = fakeWorld(ACTORS, { cells: undefined });
533
+ makeLevers({ boundsOf: bounds }).apply(plain.world, plain.scene, 0);
534
+ assert.equal(doc.made.length, 0, 'no table, no overlay');
535
+ const { world, scene } = fakeWorld(ACTORS);
536
+ makeLevers({ boundsOf: bounds }).apply(world, scene, 0);
537
+ assert.equal(doc.made.length, 1);
538
+ });
539
+ // No document at all: nothing thrown.
540
+ withGlobals({ __hubCellsDebug: true }, () => {
541
+ const { world, scene } = fakeWorld(ACTORS);
542
+ const lv = makeLevers({ boundsOf: bounds });
543
+ lv.apply(world, scene, 0);
544
+ assert.equal(lv.overlay, null);
545
+ assert.equal(lv.cellHidden, 2);
546
+ });
547
+ });
548
+
549
+ test('restore puts back everything, cell-hidden and keep-marked alike', () => {
550
+ const { world, scene } = fakeWorld(ACTORS);
551
+ const lv = makeLevers({ boundsOf: bounds });
552
+ lv.apply(world, scene, 0);
553
+ assert.equal(drawn(world, 'paving-c'), false);
554
+ lv.restore(world);
555
+ assert.deepEqual(out(world), []);
556
+ assert.equal(lv.cellHidden, 0);
557
+ assert.equal(lv.cell, null);
558
+ // And Low again finds the cell again.
559
+ lv.apply(world, scene, 1000);
560
+ assert.equal(lv.cell, 'a');
561
+ assert.equal(drawn(world, 'paving-c'), false);
562
+ });
563
+
564
+ test('a reloaded scene whose table goes away puts cell-hidden nodes back', () => {
565
+ const holder = { cells: CELLS() };
566
+ const { world, scene } = fakeWorld(ACTORS);
567
+ const read = scene.readFromFile;
568
+ scene.readFromFile = () => ({ ...read(), cells: holder.cells });
569
+ const lv = makeLevers({ boundsOf: bounds });
570
+ lv.apply(world, scene, 0);
571
+ assert.equal(drawn(world, 'wall-c'), false);
572
+ holder.cells = { ...CELLS(), eyeMax: 'high' };
573
+ scene.data = {};
574
+ lv.apply(world, scene, 16);
575
+ assert.equal(lv.cells, null);
576
+ assert.equal(drawn(world, 'wall-c'), true);
577
+ assert.deepEqual(out(world), ['lamp', 'npc-far', 'wall-far']);
578
+ });
579
+
580
+ // Review regressions.
581
+
582
+ test('an eye that leaves the table, or is at no finite place, puts back what its last cell hid at once (review P1)', () => {
583
+ const { world, scene, eyeAt } = fakeWorld(ACTORS);
584
+ const lv = makeLevers({ boundsOf: bounds });
585
+ lv.apply(world, scene, 0);
586
+ assert.equal(lv.cell, 'a');
587
+ assert.equal(drawn(world, 'paving-c'), false);
588
+ eyeAt(-30, 2, 0);
589
+ lv.apply(world, scene, 16);
590
+ assert.equal(lv.cell, null);
591
+ assert.equal(lv.cellKey, null);
592
+ assert.equal(lv.cellHidden, 0);
593
+ // paving-c is kept: only the cells ever hide it.
594
+ assert.equal(drawn(world, 'paving-c'), true, 'back on the next frame, not at the next look');
595
+ assert.equal(drawn(world, 'paving-c'), true);
596
+ // Back in a, then a camera with no finite place.
597
+ eyeAt(-5, 2, 0);
598
+ lv.apply(world, scene, 32);
599
+ assert.equal(drawn(world, 'paving-c'), false);
600
+ for (const [i, bad] of [[NaN, 2, 0], [-5, 2, Infinity], [-5, NaN, 0]].entries()) {
601
+ eyeAt(...bad);
602
+ lv.apply(world, scene, 48 + i * 32);
603
+ assert.equal(lv.cellKey, null, `eye ${bad}`);
604
+ assert.equal(drawn(world, 'paving-c'), true, `eye ${bad}`);
605
+ eyeAt(-5, 2, 0);
606
+ lv.apply(world, scene, 64 + i * 32);
607
+ assert.equal(drawn(world, 'paving-c'), false, `back in a after ${bad}`);
608
+ }
609
+ });
610
+
611
+ test('cells take out only inert actors: every component in CELL_INERT, none protected (review round 3 invariant)', () => {
612
+ const CELL_C = { at: [15, 0, 0], cell: 'c' };
613
+ const actors = [
614
+ { id: 'seat', components: { Transform: {}, Shape: {}, Model: {}, HubSeat: {} }, ...CELL_C },
615
+ { id: 'sign', components: { Transform: {}, Model: {}, TownSign: {} }, ...CELL_C },
616
+ { id: 'court', components: { Transform: {}, Shape: {}, Solid: {}, TownCourtPiece: {} }, ...CELL_C },
617
+ { id: 'statue', components: { Transform: {}, Model: {}, TownStatue: {} }, ...CELL_C },
618
+ { id: 'sign-keep', components: { Transform: {}, Model: {}, TownSign: {} }, ...CELL_C, tier: 'keep' },
619
+ { id: 'seat-near', components: { Transform: {}, Shape: {}, HubSeat: {} }, ...CELL_C, tier: 'near' },
620
+ { id: 'odd', components: { Transform: {}, Model: {}, SomethingNew: {} }, ...CELL_C },
621
+ { id: 'bare', components: {}, ...CELL_C, tier: 'keep' },
622
+ ...[...CELL_PROTECTED].map((name, i) => ({
623
+ id: `protected-${name}`,
624
+ components: { Transform: {}, Shape: {}, [name]: {} },
625
+ at: [0, 0, i],
626
+ cell: 'c',
627
+ })),
628
+ { id: 'ground-keep', components: { Transform: {}, Shape: {}, Model: {} }, ...CELL_C, tier: 'keep' },
629
+ { id: 'bench-near', components: { Transform: {}, Shape: {}, Model: {}, Solid: {}, Lookable: {} }, ...CELL_C, tier: 'near' },
630
+ { id: 'wall-plain', components: { Transform: {}, Shape: {}, Solid: {} }, at: [5, 0, 5], cell: 'c' },
631
+ { id: 'anchor', components: { Transform: {}, Shape: {}, RouteAnchor: {} }, ...CELL_C, tier: 'keep' },
632
+ { id: 'walk', components: { Transform: {}, Shape: {}, WalkSurface: {}, Solid: {} }, ...CELL_C, tier: 'keep' },
633
+ // An NPC tagged c past 20 m: the NPC distance rule still takes it out.
634
+ { id: 'npc-tagged-far', components: { Transform: {}, Body: {}, HubNpc: {}, Model: {} }, at: [0, 0, 25], cell: 'c' },
635
+ ];
636
+ const { world, scene, eyeAt } = fakeWorld(actors);
637
+ const lv = makeLevers({ boundsOf: bounds });
638
+ lv.apply(world, scene, 0);
639
+ assert.deepEqual([...CELL_INERT].sort(), ['Lookable', 'Model', 'RouteAnchor', 'Shape', 'Solid', 'Transform', 'WalkSurface']);
640
+ for (const name of ['TownWardrobeMat', 'TownWardrobeItem', 'TownWardrobe', 'HubDoor', 'Body', 'TownHatMat']) {
641
+ assert.ok(CELL_PROTECTED.has(name), name);
642
+ }
643
+ for (const id of actors.filter((a) => a.id.startsWith('protected-')).map((a) => a.id)) {
644
+ assert.equal(drawn(world, id), true, `${id}: protected, never out for its cell`);
645
+ }
646
+ for (const id of ['seat', 'sign', 'court', 'statue', 'sign-keep', 'seat-near', 'odd', 'bare']) {
647
+ assert.equal(drawn(world, id), true, `${id}: not inert, never out for its cell`);
648
+ }
649
+ const inert = ['ground-keep', 'bench-near', 'wall-plain', 'anchor', 'walk'];
650
+ for (const id of inert) {
651
+ assert.equal(drawn(world, id), false, `${id}: inert, out for its cell, tier mark or not`);
652
+ }
653
+ assert.equal(drawn(world, 'npc-tagged-far'), false, 'protected from cells, not from the NPC distance rule');
654
+ assert.equal(lv.cellHidden, inert.length);
655
+ assert.equal(cellInert(undefined), false);
656
+ assert.equal(cellInert(null), false);
657
+ assert.equal(cellInert({}), false);
658
+ assert.equal(cellInert({ Transform: {}, Shape: {} }), true);
659
+ // From b (sees c): everything back but what the old rules take.
660
+ eyeAt(5, 2, 0);
661
+ lv.apply(world, scene, 16);
662
+ assert.equal(lv.cellHidden, 0);
663
+ assert.equal(drawn(world, 'ground-keep'), true);
664
+ });
665
+
666
+ test('an actor replaced or given a component under the same id is decided again on the next look, never remembered (review round 3)', () => {
667
+ const actors = [
668
+ { id: 'stone', components: { Transform: {}, Shape: {}, Model: {} }, at: [15, 0, 0], cell: 'c', tier: 'keep' },
669
+ { id: 'gate', components: { Transform: {}, Shape: {}, Solid: {} }, at: [15, 0, 2], cell: 'c', tier: 'keep' },
670
+ { id: 'post', components: { Transform: {}, Shape: {}, Solid: {} }, at: [15, 0, 4], cell: 'c', tier: 'keep' },
671
+ ];
672
+ const { world, scene } = fakeWorld(actors);
673
+ const lv = makeLevers({ boundsOf: bounds });
674
+ let now = 0;
675
+ lv.apply(world, scene, now);
676
+ assert.deepEqual(out(world), ['gate', 'post', 'stone']);
677
+ const nodes = ['stone', 'gate', 'post'].map((id) => world.nodes.get(id).node);
678
+ // The same ids and nodes, the scene data unchanged: the actors become a
679
+ // body, a door, and one gains a seat while playing.
680
+ actors[0].components = { Transform: {}, Shape: {}, Model: {}, Body: {} };
681
+ actors[1].components = { Transform: {}, Shape: {}, Solid: {}, HubDoor: {} };
682
+ actors[2].components.HubSeat = {};
683
+ lv.apply(world, scene, (now += CHECK_EVERY_MS + 1));
684
+ assert.deepEqual(out(world), [], 'all three back on the next look');
685
+ assert.deepEqual(['stone', 'gate', 'post'].map((id) => world.nodes.get(id).node), nodes, 'same nodes');
686
+ assert.equal(lv.cellHidden, 0);
687
+ // And inert again: out again.
688
+ delete actors[2].components.HubSeat;
689
+ lv.apply(world, scene, (now += CHECK_EVERY_MS + 1));
690
+ assert.deepEqual(out(world), ['post']);
691
+ });
692
+
693
+ test('an eye just off the table, inside its last cell\'s hysteresis, has no cell: what it hid comes back (review round 2)', () => {
694
+ const { world, scene, eyeAt } = fakeWorld(ACTORS, { eye: [15, 2, 0] });
695
+ const lv = makeLevers({ boundsOf: bounds });
696
+ lv.apply(world, scene, 0);
697
+ assert.equal(lv.cell, 'c');
698
+ assert.equal(drawn(world, 'wall-a'), false);
699
+ eyeAt(21.5, 2, 0);
700
+ lv.apply(world, scene, 16);
701
+ assert.equal(lv.cell, null);
702
+ assert.equal(lv.cellHidden, 0);
703
+ assert.equal(drawn(world, 'wall-a'), true);
704
+ });
705
+
706
+ console.log(`test-tier-cells: ${n} passed`);