@wildshard/sdk 0.0.1 → 0.2.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (687) hide show
  1. package/GUIDE.md +790 -0
  2. package/README.md +13 -5
  3. package/bin/wildshard.mjs +38 -0
  4. package/lint/declaration-config.d.mts +2 -0
  5. package/lint/declaration-config.mjs +19 -0
  6. package/lint/engine-plugin.d.mts +2 -0
  7. package/lint/engine-plugin.mjs +40 -0
  8. package/lint/host-callbacks.d.mts +6 -0
  9. package/lint/host-callbacks.mjs +123 -0
  10. package/lint/host-files.d.mts +1 -0
  11. package/lint/host-files.mjs +7 -0
  12. package/lint/layer-exports.d.mts +2 -0
  13. package/lint/layer-exports.mjs +21 -0
  14. package/lint/legacy-line-basis.json +995 -0
  15. package/lint/nine-tiling-baseline.json +35 -0
  16. package/lint/ratchet.json +11 -0
  17. package/lint/runtime-files.d.mts +12 -0
  18. package/lint/runtime-files.json +16 -0
  19. package/lint/runtime-files.mjs +69 -0
  20. package/lint/runtime-performance.d.mts +6 -0
  21. package/lint/runtime-performance.mjs +184 -0
  22. package/lint/sdk-plugin.d.mts +4 -0
  23. package/lint/sdk-plugin.mjs +134 -0
  24. package/lint/shardfile-boundaries.d.mts +10 -0
  25. package/lint/shardfile-boundaries.mjs +122 -0
  26. package/lint/tile-bake-debt.json +556 -0
  27. package/package.json +365 -3
  28. package/scripts/agent-parity.mjs +1524 -0
  29. package/scripts/agent-sync.mjs +518 -0
  30. package/scripts/apfs-clone.mjs +67 -0
  31. package/scripts/assert-store-layout.mjs +23 -0
  32. package/scripts/astc6-phone-cap.d.mts +3 -0
  33. package/scripts/astc6-phone-cap.mjs +137 -0
  34. package/scripts/audit-assets.d.mts +10 -0
  35. package/scripts/audit-assets.mjs +151 -0
  36. package/scripts/bake/coatFiles.d.mts +6 -0
  37. package/scripts/bake/coatFiles.mjs +37 -0
  38. package/scripts/bake/environment.d.mts +2 -0
  39. package/scripts/bake/environment.mjs +58 -0
  40. package/scripts/bake/far-proxies.mjs +45 -0
  41. package/scripts/bake/keyed-sky.d.mts +4 -0
  42. package/scripts/bake/keyed-sky.mjs +34 -0
  43. package/scripts/bake/movers.mjs +56 -0
  44. package/scripts/bake/nativeWorld.d.mts +6 -0
  45. package/scripts/bake/nativeWorld.mjs +43 -0
  46. package/scripts/bake/navmeshGround.ts +22 -0
  47. package/scripts/bake/near-placeholder.mjs +331 -0
  48. package/scripts/bake/placeholderShards.mjs +41 -0
  49. package/scripts/bake/skins.mjs +15 -0
  50. package/scripts/bake/template-skins.mjs +33 -0
  51. package/scripts/bake/viewmodelBytes.ts +26 -0
  52. package/scripts/bake/viewmodelPage.ts +11 -0
  53. package/scripts/bake/worldHost.d.mts +35 -0
  54. package/scripts/bake/worldHost.mjs +110 -0
  55. package/scripts/bake-astc6.cache.json +80 -0
  56. package/scripts/bake-astc6.far-reach.cache.json +23 -0
  57. package/scripts/bake-astc6.list.json +111 -0
  58. package/scripts/bake-astc6.mjs +279 -0
  59. package/scripts/bake-astc6.nalati-grasslands.cache.json +42 -0
  60. package/scripts/bake-catalogue.mjs +44 -0
  61. package/scripts/bake-check.mjs +54 -0
  62. package/scripts/bake-chunk.mjs +124 -0
  63. package/scripts/bake-cloud-field.mjs +24 -0
  64. package/scripts/bake-coats.mjs +110 -0
  65. package/scripts/bake-data-maps.d.mts +24 -0
  66. package/scripts/bake-data-maps.mjs +72 -0
  67. package/scripts/bake-entry-programs.mjs +117 -0
  68. package/scripts/bake-geometry.mjs +106 -0
  69. package/scripts/bake-hybrid-tiles.mjs +28 -0
  70. package/scripts/bake-ktx2.cache.json +276 -0
  71. package/scripts/bake-ktx2.list.json +365 -0
  72. package/scripts/bake-ktx2.mjs +477 -0
  73. package/scripts/bake-map-glb.mjs +127 -0
  74. package/scripts/bake-map-rest.d.mts +7 -0
  75. package/scripts/bake-map-rest.mjs +50 -0
  76. package/scripts/bake-maps.mjs +200 -0
  77. package/scripts/bake-navmesh.mjs +259 -0
  78. package/scripts/bake-packs.mjs +129 -0
  79. package/scripts/bake-pickups.mjs +102 -0
  80. package/scripts/bake-query-terrain.mjs +64 -0
  81. package/scripts/bake-recurve-pool.mjs +16 -0
  82. package/scripts/bake-section-schemas.d.mts +3 -0
  83. package/scripts/bake-template-shardfile.mjs +32 -0
  84. package/scripts/bake-textures.mjs +80 -0
  85. package/scripts/bake-viewmodel-sets.json +45 -0
  86. package/scripts/bake-viewmodel-sets.mjs +137 -0
  87. package/scripts/bake-voxel-ao.mjs +119 -0
  88. package/scripts/bake-water-ripples.mjs +25 -0
  89. package/scripts/blender/README.md +129 -0
  90. package/scripts/blender/build.sh +166 -0
  91. package/scripts/blender/lib/export-scene.mjs +129 -0
  92. package/scripts/blender/lib/glb-digest.mjs +188 -0
  93. package/scripts/blender/lib/glb.py +68 -0
  94. package/scripts/blender/lib/save_blend.py +17 -0
  95. package/scripts/blender/lib/world_fixture.py +55 -0
  96. package/scripts/blender/targets.json +591 -0
  97. package/scripts/build-sdk.mjs +95 -0
  98. package/scripts/build-shardfiles.d.mts +7 -0
  99. package/scripts/build-shardfiles.mjs +206 -0
  100. package/scripts/capture-hero.mjs +137 -0
  101. package/scripts/check-lift-review.mjs +23 -0
  102. package/scripts/chromium-keychain-check.mjs +139 -0
  103. package/scripts/chromium-keychain.d.mts +1 -0
  104. package/scripts/chromium-keychain.mjs +5 -0
  105. package/scripts/compile-script.d.mts +3 -0
  106. package/scripts/compile-script.mjs +8 -0
  107. package/scripts/creature-color.mjs +255 -0
  108. package/scripts/decide/calibrate.py +127 -0
  109. package/scripts/decide/calibration/2026-10-03/labels-s1.tsv +281 -0
  110. package/scripts/decide/calibration/2026-10-03/labels-s2.tsv +97 -0
  111. package/scripts/decide/calibration/2026-10-03/labels-s3.tsv +48 -0
  112. package/scripts/decide/calibration/2026-10-03/labels-s3b.tsv +26 -0
  113. package/scripts/decide/calibration/2026-10-03/res-capture-status-v1.jsonl +376 -0
  114. package/scripts/decide/calibration/2026-10-03/res-text-garbled-strings.jsonl +48 -0
  115. package/scripts/decide/calibration/2026-10-03/res-text-garbled-v1.jsonl +73 -0
  116. package/scripts/decide/decide.py +262 -0
  117. package/scripts/decide/decide.sh +50 -0
  118. package/scripts/decide/layer-purity-pilot.mjs +41 -0
  119. package/scripts/decide/sets/capture-status.json +46 -0
  120. package/scripts/decide/sets/layer-purity.json +28 -0
  121. package/scripts/decide/sets/text-garbled.json +17 -0
  122. package/scripts/decide/test_decide.py +37 -0
  123. package/scripts/docs.mjs +15 -0
  124. package/scripts/entry-reads/crawl.ts +152 -0
  125. package/scripts/entry-reads/tsconfig.json +25 -0
  126. package/scripts/gen-format-schema.d.mts +2 -0
  127. package/scripts/gen-format-schema.mjs +21 -0
  128. package/scripts/gen-host-catalogue.d.mts +14 -0
  129. package/scripts/gen-host-catalogue.mjs +108 -0
  130. package/scripts/gen-shard-layout-doc.d.mts +4 -0
  131. package/scripts/gen-shard-layout-doc.mjs +55 -0
  132. package/scripts/gen-shards.d.mts +17 -0
  133. package/scripts/gen-shards.mjs +311 -0
  134. package/scripts/goldens/capture-inputs.d.mts +4 -0
  135. package/scripts/goldens/capture-inputs.mjs +34 -0
  136. package/scripts/goldens/colour_shift.py +27 -0
  137. package/scripts/goldens/native-residency.d.mts +10 -0
  138. package/scripts/goldens/native-residency.mjs +104 -0
  139. package/scripts/goldens/plot-inputs.d.mts +12 -0
  140. package/scripts/goldens/plot-inputs.mjs +46 -0
  141. package/scripts/gpu-texmem.mjs +98 -0
  142. package/scripts/horizon-matte/config.py +24 -0
  143. package/scripts/horizon-matte/encode.py +91 -0
  144. package/scripts/horizon-matte/key.py +141 -0
  145. package/scripts/horizon-matte/mkjobs.py +33 -0
  146. package/scripts/horizon-matte/mkjobs_day2.py +11 -0
  147. package/scripts/horizon-matte/overlap.py +80 -0
  148. package/scripts/horizon-matte/run_codex.py +57 -0
  149. package/scripts/horizon-matte/stitch.py +133 -0
  150. package/scripts/img2mesh/CC0.md +105 -0
  151. package/scripts/img2mesh/README.md +209 -0
  152. package/scripts/img2mesh/ab_board.py +102 -0
  153. package/scripts/img2mesh/birds/birds.json +255 -0
  154. package/scripts/img2mesh/birds/birds_atlas.py +150 -0
  155. package/scripts/img2mesh/birds/birds_fix_preview.mjs +103 -0
  156. package/scripts/img2mesh/birds/birds_fix_render.py +75 -0
  157. package/scripts/img2mesh/birds/birds_pack.py +110 -0
  158. package/scripts/img2mesh/birds/birds_phone_b.py +112 -0
  159. package/scripts/img2mesh/birds/birds_post.py +550 -0
  160. package/scripts/img2mesh/birds/birds_render.py +125 -0
  161. package/scripts/img2mesh/birds/birds_sheet.py +33 -0
  162. package/scripts/img2mesh/birds/birds_view.py +60 -0
  163. package/scripts/img2mesh/board.py +100 -0
  164. package/scripts/img2mesh/build_cc0.sh +52 -0
  165. package/scripts/img2mesh/build_driftwood.sh +12 -0
  166. package/scripts/img2mesh/build_faces.sh +53 -0
  167. package/scripts/img2mesh/build_props.py +81 -0
  168. package/scripts/img2mesh/cc0_export.py +186 -0
  169. package/scripts/img2mesh/driftwood_post.py +571 -0
  170. package/scripts/img2mesh/e304_faces.sh +67 -0
  171. package/scripts/img2mesh/face_remaster.py +911 -0
  172. package/scripts/img2mesh/face_views.py +95 -0
  173. package/scripts/img2mesh/faces-e304.json +9 -0
  174. package/scripts/img2mesh/faces.json +30 -0
  175. package/scripts/img2mesh/head_cut.py +100 -0
  176. package/scripts/img2mesh/hi3d_paint.py +94 -0
  177. package/scripts/img2mesh/hi3d_refine.py +161 -0
  178. package/scripts/img2mesh/hunyuan_cpu_rasterizer.sh +42 -0
  179. package/scripts/img2mesh/pine_hollow_phone.sh +13 -0
  180. package/scripts/img2mesh/props/coral-arch.json +32 -0
  181. package/scripts/img2mesh/props/ember-furnace.json +30 -0
  182. package/scripts/img2mesh/props/night-market-gate.json +10 -0
  183. package/scripts/img2mesh/render_still.py +86 -0
  184. package/scripts/img2mesh/rig_strip.mjs +46 -0
  185. package/scripts/img2mesh/rig_transfer.mjs +104 -0
  186. package/scripts/img2mesh/split_sheet.py +48 -0
  187. package/scripts/img2mesh/trellis_batch.py +110 -0
  188. package/scripts/img2mesh/versus_board.py +114 -0
  189. package/scripts/import-bundle.d.mts +2 -0
  190. package/scripts/import-bundle.mjs +20 -0
  191. package/scripts/ktx2-ab-board.py +133 -0
  192. package/scripts/ktx2-ab.mjs +111 -0
  193. package/scripts/ktx2-settings.mjs +18 -0
  194. package/scripts/land.d.mts +14 -0
  195. package/scripts/land.mjs +809 -0
  196. package/scripts/lint-dispatch.mjs +14 -0
  197. package/scripts/map-bake-frames.d.mts +4 -0
  198. package/scripts/map-bake-frames.mjs +23 -0
  199. package/scripts/map-geometry.d.mts +9 -0
  200. package/scripts/map-geometry.mjs +29 -0
  201. package/scripts/map-world.mjs +162 -0
  202. package/scripts/mockup-local.sh +46 -0
  203. package/scripts/music/export-midi.mjs +68 -0
  204. package/scripts/music/gen/analyze.py +308 -0
  205. package/scripts/music/gen/audio_jobs.py +46 -0
  206. package/scripts/music/gen/briefs.json +51 -0
  207. package/scripts/music/gen/build_page.py +334 -0
  208. package/scripts/music/gen/folk.json +3187 -0
  209. package/scripts/music/gen/gen_ace_step.py +156 -0
  210. package/scripts/music/gen/gen_heartmula.py +187 -0
  211. package/scripts/music/gen/gen_minimax.py +143 -0
  212. package/scripts/music/gen/gen_sao.py +122 -0
  213. package/scripts/music/gen/gen_sao_small.py +104 -0
  214. package/scripts/music/gen/gen_sfx.py +98 -0
  215. package/scripts/music/gen/gen_sfx_ezaudio.py +112 -0
  216. package/scripts/music/gen/gen_sfx_moss.py +112 -0
  217. package/scripts/music/gen/models.json +61 -0
  218. package/scripts/music/gen/nalati-jobs.json +104 -0
  219. package/scripts/music/gen/nalati-score-build.json +119 -0
  220. package/scripts/music/gen/nalati-score.json +3448 -0
  221. package/scripts/music/gen/ob7-fit-decisions.json +38 -0
  222. package/scripts/music/gen/ob7-score-jobs.json +152 -0
  223. package/scripts/music/gen/ob7-sfx-jobs.json +897 -0
  224. package/scripts/music/gen/ob7_build.py +469 -0
  225. package/scripts/music/gen/ob7_generate.py +67 -0
  226. package/scripts/music/gen/ob7_run.sh +42 -0
  227. package/scripts/music/gen/orchestral.json +3187 -0
  228. package/scripts/music/gen/own_score.py +486 -0
  229. package/scripts/music/gen/ph-jobs.json +27 -0
  230. package/scripts/music/gen/ph_page.py +222 -0
  231. package/scripts/music/gen/piano.json +3175 -0
  232. package/scripts/music/gen/rank_v3.py +248 -0
  233. package/scripts/music/gen/sfx-best.json +2486 -0
  234. package/scripts/music/gen/sfx-ezaudio.json +4082 -0
  235. package/scripts/music/gen/sfx-jobs.json +57 -0
  236. package/scripts/music/gen/sfx-minimax-jobs.json +16 -0
  237. package/scripts/music/gen/sfx-minimax.json +289 -0
  238. package/scripts/music/gen/sfx-moss.json +4082 -0
  239. package/scripts/music/gen/sfx-nalati-b3-jobs.json +17 -0
  240. package/scripts/music/gen/sfx-nalati-jobs.json +338 -0
  241. package/scripts/music/gen/sfx-nalati.json +11202 -0
  242. package/scripts/music/gen/sfx-nd-jobs.json +57 -0
  243. package/scripts/music/gen/sfx-nd-moss.json +2097 -0
  244. package/scripts/music/gen/sfx-nd-sa3-medium.json +2097 -0
  245. package/scripts/music/gen/sfx-nd-summary.json +38 -0
  246. package/scripts/music/gen/sfx-peaks.json +7 -0
  247. package/scripts/music/gen/sfx-ph-jobs.json +169 -0
  248. package/scripts/music/gen/sfx-ph-moss.json +6564 -0
  249. package/scripts/music/gen/sfx-ph-sa3-medium.json +7239 -0
  250. package/scripts/music/gen/sfx-ph-summary.json +63 -0
  251. package/scripts/music/gen/sfx-sa3-medium.json +4082 -0
  252. package/scripts/music/gen/sfx-sa3.json +4082 -0
  253. package/scripts/music/gen/sfx-summary.json +107 -0
  254. package/scripts/music/gen/sfx_build.py +332 -0
  255. package/scripts/music/gen/sfx_merge.py +255 -0
  256. package/scripts/music/gen/sfx_minimax.py +61 -0
  257. package/scripts/music/gen/sfx_nalati.py +331 -0
  258. package/scripts/music/gen/sfx_sprite.py +424 -0
  259. package/scripts/music/gen/stems.py +539 -0
  260. package/scripts/music/gen/test_loop_meter.py +29 -0
  261. package/scripts/music/gen/test_ob7_provenance.py +77 -0
  262. package/scripts/music/gen/v3-folk-build.json +148 -0
  263. package/scripts/music/gen/v3-folk.json +1818 -0
  264. package/scripts/music/gen/v3-jobs.json +145 -0
  265. package/scripts/music/gen/v3-orchestral-build.json +148 -0
  266. package/scripts/music/gen/v3-orchestral.json +1813 -0
  267. package/scripts/music/gen/v3-ph-folk-build.json +94 -0
  268. package/scripts/music/gen/v3-ph-folk.json +1806 -0
  269. package/scripts/music/gen/v3-ph-orchestral-build.json +94 -0
  270. package/scripts/music/gen/v3-ph-orchestral.json +1824 -0
  271. package/scripts/music/gen/v3-ph-piano-build.json +94 -0
  272. package/scripts/music/gen/v3-ph-piano.json +1818 -0
  273. package/scripts/music/gen/v3-piano-build.json +148 -0
  274. package/scripts/music/gen/v3-piano.json +1813 -0
  275. package/scripts/music/wildshard-theme.mid +0 -0
  276. package/scripts/music/wildshard-trailer30.mid +0 -0
  277. package/scripts/named-blob-output.d.mts +8 -0
  278. package/scripts/named-blob-output.mjs +48 -0
  279. package/scripts/pack-all.mjs +15 -0
  280. package/scripts/pid-lock.d.mts +1 -0
  281. package/scripts/pid-lock.mjs +63 -0
  282. package/scripts/practice/bake_dummy.py +53 -0
  283. package/scripts/practice/build_dummies.sh +43 -0
  284. package/scripts/practice/dummy_parts.py +568 -0
  285. package/scripts/practice/dummy_rig_gate.py +139 -0
  286. package/scripts/practice/gate_sheet.py +36 -0
  287. package/scripts/practice/generate_dummy_unimate.py +132 -0
  288. package/scripts/practice/pack_dummy.mjs +59 -0
  289. package/scripts/practice/repair_dummy_weights.mjs +68 -0
  290. package/scripts/practice/rig_dummy.py +828 -0
  291. package/scripts/practice/verify_unimate_skin.mjs +356 -0
  292. package/scripts/preparation-seed.mjs +15 -0
  293. package/scripts/prepare-basis-tool.mjs +6 -0
  294. package/scripts/prepare-product.d.mts +14 -0
  295. package/scripts/prepare-product.mjs +101 -0
  296. package/scripts/product-build-tools.d.mts +3 -0
  297. package/scripts/product-build-tools.json +3 -0
  298. package/scripts/product-build-tools.mjs +31 -0
  299. package/scripts/publish-public.mjs +7 -0
  300. package/scripts/push-tables.d.mts +1 -0
  301. package/scripts/push-tables.mjs +28 -0
  302. package/scripts/record-shard-mounts.mjs +133 -0
  303. package/scripts/sdk-externals.d.mts +2 -0
  304. package/scripts/sdk-externals.mjs +2 -0
  305. package/scripts/section-inventory.ts +209 -0
  306. package/scripts/select-candidate.mjs +15 -0
  307. package/scripts/shard-build-pool.d.mts +4 -0
  308. package/scripts/shard-build-pool.mjs +53 -0
  309. package/scripts/shard-line-baseline.json +17 -0
  310. package/scripts/shard-milestones.d.mts +15 -0
  311. package/scripts/shard-milestones.mjs +105 -0
  312. package/scripts/shard-output-report.d.mts +9 -0
  313. package/scripts/shard-output-report.mjs +85 -0
  314. package/scripts/shard-platform-cli.mjs +93 -0
  315. package/scripts/shard-progress.mjs +212 -0
  316. package/scripts/shard-timelapse.py +102 -0
  317. package/scripts/shardfile-cold-boot.mjs +79 -0
  318. package/scripts/shardfile-vite.d.mts +4 -0
  319. package/scripts/shardfile-vite.mjs +20 -0
  320. package/scripts/simplify-models.mjs +24 -0
  321. package/scripts/site-facts.mjs +88 -0
  322. package/scripts/test-template-gate.mjs +44 -0
  323. package/scripts/test_golden_compare.py +68 -0
  324. package/scripts/tex-tiers.cache.json +181 -0
  325. package/scripts/tex-tiers.mjs +240 -0
  326. package/scripts/texmem-probe.mjs +184 -0
  327. package/scripts/unused-assets.mjs +173 -0
  328. package/scripts/vite-tmp.d.mts +23 -0
  329. package/scripts/vite-tmp.mjs +157 -0
  330. package/scripts/wave-line-baselines.json +32 -0
  331. package/scripts/wildshard.d.mts +4 -0
  332. package/scripts/wildshard.mjs +105 -0
  333. package/scripts/witness-checkpoints.d.mts +10 -0
  334. package/scripts/witness-checkpoints.mjs +84 -0
  335. package/scripts/witness-generation.d.mts +10 -0
  336. package/scripts/witness-generation.mjs +45 -0
  337. package/scripts/witness-manifests.d.mts +8 -0
  338. package/scripts/witness-manifests.mjs +157 -0
  339. package/scripts/worktree-ignore.d.mts +4 -0
  340. package/scripts/worktree-ignore.mjs +36 -0
  341. package/scripts/worktree-reap.mjs +214 -0
  342. package/scripts/worktree.mjs +396 -0
  343. package/scripts/worldclaw/capture-front.sh +28 -0
  344. package/scripts/worldclaw/design-template.md +62 -0
  345. package/scripts/worldclaw/spec-map.py +92 -0
  346. package/scripts/worldclaw/spec.ts +96 -0
  347. package/skills/wildshard/SKILL.md +50 -0
  348. package/skills/wildshard-goldens/SKILL.md +54 -0
  349. package/skills/wildshard-mockup-to-model/SKILL.md +56 -0
  350. package/skills/wildshard-upgrade/SKILL.md +46 -0
  351. package/src/.oxfmtrc.json +50 -0
  352. package/src/.oxlintrc.json +173 -0
  353. package/src/cli/account/account.ts +199 -0
  354. package/src/cli/account/command.ts +193 -0
  355. package/src/cli/account/key.ts +154 -0
  356. package/src/cli/args.ts +97 -0
  357. package/src/cli/audio/audio.ts +24 -0
  358. package/src/cli/bin.mjs +8 -0
  359. package/src/cli/delete/delete.ts +258 -0
  360. package/src/cli/help.ts +196 -0
  361. package/src/cli/hero/adopt.ts +103 -0
  362. package/src/cli/hero/hero.ts +112 -0
  363. package/src/cli/hero/stamp.ts +298 -0
  364. package/src/cli/main.ts +292 -0
  365. package/src/cli/report.ts +16 -0
  366. package/src/cli/shardfile/command.ts +50 -0
  367. package/src/cli/shardfile/shardfile.ts +192 -0
  368. package/src/cli/upload/api.ts +246 -0
  369. package/src/cli/upload/compress.ts +55 -0
  370. package/src/cli/upload/hero.ts +62 -0
  371. package/src/cli/upload/placement.ts +115 -0
  372. package/src/cli/upload/provenance.ts +192 -0
  373. package/src/cli/upload/signature.ts +30 -0
  374. package/src/cli/upload/upload.ts +269 -0
  375. package/src/cli/upload/validate.ts +74 -0
  376. package/src/cli/upload/wire.ts +147 -0
  377. package/src/cli/version.ts +63 -0
  378. package/src/commons/bake/portableMath.ts +187 -0
  379. package/src/commons/catalogue.ts +10 -0
  380. package/src/commons/courseProgram.ts +32 -0
  381. package/src/commons/practiceCourse.ts +16 -0
  382. package/src/commons/scripts/abi.as +14 -0
  383. package/src/commons/scripts/bridge.as +14 -0
  384. package/src/commons/scripts/course.as +63 -0
  385. package/src/scripts/ask-new.sh +29 -0
  386. package/src/scripts/asks.mjs +141 -0
  387. package/src/scripts/herdr-prompt.sh +34 -0
  388. package/src/scripts/herdr-question-open.sh +67 -0
  389. package/src/scripts/md-wrap.mjs +229 -0
  390. package/src/server/app.ts +19 -0
  391. package/src/server/serve.ts +49 -0
  392. package/src/sharddev/admission.ts +7 -0
  393. package/src/sharddev/arenaView.ts +15 -0
  394. package/src/sharddev/as/groupBankV2.ts +36 -0
  395. package/src/sharddev/as/groupStepV2.ts +13 -0
  396. package/src/sharddev/as/ws.ts +30 -0
  397. package/src/sharddev/as/wsV2.ts +180 -0
  398. package/src/sharddev/assemblyscriptCompiler.d.mts +5 -0
  399. package/src/sharddev/assemblyscriptCompiler.mjs +14 -0
  400. package/src/sharddev/assetHandle.ts +84 -0
  401. package/src/sharddev/assetOwner.ts +70 -0
  402. package/src/sharddev/assetScope.ts +30 -0
  403. package/src/sharddev/assets.ts +21 -0
  404. package/src/sharddev/audio.ts +9 -0
  405. package/src/sharddev/audioEncode.ts +211 -0
  406. package/src/sharddev/author.ts +3 -0
  407. package/src/sharddev/authorError.ts +28 -0
  408. package/src/sharddev/authorManifest.ts +39 -0
  409. package/src/sharddev/bake/annulus.ts +19 -0
  410. package/src/sharddev/bake/assemblyscriptMemo.ts +76 -0
  411. package/src/sharddev/bake/assemblyscriptMemoPort.ts +4 -0
  412. package/src/sharddev/bake/authoredWorld.ts +201 -0
  413. package/src/sharddev/bake/basisEncoder.ts +95 -0
  414. package/src/sharddev/bake/basisGlb.ts +85 -0
  415. package/src/sharddev/bake/basisTool.ts +74 -0
  416. package/src/sharddev/bake/basisToolInputs.ts +476 -0
  417. package/src/sharddev/bake/byteCodec.ts +33 -0
  418. package/src/sharddev/bake/canvasAtlas.ts +406 -0
  419. package/src/sharddev/bake/coarseCopy.ts +59 -0
  420. package/src/sharddev/bake/colliders.ts +87 -0
  421. package/src/sharddev/bake/compactGlb.ts +224 -0
  422. package/src/sharddev/bake/compileScript.ts +119 -0
  423. package/src/sharddev/bake/compileScriptV2.ts +75 -0
  424. package/src/sharddev/bake/contactRows.ts +84 -0
  425. package/src/sharddev/bake/creaturePlacement.ts +117 -0
  426. package/src/sharddev/bake/export.ts +67 -0
  427. package/src/sharddev/bake/facetedGeometry.ts +379 -0
  428. package/src/sharddev/bake/farImpostor.ts +120 -0
  429. package/src/sharddev/bake/forest.ts +100 -0
  430. package/src/sharddev/bake/format-hook.mjs +2 -0
  431. package/src/sharddev/bake/generatorGlb.ts +23 -0
  432. package/src/sharddev/bake/geometryBounds.ts +77 -0
  433. package/src/sharddev/bake/geometryError.ts +48 -0
  434. package/src/sharddev/bake/glb.ts +355 -0
  435. package/src/sharddev/bake/glbCompression.ts +143 -0
  436. package/src/sharddev/bake/gltfSource.ts +59 -0
  437. package/src/sharddev/bake/groundMap.ts +142 -0
  438. package/src/sharddev/bake/image.ts +20 -0
  439. package/src/sharddev/bake/isleMap.ts +64 -0
  440. package/src/sharddev/bake/json.mjs +84 -0
  441. package/src/sharddev/bake/keyedSky.ts +47 -0
  442. package/src/sharddev/bake/keyedSkyMemo.ts +39 -0
  443. package/src/sharddev/bake/kinds.ts +137 -0
  444. package/src/sharddev/bake/lightSources.ts +31 -0
  445. package/src/sharddev/bake/mapAssembly.ts +84 -0
  446. package/src/sharddev/bake/mapRaster.ts +173 -0
  447. package/src/sharddev/bake/mapRest.ts +57 -0
  448. package/src/sharddev/bake/mapScenes.ts +234 -0
  449. package/src/sharddev/bake/materialGraph.ts +32 -0
  450. package/src/sharddev/bake/meadow.ts +27 -0
  451. package/src/sharddev/bake/meshoptChoiceMemo.ts +34 -0
  452. package/src/sharddev/bake/nativeInteractionFacts.ts +5 -0
  453. package/src/sharddev/bake/nativeLattice.ts +178 -0
  454. package/src/sharddev/bake/nativeRaster.ts +106 -0
  455. package/src/sharddev/bake/nativeTerrainField.ts +11 -0
  456. package/src/sharddev/bake/navigation-json.mjs +38 -0
  457. package/src/sharddev/bake/navigation.ts +113 -0
  458. package/src/sharddev/bake/navigationAsset.ts +18 -0
  459. package/src/sharddev/bake/nearPlaceholder.ts +206 -0
  460. package/src/sharddev/bake/normalizeRig.ts +80 -0
  461. package/src/sharddev/bake/phoneAstc.ts +93 -0
  462. package/src/sharddev/bake/placeholders.ts +581 -0
  463. package/src/sharddev/bake/placement.ts +80 -0
  464. package/src/sharddev/bake/portableBytes.ts +18 -0
  465. package/src/sharddev/bake/portableBytesMemo.ts +50 -0
  466. package/src/sharddev/bake/practiceCourse.ts +49 -0
  467. package/src/sharddev/bake/primitives.ts +96 -0
  468. package/src/sharddev/bake/props.ts +443 -0
  469. package/src/sharddev/bake/questPlacement.ts +98 -0
  470. package/src/sharddev/bake/rawTexture.ts +26 -0
  471. package/src/sharddev/bake/riderArms.ts +97 -0
  472. package/src/sharddev/bake/rig.ts +95 -0
  473. package/src/sharddev/bake/riggedHullRecipes.ts +40 -0
  474. package/src/sharddev/bake/signPlacements.ts +25 -0
  475. package/src/sharddev/bake/simplifier.ts +52 -0
  476. package/src/sharddev/bake/skinned.ts +312 -0
  477. package/src/sharddev/bake/slabChunks.ts +149 -0
  478. package/src/sharddev/bake/slabs.ts +263 -0
  479. package/src/sharddev/bake/source-loader.mjs +55 -0
  480. package/src/sharddev/bake/sourceMetadata.ts +54 -0
  481. package/src/sharddev/bake/species.ts +368 -0
  482. package/src/sharddev/bake/specimenCatalogue.ts +47 -0
  483. package/src/sharddev/bake/splatGround.ts +141 -0
  484. package/src/sharddev/bake/staticMaterials.ts +171 -0
  485. package/src/sharddev/bake/terrain.ts +195 -0
  486. package/src/sharddev/bake/texture.ts +33 -0
  487. package/src/sharddev/bake/textureWasm.ts +81 -0
  488. package/src/sharddev/bake/tileEncoder.ts +11 -0
  489. package/src/sharddev/bake/tileGrid.ts +62 -0
  490. package/src/sharddev/bake/v2Finite.ts +160 -0
  491. package/src/sharddev/bake/v2Fuel.ts +71 -0
  492. package/src/sharddev/bake/wholePartition.ts +74 -0
  493. package/src/sharddev/bake/wholePieceJoin.ts +147 -0
  494. package/src/sharddev/bake/world.ts +173 -0
  495. package/src/sharddev/bake/worldCollision.ts +128 -0
  496. package/src/sharddev/bake/worldGeometry.ts +237 -0
  497. package/src/sharddev/bake/worldGlb.ts +123 -0
  498. package/src/sharddev/bake/worldImage.ts +12 -0
  499. package/src/sharddev/bake/worldLod.ts +128 -0
  500. package/src/sharddev/bake/worldRows.ts +102 -0
  501. package/src/sharddev/bake/worldTextureMemo.ts +63 -0
  502. package/src/sharddev/bake/zstdBytesMemo.ts +52 -0
  503. package/src/sharddev/bake.ts +193 -0
  504. package/src/sharddev/bakePublication.ts +31 -0
  505. package/src/sharddev/behaviourSource.ts +94 -0
  506. package/src/sharddev/bin/wildshard.mjs +7 -0
  507. package/src/sharddev/blobBytes.ts +65 -0
  508. package/src/sharddev/blobs.ts +138 -0
  509. package/src/sharddev/bootInventory.ts +129 -0
  510. package/src/sharddev/bossProfiles.ts +18 -0
  511. package/src/sharddev/buildBehaviour.ts +77 -0
  512. package/src/sharddev/buildCacheMetrics.ts +17 -0
  513. package/src/sharddev/buildDecisionScripts.ts +122 -0
  514. package/src/sharddev/check.ts +117 -0
  515. package/src/sharddev/checkProject.ts +126 -0
  516. package/src/sharddev/cli.ts +191 -0
  517. package/src/sharddev/clientChannels.ts +169 -0
  518. package/src/sharddev/clientScripts.ts +10 -0
  519. package/src/sharddev/commons.ts +77 -0
  520. package/src/sharddev/commonsCosts.ts +11 -0
  521. package/src/sharddev/compileMovers.ts +11 -0
  522. package/src/sharddev/configBoundary.ts +6 -0
  523. package/src/sharddev/cookInput.ts +40 -0
  524. package/src/sharddev/crowds.ts +6 -0
  525. package/src/sharddev/decisionBindingMap.ts +11 -0
  526. package/src/sharddev/decisionScriptBindings.ts +117 -0
  527. package/src/sharddev/decisionScripts.ts +28 -0
  528. package/src/sharddev/decisionSource.ts +51 -0
  529. package/src/sharddev/dev.ts +113 -0
  530. package/src/sharddev/director.ts +26 -0
  531. package/src/sharddev/directorAbi.ts +77 -0
  532. package/src/sharddev/discoveryDocument.ts +97 -0
  533. package/src/sharddev/draft.ts +11 -0
  534. package/src/sharddev/eliteEntryRows.ts +29 -0
  535. package/src/sharddev/entries.ts +76 -0
  536. package/src/sharddev/entryReads.ts +73 -0
  537. package/src/sharddev/executeBundle.ts +55 -0
  538. package/src/sharddev/finds.ts +5 -0
  539. package/src/sharddev/formatJsonSchema.ts +3 -0
  540. package/src/sharddev/generationCache.ts +257 -0
  541. package/src/sharddev/generationRecipe.ts +94 -0
  542. package/src/sharddev/handwritten.ts +110 -0
  543. package/src/sharddev/immutable.ts +14 -0
  544. package/src/sharddev/interactions.ts +38 -0
  545. package/src/sharddev/kit/bakedGeometry.ts +16 -0
  546. package/src/sharddev/kit/geometryPack.ts +110 -0
  547. package/src/sharddev/ledger.ts +13 -0
  548. package/src/sharddev/looks/tileField.ts +67 -0
  549. package/src/sharddev/materialGraphFiles.ts +57 -0
  550. package/src/sharddev/materials.ts +574 -0
  551. package/src/sharddev/measure.ts +18 -0
  552. package/src/sharddev/modes.ts +115 -0
  553. package/src/sharddev/moverPrograms.ts +213 -0
  554. package/src/sharddev/movers.ts +75 -0
  555. package/src/sharddev/nativePopulationRows.ts +46 -0
  556. package/src/sharddev/newProject.ts +247 -0
  557. package/src/sharddev/noise.ts +54 -0
  558. package/src/sharddev/outputProduct.ts +188 -0
  559. package/src/sharddev/outputRuntime.ts +66 -0
  560. package/src/sharddev/performancePolicy.ts +18 -0
  561. package/src/sharddev/phasedBoss.ts +34 -0
  562. package/src/sharddev/physics.ts +194 -0
  563. package/src/sharddev/platformSections.ts +42 -0
  564. package/src/sharddev/plumbing.ts +8 -0
  565. package/src/sharddev/productOutput.ts +128 -0
  566. package/src/sharddev/project.ts +337 -0
  567. package/src/sharddev/projectCompilerIdentity.ts +94 -0
  568. package/src/sharddev/projectDecisions.ts +66 -0
  569. package/src/sharddev/projectEntryProof.ts +32 -0
  570. package/src/sharddev/projectGeneration.ts +219 -0
  571. package/src/sharddev/projectInputFiles.ts +47 -0
  572. package/src/sharddev/projectManifest.ts +108 -0
  573. package/src/sharddev/projectMap.ts +35 -0
  574. package/src/sharddev/projectOutput.ts +242 -0
  575. package/src/sharddev/projectPolicy.ts +17 -0
  576. package/src/sharddev/projectSections.ts +27 -0
  577. package/src/sharddev/questGraph.ts +25 -0
  578. package/src/sharddev/quests.ts +65 -0
  579. package/src/sharddev/random.ts +61 -0
  580. package/src/sharddev/refusals.ts +234 -0
  581. package/src/sharddev/reportCard.ts +13 -0
  582. package/src/sharddev/returnProjectionV2.ts +81 -0
  583. package/src/sharddev/rows.ts +192 -0
  584. package/src/sharddev/runtimeImports.ts +38 -0
  585. package/src/sharddev/runtimeMirrors.ts +39 -0
  586. package/src/sharddev/runtimePerformance.ts +38 -0
  587. package/src/sharddev/scene.ts +321 -0
  588. package/src/sharddev/sceneAnimation.ts +54 -0
  589. package/src/sharddev/sceneAudio.ts +64 -0
  590. package/src/sharddev/sceneDeclarations.ts +100 -0
  591. package/src/sharddev/sceneGraph.ts +139 -0
  592. package/src/sharddev/sceneTransform.ts +12 -0
  593. package/src/sharddev/schemaValidation.ts +61 -0
  594. package/src/sharddev/sections.ts +47 -0
  595. package/src/sharddev/shardSource.ts +59 -0
  596. package/src/sharddev/sourceReader.ts +26 -0
  597. package/src/sharddev/spawns.ts +38 -0
  598. package/src/sharddev/species/clips.ts +24 -0
  599. package/src/sharddev/species.ts +29 -0
  600. package/src/sharddev/speciesBrains.ts +19 -0
  601. package/src/sharddev/synth.ts +66 -0
  602. package/src/sharddev/test/compileDualScriptV2.ts +71 -0
  603. package/src/sharddev/test/compileSimV2.ts +21 -0
  604. package/src/sharddev/test/diskScriptScenario.ts +86 -0
  605. package/src/sharddev/test/scriptScenario.ts +249 -0
  606. package/src/sharddev/test/scriptSource.ts +12 -0
  607. package/src/sharddev/version.ts +4 -0
  608. package/src/sharddev/weapons/bowProfile.ts +20 -0
  609. package/src/sharddev/weapons/firearmRows.ts +11 -0
  610. package/src/sharddev/weapons/meleeProfile.ts +71 -0
  611. package/src/sharddev/weapons/thrownProfile.ts +10 -0
  612. package/src/sharddev/worldScenes.ts +308 -0
  613. package/src/sharddev/worldSource.ts +82 -0
  614. package/src/shards/_template/README.md +78 -0
  615. package/src/shards/_template/assets/2bf489fdb15f1734ddb4c4f32d500ec6da85c765ec7a4eb28dc6781160e7ec8c +0 -0
  616. package/src/shards/_template/assets/97ec4d8f75f5fa6239ee919444d6dc19fd35896bb305930c1f050ac6e0e0e6a6 +1 -0
  617. package/src/shards/_template/assets/a6a587a31327f936b1b04c05ade818c73fc8964260918662db43539465e27586 +0 -0
  618. package/src/shards/_template/assets/b4fbde0422e125b498c3dc8b9a5cc2516c8598f09e9d0e5f6b639b32f98179e6 +0 -0
  619. package/src/shards/_template/assets/bfa4dfc9c18979f904557ee8deab0058b8a399be10266f5fb1578b403f482fd4 +1 -0
  620. package/src/shards/_template/assets/ef3b7ff4fd22715771cb7d68a3977a903c5e7c3dc293542687d04b3ef3ace2cb +0 -0
  621. package/src/shards/_template/assets/f2db05998615ce1cb79ea96be32c168842eb6a2b34ec01feb86d36404603ee54 +0 -0
  622. package/src/shards/_template/assets/fef98ebb7fce6f66b26e78ac699e5c90f9bdcfaf8cabeb2b58125347eea8b4ab +0 -0
  623. package/src/shards/_template/behaviour/boss.as +39 -0
  624. package/src/shards/_template/behaviour/door.as +32 -0
  625. package/src/shards/_template/behaviour/hooks.json +129 -0
  626. package/src/shards/_template/behaviour/idle.as +75 -0
  627. package/src/shards/_template/behaviour/items.as +22 -0
  628. package/src/shards/_template/card/landscape.jpg +0 -0
  629. package/src/shards/_template/card/portrait.jpg +0 -0
  630. package/src/shards/_template/card/thumb.jpg +0 -0
  631. package/src/shards/_template/data/audio.json +45 -0
  632. package/src/shards/_template/data/bossDecision.json +83 -0
  633. package/src/shards/_template/data/budgets.json +70 -0
  634. package/src/shards/_template/data/card.json +281 -0
  635. package/src/shards/_template/data/clientScripts.json +987 -0
  636. package/src/shards/_template/data/creatures.json +65 -0
  637. package/src/shards/_template/data/director.json +39 -0
  638. package/src/shards/_template/data/encounters.json +96 -0
  639. package/src/shards/_template/data/items.json +172 -0
  640. package/src/shards/_template/data/layout.json +66 -0
  641. package/src/shards/_template/data/ledger.json +32 -0
  642. package/src/shards/_template/data/look.json +521 -0
  643. package/src/shards/_template/data/map.json +64 -0
  644. package/src/shards/_template/data/moves.json +16 -0
  645. package/src/shards/_template/data/placeholder.json +8 -0
  646. package/src/shards/_template/data/plumbing.json +32 -0
  647. package/src/shards/_template/data/quests.json +223 -0
  648. package/src/shards/_template/data/rows.json +423 -0
  649. package/src/shards/_template/data/skins.json +66 -0
  650. package/src/shards/_template/data/spawn.json +6 -0
  651. package/src/shards/_template/data/targets.json +150 -0
  652. package/src/shards/_template/data/text.json +12 -0
  653. package/src/shards/_template/data/ui.json +33 -0
  654. package/src/shards/_template/data/water.json +13 -0
  655. package/src/shards/_template/generators/behaviour.ts +34 -0
  656. package/src/shards/_template/generators/boss.ts +29 -0
  657. package/src/shards/_template/generators/buildOptions.ts +2 -0
  658. package/src/shards/_template/generators/cell.ts +224 -0
  659. package/src/shards/_template/generators/districts.ts +215 -0
  660. package/src/shards/_template/generators/farLook.ts +15 -0
  661. package/src/shards/_template/generators/generate.ts +27 -0
  662. package/src/shards/_template/generators/ground.ts +15 -0
  663. package/src/shards/_template/generators/kit.ts +69 -0
  664. package/src/shards/_template/generators/landscape.ts +59 -0
  665. package/src/shards/_template/generators/landscapeNoise.ts +62 -0
  666. package/src/shards/_template/generators/mapInputs.ts +10 -0
  667. package/src/shards/_template/generators/product.ts +100 -0
  668. package/src/shards/_template/generators/productOutput.ts +18 -0
  669. package/src/shards/_template/generators/props.ts +9 -0
  670. package/src/shards/_template/generators/templatePropsSource.ts +58 -0
  671. package/src/shards/_template/generators/terrain.ts +17 -0
  672. package/src/shards/_template/generators/world.ts +630 -0
  673. package/src/shards/_template/hero.json +10 -0
  674. package/src/shards/_template/look/entry-reads.json +20 -0
  675. package/src/shards/_template/manifest.json +281 -0
  676. package/src/shards/_template/shard.config.ts +10 -0
  677. package/src/shared/health.ts +10 -0
  678. package/src/tools/build-web.ts +59 -0
  679. package/src/tsconfig.json +30 -0
  680. package/src/web/app.tsx +53 -0
  681. package/src/web/index.html +12 -0
  682. package/src/web/main.tsx +10 -0
  683. package/src/web/tsconfig.json +13 -0
  684. package/tsconfig.author.json +23 -0
  685. package/tsconfig.commons.json +21 -0
  686. package/tsconfig.json +47 -0
  687. package/tsconfig.sharddev.json +20 -0
