create-threenative 0.2.2 → 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 (588) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +61 -2
  3. package/agent-docs/references/assertion-reference.md +819 -0
  4. package/agent-docs/references/capability-reference.md +4483 -0
  5. package/agent-docs/references/capture-the-frame.md +60 -0
  6. package/agent-docs/references/creating-creatures.md +215 -0
  7. package/agent-docs/references/ctx-cookbook.md +120 -0
  8. package/agent-docs/references/debug-surface.md +68 -0
  9. package/agent-docs/references/dream-loop.md +150 -0
  10. package/agent-docs/references/finding-assets.md +215 -0
  11. package/agent-docs/references/gameplay-recipes.md +54 -0
  12. package/agent-docs/references/menu-screens.md +69 -0
  13. package/agent-docs/references/mobile-memory-budget.md +87 -0
  14. package/agent-docs/references/sculpt-from-a-reference.md +40 -0
  15. package/agent-docs/references/trace-a-slow-frame.md +99 -0
  16. package/agent-docs/references/visual-baseline.md +174 -0
  17. package/agent-docs/references/webview-ui.md +113 -0
  18. package/agent-files/.agents/skills/file-engine-bug/SKILL.md +59 -0
  19. package/agent-files/.agents/skills/prd-creator/SKILL.md +40 -0
  20. package/agent-files/.agents/skills/threenative-assets/SKILL.md +45 -0
  21. package/agent-files/.agents/skills/threenative-builder/SKILL.md +7 -0
  22. package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +27 -0
  23. package/agent-files/.agents/skills/threenative-context/SKILL.md +57 -0
  24. package/agent-files/.agents/skills/threenative-performance/SKILL.md +42 -0
  25. package/agent-files/.agents/skills/threenative-playtest/SKILL.md +44 -0
  26. package/agent-files/.agents/skills/threenative-ui/SKILL.md +20 -0
  27. package/agent-files/.agents/skills/threenative-verifier/SKILL.md +7 -0
  28. package/agent-files/.agents/skills/threenative-visuals/SKILL.md +41 -0
  29. package/agent-files/.claude/agents/threenative-builder.md +7 -0
  30. package/agent-files/.claude/agents/threenative-verifier.md +7 -0
  31. package/agent-files/.claude/skills/file-engine-bug/SKILL.md +59 -0
  32. package/agent-files/.claude/skills/prd-creator/SKILL.md +40 -0
  33. package/agent-files/.claude/skills/threenative-assets/SKILL.md +45 -0
  34. package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +27 -0
  35. package/agent-files/.claude/skills/threenative-context/SKILL.md +57 -0
  36. package/agent-files/.claude/skills/threenative-performance/SKILL.md +42 -0
  37. package/agent-files/.claude/skills/threenative-playtest/SKILL.md +44 -0
  38. package/agent-files/.claude/skills/threenative-ui/SKILL.md +20 -0
  39. package/agent-files/.claude/skills/threenative-visuals/SKILL.md +41 -0
  40. package/agent-files/.threenative/agents/builder.md +32 -0
  41. package/agent-files/.threenative/agents/verifier.md +31 -0
  42. package/agent-files/AGENT-ROLES.md +26 -0
  43. package/agent-files/scripts/reference.mjs +705 -0
  44. package/agent-files/scripts/visual-loop.mjs +382 -0
  45. package/capabilities.json +5292 -0
  46. package/dist/index.d.ts +224 -3
  47. package/dist/index.js +1972 -73
  48. package/dist/threenative.d.ts +9 -2
  49. package/dist/threenative.js +2570 -176
  50. package/package.json +55 -6
  51. package/template-assets/icon.png +0 -0
  52. package/template-assets/loading.ts +325 -0
  53. package/template-assets/patches/three@0.185.1.patch +522 -0
  54. package/template-assets/worldEnvironment.ts +758 -0
  55. package/templates/action-rpg/.codex/config.toml +19 -0
  56. package/templates/action-rpg/.cursor/mcp.json +32 -0
  57. package/templates/action-rpg/.gemini/settings.json +32 -0
  58. package/templates/action-rpg/.mcp.json +18 -2
  59. package/templates/action-rpg/.vscode/mcp.json +36 -0
  60. package/templates/action-rpg/.zed/settings.json +36 -0
  61. package/templates/action-rpg/AGENTS.md +84 -29
  62. package/templates/action-rpg/CLAUDE.md +84 -29
  63. package/templates/action-rpg/index.html +0 -1
  64. package/templates/action-rpg/opencode.json +41 -0
  65. package/templates/action-rpg/package.json +15 -11
  66. package/templates/action-rpg/playtests/combat.playtest.json +32 -9
  67. package/templates/action-rpg/playtests/fail.playtest.json +3 -3
  68. package/templates/action-rpg/playtests/inventory.playtest.json +16 -10
  69. package/templates/action-rpg/playtests/performance.playtest.json +39 -0
  70. package/templates/action-rpg/playtests/progress.playtest.json +18 -13
  71. package/templates/action-rpg/playtests/survives.playtest.json +27 -0
  72. package/templates/action-rpg/playtests/touch-controls.playtest.json +42 -0
  73. package/templates/action-rpg/playtests/win.playtest.json +10 -4
  74. package/templates/action-rpg/src/conventions.ts +35 -0
  75. package/templates/action-rpg/src/entities/Enemy.ts +16 -7
  76. package/templates/action-rpg/src/entities/Player.ts +20 -3
  77. package/templates/action-rpg/src/game.ts +21 -0
  78. package/templates/action-rpg/src/render/camera.ts +7 -2
  79. package/templates/action-rpg/src/render/lighting.ts +11 -4
  80. package/templates/action-rpg/src/render/loading.ts +278 -43
  81. package/templates/action-rpg/src/render/materials.ts +11 -0
  82. package/templates/action-rpg/src/render/palette.ts +10 -3
  83. package/templates/action-rpg/src/render/postprocessing.ts +32 -16
  84. package/templates/action-rpg/src/render/quality.ts +170 -0
  85. package/templates/action-rpg/src/render/shapes.ts +185 -26
  86. package/templates/action-rpg/src/render/touch-controls.ts +185 -0
  87. package/templates/action-rpg/src/render/vfx.ts +257 -0
  88. package/templates/action-rpg/src/render/worldEnvironment.ts +758 -0
  89. package/templates/action-rpg/src/scenes/Play.ts +91 -24
  90. package/templates/action-rpg/src/state.ts +4 -0
  91. package/templates/action-rpg/src/style.css +65 -1
  92. package/templates/action-rpg/src/ui/AbilityBar.tsx +9 -7
  93. package/templates/action-rpg/src/ui/App.tsx +9 -8
  94. package/templates/action-rpg/src/ui/CharacterPanel.tsx +10 -8
  95. package/templates/action-rpg/src/ui/GameUi.tsx +24 -0
  96. package/templates/action-rpg/src/ui/Hud.tsx +10 -8
  97. package/templates/action-rpg/src/ui/InventoryPanel.tsx +9 -7
  98. package/templates/action-rpg/src/ui/main.tsx +14 -0
  99. package/templates/action-rpg/threenative.config.ts +28 -8
  100. package/templates/action-rpg/vite.config.ts +32 -2
  101. package/templates/defense/.codex/config.toml +19 -0
  102. package/templates/defense/.cursor/mcp.json +32 -0
  103. package/templates/defense/.gemini/settings.json +32 -0
  104. package/templates/defense/.mcp.json +18 -2
  105. package/templates/defense/.vscode/mcp.json +36 -0
  106. package/templates/defense/.zed/settings.json +36 -0
  107. package/templates/defense/AGENTS.md +81 -41
  108. package/templates/defense/CLAUDE.md +81 -41
  109. package/templates/defense/README.md +2 -1
  110. package/templates/defense/index.html +0 -1
  111. package/templates/defense/opencode.json +41 -0
  112. package/templates/defense/package.json +16 -12
  113. package/templates/defense/playtests/leak.playtest.json +9 -4
  114. package/templates/defense/playtests/performance.playtest.json +39 -0
  115. package/templates/defense/playtests/placement.playtest.json +5 -5
  116. package/templates/defense/playtests/pointer-placement.playtest.json +156 -0
  117. package/templates/defense/playtests/scan.playtest.json +4 -4
  118. package/templates/defense/playtests/survive.playtest.json +25 -6
  119. package/templates/defense/src/attackers/Attacker.ts +32 -16
  120. package/templates/defense/src/board/Route.ts +22 -8
  121. package/templates/defense/src/conventions.ts +18 -0
  122. package/templates/defense/src/entities/Player.ts +11 -3
  123. package/templates/defense/src/game.ts +25 -4
  124. package/templates/defense/src/physics.ts +9 -39
  125. package/templates/defense/src/placement/Buildable.ts +4 -4
  126. package/templates/defense/src/render/camera.ts +9 -3
  127. package/templates/defense/src/render/lighting.ts +6 -1
  128. package/templates/defense/src/render/loading.ts +274 -38
  129. package/templates/defense/src/render/materials.ts +9 -0
  130. package/templates/defense/src/render/palette.ts +12 -5
  131. package/templates/defense/src/render/postprocessing.ts +32 -12
  132. package/templates/defense/src/render/quality.ts +170 -0
  133. package/templates/defense/src/render/shapes.ts +180 -23
  134. package/templates/defense/src/render/sky.ts +2 -2
  135. package/templates/defense/src/render/worldEnvironment.ts +758 -0
  136. package/templates/defense/src/scenes/Boot.ts +2 -2
  137. package/templates/defense/src/scenes/Defense.ts +122 -56
  138. package/templates/defense/src/state.ts +6 -0
  139. package/templates/defense/src/style.css +65 -1
  140. package/templates/defense/src/towers/Tower.ts +11 -12
  141. package/templates/defense/src/towers/targeting.ts +1 -1
  142. package/templates/defense/src/ui/App.tsx +11 -6
  143. package/templates/defense/src/ui/GameUi.tsx +20 -0
  144. package/templates/defense/src/ui/Hud.tsx +6 -5
  145. package/templates/defense/src/ui/main.tsx +14 -0
  146. package/templates/defense/threenative.config.ts +28 -8
  147. package/templates/defense/vite.config.ts +34 -1
  148. package/templates/minimal/.codex/config.toml +19 -0
  149. package/templates/minimal/.cursor/mcp.json +32 -0
  150. package/templates/minimal/.gemini/settings.json +32 -0
  151. package/templates/minimal/.mcp.json +18 -2
  152. package/templates/minimal/.vscode/mcp.json +36 -0
  153. package/templates/minimal/.zed/settings.json +36 -0
  154. package/templates/minimal/AGENTS.md +78 -382
  155. package/templates/minimal/CLAUDE.md +78 -382
  156. package/templates/minimal/index.html +0 -1
  157. package/templates/minimal/opencode.json +41 -0
  158. package/templates/minimal/package.json +14 -11
  159. package/templates/minimal/playtests/atmosphere.playtest.json +32 -0
  160. package/templates/minimal/playtests/play.playtest.json +18 -5
  161. package/templates/minimal/playtests/survives.playtest.json +48 -4
  162. package/templates/minimal/playtests/touch-controls.playtest.json +42 -0
  163. package/templates/minimal/src/conventions.ts +18 -0
  164. package/templates/minimal/src/entities/Player.ts +39 -6
  165. package/templates/minimal/src/game.ts +1 -0
  166. package/templates/minimal/src/main.ts +14 -4
  167. package/templates/minimal/src/render/camera.ts +1 -1
  168. package/templates/minimal/src/render/hud.ts +24 -8
  169. package/templates/minimal/src/render/lighting.ts +23 -2
  170. package/templates/minimal/src/render/loading.ts +23 -103
  171. package/templates/minimal/src/render/materials.ts +7 -0
  172. package/templates/minimal/src/render/palette.ts +3 -3
  173. package/templates/minimal/src/render/postprocessing.ts +55 -16
  174. package/templates/minimal/src/render/quality.ts +162 -0
  175. package/templates/minimal/src/render/sky.ts +51 -32
  176. package/templates/minimal/src/render/touch-controls.ts +165 -0
  177. package/templates/minimal/src/render/worldEnvironment.ts +758 -0
  178. package/templates/minimal/src/scenes/Play.ts +128 -14
  179. package/templates/minimal/src/state.ts +8 -1
  180. package/templates/minimal/src/style.css +20 -0
  181. package/templates/minimal/threenative.config.ts +22 -10
  182. package/templates/minimal/vite.config.ts +28 -1
  183. package/templates/platformer/.codex/config.toml +19 -0
  184. package/templates/platformer/.cursor/mcp.json +32 -0
  185. package/templates/platformer/.gemini/settings.json +32 -0
  186. package/templates/platformer/.mcp.json +18 -2
  187. package/templates/platformer/.vscode/mcp.json +36 -0
  188. package/templates/platformer/.zed/settings.json +36 -0
  189. package/templates/platformer/AGENTS.md +81 -186
  190. package/templates/platformer/CLAUDE.md +81 -186
  191. package/templates/platformer/index.html +0 -1
  192. package/templates/platformer/opencode.json +41 -0
  193. package/templates/platformer/package.json +17 -14
  194. package/templates/platformer/playtests/avoidance.playtest.json +6 -1
  195. package/templates/platformer/playtests/branding.playtest.json +29 -0
  196. package/templates/platformer/playtests/buffer.playtest.json +1 -1
  197. package/templates/platformer/playtests/collect.playtest.json +1 -1
  198. package/templates/platformer/playtests/collision-layers.playtest.json +2 -2
  199. package/templates/platformer/playtests/coyote.playtest.json +42 -8
  200. package/templates/platformer/playtests/damage.playtest.json +4 -1
  201. package/templates/platformer/playtests/dash.playtest.json +2 -2
  202. package/templates/platformer/playtests/jump.playtest.json +2 -3
  203. package/templates/platformer/playtests/native/touch-controls.playtest.json +33 -0
  204. package/templates/platformer/playtests/oneway.playtest.json +30 -3
  205. package/templates/platformer/playtests/performance.playtest.json +7 -5
  206. package/templates/platformer/playtests/respawn.playtest.json +2 -2
  207. package/templates/platformer/playtests/stomp-rise.playtest.json +17 -3
  208. package/templates/platformer/playtests/stomp.playtest.json +11 -3
  209. package/templates/platformer/playtests/survives.playtest.json +31 -0
  210. package/templates/platformer/playtests/terminal-loop-fail.playtest.json +16 -4
  211. package/templates/platformer/playtests/terminal-loop-win.playtest.json +3 -3
  212. package/templates/platformer/playtests/touch-controls-web.playtest.json +57 -0
  213. package/templates/platformer/src/conventions.ts +18 -0
  214. package/templates/platformer/src/entities/Character.ts +79 -11
  215. package/templates/platformer/src/entities/Patrol.ts +5 -0
  216. package/templates/platformer/src/game.ts +27 -2
  217. package/templates/platformer/src/level/Platform.ts +13 -1
  218. package/templates/platformer/src/render/lighting.ts +13 -5
  219. package/templates/platformer/src/render/loading.ts +281 -62
  220. package/templates/platformer/src/render/palette.ts +4 -1
  221. package/templates/platformer/src/render/postprocessing.ts +42 -14
  222. package/templates/platformer/src/render/quality.ts +170 -0
  223. package/templates/platformer/src/render/touch-controls.ts +54 -36
  224. package/templates/platformer/src/render/worldEnvironment.ts +758 -0
  225. package/templates/platformer/src/scenes/Level.ts +97 -32
  226. package/templates/platformer/src/state.ts +4 -0
  227. package/templates/platformer/src/style.css +65 -1
  228. package/templates/platformer/src/ui/App.tsx +9 -4
  229. package/templates/platformer/src/ui/GameUi.tsx +20 -0
  230. package/templates/platformer/src/ui/Hud.tsx +6 -5
  231. package/templates/platformer/src/ui/main.tsx +14 -0
  232. package/templates/platformer/threenative.config.ts +27 -10
  233. package/templates/platformer/vite.config.ts +34 -1
  234. package/templates/puzzle/.codex/config.toml +19 -0
  235. package/templates/puzzle/.cursor/mcp.json +32 -0
  236. package/templates/puzzle/.gemini/settings.json +32 -0
  237. package/templates/puzzle/.mcp.json +32 -0
  238. package/templates/puzzle/.vscode/mcp.json +36 -0
  239. package/templates/puzzle/.zed/settings.json +36 -0
  240. package/templates/puzzle/AGENTS.md +96 -0
  241. package/templates/puzzle/CLAUDE.md +98 -0
  242. package/templates/puzzle/README.md +43 -0
  243. package/templates/puzzle/index.html +12 -0
  244. package/templates/puzzle/kit.json +7 -0
  245. package/templates/puzzle/opencode.json +41 -0
  246. package/templates/puzzle/package.json +50 -0
  247. package/templates/puzzle/playtests/carry.playtest.json +71 -0
  248. package/templates/puzzle/playtests/performance.playtest.json +23 -0
  249. package/templates/puzzle/playtests/survives.playtest.json +51 -0
  250. package/templates/puzzle/playtests/swing.playtest.json +38 -0
  251. package/templates/puzzle/public/favicon.svg +5 -0
  252. package/templates/puzzle/src/conventions.ts +25 -0
  253. package/templates/puzzle/src/entities/Ball.ts +70 -0
  254. package/templates/puzzle/src/entities/Crate.ts +76 -0
  255. package/templates/puzzle/src/entities/Gripper.ts +69 -0
  256. package/templates/puzzle/src/entities/Pendulum.ts +89 -0
  257. package/templates/puzzle/src/game.ts +48 -0
  258. package/templates/puzzle/src/main.ts +15 -0
  259. package/templates/puzzle/src/physics.ts +19 -0
  260. package/templates/puzzle/src/render/camera.ts +37 -0
  261. package/templates/puzzle/src/render/lighting.ts +55 -0
  262. package/templates/puzzle/src/render/loading.ts +325 -0
  263. package/templates/puzzle/src/render/materials.ts +28 -0
  264. package/templates/puzzle/src/render/palette.ts +31 -0
  265. package/templates/puzzle/src/render/postprocessing.ts +34 -0
  266. package/templates/puzzle/src/render/quality.ts +170 -0
  267. package/templates/puzzle/src/render/shapes.ts +134 -0
  268. package/templates/puzzle/src/render/sky.ts +16 -0
  269. package/templates/puzzle/src/render/touch-controls.ts +185 -0
  270. package/templates/puzzle/src/render/worldEnvironment.ts +758 -0
  271. package/templates/puzzle/src/room.ts +83 -0
  272. package/templates/puzzle/src/scenes/Boot.ts +12 -0
  273. package/templates/puzzle/src/scenes/Puzzle.ts +158 -0
  274. package/templates/puzzle/src/state.ts +30 -0
  275. package/templates/puzzle/src/style.css +96 -0
  276. package/templates/puzzle/src/ui/App.tsx +22 -0
  277. package/templates/puzzle/src/ui/GameUi.tsx +20 -0
  278. package/templates/puzzle/src/ui/Hud.tsx +57 -0
  279. package/templates/puzzle/src/ui/Menu.tsx +7 -0
  280. package/templates/puzzle/src/ui/main.tsx +14 -0
  281. package/templates/puzzle/tailwind.config.ts +1 -0
  282. package/templates/puzzle/threenative.config.ts +49 -0
  283. package/templates/puzzle/tsconfig.json +17 -0
  284. package/templates/puzzle/vite.config.ts +38 -0
  285. package/templates/racing/.codex/config.toml +19 -0
  286. package/templates/racing/.cursor/mcp.json +32 -0
  287. package/templates/racing/.gemini/settings.json +32 -0
  288. package/templates/racing/.mcp.json +18 -2
  289. package/templates/racing/.vscode/mcp.json +36 -0
  290. package/templates/racing/.zed/settings.json +36 -0
  291. package/templates/racing/AGENTS.md +84 -36
  292. package/templates/racing/CLAUDE.md +84 -36
  293. package/templates/racing/index.html +0 -1
  294. package/templates/racing/native-playtests/survives.playtest.json +43 -0
  295. package/templates/racing/opencode.json +41 -0
  296. package/templates/racing/package.json +17 -12
  297. package/templates/racing/playtests/boost.playtest.json +5 -5
  298. package/templates/racing/playtests/outcome.playtest.json +14 -4
  299. package/templates/racing/playtests/performance.playtest.json +39 -0
  300. package/templates/racing/playtests/ranking.playtest.json +2 -2
  301. package/templates/racing/playtests/rescue.playtest.json +12 -6
  302. package/templates/racing/playtests/reverse.playtest.json +3 -3
  303. package/templates/racing/playtests/shortcut.playtest.json +3 -3
  304. package/templates/racing/playtests/survives.playtest.json +36 -4
  305. package/templates/racing/playtests/touch-controls.playtest.json +41 -0
  306. package/templates/racing/src/conventions.ts +6 -0
  307. package/templates/racing/src/entities/RacingCar.ts +16 -4
  308. package/templates/racing/src/entities/Rival.ts +5 -2
  309. package/templates/racing/src/game.ts +24 -1
  310. package/templates/racing/src/render/camera.ts +15 -8
  311. package/templates/racing/src/render/lighting.ts +28 -14
  312. package/templates/racing/src/render/loading.ts +302 -35
  313. package/templates/racing/src/render/materials.ts +54 -4
  314. package/templates/racing/src/render/palette.ts +23 -6
  315. package/templates/racing/src/render/postprocessing.ts +32 -12
  316. package/templates/racing/src/render/quality.ts +170 -0
  317. package/templates/racing/src/render/shapes.ts +537 -26
  318. package/templates/racing/src/render/sky.ts +5 -2
  319. package/templates/racing/src/render/touch-controls.ts +185 -0
  320. package/templates/racing/src/render/worldEnvironment.ts +758 -0
  321. package/templates/racing/src/scenes/Race.ts +84 -37
  322. package/templates/racing/src/state.ts +4 -0
  323. package/templates/racing/src/style.css +65 -1
  324. package/templates/racing/src/track/Lap.ts +20 -9
  325. package/templates/racing/src/track/Ranking.ts +53 -14
  326. package/templates/racing/src/track/Track.ts +284 -32
  327. package/templates/racing/src/track/TrackSector.ts +14 -4
  328. package/templates/racing/src/ui/App.tsx +9 -4
  329. package/templates/racing/src/ui/GameUi.tsx +20 -0
  330. package/templates/racing/src/ui/Hud.tsx +6 -5
  331. package/templates/racing/src/ui/main.tsx +14 -0
  332. package/templates/racing/threenative.config.ts +28 -8
  333. package/templates/racing/vite.config.ts +34 -1
  334. package/templates/runner/.codex/config.toml +19 -0
  335. package/templates/runner/.cursor/mcp.json +32 -0
  336. package/templates/runner/.gemini/settings.json +32 -0
  337. package/templates/runner/.mcp.json +32 -0
  338. package/templates/runner/.vscode/mcp.json +36 -0
  339. package/templates/runner/.zed/settings.json +36 -0
  340. package/templates/runner/AGENTS.md +96 -0
  341. package/templates/runner/CLAUDE.md +98 -0
  342. package/templates/runner/README.md +43 -0
  343. package/templates/runner/index.html +12 -0
  344. package/templates/runner/kit.json +7 -0
  345. package/templates/runner/opencode.json +41 -0
  346. package/templates/runner/package.json +50 -0
  347. package/templates/runner/playtests/performance.playtest.json +23 -0
  348. package/templates/runner/playtests/streams.playtest.json +38 -0
  349. package/templates/runner/playtests/survives.playtest.json +51 -0
  350. package/templates/runner/public/favicon.svg +5 -0
  351. package/templates/runner/src/conventions.ts +24 -0
  352. package/templates/runner/src/entities/Runner.ts +135 -0
  353. package/templates/runner/src/game.ts +50 -0
  354. package/templates/runner/src/main.ts +15 -0
  355. package/templates/runner/src/physics.ts +13 -0
  356. package/templates/runner/src/render/camera.ts +39 -0
  357. package/templates/runner/src/render/dust.ts +131 -0
  358. package/templates/runner/src/render/lighting.ts +57 -0
  359. package/templates/runner/src/render/loading.ts +325 -0
  360. package/templates/runner/src/render/materials.ts +27 -0
  361. package/templates/runner/src/render/palette.ts +30 -0
  362. package/templates/runner/src/render/postprocessing.ts +34 -0
  363. package/templates/runner/src/render/quality.ts +170 -0
  364. package/templates/runner/src/render/shapes.ts +68 -0
  365. package/templates/runner/src/render/sky.ts +51 -0
  366. package/templates/runner/src/render/touch-controls.ts +185 -0
  367. package/templates/runner/src/render/worldEnvironment.ts +758 -0
  368. package/templates/runner/src/scenes/Boot.ts +12 -0
  369. package/templates/runner/src/scenes/Run.ts +142 -0
  370. package/templates/runner/src/state.ts +29 -0
  371. package/templates/runner/src/style.css +96 -0
  372. package/templates/runner/src/track.ts +176 -0
  373. package/templates/runner/src/ui/App.tsx +22 -0
  374. package/templates/runner/src/ui/GameUi.tsx +20 -0
  375. package/templates/runner/src/ui/Hud.tsx +55 -0
  376. package/templates/runner/src/ui/Menu.tsx +7 -0
  377. package/templates/runner/src/ui/main.tsx +14 -0
  378. package/templates/runner/tailwind.config.ts +1 -0
  379. package/templates/runner/threenative.config.ts +49 -0
  380. package/templates/runner/tsconfig.json +17 -0
  381. package/templates/runner/vite.config.ts +38 -0
  382. package/templates/sailing/.codex/config.toml +19 -0
  383. package/templates/sailing/.cursor/mcp.json +32 -0
  384. package/templates/sailing/.gemini/settings.json +32 -0
  385. package/templates/sailing/.mcp.json +32 -0
  386. package/templates/sailing/.vscode/mcp.json +36 -0
  387. package/templates/sailing/.zed/settings.json +36 -0
  388. package/templates/sailing/AGENTS.md +95 -0
  389. package/templates/sailing/CLAUDE.md +97 -0
  390. package/templates/sailing/README.md +28 -0
  391. package/templates/sailing/index.html +12 -0
  392. package/templates/sailing/kit.json +7 -0
  393. package/templates/sailing/native-playtests/float.playtest.json +55 -0
  394. package/templates/sailing/native-playtests/survives.playtest.json +38 -0
  395. package/templates/sailing/opencode.json +41 -0
  396. package/templates/sailing/package.json +52 -0
  397. package/templates/sailing/playtests/fail.playtest.json +24 -0
  398. package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +75 -0
  399. package/templates/sailing/playtests/float.playtest.json +59 -0
  400. package/templates/sailing/playtests/performance.playtest.json +36 -0
  401. package/templates/sailing/playtests/survives.playtest.json +46 -0
  402. package/templates/sailing/playtests/touch-controls.playtest.json +48 -0
  403. package/templates/sailing/playtests/win.playtest.json +31 -0
  404. package/templates/sailing/public/favicon.svg +5 -0
  405. package/templates/sailing/src/conventions.ts +8 -0
  406. package/templates/sailing/src/entities/Ship.ts +233 -0
  407. package/templates/sailing/src/game.ts +40 -0
  408. package/templates/sailing/src/main.ts +15 -0
  409. package/templates/sailing/src/render/camera.ts +28 -0
  410. package/templates/sailing/src/render/lighting.ts +41 -0
  411. package/templates/sailing/src/render/loading.ts +325 -0
  412. package/templates/sailing/src/render/materials.ts +44 -0
  413. package/templates/sailing/src/render/ocean.ts +179 -0
  414. package/templates/sailing/src/render/palette.ts +17 -0
  415. package/templates/sailing/src/render/postprocessing.ts +34 -0
  416. package/templates/sailing/src/render/props.ts +602 -0
  417. package/templates/sailing/src/render/quality.ts +140 -0
  418. package/templates/sailing/src/render/sky.ts +37 -0
  419. package/templates/sailing/src/render/touch-controls.ts +142 -0
  420. package/templates/sailing/src/render/worldEnvironment.ts +758 -0
  421. package/templates/sailing/src/scenes/Boot.ts +12 -0
  422. package/templates/sailing/src/scenes/Sailing.ts +133 -0
  423. package/templates/sailing/src/state.ts +10 -0
  424. package/templates/sailing/src/style.css +81 -0
  425. package/templates/sailing/src/ui/App.tsx +15 -0
  426. package/templates/sailing/src/ui/GameUi.tsx +12 -0
  427. package/templates/sailing/src/ui/Hud.tsx +55 -0
  428. package/templates/sailing/src/ui/Menu.tsx +30 -0
  429. package/templates/sailing/src/ui/main.tsx +7 -0
  430. package/templates/sailing/tailwind.config.ts +2 -0
  431. package/templates/sailing/threenative.config.ts +40 -0
  432. package/templates/sailing/tsconfig.json +17 -0
  433. package/templates/sailing/vite.config.ts +34 -0
  434. package/templates/shooter/.codex/config.toml +19 -0
  435. package/templates/shooter/.cursor/mcp.json +32 -0
  436. package/templates/shooter/.gemini/settings.json +32 -0
  437. package/templates/shooter/.mcp.json +18 -2
  438. package/templates/shooter/.vscode/mcp.json +36 -0
  439. package/templates/shooter/.zed/settings.json +36 -0
  440. package/templates/shooter/AGENTS.md +81 -54
  441. package/templates/shooter/CLAUDE.md +81 -54
  442. package/templates/shooter/index.html +0 -1
  443. package/templates/shooter/kit.json +2 -2
  444. package/templates/shooter/opencode.json +41 -0
  445. package/templates/shooter/package.json +16 -11
  446. package/templates/shooter/playtests/combat.playtest.json +48 -0
  447. package/templates/shooter/playtests/fail.playtest.json +5 -4
  448. package/templates/shooter/playtests/input-control.playtest.json +261 -0
  449. package/templates/shooter/playtests/per-item.playtest.json +59 -0
  450. package/templates/shooter/playtests/performance.playtest.json +39 -0
  451. package/templates/shooter/playtests/shooter.playtest.json +31 -21
  452. package/templates/shooter/playtests/survives.playtest.json +28 -1
  453. package/templates/shooter/playtests/touch-controls.playtest.json +42 -0
  454. package/templates/shooter/playtests/weapon-cycle.playtest.json +164 -0
  455. package/templates/shooter/public/favicon.svg +1 -1
  456. package/templates/shooter/src/combat/damage.ts +1 -2
  457. package/templates/shooter/src/conventions.ts +51 -0
  458. package/templates/shooter/src/entities/Player.ts +235 -18
  459. package/templates/shooter/src/entities/Target.ts +2 -2
  460. package/templates/shooter/src/game.ts +35 -3
  461. package/templates/shooter/src/main.ts +3 -13
  462. package/templates/shooter/src/render/camera.ts +78 -18
  463. package/templates/shooter/src/render/decals.ts +211 -0
  464. package/templates/shooter/src/render/lighting.ts +13 -4
  465. package/templates/shooter/src/render/loading.ts +274 -35
  466. package/templates/shooter/src/render/materials.ts +56 -3
  467. package/templates/shooter/src/render/palette.ts +6 -3
  468. package/templates/shooter/src/render/postprocessing.ts +32 -17
  469. package/templates/shooter/src/render/quality.ts +170 -0
  470. package/templates/shooter/src/render/scale.ts +22 -0
  471. package/templates/shooter/src/render/shapes.ts +519 -60
  472. package/templates/shooter/src/render/sky.ts +5 -1
  473. package/templates/shooter/src/render/touch-controls.ts +305 -0
  474. package/templates/shooter/src/render/ui.css +119 -1
  475. package/templates/shooter/src/render/ui.ts +19 -3
  476. package/templates/shooter/src/render/vfx.ts +215 -0
  477. package/templates/shooter/src/render/worldEnvironment.ts +758 -0
  478. package/templates/shooter/src/scenes/Play.ts +385 -97
  479. package/templates/shooter/src/state.ts +18 -0
  480. package/templates/shooter/src/style.css +46 -0
  481. package/templates/shooter/src/ui/App.tsx +10 -12
  482. package/templates/shooter/src/ui/Crosshair.tsx +25 -0
  483. package/templates/shooter/src/ui/GameUi.tsx +22 -0
  484. package/templates/shooter/src/ui/Hud.tsx +14 -10
  485. package/templates/shooter/src/ui/Menu.tsx +24 -9
  486. package/templates/shooter/src/ui/main.tsx +15 -0
  487. package/templates/shooter/src/weapons/Hitscan.ts +3 -4
  488. package/templates/shooter/src/weapons/Projectile.ts +29 -13
  489. package/templates/shooter/src/weapons/Viewmodel.ts +275 -0
  490. package/templates/shooter/threenative.config.ts +28 -8
  491. package/templates/shooter/vite.config.ts +32 -2
  492. package/templates/starter/.codex/config.toml +19 -0
  493. package/templates/starter/.cursor/mcp.json +32 -0
  494. package/templates/starter/.gemini/settings.json +32 -0
  495. package/templates/starter/.mcp.json +18 -2
  496. package/templates/starter/.vscode/mcp.json +36 -0
  497. package/templates/starter/.zed/settings.json +36 -0
  498. package/templates/starter/AGENTS.md +72 -426
  499. package/templates/starter/CLAUDE.md +72 -426
  500. package/templates/starter/assets/pickup.wav +0 -0
  501. package/templates/starter/gitignore +4 -0
  502. package/templates/starter/index.html +0 -1
  503. package/templates/starter/native-playtests/react-hud.playtest.json +20 -0
  504. package/templates/starter/native-playtests/render-chain.playtest.json +81 -0
  505. package/templates/starter/opencode.json +41 -0
  506. package/templates/starter/package.json +16 -12
  507. package/templates/starter/playtests/assets.playtest.json +65 -0
  508. package/templates/starter/playtests/boot-failure.playtest.json +45 -0
  509. package/templates/starter/playtests/buffer.playtest.json +59 -9
  510. package/templates/starter/playtests/cloth.playtest.json +113 -0
  511. package/templates/starter/playtests/coyote.playtest.json +60 -8
  512. package/templates/starter/playtests/forward.playtest.json +29 -4
  513. package/templates/starter/playtests/gameover.playtest.json +66 -0
  514. package/templates/starter/playtests/goal.playtest.json +67 -0
  515. package/templates/starter/playtests/hot-reload.playtest.json +48 -8
  516. package/templates/starter/playtests/look.playtest.json +142 -10
  517. package/templates/starter/playtests/models-baseline.png +0 -0
  518. package/templates/starter/playtests/models.playtest.json +74 -0
  519. package/templates/starter/playtests/monitoring.playtest.json +38 -7
  520. package/templates/starter/playtests/odometer.playtest.json +54 -0
  521. package/templates/starter/playtests/pause.playtest.json +27 -4
  522. package/templates/starter/playtests/play.playtest.json +44 -7
  523. package/templates/starter/playtests/respawn.playtest.json +46 -6
  524. package/templates/starter/playtests/restart.playtest.json +65 -10
  525. package/templates/starter/playtests/seed.playtest.json +44 -8
  526. package/templates/starter/playtests/survives.playtest.json +48 -4
  527. package/templates/starter/playtests/textures-baseline.png +0 -0
  528. package/templates/starter/playtests/textures.playtest.json +74 -0
  529. package/templates/starter/playtests/touch-controls.playtest.json +42 -0
  530. package/templates/starter/playtests/zoom-pinch.playtest.json +86 -0
  531. package/templates/starter/playtests/zoom-wheel.playtest.json +59 -0
  532. package/templates/starter/src/conventions.ts +18 -0
  533. package/templates/starter/src/entities/Goal.ts +137 -0
  534. package/templates/starter/src/entities/Player.ts +111 -10
  535. package/templates/starter/src/game.ts +27 -0
  536. package/templates/starter/src/render/adaptiveQuality.ts +195 -0
  537. package/templates/starter/src/render/camera.ts +31 -5
  538. package/templates/starter/src/render/coast.ts +199 -0
  539. package/templates/starter/src/render/easing.ts +5 -0
  540. package/templates/starter/src/render/effects/gradualBackground.ts +48 -0
  541. package/templates/starter/src/render/effects/lensDistortion.ts +43 -0
  542. package/templates/starter/src/render/effects/sparkle.ts +49 -0
  543. package/templates/starter/src/render/hero.ts +88 -0
  544. package/templates/starter/src/render/implicitSurface.ts +199 -0
  545. package/templates/starter/src/render/kuwahara.ts +174 -0
  546. package/templates/starter/src/render/lighting.ts +10 -5
  547. package/templates/starter/src/render/loading.ts +325 -0
  548. package/templates/starter/src/render/materials.ts +39 -4
  549. package/templates/starter/src/render/outline.ts +141 -0
  550. package/templates/starter/src/render/painterly.ts +86 -0
  551. package/templates/starter/src/render/palette.ts +15 -6
  552. package/templates/starter/src/render/pennant.ts +54 -0
  553. package/templates/starter/src/render/postprocessing.ts +97 -15
  554. package/templates/starter/src/render/quality.ts +185 -0
  555. package/templates/starter/src/render/rockRidge.ts +198 -0
  556. package/templates/starter/src/render/rockRidge.worker.ts +77 -0
  557. package/templates/starter/src/render/scenery.ts +40 -0
  558. package/templates/starter/src/render/shapes.ts +9 -21
  559. package/templates/starter/src/render/textureLifetime.ts +53 -0
  560. package/templates/starter/src/render/touch-controls.ts +165 -0
  561. package/templates/starter/src/render/water.ts +38 -0
  562. package/templates/starter/src/render/watercolor.ts +85 -0
  563. package/templates/starter/src/render/worldEnvironment.ts +758 -0
  564. package/templates/starter/src/scenes/Play.ts +243 -46
  565. package/templates/starter/src/state.ts +12 -0
  566. package/templates/starter/src/style.css +72 -8
  567. package/templates/starter/src/ui/App.tsx +9 -6
  568. package/templates/starter/src/ui/GameUi.tsx +20 -0
  569. package/templates/starter/src/ui/Hud.tsx +52 -29
  570. package/templates/starter/src/ui/Menu.tsx +25 -23
  571. package/templates/starter/src/ui/main.tsx +14 -0
  572. package/templates/starter/threenative.config.ts +27 -9
  573. package/templates/starter/tools/look.mjs +109 -0
  574. package/templates/starter/vite.config.ts +32 -2
  575. package/templates/action-rpg/src/physics.ts +0 -40
  576. package/templates/minimal/assets/.gitkeep +0 -0
  577. package/templates/minimal/public/.gitkeep +0 -0
  578. package/templates/minimal/public/icon.png +0 -0
  579. package/templates/platformer/assets/.gitkeep +0 -0
  580. package/templates/platformer/public/.gitkeep +0 -0
  581. package/templates/platformer/public/icon.png +0 -0
  582. package/templates/shooter/src/physics.ts +0 -49
  583. package/templates/starter/assets/.gitkeep +0 -0
  584. package/templates/starter/public/.gitkeep +0 -0
  585. package/templates/starter/public/icon.png +0 -0
  586. package/templates/starter/public/pickup.ogg +0 -0
  587. /package/templates/starter/{public → assets}/native-proof.glb +0 -0
  588. /package/templates/starter/{public → assets}/native-proof.png +0 -0
