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,208 @@
1
+ // Scenes that set `"engine": { "look": { "bake": "deferred" } }`
2
+ //
3
+ // The look (look.js) bakes two things into a model when it is built: the
4
+ // occlusion, by marching rays through a grid of the model's surfaces, and the
5
+ // attributes its outline hulls are pushed out by. On a slow phone that is
6
+ // several seconds of a town's load, all of it before the first frame. For a
7
+ // scene that asks, a model is built without them and drawn at once, and the
8
+ // baking is queued here: a little of it is done after each frame is drawn,
9
+ // until none is left.
10
+ //
11
+ // A task is one model's baking, cut into steps (look.js `bakeLater`). A step
12
+ // is never interrupted, so one that takes longer than the budget runs to its
13
+ // end and nothing else starts that frame.
14
+ //
15
+ // A task writes into the geometries of a model the world may release before
16
+ // the task has run. It listens for each one's `dispose`: a geometry that has
17
+ // been disposed is not written to, and a task none of whose geometries is
18
+ // left is dropped.
19
+ //
20
+ // A copy made of a geometry while it waits (`geometry.clone()`, as motion.js
21
+ // makes for a part that glows and a deck may for its own ends) waits with it,
22
+ // so a mesh whose geometry was replaced by a copy, the first one disposed, is
23
+ // still baked. For the length of a task each of its geometries has a `clone`
24
+ // of its own (`cloneWaiting`) that adds the copy to the task. What that keeps
25
+ // true, between here and look.js:
26
+ //
27
+ // When a task ends as `baked`, every geometry in it that has not been
28
+ // disposed, the ones it was queued with and every copy alike, holds the
29
+ // whole of the baking: whenever the copy was made (before the task began,
30
+ // between two of its stages, between two steps of one), and whatever it was
31
+ // made from (a geometry already written, one not yet, or one disposed and
32
+ // never written). Otherwise the task ends as `dropped`.
33
+ //
34
+ // It holds because nothing is read back from a geometry: the task keeps each
35
+ // stage's result for each geometry it was queued with, and keeps which stages
36
+ // each geometry holds; a copy starts with what its source held and is given
37
+ // the rest when it is made, and each stage that finishes later is given to
38
+ // every copy there is (look.js `settle`). The one geometry that cannot be
39
+ // given a result is one whose vertices were replaced by another number of
40
+ // them, and a task that ends with such a one not disposed is `dropped`.
41
+ //
42
+ // Once the task has ended, however it ended, the `clone` of its own is gone
43
+ // and a geometry is cloned as any other; so is one whose `clone` was taken
44
+ // hold of while it waited and called afterwards.
45
+
46
+ // How long the baking may take out of a frame, in milliseconds, unless the
47
+ // step that passes it is still running.
48
+ const BUDGET_MS = 6;
49
+
50
+ // The queue a world keeps (`world.lookBake`). `pending` is how many models
51
+ // are still to bake, `ms` the time spent baking so far, `baked` how many
52
+ // tasks ran to the end and left the whole of the baking in every geometry
53
+ // not disposed, and `dropped` how many did not: dropped unfinished, or ended
54
+ // with a geometry they could not write to.
55
+ // `budgetMs` and `now` can be set.
56
+ //
57
+ // `shown` is what a harness or a capture waits for: true once a frame has
58
+ // been drawn with nothing pending, so the picture on screen is the complete
59
+ // one, and false again from the moment a model is queued. `pending` reaching
60
+ // 0 is not that: the baking is done after the frame is drawn, so the frame
61
+ // that finishes the queue was drawn without the last of it.
62
+ export function makeLookBake() {
63
+ return {
64
+ tasks: [],
65
+ budgetMs: BUDGET_MS,
66
+ now: () => performance.now(),
67
+ drawn: false,
68
+ shown: false,
69
+ unsorted: false,
70
+ ms: 0,
71
+ baked: 0,
72
+ dropped: 0,
73
+ get pending() {
74
+ return this.tasks.length;
75
+ },
76
+ };
77
+ }
78
+
79
+ // Adds a task. `owner` says whose it is, for `orderLookBake`; `geometries` is
80
+ // every geometry it writes to, each once; and `steps(gone)` returns the
81
+ // iterator that does the work, one step each time it is advanced, and that
82
+ // ends with false when it left a geometry that is not disposed without the
83
+ // whole of the baking. `gone` is the set of the task's geometries disposed
84
+ // since. A copy made of one of them, or of a copy of one, is added to
85
+ // `geometries`, and `copied(copy, geometry, source)` is told: `source` is
86
+ // what it was cloned from and `geometry` the one of the task's own that
87
+ // `source` is, or is a copy of.
88
+ export function queueLookBake(queue, owner, geometries, steps, copied = null) {
89
+ const gone = new Set();
90
+ const task = { owner, geometries, gone, copyOf: new Map(), copied, steps: steps(gone), started: false, distance: 0, onDispose: null };
91
+ task.onDispose = (event) => {
92
+ gone.add(event.target);
93
+ if (gone.size >= geometries.length) {
94
+ removeTask(queue, task);
95
+ queue.dropped += 1;
96
+ }
97
+ };
98
+ for (const geometry of [...geometries]) {
99
+ waitIn(task, geometry);
100
+ }
101
+ queue.tasks.push(task);
102
+ queue.unsorted = true;
103
+ queue.shown = false;
104
+ }
105
+
106
+ // The tasks each geometry waits in. While it is in any, its `clone` is
107
+ // `cloneWaiting`, a property of its own that goes when the last task does.
108
+ const waitingIn = new WeakMap();
109
+
110
+ function waitIn(task, geometry) {
111
+ geometry.addEventListener('dispose', task.onDispose);
112
+ const tasks = waitingIn.get(geometry);
113
+ if (tasks) {
114
+ tasks.push(task);
115
+ return;
116
+ }
117
+ waitingIn.set(geometry, [task]);
118
+ geometry.clone = cloneWaiting;
119
+ }
120
+
121
+ // `clone` of a waiting geometry: the copy waits in the same tasks, as a copy
122
+ // of the geometry the task was given. Called once its tasks have ended, by
123
+ // someone who kept hold of it, it is the plain `clone`.
124
+ function cloneWaiting() {
125
+ const copy = Object.getPrototypeOf(this).clone.call(this);
126
+ for (const task of waitingIn.get(this) ?? []) {
127
+ const geometry = task.copyOf.get(this) ?? this;
128
+ task.copyOf.set(copy, geometry);
129
+ task.geometries.push(copy);
130
+ waitIn(task, copy);
131
+ task.copied?.(copy, geometry, this);
132
+ }
133
+ return copy;
134
+ }
135
+
136
+ function removeTask(queue, task) {
137
+ for (const geometry of task.geometries) {
138
+ geometry.removeEventListener('dispose', task.onDispose);
139
+ const tasks = (waitingIn.get(geometry) ?? []).filter((other) => other !== task);
140
+ if (tasks.length > 0) {
141
+ waitingIn.set(geometry, tasks);
142
+ } else {
143
+ waitingIn.delete(geometry);
144
+ delete geometry.clone;
145
+ }
146
+ }
147
+ task.copyOf.clear();
148
+ const at = queue.tasks.indexOf(task);
149
+ if (at >= 0) {
150
+ queue.tasks.splice(at, 1);
151
+ }
152
+ }
153
+
154
+ // Called once after each frame is drawn. The first call bakes nothing, so the
155
+ // first frame is on screen before any baking starts; and a call that finds
156
+ // nothing pending sets `shown`, the frame just drawn being the complete
157
+ // picture. A step that throws takes its task with it.
158
+ export function stepLookBake(queue) {
159
+ const { tasks } = queue;
160
+ const first = !queue.drawn;
161
+ queue.drawn = true;
162
+ if (tasks.length === 0) {
163
+ queue.shown = true;
164
+ return;
165
+ }
166
+ if (first) {
167
+ return;
168
+ }
169
+ const started = queue.now();
170
+ let now = started;
171
+ while (tasks.length > 0 && now - started < queue.budgetMs) {
172
+ const task = tasks[0];
173
+ task.started = true;
174
+ let step = null;
175
+ try {
176
+ step = task.steps.next();
177
+ } finally {
178
+ const then = now;
179
+ now = queue.now();
180
+ queue.ms += now - then;
181
+ if ((!step || step.done) && tasks.includes(task)) {
182
+ removeTask(queue, task);
183
+ queue[step && step.value !== false ? 'baked' : 'dropped'] += 1;
184
+ }
185
+ }
186
+ }
187
+ }
188
+
189
+ // Puts the tasks in the order of `distanceOf(owner)`, nearest first, and those
190
+ // as near as each other in the order they were added. A task already begun
191
+ // stays at the front. Asked for when `queue.unsorted` says tasks were added.
192
+ export function orderLookBake(queue, distanceOf) {
193
+ queue.unsorted = false;
194
+ for (const task of queue.tasks) {
195
+ task.distance = task.started ? -1 : distanceOf(task.owner);
196
+ }
197
+ queue.tasks.sort((a, b) => a.distance - b.distance);
198
+ }
199
+
200
+ // Drops every task, when the world is disposed. A task under way, were
201
+ // anything to advance it again, finds all its geometries gone.
202
+ export function clearLookBake(queue) {
203
+ queue.dropped += queue.tasks.length;
204
+ for (const task of [...queue.tasks]) {
205
+ task.geometries.forEach((geometry) => task.gone.add(geometry));
206
+ removeTask(queue, task);
207
+ }
208
+ }
@@ -10,6 +10,7 @@
10
10
 
