castle-web-cli 0.4.239 → 0.4.241

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 (396) hide show
  1. package/dist/agent.js +5 -1
  2. package/dist/api.d.ts +20 -0
  3. package/dist/api.js +57 -0
  4. package/dist/bundle.d.ts +38 -1
  5. package/dist/bundle.js +309 -13
  6. package/dist/castle-host/host.js +163 -11
  7. package/dist/castleJson.d.ts +10 -0
  8. package/dist/castleJson.js +46 -2
  9. package/dist/check.js +5 -2
  10. package/dist/devSessionServer.js +4 -1
  11. package/dist/devSessionStorage.d.ts +1 -0
  12. package/dist/devSessionStorage.js +32 -7
  13. package/dist/importOrder.d.ts +2 -0
  14. package/dist/importOrder.js +29 -0
  15. package/dist/index.js +6 -3
  16. package/dist/init.js +24 -2
  17. package/dist/multiplayerDoc.d.ts +1 -1
  18. package/dist/multiplayerDoc.js +2 -0
  19. package/dist/platformDoc.js +3 -2
  20. package/dist/playPagePolicy.js +5 -1
  21. package/dist/resetLeaderboards.d.ts +8 -1
  22. package/dist/resetLeaderboards.js +43 -8
  23. package/dist/roomLogs.d.ts +1 -0
  24. package/dist/roomLogs.js +30 -6
  25. package/dist/save-deck.d.ts +32 -2
  26. package/dist/save-deck.js +240 -39
  27. package/kits/base/CLAUDE.md +1 -1
  28. package/kits/base/castle.json +1 -1
  29. package/kits/base/sdk/README.md +174 -6
  30. package/kits/base/sdk/analytics.d.ts +8 -0
  31. package/kits/base/sdk/analytics.js +92 -0
  32. package/kits/base/sdk/castle.d.ts +5 -1
  33. package/kits/base/sdk/castle.js +2 -0
  34. package/kits/base/sdk/commands.d.ts +48 -0
  35. package/kits/base/sdk/commands.js +1 -0
  36. package/kits/base/sdk/debugConsole.d.ts +17 -0
  37. package/kits/base/sdk/debugConsole.js +154 -0
  38. package/kits/base/sdk/experiments.js +24 -1
  39. package/kits/base/sdk/hostRetry.d.ts +7 -0
  40. package/kits/base/sdk/hostRetry.js +57 -0
  41. package/kits/base/sdk/hub.d.ts +20 -2
  42. package/kits/base/sdk/hub.js +99 -13
  43. package/kits/base/sdk/multiplayer.d.ts +2 -0
  44. package/kits/base/sdk/multiplayer.js +168 -26
  45. package/kits/base/sdk/reconnectBudget.d.ts +6 -0
  46. package/kits/base/sdk/reconnectBudget.js +41 -1
  47. package/kits/base/sdk/runtime.js +36 -19
  48. package/kits/base/sdk/server/hub.d.ts +19 -0
  49. package/kits/base/sdk/server/hub.js +12 -0
  50. package/kits/base/sdk/server/platformHandle.d.ts +1 -0
  51. package/kits/base/sdk/server/wrapper.d.ts +1 -1
  52. package/kits/base/sdk/server/wrapper.js +26 -1
  53. package/kits/base/sdk/transport.d.ts +2 -1
  54. package/kits/base/sdk/transport.js +35 -0
  55. package/kits/hub-game/CLAUDE.md +66 -19
  56. package/kits/hub-game/code/client/act.js +9 -6
  57. package/kits/hub-game/code/client/actCore.js +26 -6
  58. package/kits/hub-game/code/client/actGateLog.js +36 -0
  59. package/kits/hub-game/code/client/actionOverflow.js +29 -8
  60. package/kits/hub-game/code/client/actionRailSurface.js +186 -0
  61. package/kits/hub-game/code/client/actionRailTree.js +173 -0
  62. package/kits/hub-game/code/client/askSurface.js +85 -0
  63. package/kits/hub-game/code/client/askTree.js +51 -0
  64. package/kits/hub-game/code/client/attention.js +31 -6
  65. package/kits/hub-game/code/client/ballot.js +42 -5
  66. package/kits/hub-game/code/client/ballotSurface.js +115 -0
  67. package/kits/hub-game/code/client/ballotTree.js +180 -0
  68. package/kits/hub-game/code/client/catchingUp.js +19 -0
  69. package/kits/hub-game/code/client/celebrate.js +66 -0
  70. package/kits/hub-game/code/client/chrome.js +481 -57
  71. package/kits/hub-game/code/client/companion.js +93 -23
  72. package/kits/hub-game/code/client/companionDress.js +1 -1
  73. package/kits/hub-game/code/client/cornerSurface.js +106 -0
  74. package/kits/hub-game/code/client/cornerTree.js +83 -0
  75. package/kits/hub-game/code/client/decor.js +20 -11
  76. package/kits/hub-game/code/client/deviceStorage.js +121 -0
  77. package/kits/hub-game/code/client/disguise.js +23 -0
  78. package/kits/hub-game/code/client/disguiseDraw.js +87 -0
  79. package/kits/hub-game/code/client/dockSurface.js +206 -0
  80. package/kits/hub-game/code/client/dockTree.js +232 -0
  81. package/kits/hub-game/code/client/earned.js +29 -0
  82. package/kits/hub-game/code/client/emoteSurface.js +188 -0
  83. package/kits/hub-game/code/client/emoteTree.js +264 -0
  84. package/kits/hub-game/code/client/farAvatars.js +4 -3
  85. package/kits/hub-game/code/client/fpsTelemetry.js +3 -1
  86. package/kits/hub-game/code/client/grab.js +121 -50
  87. package/kits/hub-game/code/client/holdShow.js +19 -0
  88. package/kits/hub-game/code/client/hookLayer.js +96 -12
  89. package/kits/hub-game/code/client/hubControls.js +7 -1
  90. package/kits/hub-game/code/client/hudSurface.js +11 -3
  91. package/kits/hub-game/code/client/hudTree.js +7 -4
  92. package/kits/hub-game/code/client/idle.js +21 -3
  93. package/kits/hub-game/code/client/invites.js +24 -3
  94. package/kits/hub-game/code/client/keys.js +15 -0
  95. package/kits/hub-game/code/client/labelsNear.js +8 -1
  96. package/kits/hub-game/code/client/layoutCache.js +57 -8
  97. package/kits/hub-game/code/client/loadingCover.js +53 -4
  98. package/kits/hub-game/code/client/menuIcons.js +15 -0
  99. package/kits/hub-game/code/client/menuSurface.js +102 -0
  100. package/kits/hub-game/code/client/menuTree.js +135 -0
  101. package/kits/hub-game/code/client/modelLook.js +41 -0
  102. package/kits/hub-game/code/client/padCues.js +11 -7
  103. package/kits/hub-game/code/client/padReadability.js +3 -3
  104. package/kits/hub-game/code/client/pickerSurface.js +152 -0
  105. package/kits/hub-game/code/client/pickerTree.js +163 -0
  106. package/kits/hub-game/code/client/pushVisit.js +4 -2
  107. package/kits/hub-game/code/client/quality.js +188 -29
  108. package/kits/hub-game/code/client/qualityEntry.js +10 -1
  109. package/kits/hub-game/code/client/quickChatSurface.js +222 -0
  110. package/kits/hub-game/code/client/quickChatTree.js +201 -0
  111. package/kits/hub-game/code/client/rehello.js +75 -0
  112. package/kits/hub-game/code/client/renderVisibility.js +17 -0
  113. package/kits/hub-game/code/client/replay.js +118 -0
  114. package/kits/hub-game/code/client/role.js +3 -0
  115. package/kits/hub-game/code/client/safeLayout.js +441 -56
  116. package/kits/hub-game/code/client/safeStyle.js +13 -10
  117. package/kits/hub-game/code/client/say.js +2 -0
  118. package/kits/hub-game/code/client/soundSurface.js +77 -0
  119. package/kits/hub-game/code/client/soundTree.js +74 -0
  120. package/kits/hub-game/code/client/soundscape.js +12 -9
  121. package/kits/hub-game/code/client/soundscapeCues.js +1 -1
  122. package/kits/hub-game/code/client/state.js +67 -1
  123. package/kits/hub-game/code/client/stuckSurface.js +76 -0
  124. package/kits/hub-game/code/client/stuckTree.js +67 -0
  125. package/kits/hub-game/code/client/talk.js +42 -12
  126. package/kits/hub-game/code/client/talkTree.js +4 -2
  127. package/kits/hub-game/code/client/textAskSurface.js +147 -0
  128. package/kits/hub-game/code/client/textAskTree.js +67 -0
  129. package/kits/hub-game/code/client/tiers.js +252 -27
  130. package/kits/hub-game/code/client/together.js +4 -1
  131. package/kits/hub-game/code/client/uiDom.js +86 -8
  132. package/kits/hub-game/code/client/uiTree.js +33 -4
  133. package/kits/hub-game/code/client/vehicle.js +72 -51
  134. package/kits/hub-game/code/client/weakestTier.js +75 -31
  135. package/kits/hub-game/code/client/wear.js +159 -5
  136. package/kits/hub-game/code/client/worldLabels.js +205 -25
  137. package/kits/hub-game/code/companionSpec.js +4 -2
  138. package/kits/hub-game/code/server/act.js +3 -0
  139. package/kits/hub-game/code/server/actGate.js +83 -0
  140. package/kits/hub-game/code/server/actions.js +71 -15
  141. package/kits/hub-game/code/server/actors.js +20 -5
  142. package/kits/hub-game/code/server/analytics.js +35 -3
  143. package/kits/hub-game/code/server/ask.js +39 -3
  144. package/kits/hub-game/code/server/ballot.js +167 -4
  145. package/kits/hub-game/code/server/celebrate.js +64 -0
  146. package/kits/hub-game/code/server/companion.js +17 -2
  147. package/kits/hub-game/code/server/decor.js +11 -2
  148. package/kits/hub-game/code/server/disguise.js +63 -0
  149. package/kits/hub-game/code/server/earned.js +6 -2
  150. package/kits/hub-game/code/server/friendBests.js +13 -4
  151. package/kits/hub-game/code/server/friendsAmong.js +67 -8
  152. package/kits/hub-game/code/server/grab.js +12 -2
  153. package/kits/hub-game/code/server/heldOffers.js +142 -0
  154. package/kits/hub-game/code/server/holdShow.js +98 -0
  155. package/kits/hub-game/code/server/hub.js +991 -72
  156. package/kits/hub-game/code/server/idle.js +110 -9
  157. package/kits/hub-game/code/server/index.js +9 -0
  158. package/kits/hub-game/code/server/labels.js +13 -3
  159. package/kits/hub-game/code/server/manifest.js +94 -6
  160. package/kits/hub-game/code/server/menu.js +26 -3
  161. package/kits/hub-game/code/server/npcs.js +55 -9
  162. package/kits/hub-game/code/server/observe.js +67 -6
  163. package/kits/hub-game/code/server/players.js +14 -2
  164. package/kits/hub-game/code/server/replay.js +135 -0
  165. package/kits/hub-game/code/server/standing.js +7 -3
  166. package/kits/hub-game/code/server/storageLimit.js +4 -1
  167. package/kits/hub-game/code/server/townDay.js +74 -0
  168. package/kits/hub-game/code/server/vehicle.js +3 -0
  169. package/kits/hub-game/code/server/vis.js +26 -4
  170. package/kits/hub-game/code/server/wallet.js +677 -0
  171. package/kits/hub-game/code/server/wear.js +13 -3
  172. package/kits/hub-game/code/server/writerLease.js +191 -0
  173. package/kits/hub-game/code/shared/act.js +1 -1
  174. package/kits/hub-game/code/shared/expression.js +6 -0
  175. package/kits/hub-game/code/shared/replay.js +37 -0
  176. package/kits/hub-game/code/systems/hub.js +429 -55
  177. package/kits/hub-game/docs/analytics.md +16 -2
  178. package/kits/hub-game/docs/contract.md +956 -101
  179. package/kits/hub-game/docs/home-pieces.md +5 -6
  180. package/kits/hub-game/docs/observed-progress.md +49 -1
  181. package/kits/hub-game/docs/vehicle-preset.md +23 -0
  182. package/kits/hub-game/index.html +1 -0
  183. package/kits/hub-game/models/hats/baker-cap.pxmodel +3 -3
  184. package/kits/hub-game/models/hats/bat-clip.pxmodel +3 -3
  185. package/kits/hub-game/models/hats/beekeeper.pxmodel +3 -3
  186. package/kits/hub-game/models/hats/cap.pxmodel +3 -3
  187. package/kits/hub-game/models/hats/captain.pxmodel +3 -3
  188. package/kits/hub-game/models/hats/chef-toque.pxmodel +3 -3
  189. package/kits/hub-game/models/hats/crooked-top.pxmodel +3 -3
  190. package/kits/hub-game/models/hats/delivery-cap.pxmodel +3 -3
  191. package/kits/hub-game/models/hats/fire-helmet.pxmodel +3 -3
  192. package/kits/hub-game/models/hats/flower-crown.pxmodel +3 -3
  193. package/kits/hub-game/models/hats/foam-crown.pxmodel +3 -3
  194. package/kits/hub-game/models/hats/hard-hat.pxmodel +3 -3
  195. package/kits/hub-game/models/hats/lantern.pxmodel +3 -3
  196. package/kits/hub-game/models/hats/laurel.pxmodel +3 -3
  197. package/kits/hub-game/models/hats/lighthouse.pxmodel +3 -3
  198. package/kits/hub-game/models/hats/nurse-cap.pxmodel +3 -3
  199. package/kits/hub-game/models/hats/police-cap.pxmodel +3 -3
  200. package/kits/hub-game/models/hats/sailor.pxmodel +3 -3
  201. package/kits/hub-game/models/hats/souwester.pxmodel +3 -3
  202. package/kits/hub-game/models/hats/straw.pxmodel +3 -3
  203. package/kits/hub-game/models/hats/sunflower.pxmodel +3 -3
  204. package/kits/hub-game/models/hats/sweatband.pxmodel +3 -3
  205. package/kits/hub-game/models/hats/teacher-beret.pxmodel +3 -3
  206. package/kits/hub-game/models/hats/witch.pxmodel +3 -3
  207. package/kits/hub-game/models/hold-show/daisy.pxmodel +231 -0
  208. package/kits/hub-game/models/hold-show/moonflower.pxmodel +171 -0
  209. package/kits/hub-game/models/hold-show/rose.pxmodel +191 -0
  210. package/kits/hub-game/models/hold-show/square/daisy.pxmodel +233 -0
  211. package/kits/hub-game/models/hold-show/square/moonflower.pxmodel +173 -0
  212. package/kits/hub-game/models/hold-show/square/rose.pxmodel +193 -0
  213. package/kits/hub-game/models/hold-show/square/sunflower.pxmodel +313 -0
  214. package/kits/hub-game/models/hold-show/square/tulip.pxmodel +133 -0
  215. package/kits/hub-game/models/hold-show/sunflower.pxmodel +311 -0
  216. package/kits/hub-game/models/hold-show/tulip.pxmodel +131 -0
  217. package/kits/hub-game/package-lock.json +3 -3
  218. package/kits/hub-game/package.json +4 -3
  219. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +1 -0
  220. package/kits/hub-game/scripts/fixtures/hud-surface.json +12 -12
  221. package/kits/hub-game/scripts/fixtures/talk-surface.json +8 -8
  222. package/kits/hub-game/scripts/gen-hats.mjs +1 -1
  223. package/kits/hub-game/scripts/gen-hold-show.mjs +27 -0
  224. package/kits/hub-game/scripts/pack.mjs +89 -23
  225. package/kits/hub-game/scripts/test-act-client.mjs +5 -0
  226. package/kits/hub-game/scripts/test-act-core.mjs +32 -0
  227. package/kits/hub-game/scripts/test-act-gate.mjs +186 -0
  228. package/kits/hub-game/scripts/test-action-rail-crowded-dom.mjs +7 -1
  229. package/kits/hub-game/scripts/test-action-rail-default-dom.mjs +102 -0
  230. package/kits/hub-game/scripts/test-action-rail-never-silent-dom.mjs +50 -0
  231. package/kits/hub-game/scripts/test-action-rail-surface.mjs +368 -0
  232. package/kits/hub-game/scripts/test-action-rail-town-jobs-dom.mjs +118 -0
  233. package/kits/hub-game/scripts/test-actions-client.mjs +5 -3
  234. package/kits/hub-game/scripts/test-actions.mjs +24 -0
  235. package/kits/hub-game/scripts/test-actors.mjs +19 -0
  236. package/kits/hub-game/scripts/test-again-corner-dom.mjs +59 -0
  237. package/kits/hub-game/scripts/test-analytics.mjs +79 -0
  238. package/kits/hub-game/scripts/test-arrival-pose-server.mjs +25 -8
  239. package/kits/hub-game/scripts/test-ask-client.mjs +9 -0
  240. package/kits/hub-game/scripts/test-ask-surface.mjs +188 -0
  241. package/kits/hub-game/scripts/test-attention.mjs +43 -1
  242. package/kits/hub-game/scripts/test-ballot-sheet-dom.mjs +71 -0
  243. package/kits/hub-game/scripts/test-ballot-surface.mjs +276 -0
  244. package/kits/hub-game/scripts/test-ballot.mjs +421 -4
  245. package/kits/hub-game/scripts/test-ban-join.mjs +1 -1
  246. package/kits/hub-game/scripts/test-celebrate-client.mjs +62 -0
  247. package/kits/hub-game/scripts/test-celebrate.mjs +116 -0
  248. package/kits/hub-game/scripts/test-chat.mjs +73 -0
  249. package/kits/hub-game/scripts/test-companion-client.mjs +203 -21
  250. package/kits/hub-game/scripts/test-companion.mjs +110 -3
  251. package/kits/hub-game/scripts/test-control-layout-dom.mjs +57 -10
  252. package/kits/hub-game/scripts/test-corner-surface.mjs +268 -0
  253. package/kits/hub-game/scripts/test-decor-client.mjs +59 -3
  254. package/kits/hub-game/scripts/test-decor.mjs +27 -0
  255. package/kits/hub-game/scripts/test-device-class.mjs +4 -1
  256. package/kits/hub-game/scripts/test-disguise-client.mjs +281 -0
  257. package/kits/hub-game/scripts/test-disguise.mjs +176 -0
  258. package/kits/hub-game/scripts/test-dock-surface.mjs +404 -0
  259. package/kits/hub-game/scripts/test-door-stay-client.mjs +602 -0
  260. package/kits/hub-game/scripts/test-door-stay.mjs +613 -0
  261. package/kits/hub-game/scripts/test-earned-client.mjs +119 -0
  262. package/kits/hub-game/scripts/test-emote-surface.mjs +616 -0
  263. package/kits/hub-game/scripts/test-fps-telemetry.mjs +39 -4
  264. package/kits/hub-game/scripts/test-friend-bests.mjs +38 -12
  265. package/kits/hub-game/scripts/test-ghost-click-dom.mjs +75 -0
  266. package/kits/hub-game/scripts/test-grab-client.mjs +29 -2
  267. package/kits/hub-game/scripts/test-grab-orbit.mjs +260 -11
  268. package/kits/hub-game/scripts/test-grab.mjs +10 -1
  269. package/kits/hub-game/scripts/test-hats.mjs +28 -0
  270. package/kits/hub-game/scripts/test-held-offers.mjs +394 -0
  271. package/kits/hub-game/scripts/test-high-only.mjs +3 -3
  272. package/kits/hub-game/scripts/test-hold-show-client.mjs +175 -0
  273. package/kits/hub-game/scripts/test-hold-show.mjs +355 -0
  274. package/kits/hub-game/scripts/test-hub-controls.mjs +3 -1
  275. package/kits/hub-game/scripts/test-hub-idle.mjs +348 -0
  276. package/kits/hub-game/scripts/test-hub-leaving.mjs +21 -0
  277. package/kits/hub-game/scripts/test-hub-ops.mjs +119 -0
  278. package/kits/hub-game/scripts/test-hub-trip.mjs +240 -4
  279. package/kits/hub-game/scripts/test-hud-clear.mjs +83 -0
  280. package/kits/hub-game/scripts/test-hud-rate.mjs +2 -1
  281. package/kits/hub-game/scripts/test-idle.mjs +160 -0
  282. package/kits/hub-game/scripts/test-invites-client.mjs +53 -0
  283. package/kits/hub-game/scripts/test-labels.mjs +11 -0
  284. package/kits/hub-game/scripts/test-landscape-layout.mjs +20 -0
  285. package/kits/hub-game/scripts/test-loading-cover.mjs +67 -1
  286. package/kits/hub-game/scripts/test-manifest.mjs +27 -0
  287. package/kits/hub-game/scripts/test-menu-client.mjs +54 -5
  288. package/kits/hub-game/scripts/test-menu-surface.mjs +236 -0
  289. package/kits/hub-game/scripts/test-npcs.mjs +128 -0
  290. package/kits/hub-game/scripts/test-observed.mjs +171 -3
  291. package/kits/hub-game/scripts/test-pack.mjs +166 -0
  292. package/kits/hub-game/scripts/test-pad-cues.mjs +39 -0
  293. package/kits/hub-game/scripts/test-picker-surface.mjs +321 -0
  294. package/kits/hub-game/scripts/test-placeat-server.mjs +648 -0
  295. package/kits/hub-game/scripts/test-placement-cache.mjs +1 -1
  296. package/kits/hub-game/scripts/test-pointer-clear-dom.mjs +82 -0
  297. package/kits/hub-game/scripts/test-progress-reset.mjs +184 -6
  298. package/kits/hub-game/scripts/test-push-visit.mjs +9 -0
  299. package/kits/hub-game/scripts/test-quality.mjs +312 -9
  300. package/kits/hub-game/scripts/test-quick-chat-surface.mjs +511 -0
  301. package/kits/hub-game/scripts/test-rehello.mjs +242 -3
  302. package/kits/hub-game/scripts/test-rejoin-yaw.mjs +138 -0
  303. package/kits/hub-game/scripts/test-relations-among.mjs +13 -7
  304. package/kits/hub-game/scripts/test-relations-refresh.mjs +90 -2
  305. package/kits/hub-game/scripts/test-replay-client.mjs +110 -0
  306. package/kits/hub-game/scripts/test-replay.mjs +178 -0
  307. package/kits/hub-game/scripts/test-resume-held.mjs +13 -0
  308. package/kits/hub-game/scripts/test-resume-pose-server.mjs +43 -5
  309. package/kits/hub-game/scripts/test-role-client.mjs +2 -1
  310. package/kits/hub-game/scripts/test-safe-act.mjs +233 -0
  311. package/kits/hub-game/scripts/test-safe-caption.mjs +364 -0
  312. package/kits/hub-game/scripts/test-safe-layout.mjs +79 -0
  313. package/kits/hub-game/scripts/test-safe-prompt.mjs +163 -0
  314. package/kits/hub-game/scripts/test-sound-surface.mjs +256 -0
  315. package/kits/hub-game/scripts/test-soundscape.mjs +85 -2
  316. package/kits/hub-game/scripts/test-standing.mjs +135 -2
  317. package/kits/hub-game/scripts/test-stuck-surface.mjs +174 -0
  318. package/kits/hub-game/scripts/test-stuck.mjs +36 -1
  319. package/kits/hub-game/scripts/test-talk-surface.mjs +23 -6
  320. package/kits/hub-game/scripts/test-talk-walk-dom.mjs +123 -0
  321. package/kits/hub-game/scripts/test-text-ask-surface.mjs +273 -0
  322. package/kits/hub-game/scripts/test-tiers.mjs +453 -3
  323. package/kits/hub-game/scripts/test-toast-no-row-dom.mjs +71 -0
  324. package/kits/hub-game/scripts/test-together.mjs +11 -0
  325. package/kits/hub-game/scripts/test-town-day.mjs +90 -0
  326. package/kits/hub-game/scripts/test-try-on.mjs +39 -0
  327. package/kits/hub-game/scripts/test-ui-dom-dom.mjs +49 -2
  328. package/kits/hub-game/scripts/test-ui-tree.mjs +28 -0
  329. package/kits/hub-game/scripts/test-vehicle-client.mjs +68 -1
  330. package/kits/hub-game/scripts/test-vis.mjs +145 -0
  331. package/kits/hub-game/scripts/test-wallet.mjs +650 -0
  332. package/kits/hub-game/scripts/test-weakest-tier.mjs +135 -1
  333. package/kits/hub-game/scripts/test-world-labels.mjs +340 -0
  334. package/kits/hub-game/scripts/test-writer-lease-server.mjs +234 -0
  335. package/kits/hub-game/scripts/test-writer-lease.mjs +281 -0
  336. package/kits/hub-game/scripts/writer-storage-fixture.mjs +37 -0
  337. package/kits/hub-game/tools/hubScene/export.mjs +6 -5
  338. package/kits/hub-game/tools/hubScene/hubdata.mjs +10 -0
  339. package/kits/hub-game/tools/hubScene/test/export-fixture.mjs +36 -2
  340. package/kits/hub-game/tools/hubScene/validate-manifest.mjs +10 -2
  341. package/kits/multiplayer-3d/castle.json +5 -5
  342. package/kits/multiplayer-3d/code/client/resumeGate.js +66 -2
  343. package/kits/multiplayer-3d/code/server/ownership.js +25 -6
  344. package/kits/multiplayer-3d/code/server/world.js +19 -4
  345. package/kits/multiplayer-3d/code/systems/multiplayer.js +108 -18
  346. package/kits/multiplayer-3d/package-lock.json +1 -1
  347. package/kits/multiplayer-3d/package.json +2 -1
  348. package/kits/multiplayer-3d/scripts/test-ground-half.mjs +56 -0
  349. package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +54 -3
  350. package/kits/multiplayer-3d/scripts/test-owned-moves.mjs +190 -0
  351. package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +417 -5
  352. package/kits/multiplayer-3d/scripts/test-resync-reconnect.mjs +68 -0
  353. package/kits/physics-2d/castle.json +2 -2
  354. package/kits/physics-2d/engine/scene.js +10 -2
  355. package/kits/physics-3d/CLAUDE.md +14 -0
  356. package/kits/physics-3d/behaviors/Player.jsx +39 -3
  357. package/kits/physics-3d/castle.json +3 -3
  358. package/kits/physics-3d/docs/engine-model-cache.md +109 -0
  359. package/kits/physics-3d/docs/engine-player.md +76 -0
  360. package/kits/physics-3d/docs/engine-skip-work.md +16 -0
  361. package/kits/physics-3d/docs/pxmodel-format.md +5 -1
  362. package/kits/physics-3d/engine3d/gait.js +16 -8
  363. package/kits/physics-3d/engine3d/groundsize.js +23 -0
  364. package/kits/physics-3d/engine3d/kithooks.js +50 -0
  365. package/kits/physics-3d/engine3d/look.js +110 -17
  366. package/kits/physics-3d/engine3d/lookbake.js +19 -1
  367. package/kits/physics-3d/engine3d/materialpresets.js +3 -2
  368. package/kits/physics-3d/engine3d/modelcache.js +280 -0
  369. package/kits/physics-3d/engine3d/modelcachedigest.js +37 -0
  370. package/kits/physics-3d/engine3d/modelcachegate.js +69 -0
  371. package/kits/physics-3d/engine3d/modelrefs.js +13 -0
  372. package/kits/physics-3d/engine3d/optimize.js +20 -9
  373. package/kits/physics-3d/engine3d/playerRun.js +26 -1
  374. package/kits/physics-3d/engine3d/pxmodel.js +7 -3
  375. package/kits/physics-3d/engine3d/templatecache.js +722 -0
  376. package/kits/physics-3d/engine3d/world3d.js +211 -17
  377. package/kits/physics-3d/package-lock.json +1 -1
  378. package/kits/physics-3d/package.json +2 -1
  379. package/kits/physics-3d/play/behaviors/Player.js +43 -3
  380. package/kits/physics-3d/scripts/render.mjs +56 -8
  381. package/kits/physics-3d/scripts/template-cache-fixtures.mjs +37 -0
  382. package/kits/physics-3d/scripts/template-cache-v1-bytes.json +49 -0
  383. package/kits/physics-3d/scripts/test-coaxial-escape.mjs +176 -0
  384. package/kits/physics-3d/scripts/test-gait.mjs +53 -9
  385. package/kits/physics-3d/scripts/test-ground-half.mjs +120 -0
  386. package/kits/physics-3d/scripts/test-model-cache.mjs +600 -0
  387. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +1 -0
  388. package/kits/physics-3d/scripts/test-sleeping-models.mjs +384 -0
  389. package/kits/physics-3d/scripts/test-template-cache-minified.mjs +106 -0
  390. package/kits/physics-3d/scripts/test-template-cache.mjs +519 -0
  391. package/kits/physics-3d/scripts/test-wall-slide.mjs +272 -0
  392. package/kits/physics-3d/systems/physics3d.js +59 -2
  393. package/kits/real-time/castle.json +2 -2
  394. package/kits/real-time/code/client/connection.js +3 -0
  395. package/package.json +2 -2
  396. package/vendor/three/examples/jsm/libs/fflate.module.js +2672 -0
