@certe/atmos-renderer 0.1.0

package/README.md

@@ -0,0 +1,166 @@
+# 🎨 @certe/atmos-renderer
+
+WebGPU-first rendering package for the Atmos Engine. Handles GPU initialization, PBR shading, multi-light systems, cascaded shadow maps, skeletal animation (GPU skinning), terrain rendering, and a full HDR post-processing pipeline.
+
+---
+
+## 🔑 Key Features
+
+- **PBR Cook-Torrance** shading with albedo, metallic, roughness, normal, and emissive maps
+- **3 light types** — Directional, Point, Spot (up to 4 each)
+- **Cascaded Shadow Maps** (2-cascade CSM) + point cube shadows + spot shadows
+- **HDR pipeline** — MSAA 4× → HDR resolve → Bloom → SSAO → Tonemapping (ACES)
+- **GPU skinning** — separate skinned pipeline with bone matrix storage buffer
+- **Terrain pipeline** — splat-textured terrain with 3-layer blending
+- **Geometry primitives** — cube, sphere, cylinder, plane
+
+---
+
+## 🚀 Quick Start
+
+```ts
+import { initWebGPU, createRenderPipeline, createMesh, createMaterial,
+         RenderSystem, Camera, MeshRenderer, createCubeGeometry } from '@certe/atmos-renderer';
+
+const gpu = await initWebGPU(canvas);
+const pipeline = createRenderPipeline(gpu);
+
+// Create a mesh + material
+const mesh = createMesh(gpu.device, createCubeGeometry());
+const material = createMaterial(gpu.device, pipeline, {
+  albedo: [0.8, 0.2, 0.2, 1],
+  metallic: 0.0,
+  roughness: 0.5,
+});
+
+// Attach to a GameObject
+const cube = new GameObject('Cube');
+const mr = cube.addComponent(MeshRenderer);
+mr.init({ mesh, material, device: gpu.device, pipelineResources: pipeline });
+
+// Render
+const renderSystem = new RenderSystem(gpu, pipeline, scene);
+```
+
+---
+
+## 📖 API Overview
+
+### Initialization
+
+| Function | Description |
+|---|---|
+| `initWebGPU(canvas)` | Request adapter + device, configure canvas |
+| `resizeGPU(gpu)` | Sync canvas pixel size, recreate depth/MSAA/HDR textures |
+| `createRenderPipeline(gpu)` | Create the PBR render pipeline + bind group layouts |
+
+### Geometry & Mesh
+
+| Function | Description |
+|---|---|
+| `createCubeGeometry()` | 32B/vertex (pos+normal+uv) |
+| `createSphereGeometry(seg?)` | Latitude-longitude sphere |
+| `createCylinderGeometry(seg?)` | With top/bottom caps |
+| `createPlaneGeometry(size?)` | XZ plane |
+| `createMesh(device, geo)` | Upload to GPU, retains CPU data for picking |
+
+### Materials
+
+```ts
+const mat = createMaterial(device, pipeline, {
+  albedo: [1, 1, 1, 1],
+  metallic: 0.5,
+  roughness: 0.3,
+  emissive: [1, 0.5, 0],
+  emissiveIntensity: 2.0,
+});
+// Textures: mat.albedoTexture, mat.normalTexture, mat.metallicRoughnessTexture
+```
+
+### Lights
+
+```ts
+// Add as components to GameObjects
+const light = obj.addComponent(DirectionalLight);
+light.color = new Float32Array([1, 1, 1]);
+light.intensity = 1.5;
+light.castShadows = true;
+
+obj.addComponent(PointLight);   // color, intensity, range
+obj.addComponent(SpotLight);    // + innerAngle, outerAngle
+```
+
+### Camera
+
+```ts
+const cam = obj.addComponent(Camera);
+cam.fov = 60;
+cam.near = 0.1;
+cam.far = 1000;
+
+// Screen-to-world unprojection
+const worldPos = Camera.screenToWorldPoint(sx, sy, depth, camera, canvas);
+```
+
+### Post-Processing
+
+The RenderSystem exposes controls for the full post-fx chain:
+
+| Property | Default | Description |
+|---|---|---|
+| `exposure` | `1.0` | Pre-tonemap multiplier |
+| `bloomIntensity` | `0.04` | Bloom strength |
+| `bloomThreshold` | `1.0` | HDR threshold for bloom |
+| `ssaoEnabled` | `false` | Toggle SSAO |
+| `ssaoRadius` / `ssaoBias` / `ssaoIntensity` | — | SSAO tuning |
+| `vignetteIntensity` / `vignetteRadius` | — | Screen-edge darkening |
+
+### Render Pipeline Flow
+
+```
+Depth Pre-pass
+Shadow Passes (CSM × 2 + Point + Spot)
+Main Pass (MSAA 4× → HDR resolve)
+SSAO (half-res, 16 samples)
+Bloom (5-level downsample/upsample)
+Tonemap (ACES + gamma 2.2 + vignette) → Swapchain
+```
+
+---
+
+## 📁 Structure
+
+```
+packages/renderer/src/
+  index.ts                # Public API
+  pipeline.ts             # PBR pipeline, constants (HDR_FORMAT, MSAA_SAMPLE_COUNT)
+  shader.ts               # PBR WGSL vertex + fragment shaders
+  material.ts             # Material creation + uniform writes
+  camera.ts               # Camera component
+  render-system.ts        # Frame orchestration
+  directional-light.ts    # DirectionalLight component
+  point-light.ts          # PointLight component
+  spot-light.ts           # SpotLight component
+  geometry.ts             # Primitive factories
+  mesh.ts                 # GPU mesh creation
+  mesh-renderer.ts        # MeshRenderer component
+  skinned-pipeline.ts     # GPU skinning pipeline
+  skinned-mesh-renderer.ts # SkinnedMeshRenderer component
+  bloom-pass.ts           # 5-level bloom
+  tonemap-pass.ts         # ACES tonemapping + vignette
+  ssao-pass.ts            # Screen-space ambient occlusion
+  depth-prepass.ts        # Non-MSAA depth for SSAO
+  directional-shadow-pass.ts # Cascaded shadow maps
+  point-shadow-pass.ts    # Cube shadow maps
+  spot-shadow-pass.ts     # Spot light shadows
+  texture.ts              # Texture creation + decoding
+  mipmap-generator.ts     # Blit-based mipmap generation
+  grid-renderer.ts        # Infinite XZ grid overlay
+```
+
+---
+
+## 🔗 Dependencies
+
+- `@certe/atmos-core` — Component, GameObject, Transform, Scene
+- `@certe/atmos-math` — Vec3, Mat4, Quat for camera/light math

