@certe/atmos-renderer 0.1.0

package/dist/material-asset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"material-asset.js","sourceRoot":"","sources":["../src/material-asset.ts"],"names":[],"mappings":"AAiBA,MAAM,UAAU,0BAA0B,CAAC,IAAY;IACrD,OAAO;QACL,IAAI;QACJ,MAAM,EAAE,KAAK;QACb,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;QAC1B,QAAQ,EAAE,CAAC;QACX,SAAS,EAAE,GAAG;KACf,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,IAAuB;IAC5D,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,IAAY;IACnD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAA4B,CAAC;IACxD,OAAO;QACL,IAAI,EAAG,GAAG,CAAC,MAAM,CAAY,IAAI,SAAS;QAC1C,MAAM,EAAG,GAAG,CAAC,QAAQ,CAAgB,IAAI,KAAK;QAC9C,MAAM,EAAG,GAAG,CAAC,QAAQ,CAAsC,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAC3E,QAAQ,EAAG,GAAG,CAAC,UAAU,CAAY,IAAI,CAAC;QAC1C,SAAS,EAAG,GAAG,CAAC,WAAW,CAAY,IAAI,GAAG;QAC9C,aAAa,EAAG,GAAG,CAAC,eAAe,CAAY,IAAI,SAAS;QAC5D,QAAQ,EAAG,GAAG,CAAC,UAAU,CAA8B,IAAI,SAAS;QACpE,iBAAiB,EAAG,GAAG,CAAC,mBAAmB,CAAY,IAAI,SAAS;QACpE,aAAa,EAAG,GAAG,CAAC,eAAe,CAAY,IAAI,SAAS;QAC5D,wBAAwB,EAAG,GAAG,CAAC,0BAA0B,CAAY,IAAI,SAAS;QAClF,UAAU,EAAG,GAAG,CAAC,YAAY,CAAY,IAAI,SAAS;QACtD,UAAU,EAAG,GAAG,CAAC,YAAY,CAAY,IAAI,SAAS;KACvD,CAAC;AACJ,CAAC"}

package/dist/material.d.ts

@@ -0,0 +1,50 @@
+import type { GPUTextureHandle } from './texture.js';
+export interface MaterialParams {
+    albedo?: [number, number, number, number];
+    metallic?: number;
+    roughness?: number;
+    albedoTexture?: GPUTextureHandle;
+    emissive?: [number, number, number];
+    emissiveIntensity?: number;
+    normalTexture?: GPUTextureHandle;
+    metallicRoughnessTexture?: GPUTextureHandle;
+    splatSharpness?: number;
+    /** Fragments with alpha below this value are discarded. 0 = no cutoff. */
+    alphaCutoff?: number;
+    texTilingX?: number;
+    texTilingY?: number;
+}
+export interface Material {
+    albedo: Float32Array;
+    metallic: number;
+    roughness: number;
+    emissive: Float32Array;
+    emissiveIntensity: number;
+    /** Terrain splat sharpness exponent (1 = linear, higher = sharper). Default 1. */
+    splatSharpness: number;
+    /** Fragments with alpha below this value are discarded. 0 = no cutoff. */
+    alphaCutoff: number;
+    texTilingX: number;
+    texTilingY: number;
+    dirty: boolean;
+    uniformBuffer: GPUBuffer | null;
+    bindGroup: GPUBindGroup | null;
+    albedoTexture: GPUTextureHandle | null;
+    normalTexture: GPUTextureHandle | null;
+    metallicRoughnessTexture: GPUTextureHandle | null;
+    textureVersion: number;
+}
+/**
+ * Bytes: vec4 albedo(16) + f32 metallic(4) + f32 roughness(4) + 8B pad
+ *      + vec4 emissive(16: rgb + intensity in w)
+ *      + vec2 texTiling(8) + 8B pad = 64
+ */
+export declare const MATERIAL_UNIFORM_SIZE = 64;
+export declare function createMaterial(params?: MaterialParams): Material;
+/**
+ * Write material uniforms into a Float32Array for GPU upload.
+ * Layout: [albedo(4), metallic, roughness, splatSharpness, alphaCutoff,
+ *          emissive.rgb(3), emissiveIntensity, texTilingX, texTilingY, pad, pad]
+ */
+export declare function writeMaterialUniforms(out: Float32Array, mat: Material): void;
+//# sourceMappingURL=material.d.ts.map

package/dist/material.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"material.d.ts","sourceRoot":"","sources":["../src/material.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,gBAAgB,CAAC;IACjC,wBAAwB,CAAC,EAAE,gBAAgB,CAAC;IAC5C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,YAAY,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kFAAkF;IAClF,cAAc,EAAE,MAAM,CAAC;IACvB,0EAA0E;IAC1E,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,aAAa,EAAE,SAAS,GAAG,IAAI,CAAC;IAChC,SAAS,EAAE,YAAY,GAAG,IAAI,CAAC;IAC/B,aAAa,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACvC,aAAa,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACvC,wBAAwB,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAClD,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,QAAQ,CAmBhE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,QAAQ,GAAG,IAAI,CAe5E"}