@@ -0,0 +1,49 @@
1
+ {
2
+ "models/barrel.pxmodel": 50296,
3
+ "models/cart.pxmodel": 1778184,
4
+ "models/mixed.pxmodel": 56824,
5
+ "models/parts/axe.pxmodel": 117392,
6
+ "models/parts/backpack.pxmodel": 166872,
7
+ "models/parts/barrel.pxmodel": 1813976,
8
+ "models/parts/bedroll.pxmodel": 76528,
9
+ "models/parts/belt-pouch.pxmodel": 95400,
10
+ "models/parts/bolt.pxmodel": 16680,
11
+ "models/parts/bracer.pxmodel": 79992,
12
+ "models/parts/chain-span.pxmodel": 176136,
13
+ "models/parts/chimney.pxmodel": 99960,
14
+ "models/parts/crate.pxmodel": 1576104,
15
+ "models/parts/crystal.pxmodel": 48704,
16
+ "models/parts/door-arched.pxmodel": 86536,
17
+ "models/parts/engine-block.pxmodel": 164784,
18
+ "models/parts/exhaust-pipe.pxmodel": 111936,
19
+ "models/parts/fence-span.pxmodel": 120264,
20
+ "models/parts/fender.pxmodel": 96656,
21
+ "models/parts/headlight.pxmodel": 91656,
22
+ "models/parts/hood.pxmodel": 44904,
23
+ "models/parts/horned-helmet.pxmodel": 81040,
24
+ "models/parts/jerry-can.pxmodel": 1813912,
25
+ "models/parts/ladder.pxmodel": 155496,
26
+ "models/parts/lamp.pxmodel": 63296,
27
+ "models/parts/lantern.pxmodel": 167496,
28
+ "models/parts/leaf-cluster.pxmodel": null,
29
+ "models/parts/offroad-tire.pxmodel": 753664,
30
+ "models/parts/pauldron.pxmodel": 66144,
31
+ "models/parts/rivet.pxmodel": 13072,
32
+ "models/parts/rock.pxmodel": 571000,
33
+ "models/parts/roll-bar-light.pxmodel": 102688,
34
+ "models/parts/round-shield.pxmodel": 151320,
35
+ "models/parts/saddlebag.pxmodel": 158136,
36
+ "models/parts/spoked-wheel.pxmodel": 1682072,
37
+ "models/parts/staff.pxmodel": 99000,
38
+ "models/parts/stepping-stones.pxmodel": 167712,
39
+ "models/parts/stone-base.pxmodel": 205744,
40
+ "models/parts/sword.pxmodel": null,
41
+ "models/parts/window-lit.pxmodel": 129976,
42
+ "models/parts/wizard-hat.pxmodel": null,
43
+ "models/player.pxmodel": 58856,
44
+ "models/rock.pxmodel": 8000,
45
+ "models/templates/biped-stout.pxmodel": 220160,
46
+ "models/templates/biped-tall.pxmodel": 217560,
47
+ "models/templates/quadruped.pxmodel": 155448,
48
+ "models/tree.pxmodel": 114776
49
+ }
@@ -0,0 +1,176 @@
1
+ // Two players on exactly one spot (hub-game v1.218, Nov 17 Market check).
2
+ // Real Player + Physics3DSystem + the kit's vendored Rapier WASM, as
3
+ // test-wall-slide.mjs runs them: the local player (the hub player blueprint)
4
+ // and another player's avatar (a kinematic Solid capsule, as multiplayer-3d
5
+ // draws one) standing exactly where the local body stands.
6
+ //
7
+ // 1. Informational: while they stay coaxial the local body is wedged into
8
+ // the ground and cannot walk (the bug the server's step-off now
9
+ // prevents). Logged, not asserted: a physics change that frees a coaxial
10
+ // body is no failure.
11
+ // 2. The gap before the step-off reaches the joiner's client: its body sits
12
+ // under the other avatar for N frames, then the session's placement
13
+ // arrives, either in one step (multiplayer-3d `placedTo`) or as clamped
14
+ // rows eased a quarter of the way each (`clampedTo` under CLAMP_SNAP).
15
+ // After it the body walks at full pace.
16
+ // 3. The other side of the same gap: the first player stands still while
17
+ // the joiner's avatar is drawn on them, then slides to the stepped-off
18
+ // spot. The first player walks at full pace once it has gone.
19
+ //
20
+ // Run from any directory: node kits/physics-3d/scripts/test-coaxial-escape.mjs
21
+ import assert from 'node:assert/strict';
22
+ import { register } from 'node:module';
23
+
24
+ register('data:text/javascript,' + encodeURIComponent(`
25
+ import { existsSync, readFileSync } from 'node:fs';
26
+ import { fileURLToPath } from 'node:url';
27
+ export async function resolve(specifier, context, next) {
28
+ const parent = context.parentURL ?? '';
29
+ if (specifier.startsWith('@imports/castle.physics-2d/')) {
30
+ specifier = parent.replace(/\\/kits\\/.*/, '/kits/physics-2d/') + specifier.slice(27);
31
+ }
32
+ if ((specifier.startsWith('.') || specifier.startsWith('file:')) && parent.includes('/kits/') && !/\\.(m?js|jsx|json)$/.test(specifier)) {
33
+ const base = new URL(specifier, parent).href;
34
+ for (const ext of ['.js', '.jsx']) if (existsSync(fileURLToPath(base + ext))) return next(base + ext, context);
35
+ }
36
+ return next(specifier, context);
37
+ }
38
+ export async function load(url, context, next) {
39
+ if (url.endsWith('.jsx')) {
40
+ return { format: 'module', source: readFileSync(fileURLToPath(url), 'utf8'), shortCircuit: true };
41
+ }
42
+ return next(url, context);
43
+ }
44
+ `));
45
+ const { Player } = await import('../behaviors/Player.jsx');
46
+ const { Physics3DSystem } = await import('../systems/physics3d.js');
47
+
48
+ const DT = 1 / 60;
49
+ const SPAWN = { x: 0, z: 9 };
50
+ // The hub arrival row's step-off for the Town (face 180, spread 1.5).
51
+ const PLACED = { x: -1.5, z: 9 };
52
+ // One clamped row every other frame (a 30 Hz session), eased a quarter.
53
+ const ROW_FRAMES = 2;
54
+ const CLAMP_EASE = 0.25;
55
+ const SPEED = Player.defaultProps.speed;
56
+ const props = { ...Player.defaultProps };
57
+ const tf = (x, y, z) => ({ x, y, z, rotationX: 0, rotationY: 180, rotationZ: 0, scaleX: 1, scaleY: 1, scaleZ: 1 });
58
+ const flat = (a, b) => Math.hypot(a.x - b.x, a.z - b.z);
59
+
60
+ async function makeWorld() {
61
+ const me = { id: 'player', runtime: {}, components: {
62
+ Transform: tf(SPAWN.x, 1, SPAWN.z), Shape: { kind: 'capsule', radius: 0.35, height: 1.4 },
63
+ Body: { type: 'dynamic', lockRotations: true, friction: 0, restitution: 0, gravityScale: 2 }, Solid: {}, Player: { ...props },
64
+ } };
65
+ const system = new Physics3DSystem();
66
+ const scene = {
67
+ time: 0, keys: new Set(), persistent: { camAngle: Math.PI / 4 },
68
+ data: { ground: {}, engine: {} }, actors: [me], maxFps: 0, three: null, cameraControl: 'orbit',
69
+ getActors: () => scene.actors, getActor: (id) => scene.actors.find((a) => a.id === id),
70
+ actorsWith: () => [], forEachBehavior: () => {},
71
+ };
72
+ system.attach(scene);
73
+ const api = scene.physics3d;
74
+ for (let i = 0; i < 200 && !api.ready(); i += 1) {
75
+ await new Promise((resolve) => setTimeout(resolve, 5));
76
+ system.afterBehaviors(scene, DT);
77
+ }
78
+ assert.ok(api.ready(), 'real Rapier initialized');
79
+ const body = () => system.bodies.get(me.id).body;
80
+ const frame = (walking) => {
81
+ scene.time += DT;
82
+ scene.keys = new Set(walking ? ['KeyW'] : []);
83
+ new Player(props).update(me, scene, DT);
84
+ system.afterBehaviors(scene, DT);
85
+ return { ...body().translation() };
86
+ };
87
+ let standing;
88
+ for (let i = 0; i < 180; i += 1) standing = frame(false);
89
+ // Body.defaultProps filled in, as the engine does for a blueprint's Body.
90
+ const avatar = { id: 'avatar', runtime: {}, components: {
91
+ Transform: tf(SPAWN.x, standing.y, SPAWN.z), Shape: { kind: 'capsule', radius: 0.35, height: 1.4 },
92
+ Body: { type: 'kinematic', friction: 0.6, restitution: 0, gravityScale: 0, lockRotations: true }, Solid: {},
93
+ } };
94
+ scene.actors.push(avatar);
95
+ // multiplayer-3d acceptClamp: a placement in one step, or an eased row.
96
+ const put = (to) => {
97
+ body().setTranslation(to, true);
98
+ Object.assign(me.components.Transform, to);
99
+ };
100
+ const place = (to) => { put(to); body().setLinvel({ x: 0, y: 0, z: 0 }, true); };
101
+ const ease = (to) => {
102
+ const at = body().translation();
103
+ put({ x: at.x + (to.x - at.x) * CLAMP_EASE, y: at.y + (to.y - at.y) * CLAMP_EASE, z: at.z + (to.z - at.z) * CLAMP_EASE });
104
+ };
105
+ return { me, avatar, standing, frame, place, ease, body, close: () => system.dispose(scene) };
106
+ }
107
+
108
+ // Walk for a second; the distance covered over its last half.
109
+ function walkPace(w) {
110
+ let mid;
111
+ for (let i = 0; i < 60; i += 1) {
112
+ const p = w.frame(true);
113
+ if (i === 29) mid = p;
114
+ }
115
+ return flat(w.body().translation(), mid) / 0.5;
116
+ }
117
+
118
+ // 1. Coaxial and staying so: wedged.
119
+ {
120
+ const w = await makeWorld();
121
+ for (let i = 0; i < 30; i += 1) w.frame(false);
122
+ const from = w.body().translation();
123
+ for (let i = 0; i < 120; i += 1) w.frame(true);
124
+ const moved = flat(w.body().translation(), from);
125
+ const sunk = w.standing.y - w.body().translation().y;
126
+ w.close();
127
+ console.log(`coaxial (informational): walked ${moved.toFixed(3)} m in 2 s, sunk ${sunk.toFixed(3)} m into the ground`);
128
+ }
129
+
130
+ // 2. The joiner: N frames under the avatar (walking or not), then the step-off.
131
+ const rows = [];
132
+ for (const how of ['place', 'ease']) {
133
+ for (const frames of [1, 6, 30, 120]) {
134
+ for (const walking of [false, true]) {
135
+ const w = await makeWorld();
136
+ for (let i = 0; i < frames; i += 1) w.frame(walking);
137
+ const target = { x: PLACED.x, y: w.standing.y, z: PLACED.z };
138
+ if (how === 'place') {
139
+ w.place(target);
140
+ w.frame(false);
141
+ } else {
142
+ // Rows keep coming until the body is near the spot (the server's
143
+ // settle ends at 0.25 m); the walk is held off meanwhile.
144
+ for (let i = 0; i < 120 && flat(w.body().translation(), target) > 0.25; i += 1) {
145
+ if (i % ROW_FRAMES === 0) w.ease(target);
146
+ w.frame(false);
147
+ }
148
+ }
149
+ const off = flat(w.body().translation(), target);
150
+ const y = w.body().translation().y;
151
+ const pace = walkPace(w);
152
+ w.close();
153
+ rows.push({ how, frames, walking, off: +off.toFixed(3), y: +y.toFixed(3), pace: +pace.toFixed(2) });
154
+ assert.ok(pace > SPEED * 0.9, `${how} after ${frames} frames (walking ${walking}): walks at ${pace} m/s`);
155
+ assert.ok(Math.abs(y - w.standing.y) < 0.05, `${how} after ${frames} frames: standing height ${y}`);
156
+ }
157
+ }
158
+ }
159
+ for (const row of rows) console.log(JSON.stringify(row));
160
+
161
+ // 3. The first player: the joiner's avatar drawn on them, then sliding away.
162
+ for (const frames of [6, 60]) {
163
+ const w = await makeWorld();
164
+ for (let i = 0; i < frames; i += 1) w.frame(false);
165
+ const t = w.avatar.components.Transform;
166
+ for (let i = 0; i < 20; i += 1) {
167
+ t.x += (PLACED.x - t.x) * 0.25;
168
+ w.frame(false);
169
+ }
170
+ const pace = walkPace(w);
171
+ const y = w.body().translation().y;
172
+ w.close();
173
+ console.log(`first player: avatar on them ${frames} frames then slid off; walks ${pace.toFixed(2)} m/s, y ${y.toFixed(3)}`);
174
+ assert.ok(pace > SPEED * 0.9, `first player walks once the avatar slid off (${pace} m/s)`);
175
+ }
176
+ console.log('test-coaxial-escape: free at full pace once the step-off or the avatar arrives');
@@ -131,8 +131,8 @@ for (const [name, url, leg, amplitude, speed, options] of cases) {
131
131
  // survive a missing write. A 30 s/3 min resume cannot jump whole cycles.
132
132
  const beforeAmplitude = state.amplitudeScale ?? 1;
133
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);
134
+ assert.ok(Math.abs(state.amplitudeScale - beforeAmplitude) <= (0.4 / amplitude) / 6 + 1e-12);
135
+ assert.ok(state.gait.cadence <= 2.5 + 1e-12);
136
136
  assert.equal(state.gait.cap, 30);
