@flighthq/scene3d-gl 0.2.1-next.840.857425c

package/dist/glEnvironmentIblBake.js

@@ -0,0 +1,365 @@
+import { createGlProgram } from '@flighthq/render-gl';
+import { ensureGlEnvironmentSourceCube, getGlCubeFaceTarget } from './glEnvironmentCube';
+import { getGlScene3DRuntime } from './glScene3DRuntime';
+// Bakes an Environment's source radiance cubemap into the split-sum image-based-lighting set —
+// a diffuse irradiance cubemap, a roughness-mipped prefiltered specular cubemap, and the 2D BRDF
+// integration LUT — and stores it on the scene runtime as `runtime.ibl`. The PBR ambient bind reads
+// that to light every PBR draw from the environment (see glPbrPrelude's IBL term). This is an
+// explicit pass the app sequences once when the environment is set (the bake is the substantial cost);
+// it is a no-op when the environment has no complete source cube. Re-baking replaces the prior set.
+//
+// Resolutions are deliberately modest (the bake runs in software under the headless capture harness);
+// they are the technique, tunable upward for production. The BRDF LUT is environment-independent, so
+// it is baked once per state and reused across re-bakes.
+export function bakeGlEnvironmentIbl(state, environment) {
+    const sourceCube = ensureGlEnvironmentSourceCube(state, environment);
+    if (sourceCube === null)
+        return;
+    const gl = state.gl;
+    gl.getExtension('EXT_color_buffer_float');
+    gl.getExtension('OES_texture_float_linear');
+    const runtime = getGlScene3DRuntime(state);
+    if (runtime.iblBakeFramebuffer === null)
+        runtime.iblBakeFramebuffer = gl.createFramebuffer();
+    const fbo = runtime.iblBakeFramebuffer;
+    const prevFramebuffer = gl.getParameter(gl.FRAMEBUFFER_BINDING);
+    const prevViewport = gl.getParameter(gl.VIEWPORT);
+    gl.disable(gl.DEPTH_TEST);
+    gl.disable(gl.CULL_FACE);
+    gl.disable(gl.BLEND);
+    const irradianceCube = bakeGlIrradiance(state, fbo, sourceCube);
+    const { prefilteredCube, prefilteredMipCount } = bakeGlPrefiltered(state, fbo, sourceCube);
+    const brdfLut = runtime.ibl?.brdfLut ?? bakeGlBrdfLut(state, fbo);
+    gl.bindFramebuffer(gl.FRAMEBUFFER, prevFramebuffer);
+    gl.viewport(prevViewport[0], prevViewport[1], prevViewport[2], prevViewport[3]);
+    gl.bindVertexArray(null);
+    runtime.ibl = {
+        brdfLut,
+        intensity: environment.intensity,
+        irradianceCube,
+        prefilteredCube,
+        prefilteredMipCount,
+    };
+}
+// Frees the IBL bake shader programs cached for `state` — the irradiance / prefilter / BRDF pass
+// programs and each one's fullscreen-quad VAO + vertex buffer. These are module-local (keyed by
+// state), so they cannot be reached from the scene runtime; destroyGlScene3DRuntime calls this to fold
+// them into the one-call teardown. A no-op when no bake has run for the state. The baked result
+// textures (runtime.ibl) are freed separately by destroyGlScene3DRuntime.
+export function destroyGlEnvironmentIblBakePrograms(state) {
+    const byState = _bakePrograms.get(state);
+    if (byState === undefined)
+        return;
+    const gl = state.gl;
+    for (const baked of byState.values()) {
+        gl.deleteProgram(baked.program);
+        gl.deleteVertexArray(baked.vao);
+        gl.deleteBuffer(baked.buffer);
+    }
+    _bakePrograms.delete(state);
+}
+function bakeGlIrradiance(state, fbo, sourceCube) {
+    const gl = state.gl;
+    const cube = createGlBakeCube(gl, IRRADIANCE_SIZE, false);
+    const program = ensureGlBakeProgram(state, 'irradiance', IRRADIANCE_FRAGMENT);
+    gl.bindFramebuffer(gl.FRAMEBUFFER, fbo);
+    gl.useProgram(program.program);
+    bindGlBakeSourceCube(gl, program, sourceCube);
+    renderGlBakeCubeFaces(state, fbo, program, cube, IRRADIANCE_SIZE, 0);
+    return cube;
+}
+function bakeGlPrefiltered(state, fbo, sourceCube) {
+    const gl = state.gl;
+    const cube = createGlBakeCube(gl, PREFILTERED_SIZE, true);
+    const program = ensureGlBakeProgram(state, 'prefiltered', PREFILTERED_FRAGMENT);
+    gl.bindFramebuffer(gl.FRAMEBUFFER, fbo);
+    gl.useProgram(program.program);
+    bindGlBakeSourceCube(gl, program, sourceCube);
+    const mipCount = PREFILTERED_MIPS;
+    for (let mip = 0; mip < mipCount; mip++) {
+        const mipSize = Math.max(1, PREFILTERED_SIZE >> mip);
+        const roughness = mipCount > 1 ? mip / (mipCount - 1) : 0;
+        gl.uniform1f(program.locRoughness, roughness);
+        renderGlBakeCubeFaces(state, fbo, program, cube, mipSize, mip);
+    }
+    return { prefilteredCube: cube, prefilteredMipCount: mipCount };
+}
+function bakeGlBrdfLut(state, fbo) {
+    const gl = state.gl;
+    const texture = gl.createTexture();
+    gl.bindTexture(gl.TEXTURE_2D, texture);
+    // RGBA16F (not RG16F): RG render targets are not reliably color-renderable across drivers (notably
+    // headless SwiftShader); the LUT uses only the R/G channels but stores them in a full RGBA target.
+    gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA16F, BRDF_LUT_SIZE, BRDF_LUT_SIZE, 0, gl.RGBA, gl.HALF_FLOAT, null);
+    gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, gl.LINEAR);
+    gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, gl.LINEAR);
+    gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_S, gl.CLAMP_TO_EDGE);
+    gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_T, gl.CLAMP_TO_EDGE);
+    const program = ensureGlBakeProgram(state, 'brdf', BRDF_LUT_FRAGMENT);
+    gl.bindFramebuffer(gl.FRAMEBUFFER, fbo);
+    gl.framebufferTexture2D(gl.FRAMEBUFFER, gl.COLOR_ATTACHMENT0, gl.TEXTURE_2D, texture, 0);
+    gl.viewport(0, 0, BRDF_LUT_SIZE, BRDF_LUT_SIZE);
+    gl.useProgram(program.program);
+    drawGlBakeQuad(state, program);
+    return texture;
+}
+// Renders all six faces of `cube` at mip `mipLevel` (size `size`) through `program`, setting the
+// per-face direction basis so the fragment shader reconstructs each texel's world direction.
+function renderGlBakeCubeFaces(state, fbo, program, cube, size, mipLevel) {
+    const gl = state.gl;
+    gl.viewport(0, 0, size, size);
+    for (let face = 0; face < 6; face++) {
+        gl.framebufferTexture2D(gl.FRAMEBUFFER, gl.COLOR_ATTACHMENT0, getGlCubeFaceTarget(gl, face), cube, mipLevel);
+        const b = CUBE_FACE_BASIS[face];
+        gl.uniform3f(program.locFaceForward, b[0], b[1], b[2]);
+        gl.uniform3f(program.locFaceRight, b[3], b[4], b[5]);
+        gl.uniform3f(program.locFaceUp, b[6], b[7], b[8]);
+        drawGlBakeQuad(state, program);
+    }
+    void fbo;
+}
+function createGlBakeCube(gl, size, mipped) {
+    const texture = gl.createTexture();
+    gl.bindTexture(gl.TEXTURE_CUBE_MAP, texture);
+    // Allocate the full mip chain up front: a cube with a mip-aware min filter is "incomplete" (samples
+    // as black) until every level it can reach has storage, so each prefiltered roughness level must be
+    // texImage2D'd here before the bake renders into it.
+    const levels = mipped ? PREFILTERED_MIPS : 1;
+    for (let mip = 0; mip < levels; mip++) {
+        const mipSize = Math.max(1, size >> mip);
+        for (let face = 0; face < 6; face++) {
+            gl.texImage2D(getGlCubeFaceTarget(gl, face), mip, gl.RGBA16F, mipSize, mipSize, 0, gl.RGBA, gl.HALF_FLOAT, null);
+        }
+    }
+    const minFilter = mipped ? gl.LINEAR_MIPMAP_LINEAR : gl.LINEAR;
+    gl.texParameteri(gl.TEXTURE_CUBE_MAP, gl.TEXTURE_MIN_FILTER, minFilter);
+    gl.texParameteri(gl.TEXTURE_CUBE_MAP, gl.TEXTURE_MAG_FILTER, gl.LINEAR);
+    gl.texParameteri(gl.TEXTURE_CUBE_MAP, gl.TEXTURE_WRAP_S, gl.CLAMP_TO_EDGE);
+    gl.texParameteri(gl.TEXTURE_CUBE_MAP, gl.TEXTURE_WRAP_T, gl.CLAMP_TO_EDGE);
+    gl.texParameteri(gl.TEXTURE_CUBE_MAP, gl.TEXTURE_WRAP_R, gl.CLAMP_TO_EDGE);
+    if (mipped)
+        gl.texParameteri(gl.TEXTURE_CUBE_MAP, gl.TEXTURE_MAX_LEVEL, PREFILTERED_MIPS - 1);
+    return texture;
+}
+function bindGlBakeSourceCube(gl, program, sourceCube) {
+    gl.activeTexture(gl.TEXTURE0);
+    gl.bindTexture(gl.TEXTURE_CUBE_MAP, sourceCube);
+    gl.uniform1i(program.locEnvCube, 0);
+}
+function ensureGlBakeProgram(state, key, fragment) {
+    const gl = state.gl;
+    let byState = _bakePrograms.get(state);
+    if (byState === undefined) {
+        byState = new Map();
+        _bakePrograms.set(state, byState);
+    }
+    let baked = byState.get(key);
+    if (baked !== undefined)
+        return baked;
+    const program = linkGlBakeProgram(gl, fragment);
+    const vao = gl.createVertexArray();
+    gl.bindVertexArray(vao);
+    const buffer = gl.createBuffer();
+    gl.bindBuffer(gl.ARRAY_BUFFER, buffer);
+    gl.bufferData(gl.ARRAY_BUFFER, _quad, gl.STATIC_DRAW);
+    gl.enableVertexAttribArray(0);
+    gl.vertexAttribPointer(0, 2, gl.FLOAT, false, 0, 0);
+    gl.bindVertexArray(null);
+    baked = {
+        buffer,
+        locEnvCube: gl.getUniformLocation(program, 'u_envCube'),
+        locFaceForward: gl.getUniformLocation(program, 'u_faceForward'),
+        locFaceRight: gl.getUniformLocation(program, 'u_faceRight'),
+        locFaceUp: gl.getUniformLocation(program, 'u_faceUp'),
+        locRoughness: gl.getUniformLocation(program, 'u_roughness'),
+        program,
+        vao,
+    };
+    byState.set(key, baked);
+    return baked;
+}
+function drawGlBakeQuad(state, program) {
+    const gl = state.gl;
+    gl.bindVertexArray(program.vao);
+    gl.drawArrays(gl.TRIANGLE_STRIP, 0, 4);
+}
+function linkGlBakeProgram(gl, fragment) {
+    return createGlProgram(gl, BAKE_VERTEX, fragment, 'IBL bake');
+}
+const IRRADIANCE_SIZE = 16;
+const PREFILTERED_SIZE = 64;
+const PREFILTERED_MIPS = 5;
+const BRDF_LUT_SIZE = 128;
+// Per-face direction basis (forward = face normal, plus right/up spanning the face) in CubeTexture
+// face order, following the standard cubemap sampling convention (up = -Y on the side/Z faces because
+// cube faces store top-left-origin). A fragment's world direction is
+// normalize(forward + uv.x*right + uv.y*up) with uv in [-1, 1].
+const CUBE_FACE_BASIS = [
+    [1, 0, 0, 0, 0, -1, 0, -1, 0], // +X
+    [-1, 0, 0, 0, 0, 1, 0, -1, 0], // -X
+    [0, 1, 0, 1, 0, 0, 0, 0, 1], // +Y
+    [0, -1, 0, 1, 0, 0, 0, 0, -1], // -Y
+    [0, 0, 1, 1, 0, 0, 0, -1, 0], // +Z
+    [0, 0, -1, -1, 0, 0, 0, -1, 0], // -Z
+];
+const _quad = new Float32Array([-1, -1, 1, -1, -1, 1, 1, 1]);
+const _bakePrograms = new WeakMap();
+// The bake vertex shader emits the clip-space quad and forwards the [-1,1] face coordinate so the
+// fragment can build its sampling direction from the per-face basis.
+const BAKE_VERTEX = `#version 300 es
+layout(location = 0) in vec2 a_position;
+out vec2 v_uv;
+void main() {
+  v_uv = a_position;
+  gl_Position = vec4(a_position, 0.0, 1.0);
+}
+`;
+const BAKE_COMMON = `precision highp float;
+in vec2 v_uv;
+uniform samplerCube u_envCube;
+uniform vec3 u_faceForward;
+uniform vec3 u_faceRight;
+uniform vec3 u_faceUp;
+out vec4 fragColor;
+const float PI = 3.14159265359;
+
+vec3 faceDirection() {
+  return normalize(u_faceForward + v_uv.x * u_faceRight + v_uv.y * u_faceUp);
+}
+vec3 srgbToLinear(vec3 c) {
+  return mix(c / 12.92, pow((c + 0.055) / 1.055, vec3(2.4)), step(0.04045, c));
+}
+`;
+// Diffuse irradiance: cosine-weighted hemisphere integral of the environment around the texel normal.
+const IRRADIANCE_FRAGMENT = `#version 300 es
+${BAKE_COMMON}
+void main() {
+  vec3 N = faceDirection();
+  vec3 up = abs(N.z) < 0.999 ? vec3(0.0, 0.0, 1.0) : vec3(1.0, 0.0, 0.0);
+  vec3 right = normalize(cross(up, N));
+  up = normalize(cross(N, right));
+
+  vec3 irradiance = vec3(0.0);
+  float samples = 0.0;
+  const float delta = 0.15;
+  for (float phi = 0.0; phi < 2.0 * PI; phi += delta) {
+    for (float theta = 0.0; theta < 0.5 * PI; theta += delta) {
+      vec3 tangent = vec3(sin(theta) * cos(phi), sin(theta) * sin(phi), cos(theta));
+      vec3 sampleVec = tangent.x * right + tangent.y * up + tangent.z * N;
+      irradiance += srgbToLinear(texture(u_envCube, sampleVec).rgb) * cos(theta) * sin(theta);
+      samples += 1.0;
+    }
+  }
+  fragColor = vec4(PI * irradiance / samples, 1.0);
+}
+`;
+// Prefiltered specular: GGX importance-sampled environment for the mip's roughness.
+const PREFILTERED_FRAGMENT = `#version 300 es
+${BAKE_COMMON}
+uniform float u_roughness;
+
+float radicalInverse(uint bits) {
+  bits = (bits << 16u) | (bits >> 16u);
+  bits = ((bits & 0x55555555u) << 1u) | ((bits & 0xAAAAAAAAu) >> 1u);
+  bits = ((bits & 0x33333333u) << 2u) | ((bits & 0xCCCCCCCCu) >> 2u);
+  bits = ((bits & 0x0F0F0F0Fu) << 4u) | ((bits & 0xF0F0F0F0u) >> 4u);
+  bits = ((bits & 0x00FF00FFu) << 8u) | ((bits & 0xFF00FF00u) >> 8u);
+  return float(bits) * 2.3283064365386963e-10;
+}
+vec2 hammersley(uint i, uint n) {
+  return vec2(float(i) / float(n), radicalInverse(i));
+}
+vec3 importanceSampleGGX(vec2 Xi, vec3 N, float roughness) {
+  float a = roughness * roughness;
+  float phi = 2.0 * PI * Xi.x;
+  float cosTheta = sqrt((1.0 - Xi.y) / (1.0 + (a * a - 1.0) * Xi.y));
+  float sinTheta = sqrt(1.0 - cosTheta * cosTheta);
+  vec3 H = vec3(cos(phi) * sinTheta, sin(phi) * sinTheta, cosTheta);
+  vec3 up = abs(N.z) < 0.999 ? vec3(0.0, 0.0, 1.0) : vec3(1.0, 0.0, 0.0);
+  vec3 tangent = normalize(cross(up, N));
+  vec3 bitangent = cross(N, tangent);
+  return normalize(tangent * H.x + bitangent * H.y + N * H.z);
+}
+void main() {
+  vec3 N = faceDirection();
+  vec3 V = N;
+  const uint SAMPLE_COUNT = 48u;
+  vec3 prefiltered = vec3(0.0);
+  float totalWeight = 0.0;
+  for (uint i = 0u; i < SAMPLE_COUNT; i++) {
+    vec2 Xi = hammersley(i, SAMPLE_COUNT);
+    vec3 H = importanceSampleGGX(Xi, N, u_roughness);
+    vec3 L = normalize(2.0 * dot(V, H) * H - V);
+    float nDotL = max(dot(N, L), 0.0);
+    if (nDotL > 0.0) {
+      prefiltered += srgbToLinear(texture(u_envCube, L).rgb) * nDotL;
+      totalWeight += nDotL;
+    }
+  }
+  fragColor = vec4(totalWeight > 0.0 ? prefiltered / totalWeight : srgbToLinear(texture(u_envCube, N).rgb), 1.0);
+}
+`;
+// BRDF integration LUT (split-sum): x = N·V, y = roughness; output RG = scale/bias for F0.
+const BRDF_LUT_FRAGMENT = `#version 300 es
+precision highp float;
+in vec2 v_uv;
+out vec4 fragColor;
+const float PI = 3.14159265359;
+
+float radicalInverse(uint bits) {
+  bits = (bits << 16u) | (bits >> 16u);
+  bits = ((bits & 0x55555555u) << 1u) | ((bits & 0xAAAAAAAAu) >> 1u);
+  bits = ((bits & 0x33333333u) << 2u) | ((bits & 0xCCCCCCCCu) >> 2u);
+  bits = ((bits & 0x0F0F0F0Fu) << 4u) | ((bits & 0xF0F0F0F0u) >> 4u);
+  bits = ((bits & 0x00FF00FFu) << 8u) | ((bits & 0xFF00FF00u) >> 8u);
+  return float(bits) * 2.3283064365386963e-10;
+}
+vec2 hammersley(uint i, uint n) {
+  return vec2(float(i) / float(n), radicalInverse(i));
+}
+vec3 importanceSampleGGX(vec2 Xi, vec3 N, float roughness) {
+  float a = roughness * roughness;
+  float phi = 2.0 * PI * Xi.x;
+  float cosTheta = sqrt((1.0 - Xi.y) / (1.0 + (a * a - 1.0) * Xi.y));
+  float sinTheta = sqrt(1.0 - cosTheta * cosTheta);
+  vec3 H = vec3(cos(phi) * sinTheta, sin(phi) * sinTheta, cosTheta);
+  vec3 up = abs(N.z) < 0.999 ? vec3(0.0, 0.0, 1.0) : vec3(1.0, 0.0, 0.0);
+  vec3 tangent = normalize(cross(up, N));
+  vec3 bitangent = cross(N, tangent);
+  return normalize(tangent * H.x + bitangent * H.y + N * H.z);
+}
+float geometrySchlickGGX(float nDotV, float roughness) {
+  float k = roughness * roughness / 2.0;
+  return nDotV / (nDotV * (1.0 - k) + k);
+}
+float geometrySmith(vec3 N, vec3 V, vec3 L, float roughness) {
+  return geometrySchlickGGX(max(dot(N, L), 0.0), roughness) * geometrySchlickGGX(max(dot(N, V), 0.0), roughness);
+}
+void main() {
+  vec2 uv = v_uv * 0.5 + 0.5;
+  float nDotV = max(uv.x, 0.001);
+  float roughness = uv.y;
+  vec3 V = vec3(sqrt(1.0 - nDotV * nDotV), 0.0, nDotV);
+  vec3 N = vec3(0.0, 0.0, 1.0);
+  float A = 0.0;
+  float B = 0.0;
+  const uint SAMPLE_COUNT = 256u;
+  for (uint i = 0u; i < SAMPLE_COUNT; i++) {
+    vec2 Xi = hammersley(i, SAMPLE_COUNT);
+    vec3 H = importanceSampleGGX(Xi, N, roughness);
+    vec3 L = normalize(2.0 * dot(V, H) * H - V);
+    float nDotL = max(L.z, 0.0);
+    float nDotH = max(H.z, 0.0);
+    float vDotH = max(dot(V, H), 0.0);
+    if (nDotL > 0.0) {
+      float G = geometrySmith(N, V, L, roughness);
+      float gVis = (G * vDotH) / (nDotH * nDotV);
+      float Fc = pow(1.0 - vDotH, 5.0);
+      A += (1.0 - Fc) * gVis;
+      B += Fc * gVis;
+    }
+  }
+  fragColor = vec4(A / float(SAMPLE_COUNT), B / float(SAMPLE_COUNT), 0.0, 1.0);
+}
+`;
+//# sourceMappingURL=glEnvironmentIblBake.js.map