package/dist/bloom-pass.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Bloom post-processing pass.
+ * Downsample chain: HDR → 1/2 → 1/4 → 1/8 → 1/16 (threshold on first pass).
+ * Upsample chain: 1/16 → 1/8 → 1/4 → 1/2 → full (additive blend).
+ * Output: full-res bloom texture.
+ */
+export declare class BloomPass {
+    threshold: number;
+    intensity: number;
+    radius: number;
+    private readonly _device;
+    private readonly _downPipeline;
+    private readonly _upPipeline;
+    private readonly _sampler;
+    private readonly _downBGL;
+    private readonly _upBGL;
+    private readonly _paramsBuffer;
+    private readonly _paramsData;
+    private _mipTextures;
+    private _mipViews;
+    private _width;
+    private _height;
+    constructor(device: GPUDevice);
+    private _ensureMips;
+    /** Execute bloom and return the bloom texture view to be composited with HDR scene. */
+    execute(encoder: GPUCommandEncoder, hdrTexture: GPUTexture): GPUTextureView;
+    destroy(): void;
+}
+//# sourceMappingURL=bloom-pass.d.ts.map

package/dist/bloom-pass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bloom-pass.d.ts","sourceRoot":"","sources":["../src/bloom-pass.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,qBAAa,SAAS;IACpB,SAAS,SAAO;IAChB,SAAS,SAAO;IAChB,MAAM,SAAO;IAEb,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAY;IACpC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAoB;IAClD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoB;IAChD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAa;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAY;IAE1C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuB;IAEnD,OAAO,CAAC,YAAY,CAAoB;IACxC,OAAO,CAAC,SAAS,CAAwB;IACzC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,OAAO,CAAK;gBAER,MAAM,EAAE,SAAS;IAyD7B,OAAO,CAAC,WAAW;IAwBnB,uFAAuF;IACvF,OAAO,CAAC,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,UAAU,GAAG,cAAc;IA4E3E,OAAO,IAAI,IAAI;CAIhB"}

