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,399 @@
1
+ // The opt-in still-caster cache of nearshadows.js. All work happens inside
2
+ // its one renderer.render call. Receivers keep three's ordinary PCF shader.
3
+ import * as THREE from 'three';
4
+ import { ActorNode, isFrozen } from './actornode.js';
5
+
6
+ // Misses draw normally; pay to build only after the complete key settles.
7
+ export const STABLE_FRAMES = 3;
8
+
9
+ // The ordering this uses is pinned to r180 WebGLShadowMap: clear, viewport,
10
+ // updateMatrices, getFrustum, draw. A different renderer draws uncached.
11
+ export function canCacheStill(renderer, scene) {
12
+ const descriptor = Object.getOwnPropertyDescriptor(renderer.shadowMap, 'render');
13
+ return THREE.REVISION === '180' && typeof renderer.renderBufferDirect === 'function' &&
14
+ !renderer.capabilities.reversedDepthBuffer && !renderer.capabilities.logarithmicDepthBuffer &&
15
+ descriptor?.writable === true && descriptor.configurable === true && typeof descriptor.value === 'function' &&
16
+ scene.onBeforeRender === THREE.Object3D.prototype.onBeforeRender && Object.isExtensible(scene.children);
17
+ }
18
+
19
+ // A still node does not promise that a shader, skin or morph stands still.
20
+ // Those casters remain movers. Alpha/displacement also depend on textures
21
+ // whose upload/readiness can change without touching an actor.
22
+ function plainDepthMaterial(material) {
23
+ return material && !material.alphaTest && !material.alphaHash && !material.alphaToCoverage &&
24
+ !material.displacementMap && !material.clippingPlanes?.length && !material.wireframe;
25
+ }
26
+
27
+ function plainDepth(object) {
28
+ if (object.isSkinnedMesh || object.isInstancedMesh || object.morphTargetInfluences?.length || object.customDepthMaterial) return false;
29
+ const material = object.material;
30
+ return Array.isArray(material) ? material.every(plainDepthMaterial) : plainDepthMaterial(material);
31
+ }
32
+
33
+ // Reordering a depth-only caster around the cached ones is sound only for
34
+ // an ordinary nearest-depth winner. Custom blending/write/test rules can
35
+ // make draw order significant, so those frames use the original pass.
36
+ function mergeableDepth(object) {
37
+ const depth = object.customDepthMaterial;
38
+ return !depth || (depth.depthTest === true && depth.depthWrite === true && depth.colorWrite === true &&
39
+ depth.depthFunc === THREE.LessEqualDepth && depth.onBeforeCompile === THREE.Material.prototype.onBeforeCompile &&
40
+ (depth.blending === THREE.NoBlending || (depth.blending === THREE.NormalBlending && depth.transparent === false)));
41
+ }
42
+
43
+ function passHook(had) {
44
+ const hook = {
45
+ had, cache: null,
46
+ render(lights, scene, camera) { return hook.cache ? hook.cache.render(lights, scene, camera) : had.call(this, lights, scene, camera); },
47
+ };
48
+ return hook;
49
+ }
50
+
51
+ function sameNumbers(a, b) {
52
+ if (a.length !== b.length) return false;
53
+ for (let i = 0; i < a.length; i++) if (a[i] !== b[i]) return false;
54
+ return true;
55
+ }
56
+
57
+ export class StillShadows {
58
+ constructor(world, near) {
59
+ this.world = world;
60
+ this.near = near;
61
+ this.shadow = new THREE.DirectionalLight().shadow;
62
+ // The sun's actual position is never used to place this second camera.
63
+ this.shadow.updateMatrices = () => {};
64
+ this.shadow.getFrustum = () => near.getFrustum();
65
+ this.oneLight = [];
66
+ this.casters = [];
67
+ this.stillFlags = [];
68
+ this.writableFlags = new WeakMap();
69
+ this.hidden = [];
70
+ this.hiddenCount = 0;
71
+ this.was = [];
72
+ this.now = [];
73
+ this.stableFrames = 0;
74
+ this.frameNumber = 0;
75
+ this.observedAt = 0;
76
+ this.valid = false;
77
+ this.frame = null;
78
+ this.inSun = false;
79
+ this.hook = null;
80
+ }
81
+
82
+ begin(frame, runtime) {
83
+ this.frame = frame;
84
+ this.frameNumber += 1;
85
+ this.runtime = runtime;
86
+ this.pass = this.world.renderer.shadowMap;
87
+ this.had = this.pass.render;
88
+ if (this.hook?.had !== this.had) this.hook = passHook(this.had);
89
+ this.hook.cache = this;
90
+ this.pass.render = this.hook.render;
91
+ if (this.valid || this.stableFrames !== STABLE_FRAMES - 1) return;
92
+ this.makeCopy();
93
+ // Register/upload the geometry through three's ordinary object walk.
94
+ // An invisible material submits no colour draw; renderBufferDirect
95
+ // below still draws it. Attach/detach without dispatching deck events.
96
+ this.triangle.parent = this.world.scene;
97
+ this.world.scene.children.push(this.triangle);
98
+ }
99
+
100
+ // Split only the shadow pass, preserving its light order. Cast flags are
101
+ // restored before any other light or the colour pass sees the scene.
102
+ // The held fade hook restores original materials before either depth pass.
103
+ render(lights, scene, camera) {
104
+ if (!this.frame) return this.had.call(this.pass, lights, scene, camera);
105
+ // A nested render may use this renderer and sun with another view. It
106
+ // must neither seed from nor change the primary view's candidate key.
107
+ if (scene !== this.world.scene || camera !== this.near.view) {
108
+ const inSun = this.inSun;
109
+ this.inSun = false;
110
+ try { return this.had.call(this.pass, lights, scene, camera); }
111
+ finally { this.inSun = inSun; }
112
+ }
113
+ this.renderScene = scene;
114
+ this.renderCamera = camera;
115
+ // Geometry registration is done; no deck's shadow/colour callback sees
116
+ // the private upload mesh in the scene graph.
117
+ this.detach();
118
+ for (let i = 0; i < lights.length; i++) {
119
+ const light = lights[i];
120
+ this.oneLight[0] = light;
121
+ this.inSun = light === this.frame?.sun;
122
+ try {
123
+ this.had.call(this.pass, this.oneLight, scene, camera);
124
+ } finally {
125
+ this.restore();
126
+ this.inSun = false;
127
+ }
128
+ }
129
+ this.oneLight[0] = null;
130
+ }
131
+
132
+ current() {
133
+ return this.frame && this.world.nearShadows?.frame === this.frame && this.frame.sun.shadow === this.near;
134
+ }
135
+
136
+ // Called after the live map's clear. A nested WebGLShadowMap pass saves
137
+ // and restores that target, and uses exactly the same size and viewport;
138
+ // the outer pass re-reads its frustum immediately after this returns.
139
+ draw(light) {
140
+ if (!this.inSun || !this.current()) return;
141
+ this.casterCount = 0;
142
+ this.stillCount = 0;
143
+ this.keyLength = 0;
144
+ const runtime = this.runtime;
145
+ const now = this.now;
146
+ now[this.keyLength++] = runtime;
147
+ now[this.keyLength++] = runtime.stillVersion;
148
+ now[this.keyLength++] = this.world.skipping?.epoch;
149
+ now[this.keyLength++] = light;
150
+ now[this.keyLength++] = this.renderScene;
151
+ now[this.keyLength++] = this.renderCamera;
152
+ now[this.keyLength++] = this.renderCamera.layers.mask;
153
+ this.recordMatrix(this.near.matrix);
154
+ this.recordMatrix(this.near.camera.projectionMatrix);
155
+ this.frustum = this.near.getFrustum();
156
+ const eligible = this.collect(this.renderScene, false);
157
+ this.casters.length = this.stillFlags.length = this.casterCount;
158
+ now.length = this.keyLength;
159
+ if (!eligible || this.stillCount === 0) {
160
+ this.valid = false;
161
+ this.stableFrames = 0;
162
+ this.was.length = this.now.length = 0;
163
+ return;
164
+ }
165
+ const lostMap = this.valid && this.shadow.map && this.world.renderer.properties?.has && !this.world.renderer.properties.has(this.shadow.map.texture);
166
+ const sameFrame = this.observedAt === this.frameNumber;
167
+ if (lostMap || !sameNumbers(now, this.was) || (!sameFrame && this.observedAt !== this.frameNumber - 1)) {
168
+ this.valid = false;
169
+ this.stableFrames = 1;
170
+ this.observedAt = this.frameNumber;
171
+ this.now = this.was;
172
+ this.was = now;
173
+ return; // A miss costs only key computation over the ordinary pass.
174
+ }
175
+ if (!sameFrame) {
176
+ this.observedAt = this.frameNumber;
177
+ this.stableFrames = Math.min(STABLE_FRAMES, this.stableFrames + 1);
178
+ }
179
+ if (!this.valid) {
180
+ if (this.stableFrames < STABLE_FRAMES) return;
181
+ if (!this.mask(true)) return this.refuse();
182
+ this.allocate();
183
+ this.shadow.camera.copy(this.near.camera);
184
+ this.shadow.matrix.copy(this.near.matrix);
185
+ this.shadow.mapSize.copy(this.near.mapSize);
186
+ const renderer = this.world.renderer;
187
+ const target = renderer.getRenderTarget();
188
+ const face = renderer.getActiveCubeFace();
189
+ const mip = renderer.getActiveMipmapLevel();
190
+ light.shadow = this.shadow;
191
+ try {
192
+ this.had.call(this.pass, this.oneLight, this.renderScene, this.renderCamera);
193
+ } finally {
194
+ this.restore();
195
+ // A re-entry/dispose already gave the sun back: never undo it.
196
+ if (this.frame && light.shadow === this.shadow) light.shadow = this.near;
197
+ // WebGLShadowMap itself restores the target only on success.
198
+ if (this.current()) renderer.setRenderTarget(target, face, mip);
199
+ }
200
+ if (!this.current()) return;
201
+ this.valid = true;
202
+ }
203
+ if (!this.current()) return;
204
+ if (!this.mask(false)) return this.refuse();
205
+ const renderer = this.world.renderer;
206
+ renderer.renderBufferDirect(this.near.camera, null, this.geometry, this.material, this.triangle, null);
207
+ }
208
+
209
+ refuse() {
210
+ this.restore();
211
+ this.valid = false;
212
+ this.stableFrames = 0;
213
+ this.was.length = 0;
214
+ }
215
+
216
+ // Cache precisely the still casters the ordinary slice would draw. In
217
+ // addition to box/version changes, a changed selection invalidates it:
218
+ // caching the full box instead could add shadows beyond the view slice.
219
+ collect(object, frozen) {
220
+ if (!object.visible) return true;
221
+ if (object instanceof ActorNode) {
222
+ const adopted = this.world.stillKeeper?.adopted;
223
+ frozen = (this.world.frozenStatics?.runtime === this.runtime && object.frozenStatic === true) ||
224
+ (this.runtime.keepsStaticActors === true && this.world.stillKeeper?.running === 0 &&
225
+ adopted?.version === this.runtime.stillVersion && isFrozen(object));
226
+ }
227
+ if (object.castShadow && (object.isMesh || object.isLine || object.isPoints) && object.layers.test(this.renderCamera.layers)) {
228
+ // Inspect a new caster once. Later flag locks are caught by mask's
229
+ // Reflect.set before any copy/draw, without allocating descriptors in
230
+ // every key computation.
231
+ let writable = this.writableFlags.get(object);
232
+ if (writable === undefined) {
233
+ const descriptor = Object.getOwnPropertyDescriptor(object, 'castShadow');
234
+ writable = descriptor?.writable === true && descriptor.value === true;
235
+ this.writableFlags.set(object, writable);
236
+ }
237
+ // Callbacks could observe the temporary flags or mutate other casters.
238
+ // Draw this frame uncached rather than change their behaviour.
239
+ if (!writable || object.castShadow !== true ||
240
+ object.onBeforeShadow !== THREE.Object3D.prototype.onBeforeShadow ||
241
+ object.onAfterShadow !== THREE.Object3D.prototype.onAfterShadow || !mergeableDepth(object)) return false;
242
+ const index = this.casterCount++;
243
+ this.casters[index] = object;
244
+ const still = frozen && plainDepth(object) && (!object.frustumCulled || this.frustum.intersectsObject(object));
245
+ this.stillFlags[index] = still;
246
+ if (still) {
247
+ this.stillCount += 1;
248
+ this.record(object);
249
+ }
250
+ }
251
+ for (let i = 0; i < object.children.length; i++) if (!this.collect(object.children[i], frozen)) return false;
252
+ return true;
253
+ }
254
+
255
+ record(object) {
256
+ const geometry = object.geometry;
257
+ const position = geometry.attributes.position;
258
+ const index = geometry.index;
259
+ const now = this.now;
260
+ let at = this.keyLength;
261
+ now[at++] = object;
262
+ now[at++] = geometry;
263
+ now[at++] = position;
264
+ now[at++] = position?.version;
265
+ now[at++] = position?.data?.version;
266
+ now[at++] = index;
267
+ now[at++] = index?.version;
268
+ now[at++] = geometry.drawRange.start;
269
+ now[at++] = geometry.drawRange.count;
270
+ now[at++] = geometry.groups.length;
271
+ for (let i = 0; i < geometry.groups.length; i++) {
272
+ const group = geometry.groups[i];
273
+ now[at++] = group.start;
274
+ now[at++] = group.count;
275
+ now[at++] = group.materialIndex;
276
+ }
277
+ this.keyLength = at;
278
+ this.recordMatrix(object.matrixWorld);
279
+ const material = object.material;
280
+ if (Array.isArray(material)) {
281
+ now[this.keyLength++] = material.length;
282
+ for (let i = 0; i < material.length; i++) this.recordMaterial(material[i]);
283
+ } else {
284
+ now[this.keyLength++] = 1;
285
+ this.recordMaterial(material);
286
+ }
287
+ }
288
+
289
+ recordMaterial(material) {
290
+ const now = this.now;
291
+ let at = this.keyLength;
292
+ now[at++] = material;
293
+ now[at++] = material?.version;
294
+ now[at++] = material?.visible;
295
+ now[at++] = material?.side;
296
+ now[at++] = material?.shadowSide;
297
+ this.keyLength = at;
298
+ }
299
+
300
+ recordMatrix(matrix) {
301
+ for (let i = 0; i < 16; i++) this.now[this.keyLength++] = matrix.elements[i];
302
+ }
303
+
304
+ mask(stillPass) {
305
+ for (let i = 0; i < this.casterCount; i++) {
306
+ if (this.stillFlags[i] === stillPass) continue;
307
+ const object = this.casters[i];
308
+ this.hidden[this.hiddenCount++] = object;
309
+ if (!Reflect.set(object, 'castShadow', false) || object.castShadow !== false) return false;
310
+ }
311
+ return true;
312
+ }
313
+
314
+ restore() {
315
+ for (let i = 0; i < this.hiddenCount; i++) {
316
+ const object = this.hidden[i];
317
+ this.hidden[i] = null;
318
+ // A callback installed mid-pass may have locked/redefined a flag.
319
+ // Restore every other object even when that one cannot be restored.
320
+ try {
321
+ if (object.castShadow !== false || Reflect.set(object, 'castShadow', true)) continue;
322
+ const descriptor = Object.getOwnPropertyDescriptor(object, 'castShadow');
323
+ if (descriptor?.value === false && descriptor.configurable) Object.defineProperty(object, 'castShadow', { ...descriptor, value: true });
324
+ } catch { /* Keep the remaining restorations and cleanup total. */ }
325
+ }
326
+ this.hiddenCount = 0;
327
+ }
328
+
329
+ allocate() {
330
+ if (this.shadow.map) return;
331
+ const { x, y } = this.near.mapSize;
332
+ this.shadow.map = new THREE.WebGLRenderTarget(x, y, {
333
+ minFilter: THREE.NearestFilter, magFilter: THREE.NearestFilter,
334
+ depthTexture: new THREE.DepthTexture(x, y, THREE.UnsignedIntType),
335
+ });
336
+ this.material.uniforms.cachedColor.value = this.shadow.map.texture;
337
+ this.material.uniforms.cachedDepth.value = this.shadow.map.depthTexture;
338
+ }
339
+
340
+ makeCopy() {
341
+ if (this.triangle) return;
342
+ this.geometry = new THREE.BufferGeometry();
343
+ this.geometry.setAttribute('position', new THREE.Float32BufferAttribute([-1, -1, 0, 3, -1, 0, -1, 3, 0], 3));
344
+ this.material = new THREE.ShaderMaterial({
345
+ uniforms: { cachedColor: { value: null }, cachedDepth: { value: null } },
346
+ vertexShader: 'varying vec2 vUv; void main() { vUv = position.xy * 0.5 + 0.5; gl_Position = vec4(position, 1.0); }',
347
+ fragmentShader: `uniform sampler2D cachedColor;
348
+ uniform sampler2D cachedDepth;
349
+ varying vec2 vUv;
350
+ void main() {
351
+ gl_FragColor = texture2D(cachedColor, vUv);
352
+ gl_FragDepth = texture2D(cachedDepth, vUv).x;
353
+ }`,
354
+ blending: THREE.NoBlending, depthTest: true, depthWrite: true, depthFunc: THREE.AlwaysDepth, toneMapped: false, visible: false,
355
+ });
356
+ this.triangle = new THREE.Mesh(this.geometry, this.material);
357
+ this.triangle.frustumCulled = false;
358
+ this.triangle.layers.enableAll();
359
+ }
360
+
361
+ end() {
362
+ this.restore();
363
+ this.frame = null;
364
+ this.runtime = null;
365
+ this.inSun = false;
366
+ if (this.hook) this.hook.cache = null;
367
+ this.detach();
368
+ const descriptor = this.pass && Object.getOwnPropertyDescriptor(this.pass, 'render');
369
+ if (descriptor?.value === this.hook?.render) {
370
+ if (descriptor.writable) this.pass.render = this.had;
371
+ else if (descriptor.configurable) Object.defineProperty(this.pass, 'render', { ...descriptor, value: this.had });
372
+ }
373
+ this.oneLight[0] = null;
374
+ this.renderScene = this.renderCamera = null;
375
+ }
376
+
377
+ detach() {
378
+ if (this.triangle?.parent !== this.world.scene) return;
379
+ const index = this.world.scene.children.indexOf(this.triangle);
380
+ if (index >= 0) this.world.scene.children.splice(index, 1);
381
+ this.triangle.parent = null;
382
+ }
383
+
384
+ dispose() {
385
+ this.end();
386
+ const resources = [this.shadow.map, this.geometry, this.material];
387
+ this.shadow.map = null;
388
+ this.geometry = this.material = this.triangle = null;
389
+ this.was.length = this.now.length = 0;
390
+ this.casters.length = this.stillFlags.length = this.hidden.length = 0;
391
+ this.writableFlags = null;
392
+ this.valid = false;
393
+ let failure;
394
+ for (const resource of resources) {
395
+ try { resource?.dispose(); } catch (error) { failure ??= { error }; }
396
+ }
397
+ if (failure) throw failure.error;
398
+ }
399
+ }
@@ -5,37 +5,13 @@
5
5
  // Both return a THREE.BufferGeometry, or null when the part's fields cannot
