@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,406 @@
1
+ import { CanvasTexture, LinearMipmapLinearFilter, SRGBColorSpace } from 'three';
2
+ import { custom, parse } from 'valibot';
3
+ import { isJsonData } from '@wildshard/format/json';
4
+ import { Rng } from '../random';
5
+
6
+ // Author-owned canvas instruction evaluator. Keep native call order and every
7
+ // expression/RNG operation equal to the original runtime painter.
8
+ /** one path segment: move, line, or arc (centre, radius, start and end angle in half turns, and when given whether it
9
+ * runs counter-clockwise) */
10
+ export type CanvasSegment = readonly ['M', number, number] | readonly ['L', number, number] | readonly ['A', number, number, number, number, number] | readonly ['A', number, number, number, number, number, boolean];
11
+
12
+ /** a number, or an expression string evaluated in the painter's scope */
13
+ export type CanvasExpr = number | string;
14
+
15
+ /** the canvas calls a `call` step makes, its arguments expressions */
16
+ export type CanvasCall = 'beginPath' | 'closePath' | 'fill' | 'stroke' | 'moveTo' | 'lineTo' | 'arc' | 'ellipse' | 'quadraticCurveTo' | 'bezierCurveTo' | 'fillRect' | 'strokeRect' | 'translate' | 'scale' | 'rotate' | 'save' | 'restore';
17
+
18
+ /** a draw step as data */
19
+ export type CanvasStep =
20
+ | { readonly op: 'set'; readonly fill?: string; readonly stroke?: string; readonly width?: CanvasExpr; readonly cap?: CanvasLineCap; readonly join?: CanvasLineJoin; readonly font?: string; readonly align?: CanvasTextAlign; readonly baseline?: CanvasTextBaseline; readonly alpha?: CanvasExpr }
21
+ | { readonly op: 'fillRect' | 'strokeRect'; readonly x: number; readonly y: number; readonly w: number; readonly h: number }
22
+ | { readonly op: 'save' | 'restore' }
23
+ | { readonly op: 'translate' | 'scale'; readonly x: number; readonly y: number }
24
+ | { readonly op: 'rotate'; readonly turns: number }
25
+ | { readonly op: 'path'; readonly segs: readonly CanvasSegment[]; readonly s?: number; readonly at?: readonly [number, number]; readonly fill?: boolean }
26
+ | { readonly op: 'text'; readonly text: string; readonly x: number; readonly y: number }
27
+ | { readonly op: 'radial'; readonly from: readonly [number, number, number]; readonly to: readonly [number, number, number]; readonly stops: readonly (readonly [number, string])[]; readonly x: number; readonly y: number; readonly w: number; readonly h: number }
28
+ | { readonly op: 'speckle'; readonly n: number; readonly seed: number; readonly split: number; readonly styles: readonly [string, string]; readonly x: number; readonly y: number; readonly w: number; readonly h: number; readonly mark: readonly [number, number, number, number] }
29
+ | { readonly op: 'grain'; readonly n: number; readonly stride: readonly [number, number]; readonly mark: readonly [number, number, number, number]; readonly x: number; readonly y: number; readonly w: number; readonly h: number }
30
+ | { readonly op: 'rng'; readonly seed: CanvasExpr }
31
+ | { readonly op: 'let' | 'assign'; readonly vars: readonly (readonly [string, CanvasExpr])[] }
32
+ | { readonly op: 'fn'; readonly name: string; readonly params: readonly string[]; readonly body: string }
33
+ | { readonly op: 'list'; readonly name: string }
34
+ | { readonly op: 'push'; readonly list: string; readonly vals: readonly CanvasExpr[] }
35
+ | { readonly op: 'loop'; readonly v: string; readonly n: CanvasExpr; readonly body: readonly CanvasStep[] }
36
+ | { readonly op: 'for'; readonly v: string; readonly from: CanvasExpr; readonly while: string; readonly next: string; readonly body: readonly CanvasStep[] }
37
+ | { readonly op: 'each'; readonly v: string | readonly string[]; readonly of: string | readonly number[]; readonly body: readonly CanvasStep[] }
38
+ | { readonly op: 'if'; readonly cond: string; readonly yes: readonly CanvasStep[]; readonly no?: readonly CanvasStep[] }
39
+ | { readonly op: 'call'; readonly fn: CanvasCall; readonly args?: readonly CanvasExpr[] }
40
+ | { readonly op: 'gradient'; readonly kind: 'linear' | 'radial'; readonly args: readonly CanvasExpr[]; readonly stops: readonly (readonly [CanvasExpr, string])[]; readonly to?: 'fill' | 'stroke' }
41
+ | { readonly op: 'valueNoise'; readonly size: number; readonly octaves: readonly number[]; readonly amp: number; readonly gain: number };
42
+
43
+ /** an atlas as data: its authored size, the draw scale (undefined: no scale call) and its steps */
44
+ export interface CanvasAtlasRow { readonly w: number; readonly h: number; readonly steps: readonly CanvasStep[] }
45
+
46
+ /** Admit the original JSON-only atlas input without installing a runtime geometry reader. */
47
+ export function canvasAtlasRows(input: unknown): CanvasAtlasRow {
48
+ return parse(custom<CanvasAtlasRow>(isJsonData), input);
49
+ }
50
+
51
+ // ───────────────────────────── expressions ─────────────────────────────
52
+
53
+ type Value = number | string | boolean;
54
+ type Compiled = (s: Scope) => Value;
55
+ interface PaintState { readonly g: CanvasRenderingContext2D; rng: Rng | null }
56
+ interface ExprFn { readonly params: readonly string[]; readonly body: Compiled; readonly scope: Scope }
57
+
58
+ class Scope {
59
+ readonly vars = new Map<string, Value>();
60
+ readonly lists = new Map<string, Value[][]>();
61
+ readonly fns = new Map<string, ExprFn>();
62
+ readonly parent: Scope | null;
63
+ readonly paint: PaintState;
64
+ constructor(parent: Scope | null, paint: PaintState) { this.parent = parent; this.paint = paint; }
65
+ child(): Scope { return new Scope(this, this.paint); }
66
+ owner<K>(pick: (s: Scope) => Map<string, K>, name: string): Map<string, K> {
67
+ if (pick(this).has(name)) return pick(this);
68
+ if (this.parent === null) throw new Error(`canvas painter: unknown name ${name}`);
69
+ return this.parent.owner(pick, name);
70
+ }
71
+ get(name: string): Value { const v = this.owner((s) => s.vars, name).get(name); if (v === undefined) throw new Error(name); return v; }
72
+ list(name: string): Value[][] { const l = this.owner((s) => s.lists, name).get(name); if (l === undefined) throw new Error(name); return l; }
73
+ fn(name: string): ExprFn | undefined { return this.fns.get(name) ?? this.parent?.fn(name); }
74
+ }
75
+
76
+ const truthy = (v: Value): boolean => (typeof v === 'number' ? v !== 0 && !Number.isNaN(v) : typeof v === 'string' ? v !== '' : v);
77
+ function num(v: Value): number {
78
+ if (typeof v !== 'number') throw new Error(`canvas painter: ${String(v)} is not a number`);
79
+ return v;
80
+ }
81
+ function stream(s: Scope): Rng {
82
+ const r = s.paint.rng;
83
+ if (r === null) throw new Error('canvas painter: no rng step before next() / range()');
84
+ return r;
85
+ }
86
+ const MATH: Readonly<Record<string, (a: readonly number[]) => number>> = {
87
+ sin: (a) => Math.sin(canvasArgument(a, 0)), cos: (a) => Math.cos(canvasArgument(a, 0)), tan: (a) => Math.tan(canvasArgument(a, 0)), atan2: (a) => Math.atan2(canvasArgument(a, 0), canvasArgument(a, 1)),
88
+ sqrt: (a) => Math.sqrt(canvasArgument(a, 0)), abs: (a) => Math.abs(canvasArgument(a, 0)), floor: (a) => Math.floor(canvasArgument(a, 0)), ceil: (a) => Math.ceil(canvasArgument(a, 0)),
89
+ round: (a) => Math.round(canvasArgument(a, 0)), min: (a) => Math.min(...a), max: (a) => Math.max(...a),
90
+ };
91
+ function canvasArgument(a: readonly number[], i: number): number {
92
+ const v = a[i];
93
+ if (v === undefined) throw new Error('canvas painter: missing argument');
94
+ return v;
95
+ }
96
+
97
+ const TOKEN = /\s*(?:(\d+(?:\.\d*)?(?:[eE][-+]?\d+)?|\.\d+(?:[eE][-+]?\d+)?)|([A-Za-z_]\w*)|'([^']*)'|(\*\*|===|!==|<=|>=|&&|\|\||[-+*/%<>()?:,!]))/yu;
98
+ const BINARY: Readonly<Record<string, (a: number, b: number) => Value>> = {
99
+ '+': (a, b) => a + b, '-': (a, b) => a - b, '*': (a, b) => a * b, '/': (a, b) => a / b, '%': (a, b) => a % b, '**': (a, b) => a ** b,
100
+ '<': (a, b) => a < b, '<=': (a, b) => a <= b, '>': (a, b) => a > b, '>=': (a, b) => a >= b,
101
+ };
102
+ const LEVELS: readonly (readonly string[])[] = [['===', '!=='], ['<', '<=', '>', '>='], ['+', '-'], ['*', '/', '%']];
103
+
104
+ interface Token { readonly k: 'n' | 'id' | 's' | 'op'; readonly t: string }
105
+ function tokens(src: string): Token[] {
106
+ const toks: Token[] = [];
107
+ TOKEN.lastIndex = 0;
108
+ while (TOKEN.lastIndex < src.length) {
109
+ if (/^\s*$/u.test(src.slice(TOKEN.lastIndex))) break;
110
+ const m = TOKEN.exec(src);
111
+ if (m === null) throw new Error(`canvas painter: cannot read "${src}" at ${TOKEN.lastIndex}`);
112
+ if (m[1] !== undefined) toks.push({ k: 'n', t: m[1] });
113
+ else if (m[2] !== undefined) toks.push({ k: 'id', t: m[2] });
114
+ else if (m[3] !== undefined) toks.push({ k: 's', t: m[3] });
115
+ else toks.push({ k: 'op', t: m[4] ?? '' });
116
+ }
117
+ return toks;
118
+ }
119
+
120
+ /** a recursive-descent parse of one expression into a closure (JavaScript's precedence, associativity and order) */
121
+ class Parser {
122
+ private p = 0;
123
+ private readonly toks: readonly Token[];
124
+ private readonly src: string;
125
+ constructor(src: string) { this.src = src; this.toks = tokens(src); }
126
+ parse(): Compiled {
127
+ const out = this.ternary();
128
+ if (this.p !== this.toks.length) throw new Error(`canvas painter: trailing input in "${this.src}"`);
129
+ return out;
130
+ }
131
+ private peek(t: string): boolean { const k = this.toks[this.p]; return k?.k === 'op' && k.t === t; }
132
+ private eat(t: string): void { if (!this.peek(t)) throw new Error(`canvas painter: expected ${t} in "${this.src}"`); this.p++; }
133
+ private ternary(): Compiled {
134
+ const c = this.or();
135
+ if (!this.peek('?')) return c;
136
+ this.p++;
137
+ const a = this.ternary(); this.eat(':'); const b = this.ternary();
138
+ return (s) => (truthy(c(s)) ? a(s) : b(s));
139
+ }
140
+ private or(): Compiled {
141
+ let l = this.and();
142
+ while (this.peek('||')) { this.p++; const a = l, b = this.and(); l = (s) => { const v = a(s); return truthy(v) ? v : b(s); }; }
143
+ return l;
144
+ }
145
+ private and(): Compiled {
146
+ let l = this.level(0);
147
+ while (this.peek('&&')) { this.p++; const a = l, b = this.level(0); l = (s) => { const v = a(s); return truthy(v) ? b(s) : v; }; }
148
+ return l;
149
+ }
150
+ private level(i: number): Compiled {
151
+ const ops = LEVELS[i];
152
+ if (ops === undefined) return this.unary();
153
+ let l = this.level(i + 1);
154
+ for (let t = this.toks[this.p]; t?.k === 'op' && ops.includes(t.t); t = this.toks[this.p]) {
155
+ this.p++;
156
+ const a = l, b = this.level(i + 1), op = t.t;
157
+ if (op === '===') l = (s) => a(s) === b(s);
158
+ else if (op === '!==') l = (s) => a(s) !== b(s);
159
+ else { const f = BINARY[op]; if (f === undefined) throw new Error(op); l = (s) => f(num(a(s)), num(b(s))); }
160
+ }
161
+ return l;
162
+ }
163
+ private unary(): Compiled {
164
+ if (this.peek('-')) { this.p++; const a = this.unary(); return (s) => -num(a(s)); }
165
+ if (this.peek('!')) { this.p++; const a = this.unary(); return (s) => !truthy(a(s)); }
166
+ const base = this.primary();
167
+ if (!this.peek('**')) return base;
168
+ this.p++;
169
+ const e = this.unary();
170
+ return (s) => num(base(s)) ** num(e(s));
171
+ }
172
+ private primary(): Compiled {
173
+ const t = this.toks[this.p++];
174
+ if (t === undefined) throw new Error(`canvas painter: "${this.src}" ends early`);
175
+ if (t.k === 'n') { const v = Number(t.t); return () => v; }
176
+ if (t.k === 's') { const v = t.t; return () => v; }
177
+ if (t.k === 'op') { if (t.t !== '(') throw new Error(`canvas painter: unexpected ${t.t} in "${this.src}"`); const e = this.ternary(); this.eat(')'); return e; }
178
+ const name = t.t;
179
+ if (!this.peek('(')) return name === 'PI' ? () => Math.PI : (s) => s.get(name);
180
+ this.p++;
181
+ const args: Compiled[] = [];
182
+ while (!this.peek(')')) { args.push(this.ternary()); if (!this.peek(')')) this.eat(','); }
183
+ this.p++;
184
+ return callOf(name, args);
185
+ }
186
+ }
187
+
188
+ function callOf(name: string, args: readonly Compiled[]): Compiled {
189
+ if (name === 'next') return (s) => stream(s).next();
190
+ if (name === 'range') return (s) => { const a = num(argOf(args, 0)(s)), b = num(argOf(args, 1)(s)); return stream(s).range(a, b); };
191
+ const m = MATH[name];
192
+ if (m !== undefined) return (s) => m(args.map((a) => num(a(s))));
193
+ return (s) => {
194
+ const f = s.fn(name);
195
+ if (f === undefined) throw new Error(`canvas painter: unknown function ${name}`);
196
+ const vals = args.map((a) => a(s)), inner = f.scope.child();
197
+ for (const [i, n] of f.params.entries()) inner.vars.set(n, vals[i] ?? 0);
198
+ return f.body(inner);
199
+ };
200
+ }
201
+ function argOf(args: readonly Compiled[], i: number): Compiled {
202
+ const a = args[i];
203
+ if (a === undefined) throw new Error('canvas painter: missing argument');
204
+ return a;
205
+ }
206
+
207
+ const compiled = new Map<string, Compiled>();
208
+ function compile(src: string): Compiled {
209
+ let c = compiled.get(src);
210
+ if (c === undefined) { c = new Parser(src).parse(); compiled.set(src, c); }
211
+ return c;
212
+ }
213
+ const value = (e: CanvasExpr, s: Scope): Value => (typeof e === 'number' ? e : compile(e)(s));
214
+ const number = (e: CanvasExpr, s: Scope): number => (typeof e === 'number' ? e : num(compile(e)(s)));
215
+
216
+ const templates = new Map<string, readonly (string | Compiled)[]>();
217
+ /** a style string: literal, or a template whose `{expr}` parts print as JavaScript's `${}` does */
218
+ function style(t: string, s: Scope): string {
219
+ if (!t.includes('{')) return t;
220
+ let parts = templates.get(t);
221
+ if (parts === undefined) {
222
+ const out: (string | Compiled)[] = [];
223
+ for (const piece of t.split(/(\{[^}]*\})/u)) if (piece !== '') out.push(piece.startsWith('{') ? compile(piece.slice(1, -1)) : piece);
224
+ parts = out;
225
+ templates.set(t, parts);
226
+ }
227
+ let r = '';
228
+ for (const part of parts) r += typeof part === 'string' ? part : String(part(s));
229
+ return r;
230
+ }
231
+
232
+ // ───────────────────────────── steps ─────────────────────────────
233
+
234
+ function set(g: CanvasRenderingContext2D, st: Extract<CanvasStep, { op: 'set' }>, s: Scope): void {
235
+ if (st.fill !== undefined) g.fillStyle = style(st.fill, s);
236
+ if (st.stroke !== undefined) g.strokeStyle = style(st.stroke, s);
237
+ if (st.width !== undefined) g.lineWidth = number(st.width, s);
238
+ if (st.cap !== undefined) g.lineCap = st.cap;
239
+ if (st.join !== undefined) g.lineJoin = st.join;
240
+ if (st.font !== undefined) g.font = st.font;
241
+ if (st.align !== undefined) g.textAlign = st.align;
242
+ if (st.baseline !== undefined) g.textBaseline = st.baseline;
243
+ if (st.alpha !== undefined) g.globalAlpha = number(st.alpha, s);
244
+ }
245
+
246
+ function path(g: CanvasRenderingContext2D, p: Extract<CanvasStep, { op: 'path' }>): void {
247
+ const k = p.s, at0 = p.at;
248
+ // a coordinate: the scaled value, offset by `at` (the same arithmetic an authored `x + s * k` performs)
249
+ const cx = (v: number): number => (k === undefined ? v : at0 === undefined ? k * v : at0[0] + k * v);
250
+ const cy = (v: number): number => (k === undefined ? v : at0 === undefined ? k * v : at0[1] + k * v);
251
+ const r = (v: number): number => (k === undefined ? v : k * v);
252
+ g.beginPath();
253
+ for (const seg of p.segs) {
254
+ if (seg[0] === 'M') g.moveTo(cx(seg[1]), cy(seg[2]));
255
+ else if (seg[0] === 'L') g.lineTo(cx(seg[1]), cy(seg[2]));
256
+ else if (seg.length === 7) g.arc(cx(seg[1]), cy(seg[2]), r(seg[3]), Math.PI * seg[4], Math.PI * seg[5], seg[6]);
257
+ else g.arc(cx(seg[1]), cy(seg[2]), r(seg[3]), Math.PI * seg[4], Math.PI * seg[5]);
258
+ }
259
+ if (p.fill === true) g.fill(); else g.stroke();
260
+ }
261
+
262
+ function call(g: CanvasRenderingContext2D, fn: CanvasCall, a: readonly number[]): void {
263
+ switch (fn) {
264
+ case 'beginPath': g.beginPath(); break;
265
+ case 'closePath': g.closePath(); break;
266
+ case 'fill': g.fill(); break;
267
+ case 'stroke': g.stroke(); break;
268
+ case 'save': g.save(); break;
269
+ case 'restore': g.restore(); break;
270
+ case 'moveTo': g.moveTo(canvasArgument(a, 0), canvasArgument(a, 1)); break;
271
+ case 'lineTo': g.lineTo(canvasArgument(a, 0), canvasArgument(a, 1)); break;
272
+ case 'translate': g.translate(canvasArgument(a, 0), canvasArgument(a, 1)); break;
273
+ case 'scale': g.scale(canvasArgument(a, 0), canvasArgument(a, 1)); break;
274
+ case 'rotate': g.rotate(canvasArgument(a, 0)); break;
275
+ case 'arc': g.arc(canvasArgument(a, 0), canvasArgument(a, 1), canvasArgument(a, 2), canvasArgument(a, 3), canvasArgument(a, 4)); break;
276
+ case 'ellipse': g.ellipse(canvasArgument(a, 0), canvasArgument(a, 1), canvasArgument(a, 2), canvasArgument(a, 3), canvasArgument(a, 4), canvasArgument(a, 5), canvasArgument(a, 6)); break;
277
+ case 'quadraticCurveTo': g.quadraticCurveTo(canvasArgument(a, 0), canvasArgument(a, 1), canvasArgument(a, 2), canvasArgument(a, 3)); break;
278
+ case 'bezierCurveTo': g.bezierCurveTo(canvasArgument(a, 0), canvasArgument(a, 1), canvasArgument(a, 2), canvasArgument(a, 3), canvasArgument(a, 4), canvasArgument(a, 5)); break;
279
+ case 'fillRect': g.fillRect(canvasArgument(a, 0), canvasArgument(a, 1), canvasArgument(a, 2), canvasArgument(a, 3)); break;
280
+ case 'strokeRect': g.strokeRect(canvasArgument(a, 0), canvasArgument(a, 1), canvasArgument(a, 2), canvasArgument(a, 3)); break;
281
+ default: { const unknown: never = fn; throw new Error(`unknown canvas call ${String(unknown)}`); }
282
+ }
283
+ }
284
+
285
+ /** octave value noise from the stream: one n × n lattice of `next()` per octave, smoothstep-blended, amplitudes from
286
+ * `amp` falling by `gain`, written grey and opaque to a size × size ImageData put at the origin */
287
+ function valueNoise(g: CanvasRenderingContext2D, st: Extract<CanvasStep, { op: 'valueNoise' }>, rng: Rng): void {
288
+ const sz = st.size, img = g.createImageData(sz, sz);
289
+ const oct = st.octaves.map((n) => { const a = new Float32Array(n * n); for (let i = 0; i < a.length; i++) a[i] = rng.next(); return { n, a }; });
290
+ const sm = (t: number): number => t * t * (3 - 2 * t);
291
+ for (let y = 0; y < sz; y++) for (let x = 0; x < sz; x++) {
292
+ let v = 0, amp = st.amp, sum = 0;
293
+ for (const { n, a } of oct) {
294
+ const fx = (x / sz) * n, fy = (y / sz) * n, x0 = Math.floor(fx), y0 = Math.floor(fy), tx = sm(fx - x0), ty = sm(fy - y0);
295
+ const q = (i: number, j: number): number => a[((j + n) % n) * n + ((i + n) % n)] ?? 0;
296
+ const vv = (q(x0, y0) * (1 - tx) + q(x0 + 1, y0) * tx) * (1 - ty) + (q(x0, y0 + 1) * (1 - tx) + q(x0 + 1, y0 + 1) * tx) * ty;
297
+ v += vv * amp; sum += amp; amp *= st.gain;
298
+ }
299
+ const b = Math.floor((v / sum) * 255), i = (y * sz + x) * 4;
300
+ img.data[i] = img.data[i + 1] = img.data[i + 2] = b; img.data[i + 3] = 255;
301
+ }
302
+ g.putImageData(img, 0, 0);
303
+ }
304
+
305
+ function run(g: CanvasRenderingContext2D, steps: readonly CanvasStep[], sc: Scope): void {
306
+ for (const s of steps) {
307
+ switch (s.op) {
308
+ case 'set': set(g, s, sc); break;
309
+ case 'fillRect': g.fillRect(s.x, s.y, s.w, s.h); break;
310
+ case 'strokeRect': g.strokeRect(s.x, s.y, s.w, s.h); break;
311
+ case 'save': g.save(); break;
312
+ case 'restore': g.restore(); break;
313
+ case 'translate': g.translate(s.x, s.y); break;
314
+ case 'scale': g.scale(s.x, s.y); break;
315
+ case 'rotate': g.rotate(Math.PI * s.turns); break;
316
+ case 'path': path(g, s); break;
317
+ case 'text': g.fillText(s.text, s.x, s.y); break;
318
+ case 'radial': {
319
+ const grd = g.createRadialGradient(s.from[0], s.from[1], s.from[2], s.to[0], s.to[1], s.to[2]);
320
+ for (const [stop, colour] of s.stops) grd.addColorStop(stop, colour);
321
+ g.fillStyle = grd;
322
+ g.fillRect(s.x, s.y, s.w, s.h);
323
+ break;
324
+ }
325
+ case 'speckle': {
326
+ let q = s.seed;
327
+ const rnd = (): number => { q = (q * 16807) % 2147483647; return q / 2147483647; };
328
+ const [w0, w1, h0, h1] = s.mark;
329
+ for (let i = 0; i < s.n; i++) {
330
+ g.fillStyle = rnd() < s.split ? s.styles[0] : s.styles[1];
331
+ g.fillRect(s.x + rnd() * s.w, s.y + rnd() * s.h, w0 + rnd() * w1, h0 + rnd() * h1);
332
+ }
333
+ break;
334
+ }
335
+ case 'grain': {
336
+ const [w0, wm, h0, hm] = s.mark;
337
+ for (let i = 0; i < s.n; i++) g.fillRect(s.x + ((i * s.stride[0]) % s.w), s.y + ((i * s.stride[1]) % s.h), w0 + (i % wm), h0 + (i % hm));
338
+ break;
339
+ }
340
+ case 'rng': sc.paint.rng = new Rng(number(s.seed, sc)); break;
341
+ case 'let': for (const [n, e] of s.vars) sc.vars.set(n, value(e, sc)); break;
342
+ case 'assign': for (const [n, e] of s.vars) { const v = value(e, sc); sc.owner((x) => x.vars, n).set(n, v); } break;
343
+ case 'fn': sc.fns.set(s.name, { params: s.params, body: compile(s.body), scope: sc }); break;
344
+ case 'list': sc.lists.set(s.name, []); break;
345
+ case 'push': { const l = sc.list(s.list); l.push(s.vals.map((e) => value(e, sc))); break; }
346
+ case 'loop': { const n = number(s.n, sc); for (let i = 0; i < n; i++) { const it = sc.child(); it.vars.set(s.v, i); run(g, s.body, it); } break; }
347
+ case 'for': {
348
+ for (let cur = number(s.from, sc); ;) {
349
+ const it = sc.child(); it.vars.set(s.v, cur);
350
+ if (!truthy(compile(s.while)(it))) break;
351
+ run(g, s.body, it);
352
+ cur = num(compile(s.next)(it));
353
+ }
354
+ break;
355
+ }
356
+ case 'each': {
357
+ if (typeof s.of === 'string') {
358
+ const names = typeof s.v === 'string' ? [s.v] : s.v;
359
+ for (const row of sc.list(s.of)) { const it = sc.child(); for (const [i, n] of names.entries()) it.vars.set(n, row[i] ?? 0); run(g, s.body, it); }
360
+ } else for (const v of s.of) { const it = sc.child(); it.vars.set(typeof s.v === 'string' ? s.v : (s.v[0] ?? ''), v); run(g, s.body, it); }
361
+ break;
362
+ }
363
+ case 'if': {
364
+ if (truthy(compile(s.cond)(sc))) run(g, s.yes, sc.child());
365
+ else if (s.no !== undefined) run(g, s.no, sc.child());
366
+ break;
367
+ }
368
+ case 'call': call(g, s.fn, (s.args ?? []).map((e) => number(e, sc))); break;
369
+ case 'gradient': {
370
+ const a = s.args.map((e) => number(e, sc));
371
+ const grd = s.kind === 'linear' ? g.createLinearGradient(canvasArgument(a, 0), canvasArgument(a, 1), canvasArgument(a, 2), canvasArgument(a, 3)) : g.createRadialGradient(canvasArgument(a, 0), canvasArgument(a, 1), canvasArgument(a, 2), canvasArgument(a, 3), canvasArgument(a, 4), canvasArgument(a, 5));
372
+ for (const [stop, colour] of s.stops) grd.addColorStop(number(stop, sc), style(colour, sc));
373
+ if (s.to === 'stroke') g.strokeStyle = grd; else g.fillStyle = grd;
374
+ break;
375
+ }
376
+ case 'valueNoise': valueNoise(g, s, stream(sc)); break;
377
+ default: {
378
+ const unknown: never = s;
379
+ throw new Error(`unknown canvas step ${JSON.stringify(unknown)}`);
380
+ }
381
+ }
382
+ }
383
+ }
384
+
385
+ /** replay an atlas's steps on a 2D context (already sized and scaled); `vars` seeds the expressions' scope (a level seed) */
386
+ export function paintSteps(g: CanvasRenderingContext2D, steps: readonly CanvasStep[], vars: Readonly<Record<string, number>> = {}): void {
387
+ const root = new Scope(null, { g, rng: null });
388
+ for (const [k, v] of Object.entries(vars)) root.vars.set(k, v);
389
+ run(g, steps, root);
390
+ }
391
+
392
+ /** paint an atlas row on a new canvas at `scale` (undefined: no scale call) and return it as a mipmapped sRGB texture */
393
+ export function paintCanvasAtlas(row: CanvasAtlasRow, scale?: number): CanvasTexture {
394
+ const cv = document.createElement('canvas');
395
+ cv.width = row.w * (scale ?? 1);
396
+ cv.height = row.h * (scale ?? 1);
397
+ const g = cv.getContext('2d');
398
+ if (g === null) throw new Error('2d canvas unavailable');
399
+ if (scale !== undefined) g.scale(scale, scale); // preserve all authored UVs and drawing coordinates at any resolution
400
+ paintSteps(g, row.steps);
401
+ const tex = new CanvasTexture(cv);
402
+ tex.colorSpace = SRGBColorSpace;
403
+ tex.minFilter = LinearMipmapLinearFilter;
404
+ tex.anisotropy = 8;
405
+ return tex;
406
+ }
@@ -0,0 +1,59 @@
1
+ import { BufferAttribute, BufferGeometry, Group, Mesh, MeshStandardMaterial, type Matrix4 } from 'three';
2
+ import { MeshoptSimplifier } from 'meshoptimizer/simplifier';
3
+ import { positionErrorScale, floatPositionError } from './geometryError';
4
+
5
+ await MeshoptSimplifier.ready;
6
+
7
+ /**
8
+ * One geometry simplified in its own frame (meshopt, borders locked, `errorMetres` absolute); the kept vertices keep every
9
+ * channel (colours and any custom shader channels). `sloppy`: unwelded sources (every edge a border) barely simplify, so
10
+ * past 1.5 x the target meshopt's topology-free pass takes over. The ratio is a target. The caller owns the result.
11
+ */
12
+ export function coarseGeometry(source: BufferGeometry, ratio: number, errorMetres: number, options: { readonly sloppy?: boolean } = {}): BufferGeometry {
13
+ return measuredCoarseGeometry(source, ratio, errorMetres, options).geometry;
14
+ }
15
+
16
+ /** Same selected indices and channels as coarseGeometry, with the tool's achieved appearance-error estimate in metres.
17
+ * Sloppy uses relative units, converted with the tool's scale. This is not a measured Hausdorff distance. */
18
+ export function measuredCoarseGeometry(source: BufferGeometry, ratio: number, errorMetres: number, options: { readonly sloppy?: boolean } = {}): { geometry: BufferGeometry; errorMetres: number } {
19
+ if (!(ratio > 0 && ratio <= 1) || !(errorMetres > 0)) throw new Error('Coarse copy needs a ratio in (0, 1] and a positive error');
20
+ const position = source.getAttribute('position');
21
+ if (!(position instanceof BufferAttribute) || position.itemSize !== 3) throw new Error('Coarse copy needs plain positions');
22
+ const index = source.getIndex(), triangles = index === null ? Array.from({ length: position.count }, (_, i) => i) : Array.from(index.array);
23
+ const positions = new Float32Array(position.count * 3);
24
+ for (let i = 0; i < position.count; i++) positions.set([position.getX(i), position.getY(i), position.getZ(i)], i * 3);
25
+ const target = Math.max(3, Math.floor(triangles.length / 3 * ratio) * 3);
26
+ let [kept, achieved] = MeshoptSimplifier.simplify(Uint32Array.from(triangles), positions, 3, target, errorMetres, ['LockBorder', 'ErrorAbsolute']);
27
+ if (options.sloppy === true && kept.length > target * 1.5) {
28
+ [kept, achieved] = MeshoptSimplifier.simplifySloppy(Uint32Array.from(triangles), positions, 3, null, target, 1);
29
+ achieved *= MeshoptSimplifier.getScale(positions, 3);
30
+ }
31
+ if (!Number.isFinite(achieved) || achieved < 0) throw new Error('Invalid coarse simplifier error');
32
+ const original = Array.from({ length: position.count * 3 }, (_, at) => position.getComponent(Math.floor(at / 3), at % 3));
33
+ const error = kept.length === triangles.length ? 0 : achieved + 2 * floatPositionError(original);
34
+ const geometry = new BufferGeometry();
35
+ for (const [name, attribute] of Object.entries(source.attributes)) geometry.setAttribute(name, attribute.clone());
36
+ geometry.setIndex(Array.from(kept));
37
+ return { geometry, errorMetres: error };
38
+ }
39
+
40
+ /**
41
+ * Tile streaming U2 / G748: a coarse (L1) copy of whole shapes in their own look, for a props bake's `coarse` source.
42
+ * Each shape's geometry is simplified once (`coarseGeometry`) and placed at its transform, on one rough vertex-coloured
43
+ * surface (the props bake's static merge draws it in its own merged look). The caller calls `dispose` after the bake.
44
+ */
45
+ export function coarseCopy(shapes: readonly { readonly mesh: Mesh; readonly transform: Matrix4 }[], ratio = 0.25, errorMetres = 1,
46
+ options: { readonly sloppy?: boolean } = {}): { readonly group: Group; readonly errorMetres: number; readonly dispose: () => void } {
47
+ const group = new Group(), material = new MeshStandardMaterial({ vertexColors: true, roughness: 1, metalness: 0 }), geometries: BufferGeometry[] = [];
48
+ let achieved = 0;
49
+ for (const { mesh, transform } of shapes) {
50
+ const result = measuredCoarseGeometry(mesh.geometry, ratio, errorMetres, options), geometry = result.geometry;
51
+ achieved = Math.max(achieved, result.errorMetres * positionErrorScale(transform));
52
+ if (!geometry.hasAttribute('normal')) geometry.computeVertexNormals();
53
+ geometries.push(geometry);
54
+ const copy = new Mesh(geometry, material);
55
+ transform.decompose(copy.position, copy.quaternion, copy.scale);
56
+ group.add(copy);
57
+ }
58
+ return { group, errorMetres: achieved, dispose: () => { for (const geometry of geometries) geometry.dispose(); material.dispose(); } };
59
+ }
@@ -0,0 +1,87 @@
1
+ import { Matrix4, Quaternion, Vector3, IcosahedronGeometry, type BufferGeometry } from 'three';
2
+ import type { AuthorPlacement, ColliderDesc } from './placement';
3
+
4
+ /** Offline placement transform and its uniform scale; no live registry is constructed. */
5
+ export interface BakedPlacementPose {
6
+ readonly x: number; readonly y: number; readonly z: number;
7
+ readonly matrix: Matrix4; readonly quat: Quaternion; readonly scale: number; readonly upright: boolean;
8
+ }
9
+ const transform = new Matrix4(), position = new Vector3(), size = new Vector3();
10
+
11
+ /** Scale, yaw, lean X, lean Z, then translate; an explicit matrix is copied.
12
+ * This is the successive placement convention, distinct from a model's YXZ Euler pose. */
13
+ export function bakePlacementPose(row: AuthorPlacement<object>): BakedPlacementPose {
14
+ const matrix = new Matrix4();
15
+ if (row.matrix === undefined) {
16
+ const scale = row.scale ?? 1;
17
+ matrix.makeScale(scale, scale, scale);
18
+ if (row.yaw !== undefined) matrix.premultiply(transform.makeRotationY(row.yaw));
19
+ if (row.leanX !== undefined) matrix.premultiply(transform.makeRotationX(row.leanX));
20
+ if (row.leanZ !== undefined) matrix.premultiply(transform.makeRotationZ(row.leanZ));
21
+ matrix.premultiply(transform.makeTranslation(row.x, row.y, row.z));
22
+ } else matrix.copy(row.matrix);
23
+ const quat = new Quaternion();
24
+ matrix.decompose(position, quat, size);
25
+ const upright = row.matrix === undefined ? (row.yaw ?? 0) === 0 && (row.leanX ?? 0) === 0 && (row.leanZ ?? 0) === 0 : Math.abs(quat.w) > 1 - 1e-12;
26
+ return { x: row.x, y: row.y, z: row.z, matrix, quat, scale: size.x, upright };
27
+ }
28
+
29
+ /** Consume a geometry's channels in successive Float32 placement steps, preserving each rounding boundary.
30
+ * An explicit matrix applies once; geometry ownership stays with the caller. */
31
+ export function bakePlacedGeometry(geometry: BufferGeometry, row: AuthorPlacement<object>): void {
32
+ if (row.matrix !== undefined) { geometry.applyMatrix4(row.matrix); return; }
33
+ if (row.scale !== undefined && row.scale !== 1) geometry.scale(row.scale, row.scale, row.scale);
34
+ if (row.yaw !== undefined) geometry.rotateY(row.yaw);
35
+ if (row.leanX !== undefined) geometry.rotateX(row.leanX);
36
+ if (row.leanZ !== undefined) geometry.rotateZ(row.leanZ);
37
+ geometry.translate(row.x, row.y, row.z);
38
+ }
39
+
40
+ /** Copy posed world vertices into a hull relative to the placement anchor, in original geometry/vertex order. */
41
+ export function bakeWorldHull(geometry: readonly BufferGeometry[], pose: Pick<BakedPlacementPose, 'x' | 'y' | 'z'>): Extract<ColliderDesc, { kind: 'hull' }> {
42
+ let count = 0;
43
+ for (const row of geometry) count += row.getAttribute('position').count;
44
+ const points = new Float32Array(count * 3);
45
+ let at = 0;
46
+ for (const row of geometry) {
47
+ const channel = row.getAttribute('position');
48
+ for (let i = 0; i < channel.count; i++, at++) {
49
+ points[at * 3] = channel.getX(i) - pose.x;
50
+ points[at * 3 + 1] = channel.getY(i) - pose.y;
51
+ points[at * 3 + 2] = channel.getZ(i) - pose.z;
52
+ }
53
+ }
54
+ return { kind: 'hull', x: pose.x, y: pose.y, z: pose.z, points };
55
+ }
56
+
57
+ const directions: readonly number[] = (() => {
58
+ const geometry = new IcosahedronGeometry(1, 2), channel = geometry.getAttribute('position');
59
+ const seen = new Set<string>(), out: number[] = [];
60
+ for (let i = 0; i < channel.count; i++) {
61
+ const key = `${channel.getX(i).toFixed(4)},${channel.getY(i).toFixed(4)},${channel.getZ(i).toFixed(4)}`;
62
+ if (!seen.has(key)) { seen.add(key); out.push(channel.getX(i), channel.getY(i), channel.getZ(i)); }
63
+ }
64
+ geometry.dispose();
65
+ return out;
66
+ })();
67
+
68
+ /** Select the first supporting vertex in each native icosphere direction, retaining tie/deduplication order.
69
+ * Read numeric accessors under the supplied matrix; return detached Float32 contact storage. */
70
+ export function bakeSupportPoints(geometry: BufferGeometry, matrix: Matrix4): Float32Array {
71
+ const channel = geometry.getAttribute('position'), vertex = new Vector3(), points: number[] = [];
72
+ for (let i = 0; i < channel.count; i++) { vertex.fromBufferAttribute(channel, i).applyMatrix4(matrix); points.push(vertex.x, vertex.y, vertex.z); }
73
+ const selected = new Set<number>();
74
+ for (let direction = 0; direction < directions.length; direction += 3) {
75
+ const dx = directions[direction] ?? 0, dy = directions[direction + 1] ?? 0, dz = directions[direction + 2] ?? 0;
76
+ let best = -Infinity, at = 0;
77
+ for (let i = 0; i < points.length; i += 3) {
78
+ const support = (points[i] ?? 0) * dx + (points[i + 1] ?? 0) * dy + (points[i + 2] ?? 0) * dz;
79
+ if (support > best) { best = support; at = i; }
80
+ }
81
+ selected.add(at);
82
+ }
83
+ const out = new Float32Array(selected.size * 3);
84
+ let at = 0;
85
+ for (const i of selected) { out[at++] = points[i] ?? 0; out[at++] = points[i + 1] ?? 0; out[at++] = points[i + 2] ?? 0; }
86
+ return out;
87
+ }