package/dist/bloom-pass.js

@@ -0,0 +1,173 @@
+/**
+ * Bloom post-processing pass.
+ * Downsample chain: HDR → 1/2 → 1/4 → 1/8 → 1/16 (threshold on first pass).
+ * Upsample chain: 1/16 → 1/8 → 1/4 → 1/2 → full (additive blend).
+ * Output: full-res bloom texture.
+ */
+import { BLOOM_DOWNSAMPLE_SHADER, BLOOM_UPSAMPLE_SHADER } from './bloom-shader.js';
+import { drawFullscreenTriangle } from './fullscreen-quad.js';
+const HDR_FORMAT = 'rgba16float';
+const MIP_COUNT = 5;
+export class BloomPass {
+    threshold = 1.0;
+    intensity = 0.5;
+    radius = 0.5;
+    _device;
+    _downPipeline;
+    _upPipeline;
+    _sampler;
+    _downBGL;
+    _upBGL;
+    _paramsBuffer;
+    _paramsData = new Float32Array(4);
+    _mipTextures = [];
+    _mipViews = [];
+    _width = 0;
+    _height = 0;
+    constructor(device) {
+        this._device = device;
+        this._sampler = device.createSampler({
+            minFilter: 'linear',
+            magFilter: 'linear',
+        });
+        this._paramsBuffer = device.createBuffer({
+            size: 16,
+            usage: GPUBufferUsage.UNIFORM | GPUBufferUsage.COPY_DST,
+        });
+        // Bind group layouts (identical for both: texture + sampler + params)
+        this._downBGL = device.createBindGroupLayout({
+            entries: [
+                { binding: 0, visibility: GPUShaderStage.FRAGMENT, texture: { sampleType: 'float' } },
+                { binding: 1, visibility: GPUShaderStage.FRAGMENT, sampler: { type: 'filtering' } },
+                { binding: 2, visibility: GPUShaderStage.FRAGMENT, buffer: { type: 'uniform' } },
+            ],
+        });
+        this._upBGL = device.createBindGroupLayout({
+            entries: [
+                { binding: 0, visibility: GPUShaderStage.FRAGMENT, texture: { sampleType: 'float' } },
+                { binding: 1, visibility: GPUShaderStage.FRAGMENT, sampler: { type: 'filtering' } },
+                { binding: 2, visibility: GPUShaderStage.FRAGMENT, buffer: { type: 'uniform' } },
+            ],
+        });
+        const downModule = device.createShaderModule({ code: BLOOM_DOWNSAMPLE_SHADER });
+        const upModule = device.createShaderModule({ code: BLOOM_UPSAMPLE_SHADER });
+        this._downPipeline = device.createRenderPipeline({
+            layout: device.createPipelineLayout({ bindGroupLayouts: [this._downBGL] }),
+            vertex: { module: downModule, entryPoint: 'vs' },
+            fragment: { module: downModule, entryPoint: 'fs', targets: [{ format: HDR_FORMAT }] },
+            primitive: { topology: 'triangle-list' },
+        });
+        this._upPipeline = device.createRenderPipeline({
+            layout: device.createPipelineLayout({ bindGroupLayouts: [this._upBGL] }),
+            vertex: { module: upModule, entryPoint: 'vs' },
+            fragment: {
+                module: upModule,
+                entryPoint: 'fs',
+                targets: [{
+                        format: HDR_FORMAT,
+                        blend: {
+                            color: { srcFactor: 'one', dstFactor: 'one', operation: 'add' },
+                            alpha: { srcFactor: 'one', dstFactor: 'one', operation: 'add' },
+                        },
+                    }],
+            },
+            primitive: { topology: 'triangle-list' },
+        });
+    }
+    _ensureMips(w, h) {
+        if (this._width === w && this._height === h)
+            return;
+        this._width = w;
+        this._height = h;
+        for (const tex of this._mipTextures)
+            tex.destroy();
+        this._mipTextures = [];
+        this._mipViews = [];
+        let mw = Math.max(1, Math.floor(w / 2));
+        let mh = Math.max(1, Math.floor(h / 2));
+        for (let i = 0; i < MIP_COUNT; i++) {
+            const tex = this._device.createTexture({
+                size: { width: mw, height: mh },
+                format: HDR_FORMAT,
+                usage: GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.RENDER_ATTACHMENT,
+            });
+            this._mipTextures.push(tex);
+            this._mipViews.push(tex.createView());
+            mw = Math.max(1, Math.floor(mw / 2));
+            mh = Math.max(1, Math.floor(mh / 2));
+        }
+    }
+    /** Execute bloom and return the bloom texture view to be composited with HDR scene. */
+    execute(encoder, hdrTexture) {
+        const w = hdrTexture.width;
+        const h = hdrTexture.height;
+        this._ensureMips(w, h);
+        const hdrView = hdrTexture.createView();
+        // --- Downsample chain ---
+        for (let i = 0; i < MIP_COUNT; i++) {
+            const srcView = i === 0 ? hdrView : this._mipViews[i - 1];
+            const isFirst = i === 0 ? 1.0 : 0.0;
+            this._paramsData[0] = this.threshold;
+            this._paramsData[1] = isFirst;
+            this._paramsData[2] = 0;
+            this._paramsData[3] = 0;
+            this._device.queue.writeBuffer(this._paramsBuffer, 0, this._paramsData);
+            const bg = this._device.createBindGroup({
+                layout: this._downBGL,
+                entries: [
+                    { binding: 0, resource: srcView },
+                    { binding: 1, resource: this._sampler },
+                    { binding: 2, resource: { buffer: this._paramsBuffer } },
+                ],
+            });
+            const pass = encoder.beginRenderPass({
+                colorAttachments: [{
+                        view: this._mipViews[i],
+                        loadOp: 'clear',
+                        storeOp: 'store',
+                        clearValue: { r: 0, g: 0, b: 0, a: 0 },
+                    }],
+            });
+            pass.setPipeline(this._downPipeline);
+            pass.setBindGroup(0, bg);
+            drawFullscreenTriangle(pass);
+            pass.end();
+        }
+        // --- Upsample chain (additive blend) ---
+        for (let i = MIP_COUNT - 2; i >= 0; i--) {
+            const srcView = this._mipViews[i + 1];
+            this._paramsData[0] = this.radius;
+            this._paramsData[1] = 0;
+            this._paramsData[2] = 0;
+            this._paramsData[3] = 0;
+            this._device.queue.writeBuffer(this._paramsBuffer, 0, this._paramsData);
+            const bg = this._device.createBindGroup({
+                layout: this._upBGL,
+                entries: [
+                    { binding: 0, resource: srcView },
+                    { binding: 1, resource: this._sampler },
+                    { binding: 2, resource: { buffer: this._paramsBuffer } },
+                ],
+            });
+            const pass = encoder.beginRenderPass({
+                colorAttachments: [{
+                        view: this._mipViews[i],
+                        loadOp: 'load',
+                        storeOp: 'store',
+                    }],
+            });
+            pass.setPipeline(this._upPipeline);
+            pass.setBindGroup(0, bg);
+            drawFullscreenTriangle(pass);
+            pass.end();
+        }
+        // Return the largest bloom mip (half-res)
+        return this._mipViews[0];
+    }
+    destroy() {
+        for (const tex of this._mipTextures)
+            tex.destroy();
+        this._paramsBuffer.destroy();
+    }
+}
+//# sourceMappingURL=bloom-pass.js.map