6
6
  // make one.
7
7
 
8
+ import { clampInt, points2, points3 } from './modelMath';
8
9
  import * as THREE from 'three';
9
10
  import { partPath } from './paths';
10
11
  import { circleSides, lengthSteps } from './optimize';
11
12
 
12
13
  const DEG = Math.PI / 180;
13
14
 
14
- function clampInt(value, min, max, fallback) {
15
- if (!Number.isFinite(value)) {
16
- return fallback;
17
- }
18
- return Math.max(min, Math.min(max, Math.round(value)));
19
- }
20
-
21
- function points2(list) {
22
- if (!Array.isArray(list)) {
23
- return [];
24
- }
25
- return list
26
- .filter((p) => Array.isArray(p) && Number.isFinite(p[0]) && Number.isFinite(p[1]))
27
- .map((p) => new THREE.Vector2(p[0], p[1]));
28
- }
29
-
30
- function points3(list) {
31
- if (!Array.isArray(list)) {
32
- return [];
33
- }
34
- return list
35
- .filter((p) => Array.isArray(p) && p.slice(0, 3).every(Number.isFinite))
36
- .map((p) => new THREE.Vector3(p[0], p[1], p[2]));
37
- }
38
-
39
15
  //
40
16
  // Sweep
41
17
  //