137
137
  assert.ok(!Object.hasOwn(entry.node.userData, 'walkSpeedHint'));
138
138
  assert.ok(!Object.hasOwn(entry.node.userData, 'walkTimeHint'));
@@ -220,10 +220,13 @@ if (gait) {
220
220
  gait.setWalkGait('model');
221
221
 
222
222
  const hub = diagnostics.find((row) => row.model === 'avatar-0-hub6' && row.mode === 'model');
223
+ const hubFixed = diagnostics.find((row) => row.model === 'avatar-0-hub6' && row.mode === 'fixed');
223
224
  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);
225
+ // Short legs cannot cover a hub run at 2.5 cycles a second: the swing is
226
+ // at its widest and the feet slip, but less than the fixed gait's do.
227
+ assert.ok(Math.abs(hub.cadence - 2.5) < 1e-10);
228
+ assert.ok(Math.abs(hub.A - 1.2) < 1e-10);
229
+ assert.ok(hub.footSpeedRatio > hubFixed.footSpeedRatio);
227
230
  }
228
231
 
229
232
  // Slow walks must cover their distance too: cadence uses the TARGET swing
@@ -242,9 +245,16 @@ if (gait) {
242
245
  const cadence = state.gait.cadence;
243
246
  const cycleFootSpeed = 4 * state.gait.length * Math.sin(effectiveAmplitude) * cadence;
244
247
  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
+ // Feet keep up wherever the widest swing allows 2.5 cycles a second;
249
+ // past that the cadence holds at the cap and the feet slip.
250
+ const reach = 4 * state.gait.length * Math.sin(baseAmplitude + 0.4) * 2.5;
251
+ if (speed <= reach) {
252
+ assert.ok(Math.abs(footSpeedRatio - 1) <= 0.05,
253
+ `${name} at ${speed} m/s: foot/ground ratio ${footSpeedRatio}`);
254
+ } else {
255
+ assert.ok(Math.abs(cadence - 2.5) < 1e-10 && footSpeedRatio < 1, `${name} at ${speed} m/s: cadence ${cadence}`);
256
+ }
257
+ assert.ok(cadence <= 2.5 + 1e-12);
248
258
  const result = { test: 'steady', model: name, mode: 'model', groundSpeed: speed,
249
259
  L: state.gait.length, cadence, A, effectiveAmplitude, cycleFootSpeed, footSpeedRatio };
250
260
  diagnostics.push(result);
@@ -254,13 +264,47 @@ if (gait) {
254
264
  }
255
265
  }
