castle-web-cli 0.4.232 → 0.4.233

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (355) hide show
  1. package/dist/agent-failures.d.ts +8 -0
  2. package/dist/agent-failures.js +19 -2
  3. package/dist/agent-prompts.d.ts +1 -1
  4. package/dist/agent-prompts.js +10 -3
  5. package/dist/agent.d.ts +64 -3
  6. package/dist/agent.js +170 -81
  7. package/dist/castle-host/host.d.ts +1 -0
  8. package/dist/castle-host/host.js +51 -3
  9. package/dist/castleJson.d.ts +4 -2
  10. package/dist/castleJson.js +2 -0
  11. package/dist/check.d.ts +3 -1
  12. package/dist/check.js +11 -1
  13. package/dist/devSessionStorage.js +47 -1
  14. package/dist/importPinMismatch.d.ts +22 -0
  15. package/dist/importPinMismatch.js +77 -0
  16. package/dist/importRegression.js +3 -15
  17. package/dist/imports.d.ts +10 -3
  18. package/dist/imports.js +88 -20
  19. package/dist/index.js +5 -4
  20. package/dist/init.js +1 -1
  21. package/dist/platformDoc.js +22 -0
  22. package/dist/routerFences.d.ts +5 -0
  23. package/dist/routerFences.js +12 -2
  24. package/dist/save-deck.d.ts +5 -0
  25. package/dist/save-deck.js +37 -4
  26. package/dist/serve.js +3 -0
  27. package/dist/shell/assets/{index-D2tWM896.js → index-BjOxR-lW.js} +4 -4
  28. package/dist/shell/assets/index-MVLfNYd9.css +1 -0
  29. package/dist/shell/index.html +2 -2
  30. package/dist/taskSteer.d.ts +13 -0
  31. package/dist/taskSteer.js +22 -2
  32. package/kits/base/castle.json +1 -1
  33. package/kits/base/package-lock.json +1 -1
  34. package/kits/base/sdk/README.md +79 -2
  35. package/kits/base/sdk/avatar.d.ts +6 -2
  36. package/kits/base/sdk/avatar.js +12 -4
  37. package/kits/base/sdk/castle.d.ts +1 -1
  38. package/kits/base/sdk/commands.d.ts +14 -0
  39. package/kits/base/sdk/hub.d.ts +6 -2
  40. package/kits/base/sdk/hub.js +13 -0
  41. package/kits/base/sdk/multiplayer.js +17 -1
  42. package/kits/base/sdk/save.js +2 -1
  43. package/kits/base/sdk/server/hub.d.ts +87 -0
  44. package/kits/base/sdk/server/hub.js +70 -0
  45. package/kits/base/sdk/server/platformHandle.d.ts +31 -1
  46. package/kits/base/sdk/server/storage.d.ts +13 -0
  47. package/kits/base/sdk/server/storage.js +46 -0
  48. package/kits/base/sdk/server/wrapper.d.ts +36 -5
  49. package/kits/base/sdk/server/wrapper.js +83 -8
  50. package/kits/hub-game/CLAUDE.md +329 -11
  51. package/kits/hub-game/blueprints/avatar-10.scene +28 -0
  52. package/kits/hub-game/blueprints/avatar-11.scene +28 -0
  53. package/kits/hub-game/blueprints/avatar-12.scene +28 -0
  54. package/kits/hub-game/blueprints/avatar-13.scene +28 -0
  55. package/kits/hub-game/blueprints/avatar-14.scene +28 -0
  56. package/kits/hub-game/blueprints/avatar-15.scene +28 -0
  57. package/kits/hub-game/blueprints/avatar-4.scene +28 -0
  58. package/kits/hub-game/blueprints/avatar-5.scene +28 -0
  59. package/kits/hub-game/blueprints/avatar-6.scene +28 -0
  60. package/kits/hub-game/blueprints/avatar-7.scene +28 -0
  61. package/kits/hub-game/blueprints/avatar-8.scene +28 -0
  62. package/kits/hub-game/blueprints/avatar-9.scene +28 -0
  63. package/kits/hub-game/code/client/actorBudget.js +47 -0
  64. package/kits/hub-game/code/client/attention.js +11 -2
  65. package/kits/hub-game/code/client/avatar.js +309 -35
  66. package/kits/hub-game/code/client/avatarCap.js +228 -0
  67. package/kits/hub-game/code/client/avatarColors.js +70 -0
  68. package/kits/hub-game/code/client/avatarFaces.js +21 -0
  69. package/kits/hub-game/code/client/avatarShare.js +251 -0
  70. package/kits/hub-game/code/client/ballot.js +467 -0
  71. package/kits/hub-game/code/client/build.js +22 -0
  72. package/kits/hub-game/code/client/chrome.js +1144 -50
  73. package/kits/hub-game/code/client/companion.js +716 -0
  74. package/kits/hub-game/code/client/companionDress.js +99 -0
  75. package/kits/hub-game/code/client/decor.js +509 -0
  76. package/kits/hub-game/code/client/earned.js +131 -0
  77. package/kits/hub-game/code/client/emoteBubble.js +75 -0
  78. package/kits/hub-game/code/client/grab.js +339 -20
  79. package/kits/hub-game/code/client/hookLayer.js +299 -13
  80. package/kits/hub-game/code/client/idle.js +163 -22
  81. package/kits/hub-game/code/client/interestCap.js +81 -0
  82. package/kits/hub-game/code/client/keys.js +36 -0
  83. package/kits/hub-game/code/client/labelsNear.js +205 -0
  84. package/kits/hub-game/code/client/menuIcons.js +34 -0
  85. package/kits/hub-game/code/client/pack.js +6 -2
  86. package/kits/hub-game/code/client/packFormat.js +3 -3
  87. package/kits/hub-game/code/client/rehello.js +167 -0
  88. package/kits/hub-game/code/client/shot.js +92 -0
  89. package/kits/hub-game/code/client/sound.js +63 -8
  90. package/kits/hub-game/code/client/soundscape.js +1151 -0
  91. package/kits/hub-game/code/client/soundscapeActions.js +99 -0
  92. package/kits/hub-game/code/client/soundscapeAmbience.js +453 -0
  93. package/kits/hub-game/code/client/soundscapeBaked.js +143 -0
  94. package/kits/hub-game/code/client/soundscapeBusker.js +217 -0
  95. package/kits/hub-game/code/client/soundscapeCourt.js +200 -0
  96. package/kits/hub-game/code/client/soundscapeCrowd.js +331 -0
  97. package/kits/hub-game/code/client/soundscapeCues.js +362 -0
  98. package/kits/hub-game/code/client/soundscapeMap.js +181 -0
  99. package/kits/hub-game/code/client/soundscapeMarket.js +176 -0
  100. package/kits/hub-game/code/client/soundscapeMusic.js +126 -0
  101. package/kits/hub-game/code/client/soundscapeMusicEngine.js +460 -0
  102. package/kits/hub-game/code/client/soundscapeSimlish.js +737 -0
  103. package/kits/hub-game/code/client/soundscapeSongs.js +127 -0
  104. package/kits/hub-game/code/client/soundscapeSongsRound3.js +63 -0
  105. package/kits/hub-game/code/client/soundscapeSynthesis.js +168 -0
  106. package/kits/hub-game/code/client/soundscapeUi.js +211 -0
  107. package/kits/hub-game/code/client/soundscapeVoice.js +1209 -0
  108. package/kits/hub-game/code/client/soundscapeWaves.js +206 -0
  109. package/kits/hub-game/code/client/spin.js +101 -0
  110. package/kits/hub-game/code/client/state.js +109 -1
  111. package/kits/hub-game/code/client/stuck.js +259 -0
  112. package/kits/hub-game/code/client/talk.js +538 -47
  113. package/kits/hub-game/code/client/tiers.js +516 -27
  114. package/kits/hub-game/code/client/toastBand.js +37 -0
  115. package/kits/hub-game/code/client/together.js +32 -0
  116. package/kits/hub-game/code/client/visibility.js +43 -0
  117. package/kits/hub-game/code/client/wear.js +461 -170
  118. package/kits/hub-game/code/client/yours.js +199 -0
  119. package/kits/hub-game/code/companionSpec.js +45 -0
  120. package/kits/hub-game/code/privateText.js +7 -0
  121. package/kits/hub-game/code/server/actions.js +133 -0
  122. package/kits/hub-game/code/server/actors.js +9 -1
  123. package/kits/hub-game/code/server/ask.js +155 -0
  124. package/kits/hub-game/code/server/ballot.js +539 -0
  125. package/kits/hub-game/code/server/cells.js +100 -0
  126. package/kits/hub-game/code/server/companion.js +82 -0
  127. package/kits/hub-game/code/server/cues.js +70 -0
  128. package/kits/hub-game/code/server/decor.js +269 -0
  129. package/kits/hub-game/code/server/earned.js +461 -0
  130. package/kits/hub-game/code/server/friendBests.js +166 -0
  131. package/kits/hub-game/code/server/friendsAmong.js +232 -0
  132. package/kits/hub-game/code/server/history.js +5 -0
  133. package/kits/hub-game/code/server/hub.js +1254 -50
  134. package/kits/hub-game/code/server/idle.js +30 -11
  135. package/kits/hub-game/code/server/index.js +2 -2
  136. package/kits/hub-game/code/server/labels.js +28 -2
  137. package/kits/hub-game/code/server/manifest.js +378 -7
  138. package/kits/hub-game/code/server/menu.js +133 -0
  139. package/kits/hub-game/code/server/npcs.js +830 -80
  140. package/kits/hub-game/code/server/party.js +2 -2
  141. package/kits/hub-game/code/server/players.js +22 -0
  142. package/kits/hub-game/code/server/shot.js +110 -0
  143. package/kits/hub-game/code/server/standing.js +124 -0
  144. package/kits/hub-game/code/server/vis.js +113 -0
  145. package/kits/hub-game/code/server/wear.js +12 -0
  146. package/kits/hub-game/code/server/yours.js +59 -0
  147. package/kits/hub-game/code/shared/cues.js +9 -0
  148. package/kits/hub-game/code/shared/decor.js +41 -0
  149. package/kits/hub-game/code/shared/shot.js +19 -0
  150. package/kits/hub-game/code/shared/spin.js +57 -0
  151. package/kits/hub-game/code/systems/hub.js +845 -95
  152. package/kits/hub-game/docs/content-pack.md +1 -1
  153. package/kits/hub-game/docs/contract.md +2244 -61
  154. package/kits/hub-game/docs/home-pieces.md +64 -0
  155. package/kits/hub-game/models/avatar-10.pxmodel +28 -0
  156. package/kits/hub-game/models/avatar-11.pxmodel +28 -0
  157. package/kits/hub-game/models/avatar-12.pxmodel +27 -0
  158. package/kits/hub-game/models/avatar-13.pxmodel +24 -0
  159. package/kits/hub-game/models/avatar-14.pxmodel +29 -0
  160. package/kits/hub-game/models/avatar-15.pxmodel +24 -0
  161. package/kits/hub-game/models/avatar-4.pxmodel +29 -0
  162. package/kits/hub-game/models/avatar-5.pxmodel +27 -0
  163. package/kits/hub-game/models/avatar-6.pxmodel +26 -0
  164. package/kits/hub-game/models/avatar-7.pxmodel +25 -0
  165. package/kits/hub-game/models/avatar-8.pxmodel +24 -0
  166. package/kits/hub-game/models/avatar-9.pxmodel +30 -0
  167. package/kits/hub-game/models/earned/badge-round.pxmodel +100 -0
  168. package/kits/hub-game/models/earned/badge-shield.pxmodel +117 -0
  169. package/kits/hub-game/models/earned/badge-star.pxmodel +87 -0
  170. package/kits/hub-game/models/earned/belt-plain.pxmodel +72 -0
  171. package/kits/hub-game/models/earned/held-ball.pxmodel +43 -0
  172. package/kits/hub-game/models/earned/held-lantern.pxmodel +85 -0
  173. package/kits/hub-game/models/earned/held-net.pxmodel +57 -0
  174. package/kits/hub-game/models/earned/held-trophy.pxmodel +109 -0
  175. package/kits/hub-game/models/earned/pin-round.pxmodel +62 -0
  176. package/kits/hub-game/models/earned/sash-plain.pxmodel +66 -0
  177. package/kits/hub-game/models/earned/square/belt-plain.pxmodel +104 -0
  178. package/kits/hub-game/models/earned/square/sash-plain.pxmodel +98 -0
  179. package/kits/hub-game/models/hats/bat-clip.pxmodel +206 -0
  180. package/kits/hub-game/models/hats/beekeeper.pxmodel +149 -0
  181. package/kits/hub-game/models/hats/cap.pxmodel +162 -0
  182. package/kits/hub-game/models/hats/captain.pxmodel +178 -0
  183. package/kits/hub-game/models/hats/crooked-top.pxmodel +172 -0
  184. package/kits/hub-game/models/hats/flower-crown.pxmodel +451 -0
  185. package/kits/hub-game/models/hats/foam-crown.pxmodel +179 -0
  186. package/kits/hub-game/models/hats/lantern.pxmodel +230 -0
  187. package/kits/hub-game/models/hats/laurel.pxmodel +533 -0
  188. package/kits/hub-game/models/hats/lighthouse.pxmodel +96 -0
  189. package/kits/hub-game/models/hats/sailor.pxmodel +141 -0
  190. package/kits/hub-game/models/hats/souwester.pxmodel +131 -0
  191. package/kits/hub-game/models/hats/straw.pxmodel +139 -0
  192. package/kits/hub-game/models/hats/sunflower.pxmodel +406 -0
  193. package/kits/hub-game/models/hats/sweatband.pxmodel +112 -0
  194. package/kits/hub-game/models/hats/witch.pxmodel +147 -0
  195. package/kits/hub-game/package-lock.json +2 -0
  196. package/kits/hub-game/package.json +2 -1
  197. package/kits/hub-game/scripts/check.mjs +78 -11
  198. package/kits/hub-game/scripts/companion-follower-wire.json +1 -0
  199. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +121 -0
  200. package/kits/hub-game/scripts/fixtures/decor-keyless.json +293 -0
  201. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +23 -0
  202. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +107 -0
  203. package/kits/hub-game/scripts/fixtures/interest-legacy.json +385 -0
  204. package/kits/hub-game/scripts/fixtures/npc-notes-v1.77.jsonl +4 -0
  205. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -0
  206. package/kits/hub-game/scripts/gen-avatars.mjs +933 -16
  207. package/kits/hub-game/scripts/gen-earned.mjs +285 -0
  208. package/kits/hub-game/scripts/gen-hats.mjs +827 -0
  209. package/kits/hub-game/scripts/grab.before-orbit.mjs +400 -0
  210. package/kits/hub-game/scripts/soundscape-wave-analysis.mjs +125 -0
  211. package/kits/hub-game/scripts/test-actions-client.mjs +488 -0
  212. package/kits/hub-game/scripts/test-actions.mjs +298 -0
  213. package/kits/hub-game/scripts/test-actor-budget.mjs +44 -0
  214. package/kits/hub-game/scripts/test-actors.mjs +19 -17
  215. package/kits/hub-game/scripts/test-ask-client.mjs +358 -0
  216. package/kits/hub-game/scripts/test-ask.mjs +269 -0
  217. package/kits/hub-game/scripts/test-attention.mjs +10 -1
  218. package/kits/hub-game/scripts/test-avatar-cap.mjs +379 -0
  219. package/kits/hub-game/scripts/test-avatar-colors.mjs +72 -0
  220. package/kits/hub-game/scripts/test-avatar-models.mjs +181 -0
  221. package/kits/hub-game/scripts/test-avatar-share.mjs +318 -0
  222. package/kits/hub-game/scripts/test-avatar-wire.mjs +753 -0
  223. package/kits/hub-game/scripts/test-avatar.mjs +540 -7
  224. package/kits/hub-game/scripts/test-ballot.mjs +1001 -0
  225. package/kits/hub-game/scripts/test-build.mjs +31 -0
  226. package/kits/hub-game/scripts/test-cells.mjs +71 -0
  227. package/kits/hub-game/scripts/test-chat.mjs +662 -0
  228. package/kits/hub-game/scripts/test-classic.mjs +2 -0
  229. package/kits/hub-game/scripts/test-companion-chat.mjs +198 -0
  230. package/kits/hub-game/scripts/test-companion-client.mjs +1167 -0
  231. package/kits/hub-game/scripts/test-companion.mjs +259 -0
  232. package/kits/hub-game/scripts/test-decor-client.mjs +303 -0
  233. package/kits/hub-game/scripts/test-decor.mjs +457 -0
  234. package/kits/hub-game/scripts/test-earned-client.mjs +459 -0
  235. package/kits/hub-game/scripts/test-earned.mjs +1194 -0
  236. package/kits/hub-game/scripts/test-emote-bubble.mjs +110 -0
  237. package/kits/hub-game/scripts/test-friend-bests.mjs +435 -0
  238. package/kits/hub-game/scripts/test-grab-orbit.mjs +918 -0
  239. package/kits/hub-game/scripts/test-grab.mjs +7 -0
  240. package/kits/hub-game/scripts/test-hats.mjs +422 -168
  241. package/kits/hub-game/scripts/test-hub-leaving.mjs +203 -0
  242. package/kits/hub-game/scripts/test-hub-ops.mjs +439 -2
  243. package/kits/hub-game/scripts/test-hub-trip.mjs +716 -2
  244. package/kits/hub-game/scripts/test-hud-clear.mjs +328 -4
  245. package/kits/hub-game/scripts/test-idle.mjs +361 -1
  246. package/kits/hub-game/scripts/test-interest-cap.mjs +36 -0
  247. package/kits/hub-game/scripts/test-interest-cells.mjs +493 -0
  248. package/kits/hub-game/scripts/test-interest-client.mjs +118 -0
  249. package/kits/hub-game/scripts/test-keys.mjs +46 -1
  250. package/kits/hub-game/scripts/test-labels.mjs +596 -0
  251. package/kits/hub-game/scripts/test-manifest.mjs +207 -0
  252. package/kits/hub-game/scripts/test-menu-client.mjs +480 -0
  253. package/kits/hub-game/scripts/test-menu.mjs +296 -0
  254. package/kits/hub-game/scripts/test-npcs.mjs +1718 -12
  255. package/kits/hub-game/scripts/test-object-entry.mjs +76 -0
  256. package/kits/hub-game/scripts/test-pack.mjs +7 -0
  257. package/kits/hub-game/scripts/test-picker.mjs +314 -0
  258. package/kits/hub-game/scripts/test-rehello.mjs +1039 -0
  259. package/kits/hub-game/scripts/test-relations-among.mjs +222 -0
  260. package/kits/hub-game/scripts/test-relations-refresh.mjs +188 -0
  261. package/kits/hub-game/scripts/test-shot.mjs +756 -0
  262. package/kits/hub-game/scripts/test-soundscape.mjs +5432 -0
  263. package/kits/hub-game/scripts/test-spin.mjs +314 -0
  264. package/kits/hub-game/scripts/test-standing.mjs +416 -0
  265. package/kits/hub-game/scripts/test-stuck.mjs +1903 -0
  266. package/kits/hub-game/scripts/test-tier-cells.mjs +706 -0
  267. package/kits/hub-game/scripts/test-tiers-render.mjs +339 -0
  268. package/kits/hub-game/scripts/test-tiers.mjs +477 -2
  269. package/kits/hub-game/scripts/test-toast-band.mjs +61 -0
  270. package/kits/hub-game/scripts/test-try-on.mjs +22 -22
  271. package/kits/hub-game/scripts/test-vis.mjs +343 -0
  272. package/kits/hub-game/scripts/test-visibility.mjs +134 -0
  273. package/kits/hub-game/scripts/test-yours-chrome.mjs +166 -0
  274. package/kits/hub-game/scripts/test-yours.mjs +372 -0
  275. package/kits/multiplayer-3d/CLAUDE.md +50 -0
  276. package/kits/multiplayer-3d/castle.json +5 -5
  277. package/kits/multiplayer-3d/code/client/avatars.js +7 -0
  278. package/kits/multiplayer-3d/code/client/gait.js +65 -0
  279. package/kits/multiplayer-3d/code/client/nameTags.js +59 -4
  280. package/kits/multiplayer-3d/code/options.js +5 -0
  281. package/kits/multiplayer-3d/code/server/ownership.js +10 -2
  282. package/kits/multiplayer-3d/code/server/sceneBodies.js +12 -0
  283. package/kits/multiplayer-3d/code/server/world.js +7 -0
  284. package/kits/multiplayer-3d/code/systems/multiplayer.js +74 -4
  285. package/kits/multiplayer-3d/package.json +2 -1
  286. package/kits/multiplayer-3d/scripts/fixtures/README.md +11 -0
  287. package/kits/multiplayer-3d/scripts/fixtures/ownership-legacy.json +2 -0
  288. package/kits/multiplayer-3d/scripts/ownership-harness.mjs +102 -0
  289. package/kits/multiplayer-3d/scripts/ownership-loader.mjs +46 -0
  290. package/kits/multiplayer-3d/scripts/ownership-worker.mjs +15 -0
  291. package/kits/multiplayer-3d/scripts/record-ownership-session.mjs +98 -0
  292. package/kits/multiplayer-3d/scripts/test-eligible-claims.mjs +167 -0
  293. package/kits/multiplayer-3d/scripts/test-own-name-tag.mjs +247 -0
  294. package/kits/physics-2d/CLAUDE.md +9 -0
  295. package/kits/physics-2d/castle.json +2 -2
  296. package/kits/physics-2d/engine/scene.js +253 -1
  297. package/kits/physics-2d/engine/skyKey.js +129 -0
  298. package/kits/physics-2d/engine/stillClock.js +106 -0
  299. package/kits/physics-2d/engine/updateBudget.js +21 -0
  300. package/kits/physics-2d/scripts/test-skip-unchanged.mjs +326 -1
  301. package/kits/physics-3d/CLAUDE.md +1169 -30
  302. package/kits/physics-3d/behaviors/Player.jsx +629 -72
  303. package/kits/physics-3d/castle.json +3 -3
  304. package/kits/physics-3d/docs/pxmodel-format.md +8 -0
  305. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +69 -13
  306. package/kits/physics-3d/engine3d/actornode.js +86 -0
  307. package/kits/physics-3d/engine3d/animationBudget.js +23 -0
  308. package/kits/physics-3d/engine3d/editorWorld.js +6 -0
  309. package/kits/physics-3d/engine3d/emptynodes.js +232 -0
  310. package/kits/physics-3d/engine3d/framecap.js +96 -0
  311. package/kits/physics-3d/engine3d/gait.js +118 -0
  312. package/kits/physics-3d/engine3d/kithooks.js +47 -0
  313. package/kits/physics-3d/engine3d/look.js +507 -48
  314. package/kits/physics-3d/engine3d/lookbake.js +208 -0
  315. package/kits/physics-3d/engine3d/materialpresets.js +2 -0
  316. package/kits/physics-3d/engine3d/motion.js +39 -10
  317. package/kits/physics-3d/engine3d/nearshadows.js +37 -19
  318. package/kits/physics-3d/engine3d/optimize.js +9 -5
  319. package/kits/physics-3d/engine3d/orbitinput.js +487 -9
  320. package/kits/physics-3d/engine3d/orbitlens.js +48 -0
  321. package/kits/physics-3d/engine3d/ownmodel.js +213 -0
  322. package/kits/physics-3d/engine3d/pxmodel.js +42 -11
  323. package/kits/physics-3d/engine3d/shadowfade.js +882 -0
  324. package/kits/physics-3d/engine3d/sky.js +547 -0
  325. package/kits/physics-3d/engine3d/skylife.js +306 -0
  326. package/kits/physics-3d/engine3d/unchanged.js +11 -0
  327. package/kits/physics-3d/engine3d/viewrange.js +52 -0
  328. package/kits/physics-3d/engine3d/world3d.js +796 -69
  329. package/kits/physics-3d/main.jsx +5 -0
  330. package/kits/physics-3d/package.json +1 -1
  331. package/kits/physics-3d/scripts/look-baseline.mjs +155 -0
  332. package/kits/physics-3d/scripts/test-camera-orbit.mjs +2563 -80
  333. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +1 -1
  334. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +435 -0
  335. package/kits/physics-3d/scripts/test-frame-cap.mjs +452 -0
  336. package/kits/physics-3d/scripts/test-gait.mjs +387 -0
  337. package/kits/physics-3d/scripts/test-look-bake.mjs +1056 -0
  338. package/kits/physics-3d/scripts/test-model-parse-cache.mjs +92 -0
  339. package/kits/physics-3d/scripts/test-near-shadows.mjs +3 -0
  340. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +1920 -0
  341. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +545 -0
  342. package/kits/physics-3d/scripts/test-orbit-shot.mjs +583 -0
  343. package/kits/physics-3d/scripts/test-orbit-view.mjs +230 -0
  344. package/kits/physics-3d/scripts/test-skip-empty-nodes.mjs +845 -0
  345. package/kits/physics-3d/scripts/test-sky.mjs +2470 -0
  346. package/kits/physics-3d/scripts/test-static-actors.mjs +8 -1
  347. package/kits/physics-3d/scripts/test-static-scenery.mjs +2171 -0
  348. package/kits/physics-3d/scripts/test-steady-hover.mjs +2 -0
  349. package/kits/physics-3d/scripts/test-view-range.mjs +260 -0
  350. package/kits/physics-3d/systems/physics3d.js +383 -6
  351. package/kits/real-time/castle.json +2 -2
  352. package/kits/real-time/code/server/gameHooks.js +7 -0
  353. package/kits/real-time/code/server/session.js +97 -19
  354. package/package.json +2 -2
  355. package/dist/shell/assets/index-Cf61cNfT.css +0 -1
