@certe/atmos-editor 0.1.0

package/dist/bootstrap/start-player.js

@@ -0,0 +1,205 @@
+import { Engine, Scene, registerCoreBuiltins, deserializeScene, applyPostProcess } from '@certe/atmos-core';
+import { initWebGPU, createRenderPipeline, createDefaultCamera, createDirectionalLight, RenderSystem, MeshRenderer, Camera, registerRendererBuiltins, resizeGPU, createMesh, SKINNED_VERTEX_STRIDE_FLOATS, } from '@certe/atmos-renderer';
+import { Vec3 } from '@certe/atmos-math';
+import { parseGltfModel } from '@certe/atmos-assets';
+import { registerAnimationBuiltins } from '@certe/atmos-animation';
+import { createGeometryCache } from './geometry-cache.js';
+import { createDefaultDeserializeContext } from './default-factories.js';
+import { discoverScripts } from '../script-discovery.js';
+import { SimpleMaterialLoader } from '../simple-material-loader.js';
+export async function startPlayer(config) {
+    const cleanups = [];
+    const assetBase = config.assetBase ?? '/';
+    // 1. Register builtins
+    registerCoreBuiltins();
+    registerRendererBuiltins();
+    registerAnimationBuiltins();
+    // 2. Discover user scripts
+    if (config.scriptModules) {
+        discoverScripts(config.scriptModules);
+    }
+    // 3. Canvas + WebGPU (prefer existing DOM element, then config, then create)
+    const canvas = config.canvas
+        ?? document.getElementById('atmos-canvas')
+        ?? createFullscreenCanvas();
+    const gpu = await initWebGPU(canvas);
+    const pipeline = createRenderPipeline(gpu.device, gpu.format);
+    const resizeObs = new ResizeObserver(() => resizeGPU(gpu));
+    resizeObs.observe(canvas);
+    cleanups.push(() => resizeObs.disconnect());
+    // 4. Geometry cache
+    const meshes = createGeometryCache(gpu.device);
+    // 5. Physics plugin init (optional)
+    if (config.physics) {
+        config.physics.init({
+            meshes,
+            getMesh(go) {
+                const mr = go.getComponent(MeshRenderer);
+                return mr?.mesh ?? null;
+            },
+        });
+    }
+    // 6. Scene + camera + light + render system
+    const scene = new Scene();
+    const camera = createDefaultCamera();
+    Vec3.set(camera.eye, 3, 4, 8);
+    Vec3.set(camera.target, 0, 1, 0);
+    const light = createDirectionalLight([-0.5, -1.0, -0.3], [1, 1, 1], 1.0);
+    const renderSystem = new RenderSystem(gpu, pipeline, scene, camera, light);
+    // 7. Physics stepper (optional)
+    let physicsSystem = null;
+    if (config.physics) {
+        physicsSystem = config.physics.createStepper(scene);
+    }
+    // 8. Material loader
+    const materialLoader = new SimpleMaterialLoader(gpu.device, assetBase);
+    // 9. Model loading helpers
+    const modelCache = new Map();
+    const loadModelAsset = async (filePath) => {
+        let asset = modelCache.get(filePath);
+        if (!asset) {
+            const res = await fetch(assetBase + filePath);
+            if (!res.ok)
+                return null;
+            asset = parseGltfModel(await res.arrayBuffer());
+            modelCache.set(filePath, asset);
+        }
+        return asset;
+    };
+    const parseModelSource = (source) => {
+        const rest = source.slice(6);
+        const lastColon = rest.lastIndexOf(':');
+        if (lastColon < 0)
+            return null;
+        return { path: rest.slice(0, lastColon), index: parseInt(rest.slice(lastColon + 1), 10) };
+    };
+    const loadModelMesh = async (source) => {
+        const parsed = parseModelSource(source);
+        if (!parsed)
+            return null;
+        const asset = await loadModelAsset(parsed.path);
+        if (!asset)
+            return null;
+        const meshData = asset.meshes[parsed.index];
+        if (!meshData)
+            return null;
+        const stride = meshData.skinned ? SKINNED_VERTEX_STRIDE_FLOATS : 8;
+        const mesh = createMesh(gpu.device, meshData.geometry.vertices, meshData.geometry.indices, stride);
+        mesh.bounds = meshData.geometry.bounds;
+        return { mesh, skinned: meshData.skinned, skinIndex: meshData.skinIndex };
+    };
+    const loadModelData = async (source) => {
+        const parsed = parseModelSource(source);
+        if (!parsed)
+            return null;
+        const asset = await loadModelAsset(parsed.path);
+        if (!asset)
+            return null;
+        const meshData = asset.meshes[parsed.index];
+        if (!meshData)
+            return null;
+        const stride = meshData.skinned ? SKINNED_VERTEX_STRIDE_FLOATS : 8;
+        const mesh = createMesh(gpu.device, meshData.geometry.vertices, meshData.geometry.indices, stride);
+        mesh.bounds = meshData.geometry.bounds;
+        return { mesh, asset, meshIndex: parsed.index };
+    };
+    // 10. Deserialize context (reuses default-factories)
+    const lazyMM = { current: materialLoader };
+    const factoryDeps = {
+        rendererCtx: renderSystem,
+        meshes,
+        physics: config.physics,
+        editorState: { current: null },
+        materialManager: lazyMM,
+        loadModelMesh,
+        loadModelData,
+    };
+    const deserializeCtx = createDefaultDeserializeContext(factoryDeps);
+    // 11. Fetch + deserialize scene
+    const sceneRes = await fetch(assetBase + config.scene);
+    if (!sceneRes.ok)
+        throw new Error(`Failed to fetch scene: ${config.scene}`);
+    const sceneData = JSON.parse(await sceneRes.text());
+    const loadedScene = deserializeScene(sceneData, deserializeCtx);
+    if (deserializeCtx.onComplete)
+        await deserializeCtx.onComplete();
+    // 12. Switch render system to loaded scene + activate camera
+    renderSystem.scene = loadedScene;
+    const mainCam = Camera.getMain(loadedScene);
+    if (mainCam) {
+        renderSystem.activeCamera = mainCam;
+    }
+    // 13. Apply post-process settings
+    if (sceneData.postProcess) {
+        applyPostProcess(renderSystem, sceneData.postProcess);
+    }
+    // 14. Engine setup
+    if (physicsSystem)
+        physicsSystem.scene = loadedScene;
+    const engine = new Engine();
+    engine.setRenderer(renderSystem);
+    if (physicsSystem)
+        engine.setPhysics(physicsSystem);
+    engine.input.attach(window);
+    cleanups.push(() => engine.input.detach());
+    // 15. Scene loader for runtime scene switching
+    Scene.setSceneLoader(async (name) => {
+        const scenePath = `scenes/${name}.scene.json`;
+        try {
+            const res = await fetch(assetBase + scenePath);
+            if (!res.ok)
+                throw new Error(`${res.status}`);
+            const data = JSON.parse(await res.text());
+            const newScene = deserializeScene(data, deserializeCtx);
+            if (deserializeCtx.onComplete)
+                await deserializeCtx.onComplete();
+            renderSystem.scene = newScene;
+            engine.scene = newScene;
+            if (physicsSystem)
+                physicsSystem.scene = newScene;
+            config.physics?.onSceneChanged(newScene);
+            if (data.postProcess) {
+                applyPostProcess(renderSystem, data.postProcess);
+            }
+            const cam = Camera.getMain(newScene);
+            if (cam)
+                renderSystem.activeCamera = cam;
+            newScene.awakeAll();
+            newScene.startAll();
+        }
+        catch (err) {
+            console.error(`[Player] Failed to load scene "${name}":`, err);
+        }
+    });
+    cleanups.push(() => Scene.setSceneLoader(null));
+    // 16. Start engine
+    engine.start(loadedScene);
+    return {
+        engine,
+        renderSystem,
+        scene: loadedScene,
+        dispose() {
+            engine.stop();
+            for (const fn of cleanups)
+                fn();
+            cleanups.length = 0;
+        },
+    };
+}
+function createFullscreenCanvas() {
+    const canvas = document.createElement('canvas');
+    canvas.id = 'atmos-player-canvas';
+    Object.assign(canvas.style, {
+        position: 'fixed',
+        top: '0',
+        left: '0',
+        width: '100%',
+        height: '100%',
+        display: 'block',
+    });
+    document.body.style.margin = '0';
+    document.body.style.overflow = 'hidden';
+    document.body.appendChild(canvas);
+    return canvas;
+}
+//# sourceMappingURL=start-player.js.map