@@ -0,0 +1,34 @@
1
+ // oxlint-disable-next-line import/no-nodejs-modules -- The build-only memo keys the exact comparison by content.
2
+ import { createHash, randomBytes } from 'node:crypto';
3
+ // oxlint-disable-next-line import/no-nodejs-modules -- The memo lives in the CI-cached gen root, outside the product.
4
+ import { mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from 'node:fs';
5
+ // oxlint-disable-next-line import/no-nodejs-modules -- The default memo root is the user's cache folder.
6
+ import { homedir } from 'node:os';
7
+ // oxlint-disable-next-line import/no-nodejs-modules -- Memo paths are joined, never read from input.
8
+ import { resolve } from 'node:path';
9
+ import { meshoptNoLarger } from '../blobs';
10
+
11
+ const sha = (bytes: string | Uint8Array): string => createHash('sha256').update(bytes).digest('hex');
12
+ // CI6: the two level-9 gzips that choose a meshopt GLB (nameMeshoptBlob) are most of its cost (Driftwood's foliage batches:
13
+ // ~0.5 s of its product worker) and their inputs rarely change. The answer depends only on the two byte arrays and the
14
+ // gzip, so the key is both arrays' hashes, Node, zlib, platform and the comparison's own source; a damaged entry recomputes.
15
+ const codec = sha(JSON.stringify({ schema: 'meshopt-choice/1', node: process.version, zlib: process.versions.zlib, platform: process.platform,
16
+ arch: process.arch, level: 9, implementation: meshoptNoLarger.toString() }));
17
+
18
+ /** `meshoptNoLarger` with an exact memo in the gen cache: the same answer for the same packed and source bytes; a missing,
19
+ * corrupt or unwritable memo runs the comparison. */
20
+ export async function meshoptNoLargerMemo(packed: Uint8Array, input: Uint8Array): Promise<boolean> {
21
+ const memoRoot = process.env['WILDSHARD_MESHOPT_CHOICE_CACHE'] ?? resolve(homedir(), '.cache/wildshard/gen/meshopt-choice/1');
22
+ const key = sha(`${codec}\0${sha(packed)}\0${sha(input)}`), file = resolve(memoRoot, `${key}.json`);
23
+ try {
24
+ const saved: unknown = JSON.parse(readFileSync(file, 'utf8'));
25
+ if (typeof saved === 'object' && saved !== null && 'key' in saved && saved.key === key && 'packed' in saved && typeof saved.packed === 'boolean') return saved.packed;
26
+ } catch { /* no memo yet, or a damaged one: compare */ }
27
+ const answer = await meshoptNoLarger(packed, input), temporary = `${file}.${process.pid}.${randomBytes(8).toString('hex')}.tmp`;
28
+ try {
29
+ mkdirSync(memoRoot, { recursive: true });
30
+ writeFileSync(temporary, JSON.stringify({ key, packed: answer }), { flag: 'wx' }); renameSync(temporary, file);
31
+ } catch { /* the memo is optional: storage never changes the build */ }
32
+ finally { try { rmSync(temporary, { force: true }); } catch { /* own temporary only */ } }
33
+ return answer;
34
+ }
@@ -0,0 +1,5 @@
1
+ import { BARREL_BODY } from '@wildshard/engine/world/interact/barrel';
2
+
3
+ /** The defining native puzzle barrel's complete physical declaration, without
4
+ * constructing a body, watch, query or live interaction owner. */
5
+ export function puzzleBarrelBody(): typeof BARREL_BODY { return BARREL_BODY; }
@@ -0,0 +1,178 @@
1
+ /** A native vertex channel. Values are interpolated linearly at cuts, without renormalising normals or splat weights. */
2
+ export interface NativeLatticeAttribute { itemSize: number; values: Float32Array | Float64Array }
3
+ /** Exact native terrain mesh, including its original diagonal, holes and vertex channels. Collision is not rebuilt here. */
4
+ export interface NativeLatticeSource {
5
+ resolution: 256 | 257;
6
+ positions: Float32Array | Float64Array;
7
+ indices: Uint32Array;
8
+ attributes: Readonly<Record<string, NativeLatticeAttribute>>;
9
+ }
10
+ /** Render-only tile geometry. Original vertices retain their values; new boundary vertices lie on original triangles. */
11
+ export interface NativeLatticeTile {
12
+ lod: 0 | 1; x: number; z: number; size: 62.5 | 125;
13
+ positions: Float64Array; indices: Uint32Array;
14
+ attributes: Record<string, { itemSize: number; values: Float64Array }>;
15
+ bounds: { min: [number, number, number]; max: [number, number, number] };
16
+ }
17
+ interface Vertex { readonly values: readonly number[] }
18
+ interface Chunk {
19
+ positions: number[]; indices: number[]; attributes: number[][]; vertices: Map<string, number>;
20
+ // Vertex tuples are owned here and never changed after construction.
21
+ heads: Map<number, number>; links: number[]; tuples: (readonly number[])[]; strings: boolean;
22
+ sample: Float64Array; words: Uint32Array;
23
+ }
24
+ const HALF = 250;
25
+ const nativeResolution = (value: number): boolean => value === 256 || value === 257;
26
+ const tileLod = (value: number): boolean => value === 0 || value === 1;
27
+
28
+ function channels(source: NativeLatticeSource): [string, NativeLatticeAttribute][] {
29
+ const vertices = source.resolution ** 2;
30
+ if (!nativeResolution(source.resolution) || source.positions.length !== vertices * 3 || !(source.positions instanceof Float32Array || source.positions instanceof Float64Array)
31
+ || !(source.indices instanceof Uint32Array) || source.indices.length % 3 !== 0 || source.indices.length > (source.resolution - 1) ** 2 * 6 || source.indices.some(i => i >= vertices)) throw new Error('Native lattice requires its bounded original 256/257 mesh');
32
+ if (source.positions.some(value => !Number.isFinite(value) || Math.abs(value) > HALF)) throw new Error('Native lattice outside finite cell bounds');
33
+ const entries = Object.entries(source.attributes).sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0);
34
+ if (entries.length > 16 || entries.reduce((n, [, channel]) => n + channel.itemSize, 0) > 64) throw new Error('Native lattice attribute cap');
35
+ for (const [name, channel] of entries) {
36
+ if (!/^[a-zA-Z][a-zA-Z0-9_]{0,63}$/.test(name) || name === 'position' || !Number.isInteger(channel.itemSize) || channel.itemSize < 1 || channel.itemSize > 4
37
+ || !(channel.values instanceof Float32Array || channel.values instanceof Float64Array) || channel.values.length !== vertices * channel.itemSize || channel.values.some(value => !Number.isFinite(value))) throw new Error(`Invalid native lattice attribute ${name}`);
38
+ }
39
+ return entries;
40
+ }
41
+ function vertex(source: NativeLatticeSource, entries: readonly [string, NativeLatticeAttribute][], index: number): Vertex {
42
+ const values: number[] = Array.from(source.positions.subarray(index * 3, index * 3 + 3));
43
+ for (const [, channel] of entries) for (const value of channel.values.subarray(index * channel.itemSize, (index + 1) * channel.itemSize)) values.push(value);
44
+ return { values };
45
+ }
46
+ function component(point: Vertex, axis: number): number {
47
+ const value = point.values[axis];
48
+ if (value === undefined) throw new Error('Native lattice vertex is incomplete');
49
+ return value;
50
+ }
51
+ function intersection(a: Vertex, b: Vertex, axis: number, boundary: number): Vertex {
52
+ // Canonical endpoint order makes both sides of a shared edge compute the same floating-point result.
53
+ const [start, end] = component(a, axis) < component(b, axis) ? [a, b] : [b, a];
54
+ if (component(start, axis) === boundary) return start;
55
+ if (component(end, axis) === boundary) return end;
56
+ const t = (boundary - component(start, axis)) / (component(end, axis) - component(start, axis));
57
+ const values = start.values.map((value, i) => value + (component(end, i) - value) * t);
58
+ values[axis] = boundary;
59
+ return { values };
60
+ }
61
+ function clip(input: readonly Vertex[], axis: number, boundary: number, greater: boolean): Vertex[] {
62
+ const output: Vertex[] = [];
63
+ for (let i = 0; i < input.length; i++) {
64
+ const a = input[i], b = input[(i + 1) % input.length];
65
+ if (a === undefined || b === undefined) continue;
66
+ const insideA = greater ? component(a, axis) >= boundary : component(a, axis) <= boundary;
67
+ const insideB = greater ? component(b, axis) >= boundary : component(b, axis) <= boundary;
68
+ if (insideA) output.push(a);
69
+ if (insideA !== insideB) output.push(intersection(a, b, axis, boundary));
70
+ }
71
+ return output;
72
+ }
73
+ function areaSquared(a: Vertex, b: Vertex, c: Vertex): number {
74
+ const ux = component(b, 0) - component(a, 0), uy = component(b, 1) - component(a, 1), uz = component(b, 2) - component(a, 2);
75
+ const vx = component(c, 0) - component(a, 0), vy = component(c, 1) - component(a, 1), vz = component(c, 2) - component(a, 2);
76
+ return (uy * vz - uz * vy) ** 2 + (uz * vx - ux * vz) ** 2 + (ux * vy - uy * vx) ** 2;
77
+ }
78
+ function vertexKey(values: readonly number[]): string { return values.map(n => Object.is(n, -0) ? '-0' : String(n)).join('/'); }
79
+ function vertexHash(chunk: Chunk, values: readonly number[]): number | undefined {
80
+ if (values.length < 3) return undefined;
81
+ const { sample, words } = chunk;
82
+ let hash = 2166136261;
83
+ for (const value of values) {
84
+ if (typeof value !== 'number') return undefined;
85
+ if (value === (value | 0) && !Object.is(value, -0)) hash = Math.imul(hash ^ value, 16777619);
86
+ else if (Number.isNaN(value)) { hash = Math.imul(hash, 16777619); hash = Math.imul(hash ^ 0x7ff80000, 16777619); }
87
+ else {
88
+ sample[0] = value;
89
+ hash = Math.imul(hash ^ (words[0] ?? 0), 16777619);
90
+ hash = Math.imul(hash ^ (words[1] ?? 0), 16777619);
91
+ }
92
+ }
93
+ hash = Math.imul(hash ^ (hash >>> 16), 0x85ebca6b);
94
+ hash = Math.imul(hash ^ (hash >>> 13), 0xc2b2ae35);
95
+ return (hash ^ (hash >>> 16)) >>> 0;
96
+ }
97
+ function sameVertex(previous: readonly number[] | undefined, values: readonly number[]): boolean {
98
+ if (previous === undefined || previous.length !== values.length) return false;
99
+ for (let k = 0; k < values.length; k++) if (!Object.is(previous[k], values[k])) return false;
100
+ return true;
101
+ }
102
+ function stringVertices(chunk: Chunk): void {
103
+ chunk.strings = true; chunk.heads.clear(); chunk.links.length = 0;
104
+ for (let index = 0; index < chunk.tuples.length; index++) chunk.vertices.set(vertexKey(chunk.tuples[index] ?? []), index);
105
+ chunk.tuples.length = 0;
106
+ }
107
+
108
+ function add(chunk: Chunk, value: Vertex, entries: readonly [string, NativeLatticeAttribute][]): number {
109
+ let existing: number | undefined, hash = 0, key = '';
110
+ if (!chunk.strings) {
111
+ const found = vertexHash(chunk, value.values);
112
+ if (found === undefined) stringVertices(chunk);
113
+ else {
114
+ hash = found;
115
+ let candidate = chunk.heads.get(hash), visited = 0;
116
+ while (candidate !== undefined && candidate >= 0) {
117
+ if (sameVertex(chunk.tuples[candidate], value.values)) { existing = candidate; break; }
118
+ // Keep adversarial lookup bounded by returning to the complete original map.
119
+ if (++visited >= 16) { stringVertices(chunk); break; }
120
+ candidate = chunk.links[candidate];
121
+ }
122
+ }
123
+ }
124
+ if (chunk.strings) { key = vertexKey(value.values); existing = chunk.vertices.get(key); }
125
+ if (existing !== undefined) return existing;
126
+ const index = chunk.positions.length / 3;
127
+ if (chunk.strings) chunk.vertices.set(key, index);
128
+ else { chunk.tuples[index] = value.values; chunk.links[index] = chunk.heads.get(hash) ?? -1; chunk.heads.set(hash, index); }
129
+ chunk.positions.push(...value.values.slice(0, 3));
130
+ let offset = 3;
131
+ entries.forEach(([, channel], i) => {
132
+ const target = chunk.attributes[i];
133
+ if (target === undefined) throw new Error('Native lattice attribute output missing');
134
+ target.push(...value.values.slice(offset, offset + channel.itemSize)); offset += channel.itemSize;
135
+ });
136
+ return index;
137
+ }
138
+
139
+ /** Clip original native triangles into the 62.5 m L0 or 125 m L1 grid, preserving every declared vertex channel.
140
+ * This performs no sampling or simplification. L1 initially retains native geometry; later LOD tools must report
141
+ * their actual error. Pass the source's real indices (including terrain cuts), never a reconstructed diagonal.
142
+ * Empty tiles are retained. The caller keeps the original native collision bake as the simulation authority.
143
+ */
144
+ export function sliceNativeLattice(source: NativeLatticeSource, lod: 0 | 1): NativeLatticeTile[] {
145
+ if (!tileLod(lod)) throw new Error('Native lattice LOD must be 0 or 1');
146
+ const entries = channels(source), count = lod === 0 ? 8 : 4, size = lod === 0 ? 62.5 : 125;
147
+ const sample = new Float64Array(1), words = new Uint32Array(sample.buffer);
148
+ const chunks: Chunk[] = Array.from({ length: count ** 2 }, () => ({ positions: [], indices: [], attributes: entries.map(() => []), vertices: new Map(), heads: new Map<number, number>(), links: [], tuples: [], strings: false, sample, words }));
149
+ const address = (value: number): number => Math.min(count - 1, Math.floor((value + HALF) / size));
150
+ for (let i = 0; i < source.indices.length; i += 3) {
151
+ const ia = source.indices[i], ib = source.indices[i + 1], ic = source.indices[i + 2];
152
+ if (ia === undefined || ib === undefined || ic === undefined) throw new Error('Native lattice triangle missing');
153
+ const a = vertex(source, entries, ia), b = vertex(source, entries, ib), c = vertex(source, entries, ic);
154
+ if (areaSquared(a, b, c) === 0) throw new Error('Native lattice source has a degenerate triangle');
155
+ for (const axis of [0, 2]) if (Math.max(component(a, axis), component(b, axis), component(c, axis)) - Math.min(component(a, axis), component(b, axis), component(c, axis)) > 500 / (source.resolution - 1) + 0.0001) throw new Error('Native lattice triangle spans more than one source cell');
156
+ const x0 = address(Math.min(component(a, 0), component(b, 0), component(c, 0))), x1 = address(Math.max(component(a, 0), component(b, 0), component(c, 0)));
157
+ const z0 = address(Math.min(component(a, 2), component(b, 2), component(c, 2))), z1 = address(Math.max(component(a, 2), component(b, 2), component(c, 2)));
158
+ for (let z = z0; z <= z1; z++) for (let x = x0; x <= x1; x++) {
159
+ let polygon = [a, b, c];
160
+ for (const [axis, boundary, greater] of [[0, -HALF + x * size, true], [0, -HALF + (x + 1) * size, false], [2, -HALF + z * size, true], [2, -HALF + (z + 1) * size, false]] as const) polygon = clip(polygon, axis, boundary, greater);
161
+ const chunk = chunks[z * count + x];
162
+ if (chunk === undefined) throw new Error('Native lattice tile missing');
163
+ for (let j = 1; j + 1 < polygon.length; j++) {
164
+ const pa = polygon[0], pb = polygon[j], pc = polygon[j + 1];
165
+ if (pa === undefined || pb === undefined || pc === undefined || areaSquared(pa, pb, pc) === 0) continue;
166
+ chunk.indices.push(add(chunk, pa, entries), add(chunk, pb, entries), add(chunk, pc, entries));
167
+ }
168
+ }
169
+ }
170
+ return chunks.map((chunk, i) => {
171
+ const x = i % count, z = Math.floor(i / count), minY = chunk.positions.reduce((min, value, at) => at % 3 === 1 ? Math.min(min, value) : min, Infinity);
172
+ const maxY = chunk.positions.reduce((max, value, at) => at % 3 === 1 ? Math.max(max, value) : max, -Infinity);
173
+ const attributes: NativeLatticeTile['attributes'] = {};
174
+ entries.forEach(([name, channel], at) => { attributes[name] = { itemSize: channel.itemSize, values: Float64Array.from(chunk.attributes[at] ?? []) }; });
175
+ return { lod, x, z, size, positions: Float64Array.from(chunk.positions), indices: Uint32Array.from(chunk.indices), attributes,
176
+ bounds: { min: [-HALF + x * size, chunk.indices.length === 0 ? 0 : minY, -HALF + z * size], max: [-HALF + (x + 1) * size, chunk.indices.length === 0 ? 0 : maxY, -HALF + (z + 1) * size] } };
177
+ });
178
+ }
@@ -0,0 +1,106 @@
1
+ import { KEYCHAIN_ARGS } from '../../../scripts/chromium-keychain.mjs';
2
+ import { build } from 'vite';
3
+ // oxlint-disable-next-line import/no-nodejs-modules -- The explicit author bundler converts file URLs on its native host.
4
+ import { fileURLToPath } from 'node:url';
5
+ import { devices, webkit, chromium, type BrowserContextOptions, type Page } from 'playwright';
6
+
7
+ /** Setup operations required from a native reference page. */
8
+ export interface NativeRasterPage {
9
+ readonly setContent: (html: string) => Promise<unknown>;
10
+ readonly addScriptTag: (input: { content: string; type?: string }) => Promise<unknown>;
11
+ }
12
+ /** Explicit author browser factory; alternate hosts preserve the same setup and cleanup contract. */
13
+ export interface NativeRasterHost<P extends NativeRasterPage> {
14
+ readonly launch: (options: { headless: true; args?: string[] }) => Promise<{
15
+ readonly newContext: (options: BrowserContextOptions | undefined) => Promise<{ readonly newPage: () => Promise<P> }>;
16
+ readonly close: () => Promise<void>;
17
+ }>;
18
+ }
19
+ /** A native author reference page; the caller holds browser-lane and owns its finite lifetime. */
20
+ export interface NativeRasterSession<P extends NativeRasterPage = Page> {
21
+ readonly page: P;
22
+ readonly dispose: () => Promise<void>;
23
+ }
24
+ /** A bundled painter and its original document. Module tags are opt-in, as for native addScriptTag. */
25
+ export interface NativeRasterInput {
26
+ readonly html: string;
27
+ readonly source: string;
28
+ readonly module?: boolean;
29
+ }
30
+
31
+ const nativeHost: NativeRasterHost<Page> = { launch: options => webkit.launch(options) };
32
+ const chromiumHost: NativeRasterHost<Page> = { launch: options => chromium.launch({ ...options, args: [...KEYCHAIN_ARGS, ...(options.args ?? [])] }) };
33
+
34
+ /** An author page whose routes and document preparation remain caller-owned. */
35
+ export interface NativeRasterBrowserInput {
36
+ readonly engine: 'webkit' | 'chromium';
37
+ readonly args?: readonly string[];
38
+ }
39
+
40
+ /** Open the original phone author context before the caller installs routes or navigates.
41
+ * Caller holds browser-lane; browser flags are copied before launch and setup refusals close partial resources. */
42
+ export function openNativeRasterPage(input: NativeRasterBrowserInput): Promise<NativeRasterSession>;
43
+ /** Use an explicit author host with the same profile, flag ownership and cleanup. */
44
+ export function openNativeRasterPage<P extends NativeRasterPage>(input: NativeRasterBrowserInput, host: NativeRasterHost<P>): Promise<NativeRasterSession<P>>;
45
+ export function openNativeRasterPage<P extends NativeRasterPage>(input: NativeRasterBrowserInput, host?: NativeRasterHost<P>): Promise<NativeRasterSession<P> | NativeRasterSession> {
46
+ return host === undefined ? openRasterPage(input.engine === 'chromium' ? chromiumHost : nativeHost, input.args) : openRasterPage(host, input.args);
47
+ }
48
+
49
+ async function openRasterPage<P extends NativeRasterPage>(host: NativeRasterHost<P>, args?: readonly string[]): Promise<NativeRasterSession<P>> {
50
+ const options = { headless: true as const, ...(args === undefined ? {} : { args: [...args] }) };
51
+ const browser = await host.launch(options);
52
+ try {
53
+ const context = await browser.newContext(devices['iPhone 16 Pro']);
54
+ const page = await context.newPage();
55
+ return { page, dispose: () => browser.close() };
56
+ } catch (error) {
57
+ await browser.close();
58
+ throw error;
59
+ }
60
+ }
61
+
62
+ /** Open the existing phone WebKit reference raster without installing a page/game service.
63
+ * Snapshot input before yielding; release the browser if any preparation step refuses. */
64
+ export function openNativeRaster(input: NativeRasterInput): Promise<NativeRasterSession>;
65
+ /** Open an explicitly supplied author host with the same page lifetime. */
66
+ export function openNativeRaster<P extends NativeRasterPage>(input: NativeRasterInput, host: NativeRasterHost<P>): Promise<NativeRasterSession<P>>;
67
+ export function openNativeRaster<P extends NativeRasterPage>(input: NativeRasterInput, host?: NativeRasterHost<P>): Promise<NativeRasterSession<P> | NativeRasterSession> {
68
+ return host === undefined ? prepareNativeRaster(input, nativeHost) : prepareNativeRaster(input, host);
69
+ }
70
+
71
+ async function prepareNativeRaster<P extends NativeRasterPage>(input: NativeRasterInput, host: NativeRasterHost<P>): Promise<NativeRasterSession<P>> {
72
+ const { html, source, module } = input;
73
+ const session = await openRasterPage(host);
74
+ try {
75
+ const { page } = session;
76
+ await page.setContent(html);
77
+ await page.addScriptTag(module === true ? { type: 'module', content: source } : { content: source });
78
+ return session;
79
+ } catch (error) {
80
+ await session.dispose();
81
+ throw error;
82
+ }
83
+ }
84
+
85
+ /** Explicit native-reference bundle settings; painters and publication remain caller-owned. */
86
+ export interface NativeRasterBundle {
87
+ readonly root: string | URL;
88
+ readonly entry: string | URL;
89
+ readonly format: 'es' | 'iife';
90
+ readonly name?: string;
91
+ readonly fileName?: string;
92
+ readonly discardModuleSideEffects?: boolean;
93
+ }
94
+
95
+ /** Bundle one native reference page with the original offline target and split policy.
96
+ * Missing code stays undefined so the author retains its defining refusal. No Vite plugin is installed. */
97
+ export async function bundleNativeRaster(input: NativeRasterBundle): Promise<string | undefined> {
98
+ const { format, name, fileName, discardModuleSideEffects } = input;
99
+ const root = typeof input.root === 'string' ? input.root : fileURLToPath(input.root);
100
+ const entry = typeof input.entry === 'string' ? input.entry : fileURLToPath(input.entry);
101
+ const result = await build({ configFile: false, logLevel: 'silent', publicDir: false, root,
102
+ build: { write: false, target: 'esnext', minify: false,
103
+ lib: { entry, formats: [format], ...(name === undefined ? {} : { name }), ...(fileName === undefined ? {} : { fileName }) },
104
+ rolldownOptions: { ...(discardModuleSideEffects === true ? { treeshake: { moduleSideEffects: false } } : {}), output: { codeSplitting: false } } } });
105
+ return (Array.isArray(result) ? result : [result]).flatMap(bundle => 'output' in bundle ? bundle.output : []).find(chunk => chunk.type === 'chunk')?.code;
106
+ }
@@ -0,0 +1,11 @@
1
+ import { buildTerrain } from '@wildshard/engine/world/terrainField';
2
+ import { CHUNK_HALF, ROAD_WIDTH, ROAD_LENGTH } from '@wildshard/engine/core/config';
3
+
4
+ /** Mandatory native cell/entry-road dimensions used by the field compiler. */
5
+ export function terrainFieldPolicy(): { readonly half: number; readonly roadWidth: typeof ROAD_WIDTH; readonly roadLength: typeof ROAD_LENGTH } {
6
+ return { half: CHUNK_HALF, roadWidth: ROAD_WIDTH, roadLength: ROAD_LENGTH };
7
+ }
8
+
9
+ /** Compile the complete closure-based native author field, including entry roads,
10
+ * trails, graded shelves, pads and water metadata. No runtime owner is installed. */
11
+ export function createTerrainField(...args: Parameters<typeof buildTerrain>): ReturnType<typeof buildTerrain> { return buildTerrain(...args); }
@@ -0,0 +1,38 @@
1
+ // Emit a declared navigation asset through an explicit shard-owned bake function. I/O stays in the SDK driver.
2
+ // oxlint-disable-next-line import/no-nodejs-modules -- The isolated SDK build driver owns navigation file I/O.
3
+ import { lstatSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
4
+ // oxlint-disable-next-line import/no-nodejs-modules -- Confine source and output paths to the author tree.
5
+ import { dirname, isAbsolute, resolve, sep } from 'node:path';
6
+ // oxlint-disable-next-line import/no-nodejs-modules -- Load the explicit shard authoring function.
7
+ import { pathToFileURL } from 'node:url';
8
+ // oxlint-disable-next-line import/no-nodejs-modules -- Read explicit producer arguments.
9
+ import process from 'node:process';
10
+ import { parseNavigation, readNavigation } from '@wildshard/format/navigation';
11
+ import { hashImmutableBytes } from '../immutable';
12
+
13
+ const entry = process.argv.at(2), input = process.argv.at(3), output = process.argv.at(4), assets = process.argv.at(5);
14
+ if (process.argv.length !== 6 || entry === undefined || input === undefined || output === undefined || assets === undefined) throw new Error('Navigation driver requires entry, source bytes, metadata and asset folder');
15
+ const root = process.cwd(), owner = /^src\/shards\/([^/]+)\/generators\//u.exec(entry)?.[1];
16
+ if (owner === undefined) throw new Error('Navigation entry requires a shard-owned generator');
17
+ /** Confine every driver path to regular source/output paths in the isolated authoring tree. @param {string} path */
18
+ function confined(path) {
19
+ if (isAbsolute(path) || path.includes('\\') || path.split('/').some(part => part === '' || part === '.' || part === '..')) throw new Error('Navigation driver path escapes the author tree');
20
+ const parts = path.split('/');
21
+ for (let length = 1; length <= parts.length; length++) {
22
+ try { if (lstatSync(resolve(root, ...parts.slice(0, length))).isSymbolicLink()) throw new Error('Navigation driver symlink refused'); }
23
+ catch (error) { if (!(error instanceof Error && 'code' in error && error.code === 'ENOENT')) throw error; }
24
+ }
25
+ const result = resolve(root, path); if (!result.startsWith(root + sep)) throw new Error('Navigation driver path escapes'); return result;
26
+ }
27
+ const author = await import(pathToFileURL(confined(entry)).href);
28
+ if (typeof author.navigationProduct !== 'function') throw new Error('Navigation author function missing');
29
+ const original = new Uint8Array(readFileSync(confined(input)));
30
+ const result = author.navigationProduct(original), navigation = parseNavigation(result.shardfile.navigation);
31
+ readNavigation(navigation, original);
32
+ if (hashImmutableBytes(original) !== navigation.file || !(result.assets instanceof Map) || result.assets.size !== 1) throw new Error('Navigation author must preserve original immutable bytes');
33
+ const bytes = result.assets.get(navigation.file);
34
+ if (!(bytes instanceof Uint8Array) || hashImmutableBytes(bytes) !== navigation.file) throw new Error('Navigation author changed bytes');
35
+ const metadata = confined(output), folder = confined(assets);
36
+ mkdirSync(dirname(metadata), { recursive: true }); mkdirSync(folder, { recursive: true });
37
+ writeFileSync(metadata, `${JSON.stringify({ navigation, url: `/assets/baked/${owner}/navmesh.bin`, files: result.shardfile.files, critical: result.shardfile.critical })}\n`);
38
+ writeFileSync(resolve(folder, navigation.file), bytes);
@@ -0,0 +1,113 @@
1
+ import type { NavMesh } from 'navcat';
2
+ import { generateTiledNavMesh } from 'navcat/blocks';
3
+
4
+ /** World-space triangles, in authored order and with upward walkable faces. No runtime datum is applied here. */
5
+ export interface NavigationSoup { positions: ArrayLike<number>; indices: ArrayLike<number> }
6
+ /** One agent's clearance and slope, in metres and degrees; the layer name is metadata only. */
7
+ export interface NavigationLayer { name: string; radius: number; height: number; climb: number; slope: number }
8
+ /** Explicit recast settings. maxEdgeLength is in metres, matching the retained native baker. */
9
+ export interface NavigationSettings {
10
+ cellSize: number; cellHeight: number; tileSizeVoxels: number;
11
+ minRegionArea: number; mergeRegionArea: number; maxSimplificationError: number;
12
+ maxEdgeLength: number; maxVerticesPerPoly: number;
13
+ detailSampleDistance: number; detailSampleMaxError: number;
14
+ }
15
+ /** Counts from the exact serialized tiles; omitted detail fans are rebuilt by the runtime reader. */
16
+ export interface NavigationLayerStats {
17
+ tiles: number; polys: number; verts: number; detailVerts: number; detailTris: number;
18
+ }
19
+ /** Complete WSNM v1 bytes and the corresponding ordered layer metadata. */
20
+ export interface BakedNavigation {
21
+ version: 1; bytes: Uint8Array; layers: (NavigationLayer & NavigationLayerStats)[];
22
+ }
23
+ const VERSION = 1, Q = 100, NEI_EXT = 248;
24
+
25
+ function component(values: ArrayLike<number>, index: number): number {
26
+ const value = values[index];
27
+ if (value === undefined) throw new Error('bake-navmesh: incomplete vertex');
28
+ return value;
29
+ }
30
+
31
+ function generate(soup: NavigationSoup, layer: NavigationLayer, GEN: NavigationSettings): NavMesh {
32
+ const { cellSize, cellHeight, tileSizeVoxels } = GEN;
33
+ const walkableRadiusVoxels = Math.max(1, Math.round(layer.radius / cellSize));
34
+ const opts = {
35
+ cellSize, cellHeight, tileSizeVoxels, tileSizeWorld: tileSizeVoxels * cellSize,
36
+ walkableRadiusVoxels, walkableRadiusWorld: layer.radius,
37
+ walkableClimbVoxels: Math.floor(layer.climb / cellHeight + 1e-6), walkableClimbWorld: layer.climb,
38
+ walkableHeightVoxels: Math.ceil(layer.height / cellHeight - 1e-6), walkableHeightWorld: layer.height,
39
+ walkableSlopeAngleDegrees: layer.slope, borderSize: walkableRadiusVoxels + 3,
40
+ minRegionArea: GEN.minRegionArea, mergeRegionArea: GEN.mergeRegionArea, maxSimplificationError: GEN.maxSimplificationError,
41
+ maxEdgeLength: Math.round(GEN.maxEdgeLength / cellSize), maxVerticesPerPoly: GEN.maxVerticesPerPoly,
42
+ detailSampleDistance: GEN.detailSampleDistance, detailSampleMaxError: GEN.detailSampleMaxError,
43
+ };
44
+ return generateTiledNavMesh({ positions: soup.positions, indices: soup.indices }, opts).navMesh;
45
+ }
46
+
47
+ // ── the file ─────────────────────────────────────────────────────────────────────────────────────────────────────────
48
+ class Writer {
49
+ buf = new DataView(new ArrayBuffer(1 << 20)); at = 0;
50
+ room(n: number): void { if (this.at + n <= this.buf.byteLength) return; const next = new DataView(new ArrayBuffer(Math.max(this.buf.byteLength * 2, this.at + n))); new Uint8Array(next.buffer).set(new Uint8Array(this.buf.buffer, 0, this.at)); this.buf = next; }
51
+ u8(...vs: number[]): void { this.room(vs.length); for (const v of vs) { if (!(v >= 0 && v <= 0xff)) throw new Error(`bake-navmesh: ${v} is not a u8`); this.buf.setUint8(this.at++, v); } }
52
+ u16(...vs: number[]): void { this.room(vs.length * 2); for (const v of vs) { if (!(v >= 0 && v <= 0xffff)) throw new Error(`bake-navmesh: ${v} is not a u16`); this.buf.setUint16(this.at, v, true); this.at += 2; } }
53
+ u32(...vs: number[]): void { this.room(vs.length * 4); for (const v of vs) { this.buf.setUint32(this.at, v, true); this.at += 4; } }
54
+ i32(...vs: number[]): void { this.room(vs.length * 4); for (const v of vs) { this.buf.setInt32(this.at, v, true); this.at += 4; } }
55
+ f32(...vs: number[]): void { this.room(vs.length * 4); for (const v of vs) { this.buf.setFloat32(this.at, v, true); this.at += 4; } }
56
+ bytes(): Uint8Array { return new Uint8Array(this.buf.buffer, 0, this.at); }
57
+ }
58
+
59
+ /** `v` in `step`s above `min`, which must land on the grid (recast's vertices are voxel corners). */
60
+ function onGrid(v: number, min: number, step: number): number {
61
+ const q = Math.round((v - min) / step);
62
+ if (Math.abs(min + q * step - v) > 1e-3) throw new Error(`bake-navmesh: vertex ${v} is off the ${step} m grid from ${min}`);
63
+ return q;
64
+ }
65
+
66
+ function writeLayer(w: Writer, layer: NavigationLayer, nav: NavMesh, GEN: NavigationSettings): NavigationLayerStats {
67
+ const tiles = Object.values(nav.tiles);
68
+ const { cellSize: cs, cellHeight: ch } = GEN;
69
+ w.f32(layer.radius, layer.height, layer.climb, cs, ch, ...nav.origin, nav.tileWidth);
70
+ w.u32(tiles.length);
71
+ const stats = { tiles: tiles.length, polys: 0, verts: 0, detailVerts: 0, detailTris: 0 };
72
+ for (const t of tiles) {
73
+ const b = t.bounds, nv = t.vertices.length / 3, nd = t.detailVertices.length / 3;
74
+ w.i32(t.tileX, t.tileY); w.f32(...b); w.u16(nv, t.polys.length, nd);
75
+ const V = t.vertices;
76
+ for (let i = 0; i < nv; i++) w.u8(onGrid(component(V, i * 3), b[0], cs));
77
+ for (let i = 0; i < nv; i++) w.u8(onGrid(component(V, i * 3 + 2), b[2], cs));
78
+ for (let i = 0; i < nv; i++) w.u16(onGrid(component(V, i * 3 + 1), b[1], ch));
79
+ w.u8(...t.polys.map((p) => p.vertices.length)); w.u8(...t.polys.map((p) => p.area)); w.u8(...t.polys.map((p) => p.flags));
80
+ const idx = t.polys.flatMap((p) => p.vertices);
81
+ if (nv <= 256) w.u8(...idx); else w.u16(...idx);
82
+ // neighbours: 0 none, i + 1 poly i of this tile, 0x8000 | side a portal to the next tile — one byte when the tile allows
83
+ const neis = t.polys.flatMap((p) => p.neis);
84
+ if (t.polys.length < NEI_EXT) w.u8(...neis.map((n) => (n & 0x8000 ? NEI_EXT + (n & 0xff) : n))); else w.u16(...neis);
85
+ // the detail mesh only where recast added height samples; a poly without is fanned from its own vertices at load
86
+ const keep: boolean[] = [];
87
+ let vb = 0, tb = 0;
88
+ for (const m of t.detailMeshes) {
89
+ if (m.verticesBase !== vb || m.trianglesBase !== tb) throw new Error('bake-navmesh: detail meshes are not in poly order');
90
+ vb += m.verticesCount; tb += m.trianglesCount;
91
+ keep.push(m.verticesCount > 0);
92
+ }
93
+ w.u8(...t.detailMeshes.map((m) => m.verticesCount)); w.u8(...t.detailMeshes.map((m, i) => (keep[i] ? m.trianglesCount : 0)));
94
+ const D = t.detailVertices;
95
+ for (let i = 0; i < D.length; i++) w.u16(Math.round((component(D, i) - component(b, i % 3)) * Q));
96
+ let kept = 0;
97
+ t.detailMeshes.forEach((m, i) => { if (keep[i]) { w.u8(...t.detailTriangles.slice(m.trianglesBase * 4, (m.trianglesBase + m.trianglesCount) * 4)); kept += m.trianglesCount; } });
98
+ stats.polys += t.polys.length; stats.verts += nv; stats.detailVerts += nd; stats.detailTris += kept;
99
+ }
100
+ return stats;
101
+ }
102
+
103
+
104
+ /** Compile authored triangles to the existing WSNM v1 transport, without a renderer or game services.
105
+ * Preserve triangle, layer and tile insertion order. The caller owns collider collection, wet-ground exclusion
106
+ * and authored-frame datum. This compiler does not turn a runtime capture into an author-only producer.
107
+ */
108
+ export function bakeNavigation(soup: NavigationSoup, layers: readonly NavigationLayer[], settings: NavigationSettings): BakedNavigation {
109
+ const writer = new Writer();
110
+ writer.u8(0x57, 0x53, 0x4e, 0x4d); writer.u32(VERSION, layers.length);
111
+ const rows = layers.map(layer => ({ ...layer, ...writeLayer(writer, layer, generate(soup, layer, settings), settings) }));
112
+ return { version: VERSION, bytes: writer.bytes(), layers: rows };
113
+ }
@@ -0,0 +1,18 @@
1
+ import { describeNavigation, type Navigation } from '@wildshard/format/navigation';
2
+ import { navigationCost } from '@wildshard/format/navigationBytes';
3
+ import { hashImmutableBytes } from '../immutable';
4
+ /** Declare original navigation bytes as platform content; no navcat compilation or byte transform. */
5
+ export function declareNavigation(bytes: Uint8Array): { navigation: Navigation; files: { hash: string; kind: 'binary'; compressed: number; decoded: number; gpu: number; triangles: number; draws: number; dependencies: string[]; critical: boolean }[]; critical: string[]; assets: Map<string, Uint8Array> } {
6
+ const hash = hashImmutableBytes(bytes), cost = navigationCost(bytes);
7
+ return { navigation: describeNavigation(hash, bytes), files: [{ hash, kind: 'binary', compressed: bytes.length, ...cost, dependencies: [], critical: true }],
8
+ critical: [hash], assets: new Map([[hash, Uint8Array.from(bytes)]]) };
9
+ }
10
+
11
+ /** Original navigation discovery transport. The platform owns its conventional public URL. */
12
+ export function navigationSourceRows(bytes: Uint8Array, slug: string): {
13
+ navigation: Navigation; url: string; files: ReturnType<typeof declareNavigation>['files']; critical: string[];
14
+ } {
15
+ if (!/^[a-z0-9]+(?:-[a-z0-9]+)*$/u.test(slug)) throw new Error('Invalid navigation owner');
16
+ const rows = declareNavigation(bytes);
17
+ return { navigation: rows.navigation, url: `/assets/baked/${slug}/navmesh.bin`, files: rows.files, critical: rows.critical };
18
+ }