@downdraft/engine 0.0.0 → 0.1.1

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 (908) hide show
  1. package/README.md +33 -0
  2. package/app/src/index.ts +10 -0
  3. package/app/src/renderer/bootstrap.ts +271 -0
  4. package/app/src/renderer/downdraft-base.css +93 -0
  5. package/app/src/renderer/feature-log.ts +200 -0
  6. package/app/src/renderer/game-module.ts +923 -0
  7. package/app/src/renderer/hooks.ts +88 -0
  8. package/app/src/renderer/hot-reload.ts +178 -0
  9. package/app/src/renderer/import-cache.ts +88 -0
  10. package/app/src/renderer/index.ts +206 -0
  11. package/app/src/renderer/mcp-harness.ts +144 -0
  12. package/app/src/renderer/save-store-factory.ts +239 -0
  13. package/app/src/renderer/sim-bridge.ts +183 -0
  14. package/app/src/renderer/standard-automation-tools.ts +771 -0
  15. package/app/src/shared/feature-log.ts +71 -0
  16. package/app/src/shared/gpu-info.ts +82 -0
  17. package/app/src/shared/import-cache-store.ts +142 -0
  18. package/app/src/shared/index.ts +6 -0
  19. package/app/src/shared/mcp-discovery.ts +47 -0
  20. package/app/src/shared/mcp-proxy.ts +82 -0
  21. package/app/src/shared/types.ts +324 -0
  22. package/asset-bake/src/bake-audio.ts +119 -0
  23. package/asset-bake/src/bake-gltf.ts +172 -0
  24. package/asset-bake/src/bake.ts +78 -0
  25. package/asset-bake/src/cache.ts +188 -0
  26. package/asset-bake/src/config.ts +186 -0
  27. package/asset-bake/src/index.ts +36 -0
  28. package/core/src/animation/animation-event.ts +41 -0
  29. package/core/src/animation/bone-mask.ts +122 -0
  30. package/core/src/animation/clip.ts +252 -0
  31. package/core/src/animation/index.ts +22 -0
  32. package/core/src/animation/mixamo.ts +113 -0
  33. package/core/src/animation/morph-target.ts +69 -0
  34. package/core/src/animation/player.ts +697 -0
  35. package/core/src/animation/retarget.ts +158 -0
  36. package/core/src/animation/skeleton-animator.ts +1399 -0
  37. package/core/src/animation/skeleton.ts +214 -0
  38. package/core/src/animation/state-machine.ts +280 -0
  39. package/core/src/assets/blob-store.ts +66 -0
  40. package/core/src/assets/cache.ts +186 -0
  41. package/core/src/assets/cubemap-converter.ts +155 -0
  42. package/core/src/assets/environment-manager.ts +121 -0
  43. package/core/src/assets/import-cache.ts +65 -0
  44. package/core/src/assets/import-settings.ts +72 -0
  45. package/core/src/assets/importer.ts +108 -0
  46. package/core/src/assets/index.ts +74 -0
  47. package/core/src/assets/irradiance-generator.ts +198 -0
  48. package/core/src/assets/loader-audio.ts +86 -0
  49. package/core/src/assets/loader-cubemap.ts +211 -0
  50. package/core/src/assets/loader-dds.ts +236 -0
  51. package/core/src/assets/loader-hdr.ts +474 -0
  52. package/core/src/assets/loader-mesh.ts +143 -0
  53. package/core/src/assets/loader-shader.ts +73 -0
  54. package/core/src/assets/loader-texture.ts +349 -0
  55. package/core/src/assets/lod.ts +198 -0
  56. package/core/src/assets/manager.ts +480 -0
  57. package/core/src/assets/manifest.ts +81 -0
  58. package/core/src/assets/material-bridge.ts +186 -0
  59. package/core/src/assets/model-importer.ts +72 -0
  60. package/core/src/assets/model-normalizer.ts +248 -0
  61. package/core/src/assets/model-to-gpu.ts +70 -0
  62. package/core/src/assets/model-to-mesh.ts +237 -0
  63. package/core/src/assets/prefilter-generator.ts +250 -0
  64. package/core/src/audio/engine.ts +177 -0
  65. package/core/src/audio/interface.ts +130 -0
  66. package/core/src/audio/listener.ts +32 -0
  67. package/core/src/audio/mixer.ts +141 -0
  68. package/core/src/audio/registry.ts +52 -0
  69. package/core/src/audio/sab.ts +87 -0
  70. package/core/src/audio/source.ts +89 -0
  71. package/core/src/change-detection/atomics.ts +1 -0
  72. package/core/src/change-detection/tracker.ts +47 -0
  73. package/core/src/debug-draw/lines.ts +64 -0
  74. package/core/src/debug-draw/points.ts +17 -0
  75. package/core/src/debug-draw/queue.ts +124 -0
  76. package/core/src/debug-draw/text.ts +25 -0
  77. package/core/src/ecs/archetype.ts +323 -0
  78. package/core/src/ecs/component.ts +188 -0
  79. package/core/src/ecs/entity.ts +25 -0
  80. package/core/src/ecs/events.ts +93 -0
  81. package/core/src/ecs/hierarchy.ts +124 -0
  82. package/core/src/ecs/hmr-swap-registry.ts +22 -0
  83. package/core/src/ecs/index.ts +25 -0
  84. package/core/src/ecs/query.ts +141 -0
  85. package/core/src/ecs/resource.ts +8 -0
  86. package/core/src/ecs/schedule.ts +181 -0
  87. package/core/src/ecs/system-params.ts +99 -0
  88. package/core/src/ecs/system.ts +42 -0
  89. package/core/src/ecs/world.ts +348 -0
  90. package/core/src/index.ts +352 -0
  91. package/core/src/input/context.ts +73 -0
  92. package/core/src/input/dom-handler.ts +380 -0
  93. package/core/src/input/local-player-manager.ts +218 -0
  94. package/core/src/input/mapping.ts +40 -0
  95. package/core/src/input/multi-sab-bridge.ts +276 -0
  96. package/core/src/input/multi-state.ts +54 -0
  97. package/core/src/input/sab-bridge.ts +71 -0
  98. package/core/src/input/state.ts +132 -0
  99. package/core/src/input/ui-router.ts +87 -0
  100. package/core/src/library/host.ts +317 -0
  101. package/core/src/library/index.ts +16 -0
  102. package/core/src/library/library.ts +292 -0
  103. package/core/src/material/compiler.ts +80 -0
  104. package/core/src/material/graph-bridge.ts +172 -0
  105. package/core/src/material/index.ts +9 -0
  106. package/core/src/material/library.ts +442 -0
  107. package/core/src/material/material.ts +156 -0
  108. package/core/src/material/variants.ts +61 -0
  109. package/core/src/math/mat4.ts +202 -0
  110. package/core/src/math/perlin-noise-2d.ts +77 -0
  111. package/core/src/math/perlin-noise-3d.ts +110 -0
  112. package/core/src/math/quat.ts +33 -0
  113. package/core/src/math/rng.ts +29 -0
  114. package/core/src/math/trig.ts +47 -0
  115. package/core/src/math/value-noise.ts +67 -0
  116. package/core/src/mesh/builder.ts +177 -0
  117. package/core/src/mesh/csg.ts +312 -0
  118. package/core/src/mesh/greased-line.ts +145 -0
  119. package/core/src/mesh/mesh.ts +17 -0
  120. package/core/src/mesh/parametric.ts +501 -0
  121. package/core/src/mesh/skinning.ts +67 -0
  122. package/core/src/mesh/vertex-layout.ts +91 -0
  123. package/core/src/module/cross-thread.ts +163 -0
  124. package/core/src/module/diagnostics.ts +123 -0
  125. package/core/src/module/host.ts +451 -0
  126. package/core/src/module/index.ts +22 -0
  127. package/core/src/module/module.ts +109 -0
  128. package/core/src/module/registry.ts +94 -0
  129. package/core/src/module/renderer-module.ts +247 -0
  130. package/core/src/module/ts-loader.ts +26 -0
  131. package/core/src/particles/compute-pass.ts +378 -0
  132. package/core/src/particles/emitter.ts +156 -0
  133. package/core/src/particles/index.ts +11 -0
  134. package/core/src/particles/particle-data.ts +47 -0
  135. package/core/src/particles/render-pass.ts +365 -0
  136. package/core/src/particles/simulator.ts +264 -0
  137. package/core/src/particles/system.ts +193 -0
  138. package/core/src/physics/body.ts +59 -0
  139. package/core/src/physics/ccd-heuristic.ts +55 -0
  140. package/core/src/physics/character.ts +282 -0
  141. package/core/src/physics/collider.ts +55 -0
  142. package/core/src/physics/collision-system.ts +91 -0
  143. package/core/src/physics/events.ts +133 -0
  144. package/core/src/physics/index.ts +34 -0
  145. package/core/src/physics/interface.ts +473 -0
  146. package/core/src/physics/interpolation-buffer.ts +192 -0
  147. package/core/src/physics/lifecycle.ts +87 -0
  148. package/core/src/physics/load-shedder.ts +164 -0
  149. package/core/src/physics/physics-accumulator.ts +101 -0
  150. package/core/src/physics/physics-system.ts +240 -0
  151. package/core/src/physics/ragdoll-presets.ts +272 -0
  152. package/core/src/physics/ragdoll-system.ts +220 -0
  153. package/core/src/physics/ragdoll.ts +182 -0
  154. package/core/src/physics/raycast.ts +143 -0
  155. package/core/src/physics/realm-manager.ts +499 -0
  156. package/core/src/physics/realm-worker-pool.ts +191 -0
  157. package/core/src/physics/realm-worker.ts +102 -0
  158. package/core/src/physics/realm.ts +189 -0
  159. package/core/src/physics/registry.ts +52 -0
  160. package/core/src/physics/safety.ts +247 -0
  161. package/core/src/physics/snapshot-manager.ts +141 -0
  162. package/core/src/physics/worker-protocol.ts +30 -0
  163. package/core/src/platform/bun-preload.ts +169 -0
  164. package/core/src/platform/css-stub.ts +4 -0
  165. package/core/src/platform/glob-polyfill.ts +124 -0
  166. package/core/src/platform/hidpi.ts +57 -0
  167. package/core/src/platform/render-surface.ts +77 -0
  168. package/core/src/platform/rpc.ts +98 -0
  169. package/core/src/platform/runtime.ts +132 -0
  170. package/core/src/plugin/context.ts +364 -0
  171. package/core/src/plugin/diagnostics.ts +61 -0
  172. package/core/src/plugin/discovery.ts +186 -0
  173. package/core/src/plugin/extension-loaders.ts +172 -0
  174. package/core/src/plugin/host.ts +659 -0
  175. package/core/src/plugin/index.ts +106 -0
  176. package/core/src/plugin/loader-asset.ts +124 -0
  177. package/core/src/plugin/loader-quickjs.ts +84 -0
  178. package/core/src/plugin/loader-wasm.ts +411 -0
  179. package/core/src/plugin/loader-worker.ts +261 -0
  180. package/core/src/plugin/manifest.ts +653 -0
  181. package/core/src/plugin/material-registry.ts +65 -0
  182. package/core/src/plugin/mcp-tools.ts +165 -0
  183. package/core/src/plugin/permissions.ts +175 -0
  184. package/core/src/plugin/quickjs-bridge.ts +294 -0
  185. package/core/src/plugin/registry.ts +107 -0
  186. package/core/src/plugin/sandbox-shim.ts +86 -0
  187. package/core/src/plugin/sandbox-worker.ts +215 -0
  188. package/core/src/plugin/wasm-abi.ts +152 -0
  189. package/core/src/plugin/wasm-worker.ts +229 -0
  190. package/core/src/plugin/workshop.ts +169 -0
  191. package/core/src/profiling/event-loop.ts +180 -0
  192. package/core/src/profiling/index.ts +69 -0
  193. package/core/src/profiling/iops/idb-patch.ts +242 -0
  194. package/core/src/profiling/iops/opfs-patch.ts +276 -0
  195. package/core/src/profiling/profiling-sab.ts +839 -0
  196. package/core/src/profiling/task-latency.ts +134 -0
  197. package/core/src/profiling/thread-metrics.ts +126 -0
  198. package/core/src/profiling/trace-event-writer.ts +205 -0
  199. package/core/src/profiling/warnings.ts +423 -0
  200. package/core/src/profiling/worker-prelude.ts +376 -0
  201. package/core/src/render/bind-group.ts +38 -0
  202. package/core/src/render/bindless/bindless-struct.ts +42 -0
  203. package/core/src/render/bindless/bindless.wgsl.ts +167 -0
  204. package/core/src/render/bindless/frame-bindings.ts +176 -0
  205. package/core/src/render/bindless/index.ts +10 -0
  206. package/core/src/render/bindless/material-manager.ts +257 -0
  207. package/core/src/render/bindless/texture-registry.ts +609 -0
  208. package/core/src/render/buffer.ts +82 -0
  209. package/core/src/render/camera-2d.ts +217 -0
  210. package/core/src/render/camera-controller.ts +440 -0
  211. package/core/src/render/camera.ts +409 -0
  212. package/core/src/render/canvas-resize-watcher.ts +46 -0
  213. package/core/src/render/compute-kernel.ts +172 -0
  214. package/core/src/render/constants.ts +2 -0
  215. package/core/src/render/device.ts +111 -0
  216. package/core/src/render/frame-graph.ts +768 -0
  217. package/core/src/render/frustum.ts +185 -0
  218. package/core/src/render/fullscreen-vs.ts +25 -0
  219. package/core/src/render/g-buffer.ts +186 -0
  220. package/core/src/render/game-renderer.ts +1452 -0
  221. package/core/src/render/gpu-driven/cull-pass.ts +394 -0
  222. package/core/src/render/gpu-driven/hzb.ts +215 -0
  223. package/core/src/render/gpu-driven/index.ts +7 -0
  224. package/core/src/render/gpu-driven/indirect-draw-pass.ts +324 -0
  225. package/core/src/render/gpu-driven/instance-buffer.ts +178 -0
  226. package/core/src/render/gpu-driven/mesh-table.ts +175 -0
  227. package/core/src/render/gpu-driven/passes/hzb-build-pass.ts +47 -0
  228. package/core/src/render/gpu-utils.ts +96 -0
  229. package/core/src/render/hdr.ts +88 -0
  230. package/core/src/render/hot-reload.ts +295 -0
  231. package/core/src/render/ibl-bind-group.ts +266 -0
  232. package/core/src/render/ibl.ts +180 -0
  233. package/core/src/render/index.ts +163 -0
  234. package/core/src/render/input-manager.ts +259 -0
  235. package/core/src/render/lighting/area-light.ts +196 -0
  236. package/core/src/render/lighting/cluster-grid.ts +288 -0
  237. package/core/src/render/lighting/cluster-types.ts +193 -0
  238. package/core/src/render/lighting/ies-parser.ts +162 -0
  239. package/core/src/render/lighting.ts +454 -0
  240. package/core/src/render/material-types/depth.wgsl +44 -0
  241. package/core/src/render/material-types/line.wgsl +50 -0
  242. package/core/src/render/material-types/matcap.wgsl +51 -0
  243. package/core/src/render/material-types/normal.wgsl +41 -0
  244. package/core/src/render/material-types/physical.wgsl +152 -0
  245. package/core/src/render/material-types/sprite.wgsl +46 -0
  246. package/core/src/render/material-types/sss.wgsl +79 -0
  247. package/core/src/render/material-types/toon.wgsl +79 -0
  248. package/core/src/render/passes/README.md +121 -0
  249. package/core/src/render/passes/atmosphere.ts +152 -0
  250. package/core/src/render/passes/cluster-lighting-pass.ts +476 -0
  251. package/core/src/render/passes/csm.ts +408 -0
  252. package/core/src/render/passes/cubemap-capture.ts +114 -0
  253. package/core/src/render/passes/debug-viz.ts +278 -0
  254. package/core/src/render/passes/debug.ts +538 -0
  255. package/core/src/render/passes/decal-mesh.ts +111 -0
  256. package/core/src/render/passes/decal-pass.ts +377 -0
  257. package/core/src/render/passes/deferred-lighting.ts +434 -0
  258. package/core/src/render/passes/depth-prepass.ts +163 -0
  259. package/core/src/render/passes/dome-360.ts +83 -0
  260. package/core/src/render/passes/fluid-render.ts +137 -0
  261. package/core/src/render/passes/gi-types.ts +118 -0
  262. package/core/src/render/passes/graph-compute.ts +300 -0
  263. package/core/src/render/passes/greased-line-pass.ts +232 -0
  264. package/core/src/render/passes/morph-target.ts +40 -0
  265. package/core/src/render/passes/opaque.ts +1028 -0
  266. package/core/src/render/passes/point-light-shadow.ts +266 -0
  267. package/core/src/render/passes/procedural-texture.ts +185 -0
  268. package/core/src/render/passes/reflection-probe.ts +140 -0
  269. package/core/src/render/passes/rsm-pass.ts +248 -0
  270. package/core/src/render/passes/sdf-text.ts +155 -0
  271. package/core/src/render/passes/shadow-map.ts +163 -0
  272. package/core/src/render/passes/shadow.ts +220 -0
  273. package/core/src/render/passes/skinning-vs.ts +121 -0
  274. package/core/src/render/passes/skinning.ts +326 -0
  275. package/core/src/render/passes/sky-dome.ts +404 -0
  276. package/core/src/render/passes/skybox.ts +162 -0
  277. package/core/src/render/passes/spot-light-shadow.ts +273 -0
  278. package/core/src/render/passes/terrain.ts +326 -0
  279. package/core/src/render/passes/transparent.ts +353 -0
  280. package/core/src/render/passes/underwater-fog.ts +185 -0
  281. package/core/src/render/passes/video-texture.ts +79 -0
  282. package/core/src/render/passes/volumetric-pass.ts +312 -0
  283. package/core/src/render/passes/volumetric-types.ts +171 -0
  284. package/core/src/render/passes/water.ts +753 -0
  285. package/core/src/render/pbr.ts +296 -0
  286. package/core/src/render/pipeline.ts +52 -0
  287. package/core/src/render/render-pass.ts +30 -0
  288. package/core/src/render/renderer-input-bus.ts +220 -0
  289. package/core/src/render/renderer-module-host.ts +623 -0
  290. package/core/src/render/resource-tracker.ts +67 -0
  291. package/core/src/render/sab-canvas-overlay.ts +122 -0
  292. package/core/src/render/shader-validator.ts +200 -0
  293. package/core/src/render/shaders/debug/debug-line.wgsl +27 -0
  294. package/core/src/render/shaders/debug/debug-point.wgsl +30 -0
  295. package/core/src/render/shaders/debug/debug-text.wgsl +42 -0
  296. package/core/src/render/shaders/debug-viz/aabb.wgsl +20 -0
  297. package/core/src/render/shaders/debug-viz/depth.wgsl +29 -0
  298. package/core/src/render/shaders/debug-viz/lod.wgsl +38 -0
  299. package/core/src/render/shaders/debug-viz/normals.wgsl +30 -0
  300. package/core/src/render/shaders/debug-viz/overdraw.wgsl +21 -0
  301. package/core/src/render/shaders/debug-viz/tangents.wgsl +29 -0
  302. package/core/src/render/shaders/debug-viz/wireframe.wgsl +33 -0
  303. package/core/src/render/shaders/shadow-chunks.ts +135 -0
  304. package/core/src/render/skybox.ts +146 -0
  305. package/core/src/render/splitscreen.ts +85 -0
  306. package/core/src/render/surface.ts +78 -0
  307. package/core/src/render/tonemap.ts +180 -0
  308. package/core/src/render/tracked-render-pass.ts +158 -0
  309. package/core/src/render/viewport.ts +109 -0
  310. package/core/src/render/wgsl-hmr.ts +70 -0
  311. package/core/src/sab/core-input-channel.ts +23 -0
  312. package/core/src/sab/define.ts +239 -0
  313. package/core/src/sab/errors.ts +76 -0
  314. package/core/src/sab/game-input.ts +343 -0
  315. package/core/src/sab/gamepad-devices.ts +259 -0
  316. package/core/src/sab/grid-buffer.ts +117 -0
  317. package/core/src/sab/input.ts +55 -0
  318. package/core/src/sab/layout.ts +219 -0
  319. package/core/src/sab/multi-input-channel.ts +50 -0
  320. package/core/src/sab/record-buffer.ts +155 -0
  321. package/core/src/sab/sab-polyfill.ts +56 -0
  322. package/core/src/sab/sim-channel.ts +453 -0
  323. package/core/src/sab/slot-buffer.ts +190 -0
  324. package/core/src/sab/types.ts +158 -0
  325. package/core/src/safety/bounds.ts +76 -0
  326. package/core/src/safety/json.ts +80 -0
  327. package/core/src/safety/path.ts +167 -0
  328. package/core/src/save/binary-format.ts +117 -0
  329. package/core/src/save/game-save-system.ts +161 -0
  330. package/core/src/save/grid-save-system.ts +158 -0
  331. package/core/src/save/migrate.ts +44 -0
  332. package/core/src/save/migration-registry.ts +94 -0
  333. package/core/src/save/persist-types.ts +208 -0
  334. package/core/src/save/schema.ts +46 -0
  335. package/core/src/save/serializer.ts +180 -0
  336. package/core/src/scene/builder.ts +65 -0
  337. package/core/src/scene/camera.ts +142 -0
  338. package/core/src/scene/checkpoint.ts +109 -0
  339. package/core/src/scene/game-loop.ts +198 -0
  340. package/core/src/scene/index.ts +24 -0
  341. package/core/src/scene/layer.ts +6 -0
  342. package/core/src/scene/prefab.ts +145 -0
  343. package/core/src/scene/scene-manager.ts +157 -0
  344. package/core/src/scene/scene.ts +192 -0
  345. package/core/src/scene/sky.ts +256 -0
  346. package/core/src/scene/spatial-grid.ts +176 -0
  347. package/core/src/scene/streaming.ts +304 -0
  348. package/core/src/scene/vegetation.ts +163 -0
  349. package/core/src/scene/world.ts +89 -0
  350. package/core/src/scripting/binding.ts +129 -0
  351. package/core/src/scripting/hot-reload.ts +144 -0
  352. package/core/src/scripting/script.ts +99 -0
  353. package/core/src/sim/hot-reload-pipeline.ts +49 -0
  354. package/core/src/sim/sim-state-helper.ts +47 -0
  355. package/core/src/sim/transient-state-registry.ts +77 -0
  356. package/core/src/sim/types.ts +113 -0
  357. package/core/src/sim/worker-loop.ts +222 -0
  358. package/core/src/stores/game-store.ts +158 -0
  359. package/core/src/stores/hot-reload-store.ts +44 -0
  360. package/core/src/telemetry/collector.ts +410 -0
  361. package/core/src/telemetry/gc-controller.ts +453 -0
  362. package/core/src/telemetry/gc-profiler.ts +126 -0
  363. package/core/src/telemetry/gc-tracker.ts +69 -0
  364. package/core/src/telemetry/gpu-profiler.ts +703 -0
  365. package/core/src/telemetry/gpu-resource-tracker.ts +285 -0
  366. package/core/src/telemetry/gpu-timer-pool.ts +234 -0
  367. package/core/src/telemetry/gpu-timer.ts +123 -0
  368. package/core/src/telemetry/gpu-timestamp-gate.ts +21 -0
  369. package/core/src/telemetry/reporter.ts +62 -0
  370. package/core/src/types/engine-types.ts +129 -0
  371. package/core/src/ui-font-scale.ts +112 -0
  372. package/core/src/util/broad-phase-grid.ts +82 -0
  373. package/core/src/util/feature-log.ts +220 -0
  374. package/core/src/util/index.ts +17 -0
  375. package/core/src/util/logger.ts +604 -0
  376. package/core/src/webgpu-destroy-augmentation.d.ts +25 -0
  377. package/core/src/worker/base-worker-host.ts +183 -0
  378. package/core/src/worker/buffer-sync.ts +550 -0
  379. package/core/src/worker/crash-recovery.ts +201 -0
  380. package/core/src/worker/entity-sim-worker-host.ts +190 -0
  381. package/core/src/worker/instrumented-worker-host.ts +171 -0
  382. package/core/src/worker/rpc.ts +253 -0
  383. package/core/src/worker/sim-worker-base.ts +913 -0
  384. package/core/src/worker/sim-worker-host.ts +358 -0
  385. package/core/src/worker/task-pool.ts +256 -0
  386. package/core/src/worker/task-worker.ts +83 -0
  387. package/libraries/asset-browser/src/index.ts +11 -0
  388. package/libraries/asset-browser/src/software-thumbnails.ts +949 -0
  389. package/libraries/audio-kira/README.md +17 -0
  390. package/libraries/audio-kira/native/Cargo.toml +14 -0
  391. package/libraries/audio-kira/native/src/engine.rs +27 -0
  392. package/libraries/audio-kira/native/src/lib.rs +185 -0
  393. package/libraries/audio-kira/native/src/mixer.rs +11 -0
  394. package/libraries/audio-kira/native/src/source.rs +80 -0
  395. package/libraries/audio-kira/src/backend.ts +469 -0
  396. package/libraries/audio-kira/src/index.ts +8 -0
  397. package/libraries/audio-kira/src/library.ts +82 -0
  398. package/libraries/blitz-ui/native/Cargo.toml +33 -0
  399. package/libraries/blitz-ui/native/assets/DejaVuSans.woff2 +0 -0
  400. package/libraries/blitz-ui/native/src/bridge.rs +100 -0
  401. package/libraries/blitz-ui/native/src/fonts.rs +20 -0
  402. package/libraries/blitz-ui/native/src/input.rs +80 -0
  403. package/libraries/blitz-ui/native/src/lib.rs +96 -0
  404. package/libraries/blitz-ui/native/src/shell.rs +301 -0
  405. package/libraries/blitz-ui/native-osr/Cargo.toml +24 -0
  406. package/libraries/blitz-ui/native-osr/src/events.rs +237 -0
  407. package/libraries/blitz-ui/native-osr/src/lib.rs +846 -0
  408. package/libraries/blitz-ui/native-osr/src/mutate.rs +385 -0
  409. package/libraries/blitz-ui/native-osr/src/resources.rs +45 -0
  410. package/libraries/blitz-ui/native-osr-spike.ts +70 -0
  411. package/libraries/blitz-ui/src/index.ts +15 -0
  412. package/libraries/blitz-ui/src/native-module.ts +221 -0
  413. package/libraries/blitz-ui/src/native-osr-ffi.ts +423 -0
  414. package/libraries/blitz-ui/src/router.ts +101 -0
  415. package/libraries/blitz-ui/src/shaders/ui-blit.wgsl.ts +35 -0
  416. package/libraries/blitz-ui/src/ui-blit-pass.ts +116 -0
  417. package/libraries/character/README.md +25 -0
  418. package/libraries/character/src/character-animator.ts +374 -0
  419. package/libraries/character/src/index.ts +24 -0
  420. package/libraries/character/src/loader.ts +375 -0
  421. package/libraries/character/src/locomotion.ts +124 -0
  422. package/libraries/character/src/preview.ts +287 -0
  423. package/libraries/devtools/README.md +51 -0
  424. package/libraries/devtools/native/Cargo.toml +12 -0
  425. package/libraries/devtools/native/src/lib.rs +1646 -0
  426. package/libraries/devtools/native/src/panels/console.rs +338 -0
  427. package/libraries/devtools/native/src/panels/dom_tree.rs +47 -0
  428. package/libraries/devtools/native/src/panels/generic.rs +317 -0
  429. package/libraries/devtools/native/src/panels/gpu.rs +107 -0
  430. package/libraries/devtools/native/src/panels/input.rs +88 -0
  431. package/libraries/devtools/native/src/panels/mod.rs +154 -0
  432. package/libraries/devtools/native/src/panels/perf_metrics.rs +91 -0
  433. package/libraries/devtools/native/src/panels/perf_recorder.rs +158 -0
  434. package/libraries/devtools/native/src/panels/scene.rs +72 -0
  435. package/libraries/devtools/native/src/state.rs +394 -0
  436. package/libraries/devtools/src/cdp-bridge.ts +349 -0
  437. package/libraries/devtools/src/collectors.ts +346 -0
  438. package/libraries/devtools/src/egui-ffi.ts +804 -0
  439. package/libraries/devtools/src/egui-renderer.ts +407 -0
  440. package/libraries/devtools/src/host.ts +363 -0
  441. package/libraries/devtools/src/index.ts +40 -0
  442. package/libraries/devtools/src/mirror.ts +794 -0
  443. package/libraries/devtools/src/native-providers.ts +744 -0
  444. package/libraries/devtools/src/verify.ts +167 -0
  445. package/libraries/devtools/src/web/browser.ts +102 -0
  446. package/libraries/devtools/src/web/host.ts +212 -0
  447. package/libraries/devtools/src/web/mirror.ts +430 -0
  448. package/libraries/devtools/src/web/server.ts +198 -0
  449. package/libraries/entities/README.md +17 -0
  450. package/libraries/entities/src/index.ts +4 -0
  451. package/libraries/entities/src/library.ts +64 -0
  452. package/libraries/entities/src/model-renderer.ts +1345 -0
  453. package/libraries/entities/src/shaders/model.wgsl +375 -0
  454. package/libraries/gamepad/src/feed-input.ts +83 -0
  455. package/libraries/gamepad/src/filters.ts +49 -0
  456. package/libraries/gamepad/src/glyphs.ts +93 -0
  457. package/libraries/gamepad/src/hub.ts +206 -0
  458. package/libraries/gamepad/src/index.ts +22 -0
  459. package/libraries/gamepad/src/library.ts +68 -0
  460. package/libraries/gamepad/src/source-sab.ts +70 -0
  461. package/libraries/gamepad/src/sysfs-enrich.ts +138 -0
  462. package/libraries/gaussian-splats/README.md +25 -0
  463. package/libraries/gaussian-splats/src/gpu-sort.ts +595 -0
  464. package/libraries/gaussian-splats/src/index.ts +31 -0
  465. package/libraries/gaussian-splats/src/library.ts +60 -0
  466. package/libraries/gaussian-splats/src/parser.ts +382 -0
  467. package/libraries/gaussian-splats/src/renderer.ts +427 -0
  468. package/libraries/gaussian-splats/src/sh-eval.ts +211 -0
  469. package/libraries/gaussian-splats/src/sorter.ts +110 -0
  470. package/libraries/gaussian-splats/src/tile-raster.ts +473 -0
  471. package/libraries/gpu-kernels/README.md +154 -0
  472. package/libraries/gpu-kernels/src/index.ts +11 -0
  473. package/libraries/gpu-kernels/src/kernel.ts +696 -0
  474. package/libraries/gpu-kernels/src/transpile.ts +958 -0
  475. package/libraries/html-ui-kit/src/behaviors.ts +250 -0
  476. package/libraries/html-ui-kit/src/components.ts +309 -0
  477. package/libraries/html-ui-kit/src/index.ts +30 -0
  478. package/libraries/html-ui-kit/src/nav/nav-controller.ts +238 -0
  479. package/libraries/html-ui-kit/src/nav/nav-input.ts +145 -0
  480. package/libraries/html-ui-kit/src/nav/osk.ts +153 -0
  481. package/libraries/html-ui-kit/src/nav/router.ts +167 -0
  482. package/libraries/html-ui-kit/src/nav/vcursor.ts +203 -0
  483. package/libraries/html-ui-kit/src/ten-foot.ts +182 -0
  484. package/libraries/html-ui-kit/src/theme.ts +238 -0
  485. package/libraries/lighting/README.md +20 -0
  486. package/libraries/lighting/src/index.ts +5 -0
  487. package/libraries/lighting/src/library.ts +66 -0
  488. package/libraries/lighting/src/light-system.ts +452 -0
  489. package/libraries/lighting/src/lighting-system.ts +68 -0
  490. package/libraries/lighting/src/shaders/light-debug.wgsl +30 -0
  491. package/libraries/marching-cubes/README.md +25 -0
  492. package/libraries/marching-cubes/src/chunked-field.ts +177 -0
  493. package/libraries/marching-cubes/src/deformation.ts +63 -0
  494. package/libraries/marching-cubes/src/generator.ts +407 -0
  495. package/libraries/marching-cubes/src/index.ts +32 -0
  496. package/libraries/marching-cubes/src/library.ts +80 -0
  497. package/libraries/marching-cubes/src/lod.ts +122 -0
  498. package/libraries/marching-cubes/src/marching-tetrahedra.ts +252 -0
  499. package/libraries/marching-cubes/src/sab.ts +45 -0
  500. package/libraries/marching-cubes/src/streaming-config.ts +48 -0
  501. package/libraries/marching-cubes/src/streaming-manager.ts +686 -0
  502. package/libraries/marching-cubes/src/tables.ts +323 -0
  503. package/libraries/marching-cubes/src/types.ts +18 -0
  504. package/libraries/models/README.md +25 -0
  505. package/libraries/models/src/bake-node-transforms.ts +171 -0
  506. package/libraries/models/src/codecs/basisu-codec.ts +180 -0
  507. package/libraries/models/src/codecs/draco-codec.ts +372 -0
  508. package/libraries/models/src/codecs/draco3dgltf.d.ts +40 -0
  509. package/libraries/models/src/codecs/index.ts +22 -0
  510. package/libraries/models/src/codecs/meshopt-codec.ts +91 -0
  511. package/libraries/models/src/codecs/registry.ts +221 -0
  512. package/libraries/models/src/dae.ts +753 -0
  513. package/libraries/models/src/default-part-selection.ts +56 -0
  514. package/libraries/models/src/dxf.ts +200 -0
  515. package/libraries/models/src/fbx/index.ts +457 -0
  516. package/libraries/models/src/fbx/interpreter/animation.ts +431 -0
  517. package/libraries/models/src/fbx/interpreter/blend-shapes.ts +323 -0
  518. package/libraries/models/src/fbx/interpreter/connections.ts +166 -0
  519. package/libraries/models/src/fbx/interpreter/diagnostics.ts +65 -0
  520. package/libraries/models/src/fbx/interpreter/geometry.ts +535 -0
  521. package/libraries/models/src/fbx/interpreter/global-settings.ts +92 -0
  522. package/libraries/models/src/fbx/interpreter/materials.ts +265 -0
  523. package/libraries/models/src/fbx/interpreter/nodes.ts +197 -0
  524. package/libraries/models/src/fbx/interpreter/skeleton.ts +476 -0
  525. package/libraries/models/src/fbx/parsers/binary-parser.ts +244 -0
  526. package/libraries/models/src/fbx/types.ts +119 -0
  527. package/libraries/models/src/gltf-extensions.ts +196 -0
  528. package/libraries/models/src/gltf.ts +935 -0
  529. package/libraries/models/src/index.ts +87 -0
  530. package/libraries/models/src/library.ts +75 -0
  531. package/libraries/models/src/loader.ts +265 -0
  532. package/libraries/models/src/material-adapter.ts +108 -0
  533. package/libraries/models/src/mini-xml.ts +174 -0
  534. package/libraries/models/src/normalize.ts +216 -0
  535. package/libraries/models/src/obj.ts +264 -0
  536. package/libraries/models/src/off.ts +95 -0
  537. package/libraries/models/src/ply.ts +348 -0
  538. package/libraries/models/src/pose-sampler.ts +219 -0
  539. package/libraries/models/src/sidecar/blender-extras.ts +37 -0
  540. package/libraries/models/src/sidecar/ddmeta.ts +114 -0
  541. package/libraries/models/src/sidecar/godot-import.ts +86 -0
  542. package/libraries/models/src/sidecar/resolver.ts +145 -0
  543. package/libraries/models/src/sidecar/types.ts +11 -0
  544. package/libraries/models/src/sidecar/unity-meta.ts +61 -0
  545. package/libraries/models/src/skeleton-synthesis.ts +132 -0
  546. package/libraries/models/src/stl.ts +149 -0
  547. package/libraries/models/src/threeds.ts +363 -0
  548. package/libraries/models/src/threemf.ts +201 -0
  549. package/libraries/models/src/types.ts +188 -0
  550. package/libraries/models/src/vtk.ts +218 -0
  551. package/libraries/models/test-fixtures/fbx/LICENSE-notice.txt +24 -0
  552. package/libraries/models/test-fixtures/fbx/README.md +46 -0
  553. package/libraries/models/test-fixtures/fbx/m01_cube_phong.fbx +0 -0
  554. package/libraries/models/test-fixtures/fbx/m02_geo_ngons.fbx +0 -0
  555. package/libraries/models/test-fixtures/fbx/m03_normals.fbx +0 -0
  556. package/libraries/models/test-fixtures/fbx/m04_material_properties.fbx +0 -0
  557. package/libraries/models/test-fixtures/fbx/m05_external_diffuse.png +0 -0
  558. package/libraries/models/test-fixtures/fbx/m05_textures.fbx +0 -0
  559. package/libraries/models/test-fixtures/fbx/m06_uv_transform.fbx +0 -0
  560. package/libraries/models/test-fixtures/fbx/m07_multimaterial.fbx +0 -0
  561. package/libraries/models/test-fixtures/fbx/m08_transforms.fbx +0 -0
  562. package/libraries/models/test-fixtures/fbx/m09_skinning.fbx +0 -0
  563. package/libraries/models/test-fixtures/fbx/m10_morph.fbx +0 -0
  564. package/libraries/models/test-fixtures/fbx/m11_node_anim.fbx +0 -0
  565. package/libraries/models/test-fixtures/fbx/m12_skeletal_anim.fbx +0 -0
  566. package/libraries/models/test-fixtures/fbx/m13_morph_anim.fbx +0 -0
  567. package/libraries/models/test-fixtures/fbx/m14_multiclip.fbx +0 -0
  568. package/libraries/models/test-fixtures/fbx/m15_camera_lights.fbx +0 -0
  569. package/libraries/models/test-fixtures/fbx/m16_axis_yup.fbx +0 -0
  570. package/libraries/models/test-fixtures/fbx/m16_axis_zup.fbx +0 -0
  571. package/libraries/models/test-fixtures/fbx/m16_units_254.fbx +0 -0
  572. package/libraries/navmesh/README.md +23 -0
  573. package/libraries/navmesh/src/crowd-system.ts +240 -0
  574. package/libraries/navmesh/src/debug-viz.ts +74 -0
  575. package/libraries/navmesh/src/index.ts +15 -0
  576. package/libraries/navmesh/src/library.ts +64 -0
  577. package/libraries/navmesh/src/navmesh-generator.ts +407 -0
  578. package/libraries/navmesh/src/navmesh.ts +159 -0
  579. package/libraries/navmesh/src/pathfinder.ts +252 -0
  580. package/libraries/navmesh/src/types.ts +63 -0
  581. package/libraries/networking/README.md +25 -0
  582. package/libraries/networking/src/authority.ts +121 -0
  583. package/libraries/networking/src/connection.ts +139 -0
  584. package/libraries/networking/src/discovery.ts +373 -0
  585. package/libraries/networking/src/enhanced-replication.ts +355 -0
  586. package/libraries/networking/src/epic-adapter.ts +129 -0
  587. package/libraries/networking/src/index.ts +45 -0
  588. package/libraries/networking/src/library.ts +69 -0
  589. package/libraries/networking/src/lobby.ts +108 -0
  590. package/libraries/networking/src/platform-adapter.ts +163 -0
  591. package/libraries/networking/src/rcs-adapter.ts +127 -0
  592. package/libraries/networking/src/remote-input.ts +188 -0
  593. package/libraries/networking/src/replication.ts +327 -0
  594. package/libraries/networking/src/rpc.ts +188 -0
  595. package/libraries/networking/src/session.ts +173 -0
  596. package/libraries/networking/src/transport.ts +201 -0
  597. package/libraries/networking/src/webrtc.ts +323 -0
  598. package/libraries/pathfinding-2d/README.md +15 -0
  599. package/libraries/pathfinding-2d/src/astar-grid.ts +312 -0
  600. package/libraries/pathfinding-2d/src/index.ts +11 -0
  601. package/libraries/persistence/README.md +25 -0
  602. package/libraries/persistence/src/autosave-manager.ts +112 -0
  603. package/libraries/persistence/src/binary-record-store.ts +244 -0
  604. package/libraries/persistence/src/browser.ts +51 -0
  605. package/libraries/persistence/src/file-save-store.ts +553 -0
  606. package/libraries/persistence/src/hash-utils.ts +59 -0
  607. package/libraries/persistence/src/index.ts +57 -0
  608. package/libraries/persistence/src/library.ts +74 -0
  609. package/libraries/persistence/src/mock-opfs.ts +141 -0
  610. package/libraries/persistence/src/node-fs-directory-handle.ts +161 -0
  611. package/libraries/persistence/src/opfs-save-store.ts +745 -0
  612. package/libraries/persistence/src/save-worker-proxy.ts +127 -0
  613. package/libraries/persistence/src/save-worker.ts +99 -0
  614. package/libraries/persistence/src/xxh3-ts.d.ts +10 -0
  615. package/libraries/physics-native/README.md +21 -0
  616. package/libraries/physics-native/native/Cargo.toml +11 -0
  617. package/libraries/physics-native/native/src/body.rs +403 -0
  618. package/libraries/physics-native/native/src/character.rs +226 -0
  619. package/libraries/physics-native/native/src/collider.rs +299 -0
  620. package/libraries/physics-native/native/src/joint.rs +81 -0
  621. package/libraries/physics-native/native/src/lib.rs +830 -0
  622. package/libraries/physics-native/native/src/query.rs +261 -0
  623. package/libraries/physics-native/native/src/realm.rs +33 -0
  624. package/libraries/physics-native/native/src/step.rs +54 -0
  625. package/libraries/physics-native/native/src/world.rs +148 -0
  626. package/libraries/physics-native/src/backend.ts +1046 -0
  627. package/libraries/physics-native/src/broadphase.ts +101 -0
  628. package/libraries/physics-native/src/ffi-spike-worker.ts +71 -0
  629. package/libraries/physics-native/src/index.ts +11 -0
  630. package/libraries/physics-native/src/library.ts +79 -0
  631. package/libraries/physics-native/src/narrowphase-shapes.ts +420 -0
  632. package/libraries/physics-native/src/narrowphase.ts +123 -0
  633. package/libraries/physics-native/src/solver.ts +141 -0
  634. package/libraries/physics-native/src/types.ts +76 -0
  635. package/libraries/physics-rapier/README.md +21 -0
  636. package/libraries/physics-rapier/bench/ffi-bench.ts +79 -0
  637. package/libraries/physics-rapier/bench/wasm-baseline.ts +90 -0
  638. package/libraries/physics-rapier/src/api.ts +452 -0
  639. package/libraries/physics-rapier/src/auto-backend.ts +59 -0
  640. package/libraries/physics-rapier/src/backend.ts +1207 -0
  641. package/libraries/physics-rapier/src/bulk-ops.ts +68 -0
  642. package/libraries/physics-rapier/src/ffi-backend.ts +21 -0
  643. package/libraries/physics-rapier/src/ffi-lib.ts +597 -0
  644. package/libraries/physics-rapier/src/index.ts +12 -0
  645. package/libraries/physics-rapier/src/library.ts +107 -0
  646. package/libraries/physics-rapier/src/rapier-backend.ts +1052 -0
  647. package/libraries/physics-rapier/src/realm-worker-script.ts +237 -0
  648. package/libraries/postfx/README.md +17 -0
  649. package/libraries/postfx/src/index.ts +19 -0
  650. package/libraries/postfx/src/library.ts +337 -0
  651. package/libraries/postfx/src/post-process-stack.ts +1752 -0
  652. package/libraries/postfx/src/shaders/post-process/afterimage.wgsl +14 -0
  653. package/libraries/postfx/src/shaders/post-process/ascii.wgsl +24 -0
  654. package/libraries/postfx/src/shaders/post-process/blit.wgsl +12 -0
  655. package/libraries/postfx/src/shaders/post-process/bloom-blur.wgsl +21 -0
  656. package/libraries/postfx/src/shaders/post-process/bloom-bright.wgsl +15 -0
  657. package/libraries/postfx/src/shaders/post-process/bloom-composite.wgsl +14 -0
  658. package/libraries/postfx/src/shaders/post-process/bloom-downsample.wgsl +60 -0
  659. package/libraries/postfx/src/shaders/post-process/bloom-soft.wgsl +46 -0
  660. package/libraries/postfx/src/shaders/post-process/bloom-upsample.wgsl +51 -0
  661. package/libraries/postfx/src/shaders/post-process/channel-mixer.wgsl +36 -0
  662. package/libraries/postfx/src/shaders/post-process/chromatic-aberration.wgsl +37 -0
  663. package/libraries/postfx/src/shaders/post-process/dithering.wgsl +64 -0
  664. package/libraries/postfx/src/shaders/post-process/dof.wgsl +131 -0
  665. package/libraries/postfx/src/shaders/post-process/edges.wgsl +45 -0
  666. package/libraries/postfx/src/shaders/post-process/fullscreen-vs.wgsl +15 -0
  667. package/libraries/postfx/src/shaders/post-process/fxaa.wgsl +102 -0
  668. package/libraries/postfx/src/shaders/post-process/gaussian-blur.wgsl +37 -0
  669. package/libraries/postfx/src/shaders/post-process/glow-blur.wgsl +33 -0
  670. package/libraries/postfx/src/shaders/post-process/glow-composite.wgsl +25 -0
  671. package/libraries/postfx/src/shaders/post-process/grain.wgsl +37 -0
  672. package/libraries/postfx/src/shaders/post-process/halftone.wgsl +80 -0
  673. package/libraries/postfx/src/shaders/post-process/highlight-blur.wgsl +33 -0
  674. package/libraries/postfx/src/shaders/post-process/highlight-composite.wgsl +32 -0
  675. package/libraries/postfx/src/shaders/post-process/lens-distortion.wgsl +43 -0
  676. package/libraries/postfx/src/shaders/post-process/lens-flare.wgsl +68 -0
  677. package/libraries/postfx/src/shaders/post-process/lut.wgsl +30 -0
  678. package/libraries/postfx/src/shaders/post-process/motion-blur.wgsl +55 -0
  679. package/libraries/postfx/src/shaders/post-process/occluder-chunk.wgsl +28 -0
  680. package/libraries/postfx/src/shaders/post-process/outline.wgsl +51 -0
  681. package/libraries/postfx/src/shaders/post-process/pixelation.wgsl +47 -0
  682. package/libraries/postfx/src/shaders/post-process/sharpen.wgsl +32 -0
  683. package/libraries/postfx/src/shaders/post-process/sobel.wgsl +26 -0
  684. package/libraries/postfx/src/shaders/post-process/split-tone.wgsl +36 -0
  685. package/libraries/postfx/src/shaders/post-process/ssao-blur.wgsl +38 -0
  686. package/libraries/postfx/src/shaders/post-process/ssao-composite.wgsl +25 -0
  687. package/libraries/postfx/src/shaders/post-process/ssao.wgsl +147 -0
  688. package/libraries/postfx/src/shaders/post-process/ssr.wgsl +155 -0
  689. package/libraries/postfx/src/shaders/post-process/taa.wgsl +98 -0
  690. package/libraries/postfx/src/shaders/post-process/tonemap.wgsl +40 -0
  691. package/libraries/postfx/src/shaders/post-process/watercolor.wgsl +82 -0
  692. package/libraries/postfx/src/shaders/post-process/white-balance.wgsl +41 -0
  693. package/libraries/recast/README.md +21 -0
  694. package/libraries/recast/src/backend.ts +150 -0
  695. package/libraries/recast/src/crowd-system.ts +352 -0
  696. package/libraries/recast/src/index.ts +12 -0
  697. package/libraries/recast/src/library.ts +91 -0
  698. package/libraries/recast/src/types.ts +86 -0
  699. package/libraries/sand/README.md +25 -0
  700. package/libraries/sand/src/cell.ts +43 -0
  701. package/libraries/sand/src/fields.ts +29 -0
  702. package/libraries/sand/src/fluid-grid.ts +261 -0
  703. package/libraries/sand/src/grid-dims.ts +74 -0
  704. package/libraries/sand/src/grid-sim-buffer.ts +271 -0
  705. package/libraries/sand/src/index.ts +81 -0
  706. package/libraries/sand/src/library.ts +92 -0
  707. package/libraries/sand/src/materials.ts +492 -0
  708. package/libraries/sand/src/palette.ts +93 -0
  709. package/libraries/sand/src/particles.ts +185 -0
  710. package/libraries/sand/src/render/sand-grid-pass.ts +430 -0
  711. package/libraries/sand/src/rng.ts +51 -0
  712. package/libraries/sand/src/rules/builtin-rules.ts +132 -0
  713. package/libraries/sand/src/rules/rule-compiler.ts +162 -0
  714. package/libraries/sand/src/rules/rule-engine.ts +231 -0
  715. package/libraries/sand/src/rules/rule-types.ts +87 -0
  716. package/libraries/sand/src/sand-step-pool.ts +484 -0
  717. package/libraries/sand/src/sand-step-worker.ts +97 -0
  718. package/libraries/sand/src/sand-world.ts +3227 -0
  719. package/libraries/stickman/README.md +25 -0
  720. package/libraries/stickman/src/index.ts +25 -0
  721. package/libraries/stickman/src/library.ts +61 -0
  722. package/libraries/stickman/src/proportions.ts +45 -0
  723. package/libraries/stickman/src/shader.ts +117 -0
  724. package/libraries/stickman/src/skeleton.ts +197 -0
  725. package/libraries/stickman/src/stickman-pass.ts +255 -0
  726. package/libraries/stickman/src/thick-line.ts +123 -0
  727. package/libraries/surface-nets/README.md +25 -0
  728. package/libraries/surface-nets/src/chunked-field.ts +14 -0
  729. package/libraries/surface-nets/src/deformation.ts +45 -0
  730. package/libraries/surface-nets/src/index.ts +36 -0
  731. package/libraries/surface-nets/src/library.ts +59 -0
  732. package/libraries/surface-nets/src/lod.ts +7 -0
  733. package/libraries/surface-nets/src/sab.ts +4 -0
  734. package/libraries/surface-nets/src/streaming-config.ts +5 -0
  735. package/libraries/surface-nets/src/streaming-manager.ts +15 -0
  736. package/libraries/surface-nets/src/surface-nets.ts +334 -0
  737. package/libraries/surface-nets/src/types.ts +23 -0
  738. package/libraries/water/README.md +25 -0
  739. package/libraries/water/src/buoyancy.ts +103 -0
  740. package/libraries/water/src/index.ts +43 -0
  741. package/libraries/water/src/library.ts +85 -0
  742. package/libraries/water/src/shore-damping.ts +93 -0
  743. package/libraries/water/src/water-buffer.ts +89 -0
  744. package/libraries/water/src/water-chunks.ts +13 -0
  745. package/libraries/water/src/water-physics.ts +376 -0
  746. package/libraries/water/src/water-renderer.ts +809 -0
  747. package/libraries/water/src/water-sab.ts +161 -0
  748. package/libraries/water/src/wave-sources.ts +84 -0
  749. package/libraries/weather/README.md +20 -0
  750. package/libraries/weather/src/index.ts +9 -0
  751. package/libraries/weather/src/library.ts +72 -0
  752. package/libraries/weather/src/types.ts +64 -0
  753. package/libraries/weather/src/weather-blend.ts +112 -0
  754. package/libraries/weather/src/weather-system.ts +271 -0
  755. package/libraries/weatherfx/README.md +24 -0
  756. package/libraries/weatherfx/src/cloud-provider.ts +31 -0
  757. package/libraries/weatherfx/src/cloud-system.ts +372 -0
  758. package/libraries/weatherfx/src/index.ts +9 -0
  759. package/libraries/weatherfx/src/library.ts +58 -0
  760. package/libraries/weatherfx/src/particle-system.ts +434 -0
  761. package/libraries/weatherfx/src/shaders/cloud.wgsl +111 -0
  762. package/libraries/weatherfx/src/shaders/particle-compute.wgsl +187 -0
  763. package/libraries/weatherfx/src/shaders/particle-render.wgsl +95 -0
  764. package/lint-plugin.mjs +41 -0
  765. package/mcp/src/client.ts +703 -0
  766. package/mcp/src/engine-context.ts +186 -0
  767. package/mcp/src/http-transport.ts +471 -0
  768. package/mcp/src/index.ts +13 -0
  769. package/mcp/src/prompts/add-entity.ts +42 -0
  770. package/mcp/src/prompts/create-scene.ts +44 -0
  771. package/mcp/src/prompts/debug-frame.ts +39 -0
  772. package/mcp/src/prompts/index.ts +12 -0
  773. package/mcp/src/resources/asset-list.ts +32 -0
  774. package/mcp/src/resources/checkpoint-list.ts +33 -0
  775. package/mcp/src/resources/entity-state.ts +55 -0
  776. package/mcp/src/resources/gpu-info.ts +103 -0
  777. package/mcp/src/resources/index.ts +57 -0
  778. package/mcp/src/resources/performance.ts +37 -0
  779. package/mcp/src/resources/scene-tree.ts +43 -0
  780. package/mcp/src/server.ts +375 -0
  781. package/mcp/src/tools/animation.ts +118 -0
  782. package/mcp/src/tools/asset.ts +161 -0
  783. package/mcp/src/tools/audio.ts +96 -0
  784. package/mcp/src/tools/build.ts +143 -0
  785. package/mcp/src/tools/camera.ts +167 -0
  786. package/mcp/src/tools/checkpoint.ts +100 -0
  787. package/mcp/src/tools/component.ts +199 -0
  788. package/mcp/src/tools/debug.ts +300 -0
  789. package/mcp/src/tools/entity.ts +361 -0
  790. package/mcp/src/tools/inspect.ts +210 -0
  791. package/mcp/src/tools/lighting.ts +263 -0
  792. package/mcp/src/tools/material.ts +243 -0
  793. package/mcp/src/tools/mesh.ts +239 -0
  794. package/mcp/src/tools/physics.ts +266 -0
  795. package/mcp/src/tools/scene.ts +153 -0
  796. package/mcp/src/tools/script.ts +122 -0
  797. package/mcp/src/types.ts +92 -0
  798. package/mcp/src/undo-redo.ts +77 -0
  799. package/modules/camera-controls/README.md +20 -0
  800. package/modules/camera-controls/src/index.ts +161 -0
  801. package/modules/controller-ui/src/index.ts +164 -0
  802. package/modules/devtools/README.md +25 -0
  803. package/modules/devtools/src/api.ts +461 -0
  804. package/modules/devtools/src/asset-utils.ts +105 -0
  805. package/modules/devtools/src/bind-debug-store.ts +48 -0
  806. package/modules/devtools/src/data-bridge.ts +286 -0
  807. package/modules/devtools/src/debug-overlay.ts +238 -0
  808. package/modules/devtools/src/debug-raycast.ts +328 -0
  809. package/modules/devtools/src/debug-store.ts +92 -0
  810. package/modules/devtools/src/debug-view-descriptors.ts +59 -0
  811. package/modules/devtools/src/doctor-panel.ts +182 -0
  812. package/modules/devtools/src/gizmo-module.ts +136 -0
  813. package/modules/devtools/src/graph-model.ts +509 -0
  814. package/modules/devtools/src/grid-renderer.ts +157 -0
  815. package/modules/devtools/src/height-ruler-renderer.ts +216 -0
  816. package/modules/devtools/src/index.ts +81 -0
  817. package/modules/devtools/src/init.ts +261 -0
  818. package/modules/devtools/src/label-overlay.ts +154 -0
  819. package/modules/devtools/src/material-stats-panel.ts +188 -0
  820. package/modules/devtools/src/profiling-bridge.ts +377 -0
  821. package/modules/devtools/src/profiling-hooks.ts +98 -0
  822. package/modules/devtools/src/renderer-adapter.ts +76 -0
  823. package/modules/devtools/src/scene-inspector.ts +637 -0
  824. package/modules/devtools/src/scene-store.ts +320 -0
  825. package/modules/devtools/src/scene-sync.ts +116 -0
  826. package/modules/devtools/src/shaders/transform-gizmo.wgsl +38 -0
  827. package/modules/devtools/src/sim-stats-panel.ts +272 -0
  828. package/modules/devtools/src/sim-stats-provider.ts +105 -0
  829. package/modules/devtools/src/skeleton-renderer.ts +351 -0
  830. package/modules/devtools/src/transform-gizmo.ts +928 -0
  831. package/modules/devtools/src/types.ts +290 -0
  832. package/modules/devtools/src/worker-expose.ts +67 -0
  833. package/modules/devtools/src/worker-sync.ts +137 -0
  834. package/modules/editor/src/commands/component.ts +156 -0
  835. package/modules/editor/src/commands/entity.ts +287 -0
  836. package/modules/editor/src/commands/hierarchy.ts +83 -0
  837. package/modules/editor/src/commands/index.ts +61 -0
  838. package/modules/editor/src/commands/prefab.ts +163 -0
  839. package/modules/editor/src/commands/registry.ts +331 -0
  840. package/modules/editor/src/commands/scene-io.ts +211 -0
  841. package/modules/editor/src/commands/selection.ts +73 -0
  842. package/modules/editor/src/commands/transform.ts +91 -0
  843. package/modules/editor/src/ddscene.ts +267 -0
  844. package/modules/editor/src/document.ts +123 -0
  845. package/modules/editor/src/editor-context.ts +172 -0
  846. package/modules/editor/src/index.ts +41 -0
  847. package/modules/editor/src/mcp.ts +103 -0
  848. package/modules/editor/src/module.ts +148 -0
  849. package/modules/editor/src/selection.ts +70 -0
  850. package/modules/editor/src/shell.ts +456 -0
  851. package/modules/editor/src/viewport.ts +199 -0
  852. package/modules/html-ui/src/composite.ts +135 -0
  853. package/modules/html-ui/src/create-html-ui.ts +188 -0
  854. package/modules/html-ui/src/doc-backend.ts +343 -0
  855. package/modules/html-ui/src/host.ts +646 -0
  856. package/modules/html-ui/src/index.ts +13 -0
  857. package/modules/html-ui/src/jsx-dev-runtime.ts +12 -0
  858. package/modules/html-ui/src/jsx-runtime.ts +126 -0
  859. package/modules/html-ui/src/protocol.ts +88 -0
  860. package/modules/html-ui/src/ui-worker.ts +16 -0
  861. package/modules/mcp/README.md +18 -0
  862. package/modules/mcp/src/index.ts +27 -0
  863. package/modules/movement-2d/README.md +19 -0
  864. package/modules/movement-2d/src/grid-character.ts +455 -0
  865. package/modules/movement-2d/src/index.ts +45 -0
  866. package/modules/movement-3d/README.md +21 -0
  867. package/modules/movement-3d/src/character-motor.ts +230 -0
  868. package/modules/movement-3d/src/index.ts +46 -0
  869. package/modules/native-osr/src/index.ts +22 -0
  870. package/modules/native-osr/src/input-router.ts +401 -0
  871. package/modules/native-osr/src/native-osr-manager.ts +247 -0
  872. package/modules/native-osr/src/native-texture-source.ts +86 -0
  873. package/modules/native-osr/src/types.ts +112 -0
  874. package/modules/native-osr/src/world-space-ui-pass.ts +351 -0
  875. package/modules/sailing/README.md +18 -0
  876. package/modules/sailing/src/index.ts +51 -0
  877. package/modules/terrain/README.md +18 -0
  878. package/modules/terrain/src/index.ts +78 -0
  879. package/modules/vitals/README.md +17 -0
  880. package/modules/vitals/src/index.ts +43 -0
  881. package/modules/vitals/src/vitals.ts +265 -0
  882. package/modules/xr/README.md +25 -0
  883. package/modules/xr/src/camera-rig.ts +146 -0
  884. package/modules/xr/src/debug.ts +59 -0
  885. package/modules/xr/src/frame-loop.ts +197 -0
  886. package/modules/xr/src/index.ts +16 -0
  887. package/modules/xr/src/input.ts +208 -0
  888. package/modules/xr/src/layer.ts +140 -0
  889. package/modules/xr/src/session.ts +156 -0
  890. package/modules/xr/src/sim-module.ts +23 -0
  891. package/modules/xr/src/types.ts +32 -0
  892. package/modules/xr/src/webxr.d.ts +182 -0
  893. package/modules/xr/src/xr-module.ts +179 -0
  894. package/package.json +232 -3
  895. package/shader-graph/src/chunks.ts +349 -0
  896. package/shader-graph/src/compiler.ts +732 -0
  897. package/shader-graph/src/compute-compiler.ts +453 -0
  898. package/shader-graph/src/compute-graph.ts +112 -0
  899. package/shader-graph/src/compute-profiles.ts +54 -0
  900. package/shader-graph/src/graph.ts +52 -0
  901. package/shader-graph/src/index.ts +53 -0
  902. package/shader-graph/src/profiles.ts +407 -0
  903. package/shader-graph/src/validator.ts +48 -0
  904. package/shader-graph/src/wgsl-binding-validator.ts +143 -0
  905. package/shader-graph/src/wgsl-struct-validator.ts +245 -0
  906. package/shader-graph/src/wgsl-struct.ts +397 -0
  907. package/test/src/index.ts +7 -0
  908. package/test/src/vision-test.ts +369 -0
