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,306 @@
1
+ // The life of the sky a world draws for a scene that set
2
+ // `"engine": { "sky": { ... } }`: when its dome is in the scene graph, and
3
+ // when what it owns on the GPU is let go. sky.js makes the dome and decides
4
+ // what it shows; everything about how long any of it lasts is here, in one
5
+ // place.
6
+ //
7
+ // The invariant:
8
+ //
9
+ // The dome and its resources are attached, detached and disposed only by
10
+ // the outermost render of their world, or with no render of that world in
11
+ // progress. Nothing a callback does (re-enter, throw, load, dispose) can
12
+ // leave a dome in the scene graph, a disposed resource in a render list,
13
+ // or a sky record alive past its key.
14
+ //
15
+ // It does not depend on which way a frame went, because every frame goes
16
+ // the same way. `skyFrame` is: count the frame in, prepare, draw, count it
17
+ // out, and if it was the outermost, `settle`. With or without a record, with
18
+ // or without an error, returned or thrown: the same five steps.
19
+ //
20
+ // The postcondition, which `settle` alone enforces, from what it reads at
21
+ // that moment and nothing a frame remembered:
22
+ //
23
+ // After the outermost frame of a world returns or throws, EITHER
24
+ // `world.sky` is null, OR it is a record whose key is the key the frame's
25
+ // runtime has NOW for THIS world, with its dome out of the scene graph,
26
+ // and neither that frame nor any frame drawn from inside it threw.
27
+ //
28
+ // "The key a runtime has for a world" (`skyKeyFor`) is its `sky`, unless the
29
+ // world is disposed or the runtime draws in another world (its `three` is
30
+ // set and is not this one): then it has none. So a runtime handed to
31
+ // `renderWorld` for a world it does not belong to never gets a sky there.
32
+ //
33
+ // The pieces, each acting only on what it reads when it acts:
34
+ //
35
+ // - `world.skyDepth` counts the frames of this world in progress that came
36
+ // through `skyFrame`, and a disposal in progress counts as one. Only at
37
+ // depth 1 (the outermost frame, with nothing being disposed) does
38
+ // `prepare` run, and only at depth 0 do `settle` and `leaveSky` release.
39
+ // - `prepare` (the outermost frame, before its draw): a record not of the
40
+ // runtime's key goes; if there is none and the runtime has a key, one is
41
+ // made; the record is stepped, and what the step let go is disposed;
42
+ // and a record of the runtime's key is attached. Each of those four reads
43
+ // `world.sky` again first, and the key wherever a deck's code may have
44
+ // run since it was last read (a `dispose` listener in the first, a getter
45
+ // on the Player's Transform or the deck's art in the third).
46
+ // - A frame from inside another, or from inside a disposal (depth above 1),
47
+ // never makes, steps, attaches, detaches or disposes. If a dome is in the
48
+ // scene graph and is not of that frame's runtime's key, it is hidden for
49
+ // that draw and shown again after, which dispatches nothing.
50
+ // - `settle` (after the outermost frame, at depth 0): the dome is taken out
51
+ // of the scene graph; then the record stays only if its key is the
52
+ // runtime's key now and nothing threw. Otherwise it is released.
53
+ // - `release` is the one place anything a record owns is disposed. It takes
54
+ // the record off the world first, so nothing can reach it again, leaves
55
+ // RELEASING in its place and counts itself into `skyDepth` while the
56
+ // `dispose` listeners run: a frame one of them draws, of any scene or of
57
+ // none, comes through `skyFrame` as a frame from inside, makes nothing,
58
+ // and is heard if it throws; a load or a dispose one of them causes
59
+ // releases nothing. Every listener on every resource is called, each in a
60
+ // guard of its own (`disposed`). So it runs once a record, calls every
61
+ // listener once, and leaves `world.sky` null: `settle` has nothing to
62
+ // loop on. RELEASING is never a record: `prepare` and `settle` run only
63
+ // when no disposal is going, so they never meet it.
64
+ // - Each record keeps the world's optional call-out hook, acquired only
65
+ // when it is made. It brackets the whole resource release, and the whole
66
+ // shed-texture disposal after a step, so disposal listeners see no adopted
67
+ // or frozen scenery and nested actor passes cannot adopt. It adds no sky
68
+ // depth and handles no errors: `disposed` still keeps them as data. Without
69
+ // a hook those same blocks run directly; without textures shed the hook
70
+ // is neither tested nor called.
71
+ // - A scene load (systems/physics3d.js `reset`, at the start of
72
+ // `SceneRuntime.load`) and `disposeWorld` call `leaveSky`: with no frame
73
+ // in progress the record is released there and then (a load releases only
74
+ // the record of the key it is replacing); with one in progress nothing is
75
+ // done, and `settle` finds the key gone.
76
+ // - Attaching and detaching write `parent` and `children` directly: no
77
+ // `added`, `removed`, `childadded` or `childremoved` is dispatched, so no
78
+ // listener runs and neither can throw.
79
+ //
80
+ // Errors are data. A step or a disposal that throws does not stop the frame:
81
+ // the first such error is kept, the frame is drawn (without a sky), every
82
+ // release that is due still runs, and the error is thrown at the frame's one
83
+ // exit, after `settle`. A frame's own error (its draw's) is thrown over a
84
+ // kept one. Any error at all, the frame's or one from a frame inside it that
85
+ // its caller caught, and `settle` keeps no record.
86
+ //
87
+ // No imports: systems/physics3d.js and the tests load it alone.
88
+
89
+ // Into the scene graph and out of it, without three.js's events.
90
+ function attach(record, scene) {
91
+ detach(record);
92
+ scene.children.push(record.mesh);
93
+ record.mesh.parent = scene;
94
+ }
95
+
96
+ function detach(record) {
97
+ const mesh = record.mesh;
98
+ const parent = mesh.parent;
99
+ if (!parent) return;
100
+ const at = parent.children.indexOf(mesh);
101
+ if (at !== -1) parent.children.splice(at, 1);
102
+ mesh.parent = null;
103
+ }
104
+
105
+ // The key a runtime has for a world, now; or null.
106
+ export function skyKeyFor(world, runtime) {
107
+ if (!runtime || world.disposed === true) return null;
108
+ const drawsIn = runtime.three;
109
+ if (drawsIn !== undefined && drawsIn !== null && drawsIn !== world) return null;
110
+ return runtime.sky ?? null;
111
+ }
112
+
113
+ // What `world.sky` is while a record's resources are being disposed: not a
114
+ // record, and it owns nothing. It is there so that every `renderWorld` of
115
+ // the world during a disposal, a scene's without the key and an editor's
116
+ // included, comes through `skyFrame` (world3d.js sends a frame here when the
117
+ // runtime has a key or `world.sky` is set) and is a frame from inside: it
118
+ // makes nothing, and if it throws the frame round the disposal hears of it.
119
+ const RELEASING = Object.freeze({ releasing: true });
120
+
121
+ // The world's record, off the world and everything it owns disposed.
122
+ // Returns the first error a `dispose` listener threw, or null. Called only
123
+ // with no frame in progress but the outermost one preparing (`prepare`,
124
+ // `settle`, `leaveSky`), and so never with the dome in the scene graph
125
+ // (`prepare` releases before it attaches, `settle` detaches first, and
126
+ // between frames no dome is attached) and never while another release is
127
+ // going (a disposal counts as a frame in progress).
128
+ function release(world) {
129
+ const record = world.sky;
130
+ if (!record) return null;
131
+ world.sky = RELEASING;
132
+ record.forget();
133
+ let failed = null;
134
+ world.skyDepth = (world.skyDepth ?? 0) + 1;
135
+ try {
136
+ const dispose = () => {
137
+ for (const item of record.owned()) failed = disposed(item, failed);
138
+ };
139
+ if (record.onCallout) record.onCallout(dispose);
140
+ else dispose();
141
+ } finally {
142
+ world.skyDepth -= 1;
143
+ world.sky = null;
144
+ }
145
+ return failed;
146
+ }
147
+
148
+ // One of the sky's own resources (a texture, the geometry, the material)
149
+ // disposed: every `dispose` listener on it called, each in a guard of its
150
+ // own. Returns the first error kept so far.
151
+ //
152
+ // Not `item.dispose()`. For these three classes three.js's `dispose()` is
153
+ // `this.dispatchEvent({ type: 'dispose' })` and nothing else (r180:
154
+ // Texture.js, Material.js, BufferGeometry.js; ShaderMaterial does not
155
+ // override it), and `dispatchEvent` stops at the first listener that
156
+ // throws. The renderer's own cleanup is such a listener (WebGLTextures,
157
+ // WebGLGeometries, the material's programs), added when the resource was
158
+ // first drawn, so after any listener a deck added before that. One deck
159
+ // listener that throws would leave the GPU's copy allocated for good. So
160
+ // the listeners are called here, as `dispatchEvent` calls them (a copy of
161
+ // the list, `this` the resource, one event with `target` set and cleared
162
+ // after), but each in its own try.
163
+ //
164
+ // That reads three.js's EventDispatcher's own storage, `_listeners.dispose`
165
+ // (an array, made by `addEventListener`). If it is not there in that shape
166
+ // (no listener was ever added, or another three.js keeps them otherwise),
167
+ // `item.dispose()` is called instead, in a guard: all or nothing, as three.js
168
+ // does it. test-sky.mjs fails if either the storage or what `dispose()` does
169
+ // changes, so an upgrade of three.js is noticed.
170
+ function disposed(item, failed) {
171
+ const keep = (err) => {
172
+ failed ??= err ?? new Error('a dispose listener threw nothing');
173
+ };
174
+ let listeners = null;
175
+ try {
176
+ const held = item._listeners;
177
+ if (held !== null && typeof held === 'object' && Array.isArray(held.dispose)) listeners = held.dispose.slice(0);
178
+ } catch (err) {
179
+ keep(err);
180
+ }
181
+ if (listeners === null) {
182
+ try {
183
+ item.dispose();
184
+ } catch (err) {
185
+ keep(err);
186
+ }
187
+ return failed;
188
+ }
189
+ const event = { type: 'dispose', target: item };
190
+ for (const listener of listeners) {
191
+ try {
192
+ listener.call(item, event);
193
+ } catch (err) {
194
+ keep(err);
195
+ }
196
+ }
197
+ event.target = null;
198
+ return failed;
199
+ }
200
+
201
+ // The scene a record was made for is going: `key` is the key a load is
202
+ // replacing (the record of another is not that load's to end), or absent for
203
+ // a dispose. With no frame in progress the record is released here; with one,
204
+ // `settle` ends it. Returns what `release` does.
205
+ export function leaveSky(world, key) {
206
+ const record = world?.sky;
207
+ if (!record || (world.skyDepth ?? 0) > 0) return null;
208
+ if (key !== undefined && record.key !== key) return null;
209
+ return release(world);
210
+ }
211
+
212
+ // The outermost frame, before its draw. Returns the first error of a
213
+ // disposal or the step, or null.
214
+ function prepare(world, runtime, make, step, calloutFor) {
215
+ let failed = null;
216
+ // A record of another key goes.
217
+ if (world.sky && world.sky.key !== skyKeyFor(world, runtime)) failed = release(world);
218
+ // None, and the runtime has a key: one is made -- unless this frame is
219
+ // already going to throw, when it would only be let go again.
220
+ if (!world.sky && failed === null) {
221
+ const key = skyKeyFor(world, runtime);
222
+ if (key !== null) {
223
+ world.sky = make(key, world);
224
+ world.sky.onCallout = calloutFor?.(world);
225
+ }
226
+ }
227
+ // The record is stepped, and what the step let go is disposed, each
228
+ // texture in its own guard. (A record here is of the runtime's key: one
229
+ // of another was released above, and nothing has run since.)
230
+ if (world.sky) {
231
+ const record = world.sky;
232
+ try {
233
+ step(record);
234
+ } catch (err) {
235
+ failed ??= err ?? new Error('the step threw nothing');
236
+ }
237
+ if (record.shed.length > 0) {
238
+ const dispose = () => {
239
+ for (const item of record.shed.splice(0)) failed = disposed(item, failed);
240
+ };
241
+ if (record.onCallout) record.onCallout(dispose);
242
+ else dispose();
243
+ }
244
+ }
245
+ // And a record of the runtime's key, in a frame that is not going to
246
+ // throw, is attached.
247
+ if (world.sky && failed === null && world.sky.key === skyKeyFor(world, runtime)) attach(world.sky, world.scene);
248
+ return failed;
249
+ }
250
+
251
+ // A frame from inside another: a dome in the scene graph that is not of this
252
+ // frame's runtime's key is hidden for the draw. Returns what to show again.
253
+ function hideAnothers(world, runtime) {
254
+ const record = world.sky;
255
+ if (!record || record === RELEASING || !record.mesh.parent || record.key === skyKeyFor(world, runtime)) return null;
256
+ const mesh = record.mesh;
257
+ const shown = mesh.visible;
258
+ mesh.visible = false;
259
+ return () => {
260
+ mesh.visible = shown;
261
+ };
262
+ }
263
+
264
+ // After the outermost frame: the postcondition, from what is true now.
265
+ // `threw` is whether that frame, or any frame drawn from inside it, did.
266
+ // Returns what `release` does.
267
+ function settle(world, runtime, threw) {
268
+ const record = world.sky;
269
+ if (!record) return null;
270
+ detach(record);
271
+ if (!threw && record.key === skyKeyFor(world, runtime)) return null;
272
+ return release(world);
273
+ }
274
+
275
+ // One frame of a world that has a record, or whose scene has a key: `draw()`
276
+ // is the frame, `make(key, world)` a record's dome and what it owns (`{ key, mesh,
277
+ // shed, owned(), forget() }`), and `step(record)` what makes it show what
278
+ // this frame should. Optional `calloutFor(world)` supplies that record's
279
+ // disposal hook; the engine makes it once per world, only for an actual record.
280
+ export function skyFrame(world, runtime, draw, make, step, calloutFor) {
281
+ world.skyDepth = (world.skyDepth ?? 0) + 1;
282
+ // The outermost frame starts with nothing heard from a frame inside it.
283
+ if (world.skyDepth === 1) world.skyThrew = false;
284
+ let kept = null;
285
+ let own = null;
286
+ let show = null;
287
+ try {
288
+ if (world.skyDepth === 1) kept = prepare(world, runtime, make, step, calloutFor);
289
+ else show = hideAnothers(world, runtime);
290
+ draw();
291
+ } catch (err) {
292
+ own = { err };
293
+ // The frame this one is inside of, if any, hears of it.
294
+ world.skyThrew = true;
295
+ } finally {
296
+ if (show) show();
297
+ world.skyDepth -= 1;
298
+ if (world.skyDepth === 0) {
299
+ // Settled whatever has gone wrong; then the first error is the one kept.
300
+ const late = settle(world, runtime, world.skyThrew === true || kept !== null);
301
+ kept ??= late;
302
+ }
303
+ }
304
+ if (own !== null) throw own.err;
305
+ if (kept !== null) throw kept;
306
+ }
@@ -151,3 +151,14 @@ export function recordReads(target, reads) {
151
151
  },