11
11
  import * as THREE from 'three';
12
12
  import { PART_DEFAULTS } from './pxmodel';
13
+ import { markKitHooks } from './kithooks';
13
14
 
14
15
  const FINISH_KEYS = ['roughness', 'metalness', 'clearcoat', 'emissive', 'emissiveIntensity'];
15
16
 
@@ -83,6 +84,7 @@ function glowByColor(material) {
83
84
  );
84
85
  };
85
86
  material.customProgramCacheKey = () => 'glow-by-color';
87
+ markKitHooks(material);
86
88
  }
87
89
 
88
90
  //
@@ -6,28 +6,14 @@
6
6
  // the files API instead of forcing a context reload (the glob puts models in
7
7
  // vite's module graph, which the imported hook would read as "code changed").
8
8
  import { useEffect, useRef, useState } from 'react';
9
+ import { initialFiles3D } from './initialModelFiles';
10
+ export { initialFiles3D } from './initialModelFiles';
9
11
  import { onFilesChanged } from 'castle-web-sdk';
10
- import { initialFiles, initialMedia, isImageFile } from '@imports/castle.physics-2d/engine/files';
12
+ import { initialMedia, isImageFile } from '@imports/castle.physics-2d/engine/files';
11
13
  import { hydrateDeclaredFiles } from '@imports/castle.physics-2d/engine/liveReload';