256
266
 
267
+ // Every wardrobe body at the town's 5.68 m/s run: no faster than 2.5
268
+ // cycles a second, and a torso bob no taller than the fixed gait's.
269
+ for (let body = 0; body < 16; body += 1) {
270
+ const url = new URL(`../../hub-game/models/avatar-${body}.pxmodel`, import.meta.url);
271
+ if (!fs.existsSync(url)) continue;
272
+ const bob = {};
273
+ for (const mode of ['fixed', 'model']) {
274
+ gait.setWalkGait(mode);
275
+ const entry = build(url, { rigScale: hubModel.scale ?? 1, yOffset: hubModel.yOffset ?? 0 });
276
+ const torso = entry.node.userData.modelParts.get('torso');
277
+ let low = Infinity;
278
+ let high = -Infinity;
279
+ for (let n = 0; n < 240; n += 1) {
280
+ entry.node.position.z += 5.68 * DT;
281
+ frame(entry, DT);
282
+ if (n >= 120) {
283
+ low = Math.min(low, torso.position.y);
284
+ high = Math.max(high, torso.position.y);
285
+ }
286
+ }
287
+ bob[mode] = high - low;
288
+ if (mode === 'model') {
289
+ assert.ok(entry.modelAnim.gait.cadence <= 2.5 + 1e-12, `avatar-${body}: cadence ${entry.modelAnim.gait.cadence}`);
290
+ assert.ok(bob.model < bob.fixed, `avatar-${body}: bob ${bob.model} vs fixed ${bob.fixed}`);
291
+ const result = { test: 'wardrobe', model: `avatar-${body}`, groundSpeed: 5.68,
292
+ L: entry.modelAnim.gait.length, cadence: entry.modelAnim.gait.cadence, bob: bob.model, fixedBob: bob.fixed };
293
+ diagnostics.push(result);
294
+ console.log('wardrobe', JSON.stringify(result));
295
+ }
296
+ }
297
+ }
298
+ gait.setWalkGait('model');
299
+
257
300
  // Network poses follow real time even when the engine caps its own step.