package/dist/material.js

@@ -0,0 +1,48 @@
+/**
+ * Bytes: vec4 albedo(16) + f32 metallic(4) + f32 roughness(4) + 8B pad
+ *      + vec4 emissive(16: rgb + intensity in w)
+ *      + vec2 texTiling(8) + 8B pad = 64
+ */
+export const MATERIAL_UNIFORM_SIZE = 64;
+export function createMaterial(params) {
+    return {
+        albedo: new Float32Array(params?.albedo ?? [1, 1, 1, 1]),
+        metallic: params?.metallic ?? 0.0,
+        roughness: params?.roughness ?? 0.5,
+        emissive: new Float32Array(params?.emissive ?? [0, 0, 0]),
+        emissiveIntensity: params?.emissiveIntensity ?? 0,
+        splatSharpness: params?.splatSharpness ?? 1,
+        alphaCutoff: params?.alphaCutoff ?? 0,
+        texTilingX: params?.texTilingX ?? 1,
+        texTilingY: params?.texTilingY ?? 1,
+        dirty: true,
+        uniformBuffer: null,
+        bindGroup: null,
+        albedoTexture: params?.albedoTexture ?? null,
+        normalTexture: params?.normalTexture ?? null,
+        metallicRoughnessTexture: params?.metallicRoughnessTexture ?? null,
+        textureVersion: 0,
+    };
+}
+/**
+ * Write material uniforms into a Float32Array for GPU upload.
+ * Layout: [albedo(4), metallic, roughness, splatSharpness, alphaCutoff,
+ *          emissive.rgb(3), emissiveIntensity, texTilingX, texTilingY, pad, pad]
+ */
+export function writeMaterialUniforms(out, mat) {
+    out[0] = mat.albedo[0];
+    out[1] = mat.albedo[1];
+    out[2] = mat.albedo[2];
+    out[3] = mat.albedo[3];
+    out[4] = mat.metallic;
+    out[5] = mat.roughness;
+    out[6] = mat.splatSharpness ?? 1;
+    out[7] = mat.alphaCutoff;
+    out[8] = mat.emissive[0];
+    out[9] = mat.emissive[1];
+    out[10] = mat.emissive[2];
+    out[11] = mat.emissiveIntensity;
+    out[12] = mat.texTilingX;
+    out[13] = mat.texTilingY;
+}
+//# sourceMappingURL=material.js.map

package/dist/material.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"material.js","sourceRoot":"","sources":["../src/material.ts"],"names":[],"mappings":"AAuCA;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAC;AAExC,MAAM,UAAU,cAAc,CAAC,MAAuB;IACpD,OAAO;QACL,MAAM,EAAE,IAAI,YAAY,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACxD,QAAQ,EAAE,MAAM,EAAE,QAAQ,IAAI,GAAG;QACjC,SAAS,EAAE,MAAM,EAAE,SAAS,IAAI,GAAG;QACnC,QAAQ,EAAE,IAAI,YAAY,CAAC,MAAM,EAAE,QAAQ,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACzD,iBAAiB,EAAE,MAAM,EAAE,iBAAiB,IAAI,CAAC;QACjD,cAAc,EAAE,MAAM,EAAE,cAAc,IAAI,CAAC;QAC3C,WAAW,EAAE,MAAM,EAAE,WAAW,IAAI,CAAC;QACrC,UAAU,EAAE,MAAM,EAAE,UAAU,IAAI,CAAC;QACnC,UAAU,EAAE,MAAM,EAAE,UAAU,IAAI,CAAC;QACnC,KAAK,EAAE,IAAI;QACX,aAAa,EAAE,IAAI;QACnB,SAAS,EAAE,IAAI;QACf,aAAa,EAAE,MAAM,EAAE,aAAa,IAAI,IAAI;QAC5C,aAAa,EAAE,MAAM,EAAE,aAAa,IAAI,IAAI;QAC5C,wBAAwB,EAAE,MAAM,EAAE,wBAAwB,IAAI,IAAI;QAClE,cAAc,EAAE,CAAC;KAClB,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAAiB,EAAE,GAAa;IACpE,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC;IACxB,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC;IACxB,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC;IACxB,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC;IACxB,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC;IACtB,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,SAAS,CAAC;IACvB,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,cAAc,IAAI,CAAC,CAAC;IACjC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,WAAW,CAAC;IACzB,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC;IAC1B,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC;IAC1B,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC;IAC3B,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,iBAAiB,CAAC;IAChC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC;IACzB,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC;AAC3B,CAAC"}

package/dist/mesh-renderer.d.ts

