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,890 @@
1
+ // The far edge of the near shadows, for a scene that sets both
2
+ // `"engine": { "shadows": { "distance": n } }` and the orbit camera key
3
+ // (`"camera": { "follow": "rigid", "control": "orbit" }`).
4
+ //
5
+ // On a frame the near-shadow mode draws (nearshadows.js) the sun's shadow is
6
+ // drawn into the mode's own map, a box round the view out to `reach` (the
7
+ // distance it could fit, measured along the way the camera looks). Past the
8
+ // box's edge nothing is shadowed: three.js finds the point outside the map
9
+ // and leaves it lit. Under a fixed camera looking down that edge is off
10
+ // screen; under the orbit camera, which the player can tilt to the
11
+ // horizontal, it is a hard line across the ground. So under both keys the
12
+ // sun's shadow strength fades out over the last quarter of the reach: whole
13
+ // up to FADE_FROM of it, gone at it, eased between (smoothstep), to full sun,
14
+ // which is what lies beyond.
15
+ //
16
+ // How, without touching anything the keyless world draws: world-local
17
+ // material variants, put on the meshes only for the keyed world's own render
18
+ // call, and never a change to a material.
19
+ //
20
+ // - What gets a variant: a material whose class is exactly one of three's
21
+ // own lit ones (standard, physical, lambert, phong, toon, by identity: a
22
+ // subclass is never faded, so no other constructor ever runs) and whose
23
+ // `onBeforeCompile`, `customProgramCacheKey` and `onBeforeRender` are
24
+ // three's own or the kit's (kithooks.js: look.js, optimize.js,
25
+ // materialpresets.js, none of which writes anything of the material's),
26
+ // alone on a mesh (a mesh with an array of materials is not faded: the
27
+ // player's models have none, optimize.js splits per-face art into one
28
+ // mesh per face) that receives shadows and whose own `onBeforeRender`
29
+ // and `onAfterRender` are three's (they are handed the material
30
+ // drawn). And a frame is faded only when the scene has no
31
+ // `onBeforeRender` of its own (it runs inside the render while the
32
+ // variants are on). Anything else is drawn as it is, unfaded: no deck
33
+ // code ever runs on, or is handed, a variant, so whatever it writes
34
+ // lands where it would without the key.
35
+ // - A variant is a separate material object to the renderer that reads
36
+ // and writes the original's properties. Its prototype, shared by the
37
+ // material class, has a forwarding accessor (`this[ORIGINAL][key]`,
38
+ // read and written) for every own property a material of the class has
39
+ // and every accessor of the class (enumerable or not, symbols
40
+ // included); below that, in place of the class's prototype, a proxy
41
+ // that answers any other key from the original (a property only this
42
+ // original has, a method) and writes any other key on it, and gives
43
+ // that key a forwarder of its own so it does not come back (read on
44
+ // anything but a variant, the shared prototype itself included, both
45
+ // fall through to the class's prototype). So every
46
+ // read is the original's, live, and every write through a variant
47
+ // (deck code inside the frame that reaches one: a callback installed
48
+ // mid-frame, handed the material three listed; an LOD's `update`;
49
+ // three's own side flip and version bumps) lands on the original as it
50
+ // would without the key. A property defined on the variant itself is
51
+ // put on the original after the frame (and before the next), and one
52
+ // that cannot then be taken off the variant drops it. Its events are
53
+ // the original's: what is added, removed, asked about or dispatched
54
+ // through it, and its `dispose`, act on the original, except the
55
+ // renderer's own dispose listener for the variant's program, known by
56
+ // its function (learned from the renderer itself, by compiling a
57
+ // private material once): that one is held by the variant (and added to the original as well, where
58
+ // the renderer drawing it without the key would have it), and the
59
+ // variant's program is let go of through it, when the variant is
60
+ // disposed or dropped, or when a dispose listener has gone from the
61
+ // original (it was disposed). The variant's own: an `id` (three sorts,
62
+ // binds and keeps programs apart by it), that listener, and the two
63
+ // shader hooks, held as they were when it was made: `onBeforeCompile`
64
+ // runs the held hook then adds the fade, and `customProgramCacheKey` is
65
+ // the held key's plus `|near-shadow-fade`; written, they write the
66
+ // original's. The original is never written but by what is written
67
+ // through the variant, as without the key.
68
+ // - Before each faded frame a variant is drawn in: if the original no
69
+ // longer has exactly the hooks it holds, or is no longer one to fade,
70
+ // the variant is dropped (and a new one made if it still is). A hook the
71
+ // original is given inside the frame, after the variants went on, is
72
+ // never run for the variant: it compiles with the held hook, under a key
73
+ // no other material has, and is dropped on the next frame.
74
+ // - Each keyed world keeps its own variants (`world.shadowFade`), made the
75
+ // first time a material is drawn faded and kept while it is in the scene.
76
+ // A variant not drawn for SWEEP_EVERY
77
+ // faded frames is disposed. Every one is disposed on a scene load (the
78
+ // physics system's `reset`), an editor's frame, any frame of a scene
79
+ // without both keys and `disposeWorld`; one dropped from inside a render
80
+ // is disposed once the outermost `renderWorld` is over.
81
+ // - `begin`, called by the near-shadow mode right before its one render
82
+ // call of a frame it draws, puts each variant on its mesh and puts a
83
+ // hook on the world renderer's `shadowMap.render` (an own property of
84
+ // three's WebGLShadowMap, which the renderer calls through the object):
85
+ // three's `render` calls it on every render after listing the draws
86
+ // (reading `mesh.material`) and before drawing any, whatever the shadow
87
+ // settings, and the hook puts the originals back. `end`, when the frame
88
+ // gives the sun its own shadow back (nearshadows.js `giveBack`, whatever
89
+ // the render did), puts the originals back too and takes the hook off.
90
+ // A hook a deck replaced meanwhile is left replaced; ours, if the
91
+ // deck's still calls it, has let go of the fade and only calls the pass
92
+ // it had. A mesh whose material was changed meanwhile keeps the new
93
+ // one. The hook goes on before any variant does, and a pass that cannot
94
+ // take it (read-only) draws the frame unfaded. Putting back is total
95
+ // (`putBack`): each mesh on its own, a material a deck made read-only
96
+ // but configurable redefined with the deck's attributes and the
97
+ // original's value, an accessor a deck put there with a setter given
98
+ // the original through it once (its getter never called), and anything
99
+ // else held (`stuck`) and tried at every frame boundary; such a mesh
100
+ // keeps its variant, which reads and writes the original, until then.
101
+ // A variant the fade has let go of (dropped, or the fade itself gone)
102
+ // is inert: it keys and compiles as its original, with no fade.
103
+ // - The visible walk and the descriptor checks stay live each frame:
104
+ // neither three's material version nor the still clock sees every
105
+ // write to a mesh's material, callbacks or visibility. The checks use
106
+ // Object.getOwnPropertyDescriptor and Object.hasOwn, including on the
107
+ // way back: the same descriptors, without calling a getter, with no
108
+ // Reflect descriptor lookup in the per-mesh path. The assignments and
109
+ // their verification stay guarded, even for a mesh changed inside the
110
+ // render. No bounds test drops a receiver: beyond `reach` the patch
111
+ // forces the shadow off, where the unfaded map may still shadow it.
112
+ //
113
+ // So no material and nothing of another world is written by the fade, and
114
+ // whatever deck code writes through a variant lands where it would without
115
+ // the key; a keyless world sharing a material compiles the same program
116
+ // from it, draws the same draws and sees the same writes. The keyed frame's
117
+ // own draws use the variants, and every render after its list of draws sees
118
+ // the originals. What is left, inside the keyed world's own frame: a
119
+ // variant is another object, so deck code that reaches one (an LOD's
120
+ // `update`, a callback installed mid-frame, a sort comparator) and compares
121
+ // it by identity with the original, or asks it `key in`, or deletes a
122
+ // property through it, does not see the original; and a property defined
123
+ // on a variant reaches the original after the frame rather than at once.
124
+ // The eligibility rule above keeps the scene's, the faded meshes' and the
125
+ // faded materials' own callbacks off variants all the same. A hook or
126
+ // callback that changes in place an object the original holds by reference
127
+ // (its colour, a texture, its defines) changes it for every world, as it
128
+ // would without the key.
129
+ //
130
+ // The patch multiplies the strength the sun's shadow is drawn with (three's
131
+ // `shadowIntensity`, in lights_fragment_begin) by the fade, for the first
132
+ // directional light that casts. `begin` checks, in the same walk, that the
133
+ // sun is that light as the renderer will order them (the first casting
134
+ // directional light in the scene, visible and on the camera's layers, which
135
+ // three's light sort keeps first); if not, the frame is not faded.
136
+ import * as THREE from 'three';
137
+ import { knownCompileHook, knownProgramKey, knownDrawCallback } from './kithooks';
138
+
139
+ // The share of the reach the shadow is whole to.
140
+ export const FADE_FROM = 0.75;
141
+
142
+ // Faded frames a variant is kept without being drawn.
143
+ const SWEEP_EVERY = 60;
144
+
145
+ const INCLUDE = '#include <lights_fragment_begin>';
146
+ const TARGET = 'directionalLightShadow.shadowIntensity, directionalLightShadow.shadowBias';
147
+ const DECLARE = `uniform vec2 nearShadowFade;
148
+ float nearShadowFadeAt( const in float depth ) {
149
+ return 1.0 - smoothstep( nearShadowFade.x, nearShadowFade.y, depth );
150
+ }
151
+ `;
152
+ let lights = null;
153
+ function fadedLights() {
154
+ return (lights ??= THREE.ShaderChunk.lights_fragment_begin.replace(
155
+ TARGET,
156
+ 'directionalLightShadow.shadowIntensity * ( UNROLLED_LOOP_INDEX == 0 ? nearShadowFadeAt( vViewPosition.z ) : 1.0 ), directionalLightShadow.shadowBias'
157
+ ));
158
+ }
159
+ // A three.js whose chunk no longer has the line: nothing is faded.
160
+ const patchable = () => fadedLights() !== THREE.ShaderChunk.lights_fragment_begin;
161
+
162
+ export const PROGRAM_KEY_SUFFIX = '|near-shadow-fade';
163
+
164
+ // The source change, on a variant's shader. A shader with no lights is left
165
+ // as it is.
166
+ export function patchShadowFade(shader, uniform) {
167
+ if (!shader.fragmentShader.includes(INCLUDE) || shader.fragmentShader.includes('nearShadowFadeAt')) return;
168
+ shader.uniforms.nearShadowFade = uniform;
169
+ shader.fragmentShader = DECLARE + shader.fragmentShader.replace(INCLUDE, fadedLights());
170
+ }
171
+
172
+ // three's own lit material classes, by identity: a material is lit here
173
+ // only when its prototype is exactly one of theirs, so no other class (and
174
+ // no other constructor) is ever involved in making a variant.
175
+ const LIT_CLASSES = new Map(
176
+ [THREE.MeshStandardMaterial, THREE.MeshPhysicalMaterial, THREE.MeshLambertMaterial, THREE.MeshPhongMaterial, THREE.MeshToonMaterial].map(
177
+ (Class) => [Class.prototype, Class]
178
+ )
179
+ );
180
+
181
+ function lit(material) {
182
+ return material !== null && typeof material === 'object' && LIT_CLASSES.has(Object.getPrototypeOf(material));
183
+ }
184
+
185
+ const own = (object, key) => Object.hasOwn(object, key);
186
+
187
+ // Whether a material gets a variant: lit, and its shader hook, key function
188
+ // and draw callback are three's own or the kit's (kithooks.js), none of which
189
+ // writes anything of the material's. One with a deck's own is drawn as it
190
+ // is, unfaded.
191
+ function fadeable(material) {
192
+ return (
193
+ lit(material) &&
194
+ knownCompileHook(dataValue(material, 'onBeforeCompile')) &&
195
+ knownProgramKey(dataValue(material, 'customProgramCacheKey')) &&
196
+ knownDrawCallback(dataValue(material, 'onBeforeRender')) &&
197
+ dataValue(material, '_listeners') !== ACCESSOR
198
+ );
199
+ }
200
+
201
+ // What an object has for `key` along its prototype chain, read from the
202
+ // property descriptors so no getter is ever called: the value of a data
203
+ // property, ACCESSOR for an accessor (a deck's getter; such a material, or
204
+ // mesh, is never faded), undefined for none. The fade's own reads of an
205
+ // original (its hooks, its listeners) and of a mesh (its material, whether
206
+ // it receives shadows) go through this, so they call nothing a deck
207
+ // defined.
208
+ const ACCESSOR = Symbol('accessor');
209
+
210
+ // The same, for a property the fade will assign: ACCESSOR too when an
211
+ // assignment would not land (read-only, or inherited by an object that
212
+ // cannot take an own property).
213
+ function writableValue(object, key) {
214
+ for (let level = object; level !== null && level !== undefined; level = Object.getPrototypeOf(level)) {
215
+ const descriptor = Object.getOwnPropertyDescriptor(level, key);
216
+ if (!descriptor) continue;
217
+ if (!('value' in descriptor) || descriptor.writable !== true) return ACCESSOR;
218
+ if (level !== object && !Object.isExtensible(object)) return ACCESSOR;
219
+ return descriptor.value;
220
+ }
221
+ return ACCESSOR;
222
+ }
223
+
224
+ // A mesh's own `material`, if it is one the fade can swap and swap back to
225
+ // exactly what it was: an own data property, writable and configurable.
226
+ // ACCESSOR otherwise (an inherited material too: the swap would leave the
227
+ // mesh an own property in place of the inherited one).
228
+ function ownMaterial(mesh) {
229
+ const descriptor = Object.getOwnPropertyDescriptor(mesh, 'material');
230
+ if (!descriptor || !('value' in descriptor) || descriptor.writable !== true || descriptor.configurable !== true) return ACCESSOR;
231
+ return descriptor.value;
232
+ }
233
+
234
+ function dataValue(object, key) {
235
+ for (let level = object; level !== null && level !== undefined; level = Object.getPrototypeOf(level)) {
236
+ const descriptor = Object.getOwnPropertyDescriptor(level, key);
237
+ if (descriptor) return 'value' in descriptor ? descriptor.value : ACCESSOR;
238
+ }
239
+ return undefined;
240
+ }
241
+
242
+ // Whether a mesh's own callbacks are three's: they are handed the material
243
+ // being drawn, which on a faded frame is the variant.
244
+ const OBJECT_BEFORE = THREE.Object3D.prototype.onBeforeRender;
245
+ const OBJECT_AFTER = THREE.Object3D.prototype.onAfterRender;
246
+ function plainObject(object, protos) {
247
+ if (own(object, 'onBeforeRender') || own(object, 'onAfterRender') || !protos) {
248
+ return dataValue(object, 'onBeforeRender') === OBJECT_BEFORE && dataValue(object, 'onAfterRender') === OBJECT_AFTER;
249
+ }
250
+ // Neither is the object's own: what its prototype has, looked at once a
251
+ // frame for each prototype (`protos`).
252
+ const proto = Object.getPrototypeOf(object);
253
+ let plain = protos.get(proto);
254
+ if (plain === undefined) {
255
+ plain = dataValue(proto, 'onBeforeRender') === OBJECT_BEFORE && dataValue(proto, 'onAfterRender') === OBJECT_AFTER;
256
+ protos.set(proto, plain);
257
+ }
258
+ return plain;
259
+ }
260
+
261
+ // A variant's original, and its own state (`events`), on the variant.
262
+ const ORIGINAL = Symbol('nearShadowFadeOriginal');
263
+ const STATE = Symbol('nearShadowFadeState');
264
+
265
+ // What a variant has of its own; every other property, read or written,
266
+ // is the original's.
267
+ const OWN = new Set([ORIGINAL, STATE, 'id', 'onBeforeCompile', 'customProgramCacheKey']);
268
+
269
+ // The accessor that reads and writes the original's `key` (`this` is the
270
+ // variant): one pair of functions per key, shared by every class.
271
+ const forwardingFunctions = new Map();
272
+
273
+ function forwarding(key, enumerable) {
274
+ let pair = forwardingFunctions.get(key);
275
+ if (!pair) {
276
+ pair = {
277
+ get() {
278
+ const original = this[ORIGINAL];
279
+ return original ? original[key] : Reflect.get(classProtoBelow(this), key, this);
280
+ },
281
+ set(value) {
282
+ const original = this[ORIGINAL];
283
+ if (original) original[key] = value;
284
+ else Reflect.set(classProtoBelow(this), key, value, this);
285
+ },
286
+ };
287
+ forwardingFunctions.set(key, pair);
288
+ }
289
+ return { get: pair.get, set: pair.set, enumerable, configurable: true };
290
+ }
291
+
292
+ // The class's own prototype under a shared prototype (`this` not a variant:
293
+ // the shared prototype read or written directly), for the forwarders and
294
+ // the proxy to fall through to.
295
+ const classProtos = new WeakMap();
296
+
297
+ function classProtoBelow(object) {
298
+ for (let level = object; level; level = Object.getPrototypeOf(level)) {
299
+ const proto = classProtos.get(level);
300
+ if (proto) return proto;
301
+ }
302
+ return Object.prototype;
303
+ }
304
+
305
+ // The renderer's own dispose listener (three's `onMaterialDispose`, one
306
+ // function per renderer), learned from the renderer itself: it is compiled
307
+ // a private material no one else can reach (`renderer.compile`, outside any
308
+ // render) and the one listener it adds to it is the renderer's; the private
309
+ // material's program is set up as for a first draw and the material then
310
+ // disposed, which lets its program go. Null when the renderer cannot do
311
+ // that: no frame of it is faded.
312
+ const rendererListeners = new WeakMap();
313
+
314
+ function disposeListenerOf(renderer) {
315
+ if (rendererListeners.has(renderer)) return rendererListeners.get(renderer);
316
+ let listener = null;
317
+ if (typeof renderer?.compile === 'function') {
318
+ const probe = new THREE.MeshBasicMaterial();
319
+ const scene = new THREE.Scene();
320
+ scene.add(new THREE.Mesh(new THREE.BufferGeometry(), probe));
321
+ try {
322
+ renderer.compile(scene, new THREE.PerspectiveCamera());
323
+ const added = probe._listeners?.dispose;
324
+ if (added?.length === 1 && typeof added[0] === 'function') listener = added[0];
325
+ // compile only links: three delays diagnostics, shader cleanup and
326
+ // uniform/attribute discovery until getUniforms. Finish that while
327
+ // the probe is alive. Otherwise Chromium's queued native completion
328
+ // readback can query its deleted program (and program 0 for metadata),
329
+ // producing twelve glGetProgramiv warnings on the first faded frame.
330
+ // This also blocks on metadata with checkShaderErrors disabled, and
331
+ // does not draw, bind a program or change any render state.
332
+ renderer.properties?.get(probe).currentProgram?.getUniforms();
333
+ } finally {
334
+ probe.dispose();
335
+ }
336
+ }
337
+ rendererListeners.set(renderer, listener);
338
+ return listener;
339
+ }
340
+
341
+ // A variant's events are its original's, as without the key: what deck code
342
+ // adds, removes, asks about or dispatches through a variant, and its
343
+ // `dispose`, act on the original. The one thing kept apart is the
344
+ // renderer's own dispose listener for the variant's program, known by its
345
+ // function (`disposeListenerOf`, never by when it is added): it is held by
346
+ // the variant (`state.renderer`) and also added to the original, where the
347
+ // renderer drawing the original without the key would have it, and the
348
+ // variant's program is released through it (`releaseVariant`).
349
+ const EVENT_METHODS = {
350
+ addEventListener(type, listener) {
351
+ const state = this[STATE];
352
+ if (type === 'dispose' && listener === state.known) state.renderer = listener;
353
+ this[ORIGINAL].addEventListener(type, listener);
354
+ },
355
+ removeEventListener(type, listener) {
356
+ const state = this[STATE];
357
+ // The renderer letting go of the variant's program: the variant's alone.
358
+ if (state.releasing && type === 'dispose' && listener === state.renderer) {
359
+ state.renderer = null;
360
+ return;
361
+ }
362
+ this[ORIGINAL].removeEventListener(type, listener);
363
+ },
364
+ hasEventListener(type, listener) {
365
+ return this[ORIGINAL].hasEventListener(type, listener);
366
+ },
367
+ dispatchEvent(event) {
368
+ this[ORIGINAL].dispatchEvent(event);
369
+ if (event.type === 'dispose') releaseVariant(this);
370
+ },
371
+ dispose() {
372
+ this[ORIGINAL].dispose();
373
+ releaseVariant(this);
374
+ },
375
+ };
376
+
377
+ // The variant's program let go of in the renderer that drew it, through the
378
+ // renderer's own listener, with nothing of the original's touched.
379
+ function releaseVariant(variant) {
380
+ const state = variant[STATE];
381
+ const listener = state.renderer;
382
+ if (!listener) return;
383
+ state.releasing = true;
384
+ try {
385
+ listener.call(variant, { type: 'dispose', target: variant });
386
+ } finally {
387
+ state.releasing = false;
388
+ state.renderer = null;
389
+ }
390
+ }
391
+
392
+ // Per material class, shared by its variants: a prototype with a
393
+ // forwarding accessor for every own property a material of the class has
394
+ // (what its constructor makes and what the first original of the class
395
+ // had, enumerable or not, symbols included), and the event methods above;
396
+ // so the properties three reads every draw go through one shared function
397
+ // each. Below it, in place of the class's own prototype, a proxy of that
398
+ // prototype that answers for the original: anything else read through a
399
+ // variant (a property only this original has, hidden or a symbol; the
400
+ // class's methods and accessors) is read from the original, and anything
401
+ // else written through it (a property the original never had; the class's
402
+ // setters, `needsUpdate`, `clearcoat`, ...) is written on the original, as
403
+ // without the key.
404
+ const forwarders = new Map();
405
+
406
+ // Read once through it, a key gets a forwarder of its own on the shared
407
+ // prototype (`shared`), so three's every-draw reads of what a class does
408
+ // not have (`isShaderMaterial`, ...) and of its methods do not come back.
409
+ function originalBelow(proto, shared) {
410
+ return new Proxy(proto, {
411
+ // `receiver` is a variant only when ORIGINAL is its own: read that way,
412
+ // the check never comes back through this proxy (the shared prototype
413
+ // itself, or anything else under it, falls through to the class).
414
+ get(target, key, receiver) {
415
+ const original = ownOriginal(receiver);
416
+ if (!original) return Reflect.get(target, key, receiver);
417
+ if (!own(shared, key)) Object.defineProperty(shared, key, forwarding(key, false));
418
+ return Reflect.get(original, key, original);
419
+ },
420
+ set(target, key, value, receiver) {
421
+ const original = ownOriginal(receiver);
422
+ return original ? Reflect.set(original, key, value, original) : Reflect.set(target, key, value, receiver);
423
+ },
424
+ });
425
+ }
426
+
427
+ function ownOriginal(object) {
428
+ return object !== null && typeof object === 'object' && own(object, ORIGINAL) ? object[ORIGINAL] : undefined;
429
+ }
430
+
431
+ function ownKeysWith(object, into) {
432
+ for (const key of Reflect.ownKeys(object)) {
433
+ if (!into.has(key)) into.set(key, Object.getOwnPropertyDescriptor(object, key).enumerable === true);
434
+ }
435
+ }
436
+
437
+ function forwarderFor(original) {
438
+ const proto = Object.getPrototypeOf(original);
439
+ let entry = forwarders.get(proto);
440
+ if (!entry) {
441
+ // The class is one of three's own (`lit`): a bare one of it, made with
442
+ // its own constructor (which touches nothing else), and the original's
443
+ // own keys.
444
+ const keys = new Map();
445
+ ownKeysWith(original, keys);
446
+ ownKeysWith(new (LIT_CLASSES.get(proto))(), keys);
447
+ // The class's own accessors too (`alphaTest`, `transmission`, ...),
448
+ // read every draw: forwarded, they run on the original.
449
+ for (let level = proto; level && level !== Object.prototype; level = Object.getPrototypeOf(level)) {
450
+ for (const key of Reflect.ownKeys(level)) {
451
+ const descriptor = Object.getOwnPropertyDescriptor(level, key);
452
+ if (!keys.has(key) && (descriptor.get || descriptor.set)) keys.set(key, false);
453
+ }
454
+ }
455
+ const shared = {};
456
+ Object.setPrototypeOf(shared, originalBelow(proto, shared));
457
+ classProtos.set(shared, proto);
458
+ for (const [key, enumerable] of keys) if (!OWN.has(key)) Object.defineProperty(shared, key, forwarding(key, enumerable));
459
+ for (const [name, method] of Object.entries(EVENT_METHODS)) Object.defineProperty(shared, name, { value: method, configurable: true, writable: true });
460
+ entry = { shared, keys };
461
+ forwarders.set(proto, entry);
462
+ }
463
+ return entry;
464
+ }
465
+
466
+ // A world-local view of `original`. The hooks checked when it is made
467
+ // (`fadeable`) are held while active: `current` says whether the original
468
+ // still has exactly them. Once inert, it follows the original's live hooks.
469
+ function makeVariant(original, uniform, rendererListener, properties) {
470
+ const { shared } = forwarderFor(original);
471
+ const variant = Object.create(shared);
472
+ const hook = dataValue(original, 'onBeforeCompile');
473
+ const key = dataValue(original, 'customProgramCacheKey');
474
+ const callback = dataValue(original, 'onBeforeRender');
475
+ const current = () =>
476
+ dataValue(original, 'onBeforeCompile') === hook &&
477
+ dataValue(original, 'customProgramCacheKey') === key &&
478
+ dataValue(original, 'onBeforeRender') === callback;
479
+ // `inert`: the variant is no longer the fade's (dropped, or the fade
480
+ // gone) but may be left on a mesh a deck would not give back: it then
481
+ // compiles and keys exactly as its original, with no fade.
482
+ const state = { known: rendererListener, renderer: null, releasing: false, inert: false };
483
+ // The held hook on the variant's shader, then the fade. A hook the
484
+ // original has been given since (inside the frame, before this compile)
485
+ // is never run.
486
+ function onBeforeCompile(shader, renderer) {
487
+ // Inert: exactly what three does when it compiles the original itself.
488
+ if (state.inert) return original.onBeforeCompile(shader, renderer);
489
+ hook.call(this, shader, renderer);
490
+ patchShadowFade(shader, uniform);
491
+ }
492
+ // The original's key plus the fade's, while it has the hooks held. Once
493
+ // it has others, a key no other material has, so the program compiled
494
+ // with the held hook is this variant's alone (it is dropped next frame).
495
+ const stale = `${PROGRAM_KEY_SUFFIX}|stale|${THREE.MathUtils.generateUUID()}`;
496
+ const customProgramCacheKey = () => {
497
+ if (state.inert) return original.customProgramCacheKey();
498
+ if (!current()) return stale;
499
+ return key.call(original) + PROGRAM_KEY_SUFFIX;
500
+ };
501
+ Object.defineProperties(variant, {
502
+ [ORIGINAL]: { value: original },
503
+ [STATE]: { value: state },
504
+ // A fresh number from three's own counter (the renderer sorts and binds
505
+ // by it, and keeps the variant's program apart by it).
506
+ id: { value: new THREE.Material().id },
507
+ // Read: the held ones. Written: the original's, as without the key (and
508
+ // the variant is then not current).
509
+ onBeforeCompile: {
510
+ get: () => onBeforeCompile,
511
+ set: (value) => {
512
+ original.onBeforeCompile = value;
513
+ },
514
+ },
515
+ customProgramCacheKey: {
516
+ get: () => customProgramCacheKey,
517
+ set: (value) => {
518
+ original.customProgramCacheKey = value;
519
+ },
520
+ },
521
+ });
522
+ // The original's dispose listeners when the variant was last brought in
523
+ // step: one gone (the original disposed, by anyone, and a renderer let go
524
+ // of it) releases the variant's program too. And, for a renderer that
525
+ // also draws the original itself (a keyed deck drawing another scene with
526
+ // the world's renderer), the renderer's own entry for the original
527
+ // (`properties`, read only if it is there, never made): a dispose removes
528
+ // it, and a draw after makes a new one, so a dispose that a redraw has
529
+ // already answered (its listener back in the same array) is seen too.
530
+ let listeners = null;
531
+ let listenerCount = 0;
532
+ let entryOfOriginal = null;
533
+ // Before each faded frame it is drawn in, and after each: anything
534
+ // defined on the variant itself (a property defined, or a forwarder
535
+ // redefined) is put on the original as it was put on the variant and
536
+ // taken off the variant. False when one cannot be taken off: the variant
537
+ // is then dropped.
538
+ function sync() {
539
+ const held = dataValue(original, '_listeners');
540
+ const disposeListeners = held !== ACCESSOR && held !== null && typeof held === 'object' ? dataValue(held, 'dispose') : undefined;
541
+ if (disposeListeners === ACCESSOR) return false;
542
+ const entry = properties?.has(original) ? properties.get(original) : null;
543
+ if ((listeners && disposeListeners !== listeners) || (disposeListeners?.length ?? 0) < listenerCount || (entryOfOriginal && entry !== entryOfOriginal)) releaseVariant(variant);
544
+ listeners = disposeListeners;
545
+ listenerCount = disposeListeners?.length ?? 0;
546
+ entryOfOriginal = entry;
547
+ for (const name of Reflect.ownKeys(variant)) {
548
+ if (OWN.has(name)) continue;
549
+ Reflect.defineProperty(original, name, Object.getOwnPropertyDescriptor(variant, name));
550
+ if (!Reflect.deleteProperty(variant, name)) return false;
551
+ }
552
+ return true;
553
+ }
554
+ sync();
555
+ return { variant, sync, current, seen: 0 };
556
+ }
557
+
558
+ // The material a variant fades, or undefined (for the tests).
559
+ export function shadowFadeOriginal(material) {
560
+ return material?.[ORIGINAL];
561
+ }
562
+
563
+ // The shadow pass hook of one frame (`begin`): the originals back, then the
564
+ // pass it had. Once its frame is over (`fade` null) it is only the pass it
565
+ // had, so one a deck kept hold of (a replacement that calls it) holds
566
+ // nothing of the fade's and does nothing of it.
567
+ // A mesh's own material back in place of the variant it was given, if it
568
+ // still has the variant. A plain assignment, or, for a property a deck made
569
+ // read-only meanwhile but left configurable, the same property redefined
570
+ // with the deck's attributes and the original's value. False when it cannot
571
+ // be (read-only and not configurable): the mesh keeps the variant, which
572
+ // reads and writes its original, until it can.
573
+ function putBack(mesh, put, had) {
574
+ const descriptor = Object.getOwnPropertyDescriptor(mesh, 'material');
575
+ // Gone from the mesh (deleted, or inherited now): not ours to touch.
576
+ if (!descriptor) return true;
577
+ if ('value' in descriptor) {
578
+ if (descriptor.value !== put) return true;
579
+ if (Reflect.set(mesh, 'material', had) && Object.getOwnPropertyDescriptor(mesh, 'material')?.value === had) return true;
580
+ if (descriptor.configurable !== true) return false;
581
+ return Reflect.defineProperty(mesh, 'material', { ...descriptor, value: had }) && Object.getOwnPropertyDescriptor(mesh, 'material')?.value === had;
582
+ }
583
+ // An accessor a deck put there during the render: what it holds cannot be
584
+ // read without calling its getter, which the fade never does. With a
585
+ // setter, the original is set through it once, the value the deck's own
586
+ // code would have had there without the key; without one, the mesh is
587
+ // held.
588
+ if (typeof descriptor.set !== 'function') return false;
589
+ // A deck setter that throws is the deck's own: the mesh is held, and
590
+ // the frame and every other mesh go on.
591
+ try {
592
+ Reflect.set(mesh, 'material', had);
593
+ } catch {
594
+ return false;
595
+ }
596
+ return true;
597
+ }
598
+
599
+ function passHook(had) {
600
+ const hook = {
601
+ fade: null,
602
+ had,
603
+ render(lights, scene, camera) {
604
+ hook.fade?.restore();
605
+ return had.call(this, lights, scene, camera);
606
+ },
607
+ };
608
+ return hook;
609
+ }
610
+
611
+ // Lets go of each variant's program, every one even if a listener throws;
612
+ // the first throw goes on after. The originals are not disposed.
613
+ function disposeAll(variants) {
614
+ let failure = null;
615
+ for (const variant of variants) {
616
+ try {
617
+ releaseVariant(variant);
618
+ } catch (err) {
619
+ failure ??= err;
620
+ }
621
+ }
622
+ if (failure) throw failure;
623
+ }
624
+
625
+ class ShadowFade {
626
+ constructor(world) {
627
+ this.world = world;
628
+ this.uniform = { value: new THREE.Vector2() };
629
+ // Original material -> its variant and when it was last drawn.
630
+ this.variants = new Map();
631
+ // The meshes given a variant this frame, what they had and what they were
632
+ // given, the first `count` of each.
633
+ this.meshes = [];
634
+ this.had = [];
635
+ this.put = [];
636
+ this.count = 0;
637
+ this.frame = 0;
638
+ this.swept = 0;
639
+ this.depth = 0;
640
+ this.dropped = false;
641
+ // Variants dropped since the last settle (`variantFor`), to dispose.
642
+ this.dead = [];
643
+ this.synced = 0;
644
+ this.listener = null;
645
+ // Per frame: whether each prototype met has three's own object
646
+ // callbacks (`plainObject`).
647
+ this.protos = new Map();
648
+ // Per frame: the materials met that are not to be faded.
649
+ this.refused = new Set();
650
+ this.firstSun = null;
651
+ this.visit = (object) => this.swapIn(object);
652
+ // The shadow pass hook of the frame now drawn (`begin`, `end`), on the
653
+ // renderer's shadow map, and whether that map had the function as its
654
+ // own.
655
+ this.pass = null;
656
+ this.passOwn = false;
657
+ this.hook = null;
658
+ // Meshes that could not be given their material back (`restore`).
659
+ this.stuck = [];
660
+ }
661
+
662
+ // Right before the render call of a frame the mode draws: the frame fades
663
+ // over the last quarter of `reach`. The variants go on the meshes now, and
664
+ // come off when three starts the shadow pass of a render on this world's
665
+ // renderer (`shadowMap.render`, which three calls on every render after it
666
+ // has listed the draws and before it draws any, whatever the shadow
667
+ // settings); `end` puts the originals back and takes the hook off.
668
+ begin(reach, sun) {
669
+ this.end();
670
+ const pass = this.world.renderer?.shadowMap;
671
+ // The pass must take the hook (a plain, writable function, read from
672
+ // its descriptor): a pass a deck has made read-only draws the frame
673
+ // unfaded.
674
+ const had = pass ? writableValue(pass, 'render') : ACCESSOR;
675
+ if (this.dropped || typeof had !== 'function') return;
676
+ // The scene's own `onBeforeRender` runs inside the render before the
677
+ // draws are listed, while the variants are on the meshes: a scene with
678
+ // one of its own is not faded.
679
+ if (!plainObject(this.world.scene)) return;
680
+ // The renderer's own dispose listener, known before any variant meets
681
+ // the renderer (learned once per renderer, outside any render).
682
+ this.listener ??= disposeListenerOf(this.world.renderer);
683
+ if (!this.listener) return;
684
+ this.frame += 1;
685
+ this.uniform.value.set(FADE_FROM * reach, reach);
686
+ // The hook goes on first, and the variants only once it is on, so no
687
+ // variant is ever on a mesh without the hook that takes it off.
688
+ if (!this.hookPass(pass, had)) return;
689
+ this.firstSun = null;
690
+ this.protos.clear();
691
+ this.refused.clear();
692
+ this.world.scene.traverseVisible(this.visit);
693
+ if (this.firstSun !== sun) this.end();
694
+ }
695
+
696
+ // Our hook on the pass (`had` its own function); false when it did not
697
+ // take.
698
+ hookPass(pass, had) {
699
+ if (this.hook?.had !== had) this.hook = passHook(had);
700
+ const passOwn = own(pass, 'render');
701
+ if (!Reflect.set(pass, 'render', this.hook.render) || dataValue(pass, 'render') !== this.hook.render) return false;
702
+ this.hook.fade = this;
703
+ this.pass = pass;
704
+ this.passOwn = passOwn;
705
+ return true;
706
+ }
707
+
708
+ // The frame is over (nearshadows.js `giveBack`, whatever the render did):
709
+ // the originals back and the hook off. A hook a deck has replaced meanwhile
710
+ // stays replaced, and the one it may still call is inert. Assignments only.
711
+ end() {
712
+ this.restore();
713
+ const { pass, hook } = this;
714
+ if (hook) hook.fade = null;
715
+ // Our hook back off the pass, if it is still there and can be taken off
716
+ // (one that cannot stays, inert: it only calls the pass it had). A hook
717
+ // a deck put over it is left.
718
+ if (pass && hook && dataValue(pass, 'render') === hook.render) {
719
+ if (this.passOwn) {
720
+ if (!Reflect.set(pass, 'render', hook.had)) {
721
+ // Made read-only during the frame but still configurable: put the
722
+ // pass back with the deck's attributes and the function it had.
723
+ const descriptor = Object.getOwnPropertyDescriptor(pass, 'render');
724
+ if (descriptor?.configurable && 'value' in descriptor) {
725
+ Reflect.defineProperty(pass, 'render', { ...descriptor, value: hook.had });
726
+ }
727
+ }
728
+ } else {
729
+ Reflect.deleteProperty(pass, 'render');
730
+ }
731
+ } else if (pass) {
732
+ this.hook = null;
733
+ }
734
+ this.pass = null;
735
+ }
736
+
737
+ swapIn(object) {
738
+ if (object.isMesh === true) {
739
+ if (dataValue(object, 'receiveShadow') !== true || !plainObject(object, this.protos)) return;
740
+ // The one property the fade writes on a mesh: only the mesh's own,
741
+ // writable and configurable, else the mesh is drawn as it is.
742
+ const material = ownMaterial(object);
743
+ if (material === ACCESSOR) return;
744
+ // A mesh with an array of materials is drawn as it is: a variant array
745
+ // would be another array, and a write into it would not reach the
746
+ // mesh's own.
747
+ if (Array.isArray(material)) return;
748
+ const put = this.variantFor(material);
749
+ if (!put) return;
750
+ if (!Reflect.set(object, 'material', put)) return;
751
+ const i = this.count++;
752
+ this.meshes[i] = object;
753
+ this.had[i] = material;
754
+ this.put[i] = put;
755
+ } else if (this.firstSun === null && object.isDirectionalLight === true && object.castShadow === true && object.layers.test(this.world.camera.layers)) {
756
+ this.firstSun = object;
757
+ }
758
+ }
759
+
760
+ variantFor(material) {
761
+ let entry = this.variants.get(material);
762
+ // Looked at once a frame for each material.
763
+ if (entry?.seen === this.frame) return entry.variant;
764
+ if (this.refused.has(material)) return null;
765
+ const eligible = fadeable(material);
766
+ // One whose original is no longer one to fade, has other hooks than it
767
+ // holds, or cannot be brought back in step, is dropped (and a new one
768
+ // made if the original is still one to fade).
769
+ if (entry && entry.seen !== this.frame && (!eligible || !entry.current() || !entry.sync())) {
770
+ this.variants.delete(material);
771
+ this.dead.push(entry.variant);
772
+ entry.variant[STATE].inert = true;
773
+ entry = null;
774
+ }
775
+ if (!eligible) {
776
+ this.refused.add(material);
777
+ return null;
778
+ }
779
+ if (!entry) {
780
+ entry = makeVariant(material, this.uniform, this.listener, this.world.renderer?.properties);
781
+ this.variants.set(material, entry);
782
+ }
783
+ entry.seen = this.frame;
784
+ return entry.variant;
785
+ }
786
+
787
+ // The originals back on every mesh that still has what it was given.
788
+ // Assignments only.
789
+ restore() {
790
+ // Each mesh on its own: the bookkeeping is right after every one, and
791
+ // one that cannot be given its material back does not stop the others.
792
+ for (let i = this.count - 1; i >= 0; i--) {
793
+ const mesh = this.meshes[i];
794
+ const put = this.put[i];
795
+ const had = this.had[i];
796
+ this.meshes[i] = null;
797
+ this.had[i] = null;
798
+ this.put[i] = null;
799
+ this.count = i;
800
+ if (!putBack(mesh, put, had)) this.stuck.push({ mesh, put, had });
801
+ }
802
+ // Those that could not be before: tried again at every frame boundary.
803
+ if (this.stuck.length > 0) {
804
+ const stuck = this.stuck;
805
+ this.stuck = [];
806
+ for (const left of stuck) if (!putBack(left.mesh, left.put, left.had)) this.stuck.push(left);
807
+ }
808
+ }
809
+
810
+ // After the outermost `renderWorld`: what landed on the variants drawn
811
+ // this frame goes to their originals (`sync`), what was dropped is
812
+ // disposed, and now and then the variants not drawn for a while.
813
+ settle() {
814
+ if (!this.dropped && this.synced !== this.frame) {
815
+ this.synced = this.frame;
816
+ for (const [material, entry] of this.variants) {
817
+ if (entry.seen !== this.frame || entry.sync()) continue;
818
+ this.variants.delete(material);
819
+ this.dead.push(entry.variant);
820
+ entry.variant[STATE].inert = true;
821
+ }
822
+ }
823
+ const dead = this.dead;
824
+ if (dead.length > 0) {
825
+ this.dead = [];
826
+ disposeAll(dead);
827
+ }
828
+ if (this.dropped) {
829
+ this.disposeVariants(() => true, this.stuck.map((left) => left.put));
830
+ return;
831
+ }
832
+ if (this.frame - this.swept < SWEEP_EVERY) return;
833
+ this.swept = this.frame;
834
+ const stale = this.frame - SWEEP_EVERY;
835
+ this.disposeVariants((entry) => entry.seen <= stale);
836
+ }
837
+
838
+ disposeVariants(gone, held = []) {
839
+ const variants = new Set(held);
840
+ for (const [material, entry] of this.variants) {
841
+ if (!gone(entry)) continue;
842
+ this.variants.delete(material);
843
+ variants.add(entry.variant);
844
+ }
845
+ for (const variant of variants) variant[STATE].inert = true;
846
+ disposeAll(variants);
847
+ }
848
+ }
849
+
850
+ // A frame of a scene with the orbit key: the world's fade, if the scene also
851
+ // asked for near shadows, else null.
852
+ export function holdShadowFade(world, runtime) {
853
+ if (!(runtime?.nearShadowDistance > 0) || !patchable()) return null;
854
+ world.shadowFade ??= new ShadowFade(world);
855
+ return world.shadowFade;
856
+ }
857
+
858
+ // The outermost `renderWorld` of a faded frame, round the near-shadow mode's
859
+ // call (`draw(fade)`).
860
+ export function renderShadowFaded(fade, draw) {
861
+ fade.depth += 1;
862
+ try {
863
+ draw(fade);
864
+ } finally {
865
+ fade.depth -= 1;
866
+ if (fade.depth === 0) fade.settle();
867
+ }
868
+ }
869
+
870
+ // A scene load, an editor's frame, a frame of a scene without both keys,
871
+ // `disposeWorld`: the originals back and every variant disposed (after the
872
+ // render, if inside one).
873
+ export function dropShadowFade(world) {
874
+ const fade = world?.shadowFade;
875
+ if (!fade) return;
876
+ world.shadowFade = null;
877
+ fade.end();
878
+ fade.dropped = true;
879
+ // A variant a mesh still holds (`stuck`) draws as its original from now
880
+ // on; its program is let go of below and made again from the original's
881
+ // key.
882
+ for (const entry of fade.variants.values()) entry.variant[STATE].inert = true;
883
+ for (const left of fade.stuck) left.put[STATE].inert = true;
884
+ if (fade.depth === 0) fade.settle();
885
+ }
886
+
887
+ // For the tests: a world's variant of a material, if it has one.
888
+ export function shadowFadeVariant(world, material) {
889
+ return world.shadowFade?.variants.get(material)?.variant;
890
+ }