@wildshard/engine 0.0.0 → 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 +1304 -4
  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 -6
@@ -0,0 +1,1476 @@
1
+ import type { BoxSpec } from '../../../shared/engine/physics/box';
2
+ /**
3
+ * `place(model, placements, options)` — the world composes models (E306 / E315; the guide is ./model.ts). One call:
4
+ * builds the copies the way `draw` says (merged / instanced / batched / single, with the model's LODs and per-copy
5
+ * culling), carries the model's own-space colliders to every placement, registers ONE registry piece (what is drawn,
6
+ * the world-space colliders, a floor) and the model's ONE catalog entry for the shard (copies summed over every
7
+ * `place` of it, a tap target on its copies, VIEW IN WORLD on the real copy nearest the spawn).
8
+ *
9
+ * const ctx = modelContext(sky, renderer);
10
+ * const rocks = place(shoreBoulder, placements, { ctx, draw: 'merged', piece: { id: 'rocks', name: 'Shore boulders', solidFloor: true } });
11
+ * const ferns = place(fern, placements, { ctx, draw: 'instanced', cull: { far: 60, keepNear: 12 } });
12
+ * game.onRender(() => cullPlaced(camera)); // once a frame, after the camera is posed, if anything culls or has LODs
13
+ *
14
+ * const homestead = new Weld({ unit: 'copy', parent: group, detail: 30, near: true }); // a merge across models (E347)
15
+ * place(logCabin, [site], { ctx, draw: 'merged', weld: homestead, piece: { id: 'cabin-1' } }); // … one call per building
16
+ * homestead.finish(); // welds them, registers their pieces
17
+ * place(woodenCrate, crates, { ctx, draw: 'instanced', weld: homestead }); // `host`: the building each stands by
18
+ *
19
+ * Cost: every path draws what the hand-rolled code drew (merged = one draw per material per cell; instanced = one per
20
+ * part per variant per LOD level in view; batched = one per material; single = one per part per copy) and its cullers
21
+ * allocate nothing per frame (./cull.ts).
22
+ */
23
+ import { app } from '../app/runtime';
24
+ import { frameBudgetSpent, paceYield, presenting } from '../../../shared/engine/core/framePacing';
25
+ import { WORK_SLICE_MS, yieldTask } from '../../../shared/engine/core/workSlice';
26
+ import * as THREE from 'three';
27
+ import { ChangedBatchedMesh } from '../render/changedTextureUploads';
28
+ import { setInstanceEnvelope } from '../render/instancedGeometry';
29
+ import { cullCopiesPerCascade } from '../world/cascadeCull';
30
+ import { mergeGeometries } from 'three/examples/jsm/utils/BufferGeometryUtils.js';
31
+ import { Rng } from '../../../shared/engine/core/rng';
32
+ import { currentOwner, enteredOwner, withOwner } from '../../../shared/engine/app/ownership';
33
+ import type { Scope } from '../../../shared/engine/app/scope';
34
+ import type { ColliderDesc, DrawnAs, ModelEntry, WorldRegistry } from '../world/registry';
35
+ import { FrameCamera } from '../world/frameCamera';
36
+ import { geometryBoundsSteps } from '../world/geometryBounds';
37
+ import { keepShadowWhole } from '../world/shadowChunks';
38
+ import { withTier } from '../explore/tiers';
39
+ import { loadingSpecimen } from './gear';
40
+ import { specimenReady, paramsOf, seedOf, type ModelBuild, type ModelBuildVisit, type ModelContext, type ModelDef, type ModelPart, type Placement } from './model';
41
+ import { drawnHullOwn, drawnHullWorld, placeCollider, poseGeometry, poseOf, type Pose } from './colliders';
42
+ import { BatchedCull, CelledCopiesCull, CellCull, cullFresh, InstancedCull, SetCull, UntilCull, WeldCull, type BatchedSlot, type CullOptions, type HostedSet, type InstancedSink } from './cull';
43
+ import { UnitParts, nearProxy, weldAcross, type WeldBuild } from './weld';
44
+ import { resourceScope } from '../../../shared/engine/app/resources';
45
+ import { ownSceneResource } from '../app/sceneOwnership';
46
+
47
+
48
+ /** how the copies are drawn (see ./model.ts step 3) */
49
+ export type Draw = 'single' | 'merged' | 'instanced' | 'batched';
50
+
51
+ /** the registry piece a `place` call adds (defaults: the model's id and name; no floor) */
52
+ export interface PieceOptions {
53
+ /** keep the old builder's piece id when migrating (saves, tests, footprints key on it) */
54
+ readonly id?: string;
55
+ readonly name?: string;
56
+ /** placement / footsteps floor function, world space (see Piece.floor) */
57
+ readonly floor?: (x: number, z: number) => number | undefined;
58
+ /** the floor is real geometry in the colliders (Piece.solidFloor) */
59
+ readonly solidFloor?: boolean;
60
+ /**
61
+ * a moving placement: the colliders ride this object (Piece.follows; then they are in its local frame). `'copy'`: the
62
+ * one `single` copy this call places moves (the boat on the swell) — the piece follows it, its colliders the model's
63
+ * own-space ones (E315 M1)
64
+ */
65
+ readonly follows?: THREE.Object3D | 'copy';
66
+ readonly active?: () => boolean;
67
+ /**
68
+ * Register the colliders `every` at a time, a `yieldTask` apart (the phone's ~30 ms per-task collider budget): the
69
+ * first piece carries the object and the first `every`; `<id>-2`, `<id>-3` … the rest. `Placed.registered` settles when
70
+ * the last is in.
71
+ */
72
+ readonly split?: { readonly every: number; readonly yieldTask: () => Promise<void> };
73
+ /**
74
+ * world-space colliders the piece carries besides its copies' own (a baked set's boxes fitted to the ground: the
75
+ * Driftwood cove's palm trunks and crag plates), registered after them on the same piece
76
+ */
77
+ readonly colliders?: readonly ColliderDesc[];
78
+ /**
79
+ * false: the piece registers its object, floor and picks but none of its colliders; `Placed.colliders` still lists them
80
+ * (world space) for a caller that registers them itself (a tile's colliders on the collider ring, tile streaming T3)
81
+ */
82
+ readonly collide?: false;
83
+ }
84
+
85
+ /** how `place` draws a model's copies: the model context, the draw, merging into cells and culling */
86
+ export interface PlaceOptions {
87
+ readonly ctx: ModelContext;
88
+ readonly draw: Draw;
89
+ /** merged: split the copies into square cells of this many metres, one mesh per cell and material (culled per cell) */
90
+ readonly cell?: number;
91
+ /**
92
+ * merged: each copy's `color` multiplies its vertex colours, as an instanced copy's tint multiplies its diffuse (FC12: a
93
+ * family drawn merged instead of instanced looks the same). Off: a merged copy's `color` is not drawn.
94
+ */
95
+ readonly mergedTint?: boolean;
96
+ /** merged: each mesh casts whole, never split into shadow pieces (a light family: its pieces cost more draws than tris) */
97
+ readonly shadowWhole?: boolean;
98
+ /** per-copy culling (instanced / batched; merged: per cell). Without it, instanced copies are culled as one set */
99
+ readonly cull?: CullOptions;
100
+ /** default: the running shard's registry; null: build only (a dev page) */
101
+ readonly registry?: WorldRegistry | null;
102
+ readonly piece?: PieceOptions;
103
+ /** batched: three's per-draw sort of the batch's instances (default three's: on) */
104
+ readonly sortObjects?: boolean;
105
+ /**
106
+ * batched: add the copies to this BatchedMesh (sized by its owner) instead of a new one, when their material is its
107
+ * material — models and the world's own geometry in one draw (Pine Hollow's crags, their face skin and the cave).
108
+ * Always batched: there is no instanced fallback for a shared batch.
109
+ */
110
+ readonly batch?: THREE.BatchedMesh;
111
+ /**
112
+ * The copies are drawn already (M3, Nalati): `place` draws nothing and carries what they made (`DrawnInto`) — their
113
+ * colliders, boxes, count and the model's catalog entry. `draw` still says how they are drawn (the card's fact).
114
+ */
115
+ readonly drawnInto?: DrawnInto;
116
+ /** instanced: the shard's own per-copy culler takes the copies instead of `cullPlaced` (see `InstancedCuller`) */
117
+ readonly culler?: InstancedCuller;
118
+ /** draw under this object (a shard's root group) instead of the scene root; the registry's piece is the same object */
119
+ readonly parent?: THREE.Object3D;
120
+ /**
121
+ * A merge across several models (E347, ./weld.ts): `draw: 'merged'` — each copy is the model's site-fitted build
122
+ * (`ModelDef.weld`), its parts merged with its unit's, its bands culled by the weld; `draw: 'instanced'` — copies set
123
+ * about the weld's copies (`Placement.host`), drawn by their host. The weld draws what they share, so the piece anchors
124
+ * on its copies (as `drawnInto`); a welded copy's piece is registered by `Weld.finish`, once the weld has drawn it.
125
+ */
126
+ readonly weld?: Weld;
127
+ }
128
+
129
+ /**
130
+ * A shard's own per-copy culler for instanced copies (E306 M4: Nine Dragon's E283 batch culler, its crowd's figure LODs
131
+ * and its paper lanterns' buckets keep the culling their draws were tuned with). `place` draws each part as a hand-rolled
132
+ * InstancedMesh was — every copy written into level 0 (its own buffers, its bounding sphere computed), each LOD level a
133
+ * mesh of its own with room for every copy (count 0, hidden) — and hands the part's levels to `take`. The shard culls
134
+ * them in its own frame hook; `cullPlaced` never touches them.
135
+ */
136
+ interface InstancedCuller {
137
+ take: (batch: HandedBatch) => void;
138
+ }
139
+
140
+ /** one part of one variant of a `place` call, handed to an `InstancedCuller` */
141
+ interface HandedBatch {
142
+ /** level 0 (every copy), then the model's LODs nearest first; `mesh: null`: nothing is drawn from `from` on */
143
+ readonly levels: readonly { readonly mesh: THREE.InstancedMesh | null; readonly from: number }[];
144
+ /** the copies' poses, in level 0's instance order */
145
+ readonly poses: readonly THREE.Matrix4[];
146
+ /** the call's `cull` options (its `far` …) */
147
+ readonly cull: CullOptions;
148
+ }
149
+
150
+ /**
151
+ * Copies drawn by the set they stand in, not by `place` (M3): each Nalati place is ONE painted mesh — every model of a
152
+ * camp or a kurgan field welded into one kit, painted per vertex in world space and AO-baked against the terrain
153
+ * together — and its generated models are instanced per place when their file lands. The
154
+ * object stays where its set put it (the registry's piece goes without it). The model's own-space colliders still go to
155
+ * each placement; `colliders` are the ones the copies made in world space as they were drawn (a model fitted to the
156
+ * ground under it). A `drawn-hull` collider needs `place` to draw.
157
+ */
158
+ export interface DrawnInto {
159
+ /** what draws them (shared by the set's models: a tap on it picks the model whose copy is under the finger) */
160
+ readonly object: THREE.Object3D;
161
+ /** each copy's world box, 6 floats per copy (min xyz, max xyz), in placement order */
162
+ readonly boxes: Float32Array;
163
+ readonly colliders?: readonly ColliderDesc[];
164
+ }
165
+
166
+ /** what a `place` call built */
167
+ export interface Placed {
168
+ readonly model: string;
169
+ /** everything it draws: the one mesh when there is one, else a group */
170
+ readonly object: THREE.Object3D;
171
+ /** its colliders, world space, in placement order */
172
+ readonly colliders: readonly ColliderDesc[];
173
+ readonly copies: number;
174
+ readonly drawnAs: DrawnAs;
175
+ /** per-copy culling / LOD for this view (a no-op when nothing culls); cheap when the camera hasn't moved */
176
+ cull: (camera: THREE.Camera) => void;
177
+ /** copy i's world box */
178
+ copyBox: (i: number, target: THREE.Box3) => THREE.Box3;
179
+ /** the copy nearest p (-1 when there are none) */
180
+ nearest: (p: THREE.Vector3) => number;
181
+ /** settles once every piece is registered (at once, unless `piece.split`, or in play a piece over LIVE_SPLIT_OVER colliders) */
182
+ readonly registered: Promise<void>;
183
+ }
184
+
185
+ /** what one drawing path hands back */
186
+ interface Drawn {
187
+ object: THREE.Object3D;
188
+ drawnAs: DrawnAs;
189
+ colliders: ColliderDesc[];
190
+ /** world boxes, 6 floats per copy (min xyz, max xyz) */
191
+ boxes: Float32Array;
192
+ /** `camera`: the view in the copies' own frame (SF63: `FrameCamera`); `world`: the camera itself, for three's LODs, which measure world matrices */
193
+ cull: ((camera: THREE.Camera, world?: THREE.Camera) => void) | null;
194
+ /** the same with a view handed in (`CullOptions.view`) */
195
+ cullWith?: ((frustum: THREE.Frustum, eye: THREE.Vector3) => void) | null;
196
+ }
197
+
198
+ // ── the shard's placed models (E155: every resident shard has its own) ──
199
+
200
+ interface ModelRecord { readonly groups: Placed[] }
201
+ type Culler = (camera: THREE.Camera, world: THREE.Camera) => void;
202
+ /**
203
+ * What one resident world placed (SF57): its model records and the cullers its calls started. A life is its registry's (a
204
+ * grid region's view, a standalone level's), or for a build-only call (`registry: null`) its owner scope's, else the page's.
205
+ * When the registry retires or the owner disposes, its records and cullers go: `cullPlaced` runs only live worlds' cullers,
206
+ * `placedGroups` returns only live groups, and nothing keeps their copies, boxes or culler arrays alive.
207
+ */
208
+ interface Life { readonly records: Map<string, ModelRecord>; readonly cullers: Culler[]; retired: boolean; readonly frame: FrameCamera | null }
209
+ const lives = new Map<object, Life>();
210
+ const pageLife: Life = { records: new Map(), cullers: [], retired: false, frame: null };
211
+ /** every live culler, flat, in the order they started (cullPlaced allocates nothing per frame), and the life each belongs to */
212
+ const cullers: Culler[] = [];
213
+ const cullerLives: Life[] = [];
214
+ /** cullPlaced's frame count: a framed life's camera is posed once per call */
215
+ let cullStamp = 0;
216
+ /** the life each weld's place calls belong to (its band culler starts at `Weld.finish`) */
217
+ const weldLives = new WeakMap<Weld, Life>();
218
+
219
+ function livedBy(key: object, retireOn: (end: () => void) => void, frame: THREE.Object3D | null = null): Life {
220
+ const known = lives.get(key);
221
+ if (known !== undefined) return known;
222
+ const life: Life = { records: new Map(), cullers: [], retired: false, frame: frame === null ? null : new FrameCamera(frame) };
223
+ lives.set(key, life);
224
+ retireOn(() => {
225
+ life.retired = true;
226
+ if (lives.get(key) === life) lives.delete(key);
227
+ for (const c of life.cullers) { const i = cullers.indexOf(c); if (i !== -1) { cullers.splice(i, 1); cullerLives.splice(i, 1); } }
228
+ life.cullers.length = 0;
229
+ life.records.clear();
230
+ });
231
+ return life;
232
+ }
233
+
234
+ /** the life a `place` call into `registry` belongs to */
235
+ function lifeOf(registry: WorldRegistry | null): Life {
236
+ if (registry !== null) return livedBy(registry, (end) => { registry.onRetire(end); }, registry.frame);
237
+ const owner = currentOwner();
238
+ return owner === null ? pageLife : livedBy(owner, (end) => { owner.onDispose(end); });
239
+ }
240
+
241
+ function startCuller(life: Life, c: Culler): void {
242
+ if (life.retired) return;
243
+ life.cullers.push(c); cullers.push(c); cullerLives.push(life);
244
+ }
245
+ function stopCuller(life: Life, c: Culler): void {
246
+ const at = life.cullers.indexOf(c);
247
+ if (at !== -1) life.cullers.splice(at, 1);
248
+ const i = cullers.indexOf(c);
249
+ if (i !== -1) { cullers.splice(i, 1); cullerLives.splice(i, 1); }
250
+ }
251
+
252
+ /** Attach restored weld bands to ordinary placed-model culling. The resident
253
+ * owns the culler; retiring either lifetime removes it before another frame. */
254
+ export function installWeldCulling(registry: WorldRegistry | null, owner: Scope, cull: WeldCull): void {
255
+ if (owner.disposed) throw new Error('Weld culling requires a live owner');
256
+ const life = lifeOf(registry), update: Culler = camera => { cull.update(camera); };
257
+ startCuller(life, update);
258
+ owner.onDispose(() => { stopCuller(life, update); });
259
+ }
260
+ /**
261
+ * The owner a `place` call was made under, when it ends before its world does (SF57): a borrowed home's entry places into
262
+ * the page's registry, and each re-entry places again. What the call recorded and started goes with that owner; null when
263
+ * the call has no explicit owner of its own (the world's retirement covers it).
264
+ */
265
+ /** Run `end` when `owner` disposes, unless `registry` retires first (then its life's own retirement covers it). */
266
+ function untilOwner(owner: Scope, registry: WorldRegistry, end: () => void): void {
267
+ const hold = { forgetRetire: (): void => undefined };
268
+ const forget = owner.capture('disposers', () => { hold.forgetRetire(); end(); });
269
+ hold.forgetRetire = registry.onRetire(forget);
270
+ }
271
+ function shorterOwner(registry: WorldRegistry | null): Scope | null {
272
+ // a build-only call's life is already its owner's (`lifeOf`)
273
+ const owner = registry === null ? null : enteredOwner();
274
+ return owner === null || owner === registry?.scope ? null : owner;
275
+ }
276
+
277
+ function eachLife(fn: (life: Life) => void): void {
278
+ fn(pageLife);
279
+ for (const life of lives.values()) fn(life);
280
+ }
281
+
282
+ /**
283
+ * Per-copy culling and LODs of everything the live shards placed — once a frame, after the camera is posed. A world whose
284
+ * registry stands in a frame of its own (a grid region's root, SF63) culls against the camera seen from that frame.
285
+ */
286
+ export function cullPlaced(camera: THREE.Camera): void {
287
+ cullStamp = (cullStamp + 1) % 0x40000000;
288
+ cullFresh(camera, () => {
289
+ for (let i = 0; i < cullers.length; i++) {
290
+ const frame = cullerLives[i]?.frame ?? null;
291
+ cullers[i]?.(frame === null ? camera : frame.of(camera, cullStamp), camera);
292
+ }
293
+ });
294
+ }
295
+
296
+
297
+ /** every `place` call the live shards have registered, in the order they were made (a shard's named places sort them into Sets) */
298
+ export function placedGroups(): readonly Placed[] {
299
+ const out: Placed[] = [];
300
+ eachLife((life) => { for (const r of life.records.values()) out.push(...r.groups); });
301
+ return out;
302
+ }
303
+
304
+ /** What placement holds now (SF57's lifetime check): live worlds, model records, registered groups and per-frame cullers. */
305
+ export interface PlacementCensus { readonly lives: number; readonly records: number; readonly groups: number; readonly cullers: number }
306
+ export function placementCensus(): PlacementCensus {
307
+ let records = 0, groups = 0;
308
+ eachLife((life) => { records += life.records.size; for (const r of life.records.values()) groups += r.groups.length; });
309
+ return { lives: lives.size, records, groups, cullers: cullers.length };
310
+ }
311
+
312
+ // ── helpers ──
313
+
314
+ const _box = new THREE.Box3(), _v = new THREE.Vector3(), _sphere = new THREE.Sphere();
315
+
316
+ function partsOf(built: readonly ModelPart[] | THREE.Object3D, id: string, draw: Draw): readonly ModelPart[] {
317
+ if (Array.isArray(built)) return built as readonly ModelPart[];
318
+ throw new Error(`place: '${id}' builds a whole object, which only draw: 'single' can place (asked for '${draw}')`);
319
+ }
320
+
321
+ function meshOf(part: ModelPart, geometry: THREE.BufferGeometry = part.geometry): THREE.Mesh {
322
+ const m = new THREE.Mesh(geometry, part.material);
323
+ m.castShadow = part.castShadow ?? false;
324
+ m.receiveShadow = part.receiveShadow ?? false;
325
+ if (part.customDepthMaterial) m.customDepthMaterial = part.customDepthMaterial;
326
+ if (part.renderOrder !== undefined) m.renderOrder = part.renderOrder;
327
+ return m;
328
+ }
329
+
330
+ /** a part as a one-copy InstancedMesh at its own origin (the instanced program variant the world draws it with) */
331
+ function instanceOf(part: ModelPart): THREE.InstancedMesh {
332
+ const im = new THREE.InstancedMesh(part.geometry, part.material, 1);
333
+ im.castShadow = part.castShadow ?? false;
334
+ im.receiveShadow = part.receiveShadow ?? false;
335
+ if (part.customDepthMaterial) im.customDepthMaterial = part.customDepthMaterial;
336
+ if (part.renderOrder !== undefined) im.renderOrder = part.renderOrder;
337
+ return im;
338
+ }
339
+
340
+ /** the one object when there is one, else a group of them */
341
+ function wrap(objects: readonly THREE.Object3D[], name: string): THREE.Object3D {
342
+ const only = objects.length === 1 ? objects[0] : undefined;
343
+ if (only !== undefined) { only.name ||= name; return only; }
344
+ const g = new THREE.Group();
345
+ g.name = name;
346
+ if (objects.length > 0) g.add(...objects);
347
+ return g;
348
+ }
349
+
350
+ /** a box of the parts' own-space geometry (union) */
351
+ function ownBox(parts: readonly ModelPart[], target: THREE.Box3): THREE.Box3 {
352
+ target.makeEmpty();
353
+ for (const p of parts) { if (p.geometry.boundingBox === null) p.geometry.computeBoundingBox(); if (p.geometry.boundingBox) target.union(p.geometry.boundingBox); }
354
+ return target;
355
+ }
356
+
357
+ function writeBox(boxes: Float32Array, i: number, b: THREE.Box3): void {
358
+ boxes.set([b.min.x, b.min.y, b.min.z, b.max.x, b.max.y, b.max.z], i * 6);
359
+ }
360
+
361
+ /** world box of posed geometry (a merged copy, before the merge) */
362
+ function geometryBox(geos: readonly THREE.BufferGeometry[], target: THREE.Box3): THREE.Box3 {
363
+ target.makeEmpty();
364
+ for (const g of geos) {
365
+ const p = g.getAttribute('position');
366
+ for (let i = 0; i < p.count; i++) target.expandByPoint(_v.set(p.getX(i), p.getY(i), p.getZ(i)));
367
+ }
368
+ return target;
369
+ }
370
+
371
+ /** the parts' own bounding sphere (their union) */
372
+ function ownSphere(parts: readonly ModelPart[], target: THREE.Sphere): THREE.Sphere {
373
+ target.makeEmpty();
374
+ for (const p of parts) { if (p.geometry.boundingSphere === null) p.geometry.computeBoundingSphere(); if (p.geometry.boundingSphere) target.union(p.geometry.boundingSphere); }
375
+ return target;
376
+ }
377
+
378
+ /** `cull.bounds: 'sphere'`: each copy's parts' own bounding sphere, posed (x, y, z, r per copy) */
379
+ function posedSpheres(copyParts: (i: number) => readonly ModelPart[], poses: readonly Pose[]): Float32Array {
380
+ const out = new Float32Array(poses.length * 4);
381
+ poses.forEach((pose, i) => {
382
+ ownSphere(copyParts(i), _sphere);
383
+ _v.copy(_sphere.center).applyMatrix4(pose.matrix);
384
+ out.set([_v.x, _v.y, _v.z, _sphere.radius * pose.scale], i * 4);
385
+ });
386
+ return out;
387
+ }
388
+
389
+ /** `cull.from: 'origin'`: each copy's placement point (x, y, z per copy, float64: exact); null: the bounds' centres */
390
+ function originsOf(pls: readonly Placement<object>[], o: PlaceOptions): Float64Array | null {
391
+ if (o.cull?.from !== 'origin') return null;
392
+ const out = new Float64Array(pls.length * 3);
393
+ pls.forEach((pl, i) => { out.set([pl.x, pl.y, pl.z], i * 3); });
394
+ return out;
395
+ }
396
+
397
+ /** each copy's placement point (x, y, z per copy), float32 (`cull.cells` buckets by it) */
398
+ function pointsOf(pls: readonly Placement<object>[]): Float32Array {
399
+ const out = new Float32Array(pls.length * 3);
400
+ pls.forEach((pl, i) => { out[i * 3] = pl.x; out[i * 3 + 1] = pl.y; out[i * 3 + 2] = pl.z; });
401
+ return out;
402
+ }
403
+
404
+ /** spheres (x, y, z, r per copy) around the world boxes: what the cullers test */
405
+ function spheresOf(boxes: Float32Array): Float32Array {
406
+ const n = boxes.length / 6, out = new Float32Array(n * 4);
407
+ for (let i = 0; i < n; i++) {
408
+ _box.min.set(boxes[i * 6] ?? 0, boxes[i * 6 + 1] ?? 0, boxes[i * 6 + 2] ?? 0);
409
+ _box.max.set(boxes[i * 6 + 3] ?? 0, boxes[i * 6 + 4] ?? 0, boxes[i * 6 + 5] ?? 0);
410
+ _box.getBoundingSphere(_sphere);
411
+ out.set([_sphere.center.x, _sphere.center.y, _sphere.center.z, _sphere.radius], i * 4);
412
+ }
413
+ return out;
414
+ }
415
+
416
+ /** a copy's colliders: the model's own-space ones at its pose (`drawn-hull` from what it draws) */
417
+ function collideCopy<P extends object>(def: ModelDef<P>, params: P, pose: Pose, world: readonly THREE.BufferGeometry[] | null, own: readonly THREE.BufferGeometry[], out: ColliderDesc[], ctx: ModelContext): void {
418
+ for (const spec of def.colliders?.(params, ctx) ?? []) {
419
+ if (spec.kind === 'drawn-hull') {
420
+ const h = world ? drawnHullWorld(world, pose) : drawnHullOwn(own, pose);
421
+ out.push(spec.surface === undefined ? h : { ...h, surface: spec.surface });
422
+ } else out.push(placeCollider(spec, pose));
423
+ }
424
+ }
425
+
426
+ /** level start distances: 0 for the model's own parts, then each LOD's `from` */
427
+ const levelsOf = <P extends object>(def: ModelDef<P>): number[] => [0, ...(def.lods ?? []).map((l) => l.from)];
428
+ /** each level's dissolve band before its start (`ModelLod.fade`; level 0 has none) */
429
+ const fadesOf = <P extends object>(def: ModelDef<P>): number[] => [0, ...(def.lods ?? []).map((l) => l.fade ?? 0)];
430
+
431
+ /** A callback belongs to one place call, so nested builders cannot mix their copies. */
432
+ type BuildOptions<P extends object> = PlaceOptions & { readonly visitBuild?: (build: ModelBuildVisit<P>) => void };
433
+
434
+ function buildModel<P extends object>(def: ModelDef<P>, o: BuildOptions<P>, params: P, rng: Rng, placements: readonly Placement<P>[], level = 0): ModelBuild {
435
+ const lod = def.lods?.[level - 1];
436
+ if (level !== 0 && lod === undefined) throw new Error(`place: '${def.id}' has no level ${level}`);
437
+ const built = lod === undefined ? def.build(o.ctx, params, rng) : lod.build(o.ctx, params, rng);
438
+ o.visitBuild?.({ kind: 'model', built, params, placements, level });
439
+ return built;
440
+ }
441
+
442
+ /** the parts of every level for one set of params (each LOD level draws from its own rng stream, never the copies') */
443
+ function levelParts<P extends object>(def: ModelDef<P>, o: BuildOptions<P>, params: P, rng: Rng, placements: readonly Placement<P>[]): (readonly ModelPart[])[] {
444
+ return runSteps(levelPartsSteps(def, o, params, rng, placements));
445
+ }
446
+
447
+ /** `levelParts`, pausing (`yield`) after every level built (op-hitch29: a sculpt's level and each of its LODs, a
448
+ * meshoptimizer copy, are separate tasks under `placeSliced`) */
449
+ function* levelPartsSteps<P extends object>(def: ModelDef<P>, o: BuildOptions<P>, params: P, rng: Rng, placements: readonly Placement<P>[]): Generator<void, (readonly ModelPart[])[]> {
450
+ const out: (readonly ModelPart[])[] = [partsOf(buildModel(def, o, params, rng, placements), def.id, o.draw)];
451
+ const lods = def.lods ?? [];
452
+ for (let l = 0; l < lods.length; l++) {
453
+ yield;
454
+ out.push(partsOf(buildModel(def, o, params, new Rng(seedOf(def) ^ Math.imul(l + 1, 0x9e3779b9)), placements, l + 1), def.id, o.draw));
455
+ }
456
+ return out;
457
+ }
458
+
459
+ /** every variant's level parts (`levelParts` per variant key, in key order), pausing after each level of each variant */
460
+ function* variantPartsSteps<P extends object>(def: ModelDef<P>, o: BuildOptions<P>, pls: readonly Placement<P>[], keys: readonly (string | undefined)[]): Generator<void, (readonly ModelPart[])[][]> {
461
+ const built: (readonly ModelPart[])[][] = [];
462
+ for (const k of keys) {
463
+ built.push(yield* levelPartsSteps(def, o, paramsOf(def, k, undefined), new Rng(seedOf(def)), o.visitBuild === undefined ? pls : pls.filter((pl) => pl.variant === k)));
464
+ yield;
465
+ }
466
+ return built;
467
+ }
468
+
469
+ // ── merged: every copy welded into one mesh per material (per cell, per LOD level) ──
470
+
471
+ /** Run a step generator to its end in this task. */
472
+ function runSteps<T>(steps: Generator<void, T>): T {
473
+ for (;;) { const r = steps.next(); if (r.done === true) return r.value; }
474
+ }
475
+
476
+ /** `mergedTint`: a merged copy's tint times its vertex colours (rgb; a geometry with none is left untinted) */
477
+ const copyTint = new THREE.Color();
478
+ function tintCopy(g: THREE.BufferGeometry, given: THREE.ColorRepresentation | undefined): void {
479
+ const colours = g.getAttribute('color');
480
+ if (given === undefined || colours === undefined || colours.itemSize < 3) return;
481
+ const color = copyTint.set(given);
482
+ if (color.r === 1 && color.g === 1 && color.b === 1) return;
483
+ for (let i = 0; i < colours.count; i++) colours.setXYZ(i, colours.getX(i) * color.r, colours.getY(i) * color.g, colours.getZ(i) * color.b);
484
+ colours.needsUpdate = true;
485
+ }
486
+
487
+ /** The merged draw, pausing (`yield`) after every copy built and every merged mesh (SF67: `placeSliced`). */
488
+ function* drawMergedSteps<P extends object>(def: ModelDef<P>, pls: readonly Placement<P>[], poses: readonly Pose[], params: readonly P[], o: BuildOptions<P>): Generator<void, Drawn> {
489
+ const rng = new Rng(seedOf(def));
490
+ const lodRngs = (def.lods ?? []).map((_, l) => new Rng(seedOf(def) ^ Math.imul(l + 1, 0x9e3779b9)));
491
+ const levels = levelsOf(def).length;
492
+ const colliders: ColliderDesc[] = [];
493
+ const boxes = new Float32Array(pls.length * 6);
494
+ /** cell key → per level → material → { part (flags), geometries } */
495
+ const cells = new Map<string, { centre: THREE.Vector3; n: number; levels: Map<THREE.Material, { part: ModelPart; geos: THREE.BufferGeometry[] }>[] }>();
496
+ const cellOf = (pl: Placement<P>): string => (o.cell === undefined ? '' : `${Math.floor(pl.x / o.cell)},${Math.floor(pl.z / o.cell)}`);
497
+ // a merged copy's geometry is posed in place: one a builder hands out twice (a shared GLB) is copied first
498
+ const seen = new WeakSet<THREE.BufferGeometry>();
499
+ const own = (g: THREE.BufferGeometry): THREE.BufferGeometry => { if (seen.has(g)) return g.clone(); seen.add(g); return g; };
500
+ for (const [i, pl] of pls.entries()) {
501
+ const pose = poses[i], p = params[i];
502
+ if (pose === undefined || p === undefined) continue;
503
+ const parts = partsOf(buildModel(def, o, p, rng, [pl]), def.id, 'merged');
504
+ const posed = parts.map((part) => { const g = own(part.geometry); poseGeometry(g, pl); if (o.mergedTint === true) tintCopy(g, pl.color); return g; });
505
+ collideCopy(def, p, pose, posed, posed, colliders, o.ctx);
506
+ writeBox(boxes, i, geometryBox(posed, _box));
507
+ const key = cellOf(pl);
508
+ let cell = cells.get(key);
509
+ if (!cell) { cell = { centre: new THREE.Vector3(), n: 0, levels: Array.from({ length: levels }, () => new Map<THREE.Material, { part: ModelPart; geos: THREE.BufferGeometry[] }>()) }; cells.set(key, cell); }
510
+ cell.centre.add(_v.set(pl.x, pl.y, pl.z)); cell.n++;
511
+ const here = cell;
512
+ const add = (l: number, list: readonly ModelPart[], geos: readonly THREE.BufferGeometry[]): void => {
513
+ const byMat = here.levels[l];
514
+ if (!byMat) return;
515
+ list.forEach((part, k) => {
516
+ const g = geos[k];
517
+ if (!g) return;
518
+ const slot = byMat.get(part.material);
519
+ if (slot) slot.geos.push(g); else byMat.set(part.material, { part, geos: [g] });
520
+ });
521
+ };
522
+ add(0, parts, posed);
523
+ (def.lods ?? []).forEach((_, l) => {
524
+ const lr = lodRngs[l];
525
+ if (!lr) return;
526
+ const lp = partsOf(buildModel(def, o, p, lr, [pl], l + 1), def.id, o.draw);
527
+ add(l + 1, lp, lp.map((part) => { const g = own(part.geometry); poseGeometry(g, pl); return g; }));
528
+ });
529
+ yield;
530
+ }
531
+ const objects: THREE.Object3D[] = [];
532
+ const cellLevels: (THREE.Object3D | null)[][] = [];
533
+ const centres: number[] = [];
534
+ let drawnMeshes = 0;
535
+ for (const cell of cells.values()) {
536
+ const perLevel: THREE.Mesh[][] = [];
537
+ for (const byMat of cell.levels) {
538
+ const meshes: THREE.Mesh[] = [];
539
+ for (const { part, geos } of byMat.values()) {
540
+ const geo = mergeGeometries(geos, false);
541
+ yield* geometryBoundsSteps(geo, 'sphere');
542
+ const mesh = meshOf(part, geo);
543
+ mesh.name = def.id;
544
+ if (o.shadowWhole === true) keepShadowWhole(mesh);
545
+ meshes.push(mesh);
546
+ yield;
547
+ }
548
+ drawnMeshes += meshes.length;
549
+ perLevel.push(meshes);
550
+ }
551
+ if (levels === 1) { objects.push(...(perLevel[0] ?? [])); continue; }
552
+ const holder = new THREE.Group();
553
+ holder.name = `${def.id}:cell`;
554
+ const lvls = perLevel.map((meshes, l) => (meshes.length === 0 ? null : wrap(meshes, `${def.id}:lod${l}`)));
555
+ for (const lvl of lvls) if (lvl) holder.add(lvl);
556
+ objects.push(holder);
557
+ cellLevels.push(lvls);
558
+ centres.push(cell.centre.x / cell.n, cell.centre.y / cell.n, cell.centre.z / cell.n);
559
+ }
560
+ if (drawnMeshes === 0) console.warn(`[models] ${def.id}: nothing placed — %d placements`, pls.length);
561
+ let cull: ((camera: THREE.Camera) => void) | null = null, cullWith: Drawn['cullWith'] = null;
562
+ if (levels > 1 || o.cull?.far !== undefined) {
563
+ const c = new CellCull(cellLevels, Float32Array.from(centres), levelsOf(def), o.cull ?? {});
564
+ cull = (camera) => { c.update(camera); }; cullWith = (f, e) => { c.updateWith(f, e); };
565
+ }
566
+ return { object: wrap(objects, def.id), drawnAs: 'merged', colliders, boxes, cull, cullWith };
567
+ }
568
+
569
+ // ── instanced: one InstancedMesh per part, per variant, per LOD level ──
570
+
571
+ function variantKeys<P extends object>(pls: readonly Placement<P>[]): { keys: (string | undefined)[]; of: Uint16Array } {
572
+ const keys: (string | undefined)[] = [], of = new Uint16Array(pls.length);
573
+ pls.forEach((pl, i) => {
574
+ let k = keys.indexOf(pl.variant);
575
+ if (k === -1) { k = keys.length; keys.push(pl.variant); }
576
+ of[i] = k;
577
+ });
578
+ return { keys, of };
579
+ }
580
+
581
+ function drawInstanced<P extends object>(def: ModelDef<P>, pls: readonly Placement<P>[], poses: readonly Pose[], params: readonly P[], o: BuildOptions<P>): Drawn {
582
+ return runSteps(drawInstancedSteps(def, pls, poses, params, o));
583
+ }
584
+
585
+ /** The local box over the copies `indices` (their boxes, `writeBox`): a culled level's envelope (`setInstanceEnvelope`). */
586
+ const _envelopeMin = new THREE.Vector3(), _envelopeMax = new THREE.Vector3(), _envelopeCopy = new THREE.Box3();
587
+ function envelopeOf(boxes: Float32Array, indices: Iterable<number>): THREE.Box3 {
588
+ const box = new THREE.Box3();
589
+ for (const i of indices) box.union(_envelopeCopy.set(_envelopeMin.fromArray(boxes, i * 6), _envelopeMax.fromArray(boxes, i * 6 + 3)));
590
+ return box;
591
+ }
592
+
593
+ /** The instanced draw, pausing (`yield`) after every variant level built and every copy's colliders (op-hitch29: `placeSliced`). */
594
+ function* drawInstancedSteps<P extends object>(def: ModelDef<P>, pls: readonly Placement<P>[], poses: readonly Pose[], params: readonly P[], o: BuildOptions<P>,
595
+ prebuilt?: (readonly ModelPart[])[][]): Generator<void, Drawn> {
596
+ const { keys, of } = variantKeys(pls);
597
+ const levels = levelsOf(def).length, n = pls.length;
598
+ // 'set': every copy written once per level, the levels shown / hidden whole (SetCull); else per copy when anything culls
599
+ const setMode = o.cull?.lodBy === 'set';
600
+ const culls = !setMode && (o.cull !== undefined || levels > 1);
601
+ const colliders: ColliderDesc[] = [];
602
+ const boxes = new Float32Array(n * 6);
603
+ const matrices = new Float32Array(n * 16);
604
+ const tinted = pls.some((pl) => pl.color !== undefined);
605
+ const colors = tinted ? new Float32Array(n * 3) : null;
606
+ const tint = new THREE.Color();
607
+ // every variant's parts, built once (instanced copies share their variant's shape)
608
+ const built = prebuilt ?? (yield* variantPartsSteps(def, o, pls, keys));
609
+ const perVariant = keys.map((_, v) => of.reduce((c, x) => c + (x === v ? 1 : 0), 0));
610
+ for (const [i, pl] of pls.entries()) {
611
+ const pose = poses[i], p = params[i], parts = built[of[i] ?? 0]?.[0] ?? [];
612
+ if (pose === undefined || p === undefined) continue;
613
+ pose.matrix.toArray(matrices, i * 16);
614
+ if (colors) { tint.set(pl.color ?? 0xffffff); colors.set([tint.r, tint.g, tint.b], i * 3); }
615
+ writeBox(boxes, i, ownBox(parts, _box).applyMatrix4(pose.matrix));
616
+ collideCopy(def, p, pose, null, parts.map((x) => x.geometry), colliders, o.ctx);
617
+ yield;
618
+ }
619
+ const objects: THREE.Object3D[] = [];
620
+ const byLevel: THREE.Object3D[][] = Array.from({ length: levels }, () => []);
621
+ // per-copy culled (InstancedCull): a level whose parts are another variant's very geometries and materials draws in that
622
+ // variant's buffers at its own scale (ModelPart.scale), one draw a level for the variants sharing a shape
623
+ const sharing = culls && o.cull?.cells === undefined;
624
+ const ids = new WeakMap<object, number>(); let nextId = 0;
625
+ const idOf = (x: object | undefined): number => {
626
+ if (x === undefined) return -1;
627
+ let k = ids.get(x); if (k === undefined) { k = nextId++; ids.set(x, k); }
628
+ return k;
629
+ };
630
+ const keyOf = (v: number, l: number, parts: readonly ModelPart[]): string => sharing && parts.length > 0
631
+ ? `${String(l)}|${parts.map((part) => [idOf(part.geometry), idOf(part.material), idOf(part.customDepthMaterial), part.until ?? '', String(part.tint ?? ''),
632
+ String(part.castShadow ?? ''), String(part.receiveShadow ?? ''), part.renderOrder ?? ''].join(':')).join(',')}`
633
+ : `${String(v)}|${String(l)}`;
634
+ const scales = new Float32Array(built.length * levels).fill(1), keyAt: string[] = [];
635
+ /** each draw group, first seen in variant order: the variant and level whose parts it draws, its capacity and copies */
636
+ const plan = new Map<string, { v: number; l: number; cap: number; copies: number[] }>();
637
+ for (const [v, lvls] of built.entries()) for (let l = 0; l < levels; l++) {
638
+ const parts = lvls[l] ?? [], scale = parts[0]?.scale ?? 1;
639
+ if (parts.some((part) => (part.scale ?? 1) !== scale)) throw new Error(`[models] ${def.id}: a level's parts scale alike`);
640
+ if (scale !== 1 && !sharing) throw new Error(`[models] ${def.id}: a scaled level needs per-copy culled instancing`);
641
+ scales[v * levels + l] = scale;
642
+ const key = keyOf(v, l, parts); keyAt.push(key);
643
+ let entry = plan.get(key);
644
+ if (entry === undefined) { entry = { v, l, cap: 0, copies: [] }; plan.set(key, entry); }
645
+ entry.cap += perVariant[v] ?? 0;
646
+ for (const [i, x] of of.entries()) if (x === v) entry.copies.push(i);
647
+ }
648
+ const made = new Map<string, InstancedSink[]>();
649
+ for (const [key, { v, l, cap, copies }] of plan) {
650
+ const parts = built[v]?.[l] ?? [], group: InstancedSink[] = [];
651
+ made.set(key, group);
652
+ if (parts.length === 0 || cap === 0) continue;
653
+ for (const until of new Set(parts.map((part) => part.until))) {
654
+ const mine = parts.filter((part) => part.until === until);
655
+ const matrix = new THREE.InstancedBufferAttribute(new Float32Array(cap * 16), 16);
656
+ // a part with `tint: false` draws without the copies' colours (it shares their matrices)
657
+ const color = colors && mine.some((part) => part.tint !== false) ? new THREE.InstancedBufferAttribute(new Float32Array(cap * 3), 3) : null;
658
+ if (culls) { matrix.setUsage(THREE.DynamicDrawUsage); color?.setUsage(THREE.DynamicDrawUsage); }
659
+ const meshes = mine.map((part) => {
660
+ const im = new THREE.InstancedMesh(part.geometry, part.material, cap);
661
+ im.instanceMatrix = matrix;
662
+ if (color && part.tint !== false) im.instanceColor = color;
663
+ im.castShadow = part.castShadow ?? false; im.receiveShadow = part.receiveShadow ?? false;
664
+ if (part.customDepthMaterial) im.customDepthMaterial = part.customDepthMaterial;
665
+ if (part.renderOrder !== undefined) im.renderOrder = part.renderOrder;
666
+ im.name = `${def.id}:${keys[v] ?? 'base'}:${l}`;
667
+ return im;
668
+ });
669
+ byLevel[l]?.push(...meshes);
670
+ if (!culls) {
671
+ // every copy of this variant, written once; three culls the set as a whole (as a hand-rolled InstancedMesh)
672
+ let c = 0;
673
+ for (let i = 0; i < n; i++) {
674
+ if (of[i] !== v) continue;
675
+ (matrix.array as Float32Array).set(matrices.subarray(i * 16, i * 16 + 16), c * 16);
676
+ if (color && colors) (color.array as Float32Array).set(colors.subarray(i * 3, i * 3 + 3), c * 3);
677
+ c++;
678
+ }
679
+ for (const im of meshes) { im.count = c; im.computeBoundingSphere(); }
680
+ } else {
681
+ const envelope = envelopeOf(boxes, copies);
682
+ for (const im of meshes) { im.count = 0; im.visible = false; im.frustumCulled = false; cullCopiesPerCascade(im); setInstanceEnvelope(im, envelope); }
683
+ }
684
+ objects.push(...meshes);
685
+ group.push({ matrix, color, meshes, ...(until === undefined ? {} : { until }) });
686
+ yield;
687
+ }
688
+ }
689
+ /** `groups[v * levels + l]`: variant v's level l's instance buffers — its parts share one; a part with an `until` has its own;
690
+ * variants sharing a level's shape share the same buffers */
691
+ const groups = keyAt.map((key) => made.get(key) ?? []);
692
+ let cull: ((camera: THREE.Camera) => void) | null = null, cullWith: Drawn['cullWith'] = null;
693
+ const bounds = (): Float32Array => (o.cull?.bounds === 'sphere' ? posedSpheres((i) => built[of[i] ?? 0]?.[0] ?? [], poses) : spheresOf(boxes));
694
+ const cells = o.cull?.cells;
695
+ if (setMode) {
696
+ const c = new SetCull(byLevel, n, bounds(), levelsOf(def), o.cull ?? {}, originsOf(pls, o));
697
+ cull = (camera) => { c.update(camera); }; cullWith = (f, e) => { c.updateWith(f, e); };
698
+ } else if (culls && cells !== undefined) {
699
+ const c = new CelledCopiesCull(groups, levels, of, matrices, colors, pointsOf(pls), levelsOf(def), { ...o.cull, cells });
700
+ cull = (camera) => { c.update(camera); }; cullWith = (f, e) => { c.updateWith(f, e); };
701
+ } else if (culls) {
702
+ // `casters`: each choice reads the casting cascades' frusta (a cascade's getFrustum rebuilds its footprint: once a choice)
703
+ const casting = o.cull?.casters === undefined ? undefined : (): THREE.Frustum[] => o.ctx.sky.csm.lights.filter((l) => l.castShadow).map((l) => l.shadow.getFrustum());
704
+ const c = new InstancedCull(groups, levels, of, matrices, colors, bounds(), levelsOf(def), o.cull ?? {}, originsOf(pls, o), fadesOf(def), casting,
705
+ scales.some((k) => k !== 1) ? scales : null);
706
+ cull = (camera) => { c.update(camera); }; cullWith = (f, e) => { c.updateWith(f, e); };
707
+ }
708
+ return { object: wrap(objects, def.id), drawnAs: 'instanced', colliders, boxes, cull, cullWith };
709
+ }
710
+
711
+ // ── instanced, culled by the shard (`PlaceOptions.culler`): per part, level 0 with every copy, each LOD its own mesh ──
712
+
713
+ /** The shard-culled instanced draw, pausing (`yield`) after every variant level built, every copy's colliders and every
714
+ * part handed to the culler (op-hitch29: `placeSliced`). */
715
+ function* drawHandedSteps<P extends object>(def: ModelDef<P>, pls: readonly Placement<P>[], poses: readonly Pose[], params: readonly P[], o: BuildOptions<P>, culler: InstancedCuller): Generator<void, Drawn> {
716
+ const { keys, of } = variantKeys(pls);
717
+ const from = levelsOf(def), n = pls.length;
718
+ const colliders: ColliderDesc[] = [];
719
+ const boxes = new Float32Array(n * 6);
720
+ const tinted = pls.some((pl) => pl.color !== undefined);
721
+ const tint = new THREE.Color();
722
+ const built = yield* variantPartsSteps(def, o, pls, keys);
723
+ for (const [i, pose] of poses.entries()) {
724
+ const p = params[i], parts = built[of[i] ?? 0]?.[0] ?? [];
725
+ if (p === undefined) continue;
726
+ writeBox(boxes, i, ownBox(parts, _box).applyMatrix4(pose.matrix));
727
+ collideCopy(def, p, pose, null, parts.map((x) => x.geometry), colliders, o.ctx);
728
+ yield;
729
+ }
730
+ const objects: THREE.Object3D[] = [];
731
+ const cull = o.cull ?? {};
732
+ for (const [v, lvls] of built.entries()) {
733
+ const mine: number[] = [];
734
+ for (let i = 0; i < n; i++) if (of[i] === v) mine.push(i);
735
+ const at = mine.map((i) => poses[i]?.matrix ?? new THREE.Matrix4()), envelope = envelopeOf(boxes, mine);
736
+ for (let k = 0; k < (lvls[0] ?? []).length; k++) {
737
+ const levels = lvls.map((parts, l) => {
738
+ const part = parts[k];
739
+ if (part === undefined || mine.length === 0) return { mesh: null, from: from[l] ?? 0 };
740
+ const im = new THREE.InstancedMesh(part.geometry, part.material, mine.length);
741
+ im.castShadow = part.castShadow ?? false; im.receiveShadow = part.receiveShadow ?? false;
742
+ if (part.customDepthMaterial) im.customDepthMaterial = part.customDepthMaterial;
743
+ if (part.renderOrder !== undefined) im.renderOrder = part.renderOrder;
744
+ im.name = `${def.id}:${keys[v] ?? 'base'}:${l}`;
745
+ setInstanceEnvelope(im, envelope);
746
+ if (l === 0) {
747
+ at.forEach((m, j) => { im.setMatrixAt(j, m); });
748
+ if (tinted) mine.forEach((i, j) => { im.setColorAt(j, tint.set(pls[i]?.color ?? 0xffffff)); });
749
+ im.computeBoundingSphere();
750
+ } else {
751
+ if (tinted) im.instanceColor = new THREE.InstancedBufferAttribute(new Float32Array(mine.length * 3), 3);
752
+ im.count = 0; im.visible = false;
753
+ }
754
+ objects.push(im);
755
+ return { mesh: im, from: from[l] ?? 0 };
756
+ });
757
+ culler.take({ levels, poses: at, cull });
758
+ yield;
759
+ }
760
+ }
761
+ return { object: wrap(objects, def.id), drawnAs: 'instanced', colliders, boxes, cull: null };
762
+ }
763
+
764
+ // ── batched: one BatchedMesh per material (WEBGL_multi_draw; never facade geometry — E271 / E272) ──
765
+
766
+ /** PF13: a graph batch holding a group that casts and a group that does not (a tree's near and far bark): its shadow
767
+ * draw leaves the non-casting group's copies out, so the shadow map is the one the casting group's own batch drew */
768
+ class CastSplitBatchedMesh extends ChangedBatchedMesh {
769
+ private readonly uncast: number[] = [];
770
+ private readonly held: number[] = [];
771
+ leaveOutOfShadows(instance: number): void { this.uncast.push(instance); }
772
+ override onBeforeShadow(...args: Parameters<ChangedBatchedMesh['onBeforeShadow']>): void {
773
+ const held = this.held;
774
+ held.length = 0;
775
+ for (const id of this.uncast) if (this.getVisibleAt(id)) { this.setVisibleAt(id, false); held.push(id); }
776
+ try { super.onBeforeShadow(...args); } finally { for (const id of held) this.setVisibleAt(id, true); }
777
+ }
778
+ }
779
+
780
+ function drawBatched<P extends object>(def: ModelDef<P>, pls: readonly Placement<P>[], poses: readonly Pose[], params: readonly P[], o: BuildOptions<P>): Drawn {
781
+ const renderer = o.ctx.renderer;
782
+ if (o.batch === undefined && (renderer === null || !renderer.extensions.has('WEBGL_multi_draw'))) return drawInstanced(def, pls, poses, params, o);
783
+ const { keys, of } = variantKeys(pls);
784
+ const levels = levelsOf(def).length, n = pls.length;
785
+ const built = keys.map((k) => levelParts(def, o, paramsOf(def, k, undefined), new Rng(seedOf(def)), o.visitBuild === undefined ? pls : pls.filter((pl) => pl.variant === k)));
786
+ // one batch per material: every (variant, level) part with that material is one of its geometries. A graph look's batch
787
+ // also keeps its parts' draw flags apart (PF1: a tree's far level shares the near level's bark and needles but casts no
788
+ // shadow on the phone; one batch per material cast every far tree's shadow, as instancing per part never did); a
789
+ // classic look's batches are as they were. A graph on the GLSL back-end (a classic ShaderMaterial) keys the same way:
790
+ // as one batch per material it cast every far tree's shadow again (PF3, Pine's mill: 54 shadow trees, TSL 17)
791
+ interface Group { part: ModelPart; geos: { v: number; l: number; g: THREE.BufferGeometry; until: number | undefined }[] }
792
+ const byMat = new Map<THREE.Material | string, Group>();
793
+ const flagged = (material: THREE.Material): boolean => Reflect.get(material, 'isGraphShaderMaterial') === true;
794
+ const batchKey = (part: ModelPart): THREE.Material | string => !flagged(part.material) ? part.material
795
+ : `${part.material.uuid}|${String(part.castShadow ?? false)}|${String(part.receiveShadow ?? false)}|${String(part.tint !== false)}|${part.customDepthMaterial?.uuid ?? ''}`;
796
+ // a part's `scale` (a level drawn at another variant's shape, model.ts) is per-copy instancing's; a batch takes the
797
+ // geometry already scaled about the copy's origin (PF1: the forest's far trees drew at their species' first height)
798
+ const scaledParts = new Map<THREE.BufferGeometry, Map<number, THREE.BufferGeometry>>();
799
+ const geometryOf = (part: ModelPart): THREE.BufferGeometry => {
800
+ const s = part.scale ?? 1;
801
+ if (s === 1) return part.geometry;
802
+ let bySize = scaledParts.get(part.geometry);
803
+ if (bySize === undefined) { bySize = new Map(); scaledParts.set(part.geometry, bySize); }
804
+ let g = bySize.get(s);
805
+ if (g === undefined) { g = part.geometry.clone().scale(s, s, s); bySize.set(s, g); }
806
+ return g;
807
+ };
808
+ built.forEach((lvls, v) => { lvls.forEach((parts, l) => { for (const part of parts) {
809
+ const key = batchKey(part), e = byMat.get(key), x = { v, l, g: geometryOf(part), until: part.until };
810
+ if (e) e.geos.push(x); else byMat.set(key, { part, geos: [x] });
811
+ } }); });
812
+ const count = (g: THREE.BufferGeometry): number => g.getAttribute('position').count;
813
+ const shared = o.batch;
814
+ // PF13: a graph look's groups that differ only in castShadow (a tree's near and far bark) share one BatchedMesh, one
815
+ // draw in the view as legacy's forest. Each group keeps its own geometries and its own copy of every tree (a dissolve
816
+ // band still draws both levels), and the shadow pass leaves the non-casting group's copies out (CastSplitBatchedMesh)
817
+ const meshKey = (part: ModelPart): THREE.Material | string => !flagged(part.material) ? part.material
818
+ : `${part.material.uuid}|${String(part.receiveShadow ?? false)}|${String(part.tint !== false)}|${part.customDepthMaterial?.uuid ?? ''}`;
819
+ const meshes = new Map<THREE.Material | string, Group[]>();
820
+ for (const group of byMat.values()) { const key = meshKey(group.part), known = meshes.get(key); if (known) known.push(group); else meshes.set(key, [group]); }
821
+ const casts = (part: ModelPart): boolean => part.castShadow ?? false;
822
+ const batches = [...meshes.values()].flatMap((groups) => {
823
+ const part = groups[0]?.part;
824
+ if (part === undefined) return [];
825
+ const all = groups.flatMap((group) => group.geos);
826
+ const verts = all.reduce((s, x) => s + count(x.g), 0), idx = all.reduce((s, x) => s + (x.g.index?.count ?? 0), 0);
827
+ const own = shared === undefined || shared.material !== part.material;
828
+ const split = own && groups.some((group) => casts(group.part)) && groups.some((group) => !casts(group.part));
829
+ const bm = !own ? shared : split ? new CastSplitBatchedMesh(n * groups.length, verts, idx, part.material) : new ChangedBatchedMesh(n * groups.length, verts, idx, part.material);
830
+ if (own) {
831
+ bm.castShadow = groups.some((group) => casts(group.part)); bm.receiveShadow = part.receiveShadow ?? false;
832
+ if (part.customDepthMaterial) bm.customDepthMaterial = part.customDepthMaterial;
833
+ bm.perObjectFrustumCulled = true;
834
+ const sort = part.sortObjects ?? o.sortObjects;
835
+ if (sort !== undefined) bm.sortObjects = sort;
836
+ bm.name = `${def.id}:batch`;
837
+ }
838
+ return groups.map(({ part: member, geos }) => {
839
+ /** geometry id per (variant, level) */
840
+ const ids = new Int32Array(keys.length * levels).fill(-1);
841
+ /** a part's `until`, squared, per (variant, level) (∞: none) */
842
+ const until2 = new Float64Array(keys.length * levels).fill(Number.POSITIVE_INFINITY);
843
+ for (const x of geos) { ids[x.v * levels + x.l] = bm.addGeometry(x.g); if (x.until !== undefined) until2[x.v * levels + x.l] = x.until * x.until; }
844
+ // what each variant's copies draw per level, shared by its copies' slots
845
+ const perVariant = keys.map((_, v) => ({ geometry: ids.slice(v * levels, v * levels + levels), until2: geos.some((x) => x.v === v && x.until !== undefined) ? until2.slice(v * levels, v * levels + levels) : null }));
846
+ return { bm, perVariant, tint: member.tint !== false, uncast: split && bm instanceof CastSplitBatchedMesh && !casts(member) ? bm : null };
847
+ });
848
+ });
849
+ // each batch copied what it was given: the scaled copies go
850
+ for (const bySize of scaledParts.values()) for (const g of bySize.values()) g.dispose();
851
+ const colliders: ColliderDesc[] = [];
852
+ const boxes = new Float32Array(n * 6);
853
+ const slots: BatchedSlot[] = [];
854
+ const start = new Uint32Array(n + 1);
855
+ const tint = new THREE.Color();
856
+ // copies a handed-in view culls start hidden: the view chooses them before the game draws a frame (the forest's trees)
857
+ const hidden = o.cull?.view !== undefined;
858
+ pls.forEach((pl, i) => {
859
+ start[i] = slots.length;
860
+ const pose = poses[i], p = params[i], v = of[i] ?? 0, parts = built[v]?.[0] ?? [];
861
+ if (pose === undefined || p === undefined) return;
862
+ writeBox(boxes, i, ownBox(parts, _box).applyMatrix4(pose.matrix));
863
+ collideCopy(def, p, pose, null, parts.map((x) => x.geometry), colliders, o.ctx);
864
+ for (const b of batches) {
865
+ const at = b.perVariant[v];
866
+ const first = at?.geometry.find((g) => g >= 0);
867
+ if (at === undefined || first === undefined) continue;
868
+ const instance = b.bm.addInstance(first);
869
+ b.bm.setMatrixAt(instance, pose.matrix);
870
+ if (pl.color !== undefined && b.tint) b.bm.setColorAt(instance, tint.set(pl.color));
871
+ if (hidden || (at.geometry[0] ?? -1) < 0) b.bm.setVisibleAt(instance, false);
872
+ b.uncast?.leaveOutOfShadows(instance);
873
+ slots.push({ mesh: b.bm, instance, geometry: at.geometry, until2: at.until2 });
874
+ }
875
+ });
876
+ start[n] = slots.length;
877
+ let cull: ((camera: THREE.Camera) => void) | null = null, cullWith: Drawn['cullWith'] = null;
878
+ if (o.cull !== undefined || levels > 1) {
879
+ const bounds = o.cull?.bounds === 'sphere' ? posedSpheres((i) => built[of[i] ?? 0]?.[0] ?? [], poses) : spheresOf(boxes);
880
+ const c = new BatchedCull(slots, start, bounds, levelsOf(def), o.cull ?? {}, originsOf(pls, o), fadesOf(def));
881
+ cull = (camera) => { c.update(camera); }; cullWith = (f, e) => { c.updateWith(f, e); };
882
+ }
883
+ return { object: wrap([...new Set(batches.map((b) => b.bm))], def.id), drawnAs: 'batched', colliders, boxes, cull, cullWith };
884
+ }
885
+
886
+ // ── single: one object per copy (THREE.LOD when the model has LODs) ──
887
+
888
+ function drawSingle<P extends object>(def: ModelDef<P>, pls: readonly Placement<P>[], poses: readonly Pose[], params: readonly P[], o: BuildOptions<P>): Drawn {
889
+ const rng = new Rng(seedOf(def));
890
+ const colliders: ColliderDesc[] = [];
891
+ const boxes = new Float32Array(pls.length * 6);
892
+ const copies = poses.map((pose, i) => {
893
+ const p = params[i];
894
+ if (p === undefined) return new THREE.Group();
895
+ const built = buildModel(def, o, p, rng, pls.slice(i, i + 1));
896
+ const own: THREE.BufferGeometry[] = [];
897
+ let obj: THREE.Object3D;
898
+ if (Array.isArray(built)) {
899
+ const parts = built as readonly ModelPart[];
900
+ own.push(...parts.map((x) => x.geometry));
901
+ obj = wrap(parts.map((x) => meshOf(x)), def.id);
902
+ } else {
903
+ obj = built as THREE.Object3D;
904
+ obj.traverse((c) => { const m = c as Partial<THREE.Mesh>; if (m.isMesh === true && m.geometry) own.push(m.geometry); });
905
+ }
906
+ if ((def.lods ?? []).length > 0) {
907
+ const lod = new THREE.LOD();
908
+ lod.addLevel(obj, 0);
909
+ (def.lods ?? []).forEach((l, k) => {
910
+ const lp = partsOf(buildModel(def, o, p, new Rng(seedOf(def) ^ Math.imul(k + 1, 0x9e3779b9)), pls.slice(i, i + 1), k + 1), def.id, o.draw);
911
+ lod.addLevel(lp.length === 0 ? new THREE.Object3D() : wrap(lp.map((x) => meshOf(x)), `${def.id}:lod${k + 1}`), l.from);
912
+ });
913
+ obj = lod;
914
+ }
915
+ pose.matrix.decompose(obj.position, obj.quaternion, obj.scale);
916
+ obj.updateMatrixWorld(true);
917
+ writeBox(boxes, i, _box.setFromObject(obj));
918
+ collideCopy(def, p, pose, null, own, colliders, o.ctx);
919
+ return obj;
920
+ });
921
+ const skinned = copies.some((c) => c.getObjectsByProperty('isSkinnedMesh', true).length > 0);
922
+ // parts tagged `userData.until` (metres): drawn only while the camera is nearer to their copy (a building's detail set)
923
+ const parts: THREE.Object3D[] = [], until: number[] = [], copyOf: number[] = [];
924
+ copies.forEach((c, i) => { c.traverse((x) => { const u: unknown = x.userData['until']; if (typeof u === 'number') { parts.push(x); until.push(u); copyOf.push(i); } }); });
925
+ // a copy's LOD is chosen once a frame for the game camera (cullPlaced), never by three's autoUpdate: a pass that hides
926
+ // the opaque meshes and re-renders the scene (n8ao's transparency pre-passes) must not see a level shown again
927
+ const lods = copies.filter((c): c is THREE.LOD => c instanceof THREE.LOD);
928
+ for (const l of lods) l.autoUpdate = false;
929
+ let cull: ((camera: THREE.Camera) => void) | null = null;
930
+ if (parts.length > 0 || lods.length > 0) {
931
+ const c = parts.length > 0 ? new UntilCull(parts, Float32Array.from(until), Uint32Array.from(copyOf), Float32Array.from(poses.flatMap((p) => [p.x, p.y, p.z]))) : null;
932
+ cull = (camera, world = camera) => { c?.update(camera); for (const l of lods) l.update(world); };
933
+ }
934
+ return { object: wrap(copies, def.id), drawnAs: skinned ? 'skinned' : 'single', colliders, boxes, cull };
935
+ }
936
+
937
+ // ── welds: a merge across several models (E347, ./weld.ts) ──
938
+
939
+ export interface WeldOptions {
940
+ /**
941
+ * 'copy': each copy its own unit — its parts merged under its root and banded by its distance, then the meshes drawn at
942
+ * every distance welded across the copies (one per material, a view per copy). 'whole': every copy's parts merged into
943
+ * one set under `root`, banded by its distance + `pad`
944
+ */
945
+ readonly unit: 'copy' | 'whole';
946
+ /** where the weld's shared meshes (the batches, the hosted copies' meshes) go; the copies' roots are the model's */
947
+ readonly parent: THREE.Object3D;
948
+ /** 'whole': the unit's root, posed (its meshes in its frame, its bands measured from it); the caller adds it to the scene */
949
+ readonly root?: THREE.Object3D;
950
+ /** 'whole': metres added to the unit's bands (its copies stand up to this far from its root) */
951
+ readonly pad?: number;
952
+ /** metres: the weld's detail band — the near proxies draw within it, the band proxies cast only past it (with `near`), and
953
+ * the hosted copies are drawn while their unit is within it (+ its pad) */
954
+ readonly detail: number;
955
+ /** each 'copy' unit gets one near proxy of all it draws (and its copy's `casters`); its band proxies cast only past `detail` */
956
+ readonly near?: boolean;
957
+ }
958
+
959
+ interface WeldCopy { readonly build: WeldBuild; readonly always: THREE.Mesh[]; readonly onBox: (box: THREE.Box3) => void }
960
+
961
+ /** A weld in progress: `new Weld(…)`, then `place(…, { weld })` per model, then `finish()`. */
962
+ export class Weld {
963
+ private readonly copies: WeldCopy[] = [];
964
+ private readonly whole: UnitParts | null;
965
+ private readonly pending: (() => void)[] = [];
966
+ private readonly hostedSets: HostedSet[] = [];
967
+ private culler: WeldCull | null = null;
968
+ private done = false;
969
+ readonly options: WeldOptions;
970
+ constructor(options: WeldOptions) {
971
+ this.options = options;
972
+ this.whole = options.unit === 'whole' ? new UnitParts() : null;
973
+ if (options.unit === 'whole' && options.root === undefined) throw new Error("weld: a 'whole' unit needs its root");
974
+ }
975
+ /** copies joined so far (the next one's index: a `Placement.host`) */
976
+ get size(): number { return this.copies.length; }
977
+ get finished(): boolean { return this.done; }
978
+ /** 'whole': its unit's root; 'copy': null */
979
+ get unitRoot(): THREE.Object3D | null { return this.options.unit === 'whole' ? this.options.root ?? null : null; }
980
+ /** the unit copy `i` belongs to */
981
+ unitOf(i: number): number {
982
+ if (i < 0 || i >= this.copies.length) throw new Error(`weld: no copy ${i} to host`);
983
+ return this.options.unit === 'whole' ? 0 : i;
984
+ }
985
+
986
+ /** a copy joins: a 'copy' unit is merged now (under its root), a 'whole' one's parts go to the unit */
987
+ join(b: WeldBuild, onBox: (box: THREE.Box3) => void): void {
988
+ if (this.done) throw new Error('weld: finished — no more copies');
989
+ const o = this.options, casters = b.casters ?? [];
990
+ const always: THREE.Mesh[] = [];
991
+ let np: THREE.Mesh | null;
992
+ const root = this.unitRoot;
993
+ if (this.whole !== null && root !== null) {
994
+ // the copy's frame → the unit's (both roots' own matrices: they stand directly under one parent); its own near proxy
995
+ // is only its dressing's
996
+ this.whole.add(b.parts, new THREE.Matrix4().copy(root.matrix).invert().multiply(b.root.matrix));
997
+ np = casters.length > 0 ? nearProxy([], casters) : null;
998
+ } else {
999
+ const near = o.near === true;
1000
+ const unit = new UnitParts();
1001
+ unit.add(b.parts);
1002
+ const d = unit.draw(b.root, near);
1003
+ for (const { mesh, part } of d.meshes) {
1004
+ if (part.until === undefined) always.push(mesh); else mesh.userData['until'] = part.until;
1005
+ }
1006
+ for (const { mesh, until } of d.proxies) {
1007
+ if (until !== undefined) mesh.userData['until'] = until;
1008
+ if (near) mesh.userData['castFrom'] = o.detail;
1009
+ }
1010
+ np = near || casters.length > 0 ? nearProxy(near ? d.front : [], casters) : null;
1011
+ }
1012
+ if (np !== null) { b.root.add(np); np.userData['until'] = o.detail; }
1013
+ this.copies.push({ build: b, always, onBox });
1014
+ }
1015
+
1016
+ /** a registration that waits for the weld to be drawn */
1017
+ defer(fn: () => void): void { if (this.done) fn(); else this.pending.push(fn); }
1018
+
1019
+ /** copies drawn by the weld's units (instanced into it) */
1020
+ host(set: HostedSet): void { if (this.culler !== null) this.culler.host(set); else this.hostedSets.push(set); }
1021
+
1022
+ finish(): void {
1023
+ if (this.done) return;
1024
+ const o = this.options, pad = o.pad ?? 0;
1025
+ const root = o.root;
1026
+ if (this.whole !== null && root !== undefined) {
1027
+ const d = this.whole.draw(root, false);
1028
+ for (const { mesh, part } of d.meshes) if (part.until !== undefined) mesh.userData['until'] = part.until + pad;
1029
+ for (const { mesh, until } of d.proxies) if (until !== undefined) mesh.userData['until'] = until + pad;
1030
+ } else weldAcross(this.copies.map((c) => ({ root: c.build.root, meshes: c.always })), o.parent);
1031
+ // the bands: every tagged object, from its copy's root (or the unit's)
1032
+ const objects: THREE.Object3D[] = [], reach: number[] = [], cast: number[] = [], at: number[] = [], origins: number[] = [];
1033
+ const collect = (top: THREE.Object3D, origin: number): void => {
1034
+ top.traverse((x) => {
1035
+ const u: unknown = x.userData['until'], c: unknown = x.userData['castFrom'];
1036
+ if (typeof u === 'number') { objects.push(x); reach.push(u * u); cast.push(0); at.push(origin); }
1037
+ if (typeof c === 'number') { objects.push(x); reach.push(c * c); cast.push(1); at.push(origin); }
1038
+ });
1039
+ };
1040
+ this.copies.forEach((c, i) => { const p = c.build.root.position; origins.push(p.x, p.y, p.z); collect(c.build.root, i); });
1041
+ let units: number[];
1042
+ let detail2: number[];
1043
+ if (this.whole !== null && root !== undefined) {
1044
+ origins.push(root.position.x, root.position.y, root.position.z);
1045
+ collect(root, this.copies.length);
1046
+ units = [this.copies.length]; detail2 = [(o.detail + pad) ** 2];
1047
+ } else { units = this.copies.map((_, i) => i); detail2 = this.copies.map(() => o.detail ** 2); }
1048
+ const culler = new WeldCull(objects, Float64Array.from(reach), Uint8Array.from(cast), Uint32Array.from(at), Float64Array.from(origins), Uint32Array.from(units), Float64Array.from(detail2));
1049
+ this.culler = culler;
1050
+ for (const s of this.hostedSets) culler.host(s);
1051
+ this.hostedSets.length = 0;
1052
+ startCuller(weldLives.get(this) ?? lifeOf(null), (camera) => { culler.update(camera); });
1053
+ this.done = true;
1054
+ // the copies' boxes (what the weld drew), then their pieces, in the order they were placed
1055
+ for (const c of this.copies) c.onBox(c.build.box(new THREE.Box3()));
1056
+ for (const fn of this.pending.splice(0)) fn();
1057
+ }
1058
+ }
1059
+
1060
+ function drawWelded<P extends object>(def: ModelDef<P>, pls: readonly Placement<P>[], poses: readonly Pose[], params: readonly P[], o: BuildOptions<P>, w: Weld): Drawn {
1061
+ const build = def.weld;
1062
+ if (build === undefined) throw new Error(`place: '${def.id}' has no weld build (ModelDef.weld)`);
1063
+ const colliders: ColliderDesc[] = [];
1064
+ const boxes = new Float32Array(pls.length * 6);
1065
+ const roots: THREE.Object3D[] = [];
1066
+ params.forEach((p, i) => {
1067
+ const pose = poses[i];
1068
+ if (pose === undefined) return;
1069
+ const b = build(o.ctx, p);
1070
+ o.visitBuild?.({ kind: 'weld', built: b, params: p, placements: pls.slice(i, i + 1), level: 0 });
1071
+ collideCopy(def, p, pose, null, [], colliders, o.ctx);
1072
+ colliders.push(...b.colliders);
1073
+ roots.push(b.root);
1074
+ w.join(b, (box) => { writeBox(boxes, i, box); });
1075
+ });
1076
+ const only = roots.length === 1 ? roots[0] : undefined;
1077
+ return { object: w.unitRoot ?? only ?? w.options.parent, drawnAs: 'merged', colliders, boxes, cull: null };
1078
+ }
1079
+
1080
+ /** instanced copies hosted by a weld's copies: one InstancedMesh per part (per variant) with room for all, drawn by the weld */
1081
+ function drawHosted<P extends object>(def: ModelDef<P>, pls: readonly Placement<P>[], poses: readonly Pose[], params: readonly P[], o: BuildOptions<P>, w: Weld): Drawn {
1082
+ const { keys, of } = variantKeys(pls);
1083
+ const n = pls.length;
1084
+ const colliders: ColliderDesc[] = [];
1085
+ const boxes = new Float32Array(n * 6);
1086
+ const built = keys.map((k) => partsOf(buildModel(def, o, paramsOf(def, k, undefined), new Rng(seedOf(def)), o.visitBuild === undefined ? pls : pls.filter((pl) => pl.variant === k)), def.id, 'instanced'));
1087
+ const units = pls.map((pl) => {
1088
+ if (pl.host === undefined) throw new Error(`place: '${def.id}' is instanced into a weld — every copy needs its host`);
1089
+ return w.unitOf(pl.host);
1090
+ });
1091
+ pls.forEach((_, i) => {
1092
+ const pose = poses[i], p = params[i], parts = built[of[i] ?? 0] ?? [];
1093
+ if (pose === undefined || p === undefined) return;
1094
+ writeBox(boxes, i, ownBox(parts, _box).applyMatrix4(pose.matrix));
1095
+ collideCopy(def, p, pose, null, parts.map((x) => x.geometry), colliders, o.ctx);
1096
+ });
1097
+ const objects: THREE.Object3D[] = [];
1098
+ built.forEach((parts, v) => {
1099
+ // the copies of this variant, per host run (consecutive copies of one host), in placement order
1100
+ const lists: { unit: number; matrices: Float32Array }[] = [];
1101
+ let run: number[] = [];
1102
+ const close = (): void => {
1103
+ const first = run[0];
1104
+ if (first === undefined) return;
1105
+ const m = new Float32Array(run.length * 16);
1106
+ run.forEach((i, j) => { poses[i]?.matrix.toArray(m, j * 16); });
1107
+ lists.push({ unit: units[first] ?? 0, matrices: m });
1108
+ run = [];
1109
+ };
1110
+ pls.forEach((pl, i) => {
1111
+ if (of[i] !== v) return;
1112
+ const prev = run[0];
1113
+ if (prev !== undefined && pls[prev]?.host !== pl.host) close();
1114
+ run.push(i);
1115
+ });
1116
+ close();
1117
+ const total = lists.reduce((c, l) => c + l.matrices.length / 16, 0);
1118
+ if (total === 0) return;
1119
+ const meshes = parts.map((part) => {
1120
+ const im = new THREE.InstancedMesh(part.geometry, part.material, total);
1121
+ im.castShadow = false; im.receiveShadow = part.receiveShadow ?? false; // hosted: its host's near proxy carries its depth
1122
+ if (part.renderOrder !== undefined) im.renderOrder = part.renderOrder;
1123
+ // as built: every copy drawn (the weld's bands choose from its first look)
1124
+ const dst = im.instanceMatrix.array as Float32Array;
1125
+ let c = 0;
1126
+ for (const l of lists) { dst.set(l.matrices, c * 16); c += l.matrices.length / 16; }
1127
+ im.computeBoundingSphere();
1128
+ return im;
1129
+ });
1130
+ objects.push(...meshes);
1131
+ w.host({ meshes, lists });
1132
+ });
1133
+ const object = wrap(objects, def.id);
1134
+ w.options.parent.add(object);
1135
+ return { object, drawnAs: 'instanced', colliders, boxes, cull: null };
1136
+ }
1137
+
1138
+ // ── the catalog entry: a specimen in own space, its variants, its facts ──
1139
+
1140
+ function modelEntry<P extends object>(def: ModelDef<P>, o: PlaceOptions, rec: ModelRecord, drawnAs: DrawnAs, registry: WorldRegistry): ModelEntry {
1141
+ const specimen = new THREE.Group();
1142
+ specimen.name = `model:${def.id}`;
1143
+ // Explore queues cards across tile retirement; their resources belong to the resident world.
1144
+ const registrationOwner = resourceScope(), parent = registry.scope ?? (registry === app.registryValue ? app.levelScope : null) ?? registrationOwner, owners = new Set<Scope>();
1145
+ const scoped = def.specimenLifetime === 'view' || def.prepare !== undefined;
1146
+ const requireSpecimenOwner = (): void => { if (scoped && (parent.disposed || parent.disposing || registry.retired)) throw new Error('Model specimen owner is not live'); };
1147
+ const build = (variant?: string): THREE.Object3D => {
1148
+ requireSpecimenOwner();
1149
+ const owner = scoped ? parent.child(`specimen/${def.id}`) : undefined;
1150
+ if (owner !== undefined) owners.add(owner);
1151
+ const make = () => (def.specimen ?? def.build)(owner === undefined ? o.ctx : { ...o.ctx, specimenScope: owner }, paramsOf(def, variant, undefined), new Rng(seedOf(def)));
1152
+ const makeObject = (): THREE.Object3D => {
1153
+ const built = owner === undefined ? make() : withOwner(owner, make);
1154
+ // Culled models retain their native instanced specimen program.
1155
+ const one = (x: ModelPart): THREE.Mesh => (o.culler === undefined ? meshOf(x) : instanceOf(x));
1156
+ const obj = Array.isArray(built) ? wrap((built as readonly ModelPart[]).map(one), def.id) : built as THREE.Object3D;
1157
+ if (owner !== undefined) {
1158
+ obj.traverse(node => { if (node instanceof THREE.InstancedMesh) ownSceneResource(node, owner); });
1159
+ owner.onDispose(() => { obj.removeFromParent(); });
1160
+ }
1161
+ if (def.specimenYaw !== undefined) obj.rotation.y = def.specimenYaw;
1162
+ return obj;
1163
+ };
1164
+ const prepared = def.prepare;
1165
+ if (prepared !== undefined && owner !== undefined) {
1166
+ return loadingSpecimen(def.id, [1, 1, 1], async () => {
1167
+ await prepared();
1168
+ requireSpecimenOwner();
1169
+ if (owner.disposed || owner.disposing) throw new Error('Specimen view retired during preparation');
1170
+ const obj = makeObject();
1171
+ await specimenReady(obj);
1172
+ return obj;
1173
+ }, owner);
1174
+ }
1175
+ try { return makeObject(); }
1176
+ catch (error) { owner?.dispose(); if (owner !== undefined) owners.delete(owner); throw error; }
1177
+ };
1178
+ // World copies retain their own resources; scoped catalogue choices retire on close.
1179
+ const specimens = new Map<string, THREE.Object3D>();
1180
+ const release = (): void => {
1181
+ specimen.removeFromParent(); specimen.clear(); specimens.clear();
1182
+ for (const owner of owners) owner.dispose(); owners.clear();
1183
+ };
1184
+ // O18: the entry lives on its registry's piece: a world that retires releases it too, and drops the ambient owner's
1185
+ // hold (the page's scope after an await), or every visit's release (and the placement it closes over) outlived the visit
1186
+ if (scoped) { const forget = registrationOwner.capture('disposers', release); registry.onRetire(() => { forget(); release(); }); }
1187
+ const kept = (variant?: string): THREE.Object3D => {
1188
+ const key = variant ?? '';
1189
+ let obj = specimens.get(key);
1190
+ if (obj === undefined) { obj = build(variant); specimens.set(key, obj); }
1191
+ return obj;
1192
+ };
1193
+ const rebuild = (variant?: string): void => {
1194
+ const container = specimen.parent;
1195
+ if (scoped) release();
1196
+ specimen.clear();
1197
+ specimen.add(kept(variant));
1198
+ container?.add(specimen);
1199
+ if ('document' in globalThis) document.dispatchEvent(new CustomEvent('ws:model-ready', { detail: { id: def.id } }));
1200
+ };
1201
+ const entry: ModelEntry = {
1202
+ ...(scoped ? { release, ready: () => specimenReady(specimen) } : {}),
1203
+ id: def.id, category: def.category, live: false, pipeline: def.pipeline, drawnAs,
1204
+ object: () => { requireSpecimenOwner(); if (specimen.children.length === 0) specimen.add(kept()); return specimen; },
1205
+ buildAt: (tier) => withTier(tier, () => build()),
1206
+ get copies(): number { let c = 0; for (const g of rec.groups) c += g.copies; return c; },
1207
+ worldBox: (near) => {
1208
+ let best: Placed | null = null, bi = -1, bd = Number.POSITIVE_INFINITY;
1209
+ for (const g of rec.groups) {
1210
+ const i = g.nearest(near);
1211
+ if (i < 0) continue;
1212
+ const d = g.copyBox(i, _box).getCenter(_v).distanceToSquared(near);
1213
+ if (d < bd) { bd = d; best = g; bi = i; }
1214
+ }
1215
+ return best ? best.copyBox(bi, new THREE.Box3()) : null;
1216
+ },
1217
+ };
1218
+ const visibleVariants = def.variants?.filter(variant => variant.hidden !== true);
1219
+ if (visibleVariants !== undefined && visibleVariants.length > 0) { entry.variants = visibleVariants.map((v) => ({ id: v.id, label: v.label })); entry.rebuild = rebuild; }
1220
+ return entry;
1221
+ }
1222
+
1223
+ // ── drawn by the set (`drawnInto`): nothing to draw, the copies' colliders and boxes carried ──
1224
+
1225
+ function drawnElsewhere<P extends object>(def: ModelDef<P>, poses: readonly Pose[], params: readonly P[], o: PlaceOptions, d: DrawnInto): Drawn {
1226
+ const colliders: ColliderDesc[] = [];
1227
+ poses.forEach((pose, i) => { const p = params[i]; if (p !== undefined) collideCopy(def, p, pose, null, [], colliders, o.ctx); });
1228
+ colliders.push(...(d.colliders ?? []));
1229
+ return { object: d.object, drawnAs: o.draw, colliders, boxes: d.boxes, cull: null };
1230
+ }
1231
+
1232
+ /** the centre of every copy's box (a piece without an object of its own: VIEW IN WORLD's anchor) */
1233
+ function boxesCentre(boxes: Float32Array): THREE.Vector3 {
1234
+ const b = new THREE.Box3();
1235
+ for (let i = 0; i + 5 < boxes.length; i += 6) b.union(_box.set(_v.set(boxes[i] ?? 0, boxes[i + 1] ?? 0, boxes[i + 2] ?? 0), new THREE.Vector3(boxes[i + 3] ?? 0, boxes[i + 4] ?? 0, boxes[i + 5] ?? 0)));
1236
+ return b.getCenter(new THREE.Vector3());
1237
+ }
1238
+
1239
+ /** `piece.follows: 'copy'`: the one `single` copy moves — its colliders ride it, so they are the model's own-space ones */
1240
+ function followCopy<P extends object>(def: ModelDef<P>, copies: number, params: P | undefined, o: PlaceOptions, drawn: Drawn): void {
1241
+ if (copies !== 1 || o.draw !== 'single' || params === undefined) throw new Error(`place: '${def.id}' follows its copy: one 'single' placement only`);
1242
+ const own: THREE.BufferGeometry[] = [];
1243
+ drawn.object.traverse((c) => { const m = c as Partial<THREE.Mesh>; if (m.isMesh === true && m.geometry) own.push(m.geometry); });
1244
+ const out: ColliderDesc[] = [];
1245
+ collideCopy(def, params, poseOf({ x: 0, y: 0, z: 0 }), null, own, out, o.ctx);
1246
+ drawn.colliders = out; // (the Placed keeps the placed, world-space ones)
1247
+ }
1248
+
1249
+ // ── a tap on an object copies are drawn into (E323) ──
1250
+
1251
+ /** how far outside a copy's box a tap still lands on it, metres (a hit on its face can round a hair outside) */
1252
+ export const CLAIM_MARGIN = 0.15;
1253
+
1254
+ /** A split piece's colliders per registration in play (OP4): ~0.3-0.6 ms a hull on the Simulator, so a dozen stays
1255
+ * inside one frame's shared build budget; the loading screen keeps each caller's `every`. */
1256
+ export const LIVE_SPLIT_EVERY = 12;
1257
+ /** In play, a piece with more colliders than this and no `split` of its own splits by LIVE_SPLIT_EVERY on the engine's
1258
+ * paced yield (OP5): Pine's 69 stump hulls landed as one unsplit registration inside a grid cell's travel window. */
1259
+ export const LIVE_SPLIT_OVER: number = 2 * LIVE_SPLIT_EVERY;
1260
+ const _claim = new THREE.Box3();
1261
+
1262
+ /** the smallest of `p`'s copy boxes holding `pt` (grown by CLAIM_MARGIN), or null when `pt` is on none of them */
1263
+ export function claimCopy(p: Placed, pt: THREE.Vector3): THREE.Box3 | null {
1264
+ let best: THREE.Box3 | null = null, bv = Number.POSITIVE_INFINITY;
1265
+ for (let i = 0; i < p.copies; i++) {
1266
+ p.copyBox(i, _claim);
1267
+ if (pt.x < _claim.min.x - CLAIM_MARGIN || pt.x > _claim.max.x + CLAIM_MARGIN || pt.y < _claim.min.y - CLAIM_MARGIN || pt.y > _claim.max.y + CLAIM_MARGIN
1268
+ || pt.z < _claim.min.z - CLAIM_MARGIN || pt.z > _claim.max.z + CLAIM_MARGIN) continue;
1269
+ const s = _claim.getSize(_v), v = s.x * s.y * s.z;
1270
+ if (v < bv) { bv = v; best = (best ?? new THREE.Box3()).copy(_claim); }
1271
+ }
1272
+ return best;
1273
+ }
1274
+
1275
+ const _ray = new THREE.Vector3();
1276
+
1277
+ /** the nearest of `p`'s copy boxes `ray` enters within `far` (a box it starts inside doesn't count), or null */
1278
+ export function rayCopy(p: Placed, ray: THREE.Ray, far: number): { box: THREE.Box3; distance: number } | null {
1279
+ let best: { box: THREE.Box3; distance: number } | null = null;
1280
+ for (let i = 0; i < p.copies; i++) {
1281
+ p.copyBox(i, _claim);
1282
+ if (_claim.containsPoint(ray.origin) || ray.intersectBox(_claim, _ray) === null) continue;
1283
+ const d = _ray.distanceTo(ray.origin);
1284
+ if (d <= far && (best === null || d < best.distance)) best = { box: _claim.clone(), distance: d };
1285
+ }
1286
+ return best;
1287
+ }
1288
+
1289
+ // ── place ──
1290
+
1291
+ /** Place copies of a model (see the file header and ./model.ts's migration guide). */
1292
+ export function place<P extends object>(def: ModelDef<P>, placements: readonly Placement<P>[], o: PlaceOptions): Placed {
1293
+ return runSteps(placeSteps(def, placements, o));
1294
+ }
1295
+
1296
+ /**
1297
+ * `place`, in slices (SF67, E461: a builder's one `place` call was a 0.1–0.6 s task at load): at every pause point (after each
1298
+ * merged copy is built and each merged mesh is welded) it calls `due()` and awaits the promise it returns (the caller's
1299
+ * clock decides; `slicer()`'s budget during loading). The result, the draw, the registration and the rng streams are
1300
+ * exactly `place`'s: nothing is registered or added to the scene before the last slice. `draw: 'merged'` and
1301
+ * `draw: 'instanced'` (with or without a shard's `culler`: op-hitch29) pause, without a weld or `drawnInto`: an instanced
1302
+ * draw after each variant's level is built (the sculpt, then each LOD), each copy's colliders, and each part's instanced
1303
+ * mesh made (a `culler` takes each one as it is made, as in `place`). Every other draw runs in one task, as `place` does.
1304
+ */
1305
+ export async function placeSliced<P extends object>(def: ModelDef<P>, placements: readonly Placement<P>[], o: PlaceOptions, due: () => Promise<void> | null): Promise<Placed> {
1306
+ const steps = placeSteps(def, placements, o);
1307
+ // every slice runs under the owner the call was made in, as one synchronous `place` would (SF57: an await drops it)
1308
+ const entered = enteredOwner();
1309
+ const next = (): IteratorResult<void, Placed> => (entered === null ? steps.next() : withOwner(entered, () => steps.next()));
1310
+ for (;;) {
1311
+ const r = next();
1312
+ if (r.done === true) return r.value;
1313
+ const pause = due();
1314
+ if (pause !== null) await pause;
1315
+ }
1316
+ }
1317
+
1318
+ function* placeSteps<P extends object>(def: ModelDef<P>, placements: readonly Placement<P>[], o: PlaceOptions): Generator<void, Placed> {
1319
+ const poses = placements.map((pl) => poseOf(pl));
1320
+ const params = placements.map((pl) => paramsOf(def, pl.variant, pl.params));
1321
+ const w = o.weld;
1322
+ if (w !== undefined && o.draw !== 'merged' && o.draw !== 'instanced') throw new Error(`place: '${def.id}' — a weld takes merged or instanced copies (asked for '${o.draw}')`);
1323
+ const visitBuild = o.ctx.visitPlacement?.({
1324
+ model: def.id, placements, draw: o.draw, moving: o.piece?.follows !== undefined,
1325
+ ...(o.piece?.id === undefined ? {} : { pieceId: o.piece.id }),
1326
+ ...(o.drawnInto === undefined ? {} : { drawnInto: o.drawnInto.object }),
1327
+ });
1328
+ const buildOptions: BuildOptions<P> = visitBuild === undefined ? o : { ...o, visitBuild };
1329
+ const drawn = o.drawnInto !== undefined ? drawnElsewhere(def, poses, params, o, o.drawnInto)
1330
+ : w !== undefined ? (o.draw === 'merged' ? drawWelded(def, placements, poses, params, buildOptions, w) : drawHosted(def, placements, poses, params, buildOptions, w))
1331
+ : o.draw === 'merged' ? yield* drawMergedSteps(def, placements, poses, params, buildOptions)
1332
+ : o.draw === 'instanced' ? (o.culler ? yield* drawHandedSteps(def, placements, poses, params, buildOptions, o.culler) : yield* drawInstancedSteps(def, placements, poses, params, buildOptions))
1333
+ : o.draw === 'batched' ? drawBatched(def, placements, poses, params, buildOptions)
1334
+ : drawSingle(def, placements, poses, params, buildOptions);
1335
+ const { boxes } = drawn;
1336
+ const extra = o.piece?.colliders;
1337
+ if (extra !== undefined) drawn.colliders = [...drawn.colliders, ...extra];
1338
+ // where each copy stands, for `nearest` (float64: exact) — the placements themselves are not kept alive
1339
+ const points = new Float64Array(placements.length * 3);
1340
+ placements.forEach((pl, i) => { points[i * 3] = pl.x; points[i * 3 + 1] = pl.y; points[i * 3 + 2] = pl.z; });
1341
+ let registered: Promise<void> = Promise.resolve();
1342
+ const placed: Placed = {
1343
+ get registered(): Promise<void> { return registered; },
1344
+ model: def.id, object: drawn.object, colliders: drawn.colliders, copies: placements.length, drawnAs: drawn.drawnAs,
1345
+ cull: drawn.cull ?? ((): void => undefined),
1346
+ copyBox: (i, target) => {
1347
+ target.min.set(boxes[i * 6] ?? 0, boxes[i * 6 + 1] ?? 0, boxes[i * 6 + 2] ?? 0);
1348
+ target.max.set(boxes[i * 6 + 3] ?? 0, boxes[i * 6 + 4] ?? 0, boxes[i * 6 + 5] ?? 0);
1349
+ return target;
1350
+ },
1351
+ nearest: (p) => {
1352
+ let bi = -1, bd = Number.POSITIVE_INFINITY;
1353
+ for (let i = 0; i * 3 < points.length; i++) { const d = ((points[i * 3] ?? 0) - p.x) ** 2 + ((points[i * 3 + 1] ?? 0) - p.y) ** 2 + ((points[i * 3 + 2] ?? 0) - p.z) ** 2; if (d < bd) { bd = d; bi = i; } }
1354
+ return bi;
1355
+ },
1356
+ };
1357
+ const registry = o.registry === undefined ? app.registry : o.registry;
1358
+ // what this call starts and records lives as long as its registry (a resident shard's) — or its owner, when build-only
1359
+ const life = lifeOf(registry), owner = shorterOwner(registry);
1360
+ if (w !== undefined && !weldLives.has(w)) weldLives.set(w, life);
1361
+ const view = o.cull?.view, cullWith = drawn.cullWith;
1362
+ if (view !== undefined && cullWith) {
1363
+ view.onViewChange(cullWith); // the shard's view drives it
1364
+ // FC12: a set drawn whole over streamed tiles follows its resident tiles between view changes (InstancedCull.update)
1365
+ if (o.cull?.resident !== undefined && drawn.cull) {
1366
+ const cull = drawn.cull;
1367
+ startCuller(life, cull);
1368
+ if (owner !== null && registry !== null) untilOwner(owner, registry, () => { stopCuller(life, cull); });
1369
+ }
1370
+ } else if (drawn.cull) {
1371
+ const cull = drawn.cull;
1372
+ startCuller(life, cull);
1373
+ if (owner !== null && registry !== null) untilOwner(owner, registry, () => { stopCuller(life, cull); });
1374
+ }
1375
+ // drawn by what it shares (a set's kit, a weld): its piece anchors on its copies, and a tap claims one of them
1376
+ const shared = o.drawnInto !== undefined || w !== undefined;
1377
+ if (registry === null) { if (w === undefined) o.parent?.add(drawn.object); return placed; }
1378
+ const register = (): void => {
1379
+ let rec = life.records.get(def.id);
1380
+ const first = rec === undefined;
1381
+ if (!rec) { rec = { groups: [] }; if (!life.retired) life.records.set(def.id, rec); }
1382
+ rec.groups.push(placed);
1383
+ if (owner !== null) {
1384
+ const record = rec;
1385
+ // SF57: the copy leaves the record with its owner; an emptied record goes too, so a re-entry's copy is the model's first again
1386
+ untilOwner(owner, registry, () => {
1387
+ const i = record.groups.indexOf(placed);
1388
+ if (i !== -1) record.groups.splice(i, 1);
1389
+ if (record.groups.length === 0 && life.records.get(def.id) === record) life.records.delete(def.id);
1390
+ });
1391
+ }
1392
+ const pc = o.piece ?? {};
1393
+ if (pc.follows === 'copy') followCopy(def, placements.length, params[0], o, drawn);
1394
+ const pieceId = pc.id ?? (first ? def.id : `${def.id}#${rec.groups.length}`), split = pc.split;
1395
+ // OP4: in play (a grid cell built on the road) a split piece registers LIVE_SPLIT_EVERY colliders at a time and
1396
+ // yields once the frame's shared build budget is spent: the loading budget's 90-150 hulls a task (Rapier's
1397
+ // convexHull each) were single 40-100 ms Simulator frames. The same colliders, in more collider-only pieces.
1398
+ // OP5: in play, a piece with no split of its own but more than LIVE_SPLIT_OVER colliders splits the same way, on the
1399
+ // engine's paced yield in its registry's world scope (any shard's large live piece; the loading screen is unchanged).
1400
+ const live = presenting(), scope = registry.scope;
1401
+ const pace = split !== undefined ? split.yieldTask
1402
+ : live && scope !== null && drawn.colliders.length > LIVE_SPLIT_OVER ? (): Promise<void> => paceYield(() => yieldTask(scope), scope, WORK_SLICE_MS) : undefined;
1403
+ const every = pace === undefined ? drawn.colliders.length : Math.max(1, live ? Math.min(split?.every ?? LIVE_SPLIT_EVERY, LIVE_SPLIT_EVERY) : split?.every ?? LIVE_SPLIT_EVERY);
1404
+ registry.add({
1405
+ id: pieceId, name: pc.name ?? def.name, category: def.category, file: def.file,
1406
+ ...(shared ? { anchor: boxesCentre(boxes) } : { object: drawn.object }), colliders: pc.collide === false ? [] : drawn.colliders.slice(0, every),
1407
+ ...(def.surface === undefined ? {} : { surface: def.surface }), ...(pc.floor === undefined ? {} : { floor: pc.floor }),
1408
+ ...(pc.solidFloor === undefined ? {} : { solidFloor: pc.solidFloor }), ...(pc.follows === undefined ? {} : { follows: pc.follows === 'copy' ? drawn.object : pc.follows }),
1409
+ ...(pc.active === undefined ? {} : { active: pc.active }),
1410
+ ...(first ? { model: modelEntry(def, o, rec, drawn.drawnAs, registry) } : {}),
1411
+ });
1412
+ // (the registry's scene listener added it to the scene: under the shard's own group instead; a weld's are where it put them)
1413
+ if (w === undefined) o.parent?.add(drawn.object);
1414
+ // a tap on any copy selects the model, boxed on the copy under the finger
1415
+ registry.addPick({ object: drawn.object, entry: def.id, boxAt: (pt) => placed.copyBox(Math.max(0, placed.nearest(pt)), new THREE.Box3()),
1416
+ // drawn into an object it shares (a kit, a painted place, a weld): a tap is this model's only on one of its copies (E323)
1417
+ ...(shared ? { claim: (pt: THREE.Vector3): THREE.Box3 | null => claimCopy(placed, pt), boxHit: (ray: THREE.Ray, far: number) => rayCopy(placed, ray, far) } : {}) });
1418
+ if (pc.collide !== false && pace !== undefined && drawn.colliders.length > every) {
1419
+ // the rest of the colliders, a task per `every` (collider-only pieces: the object and the catalog entry are on the first)
1420
+ registered = (async (): Promise<void> => {
1421
+ for (let at = every, k = 2; at < drawn.colliders.length; at += every, k++) {
1422
+ if (!live || frameBudgetSpent(WORK_SLICE_MS)) await pace();
1423
+ // a world that left while this waited takes no more pieces
1424
+ if (registry.retired) return;
1425
+ registry.add({ id: `${pieceId}-${k}`, name: pc.name ?? def.name, category: def.category, file: def.file, colliders: drawn.colliders.slice(at, at + every),
1426
+ ...(def.surface === undefined ? {} : { surface: def.surface }) });
1427
+ }
1428
+ })();
1429
+ }
1430
+ };
1431
+ // a welded copy's piece waits for its weld: its box, its anchor and its drawing are final then (`Weld.finish`)
1432
+ if (w !== undefined && o.draw === 'merged') registered = new Promise((resolve) => { w.defer(() => { register(); resolve(); }); });
1433
+ else register();
1434
+ return placed;
1435
+ }
1436
+
1437
+
1438
+ /** Authored own-space site metadata; its existing floor evaluator owns the site's walkable profile. */
1439
+ export interface ModelSiteLayout {
1440
+ readonly colliders: readonly BoxSpec[];
1441
+ readonly anchors: Readonly<Record<string, { readonly x: number; readonly y: number; readonly z: number; readonly yaw: number }>>;
1442
+ readonly floorHeightAt: (x: number, z: number) => number | undefined;
1443
+ }
1444
+ /** One actual placed model and its world-space metadata, without a second registration or draw. */
1445
+ export interface ModelSite {
1446
+ readonly group: THREE.Object3D;
1447
+ readonly placed: Placed;
1448
+ readonly colliders: BoxSpec[];
1449
+ readonly anchors: Record<string, { x: number; y: number; z: number; yaw: number }>;
1450
+ readonly colliderDescs: () => ColliderDesc[];
1451
+ readonly floorHeightAt: (x: number, z: number) => number | undefined;
1452
+ }
1453
+ /** Place an already authored fixed site through the ordinary model builder, then translate its metadata once.
1454
+ * The origin is a translation, not another turn: the site's geometry, floor and anchor yaw already carry their authored
1455
+ * rotation. The existing place path keeps model seed, registration, colliders, drawing and ownership unchanged. Its one
1456
+ * copy is drawn `single`, so a model that builds a whole object (a library model) places as one that builds parts does.
1457
+ * Optional params override the model defaults for that copy; absent params retain the default build.
1458
+ */
1459
+ export function placeModelSite<P extends object>(model: ModelDef<P>, origin: { readonly x: number; readonly y: number; readonly z: number },
1460
+ layout: ModelSiteLayout, options: Omit<PlaceOptions, 'draw'> & { readonly params?: Partial<P> }): ModelSite {
1461
+ if (![origin.x, origin.y, origin.z].every(Number.isFinite) || layout.colliders.length > 100000 || Object.keys(layout.anchors).length > 1024) throw new Error('Invalid model site metadata');
1462
+ const entries = Object.entries(layout.anchors);
1463
+ if (entries.some(([key, anchor]) => ['__proto__', 'prototype', 'constructor'].includes(key) || key.length === 0 || key.length > 256
1464
+ || ![anchor.x, anchor.y, anchor.z, anchor.yaw].every(Number.isFinite))) throw new Error('Invalid model site anchor');
1465
+ const floorHeightAt = (x: number, z: number): number | undefined => {
1466
+ const y = layout.floorHeightAt(x - origin.x, z - origin.z);
1467
+ return y === undefined ? undefined : y + origin.y;
1468
+ };
1469
+ const { params, ...placementOptions } = options;
1470
+ const placed = place(model, [{ ...origin, params: params ?? {} }], { ...placementOptions, draw: 'single',
1471
+ piece: { ...options.piece, floor: floorHeightAt, solidFloor: true } });
1472
+ return { group: placed.object, placed,
1473
+ colliders: layout.colliders.map(box => ({ ...box, x: box.x + origin.x, z: box.z + origin.z, yTop: box.yTop + origin.y, yBottom: box.yBottom + origin.y })),
1474
+ anchors: Object.fromEntries(entries.map(([key, anchor]) => [key, { x: anchor.x + origin.x, y: anchor.y + origin.y, z: anchor.z + origin.z, yaw: anchor.yaw }])),
1475
+ colliderDescs: () => [...placed.colliders], floorHeightAt };
1476
+ }