@@ -0,0 +1,43 @@
+import { Component } from '@certe/atmos-core';
+import type { Mat4Type } from '@certe/atmos-math';
+import type { Mesh } from './mesh.js';
+import type { PipelineResources } from './pipeline.js';
+import type { Material } from './material.js';
+import type { BoundingSphere } from './bounds.js';
+/** Minimal context for MeshRenderer — satisfied by RenderSystem via duck typing. */
+export interface MeshRendererContext {
+    readonly device: GPUDevice;
+    readonly pipelineResources: PipelineResources;
+}
+export declare class MeshRenderer extends Component {
+    mesh: Mesh | null;
+    material: Material | null;
+    meshSource: string;
+    materialSource: string;
+    castShadow: boolean;
+    receiveSSAO: boolean;
+    uniformBuffer: GPUBuffer | null;
+    bindGroup: GPUBindGroup | null;
+    materialBindGroup: GPUBindGroup | null;
+    private _device;
+    private _pipelineResources;
+    private readonly _mvp;
+    private readonly _invModel;
+    private readonly _normalMat;
+    private readonly _matData;
+    private _lastTextureVersion;
+    private readonly _worldBoundsCenter;
+    private readonly _worldBounds;
+    init(ctx: MeshRendererContext, mesh: Mesh, material?: Material): void;
+    /** Lazily initialise GPU buffers if mesh+material exist but init() was never called. */
+    ensureGPU(ctx: MeshRendererContext): void;
+    /** Create material bind group lazily, once the shared scene buffer is available */
+    initMaterialBindGroup(sceneBuffer: GPUBuffer): void;
+    writeUniforms(viewProjection: Mat4Type): void;
+    draw(pass: GPURenderPassEncoder): void;
+    get worldBoundingSphere(): BoundingSphere | null;
+    onDestroy(): void;
+    /** Destroy owned GPU mesh buffers (vertex + index). */
+    destroyMesh(): void;
+}
+//# sourceMappingURL=mesh-renderer.d.ts.map

package/dist/mesh-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mesh-renderer.d.ts","sourceRoot":"","sources":["../src/mesh-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,oFAAoF;AACpF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;CAC/C;AAKD,qBAAa,YAAa,SAAQ,SAAS;IACzC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAQ;IACzB,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAQ;IACjC,UAAU,SAAM;IAChB,cAAc,SAAa;IAC3B,UAAU,UAAQ;IAClB,WAAW,UAAQ;IACnB,aAAa,EAAE,SAAS,GAAG,IAAI,CAAQ;IACvC,SAAS,EAAE,YAAY,GAAG,IAAI,CAAQ;IACtC,iBAAiB,EAAE,YAAY,GAAG,IAAI,CAAQ;IAE9C,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,kBAAkB,CAAkC;IAG5D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA2B;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA2B;IACrD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA2B;IAGtD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+C;IAExE,OAAO,CAAC,mBAAmB,CAAM;IAGjC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAuB;IAC1D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAkE;IAE/F,IAAI,CACF,GAAG,EAAE,mBAAmB,EACxB,IAAI,EAAE,IAAI,EACV,QAAQ,CAAC,EAAE,QAAQ,GAClB,IAAI;IAoBP,wFAAwF;IACxF,SAAS,CAAC,GAAG,EAAE,mBAAmB,GAAG,IAAI;IAezC,mFAAmF;IACnF,qBAAqB,CAAC,WAAW,EAAE,SAAS,GAAG,IAAI;IA+BnD,aAAa,CAAC,cAAc,EAAE,QAAQ,GAAG,IAAI;IA+B7C,IAAI,CAAC,IAAI,EAAE,oBAAoB,GAAG,IAAI;IAUtC,IAAI,mBAAmB,IAAI,cAAc,GAAG,IAAI,CAoB/C;IAED,SAAS,IAAI,IAAI;IAOjB,uDAAuD;IACvD,WAAW,IAAI,IAAI;CAOpB"}

package/dist/mesh-renderer.js