package/dist/bloom-pass.js.map

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

package/dist/bloom-shader.d.ts

@@ -0,0 +1,9 @@
+/**
+ * WGSL shaders for bloom post-processing.
+ * Uses shared fullscreen triangle vertex shader.
+ * Downsample applies a bright threshold on the first pass.
+ * Upsample blends additively with the previous mip level.
+ */
+export declare const BLOOM_DOWNSAMPLE_SHADER: string;
+export declare const BLOOM_UPSAMPLE_SHADER: string;
+//# sourceMappingURL=bloom-shader.d.ts.map

package/dist/bloom-shader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bloom-shader.d.ts","sourceRoot":"","sources":["../src/bloom-shader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,eAAO,MAAM,uBAAuB,QAoCnC,CAAC;AAEF,eAAO,MAAM,qBAAqB,QAuBjC,CAAC"}

package/dist/bloom-shader.js

@@ -0,0 +1,69 @@
+/**
+ * WGSL shaders for bloom post-processing.
+ * Uses shared fullscreen triangle vertex shader.
+ * Downsample applies a bright threshold on the first pass.
+ * Upsample blends additively with the previous mip level.
+ */
+import { FULLSCREEN_VERTEX_SHADER } from './fullscreen-quad.js';
+export const BLOOM_DOWNSAMPLE_SHADER = FULLSCREEN_VERTEX_SHADER + /* wgsl */ `
+@group(0) @binding(0) var srcTexture: texture_2d<f32>;
+@group(0) @binding(1) var srcSampler: sampler;
+@group(0) @binding(2) var<uniform> params: vec4<f32>; // x=threshold, y=isFirstPass
+
+@fragment
+fn fs(@location(0) uv: vec2<f32>) -> @location(0) vec4<f32> {
+  let dims = vec2<f32>(textureDimensions(srcTexture, 0));
+  let texelSize = 1.0 / dims;
+
+  // 13-tap downsampling filter (anti-firefly, from Call of Duty presentation)
+  var color = textureSample(srcTexture, srcSampler, uv) * 0.125;
+  color += textureSample(srcTexture, srcSampler, uv + vec2(-1.0, -1.0) * texelSize) * 0.03125;
+  color += textureSample(srcTexture, srcSampler, uv + vec2( 1.0, -1.0) * texelSize) * 0.03125;
+  color += textureSample(srcTexture, srcSampler, uv + vec2(-1.0,  1.0) * texelSize) * 0.03125;
+  color += textureSample(srcTexture, srcSampler, uv + vec2( 1.0,  1.0) * texelSize) * 0.03125;
+
+  color += textureSample(srcTexture, srcSampler, uv + vec2(-2.0,  0.0) * texelSize) * 0.0625;
+  color += textureSample(srcTexture, srcSampler, uv + vec2( 2.0,  0.0) * texelSize) * 0.0625;
+  color += textureSample(srcTexture, srcSampler, uv + vec2( 0.0, -2.0) * texelSize) * 0.0625;
+  color += textureSample(srcTexture, srcSampler, uv + vec2( 0.0,  2.0) * texelSize) * 0.0625;
+
+  color += textureSample(srcTexture, srcSampler, uv + vec2(-2.0, -2.0) * texelSize) * 0.03125;
+  color += textureSample(srcTexture, srcSampler, uv + vec2( 2.0, -2.0) * texelSize) * 0.03125;
+  color += textureSample(srcTexture, srcSampler, uv + vec2(-2.0,  2.0) * texelSize) * 0.03125;
+  color += textureSample(srcTexture, srcSampler, uv + vec2( 2.0,  2.0) * texelSize) * 0.03125;
+
+  // Apply threshold on first pass only
+  if (params.y > 0.5) {
+    let brightness = max(color.r, max(color.g, color.b));
+    let contribution = max(brightness - params.x, 0.0) / max(brightness, 0.0001);
+    color = vec4(color.rgb * contribution, color.a);
+  }
+
+  return color;
+}
+`;
+export const BLOOM_UPSAMPLE_SHADER = FULLSCREEN_VERTEX_SHADER + /* wgsl */ `
+@group(0) @binding(0) var srcTexture: texture_2d<f32>;
+@group(0) @binding(1) var srcSampler: sampler;
+@group(0) @binding(2) var<uniform> params: vec4<f32>; // x=radius
+
+@fragment
+fn fs(@location(0) uv: vec2<f32>) -> @location(0) vec4<f32> {
+  let dims = vec2<f32>(textureDimensions(srcTexture, 0));
+  let texelSize = params.x / dims;
+
+  // 9-tap tent filter for smooth upsampling
+  var color = textureSample(srcTexture, srcSampler, uv + vec2(-1.0, -1.0) * texelSize);
+  color += textureSample(srcTexture, srcSampler, uv + vec2( 0.0, -1.0) * texelSize) * 2.0;
+  color += textureSample(srcTexture, srcSampler, uv + vec2( 1.0, -1.0) * texelSize);
+  color += textureSample(srcTexture, srcSampler, uv + vec2(-1.0,  0.0) * texelSize) * 2.0;
+  color += textureSample(srcTexture, srcSampler, uv) * 4.0;
+  color += textureSample(srcTexture, srcSampler, uv + vec2( 1.0,  0.0) * texelSize) * 2.0;
+  color += textureSample(srcTexture, srcSampler, uv + vec2(-1.0,  1.0) * texelSize);
+  color += textureSample(srcTexture, srcSampler, uv + vec2( 0.0,  1.0) * texelSize) * 2.0;
+  color += textureSample(srcTexture, srcSampler, uv + vec2( 1.0,  1.0) * texelSize);
+
+  return color / 16.0;
+}
+`;
+//# sourceMappingURL=bloom-shader.js.map

