@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,21 @@
1
+ import type { ScriptContract } from '@wildshard/format/scriptContract';
2
+ import { assetCost as cost, assetOverdraw as raster, parseAudio as audio, parseGlb as glb, prepareAssetDecoders, type AssetCost as Cost } from '@wildshard/format/product';
3
+ import { parseKtx2 as ktx2 } from '@wildshard/format/ktx2Cost';
4
+
5
+ // Author-only facade: keep synchronous cost APIs ready without suspending app modules.
6
+ await prepareAssetDecoders();
7
+
8
+ /** Actual parsed residency and draw costs, independent of author declarations. */
9
+ export type AssetCost = Cost;
10
+ /** Admit a self-contained GLB and derive its geometry and instance costs. */
11
+ export function parseGlb(bytes: Uint8Array): Cost { return glb(bytes); }
12
+ /** Admit bounded KTX2 mip ranges and conservative transcode residency. */
13
+ export function parseKtx2(bytes: Uint8Array): Cost { return ktx2(bytes); }
14
+ /** Admit bounded PCM WAV or indexed 48 kHz stereo AAC-LC and derive decoded sample residency. */
15
+ export function parseAudio(bytes: Uint8Array): Cost { return audio(bytes); }
16
+ /** Select the game's shared asset parser for CLI and browser admission. */
17
+ export function assetCost(kind: string, bytes: Uint8Array, script?: ScriptContract): Cost { return cost(kind, bytes, script); }
18
+ /** Advisory raster layers from actual geometry and material alpha modes, before culling or occlusion. */
19
+ export type OverdrawEstimate = ReturnType<typeof raster>;
20
+ /** Derive the shared conservative raster estimate without accepting an author-supplied number. */
21
+ export function assetOverdraw(kind: string, bytes: Uint8Array, script?: ScriptContract): OverdrawEstimate { return raster(kind, bytes, script); }
@@ -0,0 +1,9 @@
1
+ import * as v from 'valibot';
2
+ import { AudioDataSchema as schema, parseAudioData as parseData, type AudioData as Data } from '@wildshard/format/audio';
3
+
4
+ /** Compile cue mappings, wind ambience and silent/default score declarations. */
5
+ export const AudioDataSchema: v.SchemaWithPipe<readonly [typeof schema]> = v.pipe(schema);
6
+ /** A serialisable audio recipe whose voice ids the platform catalogue admits. */
7
+ export type AudioData = Data;
8
+ /** Validate the thin audio section before compiling a shardfile. */
9
+ export function parseAudioData(input: unknown): Data { return parseData(input); }
@@ -0,0 +1,211 @@
1
+ // oxlint-disable-next-line import/no-nodejs-modules -- The build runs the host's ffmpeg to encode recordings.
2
+ import { execFile } from 'node:child_process';
3
+ // oxlint-disable-next-line import/no-nodejs-modules -- The build host keys encoded recordings by exact content.
4
+ import { createHash, randomBytes } from 'node:crypto';
5
+ // oxlint-disable-next-line import/no-nodejs-modules -- The encode cache lives outside the authored product.
6
+ import { existsSync, mkdirSync, mkdtempSync, readFileSync, renameSync, rmSync, writeFileSync } from 'node:fs';
7
+ // oxlint-disable-next-line import/no-nodejs-modules -- The default cache is the existing build-cache root.
8
+ import { availableParallelism, homedir, release, tmpdir } from 'node:os';
9
+ // oxlint-disable-next-line import/no-nodejs-modules -- Cache paths use only trusted roots and hashes.
10
+ import { join, resolve } from 'node:path';
11
+ // oxlint-disable-next-line import/no-nodejs-modules -- execFile's promise form.
12
+ import { promisify } from 'node:util';
13
+ import * as v from 'valibot';
14
+ import { measureRecording } from '@wildshard/format/audioMeasure';
15
+ import { AUDIO_RULES, audioReport } from '@wildshard/format/audioRules';
16
+
17
+ // AUDIO AU7 (meta docs/plans/AUDIO-PLAN.md, J299): the build re-encodes every source recording a shard mounts (wav,
18
+ // flac, aiff or m4a under /assets/music or /assets/sfx) to AU5's targets: AAC-LC 48 kHz in .m4a at the bitrate cap
19
+ // for its role and channels (format's AUDIO_RULES). AudioToolbox `aac_at` on macOS, ffmpeg's `aac` elsewhere. Sound
20
+ // effects go mono unless the shard source marks them stereo (`audio-stereo.json`); music keeps its channels. An AAC
21
+ // file that already passes AU5's per-file check at the right channel count ships as it is, so no file is encoded
22
+ // twice. Every recording keeps its URL (a `.wav` mount serves AAC bytes), because the shard's rows, fence list and
23
+ // code name that URL. Encoded bytes are cached by source hash, role, channel mark, AU5's rules, this encoder's code
24
+ // and the host encoder's identity (ffmpeg version, encoder, platform, and the macOS release for AudioToolbox), so a
25
+ // rebuild encodes nothing and a different encoder never reads another's bytes. AudioToolbox's stereo floor is 64
26
+ // kbps, so a stereo sound effect (48 kbps) takes ffmpeg's `aac` on every host. The 180 s rule is AU5's report's to
27
+ // judge (a waiver may cover it), so the encoder ignores it.
28
+
29
+ /** Which encoder the build found, and the identity its cache key carries. */
30
+ export interface AudioEncoder {
31
+ readonly ffmpeg: string;
32
+ readonly ffprobe: string;
33
+ readonly codec: 'aac_at' | 'aac';
34
+ readonly identity: string;
35
+ }
36
+
37
+ /** What one encode pass did, for the build's log line. */
38
+ export interface AudioEncodeStats {
39
+ readonly files: number;
40
+ readonly encoded: number;
41
+ readonly cached: number;
42
+ readonly kept: number;
43
+ readonly unencoded: number;
44
+ readonly before: number;
45
+ readonly after: number;
46
+ }
47
+
48
+ export interface AudioEncodeOptions {
49
+ /** Sound-effect URLs the source marks stereo (`audio-stereo.json`). */
50
+ readonly stereo?: ReadonlySet<string>;
51
+ readonly cacheRoot?: string;
52
+ /** `null` is no encoder on this host; undefined finds one. */
53
+ readonly encoder?: AudioEncoder | null;
54
+ }
55
+
56
+ interface Mount { readonly url: string; readonly bytes: Uint8Array }
57
+ type Role = 'music' | 'sfx';
58
+
59
+ const SOURCE = /^\/assets\/(?<role>music|sfx)\/.+\.(?<ext>m4a|wav|flac|aiff?)$/u;
60
+ const SCHEMA = 'audio-encode/1';
61
+ const MAX_BYTES = 256_000_000;
62
+ const MB = 1_000_000;
63
+ const AAC_AT_STEREO_FLOOR = 64;
64
+ const RATE_STEP = 8;
65
+ const execFileAsync = promisify(execFile);
66
+ async function run(file: string, args: readonly string[]): Promise<string> {
67
+ try { return (await execFileAsync(file, [...args], { maxBuffer: 4_000_000 })).stdout; }
68
+ catch (error) {
69
+ const stderr = typeof error === 'object' && error !== null && 'stderr' in error ? String(error.stderr).trim().split('\n').slice(-2).join(' ') : '';
70
+ throw new Error(`${file} ${args.slice(0, 2).join(' ')}: ${stderr === '' ? String(error) : stderr}`, { cause: error });
71
+ }
72
+ }
73
+ const sha = (bytes: string | Uint8Array): string => createHash('sha256').update(bytes).digest('hex');
74
+
75
+ /** Whether a mount URL is a source recording the build encodes. */
76
+ export function isSourceRecordingUrl(url: string): boolean { return SOURCE.test(url); }
77
+
78
+
79
+ let found: Promise<AudioEncoder | null> | undefined;
80
+ /** The host's encoder: `aac_at` when ffmpeg on macOS has it, else ffmpeg's `aac`; null with no ffmpeg on PATH. */
81
+ export function findAudioEncoder(): Promise<AudioEncoder | null> {
82
+ found ??= (async () => {
83
+ const ffmpeg = process.env['WILDSHARD_FFMPEG'] ?? 'ffmpeg', ffprobe = process.env['WILDSHARD_FFPROBE'] ?? 'ffprobe';
84
+ try {
85
+ const version = (await run(ffmpeg, ['-hide_banner', '-version'])).split('\n')[0]?.trim() ?? '';
86
+ await run(ffprobe, ['-hide_banner', '-version']);
87
+ const toolbox = process.platform === 'darwin' && /\baac_at\b/u.test(await run(ffmpeg, ['-hide_banner', '-encoders']));
88
+ const codec = toolbox ? 'aac_at' : 'aac';
89
+ return { ffmpeg, ffprobe, codec, identity: `${version} ${codec} ${process.platform}-${process.arch}${toolbox ? ` ${release()}` : ''}` };
90
+ } catch { return null; }
91
+ })();
92
+ return found;
93
+ }
94
+
95
+ const StereoSchema = v.strictObject({ version: v.literal(1), stereo: v.array(v.pipe(v.string(), v.regex(/^\/assets\/sfx\/.+\.(?:m4a|wav|flac|aiff?)$/u, 'audio-stereo.json names sound effects under /assets/sfx/'))) });
96
+ /** The sound effects a shard source marks stereo: `audio-stereo.json` beside `mounts.json`, if any. */
97
+ export function readStereoMarks(project: string): ReadonlySet<string> {
98
+ const file = resolve(project, 'audio-stereo.json');
99
+ return existsSync(file) ? new Set(v.parse(StereoSchema, JSON.parse(readFileSync(file, 'utf8'))).stereo) : new Set();
100
+ }
101
+
102
+ /** AU5's per-file findings the encoder answers for: format and bitrate, not the shard's budget or the 180 s rule. */
103
+ function missedTargets(row: Parameters<typeof audioReport>[0][number]): ReturnType<typeof audioReport>['findings'] {
104
+ return audioReport([row], { slug: '', waiver: undefined, today: '' }).findings.filter(finding => finding.rule === 'format' || finding.rule === 'bitrate');
105
+ }
106
+
107
+ /** Whether AAC bytes already meet AU5 at the channel count the build would pick, so encoding them again only loses. */
108
+ function alreadyAtTarget(url: string, bytes: Uint8Array, role: Role, stereo: boolean): boolean {
109
+ const row = measureRecording(url, sha(bytes), bytes);
110
+ if (row.codec !== 'aac' || row.reason !== undefined) return false;
111
+ if (role === 'sfx' && !stereo && row.channels !== 1) return false;
112
+ return missedTargets(row).length === 0;
113
+ }
114
+
115
+ function readCache(root: string, key: string): Uint8Array | undefined {
116
+ try {
117
+ const meta: unknown = JSON.parse(readFileSync(resolve(root, `${key}.json`), 'utf8'));
118
+ if (typeof meta !== 'object' || meta === null || !('key' in meta) || meta.key !== key || !('hash' in meta)) return undefined;
119
+ const bytes = readFileSync(resolve(root, `${key}.m4a`));
120
+ return sha(bytes) === meta.hash ? new Uint8Array(bytes) : undefined;
121
+ } catch { return undefined; }
122
+ }
123
+
124
+ function writeCache(root: string, key: string, bytes: Uint8Array): void {
125
+ const suffix = `.${process.pid}.${randomBytes(8).toString('hex')}.tmp`, body = resolve(root, `${key}.m4a`), meta = resolve(root, `${key}.json`);
126
+ try {
127
+ writeFileSync(body + suffix, bytes, { flag: 'wx' }); renameSync(body + suffix, body);
128
+ writeFileSync(meta + suffix, JSON.stringify({ key, hash: sha(bytes) }), { flag: 'wx' }); renameSync(meta + suffix, meta);
129
+ } catch { /* Storage availability does not change the build. */ }
130
+ finally { for (const file of [body + suffix, meta + suffix]) rmSync(file, { force: true }); }
131
+ }
132
+
133
+ /** A private work folder under the cache root, or under the system's temporary folder when the cache is not writable. */
134
+ function workFolder(root: string): string {
135
+ try { const work = resolve(root, `work-${process.pid}-${randomBytes(8).toString('hex')}`); mkdirSync(work, { recursive: true }); return work; }
136
+ catch { return mkdtempSync(join(tmpdir(), 'wildshard-audio-')); }
137
+ }
138
+
139
+ /** Encode one source with ffmpeg in a private work folder; the output must pass AU5's index, format and bitrate. */
140
+ async function encode(encoder: AudioEncoder, root: string, url: string, bytes: Uint8Array, role: Role, stereo: boolean): Promise<Uint8Array> {
141
+ const work = workFolder(root), ext = SOURCE.exec(url)?.groups?.['ext'] ?? 'bin';
142
+ try {
143
+ const input = resolve(work, `in.${ext}`), output = resolve(work, 'out.m4a');
144
+ writeFileSync(input, bytes);
145
+ const probed = Number((await run(encoder.ffprobe, ['-v', 'error', '-select_streams', 'a:0', '-show_entries', 'stream=channels', '-of', 'csv=p=0', input])).trim());
146
+ if (!Number.isInteger(probed) || probed < 1) throw new Error(`${url}: no audio stream to encode`);
147
+ const channels = probed === 1 || (role === 'sfx' && !stereo) ? 1 : 2;
148
+ const kbps = AUDIO_RULES.kbps[role][channels === 1 ? 'mono' : 'stereo'];
149
+ // AudioToolbox's CBR raises stereo under 64 kbps to 64 kbps, past a stereo sound effect's cap: ffmpeg's `aac` takes those.
150
+ const codec = encoder.codec === 'aac_at' && (channels === 1 || kbps >= AAC_AT_STEREO_FLOOR) ? 'aac_at' : 'aac';
151
+ const mode = codec === 'aac_at' ? ['-aac_at_mode', 'cbr', '-aac_at_quality', '0'] : [];
152
+ // A clip of a few frames overshoots its rate (priming and the last frame weigh more): step down 8 kbps, twice at most.
153
+ let missed = '';
154
+ for (const rate of [kbps, kbps - RATE_STEP, kbps - 2 * RATE_STEP]) {
155
+ await run(encoder.ffmpeg, ['-hide_banner', '-loglevel', 'error', '-nostdin', '-y', '-i', input, '-map', '0:a:0', '-map_metadata', '-1',
156
+ '-map_chapters', '-1', '-vn', '-c:a', codec, ...mode, '-b:a', `${rate}k`, '-ac', String(channels), '-ar', String(AUDIO_RULES.sampleRate),
157
+ '-fflags', '+bitexact', '-flags:a', '+bitexact', '-f', 'mp4', output]);
158
+ const encoded = new Uint8Array(readFileSync(output)), row = measureRecording(url.replace(/\.[a-z0-9]+$/u, '.m4a'), sha(encoded), encoded);
159
+ if (row.codec !== 'aac' || row.reason !== undefined) throw new Error(`${url}: ${codec} wrote AAC the playback index refuses (${row.reason ?? row.codec})`);
160
+ const findings = missedTargets(row);
161
+ if (findings.length === 0) return encoded;
162
+ missed = findings.map(finding => finding.message).join('; ');
163
+ if (findings.some(finding => finding.rule !== 'bitrate')) break;
164
+ }
165
+ throw new Error(`${url}: ${codec} missed AU5's target: ${missed}`);
166
+ } finally { rmSync(work, { recursive: true, force: true }); }
167
+ }
168
+
169
+ /** The encode steps' own code: a change to its arguments or rate ladder is a new cache key without a schema bump. */
170
+ const IMPLEMENTATION = sha(`${encode.toString()}\0${missedTargets.toString()}`);
171
+
172
+ /** Re-encode a shard's source recordings among its mounts, each at its own URL; every other mount passes through untouched. */
173
+ export async function encodeMountAudio(mounts: readonly Mount[], options: AudioEncodeOptions = {}): Promise<{ readonly mounts: Mount[]; readonly stats: AudioEncodeStats; readonly encoder: AudioEncoder | null }> {
174
+ const sources = mounts.filter(mount => isSourceRecordingUrl(mount.url));
175
+ const stats = { files: sources.length, encoded: 0, cached: 0, kept: 0, unencoded: 0, before: 0, after: 0 };
176
+ if (sources.length === 0) return { mounts: [...mounts], stats, encoder: null };
177
+ const encoder = options.encoder === undefined ? await findAudioEncoder() : options.encoder;
178
+ const root = options.cacheRoot ?? process.env['WILDSHARD_AUDIO_CACHE'] ?? resolve(homedir(), '.cache/wildshard/gen/audio-encode/1');
179
+ if (encoder !== null) try { mkdirSync(root, { recursive: true }); } catch { /* The cache is optional; encode still runs. */ }
180
+ const out = new Map<string, Uint8Array>();
181
+ const one = async ({ url, bytes }: Mount): Promise<void> => {
182
+ if (bytes.byteLength > MAX_BYTES) throw new Error(`audio: ${url} is over ${MAX_BYTES / MB} MB`);
183
+ const role: Role = SOURCE.exec(url)?.groups?.['role'] === 'music' ? 'music' : 'sfx', stereo = options.stereo?.has(url) === true;
184
+ stats.before += bytes.byteLength;
185
+ let result: Uint8Array;
186
+ if (url.endsWith('.m4a') && alreadyAtTarget(url, bytes, role, stereo)) { result = bytes; stats.kept++; }
187
+ else if (encoder === null) { result = bytes; stats.unencoded++; }
188
+ else {
189
+ const key = sha(JSON.stringify({ schema: SCHEMA, encoder: encoder.identity, rules: AUDIO_RULES, code: IMPLEMENTATION, role, stereo, source: sha(bytes) }));
190
+ const hit = readCache(root, key);
191
+ if (hit === undefined) { result = await encode(encoder, root, url, bytes, role, stereo); writeCache(root, key, result); stats.encoded++; }
192
+ else { result = hit; stats.cached++; }
193
+ }
194
+ stats.after += result.byteLength;
195
+ out.set(url, result);
196
+ };
197
+ // One failure stops the other workers taking new files.
198
+ const queue = [...sources], workers = Math.max(1, Math.min(4, availableParallelism()));
199
+ await Promise.all(Array.from({ length: workers }, async () => {
200
+ try { for (let next = queue.shift(); next !== undefined; next = queue.shift()) await one(next); }
201
+ catch (error) { queue.length = 0; throw error; }
202
+ }));
203
+ return { mounts: mounts.map(mount => { const bytes = out.get(mount.url); return bytes === undefined ? mount : { url: mount.url, bytes }; }), stats, encoder };
204
+ }
205
+
206
+ /** The build's audio line: before and after MB, and what each recording took. */
207
+ export function audioEncodeLine(slug: string, stats: AudioEncodeStats, encoder: AudioEncoder | null): string {
208
+ const mb = (bytes: number): string => `${(bytes / MB).toFixed(2)} MB`;
209
+ const how = [`${stats.encoded} encoded`, `${stats.cached} from cache`, `${stats.kept} already at target`, ...stats.unencoded > 0 ? [`${stats.unencoded} not encoded: no ffmpeg on PATH`] : []];
210
+ return `audio: ${slug} ${stats.files} recordings, ${mb(stats.before)} before, ${mb(stats.after)} after (${how.join(', ')}${encoder === null ? '' : `; ${encoder.codec}`})`;
211
+ }
@@ -0,0 +1,3 @@
1
+ // Engine's, coverage row 6: one copy, and this repo keeps the name.
2
+ // oxlint-disable-next-line wildshard/no-reexport, oxc/no-barrel-file -- Authors import this name, and engine owns the bytes.
3
+ export * from '@wildshard/engine/host/author';
@@ -0,0 +1,28 @@
1
+ /** A schema's refusal says what was wrong, and only its path says where. Plain shapes: a bundle's valibot isn't ours. */
2
+ interface PathStep {readonly key?: unknown}
3
+ interface Refusal {readonly message: string; readonly path?: readonly PathStep[]}
4
+
5
+ const MAX_SHOWN = 5;
6
+ const isRefusal = (value: unknown): value is Refusal => typeof value === 'object' && value !== null && 'message' in value;
7
+ function refusalsOf(error: unknown): readonly Refusal[] | undefined {
8
+ if (typeof error !== 'object' || error === null || !('issues' in error) || !Array.isArray(error.issues)) return undefined;
9
+ const issues: readonly unknown[] = error.issues;
10
+ return issues.filter(isRefusal);
11
+ }
12
+ function located(issue: Refusal): string {
13
+ const path = (issue.path ?? []).map(step => (typeof step.key === 'number' ? `[${step.key}]` : `.${String(step.key)}`)).join('').replace(/^\./u, '');
14
+ return path === '' ? issue.message : `${path}: ${issue.message}`;
15
+ }
16
+
17
+ /** An author-facing line: each refused field with its path, or the error's own words. */
18
+ export function authorErrorText(error: unknown): string {
19
+ const issues = refusalsOf(error);
20
+ if (issues === undefined) return error instanceof Error ? error.message : String(error);
21
+ const shown = issues.slice(0, MAX_SHOWN).map(issue => located(issue)), more = issues.length - shown.length;
22
+ return `${shown.join('; ')}${more > 0 ? `; and ${more} more` : ''}`;
23
+ }
24
+
25
+ /** The same error with its fields located, or the error itself if nothing was refused by a schema. */
26
+ export function locatedError(error: unknown, prefix = ''): unknown {
27
+ return refusalsOf(error) === undefined ? error : new Error(`${prefix}${authorErrorText(error)}`, { cause: error });
28
+ }
@@ -0,0 +1,39 @@
1
+ import type { Shardfile } from '@wildshard/format/shardSchema';
2
+
3
+ /** C3: what a page needs before it admits a shard, for an author who wrote no level metadata: `withDiscovery` writes this
4
+ * as the product's discovery, so the shard wears its own card and enters on its own page, with no first-party manifest
5
+ * source. Every value is the platform's plain default or the shard's own; a shard's `manifest` replaces all of it. */
6
+ const NEUTRAL = [1, 1, 1];
7
+ const PHONE = {fps: 30, variability: 1.3, cpuMs: 9.6, gcMs: 0.3, systems: {physics: 0.3, ai: 0.3, animation: 0.3, player: 0.2, world: 0.2, hud: 0.1, audio: 0.1},
8
+ vertexShare: 0.5, lanes: {opaque: 0.4, shadow: 0.2, transparent: 0.1, viewmodel: 0.1, post: 0.1, reserve: 0.1}, linkMs: 1000};
9
+ /** Frame budgets a boot reports against: the platform's defaults, the same rows `_template` declares. */
10
+ export const AUTHOR_BUDGETS: Readonly<Record<'phone' | 'desktop', Readonly<Record<string, unknown>>>> = {phone: PHONE, desktop: {...PHONE, fps: 60, cpuMs: 4.8}};
11
+ /** The name those rows go by in the manifest: no author file, so `withDiscovery` answers it. */
12
+ export const AUTHOR_BUDGETS_MODULE = './data/author-budgets.json';
13
+
14
+ /** A card from the shard's name and seed, so two authors' shards differ on the title with no art of their own. */
15
+ export function authorCard(name: string, seed: number): string {
16
+ const hue = Math.abs(seed * 47) % 360, label = name.replaceAll(/[^\p{L}\p{N} .'-]/gu, '').slice(0, 24);
17
+ const svg = `<svg xmlns="http://www.w3.org/2000/svg" width="390" height="844"><rect width="390" height="844" fill="hsl(${hue} 30% 28%)"/><path d="M0 600l130-90 110 60 150-110v384H0z" fill="hsl(${hue} 30% 18%)"/><text x="195" y="420" fill="#fff" font-family="sans-serif" font-size="30" text-anchor="middle">${label}</text></svg>`;
18
+ return `data:image/svg+xml,${encodeURIComponent(svg)}`;
19
+ }
20
+
21
+ export function authorManifest(shard: Shardfile): unknown {
22
+ const {slug, name, seed} = shard.identity, art = authorCard(name, seed), {spawn} = shard;
23
+ return {
24
+ api: 1, hoverSpeedClass: 'road', slug, order: 1000, status: 'live', name, label: '(+0, +0)', seed, biome: `By ${shard.identity.author}`, blurb: name,
25
+ card: {thumb: art, portrait: art, landscape: art}, style: 'greybox', kitLook: 'toon', hands: 'toon', weapon: 'custom', treeCount: 0,
26
+ trees: {factory: 'none', noun: 'trees'}, minimap: {image: art}, pois: [], assetGlobs: [], spawn,
27
+ bounds: {x0: -250, x1: 250, z0: -250, z1: 250, floor: -10},
28
+ sky: {sunColor: NEUTRAL, sunIntensity: 1.5, envIntensity: 0.5, bgIntensity: 1, fogSunColor: NEUTRAL, cloudSunColor: NEUTRAL, hemiSky: 10266548, hemiGround: 6316128, hemiIntensity: 0.7, sun: {azimuth: 35, elevation: 45}},
29
+ atmosphere: {fogHeight: -20, fogHeightFalloff: 0, fogHeightDensity: 0, fogDistDensity: 0, volumetricSunColor: NEUTRAL},
30
+ grade: {saturation: 0, brightness: 0, contrast: 0, bloomIntensity: 0, bloomThreshold: 1, shadowTint: NEUTRAL, highTint: NEUTRAL, lift: [0, 0, 0], gain: NEUTRAL, gamma: 1},
31
+ explore: {art: {world: art, models: art, sets: art, practice: art}},
32
+ shardfile: `/shardfiles/${slug}/shard.json`, ground: {paths: 'plugin', structures: true}, uses: ['weather', 'dayCycle'],
33
+ species: [], fight: {attackers: 2, telegraphed: true, input: {bufferMs: 120, coyoteMs: 100}},
34
+ creatures: {lowPoly: true, waitForModels: false, furRim: false, tintRange: 0, oneMaterial: true},
35
+ tiers: {phone: {godRays: false, ao: false}, desktop: {godRays: false, ao: false}},
36
+ loot: {coins: true}, hud: {bands: ['band.1', 'band.2', 'band.3']}, spawns: [], audio: {ambience: 'none', score: 'none'},
37
+ bindings: {accent: shard.accent, budgets: {module: AUTHOR_BUDGETS_MODULE, export: 'default'}},
38
+ };
39
+ }
@@ -0,0 +1,19 @@
1
+ import * as THREE from 'three';
2
+
3
+ /** Authored horizontal annulus with native vertex, UV and triangle order. */
4
+ export function annulus(inner: number, outer: number, seg: number, arc: number = Math.PI * 2): THREE.BufferGeometry {
5
+ const pos: number[] = [], uv: number[] = [], nrm: number[] = [], idx: number[] = [];
6
+ for (let i = 0; i <= seg; i++) {
7
+ const a = (i / seg) * arc, c = Math.cos(a), s = Math.sin(a);
8
+ pos.push(c * inner, 0, -s * inner, c * outer, 0, -s * outer);
9
+ uv.push(i / seg, 0, i / seg, 1);
10
+ nrm.push(0, 1, 0, 0, 1, 0);
11
+ if (i < seg) { const k = i * 2; idx.push(k, k + 1, k + 2, k + 1, k + 3, k + 2); }
12
+ }
13
+ const g = new THREE.BufferGeometry();
14
+ g.setAttribute('position', new THREE.Float32BufferAttribute(pos, 3));
15
+ g.setAttribute('normal', new THREE.Float32BufferAttribute(nrm, 3));
16
+ g.setAttribute('uv', new THREE.Float32BufferAttribute(uv, 2));
17
+ g.setIndex(idx);
18
+ return g;
19
+ }
@@ -0,0 +1,76 @@
1
+ // oxlint-disable-next-line import/no-nodejs-modules -- Optional compiler storage is owned only by the trusted build host.
2
+ import { mkdirSync, renameSync, rmSync, writeFileSync } from 'node:fs';
3
+ // oxlint-disable-next-line import/no-nodejs-modules -- Unique temporary names never enter the compiler key.
4
+ import { randomBytes } from 'node:crypto';
5
+ // oxlint-disable-next-line import/no-nodejs-modules -- Reuse the existing CI-cached generation root.
6
+ import { homedir } from 'node:os';
7
+ // oxlint-disable-next-line import/no-nodejs-modules -- Construct paths from trusted roots and content hashes.
8
+ import { resolve } from 'node:path';
9
+ import { reportBuildCache } from '../buildCacheMetrics';
10
+ import { projectCompilerIdentity, rawAssemblyScriptCompilerIdentity } from '../projectCompilerIdentity';
11
+ import { encodeCanonicalJson, hashImmutableBytes } from '../immutable';
12
+ import { readBoundedFile } from '../sourceReader';
13
+ import type { AssemblyScriptMemo } from './assemblyscriptMemoPort';
14
+
15
+ const text = new TextEncoder(), maximum = 16_000_000;
16
+
17
+ /** Preserve the original raw AssemblyScript output for exact source/flags/compiler inputs.
18
+ * This host-only optional cache never stores source admission, instrumentation or executable verdicts. */
19
+ export const memoAssemblyScript: AssemblyScriptMemo = async (args, sources, generate) => {
20
+ const files = [...sources];
21
+ // Unusually large direct tool callers retain their original uncached path.
22
+ if (args.length > 64 || files.length > 65 || files.reduce((sum, [, value]) => sum + text.encode(value).byteLength, 0) > maximum)
23
+ { reportBuildCache({cache:'assemblyscript-raw',event:'bypass',bytes:0}); return generate(); }
24
+ // Preserve the original full compiler/source guard even on a raw-key hit.
25
+ const fullCompiler = await projectCompilerIdentity();
26
+ const compiler = await rawAssemblyScriptCompilerIdentity();
27
+ const inputs = { node: process.version, platform: process.platform, arch: process.arch, args: [...args], sources: files };
28
+ const keyOf = (version: number, identity: string): string => hashImmutableBytes(text.encode(encodeCanonicalJson({ version, compiler: identity, ...inputs })));
29
+ const key = keyOf(2, compiler);
30
+ // The directory and metadata format stay unchanged; both key generations remain valid.
31
+ const root = process.env['WILDSHARD_AS_RAW_CACHE'] ?? resolve(homedir(), '.cache/wildshard/gen/as-raw/1');
32
+ reportBuildCache({cache:'assemblyscript-raw',event:'lookup',bytes:0});
33
+ const read = (candidate: string): Uint8Array | undefined => {
34
+ const body = resolve(root, `${candidate}.wasm`), meta = resolve(root, `${candidate}.json`);
35
+ try {
36
+ const saved: unknown = JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(readBoundedFile(meta, 1000)));
37
+ if (typeof saved === 'object' && saved !== null && 'key' in saved && saved.key === candidate
38
+ && 'hash' in saved && typeof saved.hash === 'string' && /^[a-f0-9]{64}$/u.test(saved.hash)
39
+ && 'bytes' in saved && typeof saved.bytes === 'number' && Number.isSafeInteger(saved.bytes) && saved.bytes > 0 && saved.bytes <= maximum) {
40
+ const bytes = readBoundedFile(body, saved.bytes);
41
+ if (bytes.byteLength === saved.bytes && hashImmutableBytes(bytes) === saved.hash) {
42
+ return Uint8Array.from(bytes);
43
+ }
44
+ }
45
+ } catch { /* An absent or damaged memo recompiles, without changing caller admission. */ }
46
+ return undefined;
47
+ };
48
+ const current = read(key);
49
+ if (current !== undefined) {
50
+ reportBuildCache({cache:'assemblyscript-raw',event:'disk-hit',bytes:current.byteLength}); return current;
51
+ }
52
+ // An exact old full-compiler key is stronger than this raw-only identity.
53
+ // Validate its original body/hash before promoting; unrelated or damaged old entries miss.
54
+ const legacy = read(keyOf(1, fullCompiler));
55
+ let bytes: Uint8Array;
56
+ if (legacy !== undefined) {
57
+ bytes = legacy; reportBuildCache({cache:'assemblyscript-raw',event:'disk-hit',bytes:bytes.byteLength});
58
+ } else {
59
+ reportBuildCache({cache:'assemblyscript-raw',event:'miss',bytes:0});
60
+ bytes = Uint8Array.from(await generate());
61
+ reportBuildCache({cache:'assemblyscript-raw',event:'computed',bytes:bytes.byteLength});
62
+ }
63
+ if (bytes.byteLength === 0 || bytes.byteLength > maximum) return bytes;
64
+ const body = resolve(root, `${key}.wasm`), meta = resolve(root, `${key}.json`);
65
+ let populated=false;
66
+ const suffix = `.${process.pid}.${randomBytes(8).toString('hex')}.tmp`;
67
+ try {
68
+ mkdirSync(root, { recursive: true });
69
+ writeFileSync(body + suffix, bytes, { flag: 'wx' }); renameSync(body + suffix, body);
70
+ writeFileSync(meta + suffix, JSON.stringify({ key, bytes: bytes.byteLength, hash: hashImmutableBytes(bytes) }), { flag: 'wx' });
71
+ renameSync(meta + suffix, meta); populated=true;
72
+ } catch { /* Optional storage cannot change the compiler result. */ }
73
+ finally { for (const file of [body + suffix, meta + suffix]) try { rmSync(file, { force: true }); } catch { /* Own temporary only. */ } }
74
+ reportBuildCache({cache:'assemblyscript-raw',event:populated?'population':'write-failure',bytes:populated?bytes.byteLength:0});
75
+ return bytes;
76
+ };
@@ -0,0 +1,4 @@
1
+ /** A build-host cache of only the raw compiler output. All executable admission stays with the caller. */
2
+ export type AssemblyScriptMemo = (
3
+ args: readonly string[], sources: ReadonlyMap<string, string>, generate: () => Promise<Uint8Array>
4
+ ) => Promise<Uint8Array>;