@@ -0,0 +1,199 @@
1
+ // Generated for you: ordinary Three.js, with every coastal shape and colour game-owned.
2
+ // This file composes the starter's scene; it does not add physics or choose a framework look.
3
+ import {
4
+ ConeGeometry,
5
+ CylinderGeometry,
6
+ DodecahedronGeometry,
7
+ Group,
8
+ type Material,
9
+ Mesh,
10
+ PlaneGeometry,
11
+ SphereGeometry,
12
+ TorusGeometry,
13
+ } from "three";
14
+ import { block } from "./shapes.js";
15
+ import { type IWaveDisplacementSource, createWaterMaterial } from "./water.js";
16
+
17
+ export interface ICoastalMaterials {
18
+ readonly flower: Material;
19
+ readonly grass: Material;
20
+ readonly grassDark: Material;
21
+ readonly rock: Material;
22
+ readonly sand: Material;
23
+ readonly shoreline: Material;
24
+ }
25
+ const TUFTS = [
26
+ [-4.25, -1.28, 0.85],
27
+ [-3.65, 1.32, 0.72],
28
+ [-2.5, -1.42, 0.66],
29
+ [-1.05, 1.38, 0.76],
30
+ [0.75, -1.4, 0.74],
31
+ [1.9, 1.35, 0.82],
32
+ [3.15, -1.3, 0.68],
33
+ [4.12, 1.18, 0.78],
34
+ ] as const;
35
+ const REEDS = [-4.45, -0.3, 3.95] as const;
36
+
37
+ /** Builds the little island, its water, and the repeated vegetation around the play route. */
38
+ export function createCoastalScene(
39
+ materials: ICoastalMaterials,
40
+ waves: IWaveDisplacementSource,
41
+ random: () => number,
42
+ ): Group {
43
+ const coast = new Group();
44
+ coast.name = "coastal-diorama";
45
+
46
+ const water = new Mesh(new PlaneGeometry(72, 72, 64, 64), createWaterMaterial(waves));
47
+ water.geometry.rotateX(-Math.PI / 2);
48
+ water.name = "stylized-water";
49
+ // The wave crest reaches above the base plane; leave clearance below the lower goal
50
+ // sandbar so the animated surface never clips through its top.
51
+ water.position.set(0, -0.78, -18);
52
+ water.frustumCulled = false;
53
+ water.receiveShadow = true;
54
+ coast.add(water);
55
+
56
+ const beach = new Mesh(new CylinderGeometry(1, 1, 0.18, 32), materials.sand);
57
+ beach.name = "island-beach";
58
+ beach.position.y = -0.06;
59
+ beach.scale.set(5.25, 1, 2.15);
60
+ beach.receiveShadow = true;
61
+ coast.add(beach);
62
+
63
+ const grass = new Mesh(new CylinderGeometry(1, 1, 0.09, 32), materials.grass);
64
+ grass.name = "island-grass";
65
+ grass.position.y = 0.02;
66
+ grass.scale.set(4.82, 1, 1.72);
67
+ grass.receiveShadow = true;
68
+ coast.add(grass);
69
+
70
+ const shoreRing = new Mesh(new TorusGeometry(1, 0.055, 5, 32), materials.shoreline);
71
+ shoreRing.name = "island-shoreline";
72
+ shoreRing.position.y = 0.025;
73
+ shoreRing.scale.set(5.12, 1, 2.02);
74
+ shoreRing.receiveShadow = true;
75
+ coast.add(shoreRing);
76
+
77
+ const path = block(4.8, 0.035, 0.5, materials.sand, {
78
+ castShadow: false,
79
+ radius: 0.12,
80
+ });
81
+ path.name = "island-footpath";
82
+ path.position.set(0.1, 0.065, 0);
83
+ coast.add(path);
84
+
85
+ const bladeGeometry = new ConeGeometry(0.075, 0.58, 5);
86
+ for (const [x, z, scale] of TUFTS) addTuft(coast, bladeGeometry, materials, x, z, scale, random);
87
+
88
+ const reedGeometry = new ConeGeometry(0.06, 0.82, 5);
89
+ for (const x of REEDS) addReeds(coast, reedGeometry, materials, x, random);
90
+
91
+ const rockGeometry = new DodecahedronGeometry(1, 0);
92
+ for (const [x, z, scale] of [
93
+ [-4.45, 0.65, 0.42],
94
+ [-3.95, -0.52, 0.3],
95
+ [4.42, -0.62, 0.4],
96
+ [4.05, 0.72, 0.28],
97
+ ] as const) {
98
+ const rock = new Mesh(rockGeometry, materials.rock);
99
+ rock.position.set(x, 0.12, z);
100
+ rock.scale.set(scale * 1.35, scale, scale * 0.9);
101
+ rock.rotation.set(random() * 0.3, random() * Math.PI, random() * 0.2);
102
+ rock.castShadow = true;
103
+ rock.receiveShadow = true;
104
+ coast.add(rock);
105
+ }
106
+
107
+ for (const [x, z] of [
108
+ [-2.95, 1.05],
109
+ [2.55, -1.03],
110
+ [3.45, 0.92],
111
+ ] as const)
112
+ addFlower(coast, materials, x, z);
113
+
114
+ addDistantIslands(coast, materials.rock);
115
+ return coast;
116
+ }
117
+
118
+ function addTuft(
119
+ parent: Group,
120
+ geometry: ConeGeometry,
121
+ materials: ICoastalMaterials,
122
+ x: number,
123
+ z: number,
124
+ scale: number,
125
+ random: () => number,
126
+ ): void {
127
+ const tuft = new Group();
128
+ tuft.position.set(x, 0.09, z);
129
+ const lean = (random() - 0.5) * 0.28;
130
+ for (const [offset, material] of [
131
+ [-0.09, materials.grassDark],
132
+ [0, materials.grass],
133
+ [0.09, materials.grassDark],
134
+ ] as const) {
135
+ const blade = new Mesh(geometry, material);
136
+ blade.position.x = offset;
137
+ blade.rotation.z = lean + offset;
138
+ blade.rotation.y = random() * Math.PI;
139
+ blade.scale.setScalar(scale * (0.9 + random() * 0.18));
140
+ blade.castShadow = true;
141
+ tuft.add(blade);
142
+ }
143
+ parent.add(tuft);
144
+ }
145
+
146
+ function addReeds(
147
+ parent: Group,
148
+ geometry: ConeGeometry,
149
+ materials: ICoastalMaterials,
150
+ x: number,
151
+ random: () => number,
152
+ ): void {
153
+ const reeds = new Group();
154
+ reeds.position.set(x, 0.1, -1.5);
155
+ for (let index = 0; index < 3; index += 1) {
156
+ const reed = new Mesh(geometry, materials.grassDark);
157
+ reed.position.set((index - 1) * 0.1, index * 0.03, (random() - 0.5) * 0.14);
158
+ reed.rotation.z = (random() - 0.5) * 0.32;
159
+ reed.rotation.y = random() * Math.PI;
160
+ reed.scale.setScalar(0.72 + random() * 0.2);
161
+ reed.castShadow = true;
162
+ reeds.add(reed);
163
+ }
164
+ parent.add(reeds);
165
+ }
166
+
167
+ function addFlower(parent: Group, materials: ICoastalMaterials, x: number, z: number): void {
168
+ const flower = new Group();
169
+ flower.position.set(x, 0.1, z);
170
+ const stem = new Mesh(new CylinderGeometry(0.018, 0.028, 0.34, 6), materials.grassDark);
171
+ stem.position.y = 0.17;
172
+ const head = new Mesh(new SphereGeometry(0.095, 8, 6), materials.flower);
173
+ head.position.y = 0.37;
174
+ stem.castShadow = true;
175
+ head.castShadow = true;
176
+ flower.add(stem, head);
177
+ parent.add(flower);
178
+ }
179
+
180
+ function addDistantIslands(parent: Group, material: Material): void {
181
+ const horizon = new Group();
182
+ horizon.name = "distant-islands";
183
+ const geometry = new DodecahedronGeometry(1, 1);
184
+ for (const [x, z, scale] of [
185
+ [-10, -13, 2.1],
186
+ [-3.7, -16, 1.4],
187
+ [5.5, -14, 1.8],
188
+ [12, -19, 2.7],
189
+ ] as const) {
190
+ const island = new Mesh(geometry, material);
191
+ island.position.set(x, -0.25, z);
192
+ island.scale.set(scale * 1.45, scale * 0.62, scale);
193
+ island.rotation.y = x * 0.13;
194
+ island.castShadow = false;
195
+ island.receiveShadow = false;
196
+ horizon.add(island);
197
+ }
198
+ parent.add(horizon);
199
+ }
@@ -0,0 +1,5 @@
1
+ // Generated for you. This is ordinary game-owned source — edit or delete it freely.
2
+ // Curves decide the feel of a motion, so they live beside the rest of the starter's look.
3
+
4
+ /** Raise the pickup quickly, then settle it gently onto its hover height. */
5
+ export const pickupRiseEase = (t: number): number => 1 - (1 - t) ** 3;
@@ -0,0 +1,48 @@
1
+ // Generated for you: ordinary Three.js TSL; edit or delete it freely.
2
+ // Algorithm translated from 0beqz/realism-effects/src/gradual-background/GradualBackgroundEffect.js.
3
+ // Source project: MIT.
4
+ import { Fn, linearDepth, mix, smoothstep, uv, vec3, vec4, viewportLinearDepth } from "three/tsl";
5
+ import type { Node, TextureNode } from "three/webgpu";
6
+
7
+ // Appearance choices belong to this generated game source.
8
+ export const GRADUAL_BACKGROUND_START = 0.18;
9
+ export const GRADUAL_BACKGROUND_END = 0.86;
10
+ export const GRADUAL_BACKGROUND_STRENGTH = 0.65;
11
+ export const GRADUAL_BACKGROUND_BOTTOM = [0.015, 0.025, 0.06] as const;
12
+ export const GRADUAL_BACKGROUND_TOP = [0.24, 0.12, 0.32] as const;
13
+
14
+ export interface IGradualBackgroundOptions {
15
+ readonly bottom?: readonly [number, number, number];
16
+ /** Scene depth from the pass that produced `inputNode`; omit to use the viewport depth texture. */
17
+ readonly depth?: Node<"float">;
18
+ readonly end?: number;
19
+ readonly start?: number;
20
+ readonly strength?: number;
21
+ readonly top?: readonly [number, number, number];
22
+ }
23
+
24
+ /**
25
+ * Grade a background by screen height and scene distance toward the upper sky.
26
+ *
27
+ * `inputNode` is a **texture** node, not any vec4 node: this effect calls `.sample()` on it,
28
+ * and only a materialised texture answers that. Pass `convertToTexture(previousStage)`.
29
+ */
30
+ export function gradualBackground(
31
+ inputNode: TextureNode,
32
+ options: IGradualBackgroundOptions = {},
33
+ ): Node<"vec4"> {
34
+ const start = options.start ?? GRADUAL_BACKGROUND_START;
35
+ const end = options.end ?? GRADUAL_BACKGROUND_END;
36
+ const strength = options.strength ?? GRADUAL_BACKGROUND_STRENGTH;
37
+ const bottom = options.bottom ?? GRADUAL_BACKGROUND_BOTTOM;
38
+ const top = options.top ?? GRADUAL_BACKGROUND_TOP;
39
+ const distance = options.depth === undefined ? viewportLinearDepth : linearDepth(options.depth);
40
+ return Fn(() => {
41
+ const colour = inputNode.sample(uv());
42
+ const verticalGradient = smoothstep(start, end, uv().y);
43
+ const distanceGradient = smoothstep(start, end, distance);
44
+ const gradient = mix(verticalGradient, distanceGradient, 0.7);
45
+ const background = mix(vec3(...bottom), vec3(...top), gradient);
46
+ return vec4(mix(colour.rgb, background, strength), colour.a);
47
+ })();
48
+ }
@@ -0,0 +1,43 @@
1
+ // Generated for you: ordinary Three.js TSL; edit or delete it freely.
2
+ // Algorithm translated from 0beqz/realism-effects/src/lens-distortion/LensDistortionEffect.js.
3
+ // Source project: MIT. Radial model reference: https://marcodiiga.github.io/radial-lens-undistortion-filtering
4
+ import { Fn, float, uv, vec2, vec4 } from "three/tsl";
5
+ import type { Node, TextureNode } from "three/webgpu";
6
+
7
+ // Appearance choices belong to this generated game source.
8
+ export const LENS_DISTORTION_K1 = -0.18;
9
+ export const LENS_DISTORTION_K2 = 0.04;
10
+ export const LENS_DISTORTION_CHROMATIC_ABERRATION = 0.0025;
11
+
12
+ export interface ILensDistortionOptions {
13
+ readonly chromaticAberration?: number;
14
+ readonly k1?: number;
15
+ readonly k2?: number;
16
+ }
17
+
18
+ /**
19
+ * Apply radial undistortion with a small per-channel chromatic offset.
20
+ *
21
+ * `inputNode` is a **texture** node, not any vec4 node: this effect calls `.sample()` on it,
22
+ * and only a materialised texture answers that. Pass `convertToTexture(previousStage)`.
23
+ */
24
+ export function lensDistortion(
25
+ inputNode: TextureNode,
26
+ options: ILensDistortionOptions = {},
27
+ ): Node<"vec4"> {
28
+ const k1 = options.k1 ?? LENS_DISTORTION_K1;
29
+ const k2 = options.k2 ?? LENS_DISTORTION_K2;
30
+ const chromaticAberration = options.chromaticAberration ?? LENS_DISTORTION_CHROMATIC_ABERRATION;
31
+ return Fn(() => {
32
+ const centered = uv().sub(0.5);
33
+ const radiusSquared = centered.dot(centered);
34
+ const radial = float(1)
35
+ .add(radiusSquared.mul(k1))
36
+ .add(radiusSquared.mul(radiusSquared).mul(k2));
37
+ const distorted = centered.mul(radial).add(0.5).clamp(0, 1);
38
+ const red = inputNode.sample(distorted.add(vec2(chromaticAberration, 0))).r;
39
+ const green = inputNode.sample(distorted).g;
40
+ const blue = inputNode.sample(distorted.sub(vec2(chromaticAberration, 0))).b;
41
+ return vec4(red, green, blue, inputNode.sample(distorted).a);
42
+ })();
43
+ }
@@ -0,0 +1,49 @@
1
+ // Generated for you: ordinary Three.js TSL; edit or delete it freely.
2
+ // Algorithm translated from 0beqz/realism-effects/src/sparkle/SparkleEffect.js.
3
+ // Source project: MIT.
4
+ import { Fn, float, sin, smoothstep, uv, vec3, vec4 } from "three/tsl";
5
+ import type { Node, TextureNode } from "three/webgpu";
6
+
7
+ // Appearance choices belong to this generated game source.
8
+ export const SPARKLE_THRESHOLD = 0.55;
9
+ export const SPARKLE_COUNT = 38;
10
+ export const SPARKLE_LENGTH = 0.48;
11
+ export const SPARKLE_COLOUR = [1, 0.82, 0.42] as const;
12
+
13
+ export interface ISparkleOptions {
14
+ readonly colour?: readonly [number, number, number];
15
+ readonly count?: number;
16
+ readonly length?: number;
17
+ readonly threshold?: number;
18
+ }
19
+
20
+ /**
21
+ * Add deterministic highlight glints without a texture or a framework-owned material.
22
+ *
23
+ * `inputNode` is a **texture** node, not any vec4 node: this effect calls `.sample()` on it,
24
+ * and only a materialised texture answers that. Pass `convertToTexture(previousStage)`.
25
+ */
26
+ export function sparkle(inputNode: TextureNode, options: ISparkleOptions = {}): Node<"vec4"> {
27
+ const threshold = options.threshold ?? SPARKLE_THRESHOLD;
28
+ const count = options.count ?? SPARKLE_COUNT;
29
+ const length = options.length ?? SPARKLE_LENGTH;
30
+ const sparkleColour = options.colour ?? SPARKLE_COLOUR;
31
+ return Fn(() => {
32
+ const colour = inputNode.sample(uv());
33
+ const cell = uv().mul(count).fract().sub(0.5);
34
+ const diagonal = cell.x.add(cell.y).abs();
35
+ const cross = cell.x.sub(cell.y).abs();
36
+ const streak = float(1)
37
+ .sub(smoothstep(0, length, diagonal))
38
+ .mul(float(1).sub(smoothstep(0, length, cross)));
39
+ const brightness = colour.rgb
40
+ .add(0.0001)
41
+ .length()
42
+ .sub(threshold)
43
+ .div(float(1).sub(threshold))
44
+ .clamp(0, 1);
45
+ const phase = sin(uv().x.mul(91.7).add(uv().y.mul(173.1))).abs();
46
+ const glint = streak.mul(brightness).mul(phase);
47
+ return vec4(colour.rgb.add(vec3(...sparkleColour).mul(glint)), colour.a);
48
+ })();
49
+ }
@@ -0,0 +1,88 @@
1
+ // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
+ // ThreeNative does not read this file.
3
+ //
4
+ // The player character, built from the rounded primitives in `shapes.ts`. It lives in its own
5
+ // file because it is the one object here with a design rather than a shape: fifteen placed boxes
6
+ // in three materials, merged down per material so the whole character costs three draw calls.
7
+ import { type BufferGeometry, type Material, Mesh } from "three";
8
+ import { roundedBox } from "./shapes.js";
9
+
10
+ export interface IHeroMaterials {
11
+ readonly accent: Material;
12
+ readonly body: Material;
13
+ readonly dark: Material;
14
+ }
15
+
16
+ export type HeroPartMerger = (
17
+ parts: Iterable<Mesh>,
18
+ options: { readonly label: string },
19
+ ) => BufferGeometry;
20
+
21
+ /**
22
+ * The player character.
23
+ *
24
+ * A `roundedBox(0.6, 1, 0.6)` in one cream colour is what stood here, and it is the first thing a
25
+ * new project shows anyone: a featureless pill. The hero is the one object in a starter scene that
26
+ * has to look deliberate, because everything else — the ledge, the crate, the flag — is obviously
27
+ * scaffolding and reads fine as scaffolding.
28
+ *
29
+ * Authored **centred on y = 0** so `normaliseToMetres(model, { axis: "height", metres: 1.1 })`
30
+ * scales it without moving the feet off the collision capsule.
31
+ *
32
+ * The returned value is a `Mesh`, not a `Group`, because `Player.visual` is one and both
33
+ * `GroundSnap` and `preparePlayerConventions` are written against it. Children hang off it.
34
+ */
35
+ export function hero(materials: IHeroMaterials, mergeParts: HeroPartMerger): Mesh {
36
+ const parts = new Map<Material, Mesh[]>();
37
+ const add = (mesh: Mesh): Mesh => {
38
+ const bucket = parts.get(mesh.material as Material);
39
+ if (bucket === undefined) parts.set(mesh.material as Material, [mesh]);
40
+ else bucket.push(mesh);
41
+ return mesh;
42
+ };
43
+
44
+ const torso = add(new Mesh(roundedBox(0.44, 0.42, 0.32, 0.13, 2), materials.body));
45
+ torso.position.y = 0.06;
46
+ const head = add(new Mesh(roundedBox(0.36, 0.32, 0.32, 0.13, 2), materials.body));
47
+ head.position.y = 0.42;
48
+ const visor = add(new Mesh(roundedBox(0.28, 0.1, 0.06, 0.03, 1), materials.dark));
49
+ visor.position.set(0, 0.37, -0.16);
50
+ const brim = add(new Mesh(roundedBox(0.46, 0.05, 0.42, 0.02, 1), materials.accent));
51
+ brim.position.y = 0.52;
52
+ const crown = add(new Mesh(roundedBox(0.3, 0.16, 0.28, 0.08, 2), materials.accent));
53
+ crown.position.y = 0.6;
54
+ const scarf = add(new Mesh(roundedBox(0.42, 0.1, 0.34, 0.05, 1), materials.accent));
55
+ scarf.position.y = 0.19;
56
+ const tail = add(new Mesh(roundedBox(0.12, 0.26, 0.08, 0.04, 1), materials.accent));
57
+ tail.position.set(0.02, 0.06, 0.19);
58
+ tail.rotation.x = 0.5;
59
+ const pack = add(new Mesh(roundedBox(0.28, 0.28, 0.16, 0.07, 2), materials.dark));
60
+ pack.position.set(0, 0.06, 0.2);
61
+
62
+ for (const side of [-1, 1]) {
63
+ const arm = add(new Mesh(roundedBox(0.12, 0.3, 0.14, 0.055, 1), materials.body));
64
+ arm.position.set(side * 0.28, 0.02, 0);
65
+ arm.rotation.z = side * -0.16;
66
+ const hand = add(new Mesh(roundedBox(0.12, 0.11, 0.13, 0.05, 1), materials.dark));
67
+ hand.position.set(side * 0.31, -0.15, 0);
68
+ const leg = add(new Mesh(roundedBox(0.15, 0.3, 0.16, 0.06, 1), materials.dark));
69
+ leg.position.set(side * 0.12, -0.36, 0);
70
+ const boot = add(new Mesh(roundedBox(0.17, 0.1, 0.22, 0.045, 1), materials.accent));
71
+ boot.position.set(side * 0.12, -0.51, -0.02);
72
+ }
73
+
74
+ // Merged down to one mesh per material: fifteen little boxes is fifteen draw calls for one
75
+ // character, and with the shadow pass that is thirty. The three materials stay separate, so the
76
+ // hat, the pack and the body are still repainted from `materials.ts` alone.
77
+ const meshes: Mesh[] = [];
78
+ for (const [material, group] of parts) {
79
+ const merged = new Mesh(mergeParts(group, { label: "hero" }), material);
80
+ merged.castShadow = true;
81
+ merged.receiveShadow = true;
82
+ meshes.push(merged);
83
+ }
84
+ const root = meshes[0];
85
+ if (root === undefined) throw new Error("The hero produced no geometry.");
86
+ for (const extra of meshes.slice(1)) root.add(extra);
87
+ return root;
88
+ }
@@ -0,0 +1,199 @@
1
+ // Generated source. It extracts a closed field and owns no renderer or appearance choice.
2
+ type Point = [number, number, number];
3
+ type Triangle = [number, number, number];
4
+ type SurfaceOptions = Readonly<{
5
+ bounds: Record<"maxX" | "maxY" | "maxZ" | "minX" | "minY" | "minZ", number>;
6
+ cellSize: number;
7
+ latticeCap: number;
8
+ sample: (x: number, y: number, z: number) => number;
9
+ closed?: boolean;
10
+ protectBoundary?: boolean;
11
+ }>;
12
+ function createSurfaceFunctions() {
13
+ // biome-ignore format: compact generated helper keeps the render source under its smell budget.
14
+ function failSurface(name: string, message: string): never {
15
+ const error = new Error(`${name}: ${message}`);
16
+ error.name = name;
17
+ throw error;
18
+ }
19
+ // biome-ignore format: compact generated helper keeps the render source under its smell budget.
20
+ function readPoint(array: ArrayLike<number>, vertex: number): Point {
21
+ return [array[vertex * 3] as number, array[vertex * 3 + 1] as number, array[vertex * 3 + 2] as number];
22
+ }
23
+ // biome-ignore format: compact generated helper keeps the render source under its smell budget.
24
+ function triangleMetrics(a: Point, b: Point, c: Point): [number, number] {
25
+ const u: Point = [b[0] - a[0], b[1] - a[1], b[2] - a[2]];
26
+ const v: Point = [c[0] - a[0], c[1] - a[1], c[2] - a[2]];
27
+ const n: Point = [u[1] * v[2] - u[2] * v[1], u[2] * v[0] - u[0] * v[2], u[0] * v[1] - u[1] * v[0]];
28
+ return [n[0] * n[0] + n[1] * n[1] + n[2] * n[2], a[0] * (b[1] * c[2] - b[2] * c[1]) + a[1] * (b[2] * c[0] - b[0] * c[2]) + a[2] * (b[0] * c[1] - b[1] * c[0])];
29
+ }
30
+ // biome-ignore format: compact generated helper keeps the render source under its smell budget.
31
+ function touchSurfaceEdge(edges: Map<string, Point>, from: number, to: number): void {
32
+ const key = from < to ? `${from}|${to}` : `${to}|${from}`;
33
+ const edge = edges.get(key) ?? [0, 0, 0];
34
+ edge[0] += 1; edge[1] += from < to ? 1 : -1; edges.set(key, edge);
35
+ }
36
+ // biome-ignore format: compact generated helper keeps the render source under its smell budget.
37
+ function auditImplicitSurface(indices: Uint32Array, positions: Float32Array) {
38
+ const edges = new Map<string, Point>();
39
+ const counts = { boundaryEdges: 0, degenerateTriangles: 0, signedVolume: 0, windingConflicts: 0 };
40
+ for (let index = 0; index < indices.length; index += 3) {
41
+ const a = indices[index] as number; const b = indices[index + 1] as number; const c = indices[index + 2] as number;
42
+ if (a >= positions.length / 3 || b >= positions.length / 3 || c >= positions.length / 3)
43
+ failSurface("TN_IMPLICIT_SURFACE_INDEX_INVALID", `triangle ${index / 3} references a missing vertex.`);
44
+ touchSurfaceEdge(edges, a, b); touchSurfaceEdge(edges, b, c); touchSurfaceEdge(edges, c, a);
45
+ const [area, volume] = triangleMetrics(readPoint(positions, a), readPoint(positions, b), readPoint(positions, c));
46
+ if (area < 1e-14) counts.degenerateTriangles += 1;
47
+ counts.signedVolume += volume;
48
+ }
49
+ for (const [count, direction] of edges.values()) {
50
+ if (count !== 2) counts.boundaryEdges += 1;
51
+ if (count === 2 && direction !== 0) counts.windingConflicts += 1;
52
+ }
53
+ return { ...counts, signedVolume: counts.signedVolume / 6, triangles: indices.length / 3, vertices: positions.length / 3 };
54
+ }
55
+ // biome-ignore format: compact generated helper keeps the render source under its smell budget.
56
+ function addSurfaceTriangle(output: number[], positions: number[], sample: SurfaceOptions["sample"], dx: number, dy: number, dz: number, vertices: Triangle): void {
57
+ const [va, vb, vc] = vertices;
58
+ const [a, b, c] = [readPoint(positions, va), readPoint(positions, vb), readPoint(positions, vc)] as [Point, Point, Point];
59
+ const [area] = triangleMetrics(a, b, c);
60
+ if (area < 1e-14) return;
61
+ const center: Point = [(a[0] + b[0] + c[0]) / 3, (a[1] + b[1] + c[1]) / 3, (a[2] + b[2] + c[2]) / 3];
62
+ const gradient: Point = [
63
+ sample(center[0] + dx * 0.25, center[1], center[2]) - sample(center[0] - dx * 0.25, center[1], center[2]),
64
+ sample(center[0], center[1] + dy * 0.25, center[2]) - sample(center[0], center[1] - dy * 0.25, center[2]),
65
+ sample(center[0], center[1], center[2] + dz * 0.25) - sample(center[0], center[1], center[2] - dz * 0.25),
66
+ ];
67
+ const n: Point = [(b[1] - a[1]) * (c[2] - a[2]) - (b[2] - a[2]) * (c[1] - a[1]), (b[2] - a[2]) * (c[0] - a[0]) - (b[0] - a[0]) * (c[2] - a[2]), (b[0] - a[0]) * (c[1] - a[1]) - (b[1] - a[1]) * (c[0] - a[0])];
68
+ if (n[0] * gradient[0] + n[1] * gradient[1] + n[2] * gradient[2] >= 0) output.push(va, vb, vc); else output.push(va, vc, vb);
69
+ }
70
+ // biome-ignore format: compact generated helper keeps the render source under its smell budget.
71
+ // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: the bounded adjacency walk orients the final closed mesh.
72
+ function orientSurface(indices: Uint32Array): void {
73
+ const links = new Map<string, Array<[number, number]>>();
74
+ for (let triangle = 0; triangle < indices.length; triangle += 3) for (let edge = 0; edge < 3; edge++) {
75
+ const from = indices[triangle + edge] as number; const to = indices[triangle + (edge + 1) % 3] as number;
76
+ const key = from < to ? `${from}|${to}` : `${to}|${from}`;
77
+ const linked = links.get(key) ?? []; linked.push([triangle, from < to ? 1 : -1]); links.set(key, linked);
78
+ }
79
+ const flips = new Map<number, boolean>();
80
+ for (let start = 0; start < indices.length; start += 3) if (!flips.has(start)) {
81
+ const queue = [start]; flips.set(start, false); while (queue.length > 0) {
82
+ const triangle = queue.pop() as number; const flip = flips.get(triangle) as boolean;
83
+ for (let edge = 0; edge < 3; edge++) {
84
+ const from = indices[triangle + edge] as number; const to = indices[triangle + (edge + 1) % 3] as number;
85
+ const key = from < to ? `${from}|${to}` : `${to}|${from}`;
86
+ for (const [other, otherDirection] of links.get(key) ?? []) if (other !== triangle && !flips.has(other)) {
87
+ flips.set(other, flip !== ((from < to ? 1 : -1) === otherDirection)); queue.push(other);
88
+ }
89
+ }
90
+ }
91
+ }
92
+ for (const [triangle, flip] of flips) if (flip) {
93
+ const swap = indices[triangle + 1] as number; indices[triangle + 1] = indices[triangle + 2] as number; indices[triangle + 2] = swap;
94
+ }
95
+ }
96
+ // biome-ignore format: compact generated helper keeps the render source under its smell budget.
97
+ // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: the bounded lattice traversal is the extractor.
98
+ function buildImplicitSurface(options: SurfaceOptions) {
99
+ const started = Date.now();
100
+ const { bounds } = options;
101
+ if ([bounds.minX, bounds.maxX, bounds.minY, bounds.maxY, bounds.minZ, bounds.maxZ].some((value) => !Number.isFinite(value)))
102
+ failSurface("TN_IMPLICIT_SURFACE_BOUNDS_INVALID", "bounds must be finite.");
103
+ if (bounds.maxX <= bounds.minX || bounds.maxY <= bounds.minY || bounds.maxZ <= bounds.minZ)
104
+ failSurface("TN_IMPLICIT_SURFACE_BOUNDS_INVALID", "each maximum must exceed its minimum.");
105
+ if (!Number.isFinite(options.cellSize) || options.cellSize <= 0)
106
+ failSurface("TN_IMPLICIT_SURFACE_CELL_INVALID", "cellSize must be positive and finite.");
107
+ if (!Number.isSafeInteger(options.latticeCap) || options.latticeCap <= 0)
108
+ failSurface("TN_IMPLICIT_SURFACE_CAP_INVALID", "latticeCap must be a positive safe integer.");
109
+ const nx = Math.max(1, Math.ceil((bounds.maxX - bounds.minX) / options.cellSize));
110
+ const ny = Math.max(1, Math.ceil((bounds.maxY - bounds.minY) / options.cellSize));
111
+ const nz = Math.max(1, Math.ceil((bounds.maxZ - bounds.minZ) / options.cellSize));
112
+ const width = nx + 1;
113
+ const height = ny + 1;
114
+ const depth = nz + 1;
115
+ const latticeLength = width * height * depth;
116
+ if (!Number.isSafeInteger(latticeLength) || latticeLength > options.latticeCap)
117
+ failSurface("TN_IMPLICIT_SURFACE_LATTICE_OVERFLOW", `lattice requires ${latticeLength} samples.`);
118
+ const dx = (bounds.maxX - bounds.minX) / nx;
119
+ const dy = (bounds.maxY - bounds.minY) / ny;
120
+ const dz = (bounds.maxZ - bounds.minZ) / nz;
121
+ const cell = Math.max(dx, dy, dz);
122
+ const sample = (x: number, y: number, z: number): number => {
123
+ const value = options.sample(x, y, z);
124
+ if (!Number.isFinite(value)) failSurface("TN_IMPLICIT_SURFACE_SAMPLE_INVALID", `sample at ${x},${y},${z} is not finite.`);
125
+ return value === 0 ? 1e-8 : value;
126
+ };
127
+ const indexOf = (x: number, y: number, z: number): number => x + width * (y + height * z);
128
+ const values = new Float64Array(latticeLength);
129
+ for (let z = 0; z < depth; z += 1) for (let y = 0; y < height; y += 1) for (let x = 0; x < width; x += 1) {
130
+ let value = sample(bounds.minX + x * dx, bounds.minY + y * dy, bounds.minZ + z * dz);
131
+ if (options.protectBoundary !== false && (x === 0 || y === 0 || z === 0 || x === nx || y === ny || z === nz)) value = Math.max(value, cell * 0.5);
132
+ values[indexOf(x, y, z)] = value;
133
+ }
134
+ const corners = "000 100 110 010 001 101 111 011".split(" ").map((value) => [...value].map(Number)) as Array<[number, number, number]>;
135
+ const tetrahedra = "0516 0126 0236 0376 0746 0456".split(" ").map((value) => [...value].map(Number)) as Array<[number, number, number, number]>;
136
+ // biome-ignore format: compact generated lookup stays within the render-source smell budget.
137
+ const tetraCases: number[][][][] = [[], [[[0, 1], [0, 2], [0, 3]]], [[[0, 1], [1, 2], [1, 3]]], [[[0, 2], [1, 2], [1, 3]], [[0, 2], [1, 3], [0, 3]]], [[[0, 2], [1, 2], [2, 3]]], [[[0, 1], [1, 2], [2, 3]], [[0, 1], [2, 3], [0, 3]]], [[[0, 1], [1, 3], [2, 3]], [[0, 1], [2, 3], [0, 2]]], [[[0, 3], [1, 3], [2, 3]]], [[[0, 3], [1, 3], [2, 3]]], [[[0, 1], [1, 3], [2, 3]], [[0, 1], [2, 3], [0, 2]]], [[[0, 1], [1, 2], [2, 3]], [[0, 1], [2, 3], [0, 3]]], [[[0, 2], [1, 2], [2, 3]]], [[[0, 2], [1, 2], [1, 3]], [[0, 2], [1, 3], [0, 3]]], [[[0, 1], [1, 2], [1, 3]]], [[[0, 1], [0, 2], [0, 3]]], []];
138
+ const positions: number[] = [];
139
+ const rawIndices: number[] = [];
140
+ const edgeVertices = new Map<string, number>();
141
+ const point = (index: number): Point => [bounds.minX + (index % width) * dx, bounds.minY + (Math.floor(index / width) % height) * dy, bounds.minZ + Math.floor(index / (width * height)) * dz];
142
+ const edgePoint = (a: number, b: number): number => {
143
+ const key = a < b ? `${a}|${b}` : `${b}|${a}`;
144
+ const existing = edgeVertices.get(key);
145
+ if (existing !== undefined) return existing;
146
+ const fa = values[a] as number;
147
+ const fb = values[b] as number;
148
+ const t = Math.max(0.015, Math.min(0.985, fa / (fa - fb)));
149
+ const pa = point(a);
150
+ const pb = point(b);
151
+ const vertex = positions.length / 3;
152
+ positions.push(pa[0] + (pb[0] - pa[0]) * t, pa[1] + (pb[1] - pa[1]) * t, pa[2] + (pb[2] - pa[2]) * t);
153
+ edgeVertices.set(key, vertex);
154
+ return vertex;
155
+ };
156
+ for (let z = 0; z < nz; z += 1) for (let y = 0; y < ny; y += 1) for (let x = 0; x < nx; x += 1) {
157
+ const indexes: number[] = [];
158
+ const field: number[] = [];
159
+ for (const corner of corners) {
160
+ const index = indexOf(x + corner[0], y + corner[1], z + corner[2]);
161
+ indexes.push(index); field.push(values[index] as number);
162
+ }
163
+ for (const tetrahedron of tetrahedra) {
164
+ let code = 0;
165
+ for (let corner = 0; corner < 4; corner += 1)
166
+ if ((field[tetrahedron[corner] as number] as number) < 0) code |= 1 << corner;
167
+ const tetVertex = (crossing: number[]): number =>
168
+ edgePoint(indexes[tetrahedron[crossing[0] as number] as number] as number, indexes[tetrahedron[crossing[1] as number] as number] as number);
169
+ for (const triangle of tetraCases[code] ?? [])
170
+ addSurfaceTriangle(rawIndices, positions, sample, dx, dy, dz, [tetVertex(triangle[0] as number[]), tetVertex(triangle[1] as number[]), tetVertex(triangle[2] as number[])]);
171
+ }
172
+ }
173
+ if (rawIndices.length === 0) failSurface("TN_IMPLICIT_SURFACE_EMPTY", "the field contains no triangles.");
174
+ const outputPositions = Float32Array.from(positions);
175
+ const outputIndices = Uint32Array.from(rawIndices);
176
+ orientSurface(outputIndices);
177
+ let report = auditImplicitSurface(outputIndices, outputPositions);
178
+ if (report.signedVolume < 0) {
179
+ for (let index = 0; index < outputIndices.length; index += 3) {
180
+ const swap = outputIndices[index + 1] as number;
181
+ outputIndices[index + 1] = outputIndices[index + 2] as number;
182
+ outputIndices[index + 2] = swap;
183
+ }
184
+ report = auditImplicitSurface(outputIndices, outputPositions);
185
+ }
186
+ if (options.closed !== false && (report.boundaryEdges > 0 || report.degenerateTriangles > 0 || report.windingConflicts > 0))
187
+ failSurface("TN_IMPLICIT_SURFACE_TOPOLOGY_INVALID", `boundary=${report.boundaryEdges}, degenerate=${report.degenerateTriangles}, winding=${report.windingConflicts}.`);
188
+ if (options.closed !== false && report.signedVolume <= Math.max(cell ** 3 * 0.01, 1e-8))
189
+ failSurface("TN_IMPLICIT_SURFACE_VOLUME_INVALID", `signed volume ${report.signedVolume} is not non-trivial.`);
190
+ return { indices: outputIndices, positions: outputPositions, report: { ...report, buildMs: Math.max(0, Date.now() - started), cellSize: cell } };
191
+ }
192
+ return { auditImplicitSurface, buildImplicitSurface };
193
+ }
194
+ export const { auditImplicitSurface, buildImplicitSurface } = createSurfaceFunctions();
195
+
196
+ export function createImplicitSurfaceWorkerSource(): string {
197
+ // biome-ignore format: compact generated source list keeps this file under its smell budget.
198
+ return `const { auditImplicitSurface, buildImplicitSurface } = (${createSurfaceFunctions.toString()})();`;
199
+ }