258
301
  // Exercise both animation passes and measure cadence from actual phase,
259
302
  // rather than the requested cadence stored in the gait diagnostics.
260
303
  for (const [name, url, leg, baseAmplitude] of models.slice(0, 2)) {
261
304
  const realDt = 1 / 18;
262
305
  const engineDt = 0.033;
263
- const speed = 4;
306
+ // Inside both models' reach at the 2.5 cycle cap, so the feet keep up.
307
+ const speed = 2;
264
308
  const entry = build(url);
265
309
  const capped = build(url);
266
310
  for (let n = 0; n < 90; n += 1) {
@@ -0,0 +1,120 @@
1
+ // `"ground": { "half": n }` (engine3d/groundsize.js) on the client: the drawn
2
+ // plane and its line grid become 2n wide and the physics system's ground
3
+ // collider n each way. Without the key the plane `addGround` made is not
4
+ // touched and the collider stays 100 m each way. rapier is a recording
5
+ // stand-in: this is about the sizes asked for, not the simulation.
6
+ import assert from 'node:assert/strict';
7
+ import { register } from 'node:module';
8
+ import * as THREE from 'three';
9
+
10
+ const stub = `
11
+ const any = () => new Proxy(function () {}, {
12
+ get: (t, k) => (k === 'then' ? undefined : k === Symbol.toPrimitive ? () => 0 : any()),
13
+ apply: () => any(),
14
+ construct: () => any(),
15
+ });
16
+ export const init = async () => {};
17
+ export const World = any();
18
+ export const EventQueue = any();
19
+ export const RigidBodyDesc = any();
20
+ export const ColliderDesc = new Proxy(any(), {
21
+ get: (t, k) => (k === 'cuboid' ? (...args) => { (globalThis.__cuboids ??= []).push(args); return any(); } : any()),
22
+ });
23
+ export const RigidBodyType = { Dynamic: 0, Fixed: 1, KinematicPositionBased: 2, KinematicVelocityBased: 3 };
24
+ export const ActiveEvents = any();
25
+ export const ActiveCollisionTypes = any();
26
+ export const Ray = any();
27
+ export const Quaternion = any();
28
+ export const Vector3 = any();
29
+ `;
30
+ const hooks = `
31
+ import { existsSync } from 'node:fs';
32
+ import { fileURLToPath } from 'node:url';
33
+ export async function resolve(specifier, context, next) {
34
+ const isRapier = specifier === '@dimforge/rapier3d-compat' ||
35
+ ((specifier.startsWith('.') || specifier.startsWith('file:')) &&
36
+ new URL(specifier, context.parentURL).href.endsWith('/kits/physics-3d/engine3d/rapier.js'));
37
+ const parent = context.parentURL ?? '';
38
+ if (isRapier) {
39
+ return { url: 'data:text/javascript,' + encodeURIComponent(${JSON.stringify(stub)}), shortCircuit: true };
40
+ }
41
+ if (specifier.startsWith('@imports/castle.physics-2d/')) {
42
+ specifier = parent.replace(/\\/kits\\/.*/, '/kits/physics-2d/') + specifier.slice(27);
43
+ }
44
+ if ((specifier.startsWith('.') || specifier.startsWith('file:')) && parent.includes('/kits/') && !/\\.(m?js|jsx|json)$/.test(specifier)) {
45
+ const base = new URL(specifier, parent).href;
46
+ for (const ext of ['.js', '.jsx']) if (existsSync(fileURLToPath(base + ext))) return next(base + ext, context);
47
+ }
48
+ return next(specifier, context);
49
+ }`;
50
+ register(`data:text/javascript,${encodeURIComponent(hooks)}`);
51
+ const { syncGround } = await import('../engine3d/world3d.js');
52
+ const { groundHalf, colliderHalf } = await import('../engine3d/groundsize.js');
53
+ const { Physics3DSystem } = await import('../systems/physics3d.js');
54
+
55
+ let checks = 0;
56
+ function equal(a, b, message) {
57
+ checks++;
58
+ assert.deepEqual(a, b, message);
59
+ }
60
+
61
+ // The rule a native engine follows too.
62
+ equal([undefined, null, {}, { half: '150' }, { half: NaN }, { half: Infinity }].map(groundHalf), [null, null, null, null, null, null], 'no usable half');
63
+ equal([{ half: 150 }, { half: 0 }, { half: -5 }, { half: 1e6 }, { half: 37.5 }].map(groundHalf), [150, 1, 1, 200, 37.5], 'half clamps to 1..200');
64
+ equal([undefined, { color: '#fff' }, { half: 150 }].map(colliderHalf), [100, 100, 150], 'collider falls back to 100');
65
+
66
+ // The world as makeWorld3D's addGround leaves it.
67
+ function makeWorld() {
68
+ const scene = new THREE.Scene();
69
+ const ground = new THREE.Mesh(new THREE.PlaneGeometry(60, 60), new THREE.MeshStandardMaterial());
70
+ const grid = new THREE.GridHelper(60, 60, 0x505050, 0x505050);
71
+ scene.add(ground, grid);
72
+ return { scene, ground, grid, renderer: { dispose() {} }, nodes: new Map(), syncDepth: 0, generation: 0 };
73
+ }
74
+ const width = (mesh) => mesh.geometry.parameters.width;
75
+ const gridSpan = (grid) => {
76
+ grid.geometry.computeBoundingBox();
77
+ const box = grid.geometry.boundingBox;
78
+ return [box.max.x - box.min.x, box.max.z - box.min.z, grid.geometry.attributes.position.count];
79
+ };
80
+
81
+ {
82
+ const world = makeWorld();
83
+ const plane = world.ground.geometry;
84
+ const lines = world.grid.geometry;
85
+ syncGround(world, { color: '#445566', tile: 4 });
86
+ equal(world.ground.geometry === plane && world.grid.geometry === lines, true, 'no half: the plane and grid are untouched');
87
+ syncGround(world, null);
88
+ equal(world.ground.geometry === plane && world.grid.geometry === lines, true, 'no ground setting: untouched');
89
+
90
+ syncGround(world, { half: 150 });
91
+ equal(width(world.ground), 300, 'half 150 draws a 300 m plane');
92
+ equal(gridSpan(world.grid), [300, 300, 2 * 2 * 301], 'and a 300 m grid of 1 m cells');
93
+ const wide = world.ground.geometry;
94
+ syncGround(world, { half: 150, color: '#123456' });
95
+ equal(world.ground.geometry, wide, 'a restyle at the same half keeps the plane');
96
+
97
+ syncGround(world, { half: 1e6 });
98
+ equal(width(world.ground), 400, 'half clamps to 200');
99
+ syncGround(world, { color: '#445566' });
100
+ equal(width(world.ground), 60, 'dropping the key goes back to 60 m');
101
+ equal(gridSpan(world.grid), [60, 60, 2 * 2 * 61]);
102
+ }
103
+
104
+ // The physics system's collider.
105
+ async function collider(ground) {
106
+ globalThis.__cuboids = [];
107
+ const system = new Physics3DSystem();
108
+ system.attach({});
109
+ await new Promise((resolve) => setTimeout(resolve, 0));
110
+ const scene = { data: ground === undefined ? {} : { ground }, actors: [], getActors: () => [], getActor: () => null };
111
+ system.afterBehaviors(scene, 1 / 60);
112
+ return globalThis.__cuboids;
113
+ }
114
+ equal(await collider(undefined), [[100, 0.5, 100]], 'no ground setting: 100 m each way');
115
+ equal(await collider({ color: '#fff' }), [[100, 0.5, 100]], 'no half: 100 m each way');
116
+ equal(await collider({ half: 150 }), [[150, 0.5, 150]], 'half 150: 150 m each way');
117
+ equal(await collider({ half: 500 }), [[200, 0.5, 200]], 'clamped to 200');
118
+ equal(await collider({ none: true, half: 150 }), [], 'none: no collider');
119
+
120
+ console.log(`ground half: ${checks} checks (plane, grid, collider; absent key untouched)`);