@wildshard/sdk 0.0.1 → 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 +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 +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,74 @@
1
+ // oxlint-disable-next-line import/no-nodejs-modules -- Only the checked build host installs its pinned compiler tool.
2
+ import { execFileSync } from 'node:child_process';
3
+ // oxlint-disable-next-line import/no-nodejs-modules -- Atomic tool installation and verification stay outside author bundles.
4
+ import { existsSync, mkdirSync, mkdtempSync, renameSync, rmSync, writeFileSync } from 'node:fs';
5
+ // oxlint-disable-next-line import/no-nodejs-modules -- The trusted tool cache belongs to the build user.
6
+ import { homedir } from 'node:os';
7
+ // oxlint-disable-next-line import/no-nodejs-modules -- Only pinned relative source names enter these paths.
8
+ import { dirname, resolve } from 'node:path';
9
+ // oxlint-disable-next-line import/no-nodejs-modules -- Native compiler flags and tool cache keys name the actual host.
10
+ import process from 'node:process';
11
+ import * as v from 'valibot';
12
+ import { BASIS_INPUTS, BASIS_REVISION } from './basisToolInputs';
13
+ import { encodeCanonicalJson, hashImmutableBytes } from '../immutable';
14
+ import { readBoundedFile } from '../sourceReader';
15
+
16
+ const digest = v.pipe(v.string(), v.regex(/^[a-f0-9]{64}$/u));
17
+ const Receipt = v.strictObject({ key: digest, binary: digest });
18
+ const flags = ['-ffp-contract=on'];
19
+ const text = new TextEncoder();
20
+ /** Compiler recipe is part of the installed artifact identity, including the original fused arithmetic. */
21
+ export function basisToolRecipe(platform: string, arch: string): readonly string[] {
22
+ if (!['darwin', 'linux'].includes(platform) || !['arm64', 'x64'].includes(arch)) throw new Error('Unsupported Basis build host');
23
+ return [...flags, ...(arch === 'x64' ? ['-mfma'] : [])];
24
+ }
25
+ /** Pin source, compiler recipe and resulting executable. Missing/corrupt published tools refuse, never use PATH. */
26
+ export async function prepareBasisTool(cacheRoot: string = resolve(homedir(), '.cache/wildshard/basis')): Promise<{ readonly file: string; readonly identity: string }> {
27
+ const recipe = { revision: BASIS_REVISION, inputs: BASIS_INPUTS, platform: process.platform, arch: process.arch,
28
+ flags: basisToolRecipe(process.platform, process.arch), compiler: 'clang', configuration: 'Release', examples: false, sse: false };
29
+ const key = hashImmutableBytes(text.encode(encodeCanonicalJson(recipe))), directory = resolve(cacheRoot, key), file = resolve(directory, 'source/bin/basisu');
30
+ const verify = (): { readonly file: string; readonly identity: string } => {
31
+ const receipt = v.parse(Receipt, JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(readBoundedFile(resolve(directory, 'receipt.json'), 1024))));
32
+ const binary = hashImmutableBytes(readBoundedFile(file, 64_000_000));
33
+ if (receipt.key !== key || receipt.binary !== binary) throw new Error('Pinned Basis executable identity differs');
34
+ return { file, identity: hashImmutableBytes(text.encode(encodeCanonicalJson({ key, binary }))) };
35
+ };
36
+ if (existsSync(directory)) return verify();
37
+ mkdirSync(cacheRoot, { recursive: true });
38
+ const temporary = mkdtempSync(resolve(cacheRoot, '.building-')), source = resolve(temporary, 'source');
39
+ try {
40
+ let cursor = 0;
41
+ const downloads = await Promise.allSettled(Array.from({ length: 4 }, async () => {
42
+ for (;;) {
43
+ const row = BASIS_INPUTS[cursor++]; if (row === undefined) return;
44
+ const [name, expected] = row;
45
+ const response = await fetch(`https://raw.githubusercontent.com/BinomialLLC/basis_universal/${BASIS_REVISION}/${name}`, { signal: AbortSignal.timeout(30000) });
46
+ if (!response.ok || response.body === null) throw new Error(`Missing pinned Basis source: ${name}`);
47
+ const reader = response.body.getReader(), chunks: Uint8Array[] = []; let size = 0;
48
+ try {
49
+ for (;;) { const next = await reader.read(); if (next.done) break; size += next.value.length;
50
+ if (size > 4_000_000) throw new Error('Basis source exceeds file cap'); chunks.push(next.value); }
51
+ } finally { await reader.cancel(); }
52
+ const bytes = new Uint8Array(size); let at = 0;
53
+ for (const chunk of chunks) { bytes.set(chunk, at); at += chunk.length; }
54
+ if (hashImmutableBytes(bytes) !== expected) throw new Error(`Pinned Basis source identity differs: ${name}`);
55
+ const path = resolve(source, name); mkdirSync(dirname(path), { recursive: true }); writeFileSync(path, bytes);
56
+ }
57
+ }));
58
+ for (const download of downloads) if (download.status === 'rejected') throw download.reason;
59
+ const nativeFlags = recipe.flags.join(' '), build = resolve(temporary, 'build');
60
+ execFileSync('cmake', ['-S', source, '-B', build, '-DCMAKE_BUILD_TYPE=Release', '-DBASISU_EXAMPLES=OFF', '-DBASISU_SSE=OFF',
61
+ '-DCMAKE_C_COMPILER=clang', '-DCMAKE_CXX_COMPILER=clang++', `-DCMAKE_C_FLAGS=${nativeFlags}`, `-DCMAKE_CXX_FLAGS=${nativeFlags}`,
62
+ ...(process.platform === 'darwin' ? [`-DCMAKE_OSX_ARCHITECTURES=${process.arch === 'x64' ? 'x86_64' : 'arm64'}`] : [])], { timeout: 120000, maxBuffer: 2_000_000 });
63
+ // Cold clang builds exceed two minutes on the two-core Linux runner.
64
+ // Ring 2 prepares this verified prerequisite; Ring 3 reuses its receipt.
65
+ execFileSync('cmake', ['--build', build, '--target', 'basisu', '-j4'], { timeout: 300000, maxBuffer: 2_000_000 });
66
+ const binary = hashImmutableBytes(readBoundedFile(resolve(source, 'bin/basisu'), 64_000_000));
67
+ writeFileSync(resolve(temporary, 'receipt.json'), encodeCanonicalJson({ key, binary }));
68
+ // Only the source, license and resulting executable are needed after compilation.
69
+ rmSync(build, { recursive: true });
70
+ try { renameSync(temporary, directory); }
71
+ catch (error) { if (!(error instanceof Error && 'code' in error && ['EEXIST', 'ENOTEMPTY'].includes(String(error.code)))) throw error; }
72
+ return verify();
73
+ } finally { rmSync(temporary, { recursive: true, force: true }); }
74
+ }
@@ -0,0 +1,476 @@
1
+ /** Unmodified Basis Universal v2.50 build inputs (Apache-2.0); fetched only by the trusted build host. */
2
+ export const BASIS_REVISION = '9bebe16726b3a61c8c213eeee3b7cffb462ef34e';
3
+ export const BASIS_INPUTS: readonly (readonly [string, string])[] = [
4
+ [
5
+ "CMakeLists.txt",
6
+ "77240391f35b30cc6c409a32a81c7d1690d2b41eed6130e83c2f4efe654c3725"
7
+ ],
8
+ [
9
+ "LICENSE",
10
+ "065fcf48d6af21c0b75e23be5ed5753aee75c892e1c2cf178fa6736305614a5c"
11
+ ],
12
+ [
13
+ "NOTICE",
14
+ "a710c77f53231533f19fbc00e04a7109077f2dec74232b62a96f2ac1a1c04c85"
15
+ ],
16
+ [
17
+ "basisu.manifest",
18
+ "c545044c127a74966aaec0693053c3d02dc095b63bdc0d9ced17969220de2789"
19
+ ],
20
+ [
21
+ "basisu_text_image.cpp",
22
+ "00d7c88bb8d93915a9f847afcd4388d1c8e15343df6cbee27830d6da8e40aed1"
23
+ ],
24
+ [
25
+ "basisu_text_image.h",
26
+ "5f23791ebedda6923a4860c9c76c73cf77c23ccbda3424db2ea20c037cfd22a6"
27
+ ],
28
+ [
29
+ "basisu_tool.cpp",
30
+ "054c007d09356e403f2de5fa7c9e8213ae55bb7b0100c02c42f01f66950ebcbf"
31
+ ],
32
+ [
33
+ "basisu_tool_help.h",
34
+ "35f436613760d16f2a52bb24047da6e0c532a5fa17199b47bd828023f100bf01"
35
+ ],
36
+ [
37
+ "basisu_tool_test_codecs.inl",
38
+ "f325fe839b8cbb501100de07d9d020508e480b90b0e9b280240736e400ba57a2"
39
+ ],
40
+ [
41
+ "encoder/3rdparty/android_astc_decomp.cpp",
42
+ "c4c0a8c87829a764b2066ce6d90f682736e95803136e6a29ede9c9ac65c9b31f"
43
+ ],
44
+ [
45
+ "encoder/3rdparty/exr_reader.hh",
46
+ "9e0bfef0487b9c3082165b2a637c75ef91d9fcc4aa55a5f32eb97f77db19f99b"
47
+ ],
48
+ [
49
+ "encoder/3rdparty/qoi.h",
50
+ "48e138b971f12f0287b132d423c6a96d4677d97a383656c7636777421ed79cbe"
51
+ ],
52
+ [
53
+ "encoder/3rdparty/streamreader.hh",
54
+ "81f2d1502930ca9ca9957e7607c2a7924d3ef2fe4b08b1a4001245dc6d3fefb6"
55
+ ],
56
+ [
57
+ "encoder/3rdparty/tinydds.h",
58
+ "30290928c699c1f37f99189eb5d71749bdda953caacbd3b5a03c834ddf05c888"
59
+ ],
60
+ [
61
+ "encoder/3rdparty/tinyexr.h",
62
+ "9c7f087a54edd125fb36a2d90da6c6cb0182a98c673c0adf9bfdd04be9ef0141"
63
+ ],
64
+ [
65
+ "encoder/basisu_astc_hdr_6x6_enc.cpp",
66
+ "f6291928074d2876524d7f43a0db1c3e15560bc7315a21562a45f8406880e4bd"
67
+ ],
68
+ [
69
+ "encoder/basisu_astc_hdr_6x6_enc.h",
70
+ "42886973bef8906f9e6535542809779489e5a605f19de54a7f70818122ec012b"
71
+ ],
72
+ [
73
+ "encoder/basisu_astc_hdr_common.cpp",
74
+ "16fed85aa25d9a729075433cd98756a60e85b39f84616843cd40c39d28ff64c5"
75
+ ],
76
+ [
77
+ "encoder/basisu_astc_hdr_common.h",
78
+ "c98b41c66a7f4c010b0ff4ca8bfabc317c882649306a887ac4d8d86d9f0fa427"
79
+ ],
80
+ [
81
+ "encoder/basisu_astc_ldr_common.cpp",
82
+ "fb477e4429442a618d63d24041dfbdae2b340e4211958fafc0dbda00d5aa6c87"
83
+ ],
84
+ [
85
+ "encoder/basisu_astc_ldr_common.h",
86
+ "cc3224d7dd343307b2926c013b172d5a935265415df7084f2936bb946224b224"
87
+ ],
88
+ [
89
+ "encoder/basisu_astc_ldr_encode.cpp",
90
+ "de09685b9084549e9ca559ec809c7cd4c9902aae11d56d8e5775e222e01127d6"
91
+ ],
92
+ [
93
+ "encoder/basisu_astc_ldr_encode.h",
94
+ "59da8d06a703c3d0c5087b469ed0f1cf57d205f7e63be2801ea6fe78104e5fe4"
95
+ ],
96
+ [
97
+ "encoder/basisu_astc_ldr_fencode.cpp",
98
+ "23602173069696853e6b62b95e36b3a148a812294b736bb6768daced89720a50"
99
+ ],
100
+ [
101
+ "encoder/basisu_astc_ldr_fencode.h",
102
+ "9b89d1b5a1c83bf5d393de14f084937e82a2c553344400c28e385d9050ea5542"
103
+ ],
104
+ [
105
+ "encoder/basisu_astc_ldr_pseudoinv_tab.inl",
106
+ "d1aa5de6ebc0ddc625d78344c49a59e47e1d9c077b3a65dee5dbcd536318381c"
107
+ ],
108
+ [
109
+ "encoder/basisu_backend.cpp",
110
+ "e6e470d9af8a91947f8be99e5fc0ebda6dd3433263feaac5d89480a771e695ee"
111
+ ],
112
+ [
113
+ "encoder/basisu_backend.h",
114
+ "f54f905f9afef880c7d507a05e33636d54ec7d5ac9ed2fc5b7ae043d8643c137"
115
+ ],
116
+ [
117
+ "encoder/basisu_basis_file.cpp",
118
+ "10610c5df3f4719d7b0359f7fef4160e7bc4e1aa756ec3553d8ae2f3c488e33f"
119
+ ],
120
+ [
121
+ "encoder/basisu_basis_file.h",
122
+ "40ee6dae86be2eab243efba191b5de3be44bbd28630f37481e4bb778c7f95e97"
123
+ ],
124
+ [
125
+ "encoder/basisu_bc15_spmd.cpp",
126
+ "0866176ebd3eb710768516b47221d4b42b06e632fa378e52d6759c1b37088134"
127
+ ],
128
+ [
129
+ "encoder/basisu_bc15_spmd.h",
130
+ "02bca54b54e046a719a984ae37ee63f56914884bd62a6082fe41e7938e1c429b"
131
+ ],
132
+ [
133
+ "encoder/basisu_bc15_spmd_kernels.inl",
134
+ "70d768f5a7e2f5390bb34880219d3613ee95ecb8c56a3706300022e50dc5c142"
135
+ ],
136
+ [
137
+ "encoder/basisu_bc15_spmd_sse.cpp",
138
+ "ec43dc249c0153fe0cef53192970da2fb4897ea0d2f17c000e0c5091bedfe018"
139
+ ],
140
+ [
141
+ "encoder/basisu_bc7e_scalar.cpp",
142
+ "684b106e6037042bee065694e5956a97ba91cf2b2417c1a44217e0087a5e808f"
143
+ ],
144
+ [
145
+ "encoder/basisu_bc7e_scalar.h",
146
+ "5395f673cbdb9b4ce5115d18369f36b6002712bf88ac3ce71170cdeace889b79"
147
+ ],
148
+ [
149
+ "encoder/basisu_bc7enc.cpp",
150
+ "56cb444a02971c4900baf6a4811f9e4fa5295a7770525c365f26cdbd6205a698"
151
+ ],
152
+ [
153
+ "encoder/basisu_bc7enc.h",
154
+ "221361cdb72af44085c094d8adc3f4e6d46523bac80d8a84a76f33d8a0f1e182"
155
+ ],
156
+ [
157
+ "encoder/basisu_comp.cpp",
158
+ "3c3519d51eb2c8e5d90af2eeaaa0307cd8a78688feb33012e0bfc73343fe44af"
159
+ ],
160
+ [
161
+ "encoder/basisu_comp.h",
162
+ "319cfaa0beb24f0d903edb8d8ba767b2fc6d512b7f9ee9bdaa39f5c9a10d8988"
163
+ ],
164
+ [
165
+ "encoder/basisu_dds_export.cpp",
166
+ "4b6b7fa4b7e82fc9d312efcce439d0d34545ed007ffe386ee46ae0d003ec69f9"
167
+ ],
168
+ [
169
+ "encoder/basisu_dds_export.h",
170
+ "c102cf5cf9476e69278f48b3840f6868bd302b6988cd36548dfac3c4b133f006"
171
+ ],
172
+ [
173
+ "encoder/basisu_enc.cpp",
174
+ "33725cb025ad510e2c01eecdbecf5a3d1815f5b568e16758ef0f9fdbd31556cb"
175
+ ],
176
+ [
177
+ "encoder/basisu_enc.h",
178
+ "f286610406f3d8fc33c331b5e8f4ebe34aaddcc59cb1b7df35afd6356409c946"
179
+ ],
180
+ [
181
+ "encoder/basisu_etc.cpp",
182
+ "7f4db9b8e269e6b8d368385c98a218d43766138efdeaa7d81286a95da9a549f9"
183
+ ],
184
+ [
185
+ "encoder/basisu_etc.h",
186
+ "f6b343d43cfaa3b502ef8c2a9351a7da74233b3d49f4285dcb6232b2c8ce4462"
187
+ ],
188
+ [
189
+ "encoder/basisu_frontend.cpp",
190
+ "39b55d58b1da44273e107b261b89b8f9fc7aff302c681c252d7ac62d6525d9e8"
191
+ ],
192
+ [
193
+ "encoder/basisu_frontend.h",
194
+ "c16e6080738ba3afd317aa35a52681e87f54fcda37eace678545016e4a6e9723"
195
+ ],
196
+ [
197
+ "encoder/basisu_gpu_texture.cpp",
198
+ "b5d364829dcfb0a00b8161eac8b0d656831bfbcea0ece11f6972f583814fa311"
199
+ ],
200
+ [
201
+ "encoder/basisu_gpu_texture.h",
202
+ "7dca2c433b059eb1ef17fb3d87f59491670afd10fa999ac12d27c38fca3b8e93"
203
+ ],
204
+ [
205
+ "encoder/basisu_kernels_declares.h",
206
+ "8cc894e849bb8634d66aa934336d2e4fcd1fdabb6b8ce27eb0611f0e64be2feb"
207
+ ],
208
+ [
209
+ "encoder/basisu_kernels_imp.h",
210
+ "927ee436c23c4e4b9e1f6474746fd2768bd230f06bbdb3eeaf368b436c69d70e"
211
+ ],
212
+ [
213
+ "encoder/basisu_kernels_sse.cpp",
214
+ "c2f597ae8bed9c986e77588b623203854115b9a86ab1b9d44a078bb7d2bd066d"
215
+ ],
216
+ [
217
+ "encoder/basisu_math.h",
218
+ "f6cabd939be1278abf317f7818facb5e3298bf498d32d769d50be6f37153402f"
219
+ ],
220
+ [
221
+ "encoder/basisu_miniz.h",
222
+ "96bb1cc709ef4465fe76513ee56a10cd56e1643c7898275f18d3cf6960b849e4"
223
+ ],
224
+ [
225
+ "encoder/basisu_ocl_kernels.h",
226
+ "e6260419ee511cf7bd3a2646ab57d521f26deab8bd7380e74d5db8c2e6fa55ad"
227
+ ],
228
+ [
229
+ "encoder/basisu_opencl.cpp",
230
+ "762eec61f4dbe443fd79f34d6fd622a41befea6c7629d088c0523f8d7a12180d"
231
+ ],
232
+ [
233
+ "encoder/basisu_opencl.h",
234
+ "869cd850e14813dfac23074b033e45e700dd1e9e0e1699128cb8624820509de9"
235
+ ],
236
+ [
237
+ "encoder/basisu_pvrtc1_4.cpp",
238
+ "973a229630e42a797d501cd2a5fa49f20dcd739129949f6c3861fad8ef725043"
239
+ ],
240
+ [
241
+ "encoder/basisu_pvrtc1_4.h",
242
+ "9485683b545782ad6ecc1a9d1c51e339a1dac1ebc55022a64c8aeceefa813498"
243
+ ],
244
+ [
245
+ "encoder/basisu_resample_filters.cpp",
246
+ "7ed1324235705ae816b89a94d17e8eea147a84e5c98194b59b35b5ac23e65688"
247
+ ],
248
+ [
249
+ "encoder/basisu_resampler.cpp",
250
+ "f3bcaf9facf049b0e3c08d3ad3432a908d8707e68e536140e15d913dd967ec70"
251
+ ],
252
+ [
253
+ "encoder/basisu_resampler.h",
254
+ "0f157726034d750267b3e62c0b001cc2e32057e90aaa26ce25e98d8f7f40c0a2"
255
+ ],
256
+ [
257
+ "encoder/basisu_resampler_filters.h",
258
+ "8975adbe9656b0094e9edcb67dffc98648c774bc6d58826eb553a7e5c2d47778"
259
+ ],
260
+ [
261
+ "encoder/basisu_ssim.cpp",
262
+ "0b80fa019f7400f4d704f835e34f6c24fb0513c267e9e030015c9dcd1adfb8ed"
263
+ ],
264
+ [
265
+ "encoder/basisu_ssim.h",
266
+ "8ec3677b5be06844ed5131f44e4e858dd194145caa805b48898bbc2c0dcee173"
267
+ ],
268
+ [
269
+ "encoder/basisu_tinyexr.cpp",
270
+ "037fe28fd943ac5ab9eac3c4c029447842a9a145e1780e613662b7360506244f"
271
+ ],
272
+ [
273
+ "encoder/basisu_uastc_enc.cpp",
274
+ "2f0364eb3c0f0d3291d65d93fd852e8b8464ee0230de3ad5e7821ed044ca4939"
275
+ ],
276
+ [
277
+ "encoder/basisu_uastc_enc.h",
278
+ "3a9841ebf58a49e0a7fe4caae470ac725381495bcc5e6f40272d5ae71290e610"
279
+ ],
280
+ [
281
+ "encoder/basisu_uastc_hdr_4x4_enc.cpp",
282
+ "6d738aca775b5d1e7f00ad7565b0af7b90697b9c82fa1ccb67c21d5afc37cdde"
283
+ ],
284
+ [
285
+ "encoder/basisu_uastc_hdr_4x4_enc.h",
286
+ "7c61c900802bc3d8de188a4fc52a1640ce460a42fab256cc1ed647c64dca3b20"
287
+ ],
288
+ [
289
+ "encoder/basisu_wasm_api.cpp",
290
+ "c9e1054e41f4f93cf1ed303e10c9b7f7f6c45df444ecf16654c253794ea313ff"
291
+ ],
292
+ [
293
+ "encoder/basisu_wasm_api.h",
294
+ "a6ccaa426ac04b3f3d2c8c6aa4065396853a1b1e21746239d1a27d0c04cd9e2d"
295
+ ],
296
+ [
297
+ "encoder/basisu_wasm_api_common.h",
298
+ "04f8ab464851405b6b45c706a2570ebe0ed3b153041a565d743c53e8f581c1cf"
299
+ ],
300
+ [
301
+ "encoder/basisu_wasm_transcoder_api.cpp",
302
+ "e668a15dafda2a5bed6b40bea8c71d02f3d67c2689d3047cf8c1c12b018e0c8b"
303
+ ],
304
+ [
305
+ "encoder/basisu_wasm_transcoder_api.h",
306
+ "f7fde3e1f221455075cf81849ac24a08ae66b9010cc3b094d86c33cdd205d955"
307
+ ],
308
+ [
309
+ "encoder/basisu_xbc7_encode.cpp",
310
+ "00a19d6be5fa46919671dc3518de8db8e9331f31e8348ddbca4aea4757268fc5"
311
+ ],
312
+ [
313
+ "encoder/basisu_xbc7_encode.h",
314
+ "cd73bc88be28bb654c9b79520a18c5538989e4425faac2acc4e7e292cdb46a88"
315
+ ],
316
+ [
317
+ "encoder/cppspmd_flow.h",
318
+ "af5a6f9db7662da6c641f1b809b16fcb5f6c5537719ba22f9ca4d1bf44eb1e45"
319
+ ],
320
+ [
321
+ "encoder/cppspmd_math.h",
322
+ "71eebd8e258a9bc81e22f40adba581270b80e8601ca621976c18fe6cb12801cd"
323
+ ],
324
+ [
325
+ "encoder/cppspmd_math_declares.h",
326
+ "157aaad9130eb48eac61fb088b9e7047f8417a1c5e4586fe0a1da4968bc25907"
327
+ ],
328
+ [
329
+ "encoder/cppspmd_sse.h",
330
+ "0689aa02c266be917a0c1c9cf2dba0a2f38e9c56c40603f27c0fd69c90dc949c"
331
+ ],
332
+ [
333
+ "encoder/cppspmd_type_aliases.h",
334
+ "dcff9416e208031155aa041cd0ffd7350839034f7a5bbb3293cb40ff3db865a0"
335
+ ],
336
+ [
337
+ "encoder/jpgd.cpp",
338
+ "96b5bddee685552ce5365b9fb9216bab0ccb9bb84860e919ffdf2fa0be177aee"
339
+ ],
340
+ [
341
+ "encoder/jpgd.h",
342
+ "9a27ac6bef93c230a0aa15fe9f31f8e84b5195f4f5ae500696d9177178237eb6"
343
+ ],
344
+ [
345
+ "encoder/pvpngreader.cpp",
346
+ "1bd3ceba3b1ff9f7d1324f4127d33553f122de39129059b4d157526de9feed93"
347
+ ],
348
+ [
349
+ "encoder/pvpngreader.h",
350
+ "8dfb6b1ecd495d29679c5a0d25b39beed32d7410f5f880b6b3a0b01926abff1c"
351
+ ],
352
+ [
353
+ "transcoder/basisu.h",
354
+ "2724dd59acbd332d43dde5f15a9b546ed851c45c7c2acbcdcab4a288c58628e0"
355
+ ],
356
+ [
357
+ "transcoder/basisu_astc_cfgs.inl",
358
+ "2f56d16cc37ddb6a5f361be42e3ab32ecbeefd94fd287d5bd46c15e0e1fdb34e"
359
+ ],
360
+ [
361
+ "transcoder/basisu_astc_hdr_core.h",
362
+ "4d1e2b68275c7f402623ab0824722d7e8d6e85adc2fc747a44c07e5321b366d4"
363
+ ],
364
+ [
365
+ "transcoder/basisu_astc_helpers.h",
366
+ "f698c23506c0e59f3bd4cb645bd3b4d071b06f1112a0cf6a0de19a19cff837f8"
367
+ ],
368
+ [
369
+ "transcoder/basisu_containers.h",
370
+ "84a17dcb701dd22a44381ae226e3e9cdc9d361e74efc640d0ccb8bbbb081ee41"
371
+ ],
372
+ [
373
+ "transcoder/basisu_containers_impl.h",
374
+ "9810baeca8b39497101997cf309c0cee153f096af21f1eb8e12c142410f5ef2a"
375
+ ],
376
+ [
377
+ "transcoder/basisu_dds_transcoder.inl",
378
+ "18f731ebe27b311efda2a576b3bc76f1e1b541b25e9a790a9759f76effc61833"
379
+ ],
380
+ [
381
+ "transcoder/basisu_etc1_mods.inl",
382
+ "ddf9efd40f07209c914f4051b94bbe1821915ae61b6ca39d61aafd0126c6dd0d"
383
+ ],
384
+ [
385
+ "transcoder/basisu_file_headers.h",
386
+ "5988f2d27e41a3f36ef5a2e350675dd30bd1ee2c70853e42a1d796a74d8178a9"
387
+ ],
388
+ [
389
+ "transcoder/basisu_idct.h",
390
+ "0b218ce8a9f72036c1e531387d2a168b950a2af2d5a40204f08a5ec381a2e4ee"
391
+ ],
392
+ [
393
+ "transcoder/basisu_transcoder.cpp",
394
+ "244cf0da60941c0311feed5e9c01b9225d6ca796292391d808a4fa3cf9e406f2"
395
+ ],
396
+ [
397
+ "transcoder/basisu_transcoder.h",
398
+ "d60e4d56c7dbc392ec476e484cc5030046ecd378c554a5ffa898ccd0e1ec1b08"
399
+ ],
400
+ [
401
+ "transcoder/basisu_transcoder_internal.h",
402
+ "9e12e4543d2872c4c0beb91bf9438d5bed1205d52358fd15671b747d8485369f"
403
+ ],
404
+ [
405
+ "transcoder/basisu_transcoder_tables_astc.inc",
406
+ "7dd41c648d3ed8e7d511eb4af865669c4dd50b8ecead62a68fca471138c46e1a"
407
+ ],
408
+ [
409
+ "transcoder/basisu_transcoder_tables_astc_0_255.inc",
410
+ "f41acb498be64349c48600e965664f4bec1161781169e3ec3411827c490ef4f8"
411
+ ],
412
+ [
413
+ "transcoder/basisu_transcoder_tables_atc_55.inc",
414
+ "4a510a20bffc3738d85d41e44633d44145931aa5734affb390c7836ec8b5dabb"
415
+ ],
416
+ [
417
+ "transcoder/basisu_transcoder_tables_atc_56.inc",
418
+ "94714b54f0c13c2f3ba5481fbfb40b974892048d59ab68419b369222f0a68075"
419
+ ],
420
+ [
421
+ "transcoder/basisu_transcoder_tables_bc7_m5_alpha.inc",
422
+ "4d713b839594f429d95f329d60f8ad495e932619111b5dfddffb688e3634b495"
423
+ ],
424
+ [
425
+ "transcoder/basisu_transcoder_tables_bc7_m5_color.inc",
426
+ "e6f63d3ebce0ac84d801ec54614b6a4eeda3be3e994f3abbfc732377cfe5a531"
427
+ ],
428
+ [
429
+ "transcoder/basisu_transcoder_tables_dxt1_5.inc",
430
+ "500e640b5e6858fd10194eb4845670eb36d3ef9dc117a017632c1104ba3eb9d5"
431
+ ],
432
+ [
433
+ "transcoder/basisu_transcoder_tables_dxt1_6.inc",
434
+ "3d203465f9097845eddb821943d312bf8cffb04d8f5ce09c18d4c6df40519ed3"
435
+ ],
436
+ [
437
+ "transcoder/basisu_transcoder_tables_pvrtc2_45.inc",
438
+ "780711642098a91239ee37b3f9110469ee1c7da8dd9e440a43c7ba70f992ff9d"
439
+ ],
440
+ [
441
+ "transcoder/basisu_transcoder_tables_pvrtc2_alpha_33.inc",
442
+ "250d389235c0213757266441f72aee37cbe138a3c2a3f58b590ed53d6fb746fa"
443
+ ],
444
+ [
445
+ "transcoder/basisu_transcoder_uastc.h",
446
+ "8796f8e755b868c56967e3d4d53089c2aaac7e1f345b03be1e975016fcbaf11e"
447
+ ],
448
+ [
449
+ "transcoder/basisu_xbc7_decoder.h",
450
+ "7487d5c43fe2ff97aba5a3cee87cfcdcb433f003b72c47927d4d4aeebde7b2ea"
451
+ ],
452
+ [
453
+ "transcoder/basisu_xbc7_decoder.inl",
454
+ "485b6c4b9297047430ea8124319501d58389d96da38642f59dafd974d88d65d1"
455
+ ],
456
+ [
457
+ "zstd/LICENSE",
458
+ "2c1a7fa704df8f3a606f6fc010b8b5aaebf403f3aeec339a12048f1ba7331a0b"
459
+ ],
460
+ [
461
+ "zstd/zstd.c",
462
+ "37045a972b773425ce477a218fb7b4167da83a93ba6fd7e4baf79f5558c8424f"
463
+ ],
464
+ [
465
+ "zstd/zstd.h",
466
+ "9b4bc8245565c98ccfc61c07749928b57e7c0f6fddb0530c4f6aa1971893d88b"
467
+ ],
468
+ [
469
+ "zstd/zstd_errors.h",
470
+ "66a8c3f71d12ea6e797e4f622f31f3f8f81c41b36f48cad4f5de7d8bfb6aac0a"
471
+ ],
472
+ [
473
+ "zstd/zstddeclib.c",
474
+ "3a007442219d631e3748113518dd723d577647c8c00ca3f70371d0c2f7bda5a8"
475
+ ]
476
+ ];
@@ -0,0 +1,33 @@
1
+ // oxlint-disable-next-line import/no-nodejs-modules -- Deterministic native compression is build-only.
2
+ import { constants, deflateSync, inflateSync, zstdCompressSync } from 'node:zlib';
3
+ import { encodePortableBytes } from '@wildshard/sdk/bake/portableBytes';
4
+
5
+ /** Encode bounded owned build results with the pinned codecs; never installs a runtime service.
6
+ * Deflate keeps its portable default; native explicitly preserves Node zlib bytes under a native cache key. */
7
+ export function encodeBuildBytes(input: Uint8Array, codec: 'deflate' | 'zstd', level?: number, deflateBackend: 'portable' | 'native' = 'portable'): Uint8Array {
8
+ if (!(input instanceof Uint8Array) || !(input.buffer instanceof ArrayBuffer) || input.byteLength > 256_000_000) throw new Error('Build codec requires bounded unshared bytes');
9
+ if (level !== undefined && !Number.isInteger(level)) throw new Error('Build codec level must be an integer');
10
+ if (deflateBackend !== 'portable' && deflateBackend !== 'native') throw new Error('Unknown deflate backend');
11
+ const bytes = new Uint8Array(input); // Own the selected view; detached inputs refuse here.
12
+ if (codec === 'deflate') {
13
+ const selected = ([0, 1, 2, 3, 4, 5, 6, 7, 8, 9] as const).find(value => value === (level ?? 9));
14
+ if (selected === undefined) throw new Error('Deflate level must be an integer from 0 to 9');
15
+ return new Uint8Array(deflateBackend === 'native' ? deflateSync(bytes, { level: selected }) : encodePortableBytes(bytes, selected));
16
+ }
17
+ if (codec !== 'zstd') throw new Error('Unknown build codec');
18
+ if (deflateBackend !== 'portable') throw new Error('Deflate backend is only valid for deflate');
19
+ const selected = level ?? 19;
20
+ if (!Number.isInteger(selected) || selected < 1 || selected > 22) throw new Error('Zstd level must be an integer from 1 to 22');
21
+ return new Uint8Array(zstdCompressSync(bytes, { params: { [constants.ZSTD_c_compressionLevel]: selected } }));
22
+ }
23
+
24
+ /** Decode one bounded build-time zlib stream into an owned buffer of exactly the declared size.
25
+ * The native inflater enforces the bound during decoding, before an oversized result can allocate. */
26
+ export function decodeBuildDeflate(input: Uint8Array, expectedBytes: number): Uint8Array<ArrayBuffer> {
27
+ if (!(input instanceof Uint8Array) || !(input.buffer instanceof ArrayBuffer) || input.byteLength > 256_000_000) throw new Error('Build codec requires bounded unshared bytes');
28
+ if (!Number.isSafeInteger(expectedBytes) || expectedBytes < 0 || expectedBytes > 256_000_000) throw new Error('Invalid decoded build byte length');
29
+ const bytes = new Uint8Array(input); // Own the selected view; detached inputs refuse here.
30
+ const decoded = inflateSync(bytes, { maxOutputLength: Math.max(1, expectedBytes) });
31
+ if (decoded.byteLength !== expectedBytes) throw new Error('Decoded build byte length differs');
32
+ return Uint8Array.from(decoded);
33
+ }