@@ -0,0 +1,213 @@
1
+ // Under the orbit camera key (`"engine": { "camera": { "follow": "rigid",
2
+ // "control": "orbit" } }`), the player's own model is left out of a frame
3
+ // whose camera is inside or against it, so the view is not the inside of the
4
+ // avatar (a wall close behind pulls the camera in to 0.6 m of the point it
5
+ // looks at).
6
+ //
7
+ // The invariant: the model's node is hidden only for the duration of one
8
+ // render call: inside try/finally, a plain `visible = false` is the first
9
+ // thing in the try, and the finally's first act is `true` again if it is
10
+ // still false. Nothing else is put on the node, so nothing can throw between
11
+ // the hide and the try that undoes it. Only a node that was shown is
12
+ // hidden (a node anything else hid is not touched), so outside that call
13
+ // nothing of this file's is on any node, and there is nothing to undo on
14
+ // a scene load, a node rebuilt for a new look, a Player turned off or
15
+ // removed, a throw or a dispose. A pass inside the render that saves
16
+ // `visible` and puts it back (false, as it read it) leaves the node shown
17
+ // after it; a `true` written during the render is kept. The one thing not
18
+ // kept: a deck that hides its own player's model with a `false` written
19
+ // from inside the render of a frame this file hid (an onBeforeRender, a
20
+ // composer pass) has it shown again after that render, as that write
21
+ // cannot be told from the value this file put there; a hide written
22
+ // anywhere else (the deck's update, a behavior) is never touched.
23
+ // Accepted: anything that copies the node from inside that one render
24
+ // (clone(), copy(node), toJSON(), its own or a parent's) copies
25
+ // `visible: false`, as it would for any node a deck hides for a frame;
26
+ // three.js treats `visible` as plain state.
27
+ // Objects in `world.ownModelWith` follow the same invariant in that render.
28
+ // The set is read only when the own model is actually hidden. Only shown,
29
+ // writable objects under world.scene are hidden; restoration uses the objects
30
+ // we hid, even if the render removes them from the scene or the set.
31
+ //
32
+ // Who is hidden: the actor the keyed Player placed the camera for this
33
+ // frame, named by `runtime.orbitOwnModel` (behaviors/Player.jsx
34
+ // `placeOrbiting` writes its id after placing the camera). The frame's draw
35
+ // takes the name (the field is undefined again after it), and the physics
36
+ // system's `reset` drops a name left by a frame a scene load followed. So a
37
+ // frame the Player did not place on hides nothing, and only that one actor,
38
+ // the local player, is ever hidden: no other player's model, and nothing is
39
+ // sent anywhere. A runtime that never met the key never has the field, and
40
+ // the play loop then calls `renderWorld` as it always did.
41
+ //
42
+ // What decides: the frame's final camera (`world.camera`, after everything
43
+ // that placed it, the hub's trip cameras included) against the node as it
44
+ // is about to be drawn (`world.nodes`, after syncActors rebuilt or replaced
45
+ // it), measured in world space to the segment from the node's origin (the
46
+ // Transform: the capsule's centre) up to the top of the avatar's head,
47
+ // 0.8 m above it along world +y. Nearer than HIDE_WITHIN it is hidden; once hidden it stays so until
48
+ // the camera is SHOW_PAST away, so a camera resting at the line does not
49
+ // flicker it. The memory of the last frame's choice is kept per world and
50
+ // is only the node's identity: a node rebuilt is judged afresh.
51
+ //
52
+ // The numbers: the Player's own capsule (radius 0.35 m, top 0.7 m above its
53
+ // centre, 0.1 m under the look point) is everywhere within 0.35 m of that
54
+ // segment, and a model sized to it within about half a metre. A camera
55
+ // within 1 m of the segment sees the model filling most of a 50-degree view
56
+ // from closer than its own width, past the near plane (0.1 m) for part of
57
+ // it: that view is the model, not the place. The camera at rest (about 9 m
58
+ // out) and anywhere a player zooms to (3 m nearest) is far outside it; only
59
+ // a camera held in by a wall, or put there by something else, comes inside.
60
+ //
61
+ // Not covered: a model drawn as one of its model's shared instances
62
+ // (`instanceModels` on, a static model: `entry.instancedRig`) is drawn by
63
+ // the instanced mesh syncActors already filled, not under the node, so it
64
+ // is left alone. While hidden the model casts no shadow (three.js draws
65
+ // none for an invisible object, and its shadow pass tests the main
66
+ // camera's layers, so a layer cannot keep it); with the camera that close
67
+ // its shadow is mostly under or behind the view, and a fade would mean
68
+ // writing materials other actors share.
69
+
70
+ import { Matrix4, Vector3 } from 'three';
71
+
72
+ const LOOK_HEIGHT = 0.8; // the head's top above the Transform (player.pxmodel, 0.78 m)
73
+ export const HIDE_WITHIN = 1.0;
74
+ export const SHOW_PAST = 1.2;
75
+
76
+ const lastHidden = new WeakMap();
77
+
78
+ // Draws the frame with `render(world, runtime)` (world3d.js `renderWorld`),
79
+ // the player's own model left out of it when the camera is that close.
80
+ export function renderHidingOwnModel(world, runtime, render) {
81
+ const id = runtime.orbitOwnModel;
82
+ runtime.orbitOwnModel = undefined;
83
+ const node = ownModelInView(world, id);
84
+ if (!node) {
85
+ lastHidden.delete(world);
86
+ render(world, runtime);
87
+ return;
88
+ }
89
+ lastHidden.set(world, node);
90
+ const hiddenWith = [];
91
+ let failed = null;
92
+ try {
93
+ node.visible = false;
94
+ const extras = world.ownModelWith;
95
+ for (const object of extras instanceof Set ? extras : []) {
96
+ if (object.visible !== true || !writable(object)) continue;
97
+ let parent = object;
98
+ while (parent && parent !== world.scene) parent = parent.parent;
99
+ if (parent !== world.scene) continue;
100
+ // Remember it before the write, inside the try that restores it.
101
+ hiddenWith.push(object);
102
+ object.visible = false;
103
+ }
104
+ render(world, runtime);
105
+ } finally {
106
+ // Every one is put back even if another's setter throws (the model
107
+ // first); the first such error is thrown after all of them, unless the
108
+ // render itself threw.
109
+ const putBack = (object) => {
110
+ try {
111
+ if (object.visible === false) object.visible = true;
112
+ } catch (error) {
113
+ failed ??= { error };
114
+ }
115
+ };
116
+ putBack(node);
117
+ for (const object of hiddenWith) putBack(object);
118
+ }
119
+ if (failed) throw failed.error;
120
+ }
121
+
122
+ const cameraAt = new Vector3();
123
+ const nodeAt = new Vector3();
124
+
125
+ // The node to leave out of this frame, or null. Both positions are the
126
+ // world's, as the render will draw them (`world.scene` and `world.camera`
127
+ // are what world3d.js's RenderPass draws): a deck may keep the player's
128
+ // node under a group of its own, and syncActors writes only its local
129
+ // position. A node not in the drawn scene is not drawn, so not hidden.
130
+ function ownModelInView(world, id) {
131
+ const entry = world.nodes?.get(id);
132
+ const node = entry?.node;
133
+ const { camera, scene } = world;
134
+ if (!node || !camera || !scene || entry.instancedRig || node.visible !== true || !writable(node)) return null;
135
+ if (!drawnAt(node, scene, nodeAt)) return null;
136
+ const limit = lastHidden.get(world) === node ? SHOW_PAST : HIDE_WITHIN;
137
+ cameraDrawnAt(camera, scene, cameraAt);
138
+ return distanceToAvatar(cameraAt, nodeAt) < limit ? node : null;
139
+ }
140
+
141
+ // WebGLRenderer.render (three 0.180) brings matrices up to date with
142
+ // `if (scene.matrixWorldAutoUpdate === true) scene.updateMatrixWorld()` and
143
+ // then `if (camera.parent === null && camera.matrixWorldAutoUpdate === true)
144
+ // camera.updateMatrixWorld()`. These give where `object` will be drawn
145
+ // under those two rules, computed for its own line of ancestors only and
146
+ // written to nothing.
147
+
148
+ // `object` in `scene`: its world position after the scene's update, or the
149
+ // cached one when the scene does not update. Null when it is not in it.
150
+ function drawnAt(object, scene, out) {
151
+ const chain = [];
152
+ let o = object;
153
+ while (o && o !== scene) {
154
+ chain.push(o);
155
+ o = o.parent;
156
+ }
157
+ if (o !== scene) return null;
158
+ if (scene.matrixWorldAutoUpdate !== true) return out.setFromMatrixPosition(object.matrixWorld);
159
+ chain.push(scene);
160
+ return out.setFromMatrixPosition(updatedWorld(chain.reverse()));
161
+ }
162
+
163
+ function cameraDrawnAt(camera, scene, out) {
164
+ if (camera.parent === null) {
165
+ if (camera.matrixWorldAutoUpdate === true) return out.setFromMatrixPosition(updatedWorld([camera]));
166
+ return out.setFromMatrixPosition(camera.matrixWorld);
167
+ }
168
+ return drawnAt(camera, scene, out) ?? out.setFromMatrixPosition(camera.matrixWorld);
169
+ }
170
+
171
+ const world4 = new Matrix4();
172
+ const local4 = new Matrix4();
173
+
174
+ // Object3D.updateMatrixWorld called on chain[0] (whose parent's matrixWorld
175
+ // is used as cached), followed down the chain to its last object: that
176
+ // object's matrixWorld as the call leaves it. Per object: matrixAutoUpdate
177
+ // recomposes `matrix` (and so needs an update); an object needing one, or
178
+ // under one that had one, gets parent.matrixWorld * matrix if its
179
+ // matrixWorldAutoUpdate is on and keeps its cached one if not, and forces
180
+ // the rest below it either way.
181
+ function updatedWorld(chain) {
182
+ const top = chain[0].parent;
183
+ let parentWorld = top ? world4.copy(top.matrixWorld) : null;
184
+ let force = false;
185
+ for (const o of chain) {
186
+ const auto = o.matrixAutoUpdate;
187
+ if (auto || o.matrixWorldNeedsUpdate || force) {
188
+ if (o.matrixWorldAutoUpdate === true) {
189
+ const local = auto ? local4.compose(o.position, o.quaternion, o.scale) : o.matrix;
190
+ parentWorld = parentWorld ? world4.multiplyMatrices(parentWorld, local) : world4.copy(local);
191
+ } else {
192
+ parentWorld = world4.copy(o.matrixWorld);
193
+ }
194
+ force = true;
195
+ } else {
196
+ parentWorld = world4.copy(o.matrixWorld);
197
+ }
198
+ }
199
+ return parentWorld;
200
+ }
201
+
202
+ // `visible` can be written (Object3D's is a plain data property; a node
203
+ // whose own one is read-only is drawn as is).
204
+ function writable(node) {
205
+ const own = Object.getOwnPropertyDescriptor(node, 'visible');
206
+ return !own || own.writable === true || typeof own.set === 'function';
207
+ }
208
+
209
+ // From `p` to the segment from `at` up LOOK_HEIGHT (world +y).
210
+ export function distanceToAvatar(p, at) {
211
+ const up = Math.max(0, Math.min(LOOK_HEIGHT, p.y - at.y));
212
+ return Math.hypot(p.x - at.x, p.y - (at.y + up), p.z - at.z);
213
+ }
@@ -17,6 +17,7 @@ import { applyLook, lookIsEnabled } from './look';
17
17
  import { applyArtObjects, applyMaterialExtras, partArtRefs } from './artobjects';