package/dist/bloom-shader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bloom-shader.js","sourceRoot":"","sources":["../src/bloom-shader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAEhE,MAAM,CAAC,MAAM,uBAAuB,GAAG,wBAAwB,GAAG,UAAU,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoC3E,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG,wBAAwB,GAAG,UAAU,CAAA;;;;;;;;;;;;;;;;;;;;;;;CAuBzE,CAAC"}

package/dist/bounds.d.ts

@@ -0,0 +1,10 @@
+export interface BoundingSphere {
+    center: Float32Array;
+    radius: number;
+}
+/**
+ * Compute a bounding sphere from interleaved vertex data.
+ * Reads position from the first 3 floats of each vertex.
+ */
+export declare function computeBoundingSphere(vertices: Float32Array, stride: number): BoundingSphere;
+//# sourceMappingURL=bounds.d.ts.map

package/dist/bounds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounds.d.ts","sourceRoot":"","sources":["../src/bounds.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,YAAY,EACtB,MAAM,EAAE,MAAM,GACb,cAAc,CAiChB"}

package/dist/bounds.js

@@ -0,0 +1,37 @@
+/**
+ * Compute a bounding sphere from interleaved vertex data.
+ * Reads position from the first 3 floats of each vertex.
+ */
+export function computeBoundingSphere(vertices, stride) {
+    const vertCount = Math.floor(vertices.length / stride);
+    if (vertCount === 0) {
+        return { center: new Float32Array(3), radius: 0 };
+    }
+    // Compute centroid
+    let cx = 0, cy = 0, cz = 0;
+    for (let i = 0; i < vertCount; i++) {
+        const o = i * stride;
+        cx += vertices[o];
+        cy += vertices[o + 1];
+        cz += vertices[o + 2];
+    }
+    cx /= vertCount;
+    cy /= vertCount;
+    cz /= vertCount;
+    // Find max distance from centroid
+    let maxDist2 = 0;
+    for (let i = 0; i < vertCount; i++) {
+        const o = i * stride;
+        const dx = vertices[o] - cx;
+        const dy = vertices[o + 1] - cy;
+        const dz = vertices[o + 2] - cz;
+        const dist2 = dx * dx + dy * dy + dz * dz;
+        if (dist2 > maxDist2)
+            maxDist2 = dist2;
+    }
+    return {
+        center: new Float32Array([cx, cy, cz]),
+        radius: Math.sqrt(maxDist2),
+    };
+}
+//# sourceMappingURL=bounds.js.map

