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,452 @@
1
+ // The player's frame cap (`engine3d/framecap.js`, `"engine": { "maxFps": n }`)
2
+ // driven with made-up requestAnimationFrame timestamps, as Scene3DPlayer's
3
+ // tick drives it: displays at 60 Hz (timestamps up to 1.5 ms early or late),
4
+ // 75, 90, 120, 144, 165, 180 and 240 Hz, and a 120 Hz display that misses
5
+ // frames. Without a cap every timestamp runs and is handed exactly what the
6
+ // loop computed before the cap existed. With one, no frame runs sooner than
7
+ // the threshold after the last, a display at the cap never skips, a faster one
8
+ // runs a whole number of refreshes per frame with one dt throughout, a
9
+ // missed refresh is not made up with a burst, and dt is the time since the
10
+ // last frame that ran -- never more than physics can step, so physics keeps
11
+ // the behaviours' time -- and a key pressed and let go, or a drag begun and
12
+ // ended (the orbit input's stick under the orbit camera key too), while frames
13
+ // were skipped is seen by the next frame that runs.
14
+ // Run by test-static-actors.mjs.
15
+ import assert from 'node:assert/strict';
16
+ import fs from 'node:fs';
17
+ import {
18
+ makeFrameClock,
19
+ makeInputLatch,
20
+ nextFrame,
21
+ updateLending,
22
+ MAX_CAPPED_DT,
23
+ RUN_SHARE,
24
+ } from '../engine3d/framecap.js';
25
+ import { attachOrbitInput, stickFrom } from '../engine3d/orbitinput.js';
26
+
27
+ let seed = 20261004;
28
+ function random() {
29
+ seed = (seed + 0x6d2b79f5) | 0;
30
+ let t = Math.imul(seed ^ (seed >>> 15), 1 | seed);
31
+ t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
32
+ return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
33
+ }
34
+
35
+ // Timestamps of a display at `hz`, each moved by up to `jitter` ms either way,
36
+ // and with each refresh missed with chance `miss`.
37
+ function display(hz, { frames = 2000, jitter = 0, miss = 0, start = 1000 } = {}) {
38
+ const out = [];
39
+ for (let i = 1; i <= frames; i++) {
40
+ if (miss && random() < miss) continue;
41
+ out.push(start + (i * 1000) / hz + (random() * 2 - 1) * jitter);
42
+ }
43
+ return out;
44
+ }
45
+
46
+ // The tick's clock over `stamps` with the cap `maxFps` (a number, or a
47
+ // function of the frame's index). Returns every frame's dt or null.
48
+ function drive(stamps, maxFps, start = 1000) {
49
+ const clock = makeFrameClock(start);
50
+ return stamps.map((now, i) => nextFrame(clock, now, typeof maxFps === 'function' ? maxFps(i) : maxFps));
51
+ }
52
+
53
+ // The frames that ran: their timestamp, the gap since the one before, dt.
54
+ function runs(stamps, dts, start = 1000) {
55
+ const out = [];
56
+ let last = start;
57
+ stamps.forEach((now, i) => {
58
+ if (dts[i] === null) return;
59
+ out.push({ i, now, gap: now - last, dt: dts[i] });
60
+ last = now;
61
+ });
62
+ return out;
63
+ }
64
+
65
+ // What every frame with a cap must satisfy: none runs within the threshold of
66
+ // the last (the first a clock sees excepted), every one that comes later
67
+ // runs, and dt is the time since the last that ran.
68
+ function holds(stamps, dts, maxFps, what) {
69
+ const threshold = (RUN_SHARE * 1000) / maxFps;
70
+ let last = 1000;
71
+ stamps.forEach((now, i) => {
72
+ const gap = now - last;
73
+ if (i > 0) assert.equal(dts[i] !== null, gap >= threshold, `${what}: frame ${i} at ${gap.toFixed(3)} ms`);
74
+ if (dts[i] === null) return;
75
+ assert.equal(dts[i], Math.min(MAX_CAPPED_DT, gap / 1000), `${what}: dt of frame ${i}`);
76
+ last = now;
77
+ });
78
+ }
79
+
80
+ // The gaps of the frames that ran after the first, rounded to 0.01 ms.
81
+ const gaps = (list) => [...new Set(list.slice(1).map((r) => r.gap.toFixed(2)))];
82
+
83
+ export function run() {
84
+ let cases = 0;
85
+
86
+ // No cap: every timestamp runs, handed main's dt bit for bit -- uneven,
87
+ // missed, early (a timestamp before the clock started) and long-paused.
88
+ for (const maxFps of [0, undefined, null]) {
89
+ const stamps = [999.2, ...display(120, { jitter: 3, miss: 0.2 }), 90000, 90001.5, ...display(60, { start: 90001.5 })];
90
+ const dts = drive(stamps, maxFps);
91
+ let previousTime = 1000;
92
+ stamps.forEach((now, i) => {
93
+ const main = Math.min(0.033, (now - previousTime) / 1000);
94
+ previousTime = now;
95
+ assert.ok(Object.is(dts[i], main), `no cap: frame ${i} ${dts[i]} vs ${main}`);
96
+ });
97
+ cases += 1;
98
+ }
99
+
100
+ // A 60 Hz display under a 60 cap never skips, its timestamps up to 1.5 ms
101
+ // early or late at random and alternately as early and as late as that.
102
+ const sixty = display(60, { frames: 20000, jitter: 1.5 });
103
+ const worst = display(60, { frames: 2000 }).map((t, i) => t + (i % 2 ? 1.5 : -1.5));
104
+ for (const stamps of [sixty, worst, display(59.94), display(60.5)]) {
105
+ const dts = drive(stamps, 60);
106
+ assert.ok(dts.every((dt) => dt !== null), '60 Hz runs every refresh');
107
+ holds(stamps, dts, 60, '60 Hz');
108
+ cases += 1;
109
+ }
110
+
111
+ // Faster displays: a whole number of refreshes per frame, one gap.
112
+ const cadence = {};
113
+ for (const [hz, every, jitter] of [
114
+ [75, 1, 0.15],
115
+ [90, 2, 0.5],
116
+ [120, 2, 1.5],
117
+ [144, 2, 0.4],
118
+ [165, 3, 0.3],
119
+ [180, 3, 0.5],
120
+ [240, 4, 0.15],
121
+ ]) {
122
+ for (const j of [0, jitter]) {
123
+ const stamps = display(hz, { jitter: j });
124
+ const dts = drive(stamps, 60);
125
+ holds(stamps, dts, 60, `${hz} Hz`);
126
+ const ran = runs(stamps, dts);
127
+ ran.slice(1).forEach((r, k) => assert.equal(r.i - ran[k].i, every, `${hz} Hz runs every ${every} refreshes`));
128
+ if (!j) {
129
+ assert.equal(gaps(ran).length, 1, `${hz} Hz has one gap: ${gaps(ran)}`);
130
+ cadence[hz] = Math.round((1000 * every) / hz);
131
+ }
132
+ cases += 1;
133
+ }
134
+ }
135
+ assert.deepEqual(cadence, { 75: 13, 90: 22, 120: 17, 144: 14, 165: 18, 180: 17, 240: 17 });
136
+ const steady = runs(display(120), drive(display(120), 60));
137
+ assert.ok(steady.slice(1).every((r) => Math.abs(r.dt - 1 / 60) < 1e-9), '120 Hz: every dt is 16.7 ms');
138
+
139
+ // A 120 Hz display that misses refreshes: no frame within the threshold of
140
+ // the last, so the frame after a long gap is not followed by a short one.
141
+ const missing = display(120, { frames: 20000, miss: 0.15, jitter: 0.5 });
142
+ const missed = drive(missing, 60);
143
+ holds(missing, missed, 60, '120 Hz missing');
144
+ const ran = runs(missing, missed);
145
+ assert.ok(ran.slice(1).every((r) => r.gap >= 13), 'no burst after a miss');
146
+ assert.ok(
147
+ ran.some((r) => r.gap > 20),
148
+ 'some frames cover a missed refresh',
149
+ );
150
+ cases += 1;
151
+
152
+ // Every cap in range, on every display: the rule holds.
153
+ for (const maxFps of [30, 45, 60, 72, 90, 120, 144, 240]) {
154
+ for (const hz of [30, 60, 90, 120, 144, 240]) {
155
+ const stamps = display(hz, { frames: 600, jitter: 0.5, miss: 0.05 });
156
+ holds(stamps, drive(stamps, maxFps), maxFps, `${maxFps} cap at ${hz} Hz`);
157
+ cases += 1;
158
+ }
159
+ }
160
+
161
+ // The cap goes off with the scene that asked: from that frame on, every
162
+ // timestamp runs with main's dt; and on again with the next scene that asks.
163
+ const stamps = display(120, { frames: 300 });
164
+ const dts = drive(stamps, (i) => (i < 100 || i >= 200 ? 60 : 0));
165
+ assert.ok(dts.slice(100, 200).every((dt) => dt !== null), 'off at once');
166
+ // (The first of them is handed the time since the last frame that ran.)
167
+ const lastRan = dts[99] === null ? 98 : 99;
168
+ assert.equal(dts[100], Math.min(0.033, (stamps[100] - stamps[lastRan]) / 1000));
169
+ assert.ok(dts.slice(101, 200).every((dt, k) => dt === Math.min(0.033, (stamps[101 + k] - stamps[100 + k]) / 1000)));
170
+ assert.equal(dts.slice(200).filter((dt) => dt === null).length, 50, 'on again');
171
+ cases += 1;
172
+
173
+ // The first frame a clock sees runs, however soon.
174
+ assert.notEqual(drive([1000.5], 60)[0], null);
175
+ // The lowest cap is handed its whole interval, not cut at 0.033 s.
176
+ assert.ok(Math.abs(drive(display(60, { frames: 8 }), 30)[2] - 1 / 30) < 1e-9);
177
+ cases += 2;
178
+ cases += physicsKeepsTime();
179
+ cases += inputIsLent();
180
+ cases += orbitStickIsLent();
181
+ return cases;
182
+ }
183
+
184
+ // Physics steps what it is handed in fixed steps, at most so many a frame,
185
+ // dropping what is left after the last (`systems/physics3d.js`, read here so
186
+ // a change there is seen). Behaviour time and physics time must stay within
187
+ // the one step physics carries, whatever the frames are, at the lowest cap.
188
+ function physicsKeepsTime() {
189
+ const source = fs.readFileSync(new URL('../systems/physics3d.js', import.meta.url), 'utf8');
190
+ assert.match(source, /const FIXED_STEP = 1 \/ 60;/);
191
+ assert.match(source, /const MAX_STEPS_PER_FRAME = 4;/);
192
+ assert.match(source, /if \(steps === MAX_STEPS_PER_FRAME\) this\.acc = 0;/);
193
+ const FIXED_STEP = 1 / 60;
194
+ const step = (sim, dt) => {
195
+ sim.acc += dt;
196
+ let steps = 0;
197
+ while (sim.acc >= FIXED_STEP && steps < 4) {
198
+ sim.acc -= FIXED_STEP;
199
+ steps += 1;
200
+ }
201
+ if (steps === 4) sim.acc = 0;
202
+ sim.physics += steps * FIXED_STEP;
203
+ sim.behaviour += dt;
204
+ };
205
+ let cases = 0;
206
+ const slow = [display(20), display(24), display(30, { jitter: 4 }), display(60, { miss: 0.7 })];
207
+ const ragged = [];
208
+ for (let t = 1000, i = 0; i < 3000; i++) ragged.push((t += 15 + random() * 235));
209
+ for (const stamps of [...slow, ragged]) {
210
+ for (const maxFps of [30, 0]) {
211
+ const sim = { acc: 0, physics: 0, behaviour: 0 };
212
+ for (const dt of drive(stamps, maxFps)) {
213
+ if (dt === null) continue;
214
+ step(sim, dt);
215
+ const behind = sim.behaviour - sim.physics;
216
+ assert.ok(behind > -1e-9 && behind < FIXED_STEP + 1e-9, `physics keeps time (cap ${maxFps}): ${behind}`);
217
+ }
218
+ assert.ok(sim.behaviour > 10, 'the run is long');
219
+ cases += 1;
220
+ }
221
+ }
222
+ return cases;
223
+ }
224
+
225
+ // Input under the cap, as Scene3DPlayer's handlers and tick do it: a key
226
+ // handler keeps `runtime.keys` (held) and, under a cap only, the latch; the
227
+ // tick runs a capped frame with `updateLending`, an uncapped one with
228
+ // `runtime.update`. Events are given as [ms, kind, value].
229
+ function play(stamps, events, maxFps, { throwAt = -1 } = {}) {
230
+ const move = { x: 0, y: 0, active: false };
231
+ const seen = [];
232
+ const runtime = {
233
+ maxFps,
234
+ keys: new Set(),
235
+ moveInput: move,
236
+ update(dt) {
237
+ seen.push({ keys: [...this.keys].sort(), stick: move.active ? [move.x, move.y] : null, dt });
238
+ if (seen.length - 1 === throwAt) throw new Error('update threw');
239
+ },
240
+ };
241
+ const latch = makeInputLatch();
242
+ const clock = makeFrameClock(stamps[0] - 1);
243
+ const queue = [...events].sort((a, b) => a[0] - b[0]);
244
+ const after = [];
245
+ for (const now of stamps) {
246
+ while (queue.length && queue[0][0] < now) {
247
+ const [, kind, value] = queue.shift();
248
+ if (kind === 'down' || kind === 'repeat') {
249
+ // As Scene3DPlayer's handler: an auto-repeat keydown is held, not noted.
250
+ runtime.keys.add(value);
251
+ if (runtime.maxFps > 0 && kind === 'down') latch.keys.add(value);
252
+ } else if (kind === 'up') {
253
+ runtime.keys.delete(value);
254
+ } else if (kind === 'drag') {
255
+ move.active = true;
256
+ [move.x, move.y] = value;
257
+ if (runtime.maxFps > 0) latch.stick = { x: move.x, y: move.y };
258
+ } else if (kind === 'lift') {
259
+ move.active = false;
260
+ move.x = 0;
261
+ move.y = 0;
262
+ }
263
+ }
264
+ if (runtime.maxFps === 0) assert.ok(latch.keys.size === 0 && latch.stick === null, 'nothing is latched without a cap');
265
+ const dt = nextFrame(clock, now, runtime.maxFps);
266
+ if (dt === null) continue;
267
+ try {
268
+ if (runtime.maxFps > 0) updateLending(runtime, latch, dt);
269
+ else runtime.update(dt);
270
+ } catch {
271
+ // the loop stops on a throw; what matters is what it left behind
272
+ }
273
+ after.push({ keys: [...runtime.keys].sort(), stick: move.active ? [move.x, move.y] : null });
274
+ }
275
+ return { seen, after };
276
+ }
277
+
278
+ function inputIsLent() {
279
+ let cases = 0;
280
+ const hz120 = Array.from({ length: 40 }, (_, i) => 1000 + (i * 1000) / 120);
281
+ const at = (ms) => 1000 + ms;
282
+ // Space down at 4 ms, up at 12 ms: the 8.3 ms frame sees it without the
283
+ // cap; with it, that frame is skipped and the 16.7 ms frame sees it, once.
284
+ const tap = [[at(4), 'down', 'Space'], [at(12), 'up', 'Space']];
285
+ const plain = play(hz120, tap, 0);
286
+ assert.deepEqual(plain.seen.map((f) => f.keys.join()).slice(0, 3), ['', 'Space', '']);
287
+ const capped = play(hz120, tap, 60);
288
+ assert.deepEqual(capped.seen.map((f) => f.keys.join()).slice(0, 3), ['', 'Space', ''], 'seen by the next frame that runs');
289
+ assert.ok(capped.after.every((f) => f.keys.length === 0), 'and taken back after it');
290
+ cases += 1;
291
+ // Held across skipped frames: held in every frame, never taken out.
292
+ const held = play(hz120, [[at(4), 'down', 'KeyW'], [at(200), 'up', 'KeyW']], 60);
293
+ assert.ok(held.seen.slice(1, 12).every((f) => f.keys.join() === 'KeyW'));
294
+ assert.ok(held.after.slice(1, 12).every((f) => f.keys.join() === 'KeyW'), 'a held key stays held');
295
+ cases += 1;
296
+ // A drag begun and ended between two frames that run: its last direction,
297
+ // for one frame, then the stick at rest. One still held is its own.
298
+ const flick = play(hz120, [[at(2), 'drag', [0.1, -0.5]], [at(6), 'drag', [0.2, -0.9]], [at(12), 'lift']], 60);
299
+ assert.deepEqual(flick.seen.slice(0, 3).map((f) => f.stick), [null, [0.2, -0.9], null]);
300
+ assert.ok(flick.after.every((f) => f.stick === null));
301
+ const drag = play(hz120, [[at(2), 'drag', [0.1, -0.5]], [at(20), 'drag', [0.3, 0.3]]], 60);
302
+ assert.deepEqual(drag.seen.slice(1, 3).map((f) => f.stick), [[0.1, -0.5], [0.3, 0.3]]);
303
+ cases += 1;
304
+ // Auto-repeat after a frame has seen the press is not a new press: released
305
+ // before the next frame that runs, it is not lent back.
306
+ const repeat = play(hz120, [[at(4), 'down', 'Space'], [at(20), 'repeat', 'Space'], [at(24), 'up', 'Space']], 60);
307
+ assert.deepEqual(repeat.seen.slice(0, 3).map((f) => f.keys.join()), ['', 'Space', ''], 'a repeat does not replay the press');
308
+ cases += 1;
309
+ // An update that throws still gives back what it was lent.
310
+ const threw = play(hz120, tap, 60, { throwAt: 1 });
311
+ assert.deepEqual(threw.after[1].keys, []);
312
+ cases += 1;
313
+ // Random presses on a 120 Hz display that misses frames: every press is
314
+ // seen by a frame that runs, and a key is in a frame only if it is held
315
+ // then or went down since the frame before.
316
+ const stamps = display(120, { frames: 6000, miss: 0.1, jitter: 0.5 });
317
+ const presses = [];
318
+ for (let i = 0; i < 400; i++) {
319
+ const from = 1000 + random() * 48000;
320
+ const code = `Key${'ABCDEFGH'[i % 8]}${i}`;
321
+ presses.push({ code, from, to: from + 0.5 + random() * 30 });
322
+ }
323
+ const events = presses.flatMap((p) => [[p.from, 'down', p.code], [p.to, 'up', p.code]]);
324
+ const fuzz = play(stamps, events, 60);
325
+ const ranAt = [];
326
+ {
327
+ const clock = makeFrameClock(stamps[0] - 1);
328
+ for (const now of stamps) if (nextFrame(clock, now, 60) !== null) ranAt.push(now);
329
+ }
330
+ presses.forEach((p) => {
331
+ const frames = ranAt.map((now, k) => (fuzz.seen[k].keys.includes(p.code) ? k : -1)).filter((k) => k >= 0);
332
+ if (p.from >= ranAt[ranAt.length - 1]) return;
333
+ assert.ok(frames.length > 0, `press ${p.code} is seen`);
334
+ for (const k of frames) {
335
+ const heldThen = p.from < ranAt[k] && p.to >= ranAt[k];
336
+ const sinceLast = p.from < ranAt[k] && (k === 0 || p.from >= ranAt[k - 1]);
337
+ assert.ok(heldThen || sinceLast, `press ${p.code} only where it belongs`);
338
+ }
339
+ });
340
+ assert.ok(fuzz.after.every((f) => f.keys.every((code) => presses.some((p) => p.code === code))));
341
+ cases += 1;
342
+ return cases;
343
+ }
344
+
345
+ // Scene3DPlayer's own `attachInput`, cut out of the .jsx (it holds no JSX) as
346
+ // test-camera-orbit.mjs cuts it, run with the real orbit input, a stand-in
347
+ // canvas, window, document and clock.
348
+ function attachInputFromPlayer(clock) {
349
+ const source = fs.readFileSync(new URL('../engine3d/Scene3DPlayer.jsx', import.meta.url), 'utf8');
350
+ const cut = source.slice(source.indexOf('function attachInput('), source.indexOf('\nfunction attachResize('));
351
+ assert.ok(cut.length > 1000 && cut.trimEnd().endsWith('\n}') && !/<[A-Za-z]/.test(cut), 'attachInput is cut out whole');
352
+ const target = () => {
353
+ const on = [];
354
+ return {
355
+ addEventListener: (type, fn) => on.push([type, fn]),
356
+ removeEventListener: (type, fn) => {
357
+ const i = on.findIndex(([t, f]) => t === type && f === fn);
358
+ if (i >= 0) on.splice(i, 1);
359
+ },
360
+ focus() {},
361
+ setPointerCapture() {},
362
+ getBoundingClientRect: () => ({ left: 100, top: 0, width: 800, height: 600 }),
363
+ fire(type, event) {
364
+ const e = { type, preventDefault() {}, stopPropagation() {}, ...event };
365
+ for (const [t, fn] of [...on]) if (t === type) fn(e);
366
+ },
367
+ };
368
+ };
369
+ const window = target();
370
+ window.parent = window;
371
+ const attachInput = new Function('attachOrbitInput', 'window', 'document', 'performance', `${cut}\nreturn attachInput;`)(
372
+ attachOrbitInput,
373
+ window,
374
+ { hasFocus: () => true },
375
+ clock
376
+ );
377
+ return { canvas: target(), attachInput };
378
+ }
379
+
380
+ // The stick under the orbit camera key, which the orbit input writes: the
381
+ // real handlers and orbit input, frames run as the tick runs them. Events are
382
+ // [ms, type, x, y], fired as touch pointer 1.
383
+ function playOrbit(stamps, events, maxFps) {
384
+ const clock = { t: 0, now: () => clock.t };
385
+ const { canvas, attachInput } = attachInputFromPlayer(clock);
386
+ const seen = [];
387
+ const runtime = {
388
+ maxFps,
389
+ cameraControl: 'orbit',
390
+ keys: new Set(),
391
+ update(dt) {
392
+ const move = this.moveInput;
393
+ seen.push({ stick: move.active ? [move.x, move.y] : null, dt });
394
+ },
395
+ };
396
+ const latch = makeInputLatch();
397
+ const detach = attachInput(canvas, runtime, { debugLines: { visible: false } }, latch);
398
+ const frameClock = makeFrameClock(stamps[0] - 1);
399
+ const queue = [...events].sort((a, b) => a[0] - b[0]);
400
+ const after = [];
401
+ for (const now of stamps) {
402
+ while (queue.length && queue[0][0] < now) {
403
+ const [at, type, x, y] = queue.shift();
404
+ clock.t = at;
405
+ canvas.fire(type, { pointerId: 1, clientX: x, clientY: y, pointerType: 'touch', button: 0 });
406
+ }
407
+ if (!(runtime.maxFps > 0)) assert.ok(latch.keys.size === 0 && latch.stick === null, 'nothing is latched without a cap');
408
+ clock.t = now;
409
+ const dt = nextFrame(frameClock, now, runtime.maxFps);
410
+ if (dt === null) continue;
411
+ if (runtime.maxFps > 0) updateLending(runtime, latch, dt);
412
+ else runtime.update(dt);
413
+ const move = runtime.moveInput;
414
+ after.push({ stick: move.active ? [move.x, move.y] : null });
415
+ }
416
+ detach();
417
+ return { seen, after };
418
+ }
419
+
420
+ function orbitStickIsLent() {
421
+ let cases = 0;
422
+ const hz120 = Array.from({ length: 40 }, (_, i) => 1000 + (i * 1000) / 120);
423
+ const at = (ms) => 1000 + ms;
424
+ // A finger down on the left half (the stick's), past the tap slop and on,
425
+ // and up again, all before the 16.7 ms frame: under a cap of 60 the 8.3 ms
426
+ // frame that would have seen it is skipped.
427
+ const flick = [
428
+ [at(2), 'pointerdown', 200, 300],
429
+ [at(4), 'pointermove', 200, 250],
430
+ [at(6), 'pointermove', 230, 200],
431
+ [at(12), 'pointerup', 230, 200],
432
+ ];
433
+ const last = stickFrom(30, -100, 56);
434
+ const capped = playOrbit(hz120, flick, 60);
435
+ assert.deepEqual(capped.seen.slice(0, 3).map((f) => f.stick), [null, [last.x, last.y], null], 'the orbit stick is lent to the next frame that runs');
436
+ assert.ok(capped.after.every((f) => f.stick === null), 'and is at rest after it');
437
+ cases += 1;
438
+ // Without a cap (0, or a runtime that never read the key) nothing is
439
+ // latched, and the 8.3 ms frame sees the drag held, as always.
440
+ for (const maxFps of [0, undefined]) {
441
+ const plain = playOrbit(hz120, flick, maxFps);
442
+ assert.deepEqual(plain.seen.slice(0, 3).map((f) => f.stick), [null, [last.x, last.y], null], `uncapped (${maxFps})`);
443
+ }
444
+ cases += 1;
445
+ // A drag held across frames under the cap is its own, never lent over.
446
+ const held = playOrbit(hz120, [[at(2), 'pointerdown', 200, 300], [at(4), 'pointermove', 200, 250], [at(30), 'pointermove', 230, 200]], 60);
447
+ const first = stickFrom(0, -50, 56);
448
+ assert.deepEqual(held.seen.slice(1, 3).map((f) => f.stick), [[first.x, first.y], [last.x, last.y]]);
449
+ assert.deepEqual(held.after.at(-1).stick, [last.x, last.y]);
450
+ cases += 1;
451
+ return cases;
452
+ }