@@ -151,3 +151,14 @@ export function recordReads(target, reads) {
151
151
  },
152
152
  });
153
153
  }
154
+
155
+ // For the audit of a scene that set `"engine": { "staticActors": true }`
156
+ // (`world.auditStatic`, QA only; world3d.js): writes down that a still actor
157
+ // was found changed with no `scene.touch`, and warns of each actor once.
158
+ export function noteChangedStill(world, id, what) {
159
+ const failures = (world.staticAuditFailures ??= []);
160
+ if (!failures.some((failure) => failure.id === id)) {
161
+ console.warn(`staticActors: "${id}" is marked static and ${what} changed without scene.touch`);
162
+ }
163
+ failures.push({ id, what });
164
+ }
@@ -0,0 +1,52 @@
1
+ // Opt-in engine.view.far (metres). Like orbitlens.js, keep the camera's
2
+ // original value on the first keyed frame, and return it before the next
3
+ // scene's code, when the key goes, on an editor frame, or on disposal.
4
+ // No imports: Fog and the optional sky colour reader come from the renderer.
5
+ // A keyless world allocates nothing and writes nothing, including on reset
6
+ // and disposal.
7
+ export function viewFar(data) {
8
+ const far = data?.engine?.view?.far;
9
+ return typeof far === 'number' && far >= 20 && far <= 1000 ? far : null;
10
+ }
11
+
12
+ const hexColor = (value) => typeof value === 'string' && /^#[\da-f]{6}$/i.test(value);
13
+
14
+ function backgroundColor(world, data) {
15
+ if (world.scene.background?.isColor) return world.scene.background;
16
+ return hexColor(data.background) ? data.background : 0x808080;
17
+ }
18
+
19
+ export function fitViewRange(world, runtime, Fog, skyColor) {
20
+ const far = viewFar(runtime?.data);
21
+ if (far === null) {
22
+ giveBackViewRange(world);
23
+ return;
24
+ }
25
+ if (world.disposed === true) return;
26
+ const camera = world.camera;
27
+ const range = (world.viewRange ??= { far: camera.far, fog: world.scene.fog, owned: new Fog(0x808080, 0, far) });
28
+ const view = runtime.data.engine.view;
29
+ const from = Number.isFinite(view.fogFrom) ? view.fogFrom : 0.75 * far;
30
+ range.owned.near = Math.max(0, Math.min(far * (1 - 1e-6), from));
31
+ range.owned.far = far;
32
+ const color = hexColor(view.fogColor) ? view.fogColor : skyColor?.(world, range) ?? backgroundColor(world, runtime.data);
33
+ // Color inputs already use three's linear working space; set copies them.
34
+ range.owned.color.set(color);
35
+ if (world.scene.fog !== range.owned) world.scene.fog = range.owned;
36
+ if (camera.far !== far) {
37
+ camera.far = far;
38
+ camera.updateProjectionMatrix();
39
+ }
40
+ }
41
+
42
+ export function giveBackViewRange(world) {
43
+ const range = world?.viewRange;
44
+ if (!range) return;
45
+ world.viewRange = null;
46
+ world.scene.fog = range.fog;
47
+ const camera = world.camera;
48
+ if (camera && camera.far !== range.far) {
49
+ camera.far = range.far;
50
+ camera.updateProjectionMatrix();
51
+ }
52
+ }