@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,107 @@
1
+ {
2
+ "medium": {
3
+ "title": "Stable Audio 3 Medium",
4
+ "licence": "Stability AI Community (< $1M, register, credit)",
5
+ "families_rendered": 51,
6
+ "rank1": 24,
7
+ "top5": 45,
8
+ "mean_rank": 3.27,
9
+ "median_rank": 2.0,
10
+ "mean_gen_s": 1.05,
11
+ "mps_driver_gb_max": 11.45,
12
+ "shipped": 45,
13
+ "synth_keeps": [
14
+ "gull",
15
+ "hum-pickup",
16
+ "jump",
17
+ "splash",
18
+ "swimStroke",
19
+ "swordHit-wood"
20
+ ],
21
+ "bytes": 1811585,
22
+ "peak_gb": 19.4
23
+ },
24
+ "moss": {
25
+ "title": "MOSS-SoundEffect v2.0",
26
+ "licence": "Apache-2.0",
27
+ "families_rendered": 51,
28
+ "rank1": 26,
29
+ "top5": 46,
30
+ "mean_rank": 2.67,
31
+ "median_rank": 1.0,
32
+ "mean_gen_s": 53.77,
33
+ "mps_driver_gb_max": 19.8,
34
+ "shipped": 46,
35
+ "synth_keeps": [
36
+ "boar_grunt",
37
+ "hitMarker",
38
+ "jump",
39
+ "land",
40
+ "lunge"
41
+ ],
42
+ "bytes": 1541693,
43
+ "peak_gb": 16.3
44
+ },
45
+ "ezaudio": {
46
+ "title": "EzAudio-XL",
47
+ "licence": "MIT (+ flan-t5-xl, Apache-2.0)",
48
+ "families_rendered": 51,
49
+ "rank1": 9,
50
+ "top5": 17,
51
+ "mean_rank": 17.02,
52
+ "median_rank": 19.0,
53
+ "mean_gen_s": 7.38,
54
+ "mps_driver_gb_max": 7.75,
55
+ "shipped": 17,
56
+ "synth_keeps": [
57
+ "boar_grunt",
58
+ "boar_squeal",
59
+ "boltImpact-flesh",
60
+ "coconut_hit",
61
+ "coconut_land",
62
+ "crab_click",
63
+ "crab_snap",
64
+ "crossbowFire",
65
+ "deer_call",
66
+ "dodge",
67
+ "dryFire",
68
+ "elk_bugle",
69
+ "footstep-litter",
70
+ "footstep-planks",
71
+ "footstep-sand",
72
+ "gull",
73
+ "hitMarker",
74
+ "hoofsteps",
75
+ "jump",
76
+ "kill",
77
+ "land",
78
+ "land-hard",
79
+ "monkey_chatter",
80
+ "monkey_shriek",
81
+ "rifleFire",
82
+ "sailor_groan",
83
+ "sailor_slash",
84
+ "splash",
85
+ "surface",
86
+ "swimStroke",
87
+ "swordHit-flesh",
88
+ "swordHit-wood",
89
+ "wadeStep",
90
+ "waterExit"
91
+ ],
92
+ "bytes": 587331,
93
+ "peak_gb": 8.2
94
+ },
95
+ "minimax": {
96
+ "title": "MiniMax Music 3",
97
+ "licence": "MiniMax-Music3 Community (< $20M, UI credit)",
98
+ "families_rendered": 10,
99
+ "rank1": 0,
100
+ "top5": 1,
101
+ "mean_rank": 24.9,
102
+ "median_rank": 24.5,
103
+ "mean_gen_s": 504.23,
104
+ "mps_driver_gb_max": 8.97,
105
+ "peak_gb": 20.9
106
+ }
107
+ }
@@ -0,0 +1,332 @@
1
+ """MUSIC.md v3 row 6 (E33), SFX round 2: rank every model's sound-effect takes with CLAP, ship each model's set, and
2
+ build the side-by-side comparison page.
3
+
4
+ ~/ml/music/analysis/.venv/bin/python scripts/music/gen/sfx_build.py <sfx-raw-dir>
5
+ ~/ml/music/analysis/.venv/bin/python scripts/music/gen/sfx_build.py <sfx-raw-dir> --jobs sfx-ph-jobs.json --stage <dir>
6
+
7
+ --jobs / --stage (PINE-HOLLOW-REMASTER PH-A2..A4): rank another families file; each model's set is written to <dir>/<set>/
8
+ (a staging area outside public/, for sfx_merge.py --jobs to pick the winners from) and the rankings to
9
+ scripts/music/gen/sfx-<tag>-<set>.json (--tag defaults to ph); no comparison page (ph_page.py / nd_page.py make it). A family's
10
+ optional `group` (an NPC's barks, the footstep surfaces) keeps its siblings out of its CLAP competitors, so near-identical
11
+ descriptions do not rank each other down. With --stage, beds encode stereo at BED_KBPS (Pine Hollow has 14 of them).
12
+
13
+ --only fam,fam,... (with --stage): a later round of a few families (the remaster's sound gaps). Only those families' takes
14
+ are ranked (against every family's description, as ever), and only their rows in sfx-ph-<set>.json, their entries in
15
+ <dir>/<set>/sfx.json and their files are replaced; every other family keeps what its own round decided (a new competitor
16
+ reshuffles near-tied takes of families nobody asked to change: in the gaps round 9 old families would have swapped
17
+ takes and bark-miller-7 dropped out). The per-model summary is left as it is.
18
+
19
+ Reads <raw>/<model>/<family>/<seed>.wav + .json (gen_sfx.py / gen_sfx_moss.py / gen_sfx_ezaudio.py / MiniMax via
20
+ sfx_minimax.py). For every take:
21
+ CLAP (laion/clap-htsat-fused, the model's own logit scale): softmax of its own family description against every
22
+ other family's description plus three foils ("music with melody and instruments", "a person speaking", "silence").
23
+ `p` = the share its own description gets, `rank` = where it places among all of them (1 = best match).
24
+ Beds / hums also need a loop: the best seam on a 1 s grid (analyze.loop_seam), made seamless like the music
25
+ (stems.seam: the last second crossfaded into the second before loopStart), loop points measured on the decoded file.
26
+ Per (model, family) the best take ships if it ranks <= SHIP_MAX_RANK (5); one-shots add their 2nd take as a variant when
27
+ it also ranks <= 3. A family whose best take ranks lower is listed in sfx.json's `synth_keeps` (the synth plays it).
28
+ Writes public/assets/sfx/<set>/ for every model in SETS: content-addressed files (<family>-<seed>-<sha1[:8]>.m4a: the
29
+ service worker serves audio cache-first) + sfx.json
30
+ { model, credit, licence, beds: {forest: {file, loopStart, loopEnd, duration, gain}}, hums: {...},
31
+ oneshots: {<Audio method / AnimalSound id>: {files: [...], gain}}, synth_keeps: [...], provenance: [...] }
32
+ Beds / hums: stereo AAC 96 kb/s; one-shots: mono AAC 64 kb/s, trimmed to the sounding part. Levels: beds -24 LUFS,
33
+ hums -26 LUFS, one-shots -18 LUFS (the game applies its own gains on top: beds 0.5, pickup hum 0.35, shrine 0.6).
34
+ Also writes scripts/music/gen/sfx-<set>.json (every take, every score), sfx-summary.json (per model: families shipped,
35
+ mean rank, speed, memory) and art/sfx/round-2-top3/ (MP3 of each family's best take per model, side by side; MiniMax
36
+ Music 3 as a fourth column for the ten families it was tried on).
37
+ """
38
+
39
+ from __future__ import annotations
40
+
41
+ import html
42
+ import json
43
+ import subprocess
44
+ import sys
45
+ from pathlib import Path
46
+ from typing import TYPE_CHECKING
47
+
48
+ if TYPE_CHECKING:
49
+ import numpy as np
50
+
51
+ HERE = Path(__file__).resolve().parent
52
+ sys.path.insert(0, str(HERE))
53
+ from audio_jobs import family_key, read_sfx, tag_name # noqa: E402
54
+
55
+ REPO = HERE.parents[2]
56
+ OUT = REPO / "public/assets/sfx"
57
+ ART = REPO / "art/sfx/round-2-top3"
58
+ STABILITY = ("Stability AI Community License: free below USD 1M annual revenue; register with Stability AI for commercial use; "
59
+ "show 'Powered by Stability AI'; keep the licence + NOTICE with any redistribution. Its T5Gemma text encoder adds the Gemma terms.")
60
+ # raw-dir name -> the shipped set (None = compared on the page only)
61
+ SETS = {
62
+ "medium": {"set": "sa3-medium", "title": "Stable Audio 3 Medium", "licence": STABILITY,
63
+ "credit": "SFX: Stable Audio 3 Medium — Powered by Stability AI", "short": "Stability AI Community (< $1M, register, credit)"},
64
+ "moss": {"set": "moss", "title": "MOSS-SoundEffect v2.0", "short": "Apache-2.0",
65
+ "licence": "Apache-2.0 (OpenMOSS-Team/MOSS-SoundEffect-v2.0): commercial use OK; keep the licence and NOTICE text with any redistribution of the weights; outputs are unrestricted.",
66
+ "credit": "SFX: MOSS-SoundEffect v2.0 by OpenMOSS (Apache-2.0)"},
67
+ "ezaudio": {"set": "ezaudio", "title": "EzAudio-XL", "short": "MIT (+ flan-t5-xl, Apache-2.0)",
68
+ "licence": "MIT (OpenSound/EzAudio: code and weights); the flan-t5-xl text encoder is Apache-2.0. Commercial use OK; keep the copyright notice with any redistribution of the weights.",
69
+ "credit": "SFX: EzAudio by OpenSound (MIT)"},
70
+ "minimax": {"set": None, "title": "MiniMax Music 3", "short": "MiniMax-Music3 Community (< $20M, UI credit)",
71
+ "licence": "MiniMax-Music3 Community License", "credit": "Music: MiniMax-Music3"},
72
+ }
73
+ FOILS = ["music with melody and instruments", "a person speaking", "silence"]
74
+ LEVEL = {"bed": -24.0, "hum": -26.0, "oneshot": -18.0}
75
+ SHIP_MAX_RANK = 5
76
+ BED_KBPS = 64
77
+ GAIN = {"bed-forest": 0.5, "bed-island": 0.5, "bed-underwater": 0.5, "hum-pickup": 0.35, "hum-shrine": 0.6}
78
+
79
+
80
+ def trim(x: np.ndarray, sr: int, max_s: float) -> np.ndarray:
81
+ import numpy as np
82
+
83
+ env = np.abs(x).max(0)
84
+ idx = np.where(env > env.max() * 10 ** (-45 / 20))[0]
85
+ a, b = max(int(idx[0]) - int(0.005 * sr), 0), min(int(idx[-1]) + int(0.03 * sr), x.shape[1], int(idx[0]) + int(max_s * sr))
86
+ y = x[:, a:b].copy()
87
+ n = min(int(0.04 * sr), y.shape[1] // 4)
88
+ y[:, -n:] *= np.linspace(1.0, 0.0, n)[None]
89
+ return y
90
+
91
+
92
+ def main() -> None:
93
+ import argparse
94
+
95
+ ap = argparse.ArgumentParser()
96
+ ap.add_argument("raw", nargs="?")
97
+ ap.add_argument("--jobs", default="sfx-jobs.json")
98
+ ap.add_argument("--stage", default=None, help="write each model's set under this dir instead of public/assets/sfx/")
99
+ ap.add_argument("--only", default="", help="with --stage: rank and ship only these families (comma list); the rest keep their round's")
100
+ ap.add_argument("--tag", default="ph", type=tag_name, help="staged ranking prefix sfx-<tag>-<model>.json (default ph)")
101
+ ap.add_argument("--list", action="store_true", help="validate and print job families; no model imports")
102
+ ap.add_argument("--dry", action="store_true", help="replay cached ranking JSON without loading models or writing files")
103
+ args = ap.parse_args()
104
+ only = {f for f in args.only.split(",") if f}
105
+ if only and not args.stage:
106
+ raise SystemExit("--only needs --stage")
107
+ fams = read_sfx(HERE / args.jobs)["families"]
108
+ if only - fams.keys():
109
+ ap.error(f"unknown --only families: {sorted(only - fams.keys())}")
110
+ out_root, prefix = (Path(args.stage), f"sfx-{args.tag}-") if args.stage else (OUT, "sfx-")
111
+ if args.list:
112
+ print(json.dumps(fams, indent=2, ensure_ascii=False))
113
+ return
114
+ if args.dry:
115
+ cached = {meta["set"] or model: (HERE / f"{prefix}{meta['set'] or model}.json") for model, meta in SETS.items()}
116
+ cached = {model: p for model, p in cached.items() if p.exists()}
117
+ if not cached:
118
+ ap.error("--dry needs cached rankings from a previous run; use --list to validate new jobs")
119
+ for p in cached.values():
120
+ rows = json.loads(p.read_text())["families"]
121
+ if not (only or set(fams)) <= rows.keys():
122
+ ap.error(f"{p}: missing cached families (run the model ranking first)")
123
+ print(json.dumps({str(p): p.read_text() for p in cached.values()}, indent=2, ensure_ascii=False))
124
+ return
125
+ if args.raw is None:
126
+ ap.error("raw is required unless --list or --dry is used")
127
+ raw = Path(args.raw)
128
+ import librosa
129
+ import numpy as np
130
+ import soundfile as sf
131
+ import torch
132
+ from transformers import ClapModel, ClapProcessor
133
+ from analyze import CLAP_DIR, _tensor, loop_seam
134
+ from stems import decode_offset, encode, lufs, seam, shipped_name
135
+ clap = ClapModel.from_pretrained(str(CLAP_DIR)).eval()
136
+ proc = ClapProcessor.from_pretrained(str(CLAP_DIR))
137
+ scale = float(clap.logit_scale_a.detach().exp())
138
+ names = list(fams)
139
+ texts = [fams[f]["desc"] for f in names] + FOILS
140
+ with torch.no_grad():
141
+ te = torch.nn.functional.normalize(_tensor(clap.get_text_features(**proc(text=texts, return_tensors="pt", padding=True))), dim=-1)
142
+
143
+ picks: dict[str, dict[str, list[dict]]] = {}
144
+ summary: dict[str, dict] = {}
145
+ for model, meta in SETS.items():
146
+ takes = []
147
+ for wav in sorted((raw / model).glob("*/*.wav")):
148
+ side = json.loads(wav.with_suffix(".json").read_text())
149
+ fam = side["family"]
150
+ if only and fam not in only:
151
+ continue
152
+ x, sr = sf.read(str(wav), always_2d=True)
153
+ y = x.mean(1).astype(np.float32)
154
+ y48 = librosa.resample(y, orig_sr=sr, target_sr=48000)
155
+ seg = 48000 * 10
156
+ chunks = [y48[i:i + seg] for i in range(0, max(len(y48) - seg // 2, 1), seg)] or [y48]
157
+ with torch.no_grad():
158
+ a = proc(audio=chunks, sampling_rate=48000, return_tensors="pt")
159
+ ae = torch.nn.functional.normalize(_tensor(clap.get_audio_features(**a)), dim=-1).mean(0, keepdim=True)
160
+ sims = (torch.nn.functional.normalize(ae, dim=-1) @ te.T)[0]
161
+ i = names.index(fam)
162
+ grp = fams[fam].get("group")
163
+ keep = torch.tensor([j == i or grp is None or j >= len(names) or fams[names[j]].get("group") != grp for j in range(len(texts))])
164
+ ks = sims[keep]
165
+ ki = int(keep[:i].sum()) # this family's index among the kept competitors
166
+ r = {"family": fam, "seed": side["seed"], "wav": str(wav), "side": side,
167
+ "p": round(float(torch.softmax(ks * scale, 0)[ki]), 3), "rank": int((ks > ks[ki]).sum()) + 1,
168
+ "best_match": texts[int(sims.argmax())], "peak": round(float(np.abs(x).max()), 3)}
169
+ if fams[fam]["kind"] in ("bed", "hum"):
170
+ r["seam"] = loop_seam(librosa.resample(y, orig_sr=sr, target_sr=22050), 22050, 240.0, len(y) / sr) # 1 s grid
171
+ takes.append(r)
172
+ if not takes:
173
+ continue
174
+ by_fam: dict[str, list[dict]] = {}
175
+ for r in takes:
176
+ by_fam.setdefault(r["family"], []).append(r)
177
+ for rs in by_fam.values():
178
+ rs.sort(key=lambda r: (r["rank"] <= 3, r["p"] * (0.7 + 0.3 * max(r.get("seam", {}).get("score", 1.0), 0.0))), reverse=True)
179
+ picks[model] = by_fam
180
+ best = {f: rs[0] for f, rs in by_fam.items()}
181
+ ranks = [b["rank"] for b in best.values()]
182
+ gens = [r["side"].get("gen_time_s", 0) for r in takes]
183
+ summary[model] = {"title": meta["title"], "licence": meta["short"], "families_rendered": len(best),
184
+ "rank1": sum(x == 1 for x in ranks), "top5": sum(x <= SHIP_MAX_RANK for x in ranks),
185
+ "mean_rank": round(float(np.mean(ranks)), 2), "median_rank": float(np.median(ranks)),
186
+ "mean_gen_s": round(float(np.mean(gens)), 2),
187
+ "mps_driver_gb_max": max((r["side"].get("mps_driver_gb") or 0) for r in takes)}
188
+ tag = meta["set"] or model
189
+ rows = {f: [{k: v for k, v in r.items() if k != "wav"} for r in rs] for f, rs in by_fam.items()}
190
+ if only: # every other family keeps its own round's rows
191
+ rows = {**json.loads((HERE / f"{prefix}{tag}.json").read_text())["families"], **rows}
192
+ (HERE / f"{prefix}{tag}.json").write_text(json.dumps({"model": meta["title"], "families": rows}, indent=2) + "\n")
193
+ if meta["set"] is None:
194
+ continue
195
+
196
+ # ---- ship this model's set
197
+ dest = out_root / meta["set"]
198
+ dest.mkdir(parents=True, exist_ok=True)
199
+ man: dict = {"model": meta["title"], "credit": meta["credit"], "licence": meta["licence"],
200
+ "beds": {}, "hums": {}, "oneshots": {}, "provenance": []}
201
+ total, skipped = 0, []
202
+ if only: # keep the other families' entries and files; drop these families' old ones
203
+ man = json.loads((dest / "sfx.json").read_text())
204
+ gone: list[str] = []
205
+ for fam in only:
206
+ kind = fams[fam]["kind"]
207
+ sec, key = (man["oneshots"], fam) if kind == "oneshot" else (man["beds" if kind == "bed" else "hums"], family_key(fam))
208
+ e = sec.pop(key, None)
209
+ if e is not None:
210
+ gone += e["files"] if "files" in e else [e["file"]]
211
+ man["provenance"] = [p for p in man["provenance"] if p["file"] not in gone]
212
+ for f in gone:
213
+ (dest / f).unlink(missing_ok=True)
214
+ skipped = [f for f in man.get("synth_keeps", []) if f not in only]
215
+ else:
216
+ for old in dest.glob("*.m4a"): # this folder holds only this script's output
217
+ old.unlink()
218
+ for fam, rs in sorted(by_fam.items()):
219
+ kind = fams[fam]["kind"]
220
+ if rs[0]["rank"] > SHIP_MAX_RANK: # its best take sounds more like some other family: the synth keeps it
221
+ skipped.append(fam)
222
+ continue
223
+ chosen = rs[:1] if kind != "oneshot" else [r for r in rs[:2] if r is rs[0] or r["rank"] <= 3]
224
+ for r in chosen:
225
+ x, sr = sf.read(r["wav"], always_2d=True)
226
+ x = x.T.astype(np.float64)
227
+ if kind in ("bed", "hum"):
228
+ s = r["seam"]
229
+ y, _ = seam(x, sr, {"loopStart": s["start_s"], "loopEnd": s["end_s"]}, 1.0)
230
+ else:
231
+ y = trim(x, sr, 3.0)
232
+ L, tp = lufs(y, sr)
233
+ y = y * 10 ** (min(LEVEL[kind] - L, -1.0 - tp) / 20)
234
+ tmp = dest / ".tmp.m4a"
235
+ total += encode(y, sr, tmp, mono=(kind == "oneshot"), kbps=BED_KBPS if (args.stage and kind == "bed") else None)
236
+ lag, dlen = decode_offset(tmp, y, sr) if kind in ("bed", "hum") else (0.0, 0.0)
237
+ fname = shipped_name(dest, tmp, f"{fam}-{r['seed']}")
238
+ if kind in ("bed", "hum"):
239
+ entry = {"file": fname, "loopStart": round(r["seam"]["start_s"] + lag, 4), "loopEnd": round(r["seam"]["end_s"] + lag, 4),
240
+ "duration": round(dlen, 4), "gain": GAIN.get(fam, 0.5)}
241
+ assert entry["loopEnd"] <= dlen and entry["loopEnd"] - entry["loopStart"] > 0.5
242
+ man["beds" if kind == "bed" else "hums"][family_key(fam)] = entry
243
+ else:
244
+ man["oneshots"].setdefault(fam, {"files": [], "gain": 1.0})["files"].append(fname)
245
+ man["provenance"].append({"file": fname, "model": r["side"]["repo"], "code": r["side"]["code_commit"], "prompt": r["side"]["prompt"],
246
+ "seed": r["seed"], "steps": r["side"]["steps"], "clap_p": r["p"], "clap_rank": r["rank"]})
247
+ man["synth_keeps"] = sorted(skipped)
248
+ (dest / "sfx.json").write_text(json.dumps(man, indent=2, ensure_ascii=False) + "\n")
249
+ summary[model].update(shipped=len(by_fam) - len(skipped), synth_keeps=sorted(skipped), bytes=total)
250
+ print(f"{meta['set']}: {total / 1e6:.2f} MB {'added' if only else ''}, {'ranked' if only else 'ships'} {len(by_fam)}, synth keeps {sorted(skipped)}", flush=True)
251
+
252
+ peaks = HERE / "sfx-peaks.json" # measured peak RSS per model process (/usr/bin/time -l), written from the run logs
253
+ if peaks.exists():
254
+ for m, gb in json.loads(peaks.read_text()).items():
255
+ if m in summary:
256
+ summary[m]["peak_gb"] = gb
257
+ if args.stage and only:
258
+ return
259
+ if args.stage:
260
+ (HERE / f"sfx-{args.tag}-summary.json").write_text(json.dumps(summary, indent=2) + "\n")
261
+ return
262
+ (HERE / "sfx-summary.json").write_text(json.dumps(summary, indent=2) + "\n")
263
+ page(raw, picks, summary, names, fams)
264
+
265
+
266
+ def page(raw: Path, picks: dict, summary: dict, names: list[str], fams: dict) -> None:
267
+ from build_page import PAGE_CSS
268
+
269
+ for old in ART.glob("*/*.mp3"):
270
+ old.unlink()
271
+ cols = [m for m in SETS if m in picks]
272
+ rows = []
273
+ for fam in names:
274
+ cells = []
275
+ best_rank = min((picks[m][fam][0]["rank"] for m in cols if fam in picks[m]), default=None)
276
+ for m in cols:
277
+ rs = picks[m].get(fam)
278
+ if not rs:
279
+ cells.append("<td class='empty'>not tried</td>")
280
+ continue
281
+ r = rs[0]
282
+ mp3 = ART / (SETS[m]["set"] or m) / f"{fam}-{r['seed']}.mp3"
283
+ mp3.parent.mkdir(parents=True, exist_ok=True)
284
+ subprocess.run(["ffmpeg", "-y", "-loglevel", "error", "-i", r["wav"], "-t", "20", "-ac", "1", "-af", "loudnorm=I=-18:TP=-1.5",
285
+ "-c:a", "libmp3lame", "-b:a", "96k", str(mp3)], check=True)
286
+ tone = "good" if r["rank"] == 1 else ("warn" if r["rank"] <= SHIP_MAX_RANK else "bad")
287
+ if SETS[m]["set"] is None:
288
+ ship = "compared only"
289
+ else:
290
+ ship = "in the game" if r["rank"] <= SHIP_MAX_RANK else "synth plays"
291
+ star = " <span class='chip good'><b>best</b></span>" if r["rank"] == best_rank else ""
292
+ cells.append(f"<td><audio controls preload='none' src='{html.escape(mp3.parent.name)}/{html.escape(mp3.name)}'></audio>"
293
+ f"<div class='chips'><span class='chip {tone}'><b>CLAP</b> rank {r['rank']} &middot; {r['p'] * 100:.0f}%</span>"
294
+ f"<span class='chip'>{ship}</span>{star}</div></td>")
295
+ rows.append(f"<tr><th scope='row'>{html.escape(fam)}<br><span class='meta'>{html.escape(fams[fam]['desc'])}</span></th>{''.join(cells)}</tr>")
296
+ srows = []
297
+ for m in cols:
298
+ s = summary[m]
299
+ shipped = f"{s['shipped']} of {s['families_rendered']}" if "shipped" in s else f"compared on {s['families_rendered']}"
300
+ srows.append(f"<tr><td><b>{html.escape(s['title'])}</b></td><td>{shipped}</td><td>{s['rank1']}</td><td>{s['mean_rank']}</td>"
301
+ f"<td>{s['mean_gen_s']} s</td><td>{s.get('peak_gb', s['mps_driver_gb_max'])} GB</td><td>{html.escape(s['licence'])}</td></tr>")
302
+ (ART / "index.html").write_text(f"""<title>Wildshard Sound Effects Round 2</title>
303
+ <meta name="description" content="Every Wildshard sound effect from the top three commercial-licence local SFX models, side by side, CLAP-ranked.">
304
+ <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Newsreader:opsz,wght@6..72,500;6..72,600&family=IBM+Plex+Sans:wght@400;500;600&family=IBM+Plex+Mono:wght@400;500&display=swap">
305
+ <style>
306
+ {PAGE_CSS}
307
+ .grid td, .grid th {{ white-space: normal; vertical-align: top; }}
308
+ .grid th[scope=row] {{ text-transform: none; letter-spacing: 0; font-size: 13px; color: var(--ink); min-width: 150px; }}
309
+ .grid audio {{ width: 200px; max-width: 100%; }}
310
+ </style>
311
+ <div class="wrap">
312
+ <header>
313
+ <h1>Wildshard sound effects, round 2</h1>
314
+ <p class="lede">Every sound the game makes that is not music, from the three best local sound-effect models whose licences allow commercial use. Each cell is that model's best of three takes, ranked by CLAP: "rank 1" means the audio matched its own description better than any of the other {len(names) - 1} families and three foils. A set carries a family only when its take ranks in the top {SHIP_MAX_RANK}; otherwise the game's synth plays it. All three sets are in the game (Settings, Sound effects). MiniMax Music 3 was tried on ten families as a fourth column.</p>
315
+ </header>
316
+ <section class="notes"><h2>The models</h2>
317
+ <div class="tablewrap"><table class="models">
318
+ <thead><tr><th>model</th><th>families in the game</th><th>rank 1</th><th>mean rank</th><th>time per take</th><th>peak memory</th><th>licence</th></tr></thead>
319
+ <tbody>{''.join(srows)}</tbody>
320
+ </table></div>
321
+ </section>
322
+ <section class="style"><div class="tablewrap"><table class="grid">
323
+ <thead><tr><th>family</th>{''.join(f'<th>{html.escape(SETS[m]["title"])}</th>' for m in cols)}</tr></thead>
324
+ <tbody>{''.join(rows)}</tbody>
325
+ </table></div></section>
326
+ </div>
327
+ """)
328
+ print(f"page -> {ART / 'index.html'}")
329
+
330
+
331
+ if __name__ == "__main__":
332
+ main()