castle-web-cli 0.4.232 → 0.4.234

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 (587) 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/api.d.ts +11 -0
  8. package/dist/api.js +43 -0
  9. package/dist/bundle.d.ts +64 -0
  10. package/dist/bundle.js +558 -2
  11. package/dist/castle-host/host.d.ts +18 -2
  12. package/dist/castle-host/host.js +844 -39
  13. package/dist/castleJson.d.ts +23 -2
  14. package/dist/castleJson.js +46 -2
  15. package/dist/check.d.ts +3 -1
  16. package/dist/check.js +20 -3
  17. package/dist/chunkLoader.d.ts +3 -0
  18. package/dist/chunkLoader.js +111 -0
  19. package/dist/devParty.d.ts +26 -0
  20. package/dist/devParty.js +231 -0
  21. package/dist/devSaveStorage.js +4 -0
  22. package/dist/devSessionStorage.js +50 -2
  23. package/dist/devSocial.d.ts +24 -0
  24. package/dist/devSocial.js +70 -0
  25. package/dist/ide.d.ts +2 -0
  26. package/dist/ide.js +119 -15
  27. package/dist/importPinMismatch.d.ts +22 -0
  28. package/dist/importPinMismatch.js +77 -0
  29. package/dist/importRegression.js +3 -15
  30. package/dist/imports.d.ts +10 -3
  31. package/dist/imports.js +88 -20
  32. package/dist/index.js +11 -4
  33. package/dist/init.js +1 -1
  34. package/dist/platformDoc.js +22 -0
  35. package/dist/routerFences.d.ts +5 -0
  36. package/dist/routerFences.js +12 -2
  37. package/dist/save-deck.d.ts +25 -1
  38. package/dist/save-deck.js +178 -9
  39. package/dist/serve.js +32 -11
  40. package/dist/shell/assets/{index-D2tWM896.js → index-DulbYIJm.js} +97 -97
  41. package/dist/shell/assets/index-MVLfNYd9.css +1 -0
  42. package/dist/shell/index.html +2 -2
  43. package/dist/taskSteer.d.ts +13 -0
  44. package/dist/taskSteer.js +22 -2
  45. package/dist/vitePlugins.d.ts +2 -1
  46. package/dist/vitePlugins.js +13 -0
  47. package/kits/base/castle.json +1 -1
  48. package/kits/base/package-lock.json +1 -1
  49. package/kits/base/sdk/README.md +339 -5
  50. package/kits/base/sdk/avatar.d.ts +6 -2
  51. package/kits/base/sdk/avatar.js +12 -4
  52. package/kits/base/sdk/castle.d.ts +7 -3
  53. package/kits/base/sdk/castle.js +2 -0
  54. package/kits/base/sdk/commands.d.ts +176 -1
  55. package/kits/base/sdk/commands.js +3 -0
  56. package/kits/base/sdk/display.d.ts +3 -0
  57. package/kits/base/sdk/display.js +9 -3
  58. package/kits/base/sdk/hub.d.ts +37 -6
  59. package/kits/base/sdk/hub.js +63 -4
  60. package/kits/base/sdk/multiplayer.d.ts +7 -1
  61. package/kits/base/sdk/multiplayer.js +148 -32
  62. package/kits/base/sdk/multiplayerProtocol.d.ts +2 -0
  63. package/kits/base/sdk/party.d.ts +23 -0
  64. package/kits/base/sdk/party.js +91 -0
  65. package/kits/base/sdk/reconnectBudget.d.ts +23 -0
  66. package/kits/base/sdk/reconnectBudget.js +96 -0
  67. package/kits/base/sdk/save.d.ts +38 -1
  68. package/kits/base/sdk/save.js +81 -7
  69. package/kits/base/sdk/server/hub.d.ts +117 -0
  70. package/kits/base/sdk/server/hub.js +119 -2
  71. package/kits/base/sdk/server/platformHandle.d.ts +43 -1
  72. package/kits/base/sdk/server/storage.d.ts +17 -0
  73. package/kits/base/sdk/server/storage.js +65 -3
  74. package/kits/base/sdk/server/wrapper.d.ts +43 -6
  75. package/kits/base/sdk/server/wrapper.js +93 -9
  76. package/kits/base/sdk/social.d.ts +9 -0
  77. package/kits/base/sdk/social.js +5 -0
  78. package/kits/hub-game/CLAUDE.md +451 -13
  79. package/kits/hub-game/README.md +63 -0
  80. package/kits/hub-game/blueprints/avatar-10.scene +28 -0
  81. package/kits/hub-game/blueprints/avatar-11.scene +28 -0
  82. package/kits/hub-game/blueprints/avatar-12.scene +28 -0
  83. package/kits/hub-game/blueprints/avatar-13.scene +28 -0
  84. package/kits/hub-game/blueprints/avatar-14.scene +28 -0
  85. package/kits/hub-game/blueprints/avatar-15.scene +28 -0
  86. package/kits/hub-game/blueprints/avatar-4.scene +28 -0
  87. package/kits/hub-game/blueprints/avatar-5.scene +28 -0
  88. package/kits/hub-game/blueprints/avatar-6.scene +28 -0
  89. package/kits/hub-game/blueprints/avatar-7.scene +28 -0
  90. package/kits/hub-game/blueprints/avatar-8.scene +28 -0
  91. package/kits/hub-game/blueprints/avatar-9.scene +28 -0
  92. package/kits/hub-game/castle.json +5 -5
  93. package/kits/hub-game/code/client/act.js +312 -0
  94. package/kits/hub-game/code/client/actionLayout.js +147 -0
  95. package/kits/hub-game/code/client/actionOverflow.js +556 -0
  96. package/kits/hub-game/code/client/actorBudget.js +47 -0
  97. package/kits/hub-game/code/client/arrivalCamera.js +50 -0
  98. package/kits/hub-game/code/client/askSlot.js +117 -0
  99. package/kits/hub-game/code/client/attention.js +11 -2
  100. package/kits/hub-game/code/client/avatar.js +311 -35
  101. package/kits/hub-game/code/client/avatarCap.js +228 -0
  102. package/kits/hub-game/code/client/avatarColors.js +70 -0
  103. package/kits/hub-game/code/client/avatarFaces.js +21 -0
  104. package/kits/hub-game/code/client/avatarShare.js +253 -0
  105. package/kits/hub-game/code/client/backVisibility.js +13 -0
  106. package/kits/hub-game/code/client/ballot.js +472 -0
  107. package/kits/hub-game/code/client/build.js +38 -0
  108. package/kits/hub-game/code/client/chat.js +41 -5
  109. package/kits/hub-game/code/client/chatModeration.js +5 -0
  110. package/kits/hub-game/code/client/chrome.js +2144 -160
  111. package/kits/hub-game/code/client/companion.js +716 -0
  112. package/kits/hub-game/code/client/companionDress.js +99 -0
  113. package/kits/hub-game/code/client/crowdNames.js +241 -0
  114. package/kits/hub-game/code/client/decor.js +515 -0
  115. package/kits/hub-game/code/client/defaultEnvironment.js +194 -0
  116. package/kits/hub-game/code/client/doorErrors.js +39 -0
  117. package/kits/hub-game/code/client/earned.js +131 -0
  118. package/kits/hub-game/code/client/emoteBubble.js +75 -0
  119. package/kits/hub-game/code/client/fall.js +18 -0
  120. package/kits/hub-game/code/client/farAvatars.js +233 -0
  121. package/kits/hub-game/code/client/firstJoin.js +9 -2
  122. package/kits/hub-game/code/client/fpsTelemetry.js +50 -0
  123. package/kits/hub-game/code/client/frameBatch.js +5 -0
  124. package/kits/hub-game/code/client/grab.js +368 -29
  125. package/kits/hub-game/code/client/hookLayer.js +385 -20
  126. package/kits/hub-game/code/client/hudCopy.js +51 -0
  127. package/kits/hub-game/code/client/hudRate.js +20 -0
  128. package/kits/hub-game/code/client/idle.js +177 -24
  129. package/kits/hub-game/code/client/interestCap.js +81 -0
  130. package/kits/hub-game/code/client/invites.js +231 -0
  131. package/kits/hub-game/code/client/joinError.js +9 -0
  132. package/kits/hub-game/code/client/keys.js +36 -0
  133. package/kits/hub-game/code/client/labelsNear.js +234 -0
  134. package/kits/hub-game/code/client/landscapeLayout.js +17 -0
  135. package/kits/hub-game/code/client/layoutCache.js +264 -0
  136. package/kits/hub-game/code/client/loadTelemetry.js +20 -0
  137. package/kits/hub-game/code/client/loadingCover.js +148 -0
  138. package/kits/hub-game/code/client/loadingEntry.js +8 -0
  139. package/kits/hub-game/code/client/menuIcons.js +34 -0
  140. package/kits/hub-game/code/client/menuRows.js +43 -0
  141. package/kits/hub-game/code/client/modelReady.js +7 -0
  142. package/kits/hub-game/code/client/pack.js +6 -2
  143. package/kits/hub-game/code/client/packFormat.js +3 -3
  144. package/kits/hub-game/code/client/padCueArrival.js +23 -0
  145. package/kits/hub-game/code/client/padCues.js +112 -0
  146. package/kits/hub-game/code/client/padOccupancy.js +88 -0
  147. package/kits/hub-game/code/client/padReadability.js +26 -0
  148. package/kits/hub-game/code/client/padRings.js +69 -0
  149. package/kits/hub-game/code/client/pushVisit.js +14 -0
  150. package/kits/hub-game/code/client/quality.js +205 -0
  151. package/kits/hub-game/code/client/qualityEntry.js +55 -0
  152. package/kits/hub-game/code/client/rehello.js +167 -0
  153. package/kits/hub-game/code/client/safeLayout.js +338 -0
  154. package/kits/hub-game/code/client/safeStyle.js +42 -0
  155. package/kits/hub-game/code/client/say.js +12 -3
  156. package/kits/hub-game/code/client/shot.js +146 -0
  157. package/kits/hub-game/code/client/shotFit.js +56 -0
  158. package/kits/hub-game/code/client/signIn.js +28 -0
  159. package/kits/hub-game/code/client/sound.js +63 -8
  160. package/kits/hub-game/code/client/soundscape.js +1151 -0
  161. package/kits/hub-game/code/client/soundscapeActions.js +99 -0
  162. package/kits/hub-game/code/client/soundscapeAmbience.js +453 -0
  163. package/kits/hub-game/code/client/soundscapeBaked.js +143 -0
  164. package/kits/hub-game/code/client/soundscapeBusker.js +217 -0
  165. package/kits/hub-game/code/client/soundscapeCourt.js +200 -0
  166. package/kits/hub-game/code/client/soundscapeCrowd.js +331 -0
  167. package/kits/hub-game/code/client/soundscapeCues.js +362 -0
  168. package/kits/hub-game/code/client/soundscapeMap.js +181 -0
  169. package/kits/hub-game/code/client/soundscapeMarket.js +176 -0
  170. package/kits/hub-game/code/client/soundscapeMusic.js +126 -0
  171. package/kits/hub-game/code/client/soundscapeMusicEngine.js +460 -0
  172. package/kits/hub-game/code/client/soundscapeSimlish.js +737 -0
  173. package/kits/hub-game/code/client/soundscapeSongs.js +127 -0
  174. package/kits/hub-game/code/client/soundscapeSongsRound3.js +63 -0
  175. package/kits/hub-game/code/client/soundscapeSynthesis.js +168 -0
  176. package/kits/hub-game/code/client/soundscapeUi.js +211 -0
  177. package/kits/hub-game/code/client/soundscapeVoice.js +1209 -0
  178. package/kits/hub-game/code/client/soundscapeWaves.js +206 -0
  179. package/kits/hub-game/code/client/spin.js +101 -0
  180. package/kits/hub-game/code/client/state.js +162 -1
  181. package/kits/hub-game/code/client/stuck.js +259 -0
  182. package/kits/hub-game/code/client/talk.js +714 -59
  183. package/kits/hub-game/code/client/tiers.js +543 -52
  184. package/kits/hub-game/code/client/toastBand.js +37 -0
  185. package/kits/hub-game/code/client/together.js +39 -2
  186. package/kits/hub-game/code/client/visibility.js +43 -0
  187. package/kits/hub-game/code/client/weakestLookBake.js +92 -0
  188. package/kits/hub-game/code/client/weakestTier.js +295 -0
  189. package/kits/hub-game/code/client/wear.js +461 -170
  190. package/kits/hub-game/code/client/worldLabels.js +241 -0
  191. package/kits/hub-game/code/client/yours.js +200 -0
  192. package/kits/hub-game/code/companionSpec.js +45 -0
  193. package/kits/hub-game/code/npcDisplayText.js +55 -0
  194. package/kits/hub-game/code/privateText.js +7 -0
  195. package/kits/hub-game/code/server/act.js +124 -0
  196. package/kits/hub-game/code/server/actions.js +138 -0
  197. package/kits/hub-game/code/server/actors.js +11 -2
  198. package/kits/hub-game/code/server/analytics.js +83 -0
  199. package/kits/hub-game/code/server/anonymousEntry.js +49 -0
  200. package/kits/hub-game/code/server/arrivalPose.js +36 -0
  201. package/kits/hub-game/code/server/ask.js +155 -0
  202. package/kits/hub-game/code/server/ballot.js +539 -0
  203. package/kits/hub-game/code/server/cells.js +100 -0
  204. package/kits/hub-game/code/server/companion.js +107 -0
  205. package/kits/hub-game/code/server/cues.js +70 -0
  206. package/kits/hub-game/code/server/decor.js +269 -0
  207. package/kits/hub-game/code/server/doorAnalytics.js +52 -0
  208. package/kits/hub-game/code/server/earned.js +478 -0
  209. package/kits/hub-game/code/server/frameBatch.js +183 -0
  210. package/kits/hub-game/code/server/friendBests.js +166 -0
  211. package/kits/hub-game/code/server/friendsAmong.js +272 -0
  212. package/kits/hub-game/code/server/history.js +7 -0
  213. package/kits/hub-game/code/server/hub.js +2510 -95
  214. package/kits/hub-game/code/server/idle.js +60 -12
  215. package/kits/hub-game/code/server/index.js +28 -6
  216. package/kits/hub-game/code/server/invites.js +19 -0
  217. package/kits/hub-game/code/server/labels.js +36 -2
  218. package/kits/hub-game/code/server/loadAbandon.js +106 -0
  219. package/kits/hub-game/code/server/manifest.js +586 -7
  220. package/kits/hub-game/code/server/menu.js +161 -0
  221. package/kits/hub-game/code/server/npcs.js +1025 -113
  222. package/kits/hub-game/code/server/observe.js +408 -0
  223. package/kits/hub-game/code/server/padOccupancy.js +85 -0
  224. package/kits/hub-game/code/server/party.js +2 -2
  225. package/kits/hub-game/code/server/players.js +30 -0
  226. package/kits/hub-game/code/server/resumePose.js +152 -0
  227. package/kits/hub-game/code/server/say.js +1 -1
  228. package/kits/hub-game/code/server/shot.js +110 -0
  229. package/kits/hub-game/code/server/standing.js +123 -0
  230. package/kits/hub-game/code/server/storageLimit.js +187 -0
  231. package/kits/hub-game/code/server/vis.js +175 -0
  232. package/kits/hub-game/code/server/wear.js +12 -0
  233. package/kits/hub-game/code/server/yours.js +59 -0
  234. package/kits/hub-game/code/shared/act.js +35 -0
  235. package/kits/hub-game/code/shared/cues.js +9 -0
  236. package/kits/hub-game/code/shared/danceIdle.js +28 -0
  237. package/kits/hub-game/code/shared/decor.js +41 -0
  238. package/kits/hub-game/code/shared/loadStages.js +12 -0
  239. package/kits/hub-game/code/shared/quality.js +74 -0
  240. package/kits/hub-game/code/shared/say.js +2 -0
  241. package/kits/hub-game/code/shared/shot.js +53 -0
  242. package/kits/hub-game/code/shared/spin.js +57 -0
  243. package/kits/hub-game/code/systems/hub.js +1753 -202
  244. package/kits/hub-game/docs/analytics.md +279 -0
  245. package/kits/hub-game/docs/content-pack.md +1 -1
  246. package/kits/hub-game/docs/contract.md +3475 -77
  247. package/kits/hub-game/docs/home-pieces.md +71 -0
  248. package/kits/hub-game/docs/observed-progress.md +252 -0
  249. package/kits/hub-game/main.jsx +2 -0
  250. package/kits/hub-game/models/avatar-10.pxmodel +28 -0
  251. package/kits/hub-game/models/avatar-11.pxmodel +28 -0
  252. package/kits/hub-game/models/avatar-12.pxmodel +27 -0
  253. package/kits/hub-game/models/avatar-13.pxmodel +24 -0
  254. package/kits/hub-game/models/avatar-14.pxmodel +29 -0
  255. package/kits/hub-game/models/avatar-15.pxmodel +24 -0
  256. package/kits/hub-game/models/avatar-4.pxmodel +29 -0
  257. package/kits/hub-game/models/avatar-5.pxmodel +27 -0
  258. package/kits/hub-game/models/avatar-6.pxmodel +26 -0
  259. package/kits/hub-game/models/avatar-7.pxmodel +25 -0
  260. package/kits/hub-game/models/avatar-8.pxmodel +24 -0
  261. package/kits/hub-game/models/avatar-9.pxmodel +30 -0
  262. package/kits/hub-game/models/earned/badge-round.pxmodel +100 -0
  263. package/kits/hub-game/models/earned/badge-shield.pxmodel +117 -0
  264. package/kits/hub-game/models/earned/badge-star.pxmodel +87 -0
  265. package/kits/hub-game/models/earned/belt-plain.pxmodel +72 -0
  266. package/kits/hub-game/models/earned/held-ball.pxmodel +43 -0
  267. package/kits/hub-game/models/earned/held-lantern.pxmodel +85 -0
  268. package/kits/hub-game/models/earned/held-net.pxmodel +57 -0
  269. package/kits/hub-game/models/earned/held-trophy.pxmodel +109 -0
  270. package/kits/hub-game/models/earned/pin-round.pxmodel +62 -0
  271. package/kits/hub-game/models/earned/sash-plain.pxmodel +66 -0
  272. package/kits/hub-game/models/earned/square/belt-plain.pxmodel +104 -0
  273. package/kits/hub-game/models/earned/square/sash-plain.pxmodel +98 -0
  274. package/kits/hub-game/models/hats/bat-clip.pxmodel +206 -0
  275. package/kits/hub-game/models/hats/beekeeper.pxmodel +149 -0
  276. package/kits/hub-game/models/hats/cap.pxmodel +162 -0
  277. package/kits/hub-game/models/hats/captain.pxmodel +178 -0
  278. package/kits/hub-game/models/hats/crooked-top.pxmodel +172 -0
  279. package/kits/hub-game/models/hats/flower-crown.pxmodel +451 -0
  280. package/kits/hub-game/models/hats/foam-crown.pxmodel +179 -0
  281. package/kits/hub-game/models/hats/lantern.pxmodel +230 -0
  282. package/kits/hub-game/models/hats/laurel.pxmodel +533 -0
  283. package/kits/hub-game/models/hats/lighthouse.pxmodel +96 -0
  284. package/kits/hub-game/models/hats/sailor.pxmodel +141 -0
  285. package/kits/hub-game/models/hats/souwester.pxmodel +131 -0
  286. package/kits/hub-game/models/hats/straw.pxmodel +139 -0
  287. package/kits/hub-game/models/hats/sunflower.pxmodel +406 -0
  288. package/kits/hub-game/models/hats/sweatband.pxmodel +112 -0
  289. package/kits/hub-game/models/hats/witch.pxmodel +147 -0
  290. package/kits/hub-game/package-lock.json +10 -1
  291. package/kits/hub-game/package.json +6 -2
  292. package/kits/hub-game/play/player.js +142 -0
  293. package/kits/hub-game/play/registry.js +47 -0
  294. package/kits/hub-game/play.jsx +37 -0
  295. package/kits/hub-game/scripts/check.mjs +117 -16
  296. package/kits/hub-game/scripts/companion-follower-wire.json +1 -0
  297. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +132 -0
  298. package/kits/hub-game/scripts/fixtures/decor-keyless.json +293 -0
  299. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +26 -0
  300. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +123 -0
  301. package/kits/hub-game/scripts/fixtures/interest-legacy.json +385 -0
  302. package/kits/hub-game/scripts/fixtures/npc-notes-v1.77.jsonl +4 -0
  303. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -0
  304. package/kits/hub-game/scripts/gen-avatars.mjs +933 -16
  305. package/kits/hub-game/scripts/gen-earned.mjs +285 -0
  306. package/kits/hub-game/scripts/gen-hats.mjs +827 -0
  307. package/kits/hub-game/scripts/grab.before-orbit.mjs +400 -0
  308. package/kits/hub-game/scripts/pose-storage-fixture.mjs +46 -0
  309. package/kits/hub-game/scripts/soundscape-wave-analysis.mjs +125 -0
  310. package/kits/hub-game/scripts/test-act-client.mjs +186 -0
  311. package/kits/hub-game/scripts/test-act.mjs +171 -0
  312. package/kits/hub-game/scripts/test-action-layout.mjs +80 -0
  313. package/kits/hub-game/scripts/test-action-observers.mjs +46 -0
  314. package/kits/hub-game/scripts/test-actions-client.mjs +853 -0
  315. package/kits/hub-game/scripts/test-actions.mjs +298 -0
  316. package/kits/hub-game/scripts/test-actor-budget.mjs +44 -0
  317. package/kits/hub-game/scripts/test-actors.mjs +38 -23
  318. package/kits/hub-game/scripts/test-analytics.mjs +76 -0
  319. package/kits/hub-game/scripts/test-anonymous-entry.mjs +28 -0
  320. package/kits/hub-game/scripts/test-arrival-pose-server.mjs +196 -0
  321. package/kits/hub-game/scripts/test-arrival-pose.mjs +24 -0
  322. package/kits/hub-game/scripts/test-ask-client.mjs +358 -0
  323. package/kits/hub-game/scripts/test-ask-slot.mjs +85 -0
  324. package/kits/hub-game/scripts/test-ask.mjs +269 -0
  325. package/kits/hub-game/scripts/test-attention.mjs +10 -1
  326. package/kits/hub-game/scripts/test-avatar-cap.mjs +379 -0
  327. package/kits/hub-game/scripts/test-avatar-colors.mjs +72 -0
  328. package/kits/hub-game/scripts/test-avatar-models.mjs +181 -0
  329. package/kits/hub-game/scripts/test-avatar-share.mjs +318 -0
  330. package/kits/hub-game/scripts/test-avatar-wire.mjs +792 -0
  331. package/kits/hub-game/scripts/test-avatar.mjs +584 -7
  332. package/kits/hub-game/scripts/test-back-visibility.mjs +82 -0
  333. package/kits/hub-game/scripts/test-ballot.mjs +1008 -0
  334. package/kits/hub-game/scripts/test-ban-join.mjs +121 -13
  335. package/kits/hub-game/scripts/test-build.mjs +49 -0
  336. package/kits/hub-game/scripts/test-cells.mjs +71 -0
  337. package/kits/hub-game/scripts/test-chat.mjs +863 -0
  338. package/kits/hub-game/scripts/test-classic.mjs +2 -0
  339. package/kits/hub-game/scripts/test-companion-chat.mjs +216 -0
  340. package/kits/hub-game/scripts/test-companion-client.mjs +1167 -0
  341. package/kits/hub-game/scripts/test-companion.mjs +259 -0
  342. package/kits/hub-game/scripts/test-control-layout-dom.mjs +120 -0
  343. package/kits/hub-game/scripts/test-crowd-names.mjs +205 -0
  344. package/kits/hub-game/scripts/test-decor-client.mjs +344 -0
  345. package/kits/hub-game/scripts/test-decor.mjs +464 -0
  346. package/kits/hub-game/scripts/test-default-environment-root.mjs +95 -0
  347. package/kits/hub-game/scripts/test-default-environment.mjs +267 -0
  348. package/kits/hub-game/scripts/test-door-analytics.mjs +58 -0
  349. package/kits/hub-game/scripts/test-door-jump.mjs +100 -0
  350. package/kits/hub-game/scripts/test-earned-client.mjs +459 -0
  351. package/kits/hub-game/scripts/test-earned.mjs +1224 -0
  352. package/kits/hub-game/scripts/test-emote-bubble.mjs +110 -0
  353. package/kits/hub-game/scripts/test-far-avatars.mjs +340 -0
  354. package/kits/hub-game/scripts/test-fps-telemetry.mjs +112 -0
  355. package/kits/hub-game/scripts/test-frame-batch.mjs +252 -0
  356. package/kits/hub-game/scripts/test-fresh-friends.mjs +118 -0
  357. package/kits/hub-game/scripts/test-friend-bests.mjs +435 -0
  358. package/kits/hub-game/scripts/test-grab-orbit.mjs +961 -0
  359. package/kits/hub-game/scripts/test-grab.mjs +7 -0
  360. package/kits/hub-game/scripts/test-hats.mjs +422 -168
  361. package/kits/hub-game/scripts/test-high-only.mjs +170 -0
  362. package/kits/hub-game/scripts/test-hub-leaving.mjs +203 -0
  363. package/kits/hub-game/scripts/test-hub-ops.mjs +758 -2
  364. package/kits/hub-game/scripts/test-hub-trip.mjs +1594 -12
  365. package/kits/hub-game/scripts/test-hud-clear.mjs +484 -57
  366. package/kits/hub-game/scripts/test-hud-defects-dom.mjs +100 -0
  367. package/kits/hub-game/scripts/test-hud-rate.mjs +224 -0
  368. package/kits/hub-game/scripts/test-hud-safe-visibility-dom.mjs +83 -0
  369. package/kits/hub-game/scripts/test-idle.mjs +427 -1
  370. package/kits/hub-game/scripts/test-interest-cap.mjs +36 -0
  371. package/kits/hub-game/scripts/test-interest-cells.mjs +513 -0
  372. package/kits/hub-game/scripts/test-interest-client.mjs +118 -0
  373. package/kits/hub-game/scripts/test-interest.mjs +15 -0
  374. package/kits/hub-game/scripts/test-invites-client.mjs +430 -0
  375. package/kits/hub-game/scripts/test-invites.mjs +109 -0
  376. package/kits/hub-game/scripts/test-keys.mjs +46 -1
  377. package/kits/hub-game/scripts/test-labels.mjs +664 -0
  378. package/kits/hub-game/scripts/test-landscape-layout.mjs +194 -0
  379. package/kits/hub-game/scripts/test-list-scroll-dom.mjs +49 -0
  380. package/kits/hub-game/scripts/test-load-abandon.mjs +246 -0
  381. package/kits/hub-game/scripts/test-loading-cover.mjs +162 -0
  382. package/kits/hub-game/scripts/test-manifest.mjs +472 -0
  383. package/kits/hub-game/scripts/test-menu-client.mjs +585 -0
  384. package/kits/hub-game/scripts/test-menu.mjs +319 -0
  385. package/kits/hub-game/scripts/test-npcs.mjs +2528 -13
  386. package/kits/hub-game/scripts/test-object-entry.mjs +76 -0
  387. package/kits/hub-game/scripts/test-observed.mjs +745 -0
  388. package/kits/hub-game/scripts/test-pack.mjs +7 -0
  389. package/kits/hub-game/scripts/test-pad-cues.mjs +304 -0
  390. package/kits/hub-game/scripts/test-pad-occupancy.mjs +177 -0
  391. package/kits/hub-game/scripts/test-picker.mjs +541 -0
  392. package/kits/hub-game/scripts/test-placement-cache.mjs +690 -0
  393. package/kits/hub-game/scripts/test-progress-reset.mjs +559 -0
  394. package/kits/hub-game/scripts/test-push-visit.mjs +26 -0
  395. package/kits/hub-game/scripts/test-quality.mjs +385 -0
  396. package/kits/hub-game/scripts/test-rehello.mjs +1733 -0
  397. package/kits/hub-game/scripts/test-relations-among.mjs +222 -0
  398. package/kits/hub-game/scripts/test-relations-refresh.mjs +188 -0
  399. package/kits/hub-game/scripts/test-resume-action-order.mjs +598 -0
  400. package/kits/hub-game/scripts/test-resume-held.mjs +239 -0
  401. package/kits/hub-game/scripts/test-resume-pose.mjs +142 -0
  402. package/kits/hub-game/scripts/test-safe-events-dom.mjs +116 -0
  403. package/kits/hub-game/scripts/test-safe-layout.mjs +330 -0
  404. package/kits/hub-game/scripts/test-say.mjs +1 -1
  405. package/kits/hub-game/scripts/test-shot.mjs +901 -0
  406. package/kits/hub-game/scripts/test-signin-client.mjs +45 -0
  407. package/kits/hub-game/scripts/test-soundscape.mjs +5437 -0
  408. package/kits/hub-game/scripts/test-spin.mjs +314 -0
  409. package/kits/hub-game/scripts/test-standing.mjs +449 -0
  410. package/kits/hub-game/scripts/test-storage-limit.mjs +333 -0
  411. package/kits/hub-game/scripts/test-stuck.mjs +1904 -0
  412. package/kits/hub-game/scripts/test-talk-overlay-dom.mjs +130 -0
  413. package/kits/hub-game/scripts/test-tier-cells.mjs +706 -0
  414. package/kits/hub-game/scripts/test-tiers-render.mjs +412 -0
  415. package/kits/hub-game/scripts/test-tiers.mjs +476 -2
  416. package/kits/hub-game/scripts/test-toast-band.mjs +61 -0
  417. package/kits/hub-game/scripts/test-try-on.mjs +22 -22
  418. package/kits/hub-game/scripts/test-vis.mjs +770 -0
  419. package/kits/hub-game/scripts/test-visibility.mjs +134 -0
  420. package/kits/hub-game/scripts/test-weakest-tier.mjs +924 -0
  421. package/kits/hub-game/scripts/test-world-labels.mjs +367 -0
  422. package/kits/hub-game/scripts/test-yours-chrome.mjs +210 -0
  423. package/kits/hub-game/scripts/test-yours.mjs +403 -0
  424. package/kits/multiplayer-3d/CLAUDE.md +50 -0
  425. package/kits/multiplayer-3d/castle.json +5 -5
  426. package/kits/multiplayer-3d/code/client/avatars.js +7 -0
  427. package/kits/multiplayer-3d/code/client/gait.js +65 -0
  428. package/kits/multiplayer-3d/code/client/joinFailure.js +27 -0
  429. package/kits/multiplayer-3d/code/client/nameTags.js +59 -4
  430. package/kits/multiplayer-3d/code/client/resumeGate.js +139 -0
  431. package/kits/multiplayer-3d/code/options.js +5 -0
  432. package/kits/multiplayer-3d/code/server/ownership.js +10 -2
  433. package/kits/multiplayer-3d/code/server/sceneBodies.js +12 -0
  434. package/kits/multiplayer-3d/code/server/world.js +7 -0
  435. package/kits/multiplayer-3d/code/systems/multiplayer.js +443 -34
  436. package/kits/multiplayer-3d/package-lock.json +8 -1
  437. package/kits/multiplayer-3d/package.json +3 -1
  438. package/kits/multiplayer-3d/scripts/fixtures/README.md +11 -0
  439. package/kits/multiplayer-3d/scripts/fixtures/ownership-legacy.json +2 -0
  440. package/kits/multiplayer-3d/scripts/ownership-harness.mjs +102 -0
  441. package/kits/multiplayer-3d/scripts/ownership-loader.mjs +46 -0
  442. package/kits/multiplayer-3d/scripts/ownership-worker.mjs +15 -0
  443. package/kits/multiplayer-3d/scripts/record-ownership-session.mjs +98 -0
  444. package/kits/multiplayer-3d/scripts/test-eligible-claims.mjs +167 -0
  445. package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +436 -0
  446. package/kits/multiplayer-3d/scripts/test-own-name-tag.mjs +247 -0
  447. package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +624 -0
  448. package/kits/physics-2d/CLAUDE.md +19 -1
  449. package/kits/physics-2d/castle.json +2 -2
  450. package/kits/physics-2d/engine/frozenActors.js +233 -0
  451. package/kits/physics-2d/engine/scene.js +337 -3
  452. package/kits/physics-2d/engine/skyKey.js +129 -0
  453. package/kits/physics-2d/engine/stillClock.js +106 -0
  454. package/kits/physics-2d/engine/updateBudget.js +21 -0
  455. package/kits/physics-2d/eslint.config.js +1 -1
  456. package/kits/physics-2d/play/behaviors/AnalogStick.js +198 -0
  457. package/kits/physics-2d/play/behaviors/Camera.js +40 -0
  458. package/kits/physics-2d/play/behaviors/Collider.js +122 -0
  459. package/kits/physics-2d/play/behaviors/Draggable.js +115 -0
  460. package/kits/physics-2d/play/behaviors/Goal.js +46 -0
  461. package/kits/physics-2d/play/behaviors/Joints.js +126 -0
  462. package/kits/physics-2d/play/behaviors/Layout.js +71 -0
  463. package/kits/physics-2d/play/behaviors/RigidBody.js +57 -0
  464. package/kits/physics-2d/play/behaviors/Slingshot.js +142 -0
  465. package/kits/physics-2d/play/behaviors/SoundPlayer.js +263 -0
  466. package/kits/physics-2d/play/behaviors/Sprite.js +406 -0
  467. package/kits/physics-2d/play/behaviors/Style.js +209 -0
  468. package/kits/physics-2d/play/behaviors/Text.js +85 -0
  469. package/kits/physics-2d/play/behaviors/Video.js +93 -0
  470. package/kits/physics-2d/scripts/test-skip-unchanged.mjs +326 -1
  471. package/kits/physics-3d/CLAUDE.md +42 -529
  472. package/kits/physics-3d/behaviors/Body.jsx +3 -0
  473. package/kits/physics-3d/behaviors/Model.jsx +3 -0
  474. package/kits/physics-3d/behaviors/Player.jsx +661 -87
  475. package/kits/physics-3d/behaviors/Shape.jsx +3 -0
  476. package/kits/physics-3d/behaviors/Solid.jsx +3 -0
  477. package/kits/physics-3d/behaviors/Transform.jsx +3 -0
  478. package/kits/physics-3d/castle.json +3 -3
  479. package/kits/physics-3d/docs/engine-camera.md +542 -0
  480. package/kits/physics-3d/docs/engine-frame-cap.md +136 -0
  481. package/kits/physics-3d/docs/engine-load.md +149 -0
  482. package/kits/physics-3d/docs/engine-look.md +114 -0
  483. package/kits/physics-3d/docs/engine-shadows.md +372 -0
  484. package/kits/physics-3d/docs/engine-skip-work.md +187 -0
  485. package/kits/physics-3d/docs/engine-sky.md +198 -0
  486. package/kits/physics-3d/docs/engine-static-actors.md +226 -0
  487. package/kits/physics-3d/docs/engine-view.md +37 -0
  488. package/kits/physics-3d/docs/pxmodel-format.md +9 -1
  489. package/kits/physics-3d/engine3d/PlayOnly3D.jsx +5 -1
  490. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +19 -277
  491. package/kits/physics-3d/engine3d/actornode.js +87 -0
  492. package/kits/physics-3d/engine3d/animationBudget.js +23 -0
  493. package/kits/physics-3d/engine3d/branches.js +3 -13
  494. package/kits/physics-3d/engine3d/cage.js +2 -7
  495. package/kits/physics-3d/engine3d/cageops.js +2 -17
  496. package/kits/physics-3d/engine3d/dataBehaviors.js +12 -0
  497. package/kits/physics-3d/engine3d/editorWorld.js +6 -0
  498. package/kits/physics-3d/engine3d/emptynodes.js +232 -0
  499. package/kits/physics-3d/engine3d/framecap.js +99 -0
  500. package/kits/physics-3d/engine3d/frozenphysics.js +140 -0
  501. package/kits/physics-3d/engine3d/frozenstatics.js +273 -0
  502. package/kits/physics-3d/engine3d/gait.js +126 -0
  503. package/kits/physics-3d/engine3d/initialModelFiles.js +18 -0
  504. package/kits/physics-3d/engine3d/kithooks.js +47 -0
  505. package/kits/physics-3d/engine3d/look.js +514 -48
  506. package/kits/physics-3d/engine3d/lookbake.js +208 -0
  507. package/kits/physics-3d/engine3d/materialpresets.js +2 -0
  508. package/kits/physics-3d/engine3d/modelFiles.js +3 -17
  509. package/kits/physics-3d/engine3d/modelMath.js +49 -0
  510. package/kits/physics-3d/engine3d/modelready.js +16 -0
  511. package/kits/physics-3d/engine3d/motion.js +39 -10
  512. package/kits/physics-3d/engine3d/nearshadows.js +106 -21
  513. package/kits/physics-3d/engine3d/optimize.js +9 -5
  514. package/kits/physics-3d/engine3d/orbitinput.js +522 -10
  515. package/kits/physics-3d/engine3d/orbitlens.js +48 -0
  516. package/kits/physics-3d/engine3d/ownmodel.js +213 -0
  517. package/kits/physics-3d/engine3d/partgeometry.js +1 -16
  518. package/kits/physics-3d/engine3d/paths.js +1 -9
  519. package/kits/physics-3d/engine3d/playTimings.js +50 -0
  520. package/kits/physics-3d/engine3d/playerRun.js +372 -0
  521. package/kits/physics-3d/engine3d/pxmodel.js +42 -11
  522. package/kits/physics-3d/engine3d/rapier.js +27 -0
  523. package/kits/physics-3d/engine3d/scatter.js +1 -11
  524. package/kits/physics-3d/engine3d/shadowfade.js +890 -0
  525. package/kits/physics-3d/engine3d/sky.js +547 -0
  526. package/kits/physics-3d/engine3d/skylife.js +306 -0
  527. package/kits/physics-3d/engine3d/squarefirst.js +177 -0
  528. package/kits/physics-3d/engine3d/stillshadows.js +399 -0
  529. package/kits/physics-3d/engine3d/sweep.js +1 -25
  530. package/kits/physics-3d/engine3d/unchanged.js +11 -0
  531. package/kits/physics-3d/engine3d/viewrange.js +52 -0
  532. package/kits/physics-3d/engine3d/world3d.js +1253 -76
  533. package/kits/physics-3d/eslint.config.js +2 -1
  534. package/kits/physics-3d/main.jsx +10 -2
  535. package/kits/physics-3d/package-lock.json +7 -0
  536. package/kits/physics-3d/package.json +5 -1
  537. package/kits/physics-3d/play/behaviors/Body.js +31 -0
  538. package/kits/physics-3d/play/behaviors/Door.js +37 -0
  539. package/kits/physics-3d/play/behaviors/Lookable.js +16 -0
  540. package/kits/physics-3d/play/behaviors/Model.js +23 -0
  541. package/kits/physics-3d/play/behaviors/Pickup.js +46 -0
  542. package/kits/physics-3d/play/behaviors/Player.js +1204 -0
  543. package/kits/physics-3d/play/behaviors/Shape.js +47 -0
  544. package/kits/physics-3d/play/behaviors/Solid.js +16 -0
  545. package/kits/physics-3d/play/behaviors/Transform.js +29 -0
  546. package/kits/physics-3d/pnpm-lock.yaml +8 -0
  547. package/kits/physics-3d/scripts/bench-shadow-fade.mjs +37 -0
  548. package/kits/physics-3d/scripts/build-rapier-gz.mjs +56 -0
  549. package/kits/physics-3d/scripts/frozen-statics-fixture.mjs +141 -0
  550. package/kits/physics-3d/scripts/look-baseline.mjs +155 -0
  551. package/kits/physics-3d/scripts/test-camera-follow.mjs +5 -1
  552. package/kits/physics-3d/scripts/test-camera-orbit.mjs +2613 -82
  553. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +2 -2
  554. package/kits/physics-3d/scripts/test-empty-gait-hints.mjs +89 -0
  555. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +438 -0
  556. package/kits/physics-3d/scripts/test-frame-cap.mjs +452 -0
  557. package/kits/physics-3d/scripts/test-frozen-nested.mjs +49 -0
  558. package/kits/physics-3d/scripts/test-frozen-statics-legacy-physics2d.mjs +123 -0
  559. package/kits/physics-3d/scripts/test-frozen-statics.mjs +434 -0
  560. package/kits/physics-3d/scripts/test-gait.mjs +387 -0
  561. package/kits/physics-3d/scripts/test-look-bake.mjs +1056 -0
  562. package/kits/physics-3d/scripts/test-model-parse-cache.mjs +92 -0
  563. package/kits/physics-3d/scripts/test-near-shadows.mjs +5 -2
  564. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +2001 -0
  565. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +582 -0
  566. package/kits/physics-3d/scripts/test-orbit-shot.mjs +657 -0
  567. package/kits/physics-3d/scripts/test-orbit-view.mjs +230 -0
  568. package/kits/physics-3d/scripts/test-rapier-gz.mjs +106 -0
  569. package/kits/physics-3d/scripts/test-skip-empty-nodes.mjs +845 -0
  570. package/kits/physics-3d/scripts/test-sky.mjs +2470 -0
  571. package/kits/physics-3d/scripts/test-square-first.mjs +921 -0
  572. package/kits/physics-3d/scripts/test-static-actors.mjs +10 -1
  573. package/kits/physics-3d/scripts/test-static-physics.mjs +4 -1
  574. package/kits/physics-3d/scripts/test-static-scenery.mjs +2174 -0
  575. package/kits/physics-3d/scripts/test-steady-hover.mjs +7 -2
  576. package/kits/physics-3d/scripts/test-still-shadows.mjs +477 -0
  577. package/kits/physics-3d/scripts/test-view-range.mjs +260 -0
  578. package/kits/physics-3d/systems/physics3d.js +419 -9
  579. package/kits/real-time/castle.json +2 -2
  580. package/kits/real-time/code/client/connection.js +33 -10
  581. package/kits/real-time/code/client/gameHooks.js +2 -0
  582. package/kits/real-time/code/client/joinOverlay.js +9 -4
  583. package/kits/real-time/code/server/gameHooks.js +7 -0
  584. package/kits/real-time/code/server/session.js +102 -22
  585. package/kits/real-time/package-lock.json +1 -1
  586. package/package.json +2 -2
  587. 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