18
18
  import { coarsenParts, detailFor, optimizeModel, referenceBudget } from './optimize';
19
19
  import { airSpeed, modelAnimation } from './motion';
20
+ import { modelWalk, takeWalkSpeedHint, walkGait } from './gait.js';
20
21
 
21
22
  const DEG = Math.PI / 180;
22
23
 
@@ -258,16 +259,28 @@ export const STARTER_MODEL_TEXT = serializeModel({
258
259
  parts: [normalizePart({ id: 'body', size: [1, 1, 1], position: [0, 0.5, 0] }, 0)],
259
260
  });
260
261
 
261
- // Bounded parse cache -- model text is re-seen constantly by signatures and
262
- // rebuilds; parsing is cheap but not free.
262
+ // Model text is re-seen constantly by signatures and rebuilds. Keep a
263
+ // 400-model deck plus recent edits, evicting only the least recently used.
264
+ // The hub-world-preview's 314 distinct texts (315 files) averaged ~30 KiB
265
+ // retained per parse and 5.2 KiB of source: Node 22 --expose-gc heap deltas,
266
+ // 20 retained corpus copies, five runs. At 512 entries that is ~20 MiB for
267
+ // parsed data + text (allowing two bytes per source character), excluding
268
+ // renderer caches. Hits keep the same object, also used by look's WeakMap.
269
+ const PARSE_CACHE_LIMIT = 512;
263
270
  const parseCache = new Map();
