castle-web-cli 0.4.232 → 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 (355) 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/shell/assets/{index-D2tWM896.js → index-BjOxR-lW.js} +4 -4
  28. package/dist/shell/assets/index-MVLfNYd9.css +1 -0
  29. package/dist/shell/index.html +2 -2
  30. package/dist/taskSteer.d.ts +13 -0
  31. package/dist/taskSteer.js +22 -2
  32. package/kits/base/castle.json +1 -1
  33. package/kits/base/package-lock.json +1 -1
  34. package/kits/base/sdk/README.md +79 -2
  35. package/kits/base/sdk/avatar.d.ts +6 -2
  36. package/kits/base/sdk/avatar.js +12 -4
  37. package/kits/base/sdk/castle.d.ts +1 -1
  38. package/kits/base/sdk/commands.d.ts +14 -0
  39. package/kits/base/sdk/hub.d.ts +6 -2
  40. package/kits/base/sdk/hub.js +13 -0
  41. package/kits/base/sdk/multiplayer.js +17 -1
  42. package/kits/base/sdk/save.js +2 -1
  43. package/kits/base/sdk/server/hub.d.ts +87 -0
  44. package/kits/base/sdk/server/hub.js +70 -0
  45. package/kits/base/sdk/server/platformHandle.d.ts +31 -1
  46. package/kits/base/sdk/server/storage.d.ts +13 -0
  47. package/kits/base/sdk/server/storage.js +46 -0
  48. package/kits/base/sdk/server/wrapper.d.ts +36 -5
  49. package/kits/base/sdk/server/wrapper.js +83 -8
  50. package/kits/hub-game/CLAUDE.md +329 -11
  51. package/kits/hub-game/blueprints/avatar-10.scene +28 -0
  52. package/kits/hub-game/blueprints/avatar-11.scene +28 -0
  53. package/kits/hub-game/blueprints/avatar-12.scene +28 -0
  54. package/kits/hub-game/blueprints/avatar-13.scene +28 -0
  55. package/kits/hub-game/blueprints/avatar-14.scene +28 -0
  56. package/kits/hub-game/blueprints/avatar-15.scene +28 -0
  57. package/kits/hub-game/blueprints/avatar-4.scene +28 -0
  58. package/kits/hub-game/blueprints/avatar-5.scene +28 -0
  59. package/kits/hub-game/blueprints/avatar-6.scene +28 -0
  60. package/kits/hub-game/blueprints/avatar-7.scene +28 -0
  61. package/kits/hub-game/blueprints/avatar-8.scene +28 -0
  62. package/kits/hub-game/blueprints/avatar-9.scene +28 -0
  63. package/kits/hub-game/code/client/actorBudget.js +47 -0
  64. package/kits/hub-game/code/client/attention.js +11 -2
  65. package/kits/hub-game/code/client/avatar.js +309 -35
  66. package/kits/hub-game/code/client/avatarCap.js +228 -0
  67. package/kits/hub-game/code/client/avatarColors.js +70 -0
  68. package/kits/hub-game/code/client/avatarFaces.js +21 -0
  69. package/kits/hub-game/code/client/avatarShare.js +251 -0
  70. package/kits/hub-game/code/client/ballot.js +467 -0
  71. package/kits/hub-game/code/client/build.js +22 -0
  72. package/kits/hub-game/code/client/chrome.js +1144 -50
  73. package/kits/hub-game/code/client/companion.js +716 -0
  74. package/kits/hub-game/code/client/companionDress.js +99 -0
  75. package/kits/hub-game/code/client/decor.js +509 -0
  76. package/kits/hub-game/code/client/earned.js +131 -0
  77. package/kits/hub-game/code/client/emoteBubble.js +75 -0
  78. package/kits/hub-game/code/client/grab.js +339 -20
  79. package/kits/hub-game/code/client/hookLayer.js +299 -13
  80. package/kits/hub-game/code/client/idle.js +163 -22
  81. package/kits/hub-game/code/client/interestCap.js +81 -0
  82. package/kits/hub-game/code/client/keys.js +36 -0
  83. package/kits/hub-game/code/client/labelsNear.js +205 -0
  84. package/kits/hub-game/code/client/menuIcons.js +34 -0
  85. package/kits/hub-game/code/client/pack.js +6 -2
  86. package/kits/hub-game/code/client/packFormat.js +3 -3
  87. package/kits/hub-game/code/client/rehello.js +167 -0
  88. package/kits/hub-game/code/client/shot.js +92 -0
  89. package/kits/hub-game/code/client/sound.js +63 -8
  90. package/kits/hub-game/code/client/soundscape.js +1151 -0
  91. package/kits/hub-game/code/client/soundscapeActions.js +99 -0
  92. package/kits/hub-game/code/client/soundscapeAmbience.js +453 -0
  93. package/kits/hub-game/code/client/soundscapeBaked.js +143 -0
  94. package/kits/hub-game/code/client/soundscapeBusker.js +217 -0
  95. package/kits/hub-game/code/client/soundscapeCourt.js +200 -0
  96. package/kits/hub-game/code/client/soundscapeCrowd.js +331 -0
  97. package/kits/hub-game/code/client/soundscapeCues.js +362 -0
  98. package/kits/hub-game/code/client/soundscapeMap.js +181 -0
  99. package/kits/hub-game/code/client/soundscapeMarket.js +176 -0
  100. package/kits/hub-game/code/client/soundscapeMusic.js +126 -0
  101. package/kits/hub-game/code/client/soundscapeMusicEngine.js +460 -0
  102. package/kits/hub-game/code/client/soundscapeSimlish.js +737 -0
  103. package/kits/hub-game/code/client/soundscapeSongs.js +127 -0
  104. package/kits/hub-game/code/client/soundscapeSongsRound3.js +63 -0
  105. package/kits/hub-game/code/client/soundscapeSynthesis.js +168 -0
  106. package/kits/hub-game/code/client/soundscapeUi.js +211 -0
  107. package/kits/hub-game/code/client/soundscapeVoice.js +1209 -0
  108. package/kits/hub-game/code/client/soundscapeWaves.js +206 -0
  109. package/kits/hub-game/code/client/spin.js +101 -0
  110. package/kits/hub-game/code/client/state.js +109 -1
  111. package/kits/hub-game/code/client/stuck.js +259 -0
  112. package/kits/hub-game/code/client/talk.js +538 -47
  113. package/kits/hub-game/code/client/tiers.js +516 -27
  114. package/kits/hub-game/code/client/toastBand.js +37 -0
  115. package/kits/hub-game/code/client/together.js +32 -0
  116. package/kits/hub-game/code/client/visibility.js +43 -0
  117. package/kits/hub-game/code/client/wear.js +461 -170
  118. package/kits/hub-game/code/client/yours.js +199 -0
  119. package/kits/hub-game/code/companionSpec.js +45 -0
  120. package/kits/hub-game/code/privateText.js +7 -0
  121. package/kits/hub-game/code/server/actions.js +133 -0
  122. package/kits/hub-game/code/server/actors.js +9 -1
  123. package/kits/hub-game/code/server/ask.js +155 -0
  124. package/kits/hub-game/code/server/ballot.js +539 -0
  125. package/kits/hub-game/code/server/cells.js +100 -0
  126. package/kits/hub-game/code/server/companion.js +82 -0
  127. package/kits/hub-game/code/server/cues.js +70 -0
  128. package/kits/hub-game/code/server/decor.js +269 -0
  129. package/kits/hub-game/code/server/earned.js +461 -0
  130. package/kits/hub-game/code/server/friendBests.js +166 -0
  131. package/kits/hub-game/code/server/friendsAmong.js +232 -0
  132. package/kits/hub-game/code/server/history.js +5 -0
  133. package/kits/hub-game/code/server/hub.js +1254 -50
  134. package/kits/hub-game/code/server/idle.js +30 -11
  135. package/kits/hub-game/code/server/index.js +2 -2
  136. package/kits/hub-game/code/server/labels.js +28 -2
  137. package/kits/hub-game/code/server/manifest.js +378 -7
  138. package/kits/hub-game/code/server/menu.js +133 -0
  139. package/kits/hub-game/code/server/npcs.js +830 -80
  140. package/kits/hub-game/code/server/party.js +2 -2
  141. package/kits/hub-game/code/server/players.js +22 -0
  142. package/kits/hub-game/code/server/shot.js +110 -0
  143. package/kits/hub-game/code/server/standing.js +124 -0
  144. package/kits/hub-game/code/server/vis.js +113 -0
  145. package/kits/hub-game/code/server/wear.js +12 -0
  146. package/kits/hub-game/code/server/yours.js +59 -0
  147. package/kits/hub-game/code/shared/cues.js +9 -0
  148. package/kits/hub-game/code/shared/decor.js +41 -0
  149. package/kits/hub-game/code/shared/shot.js +19 -0
  150. package/kits/hub-game/code/shared/spin.js +57 -0
  151. package/kits/hub-game/code/systems/hub.js +845 -95
  152. package/kits/hub-game/docs/content-pack.md +1 -1
  153. package/kits/hub-game/docs/contract.md +2244 -61
  154. package/kits/hub-game/docs/home-pieces.md +64 -0
  155. package/kits/hub-game/models/avatar-10.pxmodel +28 -0
  156. package/kits/hub-game/models/avatar-11.pxmodel +28 -0
  157. package/kits/hub-game/models/avatar-12.pxmodel +27 -0
  158. package/kits/hub-game/models/avatar-13.pxmodel +24 -0
  159. package/kits/hub-game/models/avatar-14.pxmodel +29 -0
  160. package/kits/hub-game/models/avatar-15.pxmodel +24 -0
  161. package/kits/hub-game/models/avatar-4.pxmodel +29 -0
  162. package/kits/hub-game/models/avatar-5.pxmodel +27 -0
  163. package/kits/hub-game/models/avatar-6.pxmodel +26 -0
  164. package/kits/hub-game/models/avatar-7.pxmodel +25 -0
  165. package/kits/hub-game/models/avatar-8.pxmodel +24 -0
  166. package/kits/hub-game/models/avatar-9.pxmodel +30 -0
  167. package/kits/hub-game/models/earned/badge-round.pxmodel +100 -0
  168. package/kits/hub-game/models/earned/badge-shield.pxmodel +117 -0
  169. package/kits/hub-game/models/earned/badge-star.pxmodel +87 -0
  170. package/kits/hub-game/models/earned/belt-plain.pxmodel +72 -0
  171. package/kits/hub-game/models/earned/held-ball.pxmodel +43 -0
  172. package/kits/hub-game/models/earned/held-lantern.pxmodel +85 -0
  173. package/kits/hub-game/models/earned/held-net.pxmodel +57 -0
  174. package/kits/hub-game/models/earned/held-trophy.pxmodel +109 -0
  175. package/kits/hub-game/models/earned/pin-round.pxmodel +62 -0
  176. package/kits/hub-game/models/earned/sash-plain.pxmodel +66 -0
  177. package/kits/hub-game/models/earned/square/belt-plain.pxmodel +104 -0
  178. package/kits/hub-game/models/earned/square/sash-plain.pxmodel +98 -0
  179. package/kits/hub-game/models/hats/bat-clip.pxmodel +206 -0
  180. package/kits/hub-game/models/hats/beekeeper.pxmodel +149 -0
  181. package/kits/hub-game/models/hats/cap.pxmodel +162 -0
  182. package/kits/hub-game/models/hats/captain.pxmodel +178 -0
  183. package/kits/hub-game/models/hats/crooked-top.pxmodel +172 -0
  184. package/kits/hub-game/models/hats/flower-crown.pxmodel +451 -0
  185. package/kits/hub-game/models/hats/foam-crown.pxmodel +179 -0
  186. package/kits/hub-game/models/hats/lantern.pxmodel +230 -0
  187. package/kits/hub-game/models/hats/laurel.pxmodel +533 -0
  188. package/kits/hub-game/models/hats/lighthouse.pxmodel +96 -0
  189. package/kits/hub-game/models/hats/sailor.pxmodel +141 -0
  190. package/kits/hub-game/models/hats/souwester.pxmodel +131 -0
  191. package/kits/hub-game/models/hats/straw.pxmodel +139 -0
  192. package/kits/hub-game/models/hats/sunflower.pxmodel +406 -0
  193. package/kits/hub-game/models/hats/sweatband.pxmodel +112 -0
  194. package/kits/hub-game/models/hats/witch.pxmodel +147 -0
  195. package/kits/hub-game/package-lock.json +2 -0
  196. package/kits/hub-game/package.json +2 -1
  197. package/kits/hub-game/scripts/check.mjs +78 -11
  198. package/kits/hub-game/scripts/companion-follower-wire.json +1 -0
  199. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +121 -0
  200. package/kits/hub-game/scripts/fixtures/decor-keyless.json +293 -0
  201. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +23 -0
  202. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +107 -0
  203. package/kits/hub-game/scripts/fixtures/interest-legacy.json +385 -0
  204. package/kits/hub-game/scripts/fixtures/npc-notes-v1.77.jsonl +4 -0
  205. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -0
  206. package/kits/hub-game/scripts/gen-avatars.mjs +933 -16
  207. package/kits/hub-game/scripts/gen-earned.mjs +285 -0
  208. package/kits/hub-game/scripts/gen-hats.mjs +827 -0
  209. package/kits/hub-game/scripts/grab.before-orbit.mjs +400 -0
  210. package/kits/hub-game/scripts/soundscape-wave-analysis.mjs +125 -0
  211. package/kits/hub-game/scripts/test-actions-client.mjs +488 -0
  212. package/kits/hub-game/scripts/test-actions.mjs +298 -0
  213. package/kits/hub-game/scripts/test-actor-budget.mjs +44 -0
  214. package/kits/hub-game/scripts/test-actors.mjs +19 -17
  215. package/kits/hub-game/scripts/test-ask-client.mjs +358 -0
  216. package/kits/hub-game/scripts/test-ask.mjs +269 -0
  217. package/kits/hub-game/scripts/test-attention.mjs +10 -1
  218. package/kits/hub-game/scripts/test-avatar-cap.mjs +379 -0
  219. package/kits/hub-game/scripts/test-avatar-colors.mjs +72 -0
  220. package/kits/hub-game/scripts/test-avatar-models.mjs +181 -0
  221. package/kits/hub-game/scripts/test-avatar-share.mjs +318 -0
  222. package/kits/hub-game/scripts/test-avatar-wire.mjs +753 -0
  223. package/kits/hub-game/scripts/test-avatar.mjs +540 -7
  224. package/kits/hub-game/scripts/test-ballot.mjs +1001 -0
  225. package/kits/hub-game/scripts/test-build.mjs +31 -0
  226. package/kits/hub-game/scripts/test-cells.mjs +71 -0
  227. package/kits/hub-game/scripts/test-chat.mjs +662 -0
  228. package/kits/hub-game/scripts/test-classic.mjs +2 -0
  229. package/kits/hub-game/scripts/test-companion-chat.mjs +198 -0
  230. package/kits/hub-game/scripts/test-companion-client.mjs +1167 -0
  231. package/kits/hub-game/scripts/test-companion.mjs +259 -0
  232. package/kits/hub-game/scripts/test-decor-client.mjs +303 -0
  233. package/kits/hub-game/scripts/test-decor.mjs +457 -0
  234. package/kits/hub-game/scripts/test-earned-client.mjs +459 -0
  235. package/kits/hub-game/scripts/test-earned.mjs +1194 -0
  236. package/kits/hub-game/scripts/test-emote-bubble.mjs +110 -0
  237. package/kits/hub-game/scripts/test-friend-bests.mjs +435 -0
  238. package/kits/hub-game/scripts/test-grab-orbit.mjs +918 -0
  239. package/kits/hub-game/scripts/test-grab.mjs +7 -0
  240. package/kits/hub-game/scripts/test-hats.mjs +422 -168
  241. package/kits/hub-game/scripts/test-hub-leaving.mjs +203 -0
  242. package/kits/hub-game/scripts/test-hub-ops.mjs +439 -2
  243. package/kits/hub-game/scripts/test-hub-trip.mjs +716 -2
  244. package/kits/hub-game/scripts/test-hud-clear.mjs +328 -4
  245. package/kits/hub-game/scripts/test-idle.mjs +361 -1
  246. package/kits/hub-game/scripts/test-interest-cap.mjs +36 -0
  247. package/kits/hub-game/scripts/test-interest-cells.mjs +493 -0
  248. package/kits/hub-game/scripts/test-interest-client.mjs +118 -0
  249. package/kits/hub-game/scripts/test-keys.mjs +46 -1
  250. package/kits/hub-game/scripts/test-labels.mjs +596 -0
  251. package/kits/hub-game/scripts/test-manifest.mjs +207 -0
  252. package/kits/hub-game/scripts/test-menu-client.mjs +480 -0
  253. package/kits/hub-game/scripts/test-menu.mjs +296 -0
  254. package/kits/hub-game/scripts/test-npcs.mjs +1718 -12
  255. package/kits/hub-game/scripts/test-object-entry.mjs +76 -0
  256. package/kits/hub-game/scripts/test-pack.mjs +7 -0
  257. package/kits/hub-game/scripts/test-picker.mjs +314 -0
  258. package/kits/hub-game/scripts/test-rehello.mjs +1039 -0
  259. package/kits/hub-game/scripts/test-relations-among.mjs +222 -0
  260. package/kits/hub-game/scripts/test-relations-refresh.mjs +188 -0
  261. package/kits/hub-game/scripts/test-shot.mjs +756 -0
  262. package/kits/hub-game/scripts/test-soundscape.mjs +5432 -0
  263. package/kits/hub-game/scripts/test-spin.mjs +314 -0
  264. package/kits/hub-game/scripts/test-standing.mjs +416 -0
  265. package/kits/hub-game/scripts/test-stuck.mjs +1903 -0
  266. package/kits/hub-game/scripts/test-tier-cells.mjs +706 -0
  267. package/kits/hub-game/scripts/test-tiers-render.mjs +339 -0
  268. package/kits/hub-game/scripts/test-tiers.mjs +477 -2
  269. package/kits/hub-game/scripts/test-toast-band.mjs +61 -0
  270. package/kits/hub-game/scripts/test-try-on.mjs +22 -22
  271. package/kits/hub-game/scripts/test-vis.mjs +343 -0
  272. package/kits/hub-game/scripts/test-visibility.mjs +134 -0
  273. package/kits/hub-game/scripts/test-yours-chrome.mjs +166 -0
  274. package/kits/hub-game/scripts/test-yours.mjs +372 -0
  275. package/kits/multiplayer-3d/CLAUDE.md +50 -0
  276. package/kits/multiplayer-3d/castle.json +5 -5
  277. package/kits/multiplayer-3d/code/client/avatars.js +7 -0
  278. package/kits/multiplayer-3d/code/client/gait.js +65 -0
  279. package/kits/multiplayer-3d/code/client/nameTags.js +59 -4
  280. package/kits/multiplayer-3d/code/options.js +5 -0
  281. package/kits/multiplayer-3d/code/server/ownership.js +10 -2
  282. package/kits/multiplayer-3d/code/server/sceneBodies.js +12 -0
  283. package/kits/multiplayer-3d/code/server/world.js +7 -0
  284. package/kits/multiplayer-3d/code/systems/multiplayer.js +74 -4
  285. package/kits/multiplayer-3d/package.json +2 -1
  286. package/kits/multiplayer-3d/scripts/fixtures/README.md +11 -0
  287. package/kits/multiplayer-3d/scripts/fixtures/ownership-legacy.json +2 -0
  288. package/kits/multiplayer-3d/scripts/ownership-harness.mjs +102 -0
  289. package/kits/multiplayer-3d/scripts/ownership-loader.mjs +46 -0
  290. package/kits/multiplayer-3d/scripts/ownership-worker.mjs +15 -0
  291. package/kits/multiplayer-3d/scripts/record-ownership-session.mjs +98 -0
  292. package/kits/multiplayer-3d/scripts/test-eligible-claims.mjs +167 -0
  293. package/kits/multiplayer-3d/scripts/test-own-name-tag.mjs +247 -0
  294. package/kits/physics-2d/CLAUDE.md +9 -0
  295. package/kits/physics-2d/castle.json +2 -2
  296. package/kits/physics-2d/engine/scene.js +253 -1
  297. package/kits/physics-2d/engine/skyKey.js +129 -0
  298. package/kits/physics-2d/engine/stillClock.js +106 -0
  299. package/kits/physics-2d/engine/updateBudget.js +21 -0
  300. package/kits/physics-2d/scripts/test-skip-unchanged.mjs +326 -1
  301. package/kits/physics-3d/CLAUDE.md +1169 -30
  302. package/kits/physics-3d/behaviors/Player.jsx +629 -72
  303. package/kits/physics-3d/castle.json +3 -3
  304. package/kits/physics-3d/docs/pxmodel-format.md +8 -0
  305. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +69 -13
  306. package/kits/physics-3d/engine3d/actornode.js +86 -0
  307. package/kits/physics-3d/engine3d/animationBudget.js +23 -0
  308. package/kits/physics-3d/engine3d/editorWorld.js +6 -0
  309. package/kits/physics-3d/engine3d/emptynodes.js +232 -0
  310. package/kits/physics-3d/engine3d/framecap.js +96 -0
  311. package/kits/physics-3d/engine3d/gait.js +118 -0
  312. package/kits/physics-3d/engine3d/kithooks.js +47 -0
  313. package/kits/physics-3d/engine3d/look.js +507 -48
  314. package/kits/physics-3d/engine3d/lookbake.js +208 -0
  315. package/kits/physics-3d/engine3d/materialpresets.js +2 -0
  316. package/kits/physics-3d/engine3d/motion.js +39 -10
  317. package/kits/physics-3d/engine3d/nearshadows.js +37 -19
  318. package/kits/physics-3d/engine3d/optimize.js +9 -5
  319. package/kits/physics-3d/engine3d/orbitinput.js +487 -9
  320. package/kits/physics-3d/engine3d/orbitlens.js +48 -0
  321. package/kits/physics-3d/engine3d/ownmodel.js +213 -0
  322. package/kits/physics-3d/engine3d/pxmodel.js +42 -11
  323. package/kits/physics-3d/engine3d/shadowfade.js +882 -0
  324. package/kits/physics-3d/engine3d/sky.js +547 -0
  325. package/kits/physics-3d/engine3d/skylife.js +306 -0
  326. package/kits/physics-3d/engine3d/unchanged.js +11 -0
  327. package/kits/physics-3d/engine3d/viewrange.js +52 -0
  328. package/kits/physics-3d/engine3d/world3d.js +796 -69
  329. package/kits/physics-3d/main.jsx +5 -0
  330. package/kits/physics-3d/package.json +1 -1
  331. package/kits/physics-3d/scripts/look-baseline.mjs +155 -0
  332. package/kits/physics-3d/scripts/test-camera-orbit.mjs +2563 -80
  333. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +1 -1
  334. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +435 -0
  335. package/kits/physics-3d/scripts/test-frame-cap.mjs +452 -0
  336. package/kits/physics-3d/scripts/test-gait.mjs +387 -0
  337. package/kits/physics-3d/scripts/test-look-bake.mjs +1056 -0
  338. package/kits/physics-3d/scripts/test-model-parse-cache.mjs +92 -0
  339. package/kits/physics-3d/scripts/test-near-shadows.mjs +3 -0
  340. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +1920 -0
  341. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +545 -0
  342. package/kits/physics-3d/scripts/test-orbit-shot.mjs +583 -0
  343. package/kits/physics-3d/scripts/test-orbit-view.mjs +230 -0
  344. package/kits/physics-3d/scripts/test-skip-empty-nodes.mjs +845 -0
  345. package/kits/physics-3d/scripts/test-sky.mjs +2470 -0
  346. package/kits/physics-3d/scripts/test-static-actors.mjs +8 -1
  347. package/kits/physics-3d/scripts/test-static-scenery.mjs +2171 -0
  348. package/kits/physics-3d/scripts/test-steady-hover.mjs +2 -0
  349. package/kits/physics-3d/scripts/test-view-range.mjs +260 -0
  350. package/kits/physics-3d/systems/physics3d.js +383 -6
  351. package/kits/real-time/castle.json +2 -2
  352. package/kits/real-time/code/server/gameHooks.js +7 -0
  353. package/kits/real-time/code/server/session.js +97 -19
  354. package/package.json +2 -2
  355. package/dist/shell/assets/index-Cf61cNfT.css +0 -1