@@ -0,0 +1,162 @@
+import { Component } from '@certe/atmos-core';
+import { Mat4 } from '@certe/atmos-math';
+import { writeMaterialUniforms, MATERIAL_UNIFORM_SIZE } from './material.js';
+import { getWhiteFallbackTexture, getFlatNormalFallback, getDefaultMetallicRoughnessFallback } from './texture.js';
+/** Per-object uniform buffer: MVP(64) + model(64) + normalMatrix(64) = 192 bytes */
+const OBJECT_UNIFORM_SIZE = 192;
+export class MeshRenderer extends Component {
+    mesh = null;
+    material = null;
+    meshSource = '';
+    materialSource = 'Default';
+    castShadow = true;
+    receiveSSAO = true;
+    uniformBuffer = null;
+    bindGroup = null;
+    materialBindGroup = null;
+    _device = null;
+    _pipelineResources = null;
+    // Pre-allocated scratch matrices
+    _mvp = Mat4.create();
+    _invModel = Mat4.create();
+    _normalMat = Mat4.create();
+    // Scratch buffer for material uniforms
+    _matData = new Float32Array(MATERIAL_UNIFORM_SIZE / 4);
+    _lastTextureVersion = -1;
+    // Pre-allocated bounding sphere result (reused by worldBoundingSphere getter)
+    _worldBoundsCenter = new Float32Array(3);
+    _worldBounds = { center: this._worldBoundsCenter, radius: 0 };
+    init(ctx, mesh, material) {
+        const { device, pipelineResources } = ctx;
+        this._device = device;
+        this._pipelineResources = pipelineResources;
+        this.mesh = mesh;
+        this.material = material ?? null;
+        this.uniformBuffer = device.createBuffer({
+            size: OBJECT_UNIFORM_SIZE,
+            usage: GPUBufferUsage.UNIFORM | GPUBufferUsage.COPY_DST,
+        });
+        this.bindGroup = device.createBindGroup({
+            layout: pipelineResources.objectBindGroupLayout,
+            entries: [
+                { binding: 0, resource: { buffer: this.uniformBuffer } },
+            ],
+        });
+    }
+    /** Lazily initialise GPU buffers if mesh+material exist but init() was never called. */
+    ensureGPU(ctx) {
+        if (this._device || !this.mesh)
+            return;
+        const { device, pipelineResources } = ctx;
+        this._device = device;
+        this._pipelineResources = pipelineResources;
+        this.uniformBuffer = device.createBuffer({
+            size: OBJECT_UNIFORM_SIZE,
+            usage: GPUBufferUsage.UNIFORM | GPUBufferUsage.COPY_DST,
+        });
+        this.bindGroup = device.createBindGroup({
+            layout: pipelineResources.objectBindGroupLayout,
+            entries: [{ binding: 0, resource: { buffer: this.uniformBuffer } }],
+        });
+    }
+    /** Create material bind group lazily, once the shared scene buffer is available */
+    initMaterialBindGroup(sceneBuffer) {
+        if (!this._device || !this._pipelineResources || !this.material)
+            return;
+        if (this.materialBindGroup)
+            return;
+        // Create material uniform buffer if needed
+        if (!this.material.uniformBuffer) {
+            this.material.uniformBuffer = this._device.createBuffer({
+                size: MATERIAL_UNIFORM_SIZE,
+                usage: GPUBufferUsage.UNIFORM | GPUBufferUsage.COPY_DST,
+            });
+            this.material.dirty = true;
+        }
+        const tex = this.material.albedoTexture ?? getWhiteFallbackTexture(this._device);
+        const nrm = this.material.normalTexture ?? getFlatNormalFallback(this._device);
+        const mr = this.material.metallicRoughnessTexture ?? getDefaultMetallicRoughnessFallback(this._device);
+        this.materialBindGroup = this._device.createBindGroup({
+            layout: this._pipelineResources.materialBindGroupLayout,
+            entries: [
+                { binding: 0, resource: { buffer: this.material.uniformBuffer } },
+                { binding: 1, resource: { buffer: sceneBuffer } },
+                { binding: 2, resource: tex.view },
+                { binding: 3, resource: tex.sampler },
+                { binding: 4, resource: nrm.view },
+                { binding: 5, resource: nrm.sampler },
+                { binding: 6, resource: mr.view },
+                { binding: 7, resource: mr.sampler },
+            ],
+        });
+    }
+    writeUniforms(viewProjection) {
+        if (!this._device || !this.uniformBuffer)
+            return;
+        const model = this.gameObject.transform.worldMatrix;
+        // MVP
+        Mat4.multiply(this._mvp, viewProjection, model);
+        // Normal matrix = transpose(inverse(model))
+        Mat4.invert(this._invModel, model);
+        Mat4.transpose(this._normalMat, this._invModel);
+        // Write all 3 matrices to buffer
+        this._device.queue.writeBuffer(this.uniformBuffer, 0, this._mvp);
+        this._device.queue.writeBuffer(this.uniformBuffer, 64, model);
+        this._device.queue.writeBuffer(this.uniformBuffer, 128, this._normalMat);
+        // Rebuild bind group if material texture changed
+        if (this.material && this.material.textureVersion !== this._lastTextureVersion) {
+            this._lastTextureVersion = this.material.textureVersion;
+            this.materialBindGroup = null;
+        }
+        // Write material uniforms if dirty
+        if (this.material?.dirty && this.material.uniformBuffer) {
+            writeMaterialUniforms(this._matData, this.material);
+            this._device.queue.writeBuffer(this.material.uniformBuffer, 0, this._matData);
+            this.material.dirty = false;
+        }
+    }
+    draw(pass) {
+        if (!this.mesh || !this.bindGroup || !this._pipelineResources || !this.materialBindGroup)
+            return;
+        pass.setPipeline(this._pipelineResources.pipeline);
+        pass.setBindGroup(0, this.bindGroup);
+        pass.setBindGroup(1, this.materialBindGroup);
+        pass.setVertexBuffer(0, this.mesh.vertexBuffer);
+        pass.setIndexBuffer(this.mesh.indexBuffer, this.mesh.indexFormat);
+        pass.drawIndexed(this.mesh.indexCount);
+    }
+    get worldBoundingSphere() {
+        const bounds = this.mesh?.bounds;
+        if (!bounds)
+            return null;
+        const model = this.gameObject.transform.worldMatrix;
+        // Transform center by world matrix
+        const cx = bounds.center[0];
+        const cy = bounds.center[1];
+        const cz = bounds.center[2];
+        this._worldBoundsCenter[0] = model[0] * cx + model[4] * cy + model[8] * cz + model[12];
+        this._worldBoundsCenter[1] = model[1] * cx + model[5] * cy + model[9] * cz + model[13];
+        this._worldBoundsCenter[2] = model[2] * cx + model[6] * cy + model[10] * cz + model[14];
+        // Approximate world radius: max column scale
+        const sx = Math.sqrt(model[0] * model[0] + model[1] * model[1] + model[2] * model[2]);
+        const sy = Math.sqrt(model[4] * model[4] + model[5] * model[5] + model[6] * model[6]);
+        const sz = Math.sqrt(model[8] * model[8] + model[9] * model[9] + model[10] * model[10]);
+        this._worldBounds.radius = bounds.radius * Math.max(sx, sy, sz);
+        return this._worldBounds;
+    }
+    onDestroy() {
+        this.uniformBuffer?.destroy();
+        this.uniformBuffer = null;
+        this.bindGroup = null;
+        this.materialBindGroup = null;
+    }
+    /** Destroy owned GPU mesh buffers (vertex + index). */
+    destroyMesh() {
+        if (this.mesh) {
+            this.mesh.vertexBuffer.destroy();
+            this.mesh.indexBuffer.destroy();
+            this.mesh = null;
+        }
+    }
+}
+//# sourceMappingURL=mesh-renderer.js.map