264
271
  export function parseModelCached(text) {
265
272
  if (typeof text !== 'string') return null;
266
273
  const cached = parseCache.get(text);
267
- if (cached !== undefined) return cached;
268
- if (parseCache.size > 200) parseCache.clear();
274
+ if (cached !== undefined) {
275
+ parseCache.delete(text);
276
+ parseCache.set(text, cached);
277
+ return cached;
278
+ }
269
279
  const model = parseModel(text);
270
280
  parseCache.set(text, model);
281
+ if (parseCache.size > PARSE_CACHE_LIMIT) {
282
+ parseCache.delete(parseCache.keys().next().value);
283
+ }
271
284
  return model;
272
285
  }
273
286
 
@@ -630,7 +643,10 @@ export function modelArtSignature(model, sprites) {
630
643
  // Walk animation by part-id convention (legL/legR/armL/armR/torso), driven by
631
644
  // observed motion: speed from position deltas, air from vertical speed, lean
632
645
  // from yaw rate. dt of 0 (editor views) holds the neutral pose.
633
- export function animateModelParts(entry, dt) {
646
+ export function animateModelParts(entry, dt, world) {
647
+ if (walkGait() === 'model') {
648
+ entry.walkFrameHint = takeWalkSpeedHint(entry.node);
649
+ }
634
650
  const partGroups = entry.node.userData.modelParts;
635
651
  if (!partGroups) return;
636
652
  const parts = {
@@ -643,12 +659,25 @@ export function animateModelParts(entry, dt) {
643
659
  if (!parts.legL && !parts.torso) return;
644
660
  const anim = (entry.modelAnim ??= { phase: 0, swing: 0, air: 0, lean: 0, last: null });
645
661
  const p = entry.node.position;
662
+ const gait = walkGait() === 'model'
663
+ ? modelWalk(entry.node, anim, ['legL', 'legR'], 0.8,
664
+ dt > 0 && anim.last ? Math.hypot(p.x - anim.last.x, p.z - anim.last.z) / dt : 0,
665
+ dt, entry.walkFrameHint) : null;
646
666
  if (dt > 0 && anim.last) {
647
- const speed = Math.hypot(p.x - anim.last.x, p.z - anim.last.z) / dt;
648
- const verticalSpeed = airSpeed(entry.node, p, anim.last, dt);
649
- anim.swing += (Math.min(1, speed / 5) - anim.swing) * Math.min(1, dt * 10);
650
- anim.air += ((Math.abs(verticalSpeed) > 1.2 ? 1 : 0) - anim.air) * Math.min(1, dt * 8);
651
- anim.phase += Math.min(speed, 8) * 2.4 * dt;
667
+ if (gait?.model) {
668
+ const verticalSpeed = airSpeed(entry.node, p, anim.last, dt, world);
669
+ anim.swing += (Math.min(1, gait.speed / gait.walkSpeed) - anim.swing) * Math.min(1, gait.dt * 10);
670
+ anim.air += ((Math.abs(verticalSpeed) > 1.2 ? 1 : 0) - anim.air) * Math.min(1, dt * 8);
671
+ anim.amplitudeScale ??= 1;
672
+ anim.amplitudeScale += (gait.amplitudeScale - anim.amplitudeScale) * Math.min(1, gait.dt * 10);
673
+ anim.phase += 2 * Math.PI * gait.cadence * gait.phaseDt;
674
+ } else {
675
+ const speed = Math.hypot(p.x - anim.last.x, p.z - anim.last.z) / dt;
676
+ const verticalSpeed = airSpeed(entry.node, p, anim.last, dt, world);
677
+ anim.swing += (Math.min(1, speed / 5) - anim.swing) * Math.min(1, dt * 10);
678
+ anim.air += ((Math.abs(verticalSpeed) > 1.2 ? 1 : 0) - anim.air) * Math.min(1, dt * 8);
679
+ anim.phase += Math.min(speed, 8) * 2.4 * dt;
680
+ }
652
681
  const yaw = entry.node.rotation.y;
653
682
  let yawDelta = yaw - (anim.lastYaw ?? yaw);
654
683
  yawDelta = Math.atan2(Math.sin(yawDelta), Math.cos(yawDelta));
@@ -658,7 +687,9 @@ export function animateModelParts(entry, dt) {
658
687
  }
659
688
  anim.last = { x: p.x, y: p.y, z: p.z };
660
689
 
661
- const swing = Math.sin(anim.phase) * 0.8 * anim.swing * (1 - anim.air);
690
+ const swing = gait?.model
691
+ ? Math.sin(anim.phase) * 0.8 * anim.swing * (1 - anim.air) * (anim.amplitudeScale ?? 1)
692
+ : Math.sin(anim.phase) * 0.8 * anim.swing * (1 - anim.air);
662
693
  if (parts.legL) parts.legL.rotation.x = swing + anim.air * -0.55;
663
694
  if (parts.legR) parts.legR.rotation.x = -swing + anim.air * -0.3;
664
695
  if (parts.armL) parts.armL.rotation.x = -swing * 0.75 + anim.air * -1.5;