package/dist/bounds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounds.js","sourceRoot":"","sources":["../src/bounds.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAAsB,EACtB,MAAc;IAEd,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IACvD,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;QACpB,OAAO,EAAE,MAAM,EAAE,IAAI,YAAY,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IACpD,CAAC;IAED,mBAAmB;IACnB,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC;QACrB,EAAE,IAAI,QAAQ,CAAC,CAAC,CAAE,CAAC;QACnB,EAAE,IAAI,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;QACvB,EAAE,IAAI,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;IACzB,CAAC;IACD,EAAE,IAAI,SAAS,CAAC;IAChB,EAAE,IAAI,SAAS,CAAC;IAChB,EAAE,IAAI,SAAS,CAAC;IAEhB,kCAAkC;IAClC,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC;QACrB,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAE,GAAG,EAAE,CAAC;QAC7B,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAE,GAAG,EAAE,CAAC;QACjC,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAE,GAAG,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;QAC1C,IAAI,KAAK,GAAG,QAAQ;YAAE,QAAQ,GAAG,KAAK,CAAC;IACzC,CAAC;IAED,OAAO;QACL,MAAM,EAAE,IAAI,YAAY,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QACtC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;KAC5B,CAAC;AACJ,CAAC"}

package/dist/camera.d.ts

