@wildshard/sdk 0.0.1 → 0.2.4

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 (688) hide show
  1. package/GUIDE.md +895 -0
  2. package/README.md +13 -5
  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 +365 -3
  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 +47 -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 +39 -0
  358. package/src/cli/bin.mjs +8 -0
  359. package/src/cli/delete/delete.ts +258 -0
  360. package/src/cli/help.ts +204 -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 +291 -0
  365. package/src/cli/report.ts +20 -0
  366. package/src/cli/shardfile/command.ts +49 -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/agentFiles.ts +127 -0
  394. package/src/sharddev/arenaView.ts +15 -0
  395. package/src/sharddev/as/groupBankV2.ts +36 -0
  396. package/src/sharddev/as/groupStepV2.ts +13 -0
  397. package/src/sharddev/as/ws.ts +30 -0
  398. package/src/sharddev/as/wsV2.ts +180 -0
  399. package/src/sharddev/assemblyscriptCompiler.d.mts +5 -0
  400. package/src/sharddev/assemblyscriptCompiler.mjs +14 -0
  401. package/src/sharddev/assetHandle.ts +84 -0
  402. package/src/sharddev/assetOwner.ts +70 -0
  403. package/src/sharddev/assetScope.ts +30 -0
  404. package/src/sharddev/assets.ts +21 -0
  405. package/src/sharddev/audio.ts +9 -0
  406. package/src/sharddev/audioEncode.ts +211 -0
  407. package/src/sharddev/author.ts +3 -0
  408. package/src/sharddev/authorError.ts +28 -0
  409. package/src/sharddev/authorManifest.ts +39 -0
  410. package/src/sharddev/bake/annulus.ts +19 -0
  411. package/src/sharddev/bake/assemblyscriptMemo.ts +76 -0
  412. package/src/sharddev/bake/assemblyscriptMemoPort.ts +4 -0
  413. package/src/sharddev/bake/authoredWorld.ts +201 -0
  414. package/src/sharddev/bake/basisEncoder.ts +95 -0
  415. package/src/sharddev/bake/basisGlb.ts +85 -0
  416. package/src/sharddev/bake/basisTool.ts +74 -0
  417. package/src/sharddev/bake/basisToolInputs.ts +476 -0
  418. package/src/sharddev/bake/byteCodec.ts +33 -0
  419. package/src/sharddev/bake/canvasAtlas.ts +406 -0
  420. package/src/sharddev/bake/coarseCopy.ts +59 -0
  421. package/src/sharddev/bake/colliders.ts +87 -0
  422. package/src/sharddev/bake/compactGlb.ts +224 -0
  423. package/src/sharddev/bake/compileScript.ts +119 -0
  424. package/src/sharddev/bake/compileScriptV2.ts +75 -0
  425. package/src/sharddev/bake/contactRows.ts +84 -0
  426. package/src/sharddev/bake/creaturePlacement.ts +117 -0
  427. package/src/sharddev/bake/export.ts +67 -0
  428. package/src/sharddev/bake/facetedGeometry.ts +379 -0
  429. package/src/sharddev/bake/farImpostor.ts +120 -0
  430. package/src/sharddev/bake/forest.ts +100 -0
  431. package/src/sharddev/bake/format-hook.mjs +2 -0
  432. package/src/sharddev/bake/generatorGlb.ts +23 -0
  433. package/src/sharddev/bake/geometryBounds.ts +77 -0
  434. package/src/sharddev/bake/geometryError.ts +48 -0
  435. package/src/sharddev/bake/glb.ts +355 -0
  436. package/src/sharddev/bake/glbCompression.ts +143 -0
  437. package/src/sharddev/bake/gltfSource.ts +59 -0
  438. package/src/sharddev/bake/groundMap.ts +142 -0
  439. package/src/sharddev/bake/image.ts +20 -0
  440. package/src/sharddev/bake/isleMap.ts +64 -0
  441. package/src/sharddev/bake/json.mjs +84 -0
  442. package/src/sharddev/bake/keyedSky.ts +47 -0
  443. package/src/sharddev/bake/keyedSkyMemo.ts +39 -0
  444. package/src/sharddev/bake/kinds.ts +137 -0
  445. package/src/sharddev/bake/lightSources.ts +31 -0
  446. package/src/sharddev/bake/mapAssembly.ts +84 -0
  447. package/src/sharddev/bake/mapRaster.ts +173 -0
  448. package/src/sharddev/bake/mapRest.ts +57 -0
  449. package/src/sharddev/bake/mapScenes.ts +234 -0
  450. package/src/sharddev/bake/materialGraph.ts +32 -0
  451. package/src/sharddev/bake/meadow.ts +27 -0
  452. package/src/sharddev/bake/meshoptChoiceMemo.ts +34 -0
  453. package/src/sharddev/bake/nativeInteractionFacts.ts +5 -0
  454. package/src/sharddev/bake/nativeLattice.ts +178 -0
  455. package/src/sharddev/bake/nativeRaster.ts +106 -0
  456. package/src/sharddev/bake/nativeTerrainField.ts +11 -0
  457. package/src/sharddev/bake/navigation-json.mjs +38 -0
  458. package/src/sharddev/bake/navigation.ts +113 -0
  459. package/src/sharddev/bake/navigationAsset.ts +18 -0
  460. package/src/sharddev/bake/nearPlaceholder.ts +206 -0
  461. package/src/sharddev/bake/normalizeRig.ts +80 -0
  462. package/src/sharddev/bake/phoneAstc.ts +93 -0
  463. package/src/sharddev/bake/placeholders.ts +581 -0
  464. package/src/sharddev/bake/placement.ts +80 -0
  465. package/src/sharddev/bake/portableBytes.ts +18 -0
  466. package/src/sharddev/bake/portableBytesMemo.ts +50 -0
  467. package/src/sharddev/bake/practiceCourse.ts +49 -0
  468. package/src/sharddev/bake/primitives.ts +96 -0
  469. package/src/sharddev/bake/props.ts +443 -0
  470. package/src/sharddev/bake/questPlacement.ts +98 -0
  471. package/src/sharddev/bake/rawTexture.ts +26 -0
  472. package/src/sharddev/bake/riderArms.ts +97 -0
  473. package/src/sharddev/bake/rig.ts +95 -0
  474. package/src/sharddev/bake/riggedHullRecipes.ts +40 -0
  475. package/src/sharddev/bake/signPlacements.ts +25 -0
  476. package/src/sharddev/bake/simplifier.ts +52 -0
  477. package/src/sharddev/bake/skinned.ts +312 -0
  478. package/src/sharddev/bake/slabChunks.ts +149 -0
  479. package/src/sharddev/bake/slabs.ts +263 -0
  480. package/src/sharddev/bake/source-loader.mjs +55 -0
  481. package/src/sharddev/bake/sourceMetadata.ts +54 -0
  482. package/src/sharddev/bake/species.ts +368 -0
  483. package/src/sharddev/bake/specimenCatalogue.ts +47 -0
  484. package/src/sharddev/bake/splatGround.ts +141 -0
  485. package/src/sharddev/bake/staticMaterials.ts +171 -0
  486. package/src/sharddev/bake/terrain.ts +195 -0
  487. package/src/sharddev/bake/texture.ts +33 -0
  488. package/src/sharddev/bake/textureWasm.ts +81 -0
  489. package/src/sharddev/bake/tileEncoder.ts +11 -0
  490. package/src/sharddev/bake/tileGrid.ts +62 -0
  491. package/src/sharddev/bake/v2Finite.ts +160 -0
  492. package/src/sharddev/bake/v2Fuel.ts +71 -0
  493. package/src/sharddev/bake/wholePartition.ts +74 -0
  494. package/src/sharddev/bake/wholePieceJoin.ts +147 -0
  495. package/src/sharddev/bake/world.ts +173 -0
  496. package/src/sharddev/bake/worldCollision.ts +128 -0
  497. package/src/sharddev/bake/worldGeometry.ts +237 -0
  498. package/src/sharddev/bake/worldGlb.ts +123 -0
  499. package/src/sharddev/bake/worldImage.ts +12 -0
  500. package/src/sharddev/bake/worldLod.ts +128 -0
  501. package/src/sharddev/bake/worldRows.ts +102 -0
  502. package/src/sharddev/bake/worldTextureMemo.ts +63 -0
  503. package/src/sharddev/bake/zstdBytesMemo.ts +52 -0
  504. package/src/sharddev/bake.ts +193 -0
  505. package/src/sharddev/bakePublication.ts +31 -0
  506. package/src/sharddev/behaviourSource.ts +94 -0
  507. package/src/sharddev/bin/wildshard.mjs +7 -0
  508. package/src/sharddev/blobBytes.ts +65 -0
  509. package/src/sharddev/blobs.ts +138 -0
  510. package/src/sharddev/bootInventory.ts +129 -0
  511. package/src/sharddev/bossProfiles.ts +18 -0
  512. package/src/sharddev/buildBehaviour.ts +77 -0
  513. package/src/sharddev/buildCacheMetrics.ts +17 -0
  514. package/src/sharddev/buildDecisionScripts.ts +122 -0
  515. package/src/sharddev/check.ts +118 -0
  516. package/src/sharddev/checkProject.ts +127 -0
  517. package/src/sharddev/cli.ts +200 -0
  518. package/src/sharddev/clientChannels.ts +169 -0
  519. package/src/sharddev/clientScripts.ts +10 -0
  520. package/src/sharddev/commons.ts +77 -0
  521. package/src/sharddev/commonsCosts.ts +11 -0
  522. package/src/sharddev/compileMovers.ts +11 -0
  523. package/src/sharddev/configBoundary.ts +6 -0
  524. package/src/sharddev/cookInput.ts +40 -0
  525. package/src/sharddev/crowds.ts +6 -0
  526. package/src/sharddev/decisionBindingMap.ts +11 -0
  527. package/src/sharddev/decisionScriptBindings.ts +117 -0
  528. package/src/sharddev/decisionScripts.ts +28 -0
  529. package/src/sharddev/decisionSource.ts +51 -0
  530. package/src/sharddev/dev.ts +113 -0
  531. package/src/sharddev/director.ts +26 -0
  532. package/src/sharddev/directorAbi.ts +77 -0
  533. package/src/sharddev/discoveryDocument.ts +97 -0
  534. package/src/sharddev/draft.ts +11 -0
  535. package/src/sharddev/eliteEntryRows.ts +29 -0
  536. package/src/sharddev/entries.ts +76 -0
  537. package/src/sharddev/entryReads.ts +73 -0
  538. package/src/sharddev/executeBundle.ts +55 -0
  539. package/src/sharddev/finds.ts +5 -0
  540. package/src/sharddev/formatJsonSchema.ts +3 -0
  541. package/src/sharddev/generationCache.ts +257 -0
  542. package/src/sharddev/generationRecipe.ts +94 -0
  543. package/src/sharddev/handwritten.ts +110 -0
  544. package/src/sharddev/immutable.ts +14 -0
  545. package/src/sharddev/interactions.ts +38 -0
  546. package/src/sharddev/kit/bakedGeometry.ts +16 -0
  547. package/src/sharddev/kit/geometryPack.ts +110 -0
  548. package/src/sharddev/ledger.ts +13 -0
  549. package/src/sharddev/looks/tileField.ts +67 -0
  550. package/src/sharddev/materialGraphFiles.ts +57 -0
  551. package/src/sharddev/materials.ts +574 -0
  552. package/src/sharddev/measure.ts +18 -0
  553. package/src/sharddev/modes.ts +115 -0
  554. package/src/sharddev/moverPrograms.ts +213 -0
  555. package/src/sharddev/movers.ts +75 -0
  556. package/src/sharddev/nativePopulationRows.ts +46 -0
  557. package/src/sharddev/newProject.ts +226 -0
  558. package/src/sharddev/noise.ts +54 -0
  559. package/src/sharddev/outputProduct.ts +188 -0
  560. package/src/sharddev/outputRuntime.ts +66 -0
  561. package/src/sharddev/performancePolicy.ts +29 -0
  562. package/src/sharddev/phasedBoss.ts +34 -0
  563. package/src/sharddev/physics.ts +194 -0
  564. package/src/sharddev/platformSections.ts +42 -0
  565. package/src/sharddev/plumbing.ts +8 -0
  566. package/src/sharddev/productOutput.ts +128 -0
  567. package/src/sharddev/project.ts +337 -0
  568. package/src/sharddev/projectCompilerIdentity.ts +94 -0
  569. package/src/sharddev/projectDecisions.ts +66 -0
  570. package/src/sharddev/projectEntryProof.ts +32 -0
  571. package/src/sharddev/projectGeneration.ts +219 -0
  572. package/src/sharddev/projectInputFiles.ts +47 -0
  573. package/src/sharddev/projectManifest.ts +108 -0
  574. package/src/sharddev/projectMap.ts +35 -0
  575. package/src/sharddev/projectOutput.ts +242 -0
  576. package/src/sharddev/projectPolicy.ts +17 -0
  577. package/src/sharddev/projectSections.ts +27 -0
  578. package/src/sharddev/questGraph.ts +25 -0
  579. package/src/sharddev/quests.ts +65 -0
  580. package/src/sharddev/random.ts +61 -0
  581. package/src/sharddev/refusals.ts +304 -0
  582. package/src/sharddev/reportCard.ts +13 -0
  583. package/src/sharddev/returnProjectionV2.ts +81 -0
  584. package/src/sharddev/rows.ts +192 -0
  585. package/src/sharddev/runtimeImports.ts +38 -0
  586. package/src/sharddev/runtimeMirrors.ts +39 -0
  587. package/src/sharddev/runtimePerformance.ts +38 -0
  588. package/src/sharddev/scene.ts +321 -0
  589. package/src/sharddev/sceneAnimation.ts +54 -0
  590. package/src/sharddev/sceneAudio.ts +64 -0
  591. package/src/sharddev/sceneDeclarations.ts +100 -0
  592. package/src/sharddev/sceneGraph.ts +139 -0
  593. package/src/sharddev/sceneTransform.ts +12 -0
  594. package/src/sharddev/schemaValidation.ts +61 -0
  595. package/src/sharddev/sections.ts +47 -0
  596. package/src/sharddev/shardSource.ts +59 -0
  597. package/src/sharddev/sourceReader.ts +26 -0
  598. package/src/sharddev/spawns.ts +38 -0
  599. package/src/sharddev/species/clips.ts +24 -0
  600. package/src/sharddev/species.ts +29 -0
  601. package/src/sharddev/speciesBrains.ts +19 -0
  602. package/src/sharddev/synth.ts +66 -0
  603. package/src/sharddev/test/compileDualScriptV2.ts +71 -0
  604. package/src/sharddev/test/compileSimV2.ts +21 -0
  605. package/src/sharddev/test/diskScriptScenario.ts +86 -0
  606. package/src/sharddev/test/scriptScenario.ts +249 -0
  607. package/src/sharddev/test/scriptSource.ts +12 -0
  608. package/src/sharddev/version.ts +4 -0
  609. package/src/sharddev/weapons/bowProfile.ts +20 -0
  610. package/src/sharddev/weapons/firearmRows.ts +11 -0
  611. package/src/sharddev/weapons/meleeProfile.ts +71 -0
  612. package/src/sharddev/weapons/thrownProfile.ts +10 -0
  613. package/src/sharddev/worldScenes.ts +308 -0
  614. package/src/sharddev/worldSource.ts +82 -0
  615. package/src/shards/_template/README.md +78 -0
  616. package/src/shards/_template/assets/2bf489fdb15f1734ddb4c4f32d500ec6da85c765ec7a4eb28dc6781160e7ec8c +0 -0
  617. package/src/shards/_template/assets/97ec4d8f75f5fa6239ee919444d6dc19fd35896bb305930c1f050ac6e0e0e6a6 +1 -0
  618. package/src/shards/_template/assets/a6a587a31327f936b1b04c05ade818c73fc8964260918662db43539465e27586 +0 -0
  619. package/src/shards/_template/assets/b4fbde0422e125b498c3dc8b9a5cc2516c8598f09e9d0e5f6b639b32f98179e6 +0 -0
  620. package/src/shards/_template/assets/bfa4dfc9c18979f904557ee8deab0058b8a399be10266f5fb1578b403f482fd4 +1 -0
  621. package/src/shards/_template/assets/ef3b7ff4fd22715771cb7d68a3977a903c5e7c3dc293542687d04b3ef3ace2cb +0 -0
  622. package/src/shards/_template/assets/f2db05998615ce1cb79ea96be32c168842eb6a2b34ec01feb86d36404603ee54 +0 -0
  623. package/src/shards/_template/assets/fef98ebb7fce6f66b26e78ac699e5c90f9bdcfaf8cabeb2b58125347eea8b4ab +0 -0
  624. package/src/shards/_template/behaviour/boss.as +39 -0
  625. package/src/shards/_template/behaviour/door.as +32 -0
  626. package/src/shards/_template/behaviour/hooks.json +129 -0
  627. package/src/shards/_template/behaviour/idle.as +75 -0
  628. package/src/shards/_template/behaviour/items.as +22 -0
  629. package/src/shards/_template/card/landscape.jpg +0 -0
  630. package/src/shards/_template/card/portrait.jpg +0 -0
  631. package/src/shards/_template/card/thumb.jpg +0 -0
  632. package/src/shards/_template/data/audio.json +45 -0
  633. package/src/shards/_template/data/bossDecision.json +83 -0
  634. package/src/shards/_template/data/budgets.json +70 -0
  635. package/src/shards/_template/data/card.json +281 -0
  636. package/src/shards/_template/data/clientScripts.json +987 -0
  637. package/src/shards/_template/data/creatures.json +65 -0
  638. package/src/shards/_template/data/director.json +39 -0
  639. package/src/shards/_template/data/encounters.json +96 -0
  640. package/src/shards/_template/data/items.json +172 -0
  641. package/src/shards/_template/data/layout.json +66 -0
  642. package/src/shards/_template/data/ledger.json +32 -0
  643. package/src/shards/_template/data/look.json +521 -0
  644. package/src/shards/_template/data/map.json +64 -0
  645. package/src/shards/_template/data/moves.json +16 -0
  646. package/src/shards/_template/data/placeholder.json +8 -0
  647. package/src/shards/_template/data/plumbing.json +32 -0
  648. package/src/shards/_template/data/quests.json +223 -0
  649. package/src/shards/_template/data/rows.json +423 -0
  650. package/src/shards/_template/data/skins.json +66 -0
  651. package/src/shards/_template/data/spawn.json +6 -0
  652. package/src/shards/_template/data/targets.json +150 -0
  653. package/src/shards/_template/data/text.json +12 -0
  654. package/src/shards/_template/data/ui.json +33 -0
  655. package/src/shards/_template/data/water.json +13 -0
  656. package/src/shards/_template/generators/behaviour.ts +34 -0
  657. package/src/shards/_template/generators/boss.ts +29 -0
  658. package/src/shards/_template/generators/buildOptions.ts +2 -0
  659. package/src/shards/_template/generators/cell.ts +224 -0
  660. package/src/shards/_template/generators/districts.ts +215 -0
  661. package/src/shards/_template/generators/farLook.ts +15 -0
  662. package/src/shards/_template/generators/generate.ts +27 -0
  663. package/src/shards/_template/generators/ground.ts +15 -0
  664. package/src/shards/_template/generators/kit.ts +69 -0
  665. package/src/shards/_template/generators/landscape.ts +59 -0
  666. package/src/shards/_template/generators/landscapeNoise.ts +62 -0
  667. package/src/shards/_template/generators/mapInputs.ts +10 -0
  668. package/src/shards/_template/generators/product.ts +100 -0
  669. package/src/shards/_template/generators/productOutput.ts +18 -0
  670. package/src/shards/_template/generators/props.ts +9 -0
  671. package/src/shards/_template/generators/templatePropsSource.ts +58 -0
  672. package/src/shards/_template/generators/terrain.ts +17 -0
  673. package/src/shards/_template/generators/world.ts +630 -0
  674. package/src/shards/_template/hero.json +10 -0
  675. package/src/shards/_template/look/entry-reads.json +20 -0
  676. package/src/shards/_template/manifest.json +281 -0
  677. package/src/shards/_template/shard.config.ts +10 -0
  678. package/src/shared/health.ts +10 -0
  679. package/src/tools/build-web.ts +59 -0
  680. package/src/tsconfig.json +30 -0
  681. package/src/web/app.tsx +53 -0
  682. package/src/web/index.html +12 -0
  683. package/src/web/main.tsx +10 -0
  684. package/src/web/tsconfig.json +13 -0
  685. package/tsconfig.author.json +23 -0
  686. package/tsconfig.commons.json +21 -0
  687. package/tsconfig.json +47 -0
  688. package/tsconfig.sharddev.json +20 -0
