@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,337 @@
1
+ import { diagnosticNow } from '@wildshard/engine/core/clock';
2
+ import { executeBundle } from './executeBundle';
3
+ import { generationRecipes } from './generationRecipe.ts';
4
+ import { mergeProjectSections } from './projectSections';
5
+ import { writeEmptyShardSource } from './newProject';
6
+ import { shardOutputRoot } from './shardSource';
7
+ import { assertConfigBoundary } from './configBoundary';
8
+ import { createProjectGeneration, finishProjectGeneration, isProjectGenerator, type ProjectGenerationContext, type ProjectGenerationInputRoot } from './projectGeneration';
9
+ // oxlint-disable-next-line import/no-nodejs-modules -- The author CLI verifies and writes local build products.
10
+ import { cpSync, existsSync, readFileSync, realpathSync, writeFileSync } from 'node:fs';
11
+ // oxlint-disable-next-line import/no-nodejs-modules -- Resolve source assets inside the author project.
12
+ import { resolve, sep } from 'node:path';
13
+ // oxlint-disable-next-line import/no-nodejs-modules -- Build phase diagnostics belong only to the CI compiler process.
14
+ import process from 'node:process';
15
+ import { build } from 'vite';
16
+ import ts from '@typescript/typescript6';
17
+ import { parseShardfile, type Shardfile } from '@wildshard/engine/host/shardfile';
18
+ import { preflightAssetGraph, offlineMemoryAdmission, prepareAssetDecoders } from "@wildshard/format/product";
19
+ import { preflightDeclaredCosts } from '@wildshard/format/assetAdmission';
20
+ import { preflightShardfile } from '@wildshard/format/preflight';
21
+
22
+ import { readBoundedFile } from './sourceReader';
23
+ import { encodeCanonicalJson, hashImmutableBytes } from './immutable';
24
+ import { withAssetOwner } from './assetScope';
25
+ import { hashAssetBytes } from './assetHandle';
26
+
27
+ import { projectPerformancePolicy } from './performancePolicy';
28
+ import { checkProjectRuntime } from './runtimePerformance';
29
+ import { admitProduct, assertBuildSides, assertProductTargets, namedJsonReader, SIDE_SECTIONS } from './productOutput';
30
+ import { bakeAuthoredWorld } from './bake/authoredWorld';
31
+ import { parseWorldSource } from './worldSource';
32
+ import { compileBehaviourSource } from './behaviourSource';
33
+ import { buildBehaviourProject } from './buildBehaviour';
34
+ import { packProjectMap, generatedProjectMap, type ProjectMap } from './projectMap';
35
+ import { projectPlaceholders } from './bake/placeholders';
36
+ import type { ScriptAdmissionRows } from '@wildshard/format/scriptContract';
37
+ import { readCookInput, type CookInput } from './cookInput';
38
+ import { audioEncodeLine, encodeMountAudio, readStereoMarks } from './audioEncode';
39
+ import { AUTHOR_BUDGETS, AUTHOR_BUDGETS_MODULE, authorManifest } from './authorManifest';
40
+ import { discoveryDocument, discoveryUrl } from './discoveryDocument';
41
+ import { outputScriptAdmissionRows, outputPlatformPayloads, clearOutputProduct, writeOutputProduct, type OutputProductOptions } from './outputProduct';
42
+ import { prepareProjectOutput, mergeProjectBlobs, projectMirrors, type PreparedProjectOutput } from './projectOutput';
43
+ import type { RuntimeMirror } from './runtimeMirrors';
44
+ import { proveRuntimeData, writeRuntimeFiles } from './outputRuntime';
45
+ import { readManifestSource, type ProjectManifestSource } from './projectManifest';
46
+ import { projectDecisionOptions } from './projectDecisions';
47
+ import { projectDecisionBudget } from './projectPolicy';
48
+ import { nameBlob } from './blobs';
49
+ import { lowerMaterialGraphs } from './materialGraphFiles';
50
+ import { parseDiscoveryValues, type DiscoveryValues } from '@wildshard/format/discoveryValues';
51
+
52
+ /** Stable JSON encoding: sorted object keys, no timestamps or host paths. */
53
+ export function canonicalJson(value: unknown): string { return encodeCanonicalJson(value); }
54
+ /** Hash of immutable wire bytes; this is also their output filename. */
55
+ export function contentHash(bytes: Uint8Array): string { return hashImmutableBytes(bytes); }
56
+
57
+ /** Validate graph closure costs and actual bytes through the same admission used by the browser loader. */
58
+ export function validateProject(input: unknown, assets: ReadonlyMap<string, Uint8Array>, project?: string, scripts: ScriptAdmissionRows = []): Shardfile {
59
+ const source = parseShardfile(input);
60
+ return admitProduct(source, assets, projectPerformancePolicy(project, source), scripts);
61
+ }
62
+
63
+ async function authorModule(project: string, file: string): Promise<{ exports: Record<string, unknown>; hash: string; mapHash: string }> {
64
+ await prepareAssetDecoders();
65
+ // The compiled declaration executes here; only its returned data is emitted.
66
+ // Source-text inspection still enters the recorder's exact-content guard.
67
+ const result = await build({ configFile: false, logLevel: 'silent', plugins: [{name:'wildshard-author-execution',api:{wildshardInputIdentity:'execution'}}], build: { write: false, minify: false, lib: { entry: resolve(project, file), formats: ['es'], fileName: 'config' }, rolldownOptions: { external: [/^node:/u, 'assemblyscript/dist/asc.js'], output: { codeSplitting: false } } } });
68
+ const built = Array.isArray(result) ? result[0] : result;
69
+ if (built === undefined || !('output' in built) || (Array.isArray(result) && result.length !== 1)) throw new Error('config build produced unexpected output');
70
+ const chunks = built.output.filter((out) => out.type === 'chunk');
71
+ if (chunks.length !== 1) throw new Error('config must bundle as one module');
72
+ const chunk = chunks[0]; if (chunk === undefined) throw new Error('config chunk missing');
73
+ assertConfigBoundary([...chunk.imports, ...chunk.dynamicImports]);
74
+ const loaded: unknown = await executeBundle(generationRecipes(chunk.code), project);
75
+ if (typeof loaded !== 'object' || loaded === null) throw new Error('Author module has no exports');
76
+ // Bundler source-location comments change when an author moves a project.
77
+ // Parse before dropping comments so literal text remains part of identity.
78
+ const syntax = ts.createSourceFile('config.js', chunk.code, ts.ScriptTarget.Latest, true, ts.ScriptKind.JS);
79
+ const executable = ts.createPrinter({ removeComments: true, newLine: ts.NewLineKind.LineFeed }).printFile(syntax);
80
+ return { exports: Object.fromEntries(Object.entries(loaded)), hash: contentHash(new TextEncoder().encode(chunk.code)), mapHash: contentHash(new TextEncoder().encode(executable)) };
81
+ }
82
+
83
+ /** GR9: a declared output's build program (`programs` in shard.config.ts, keyed by slug), if the folder has one for it. */
84
+ function outputProgram(loaded: Record<string, unknown>, output: string): ((ctx: ProjectGenerationContext) => unknown) | undefined {
85
+ const programs = loaded['programs'];
86
+ if (programs === undefined) return undefined;
87
+ if (typeof programs !== 'object' || programs === null) throw new Error('config programs must map output slugs to build functions');
88
+ const program: unknown = Object.hasOwn(programs, output) ? Reflect.get(programs, output) : undefined;
89
+ if (program !== undefined && !isProjectGenerator(program)) throw new Error(`config program for ${output} must be a build function`);
90
+ return program;
91
+ }
92
+
93
+ /** SF88g: one declared output of a source folder that emits several products (`outputs` in shard.config.ts, keyed by slug). */
94
+ function outputDeclaration(loaded: Record<string, unknown>, output: string): unknown {
95
+ const outputs = loaded['outputs'];
96
+ if (typeof outputs !== 'object' || outputs === null || !Object.hasOwn(outputs, output)) throw new Error(`config declares no output ${output}`);
97
+ return Reflect.get(outputs, output);
98
+ }
99
+
100
+ async function projectModule(project: string, decisionLegacyLines?: number, selected?: string, mapSourceHash?: string, inputRoots: readonly ProjectGenerationInputRoot[] = []): Promise<{ map: Awaited<ReturnType<typeof generatedProjectMap>> | undefined; discovery: DiscoveryValues | undefined; shard: Shardfile; commons: unknown; baked: ReadonlyMap<string, Uint8Array>; output: PreparedProjectOutput; mirrors: readonly RuntimeMirror[] }> {
101
+ const program = await authorModule(project, 'shard.config.ts'), loaded = program.exports;
102
+ if (!('default' in loaded)) throw new Error('config has no default export');
103
+ if ('generate' in loaded && typeof loaded['generate'] !== 'function') throw new Error('config generate export must be a build function');
104
+ let declaration: unknown = selected === undefined ? loaded['generate'] ?? loaded['default'] : outputDeclaration(loaded, selected);
105
+ let shard: Shardfile;
106
+ const baked = new Map<string, Uint8Array>(), root = realpathSync(project);
107
+ const sidecarModule = existsSync(resolve(project, 'generators/output.ts')) ? await authorModule(project, 'generators/output.ts') : undefined;
108
+ // Config and sidecar share pending work. Each bundled callback carries its
109
+ // own recipe; the complete identity remains a safe fallback for dynamic calls.
110
+ const generation = createProjectGeneration(project, contentHash(new TextEncoder().encode(canonicalJson({
111
+ program: program.hash, output: selected ?? null, ...(sidecarModule === undefined ? {} : { sidecar: sidecarModule.hash }),
112
+ }))), baked, undefined, inputRoots, selected ?? 'default');
113
+ let generationSucceeded = false;
114
+ try {
115
+ let generatedOutput: unknown, map: Awaited<ReturnType<typeof generatedProjectMap>> | undefined;
116
+ let discovery: DiscoveryValues | undefined;
117
+ // GR9: a selected output's build program supplies its world GLB bytes and its map lattice
118
+ let programWorld: Uint8Array | undefined;
119
+ const outputBuild = selected === undefined ? undefined : outputProgram(loaded, selected);
120
+ if (outputBuild !== undefined) {
121
+ const result: unknown = await outputBuild(generation);
122
+ if (typeof result !== 'object' || result === null || Object.keys(result).some(key => key !== 'world' && key !== 'map')) throw new Error('Output program returns only world and map');
123
+ if ('world' in result) {
124
+ if (!(result.world instanceof Uint8Array)) throw new Error('Output program world must be GLB bytes');
125
+ programWorld = result.world;
126
+ }
127
+ if ('map' in result) map = await generatedProjectMap(result.map, mapSourceHash ?? program.mapHash);
128
+ }
129
+ if (isProjectGenerator(declaration)) {
130
+ declaration = await declaration(generation);
131
+ if (typeof declaration === 'object' && declaration !== null && 'shard' in declaration) {
132
+ if (!('output' in declaration) || Object.keys(declaration).some(key => !['shard', 'output', 'map', 'discovery'].includes(key))) throw new Error('Generated project requires shard, output and optional map/discovery');
133
+ if ('map' in declaration) map = await generatedProjectMap(declaration.map, mapSourceHash ?? program.mapHash);
134
+ if ('discovery' in declaration) discovery = parseDiscoveryValues(declaration.discovery);
135
+ generatedOutput = declaration.output;
136
+ if (generatedOutput === undefined) throw new Error('Generated project output is absent');
137
+ declaration = declaration.shard;
138
+ }
139
+ }
140
+ const sourcePath = (path: string): string => {
141
+ const resolved = realpathSync(resolve(root, path));
142
+ if (!resolved.startsWith(`${root}${sep}`)) throw new Error('Authored source resolves outside the author project'); return resolved;
143
+ };
144
+ if ('behaviour' in loaded) {
145
+ const compiled = await compileBehaviourSource(loaded['behaviour'], declaration, path => new TextDecoder('utf-8', { fatal: true }).decode(readBoundedFile(sourcePath(path), 1_000_000)));
146
+ declaration = compiled.declaration;
147
+ for (const [hash, bytes] of compiled.assets) baked.set(hash, bytes);
148
+ }
149
+ // D74: inline material graphs become content-addressed graph files of the closure before any admission reads them
150
+ const lowered = lowerMaterialGraphs(declaration);
151
+ declaration = lowered.declaration;
152
+ for (const [hash, bytes] of lowered.assets) baked.set(hash, bytes);
153
+ if (typeof declaration === 'object' && declaration !== null && 'world' in declaration) {
154
+ const world = parseWorldSource(declaration.world);
155
+ const product = await bakeAuthoredWorld(declaration, programWorld ?? readBoundedFile(sourcePath(world.glb), 256_000_000), hash => baked.get(hash));
156
+ shard = product.shard;
157
+ for (const [hash, bytes] of product.assets) baked.set(hash, bytes);
158
+ } else shard = parseShardfile(declaration);
159
+ checkProjectRuntime(project, projectPerformancePolicy(project, shard));
160
+ const sidecar = sidecarModule?.exports;
161
+ if (sidecar !== undefined && ('output' in loaded || !('output' in sidecar))) throw new Error('Output sidecar requires one unambiguous output export');
162
+ if (generatedOutput !== undefined && (sidecar !== undefined || 'output' in loaded)) throw new Error('Generated project requires one unambiguous output declaration');
163
+ let sidecarOutput = sidecar?.['output'];
164
+ const prepareOutput = sidecar?.['prepareOutput'];
165
+ if (prepareOutput !== undefined) {
166
+ if (!isProjectGenerator(prepareOutput) || sidecarModule === undefined) throw new Error('Output preparation must be a build function');
167
+ sidecarOutput = await prepareOutput(generation);
168
+ }
169
+ // GR6: an output sidecar may also build the project's map lattice (`prepareMap(ctx)` → `{ pixels, name? }`), as a
170
+ // source program returning `map` does; one producer of the map only
171
+ const prepareMap = sidecar?.['prepareMap'];
172
+ if (prepareMap !== undefined) {
173
+ if (!isProjectGenerator(prepareMap)) throw new Error('Map preparation must be a build function');
174
+ if (map !== undefined) throw new Error('Generated project declares its map twice');
175
+ map = await generatedProjectMap(await prepareMap(generation), mapSourceHash ?? program.mapHash);
176
+ }
177
+ // A sidecar may compute finite discovery data through the same explicit input context.
178
+ const prepareDiscovery = sidecar?.['prepareDiscovery'];
179
+ if (prepareDiscovery !== undefined) {
180
+ if (!isProjectGenerator(prepareDiscovery)) throw new Error('Discovery preparation must be a build function');
181
+ if (discovery !== undefined) throw new Error('Generated project declares its discovery twice');
182
+ discovery = parseDiscoveryValues(await prepareDiscovery(generation));
183
+ }
184
+ shard = mergeProjectSections(shard, sidecar?.['sections']);
185
+ const output = await prepareProjectOutput(project, generatedOutput ?? (sidecar === undefined ? loaded['output'] : sidecarOutput), { source: shard, options: projectDecisionOptions(loaded['buildOptions'], projectDecisionBudget(project, decisionLegacyLines)) });
186
+ // The CLI-only sidecar may declare the runtime/const.ts mirrors too (a browser config cannot import data/ values).
187
+ if (sidecar !== undefined && 'mirrors' in loaded && 'mirrors' in sidecar) throw new Error('Runtime mirrors declared by both the config and its output sidecar');
188
+ const mirrors = projectMirrors('mirrors' in loaded ? loaded['mirrors'] : sidecar !== undefined && 'mirrors' in sidecar ? sidecar['mirrors'] : undefined);
189
+ if (mapSourceHash !== undefined && map === undefined) throw new Error('Generated map source identity requires a generated map');
190
+ generationSucceeded = true;
191
+ return { map, discovery, shard, commons: 'commons' in loaded ? loaded['commons'] : undefined, baked, output, mirrors };
192
+ } finally { await finishProjectGeneration(generation, generationSucceeded); }
193
+ }
194
+
195
+ /** Compile authored geometry and read its remaining immutable inputs without writing hashes into the author folder. */
196
+ export async function readProjectAssets(project: string, map?: ProjectMap, manifestSource?: ProjectManifestSource, options: { decisionLegacyLines?: number; output?: string; mapSourceHash?: string } = {}): Promise<{ shard: Shardfile; assets: Map<string, Uint8Array>; output: Omit<OutputProductOptions, 'runtime'>; mirrors: readonly RuntimeMirror[] }> {
197
+ const loaded = await withAssetOwner(() => projectModule(project, options.decisionLegacyLines, options.output, options.mapSourceHash, manifestSource?.imageRoots)), pinned = new Map(pinnedCommons(loaded.commons, loaded.shard, project));
198
+ for (const [hash, bytes] of loaded.baked) pinned.set(hash, bytes);
199
+ for (const [hash, bytes] of loaded.output.assets) {
200
+ const previous = pinned.get(hash);
201
+ if (previous !== undefined && hashAssetBytes(previous) !== hashAssetBytes(bytes)) throw new Error('Output asset conflicts with baked input');
202
+ pinned.set(hash, bytes);
203
+ }
204
+ const level = manifestSource === undefined || manifestSource.file === undefined && loaded.shard.manifest === undefined ? undefined : await readManifestSource(manifestSource, loaded.shard.manifest, loaded.map?.map.bytes);
205
+ if (level !== undefined && loaded.shard.manifest !== undefined && canonicalJson(loaded.shard.manifest) !== canonicalJson(level.authored)) throw new Error('Authored manifest differs from configured level metadata');
206
+ const source = level === undefined ? loaded.shard : parseShardfile({ ...loaded.shard, manifest: level.manifest });
207
+ if (map !== undefined && loaded.map !== undefined) throw new Error('Build map and generated map cannot compete');
208
+ const selectedMap = loaded.map?.map ?? map, packed = selectedMap === undefined ? undefined : packProjectMap(source, selectedMap);
209
+ if (packed !== undefined && selectedMap !== undefined) pinned.set(packed.hash, selectedMap.bytes);
210
+ const shard = packed?.shard ?? source;
211
+ const mapBlobs = loaded.map?.name === undefined ? [] : [nameBlob(loaded.map.name, 'image', loaded.map.map.bytes)];
212
+ // Explicit authored hints retain their positions; automatic UI hints never duplicate them or commons.
213
+ const declaredLate = new Set([...(shard.late ?? []), ...(loaded.output.late ?? [])].map(row => row.hash)),
214
+ existingFiles = new Set(shard.files.map(row => row.hash)), libraryRoots = new Set(shard.library);
215
+ const late = [...loaded.output.late ?? [], ...(level?.late ?? []).filter(row => !declaredLate.has(row.hash) && !shard.requires.commons.includes(row.hash)
216
+ && (!existingFiles.has(row.hash) || libraryRoots.has(row.hash)))];
217
+ const merged = mergeProjectBlobs(shard, pinned, [...loaded.output.blobs, ...mapBlobs, ...(level?.blobs ?? [])], loaded.output.options.namedFiles, late);
218
+ return { shard: merged.shard, assets: projectAssets(project, merged.shard, 'project', merged.assets),
219
+ output: { ...loaded.output.options, namedFiles: merged.namedFiles, ...(loaded.discovery === undefined ? {} : { discovery: loaded.discovery }) }, mirrors: loaded.mirrors };
220
+ }
221
+
222
+ function pinnedCommons(input: unknown, source: Shardfile, project: string): ReadonlyMap<string, Uint8Array> | undefined {
223
+ if (input === undefined) return undefined;
224
+ preflightDeclaredCosts(source, offlineMemoryAdmission(projectPerformancePolicy(project, source)));
225
+ if (typeof input !== 'object' || input === null || !('catalogue' in input) || !('assets' in input)) throw new Error('Build-only commons export needs a compiled catalogue');
226
+ const catalogue = input.catalogue;
227
+ if (typeof catalogue !== 'object' || catalogue === null || !('format' in catalogue) || catalogue.format !== 'wildshard.commons' || !('version' in catalogue) || catalogue.version !== 0 || !(input.assets instanceof Map)) throw new Error('Unsupported build-only commons catalogue');
228
+ const assets = new Map<string, Uint8Array>();
229
+ for (const hash of source.requires.commons) {
230
+ const bytes: unknown = input.assets.get(hash);
231
+ if (!(bytes instanceof Uint8Array) || bytes.length !== source.requires.commonsWire[hash] || hashAssetBytes(bytes) !== hash) throw new Error('Pinned commons export misses or changes a required asset');
232
+ assets.set(hash, bytes);
233
+ }
234
+ return assets;
235
+ }
236
+ /** Preflight and read bounded immutable files from an author project or flat built product. */
237
+ export function projectAssets(project: string, shard: Shardfile, layout: 'project' | 'product' = 'project', pinned?: ReadonlyMap<string, Uint8Array>): Map<string, Uint8Array> {
238
+ preflightShardfile(shard); preflightAssetGraph(shard);
239
+ preflightDeclaredCosts(shard, offlineMemoryAdmission(projectPerformancePolicy(project, shard)));
240
+ assertProductTargets(shard, projectPerformancePolicy(project, shard));
241
+ const read = (hash: string, size: number, folder: string): Uint8Array => {
242
+ const bytes = pinned?.get(hash) ?? readBoundedFile(resolve(project, layout === 'project' ? folder : '.', hash), size);
243
+ if (bytes.length !== size) throw new Error('Project asset differs from its declared wire size'); return bytes;
244
+ };
245
+ return new Map([...shard.files.map((f) => [f.hash, read(f.hash, f.compressed, 'assets')] as const), ...shard.requires.commons.map((h) => [`commons:${h}`, read(h, shard.requires.commonsWire[h] ?? 0, 'commons')] as const)]);
246
+ }
247
+ /**
248
+ * Build a deterministic shard.json, immutable files and the distributed normal client when present; a shardfile with a
249
+ * terrain gains its far / near placeholders when `placeholders` is set (the CLI's default).
250
+ */
251
+ export async function buildProject(project: string, output?: string, options: { decisionLegacyLines?: number; output?: string; outputFormat?: 2; manifest?: ProjectManifestSource; copyRuntime?: boolean; devserver?: boolean; client?: string | null; map?: ProjectMap; mapSourceHash?: string; placeholders?: boolean; admit?: (shard: Shardfile, assets: ReadonlyMap<string, Uint8Array>, policy: 'warn' | 'refuse', sections: ReadonlyMap<string, unknown>) => Promise<void> } = {}): Promise<Shardfile> {
252
+ let phaseStarted = diagnosticNow();
253
+ const phase = (name: string): void => {
254
+ const now = diagnosticNow();
255
+ if (process.env['GITHUB_ACTIONS'] === 'true') console.info(`author timing: ${JSON.stringify({ pid: process.pid, phase: name, product: options.output ?? project, seconds: Number(((now - phaseStarted) / 1000).toFixed(3)) })}`);
256
+ phaseStarted = diagnosticNow();
257
+ };
258
+ await buildBehaviourProject(project); phase('behaviour-compile');
259
+ const loaded = await readProjectAssets(project, options.map, options.manifest, options), assets = loaded.assets;
260
+ phase('project-read');
261
+ // SERVER-PARITY SS8: a kind or script whose side has no half to run it refuses here, one plain line each, before any write.
262
+ assertBuildSides(outputPlatformPayloads(loaded.output.platform, SIDE_SECTIONS), namedJsonReader(loaded.output.namedFiles ?? [], assets));
263
+ // G348: a shardfile with a terrain gets its far and near placeholders from its own terrain, tiles and look (`wildshard
264
+ // build` asks for them; the first-party product builds keep theirs in the repo bake until the grid reads `near`)
265
+ // a static import: the author CLI must bundle to one module (scripts/wildshard.mjs); the bakers' closure stays
266
+ // renderer-free (the Node sim proofs import this module under the renderer-denying loader)
267
+ const shard = validateProject(options.placeholders === true ? await projectPlaceholders(loaded.shard, assets) : loaded.shard, assets, project, outputScriptAdmissionRows(loaded.output.platform));
268
+ phase('asset-admission');
269
+ // The decision rows travel with the moves they bind, so a headless admission resolves the same registries as the build.
270
+ await options.admit?.(shard, assets, projectPerformancePolicy(project, shard), outputPlatformPayloads(loaded.output.platform));
271
+ phase('simulation-admission');
272
+ const destination = output ?? resolve(shardOutputRoot(project), 'public/shardfiles', shard.identity.slug);
273
+ const clientPlan = shard.runtime !== null;
274
+ if (options.copyRuntime === true || clientPlan) {
275
+ const root = realpathSync(project), target = resolve(destination);
276
+ if (target === root || target.startsWith(`${root}${sep}`) || root.startsWith(`${target}${sep}`)) throw new Error('Runtime output must be separate from its author project');
277
+ }
278
+ clearOutputProduct(destination);
279
+ let descriptor: ReturnType<typeof writeOutputProduct>;
280
+ try {
281
+ const runtime = options.copyRuntime === true || clientPlan ? writeRuntimeFiles(project, destination) : undefined;
282
+ const cook = await withDiscovery(project, shard.manifest ?? options.manifest?.composed ?? authorManifest(shard), loaded.output.discovery, await encodedCookInput(project, shard.identity.slug), assets);
283
+ descriptor = writeOutputProduct(shard, assets, destination, { ...loaded.output, ...(runtime === undefined ? {} : { runtime }), ...(cook === undefined ? {} : { cook }) });
284
+ phase('product-write');
285
+ if (runtime !== undefined) proveRuntimeData(destination, descriptor, loaded.mirrors);
286
+ phase('runtime-proof');
287
+ } catch (error) { clearOutputProduct(destination); throw error; }
288
+ const directory = import.meta.dirname;
289
+ const clientFolder = options.devserver === true ? 'client-devserver' : 'client';
290
+ const client = options.client === null ? undefined : options.client ?? [resolve(directory, clientFolder), resolve(directory, 'dist', clientFolder)].find((path) => existsSync(resolve(path, 'index.html')));
291
+ if (client !== undefined) {
292
+ cpSync(client, destination, { recursive: true });
293
+ const json = canonicalJson(descriptor).replaceAll('<', String.raw`\u003c`);
294
+ const html = readFileSync(resolve(destination, 'index.html'), 'utf8').replace('</head>', `<script id="ws-shardfile" type="application/json">${json}</script></head>`);
295
+ writeFileSync(resolve(destination, 'index.html'), html);
296
+ }
297
+ return shard;
298
+ }
299
+ /** AUDIO AU7: the cook input with its source recordings encoded to AU5's targets, and the before and after MB printed. */
300
+ async function encodedCookInput(project: string, slug: string): Promise<CookInput | undefined> {
301
+ const input = readCookInput(project, slug);
302
+ if (input === undefined) return undefined;
303
+ const { mounts, stats, encoder } = await encodeMountAudio(input.mounts, { stereo: readStereoMarks(project) });
304
+ if (stats.files > 0) console.info(audioEncodeLine(slug, stats, encoder));
305
+ return { ...input, mounts };
306
+ }
307
+ /** C3: a manifest's bindings go with the product, so a page needs nothing compiled to enter it: the packed level manifest, an
308
+ * output's composed one, which packs no images of its own, or for an author with neither, the plain one their shard implies. */
309
+ async function withDiscovery(project: string, manifest: unknown, values: DiscoveryValues | undefined, input: CookInput | undefined, assets: ReadonlyMap<string, Uint8Array>): Promise<CookInput | undefined> {
310
+ if (typeof manifest !== 'object' || manifest === null || !('slug' in manifest) || typeof manifest.slug !== 'string' || !('bindings' in manifest)) return input;
311
+ // A manifest's slug is its product's folder (`packManifestImages`).
312
+ const folder = manifest.slug, document = await discoveryDocument(folder, manifest, values, async (module, name) => {
313
+ if (module === AUTHOR_BUDGETS_MODULE) return AUTHOR_BUDGETS;
314
+ if (name === 'css') return readFileSync(resolve(project, module), 'utf8');
315
+ if (module.endsWith('.json')) return JSON.parse(readFileSync(resolve(project, module), 'utf8')) as unknown;
316
+ return (await authorModule(project, `${module.replace(/^\.\//u, '')}.ts`)).exports[name];
317
+ });
318
+ // Rows name their images where the author keeps them. A product holding those bytes serves them; the rest ride as mounts.
319
+ const mounts = new Map<string, Uint8Array>(), art = new Map<string, number>();
320
+ const packed = JSON.stringify(document).replaceAll(/"\/(src\/shards\/[^"]+(\.[a-z]+))"/gu, (row: string, path: string, extension: string) => {
321
+ if (!/^\.(?:jpe?g|png|webp|svg|hdr)$/u.test(extension)) return row;
322
+ const bytes = readFileSync(resolve(project, '../../..', path)), hash = hashAssetBytes(bytes), held = assets.has(hash);
323
+ const url = `/shardfiles/${folder}/blobs/image/${hash}${extension}`;
324
+ if (!held) mounts.set(url, bytes);
325
+ art.set(url, bytes.length);
326
+ return `"${url}"`;
327
+ });
328
+ for (const [, url, hash] of packed.matchAll(/"(\/shardfiles\/[^/"]+\/blobs\/image\/([a-f0-9]{64})\.[a-z0-9]+)"/gu)) {
329
+ const bytes = hash === undefined ? undefined : assets.get(hash);
330
+ if (url !== undefined && bytes !== undefined) art.set(url, bytes.length);
331
+ }
332
+ return {...input, mounts: [...input?.mounts ?? [], ...[...mounts].map(([url, bytes]) => ({url, bytes})),
333
+ {url: discoveryUrl(folder), bytes: new TextEncoder().encode(`${packed.slice(0, -1)},"art":${JSON.stringify(Object.fromEntries(art))}}`)}]};
334
+ }
335
+ /** Create the runtime-free source layout without replacing existing work. */
336
+ /** A bare shard source at `project` (`wildshard new --empty` writes the same one at a new repo's `src/`). */
337
+ export function newProject(project: string, slug: string): void { writeEmptyShardSource(project, slug); }
@@ -0,0 +1,94 @@
1
+ // oxlint-disable-next-line import/no-nodejs-modules -- Compiler keys cover the installed tools' actual source bytes.
2
+ import { readdirSync, realpathSync, existsSync } from 'node:fs';
3
+ // oxlint-disable-next-line import/no-nodejs-modules -- Resolve only the pinned installed compiler dependency graph.
4
+ import { createRequire } from 'node:module';
5
+ // oxlint-disable-next-line import/no-nodejs-modules -- Package-relative names, never installation paths, enter the key.
6
+ import { dirname, resolve, relative } from 'node:path';
7
+ import { build } from 'vite';
8
+ import * as v from 'valibot';
9
+ import { encodeCanonicalJson, hashImmutableBytes } from './immutable';
10
+ import { readBoundedFile } from './sourceReader';
11
+
12
+ const Package = v.object({ name: v.string(), version: v.string(), dependencies: v.optional(v.record(v.string(), v.string()), {}) });
13
+ const external = ['binaryen', 'assemblyscript/dist/asc.js'];
14
+ /** A bounded immutable build session owns its two identities. Production uses
15
+ * the native bundler; a host may provide its own scoped bundling capability. */
16
+ export function createProjectCompilerIdentities(bundle: typeof build = build): {
17
+ project: () => Promise<string>; rawAssemblyScript: () => Promise<string>;
18
+ } {
19
+ let project: Promise<string> | undefined, raw: Promise<string> | undefined;
20
+ return {
21
+ project: () => { project ??= capture('project', bundle); return project; },
22
+ rawAssemblyScript: () => { raw ??= capture('raw-assemblyscript', bundle); return raw; },
23
+ };
24
+ }
25
+ const compilerIdentities = createProjectCompilerIdentities();
26
+
27
+ /** Hash a build tool's bundled implementation and installed external compiler closure.
28
+ * This conservative identity is captured once per immutable CLI process; the product receipt still traces source reads. */
29
+ export function projectCompilerIdentity(): Promise<string> {
30
+ return compilerIdentities.project();
31
+ }
32
+ /** Raw ASC storage retains both compiler entry implementations and the same
33
+ * installed compiler/runtime/stdlib closure. Decision builders are outside this
34
+ * role: their complete generated virtual sources and arguments key the raw memo,
35
+ * while the full project identity above still binds their own implementation. */
36
+ export function rawAssemblyScriptCompilerIdentity(): Promise<string> {
37
+ return compilerIdentities.rawAssemblyScript();
38
+ }
39
+ async function capture(role: 'project' | 'raw-assemblyscript', bundle: typeof build): Promise<string> {
40
+ // The CLI defines the SDK directory when executing its bundle as a data URL.
41
+ const require = createRequire(resolve(import.meta.dirname, 'package.json'));
42
+ const compiler = require.resolve('@wildshard/sdk/compileScript');
43
+ const decisions = require.resolve('@wildshard/sdk/buildDecisionScripts');
44
+ const v2 = require.resolve('@wildshard/sdk/compileScriptV2');
45
+ const built = await bundle({ configFile: false, logLevel: 'silent', build: { write: false, minify: false,
46
+ lib: { entry: role === 'project' ? [compiler, decisions, v2] : [compiler, v2], formats: ['es'] },
47
+ rolldownOptions: { external: [/^node:/u, ...external] } } });
48
+ const result = Array.isArray(built) ? built[0] : built;
49
+ if (result === undefined || !('output' in result)) throw new Error('Missing generation compiler identity');
50
+ const chunks = result.output.filter(row => row.type === 'chunk'), names = new Set(chunks.map(row => row.fileName));
51
+ if (chunks.length === 0 || result.output.some(row => row.type !== 'chunk')
52
+ || chunks.some(row => [...row.imports, ...row.dynamicImports].some(name => !names.has(name) && !name.startsWith('node:') && !external.includes(name)))) throw new Error('Unknown generation compiler dependency');
53
+ const files: [string, string][] = chunks.map(row => [`sdk/${row.fileName}`, hashImmutableBytes(new TextEncoder().encode(row.code))]);
54
+ files.push(...compilerPackageInputs([{ name: 'binaryen', from: compiler }, { name: 'assemblyscript', from: compiler, specifier: 'assemblyscript/dist/asc.js' }]));
55
+ files.sort(([a, ah], [b, bh]) => a.localeCompare(b) || ah.localeCompare(bh));
56
+ return hashImmutableBytes(new TextEncoder().encode(encodeCanonicalJson(role === 'project' ? { version: 1, files } : { version: 1, role, files })));
57
+ }
58
+
59
+ /** Capture actual runtime and standard-library files, including transitive installed compiler versions. */
60
+ export function compilerPackageInputs(packages: readonly { readonly name: string; readonly from: string; readonly specifier?: string }[]): readonly [string, string][] {
61
+ const files: [string, string][] = [];
62
+ const visited = new Set<string>(); let count = 0, total = 0;
63
+ const packageInputs = (name: string, from: string, specifier = name): void => {
64
+ let root = dirname(realpathSync(createRequire(from).resolve(specifier)));
65
+ for (;;) {
66
+ const path = resolve(root, 'package.json');
67
+ if (existsSync(path)) {
68
+ const installedName = v.parse(v.object({ name: v.optional(v.string()) }), JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(readBoundedFile(path, 1_000_000)))).name;
69
+ // Root-pinned Binaryen aliases retain their actual manifest/version/source identity below.
70
+ if (installedName === name || (name === 'binaryen' && installedName === '@pre-bundled/binaryen')) break;
71
+ }
72
+ const parent = dirname(root); if (parent === root) throw new Error('Missing compiler package identity'); root = parent;
73
+ }
74
+ if (visited.has(root)) return; visited.add(root);
75
+ const metadata = resolve(root, 'package.json'), pkg = v.parse(Package, JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(readBoundedFile(metadata, 1_000_000))));
76
+ const walk = (directory: string): void => {
77
+ for (const entry of readdirSync(directory, { withFileTypes: true })) {
78
+ if (entry.name === 'node_modules') continue;
79
+ const path = resolve(directory, entry.name);
80
+ if (entry.isSymbolicLink()) throw new Error('Compiler package contains a symbolic source');
81
+ if (entry.isDirectory()) walk(path);
82
+ else if (entry.isFile() && /\.(?:[cm]?js|ts|wasm|json)$/u.test(entry.name)) {
83
+ const bytes = readBoundedFile(path, 64_000_000); total += bytes.byteLength;
84
+ if (++count > 10000 || total > 256_000_000) throw new Error('Compiler package identity exceeds bounds');
85
+ files.push([`${pkg.name}@${pkg.version}/${relative(root, path).replaceAll('\\', '/')}`, hashImmutableBytes(bytes)]);
86
+ }
87
+ }
88
+ };
89
+ walk(root);
90
+ for (const dependency of Object.keys(pkg.dependencies).sort()) packageInputs(dependency, metadata);
91
+ };
92
+ for (const row of packages) packageInputs(row.name, row.from, row.specifier);
93
+ return files.sort(([a, ah], [b, bh]) => a.localeCompare(b) || ah.localeCompare(bh));
94
+ }
@@ -0,0 +1,66 @@
1
+ import * as v from 'valibot';
2
+ import { nativeRuntimeActorIds } from '@wildshard/format/nativeRuntimePlan';
3
+ import { buildDecisionRegistries } from '@wildshard/format/decisionBindings';
4
+ import { DeclaredBodyOpsSchema, declaredBodyRegistries } from '@wildshard/format/bodySlots';
5
+ import { parseActorMoves } from '@wildshard/format/actorMoves';
6
+ import { readCreatureStrikes } from '@wildshard/format/creatures';
7
+ import type { Shardfile } from '@wildshard/format/shardSchema';
8
+ import type { OutputFile } from '@wildshard/format/outputIndex';
9
+ import { compileDecisionScripts, readDecisionSources, type DecisionBuildOptions } from './buildDecisionScripts';
10
+ import { outputDecisionScripts } from './outputProduct';
11
+ import { emitPlatformSections } from './platformSections';
12
+ import { parseWorldTargets } from '@wildshard/format/worldTargets';
13
+ import { hashAssetBytes } from './assetHandle';
14
+ import type { EmittedSections } from './sections';
15
+ import type { NamedBlob } from './blobs';
16
+
17
+ /** Standalone policy is an explicit author declaration, separate from shipped runtime/content. */
18
+ export function projectDecisionOptions(input: unknown, decisionLegacyLines?: number): DecisionBuildOptions {
19
+ const options = v.parse(v.strictObject({ asLineCeiling: v.exactOptional(v.pipe(v.number(), v.safeInteger(), v.minValue(0))) }), input ?? {});
20
+ return { ...options, ...(decisionLegacyLines === undefined ? {} : { decisionLegacyLines }) };
21
+ }
22
+ /** Replace the declared decision payload with freshly compiled rows; no old Wasm bytes are needed to build it. */
23
+ export async function prepareProjectDecisions(project: string, source: Shardfile, platform: EmittedSections | undefined, options: DecisionBuildOptions): Promise<{
24
+ platform?: EmittedSections; blobs: readonly NamedBlob[]; replaced: ReadonlySet<string>;
25
+ }> {
26
+ const rows = outputDecisionScripts(platform);
27
+ if (rows.length === 0) return { ...(platform === undefined ? {} : { platform }), blobs: [], replaced: new Set() };
28
+ const authored = readDecisionSources(project);
29
+ const moveEntry = platform?.sections.find(row => row.name === 'actors/moves'), moveBytes = moveEntry === undefined ? undefined : platform?.files.get(moveEntry.path);
30
+ const moves = moveBytes === undefined ? [] : parseActorMoves(JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(moveBytes)));
31
+ const targetEntry = platform?.sections.find(row => row.name === 'world/targets'), targetBytes = targetEntry === undefined ? undefined : platform?.files.get(targetEntry.path);
32
+ if (targetEntry !== undefined && targetBytes === undefined) throw new Error('Missing declared world target section bytes');
33
+ if (targetEntry !== undefined && targetBytes !== undefined && (targetBytes.length !== targetEntry.bytes || hashAssetBytes(targetBytes) !== targetEntry.hash)) throw new Error('World target section hash or size mismatch');
34
+ const worldTargets = targetBytes === undefined ? undefined : parseWorldTargets(JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(targetBytes)));
35
+ const strikeEntry = platform?.sections.find(row => row.name === 'actors/strikes'), strikeBytes = strikeEntry === undefined ? undefined : platform?.files.get(strikeEntry.path);
36
+ if (strikeEntry !== undefined && strikeBytes === undefined) throw new Error('Missing declared native strike section bytes');
37
+ if (strikeEntry !== undefined && strikeBytes !== undefined && (strikeBytes.length !== strikeEntry.bytes || hashAssetBytes(strikeBytes) !== strikeEntry.hash)) throw new Error('Native strike section hash or size mismatch');
38
+ const strikes = strikeBytes === undefined ? [] : readCreatureStrikes(JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(strikeBytes)));
39
+ const nativeEntry = platform?.sections.find(row => row.name === 'sim/runtime-plan');
40
+ const nativeBytes = nativeEntry === undefined ? undefined : platform?.files.get(nativeEntry.path);
41
+ if (nativeEntry !== undefined && (nativeBytes === undefined || nativeBytes.length !== nativeEntry.bytes || hashAssetBytes(nativeBytes) !== nativeEntry.hash)) throw new Error('Native plan section hash or size mismatch');
42
+ const nativeActors = source.runtime === null && nativeBytes !== undefined
43
+ ? nativeRuntimeActorIds(JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(nativeBytes))) : [];
44
+ // G566: the shard's declared bodies (sim/bodies) resolve the scripts' Body / Collider aliases, as the runtime host does
45
+ const bodyEntry = platform?.sections.find(row => row.name === 'sim/bodies'), bodyBytes = bodyEntry === undefined ? undefined : platform?.files.get(bodyEntry.path);
46
+ if (bodyEntry !== undefined && (bodyBytes === undefined || bodyBytes.length !== bodyEntry.bytes || hashAssetBytes(bodyBytes) !== bodyEntry.hash)) throw new Error('Declared body section hash or size mismatch');
47
+ const bodies = bodyBytes === undefined ? {} : declaredBodyRegistries(v.parse(DeclaredBodyOpsSchema, JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(bodyBytes))));
48
+ const built = await compileDecisionScripts(rows, { ...buildDecisionRegistries(source, moves, worldTargets, strikes, rows, nativeActors), ...bodies }, authored, options);
49
+ const emitted = emitPlatformSections(new Map([['sim/scripts', built.rows]])), sections = [...(platform?.sections ?? []).filter(row => row.name !== 'sim/scripts'), ...emitted.sections];
50
+ const files = new Map(platform?.files);
51
+ for (const row of platform?.sections ?? []) if (row.name === 'sim/scripts') files.delete(row.path);
52
+ for (const [path, bytes] of emitted.files) files.set(path, bytes);
53
+ return { platform: { sections, files }, blobs: built.blobs, replaced: new Set(rows.map(row => row.module.slice('blobs/wasm/'.length, -'.wasm'.length))) };
54
+ }
55
+ /** Source declarations previously emitted by a v1 producer are superseded by the official author compiler. */
56
+ export function replacedDecisionBlob(row: { kind: string; source: string }, replaced: ReadonlySet<string>): boolean {
57
+ return row.kind === 'wasm' && replaced.has((row.source.split('/').at(-1) ?? '').replace(/\.wasm$/u, ''));
58
+ }
59
+ /** Preserve an authored logical name when its old hash declaration is replaced. */
60
+ export function decisionBlobNames(blobs: readonly NamedBlob[], files: readonly OutputFile[], sources: readonly { name: string; source: string; kind: string }[], oldRows: ReturnType<typeof outputDecisionScripts>): readonly NamedBlob[] {
61
+ return blobs.map(blob => {
62
+ const row = oldRows.find(candidate => blob.file.name === `behaviour/${candidate.id}.wasm`), hash = row?.module.slice('blobs/wasm/'.length, -'.wasm'.length);
63
+ const name = hash === undefined ? undefined : files.find(file => file.hash === hash)?.name ?? sources.find(file => replacedDecisionBlob(file, new Set([hash])))?.name;
64
+ return name === undefined ? blob : { ...blob, file: { ...blob.file, name } };
65
+ });
66
+ }
@@ -0,0 +1,32 @@
1
+ // oxlint-disable-next-line import/no-nodejs-modules -- Resolve only the SDK's installed native physics binary, never author-selected files.
2
+ import { createRequire } from 'node:module';
3
+ // oxlint-disable-next-line import/no-nodejs-modules -- The fixed package binary is adjacent to its installed entry.
4
+ import { resolve } from 'node:path';
5
+ import { loadRapier } from '@wildshard/engine/physics/rapier';
6
+ import { Physics } from '@wildshard/engine/physics/Physics';
7
+ import { addBakedPieces } from '@wildshard/engine/game/plugin/simulation';
8
+ import { proveEntryways } from '@wildshard/engine/game/bake/entryways';
9
+ import { readBoundedFile } from './sourceReader';
10
+ import { parseShardfile, type Shardfile } from '@wildshard/engine/host/shardfile';
11
+
12
+ /** Actual static capsule walks and transfers, never a caller-supplied receipt. */
13
+ export interface StaticPortalEntryProof { readonly lanes: number; readonly steps: number; readonly portalTransfers: number }
14
+
15
+ /** Fresh build-only proof. Dynamic movers and ordinary edge entries require their existing world-specific proofs. */
16
+ export async function proveStaticPortalEntries(input: Shardfile, pieces: unknown): Promise<StaticPortalEntryProof> {
17
+ const source = parseShardfile(input);
18
+ if (source.entryways.length === 0 || source.entryways.some(entry => entry.kind !== 'portalLink')) {
19
+ throw new Error('Static portal proof requires only declared portal links');
20
+ }
21
+ const require = createRequire(resolve(import.meta.dirname, 'package.json'));
22
+ const binary = require.resolve('@dimforge/rapier3d-simd/rapier_wasm3d_bg.wasm');
23
+ const physics = new Physics(await loadRapier(readBoundedFile(binary, 25_000_000).slice()));
24
+ try {
25
+ addBakedPieces(physics, pieces); physics.step();
26
+ const proof = proveEntryways(source, new Map(), { world: () => ({ physics,
27
+ fixedStep: () => { /* Static portal entries have no moving owner. */ },
28
+ dispose: () => { /* This operation owns the single physics world. */ } }) });
29
+ if (proof.portalTransfers === undefined) throw new Error('Static portal proof produced no transfer evidence');
30
+ return { lanes: proof.lanes, steps: proof.steps, portalTransfers: proof.portalTransfers };
31
+ } finally { physics.dispose(); }
32
+ }