@@ -0,0 +1,152 @@
1
+ // Physical material — extends PBR with clearcoat, transmission, sheen, iridescence
2
+ // Forward-rendered, Cook-Torrance BRDF + clearcoat layer
3
+
4
+ struct PhysicalUniforms {
5
+ baseColor: vec4<f32>,
6
+ roughness: f32,
7
+ metallic: f32,
8
+ clearcoat: f32,
9
+ clearcoatRoughness: f32,
10
+ transmission: f32,
11
+ ior: f32,
12
+ thickness: f32,
13
+ sheenColor: vec3<f32>,
14
+ sheenRoughness: f32,
15
+ iridescence: f32,
16
+ iridescenceIOR: f32,
17
+ attenuationColor: vec3<f32>,
18
+ attenuationDistance: f32,
19
+ envMapIntensity: f32,
20
+ _pad: f32,
21
+ _pad2: f32,
22
+ emissive: vec3<f32>,
23
+ };
24
+
25
+ struct CameraUniforms {
26
+ viewProj: mat4x4<f32>,
27
+ cameraPos: vec3<f32>,
28
+ _pad: f32,
29
+ };
30
+
31
+ struct ModelUniforms {
32
+ model: mat4x4<f32>,
33
+ normalMatrix: mat4x4<f32>,
34
+ };
35
+
36
+ struct LightUniforms {
37
+ dirDirection: vec4<f32>,
38
+ dirColor: vec4<f32>,
39
+ };
40
+
41
+ @group(0) @binding(0) var<uniform> mat: PhysicalUniforms;
42
+ @group(0) @binding(1) var<uniform> camera: CameraUniforms;
43
+ @group(0) @binding(2) var<uniform> model: ModelUniforms;
44
+ @group(0) @binding(3) var<uniform> lights: LightUniforms;
45
+ @group(0) @binding(4) var albedoMap: texture_2d<f32>;
46
+ @group(0) @binding(5) var normalMap: texture_2d<f32>;
47
+ @group(0) @binding(6) var clearcoatNormalMap: texture_2d<f32>;
48
+ @group(0) @binding(7) var texSampler: sampler;
49
+
50
+ const PI = 3.14159265359;
51
+
52
+ fn distributionGGX(N: vec3<f32>, H: vec3<f32>, roughness: f32) -> f32 {
53
+ let a = roughness * roughness;
54
+ let a2 = a * a;
55
+ let NdotH = max(dot(N, H), 0.0);
56
+ let NdotH2 = NdotH * NdotH;
57
+ let nom = a2;
58
+ let denom = NdotH2 * (a2 - 1.0) + 1.0;
59
+ return nom / (PI * denom * denom);
60
+ }
61
+
62
+ fn geometrySmith(N: vec3<f32>, V: vec3<f32>, L: vec3<f32>, roughness: f32) -> f32 {
63
+ let r = roughness + 1.0;
64
+ let k = (r * r) / 8.0;
65
+ let NdotV = max(dot(N, V), 0.0);
66
+ let NdotL = max(dot(N, L), 0.0);
67
+ let ggxV = NdotV / (NdotV * (1.0 - k) + k);
68
+ let ggxL = NdotL / (NdotL * (1.0 - k) + k);
69
+ return ggxV * ggxL;
70
+ }
71
+
72
+ fn fresnelSchlick(cosTheta: f32, F0: vec3<f32>) -> vec3<f32> {
73
+ return F0 + (1.0 - F0) * pow(clamp(1.0 - cosTheta, 0.0, 1.0), 5.0);
74
+ }
75
+
76
+ fn fresnelSchlickRoughness(cosTheta: f32, F0: vec3<f32>, roughness: f32) -> vec3<f32> {
77
+ return F0 + (max(vec3<f32>(1.0 - roughness), F0) - F0) * pow(clamp(1.0 - cosTheta, 0.0, 1.0), 5.0);
78
+ }
79
+
80
+ struct VertexInput {
81
+ @location(0) position: vec3<f32>,
82
+ @location(1) normal: vec3<f32>,
83
+ @location(2) uv: vec2<f32>,
84
+ @location(3) tangent: vec3<f32>,
85
+ };
86
+
87
+ struct VertexOutput {
88
+ @builtin(position) clipPosition: vec4<f32>,
89
+ @location(0) uv: vec2<f32>,
90
+ @location(1) worldNormal: vec3<f32>,
91
+ @location(2) worldPos: vec3<f32>,
92
+ @location(3) worldTangent: vec3<f32>,
93
+ };
94
+
95
+ @vertex
96
+ fn vs_main(input: VertexInput) -> VertexOutput {
97
+ var output: VertexOutput;
98
+ let worldPos = model.model * vec4<f32>(input.position, 1.0);
99
+ output.clipPosition = camera.viewProj * worldPos;
100
+ output.uv = input.uv;
101
+ output.worldNormal = normalize((model.normalMatrix * vec4<f32>(input.normal, 0.0)).xyz);
102
+ output.worldPos = worldPos.xyz;
103
+ output.worldTangent = normalize((model.normalMatrix * vec4<f32>(input.tangent, 0.0)).xyz);
104
+ return output;
105
+ }
106
+
107
+ @fragment
108
+ fn fs_main(input: VertexOutput) -> @location(0) vec4<f32> {
109
+ let N = normalize(input.worldNormal);
110
+ let V = normalize(camera.cameraPos - input.worldPos);
111
+
112
+ let albedo = textureSample(albedoMap, texSampler, input.uv).rgb * mat.baseColor.rgb;
113
+ let F0 = mix(vec3<f32>(0.04), albedo, mat.metallic);
114
+
115
+ let L = normalize(-lights.dirDirection.xyz);
116
+ let H = normalize(V + L);
117
+ let NdotL = max(dot(N, L), 0.0);
118
+
119
+ let NDF = distributionGGX(N, H, mat.roughness);
120
+ let G = geometrySmith(N, V, L, mat.roughness);
121
+ let F = fresnelSchlick(max(dot(H, V), 0.0), F0);
122
+
123
+ let numerator = NDF * G * F;
124
+ let denominator = 4.0 * max(dot(N, V), 0.0) * NdotL + 0.0001;
125
+ let specular = numerator / denominator;
126
+
127
+ let kS = F;
128
+ let kD = (vec3<f32>(1.0) - kS) * (1.0 - mat.metallic);
129
+
130
+ let diffuse = kD * albedo / PI;
131
+ var color = (diffuse + specular) * lights.dirColor.rgb * NdotL;
132
+
133
+ if (mat.clearcoat > 0.0) {
134
+ let ccN = normalize(textureSample(clearcoatNormalMap, texSampler, input.uv).xyz * 2.0 - 1.0);
135
+ let ccF0 = vec3<f32>(0.04);
136
+ let ccNDF = distributionGGX(ccN, H, mat.clearcoatRoughness);
137
+ let ccG = geometrySmith(ccN, V, L, mat.clearcoatRoughness);
138
+ let ccF = fresnelSchlick(max(dot(H, V), 0.0), ccF0);
139
+ let ccSpec = (ccNDF * ccG * ccF) / (4.0 * max(dot(ccN, V), 0.0) * NdotL + 0.0001);
140
+ color = mix(color, color + ccSpec * lights.dirColor.rgb * NdotL, mat.clearcoat);
141
+ }
142
+
143
+ if (mat.sheenRoughness < 1.0) {
144
+ let sheenF = pow(1.0 - max(dot(N, V), 0.0), 5.0) * (1.0 - mat.sheenRoughness);
145
+ color += mat.sheenColor * sheenF * NdotL * 0.3;
146
+ }
147
+
148
+ let ambient = albedo * 0.03 * mat.envMapIntensity;
149
+ color += ambient;
150
+
151
+ return vec4<f32>(color, mat.baseColor.a);
152
+ }
@@ -0,0 +1,46 @@
1
+ // Sprite material — billboard quad with texture + color, no lighting
2
+ // Forward-rendered
3
+
4
+ struct SpriteUniforms {
5
+ color: vec4<f32>,
6
+ };
7
+
8
+ struct CameraUniforms {
9
+ viewProj: mat4x4<f32>,
10
+ cameraRight: vec3<f32>,
11
+ cameraUp: vec3<f32>,
12
+ _pad: f32,
13
+ };
14
+
15
+ @group(0) @binding(0) var<uniform> sprite: SpriteUniforms;
16
+ @group(0) @binding(1) var<uniform> camera: CameraUniforms;
17
+ @group(0) @binding(2) var spriteMap: texture_2d<f32>;
18
+ @group(0) @binding(3) var spriteSampler: sampler;
19
+
20
+ struct VertexInput {
21
+ @location(0) position: vec3<f32>,
22
+ @location(1) uv: vec2<f32>,
23
+ };
24
+
25
+ struct VertexOutput {
26
+ @builtin(position) clipPosition: vec4<f32>,
27
+ @location(0) uv: vec2<f32>,
28
+ };
29
+
30
+ @vertex
31
+ fn vs_main(input: VertexInput) -> VertexOutput {
32
+ var output: VertexOutput;
33
+ let worldPos = vec4<f32>(
34
+ input.position + camera.cameraRight * (input.uv.x - 0.5) + camera.cameraUp * (input.uv.y - 0.5),
35
+ 1.0,
36
+ );
37
+ output.clipPosition = camera.viewProj * worldPos;
38
+ output.uv = input.uv;
39
+ return output;
40
+ }
41
+
42
+ @fragment
43
+ fn fs_main(input: VertexOutput) -> @location(0) vec4<f32> {
44
+ let texColor = textureSample(spriteMap, spriteSampler, input.uv);
45
+ return texColor * sprite.color;
46
+ }
@@ -0,0 +1,79 @@
1
+ // SSS material — subsurface scattering approximation with diffuse transmission
2
+ // Forward-rendered, wraps PBR with subsurface color and transmittance
3
+
4
+ struct SSSUniforms {
5
+ baseColor: vec4<f32>,
6
+ subsurfaceColor: vec3<f32>,
7
+ scatterRadius: f32,
8
+ transmittance: f32,
9
+ };
10
+
11
+ struct CameraUniforms {
12
+ viewProj: mat4x4<f32>,
13
+ cameraPos: vec3<f32>,
14
+ _pad: f32,
15
+ };
16
+
17
+ struct ModelUniforms {
18
+ model: mat4x4<f32>,
19
+ normalMatrix: mat4x4<f32>,
20
+ };
21
+
22
+ struct LightUniforms {
23
+ dirDirection: vec4<f32>,
24
+ dirColor: vec4<f32>,
25
+ };
26
+
27
+ @group(0) @binding(0) var<uniform> sss: SSSUniforms;
28
+ @group(0) @binding(1) var<uniform> camera: CameraUniforms;
29
+ @group(0) @binding(2) var<uniform> model: ModelUniforms;
30
+ @group(0) @binding(3) var<uniform> lights: LightUniforms;
31
+ @group(0) @binding(4) var albedoMap: texture_2d<f32>;
32
+ @group(0) @binding(5) var texSampler: sampler;
33
+
34
+ struct VertexInput {
35
+ @location(0) position: vec3<f32>,
36
+ @location(1) normal: vec3<f32>,
37
+ @location(2) uv: vec2<f32>,
38
+ };
39
+
40
+ struct VertexOutput {
41
+ @builtin(position) clipPosition: vec4<f32>,
42
+ @location(0) uv: vec2<f32>,
43
+ @location(1) worldNormal: vec3<f32>,
44
+ @location(2) worldPos: vec3<f32>,
45
+ };
46
+
47
+ @vertex
48
+ fn vs_main(input: VertexInput) -> VertexOutput {
49
+ var output: VertexOutput;
50
+ let worldPos = model.model * vec4<f32>(input.position, 1.0);
51
+ output.clipPosition = camera.viewProj * worldPos;
52
+ output.uv = input.uv;
53
+ output.worldNormal = normalize((model.normalMatrix * vec4<f32>(input.normal, 0.0)).xyz);
54
+ output.worldPos = worldPos.xyz;
55
+ return output;
56
+ }
57
+
58
+ @fragment
59
+ fn fs_main(input: VertexOutput) -> @location(0) vec4<f32> {
60
+ let N = normalize(input.worldNormal);
61
+ let V = normalize(camera.cameraPos - input.worldPos);
62
+ let L = normalize(-lights.dirDirection.xyz);
63
+
64
+ let albedo = textureSample(albedoMap, texSampler, input.uv).rgb * sss.baseColor.rgb;
65
+
66
+ let NdotL = max(dot(N, L), 0.0);
67
+ let diffuse = albedo * lights.dirColor.rgb * NdotL;
68
+
69
+ let backLight = max(dot(-N, L), 0.0);
70
+ let transmittanceLight = sss.subsurfaceColor * lights.dirColor.rgb * backLight * sss.transmittance;
71
+
72
+ let wrapLight = (dot(N, L) + sss.scatterRadius) / (1.0 + sss.scatterRadius);
73
+ let sssDiffuse = albedo * sss.subsurfaceColor * max(wrapLight, 0.0) * 0.5;
74
+
75
+ let ambient = albedo * 0.03;
76
+ let color = ambient + diffuse + transmittanceLight + sssDiffuse;
77
+
78
+ return vec4<f32>(color, sss.baseColor.a);
79
+ }
@@ -0,0 +1,79 @@
1
+ // Toon material — quantized diffuse bands with rim light and optional outline
2
+ // Forward-rendered
3
+
4
+ struct ToonUniforms {
5
+ baseColor: vec4<f32>,
6
+ stepCount: f32,
7
+ stepSmoothness: f32,
8
+ outlineWidth: f32,
9
+ rimColor: vec3<f32>,
10
+ rimPower: f32,
11
+ };
12
+
13
+ struct CameraUniforms {
14
+ viewProj: mat4x4<f32>,
15
+ cameraPos: vec3<f32>,
16
+ _pad: f32,
17
+ };
18
+
19
+ struct ModelUniforms {
20
+ model: mat4x4<f32>,
21
+ normalMatrix: mat4x4<f32>,
22
+ };
23
+
24
+ struct LightUniforms {
25
+ dirDirection: vec4<f32>,
26
+ dirColor: vec4<f32>,
27
+ };
28
+
29
+ @group(0) @binding(0) var<uniform> toon: ToonUniforms;
30
+ @group(0) @binding(1) var<uniform> camera: CameraUniforms;
31
+ @group(0) @binding(2) var<uniform> model: ModelUniforms;
32
+ @group(0) @binding(3) var<uniform> lights: LightUniforms;
33
+ @group(0) @binding(4) var albedoMap: texture_2d<f32>;
34
+ @group(0) @binding(5) var albedoSampler: sampler;
35
+
36
+ struct VertexInput {
37
+ @location(0) position: vec3<f32>,
38
+ @location(1) normal: vec3<f32>,
39
+ @location(2) uv: vec2<f32>,
40
+ };
41
+
42
+ struct VertexOutput {
43
+ @builtin(position) clipPosition: vec4<f32>,
44
+ @location(0) uv: vec2<f32>,
45
+ @location(1) normal: vec3<f32>,
46
+ @location(2) viewDir: vec3<f32>,
47
+ };
48
+
49
+ @vertex
50
+ fn vs_main(input: VertexInput) -> VertexOutput {
51
+ var output: VertexOutput;
52
+ let worldPos = model.model * vec4<f32>(input.position, 1.0);
53
+ output.clipPosition = camera.viewProj * worldPos;
54
+ output.uv = input.uv;
55
+ output.normal = normalize((model.normalMatrix * vec4<f32>(input.normal, 0.0)).xyz);
56
+ output.viewDir = normalize(camera.cameraPos - worldPos.xyz);
57
+ return output;
58
+ }
59
+
60
+ @fragment
61
+ fn fs_main(input: VertexOutput) -> @location(0) vec4<f32> {
62
+ let N = normalize(input.normal);
63
+ let L = normalize(-lights.dirDirection.xyz);
64
+ let V = normalize(input.viewDir);
65
+
66
+ let NdotL = max(dot(N, L), 0.0);
67
+ let steps = max(toon.stepCount, 1.0);
68
+ let quantized = floor(NdotL * steps) / steps;
69
+ let smoothStep = mix(quantized, smoothstep(0.0, 1.0, NdotL), toon.stepSmoothness);
70
+
71
+ let albedo = textureSample(albedoMap, albedoSampler, input.uv).rgb * toon.baseColor.rgb;
72
+ let diffuse = albedo * lights.dirColor.rgb * smoothStep;
73
+
74
+ let rim = pow(1.0 - max(dot(N, V), 0.0), toon.rimPower);
75
+ let rimLight = toon.rimColor * rim;
76
+
77
+ let ambient = albedo * 0.3;
78
+ return vec4<f32>(ambient + diffuse + rimLight, toon.baseColor.a);
79
+ }
@@ -0,0 +1,121 @@
1
+ # Render Passes
2
+
3
+ This directory contains all render pass implementations (70 files). It is
4
+ currently flat. The categorization below documents a **future migration** into
5
+ subdirectories. Files should **not** be moved yet — doing so would break the
6
+ many relative imports across the codebase. When the migration is performed,
7
+ update all `./passes/<name>` import paths accordingly.
8
+
9
+ ## Proposed subdirectory layout
10
+
11
+ ### `passes/base/` — RenderPass base class & shared utilities
12
+ Core abstractions that all other passes build on.
13
+
14
+ | File | Description |
15
+ |------|-------------|
16
+ | (none currently — `render-pass.ts` lives in `../render-pass.ts`) | `RenderPass` base class |
17
+ | `volumetric-types.ts` | Shared volumetric fog type definitions |
18
+ | `gi-types.ts` | Shared global illumination (RSM/VPL) type definitions |
19
+
20
+ ### `passes/gbuffer/` — GBuffer & deferred lighting
21
+ Passes related to the deferred rendering pipeline (GBuffer generation +
22
+ deferred shading).
23
+
24
+ | File | Description |
25
+ |------|-------------|
26
+ | `deferred-lighting.ts` | Deferred lighting pass (reads GBuffer) |
27
+ | `depth-prepass.ts` | Depth pre-pass (z-prepass for deferred) |
28
+ | `cluster-lighting-pass.ts` | Clustered deferred lighting pass |
29
+
30
+ ### `passes/postfx/` — Post-processing passes
31
+ Screen-space and fullscreen post-processing effects.
32
+
33
+ | File | Description |
34
+ |------|-------------|
35
+ | `highlight.ts` | Highlight/selection outline post-effect |
36
+ | `glow.ts` | Selective bloom/glow pass |
37
+ | `grain.ts` | Film grain post-effect |
38
+ | `sharpen.ts` | Image sharpening pass |
39
+ | `edges.ts` | Edge detection / toon outline pass |
40
+ | `outline.ts` | Object outline post-effect |
41
+ | `motion-blur.ts` | Camera/object motion blur |
42
+ | `lens-flare.ts` | Lens flare post-effect |
43
+ | `ssao.ts` | Screen-space ambient occlusion |
44
+ | `ssr.ts` | Screen-space reflections |
45
+ | `post-process.ts` | Generic post-process pass (tone mapping, etc.) |
46
+ | `underwater-fog.ts` | Underwater fog post-effect |
47
+ | `debug-viz.ts` | Debug visualization overlays |
48
+
49
+ > **Note:** The unified `PostProcessStack` (21+ chainable effects), its WGSL
50
+ > shaders, the `PostfxLib` engine-library descriptor, and the `LUT3D` color
51
+ > grading effect have moved to the dedicated `@downdraft/engine/libraries/postfx`
52
+ > package at `packages/engine/libraries/postfx/`. The standalone `lut3d.ts`
53
+ > frame-graph pass has been removed in favor of the in-chain `lut` effect.
54
+
55
+ ### `passes/compute/` — Compute passes
56
+ GPU compute shader passes (GPGPU).
57
+
58
+ | File | Description |
59
+ |------|-------------|
60
+ | `graph-compute.ts` | Graph-based compute pass (node-authored compute shaders) |
61
+ | `skinning.ts` | GPU skinning compute pass (`SkinningComputePass`) |
62
+ | `skinning-vs.ts` | Vertex-shader skinning pass (compute-assisted) |
63
+ | `procedural-texture.ts` | Procedural texture generation (compute) |
64
+
65
+ ### `passes/forward/` — Forward rendering passes
66
+ Traditional forward-rendering passes (opaque, transparent, sky, etc.).
67
+
68
+ | File | Description |
69
+ |------|-------------|
70
+ | `opaque.ts` | Opaque forward pass (main geometry pass) |
71
+ | `transparent.ts` | Transparent/alpha-blended forward pass |
72
+ | `skybox.ts` | Skybox rendering pass |
73
+ | `sky-dome.ts` | Procedural sky dome pass |
74
+ | `dome-360.ts` | 360° dome/environment pass |
75
+ | `terrain.ts` | Terrain rendering pass |
76
+ | `water.ts` | Water surface pass |
77
+ | `clouds.ts` | Volumetric clouds pass |
78
+ | `atmosphere.ts` | Atmospheric scattering pass |
79
+ | `fluid-render.ts` | Fluid simulation render pass |
80
+
81
+ ### `passes/shadow/` — Shadow mapping passes
82
+ (If a sixth subdirectory is desired; otherwise fold into `forward/`.)
83
+
84
+ | File | Description |
85
+ |------|-------------|
86
+ | `shadow.ts` | Base shadow map pass |
87
+ | `shadow-map.ts` | Shadow map system manager |
88
+ | `csm.ts` | Cascaded shadow maps |
89
+ | `point-light-shadow.ts` | Point light shadow cube maps |
90
+ | `spot-light-shadow.ts` | Spot light shadow maps |
91
+
92
+ ### `passes/special/` — Specialized / miscellaneous passes
93
+ (If a seventh subdirectory is desired; otherwise keep at top level.)
94
+
95
+ | File | Description |
96
+ |------|-------------|
97
+ | `debug.ts` | Debug render pass (lines, points, text) |
98
+ | `cubemap-capture.ts` | Cubemap capture pass (reflection probes) |
99
+ | `reflection-probe.ts` | Reflection probe pass/types |
100
+ | `rsm-pass.ts` | Reflective shadow map (RSM) pass for GI |
101
+ | `volumetric-pass.ts` | Volumetric lighting/fog pass |
102
+ | `sdf-text.ts` | SDF text rendering pass |
103
+ | `ui-composite.ts` | UI composition pass |
104
+ | `video-texture.ts` | Video texture source pass |
105
+ | `decal-mesh.ts` | Decal mesh generation utilities |
106
+ | `decal-pass.ts` | Decal rendering pass |
107
+ | `greased-line-pass.ts` | Greased line rendering pass |
108
+ | `morph-target.ts` | Morph target pass |
109
+
110
+ ## Migration notes
111
+
112
+ 1. **Import paths**: All passes are currently imported via `./passes/<name>`
113
+ from the render barrel and via `../passes/<name>` from sibling render files.
114
+ After moving, these paths become `./passes/<subdir>/<name>` and
115
+ `../passes/<subdir>/<name>` respectively.
116
+ 2. **Spec files**: Each `.spec.ts` file should move alongside its source file.
117
+ 3. **Barrel exports**: `packages/engine/core/src/render/index.ts` re-exports all
118
+ passes — update the paths there after migration.
119
+ 4. **Cross-pass imports**: Some passes import from sibling passes (e.g.
120
+ `post-process.ts` imports from `volumetric-types.ts`). Update these
121
+ relative paths after moving.
@@ -0,0 +1,152 @@
1
+ import type { WgslStruct } from "@downdraft/engine/shader-graph";
2
+ import { f32, u32, vec3f, wgsl } from "@downdraft/engine/shader-graph";
3
+
4
+ export interface AtmosphereConfig {
5
+ planetRadius: number;
6
+ atmosphereRadius: number;
7
+ sunIntensity: number;
8
+ rayleighCoefficients: number[];
9
+ mieCoefficient: number;
10
+ mieDirectionG: number;
11
+ sunDirection: number[];
12
+ samples: number;
13
+ }
14
+
15
+ export const DEFAULT_ATMOSPHERE_CONFIG: AtmosphereConfig = {
16
+ planetRadius: 6371e3,
17
+ atmosphereRadius: 6471e3,
18
+ sunIntensity: 22.0,
19
+ rayleighCoefficients: [5.5e-6, 13.0e-6, 22.4e-6],
20
+ mieCoefficient: 21e-6,
21
+ mieDirectionG: 0.758,
22
+ sunDirection: [0, 1, 0],
23
+ samples: 16,
24
+ };
25
+
26
+ export function computeRayleighScattering(
27
+ wavelength: number[],
28
+ coefficients: number[],
29
+ density: number,
30
+ ): number[] {
31
+ return [
32
+ coefficients[0] * density,
33
+ coefficients[1] * density,
34
+ coefficients[2] * density,
35
+ ];
36
+ }
37
+
38
+ export function computeMieScattering(
39
+ coefficient: number,
40
+ density: number,
41
+ ): number {
42
+ return coefficient * density;
43
+ }
44
+
45
+ export function computeAtmosphereDensity(
46
+ altitude: number,
47
+ planetRadius: number,
48
+ atmosphereRadius: number,
49
+ ): number {
50
+ const height = altitude - planetRadius;
51
+ const atmosphereHeight = atmosphereRadius - planetRadius;
52
+ if (height < 0) return 1.0;
53
+ if (height > atmosphereHeight) return 0.0;
54
+ return Math.exp(-height / (atmosphereHeight * 0.25));
55
+ }
56
+
57
+ export function computeOpticalDepthRayleigh(
58
+ startAltitude: number,
59
+ endAltitude: number,
60
+ planetRadius: number,
61
+ atmosphereRadius: number,
62
+ samples: number,
63
+ ): number[] {
64
+ const depth: number[] = [0, 0, 0];
65
+ const stepAltitude = (endAltitude - startAltitude) / samples;
66
+ for (let i = 0; i < samples; i++) {
67
+ const alt = startAltitude + stepAltitude * (i + 0.5);
68
+ const density = computeAtmosphereDensity(alt, planetRadius, atmosphereRadius);
69
+ depth[0] += density * stepAltitude;
70
+ depth[1] += density * stepAltitude;
71
+ depth[2] += density * stepAltitude;
72
+ }
73
+ return depth;
74
+ }
75
+
76
+ export function computeSkyColor(
77
+ viewDir: number[],
78
+ sunDir: number[],
79
+ config: AtmosphereConfig,
80
+ ): number[] {
81
+ const cosTheta = viewDir[0] * sunDir[0] + viewDir[1] * sunDir[1] + viewDir[2] * sunDir[2];
82
+ const rayleigh = computeRayleighScattering(
83
+ config.rayleighCoefficients,
84
+ config.rayleighCoefficients,
85
+ 1.0,
86
+ );
87
+
88
+ // Simplified sky color: Rayleigh phase * optical depth
89
+ const phase = (3.0 / (16.0 * Math.PI)) * (1.0 + cosTheta * cosTheta);
90
+ const intensity = config.sunIntensity * phase;
91
+
92
+ return [
93
+ intensity * rayleigh[0] * 1e6,
94
+ intensity * rayleigh[1] * 1e6,
95
+ intensity * rayleigh[2] * 1e6,
96
+ ];
97
+ }
98
+
99
+ const AtmosphereUniforms: WgslStruct = wgsl.struct("AtmosphereUniforms", {
100
+ planetRadius: f32,
101
+ atmosphereRadius: f32,
102
+ sunIntensity: f32,
103
+ mieG: f32,
104
+ rayleighCoeffs: vec3f,
105
+ mieCoefficient: f32,
106
+ sunDirection: vec3f,
107
+ samples: u32,
108
+ });
109
+
110
+ export const ATMOSPHERE_SHADER_CHUNK = /* wgsl */ `
111
+ ${AtmosphereUniforms.wgsl}
112
+
113
+ fn atmosphereDensity(altitude: f32, planetRadius: f32, atmosphereRadius: f32) -> f32 {
114
+ let height = altitude - planetRadius;
115
+ let atmosphereHeight = atmosphereRadius - planetRadius;
116
+ if (height < 0.0) { return 1.0; }
117
+ if (height > atmosphereHeight) { return 0.0; }
118
+ return exp(-height / (atmosphereHeight * 0.25));
119
+ }
120
+
121
+ fn rayleighPhase(cosTheta: f32) -> f32 {
122
+ return (3.0 / (16.0 * 3.14159265)) * (1.0 + cosTheta * cosTheta);
123
+ }
124
+
125
+ fn miePhase(cosTheta: f32, g: f32) -> f32 {
126
+ let g2 = g * g;
127
+ let denom = 1.0 + g2 - 2.0 * g * cosTheta;
128
+ return (3.0 * (1.0 - g2)) / (8.0 * 3.14159265 * denom * sqrt(max(denom, 0.0001)));
129
+ }
130
+
131
+ fn computeAtmosphereColor(
132
+ rayOrigin: vec3<f32>,
133
+ rayDir: vec3<f32>,
134
+ sunDir: vec3<f32>,
135
+ uniforms: AtmosphereUniforms,
136
+ ) -> vec3<f32> {
137
+ // Simplified atmospheric scattering
138
+ let cosTheta = dot(rayDir, sunDir);
139
+ let rayleighPhaseVal = rayleighPhase(cosTheta);
140
+ let miePhaseVal = miePhase(cosTheta, uniforms.mieG);
141
+
142
+ // Approximate optical depth based on view direction
143
+ let upDot = max(rayDir.y, 0.0);
144
+ let opticalDepth = 1.0 / (upDot + 0.1);
145
+
146
+ let rayleighColor = uniforms.rayleighCoeffs * rayleighPhaseVal * opticalDepth;
147
+ let mieColor = uniforms.mieCoefficient * miePhaseVal * opticalDepth;
148
+
149
+ let color = (rayleighColor + vec3<f32>(mieColor)) * uniforms.sunIntensity;
150
+ return color;
151
+ }
152
+ `;