package/dist/glEnvironmentIblBake.js.map

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

package/dist/glEnvironmentSkybox.d.ts

@@ -0,0 +1,3 @@
+import type { Camera3D, Environment, GlRenderState } from '@flighthq/types';
+export declare function drawGlEnvironmentSkybox(state: GlRenderState, environment: Readonly<Environment>, camera: Readonly<Camera3D>, aspect: number): void;
+//# sourceMappingURL=glEnvironmentSkybox.d.ts.map

package/dist/glEnvironmentSkybox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glEnvironmentSkybox.d.ts","sourceRoot":"","sources":["../src/glEnvironmentSkybox.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAW,MAAM,iBAAiB,CAAC;AAUrF,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,aAAa,EACpB,WAAW,EAAE,QAAQ,CAAC,WAAW,CAAC,EAClC,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAC1B,MAAM,EAAE,MAAM,GACb,IAAI,CA2BN"}

package/dist/glEnvironmentSkybox.js

@@ -0,0 +1,95 @@
+import { getCamera3DInverseViewProjectionMatrix4 } from '@flighthq/camera';
+import { createMatrix4 } from '@flighthq/geometry';
+import { createGlProgram } from '@flighthq/render-gl';
+import { ensureGlEnvironmentSourceCube } from './glEnvironmentCube';
+// Draws the environment's radiance cubemap as the scene backdrop: a screen-filling pass that, per
+// pixel, reconstructs the world-space view ray from the inverse view-projection and samples the cube.
+// The quad is emitted at the far plane (clip z = w) with depth writes off, so it fills only pixels the
+// opaque scene has not yet covered and never occludes geometry. Call it once, after the color target
+// is bound and cleared and before drawGlScene3D. A no-op when the environment has no complete source
+// cube. `aspect` is the viewport width / height (matches the camera aspect drawGlScene3D uses).
+export function drawGlEnvironmentSkybox(state, environment, camera, aspect) {
+    const cube = ensureGlEnvironmentSourceCube(state, environment);
+    if (cube === null)
+        return;
+    const gl = state.gl;
+    const sky = ensureGlSkybox(state);
+    getCamera3DInverseViewProjectionMatrix4(_inverseViewProjection, camera, aspect);
+    const prevDepthTest = gl.getParameter(gl.DEPTH_TEST);
+    gl.depthMask(false);
+    gl.disable(gl.DEPTH_TEST);
+    gl.disable(gl.BLEND);
+    gl.useProgram(sky.program);
+    gl.uniformMatrix4fv(sky.locInverseViewProjection, false, _inverseViewProjection.m);
+    gl.uniform1f(sky.locIntensity, environment.intensity);
+    gl.activeTexture(gl.TEXTURE0);
+    gl.bindTexture(gl.TEXTURE_CUBE_MAP, cube);
+    gl.uniform1i(sky.locEnvCube, 0);
+    gl.bindVertexArray(sky.vao);
+    gl.drawArrays(gl.TRIANGLE_STRIP, 0, 4);
+    gl.bindVertexArray(null);
+    gl.depthMask(true);
+    if (prevDepthTest)
+        gl.enable(gl.DEPTH_TEST);
+}
+function ensureGlSkybox(state) {
+    const gl = state.gl;
+    let sky = _skyboxes.get(state);
+    if (sky !== undefined)
+        return sky;
+    const program = linkGlSkyboxProgram(gl);
+    const vao = gl.createVertexArray();
+    gl.bindVertexArray(vao);
+    const buffer = gl.createBuffer();
+    gl.bindBuffer(gl.ARRAY_BUFFER, buffer);
+    gl.bufferData(gl.ARRAY_BUFFER, _quad, gl.STATIC_DRAW);
+    gl.enableVertexAttribArray(0);
+    gl.vertexAttribPointer(0, 2, gl.FLOAT, false, 0, 0);
+    gl.bindVertexArray(null);
+    sky = {
+        locEnvCube: gl.getUniformLocation(program, 'u_envCube'),
+        locInverseViewProjection: gl.getUniformLocation(program, 'u_inverseViewProjection'),
+        locIntensity: gl.getUniformLocation(program, 'u_intensity'),
+        program,
+        vao,
+    };
+    _skyboxes.set(state, sky);
+    return sky;
+}
+function linkGlSkyboxProgram(gl) {
+    return createGlProgram(gl, SKYBOX_VERTEX, SKYBOX_FRAGMENT, 'Skybox');
+}
+const _inverseViewProjection = createMatrix4();
+const _quad = new Float32Array([-1, -1, 1, -1, -1, 1, 1, 1]);
+const _skyboxes = new WeakMap();
+const SKYBOX_VERTEX = `#version 300 es
+layout(location = 0) in vec2 a_position;
+out vec2 v_ndc;
+void main() {
+  v_ndc = a_position;
+  // Emit at the far plane (z = w) so the backdrop sits behind every drawn fragment.
+  gl_Position = vec4(a_position, 1.0, 1.0);
+}
+`;
+const SKYBOX_FRAGMENT = `#version 300 es
+precision highp float;
+in vec2 v_ndc;
+uniform samplerCube u_envCube;
+uniform mat4 u_inverseViewProjection;
+uniform float u_intensity;
+out vec4 fragColor;
+
+vec3 srgbToLinear(vec3 c) {
+  return mix(c / 12.92, pow((c + 0.055) / 1.055, vec3(2.4)), step(0.04045, c));
+}
+
+void main() {
+  // Reconstruct the world-space ray through this pixel from the near- and far-plane unprojections.
+  vec4 nearW = u_inverseViewProjection * vec4(v_ndc, -1.0, 1.0);
+  vec4 farW = u_inverseViewProjection * vec4(v_ndc, 1.0, 1.0);
+  vec3 dir = normalize(farW.xyz / farW.w - nearW.xyz / nearW.w);
+  vec3 color = srgbToLinear(texture(u_envCube, dir).rgb) * u_intensity;
+  fragColor = vec4(color, 1.0);
+}
+`;
+//# sourceMappingURL=glEnvironmentSkybox.js.map

