@downdraft/engine 0.1.1 → 0.1.2-alpha.5
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.
- package/app/README.md +11 -0
- package/app/src/renderer/bootstrap.ts +295 -19
- package/app/src/renderer/game-module.ts +60 -12
- package/app/src/renderer/hooks.ts +9 -1
- package/app/src/renderer/hot-reload.ts +9 -9
- package/app/src/renderer/mcp-harness.ts +2 -2
- package/app/src/renderer/standard-automation-tools.ts +104 -3
- package/app/src/shared/feature-log.ts +2 -1
- package/app/src/shared/mcp-discovery.ts +8 -3
- package/app/src/shared/mcp-proxy.ts +2 -2
- package/asset-bake/README.md +22 -0
- package/core/README.md +25 -0
- package/core/src/animation/skeleton-animator.ts +23 -5
- package/core/src/assets/manager.ts +4 -4
- package/core/src/ecs/events.ts +1 -1
- package/core/src/ecs/schedule.ts +1 -1
- package/core/src/ecs/world.ts +1 -1
- package/core/src/index.ts +3 -4
- package/core/src/library/host.ts +27 -13
- package/core/src/library/library.ts +13 -5
- package/core/src/module/cross-thread.ts +6 -0
- package/core/src/module/diagnostics.ts +10 -6
- package/core/src/module/host.ts +65 -18
- package/core/src/module/index.ts +1 -0
- package/core/src/module/module.ts +11 -5
- package/core/src/module/renderer-module.ts +15 -0
- package/core/src/physics/safety.ts +1 -1
- package/core/src/platform/bun-preload.ts +7 -2
- package/core/src/platform/glob-polyfill.ts +17 -8
- package/core/src/platform/pkg-root.ts +27 -0
- package/core/src/platform/runtime.ts +29 -0
- package/core/src/plugin/discovery.ts +1 -1
- package/core/src/plugin/extension-loaders.ts +6 -4
- package/core/src/plugin/host.ts +13 -13
- package/core/src/plugin/loader-asset.ts +5 -5
- package/core/src/plugin/loader-quickjs.ts +1 -1
- package/core/src/plugin/loader-wasm.ts +3 -3
- package/core/src/plugin/loader-worker.ts +1 -1
- package/core/src/plugin/manifest.ts +8 -3
- package/core/src/plugin/workshop.ts +3 -3
- package/core/src/profiling/index.ts +1 -1
- package/core/src/profiling/profiling-sab.ts +19 -0
- package/core/src/profiling/warnings.ts +1 -1
- package/core/src/profiling/worker-prelude.ts +1 -1
- package/core/src/render/bindless/frame-bindings.ts +1 -1
- package/core/src/render/bindless/material-manager.ts +2 -2
- package/core/src/render/bindless/texture-registry.ts +2 -2
- package/core/src/render/device.ts +5 -5
- package/core/src/render/frame-graph.ts +2 -2
- package/core/src/render/game-renderer.ts +42 -18
- package/core/src/render/hot-reload.ts +3 -3
- package/core/src/render/renderer-module-host.ts +32 -12
- package/core/src/render/shader-validator.ts +7 -7
- package/core/src/render/surface.ts +1 -1
- package/core/src/sab/errors.ts +1 -1
- package/core/src/sab/sab-polyfill.ts +1 -1
- package/core/src/save/migration-registry.ts +4 -4
- package/core/src/save/schema.ts +1 -1
- package/core/src/scene/prefab.ts +1 -1
- package/core/src/scene/scene-manager.ts +2 -2
- package/core/src/scene/scene.ts +4 -4
- package/core/src/scene/streaming.ts +2 -2
- package/core/src/scripting/hot-reload.ts +2 -2
- package/core/src/sim/hot-reload-pipeline.ts +30 -6
- package/core/src/sim/sim-state-helper.ts +1 -1
- package/core/src/sim/transient-state-registry.ts +1 -1
- package/core/src/sim/worker-loop.ts +2 -2
- package/core/src/telemetry/gpu-profiler.ts +3 -3
- package/core/src/util/index.ts +1 -1
- package/core/src/util/logger.ts +36 -5
- package/core/src/version.ts +13 -0
- package/core/src/worker/base-worker-host.ts +87 -25
- package/core/src/worker/buffer-sync.ts +1 -1
- package/core/src/worker/crash-recovery.ts +2 -2
- package/core/src/worker/instrumented-worker-host.ts +3 -3
- package/core/src/worker/rpc.ts +62 -11
- package/core/src/worker/sim-worker-base.ts +3 -8
- package/core/src/worker/task-pool.ts +2 -2
- package/dist/.dd-manifest.json +4119 -0
- package/dist/app/src/index.js +9 -0
- package/dist/app/src/renderer/bootstrap.js +446 -0
- package/dist/app/src/renderer/downdraft-base.css +93 -0
- package/dist/app/src/renderer/feature-log.js +180 -0
- package/dist/app/src/renderer/game-module.js +562 -0
- package/dist/app/src/renderer/hooks.js +82 -0
- package/dist/app/src/renderer/hot-reload.js +158 -0
- package/dist/app/src/renderer/import-cache.js +77 -0
- package/dist/app/src/renderer/index.js +149 -0
- package/dist/app/src/renderer/mcp-harness.js +112 -0
- package/dist/app/src/renderer/save-store-factory.js +180 -0
- package/dist/app/src/renderer/sim-bridge.js +138 -0
- package/dist/app/src/renderer/standard-automation-tools.js +720 -0
- package/dist/app/src/shared/feature-log.js +54 -0
- package/dist/app/src/shared/gpu-info.js +74 -0
- package/dist/app/src/shared/import-cache-store.js +123 -0
- package/dist/app/src/shared/index.js +4 -0
- package/dist/app/src/shared/mcp-discovery.js +55 -0
- package/dist/app/src/shared/mcp-proxy.js +71 -0
- package/dist/app/src/shared/types.js +13 -0
- package/dist/asset-bake/src/bake-audio.js +103 -0
- package/dist/asset-bake/src/bake-gltf.js +141 -0
- package/dist/asset-bake/src/bake.js +63 -0
- package/dist/asset-bake/src/cache.js +147 -0
- package/dist/asset-bake/src/config.js +93 -0
- package/dist/asset-bake/src/index.js +25 -0
- package/dist/core/src/animation/animation-event.js +24 -0
- package/dist/core/src/animation/bone-mask.js +103 -0
- package/dist/core/src/animation/clip.js +210 -0
- package/dist/core/src/animation/index.js +13 -0
- package/dist/core/src/animation/mixamo.js +78 -0
- package/dist/core/src/animation/morph-target.js +37 -0
- package/dist/core/src/animation/player.js +621 -0
- package/dist/core/src/animation/retarget.js +101 -0
- package/dist/core/src/animation/skeleton-animator.js +1361 -0
- package/dist/core/src/animation/skeleton.js +166 -0
- package/dist/core/src/animation/state-machine.js +252 -0
- package/dist/core/src/assets/blob-store.js +14 -0
- package/dist/core/src/assets/cache.js +168 -0
- package/dist/core/src/assets/cubemap-converter.js +129 -0
- package/dist/core/src/assets/environment-manager.js +84 -0
- package/dist/core/src/assets/import-cache.js +36 -0
- package/dist/core/src/assets/import-settings.js +34 -0
- package/dist/core/src/assets/importer.js +78 -0
- package/dist/core/src/assets/index.js +29 -0
- package/dist/core/src/assets/irradiance-generator.js +179 -0
- package/dist/core/src/assets/loader-audio.js +70 -0
- package/dist/core/src/assets/loader-cubemap.js +141 -0
- package/dist/core/src/assets/loader-dds.js +185 -0
- package/dist/core/src/assets/loader-hdr.js +430 -0
- package/dist/core/src/assets/loader-mesh.js +47 -0
- package/dist/core/src/assets/loader-shader.js +61 -0
- package/dist/core/src/assets/loader-texture.js +264 -0
- package/dist/core/src/assets/lod.js +150 -0
- package/dist/core/src/assets/manager.js +401 -0
- package/dist/core/src/assets/manifest.js +57 -0
- package/dist/core/src/assets/material-bridge.js +160 -0
- package/dist/core/src/assets/model-importer.js +32 -0
- package/dist/core/src/assets/model-normalizer.js +213 -0
- package/dist/core/src/assets/model-to-gpu.js +44 -0
- package/dist/core/src/assets/model-to-mesh.js +171 -0
- package/dist/core/src/assets/prefilter-generator.js +220 -0
- package/dist/core/src/audio/engine.js +153 -0
- package/dist/core/src/audio/interface.js +8 -0
- package/dist/core/src/audio/listener.js +19 -0
- package/dist/core/src/audio/mixer.js +124 -0
- package/dist/core/src/audio/registry.js +43 -0
- package/dist/core/src/audio/sab.js +74 -0
- package/dist/core/src/audio/source.js +60 -0
- package/dist/core/src/change-detection/atomics.js +1 -0
- package/dist/core/src/change-detection/tracker.js +26 -0
- package/dist/core/src/debug-draw/lines.js +27 -0
- package/dist/core/src/debug-draw/points.js +9 -0
- package/dist/core/src/debug-draw/queue.js +77 -0
- package/dist/core/src/debug-draw/text.js +12 -0
- package/dist/core/src/ecs/archetype.js +271 -0
- package/dist/core/src/ecs/component.js +109 -0
- package/dist/core/src/ecs/entity.js +11 -0
- package/dist/core/src/ecs/events.js +73 -0
- package/dist/core/src/ecs/hierarchy.js +104 -0
- package/dist/core/src/ecs/hmr-swap-registry.js +15 -0
- package/dist/core/src/ecs/index.js +14 -0
- package/dist/core/src/ecs/query.js +110 -0
- package/dist/core/src/ecs/resource.js +3 -0
- package/dist/core/src/ecs/schedule.js +157 -0
- package/dist/core/src/ecs/system-params.js +45 -0
- package/dist/core/src/ecs/system.js +18 -0
- package/dist/core/src/ecs/world.js +292 -0
- package/dist/core/src/index.js +191 -0
- package/dist/core/src/input/context.js +69 -0
- package/dist/core/src/input/dom-handler.js +288 -0
- package/dist/core/src/input/local-player-manager.js +145 -0
- package/dist/core/src/input/mapping.js +36 -0
- package/dist/core/src/input/multi-sab-bridge.js +224 -0
- package/dist/core/src/input/multi-state.js +48 -0
- package/dist/core/src/input/sab-bridge.js +66 -0
- package/dist/core/src/input/state.js +108 -0
- package/dist/core/src/input/ui-router.js +76 -0
- package/dist/core/src/library/host.js +291 -0
- package/dist/core/src/library/index.js +1 -0
- package/dist/core/src/library/library.js +20 -0
- package/dist/core/src/material/compiler.js +73 -0
- package/dist/core/src/material/graph-bridge.js +119 -0
- package/dist/core/src/material/index.js +6 -0
- package/dist/core/src/material/library.js +414 -0
- package/dist/core/src/material/material.js +120 -0
- package/dist/core/src/material/variants.js +37 -0
- package/dist/core/src/math/mat4.js +198 -0
- package/dist/core/src/math/perlin-noise-2d.js +66 -0
- package/dist/core/src/math/perlin-noise-3d.js +76 -0
- package/dist/core/src/math/quat.js +29 -0
- package/dist/core/src/math/rng.js +25 -0
- package/dist/core/src/math/trig.js +42 -0
- package/dist/core/src/math/value-noise.js +49 -0
- package/dist/core/src/mesh/builder.js +137 -0
- package/dist/core/src/mesh/csg.js +250 -0
- package/dist/core/src/mesh/greased-line.js +102 -0
- package/dist/core/src/mesh/mesh.js +6 -0
- package/dist/core/src/mesh/parametric.js +392 -0
- package/dist/core/src/mesh/skinning.js +30 -0
- package/dist/core/src/mesh/vertex-layout.js +65 -0
- package/dist/core/src/module/cross-thread.js +126 -0
- package/dist/core/src/module/diagnostics.js +99 -0
- package/dist/core/src/module/host.js +449 -0
- package/dist/core/src/module/index.js +6 -0
- package/dist/core/src/module/module.js +1 -0
- package/dist/core/src/module/registry.js +83 -0
- package/dist/core/src/module/renderer-module.js +13 -0
- package/dist/core/src/module/ts-loader.js +20 -0
- package/dist/core/src/particles/compute-pass.js +329 -0
- package/dist/core/src/particles/emitter.js +113 -0
- package/dist/core/src/particles/index.js +7 -0
- package/dist/core/src/particles/particle-data.js +33 -0
- package/dist/core/src/particles/render-pass.js +338 -0
- package/dist/core/src/particles/simulator.js +224 -0
- package/dist/core/src/particles/system.js +157 -0
- package/dist/core/src/physics/body.js +25 -0
- package/dist/core/src/physics/ccd-heuristic.js +46 -0
- package/dist/core/src/physics/character.js +184 -0
- package/dist/core/src/physics/collider.js +36 -0
- package/dist/core/src/physics/collision-system.js +62 -0
- package/dist/core/src/physics/events.js +74 -0
- package/dist/core/src/physics/index.js +24 -0
- package/dist/core/src/physics/interface.js +14 -0
- package/dist/core/src/physics/interpolation-buffer.js +182 -0
- package/dist/core/src/physics/lifecycle.js +66 -0
- package/dist/core/src/physics/load-shedder.js +155 -0
- package/dist/core/src/physics/physics-accumulator.js +94 -0
- package/dist/core/src/physics/physics-system.js +142 -0
- package/dist/core/src/physics/ragdoll-presets.js +248 -0
- package/dist/core/src/physics/ragdoll-system.js +193 -0
- package/dist/core/src/physics/ragdoll.js +117 -0
- package/dist/core/src/physics/raycast.js +97 -0
- package/dist/core/src/physics/realm-manager.js +431 -0
- package/dist/core/src/physics/realm-worker-pool.js +181 -0
- package/dist/core/src/physics/realm-worker.js +91 -0
- package/dist/core/src/physics/realm.js +137 -0
- package/dist/core/src/physics/registry.js +43 -0
- package/dist/core/src/physics/safety.js +211 -0
- package/dist/core/src/physics/snapshot-manager.js +118 -0
- package/dist/core/src/physics/worker-protocol.js +1 -0
- package/dist/core/src/platform/bun-preload.js +175 -0
- package/dist/core/src/platform/css-stub.js +4 -0
- package/dist/core/src/platform/glob-polyfill.js +137 -0
- package/dist/core/src/platform/hidpi.js +52 -0
- package/dist/core/src/platform/pkg-root.js +27 -0
- package/dist/core/src/platform/render-surface.js +15 -0
- package/dist/core/src/platform/rpc.js +82 -0
- package/dist/core/src/platform/runtime.js +93 -0
- package/dist/core/src/plugin/context.js +144 -0
- package/dist/core/src/plugin/diagnostics.js +20 -0
- package/dist/core/src/plugin/discovery.js +124 -0
- package/dist/core/src/plugin/extension-loaders.js +111 -0
- package/dist/core/src/plugin/host.js +542 -0
- package/dist/core/src/plugin/index.js +19 -0
- package/dist/core/src/plugin/loader-asset.js +105 -0
- package/dist/core/src/plugin/loader-quickjs.js +67 -0
- package/dist/core/src/plugin/loader-wasm.js +385 -0
- package/dist/core/src/plugin/loader-worker.js +228 -0
- package/dist/core/src/plugin/manifest.js +424 -0
- package/dist/core/src/plugin/material-registry.js +44 -0
- package/dist/core/src/plugin/mcp-tools.js +147 -0
- package/dist/core/src/plugin/permissions.js +152 -0
- package/dist/core/src/plugin/quickjs-bridge.js +219 -0
- package/dist/core/src/plugin/registry.js +92 -0
- package/dist/core/src/plugin/sandbox-shim.js +79 -0
- package/dist/core/src/plugin/sandbox-worker.js +194 -0
- package/dist/core/src/plugin/wasm-abi.js +62 -0
- package/dist/core/src/plugin/wasm-worker.js +234 -0
- package/dist/core/src/plugin/workshop.js +131 -0
- package/dist/core/src/profiling/event-loop.js +164 -0
- package/dist/core/src/profiling/index.js +23 -0
- package/dist/core/src/profiling/iops/idb-patch.js +211 -0
- package/dist/core/src/profiling/iops/opfs-patch.js +206 -0
- package/dist/core/src/profiling/profiling-sab.js +632 -0
- package/dist/core/src/profiling/task-latency.js +118 -0
- package/dist/core/src/profiling/thread-metrics.js +103 -0
- package/dist/core/src/profiling/trace-event-writer.js +165 -0
- package/dist/core/src/profiling/warnings.js +304 -0
- package/dist/core/src/profiling/worker-prelude.js +281 -0
- package/dist/core/src/render/bind-group.js +33 -0
- package/dist/core/src/render/bindless/bindless-struct.js +39 -0
- package/dist/core/src/render/bindless/bindless.wgsl.js +163 -0
- package/dist/core/src/render/bindless/frame-bindings.js +142 -0
- package/dist/core/src/render/bindless/index.js +6 -0
- package/dist/core/src/render/bindless/material-manager.js +182 -0
- package/dist/core/src/render/bindless/texture-registry.js +498 -0
- package/dist/core/src/render/buffer.js +74 -0
- package/dist/core/src/render/camera-2d.js +151 -0
- package/dist/core/src/render/camera-controller.js +370 -0
- package/dist/core/src/render/camera.js +332 -0
- package/dist/core/src/render/canvas-resize-watcher.js +36 -0
- package/dist/core/src/render/compute-kernel.js +130 -0
- package/dist/core/src/render/constants.js +2 -0
- package/dist/core/src/render/device.js +91 -0
- package/dist/core/src/render/frame-graph.js +594 -0
- package/dist/core/src/render/frustum.js +152 -0
- package/dist/core/src/render/fullscreen-vs.js +24 -0
- package/dist/core/src/render/g-buffer.js +156 -0
- package/dist/core/src/render/game-renderer.js +1165 -0
- package/dist/core/src/render/gpu-driven/cull-pass.js +352 -0
- package/dist/core/src/render/gpu-driven/hzb.js +183 -0
- package/dist/core/src/render/gpu-driven/index.js +6 -0
- package/dist/core/src/render/gpu-driven/indirect-draw-pass.js +300 -0
- package/dist/core/src/render/gpu-driven/instance-buffer.js +150 -0
- package/dist/core/src/render/gpu-driven/mesh-table.js +130 -0
- package/dist/core/src/render/gpu-driven/passes/hzb-build-pass.js +39 -0
- package/dist/core/src/render/gpu-utils.js +72 -0
- package/dist/core/src/render/hdr.js +69 -0
- package/dist/core/src/render/hot-reload.js +236 -0
- package/dist/core/src/render/ibl-bind-group.js +232 -0
- package/dist/core/src/render/ibl.js +148 -0
- package/dist/core/src/render/index.js +86 -0
- package/dist/core/src/render/input-manager.js +224 -0
- package/dist/core/src/render/lighting/area-light.js +142 -0
- package/dist/core/src/render/lighting/cluster-grid.js +255 -0
- package/dist/core/src/render/lighting/cluster-types.js +87 -0
- package/dist/core/src/render/lighting/ies-parser.js +111 -0
- package/dist/core/src/render/lighting.js +300 -0
- package/dist/core/src/render/material-types/depth.wgsl +44 -0
- package/dist/core/src/render/material-types/line.wgsl +50 -0
- package/dist/core/src/render/material-types/matcap.wgsl +51 -0
- package/dist/core/src/render/material-types/normal.wgsl +41 -0
- package/dist/core/src/render/material-types/physical.wgsl +152 -0
- package/dist/core/src/render/material-types/sprite.wgsl +46 -0
- package/dist/core/src/render/material-types/sss.wgsl +79 -0
- package/dist/core/src/render/material-types/toon.wgsl +79 -0
- package/dist/core/src/render/passes/README.md +121 -0
- package/dist/core/src/render/passes/atmosphere.js +107 -0
- package/dist/core/src/render/passes/cluster-lighting-pass.js +441 -0
- package/dist/core/src/render/passes/csm.js +338 -0
- package/dist/core/src/render/passes/cubemap-capture.js +93 -0
- package/dist/core/src/render/passes/debug-viz.js +248 -0
- package/dist/core/src/render/passes/debug.js +500 -0
- package/dist/core/src/render/passes/decal-mesh.js +86 -0
- package/dist/core/src/render/passes/decal-pass.js +344 -0
- package/dist/core/src/render/passes/deferred-lighting.js +406 -0
- package/dist/core/src/render/passes/depth-prepass.js +148 -0
- package/dist/core/src/render/passes/dome-360.js +68 -0
- package/dist/core/src/render/passes/fluid-render.js +116 -0
- package/dist/core/src/render/passes/gi-types.js +78 -0
- package/dist/core/src/render/passes/graph-compute.js +251 -0
- package/dist/core/src/render/passes/greased-line-pass.js +218 -0
- package/dist/core/src/render/passes/morph-target.js +35 -0
- package/dist/core/src/render/passes/opaque.js +966 -0
- package/dist/core/src/render/passes/point-light-shadow.js +221 -0
- package/dist/core/src/render/passes/procedural-texture.js +142 -0
- package/dist/core/src/render/passes/reflection-probe.js +100 -0
- package/dist/core/src/render/passes/rsm-pass.js +228 -0
- package/dist/core/src/render/passes/sdf-text.js +114 -0
- package/dist/core/src/render/passes/shadow-map.js +121 -0
- package/dist/core/src/render/passes/shadow.js +191 -0
- package/dist/core/src/render/passes/skinning-vs.js +102 -0
- package/dist/core/src/render/passes/skinning.js +282 -0
- package/dist/core/src/render/passes/sky-dome.js +380 -0
- package/dist/core/src/render/passes/skybox.js +146 -0
- package/dist/core/src/render/passes/spot-light-shadow.js +223 -0
- package/dist/core/src/render/passes/terrain.js +303 -0
- package/dist/core/src/render/passes/transparent.js +323 -0
- package/dist/core/src/render/passes/underwater-fog.js +173 -0
- package/dist/core/src/render/passes/video-texture.js +58 -0
- package/dist/core/src/render/passes/volumetric-pass.js +278 -0
- package/dist/core/src/render/passes/volumetric-types.js +96 -0
- package/dist/core/src/render/passes/water.js +697 -0
- package/dist/core/src/render/pbr.js +257 -0
- package/dist/core/src/render/pipeline.js +49 -0
- package/dist/core/src/render/render-pass.js +13 -0
- package/dist/core/src/render/renderer-input-bus.js +176 -0
- package/dist/core/src/render/renderer-module-host.js +539 -0
- package/dist/core/src/render/resource-tracker.js +59 -0
- package/dist/core/src/render/sab-canvas-overlay.js +83 -0
- package/dist/core/src/render/shader-validator.js +172 -0
- package/dist/core/src/render/shaders/debug/debug-line.wgsl +27 -0
- package/dist/core/src/render/shaders/debug/debug-point.wgsl +30 -0
- package/dist/core/src/render/shaders/debug/debug-text.wgsl +42 -0
- package/dist/core/src/render/shaders/debug-viz/aabb.wgsl +20 -0
- package/dist/core/src/render/shaders/debug-viz/depth.wgsl +29 -0
- package/dist/core/src/render/shaders/debug-viz/lod.wgsl +38 -0
- package/dist/core/src/render/shaders/debug-viz/normals.wgsl +30 -0
- package/dist/core/src/render/shaders/debug-viz/overdraw.wgsl +21 -0
- package/dist/core/src/render/shaders/debug-viz/tangents.wgsl +29 -0
- package/dist/core/src/render/shaders/debug-viz/wireframe.wgsl +33 -0
- package/dist/core/src/render/shaders/shadow-chunks.js +133 -0
- package/dist/core/src/render/skybox.js +123 -0
- package/dist/core/src/render/splitscreen.js +60 -0
- package/dist/core/src/render/surface.js +63 -0
- package/dist/core/src/render/tonemap.js +171 -0
- package/dist/core/src/render/tracked-render-pass.js +115 -0
- package/dist/core/src/render/viewport.js +81 -0
- package/dist/core/src/render/wgsl-hmr.js +66 -0
- package/dist/core/src/sab/core-input-channel.js +22 -0
- package/dist/core/src/sab/define.js +127 -0
- package/dist/core/src/sab/errors.js +60 -0
- package/dist/core/src/sab/game-input.js +299 -0
- package/dist/core/src/sab/gamepad-devices.js +205 -0
- package/dist/core/src/sab/grid-buffer.js +91 -0
- package/dist/core/src/sab/input.js +38 -0
- package/dist/core/src/sab/layout.js +160 -0
- package/dist/core/src/sab/multi-input-channel.js +39 -0
- package/dist/core/src/sab/record-buffer.js +130 -0
- package/dist/core/src/sab/sab-polyfill.js +47 -0
- package/dist/core/src/sab/sim-channel.js +397 -0
- package/dist/core/src/sab/slot-buffer.js +140 -0
- package/dist/core/src/sab/types.js +1 -0
- package/dist/core/src/safety/bounds.js +71 -0
- package/dist/core/src/safety/json.js +70 -0
- package/dist/core/src/safety/path.js +151 -0
- package/dist/core/src/save/binary-format.js +95 -0
- package/dist/core/src/save/game-save-system.js +101 -0
- package/dist/core/src/save/grid-save-system.js +102 -0
- package/dist/core/src/save/migrate.js +35 -0
- package/dist/core/src/save/migration-registry.js +66 -0
- package/dist/core/src/save/persist-types.js +4 -0
- package/dist/core/src/save/schema.js +36 -0
- package/dist/core/src/save/serializer.js +139 -0
- package/dist/core/src/scene/builder.js +31 -0
- package/dist/core/src/scene/camera.js +118 -0
- package/dist/core/src/scene/checkpoint.js +84 -0
- package/dist/core/src/scene/game-loop.js +155 -0
- package/dist/core/src/scene/index.js +14 -0
- package/dist/core/src/scene/layer.js +7 -0
- package/dist/core/src/scene/prefab.js +97 -0
- package/dist/core/src/scene/scene-manager.js +141 -0
- package/dist/core/src/scene/scene.js +147 -0
- package/dist/core/src/scene/sky.js +179 -0
- package/dist/core/src/scene/spatial-grid.js +140 -0
- package/dist/core/src/scene/streaming.js +247 -0
- package/dist/core/src/scene/vegetation.js +107 -0
- package/dist/core/src/scene/world.js +66 -0
- package/dist/core/src/scripting/binding.js +85 -0
- package/dist/core/src/scripting/hot-reload.js +123 -0
- package/dist/core/src/scripting/script.js +68 -0
- package/dist/core/src/sim/hot-reload-pipeline.js +65 -0
- package/dist/core/src/sim/sim-state-helper.js +40 -0
- package/dist/core/src/sim/transient-state-registry.js +63 -0
- package/dist/core/src/sim/types.js +4 -0
- package/dist/core/src/sim/worker-loop.js +168 -0
- package/dist/core/src/stores/game-store.js +81 -0
- package/dist/core/src/stores/hot-reload-store.js +19 -0
- package/dist/core/src/telemetry/collector.js +303 -0
- package/dist/core/src/telemetry/gc-controller.js +365 -0
- package/dist/core/src/telemetry/gc-profiler.js +82 -0
- package/dist/core/src/telemetry/gc-tracker.js +63 -0
- package/dist/core/src/telemetry/gpu-profiler.js +554 -0
- package/dist/core/src/telemetry/gpu-resource-tracker.js +234 -0
- package/dist/core/src/telemetry/gpu-timer-pool.js +223 -0
- package/dist/core/src/telemetry/gpu-timer.js +117 -0
- package/dist/core/src/telemetry/gpu-timestamp-gate.js +22 -0
- package/dist/core/src/telemetry/reporter.js +56 -0
- package/dist/core/src/types/engine-types.js +21 -0
- package/dist/core/src/ui-font-scale.js +111 -0
- package/dist/core/src/util/broad-phase-grid.js +77 -0
- package/dist/core/src/util/feature-log.js +176 -0
- package/dist/core/src/util/index.js +4 -0
- package/dist/core/src/util/logger.js +596 -0
- package/dist/core/src/version.js +11 -0
- package/dist/core/src/webgpu-destroy-augmentation.d.ts +25 -0
- package/dist/core/src/worker/base-worker-host.js +212 -0
- package/dist/core/src/worker/buffer-sync.js +454 -0
- package/dist/core/src/worker/crash-recovery.js +153 -0
- package/dist/core/src/worker/entity-sim-worker-host.js +128 -0
- package/dist/core/src/worker/instrumented-worker-host.js +139 -0
- package/dist/core/src/worker/rpc.js +244 -0
- package/dist/core/src/worker/sim-worker-base.js +558 -0
- package/dist/core/src/worker/sim-worker-host.js +271 -0
- package/dist/core/src/worker/task-pool.js +205 -0
- package/dist/core/src/worker/task-worker.js +77 -0
- package/dist/libraries/asset-browser/src/index.js +10 -0
- package/dist/libraries/asset-browser/src/software-thumbnails.js +940 -0
- package/dist/libraries/audio-kira/src/backend.js +405 -0
- package/dist/libraries/audio-kira/src/index.js +4 -0
- package/dist/libraries/audio-kira/src/library.js +54 -0
- package/dist/libraries/blitz-ui/src/index.js +13 -0
- package/dist/libraries/blitz-ui/src/native-module.js +162 -0
- package/dist/libraries/blitz-ui/src/native-osr-ffi.js +409 -0
- package/dist/libraries/blitz-ui/src/router.js +82 -0
- package/dist/libraries/blitz-ui/src/shaders/ui-blit.wgsl.js +32 -0
- package/dist/libraries/blitz-ui/src/ui-blit-pass.js +108 -0
- package/dist/libraries/character/src/character-animator.js +323 -0
- package/dist/libraries/character/src/customization.js +464 -0
- package/dist/libraries/character/src/index.js +19 -0
- package/dist/libraries/character/src/inspectable.js +77 -0
- package/dist/libraries/character/src/loader.js +336 -0
- package/dist/libraries/character/src/locomotion.js +84 -0
- package/dist/libraries/character/src/preview.js +280 -0
- package/dist/libraries/devtools/src/backend.js +449 -0
- package/dist/libraries/devtools/src/cdp-bridge.js +293 -0
- package/dist/libraries/devtools/src/collectors.js +318 -0
- package/dist/libraries/devtools/src/index.js +31 -0
- package/dist/libraries/devtools/src/native-providers.js +749 -0
- package/dist/libraries/devtools/src/snapshot.js +35 -0
- package/dist/libraries/devtools/src/verify.js +139 -0
- package/dist/libraries/devtools/src/web/browser.js +94 -0
- package/dist/libraries/devtools/src/web/host.js +183 -0
- package/dist/libraries/devtools/src/web/mirror.js +26 -0
- package/dist/libraries/devtools/src/web/server.js +187 -0
- package/dist/libraries/entities/src/index.js +3 -0
- package/dist/libraries/entities/src/library.js +46 -0
- package/dist/libraries/entities/src/model-renderer.js +1307 -0
- package/dist/libraries/entities/src/shaders/model.wgsl +375 -0
- package/dist/libraries/gamepad/src/feed-input.js +54 -0
- package/dist/libraries/gamepad/src/filters.js +44 -0
- package/dist/libraries/gamepad/src/glyphs.js +83 -0
- package/dist/libraries/gamepad/src/hub.js +164 -0
- package/dist/libraries/gamepad/src/index.js +10 -0
- package/dist/libraries/gamepad/src/library.js +56 -0
- package/dist/libraries/gamepad/src/source-sab.js +62 -0
- package/dist/libraries/gamepad/src/sysfs-enrich.js +125 -0
- package/dist/libraries/gaussian-splats/src/gpu-sort.js +506 -0
- package/dist/libraries/gaussian-splats/src/index.js +8 -0
- package/dist/libraries/gaussian-splats/src/library.js +44 -0
- package/dist/libraries/gaussian-splats/src/parser.js +297 -0
- package/dist/libraries/gaussian-splats/src/renderer.js +368 -0
- package/dist/libraries/gaussian-splats/src/sh-eval.js +196 -0
- package/dist/libraries/gaussian-splats/src/sorter.js +76 -0
- package/dist/libraries/gaussian-splats/src/tile-raster.js +424 -0
- package/dist/libraries/gpu-kernels/src/index.js +8 -0
- package/dist/libraries/gpu-kernels/src/kernel.js +591 -0
- package/dist/libraries/gpu-kernels/src/transpile.js +896 -0
- package/dist/libraries/html-ui-kit/src/behaviors.js +231 -0
- package/dist/libraries/html-ui-kit/src/components.js +219 -0
- package/dist/libraries/html-ui-kit/src/index.js +17 -0
- package/dist/libraries/html-ui-kit/src/nav/nav-controller.js +215 -0
- package/dist/libraries/html-ui-kit/src/nav/nav-input.js +138 -0
- package/dist/libraries/html-ui-kit/src/nav/osk.js +135 -0
- package/dist/libraries/html-ui-kit/src/nav/router.js +152 -0
- package/dist/libraries/html-ui-kit/src/nav/vcursor.js +177 -0
- package/dist/libraries/html-ui-kit/src/ten-foot.js +138 -0
- package/dist/libraries/html-ui-kit/src/theme.js +235 -0
- package/dist/libraries/inspectable/src/index.js +6 -0
- package/dist/libraries/inspectable/src/inspectable.js +205 -0
- package/dist/libraries/lighting/src/index.js +4 -0
- package/dist/libraries/lighting/src/library.js +48 -0
- package/dist/libraries/lighting/src/light-system.js +395 -0
- package/dist/libraries/lighting/src/lighting-system.js +57 -0
- package/dist/libraries/lighting/src/shaders/light-debug.wgsl +30 -0
- package/dist/libraries/marching-cubes/src/chunked-field.js +130 -0
- package/dist/libraries/marching-cubes/src/deformation.js +41 -0
- package/dist/libraries/marching-cubes/src/generator.js +356 -0
- package/dist/libraries/marching-cubes/src/index.js +13 -0
- package/dist/libraries/marching-cubes/src/library.js +54 -0
- package/dist/libraries/marching-cubes/src/lod.js +95 -0
- package/dist/libraries/marching-cubes/src/marching-tetrahedra.js +261 -0
- package/dist/libraries/marching-cubes/src/sab.js +40 -0
- package/dist/libraries/marching-cubes/src/streaming-config.js +28 -0
- package/dist/libraries/marching-cubes/src/streaming-manager.js +490 -0
- package/dist/libraries/marching-cubes/src/tables.js +314 -0
- package/dist/libraries/marching-cubes/src/types.js +1 -0
- package/dist/libraries/models/src/bake-node-transforms.js +146 -0
- package/dist/libraries/models/src/bind-unskinned-meshes.js +145 -0
- package/dist/libraries/models/src/codecs/basisu-codec.js +134 -0
- package/dist/libraries/models/src/codecs/draco-codec.js +236 -0
- package/dist/libraries/models/src/codecs/draco3dgltf.d.ts +40 -0
- package/dist/libraries/models/src/codecs/index.js +5 -0
- package/dist/libraries/models/src/codecs/meshopt-codec.js +59 -0
- package/dist/libraries/models/src/codecs/registry.js +111 -0
- package/dist/libraries/models/src/dae.js +665 -0
- package/dist/libraries/models/src/default-part-selection.js +58 -0
- package/dist/libraries/models/src/dxf.js +235 -0
- package/dist/libraries/models/src/fbx/index.js +438 -0
- package/dist/libraries/models/src/fbx/interpreter/animation.js +369 -0
- package/dist/libraries/models/src/fbx/interpreter/blend-shapes.js +283 -0
- package/dist/libraries/models/src/fbx/interpreter/connections.js +158 -0
- package/dist/libraries/models/src/fbx/interpreter/diagnostics.js +48 -0
- package/dist/libraries/models/src/fbx/interpreter/geometry.js +430 -0
- package/dist/libraries/models/src/fbx/interpreter/global-settings.js +77 -0
- package/dist/libraries/models/src/fbx/interpreter/materials.js +231 -0
- package/dist/libraries/models/src/fbx/interpreter/nodes.js +168 -0
- package/dist/libraries/models/src/fbx/interpreter/skeleton.js +454 -0
- package/dist/libraries/models/src/fbx/parsers/binary-parser.js +217 -0
- package/dist/libraries/models/src/fbx/types.js +88 -0
- package/dist/libraries/models/src/gltf-extensions.js +121 -0
- package/dist/libraries/models/src/gltf.js +724 -0
- package/dist/libraries/models/src/index.js +46 -0
- package/dist/libraries/models/src/library.js +44 -0
- package/dist/libraries/models/src/loader.js +218 -0
- package/dist/libraries/models/src/material-adapter.js +82 -0
- package/dist/libraries/models/src/mini-xml.js +145 -0
- package/dist/libraries/models/src/normalize.js +168 -0
- package/dist/libraries/models/src/obj.js +247 -0
- package/dist/libraries/models/src/off.js +94 -0
- package/dist/libraries/models/src/ply.js +329 -0
- package/dist/libraries/models/src/pose-sampler.js +183 -0
- package/dist/libraries/models/src/sidecar/blender-extras.js +32 -0
- package/dist/libraries/models/src/sidecar/ddmeta.js +98 -0
- package/dist/libraries/models/src/sidecar/godot-import.js +76 -0
- package/dist/libraries/models/src/sidecar/resolver.js +112 -0
- package/dist/libraries/models/src/sidecar/types.js +8 -0
- package/dist/libraries/models/src/sidecar/unity-meta.js +46 -0
- package/dist/libraries/models/src/skeleton-synthesis.js +122 -0
- package/dist/libraries/models/src/stl.js +129 -0
- package/dist/libraries/models/src/threeds.js +312 -0
- package/dist/libraries/models/src/threemf.js +203 -0
- package/dist/libraries/models/src/types.js +33 -0
- package/dist/libraries/models/src/vtk.js +242 -0
- package/dist/libraries/navmesh/src/crowd-system.js +207 -0
- package/dist/libraries/navmesh/src/debug-viz.js +52 -0
- package/dist/libraries/navmesh/src/index.js +7 -0
- package/dist/libraries/navmesh/src/library.js +47 -0
- package/dist/libraries/navmesh/src/navmesh-generator.js +364 -0
- package/dist/libraries/navmesh/src/navmesh.js +141 -0
- package/dist/libraries/navmesh/src/pathfinder.js +221 -0
- package/dist/libraries/navmesh/src/types.js +1 -0
- package/dist/libraries/networking/src/authority.js +107 -0
- package/dist/libraries/networking/src/connection.js +107 -0
- package/dist/libraries/networking/src/discovery.js +314 -0
- package/dist/libraries/networking/src/enhanced-replication.js +282 -0
- package/dist/libraries/networking/src/epic-adapter.js +101 -0
- package/dist/libraries/networking/src/index.js +16 -0
- package/dist/libraries/networking/src/library.js +45 -0
- package/dist/libraries/networking/src/lobby.js +84 -0
- package/dist/libraries/networking/src/platform-adapter.js +92 -0
- package/dist/libraries/networking/src/rcs-adapter.js +100 -0
- package/dist/libraries/networking/src/remote-input.js +162 -0
- package/dist/libraries/networking/src/replication.js +273 -0
- package/dist/libraries/networking/src/rpc.js +172 -0
- package/dist/libraries/networking/src/session.js +129 -0
- package/dist/libraries/networking/src/transport.js +156 -0
- package/dist/libraries/networking/src/webrtc.js +266 -0
- package/dist/libraries/pathfinding-2d/src/astar-grid.js +255 -0
- package/dist/libraries/pathfinding-2d/src/index.js +9 -0
- package/dist/libraries/persistence/src/autosave-manager.js +94 -0
- package/dist/libraries/persistence/src/binary-record-store.js +205 -0
- package/dist/libraries/persistence/src/browser.js +16 -0
- package/dist/libraries/persistence/src/file-save-store.js +507 -0
- package/dist/libraries/persistence/src/hash-utils.js +54 -0
- package/dist/libraries/persistence/src/index.js +17 -0
- package/dist/libraries/persistence/src/library.js +51 -0
- package/dist/libraries/persistence/src/mock-opfs.js +114 -0
- package/dist/libraries/persistence/src/node-fs-directory-handle.js +168 -0
- package/dist/libraries/persistence/src/opfs-save-store.js +584 -0
- package/dist/libraries/persistence/src/save-worker-proxy.js +96 -0
- package/dist/libraries/persistence/src/save-worker.js +76 -0
- package/dist/libraries/persistence/src/xxh3-ts.d.ts +10 -0
- package/dist/libraries/physics-native/src/backend.js +960 -0
- package/dist/libraries/physics-native/src/broadphase.js +79 -0
- package/dist/libraries/physics-native/src/index.js +6 -0
- package/dist/libraries/physics-native/src/library.js +57 -0
- package/dist/libraries/physics-native/src/narrowphase-shapes.js +348 -0
- package/dist/libraries/physics-native/src/narrowphase.js +60 -0
- package/dist/libraries/physics-native/src/solver.js +105 -0
- package/dist/libraries/physics-native/src/types.js +4 -0
- package/dist/libraries/physics-rapier/src/api.js +352 -0
- package/dist/libraries/physics-rapier/src/auto-backend.js +54 -0
- package/dist/libraries/physics-rapier/src/backend.js +1066 -0
- package/dist/libraries/physics-rapier/src/bulk-ops.js +46 -0
- package/dist/libraries/physics-rapier/src/ffi-backend.js +17 -0
- package/dist/libraries/physics-rapier/src/ffi-lib.js +605 -0
- package/dist/libraries/physics-rapier/src/index.js +9 -0
- package/dist/libraries/physics-rapier/src/library.js +71 -0
- package/dist/libraries/physics-rapier/src/rapier-backend.js +1102 -0
- package/dist/libraries/physics-rapier/src/realm-worker-script.js +233 -0
- package/dist/libraries/postfx/src/index.js +14 -0
- package/dist/libraries/postfx/src/library.js +207 -0
- package/dist/libraries/postfx/src/post-process-stack.js +1641 -0
- package/dist/libraries/postfx/src/shaders/post-process/afterimage.wgsl +14 -0
- package/dist/libraries/postfx/src/shaders/post-process/ascii.wgsl +24 -0
- package/dist/libraries/postfx/src/shaders/post-process/blit.wgsl +12 -0
- package/dist/libraries/postfx/src/shaders/post-process/bloom-blur.wgsl +21 -0
- package/dist/libraries/postfx/src/shaders/post-process/bloom-bright.wgsl +15 -0
- package/dist/libraries/postfx/src/shaders/post-process/bloom-composite.wgsl +14 -0
- package/dist/libraries/postfx/src/shaders/post-process/bloom-downsample.wgsl +60 -0
- package/dist/libraries/postfx/src/shaders/post-process/bloom-soft.wgsl +46 -0
- package/dist/libraries/postfx/src/shaders/post-process/bloom-upsample.wgsl +51 -0
- package/dist/libraries/postfx/src/shaders/post-process/channel-mixer.wgsl +36 -0
- package/dist/libraries/postfx/src/shaders/post-process/chromatic-aberration.wgsl +37 -0
- package/dist/libraries/postfx/src/shaders/post-process/dithering.wgsl +64 -0
- package/dist/libraries/postfx/src/shaders/post-process/dof.wgsl +131 -0
- package/dist/libraries/postfx/src/shaders/post-process/edges.wgsl +45 -0
- package/dist/libraries/postfx/src/shaders/post-process/fullscreen-vs.wgsl +15 -0
- package/dist/libraries/postfx/src/shaders/post-process/fxaa.wgsl +102 -0
- package/dist/libraries/postfx/src/shaders/post-process/gaussian-blur.wgsl +37 -0
- package/dist/libraries/postfx/src/shaders/post-process/glow-blur.wgsl +33 -0
- package/dist/libraries/postfx/src/shaders/post-process/glow-composite.wgsl +25 -0
- package/dist/libraries/postfx/src/shaders/post-process/grain.wgsl +37 -0
- package/dist/libraries/postfx/src/shaders/post-process/halftone.wgsl +80 -0
- package/dist/libraries/postfx/src/shaders/post-process/highlight-blur.wgsl +33 -0
- package/dist/libraries/postfx/src/shaders/post-process/highlight-composite.wgsl +32 -0
- package/dist/libraries/postfx/src/shaders/post-process/lens-distortion.wgsl +43 -0
- package/dist/libraries/postfx/src/shaders/post-process/lens-flare.wgsl +68 -0
- package/dist/libraries/postfx/src/shaders/post-process/lut.wgsl +30 -0
- package/dist/libraries/postfx/src/shaders/post-process/motion-blur.wgsl +55 -0
- package/dist/libraries/postfx/src/shaders/post-process/occluder-chunk.wgsl +28 -0
- package/dist/libraries/postfx/src/shaders/post-process/outline.wgsl +51 -0
- package/dist/libraries/postfx/src/shaders/post-process/pixelation.wgsl +47 -0
- package/dist/libraries/postfx/src/shaders/post-process/sharpen.wgsl +32 -0
- package/dist/libraries/postfx/src/shaders/post-process/sobel.wgsl +26 -0
- package/dist/libraries/postfx/src/shaders/post-process/split-tone.wgsl +36 -0
- package/dist/libraries/postfx/src/shaders/post-process/ssao-blur.wgsl +38 -0
- package/dist/libraries/postfx/src/shaders/post-process/ssao-composite.wgsl +25 -0
- package/dist/libraries/postfx/src/shaders/post-process/ssao.wgsl +147 -0
- package/dist/libraries/postfx/src/shaders/post-process/ssr.wgsl +155 -0
- package/dist/libraries/postfx/src/shaders/post-process/taa.wgsl +98 -0
- package/dist/libraries/postfx/src/shaders/post-process/tonemap.wgsl +40 -0
- package/dist/libraries/postfx/src/shaders/post-process/watercolor.wgsl +82 -0
- package/dist/libraries/postfx/src/shaders/post-process/white-balance.wgsl +41 -0
- package/dist/libraries/recast/src/backend.js +124 -0
- package/dist/libraries/recast/src/crowd-system.js +310 -0
- package/dist/libraries/recast/src/index.js +4 -0
- package/dist/libraries/recast/src/library.js +59 -0
- package/dist/libraries/recast/src/types.js +4 -0
- package/dist/libraries/sand/src/cell.js +32 -0
- package/dist/libraries/sand/src/fields.js +27 -0
- package/dist/libraries/sand/src/fluid-grid.js +267 -0
- package/dist/libraries/sand/src/grid-dims.js +47 -0
- package/dist/libraries/sand/src/grid-sim-buffer.js +184 -0
- package/dist/libraries/sand/src/index.js +20 -0
- package/dist/libraries/sand/src/library.js +67 -0
- package/dist/libraries/sand/src/materials.js +437 -0
- package/dist/libraries/sand/src/palette.js +87 -0
- package/dist/libraries/sand/src/particles.js +163 -0
- package/dist/libraries/sand/src/render/sand-grid-pass.js +377 -0
- package/dist/libraries/sand/src/rng.js +44 -0
- package/dist/libraries/sand/src/rules/builtin-rules.js +125 -0
- package/dist/libraries/sand/src/rules/rule-compiler.js +164 -0
- package/dist/libraries/sand/src/rules/rule-engine.js +210 -0
- package/dist/libraries/sand/src/rules/rule-types.js +27 -0
- package/dist/libraries/sand/src/sand-step-pool.js +458 -0
- package/dist/libraries/sand/src/sand-step-worker.js +101 -0
- package/dist/libraries/sand/src/sand-world.js +3382 -0
- package/dist/libraries/stickman/src/index.js +7 -0
- package/dist/libraries/stickman/src/library.js +44 -0
- package/dist/libraries/stickman/src/proportions.js +40 -0
- package/dist/libraries/stickman/src/shader.js +113 -0
- package/dist/libraries/stickman/src/skeleton.js +163 -0
- package/dist/libraries/stickman/src/stickman-pass.js +210 -0
- package/dist/libraries/stickman/src/thick-line.js +120 -0
- package/dist/libraries/surface-nets/src/chunked-field.js +5 -0
- package/dist/libraries/surface-nets/src/deformation.js +29 -0
- package/dist/libraries/surface-nets/src/index.js +15 -0
- package/dist/libraries/surface-nets/src/library.js +41 -0
- package/dist/libraries/surface-nets/src/lod.js +6 -0
- package/dist/libraries/surface-nets/src/sab.js +4 -0
- package/dist/libraries/surface-nets/src/streaming-config.js +4 -0
- package/dist/libraries/surface-nets/src/streaming-manager.js +9 -0
- package/dist/libraries/surface-nets/src/surface-nets.js +361 -0
- package/dist/libraries/surface-nets/src/types.js +1 -0
- package/dist/libraries/water/src/buoyancy.js +80 -0
- package/dist/libraries/water/src/index.js +12 -0
- package/dist/libraries/water/src/library.js +65 -0
- package/dist/libraries/water/src/shore-damping.js +70 -0
- package/dist/libraries/water/src/water-buffer.js +78 -0
- package/dist/libraries/water/src/water-chunks.js +5 -0
- package/dist/libraries/water/src/water-physics.js +315 -0
- package/dist/libraries/water/src/water-renderer.js +736 -0
- package/dist/libraries/water/src/water-sab.js +138 -0
- package/dist/libraries/water/src/wave-sources.js +45 -0
- package/dist/libraries/weather/src/index.js +5 -0
- package/dist/libraries/weather/src/library.js +48 -0
- package/dist/libraries/weather/src/types.js +29 -0
- package/dist/libraries/weather/src/weather-blend.js +108 -0
- package/dist/libraries/weather/src/weather-system.js +275 -0
- package/dist/libraries/weatherfx/src/cloud-provider.js +5 -0
- package/dist/libraries/weatherfx/src/cloud-system.js +294 -0
- package/dist/libraries/weatherfx/src/index.js +4 -0
- package/dist/libraries/weatherfx/src/library.js +41 -0
- package/dist/libraries/weatherfx/src/particle-system.js +350 -0
- package/dist/libraries/weatherfx/src/shaders/cloud.wgsl +111 -0
- package/dist/libraries/weatherfx/src/shaders/particle-compute.wgsl +187 -0
- package/dist/libraries/weatherfx/src/shaders/particle-render.wgsl +95 -0
- package/dist/mcp/src/client.js +669 -0
- package/dist/mcp/src/engine-context.js +99 -0
- package/dist/mcp/src/http-transport.js +423 -0
- package/dist/mcp/src/index.js +5 -0
- package/dist/mcp/src/prompts/add-entity.js +39 -0
- package/dist/mcp/src/prompts/create-scene.js +41 -0
- package/dist/mcp/src/prompts/debug-frame.js +36 -0
- package/dist/mcp/src/prompts/index.js +10 -0
- package/dist/mcp/src/resources/asset-list.js +28 -0
- package/dist/mcp/src/resources/checkpoint-list.js +29 -0
- package/dist/mcp/src/resources/entity-state.js +45 -0
- package/dist/mcp/src/resources/gpu-info.js +90 -0
- package/dist/mcp/src/resources/index.js +51 -0
- package/dist/mcp/src/resources/performance.js +33 -0
- package/dist/mcp/src/resources/scene-tree.js +37 -0
- package/dist/mcp/src/server.js +307 -0
- package/dist/mcp/src/tools/animation.js +102 -0
- package/dist/mcp/src/tools/asset.js +146 -0
- package/dist/mcp/src/tools/audio.js +80 -0
- package/dist/mcp/src/tools/build.js +128 -0
- package/dist/mcp/src/tools/camera.js +157 -0
- package/dist/mcp/src/tools/checkpoint.js +90 -0
- package/dist/mcp/src/tools/component.js +176 -0
- package/dist/mcp/src/tools/debug.js +273 -0
- package/dist/mcp/src/tools/entity.js +309 -0
- package/dist/mcp/src/tools/inspect.js +192 -0
- package/dist/mcp/src/tools/lighting.js +239 -0
- package/dist/mcp/src/tools/material.js +225 -0
- package/dist/mcp/src/tools/mesh.js +210 -0
- package/dist/mcp/src/tools/physics.js +251 -0
- package/dist/mcp/src/tools/scene.js +139 -0
- package/dist/mcp/src/tools/script.js +114 -0
- package/dist/mcp/src/types.js +9 -0
- package/dist/mcp/src/undo-redo.js +64 -0
- package/dist/modules/camera-controls/src/index.js +116 -0
- package/dist/modules/controller-ui/src/index.js +149 -0
- package/dist/modules/devtools/src/api.js +317 -0
- package/dist/modules/devtools/src/asset-utils.js +102 -0
- package/dist/modules/devtools/src/bind-debug-store.js +34 -0
- package/dist/modules/devtools/src/blitz/host.js +391 -0
- package/dist/modules/devtools/src/blitz/module.js +65 -0
- package/dist/modules/devtools/src/blitz/panels/console.js +217 -0
- package/dist/modules/devtools/src/blitz/panels/elements.js +79 -0
- package/dist/modules/devtools/src/blitz/panels/gpu.js +61 -0
- package/dist/modules/devtools/src/blitz/panels/performance.js +113 -0
- package/dist/modules/devtools/src/blitz/panels/snapshot.js +141 -0
- package/dist/modules/devtools/src/blitz/panels/types.js +55 -0
- package/dist/modules/devtools/src/blitz/theme.js +167 -0
- package/dist/modules/devtools/src/data-bridge.js +247 -0
- package/dist/modules/devtools/src/debug-overlay.js +181 -0
- package/dist/modules/devtools/src/debug-raycast.js +296 -0
- package/dist/modules/devtools/src/debug-store.js +28 -0
- package/dist/modules/devtools/src/debug-view-descriptors.js +24 -0
- package/dist/modules/devtools/src/doctor-panel.js +163 -0
- package/dist/modules/devtools/src/gizmo-module.js +95 -0
- package/dist/modules/devtools/src/graph-model.js +387 -0
- package/dist/modules/devtools/src/grid-renderer.js +145 -0
- package/dist/modules/devtools/src/height-ruler-renderer.js +189 -0
- package/dist/modules/devtools/src/index.js +46 -0
- package/dist/modules/devtools/src/init.js +204 -0
- package/dist/modules/devtools/src/label-overlay.js +129 -0
- package/dist/modules/devtools/src/material-stats-panel.js +171 -0
- package/dist/modules/devtools/src/profiling-bridge.js +288 -0
- package/dist/modules/devtools/src/profiling-hooks.js +63 -0
- package/dist/modules/devtools/src/renderer-adapter.js +61 -0
- package/dist/modules/devtools/src/scene-inspector.js +571 -0
- package/dist/modules/devtools/src/scene-store.js +212 -0
- package/dist/modules/devtools/src/scene-sync.js +92 -0
- package/dist/modules/devtools/src/shaders/transform-gizmo.wgsl +38 -0
- package/dist/modules/devtools/src/sim-stats-panel.js +250 -0
- package/dist/modules/devtools/src/sim-stats-provider.js +73 -0
- package/dist/modules/devtools/src/skeleton-renderer.js +326 -0
- package/dist/modules/devtools/src/transform-gizmo.js +677 -0
- package/dist/modules/devtools/src/types.js +5 -0
- package/dist/modules/devtools/src/worker-expose.js +59 -0
- package/dist/modules/devtools/src/worker-sync.js +115 -0
- package/dist/modules/editor/src/commands/component.js +151 -0
- package/dist/modules/editor/src/commands/entity.js +253 -0
- package/dist/modules/editor/src/commands/hierarchy.js +79 -0
- package/dist/modules/editor/src/commands/index.js +57 -0
- package/dist/modules/editor/src/commands/prefab.js +149 -0
- package/dist/modules/editor/src/commands/registry.js +246 -0
- package/dist/modules/editor/src/commands/scene-io.js +206 -0
- package/dist/modules/editor/src/commands/selection.js +71 -0
- package/dist/modules/editor/src/commands/transform.js +88 -0
- package/dist/modules/editor/src/ddscene.js +189 -0
- package/dist/modules/editor/src/document.js +96 -0
- package/dist/modules/editor/src/editor-context.js +115 -0
- package/dist/modules/editor/src/index.js +11 -0
- package/dist/modules/editor/src/mcp.js +91 -0
- package/dist/modules/editor/src/module.js +115 -0
- package/dist/modules/editor/src/selection.js +60 -0
- package/dist/modules/editor/src/shell.js +397 -0
- package/dist/modules/editor/src/viewport.js +186 -0
- package/dist/modules/html-ui/src/composite.js +116 -0
- package/dist/modules/html-ui/src/create-html-ui.js +137 -0
- package/dist/modules/html-ui/src/doc-backend.js +518 -0
- package/dist/modules/html-ui/src/host.js +819 -0
- package/dist/modules/html-ui/src/index.js +5 -0
- package/dist/modules/html-ui/src/jsx-dev-runtime.js +9 -0
- package/dist/modules/html-ui/src/jsx-runtime.js +121 -0
- package/dist/modules/html-ui/src/protocol.js +6 -0
- package/dist/modules/html-ui/src/ui-worker.js +10 -0
- package/dist/modules/mcp/src/index.js +62 -0
- package/dist/modules/movement-2d/src/grid-character.js +345 -0
- package/dist/modules/movement-2d/src/index.js +27 -0
- package/dist/modules/movement-3d/src/character-motor.js +166 -0
- package/dist/modules/movement-3d/src/index.js +27 -0
- package/dist/modules/native-osr/src/index.js +12 -0
- package/dist/modules/native-osr/src/input-router.js +335 -0
- package/dist/modules/native-osr/src/native-osr-manager.js +210 -0
- package/dist/modules/native-osr/src/native-texture-source.js +66 -0
- package/dist/modules/native-osr/src/types.js +8 -0
- package/dist/modules/native-osr/src/world-space-ui-pass.js +313 -0
- package/dist/modules/sailing/src/index.js +39 -0
- package/dist/modules/terrain/src/index.js +44 -0
- package/dist/modules/vitals/src/index.js +25 -0
- package/dist/modules/vitals/src/vitals.js +195 -0
- package/dist/modules/xr/src/camera-rig.js +119 -0
- package/dist/modules/xr/src/debug.js +45 -0
- package/dist/modules/xr/src/frame-loop.js +139 -0
- package/dist/modules/xr/src/index.js +10 -0
- package/dist/modules/xr/src/input.js +164 -0
- package/dist/modules/xr/src/layer.js +100 -0
- package/dist/modules/xr/src/session.js +133 -0
- package/dist/modules/xr/src/sim-module.js +21 -0
- package/dist/modules/xr/src/types.js +4 -0
- package/dist/modules/xr/src/webxr.d.ts +182 -0
- package/dist/modules/xr/src/xr-module.js +134 -0
- package/dist/shader-graph/src/chunks.js +340 -0
- package/dist/shader-graph/src/compiler.js +639 -0
- package/dist/shader-graph/src/compute-compiler.js +384 -0
- package/dist/shader-graph/src/compute-graph.js +55 -0
- package/dist/shader-graph/src/compute-profiles.js +39 -0
- package/dist/shader-graph/src/graph.js +38 -0
- package/dist/shader-graph/src/index.js +15 -0
- package/dist/shader-graph/src/profiles.js +305 -0
- package/dist/shader-graph/src/validator.js +42 -0
- package/dist/shader-graph/src/wgsl-binding-validator.js +110 -0
- package/dist/shader-graph/src/wgsl-struct-validator.js +222 -0
- package/dist/shader-graph/src/wgsl-struct.js +251 -0
- package/dist/test/src/index.js +1 -0
- package/dist/test/src/vision-test.js +228 -0
- package/libraries/asset-browser/src/software-thumbnails.ts +2 -2
- package/libraries/audio-kira/src/backend.ts +2 -1
- package/libraries/blitz-ui/native/src/shell.rs +35 -1
- package/libraries/blitz-ui/native-osr/Cargo.toml +8 -0
- package/libraries/blitz-ui/native-osr/src/lib.rs +213 -22
- package/libraries/blitz-ui/native-osr/src/mutate.rs +109 -14
- package/libraries/blitz-ui/src/native-osr-ffi.ts +71 -8
- package/libraries/blitz-ui/src/router.ts +3 -1
- package/libraries/blitz-ui/src/ui-blit-pass.ts +1 -1
- package/libraries/character/src/character-animator.ts +1 -1
- package/libraries/character/src/customization.ts +513 -0
- package/libraries/character/src/index.ts +6 -0
- package/libraries/character/src/inspectable.ts +111 -0
- package/libraries/character/src/loader.ts +38 -13
- package/libraries/character/src/locomotion.ts +13 -1
- package/libraries/character/src/preview.ts +94 -24
- package/libraries/devtools/README.md +16 -18
- package/libraries/devtools/src/backend.ts +505 -0
- package/libraries/devtools/src/cdp-bridge.ts +8 -8
- package/libraries/devtools/src/collectors.ts +41 -37
- package/libraries/devtools/src/index.ts +32 -14
- package/libraries/devtools/src/native-providers.ts +20 -12
- package/libraries/devtools/src/snapshot.ts +77 -0
- package/libraries/devtools/src/web/host.ts +11 -12
- package/libraries/devtools/src/web/mirror.ts +14 -405
- package/libraries/devtools/src/web/server.ts +4 -3
- package/libraries/entities/src/model-renderer.ts +96 -23
- package/libraries/gamepad/src/library.ts +2 -1
- package/libraries/inspectable/src/index.ts +11 -0
- package/libraries/inspectable/src/inspectable.ts +277 -0
- package/libraries/marching-cubes/src/streaming-manager.ts +4 -4
- package/libraries/models/src/bind-unskinned-meshes.ts +131 -0
- package/libraries/models/src/index.ts +1 -0
- package/libraries/models/src/types.ts +22 -0
- package/libraries/persistence/src/autosave-manager.ts +1 -1
- package/libraries/persistence/src/binary-record-store.ts +1 -1
- package/libraries/persistence/src/file-save-store.ts +4 -4
- package/libraries/persistence/src/library.ts +1 -1
- package/libraries/persistence/src/opfs-save-store.ts +5 -5
- package/libraries/persistence/src/save-worker.ts +13 -14
- package/libraries/physics-rapier/src/ffi-lib.ts +2 -1
- package/libraries/postfx/src/post-process-stack.ts +1 -1
- package/libraries/sand/src/sand-step-pool.ts +5 -0
- package/libraries/water/src/water-renderer.ts +1 -1
- package/libraries/weatherfx/src/cloud-system.ts +3 -3
- package/mcp/README.md +20 -0
- package/mcp/src/client.ts +75 -22
- package/mcp/src/undo-redo.ts +2 -2
- package/modules/devtools/src/blitz/host.ts +430 -0
- package/modules/devtools/src/blitz/module.ts +101 -0
- package/modules/devtools/src/blitz/panels/console.ts +223 -0
- package/modules/devtools/src/blitz/panels/elements.ts +92 -0
- package/modules/devtools/src/blitz/panels/gpu.ts +70 -0
- package/modules/devtools/src/blitz/panels/performance.ts +120 -0
- package/modules/devtools/src/blitz/panels/snapshot.ts +152 -0
- package/modules/devtools/src/blitz/panels/types.ts +120 -0
- package/modules/devtools/src/blitz/theme.ts +168 -0
- package/modules/devtools/src/data-bridge.ts +1 -1
- package/modules/devtools/src/index.ts +6 -0
- package/modules/devtools/src/profiling-bridge.ts +17 -13
- package/modules/devtools/src/profiling-hooks.ts +22 -13
- package/modules/devtools/src/scene-inspector.ts +1 -1
- package/modules/devtools/src/worker-sync.ts +9 -1
- package/modules/editor/src/commands/registry.ts +2 -2
- package/modules/editor/src/module.ts +1 -1
- package/modules/html-ui/src/composite.ts +1 -1
- package/modules/html-ui/src/create-html-ui.ts +21 -9
- package/modules/html-ui/src/doc-backend.ts +189 -10
- package/modules/html-ui/src/host.ts +354 -40
- package/modules/html-ui/src/index.ts +1 -1
- package/modules/html-ui/src/jsx-runtime.ts +1 -1
- package/modules/html-ui/src/protocol.ts +53 -6
- package/modules/mcp/README.md +6 -0
- package/modules/mcp/src/index.ts +70 -3
- package/modules/movement-3d/src/character-motor.ts +83 -10
- package/package.json +838 -165
- package/shader-graph/README.md +25 -0
- package/test/README.md +16 -0
- package/libraries/blitz-ui/native-osr-spike.ts +0 -70
- package/libraries/devtools/native/Cargo.toml +0 -12
- package/libraries/devtools/native/src/lib.rs +0 -1646
- package/libraries/devtools/native/src/panels/console.rs +0 -338
- package/libraries/devtools/native/src/panels/dom_tree.rs +0 -47
- package/libraries/devtools/native/src/panels/generic.rs +0 -317
- package/libraries/devtools/native/src/panels/gpu.rs +0 -107
- package/libraries/devtools/native/src/panels/input.rs +0 -88
- package/libraries/devtools/native/src/panels/mod.rs +0 -154
- package/libraries/devtools/native/src/panels/perf_metrics.rs +0 -91
- package/libraries/devtools/native/src/panels/perf_recorder.rs +0 -158
- package/libraries/devtools/native/src/panels/scene.rs +0 -72
- package/libraries/devtools/native/src/state.rs +0 -394
- package/libraries/devtools/src/egui-ffi.ts +0 -804
- package/libraries/devtools/src/egui-renderer.ts +0 -407
- package/libraries/devtools/src/host.ts +0 -363
- package/libraries/devtools/src/mirror.ts +0 -794
- package/libraries/models/test-fixtures/fbx/LICENSE-notice.txt +0 -24
- package/libraries/models/test-fixtures/fbx/README.md +0 -46
- package/libraries/models/test-fixtures/fbx/m01_cube_phong.fbx +0 -0
- package/libraries/models/test-fixtures/fbx/m02_geo_ngons.fbx +0 -0
- package/libraries/models/test-fixtures/fbx/m03_normals.fbx +0 -0
- package/libraries/models/test-fixtures/fbx/m04_material_properties.fbx +0 -0
- package/libraries/models/test-fixtures/fbx/m05_external_diffuse.png +0 -0
- package/libraries/models/test-fixtures/fbx/m05_textures.fbx +0 -0
- package/libraries/models/test-fixtures/fbx/m06_uv_transform.fbx +0 -0
- package/libraries/models/test-fixtures/fbx/m07_multimaterial.fbx +0 -0
- package/libraries/models/test-fixtures/fbx/m08_transforms.fbx +0 -0
- package/libraries/models/test-fixtures/fbx/m09_skinning.fbx +0 -0
- package/libraries/models/test-fixtures/fbx/m10_morph.fbx +0 -0
- package/libraries/models/test-fixtures/fbx/m11_node_anim.fbx +0 -0
- package/libraries/models/test-fixtures/fbx/m12_skeletal_anim.fbx +0 -0
- package/libraries/models/test-fixtures/fbx/m13_morph_anim.fbx +0 -0
- package/libraries/models/test-fixtures/fbx/m14_multiclip.fbx +0 -0
- package/libraries/models/test-fixtures/fbx/m15_camera_lights.fbx +0 -0
- package/libraries/models/test-fixtures/fbx/m16_axis_yup.fbx +0 -0
- package/libraries/models/test-fixtures/fbx/m16_axis_zup.fbx +0 -0
- package/libraries/models/test-fixtures/fbx/m16_units_254.fbx +0 -0
- package/libraries/physics-native/src/ffi-spike-worker.ts +0 -71
- package/libraries/physics-rapier/bench/ffi-bench.ts +0 -79
- package/libraries/physics-rapier/bench/wasm-baseline.ts +0 -90
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
import { AssetManager as AssetManagerClass, AudioListener, AudioSource, BlendMode, Camera as CameraClass, CheckpointManager as CheckpointManagerClass, createAudioListener, createAudioSource, createDirectionalLight as createDirLight, createPointLight as createPtLight, CullMode, DebugDrawQueue as DebugDrawQueueClass, entityEqual, GameWorld as GameWorldClass, getComponentId, getComponentName, isAlive, LightType as LightTypeEnum, LODGenerator as LODGeneratorClass, Material as MaterialClass, MaterialHotReloader as MaterialHotReloaderClass, MaterialLibrary as MaterialLibraryClass, MeshBuilder as MeshBuilderClass, ROOT_ENTITY, SaveSystem as SaveSystemClass, Scene as SceneClass, ScriptingSystem as ScriptingSystemClass, TelemetryCollector as TelemetryCollectorClass, TelemetryReporter as TelemetryReporterClass, World as WorldClass } from "@downdraft/engine";
|
|
2
|
+
export class EngineContext {
|
|
3
|
+
world;
|
|
4
|
+
ecsWorld;
|
|
5
|
+
scene;
|
|
6
|
+
camera;
|
|
7
|
+
hierarchy;
|
|
8
|
+
assetManager;
|
|
9
|
+
materialLibrary;
|
|
10
|
+
checkpointManager;
|
|
11
|
+
telemetryCollector;
|
|
12
|
+
telemetryReporter;
|
|
13
|
+
debugDraw;
|
|
14
|
+
scriptingSystem;
|
|
15
|
+
saveSystem;
|
|
16
|
+
lights = [];
|
|
17
|
+
meshes = new Map();
|
|
18
|
+
entityMeshes = new Map();
|
|
19
|
+
entityMaterials = new Map();
|
|
20
|
+
physicsRealms = new Map();
|
|
21
|
+
bodyHandles = new Map();
|
|
22
|
+
raycastQuery = null;
|
|
23
|
+
debugVisualizeMode = "none";
|
|
24
|
+
audioEngine = null;
|
|
25
|
+
animationPlayers = new Map();
|
|
26
|
+
materialHotReloader;
|
|
27
|
+
lodConfigs = new Map();
|
|
28
|
+
lodGenerator;
|
|
29
|
+
audioSources = new Map();
|
|
30
|
+
audioListeners = new Map();
|
|
31
|
+
cameraFollowEntity = null;
|
|
32
|
+
constructor(opts = {}) {
|
|
33
|
+
const ecsWorld = new WorldClass();
|
|
34
|
+
this.ecsWorld = ecsWorld;
|
|
35
|
+
this.scene = new SceneClass(opts.sceneName ?? "main", ecsWorld);
|
|
36
|
+
this.world = new GameWorldClass(this.scene);
|
|
37
|
+
this.camera = new CameraClass();
|
|
38
|
+
this.hierarchy = this.world.hierarchy;
|
|
39
|
+
this.assetManager = new AssetManagerClass();
|
|
40
|
+
this.materialLibrary = new MaterialLibraryClass();
|
|
41
|
+
this.checkpointManager = new CheckpointManagerClass();
|
|
42
|
+
this.telemetryCollector = new TelemetryCollectorClass(opts.enableTelemetry ?? true);
|
|
43
|
+
this.telemetryReporter = new TelemetryReporterClass(this.telemetryCollector);
|
|
44
|
+
this.debugDraw = new DebugDrawQueueClass();
|
|
45
|
+
this.scriptingSystem = new ScriptingSystemClass(ecsWorld);
|
|
46
|
+
this.saveSystem = new SaveSystemClass();
|
|
47
|
+
this.materialHotReloader = new MaterialHotReloaderClass();
|
|
48
|
+
this.lodGenerator = new LODGeneratorClass();
|
|
49
|
+
}
|
|
50
|
+
static fromGame(opts) {
|
|
51
|
+
const ctx = new EngineContext({
|
|
52
|
+
sceneName: opts.scene.name,
|
|
53
|
+
enableTelemetry: opts.enableTelemetry,
|
|
54
|
+
});
|
|
55
|
+
ctx.ecsWorld = opts.ecsWorld;
|
|
56
|
+
ctx.scene = opts.scene;
|
|
57
|
+
ctx.world = opts.gameWorld;
|
|
58
|
+
ctx.camera = opts.camera;
|
|
59
|
+
ctx.hierarchy = opts.gameWorld.hierarchy;
|
|
60
|
+
return ctx;
|
|
61
|
+
}
|
|
62
|
+
getEntityKey(e) {
|
|
63
|
+
return `${e.index}.${e.generation}`;
|
|
64
|
+
}
|
|
65
|
+
parseEntityKey(key) {
|
|
66
|
+
const parts = key.split(".");
|
|
67
|
+
if (parts.length !== 2)
|
|
68
|
+
return null;
|
|
69
|
+
const index = parseInt(parts[0], 10);
|
|
70
|
+
const generation = parseInt(parts[1], 10);
|
|
71
|
+
if (isNaN(index) || isNaN(generation))
|
|
72
|
+
return null;
|
|
73
|
+
return { index, generation };
|
|
74
|
+
}
|
|
75
|
+
isEntityAlive(e) {
|
|
76
|
+
return isAlive(this.ecsWorld.entities, e);
|
|
77
|
+
}
|
|
78
|
+
getAllAliveEntities() {
|
|
79
|
+
const result = [];
|
|
80
|
+
for (let i = 0; i < this.ecsWorld.entities.length; i++) {
|
|
81
|
+
const meta = this.ecsWorld.entities[i];
|
|
82
|
+
if (meta.alive) {
|
|
83
|
+
result.push({ index: i, generation: meta.generation });
|
|
84
|
+
}
|
|
85
|
+
}
|
|
86
|
+
return result;
|
|
87
|
+
}
|
|
88
|
+
getComponentNameById(id) {
|
|
89
|
+
return getComponentName(id);
|
|
90
|
+
}
|
|
91
|
+
getComponentIdByName(name) {
|
|
92
|
+
return getComponentId(name);
|
|
93
|
+
}
|
|
94
|
+
step(dt) {
|
|
95
|
+
this.world.step(dt);
|
|
96
|
+
this.telemetryCollector.recordFrame(dt * 1000);
|
|
97
|
+
}
|
|
98
|
+
}
|
|
99
|
+
export { AudioListener, AudioSource, BlendMode, createAudioListener, createAudioSource, createDirLight as createDirectionalLight, createPtLight as createPointLight, CullMode, entityEqual, LightTypeEnum as LightType, LODGeneratorClass as LODGenerator, MaterialClass as Material, MaterialHotReloaderClass as MaterialHotReloader, MeshBuilderClass as MeshBuilder, ROOT_ENTITY };
|
|
@@ -0,0 +1,423 @@
|
|
|
1
|
+
// ============================================================================
|
|
2
|
+
// MCP HTTP Transport — HTTP server that bridges JSON-RPC requests to MCPServer
|
|
3
|
+
// Supports direct mode (has MCPServer instance) or proxy mode (forwards via callback)
|
|
4
|
+
// ============================================================================
|
|
5
|
+
import { randomBytes } from "node:crypto";
|
|
6
|
+
import { createReadStream } from "node:fs";
|
|
7
|
+
import { stat as statFile } from "node:fs/promises";
|
|
8
|
+
import { createServer } from "node:http";
|
|
9
|
+
import { sep as pathSep, resolve as resolvePath } from "node:path";
|
|
10
|
+
/** Loopback hostnames accepted in Host/Origin headers. Everything else is
|
|
11
|
+
* rejected — the endpoint binds 127.0.0.1 and is meant for local tools only. */
|
|
12
|
+
const LOOPBACK_HOST_RE = /^(localhost|127\.0\.0\.1|\[::1\])(:\d+)?$/;
|
|
13
|
+
export class McpHttpTransport {
|
|
14
|
+
server = null;
|
|
15
|
+
port;
|
|
16
|
+
/** Actual bound port (set after start()). Equals `port` when explicitly
|
|
17
|
+
* configured; differs when `port` was 0 (ephemeral OS-assigned port). */
|
|
18
|
+
boundPort = null;
|
|
19
|
+
mode;
|
|
20
|
+
mcpServer;
|
|
21
|
+
proxyHandler;
|
|
22
|
+
initialized = false;
|
|
23
|
+
sessionId = null;
|
|
24
|
+
sseResponse = null;
|
|
25
|
+
/** Optional root directory for the GET /mcp/artifact/<path> download endpoint. */
|
|
26
|
+
artifactDir = null;
|
|
27
|
+
/** Bearer token for optional authentication. Always generated so it can be
|
|
28
|
+
* advertised to trusted local clients (e.g. via the PID `.token` file). */
|
|
29
|
+
authToken;
|
|
30
|
+
/** When true, every request (except /mcp/health) must carry the token.
|
|
31
|
+
* Default false — Origin+Host checks already block browser clients, and
|
|
32
|
+
* external stdio bridges that only read the PID port file don't yet send
|
|
33
|
+
* a token. Enable via config `mcp.requireAuth` or `MCP_AUTH=1`. */
|
|
34
|
+
requireAuth;
|
|
35
|
+
constructor(opts) {
|
|
36
|
+
this.port = opts.port ?? 0;
|
|
37
|
+
if (opts.mcpServer) {
|
|
38
|
+
this.mode = "direct";
|
|
39
|
+
this.mcpServer = opts.mcpServer;
|
|
40
|
+
this.proxyHandler = null;
|
|
41
|
+
}
|
|
42
|
+
else if (opts.proxyHandler) {
|
|
43
|
+
this.mode = "proxy";
|
|
44
|
+
this.mcpServer = null;
|
|
45
|
+
this.proxyHandler = opts.proxyHandler;
|
|
46
|
+
}
|
|
47
|
+
else {
|
|
48
|
+
throw new Error("McpHttpTransport requires either mcpServer or proxyHandler");
|
|
49
|
+
}
|
|
50
|
+
this.artifactDir = opts.artifactDir ?? null;
|
|
51
|
+
this.authToken = opts.authToken ?? randomBytes(24).toString("hex");
|
|
52
|
+
this.requireAuth =
|
|
53
|
+
opts.requireAuth ??
|
|
54
|
+
(typeof process !== "undefined" && process.env?.MCP_AUTH === "1");
|
|
55
|
+
}
|
|
56
|
+
start() {
|
|
57
|
+
return new Promise((resolve, reject) => {
|
|
58
|
+
this.server = createServer((req, res) => this.handleRequest(req, res));
|
|
59
|
+
this.server.on("error", (err) => {
|
|
60
|
+
this.server = null;
|
|
61
|
+
reject(err);
|
|
62
|
+
});
|
|
63
|
+
// Bind to loopback only — the MCP transport is for local clients
|
|
64
|
+
// (Devin's stdio bridge, the e2e harness). Binding 0.0.0.0 would
|
|
65
|
+
// expose the JSON-RPC endpoint to the local network.
|
|
66
|
+
this.server.listen(this.port, "127.0.0.1", () => {
|
|
67
|
+
const addr = this.server.address();
|
|
68
|
+
this.boundPort = addr && typeof addr === "object" ? addr.port : this.port;
|
|
69
|
+
resolve();
|
|
70
|
+
});
|
|
71
|
+
});
|
|
72
|
+
}
|
|
73
|
+
async stop() {
|
|
74
|
+
return new Promise((resolve) => {
|
|
75
|
+
if (this.server) {
|
|
76
|
+
this.server.close(() => resolve());
|
|
77
|
+
this.server = null;
|
|
78
|
+
}
|
|
79
|
+
else {
|
|
80
|
+
resolve();
|
|
81
|
+
}
|
|
82
|
+
});
|
|
83
|
+
}
|
|
84
|
+
/**
|
|
85
|
+
* The actual bound port. After `start()` this is the OS-assigned port
|
|
86
|
+
* when `port` was 0 (ephemeral); before `start()` (or after `stop()`)
|
|
87
|
+
* it falls back to the configured `port`.
|
|
88
|
+
*/
|
|
89
|
+
getPort() {
|
|
90
|
+
return this.boundPort ?? this.port;
|
|
91
|
+
}
|
|
92
|
+
/** The bearer token required when `requireAuth` is enabled. Written to the
|
|
93
|
+
* PID `.token` file so trusted local clients can discover it. */
|
|
94
|
+
getAuthToken() {
|
|
95
|
+
return this.authToken;
|
|
96
|
+
}
|
|
97
|
+
/**
|
|
98
|
+
* Local-client gate. The endpoint binds 127.0.0.1 but browsers treat
|
|
99
|
+
* loopback as trustworthy — without these checks any webpage could drive
|
|
100
|
+
* the JSON-RPC surface (which includes code-eval and heap-snapshot tools):
|
|
101
|
+
*
|
|
102
|
+
* - `Host` must be loopback → defeats DNS-rebinding to 127.0.0.1.
|
|
103
|
+
* - `Origin`, when present (browsers always send it on POST), must be
|
|
104
|
+
* loopback → defeats fetch() from arbitrary web pages. Node fetch and
|
|
105
|
+
* curl send no Origin, so CLI clients are unaffected.
|
|
106
|
+
* - `requireAuth` additionally demands the bearer token.
|
|
107
|
+
*
|
|
108
|
+
* No CORS headers are ever emitted, so even if an Origin check regressed,
|
|
109
|
+
* browser JS could not read responses.
|
|
110
|
+
*/
|
|
111
|
+
checkLocalClient(req, res) {
|
|
112
|
+
const host = req.headers.host ?? "";
|
|
113
|
+
if (!LOOPBACK_HOST_RE.test(host)) {
|
|
114
|
+
this.sendJSON(res, 403, { error: "Forbidden: non-loopback Host" });
|
|
115
|
+
return false;
|
|
116
|
+
}
|
|
117
|
+
const origin = req.headers.origin;
|
|
118
|
+
if (origin !== undefined) {
|
|
119
|
+
let originHost = "";
|
|
120
|
+
try {
|
|
121
|
+
originHost = new URL(origin).host;
|
|
122
|
+
}
|
|
123
|
+
catch {
|
|
124
|
+
/* invalid origin → reject below */
|
|
125
|
+
}
|
|
126
|
+
if (!LOOPBACK_HOST_RE.test(originHost)) {
|
|
127
|
+
this.sendJSON(res, 403, { error: "Forbidden: non-loopback Origin" });
|
|
128
|
+
return false;
|
|
129
|
+
}
|
|
130
|
+
}
|
|
131
|
+
if (this.requireAuth) {
|
|
132
|
+
const bearer = /^Bearer (.+)$/.exec(req.headers.authorization ?? "")?.[1];
|
|
133
|
+
const token = req.headers["x-downdraft-token"] ?? bearer;
|
|
134
|
+
if (token !== this.authToken) {
|
|
135
|
+
this.sendJSON(res, 401, { error: "Unauthorized" });
|
|
136
|
+
return false;
|
|
137
|
+
}
|
|
138
|
+
}
|
|
139
|
+
return true;
|
|
140
|
+
}
|
|
141
|
+
sendJSON(res, status, data) {
|
|
142
|
+
res.writeHead(status, { "Content-Type": "application/json" });
|
|
143
|
+
res.end(JSON.stringify(data));
|
|
144
|
+
}
|
|
145
|
+
/**
|
|
146
|
+
* Stream a file from the artifact directory. Supports HTTP Range requests
|
|
147
|
+
* for large trace files. Rejects paths that escape artifactDir.
|
|
148
|
+
*/
|
|
149
|
+
async handleArtifactDownload(req, res) {
|
|
150
|
+
if (!this.artifactDir) {
|
|
151
|
+
this.sendJSON(res, 503, { error: "Artifact download not configured (no artifactDir)" });
|
|
152
|
+
return;
|
|
153
|
+
}
|
|
154
|
+
// Decode the relative path from the URL (after /mcp/artifact/).
|
|
155
|
+
const prefix = "/mcp/artifact/";
|
|
156
|
+
const rawRel = decodeURIComponent(req.url.slice(prefix.length));
|
|
157
|
+
// Strip any query string.
|
|
158
|
+
const relPath = rawRel.split("?")[0];
|
|
159
|
+
// Resolve against artifactDir and verify the result stays inside it.
|
|
160
|
+
const resolved = resolvePath(this.artifactDir, relPath);
|
|
161
|
+
const root = resolvePath(this.artifactDir) + pathSep;
|
|
162
|
+
if (!resolved.startsWith(root)) {
|
|
163
|
+
this.sendJSON(res, 403, { error: "Path traversal rejected" });
|
|
164
|
+
return;
|
|
165
|
+
}
|
|
166
|
+
let fileSize;
|
|
167
|
+
try {
|
|
168
|
+
const s = await statFile(resolved);
|
|
169
|
+
if (!s.isFile()) {
|
|
170
|
+
this.sendJSON(res, 404, { error: "Not a file" });
|
|
171
|
+
return;
|
|
172
|
+
}
|
|
173
|
+
fileSize = s.size;
|
|
174
|
+
}
|
|
175
|
+
catch {
|
|
176
|
+
this.sendJSON(res, 404, { error: "File not found" });
|
|
177
|
+
return;
|
|
178
|
+
}
|
|
179
|
+
// Content-Type by extension.
|
|
180
|
+
const lower = resolved.toLowerCase();
|
|
181
|
+
let contentType = "application/octet-stream";
|
|
182
|
+
if (lower.endsWith(".json"))
|
|
183
|
+
contentType = "application/json";
|
|
184
|
+
else if (lower.endsWith(".heapsnapshot"))
|
|
185
|
+
contentType = "application/octet-stream";
|
|
186
|
+
// Range support.
|
|
187
|
+
const rangeHeader = req.headers.range;
|
|
188
|
+
if (rangeHeader) {
|
|
189
|
+
const match = /^bytes=(\d+)-(\d*)$/.exec(rangeHeader);
|
|
190
|
+
if (match) {
|
|
191
|
+
const start = parseInt(match[1], 10);
|
|
192
|
+
const end = match[2] ? parseInt(match[2], 10) : fileSize - 1;
|
|
193
|
+
if (start >= fileSize || end >= fileSize || start > end) {
|
|
194
|
+
res.writeHead(416, {
|
|
195
|
+
"Content-Range": `bytes */${fileSize}`,
|
|
196
|
+
"Content-Type": contentType,
|
|
197
|
+
});
|
|
198
|
+
res.end();
|
|
199
|
+
return;
|
|
200
|
+
}
|
|
201
|
+
res.writeHead(206, {
|
|
202
|
+
"Content-Type": contentType,
|
|
203
|
+
"Content-Range": `bytes ${start}-${end}/${fileSize}`,
|
|
204
|
+
"Content-Length": end - start + 1,
|
|
205
|
+
"Accept-Ranges": "bytes",
|
|
206
|
+
});
|
|
207
|
+
createReadStream(resolved, { start, end }).pipe(res);
|
|
208
|
+
return;
|
|
209
|
+
}
|
|
210
|
+
}
|
|
211
|
+
res.writeHead(200, {
|
|
212
|
+
"Content-Type": contentType,
|
|
213
|
+
"Content-Length": fileSize,
|
|
214
|
+
"Accept-Ranges": "bytes",
|
|
215
|
+
});
|
|
216
|
+
createReadStream(resolved).pipe(res);
|
|
217
|
+
}
|
|
218
|
+
async handleRequest(req, res) {
|
|
219
|
+
if (req.method === "OPTIONS") {
|
|
220
|
+
// No CORS headers — preflight gets a bare 204 and browser fetches fail.
|
|
221
|
+
res.writeHead(204);
|
|
222
|
+
res.end();
|
|
223
|
+
return;
|
|
224
|
+
}
|
|
225
|
+
// GET /mcp/health — readiness probe for the e2e harness; intentionally
|
|
226
|
+
// exempt from the local-client gate (it leaks only port/mode booleans).
|
|
227
|
+
// Everything else requires a loopback Host/Origin (+ token if enabled).
|
|
228
|
+
if (req.method === "GET" && req.url === "/mcp/health") {
|
|
229
|
+
this.sendJSON(res, 200, {
|
|
230
|
+
status: "ok",
|
|
231
|
+
mode: this.mode,
|
|
232
|
+
port: this.getPort(),
|
|
233
|
+
initialized: this.initialized,
|
|
234
|
+
});
|
|
235
|
+
return;
|
|
236
|
+
}
|
|
237
|
+
if (!this.checkLocalClient(req, res))
|
|
238
|
+
return;
|
|
239
|
+
// GET /mcp/artifact/<path> — stream a generated trace/heap-snapshot file.
|
|
240
|
+
// <path> is relative to the configured artifactDir. Path traversal is
|
|
241
|
+
// rejected: the resolved path must start with artifactDir + sep.
|
|
242
|
+
if (req.method === "GET" && req.url?.startsWith("/mcp/artifact/")) {
|
|
243
|
+
await this.handleArtifactDownload(req, res);
|
|
244
|
+
return;
|
|
245
|
+
}
|
|
246
|
+
// GET /mcp/tools
|
|
247
|
+
if (req.method === "GET" && req.url === "/mcp/tools") {
|
|
248
|
+
try {
|
|
249
|
+
const tools = await this.handleJsonRpc("tools/list", {});
|
|
250
|
+
this.sendJSON(res, 200, tools);
|
|
251
|
+
}
|
|
252
|
+
catch (e) {
|
|
253
|
+
this.sendJSON(res, 500, { error: e.message });
|
|
254
|
+
}
|
|
255
|
+
return;
|
|
256
|
+
}
|
|
257
|
+
// GET /mcp or / — SSE stream (MCP HTTP+SSE transport)
|
|
258
|
+
// The client opens an SSE connection; we send an `endpoint` event
|
|
259
|
+
// telling it to POST JSON-RPC messages back to /mcp.
|
|
260
|
+
if (req.method === "GET" && (req.url === "/mcp" || req.url === "/" || req.url === "/mcp/")) {
|
|
261
|
+
if (!this.sessionId)
|
|
262
|
+
this.sessionId = `mcp-${Date.now()}-${Math.random().toString(36).slice(2)}`;
|
|
263
|
+
res.writeHead(200, {
|
|
264
|
+
"Content-Type": "text/event-stream",
|
|
265
|
+
"Cache-Control": "no-cache",
|
|
266
|
+
"Connection": "keep-alive",
|
|
267
|
+
"Mcp-Session-Id": this.sessionId,
|
|
268
|
+
});
|
|
269
|
+
// Tell the client where to POST requests
|
|
270
|
+
res.write(`event: endpoint\ndata: /mcp\n\n`);
|
|
271
|
+
// Keep the connection open — the client will POST requests separately
|
|
272
|
+
// and we'll stream responses back on this connection.
|
|
273
|
+
// Store the response so we can write to it later.
|
|
274
|
+
this.sseResponse = res;
|
|
275
|
+
req.on("close", () => {
|
|
276
|
+
if (this.sseResponse === res)
|
|
277
|
+
this.sseResponse = null;
|
|
278
|
+
});
|
|
279
|
+
return;
|
|
280
|
+
}
|
|
281
|
+
// POST /mcp or POST / (root) — MCP Streamable HTTP transport
|
|
282
|
+
// The MCP client POSTs JSON-RPC messages to the configured URL.
|
|
283
|
+
// We accept both /mcp and / so the URL can be either
|
|
284
|
+
// "http://localhost:PORT" or "http://localhost:PORT/mcp".
|
|
285
|
+
if (req.method === "POST" && (req.url === "/mcp" || req.url === "/" || req.url === "/mcp/")) {
|
|
286
|
+
// MCP Streamable HTTP: return session ID header on initialize
|
|
287
|
+
if (!this.sessionId)
|
|
288
|
+
this.sessionId = `mcp-${Date.now()}-${Math.random().toString(36).slice(2)}`;
|
|
289
|
+
res.setHeader("Mcp-Session-Id", this.sessionId);
|
|
290
|
+
let body = "";
|
|
291
|
+
req.on("data", (chunk) => { body += chunk; });
|
|
292
|
+
req.on("end", async () => {
|
|
293
|
+
let msg;
|
|
294
|
+
try {
|
|
295
|
+
msg = JSON.parse(body);
|
|
296
|
+
}
|
|
297
|
+
catch (e) {
|
|
298
|
+
this.sendJSON(res, 400, {
|
|
299
|
+
jsonrpc: "2.0",
|
|
300
|
+
id: 0,
|
|
301
|
+
error: { code: -32700, message: `Parse error: ${e.message}` },
|
|
302
|
+
});
|
|
303
|
+
return;
|
|
304
|
+
}
|
|
305
|
+
try {
|
|
306
|
+
const result = await this.handleJsonRpc(msg.method, msg.params ?? {});
|
|
307
|
+
const response = { jsonrpc: "2.0", id: msg.id ?? 0, result };
|
|
308
|
+
// If there's an open SSE stream (HTTP+SSE transport), write the
|
|
309
|
+
// response to it and respond to the POST with 202 Accepted.
|
|
310
|
+
// Check writableEnded to avoid writing to a closed stream.
|
|
311
|
+
if (this.sseResponse && !this.sseResponse.writableEnded && !this.sseResponse.destroyed) {
|
|
312
|
+
this.sseResponse.write(`event: message\ndata: ${JSON.stringify(response)}\n\n`);
|
|
313
|
+
res.writeHead(202);
|
|
314
|
+
res.end();
|
|
315
|
+
return;
|
|
316
|
+
}
|
|
317
|
+
// Streamable HTTP: check Accept header for SSE format
|
|
318
|
+
const accept = req.headers.accept ?? "";
|
|
319
|
+
if (accept.includes("text/event-stream")) {
|
|
320
|
+
res.writeHead(200, {
|
|
321
|
+
"Content-Type": "text/event-stream",
|
|
322
|
+
"Cache-Control": "no-cache",
|
|
323
|
+
"Connection": "keep-alive",
|
|
324
|
+
});
|
|
325
|
+
res.write(`event: message\ndata: ${JSON.stringify(response)}\n\n`);
|
|
326
|
+
res.end();
|
|
327
|
+
}
|
|
328
|
+
else {
|
|
329
|
+
this.sendJSON(res, 200, response);
|
|
330
|
+
}
|
|
331
|
+
}
|
|
332
|
+
catch (e) {
|
|
333
|
+
// Method/handler failure — return a JSON-RPC error (not HTTP 400)
|
|
334
|
+
// so clients see the real tool error instead of a transport error.
|
|
335
|
+
this.sendJSON(res, 200, {
|
|
336
|
+
jsonrpc: "2.0",
|
|
337
|
+
id: msg.id ?? 0,
|
|
338
|
+
error: { code: -32603, message: e.message },
|
|
339
|
+
});
|
|
340
|
+
}
|
|
341
|
+
});
|
|
342
|
+
return;
|
|
343
|
+
}
|
|
344
|
+
// DELETE /mcp or / — end session (MCP Streamable HTTP)
|
|
345
|
+
if (req.method === "DELETE" && (req.url === "/mcp" || req.url === "/" || req.url === "/mcp/")) {
|
|
346
|
+
this.initialized = false;
|
|
347
|
+
this.sessionId = null;
|
|
348
|
+
res.writeHead(204);
|
|
349
|
+
res.end();
|
|
350
|
+
return;
|
|
351
|
+
}
|
|
352
|
+
this.sendJSON(res, 404, { error: "Not found" });
|
|
353
|
+
}
|
|
354
|
+
async handleJsonRpc(method, params) {
|
|
355
|
+
if (method === "initialize") {
|
|
356
|
+
this.initialized = true;
|
|
357
|
+
return {
|
|
358
|
+
protocolVersion: "2024-11-05",
|
|
359
|
+
capabilities: { tools: {}, resources: {}, prompts: {} },
|
|
360
|
+
serverInfo: { name: "downdraft-mcp", version: "0.1.0" },
|
|
361
|
+
};
|
|
362
|
+
}
|
|
363
|
+
if (!this.initialized) {
|
|
364
|
+
throw new Error("Server not initialized");
|
|
365
|
+
}
|
|
366
|
+
if (this.mode === "direct" && this.mcpServer) {
|
|
367
|
+
return this.handleDirect(method, params);
|
|
368
|
+
}
|
|
369
|
+
else if (this.mode === "proxy" && this.proxyHandler) {
|
|
370
|
+
return this.proxyHandler({ method, params });
|
|
371
|
+
}
|
|
372
|
+
throw new Error("No handler available");
|
|
373
|
+
}
|
|
374
|
+
async handleDirect(method, params) {
|
|
375
|
+
const server = this.mcpServer;
|
|
376
|
+
switch (method) {
|
|
377
|
+
case "tools/list":
|
|
378
|
+
return {
|
|
379
|
+
tools: server.listTools().map((t) => ({
|
|
380
|
+
name: t.name,
|
|
381
|
+
description: t.description,
|
|
382
|
+
inputSchema: t.inputSchema,
|
|
383
|
+
})),
|
|
384
|
+
};
|
|
385
|
+
case "tools/call": {
|
|
386
|
+
const name = params.name;
|
|
387
|
+
const args = params.arguments ?? {};
|
|
388
|
+
return await server.callTool(name, args);
|
|
389
|
+
}
|
|
390
|
+
case "resources/list":
|
|
391
|
+
return {
|
|
392
|
+
resources: server.listResources().map((r) => ({
|
|
393
|
+
uri: r.uri,
|
|
394
|
+
name: r.name,
|
|
395
|
+
description: r.description,
|
|
396
|
+
mimeType: r.mimeType,
|
|
397
|
+
})),
|
|
398
|
+
};
|
|
399
|
+
case "resources/read": {
|
|
400
|
+
const uri = params.uri;
|
|
401
|
+
return await server.readResource(uri);
|
|
402
|
+
}
|
|
403
|
+
case "prompts/list":
|
|
404
|
+
return {
|
|
405
|
+
prompts: server.listPrompts().map((p) => ({
|
|
406
|
+
name: p.name,
|
|
407
|
+
description: p.description,
|
|
408
|
+
arguments: p.arguments,
|
|
409
|
+
})),
|
|
410
|
+
};
|
|
411
|
+
case "prompts/get": {
|
|
412
|
+
const name = params.name;
|
|
413
|
+
const args = params.arguments ?? {};
|
|
414
|
+
return await server.getPrompt(name, args);
|
|
415
|
+
}
|
|
416
|
+
case "shutdown":
|
|
417
|
+
this.initialized = false;
|
|
418
|
+
return {};
|
|
419
|
+
default:
|
|
420
|
+
throw new Error(`Method not found: ${method}`);
|
|
421
|
+
}
|
|
422
|
+
}
|
|
423
|
+
}
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
export { discoverGameInstance, findFreePort, GameClient, launchGame, listGameInstances, McpClientError, mcpPortDir } from "./client.js";
|
|
2
|
+
export { EngineContext } from "./engine-context.js";
|
|
3
|
+
export { MCPServer } from "./server.js";
|
|
4
|
+
export { errorResult, jsonResult, textResult } from "./types.js";
|
|
5
|
+
export { UndoRedoManager } from "./undo-redo.js";
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
export function createAddEntityPrompt() {
|
|
2
|
+
return [
|
|
3
|
+
{
|
|
4
|
+
def: {
|
|
5
|
+
name: "add-entity",
|
|
6
|
+
description: "Template for adding a new entity to the current scene",
|
|
7
|
+
arguments: [
|
|
8
|
+
{ name: "entityType", description: "Type of entity (cube, sphere, plane, custom)", required: true },
|
|
9
|
+
{ name: "position", description: "Position as 'x,y,z'" },
|
|
10
|
+
{ name: "material", description: "Material type (pbr, unlit, etc.)" },
|
|
11
|
+
],
|
|
12
|
+
},
|
|
13
|
+
handler: (args) => {
|
|
14
|
+
const entityType = args.entityType ?? "cube";
|
|
15
|
+
const position = args.position ?? "0,0,0";
|
|
16
|
+
const material = args.material ?? "pbr";
|
|
17
|
+
return {
|
|
18
|
+
messages: [
|
|
19
|
+
{
|
|
20
|
+
role: "user",
|
|
21
|
+
content: {
|
|
22
|
+
type: "text",
|
|
23
|
+
text: `Add a ${entityType} entity to the scene at position (${position}) with a ${material} material.
|
|
24
|
+
|
|
25
|
+
Steps:
|
|
26
|
+
1. Generate a procedural ${entityType} mesh (generate_procedural_mesh)
|
|
27
|
+
2. Spawn an entity with a Transform component at position (${position}) (spawn_entity)
|
|
28
|
+
3. Assign the mesh to the entity (assign_mesh)
|
|
29
|
+
4. Create a ${material} material (create_material)
|
|
30
|
+
5. Assign the material to the entity (assign_material)
|
|
31
|
+
6. Verify with get_entity_state`,
|
|
32
|
+
},
|
|
33
|
+
},
|
|
34
|
+
],
|
|
35
|
+
};
|
|
36
|
+
},
|
|
37
|
+
},
|
|
38
|
+
];
|
|
39
|
+
}
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
export function createCreateScenePrompt() {
|
|
2
|
+
return [
|
|
3
|
+
{
|
|
4
|
+
def: {
|
|
5
|
+
name: "create-scene",
|
|
6
|
+
description: "Template for creating a new scene with entities, lighting, and camera",
|
|
7
|
+
arguments: [
|
|
8
|
+
{ name: "sceneName", description: "Name of the scene to create", required: true },
|
|
9
|
+
{ name: "description", description: "Description of what the scene should contain" },
|
|
10
|
+
],
|
|
11
|
+
},
|
|
12
|
+
handler: (args) => {
|
|
13
|
+
const sceneName = args.sceneName ?? "my-scene";
|
|
14
|
+
const description = args.description ?? "a basic scene with lighting";
|
|
15
|
+
return {
|
|
16
|
+
messages: [
|
|
17
|
+
{
|
|
18
|
+
role: "user",
|
|
19
|
+
content: {
|
|
20
|
+
type: "text",
|
|
21
|
+
text: `Create a scene called "${sceneName}" that contains ${description}.
|
|
22
|
+
|
|
23
|
+
Steps:
|
|
24
|
+
1. Use create_scene to create a new scene named "${sceneName}"
|
|
25
|
+
2. Generate procedural meshes as needed (generate_procedural_mesh)
|
|
26
|
+
3. Spawn entities with Transform components (spawn_entity)
|
|
27
|
+
4. Assign meshes to entities (assign_mesh)
|
|
28
|
+
5. Create and assign materials (create_material, assign_material)
|
|
29
|
+
6. Add lighting (add_light or set_sun_angle)
|
|
30
|
+
7. Position the camera to frame the scene (set_camera)
|
|
31
|
+
8. Create a checkpoint (create_checkpoint)
|
|
32
|
+
|
|
33
|
+
Use the available MCP tools to accomplish each step.`,
|
|
34
|
+
},
|
|
35
|
+
},
|
|
36
|
+
],
|
|
37
|
+
};
|
|
38
|
+
},
|
|
39
|
+
},
|
|
40
|
+
];
|
|
41
|
+
}
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
export function createDebugFramePrompt() {
|
|
2
|
+
return [
|
|
3
|
+
{
|
|
4
|
+
def: {
|
|
5
|
+
name: "debug-frame",
|
|
6
|
+
description: "Template for debugging why a frame is slow or rendering incorrectly",
|
|
7
|
+
arguments: [
|
|
8
|
+
{ name: "symptom", description: "What's wrong (slow, black screen, flickering, etc.)", required: true },
|
|
9
|
+
],
|
|
10
|
+
},
|
|
11
|
+
handler: (args) => {
|
|
12
|
+
const symptom = args.symptom ?? "the frame is slow";
|
|
13
|
+
return {
|
|
14
|
+
messages: [
|
|
15
|
+
{
|
|
16
|
+
role: "user",
|
|
17
|
+
content: {
|
|
18
|
+
type: "text",
|
|
19
|
+
text: `Debug why ${symptom}.
|
|
20
|
+
|
|
21
|
+
Steps:
|
|
22
|
+
1. Use profile_frame to get per-system timings and frame time
|
|
23
|
+
2. Use get_performance_history to see frame time trends
|
|
24
|
+
3. Use get_telemetry to check GC pauses, memory, and CPU per thread
|
|
25
|
+
4. Use get_scene_tree to verify entity count is expected
|
|
26
|
+
5. Use inspect_gpu to check buffer sizes and texture memory
|
|
27
|
+
6. If a specific system is slow, use inspect_object to examine related entities
|
|
28
|
+
7. Suggest optimizations based on findings`,
|
|
29
|
+
},
|
|
30
|
+
},
|
|
31
|
+
],
|
|
32
|
+
};
|
|
33
|
+
},
|
|
34
|
+
},
|
|
35
|
+
];
|
|
36
|
+
}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import { createCreateScenePrompt } from "./create-scene.js";
|
|
2
|
+
import { createAddEntityPrompt } from "./add-entity.js";
|
|
3
|
+
import { createDebugFramePrompt } from "./debug-frame.js";
|
|
4
|
+
export function createPrompts() {
|
|
5
|
+
return [
|
|
6
|
+
...createCreateScenePrompt(),
|
|
7
|
+
...createAddEntityPrompt(),
|
|
8
|
+
...createDebugFramePrompt(),
|
|
9
|
+
];
|
|
10
|
+
}
|