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,387 @@
1
+ // Fast, renderer-free gait proof. Copy this SAME script to origin/main to
2
+ // compare fixed traces: node kits/physics-3d/scripts/test-gait.mjs --trace kits/physics-3d/scripts/out/gait-fixed.jsonl
3
+ // It tolerates the new gait modules being absent in that checkout.
4
+ import assert from 'node:assert/strict';
5
+ import fs from 'node:fs';
6
+ import path from 'node:path';
7
+ import { register } from 'node:module';
8
+ import { fileURLToPath } from 'node:url';
9
+ import * as THREE from 'three';
10
+
11
+ // Same bundler-import resolver as the kit's Node render/engine probes, without
12
+ // importing a test suite (filmstrip.js itself is a browser render module).
13
+ register(`data:text/javascript,${encodeURIComponent(`
14
+ import { existsSync } from 'node:fs';
15
+ import { fileURLToPath } from 'node:url';
16
+ export async function resolve(specifier, context, next) {
17
+ const parent = context.parentURL ?? '';
18
+ if (specifier.startsWith('@imports/castle.physics-2d/')) {
19
+ specifier = parent.replace(/\\/kits\\/.*/, '/kits/physics-2d/') + specifier.slice(27);
20
+ }
21
+ if ((specifier.startsWith('.') || specifier.startsWith('file:')) && parent.includes('/kits/') && !/\\.(m?js|jsx|json)$/.test(specifier)) {
22
+ const base = new URL(specifier, parent).href;
23
+ for (const ext of ['.js', '.jsx']) if (existsSync(fileURLToPath(base + ext))) return next(base + ext, context);
24
+ }
25
+ return next(specifier, context);
26
+ }
27
+ `)}`);
28
+
29
+ const { buildModelNode, parseModel, animateModelParts } = await import('../engine3d/pxmodel.js');
30
+ const { animateMotion } = await import('../engine3d/motion.js');
31
+ const { setLookEnabled } = await import('../engine3d/look.js');
32
+ const gaitUrl = new URL('../engine3d/gait.js', import.meta.url);
33
+ const gait = fs.existsSync(gaitUrl) ? await import(gaitUrl) : null;
34
+ const DT = 1 / 60;
35
+ const fixedTrace = [];
36
+ // Geometry is identical with the expensive lighting bake disabled; walk poses
37
+ // do not depend on lighting. Keep this setting in the origin/main comparison.
38
+ setLookEnabled(false);
39
+
40
+ function build(url, options = {}) {
41
+ const model = parseModel(fs.readFileSync(url, 'utf8'));
42
+ if (options.height) model.height = options.height;
43
+ const rig = buildModelNode(model, {}, {}, '', [], { optimize: true });
44
+ if (options.rigScale) rig.scale.setScalar(options.rigScale);
45
+ rig.position.y = options.yOffset ?? 0;
46
+ const node = new THREE.Group();
47
+ node.add(rig);
48
+ node.userData.modelParts = rig.userData.modelParts;
49
+ node.updateMatrixWorld(true);
50
+ return { node };
51
+ }
52
+
53
+ function frame(entry, dt, hint, timeHint) {
54
+ if (hint !== undefined) {
55
+ entry.node.userData.walkSpeedHint = hint;
56
+ entry.node.userData.walkHintAt = performance.now();
57
+ }
58
+ if (timeHint !== undefined) entry.node.userData.walkTimeHint = timeHint;
59
+ animateModelParts(entry, dt);
60
+ animateMotion(entry, dt, { id: 'gait-proof', runtime: {} });
61
+ }
62
+
63
+ const models = [
64
+ ['player', new URL('../models/player.pxmodel', import.meta.url), 'legL', 0.8],
65
+ ['quadruped', new URL('../models/templates/quadruped.pxmodel', import.meta.url), 'legFL', 0.6],
66
+ ['avatar-0', new URL('../../hub-game/models/avatar-0.pxmodel', import.meta.url), 'legL', 0.8],
67
+ ];
68
+ // The hub blueprint draws avatar-0 at its authored pxmodel height, with no
69
+ // extra scale unless its Model component asks for one. buildModelNode applies
70
+ // the pxmodel's own height, if present; do not resize it to collider height.
71
+ const hubBlueprint = new URL('../../hub-game/blueprints/avatar-0.scene', import.meta.url);
72
+ const hubModel = fs.existsSync(hubBlueprint)
73
+ ? JSON.parse(fs.readFileSync(hubBlueprint, 'utf8')).actors[0].components.Model : {};
74
+ const cases = [...models.map((model) => [...model, 4, {}]),
75
+ ['avatar-0-hub6', models[2][1], 'legL', 0.8, 6,
76
+ { rigScale: hubModel.scale ?? 1, yOffset: hubModel.yOffset ?? 0 }]];
77
+ const diagnostics = [];
78
+ for (const [name, url, leg, amplitude, speed, options] of cases) {
79
+ if (!fs.existsSync(url)) continue;
80
+ for (const mode of gait ? ['fixed', 'model'] : ['fixed']) {
81
+ gait?.setWalkGait(mode);
82
+ const entry = build(url, options);
83
+ const height = new THREE.Box3().setFromObject(entry.node).getSize(new THREE.Vector3()).y;
84
+ for (let n = 0; n < 180; n += 1) {
85
+ entry.node.position.z += speed * DT;
86
+ frame(entry, DT);
87
+ const part = entry.node.userData.modelParts.get(leg);
88
+ const pose = { model: name, frame: n, rotationX: part.rotation.x,
89
+ legFL: leg === 'legFL' ? [...part.position.toArray(), ...part.rotation.toArray(), ...part.scale.toArray()] : null,
90
+ // Every part's full local pose, so the trace covers arms, torso bob and lean too.
91
+ parts: [...entry.node.userData.modelParts].map(([id, object]) =>
92
+ [id, ...object.position.toArray(), ...object.rotation.toArray(), ...object.scale.toArray()]) };
93
+ if (mode === 'fixed') fixedTrace.push(JSON.stringify(pose));
94
+ console.log(JSON.stringify({ mode, ...pose }));
95
+ }
96
+ const state = leg === 'legFL' ? entry.motionState.walk : entry.modelAnim;
97
+ const measured = mode === 'model' ? state.gait : null;
98
+ // Fixed mode has no cache; use the measurement from a separate model-mode
99
+ // entry for diagnostics, leaving the fixed trace untouched.
100
+ let reference = measured;
101
+ if (!reference && gait) {
102
+ gait.setWalkGait('model');
103
+ const probe = build(url, options);
104
+ frame(probe, DT);
105
+ frame(probe, DT);
106
+ reference = (leg === 'legFL' ? probe.motionState.walk : probe.modelAnim).gait;
107
+ gait.setWalkGait(mode);
108
+ }
109
+ const k = measured?.k ?? 2.4;
110
+ const walkSpeed = measured?.walkSpeed ?? 5;
111
+ const cap = measured?.cap ?? 8;
112
+ const cadence = measured?.cadence ?? Math.min(speed, 8) * 2.4 / (2 * Math.PI);
113
+ const A = amplitude * (mode === 'model' ? state.amplitudeScale ?? 1 : 1);
114
+ const amount = state.amount ?? state.swing;
115
+ const L = reference?.length ?? null;
116
+ // Sinusoidal legs have varying foot speed. Report instantaneous mid-stance
117
+ // and cycle-average estimates separately; slip ratio 0 means no average
118
+ // shortfall, foot-speed ratio 1 means cadence covers the ground distance.
119
+ const footSpeed = L === null ? null : L * A * amount * 2 * Math.PI * cadence;
120
+ const cycleFootSpeed = L === null ? null : 4 * L * Math.sin(A * amount) * cadence;
121
+ const result = { model: name, mode, H: height, L, k, walkSpeed, cap, groundSpeed: speed,
122
+ cadence, A, targetA: measured?.amplitude ?? amplitude,
123
+ midStanceFootSpeed: footSpeed, midStanceSlip: footSpeed === null ? null : speed - footSpeed,
124
+ cycleFootSpeed, footSpeedRatio: cycleFootSpeed === null ? null : cycleFootSpeed / speed,
125
+ footSlipRatio: cycleFootSpeed === null ? null : Math.abs(speed - cycleFootSpeed) / speed };
126
+ diagnostics.push(result);
127
+ console.log('summary', JSON.stringify(result));
128
+
129
+ if (mode === 'model') {
130
+ // Hints override a stopped node, are consumed by both passes, and do not
131
+ // survive a missing write. A 30 s/3 min resume cannot jump whole cycles.
132
+ const beforeAmplitude = state.amplitudeScale ?? 1;
133
+ frame(entry, DT, 30, DT);
134
+ assert.ok(Math.abs(state.amplitudeScale - beforeAmplitude) <= (0.3 / amplitude) / 6 + 1e-12);
135
+ assert.ok(state.gait.cadence <= 6);
136
+ assert.equal(state.gait.cap, 30);
137
+ assert.ok(!Object.hasOwn(entry.node.userData, 'walkSpeedHint'));
138
+ assert.ok(!Object.hasOwn(entry.node.userData, 'walkTimeHint'));
139
+ assert.ok(!Object.hasOwn(entry.node.userData, 'walkHintAt'));
140
+ assert.ok(!Object.hasOwn(entry, 'walkFrameHint'));
141
+ for (const pause of [30, 180, 0, -1, Infinity]) {
142
+ const phase = state.phase;
143
+ frame(entry, pause, 1e100);
144
+ assert.ok(Number.isFinite(state.phase));
145
+ assert.ok(state.phase - phase <= 2 * Math.PI * 6 * 0.1 + 1e-7);
146
+ assert.ok(Number.isFinite(entry.node.userData.modelParts.get(leg).rotation.x));
147
+ }
148
+ const phase = state.phase;
149
+ frame(entry, DT); // stopped, no stale network hint
150
+ assert.equal(state.phase, phase);
151
+ frame(entry, DT, 0.04, DT);
152
+ assert.equal(state.phase, phase); // finite low-speed cadence limit is suppressed
153
+ const oldL = state.gait.length;
154
+ entry.node.scale.setScalar(2);
155
+ frame(entry, DT);
156
+ assert.ok(Math.abs(state.gait.length - 2 * oldL) < 1e-6);
157
+ }
158
+ }
159
+ }
160
+
161
+ if (gait) {
162
+ gait.setWalkGait('model');
163
+ // Freshness uses a supplied clock here so boundary checks are deterministic.
164
+ for (const [at, now, accepted] of [[1000, 1000, true], [1000, 1100, true],
165
+ [1000, 1101, false], [1000, 1500, false], [1001, 1000, false],
166
+ [undefined, 1000, false], [NaN, 1000, false], [1000, NaN, false]]) {
167
+ const node = new THREE.Group();
168
+ Object.assign(node.userData, { walkSpeedHint: 4, walkTimeHint: DT, walkHintAt: at });
169
+ const hint = gait.takeWalkSpeedHint(node, now);
170
+ assert.deepEqual(hint, accepted ? { speed: 4, time: DT } : undefined);
171
+ for (const key of ['walkSpeedHint', 'walkTimeHint', 'walkHintAt']) assert.ok(!Object.hasOwn(node.userData, key));
172
+ }
173
+ for (const [name, url, leg] of models.slice(0, 2)) {
174
+ const entry = build(url);
175
+ for (let n = 0; n < 180; n += 1) frame(entry, DT, 4);
176
+ const state = leg === 'legFL' ? entry.motionState.walk : entry.modelAnim;
177
+ const phase = state.phase;
178
+ Object.assign(entry.node.userData, { walkSpeedHint: 4, walkTimeHint: 0.25, walkHintAt: performance.now() - 500 });
179
+ frame(entry, DT); // parked node has no observed motion; stale hint must not walk
180
+ assert.equal(state.phase, phase);
181
+ assert.equal(state.gait.cadence, 0);
182
+ for (const key of ['walkSpeedHint', 'walkTimeHint', 'walkHintAt']) assert.ok(!Object.hasOwn(entry.node.userData, key));
183
+ assert.ok(!Object.hasOwn(entry, 'walkFrameHint'));
184
+ console.log('stale-hint', JSON.stringify({ model: name, ageMs: 500, cadence: state.gait.cadence, removed: true }));
185
+ }
186
+ const scaled = build(models[0][1], { height: 3, rigScale: 1.5 });
187
+ scaled.node.scale.setScalar(2);
188
+ frame(scaled, DT);
189
+ const plain = build(models[0][1]);
190
+ frame(plain, DT);
191
+ const height = new THREE.Box3().setFromObject(plain.node).getSize(new THREE.Vector3()).y;
192
+ assert.ok(Math.abs(scaled.modelAnim.gait.length / plain.modelAnim.gait.length - 9 / height) < 1e-5);
193
+
194
+ // No visible height or leg geometry: fixed/model traces must match exactly,
195
+ // even with a network hint and a long frame. No new swing multiplier applies.
196
+ const emptyEntry = () => {
197
+ const node = new THREE.Group();
198
+ const rig = new THREE.Group();
199
+ const torso = new THREE.Group();
200
+ rig.add(torso);
201
+ node.add(rig);
202
+ node.userData.modelParts = new Map([['torso', torso]]);
203
+ return { node };
204
+ };
205
+ const fallbackTrace = (mode) => {
206
+ gait.setWalkGait(mode);
207
+ const entry = emptyEntry();
208
+ const trace = [];
209
+ for (const dt of [DT, DT, 0, DT, 30, DT, Infinity]) {
210
+ entry.node.position.z += 6 * dt;
211
+ frame(entry, dt, 20);
212
+ const { phase, swing, air, lean, last, lastYaw } = entry.modelAnim;
213
+ const torso = entry.node.userData.modelParts.get('torso');
214
+ trace.push({ phase, swing, air, lean, last, lastYaw,
215
+ position: torso.position.toArray(), rotation: torso.rotation.toArray() });
216
+ }
217
+ return trace;
218
+ };
219
+ assert.deepEqual(fallbackTrace('model'), fallbackTrace('fixed'));
220
+ gait.setWalkGait('model');
221
+
222
+ const hub = diagnostics.find((row) => row.model === 'avatar-0-hub6' && row.mode === 'model');
223
+ if (hub) {
224
+ assert.ok(hub.cadence > 4.5 && hub.cadence < 6);
225
+ assert.ok(Math.abs(hub.A - 1.1) < 1e-10);
226
+ assert.ok(hub.footSlipRatio < 1e-10);
227
+ }
228
+
229
+ // Slow walks must cover their distance too: cadence uses the TARGET swing
230
+ // amount, while the actual rendered swing/amplitude ease into steady state.
231
+ for (const index of [0, 2]) {
232
+ const [name, url, , baseAmplitude] = models[index];
233
+ for (const speed of [1, 2, 4, 6]) {
234
+ const entry = build(url, index === 2 ? { rigScale: hubModel.scale ?? 1, yOffset: hubModel.yOffset ?? 0 } : {});
235
+ for (let frameIndex = 0; frameIndex < 180; frameIndex += 1) {
236
+ entry.node.position.z += speed * DT;
237
+ frame(entry, DT);
238
+ }
239
+ const state = entry.modelAnim;
240
+ const A = baseAmplitude * (state.amplitudeScale ?? 1);
241
+ const effectiveAmplitude = A * state.swing;
242
+ const cadence = state.gait.cadence;
243
+ const cycleFootSpeed = 4 * state.gait.length * Math.sin(effectiveAmplitude) * cadence;
244
+ const footSpeedRatio = cycleFootSpeed / speed;
245
+ assert.ok(Math.abs(footSpeedRatio - 1) <= 0.05,
246
+ `${name} at ${speed} m/s: foot/ground ratio ${footSpeedRatio}`);
247
+ assert.ok(cadence <= 6);
248
+ const result = { test: 'steady', model: name, mode: 'model', groundSpeed: speed,
249
+ L: state.gait.length, cadence, A, effectiveAmplitude, cycleFootSpeed, footSpeedRatio };
250
+ diagnostics.push(result);
251
+ console.log('steady', JSON.stringify(result));
252
+ frame(entry, DT); // speed zero has zero cadence, despite finite slow-walk limit
253
+ assert.equal(state.gait.cadence, 0);
254
+ }
255
+ }
256
+
257
+ // Network poses follow real time even when the engine caps its own step.
258
+ // Exercise both animation passes and measure cadence from actual phase,
259
+ // rather than the requested cadence stored in the gait diagnostics.
260
+ for (const [name, url, leg, baseAmplitude] of models.slice(0, 2)) {
261
+ const realDt = 1 / 18;
262
+ const engineDt = 0.033;
263
+ const speed = 4;
264
+ const entry = build(url);
265
+ const capped = build(url);
266
+ for (let n = 0; n < 90; n += 1) {
267
+ entry.node.position.z += speed * realDt;
268
+ capped.node.position.z += speed * realDt;
269
+ frame(entry, engineDt, speed, realDt);
270
+ frame(capped, engineDt, speed);
271
+ }
272
+ const state = leg === 'legFL' ? entry.motionState.walk : entry.modelAnim;
273
+ const cappedState = leg === 'legFL' ? capped.motionState.walk : capped.modelAnim;
274
+ const before = state.phase;
275
+ const cappedBefore = cappedState.phase;
276
+ for (let n = 0; n < 90; n += 1) {
277
+ entry.node.position.z += speed * realDt;
278
+ capped.node.position.z += speed * realDt;
279
+ frame(entry, engineDt, speed, realDt);
280
+ frame(capped, engineDt, speed);
281
+ }
282
+ const cadence = (state.phase - before) / (2 * Math.PI * 90 * realDt);
283
+ const amount = state.amount ?? state.swing;
284
+ const effectiveAmplitude = baseAmplitude * state.amplitudeScale * amount;
285
+ const footSpeedRatio = 4 * state.gait.length * Math.sin(effectiveAmplitude) * cadence / speed;
286
+ assert.ok(Math.abs(footSpeedRatio - 1) <= 0.05, `${name} at 18 fps: foot/ground ratio ${footSpeedRatio}`);
287
+ assert.ok(Math.abs((cappedState.phase - cappedBefore) / (state.phase - before) - engineDt / realDt) < 1e-10);
288
+ assert.equal(state.amplitudeScale, cappedState.amplitudeScale);
289
+ assert.equal(amount, cappedState.amount ?? cappedState.swing);
290
+ assert.ok(!Object.hasOwn(entry.node.userData, 'walkSpeedHint'));
291
+ assert.ok(!Object.hasOwn(entry.node.userData, 'walkTimeHint'));
292
+ assert.ok(!Object.hasOwn(entry.node.userData, 'walkHintAt'));
293
+ const phase = state.phase;
294
+ frame(entry, engineDt); // both hints expired; stopped pose cannot retain real time
295
+ assert.equal(state.phase, phase);
296
+ const result = { test: 'hinted-18fps', model: name, groundSpeed: speed, engineDt, realDt, cadence, footSpeedRatio };
297
+ diagnostics.push(result);
298
+ console.log('hinted-18fps', JSON.stringify(result));
299
+ }
300
+
301
+ const networkUrl = new URL('../../multiplayer-3d/code/client/gait.js', import.meta.url);
302
+ if (fs.existsSync(networkUrl)) {
303
+ const { trackWalkSpeed, easeWalkSpeed, walkFrameTime } = await import(networkUrl);
304
+ const sample = (simMs, x, velocity) => ({ simMs, pose: [x, 0, 0, 0], velocity });
305
+ const track = { samples: [sample(0, 0), sample(250, 1), sample(500, 2), sample(750, 2.5)] };
306
+ assert.equal(trackWalkSpeed(track, -1), 0);
307
+ assert.equal(trackWalkSpeed(track, 750), 2); // full speed at newest
308
+ assert.equal(trackWalkSpeed(track, 850), 2 * 0.6); // 100 ms past newest: 60%
309
+ assert.equal(trackWalkSpeed(track, 1000), 0); // ramp ends at hold boundary
310
+ assert.equal(trackWalkSpeed(track, 1000 + 1e-6), 0);
311
+ assert.equal(trackWalkSpeed(track, 1150), 0); // 400 ms past newest
312
+ console.log('hold', JSON.stringify({ pastNewest100ms: trackWalkSpeed(track, 850), pastNewest400ms: trackWalkSpeed(track, 1150) }));
313
+ assert.equal(trackWalkSpeed(track, 375), 4);
314
+ assert.equal(trackWalkSpeed(track, 500 - 1e-6), 4);
315
+ assert.equal(trackWalkSpeed(track, 500 + 1e-6), 2);
316
+ const trimmed = { samples: track.samples.slice(1) };
317
+ assert.equal(trackWalkSpeed(trimmed, 250 + 1e-6), 4);
318
+ const turning = { samples: [sample(0, 0), sample(500, 2),
319
+ { simMs: 1000, pose: [2, 0, 0, Math.PI / 2] }] };
320
+ assert.equal(trackWalkSpeed(turning, 750), 0);
321
+ assert.equal(trackWalkSpeed({ samples: [sample(0, 0), sample(250, 10)] }, 125), 0);
322
+ assert.equal(trackWalkSpeed({ samples: [sample(0, 0), sample(0, 1)] }, 0), 0);
323
+ assert.equal(trackWalkSpeed({ samples: [sample(0, 0, [8, 0, 0]), sample(250, 1, [8, 0, 0]), sample(500, 2, [8, 0, 0])] }, 375), 8);
324
+ const seeded = (at = 375, source = track) => {
325
+ const speeds = new Map();
326
+ assert.equal(easeWalkSpeed(speeds, 'remote', source, at, 0.033, 1000), trackWalkSpeed(source, at));
327
+ assert.deepEqual(speeds.get('remote'), { speed: trackWalkSpeed(source, at), track: source, at, wall: 1000 });
328
+ return speeds;
329
+ };
330
+ // An ordinary stop eases; a real wall-clock pause must take zero outright
331
+ // even when the frame dt is capped and render time advanced less than 0.5 s.
332
+ const stopped = { samples: [...track.samples, sample(1000, 2.5)] };
333
+ const ordinary = seeded(375, stopped);
334
+ const eased = easeWalkSpeed(ordinary, 'remote', stopped, 751, 0.033, 1033);
335
+ assert.ok(Math.abs(eased - 4 * Math.exp(-0.033 / 0.1)) < 1e-12);
336
+ for (const gap of [30000, 180000]) {
337
+ const speeds = seeded(375, stopped);
338
+ const speed = easeWalkSpeed(speeds, 'remote', stopped, 751, 0.033, 1000 + gap);
339
+ assert.equal(speed, 0);
340
+ console.log('resume', JSON.stringify({ wallGapSeconds: gap / 1000, dt: 0.033, speed }));
341
+ }
342
+ assert.equal(easeWalkSpeed(seeded(), 'remote', track, 1500, 0.033, 1033), 0);
343
+ assert.equal(easeWalkSpeed(seeded(600), 'remote', track, 375, 0.033, 1033), 4);
344
+ const replacement = { samples: [sample(0, 2), sample(1000, 2)] };
345
+ assert.equal(easeWalkSpeed(seeded(), 'remote', replacement, 375, 0.033, 1033), 0);
346
+ for (const [name, url, leg] of models.slice(0, 2)) {
347
+ const entry = build(url);
348
+ for (let n = 0; n < 180; n += 1) frame(entry, DT, 4);
349
+ const state = leg === 'legFL' ? entry.motionState.walk : entry.modelAnim;
350
+ const speeds = seeded(375, stopped);
351
+ let stopSeconds;
352
+ let restPhase;
353
+ for (let n = 1; n <= 120; n += 1) {
354
+ const speed = easeWalkSpeed(speeds, 'remote', stopped, 751 + n * DT * 1000, DT, 1000 + n * DT * 1000);
355
+ frame(entry, DT, speed, DT);
356
+ if (speed === 0 && stopSeconds === undefined) {
357
+ stopSeconds = n * DT;
358
+ restPhase = state.phase;
359
+ }
360
+ if (restPhase !== undefined) assert.equal(state.phase, restPhase);
361
+ }
362
+ assert.ok(stopSeconds <= 1, `${name}: phase did not stop within 1 s`);
363
+ assert.equal(speeds.get('remote').speed, 0);
364
+ console.log('rest', JSON.stringify({ model: name, stopSeconds, cadence: state.gait.cadence }));
365
+ }
366
+ const clock = {};
367
+ assert.equal(walkFrameTime(clock, 1000), 0);
368
+ assert.ok(Math.abs(walkFrameTime(clock, 1000 + 1000 / 18) - 1 / 18) < 1e-12);
369
+ assert.equal(walkFrameTime(clock, clock.wall + 250), 0.25);
370
+ assert.equal(walkFrameTime(clock, clock.wall + 251), 0);
371
+ assert.equal(walkFrameTime(clock, clock.wall + 30000), 0);
372
+ assert.equal(walkFrameTime(clock, clock.wall - 1), 0);
373
+ assert.equal(walkFrameTime(clock, Infinity), 0);
374
+ assert.equal(walkFrameTime(clock, 1000), 0);
375
+ assert.equal(walkFrameTime(clock, 1033), 0.033);
376
+ console.log('network/scale/hint/resume/rest/frame-time checks passed');
377
+ }
378
+ gait.setWalkGait('fixed');
379
+ }
380
+ const index = process.argv.indexOf('--trace');
381
+ const trace = path.resolve(index >= 0 ? process.argv[index + 1] : fileURLToPath(new URL('./out/gait-fixed.jsonl', import.meta.url)));
382
+ fs.mkdirSync(path.dirname(trace), { recursive: true });
383
+ fs.writeFileSync(trace, `${fixedTrace.join('\n')}\n`);
384
+ const summaryPath = trace.replace(/\.jsonl$/, '') + '-summary.json';
385
+ fs.writeFileSync(summaryPath, JSON.stringify(diagnostics, null, 2) + '\n');
386
+ console.log(`fixed trace: ${trace}`);
387
+ console.log(`diagnostics: ${summaryPath}`);