package/dist/mesh-renderer.js.map

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

package/dist/mesh.d.ts

@@ -0,0 +1,16 @@
+import type { BoundingSphere } from './bounds.js';
+export interface Mesh {
+    vertexBuffer: GPUBuffer;
+    indexBuffer: GPUBuffer;
+    indexCount: number;
+    indexFormat: GPUIndexFormat;
+    bounds?: BoundingSphere;
+    /** CPU-side vertex data for ray picking */
+    vertices?: Float32Array;
+    /** CPU-side index data for ray picking */
+    indices?: Uint16Array | Uint32Array;
+    /** Floats per vertex (e.g. 8 for pos+normal+uv) */
+    vertexStride?: number;
+}
+export declare function createMesh(device: GPUDevice, vertices: Float32Array, indices: Uint16Array | Uint32Array, vertexStride?: number): Mesh;
+//# sourceMappingURL=mesh.d.ts.map

package/dist/mesh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mesh.d.ts","sourceRoot":"","sources":["../src/mesh.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,WAAW,IAAI;IACnB,YAAY,EAAE,SAAS,CAAC;IACxB,WAAW,EAAE,SAAS,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,cAAc,CAAC;IAC5B,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,WAAW,GAAG,WAAW,CAAC;IACpC,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,UAAU,CACxB,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,WAAW,GAAG,WAAW,EAClC,YAAY,CAAC,EAAE,MAAM,GACpB,IAAI,CAiCN"}

package/dist/mesh.js

@@ -0,0 +1,33 @@
+export function createMesh(device, vertices, indices, vertexStride) {
+    const vertexBuffer = device.createBuffer({
+        size: vertices.byteLength,
+        usage: GPUBufferUsage.VERTEX | GPUBufferUsage.COPY_DST,
+    });
+    device.queue.writeBuffer(vertexBuffer, 0, vertices);
+    // writeBuffer requires byte length to be a multiple of 4.
+    // Uint16Array with odd element count (e.g. 3 indices = 6 bytes) needs padding.
+    const alignedByteSize = Math.ceil(indices.byteLength / 4) * 4;
+    const indexBuffer = device.createBuffer({
+        size: alignedByteSize,
+        usage: GPUBufferUsage.INDEX | GPUBufferUsage.COPY_DST,
+    });
+    if (indices.byteLength === alignedByteSize) {
+        device.queue.writeBuffer(indexBuffer, 0, indices);
+    }
+    else {
+        const padded = new Uint8Array(alignedByteSize);
+        padded.set(new Uint8Array(indices.buffer, indices.byteOffset, indices.byteLength));
+        device.queue.writeBuffer(indexBuffer, 0, padded);
+    }
+    const indexFormat = indices instanceof Uint32Array ? 'uint32' : 'uint16';
+    return {
+        vertexBuffer,
+        indexBuffer,
+        indexCount: indices.length,
+        indexFormat,
+        vertices,
+        indices,
+        vertexStride,
+    };
+}
+//# sourceMappingURL=mesh.js.map

