@wildshard/sdk 0.0.1 → 0.2.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (688) hide show
  1. package/GUIDE.md +895 -0
  2. package/README.md +13 -5
  3. package/bin/wildshard.mjs +38 -0
  4. package/lint/declaration-config.d.mts +2 -0
  5. package/lint/declaration-config.mjs +19 -0
  6. package/lint/engine-plugin.d.mts +2 -0
  7. package/lint/engine-plugin.mjs +40 -0
  8. package/lint/host-callbacks.d.mts +6 -0
  9. package/lint/host-callbacks.mjs +123 -0
  10. package/lint/host-files.d.mts +1 -0
  11. package/lint/host-files.mjs +7 -0
  12. package/lint/layer-exports.d.mts +2 -0
  13. package/lint/layer-exports.mjs +21 -0
  14. package/lint/legacy-line-basis.json +995 -0
  15. package/lint/nine-tiling-baseline.json +35 -0
  16. package/lint/ratchet.json +11 -0
  17. package/lint/runtime-files.d.mts +12 -0
  18. package/lint/runtime-files.json +16 -0
  19. package/lint/runtime-files.mjs +69 -0
  20. package/lint/runtime-performance.d.mts +6 -0
  21. package/lint/runtime-performance.mjs +184 -0
  22. package/lint/sdk-plugin.d.mts +4 -0
  23. package/lint/sdk-plugin.mjs +134 -0
  24. package/lint/shardfile-boundaries.d.mts +10 -0
  25. package/lint/shardfile-boundaries.mjs +122 -0
  26. package/lint/tile-bake-debt.json +556 -0
  27. package/package.json +365 -3
  28. package/scripts/agent-parity.mjs +1524 -0
  29. package/scripts/agent-sync.mjs +518 -0
  30. package/scripts/apfs-clone.mjs +67 -0
  31. package/scripts/assert-store-layout.mjs +23 -0
  32. package/scripts/astc6-phone-cap.d.mts +3 -0
  33. package/scripts/astc6-phone-cap.mjs +137 -0
  34. package/scripts/audit-assets.d.mts +10 -0
  35. package/scripts/audit-assets.mjs +151 -0
  36. package/scripts/bake/coatFiles.d.mts +6 -0
  37. package/scripts/bake/coatFiles.mjs +37 -0
  38. package/scripts/bake/environment.d.mts +2 -0
  39. package/scripts/bake/environment.mjs +58 -0
  40. package/scripts/bake/far-proxies.mjs +45 -0
  41. package/scripts/bake/keyed-sky.d.mts +4 -0
  42. package/scripts/bake/keyed-sky.mjs +34 -0
  43. package/scripts/bake/movers.mjs +56 -0
  44. package/scripts/bake/nativeWorld.d.mts +6 -0
  45. package/scripts/bake/nativeWorld.mjs +43 -0
  46. package/scripts/bake/navmeshGround.ts +22 -0
  47. package/scripts/bake/near-placeholder.mjs +331 -0
  48. package/scripts/bake/placeholderShards.mjs +41 -0
  49. package/scripts/bake/skins.mjs +15 -0
  50. package/scripts/bake/template-skins.mjs +33 -0
  51. package/scripts/bake/viewmodelBytes.ts +26 -0
  52. package/scripts/bake/viewmodelPage.ts +11 -0
  53. package/scripts/bake/worldHost.d.mts +35 -0
  54. package/scripts/bake/worldHost.mjs +110 -0
  55. package/scripts/bake-astc6.cache.json +80 -0
  56. package/scripts/bake-astc6.far-reach.cache.json +23 -0
  57. package/scripts/bake-astc6.list.json +111 -0
  58. package/scripts/bake-astc6.mjs +279 -0
  59. package/scripts/bake-astc6.nalati-grasslands.cache.json +42 -0
  60. package/scripts/bake-catalogue.mjs +44 -0
  61. package/scripts/bake-check.mjs +54 -0
  62. package/scripts/bake-chunk.mjs +124 -0
  63. package/scripts/bake-cloud-field.mjs +24 -0
  64. package/scripts/bake-coats.mjs +110 -0
  65. package/scripts/bake-data-maps.d.mts +24 -0
  66. package/scripts/bake-data-maps.mjs +72 -0
  67. package/scripts/bake-entry-programs.mjs +117 -0
  68. package/scripts/bake-geometry.mjs +106 -0
  69. package/scripts/bake-hybrid-tiles.mjs +28 -0
  70. package/scripts/bake-ktx2.cache.json +276 -0
  71. package/scripts/bake-ktx2.list.json +365 -0
  72. package/scripts/bake-ktx2.mjs +477 -0
  73. package/scripts/bake-map-glb.mjs +127 -0
  74. package/scripts/bake-map-rest.d.mts +7 -0
  75. package/scripts/bake-map-rest.mjs +50 -0
  76. package/scripts/bake-maps.mjs +200 -0
  77. package/scripts/bake-navmesh.mjs +259 -0
  78. package/scripts/bake-packs.mjs +129 -0
  79. package/scripts/bake-pickups.mjs +102 -0
  80. package/scripts/bake-query-terrain.mjs +64 -0
  81. package/scripts/bake-recurve-pool.mjs +16 -0
  82. package/scripts/bake-section-schemas.d.mts +3 -0
  83. package/scripts/bake-template-shardfile.mjs +32 -0
  84. package/scripts/bake-textures.mjs +80 -0
  85. package/scripts/bake-viewmodel-sets.json +45 -0
  86. package/scripts/bake-viewmodel-sets.mjs +137 -0
  87. package/scripts/bake-voxel-ao.mjs +119 -0
  88. package/scripts/bake-water-ripples.mjs +25 -0
  89. package/scripts/blender/README.md +129 -0
  90. package/scripts/blender/build.sh +166 -0
  91. package/scripts/blender/lib/export-scene.mjs +129 -0
  92. package/scripts/blender/lib/glb-digest.mjs +188 -0
  93. package/scripts/blender/lib/glb.py +68 -0
  94. package/scripts/blender/lib/save_blend.py +17 -0
  95. package/scripts/blender/lib/world_fixture.py +55 -0
  96. package/scripts/blender/targets.json +591 -0
  97. package/scripts/build-sdk.mjs +95 -0
  98. package/scripts/build-shardfiles.d.mts +7 -0
  99. package/scripts/build-shardfiles.mjs +206 -0
  100. package/scripts/capture-hero.mjs +137 -0
  101. package/scripts/check-lift-review.mjs +23 -0
  102. package/scripts/chromium-keychain-check.mjs +139 -0
  103. package/scripts/chromium-keychain.d.mts +1 -0
  104. package/scripts/chromium-keychain.mjs +5 -0
  105. package/scripts/compile-script.d.mts +3 -0
  106. package/scripts/compile-script.mjs +8 -0
  107. package/scripts/creature-color.mjs +255 -0
  108. package/scripts/decide/calibrate.py +127 -0
  109. package/scripts/decide/calibration/2026-10-03/labels-s1.tsv +281 -0
  110. package/scripts/decide/calibration/2026-10-03/labels-s2.tsv +97 -0
  111. package/scripts/decide/calibration/2026-10-03/labels-s3.tsv +48 -0
  112. package/scripts/decide/calibration/2026-10-03/labels-s3b.tsv +26 -0
  113. package/scripts/decide/calibration/2026-10-03/res-capture-status-v1.jsonl +376 -0
  114. package/scripts/decide/calibration/2026-10-03/res-text-garbled-strings.jsonl +48 -0
  115. package/scripts/decide/calibration/2026-10-03/res-text-garbled-v1.jsonl +73 -0
  116. package/scripts/decide/decide.py +262 -0
  117. package/scripts/decide/decide.sh +50 -0
  118. package/scripts/decide/layer-purity-pilot.mjs +41 -0
  119. package/scripts/decide/sets/capture-status.json +46 -0
  120. package/scripts/decide/sets/layer-purity.json +28 -0
  121. package/scripts/decide/sets/text-garbled.json +17 -0
  122. package/scripts/decide/test_decide.py +37 -0
  123. package/scripts/docs.mjs +15 -0
  124. package/scripts/entry-reads/crawl.ts +152 -0
  125. package/scripts/entry-reads/tsconfig.json +25 -0
  126. package/scripts/gen-format-schema.d.mts +2 -0
  127. package/scripts/gen-format-schema.mjs +21 -0
  128. package/scripts/gen-host-catalogue.d.mts +14 -0
  129. package/scripts/gen-host-catalogue.mjs +108 -0
  130. package/scripts/gen-shard-layout-doc.d.mts +4 -0
  131. package/scripts/gen-shard-layout-doc.mjs +55 -0
  132. package/scripts/gen-shards.d.mts +17 -0
  133. package/scripts/gen-shards.mjs +311 -0
  134. package/scripts/goldens/capture-inputs.d.mts +4 -0
  135. package/scripts/goldens/capture-inputs.mjs +34 -0
  136. package/scripts/goldens/colour_shift.py +27 -0
  137. package/scripts/goldens/native-residency.d.mts +10 -0
  138. package/scripts/goldens/native-residency.mjs +104 -0
  139. package/scripts/goldens/plot-inputs.d.mts +12 -0
  140. package/scripts/goldens/plot-inputs.mjs +46 -0
  141. package/scripts/gpu-texmem.mjs +98 -0
  142. package/scripts/horizon-matte/config.py +24 -0
  143. package/scripts/horizon-matte/encode.py +91 -0
  144. package/scripts/horizon-matte/key.py +141 -0
  145. package/scripts/horizon-matte/mkjobs.py +33 -0
  146. package/scripts/horizon-matte/mkjobs_day2.py +11 -0
  147. package/scripts/horizon-matte/overlap.py +80 -0
  148. package/scripts/horizon-matte/run_codex.py +57 -0
  149. package/scripts/horizon-matte/stitch.py +133 -0
  150. package/scripts/img2mesh/CC0.md +105 -0
  151. package/scripts/img2mesh/README.md +209 -0
  152. package/scripts/img2mesh/ab_board.py +102 -0
  153. package/scripts/img2mesh/birds/birds.json +255 -0
  154. package/scripts/img2mesh/birds/birds_atlas.py +150 -0
  155. package/scripts/img2mesh/birds/birds_fix_preview.mjs +103 -0
  156. package/scripts/img2mesh/birds/birds_fix_render.py +75 -0
  157. package/scripts/img2mesh/birds/birds_pack.py +110 -0
  158. package/scripts/img2mesh/birds/birds_phone_b.py +112 -0
  159. package/scripts/img2mesh/birds/birds_post.py +550 -0
  160. package/scripts/img2mesh/birds/birds_render.py +125 -0
  161. package/scripts/img2mesh/birds/birds_sheet.py +33 -0
  162. package/scripts/img2mesh/birds/birds_view.py +60 -0
  163. package/scripts/img2mesh/board.py +100 -0
  164. package/scripts/img2mesh/build_cc0.sh +52 -0
  165. package/scripts/img2mesh/build_driftwood.sh +12 -0
  166. package/scripts/img2mesh/build_faces.sh +53 -0
  167. package/scripts/img2mesh/build_props.py +81 -0
  168. package/scripts/img2mesh/cc0_export.py +186 -0
  169. package/scripts/img2mesh/driftwood_post.py +571 -0
  170. package/scripts/img2mesh/e304_faces.sh +67 -0
  171. package/scripts/img2mesh/face_remaster.py +911 -0
  172. package/scripts/img2mesh/face_views.py +95 -0
  173. package/scripts/img2mesh/faces-e304.json +9 -0
  174. package/scripts/img2mesh/faces.json +30 -0
  175. package/scripts/img2mesh/head_cut.py +100 -0
  176. package/scripts/img2mesh/hi3d_paint.py +94 -0
  177. package/scripts/img2mesh/hi3d_refine.py +161 -0
  178. package/scripts/img2mesh/hunyuan_cpu_rasterizer.sh +42 -0
  179. package/scripts/img2mesh/pine_hollow_phone.sh +13 -0
  180. package/scripts/img2mesh/props/coral-arch.json +32 -0
  181. package/scripts/img2mesh/props/ember-furnace.json +30 -0
  182. package/scripts/img2mesh/props/night-market-gate.json +10 -0
  183. package/scripts/img2mesh/render_still.py +86 -0
  184. package/scripts/img2mesh/rig_strip.mjs +46 -0
  185. package/scripts/img2mesh/rig_transfer.mjs +104 -0
  186. package/scripts/img2mesh/split_sheet.py +48 -0
  187. package/scripts/img2mesh/trellis_batch.py +110 -0
  188. package/scripts/img2mesh/versus_board.py +114 -0
  189. package/scripts/import-bundle.d.mts +2 -0
  190. package/scripts/import-bundle.mjs +20 -0
  191. package/scripts/ktx2-ab-board.py +133 -0
  192. package/scripts/ktx2-ab.mjs +111 -0
  193. package/scripts/ktx2-settings.mjs +18 -0
  194. package/scripts/land.d.mts +14 -0
  195. package/scripts/land.mjs +809 -0
  196. package/scripts/lint-dispatch.mjs +14 -0
  197. package/scripts/map-bake-frames.d.mts +4 -0
  198. package/scripts/map-bake-frames.mjs +23 -0
  199. package/scripts/map-geometry.d.mts +9 -0
  200. package/scripts/map-geometry.mjs +29 -0
  201. package/scripts/map-world.mjs +162 -0
  202. package/scripts/mockup-local.sh +46 -0
  203. package/scripts/music/export-midi.mjs +68 -0
  204. package/scripts/music/gen/analyze.py +308 -0
  205. package/scripts/music/gen/audio_jobs.py +46 -0
  206. package/scripts/music/gen/briefs.json +51 -0
  207. package/scripts/music/gen/build_page.py +334 -0
  208. package/scripts/music/gen/folk.json +3187 -0
  209. package/scripts/music/gen/gen_ace_step.py +156 -0
  210. package/scripts/music/gen/gen_heartmula.py +187 -0
  211. package/scripts/music/gen/gen_minimax.py +143 -0
  212. package/scripts/music/gen/gen_sao.py +122 -0
  213. package/scripts/music/gen/gen_sao_small.py +104 -0
  214. package/scripts/music/gen/gen_sfx.py +98 -0
  215. package/scripts/music/gen/gen_sfx_ezaudio.py +112 -0
  216. package/scripts/music/gen/gen_sfx_moss.py +112 -0
  217. package/scripts/music/gen/models.json +61 -0
  218. package/scripts/music/gen/nalati-jobs.json +104 -0
  219. package/scripts/music/gen/nalati-score-build.json +119 -0
  220. package/scripts/music/gen/nalati-score.json +3448 -0
  221. package/scripts/music/gen/ob7-fit-decisions.json +38 -0
  222. package/scripts/music/gen/ob7-score-jobs.json +152 -0
  223. package/scripts/music/gen/ob7-sfx-jobs.json +897 -0
  224. package/scripts/music/gen/ob7_build.py +469 -0
  225. package/scripts/music/gen/ob7_generate.py +67 -0
  226. package/scripts/music/gen/ob7_run.sh +42 -0
  227. package/scripts/music/gen/orchestral.json +3187 -0
  228. package/scripts/music/gen/own_score.py +486 -0
  229. package/scripts/music/gen/ph-jobs.json +27 -0
  230. package/scripts/music/gen/ph_page.py +222 -0
  231. package/scripts/music/gen/piano.json +3175 -0
  232. package/scripts/music/gen/rank_v3.py +248 -0
  233. package/scripts/music/gen/sfx-best.json +2486 -0
  234. package/scripts/music/gen/sfx-ezaudio.json +4082 -0
  235. package/scripts/music/gen/sfx-jobs.json +57 -0
  236. package/scripts/music/gen/sfx-minimax-jobs.json +16 -0
  237. package/scripts/music/gen/sfx-minimax.json +289 -0
  238. package/scripts/music/gen/sfx-moss.json +4082 -0
  239. package/scripts/music/gen/sfx-nalati-b3-jobs.json +17 -0
  240. package/scripts/music/gen/sfx-nalati-jobs.json +338 -0
  241. package/scripts/music/gen/sfx-nalati.json +11202 -0
  242. package/scripts/music/gen/sfx-nd-jobs.json +57 -0
  243. package/scripts/music/gen/sfx-nd-moss.json +2097 -0
  244. package/scripts/music/gen/sfx-nd-sa3-medium.json +2097 -0
  245. package/scripts/music/gen/sfx-nd-summary.json +38 -0
  246. package/scripts/music/gen/sfx-peaks.json +7 -0
  247. package/scripts/music/gen/sfx-ph-jobs.json +169 -0
  248. package/scripts/music/gen/sfx-ph-moss.json +6564 -0
  249. package/scripts/music/gen/sfx-ph-sa3-medium.json +7239 -0
  250. package/scripts/music/gen/sfx-ph-summary.json +63 -0
  251. package/scripts/music/gen/sfx-sa3-medium.json +4082 -0
  252. package/scripts/music/gen/sfx-sa3.json +4082 -0
  253. package/scripts/music/gen/sfx-summary.json +107 -0
  254. package/scripts/music/gen/sfx_build.py +332 -0
  255. package/scripts/music/gen/sfx_merge.py +255 -0
  256. package/scripts/music/gen/sfx_minimax.py +61 -0
  257. package/scripts/music/gen/sfx_nalati.py +331 -0
  258. package/scripts/music/gen/sfx_sprite.py +424 -0
  259. package/scripts/music/gen/stems.py +539 -0
  260. package/scripts/music/gen/test_loop_meter.py +29 -0
  261. package/scripts/music/gen/test_ob7_provenance.py +77 -0
  262. package/scripts/music/gen/v3-folk-build.json +148 -0
  263. package/scripts/music/gen/v3-folk.json +1818 -0
  264. package/scripts/music/gen/v3-jobs.json +145 -0
  265. package/scripts/music/gen/v3-orchestral-build.json +148 -0
  266. package/scripts/music/gen/v3-orchestral.json +1813 -0
  267. package/scripts/music/gen/v3-ph-folk-build.json +94 -0
  268. package/scripts/music/gen/v3-ph-folk.json +1806 -0
  269. package/scripts/music/gen/v3-ph-orchestral-build.json +94 -0
  270. package/scripts/music/gen/v3-ph-orchestral.json +1824 -0
  271. package/scripts/music/gen/v3-ph-piano-build.json +94 -0
  272. package/scripts/music/gen/v3-ph-piano.json +1818 -0
  273. package/scripts/music/gen/v3-piano-build.json +148 -0
  274. package/scripts/music/gen/v3-piano.json +1813 -0
  275. package/scripts/music/wildshard-theme.mid +0 -0
  276. package/scripts/music/wildshard-trailer30.mid +0 -0
  277. package/scripts/named-blob-output.d.mts +8 -0
  278. package/scripts/named-blob-output.mjs +48 -0
  279. package/scripts/pack-all.mjs +15 -0
  280. package/scripts/pid-lock.d.mts +1 -0
  281. package/scripts/pid-lock.mjs +63 -0
  282. package/scripts/practice/bake_dummy.py +53 -0
  283. package/scripts/practice/build_dummies.sh +43 -0
  284. package/scripts/practice/dummy_parts.py +568 -0
  285. package/scripts/practice/dummy_rig_gate.py +139 -0
  286. package/scripts/practice/gate_sheet.py +36 -0
  287. package/scripts/practice/generate_dummy_unimate.py +132 -0
  288. package/scripts/practice/pack_dummy.mjs +59 -0
  289. package/scripts/practice/repair_dummy_weights.mjs +68 -0
  290. package/scripts/practice/rig_dummy.py +828 -0
  291. package/scripts/practice/verify_unimate_skin.mjs +356 -0
  292. package/scripts/preparation-seed.mjs +15 -0
  293. package/scripts/prepare-basis-tool.mjs +6 -0
  294. package/scripts/prepare-product.d.mts +14 -0
  295. package/scripts/prepare-product.mjs +101 -0
  296. package/scripts/product-build-tools.d.mts +3 -0
  297. package/scripts/product-build-tools.json +3 -0
  298. package/scripts/product-build-tools.mjs +31 -0
  299. package/scripts/publish-public.mjs +7 -0
  300. package/scripts/push-tables.d.mts +1 -0
  301. package/scripts/push-tables.mjs +28 -0
  302. package/scripts/record-shard-mounts.mjs +133 -0
  303. package/scripts/sdk-externals.d.mts +2 -0
  304. package/scripts/sdk-externals.mjs +2 -0
  305. package/scripts/section-inventory.ts +209 -0
  306. package/scripts/select-candidate.mjs +15 -0
  307. package/scripts/shard-build-pool.d.mts +4 -0
  308. package/scripts/shard-build-pool.mjs +53 -0
  309. package/scripts/shard-line-baseline.json +17 -0
  310. package/scripts/shard-milestones.d.mts +15 -0
  311. package/scripts/shard-milestones.mjs +105 -0
  312. package/scripts/shard-output-report.d.mts +9 -0
  313. package/scripts/shard-output-report.mjs +85 -0
  314. package/scripts/shard-platform-cli.mjs +93 -0
  315. package/scripts/shard-progress.mjs +212 -0
  316. package/scripts/shard-timelapse.py +102 -0
  317. package/scripts/shardfile-cold-boot.mjs +79 -0
  318. package/scripts/shardfile-vite.d.mts +4 -0
  319. package/scripts/shardfile-vite.mjs +20 -0
  320. package/scripts/simplify-models.mjs +24 -0
  321. package/scripts/site-facts.mjs +88 -0
  322. package/scripts/test-template-gate.mjs +44 -0
  323. package/scripts/test_golden_compare.py +68 -0
  324. package/scripts/tex-tiers.cache.json +181 -0
  325. package/scripts/tex-tiers.mjs +240 -0
  326. package/scripts/texmem-probe.mjs +184 -0
  327. package/scripts/unused-assets.mjs +173 -0
  328. package/scripts/vite-tmp.d.mts +23 -0
  329. package/scripts/vite-tmp.mjs +157 -0
  330. package/scripts/wave-line-baselines.json +32 -0
  331. package/scripts/wildshard.d.mts +4 -0
  332. package/scripts/wildshard.mjs +105 -0
  333. package/scripts/witness-checkpoints.d.mts +10 -0
  334. package/scripts/witness-checkpoints.mjs +84 -0
  335. package/scripts/witness-generation.d.mts +10 -0
  336. package/scripts/witness-generation.mjs +45 -0
  337. package/scripts/witness-manifests.d.mts +8 -0
  338. package/scripts/witness-manifests.mjs +157 -0
  339. package/scripts/worktree-ignore.d.mts +4 -0
  340. package/scripts/worktree-ignore.mjs +36 -0
  341. package/scripts/worktree-reap.mjs +214 -0
  342. package/scripts/worktree.mjs +396 -0
  343. package/scripts/worldclaw/capture-front.sh +28 -0
  344. package/scripts/worldclaw/design-template.md +62 -0
  345. package/scripts/worldclaw/spec-map.py +92 -0
  346. package/scripts/worldclaw/spec.ts +96 -0
  347. package/skills/wildshard/SKILL.md +50 -0
  348. package/skills/wildshard-goldens/SKILL.md +54 -0
  349. package/skills/wildshard-mockup-to-model/SKILL.md +56 -0
  350. package/skills/wildshard-upgrade/SKILL.md +47 -0
  351. package/src/.oxfmtrc.json +50 -0
  352. package/src/.oxlintrc.json +173 -0
  353. package/src/cli/account/account.ts +199 -0
  354. package/src/cli/account/command.ts +193 -0
  355. package/src/cli/account/key.ts +154 -0
  356. package/src/cli/args.ts +97 -0
  357. package/src/cli/audio/audio.ts +39 -0
  358. package/src/cli/bin.mjs +8 -0
  359. package/src/cli/delete/delete.ts +258 -0
  360. package/src/cli/help.ts +204 -0
  361. package/src/cli/hero/adopt.ts +103 -0
  362. package/src/cli/hero/hero.ts +112 -0
  363. package/src/cli/hero/stamp.ts +298 -0
  364. package/src/cli/main.ts +291 -0
  365. package/src/cli/report.ts +20 -0
  366. package/src/cli/shardfile/command.ts +49 -0
  367. package/src/cli/shardfile/shardfile.ts +192 -0
  368. package/src/cli/upload/api.ts +246 -0
  369. package/src/cli/upload/compress.ts +55 -0
  370. package/src/cli/upload/hero.ts +62 -0
  371. package/src/cli/upload/placement.ts +115 -0
  372. package/src/cli/upload/provenance.ts +192 -0
  373. package/src/cli/upload/signature.ts +30 -0
  374. package/src/cli/upload/upload.ts +269 -0
  375. package/src/cli/upload/validate.ts +74 -0
  376. package/src/cli/upload/wire.ts +147 -0
  377. package/src/cli/version.ts +63 -0
  378. package/src/commons/bake/portableMath.ts +187 -0
  379. package/src/commons/catalogue.ts +10 -0
  380. package/src/commons/courseProgram.ts +32 -0
  381. package/src/commons/practiceCourse.ts +16 -0
  382. package/src/commons/scripts/abi.as +14 -0
  383. package/src/commons/scripts/bridge.as +14 -0
  384. package/src/commons/scripts/course.as +63 -0
  385. package/src/scripts/ask-new.sh +29 -0
  386. package/src/scripts/asks.mjs +141 -0
  387. package/src/scripts/herdr-prompt.sh +34 -0
  388. package/src/scripts/herdr-question-open.sh +67 -0
  389. package/src/scripts/md-wrap.mjs +229 -0
  390. package/src/server/app.ts +19 -0
  391. package/src/server/serve.ts +49 -0
  392. package/src/sharddev/admission.ts +7 -0
  393. package/src/sharddev/agentFiles.ts +127 -0
  394. package/src/sharddev/arenaView.ts +15 -0
  395. package/src/sharddev/as/groupBankV2.ts +36 -0
  396. package/src/sharddev/as/groupStepV2.ts +13 -0
  397. package/src/sharddev/as/ws.ts +30 -0
  398. package/src/sharddev/as/wsV2.ts +180 -0
  399. package/src/sharddev/assemblyscriptCompiler.d.mts +5 -0
  400. package/src/sharddev/assemblyscriptCompiler.mjs +14 -0
  401. package/src/sharddev/assetHandle.ts +84 -0
  402. package/src/sharddev/assetOwner.ts +70 -0
  403. package/src/sharddev/assetScope.ts +30 -0
  404. package/src/sharddev/assets.ts +21 -0
  405. package/src/sharddev/audio.ts +9 -0
  406. package/src/sharddev/audioEncode.ts +211 -0
  407. package/src/sharddev/author.ts +3 -0
  408. package/src/sharddev/authorError.ts +28 -0
  409. package/src/sharddev/authorManifest.ts +39 -0
  410. package/src/sharddev/bake/annulus.ts +19 -0
  411. package/src/sharddev/bake/assemblyscriptMemo.ts +76 -0
  412. package/src/sharddev/bake/assemblyscriptMemoPort.ts +4 -0
  413. package/src/sharddev/bake/authoredWorld.ts +201 -0
  414. package/src/sharddev/bake/basisEncoder.ts +95 -0
  415. package/src/sharddev/bake/basisGlb.ts +85 -0
  416. package/src/sharddev/bake/basisTool.ts +74 -0
  417. package/src/sharddev/bake/basisToolInputs.ts +476 -0
  418. package/src/sharddev/bake/byteCodec.ts +33 -0
  419. package/src/sharddev/bake/canvasAtlas.ts +406 -0
  420. package/src/sharddev/bake/coarseCopy.ts +59 -0
  421. package/src/sharddev/bake/colliders.ts +87 -0
  422. package/src/sharddev/bake/compactGlb.ts +224 -0
  423. package/src/sharddev/bake/compileScript.ts +119 -0
  424. package/src/sharddev/bake/compileScriptV2.ts +75 -0
  425. package/src/sharddev/bake/contactRows.ts +84 -0
  426. package/src/sharddev/bake/creaturePlacement.ts +117 -0
  427. package/src/sharddev/bake/export.ts +67 -0
  428. package/src/sharddev/bake/facetedGeometry.ts +379 -0
  429. package/src/sharddev/bake/farImpostor.ts +120 -0
  430. package/src/sharddev/bake/forest.ts +100 -0
  431. package/src/sharddev/bake/format-hook.mjs +2 -0
  432. package/src/sharddev/bake/generatorGlb.ts +23 -0
  433. package/src/sharddev/bake/geometryBounds.ts +77 -0
  434. package/src/sharddev/bake/geometryError.ts +48 -0
  435. package/src/sharddev/bake/glb.ts +355 -0
  436. package/src/sharddev/bake/glbCompression.ts +143 -0
  437. package/src/sharddev/bake/gltfSource.ts +59 -0
  438. package/src/sharddev/bake/groundMap.ts +142 -0
  439. package/src/sharddev/bake/image.ts +20 -0
  440. package/src/sharddev/bake/isleMap.ts +64 -0
  441. package/src/sharddev/bake/json.mjs +84 -0
  442. package/src/sharddev/bake/keyedSky.ts +47 -0
  443. package/src/sharddev/bake/keyedSkyMemo.ts +39 -0
  444. package/src/sharddev/bake/kinds.ts +137 -0
  445. package/src/sharddev/bake/lightSources.ts +31 -0
  446. package/src/sharddev/bake/mapAssembly.ts +84 -0
  447. package/src/sharddev/bake/mapRaster.ts +173 -0
  448. package/src/sharddev/bake/mapRest.ts +57 -0
  449. package/src/sharddev/bake/mapScenes.ts +234 -0
  450. package/src/sharddev/bake/materialGraph.ts +32 -0
  451. package/src/sharddev/bake/meadow.ts +27 -0
  452. package/src/sharddev/bake/meshoptChoiceMemo.ts +34 -0
  453. package/src/sharddev/bake/nativeInteractionFacts.ts +5 -0
  454. package/src/sharddev/bake/nativeLattice.ts +178 -0
  455. package/src/sharddev/bake/nativeRaster.ts +106 -0
  456. package/src/sharddev/bake/nativeTerrainField.ts +11 -0
  457. package/src/sharddev/bake/navigation-json.mjs +38 -0
  458. package/src/sharddev/bake/navigation.ts +113 -0
  459. package/src/sharddev/bake/navigationAsset.ts +18 -0
  460. package/src/sharddev/bake/nearPlaceholder.ts +206 -0
  461. package/src/sharddev/bake/normalizeRig.ts +80 -0
  462. package/src/sharddev/bake/phoneAstc.ts +93 -0
  463. package/src/sharddev/bake/placeholders.ts +581 -0
  464. package/src/sharddev/bake/placement.ts +80 -0
  465. package/src/sharddev/bake/portableBytes.ts +18 -0
  466. package/src/sharddev/bake/portableBytesMemo.ts +50 -0
  467. package/src/sharddev/bake/practiceCourse.ts +49 -0
  468. package/src/sharddev/bake/primitives.ts +96 -0
  469. package/src/sharddev/bake/props.ts +443 -0
  470. package/src/sharddev/bake/questPlacement.ts +98 -0
  471. package/src/sharddev/bake/rawTexture.ts +26 -0
  472. package/src/sharddev/bake/riderArms.ts +97 -0
  473. package/src/sharddev/bake/rig.ts +95 -0
  474. package/src/sharddev/bake/riggedHullRecipes.ts +40 -0
  475. package/src/sharddev/bake/signPlacements.ts +25 -0
  476. package/src/sharddev/bake/simplifier.ts +52 -0
  477. package/src/sharddev/bake/skinned.ts +312 -0
  478. package/src/sharddev/bake/slabChunks.ts +149 -0
  479. package/src/sharddev/bake/slabs.ts +263 -0
  480. package/src/sharddev/bake/source-loader.mjs +55 -0
  481. package/src/sharddev/bake/sourceMetadata.ts +54 -0
  482. package/src/sharddev/bake/species.ts +368 -0
  483. package/src/sharddev/bake/specimenCatalogue.ts +47 -0
  484. package/src/sharddev/bake/splatGround.ts +141 -0
  485. package/src/sharddev/bake/staticMaterials.ts +171 -0
  486. package/src/sharddev/bake/terrain.ts +195 -0
  487. package/src/sharddev/bake/texture.ts +33 -0
  488. package/src/sharddev/bake/textureWasm.ts +81 -0
  489. package/src/sharddev/bake/tileEncoder.ts +11 -0
  490. package/src/sharddev/bake/tileGrid.ts +62 -0
  491. package/src/sharddev/bake/v2Finite.ts +160 -0
  492. package/src/sharddev/bake/v2Fuel.ts +71 -0
  493. package/src/sharddev/bake/wholePartition.ts +74 -0
  494. package/src/sharddev/bake/wholePieceJoin.ts +147 -0
  495. package/src/sharddev/bake/world.ts +173 -0
  496. package/src/sharddev/bake/worldCollision.ts +128 -0
  497. package/src/sharddev/bake/worldGeometry.ts +237 -0
  498. package/src/sharddev/bake/worldGlb.ts +123 -0
  499. package/src/sharddev/bake/worldImage.ts +12 -0
  500. package/src/sharddev/bake/worldLod.ts +128 -0
  501. package/src/sharddev/bake/worldRows.ts +102 -0
  502. package/src/sharddev/bake/worldTextureMemo.ts +63 -0
  503. package/src/sharddev/bake/zstdBytesMemo.ts +52 -0
  504. package/src/sharddev/bake.ts +193 -0
  505. package/src/sharddev/bakePublication.ts +31 -0
  506. package/src/sharddev/behaviourSource.ts +94 -0
  507. package/src/sharddev/bin/wildshard.mjs +7 -0
  508. package/src/sharddev/blobBytes.ts +65 -0
  509. package/src/sharddev/blobs.ts +138 -0
  510. package/src/sharddev/bootInventory.ts +129 -0
  511. package/src/sharddev/bossProfiles.ts +18 -0
  512. package/src/sharddev/buildBehaviour.ts +77 -0
  513. package/src/sharddev/buildCacheMetrics.ts +17 -0
  514. package/src/sharddev/buildDecisionScripts.ts +122 -0
  515. package/src/sharddev/check.ts +118 -0
  516. package/src/sharddev/checkProject.ts +127 -0
  517. package/src/sharddev/cli.ts +200 -0
  518. package/src/sharddev/clientChannels.ts +169 -0
  519. package/src/sharddev/clientScripts.ts +10 -0
  520. package/src/sharddev/commons.ts +77 -0
  521. package/src/sharddev/commonsCosts.ts +11 -0
  522. package/src/sharddev/compileMovers.ts +11 -0
  523. package/src/sharddev/configBoundary.ts +6 -0
  524. package/src/sharddev/cookInput.ts +40 -0
  525. package/src/sharddev/crowds.ts +6 -0
  526. package/src/sharddev/decisionBindingMap.ts +11 -0
  527. package/src/sharddev/decisionScriptBindings.ts +117 -0
  528. package/src/sharddev/decisionScripts.ts +28 -0
  529. package/src/sharddev/decisionSource.ts +51 -0
  530. package/src/sharddev/dev.ts +113 -0
  531. package/src/sharddev/director.ts +26 -0
  532. package/src/sharddev/directorAbi.ts +77 -0
  533. package/src/sharddev/discoveryDocument.ts +97 -0
  534. package/src/sharddev/draft.ts +11 -0
  535. package/src/sharddev/eliteEntryRows.ts +29 -0
  536. package/src/sharddev/entries.ts +76 -0
  537. package/src/sharddev/entryReads.ts +73 -0
  538. package/src/sharddev/executeBundle.ts +55 -0
  539. package/src/sharddev/finds.ts +5 -0
  540. package/src/sharddev/formatJsonSchema.ts +3 -0
  541. package/src/sharddev/generationCache.ts +257 -0
  542. package/src/sharddev/generationRecipe.ts +94 -0
  543. package/src/sharddev/handwritten.ts +110 -0
  544. package/src/sharddev/immutable.ts +14 -0
  545. package/src/sharddev/interactions.ts +38 -0
  546. package/src/sharddev/kit/bakedGeometry.ts +16 -0
  547. package/src/sharddev/kit/geometryPack.ts +110 -0
  548. package/src/sharddev/ledger.ts +13 -0
  549. package/src/sharddev/looks/tileField.ts +67 -0
  550. package/src/sharddev/materialGraphFiles.ts +57 -0
  551. package/src/sharddev/materials.ts +574 -0
  552. package/src/sharddev/measure.ts +18 -0
  553. package/src/sharddev/modes.ts +115 -0
  554. package/src/sharddev/moverPrograms.ts +213 -0
  555. package/src/sharddev/movers.ts +75 -0
  556. package/src/sharddev/nativePopulationRows.ts +46 -0
  557. package/src/sharddev/newProject.ts +226 -0
  558. package/src/sharddev/noise.ts +54 -0
  559. package/src/sharddev/outputProduct.ts +188 -0
  560. package/src/sharddev/outputRuntime.ts +66 -0
  561. package/src/sharddev/performancePolicy.ts +29 -0
  562. package/src/sharddev/phasedBoss.ts +34 -0
  563. package/src/sharddev/physics.ts +194 -0
  564. package/src/sharddev/platformSections.ts +42 -0
  565. package/src/sharddev/plumbing.ts +8 -0
  566. package/src/sharddev/productOutput.ts +128 -0
  567. package/src/sharddev/project.ts +337 -0
  568. package/src/sharddev/projectCompilerIdentity.ts +94 -0
  569. package/src/sharddev/projectDecisions.ts +66 -0
  570. package/src/sharddev/projectEntryProof.ts +32 -0
  571. package/src/sharddev/projectGeneration.ts +219 -0
  572. package/src/sharddev/projectInputFiles.ts +47 -0
  573. package/src/sharddev/projectManifest.ts +108 -0
  574. package/src/sharddev/projectMap.ts +35 -0
  575. package/src/sharddev/projectOutput.ts +242 -0
  576. package/src/sharddev/projectPolicy.ts +17 -0
  577. package/src/sharddev/projectSections.ts +27 -0
  578. package/src/sharddev/questGraph.ts +25 -0
  579. package/src/sharddev/quests.ts +65 -0
  580. package/src/sharddev/random.ts +61 -0
  581. package/src/sharddev/refusals.ts +304 -0
  582. package/src/sharddev/reportCard.ts +13 -0
  583. package/src/sharddev/returnProjectionV2.ts +81 -0
  584. package/src/sharddev/rows.ts +192 -0
  585. package/src/sharddev/runtimeImports.ts +38 -0
  586. package/src/sharddev/runtimeMirrors.ts +39 -0
  587. package/src/sharddev/runtimePerformance.ts +38 -0
  588. package/src/sharddev/scene.ts +321 -0
  589. package/src/sharddev/sceneAnimation.ts +54 -0
  590. package/src/sharddev/sceneAudio.ts +64 -0
  591. package/src/sharddev/sceneDeclarations.ts +100 -0
  592. package/src/sharddev/sceneGraph.ts +139 -0
  593. package/src/sharddev/sceneTransform.ts +12 -0
  594. package/src/sharddev/schemaValidation.ts +61 -0
  595. package/src/sharddev/sections.ts +47 -0
  596. package/src/sharddev/shardSource.ts +59 -0
  597. package/src/sharddev/sourceReader.ts +26 -0
  598. package/src/sharddev/spawns.ts +38 -0
  599. package/src/sharddev/species/clips.ts +24 -0
  600. package/src/sharddev/species.ts +29 -0
  601. package/src/sharddev/speciesBrains.ts +19 -0
  602. package/src/sharddev/synth.ts +66 -0
  603. package/src/sharddev/test/compileDualScriptV2.ts +71 -0
  604. package/src/sharddev/test/compileSimV2.ts +21 -0
  605. package/src/sharddev/test/diskScriptScenario.ts +86 -0
  606. package/src/sharddev/test/scriptScenario.ts +249 -0
  607. package/src/sharddev/test/scriptSource.ts +12 -0
  608. package/src/sharddev/version.ts +4 -0
  609. package/src/sharddev/weapons/bowProfile.ts +20 -0
  610. package/src/sharddev/weapons/firearmRows.ts +11 -0
  611. package/src/sharddev/weapons/meleeProfile.ts +71 -0
  612. package/src/sharddev/weapons/thrownProfile.ts +10 -0
  613. package/src/sharddev/worldScenes.ts +308 -0
  614. package/src/sharddev/worldSource.ts +82 -0
  615. package/src/shards/_template/README.md +78 -0
  616. package/src/shards/_template/assets/2bf489fdb15f1734ddb4c4f32d500ec6da85c765ec7a4eb28dc6781160e7ec8c +0 -0
  617. package/src/shards/_template/assets/97ec4d8f75f5fa6239ee919444d6dc19fd35896bb305930c1f050ac6e0e0e6a6 +1 -0
  618. package/src/shards/_template/assets/a6a587a31327f936b1b04c05ade818c73fc8964260918662db43539465e27586 +0 -0
  619. package/src/shards/_template/assets/b4fbde0422e125b498c3dc8b9a5cc2516c8598f09e9d0e5f6b639b32f98179e6 +0 -0
  620. package/src/shards/_template/assets/bfa4dfc9c18979f904557ee8deab0058b8a399be10266f5fb1578b403f482fd4 +1 -0
  621. package/src/shards/_template/assets/ef3b7ff4fd22715771cb7d68a3977a903c5e7c3dc293542687d04b3ef3ace2cb +0 -0
  622. package/src/shards/_template/assets/f2db05998615ce1cb79ea96be32c168842eb6a2b34ec01feb86d36404603ee54 +0 -0
  623. package/src/shards/_template/assets/fef98ebb7fce6f66b26e78ac699e5c90f9bdcfaf8cabeb2b58125347eea8b4ab +0 -0
  624. package/src/shards/_template/behaviour/boss.as +39 -0
  625. package/src/shards/_template/behaviour/door.as +32 -0
  626. package/src/shards/_template/behaviour/hooks.json +129 -0
  627. package/src/shards/_template/behaviour/idle.as +75 -0
  628. package/src/shards/_template/behaviour/items.as +22 -0
  629. package/src/shards/_template/card/landscape.jpg +0 -0
  630. package/src/shards/_template/card/portrait.jpg +0 -0
  631. package/src/shards/_template/card/thumb.jpg +0 -0
  632. package/src/shards/_template/data/audio.json +45 -0
  633. package/src/shards/_template/data/bossDecision.json +83 -0
  634. package/src/shards/_template/data/budgets.json +70 -0
  635. package/src/shards/_template/data/card.json +281 -0
  636. package/src/shards/_template/data/clientScripts.json +987 -0
  637. package/src/shards/_template/data/creatures.json +65 -0
  638. package/src/shards/_template/data/director.json +39 -0
  639. package/src/shards/_template/data/encounters.json +96 -0
  640. package/src/shards/_template/data/items.json +172 -0
  641. package/src/shards/_template/data/layout.json +66 -0
  642. package/src/shards/_template/data/ledger.json +32 -0
  643. package/src/shards/_template/data/look.json +521 -0
  644. package/src/shards/_template/data/map.json +64 -0
  645. package/src/shards/_template/data/moves.json +16 -0
  646. package/src/shards/_template/data/placeholder.json +8 -0
  647. package/src/shards/_template/data/plumbing.json +32 -0
  648. package/src/shards/_template/data/quests.json +223 -0
  649. package/src/shards/_template/data/rows.json +423 -0
  650. package/src/shards/_template/data/skins.json +66 -0
  651. package/src/shards/_template/data/spawn.json +6 -0
  652. package/src/shards/_template/data/targets.json +150 -0
  653. package/src/shards/_template/data/text.json +12 -0
  654. package/src/shards/_template/data/ui.json +33 -0
  655. package/src/shards/_template/data/water.json +13 -0
  656. package/src/shards/_template/generators/behaviour.ts +34 -0
  657. package/src/shards/_template/generators/boss.ts +29 -0
  658. package/src/shards/_template/generators/buildOptions.ts +2 -0
  659. package/src/shards/_template/generators/cell.ts +224 -0
  660. package/src/shards/_template/generators/districts.ts +215 -0
  661. package/src/shards/_template/generators/farLook.ts +15 -0
  662. package/src/shards/_template/generators/generate.ts +27 -0
  663. package/src/shards/_template/generators/ground.ts +15 -0
  664. package/src/shards/_template/generators/kit.ts +69 -0
  665. package/src/shards/_template/generators/landscape.ts +59 -0
  666. package/src/shards/_template/generators/landscapeNoise.ts +62 -0
  667. package/src/shards/_template/generators/mapInputs.ts +10 -0
  668. package/src/shards/_template/generators/product.ts +100 -0
  669. package/src/shards/_template/generators/productOutput.ts +18 -0
  670. package/src/shards/_template/generators/props.ts +9 -0
  671. package/src/shards/_template/generators/templatePropsSource.ts +58 -0
  672. package/src/shards/_template/generators/terrain.ts +17 -0
  673. package/src/shards/_template/generators/world.ts +630 -0
  674. package/src/shards/_template/hero.json +10 -0
  675. package/src/shards/_template/look/entry-reads.json +20 -0
  676. package/src/shards/_template/manifest.json +281 -0
  677. package/src/shards/_template/shard.config.ts +10 -0
  678. package/src/shared/health.ts +10 -0
  679. package/src/tools/build-web.ts +59 -0
  680. package/src/tsconfig.json +30 -0
  681. package/src/web/app.tsx +53 -0
  682. package/src/web/index.html +12 -0
  683. package/src/web/main.tsx +10 -0
  684. package/src/web/tsconfig.json +13 -0
  685. package/tsconfig.author.json +23 -0
  686. package/tsconfig.commons.json +21 -0
  687. package/tsconfig.json +47 -0
  688. package/tsconfig.sharddev.json +20 -0