package/dist/glEnvironmentSkybox.js.map

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

package/dist/glLitProgram.d.ts

@@ -0,0 +1,5 @@
+import type { GlLitProgram, GlRenderState, Scene3DLightBlock, GlMeshProgram } from '@flighthq/types';
+export declare function bindGlMeshLightBlock(state: GlRenderState, program: Readonly<GlLitProgram>, lights: Readonly<Scene3DLightBlock>): void;
+export declare function resolveGlLitLocations(gl: WebGL2RenderingContext, program: WebGLProgram): Omit<GlLitProgram, keyof GlMeshProgram>;
+export declare const GL_MESH_LIGHT_BLOCK_GLSL = "\nuniform vec4 u_directional;          // xyz = light travel direction (surface->light is -xyz)\nuniform vec4 u_directionalRadiance;  // rgb = linear radiance, premultiplied by intensity\nuniform vec3 u_ambientRadiance;      // linear ambient irradiance\nuniform float u_directionalCount;    // 0 or 1 \u2014 gates the directional term\nuniform float u_ambientCount;        // 0 or 1 \u2014 gates the ambient term\nuniform vec3 u_cameraPosition;       // world-space camera position for view-dependent terms\nuniform sampler2D u_shadowMap;       // directional shadow depth map\nuniform mat4 u_shadowMatrix;         // world -> shadow light-clip\nuniform float u_shadowEnabled;       // 0 or 1 \u2014 gates shadow sampling\n\n// Punctual (point/spot/hemisphere) forward-light arrays. Fixed MAX_FORWARD_LIGHTS-wide; each count\n// uniform bounds its loop. Layout matches Scene3DLightBlock.data (packScene3DLightBlock) byte-for-byte:\n//   point[i]      = u_pointLights[i*2+0]={pos.xyz,range}, [i*2+1]={radiance.rgb,invSqrRange}\n//   spot[i]       = u_spotLights[i*4+0..1] as point, [i*4+2]={dir.xyz,_}, [i*4+3]={cosInner,cosOuter,_,_}\n//   hemisphere[i] = u_hemisphereLights[i*3+0]={sky.rgb,_}, [i*3+1]={ground.rgb,_}, [i*3+2]={up.xyz,_}\nuniform vec4 u_pointLights[MAX_FORWARD_LIGHTS * 2];\nuniform vec4 u_spotLights[MAX_FORWARD_LIGHTS * 4];\nuniform vec4 u_hemisphereLights[MAX_FORWARD_LIGHTS * 3];\nuniform int u_pointCount;\nuniform int u_spotCount;\nuniform int u_hemisphereCount;\n\n// Smooth inverse-square range window (glTF/UE4): 1 near the light, eased to 0 at the range. invSqrRange\n// is 1/range^2 (0 = infinite range, no cutoff). dist2 is the squared surface->light distance.\nfloat rangeWindow(float dist2, float invSqrRange) {\n  float factor = dist2 * invSqrRange;\n  float windowed = clamp(1.0 - factor * factor, 0.0, 1.0);\n  return windowed * windowed;\n}\n\n// Directional shadow factor at a world position: 1.0 fully lit, 0.0 fully shadowed, with 3x3 PCF.\n// Fragments outside the shadow frustum are treated as lit.\nfloat sampleDirectionalShadow(vec3 worldPos) {\n  if (u_shadowEnabled < 0.5) return 1.0;\n  vec4 clip = u_shadowMatrix * vec4(worldPos, 1.0);\n  vec3 ndc = clip.xyz / clip.w;\n  vec3 uvz = ndc * 0.5 + 0.5;\n  if (uvz.x < 0.0 || uvz.x > 1.0 || uvz.y < 0.0 || uvz.y > 1.0 || uvz.z > 1.0) return 1.0;\n  float current = uvz.z - 0.0025;\n  vec2 texel = 1.0 / vec2(textureSize(u_shadowMap, 0));\n  float sum = 0.0;\n  for (int x = -1; x <= 1; ++x) {\n    for (int y = -1; y <= 1; ++y) {\n      float closest = texture(u_shadowMap, uvz.xy + vec2(float(x), float(y)) * texel).r;\n      sum += current <= closest ? 1.0 : 0.0;\n    }\n  }\n  return sum / 9.0;\n}\n";
+//# sourceMappingURL=glLitProgram.d.ts.map

package/dist/glLitProgram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glLitProgram.d.ts","sourceRoot":"","sources":["../src/glLitProgram.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAsCrG,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,QAAQ,CAAC,YAAY,CAAC,EAC/B,MAAM,EAAE,QAAQ,CAAC,iBAAiB,CAAC,GAClC,IAAI,CA2FN;AAsCD,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,sBAAsB,EAC1B,OAAO,EAAE,YAAY,GACpB,IAAI,CAAC,YAAY,EAAE,MAAM,aAAa,CAAC,CAwBzC;AAMD,eAAO,MAAM,wBAAwB,6oFAkDpC,CAAC"}