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
@@ -20,8 +20,8 @@ export const PACK_LIMITS = {
20
20
  // the kit's check puts on a deck's sounds, inside `bytes` and `files`.
21
21
  audioBytes: 1024 * 1024,
22
22
  audioFileBytes: 256 * 1024,
23
- sceneBytes: 1024 * 1024,
24
- sceneActors: 1500,
23
+ sceneBytes: 3 * 1024 * 1024,
24
+ sceneActors: 6000,
25
25
  places: 16,
26
26
  // Meshes one model may expand to once its repeats, scatters, mirrors, tips
27
27
  // and model references are applied, and all of one scene's models together:
@@ -321,7 +321,7 @@ function modelRefPath(src, fromPath) {
321
321
  // throws while loading would strand the player between places.
322
322
  // A blueprint's template actors have no id; a place's actors do.
323
323
  function checkScene(path, text, errors, leaves, isPlace, files) {
324
- if (text.length > PACK_LIMITS.sceneBytes) {
324
+ if (new TextEncoder().encode(text).byteLength > PACK_LIMITS.sceneBytes) {
325
325
  errors.push(`${path} is over ${PACK_LIMITS.sceneBytes} bytes`);
326
326
  return;
327
327
  }
@@ -0,0 +1,167 @@
1
+ // Whether this client's connection came back to a session that let it go.
2
+ //
3
+ // A phone app switch drops the socket long enough for the platform to report a
4
+ // leave: the real-time server removes the body and the place forgets the
5
+ // player. The SDK then resumes the connection, usually on the same net object
6
+ // this client already greeted, so `sayHello` (which greets a new net) would
7
+ // never greet again and the player would stay a ghost: no HUD, no doors.
8
+ //
9
+ // The signal is the session's own: the real-time server sends a WORLD
10
+ // snapshot to a connection each time it gives it a body (`admit` in the
11
+ // real-time kit's session.js), and only then (or, on a deck that filters, to a
12
+ // client that came back to a body it still had). A second WORLD on a net this
13
+ // client already greeted is a re-admission. It is read off the transport's
14
+ // queue, so it holds while the page was hidden and its frames stopped: the
15
+ // snapshot waits in the queue and is seen on the first frame back. Every
16
+ // version of a place's server sends it, so a re-saved town fixes every place.
17
+ //
18
+ // The same connection under a new player id (the SDK re-acquired a session)
19
+ // is a re-admission too, and is reported by `selfId`. It is also another
20
+ // session: what the old one sent this player alone (HUD, tune, decor, a card)
21
+ // is not the new one's. The watch's `onIdentity` runs once at that boundary,
22
+ // before the new session's packets are applied: from the drain that would hand
23
+ // them over, or from `resumed` if this client sees the id first.
24
+
25
+ // The real-time kit's WORLD kind (`code/client/messages.js` there).
26
+ const WORLD = 'w';
27
+
28
+ const watches = new WeakMap();
29
+
30
+ // The player id each deck message arrived under, set the moment it arrives
31
+ // (`tag`, from the hook layer's `arrive`, which runs with or without frames).
32
+ // A message queued under an id the connection no longer has belongs to the
33
+ // session it left: the drain drops it, so an old HUD, tune or card queued
34
+ // while the page was hidden does not come back after the identity reset. One
35
+ // that arrived before the client had a net is untagged and kept, as are
36
+ // snapshots (WORLD/STATE), which never pass `arrive`; the new session's WORLD
37
+ // replaces the shared state whole.
38
+ const tags = new WeakMap();
39
+
40
+ export function tag(msg, net) {
41
+ const id = net ? selfIdOf(net) : null;
42
+ if (id && msg && typeof msg === 'object') {
43
+ tags.set(msg, id);
44
+ }
45
+ }
46
+
47
+ // The watch over one net: how many re-admitting snapshots it has drained. The
48
+ // first snapshot is the join's own; when the multiplayer kit has already
49
+ // drained it (it says `joined`), every later one counts.
50
+ export function watch(mp, net, onIdentity = null) {
51
+ let w = watches.get(net);
52
+ if (w) {
53
+ w.onIdentity = onIdentity ?? w.onIdentity;
54
+ return w;
55
+ }
56
+ w = { seen: mp?.joined === true, again: 0, selfId: selfIdOf(net), onIdentity };
57
+ watches.set(net, w);
58
+ const drain = net.drain;
59
+ if (typeof drain === 'function') {
60
+ net.drain = (...args) => {
61
+ let messages = drain.apply(net, args);
62
+ identity(net, w);
63
+ const id = selfIdOf(net);
64
+ if (id && Array.isArray(messages)) {
65
+ messages = messages.filter((msg) => {
66
+ const at = tags.get(msg);
67
+ return at === undefined || at === id;
68
+ });
69
+ }
70
+ for (const msg of messages ?? []) {
71
+ if (msg?.k === WORLD) {
72
+ if (w.seen) {
73
+ w.again += 1;
74
+ } else {
75
+ w.seen = true;
76
+ }
77
+ }
78
+ }
79
+ return messages;
80
+ };
81
+ }
82
+ return w;
83
+ }
84
+
85
+ // A mark of where a connection stands when a hello goes out: a later
86
+ // `resumed` against it says whether the session has let this client go and
87
+ // taken it back since.
88
+ export function mark(mp, net, onIdentity = null) {
89
+ const w = watch(mp, net, onIdentity);
90
+ identity(net, w);
91
+ return { again: w.again, selfId: selfIdOf(net) };
92
+ }
93
+
94
+ // The identity boundary: a net whose player id changed since the watch last
95
+ // looked runs `onIdentity` once.
96
+ function identity(net, w) {
97
+ const id = selfIdOf(net);
98
+ if (!id || id === w.selfId) {
99
+ return;
100
+ }
101
+ const was = w.selfId;
102
+ w.selfId = id;
103
+ if (was) {
104
+ try {
105
+ w.onIdentity?.();
106
+ } catch (err) {
107
+ console.warn(`[hub] resetting for a new session failed: ${err?.message ?? err}`);
108
+ }
109
+ }
110
+ }
111
+
112
+ // 'self' when the connection now has another player id (another session, or a
113
+ // session that started this player afresh), 'world' when the session sent this
114
+ // connection the world again, else null.
115
+ export function resumed(mp, net, at) {
116
+ if (!at) {
117
+ return null;
118
+ }
119
+ const w = watch(mp, net);
120
+ identity(net, w);
121
+ const id = selfIdOf(net);
122
+ if (id && at.selfId && id !== at.selfId) {
123
+ return 'self';
124
+ }
125
+ return w.again !== at.again ? 'world' : null;
126
+ }
127
+
128
+ // Which hello a connection that came back (`resumed`'s answer) says:
129
+ // 'none' nothing came back, or a game (a place with `result`) back under
130
+ // the same player id that did not opt in to `resume`: its round
131
+ // and result belong to the visit that left, so the place keeps it
132
+ // as it was (no re-arrival);
133
+ // 'fresh' a game back under a NEW player id: a session that has never
134
+ // arrived this player, so an ordinary first hello (a party of one,
135
+ // nothing carried), or the player stays a ghost for the visit;
136
+ // 'resume' any other place, or a game whose place says `resume: true`
137
+ // (v1.72) back under the same id: the resume hello, which
138
+ // re-arrives a player the place let go and is idempotent for one
139
+ // it still has.
140
+ export function helloAfter(back, isGame, resumes = false) {
141
+ if (!back) {
142
+ return 'none';
143
+ }
144
+ if (isGame) {
145
+ if (back === 'self') {
146
+ return 'fresh';
147
+ }
148
+ return resumes === true ? 'resume' : 'none';
149
+ }
150
+ return 'resume';
151
+ }
152
+
153
+ // Whether a `hub-end` starts this client's end. One a resume place says again
154
+ // (v1.72, `again: true`, to a client a drop may have kept it from) is taken
155
+ // only by a client not already ending in that session, so a repeat never
156
+ // restarts its pause; every other end is taken, as it always was.
157
+ export function takesEnd(msg, pendingEnd, endSession, session) {
158
+ return !(msg?.again === true && pendingEnd !== null && endSession === session);
159
+ }
160
+
161
+ function selfIdOf(net) {
162
+ try {
163
+ return net.selfId?.() || null;
164
+ } catch {
165
+ return null;
166
+ }
167
+ }
@@ -0,0 +1,92 @@
1
+ // v1.61: only an accepted orbit shot makes state or starts a watcher. There
2
+ // is no frame hook. The timer stops on clear, travel, load or connection loss.
3
+ import { shotValue } from '../shared/shot.js';
4
+
5
+ function nothing() {}
6
+
7
+ // Until a message sets a shot, lifecycle cleanup is a no-op: it reads no
8
+ // scene or hub state. Once used, cleanup also declines a resumable pose.
9
+ export let clearShot = nothing;
10
+ let active;
11
+ let remembered;
12
+
13
+ function equalPose(a, b) {
14
+ return a.look.x === b.look.x && a.look.y === b.look.y && a.look.z === b.look.z && a.distance === b.distance && a.pitch === b.pitch && a.yaw === b.yaw;
15
+ }
16
+
17
+ function clear(resumable = false) {
18
+ if (active) {
19
+ clearInterval(active.timer);
20
+ // A deck's later assignment owns its lifecycle, even if equal in value.
21
+ if (active.scene.orbitShot === active.pose) {
22
+ delete active.scene.orbitShot;
23
+ }
24
+ remembered = { scene: active.scene, pose: active.pose, path: active.path, key: active.key, resumable };
25
+ active = undefined;
26
+ } else if (remembered && !resumable) {
27
+ remembered.resumable = false;
28
+ }
29
+ }
30
+
31
+ function checkActive() {
32
+ if (!active) {
33
+ return;
34
+ }
35
+ const { scene, pose, path, key, net, generation, lastRenewedAt } = active;
36
+ // Ownership and place changes take priority over a simultaneous disconnect.
37
+ if (scene.orbitShot !== pose || scene.cameraControl !== 'orbit' || scene.currentScenePath !== path || scene.sceneKey !== key) {
38
+ clear();
39
+ } else if (performance.now() - lastRenewedAt > 5000 || scene.multiplayer?.net !== net || scene.multiplayer?.generation !== generation || net?.closed?.() || (net?.status && net.status().state !== 'connected')) {
40
+ clear(true);
41
+ }
42
+ }
43
+
44
+ export function receiveShot(scene, value, lease = false) {
45
+ if (scene.cameraControl !== 'orbit') {
46
+ return;
47
+ }
48
+ const pose = shotValue(value);
49
+ if (!pose) {
50
+ if (!lease) {
51
+ clearShot();
52
+ }
53
+ return;
54
+ }
55
+ // Check before processing a renewal: the watcher may have been throttled.
56
+ checkActive();
57
+ if (lease) {
58
+ if (active) {
59
+ if (active.scene === scene && equalPose(active.pose, pose)) {
60
+ active.lastRenewedAt = performance.now();
61
+ }
62
+ return;
63
+ }
64
+ if (!remembered?.resumable || remembered.scene !== scene || scene.currentScenePath !== remembered.path || scene.sceneKey !== remembered.key || scene.orbitShot !== undefined || !equalPose(remembered.pose, pose)) {
65
+ // A scene change or deck assignment during a disconnect also declines it.
66
+ if (remembered && (remembered.scene !== scene || scene.currentScenePath !== remembered.path || scene.sceneKey !== remembered.key || scene.orbitShot !== undefined)) {
67
+ clear();
68
+ }
69
+ return;
70
+ }
71
+ }
72
+ const now = performance.now();
73
+ const net = scene.multiplayer?.net;
74
+ const generation = scene.multiplayer?.generation;
75
+ const path = scene.currentScenePath;
76
+ const key = scene.sceneKey;
77
+ if (active?.scene === scene && scene.orbitShot === active.pose && active.net === net && active.generation === generation && active.path === path && active.key === key && equalPose(active.pose, pose)) {
78
+ active.lastRenewedAt = now;
79
+ remembered = undefined;
80
+ return;
81
+ }
82
+ clearShot();
83
+ remembered = undefined;
84
+ scene.orbitShot = pose;
85
+ const own = { scene, pose, net, generation, path, key, lastRenewedAt: now };
86
+ active = own;
87
+ clearShot = () => clear();
88
+ // A transient socket loss need not end the session or produce a hub trip.
89
+ // Expiry also catches a reconnect to a restarted server when a background
90
+ // tab's watcher missed the disconnect and the transport identities stayed.
91
+ own.timer = setInterval(checkActive, 100);
92
+ }
@@ -47,6 +47,7 @@ export function makeSound() {
47
47
  const loops = new Map();
48
48
  // { el, actor, volume, radius }
49
49
  const shots = new Set();
50
+ let restoreEvents = () => {};
50
51
 
51
52
  function stop(el) {
52
53
  try {
@@ -83,16 +84,49 @@ export function makeSound() {
83
84
  }
84
85
 
85
86
  return {
86
- // `on`: whether the place may sound now (not during a trip).
87
- frame(scene, local, on) {
87
+ // Read only, for opt-in music ducking. The place's distance-scaled level,
88
+ // before the user's master volume; pending and paused files never win.
89
+ loudestLoop() {
90
+ let loudest = 0;
91
+ for (const { el, heard } of loops.values()) {
92
+ if (el.paused === false && !el.muted && Number.isFinite(heard)) {
93
+ loudest = Math.max(loudest, heard);
94
+ }
95
+ }
96
+ return loudest;
97
+ },
98
+ // Opt-in only (`hub.soundscape`): ask when a one-shot is processed by
99
+ // hookLayer.js after the transport drains. Non-live and settling frames
100
+ // drop it there so it cannot wait for a later frame.
101
+ filterEvents(canPlay) {
102
+ hub.soundGate = canPlay;
103
+ restoreEvents = () => {
104
+ if (hub.soundGate === canPlay) {
105
+ hub.soundGate = null;
106
+ }
107
+ };
108
+ },
109
+ // `on`: whether the place may sound now (not during a trip). `master`,
110
+ // only ever given in a deck with `hub.soundscape` (`soundscape.js`), is
111
+ // how loud that deck's sound control has everything, 0 to 1, or null
112
+ // before the player's first gesture: nothing is started then (no play is
113
+ // tried and left waiting for the gesture, a one-shot is dropped), and a
114
+ // loop starts where everyone else is in it once there has been one.
115
+ // Without it every volume and every play is the one it always was.
116
+ frame(scene, local, on, master) {
88
117
  const files = hub.place?.idle?.sounds ?? [];
89
118
  const events = hub.soundEvents.splice(0);
90
- if (!on || !files.length || typeof Audio === 'undefined') {
119
+ if (!on || !files.length || typeof Audio === 'undefined' || master === null) {
91
120
  stopAll();
92
121
  return;
93
122
  }
94
123
  const url = (file) => soundUrl(file, files, scene.content);
95
124
  const me = local?.components.Transform ?? null;
125
+ const level = master === undefined ? null : Math.min(1, Math.max(0, Number(master) || 0));
126
+ const heard = (volume, radius, d) => {
127
+ const gain = gainAt(volume, radius, d);
128
+ return level === null ? gain : gain * level;
129
+ };
96
130
  for (const [actorId, loop] of [...loops]) {
97
131
  const want = hub.sounds[actorId];
98
132
  if (!want || `${want.file}|${want.since}` !== loop.key) {
@@ -121,16 +155,22 @@ export function makeSound() {
121
155
  loops.set(actorId, loop);
122
156
  playMedia(el);
123
157
  }
124
- loop.el.volume = gainAt(loop.volume, loop.radius, distance(scene, me, actorId));
158
+ if (level === null) {
159
+ loop.el.volume = heard(loop.volume, loop.radius, distance(scene, me, actorId));
160
+ } else {
161
+ // Opt-in only: the level before the user's volume, for `loudestLoop`.
162
+ loop.heard = gainAt(loop.volume, loop.radius, distance(scene, me, actorId));
163
+ loop.el.volume = loop.heard * level;
164
+ }
125
165
  }
126
166
  for (const event of events) {
127
167
  const src = typeof event.file === 'string' ? url(event.file) : null;
128
168
  const d = distance(scene, me, event.actor);
129
- if (!src || shots.size >= MAX_SHOTS || gainAt(event.volume, event.radius, d) <= 0) {
169
+ if (!src || shots.size >= MAX_SHOTS || heard(event.volume, event.radius, d) <= 0) {
130
170
  continue;
131
171
  }
132
172
  const shot = { el: new Audio(src), actor: event.actor, volume: event.volume, radius: event.radius };
133
- shot.el.volume = gainAt(shot.volume, shot.radius, d);
173
+ shot.el.volume = heard(shot.volume, shot.radius, d);
134
174
  shots.add(shot);
135
175
  const done = () => {
136
176
  shots.delete(shot);
@@ -139,9 +179,24 @@ export function makeSound() {
139
179
  Promise.resolve(shot.el.play()).catch(done);
140
180
  }
141
181
  for (const shot of shots) {
142
- shot.el.volume = gainAt(shot.volume, shot.radius, distance(scene, me, shot.actor));
182
+ shot.el.volume = heard(shot.volume, shot.radius, distance(scene, me, shot.actor));
143
183
  }
144
184
  },
145
- dispose: stopAll,
185
+ // Everything playing made silent where it stands, until the next frame
186
+ // says how loud it is: for a page that is hidden, which draws no frame.
187
+ // Only a deck with `hub.soundscape` calls it.
188
+ hush() {
189
+ for (const loop of loops.values()) {
190
+ loop.el.volume = 0;
191
+ loop.heard = 0;
192
+ }
193
+ for (const shot of shots) {
194
+ shot.el.volume = 0;
195
+ }
196
+ },
197
+ dispose() {
198
+ restoreEvents();
199
+ stopAll();
200
+ },
146
201
  };
147
202
  }