12
14
  import { parseFull } from '@imports/castle.physics-2d/engine/pxart';
13
15
  import { imageArt } from '@imports/castle.physics-2d/engine/art';
14
16
 
15
- // Both the deck's own models and every import's -- same shape as the imported
16
- // engine's own file globs: when this kit is itself an import, its models live
17
- // under imports/<alias>/models/ in the deck being served, and a map without
18
- // them can't resolve a kit blueprint's Model ref.
19
- const modelModules = import.meta.glob(
20
- ['/**/*.pxmodel', '!/node_modules/**', '!/dist/**', '!/.castle/**'],
21
- { query: '?raw', import: 'default', eager: true }
22
- );
23
-
24
- export const initialFiles3D = {
25
- ...initialFiles,
26
- ...Object.fromEntries(
27
- Object.entries(modelModules).map(([globPath, text]) => [globPath.replace(/^\//, ''), text])
28
- ),
29
- };
30
-
31
17
  const DATA_EXTS = ['.scene', '.sprite', '.pxart', '.drawing', '.pxmodel'];
32
18
  const CODE_EXTS = ['.js', '.jsx', '.ts', '.tsx', '.css'];
33
19
 
@@ -0,0 +1,49 @@
1
+ // Shared numeric and point helpers for procedural model geometry.
2
+ import * as THREE from 'three';
3
+
4
+ export function points2(list) {
5
+ if (!Array.isArray(list)) {
6
+ return [];
7
+ }
8
+ return list
9
+ .filter((p) => Array.isArray(p) && Number.isFinite(p[0]) && Number.isFinite(p[1]))
10
+ .map((p) => new THREE.Vector2(p[0], p[1]));
11
+ }
12
+
13
+ export function points3(list) {
14
+ if (!Array.isArray(list)) {
15
+ return [];
16
+ }
17
+ return list
18
+ .filter((p) => Array.isArray(p) && p.slice(0, 3).every(Number.isFinite))
19
+ .map((p) => new THREE.Vector3(p[0], p[1], p[2]));
20
+ }
21
+
22
+ export function clampInt(value, min, max, fallback) {
23
+ if (!Number.isFinite(value)) {
24
+ return fallback;
25
+ }
26
+ return Math.max(min, Math.min(max, Math.round(value)));
27
+ }
28
+
29
+ // Cage UVs may have only two coordinates; cage operations keep their strict Z policy.
30
+ export function average(points, fillMissingZ = false) {
31
+ const sum = [0, 0, 0];
32
+ for (const point of points) {
33
+ sum[0] += point[0];
34
+ sum[1] += point[1];
35
+ sum[2] += fillMissingZ ? (point[2] ?? 0) : point[2];
36
+ }
37
+ return sum.map((value) => value / Math.max(1, points.length));
38
+ }
39
+
40
+ // Mulberry32; branches retain their original +17 seed offset.
41
+ export function seededRandom(seed, offset = 0) {
42
+ let state = Math.round(seed * 9973 + offset) | 0;
43
+ return () => {
44
+ state = (state + 0x6d2b79f5) | 0;
45
+ let t = Math.imul(state ^ (state >>> 15), 1 | state);
46
+ t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
47
+ return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
48
+ };
49
+ }
@@ -0,0 +1,16 @@
1
+ // Call before retaining, cloning or measuring an actor's model. A waiting
2
+ // actor's whole shared key fills synchronously through the usual fill path.
3
+ // Dormant without engine.load; callers must look up the entry again because
4
+ // a signature edit can replace it. This module pulls no renderer into readers.
5
+ export function ensureActorModel(world, actorId) {
6
+ world?.modelLoad?.ensureActor(actorId);
7
+ }
8
+
9
+ // Legacy physics-2d has no per-consumer fence. Check at every dispatch
10
+ // boundary physics-3d owns; absent keys and capable runtimes do no work here.
11
+ // actorId restricts a collision check to that actor's waiting entry.
12
+ export function prepareModelConsumers(world, runtime, actorId) {
13
+ if (runtime.callsBeforeBehavior === true) return;
14
+ const load = world?.modelLoad;
15
+ if (load?.runtime === runtime && load.pending.size) load.prepareConsumers(actorId);
16
+ }
@@ -6,6 +6,9 @@
6
6
  // The biped walk is animateModelParts in pxmodel.js. It runs first each frame
7
7
  // and sets its channels outright; motion here adds to what it leaves.
8
8
 
9
+ import { checkEmptyPass } from './emptynodes.js';
10
+ import { modelWalk, takeWalkSpeedHint, takeWalkSpeedHintIfPresent, walkGait } from './gait.js';
11
+
9
12
  const DEG = Math.PI / 180;
10
13
  const TAU = Math.PI * 2;
11
14
 
@@ -29,13 +32,15 @@ const WALK_SPEED = 5;
29
32
  // How fast a node rises or falls over the ground. A scene whose
30
33
  // `userData.groundHeight(x, z)` is set (a deck's terrain) has slopes, and
31
34
  // walking up one is not a fall; without it this is plain vertical speed.
32
- export function airSpeed(node, position, last, dt) {
35
+ export function airSpeed(node, position, last, dt, world) {
33
36
  const groundHeight = node.parent?.userData?.groundHeight;
34
37
  if (typeof groundHeight !== 'function') {
35
38
  return (position.y - last.y) / dt;
36
39
  }
37
40
  const over = position.y - groundHeight(position.x, position.z);
41
+ if (world) checkEmptyPass(world);
38
42
  const lastOver = last.y - groundHeight(last.x, last.z);
43
+ if (world) checkEmptyPass(world);
39
44
  return (over - lastOver) / dt;
40
45
  }
41
46
 
@@ -229,14 +234,27 @@ function applyClip(pose, target, state) {
229
234
 
230
235
  // How much the node walks (0 to 1), how much it is in the air, and a phase
231
236
  // that advances with distance walked, observed from its position.
232
- function observeWalk(walk, node, dt) {
237
+ function observeWalk(walk, node, dt, world, hint) {
233
238
  const p = node.position;
239
+ const gait = walkGait() === 'model'
240
+ ? modelWalk(node, walk, ['legFL', 'legFR', 'legBL', 'legBR'], 0.6,
241
+ dt > 0 && walk.last ? Math.hypot(p.x - walk.last.x, p.z - walk.last.z) / dt : 0,
242
+ dt, hint) : null;
234
243
  if (walk.last) {
235
- const speed = Math.hypot(p.x - walk.last.x, p.z - walk.last.z) / dt;
236
- const rise = airSpeed(node, p, walk.last, dt);
237
- walk.amount += (Math.min(1, speed / WALK_SPEED) - walk.amount) * Math.min(1, dt * 10);
238
- walk.air += ((Math.abs(rise) > 1.2 ? 1 : 0) - walk.air) * Math.min(1, dt * 8);
239
- walk.phase += Math.min(speed, 8) * STRIDE * dt;
244
+ if (gait?.model) {
245
+ const rise = airSpeed(node, p, walk.last, dt, world);
246
+ walk.amount += (Math.min(1, gait.speed / gait.walkSpeed) - walk.amount) * Math.min(1, gait.dt * 10);
247
+ walk.air += ((Math.abs(rise) > 1.2 ? 1 : 0) - walk.air) * Math.min(1, dt * 8);
248
+ walk.amplitudeScale ??= 1;
249
+ walk.amplitudeScale += (gait.amplitudeScale - walk.amplitudeScale) * Math.min(1, gait.dt * 10);
250
+ walk.phase += TAU * gait.cadence * gait.phaseDt;
251
+ } else {
252
+ const speed = Math.hypot(p.x - walk.last.x, p.z - walk.last.z) / dt;
253
+ const rise = airSpeed(node, p, walk.last, dt, world);
254
+ walk.amount += (Math.min(1, speed / WALK_SPEED) - walk.amount) * Math.min(1, dt * 10);
255
+ walk.air += ((Math.abs(rise) > 1.2 ? 1 : 0) - walk.air) * Math.min(1, dt * 8);
256
+ walk.phase += Math.min(speed, 8) * STRIDE * dt;
257
+ }
240
258
  }
241
259
  walk.last = { x: p.x, y: p.y, z: p.z };
242
260
  }
@@ -246,7 +264,9 @@ const LEG_SIDES = { legFL: 1, legBR: 1, legFR: -1, legBL: -1 };
246
264
 
247
265
  function gaitLeg(pose, target, state) {
248
266
  const walk = state.walk;
249
- const swing = Math.sin(walk.phase) * 0.6 * walk.amount * (1 - walk.air);
267
+ const swing = walkGait() === 'model' && walk.gait?.model
268
+ ? Math.sin(walk.phase) * 0.6 * walk.amount * (1 - walk.air) * (walk.amplitudeScale ?? 1)
269
+ : Math.sin(walk.phase) * 0.6 * walk.amount * (1 - walk.air);
250
270
 
251
271
  // In the air the front legs reach forward and the back legs back.
252
272
  const tuck = target.id.startsWith('legF') ? -0.5 : 0.5;
@@ -539,7 +559,12 @@ function setupMotion(entry, actor) {
539
559
  // animateModelParts, with the actor whose clips to play (optional). dt of 0
540
560
  // (editor views) leaves the model in its rest pose. The first call finds the
541
561
  // parts and moves nothing.
542
- export function animateMotion(entry, dt, actor = null) {
562
+ export function animateMotion(entry, dt, actor = null, world, skipEmptyHints = false) {
563
+ let hint;
564
+ if (walkGait() === 'model') {
565
+ hint = entry.walkFrameHint ?? (skipEmptyHints ? takeWalkSpeedHintIfPresent(entry.node) : takeWalkSpeedHint(entry.node));
566
+ delete entry.walkFrameHint;
567
+ }
543
568
  if (!(dt > 0)) {
544
569
  return;
545
570
  }
@@ -551,8 +576,12 @@ export function animateMotion(entry, dt, actor = null) {
551
576
  if (!state) {
552
577
  return;
553
578
  }
579
+ // Reject a non-finite elapsed time only for a measurable model gait; an
580
+ // unreadable model retains the fixed path's exact behavior, too.
581
+ if (walkGait() === 'model' && !Number.isFinite(dt)
582
+ && modelWalk(entry.node, state.walk, ['legFL', 'legFR', 'legBL', 'legBR'], 0.6, 0, dt, hint).model) return;
554
583
  state.clock += dt;
555
- observeWalk(state.walk, entry.node, dt);
584
+ observeWalk(state.walk, entry.node, dt, world, hint);
556
585
  updateClip(state, actor, dt);
557
586
  for (const target of state.targets) {
558
587
  poseTarget(target, state, dt);
@@ -145,7 +145,56 @@
145
145
  // drops it all. The map, and a
146
146
  // blur map were there ever one, are taken off the shadow before they are
147
147
  // disposed, once.
148
+ //
149
+ // Optional `"cacheStill": true` under the same `engine.shadows` object:
150
+ //
151
+ // The existing whole-texel box placement is unchanged. Still casters are
152
+ // under this runtime's adopted/frozen ActorNodes; touched, thawed, spawned,
153
+ // skinned, morphed, instanced or texture-dependent depth casters stay live.
154
+ // stillshadows.js keeps an extra packed-depth target with a hardware depth
155
+ // texture. Its key is the snapped matrix, projection, runtime/still
156
+ // version, frozen epoch, render camera/scene/layers, and selected still
157
+ // casters (including matrices, geometry and depth material). A changed
158
+ // key draws the ordinary pass: no copy or still-map rebuild. Only after
159
+ // STABLE_FRAMES (3) consecutive engine frames with the same complete key
160
+ // does it build, then reuse, the still map. Repeated renders in one frame
161
+ // do not advance that count. Key buffers and selection arrays are reused;
162
+ // existing casters need no descriptor allocations to compute the key.
163
+ // Continuous movement therefore adds key computation only, rather than a
164
+ // depth pass and copy each frame. Checking the selection preserves
165
+ // exact view-slice culling, even past `distance`; it can invalidate inside
166
+ // one snapped box. Caching the full box would change that picture.
167
+ //
168
+ // r180 WebGLShadowMap clears unconditionally, but calls updateMatrices
169
+ // after clearing/setting the viewport and before drawing. There the cache
170
+ // draws one fullscreen triangle copying BOTH packed colour and hardware
171
+ // depth into the live map on a hit or the qualified build frame. Movers
172
+ // draw normally without another clear. Once a key qualifies, a nested
173
+ // shadow-only pass builds the still target first;
174
+ // it saves/restores the live target and uses the same viewport size. No
175
+ // receiver shader changes or renderer settings. Another three revision,
176
+ // reversed/logarithmic depth, or an unhookable pass draws ordinary near
177
+ // shadows. Custom shadow callbacks or unwritable cast flags make the frame
178
+ // uncached, as do custom depth rules whose result depends on draw order.
179
+ //
180
+ // Only with this extra key, a shadowMap.render hook wraps the fade's hook
181
+ // during that one render call. It calls the original pass per light,
182
+ // and bypasses the cache for a different actual render camera or scene:
183
+ // those renders draw the ordinary pass and do not alter the primary key.
184
+ // Selection and rebuild use the hook's actual camera and scene. It restores
185
+ // temporarily suppressed castShadow flags before the next light
186
+ // or colour pass. The fade puts original materials back before both depth
187
+ // passes; receiver variants and shaders are unchanged. A private triangle
188
+ // with an invisible material is attached before a build can qualify, with
189
+ // all layers enabled, so any camera's object walk uploads and tracks its
190
+ // geometry without submitting a colour draw. It detaches at the primary
191
+ // shadow pass; unrelated renders leave it for that walk. giveBack
192
+ // removes it and the hooks and restores flags before disposal or a plain
193
+ // nested frame. All cache resources detach and free with the near shadow
194
+ // on every exit, throw and dispose, including removal of cacheStill itself.
195
+ // Absent/false acquires no cache objects, maps, hooks, walks or shaders.
148
196
  import * as THREE from 'three';
197
+ import { StillShadows, canCacheStill } from './stillshadows.js';
149
198
 
150
199
  // How far from the point it shades three.js's shader may read the shadow map,
151
200
  // across the light: what the outline is pushed out by and the box made wider
@@ -207,15 +256,16 @@ const axisZ = new THREE.Vector3();
207
256
  // class by name; a light's shadow has it.
208
257
  let NearShadowClass = null;
209
258
 
210
- function makeNearShadow() {
259
+ function makeNearShadow(onCallout) {
211
260
  NearShadowClass ??= defineNearShadow(new THREE.DirectionalLight().shadow.constructor);
212
- return new NearShadowClass();
261
+ return new NearShadowClass(onCallout);
213
262
  }
214
263
 
215
264
  function defineNearShadow(DirectionalLightShadow) {
216
265
  return class NearShadow extends DirectionalLightShadow {
217
- constructor() {
266
+ constructor(onCallout) {
218
267
  super();
268
+ this.onCallout = onCallout;
219
269
  this.slice = new SliceFrustum();
220
270
  // What a frame is fitted to (`fit`): the view camera, the distance drawn,
221
271
  // the view's corners one metre ahead, how far along the view the sphere's
@@ -275,6 +325,9 @@ function defineNearShadow(DirectionalLightShadow) {
275
325
  points.push([point.dot(axisX), point.dot(axisY)]);
276
326
  }
277
327
  outlineSides(this.slice.sides, points, axisX, axisY, this.margin);
328
+ // WebGLShadowMap has cleared and set the viewport, but has not drawn
329
+ // any casters yet. The optional cache seeds colour AND hardware depth.
330
+ this.stillCache?.draw(light);
278
331
  }
279
332
 
280
333
  // The camera at `target + offset` looking at `target`, and the matrices that
@@ -289,16 +342,28 @@ function defineNearShadow(DirectionalLightShadow) {
289
342
  // have made) off before disposing it, so nothing that runs from its
290
343
  // `dispose` finds it here.
291
344
  release() {
292
- const { map, mapPass } = this;
345
+ const { map, mapPass, stillCache } = this;
293
346
  this.map = null;
294
347
  this.mapPass = null;
348
+ this.stillCache = null;
295
349
  // Both are off the shadow before either is disposed, and a `dispose`
296
350
  // listener that throws does not keep the other from being freed.
297
- try {
298
- if (map) map.dispose();
299
- } finally {
300
- if (mapPass) mapPass.dispose();
301
- }
351
+ // One bracket spans both maps and all their listeners. Empty releases
352
+ // and unchanged frames neither call out nor allocate this operation.
353
+ if (!map && !mapPass && !stillCache) return;
354
+ const dispose = () => {
355
+ try {
356
+ stillCache?.dispose();
357
+ } finally {
358
+ try {
359
+ if (map) map.dispose();
360
+ } finally {
361
+ if (mapPass) mapPass.dispose();
362
+ }
363
+ }
364
+ };
365
+ if (this.onCallout) this.onCallout(dispose);
366
+ else dispose();
302
367
  }
303
368
  };
304
369
  }
@@ -328,11 +393,15 @@ function shadowSettings(world) {
328
393
  }
329
394
 
330
395
  // The frame the mode is drawing, if there is one, is over for it and the sun
331
- // has its own shadow back. Assignments only: nothing here calls out.
396
+ // has its own shadow back, and under the orbit key the meshes their own
397
+ // materials and the scene and the shadow pass their own functions
398
+ // (shadowfade.js `end`). Assignments only: nothing here calls out.
332
399
  function giveBack(state) {
333
400
  const frame = state.frame;
334
401
  state.frame = null;
335
- if (frame && frame.sun.shadow === frame.near) frame.sun.shadow = frame.own;
402
+ if (frame && (frame.sun.shadow === frame.near || frame.sun.shadow === frame.cache?.shadow)) frame.sun.shadow = frame.own;
403
+ frame?.cache?.end();
404
+ if (frame?.fade) frame.fade.end();
336
405
  }
337
406
 
338
407
  // The one way out of the mode, for every reason and at the moment it happens:
@@ -363,9 +432,12 @@ export function dropNearShadows(world) {
363
432
  // One `renderWorld` of a world that has mode state or whose scene asked for
364
433
  // `distance` (0: it did not). `fitBias` is world3d.js fitting the bias of the
365
434
  // sun's own shadow and `render` its render call; a plain frame is the two, as
366
- // without the key.
367
- export function renderWithNearShadows(world, distance, fitBias, render) {
368
- const state = world.nearShadows ?? newState(world);
435
+ // without the key. `onCallout` is kept with the mode and brackets the entire
436
+ // release operation when a map's disposal can run listeners. `fade` (the
437
+ // scene has the orbit camera key as well, shadowfade.js) fades the far edge
438
+ // of a frame the mode draws; a plain frame is drawn the same either way.
439
+ export function renderWithNearShadows(world, distance, fitBias, render, onCallout, fade, runtime) {
440
+ const state = world.nearShadows ?? newState(world, onCallout);
369
441
  if (state.depth > 0) {
370
442
  // Term 2: entered from inside another call. Plain, and nothing is made.
371
443
  state.off = true;
@@ -380,7 +452,7 @@ export function renderWithNearShadows(world, distance, fitBias, render) {
380
452
  let returned = false;
381
453
  try {
382
454
  try {
383
- drawn = guardedFrame(world, state, distance, fitBias, render);
455
+ drawn = guardedFrame(world, state, distance, fitBias, render, fade, runtime);
384
456
  returned = true;
385
457
  } finally {
386
458
  // First what must happen whatever follows and cannot call out: the sun
@@ -398,13 +470,13 @@ export function renderWithNearShadows(world, distance, fitBias, render) {
398
470
  }
399
471
  }
400
472
 
401
- function newState(world) {
402
- world.nearShadows = { shadow: null, lastType: undefined, off: false, frame: null, depth: 0 };
473
+ function newState(world, onCallout) {
474
+ world.nearShadows = { shadow: null, lastType: undefined, off: false, frame: null, depth: 0, onCallout };
403
475
  return world.nearShadows;
404
476
  }
405
477
 
406
478
  // The frame, inside the guard. True when the mode drew it.
407
- function guardedFrame(world, state, distance, fitBias, render) {
479
+ function guardedFrame(world, state, distance, fitBias, render, fade, runtime) {
408
480
  if (!(distance > 0) || world.disposed === true || state.off) {
409
481
  leaveMode(state);
410
482
  fitBias();
@@ -417,7 +489,7 @@ function guardedFrame(world, state, distance, fitBias, render) {
417
489
  const due = type !== undefined && state.lastType === type;
418
490
  state.lastType = undefined;
419
491
  fitBias();
420
- const drawn = due && nearFrame(world, state, distance, render);
492
+ const drawn = due && nearFrame(world, state, distance, render, fade, runtime);
421
493
  if (!drawn) {
422
494
  leaveMode(state);
423
495
  render();
@@ -428,16 +500,29 @@ function guardedFrame(world, state, distance, fitBias, render) {
428
500
 
429
501
  // Draws the frame with the mode's own shadow on the sun, if the terms hold.
430
502
  // False when they do not and nothing has been drawn.
431
- function nearFrame(world, state, distance, render) {
503
+ function nearFrame(world, state, distance, render, fade, runtime) {
432
504
  const sun = sunOf(world);
433
505
  if (!sun) return false;
434
- state.shadow ??= makeNearShadow();
506
+ state.shadow ??= makeNearShadow(state.onCallout);
435
507
  const frame = { sun, own: sun.shadow, near: state.shadow };
436
508
  state.frame = frame;
437
509
  // Fitting may free a map of the wrong size, whose `dispose` runs someone
438
510
  // else's code: a call from there has left the mode.
439
511
  if (!fit(frame.near, frame.own, world, distance) || state.frame !== frame) return false;
512
+ const cacheStill = runtime?.data?.engine?.shadows?.cacheStill === true && canCacheStill(world.renderer, world.scene);
513
+ if (!cacheStill && frame.near.stillCache) frame.near.release();
514
+ if (state.frame !== frame) return false;
515
+ if (cacheStill) {
516
+ frame.cache = frame.near.stillCache ??= new StillShadows(world, frame.near);
517
+ }
440
518
  sun.shadow = frame.near;
519
+ if (fade) {
520
+ frame.fade = fade;
521
+ fade.begin(frame.near.reach, sun);
522
+ }
523
+ // Outside the fade's hook, so it restores originals before either depth
524
+ // pass, and giveBack removes the two hooks in the opposite order.
525
+ frame.cache?.begin(frame, runtime);
441
526
  render();
442
527
  return true;
443
528
  }