@@ -0,0 +1,424 @@
1
+ """Pack Pine Hollow's one-shots + barks into ONE audio sprite, and ship its mono-sourced beds mono (PINE-HOLLOW-REMASTER
2
+ load lane: the bar fetched the set one file at a time, 228 requests on a phone cold launch against the 180 budget row).
3
+
4
+ python3 scripts/music/gen/sfx_sprite.py # pack public/assets/sfx/pine-hollow/ (from the shipped files)
5
+ ~/ml/music/analysis/.venv/bin/python scripts/music/gen/sfx_sprite.py --raw <sfx-raw-dir> # from the lossless takes
6
+
7
+ Run at the end of sfx_merge.py's merge_set (which rebuilds an own set from the stage dir and would
8
+ otherwise un-pack it), and by hand. Idempotent: a set whose sfx.json already has a `sprite` and none of the packed files is
9
+ left as it is (the beds step skips a bed that is already mono). A set with a sprite AND new one-shot files (merge_set
10
+ --only: a later round added families) is re-packed: a take already in the sprite is sourced from its lossless take as
11
+ ever, or else from its slice of the old sprite's decode; the old clips keep their order (and so their offsets), the new
12
+ ones follow, and a clip no family lists any more is dropped.
13
+
14
+ Sprite. Every file under sfx.json "oneshots" (every family, the barks too) laid end to end on one 48 kHz mono timeline with
15
+ GAP (0.2 s) of silence before the first clip, between clips and after the last, encoded as ONE AAC-LC 48 kHz mono .m4a at
16
+ the one-shots' own rate (64 kb/s over the sounding part; the silent gaps cost ~nothing), content-addressed `oneshots-<sha1[:8]>.m4a`. sfx.json gets a top-level
17
+ "sprite": {"file": "oneshots-….m4a", "gap": 0.2, "duration": <s>, "clips": {"<original file name>": [startSec, durSec], …}}
18
+ (oneshots' family -> files lists and the provenance stay as they are, so provenance still names each take and the game
19
+ maps a family's files to their clips), then the individual one-shot files are deleted. A clip's source is its lossless
20
+ take re-derived exactly as sfx_build.py shipped it (trim, -18 LUFS, soxr to 48 kHz, mono) when --raw is given and that
21
+ re-derivation is the shipped file (lag 0, the same level, correlation >= MATCH_MIN), else the shipped file's own decode
22
+ (one AAC generation more).
23
+ Offsets are PROVEN, not assumed: the sprite is decoded with ffmpeg AND with afconvert (CoreAudio, Safari's decoder), each
24
+ clip's source is cross-correlated against both decodes around its stored start, and the stored start must hold to within
25
+ TOL_S (1 ms) in both (the AAC priming is carried by the m4a edit list, which both honour). A table is printed; any miss
26
+ fails the run before anything is written or deleted.
27
+
28
+ Beds (--raw only). A bed whose lossless take is MONO (every MOSS-SoundEffect bed: its model renders one channel) was
29
+ shipped as 2 identical channels at 64 kb/s stereo, whose side channel is pure coding noise. It is re-encoded mono from
30
+ the lossless take (the seam and the -24 LUFS level exactly as sfx_build.py made them, at the old per-channel level:
31
+ UPMIX) with Apple's AAC encoder, content-addressed, at the lowest rate of BED_MONO_KBPS that passes every check: the new
32
+ decode lines up with the old one in ffmpeg and in afconvert (lag 0, so loopStart / loopEnd stay valid), afconvert's
33
+ decoded length equals the old one and the take's within 1 ms (ffmpeg's carries the encoder's tail padding: recorded as
34
+ `duration`), and it is never worse than what shipped (its band at least as wide, its mean spectral error against the
35
+ lossless take no larger: the fidelity() numbers). A stereo take (Stable Audio's) keeps its file, and so does a bed
36
+ ForestAmbience pans (panned_beds: a StereoPannerNode pans a 2-channel input by another law).
37
+ """
38
+
39
+ from __future__ import annotations
40
+
41
+ import argparse
42
+ import hashlib
43
+ import json
44
+ import struct
45
+ import subprocess
46
+ import sys
47
+ import tempfile
48
+ from pathlib import Path
49
+
50
+ import numpy as np
51
+
52
+ HERE = Path(__file__).resolve().parent
53
+ sys.path.insert(0, str(HERE))
54
+ from audio_jobs import tag_name # noqa: E402
55
+ REPO = HERE.parents[2]
56
+ PH = REPO / "public/assets/sfx/pine-hollow"
57
+ SR = 48000
58
+ GAP = 0.2
59
+ KBPS = 64
60
+ # a mono bed: Apple's AAC encoder (afconvert, the one CoreAudio ships), ABR, at the lowest of these rates that is never
61
+ # worse than the shipped file. ffmpeg's own encoder is not: mono at 64 kb/s still has ~1.5x the old in-band error (measured)
62
+ BED_MONO_KBPS = (32, 40, 48)
63
+ TOL_S = 0.001
64
+ # a re-derived take is "the shipped file" when it lines up at lag 0 with the same level: AAC smears clicks and substitutes
65
+ # noise (exact in spectrum, not in waveform), so a correct re-derivation can correlate as low as ~0.7; another take gives ~0
66
+ MATCH_MIN, MATCH_DB = 0.5, 0.5
67
+ # a take compared with its slice of an older SPRITE (a re-pack): that sprite was cut from the same lossless takes (lag 0
68
+ # proven), but its encode (57 kb/s over the file) sits further from them in level than a 64 kb/s file of its own: measured
69
+ # up to 0.76 dB on the gaps round's re-pack
70
+ SPRITE_DB = 1.0
71
+ RAW_DIR = {"moss": "moss", "sa3-medium": "medium"} # sfx-raw-dir/<model>/<family>/<seed>.wav
72
+ # ffmpeg's `-ac 2` (stems.encode) put a mono take in each channel at -3.01 dB (swresample's centre mix level); WebAudio
73
+ # up-mixes a mono buffer to L = R = m ("speakers"), so the mono file carries that same per-channel level
74
+ UPMIX = 1 / np.sqrt(2)
75
+ AMBIENCE = REPO / "src/shards/pine-hollow/data/audioSource.json"
76
+
77
+
78
+ def panned_beds() -> set[str]:
79
+ """the beds ForestAmbience sends through a StereoPannerNode (its PANNED set). Those stay stereo: the panner pans a mono
80
+ input at equal power but a 2-channel one by its stereo law, which on these dual-mono files is up to ~3 dB louder
81
+ off-centre, so a mono file would change how loud the bed is to one side"""
82
+ beds = json.loads(AMBIENCE.read_text())["audio"]["zones"]["routing"]["samples"]["beds"]
83
+ return {bed["id"] for bed in beds if bed["panned"]}
84
+
85
+
86
+ # ─────────────── decode / encode ───────────────
87
+ def ff_decode(path: Path, channels: int = 1) -> np.ndarray:
88
+ """(channels, n) float at 48 kHz as ffmpeg decodes it (it honours the mp4 edit list, as Chromium's decodeAudioData does)"""
89
+ out = subprocess.run(["ffmpeg", "-v", "error", "-i", str(path), "-f", "f32le", "-ac", str(channels), "-ar", str(SR), "-"],
90
+ capture_output=True, check=True).stdout
91
+ return np.frombuffer(out, np.float32).reshape(-1, channels).T.astype(np.float64)
92
+
93
+
94
+ def read_wav(path: Path) -> np.ndarray:
95
+ """(channels, n) float from a 32-bit float WAVE (afconvert's output; chunks walked, not assumed)"""
96
+ b = path.read_bytes()
97
+ assert b[:4] == b"RIFF" and b[8:12] == b"WAVE", path
98
+ pos, fmt, data = 12, None, None
99
+ while pos + 8 <= len(b):
100
+ cid, size = b[pos:pos + 4], struct.unpack("<I", b[pos + 4:pos + 8])[0]
101
+ body = b[pos + 8:pos + 8 + size]
102
+ if cid == b"fmt ":
103
+ fmt = struct.unpack("<HHIIHH", body[:16])
104
+ elif cid == b"data":
105
+ data = body
106
+ pos += 8 + size + (size & 1)
107
+ assert fmt is not None and data is not None, path
108
+ tag, ch, rate, _, _, bits = fmt
109
+ assert rate == SR and bits == 32 and tag in (3, 0xFFFE), (path, fmt)
110
+ return np.frombuffer(data, "<f4").reshape(-1, ch).T.astype(np.float64)
111
+
112
+
113
+ def af_decode(path: Path, channels: int = 1) -> np.ndarray:
114
+ """(channels, n) float at 48 kHz as CoreAudio decodes it (afconvert: Safari's decoder; honours the edit list / iTunSMPB)"""
115
+ with tempfile.TemporaryDirectory() as d:
116
+ wav = Path(d) / "x.wav"
117
+ subprocess.run(["afconvert", "-f", "WAVE", "-d", f"LEF32@{SR}", "-c", str(channels), str(path), str(wav)], check=True, capture_output=True)
118
+ return read_wav(wav)
119
+
120
+
121
+ def write_wav(y: np.ndarray, path: Path) -> None:
122
+ """(channels, n) float -> a 32-bit float WAVE at 48 kHz"""
123
+ data = np.ascontiguousarray(y.T, dtype="<f4").tobytes()
124
+ ch = y.shape[0]
125
+ fmt = struct.pack("<HHIIHH", 3, ch, SR, SR * 4 * ch, 4 * ch, 32)
126
+ path.write_bytes(b"RIFF" + struct.pack("<I", 4 + 8 + len(fmt) + 8 + len(data)) + b"WAVE"
127
+ + b"fmt " + struct.pack("<I", len(fmt)) + fmt + b"data" + struct.pack("<I", len(data)) + data)
128
+
129
+
130
+ def encode(y: np.ndarray, dest: Path, kbps: int, apple: bool = False) -> None:
131
+ """(channels, n) float at 48 kHz -> AAC-LC .m4a: ffmpeg's encoder (as stems.encode ships every file), or Apple's through
132
+ afconvert (ABR, best quality) - its own m4a writer, whose priming / padding CoreAudio and ffmpeg both read right
133
+ (ffmpeg's muxer around its aac_at wrapper leaves CoreAudio ~12 ms of tail padding: measured)"""
134
+ if apple:
135
+ with tempfile.TemporaryDirectory() as d:
136
+ wav = Path(d) / "x.wav"
137
+ write_wav(y, wav)
138
+ subprocess.run(["afconvert", "-f", "m4af", "-d", "aac", "-b", str(kbps * 1000), "-s", "1", "-q", "127", str(wav), str(dest)],
139
+ check=True, capture_output=True)
140
+ return
141
+ subprocess.run(["ffmpeg", "-y", "-v", "error", "-f", "f32le", "-ar", str(SR), "-ac", str(y.shape[0]), "-i", "-", "-c:a", "aac",
142
+ "-b:a", f"{kbps}k", "-movflags", "+faststart", str(dest)],
143
+ input=np.ascontiguousarray(y.T, dtype="<f4").tobytes(), check=True)
144
+
145
+
146
+ def content_name(tmp: Path, stem: str) -> str:
147
+ """<stem>-<sha1[:8]>.m4a (stems.shipped_name's rule: the service worker serves audio cache-first)"""
148
+ name = f"{stem}-{hashlib.sha1(tmp.read_bytes()).hexdigest()[:8]}.m4a"
149
+ tmp.replace(tmp.parent / name)
150
+ return name
151
+
152
+
153
+ def probe(path: Path) -> dict:
154
+ p = subprocess.run(["ffprobe", "-v", "error", "-select_streams", "a:0", "-show_entries", "stream=codec_name,profile,sample_rate,channels,bit_rate",
155
+ "-of", "json", str(path)], capture_output=True, check=True, text=True)
156
+ return json.loads(p.stdout)["streams"][0]
157
+
158
+
159
+ def xlag(a: np.ndarray, b: np.ndarray, search: int) -> tuple[int, float]:
160
+ """(lag of b inside a in samples - positive = b sits later in a, normalised correlation at that lag); a is b's window
161
+ padded by `search` samples on both sides"""
162
+ n = len(a) + len(b)
163
+ c = np.fft.irfft(np.fft.rfft(a, n) * np.conj(np.fft.rfft(b, n)), n)[: 2 * search + 1]
164
+ k = int(np.argmax(c))
165
+ seg = a[k:k + len(b)]
166
+ den = float(np.sqrt((seg ** 2).sum() * (b ** 2).sum())) or 1.0
167
+ return k - search, float(c[k] / den)
168
+
169
+
170
+ # ─────────────── the lossless takes (the analysis venv: librosa, soundfile) ───────────────
171
+ class Lossless:
172
+ """a shipped file re-derived from its raw take exactly as sfx_build.py made it (before its AAC encode)"""
173
+
174
+ def __init__(self, raw: Path, tag: str = "ph") -> None:
175
+ sys.path.insert(0, str(HERE))
176
+ import librosa
177
+ import soundfile as sf
178
+ from sfx_build import LEVEL, trim
179
+ from stems import lufs, seam
180
+
181
+ self.raw, self.librosa, self.sf, self.LEVEL, self.trim, self.lufs, self.seam = raw, librosa, sf, LEVEL, trim, lufs, seam
182
+ self.rank = {s: json.loads((HERE / f"sfx-{tag}-{s}.json").read_text())["families"] for s in RAW_DIR}
183
+
184
+ def wav(self, prov: dict, fam: str) -> Path:
185
+ return self.raw / RAW_DIR[prov["set_of_origin"]] / fam / f"{prov['seed']}.wav"
186
+
187
+ def take(self, prov: dict, fam: str, kind: str) -> tuple[np.ndarray, int]:
188
+ """(channels, n) at 48 kHz (mono for a one-shot, the take's own channels for a bed), and the raw take's channels"""
189
+ x, sr = self.sf.read(str(self.wav(prov, fam)), always_2d=True)
190
+ x = x.T.astype(np.float64)
191
+ if kind == "bed":
192
+ row = next(r for r in self.rank[prov["set_of_origin"]][fam] if r["seed"] == prov["seed"])
193
+ y, _ = self.seam(x, sr, {"loopStart": row["seam"]["start_s"], "loopEnd": row["seam"]["end_s"]}, 1.0)
194
+ else:
195
+ y = self.trim(x, sr, 3.0)
196
+ L, tp = self.lufs(y, sr)
197
+ y = y * 10 ** (min(self.LEVEL[kind] - L, -1.0 - tp) / 20)
198
+ y = self.librosa.resample(y, orig_sr=sr, target_sr=SR, res_type="soxr_hq") if sr != SR else y
199
+ return (y.mean(0, keepdims=True) if kind == "oneshot" else y), x.shape[0]
200
+
201
+
202
+ def matches(src: np.ndarray, shipped: np.ndarray) -> tuple[int, float, float]:
203
+ """(lag, correlation, level difference in dB) of a re-derived take against the shipped file's decode (mono, 48 kHz)"""
204
+ n = min(len(src), len(shipped))
205
+ pad = np.concatenate([np.zeros(480), shipped[:n], np.zeros(480)])
206
+ lag, r = xlag(pad, src[:n], 480)
207
+ return lag, r, float(10 * np.log10((src[:n] ** 2).sum() / max((shipped[:n] ** 2).sum(), 1e-20)))
208
+
209
+
210
+ def same(m: tuple[int, float, float], db: float = MATCH_DB) -> bool:
211
+ return m[0] == 0 and m[1] >= MATCH_MIN and abs(m[2]) <= db
212
+
213
+
214
+ # ─────────────── the sprite ───────────────
215
+ def pack(ph: Path, lossless: Lossless | None) -> None:
216
+ man_path = ph / "sfx.json"
217
+ man = json.loads(man_path.read_text())
218
+ shots = man.get("oneshots", {})
219
+ order: list[tuple[str, str]] = [] # (file, family), families in sfx.json order
220
+ for fam, v in shots.items():
221
+ for f in (v["files"] if isinstance(v, dict) else v):
222
+ if f not in [o for o, _ in order]:
223
+ order.append((f, fam))
224
+ have = [f for f, _ in order if (ph / f).exists()]
225
+ if "sprite" in man and not have:
226
+ print(f"sprite: already packed ({man['sprite']['file']}, {len(man['sprite']['clips'])} clips) - nothing to do")
227
+ return
228
+ # a later round's files next to the packed set: the packed takes come out of the old sprite
229
+ old = man.get("sprite")
230
+ old_dec = ff_decode(ph / old["file"])[0] if old and (ph / old["file"]).exists() else None
231
+ old_clips: dict[str, list[float]] = old["clips"] if old_dec is not None else {}
232
+ missing = [f for f, _ in order if not (ph / f).exists() and f not in old_clips]
233
+ if missing:
234
+ raise SystemExit(f"sprite: {len(missing)} one-shot files are missing and there is no sprite to keep: {missing[:5]}")
235
+ if not order:
236
+ print("sprite: no shipped one-shots - nothing to pack")
237
+ return
238
+ rates = {int(probe(ph / f)["bit_rate"]) for f, _ in order if (ph / f).exists()}
239
+ print(f"sprite: {len(order)} one-shots, their rates {min(rates) // 1000}-{max(rates) // 1000} kb/s -> one file, {KBPS} kb/s where it sounds")
240
+
241
+ prov = {p["file"]: p for p in man.get("provenance", [])}
242
+ gap = round(GAP * SR)
243
+ parts: list[np.ndarray] = [np.zeros(gap)]
244
+ clips: dict[str, list[float]] = {}
245
+ srcs: dict[str, np.ndarray] = {}
246
+ origin: dict[str, str] = {}
247
+ pos = gap
248
+ def shipped_of(f: str) -> np.ndarray:
249
+ if (ph / f).exists():
250
+ return ff_decode(ph / f)[0]
251
+ a, n = round(old_clips[f][0] * SR), round(old_clips[f][1] * SR)
252
+ return old_dec[a:a + n] # its slice of the old sprite (lag 0: proven when that sprite was packed)
253
+
254
+ for f, fam in order:
255
+ shipped = shipped_of(f)
256
+ src, how = shipped, "aac"
257
+ if lossless is not None and f in prov and lossless.wav(prov[f], fam).exists():
258
+ y, _ = lossless.take(prov[f], fam, "oneshot")
259
+ m = matches(y[0], shipped)
260
+ if same(m, MATCH_DB if (ph / f).exists() else SPRITE_DB):
261
+ src, how = y[0], "lossless"
262
+ else:
263
+ print(f" {f}: the raw take does not match the shipped file (lag {m[0]}, r {m[1]:.3f}, {m[2]:+.2f} dB) - its shipped decode is packed")
264
+ srcs[f], origin[f] = src, how
265
+ clips[f] = [round(pos / SR, 6), round(len(src) / SR, 6)]
266
+ parts += [src, np.zeros(gap)]
267
+ pos += len(src) + gap
268
+ timeline = np.concatenate(parts)[None]
269
+
270
+ tmp = ph / ".sprite.tmp.m4a"
271
+ # the encoder's rate control averages over the whole file and a silent frame costs ~4 bytes: the gaps' share of the
272
+ # time comes off the target, so the clips get the originals' 64 kb/s (not ~72)
273
+ encode(timeline, tmp, round(KBPS * (pos - gap * (len(order) + 1)) / pos))
274
+ decs = {"ffmpeg": ff_decode(tmp)[0], "afconvert": af_decode(tmp)[0]}
275
+ fails = verify(clips, srcs, origin, decs)
276
+ if fails:
277
+ tmp.unlink()
278
+ raise SystemExit(f"sprite: {fails} clip offsets are off by more than {TOL_S * 1000:.0f} ms - nothing written")
279
+ before = sum((ph / f).stat().st_size for f, _ in order if (ph / f).exists()) + sum(o.stat().st_size for o in ph.glob("oneshots-*.m4a"))
280
+ for o in ph.glob("oneshots-*.m4a"):
281
+ o.unlink()
282
+ name = content_name(tmp, "oneshots")
283
+ man["sprite"] = {"file": name, "gap": GAP, "duration": round(min(len(d) for d in decs.values()) / SR, 6), "clips": clips} # decoded
284
+ man_path.write_text(json.dumps(man, indent=2, ensure_ascii=False) + "\n")
285
+ for f, _ in order:
286
+ (ph / f).unlink(missing_ok=True)
287
+ after = (ph / name).stat().st_size
288
+ p = probe(ph / name)
289
+ print(f"sprite: {name} {after / 1e3:.1f} kB ({p['codec_name']} {p['profile']} {p['sample_rate']} Hz {p['channels']} ch {int(p['bit_rate']) // 1000} kb/s, "
290
+ f"{len(timeline[0]) / SR:.2f} s) holds {len(order)} takes (was {before / 1e3:.1f} kB); "
291
+ f"sources: {sum(1 for v in origin.values() if v == 'lossless')} lossless, {sum(1 for v in origin.values() if v == 'aac')} shipped AAC")
292
+
293
+
294
+ def verify(clips: dict[str, list[float]], srcs: dict[str, np.ndarray], origin: dict[str, str], decs: dict[str, np.ndarray]) -> int:
295
+ """print each clip's measured start error in every decoder; the number of clips off by more than TOL_S"""
296
+ search, tol = round(0.05 * SR), round(TOL_S * SR)
297
+ print(f" {'clip':34s} {'start s':>8s} {'dur s':>6s} {'src':8s}" + "".join(f" {k + ' lag':>14s} {'r':>5s}" for k in decs))
298
+ fails, worst = 0, dict.fromkeys(decs, 0)
299
+ for f, (start, _) in clips.items():
300
+ s, src = round(start * SR), srcs[f]
301
+ row = f" {f[:34]:34s} {start:8.4f} {len(src) / SR:6.3f} {origin[f]:8s}"
302
+ for k, d in decs.items():
303
+ win = d[s - search:s + len(src) + search]
304
+ lag, r = xlag(win, src, search)
305
+ worst[k] = max(worst[k], abs(lag))
306
+ bad = abs(lag) > tol or r < MATCH_MIN # the clip must be there (another sound: r ~ 0); AAC blurs clicks to ~0.7-0.9
307
+ fails += bad
308
+ row += f" {lag:+6d} ({lag / SR * 1000:+.2f}ms) {r:5.3f}" + (" !" if bad else "")
309
+ print(row)
310
+ print(" worst |lag|: " + ", ".join(f"{k} {v} samples ({v / SR * 1000:.3f} ms)" for k, v in worst.items()) + f"; tolerance {tol} samples ({TOL_S * 1000:.0f} ms)")
311
+ return fails
312
+
313
+
314
+ # ─────────────── the beds ───────────────
315
+ def beds(ph: Path, lossless: Lossless) -> None:
316
+ man_path = ph / "sfx.json"
317
+ man = json.loads(man_path.read_text())
318
+ prov = {p["file"]: p for p in man.get("provenance", [])}
319
+ changed, gone, pan = False, [], panned_beds()
320
+ print(f" {'bed':12s} {'take':10s} {'raw ch':>6s} {'side/mid':>9s} {'old kB':>7s} {'new kB':>7s} {'ff lag':>6s} {'af lag':>6s} {'ff dur':>9s} {'af dur':>9s}"
321
+ f" {'band old':>8s} {'new':>6s} {'err old':>7s} {'new':>6s}")
322
+ for name, b in man.get("beds", {}).items():
323
+ f = b["file"]
324
+ p, fam = prov.get(f), f"bed-{name}"
325
+ if p is None or not lossless.wav(p, fam).exists():
326
+ print(f" {name:12s} no lossless take - kept")
327
+ continue
328
+ if probe(ph / f)["channels"] == 1:
329
+ print(f" {name:12s} already mono - kept")
330
+ continue
331
+ y, raw_ch = lossless.take(p, fam, "bed")
332
+ old = ff_decode(ph / f, 2)
333
+ mid, side = old.mean(0), (old[0] - old[1]) / 2
334
+ sm = 10 * np.log10((side ** 2).mean() / (mid ** 2).mean())
335
+ if raw_ch != 1:
336
+ print(f" {name:12s} {p['set_of_origin']:10s} {raw_ch:6d} {sm:8.1f}dB stereo take - kept")
337
+ continue
338
+ if name in pan:
339
+ print(f" {name:12s} {p['set_of_origin']:10s} {raw_ch:6d} {sm:8.1f}dB panned (ForestAmbience PANNED): its stereo pan law - kept")
340
+ continue
341
+ src = y.mean(0) * UPMIX
342
+ m0 = matches(src, mid)
343
+ if not same(m0):
344
+ print(f" {name:12s} the raw take does not match the shipped bed (lag {m0[0]}, r {m0[1]:.3f}, {m0[2]:+.2f} dB) - kept")
345
+ continue
346
+ tmp, old_af = ph / ".bed.tmp.m4a", af_decode(ph / f)[0]
347
+ bw_old, err_old = fidelity(src, mid)
348
+ ok, kbps = False, 0
349
+ for kbps in BED_MONO_KBPS:
350
+ encode(src[None], tmp, kbps, apple=True)
351
+ new_ff, new_af = ff_decode(tmp)[0], af_decode(tmp)[0]
352
+ lag_ff, lag_af = matches(new_ff, mid)[0], matches(new_af, old_af)[0]
353
+ dff, daf = (len(new_ff) - old.shape[1]) / SR, (len(new_af) - len(old_af)) / SR
354
+ bw_new, err_new = fidelity(src, new_ff)
355
+ # afconvert trims the AAC padding at both ends (the valid-frame count): exact. ffmpeg trims only the priming, so its
356
+ # length carries the encoder's tail padding (Apple's differs from ffmpeg's): recorded as `duration`, past loopEnd
357
+ ok = (lag_ff == 0 and lag_af == 0 and abs(daf) <= TOL_S and abs(len(new_af) - len(src)) <= TOL_S * SR
358
+ and b["loopEnd"] <= min(len(new_af), len(new_ff)) / SR
359
+ and bw_new >= bw_old and err_new <= err_old) # never worse than what ships
360
+ print(f" {name:12s} {p['set_of_origin']:10s} {raw_ch:6d} {sm:8.1f}dB {(ph / f).stat().st_size / 1e3:7.1f} {tmp.stat().st_size / 1e3:7.1f} "
361
+ f"{lag_ff:6d} {lag_af:6d} {dff * 1000:+8.2f}ms {daf * 1000:+8.2f}ms {bw_old:6.1f}kHz {bw_new:4.1f}kHz {err_old:5.2f}dB {err_new:4.2f}dB"
362
+ f" mono {kbps} kb/s" + ("" if ok else " - worse, next rate"))
363
+ if ok:
364
+ break
365
+ if not ok:
366
+ tmp.unlink()
367
+ print(f" {name:12s} no mono rate is as good as the shipped file - kept")
368
+ continue
369
+ new = content_name(tmp, f.rsplit("-", 1)[0])
370
+ gone.append(f)
371
+ b["file"] = new
372
+ p["file"] = new
373
+ b["duration"] = round(len(new_ff) / SR, 4)
374
+ p["reencode"] = f"mono {kbps} kb/s (Apple AAC) from the lossless mono take (was 2 identical channels at 64 kb/s stereo; side/mid {sm:.1f} dB = coding noise)"
375
+ changed = True
376
+ if changed:
377
+ man_path.write_text(json.dumps(man, indent=2, ensure_ascii=False) + "\n")
378
+ for f in gone: # only once sfx.json names the new files
379
+ (ph / f).unlink()
380
+
381
+
382
+ def fidelity(src: np.ndarray, dec: np.ndarray) -> tuple[float, float]:
383
+ """(the decode's band in kHz: the highest bin within 6 dB of the source's, the mean |spectral error| over 50 Hz-8 kHz in dB)
384
+ - a waveform SNR says little about AAC on noise (its noise substitution is exact in spectrum, not in waveform)"""
385
+ def psd(x: np.ndarray) -> np.ndarray:
386
+ n, w = 4096, np.hanning(4096)
387
+ return (np.abs(np.fft.rfft(np.stack([x[i:i + n] * w for i in range(0, len(x) - n, n // 2)]), axis=1)) ** 2).mean(0)
388
+ n = min(len(src), len(dec))
389
+ a, b, f = psd(src[:n]), psd(dec[:n]), np.fft.rfftfreq(4096, 1 / SR)
390
+ r = 10 * np.log10((b + 1e-20) / (a + 1e-20))
391
+ k = (f > 50) & (f < 8000)
392
+ return float(f[np.where(r > -6)[0].max()] / 1000), float(np.abs(r[k]).mean())
393
+
394
+
395
+ def run(ph: Path = PH, raw: Path | None = None, *, set_name: str = "pine-hollow", tag: str = "ph", dry: bool = False) -> None:
396
+ """the whole step (sfx_merge.py's merge_set calls this last): the beds (with the lossless takes), then the sprite"""
397
+ if dry:
398
+ # Planning must never decode/re-encode or alter the shipped manifest. The normal pack proves offsets in both decoders.
399
+ print(json.dumps({str(ph / "sfx.json"): (ph / "sfx.json").read_text()}, indent=2, ensure_ascii=False))
400
+ return
401
+ lossless = Lossless(raw, tag) if raw is not None else None
402
+ if lossless is not None and set_name == "pine-hollow":
403
+ print("beds:")
404
+ beds(ph, lossless)
405
+ else:
406
+ print("beds: no --raw or no declared panning contract for this set - left as they are")
407
+ pack(ph, lossless)
408
+
409
+
410
+ def main() -> None:
411
+ ap = argparse.ArgumentParser(description=__doc__.split("\n\n")[0])
412
+ ap.add_argument("--raw", default=None, help="the sfx raw dir sfx_build.py read (<raw>/<model>/<family>/<seed>.wav): lossless sources")
413
+ ap.add_argument("--dir", default=str(PH), help="the set to pack (default public/assets/sfx/pine-hollow)")
414
+ ap.add_argument("--set", default="pine-hollow", type=tag_name, help="public/assets/sfx/<set>/ (default pine-hollow)")
415
+ ap.add_argument("--tag", type=tag_name, help="ranking tag (default ph; nine-dragon-stack uses nd)")
416
+ ap.add_argument("--dry", action="store_true", help="replay the existing manifest JSON, no decoding or changes")
417
+ args = ap.parse_args()
418
+ dest = Path(args.dir) if args.dir != str(PH) else REPO / "public/assets/sfx" / args.set
419
+ tag = args.tag or ("nd" if args.set == "nine-dragon-stack" else "ph")
420
+ run(dest, Path(args.raw) if args.raw else None, set_name=args.set, tag=tag, dry=args.dry)
421
+
422
+
423
+ if __name__ == "__main__":
424
+ main()