@wildshard/sdk 0.0.0 → 0.2.3

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 (687) hide show
  1. package/GUIDE.md +790 -0
  2. package/README.md +14 -4
  3. package/bin/wildshard.mjs +38 -0
  4. package/lint/declaration-config.d.mts +2 -0
  5. package/lint/declaration-config.mjs +19 -0
  6. package/lint/engine-plugin.d.mts +2 -0
  7. package/lint/engine-plugin.mjs +40 -0
  8. package/lint/host-callbacks.d.mts +6 -0
  9. package/lint/host-callbacks.mjs +123 -0
  10. package/lint/host-files.d.mts +1 -0
  11. package/lint/host-files.mjs +7 -0
  12. package/lint/layer-exports.d.mts +2 -0
  13. package/lint/layer-exports.mjs +21 -0
  14. package/lint/legacy-line-basis.json +995 -0
  15. package/lint/nine-tiling-baseline.json +35 -0
  16. package/lint/ratchet.json +11 -0
  17. package/lint/runtime-files.d.mts +12 -0
  18. package/lint/runtime-files.json +16 -0
  19. package/lint/runtime-files.mjs +69 -0
  20. package/lint/runtime-performance.d.mts +6 -0
  21. package/lint/runtime-performance.mjs +184 -0
  22. package/lint/sdk-plugin.d.mts +4 -0
  23. package/lint/sdk-plugin.mjs +134 -0
  24. package/lint/shardfile-boundaries.d.mts +10 -0
  25. package/lint/shardfile-boundaries.mjs +122 -0
  26. package/lint/tile-bake-debt.json +556 -0
  27. package/package.json +371 -4
  28. package/scripts/agent-parity.mjs +1524 -0
  29. package/scripts/agent-sync.mjs +518 -0
  30. package/scripts/apfs-clone.mjs +67 -0
  31. package/scripts/assert-store-layout.mjs +23 -0
  32. package/scripts/astc6-phone-cap.d.mts +3 -0
  33. package/scripts/astc6-phone-cap.mjs +137 -0
  34. package/scripts/audit-assets.d.mts +10 -0
  35. package/scripts/audit-assets.mjs +151 -0
  36. package/scripts/bake/coatFiles.d.mts +6 -0
  37. package/scripts/bake/coatFiles.mjs +37 -0
  38. package/scripts/bake/environment.d.mts +2 -0
  39. package/scripts/bake/environment.mjs +58 -0
  40. package/scripts/bake/far-proxies.mjs +45 -0
  41. package/scripts/bake/keyed-sky.d.mts +4 -0
  42. package/scripts/bake/keyed-sky.mjs +34 -0
  43. package/scripts/bake/movers.mjs +56 -0
  44. package/scripts/bake/nativeWorld.d.mts +6 -0
  45. package/scripts/bake/nativeWorld.mjs +43 -0
  46. package/scripts/bake/navmeshGround.ts +22 -0
  47. package/scripts/bake/near-placeholder.mjs +331 -0
  48. package/scripts/bake/placeholderShards.mjs +41 -0
  49. package/scripts/bake/skins.mjs +15 -0
  50. package/scripts/bake/template-skins.mjs +33 -0
  51. package/scripts/bake/viewmodelBytes.ts +26 -0
  52. package/scripts/bake/viewmodelPage.ts +11 -0
  53. package/scripts/bake/worldHost.d.mts +35 -0
  54. package/scripts/bake/worldHost.mjs +110 -0
  55. package/scripts/bake-astc6.cache.json +80 -0
  56. package/scripts/bake-astc6.far-reach.cache.json +23 -0
  57. package/scripts/bake-astc6.list.json +111 -0
  58. package/scripts/bake-astc6.mjs +279 -0
  59. package/scripts/bake-astc6.nalati-grasslands.cache.json +42 -0
  60. package/scripts/bake-catalogue.mjs +44 -0
  61. package/scripts/bake-check.mjs +54 -0
  62. package/scripts/bake-chunk.mjs +124 -0
  63. package/scripts/bake-cloud-field.mjs +24 -0
  64. package/scripts/bake-coats.mjs +110 -0
  65. package/scripts/bake-data-maps.d.mts +24 -0
  66. package/scripts/bake-data-maps.mjs +72 -0
  67. package/scripts/bake-entry-programs.mjs +117 -0
  68. package/scripts/bake-geometry.mjs +106 -0
  69. package/scripts/bake-hybrid-tiles.mjs +28 -0
  70. package/scripts/bake-ktx2.cache.json +276 -0
  71. package/scripts/bake-ktx2.list.json +365 -0
  72. package/scripts/bake-ktx2.mjs +477 -0
  73. package/scripts/bake-map-glb.mjs +127 -0
  74. package/scripts/bake-map-rest.d.mts +7 -0
  75. package/scripts/bake-map-rest.mjs +50 -0
  76. package/scripts/bake-maps.mjs +200 -0
  77. package/scripts/bake-navmesh.mjs +259 -0
  78. package/scripts/bake-packs.mjs +129 -0
  79. package/scripts/bake-pickups.mjs +102 -0
  80. package/scripts/bake-query-terrain.mjs +64 -0
  81. package/scripts/bake-recurve-pool.mjs +16 -0
  82. package/scripts/bake-section-schemas.d.mts +3 -0
  83. package/scripts/bake-template-shardfile.mjs +32 -0
  84. package/scripts/bake-textures.mjs +80 -0
  85. package/scripts/bake-viewmodel-sets.json +45 -0
  86. package/scripts/bake-viewmodel-sets.mjs +137 -0
  87. package/scripts/bake-voxel-ao.mjs +119 -0
  88. package/scripts/bake-water-ripples.mjs +25 -0
  89. package/scripts/blender/README.md +129 -0
  90. package/scripts/blender/build.sh +166 -0
  91. package/scripts/blender/lib/export-scene.mjs +129 -0
  92. package/scripts/blender/lib/glb-digest.mjs +188 -0
  93. package/scripts/blender/lib/glb.py +68 -0
  94. package/scripts/blender/lib/save_blend.py +17 -0
  95. package/scripts/blender/lib/world_fixture.py +55 -0
  96. package/scripts/blender/targets.json +591 -0
  97. package/scripts/build-sdk.mjs +95 -0
  98. package/scripts/build-shardfiles.d.mts +7 -0
  99. package/scripts/build-shardfiles.mjs +206 -0
  100. package/scripts/capture-hero.mjs +137 -0
  101. package/scripts/check-lift-review.mjs +23 -0
  102. package/scripts/chromium-keychain-check.mjs +139 -0
  103. package/scripts/chromium-keychain.d.mts +1 -0
  104. package/scripts/chromium-keychain.mjs +5 -0
  105. package/scripts/compile-script.d.mts +3 -0
  106. package/scripts/compile-script.mjs +8 -0
  107. package/scripts/creature-color.mjs +255 -0
  108. package/scripts/decide/calibrate.py +127 -0
  109. package/scripts/decide/calibration/2026-10-03/labels-s1.tsv +281 -0
  110. package/scripts/decide/calibration/2026-10-03/labels-s2.tsv +97 -0
  111. package/scripts/decide/calibration/2026-10-03/labels-s3.tsv +48 -0
  112. package/scripts/decide/calibration/2026-10-03/labels-s3b.tsv +26 -0
  113. package/scripts/decide/calibration/2026-10-03/res-capture-status-v1.jsonl +376 -0
  114. package/scripts/decide/calibration/2026-10-03/res-text-garbled-strings.jsonl +48 -0
  115. package/scripts/decide/calibration/2026-10-03/res-text-garbled-v1.jsonl +73 -0
  116. package/scripts/decide/decide.py +262 -0
  117. package/scripts/decide/decide.sh +50 -0
  118. package/scripts/decide/layer-purity-pilot.mjs +41 -0
  119. package/scripts/decide/sets/capture-status.json +46 -0
  120. package/scripts/decide/sets/layer-purity.json +28 -0
  121. package/scripts/decide/sets/text-garbled.json +17 -0
  122. package/scripts/decide/test_decide.py +37 -0
  123. package/scripts/docs.mjs +15 -0
  124. package/scripts/entry-reads/crawl.ts +152 -0
  125. package/scripts/entry-reads/tsconfig.json +25 -0
  126. package/scripts/gen-format-schema.d.mts +2 -0
  127. package/scripts/gen-format-schema.mjs +21 -0
  128. package/scripts/gen-host-catalogue.d.mts +14 -0
  129. package/scripts/gen-host-catalogue.mjs +108 -0
  130. package/scripts/gen-shard-layout-doc.d.mts +4 -0
  131. package/scripts/gen-shard-layout-doc.mjs +55 -0
  132. package/scripts/gen-shards.d.mts +17 -0
  133. package/scripts/gen-shards.mjs +311 -0
  134. package/scripts/goldens/capture-inputs.d.mts +4 -0
  135. package/scripts/goldens/capture-inputs.mjs +34 -0
  136. package/scripts/goldens/colour_shift.py +27 -0
  137. package/scripts/goldens/native-residency.d.mts +10 -0
  138. package/scripts/goldens/native-residency.mjs +104 -0
  139. package/scripts/goldens/plot-inputs.d.mts +12 -0
  140. package/scripts/goldens/plot-inputs.mjs +46 -0
  141. package/scripts/gpu-texmem.mjs +98 -0
  142. package/scripts/horizon-matte/config.py +24 -0
  143. package/scripts/horizon-matte/encode.py +91 -0
  144. package/scripts/horizon-matte/key.py +141 -0
  145. package/scripts/horizon-matte/mkjobs.py +33 -0
  146. package/scripts/horizon-matte/mkjobs_day2.py +11 -0
  147. package/scripts/horizon-matte/overlap.py +80 -0
  148. package/scripts/horizon-matte/run_codex.py +57 -0
  149. package/scripts/horizon-matte/stitch.py +133 -0
  150. package/scripts/img2mesh/CC0.md +105 -0
  151. package/scripts/img2mesh/README.md +209 -0
  152. package/scripts/img2mesh/ab_board.py +102 -0
  153. package/scripts/img2mesh/birds/birds.json +255 -0
  154. package/scripts/img2mesh/birds/birds_atlas.py +150 -0
  155. package/scripts/img2mesh/birds/birds_fix_preview.mjs +103 -0
  156. package/scripts/img2mesh/birds/birds_fix_render.py +75 -0
  157. package/scripts/img2mesh/birds/birds_pack.py +110 -0
  158. package/scripts/img2mesh/birds/birds_phone_b.py +112 -0
  159. package/scripts/img2mesh/birds/birds_post.py +550 -0
  160. package/scripts/img2mesh/birds/birds_render.py +125 -0
  161. package/scripts/img2mesh/birds/birds_sheet.py +33 -0
  162. package/scripts/img2mesh/birds/birds_view.py +60 -0
  163. package/scripts/img2mesh/board.py +100 -0
  164. package/scripts/img2mesh/build_cc0.sh +52 -0
  165. package/scripts/img2mesh/build_driftwood.sh +12 -0
  166. package/scripts/img2mesh/build_faces.sh +53 -0
  167. package/scripts/img2mesh/build_props.py +81 -0
  168. package/scripts/img2mesh/cc0_export.py +186 -0
  169. package/scripts/img2mesh/driftwood_post.py +571 -0
  170. package/scripts/img2mesh/e304_faces.sh +67 -0
  171. package/scripts/img2mesh/face_remaster.py +911 -0
  172. package/scripts/img2mesh/face_views.py +95 -0
  173. package/scripts/img2mesh/faces-e304.json +9 -0
  174. package/scripts/img2mesh/faces.json +30 -0
  175. package/scripts/img2mesh/head_cut.py +100 -0
  176. package/scripts/img2mesh/hi3d_paint.py +94 -0
  177. package/scripts/img2mesh/hi3d_refine.py +161 -0
  178. package/scripts/img2mesh/hunyuan_cpu_rasterizer.sh +42 -0
  179. package/scripts/img2mesh/pine_hollow_phone.sh +13 -0
  180. package/scripts/img2mesh/props/coral-arch.json +32 -0
  181. package/scripts/img2mesh/props/ember-furnace.json +30 -0
  182. package/scripts/img2mesh/props/night-market-gate.json +10 -0
  183. package/scripts/img2mesh/render_still.py +86 -0
  184. package/scripts/img2mesh/rig_strip.mjs +46 -0
  185. package/scripts/img2mesh/rig_transfer.mjs +104 -0
  186. package/scripts/img2mesh/split_sheet.py +48 -0
  187. package/scripts/img2mesh/trellis_batch.py +110 -0
  188. package/scripts/img2mesh/versus_board.py +114 -0
  189. package/scripts/import-bundle.d.mts +2 -0
  190. package/scripts/import-bundle.mjs +20 -0
  191. package/scripts/ktx2-ab-board.py +133 -0
  192. package/scripts/ktx2-ab.mjs +111 -0
  193. package/scripts/ktx2-settings.mjs +18 -0
  194. package/scripts/land.d.mts +14 -0
  195. package/scripts/land.mjs +809 -0
  196. package/scripts/lint-dispatch.mjs +14 -0
  197. package/scripts/map-bake-frames.d.mts +4 -0
  198. package/scripts/map-bake-frames.mjs +23 -0
  199. package/scripts/map-geometry.d.mts +9 -0
  200. package/scripts/map-geometry.mjs +29 -0
  201. package/scripts/map-world.mjs +162 -0
  202. package/scripts/mockup-local.sh +46 -0
  203. package/scripts/music/export-midi.mjs +68 -0
  204. package/scripts/music/gen/analyze.py +308 -0
  205. package/scripts/music/gen/audio_jobs.py +46 -0
  206. package/scripts/music/gen/briefs.json +51 -0
  207. package/scripts/music/gen/build_page.py +334 -0
  208. package/scripts/music/gen/folk.json +3187 -0
  209. package/scripts/music/gen/gen_ace_step.py +156 -0
  210. package/scripts/music/gen/gen_heartmula.py +187 -0
  211. package/scripts/music/gen/gen_minimax.py +143 -0
  212. package/scripts/music/gen/gen_sao.py +122 -0
  213. package/scripts/music/gen/gen_sao_small.py +104 -0
  214. package/scripts/music/gen/gen_sfx.py +98 -0
  215. package/scripts/music/gen/gen_sfx_ezaudio.py +112 -0
  216. package/scripts/music/gen/gen_sfx_moss.py +112 -0
  217. package/scripts/music/gen/models.json +61 -0
  218. package/scripts/music/gen/nalati-jobs.json +104 -0
  219. package/scripts/music/gen/nalati-score-build.json +119 -0
  220. package/scripts/music/gen/nalati-score.json +3448 -0
  221. package/scripts/music/gen/ob7-fit-decisions.json +38 -0
  222. package/scripts/music/gen/ob7-score-jobs.json +152 -0
  223. package/scripts/music/gen/ob7-sfx-jobs.json +897 -0
  224. package/scripts/music/gen/ob7_build.py +469 -0
  225. package/scripts/music/gen/ob7_generate.py +67 -0
  226. package/scripts/music/gen/ob7_run.sh +42 -0
  227. package/scripts/music/gen/orchestral.json +3187 -0
  228. package/scripts/music/gen/own_score.py +486 -0
  229. package/scripts/music/gen/ph-jobs.json +27 -0
  230. package/scripts/music/gen/ph_page.py +222 -0
  231. package/scripts/music/gen/piano.json +3175 -0
  232. package/scripts/music/gen/rank_v3.py +248 -0
  233. package/scripts/music/gen/sfx-best.json +2486 -0
  234. package/scripts/music/gen/sfx-ezaudio.json +4082 -0
  235. package/scripts/music/gen/sfx-jobs.json +57 -0
  236. package/scripts/music/gen/sfx-minimax-jobs.json +16 -0
  237. package/scripts/music/gen/sfx-minimax.json +289 -0
  238. package/scripts/music/gen/sfx-moss.json +4082 -0
  239. package/scripts/music/gen/sfx-nalati-b3-jobs.json +17 -0
  240. package/scripts/music/gen/sfx-nalati-jobs.json +338 -0
  241. package/scripts/music/gen/sfx-nalati.json +11202 -0
  242. package/scripts/music/gen/sfx-nd-jobs.json +57 -0
  243. package/scripts/music/gen/sfx-nd-moss.json +2097 -0
  244. package/scripts/music/gen/sfx-nd-sa3-medium.json +2097 -0
  245. package/scripts/music/gen/sfx-nd-summary.json +38 -0
  246. package/scripts/music/gen/sfx-peaks.json +7 -0
  247. package/scripts/music/gen/sfx-ph-jobs.json +169 -0
  248. package/scripts/music/gen/sfx-ph-moss.json +6564 -0
  249. package/scripts/music/gen/sfx-ph-sa3-medium.json +7239 -0
  250. package/scripts/music/gen/sfx-ph-summary.json +63 -0
  251. package/scripts/music/gen/sfx-sa3-medium.json +4082 -0
  252. package/scripts/music/gen/sfx-sa3.json +4082 -0
  253. package/scripts/music/gen/sfx-summary.json +107 -0
  254. package/scripts/music/gen/sfx_build.py +332 -0
  255. package/scripts/music/gen/sfx_merge.py +255 -0
  256. package/scripts/music/gen/sfx_minimax.py +61 -0
  257. package/scripts/music/gen/sfx_nalati.py +331 -0
  258. package/scripts/music/gen/sfx_sprite.py +424 -0
  259. package/scripts/music/gen/stems.py +539 -0
  260. package/scripts/music/gen/test_loop_meter.py +29 -0
  261. package/scripts/music/gen/test_ob7_provenance.py +77 -0
  262. package/scripts/music/gen/v3-folk-build.json +148 -0
  263. package/scripts/music/gen/v3-folk.json +1818 -0
  264. package/scripts/music/gen/v3-jobs.json +145 -0
  265. package/scripts/music/gen/v3-orchestral-build.json +148 -0
  266. package/scripts/music/gen/v3-orchestral.json +1813 -0
  267. package/scripts/music/gen/v3-ph-folk-build.json +94 -0
  268. package/scripts/music/gen/v3-ph-folk.json +1806 -0
  269. package/scripts/music/gen/v3-ph-orchestral-build.json +94 -0
  270. package/scripts/music/gen/v3-ph-orchestral.json +1824 -0
  271. package/scripts/music/gen/v3-ph-piano-build.json +94 -0
  272. package/scripts/music/gen/v3-ph-piano.json +1818 -0
  273. package/scripts/music/gen/v3-piano-build.json +148 -0
  274. package/scripts/music/gen/v3-piano.json +1813 -0
  275. package/scripts/music/wildshard-theme.mid +0 -0
  276. package/scripts/music/wildshard-trailer30.mid +0 -0
  277. package/scripts/named-blob-output.d.mts +8 -0
  278. package/scripts/named-blob-output.mjs +48 -0
  279. package/scripts/pack-all.mjs +15 -0
  280. package/scripts/pid-lock.d.mts +1 -0
  281. package/scripts/pid-lock.mjs +63 -0
  282. package/scripts/practice/bake_dummy.py +53 -0
  283. package/scripts/practice/build_dummies.sh +43 -0
  284. package/scripts/practice/dummy_parts.py +568 -0
  285. package/scripts/practice/dummy_rig_gate.py +139 -0
  286. package/scripts/practice/gate_sheet.py +36 -0
  287. package/scripts/practice/generate_dummy_unimate.py +132 -0
  288. package/scripts/practice/pack_dummy.mjs +59 -0
  289. package/scripts/practice/repair_dummy_weights.mjs +68 -0
  290. package/scripts/practice/rig_dummy.py +828 -0
  291. package/scripts/practice/verify_unimate_skin.mjs +356 -0
  292. package/scripts/preparation-seed.mjs +15 -0
  293. package/scripts/prepare-basis-tool.mjs +6 -0
  294. package/scripts/prepare-product.d.mts +14 -0
  295. package/scripts/prepare-product.mjs +101 -0
  296. package/scripts/product-build-tools.d.mts +3 -0
  297. package/scripts/product-build-tools.json +3 -0
  298. package/scripts/product-build-tools.mjs +31 -0
  299. package/scripts/publish-public.mjs +7 -0
  300. package/scripts/push-tables.d.mts +1 -0
  301. package/scripts/push-tables.mjs +28 -0
  302. package/scripts/record-shard-mounts.mjs +133 -0
  303. package/scripts/sdk-externals.d.mts +2 -0
  304. package/scripts/sdk-externals.mjs +2 -0
  305. package/scripts/section-inventory.ts +209 -0
  306. package/scripts/select-candidate.mjs +15 -0
  307. package/scripts/shard-build-pool.d.mts +4 -0
  308. package/scripts/shard-build-pool.mjs +53 -0
  309. package/scripts/shard-line-baseline.json +17 -0
  310. package/scripts/shard-milestones.d.mts +15 -0
  311. package/scripts/shard-milestones.mjs +105 -0
  312. package/scripts/shard-output-report.d.mts +9 -0
  313. package/scripts/shard-output-report.mjs +85 -0
  314. package/scripts/shard-platform-cli.mjs +93 -0
  315. package/scripts/shard-progress.mjs +212 -0
  316. package/scripts/shard-timelapse.py +102 -0
  317. package/scripts/shardfile-cold-boot.mjs +79 -0
  318. package/scripts/shardfile-vite.d.mts +4 -0
  319. package/scripts/shardfile-vite.mjs +20 -0
  320. package/scripts/simplify-models.mjs +24 -0
  321. package/scripts/site-facts.mjs +88 -0
  322. package/scripts/test-template-gate.mjs +44 -0
  323. package/scripts/test_golden_compare.py +68 -0
  324. package/scripts/tex-tiers.cache.json +181 -0
  325. package/scripts/tex-tiers.mjs +240 -0
  326. package/scripts/texmem-probe.mjs +184 -0
  327. package/scripts/unused-assets.mjs +173 -0
  328. package/scripts/vite-tmp.d.mts +23 -0
  329. package/scripts/vite-tmp.mjs +157 -0
  330. package/scripts/wave-line-baselines.json +32 -0
  331. package/scripts/wildshard.d.mts +4 -0
  332. package/scripts/wildshard.mjs +105 -0
  333. package/scripts/witness-checkpoints.d.mts +10 -0
  334. package/scripts/witness-checkpoints.mjs +84 -0
  335. package/scripts/witness-generation.d.mts +10 -0
  336. package/scripts/witness-generation.mjs +45 -0
  337. package/scripts/witness-manifests.d.mts +8 -0
  338. package/scripts/witness-manifests.mjs +157 -0
  339. package/scripts/worktree-ignore.d.mts +4 -0
  340. package/scripts/worktree-ignore.mjs +36 -0
  341. package/scripts/worktree-reap.mjs +214 -0
  342. package/scripts/worktree.mjs +396 -0
  343. package/scripts/worldclaw/capture-front.sh +28 -0
  344. package/scripts/worldclaw/design-template.md +62 -0
  345. package/scripts/worldclaw/spec-map.py +92 -0
  346. package/scripts/worldclaw/spec.ts +96 -0
  347. package/skills/wildshard/SKILL.md +50 -0
  348. package/skills/wildshard-goldens/SKILL.md +54 -0
  349. package/skills/wildshard-mockup-to-model/SKILL.md +56 -0
  350. package/skills/wildshard-upgrade/SKILL.md +46 -0
  351. package/src/.oxfmtrc.json +50 -0
  352. package/src/.oxlintrc.json +173 -0
  353. package/src/cli/account/account.ts +199 -0
  354. package/src/cli/account/command.ts +193 -0
  355. package/src/cli/account/key.ts +154 -0
  356. package/src/cli/args.ts +97 -0
  357. package/src/cli/audio/audio.ts +24 -0
  358. package/src/cli/bin.mjs +8 -0
  359. package/src/cli/delete/delete.ts +258 -0
  360. package/src/cli/help.ts +196 -0
  361. package/src/cli/hero/adopt.ts +103 -0
  362. package/src/cli/hero/hero.ts +112 -0
  363. package/src/cli/hero/stamp.ts +298 -0
  364. package/src/cli/main.ts +292 -0
  365. package/src/cli/report.ts +16 -0
  366. package/src/cli/shardfile/command.ts +50 -0
  367. package/src/cli/shardfile/shardfile.ts +192 -0
  368. package/src/cli/upload/api.ts +246 -0
  369. package/src/cli/upload/compress.ts +55 -0
  370. package/src/cli/upload/hero.ts +62 -0
  371. package/src/cli/upload/placement.ts +115 -0
  372. package/src/cli/upload/provenance.ts +192 -0
  373. package/src/cli/upload/signature.ts +30 -0
  374. package/src/cli/upload/upload.ts +269 -0
  375. package/src/cli/upload/validate.ts +74 -0
  376. package/src/cli/upload/wire.ts +147 -0
  377. package/src/cli/version.ts +63 -0
  378. package/src/commons/bake/portableMath.ts +187 -0
  379. package/src/commons/catalogue.ts +10 -0
  380. package/src/commons/courseProgram.ts +32 -0
  381. package/src/commons/practiceCourse.ts +16 -0
  382. package/src/commons/scripts/abi.as +14 -0
  383. package/src/commons/scripts/bridge.as +14 -0
  384. package/src/commons/scripts/course.as +63 -0
  385. package/src/scripts/ask-new.sh +29 -0
  386. package/src/scripts/asks.mjs +141 -0
  387. package/src/scripts/herdr-prompt.sh +34 -0
  388. package/src/scripts/herdr-question-open.sh +67 -0
  389. package/src/scripts/md-wrap.mjs +229 -0
  390. package/src/server/app.ts +19 -0
  391. package/src/server/serve.ts +49 -0
  392. package/src/sharddev/admission.ts +7 -0
  393. package/src/sharddev/arenaView.ts +15 -0
  394. package/src/sharddev/as/groupBankV2.ts +36 -0
  395. package/src/sharddev/as/groupStepV2.ts +13 -0
  396. package/src/sharddev/as/ws.ts +30 -0
  397. package/src/sharddev/as/wsV2.ts +180 -0
  398. package/src/sharddev/assemblyscriptCompiler.d.mts +5 -0
  399. package/src/sharddev/assemblyscriptCompiler.mjs +14 -0
  400. package/src/sharddev/assetHandle.ts +84 -0
  401. package/src/sharddev/assetOwner.ts +70 -0
  402. package/src/sharddev/assetScope.ts +30 -0
  403. package/src/sharddev/assets.ts +21 -0
  404. package/src/sharddev/audio.ts +9 -0
  405. package/src/sharddev/audioEncode.ts +211 -0
  406. package/src/sharddev/author.ts +3 -0
  407. package/src/sharddev/authorError.ts +28 -0
  408. package/src/sharddev/authorManifest.ts +39 -0
  409. package/src/sharddev/bake/annulus.ts +19 -0
  410. package/src/sharddev/bake/assemblyscriptMemo.ts +76 -0
  411. package/src/sharddev/bake/assemblyscriptMemoPort.ts +4 -0
  412. package/src/sharddev/bake/authoredWorld.ts +201 -0
  413. package/src/sharddev/bake/basisEncoder.ts +95 -0
  414. package/src/sharddev/bake/basisGlb.ts +85 -0
  415. package/src/sharddev/bake/basisTool.ts +74 -0
  416. package/src/sharddev/bake/basisToolInputs.ts +476 -0
  417. package/src/sharddev/bake/byteCodec.ts +33 -0
  418. package/src/sharddev/bake/canvasAtlas.ts +406 -0
  419. package/src/sharddev/bake/coarseCopy.ts +59 -0
  420. package/src/sharddev/bake/colliders.ts +87 -0
  421. package/src/sharddev/bake/compactGlb.ts +224 -0
  422. package/src/sharddev/bake/compileScript.ts +119 -0
  423. package/src/sharddev/bake/compileScriptV2.ts +75 -0
  424. package/src/sharddev/bake/contactRows.ts +84 -0
  425. package/src/sharddev/bake/creaturePlacement.ts +117 -0
  426. package/src/sharddev/bake/export.ts +67 -0
  427. package/src/sharddev/bake/facetedGeometry.ts +379 -0
  428. package/src/sharddev/bake/farImpostor.ts +120 -0
  429. package/src/sharddev/bake/forest.ts +100 -0
  430. package/src/sharddev/bake/format-hook.mjs +2 -0
  431. package/src/sharddev/bake/generatorGlb.ts +23 -0
  432. package/src/sharddev/bake/geometryBounds.ts +77 -0
  433. package/src/sharddev/bake/geometryError.ts +48 -0
  434. package/src/sharddev/bake/glb.ts +355 -0
  435. package/src/sharddev/bake/glbCompression.ts +143 -0
  436. package/src/sharddev/bake/gltfSource.ts +59 -0
  437. package/src/sharddev/bake/groundMap.ts +142 -0
  438. package/src/sharddev/bake/image.ts +20 -0
  439. package/src/sharddev/bake/isleMap.ts +64 -0
  440. package/src/sharddev/bake/json.mjs +84 -0
  441. package/src/sharddev/bake/keyedSky.ts +47 -0
  442. package/src/sharddev/bake/keyedSkyMemo.ts +39 -0
  443. package/src/sharddev/bake/kinds.ts +137 -0
  444. package/src/sharddev/bake/lightSources.ts +31 -0
  445. package/src/sharddev/bake/mapAssembly.ts +84 -0
  446. package/src/sharddev/bake/mapRaster.ts +173 -0
  447. package/src/sharddev/bake/mapRest.ts +57 -0
  448. package/src/sharddev/bake/mapScenes.ts +234 -0
  449. package/src/sharddev/bake/materialGraph.ts +32 -0
  450. package/src/sharddev/bake/meadow.ts +27 -0
  451. package/src/sharddev/bake/meshoptChoiceMemo.ts +34 -0
  452. package/src/sharddev/bake/nativeInteractionFacts.ts +5 -0
  453. package/src/sharddev/bake/nativeLattice.ts +178 -0
  454. package/src/sharddev/bake/nativeRaster.ts +106 -0
  455. package/src/sharddev/bake/nativeTerrainField.ts +11 -0
  456. package/src/sharddev/bake/navigation-json.mjs +38 -0
  457. package/src/sharddev/bake/navigation.ts +113 -0
  458. package/src/sharddev/bake/navigationAsset.ts +18 -0
  459. package/src/sharddev/bake/nearPlaceholder.ts +206 -0
  460. package/src/sharddev/bake/normalizeRig.ts +80 -0
  461. package/src/sharddev/bake/phoneAstc.ts +93 -0
  462. package/src/sharddev/bake/placeholders.ts +581 -0
  463. package/src/sharddev/bake/placement.ts +80 -0
  464. package/src/sharddev/bake/portableBytes.ts +18 -0
  465. package/src/sharddev/bake/portableBytesMemo.ts +50 -0
  466. package/src/sharddev/bake/practiceCourse.ts +49 -0
  467. package/src/sharddev/bake/primitives.ts +96 -0
  468. package/src/sharddev/bake/props.ts +443 -0
  469. package/src/sharddev/bake/questPlacement.ts +98 -0
  470. package/src/sharddev/bake/rawTexture.ts +26 -0
  471. package/src/sharddev/bake/riderArms.ts +97 -0
  472. package/src/sharddev/bake/rig.ts +95 -0
  473. package/src/sharddev/bake/riggedHullRecipes.ts +40 -0
  474. package/src/sharddev/bake/signPlacements.ts +25 -0
  475. package/src/sharddev/bake/simplifier.ts +52 -0
  476. package/src/sharddev/bake/skinned.ts +312 -0
  477. package/src/sharddev/bake/slabChunks.ts +149 -0
  478. package/src/sharddev/bake/slabs.ts +263 -0
  479. package/src/sharddev/bake/source-loader.mjs +55 -0
  480. package/src/sharddev/bake/sourceMetadata.ts +54 -0
  481. package/src/sharddev/bake/species.ts +368 -0
  482. package/src/sharddev/bake/specimenCatalogue.ts +47 -0
  483. package/src/sharddev/bake/splatGround.ts +141 -0
  484. package/src/sharddev/bake/staticMaterials.ts +171 -0
  485. package/src/sharddev/bake/terrain.ts +195 -0
  486. package/src/sharddev/bake/texture.ts +33 -0
  487. package/src/sharddev/bake/textureWasm.ts +81 -0
  488. package/src/sharddev/bake/tileEncoder.ts +11 -0
  489. package/src/sharddev/bake/tileGrid.ts +62 -0
  490. package/src/sharddev/bake/v2Finite.ts +160 -0
  491. package/src/sharddev/bake/v2Fuel.ts +71 -0
  492. package/src/sharddev/bake/wholePartition.ts +74 -0
  493. package/src/sharddev/bake/wholePieceJoin.ts +147 -0
  494. package/src/sharddev/bake/world.ts +173 -0
  495. package/src/sharddev/bake/worldCollision.ts +128 -0
  496. package/src/sharddev/bake/worldGeometry.ts +237 -0
  497. package/src/sharddev/bake/worldGlb.ts +123 -0
  498. package/src/sharddev/bake/worldImage.ts +12 -0
  499. package/src/sharddev/bake/worldLod.ts +128 -0
  500. package/src/sharddev/bake/worldRows.ts +102 -0
  501. package/src/sharddev/bake/worldTextureMemo.ts +63 -0
  502. package/src/sharddev/bake/zstdBytesMemo.ts +52 -0
  503. package/src/sharddev/bake.ts +193 -0
  504. package/src/sharddev/bakePublication.ts +31 -0
  505. package/src/sharddev/behaviourSource.ts +94 -0
  506. package/src/sharddev/bin/wildshard.mjs +7 -0
  507. package/src/sharddev/blobBytes.ts +65 -0
  508. package/src/sharddev/blobs.ts +138 -0
  509. package/src/sharddev/bootInventory.ts +129 -0
  510. package/src/sharddev/bossProfiles.ts +18 -0
  511. package/src/sharddev/buildBehaviour.ts +77 -0
  512. package/src/sharddev/buildCacheMetrics.ts +17 -0
  513. package/src/sharddev/buildDecisionScripts.ts +122 -0
  514. package/src/sharddev/check.ts +117 -0
  515. package/src/sharddev/checkProject.ts +126 -0
  516. package/src/sharddev/cli.ts +191 -0
  517. package/src/sharddev/clientChannels.ts +169 -0
  518. package/src/sharddev/clientScripts.ts +10 -0
  519. package/src/sharddev/commons.ts +77 -0
  520. package/src/sharddev/commonsCosts.ts +11 -0
  521. package/src/sharddev/compileMovers.ts +11 -0
  522. package/src/sharddev/configBoundary.ts +6 -0
  523. package/src/sharddev/cookInput.ts +40 -0
  524. package/src/sharddev/crowds.ts +6 -0
  525. package/src/sharddev/decisionBindingMap.ts +11 -0
  526. package/src/sharddev/decisionScriptBindings.ts +117 -0
  527. package/src/sharddev/decisionScripts.ts +28 -0
  528. package/src/sharddev/decisionSource.ts +51 -0
  529. package/src/sharddev/dev.ts +113 -0
  530. package/src/sharddev/director.ts +26 -0
  531. package/src/sharddev/directorAbi.ts +77 -0
  532. package/src/sharddev/discoveryDocument.ts +97 -0
  533. package/src/sharddev/draft.ts +11 -0
  534. package/src/sharddev/eliteEntryRows.ts +29 -0
  535. package/src/sharddev/entries.ts +76 -0
  536. package/src/sharddev/entryReads.ts +73 -0
  537. package/src/sharddev/executeBundle.ts +55 -0
  538. package/src/sharddev/finds.ts +5 -0
  539. package/src/sharddev/formatJsonSchema.ts +3 -0
  540. package/src/sharddev/generationCache.ts +257 -0
  541. package/src/sharddev/generationRecipe.ts +94 -0
  542. package/src/sharddev/handwritten.ts +110 -0
  543. package/src/sharddev/immutable.ts +14 -0
  544. package/src/sharddev/interactions.ts +38 -0
  545. package/src/sharddev/kit/bakedGeometry.ts +16 -0
  546. package/src/sharddev/kit/geometryPack.ts +110 -0
  547. package/src/sharddev/ledger.ts +13 -0
  548. package/src/sharddev/looks/tileField.ts +67 -0
  549. package/src/sharddev/materialGraphFiles.ts +57 -0
  550. package/src/sharddev/materials.ts +574 -0
  551. package/src/sharddev/measure.ts +18 -0
  552. package/src/sharddev/modes.ts +115 -0
  553. package/src/sharddev/moverPrograms.ts +213 -0
  554. package/src/sharddev/movers.ts +75 -0
  555. package/src/sharddev/nativePopulationRows.ts +46 -0
  556. package/src/sharddev/newProject.ts +247 -0
  557. package/src/sharddev/noise.ts +54 -0
  558. package/src/sharddev/outputProduct.ts +188 -0
  559. package/src/sharddev/outputRuntime.ts +66 -0
  560. package/src/sharddev/performancePolicy.ts +18 -0
  561. package/src/sharddev/phasedBoss.ts +34 -0
  562. package/src/sharddev/physics.ts +194 -0
  563. package/src/sharddev/platformSections.ts +42 -0
  564. package/src/sharddev/plumbing.ts +8 -0
  565. package/src/sharddev/productOutput.ts +128 -0
  566. package/src/sharddev/project.ts +337 -0
  567. package/src/sharddev/projectCompilerIdentity.ts +94 -0
  568. package/src/sharddev/projectDecisions.ts +66 -0
  569. package/src/sharddev/projectEntryProof.ts +32 -0
  570. package/src/sharddev/projectGeneration.ts +219 -0
  571. package/src/sharddev/projectInputFiles.ts +47 -0
  572. package/src/sharddev/projectManifest.ts +108 -0
  573. package/src/sharddev/projectMap.ts +35 -0
  574. package/src/sharddev/projectOutput.ts +242 -0
  575. package/src/sharddev/projectPolicy.ts +17 -0
  576. package/src/sharddev/projectSections.ts +27 -0
  577. package/src/sharddev/questGraph.ts +25 -0
  578. package/src/sharddev/quests.ts +65 -0
  579. package/src/sharddev/random.ts +61 -0
  580. package/src/sharddev/refusals.ts +234 -0
  581. package/src/sharddev/reportCard.ts +13 -0
  582. package/src/sharddev/returnProjectionV2.ts +81 -0
  583. package/src/sharddev/rows.ts +192 -0
  584. package/src/sharddev/runtimeImports.ts +38 -0
  585. package/src/sharddev/runtimeMirrors.ts +39 -0
  586. package/src/sharddev/runtimePerformance.ts +38 -0
  587. package/src/sharddev/scene.ts +321 -0
  588. package/src/sharddev/sceneAnimation.ts +54 -0
  589. package/src/sharddev/sceneAudio.ts +64 -0
  590. package/src/sharddev/sceneDeclarations.ts +100 -0
  591. package/src/sharddev/sceneGraph.ts +139 -0
  592. package/src/sharddev/sceneTransform.ts +12 -0
  593. package/src/sharddev/schemaValidation.ts +61 -0
  594. package/src/sharddev/sections.ts +47 -0
  595. package/src/sharddev/shardSource.ts +59 -0
  596. package/src/sharddev/sourceReader.ts +26 -0
  597. package/src/sharddev/spawns.ts +38 -0
  598. package/src/sharddev/species/clips.ts +24 -0
  599. package/src/sharddev/species.ts +29 -0
  600. package/src/sharddev/speciesBrains.ts +19 -0
  601. package/src/sharddev/synth.ts +66 -0
  602. package/src/sharddev/test/compileDualScriptV2.ts +71 -0
  603. package/src/sharddev/test/compileSimV2.ts +21 -0
  604. package/src/sharddev/test/diskScriptScenario.ts +86 -0
  605. package/src/sharddev/test/scriptScenario.ts +249 -0
  606. package/src/sharddev/test/scriptSource.ts +12 -0
  607. package/src/sharddev/version.ts +4 -0
  608. package/src/sharddev/weapons/bowProfile.ts +20 -0
  609. package/src/sharddev/weapons/firearmRows.ts +11 -0
  610. package/src/sharddev/weapons/meleeProfile.ts +71 -0
  611. package/src/sharddev/weapons/thrownProfile.ts +10 -0
  612. package/src/sharddev/worldScenes.ts +308 -0
  613. package/src/sharddev/worldSource.ts +82 -0
  614. package/src/shards/_template/README.md +78 -0
  615. package/src/shards/_template/assets/2bf489fdb15f1734ddb4c4f32d500ec6da85c765ec7a4eb28dc6781160e7ec8c +0 -0
  616. package/src/shards/_template/assets/97ec4d8f75f5fa6239ee919444d6dc19fd35896bb305930c1f050ac6e0e0e6a6 +1 -0
  617. package/src/shards/_template/assets/a6a587a31327f936b1b04c05ade818c73fc8964260918662db43539465e27586 +0 -0
  618. package/src/shards/_template/assets/b4fbde0422e125b498c3dc8b9a5cc2516c8598f09e9d0e5f6b639b32f98179e6 +0 -0
  619. package/src/shards/_template/assets/bfa4dfc9c18979f904557ee8deab0058b8a399be10266f5fb1578b403f482fd4 +1 -0
  620. package/src/shards/_template/assets/ef3b7ff4fd22715771cb7d68a3977a903c5e7c3dc293542687d04b3ef3ace2cb +0 -0
  621. package/src/shards/_template/assets/f2db05998615ce1cb79ea96be32c168842eb6a2b34ec01feb86d36404603ee54 +0 -0
  622. package/src/shards/_template/assets/fef98ebb7fce6f66b26e78ac699e5c90f9bdcfaf8cabeb2b58125347eea8b4ab +0 -0
  623. package/src/shards/_template/behaviour/boss.as +39 -0
  624. package/src/shards/_template/behaviour/door.as +32 -0
  625. package/src/shards/_template/behaviour/hooks.json +129 -0
  626. package/src/shards/_template/behaviour/idle.as +75 -0
  627. package/src/shards/_template/behaviour/items.as +22 -0
  628. package/src/shards/_template/card/landscape.jpg +0 -0
  629. package/src/shards/_template/card/portrait.jpg +0 -0
  630. package/src/shards/_template/card/thumb.jpg +0 -0
  631. package/src/shards/_template/data/audio.json +45 -0
  632. package/src/shards/_template/data/bossDecision.json +83 -0
  633. package/src/shards/_template/data/budgets.json +70 -0
  634. package/src/shards/_template/data/card.json +281 -0
  635. package/src/shards/_template/data/clientScripts.json +987 -0
  636. package/src/shards/_template/data/creatures.json +65 -0
  637. package/src/shards/_template/data/director.json +39 -0
  638. package/src/shards/_template/data/encounters.json +96 -0
  639. package/src/shards/_template/data/items.json +172 -0
  640. package/src/shards/_template/data/layout.json +66 -0
  641. package/src/shards/_template/data/ledger.json +32 -0
  642. package/src/shards/_template/data/look.json +521 -0
  643. package/src/shards/_template/data/map.json +64 -0
  644. package/src/shards/_template/data/moves.json +16 -0
  645. package/src/shards/_template/data/placeholder.json +8 -0
  646. package/src/shards/_template/data/plumbing.json +32 -0
  647. package/src/shards/_template/data/quests.json +223 -0
  648. package/src/shards/_template/data/rows.json +423 -0
  649. package/src/shards/_template/data/skins.json +66 -0
  650. package/src/shards/_template/data/spawn.json +6 -0
  651. package/src/shards/_template/data/targets.json +150 -0
  652. package/src/shards/_template/data/text.json +12 -0
  653. package/src/shards/_template/data/ui.json +33 -0
  654. package/src/shards/_template/data/water.json +13 -0
  655. package/src/shards/_template/generators/behaviour.ts +34 -0
  656. package/src/shards/_template/generators/boss.ts +29 -0
  657. package/src/shards/_template/generators/buildOptions.ts +2 -0
  658. package/src/shards/_template/generators/cell.ts +224 -0
  659. package/src/shards/_template/generators/districts.ts +215 -0
  660. package/src/shards/_template/generators/farLook.ts +15 -0
  661. package/src/shards/_template/generators/generate.ts +27 -0
  662. package/src/shards/_template/generators/ground.ts +15 -0
  663. package/src/shards/_template/generators/kit.ts +69 -0
  664. package/src/shards/_template/generators/landscape.ts +59 -0
  665. package/src/shards/_template/generators/landscapeNoise.ts +62 -0
  666. package/src/shards/_template/generators/mapInputs.ts +10 -0
  667. package/src/shards/_template/generators/product.ts +100 -0
  668. package/src/shards/_template/generators/productOutput.ts +18 -0
  669. package/src/shards/_template/generators/props.ts +9 -0
  670. package/src/shards/_template/generators/templatePropsSource.ts +58 -0
  671. package/src/shards/_template/generators/terrain.ts +17 -0
  672. package/src/shards/_template/generators/world.ts +630 -0
  673. package/src/shards/_template/hero.json +10 -0
  674. package/src/shards/_template/look/entry-reads.json +20 -0
  675. package/src/shards/_template/manifest.json +281 -0
  676. package/src/shards/_template/shard.config.ts +10 -0
  677. package/src/shared/health.ts +10 -0
  678. package/src/tools/build-web.ts +59 -0
  679. package/src/tsconfig.json +30 -0
  680. package/src/web/app.tsx +53 -0
  681. package/src/web/index.html +12 -0
  682. package/src/web/main.tsx +10 -0
  683. package/src/web/tsconfig.json +13 -0
  684. package/tsconfig.author.json +23 -0
  685. package/tsconfig.commons.json +21 -0
  686. package/tsconfig.json +47 -0
  687. package/tsconfig.sharddev.json +20 -0