@@ -0,0 +1,31 @@
+import { Component, Scene } from '@certe/atmos-core';
+import type { Mat4Type } from '@certe/atmos-math';
+/** Loose interface to avoid circular import with RenderSystem. */
+export interface ScreenToWorldProvider {
+    screenToWorldPoint(x: number, y: number, nearClip?: number): Promise<Float32Array | null>;
+}
+export declare class Camera extends Component {
+    fovY: number;
+    near: number;
+    far: number;
+    isMainCamera: boolean;
+    clearColor: Float32Array<ArrayBuffer>;
+    /** Set by RenderSystem when it activates a camera. */
+    static _renderSystem: ScreenToWorldProvider | null;
+    private readonly _viewMatrix;
+    get viewMatrix(): Mat4Type;
+    /** Compute view matrix as inverse of the camera's world transform. */
+    updateViewMatrix(): void;
+    /** Extract world-space position from the worldMatrix translation column. */
+    getWorldPosition(out: Float32Array): Float32Array;
+    /**
+     * Convert screen pixel coordinates to a world-space point using GPU depth readback.
+     * Returns null if the pixel is sky (depth >= 1.0) or closer than nearClip.
+     */
+    screenToWorldPoint(x: number, y: number, nearClip?: number): Promise<Float32Array | null>;
+    /** Shortcut: get the main camera from the currently active scene. */
+    static get main(): Camera | null;
+    /** Find the first enabled Camera with isMainCamera=true in the scene. */
+    static getMain(scene: Scene): Camera | null;
+}
+//# sourceMappingURL=camera.d.ts.map

package/dist/camera.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera.d.ts","sourceRoot":"","sources":["../src/camera.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,kEAAkE;AAClE,MAAM,WAAW,qBAAqB;IACpC,kBAAkB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;CAC3F;AAED,qBAAa,MAAO,SAAQ,SAAS;IACnC,IAAI,SAAe;IACnB,IAAI,SAAO;IACX,GAAG,SAAO;IACV,YAAY,UAAS;IACrB,UAAU,4BAA4C;IAEtD,sDAAsD;IACtD,MAAM,CAAC,aAAa,EAAE,qBAAqB,GAAG,IAAI,CAAQ;IAE1D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA2B;IAEvD,IAAI,UAAU,IAAI,QAAQ,CAEzB;IAED,sEAAsE;IACtE,gBAAgB,IAAI,IAAI;IAIxB,4EAA4E;IAC5E,gBAAgB,CAAC,GAAG,EAAE,YAAY,GAAG,YAAY;IAQjD;;;OAGG;IACG,kBAAkB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAK/F,qEAAqE;IACrE,MAAM,KAAK,IAAI,IAAI,MAAM,GAAG,IAAI,CAG/B;IAED,yEAAyE;IACzE,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI;CAS5C"}

package/dist/camera.js