@@ -0,0 +1,160 @@
1
+ /** WASM-HOST H1 build pass. This is not executable-module admission: H2 must
2
+ * verify metering, entries, capabilities and the complete ABI before execution.
3
+ * Kept separate from compileScript so v0/v1 bytes remain unchanged. */
4
+ import binaryen from 'binaryen';
5
+ import { SCRIPT_ABI } from '@wildshard/format/scriptAbi';
6
+
7
+ type Form = string | Form[];
8
+ type Float = 'f32' | 'f64';
9
+ interface Guard { type: Float; label: string | undefined; local: string; value: Form }
10
+ const features = binaryen.Features.MutableGlobals | binaryen.Features.SignExt | binaryen.Features.NontrappingFPToInt;
11
+ const maximum = { f32: '3.4028234663852886e+38', f64: '1.7976931348623157e+308' };
12
+ const floating = (value: Form | undefined): value is Float => value === 'f32' || value === 'f64';
13
+ function form(value: Form | undefined): value is Form[] { return Array.isArray(value); }
14
+ function text(value: Form): string { return form(value) ? `(${value.map(text).join(' ')})` : value; }
15
+ function parse(source: string): Form[] {
16
+ const root: Form[] = [], stack = [root];
17
+ for (const word of source.match(/"(?:\\.|[^"\\])*"|[()]|[^\s()]+/gu) ?? []) {
18
+ const current = stack.at(-1); if (current === undefined) throw new Error('Malformed v2 WAT');
19
+ if (word === '(') { const next: Form[] = []; current.push(next); stack.push(next); }
20
+ else if (word === ')') { if (stack.length === 1) throw new Error('Unbalanced v2 WAT'); stack.pop(); }
21
+ else current.push(word);
22
+ }
23
+ const module = root[0];
24
+ if (stack.length !== 1 || root.length !== 1 || !form(module) || module[0] !== 'module') throw new Error('Malformed v2 module');
25
+ return module;
26
+ }
27
+ function walk(node: Form, visit: (value: Form[]) => void): void {
28
+ if (!form(node)) return;
29
+ visit(node); for (const child of node) walk(child, visit);
30
+ }
31
+ function globals(module: Form[]): Map<string, Float> {
32
+ const result = new Map<string, Float>();
33
+ for (const node of module) if (form(node) && node[0] === 'global' && typeof node[1] === 'string') {
34
+ const declaration = node[2], type = form(declaration) && declaration[0] === 'mut' ? declaration[1] : declaration;
35
+ if (floating(type)) result.set(node[1], type);
36
+ }
37
+ return result;
38
+ }
39
+ function checkedModule(bytes: Uint8Array): binaryen.Module {
40
+ if (bytes.byteLength > SCRIPT_ABI.maxBytes || !WebAssembly.validate(new Uint8Array(bytes))) throw new Error('Invalid v2 finite input');
41
+ const module = binaryen.readBinary(bytes); module.setFeatures(features);
42
+ if (!module.validate()) { module.dispose(); throw new Error('Unsupported v2 features (including SIMD)'); }
43
+ return module;
44
+ }
45
+ function check(type: Float, local: string): Form[] {
46
+ return ['if', ['i32.or', [`${type}.ne`, ['local.get', local], ['local.get', local]],
47
+ [`${type}.gt`, [`${type}.abs`, ['local.get', local]], [`${type}.const`, maximum[type]]]], ['then', ['unreachable']]];
48
+ }
49
+ function same(a: Form | undefined, b: Form): boolean { return a !== undefined && text(a) === text(b); }
50
+ function guard(node: Form): Guard | undefined {
51
+ if (!form(node) || node[0] !== 'block') return undefined;
52
+ const label = typeof node[1] === 'string' ? node[1] : undefined, at = label === undefined ? 1 : 2;
53
+ // Binaryen can flatten the checked expression's preceding statements into
54
+ // this block. The final set/check/get must still be exact; branches to the
55
+ // result label remain forbidden, including from that preceding sequence.
56
+ if (node.length < at+4) return undefined;
57
+ const result = node[at], set = node.at(-3), get = node.at(-1);
58
+ if (!form(result) || result.length !== 2 || result[0] !== 'result' || !floating(result[1])
59
+ || !form(set) || set.length !== 3 || set[0] !== 'local.set' || typeof set[1] !== 'string'
60
+ || set[2] === undefined || !same(get, ['local.get', set[1]])) return undefined;
61
+ // Binaryen canonicalizes decimal float constants on emission. Compare the
62
+ // value at its declared width, while requiring every other guard instruction.
63
+ const expected = check(result[1], set[1]), actual = node.at(-2);
64
+ if (!form(actual)) return undefined;
65
+ const copy = parse(`(module ${text(actual)})`)[1];
66
+ if (!form(copy)) return undefined;
67
+ const condition = copy[1], bound = form(condition) ? condition[2] : undefined;
68
+ const constant = form(bound) ? bound[2] : undefined;
69
+ if (!form(constant) || constant.length !== 2 || constant[0] !== `${result[1]}.const` || typeof constant[1] !== 'string') return undefined;
70
+ const value = Number(constant[1]), target = Number(maximum[result[1]]);
71
+ if ((result[1] === 'f32' ? Math.fround(value) !== Math.fround(target) : value !== target)) return undefined;
72
+ constant[1] = maximum[result[1]];
73
+ if (!same(copy, expected)) return undefined;
74
+ return { type: result[1], label, local: set[1], value: set[2] };
75
+ }
76
+
77
+ /** Insert expression-local finite checks without a JS function import. Original
78
+ * branches retain their named labels; new guard labels are collision-free. */
79
+ export function instrumentV2Finite(bytes: Uint8Array): Uint8Array {
80
+ const input = checkedModule(bytes);
81
+ try {
82
+ const module = parse(input.emitText()), types = globals(module), names = new Set<string>();
83
+ walk(module, node => { for (const value of node) if (typeof value === 'string') names.add(value); });
84
+ let serial = 0;
85
+ const fresh = (prefix: string): string => { let name: string; do { name = `$__v2_${prefix}_${serial++}`; } while (names.has(name)); names.add(name); return name; };
86
+ for (const fn of module) {
87
+ if (!form(fn) || fn[0] !== 'func') continue;
88
+ const locals = new Map<Float, string>();
89
+ const wrap = (type: Float, value: Form): Form[] => {
90
+ let local = locals.get(type);
91
+ if (local === undefined) { local = fresh(type); locals.set(type, local); }
92
+ return ['block', fresh('finite'), ['result', type], ['local.set', local, value], check(type, local), ['local.get', local]];
93
+ };
94
+ const rewrite = (node: Form): Form => {
95
+ if (!form(node)) return node;
96
+ const result = node.map(rewrite), op = result[0], tail = result.at(-1);
97
+ const type = op === 'f32.store' || op === 'i32.reinterpret_f32' ? 'f32'
98
+ : op === 'f64.store' || op === 'i64.reinterpret_f64' ? 'f64'
99
+ : op === 'global.set' && typeof result[1] === 'string' ? types.get(result[1]) : undefined;
100
+ if (type !== undefined && tail !== undefined) result[result.length - 1] = wrap(type, tail);
101
+ // A result block at the end of an if arm is flattened by Binaryen.
102
+ // Keep reinterpret guards expression-local for both verifiers. Finite
103
+ // multiplication by one preserves every bit, including signed zero.
104
+ return op === 'f32.reinterpret_i32' ? ['f32.mul',wrap('f32', result),['f32.const','1']]
105
+ : op === 'f64.reinterpret_i64' ? ['f64.mul',wrap('f64', result),['f64.const','1']] : result;
106
+ };
107
+ let body = 2;
108
+ while (form(fn[body]) && ['param', 'result', 'local', 'type'].includes(String(fn[body]?.[0]))) body++;
109
+ for (let i = body; i < fn.length; i++) { const node = fn[i]; if (node !== undefined) fn[i] = rewrite(node); }
110
+ fn.splice(body, 0, ...[...locals].map(([type, name]): Form[] => ['local', name, type]));
111
+ }
112
+ const output = binaryen.parseText(text(module));
113
+ try {
114
+ output.setFeatures(features); if (!output.validate()) throw new Error('Invalid v2 finite rewrite');
115
+ const resultBytes = output.emitBinary(); inspectV2Finite(resultBytes); return resultBytes;
116
+ } finally { output.dispose(); }
117
+ } finally { input.dispose(); }
118
+ }
119
+
120
+ /** Build-time guard verification only; deliberately not the ABI-v2 admit API.
121
+ * In particular a guarded binary still needs H2's fuel/control-flow verifier. */
122
+ export function inspectV2Finite(bytes: Uint8Array): { stores: number; globals: number; reinterprets: number } {
123
+ const input = checkedModule(bytes);
124
+ try {
125
+ const module = parse(input.emitText()), types = globals(module), guards = new Map<Form[], Guard>(), guardedResults = new Set<Form>();
126
+ walk(module, node => {
127
+ let found = guard(node);
128
+ // Binaryen represents a function's outer block as its body sequence.
129
+ if (found === undefined && node[0] === 'func') {
130
+ const result = node.find(child => form(child) && child[0] === 'result');
131
+ let body = 2;
132
+ while (form(node[body]) && ['param', 'result', 'local', 'type'].includes(String(node[body]?.[0]))) body++;
133
+ if (form(result) && floating(result[1]) && node.length-body >= 3) found = guard(['block', result, ...node.slice(body)]);
134
+ }
135
+ if (found !== undefined) { guards.set(node, found); guardedResults.add(found.value); }
136
+ });
137
+ const labels = new Set([...guards.values()].flatMap(value => value.label === undefined ? [] : [value.label]));
138
+ const counts = { stores: 0, globals: 0, reinterprets: 0 };
139
+ walk(module, node => {
140
+ const op = node[0];
141
+ // A forged branch to a guard's result label could bypass its check. The
142
+ // compiler never targets these labels, including from nested expressions.
143
+ if ((op === 'br' || op === 'br_if' || op === 'br_table') && node.slice(1).some(value => typeof value === 'string' && labels.has(value))) throw new Error('Branch bypasses v2 finite guard');
144
+ const type = op === 'f32.store' || op === 'i32.reinterpret_f32' ? 'f32'
145
+ : op === 'f64.store' || op === 'i64.reinterpret_f64' ? 'f64'
146
+ : op === 'global.set' && typeof node[1] === 'string' ? types.get(node[1]) : undefined;
147
+ if (type !== undefined) {
148
+ const value = node.at(-1), found = form(value) ? guards.get(value) : undefined;
149
+ if (found?.type !== type) throw new Error('Missing v2 finite input guard');
150
+ if (op === 'global.set') counts.globals++;
151
+ else if (op === 'f32.store' || op === 'f64.store') counts.stores++;
152
+ else counts.reinterprets++;
153
+ }
154
+ if (op === 'f32.reinterpret_i32' || op === 'f64.reinterpret_i64') {
155
+ if (!guardedResults.has(node)) throw new Error('Missing v2 finite reinterpret guard'); counts.reinterprets++;
156
+ }
157
+ });
158
+ return counts;
159
+ } finally { input.dispose(); }
160
+ }
@@ -0,0 +1,71 @@
1
+ /** Separate ABI v2 build meter. No existing v0/v1 compilation calls this pass. */
2
+ import { readV2Module,type V2Body,type V2Signature } from '@wildshard/format/scriptModuleV2';
3
+ import { inspectV2Fuel,V2_ENTRY_SIGNATURES,V2_WORK_ENTRIES,v2Lane,v2BlockCosts,type V2Lane } from '@wildshard/format/scriptFuelV2';
4
+
5
+ function uint(input: number): number[] { let value = input; const result: number[] = []; do { const byte = value%128; value = Math.floor(value/128); result.push(byte | (value > 0 ? 128 : 0)); } while (value > 0); return result; }
6
+ function signed(input: number): number[] {
7
+ let value = input; const result: number[] = []; let more = true;
8
+ while (more) { let byte = value & 127; value >>= 7; more = !((value === 0 && (byte & 64) === 0) || (value === -1 && (byte & 64) !== 0)); if (more) byte |= 128; result.push(byte); } return result;
9
+ }
10
+ function vector(rows: readonly (readonly number[])[]): number[] { return [...uint(rows.length),...rows.flat()]; }
11
+ function section(id: number,bytes: readonly number[]): number[] { return [id,...uint(bytes.length),...bytes]; }
12
+ function named(name: string): number[] { const bytes = new TextEncoder().encode(name); return [...uint(bytes.length),...bytes]; }
13
+ function charge(fuel: number,cost: number): number[] { return [0x23,...uint(fuel),0x41,...signed(cost),0x6b,0x24,...uint(fuel),0x23,...uint(fuel),0x41,0,0x48,0x04,0x40,0x00,0x0b]; }
14
+ function metered(body: V2Body,fuel: number,getters: ReadonlySet<number>): number[] {
15
+ const costs = v2BlockCosts(body.code,new Map([...getters].map(target => [target,2]))), result = [...body.bytes.subarray(0,body.prefix)];
16
+ for (let i = 0; i < body.code.length; i++) {
17
+ const value = body.code[i]; if (value === undefined) throw new Error('Missing v2 meter instruction');
18
+ const cost = costs.get(i); if (cost !== undefined) result.push(...charge(fuel,cost));
19
+ for (const byte of body.bytes.subarray(value.at,value.end)) result.push(byte);
20
+ }
21
+ return [...uint(result.length),...result];
22
+ }
23
+ function wrapper(type: V2Signature,target: number,fuel: number): number[] {
24
+ const body = [0,0x20,...uint(type.params.length-1),0x24,...uint(fuel),0x23,...uint(fuel),0x41,0,0x48,0x04,0x40,0x00,0x0b,
25
+ ...type.params.flatMap((_,index) => [0x20,...uint(index)]),0x10,...uint(target),0x1a,0x23,...uint(fuel),0x0b];
26
+ return [...uint(body.length),...body];
27
+ }
28
+ /** Add a private fuel global and canonical host-only entry wrappers, pricing
29
+ * coalesced acyclic regions by their scalar instruction counts (H0). The resulting
30
+ * bytes still need complete finite/ABI admission before execution. */
31
+ export function instrumentV2Fuel(bytes: Uint8Array,options: { readonly lane?: V2Lane } = {}): Uint8Array {
32
+ const image = readV2Module(bytes), lane = v2Lane(image,options.lane,true), fuel = image.globals.length, getters = new Set<number>(), entries = new Map<number,number>();
33
+ for (const name of ['ws_abi','ws_io']) { const entry = image.exports.get(name); if (entry?.kind !== 0) throw new Error('Missing v2 getter'); getters.add(entry.index); }
34
+ for (const name of ['ws_init',V2_WORK_ENTRIES[lane]]) {
35
+ const params = V2_ENTRY_SIGNATURES[name]; if (params === undefined) throw new Error('Missing v2 entry contract');
36
+ const exp = image.exports.get(name), type = image.types[image.functions[exp?.index ?? -1] ?? -1];
37
+ if (exp?.kind !== 0 || type?.result !== 0x7f || type.params.length !== params.length || type.params.some((value,i) => value !== params[i]) || entries.has(exp.index)) throw new Error('Wrong v2 work entry');
38
+ entries.set(exp.index,image.functions.length+entries.size);
39
+ }
40
+ const reader = image.exports.get('__v2_fuel');
41
+ if (reader !== undefined) {
42
+ const type = image.types[image.functions[reader.index] ?? -1];
43
+ if (reader.kind !== 0 || type?.params.length !== 0 || type.result !== 0x7f || getters.has(reader.index) || entries.has(reader.index)) throw new Error('Invalid v2 fuel reader intrinsic');
44
+ }
45
+ // Refuse acyclic entry-to-entry calls too: a source entry implementation is
46
+ // host-only even though the final exported wrapper has a different index.
47
+ const sourceEntries = new Set(Object.keys(V2_ENTRY_SIGNATURES).flatMap(name => { const row = image.exports.get(name); return row?.kind === 0 ? [row.index] : []; }));
48
+ for (const body of image.bodies) for (const value of body.code) if (value.op === 0x10 && sourceEntries.has(value.args[0] ?? -1)) throw new Error('Guest calls a v2 entry');
49
+ const functions = [...image.functions,...[...entries.keys()].map(index => image.functions[index] ?? -1)];
50
+ const globalSection = image.sections.find(value => value.id === 6);
51
+ // The original vector's count can occupy multiple bytes. Locate its payload
52
+ // by consuming exactly that unsigned LEB, preserving every initializer byte.
53
+ let globalPrefix = 0; if (globalSection !== undefined) { do { const byte = globalSection.bytes[globalPrefix++]; if (byte === undefined) throw new Error('Missing v2 globals'); if (byte < 128) break; } while (globalPrefix < 5); }
54
+ const globalBytes = [...uint(fuel+1),...(globalSection?.bytes.subarray(globalPrefix) ?? []),0x7f,1,0x41,0,0x0b];
55
+ const exports = [...image.exports].filter(([name,value]) => name !== '__v2_fuel' && value.kind === 0 && (!Object.hasOwn(V2_ENTRY_SIGNATURES,name) || name === 'ws_init' || name === V2_WORK_ENTRIES[lane])).map(([name,value]) => named(name).concat([value.kind],uint(entries.get(value.index) ?? value.index)));
56
+ for (let i = 0; i < image.globals.length; i++) if (image.globals[i]?.mutable) exports.push([...named(`__state_${i}`),3,...uint(i)]);
57
+ const bodies = image.bodies.map((body,index) => {
58
+ if (index === reader?.index) { const plain = [0,...charge(fuel,2),0x23,...uint(fuel),0x0b];return [...uint(plain.length),...plain]; }
59
+ return getters.has(index) ? [...uint(body.bytes.length),...body.bytes] : metered(body,fuel,getters);
60
+ });
61
+ for (const target of entries.keys()) { const type = image.types[image.functions[target] ?? -1]; if (type === undefined) throw new Error('Missing v2 entry type'); bodies.push(wrapper(type,target,fuel)); }
62
+ const replacements = new Map([[3,vector(functions.map(value => uint(value)))],[6,globalBytes],[7,vector(exports)],[10,vector(bodies)]]), output = [...bytes.subarray(0,8)];
63
+ const emitted = new Set<number>();
64
+ for (const input of image.sections) {
65
+ if (input.id === 0) continue; // stale names no longer describe wrapper indices
66
+ for (const [id,data] of replacements) if (id < input.id && !emitted.has(id)) { for (const value of section(id,data)) output.push(value); emitted.add(id); }
67
+ for (const value of section(input.id,replacements.get(input.id) ?? [...input.bytes])) output.push(value); emitted.add(input.id);
68
+ }
69
+ for (const [id,data] of replacements) if (!emitted.has(id)) for (const value of section(id,data)) output.push(value);
70
+ const result = new Uint8Array(output); inspectV2Fuel(result,{ lane }); return result;
71
+ }
@@ -0,0 +1,74 @@
1
+ import * as v from 'valibot';
2
+
3
+ /** Build-time topology ordinals and the optional shared grid emitted by the SDK whole-shape producer. */
4
+ export interface WholePartitionRows {
5
+ id: string; vertices: number[]; triangles: number[]; vertexCount: number; indexCount: number; index: 'none' | 'u16' | 'u32';
6
+ grid?: { origin: [number, number, number]; step: number };
7
+ }
8
+ /** Portable source channels accepted by an offline float-channel reconstruction. */
9
+ export interface WholeSourceChannel {
10
+ semantic: string; storage: 'Float32Array' | 'Int16Array' | 'Int8Array' | 'Uint8Array'; normalized: boolean; itemSize: number;
11
+ }
12
+ const ordinal = v.pipe(v.number(), v.integer(), v.minValue(0));
13
+ const ordinals = v.union([v.array(ordinal), v.pipe(v.strictObject({ runs: v.array(ordinal) }),
14
+ v.check(row => row.runs.length % 2 === 0 && row.runs.every((n, i) => i % 2 === 0 || n > 0)
15
+ && row.runs.reduce((sum, n, i) => sum + (i % 2 === 1 ? n : 0), 0) <= 1 << 24),
16
+ v.transform(row => { const result: number[] = []; for (let i = 0; i < row.runs.length; i += 2) {
17
+ const start = row.runs[i] ?? 0, count = row.runs[i + 1] ?? 0;
18
+ for (let k = 0; k < count; k++) result.push(start + k);
19
+ } return result; }))]);
20
+ const partition = v.strictObject({ id: v.string(), vertices: ordinals, triangles: ordinals,
21
+ vertexCount: v.pipe(ordinal, v.minValue(1)), indexCount: ordinal, index: v.picklist(['none', 'u16', 'u32']),
22
+ grid: v.exactOptional(v.strictObject({ origin: v.tuple([v.pipe(v.number(), v.finite()), v.pipe(v.number(), v.finite()), v.pipe(v.number(), v.finite())]),
23
+ step: v.pipe(v.number(), v.minValue(1 / 4096), v.maxValue(1)) })) });
24
+ const channels = v.record(v.string(), v.pipe(v.strictObject({ semantic: v.string(), storage: v.picklist(['Float32Array', 'Int16Array', 'Int8Array', 'Uint8Array']),
25
+ normalized: v.boolean(), itemSize: v.pipe(v.number(), v.integer(), v.minValue(1), v.maxValue(4)) }),
26
+ v.check(row => row.storage === 'Float32Array' ? !row.normalized
27
+ : row.storage === 'Int16Array' ? row.semantic === 'POSITION' && row.itemSize === 3 && !row.normalized
28
+ : row.storage === 'Int8Array' ? row.semantic === 'NORMAL' && row.itemSize === 3 && row.normalized
29
+ : row.semantic === 'COLOR_0' && row.normalized)));
30
+
31
+ /** Strict topology/grid intake; retains the original bounded ordinal-run expansion. */
32
+ export function parseWholePartition(input: unknown): WholePartitionRows { return v.parse(partition, input); }
33
+ /** Only the SDK's portable native/compact float-reconstruction channel forms. */
34
+ export function parseWholeSourceChannels(input: unknown): Record<string, WholeSourceChannel> { return v.parse(channels, input); }
35
+
36
+ /** Select the complete file closure for named original shapes. A selected file
37
+ * may contain another shape's partitions; all of that shape's files join too,
38
+ * so the ordinary whole reader retains every completeness/conflict refusal.
39
+ * Only metadata is inspected here. Cost admission and runtime decoding still
40
+ * validate the original, unchanged GLBs and every selected topology ordinal. */
41
+ export function wholePartitionFiles(files: readonly string[], read: (file: string) => Uint8Array, required: readonly string[]): string[] {
42
+ if (files.length > 4096 || required.length === 0 || required.length > 1024 || new Set(files).size !== files.length
43
+ || new Set(required).size !== required.length || required.some(id => id.length === 0)) throw new Error('Invalid whole source selection');
44
+ const names = new Map<string, Set<string>>(), present = new Set<string>();
45
+ for (const file of files) {
46
+ const bytes = read(file);
47
+ if (bytes.length < 20 || bytes.length > 25_000_000) throw new Error('Whole source GLB wire cap');
48
+ const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength), size = view.getUint32(12, true);
49
+ if (view.getUint32(0, true) !== 0x46546c67 || view.getUint32(4, true) !== 2 || view.getUint32(8, true) !== bytes.length
50
+ || view.getUint32(16, true) !== 0x4e4f534a || size > 2_000_000 || size % 4 !== 0 || 20 + size > bytes.length) throw new Error('Invalid whole source GLB header');
51
+ const input: unknown = JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(bytes.subarray(20, 20 + size)));
52
+ const document = v.parse(v.object({ asset: v.object({ version: v.literal('2.0') }), nodes: v.optional(v.pipe(v.array(v.object({ extras: v.optional(v.unknown()) })), v.maxLength(10_000)), []) }), input);
53
+ const ids = new Set<string>();
54
+ for (const node of document.nodes) {
55
+ const extras = node.extras;
56
+ if (typeof extras !== 'object' || extras === null || Array.isArray(extras) || !Object.hasOwn(extras, 'wholePartition')) continue;
57
+ const row = parseWholePartition(Reflect.get(extras, 'wholePartition'));
58
+ if (row.id.length === 0 || row.id.length > 512) throw new Error('Invalid whole source shape identity');
59
+ ids.add(row.id); present.add(row.id);
60
+ }
61
+ names.set(file, ids);
62
+ }
63
+ for (const id of required) if (!present.has(id)) throw new Error(`Missing whole source shape: ${id}`);
64
+ const wanted = new Set(required), selected = new Set<string>();
65
+ let changed = true;
66
+ while (changed) {
67
+ changed = false;
68
+ for (const [file, ids] of names) {
69
+ if (selected.has(file) || ![...ids].some(id => wanted.has(id))) continue;
70
+ selected.add(file); for (const id of ids) wanted.add(id); changed = true;
71
+ }
72
+ }
73
+ return files.filter(file => selected.has(file));
74
+ }
@@ -0,0 +1,147 @@
1
+ import { BufferAttribute, BufferGeometry, Float16BufferAttribute, InterleavedBufferAttribute, Matrix3, Matrix4, Vector3, type TypedArrayConstructor } from 'three';
2
+ import { mergeGeometries } from 'three/examples/jsm/utils/BufferGeometryUtils.js';
3
+ import type { WholeGeometryPiece } from '@wildshard/engine/game/plugin/geometry';
4
+
5
+ function raw(attribute: BufferAttribute | InterleavedBufferAttribute, vertex: number, lane: number): number | undefined {
6
+ return attribute instanceof InterleavedBufferAttribute ? attribute.data.array[vertex * attribute.data.stride + attribute.offset + lane] : attribute.array[vertex * attribute.itemSize + lane];
7
+ }
8
+ function gpuType(attribute: BufferAttribute | InterleavedBufferAttribute): BufferAttribute['gpuType'] | undefined {
9
+ return attribute instanceof BufferAttribute ? attribute.gpuType : undefined;
10
+ }
11
+
12
+ /** Same native getters, vector operations and per-transform storage rounding as
13
+ * BufferGeometry.applyMatrix4. Private intermediate bounds are not consumed by
14
+ * the union; its caller restores the original frozen draw bounds. */
15
+ function* transform(geometry: BufferGeometry, matrix: Matrix4): Generator<void> {
16
+ const vector = new Vector3(), normalMatrix = new Matrix3().getNormalMatrix(matrix);
17
+ for (const name of ['position', 'normal', 'tangent']) {
18
+ const attribute = geometry.getAttribute(name); if (attribute === undefined) continue;
19
+ for (let i = 0; i < attribute.count; i++) {
20
+ if (i % 256 === 0) yield;
21
+ vector.fromBufferAttribute(attribute, i);
22
+ if (name === 'position') vector.applyMatrix4(matrix);
23
+ else if (name === 'normal') vector.applyNormalMatrix(normalMatrix);
24
+ else vector.transformDirection(matrix);
25
+ attribute.setXYZ(i, vector.x, vector.y, vector.z);
26
+ }
27
+ attribute.needsUpdate = true;
28
+ }
29
+ }
30
+
31
+ /** Merge the admitted rigid channels in the original piece order. Preallocate
32
+ * indices instead of growing a boxed-number array, retaining Three's exact
33
+ * 65535 primitive-restart boundary and native attribute storage. */
34
+ function* merge(copies: readonly BufferGeometry[]): Generator<void, BufferGeometry> {
35
+ const first = copies[0]; if (first === undefined) return new BufferGeometry();
36
+ // WholeGeometryPiece's admission rejects morphs. Preserve the original pure
37
+ // helper's compatibility for independently constructed non-rigid callers.
38
+ if (copies.some(copy => Object.keys(copy.morphAttributes).length > 0)) {
39
+ const joined = mergeGeometries([...copies], false);
40
+ if (joined === null) throw new Error('Whole piece channels cannot join');
41
+ return joined;
42
+ }
43
+ const indexed = first.index !== null, names = Object.keys(first.attributes), geometry = new BufferGeometry();
44
+ let complete = false;
45
+ try {
46
+ for (const copy of copies) {
47
+ if ((copy.index !== null) !== indexed || Object.keys(copy.attributes).length !== names.length
48
+ || names.some(name => copy.getAttribute(name) === undefined) || copy.morphTargetsRelative !== first.morphTargetsRelative) throw new Error('Whole piece channels cannot join');
49
+ }
50
+ if (indexed) {
51
+ const indices = new Uint32Array(copies.reduce((n, copy) => n + (copy.index?.count ?? 0), 0));
52
+ let offset = 0, written = 0, wide = false;
53
+ for (const copy of copies) {
54
+ const index = copy.index; if (index === null) throw new Error('Whole piece channels cannot join');
55
+ for (let i = 0; i < index.count; i++) {
56
+ if (i % 1024 === 0) yield;
57
+ const value = index.getX(i) + offset; indices[written++] = value; wide ||= value >= 65535;
58
+ }
59
+ offset += copy.getAttribute('position').count;
60
+ }
61
+ geometry.setIndex(new BufferAttribute(wide ? indices : Uint16Array.from(indices), 1));
62
+ }
63
+ for (const name of names) {
64
+ yield;
65
+ const attributes = copies.map(copy => copy.getAttribute(name)), template = attributes[0];
66
+ if (template === undefined) throw new Error('Whole piece channels cannot join');
67
+ // NR2: a half-float channel is its class, not its storage (three uploads a plain Uint16Array as integers), so the
68
+ // union keeps the Float16 wrapper: Nine's fabric aFace / aPat read as raw half bits shaded its stone flat
69
+ const half = template instanceof Float16BufferAttribute;
70
+ for (const attribute of attributes) if (attribute.array.constructor !== template.array.constructor || attribute.itemSize !== template.itemSize
71
+ || attribute.normalized !== template.normalized || gpuType(attribute) !== gpuType(template) || (attribute instanceof Float16BufferAttribute) !== half) throw new Error('Whole piece channels cannot join');
72
+ // TypedArray.constructor loses its construct signature in lib.d.ts;
73
+ // admission and the exact constructor check above retain its native type.
74
+ const Storage = template.array.constructor as TypedArrayConstructor;
75
+ const array = new Storage(attributes.reduce((n, attribute) => n + attribute.count * attribute.itemSize, 0));
76
+ let offset = 0;
77
+ for (const attribute of attributes) {
78
+ if (attribute instanceof InterleavedBufferAttribute) {
79
+ // the stored words as they are (no normalize or half-float round trip)
80
+ for (let i = 0, at = offset; i < attribute.count; i++) {
81
+ if (i % 256 === 0) yield;
82
+ for (let lane = 0; lane < template.itemSize; lane++) array[at++] = raw(attribute, i, lane) ?? 0;
83
+ }
84
+ } else for (let i = 0; i < attribute.array.length; i += 16384) {
85
+ yield; array.set(attribute.array.subarray(i, i + 16384), offset + i);
86
+ }
87
+ offset += attribute.count * template.itemSize;
88
+ }
89
+ // Float16BufferAttribute copies its array, so it wraps the filled storage last
90
+ const joined = half && array instanceof Uint16Array ? new Float16BufferAttribute(array, template.itemSize, template.normalized) : new BufferAttribute(array, template.itemSize, template.normalized), kind = gpuType(template);
91
+ if (kind !== undefined) joined.gpuType = kind;
92
+ geometry.setAttribute(name, joined);
93
+ }
94
+ complete = true; return geometry;
95
+ } finally { if (!complete) geometry.dispose(); }
96
+ }
97
+
98
+ /** Validate every shared original lane, including signed zero, before a new
99
+ * one-draw union can publish. A caller may yield between bounded scalar chunks;
100
+ * closing the cursor disposes all private intermediate geometry. */
101
+ export function* joinWholePieceSteps(pieces: readonly WholeGeometryPiece[], pose?: readonly number[], forceIdentityTransform = false): Generator<void, BufferGeometry | undefined> {
102
+ const first = pieces[0]; if (first === undefined) return new BufferGeometry();
103
+ const vertices = new Map<number, { readonly piece: WholeGeometryPiece; readonly local: number }>(), triangles = new Set<number>();
104
+ for (const piece of pieces) {
105
+ if (piece.part !== first.part || piece.layout !== first.layout || !piece.matrix.equals(first.matrix)
106
+ || piece.vertexCount !== first.vertexCount || piece.indexCount !== first.indexCount) throw new Error('Whole source layout or transform differs');
107
+ let checked = 0;
108
+ for (const triangle of piece.triangles) {
109
+ if (checked++ % 256 === 0) yield;
110
+ if (triangles.has(triangle)) throw new Error('Whole duplicate or invalid triangle'); triangles.add(triangle);
111
+ }
112
+ const attributes = Object.entries(piece.geometry.attributes);
113
+ for (const [local, ordinal] of piece.vertices.entries()) {
114
+ if (local % 256 === 0) yield;
115
+ const prior = vertices.get(ordinal);
116
+ if (prior === undefined) { vertices.set(ordinal, { piece, local }); continue; }
117
+ for (const [name, attribute] of attributes) {
118
+ const other = prior.piece.geometry.getAttribute(name);
119
+ if (other === undefined || attribute.itemSize !== other.itemSize) throw new Error('Whole channel layout differs');
120
+ for (let lane = 0; lane < attribute.itemSize; lane++) if (!Object.is(raw(attribute, local, lane), raw(other, prior.local, lane))) throw new Error('Whole shared vertex differs');
121
+ }
122
+ }
123
+ }
124
+ const copies: BufferGeometry[] = [], identity = new Matrix4();
125
+ try {
126
+ for (const piece of pieces) {
127
+ yield;
128
+ const copy = piece.geometry.clone(); copies.push(copy);
129
+ if (forceIdentityTransform || pose !== undefined || !piece.matrix.equals(identity)) yield* transform(copy, piece.matrix);
130
+ if (pose !== undefined) yield* transform(copy, new Matrix4().fromArray(pose));
131
+ }
132
+ return yield* merge(copies);
133
+ } finally { for (const copy of copies) copy.dispose(); }
134
+ }
135
+
136
+ /** Synchronous bake oracle over the exact source-piece cursor. Runtime
137
+ * readers consume the baked chunks and never reconstruct this union. */
138
+ export function joinWholePieces(pieces: readonly WholeGeometryPiece[], pose?: readonly number[], forceIdentityTransform = false): BufferGeometry {
139
+ const steps = joinWholePieceSteps(pieces, pose, forceIdentityTransform);
140
+ for (;;) {
141
+ const next = steps.next();
142
+ if (next.done) {
143
+ if (next.value === undefined) throw new Error('Whole piece join did not complete');
144
+ return next.value;
145
+ }
146
+ }
147
+ }