package/dist/mesh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mesh.js","sourceRoot":"","sources":["../src/mesh.ts"],"names":[],"mappings":"AAgBA,MAAM,UAAU,UAAU,CACxB,MAAiB,EACjB,QAAsB,EACtB,OAAkC,EAClC,YAAqB;IAErB,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;QACvC,IAAI,EAAE,QAAQ,CAAC,UAAU;QACzB,KAAK,EAAE,cAAc,CAAC,MAAM,GAAG,cAAc,CAAC,QAAQ;KACvD,CAAC,CAAC;IACH,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,YAAY,EAAE,CAAC,EAAE,QAAsC,CAAC,CAAC;IAElF,0DAA0D;IAC1D,+EAA+E;IAC/E,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IAC9D,MAAM,WAAW,GAAG,MAAM,CAAC,YAAY,CAAC;QACtC,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,cAAc,CAAC,KAAK,GAAG,cAAc,CAAC,QAAQ;KACtD,CAAC,CAAC;IACH,IAAI,OAAO,CAAC,UAAU,KAAK,eAAe,EAAE,CAAC;QAC3C,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,EAAE,OAAqC,CAAC,CAAC;IAClF,CAAC;SAAM,CAAC;QACN,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,eAAe,CAAC,CAAC;QAC/C,MAAM,CAAC,GAAG,CAAC,IAAI,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;QACnF,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,EAAE,MAAoC,CAAC,CAAC;IACjF,CAAC;IAED,MAAM,WAAW,GAAmB,OAAO,YAAY,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;IAEzF,OAAO;QACL,YAAY;QACZ,WAAW;QACX,UAAU,EAAE,OAAO,CAAC,MAAM;QAC1B,WAAW;QACX,QAAQ;QACR,OAAO;QACP,YAAY;KACb,CAAC;AACJ,CAAC"}

package/dist/mipmap-generator.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Blit-based mipmap generator for WebGPU textures.
+ * Creates each mip level by rendering a fullscreen triangle with linear filtering.
+ */
+/** Generate mipmaps for a texture using blit-based downsampling. */
+export declare function generateMipmaps(device: GPUDevice, texture: GPUTexture): void;
+//# sourceMappingURL=mipmap-generator.d.ts.map

package/dist/mipmap-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mipmap-generator.d.ts","sourceRoot":"","sources":["../src/mipmap-generator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAuEH,oEAAoE;AACpE,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,GAAG,IAAI,CAmC5E"}

package/dist/mipmap-generator.js

@@ -0,0 +1,96 @@
+/**
+ * Blit-based mipmap generator for WebGPU textures.
+ * Creates each mip level by rendering a fullscreen triangle with linear filtering.
+ */
+const MIPMAP_SHADER = /* wgsl */ `
+var<private> pos: array<vec2<f32>, 3> = array(
+  vec2(-1.0, -1.0),
+  vec2( 3.0, -1.0),
+  vec2(-1.0,  3.0),
+);
+
+struct VertexOutput {
+  @builtin(position) position: vec4<f32>,
+  @location(0) uv: vec2<f32>,
+};
+
+@vertex
+fn vs(@builtin(vertex_index) i: u32) -> VertexOutput {
+  var out: VertexOutput;
+  let p = pos[i];
+  out.position = vec4(p, 0.0, 1.0);
+  out.uv = p * vec2(0.5, -0.5) + vec2(0.5);
+  return out;
+}
+
+@group(0) @binding(0) var srcTexture: texture_2d<f32>;
+@group(0) @binding(1) var srcSampler: sampler;
+
+@fragment
+fn fs(@location(0) uv: vec2<f32>) -> @location(0) vec4<f32> {
+  return textureSample(srcTexture, srcSampler, uv);
+}
+`;
+const _cache = new WeakMap();
+function getOrCreatePipeline(device, format) {
+    let formatMap = _cache.get(device);
+    if (!formatMap) {
+        formatMap = new Map();
+        _cache.set(device, formatMap);
+    }
+    const cached = formatMap.get(format);
+    if (cached)
+        return cached;
+    const module = device.createShaderModule({ code: MIPMAP_SHADER });
+    const bindGroupLayout = device.createBindGroupLayout({
+        entries: [
+            { binding: 0, visibility: GPUShaderStage.FRAGMENT, texture: { sampleType: 'float' } },
+            { binding: 1, visibility: GPUShaderStage.FRAGMENT, sampler: { type: 'filtering' } },
+        ],
+    });
+    const pipelineLayout = device.createPipelineLayout({ bindGroupLayouts: [bindGroupLayout] });
+    const pipeline = device.createRenderPipeline({
+        layout: pipelineLayout,
+        vertex: { module, entryPoint: 'vs' },
+        fragment: { module, entryPoint: 'fs', targets: [{ format }] },
+        primitive: { topology: 'triangle-list' },
+    });
+    const sampler = device.createSampler({ minFilter: 'linear', magFilter: 'linear' });
+    const entry = { pipeline, sampler, bindGroupLayout };
+    formatMap.set(format, entry);
+    return entry;
+}
+/** Generate mipmaps for a texture using blit-based downsampling. */
+export function generateMipmaps(device, texture) {
+    const mipCount = texture.mipLevelCount;
+    if (mipCount <= 1)
+        return;
+    const format = texture.format;
+    const { pipeline, sampler, bindGroupLayout } = getOrCreatePipeline(device, format);
+    const encoder = device.createCommandEncoder();
+    for (let level = 1; level < mipCount; level++) {
+        const srcView = texture.createView({ baseMipLevel: level - 1, mipLevelCount: 1 });
+        const dstView = texture.createView({ baseMipLevel: level, mipLevelCount: 1 });
+        const bindGroup = device.createBindGroup({
+            layout: bindGroupLayout,
+            entries: [
+                { binding: 0, resource: srcView },
+                { binding: 1, resource: sampler },
+            ],
+        });
+        const pass = encoder.beginRenderPass({
+            colorAttachments: [{
+                    view: dstView,
+                    loadOp: 'clear',
+                    storeOp: 'store',
+                    clearValue: { r: 0, g: 0, b: 0, a: 0 },
+                }],
+        });
+        pass.setPipeline(pipeline);
+        pass.setBindGroup(0, bindGroup);
+        pass.draw(3);
+        pass.end();
+    }
+    device.queue.submit([encoder.finish()]);
+}
+//# sourceMappingURL=mipmap-generator.js.map