@@ -185,7 +185,7 @@ function materialOf(material) {
185
185
 
186
186
  // Everything a frame draws: each actor's meshes and outlines in the order
187
187
  // three.js walks them, with what each is drawn from and where.
188
- function drawn(world) {
188
+ export function drawn(world) {
189
189
  const lines = [];
190
190
  for (const [id, entry] of world.nodes) {
191
191
  entry.node.traverseVisible((object) => {
@@ -0,0 +1,435 @@
1
+ // The Player's walking bob under the frame cap (`"engine": { "maxFps": 60 }`,
2
+ // engine3d/framecap.js), against the same frames uncapped.
3
+ //
4
+ // The real Player drives the real Physics3DSystem (accumulator, fixed 1/60
5
+ // steps, at most four a frame, interpolated write-back, the follow camera
6
+ // placed last), frame by frame as Scene3DPlayer's tick drives them: the real
7
+ // `nextFrame` decides from made-up requestAnimationFrame timestamps which
8
+ // animation frames run and what dt each is handed (at most 0.033 s uncapped,
9
+ // 3/60 capped). On flat ground the player walks forward without stopping;
10
+ // what is measured is the drawn (interpolated Transform) height, peak to peak
11
+ // and rms, the camera's height and its distance from the player as drawn
12
+ // (peak to peak: how much the player slides about on screen), and the drawn
13
+ // horizontal speed (distance over the dt handed), on each frame that ran.
14
+ //
15
+ // The frames: a steady 60 Hz page; a 120 Hz display, every refresh a frame
16
+ // uncapped and every second one capped at 60; and three slow-phone traces like
17
+ // the TECNO KJ5's (frames 25-55 ms, mean about 32, with a hitch of 60-80 ms
18
+ // now and then), each made from its own seed.
19
+ //
20
+ // What it shows (the kit's CLAUDE.md, maxFps, has the account): without the
21
+ // cap, a dt clamp of 0.033 s turns every slow-phone frame longer than 33 ms
22
+ // into the same dt, two physics steps less 0.3 ms, so the accumulator's carry
23
+ // barely moves from frame to frame. Under the cap each frame is handed what it
24
+ // took, 25 to 50 ms, and the carry jumps about anywhere in [0, 1/60) every
25
+ // frame. The keyless hover and fall-faster pull are impulses scaled by the
26
+ // frame's dt while gravity acts per fixed step, so each frame the player gains
27
+ // g x (dt - steps / 60), which is g x (the change in the carry): the vertical
28
+ // velocity follows the carry, and the drawn height bobs with it. The
29
+ // `"reverted"` rows play the Player as the reverted cap had it (the loop
30
+ // capped, the Player not told) and must bob at least 1.5 times as much as
31
+ // uncapped on the slow-phone traces (2.5 times on whole 60 Hz refreshes); the capped rows (the Player told, so the
32
+ // hover and pull are forces per step, as under the camera key) must bob no
33
+ // more than uncapped on every trace, nor slide about on screen more (the
34
+ // keyless follow camera is placed at the end of a capped frame and eased
35
+ // exactly, Player.jsx `placeCapped`), stand at the camera key's height, and
36
+ // jump as high as under it, to within a centimetre.
37
+ //
38
+ // With the key absent nothing here differs from main: `scene.maxFps` is 0 and
39
+ // the Player takes the code it always did (test-steady-hover.mjs holds that
40
+ // path to main's calls, call for call).
41
+ //
42
+ // Where `@dimforge/rapier3d-compat` is installed (this kit's node_modules or
43
+ // above, or `CASTLE_RAPIER=<path to rapier.mjs>`) everything is run again on
44
+ // rapier itself, with the orbit camera too; otherwise on a stand-in only.
45
+ // test-static-actors.mjs runs it (`npm run check`).
46
+ // node scripts/test-frame-cap-bob.mjs [--table]
47
+ import assert from 'node:assert/strict';
48
+ import { existsSync } from 'node:fs';
49
+ import { register } from 'node:module';
50
+ import { dirname, join, resolve as resolvePath } from 'node:path';
51
+ import { fileURLToPath, pathToFileURL } from 'node:url';
52
+ import { PerspectiveCamera } from 'three';
53
+ import { makeFrameClock, nextFrame } from '../engine3d/framecap.js';
54
+
55
+ // A stand-in rapier, as test-steady-hover.mjs has it: a step pushes the frame's
56
+ // impulses first, then gravity and forces spread over four sub-steps; flat
57
+ // ground at y 0 under a 1.4 m capsule.
58
+ const fakeRapier = `
59
+ const SUBSTEPS = 4;
60
+ export const init = async () => {};
61
+ export const RigidBodyType = { Dynamic: 0, Fixed: 1, KinematicPositionBased: 2, KinematicVelocityBased: 3 };
62
+ export const ActiveEvents = { COLLISION_EVENTS: 1 };
63
+ export const QueryFilterFlags = { EXCLUDE_SENSORS: 1 };
64
+ class Desc {
65
+ constructor(type) { this.type = type; this.at = { x: 0, y: 0, z: 0 }; this.gravityScale = 1; }
66
+ setTranslation(x, y, z) { this.at = { x, y, z }; return this; }
67
+ setRotation() { return this; }
68
+ setGravityScale(scale) { this.gravityScale = scale; return this; }
69
+ lockRotations() { return this; }
70
+ }
71
+ export const RigidBodyDesc = { dynamic: () => new Desc(0), fixed: () => new Desc(1), kinematicPositionBased: () => new Desc(2) };
72
+ const collider = () => { const d = { setFriction: () => d, setRestitution: () => d, setSensor: () => d, setActiveEvents: () => d }; return d; };
73
+ export const ColliderDesc = { ball: collider, capsule: collider, cylinder: collider, cuboid: collider };
74
+ export class Ray { constructor(origin, dir) { this.origin = origin; this.dir = dir; } }
75
+ export class EventQueue { drainCollisionEvents() {} free() {} }
76
+ class Body {
77
+ constructor(desc) { this.type = desc.type; this.pos = { ...desc.at }; this.vel = { x: 0, y: 0, z: 0 }; this.force = { x: 0, y: 0, z: 0 }; this.gravityScale = desc.gravityScale; }
78
+ bodyType() { return this.type; }
79
+ isDynamic() { return this.type === 0; }
80
+ mass() { return 1.5; }
81
+ translation() { return { ...this.pos }; }
82
+ rotation() { return { x: 0, y: 0, z: 0, w: 1 }; }
83
+ linvel() { return { ...this.vel }; }
84
+ setLinvel(v) { this.vel = { x: v.x, y: v.y, z: v.z }; }
85
+ setTranslation(p) { this.pos = { x: p.x, y: p.y, z: p.z }; }
86
+ setRotation() {}
87
+ setNextKinematicTranslation(p) { this.pos = { x: p.x, y: p.y, z: p.z }; }
88
+ setNextKinematicRotation() {}
89
+ applyImpulse(j) { for (const k of ['x', 'y', 'z']) this.vel[k] += j[k] / this.mass(); }
90
+ addForce(f) { for (const k of ['x', 'y', 'z']) this.force[k] += f[k]; }
91
+ resetForces() { this.force = { x: 0, y: 0, z: 0 }; }
92
+ }
93
+ export class World {
94
+ constructor(gravity) { this.gravity = gravity; this.bodies = new Set(); this.timestep = 1 / 60; this.handles = 0; }
95
+ createRigidBody(desc) { const body = new Body(desc); this.bodies.add(body); return body; }
96
+ createCollider() { return { handle: (this.handles += 1) }; }
97
+ removeRigidBody(body) { this.bodies.delete(body); }
98
+ castRay(ray, max) { const d = ray.origin.y; return d >= 0 && d <= max ? { timeOfImpact: d, collider: { handle: -1 } } : null; }
99
+ step() {
100
+ const h = this.timestep / SUBSTEPS;
101
+ for (const body of this.bodies) {
102
+ if (body.type !== 0) continue;
103
+ for (let i = 0; i < SUBSTEPS; i += 1) {
104
+ for (const k of ['x', 'y', 'z']) {
105
+ body.vel[k] += (this.gravity[k] * body.gravityScale + body.force[k] / body.mass()) * h;
106
+ body.pos[k] += body.vel[k] * h;
107
+ }
108
+ if (body.pos.y < 0.7) { body.pos.y = 0.7; body.vel.y = Math.max(0, body.vel.y); }
109
+ }
110
+ }
111
+ }
112
+ free() {}
113
+ }
114
+ `;
115
+
116
+ // The nearest installed rapier: CASTLE_RAPIER, else from this kit upwards.
117
+ function findRapier() {
118
+ if (process.env.CASTLE_RAPIER) return pathToFileURL(resolvePath(process.env.CASTLE_RAPIER)).href;
119
+ let dir = dirname(dirname(fileURLToPath(import.meta.url)));
120
+ for (;;) {
121
+ const file = join(dir, 'node_modules', '@dimforge', 'rapier3d-compat', 'rapier.mjs');
122
+ if (existsSync(file)) return pathToFileURL(file).href;
123
+ const up = dirname(dir);
124
+ if (up === dir) return null;
125
+ dir = up;
126
+ }
127
+ }
128
+ const realRapier = findRapier();
129
+
130
+ const hooks = `
131
+ import { existsSync, readFileSync } from 'node:fs';
132
+ import { fileURLToPath } from 'node:url';
133
+ const fake = 'data:text/javascript,' + encodeURIComponent(${JSON.stringify(fakeRapier)});
134
+ const real = ${JSON.stringify(realRapier)};
135
+ export async function resolve(specifier, context, next) {
136
+ const parent = context.parentURL ?? '';
137
+ if (specifier === '@dimforge/rapier3d-compat' && parent.endsWith('?bob-fake')) return { url: fake, shortCircuit: true };
138
+ if (specifier === '@dimforge/rapier3d-compat' && parent.endsWith('?bob-real')) return { url: real, shortCircuit: true };
139
+ if (/\\?bob-(fake|real)$/.test(specifier)) return { url: new URL(specifier, parent).href, shortCircuit: true };
140
+ if (specifier.startsWith('@imports/castle.physics-2d/')) {
141
+ specifier = parent.replace(/\\/kits\\/.*/, '/kits/physics-2d/') + specifier.slice(27);
142
+ }
143
+ if ((specifier.startsWith('.') || specifier.startsWith('file:')) && parent.includes('/kits/') && !/\\.(m?js|jsx|json)(\\?.*)?$/.test(specifier)) {
144
+ const base = new URL(specifier, parent).href;
145
+ for (const ext of ['.js', '.jsx']) if (existsSync(fileURLToPath(base + ext))) return next(base + ext, context);
146
+ }
147
+ return next(specifier, context);
148
+ }
149
+ export async function load(url, context, next) {
150
+ if (url.endsWith('/behaviors/Player.jsx')) {
151
+ return { format: 'module', source: readFileSync(fileURLToPath(url), 'utf8'), shortCircuit: true };
152
+ }
153
+ return next(url, context);
154
+ }`;
155
+ register(`data:text/javascript,${encodeURIComponent(hooks)}`);
156
+ const { Player } = await import('../behaviors/Player.jsx');
157
+
158
+ //
159
+ // Frames
160
+ //
161
+
162
+ const FIXED = 1 / 60;
163
+
164
+ // A small deterministic generator (mulberry32).
165
+ function generator(seed) {
166
+ let s = seed | 0;
167
+ return () => {
168
+ s = (s + 0x6d2b79f5) | 0;
169
+ let t = Math.imul(s ^ (s >>> 15), 1 | s);
170
+ t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
171
+ return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
172
+ };
173
+ }
174
+
175
+ // requestAnimationFrame timestamps (ms), `seconds` long, from `start`.
176
+ function stamps(kind, seconds, start = 1000) {
177
+ const out = [];
178
+ let now = start;
179
+ const end = start + seconds * 1000;
180
+ if (kind === 'steady60' || kind === '120Hz') {
181
+ const period = 1000 / (kind === '120Hz' ? 120 : 60);
182
+ for (let i = 1; now < end; i += 1) out.push((now = start + i * period));
183
+ return out;
184
+ }
185
+ // A slow phone whose frames land on its display's vsync (90 or 60 Hz): a
186
+ // whole number of refreshes each, mostly three (90 Hz) or two (60 Hz).
187
+ if (kind === 'tecno90' || kind === 'tecno60') {
188
+ const random = generator(kind === 'tecno90' ? 90 : 60);
189
+ const period = kind === 'tecno90' ? 1000 / 90 : 1000 / 60;
190
+ const counts = kind === 'tecno90' ? [[0.3, 2], [0.85, 3], [0.97, 4], [1, 6]] : [[0.1, 1], [0.8, 2], [0.98, 3], [1, 4]];
191
+ for (let i = 0; now < end; ) {
192
+ const r = random();
193
+ i += counts.find(([p]) => r < p)[1];
194
+ out.push((now = start + i * period));
195
+ }
196
+ return out;
197
+ }
198
+ // A slow phone: most frames 25-35 ms, one in eight 35-55 ms, one in fifty a
199
+ // hitch of 60-80 ms. Mean about 32 ms.
200
+ const random = generator({ tecnoA: 1, tecnoB: 2, tecnoC: 3 }[kind] * 7919);
201
+ while (now < end) {
202
+ const r = random();
203
+ const gap = r < 0.02 ? 60 + 20 * random() : r < 0.145 ? 35 + 20 * random() : 25 + 10 * random();
204
+ out.push((now += gap));
205
+ }
206
+ return out;
207
+ }
208
+ const TRACES = ['steady60', '120Hz', 'tecnoA', 'tecnoB', 'tecnoC', 'tecno90', 'tecno60'];
209
+ const SLOW = ['tecnoA', 'tecnoB', 'tecnoC', 'tecno90', 'tecno60'];
210
+
211
+ //
212
+ // A world of one player on flat ground
213
+ //
214
+
215
+ const newPlayer = () => ({
216
+ id: 'player',
217
+ components: {
218
+ Transform: { x: 0, y: 1, z: 0, rotationX: 0, rotationY: 0, rotationZ: 0, scaleX: 1, scaleY: 1, scaleZ: 1 },
219
+ Shape: { kind: 'capsule', radius: 0.35, height: 1.4 },
220
+ Body: { type: 'dynamic', lockRotations: true, friction: 0, gravityScale: 2 },
221
+ Solid: {},
222
+ Player: { ...Player.defaultProps },
223
+ },
224
+ runtime: {},
225
+ });
226
+
227
+ // `camera` is 'none' (no camera key), 'rigid' or 'orbit'. `told` is the cap
228
+ // the Player reads (`scene.maxFps`); the loop's own cap is the run's.
229
+ async function makeWorld(Physics3DSystem, camera, told) {
230
+ const system = new Physics3DSystem();
231
+ const cam = new PerspectiveCamera(70, 20 / 9, 0.1, 500);
232
+ const scene = {
233
+ time: 0,
234
+ keys: new Set(),
235
+ moveInput: null,
236
+ persistent: {},
237
+ three: { camera: cam },
238
+ cameraFollowsRigidly: camera !== 'none',
239
+ cameraControl: camera === 'orbit' ? 'orbit' : null,
240
+ maxFps: told,
241
+ skipsUnchangedActors: false,
242
+ data: {},
243
+ actors: [newPlayer()],
244
+ actorsWith: () => [],
245
+ getActors: () => scene.actors,
246
+ getActor: (id) => scene.actors.find((a) => a.id === id),
247
+ forEachBehavior: () => {},
248
+ };
249
+ system.attach(scene);
250
+ const player = new Player(scene.actors[0].components.Player);
251
+ const frame = (dt, keys) => {
252
+ scene.time += dt;
253
+ scene.keys = new Set(keys);
254
+ player.update(scene.actors[0], scene, dt);
255
+ system.afterBehaviors(scene, dt);
256
+ };
257
+ for (let i = 0; i < 200 && !scene.physics3d.ready(); i += 1) {
258
+ await new Promise((resolve) => setTimeout(resolve, 5));
259
+ frame(FIXED, []);
260
+ }
261
+ assert.ok(scene.physics3d.ready(), 'physics is ready');
262
+ return { system, scene, cam, frame, t: () => scene.actors[0].components.Transform };
263
+ }
264
+
265
+ const spread = (values) => Math.max(...values) - Math.min(...values);
266
+ const rms = (values) => {
267
+ const mean = values.reduce((a, b) => a + b, 0) / values.length;
268
+ return Math.sqrt(values.reduce((a, b) => a + (b - mean) ** 2, 0) / values.length);
269
+ };
270
+ const mean = (values) => values.reduce((a, b) => a + b, 0) / values.length;
271
+
272
+ // Stand for 3 s, then walk forward for 12 s on `trace`'s frames, the loop
273
+ // capped at `cap` (0 for none) and the Player told `told`. Measured from 2 s
274
+ // into the walk, on every frame that ran.
275
+ async function walk(Physics3DSystem, camera, trace, cap, told) {
276
+ const world = await makeWorld(Physics3DSystem, camera, told);
277
+ const times = stamps(trace, 15);
278
+ const clock = makeFrameClock(1000);
279
+ const drawn = [];
280
+ const camY = [];
281
+ const camDist = [];
282
+ const speed = [];
283
+ const dts = [];
284
+ let rest = null;
285
+ let last = null;
286
+ for (const now of times) {
287
+ const dt = nextFrame(clock, now, cap);
288
+ if (dt === null) continue;
289
+ const walking = now >= 4000;
290
+ if (walking && rest === null) rest = world.t().y;
291
+ world.frame(dt, walking ? ['KeyW'] : []);
292
+ const t = world.t();
293
+ if (now >= 6000) {
294
+ const c = world.cam.position;
295
+ drawn.push(t.y);
296
+ camY.push(c.y);
297
+ // The camera to the player as the frame draws them: a steady walk
298
+ // keeps one distance when the player holds one place on screen.
299
+ camDist.push(Math.hypot(c.x - t.x, c.y - t.y, c.z - t.z));
300
+ dts.push(dt);
301
+ if (last) speed.push(Math.hypot(t.x - last.x, t.z - last.z) / dt);
302
+ }
303
+ last = { x: t.x, z: t.z };
304
+ }
305
+ const v = mean(speed);
306
+ return {
307
+ pp: spread(drawn),
308
+ rms: rms(drawn),
309
+ camPP: spread(camY),
310
+ distPP: spread(camDist),
311
+ rest,
312
+ walkY: mean(drawn),
313
+ speed: v,
314
+ jitter: rms(speed) / v,
315
+ frames: dts.length,
316
+ meanDt: mean(dts),
317
+ };
318
+ }
319
+
320
+ // The highest the drawn player gets from one jump, 1 s into a walk.
321
+ async function jumpApex(Physics3DSystem, camera, trace, cap, told) {
322
+ const world = await makeWorld(Physics3DSystem, camera, told);
323
+ const clock = makeFrameClock(1000);
324
+ let jumped = false;
325
+ let apex = -Infinity;
326
+ for (const now of stamps(trace, 7)) {
327
+ const dt = nextFrame(clock, now, cap);
328
+ if (dt === null) continue;
329
+ const jump = !jumped && now >= 5000;
330
+ jumped ||= jump;
331
+ world.frame(dt, now >= 4000 ? (jump ? ['KeyW', 'Space'] : ['KeyW']) : []);
332
+ if (jumped) apex = Math.max(apex, world.t().y);
333
+ }
334
+ return apex;
335
+ }
336
+
337
+ // The configurations: uncapped (the key absent), capped as the reverted cap
338
+ // had it (the Player not told), and capped as it is now.
339
+ const RUNS = [
340
+ { name: 'uncapped', cap: 0, told: 0 },
341
+ { name: 'reverted', cap: 60, told: 0 },
342
+ { name: 'capped', cap: 60, told: 60 },
343
+ ];
344
+
345
+ async function runOn(Physics3DSystem, label, cameras) {
346
+ const rows = [];
347
+ for (const camera of cameras) {
348
+ for (const trace of TRACES) {
349
+ const row = { label, camera, trace };
350
+ for (const run of RUNS) row[run.name] = await walk(Physics3DSystem, camera, trace, run.cap, run.told);
351
+ rows.push(row);
352
+ }
353
+ }
354
+ // A capped jump goes as high as one under the camera key, uncapped.
355
+ const jumps = [];
356
+ for (const trace of ['steady60', '120Hz', 'tecnoA', 'tecno60']) {
357
+ jumps.push({ label, trace, capped: await jumpApex(Physics3DSystem, 'none', trace, 60, 60), keyed: await jumpApex(Physics3DSystem, 'rigid', trace, 0, 0) });
358
+ }
359
+ return { rows, jumps };
360
+ }
361
+
362
+ // What must hold of every row; the number of checks.
363
+ function judge(rows) {
364
+ let checks = 0;
365
+ const keyed = rows.filter((row) => row.camera === 'rigid');
366
+ for (const row of rows) {
367
+ const where = `${row.label} ${row.camera} ${row.trace}`;
368
+ const { uncapped, reverted, capped } = row;
369
+ // Walking at speed throughout (the player did walk).
370
+ for (const run of RUNS) assert.ok(Math.abs(row[run.name].speed - Player.defaultProps.speed) < 0.05, `${where} ${run.name}: walks at its speed (${row[run.name].speed})`);
371
+ // The fix: capped bobs no more than uncapped, on every trace (a tenth of
372
+ // a millimetre of slack for rounding), and the horizontal speed is no
373
+ // less steady.
374
+ assert.ok(capped.pp <= uncapped.pp + 1e-4, `${where}: capped bob ${capped.pp} m against ${uncapped.pp} m uncapped`);
375
+ assert.ok(capped.rms <= uncapped.rms + 1e-4, `${where}: capped rms ${capped.rms} m against ${uncapped.rms} m uncapped`);
376
+ assert.ok(capped.jitter <= uncapped.jitter + 1e-3, `${where}: capped speed jitter ${capped.jitter} against ${uncapped.jitter}`);
377
+ // And the camera holds the player as steady on screen: its height and
378
+ // its distance from the player as drawn move no more than uncapped.
379
+ assert.ok(capped.camPP <= uncapped.camPP + 1e-4, `${where}: capped camera height ${capped.camPP} m against ${uncapped.camPP} m uncapped`);
380
+ assert.ok(capped.distPP <= uncapped.distPP + 1e-4, `${where}: capped camera distance ${capped.distPP} m against ${uncapped.distPP} m uncapped`);
381
+ // The capped player walks within 1 mm of the camera key's height (the
382
+ // steady hover's), whatever the frames.
383
+ const steady = keyed.find((k) => k.label === row.label && k.trace === row.trace).uncapped;
384
+ assert.ok(Math.abs(capped.walkY - steady.walkY) < 1e-3, `${where}: capped walks at ${capped.walkY}, the camera key's height ${steady.walkY}`);
385
+ checks += 7;
386
+ // The reproduction: without the camera key, the reverted cap bobs half
387
+ // as much again as uncapped on a slow phone, and over two and a half
388
+ // times as much where its frames are whole 60 Hz refreshes (the uncapped
389
+ // clamp makes nearly every one of those the same dt).
390
+ if (row.camera === 'none' && SLOW.includes(row.trace)) {
391
+ const more = row.trace === 'tecno60' ? 2.5 : 1.5;
392
+ assert.ok(reverted.pp > more * uncapped.pp, `${where}: the reverted cap bobs ${reverted.pp} m against ${uncapped.pp} m uncapped`);
393
+ checks += 1;
394
+ }
395
+ }
396
+ return checks;
397
+ }
398
+
399
+ export async function run({ table = false } = {}) {
400
+ const results = [];
401
+ const fake = await import('../systems/physics3d.js?bob-fake');
402
+ results.push(['stand-in', await runOn(fake.Physics3DSystem, 'stand-in rapier', ['none', 'rigid'])]);
403
+ if (realRapier) {
404
+ const real = await import('../systems/physics3d.js?bob-real');
405
+ results.push(['rapier', await runOn(real.Physics3DSystem, 'rapier', ['none', 'rigid', 'orbit'])]);
406
+ }
407
+ if (table) {
408
+ const mm = (v) => (v * 1000).toFixed(2).padStart(6);
409
+ const pct = (v) => (v * 100).toFixed(2).padStart(5);
410
+ for (const [name, { rows }] of results) {
411
+ console.log(`${name}: walking; drawn height p-p / rms, camera height p-p and camera-to-player distance p-p in mm, speed jitter in %, walking height in m`);
412
+ console.log(' camera trace | uncapped: pp rms camPP camDist jit height | reverted: pp rms camPP camDist jit height | capped: pp rms camPP camDist jit height | frames dt(ms) unc/cap');
413
+ for (const row of rows) {
414
+ const cell = (r) => `${mm(r.pp)} ${mm(r.rms)} ${mm(r.camPP)} ${mm(r.distPP)} ${pct(r.jitter)} ${r.walkY.toFixed(4)}`;
415
+ console.log(
416
+ ` ${row.camera.padEnd(6)} ${row.trace.padEnd(9)} | ${cell(row.uncapped)} | ${cell(row.reverted)} | ${cell(row.capped)} | ${(row.uncapped.meanDt * 1000).toFixed(1)}/${(row.capped.meanDt * 1000).toFixed(1)}`
417
+ );
418
+ }
419
+ }
420
+ }
421
+ let checks = judge(results.flatMap(([, result]) => result.rows));
422
+ for (const { label, trace, capped, keyed } of results.flatMap(([, result]) => result.jumps)) {
423
+ if (table) console.log(`${label} ${trace}: jump apex ${capped.toFixed(4)} m capped, ${keyed.toFixed(4)} m under the camera key uncapped`);
424
+ assert.ok(capped > 2 && Math.abs(capped - keyed) < 0.01, `${label} ${trace}: a capped jump reaches ${capped} m, ${keyed} m under the camera key`);
425
+ checks += 1;
426
+ }
427
+ return { checks, real: Boolean(realRapier) };
428
+ }
429
+
430
+ export const summary = ({ checks, real }) =>
431
+ `${checks} frame-cap bob checks (${real ? 'on a stand-in rapier and on rapier itself' : 'on a stand-in rapier; rapier itself is not installed here, so that half was skipped'})`;
432
+
433
+ if (import.meta.url === `file://${process.argv[1]}`) {
434
+ console.log(summary(await run({ table: process.argv.includes('--table') })));
435
+ }