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,96 @@
1
+ // The player's clock: which animation frames run a frame, and the dt each one
2
+ // that runs is handed. Without a cap (`runtime.maxFps` 0) every animation
3
+ // frame runs and is handed the time since the last one, at most 0.033 s, as
4
+ // the loop always did. With `"engine": { "maxFps": n }` (the kit's CLAUDE.md
5
+ // has the terms) a frame runs only once at least RUN_SHARE of 1/n seconds has
6
+ // passed since the last frame that ran -- by time, never by counting frames --
7
+ // and is handed all the time since that frame, so nothing skipped is lost:
8
+ // neither time (up to what physics can step, below) nor input (a key pressed
9
+ // and let go, or a drag begun and ended, between two frames that run is lent
10
+ // to the next one, `updateLending`).
11
+
12
+ // The longest step a frame is handed without a cap, in seconds.
13
+ export const MAX_DT = 0.033;
14
+
15
+ // The longest step a capped frame is handed: three of the physics system's
16
+ // fixed 1/60 s steps (`systems/physics3d.js`). It steps at most four a frame
17
+ // and throws away whatever is left once it has taken four, so a frame handed
18
+ // more than 3/60 s, on top of the less than 1/60 s it may carry over, could
19
+ // leave physics behind the behaviours' clock. A cap of 30 (the lowest there
20
+ // is) has frames 1/30 s apart, under this; it cuts only a late frame, as
21
+ // MAX_DT does without a cap.
22
+ export const MAX_CAPPED_DT = 3 / 60;
23
+
24
+ // The share of the cap's interval that must have passed. A refresh timestamp
25
+ // only ever lands on the display's own vsync, so the rule picks a whole number
26
+ // of refreshes per frame, and RUN_SHARE decides which: at 60 the threshold is
27
+ // 13.0 ms, which a 60 Hz display passes on every refresh even with timestamps
28
+ // 1.8 ms early or late; 75 Hz (13.3 ms) too; 90, 120 and 144 Hz every second
29
+ // refresh (11.1, 8.3 and 6.9 ms do not pass, twice that does): 45, 60 and 72
30
+ // fps; 165 and 180 Hz every third, 240 Hz every fourth: 55, 60, 60 fps. Each
31
+ // is a steady cadence, one dt every frame. It sits between the multiples of
32
+ // the common refresh periods (11.1, 12.1 and 12.5 ms below it, 13.3 and 13.9
33
+ // above), not on one, where a display would alternate.
34
+ export const RUN_SHARE = 0.78;
35
+
36
+ export function makeFrameClock(now) {
37
+ return { previousTime: now, ran: false };
38
+ }
39
+
40
+ // The dt for the animation frame at `now` (its requestAnimationFrame
41
+ // timestamp), or null when it is skipped. The first frame a clock sees always
42
+ // runs.
43
+ export function nextFrame(clock, now, maxFps) {
44
+ if (maxFps > 0 && clock.ran && now - clock.previousTime < (RUN_SHARE * 1000) / maxFps) return null;
45
+ const dt = Math.min(maxFps > 0 ? MAX_CAPPED_DT : MAX_DT, (now - clock.previousTime) / 1000);
46
+ clock.previousTime = now;
47
+ clock.ran = true;
48
+ return dt;
49
+ }
50
+
51
+ // What the input handlers keep for the next frame that runs, under a cap
52
+ // only: every key that went down (`keys`, codes and key names as
53
+ // `runtime.keys` holds them) and the drag stick's last direction while a
54
+ // drag held it (`stick`). Without a cap the handlers write nothing here.
55
+ export function makeInputLatch() {
56
+ return { keys: new Set(), stick: null };
57
+ }
58
+
59
+ // Runs `runtime.update(dt)` for a capped frame with what went down since the
60
+ // last frame that ran lent to it: a key in `latch.keys` that is no longer held
61
+ // is in `runtime.keys` for this update, and when no drag holds the stick now,
62
+ // the last direction a drag gave it since that frame is in
63
+ // `runtime.moveInput`. Afterwards both are as the handlers left them: lent
64
+ // keys come out of `runtime.keys` and a lent stick goes back to rest. The latch is emptied
65
+ // either way. So a press shorter than the frames that were skipped is seen
66
+ // by exactly one frame, as it would have been without the cap; a key held
67
+ // across it is seen as held, as always. A tap's jump, the grab key and the
68
+ // hub's buttons are latches or handlers of their own and lose nothing.
69
+ export function updateLending(runtime, latch, dt) {
70
+ const keys = runtime.keys;
71
+ const move = runtime.moveInput;
72
+ const lent = [];
73
+ for (const code of latch.keys) {
74
+ if (keys.has(code)) continue;
75
+ keys.add(code);
76
+ lent.push(code);
77
+ }
78
+ latch.keys.clear();
79
+ const stick = latch.stick && move && !move.active ? latch.stick : null;
80
+ latch.stick = null;
81
+ if (stick) {
82
+ move.active = true;
83
+ move.x = stick.x;
84
+ move.y = stick.y;
85
+ }
86
+ try {
87
+ runtime.update(dt);
88
+ } finally {
89
+ for (const code of lent) keys.delete(code);
90
+ if (stick) {
91
+ move.active = false;
92
+ move.x = 0;
93
+ move.y = 0;
94
+ }
95
+ }
96
+ }
@@ -0,0 +1,118 @@
1
+ // Browser entries select the deck's gait; engine modules remain usable in Node.
2
+ import * as THREE from 'three';
3
+
4
+ const STOP_SPEED = 0.05;
5
+ const HINT_MAX_AGE_MS = 100;
6
+
7
+ let mode = 'fixed';
8
+ export function setWalkGait(value) {
9
+ mode = value === 'model' ? 'model' : 'fixed';
10
+ }
11
+ export function walkGait() {
12
+ return mode;
13
+ }
14
+
15
+ // One hint is shared by the biped and motion passes, then forgotten. Even an
16
+ // invalid hint is removed so a reused actor never inherits old network timing.
17
+ export function takeWalkSpeedHint(node, now = typeof performance === 'undefined' ? undefined : performance.now()) {
18
+ const speed = node.userData.walkSpeedHint;
19
+ const time = node.userData.walkTimeHint;
20
+ const at = node.userData.walkHintAt;
21
+ delete node.userData.walkSpeedHint;
22
+ delete node.userData.walkTimeHint;
23
+ delete node.userData.walkHintAt;
24
+ const age = now - at;
25
+ if (!Number.isFinite(now) || !Number.isFinite(at) || age < 0 || age > HINT_MAX_AGE_MS) return undefined;
26
+ return Number.isFinite(speed) ? { speed: Math.max(0, speed), time } : undefined;
27
+ }
28
+
29
+ // Bounds of visible geometry only (outlines and hidden pattern parts excluded).
30
+ function boundsOf(node) {
31
+ const bounds = new THREE.Box3();
32
+ const box = new THREE.Box3();
33
+ const visit = (object) => {
34
+ if (!object.visible) return;
35
+ if (object.isMesh && !object.userData.lookOutline) {
36
+ object.geometry.computeBoundingBox();
37
+ box.copy(object.geometry.boundingBox).applyMatrix4(object.matrixWorld);
38
+ bounds.union(box);
39
+ }
40
+ for (const child of object.children) visit(child);
41
+ };
42
+ visit(node);
43
+ return bounds;
44
+ }
45
+
46
+ // Cache the rest-pose world leg length, including fitHeight's inner group and
47
+ // the actor/model scales. Remeasure on replacement or a scale change, with the
48
+ // legs briefly restored to their first pose so a swing cannot shorten the read.
49
+ function measureLegs(node, state, ids) {
50
+ const parts = node.userData.modelParts;
51
+ const rig = node.children[0];
52
+ const scale = [...node.scale.toArray(), ...(rig?.scale.toArray() ?? [])];
53
+ const old = state.gait;
54
+ if (old?.parts === parts && old.rig === rig && scale.every((v, i) => v === old.scale[i])) return old;
55
+ const legs = ids.map((id) => parts?.get(id)).filter(Boolean);
56
+ const rest = old?.parts === parts && old.rig === rig ? old.rest : legs.map((leg) => leg.quaternion.clone());
57
+ const posed = legs.map((leg) => leg.quaternion.clone());
58
+ let length = 0;
59
+ try {
60
+ legs.forEach((leg, i) => leg.quaternion.copy(rest[i]));
61
+ node.updateWorldMatrix(true, true);
62
+ for (const leg of legs) {
63
+ const bounds = boundsOf(leg);
64
+ const hip = new THREE.Vector3().setFromMatrixPosition(leg.matrixWorld);
65
+ const below = hip.y - bounds.min.y;
66
+ if (Number.isFinite(below) && below > 0) length = Math.max(length, below);
67
+ }
68
+ if (!(length > 0)) {
69
+ const bounds = boundsOf(node);
70
+ const height = bounds.max.y - bounds.min.y;
71
+ if (Number.isFinite(height) && height > 0) length = 0.45 * height;
72
+ }
73
+ } finally {
74
+ legs.forEach((leg, i) => leg.quaternion.copy(posed[i]));
75
+ node.updateWorldMatrix(true, true);
76
+ }
77
+ return (state.gait = { parts, rig, scale, rest, length });
78
+ }
79
+
80
+ // Both walkers use the same world-length stride and adaptive swing. Cadence,
81
+ // rather than metres per second, is capped so ordinary hub running keeps up.
82
+ // Air and lean still observe actual position and elapsed time.
83
+ export function modelWalk(node, state, ids, baseAmplitude, observedSpeed, dt, hint) {
84
+ const gait = measureLegs(node, state, ids);
85
+ const cycle = 4 * gait.length * Math.sin(baseAmplitude);
86
+ const scale = cycle / (2 * Math.PI / 2.4);
87
+ const model = cycle > 0 && Number.isFinite(cycle) && 5 * scale > 0 && Number.isFinite(5 * scale);
88
+ if (!model) {
89
+ // The animators branch back to their original arithmetic when no length
90
+ // can be read, including the original distance cap and elapsed time.
91
+ Object.assign(gait, { model: false, k: 2.4, walkSpeed: 5, cap: 8,
92
+ amplitude: baseAmplitude, amplitudeScale: 1 });
93
+ return gait;
94
+ }
95
+ const supplied = Number.isFinite(hint?.speed) ? hint.speed : observedSpeed;
96
+ const speed = Number.isFinite(supplied) ? Math.max(0, Math.min(30, supplied)) : 0;
97
+ const softCadence = 4.5;
98
+ const amplitude = speed <= cycle * softCadence ? baseAmplitude
99
+ : Math.min(baseAmplitude + 0.3, Math.asin(Math.min(1, speed / (4 * gait.length * softCadence))));
100
+ const targetAmount = Math.min(1, speed / (5 * scale));
101
+ // The rendered angle includes the swing amount. Use its target (not the
102
+ // eased startup pose), avoiding both low-speed slip and startup spikes.
103
+ const effectiveAmplitude = amplitude * targetAmount;
104
+ const stride = 4 * gait.length * Math.sin(effectiveAmplitude);
105
+ // This replaces the rad/metre clamp: even a tiny/broken model cannot blur
106
+ // beyond six cycles a second. Division overflow also lands on this bound.
107
+ const cadence = speed < STOP_SPEED ? 0 : Math.min(6, speed / stride);
108
+ Object.assign(gait, { model: true, k: stride > 0 ? 2 * Math.PI / stride : 2.4, walkSpeed: 5 * scale,
109
+ cap: 30, cadence, amplitude, effectiveAmplitude, targetAmount, amplitudeScale: amplitude / baseAmplitude });
110
+ return {
111
+ ...gait,
112
+ speed,
113
+ dt: Number.isFinite(dt) && dt > 0 ? Math.min(dt, 0.1) : 0,
114
+ // Only network-driven phase follows real time; pose easing uses engine dt.
115
+ phaseDt: Number.isFinite(hint?.time) ? Math.max(0, Math.min(hint.time, 0.25))
116
+ : Number.isFinite(dt) && dt > 0 ? Math.min(dt, 0.1) : 0,
117
+ };
118
+ }
@@ -0,0 +1,47 @@
1
+ // The shader hooks the kit itself puts on lit materials (look.js's rim and
2
+ // occlusion, optimize.js's per-vertex finish, materialpresets.js's glow by
3
+ // colour), so the orbit camera's shadow fade (shadowfade.js) knows which
4
+ // `onBeforeCompile` and `customProgramCacheKey` it may run for its own
5
+ // variant of a material, and which `onBeforeRender` it may leave on one. Each of these only edits the shader it is handed
6
+ // and adds uniform objects the kit owns; none stores anything on the
7
+ // material or anywhere reachable from it, so running it for a variant
8
+ // changes nothing another world can see.
9
+ //
10
+ // A hook is known when it is three.js's own (the empty default) or was
11
+ // marked here when it was put on, and the hooks it wraps (`previous`) were
12
+ // known then. A material whose hook or key function is anything else (a
13
+ // deck's own) is never given a variant: it is drawn as it is, unfaded.
14
+ //
15
+ // Marking puts the functions in a WeakSet; nothing is written on the
16
+ // material or the function.
17
+ import * as THREE from 'three';
18
+
19
+ const known = new WeakSet();
20
+
21
+ const DEFAULT_HOOK = THREE.Material.prototype.onBeforeCompile;
22
+ const DEFAULT_KEY = THREE.Material.prototype.customProgramCacheKey;
23
+ const DEFAULT_DRAW = THREE.Material.prototype.onBeforeRender;
24
+
25
+ export function knownCompileHook(hook) {
26
+ return hook === DEFAULT_HOOK || known.has(hook);
27
+ }
28
+
29
+ export function knownProgramKey(key) {
30
+ return key === DEFAULT_KEY || known.has(key);
31
+ }
32
+
33
+ // A material's `onBeforeRender`: three's own. (The kit's one material
34
+ // callback, look.js's outline, is on an unlit material, never faded.)
35
+ export function knownDrawCallback(callback) {
36
+ return callback === DEFAULT_DRAW;
37
+ }
38
+
39
+ // After the kit has put its hook and key function on `material`. `previous`
40
+ // hooks are what it had, the hook and key the new ones call; null when
41
+ // the new ones call nothing of the material's. Plain arguments avoid a
42
+ // bookkeeping object on every material, including keyless materials.
43
+ export function markKitHooks(material, previousHook = null, previousKey = null) {
44
+ if (previousHook !== null && !(knownCompileHook(previousHook) && knownProgramKey(previousKey))) return;
45
+ known.add(material.onBeforeCompile);
46
+ known.add(material.customProgramCacheKey);
47
+ }