package/dist/mipmap-generator.js.map

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

package/dist/pbr-wgsl.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Shared PBR WGSL functions and light loop code.
+ * Concatenated into both shader.ts (standard PBR) and terrain-shader.ts (splat PBR).
+ */
+/** PBR helper functions: GGX distribution, geometry, Fresnel, computePBR, computeTBN */
+export declare const PBR_FUNCTIONS_WGSL = "\n// GGX/Trowbridge-Reitz normal distribution\nfn distributionGGX(N: vec3<f32>, H: vec3<f32>, roughness: f32) -> f32 {\n  let a = roughness * roughness;\n  let a2 = a * a;\n  let NdotH = max(dot(N, H), 0.0);\n  let NdotH2 = NdotH * NdotH;\n  let denom = NdotH2 * (a2 - 1.0) + 1.0;\n  return a2 / (PI * denom * denom);\n}\n\n// Schlick-GGX geometry function\nfn geometrySchlickGGX(NdotV: f32, roughness: f32) -> f32 {\n  let r = roughness + 1.0;\n  let k = (r * r) / 8.0;\n  return NdotV / (NdotV * (1.0 - k) + k);\n}\n\n// Smith's geometry function\nfn geometrySmith(N: vec3<f32>, V: vec3<f32>, L: vec3<f32>, roughness: f32) -> f32 {\n  let NdotV = max(dot(N, V), 0.0);\n  let NdotL = max(dot(N, L), 0.0);\n  return geometrySchlickGGX(NdotV, roughness) * geometrySchlickGGX(NdotL, roughness);\n}\n\n// Fresnel-Schlick approximation\nfn fresnelSchlick(cosTheta: f32, F0: vec3<f32>) -> vec3<f32> {\n  return F0 + (1.0 - F0) * pow(clamp(1.0 - cosTheta, 0.0, 1.0), 5.0);\n}\n\n// Compute PBR contribution from a single light direction\nfn computePBR(\n  N: vec3<f32>, V: vec3<f32>, L: vec3<f32>,\n  albedo: vec3<f32>, metallic: f32, roughness: f32,\n  F0: vec3<f32>, radiance: vec3<f32>,\n) -> vec3<f32> {\n  let H = normalize(V + L);\n  let NDF = distributionGGX(N, H, roughness);\n  let G = geometrySmith(N, V, L, roughness);\n  let F = fresnelSchlick(max(dot(H, V), 0.0), F0);\n\n  let numerator = NDF * G * F;\n  let denominator = 4.0 * max(dot(N, V), 0.0) * max(dot(N, L), 0.0) + 0.0001;\n  let specular = numerator / denominator;\n\n  let kS = F;\n  let kD = (vec3<f32>(1.0) - kS) * (1.0 - metallic);\n  let NdotL = max(dot(N, L), 0.0);\n\n  return (kD * albedo / PI + specular) * radiance * NdotL;\n}\n\n// Compute cotangent-frame TBN from screen-space derivatives\nfn computeTBN(worldPos: vec3<f32>, worldNormal: vec3<f32>, uv: vec2<f32>) -> mat3x3<f32> {\n  let dp1 = dpdx(worldPos);\n  let dp2 = dpdy(worldPos);\n  let duv1 = dpdx(uv);\n  let duv2 = dpdy(uv);\n  let T = normalize(dp1 * duv2.y - dp2 * duv1.y);\n  let B = normalize(dp2 * duv1.x - dp1 * duv2.x);\n  let N = normalize(worldNormal);\n  return mat3x3(T, B, N);\n}\n";
+/** Light loop WGSL: iterates dir/point/spot lights with PBR + shadow sampling.
+ *  Expects: N, V, albedo, metallic, roughness, F0, worldPosition in scope. Writes to Lo. */
+export declare const LIGHT_LOOP_WGSL = "\n  // Directional lights\n  for (var i = 0u; i < scene.numDirLights; i = i + 1u) {\n    let light = scene.dirLights[i];\n    let L = normalize(-light.direction.xyz);\n    let intensity = light.color.w;\n    let radiance = light.color.rgb * intensity;\n    var contribution = computePBR(N, V, L, albedo, metallic, roughness, F0, radiance);\n    let dirSlot = shadow.dirLightToSlot[i];\n    if (dirSlot != 0xFFFFFFFFu) {\n      contribution = contribution * sampleDirShadow(dirSlot, worldPosition);\n    }\n    Lo = Lo + contribution;\n  }\n\n  // Point lights\n  for (var i = 0u; i < scene.numPointLights; i = i + 1u) {\n    let light = scene.pointLights[i];\n    let lightPos = light.position.xyz;\n    let range = light.position.w;\n    let intensity = light.color.w;\n\n    let toLight = lightPos - worldPosition;\n    let dist = length(toLight);\n    let L = toLight / max(dist, 0.0001);\n\n    // Smooth distance attenuation with range cutoff\n    let attenuation = max(1.0 - (dist * dist) / (range * range), 0.0);\n    let radiance = light.color.rgb * intensity * attenuation * attenuation;\n\n    var contribution = computePBR(N, V, L, albedo, metallic, roughness, F0, radiance);\n    let pointSlot = shadow.pointLightToSlot[i];\n    if (pointSlot != 0xFFFFFFFFu) {\n      contribution = contribution * samplePointShadow(pointSlot, worldPosition, N);\n    }\n    Lo = Lo + contribution;\n  }\n\n  // Spot lights\n  for (var i = 0u; i < scene.numSpotLights; i = i + 1u) {\n    let light = scene.spotLights[i];\n    let lightPos = light.position.xyz;\n    let range = light.position.w;\n    let spotDir = light.direction.xyz;\n    let outerCos = light.direction.w;\n    let innerCos = light.extra.x;\n    let intensity = light.color.w;\n\n    let toLight = lightPos - worldPosition;\n    let dist = length(toLight);\n    let L = toLight / max(dist, 0.0001);\n\n    // Distance attenuation (same as point light)\n    let distAtt = max(1.0 - (dist * dist) / (range * range), 0.0);\n\n    // Cone attenuation: smoothstep between outer and inner cosines\n    let cosAngle = dot(-L, spotDir);\n    let coneAtt = smoothstep(outerCos, innerCos, cosAngle);\n\n    let attenuation = distAtt * distAtt * coneAtt;\n    let radiance = light.color.rgb * intensity * attenuation;\n\n    var contribution = computePBR(N, V, L, albedo, metallic, roughness, F0, radiance);\n    let spotSlot = shadow.spotLightToSlot[i];\n    if (spotSlot != 0xFFFFFFFFu) {\n      contribution = contribution * sampleSpotShadow(spotSlot, worldPosition);\n    }\n    Lo = Lo + contribution;\n  }\n";
+/** Fog calculation WGSL. Expects: scene, worldPosition, color in scope. Modifies color. */
+export declare const FOG_WGSL = "\n  // Distance fog\n  if (scene.fogEnabled != 0u) {\n    let fogDist = length(scene.cameraPos.xyz - worldPosition);\n    var fogFactor: f32;\n    if (scene.fogMode == 0u) {\n      // Linear\n      fogFactor = saturate((scene.fogEnd - fogDist) / (scene.fogEnd - scene.fogStart));\n    } else {\n      // Exponential\u00B2\n      let d = scene.fogDensity * fogDist;\n      fogFactor = exp(-(d * d));\n    }\n    color = mix(scene.fogColor.rgb, color, fogFactor);\n  }\n";
+//# sourceMappingURL=pbr-wgsl.d.ts.map

package/dist/pbr-wgsl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pbr-wgsl.d.ts","sourceRoot":"","sources":["../src/pbr-wgsl.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,wFAAwF;AACxF,eAAO,MAAM,kBAAkB,2lEA+D9B,CAAC;AAEF;4FAC4F;AAC5F,eAAO,MAAM,eAAe,2gFAqE3B,CAAC;AAEF,2FAA2F;AAC3F,eAAO,MAAM,QAAQ,ydAepB,CAAC"}