152
152
  });
153
153
  }
154
+
155
+ // For the audit of a scene that set `"engine": { "staticActors": true }`
156
+ // (`world.auditStatic`, QA only; world3d.js): writes down that a still actor
157
+ // was found changed with no `scene.touch`, and warns of each actor once.
158
+ export function noteChangedStill(world, id, what) {
159
+ const failures = (world.staticAuditFailures ??= []);
160
+ if (!failures.some((failure) => failure.id === id)) {
161
+ console.warn(`staticActors: "${id}" is marked static and ${what} changed without scene.touch`);
162
+ }
163
+ failures.push({ id, what });
164
+ }
@@ -0,0 +1,52 @@
1
+ // Opt-in engine.view.far (metres). Like orbitlens.js, keep the camera's
2
+ // original value on the first keyed frame, and return it before the next
3
+ // scene's code, when the key goes, on an editor frame, or on disposal.
4
+ // No imports: Fog and the optional sky colour reader come from the renderer.
5
+ // A keyless world allocates nothing and writes nothing, including on reset
6
+ // and disposal.
7
+ export function viewFar(data) {
8
+ const far = data?.engine?.view?.far;
9
+ return typeof far === 'number' && far >= 20 && far <= 1000 ? far : null;
10
+ }
11
+
12
+ const hexColor = (value) => typeof value === 'string' && /^#[\da-f]{6}$/i.test(value);
13
+
14
+ function backgroundColor(world, data) {
15
+ if (world.scene.background?.isColor) return world.scene.background;
16
+ return hexColor(data.background) ? data.background : 0x808080;
17
+ }
18
+
19
+ export function fitViewRange(world, runtime, Fog, skyColor) {
20
+ const far = viewFar(runtime?.data);
21
+ if (far === null) {
22
+ giveBackViewRange(world);
23
+ return;
24
+ }
25
+ if (world.disposed === true) return;
26
+ const camera = world.camera;
27
+ const range = (world.viewRange ??= { far: camera.far, fog: world.scene.fog, owned: new Fog(0x808080, 0, far) });
28
+ const view = runtime.data.engine.view;
29
+ const from = Number.isFinite(view.fogFrom) ? view.fogFrom : 0.75 * far;
30
+ range.owned.near = Math.max(0, Math.min(far * (1 - 1e-6), from));
31
+ range.owned.far = far;
32
+ const color = hexColor(view.fogColor) ? view.fogColor : skyColor?.(world, range) ?? backgroundColor(world, runtime.data);
33
+ // Color inputs already use three's linear working space; set copies them.
34
+ range.owned.color.set(color);
35
+ if (world.scene.fog !== range.owned) world.scene.fog = range.owned;
36
+ if (camera.far !== far) {
37
+ camera.far = far;
38
+ camera.updateProjectionMatrix();
39
+ }
40
+ }
41
+
42
+ export function giveBackViewRange(world) {
43
+ const range = world?.viewRange;
44
+ if (!range) return;
45
+ world.viewRange = null;
46
+ world.scene.fog = range.fog;
47
+ const camera = world.camera;
48
+ if (camera && camera.far !== range.far) {
49
+ camera.far = range.far;
50
+ camera.updateProjectionMatrix();
51
+ }
52
+ }