+ }
@@ -0,0 +1,177 @@
1
+ // The dormant engine.load key. Invalid settings leave the old path alone.
2
+ import { parseModelCached } from './pxmodel';
3
+ import { modelAnimation } from './motion';
4
+ import { resolveModelRef, MAX_MODEL_DEPTH } from './modelrefs';
5
+ import { isDataBehavior } from './dataBehaviors.js';
6
+ import { Vector3 } from 'three';
7
+
8
+ export function readLoadKey(data) {
9
+ const load = data?.engine?.load;
10
+ if (!load || typeof load !== 'object' || Array.isArray(load) ||
11
+ Object.keys(load).some(key => !['first', 'sliceMs', 'inert', 'horizon'].includes(key))) return null;
12
+ if (load.inert !== undefined && (!Array.isArray(load.inert) ||
13
+ !load.inert.every(name => typeof name === 'string' && name.length > 0))) return null;
14
+ const inert = load.inert === undefined ? {} : { inert: [...load.inert] };
15
+ const sliceMs = load.sliceMs === undefined ? 8 : load.sliceMs;
16
+ if (!Number.isFinite(sliceMs) || sliceMs < 1 || sliceMs > 50) return null;
17
+ const horizon = load.horizon === undefined ? 45 : load.horizon;
18
+ if (!Number.isFinite(horizon) || horizon < 0) return null;
19
+ const first = load.first;
20
+ if (Array.isArray(first)) {
21
+ return first.every(id => typeof id === 'string' && id.length > 0) ? { first: [...first], sliceMs, horizon, ...inert } : null;
22
+ }
23
+ if (!first || typeof first !== 'object' || Object.keys(first).length !== 1 ||
24
+ !Number.isFinite(first.radius) || first.radius <= 0) return null;
25
+ return { first: { radius: first.radius }, sliceMs, horizon, ...inert };
26
+ }
27
+
28
+ const BIPED_PARTS = new Set(['legL', 'legR', 'armL', 'armR', 'torso']);
29
+
30
+ function modelMayWait(model, files, path, chain = [path]) {
31
+ if (modelAnimation(model)) return false;
32
+ for (const part of model.parts) {
33
+ if (BIPED_PARTS.has(part.id) || part.keep || part.tint || part.id.startsWith('slot-')) return false;
34
+ if (part.kind !== 'model') continue;
35
+ const ref = resolveModelRef(part.src, path);
36
+ if (chain.includes(ref) || chain.length > MAX_MODEL_DEPTH) continue;
37
+ const inner = parseModelCached(files?.[ref]);
38
+ if (inner && !modelMayWait(inner, files, ref, [...chain, ref])) return false;
39
+ }
40
+ return true;
41
+ }
42
+
43
+ function componentsMayWait(runtime, actor, inert, names) {
44
+ if (!actor.components.Transform || 'Player' in actor.components ||
45
+ actor.id === runtime.orbitOwnModel || actor.id === runtime.followCamera?.id || actor.runtime?.modelClip) return false;
46
+ for (const name of names) {
47
+ const Behavior = runtime.behaviors?.get(name);
48
+ // SceneRuntime skips an unregistered component entirely. Registered
49
+ // custom classes block even if disabled or constructor-only, unless the
50
+ // deck explicitly promises they never consume this actor's visual.
51
+ if (!Behavior || inert.includes(name)) continue;
52
+ if (!isDataBehavior(name, Behavior)) return false;
53
+ }
54
+ return true;
55
+ }
56
+
57
+ export function actorMayWait(world, runtime, actor, inert = []) {
58
+ if (!componentsMayWait(runtime, actor, inert, Object.keys(actor.components))) return false;
59
+ const file = actor.components.Model?.file;
60
+ const model = file && parseModelCached(runtime.files?.[file]);
61
+ if (!model || !modelMayWait(model, runtime.files, file)) return false;
62
+ for (const object of world.ownModelWith ?? []) {
63
+ for (let node = object; node; node = node.parent) if (node.userData?.actorId === actor.id) return false;
64
+ }
65
+ return true;
66
+ }
67
+
68
+ // Track broad registry changes as well as each waiter's own class identities:
69
+ // a remove+add can change registrations without changing Map identity or size.
70
+ // A revision lets pair checks update one waiter independently of the others.
71
+ export function consumerRegistryVersion(load) {
72
+ const registry = load.runtime.behaviors;
73
+ if (registry !== load.consumerRegistry || registry?.size !== load.consumerRegistrySize) {
74
+ load.consumerRegistry = registry;
75
+ load.consumerRegistrySize = registry?.size;
76
+ load.consumerRevision++;
77
+ }
78
+ return load.consumerRevision;
79
+ }
80
+
81
+ export function rememberModelConsumer(load, actor) {
82
+ const names = Object.keys(actor.components);
83
+ return { names, classes: names.map(name => load.runtime.behaviors?.get(name)),
84
+ count: names.length, revision: consumerRegistryVersion(load) };
85
+ }
86
+
87
+ // This dispatch fence reads component membership, never model contents or
88
+ // render signatures. Unchanged frames allocate no arrays; class identity costs
89
+ // only one Map lookup per captured component, including unregistered names.
90
+ export function modelConsumerChanged(load, wait, revision) {
91
+ const { actor, consumer } = wait;
92
+ const c = actor.components, runtime = load.runtime;
93
+ if (!c.Transform || 'Player' in c || actor.id === runtime.orbitOwnModel ||
94
+ actor.id === runtime.followCamera?.id || actor.runtime?.modelClip) return true;
95
+ let count = 0;
96
+ for (const name in c) if (Object.hasOwn(c, name)) count++;
97
+ // A remove+add can preserve the count. Promote conservatively if an old key
98
+ // vanished, without allocating a new list just to discover its replacement.
99
+ if (count === consumer.count) for (const name of consumer.names) if (!Object.hasOwn(c, name)) return true;
100
+ let classesChanged = false;
101
+ for (let i = 0; i < consumer.names.length; i++) {
102
+ if (runtime.behaviors?.get(consumer.names[i]) !== consumer.classes[i]) classesChanged = true;
103
+ }
104
+ if (count === consumer.count && revision === consumer.revision && !classesChanged) return false;
105
+ const names = Object.keys(c);
106
+ consumer.names = names; consumer.classes = names.map(name => runtime.behaviors?.get(name));
107
+ consumer.count = count; consumer.revision = revision;
108
+ return !componentsMayWait(runtime, actor, load.inert ?? [], names);
109
+ }
110
+
111
+ const playerTransform = actors => actors.find(actor => 'Player' in actor.components)?.components.Transform;
112
+
113
+ // Cache eligibility until the focus moves over 1 m or pending membership /
114
+ // placement changes. Dynamic and tier-detached moves invalidate during sync.
115
+ export function nearModelKeys(world, load) {
116
+ const previous = load.nearCache;
117
+ if (load.horizon === 0 || !load.pending.size) {
118
+ if (previous?.revision === load.pendingRevision) return previous.near;
119
+ const near = new Set(load.pending.keys());
120
+ load.nearCache = { near, revision: load.pendingRevision };
121
+ return near;
122
+ }
123
+ const actors = load.runtime.actors;
124
+ let player = previous?.player;
125
+ if (!player || !previous || previous.revision !== load.pendingRevision || previous.actors !== actors ||
126
+ previous.actorCount !== actors?.size || (player &&
127
+ (load.runtime.getActor(player.id) !== player || !('Player' in player.components)))) {
128
+ player = load.runtime.getActors().find(actor => 'Player' in actor.components);
129
+ }
130
+ const centre = player?.components.Transform ?? world.camera.getWorldPosition(load.horizonCamera ??= new Vector3());
131
+ if (previous && previous.revision === load.pendingRevision && previous.player === player &&
132
+ Math.hypot(centre.x - previous.x, centre.z - previous.z) <= 1) {
133
+ previous.actors = actors; previous.actorCount = actors?.size;
134
+ return previous.near;
135
+ }
136
+ const near = new Set();
137
+ for (const [key, waits] of load.pending) {
138
+ for (const wait of waits) {
139
+ const t = wait.actor.components.Transform;
140
+ if (t && Math.hypot(t.x - centre.x, t.z - centre.z) <= load.horizon) {
141
+ near.add(key);
142
+ break;
143
+ }
144
+ }
145
+ }
146
+ load.nearCache = { near, revision: load.pendingRevision, player, actors, actorCount: actors?.size, x: centre.x, z: centre.z };
147
+ return near;
148
+ }
149
+
150
+ export function makeModelLoad(world, runtime, setting) {
151
+ const actors = runtime.getActors();
152
+ // Player is a component/behaviour, as in Door/Pickup and the Player itself.
153
+ const centre = playerTransform(actors) ?? { x: 0, z: 0 };
154
+ const ids = Array.isArray(setting.first) ? new Set(setting.first) : null;
155
+ const firstFiles = new Set();
156
+ for (const actor of actors) {
157
+ const t = actor.components.Transform;
158
+ if (!t) continue;
159
+ const selected = ids ? ids.has(actor.id) : Math.hypot(t.x - centre.x, t.z - centre.z) <= setting.first.radius;
160
+ if (selected || world.instanceModels || !actorMayWait(world, runtime, actor, setting.inert)) firstFiles.add(actor.components.Model?.file);
161
+ }
162
+ return {
163
+ runtime, data: runtime.data, sceneKey: runtime.sceneKey ?? runtime.scenePath,
164
+ setting: JSON.stringify(setting), sliceMs: setting.sliceMs, horizon: setting.horizon, inert: setting.inert, firstFiles,
165
+ pending: new Map(), built: new Set(), firstKeys: new Set(), deferredKeys: new Set(),
166
+ pendingRevision: 0, nearCache: null,
167
+ consumerRegistry: runtime.behaviors, consumerRegistrySize: runtime.behaviors?.size, consumerRevision: 0,
168
+ synced: false, drawn: false, restMarked: false, draining: false,
169
+ drawnAt: null, frameIntervals: [], skippedFrames: 0,
170
+ now: () => performance.now(),
171
+ };
172
+ }
173
+
174
+ export function loadSummary(load, world) {
175
+ return Object.freeze({ pending: load.pending.size, near: nearModelKeys(world, load).size, built: load.built.size,
176
+ firstKeys: load.firstKeys.size, deferredKeys: load.deferredKeys.size });
177
+ }