@@ -0,0 +1,53 @@
+import { Component, Scene } from '@certe/atmos-core';
+import { Mat4 } from '@certe/atmos-math';
+export class Camera extends Component {
+    fovY = Math.PI / 4;
+    near = 0.1;
+    far = 100;
+    isMainCamera = false;
+    clearColor = new Float32Array([0.05, 0.05, 0.1, 1.0]);
+    /** Set by RenderSystem when it activates a camera. */
+    static _renderSystem = null;
+    _viewMatrix = Mat4.create();
+    get viewMatrix() {
+        return this._viewMatrix;
+    }
+    /** Compute view matrix as inverse of the camera's world transform. */
+    updateViewMatrix() {
+        Mat4.invert(this._viewMatrix, this.gameObject.transform.worldMatrix);
+    }
+    /** Extract world-space position from the worldMatrix translation column. */
+    getWorldPosition(out) {
+        const m = this.gameObject.transform.worldMatrix;
+        out[0] = m[12];
+        out[1] = m[13];
+        out[2] = m[14];
+        return out;
+    }
+    /**
+     * Convert screen pixel coordinates to a world-space point using GPU depth readback.
+     * Returns null if the pixel is sky (depth >= 1.0) or closer than nearClip.
+     */
+    async screenToWorldPoint(x, y, nearClip) {
+        if (!Camera._renderSystem)
+            return null;
+        return Camera._renderSystem.screenToWorldPoint(x, y, nearClip);
+    }
+    /** Shortcut: get the main camera from the currently active scene. */
+    static get main() {
+        if (!Scene.current)
+            return null;
+        return Camera.getMain(Scene.current);
+    }
+    /** Find the first enabled Camera with isMainCamera=true in the scene. */
+    static getMain(scene) {
+        for (const obj of scene.getAllObjects()) {
+            const cam = obj.getComponent(Camera);
+            if (cam && cam.enabled && cam.isMainCamera) {
+                return cam;
+            }
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=camera.js.map

package/dist/camera.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera.js","sourceRoot":"","sources":["../src/camera.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAQzC,MAAM,OAAO,MAAO,SAAQ,SAAS;IACnC,IAAI,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;IACnB,IAAI,GAAG,GAAG,CAAC;IACX,GAAG,GAAG,GAAG,CAAC;IACV,YAAY,GAAG,KAAK,CAAC;IACrB,UAAU,GAAG,IAAI,YAAY,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IAEtD,sDAAsD;IACtD,MAAM,CAAC,aAAa,GAAiC,IAAI,CAAC;IAEzC,WAAW,GAAa,IAAI,CAAC,MAAM,EAAE,CAAC;IAEvD,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,sEAAsE;IACtE,gBAAgB;QACd,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IACvE,CAAC;IAED,4EAA4E;IAC5E,gBAAgB,CAAC,GAAiB;QAChC,MAAM,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,WAAW,CAAC;QAChD,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAE,CAAC;QAChB,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAE,CAAC;QAChB,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAE,CAAC;QAChB,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,kBAAkB,CAAC,CAAS,EAAE,CAAS,EAAE,QAAiB;QAC9D,IAAI,CAAC,MAAM,CAAC,aAAa;YAAE,OAAO,IAAI,CAAC;QACvC,OAAO,MAAM,CAAC,aAAa,CAAC,kBAAkB,CAAC,CAAC,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC;IACjE,CAAC;IAED,qEAAqE;IACrE,MAAM,KAAK,IAAI;QACb,IAAI,CAAC,KAAK,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAChC,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;IAED,yEAAyE;IACzE,MAAM,CAAC,OAAO,CAAC,KAAY;QACzB,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,aAAa,EAAE,EAAE,CAAC;YACxC,MAAM,GAAG,GAAG,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;YACrC,IAAI,GAAG,IAAI,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;gBAC3C,OAAO,GAAG,CAAC;YACb,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC"}

package/dist/depth-prepass.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Non-MSAA depth pre-pass for screen-space effects (SSAO).
+ * Renders scene geometry to a depth32float texture using the camera VP matrix.
+ * The resulting texture has TEXTURE_BINDING so it can be sampled in post-processing.
+ */
+import type { Scene } from '@certe/atmos-core';
+import type { Mat4Type } from '@certe/atmos-math';
+export declare class DepthPrepass {
+    private readonly _device;
+    private readonly _pipeline;
+    private readonly _vpBuffer;
+    private readonly _vpBindGroup;
+    private _depthTexture;
+    private _depthView;
+    private _width;
+    private _height;
+    get depthView(): GPUTextureView;
+    constructor(device: GPUDevice, objectBindGroupLayout: GPUBindGroupLayout, w: number, h: number);
+    private _createTexture;
+    resize(w: number, h: number): void;
+    execute(encoder: GPUCommandEncoder, scene: Scene, cameraVP: Mat4Type, extraDraw?: (pass: GPURenderPassEncoder) => void): void;
+    destroy(): void;
+}
+//# sourceMappingURL=depth-prepass.d.ts.map

package/dist/depth-prepass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"depth-prepass.d.ts","sourceRoot":"","sources":["../src/depth-prepass.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAKlD,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAY;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,UAAU,CAAiB;IACnC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,OAAO,CAAK;IAEpB,IAAI,SAAS,IAAI,cAAc,CAA4B;gBAE/C,MAAM,EAAE,SAAS,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM;IAgD9F,OAAO,CAAC,cAAc;IAQtB,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IASlC,OAAO,CACL,OAAO,EAAE,iBAAiB,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAC5D,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,oBAAoB,KAAK,IAAI,GAC/C,IAAI;IAgCP,OAAO,IAAI,IAAI;CAIhB"}