package/dist/bootstrap/start-player.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-player.js","sourceRoot":"","sources":["../../src/bootstrap/start-player.ts"],"names":[],"mappings":"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"}

package/dist/bootstrap/types.d.ts

@@ -0,0 +1,160 @@
+import type { Component, Engine, Scene, GameObject, DeserializeContext, PhysicsStepper } from '@certe/atmos-core';
+import type { GPUContext, PipelineResources, Mesh, RenderSystem } from '@certe/atmos-renderer';
+import type { EditorState } from '../editor-state.js';
+import type { GizmoState } from '../gizmo-state.js';
+import type { OrbitCamera } from '../orbit-camera.js';
+import type { ProjectFileSystem } from '../project-fs.js';
+import type { MaterialManager } from '../material-manager.js';
+import type { PrimitiveType } from '../editor-mount.js';
+import type { ScriptAsset } from '../asset-types.js';
+import type { PhysicsSettings } from '../project-settings.js';
+/** Data for rendering joint axis gizmos. Positions/directions in world space. */
+export interface JointGizmoData {
+    /** World-space anchor position on body 1. */
+    origin1: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    /** World-space axis direction on body 1 (unit vector). */
+    dir1: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    /** World-space anchor position on body 2. */
+    origin2: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    /** World-space axis direction on body 2 (unit vector). */
+    dir2: {
+        x: number;
+        y: number;
+        z: number;
+    };
+}
+/** Data for rendering collider wireframe gizmos. Positions/rotations in world space. */
+export interface ColliderGizmoData {
+    shapeType: 'box' | 'sphere' | 'capsule' | 'cylinder';
+    position: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    rotation: {
+        x: number;
+        y: number;
+        z: number;
+        w: number;
+    };
+    halfExtents?: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    radius?: number;
+    halfHeight?: number;
+}
+/** Minimal mesh interface for collider auto-sizing (avoids importing @certe/atmos-renderer in physics) */
+export interface MeshLike {
+    vertices?: Float32Array;
+    vertexStride?: number;
+}
+/** Context provided to the physics plugin during initialization. */
+export interface PhysicsInitContext {
+    /** Named primitive meshes — keys: cube, plane, sphere, cylinder */
+    meshes: Record<string, unknown>;
+    /** Read MeshRenderer.mesh from a GameObject without importing @certe/atmos-renderer */
+    getMesh(go: GameObject): MeshLike | null;
+}
+/** Physics plugin interface. @certe/atmos-physics provides createEditorPhysics() that returns this. */
+export interface EditorPhysicsPlugin {
+    /** Initialize: map meshes to collider shapes. */
+    init(ctx: PhysicsInitContext): void;
+    /** Create a physics stepper for the given scene. */
+    createStepper(scene: Scene): PhysicsStepper & {
+        scene: Scene;
+    };
+    /** Check if a component can be added. Returns null if OK, or a reason string. */
+    canAddComponent(ctor: new () => Component, go: GameObject): string | null;
+    /** Try adding a physics component. Returns true if handled. */
+    handleAddComponent(ctor: new () => Component, go: GameObject): boolean;
+    /** Try removing a physics component. Returns true if handled. */
+    handleRemoveComponent(comp: Component, go: GameObject): boolean;
+    /** Try deserializing a physics component. Returns true if handled. */
+    handleDeserialize(go: GameObject, type: string, data: Record<string, unknown>, deferred: Array<() => void>): boolean;
+    /** Flush deferred operations (e.g. joint connectedObject). */
+    flushDeferred(ops: Array<() => void>): void;
+    /** Initialize physics components on a duplicated GameObject (copy) using the source as reference. */
+    handleDuplicate(copy: GameObject, source: GameObject): void;
+    /** Install reparent validator + callback for nested-RigidBody prevention. */
+    installReparentHooks(setValidator: (fn: ((child: GameObject, newParent: GameObject | null) => boolean) | null) => void, setCallback: (fn: ((child: GameObject) => void) | null) => void): void;
+    /** Sync physics system when scene changes. */
+    onSceneChanged(scene: Scene): void;
+    /** Returns true if the component belongs to the physics plugin (RigidBody, Collider, Joint). */
+    isPhysicsComponent(comp: Component): boolean;
+    /** Teleport RigidBodies after play-mode snapshot restore. */
+    onSceneRestored(scene: Scene): void;
+    /** Get joint axis gizmo data for a selected GameObject, or null if it has no hinge joints. */
+    getJointGizmoData(go: GameObject): JointGizmoData[] | null;
+    /** Get collider wireframe gizmo data for a selected GameObject, or null if it has no colliders. */
+    getColliderGizmoData(go: GameObject): ColliderGizmoData[] | null;
+    /** Recreate joints on/connected-to the given objects so auto-configured anchors/axes update. */
+    syncJointsForObjects?(objects: readonly GameObject[]): void;
+    /** Push transform changes (scale→collider, position→fixed body) while engine is paused. */
+    syncTransformsForObjects?(objects: readonly GameObject[]): void;
+    /** Recreate all auto-configured joints in the scene (e.g. before first physics step). */
+    syncAllJoints?(scene: Scene): void;
+    /** Apply project-wide physics settings to the physics world. */
+    applyPhysicsSettings?(settings: PhysicsSettings): void;
+}
+/** Context provided to the setupScene callback. */
+export interface SceneSetupContext {
+    scene: Scene;
+    gpu: GPUContext;
+    pipeline: PipelineResources;
+    meshes: Record<Exclude<PrimitiveType, 'camera' | 'directionalLight' | 'pointLight' | 'spotLight'>, Mesh>;
+}
+export interface EditorConfig {
+    /** Canvas element to render into. Created automatically if omitted. */
+    canvas?: HTMLCanvasElement;
+    /** Container element for the React editor UI. Created automatically if omitted. */
+    container?: HTMLElement;
+    /** Optional physics plugin (from @certe/atmos-physics createEditorPhysics()). */
+    physics?: EditorPhysicsPlugin;
+    /** Optional callback to populate the initial scene. */
+    setupScene?: (ctx: SceneSetupContext) => void;
+    /** User script assets to register in the editor. */
+    scripts?: ScriptAsset[];
+    /** Raw eager-loaded modules from import.meta.glob(). Processed internally via discoverScripts(). */
+    scriptModules?: Record<string, Record<string, unknown>>;
+    /** Override the default primitive factory. */
+    primitiveFactory?: (type: PrimitiveType, name: string) => GameObject;
+    /** Override the default component factory. */
+    componentFactory?: (ctor: new () => Component, go: GameObject) => void;
+    /** Override the default deserialize context. */
+    deserializeContext?: DeserializeContext;
+    /** Show asset browser panel. Default: true. */
+    showAssetBrowser?: boolean;
+    /** Callback invoked when a script is attached to a GameObject. */
+    onAttachScript?: (script: ScriptAsset, go: GameObject) => void;
+}
+/** Return value of startEditor(). */
+export interface EditorApp {
+    editorState: EditorState;
+    engine: Engine;
+    gizmoState: GizmoState | undefined;
+    orbitCamera: OrbitCamera | undefined;
+    renderSystem: RenderSystem;
+    scene: Scene;
+    gpu: GPUContext;
+    projectFs: ProjectFileSystem;
+    materialManager: MaterialManager | null;
+    /** Open a project directory (shows picker). After opening, seeds + creates MaterialManager. */
+    openProject(): Promise<boolean>;
+    /** Tear down everything and stop the engine. */
+    dispose(): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/bootstrap/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/bootstrap/types.ts"],"names":[],"mappings":"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"}

package/dist/bootstrap/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/bootstrap/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/bootstrap/types.ts"],"names":[],"mappings":""}

package/dist/camera-frustum-renderer.d.ts

@@ -0,0 +1,15 @@
+import { Camera } from '@certe/atmos-renderer';
+export declare class CameraFrustumRenderer {
+    private readonly _device;
+    private readonly _pipeline;
+    private readonly _vertexBuffer;
+    private readonly _indexBuffer;
+    private readonly _uniformBuffer;
+    private readonly _bindGroup;
+    private readonly _verts;
+    private readonly _mvp;
+    constructor(device: GPUDevice, format: GPUTextureFormat);
+    render(pass: GPURenderPassEncoder, vp: Float32Array, camera: Camera, aspect: number): void;
+    destroy(): void;
+}
+//# sourceMappingURL=camera-frustum-renderer.d.ts.map

package/dist/camera-frustum-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera-frustum-renderer.d.ts","sourceRoot":"","sources":["../src/camera-frustum-renderer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAuB,MAAM,uBAAuB,CAAC;AAkCpE,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAY;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAY;IAC1C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAY;IACzC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAY;IAC3C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAe;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoD;IAC3E,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA2B;gBAEpC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB;IA8BvD,MAAM,CACJ,IAAI,EAAE,oBAAoB,EAC1B,EAAE,EAAE,YAAY,EAChB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,IAAI;IAyCP,OAAO,IAAI,IAAI;CAKhB"}

package/dist/camera-frustum-renderer.js

@@ -0,0 +1,110 @@
+import { Mat4 } from '@certe/atmos-math';
+import { createUnlitPipeline } from '@certe/atmos-renderer';
+/** Fixed distance for the far-plane visualization (keeps the frustum compact). */
+const FAR_VIZ = 5;
+/** Frustum wireframe color (light cyan). */
+const COLOR = [0.45, 0.7, 1.0];
+/** 6 floats per vertex: position(3) + color(3). */
+const FLOATS_PER_VERT = 6;
+/**
+ * 8 corner vertices (4 near + 4 far).
+ * Index order per plane (looking from camera toward -Z):
+ *   0=TL  1=TR  2=BR  3=BL  (near)
+ *   4=TL  5=TR  6=BR  7=BL  (far)
+ */
+const VERTEX_COUNT = 8;
+const VERTEX_BUFFER_SIZE = VERTEX_COUNT * FLOATS_PER_VERT * 4; // bytes
+/** 12 lines × 2 indices = 24 indices (line-list). */
+// prettier-ignore
+const INDICES = new Uint16Array([
+    // near rectangle
+    0, 1, 1, 2, 2, 3, 3, 0,
+    // far rectangle
+    4, 5, 5, 6, 6, 7, 7, 4,
+    // connecting edges
+    0, 4, 1, 5, 2, 6, 3, 7,
+]);
+const UNIFORM_SIZE = 64; // mat4x4
+export class CameraFrustumRenderer {
+    _device;
+    _pipeline;
+    _vertexBuffer;
+    _indexBuffer;
+    _uniformBuffer;
+    _bindGroup;
+    _verts = new Float32Array(VERTEX_COUNT * FLOATS_PER_VERT);
+    _mvp = Mat4.create();
+    constructor(device, format) {
+        this._device = device;
+        this._pipeline = createUnlitPipeline(device, format, {
+            topology: 'line-list',
+            depthWrite: false,
+            depthCompare: 'always',
+        });
+        this._vertexBuffer = device.createBuffer({
+            size: VERTEX_BUFFER_SIZE,
+            usage: GPUBufferUsage.VERTEX | GPUBufferUsage.COPY_DST,
+        });
+        this._indexBuffer = device.createBuffer({
+            size: INDICES.byteLength,
+            usage: GPUBufferUsage.INDEX | GPUBufferUsage.COPY_DST,
+        });
+        device.queue.writeBuffer(this._indexBuffer, 0, INDICES);
+        this._uniformBuffer = device.createBuffer({
+            size: UNIFORM_SIZE,
+            usage: GPUBufferUsage.UNIFORM | GPUBufferUsage.COPY_DST,
+        });
+        this._bindGroup = device.createBindGroup({
+            layout: this._pipeline.bindGroupLayout,
+            entries: [{ binding: 0, resource: { buffer: this._uniformBuffer } }],
+        });
+    }
+    render(pass, vp, camera, aspect) {
+        const farViz = FAR_VIZ;
+        const halfFov = camera.fovY * 0.5;
+        const tanHalf = Math.tan(halfFov);
+        const hNear = camera.near * tanHalf;
+        const wNear = hNear * aspect;
+        const hFar = farViz * tanHalf;
+        const wFar = hFar * aspect;
+        const [r, g, b] = COLOR;
+        const v = this._verts;
+        let o = 0;
+        // Near plane corners (TL, TR, BR, BL) at z = -near
+        const nz = -camera.near;
+        o = writeVert(v, o, -wNear, hNear, nz, r, g, b);
+        o = writeVert(v, o, wNear, hNear, nz, r, g, b);
+        o = writeVert(v, o, wNear, -hNear, nz, r, g, b);
+        o = writeVert(v, o, -wNear, -hNear, nz, r, g, b);
+        // Far plane corners (TL, TR, BR, BL) at z = -farViz
+        const fz = -farViz;
+        o = writeVert(v, o, -wFar, hFar, fz, r, g, b);
+        o = writeVert(v, o, wFar, hFar, fz, r, g, b);
+        o = writeVert(v, o, wFar, -hFar, fz, r, g, b);
+        writeVert(v, o, -wFar, -hFar, fz, r, g, b);
+        this._device.queue.writeBuffer(this._vertexBuffer, 0, v);
+        // MVP = VP × cameraWorldMatrix (vertices are in camera-local space)
+        Mat4.multiply(this._mvp, vp, camera.gameObject.transform.worldMatrix);
+        this._device.queue.writeBuffer(this._uniformBuffer, 0, this._mvp);
+        pass.setPipeline(this._pipeline.pipeline);
+        pass.setBindGroup(0, this._bindGroup);
+        pass.setVertexBuffer(0, this._vertexBuffer);
+        pass.setIndexBuffer(this._indexBuffer, 'uint16');
+        pass.drawIndexed(INDICES.length);
+    }
+    destroy() {
+        this._vertexBuffer.destroy();
+        this._indexBuffer.destroy();
+        this._uniformBuffer.destroy();
+    }
+}
+function writeVert(buf, offset, x, y, z, r, g, b) {
+    buf[offset] = x;
+    buf[offset + 1] = y;
+    buf[offset + 2] = z;
+    buf[offset + 3] = r;
+    buf[offset + 4] = g;
+    buf[offset + 5] = b;
+    return offset + FLOATS_PER_VERT;
+}
+//# sourceMappingURL=camera-frustum-renderer.js.map

package/dist/camera-frustum-renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera-frustum-renderer.js","sourceRoot":"","sources":["../src/camera-frustum-renderer.ts"],"names":[],"mappings":"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"}

package/dist/camera-presets.d.ts

@@ -0,0 +1,10 @@
+import type { OrbitCamera } from './orbit-camera.js';
+import type { CameraSettings } from '@certe/atmos-renderer';
+export interface CameraPreset {
+    name: string;
+    azimuth: number;
+    elevation: number;
+}
+export declare const CAMERA_PRESETS: CameraPreset[];
+export declare function applyCameraPreset(orbit: OrbitCamera, preset: CameraPreset, camera: CameraSettings): void;
+//# sourceMappingURL=camera-presets.d.ts.map

package/dist/camera-presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera-presets.d.ts","sourceRoot":"","sources":["../src/camera-presets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,eAAO,MAAM,cAAc,EAAE,YAAY,EAOxC,CAAC;AAEF,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,cAAc,GACrB,IAAI,CAIN"}

package/dist/camera-presets.js

@@ -0,0 +1,15 @@
+const DEG = Math.PI / 180;
+export const CAMERA_PRESETS = [
+    { name: 'Front', azimuth: 0, elevation: 0 },
+    { name: 'Back', azimuth: 180 * DEG, elevation: 0 },
+    { name: 'Left', azimuth: -90 * DEG, elevation: 0 },
+    { name: 'Right', azimuth: 90 * DEG, elevation: 0 },
+    { name: 'Top', azimuth: 0, elevation: 89 * DEG },
+    { name: 'Bottom', azimuth: 0, elevation: -89 * DEG },
+];
+export function applyCameraPreset(orbit, preset, camera) {
+    orbit.azimuth = preset.azimuth;
+    orbit.elevation = preset.elevation;
+    orbit.applyToCamera(camera);
+}
+//# sourceMappingURL=camera-presets.js.map

package/dist/camera-presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera-presets.js","sourceRoot":"","sources":["../src/camera-presets.ts"],"names":[],"mappings":"AASA,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,GAAG,GAAG,CAAC;AAE1B,MAAM,CAAC,MAAM,cAAc,GAAmB;IAC5C,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE;IAC3C,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,GAAG,EAAE,SAAS,EAAE,CAAC,EAAE;IAClD,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG,GAAG,EAAE,SAAS,EAAE,CAAC,EAAE;IAClD,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,GAAG,GAAG,EAAE,SAAS,EAAE,CAAC,EAAE;IAClD,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,GAAG,GAAG,EAAE;IAChD,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,GAAG,GAAG,EAAE;CACrD,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAC/B,KAAkB,EAClB,MAAoB,EACpB,MAAsB;IAEtB,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAC/B,KAAK,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;IACnC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;AAC9B,CAAC"}

package/dist/collider-gizmo-renderer.d.ts

@@ -0,0 +1,13 @@
+import type { ColliderGizmoData } from './bootstrap/types.js';
+export declare class ColliderGizmoRenderer {
+    private readonly _device;
+    private readonly _pipeline;
+    private readonly _vertexBuffer;
+    private readonly _uniformBuffer;
+    private readonly _bindGroup;
+    private readonly _verts;
+    constructor(device: GPUDevice, format: GPUTextureFormat);
+    render(pass: GPURenderPassEncoder, vp: Float32Array, colliders: ColliderGizmoData[]): void;
+    destroy(): void;
+}
+//# sourceMappingURL=collider-gizmo-renderer.d.ts.map

package/dist/collider-gizmo-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collider-gizmo-renderer.d.ts","sourceRoot":"","sources":["../src/collider-gizmo-renderer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAmL9D,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAY;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAY;IAC1C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAY;IAC3C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAe;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiD;gBAE5D,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB;IAwBvD,MAAM,CACJ,IAAI,EAAE,oBAAoB,EAC1B,EAAE,EAAE,YAAY,EAChB,SAAS,EAAE,iBAAiB,EAAE,GAC7B,IAAI;IAgCP,OAAO,IAAI,IAAI;CAIhB"}