@@ -0,0 +1,120 @@
1
+ import type { BufferGeometry } from 'three';
2
+ import type { FarImpostor } from '@wildshard/format/shardSections';
3
+ import { ROAD_SKY } from '@wildshard/engine/game/grid/frameModel';
4
+ import { FAR_CLIFF_FLOOR } from '@wildshard/engine/game/grid/farView';
5
+ import { writeImagePixels } from './image';
6
+
7
+ /**
8
+ * G539 (Jake: *"we need to have a different far layout rendering option for really distant things"*): the far tier's
9
+ * camera-facing impostor, baked at build time beside the far proxy from the proxy itself. A software rasteriser (no GPU,
10
+ * no DOM) renders the proxy from `views` compass directions, orthographic and almost level (the road's eye on a cell
11
+ * kilometres away), under the road's own key light and fill (`ROAD_SKY`, G165: everything outside the cell you stand in
12
+ * is under the road light, and only there does the far tier draw). Each tile holds the lit colour sRGB-encoded over
13
+ * `range` and dithered to 5 bits a channel, with a 1-bit coverage alpha, so the runtime packs it to RGBA 5551 losslessly
14
+ * (`farView.ts`: 2 bytes a texel). Deterministic: the same proxy gives the same bytes. Nothing here knows a shard.
15
+ */
16
+ export const FAR_IMPOSTOR_BAKE = { views: 8, cols: 2, tile: [256, 64] as const, elevation: 1, range: 3, supersample: 2, margin: 2 } as const;
17
+
18
+ /** The proxy's look family: toon draws flat facets, the others their vertex normals. */
19
+ export type FarImpostorFamily = 'toon' | 'painterly' | 'pbr';
20
+ /** One baked impostor: its row (without its file reference), the PNG and its GPU texels (RGBA 5551). */
21
+ export interface FarImpostorBake { readonly row: Omit<FarImpostor, 'file'>; readonly png: Uint8Array; readonly gpu: number }
22
+
23
+ const BAYER = [0, 8, 2, 10, 12, 4, 14, 6, 3, 11, 1, 9, 15, 7, 13, 5] as const;
24
+ const encode = (linear: number): number => (linear <= 0.0031308 ? 12.92 * linear : 1.055 * linear ** (1 / 2.4) - 0.055);
25
+
26
+ /**
27
+ * The road light on a surface normal as the proxy's own material lights it: three's Lambert (the hemisphere fill plus the
28
+ * key light, each through BRDF_Lambert's 1 / π), the boundary face's light floor (`FAR_CLIFF_FLOOR`, emissive) on a cliff.
29
+ */
30
+ function lit(albedo: readonly [number, number, number], nx: number, ny: number, nz: number, family: FarImpostorFamily, cliff: boolean): [number, number, number] {
31
+ const { sun, hemi } = ROAD_SKY, az = sun.azimuth * Math.PI / 180, el = sun.elevation * Math.PI / 180;
32
+ const lx = -Math.sin(az) * Math.cos(el), ly = Math.sin(el), lz = Math.cos(az) * Math.cos(el);
33
+ const k = Math.max(0, nx * lx + ny * ly + nz * lz) * sun.intensity, h = 0.5 + 0.5 * ny;
34
+ // a pbr proxy also takes the environment (`ROAD_SKY.env`): a grey fill standing in for it
35
+ const env = family === 'pbr' ? ROAD_SKY.env * 0.35 : 0;
36
+ return [0, 1, 2].map((i) => {
37
+ const sky = hemi.sky[i] ?? 0, ground = hemi.ground[i] ?? 0;
38
+ return (albedo[i] ?? 0) * (((ground + (sky - ground) * h) * hemi.intensity + (sun.colour[i] ?? 0) * k) / Math.PI + env + (cliff ? FAR_CLIFF_FLOOR : 0));
39
+ }) as [number, number, number];
40
+ }
41
+
42
+ /** Bake the impostor of a far proxy geometry (position, normal, color; indexed or not), in the cell's frame. */
43
+ export async function bakeFarImpostor(geometry: BufferGeometry, family: FarImpostorFamily): Promise<FarImpostorBake> {
44
+ const B = FAR_IMPOSTOR_BAKE, [tw, th] = B.tile, ss = B.supersample, W = tw * ss, H = th * ss, rows = Math.ceil(B.views / B.cols);
45
+ const cliffs = geometry.hasAttribute('uv') ? geometry.getAttribute('uv') : null;
46
+ const position = geometry.getAttribute('position'), normal = geometry.hasAttribute('normal') ? geometry.getAttribute('normal') : null, colour = geometry.hasAttribute('color') ? geometry.getAttribute('color') : null;
47
+ const index = geometry.getIndex(), count = index === null ? position.count : index.count;
48
+ const vertex = (i: number): number => (index === null ? i : index.getX(i));
49
+ const el = B.elevation * Math.PI / 180, ce = Math.cos(el), se = Math.sin(el);
50
+ // view k is seen from azimuth a (the camera at (sin a, ·, cos a) of the cell): screen right (cos a, 0, −sin a), screen up and depth
51
+ const frames = Array.from({ length: B.views }, (_, k) => {
52
+ const a = (k / B.views) * Math.PI * 2, sa = Math.sin(a), ca = Math.cos(a);
53
+ return { right: [ca, 0, -sa], up: [-se * sa, ce, -se * ca], forward: [-ce * sa, -se, -ce * ca] } as const;
54
+ });
55
+ const project = (f: (typeof frames)[number], x: number, y: number, z: number): [number, number, number] =>
56
+ [f.right[0] * x + f.right[2] * z, f.up[0] * x + f.up[1] * y + f.up[2] * z, f.forward[0] * x + f.forward[1] * y + f.forward[2] * z];
57
+ // one frame for every view: the widest half-width and the lowest and highest screen heights
58
+ let half = 0, bottom = Infinity, top = -Infinity;
59
+ for (const f of frames) for (let v = 0; v < position.count; v++) {
60
+ const [sx, sy] = project(f, position.getX(v), position.getY(v), position.getZ(v));
61
+ half = Math.max(half, Math.abs(sx)); bottom = Math.min(bottom, sy); top = Math.max(top, sy);
62
+ }
63
+ if (!Number.isFinite(half) || !(top > bottom)) throw new Error('Far impostor needs a proxy with extent');
64
+ const width = 2 * (half + B.margin);
65
+ bottom -= B.margin; top += B.margin;
66
+ const atlas = new Uint8ClampedArray(B.cols * tw * rows * th * 4);
67
+ const rgb = new Float32Array(W * H * 3), depth = new Float32Array(W * H), cover = new Uint8Array(W * H);
68
+ for (let k = 0; k < B.views; k++) {
69
+ const f = frames[k]; if (f === undefined) continue;
70
+ depth.fill(Infinity); cover.fill(0); rgb.fill(0);
71
+ for (let t = 0; t + 2 < count; t += 3) {
72
+ const ids = [vertex(t), vertex(t + 1), vertex(t + 2)];
73
+ const p = ids.map((v) => project(f, position.getX(v), position.getY(v), position.getZ(v)));
74
+ const [p0, p1, p2] = p; if (p0 === undefined || p1 === undefined || p2 === undefined) continue;
75
+ // the facet's colour: its vertices' mean albedo under the road light, by its face normal (toon) or mean vertex normal
76
+ const w = ids.map((v) => [position.getX(v), position.getY(v), position.getZ(v)] as const);
77
+ const [w0, w1, w2] = w; if (w0 === undefined || w1 === undefined || w2 === undefined) continue;
78
+ let nx: number, ny: number, nz: number;
79
+ if (family === 'toon' || normal === null) {
80
+ const ux = w1[0] - w0[0], uy = w1[1] - w0[1], uz = w1[2] - w0[2], vx = w2[0] - w0[0], vy = w2[1] - w0[1], vz = w2[2] - w0[2];
81
+ nx = uy * vz - uz * vy; ny = uz * vx - ux * vz; nz = ux * vy - uy * vx;
82
+ } else { nx = 0; ny = 0; nz = 0; for (const v of ids) { nx += normal.getX(v); ny += normal.getY(v); nz += normal.getZ(v); } }
83
+ const len = Math.hypot(nx, ny, nz) || 1;
84
+ const albedo: [number, number, number] = [0, 1, 2].map((c) => ids.reduce((sum, v) => sum + (colour === null ? 0.6 : colour.getComponent(v, c)), 0) / 3) as [number, number, number];
85
+ const shade = lit(albedo, nx / len, ny / len, nz / len, family, cliffs !== null && ids.every((v) => cliffs.getY(v) > 0.5));
86
+ // screen pixels (y down), then a depth-tested edge-function fill
87
+ const px = p.map(([sx, sy, sz]) => [(sx / width + 0.5) * W, (top - sy) / (top - bottom) * H, sz] as const);
88
+ const [a, b, c] = px; if (a === undefined || b === undefined || c === undefined) continue;
89
+ const area = (b[0] - a[0]) * (c[1] - a[1]) - (b[1] - a[1]) * (c[0] - a[0]);
90
+ if (Math.abs(area) < 1e-9) continue;
91
+ const x0 = Math.max(0, Math.floor(Math.min(a[0], b[0], c[0]))), x1 = Math.min(W - 1, Math.ceil(Math.max(a[0], b[0], c[0])));
92
+ const y0 = Math.max(0, Math.floor(Math.min(a[1], b[1], c[1]))), y1 = Math.min(H - 1, Math.ceil(Math.max(a[1], b[1], c[1])));
93
+ for (let y = y0; y <= y1; y++) for (let x = x0; x <= x1; x++) {
94
+ const qx = x + 0.5, qy = y + 0.5;
95
+ const e0 = ((b[0] - qx) * (c[1] - qy) - (b[1] - qy) * (c[0] - qx)) / area, e1 = ((c[0] - qx) * (a[1] - qy) - (c[1] - qy) * (a[0] - qx)) / area, e2 = 1 - e0 - e1;
96
+ if (e0 < 0 || e1 < 0 || e2 < 0) continue;
97
+ const z = e0 * a[2] + e1 * b[2] + e2 * c[2], i = y * W + x;
98
+ if (z >= (depth[i] ?? Infinity)) continue;
99
+ depth[i] = z; cover[i] = 1; rgb[i * 3] = shade[0]; rgb[i * 3 + 1] = shade[1]; rgb[i * 3 + 2] = shade[2];
100
+ }
101
+ }
102
+ // resolve the supersamples into the tile: covered mean colour, half coverage or more is opaque; dither to 5 bits
103
+ const ox = (k % B.cols) * tw, oy = Math.floor(k / B.cols) * th;
104
+ for (let y = 0; y < th; y++) for (let x = 0; x < tw; x++) {
105
+ let n = 0, r = 0, g = 0, bl = 0;
106
+ for (let dy = 0; dy < ss; dy++) for (let dx = 0; dx < ss; dx++) {
107
+ const i = (y * ss + dy) * W + x * ss + dx;
108
+ if (cover[i] !== 1) continue;
109
+ n++; r += rgb[i * 3] ?? 0; g += rgb[i * 3 + 1] ?? 0; bl += rgb[i * 3 + 2] ?? 0;
110
+ }
111
+ const o = ((oy + y) * B.cols * tw + ox + x) * 4, d = ((BAYER[(y % 4) * 4 + (x % 4)] ?? 0) + 0.5) / 16;
112
+ if (n * 2 < ss * ss) continue;
113
+ const q = (value: number): number => Math.min(31, Math.floor(encode(Math.min(1, Math.max(0, value / n / B.range))) * 31 + d)) * 255 / 31;
114
+ atlas[o] = q(r); atlas[o + 1] = q(g); atlas[o + 2] = q(bl); atlas[o + 3] = 255;
115
+ }
116
+ }
117
+ const png = await writeImagePixels({ width: B.cols * tw, height: rows * th, pixels: atlas });
118
+ const round = (n: number): number => Math.round(n * 100) / 100;
119
+ return { row: { views: B.views, cols: B.cols, tile: [tw, th], width: round(width), bottom: round(bottom), top: round(top), range: B.range }, png, gpu: B.cols * tw * rows * th * 2 };
120
+ }
@@ -0,0 +1,100 @@
1
+ import { canopyMapOf, placeForest, type ForestPlacementSource, type PlantSpec } from '@wildshard/engine/world/forest/placement';
2
+ import { buildTerrainMetadata } from '@wildshard/engine/world/terrainField';
3
+ import type { ForestSpec, TerrainSpec } from '@wildshard/engine/level/data';
4
+ import { readNativeTerrain } from './terrain';
5
+ import { TreeSetSchema } from '@wildshard/format/treeSetRows';
6
+ import { ManifestMetadataSchema } from '@wildshard/format/minimap';
7
+ import * as v from 'valibot';
8
+ import { TREE_SPECS } from '@wildshard/engine/world/forest/treeSpec';
9
+
10
+ /** Native ordered default tree geometry traits used by forest placement. */
11
+ export function forestDefaultTreeSpecs(): typeof TREE_SPECS { return TREE_SPECS; }
12
+
13
+ /** Ordered planting traits accepted by the native forest placement law. */
14
+ export type NativeForestSpecies = NonNullable<NonNullable<ForestPlacementSource['forest']>['speciesTraits']>[number];
15
+
16
+ /** Admit an authored tree pool, material slots and ordered variants before publication. */
17
+ export function treeSetRows(input: unknown): v.InferOutput<typeof TreeSetSchema> { return v.parse(TreeSetSchema, input); }
18
+
19
+ /** Owned native tree data; no live color, scene or geometry object enters an author result. */
20
+ export interface NativeForestTree {
21
+ readonly x: number; readonly y: number; readonly z: number; readonly r: number;
22
+ readonly variant: number; readonly scale: number; readonly rot: number; readonly height: number;
23
+ readonly species?: string;
24
+ readonly tint: readonly [number, number, number];
25
+ }
26
+
27
+ /** A build's ordered trees and the original padded trunk query over those same owned records. */
28
+ export interface NativeForestPlacements {
29
+ readonly trees: readonly NativeForestTree[];
30
+ readonly nearby: (x: number, z: number, radius?: number) => readonly NativeForestTree[];
31
+ }
32
+
33
+ /** Bake the existing forest algorithm from trusted explicit policy and native samplers.
34
+ * Return detached numeric records with stable query identity; never select a page or install terrain.
35
+ * The caller owns the result and includes every supplied policy/sampler in its native source cache key. */
36
+ export function bakeForestPlacements(source: ForestPlacementSource, variants: readonly PlantSpec[]): NativeForestPlacements {
37
+ const native = placeForest(variants, source), trees: NativeForestTree[] = [];
38
+ const owned = new Map<(typeof native.trees)[number], NativeForestTree>();
39
+ for (const tree of native.trees) {
40
+ const { tint, species, ...data } = tree;
41
+ const row: NativeForestTree = { ...data, ...(species === undefined ? {} : { species }), tint: [tint.r, tint.g, tint.b] };
42
+ trees.push(row); owned.set(tree, row);
43
+ }
44
+ return { trees, nearby: (x, z, radius = 2) => native.grid.nearby(x, z, radius).map(tree => {
45
+ const row = owned.get(tree);
46
+ if (row === undefined) throw new Error('Native forest query lost its owned tree');
47
+ return row;
48
+ }) };
49
+ }
50
+
51
+ /** A native terrain's trail, cabin, pond and water queries from explicit trails, cabin sites and water level: the page's
52
+ * terrain law over those inputs, for a forest bake's source (`bakeForestPlacements`). No level is selected or installed. */
53
+ export function nativeTerrainQueries(seed: number, spec: Parameters<typeof buildTerrainMetadata>[1],
54
+ waterLevel: Parameters<typeof buildTerrainMetadata>[2]): ReturnType<typeof buildTerrainMetadata> {
55
+ return buildTerrainMetadata(seed, spec, waterLevel);
56
+ }
57
+
58
+ /** One declared forest candidate (a shard's forest rows, G4): its exact jittered lattice point and what it answers. */
59
+ export interface PlantedForestCandidate {
60
+ readonly x: number; readonly z: number; readonly density: number; readonly scale: number;
61
+ readonly species: Readonly<Partial<Record<string, number>>>;
62
+ }
63
+ /** The declared ground a forest avoids: its trails, cabin pads and pond (a shard's ground rows), and its still water. */
64
+ export type PlantedForestGround = Pick<TerrainSpec, 'trails' | 'cabinSites' | 'pond'> & { readonly seed: number; readonly water: number; readonly datum?: number };
65
+ /** Everything a page plants its forest from, as data: no level is selected and no terrain installed. */
66
+ export interface PlantedForestInput {
67
+ readonly seed: number; readonly treeCount: number;
68
+ /** the manifest's forest policy as authored (`manifest.json` `forest`; its queries come from `candidates`) */
69
+ readonly forest: unknown;
70
+ readonly candidates: readonly PlantedForestCandidate[];
71
+ readonly ground: PlantedForestGround;
72
+ /** the retained baked terrain (WSTR) the page installs */
73
+ readonly terrain: Uint8Array;
74
+ readonly variants: readonly PlantSpec[];
75
+ }
76
+
77
+ /** G32: the forest a page plants (`placeForest(plantSpecs(def.trees))` on its installed level), from data. Heights and
78
+ * normals are the retained bake's (plus the ground's datum, as the installed field adds it); the trail, cabin and pond
79
+ * masks are the terrain field's own (`buildTerrainMetadata`); each candidate answers its declared density, scale and
80
+ * species. A program reaches the planted trees without the level registry or any runtime module. */
81
+ /** A planted forest: its trees and their nearby query, and the canopy channel a splat ground darkens under (256², 0–1). */
82
+ export interface PlantedForest extends NativeForestPlacements { readonly canopy: Float32Array }
83
+ export function bakePlantedForest(input: PlantedForestInput): PlantedForest {
84
+ const baked = readNativeTerrain(input.terrain), datum = input.ground.datum ?? 0, ground = input.ground;
85
+ const policy: Omit<ForestSpec, 'density' | 'scale' | 'species'> = v.parse(ManifestMetadataSchema.entries.forest.wrapped, input.forest);
86
+ const masks = buildTerrainMetadata(ground.seed, { trails: ground.trails, cabinSites: ground.cabinSites, ...(ground.pond === undefined ? {} : { pond: ground.pond }) }, () => ground.water);
87
+ const at = new Map(input.candidates.map(row => [`${String(row.x)},${String(row.z)}`, row]));
88
+ const row = (x: number, z: number): PlantedForestCandidate => {
89
+ const found = at.get(`${String(x)},${String(z)}`);
90
+ if (found === undefined) throw new Error('Forest candidate differs from its declared rows');
91
+ return found;
92
+ };
93
+ const planted = bakeForestPlacements({
94
+ seed: input.seed, treeCount: input.treeCount,
95
+ heightAt: datum === 0 ? baked.heightAt : (x, z) => baked.heightAt(x, z) + datum, normalAt: baked.normalAt,
96
+ trailDistance: masks.trailDistance, cabinMask: masks.cabinMask, pondMask: masks.pondMask,
97
+ forest: { ...policy, density: (x, z) => row(x, z).density, scale: (x, z) => row(x, z).scale, species: (x, z) => ({ ...row(x, z).species }) },
98
+ }, input.variants);
99
+ return { ...planted, canopy: canopyMapOf(planted.trees) };
100
+ }
@@ -0,0 +1,2 @@
1
+ // J82's hook lives in engine: one copy, and it imports nothing of ours.
2
+ import '@wildshard/engine/scripts/format-hook.mjs';
@@ -0,0 +1,23 @@
1
+ // SHARD-AUTHORING SA6 (J170): a generator's GLB codec. A generator builds, reads and writes GLB documents through this
2
+ // module, so its imports stay on the authoring surface (the SDK's `generator-imports` rule) while gltf-transform and the
3
+ // meshopt decoder stay the SDK's own dependencies, pinned with it.
4
+ import { Document, WebIO } from '@gltf-transform/core';
5
+ import { ALL_EXTENSIONS } from '@gltf-transform/extensions';
6
+ import { MeshoptDecoder } from 'meshoptimizer';
7
+
8
+ /** An empty glTF document for a generator to fill and pass to `writeGlb`. */
9
+ export function newGlbDocument(): Document {
10
+ return new Document();
11
+ }
12
+
13
+ /** Read GLB bytes into a document: every glTF extension gltf-transform knows, meshopt-compressed buffers decoded. */
14
+ export async function readGlb(bytes: Uint8Array): Promise<Document> {
15
+ await MeshoptDecoder.ready;
16
+ const io = new WebIO().registerExtensions(ALL_EXTENSIONS).registerDependencies({ 'meshopt.decoder': MeshoptDecoder });
17
+ return io.readBinary(bytes);
18
+ }
19
+
20
+ /** Write a document as GLB bytes, as it stands: no compression, quantization, welding or reordering. */
21
+ export function writeGlb(doc: Document): Promise<Uint8Array> {
22
+ return new WebIO().writeBinary(doc);
23
+ }
@@ -0,0 +1,77 @@
1
+ import { Box3, BufferAttribute, InterleavedBufferAttribute, Sphere, Vector3, type BufferGeometry } from 'three';
2
+
3
+ // Keep typed-array scans separate from the generator's yield state.
4
+ function packedBox(array: Float32Array, start: number, end: number, box: Box3): void {
5
+ let { x: minX, y: minY, z: minZ } = box.min, { x: maxX, y: maxY, z: maxZ } = box.max;
6
+ for (let i = start; i < end; i += 3) {
7
+ const x = array[i] ?? Number.NaN, y = array[i + 1] ?? Number.NaN, z = array[i + 2] ?? Number.NaN;
8
+ minX = Math.min(minX, x); minY = Math.min(minY, y); minZ = Math.min(minZ, z);
9
+ maxX = Math.max(maxX, x); maxY = Math.max(maxY, y); maxZ = Math.max(maxZ, z);
10
+ }
11
+ box.min.set(minX, minY, minZ); box.max.set(maxX, maxY, maxZ);
12
+ }
13
+
14
+ function packedRadius(array: Float32Array, start: number, end: number, center: Vector3, radiusSq: number): number {
15
+ const { x, y, z } = center;
16
+ let largest = radiusSq;
17
+ for (let i = start; i < end; i += 3) {
18
+ const dx = x - (array[i] ?? Number.NaN), dy = y - (array[i + 1] ?? Number.NaN), dz = z - (array[i + 2] ?? Number.NaN);
19
+ largest = Math.max(largest, dx * dx + dy * dy + dz * dz);
20
+ }
21
+ return largest;
22
+ }
23
+
24
+ /** Compute ordinary geometry bounds in 32,768-vertex steps, with three.js's vertex order and arithmetic.
25
+ * Exhausting the generator is synchronous; a sliced builder may pause between steps. Geometry must remain
26
+ * unmodified until completion. Existing bound objects retain their identity and are published only at completion.
27
+ * Morph targets, GPU-only attributes and invalid coordinates keep three.js's original implementation. */
28
+ export function* bakeGeometryBoundsSteps(geometry: BufferGeometry, bounds: 'box' | 'sphere' | 'both' = 'both'): Generator<void, void> {
29
+ const position: unknown = geometry.getAttribute('position');
30
+ const original = (): void => {
31
+ if (bounds !== 'box') geometry.computeBoundingSphere();
32
+ if (bounds !== 'sphere') geometry.computeBoundingBox();
33
+ };
34
+ if (!(position instanceof BufferAttribute || position instanceof InterleavedBufferAttribute) || geometry.morphAttributes.position !== undefined) {
35
+ original(); return;
36
+ }
37
+ const box = new Box3(), point = new Vector3();
38
+ // Merged/static meshes use packed, unnormalized Float32 positions. Scan those
39
+ // bytes directly; accessor calls dominate large bounds scans on WebKit.
40
+ const packed = position instanceof BufferAttribute && position.array instanceof Float32Array
41
+ && position.itemSize === 3 && !position.normalized && position.count * 3 === position.array.length
42
+ && position.array.length % 3 === 0 ? position.array : null;
43
+ if (packed === null) {
44
+ for (let i = 0; i < position.count; i++) {
45
+ point.fromBufferAttribute(position, i); box.expandByPoint(point);
46
+ if ((i & 32767) === 32767) yield;
47
+ }
48
+ } else {
49
+ for (let i = 0; i < packed.length; i += 32768 * 3) {
50
+ const end = Math.min(packed.length, i + 32768 * 3);
51
+ packedBox(packed, i, end, box);
52
+ if (end - i === 32768 * 3) yield;
53
+ }
54
+ }
55
+ if (Number.isNaN(box.min.x) || Number.isNaN(box.min.y) || Number.isNaN(box.min.z)) { original(); return; }
56
+ if (bounds !== 'box') {
57
+ const sphere = new Sphere(); box.getCenter(sphere.center);
58
+ let radiusSq = 0;
59
+ if (packed === null) {
60
+ for (let i = 0; i < position.count; i++) {
61
+ point.fromBufferAttribute(position, i);
62
+ radiusSq = Math.max(radiusSq, sphere.center.distanceToSquared(point));
63
+ if ((i & 32767) === 32767) yield;
64
+ }
65
+ } else {
66
+ for (let i = 0; i < packed.length; i += 32768 * 3) {
67
+ const end = Math.min(packed.length, i + 32768 * 3);
68
+ radiusSq = packedRadius(packed, i, end, sphere.center, radiusSq);
69
+ if (end - i === 32768 * 3) yield;
70
+ }
71
+ }
72
+ sphere.radius = Math.sqrt(radiusSq);
73
+ if (Number.isNaN(sphere.radius)) { original(); return; }
74
+ (geometry.boundingSphere ??= new Sphere()).copy(sphere);
75
+ }
76
+ if (bounds !== 'sphere') (geometry.boundingBox ??= new Box3()).copy(box);
77
+ }
@@ -0,0 +1,48 @@
1
+ import { Matrix3, Matrix4, Vector3, type BufferGeometry } from 'three';
2
+ import type { TileGrid } from './worldGeometry';
3
+
4
+ /** Conservative Euclidean displacement scale, including shear; translation is excluded. */
5
+ export function positionErrorScale(matrix: Matrix4): number {
6
+ const e = matrix.elements;
7
+ if (e.some(value => !Number.isFinite(value)) || e[3] !== 0 || e[7] !== 0 || e[11] !== 0 || e[15] !== 1) throw new Error('Position error needs an affine transform');
8
+ const read = (row: number, column: number): number => Math.abs(e[column * 4 + row] ?? 0);
9
+ const row = Math.max(...[0, 1, 2].map(i => read(i, 0) + read(i, 1) + read(i, 2)));
10
+ const column = Math.max(...[0, 1, 2].map(i => read(0, i) + read(1, i) + read(2, i)));
11
+ return Math.sqrt(row * column);
12
+ }
13
+
14
+ /** Actual Euclidean position loss when the writer stores triples as float32. */
15
+ export function floatPositionError(positions: ArrayLike<number>): number {
16
+ if (positions.length % 3 !== 0) throw new Error('Position error needs triples');
17
+ let error = 0;
18
+ for (let at = 0; at < positions.length; at += 3) {
19
+ const x = positions[at], y = positions[at + 1], z = positions[at + 2];
20
+ if (x === undefined || y === undefined || z === undefined || ![x, y, z].every(Number.isFinite)
21
+ || ![Math.fround(x), Math.fround(y), Math.fround(z)].every(Number.isFinite)) throw new Error('Position error needs finite storage');
22
+ error = Math.max(error, Math.hypot(x - Math.fround(x), y - Math.fround(y), z - Math.fround(z)));
23
+ }
24
+ return error;
25
+ }
26
+
27
+ /** Compact positions' quantization-cell radius in world metres. An exactly grid-aligned source loses nothing.
28
+ * The transform applies to displacement only; translation never enlarges the error. */
29
+ export function gridPositionError(geometry: BufferGeometry, grid: TileGrid, transform: Matrix4 = new Matrix4()): number {
30
+ if (!Number.isFinite(grid.step) || grid.step <= 0 || grid.origin.some(value => !Number.isFinite(value))
31
+ || transform.elements.some(value => !Number.isFinite(value))) throw new Error('Invalid position error grid');
32
+ const position = geometry.getAttribute('position');
33
+ if (position.itemSize !== 3) throw new Error('Position error needs triples');
34
+ let rounded = false;
35
+ for (let at = 0; at < position.count; at++) for (let axis = 0; axis < 3; axis++) {
36
+ const value = position.getComponent(at, axis), origin = grid.origin[axis];
37
+ if (origin === undefined || !Number.isFinite(value)) throw new Error('Invalid position error source');
38
+ const stored = Math.round((value - origin) / grid.step);
39
+ if (Math.abs(stored) > 32767) throw new Error('Position error outside grid');
40
+ rounded ||= stored * grid.step + origin !== value;
41
+ }
42
+ if (!rounded) return 0;
43
+ const linear = new Matrix3().setFromMatrix4(transform), half = grid.step / 2;
44
+ let radius = 0;
45
+ for (const x of [-half, half]) for (const y of [-half, half]) for (const z of [-half, half])
46
+ radius = Math.max(radius, new Vector3(x, y, z).applyMatrix3(linear).length());
47
+ return radius;
48
+ }