@wildshard/engine 0.0.1 → 0.1.15

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 (3051) hide show
  1. package/CHANGELOG.md +128 -0
  2. package/budgets/calibration/m5-2026-10-01T08-07-18-573Z.json +3985 -0
  3. package/budgets/calibration/m5-2026-10-01T22-02-53-510Z.json +4473 -0
  4. package/budgets/calibration-reports/README.md +25 -0
  5. package/budgets/calibration-reports/_template.desktop.json +1994 -0
  6. package/budgets/calibration-reports/_template.phone.json +2069 -0
  7. package/budgets/calibration-reports/assessment.json +571 -0
  8. package/budgets/calibration-reports/driftwood-isle.phone.json +72 -0
  9. package/budgets/calibration-reports/far-reach.desktop.json +73158 -0
  10. package/budgets/calibration-reports/far-reach.phone.json +73086 -0
  11. package/budgets/calibration-reports/nalati-grasslands-x22.desktop.json +19525 -0
  12. package/budgets/calibration-reports/nalati-grasslands.phone.json +72 -0
  13. package/budgets/calibration-reports/nine-dragon-stack-g224.desktop.json +146 -0
  14. package/budgets/calibration-reports/nine-dragon-stack.phone.json +89 -0
  15. package/budgets/calibration-reports/pine-hollow.desktop.json +54949 -0
  16. package/budgets/calibration-reports/pine-hollow.phone.json +72 -0
  17. package/budgets/calibration-reports/sunscar-dunes.desktop.json +7788 -0
  18. package/budgets/calibration-reports/sunscar-dunes.phone.json +9378 -0
  19. package/budgets/calibration.json +4473 -0
  20. package/budgets/ceiling-re-records.json +71 -0
  21. package/budgets/ceiling-sources.json +5985 -0
  22. package/budgets/desktop-reference.json +7 -0
  23. package/budgets/g224-ceiling-re-record.json +15 -0
  24. package/budgets/grid-strip-room.json +9 -0
  25. package/budgets/nalati-ceiling-sources.json +44 -0
  26. package/budgets/shard-size-baseline.json +552 -0
  27. package/budgets/x22-ceiling-re-record.json +15 -0
  28. package/budgets/x7-ceiling-sources.json +41 -0
  29. package/index.html +622 -0
  30. package/lint/api-undocumented.json +7 -0
  31. package/lint/authored-html.d.mts +4 -0
  32. package/lint/authored-html.mjs +313 -0
  33. package/lint/base64-debt.json +18 -0
  34. package/lint/class-moves.json +4 -0
  35. package/lint/client-plan-boundary.d.mts +2 -0
  36. package/lint/client-plan-boundary.mjs +102 -0
  37. package/lint/debug-flags.d.mts +5 -0
  38. package/lint/debug-flags.mjs +190 -0
  39. package/lint/declaration-config.d.mts +2 -0
  40. package/lint/declaration-config.mjs +19 -0
  41. package/lint/edge-exemptions.json +6 -0
  42. package/lint/engine-internal.json +26 -0
  43. package/lint/engine-side-edges.json +5 -0
  44. package/lint/engine-sides.d.mts +30 -0
  45. package/lint/engine-sides.json +1794 -0
  46. package/lint/engine-sides.mjs +269 -0
  47. package/lint/engine-words.json +7 -0
  48. package/lint/exec-max-buffer.mjs +88 -0
  49. package/lint/generated-import-debt.json +117 -0
  50. package/lint/generated-source-debt.json +1029 -0
  51. package/lint/host-callback-syntax.d.mts +4 -0
  52. package/lint/host-callback-syntax.mjs +62 -0
  53. package/lint/host-callbacks.d.mts +6 -0
  54. package/lint/host-callbacks.mjs +123 -0
  55. package/lint/host-files.d.mts +1 -0
  56. package/lint/host-files.mjs +7 -0
  57. package/lint/host-reviews.json +14 -0
  58. package/lint/layer-edges.json +15 -0
  59. package/lint/layer-exports.d.mts +2 -0
  60. package/lint/layer-exports.mjs +23 -0
  61. package/lint/legacy-line-basis.json +995 -0
  62. package/lint/listed-view-code.json +13 -0
  63. package/lint/manifest-closure-budget.json +6 -0
  64. package/lint/nine-tiling-baseline.json +35 -0
  65. package/lint/no-base64.d.mts +19 -0
  66. package/lint/no-base64.mjs +112 -0
  67. package/lint/no-binary-json.json +174 -0
  68. package/lint/no-generated-import.d.mts +22 -0
  69. package/lint/no-generated-import.mjs +114 -0
  70. package/lint/page-events.json +895 -0
  71. package/lint/platform-pending-users.json +2520 -0
  72. package/lint/platform-pending-users.md +18 -0
  73. package/lint/ratchet-files.d.mts +2 -0
  74. package/lint/ratchet-files.mjs +45 -0
  75. package/lint/ratchet.json +230 -0
  76. package/lint/ratchet.mjs +212 -0
  77. package/lint/recorded-debt.mjs +24 -0
  78. package/lint/row-functions.json +173 -0
  79. package/lint/runtime-files.d.mts +12 -0
  80. package/lint/runtime-files.json +16 -0
  81. package/lint/runtime-files.mjs +69 -0
  82. package/lint/runtime-performance.d.mts +6 -0
  83. package/lint/runtime-performance.json +14 -0
  84. package/lint/runtime-performance.mjs +184 -0
  85. package/lint/schema-types.d.mts +9 -0
  86. package/lint/schema-types.mjs +114 -0
  87. package/lint/shard-coupling.json +333 -0
  88. package/lint/shard-imports.d.mts +5 -0
  89. package/lint/shard-imports.mjs +43 -0
  90. package/lint/shard-layout.json +64 -0
  91. package/lint/shard-platform.json +24 -0
  92. package/lint/shard-words.pin.json +421 -0
  93. package/lint/shardfile-boundaries.d.mts +10 -0
  94. package/lint/shardfile-boundaries.mjs +122 -0
  95. package/lint/sim-closure.d.mts +3 -0
  96. package/lint/sim-closure.json +3 -0
  97. package/lint/sim-closure.mjs +112 -0
  98. package/lint/sim-players.json +17 -0
  99. package/lint/sim-schema-leaves.json +1 -0
  100. package/lint/source-stamps.mjs +12 -0
  101. package/lint/syntax-values.mjs +299 -0
  102. package/lint/tile-bake-debt.json +556 -0
  103. package/lint/url-params.json +48 -0
  104. package/lint/weapon-subclasses.json +4 -0
  105. package/lint/wildshard-plugin.d.ts +13 -0
  106. package/lint/wildshard-plugin.js +1196 -0
  107. package/package.json +1298 -3
  108. package/scripts/agent-parity.mjs +1524 -0
  109. package/scripts/agent-sync.mjs +518 -0
  110. package/scripts/agent-time.py +475 -0
  111. package/scripts/apfs-clone.mjs +67 -0
  112. package/scripts/api-origin.d.mts +3 -0
  113. package/scripts/api-origin.mjs +38 -0
  114. package/scripts/app-build/appCook.ts +19 -0
  115. package/scripts/app-build/assetHashes.ts +57 -0
  116. package/scripts/app-build/assetLimits.d.mts +15 -0
  117. package/scripts/app-build/assetLimits.mjs +61 -0
  118. package/scripts/app-build/assetTables.d.mts +19 -0
  119. package/scripts/app-build/assetTables.mjs +68 -0
  120. package/scripts/app-build/audioPacks.ts +41 -0
  121. package/scripts/app-build/bakedTextures.d.mts +2 -0
  122. package/scripts/app-build/bakedTextures.mjs +59 -0
  123. package/scripts/app-build/basis.ts +25 -0
  124. package/scripts/app-build/bootExtras.ts +127 -0
  125. package/scripts/app-build/bootModules.ts +271 -0
  126. package/scripts/app-build/bootProductTiers.ts +48 -0
  127. package/scripts/app-build/bootProducts.ts +67 -0
  128. package/scripts/app-build/buildIdentity.d.mts +16 -0
  129. package/scripts/app-build/buildIdentity.mjs +89 -0
  130. package/scripts/app-build/catalogue.ts +216 -0
  131. package/scripts/app-build/chunkReport.d.mts +3 -0
  132. package/scripts/app-build/chunkReport.mjs +29 -0
  133. package/scripts/app-build/contentBase.d.mts +2 -0
  134. package/scripts/app-build/contentBase.mjs +34 -0
  135. package/scripts/app-build/controlChunks.ts +106 -0
  136. package/scripts/app-build/crossroadsRig.ts +17 -0
  137. package/scripts/app-build/doctorOutput.mjs +19 -0
  138. package/scripts/app-build/finalChunkNames.d.mts +3 -0
  139. package/scripts/app-build/finalChunkNames.mjs +94 -0
  140. package/scripts/app-build/gen.ts +100 -0
  141. package/scripts/app-build/gridSeams.d.mts +16 -0
  142. package/scripts/app-build/gridSeams.mjs +95 -0
  143. package/scripts/app-build/homeIcons.d.mts +20 -0
  144. package/scripts/app-build/homeIcons.mjs +64 -0
  145. package/scripts/app-build/importMap.d.mts +7 -0
  146. package/scripts/app-build/importMap.mjs +102 -0
  147. package/scripts/app-build/noTopLevelAwait.d.mts +4 -0
  148. package/scripts/app-build/noTopLevelAwait.mjs +36 -0
  149. package/scripts/app-build/outputProducts.d.mts +10 -0
  150. package/scripts/app-build/outputProducts.mjs +114 -0
  151. package/scripts/app-build/previousDeploy.d.mts +24 -0
  152. package/scripts/app-build/previousDeploy.mjs +245 -0
  153. package/scripts/app-build/serviceWorker.ts +145 -0
  154. package/scripts/app-build/splitOutput.d.mts +6 -0
  155. package/scripts/app-build/splitOutput.mjs +98 -0
  156. package/scripts/app-build/standaloneOutput.d.mts +4 -0
  157. package/scripts/app-build/standaloneOutput.mjs +31 -0
  158. package/scripts/app-build/validationReceipts.d.mts +2 -0
  159. package/scripts/app-build/validationReceipts.mjs +25 -0
  160. package/scripts/app-build/versionFiles.ts +20 -0
  161. package/scripts/app-build/worldMapAtlas.ts +62 -0
  162. package/scripts/app-build/writtenBundle.ts +51 -0
  163. package/scripts/app-build-pipeline-proof.mjs +67 -0
  164. package/scripts/app-build-pipeline.mjs +274 -0
  165. package/scripts/assert-store-layout.mjs +17 -0
  166. package/scripts/author-bundle-cache.d.mts +1 -0
  167. package/scripts/author-bundle-cache.mjs +137 -0
  168. package/scripts/author-bundle-usage.d.mts +3 -0
  169. package/scripts/author-bundle-usage.mjs +20 -0
  170. package/scripts/authored-manifest.d.mts +7 -0
  171. package/scripts/authored-manifest.mjs +217 -0
  172. package/scripts/authoring-inputs.d.mts +8 -0
  173. package/scripts/authoring-inputs.mjs +104 -0
  174. package/scripts/bake-grid-seams.mjs +110 -0
  175. package/scripts/bake-input-hashes.d.mts +6 -0
  176. package/scripts/bake-input-hashes.mjs +59 -0
  177. package/scripts/bake-loader.mjs +105 -0
  178. package/scripts/bake-output.d.mts +29 -0
  179. package/scripts/bake-output.mjs +84 -0
  180. package/scripts/bench-load.mjs +391 -0
  181. package/scripts/boot-dist-plan.mjs +47 -0
  182. package/scripts/boot-dist.py +251 -0
  183. package/scripts/boot-pack-parts.d.mts +2 -0
  184. package/scripts/boot-pack-parts.mjs +51 -0
  185. package/scripts/boot-publication-proof.d.mts +2 -0
  186. package/scripts/boot-publication-proof.mjs +64 -0
  187. package/scripts/boot-publication.d.mts +19 -0
  188. package/scripts/boot-publication.generated.json +3684 -0
  189. package/scripts/boot-publication.mjs +100 -0
  190. package/scripts/boot-temp-warn.sh +70 -0
  191. package/scripts/boot-timing-proof.mjs +264 -0
  192. package/scripts/browser-lane.sh +288 -0
  193. package/scripts/browser-slot-lock.py +49 -0
  194. package/scripts/budget-ceilings.mjs +88 -0
  195. package/scripts/budget-ratchet.d.mts +1 -0
  196. package/scripts/budget-ratchet.mjs +8 -0
  197. package/scripts/build-app.mjs +49 -0
  198. package/scripts/build-cache-report.d.mts +20 -0
  199. package/scripts/build-cache-report.mjs +104 -0
  200. package/scripts/build-mirror.d.mts +24 -0
  201. package/scripts/build-mirror.mjs +387 -0
  202. package/scripts/build-server.mjs +47 -0
  203. package/scripts/build-without-browser.mjs +14 -0
  204. package/scripts/built-product.d.mts +22 -0
  205. package/scripts/built-product.mjs +187 -0
  206. package/scripts/calibrate.mjs +43 -0
  207. package/scripts/capture-main-menu-hero.mjs +457 -0
  208. package/scripts/catalogue-all-heads.ts +35 -0
  209. package/scripts/changelog.d.mts +18 -0
  210. package/scripts/changelog.mjs +129 -0
  211. package/scripts/chaos-proxy-core.mjs +978 -0
  212. package/scripts/chaos-proxy-proof.mjs +1130 -0
  213. package/scripts/chaos-proxy.mjs +68 -0
  214. package/scripts/chaos-router.mjs +107 -0
  215. package/scripts/chaos-rules.mjs +197 -0
  216. package/scripts/check-chunks.d.mts +8 -0
  217. package/scripts/check-chunks.mjs +143 -0
  218. package/scripts/check-closed-components.d.mts +7 -0
  219. package/scripts/check-closed-components.mjs +87 -0
  220. package/scripts/check-css.mjs +235 -0
  221. package/scripts/check-custom-sections-zero.d.mts +2 -0
  222. package/scripts/check-custom-sections-zero.mjs +43 -0
  223. package/scripts/check-devserver.d.mts +2 -0
  224. package/scripts/check-devserver.mjs +29 -0
  225. package/scripts/check-engine-sides.mjs +85 -0
  226. package/scripts/check-graph.d.mts +9 -0
  227. package/scripts/check-graph.mjs +217 -0
  228. package/scripts/check-listeners.mjs +122 -0
  229. package/scripts/check-model-sources.mjs +106 -0
  230. package/scripts/check-models.d.mts +22 -0
  231. package/scripts/check-models.mjs +367 -0
  232. package/scripts/check-page-events.mjs +386 -0
  233. package/scripts/check-paths.allow.json +1282 -0
  234. package/scripts/check-paths.mjs +97 -0
  235. package/scripts/check-platform-ratchets.d.mts +7 -0
  236. package/scripts/check-platform-ratchets.mjs +297 -0
  237. package/scripts/check-shards.d.mts +5 -0
  238. package/scripts/check-shards.mjs +101 -0
  239. package/scripts/check-sim-players.mjs +82 -0
  240. package/scripts/check-spelled-paths.d.mts +1 -0
  241. package/scripts/check-spelled-paths.mjs +34 -0
  242. package/scripts/chromium-keychain-check.mjs +140 -0
  243. package/scripts/chromium-keychain.d.mts +1 -0
  244. package/scripts/chromium-keychain.mjs +5 -0
  245. package/scripts/chromium-memory-browser.d.mts +4 -0
  246. package/scripts/chromium-memory-browser.mjs +52 -0
  247. package/scripts/ci-bisect.py +91 -0
  248. package/scripts/ci-browser.sh +45 -0
  249. package/scripts/ci-checks.d.mts +2 -0
  250. package/scripts/ci-checks.mjs +94 -0
  251. package/scripts/ci-disk-census.py +58 -0
  252. package/scripts/ci-docs-proof.mjs +84 -0
  253. package/scripts/ci-exact-reuse.d.mts +3 -0
  254. package/scripts/ci-exact-reuse.mjs +73 -0
  255. package/scripts/ci-generated-manifest.sh +18 -0
  256. package/scripts/ci-native-fixtures.mjs +36 -0
  257. package/scripts/ci-pack.d.mts +14 -0
  258. package/scripts/ci-pack.mjs +231 -0
  259. package/scripts/ci-playwright-install.sh +11 -0
  260. package/scripts/ci-product-cache.d.mts +2 -0
  261. package/scripts/ci-product-cache.mjs +57 -0
  262. package/scripts/ci-products.py +285 -0
  263. package/scripts/ci-proof-jobs.d.mts +3 -0
  264. package/scripts/ci-proof-jobs.mjs +34 -0
  265. package/scripts/ci-selection.mjs +63 -0
  266. package/scripts/ci-shard-wall-proof.mjs +26 -0
  267. package/scripts/ci-shard-wall.mjs +35 -0
  268. package/scripts/ci-static.sh +63 -0
  269. package/scripts/commit.sh +305 -0
  270. package/scripts/commit_lane.py +42 -0
  271. package/scripts/committed-fast-checks.mjs +262 -0
  272. package/scripts/committed-source-tables.mjs +47 -0
  273. package/scripts/compare-platform-steps.mjs +15 -0
  274. package/scripts/compiler-code.d.mts +3 -0
  275. package/scripts/compiler-code.mjs +69 -0
  276. package/scripts/complete-at-control-snapshot.mjs +297 -0
  277. package/scripts/complete-at-control.mjs +580 -0
  278. package/scripts/content-base-proof.mjs +158 -0
  279. package/scripts/content-sw-proof.mjs +215 -0
  280. package/scripts/cook-admission-proof.mjs +42 -0
  281. package/scripts/cook-audit.ts +57 -0
  282. package/scripts/cook-job.mjs +32 -0
  283. package/scripts/cook-parts-report.mjs +34 -0
  284. package/scripts/cook-revision.ts +60 -0
  285. package/scripts/cook-to-play.mjs +96 -0
  286. package/scripts/cook-worker.mjs +78 -0
  287. package/scripts/cook-worker.service +5 -0
  288. package/scripts/cook.mjs +19 -0
  289. package/scripts/core-heap-diagnostic.d.mts +21 -0
  290. package/scripts/core-heap-diagnostic.mjs +52 -0
  291. package/scripts/cpu-admission-proof.mjs +55 -0
  292. package/scripts/cpu-admission.mjs +32 -0
  293. package/scripts/cpu-admission.py +243 -0
  294. package/scripts/cpu-broker-proof.mjs +96 -0
  295. package/scripts/cpu-broker.mjs +56 -0
  296. package/scripts/cpu-broker.py +119 -0
  297. package/scripts/cpu-census-proof.py +193 -0
  298. package/scripts/cpu-census.py +374 -0
  299. package/scripts/crossroads-proof.mjs +32 -0
  300. package/scripts/crossroads-rig/core.d.ts +16 -0
  301. package/scripts/crossroads-rig/core.js +417 -0
  302. package/scripts/crossroads-rig/desktop-probe.mjs +163 -0
  303. package/scripts/crossroads-rig/index.html +21 -0
  304. package/scripts/crossroads-rig/phone.js +74 -0
  305. package/scripts/crossroads-rig/production-probe.mjs +160 -0
  306. package/scripts/crossroads-rig/production.html +23 -0
  307. package/scripts/crossroads-rig/production.md +28 -0
  308. package/scripts/crossroads-rig/rig.js +36 -0
  309. package/scripts/crossroads-rig/sim-probe.mjs +217 -0
  310. package/scripts/crossroads-rig/stage.sh +11 -0
  311. package/scripts/crossroads-smoke.mjs +83 -0
  312. package/scripts/debug-settings.d.mts +24 -0
  313. package/scripts/debug-settings.mjs +80 -0
  314. package/scripts/decision-legacy-lines.d.mts +4 -0
  315. package/scripts/decision-legacy-lines.mjs +30 -0
  316. package/scripts/deck-skip-proof.mjs +63 -0
  317. package/scripts/deny-browser.mjs +11 -0
  318. package/scripts/docs-inputs-proof.mjs +31 -0
  319. package/scripts/doctor-proof.mjs +186 -0
  320. package/scripts/dome-cameras.d.mts +27 -0
  321. package/scripts/dome-cameras.mjs +77 -0
  322. package/scripts/download-bench/link.mjs +101 -0
  323. package/scripts/e2e-client.mjs +153 -0
  324. package/scripts/e2e-offline.sh +9 -0
  325. package/scripts/e2e-paths.mjs +31 -0
  326. package/scripts/e2e-watcher.mjs +191 -0
  327. package/scripts/e7-doctor-proof.mjs +61 -0
  328. package/scripts/e7-doctor-request-proof.mjs +179 -0
  329. package/scripts/e7-doctor-worker-proof.mjs +221 -0
  330. package/scripts/e7-live-staging-proof.mjs +72 -0
  331. package/scripts/e7-playtest-table.mjs +67 -0
  332. package/scripts/e7-records-proof.mjs +17 -0
  333. package/scripts/e7-voice-staging-proof.mjs +94 -0
  334. package/scripts/engine-ci-budget.ts +39 -0
  335. package/scripts/engine-ci-membership-proof.ts +26 -0
  336. package/scripts/engine-ci-plan.ts +120 -0
  337. package/scripts/engine-ci-proof.mjs +41 -0
  338. package/scripts/engine-ci-sequencer.ts +18 -0
  339. package/scripts/engine-ci-shard.mjs +28 -0
  340. package/scripts/engine-ci.config.ts +17 -0
  341. package/scripts/engine-order-proof.mjs +41 -0
  342. package/scripts/environment-boundary-proof.mjs +28 -0
  343. package/scripts/fetch-assets.mjs +76 -0
  344. package/scripts/format-hook.mjs +20 -0
  345. package/scripts/format-lock.d.mts +6 -0
  346. package/scripts/format-lock.mjs +120 -0
  347. package/scripts/format-package.d.mts +4 -0
  348. package/scripts/format-package.mjs +12 -0
  349. package/scripts/frame-cost-report.ts +85 -0
  350. package/scripts/frame-floor-args.d.mts +14 -0
  351. package/scripts/frame-floor-args.mjs +156 -0
  352. package/scripts/frame-floor-buffer-pressure.d.mts +3 -0
  353. package/scripts/frame-floor-buffer-pressure.mjs +91 -0
  354. package/scripts/frame-floor-draw-report.d.mts +38 -0
  355. package/scripts/frame-floor-draw-report.mjs +112 -0
  356. package/scripts/frame-floor-gl-time.d.mts +4 -0
  357. package/scripts/frame-floor-gl-time.mjs +104 -0
  358. package/scripts/frame-floor-gpu-bisect.mjs +120 -0
  359. package/scripts/frame-floor-grid.d.mts +67 -0
  360. package/scripts/frame-floor-grid.mjs +552 -0
  361. package/scripts/frame-floor-inventory.d.mts +2 -0
  362. package/scripts/frame-floor-inventory.mjs +10 -0
  363. package/scripts/frame-floor-jsc-gc.d.mts +15 -0
  364. package/scripts/frame-floor-jsc-gc.mjs +122 -0
  365. package/scripts/frame-floor-native-pressure.d.mts +4 -0
  366. package/scripts/frame-floor-native-pressure.mjs +78 -0
  367. package/scripts/frame-floor-native.mjs +108 -0
  368. package/scripts/frame-floor-navigation.d.mts +12 -0
  369. package/scripts/frame-floor-navigation.mjs +41 -0
  370. package/scripts/frame-floor-pause-ablation.d.mts +15 -0
  371. package/scripts/frame-floor-pause-ablation.mjs +90 -0
  372. package/scripts/frame-floor-pending.d.mts +16 -0
  373. package/scripts/frame-floor-pending.mjs +29 -0
  374. package/scripts/frame-floor-programs.mjs +39 -0
  375. package/scripts/frame-floor-report-phase.d.mts +10 -0
  376. package/scripts/frame-floor-report-phase.mjs +41 -0
  377. package/scripts/frame-floor-script-profile.d.mts +20 -0
  378. package/scripts/frame-floor-script-profile.mjs +159 -0
  379. package/scripts/frame-floor-settings.d.mts +6 -0
  380. package/scripts/frame-floor-settings.mjs +118 -0
  381. package/scripts/frame-floor-standing.d.mts +4 -0
  382. package/scripts/frame-floor-standing.mjs +20 -0
  383. package/scripts/frame-floor-task-clock.d.mts +4 -0
  384. package/scripts/frame-floor-task-clock.mjs +284 -0
  385. package/scripts/frame-floor-timeline-session.ts +76 -0
  386. package/scripts/frame-floor-wasm-constructors.d.mts +6 -0
  387. package/scripts/frame-floor-wasm-constructors.mjs +37 -0
  388. package/scripts/frame-floor-wasm-probe.d.mts +2 -0
  389. package/scripts/frame-floor-wasm-probe.mjs +51 -0
  390. package/scripts/frame-floor-webkit-timeline.d.mts +26 -0
  391. package/scripts/frame-floor-webkit-timeline.mjs +285 -0
  392. package/scripts/frame-floor.mjs +1290 -0
  393. package/scripts/full-test-log-proof.py +191 -0
  394. package/scripts/full-test-report.py +154 -0
  395. package/scripts/function-source.d.mts +3 -0
  396. package/scripts/function-source.mjs +48 -0
  397. package/scripts/g571-hosts.d.mts +3 -0
  398. package/scripts/g571-hosts.mjs +54 -0
  399. package/scripts/game-plugins.d.mts +22 -0
  400. package/scripts/gate-related-tests.d.mts +7 -0
  401. package/scripts/gate-related-tests.mjs +178 -0
  402. package/scripts/gen-api.d.mts +10 -0
  403. package/scripts/gen-api.mjs +134 -0
  404. package/scripts/gen-boot-cache.d.mts +2 -0
  405. package/scripts/gen-boot-cache.mjs +146 -0
  406. package/scripts/gen-budget-derivations.d.mts +1 -0
  407. package/scripts/gen-budget-derivations.mjs +43 -0
  408. package/scripts/gen-programs.d.mts +8 -0
  409. package/scripts/gen-programs.mjs +82 -0
  410. package/scripts/gen-shard-words.d.mts +4 -0
  411. package/scripts/gen-shard-words.mjs +188 -0
  412. package/scripts/gen-source.d.mts +4 -0
  413. package/scripts/gen-source.mjs +73 -0
  414. package/scripts/gen-starter-arm-clips.d.mts +4 -0
  415. package/scripts/gen-starter-arm-clips.mjs +17 -0
  416. package/scripts/gen-starter-bag.d.mts +4 -0
  417. package/scripts/gen-starter-bag.mjs +16 -0
  418. package/scripts/gen-starter-effects.d.mts +4 -0
  419. package/scripts/gen-starter-effects.mjs +16 -0
  420. package/scripts/gen-starter-weapons.d.mts +4 -0
  421. package/scripts/gen-starter-weapons.mjs +16 -0
  422. package/scripts/gen.mjs +6 -0
  423. package/scripts/generate-title-launch.mjs +55 -0
  424. package/scripts/generated-files.d.mts +6 -0
  425. package/scripts/generated-files.mjs +86 -0
  426. package/scripts/generated-input-reading.d.mts +3 -0
  427. package/scripts/generated-input-reading.mjs +89 -0
  428. package/scripts/generated-policy.d.mts +13 -0
  429. package/scripts/generated-policy.mjs +113 -0
  430. package/scripts/generated-source.d.mts +11 -0
  431. package/scripts/generated-source.mjs +214 -0
  432. package/scripts/generation-cache-prune.d.mts +10 -0
  433. package/scripts/generation-cache-prune.mjs +128 -0
  434. package/scripts/gfx-toggle/compare.mjs +133 -0
  435. package/scripts/git-common.d.mts +1 -0
  436. package/scripts/git-common.mjs +13 -0
  437. package/scripts/git-rule-counts.mjs +16 -0
  438. package/scripts/git-source-view.mjs +225 -0
  439. package/scripts/goldens/board.py +176 -0
  440. package/scripts/goldens/capture-inputs.d.mts +4 -0
  441. package/scripts/goldens/capture-inputs.mjs +35 -0
  442. package/scripts/goldens/capture.mjs +214 -0
  443. package/scripts/goldens/colour_shift.py +27 -0
  444. package/scripts/goldens/native-residency.d.mts +10 -0
  445. package/scripts/goldens/native-residency.mjs +104 -0
  446. package/scripts/goldens/plot-inputs.d.mts +12 -0
  447. package/scripts/goldens/plot-inputs.mjs +46 -0
  448. package/scripts/gpu-gate/matrix.d.mts +3 -0
  449. package/scripts/gpu-gate/matrix.mjs +48 -0
  450. package/scripts/gpu-gate/probe.mjs +30 -0
  451. package/scripts/gpu-gate/status.d.mts +4 -0
  452. package/scripts/gpu-gate/status.mjs +112 -0
  453. package/scripts/gpu-perf/com.wildshard.gpu-perf.plist +11 -0
  454. package/scripts/gpu-perf/install.sh +31 -0
  455. package/scripts/gpu-perf/nightly.mjs +216 -0
  456. package/scripts/gpu-perf/nightly.sh +7 -0
  457. package/scripts/gpu-perf/report.d.mts +18 -0
  458. package/scripts/gpu-perf/report.mjs +109 -0
  459. package/scripts/gpu-perf/timing.sh +17 -0
  460. package/scripts/gpu-trace-frames.mjs +113 -0
  461. package/scripts/grid-crossing-walk-proof.mjs +172 -0
  462. package/scripts/grid-gate-proof.mjs +126 -0
  463. package/scripts/grid-ready-latches.d.mts +7 -0
  464. package/scripts/grid-ready-latches.mjs +44 -0
  465. package/scripts/grid-ready-memory.d.mts +3 -0
  466. package/scripts/grid-ready-memory.mjs +86 -0
  467. package/scripts/grid-runtime-evidence.d.mts +4 -0
  468. package/scripts/grid-runtime-evidence.mjs +107 -0
  469. package/scripts/grid-spawn-proof.mjs +317 -0
  470. package/scripts/guard-counts.d.mts +8 -0
  471. package/scripts/guard-counts.mjs +136 -0
  472. package/scripts/guard-index-tree.d.mts +2 -0
  473. package/scripts/guard-index-tree.mjs +19 -0
  474. package/scripts/heavy-lane-lease.d.mts +2 -0
  475. package/scripts/heavy-lane-lease.mjs +33 -0
  476. package/scripts/heavy-lane.py +652 -0
  477. package/scripts/herdr-prompt.sh +13 -0
  478. package/scripts/herdr-question-open.sh +22 -0
  479. package/scripts/hero-shots.mjs +168 -0
  480. package/scripts/home-icons.mjs +27 -0
  481. package/scripts/host-activity.ts +41 -0
  482. package/scripts/hud-worst/chat.ts +33 -0
  483. package/scripts/hud-worst.mjs +344 -0
  484. package/scripts/inbox-pull.mjs +129 -0
  485. package/scripts/inline-shell-css.mjs +30 -0
  486. package/scripts/input-hash-memo.d.mts +16 -0
  487. package/scripts/input-hash-memo.mjs +109 -0
  488. package/scripts/input-snapshot.d.mts +2 -0
  489. package/scripts/input-snapshot.mjs +45 -0
  490. package/scripts/ios-memory-watchdog.py +339 -0
  491. package/scripts/iphone-mem-reading.sh +40 -0
  492. package/scripts/js-entry-census.mjs +54 -0
  493. package/scripts/js-payload-heap.mjs +23 -0
  494. package/scripts/json-declarations.d.mts +3 -0
  495. package/scripts/json-declarations.mjs +101 -0
  496. package/scripts/json-output-guard.d.mts +6 -0
  497. package/scripts/json-output-guard.mjs +50 -0
  498. package/scripts/ktx2-engine-map.json +156 -0
  499. package/scripts/ktx2-tables.d.mts +5 -0
  500. package/scripts/ktx2-tables.mjs +103 -0
  501. package/scripts/land.d.mts +17 -0
  502. package/scripts/land.mjs +888 -0
  503. package/scripts/lane-watchdog.d.mts +11 -0
  504. package/scripts/lane-watchdog.mjs +256 -0
  505. package/scripts/latch-grid-evidence.d.mts +1 -0
  506. package/scripts/latch-grid-evidence.mjs +68 -0
  507. package/scripts/lift-pending-batches-proof.mjs +135 -0
  508. package/scripts/lift-pending-batches.mjs +124 -0
  509. package/scripts/lift-pending-history-proof.mjs +41 -0
  510. package/scripts/lift-pending-proof.mjs +27 -0
  511. package/scripts/lift-pending-schedule.mjs +23 -0
  512. package/scripts/lift-pending.d.mts +1 -0
  513. package/scripts/lift-pending.mjs +78 -0
  514. package/scripts/link-node-modules.d.mts +1 -0
  515. package/scripts/link-node-modules.mjs +291 -0
  516. package/scripts/lint-all.mjs +50 -0
  517. package/scripts/lint-cli.mjs +10 -0
  518. package/scripts/lint-fast.mjs +30 -0
  519. package/scripts/lint-game-selection-proof.mjs +27 -0
  520. package/scripts/lint-game.mjs +26 -0
  521. package/scripts/lint-tools.d.mts +4 -0
  522. package/scripts/lint-tools.mjs +28 -0
  523. package/scripts/listed-view-code.d.mts +7 -0
  524. package/scripts/listed-view-code.mjs +93 -0
  525. package/scripts/live-prepush.py +352 -0
  526. package/scripts/load-mem-probe.mjs +248 -0
  527. package/scripts/loading-bar-rule.mjs +107 -0
  528. package/scripts/loading-benchmark/accuracy-data.d.mts +12 -0
  529. package/scripts/loading-benchmark/accuracy-data.mjs +92 -0
  530. package/scripts/loading-benchmark/cache-bodies.d.mts +14 -0
  531. package/scripts/loading-benchmark/cache-bodies.mjs +103 -0
  532. package/scripts/loading-benchmark/catalogue.d.mts +8 -0
  533. package/scripts/loading-benchmark/catalogue.mjs +41 -0
  534. package/scripts/loading-benchmark/sim-shard.d.mts +60 -0
  535. package/scripts/loading-benchmark/sim-shard.mjs +289 -0
  536. package/scripts/loading-benchmark/transport.d.mts +9 -0
  537. package/scripts/loading-benchmark/transport.mjs +109 -0
  538. package/scripts/loading-card-proof.mjs +298 -0
  539. package/scripts/loading-fence-proof.mjs +67 -0
  540. package/scripts/loading-flow/analyse.mjs +280 -0
  541. package/scripts/loading-flow/benchmax.mjs +179 -0
  542. package/scripts/loading-flow/board.py +104 -0
  543. package/scripts/loading-flow/drive.mjs +283 -0
  544. package/scripts/loading-flow/layer-parity-proof.mjs +69 -0
  545. package/scripts/loading-flow/link-probe.mjs +99 -0
  546. package/scripts/loading-flow/profile.mjs +54 -0
  547. package/scripts/loading-flow/run.sh +51 -0
  548. package/scripts/loading-flow/source-maps-proof.mjs +86 -0
  549. package/scripts/loading-flow/source-maps.mjs +73 -0
  550. package/scripts/loading-flow/stalls.d.mts +39 -0
  551. package/scripts/loading-flow/stalls.mjs +141 -0
  552. package/scripts/loading-flow/sweep-input-proof.mjs +127 -0
  553. package/scripts/loading-flow/sweep-input.mjs +70 -0
  554. package/scripts/loading-flow/sweep-report.mjs +112 -0
  555. package/scripts/loading-flow/sweep.sh +101 -0
  556. package/scripts/loading-flow/target-proof.mjs +56 -0
  557. package/scripts/loading-flow/target.mjs +39 -0
  558. package/scripts/loading-time-left-proof.mjs +121 -0
  559. package/scripts/loading-time-left-rule.mjs +49 -0
  560. package/scripts/look-loop/cameras.d.mts +18 -0
  561. package/scripts/look-loop/cameras.mjs +109 -0
  562. package/scripts/look-loop/fit-lut.py +142 -0
  563. package/scripts/look-loop/palette-delta.py +183 -0
  564. package/scripts/look-loop/regions/driftwood-isle.json +25 -0
  565. package/scripts/look-loop/regions/far-reach.json +225 -0
  566. package/scripts/look-loop/regions/open-plot-night-market.json +855 -0
  567. package/scripts/look-loop/regions/pine-hollow.json +22 -0
  568. package/scripts/look-loop/regions/sunscar-dunes.json +281 -0
  569. package/scripts/look-loop/targets.py +229 -0
  570. package/scripts/look-loop/test_look_loop.py +133 -0
  571. package/scripts/look-loop/views.mjs +176 -0
  572. package/scripts/main-menu-aerial-plan.mjs +8 -0
  573. package/scripts/main-menu-aerial-poses.ts +292 -0
  574. package/scripts/main-pull.mjs +84 -0
  575. package/scripts/main-watch.d.mts +19 -0
  576. package/scripts/main-watch.mjs +248 -0
  577. package/scripts/manifest-art-inputs.json +4 -0
  578. package/scripts/manifest-budget.mjs +44 -0
  579. package/scripts/manifest-declaration.d.mts +3 -0
  580. package/scripts/manifest-declaration.mjs +40 -0
  581. package/scripts/manifest-spawns.mjs +38 -0
  582. package/scripts/manifest-static-imports.d.mts +2 -0
  583. package/scripts/manifest-static-imports.mjs +83 -0
  584. package/scripts/map-hash.d.mts +20 -0
  585. package/scripts/map-hash.mjs +155 -0
  586. package/scripts/map-painter.d.mts +13 -0
  587. package/scripts/map-painter.mjs +97 -0
  588. package/scripts/map-stylize.py +241 -0
  589. package/scripts/memory/cpuOwners.d.mts +4 -0
  590. package/scripts/memory/cpuOwners.mjs +51 -0
  591. package/scripts/memory/heapReader.d.mts +3 -0
  592. package/scripts/memory/heapReader.mjs +59 -0
  593. package/scripts/memory/js-heap-ratchet.json +17 -0
  594. package/scripts/memory/jsHeap.d.mts +6 -0
  595. package/scripts/memory/jsHeap.mjs +52 -0
  596. package/scripts/memory-report-blocks.d.mts +28 -0
  597. package/scripts/memory-report-blocks.mjs +60 -0
  598. package/scripts/memory-report-data.d.mts +25 -0
  599. package/scripts/memory-report-data.mjs +222 -0
  600. package/scripts/memory-report-graphic.d.mts +5 -0
  601. package/scripts/memory-report-graphic.mjs +90 -0
  602. package/scripts/memory-report-snapshot.d.mts +4 -0
  603. package/scripts/memory-report-snapshot.mjs +13 -0
  604. package/scripts/memory-report.d.mts +5 -0
  605. package/scripts/memory-report.mjs +94 -0
  606. package/scripts/mmo-bots.mjs +241 -0
  607. package/scripts/mobile-graphics-proof.mjs +120 -0
  608. package/scripts/model-spin-recording.d.mts +4 -0
  609. package/scripts/model-spin-recording.mjs +25 -0
  610. package/scripts/model-spin.mjs +327 -0
  611. package/scripts/module-cache-proof.mjs +43 -0
  612. package/scripts/name-prompt-proof.mjs +136 -0
  613. package/scripts/native-recorder-cache.d.mts +33 -0
  614. package/scripts/native-recorder-cache.mjs +287 -0
  615. package/scripts/native-retention-proof.mjs +79 -0
  616. package/scripts/night-market-kit-budget.d.mts +12 -0
  617. package/scripts/night-market-kit-budget.mjs +80 -0
  618. package/scripts/nightly-heads.ts +176 -0
  619. package/scripts/nightly-model.ts +127 -0
  620. package/scripts/nightly-tag.d.mts +1 -0
  621. package/scripts/nightly-tag.mjs +32 -0
  622. package/scripts/nightly.proof.ts +105 -0
  623. package/scripts/nightly.ts +43 -0
  624. package/scripts/nine-sim-memory.mjs +353 -0
  625. package/scripts/no-binary-json.d.mts +12 -0
  626. package/scripts/no-binary-json.mjs +270 -0
  627. package/scripts/non-engine-admission-proof.mjs +27 -0
  628. package/scripts/number-path-probe.d.mts +7 -0
  629. package/scripts/number-path-probe.mjs +57 -0
  630. package/scripts/offline-proof-rules.d.mts +23 -0
  631. package/scripts/offline-proof-rules.mjs +123 -0
  632. package/scripts/offline-proof.mjs +498 -0
  633. package/scripts/online-phone-proof.mjs +330 -0
  634. package/scripts/online-proof.mjs +150 -0
  635. package/scripts/online-ride-proof.mjs +74 -0
  636. package/scripts/online-rig.mjs +114 -0
  637. package/scripts/page-parity.mjs +99 -0
  638. package/scripts/page-release/content.d.mts +30 -0
  639. package/scripts/page-release/content.mjs +299 -0
  640. package/scripts/page-release/flow.d.mts +60 -0
  641. package/scripts/page-release/flow.mjs +365 -0
  642. package/scripts/page-release/hosts/workers.d.mts +8 -0
  643. package/scripts/page-release/hosts/workers.mjs +160 -0
  644. package/scripts/page-release/packs.mjs +108 -0
  645. package/scripts/page-release/redact.d.mts +1 -0
  646. package/scripts/page-release/redact.mjs +19 -0
  647. package/scripts/page-release.mjs +101 -0
  648. package/scripts/page-size.d.mts +13 -0
  649. package/scripts/page-size.mjs +198 -0
  650. package/scripts/parallel-fast-lint.d.mts +1 -0
  651. package/scripts/parallel-fast-lint.mjs +54 -0
  652. package/scripts/parity/audio-diagnostics.d.mts +5 -0
  653. package/scripts/parity/audio-diagnostics.mjs +63 -0
  654. package/scripts/parity/audio-settle.mjs +111 -0
  655. package/scripts/parity/black-frame.d.mts +11 -0
  656. package/scripts/parity/black-frame.mjs +58 -0
  657. package/scripts/parity/boot-smoke.d.mts +47 -0
  658. package/scripts/parity/boot-smoke.mjs +585 -0
  659. package/scripts/parity/boot-timing-delay.mjs +54 -0
  660. package/scripts/parity/browser-escape.d.mts +2 -0
  661. package/scripts/parity/browser-escape.mjs +50 -0
  662. package/scripts/parity/budgetCeilings.d.mts +3 -0
  663. package/scripts/parity/budgetCeilings.mjs +30 -0
  664. package/scripts/parity/budgets.d.mts +7 -0
  665. package/scripts/parity/budgets.mjs +73 -0
  666. package/scripts/parity/cache.d.mts +1 -0
  667. package/scripts/parity/cache.mjs +40 -0
  668. package/scripts/parity/canvas-bytes.d.mts +13 -0
  669. package/scripts/parity/canvas-bytes.mjs +96 -0
  670. package/scripts/parity/capture-rpc.d.mts +2 -0
  671. package/scripts/parity/capture-rpc.mjs +41 -0
  672. package/scripts/parity/capture-trace.d.mts +6 -0
  673. package/scripts/parity/capture-trace.mjs +63 -0
  674. package/scripts/parity/clock.d.mts +1 -0
  675. package/scripts/parity/clock.mjs +89 -0
  676. package/scripts/parity/combat.d.mts +14 -0
  677. package/scripts/parity/combat.mjs +81 -0
  678. package/scripts/parity/compare.d.mts +10 -0
  679. package/scripts/parity/compare.mjs +177 -0
  680. package/scripts/parity/explorer-smoke.d.mts +21 -0
  681. package/scripts/parity/explorer-smoke.mjs +310 -0
  682. package/scripts/parity/fast-png.d.mts +18 -0
  683. package/scripts/parity/fast-png.mjs +68 -0
  684. package/scripts/parity/fingerprint.mjs +8 -0
  685. package/scripts/parity/fixed-render.d.mts +11 -0
  686. package/scripts/parity/fixed-render.mjs +79 -0
  687. package/scripts/parity/frame-budget.d.mts +3 -0
  688. package/scripts/parity/frame-budget.mjs +39 -0
  689. package/scripts/parity/frame-bytes.d.mts +8 -0
  690. package/scripts/parity/frame-bytes.mjs +45 -0
  691. package/scripts/parity/frames.mjs +8 -0
  692. package/scripts/parity/glbytes.d.mts +8 -0
  693. package/scripts/parity/glbytes.mjs +148 -0
  694. package/scripts/parity/grid-boot-waits.d.mts +13 -0
  695. package/scripts/parity/grid-boot-waits.mjs +43 -0
  696. package/scripts/parity/heat-bytes.d.mts +5 -0
  697. package/scripts/parity/heat-bytes.mjs +32 -0
  698. package/scripts/parity/hover-touch.mjs +153 -0
  699. package/scripts/parity/hud.d.mts +4 -0
  700. package/scripts/parity/hud.mjs +17 -0
  701. package/scripts/parity/image-routes.d.mts +5 -0
  702. package/scripts/parity/image-routes.mjs +29 -0
  703. package/scripts/parity/init.d.mts +15 -0
  704. package/scripts/parity/init.mjs +63 -0
  705. package/scripts/parity/lane-browser.mjs +14 -0
  706. package/scripts/parity/offline.d.mts +5 -0
  707. package/scripts/parity/offline.mjs +24 -0
  708. package/scripts/parity/phone-route-browser.d.mts +20 -0
  709. package/scripts/parity/phone-route-browser.mjs +241 -0
  710. package/scripts/parity/phone-route-page.d.mts +10 -0
  711. package/scripts/parity/phone-route-page.mjs +245 -0
  712. package/scripts/parity/phone-route-runner.d.mts +2 -0
  713. package/scripts/parity/phone-route-runner.mjs +39 -0
  714. package/scripts/parity/phone-route.d.mts +43 -0
  715. package/scripts/parity/phone-route.mjs +212 -0
  716. package/scripts/parity/pool.d.mts +4 -0
  717. package/scripts/parity/pool.mjs +74 -0
  718. package/scripts/parity/poses.d.mts +6 -0
  719. package/scripts/parity/poses.mjs +57 -0
  720. package/scripts/parity/probe.d.mts +2 -0
  721. package/scripts/parity/probe.mjs +13 -0
  722. package/scripts/parity/profile.d.mts +2 -0
  723. package/scripts/parity/profile.mjs +52 -0
  724. package/scripts/parity/record.d.mts +8 -0
  725. package/scripts/parity/record.mjs +102 -0
  726. package/scripts/parity/resources.mjs +58 -0
  727. package/scripts/parity/saves.d.mts +1 -0
  728. package/scripts/parity/saves.mjs +14 -0
  729. package/scripts/parity/serve.d.mts +9 -0
  730. package/scripts/parity/serve.mjs +125 -0
  731. package/scripts/parity/shader-code.d.mts +2 -0
  732. package/scripts/parity/shader-code.mjs +10 -0
  733. package/scripts/parity/ssim.d.mts +4 -0
  734. package/scripts/parity/ssim.mjs +44 -0
  735. package/scripts/parity/telemetry.d.mts +1 -0
  736. package/scripts/parity/telemetry.mjs +19 -0
  737. package/scripts/parity/timeout.mjs +7 -0
  738. package/scripts/parity/title-trace.d.mts +13 -0
  739. package/scripts/parity/title-trace.mjs +59 -0
  740. package/scripts/parity/value.d.mts +11 -0
  741. package/scripts/parity/value.mjs +50 -0
  742. package/scripts/parity/walk.d.mts +10 -0
  743. package/scripts/parity/walk.mjs +109 -0
  744. package/scripts/parity.mjs +310 -0
  745. package/scripts/perf/README.md +47 -0
  746. package/scripts/perf/cameras24.json +2963 -0
  747. package/scripts/perf/draw-census-page.d.mts +10 -0
  748. package/scripts/perf/draw-census-page.mjs +162 -0
  749. package/scripts/perf/draw-census-poses.d.mts +14 -0
  750. package/scripts/perf/draw-census-poses.mjs +44 -0
  751. package/scripts/perf/draw-census-report.d.mts +24 -0
  752. package/scripts/perf/draw-census-report.mjs +86 -0
  753. package/scripts/perf/draw-census.mjs +156 -0
  754. package/scripts/perf/exact-world-capture.mjs +167 -0
  755. package/scripts/perf/gpu-census-coverage.d.mts +6 -0
  756. package/scripts/perf/gpu-census-coverage.mjs +47 -0
  757. package/scripts/perf/gpu-census-overdraw.mjs +105 -0
  758. package/scripts/perf/gpu-census-page.d.mts +11 -0
  759. package/scripts/perf/gpu-census-page.mjs +53 -0
  760. package/scripts/perf/gpu-census-report.d.mts +3 -0
  761. package/scripts/perf/gpu-census-report.mjs +15 -0
  762. package/scripts/perf/gpu-census.d.mts +6 -0
  763. package/scripts/perf/gpu-census.mjs +95 -0
  764. package/scripts/perf/material-program-loan.d.mts +18 -0
  765. package/scripts/perf/material-program-loan.mjs +88 -0
  766. package/scripts/perf/world-pixel-difference.d.mts +5 -0
  767. package/scripts/perf/world-pixel-difference.mjs +22 -0
  768. package/scripts/phone-loading/chromium.ts +113 -0
  769. package/scripts/phone-loading/cpu-profile.ts +47 -0
  770. package/scripts/phone-loading/fixtures.ts +18 -0
  771. package/scripts/phone-loading/instrument.ts +219 -0
  772. package/scripts/phone-loading/link.ts +115 -0
  773. package/scripts/phone-loading/main.ts +261 -0
  774. package/scripts/phone-loading/model.ts +123 -0
  775. package/scripts/phone-loading/native-body.ts +40 -0
  776. package/scripts/phone-loading/native-sizes.ts +194 -0
  777. package/scripts/phone-loading/network.ts +167 -0
  778. package/scripts/phone-loading/play.ts +132 -0
  779. package/scripts/phone-loading/post-control.ts +22 -0
  780. package/scripts/phone-loading/recording.ts +28 -0
  781. package/scripts/phone-loading/shaped-preview.ts +37 -0
  782. package/scripts/phone-loading/tsconfig.json +11 -0
  783. package/scripts/physics-baseline.mjs +433 -0
  784. package/scripts/physics-grid-entry.d.mts +15 -0
  785. package/scripts/physics-grid-entry.mjs +62 -0
  786. package/scripts/physics-grid.d.mts +10 -0
  787. package/scripts/physics-grid.mjs +102 -0
  788. package/scripts/physics-native.d.mts +6 -0
  789. package/scripts/physics-native.mjs +81 -0
  790. package/scripts/physics-route.json +4400 -0
  791. package/scripts/physics-walk.d.mts +16 -0
  792. package/scripts/physics-walk.mjs +79 -0
  793. package/scripts/pid-lock.d.mts +1 -0
  794. package/scripts/pid-lock.mjs +63 -0
  795. package/scripts/pin-assets.ts +94 -0
  796. package/scripts/pin-format.ts +43 -0
  797. package/scripts/pin-packs.ts +17 -0
  798. package/scripts/pins-exclude.d.mts +3 -0
  799. package/scripts/pins-exclude.mjs +54 -0
  800. package/scripts/pins-reuse.d.mts +27 -0
  801. package/scripts/pins-reuse.mjs +321 -0
  802. package/scripts/pins.ts +468 -0
  803. package/scripts/platform-chargebacks.d.mts +9 -0
  804. package/scripts/platform-chargebacks.mjs +135 -0
  805. package/scripts/playground-grapple.mjs +154 -0
  806. package/scripts/playground-harness.mjs +137 -0
  807. package/scripts/playground-horse.mjs +106 -0
  808. package/scripts/prebuilt-output.py +322 -0
  809. package/scripts/precommit-checks.d.mts +3 -0
  810. package/scripts/precommit-checks.mjs +115 -0
  811. package/scripts/precommit-inputs.d.mts +5 -0
  812. package/scripts/precommit-inputs.mjs +73 -0
  813. package/scripts/precommit-jobs.d.mts +5 -0
  814. package/scripts/precommit-jobs.mjs +85 -0
  815. package/scripts/precommit-source.py +493 -0
  816. package/scripts/preparation-cache-key.d.mts +2 -0
  817. package/scripts/preparation-cache-key.mjs +70 -0
  818. package/scripts/prepush-proof.mjs +36 -0
  819. package/scripts/preview-encoded-cache.d.mts +7 -0
  820. package/scripts/preview-encoded-cache.mjs +64 -0
  821. package/scripts/preview-lag.mjs +80 -0
  822. package/scripts/preview-server.mjs +256 -0
  823. package/scripts/preview-telemetry.d.mts +4 -0
  824. package/scripts/preview-telemetry.mjs +56 -0
  825. package/scripts/product-build-times.d.mts +3 -0
  826. package/scripts/product-build-times.mjs +42 -0
  827. package/scripts/program-discovery.d.mts +5 -0
  828. package/scripts/program-discovery.mjs +42 -0
  829. package/scripts/progress-recording.d.mts +6 -0
  830. package/scripts/progress-recording.mjs +26 -0
  831. package/scripts/progress-video.sh +27 -0
  832. package/scripts/proof-run.sh +69 -0
  833. package/scripts/prune-local-caches.mjs +10 -0
  834. package/scripts/public-grid.d.mts +11 -0
  835. package/scripts/public-grid.mjs +56 -0
  836. package/scripts/push-budget.d.mts +3 -0
  837. package/scripts/push-budget.mjs +5 -0
  838. package/scripts/push-cache-git-proof.mjs +32 -0
  839. package/scripts/push-cache-lease-proof.mjs +22 -0
  840. package/scripts/push-cache-proof.mjs +29 -0
  841. package/scripts/push-checks.d.mts +2 -0
  842. package/scripts/push-checks.mjs +116 -0
  843. package/scripts/push-cohort-proof.mjs +15 -0
  844. package/scripts/push-dependencies.mjs +97 -0
  845. package/scripts/push-dependency-proof.mjs +53 -0
  846. package/scripts/push-duration-sequencer.ts +26 -0
  847. package/scripts/push-environment.mjs +21 -0
  848. package/scripts/push-exclusion-proof.mjs +81 -0
  849. package/scripts/push-gate-copy.mjs +168 -0
  850. package/scripts/push-inputs.d.mts +4 -0
  851. package/scripts/push-inputs.mjs +99 -0
  852. package/scripts/push-lint-config.d.mts +4 -0
  853. package/scripts/push-lint-config.mjs +26 -0
  854. package/scripts/push-local-split.d.mts +15 -0
  855. package/scripts/push-local-split.mjs +116 -0
  856. package/scripts/push-loop.py +317 -0
  857. package/scripts/push-proof-cache.mjs +131 -0
  858. package/scripts/push-ref-tree-proof.mjs +63 -0
  859. package/scripts/push-related.mjs +29 -0
  860. package/scripts/push-selection-dev-proof.mjs +57 -0
  861. package/scripts/push-selection-proof.mjs +45 -0
  862. package/scripts/push-selection.d.mts +2 -0
  863. package/scripts/push-selection.mjs +65 -0
  864. package/scripts/push-vitest.config.ts +20 -0
  865. package/scripts/push_input_cache.py +306 -0
  866. package/scripts/quarantine-placement-proof.mjs +28 -0
  867. package/scripts/quarantine-renewal-proof.mjs +34 -0
  868. package/scripts/quarantine-window-proof.mjs +26 -0
  869. package/scripts/quest-complete-proof.mjs +78 -0
  870. package/scripts/quiet-cli.mjs +13 -0
  871. package/scripts/quiet_logs.py +79 -0
  872. package/scripts/ratchet-approval.d.mts +3 -0
  873. package/scripts/ratchet-approval.mjs +70 -0
  874. package/scripts/record-fence-reads.mjs +115 -0
  875. package/scripts/release-check.mjs +22 -0
  876. package/scripts/release-proof-proof.mjs +71 -0
  877. package/scripts/reload-title-proof.mjs +100 -0
  878. package/scripts/remote-air-proof.mjs +137 -0
  879. package/scripts/remote-bar-proof.mjs +75 -0
  880. package/scripts/remote-board-proof.mjs +129 -0
  881. package/scripts/remote-body-proof.mjs +101 -0
  882. package/scripts/remote-death-proof.mjs +134 -0
  883. package/scripts/remote-gait-proof.mjs +139 -0
  884. package/scripts/remote-held-proof.mjs +155 -0
  885. package/scripts/remote-hurt-proof.mjs +121 -0
  886. package/scripts/remote-map-proof.mjs +103 -0
  887. package/scripts/remote-name-proof.mjs +123 -0
  888. package/scripts/remote-players-proof.mjs +214 -0
  889. package/scripts/remote-room.mjs +75 -0
  890. package/scripts/remote-strike-proof.mjs +148 -0
  891. package/scripts/renderer-revision-replay.mjs +49 -0
  892. package/scripts/renderer-revision.d.mts +12 -0
  893. package/scripts/renderer-revision.mjs +101 -0
  894. package/scripts/renderer-revision.proof.mjs +71 -0
  895. package/scripts/repo-size.d.mts +43 -0
  896. package/scripts/repo-size.mjs +540 -0
  897. package/scripts/ring-cook.mjs +51 -0
  898. package/scripts/ring-step.ts +112 -0
  899. package/scripts/ring1.sh +79 -0
  900. package/scripts/room-deploy.mjs +130 -0
  901. package/scripts/room-soak.mjs +40 -0
  902. package/scripts/runtime_input_copies.py +49 -0
  903. package/scripts/scorecard.mjs +1156 -0
  904. package/scripts/script-scenario-metrics.d.mts +10 -0
  905. package/scripts/script-scenario-metrics.mjs +75 -0
  906. package/scripts/section-types.d.mts +3 -0
  907. package/scripts/section-types.mjs +35 -0
  908. package/scripts/sentry-maps.d.mts +9 -0
  909. package/scripts/sentry-maps.mjs +94 -0
  910. package/scripts/serialize-asset-tables.mjs +13 -0
  911. package/scripts/serve-build.sh +392 -0
  912. package/scripts/serve-port-lease.py +100 -0
  913. package/scripts/serve-shared-preview.py +295 -0
  914. package/scripts/server-origin.mjs +10 -0
  915. package/scripts/server-release/github.mjs +142 -0
  916. package/scripts/server-release/publish.d.mts +19 -0
  917. package/scripts/server-release/publish.mjs +143 -0
  918. package/scripts/server-release/sign.d.mts +10 -0
  919. package/scripts/server-release/sign.mjs +75 -0
  920. package/scripts/shard-component-spans.d.mts +15 -0
  921. package/scripts/shard-component-spans.mjs +18 -0
  922. package/scripts/shard-components.d.mts +16 -0
  923. package/scripts/shard-components.mjs +365 -0
  924. package/scripts/shard-coupling.d.mts +11 -0
  925. package/scripts/shard-coupling.mjs +238 -0
  926. package/scripts/shard-folders.mjs +14 -0
  927. package/scripts/shard-net-lines.d.mts +13 -0
  928. package/scripts/shard-net-lines.mjs +62 -0
  929. package/scripts/shard-output-content.d.mts +4 -0
  930. package/scripts/shard-output-content.mjs +27 -0
  931. package/scripts/shard-outputs.d.mts +12 -0
  932. package/scripts/shard-outputs.mjs +64 -0
  933. package/scripts/shard-phone-memory.d.mts +37 -0
  934. package/scripts/shard-phone-memory.mjs +556 -0
  935. package/scripts/shard-platform-format.d.mts +10 -0
  936. package/scripts/shard-platform-format.mjs +7 -0
  937. package/scripts/shard-platform-hosts.d.mts +2 -0
  938. package/scripts/shard-platform-hosts.mjs +93 -0
  939. package/scripts/shard-platform-output.d.mts +12 -0
  940. package/scripts/shard-platform-output.mjs +74 -0
  941. package/scripts/shard-platform-sections.d.mts +2 -0
  942. package/scripts/shard-platform-sections.mjs +9 -0
  943. package/scripts/shard-platform.d.mts +76 -0
  944. package/scripts/shard-platform.mjs +1072 -0
  945. package/scripts/shard-public.d.mts +3 -0
  946. package/scripts/shard-public.mjs +36 -0
  947. package/scripts/shard-runtime-closure.d.mts +3 -0
  948. package/scripts/shard-runtime-closure.mjs +30 -0
  949. package/scripts/shard-size-gate.d.mts +13 -0
  950. package/scripts/shard-size-gate.mjs +135 -0
  951. package/scripts/shard-size-watch.d.mts +7 -0
  952. package/scripts/shard-size-watch.mjs +70 -0
  953. package/scripts/shard-wire-meter.mjs +107 -0
  954. package/scripts/shardfile-cache.d.mts +17 -0
  955. package/scripts/shardfile-cache.mjs +268 -0
  956. package/scripts/shardfile-inputs.d.mts +19 -0
  957. package/scripts/shardfile-inputs.mjs +452 -0
  958. package/scripts/shardfile-validation-revision.d.mts +1 -0
  959. package/scripts/shardfile-validation-revision.mjs +30 -0
  960. package/scripts/shards.d.mts +7 -0
  961. package/scripts/shards.mjs +16 -0
  962. package/scripts/side-parity.d.mts +8 -0
  963. package/scripts/side-parity.mjs +220 -0
  964. package/scripts/sim-boost-lap.mjs +198 -0
  965. package/scripts/sim-grid-entry.mjs +534 -0
  966. package/scripts/sim-in-runtime.d.mts +6 -0
  967. package/scripts/sim-in-runtime.mjs +146 -0
  968. package/scripts/sim-lane.sh +351 -0
  969. package/scripts/sim-mem-phases.py +195 -0
  970. package/scripts/sim-memory.mjs +414 -0
  971. package/scripts/sim-node-loader.mjs +37 -0
  972. package/scripts/sim-presentation-proof.py +37 -0
  973. package/scripts/sim-quiet.py +160 -0
  974. package/scripts/sim-safari-ready.py +896 -0
  975. package/scripts/sim-transport.c +93 -0
  976. package/scripts/slice-inputs.ts +31 -0
  977. package/scripts/smoke-timings.py +34 -0
  978. package/scripts/snapshot-admission-proof.mjs +55 -0
  979. package/scripts/soak/boundary.mjs +110 -0
  980. package/scripts/soak/inspector.d.mts +18 -0
  981. package/scripts/soak/inspector.mjs +74 -0
  982. package/scripts/soak/memory-categories.d.mts +12 -0
  983. package/scripts/soak/memory-categories.mjs +28 -0
  984. package/scripts/socket-smoke.mjs +20 -0
  985. package/scripts/sort-sides.d.mts +33 -0
  986. package/scripts/sort-sides.mjs +919 -0
  987. package/scripts/source-generation-outputs.json +11 -0
  988. package/scripts/source-generators.d.mts +11 -0
  989. package/scripts/source-generators.mjs +59 -0
  990. package/scripts/source-input-proof.d.mts +12 -0
  991. package/scripts/source-input-proof.mjs +106 -0
  992. package/scripts/source-table-cache.d.mts +2 -0
  993. package/scripts/source-table-cache.mjs +102 -0
  994. package/scripts/sp-tools.py +150 -0
  995. package/scripts/sp-tools.sh +6 -0
  996. package/scripts/split-repair-data-shard.mjs +98 -0
  997. package/scripts/split-repair-guardian.mjs +26 -0
  998. package/scripts/split-repair-hare.mjs +54 -0
  999. package/scripts/split-repair-held-melee.mjs +41 -0
  1000. package/scripts/split-repair-horse-panic.mjs +45 -0
  1001. package/scripts/split-repair-movers.mjs +92 -0
  1002. package/scripts/split-repair-nalati-signals.mjs +94 -0
  1003. package/scripts/split-repair-perks.mjs +73 -0
  1004. package/scripts/split-repair-pine-writes.mjs +76 -0
  1005. package/scripts/split-repair-proof.mjs +24 -0
  1006. package/scripts/split-repair-sky-trails.mjs +110 -0
  1007. package/scripts/split-repair-stun.mjs +37 -0
  1008. package/scripts/split-repair-wake-loss.mjs +35 -0
  1009. package/scripts/split-repair-whip.mjs +44 -0
  1010. package/scripts/staging-proof-lines.d.mts +8 -0
  1011. package/scripts/staging-proof-lines.mjs +85 -0
  1012. package/scripts/standalone-smoke.mjs +116 -0
  1013. package/scripts/storage-policy.json +89 -0
  1014. package/scripts/temp-janitor.d.mts +6 -0
  1015. package/scripts/temp-janitor.mjs +40 -0
  1016. package/scripts/template-format-proof.mjs +44 -0
  1017. package/scripts/test-amber.d.mts +11 -0
  1018. package/scripts/test-amber.mjs +90 -0
  1019. package/scripts/test-build-tools.ts +24 -0
  1020. package/scripts/test-facade-instancing.mjs +53 -0
  1021. package/scripts/test-ios-memory-watchdog.py +107 -0
  1022. package/scripts/test-products.json +389 -0
  1023. package/scripts/test-quarantine.d.mts +6 -0
  1024. package/scripts/test-quarantine.mjs +132 -0
  1025. package/scripts/test-shard-plan.ts +66 -0
  1026. package/scripts/test-timings.d.mts +14 -0
  1027. package/scripts/test-timings.mjs +174 -0
  1028. package/scripts/test_agent_time.py +155 -0
  1029. package/scripts/test_browser_lane.py +239 -0
  1030. package/scripts/test_lease_order.py +142 -0
  1031. package/scripts/test_partition.py +23 -0
  1032. package/scripts/test_prebuilt_output.py +258 -0
  1033. package/scripts/test_products.py +20 -0
  1034. package/scripts/test_serve_ports.py +645 -0
  1035. package/scripts/test_sim_lane.py +1661 -0
  1036. package/scripts/test_sim_quiet.py +140 -0
  1037. package/scripts/texture-inputs.d.mts +4 -0
  1038. package/scripts/texture-inputs.mjs +16 -0
  1039. package/scripts/tile-bake-policy.d.mts +4 -0
  1040. package/scripts/tile-bake-policy.mjs +43 -0
  1041. package/scripts/tile-bake-report.d.mts +17 -0
  1042. package/scripts/tile-bake-report.mjs +161 -0
  1043. package/scripts/tile-bakes.d.mts +13 -0
  1044. package/scripts/tile-bakes.mjs +100 -0
  1045. package/scripts/timelapse.sh +44 -0
  1046. package/scripts/title-assets.d.mts +6 -0
  1047. package/scripts/title-assets.generated.json +9 -0
  1048. package/scripts/title-assets.mjs +46 -0
  1049. package/scripts/title-exit-proof.mjs +132 -0
  1050. package/scripts/tsconfig.json +576 -0
  1051. package/scripts/typecheck-lint.sh +21 -0
  1052. package/scripts/typecheck-root.d.mts +2 -0
  1053. package/scripts/typecheck-root.mjs +18 -0
  1054. package/scripts/types/wildshard-probe.d.ts +29 -0
  1055. package/scripts/types/worker-page.d.ts +55 -0
  1056. package/scripts/uncatalogued-shard-proof.mjs +48 -0
  1057. package/scripts/vite-tmp.d.mts +23 -0
  1058. package/scripts/vite-tmp.mjs +157 -0
  1059. package/scripts/vitest-bench.py +800 -0
  1060. package/scripts/vitest-ci-files.ts +90 -0
  1061. package/scripts/vitest-ci.config.ts +15 -0
  1062. package/scripts/vitest-cpu.ts +46 -0
  1063. package/scripts/vitest-environments.ts +41 -0
  1064. package/scripts/vitest-fixture-snapshots.config.ts +8 -0
  1065. package/scripts/vitest-lane.ts +53 -0
  1066. package/scripts/vitest-module-cache.ts +49 -0
  1067. package/scripts/vitest-native-escape.config.ts +9 -0
  1068. package/scripts/vitest-plan.ts +94 -0
  1069. package/scripts/vitest-push-guards.config.ts +13 -0
  1070. package/scripts/vitest-push.config.ts +19 -0
  1071. package/scripts/vitest-shard.ts +109 -0
  1072. package/scripts/vitest-timings.ts +32 -0
  1073. package/scripts/vitest-tmp.ts +83 -0
  1074. package/scripts/vitest.sh +5 -0
  1075. package/scripts/vps/dump.sh +50 -0
  1076. package/scripts/vps/harden-apply.sh +490 -0
  1077. package/scripts/vps/harden-caddy.sh +215 -0
  1078. package/scripts/vps/harden.sh +358 -0
  1079. package/scripts/vps/health-stub.mjs +11 -0
  1080. package/scripts/vps/pull.mjs +156 -0
  1081. package/scripts/vps/rebuild.sh +531 -0
  1082. package/scripts/vps/restore-check.sh +35 -0
  1083. package/scripts/vps/setup-state.mjs +121 -0
  1084. package/scripts/vps/setup.sh +442 -0
  1085. package/scripts/vps/uptime.sh +26 -0
  1086. package/scripts/vps/wildshard-agent.pub +1 -0
  1087. package/scripts/vps/wildshard-apply.mjs +127 -0
  1088. package/scripts/vps/wildshard-config +211 -0
  1089. package/scripts/vps-harden-proof.sh +117 -0
  1090. package/scripts/vps-rebuild-proof.sh +170 -0
  1091. package/scripts/warm-native-chrome.d.mts +6 -0
  1092. package/scripts/warm-native-chrome.mjs +75 -0
  1093. package/scripts/webkit-mem-reading.mjs +157 -0
  1094. package/scripts/webkit-render-smoke.mjs +145 -0
  1095. package/scripts/worker-bootstrap-proof.mjs +79 -0
  1096. package/scripts/worker-client-death-return.mjs +97 -0
  1097. package/scripts/worker-client-death.mjs +67 -0
  1098. package/scripts/worker-client-fights.mjs +1438 -0
  1099. package/scripts/worker-client-grid-entry.mjs +239 -0
  1100. package/scripts/worker-client-hurt.mjs +92 -0
  1101. package/scripts/worker-client-moments.mjs +340 -0
  1102. package/scripts/worker-client-partner.mjs +93 -0
  1103. package/scripts/worker-client-pine-durable.mjs +102 -0
  1104. package/scripts/worker-client-pine-grid.mjs +77 -0
  1105. package/scripts/worker-client-pine-import.mjs +93 -0
  1106. package/scripts/worker-client-pine.mjs +114 -0
  1107. package/scripts/worker-client-play.mjs +572 -0
  1108. package/scripts/worker-client-proof.mjs +201 -0
  1109. package/scripts/worker-client-repairs.mjs +108 -0
  1110. package/scripts/worker-client-returns.mjs +51 -0
  1111. package/scripts/worker-client-saves.mjs +146 -0
  1112. package/scripts/worker-client-windup.mjs +50 -0
  1113. package/scripts/worktree-ignore.d.mts +4 -0
  1114. package/scripts/worktree-ignore.mjs +36 -0
  1115. package/scripts/worktree-reap.mjs +214 -0
  1116. package/scripts/worktree.mjs +339 -0
  1117. package/src/.oxfmtrc.json +48 -0
  1118. package/src/.oxlintrc.json +190 -0
  1119. package/src/cli/main.ts +112 -0
  1120. package/src/cli/version.ts +13 -0
  1121. package/src/client/app/assetTables.ts +68 -0
  1122. package/src/client/app/bootDownloads.ts +43 -0
  1123. package/src/client/app/bootRoute.ts +27 -0
  1124. package/src/client/app/calibrate.ts +9 -0
  1125. package/src/client/app/dropModal.ts +99 -0
  1126. package/src/client/app/entry.ts +439 -0
  1127. package/src/client/app/failScreens.ts +561 -0
  1128. package/src/client/app/identity.ts +10 -0
  1129. package/src/client/app/main.ts +3 -0
  1130. package/src/client/app/pageServices.ts +20 -0
  1131. package/src/client/app/selectedManifests.ts +31 -0
  1132. package/src/client/app/shardSelection.ts +46 -0
  1133. package/src/client/app/titleSettings.ts +15 -0
  1134. package/src/client/app.tsx +53 -0
  1135. package/src/client/engine/ai/view/eliteController.ts +148 -0
  1136. package/src/client/engine/ai/view/eliteEntry.ts +464 -0
  1137. package/src/client/engine/aliasFixture.webp +0 -0
  1138. package/src/client/engine/anim/channel.ts +58 -0
  1139. package/src/client/engine/anim/machine.ts +77 -0
  1140. package/src/client/engine/anim/rig.ts +150 -0
  1141. package/src/client/engine/anim/rigAtlas.ts +73 -0
  1142. package/src/client/engine/anim/rigParser.ts +59 -0
  1143. package/src/client/engine/app/app.ts +262 -0
  1144. package/src/client/engine/app/assets.ts +122 -0
  1145. package/src/client/engine/app/cachedAssets.ts +116 -0
  1146. package/src/client/engine/app/disposalCache.ts +30 -0
  1147. package/src/client/engine/app/runtime.ts +16 -0
  1148. package/src/client/engine/app/sceneOwnership.ts +317 -0
  1149. package/src/client/engine/app/services.ts +20 -0
  1150. package/src/client/engine/app/systems.ts +71 -0
  1151. package/src/client/engine/app/ui.ts +33 -0
  1152. package/src/client/engine/app/view/frameScheduler.ts +65 -0
  1153. package/src/client/engine/app/view/pageActivity.ts +12 -0
  1154. package/src/client/engine/app/view/presentation.ts +41 -0
  1155. package/src/client/engine/app/view/presentationLoop.ts +56 -0
  1156. package/src/client/engine/app/view/scopeEnvironment.ts +39 -0
  1157. package/src/client/engine/app/workerScope.js +20 -0
  1158. package/src/client/engine/audio/AmbienceBeds.ts +197 -0
  1159. package/src/client/engine/audio/Audio.ts +634 -0
  1160. package/src/client/engine/audio/Cues.ts +153 -0
  1161. package/src/client/engine/audio/Music.ts +958 -0
  1162. package/src/client/engine/audio/SetScore.ts +297 -0
  1163. package/src/client/engine/audio/Stems.ts +277 -0
  1164. package/src/client/engine/audio/Voices.ts +299 -0
  1165. package/src/client/engine/audio/aacNative.ts +46 -0
  1166. package/src/client/engine/audio/aacPull.ts +166 -0
  1167. package/src/client/engine/audio/aacSource.ts +122 -0
  1168. package/src/client/engine/audio/aacTrack.ts +115 -0
  1169. package/src/client/engine/audio/aacWindows.ts +66 -0
  1170. package/src/client/engine/audio/activity.ts +70 -0
  1171. package/src/client/engine/audio/activityTimers.ts +37 -0
  1172. package/src/client/engine/audio/ambience.ts +549 -0
  1173. package/src/client/engine/audio/audioLog.ts +22 -0
  1174. package/src/client/engine/audio/codecs.merge.d.ts +9 -0
  1175. package/src/client/engine/audio/credits.ts +48 -0
  1176. package/src/client/engine/audio/cueRouting.ts +93 -0
  1177. package/src/client/engine/audio/declared.ts +95 -0
  1178. package/src/client/engine/audio/declaredAmbience.ts +113 -0
  1179. package/src/client/engine/audio/declaredBank.ts +104 -0
  1180. package/src/client/engine/audio/declaredGameplay.ts +82 -0
  1181. package/src/client/engine/audio/dsp.ts +164 -0
  1182. package/src/client/engine/audio/gen.ts +538 -0
  1183. package/src/client/engine/audio/interactSfx.ts +95 -0
  1184. package/src/client/engine/audio/levelAudio.ts +131 -0
  1185. package/src/client/engine/audio/loopWindow.ts +24 -0
  1186. package/src/client/engine/audio/ownership.ts +16 -0
  1187. package/src/client/engine/audio/playerVoices.ts +278 -0
  1188. package/src/client/engine/audio/preload.ts +166 -0
  1189. package/src/client/engine/audio/score/score.ts +60 -0
  1190. package/src/client/engine/audio/scoreSelection.ts +19 -0
  1191. package/src/client/engine/audio/surface.ts +71 -0
  1192. package/src/client/engine/audio/synth.ts +301 -0
  1193. package/src/client/engine/audio/unlock.ts +104 -0
  1194. package/src/client/engine/audio/util.ts +95 -0
  1195. package/src/client/engine/blocks.ts +6 -0
  1196. package/src/client/engine/boot/audioFiles.ts +9 -0
  1197. package/src/client/engine/boot/audioInventory.ts +34 -0
  1198. package/src/client/engine/boot/audioPack.ts +54 -0
  1199. package/src/client/engine/boot/bakedApi.ts +46 -0
  1200. package/src/client/engine/boot/bakedTextures.ts +114 -0
  1201. package/src/client/engine/boot/bootCache.ts +16 -0
  1202. package/src/client/engine/boot/bootTrace.ts +362 -0
  1203. package/src/client/engine/boot/browserChunkRecovery.ts +136 -0
  1204. package/src/client/engine/boot/bytes.ts +272 -0
  1205. package/src/client/engine/boot/catalog.ts +35 -0
  1206. package/src/client/engine/boot/chunkRecovery.ts +41 -0
  1207. package/src/client/engine/boot/clearDownloads.ts +128 -0
  1208. package/src/client/engine/boot/contentBase.ts +77 -0
  1209. package/src/client/engine/boot/contentRead.ts +151 -0
  1210. package/src/client/engine/boot/diagnostics.ts +195 -0
  1211. package/src/client/engine/boot/download.ts +112 -0
  1212. package/src/client/engine/boot/dropNotice.ts +260 -0
  1213. package/src/client/engine/boot/earlyPrograms.ts +123 -0
  1214. package/src/client/engine/boot/extras.ts +324 -0
  1215. package/src/client/engine/boot/filePolicy.ts +126 -0
  1216. package/src/client/engine/boot/firstPlayMark.ts +43 -0
  1217. package/src/client/engine/boot/gpuFiles.ts +176 -0
  1218. package/src/client/engine/boot/gpuTrace.ts +42 -0
  1219. package/src/client/engine/boot/idle.ts +52 -0
  1220. package/src/client/engine/boot/imageDecode.ts +95 -0
  1221. package/src/client/engine/boot/imageDecode.worker.ts +69 -0
  1222. package/src/client/engine/boot/ktx2.generated.ts +157 -0
  1223. package/src/client/engine/boot/lastEnd.ts +312 -0
  1224. package/src/client/engine/boot/leaveAfterPaint.ts +16 -0
  1225. package/src/client/engine/boot/liveJsonParser.ts +124 -0
  1226. package/src/client/engine/boot/liveJsonParser.worker.ts +22 -0
  1227. package/src/client/engine/boot/loadingDownloadText.ts +54 -0
  1228. package/src/client/engine/boot/loadingPacks.ts +18 -0
  1229. package/src/client/engine/boot/lowPower.ts +96 -0
  1230. package/src/client/engine/boot/manifest.ts +12 -0
  1231. package/src/client/engine/boot/pack.ts +180 -0
  1232. package/src/client/engine/boot/parsedPages.ts +115 -0
  1233. package/src/client/engine/boot/perflog.ts +15 -0
  1234. package/src/client/engine/boot/plan.ts +256 -0
  1235. package/src/client/engine/boot/prefetch.ts +188 -0
  1236. package/src/client/engine/boot/prefetchQuota.ts +84 -0
  1237. package/src/client/engine/boot/readContentResponse.ts +17 -0
  1238. package/src/client/engine/boot/retry.ts +14 -0
  1239. package/src/client/engine/boot/runtime.ts +21 -0
  1240. package/src/client/engine/boot/shardPrefetch.ts +278 -0
  1241. package/src/client/engine/boot/shell.ts +135 -0
  1242. package/src/client/engine/boot/stuck.ts +106 -0
  1243. package/src/client/engine/boot/stuckStep.ts +99 -0
  1244. package/src/client/engine/boot/sw.ts +385 -0
  1245. package/src/client/engine/boot/swGlobal.d.ts +9 -0
  1246. package/src/client/engine/boot/texturePack.ts +182 -0
  1247. package/src/client/engine/boot/timeLeft.ts +106 -0
  1248. package/src/client/engine/boot/titleArrival.ts +101 -0
  1249. package/src/client/engine/boot/weights.ts +21 -0
  1250. package/src/client/engine/boot.ts +51 -0
  1251. package/src/client/engine/build.d.ts +2 -0
  1252. package/src/client/engine/calibrate/entry.ts +29 -0
  1253. package/src/client/engine/calibrate/js.ts +39 -0
  1254. package/src/client/engine/calibrate/math.ts +23 -0
  1255. package/src/client/engine/calibrate/run.ts +93 -0
  1256. package/src/client/engine/calibrate/wasm.ts +154 -0
  1257. package/src/client/engine/combat/EquipmentService.ts +412 -0
  1258. package/src/client/engine/combat/cues.ts +46 -0
  1259. package/src/client/engine/combat/types.ts +21 -0
  1260. package/src/client/engine/combat/view/Bow.ts +462 -0
  1261. package/src/client/engine/combat/view/DropArc.ts +64 -0
  1262. package/src/client/engine/combat/view/EquipmentHost.ts +15 -0
  1263. package/src/client/engine/combat/view/SweptMelee.ts +691 -0
  1264. package/src/client/engine/combat/view/bowProfile.ts +182 -0
  1265. package/src/client/engine/combat/view/brass.ts +65 -0
  1266. package/src/client/engine/combat/view/firearmFx.ts +25 -0
  1267. package/src/client/engine/combat/view/hitscan.ts +29 -0
  1268. package/src/client/engine/combat/view/melee.ts +67 -0
  1269. package/src/client/engine/combat/view/projectedTrail.ts +42 -0
  1270. package/src/client/engine/combat/view/projectile.ts +315 -0
  1271. package/src/client/engine/combat/view/ranged.ts +460 -0
  1272. package/src/client/engine/combat/view/rangedFeel.ts +39 -0
  1273. package/src/client/engine/combat/view/slashTrail.ts +151 -0
  1274. package/src/client/engine/core/Game.ts +1833 -0
  1275. package/src/client/engine/core/GpuRecovery.ts +200 -0
  1276. package/src/client/engine/core/Grade.ts +109 -0
  1277. package/src/client/engine/core/KeepAlive.ts +32 -0
  1278. package/src/client/engine/core/Tour.ts +46 -0
  1279. package/src/client/engine/core/Volumetrics.ts +260 -0
  1280. package/src/client/engine/core/apiOrigin.ts +12 -0
  1281. package/src/client/engine/core/assets.ts +292 -0
  1282. package/src/client/engine/core/bootstrap.ts +175 -0
  1283. package/src/client/engine/core/crashFlag.ts +32 -0
  1284. package/src/client/engine/core/crossroads.ts +4 -0
  1285. package/src/client/engine/core/deflate.ts +110 -0
  1286. package/src/client/engine/core/devMode.ts +49 -0
  1287. package/src/client/engine/core/devPixels.ts +62 -0
  1288. package/src/client/engine/core/drawBudget.ts +48 -0
  1289. package/src/client/engine/core/errorReport.ts +248 -0
  1290. package/src/client/engine/core/gpuOnly.ts +139 -0
  1291. package/src/client/engine/core/graphicsMode.ts +62 -0
  1292. package/src/client/engine/core/graphicsQuality.ts +117 -0
  1293. package/src/client/engine/core/heldTiming.ts +24 -0
  1294. package/src/client/engine/core/ktx2.ts +511 -0
  1295. package/src/client/engine/core/ktx2Sources.ts +22 -0
  1296. package/src/client/engine/core/ktx2Zstd.ts +151 -0
  1297. package/src/client/engine/core/ktx2Zstd.worker.ts +31 -0
  1298. package/src/client/engine/core/practiceRoom.ts +16 -0
  1299. package/src/client/engine/core/reloadGuard.ts +21 -0
  1300. package/src/client/engine/core/scopedCpu.ts +49 -0
  1301. package/src/client/engine/core/scopedWorkerPool.ts +55 -0
  1302. package/src/client/engine/core/shadowLayer.ts +8 -0
  1303. package/src/client/engine/core/slowGpuPacing.ts +118 -0
  1304. package/src/client/engine/core/sustainedFrames.ts +73 -0
  1305. package/src/client/engine/core/tier.ts +126 -0
  1306. package/src/client/engine/core/viewport.ts +130 -0
  1307. package/src/client/engine/core/webglStartup.ts +50 -0
  1308. package/src/client/engine/core/worldDepth.ts +183 -0
  1309. package/src/client/engine/core/zstdFrame.ts +38 -0
  1310. package/src/client/engine/debug/probe.ts +560 -0
  1311. package/src/client/engine/debug/timerBaseline.ts +14 -0
  1312. package/src/client/engine/entities/AnimalFactory.ts +766 -0
  1313. package/src/client/engine/entities/AnimalHerdView.ts +413 -0
  1314. package/src/client/engine/entities/AnimalView.ts +583 -0
  1315. package/src/client/engine/entities/RowBodies.ts +276 -0
  1316. package/src/client/engine/entities/animalMatrices.ts +179 -0
  1317. package/src/client/engine/entities/animalShadow.ts +58 -0
  1318. package/src/client/engine/entities/animalShells.ts +14 -0
  1319. package/src/client/engine/entities/farHerd.ts +469 -0
  1320. package/src/client/engine/entities/lowpoly.ts +155 -0
  1321. package/src/client/engine/entities/species/loft.ts +253 -0
  1322. package/src/client/engine/entities/species/look.ts +122 -0
  1323. package/src/client/engine/events/maps.ts +58 -0
  1324. package/src/client/engine/explore/Compare.ts +126 -0
  1325. package/src/client/engine/explore/Explore.ts +648 -0
  1326. package/src/client/engine/explore/FreeCam.ts +280 -0
  1327. package/src/client/engine/explore/MiniMap.ts +283 -0
  1328. package/src/client/engine/explore/ModelExplorer.ts +1155 -0
  1329. package/src/client/engine/explore/Select.ts +176 -0
  1330. package/src/client/engine/explore/SetExplorer.ts +553 -0
  1331. package/src/client/engine/explore/TouchFly.ts +236 -0
  1332. package/src/client/engine/explore/catalog.ts +159 -0
  1333. package/src/client/engine/explore/diorama.ts +245 -0
  1334. package/src/client/engine/explore/fatLines.ts +47 -0
  1335. package/src/client/engine/explore/img/mockups/nalati-camp-live.jpg +0 -0
  1336. package/src/client/engine/explore/img/mockups/nalati-camp-target.jpg +0 -0
  1337. package/src/client/engine/explore/img/mockups/nalati-gully-live.jpg +0 -0
  1338. package/src/client/engine/explore/img/mockups/nalati-gully-target.jpg +0 -0
  1339. package/src/client/engine/explore/img/mockups/nalati-rail-live.jpg +0 -0
  1340. package/src/client/engine/explore/img/mockups/nalati-rail-target.jpg +0 -0
  1341. package/src/client/engine/explore/img/mockups/nine-gate-live.jpg +0 -0
  1342. package/src/client/engine/explore/img/mockups/nine-gate-target.jpg +0 -0
  1343. package/src/client/engine/explore/img/mockups/nine-stair-live.jpg +0 -0
  1344. package/src/client/engine/explore/img/mockups/nine-stair-target.jpg +0 -0
  1345. package/src/client/engine/explore/pick.ts +120 -0
  1346. package/src/client/engine/explore/registry.ts +16 -0
  1347. package/src/client/engine/explore/setView.ts +222 -0
  1348. package/src/client/engine/explore/tiers.ts +27 -0
  1349. package/src/client/engine/explore/viewPoint.ts +100 -0
  1350. package/src/client/engine/fx/Impacts.ts +154 -0
  1351. package/src/client/engine/fx/LightPool.ts +188 -0
  1352. package/src/client/engine/fx/ParticlePool.ts +76 -0
  1353. package/src/client/engine/fx/SiteLights.ts +119 -0
  1354. package/src/client/engine/fx/effectField.ts +91 -0
  1355. package/src/client/engine/fx/groundFx.ts +144 -0
  1356. package/src/client/engine/fx/groundTell.ts +101 -0
  1357. package/src/client/engine/fx/lightEmitters.ts +35 -0
  1358. package/src/client/engine/input/ControlsPanel.ts +108 -0
  1359. package/src/client/engine/input/InputService.ts +394 -0
  1360. package/src/client/engine/input/bindingTable.ts +124 -0
  1361. package/src/client/engine/input/bindings.ts +101 -0
  1362. package/src/client/engine/input/dom.ts +62 -0
  1363. package/src/client/engine/input/equipmentInput.ts +4 -0
  1364. package/src/client/engine/input/gameplay.ts +36 -0
  1365. package/src/client/engine/input/keycap.ts +25 -0
  1366. package/src/client/engine/input/menuInput.ts +7 -0
  1367. package/src/client/engine/input/platform.ts +36 -0
  1368. package/src/client/engine/input/weaponActions.ts +8 -0
  1369. package/src/client/engine/level/frame.ts +95 -0
  1370. package/src/client/engine/level/installation.ts +107 -0
  1371. package/src/client/engine/level/load.ts +97 -0
  1372. package/src/client/engine/level/registrations.ts +59 -0
  1373. package/src/client/engine/math/color.ts +6 -0
  1374. package/src/client/engine/models/animalGeometry.ts +29 -0
  1375. package/src/client/engine/models/castawayBody.ts +257 -0
  1376. package/src/client/engine/models/colliders.ts +186 -0
  1377. package/src/client/engine/models/creature.ts +66 -0
  1378. package/src/client/engine/models/cull.ts +953 -0
  1379. package/src/client/engine/models/gear.ts +87 -0
  1380. package/src/client/engine/models/geometryPack.ts +14 -0
  1381. package/src/client/engine/models/hoverboard.ts +29 -0
  1382. package/src/client/engine/models/instancedBatch.ts +324 -0
  1383. package/src/client/engine/models/interact.ts +26 -0
  1384. package/src/client/engine/models/live.ts +174 -0
  1385. package/src/client/engine/models/model.ts +449 -0
  1386. package/src/client/engine/models/modelPose.ts +14 -0
  1387. package/src/client/engine/models/nativeGeometry.ts +114 -0
  1388. package/src/client/engine/models/ownedGeometry.ts +294 -0
  1389. package/src/client/engine/models/place.ts +1476 -0
  1390. package/src/client/engine/models/roster.ts +44 -0
  1391. package/src/client/engine/models/sets.ts +74 -0
  1392. package/src/client/engine/models/slots.ts +69 -0
  1393. package/src/client/engine/models/staticSets.ts +119 -0
  1394. package/src/client/engine/models/swimHands.ts +44 -0
  1395. package/src/client/engine/models/trainingDummy.ts +46 -0
  1396. package/src/client/engine/models/trainingDummyFigure.ts +16 -0
  1397. package/src/client/engine/models/weld.ts +260 -0
  1398. package/src/client/engine/net/attackPrediction.ts +38 -0
  1399. package/src/client/engine/net/client.ts +314 -0
  1400. package/src/client/engine/net/heldOnOthers.ts +167 -0
  1401. package/src/client/engine/net/hurtOther.ts +12 -0
  1402. package/src/client/engine/net/interpolator.ts +179 -0
  1403. package/src/client/engine/net/nameTag.ts +88 -0
  1404. package/src/client/engine/net/netClock.ts +90 -0
  1405. package/src/client/engine/net/netPlayer.ts +265 -0
  1406. package/src/client/engine/net/netRecord.ts +43 -0
  1407. package/src/client/engine/net/onRep.ts +75 -0
  1408. package/src/client/engine/net/otherPlayers.ts +239 -0
  1409. package/src/client/engine/net/othersOnMap.ts +80 -0
  1410. package/src/client/engine/net/predictionWorld.ts +100 -0
  1411. package/src/client/engine/net/predictor.ts +233 -0
  1412. package/src/client/engine/net/redial.ts +179 -0
  1413. package/src/client/engine/net/remoteAir.ts +134 -0
  1414. package/src/client/engine/net/remoteBoard.ts +128 -0
  1415. package/src/client/engine/net/remoteDeath.ts +140 -0
  1416. package/src/client/engine/net/remoteGait.ts +114 -0
  1417. package/src/client/engine/net/remoteHurt.ts +123 -0
  1418. package/src/client/engine/net/remoteStrike.ts +160 -0
  1419. package/src/client/engine/net/voiceNear.ts +55 -0
  1420. package/src/client/engine/net/webSocketTransport.ts +91 -0
  1421. package/src/client/engine/physics/active.ts +15 -0
  1422. package/src/client/engine/physics/boxFrame.ts +15 -0
  1423. package/src/client/engine/physics/calibration.ts +31 -0
  1424. package/src/client/engine/physics/debug.ts +68 -0
  1425. package/src/client/engine/physics/navmeshLoad.ts +86 -0
  1426. package/src/client/engine/physics/ragdoll.ts +513 -0
  1427. package/src/client/engine/physics/ropeDeck.ts +112 -0
  1428. package/src/client/engine/player/AimAssist.ts +183 -0
  1429. package/src/client/engine/player/AimTargets.ts +55 -0
  1430. package/src/client/engine/player/CameraFX.ts +89 -0
  1431. package/src/client/engine/player/Hands.ts +216 -0
  1432. package/src/client/engine/player/LockOnTarget.ts +395 -0
  1433. package/src/client/engine/player/Player.ts +678 -0
  1434. package/src/client/engine/player/Skins.ts +109 -0
  1435. package/src/client/engine/player/TouchControls.ts +564 -0
  1436. package/src/client/engine/player/WaterLine.ts +94 -0
  1437. package/src/client/engine/player/WeaponPickup.ts +465 -0
  1438. package/src/client/engine/player/bladeGlow.ts +120 -0
  1439. package/src/client/engine/player/firstPersonArms.ts +384 -0
  1440. package/src/client/engine/player/heldHandParts.ts +91 -0
  1441. package/src/client/engine/player/viewmodelSources.ts +25 -0
  1442. package/src/client/engine/player/viewmodelTextures.ts +261 -0
  1443. package/src/client/engine/player/viewmodelTextures.worker.ts +28 -0
  1444. package/src/client/engine/practice/DummyClips.ts +100 -0
  1445. package/src/client/engine/practice/DummyMotion.ts +287 -0
  1446. package/src/client/engine/practice/DummyStudio.ts +137 -0
  1447. package/src/client/engine/practice/TrainingArena.ts +463 -0
  1448. package/src/client/engine/practice/TrainingDummy.ts +160 -0
  1449. package/src/client/engine/practice/TrainingDummyAssets.ts +80 -0
  1450. package/src/client/engine/practice/arena.css +20 -0
  1451. package/src/client/engine/practice/dummyMetadata.ts +12 -0
  1452. package/src/client/engine/practice/lineup.ts +17 -0
  1453. package/src/client/engine/practice/playground/Playground.ts +52 -0
  1454. package/src/client/engine/practice/playground/catalog.ts +44 -0
  1455. package/src/client/engine/practice/playground/devGrid.ts +173 -0
  1456. package/src/client/engine/practice/playground/hud.ts +80 -0
  1457. package/src/client/engine/practice/playground/load.ts +24 -0
  1458. package/src/client/engine/practice/practiceLoan.ts +52 -0
  1459. package/src/client/engine/practice/targets.ts +15 -0
  1460. package/src/client/engine/pwa/cacheNames.ts +2 -0
  1461. package/src/client/engine/pwa/sw.js +401 -0
  1462. package/src/client/engine/quest/view/replica.ts +88 -0
  1463. package/src/client/engine/quest/view/ui.ts +221 -0
  1464. package/src/client/engine/quest/view.ts +209 -0
  1465. package/src/client/engine/render/allocationBytes.ts +16 -0
  1466. package/src/client/engine/render/allocationJournal.ts +125 -0
  1467. package/src/client/engine/render/aoTransparency.ts +225 -0
  1468. package/src/client/engine/render/budgetReport.ts +53 -0
  1469. package/src/client/engine/render/budgets.ts +72 -0
  1470. package/src/client/engine/render/calibration.ts +32 -0
  1471. package/src/client/engine/render/calibrationGpu.ts +84 -0
  1472. package/src/client/engine/render/changedTextureUploads.ts +118 -0
  1473. package/src/client/engine/render/compileLights.ts +75 -0
  1474. package/src/client/engine/render/compileShadows.ts +29 -0
  1475. package/src/client/engine/render/composerDepth.ts +26 -0
  1476. package/src/client/engine/render/compressedMipmaps.ts +59 -0
  1477. package/src/client/engine/render/compressedTextureRetirement.ts +71 -0
  1478. package/src/client/engine/render/compressedUpload.ts +107 -0
  1479. package/src/client/engine/render/contextErrors.ts +14 -0
  1480. package/src/client/engine/render/dataLook.ts +691 -0
  1481. package/src/client/engine/render/desktopReference.ts +5 -0
  1482. package/src/client/engine/render/diagnosticJournal.ts +23 -0
  1483. package/src/client/engine/render/displayColour.ts +55 -0
  1484. package/src/client/engine/render/doubleElements.ts +33 -0
  1485. package/src/client/engine/render/drawGuards.ts +47 -0
  1486. package/src/client/engine/render/drawHooks.ts +265 -0
  1487. package/src/client/engine/render/drawNeutral.ts +19 -0
  1488. package/src/client/engine/render/drawnEnvironment.ts +35 -0
  1489. package/src/client/engine/render/entryWarmupBound.ts +19 -0
  1490. package/src/client/engine/render/families/emissive.ts +224 -0
  1491. package/src/client/engine/render/families/ground.ts +291 -0
  1492. package/src/client/engine/render/families/measure.ts +191 -0
  1493. package/src/client/engine/render/families/paintedTerrain.ts +388 -0
  1494. package/src/client/engine/render/families/painterly.ts +288 -0
  1495. package/src/client/engine/render/families/pbr.ts +67 -0
  1496. package/src/client/engine/render/families/registry.ts +140 -0
  1497. package/src/client/engine/render/families/toon.ts +193 -0
  1498. package/src/client/engine/render/fencedUnits.ts +115 -0
  1499. package/src/client/engine/render/firstFrameParts.ts +95 -0
  1500. package/src/client/engine/render/fogPatches.ts +56 -0
  1501. package/src/client/engine/render/frameCounter.ts +47 -0
  1502. package/src/client/engine/render/frameDrawRange.ts +120 -0
  1503. package/src/client/engine/render/gltfMaterialOrder.ts +83 -0
  1504. package/src/client/engine/render/gpuClasses.ts +29 -0
  1505. package/src/client/engine/render/gpuLabels.ts +437 -0
  1506. package/src/client/engine/render/graph/colourFunction.ts +83 -0
  1507. package/src/client/engine/render/graph/glsl.ts +1056 -0
  1508. package/src/client/engine/render/graph/glslCodec.ts +48 -0
  1509. package/src/client/engine/render/graph/glslMaterial.ts +463 -0
  1510. package/src/client/engine/render/graph/glslPost.ts +79 -0
  1511. package/src/client/engine/render/graph/glslProgram.ts +698 -0
  1512. package/src/client/engine/render/graph/presets.ts +812 -0
  1513. package/src/client/engine/render/graph/viewRay.ts +28 -0
  1514. package/src/client/engine/render/graphBackend.ts +176 -0
  1515. package/src/client/engine/render/hoverboardGeometry.ts +54 -0
  1516. package/src/client/engine/render/instancedGeometry.ts +28 -0
  1517. package/src/client/engine/render/instancedTwin.ts +40 -0
  1518. package/src/client/engine/render/ktx2Probe.ts +299 -0
  1519. package/src/client/engine/render/layeredMaps.ts +64 -0
  1520. package/src/client/engine/render/lightUniforms.ts +22 -0
  1521. package/src/client/engine/render/lighterTargets.ts +47 -0
  1522. package/src/client/engine/render/lightmaps.ts +36 -0
  1523. package/src/client/engine/render/look.ts +406 -0
  1524. package/src/client/engine/render/lookLight.ts +107 -0
  1525. package/src/client/engine/render/lut.ts +23 -0
  1526. package/src/client/engine/render/memoryImages.ts +31 -0
  1527. package/src/client/engine/render/memorySaver.ts +262 -0
  1528. package/src/client/engine/render/offscreenBuild.ts +184 -0
  1529. package/src/client/engine/render/offscreenPreparation.ts +41 -0
  1530. package/src/client/engine/render/parkedDraws.ts +920 -0
  1531. package/src/client/engine/render/pmremSize.ts +21 -0
  1532. package/src/client/engine/render/postPreparation.ts +67 -0
  1533. package/src/client/engine/render/precompile.ts +1833 -0
  1534. package/src/client/engine/render/programRetention.ts +125 -0
  1535. package/src/client/engine/render/readbackPreparation.ts +23 -0
  1536. package/src/client/engine/render/regionCinematic.ts +212 -0
  1537. package/src/client/engine/render/regionLook.ts +301 -0
  1538. package/src/client/engine/render/releasedArrays.ts +13 -0
  1539. package/src/client/engine/render/renderer.ts +68 -0
  1540. package/src/client/engine/render/scatterInstances.ts +139 -0
  1541. package/src/client/engine/render/scenePreparation.ts +27 -0
  1542. package/src/client/engine/render/shaderPatches.ts +303 -0
  1543. package/src/client/engine/render/shaderText.ts +95 -0
  1544. package/src/client/engine/render/shadowDepthVariants.ts +35 -0
  1545. package/src/client/engine/render/shadowMaterialOwnership.ts +120 -0
  1546. package/src/client/engine/render/skinnedSpheres.ts +30 -0
  1547. package/src/client/engine/render/skyEnvironment.ts +222 -0
  1548. package/src/client/engine/render/staticMatrices.ts +88 -0
  1549. package/src/client/engine/render/streamedInstances.ts +184 -0
  1550. package/src/client/engine/render/textureBytes.ts +185 -0
  1551. package/src/client/engine/render/textureUploadEvents.ts +60 -0
  1552. package/src/client/engine/render/tierBenchmark.ts +54 -0
  1553. package/src/client/engine/render/tierBoot.ts +50 -0
  1554. package/src/client/engine/render/tierSelect.ts +27 -0
  1555. package/src/client/engine/render/tiers.ts +78 -0
  1556. package/src/client/engine/render/uniformCaches.ts +143 -0
  1557. package/src/client/engine/render/uploadOwnership.ts +335 -0
  1558. package/src/client/engine/render/viewmodel.ts +114 -0
  1559. package/src/client/engine/render/viewmodelFeel.ts +374 -0
  1560. package/src/client/engine/saves/indexed.ts +250 -0
  1561. package/src/client/engine/saves/slots.ts +42 -0
  1562. package/src/client/engine/saves/view/storage.ts +11 -0
  1563. package/src/client/engine/script/client.ts +240 -0
  1564. package/src/client/engine/telemetry/bootInbox.ts +18 -0
  1565. package/src/client/engine/telemetry/browserErrors.ts +173 -0
  1566. package/src/client/engine/telemetry/crossroads.ts +26 -0
  1567. package/src/client/engine/telemetry/health.ts +40 -0
  1568. package/src/client/engine/telemetry/model.ts +36 -0
  1569. package/src/client/engine/telemetry/runtime.ts +62 -0
  1570. package/src/client/engine/types/meshopt-simplifier.d.ts +10 -0
  1571. package/src/client/engine/types/n8ao.d.ts +52 -0
  1572. package/src/client/engine/ui/BootSettings.ts +97 -0
  1573. package/src/client/engine/ui/BossBar.ts +141 -0
  1574. package/src/client/engine/ui/Combat.ts +299 -0
  1575. package/src/client/engine/ui/DeathFade.ts +104 -0
  1576. package/src/client/engine/ui/DebugMenu.ts +199 -0
  1577. package/src/client/engine/ui/EliteBar.ts +219 -0
  1578. package/src/client/engine/ui/ErrorModal.ts +309 -0
  1579. package/src/client/engine/ui/Feedback.ts +346 -0
  1580. package/src/client/engine/ui/FirstHints.ts +279 -0
  1581. package/src/client/engine/ui/HUD.ts +714 -0
  1582. package/src/client/engine/ui/HurtArc.ts +102 -0
  1583. package/src/client/engine/ui/ItemCard.ts +95 -0
  1584. package/src/client/engine/ui/KeyHelp.ts +59 -0
  1585. package/src/client/engine/ui/Loading.ts +851 -0
  1586. package/src/client/engine/ui/LockOn.ts +131 -0
  1587. package/src/client/engine/ui/Map.ts +280 -0
  1588. package/src/client/engine/ui/Menu.ts +438 -0
  1589. package/src/client/engine/ui/Minimap.ts +840 -0
  1590. package/src/client/engine/ui/Perf.ts +356 -0
  1591. package/src/client/engine/ui/ReloadPrompt.ts +42 -0
  1592. package/src/client/engine/ui/RotateGate.ts +40 -0
  1593. package/src/client/engine/ui/SavePanel.ts +62 -0
  1594. package/src/client/engine/ui/Settings.ts +277 -0
  1595. package/src/client/engine/ui/SpeedLines.ts +46 -0
  1596. package/src/client/engine/ui/StartTitle.ts +39 -0
  1597. package/src/client/engine/ui/ToastStack.ts +90 -0
  1598. package/src/client/engine/ui/Update.ts +116 -0
  1599. package/src/client/engine/ui/WeaponStrip.ts +272 -0
  1600. package/src/client/engine/ui/WindupWarn.ts +116 -0
  1601. package/src/client/engine/ui/authoredDebugRows.ts +3 -0
  1602. package/src/client/engine/ui/buildCheck.ts +72 -0
  1603. package/src/client/engine/ui/buildRow.ts +71 -0
  1604. package/src/client/engine/ui/cards.ts +41 -0
  1605. package/src/client/engine/ui/debugOptions.ts +230 -0
  1606. package/src/client/engine/ui/declared.ts +89 -0
  1607. package/src/client/engine/ui/devSwitch.ts +48 -0
  1608. package/src/client/engine/ui/developerBanner.ts +32 -0
  1609. package/src/client/engine/ui/diagnosticsCopy.ts +20 -0
  1610. package/src/client/engine/ui/drawBudgetCounter.ts +10 -0
  1611. package/src/client/engine/ui/errorScreen.ts +109 -0
  1612. package/src/client/engine/ui/frameWindow.ts +50 -0
  1613. package/src/client/engine/ui/graphicsBlock.ts +156 -0
  1614. package/src/client/engine/ui/graphicsControls.ts +47 -0
  1615. package/src/client/engine/ui/haptics.ts +28 -0
  1616. package/src/client/engine/ui/hoverBoost.ts +61 -0
  1617. package/src/client/engine/ui/hudAdapters.ts +61 -0
  1618. package/src/client/engine/ui/hudSlots.ts +130 -0
  1619. package/src/client/engine/ui/icons.ts +62 -0
  1620. package/src/client/engine/ui/layers.ts +134 -0
  1621. package/src/client/engine/ui/leaveGuard.ts +64 -0
  1622. package/src/client/engine/ui/loadProgress.ts +67 -0
  1623. package/src/client/engine/ui/loading.css +125 -0
  1624. package/src/client/engine/ui/lookLightOption.ts +22 -0
  1625. package/src/client/engine/ui/mapLabel.ts +18 -0
  1626. package/src/client/engine/ui/mapPainter.ts +395 -0
  1627. package/src/client/engine/ui/menuSettings.ts +188 -0
  1628. package/src/client/engine/ui/namePrompt.ts +138 -0
  1629. package/src/client/engine/ui/offlineDownload.ts +83 -0
  1630. package/src/client/engine/ui/ownership.ts +14 -0
  1631. package/src/client/engine/ui/panel.ts +166 -0
  1632. package/src/client/engine/ui/perf.css +93 -0
  1633. package/src/client/engine/ui/perfDock.ts +61 -0
  1634. package/src/client/engine/ui/perfHud.ts +332 -0
  1635. package/src/client/engine/ui/perfLap.ts +206 -0
  1636. package/src/client/engine/ui/perfLapSummary.ts +92 -0
  1637. package/src/client/engine/ui/perfProbe.ts +280 -0
  1638. package/src/client/engine/ui/pinKeepOut.ts +59 -0
  1639. package/src/client/engine/ui/playerDeath.ts +16 -0
  1640. package/src/client/engine/ui/playerHurt.ts +70 -0
  1641. package/src/client/engine/ui/playerReload.ts +55 -0
  1642. package/src/client/engine/ui/reloadChip.ts +24 -0
  1643. package/src/client/engine/ui/reloadCover.ts +110 -0
  1644. package/src/client/engine/ui/review.ts +158 -0
  1645. package/src/client/engine/ui/roomMap.ts +109 -0
  1646. package/src/client/engine/ui/saveStrings.ts +9 -0
  1647. package/src/client/engine/ui/settingsTabs.ts +249 -0
  1648. package/src/client/engine/ui/styles/base.css +92 -0
  1649. package/src/client/engine/ui/styles/boss.css +97 -0
  1650. package/src/client/engine/ui/styles/combat.css +100 -0
  1651. package/src/client/engine/ui/styles/debug.css +22 -0
  1652. package/src/client/engine/ui/styles/elite.css +87 -0
  1653. package/src/client/engine/ui/styles/explore.css +435 -0
  1654. package/src/client/engine/ui/styles/feedback.css +63 -0
  1655. package/src/client/engine/ui/styles/game.css +290 -0
  1656. package/src/client/engine/ui/styles/gmenu.css +407 -0
  1657. package/src/client/engine/ui/styles/hints.css +26 -0
  1658. package/src/client/engine/ui/styles/itemcard.css +38 -0
  1659. package/src/client/engine/ui/styles/menu.css +129 -0
  1660. package/src/client/engine/ui/styles/minimap.css +87 -0
  1661. package/src/client/engine/ui/styles/namePrompt.css +27 -0
  1662. package/src/client/engine/ui/styles/playgrounds.css +18 -0
  1663. package/src/client/engine/ui/styles/quest.css +65 -0
  1664. package/src/client/engine/ui/styles/rotate.css +55 -0
  1665. package/src/client/engine/ui/styles/touch.css +303 -0
  1666. package/src/client/engine/ui/styles/update.css +27 -0
  1667. package/src/client/engine/ui/tabs.ts +27 -0
  1668. package/src/client/engine/ui/unstuck.ts +38 -0
  1669. package/src/client/engine/ui/voiceSettings.ts +135 -0
  1670. package/src/client/engine/world/Atmosphere.ts +333 -0
  1671. package/src/client/engine/world/BakedSky.ts +155 -0
  1672. package/src/client/engine/world/Boundary.ts +234 -0
  1673. package/src/client/engine/world/Grass.ts +664 -0
  1674. package/src/client/engine/world/Horizon.ts +237 -0
  1675. package/src/client/engine/world/HorizonMatte.ts +399 -0
  1676. package/src/client/engine/world/Terrain.ts +560 -0
  1677. package/src/client/engine/world/TreeFactory.ts +128 -0
  1678. package/src/client/engine/world/backdropLayer.ts +580 -0
  1679. package/src/client/engine/world/blenderArea.ts +23 -0
  1680. package/src/client/engine/world/bounds.ts +57 -0
  1681. package/src/client/engine/world/cascadeCull.ts +251 -0
  1682. package/src/client/engine/world/cascadeLights.ts +29 -0
  1683. package/src/client/engine/world/cloudField.ts +29 -0
  1684. package/src/client/engine/world/coarseTileMask.ts +100 -0
  1685. package/src/client/engine/world/csmLightBlock.ts +23 -0
  1686. package/src/client/engine/world/declaredProps.ts +226 -0
  1687. package/src/client/engine/world/forest/Forest.ts +378 -0
  1688. package/src/client/engine/world/forest/treeSet.ts +140 -0
  1689. package/src/client/engine/world/forest/treeSpecies.ts +17 -0
  1690. package/src/client/engine/world/frameCamera.ts +58 -0
  1691. package/src/client/engine/world/geometryBake.ts +272 -0
  1692. package/src/client/engine/world/geometryBounds.ts +77 -0
  1693. package/src/client/engine/world/geometryKit.ts +163 -0
  1694. package/src/client/engine/world/hiddenFaces.ts +153 -0
  1695. package/src/client/engine/world/interact/Interactables.ts +690 -0
  1696. package/src/client/engine/world/interact/kit.ts +6 -0
  1697. package/src/client/engine/world/lookFlags.ts +15 -0
  1698. package/src/client/engine/world/lowpolyKit.ts +270 -0
  1699. package/src/client/engine/world/lut.ts +45 -0
  1700. package/src/client/engine/world/painterly.ts +109 -0
  1701. package/src/client/engine/world/pointLightSkip.ts +31 -0
  1702. package/src/client/engine/world/pond.ts +184 -0
  1703. package/src/client/engine/world/pondGrid.ts +5 -0
  1704. package/src/client/engine/world/registry.ts +348 -0
  1705. package/src/client/engine/world/shadowCadence.ts +14 -0
  1706. package/src/client/engine/world/shadowChunks.ts +193 -0
  1707. package/src/client/engine/world/shadowFade.ts +190 -0
  1708. package/src/client/engine/world/shadowFilter.ts +117 -0
  1709. package/src/client/engine/world/shadowVariants.ts +115 -0
  1710. package/src/client/engine/world/skyBackdrop.ts +526 -0
  1711. package/src/client/engine/world/skyRig.ts +577 -0
  1712. package/src/client/engine/world/skyTextures.ts +103 -0
  1713. package/src/client/engine/world/terrainTileView.ts +164 -0
  1714. package/src/client/engine/world/tileStreamer.ts +823 -0
  1715. package/src/client/engine/world/voxelAO.ts +338 -0
  1716. package/src/client/engine/world/water/ripplePixels.ts +51 -0
  1717. package/src/client/engine/world/water/ripples.ts +102 -0
  1718. package/src/client/engine/world/weakShaderMap.ts +58 -0
  1719. package/src/client/engine/world/wind.ts +112 -0
  1720. package/src/client/game/Boss.ts +354 -0
  1721. package/src/client/game/Elite.ts +529 -0
  1722. package/src/client/game/Inventory.ts +123 -0
  1723. package/src/client/game/Progress.ts +166 -0
  1724. package/src/client/game/ambient/ambientFlock.ts +71 -0
  1725. package/src/client/game/ambient/crowdDraw.ts +85 -0
  1726. package/src/client/game/ambient/foragerDraw.ts +56 -0
  1727. package/src/client/game/ambient/pageCrowds.ts +81 -0
  1728. package/src/client/game/ambient/wingField.ts +46 -0
  1729. package/src/client/game/animation/limbCollision.ts +46 -0
  1730. package/src/client/game/animation/limbQueryPose.ts +141 -0
  1731. package/src/client/game/animation/limbQueryView.ts +53 -0
  1732. package/src/client/game/animation/limbView.ts +28 -0
  1733. package/src/client/game/audio/cueDirector.ts +157 -0
  1734. package/src/client/game/audio/forestPage.ts +30 -0
  1735. package/src/client/game/audio/sceneDirector.ts +239 -0
  1736. package/src/client/game/audio/sceneEvents.merge.d.ts +9 -0
  1737. package/src/client/game/audio/theme.ts +229 -0
  1738. package/src/client/game/audio/voicePatches.ts +108 -0
  1739. package/src/client/game/bag/BagButton.ts +85 -0
  1740. package/src/client/game/bag/bag.ts +239 -0
  1741. package/src/client/game/bag/equipment.ts +18 -0
  1742. package/src/client/game/bag/tabs.ts +194 -0
  1743. package/src/client/game/boot/audio.generated.ts +9258 -0
  1744. package/src/client/game/boot/bytes.generated.ts +1643 -0
  1745. package/src/client/game/boot/loadingPaths.ts +121 -0
  1746. package/src/client/game/boot/packs.generated.ts +5 -0
  1747. package/src/client/game/boot/spawnDownload.ts +999 -0
  1748. package/src/client/game/boot/versions.generated.ts +868 -0
  1749. package/src/client/game/boss/arenaFire.ts +135 -0
  1750. package/src/client/game/boss/arenaRoom.ts +715 -0
  1751. package/src/client/game/boss/arenaRoomView.ts +530 -0
  1752. package/src/client/game/boss/barFeed.ts +253 -0
  1753. package/src/client/game/boss/encounterView.ts +463 -0
  1754. package/src/client/game/boss/presentation.ts +18 -0
  1755. package/src/client/game/boss/roamingProjection.ts +255 -0
  1756. package/src/client/game/boss/slotRowsView.ts +95 -0
  1757. package/src/client/game/boss/socketRig.ts +129 -0
  1758. package/src/client/game/boss/timedEncounters.ts +83 -0
  1759. package/src/client/game/combat/roamingSession.ts +107 -0
  1760. package/src/client/game/compendium/Journal.ts +85 -0
  1761. package/src/client/game/compendium/compendium.css +135 -0
  1762. package/src/client/game/compendium/install.ts +181 -0
  1763. package/src/client/game/compendium/journalView.ts +224 -0
  1764. package/src/client/game/compendium/keepsakes.ts +169 -0
  1765. package/src/client/game/compendium/keepsakesView.ts +70 -0
  1766. package/src/client/game/complete/ShardComplete.ts +148 -0
  1767. package/src/client/game/complete/complete.css +71 -0
  1768. package/src/client/game/complete/declared.ts +111 -0
  1769. package/src/client/game/cosmetics/bodyShadow.ts +148 -0
  1770. package/src/client/game/cosmetics/cosmetics.ts +119 -0
  1771. package/src/client/game/cosmetics/locker.ts +88 -0
  1772. package/src/client/game/data/pickupCatalogue.json +1008 -0
  1773. package/src/client/game/debug/browser.d.ts +10 -0
  1774. package/src/client/game/draftTitles.ts +26 -0
  1775. package/src/client/game/eliteView.ts +246 -0
  1776. package/src/client/game/engineStrings.ts +12 -0
  1777. package/src/client/game/equipmentTypes.merge.d.ts +10 -0
  1778. package/src/client/game/firstPlay.css +18 -0
  1779. package/src/client/game/firstPlay.ts +94 -0
  1780. package/src/client/game/generators/pickups.ts +92 -0
  1781. package/src/client/game/grapple/fontPreparation.ts +31 -0
  1782. package/src/client/game/grapple/netClaw.ts +61 -0
  1783. package/src/client/game/grapple/ribbon.ts +159 -0
  1784. package/src/client/game/grapple/tool.ts +478 -0
  1785. package/src/client/game/grid/admissionPriority.ts +41 -0
  1786. package/src/client/game/grid/admissionYield.ts +37 -0
  1787. package/src/client/game/grid/approachProductInputs.ts +72 -0
  1788. package/src/client/game/grid/assetResidency.ts +188 -0
  1789. package/src/client/game/grid/borderShimmer.ts +185 -0
  1790. package/src/client/game/grid/budgetOverlay.css +40 -0
  1791. package/src/client/game/grid/budgetOverlay.ts +238 -0
  1792. package/src/client/game/grid/budgetPoints.ts +184 -0
  1793. package/src/client/game/grid/cellChanges.ts +106 -0
  1794. package/src/client/game/grid/cellClip.ts +611 -0
  1795. package/src/client/game/grid/cellCover.ts +58 -0
  1796. package/src/client/game/grid/cellLoading.ts +89 -0
  1797. package/src/client/game/grid/cellPresence.ts +28 -0
  1798. package/src/client/game/grid/cellScreens.ts +83 -0
  1799. package/src/client/game/grid/copyIdentity.ts +98 -0
  1800. package/src/client/game/grid/copyLayout.ts +153 -0
  1801. package/src/client/game/grid/copyPrompts.ts +31 -0
  1802. package/src/client/game/grid/edgeSources.ts +120 -0
  1803. package/src/client/game/grid/enteredEquipment.ts +65 -0
  1804. package/src/client/game/grid/enteredInteract.ts +43 -0
  1805. package/src/client/game/grid/entryDownloads.ts +45 -0
  1806. package/src/client/game/grid/entryReadPrefetch.ts +64 -0
  1807. package/src/client/game/grid/farImpostorDecodeWorker.ts +32 -0
  1808. package/src/client/game/grid/farImpostorPack.ts +18 -0
  1809. package/src/client/game/grid/farImpostorView.ts +130 -0
  1810. package/src/client/game/grid/farView.ts +235 -0
  1811. package/src/client/game/grid/frame.ts +845 -0
  1812. package/src/client/game/grid/frameLook.ts +215 -0
  1813. package/src/client/game/grid/frameModel.ts +126 -0
  1814. package/src/client/game/grid/gridHud.css +47 -0
  1815. package/src/client/game/grid/gridHud.ts +126 -0
  1816. package/src/client/game/grid/hazeBand.ts +77 -0
  1817. package/src/client/game/grid/homeCheckpoint.ts +11 -0
  1818. package/src/client/game/grid/homeMetadata.ts +40 -0
  1819. package/src/client/game/grid/intent.ts +65 -0
  1820. package/src/client/game/grid/live.ts +787 -0
  1821. package/src/client/game/grid/liveSession.ts +969 -0
  1822. package/src/client/game/grid/loadingRings.ts +49 -0
  1823. package/src/client/game/grid/mapAtlas.build.d.ts +4 -0
  1824. package/src/client/game/grid/mapAtlas.ts +33 -0
  1825. package/src/client/game/grid/mapFrame.ts +81 -0
  1826. package/src/client/game/grid/memoryRows.ts +32 -0
  1827. package/src/client/game/grid/memoryWarning.css +11 -0
  1828. package/src/client/game/grid/memoryWarning.ts +81 -0
  1829. package/src/client/game/grid/menu.ts +49 -0
  1830. package/src/client/game/grid/minimapBlend.ts +185 -0
  1831. package/src/client/game/grid/nearGrain.ts +40 -0
  1832. package/src/client/game/grid/nearPlaceholderPlan.ts +60 -0
  1833. package/src/client/game/grid/nearPlaceholderView.ts +182 -0
  1834. package/src/client/game/grid/neighbourLife.ts +151 -0
  1835. package/src/client/game/grid/neighbourPanels.ts +84 -0
  1836. package/src/client/game/grid/neighbourRows.ts +32 -0
  1837. package/src/client/game/grid/oneWayIn.ts +114 -0
  1838. package/src/client/game/grid/pageEntry.ts +234 -0
  1839. package/src/client/game/grid/pageResidency.ts +216 -0
  1840. package/src/client/game/grid/pageShell.ts +67 -0
  1841. package/src/client/game/grid/prefetch.ts +344 -0
  1842. package/src/client/game/grid/prefetchIndex.ts +28 -0
  1843. package/src/client/game/grid/prefetchIndexCore.ts +41 -0
  1844. package/src/client/game/grid/prelinkViews.ts +31 -0
  1845. package/src/client/game/grid/preparationAdmission.ts +34 -0
  1846. package/src/client/game/grid/productInputs.ts +98 -0
  1847. package/src/client/game/grid/productLeases.ts +76 -0
  1848. package/src/client/game/grid/products.ts +350 -0
  1849. package/src/client/game/grid/refusal.ts +73 -0
  1850. package/src/client/game/grid/regionLight.ts +102 -0
  1851. package/src/client/game/grid/regionShell.ts +58 -0
  1852. package/src/client/game/grid/regionSky.ts +104 -0
  1853. package/src/client/game/grid/regionalBuildCheckpoint.ts +19 -0
  1854. package/src/client/game/grid/regionalInputs.ts +34 -0
  1855. package/src/client/game/grid/regionalRuntime.ts +518 -0
  1856. package/src/client/game/grid/regionalView.ts +205 -0
  1857. package/src/client/game/grid/regionalWorld.ts +609 -0
  1858. package/src/client/game/grid/renderResidency.ts +95 -0
  1859. package/src/client/game/grid/reveal.ts +163 -0
  1860. package/src/client/game/grid/roadCull.ts +473 -0
  1861. package/src/client/game/grid/roadGrain.ts +32 -0
  1862. package/src/client/game/grid/roadGrain.worker.ts +20 -0
  1863. package/src/client/game/grid/roadGrainPreparation.ts +45 -0
  1864. package/src/client/game/grid/roadLook.ts +487 -0
  1865. package/src/client/game/grid/roadLookPlatform.ts +196 -0
  1866. package/src/client/game/grid/roadResources.ts +15 -0
  1867. package/src/client/game/grid/roadSign.worker.ts +30 -0
  1868. package/src/client/game/grid/roadSignPaint.ts +38 -0
  1869. package/src/client/game/grid/roadSignPixels.ts +22 -0
  1870. package/src/client/game/grid/roadSignPreparation.ts +45 -0
  1871. package/src/client/game/grid/roadSky.ts +219 -0
  1872. package/src/client/game/grid/roadSolid.ts +227 -0
  1873. package/src/client/game/grid/roadTileArchive.ts +239 -0
  1874. package/src/client/game/grid/roadTileBacking.ts +327 -0
  1875. package/src/client/game/grid/roadTileCapture.worker.ts +14 -0
  1876. package/src/client/game/grid/roadTileCaptureJob.ts +37 -0
  1877. package/src/client/game/grid/roadTileCaptureWorker.ts +104 -0
  1878. package/src/client/game/grid/roadTileCoarse.ts +28 -0
  1879. package/src/client/game/grid/roadTileGeometry.ts +77 -0
  1880. package/src/client/game/grid/roadTilePool.ts +157 -0
  1881. package/src/client/game/grid/roadTileStream.ts +69 -0
  1882. package/src/client/game/grid/roadTileWrite.worker.ts +24 -0
  1883. package/src/client/game/grid/roadTileWriter.ts +67 -0
  1884. package/src/client/game/grid/runtimeCost.ts +44 -0
  1885. package/src/client/game/grid/seamLook.ts +177 -0
  1886. package/src/client/game/grid/session.ts +1235 -0
  1887. package/src/client/game/grid/shardfileFar.ts +88 -0
  1888. package/src/client/game/grid/skinEnvelope.ts +135 -0
  1889. package/src/client/game/grid/softWallLook.ts +116 -0
  1890. package/src/client/game/grid/tileDecodeWorker.ts +24 -0
  1891. package/src/client/game/grid/tileDecoder.ts +102 -0
  1892. package/src/client/game/grid/titleOrder.ts +8 -0
  1893. package/src/client/game/grid/titlePrefetchChoice.ts +35 -0
  1894. package/src/client/game/grid/viewAdmissions.ts +36 -0
  1895. package/src/client/game/grid/voidLook.ts +181 -0
  1896. package/src/client/game/icons.merge.d.ts +49 -0
  1897. package/src/client/game/icons.ts +240 -0
  1898. package/src/client/game/identity.ts +28 -0
  1899. package/src/client/game/inputContexts.ts +33 -0
  1900. package/src/client/game/keyBindings.ts +37 -0
  1901. package/src/client/game/loadout/actors.ts +15 -0
  1902. package/src/client/game/loadout/claims.ts +728 -0
  1903. package/src/client/game/loadout/cosmeticFinishes.ts +217 -0
  1904. package/src/client/game/loadout/effects.ts +97 -0
  1905. package/src/client/game/loadout/finishes.ts +60 -0
  1906. package/src/client/game/loadout/held.ts +207 -0
  1907. package/src/client/game/loadout/rangedPage.ts +142 -0
  1908. package/src/client/game/looks/coverAppearance.ts +101 -0
  1909. package/src/client/game/looks/daySky.ts +110 -0
  1910. package/src/client/game/looks/forestGround.ts +49 -0
  1911. package/src/client/game/looks/forestGroundInputs.ts +27 -0
  1912. package/src/client/game/looks/forestRoofMask.ts +15 -0
  1913. package/src/client/game/looks/forestWeather.ts +26 -0
  1914. package/src/client/game/looks/graphDaySky.ts +245 -0
  1915. package/src/client/game/looks/grassPresentation.ts +334 -0
  1916. package/src/client/game/looks/keyedSky.ts +500 -0
  1917. package/src/client/game/looks/lettering.ts +14 -0
  1918. package/src/client/game/looks/overcast.ts +61 -0
  1919. package/src/client/game/looks/paintedGroundMerge.ts +12 -0
  1920. package/src/client/game/looks/paintedLook.ts +197 -0
  1921. package/src/client/game/looks/painterlyLook.ts +259 -0
  1922. package/src/client/game/looks/posedBufferPool.ts +67 -0
  1923. package/src/client/game/looks/posedInstances.ts +199 -0
  1924. package/src/client/game/looks/postGraphLook.ts +455 -0
  1925. package/src/client/game/looks/riggedHulls.ts +451 -0
  1926. package/src/client/game/looks/scaledPost.ts +236 -0
  1927. package/src/client/game/looks/speciesBook.ts +224 -0
  1928. package/src/client/game/looks/staticCapture.ts +225 -0
  1929. package/src/client/game/looks/streamedCover.ts +330 -0
  1930. package/src/client/game/looks/toonLighting.ts +28 -0
  1931. package/src/client/game/looks/toonLook.ts +69 -0
  1932. package/src/client/game/looks/toonSky.ts +60 -0
  1933. package/src/client/game/looks/vertexWear.ts +49 -0
  1934. package/src/client/game/loot/CoinBurst.ts +19 -0
  1935. package/src/client/game/loot/CoinMotion.ts +169 -0
  1936. package/src/client/game/loot/coinModel.ts +11 -0
  1937. package/src/client/game/loot/coins.ts +21 -0
  1938. package/src/client/game/loot/feed.ts +23 -0
  1939. package/src/client/game/loot/loot.css +19 -0
  1940. package/src/client/game/loot/runtime.ts +243 -0
  1941. package/src/client/game/loot/tables.ts +30 -0
  1942. package/src/client/game/loot/ui/CoinChip.ts +70 -0
  1943. package/src/client/game/loot/ui/ShopPanel.ts +211 -0
  1944. package/src/client/game/loot/ui/shop.css +42 -0
  1945. package/src/client/game/mainMenu.css +177 -0
  1946. package/src/client/game/mainMenu.ts +268 -0
  1947. package/src/client/game/models/binarySource.ts +78 -0
  1948. package/src/client/game/models/collectionDisplay.ts +133 -0
  1949. package/src/client/game/models/collectionWall.ts +236 -0
  1950. package/src/client/game/models/explorerCatalogue.ts +176 -0
  1951. package/src/client/game/models/figureCatalogue.ts +172 -0
  1952. package/src/client/game/models/fixedDraws.ts +178 -0
  1953. package/src/client/game/models/heldGear.ts +76 -0
  1954. package/src/client/game/models/interact.ts +107 -0
  1955. package/src/client/game/models/islandLibrary.ts +179 -0
  1956. package/src/client/game/models/kitFigureCard.ts +77 -0
  1957. package/src/client/game/models/libraryModel.ts +67 -0
  1958. package/src/client/game/models/mountedSpecimen.ts +45 -0
  1959. package/src/client/game/models/pickupRows.ts +12 -0
  1960. package/src/client/game/models/ropeDeckSite.ts +114 -0
  1961. package/src/client/game/models/scenePartSpecimen.ts +102 -0
  1962. package/src/client/game/models/sceneSpecimens.ts +103 -0
  1963. package/src/client/game/models/socketRigCreature.ts +65 -0
  1964. package/src/client/game/models/specimenCatalogue.ts +540 -0
  1965. package/src/client/game/models/treeSet.ts +149 -0
  1966. package/src/client/game/models/worldSceneCatalogue.ts +310 -0
  1967. package/src/client/game/nativeItems.merge.d.ts +6 -0
  1968. package/src/client/game/pageSaveKeys.ts +13 -0
  1969. package/src/client/game/plugin/audio.ts +277 -0
  1970. package/src/client/game/plugin/bakedGeometry.ts +103 -0
  1971. package/src/client/game/plugin/bladeMoves.ts +117 -0
  1972. package/src/client/game/plugin/bossStorm.ts +40 -0
  1973. package/src/client/game/plugin/clientChannelView.ts +135 -0
  1974. package/src/client/game/plugin/context.ts +198 -0
  1975. package/src/client/game/plugin/followedMovers.ts +184 -0
  1976. package/src/client/game/plugin/geometry.ts +2083 -0
  1977. package/src/client/game/plugin/headless.ts +127 -0
  1978. package/src/client/game/plugin/heldEquipment.ts +208 -0
  1979. package/src/client/game/plugin/heldFirearm.ts +395 -0
  1980. package/src/client/game/plugin/heldRecipe.ts +43 -0
  1981. package/src/client/game/plugin/heldTool.ts +166 -0
  1982. package/src/client/game/plugin/moverEvents.merge.d.ts +6 -0
  1983. package/src/client/game/plugin/moverViews.ts +114 -0
  1984. package/src/client/game/plugin/placeholderGeometry.ts +40 -0
  1985. package/src/client/game/plugin/scene.ts +290 -0
  1986. package/src/client/game/plugin/shaderFamily.ts +225 -0
  1987. package/src/client/game/plugin/ui.ts +1511 -0
  1988. package/src/client/game/plugin/weaponFamily.ts +779 -0
  1989. package/src/client/game/population/netCounts.ts +12 -0
  1990. package/src/client/game/population/pageAir.ts +37 -0
  1991. package/src/client/game/population/pageLife.ts +289 -0
  1992. package/src/client/game/population/pageReturns.ts +17 -0
  1993. package/src/client/game/population/productCreatures.ts +71 -0
  1994. package/src/client/game/population/projection.ts +227 -0
  1995. package/src/client/game/population/rowSpecies.ts +15 -0
  1996. package/src/client/game/population/signals.ts +24 -0
  1997. package/src/client/game/population/speciesViewSlots.ts +55 -0
  1998. package/src/client/game/population/wildlifeFeature.ts +208 -0
  1999. package/src/client/game/population.merge.d.ts +9 -0
  2000. package/src/client/game/practice/course.ts +154 -0
  2001. package/src/client/game/practice/numericCourse.ts +35 -0
  2002. package/src/client/game/practice/registration.ts +17 -0
  2003. package/src/client/game/practice/scene.ts +47 -0
  2004. package/src/client/game/quest/carriedProp.ts +113 -0
  2005. package/src/client/game/quest/chapter.ts +355 -0
  2006. package/src/client/game/quest/chapterDirector.ts +255 -0
  2007. package/src/client/game/quest/chapterView.ts +165 -0
  2008. package/src/client/game/quest/continuation.ts +53 -0
  2009. package/src/client/game/quest/contractBoardPage.ts +85 -0
  2010. package/src/client/game/quest/declaredPage.ts +199 -0
  2011. package/src/client/game/quest/elitePage.ts +115 -0
  2012. package/src/client/game/quest/figureOrbit.ts +32 -0
  2013. package/src/client/game/quest/figures.ts +259 -0
  2014. package/src/client/game/quest/finishedAfterSeen.ts +20 -0
  2015. package/src/client/game/quest/hints.ts +90 -0
  2016. package/src/client/game/quest/pageComposition.ts +331 -0
  2017. package/src/client/game/quest/pageDoors.ts +25 -0
  2018. package/src/client/game/quest/pageFacets.ts +76 -0
  2019. package/src/client/game/quest/pageReference.ts +17 -0
  2020. package/src/client/game/quest/presentation.css +4 -0
  2021. package/src/client/game/quest/questPageViews.ts +168 -0
  2022. package/src/client/game/quest/reward.ts +48 -0
  2023. package/src/client/game/quest/story.ts +161 -0
  2024. package/src/client/game/quest/trader.ts +176 -0
  2025. package/src/client/game/riding/client.ts +373 -0
  2026. package/src/client/game/riding/hud.ts +255 -0
  2027. package/src/client/game/riding/mount.ts +317 -0
  2028. package/src/client/game/riding/reins.ts +177 -0
  2029. package/src/client/game/riding/ride.css +70 -0
  2030. package/src/client/game/riding/seatedFigure.ts +78 -0
  2031. package/src/client/game/saves.css +34 -0
  2032. package/src/client/game/savesSettings.ts +189 -0
  2033. package/src/client/game/session/clockSettings.ts +66 -0
  2034. package/src/client/game/session/context.ts +61 -0
  2035. package/src/client/game/session/crashResume.ts +36 -0
  2036. package/src/client/game/session/data.ts +101 -0
  2037. package/src/client/game/session/entryReadiness.ts +13 -0
  2038. package/src/client/game/session/exitToTitle.ts +19 -0
  2039. package/src/client/game/session/finish.ts +414 -0
  2040. package/src/client/game/session/hudAccent.ts +30 -0
  2041. package/src/client/game/session/loadout.ts +176 -0
  2042. package/src/client/game/session/play.ts +824 -0
  2043. package/src/client/game/session/positions.ts +8 -0
  2044. package/src/client/game/session/readyFrame.ts +10 -0
  2045. package/src/client/game/session/session.ts +193 -0
  2046. package/src/client/game/session/settlePrograms.ts +29 -0
  2047. package/src/client/game/session/titlePreparation.ts +43 -0
  2048. package/src/client/game/session/world.ts +168 -0
  2049. package/src/client/game/shard/declaredEntry.ts +44 -0
  2050. package/src/client/game/shard/declaredPlumbing.ts +80 -0
  2051. package/src/client/game/shard/declaredTargets.ts +64 -0
  2052. package/src/client/game/shard/declaredUi.ts +23 -0
  2053. package/src/client/game/shard/discovery.ts +80 -0
  2054. package/src/client/game/shard/list.ts +26 -0
  2055. package/src/client/game/shard/load.ts +94 -0
  2056. package/src/client/game/shard/manifest.ts +910 -0
  2057. package/src/client/game/shard/pageBoot.ts +52 -0
  2058. package/src/client/game/shard/pagePolicy.ts +17 -0
  2059. package/src/client/game/shard/registry.ts +74 -0
  2060. package/src/client/game/shard/retainedHooks.ts +204 -0
  2061. package/src/client/game/shard/scopedRuntime.ts +68 -0
  2062. package/src/client/game/shard/spec.ts +69 -0
  2063. package/src/client/game/shard/titleList.ts +86 -0
  2064. package/src/client/game/shardfile/accent.ts +5 -0
  2065. package/src/client/game/shardfile/assetCache.ts +46 -0
  2066. package/src/client/game/shardfile/audioCatalogue.ts +16 -0
  2067. package/src/client/game/shardfile/bakedKinds.ts +313 -0
  2068. package/src/client/game/shardfile/bakedTiles.ts +253 -0
  2069. package/src/client/game/shardfile/buildingCloud.ts +27 -0
  2070. package/src/client/game/shardfile/calibrationScripts.ts +30 -0
  2071. package/src/client/game/shardfile/caveInterior.ts +162 -0
  2072. package/src/client/game/shardfile/client.ts +671 -0
  2073. package/src/client/game/shardfile/clientAmbientLife.ts +31 -0
  2074. package/src/client/game/shardfile/clientAssets.ts +163 -0
  2075. package/src/client/game/shardfile/clientBossFight.ts +39 -0
  2076. package/src/client/game/shardfile/clientBossTelegraph.ts +43 -0
  2077. package/src/client/game/shardfile/clientCatalogue.ts +44 -0
  2078. package/src/client/game/shardfile/clientCosmeticFinishes.ts +37 -0
  2079. package/src/client/game/shardfile/clientCues.ts +22 -0
  2080. package/src/client/game/shardfile/clientEliteConstruction.ts +44 -0
  2081. package/src/client/game/shardfile/clientEliteEntry.ts +33 -0
  2082. package/src/client/game/shardfile/clientEntryBinds.ts +32 -0
  2083. package/src/client/game/shardfile/clientFinds.ts +20 -0
  2084. package/src/client/game/shardfile/clientForestPage.ts +144 -0
  2085. package/src/client/game/shardfile/clientGraphs.ts +319 -0
  2086. package/src/client/game/shardfile/clientHeldMelee.ts +82 -0
  2087. package/src/client/game/shardfile/clientItems.ts +25 -0
  2088. package/src/client/game/shardfile/clientLibrary.ts +71 -0
  2089. package/src/client/game/shardfile/clientMaterials.ts +296 -0
  2090. package/src/client/game/shardfile/clientMeadow.ts +30 -0
  2091. package/src/client/game/shardfile/clientModules.ts +24 -0
  2092. package/src/client/game/shardfile/clientMoverOwners.ts +80 -0
  2093. package/src/client/game/shardfile/clientNativeBook.ts +38 -0
  2094. package/src/client/game/shardfile/clientPlaceSets.ts +74 -0
  2095. package/src/client/game/shardfile/clientPlan.ts +529 -0
  2096. package/src/client/game/shardfile/clientPlayerEnter.ts +22 -0
  2097. package/src/client/game/shardfile/clientPopulation.ts +49 -0
  2098. package/src/client/game/shardfile/clientPopulationProjection.ts +28 -0
  2099. package/src/client/game/shardfile/clientPost.ts +94 -0
  2100. package/src/client/game/shardfile/clientPropMaterials.ts +100 -0
  2101. package/src/client/game/shardfile/clientQuestComposition.ts +87 -0
  2102. package/src/client/game/shardfile/clientQuestPage.ts +98 -0
  2103. package/src/client/game/shardfile/clientRecipes.ts +76 -0
  2104. package/src/client/game/shardfile/clientResidency.ts +29 -0
  2105. package/src/client/game/shardfile/clientReturnModules.ts +25 -0
  2106. package/src/client/game/shardfile/clientRuntimeHooks.ts +66 -0
  2107. package/src/client/game/shardfile/clientSceneHandles.ts +19 -0
  2108. package/src/client/game/shardfile/clientScripts.ts +100 -0
  2109. package/src/client/game/shardfile/clientSkins.ts +183 -0
  2110. package/src/client/game/shardfile/clientSource.ts +221 -0
  2111. package/src/client/game/shardfile/clientSpeciesProgram.ts +45 -0
  2112. package/src/client/game/shardfile/clientSplatTerrain.ts +99 -0
  2113. package/src/client/game/shardfile/clientStealthEntry.ts +72 -0
  2114. package/src/client/game/shardfile/clientTargets.ts +73 -0
  2115. package/src/client/game/shardfile/clientTimedEncounters.ts +42 -0
  2116. package/src/client/game/shardfile/clientTrails.ts +42 -0
  2117. package/src/client/game/shardfile/clientViewProgram.ts +101 -0
  2118. package/src/client/game/shardfile/clientViews.ts +211 -0
  2119. package/src/client/game/shardfile/clientWater.ts +108 -0
  2120. package/src/client/game/shardfile/clientWaterSurfaces.ts +88 -0
  2121. package/src/client/game/shardfile/clientWorker.ts +621 -0
  2122. package/src/client/game/shardfile/clientWorldAssembly.ts +129 -0
  2123. package/src/client/game/shardfile/constructionCheckpoint.ts +31 -0
  2124. package/src/client/game/shardfile/controlFiles.ts +41 -0
  2125. package/src/client/game/shardfile/controlRefinement.ts +229 -0
  2126. package/src/client/game/shardfile/declaredTalks.ts +114 -0
  2127. package/src/client/game/shardfile/emptyEquipment.ts +19 -0
  2128. package/src/client/game/shardfile/emptyLook.ts +26 -0
  2129. package/src/client/game/shardfile/enteredTileReadout.ts +27 -0
  2130. package/src/client/game/shardfile/entryTransport.ts +222 -0
  2131. package/src/client/game/shardfile/farStandIn.ts +79 -0
  2132. package/src/client/game/shardfile/forestPage.ts +289 -0
  2133. package/src/client/game/shardfile/groundMerge.ts +232 -0
  2134. package/src/client/game/shardfile/heldClaimsEntry.ts +34 -0
  2135. package/src/client/game/shardfile/homeBuildCache.ts +114 -0
  2136. package/src/client/game/shardfile/homeGeometrySnapshot.ts +92 -0
  2137. package/src/client/game/shardfile/hybrid.ts +537 -0
  2138. package/src/client/game/shardfile/hybridPresentation.ts +16 -0
  2139. package/src/client/game/shardfile/islandBook.ts +87 -0
  2140. package/src/client/game/shardfile/itemModels.ts +78 -0
  2141. package/src/client/game/shardfile/legacyAsset.ts +30 -0
  2142. package/src/client/game/shardfile/lentLooks.ts +210 -0
  2143. package/src/client/game/shardfile/lightEmitters.ts +100 -0
  2144. package/src/client/game/shardfile/livingBuildings.ts +202 -0
  2145. package/src/client/game/shardfile/look.ts +23 -0
  2146. package/src/client/game/shardfile/mapImage.ts +49 -0
  2147. package/src/client/game/shardfile/pageItems.ts +57 -0
  2148. package/src/client/game/shardfile/pagePreparation.ts +40 -0
  2149. package/src/client/game/shardfile/pageWater.ts +29 -0
  2150. package/src/client/game/shardfile/paintedWorldStages.ts +132 -0
  2151. package/src/client/game/shardfile/portalRideBinding.ts +62 -0
  2152. package/src/client/game/shardfile/preparationReads.ts +61 -0
  2153. package/src/client/game/shardfile/preparationTiming.ts +115 -0
  2154. package/src/client/game/shardfile/presentation.ts +36 -0
  2155. package/src/client/game/shardfile/product.ts +718 -0
  2156. package/src/client/game/shardfile/productCacheCompletion.ts +53 -0
  2157. package/src/client/game/shardfile/productChecks.ts +40 -0
  2158. package/src/client/game/shardfile/productCost.ts +422 -0
  2159. package/src/client/game/shardfile/productGround.ts +60 -0
  2160. package/src/client/game/shardfile/productNavigation.ts +18 -0
  2161. package/src/client/game/shardfile/productPreflight.ts +12 -0
  2162. package/src/client/game/shardfile/questWorld.ts +17 -0
  2163. package/src/client/game/shardfile/readAsset.ts +44 -0
  2164. package/src/client/game/shardfile/reusableWholeLibrary.ts +102 -0
  2165. package/src/client/game/shardfile/runtimeProduct.ts +396 -0
  2166. package/src/client/game/shardfile/sceneBakeFiles.ts +22 -0
  2167. package/src/client/game/shardfile/sceneBuffers.ts +207 -0
  2168. package/src/client/game/shardfile/sceneDraws.ts +90 -0
  2169. package/src/client/game/shardfile/sceneDressing.ts +456 -0
  2170. package/src/client/game/shardfile/sceneHandles.ts +170 -0
  2171. package/src/client/game/shardfile/sceneInputs.ts +21 -0
  2172. package/src/client/game/shardfile/sceneInstances.ts +67 -0
  2173. package/src/client/game/shardfile/sceneMotion.ts +161 -0
  2174. package/src/client/game/shardfile/scenePools.ts +40 -0
  2175. package/src/client/game/shardfile/sceneProfile.ts +12 -0
  2176. package/src/client/game/shardfile/sceneRigFiles.ts +30 -0
  2177. package/src/client/game/shardfile/sceneScatterPages.ts +47 -0
  2178. package/src/client/game/shardfile/sceneSources.ts +153 -0
  2179. package/src/client/game/shardfile/serverRoute.ts +38 -0
  2180. package/src/client/game/shardfile/skinLayerPlayback.ts +67 -0
  2181. package/src/client/game/shardfile/skinPlayback.ts +138 -0
  2182. package/src/client/game/shardfile/slabLibrary.ts +203 -0
  2183. package/src/client/game/shardfile/stillImage.ts +19 -0
  2184. package/src/client/game/shardfile/streamingView.ts +78 -0
  2185. package/src/client/game/shardfile/tileBufferedDraws.ts +49 -0
  2186. package/src/client/game/shardfile/tileContent.ts +564 -0
  2187. package/src/client/game/shardfile/tileDriver.ts +462 -0
  2188. package/src/client/game/shardfile/tileEntry.ts +18 -0
  2189. package/src/client/game/shardfile/tiledMesh.ts +146 -0
  2190. package/src/client/game/shardfile/water.ts +8 -0
  2191. package/src/client/game/shardfile/weatherFields.ts +31 -0
  2192. package/src/client/game/shardfile/wholeGeometryPieces.ts +101 -0
  2193. package/src/client/game/shardfile/wholeLibrary.ts +47 -0
  2194. package/src/client/game/shardfile/wholeRefinementCover.ts +78 -0
  2195. package/src/client/game/shardfile/wirePage.ts +260 -0
  2196. package/src/client/game/shardfile/worldAssembly.ts +531 -0
  2197. package/src/client/game/shardfile/worldBuildYield.ts +10 -0
  2198. package/src/client/game/shardfile/worldEntry.ts +117 -0
  2199. package/src/client/game/shardfile/worldSceneBatch.ts +105 -0
  2200. package/src/client/game/shardfile/worldSceneGeometry.ts +171 -0
  2201. package/src/client/game/shardfile/worldSceneMaterials.ts +90 -0
  2202. package/src/client/game/shardfile/worldScenePlacement.ts +364 -0
  2203. package/src/client/game/shardfile/worldScenePlacementPages.ts +61 -0
  2204. package/src/client/game/shardfile/worldSceneReads.ts +83 -0
  2205. package/src/client/game/shardfile/worldSceneStepSources.ts +69 -0
  2206. package/src/client/game/shardfile/worldSceneSurface.ts +108 -0
  2207. package/src/client/game/shardfile/worldSceneTextures.ts +134 -0
  2208. package/src/client/game/shardfile/worldSceneUniforms.ts +17 -0
  2209. package/src/client/game/shardfile/worldSceneWeld.ts +339 -0
  2210. package/src/client/game/shardfile/worldScenes.ts +760 -0
  2211. package/src/client/game/shardfile/worldUpdates.ts +149 -0
  2212. package/src/client/game/stealth/controller.ts +115 -0
  2213. package/src/client/game/stealth/stealth.css +70 -0
  2214. package/src/client/game/summary.css +8 -0
  2215. package/src/client/game/summary.ts +67 -0
  2216. package/src/client/game/systems/audio/crossbowSounds.ts +71 -0
  2217. package/src/client/game/systems/audio/firearmSounds.ts +43 -0
  2218. package/src/client/game/systems/audio/meleeSounds.ts +40 -0
  2219. package/src/client/game/systems/audio/silentScore.ts +6 -0
  2220. package/src/client/game/systems/effects/starter.generated.ts +2 -0
  2221. package/src/client/game/systems/effects/status.css +3 -0
  2222. package/src/client/game/systems/effects/view.ts +35 -0
  2223. package/src/client/game/systems/items/declaredSword.ts +149 -0
  2224. package/src/client/game/systems/looks/fogProgram.ts +18 -0
  2225. package/src/client/game/systems/looks/particles.ts +407 -0
  2226. package/src/client/game/systems/looks/rainCurtain.ts +50 -0
  2227. package/src/client/game/systems/looks/surfaceLooks.ts +138 -0
  2228. package/src/client/game/systems/looks/trample.ts +139 -0
  2229. package/src/client/game/systems/looks/waterSurface.ts +179 -0
  2230. package/src/client/game/systems/npc/figureRows.ts +169 -0
  2231. package/src/client/game/systems/npc/figureSkins.ts +130 -0
  2232. package/src/client/game/systems/npc/kitFigure.ts +127 -0
  2233. package/src/client/game/systems/npc/npcRig.ts +217 -0
  2234. package/src/client/game/systems/npc/standingFigure.ts +111 -0
  2235. package/src/client/game/systems/props/interact.ts +236 -0
  2236. package/src/client/game/systems/species/bear.ts +30 -0
  2237. package/src/client/game/systems/species/boar.ts +28 -0
  2238. package/src/client/game/systems/species/install.ts +18 -0
  2239. package/src/client/game/systems/species/view/bear.ts +246 -0
  2240. package/src/client/game/systems/species/view/boar.ts +249 -0
  2241. package/src/client/game/systems/tools/hoverboard.ts +107 -0
  2242. package/src/client/game/systems/viewmodel/armAliases.json +24 -0
  2243. package/src/client/game/systems/viewmodel/armClips.ts +8 -0
  2244. package/src/client/game/systems/viewmodel/armRig.ts +293 -0
  2245. package/src/client/game/systems/viewmodel/clips.generated.ts +2 -0
  2246. package/src/client/game/systems/viewmodel/heldView.ts +458 -0
  2247. package/src/client/game/systems/viewmodel/rigArms.ts +280 -0
  2248. package/src/client/game/titleAssets.ts +9 -0
  2249. package/src/client/game/titleDeck.ts +381 -0
  2250. package/src/client/game/travel/travel.ts +99 -0
  2251. package/src/client/game/ui/dataPanels.ts +95 -0
  2252. package/src/client/game/ui/panelTemplates.ts +71 -0
  2253. package/src/client/game/ui/panels.ts +109 -0
  2254. package/src/client/game/upgrade.css +12 -0
  2255. package/src/client/game/weapons/Bow.ts +14 -0
  2256. package/src/client/game/weapons/Sword.ts +30 -0
  2257. package/src/client/game/weapons/arcPower.ts +203 -0
  2258. package/src/client/game/weapons/heldLauncher.ts +452 -0
  2259. package/src/client/game/weapons/heldPolearm.ts +491 -0
  2260. package/src/client/game/weapons/mountedBlade.ts +122 -0
  2261. package/src/client/game/weather/forest.ts +281 -0
  2262. package/src/client/game/weather/netClimate.ts +88 -0
  2263. package/src/client/game/weather/pageSky.ts +31 -0
  2264. package/src/client/game/weather/rainPresentation.ts +246 -0
  2265. package/src/client/game/weather/weatherEvents.merge.d.ts +8 -0
  2266. package/src/client/game/whatsNew.ts +31 -0
  2267. package/src/client/game/whatsNewBanner.ts +125 -0
  2268. package/src/client/host/online/chatCorner.ts +46 -0
  2269. package/src/client/host/online/chatLines.ts +213 -0
  2270. package/src/client/host/online/doctor.ts +321 -0
  2271. package/src/client/host/online/doctorPage.ts +26 -0
  2272. package/src/client/host/online/doctorView.ts +144 -0
  2273. package/src/client/host/online/linkScreens.ts +300 -0
  2274. package/src/client/host/online/reconnectStrip.ts +26 -0
  2275. package/src/client/host/online/release.ts +28 -0
  2276. package/src/client/host/online/shell.ts +312 -0
  2277. package/src/client/host/online/voice.ts +468 -0
  2278. package/src/client/host/online/voiceUi.ts +186 -0
  2279. package/src/client/host/standalone/shell.ts +169 -0
  2280. package/src/client/index.html +12 -0
  2281. package/src/client/main.tsx +10 -0
  2282. package/src/client/side.ts +2 -0
  2283. package/src/client/tsconfig.json +13 -0
  2284. package/src/cook/game/brotliSizeCache.d.mts +5 -0
  2285. package/src/cook/game/brotliSizeCache.mjs +59 -0
  2286. package/src/cook/game/contentNamed.ts +6 -0
  2287. package/src/cook/game/cookJob.ts +103 -0
  2288. package/src/cook/game/cookWorker.ts +413 -0
  2289. package/src/cook/game/encodedBytes.ts +51 -0
  2290. package/src/cook/game/engineHalf.ts +47 -0
  2291. package/src/cook/game/entryDownloads.ts +36 -0
  2292. package/src/cook/game/entryReadSet.ts +67 -0
  2293. package/src/cook/game/entryTotals.ts +320 -0
  2294. package/src/cook/game/fenceReads.ts +218 -0
  2295. package/src/cook/game/gridCollision.ts +53 -0
  2296. package/src/cook/game/gridEntryDownloads.ts +33 -0
  2297. package/src/cook/game/gridStripPages.ts +239 -0
  2298. package/src/cook/game/installedRuntimeReads.ts +48 -0
  2299. package/src/cook/game/packStore.ts +120 -0
  2300. package/src/cook/game/portableEncode.ts +7 -0
  2301. package/src/cook/game/productTarball.ts +18 -0
  2302. package/src/cook/game/shardCook.ts +350 -0
  2303. package/src/cook/game/spawnParts.ts +294 -0
  2304. package/src/cook/game/stripPack.ts +31 -0
  2305. package/src/cook/side.ts +2 -0
  2306. package/src/e2e/playwright.config.ts +60 -0
  2307. package/src/e2e/smoke/game.ts +217 -0
  2308. package/src/e2e/smoke/page-globals.d.ts +37 -0
  2309. package/src/e2e/smoke/template2.spec.ts +146 -0
  2310. package/src/e2e/status.spec.ts +13 -0
  2311. package/src/scripts/ask-new.sh +29 -0
  2312. package/src/scripts/asks.mjs +142 -0
  2313. package/src/scripts/check-sides.mjs +70 -0
  2314. package/src/scripts/herdr-prompt.sh +34 -0
  2315. package/src/scripts/herdr-question-open.sh +67 -0
  2316. package/src/scripts/md-wrap.mjs +229 -0
  2317. package/src/server/app.ts +19 -0
  2318. package/src/server/engine/ai/CreatureBrain.ts +23 -0
  2319. package/src/server/engine/ai/bossContenders.ts +101 -0
  2320. package/src/server/engine/ai/burstFlyer.ts +31 -0
  2321. package/src/server/engine/ai/challengeGrazer.ts +31 -0
  2322. package/src/server/engine/ai/eliteContinuation.ts +141 -0
  2323. package/src/server/engine/ai/eliteKernels.ts +187 -0
  2324. package/src/server/engine/ai/eliteLifecycle.ts +126 -0
  2325. package/src/server/engine/ai/eliteRoster.ts +357 -0
  2326. package/src/server/engine/ai/grazer.ts +1360 -0
  2327. package/src/server/engine/ai/guardian.ts +20 -0
  2328. package/src/server/engine/ai/guardianPolicy.ts +264 -0
  2329. package/src/server/engine/ai/herd.ts +17 -0
  2330. package/src/server/engine/ai/hunt.ts +46 -0
  2331. package/src/server/engine/ai/moves.ts +202 -0
  2332. package/src/server/engine/ai/orbitDiver.ts +33 -0
  2333. package/src/server/engine/ai/pack.ts +29 -0
  2334. package/src/server/engine/ai/patrolDiver.ts +31 -0
  2335. package/src/server/engine/ai/perchHunter.ts +20 -0
  2336. package/src/server/engine/ai/phases.ts +121 -0
  2337. package/src/server/engine/ai/platform.ts +140 -0
  2338. package/src/server/engine/ai/ramGrazer.ts +31 -0
  2339. package/src/server/engine/ai/scriptBrain.ts +147 -0
  2340. package/src/server/engine/ai/skirmisher.ts +20 -0
  2341. package/src/server/engine/ai/species.ts +33 -0
  2342. package/src/server/engine/combat/EquipmentPickup.ts +28 -0
  2343. package/src/server/engine/combat/contactWeapon.ts +251 -0
  2344. package/src/server/engine/combat/damageBook.ts +45 -0
  2345. package/src/server/engine/combat/rewind.ts +7 -0
  2346. package/src/server/engine/entities/AnimalManager.ts +752 -0
  2347. package/src/server/engine/entities/bodyClear.ts +47 -0
  2348. package/src/server/engine/entities/creatureRefill.ts +119 -0
  2349. package/src/server/engine/entities/killHeight.ts +18 -0
  2350. package/src/server/engine/level/context.ts +111 -0
  2351. package/src/server/engine/net/chat.ts +97 -0
  2352. package/src/server/engine/net/combatWire.ts +49 -0
  2353. package/src/server/engine/net/commandQueue.ts +95 -0
  2354. package/src/server/engine/net/handles.ts +74 -0
  2355. package/src/server/engine/net/hitHistory.ts +114 -0
  2356. package/src/server/engine/net/ledgerBook.ts +65 -0
  2357. package/src/server/engine/net/room.ts +560 -0
  2358. package/src/server/engine/net/serverClock.ts +43 -0
  2359. package/src/server/engine/net/simWorld.ts +131 -0
  2360. package/src/server/engine/net/tiers.ts +14 -0
  2361. package/src/server/engine/physics/edgeEntries.ts +40 -0
  2362. package/src/server/engine/physics/rapierBindings.ts +4 -0
  2363. package/src/server/engine/saves/forwardedStorage.ts +43 -0
  2364. package/src/server/engine/script/composition.ts +219 -0
  2365. package/src/server/engine/script/decision.ts +573 -0
  2366. package/src/server/engine/script/inputInboxV2.ts +116 -0
  2367. package/src/server/engine/script/lane.ts +185 -0
  2368. package/src/server/engine/script/ownedSimBatchV2.ts +205 -0
  2369. package/src/server/engine/script/queries.ts +37 -0
  2370. package/src/server/engine/script/queriesV2.ts +149 -0
  2371. package/src/server/engine/script/simBatchV2.ts +125 -0
  2372. package/src/server/engine/sim/playerSim.ts +443 -0
  2373. package/src/server/engine/sim/respawn.ts +74 -0
  2374. package/src/server/engine/sim/restore.ts +37 -0
  2375. package/src/server/engine/sim.ts +711 -0
  2376. package/src/server/game/animation/limbPopulation.ts +138 -0
  2377. package/src/server/game/bake/entryways.ts +186 -0
  2378. package/src/server/game/boss/arenaRoomEntry.ts +97 -0
  2379. package/src/server/game/boss/arenaRoomFight.ts +103 -0
  2380. package/src/server/game/boss/arenaRoomNative.ts +142 -0
  2381. package/src/server/game/boss/arenaWords.ts +46 -0
  2382. package/src/server/game/boss/bounty.ts +37 -0
  2383. package/src/server/game/boss/captainNative.ts +122 -0
  2384. package/src/server/game/boss/continuation.ts +37 -0
  2385. package/src/server/game/boss/headlessArenaPose.ts +40 -0
  2386. package/src/server/game/boss/headlessArenaViews.ts +54 -0
  2387. package/src/server/game/boss/headlessCloudBody.ts +93 -0
  2388. package/src/server/game/boss/native.ts +220 -0
  2389. package/src/server/game/boss/nativeArenaSand.ts +93 -0
  2390. package/src/server/game/boss/nativeArenaSeal.ts +26 -0
  2391. package/src/server/game/boss/nativeWake.ts +50 -0
  2392. package/src/server/game/boss/openArenaNative.ts +200 -0
  2393. package/src/server/game/boss/openArenaRoom.ts +69 -0
  2394. package/src/server/game/boss/openArenaState.ts +25 -0
  2395. package/src/server/game/boss/patrolNative.ts +286 -0
  2396. package/src/server/game/boss/roaming.ts +77 -0
  2397. package/src/server/game/boss/slotHeights.ts +103 -0
  2398. package/src/server/game/boss/slotsNative.ts +175 -0
  2399. package/src/server/game/boss/windEliteNative.ts +139 -0
  2400. package/src/server/game/grapple/native.ts +181 -0
  2401. package/src/server/game/grid/durability.ts +166 -0
  2402. package/src/server/game/grid/room.ts +53 -0
  2403. package/src/server/game/grid/roomNet.ts +85 -0
  2404. package/src/server/game/grid/simulation.ts +345 -0
  2405. package/src/server/game/items.merge.d.ts +7 -0
  2406. package/src/server/game/loadout/nativeAmmunition.ts +139 -0
  2407. package/src/server/game/loadout/ownedEffects.ts +68 -0
  2408. package/src/server/game/loot/harvest.ts +43 -0
  2409. package/src/server/game/loot/personal.ts +70 -0
  2410. package/src/server/game/loot/playerOwned.ts +235 -0
  2411. package/src/server/game/plugin/bossPhase.ts +904 -0
  2412. package/src/server/game/plugin/brain.ts +1325 -0
  2413. package/src/server/game/plugin/mover.ts +601 -0
  2414. package/src/server/game/plugin/nativeItems.ts +437 -0
  2415. package/src/server/game/plugin/nativeRewind.ts +37 -0
  2416. package/src/server/game/plugin/nativeSwept.ts +249 -0
  2417. package/src/server/game/plugin/playerSeats.ts +62 -0
  2418. package/src/server/game/plugin/scriptSeats.ts +89 -0
  2419. package/src/server/game/plugin/simulation.ts +1623 -0
  2420. package/src/server/game/population/actorProjectionV2.ts +276 -0
  2421. package/src/server/game/population/actors.ts +136 -0
  2422. package/src/server/game/population/directedLaw.ts +69 -0
  2423. package/src/server/game/population/encounterBook.ts +78 -0
  2424. package/src/server/game/population/encounterIntake.ts +78 -0
  2425. package/src/server/game/population/environment.ts +86 -0
  2426. package/src/server/game/population/mixedRoster.ts +353 -0
  2427. package/src/server/game/population/nativeBake.ts +202 -0
  2428. package/src/server/game/population/nativeManager.ts +426 -0
  2429. package/src/server/game/population/nativeReturns.ts +99 -0
  2430. package/src/server/game/population/perchBody.ts +97 -0
  2431. package/src/server/game/population/projectedSites.ts +41 -0
  2432. package/src/server/game/population/relations.ts +45 -0
  2433. package/src/server/game/population/roster.ts +259 -0
  2434. package/src/server/game/population/scriptStrikes.ts +67 -0
  2435. package/src/server/game/population/shelter.ts +193 -0
  2436. package/src/server/game/population/signals.ts +9 -0
  2437. package/src/server/game/population/spawnScript.ts +797 -0
  2438. package/src/server/game/population/specCatalogue.ts +11 -0
  2439. package/src/server/game/quest/bodyOps.ts +253 -0
  2440. package/src/server/game/quest/chapterRecords.ts +97 -0
  2441. package/src/server/game/quest/eliteDrops.ts +36 -0
  2442. package/src/server/game/quest/eliteFeature.ts +141 -0
  2443. package/src/server/game/quest/killSteps.ts +34 -0
  2444. package/src/server/game/quest/nativeBodyScripts.ts +29 -0
  2445. package/src/server/game/quest/nativeChapter.ts +80 -0
  2446. package/src/server/game/quest/nativeComposition.ts +548 -0
  2447. package/src/server/game/quest/nativeEntry.ts +128 -0
  2448. package/src/server/game/quest/nativeInputs.ts +29 -0
  2449. package/src/server/game/quest/nativeSecret.ts +80 -0
  2450. package/src/server/game/quest/serverChapters.ts +192 -0
  2451. package/src/server/game/quest/serverDoors.ts +89 -0
  2452. package/src/server/game/quest/serverPlaces.ts +32 -0
  2453. package/src/server/game/riding/native.ts +362 -0
  2454. package/src/server/game/riding/nativePopulation.ts +384 -0
  2455. package/src/server/game/riding/nativeTaming.ts +331 -0
  2456. package/src/server/game/riding/pastureController.ts +131 -0
  2457. package/src/server/game/riding/roster.ts +108 -0
  2458. package/src/server/game/riding/wildRefill.ts +37 -0
  2459. package/src/server/game/roomRespawn.ts +60 -0
  2460. package/src/server/game/shard/declaredEncounters.ts +22 -0
  2461. package/src/server/game/shard/manifest-closure.generated.json +683 -0
  2462. package/src/server/game/shard/portShares.generated.ts +2 -0
  2463. package/src/server/game/shard/world.ts +5 -0
  2464. package/src/server/game/shardfile/borrowedDecisions.ts +281 -0
  2465. package/src/server/game/shardfile/bossRow.ts +236 -0
  2466. package/src/server/game/shardfile/brainRuntime.ts +162 -0
  2467. package/src/server/game/shardfile/decisions.ts +597 -0
  2468. package/src/server/game/shardfile/declaredClimate.ts +22 -0
  2469. package/src/server/game/shardfile/declaredKitItems.ts +243 -0
  2470. package/src/server/game/shardfile/declaredTalks.ts +52 -0
  2471. package/src/server/game/shardfile/groupRuntime.ts +302 -0
  2472. package/src/server/game/shardfile/homeKeeper.ts +565 -0
  2473. package/src/server/game/shardfile/nativeAssembly.ts +102 -0
  2474. package/src/server/game/shardfile/nativeAssemblyHosts.ts +301 -0
  2475. package/src/server/game/shardfile/nativeAssemblyInput.ts +68 -0
  2476. package/src/server/game/shardfile/nativePlan.ts +28 -0
  2477. package/src/server/game/shardfile/nativeRuntimeLoans.ts +52 -0
  2478. package/src/server/game/shardfile/phasedBossRoaming.ts +427 -0
  2479. package/src/server/game/shardfile/portalLinkProof.ts +66 -0
  2480. package/src/server/game/shardfile/scriptComposition.ts +57 -0
  2481. package/src/server/game/shardfile/scripts.ts +56 -0
  2482. package/src/server/game/shardfile/statusEffects.ts +68 -0
  2483. package/src/server/game/stealth/nativeStealth.ts +74 -0
  2484. package/src/server/game/weapons/nativeHeld.ts +333 -0
  2485. package/src/server/game/weather/continuation.ts +97 -0
  2486. package/src/server/game/weather/reactions.ts +219 -0
  2487. package/src/server/game/weather/wire.ts +42 -0
  2488. package/src/server/host/bake/headlessWorker.ts +132 -0
  2489. package/src/server/host/dedicated/cellHost.ts +171 -0
  2490. package/src/server/host/dedicated/cellProtocol.ts +64 -0
  2491. package/src/server/host/dedicated/cellWorker.ts +33 -0
  2492. package/src/server/host/dedicated/crossing.ts +44 -0
  2493. package/src/server/host/dedicated/dedicatedRoom.ts +419 -0
  2494. package/src/server/host/dedicated/doorTrust.ts +55 -0
  2495. package/src/server/host/dedicated/gridCells.ts +53 -0
  2496. package/src/server/host/dedicated/main.ts +134 -0
  2497. package/src/server/host/dedicated/packReader.ts +68 -0
  2498. package/src/server/host/dedicated/playerDoc.ts +96 -0
  2499. package/src/server/host/dedicated/playerSaves.ts +62 -0
  2500. package/src/server/host/dedicated/playerStore.ts +82 -0
  2501. package/src/server/host/dedicated/playtest.ts +41 -0
  2502. package/src/server/host/dedicated/releaseFile.ts +71 -0
  2503. package/src/server/host/dedicated/roadRoom.ts +151 -0
  2504. package/src/server/host/dedicated/saves/database.ts +15 -0
  2505. package/src/server/host/dedicated/saves/migrate.ts +26 -0
  2506. package/src/server/host/dedicated/saves/migrations/0001-saves.sql +48 -0
  2507. package/src/server/host/dedicated/saves/migrations/0002-report-delivery.sql +3 -0
  2508. package/src/server/host/dedicated/saves/migrations/0003-place.sql +11 -0
  2509. package/src/server/host/dedicated/saves/migrations/0004-names.sql +4 -0
  2510. package/src/server/host/dedicated/saves/migrations/0005-profile.sql +41 -0
  2511. package/src/server/host/dedicated/saves/names.ts +56 -0
  2512. package/src/server/host/dedicated/saves/pgDatabase.ts +43 -0
  2513. package/src/server/host/dedicated/saves/profile.ts +44 -0
  2514. package/src/server/host/dedicated/saves/reportQueue.ts +49 -0
  2515. package/src/server/host/dedicated/saves/saveStore.ts +117 -0
  2516. package/src/server/host/dedicated/saves/writeQueue.ts +94 -0
  2517. package/src/server/host/dedicated/seats.ts +12 -0
  2518. package/src/server/host/dedicated/serverReports.ts +81 -0
  2519. package/src/server/host/dedicated/serverSentry.ts +124 -0
  2520. package/src/server/host/dedicated/shopGate.ts +36 -0
  2521. package/src/server/host/dedicated/socketPump.ts +74 -0
  2522. package/src/server/host/dedicated/socketTransport.ts +123 -0
  2523. package/src/server/host/dedicated/voiceRelay.ts +138 -0
  2524. package/src/server/host/dedicated/workerTable.ts +29 -0
  2525. package/src/server/host/dedicated/world.ts +428 -0
  2526. package/src/server/host/headless.ts +280 -0
  2527. package/src/server/host/headlessProduct.ts +52 -0
  2528. package/src/server/host/headlessRuntime.ts +354 -0
  2529. package/src/server/host/ropeDecks.ts +69 -0
  2530. package/src/server/host/standalone/cellWorld.ts +188 -0
  2531. package/src/server/host/standalone/continuation.ts +58 -0
  2532. package/src/server/host/standalone/fallFloor.ts +83 -0
  2533. package/src/server/host/standalone/gridServer.ts +282 -0
  2534. package/src/server/host/standalone/ledgerFilings.ts +33 -0
  2535. package/src/server/host/standalone/progressWatch.ts +90 -0
  2536. package/src/server/host/standalone/roadWorld.ts +49 -0
  2537. package/src/server/host/standalone/serverHost.ts +132 -0
  2538. package/src/server/host/standalone/serverProduct.ts +149 -0
  2539. package/src/server/host/standalone/serverRuntime.ts +43 -0
  2540. package/src/server/host/standalone/serverWorker.ts +22 -0
  2541. package/src/server/host/tickWorkerHost.ts +250 -0
  2542. package/src/server/host/tickWorkerLoop.ts +123 -0
  2543. package/src/server/serve.ts +49 -0
  2544. package/src/server/side.ts +2 -0
  2545. package/src/shared/engine/ai/BossBrain.ts +287 -0
  2546. package/src/shared/engine/ai/GroupBrain.ts +152 -0
  2547. package/src/shared/engine/ai/ambientFlight.ts +60 -0
  2548. package/src/shared/engine/ai/ambientFlock.ts +297 -0
  2549. package/src/shared/engine/ai/ambientForager.ts +289 -0
  2550. package/src/shared/engine/ai/bossScale.ts +8 -0
  2551. package/src/shared/engine/ai/director.ts +94 -0
  2552. package/src/shared/engine/ai/diver.ts +540 -0
  2553. package/src/shared/engine/ai/eliteScript.ts +85 -0
  2554. package/src/shared/engine/ai/encounters.ts +124 -0
  2555. package/src/shared/engine/ai/flight.ts +69 -0
  2556. package/src/shared/engine/ai/flock.ts +334 -0
  2557. package/src/shared/engine/ai/hfsm.ts +51 -0
  2558. package/src/shared/engine/ai/huntPattern.ts +987 -0
  2559. package/src/shared/engine/ai/inspect.ts +6 -0
  2560. package/src/shared/engine/ai/pinning.ts +13 -0
  2561. package/src/shared/engine/ai/reach.ts +19 -0
  2562. package/src/shared/engine/ai/stalker.ts +1502 -0
  2563. package/src/shared/engine/ai/strikeRows.ts +17 -0
  2564. package/src/shared/engine/ai/strikeState.ts +19 -0
  2565. package/src/shared/engine/ai/strikes.ts +199 -0
  2566. package/src/shared/engine/ai/weighted.ts +27 -0
  2567. package/src/shared/engine/app/identity.ts +66 -0
  2568. package/src/shared/engine/app/ownership.ts +155 -0
  2569. package/src/shared/engine/app/pageSeat.ts +12 -0
  2570. package/src/shared/engine/app/resources.ts +7 -0
  2571. package/src/shared/engine/app/scheduler.ts +162 -0
  2572. package/src/shared/engine/app/scope.ts +557 -0
  2573. package/src/shared/engine/app/scopeEnvironment.ts +27 -0
  2574. package/src/shared/engine/app/scopedProperty.ts +38 -0
  2575. package/src/shared/engine/audio/audioProfiles.ts +161 -0
  2576. package/src/shared/engine/audio/bootAudio.ts +316 -0
  2577. package/src/shared/engine/boot/loadingWaits.ts +62 -0
  2578. package/src/shared/engine/boot/serverProgress.ts +27 -0
  2579. package/src/shared/engine/boot/steps.ts +63 -0
  2580. package/src/shared/engine/boot/tables.ts +48 -0
  2581. package/src/shared/engine/boot/timeline.ts +189 -0
  2582. package/src/shared/engine/boot/timing.ts +96 -0
  2583. package/src/shared/engine/boot/waits.ts +114 -0
  2584. package/src/shared/engine/boot/workerTiming.ts +74 -0
  2585. package/src/shared/engine/combat/Equipment.ts +66 -0
  2586. package/src/shared/engine/combat/Firearm.ts +200 -0
  2587. package/src/shared/engine/combat/Melee.ts +46 -0
  2588. package/src/shared/engine/combat/Tool.ts +8 -0
  2589. package/src/shared/engine/combat/Weapon.ts +133 -0
  2590. package/src/shared/engine/combat/ammo.ts +17 -0
  2591. package/src/shared/engine/combat/blocks/ads.ts +5 -0
  2592. package/src/shared/engine/combat/blocks/melee.ts +19 -0
  2593. package/src/shared/engine/combat/bowDraw.ts +140 -0
  2594. package/src/shared/engine/combat/bowLaw.ts +54 -0
  2595. package/src/shared/engine/combat/effects/EffectService.ts +216 -0
  2596. package/src/shared/engine/combat/effects/types.ts +47 -0
  2597. package/src/shared/engine/combat/health.ts +92 -0
  2598. package/src/shared/engine/combat/impact.ts +8 -0
  2599. package/src/shared/engine/combat/itemFamilies.ts +34 -0
  2600. package/src/shared/engine/combat/items.ts +147 -0
  2601. package/src/shared/engine/combat/lungeTarget.ts +42 -0
  2602. package/src/shared/engine/combat/meleeProfile.ts +48 -0
  2603. package/src/shared/engine/combat/pipeline.ts +157 -0
  2604. package/src/shared/engine/combat/projectileContact.ts +275 -0
  2605. package/src/shared/engine/combat/projectileFlight.ts +89 -0
  2606. package/src/shared/engine/combat/projectileLaw.ts +148 -0
  2607. package/src/shared/engine/combat/shotSpread.ts +38 -0
  2608. package/src/shared/engine/combat/sweptBasePose.ts +75 -0
  2609. package/src/shared/engine/combat/sweptBlade.ts +108 -0
  2610. package/src/shared/engine/combat/sweptMeleeCore.ts +223 -0
  2611. package/src/shared/engine/combat/targets.ts +20 -0
  2612. package/src/shared/engine/core/clock.ts +57 -0
  2613. package/src/shared/engine/core/config.ts +66 -0
  2614. package/src/shared/engine/core/faults.ts +129 -0
  2615. package/src/shared/engine/core/fixedStep.ts +5 -0
  2616. package/src/shared/engine/core/frameCost.ts +227 -0
  2617. package/src/shared/engine/core/framePacing.ts +179 -0
  2618. package/src/shared/engine/core/harnessTap.ts +15 -0
  2619. package/src/shared/engine/core/memoryAttribution.ts +137 -0
  2620. package/src/shared/engine/core/memoryResources.ts +20 -0
  2621. package/src/shared/engine/core/noise.ts +53 -0
  2622. package/src/shared/engine/core/perfLap.ts +37 -0
  2623. package/src/shared/engine/core/portableMath.ts +204 -0
  2624. package/src/shared/engine/core/portableMathFirst.ts +4 -0
  2625. package/src/shared/engine/core/practiceRoomState.ts +3 -0
  2626. package/src/shared/engine/core/rng.ts +101 -0
  2627. package/src/shared/engine/core/time.ts +8 -0
  2628. package/src/shared/engine/core/workSlice.ts +111 -0
  2629. package/src/shared/engine/entities/AnimalSim.ts +390 -0
  2630. package/src/shared/engine/entities/animalPose.ts +401 -0
  2631. package/src/shared/engine/entities/animalRig.ts +76 -0
  2632. package/src/shared/engine/entities/animalStates.ts +2 -0
  2633. package/src/shared/engine/entities/creatureFloor.ts +13 -0
  2634. package/src/shared/engine/entities/eliteBrain.ts +36 -0
  2635. package/src/shared/engine/entities/fightRules.ts +80 -0
  2636. package/src/shared/engine/entities/ids.ts +18 -0
  2637. package/src/shared/engine/entities/poseCadence.ts +9 -0
  2638. package/src/shared/engine/entities/species/registry.ts +382 -0
  2639. package/src/shared/engine/entities/species/rigs.ts +53 -0
  2640. package/src/shared/engine/events/events.ts +107 -0
  2641. package/src/shared/engine/input/commands.ts +34 -0
  2642. package/src/shared/engine/input/netButtons.ts +4 -0
  2643. package/src/shared/engine/level/data.ts +163 -0
  2644. package/src/shared/engine/level/selection.ts +44 -0
  2645. package/src/shared/engine/level/spec.ts +132 -0
  2646. package/src/shared/engine/net/acts.ts +48 -0
  2647. package/src/shared/engine/net/animalNet.ts +43 -0
  2648. package/src/shared/engine/net/bits.ts +104 -0
  2649. package/src/shared/engine/net/chatFilter.ts +40 -0
  2650. package/src/shared/engine/net/chatWire.ts +18 -0
  2651. package/src/shared/engine/net/chatWords.ts +7 -0
  2652. package/src/shared/engine/net/command.ts +96 -0
  2653. package/src/shared/engine/net/encounterNet.ts +32 -0
  2654. package/src/shared/engine/net/frame.ts +159 -0
  2655. package/src/shared/engine/net/identity.ts +40 -0
  2656. package/src/shared/engine/net/ledgerWire.ts +24 -0
  2657. package/src/shared/engine/net/measurements.ts +14 -0
  2658. package/src/shared/engine/net/messages.ts +213 -0
  2659. package/src/shared/engine/net/netSchemas.ts +38 -0
  2660. package/src/shared/engine/net/playerNet.ts +80 -0
  2661. package/src/shared/engine/net/schema.ts +157 -0
  2662. package/src/shared/engine/net/shardNet.ts +25 -0
  2663. package/src/shared/engine/net/socketFrames.ts +84 -0
  2664. package/src/shared/engine/net/transport.ts +19 -0
  2665. package/src/shared/engine/net/wireFrames.ts +123 -0
  2666. package/src/shared/engine/net/wireMessages.ts +115 -0
  2667. package/src/shared/engine/net/wireValues.ts +142 -0
  2668. package/src/shared/engine/physics/CharacterMotor.ts +429 -0
  2669. package/src/shared/engine/physics/Physics.ts +211 -0
  2670. package/src/shared/engine/physics/bodies.ts +600 -0
  2671. package/src/shared/engine/physics/box.ts +42 -0
  2672. package/src/shared/engine/physics/creatures.ts +188 -0
  2673. package/src/shared/engine/physics/declaredProps.ts +26 -0
  2674. package/src/shared/engine/physics/entrySockets.ts +44 -0
  2675. package/src/shared/engine/physics/frame.ts +39 -0
  2676. package/src/shared/engine/physics/gridBorders.ts +38 -0
  2677. package/src/shared/engine/physics/groups.ts +64 -0
  2678. package/src/shared/engine/physics/heightPatch.ts +49 -0
  2679. package/src/shared/engine/physics/meshCollision.ts +84 -0
  2680. package/src/shared/engine/physics/mover.ts +60 -0
  2681. package/src/shared/engine/physics/navmesh.ts +206 -0
  2682. package/src/shared/engine/physics/navmeshUrl.ts +8 -0
  2683. package/src/shared/engine/physics/nearColliders.ts +55 -0
  2684. package/src/shared/engine/physics/overlap.ts +26 -0
  2685. package/src/shared/engine/physics/paths.ts +135 -0
  2686. package/src/shared/engine/physics/pieces.ts +139 -0
  2687. package/src/shared/engine/physics/query.ts +161 -0
  2688. package/src/shared/engine/physics/queryBatchV2.ts +118 -0
  2689. package/src/shared/engine/physics/rapier-bg.d.ts +5 -0
  2690. package/src/shared/engine/physics/rapier.ts +34 -0
  2691. package/src/shared/engine/physics/readinessWalls.ts +49 -0
  2692. package/src/shared/engine/physics/ropeChain.ts +128 -0
  2693. package/src/shared/engine/physics/stripColliders.ts +21 -0
  2694. package/src/shared/engine/physics/surface.ts +31 -0
  2695. package/src/shared/engine/physics/terrain.ts +155 -0
  2696. package/src/shared/engine/physics/terrainTiles.ts +20 -0
  2697. package/src/shared/engine/physics/trainingTargets.ts +51 -0
  2698. package/src/shared/engine/physics/transferWalls.ts +84 -0
  2699. package/src/shared/engine/physics/wasmUrl.ts +3 -0
  2700. package/src/shared/engine/player/MeleeSweep.ts +50 -0
  2701. package/src/shared/engine/player/board.ts +129 -0
  2702. package/src/shared/engine/player/combatMotion.ts +5 -0
  2703. package/src/shared/engine/player/dash.ts +60 -0
  2704. package/src/shared/engine/player/dodge.ts +14 -0
  2705. package/src/shared/engine/player/fall.ts +29 -0
  2706. package/src/shared/engine/player/hoverSpeed.ts +22 -0
  2707. package/src/shared/engine/player/impulse.ts +30 -0
  2708. package/src/shared/engine/player/jump.ts +30 -0
  2709. package/src/shared/engine/player/lockOrbit.ts +72 -0
  2710. package/src/shared/engine/player/modes.ts +239 -0
  2711. package/src/shared/engine/player/motion.ts +391 -0
  2712. package/src/shared/engine/player/motionState.ts +84 -0
  2713. package/src/shared/engine/player/shove.ts +27 -0
  2714. package/src/shared/engine/player/swim.ts +196 -0
  2715. package/src/shared/engine/player/walk.ts +25 -0
  2716. package/src/shared/engine/quest/core.ts +174 -0
  2717. package/src/shared/engine/quest/dialogueClock.ts +191 -0
  2718. package/src/shared/engine/quest/discovery.ts +42 -0
  2719. package/src/shared/engine/quest/lastPlace.ts +80 -0
  2720. package/src/shared/engine/quest/players.ts +162 -0
  2721. package/src/shared/engine/quest/progress.ts +25 -0
  2722. package/src/shared/engine/quest/viewPort.ts +22 -0
  2723. package/src/shared/engine/saves/environment.ts +13 -0
  2724. package/src/shared/engine/saves/legacy.ts +65 -0
  2725. package/src/shared/engine/saves/runtime.ts +28 -0
  2726. package/src/shared/engine/saves/saves.lock.json +551 -0
  2727. package/src/shared/engine/saves/shape.ts +157 -0
  2728. package/src/shared/engine/saves/store.ts +423 -0
  2729. package/src/shared/engine/script/checkpointBytes.ts +18 -0
  2730. package/src/shared/engine/script/decisionModule.ts +158 -0
  2731. package/src/shared/engine/script/effects.ts +111 -0
  2732. package/src/shared/engine/script/fixedMemory.ts +92 -0
  2733. package/src/shared/engine/script/groupBankV2.ts +376 -0
  2734. package/src/shared/engine/script/groupStepV2.ts +987 -0
  2735. package/src/shared/engine/script/host.ts +443 -0
  2736. package/src/shared/engine/script/moduleV2.ts +160 -0
  2737. package/src/shared/engine/script/observationColumnsV2.ts +431 -0
  2738. package/src/shared/engine/script/observationsV2.ts +139 -0
  2739. package/src/shared/engine/script/state.ts +183 -0
  2740. package/src/shared/engine/script/strings.ts +5 -0
  2741. package/src/shared/engine/script/viewLane.ts +335 -0
  2742. package/src/shared/engine/script/viewProgram.ts +315 -0
  2743. package/src/shared/engine/sim/actRoutes.ts +72 -0
  2744. package/src/shared/engine/sim/apiVersion.ts +2 -0
  2745. package/src/shared/engine/sim/bands.ts +174 -0
  2746. package/src/shared/engine/sim/cableTraversal.ts +356 -0
  2747. package/src/shared/engine/sim/dayClock.ts +76 -0
  2748. package/src/shared/engine/sim/edgeProfiles.ts +123 -0
  2749. package/src/shared/engine/sim/encounterRows.ts +49 -0
  2750. package/src/shared/engine/sim/leadPlayer.ts +16 -0
  2751. package/src/shared/engine/sim/moverLifecycle.ts +80 -0
  2752. package/src/shared/engine/sim/moverMotion.ts +130 -0
  2753. package/src/shared/engine/sim/nearPlayer.ts +21 -0
  2754. package/src/shared/engine/sim/netMotion.ts +17 -0
  2755. package/src/shared/engine/sim/readiness.ts +77 -0
  2756. package/src/shared/engine/sim/seamError.ts +100 -0
  2757. package/src/shared/engine/sim/seamGeometry.ts +365 -0
  2758. package/src/shared/engine/sim/seamLattice.ts +127 -0
  2759. package/src/shared/engine/sim/shardRows.ts +106 -0
  2760. package/src/shared/engine/sim/shore.ts +14 -0
  2761. package/src/shared/engine/sim/snapshot.ts +482 -0
  2762. package/src/shared/engine/sim/snapshotBase64.ts +25 -0
  2763. package/src/shared/engine/sim/snapshotData.ts +460 -0
  2764. package/src/shared/engine/sim/snapshotPhysics.ts +163 -0
  2765. package/src/shared/engine/sim/snapshotReferenceMemo.ts +271 -0
  2766. package/src/shared/engine/sim/strips.ts +134 -0
  2767. package/src/shared/engine/strings.ts +751 -0
  2768. package/src/shared/engine/world/BakedTerrain.ts +131 -0
  2769. package/src/shared/engine/world/Heightfield.ts +129 -0
  2770. package/src/shared/engine/world/bakedTerrainField.ts +85 -0
  2771. package/src/shared/engine/world/dayCycle.ts +198 -0
  2772. package/src/shared/engine/world/easedFields.ts +32 -0
  2773. package/src/shared/engine/world/forest/placement.ts +391 -0
  2774. package/src/shared/engine/world/forest/treeSpec.ts +15 -0
  2775. package/src/shared/engine/world/groundField.ts +21 -0
  2776. package/src/shared/engine/world/interact/barrel.ts +114 -0
  2777. package/src/shared/engine/world/interact/flags.ts +229 -0
  2778. package/src/shared/engine/world/interact/pickup.ts +22 -0
  2779. package/src/shared/engine/world/interact/prompts.ts +47 -0
  2780. package/src/shared/engine/world/interact/types.ts +327 -0
  2781. package/src/shared/engine/world/interact/validate.ts +67 -0
  2782. package/src/shared/engine/world/scalarChannel.ts +146 -0
  2783. package/src/shared/engine/world/steppeWind.ts +193 -0
  2784. package/src/shared/engine/world/terrainField.ts +217 -0
  2785. package/src/shared/engine/world/terrainHeight.ts +19 -0
  2786. package/src/shared/engine/world/water/body.ts +88 -0
  2787. package/src/shared/engine/world/water/declared.ts +106 -0
  2788. package/src/shared/engine/world/waves.ts +57 -0
  2789. package/src/shared/engine/world/weather.ts +166 -0
  2790. package/src/shared/engine/world/weatherContinuation.ts +121 -0
  2791. package/src/shared/engine/world/windField.ts +49 -0
  2792. package/src/shared/engine/world/windStrength.ts +6 -0
  2793. package/src/shared/engine/world/yawFrame.ts +38 -0
  2794. package/src/shared/game/achievements.ts +140 -0
  2795. package/src/shared/game/ambient/flock.ts +374 -0
  2796. package/src/shared/game/animation/limbBlend.ts +70 -0
  2797. package/src/shared/game/animation/limbRig.ts +208 -0
  2798. package/src/shared/game/bag/findsCatalogue.ts +58 -0
  2799. package/src/shared/game/bag/itemCatalog.ts +18 -0
  2800. package/src/shared/game/bag/items.ts +5 -0
  2801. package/src/shared/game/bag/starter.generated.ts +3 -0
  2802. package/src/shared/game/bag/starterItems.json +62 -0
  2803. package/src/shared/game/boss/arenaAnswers.ts +49 -0
  2804. package/src/shared/game/boss/arenaCollision.ts +16 -0
  2805. package/src/shared/game/boss/arenaGround.ts +121 -0
  2806. package/src/shared/game/boss/arenaPortal.ts +63 -0
  2807. package/src/shared/game/boss/arenaRoomRows.ts +403 -0
  2808. package/src/shared/game/boss/arenaWhirls.ts +88 -0
  2809. package/src/shared/game/boss/jointTargets.ts +41 -0
  2810. package/src/shared/game/boss/lane.ts +62 -0
  2811. package/src/shared/game/boss/openArenaFight.ts +644 -0
  2812. package/src/shared/game/boss/patrolLaw.ts +136 -0
  2813. package/src/shared/game/boss/slotLaw.ts +173 -0
  2814. package/src/shared/game/boss/wake.ts +60 -0
  2815. package/src/shared/game/compendium/finds.ts +49 -0
  2816. package/src/shared/game/compendium/registry.ts +28 -0
  2817. package/src/shared/game/compendium/rules.ts +136 -0
  2818. package/src/shared/game/compendium/state.ts +23 -0
  2819. package/src/shared/game/compendium/tracker.ts +138 -0
  2820. package/src/shared/game/compendium/types.ts +115 -0
  2821. package/src/shared/game/eliteSystem.ts +349 -0
  2822. package/src/shared/game/grapple/course.ts +14 -0
  2823. package/src/shared/game/grapple/feed.ts +27 -0
  2824. package/src/shared/game/grapple/sim.ts +352 -0
  2825. package/src/shared/game/grid/allocator.ts +479 -0
  2826. package/src/shared/game/grid/assembly.ts +73 -0
  2827. package/src/shared/game/grid/catalogue.ts +197 -0
  2828. package/src/shared/game/grid/catalogueDocument.ts +6 -0
  2829. package/src/shared/game/grid/catalogueSlot.ts +53 -0
  2830. package/src/shared/game/grid/cellEvents.ts +37 -0
  2831. package/src/shared/game/grid/collisionStrips.ts +18 -0
  2832. package/src/shared/game/grid/compiledStrips.ts +282 -0
  2833. package/src/shared/game/grid/continuations.ts +43 -0
  2834. package/src/shared/game/grid/crossing.ts +143 -0
  2835. package/src/shared/game/grid/edgeProfiles.ts +31 -0
  2836. package/src/shared/game/grid/farProxy.ts +302 -0
  2837. package/src/shared/game/grid/ghosts.ts +42 -0
  2838. package/src/shared/game/grid/gridAssetBytes.ts +59 -0
  2839. package/src/shared/game/grid/gridCollision.ts +37 -0
  2840. package/src/shared/game/grid/instances.ts +9 -0
  2841. package/src/shared/game/grid/pageMode.ts +32 -0
  2842. package/src/shared/game/grid/platformInputs.ts +11 -0
  2843. package/src/shared/game/grid/postPairs.ts +40 -0
  2844. package/src/shared/game/grid/readinessEdges.ts +13 -0
  2845. package/src/shared/game/grid/recovery.ts +221 -0
  2846. package/src/shared/game/grid/roadLayout.ts +169 -0
  2847. package/src/shared/game/grid/roadRecovery.ts +99 -0
  2848. package/src/shared/game/grid/rules.ts +45 -0
  2849. package/src/shared/game/grid/runtimeCheckpoint.ts +58 -0
  2850. package/src/shared/game/grid/seamData.ts +74 -0
  2851. package/src/shared/game/grid/seamGeometry.ts +219 -0
  2852. package/src/shared/game/grid/singleplayer.json +701 -0
  2853. package/src/shared/game/grid/travellerCombat.ts +34 -0
  2854. package/src/shared/game/grid/wallet.ts +104 -0
  2855. package/src/shared/game/harvest.ts +16 -0
  2856. package/src/shared/game/instanceSaves.ts +14 -0
  2857. package/src/shared/game/inventoryLaw.ts +131 -0
  2858. package/src/shared/game/ledger.ts +188 -0
  2859. package/src/shared/game/loadout/itemCatalogue.ts +44 -0
  2860. package/src/shared/game/loadout/persistence.ts +20 -0
  2861. package/src/shared/game/loadout/pouch.ts +46 -0
  2862. package/src/shared/game/localSaveKeys.ts +9 -0
  2863. package/src/shared/game/looks/dayClock.ts +112 -0
  2864. package/src/shared/game/looks/dayLookPresets.ts +75 -0
  2865. package/src/shared/game/looks/keyedSkyClock.ts +15 -0
  2866. package/src/shared/game/loot/Bounty.ts +49 -0
  2867. package/src/shared/game/loot/Owned.ts +112 -0
  2868. package/src/shared/game/loot/Purse.ts +94 -0
  2869. package/src/shared/game/loot/coinAmounts.ts +17 -0
  2870. package/src/shared/game/loot/coinBurstState.ts +23 -0
  2871. package/src/shared/game/loot/deaths.ts +14 -0
  2872. package/src/shared/game/loot/exchange.ts +71 -0
  2873. package/src/shared/game/loot/ownedRows.ts +24 -0
  2874. package/src/shared/game/loot/tableRows.ts +11 -0
  2875. package/src/shared/game/newGame.ts +56 -0
  2876. package/src/shared/game/plugin/animation.ts +618 -0
  2877. package/src/shared/game/plugin/bodyBoss.ts +119 -0
  2878. package/src/shared/game/plugin/borrowed.ts +62 -0
  2879. package/src/shared/game/plugin/bossRecord.ts +28 -0
  2880. package/src/shared/game/plugin/channelPrograms.ts +307 -0
  2881. package/src/shared/game/plugin/channels.ts +355 -0
  2882. package/src/shared/game/plugin/creatureFrame.ts +46 -0
  2883. package/src/shared/game/plugin/director.ts +435 -0
  2884. package/src/shared/game/plugin/moduleHash.ts +49 -0
  2885. package/src/shared/game/plugin/quests.ts +450 -0
  2886. package/src/shared/game/plugin/runtimeRows.ts +288 -0
  2887. package/src/shared/game/population/census.ts +67 -0
  2888. package/src/shared/game/population/groupNotices.ts +34 -0
  2889. package/src/shared/game/population/pageHomes.ts +125 -0
  2890. package/src/shared/game/population/pageRows.ts +20 -0
  2891. package/src/shared/game/population/perchRoot.ts +17 -0
  2892. package/src/shared/game/population/respawn.ts +89 -0
  2893. package/src/shared/game/population/returnProgram.ts +448 -0
  2894. package/src/shared/game/population/returnProjectionV2.ts +203 -0
  2895. package/src/shared/game/population/wildlifeOwner.ts +20 -0
  2896. package/src/shared/game/quest/boundState.ts +55 -0
  2897. package/src/shared/game/quest/carriedRound.ts +59 -0
  2898. package/src/shared/game/quest/chapterBindings.ts +64 -0
  2899. package/src/shared/game/quest/chapterClock.ts +56 -0
  2900. package/src/shared/game/quest/chapterDecision.ts +31 -0
  2901. package/src/shared/game/quest/chapterFlow.ts +54 -0
  2902. package/src/shared/game/quest/chapterLeads.ts +10 -0
  2903. package/src/shared/game/quest/contractBoard.ts +108 -0
  2904. package/src/shared/game/quest/contracts.ts +145 -0
  2905. package/src/shared/game/quest/declared.ts +152 -0
  2906. package/src/shared/game/quest/effectPresentation.ts +23 -0
  2907. package/src/shared/game/quest/effects.ts +61 -0
  2908. package/src/shared/game/quest/eliteDecisions.ts +123 -0
  2909. package/src/shared/game/quest/eliteStreams.ts +7 -0
  2910. package/src/shared/game/quest/featCounters.ts +41 -0
  2911. package/src/shared/game/quest/flagGates.ts +103 -0
  2912. package/src/shared/game/quest/interactionRows.ts +214 -0
  2913. package/src/shared/game/quest/ledger.ts +23 -0
  2914. package/src/shared/game/quest/legacyRecords.ts +17 -0
  2915. package/src/shared/game/quest/nativeProps.ts +117 -0
  2916. package/src/shared/game/quest/pagePersistence.ts +91 -0
  2917. package/src/shared/game/quest/pageReads.ts +39 -0
  2918. package/src/shared/game/quest/pageResources.ts +19 -0
  2919. package/src/shared/game/quest/pageState.ts +66 -0
  2920. package/src/shared/game/quest/persistence.ts +110 -0
  2921. package/src/shared/game/quest/questObservation.ts +50 -0
  2922. package/src/shared/game/quest/steps.ts +116 -0
  2923. package/src/shared/game/quest/storyLaw.ts +17 -0
  2924. package/src/shared/game/riding/bindingTypes.ts +43 -0
  2925. package/src/shared/game/riding/companions.ts +135 -0
  2926. package/src/shared/game/riding/entered.ts +21 -0
  2927. package/src/shared/game/riding/pagePopulation.ts +28 -0
  2928. package/src/shared/game/riding/pastureCues.ts +24 -0
  2929. package/src/shared/game/riding/physics.ts +691 -0
  2930. package/src/shared/game/riding/presentation.ts +27 -0
  2931. package/src/shared/game/riding/taming.ts +164 -0
  2932. package/src/shared/game/rng.merge.d.ts +10 -0
  2933. package/src/shared/game/saves.ts +90 -0
  2934. package/src/shared/game/shard/api.ts +2 -0
  2935. package/src/shared/game/shard/declaredRows.ts +121 -0
  2936. package/src/shared/game/shard/enteredServices.ts +14 -0
  2937. package/src/shared/game/shard/runtime.ts +90 -0
  2938. package/src/shared/game/shard/slug.ts +9 -0
  2939. package/src/shared/game/shard/terrainBake.ts +12 -0
  2940. package/src/shared/game/shardfile/aimTargetFilter.ts +12 -0
  2941. package/src/shared/game/shardfile/bakedPlacementPoses.ts +25 -0
  2942. package/src/shared/game/shardfile/buildingDoor.ts +52 -0
  2943. package/src/shared/game/shardfile/clientGround.ts +86 -0
  2944. package/src/shared/game/shardfile/clientState.ts +133 -0
  2945. package/src/shared/game/shardfile/collisionBindings.ts +31 -0
  2946. package/src/shared/game/shardfile/contentHash.ts +7 -0
  2947. package/src/shared/game/shardfile/crowdRuntime.ts +254 -0
  2948. package/src/shared/game/shardfile/customSchema.ts +57 -0
  2949. package/src/shared/game/shardfile/dataCreaturePorts.ts +239 -0
  2950. package/src/shared/game/shardfile/entryOwners.ts +153 -0
  2951. package/src/shared/game/shardfile/fileInputs.ts +21 -0
  2952. package/src/shared/game/shardfile/identity.ts +18 -0
  2953. package/src/shared/game/shardfile/items.ts +180 -0
  2954. package/src/shared/game/shardfile/ktx2Targets.ts +62 -0
  2955. package/src/shared/game/shardfile/ladder.ts +137 -0
  2956. package/src/shared/game/shardfile/liftRider.ts +62 -0
  2957. package/src/shared/game/shardfile/logicalState.ts +57 -0
  2958. package/src/shared/game/shardfile/movers.ts +14 -0
  2959. package/src/shared/game/shardfile/namedJsonChecks.ts +12 -0
  2960. package/src/shared/game/shardfile/outputChecksNode.ts +11 -0
  2961. package/src/shared/game/shardfile/outputDescriptor.ts +317 -0
  2962. package/src/shared/game/shardfile/outputIndexChecks.ts +8 -0
  2963. package/src/shared/game/shardfile/packReads.ts +93 -0
  2964. package/src/shared/game/shardfile/playArea.ts +42 -0
  2965. package/src/shared/game/shardfile/portalRide.ts +170 -0
  2966. package/src/shared/game/shardfile/portalTraversal.ts +49 -0
  2967. package/src/shared/game/shardfile/productData.ts +22 -0
  2968. package/src/shared/game/shardfile/props.ts +11 -0
  2969. package/src/shared/game/shardfile/resourceRole.ts +14 -0
  2970. package/src/shared/game/shardfile/runtimeState.ts +69 -0
  2971. package/src/shared/game/shardfile/schemaReferences.ts +33 -0
  2972. package/src/shared/game/shardfile/scriptNotice.ts +38 -0
  2973. package/src/shared/game/shardfile/serverPack.ts +23 -0
  2974. package/src/shared/game/shardfile/shardProduct.ts +206 -0
  2975. package/src/shared/game/shardfile/spawnManifest.ts +126 -0
  2976. package/src/shared/game/shardfile/talks.ts +22 -0
  2977. package/src/shared/game/shardfile/targets.ts +11 -0
  2978. package/src/shared/game/shardfile/tileOrder.ts +64 -0
  2979. package/src/shared/game/shardfile/walkInPortalRide.ts +160 -0
  2980. package/src/shared/game/shardfile/wholeInputs.ts +18 -0
  2981. package/src/shared/game/shardfile/wirePrompts.ts +35 -0
  2982. package/src/shared/game/shardfile/worldActionsV2.ts +113 -0
  2983. package/src/shared/game/shardfile/worldTargets.ts +71 -0
  2984. package/src/shared/game/stealth/stealthLaw.ts +120 -0
  2985. package/src/shared/game/strings.ts +88 -0
  2986. package/src/shared/game/systems/cellField.ts +144 -0
  2987. package/src/shared/game/systems/effects/starterEffects.ts +20 -0
  2988. package/src/shared/game/systems/effects/starterRows.json +98 -0
  2989. package/src/shared/game/systems/looks/grassField.ts +249 -0
  2990. package/src/shared/game/systems/looks/trampleField.ts +263 -0
  2991. package/src/shared/game/weapons/heldBowBase.ts +15 -0
  2992. package/src/shared/game/weapons/heldDecision.ts +20 -0
  2993. package/src/shared/game/weapons/javelinFlight.ts +139 -0
  2994. package/src/shared/game/weapons/launcherSpring.ts +11 -0
  2995. package/src/shared/game/weapons/mountedPass.ts +70 -0
  2996. package/src/shared/game/weapons/polearmContact.ts +73 -0
  2997. package/src/shared/game/weapons/polearmDecision.ts +152 -0
  2998. package/src/shared/game/weapons/starter.generated.ts +2 -0
  2999. package/src/shared/game/weapons/starterBow.json +21 -0
  3000. package/src/shared/game/weapons/starterBowProfile.ts +17 -0
  3001. package/src/shared/game/weapons/starterCombat.ts +19 -0
  3002. package/src/shared/game/weapons/starterGlyphs.ts +9 -0
  3003. package/src/shared/game/weapons/starterMeleeProfile.ts +67 -0
  3004. package/src/shared/game/weapons/starterMoves.ts +101 -0
  3005. package/src/shared/game/weather/feed.ts +57 -0
  3006. package/src/shared/health.ts +10 -0
  3007. package/src/shared/host/author.ts +14 -0
  3008. package/src/shared/host/formatJsonSchema.ts +1114 -0
  3009. package/src/shared/host/headlessJourney.ts +152 -0
  3010. package/src/shared/host/headlessObservation.ts +16 -0
  3011. package/src/shared/host/headlessSections.ts +18 -0
  3012. package/src/shared/host/headlessTape.ts +99 -0
  3013. package/src/shared/host/headlessTapeParts.ts +35 -0
  3014. package/src/shared/host/immutable.ts +14 -0
  3015. package/src/shared/host/releaseRows.ts +23 -0
  3016. package/src/shared/host/shardfile.ts +23 -0
  3017. package/src/shared/host/standalone/harnessPlace.ts +23 -0
  3018. package/src/shared/host/standalone/heldReads.ts +45 -0
  3019. package/src/shared/host/standalone/netInput.ts +112 -0
  3020. package/src/shared/host/standalone/workerLoopback.ts +51 -0
  3021. package/src/shared/host/tickProtocol.ts +246 -0
  3022. package/src/shared/side.ts +2 -0
  3023. package/src/test/engine/FakeGame.ts +123 -0
  3024. package/src/test/engine/creatureStride.ts +29 -0
  3025. package/src/test/engine/declarationConsumer.ts +24 -0
  3026. package/src/test/engine/linkedGl.ts +7 -0
  3027. package/src/test/engine/manager.ts +58 -0
  3028. package/src/test/engine/nativeBytes.ts +5 -0
  3029. package/src/test/engine/netLoopback.ts +64 -0
  3030. package/src/test/engine/realGc.ts +34 -0
  3031. package/src/test/engine/terrain.ts +32 -0
  3032. package/src/test/engine/textureUploadRenderer.ts +34 -0
  3033. package/src/test/engine/weaponParity.ts +119 -0
  3034. package/src/test/engine/world.ts +48 -0
  3035. package/src/test/game/creatureRecipe.ts +11 -0
  3036. package/src/test/helpers/git.ts +94 -0
  3037. package/src/test/tsconfig.app.json +28 -0
  3038. package/src/test/tsconfig.engine.json +27 -0
  3039. package/src/test/tsconfig.game.json +28 -0
  3040. package/src/test/tsconfig.host.json +27 -0
  3041. package/src/tools/build-web.ts +58 -0
  3042. package/src/tsconfig.json +39 -0
  3043. package/tsconfig.app.json +32 -0
  3044. package/tsconfig.engine.json +22 -0
  3045. package/tsconfig.game.json +34 -0
  3046. package/tsconfig.host.json +33 -0
  3047. package/tsconfig.json +54 -0
  3048. package/tsconfig.layers.json +35 -0
  3049. package/types/format-standards.d.ts +19 -0
  3050. package/vite/rapier.ts +35 -0
  3051. package/README.md +0 -8
@@ -0,0 +1,1833 @@
1
+ import { pageScope, resourceScope } from '../../../shared/engine/app/resources';
2
+ import { pageEnvironments } from './drawnEnvironment';
3
+ import type { Scope } from '../../../shared/engine/app/scope';
4
+ import { engineString } from '../../../shared/engine/strings';
5
+ import * as THREE from 'three';
6
+ import { Pass, ToneMappingEffect, ToneMappingMode, type EffectComposer } from 'postprocessing';
7
+ import { newProgramsSince, snapshotPrograms, type ProgramLike } from '../boot/perflog';
8
+ import { bootTraceActive } from '../boot/bootTrace';
9
+ import type { Renderer } from './renderer';
10
+ import type { OffscreenPass } from './look';
11
+ import type { Game } from '../core/Game';
12
+ import { chunkShadowCastersSliced } from '../world/shadowChunks';
13
+ import { CompileLights, createCompileScene } from './compileLights';
14
+ import { recordGpuCheckpoint } from '../boot/gpuTrace';
15
+ import { familyCompileJobs } from './families/registry';
16
+ import { shaderPatchTextures } from './shaderPatches';
17
+ import { uploadCompressedTexture } from './compressedUpload';
18
+ import { linkStandIn } from '../app/sceneOwnership';
19
+ import { FenceAbortError } from './fencedUnits';
20
+ import { offscreenPreparations } from './offscreenPreparation';
21
+ import { prepareSceneResources } from './scenePreparation';
22
+ import { readbackPreparation } from './readbackPreparation';
23
+ import { postTriangle } from './postPreparation';
24
+ import { shadowDepthResolver, type ShadowDepthResolver } from './shadowDepthVariants';
25
+ import { boundEntryWarmup } from './entryWarmupBound';
26
+ import { workSlice } from '../../../shared/engine/core/workSlice';
27
+ import { SHADOW_LAYER } from '../core/shadowLayer';
28
+ import { buildHeld, heldBudget, nativeBudgetSpent, presenting } from '../../../shared/engine/core/framePacing';
29
+ import { countedWait, waitFor } from '../../../shared/engine/boot/waits';
30
+ import { isDev } from '../core/devMode';
31
+
32
+ let censusSlot = 0;
33
+ // Weak identities only: a target becomes known after its own completed-draw
34
+ // barrier, not merely because another concurrent warm-up allocated it.
35
+ const fencedTargets = new WeakMap<Renderer, WeakMap<THREE.WebGLRenderTarget, object>>();
36
+ // Admission revisions distinguish a draw that already spent the budget from
37
+ // another warm-up which issued atomic work while this caller was yielding.
38
+ const issuedCompileWork = new WeakMap<Renderer, number>();
39
+
40
+ /**
41
+ * Shader precompile for the `shaders` boot step (project/archive/2026-09-22-load-perf.md §P2.3, Status table).
42
+ *
43
+ * The first `render()` of the world used to build every program the scene needs in one
44
+ * synchronous stall: the lit materials, then the shadow-depth variants of every caster, then the
45
+ * post chain's screen-quad shaders — on iOS (Metal through ANGLE) ~150 ms a program, so 10–17 s
46
+ * with the loading bar frozen at "140 / 142". This module builds the same programs *before* the
47
+ * first frame, in three passes:
48
+ *
49
+ * 1. issue — `renderer.compile()` of every distinct (material × object-flags) pair, of a
50
+ * MeshDepthMaterial configured the way WebGLShadowMap would for each caster, of the
51
+ * sky background box, and of every material the composer's passes own. Program
52
+ * creation is synchronous JS; it is spread over frames by wall time.
53
+ * 2. link — with KHR_parallel_shader_compile the driver links everything on its worker threads
54
+ * at once and we poll `program.isReady()`, reporting the ready count every frame.
55
+ * Without it, one program per frame is forced through LINK_STATUS so the stall is
56
+ * sliced and the bar still moves.
57
+ * 3. (the caller's firstFrame step draws; it should find nothing left to compile — Debug ▸ Performance ▸ Load profiling
58
+ * lists what it did.)
59
+ *
60
+ * Program identity is the WebGLPrograms cache key: material type + shader IDs + parameters from
61
+ * the target scene (fog, lights, environment), the object (instancing, skinning, morphs, geometry
62
+ * attributes) and the render target (colour space, tone mapping). Every clone here is built so its
63
+ * key equals the one the real draw will compute — a wrong key is a wasted compile, not a bug.
64
+ */
65
+
66
+
67
+
68
+
69
+
70
+
71
+
72
+ export interface CompileJob {
73
+ label: string;
74
+ root: THREE.Object3D;
75
+ /** An offscreen pass's actual camera, including its light/caster layer mask. */
76
+ camera?: THREE.Camera;
77
+ /** the scene whose fog / lights / environment the real draw will see (null: an empty scene) */
78
+ target: THREE.Scene | null;
79
+ /** render target the real draw goes to (null: the canvas) */
80
+ rt: THREE.WebGLRenderTarget | null;
81
+ /** compile with the target scene's fog cleared (the shadow pass and the background box see no fog) */
82
+ fogOff?: boolean;
83
+ /** The offscreen factory's tone mapping during this variant, restored before yielding. */
84
+ toneMapping?: THREE.ToneMapping;
85
+ /** Borrowed environment of a parked world's first draw. Applied only during synchronous compile, never a paint. */
86
+ environment?: THREE.Texture;
87
+ /** Release only stand-in resources, after their owner's real draws no longer need the cached programs. */
88
+ dispose?: () => void;
89
+ /** Diagnostic family of this job (scene, shadow, exterior…): new programs are counted per kind in the stage trace. */
90
+ kind?: string;
91
+ /** Detached compile lights; their shadow storage ends with this warm. */
92
+ lights?: CompileLights;
93
+ /** Future lights still to copy into `lights`: copied just before this job compiles, inside its own work slice. */
94
+ futureLights?: readonly THREE.Light[];
95
+ /** Configure a shared, per-draw-configured material (a graph shadow-depth variant) just before this job compiles. */
96
+ prepare?: () => void;
97
+ /** One native face program of a two-pass transparent material; restored before any yield. */
98
+ materialSide?: { readonly material: THREE.Material; readonly side: THREE.Side };
99
+ }
100
+
101
+ export interface PrecompileReport { materials: number; jobs: number; programs: number; parallel: boolean }
102
+
103
+ /** Scalar preparation stage observation. Elapsed time includes painted waits; units count completed jobs/resources. */
104
+ /** Link preparation during compile counts queue completions (including group
105
+ * refreshes); its time is already contained in compile, not an extra phase. */
106
+ export type PrecompileStage = (phase: 'compile' | 'cached-compile' | 'repeat-jobs' | 'link-preparation-during-compile' | 'link' | 'upload' | 'upload-kib' | `programs:${string}`, elapsedMs: number, units: number) => void;
107
+
108
+ const exteriorLighting = new WeakMap<THREE.Scene, { environment: THREE.Texture | null; roots: Set<THREE.Object3D> }>();
109
+
110
+ /** Declare a content root whose lights disappear outside its frame. Sliced preparation also compiles the exterior
111
+ * state, excluding all registered roots and borrowing its declared environment, without changing a live scene.
112
+ * Registrations leave with their content owners; all roots on one page must agree on its exterior environment. */
113
+ export function registerExteriorLighting(scene: THREE.Scene, owner: Scope, root: THREE.Object3D, environment: THREE.Texture | null): void {
114
+ if (owner.disposed) throw new Error('Exterior lighting requires a live owner');
115
+ let state = exteriorLighting.get(scene);
116
+ if (state === undefined) { state = { environment, roots: new Set() }; exteriorLighting.set(scene, state); }
117
+ if (state.environment !== environment) throw new Error('Exterior lighting declarations disagree');
118
+ if (state.roots.has(root)) throw new Error('Exterior lighting root is already registered');
119
+ const held = state;
120
+ held.roots.add(root);
121
+ owner.onDispose(() => { held.roots.delete(root); if (held.roots.size === 0) exteriorLighting.delete(scene); });
122
+ }
123
+
124
+ /** Hidden registered siblings cannot draw on this entered frame. Keep its entire hierarchy and any visible roots;
125
+ * ordinary boot has no exclusion. Borrowed roots and their visibility are never changed. */
126
+ export function entryFrameExclusions(scene: THREE.Scene, future?: THREE.Object3D): ReadonlySet<THREE.Object3D> | undefined {
127
+ if (future === undefined) return undefined;
128
+ const contains = (root: THREE.Object3D, child: THREE.Object3D): boolean => {
129
+ for (let node: THREE.Object3D | null = child; node !== null; node = node.parent) if (node === root) return true;
130
+ return false;
131
+ };
132
+ return new Set([...exteriorLighting.get(scene)?.roots ?? []].filter(root => !root.visible
133
+ && !contains(root, future) && !contains(future, root)));
134
+ }
135
+
136
+ function exclusiveMaterials(scene: THREE.Scene, excluded: ReadonlySet<THREE.Object3D> | undefined): Set<THREE.Material> | undefined {
137
+ if (excluded === undefined || excluded.size === 0) return undefined;
138
+ const included = new Set<THREE.Material>(), materials = new Set<THREE.Material>();
139
+ compileObjects(scene, object => { for (const material of materialsOf(object)) included.add(material); }, excluded);
140
+ for (const root of excluded) root.traverse(object => {
141
+ for (const material of materialsOf(object)) if (!included.has(material)) materials.add(material);
142
+ });
143
+ return materials;
144
+ }
145
+
146
+ function exteriorJobs(scene: THREE.Scene, rt: THREE.WebGLRenderTarget | null, shadows: boolean, roots?: readonly THREE.Object3D[], per = 6,
147
+ resolve?: ShadowDepthResolver, leaving: readonly THREE.Object3D[] = [], from?: THREE.Vector3): CompileJob[] {
148
+ const steps = exteriorJobSteps(scene, rt, shadows, roots, per, resolve, leaving, from);
149
+ for (;;) { const step = steps.next(); if (step.done) return step.value; }
150
+ }
151
+
152
+ function* exteriorJobSteps(scene: THREE.Scene, rt: THREE.WebGLRenderTarget | null, shadows: boolean, roots?: readonly THREE.Object3D[], per = 6,
153
+ resolve?: ShadowDepthResolver, leaving: readonly THREE.Object3D[] = [], from?: THREE.Vector3): Generator<void, CompileJob[]> {
154
+ const registered = exteriorLighting.get(scene);
155
+ if (registered === undefined) return [];
156
+ // `leaving`: content that goes with the entered frame's owner (its staged camera models) never draws outside either
157
+ const state = leaving.length === 0 ? registered : { environment: registered.environment, roots: new Set([...registered.roots, ...leaving]) };
158
+ const target = createCompileScene(scene);
159
+ const lights = new CompileLights();
160
+ // the road draws with the page's own environment (a layer swaps a cell's in only while it renders, `BackdropLayer.apply`):
161
+ // with none declared, the live page environment keys the exterior variant (G639: a null one keyed Driftwood's road
162
+ // programs without the page PMREM, so they all linked on the first road frame)
163
+ target.fog = scene.fog; target.environment = state.environment ?? scene.environment;
164
+ const pending: THREE.Object3D[] = [scene];
165
+ while (pending.length > 0) {
166
+ const object = pending.pop();
167
+ if (object === undefined || !object.visible || state.roots.has(object)) continue;
168
+ if (object instanceof THREE.Light) target.add(lights.copy(object));
169
+ for (let i = object.children.length - 1; i >= 0; i--) { const child = object.children[i]; if (child !== undefined) pending.push(child); }
170
+ yield;
171
+ }
172
+ const exterior = (yield* sceneJobSteps(scene, rt, roots === undefined ? per : 1, roots ?? [scene], state.roots, undefined, from)).jobs;
173
+ // Only whole-scene family preparation consumes this exclusion set. A root warm-up (a sky or clip variant) must
174
+ // not walk every parked resident just to discard its material inventory.
175
+ const excludedMaterials = new Set<THREE.Material>();
176
+ if (roots === undefined) {
177
+ const materials = new Set<THREE.Material>();
178
+ for (const job of exterior) job.root.traverse(object => { for (const material of materialsOf(object)) materials.add(material); });
179
+ for (const root of state.roots) root.traverse(object => { for (const material of materialsOf(object)) if (!materials.has(material)) excludedMaterials.add(material); });
180
+ }
181
+ const jobs = roots === undefined
182
+ ? [...exterior, ...familyCompileJobs(scene, rt, per, excludedMaterials), ...(shadows ? shadowJobs(scene, rt, per, state.roots, resolve) : [])]
183
+ : exterior;
184
+ // Passes with their own scene keep their authored state. Only the page world/depth variants transition outside.
185
+ for (const job of jobs) if (job.target === scene) { job.target = target; job.lights = lights; }
186
+ // A view root's warm-up (`roots`): also the variant for every other environment the road may draw with, one per cube
187
+ // height (a cell's layer swaps its PMREM in by weight; G639: Driftwood's, Nalati's and Pine's ring and road views linked
188
+ // their 256 / 512 / 1024 variants on the first road frame beside each, 150-270 ms each with a cold shader cache)
189
+ if (roots !== undefined) {
190
+ const own = target.environment, height = (t: THREE.Texture | null): unknown => (t === null ? null : Reflect.get(t.image ?? {}, 'height'));
191
+ for (const environment of pageEnvironments()) {
192
+ if (height(environment) === height(own)) continue;
193
+ const lit = (yield* sceneJobSteps(scene, rt, 1, roots, state.roots)).jobs;
194
+ for (const job of lit) if (job.target === scene) { job.target = target; job.lights = lights; job.environment = environment; }
195
+ jobs.push(...lit);
196
+ }
197
+ }
198
+ return jobs;
199
+ }
200
+
201
+ /** Resolve an entered world's programs, then warm the actual depth/post pass targets without advancing simulation.
202
+ * The entered owner fences both phases; the renderer target is restored even if a pass fails. */
203
+ export async function warmComposerFrame(composer: Pick<EffectComposer, 'render'>,
204
+ renderer: Pick<Renderer, 'getRenderTarget' | 'setRenderTarget'>, prepare: () => Promise<unknown>, current: () => boolean): Promise<void> {
205
+ if (!current()) throw new Error('Entered frame left before shader warm-up');
206
+ await prepare();
207
+ if (!current()) throw new Error('Entered frame left during shader warm-up');
208
+ const target = renderer.getRenderTarget();
209
+ try { composer.render(0); } finally { renderer.setRenderTarget(target); }
210
+ }
211
+
212
+ /** any scene object, with the mesh-ish fields the program key reads (all optional: lights, groups and bones have none) */
213
+ type MeshLike = THREE.Object3D & { isMesh?: boolean; geometry?: THREE.BufferGeometry; material?: THREE.Material | THREE.Material[]; isInstancedMesh?: boolean; instanceColor?: THREE.InstancedBufferAttribute | null; isSkinnedMesh?: boolean; skeleton?: THREE.Skeleton; isPoints?: boolean; isLine?: boolean; isSprite?: boolean };
214
+
215
+ /** The parts of an object that change its material's program (including shadow/skin layouts); `positionOnly` drops the
216
+ * attribute bits a position-only override pass never reads. */
217
+ export function programObjectKey(o: BatchedLike, positionOnly = false): string {
218
+ const g = o.geometry;
219
+ const a: THREE.NormalBufferAttributes = g?.attributes ?? {};
220
+ const morph = g?.morphAttributes ? Object.keys(g.morphAttributes).map((k) => `${k}${g.morphAttributes[k as 'position']?.length ?? 0}`).join('') : '';
221
+ // The facade shares one material between its shell and a colored BatchedMesh.
222
+ // Both batching bits are shader defines; omitting them skips the batch until its first draw.
223
+ // An RGBA colour channel is three's vertexAlphas bit: Nine's coarse facades share one material between RGB and RGBA pieces.
224
+ return `${o.isBatchedMesh ? 'B' : ''}${o.isBatchedMesh && o._colorsTexture ? 'K' : ''}${o.isInstancedMesh ? 'I' : ''}${o.instanceColor ? 'C' : ''}${o.isSkinnedMesh ? `S${String(o.skeleton?.bones.length ?? 0)}` : ''}${o.isPoints ? 'P' : ''}${o.isLine ? 'L' : ''}${o.isSprite ? 'Q' : ''}${o.receiveShadow ? 'R' : ''}` +
225
+ `|${positionOnly ? '' : `${a['uv1'] ? 1 : 0}${a['uv2'] ? 1 : 0}${a['uv3'] ? 1 : 0}${a['tangent'] ? 1 : 0}${a['color'] ? a['color'].itemSize === 4 ? 2 : 1 : 0}${a['normal'] ? 1 : 0}`}|${morph}`;
226
+ }
227
+
228
+ function materialProperties(renderer: Renderer, material: THREE.Material): object | undefined {
229
+ // Test doubles of the renderer carry no property store.
230
+ const store: unknown = Reflect.get(renderer, 'properties');
231
+ const get: unknown = typeof store === 'object' && store !== null ? Reflect.get(store, 'get') : undefined;
232
+ const properties: unknown = typeof get === 'function' ? Reflect.apply(get, store, [material]) : undefined;
233
+ return typeof properties === 'object' && properties !== null ? properties : undefined;
234
+ }
235
+
236
+ /** Only an already allocated, ordinary single-sample 2D target can be cheap
237
+ * before this warm-up. Compare its native handle across setRenderTarget and
238
+ * compile; absent stores, allocation, replacement and disposal stay unknown. */
239
+ function allocatedTarget(renderer: Renderer, target: THREE.WebGLRenderTarget | null): object | undefined {
240
+ if (target === null || Object.getPrototypeOf(target) !== THREE.WebGLRenderTarget.prototype || target.samples !== 0 || target.textures.length !== 1) return undefined;
241
+ const store: unknown = Reflect.get(renderer, 'properties');
242
+ if (typeof store !== 'object' || store === null) return undefined;
243
+ const has: unknown = Reflect.get(store, 'has'), get: unknown = Reflect.get(store, 'get');
244
+ if (typeof has !== 'function' || typeof get !== 'function' || Reflect.apply(has, store, [target]) !== true) return undefined;
245
+ const properties: unknown = Reflect.apply(get, store, [target]);
246
+ if (typeof properties !== 'object' || properties === null || Reflect.get(properties, '__useDefaultFramebuffer') !== undefined
247
+ || Reflect.get(properties, '__hasExternalTextures') === true
248
+ || target.depthBuffer && Reflect.get(properties, '__boundDepthTexture') !== target.depthTexture) return undefined;
249
+ const framebuffer: unknown = Reflect.get(properties, '__webglFramebuffer');
250
+ return typeof framebuffer === 'object' && framebuffer !== null && !Array.isArray(framebuffer) ? framebuffer : undefined;
251
+ }
252
+
253
+ /** The program a material last compiled to (three's material properties), or undefined; identity only. */
254
+ function currentProgram(renderer: Renderer, material: THREE.Material): unknown {
255
+ const properties = materialProperties(renderer, material);
256
+ return properties === undefined ? undefined : Reflect.get(properties, 'currentProgram');
257
+ }
258
+
259
+ // compile() can visit several object layouts for one material in a batch. Its
260
+ // currentProgram is only the last one; all acquired layouts need block metadata.
261
+ function materialPrograms(renderer: Renderer, material: THREE.Material): readonly unknown[] {
262
+ const properties = materialProperties(renderer, material);
263
+ const programs: unknown = properties === undefined ? undefined : Reflect.get(properties, 'programs');
264
+ return programs instanceof Map ? [...programs.values()] : [currentProgram(renderer, material)];
265
+ }
266
+ /** The objects with a material no pass has built yet: `arrival`'s filter for a second pass over a scene that gained a few, which
267
+ * costs what they cost and not the whole scene's walk (a server's first bodies: 2.4 s of Pine's warm load at phone CPU). */
268
+ export function unbuiltObjects(renderer: Renderer): (object: THREE.Object3D) => boolean {
269
+ return object => materialsOf(object).some(material => materialPrograms(renderer, material).every(program => program === undefined));
270
+ }
271
+
272
+ /** compile() selects its new program on the borrowed material. Keep the last real draw's selection while
273
+ * that variant links across painted waits; retain the expanded program cache for its later real use. */
274
+ function holdDrawnPrograms(renderer: Renderer, root: THREE.Object3D): () => void {
275
+ const held: { material: THREE.Material; properties: object; fields: Map<PropertyKey, unknown>;
276
+ uniforms: { uniform: object; value: unknown }[] }[] = [];
277
+ const seen = new Set<THREE.Material>();
278
+ root.traverse(object => {
279
+ for (const material of materialsOf(object)) {
280
+ if (seen.has(material)) continue;
281
+ seen.add(material);
282
+ const properties = materialProperties(renderer, material);
283
+ // __version is set by setProgram on a real draw, not by compile. Never restore an unrendered variant.
284
+ if (properties === undefined || Reflect.get(properties, '__version') !== material.version ||
285
+ Reflect.get(properties, 'currentProgram') === undefined) continue;
286
+ const fields = new Map<PropertyKey, unknown>();
287
+ for (const key of Reflect.ownKeys(properties)) if (key !== 'programs') fields.set(key, Reflect.get(properties, key));
288
+ const uniforms: { uniform: object; value: unknown }[] = [];
289
+ const values: unknown = Reflect.get(properties, 'uniforms');
290
+ if (typeof values === 'object' && values !== null) for (const key of Reflect.ownKeys(values)) {
291
+ const uniform: unknown = Reflect.get(values, key);
292
+ if (typeof uniform === 'object' && uniform !== null && Object.hasOwn(uniform, 'value')) {
293
+ uniforms.push({ uniform, value: Reflect.get(uniform, 'value') });
294
+ }
295
+ }
296
+ held.push({ material, properties, fields, uniforms });
297
+ }
298
+ });
299
+ return () => {
300
+ for (const { material, properties, fields, uniforms } of held) {
301
+ if (materialProperties(renderer, material) !== properties) continue;
302
+ for (const key of Reflect.ownKeys(properties)) if (key !== 'programs' && !fields.has(key)) Reflect.deleteProperty(properties, key);
303
+ for (const [key, value] of fields) Reflect.set(properties, key, value);
304
+ for (const { uniform, value } of uniforms) Reflect.set(uniform, 'value', value);
305
+ }
306
+ };
307
+ }
308
+
309
+ /** Whether three has destroyed this program across an await: its cache evicts an unused program (its last material
310
+ * disposed, as a road journey retires a cell) by deleting the native program and setting `.program` to undefined. A
311
+ * retired identity has nothing left to prepare, and any query of it would hand `getProgramParameter` an undefined
312
+ * program (WebKit: 'Argument 1 ... is not a WebGLProgram', CI's road journey on fa1da6a58c). */
313
+ export function nativeRetired(program: object): boolean {
314
+ // three's program always carries the key (set in its constructor, emptied by destroy()); an object without it (a
315
+ // test double, a foreign holder) is not a retired three program
316
+ if (!Reflect.has(program, 'program')) return false;
317
+ const handle: unknown = Reflect.get(program, 'program');
318
+ return handle === undefined || handle === null;
319
+ }
320
+
321
+ /** DL21: an upload this long (ms) is named in a Developer measure, 'wildshard.precompile.upload:<name>' (the DL23 recordings
322
+ * keep every measure), with its size and bytes. */
323
+ const SLOW_UPLOAD_MS = 100;
324
+ function slowUpload(texture: THREE.Texture, start: number, bytes: number): void {
325
+ const image: unknown = texture.image, source = typeof image === 'object' && image !== null ? Reflect.get(image, 'currentSrc') ?? Reflect.get(image, 'src') : undefined;
326
+ const width = typeof image === 'object' && image !== null ? Reflect.get(image, 'width') : undefined, height = typeof image === 'object' && image !== null ? Reflect.get(image, 'height') : undefined;
327
+ const name = texture.name !== '' ? texture.name : typeof source === 'string' ? source.slice(-80) : `texture-${String(texture.id)}`;
328
+ performance.measure(`wildshard.precompile.upload:${name}`, { start, end: performance.now(),
329
+ detail: { bytes, width: typeof width === 'number' ? width : null, height: typeof height === 'number' ? height : null, compressed: texture instanceof THREE.CompressedTexture } });
330
+ }
331
+
332
+ /** How many programs the renderer holds (0 for a test double without `info.programs`). */
333
+ function programCount(renderer: Renderer): number {
334
+ const info: unknown = Reflect.get(renderer, 'info');
335
+ const programs: unknown = typeof info === 'object' && info !== null ? Reflect.get(info, 'programs') : undefined;
336
+ return Array.isArray(programs) ? programs.length : 0;
337
+ }
338
+
339
+ /** the object lives on the shadow pass's layer alone (no view camera ever draws it) */
340
+ const shadowOnly = (o: THREE.Object3D): boolean => o.layers.mask === 1 << SHADOW_LAYER;
341
+ /** the geometry and group a classic graph's pre-compile `onBeforeRender` is handed (it reads neither) */
342
+ const NO_GEOMETRY = new THREE.BufferGeometry(), NO_GROUP = new THREE.Group();
343
+ function materialsOf(o: THREE.Object3D): THREE.Material[] { const m = (o as MeshLike).material; return Array.isArray(m) ? m : m ? [m] : []; }
344
+ /** NR4: a geometry with no channels and no index (a refining mesh's placeholder before its first fine tile) cannot
345
+ * draw; a program compiled against it reads every attribute as a constant (three warns per channel), so it waits
346
+ * for its first real draw */
347
+ function channelless(o: THREE.Object3D): boolean {
348
+ const geometry = (o as MeshLike).geometry;
349
+ return geometry instanceof THREE.BufferGeometry && geometry.index === null && Object.keys(geometry.attributes).length === 0;
350
+ }
351
+
352
+ type BatchedLike = MeshLike & { isBatchedMesh?: boolean; _colorsTexture?: THREE.DataTexture | null };
353
+
354
+ /** An exterior frame excludes the same owned subtrees as its light inventory, including nested roots. */
355
+ function compileObjects(root: THREE.Object3D, visit: (object: THREE.Object3D) => void, excludedRoots?: ReadonlySet<THREE.Object3D>): void {
356
+ if (excludedRoots === undefined) { root.traverse(visit); return; }
357
+ const walk = (object: THREE.Object3D): void => {
358
+ if (excludedRoots.has(object)) return;
359
+ visit(object);
360
+ for (const child of object.children) walk(child);
361
+ };
362
+ walk(root);
363
+ }
364
+ /** NF15: a classic graph that reads instance colours gives the live mesh its white ones first (its draw hook gives them
365
+ * only after a frame), so a copy compiles the coloured program the draws use */
366
+ function prepareInstances(mesh: MeshLike): void {
367
+ for (const material of materialsOf(mesh)) {
368
+ const prepare: unknown = Reflect.get(material, 'prepareInstances');
369
+ if (typeof prepare === 'function') Reflect.apply(prepare, material, [mesh]);
370
+ }
371
+ }
372
+ /**
373
+ * A detached stand-in for `mesh` that computes the same program: `clone(false)` keeps the
374
+ * instancing / skinning / morph flags, geometry and skeleton. BatchedMesh.copy in r186 never
375
+ * copies `_colorsTexture` (it tests the destination, which is null), yet `batchingColor` is a
376
+ * cache-key bit — carry the reference over, or the forest's four materials and three depth
377
+ * variants compile again at the first frame.
378
+ */
379
+ function standIn(mesh: MeshLike): MeshLike {
380
+ prepareInstances(mesh);
381
+ const copy = mesh.clone(false) as BatchedLike;
382
+ const src = mesh as BatchedLike;
383
+ if (src.isBatchedMesh && src._colorsTexture && !copy._colorsTexture) copy._colorsTexture = src._colorsTexture;
384
+ // compile() walks visible objects only: a culled level (an LOD step hidden until its first draw) still needs its program
385
+ copy.visible = true;
386
+ linkStandIn(copy, mesh); // its uploads belong to the mesh's owner (SF57 upload-owner)
387
+ return copy;
388
+ }
389
+
390
+ /**
391
+ * One detached clone per distinct (material, object-flags) pair, grouped `per` clones a job.
392
+ * `clone(false)` keeps the instancing / skinning / morph flags and the geometry that pick the
393
+ * variant, without touching live visibility or parents (gauntlet's compileMaterials).
394
+ * `roots` restricts the borrowed inventory while retaining the target scene's lights, fog and environment.
395
+ * `excludedRoots` omits content that leaves with an exterior frame's lighting, without changing live visibility.
396
+ * `from` orders the jobs by distance from it to what each draws, nearest first.
397
+ */
398
+ export function sceneJobs(scene: THREE.Scene, rt: THREE.WebGLRenderTarget | null, per = 6, roots: readonly THREE.Object3D[] = [scene],
399
+ excludedRoots?: ReadonlySet<THREE.Object3D>, from?: THREE.Vector3): { jobs: CompileJob[]; materials: number } {
400
+ const steps = sceneJobSteps(scene, rt, per, roots, excludedRoots, undefined, from);
401
+ for (;;) { const step = steps.next(); if (step.done) return step.value; }
402
+ }
403
+
404
+ function* sceneJobSteps(scene: THREE.Scene, rt: THREE.WebGLRenderTarget | null, per: number, roots: readonly THREE.Object3D[],
405
+ excludedRoots?: ReadonlySet<THREE.Object3D>, include?: (object: THREE.Object3D) => boolean, from?: THREE.Vector3): Generator<void, { jobs: CompileJob[]; materials: number }> {
406
+ const seen = new Set<string>();
407
+ const mats = new Set<THREE.Material>();
408
+ const clones: { readonly object: THREE.Object3D; readonly side?: CompileJob['materialSide']; readonly distance: number }[] = [];
409
+ const pending = [...roots].reverse();
410
+ while (pending.length > 0) {
411
+ const o = pending.pop();
412
+ if (o === undefined || excludedRoots?.has(o) === true) continue;
413
+ for (let i = o.children.length - 1; i >= 0; i--) { const child = o.children[i]; if (child !== undefined) pending.push(child); }
414
+ const mesh = o as MeshLike;
415
+ // G743: a shadow-only object (its layers are the shadow pass's alone: shadowChunks.ts' pieces) is never drawn by a
416
+ // view, so its view program is never used; the shadow jobs warm the depth program it does draw with
417
+ const materials = shadowOnly(o) || channelless(o) ? [] : materialsOf(mesh), list = materials.length > 0 && include !== undefined && !include(o) ? [] : materials;
418
+ if (list.length === 0) { yield; continue; }
419
+ // DL23: every included mesh takes its white instance colours before its key is read, not only the first of its
420
+ // (material, key) pair: a second colourless twin kept the colourless key the first had left, drew colourless at its
421
+ // first parked draw and linked that program there (Nine's instanced architecture, Simulator frames of 456-711 ms)
422
+ prepareInstances(mesh);
423
+ const ok = programObjectKey(mesh);
424
+ const wanted = list.filter((m) => { mats.add(m); const k = m.uuid + ok; if (seen.has(k)) return false; seen.add(k); return true; });
425
+ const distance = from === undefined || wanted.length === 0 ? 0 : boundsDistance(o, from);
426
+ // A mesh's material array can contain many distinct programs. Count each
427
+ // as one unit too, so a live `per = 1` job cannot hide an atomic batch.
428
+ for (const material of wanted) {
429
+ // Three's compile otherwise issues both face programs synchronously.
430
+ const sides = material.transparent && material.side === THREE.DoubleSide && !material.forceSinglePass
431
+ ? [THREE.BackSide, THREE.FrontSide] : [undefined];
432
+ for (const side of sides) {
433
+ const copy = standIn(mesh);
434
+ copy.material = material;
435
+ clones.push({ object: copy, distance, ...(side === undefined ? {} : { side: { material, side } }) });
436
+ }
437
+ yield;
438
+ }
439
+ if (wanted.length === 0) yield;
440
+ }
441
+ // nearest first: what the player reaches soonest links soonest (a stable sort keeps a material's face pair together)
442
+ if (from !== undefined) clones.sort((a, b) => a.distance - b.distance);
443
+ const jobs: CompileJob[] = [];
444
+ for (let i = 0; i < clones.length;) {
445
+ const root = new THREE.Group();
446
+ const first = clones[i], start = i;
447
+ if (first === undefined) break;
448
+ do {
449
+ const clone = clones[i++]; if (clone !== undefined) root.add(clone.object);
450
+ } while (i < clones.length && i - start < per && first.side === undefined && clones[i]?.side === undefined);
451
+ jobs.push({ label: engineString('s_4bdf150dd0ed', [start]), root, target: scene, rt,
452
+ ...(first.side === undefined ? {} : { materialSide: first.side }) });
453
+ yield;
454
+ }
455
+ return { jobs, materials: mats.size };
456
+ }
457
+
458
+ function pacedSceneJobs(scene: THREE.Scene, rt: THREE.WebGLRenderTarget | null, per: number, roots: readonly THREE.Object3D[],
459
+ excluded: ReadonlySet<THREE.Object3D> | undefined, current: () => boolean, owner: Scope, include?: (object: THREE.Object3D) => boolean,
460
+ from?: THREE.Vector3): Promise<{ jobs: CompileJob[]; materials: number }> {
461
+ return pacedPreparation(sceneJobSteps(scene, rt, per, roots, excluded, include, from), current, owner);
462
+ }
463
+
464
+ const boundsCentre = new THREE.Vector3();
465
+ /** How far `object`'s drawn bounds lie from `at`: its bounding sphere's (an instanced or batched mesh's own, else its
466
+ * geometry's, as three's frustum test last computed it) centre's distance less the radius; its origin's without one. */
467
+ function boundsDistance(object: THREE.Object3D, at: THREE.Vector3): number {
468
+ const own: unknown = Reflect.get(object, 'boundingSphere'), geometry: unknown = Reflect.get(object, 'geometry');
469
+ const sphere = own instanceof THREE.Sphere ? own : geometry instanceof THREE.BufferGeometry ? geometry.boundingSphere : null;
470
+ if (sphere === null) return boundsCentre.setFromMatrixPosition(object.matrixWorld).distanceTo(at);
471
+ boundsCentre.copy(sphere.center).applyMatrix4(object.matrixWorld);
472
+ return Math.max(0, boundsCentre.distanceTo(at) - sphere.radius * object.matrixWorld.getMaxScaleOnAxis());
473
+ }
474
+
475
+ /** Discovery shares the ordinary measured build budget. Live root callers retain their completed-draw barrier; cheap
476
+ * desktop discovery stays in one turn. No borrowed flags/materials are changed while an iterator is suspended. */
477
+ async function pacedPreparation<T>(steps: Generator<void, T>, current: () => boolean, owner: Scope,
478
+ pause?: () => Promise<void>): Promise<T> {
479
+ let slice = workSlice(undefined, owner);
480
+ for (;;) {
481
+ if (!current()) throw new Error('Shader preparation owner left');
482
+ const step = steps.next(); if (step.done) return step.value;
483
+ if (slice.due()) {
484
+ await (pause === undefined ? slice.yield() : pause());
485
+ slice = workSlice(undefined, owner);
486
+ }
487
+ }
488
+ }
489
+
490
+ /**
491
+ * sp-o100: the bound for a live warm-up on a paced page that does not isolate its uploads (desktop Chromium's entered
492
+ * frame). The 12 ms boot bound is checked after the fact, so a slice ran 12 ms plus its last unit (a six-material job, a
493
+ * 15 ms first link query) on top of the frame's own 3-5 ms of game work: Pine's road entry drew five of its ten
494
+ * double-vsync travel frames in its warm-up. Live slices also issue one material a job.
495
+ */
496
+ export const LIVE_PRECOMPILE_SLICE_MS = 6;
497
+
498
+ /**
499
+ * A warmed program's link check (D176), once it has linked: one LINK_STATUS read. three's own check
500
+ * (`renderer.debug.checkShaderErrors`, off since D176) read the program's and both shaders' info logs on every program's
501
+ * first use. A failure is reported as three reports it (`THREE.WebGLProgram: Shader Error`, its material, the program and
502
+ * shader logs), so the boot smoke and the console still see a broken shader. Returns whether the link failed.
503
+ */
504
+ export function reportLinkFailure(gl: Pick<WebGL2RenderingContext, 'LINK_STATUS' | 'VALIDATE_STATUS' | 'SHADER_TYPE' | 'VERTEX_SHADER' | 'getProgramParameter'
505
+ | 'getAttachedShaders' | 'getShaderParameter' | 'getShaderInfoLog' | 'getProgramInfoLog' | 'getError'>, program: Pick<ProgramLike, 'program' | 'name' | 'type'>): boolean {
506
+ if (gl.getProgramParameter(program.program, gl.LINK_STATUS) !== false) return false;
507
+ const shaders = (gl.getAttachedShaders(program.program) ?? []).map(shader =>
508
+ `${gl.getShaderParameter(shader, gl.SHADER_TYPE) === gl.VERTEX_SHADER ? 'vertex' : 'fragment'} shader log: ${gl.getShaderInfoLog(shader) ?? ''}`);
509
+ console.error(`THREE.WebGLProgram: Shader Error ${String(gl.getError())} - VALIDATE_STATUS ${String(gl.getProgramParameter(program.program, gl.VALIDATE_STATUS))}\n\n`
510
+ + `Material Name: ${program.name}\nMaterial Type: ${program.type}\n\nProgram Info Log: ${gl.getProgramInfoLog(program.program) ?? ''}\n${shaders.join('\n')}`);
511
+ return true;
512
+ }
513
+
514
+ /** Prepare newly resident roots against current page lighting and its declared exterior state before exposure.
515
+ * Borrow original materials and object flags in the ordinary painted compile/link/upload slices. Live parents,
516
+ * visibility, uniforms, lighting and render targets stay unchanged; the resident owner fences every slice.
517
+ * An optional live-draw barrier spaces batches; initial boot uses ordinary browser paint opportunities.
518
+ * An optional upload budget batches the isolated image uploads per drawn frame (op-hitch32).
519
+ * A parked group may borrow its installing scene's environment; owner-only equipment can omit exterior variants.
520
+ * `from` orders the exterior variants by distance from it to what draws them, nearest first. */
521
+ export async function prepareSceneRoots(renderer: Renderer, camera: THREE.Camera, scene: THREE.Scene,
522
+ target: THREE.WebGLRenderTarget | null, roots: readonly THREE.Object3D[], current: () => boolean, pause?: () => Promise<void>,
523
+ uploadBudget?: UploadBudget, scenePrograms = true, futureLighting?: THREE.Object3D, futureEnvironment?: THREE.Texture, exteriorPrograms = true,
524
+ from?: THREE.Vector3): Promise<void> {
525
+ let discovery = workSlice(undefined, pageScope);
526
+ await prepareSceneResources(roots, camera, current);
527
+ // `scenePrograms` false: the roots' resources and exterior variants only (the boot's Shaders step builds what its first
528
+ // frame draws, and the rest is warmed in play)
529
+ const { jobs, materials } = !scenePrograms ? { jobs: [], materials: 0 } : pause === undefined
530
+ ? sceneJobs(scene, target, 1, roots)
531
+ : await pacedPreparation(sceneJobSteps(scene, target, 1, roots), current, pageScope, pause);
532
+ // a parked region's content compiles against the lights its first visible frame has (G639: a Nalati clip variant made
533
+ // during entry was prepared under the road's lights and linked again at its first lit draw, 134 ms)
534
+ if (futureLighting !== undefined) includeFutureLights(jobs, scene, futureLighting, futureEnvironment);
535
+ // Discovery only constructs detached jobs. Cheap phases share the CPU slice;
536
+ // native compile/link/upload retain runPrecompile's completed-draw fences.
537
+ if (pause !== undefined && discovery.due()) { await pause(); discovery = workSlice(undefined, pageScope); }
538
+ if (!current()) throw new Error('Shader preparation owner left');
539
+ if (exteriorPrograms) jobs.push(...(pause === undefined ? exteriorJobs(scene, target, false, roots, 6, undefined, [], from)
540
+ : await pacedPreparation(exteriorJobSteps(scene, target, false, roots, 6, undefined, [], from), current, pageScope, pause)));
541
+ if (pause !== undefined && discovery.due()) await pause();
542
+ if (!current()) throw new Error('Shader preparation owner left');
543
+ await runPrecompile(renderer, camera, jobs, materials, undefined, undefined, current, pause !== undefined, pause, uploadBudget, undefined,
544
+ pause === undefined ? undefined : LIVE_PRECOMPILE_SLICE_MS);
545
+
546
+ }
547
+
548
+ /** Prepare registered override passes with their real caster flags and camera layers. Borrowed materials, geometry,
549
+ * textures and scene state stay untouched; each pass is compiled into its own real target in the ordinary slices.
550
+ * Optional excluded roots defer passes owned by another hidden entered-frame hierarchy. */
551
+ export function offscreenJobs(scene: THREE.Scene, per = 1, excludedRoots?: ReadonlySet<THREE.Object3D>): CompileJob[] {
552
+ const isScene = (object: THREE.Object3D): object is THREE.Scene => object instanceof THREE.Scene;
553
+ const jobs: CompileJob[] = [];
554
+ compileObjects(scene, object => {
555
+ if (!isScene(object)) return;
556
+ for (const pass of offscreenPreparations(object)) {
557
+ const seen = new Set<string>(), clones: THREE.Object3D[] = [];
558
+ for (const root of pass.roots()) root.traverseVisible(caster => {
559
+ const mesh = caster as MeshLike;
560
+ if (!mesh.layers.test(pass.camera.layers) || channelless(mesh)) return;
561
+ // A real render builds its list from visible materials and, for arrays, authored geometry groups.
562
+ // compile() does neither, so do not create programs for slots the pass cannot draw.
563
+ const materials = materialsOf(mesh);
564
+ const drawable = (material: THREE.Material | undefined): boolean => material?.visible === true && material.allowOverride;
565
+ const eligible = Array.isArray(mesh.material)
566
+ ? mesh.geometry?.groups.some(group => drawable(materials[group.materialIndex ?? 0])) === true
567
+ : materials.some(drawable);
568
+ if (!eligible) return;
569
+ const key = programObjectKey(mesh, pass.positionOnly);
570
+ if (seen.has(key)) return;
571
+ seen.add(key);
572
+ const copy = standIn(mesh);
573
+ copy.material = pass.material;
574
+ clones.push(copy);
575
+ });
576
+ for (let i = 0; i < clones.length; i += per) {
577
+ const root = new THREE.Group();
578
+ for (const clone of clones.slice(i, i + per)) root.add(clone);
579
+ jobs.push({ label: pass.label, root, target: object, rt: pass.target, camera: pass.camera });
580
+ }
581
+ }
582
+ }, excludedRoots);
583
+ return jobs;
584
+ }
585
+
586
+ /** Compile a parked subtree against the light counts its first visible frame will have. Three gathers visible lights
587
+ * from both the target scene and each job root. Detached light clones add only the future lights absent from the
588
+ * target's visible traversal; live visibility, intensity, parents and the page's drawn light count stay unchanged.
589
+ * A future scene's environment is likewise borrowed during compile: a parked sky can have a different PMREM layout
590
+ * from the road. Post/background jobs targeting another scene keep that scene's lighting. */
591
+ export function includeFutureLights(jobs: readonly CompileJob[], target: THREE.Scene, future: THREE.Object3D,
592
+ environment: THREE.Texture | null = future instanceof THREE.Scene ? future.environment : null): void {
593
+ if (future === target) return;
594
+ const visible = new Set<THREE.Light>();
595
+ target.traverseVisible(object => { if (object instanceof THREE.Light) visible.add(object); });
596
+ const added: THREE.Light[] = [];
597
+ const visit = (object: THREE.Object3D): void => {
598
+ // Only the parked root is hidden by admission; authored descendant visibility still governs the future draw.
599
+ if (object !== future && !object.visible) return;
600
+ if (object instanceof THREE.Light && !visible.has(object)) added.push(object);
601
+ for (const child of object.children) visit(child);
602
+ };
603
+ visit(future);
604
+ // G808: the jobs share one copy of each future light, re-parented into each job's root as it compiles (a Pine entry
605
+ // cloned every future light for each of its ~480 jobs: ~80 ms of light.clone at 4x)
606
+ const shared = new CompileLights();
607
+ for (const job of jobs) if (job.target === target) {
608
+ job.lights ??= shared;
609
+ job.futureLights = [...job.futureLights ?? [], ...added];
610
+ if (environment !== null) job.environment = environment;
611
+ }
612
+ }
613
+
614
+ /**
615
+ * A job's disposer made outside the function that collects the job's stand-ins (SF57 leak5). A closure shares its
616
+ * function's one context: made inside `shadowJobs`, the disposer (held by the warm-up's owner until that frame leaves)
617
+ * also held the stand-in list the scene walk filled, and so every caster's geometry, material and textures, including
618
+ * other residents' that retired meanwhile.
619
+ */
620
+ function disposerOf(resources: Iterable<{ dispose: () => void }>): () => void {
621
+ const held = [...resources];
622
+ return () => { for (const resource of held) resource.dispose(); };
623
+ }
624
+
625
+ /**
626
+ * The shadow pass's depth materials: WebGLShadowMap.getDepthMaterial picks the caster's
627
+ * customDepthMaterial, else the shared MeshDepthMaterial (BasicDepthPacking — r186 shadow maps are depth textures) with the caster
628
+ * material's map / alphaMap / alphaTest / displacement copied on and the side flipped — and it
629
+ * draws with no fog (renderBufferDirect's empty scene) and the main scene's lights.
630
+ * `excludedRoots` omits casters whose owned subtree cannot draw in the requested exterior frame.
631
+ */
632
+ export function shadowJobs(scene: THREE.Scene, rt: THREE.WebGLRenderTarget | null, per = 6, excludedRoots?: ReadonlySet<THREE.Object3D>,
633
+ resolve?: ShadowDepthResolver): CompileJob[] {
634
+ const flip: Record<number, THREE.Side> = { [THREE.FrontSide]: THREE.BackSide, [THREE.BackSide]: THREE.FrontSide, [THREE.DoubleSide]: THREE.DoubleSide };
635
+ const seen = new Set<string>();
636
+ const clones: THREE.Object3D[] = [];
637
+ const graphDepths: { copy: THREE.Object3D; prepare: () => void }[] = [];
638
+ const temporary = new Set<THREE.Material>();
639
+ compileObjects(scene, (o) => {
640
+ const mesh = o as MeshLike;
641
+ if (!mesh.castShadow || !mesh.isMesh && !mesh.isPoints && !mesh.isLine || channelless(mesh)) return;
642
+ const ok = programObjectKey(mesh);
643
+ for (const m of materialsOf(mesh)) {
644
+ const mat = m as THREE.MeshStandardMaterial;
645
+ let depth: THREE.Material;
646
+ let key: string;
647
+ if (mesh.customDepthMaterial) { depth = mesh.customDepthMaterial; key = `custom:${depth.uuid}|${ok}`; }
648
+ else {
649
+ const side = mat.shadowSide ?? flip[mat.side] ?? THREE.BackSide;
650
+ const disp = mat.displacementMap && mat.displacementScale !== 0 ? mat.displacementMap : null;
651
+ // a shader material (a classic graph program) has no displacement fields: three's defaults, not undefined
652
+ const scale: unknown = Reflect.get(m, 'displacementScale'), bias: unknown = Reflect.get(m, 'displacementBias');
653
+ const displacementScale = typeof scale === 'number' ? scale : 1, displacementBias = typeof bias === 'number' ? bias : 0;
654
+ const alphaTest = mat.alphaToCoverage ? 0.5 : mat.alphaTest;
655
+ key = `depth|${mat.map ? `m${mat.map.channel}` : ''}|${mat.alphaMap ? `a${mat.alphaMap.channel}` : ''}|${alphaTest > 0 ? 't' : ''}|${side}|${disp ? `d${disp.channel}` : ''}|${ok}`;
656
+ // sp-o289: a renderer whose shadow draw swaps this material's depth (a vertex-moving graph) gets that variant,
657
+ // configured from the same stock depth material, per source material: its program is its own.
658
+ const graphKey = resolve === undefined ? key : `${mat.uuid}|${key}`;
659
+ if (seen.has(key) && seen.has(graphKey)) continue;
660
+ const stock = new THREE.MeshDepthMaterial({ depthPacking: THREE.BasicDepthPacking, map: mat.map ?? null, alphaMap: mat.alphaMap ?? null, alphaTest, side, displacementMap: disp, displacementScale, displacementBias });
661
+ temporary.add(stock);
662
+ if (resolve !== undefined && resolve(m, stock) !== null) {
663
+ if (seen.has(graphKey)) continue;
664
+ seen.add(graphKey);
665
+ const copy = standIn(mesh);
666
+ // The variant is shared by its source's casters and reconfigured per draw: configure it at compile time.
667
+ const prepare = (): void => { const variant = resolve(m, stock); if (variant !== null) copy.material = variant; };
668
+ prepare();
669
+ graphDepths.push({ copy, prepare });
670
+ continue;
671
+ }
672
+ if (alphaTest > 0) depth = stock;
673
+ else {
674
+ // PF3 (shadowDepthKinds): a caster that does not alpha-test draws its depth with no texture
675
+ key = ['depth', '', '', '', side, disp ? `d${disp.channel}` : '', ok].join('|');
676
+ depth = new THREE.MeshDepthMaterial({ depthPacking: THREE.BasicDepthPacking, alphaTest, side, displacementMap: disp, displacementScale, displacementBias });
677
+ temporary.add(depth);
678
+ }
679
+ }
680
+ if (seen.has(key)) continue;
681
+ seen.add(key);
682
+ const copy = standIn(mesh);
683
+ copy.material = depth;
684
+ clones.push(copy);
685
+ }
686
+ }, excludedRoots);
687
+ // Generic variants for casters that appear after this step (a fired bolt, a fade clone, a detail LOD
688
+ // that pops in): opaque and alpha-tested — cache hits when the scene already had them.
689
+ // Opaque native depth draws omit maps; do not warm a texture-only duplicate.
690
+ const white = new THREE.DataTexture(new Uint8Array([255, 255, 255, 255]), 1, 1); white.needsUpdate = true;
691
+ const box = new THREE.BoxGeometry(1, 1, 1);
692
+ for (const [map, side, alphaTest] of [[null, THREE.BackSide, 0], [white, THREE.DoubleSide, 0.5]] as [THREE.Texture | null, THREE.Side, number][]) {
693
+ const key = `depth|${map ? 'm0' : ''}||${alphaTest > 0 ? 't' : ''}|${side}||generic`;
694
+ if (seen.has(key)) continue;
695
+ seen.add(key);
696
+ const depth = new THREE.MeshDepthMaterial({ depthPacking: THREE.BasicDepthPacking, map, alphaTest, side });
697
+ temporary.add(depth);
698
+ clones.push(new THREE.Mesh(box, depth));
699
+ }
700
+ const jobs: CompileJob[] = [];
701
+ for (let i = 0; i < clones.length; i += per) {
702
+ const root = new THREE.Group();
703
+ for (const c of clones.slice(i, i + per)) root.add(c);
704
+ jobs.push({ label: engineString('s_2a96df75489f', [i]), root, target: scene, rt, fogOff: true });
705
+ }
706
+ // One job each: a graph depth variant is configured for its caster just before its compile.
707
+ for (const [i, { copy, prepare }] of graphDepths.entries()) {
708
+ const root = new THREE.Group();
709
+ root.add(copy);
710
+ jobs.push({ label: engineString('s_2a96df75489f', [clones.length + i]), root, target: scene, rt, fogOff: true, prepare });
711
+ }
712
+ const first = jobs[0];
713
+ if (first !== undefined) first.dispose = disposerOf([...temporary, box, white]);
714
+ return jobs;
715
+ }
716
+
717
+ /** The sky background box (WebGLBackground's boxMesh) — same shader, same envMap kind, drawn into the scene target. */
718
+ export function backgroundJob(scene: THREE.Scene, rt: THREE.WebGLRenderTarget | null): CompileJob | null {
719
+ const bg = scene.background;
720
+ if (!bg || !('isTexture' in bg)) return null;
721
+ const cube = bg.mapping === THREE.CubeUVReflectionMapping ? bg : 'isCubeTexture' in bg ? bg : new THREE.CubeTexture(); // equirect → cube (WebGLCubeMaps)
722
+ const lib = THREE.ShaderLib['backgroundCube'];
723
+ if (lib === undefined) throw new Error('precompile: ShaderLib.backgroundCube is missing');
724
+ const envMap: THREE.IUniform<THREE.Texture> = { value: cube };
725
+ const mat = new THREE.ShaderMaterial({
726
+ name: 'BackgroundCubeMaterial', uniforms: { ...THREE.UniformsUtils.clone(lib.uniforms), envMap },
727
+ vertexShader: lib.vertexShader, fragmentShader: lib.fragmentShader,
728
+ side: THREE.BackSide, depthTest: false, depthWrite: false, fog: false,
729
+ });
730
+ Object.defineProperty(mat, 'envMap', { get: () => envMap.value });
731
+ mat.toneMapped = THREE.ColorManagement.getTransfer(bg.colorSpace) !== THREE.SRGBTransfer;
732
+ const geo = new THREE.BoxGeometry(1, 1, 1); geo.deleteAttribute('normal'); geo.deleteAttribute('uv');
733
+ const root = new THREE.Group(); root.add(new THREE.Mesh(geo, mat));
734
+ return { label: engineString('s_ff7f862b819f'), root, target: scene, rt,
735
+ dispose: () => { mat.dispose(); geo.dispose(); if (cube !== bg) cube.dispose(); } };
736
+ }
737
+
738
+ /**
739
+ * Every material the composer's passes own (fullscreen materials, the blur / luminance /
740
+ * downsample materials passes swap in, nested passes of effects), each on a screen triangle in an
741
+ * empty scene: no fog or lights, using internal pass targets where declared, otherwise the composer's
742
+ * buffer — except the pass that renders to screen. Targets and borrowed materials keep their identities.
743
+ */
744
+ export function postJobs(composer: Pick<EffectComposer, 'passes'>, rt: THREE.WebGLRenderTarget | null, per: number = Number.POSITIVE_INFINITY): CompileJob[] {
745
+ const found = new Map<THREE.Material, THREE.WebGLRenderTarget | null>();
746
+ // A scene pass can point back to its composer. Revisit a pass reached more directly so that
747
+ // an earlier, deeper route cannot exhaust the depth budget before its nested effects are read.
748
+ const visited = new Map<object, number>();
749
+ const walk = (v: unknown, targetIn: THREE.WebGLRenderTarget | null, depth: number): void => {
750
+ let target = targetIn;
751
+ if (v === null || typeof v !== 'object' || (visited.get(v) ?? Number.POSITIVE_INFINITY) <= depth || depth > 4) return;
752
+ // AGX never updates its adaptation passes. Bloom still draws luminance when its threshold is zero.
753
+ if (v instanceof ToneMappingEffect && v.mode !== ToneMappingMode.REINHARD2_ADAPTIVE) return;
754
+ if (v instanceof Pass && !v.enabled) return;
755
+ const o = v as Record<string, unknown> & { isMaterial?: boolean; isObject3D?: boolean; isScene?: boolean; isTexture?: boolean; isWebGLRenderTarget?: boolean; isCamera?: boolean; isMesh?: boolean };
756
+ if (o.isMaterial) {
757
+ const m = o as unknown as THREE.ShaderMaterial;
758
+ // The god-rays light source's MeshBasicMaterial already has its in-scene program.
759
+ const idle = !m.isShaderMaterial;
760
+ if (!idle && !found.has(m)) found.set(m, target);
761
+ return;
762
+ }
763
+ if (o.isTexture || o.isWebGLRenderTarget || o.isCamera || o.isScene || ArrayBuffer.isView(v)) return;
764
+ if (o.isObject3D) { if (o.isMesh) walk((o as unknown as THREE.Mesh).material, target, depth + 1); return; }
765
+ visited.set(v, depth);
766
+ // Internal luminance/blur passes draw into their own targets, whose depth
767
+ // attachment can differ from the composer's input even at the same format.
768
+ const ownTarget: unknown = Reflect.get(v, 'renderTarget');
769
+ if (ownTarget instanceof THREE.WebGLRenderTarget) target = ownTarget;
770
+ if (v instanceof Pass) {
771
+ target = v.renderToScreen ? null : ownTarget instanceof THREE.WebGLRenderTarget ? ownTarget : rt;
772
+ walk(v.fullscreenMaterial, target, depth + 1);
773
+ }
774
+ for (const [key, val] of Object.entries(o)) if (key !== 'composer') walk(val, target, depth + 1);
775
+ };
776
+ for (const pass of composer.passes) walk(pass, pass.renderToScreen ? null : rt, 0);
777
+ const tri = postTriangle();
778
+ const jobs: CompileJob[] = [];
779
+ const empty = new THREE.Scene();
780
+ const groups = new Map<THREE.WebGLRenderTarget | null, THREE.Group>();
781
+ for (const [material, target] of found) {
782
+ let group = groups.get(target);
783
+ if (group === undefined) { group = new THREE.Group(); groups.set(target, group); }
784
+ const mesh = new THREE.Mesh(tri, material); mesh.frustumCulled = false; group.add(mesh);
785
+ }
786
+ for (const [target, group] of groups) {
787
+ const label = target === null ? 's_9070659b32c3' : 's_178612197e2b';
788
+ const meshes = [...group.children];
789
+ for (let i = 0; i < meshes.length; i += per) {
790
+ const root = new THREE.Group();
791
+ for (const mesh of meshes.slice(i, i + per)) root.add(mesh);
792
+ jobs.push({ label: engineString(label), root, target: empty, rt: target });
793
+ }
794
+ }
795
+ const first = jobs[0];
796
+ if (first === undefined) tri.dispose(); else first.dispose = disposerOf([tri]);
797
+ return jobs;
798
+ }
799
+
800
+ /** Draw linked post materials individually into their existing targets before the first composer frame.
801
+ * Each completed draw gets a paint opportunity. No effect clock, simulation, target size or material is changed;
802
+ * the real composer overwrites these temporary pixels. Target face/mip are restored on failure and cancellation. */
803
+ export async function warmPostJobs(renderer: Pick<Renderer, 'getRenderTarget' | 'getActiveCubeFace' | 'getActiveMipmapLevel' | 'setRenderTarget' | 'render'>,
804
+ jobs: readonly CompileJob[], pause: () => Promise<void>, current: () => boolean,
805
+ onProgress?: (done: number, total: number, detail: string) => void,
806
+ /** LS11: `pause` settles the GPU (gpuSettled): each draw is credited only once it has, never before */
807
+ settles = false): Promise<void> {
808
+ // Some passes bind their sample arrays only inside render (desktop AO).
809
+ // Linking is safe before that binding; a stand-in draw is not. Leave those
810
+ // materials to their real pass rather than inventing values or advancing it.
811
+ // A material that samples its stand-in target's own attachment (the depth-sliced colour pass reads the scene target's
812
+ // depth, and its stand-in target is that scene target) is a feedback loop: WebGL refuses the draw with
813
+ // INVALID_OPERATION, which then fails the next texture upload's error check (the public Pine smoke's 'Graphics error
814
+ // 1282 before compressed texture'). The real composer draws it into its other buffer; it is left to that draw.
815
+ const feedback = (value: unknown, rt: THREE.WebGLRenderTarget | null): boolean => rt !== null && value instanceof THREE.Texture
816
+ && (value === rt.depthTexture || rt.textures.some(texture => texture === value));
817
+ const drawable = jobs.filter(job => {
818
+ const materials: THREE.Material[] = [];
819
+ job.root.traverse(object => { materials.push(...materialsOf(object)); });
820
+ return materials.every(material => !(material instanceof THREE.ShaderMaterial) || Object.values(material.uniforms).every(uniform => {
821
+ const value: unknown = uniform.value;
822
+ return value !== undefined && !(Array.isArray(value) && value.length === 0) && !(ArrayBuffer.isView(value) && value.byteLength === 0)
823
+ && !feedback(value, job.rt) && !(Array.isArray(value) && value.some(item => feedback(item, job.rt)));
824
+ }));
825
+ });
826
+ const camera = new THREE.OrthographicCamera(-1, 1, 1, -1, 0, 1);
827
+ for (const [index, job] of drawable.entries()) {
828
+ if (!current()) throw new Error('Shader warm-up owner left');
829
+ const target = renderer.getRenderTarget(), face = renderer.getActiveCubeFace(), mip = renderer.getActiveMipmapLevel();
830
+ try { renderer.setRenderTarget(job.rt); renderer.render(job.root, camera); }
831
+ finally { renderer.setRenderTarget(target, face, mip); }
832
+ const report = (): void => { onProgress?.(index + 1, drawable.length, `${index + 1} / ${drawable.length} post pipelines drawn`); };
833
+ if (!settles) report();
834
+ await pause();
835
+ if (settles) { if (!current()) throw new Error('Shader warm-up owner left'); report(); }
836
+ }
837
+ if (!current()) throw new Error('Shader warm-up owner left');
838
+ }
839
+
840
+ /**
841
+ * Every texture the first frame would upload — material maps, ShaderMaterial uniforms (the post
842
+ * chain's lookup tables included), the scene's background / environment — read off the compile jobs.
843
+ * Uploading (texImage + mipmaps, ~30 × 1024² on the phone) is otherwise the first draw's job,
844
+ * inside the first frame's stall.
845
+ */
846
+ export function collectTextures(jobs: CompileJob[]): THREE.Texture[] {
847
+ const out = new Set<THREE.Texture>();
848
+ const isTexture = (v: unknown): v is THREE.Texture => typeof v === 'object' && v !== null && (v as { isTexture?: boolean }).isTexture === true;
849
+ // Depth attachments are GPU-generated too, but Three does not mark them
850
+ // isRenderTargetTexture. Eager upload can revive a retired post uniform after
851
+ // its target released it; only the owning target may initialize that storage.
852
+ const add = (v: unknown): void => { if (isTexture(v) && !v.isRenderTargetTexture && !(v instanceof THREE.DepthTexture)) out.add(v); };
853
+ const fromMaterial = (m: THREE.Material): void => {
854
+ for (const v of Object.values(m)) add(v);
855
+ for (const texture of shaderPatchTextures(m)) add(texture);
856
+ const u = (m as THREE.Material & { uniforms?: Record<string, THREE.IUniform> }).uniforms;
857
+ if (u) for (const uni of Object.values(u)) add(uni.value);
858
+ };
859
+ // the jobs' clones carry every scene material, the post-chain materials and the background box;
860
+ // the target scenes carry the background / environment maps
861
+ for (const job of jobs) {
862
+ job.root.traverse((o) => { for (const m of materialsOf(o)) fromMaterial(m); });
863
+ if (job.target) { add(job.target.background); add(job.target.environment); }
864
+ add(job.environment);
865
+ }
866
+ return [...out];
867
+ }
868
+
869
+ const frame = (): Promise<void> => new Promise((resolve) => { pageScope.raf(() => { pageScope.timeout(0, resolve); }); }); // a real paint between (the page's: no ambient owner read mid-build, SF57)
870
+
871
+ /** Whether this preparation links one job at a time (LS11): a GPU without parallel compile, under a loading screen. */
872
+ const serialLoading = (renderer: Renderer, isolateImageUploads: boolean): boolean =>
873
+ !renderer.extensions.has('KHR_parallel_shader_compile') && !isolateImageUploads && !presenting();
874
+
875
+ /**
876
+ * LS11 (J204): `pause`, repeated until the GPU has finished what was submitted before it (a WebGL2 fence, asked once a
877
+ * pause, never waited on). SwiftShader at 4x CPU ran the shaders step's 19 texture uploads and two post draws in 50 ms of
878
+ * script, then held the main thread 1.1 s in the canvas read-back that waited for all of it. A lost context or a failed
879
+ * wait rejects as the first frame's fences do (FenceAbortError, 'WebGL context lost' for a loss), crediting nothing; a
880
+ * retired owner ends the wait and the caller's own check throws.
881
+ */
882
+ function gpuSettled(renderer: Renderer, pause: () => Promise<void>, current: () => boolean): () => Promise<void> {
883
+ return async () => {
884
+ const gl = renderer.getContext();
885
+ if (!('fenceSync' in gl)) { await pause(); return; }
886
+ const lost = (): FenceAbortError => new FenceAbortError('context-lost', 'WebGL context lost during a shader warm-up fence');
887
+ const sync = gl.isContextLost() ? null : gl.fenceSync(gl.SYNC_GPU_COMMANDS_COMPLETE, 0);
888
+ if (sync === null) throw lost();
889
+ try {
890
+ gl.flush();
891
+ for (;;) {
892
+ await pause();
893
+ if (!current()) return;
894
+ if (gl.isContextLost()) throw lost();
895
+ const status = gl.clientWaitSync(sync, 0, 0);
896
+ if (status === gl.ALREADY_SIGNALED || status === gl.CONDITION_SATISFIED) return;
897
+ if (status !== gl.TIMEOUT_EXPIRED) throw new FenceAbortError('wait-failed', `WebGL fence wait failed during a shader warm-up (0x${status.toString(16)})`);
898
+ }
899
+ } finally { gl.deleteSync(sync); }
900
+ };
901
+ }
902
+
903
+ /**
904
+ * A per-frame budget for live image uploads (op-hitch32). Isolated preparation (WebKit's entered world) uploads one image
905
+ * per drawn frame, and other browsers check 12 ms only after each upload; with a budget, a frame takes uploads while their
906
+ * measured time stays under `ms`, predicting the next one's cost from its decoded size before it starts, so a large image
907
+ * uploads alone and a slice never starts an upload it cannot fit. `Game` uses this bound for paced live WebKit
908
+ * preparation; other browsers select it explicitly with the `uploads` Developer mode.
909
+ */
910
+ export interface UploadBudget {
911
+ /** Measured upload milliseconds one drawn frame may hold. */
912
+ ms: number;
913
+ /** Decoded bytes one drawn frame may hold; a larger image uploads alone. */
914
+ bytes: number;
915
+ }
916
+
917
+ /** The Developer tool's budget for isolated (WebKit) uploads: about a quarter of a 30 fps frame, 8 MiB of decoded texels. */
918
+ export const LIVE_UPLOAD_BUDGET: UploadBudget = { ms: 8, bytes: 8 * 1024 * 1024 };
919
+
920
+ /** Live WebKit preparation settles one program per painted slice. A material can issue two side variants. */
921
+ export const LIVE_PROGRAMS_PER_FRAME = 1;
922
+ /** Whether issued links queue in WebKit's GPU process ahead of the next drawn frame (Safari and every iOS browser). */
923
+ export const queuedLinks = (): boolean => navigator.userAgent.includes('AppleWebKit') && !/Chrome|Chromium|Edg/.test(navigator.userAgent);
924
+ /** CO1: an in-play warm-up's pacing. On WebKit, one program and one upload budget per painted frame (as the grid's live
925
+ * warm-up); a 6 ms slice alone issued every link at once there, and each drawn frame waited behind the GPU process's
926
+ * queue (Jake's Driftwood spawn: 3 fps for ~30 s after the reveal). Elsewhere the driver links off the main thread.
927
+ * The ordinary paint pause stays: a paused game that draws nothing still links one program a paint, never rejects. */
928
+ export function liveWarmPacing(): { isolateImageUploads?: true; uploadBudget?: UploadBudget } {
929
+ return queuedLinks() ? { isolateImageUploads: true, uploadBudget: LIVE_UPLOAD_BUDGET } : {};
930
+ }
931
+ /** G580 T2: while the traveller waits at the cell this warm-up prepares (`setWarmUpHeld`), a live WebKit slice may issue
932
+ * and settle this many: its longer frames cost no movement, and the cell opens sooner. */
933
+ export const LIVE_HELD_PROGRAMS_PER_FRAME = 4;
934
+ let warmUpHeld = false;
935
+ /** Whether the traveller waits for a live warm-up (a grid cell's loading screen shows); the grid sets it, off by default. */
936
+ export function setWarmUpHeld(held: boolean): void { warmUpHeld = held; }
937
+ const programsPerFrame = (): number => (warmUpHeld ? LIVE_HELD_PROGRAMS_PER_FRAME : LIVE_PROGRAMS_PER_FRAME);
938
+ let parkedFrozen = false;
939
+ /** G580 T2: whether a live warm-up freezes its parked (invisible) future root's matrices (`freezeParkedMatrices`); the grid
940
+ * sets it, off by default. */
941
+ export function setParkedMatricesFrozen(frozen: boolean): void { parkedFrozen = frozen; }
942
+ export function parkedMatricesFrozen(): boolean { return parkedFrozen; }
943
+ /**
944
+ * G580 T2: three recomputes every matrix under an invisible root each frame (`updateMatrixWorld` ignores visibility): a
945
+ * parked destination world cost Pine's warm-up 8 s of its 27 s. Bring `root`'s subtree up to date once, then skip it while
946
+ * the root stays invisible (a warm-up draw that shows it updates it as usual; `shown: 'skip'` skips those too, for a
947
+ * warm-up whose draws only need its pipelines). The returned thaw restores the root's own update and refreshes the
948
+ * subtree.
949
+ */
950
+ export function freezeParkedMatrices(root: THREE.Object3D, options: { shown?: 'update' | 'skip' } = {}): () => void {
951
+ const update = root.updateMatrixWorld.bind(root), skipShown = options.shown === 'skip';
952
+ update(true);
953
+ const frozen = (force?: boolean): void => { if (root.visible && !skipShown) update(force); };
954
+ root.updateMatrixWorld = frozen;
955
+ return () => {
956
+ if (root.updateMatrixWorld === frozen) Reflect.deleteProperty(root, 'updateMatrixWorld');
957
+ root.updateMatrixWorld(true);
958
+ };
959
+ }
960
+ /**
961
+ * O14: how long live preparation leaves an unfinished link before it asks again (ms). WebKit answers COMPLETION_STATUS
962
+ * through its GPU process, behind every compile still queued there: ~20 ms a query on the Simulator. Asked once a slice,
963
+ * Nine Dragon's entry polled one Lambert program 154 times (3.2 s), one long frame each, before its link finished.
964
+ * Only while the page presents (a build in play): a loading screen or first frame waits on the link itself, and a 4 Hz
965
+ * poll stretched the native shard select's first frame from ~300 ms to 1.5 s.
966
+ */
967
+ export const LIVE_LINK_POLL_MS = 250;
968
+ /** The longest wait between two asks of one unfinished live link: its waits double from LIVE_LINK_POLL_MS (O14). */
969
+ const LIVE_LINK_POLL_MAX_MS = 1000;
970
+ /** the wait before asking an unfinished link again: LIVE_LINK_POLL_MS in play, none while loading */
971
+ const linkPollMs = (): number => (presenting() ? LIVE_LINK_POLL_MS : 0);
972
+
973
+ /** How long a parallel link is waited on before its caller links it synchronously (ms; `boundedLinkWait`). */
974
+ export const LINK_WAIT_MS = 10_000;
975
+ /**
976
+ * Wait for parallel links to report done (`ready`), asking again after each `wait`, for at most `capMs`. WebKit can leave
977
+ * a link's COMPLETION_STATUS unreported (O14: Nine Dragon's entry warm-up then stalled past its 30 s bound on the
978
+ * Simulator; O15: Driftwood's offscreen sky): false past the bound, and the caller links what is left synchronously
979
+ * (three's `getUniforms()`: the link-status check, one long frame instead of no frame). Never waits forever.
980
+ * `since` (DL23) moves the bound's start to the caller's last progress, so a batch still landing links keeps waiting.
981
+ */
982
+ export async function boundedLinkWait(ready: () => boolean | Promise<boolean>, wait: () => Promise<void>, capMs: number = LINK_WAIT_MS,
983
+ since?: () => number): Promise<boolean> {
984
+ const start = performance.now();
985
+ for (;;) {
986
+ const done = ready();
987
+ if (typeof done === 'boolean' ? done : await done) return true;
988
+ if (performance.now() - Math.max(start, since?.() ?? start) >= capMs) return false;
989
+ await wait();
990
+ }
991
+ }
992
+
993
+ // Program identities are renderer-owned; preparation must not keep a retired renderer or revisit its resolved links.
994
+ const resolvedPrograms = new WeakSet<ProgramLike>();
995
+
996
+ /** The Developer tool's budget for other browsers' slices: under the 12 ms checked after the fact, and 64 MiB. */
997
+
998
+ /** A slice's wall time, checked after each unit (a job's compile, a program's resolve, an image's upload): boot's bound. */
999
+ const PRECOMPILE_SLICE_MS = 12;
1000
+
1001
+ /** Decoded bytes an uncompressed texture's upload moves (with a third more for generated mips); 0 when unknown. */
1002
+ export function imageUploadBytes(texture: THREE.Texture): number {
1003
+ const one = (image: unknown): number => {
1004
+ if (typeof image !== 'object' || image === null) return 0;
1005
+ const data: unknown = Reflect.get(image, 'data');
1006
+ if (ArrayBuffer.isView(data)) return data.byteLength;
1007
+ const size = (key: string): number => { const v: unknown = Reflect.get(image, key); return typeof v === 'number' && Number.isFinite(v) && v > 0 ? v : 0; };
1008
+ return (size('naturalWidth') || size('width')) * (size('naturalHeight') || size('height')) * Math.max(1, size('depth')) * 4;
1009
+ };
1010
+ const image: unknown = texture.image;
1011
+ const texels = Array.isArray(image) ? image.reduce((sum: number, face: unknown) => sum + one(face), 0) : one(image);
1012
+ return Math.round(texture.generateMipmaps ? texels * 4 / 3 : texels);
1013
+ }
1014
+
1015
+ // Three's versioned allocation can already hold a page image borrowed by a new frame.
1016
+ // Initialization still runs; only its empty upload wait may be omitted. A lost allocation
1017
+ // or either changed version requires the normal upload slice, including after recovery.
1018
+ function imageResident(renderer: Renderer, texture: THREE.Texture): boolean {
1019
+ // These sources may advance and upload inside initTexture itself.
1020
+ if (Reflect.get(texture, 'isVideoTexture') === true || Reflect.get(texture, 'isHTMLTexture') === true) return false;
1021
+ const store: unknown = Reflect.get(renderer, 'properties');
1022
+ const get: unknown = typeof store === 'object' && store !== null ? Reflect.get(store, 'get') : undefined;
1023
+ if (typeof get !== 'function') return false;
1024
+ const allocation: unknown = Reflect.apply(get, store, [texture]);
1025
+ const source: unknown = Reflect.apply(get, store, [texture.source]);
1026
+ return typeof allocation === 'object' && allocation !== null
1027
+ && Reflect.get(allocation, '__webglTexture') !== undefined
1028
+ && Reflect.get(allocation, '__webglTexture') !== null
1029
+ && Reflect.get(allocation, '__version') === texture.version
1030
+ && typeof source === 'object' && source !== null
1031
+ && Reflect.get(source, '__version') === texture.source.version;
1032
+ }
1033
+
1034
+ /** One drawn frame's batch of image uploads under a budget, predicting each upload's time from the measured rate. */
1035
+ interface UploadBatch { full: (bytes: number) => boolean; add: (bytes: number, ms: number) => void; reset: () => void; pending: () => boolean }
1036
+ function newUploadBatch(budget: UploadBudget): UploadBatch {
1037
+ let ms = 0, bytes = 0, count = 0, totalMs = 0, totalBytes = 0;
1038
+ return {
1039
+ full: next => {
1040
+ if (count === 0) return false;
1041
+ // The byte-weighted rate so far predicts the next upload; nothing measured yet, the frame is full.
1042
+ const predicted = totalBytes === 0 ? budget.ms : next * totalMs / totalBytes;
1043
+ return bytes + next > budget.bytes || ms + predicted > budget.ms;
1044
+ },
1045
+ add: (b, t) => {
1046
+ ms += t; bytes += b; count++;
1047
+ if (b > 0) { totalMs += t; totalBytes += b; }
1048
+ },
1049
+ reset: () => { ms = 0; bytes = 0; count = 0; },
1050
+ pending: () => count > 0,
1051
+ };
1052
+ }
1053
+
1054
+ /** Wait for a new completed game draw, then a paint opportunity. A capped/skipped rAF cannot release preparation;
1055
+ * owner retirement rejects before another batch. Does not advance simulation,
1056
+ * force a draw or change frame pacing. */
1057
+ export async function waitForDrawnFrame(scope: Scope, drawn: () => number, current: () => boolean): Promise<void> {
1058
+ if (scope.disposed || scope.disposing || !current()) throw new Error('Shader warm-up owner left');
1059
+ // Retirement may happen before the task is delivered. Own cleanup outside
1060
+ // that race so it closes the pending ports too.
1061
+ const wait = scope.child('drawn-frame');
1062
+ try {
1063
+ await boundEntryWarmup(scope, withinBound =>
1064
+ drawnFrame(wait, drawn, () => !scope.disposing && withinBound() && current()));
1065
+ } finally { wait.dispose(); }
1066
+ }
1067
+
1068
+ function drawnFrame(scope: Scope, drawn: () => number, current: () => boolean): Promise<void> {
1069
+ const before = drawn();
1070
+ return new Promise<void>((resolve, reject) => {
1071
+ let done = false;
1072
+ const forget = scope.capture('disposers', () => { if (!done) { done = true; reject(new Error('Shader warm-up owner left')); } });
1073
+ const finish = (): void => {
1074
+ if (done) return;
1075
+ done = true; forget();
1076
+ if (current()) resolve(); else reject(new Error('Shader warm-up owner left'));
1077
+ };
1078
+ const poll = (): void => { scope.raf(() => {
1079
+ if (done) return;
1080
+ if (!current()) { finish(); return; }
1081
+ if (drawn() <= before) { poll(); return; }
1082
+ // Keep a task after the completed frame, without a nested timer's
1083
+ // clamp spending the next native slice before it starts. Every call
1084
+ // still requires its own later game draw, including capped/skipped rAFs.
1085
+ if (typeof globalThis.MessageChannel !== 'function') { scope.timeout(0, finish); return; }
1086
+ const channel = new MessageChannel(), turn = scope.child('drawn-frame-turn');
1087
+ turn.onDispose(() => { channel.port1.close(); channel.port2.close(); });
1088
+ turn.listen(channel.port1, 'message', () => { turn.dispose(); scope.run(finish); }, { once: true });
1089
+ channel.port1.start(); channel.port2.postMessage(0);
1090
+ }); };
1091
+ poll();
1092
+ });
1093
+ }
1094
+
1095
+ /**
1096
+ * Issue jobs and settle their driver links: reports (done, total, detail) monotonically —
1097
+ * `total` = jobs + programs once the programs are known. Live preparation may isolate image
1098
+ * uploads so an unpredictable native upload cannot join another upload in the same painted slice.
1099
+ * An optional pause port requires a completed live draw between batches instead of a browser rAF the game may skip.
1100
+ * An optional upload budget batches image uploads per frame under it (op-hitch32).
1101
+ */
1102
+ /** G808: per renderer, each material's compile signatures a warm-up has run (its version, object key and the light /
1103
+ * environment / target state it compiled under). A later job repeating one adds no program. */
1104
+ const compiledUnder = new WeakMap<Renderer, WeakMap<THREE.Material, Set<string>>>();
1105
+
1106
+ /** What three folds into a program's key beside the material and the object: the lights it counts (visible, in the
1107
+ * compile camera's layers, from the job's root, the lights about to be copied in and the target scene), fog,
1108
+ * environment, render target, tone mapping, shadow map, output colour space, clipping and the camera kind. */
1109
+ function compileSignature(renderer: Renderer, job: CompileJob, camera: THREE.Camera): string {
1110
+ const view = job.camera ?? camera, lights: string[] = [], seen = new Set<THREE.Object3D>();
1111
+ const collect = (root: THREE.Object3D): void => {
1112
+ root.traverseVisible(object => {
1113
+ if (seen.has(object) || !(object instanceof THREE.Light) || !object.layers.test(view.layers)) return;
1114
+ seen.add(object); lights.push(`${object.type}${object.castShadow ? '+' : ''}`);
1115
+ });
1116
+ };
1117
+ collect(job.root); if (job.target !== null) collect(job.target);
1118
+ for (const light of job.futureLights ?? []) lights.push(`${light.type}${light.castShadow ? '+' : ''}`);
1119
+ lights.sort();
1120
+ const target = job.target, fog = job.fogOff === true ? null : target?.fog ?? null;
1121
+ return [lights.join(','), fog === null ? '-' : fog.constructor.name, (job.environment ?? target?.environment)?.uuid ?? '-',
1122
+ job.rt?.texture.uuid ?? 'canvas', job.toneMapping ?? field(renderer, 'toneMapping'), field(Reflect.get(renderer, 'shadowMap'), 'enabled'),
1123
+ field(Reflect.get(renderer, 'shadowMap'), 'type'), field(renderer, 'outputColorSpace'), field(renderer, 'localClippingEnabled'), view.type].join('|');
1124
+ }
1125
+ /** A state field as text; test doubles of the renderer carry only some of them. */
1126
+ function field(holder: unknown, name: string): string {
1127
+ return typeof holder === 'object' && holder !== null ? String(Reflect.get(holder, name)) : '-';
1128
+ }
1129
+ /** Each compiled object's material keys under `signature`. */
1130
+ function compiledKeys(job: CompileJob, signature: string, use: (material: THREE.Material, key: string) => boolean): boolean {
1131
+ let any = false, all = true;
1132
+ job.root.traverse(object => {
1133
+ if (!all) return;
1134
+ for (const material of materialsOf(object)) {
1135
+ any = true;
1136
+ if (!use(material, `${String(material.version)}|${object.type}|${programObjectKey(object)}|${String(object.receiveShadow)}|${signature}`)) { all = false; return; }
1137
+ }
1138
+ });
1139
+ return any && all;
1140
+ }
1141
+ /** Whether every material of `job` already compiled under this signature (never a custom-prepared or forced-face job). */
1142
+ function repeatsCompiled(renderer: Renderer, job: CompileJob, camera: THREE.Camera): boolean {
1143
+ if (job.prepare !== undefined || job.materialSide !== undefined) return false;
1144
+ const known = compiledUnder.get(renderer);
1145
+ if (known === undefined) return false;
1146
+ const signature = compileSignature(renderer, job, camera);
1147
+ // a material that was disposed (its programs released) builds again: only a material still holding a program repeats
1148
+ return compiledKeys(job, signature, (material, key) => known.get(material)?.has(key) === true
1149
+ && materialPrograms(renderer, material).some(program => program !== undefined && program !== null));
1150
+ }
1151
+ /** What `job` compiled under `signature` (its state before the compile, as `repeatsCompiled` reads it), kept by the
1152
+ * run and published to the renderer's record when the run completes: a run's own jobs schedule exactly as before. */
1153
+ function recordCompiled(job: CompileJob, signature: string, into: [THREE.Material, string][]): void {
1154
+ if (job.prepare !== undefined || job.materialSide !== undefined) return;
1155
+ compiledKeys(job, signature, (material, key) => { into.push([material, key]); return true; });
1156
+ }
1157
+ function publishCompiled(renderer: Renderer, records: readonly [THREE.Material, string][]): void {
1158
+ let known = compiledUnder.get(renderer);
1159
+ if (known === undefined) { known = new WeakMap(); compiledUnder.set(renderer, known); }
1160
+ for (const [material, key] of records) {
1161
+ let keys = known.get(material);
1162
+ if (keys === undefined) { keys = new Set(); known.set(material, keys); }
1163
+ keys.add(key);
1164
+ }
1165
+ }
1166
+
1167
+ export async function runPrecompile(
1168
+ renderer: Renderer, camera: THREE.Camera, jobs: CompileJob[], materials: number,
1169
+ onProgress?: (done: number, total: number, detail: string) => void,
1170
+ textures: THREE.Texture[] = collectTextures(jobs),
1171
+ current: () => boolean = () => true,
1172
+ isolateImageUploads = false,
1173
+ pause: () => Promise<void> = frame,
1174
+ uploadBudget?: UploadBudget,
1175
+ onStage?: PrecompileStage,
1176
+ sliceMs: number = PRECOMPILE_SLICE_MS,
1177
+ ): Promise<PrecompileReport> {
1178
+ // Page siblings can retire while a neighbour's preparation yields. The inventory is
1179
+ // borrowed: disposal cancels only that resource's upload, not the live neighbour.
1180
+ const retired = new WeakSet<THREE.Texture>(), watched = new Set<THREE.Texture>();
1181
+ const observer = pageScope.child('shader-texture-inventory');
1182
+ const watch = (texture: THREE.Texture): void => {
1183
+ if (watched.has(texture)) return;
1184
+ watched.add(texture); observer.listenOnceEmitter(texture, 'dispose', () => { retired.add(texture); });
1185
+ };
1186
+ for (const texture of textures) watch(texture);
1187
+ try { return await runPrecompileWork(renderer, camera, jobs, materials, onProgress, textures, current, retired, watch, isolateImageUploads, pause, uploadBudget, onStage, sliceMs, observer); }
1188
+ finally {
1189
+ observer.dispose();
1190
+ for (const lights of new Set(jobs.flatMap(job => job.lights === undefined ? [] : [job.lights]))) lights.dispose();
1191
+ }
1192
+ }
1193
+
1194
+ async function runPrecompileWork(renderer: Renderer, camera: THREE.Camera, jobs: CompileJob[], materials: number,
1195
+ onProgress: ((done: number, total: number, detail: string) => void) | undefined, textures: THREE.Texture[],
1196
+ current: () => boolean, retired: WeakSet<THREE.Texture>, watch: (texture: THREE.Texture) => void, isolateImageUploads: boolean, pause: () => Promise<void>,
1197
+ uploadBudget: UploadBudget | undefined, onStage: PrecompileStage | undefined, sliceMs: number, observer: Scope): Promise<PrecompileReport> {
1198
+ const checkCurrent = (): void => { if (!current()) throw new Error('Shader warm-up owner left'); };
1199
+ checkCurrent();
1200
+ for (const texture of collectTextures(jobs)) watch(texture);
1201
+ const parallel = renderer.extensions.has('KHR_parallel_shader_compile');
1202
+ // LS11 (J204): without parallel compile (SwiftShader reports serial) the GPU process compiles and links each program in
1203
+ // the order issued, so issuing a run's every job before its first resolve left that resolve waiting on all of them:
1204
+ // Driftwood's shaders step at 4x CPU, 123 jobs issued in 0.2 s, then the main thread held 0.74 s in the first link
1205
+ // query, and the bar sat still while its total grew by 75 programs. Under a loading screen each job's new programs are
1206
+ // resolved inside its own slice, so the slice clock counts the link and the painted pause follows it.
1207
+ const linkPerJob = serialLoading(renderer, isolateImageUploads), settledPause = gpuSettled(renderer, pause, current);
1208
+ const before = snapshotPrograms(renderer);
1209
+ const created: ProgramLike[] = [];
1210
+ // op-hitch31: the programs the jobs' materials compiled to, including ones issued before `before` (a captured
1211
+ // offscreen factory such as PMREM issues its own in `_compileMaterial` during capture). Without them the replayed
1212
+ // draw was their first use: a blocking link query (53-99 ms getProgramInfoLog on the Simulator) in one frame.
1213
+ const jobPrograms = new Set<unknown>();
1214
+ const issuedPrograms = new Set<unknown>();
1215
+ const needsPreparation = (program: ProgramLike): boolean => !resolvedPrograms.has(program) && !nativeRetired(program);
1216
+ // Holding at a wall can lend builders more shared frame time, but must not
1217
+ // enlarge this caller's explicit shader slice and join two slow native units.
1218
+ const spent = (start: number): boolean => performance.now() - start >= sliceMs || nativeBudgetSpent(sliceMs);
1219
+ let tFrame = performance.now(), programsAtFrame = programCount(renderer);
1220
+ let nativeInSlice = false, cachedCpuJobs = 0, cachedCpuMs = 0, settledInFrame = 0, settledDuringIssue = 0, repeatJobs = 0;
1221
+ const compiledRecords: [THREE.Material, string][] = [];
1222
+ let issueFrame = 0;
1223
+ // Link readiness or first-use queries may need a completed frame internally.
1224
+ // The outer issue loop must then measure the frame actually receiving work,
1225
+ // rather than wait again because its old clock predates that completed draw.
1226
+ const pauseIssue = async (): Promise<void> => {
1227
+ await pause(); checkCurrent(); issueFrame++;
1228
+ tFrame = performance.now(); programsAtFrame = programCount(renderer); nativeInSlice = false; settledInFrame = 0;
1229
+ };
1230
+ const resolveProgram = async (program: ProgramLike, start: number): Promise<void> => {
1231
+ // Completion queries and first-use queries are separate native units. A slow ready() must not admit a second
1232
+ // expensive query into the same continuation. Cheap queries still batch.
1233
+ if (spent(start)) await pauseIssue();
1234
+ // the pause above can outlive the program: a retired identity is settled, never queried
1235
+ if (!resolvedPrograms.has(program) && !nativeRetired(program)) { program.getUniforms(); reportLinkFailure(renderer.getContext(), program); }
1236
+ resolvedPrograms.add(program);
1237
+ };
1238
+ // Keep issue and first use on one painted slice when the driver has already finished linking.
1239
+ // An incomplete link is queued; it never blocks issuing the next material or loses its owner fence.
1240
+ const queued: ProgramLike[] = [], enqueued = new Set<ProgramLike>();
1241
+ let settled = 0, unreadyAt = Number.NEGATIVE_INFINITY;
1242
+ const queue = (program: ProgramLike): void => {
1243
+ if (!enqueued.has(program) && needsPreparation(program)) { enqueued.add(program); queued.push(program); }
1244
+ };
1245
+ const settleOne = async (start: number): Promise<void> => {
1246
+ const program = queued[settled];
1247
+ if (program === undefined || parallel && performance.now() - unreadyAt < linkPollMs()) return;
1248
+ if (nativeRetired(program)) { enqueued.delete(program); settled++; return; }
1249
+ if (parallel && !program.isReady()) { unreadyAt = performance.now(); return; }
1250
+ await resolveProgram(program, start); enqueued.delete(program); settled++;
1251
+ };
1252
+ const total = () => jobs.length + Math.max(created.length, 1) + textures.length;
1253
+ const mode = parallel ? 'parallel' : 'serial';
1254
+ const settleInSlice = async (): Promise<void> => {
1255
+ if (queued[settled] === undefined || settledInFrame >= programsPerFrame()) return;
1256
+ const previous = settled, started = performance.now(), priorNative = nativeInSlice, previousFrame = issueFrame;
1257
+ await settleOne(tFrame);
1258
+ const completed = settled - previous;
1259
+ settledInFrame += completed; settledDuringIssue += completed;
1260
+ // A cheap completed query leaves no unresolved native unit of its own.
1261
+ // It cannot erase an earlier issue, a slow query or an unfinished poll.
1262
+ nativeInSlice = (previousFrame === issueFrame && priorNative) || completed === 0
1263
+ || performance.now() - Math.max(started, tFrame) >= sliceMs;
1264
+ };
1265
+ const preparedTargets = new Set<THREE.WebGLRenderTarget | null>([null]);
1266
+ let targetFences = fencedTargets.get(renderer);
1267
+ if (targetFences === undefined) { targetFences = new WeakMap(); fencedTargets.set(renderer, targetFences); }
1268
+ const watchedTargets = new Set<THREE.WebGLRenderTarget>();
1269
+ let stageStart = tFrame;
1270
+ const programsByKind = new Map<string, number>();
1271
+ for (const [i, job] of jobs.entries()) {
1272
+ // Job discovery and other builders may already have spent this drawn frame. Compile is atomic: don't start it
1273
+ // on a stale local slice, and don't append first-use/link preparation after a compile has consumed the budget.
1274
+ // A completed draw can itself consume the shared budget (SwiftShader).
1275
+ // If no warm-up issued work while we yielded, admit one atomic job even
1276
+ // after that slow draw. Otherwise recheck the shared budget, so expensive
1277
+ // queued warm-ups cannot all join the same spent frame. The post-job
1278
+ // budget and program cap still end this caller's slice before more work.
1279
+ while (nativeBudgetSpent(sliceMs)) {
1280
+ const beforeIssue = issuedCompileWork.get(renderer) ?? 0;
1281
+ await pauseIssue();
1282
+ if ((issuedCompileWork.get(renderer) ?? 0) === beforeIssue) break;
1283
+ }
1284
+ checkCurrent();
1285
+ // Resolve earlier ready links in this frame's spare issue time. Waiting
1286
+ // until a compile spends the slice left every first-use query for a
1287
+ // separate tail. Slow queries still finish their frame before issuing.
1288
+ if (isolateImageUploads && queued[settled] !== undefined) {
1289
+ await settleInSlice(); checkCurrent();
1290
+ if (spent(tFrame) || settledInFrame >= programsPerFrame()) {
1291
+ await pause(); checkCurrent(); tFrame = performance.now(); programsAtFrame = programCount(renderer); nativeInSlice = false; settledInFrame = 0;
1292
+ }
1293
+ }
1294
+ // G808: a job whose every material an earlier warm-up already compiled under this same light / environment / target
1295
+ // signature adds no program (three would only look its keys up again), so it is not run: on the phone path a
1296
+ // crossing's later passes re-ran ~1,300 such jobs, each still spending part of a slice
1297
+ if (i < jobs.length - 1 && repeatsCompiled(renderer, job, camera)) { repeatJobs++; onProgress?.(i + 1, total(), `${materials} materials · ${i + 1} / ${jobs.length} batches · ${mode}`); continue; }
1298
+ const jobStart = performance.now(); issuedPrograms.clear();
1299
+ issuedCompileWork.set(renderer, (issuedCompileWork.get(renderer) ?? 0) + 1);
1300
+ if (job.rt !== null && !watchedTargets.has(job.rt)) {
1301
+ const target = job.rt; watchedTargets.add(target);
1302
+ observer.listenOnceEmitter(target, 'dispose', () => { preparedTargets.delete(target); watchedTargets.delete(target); });
1303
+ }
1304
+ const compiledSignature = compileSignature(renderer, job, camera);
1305
+ const programsBefore = programCount(renderer), targetBefore = allocatedTarget(renderer, job.rt);
1306
+ const prevRt = renderer.getRenderTarget(), prevTone = renderer.toneMapping;
1307
+ const fog = job.target?.fog ?? null;
1308
+ const environment = job.target?.environment ?? null;
1309
+ let originalSide: THREE.Side | undefined;
1310
+ const restoreDrawn = isolateImageUploads ? holdDrawnPrograms(renderer, job.root) : undefined;
1311
+ try {
1312
+ if (job.fogOff && job.target) job.target.fog = null;
1313
+ if (job.environment !== undefined && job.target) job.target.environment = job.environment;
1314
+ if (job.toneMapping !== undefined) renderer.toneMapping = job.toneMapping;
1315
+ renderer.setRenderTarget(job.rt);
1316
+ if (job.lights !== undefined && job.futureLights !== undefined) {
1317
+ for (const light of job.futureLights) job.root.add(job.lights.copy(light));
1318
+ delete job.futureLights;
1319
+ }
1320
+ job.lights?.prepare();
1321
+ job.prepare?.();
1322
+ // A live owner may change its flags while the previous unit yields.
1323
+ // Then let Three compile that current material instead of forcing a stale face.
1324
+ if (job.materialSide !== undefined && job.materialSide.material.transparent
1325
+ && job.materialSide.material.side === THREE.DoubleSide && !job.materialSide.material.forceSinglePass) {
1326
+ originalSide = job.materialSide.material.side;
1327
+ job.materialSide.material.side = job.materialSide.side;
1328
+ job.materialSide.material.needsUpdate = true;
1329
+ }
1330
+ // a classic graph program follows its drawn scene's environment (and its object's codec) in its onBeforeRender,
1331
+ // which compile never calls: run it first, or the first draw links a second program
1332
+ const scene = job.target;
1333
+ if (scene !== null && scene !== undefined) job.root.traverse(object => {
1334
+ if (object instanceof THREE.Mesh) for (const material of materialsOf(object)) if (Reflect.get(material, 'isGraphShaderMaterial') === true) {
1335
+ material.onBeforeRender(renderer, scene, job.camera ?? camera, NO_GEOMETRY, object, NO_GROUP);
1336
+ }
1337
+ });
1338
+ renderer.compile(job.root, job.camera ?? camera, job.target ?? undefined);
1339
+ job.root.traverse(object => { for (const material of materialsOf(object)) {
1340
+ for (const program of materialPrograms(renderer, material)) {
1341
+ jobPrograms.add(program);
1342
+ issuedPrograms.add(program);
1343
+ }
1344
+ } });
1345
+ } finally {
1346
+ if (job.materialSide !== undefined && originalSide !== undefined) job.materialSide.material.side = originalSide;
1347
+ restoreDrawn?.();
1348
+ renderer.setRenderTarget(prevRt); renderer.toneMapping = prevTone;
1349
+ if (job.fogOff && job.target) job.target.fog = fog;
1350
+ if (job.environment !== undefined && job.target) job.target.environment = environment;
1351
+ }
1352
+ recordCompiled(job, compiledSignature, compiledRecords);
1353
+ const made = programCount(renderer) - programsBefore;
1354
+ const targetKnown = preparedTargets.has(job.rt) || job.rt !== null && targetBefore !== undefined
1355
+ && targetFences.get(job.rt) === targetBefore && targetBefore === allocatedTarget(renderer, job.rt);
1356
+ // A forced face which selects only already-resolved physical programs is
1357
+ // CPU bookkeeping too. Fresh/unresolved face programs still fail the
1358
+ // acquired-program proof below and keep the original native fences.
1359
+ let cachedOnly = made === 0 && job.prepare === undefined && targetKnown;
1360
+ let knownPrograms = 0;
1361
+ const acquired = isolateImageUploads ? snapshotPrograms(renderer) : undefined;
1362
+ if (acquired !== undefined) for (const program of acquired) if (issuedPrograms.has(program)) {
1363
+ knownPrograms++; if (needsPreparation(program)) cachedOnly = false;
1364
+ }
1365
+ cachedOnly &&= knownPrograms > 0 && knownPrograms === issuedPrograms.size;
1366
+ if (job.rt === null || watchedTargets.has(job.rt)) preparedTargets.add(job.rt);
1367
+ if (made > 0 && job.kind !== undefined) programsByKind.set(job.kind, (programsByKind.get(job.kind) ?? 0) + made);
1368
+ if (isolateImageUploads) {
1369
+ for (const program of acquired ?? []) if (!before.has(program) || jobPrograms.has(program)) queue(program);
1370
+ }
1371
+ if (linkPerJob && issuedPrograms.size > 0) {
1372
+ for (const program of snapshotPrograms(renderer)) if (issuedPrograms.has(program) && needsPreparation(program)) await resolveProgram(program, tFrame);
1373
+ checkCurrent();
1374
+ }
1375
+ onProgress?.(i + 1, total(), `${materials} materials · ${i + 1} / ${jobs.length} batches · ${mode}`);
1376
+ // op-hitch37: a live WebKit warm-up also yields once a slice has issued LIVE_PROGRAMS_PER_FRAME programs: WebKit
1377
+ // queues compile/link to its GPU process, so the JS slice is cheap but the frame that presents it waits for all of
1378
+ // them (Sky Reach's entry: 18 programs in one 217 ms Simulator frame of afterPlay).
1379
+ const capped = isolateImageUploads && programCount(renderer) - programsAtFrame >= programsPerFrame();
1380
+ // A held frame may share its existing native-time budget with cheap jobs
1381
+ // that only revisit fully resolved programs. Do not rebase a slice that
1382
+ // issued any new/unknown native work, unresolved side or first-use metadata.
1383
+ // The global native budget and program cap still end this same frame.
1384
+ const jobMs = performance.now() - jobStart;
1385
+ if (cachedOnly && !nativeInSlice && isolateImageUploads && buildHeld() && presenting() && jobMs < sliceMs) {
1386
+ tFrame = performance.now(); cachedCpuJobs++; cachedCpuMs += jobMs;
1387
+ } else if (!cachedOnly || jobMs >= sliceMs) nativeInSlice = true;
1388
+ // D176: where the driver compiles off the main thread (not WebKit's queued GPU process: its new units keep the explicit
1389
+ // slice and the programs-per-frame cap), a held frame's slice keeps issuing cheap jobs to the held build budget
1390
+ // (HELD_BUILD_MS past the drawn frame, as builds have since 18736fc479): a 6 ms slice in a 33 ms held frame left a
1391
+ // Nalati crossing's shader warm-up 40 % idle. G808: a slow job no longer ends the held slice by itself: each node
1392
+ // material's build (~11 ms at 4x) ended one, and a Nalati crossing's compile window still sat ~35 % idle; a slice runs
1393
+ // to the held budget, overrunning it by at most one job.
1394
+ const sliceDone = !isolateImageUploads && buildHeld() && presenting()
1395
+ ? performance.now() - tFrame >= heldBudget(sliceMs) || nativeBudgetSpent(sliceMs)
1396
+ : spent(tFrame);
1397
+ // A fully resolved cached-only root issued no native work to fence. Keep
1398
+ // its cheap completion in the held slice; fresh programs/targets, custom
1399
+ // preparation, unresolved faces and texture uploads retain their own fences.
1400
+ const cachedCompletion = cachedOnly && !nativeInSlice && isolateImageUploads && buildHeld() && presenting();
1401
+ if (sliceDone || capped || i === jobs.length - 1 && !cachedCompletion) {
1402
+ const beforeSettlement = issueFrame;
1403
+ if (isolateImageUploads && !spent(tFrame)) await settleInSlice();
1404
+ // A nested link wait already painted the spent issue frame. Recheck its
1405
+ // old cap before waiting again; final completion still keeps its fence.
1406
+ if (issueFrame !== beforeSettlement && i < jobs.length - 1 && !spent(tFrame)
1407
+ && settledInFrame < programsPerFrame() && programCount(renderer) - programsAtFrame < programsPerFrame()) continue;
1408
+ await pause(); tFrame = performance.now(); programsAtFrame = programCount(renderer); nativeInSlice = false; settledInFrame = 0;
1409
+ for (const target of preparedTargets) if (target !== null) {
1410
+ const framebuffer = allocatedTarget(renderer, target);
1411
+ if (framebuffer !== undefined) targetFences.set(target, framebuffer);
1412
+ }
1413
+ }
1414
+ }
1415
+ publishCompiled(renderer, compiledRecords);
1416
+ created.push(...newProgramsSince(renderer, before));
1417
+ for (const program of before) if (jobPrograms.has(program)) created.push(program);
1418
+ // H4: distinguish repeated native identities from newly created identities
1419
+ // before removing an initial-home pass. Scalar diagnostics own no resources.
1420
+ if (isDev()) {
1421
+ let cached = 0, fresh = 0;
1422
+ for (const program of before) if (jobPrograms.has(program)) cached++;
1423
+ for (const program of newProgramsSince(renderer, before)) if (jobPrograms.has(program)) fresh++;
1424
+ const name = `wildshard.precompile.census:${censusSlot++ % 16}`;
1425
+ performance.clearMeasures(name);
1426
+ performance.measure(name, { start: stageStart, end: performance.now(),
1427
+ detail: { jobs: jobs.length, cachedProgramIdentities: cached, newProgramIdentities: fresh } });
1428
+ }
1429
+ if (onStage !== undefined) {
1430
+ for (const [kind, count] of programsByKind) onStage(`programs:${kind}`, 0, count);
1431
+ onStage('link-preparation-during-compile', 0, settledDuringIssue);
1432
+ onStage('cached-compile', cachedCpuMs, cachedCpuJobs);
1433
+ onStage('repeat-jobs', 0, repeatJobs);
1434
+ onStage('compile', performance.now() - stageStart, jobs.length); stageStart = performance.now();
1435
+ }
1436
+ const pending = created.filter(needsPreparation);
1437
+ const n = pending.length;
1438
+ // Ordinary parallel preparation waits for the batch before resolving it. Live preparation
1439
+ // settles one ready identity below; completion polls also cross the GPU-process boundary.
1440
+ const units = parallel ? 2 * n : n;
1441
+ if (parallel && !isolateImageUploads) {
1442
+ const linked = new Set<ProgramLike>();
1443
+ // Boot can observe the same unreported WebKit completion as live and
1444
+ // offscreen preparation. Keep their existing bounded wait, then resolve
1445
+ // every remaining program through the mandatory native first use below.
1446
+ // DL23: the bound counts from the last link that landed. The boot census is the first frame's whole inventory
1447
+ // (86-107 programs), which a loaded iPhone Simulator links at about 4 a second: still landing links, the batch
1448
+ // passed 10 s from its issue, and the resolve below forced the rest in one frame (Driftwood 5.2 s, Pine 3.3 s).
1449
+ // A link that never reports (O14) still ends the wait LINK_WAIT_MS after the last one landed.
1450
+ let landedAt = performance.now();
1451
+ const report = (): void => { onProgress?.(jobs.length + linked.size, jobs.length + units + textures.length, `${linked.size} / ${n} programs linked · parallel`); };
1452
+ await waitFor(`Link ${n} shader programs`, boundedLinkWait(async () => {
1453
+ checkCurrent();
1454
+ let askedAt = performance.now(), shown = linked.size;
1455
+ for (const p of pending) {
1456
+ if (linked.has(p)) continue;
1457
+ if (nativeRetired(p) || p.isReady()) { linked.add(p); landedAt = performance.now(); }
1458
+ // DL21: a pass asks every unlinked program, and on the Simulator each ask waits ~20 ms behind the GPU process's
1459
+ // queued links, a slice apiece: a pass over 40 took 1-1.6 s, the card on its last count while links landed. Each
1460
+ // slice shows the links landed so far
1461
+ if (spent(askedAt)) { if (linked.size !== shown) { shown = linked.size; report(); } await pause(); checkCurrent(); askedAt = performance.now(); }
1462
+ }
1463
+ report();
1464
+ return linked.size >= n;
1465
+ }, async () => { await pause(); checkCurrent(); }, LINK_WAIT_MS, () => landedAt), 'shader');
1466
+ }
1467
+ // Phase B: resolve each link. COMPLETION_STATUS only says the front end is done — ANGLE Metal
1468
+ // builds the Metal library on the first LINK_STATUS / uniform query (~20 ms a program with a cold
1469
+ // shader cache), which the first frame would otherwise pay for every program in one stall. One
1470
+ // resolve per program, time-boxed per frame so the count keeps moving; without the extension this
1471
+ // is also where the link itself blocks. The resolve is three's own first use (`getUniforms()`: the
1472
+ // link-status + info-log checks, every uniform / attribute location), which the first draw of each
1473
+ // program otherwise ran inside the first frame (~45 ms of onFirstUse at 4x CPU).
1474
+ // op-hitch37: a live WebKit warm-up resolves at most LIVE_PROGRAMS_PER_FRAME a slice. Its queries return quickly on the
1475
+ // main thread, so the 12 ms box never closed, but the frame waited for every library they forced (Nine Dragon's entry:
1476
+ // 759 uniforms resolved in one 699 ms Simulator frame of afterPlay).
1477
+ let tSlice = performance.now(), resolvedInSlice = 0;
1478
+ // DL21: the phase names itself as it opens: its first link wait holds until the GPU process has compiled everything
1479
+ // queued before it (Pine's step 29 sat 3.5 s on '474 / 474 batches' in the DL23 recording on 2477dc4)
1480
+ if (n > 0) onProgress?.(jobs.length + (parallel && !isolateImageUploads ? n : 0), jobs.length + units + textures.length, `0 / ${n} programs resolved · ${mode}`);
1481
+ // DL21: under the loader a resolve waits on one program while the GPU process links the rest, and they land in a burst behind it
1482
+ // (Pine's step 29 held '2 / 28 programs resolved' 1.2-7.3 s, its foot naming nothing). No frame is on show here, so each wait's
1483
+ // poll also asks one program further on, and the card counts the links as they land, on a named wait.
1484
+ const counted = parallel && isolateImageUploads && !presenting() && n > 1 ? countedWait(`Link ${n} shader programs`, 'linked', 'shader') : undefined;
1485
+ const landed = new Set<ProgramLike>();
1486
+ let ahead = 0;
1487
+ const askAhead = (resolved: number): void => {
1488
+ const left = n - resolved - 1;
1489
+ if (counted === undefined || left <= 0) return;
1490
+ ahead = (ahead + 1) % left;
1491
+ const next = pending[resolved + 1 + ahead];
1492
+ if (next === undefined || landed.has(next) || !(nativeRetired(next) || next.isReady())) return;
1493
+ landed.add(next); counted.add();
1494
+ onProgress?.(jobs.length + 2 * resolved, jobs.length + units + textures.length, `${resolved} / ${n} programs resolved · ${landed.size} linked · ${mode}`);
1495
+ };
1496
+ try {
1497
+ for (const [i, p] of pending.entries()) {
1498
+ if (nativeBudgetSpent(sliceMs)) { await pause(); tSlice = performance.now(); resolvedInSlice = 0; }
1499
+ checkCurrent();
1500
+ // A live slice settles one ready program. An incomplete link alone needs another poll.
1501
+ // (past LINK_WAIT_MS the resolve below links it synchronously). O14: each ask waits behind the GPU process's queued
1502
+ // compiles (~20 ms on the Simulator, a missed vsync), so a link still unfinished is asked less often each time
1503
+ let every = linkPollMs(), queryStart = performance.now();
1504
+ if (parallel && isolateImageUploads) await boundedLinkWait(() => { queryStart = performance.now(); return nativeRetired(p) || p.isReady(); }, async () => {
1505
+ askAhead(i);
1506
+ const asked = performance.now();
1507
+ do { await pause(); checkCurrent(); } while (performance.now() - asked < every);
1508
+ every = Math.min(every * 2, LIVE_LINK_POLL_MAX_MS);
1509
+ });
1510
+ await resolveProgram(p, queryStart); resolvedInSlice++;
1511
+ const linkedProgress = parallel ? (isolateImageUploads ? 2 * (i + 1) : n + i + 1) : i + 1;
1512
+ onProgress?.(jobs.length + linkedProgress, jobs.length + units + textures.length, `${i + 1} / ${n} programs resolved · ${mode}`);
1513
+ if (spent(tSlice) || (isolateImageUploads && resolvedInSlice >= programsPerFrame())) { await pause(); tSlice = performance.now(); resolvedInSlice = 0; }
1514
+ }
1515
+ } finally { counted?.end(); }
1516
+ // Compilation exposes samplers injected by shader callbacks; merge them before any draw.
1517
+ if (onStage !== undefined) { onStage('link', performance.now() - stageStart, pending.length); stageStart = performance.now(); }
1518
+ const uploadTextures = [...new Set([...textures, ...collectTextures(jobs)])];
1519
+ for (const texture of uploadTextures) watch(texture);
1520
+ // Phase C: compressed textures retain their fenced slices. Live WebKit image preparation
1521
+ // isolates native uploads; a post-upload time check alone can overshoot before it yields.
1522
+ tSlice = performance.now();
1523
+ const base = jobs.length + units;
1524
+ // op-hitch32: with an upload budget, live preparation batches image uploads per frame under it: several instead of one
1525
+ // when isolated, and a predicted overshoot waits for the next frame instead of the 12 ms check after the fact.
1526
+ const batch = uploadBudget !== undefined ? newUploadBatch(uploadBudget) : undefined;
1527
+ let imageBytes = 0, slowestUpload = 0;
1528
+ for (const [i, tex] of uploadTextures.entries()) {
1529
+ if (nativeBudgetSpent(sliceMs)) { await pause(); tSlice = performance.now(); batch?.reset(); }
1530
+ checkCurrent();
1531
+ const compressed = tex instanceof THREE.CompressedTexture;
1532
+ const bytes = compressed ? 0 : imageUploadBytes(tex);
1533
+ const imageUpload = !compressed && !retired.has(tex) && !(isolateImageUploads && imageResident(renderer, tex));
1534
+ if (batch !== undefined && imageUpload && batch.full(bytes)) { await pause(); checkCurrent(); batch.reset(); }
1535
+ const tUpload = performance.now();
1536
+ if (!retired.has(tex)) {
1537
+ if (compressed) {
1538
+ try { await uploadCompressedTexture(renderer, tex, () => current() && !retired.has(tex), true); }
1539
+ catch (error) { if (!retired.has(tex)) throw error; }
1540
+ } else {
1541
+ renderer.initTexture(tex);
1542
+ }
1543
+ }
1544
+ // LS11: a serial GPU's image upload is credited only once its settled pause says the GPU finished it
1545
+ const settles = linkPerJob && imageUpload && !compressed && batch === undefined;
1546
+ if (!settles) onProgress?.(base + i + 1, base + uploadTextures.length, `${i + 1} / ${uploadTextures.length} textures uploaded`);
1547
+ if (imageUpload) { imageBytes += bytes; slowestUpload = Math.max(slowestUpload, performance.now() - tUpload); }
1548
+ // DL21: name an upload that held a loading frame (Nine's Shardfile cold card sat 1.0 s on '30 / 33 textures uploaded')
1549
+ if (isDev() && performance.now() - tUpload >= SLOW_UPLOAD_MS) slowUpload(tex, tUpload, compressed ? 0 : bytes);
1550
+ if (compressed) { checkCurrent(); tSlice = performance.now(); batch?.reset(); }
1551
+ else if (batch !== undefined) { if (imageUpload) batch.add(bytes, performance.now() - tUpload); }
1552
+ // LS11: one image upload a settled pause, so its GPU copy and mips land before the next and none queue behind a paint
1553
+ else if (settles) {
1554
+ await settledPause(); checkCurrent(); tSlice = performance.now();
1555
+ onProgress?.(base + i + 1, base + uploadTextures.length, `${i + 1} / ${uploadTextures.length} textures uploaded`);
1556
+ }
1557
+ else if (isolateImageUploads ? imageUpload : performance.now() - tSlice > heldBudget(sliceMs)) { await pause(); checkCurrent(); tSlice = performance.now(); }
1558
+ }
1559
+ // The batch's last uploads keep their own drawn frame before whatever follows warm-up, as isolation did.
1560
+ if (batch?.pending() === true) await pause();
1561
+ checkCurrent();
1562
+ onStage?.('upload', performance.now() - stageStart, uploadTextures.length);
1563
+ // Image bytes uploaded (KiB) with the slowest single upload's main-thread time.
1564
+ onStage?.('upload-kib', slowestUpload, Math.round(imageBytes / 1024));
1565
+ return { materials, jobs: jobs.length, programs: created.length, parallel };
1566
+ }
1567
+
1568
+
1569
+
1570
+
1571
+
1572
+
1573
+
1574
+ /**
1575
+ * Link an offscreen pass's programs before its first draw (op-hitch47): `compileAsync` with the pass's own target bound,
1576
+ * so the programs carry that target's keys (a render target's draws skip tone mapping and the output conversion), and
1577
+ * resolves once the driver has linked them (KHR_parallel_shader_compile where there is one). The target is restored.
1578
+ * Completion and fallback first-use queries share measured work slices, without a browser-specific policy. Slow
1579
+ * queries yield before the next native unit; cheap queries batch. `current` fences every sliced continuation.
1580
+ */
1581
+ export async function compileOffscreenPass(renderer: Renderer, pass: OffscreenPass, current: () => boolean = () => true): Promise<void> {
1582
+ const checkCurrent = (): void => { if (!current()) throw new Error('Shader warm-up owner left'); };
1583
+ checkCurrent();
1584
+ const compileSlice = workSlice(LIVE_PRECOMPILE_SLICE_MS, pageScope);
1585
+ await compileSlice.check(); checkCurrent();
1586
+ const prior = renderer.getRenderTarget(), face = renderer.getActiveCubeFace(), mip = renderer.getActiveMipmapLevel();
1587
+ let materials: Set<THREE.Material>;
1588
+ renderer.setRenderTarget(pass.target);
1589
+ try { materials = renderer.compile(pass.scene, pass.camera); } finally { renderer.setRenderTarget(prior, face, mip); }
1590
+ await compileSlice.check(); checkCurrent();
1591
+ // O15: three's compileAsync asked each link's COMPLETION_STATUS every 10 ms with no limit (~20 ms a query through
1592
+ // WebKit's GPU process on the Simulator), and a link WebKit never reported held Driftwood's region sky, so its entry
1593
+ // warm-up stalled in before-warm past 30 s. The links are asked at LIVE_LINK_POLL_MS for at most LINK_WAIT_MS; then
1594
+ // each one still pending is linked synchronously (its first use, `getUniforms`), as the live resolve does.
1595
+ const unready = async (): Promise<unknown[]> => {
1596
+ // The 250 ms poll delay is idle time, not query work: give each scan its own clock. A slow driver query ends its
1597
+ // slice before the next program; fast desktop queries retain the same batch and native call order.
1598
+ const slice = workSlice(LIVE_PRECOMPILE_SLICE_MS, pageScope), pending: unknown[] = [];
1599
+ for (const material of materials) for (const program of materialPrograms(renderer, material)) {
1600
+ await slice.check(); checkCurrent();
1601
+ if (typeof program !== 'object' || program === null || nativeRetired(program)) continue;
1602
+ const isReady: unknown = Reflect.get(program, 'isReady');
1603
+ if (typeof isReady === 'function' && Reflect.apply(isReady, program, []) !== true) pending.push(program);
1604
+ }
1605
+ await slice.check(); checkCurrent();
1606
+ return pending;
1607
+ };
1608
+ if (await boundedLinkWait(async () => (await unready()).length === 0, () => new Promise<void>((resolve) => { pageScope.timeout(LIVE_LINK_POLL_MS, resolve); }))) return;
1609
+ const pending = await unready(), resolveSlice = workSlice(LIVE_PRECOMPILE_SLICE_MS, pageScope);
1610
+ for (const program of pending) {
1611
+ await resolveSlice.check(); checkCurrent();
1612
+ if (typeof program !== 'object' || program === null || nativeRetired(program)) continue;
1613
+ const getUniforms: unknown = Reflect.get(program, 'getUniforms');
1614
+ if (typeof getUniforms === 'function') Reflect.apply(getUniforms, program, []);
1615
+ await resolveSlice.check(); checkCurrent();
1616
+ }
1617
+ }
1618
+
1619
+ /**
1620
+ * Whether the renderer would draw `object` from `camera` now: shown up its parents, on the camera's layers, with copies to
1621
+ * draw, and in the camera's frustum unless it is never frustum culled (three's own test). What the camera carries (the
1622
+ * held view: the swim hands, a rig's other sword, the reins) counts however its own parts are hidden: a swim, a swap or a
1623
+ * mount shows it at once, and left to the in-play warm-up its links sat in the Simulator spawn's first seconds (D12).
1624
+ */
1625
+ function drawnFrom(camera: THREE.Camera, entering?: THREE.Object3D, turns: readonly number[] = []): (object: THREE.Object3D) => boolean {
1626
+ camera.updateMatrixWorld();
1627
+ const frusta = [new THREE.Frustum().setFromProjectionMatrix(new THREE.Matrix4().multiplyMatrices(camera.projectionMatrix, camera.matrixWorldInverse))];
1628
+ // PL6: the first frame's warm turns (Game.warmTurn: a square 100° view turned by each yaw, level, from the same eye)
1629
+ // draw what is behind and beside the spawn too; left out here, their programs built and linked inside the first frame
1630
+ if (camera instanceof THREE.PerspectiveCamera) for (const turn of turns) {
1631
+ const view = new THREE.PerspectiveCamera(100, 1, camera.near, camera.far), yaw = new THREE.Euler().setFromQuaternion(camera.quaternion, 'YXZ').y;
1632
+ view.position.copy(camera.position); view.scale.copy(camera.scale); view.quaternion.setFromEuler(new THREE.Euler(0, yaw + turn, 0, 'YXZ'));
1633
+ view.updateMatrix(); view.matrixWorld.copy(view.matrix);
1634
+ if (camera.parent !== null) view.matrixWorld.premultiply(camera.parent.matrixWorld);
1635
+ view.matrixWorldInverse.copy(view.matrixWorld).invert();
1636
+ frusta.push(new THREE.Frustum().setFromProjectionMatrix(new THREE.Matrix4().multiplyMatrices(view.projectionMatrix, view.matrixWorldInverse)));
1637
+ }
1638
+ return (object) => {
1639
+ let held = false;
1640
+ for (let at = object.parent; at !== null && !held; at = at.parent) held = at === camera;
1641
+ // The entering root alone is hidden by admission. Its authored descendants
1642
+ // keep their own visibility, layers, instance counts and camera culling.
1643
+ // Below the camera a held part's own visibility is ignored; the camera and its parents still count.
1644
+ for (let at: THREE.Object3D | null = object, carried = held; at !== null; at = at.parent) {
1645
+ if (at === camera) carried = false;
1646
+ if (!carried && at !== entering && !at.visible) return false;
1647
+ }
1648
+ if (!object.layers.test(camera.layers)) return false;
1649
+ if (object instanceof THREE.InstancedMesh && object.count === 0) return false;
1650
+ if (held || !object.frustumCulled) return true;
1651
+ // what three's frustum test reads: a bounded geometry (anything else, a sprite too, is compiled now)
1652
+ const geometry: unknown = Reflect.get(object, 'geometry');
1653
+ return !(geometry instanceof THREE.BufferGeometry) || frusta.some(frustum => frustum.intersectsObject(object));
1654
+ };
1655
+ }
1656
+
1657
+ /**
1658
+ * D188 (G808, G815): what an arrival needs drawn before its reveal. Content outside `root` (the page: roads, other
1659
+ * cells, the sky) keeps its whole inventory. Inside `root` (the parked destination, hidden while it waits), a drawable
1660
+ * whose bounds reach within `radius` of `at` (horizontal, every direction: the player can turn on the reveal) is in; so
1661
+ * is one whose bounds can't be trusted (unbounded, unculled, skinned, morphed, drawn through callbacks), which draws
1662
+ * wherever it is, and one under a hidden subtree (a placement's other LOD level, an alternate shown later): the parked
1663
+ * draws warm one of each such pipeline wherever it is, and left out here it compiled inside those held draws.
1664
+ */
1665
+ export function arrivalSet(root: THREE.Object3D, at: THREE.Vector3, radius: number): (object: THREE.Object3D) => boolean {
1666
+ const centre = new THREE.Vector3();
1667
+ return (object) => {
1668
+ let inside = false;
1669
+ for (let node: THREE.Object3D | null = object; node !== null; node = node.parent) {
1670
+ if (node === root) { inside = true; break; }
1671
+ }
1672
+ if (!inside) return true;
1673
+ for (let node: THREE.Object3D | null = object; node !== null && node !== root; node = node.parent) if (!node.visible) return true;
1674
+ if (object instanceof THREE.InstancedMesh && object.count === 0) return false;
1675
+ if (!object.frustumCulled || object instanceof THREE.SkinnedMesh || object.onBeforeRender !== THREE.Object3D.prototype.onBeforeRender
1676
+ || object.onAfterRender !== THREE.Object3D.prototype.onAfterRender) return true;
1677
+ const geometry: unknown = Reflect.get(object, 'geometry');
1678
+ if (!(geometry instanceof THREE.BufferGeometry)) return true;
1679
+ for (const key in geometry.morphAttributes) if (Object.hasOwn(geometry.morphAttributes, key)) return true;
1680
+ if (object instanceof THREE.InstancedMesh) { if (object.boundingSphere === null) object.computeBoundingSphere(); }
1681
+ else if (geometry.boundingSphere === null) geometry.computeBoundingSphere();
1682
+ const sphere: unknown = object instanceof THREE.InstancedMesh ? object.boundingSphere : geometry.boundingSphere;
1683
+ if (!(sphere instanceof THREE.Sphere) || !Number.isFinite(sphere.radius)) return true;
1684
+ centre.copy(sphere.center).applyMatrix4(object.matrixWorld);
1685
+ return Math.hypot(centre.x - at.x, centre.z - at.z) - sphere.radius * object.matrixWorld.getMaxScaleOnAxis() <= radius;
1686
+ };
1687
+ }
1688
+
1689
+ /**
1690
+ * T10 (G808): the programs an arrival links before its reveal: `arrivalSet` (the node materials it also took, each one
1691
+ * unsliceable build, retired with the node runtime in NF18). Its parked first draws still follow the reveal with the rest.
1692
+ */
1693
+ export function arrivalPrograms(root: THREE.Object3D, at: THREE.Vector3, radius: number): (object: THREE.Object3D) => boolean {
1694
+ return arrivalSet(root, at, radius);
1695
+ }
1696
+
1697
+ /** The level supplies compile policy; the mechanism owns all shader jobs. */
1698
+ let earlyStandIn: THREE.WebGLRenderTarget | null = null;
1699
+ const earlyTarget = (): THREE.WebGLRenderTarget => { earlyStandIn ??= new THREE.WebGLRenderTarget(1, 1, { type: THREE.HalfFloatType }); return earlyStandIn; };
1700
+ export async function precompileLevel(game: Pick<Game, 'renderer' | 'camera' | 'scene' | 'rootScene' | 'composer' | 'composerBuilt' | 'level'>, onProgress?: (done: number, total: number, detail: string) => void,
1701
+ options: { /** Entered frames reuse their existing caster geometry. */ chunkCasters?: boolean; /** Fence yielded work to its entered owner. */ current?: () => boolean;
1702
+ /** A parked content subtree whose lights become visible on entry; no live light/visibility change. */ futureLighting?: THREE.Object3D;
1703
+ /** Content that leaves with the entered frame's owner (its staged camera models): no exterior variant (O14). */ leaving?: readonly THREE.Object3D[];
1704
+ /** The installing scene's PMREM when futureLighting includes sibling content outside that scene. */ futureEnvironment?: THREE.Texture;
1705
+ /** Temporary program holders survive until this frame leaves; content materials remain borrowed. */ owner?: Pick<Scope, 'onDispose'>;
1706
+ /** Yield after each image upload during live preparation; ordinary boot keeps batched uploads. */ isolateImageUploads?: boolean;
1707
+ /** A live presentation barrier; initial boot keeps the ordinary browser paint opportunity. */ pause?: () => Promise<void>;
1708
+ /** Batch image uploads per frame under this budget (op-hitch32): several when isolated, none started past it. */ uploadBudget?: UploadBudget;
1709
+ /** Optional scalar stage timings, including painted waits. Does not retain materials or native handles. */ onStage?: PrecompileStage;
1710
+ /** Warm post draw pipelines one material per paint during initial loading; never used by live preparation. */ warmPost?: boolean;
1711
+ /** Start completed world materials while construction continues. Other jobs and exterior variants remain
1712
+ * mandatory in the final complete preparation, after the page's presentation owners have settled. */ sceneOnly?: boolean;
1713
+ /** A live warm-up's slice bound (LIVE_PRECOMPILE_SLICE_MS): one material a job, each slice checked against it. */ sliceMs?: number;
1714
+ /** Programs only for what the camera draws now (the first frame's); the rest is the caller's later warm-up (S1): the
1715
+ * scene's undrawn materials, material families and the exterior (road) lighting variants, none of which draws until
1716
+ * a look swaps or the player leaves the cell. Shadow, offscreen, post and background jobs stay whole: any of them
1717
+ * can draw in the first seconds (a turn moves casters into a cascade, a menu blurs). */ drawnOnly?: boolean;
1718
+ /** D188 (G815): scene programs only for what `arrivalSet` keeps; like `drawnOnly`, material families and the
1719
+ * exterior variants wait for the caller's after-reveal warm-up. Shadow, offscreen, post and background stay whole. */
1720
+ arrival?: (object: THREE.Object3D) => boolean;
1721
+ /** PL6: with `drawnOnly`, the yaws the first frame's warm turns draw (`Game.warmTurnYaws`): what they show counts as drawn. */
1722
+ turns?: readonly number[];
1723
+ /** DL23 (J198): with `drawnOnly`, scene programs for exactly what the boot's first frame draws (`parkedDraws`
1724
+ * `firstFrameDrawables`) instead of the camera's view and turns: left out, they linked synchronously inside its
1725
+ * parked draws. */
1726
+ firstFrame?: (object: THREE.Object3D) => boolean;
1727
+ /** Scene and exterior programs ordered by the camera's distance to what draws them, nearest first (the after-control
1728
+ * warm-up: what the player reaches soonest links soonest). */ nearest?: boolean } = {}): Promise<number> {
1729
+
1730
+ if (options.current?.() === false) throw new Error('Shader warm-up owner left');
1731
+ if (options.futureLighting !== undefined) {
1732
+ await prepareSceneResources([options.futureLighting], game.camera, options.current ?? (() => true));
1733
+ }
1734
+ const tracedBoot = bootTraceActive();
1735
+ if (tracedBoot) recordGpuCheckpoint(game.renderer, 'compile:before');
1736
+ // r186 removed PCFSoftShadowMap: the first shadow pass silently flips the type to PCF, and
1737
+ // shadowMapType is in every program's cache key — so everything compiled here would be
1738
+ // compiled AGAIN by the first frame (desktop 105 → 179 programs). Settle it before compiling.
1739
+ // oxlint-disable-next-line typescript/no-deprecated -- the guard exists to migrate away from the deprecated value
1740
+ if (game.renderer.shadowMap.type === THREE.PCFSoftShadowMap) game.renderer.shadowMap.type = THREE.PCFShadowMap;
1741
+ // E153: island-wide casters draw into each shadow map in pieces, culled per cascade (shadowChunks.ts)
1742
+ if (options.chunkCasters !== false) {
1743
+ // SF67: sliced with a painted frame between (it was one 0.3 s task on Driftwood at 4×); the pieces are the same
1744
+ let tChunk = performance.now();
1745
+ const pauseChunking = async (): Promise<void> => {
1746
+ await (options.pause ?? frame)();
1747
+ if (options.current?.() === false) throw new Error('Shader warm-up owner left');
1748
+ tChunk = performance.now();
1749
+ };
1750
+ const cut = await chunkShadowCastersSliced(game.scene, () => (performance.now() - tChunk < 12 ? null : pauseChunking()));
1751
+ if (cut.meshes > 0) console.info(`[shadow] ${String(cut.meshes)} casters in ${String(cut.pieces)} pieces (${String(cut.tris)} tris)`);
1752
+ }
1753
+ // Compile against the same page lights/environment as firstFrame. A regional content binding
1754
+ // changes game.scene only for installation; the renderer always draws rootScene. Keep caster
1755
+ // chunking above scoped to the content frame so warm-up cannot restructure other residents.
1756
+ const scene = game.rootScene;
1757
+ // DL10: an early scene-only pass runs before buildComposer(); three keys a program on whether it draws to a (non-XR)
1758
+ // target, not on which, so a 1 x 1 stand-in gives the composer input buffer's programs (linear output, no tone mapping)
1759
+ const rt = game.composerBuilt ? game.composer.inputBuffer : earlyTarget();
1760
+ // A live warm-up builds its jobs in work slices too (its compile slices start only in runPrecompile): the setup below
1761
+ // was one 190-220 ms task when a crossing prepared a resident (Driftwood and Pine drives on the phone at 4x)
1762
+ // its owner taken now, and its setup's yields on the page's scope: after an await the ambient owner can be any
1763
+ // task's, even a retired cell's closed scope, whose timers never fire (a setup yield on one stalled Driftwood's
1764
+ // warm-up for 9,103 frames); `current` ends an abandoned warm-up at its next step
1765
+ const owner = options.owner ?? resourceScope();
1766
+ const live = options.sliceMs !== undefined, setup = workSlice(undefined, pageScope);
1767
+ const pace = async (): Promise<void> => {
1768
+ if (!live || !setup.due()) return;
1769
+ await setup.yield();
1770
+ if (options.current?.() === false) throw new Error('Shader warm-up owner left');
1771
+ };
1772
+ const policy = game.level.boot.shaders;
1773
+ // sp-o289: the shadow pass's own depth substitutes (graph shadow-depth variants), where a back-end registered them
1774
+ const depthVariants = shadowDepthResolver(game.renderer);
1775
+ const single = options.isolateImageUploads === true || options.sliceMs !== undefined;
1776
+ const per = single ? 1 : 6;
1777
+ const excludedRoots = entryFrameExclusions(scene, options.futureLighting);
1778
+ const kinded = (kind: string, list: CompileJob[]): CompileJob[] => { for (const job of list) job.kind = kind; return list; };
1779
+ const from = options.nearest === true ? game.camera.getWorldPosition(new THREE.Vector3()) : undefined, drawnOnly = options.drawnOnly === true || options.arrival !== undefined;
1780
+ // The page's road/held roots can still change while its home constructs.
1781
+ // Only the completed destination subtree lends materials to the head start,
1782
+ // with what the camera carries (PL6: a grid region's kit mounts its held
1783
+ // view before its play; regionalRuntime's census after the kit takes it).
1784
+ const roots = options.sceneOnly === true && options.futureLighting !== undefined ? [options.futureLighting, game.camera] : [scene];
1785
+ const { jobs, materials } = policy?.scene === false ? { jobs: [], materials: 0 }
1786
+ : live || drawnOnly
1787
+ ? await pacedSceneJobs(scene, rt, per, roots, excludedRoots, options.current ?? (() => true), pageScope, options.arrival
1788
+ ?? (drawnOnly ? options.firstFrame ?? drawnFrom(game.camera, options.futureLighting, options.turns) : undefined), from)
1789
+ : sceneJobs(scene, rt, per, roots, excludedRoots);
1790
+ // Diagnostic split: the entered root's own materials, else the rest of the page compiled under its lights.
1791
+ const entered = new Set<THREE.Material>();
1792
+ options.futureLighting?.traverse(object => { for (const material of materialsOf(object)) entered.add(material); });
1793
+ for (const job of jobs) job.kind = job.root.children.some(clone => materialsOf(clone).some(material => entered.has(material))) ? 'scene-entered' : 'scene-other';
1794
+ await pace();
1795
+ // material families (SF10a): live family programs the scene does not hold yet (none live: no jobs)
1796
+ if (options.sceneOnly !== true && policy?.scene !== false) jobs.push(...kinded('family', drawnOnly ? [] : familyCompileJobs(scene, rt, per, exclusiveMaterials(scene, excludedRoots))), ...kinded('offscreen', offscreenJobs(scene, 1, excludedRoots)));
1797
+ await pace();
1798
+ if (options.sceneOnly !== true && policy?.shadows !== false) jobs.push(...kinded('shadow', shadowJobs(scene, rt, per, excludedRoots, depthVariants)));
1799
+ await pace();
1800
+ const bg = options.sceneOnly === true ? null : backgroundJob(scene, rt);
1801
+ if (bg && policy?.background !== false) jobs.push(...kinded('background', [bg])); else bg?.dispose?.();
1802
+ const post = options.sceneOnly === true || policy?.post === false ? [] : kinded('post', postJobs(game.composer, rt, single || options.warmPost === true ? 1 : Number.POSITIVE_INFINITY));
1803
+ // Issue the post links first so driver work overlaps the world/shadow jobs.
1804
+ if (options.warmPost === true) jobs.unshift(...post); else jobs.push(...post);
1805
+ // Three renders shadows before setupLights(), so the first entered shadow draw still uses the preceding
1806
+ // road frame's light state. Warm that depth variant too; the following shadow draw uses the future state.
1807
+ const previousShadows = options.sceneOnly !== true && policy?.shadows !== false && options.futureLighting !== undefined && options.futureLighting !== scene
1808
+ ? kinded('previous-shadow', shadowJobs(scene, rt, per, excludedRoots, depthVariants)) : [];
1809
+ await pace();
1810
+ if (options.futureLighting !== undefined) includeFutureLights(jobs, scene, options.futureLighting, options.futureEnvironment);
1811
+ jobs.push(...previousShadows);
1812
+ if (options.sceneOnly !== true && policy?.scene !== false && !drawnOnly) jobs.push(...kinded('exterior', exteriorJobs(scene, rt, policy?.shadows !== false, undefined, per, depthVariants, options.leaving, from)));
1813
+ await pace();
1814
+ if (options.sceneOnly !== true && policy?.post !== false) jobs.push(readbackPreparation(owner));
1815
+ for (const job of jobs) if (job.dispose !== undefined) owner.onDispose(job.dispose);
1816
+ let completed = 0, total = 0;
1817
+ const warm = options.warmPost === true ? post : [];
1818
+ const progress = (done: number, count: number, detail: string): void => {
1819
+ completed = done; total = count; onProgress?.(done, count + warm.length, detail);
1820
+ };
1821
+ if (live) { await setup.yield(); if (options.current?.() === false) throw new Error('Shader warm-up owner left'); }
1822
+ const report = await runPrecompile(game.renderer, game.camera, jobs, materials, progress, collectTextures(jobs), options.current, options.isolateImageUploads, options.pause, options.uploadBudget, options.onStage, options.sliceMs);
1823
+ if (warm.length > 0) {
1824
+ // LS11: on a serial GPU each post draw's pipeline lands before the next (the last one draws to the canvas)
1825
+ const serial = serialLoading(game.renderer, options.isolateImageUploads === true);
1826
+ const postPause = serial ? gpuSettled(game.renderer, options.pause ?? frame, options.current ?? (() => true)) : options.pause ?? frame;
1827
+ await warmPostJobs(game.renderer, warm, postPause, options.current ?? (() => true),
1828
+ (done, count, detail) => { onProgress?.(completed + done, total + count, detail); }, serial);
1829
+ }
1830
+ if (tracedBoot) recordGpuCheckpoint(game.renderer, 'compile:after');
1831
+ return report.materials;
1832
+
1833
+ }