@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,194 @@
1
+ import { BufferGeometry, Matrix4, Object3D, Quaternion, Vector3 } from 'three';
2
+ import { updateAuthoringMatrix } from './sceneTransform';
3
+ /** Authored contact material; the compiler writes this tag without installing a physics service. */
4
+ export type Surface = 'wood' | 'stone' | 'grass' | 'sand' | 'rock' | 'metal' | 'earth' | 'felt';
5
+ /** JSON-only position in metres. */
6
+ export interface ColliderPoint {
7
+ x: number;
8
+ y: number;
9
+ z: number;
10
+ }
11
+ /** JSON-only unit quaternion, using three.js axis and component conventions. */
12
+ export interface ColliderRotation {
13
+ x: number;
14
+ y: number;
15
+ z: number;
16
+ w: number;
17
+ }
18
+ interface Placed extends ColliderPoint {
19
+ rot?: ColliderRotation;
20
+ surface?: Surface;
21
+ }
22
+ /** An existing authored box row, including its optional yaw or quaternion representation. */
23
+ export interface BoxColliderData extends Placed {
24
+ kind: 'box';
25
+ hx: number;
26
+ hy: number;
27
+ hz: number;
28
+ yaw?: number;
29
+ }
30
+ /** Build-time collider description. Geometry arrays are plain data, never Rapier handles. */
31
+ export type ColliderData = BoxColliderData | Placed & {
32
+ kind: 'capsule';
33
+ halfHeight: number;
34
+ radius: number;
35
+ } | Placed & {
36
+ kind: 'hull';
37
+ points: number[];
38
+ } | Placed & {
39
+ kind: 'trimesh';
40
+ vertices: number[];
41
+ indices: number[];
42
+ };
43
+ function positive(...values: number[]): void {
44
+ if (values.some(value => !Number.isFinite(value) || value <= 0))
45
+ throw new Error('Collider dimensions must be finite and positive');
46
+ }
47
+ /** A physics declaration in an ordinary three.js scene. Name the object for its stable authoring identity. */
48
+ export abstract class Collider extends Object3D {
49
+ /** Optional contact tag; undefined leaves the host default unchanged. */
50
+ surface: Surface | undefined;
51
+ protected constructor(surface?: Surface) { super(); this.surface = surface; }
52
+ /** Copy authoring tags with the ordinary three.js transform and children. */
53
+ override copy(source: this, recursive = true): this { super.copy(source, recursive); this.surface = source.surface; return this; }
54
+ /** Read the actual world transform, rejecting shear and reflected or collapsed axes. */
55
+ protected placement(): {
56
+ placed: Placed;
57
+ scale: Vector3;
58
+ } {
59
+ updateAuthoringMatrix(this);
60
+ const position = new Vector3(), rotation = new Quaternion(), scale = new Vector3();
61
+ this.matrixWorld.decompose(position, rotation, scale);
62
+ if (this.matrixAutoUpdate && (this.parent === null || this.parent.matrixWorld.equals(new Matrix4()))) {
63
+ rotation.copy(this.quaternion);
64
+ scale.copy(this.scale);
65
+ }
66
+ const composed = new Matrix4().compose(position, rotation, scale);
67
+ if (this.matrixWorld.elements.some((value, index) => !Number.isFinite(value) || Math.abs(value - (composed.elements[index] ?? Infinity)) > 1e-8))
68
+ throw new Error('Collider requires a finite, unsheared transform');
69
+ positive(scale.x, scale.y, scale.z);
70
+ if (Math.abs(rotation.lengthSq() - 1) > 1e-8)
71
+ throw new Error('Collider requires a unit rotation');
72
+ return { placed: { x: position.x, y: position.y, z: position.z,
73
+ ...(rotation.x === 0 && rotation.y === 0 && rotation.z === 0 && rotation.w === 1 ? {} : { rot: { x: rotation.x, y: rotation.y, z: rotation.z, w: rotation.w } }),
74
+ ...(this.surface === undefined ? {} : { surface: this.surface }) }, scale };
75
+ }
76
+ /** Emit one transformed collider, without changing the scene or its geometry. */
77
+ abstract toColliderData(): ColliderData;
78
+ }
79
+ /** Box dimensions are full width, height and depth, like three.js BoxGeometry. */
80
+ export class BoxCollider extends Collider {
81
+ private rotationEncoding: 'auto' | 'yaw' | 'quaternion' = 'auto';
82
+ /** Full authored dimensions in metres. */
83
+ width: number;
84
+ /** Full authored dimensions in metres. */
85
+ height: number;
86
+ /** Full authored dimensions in metres. */
87
+ depth: number;
88
+ constructor(width = 1, height = 1, depth = 1, surface?: Surface) {
89
+ super(surface);
90
+ positive(width, height, depth);
91
+ this.width = width; this.height = height; this.depth = depth;
92
+ }
93
+ /** Adopt an existing authoring row as a real Object3D, retaining its rotation encoding for byte-stable migration. */
94
+ static fromData(row: BoxColliderData): BoxCollider {
95
+ if (row.rot !== undefined && row.yaw !== undefined)
96
+ throw new Error('Box cannot declare both yaw and quaternion');
97
+ const collider = new BoxCollider(row.hx * 2, row.hy * 2, row.hz * 2, row.surface);
98
+ collider.position.set(row.x, row.y, row.z);
99
+ if (row.rot !== undefined) {
100
+ collider.quaternion.set(row.rot.x, row.rot.y, row.rot.z, row.rot.w);
101
+ collider.rotationEncoding = 'quaternion';
102
+ }
103
+ else if (row.yaw !== undefined) {
104
+ collider.rotation.y = row.yaw;
105
+ collider.rotationEncoding = 'yaw';
106
+ }
107
+ return collider;
108
+ }
109
+ /** Clone the same dimensions, tag and hierarchy, like a three.js Mesh. */
110
+ override copy(source: this, recursive = true): this { super.copy(source, recursive); this.width = source.width; this.height = source.height; this.depth = source.depth; this.rotationEncoding = source.rotationEncoding; return this; }
111
+ /** Convert full dimensions to world-space half extents. */
112
+ override toColliderData(): BoxColliderData {
113
+ positive(this.width, this.height, this.depth);
114
+ const { placed, scale } = this.placement();
115
+ const row: BoxColliderData = { kind: 'box', ...placed, hx: this.width * scale.x / 2, hy: this.height * scale.y / 2, hz: this.depth * scale.z / 2 };
116
+ if (this.rotationEncoding === 'quaternion' && row.rot === undefined)
117
+ row.rot = { x: 0, y: 0, z: 0, w: 1 };
118
+ if (this.rotationEncoding === 'yaw') {
119
+ if (row.rot !== undefined && (Math.abs(row.rot.x) > 1e-8 || Math.abs(row.rot.z) > 1e-8))
120
+ throw new Error('Yaw-encoded box must remain upright');
121
+ row.yaw = this.matrixAutoUpdate && (this.parent === null || this.parent.matrixWorld.equals(new Matrix4())) ? this.rotation.y : 2 * Math.atan2(row.rot?.y ?? 0, row.rot?.w ?? 1);
122
+ delete row.rot;
123
+ }
124
+ return row;
125
+ }
126
+ }
127
+ /** Capsule radius and straight length follow three.js CapsuleGeometry; the caps add two radii. */
128
+ export class CapsuleCollider extends Collider {
129
+ /** Radius of both caps in metres. */
130
+ radius: number;
131
+ /** Straight cylinder length in metres. */
132
+ length: number;
133
+ constructor(radius = 0.5, length = 1, surface?: Surface) {
134
+ super(surface);
135
+ positive(radius);
136
+ if (!Number.isFinite(length) || length < 0)
137
+ throw new Error('Capsule length must be finite and nonnegative');
138
+ this.radius = radius; this.length = length;
139
+ }
140
+ /** Clone the same radius and straight length without constructing a physics body. */
141
+ override copy(source: this, recursive = true): this { super.copy(source, recursive); this.radius = source.radius; this.length = source.length; return this; }
142
+ /** A circular capsule refuses ununiform scale instead of approximating an ellipse. */
143
+ override toColliderData(): ColliderData {
144
+ positive(this.radius);
145
+ if (!Number.isFinite(this.length) || this.length < 0)
146
+ throw new Error('Capsule length must be finite and nonnegative');
147
+ const { placed, scale } = this.placement();
148
+ if (Math.abs(scale.x - scale.z) > 1e-8 || Math.abs(scale.x - scale.y) > 1e-8)
149
+ throw new Error('Capsule requires uniform scale');
150
+ return { kind: 'capsule', ...placed, halfHeight: this.length * scale.y / 2, radius: this.radius * scale.x };
151
+ }
152
+ }
153
+ function positions(geometry: BufferGeometry, scale: Vector3): number[] {
154
+ const attribute = geometry.getAttribute('position');
155
+ if (!geometry.hasAttribute('position') || attribute.itemSize !== 3 || attribute.count === 0)
156
+ throw new Error('Collider geometry requires three-component positions');
157
+ const points: number[] = [];
158
+ for (let i = 0; i < attribute.count; i++)
159
+ points.push(attribute.getX(i) * scale.x, attribute.getY(i) * scale.y, attribute.getZ(i) * scale.z);
160
+ if (points.some(value => !Number.isFinite(value)))
161
+ throw new Error('Collider geometry requires finite positions');
162
+ return points;
163
+ }
164
+ /** A convex collider uses the authored geometry positions; hull construction belongs to the physics compiler. */
165
+ export class HullCollider extends Collider {
166
+ /** The authored geometry, shared like a three.js Mesh geometry. */
167
+ geometry: BufferGeometry;
168
+ constructor(geometry: BufferGeometry = new BufferGeometry(), surface?: Surface) { super(surface); this.geometry = geometry; }
169
+ /** Copy references to authored geometry, exactly as Mesh.copy does. */
170
+ override copy(source: this, recursive = true): this { super.copy(source, recursive); this.geometry = source.geometry; return this; }
171
+ /** Preserve every authored vertex while applying world scale once. */
172
+ override toColliderData(): ColliderData {
173
+ const { placed, scale } = this.placement(), points = positions(this.geometry, scale);
174
+ if (points.length < 12)
175
+ throw new Error('Hull requires at least four points');
176
+ return { kind: 'hull', ...placed, points };
177
+ }
178
+ }
179
+ /** An exact triangle collider uses the same BufferGeometry a Mesh can draw. */
180
+ export class MeshCollider extends Collider {
181
+ /** The authored geometry, shared like a three.js Mesh geometry. */
182
+ geometry: BufferGeometry;
183
+ constructor(geometry: BufferGeometry = new BufferGeometry(), surface?: Surface) { super(surface); this.geometry = geometry; }
184
+ /** Copy references to authored geometry, exactly as Mesh.copy does. */
185
+ override copy(source: this, recursive = true): this { super.copy(source, recursive); this.geometry = source.geometry; return this; }
186
+ /** Indexed and nonindexed triangles retain their original order and winding. */
187
+ override toColliderData(): ColliderData {
188
+ const { placed, scale } = this.placement(), vertices = positions(this.geometry, scale), count = vertices.length / 3;
189
+ const index = this.geometry.getIndex(), indices = index === null ? Array.from({ length: count }, (_, i) => i) : Array.from({ length: index.count }, (_, i) => index.getX(i));
190
+ if (indices.length % 3 !== 0 || indices.some(value => !Number.isSafeInteger(value) || value < 0 || value >= count))
191
+ throw new Error('Mesh collider requires valid triangle indices');
192
+ return { kind: 'trimesh', ...placed, vertices, indices };
193
+ }
194
+ }
@@ -0,0 +1,42 @@
1
+ import { isJsonData } from '@wildshard/format/json';
2
+ import { PLATFORM_DATA_SECTIONS, parsePlatformDataSection, type PlatformDataSectionName } from '@wildshard/format/platformDataSections';
3
+ import { parseWorldPhysics, type WorldPhysics } from '@wildshard/format/worldPhysics';
4
+ import { encodeCanonicalJson } from './immutable';
5
+ import { ownAssetBytes } from './assetOwner';
6
+ import { locatedError } from './authorError';
7
+ import type { DefinedSectionEntry, EmittedSections } from './sections';
8
+ import { parseClientPlan, type ClientPlan } from '@wildshard/format/clientPlan';
9
+
10
+ /** The platform section names accepted by source-owned composition. */
11
+ export type PlatformSectionName = PlatformDataSectionName;
12
+
13
+ /** Admit source-owned client feature rows with the defining detached/frozen platform contract. */
14
+ export function clientPlanSection(input: unknown): ClientPlan { return parseClientPlan(input); }
15
+
16
+ /** Select the native bake's common fields at build time, keeping owner-specific metadata in its own custom section.
17
+ * The raw source bake remains unchanged. No body, collider, buffer or renderer is constructed by this operation. */
18
+ export function worldPhysicsSection(input: unknown, policy: { readonly rig: 'segments' | 'axis'; readonly provenance: 'piece' | 'tagged' }): WorldPhysics {
19
+ if (!isJsonData(input) || typeof input !== 'object' || input === null || Array.isArray(input)) throw new Error('Native bake must be plain JSON');
20
+ const fields = new Set(['version', 'ground', 'solids', 'actors', 'parked', 'herds']);
21
+ const value = Object.fromEntries(Object.entries(input).filter(([key]) => fields.has(key)));
22
+ return parseWorldPhysics({ ...value, rig: policy.rig, provenance: policy.provenance });
23
+ }
24
+
25
+ function parsedSection(name: PlatformDataSectionName, input: unknown): ReturnType<typeof parsePlatformDataSection> {
26
+ try { return parsePlatformDataSection(name, input); } catch (error) { throw locatedError(error, `Section ${name}: `); }
27
+ }
28
+
29
+ /** Emit new platform sections through their defining parsers. The product writer merges these independently from
30
+ * custom definitions and the older root-key envelopes, refusing duplicate names across all three sources. */
31
+ export function emitPlatformSections(values: ReadonlyMap<PlatformDataSectionName, unknown>): EmittedSections {
32
+ const sections: DefinedSectionEntry[] = [], files = new Map<string, Uint8Array>();
33
+ for (const [name, input] of values) {
34
+ if (!Object.hasOwn(PLATFORM_DATA_SECTIONS, name)) throw new Error(`Unknown platform data section: ${name}`);
35
+ const value = parsedSection(name, input), path = `sections/${name}.json`;
36
+ const owned = ownAssetBytes(new TextEncoder().encode(encodeCanonicalJson(value))), bytes = owned.bytes;
37
+ files.set(path, bytes);
38
+ sections.push({ name, path, schema: `wildshard:${name}@1`, hash: owned.hash, bytes: bytes.length });
39
+ }
40
+ sections.sort((a, b) => a.name < b.name ? -1 : a.name > b.name ? 1 : 0);
41
+ return { sections, files: new Map([...files].sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0)) };
42
+ }
@@ -0,0 +1,8 @@
1
+ import * as v from 'valibot';
2
+ import { PlumbingSchema as schema, type PlumbingData as Data } from '@wildshard/format/plumbing';
3
+ /** Validate declared input contexts, tier knobs and Debug choices for an author project. */
4
+ export const PlumbingSchema: v.SchemaWithPipe<readonly [typeof schema]> = v.pipe(schema);
5
+ /** The compiled, callback-free scoped plumbing contract. */
6
+ export type PlumbingData = Data;
7
+ /** Compile author plumbing after checking owned identities and hook references. */
8
+ export function parsePlumbing(input: unknown): Data { return v.parse(PlumbingSchema, input); }
@@ -0,0 +1,128 @@
1
+ // oxlint-disable-next-line import/no-nodejs-modules -- Author builds emit immutable product files.
2
+ import { mkdirSync, writeFileSync } from 'node:fs';
3
+ // oxlint-disable-next-line import/no-nodejs-modules -- The caller supplies its owned output directory.
4
+ import { resolve } from 'node:path';
5
+ import type { ScriptAdmissionRows } from '@wildshard/format/scriptContract';
6
+ import { parseShardfile, type Shardfile } from '@wildshard/format/shardSchema';
7
+ import { admitShardfileProduct, assertProductTargets as assertTargets } from '@wildshard/format/productValidation';
8
+ import { offlineMemoryAdmission, prepareAssetDecoders } from '@wildshard/format/product';
9
+ import { validationRevision, validationSourceBytes } from '@wildshard/format/validationReceipt';
10
+ import { preflightDeclaredCosts } from '@wildshard/format/assetAdmission';
11
+ import { CLIENT_FEATURE_SIDES, unsidedKinds } from '@wildshard/format/featureSides';
12
+ import { PAGE_ONLY_PROGRAM_HOSTS, SCRIPT_V1_VIEW_COMMANDS } from '@wildshard/format/scriptSides';
13
+ import { encodeCanonicalJson, hashImmutableBytes } from './immutable';
14
+ import { hashAssetBytes } from './assetHandle';
15
+
16
+ // Author-only facade: direct synchronous writers need the same readiness as the CLI.
17
+ await prepareAssetDecoders();
18
+
19
+ /** Refuse the same target overages as the author CLI; warning policy belongs only to trusted checkout callers. */
20
+ export function assertProductTargets(source: Shardfile, policy: 'warn' | 'refuse'): void {
21
+ // Execution has not run yet; report only the targets actually checked.
22
+ assertTargets(source, policy);
23
+ }
24
+
25
+ /** The sections SERVER-PARITY's side refusals read (SS2 kinds, SS7 scripts). */
26
+ export const SIDE_SECTIONS: readonly string[] = ['client/plan', 'sim/scripts', 'actors/return-scripts', 'actors/spawn-scripts'];
27
+ const SCRIPT_SECTIONS = ['sim/scripts', 'actors/return-scripts', 'actors/spawn-scripts'] as const;
28
+ const prop = (value: unknown, key: string): unknown => typeof value === 'object' && value !== null && !Array.isArray(value) && Object.hasOwn(value, key) ? Reflect.get(value, key) : undefined;
29
+ const text = (value: unknown, key: string): string | undefined => { const found = prop(value, key); return typeof found === 'string' ? found : undefined; };
30
+ const list = (value: unknown): readonly unknown[] => Array.isArray(value) ? value : [];
31
+
32
+ /** A `view` script row that emits a gameplay command, as one plain line, or nothing (SS7's row rule, with the script named). */
33
+ export function viewGameplayLine(row: unknown): string[] {
34
+ if (text(row, 'side') !== 'view') return [];
35
+ const writes = list(prop(row, 'commands')).filter((name): name is string => typeof name === 'string' && !SCRIPT_V1_VIEW_COMMANDS.has(name as never));
36
+ return writes.length === 0 ? [] : [`side refused: script ${text(row, 'id') ?? '(no id)'} declares view, missing its server half: it emits ${writes.join(', ')}, which write gameplay (declare it sim)`];
37
+ }
38
+
39
+ /**
40
+ * SERVER-PARITY SS8: every SS2 and SS7 refusal in a build's sections, one plain line each, naming the kind or script, its
41
+ * declared side and the half nothing runs. The same rules format admission applies to the written folder (`feature-sides.ts`,
42
+ * `script-sides.ts`), said at build time so an author reads which row to fix before anything is written or uploaded.
43
+ * `named` reads a named JSON file of the product by name (a `page.life` feature's `file`).
44
+ */
45
+ export function sideRefusalLines(sections: ReadonlyMap<string, unknown>, named: (name: string) => unknown): string[] {
46
+ const lines = unsidedKinds(sections.get('client/plan')).map(entry => {
47
+ const [where = '', kind = ''] = entry.split(' ');
48
+ return `side refused: ${where === 'world.assembly' ? 'world.assembly stage' : 'client/plan kind'} ${kind} declares no side, missing its view, both or server entry in shardfile feature-sides.ts`;
49
+ });
50
+ const returns = list(sections.get('actors/return-scripts'));
51
+ for (const feature of list(prop(sections.get('client/plan'), 'features'))) {
52
+ const kind = text(feature, 'kind') ?? '', host = PAGE_ONLY_PROGRAM_HOSTS.get(kind), file = text(feature, 'file');
53
+ if (host === undefined || file === undefined) continue;
54
+ const script = host.reduce<unknown>((value, key) => prop(value, key), named(file));
55
+ if (script === undefined) continue;
56
+ const id = text(script, 'id') ?? '(no id)', admitted = returns.find(row => text(row, 'id') === id);
57
+ const side = CLIENT_FEATURE_SIDES[kind as keyof typeof CLIENT_FEATURE_SIDES].side;
58
+ if (admitted === undefined || encodeCanonicalJson(admitted) !== encodeCanonicalJson(script)) lines.push(`side refused: ${kind} program ${id} (${file}) is not its actors/return-scripts row, so it has no admitted side`);
59
+ else if (text(admitted, 'side') === 'sim') lines.push(`side refused: script ${id} declares sim, missing its server half: only ${kind} (${side}) runs it, from ${file}`);
60
+ }
61
+ for (const row of list(sections.get('sim/scripts'))) if (text(row, 'side') === 'view') lines.push(`side refused: script ${text(row, 'id') ?? '(no id)'} declares view, missing its page half: it sits in sim/scripts, which only the server runs`);
62
+ for (const name of SCRIPT_SECTIONS) for (const row of list(sections.get(name))) lines.push(...viewGameplayLine(row));
63
+ return [...new Set(lines)];
64
+ }
65
+
66
+ /** A reader of a build's named JSON files by name, from its named-file rows and asset bytes: `undefined` when absent or not JSON. */
67
+ export function namedJsonReader(files: readonly { readonly name?: string | undefined; readonly kind: string; readonly hash: string }[], assets: ReadonlyMap<string, Uint8Array>): (name: string) => unknown {
68
+ return (name) => {
69
+ const file = files.find(row => row.kind === 'json' && row.name === name), bytes = file === undefined ? undefined : assets.get(file.hash);
70
+ if (bytes === undefined) return undefined;
71
+ try { const parsed: unknown = JSON.parse(new TextDecoder().decode(bytes)); return parsed; } catch { return undefined; }
72
+ };
73
+ }
74
+
75
+ /** Refuse a build whose sections carry a side refusal: each line is printed, then the build fails with them all. */
76
+ export function assertBuildSides(sections: ReadonlyMap<string, unknown>, named: (name: string) => unknown): void {
77
+ const lines = sideRefusalLines(sections, named);
78
+ if (lines.length === 0) return;
79
+ throw new Error(lines.join('\n'));
80
+ }
81
+
82
+ /** Each product admitProduct returned: the assets map, policy and script rows it was admitted with, and its exact JSON then
83
+ * (by object identity only: a different object, even an equal one, is admitted in full) */
84
+ const admitted = new WeakMap<object, { readonly assets: ReadonlyMap<string, Uint8Array>; readonly policy: 'warn' | 'refuse'; readonly scripts: string; readonly snapshot: string }>();
85
+
86
+ /** Admit declared costs and actual immutable bytes through the browser's defining contracts, without a config loader. */
87
+ export function admitProduct(input: unknown, assets: ReadonlyMap<string, Uint8Array>, policy: 'warn' | 'refuse' = 'refuse', scripts: ScriptAdmissionRows = []): Shardfile {
88
+ const product = admitShardfileProduct(input, assets, hashAssetBytes, policy, scripts);
89
+ rememberAdmitted(product, assets, policy, scripts);
90
+ return product;
91
+ }
92
+
93
+ /** Record a product format validation just admitted, so a writer handed that same object does not admit it twice. */
94
+ export function rememberAdmitted(product: Shardfile, assets: ReadonlyMap<string, Uint8Array>, policy: 'warn' | 'refuse', scripts: ScriptAdmissionRows): void {
95
+ admitted.set(product, { assets, policy, scripts: JSON.stringify(scripts), snapshot: JSON.stringify(product) });
96
+ }
97
+
98
+ /**
99
+ * CI6: the product this very call chain just admitted, handed straight back to a writer that would admit it again: the same
100
+ * object admitProduct returned, with the same assets map, policy and script rows, and JSON unchanged since (nothing wrote
101
+ * to it). Its admission's own result then is a fresh parse of it; any other input (a copy, a mutated object, another map
102
+ * or policy) returns null and takes the full admission. The written folder's own re-admission never depends on this.
103
+ */
104
+ export function readmitted(input: unknown, assets: ReadonlyMap<string, Uint8Array>, policy: 'warn' | 'refuse', scripts: ScriptAdmissionRows): Shardfile | null {
105
+ if (typeof input !== 'object' || input === null) return null;
106
+ const row = admitted.get(input);
107
+ if (row === undefined || row.assets !== assets || row.policy !== policy || row.scripts !== JSON.stringify(scripts) || row.snapshot !== JSON.stringify(input)) return null;
108
+ return parseShardfile(input);
109
+ }
110
+
111
+ /** Emit a complete product: canonical shard.json, every charged local/commons asset and the informational validation receipt.
112
+ * Config builds and author-only cold producers share this writer. No client, runtime, cache or retained product is read.
113
+ * Default admission refuses overages; a trusted caller alone may request the existing warning policy. */
114
+ export function writeProduct(input: unknown, assets: ReadonlyMap<string, Uint8Array>, destination: string, policy: 'warn' | 'refuse' = 'refuse'): Shardfile {
115
+ const shard = admitProduct(input, assets, policy);
116
+ shard.files.sort((a, b) => a.hash.localeCompare(b.hash));
117
+ shard.tiles.sort((a, b) => a.lod - b.lod || a.x - b.x || a.z - b.z);
118
+ mkdirSync(destination, { recursive: true });
119
+ const emitted = new Set<string>();
120
+ for (const [ref, bytes] of assets) {
121
+ const hash = ref.replace('commons:', '');
122
+ if (emitted.has(hash)) continue;
123
+ writeFileSync(resolve(destination, hash), bytes); emitted.add(hash);
124
+ }
125
+ writeFileSync(resolve(destination, 'shard.json'), encodeCanonicalJson(shard));
126
+ writeFileSync(resolve(destination, 'validation.json'), encodeCanonicalJson({ revision: validationRevision(), sourceHash: hashImmutableBytes(validationSourceBytes(shard)), worst: preflightDeclaredCosts(shard, offlineMemoryAdmission(policy)).worst }));
127
+ return shard;
128
+ }