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,545 @@
1
+ // Desktop shift lock, through Scene3DPlayer's actual attachInput and a
2
+ // stand-in DOM. No browser, renderer or physics world is needed here.
3
+ import assert from 'node:assert/strict';
4
+ import { readFileSync } from 'node:fs';
5
+ import { attachOrbitInput, LOOK_RAD_PER_PX, WHEEL_ZOOM_PER_NOTCH } from '../engine3d/orbitinput.js';
6
+
7
+ const cutInput = (file) => {
8
+ const source = readFileSync(new URL(file, import.meta.url), 'utf8');
9
+ return source.slice(source.indexOf('function attachInput('), source.indexOf('\nfunction attachResize('));
10
+ };
11
+ const inputSource = cutInput('../engine3d/Scene3DPlayer.jsx');
12
+ const beforeSource = cutInput('./Scene3DPlayer.before-orbit.jsx');
13
+ const tick = () => new Promise((resolve) => setTimeout(resolve, 0));
14
+ const near = (got, expected) => assert.ok(Math.abs(got - expected) < 1e-12, `${got} ~= ${expected}`);
15
+
16
+ function eventTarget(log, name) {
17
+ const listeners = [];
18
+ return {
19
+ listeners,
20
+ addEventListener(type, fn, options) {
21
+ log.push(`${name}:${type}`);
22
+ listeners.push({ type, fn, options });
23
+ },
24
+ removeEventListener(type, fn) {
25
+ const i = listeners.findIndex((entry) => entry.type === type && entry.fn === fn);
26
+ if (i >= 0) listeners.splice(i, 1);
27
+ },
28
+ fire(type, more = {}) {
29
+ const event = {
30
+ type, target: this, prevented: false, stopped: false,
31
+ preventDefault() { this.prevented = true; },
32
+ stopPropagation() { this.stopped = true; },
33
+ ...more,
34
+ };
35
+ for (const entry of [...listeners]) if (entry.type === type) entry.fn(event);
36
+ return event;
37
+ },
38
+ };
39
+ }
40
+
41
+ function harness({ keyed = true, fine = true, mode = 'promise', chromium = false, source = inputSource } = {}) {
42
+ const log = [];
43
+ const win = eventTarget(log, 'window');
44
+ win.parent = win;
45
+ const media = { matches: fine };
46
+ let queries = 0;
47
+ win.matchMedia = (query) => {
48
+ queries += 1;
49
+ assert.equal(query, '(hover: hover) and (pointer: fine)');
50
+ return media;
51
+ };
52
+ const doc = eventTarget(log, 'document');
53
+ Object.assign(doc, { defaultView: win, pointerLockElement: null, visibilityState: 'visible', hasFocus: () => true });
54
+ const parent = { children: [], appendChild(button) { this.children.push(button); } };
55
+ doc.createElement = (tag) => {
56
+ assert.equal(tag, 'button');
57
+ const button = eventTarget(log, 'button');
58
+ button.style = {};
59
+ button.attributes = {};
60
+ button.setAttribute = (key, value) => (button.attributes[key] = value);
61
+ button.remove = () => parent.children.splice(parent.children.indexOf(button), 1);
62
+ return button;
63
+ };
64
+ const canvas = eventTarget(log, 'canvas');
65
+ const active = new Set();
66
+ const captures = new Set();
67
+ const recaptured = [];
68
+ Object.assign(canvas, {
69
+ ownerDocument: doc, parentElement: parent, focused: 0,
70
+ focus() { this.focused += 1; },
71
+ getBoundingClientRect: () => ({ left: 0, top: 0, width: 800, height: 600 }),
72
+ setPointerCapture(id) {
73
+ if (doc.pointerLockElement === canvas || !active.has(id)) throw new Error('cannot capture');
74
+ captures.add(id);
75
+ recaptured.push(id);
76
+ },
77
+ hasPointerCapture: (id) => captures.has(id),
78
+ });
79
+ const later = [];
80
+ const waiting = [];
81
+ let requests = 0;
82
+ let exits = 0;
83
+ if (mode !== 'missing') canvas.requestPointerLock = () => {
84
+ requests += 1;
85
+ if (mode === 'throw') throw new Error('pointer lock unavailable');
86
+ if (mode === 'none') {
87
+ waiting.push({ resolve() {}, reject() {} });
88
+ return undefined;
89
+ }
90
+ return new Promise((resolve, reject) => waiting.push({ resolve, reject }));
91
+ };
92
+ doc.exitPointerLock = () => {
93
+ exits += 1;
94
+ if (chromium) doc.pointerLockElement = null;
95
+ later.push(() => {
96
+ doc.pointerLockElement = null;
97
+ doc.fire('pointerlockchange');
98
+ });
99
+ };
100
+ const runtime = { cameraControl: keyed ? 'orbit' : null, keys: new Set() };
101
+ const world = { debugLines: { visible: false } };
102
+ const attach = new Function('attachOrbitInput', 'window', 'document', 'performance', `${source}\nreturn attachInput;`)(attachOrbitInput, win, doc, performance);
103
+ const detach = attach(canvas, runtime, world);
104
+ const pointer = (type, id = 1, more = {}) => {
105
+ if (type === 'pointerdown') active.add(id);
106
+ const event = canvas.fire(type, {
107
+ pointerId: id, clientX: 600, clientY: 300, pointerType: 'mouse',
108
+ button: type === 'pointermove' ? -1 : 0, buttons: type === 'pointerup' ? 0 : 1,
109
+ ...more,
110
+ });
111
+ if (type === 'pointerup' || type === 'pointercancel') active.delete(id);
112
+ return event;
113
+ };
114
+ return {
115
+ win, doc, canvas, runtime, world, media, log, parent, active, captures, recaptured, waiting, detach, pointer,
116
+ get queries() { return queries; },
117
+ get requests() { return requests; },
118
+ get exits() { return exits; },
119
+ get button() { return parent.children[0]; },
120
+ get on() { return runtime.orbitInput().shiftLock.active; },
121
+ listen() { runtime.orbitInput(); runtime.lookInput.listen(); },
122
+ take: () => ({ ...runtime.lookInput.consume() }),
123
+ shift(more = {}) { return win.fire('keydown', { key: 'Shift', code: 'ShiftLeft', repeat: false, target: canvas, ...more }); },
124
+ flush() { for (const fn of later.splice(0)) fn(); },
125
+ async grant(change = true) {
126
+ const settle = waiting.shift();
127
+ doc.pointerLockElement = canvas;
128
+ captures.clear();
129
+ if (change) doc.fire('pointerlockchange');
130
+ settle.resolve();
131
+ await tick();
132
+ },
133
+ async deny() {
134
+ const settle = waiting.shift();
135
+ doc.fire('pointerlockerror');
136
+ settle.reject(new Error('refused'));
137
+ await tick();
138
+ },
139
+ escape() { doc.pointerLockElement = null; doc.fire('pointerlockchange'); },
140
+ };
141
+ }
142
+
143
+ export async function runShiftLockChecks() {
144
+ let checks = 0;
145
+ // A cold keyless runtime is identical to the handlers before orbit input:
146
+ // listeners, focus, keys, pointer captures and taps; no media query or DOM.
147
+ {
148
+ const now = harness({ keyed: false });
149
+ const before = harness({ keyed: false, source: beforeSource });
150
+ for (const h of [now, before]) {
151
+ assert.equal(h.shift().prevented, false);
152
+ h.win.fire('keydown', { key: 'Shift', code: 'ShiftRight', repeat: true });
153
+ h.pointer('pointerdown');
154
+ h.pointer('pointermove', 1, { clientX: 601 });
155
+ h.pointer('pointerup');
156
+ h.win.fire('keyup', { key: 'Shift', code: 'ShiftLeft' });
157
+ }
158
+ assert.deepEqual(now.log, before.log);
159
+ assert.deepEqual([...now.runtime.keys], [...before.runtime.keys]);
160
+ assert.ok(now.runtime.keys.has('ShiftRight'));
161
+ assert.equal(now.canvas.focused, before.canvas.focused);
162
+ assert.deepEqual(now.recaptured, before.recaptured);
163
+ assert.equal(now.runtime.moveInput.consumeJump(), before.runtime.moveInput.consumeJump());
164
+ assert.equal(now.runtime.lookInput, undefined);
165
+ assert.equal(now.button, undefined);
166
+ assert.equal(now.queries, 0);
167
+ assert.equal(now.requests, 0);
168
+ assert.equal(now.exits, 0);
169
+ now.detach();
170
+ before.detach();
171
+ checks += 1;
172
+ }
173
+ // A Shift gesture before the first Player frame also makes the control
174
+ // lazily; attaching the keyless input handlers alone makes nothing.
175
+ {
176
+ const h = harness();
177
+ assert.equal(h.button, undefined);
178
+ h.shift();
179
+ assert.equal(h.button.attributes['aria-pressed'], 'false');
180
+ await h.grant();
181
+ assert.equal(h.button.attributes['aria-pressed'], 'true');
182
+ h.button.fire('click');
183
+ assert.equal(h.on, false);
184
+ h.flush();
185
+ h.detach();
186
+ checks += 1;
187
+ }
188
+ // Shift still reaches runtime.keys, but only an initial, non-editable
189
+ // Shift keydown can toggle. The button is lazy and off by default.
190
+ {
191
+ const h = harness();
192
+ assert.equal(h.button, undefined);
193
+ h.listen();
194
+ const button = h.button;
195
+ assert.equal(button.style.display, 'flex');
196
+ assert.equal(button.style.width, '44px');
197
+ assert.equal(button.attributes['aria-label'], 'Shift lock (Shift)');
198
+ assert.equal(button.title, 'Shift lock (Shift)');
199
+ assert.equal(button.attributes['aria-pressed'], 'false');
200
+ for (const more of [
201
+ { repeat: true }, { target: { isContentEditable: true } },
202
+ ...['input', 'textarea', 'select'].map((tag) => ({ target: { closest: (selector) => selector.includes(tag) } })),
203
+ { key: 'shift' },
204
+ ]) h.shift(more);
205
+ assert.equal(h.requests, 0);
206
+ assert.equal(h.shift().prevented, false);
207
+ assert.ok(h.runtime.keys.has('Shift') && h.runtime.keys.has('ShiftLeft'));
208
+ assert.equal(h.requests, 1);
209
+ assert.equal(h.on, false, 'a request alone is not on');
210
+ await h.grant();
211
+ assert.equal(h.on, true);
212
+ assert.equal(button.attributes['aria-pressed'], 'true');
213
+ h.shift({ repeat: true });
214
+ assert.equal(h.on, true);
215
+ h.shift({ code: 'ShiftRight' });
216
+ assert.ok(h.runtime.keys.has('ShiftRight'));
217
+ assert.equal(h.on, false);
218
+ assert.equal(button.attributes['aria-pressed'], 'false');
219
+ assert.equal(h.exits, 1);
220
+ h.flush();
221
+ assert.equal(h.doc.pointerLockElement, null);
222
+ h.detach();
223
+ assert.equal(h.parent.children.length, 0);
224
+ assert.equal(button.listeners.length, 0);
225
+ checks += 1;
226
+ }
227
+ // Both the pointerdown and click are contained; keyboard movement keeps
228
+ // working with focus returned to the canvas, including after toggling off.
229
+ {
230
+ const h = harness();
231
+ h.listen();
232
+ assert.equal(h.button.fire('pointerdown').stopped, true);
233
+ assert.equal(h.button.fire('pointerdown').prevented, true);
234
+ const focused = h.canvas.focused;
235
+ assert.equal(h.button.fire('click').stopped, true);
236
+ assert.equal(h.canvas.focused, focused + 1);
237
+ await h.grant();
238
+ assert.equal(h.on, true);
239
+ h.win.fire('keydown', { key: 'w', code: 'KeyW' });
240
+ assert.ok(h.runtime.keys.has('KeyW'));
241
+ h.button.fire('click');
242
+ assert.equal(h.canvas.focused, focused + 2);
243
+ assert.equal(h.on, false);
244
+ h.flush();
245
+ h.detach();
246
+ checks += 1;
247
+ }
248
+ // Continuous relative motion with no press, and while a button is held,
249
+ // turns exactly once. A fast left release jumps regardless of mouse motion.
250
+ {
251
+ const h = harness();
252
+ h.listen();
253
+ h.shift();
254
+ await h.grant();
255
+ h.pointer('pointermove', 1, { buttons: 0, movementX: 20, movementY: -7 });
256
+ let got = h.take();
257
+ near(got.yaw, 20 * LOOK_RAD_PER_PX);
258
+ near(got.pitch, -7 * LOOK_RAD_PER_PX);
259
+ h.pointer('pointerdown');
260
+ h.pointer('pointermove', 1, { clientX: 790, clientY: 100, movementX: 50, movementY: 15 });
261
+ got = h.take();
262
+ near(got.yaw, 50 * LOOK_RAD_PER_PX);
263
+ near(got.pitch, 15 * LOOK_RAD_PER_PX);
264
+ h.pointer('pointerup');
265
+ assert.equal(h.runtime.moveInput.consumeJump(), true);
266
+ assert.equal(h.runtime.moveInput.active, false);
267
+ assert.equal(h.on, true);
268
+ for (const button of [1, 2]) {
269
+ h.pointer('pointerdown', 1, { button });
270
+ h.pointer('pointermove', 1, { button: 2, buttons: 3, movementX: -4 });
271
+ near(h.take().yaw, -4 * LOOK_RAD_PER_PX);
272
+ h.pointer('pointerup', 1, { button });
273
+ assert.equal(h.runtime.moveInput.consumeJump(), false);
274
+ }
275
+ assert.equal(h.requests, 1, 'presses and chords never request again');
276
+ assert.equal(h.exits, 0, 'releases never exit shift lock');
277
+ assert.equal(h.canvas.fire('wheel', { deltaY: 100, deltaMode: 0 }).prevented, true);
278
+ near(h.take().zoom, WHEEL_ZOOM_PER_NOTCH);
279
+ h.pointer('pointermove', 1, { buttons: 0, movementX: NaN, movementY: undefined });
280
+ assert.deepEqual(h.take(), { yaw: 0, pitch: 0, zoom: 1, locked: false });
281
+ h.detach();
282
+ h.flush();
283
+ checks += 1;
284
+ }
285
+ // Refused, throwing, missing and event-only requests never pretend to be
286
+ // on. A late grant after an event-only error is released immediately.
287
+ for (const mode of ['promise', 'throw', 'missing', 'none']) {
288
+ const h = harness({ mode });
289
+ h.listen();
290
+ h.shift();
291
+ if (mode === 'promise' || mode === 'none') await h.deny();
292
+ assert.equal(h.on, false, mode);
293
+ assert.equal(h.button?.attributes['aria-pressed'] ?? 'false', 'false');
294
+ if (mode === 'none') {
295
+ h.doc.pointerLockElement = h.canvas;
296
+ h.doc.fire('pointerlockchange');
297
+ assert.equal(h.exits, 1);
298
+ h.flush();
299
+ }
300
+ if (mode === 'missing') assert.equal(h.button, undefined);
301
+ h.detach();
302
+ assert.equal(h.doc.listeners.length, 0);
303
+ checks += 1;
304
+ }
305
+ // A long press is not a tap. A missing lift is cancelled on the next
306
+ // buttonless move, with shift lock and its continuous turning kept on.
307
+ {
308
+ const h = harness();
309
+ h.listen();
310
+ h.shift();
311
+ await h.grant();
312
+ h.pointer('pointerdown');
313
+ await new Promise((resolve) => setTimeout(resolve, 310));
314
+ h.pointer('pointerup');
315
+ assert.equal(h.runtime.moveInput.consumeJump(), false);
316
+ h.pointer('pointerdown');
317
+ h.pointer('pointermove', 1, { buttons: 0, movementX: 10 });
318
+ assert.equal(h.runtime.orbitInput().busy, false);
319
+ near(h.take().yaw, 10 * LOOK_RAD_PER_PX);
320
+ assert.equal(h.on, true);
321
+ h.pointer('pointerup');
322
+ assert.equal(h.runtime.moveInput.consumeJump(), false);
323
+ h.detach();
324
+ h.flush();
325
+ checks += 1;
326
+ }
327
+ // An unlock still on its way must not queue an automatic re-lock outside
328
+ // a user gesture. A later fresh gesture asks, and can be refused by Chrome.
329
+ {
330
+ const h = harness({ chromium: true });
331
+ h.listen();
332
+ h.shift();
333
+ await h.grant();
334
+ h.shift();
335
+ h.shift();
336
+ h.flush();
337
+ assert.equal(h.requests, 1);
338
+ assert.equal(h.on, false);
339
+ h.shift();
340
+ assert.equal(h.requests, 2);
341
+ await h.deny();
342
+ assert.equal(h.on, false);
343
+ assert.equal(h.button.attributes['aria-pressed'], 'false');
344
+ h.detach();
345
+ checks += 1;
346
+ }
347
+ // Without a promise, a retry inside a refusal's watch window is off once
348
+ // the window closes, and the next Shift asks again.
349
+ {
350
+ const h = harness({ mode: 'none' });
351
+ h.listen();
352
+ h.shift();
353
+ await h.deny();
354
+ h.shift();
355
+ await new Promise((resolve) => setTimeout(resolve, 1100));
356
+ assert.equal(h.on, false);
357
+ assert.equal(h.requests, 1);
358
+ h.shift();
359
+ assert.equal(h.requests, 2, 'the next Shift asks again');
360
+ await h.grant();
361
+ assert.equal(h.on, true);
362
+ h.detach();
363
+ h.flush();
364
+ checks += 1;
365
+ }
366
+ // A promise settled without a lock also leaves the mode off.
367
+ {
368
+ const h = harness();
369
+ h.listen();
370
+ h.shift();
371
+ h.waiting.shift().resolve();
372
+ await tick();
373
+ assert.equal(h.on, false);
374
+ assert.equal(h.button.attributes['aria-pressed'], 'false');
375
+ h.detach();
376
+ checks += 1;
377
+ }
378
+ // Successful event-only requests, and promises whose event has not arrived,
379
+ // can both land. There is no promise-only assumption in the mode.
380
+ for (const mode of ['none', 'promise']) {
381
+ const h = harness({ mode });
382
+ h.listen();
383
+ h.shift();
384
+ await h.grant(mode === 'none');
385
+ assert.equal(h.on, true);
386
+ h.escape();
387
+ assert.equal(h.on, false);
388
+ h.detach();
389
+ checks += 1;
390
+ }
391
+ // Escape, blur, hidden, every scene load and detach cancel all gestures.
392
+ // Chromium's early pointerLockElement clearing does not restore captures
393
+ // until the later event; touches held during the lock get theirs too.
394
+ for (const ending of ['escape', 'blur', 'hidden', 'orbit-load', 'keyless-load', 'detach', 'shift']) {
395
+ const h = harness({ chromium: true });
396
+ h.listen();
397
+ h.shift();
398
+ await h.grant();
399
+ h.pointer('pointerdown');
400
+ h.pointer('pointerdown', 2, { pointerType: 'touch', clientX: 100 });
401
+ h.pointer('pointermove', 2, { pointerType: 'touch', clientX: 150 });
402
+ assert.equal(h.runtime.moveInput.active, true, 'touch keeps its stick path during shift lock');
403
+ h.take();
404
+ if (ending === 'escape') h.escape();
405
+ else if (ending === 'blur') h.win.fire('blur');
406
+ else if (ending === 'hidden') { h.doc.visibilityState = 'hidden'; h.doc.fire('visibilitychange'); }
407
+ else if (ending.endsWith('load')) {
408
+ h.runtime.lookInput.reset();
409
+ h.runtime.cameraControl = ending === 'orbit-load' ? 'orbit' : null;
410
+ assert.equal(h.button.style.display, 'none');
411
+ } else if (ending === 'detach') h.detach();
412
+ else h.shift();
413
+ assert.equal(h.on, false, ending);
414
+ assert.equal(h.runtime.moveInput.active, false, ending);
415
+ assert.equal(h.runtime.orbitInput().busy, false, ending);
416
+ if (ending !== 'escape') {
417
+ assert.equal(h.captures.size, 0, 'captures wait for pointerlockchange');
418
+ h.flush();
419
+ }
420
+ assert.ok(h.captures.has(1) && h.captures.has(2), `${ending}: held captures returned`);
421
+ assert.deepEqual(h.take(), { yaw: 0, pitch: 0, zoom: 1, locked: false });
422
+ h.pointer('pointerup');
423
+ assert.equal(h.runtime.moveInput.consumeJump(), false, 'a cancelled press never jumps');
424
+ if (ending === 'keyless-load') {
425
+ const requests = h.requests;
426
+ h.shift();
427
+ assert.equal(h.requests, requests);
428
+ assert.equal(h.button.style.display, 'none');
429
+ } else if (ending === 'orbit-load') {
430
+ h.listen();
431
+ assert.equal(h.button.style.display, 'flex');
432
+ assert.equal(h.button.attributes['aria-pressed'], 'false');
433
+ }
434
+ h.detach();
435
+ assert.equal(h.doc.listeners.length, 0);
436
+ assert.equal(h.win.listeners.length, 0);
437
+ checks += 1;
438
+ }
439
+ // Lifts outside the canvas go through its own handler, and an unobserved
440
+ // lift that cannot be recaptured is cancelled through the same onLost path.
441
+ {
442
+ const h = harness();
443
+ h.listen();
444
+ h.shift();
445
+ await h.grant();
446
+ h.pointer('pointerdown');
447
+ h.active.delete(1);
448
+ h.doc.fire('pointerup', { pointerId: 1 });
449
+ assert.equal(h.runtime.moveInput.consumeJump(), true);
450
+ h.pointer('pointerdown', 2, { pointerType: 'touch', clientX: 100 });
451
+ h.pointer('pointermove', 2, { pointerType: 'touch', clientX: 160 });
452
+ h.active.delete(2);
453
+ h.escape();
454
+ assert.equal(h.captures.has(2), false);
455
+ assert.equal(h.runtime.moveInput.active, false);
456
+ assert.equal(h.runtime.orbitInput().busy, false);
457
+ h.detach();
458
+ checks += 1;
459
+ }
460
+ // Cancel while the request is pending: nothing late may keep it on.
461
+ for (const ending of ['shift', 'reset', 'blur', 'hidden', 'detach']) {
462
+ const h = harness();
463
+ h.listen();
464
+ h.shift();
465
+ if (ending === 'shift') h.shift();
466
+ else if (ending === 'reset') h.runtime.lookInput.reset();
467
+ else if (ending === 'blur') h.win.fire('blur');
468
+ else if (ending === 'hidden') { h.doc.visibilityState = 'hidden'; h.doc.fire('visibilitychange'); }
469
+ else h.detach();
470
+ await h.grant();
471
+ assert.equal(h.on, false);
472
+ assert.equal(h.exits, 1, `${ending}: the late lock is let go of`);
473
+ h.flush();
474
+ h.detach();
475
+ assert.equal(h.doc.listeners.length, 0);
476
+ checks += 1;
477
+ }
478
+ // A held drag's lock can become shift lock without a second request. A
479
+ // release after that transfer does not let go of the permanent lock.
480
+ {
481
+ const h = harness();
482
+ h.listen();
483
+ h.pointer('pointerdown', 1, { button: 2, buttons: 2 });
484
+ await h.grant();
485
+ h.shift();
486
+ assert.equal(h.on, true);
487
+ assert.equal(h.requests, 1);
488
+ h.pointer('pointerup', 1, { button: 2 });
489
+ assert.equal(h.exits, 0);
490
+ h.detach();
491
+ h.flush();
492
+ checks += 1;
493
+ }
494
+ // Touch-only devices have no control, no Shift requests or lock listeners;
495
+ // touch and pen still take the stick and look paths they already had.
496
+ {
497
+ const h = harness({ fine: false });
498
+ h.listen();
499
+ h.shift();
500
+ assert.equal(h.button, undefined);
501
+ assert.equal(h.requests, 0);
502
+ assert.equal(h.doc.listeners.length, 0);
503
+ assert.deepEqual(h.win.listeners.map((entry) => entry.type), ['keydown', 'keyup']);
504
+ for (const pointerType of ['touch', 'pen']) {
505
+ h.pointer('pointerdown', 1, { pointerType, clientX: 100 });
506
+ h.pointer('pointermove', 1, { pointerType, clientX: 160 });
507
+ assert.equal(h.runtime.moveInput.active, true);
508
+ h.pointer('pointerup', 1, { pointerType });
509
+ h.pointer('pointerdown', 2, { pointerType });
510
+ h.pointer('pointermove', 2, { pointerType, clientX: 650 });
511
+ near(h.take().yaw, 50 * LOOK_RAD_PER_PX);
512
+ h.pointer('pointerup', 2, { pointerType });
513
+ }
514
+ assert.equal(h.requests, 0);
515
+ h.detach();
516
+ checks += 1;
517
+ }
518
+ // The media query is rechecked on keyed frames without new listeners.
519
+ // Losing a fine pointer hides the control, but Shift can still turn it off.
520
+ {
521
+ const h = harness();
522
+ h.listen();
523
+ const button = h.button;
524
+ h.shift();
525
+ await h.grant();
526
+ h.media.matches = false;
527
+ h.listen();
528
+ assert.equal(button.style.display, 'none');
529
+ h.shift();
530
+ assert.equal(h.on, false);
531
+ h.flush();
532
+ h.media.matches = true;
533
+ h.listen();
534
+ assert.equal(h.button, button);
535
+ assert.equal(button.style.display, 'flex');
536
+ assert.equal(h.queries, 1);
537
+ h.detach();
538
+ checks += 1;
539
+ }
540
+ return checks;
541
+ }
542
+
543
+ if (import.meta.url === `file://${process.argv[1]}`) {
544
+ console.log(`orbit shift lock: ${await runShiftLockChecks()} checks`);
545
+ }