@downdraft/engine 0.0.0 → 0.1.0
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/src/index.ts +10 -0
- package/app/src/renderer/bootstrap.ts +271 -0
- package/app/src/renderer/downdraft-base.css +93 -0
- package/app/src/renderer/feature-log.ts +200 -0
- package/app/src/renderer/game-module.ts +923 -0
- package/app/src/renderer/hooks.ts +88 -0
- package/app/src/renderer/hot-reload.ts +178 -0
- package/app/src/renderer/import-cache.ts +88 -0
- package/app/src/renderer/index.ts +206 -0
- package/app/src/renderer/mcp-harness.ts +144 -0
- package/app/src/renderer/save-store-factory.ts +239 -0
- package/app/src/renderer/sim-bridge.ts +183 -0
- package/app/src/renderer/standard-automation-tools.ts +771 -0
- package/app/src/shared/feature-log.ts +71 -0
- package/app/src/shared/gpu-info.ts +82 -0
- package/app/src/shared/import-cache-store.ts +142 -0
- package/app/src/shared/index.ts +6 -0
- package/app/src/shared/mcp-discovery.ts +47 -0
- package/app/src/shared/mcp-proxy.ts +82 -0
- package/app/src/shared/types.ts +324 -0
- package/asset-bake/src/bake-audio.ts +119 -0
- package/asset-bake/src/bake-gltf.ts +172 -0
- package/asset-bake/src/bake.ts +78 -0
- package/asset-bake/src/cache.ts +188 -0
- package/asset-bake/src/config.ts +186 -0
- package/asset-bake/src/index.ts +36 -0
- package/core/src/animation/animation-event.ts +41 -0
- package/core/src/animation/bone-mask.ts +122 -0
- package/core/src/animation/clip.ts +252 -0
- package/core/src/animation/index.ts +22 -0
- package/core/src/animation/mixamo.ts +113 -0
- package/core/src/animation/morph-target.ts +69 -0
- package/core/src/animation/player.ts +697 -0
- package/core/src/animation/retarget.ts +158 -0
- package/core/src/animation/skeleton-animator.ts +1399 -0
- package/core/src/animation/skeleton.ts +214 -0
- package/core/src/animation/state-machine.ts +280 -0
- package/core/src/assets/blob-store.ts +66 -0
- package/core/src/assets/cache.ts +186 -0
- package/core/src/assets/cubemap-converter.ts +155 -0
- package/core/src/assets/environment-manager.ts +121 -0
- package/core/src/assets/import-cache.ts +65 -0
- package/core/src/assets/import-settings.ts +72 -0
- package/core/src/assets/importer.ts +108 -0
- package/core/src/assets/index.ts +74 -0
- package/core/src/assets/irradiance-generator.ts +198 -0
- package/core/src/assets/loader-audio.ts +86 -0
- package/core/src/assets/loader-cubemap.ts +211 -0
- package/core/src/assets/loader-dds.ts +236 -0
- package/core/src/assets/loader-hdr.ts +474 -0
- package/core/src/assets/loader-mesh.ts +143 -0
- package/core/src/assets/loader-shader.ts +73 -0
- package/core/src/assets/loader-texture.ts +349 -0
- package/core/src/assets/lod.ts +198 -0
- package/core/src/assets/manager.ts +480 -0
- package/core/src/assets/manifest.ts +81 -0
- package/core/src/assets/material-bridge.ts +186 -0
- package/core/src/assets/model-importer.ts +72 -0
- package/core/src/assets/model-normalizer.ts +248 -0
- package/core/src/assets/model-to-gpu.ts +70 -0
- package/core/src/assets/model-to-mesh.ts +237 -0
- package/core/src/assets/prefilter-generator.ts +250 -0
- package/core/src/audio/engine.ts +177 -0
- package/core/src/audio/interface.ts +130 -0
- package/core/src/audio/listener.ts +32 -0
- package/core/src/audio/mixer.ts +141 -0
- package/core/src/audio/registry.ts +52 -0
- package/core/src/audio/sab.ts +87 -0
- package/core/src/audio/source.ts +89 -0
- package/core/src/change-detection/atomics.ts +1 -0
- package/core/src/change-detection/tracker.ts +47 -0
- package/core/src/debug-draw/lines.ts +64 -0
- package/core/src/debug-draw/points.ts +17 -0
- package/core/src/debug-draw/queue.ts +124 -0
- package/core/src/debug-draw/text.ts +25 -0
- package/core/src/ecs/archetype.ts +323 -0
- package/core/src/ecs/component.ts +188 -0
- package/core/src/ecs/entity.ts +25 -0
- package/core/src/ecs/events.ts +93 -0
- package/core/src/ecs/hierarchy.ts +124 -0
- package/core/src/ecs/hmr-swap-registry.ts +22 -0
- package/core/src/ecs/index.ts +25 -0
- package/core/src/ecs/query.ts +141 -0
- package/core/src/ecs/resource.ts +8 -0
- package/core/src/ecs/schedule.ts +181 -0
- package/core/src/ecs/system-params.ts +99 -0
- package/core/src/ecs/system.ts +42 -0
- package/core/src/ecs/world.ts +348 -0
- package/core/src/index.ts +352 -0
- package/core/src/input/context.ts +73 -0
- package/core/src/input/dom-handler.ts +380 -0
- package/core/src/input/local-player-manager.ts +218 -0
- package/core/src/input/mapping.ts +40 -0
- package/core/src/input/multi-sab-bridge.ts +276 -0
- package/core/src/input/multi-state.ts +54 -0
- package/core/src/input/sab-bridge.ts +71 -0
- package/core/src/input/state.ts +132 -0
- package/core/src/input/ui-router.ts +87 -0
- package/core/src/library/host.ts +317 -0
- package/core/src/library/index.ts +16 -0
- package/core/src/library/library.ts +292 -0
- package/core/src/material/compiler.ts +80 -0
- package/core/src/material/graph-bridge.ts +172 -0
- package/core/src/material/index.ts +9 -0
- package/core/src/material/library.ts +442 -0
- package/core/src/material/material.ts +156 -0
- package/core/src/material/variants.ts +61 -0
- package/core/src/math/mat4.ts +202 -0
- package/core/src/math/perlin-noise-2d.ts +77 -0
- package/core/src/math/perlin-noise-3d.ts +110 -0
- package/core/src/math/quat.ts +33 -0
- package/core/src/math/rng.ts +29 -0
- package/core/src/math/trig.ts +47 -0
- package/core/src/math/value-noise.ts +67 -0
- package/core/src/mesh/builder.ts +177 -0
- package/core/src/mesh/csg.ts +312 -0
- package/core/src/mesh/greased-line.ts +145 -0
- package/core/src/mesh/mesh.ts +17 -0
- package/core/src/mesh/parametric.ts +501 -0
- package/core/src/mesh/skinning.ts +67 -0
- package/core/src/mesh/vertex-layout.ts +91 -0
- package/core/src/module/cross-thread.ts +163 -0
- package/core/src/module/diagnostics.ts +123 -0
- package/core/src/module/host.ts +451 -0
- package/core/src/module/index.ts +22 -0
- package/core/src/module/module.ts +109 -0
- package/core/src/module/registry.ts +94 -0
- package/core/src/module/renderer-module.ts +247 -0
- package/core/src/module/ts-loader.ts +26 -0
- package/core/src/particles/compute-pass.ts +378 -0
- package/core/src/particles/emitter.ts +156 -0
- package/core/src/particles/index.ts +11 -0
- package/core/src/particles/particle-data.ts +47 -0
- package/core/src/particles/render-pass.ts +365 -0
- package/core/src/particles/simulator.ts +264 -0
- package/core/src/particles/system.ts +193 -0
- package/core/src/physics/body.ts +59 -0
- package/core/src/physics/ccd-heuristic.ts +55 -0
- package/core/src/physics/character.ts +282 -0
- package/core/src/physics/collider.ts +55 -0
- package/core/src/physics/collision-system.ts +91 -0
- package/core/src/physics/events.ts +133 -0
- package/core/src/physics/index.ts +34 -0
- package/core/src/physics/interface.ts +473 -0
- package/core/src/physics/interpolation-buffer.ts +192 -0
- package/core/src/physics/lifecycle.ts +87 -0
- package/core/src/physics/load-shedder.ts +164 -0
- package/core/src/physics/physics-accumulator.ts +101 -0
- package/core/src/physics/physics-system.ts +240 -0
- package/core/src/physics/ragdoll-presets.ts +272 -0
- package/core/src/physics/ragdoll-system.ts +220 -0
- package/core/src/physics/ragdoll.ts +182 -0
- package/core/src/physics/raycast.ts +143 -0
- package/core/src/physics/realm-manager.ts +499 -0
- package/core/src/physics/realm-worker-pool.ts +191 -0
- package/core/src/physics/realm-worker.ts +102 -0
- package/core/src/physics/realm.ts +189 -0
- package/core/src/physics/registry.ts +52 -0
- package/core/src/physics/safety.ts +247 -0
- package/core/src/physics/snapshot-manager.ts +141 -0
- package/core/src/physics/worker-protocol.ts +30 -0
- package/core/src/platform/bun-preload.ts +169 -0
- package/core/src/platform/css-stub.ts +4 -0
- package/core/src/platform/glob-polyfill.ts +124 -0
- package/core/src/platform/hidpi.ts +57 -0
- package/core/src/platform/render-surface.ts +77 -0
- package/core/src/platform/rpc.ts +98 -0
- package/core/src/platform/runtime.ts +123 -0
- package/core/src/plugin/context.ts +364 -0
- package/core/src/plugin/diagnostics.ts +61 -0
- package/core/src/plugin/discovery.ts +186 -0
- package/core/src/plugin/extension-loaders.ts +172 -0
- package/core/src/plugin/host.ts +659 -0
- package/core/src/plugin/index.ts +106 -0
- package/core/src/plugin/loader-asset.ts +124 -0
- package/core/src/plugin/loader-quickjs.ts +84 -0
- package/core/src/plugin/loader-wasm.ts +411 -0
- package/core/src/plugin/loader-worker.ts +261 -0
- package/core/src/plugin/manifest.ts +653 -0
- package/core/src/plugin/material-registry.ts +65 -0
- package/core/src/plugin/mcp-tools.ts +165 -0
- package/core/src/plugin/permissions.ts +175 -0
- package/core/src/plugin/quickjs-bridge.ts +294 -0
- package/core/src/plugin/registry.ts +107 -0
- package/core/src/plugin/sandbox-shim.ts +86 -0
- package/core/src/plugin/sandbox-worker.ts +215 -0
- package/core/src/plugin/wasm-abi.ts +152 -0
- package/core/src/plugin/wasm-worker.ts +229 -0
- package/core/src/plugin/workshop.ts +169 -0
- package/core/src/profiling/event-loop.ts +180 -0
- package/core/src/profiling/index.ts +69 -0
- package/core/src/profiling/iops/idb-patch.ts +242 -0
- package/core/src/profiling/iops/opfs-patch.ts +276 -0
- package/core/src/profiling/profiling-sab.ts +839 -0
- package/core/src/profiling/task-latency.ts +134 -0
- package/core/src/profiling/thread-metrics.ts +126 -0
- package/core/src/profiling/trace-event-writer.ts +205 -0
- package/core/src/profiling/warnings.ts +423 -0
- package/core/src/profiling/worker-prelude.ts +376 -0
- package/core/src/render/bind-group.ts +38 -0
- package/core/src/render/bindless/bindless-struct.ts +42 -0
- package/core/src/render/bindless/bindless.wgsl.ts +167 -0
- package/core/src/render/bindless/frame-bindings.ts +176 -0
- package/core/src/render/bindless/index.ts +10 -0
- package/core/src/render/bindless/material-manager.ts +257 -0
- package/core/src/render/bindless/texture-registry.ts +609 -0
- package/core/src/render/buffer.ts +82 -0
- package/core/src/render/camera-2d.ts +217 -0
- package/core/src/render/camera-controller.ts +440 -0
- package/core/src/render/camera.ts +409 -0
- package/core/src/render/canvas-resize-watcher.ts +46 -0
- package/core/src/render/compute-kernel.ts +172 -0
- package/core/src/render/constants.ts +2 -0
- package/core/src/render/device.ts +111 -0
- package/core/src/render/frame-graph.ts +768 -0
- package/core/src/render/frustum.ts +185 -0
- package/core/src/render/fullscreen-vs.ts +25 -0
- package/core/src/render/g-buffer.ts +186 -0
- package/core/src/render/game-renderer.ts +1452 -0
- package/core/src/render/gpu-driven/cull-pass.ts +394 -0
- package/core/src/render/gpu-driven/hzb.ts +215 -0
- package/core/src/render/gpu-driven/index.ts +7 -0
- package/core/src/render/gpu-driven/indirect-draw-pass.ts +324 -0
- package/core/src/render/gpu-driven/instance-buffer.ts +178 -0
- package/core/src/render/gpu-driven/mesh-table.ts +175 -0
- package/core/src/render/gpu-driven/passes/hzb-build-pass.ts +47 -0
- package/core/src/render/gpu-utils.ts +96 -0
- package/core/src/render/hdr.ts +88 -0
- package/core/src/render/hot-reload.ts +295 -0
- package/core/src/render/ibl-bind-group.ts +266 -0
- package/core/src/render/ibl.ts +180 -0
- package/core/src/render/index.ts +163 -0
- package/core/src/render/input-manager.ts +259 -0
- package/core/src/render/lighting/area-light.ts +196 -0
- package/core/src/render/lighting/cluster-grid.ts +288 -0
- package/core/src/render/lighting/cluster-types.ts +193 -0
- package/core/src/render/lighting/ies-parser.ts +162 -0
- package/core/src/render/lighting.ts +454 -0
- package/core/src/render/material-types/depth.wgsl +44 -0
- package/core/src/render/material-types/line.wgsl +50 -0
- package/core/src/render/material-types/matcap.wgsl +51 -0
- package/core/src/render/material-types/normal.wgsl +41 -0
- package/core/src/render/material-types/physical.wgsl +152 -0
- package/core/src/render/material-types/sprite.wgsl +46 -0
- package/core/src/render/material-types/sss.wgsl +79 -0
- package/core/src/render/material-types/toon.wgsl +79 -0
- package/core/src/render/passes/README.md +121 -0
- package/core/src/render/passes/atmosphere.ts +152 -0
- package/core/src/render/passes/cluster-lighting-pass.ts +476 -0
- package/core/src/render/passes/csm.ts +408 -0
- package/core/src/render/passes/cubemap-capture.ts +114 -0
- package/core/src/render/passes/debug-viz.ts +278 -0
- package/core/src/render/passes/debug.ts +538 -0
- package/core/src/render/passes/decal-mesh.ts +111 -0
- package/core/src/render/passes/decal-pass.ts +377 -0
- package/core/src/render/passes/deferred-lighting.ts +434 -0
- package/core/src/render/passes/depth-prepass.ts +163 -0
- package/core/src/render/passes/dome-360.ts +83 -0
- package/core/src/render/passes/fluid-render.ts +137 -0
- package/core/src/render/passes/gi-types.ts +118 -0
- package/core/src/render/passes/graph-compute.ts +300 -0
- package/core/src/render/passes/greased-line-pass.ts +232 -0
- package/core/src/render/passes/morph-target.ts +40 -0
- package/core/src/render/passes/opaque.ts +1028 -0
- package/core/src/render/passes/point-light-shadow.ts +266 -0
- package/core/src/render/passes/procedural-texture.ts +185 -0
- package/core/src/render/passes/reflection-probe.ts +140 -0
- package/core/src/render/passes/rsm-pass.ts +248 -0
- package/core/src/render/passes/sdf-text.ts +155 -0
- package/core/src/render/passes/shadow-map.ts +163 -0
- package/core/src/render/passes/shadow.ts +220 -0
- package/core/src/render/passes/skinning-vs.ts +121 -0
- package/core/src/render/passes/skinning.ts +326 -0
- package/core/src/render/passes/sky-dome.ts +404 -0
- package/core/src/render/passes/skybox.ts +162 -0
- package/core/src/render/passes/spot-light-shadow.ts +273 -0
- package/core/src/render/passes/terrain.ts +326 -0
- package/core/src/render/passes/transparent.ts +353 -0
- package/core/src/render/passes/underwater-fog.ts +185 -0
- package/core/src/render/passes/video-texture.ts +79 -0
- package/core/src/render/passes/volumetric-pass.ts +312 -0
- package/core/src/render/passes/volumetric-types.ts +171 -0
- package/core/src/render/passes/water.ts +753 -0
- package/core/src/render/pbr.ts +296 -0
- package/core/src/render/pipeline.ts +52 -0
- package/core/src/render/render-pass.ts +30 -0
- package/core/src/render/renderer-input-bus.ts +220 -0
- package/core/src/render/renderer-module-host.ts +623 -0
- package/core/src/render/resource-tracker.ts +67 -0
- package/core/src/render/sab-canvas-overlay.ts +122 -0
- package/core/src/render/shader-validator.ts +200 -0
- package/core/src/render/shaders/debug/debug-line.wgsl +27 -0
- package/core/src/render/shaders/debug/debug-point.wgsl +30 -0
- package/core/src/render/shaders/debug/debug-text.wgsl +42 -0
- package/core/src/render/shaders/debug-viz/aabb.wgsl +20 -0
- package/core/src/render/shaders/debug-viz/depth.wgsl +29 -0
- package/core/src/render/shaders/debug-viz/lod.wgsl +38 -0
- package/core/src/render/shaders/debug-viz/normals.wgsl +30 -0
- package/core/src/render/shaders/debug-viz/overdraw.wgsl +21 -0
- package/core/src/render/shaders/debug-viz/tangents.wgsl +29 -0
- package/core/src/render/shaders/debug-viz/wireframe.wgsl +33 -0
- package/core/src/render/shaders/shadow-chunks.ts +135 -0
- package/core/src/render/skybox.ts +146 -0
- package/core/src/render/splitscreen.ts +85 -0
- package/core/src/render/surface.ts +78 -0
- package/core/src/render/tonemap.ts +180 -0
- package/core/src/render/tracked-render-pass.ts +158 -0
- package/core/src/render/viewport.ts +109 -0
- package/core/src/render/wgsl-hmr.ts +70 -0
- package/core/src/sab/core-input-channel.ts +23 -0
- package/core/src/sab/define.ts +239 -0
- package/core/src/sab/errors.ts +76 -0
- package/core/src/sab/game-input.ts +343 -0
- package/core/src/sab/gamepad-devices.ts +259 -0
- package/core/src/sab/grid-buffer.ts +117 -0
- package/core/src/sab/input.ts +55 -0
- package/core/src/sab/layout.ts +219 -0
- package/core/src/sab/multi-input-channel.ts +50 -0
- package/core/src/sab/record-buffer.ts +155 -0
- package/core/src/sab/sab-polyfill.ts +56 -0
- package/core/src/sab/sim-channel.ts +453 -0
- package/core/src/sab/slot-buffer.ts +190 -0
- package/core/src/sab/types.ts +158 -0
- package/core/src/safety/bounds.ts +76 -0
- package/core/src/safety/json.ts +80 -0
- package/core/src/safety/path.ts +167 -0
- package/core/src/save/binary-format.ts +117 -0
- package/core/src/save/game-save-system.ts +161 -0
- package/core/src/save/grid-save-system.ts +158 -0
- package/core/src/save/migrate.ts +44 -0
- package/core/src/save/migration-registry.ts +94 -0
- package/core/src/save/persist-types.ts +208 -0
- package/core/src/save/schema.ts +46 -0
- package/core/src/save/serializer.ts +180 -0
- package/core/src/scene/builder.ts +65 -0
- package/core/src/scene/camera.ts +142 -0
- package/core/src/scene/checkpoint.ts +109 -0
- package/core/src/scene/game-loop.ts +198 -0
- package/core/src/scene/index.ts +24 -0
- package/core/src/scene/layer.ts +6 -0
- package/core/src/scene/prefab.ts +145 -0
- package/core/src/scene/scene-manager.ts +157 -0
- package/core/src/scene/scene.ts +192 -0
- package/core/src/scene/sky.ts +256 -0
- package/core/src/scene/spatial-grid.ts +176 -0
- package/core/src/scene/streaming.ts +304 -0
- package/core/src/scene/vegetation.ts +163 -0
- package/core/src/scene/world.ts +89 -0
- package/core/src/scripting/binding.ts +129 -0
- package/core/src/scripting/hot-reload.ts +144 -0
- package/core/src/scripting/script.ts +99 -0
- package/core/src/sim/hot-reload-pipeline.ts +49 -0
- package/core/src/sim/sim-state-helper.ts +47 -0
- package/core/src/sim/transient-state-registry.ts +77 -0
- package/core/src/sim/types.ts +113 -0
- package/core/src/sim/worker-loop.ts +222 -0
- package/core/src/stores/game-store.ts +158 -0
- package/core/src/stores/hot-reload-store.ts +44 -0
- package/core/src/telemetry/collector.ts +410 -0
- package/core/src/telemetry/gc-controller.ts +453 -0
- package/core/src/telemetry/gc-profiler.ts +126 -0
- package/core/src/telemetry/gc-tracker.ts +69 -0
- package/core/src/telemetry/gpu-profiler.ts +703 -0
- package/core/src/telemetry/gpu-resource-tracker.ts +285 -0
- package/core/src/telemetry/gpu-timer-pool.ts +234 -0
- package/core/src/telemetry/gpu-timer.ts +123 -0
- package/core/src/telemetry/gpu-timestamp-gate.ts +21 -0
- package/core/src/telemetry/reporter.ts +62 -0
- package/core/src/types/engine-types.ts +129 -0
- package/core/src/ui-font-scale.ts +112 -0
- package/core/src/util/broad-phase-grid.ts +82 -0
- package/core/src/util/feature-log.ts +220 -0
- package/core/src/util/index.ts +17 -0
- package/core/src/util/logger.ts +604 -0
- package/core/src/webgpu-destroy-augmentation.d.ts +25 -0
- package/core/src/worker/base-worker-host.ts +183 -0
- package/core/src/worker/buffer-sync.ts +550 -0
- package/core/src/worker/crash-recovery.ts +201 -0
- package/core/src/worker/entity-sim-worker-host.ts +190 -0
- package/core/src/worker/instrumented-worker-host.ts +171 -0
- package/core/src/worker/rpc.ts +253 -0
- package/core/src/worker/sim-worker-base.ts +913 -0
- package/core/src/worker/sim-worker-host.ts +358 -0
- package/core/src/worker/task-pool.ts +256 -0
- package/core/src/worker/task-worker.ts +83 -0
- package/libraries/asset-browser/src/index.ts +11 -0
- package/libraries/asset-browser/src/software-thumbnails.ts +949 -0
- package/libraries/audio-kira/README.md +17 -0
- package/libraries/audio-kira/native/Cargo.toml +14 -0
- package/libraries/audio-kira/native/src/engine.rs +27 -0
- package/libraries/audio-kira/native/src/lib.rs +185 -0
- package/libraries/audio-kira/native/src/mixer.rs +11 -0
- package/libraries/audio-kira/native/src/source.rs +80 -0
- package/libraries/audio-kira/src/backend.ts +469 -0
- package/libraries/audio-kira/src/index.ts +8 -0
- package/libraries/audio-kira/src/library.ts +82 -0
- package/libraries/blitz-ui/native/Cargo.toml +33 -0
- package/libraries/blitz-ui/native/assets/DejaVuSans.woff2 +0 -0
- package/libraries/blitz-ui/native/src/bridge.rs +100 -0
- package/libraries/blitz-ui/native/src/fonts.rs +20 -0
- package/libraries/blitz-ui/native/src/input.rs +80 -0
- package/libraries/blitz-ui/native/src/lib.rs +96 -0
- package/libraries/blitz-ui/native/src/shell.rs +301 -0
- package/libraries/blitz-ui/native-osr/Cargo.toml +24 -0
- package/libraries/blitz-ui/native-osr/src/events.rs +237 -0
- package/libraries/blitz-ui/native-osr/src/lib.rs +846 -0
- package/libraries/blitz-ui/native-osr/src/mutate.rs +385 -0
- package/libraries/blitz-ui/native-osr/src/resources.rs +45 -0
- package/libraries/blitz-ui/native-osr-spike.ts +70 -0
- package/libraries/blitz-ui/src/index.ts +15 -0
- package/libraries/blitz-ui/src/native-module.ts +221 -0
- package/libraries/blitz-ui/src/native-osr-ffi.ts +423 -0
- package/libraries/blitz-ui/src/router.ts +101 -0
- package/libraries/blitz-ui/src/shaders/ui-blit.wgsl.ts +35 -0
- package/libraries/blitz-ui/src/ui-blit-pass.ts +116 -0
- package/libraries/character/README.md +25 -0
- package/libraries/character/src/character-animator.ts +374 -0
- package/libraries/character/src/index.ts +24 -0
- package/libraries/character/src/loader.ts +375 -0
- package/libraries/character/src/locomotion.ts +124 -0
- package/libraries/character/src/preview.ts +287 -0
- package/libraries/devtools/README.md +51 -0
- package/libraries/devtools/native/Cargo.toml +12 -0
- package/libraries/devtools/native/src/lib.rs +1646 -0
- package/libraries/devtools/native/src/panels/console.rs +338 -0
- package/libraries/devtools/native/src/panels/dom_tree.rs +47 -0
- package/libraries/devtools/native/src/panels/generic.rs +317 -0
- package/libraries/devtools/native/src/panels/gpu.rs +107 -0
- package/libraries/devtools/native/src/panels/input.rs +88 -0
- package/libraries/devtools/native/src/panels/mod.rs +154 -0
- package/libraries/devtools/native/src/panels/perf_metrics.rs +91 -0
- package/libraries/devtools/native/src/panels/perf_recorder.rs +158 -0
- package/libraries/devtools/native/src/panels/scene.rs +72 -0
- package/libraries/devtools/native/src/state.rs +394 -0
- package/libraries/devtools/src/cdp-bridge.ts +349 -0
- package/libraries/devtools/src/collectors.ts +346 -0
- package/libraries/devtools/src/egui-ffi.ts +804 -0
- package/libraries/devtools/src/egui-renderer.ts +407 -0
- package/libraries/devtools/src/host.ts +363 -0
- package/libraries/devtools/src/index.ts +40 -0
- package/libraries/devtools/src/mirror.ts +794 -0
- package/libraries/devtools/src/native-providers.ts +744 -0
- package/libraries/devtools/src/verify.ts +167 -0
- package/libraries/devtools/src/web/browser.ts +102 -0
- package/libraries/devtools/src/web/host.ts +212 -0
- package/libraries/devtools/src/web/mirror.ts +430 -0
- package/libraries/devtools/src/web/server.ts +198 -0
- package/libraries/entities/README.md +17 -0
- package/libraries/entities/src/index.ts +4 -0
- package/libraries/entities/src/library.ts +64 -0
- package/libraries/entities/src/model-renderer.ts +1345 -0
- package/libraries/entities/src/shaders/model.wgsl +375 -0
- package/libraries/gamepad/src/feed-input.ts +83 -0
- package/libraries/gamepad/src/filters.ts +49 -0
- package/libraries/gamepad/src/glyphs.ts +93 -0
- package/libraries/gamepad/src/hub.ts +206 -0
- package/libraries/gamepad/src/index.ts +22 -0
- package/libraries/gamepad/src/library.ts +68 -0
- package/libraries/gamepad/src/source-sab.ts +70 -0
- package/libraries/gamepad/src/sysfs-enrich.ts +138 -0
- package/libraries/gaussian-splats/README.md +25 -0
- package/libraries/gaussian-splats/src/gpu-sort.ts +595 -0
- package/libraries/gaussian-splats/src/index.ts +31 -0
- package/libraries/gaussian-splats/src/library.ts +60 -0
- package/libraries/gaussian-splats/src/parser.ts +382 -0
- package/libraries/gaussian-splats/src/renderer.ts +427 -0
- package/libraries/gaussian-splats/src/sh-eval.ts +211 -0
- package/libraries/gaussian-splats/src/sorter.ts +110 -0
- package/libraries/gaussian-splats/src/tile-raster.ts +473 -0
- package/libraries/gpu-kernels/README.md +154 -0
- package/libraries/gpu-kernels/src/index.ts +11 -0
- package/libraries/gpu-kernels/src/kernel.ts +696 -0
- package/libraries/gpu-kernels/src/transpile.ts +958 -0
- package/libraries/html-ui-kit/src/behaviors.ts +250 -0
- package/libraries/html-ui-kit/src/components.ts +309 -0
- package/libraries/html-ui-kit/src/index.ts +30 -0
- package/libraries/html-ui-kit/src/nav/nav-controller.ts +238 -0
- package/libraries/html-ui-kit/src/nav/nav-input.ts +145 -0
- package/libraries/html-ui-kit/src/nav/osk.ts +153 -0
- package/libraries/html-ui-kit/src/nav/router.ts +167 -0
- package/libraries/html-ui-kit/src/nav/vcursor.ts +203 -0
- package/libraries/html-ui-kit/src/ten-foot.ts +182 -0
- package/libraries/html-ui-kit/src/theme.ts +238 -0
- package/libraries/lighting/README.md +20 -0
- package/libraries/lighting/src/index.ts +5 -0
- package/libraries/lighting/src/library.ts +66 -0
- package/libraries/lighting/src/light-system.ts +452 -0
- package/libraries/lighting/src/lighting-system.ts +68 -0
- package/libraries/lighting/src/shaders/light-debug.wgsl +30 -0
- package/libraries/marching-cubes/README.md +25 -0
- package/libraries/marching-cubes/src/chunked-field.ts +177 -0
- package/libraries/marching-cubes/src/deformation.ts +63 -0
- package/libraries/marching-cubes/src/generator.ts +407 -0
- package/libraries/marching-cubes/src/index.ts +32 -0
- package/libraries/marching-cubes/src/library.ts +80 -0
- package/libraries/marching-cubes/src/lod.ts +122 -0
- package/libraries/marching-cubes/src/marching-tetrahedra.ts +252 -0
- package/libraries/marching-cubes/src/sab.ts +45 -0
- package/libraries/marching-cubes/src/streaming-config.ts +48 -0
- package/libraries/marching-cubes/src/streaming-manager.ts +686 -0
- package/libraries/marching-cubes/src/tables.ts +323 -0
- package/libraries/marching-cubes/src/types.ts +18 -0
- package/libraries/models/README.md +25 -0
- package/libraries/models/src/bake-node-transforms.ts +171 -0
- package/libraries/models/src/codecs/basisu-codec.ts +180 -0
- package/libraries/models/src/codecs/draco-codec.ts +372 -0
- package/libraries/models/src/codecs/draco3dgltf.d.ts +40 -0
- package/libraries/models/src/codecs/index.ts +22 -0
- package/libraries/models/src/codecs/meshopt-codec.ts +91 -0
- package/libraries/models/src/codecs/registry.ts +221 -0
- package/libraries/models/src/dae.ts +753 -0
- package/libraries/models/src/default-part-selection.ts +56 -0
- package/libraries/models/src/dxf.ts +200 -0
- package/libraries/models/src/fbx/index.ts +457 -0
- package/libraries/models/src/fbx/interpreter/animation.ts +431 -0
- package/libraries/models/src/fbx/interpreter/blend-shapes.ts +323 -0
- package/libraries/models/src/fbx/interpreter/connections.ts +166 -0
- package/libraries/models/src/fbx/interpreter/diagnostics.ts +65 -0
- package/libraries/models/src/fbx/interpreter/geometry.ts +535 -0
- package/libraries/models/src/fbx/interpreter/global-settings.ts +92 -0
- package/libraries/models/src/fbx/interpreter/materials.ts +265 -0
- package/libraries/models/src/fbx/interpreter/nodes.ts +197 -0
- package/libraries/models/src/fbx/interpreter/skeleton.ts +476 -0
- package/libraries/models/src/fbx/parsers/binary-parser.ts +244 -0
- package/libraries/models/src/fbx/types.ts +119 -0
- package/libraries/models/src/gltf-extensions.ts +196 -0
- package/libraries/models/src/gltf.ts +935 -0
- package/libraries/models/src/index.ts +87 -0
- package/libraries/models/src/library.ts +75 -0
- package/libraries/models/src/loader.ts +265 -0
- package/libraries/models/src/material-adapter.ts +108 -0
- package/libraries/models/src/mini-xml.ts +174 -0
- package/libraries/models/src/normalize.ts +216 -0
- package/libraries/models/src/obj.ts +264 -0
- package/libraries/models/src/off.ts +95 -0
- package/libraries/models/src/ply.ts +348 -0
- package/libraries/models/src/pose-sampler.ts +219 -0
- package/libraries/models/src/sidecar/blender-extras.ts +37 -0
- package/libraries/models/src/sidecar/ddmeta.ts +114 -0
- package/libraries/models/src/sidecar/godot-import.ts +86 -0
- package/libraries/models/src/sidecar/resolver.ts +145 -0
- package/libraries/models/src/sidecar/types.ts +11 -0
- package/libraries/models/src/sidecar/unity-meta.ts +61 -0
- package/libraries/models/src/skeleton-synthesis.ts +132 -0
- package/libraries/models/src/stl.ts +149 -0
- package/libraries/models/src/threeds.ts +363 -0
- package/libraries/models/src/threemf.ts +201 -0
- package/libraries/models/src/types.ts +188 -0
- package/libraries/models/src/vtk.ts +218 -0
- package/libraries/models/test-fixtures/fbx/LICENSE-notice.txt +24 -0
- package/libraries/models/test-fixtures/fbx/README.md +46 -0
- 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/navmesh/README.md +23 -0
- package/libraries/navmesh/src/crowd-system.ts +240 -0
- package/libraries/navmesh/src/debug-viz.ts +74 -0
- package/libraries/navmesh/src/index.ts +15 -0
- package/libraries/navmesh/src/library.ts +64 -0
- package/libraries/navmesh/src/navmesh-generator.ts +407 -0
- package/libraries/navmesh/src/navmesh.ts +159 -0
- package/libraries/navmesh/src/pathfinder.ts +252 -0
- package/libraries/navmesh/src/types.ts +63 -0
- package/libraries/networking/README.md +25 -0
- package/libraries/networking/src/authority.ts +121 -0
- package/libraries/networking/src/connection.ts +139 -0
- package/libraries/networking/src/discovery.ts +373 -0
- package/libraries/networking/src/enhanced-replication.ts +355 -0
- package/libraries/networking/src/epic-adapter.ts +129 -0
- package/libraries/networking/src/index.ts +45 -0
- package/libraries/networking/src/library.ts +69 -0
- package/libraries/networking/src/lobby.ts +108 -0
- package/libraries/networking/src/platform-adapter.ts +163 -0
- package/libraries/networking/src/rcs-adapter.ts +127 -0
- package/libraries/networking/src/remote-input.ts +188 -0
- package/libraries/networking/src/replication.ts +327 -0
- package/libraries/networking/src/rpc.ts +188 -0
- package/libraries/networking/src/session.ts +173 -0
- package/libraries/networking/src/transport.ts +201 -0
- package/libraries/networking/src/webrtc.ts +323 -0
- package/libraries/pathfinding-2d/README.md +15 -0
- package/libraries/pathfinding-2d/src/astar-grid.ts +312 -0
- package/libraries/pathfinding-2d/src/index.ts +11 -0
- package/libraries/persistence/README.md +25 -0
- package/libraries/persistence/src/autosave-manager.ts +112 -0
- package/libraries/persistence/src/binary-record-store.ts +244 -0
- package/libraries/persistence/src/browser.ts +51 -0
- package/libraries/persistence/src/file-save-store.ts +553 -0
- package/libraries/persistence/src/hash-utils.ts +59 -0
- package/libraries/persistence/src/index.ts +57 -0
- package/libraries/persistence/src/library.ts +74 -0
- package/libraries/persistence/src/mock-opfs.ts +141 -0
- package/libraries/persistence/src/node-fs-directory-handle.ts +161 -0
- package/libraries/persistence/src/opfs-save-store.ts +745 -0
- package/libraries/persistence/src/save-worker-proxy.ts +127 -0
- package/libraries/persistence/src/save-worker.ts +99 -0
- package/libraries/persistence/src/xxh3-ts.d.ts +10 -0
- package/libraries/physics-native/README.md +21 -0
- package/libraries/physics-native/native/Cargo.toml +11 -0
- package/libraries/physics-native/native/src/body.rs +403 -0
- package/libraries/physics-native/native/src/character.rs +226 -0
- package/libraries/physics-native/native/src/collider.rs +299 -0
- package/libraries/physics-native/native/src/joint.rs +81 -0
- package/libraries/physics-native/native/src/lib.rs +830 -0
- package/libraries/physics-native/native/src/query.rs +261 -0
- package/libraries/physics-native/native/src/realm.rs +33 -0
- package/libraries/physics-native/native/src/step.rs +54 -0
- package/libraries/physics-native/native/src/world.rs +148 -0
- package/libraries/physics-native/src/backend.ts +1046 -0
- package/libraries/physics-native/src/broadphase.ts +101 -0
- package/libraries/physics-native/src/ffi-spike-worker.ts +71 -0
- package/libraries/physics-native/src/index.ts +11 -0
- package/libraries/physics-native/src/library.ts +79 -0
- package/libraries/physics-native/src/narrowphase-shapes.ts +420 -0
- package/libraries/physics-native/src/narrowphase.ts +123 -0
- package/libraries/physics-native/src/solver.ts +141 -0
- package/libraries/physics-native/src/types.ts +76 -0
- package/libraries/physics-rapier/README.md +21 -0
- package/libraries/physics-rapier/bench/ffi-bench.ts +79 -0
- package/libraries/physics-rapier/bench/wasm-baseline.ts +90 -0
- package/libraries/physics-rapier/src/api.ts +452 -0
- package/libraries/physics-rapier/src/auto-backend.ts +59 -0
- package/libraries/physics-rapier/src/backend.ts +1207 -0
- package/libraries/physics-rapier/src/bulk-ops.ts +68 -0
- package/libraries/physics-rapier/src/ffi-backend.ts +21 -0
- package/libraries/physics-rapier/src/ffi-lib.ts +597 -0
- package/libraries/physics-rapier/src/index.ts +12 -0
- package/libraries/physics-rapier/src/library.ts +107 -0
- package/libraries/physics-rapier/src/rapier-backend.ts +1052 -0
- package/libraries/physics-rapier/src/realm-worker-script.ts +237 -0
- package/libraries/postfx/README.md +17 -0
- package/libraries/postfx/src/index.ts +19 -0
- package/libraries/postfx/src/library.ts +337 -0
- package/libraries/postfx/src/post-process-stack.ts +1752 -0
- package/libraries/postfx/src/shaders/post-process/afterimage.wgsl +14 -0
- package/libraries/postfx/src/shaders/post-process/ascii.wgsl +24 -0
- package/libraries/postfx/src/shaders/post-process/blit.wgsl +12 -0
- package/libraries/postfx/src/shaders/post-process/bloom-blur.wgsl +21 -0
- package/libraries/postfx/src/shaders/post-process/bloom-bright.wgsl +15 -0
- package/libraries/postfx/src/shaders/post-process/bloom-composite.wgsl +14 -0
- package/libraries/postfx/src/shaders/post-process/bloom-downsample.wgsl +60 -0
- package/libraries/postfx/src/shaders/post-process/bloom-soft.wgsl +46 -0
- package/libraries/postfx/src/shaders/post-process/bloom-upsample.wgsl +51 -0
- package/libraries/postfx/src/shaders/post-process/channel-mixer.wgsl +36 -0
- package/libraries/postfx/src/shaders/post-process/chromatic-aberration.wgsl +37 -0
- package/libraries/postfx/src/shaders/post-process/dithering.wgsl +64 -0
- package/libraries/postfx/src/shaders/post-process/dof.wgsl +131 -0
- package/libraries/postfx/src/shaders/post-process/edges.wgsl +45 -0
- package/libraries/postfx/src/shaders/post-process/fullscreen-vs.wgsl +15 -0
- package/libraries/postfx/src/shaders/post-process/fxaa.wgsl +102 -0
- package/libraries/postfx/src/shaders/post-process/gaussian-blur.wgsl +37 -0
- package/libraries/postfx/src/shaders/post-process/glow-blur.wgsl +33 -0
- package/libraries/postfx/src/shaders/post-process/glow-composite.wgsl +25 -0
- package/libraries/postfx/src/shaders/post-process/grain.wgsl +37 -0
- package/libraries/postfx/src/shaders/post-process/halftone.wgsl +80 -0
- package/libraries/postfx/src/shaders/post-process/highlight-blur.wgsl +33 -0
- package/libraries/postfx/src/shaders/post-process/highlight-composite.wgsl +32 -0
- package/libraries/postfx/src/shaders/post-process/lens-distortion.wgsl +43 -0
- package/libraries/postfx/src/shaders/post-process/lens-flare.wgsl +68 -0
- package/libraries/postfx/src/shaders/post-process/lut.wgsl +30 -0
- package/libraries/postfx/src/shaders/post-process/motion-blur.wgsl +55 -0
- package/libraries/postfx/src/shaders/post-process/occluder-chunk.wgsl +28 -0
- package/libraries/postfx/src/shaders/post-process/outline.wgsl +51 -0
- package/libraries/postfx/src/shaders/post-process/pixelation.wgsl +47 -0
- package/libraries/postfx/src/shaders/post-process/sharpen.wgsl +32 -0
- package/libraries/postfx/src/shaders/post-process/sobel.wgsl +26 -0
- package/libraries/postfx/src/shaders/post-process/split-tone.wgsl +36 -0
- package/libraries/postfx/src/shaders/post-process/ssao-blur.wgsl +38 -0
- package/libraries/postfx/src/shaders/post-process/ssao-composite.wgsl +25 -0
- package/libraries/postfx/src/shaders/post-process/ssao.wgsl +147 -0
- package/libraries/postfx/src/shaders/post-process/ssr.wgsl +155 -0
- package/libraries/postfx/src/shaders/post-process/taa.wgsl +98 -0
- package/libraries/postfx/src/shaders/post-process/tonemap.wgsl +40 -0
- package/libraries/postfx/src/shaders/post-process/watercolor.wgsl +82 -0
- package/libraries/postfx/src/shaders/post-process/white-balance.wgsl +41 -0
- package/libraries/recast/README.md +21 -0
- package/libraries/recast/src/backend.ts +150 -0
- package/libraries/recast/src/crowd-system.ts +352 -0
- package/libraries/recast/src/index.ts +12 -0
- package/libraries/recast/src/library.ts +91 -0
- package/libraries/recast/src/types.ts +86 -0
- package/libraries/sand/README.md +25 -0
- package/libraries/sand/src/cell.ts +43 -0
- package/libraries/sand/src/fields.ts +29 -0
- package/libraries/sand/src/fluid-grid.ts +261 -0
- package/libraries/sand/src/grid-dims.ts +74 -0
- package/libraries/sand/src/grid-sim-buffer.ts +271 -0
- package/libraries/sand/src/index.ts +81 -0
- package/libraries/sand/src/library.ts +92 -0
- package/libraries/sand/src/materials.ts +492 -0
- package/libraries/sand/src/palette.ts +93 -0
- package/libraries/sand/src/particles.ts +185 -0
- package/libraries/sand/src/render/sand-grid-pass.ts +430 -0
- package/libraries/sand/src/rng.ts +51 -0
- package/libraries/sand/src/rules/builtin-rules.ts +132 -0
- package/libraries/sand/src/rules/rule-compiler.ts +162 -0
- package/libraries/sand/src/rules/rule-engine.ts +231 -0
- package/libraries/sand/src/rules/rule-types.ts +87 -0
- package/libraries/sand/src/sand-step-pool.ts +484 -0
- package/libraries/sand/src/sand-step-worker.ts +97 -0
- package/libraries/sand/src/sand-world.ts +3227 -0
- package/libraries/stickman/README.md +25 -0
- package/libraries/stickman/src/index.ts +25 -0
- package/libraries/stickman/src/library.ts +61 -0
- package/libraries/stickman/src/proportions.ts +45 -0
- package/libraries/stickman/src/shader.ts +117 -0
- package/libraries/stickman/src/skeleton.ts +197 -0
- package/libraries/stickman/src/stickman-pass.ts +255 -0
- package/libraries/stickman/src/thick-line.ts +123 -0
- package/libraries/surface-nets/README.md +25 -0
- package/libraries/surface-nets/src/chunked-field.ts +14 -0
- package/libraries/surface-nets/src/deformation.ts +45 -0
- package/libraries/surface-nets/src/index.ts +36 -0
- package/libraries/surface-nets/src/library.ts +59 -0
- package/libraries/surface-nets/src/lod.ts +7 -0
- package/libraries/surface-nets/src/sab.ts +4 -0
- package/libraries/surface-nets/src/streaming-config.ts +5 -0
- package/libraries/surface-nets/src/streaming-manager.ts +15 -0
- package/libraries/surface-nets/src/surface-nets.ts +334 -0
- package/libraries/surface-nets/src/types.ts +23 -0
- package/libraries/water/README.md +25 -0
- package/libraries/water/src/buoyancy.ts +103 -0
- package/libraries/water/src/index.ts +43 -0
- package/libraries/water/src/library.ts +85 -0
- package/libraries/water/src/shore-damping.ts +93 -0
- package/libraries/water/src/water-buffer.ts +89 -0
- package/libraries/water/src/water-chunks.ts +13 -0
- package/libraries/water/src/water-physics.ts +376 -0
- package/libraries/water/src/water-renderer.ts +809 -0
- package/libraries/water/src/water-sab.ts +161 -0
- package/libraries/water/src/wave-sources.ts +84 -0
- package/libraries/weather/README.md +20 -0
- package/libraries/weather/src/index.ts +9 -0
- package/libraries/weather/src/library.ts +72 -0
- package/libraries/weather/src/types.ts +64 -0
- package/libraries/weather/src/weather-blend.ts +112 -0
- package/libraries/weather/src/weather-system.ts +271 -0
- package/libraries/weatherfx/README.md +24 -0
- package/libraries/weatherfx/src/cloud-provider.ts +31 -0
- package/libraries/weatherfx/src/cloud-system.ts +372 -0
- package/libraries/weatherfx/src/index.ts +9 -0
- package/libraries/weatherfx/src/library.ts +58 -0
- package/libraries/weatherfx/src/particle-system.ts +434 -0
- package/libraries/weatherfx/src/shaders/cloud.wgsl +111 -0
- package/libraries/weatherfx/src/shaders/particle-compute.wgsl +187 -0
- package/libraries/weatherfx/src/shaders/particle-render.wgsl +95 -0
- package/lint-plugin.mjs +41 -0
- package/mcp/src/client.ts +703 -0
- package/mcp/src/engine-context.ts +186 -0
- package/mcp/src/http-transport.ts +471 -0
- package/mcp/src/index.ts +13 -0
- package/mcp/src/prompts/add-entity.ts +42 -0
- package/mcp/src/prompts/create-scene.ts +44 -0
- package/mcp/src/prompts/debug-frame.ts +39 -0
- package/mcp/src/prompts/index.ts +12 -0
- package/mcp/src/resources/asset-list.ts +32 -0
- package/mcp/src/resources/checkpoint-list.ts +33 -0
- package/mcp/src/resources/entity-state.ts +55 -0
- package/mcp/src/resources/gpu-info.ts +103 -0
- package/mcp/src/resources/index.ts +57 -0
- package/mcp/src/resources/performance.ts +37 -0
- package/mcp/src/resources/scene-tree.ts +43 -0
- package/mcp/src/server.ts +375 -0
- package/mcp/src/tools/animation.ts +118 -0
- package/mcp/src/tools/asset.ts +161 -0
- package/mcp/src/tools/audio.ts +96 -0
- package/mcp/src/tools/build.ts +143 -0
- package/mcp/src/tools/camera.ts +167 -0
- package/mcp/src/tools/checkpoint.ts +100 -0
- package/mcp/src/tools/component.ts +199 -0
- package/mcp/src/tools/debug.ts +300 -0
- package/mcp/src/tools/entity.ts +361 -0
- package/mcp/src/tools/inspect.ts +210 -0
- package/mcp/src/tools/lighting.ts +263 -0
- package/mcp/src/tools/material.ts +243 -0
- package/mcp/src/tools/mesh.ts +239 -0
- package/mcp/src/tools/physics.ts +266 -0
- package/mcp/src/tools/scene.ts +153 -0
- package/mcp/src/tools/script.ts +122 -0
- package/mcp/src/types.ts +92 -0
- package/mcp/src/undo-redo.ts +77 -0
- package/modules/camera-controls/README.md +20 -0
- package/modules/camera-controls/src/index.ts +161 -0
- package/modules/controller-ui/src/index.ts +164 -0
- package/modules/devtools/README.md +25 -0
- package/modules/devtools/src/api.ts +461 -0
- package/modules/devtools/src/asset-utils.ts +105 -0
- package/modules/devtools/src/bind-debug-store.ts +48 -0
- package/modules/devtools/src/data-bridge.ts +286 -0
- package/modules/devtools/src/debug-overlay.ts +238 -0
- package/modules/devtools/src/debug-raycast.ts +328 -0
- package/modules/devtools/src/debug-store.ts +92 -0
- package/modules/devtools/src/debug-view-descriptors.ts +59 -0
- package/modules/devtools/src/doctor-panel.ts +182 -0
- package/modules/devtools/src/gizmo-module.ts +136 -0
- package/modules/devtools/src/graph-model.ts +509 -0
- package/modules/devtools/src/grid-renderer.ts +157 -0
- package/modules/devtools/src/height-ruler-renderer.ts +216 -0
- package/modules/devtools/src/index.ts +81 -0
- package/modules/devtools/src/init.ts +261 -0
- package/modules/devtools/src/label-overlay.ts +154 -0
- package/modules/devtools/src/material-stats-panel.ts +188 -0
- package/modules/devtools/src/profiling-bridge.ts +377 -0
- package/modules/devtools/src/profiling-hooks.ts +98 -0
- package/modules/devtools/src/renderer-adapter.ts +76 -0
- package/modules/devtools/src/scene-inspector.ts +637 -0
- package/modules/devtools/src/scene-store.ts +320 -0
- package/modules/devtools/src/scene-sync.ts +116 -0
- package/modules/devtools/src/shaders/transform-gizmo.wgsl +38 -0
- package/modules/devtools/src/sim-stats-panel.ts +272 -0
- package/modules/devtools/src/sim-stats-provider.ts +105 -0
- package/modules/devtools/src/skeleton-renderer.ts +351 -0
- package/modules/devtools/src/transform-gizmo.ts +928 -0
- package/modules/devtools/src/types.ts +290 -0
- package/modules/devtools/src/worker-expose.ts +67 -0
- package/modules/devtools/src/worker-sync.ts +137 -0
- package/modules/editor/src/commands/component.ts +156 -0
- package/modules/editor/src/commands/entity.ts +287 -0
- package/modules/editor/src/commands/hierarchy.ts +83 -0
- package/modules/editor/src/commands/index.ts +61 -0
- package/modules/editor/src/commands/prefab.ts +163 -0
- package/modules/editor/src/commands/registry.ts +331 -0
- package/modules/editor/src/commands/scene-io.ts +211 -0
- package/modules/editor/src/commands/selection.ts +73 -0
- package/modules/editor/src/commands/transform.ts +91 -0
- package/modules/editor/src/ddscene.ts +267 -0
- package/modules/editor/src/document.ts +123 -0
- package/modules/editor/src/editor-context.ts +172 -0
- package/modules/editor/src/index.ts +41 -0
- package/modules/editor/src/mcp.ts +103 -0
- package/modules/editor/src/module.ts +148 -0
- package/modules/editor/src/selection.ts +70 -0
- package/modules/editor/src/shell.ts +456 -0
- package/modules/editor/src/viewport.ts +199 -0
- package/modules/html-ui/src/composite.ts +135 -0
- package/modules/html-ui/src/create-html-ui.ts +188 -0
- package/modules/html-ui/src/doc-backend.ts +343 -0
- package/modules/html-ui/src/host.ts +646 -0
- package/modules/html-ui/src/index.ts +13 -0
- package/modules/html-ui/src/jsx-dev-runtime.ts +12 -0
- package/modules/html-ui/src/jsx-runtime.ts +126 -0
- package/modules/html-ui/src/protocol.ts +88 -0
- package/modules/html-ui/src/ui-worker.ts +16 -0
- package/modules/mcp/README.md +18 -0
- package/modules/mcp/src/index.ts +27 -0
- package/modules/movement-2d/README.md +19 -0
- package/modules/movement-2d/src/grid-character.ts +455 -0
- package/modules/movement-2d/src/index.ts +45 -0
- package/modules/movement-3d/README.md +21 -0
- package/modules/movement-3d/src/character-motor.ts +230 -0
- package/modules/movement-3d/src/index.ts +46 -0
- package/modules/native-osr/src/index.ts +22 -0
- package/modules/native-osr/src/input-router.ts +401 -0
- package/modules/native-osr/src/native-osr-manager.ts +247 -0
- package/modules/native-osr/src/native-texture-source.ts +86 -0
- package/modules/native-osr/src/types.ts +112 -0
- package/modules/native-osr/src/world-space-ui-pass.ts +351 -0
- package/modules/sailing/README.md +18 -0
- package/modules/sailing/src/index.ts +51 -0
- package/modules/terrain/README.md +18 -0
- package/modules/terrain/src/index.ts +78 -0
- package/modules/vitals/README.md +17 -0
- package/modules/vitals/src/index.ts +43 -0
- package/modules/vitals/src/vitals.ts +265 -0
- package/modules/xr/README.md +25 -0
- package/modules/xr/src/camera-rig.ts +146 -0
- package/modules/xr/src/debug.ts +59 -0
- package/modules/xr/src/frame-loop.ts +197 -0
- package/modules/xr/src/index.ts +16 -0
- package/modules/xr/src/input.ts +208 -0
- package/modules/xr/src/layer.ts +140 -0
- package/modules/xr/src/session.ts +156 -0
- package/modules/xr/src/sim-module.ts +23 -0
- package/modules/xr/src/types.ts +32 -0
- package/modules/xr/src/webxr.d.ts +182 -0
- package/modules/xr/src/xr-module.ts +179 -0
- package/package.json +232 -3
- package/shader-graph/src/chunks.ts +349 -0
- package/shader-graph/src/compiler.ts +732 -0
- package/shader-graph/src/compute-compiler.ts +453 -0
- package/shader-graph/src/compute-graph.ts +112 -0
- package/shader-graph/src/compute-profiles.ts +54 -0
- package/shader-graph/src/graph.ts +52 -0
- package/shader-graph/src/index.ts +53 -0
- package/shader-graph/src/profiles.ts +407 -0
- package/shader-graph/src/validator.ts +48 -0
- package/shader-graph/src/wgsl-binding-validator.ts +143 -0
- package/shader-graph/src/wgsl-struct-validator.ts +245 -0
- package/shader-graph/src/wgsl-struct.ts +397 -0
- package/test/src/index.ts +7 -0
- package/test/src/vision-test.ts +369 -0
|
@@ -0,0 +1,91 @@
|
|
|
1
|
+
// ============================================================================
|
|
2
|
+
// Transform commands — `transform.set` is the workhorse for gizmo drags and
|
|
3
|
+
// inspector vec3 edits. Writes into the entity's `transform` component
|
|
4
|
+
// (position/rotation/scale), creating it with identity defaults when absent.
|
|
5
|
+
// The component name is configurable via `ctx.transformComponent`.
|
|
6
|
+
// ============================================================================
|
|
7
|
+
|
|
8
|
+
import { sanitizeObject } from "@downdraft/engine";
|
|
9
|
+
|
|
10
|
+
import type { EditorContext } from "../editor-context";
|
|
11
|
+
import type { EditorCommand } from "./registry";
|
|
12
|
+
|
|
13
|
+
const IDENTITY = { position: [0, 0, 0], rotation: [0, 0, 0, 1], scale: [1, 1, 1] };
|
|
14
|
+
|
|
15
|
+
function readTransform(ctx: EditorContext, entityKey: string): Record<string, unknown> {
|
|
16
|
+
const entity = ctx.parseEntity(entityKey);
|
|
17
|
+
if (!entity) return { ...IDENTITY };
|
|
18
|
+
const cid = ctx.engine.getComponentIdByName(ctx.transformComponent);
|
|
19
|
+
const data = ctx.engine.ecsWorld.getComponent<Record<string, unknown>>(entity, cid);
|
|
20
|
+
return data ? (sanitizeObject({ ...data }) as Record<string, unknown>) : { ...IDENTITY };
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
export function createTransformCommands(): EditorCommand[] {
|
|
24
|
+
return [
|
|
25
|
+
{
|
|
26
|
+
id: "transform.set",
|
|
27
|
+
title: "Set Transform",
|
|
28
|
+
mutating: true,
|
|
29
|
+
params: {
|
|
30
|
+
type: "object",
|
|
31
|
+
properties: {
|
|
32
|
+
entity: { type: "string" },
|
|
33
|
+
position: { type: "array", items: { type: "number" }, description: "[x,y,z]" },
|
|
34
|
+
rotation: { type: "array", items: { type: "number" }, description: "quaternion [x,y,z,w]" },
|
|
35
|
+
scale: { type: "array", items: { type: "number" }, description: "[x,y,z]" },
|
|
36
|
+
},
|
|
37
|
+
required: ["entity"],
|
|
38
|
+
},
|
|
39
|
+
apply(ctx, params) {
|
|
40
|
+
const key = params.entity as string;
|
|
41
|
+
const entity = ctx.parseEntity(key);
|
|
42
|
+
if (!entity || !ctx.isAliveKey(key)) throw new Error(`Entity ${key} not found or dead`);
|
|
43
|
+
|
|
44
|
+
const old = readTransform(ctx, key);
|
|
45
|
+
const next = { ...old } as Record<string, unknown>;
|
|
46
|
+
const applied: string[] = [];
|
|
47
|
+
(["position", "rotation", "scale"] as const).forEach((field) => {
|
|
48
|
+
const v = params[field] as number[] | undefined;
|
|
49
|
+
if (v) { next[field] = [...v]; applied.push(field); }
|
|
50
|
+
});
|
|
51
|
+
if (applied.length === 0) throw new Error("transform.set: nothing to set");
|
|
52
|
+
|
|
53
|
+
const cid = ctx.engine.getComponentIdByName(ctx.transformComponent);
|
|
54
|
+
const sanitized = sanitizeObject(next);
|
|
55
|
+
if (ctx.engine.ecsWorld.hasComponent(entity, cid)) {
|
|
56
|
+
ctx.engine.ecsWorld.setComponent(entity, cid, sanitized);
|
|
57
|
+
} else {
|
|
58
|
+
ctx.engine.ecsWorld.addComponent(entity, cid, sanitized);
|
|
59
|
+
}
|
|
60
|
+
ctx.engine.ecsWorld.flushCommands();
|
|
61
|
+
ctx.document.markDirty({ kind: "data", entity: key });
|
|
62
|
+
ctx.adapter?.syncEntity?.(key);
|
|
63
|
+
|
|
64
|
+
// Inverse restores only the fields we changed.
|
|
65
|
+
const inverseChanges: Record<string, unknown> = {};
|
|
66
|
+
applied.forEach((f) => { inverseChanges[f] = old[f]; });
|
|
67
|
+
return {
|
|
68
|
+
value: { entity: key, applied },
|
|
69
|
+
inverse: [{ command: "component.set", params: { entity: key, component: ctx.transformComponent, changes: inverseChanges } }],
|
|
70
|
+
description: `Transform ${key} (${applied.join(", ")})`,
|
|
71
|
+
};
|
|
72
|
+
},
|
|
73
|
+
},
|
|
74
|
+
|
|
75
|
+
{
|
|
76
|
+
id: "transform.get",
|
|
77
|
+
title: "Get Transform",
|
|
78
|
+
mutating: false,
|
|
79
|
+
params: {
|
|
80
|
+
type: "object",
|
|
81
|
+
properties: { entity: { type: "string" } },
|
|
82
|
+
required: ["entity"],
|
|
83
|
+
},
|
|
84
|
+
apply(ctx, params) {
|
|
85
|
+
const key = params.entity as string;
|
|
86
|
+
if (!ctx.isAliveKey(key)) throw new Error(`Entity ${key} not found or dead`);
|
|
87
|
+
return { value: { entity: key, transform: readTransform(ctx, key) } };
|
|
88
|
+
},
|
|
89
|
+
},
|
|
90
|
+
];
|
|
91
|
+
}
|
|
@@ -0,0 +1,267 @@
|
|
|
1
|
+
// ============================================================================
|
|
2
|
+
// .ddscene — the editor's scene document format + SceneLoader.
|
|
3
|
+
//
|
|
4
|
+
// JSON, versioned, component-name-keyed (stable across code changes —
|
|
5
|
+
// numeric component ids are NOT persisted). Entity file ids are stable
|
|
6
|
+
// strings ("e_3") so parent references survive respawn.
|
|
7
|
+
//
|
|
8
|
+
// serializeDocument(doc) → DdSceneFile
|
|
9
|
+
// deserializeIntoDocument(doc, file) → { warnings, idMap }
|
|
10
|
+
// instantiateScene(file, deps) → spawn-only engine API for games
|
|
11
|
+
// diffScenes(a, b) → structural diff for agents/CI
|
|
12
|
+
//
|
|
13
|
+
// Format is intentionally close to `SerializedScene` (core/scene/scene.ts)
|
|
14
|
+
// but persists component *names* and adds names/hierarchy/environment —
|
|
15
|
+
// `SerializedScene` is a runtime checkpoint, `.ddscene` is an authored doc.
|
|
16
|
+
// ============================================================================
|
|
17
|
+
|
|
18
|
+
import {
|
|
19
|
+
getColumnValue,
|
|
20
|
+
getComponentId,
|
|
21
|
+
getComponentName,
|
|
22
|
+
isRegisteredComponentName,
|
|
23
|
+
sanitizeObject,
|
|
24
|
+
type Entity,
|
|
25
|
+
type Hierarchy,
|
|
26
|
+
type Scene,
|
|
27
|
+
type World,
|
|
28
|
+
} from "@downdraft/engine";
|
|
29
|
+
|
|
30
|
+
import type { EditorDocument } from "./document";
|
|
31
|
+
|
|
32
|
+
export const DDSCENE_FORMAT = "ddscene";
|
|
33
|
+
export const DDSCENE_VERSION = 1;
|
|
34
|
+
|
|
35
|
+
export interface DdSceneEntity {
|
|
36
|
+
/** Stable file id — unique within the document. */
|
|
37
|
+
id: string;
|
|
38
|
+
/** Editor display name. */
|
|
39
|
+
name?: string;
|
|
40
|
+
/** File id of the parent entity. */
|
|
41
|
+
parent?: string;
|
|
42
|
+
/** Prefab reference (path or registry name). */
|
|
43
|
+
prefab?: string;
|
|
44
|
+
/** Per-prefab component overrides (recorded over the prefab base). */
|
|
45
|
+
overrides?: Record<string, Record<string, unknown>>;
|
|
46
|
+
/** Component name → data. Absent when the entity is a pure prefab ref. */
|
|
47
|
+
components?: Record<string, Record<string, unknown>>;
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
export interface DdSceneFile {
|
|
51
|
+
format: typeof DDSCENE_FORMAT;
|
|
52
|
+
version: number;
|
|
53
|
+
name: string;
|
|
54
|
+
entities: DdSceneEntity[];
|
|
55
|
+
environment?: Record<string, unknown>;
|
|
56
|
+
camera?: {
|
|
57
|
+
position: [number, number, number];
|
|
58
|
+
target: [number, number, number];
|
|
59
|
+
fov?: number;
|
|
60
|
+
};
|
|
61
|
+
meta: Record<string, unknown>;
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
export interface DeserializeResult {
|
|
65
|
+
warnings: string[];
|
|
66
|
+
/** file id → live entity key ("index.generation"). */
|
|
67
|
+
idMap: Map<string, string>;
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
// ── Serialize ──
|
|
71
|
+
|
|
72
|
+
export function serializeDocument(doc: EditorDocument, scene: Scene, hierarchy: Hierarchy): DdSceneFile {
|
|
73
|
+
const entities: DdSceneEntity[] = [];
|
|
74
|
+
const fileIds = new Map<string, string>(); // entity key → file id
|
|
75
|
+
|
|
76
|
+
for (const entity of doc.entities()) {
|
|
77
|
+
fileIds.set(doc.key(entity), `e_${entity.index}`);
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
for (const entity of doc.entities()) {
|
|
81
|
+
const key = doc.key(entity);
|
|
82
|
+
const arch = doc.world.getArchetypeForEntity(entity);
|
|
83
|
+
const components: Record<string, Record<string, unknown>> = {};
|
|
84
|
+
if (arch) {
|
|
85
|
+
const row = arch.entities.findIndex((e) => e.index === entity.index && e.generation === entity.generation);
|
|
86
|
+
if (row >= 0) {
|
|
87
|
+
for (const [cid, col] of arch.columns.entries()) {
|
|
88
|
+
const data = getColumnValue(col, row);
|
|
89
|
+
if (data !== undefined && data !== null) {
|
|
90
|
+
components[getComponentName(cid)] = sanitizeObject(data) as Record<string, unknown>;
|
|
91
|
+
}
|
|
92
|
+
}
|
|
93
|
+
}
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
const parent = hierarchy.getParent(entity);
|
|
97
|
+
const entry: DdSceneEntity = {
|
|
98
|
+
id: fileIds.get(key)!,
|
|
99
|
+
components,
|
|
100
|
+
};
|
|
101
|
+
const displayName = doc.entityName(key);
|
|
102
|
+
if (displayName) entry.name = displayName;
|
|
103
|
+
if (parent) {
|
|
104
|
+
const parentFileId = fileIds.get(doc.key(parent));
|
|
105
|
+
if (parentFileId) entry.parent = parentFileId;
|
|
106
|
+
}
|
|
107
|
+
entities.push(entry);
|
|
108
|
+
}
|
|
109
|
+
|
|
110
|
+
return {
|
|
111
|
+
format: DDSCENE_FORMAT,
|
|
112
|
+
version: DDSCENE_VERSION,
|
|
113
|
+
name: doc.name,
|
|
114
|
+
entities,
|
|
115
|
+
meta: {
|
|
116
|
+
engineVersion: "0.1.0",
|
|
117
|
+
savedAt: new Date().toISOString(),
|
|
118
|
+
},
|
|
119
|
+
};
|
|
120
|
+
}
|
|
121
|
+
|
|
122
|
+
// ── Deserialize ──
|
|
123
|
+
|
|
124
|
+
export function deserializeIntoDocument(
|
|
125
|
+
doc: EditorDocument,
|
|
126
|
+
scene: Scene,
|
|
127
|
+
world: World,
|
|
128
|
+
hierarchy: Hierarchy,
|
|
129
|
+
file: DdSceneFile,
|
|
130
|
+
): DeserializeResult {
|
|
131
|
+
const warnings: string[] = [];
|
|
132
|
+
const idMap = new Map<string, string>();
|
|
133
|
+
|
|
134
|
+
if (file.format !== DDSCENE_FORMAT) {
|
|
135
|
+
throw new Error(`Not a .ddscene document (format="${file.format}")`);
|
|
136
|
+
}
|
|
137
|
+
if (file.version > DDSCENE_VERSION) {
|
|
138
|
+
throw new Error(
|
|
139
|
+
`.ddscene version ${file.version} is newer than this engine supports (${DDSCENE_VERSION})`,
|
|
140
|
+
);
|
|
141
|
+
}
|
|
142
|
+
|
|
143
|
+
// Clear the current document contents.
|
|
144
|
+
for (const entity of doc.entities()) {
|
|
145
|
+
world.despawn(entity);
|
|
146
|
+
scene.removeEntity(entity);
|
|
147
|
+
}
|
|
148
|
+
world.flushCommands();
|
|
149
|
+
doc.resetMeta(file.name);
|
|
150
|
+
|
|
151
|
+
// Pass 1: spawn entities + components.
|
|
152
|
+
const spawned = new Map<string, Entity>(); // fileId → Entity
|
|
153
|
+
file.entities.forEach((entry) => {
|
|
154
|
+
const components = new Map<number, unknown>();
|
|
155
|
+
for (const [compName, data] of Object.entries(entry.components ?? {})) {
|
|
156
|
+
if (!isRegisteredComponentName(compName)) {
|
|
157
|
+
warnings.push(`entity "${entry.id}": unknown component "${compName}" — skipped`);
|
|
158
|
+
continue;
|
|
159
|
+
}
|
|
160
|
+
components.set(getComponentId(compName), sanitizeObject({ ...data }));
|
|
161
|
+
}
|
|
162
|
+
const entity = world.spawn(components);
|
|
163
|
+
scene.trackEntity(entity);
|
|
164
|
+
spawned.set(entry.id, entity);
|
|
165
|
+
const key = `${entity.index}.${entity.generation}`;
|
|
166
|
+
idMap.set(entry.id, key);
|
|
167
|
+
if (entry.name) doc.setEntityName(key, entry.name);
|
|
168
|
+
});
|
|
169
|
+
world.flushCommands();
|
|
170
|
+
|
|
171
|
+
// Pass 2: restore hierarchy (prefab refs resolve in Phase 3 — entries with
|
|
172
|
+
// `prefab` still spawn their own entity shell for now).
|
|
173
|
+
file.entities.forEach((entry) => {
|
|
174
|
+
if (!entry.parent) return;
|
|
175
|
+
const child = spawned.get(entry.id);
|
|
176
|
+
const parent = spawned.get(entry.parent);
|
|
177
|
+
if (child && parent) {
|
|
178
|
+
hierarchy.setParent(child, parent);
|
|
179
|
+
} else {
|
|
180
|
+
warnings.push(`entity "${entry.id}": parent "${entry.parent}" not found — orphaned`);
|
|
181
|
+
}
|
|
182
|
+
});
|
|
183
|
+
|
|
184
|
+
doc.markClean();
|
|
185
|
+
return { warnings, idMap };
|
|
186
|
+
}
|
|
187
|
+
|
|
188
|
+
/**
|
|
189
|
+
* `SceneLoader` — the runtime consumption half. Games call this to spawn a
|
|
190
|
+
* `.ddscene` into their own World/Hierarchy. Returns the fileId→Entity map
|
|
191
|
+
* so games can resolve authored references.
|
|
192
|
+
*/
|
|
193
|
+
export function instantiateScene(
|
|
194
|
+
file: DdSceneFile,
|
|
195
|
+
deps: { world: World; scene?: Scene; hierarchy?: Hierarchy },
|
|
196
|
+
): DeserializeResult & { entities: Map<string, Entity> } {
|
|
197
|
+
const warnings: string[] = [];
|
|
198
|
+
const idMap = new Map<string, string>();
|
|
199
|
+
const spawned = new Map<string, Entity>();
|
|
200
|
+
|
|
201
|
+
if (file.format !== DDSCENE_FORMAT) {
|
|
202
|
+
throw new Error(`Not a .ddscene document (format="${file.format}")`);
|
|
203
|
+
}
|
|
204
|
+
|
|
205
|
+
file.entities.forEach((entry) => {
|
|
206
|
+
const components = new Map<number, unknown>();
|
|
207
|
+
for (const [compName, data] of Object.entries(entry.components ?? {})) {
|
|
208
|
+
if (!isRegisteredComponentName(compName)) {
|
|
209
|
+
warnings.push(`entity "${entry.id}": unknown component "${compName}" — skipped`);
|
|
210
|
+
continue;
|
|
211
|
+
}
|
|
212
|
+
components.set(getComponentId(compName), sanitizeObject({ ...data }));
|
|
213
|
+
}
|
|
214
|
+
const entity = deps.world.spawn(components);
|
|
215
|
+
deps.scene?.trackEntity(entity);
|
|
216
|
+
spawned.set(entry.id, entity);
|
|
217
|
+
idMap.set(entry.id, `${entity.index}.${entity.generation}`);
|
|
218
|
+
});
|
|
219
|
+
deps.world.flushCommands();
|
|
220
|
+
|
|
221
|
+
file.entities.forEach((entry) => {
|
|
222
|
+
if (!entry.parent || !deps.hierarchy) return;
|
|
223
|
+
const child = spawned.get(entry.id);
|
|
224
|
+
const parent = spawned.get(entry.parent);
|
|
225
|
+
if (child && parent) deps.hierarchy.setParent(child, parent);
|
|
226
|
+
});
|
|
227
|
+
|
|
228
|
+
return { warnings, idMap, entities: spawned };
|
|
229
|
+
}
|
|
230
|
+
|
|
231
|
+
// ── Diff ──
|
|
232
|
+
|
|
233
|
+
export interface SceneDiff {
|
|
234
|
+
added: string[];
|
|
235
|
+
removed: string[];
|
|
236
|
+
changed: string[];
|
|
237
|
+
}
|
|
238
|
+
|
|
239
|
+
/** Structural diff between two serialized scenes (entity id + JSON-equal
|
|
240
|
+
* component data). Used by `editor_diff` and by tests verifying round-trips. */
|
|
241
|
+
export function diffScenes(a: DdSceneFile, b: DdSceneFile): SceneDiff {
|
|
242
|
+
const aMap = new Map(a.entities.map((e) => [e.id, e]));
|
|
243
|
+
const bMap = new Map(b.entities.map((e) => [e.id, e]));
|
|
244
|
+
const diff: SceneDiff = { added: [], removed: [], changed: [] };
|
|
245
|
+
|
|
246
|
+
bMap.forEach((ent, id) => {
|
|
247
|
+
const prev = aMap.get(id);
|
|
248
|
+
if (!prev) { diff.added.push(id); return; }
|
|
249
|
+
if (JSON.stringify(prev.components) !== JSON.stringify(ent.components)
|
|
250
|
+
|| prev.parent !== ent.parent
|
|
251
|
+
|| prev.name !== ent.name) {
|
|
252
|
+
diff.changed.push(id);
|
|
253
|
+
}
|
|
254
|
+
});
|
|
255
|
+
aMap.forEach((_, id) => {
|
|
256
|
+
if (!bMap.has(id)) diff.removed.push(id);
|
|
257
|
+
});
|
|
258
|
+
return diff;
|
|
259
|
+
}
|
|
260
|
+
|
|
261
|
+
export function parseDdScene(text: string): DdSceneFile {
|
|
262
|
+
const data = JSON.parse(text) as DdSceneFile;
|
|
263
|
+
if (data.format !== DDSCENE_FORMAT) {
|
|
264
|
+
throw new Error(`Not a .ddscene document (format="${(data as { format?: string }).format}")`);
|
|
265
|
+
}
|
|
266
|
+
return data;
|
|
267
|
+
}
|
|
@@ -0,0 +1,123 @@
|
|
|
1
|
+
// ============================================================================
|
|
2
|
+
// EditorDocument — the design-world document the editor edits.
|
|
3
|
+
//
|
|
4
|
+
// Wraps the EngineContext's Scene/World/Hierarchy plus editor-owned metadata
|
|
5
|
+
// (display names, file path, dirty state). Commands mutate the world through
|
|
6
|
+
// this document; the `.ddscene` serializer (ddscene.ts) round-trips it to
|
|
7
|
+
// disk.
|
|
8
|
+
//
|
|
9
|
+
// Display names are document metadata, not a component — games are free to
|
|
10
|
+
// have their own "name" component; the editor's name is authoring chrome.
|
|
11
|
+
// ============================================================================
|
|
12
|
+
|
|
13
|
+
import { isAlive, type Entity, type Scene, type World } from "@downdraft/engine";
|
|
14
|
+
|
|
15
|
+
export type DocumentChangeKind =
|
|
16
|
+
| "structure" // entity spawned/removed/reparented
|
|
17
|
+
| "data" // component data changed
|
|
18
|
+
| "meta" // names/flags changed
|
|
19
|
+
| "file"; // opened/saved (path + dirty reset)
|
|
20
|
+
|
|
21
|
+
export interface DocumentChange {
|
|
22
|
+
kind: DocumentChangeKind;
|
|
23
|
+
entity?: string;
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
export class EditorDocument {
|
|
27
|
+
name: string;
|
|
28
|
+
filePath: string | null = null;
|
|
29
|
+
|
|
30
|
+
private scene: Scene;
|
|
31
|
+
private names = new Map<string, string>();
|
|
32
|
+
private dirty = false;
|
|
33
|
+
private version = 0;
|
|
34
|
+
private listeners = new Set<(change: DocumentChange) => void>();
|
|
35
|
+
|
|
36
|
+
constructor(scene: Scene, name?: string) {
|
|
37
|
+
this.scene = scene;
|
|
38
|
+
this.name = name ?? scene.name;
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
get world(): World {
|
|
42
|
+
return this.scene.world;
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
get entityCount(): number {
|
|
46
|
+
return this.scene.getEntityCount();
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
key(entity: Entity): string {
|
|
50
|
+
return `${entity.index}.${entity.generation}`;
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
parse(key: string): Entity | null {
|
|
54
|
+
const parts = key.split(".");
|
|
55
|
+
if (parts.length !== 2) return null;
|
|
56
|
+
const index = parseInt(parts[0]!, 10);
|
|
57
|
+
const generation = parseInt(parts[1]!, 10);
|
|
58
|
+
if (Number.isNaN(index) || Number.isNaN(generation)) return null;
|
|
59
|
+
return { index, generation };
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
isAliveKey(key: string): boolean {
|
|
63
|
+
const e = this.parse(key);
|
|
64
|
+
return e !== null && isAlive(this.world.entities, e);
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
/** All live entities tracked by the document's scene. */
|
|
68
|
+
entities(): Entity[] {
|
|
69
|
+
return this.scene.getEntities();
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
entityKeys(): string[] {
|
|
73
|
+
return this.entities().map((e) => this.key(e));
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
entityName(key: string): string | undefined {
|
|
77
|
+
return this.names.get(key);
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
setEntityName(key: string, name: string | undefined): void {
|
|
81
|
+
if (name === undefined || name === "") this.names.delete(key);
|
|
82
|
+
else this.names.set(key, name);
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
/** Display label: authored name if present, else `Entity <key>`. */
|
|
86
|
+
label(key: string): string {
|
|
87
|
+
return this.names.get(key) ?? `Entity ${key}`;
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
/** Reset all editor metadata (called when a new doc is loaded in place). */
|
|
91
|
+
resetMeta(name: string): void {
|
|
92
|
+
this.names.clear();
|
|
93
|
+
this.name = name;
|
|
94
|
+
this.filePath = null;
|
|
95
|
+
this.dirty = false;
|
|
96
|
+
this.version++;
|
|
97
|
+
}
|
|
98
|
+
|
|
99
|
+
isDirty(): boolean {
|
|
100
|
+
return this.dirty;
|
|
101
|
+
}
|
|
102
|
+
|
|
103
|
+
getVersion(): number {
|
|
104
|
+
return this.version;
|
|
105
|
+
}
|
|
106
|
+
|
|
107
|
+
markDirty(change: DocumentChange): void {
|
|
108
|
+
this.dirty = true;
|
|
109
|
+
this.version++;
|
|
110
|
+
this.listeners.forEach((fn) => fn(change));
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
markClean(): void {
|
|
114
|
+
this.dirty = false;
|
|
115
|
+
this.version++;
|
|
116
|
+
this.listeners.forEach((fn) => fn({ kind: "file" }));
|
|
117
|
+
}
|
|
118
|
+
|
|
119
|
+
onChange(fn: (change: DocumentChange) => void): () => void {
|
|
120
|
+
this.listeners.add(fn);
|
|
121
|
+
return () => this.listeners.delete(fn);
|
|
122
|
+
}
|
|
123
|
+
}
|
|
@@ -0,0 +1,172 @@
|
|
|
1
|
+
// ============================================================================
|
|
2
|
+
// EditorContext — the editor's backend object.
|
|
3
|
+
//
|
|
4
|
+
// Composes an `EngineContext` (the standalone editing world from
|
|
5
|
+
// `@downdraft/engine/mcp`: World + Scene + GameWorld + Hierarchy +
|
|
6
|
+
// AssetManager + MaterialLibrary + CheckpointManager + SaveSystem +
|
|
7
|
+
// UndoRedoManager) with editor session state: the `EditorDocument`,
|
|
8
|
+
// `SelectionModel`, `EditorCommandRegistry`, and filesystem access.
|
|
9
|
+
//
|
|
10
|
+
// Design-document mode (Phase 0–5): the EngineContext is standalone — the
|
|
11
|
+
// editor owns a private World/Scene on the main thread and the game's
|
|
12
|
+
// renderer maps entities to visuals via an `EditorSceneAdapter`.
|
|
13
|
+
// Live-sim mode (Phase 6) swaps in `EngineContext.fromGame()` backed by the
|
|
14
|
+
// game's world — the command layer above doesn't change.
|
|
15
|
+
// ============================================================================
|
|
16
|
+
|
|
17
|
+
import type { Entity } from "@downdraft/engine";
|
|
18
|
+
import { EngineContext } from "@downdraft/engine/mcp";
|
|
19
|
+
|
|
20
|
+
import { EditorCommandRegistry } from "./commands/registry";
|
|
21
|
+
import { EditorDocument } from "./document";
|
|
22
|
+
import { SelectionModel } from "./selection";
|
|
23
|
+
|
|
24
|
+
// ── Filesystem abstraction ──
|
|
25
|
+
// The editor runs in the JS runtime process (Bun/Node/Deno), so `node:fs`
|
|
26
|
+
// covers all hosts — but it is lazy-imported so the module stays loadable in
|
|
27
|
+
// non-node test contexts. `createNodeFs()` resolves at call time.
|
|
28
|
+
|
|
29
|
+
export interface EditorFs {
|
|
30
|
+
readText(path: string): Promise<string>;
|
|
31
|
+
writeText(path: string, text: string): Promise<void>;
|
|
32
|
+
exists(path: string): Promise<boolean>;
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
export function createNodeFs(): EditorFs {
|
|
36
|
+
return {
|
|
37
|
+
async readText(path: string): Promise<string> {
|
|
38
|
+
const fs = await import("node:fs/promises");
|
|
39
|
+
return fs.readFile(path, "utf8");
|
|
40
|
+
},
|
|
41
|
+
async writeText(path: string, text: string): Promise<void> {
|
|
42
|
+
const fs = await import("node:fs/promises");
|
|
43
|
+
await fs.writeFile(path, text, "utf8");
|
|
44
|
+
},
|
|
45
|
+
async exists(path: string): Promise<boolean> {
|
|
46
|
+
const fs = await import("node:fs/promises");
|
|
47
|
+
try {
|
|
48
|
+
await fs.access(path);
|
|
49
|
+
return true;
|
|
50
|
+
} catch {
|
|
51
|
+
return false;
|
|
52
|
+
}
|
|
53
|
+
},
|
|
54
|
+
};
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
// ── Scene adapter (game-provided visual bridge) ──
|
|
58
|
+
// The design world is pure ECS data; the adapter maps entities to whatever
|
|
59
|
+
// the game uses to draw them (ModelRenderer, custom passes). Phase 0 is
|
|
60
|
+
// headless — no adapter is required. Phase 1 ships the generic adapter.
|
|
61
|
+
|
|
62
|
+
export interface EditorRay {
|
|
63
|
+
origin: [number, number, number];
|
|
64
|
+
dir: [number, number, number];
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
export interface EditorSceneAdapter {
|
|
68
|
+
/** Push an entity's visual state to the renderer (spawn/update). */
|
|
69
|
+
syncEntity?(entityKey: string): void;
|
|
70
|
+
/** Remove an entity's visual. */
|
|
71
|
+
removeEntity?(entityKey: string): void;
|
|
72
|
+
/**
|
|
73
|
+
* Pick: screen-space pointer position → entity key, or null. The adapter
|
|
74
|
+
* owns the camera, so it computes the world ray itself.
|
|
75
|
+
*/
|
|
76
|
+
pickAt?(x: number, y: number, w: number, h: number): string | null;
|
|
77
|
+
/** World-space bounds for framing/marquee/outline. */
|
|
78
|
+
bounds?(entityKey: string): { min: [number, number, number]; max: [number, number, number] } | null;
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
export interface EditorContextOptions {
|
|
82
|
+
/** Provide a pre-built EngineContext (e.g. `EngineContext.fromGame()` for
|
|
83
|
+
* live-world editing). When omitted a standalone design world is created. */
|
|
84
|
+
engine?: EngineContext;
|
|
85
|
+
sceneName?: string;
|
|
86
|
+
fs?: EditorFs | null;
|
|
87
|
+
adapter?: EditorSceneAdapter;
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
export class EditorContext {
|
|
91
|
+
readonly engine: EngineContext;
|
|
92
|
+
readonly document: EditorDocument;
|
|
93
|
+
readonly selection: SelectionModel;
|
|
94
|
+
readonly commands: EditorCommandRegistry;
|
|
95
|
+
readonly fs: EditorFs | null;
|
|
96
|
+
adapter: EditorSceneAdapter | null;
|
|
97
|
+
/**
|
|
98
|
+
* Entity key produced by the most recent `entity.restore` — lets
|
|
99
|
+
* `hierarchy.setParentToRestore` in the same undo batch re-parent
|
|
100
|
+
* children to the restored (new) key. Internal; not for public use.
|
|
101
|
+
*/
|
|
102
|
+
lastRestoredKey: string | null = null;
|
|
103
|
+
/**
|
|
104
|
+
* Entity keys are physical ("index.generation") — despawn frees the slot
|
|
105
|
+
* and respawn yields a different key. `entity.restore` registers an
|
|
106
|
+
* alias oldKey→newKey here so journaled inverses and params carrying a
|
|
107
|
+
* stale key keep resolving (redo after an undo-remove relies on this).
|
|
108
|
+
*/
|
|
109
|
+
private keyAliases = new Map<string, string>();
|
|
110
|
+
/** Component name the transform commands read/write. Games with a
|
|
111
|
+
* differently-named transform component can override via module config. */
|
|
112
|
+
transformComponent = "transform";
|
|
113
|
+
|
|
114
|
+
constructor(opts: EditorContextOptions = {}) {
|
|
115
|
+
this.engine = opts.engine ?? new EngineContext({ sceneName: opts.sceneName ?? "editor-scene" });
|
|
116
|
+
this.document = new EditorDocument(this.engine.scene, opts.sceneName ?? this.engine.scene.name);
|
|
117
|
+
this.selection = new SelectionModel();
|
|
118
|
+
this.commands = new EditorCommandRegistry(this);
|
|
119
|
+
this.fs = opts.fs === undefined ? createNodeFs() : opts.fs;
|
|
120
|
+
this.adapter = opts.adapter ?? null;
|
|
121
|
+
|
|
122
|
+
// Document dirty tracking: any applied mutating command dirties the doc
|
|
123
|
+
// unless it opts out via `marksDirty: false` — file-state commands
|
|
124
|
+
// (scene.save/open/new) call markClean themselves, and auto-dirtying
|
|
125
|
+
// after dispatch would stomp the clean flag.
|
|
126
|
+
this.commands.onDispatched((entry) => {
|
|
127
|
+
const cmd = this.commands.get(entry.command);
|
|
128
|
+
if (cmd?.mutating && cmd.marksDirty !== false) {
|
|
129
|
+
this.document.markDirty({ kind: "data", entity: entry.params["entity"] as string | undefined });
|
|
130
|
+
}
|
|
131
|
+
});
|
|
132
|
+
}
|
|
133
|
+
|
|
134
|
+
// ── Entity helpers (delegate to engine + document) ──
|
|
135
|
+
|
|
136
|
+
key(entity: Entity): string {
|
|
137
|
+
return this.document.key(entity);
|
|
138
|
+
}
|
|
139
|
+
|
|
140
|
+
/** Follow the restore-alias chain for a possibly stale entity key. */
|
|
141
|
+
resolveKey(key: string): string {
|
|
142
|
+
let k = key;
|
|
143
|
+
const seen = new Set<string>();
|
|
144
|
+
while (this.keyAliases.has(k) && !seen.has(k)) {
|
|
145
|
+
seen.add(k);
|
|
146
|
+
k = this.keyAliases.get(k)!;
|
|
147
|
+
}
|
|
148
|
+
return k;
|
|
149
|
+
}
|
|
150
|
+
|
|
151
|
+
/** Record that oldKey now refers to newKey (entity restored under a new id). */
|
|
152
|
+
registerKeyAlias(oldKey: string, newKey: string): void {
|
|
153
|
+
if (oldKey !== newKey) this.keyAliases.set(oldKey, newKey);
|
|
154
|
+
}
|
|
155
|
+
|
|
156
|
+
clearKeyAliases(): void {
|
|
157
|
+
this.keyAliases.clear();
|
|
158
|
+
}
|
|
159
|
+
|
|
160
|
+
parseEntity(key: string): Entity | null {
|
|
161
|
+
return this.document.parse(this.resolveKey(key));
|
|
162
|
+
}
|
|
163
|
+
|
|
164
|
+
isAliveKey(key: string): boolean {
|
|
165
|
+
return this.document.isAliveKey(this.resolveKey(key));
|
|
166
|
+
}
|
|
167
|
+
|
|
168
|
+
dispose(): void {
|
|
169
|
+
// No timers/subscriptions held yet — placeholder for adapter teardown,
|
|
170
|
+
// autosave timers, and the UI shell.
|
|
171
|
+
}
|
|
172
|
+
}
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
// @downdraft/engine/modules/editor — public API
|
|
2
|
+
export { createEditorModule, EditorModuleTok } from "./module";
|
|
3
|
+
export type { EditorModuleConfig } from "./module";
|
|
4
|
+
|
|
5
|
+
export { createNodeFs, EditorContext } from "./editor-context";
|
|
6
|
+
export type { EditorContextOptions, EditorFs, EditorRay, EditorSceneAdapter } from "./editor-context";
|
|
7
|
+
|
|
8
|
+
export { EditorDocument } from "./document";
|
|
9
|
+
export type { DocumentChange, DocumentChangeKind } from "./document";
|
|
10
|
+
|
|
11
|
+
export { SelectionModel } from "./selection";
|
|
12
|
+
|
|
13
|
+
export { EditorCommandError, EditorCommandRegistry } from "./commands/registry";
|
|
14
|
+
export type {
|
|
15
|
+
CommandInvocation,
|
|
16
|
+
CommandOutcome,
|
|
17
|
+
EditorCommand,
|
|
18
|
+
EditorCommandSource,
|
|
19
|
+
EditorParamSchema,
|
|
20
|
+
JournalEntry
|
|
21
|
+
} from "./commands/registry";
|
|
22
|
+
|
|
23
|
+
export { registerDefaultCommands } from "./commands/index";
|
|
24
|
+
|
|
25
|
+
export { DEFAULT_LAYOUT, EditorShell } from "./shell";
|
|
26
|
+
export type { EditorShellLayout, GizmoModeName } from "./shell";
|
|
27
|
+
|
|
28
|
+
export { EditorViewport } from "./viewport";
|
|
29
|
+
|
|
30
|
+
export {
|
|
31
|
+
DDSCENE_FORMAT,
|
|
32
|
+
DDSCENE_VERSION,
|
|
33
|
+
deserializeIntoDocument,
|
|
34
|
+
diffScenes,
|
|
35
|
+
instantiateScene,
|
|
36
|
+
parseDdScene,
|
|
37
|
+
serializeDocument
|
|
38
|
+
} from "./ddscene";
|
|
39
|
+
export type { DdSceneEntity, DdSceneFile, DeserializeResult, SceneDiff } from "./ddscene";
|
|
40
|
+
|
|
41
|
+
export { createEditorMcpTools, editorMcpTools, getEditorContext } from "./mcp";
|