@3driseai/3drise-viewer 0.1.22 → 0.1.24

package/dist/components/spotBeam/beamPatterns.js

@@ -0,0 +1,106 @@
+// =============================================================================
+// beamPatterns — the shape the light throws
+// =============================================================================
+//
+// A spot light's beam is shaped by what sits in front of it, so this generates
+// that mask once, as a texture: three projects it through the light's own
+// frustum (SpotLight.map), and the beam shader samples the same texture, so the
+// haze in the air and the pool on the floor always agree.
+//
+// Everything is masked by the cone's own circle, so the beam edge stays round
+// whatever the pattern does inside it.
+//
+import { CanvasTexture, LinearFilter, SRGBColorSpace } from 'three';
+export const BEAM_PATTERNS = ['round', 'slot', 'bars', 'blinds', 'window', 'leaves'];
+const SIZE = 512;
+/** Soft-edged mask of the cone itself; everything else multiplies into it. */
+function coneMask(g, softness) {
+    const r = SIZE / 2;
+    const inner = Math.max(0.02, 1 - softness) * r;
+    const grad = g.createRadialGradient(r, r, inner, r, r, r);
+    grad.addColorStop(0, 'rgba(255,255,255,1)');
+    grad.addColorStop(1, 'rgba(255,255,255,0)');
+    g.globalCompositeOperation = 'destination-in';
+    g.fillStyle = grad;
+    g.fillRect(0, 0, SIZE, SIZE);
+    g.globalCompositeOperation = 'source-over';
+}
+function drawPattern(g, pattern, softness) {
+    const s = SIZE;
+    g.fillStyle = '#ffffff';
+    if (pattern === 'round') {
+        g.fillRect(0, 0, s, s);
+        return;
+    }
+    if (pattern === 'slot') {
+        const h = s * 0.3;
+        g.fillRect(0, (s - h) / 2, s, h);
+        return;
+    }
+    if (pattern === 'bars') {
+        const n = 7, w = s / n;
+        for (let i = 0; i < n; i++)
+            if (i % 2 === 0)
+                g.fillRect(i * w, 0, w * 0.62, s);
+        return;
+    }
+    if (pattern === 'blinds') {
+        const n = 9, h = s / n;
+        for (let i = 0; i < n; i++)
+            g.fillRect(0, i * h, s, h * 0.5);
+        return;
+    }
+    if (pattern === 'window') {
+        const bar = s * 0.045;
+        g.fillRect(0, 0, s, s);
+        g.fillStyle = '#000000';
+        g.fillRect(s / 2 - bar / 2, 0, bar, s);
+        g.fillRect(0, s / 2 - bar / 2, s, bar);
+        g.fillRect(0, 0, s, bar * 0.8);
+        g.fillRect(0, s - bar * 0.8, s, bar * 0.8);
+        return;
+    }
+    // leaves: overlapping blobs, deterministic so the same config is the same dapple
+    let seed = 9;
+    const rnd = () => (seed = (seed * 1664525 + 1013904223) % 4294967296) / 4294967296;
+    g.fillRect(0, 0, s, s);
+    g.fillStyle = '#000000';
+    for (let i = 0; i < 34; i++) {
+        const x = rnd() * s, y = rnd() * s, r = s * (0.05 + rnd() * 0.11);
+        g.beginPath();
+        g.ellipse(x, y, r, r * (0.55 + rnd() * 0.7), rnd() * Math.PI, 0, Math.PI * 2);
+        g.fill();
+    }
+    void softness;
+}
+/**
+ * Build the mask. `rotation` is baked in rather than applied as a uv transform:
+ * three samples a spot light's map through the light frustum and ignores the
+ * texture matrix, so rotating it any other way would turn the haze without
+ * turning the pool.
+ */
+export function createBeamPattern(pattern, softness, rotationDeg) {
+    const canvas = document.createElement('canvas');
+    canvas.width = canvas.height = SIZE;
+    const g = canvas.getContext('2d');
+    g.clearRect(0, 0, SIZE, SIZE);
+    g.save();
+    g.translate(SIZE / 2, SIZE / 2);
+    g.rotate((rotationDeg * Math.PI) / 180);
+    g.translate(-SIZE / 2, -SIZE / 2);
+    drawPattern(g, pattern, softness);
+    g.restore();
+    // Soften the pattern edges as well as the cone rim.
+    if (softness > 0.02 && pattern !== 'round') {
+        g.filter = `blur(${Math.round(softness * 26)}px)`;
+        g.drawImage(canvas, 0, 0);
+        g.filter = 'none';
+    }
+    coneMask(g, Math.max(softness, 0.06));
+    const texture = new CanvasTexture(canvas);
+    texture.colorSpace = SRGBColorSpace;
+    texture.minFilter = LinearFilter;
+    texture.magFilter = LinearFilter;
+    texture.needsUpdate = true;
+    return texture;
+}

package/dist/components/spotBeam/index.d.ts

@@ -0,0 +1,7 @@
+export { default as SpotBeam } from './SpotBeam';
+export type { SpotBeamProps } from './SpotBeam';
+export { BEAM_PATTERNS, createBeamPattern } from './beamPatterns';
+export type { BeamPattern } from './beamPatterns';
+export { createSpotBeamMaterials, disposeSpotBeamMaterials } from './spotBeamMaterials';
+export type { SpotBeamMaterials } from './spotBeamMaterials';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/spotBeam/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/spotBeam/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,YAAY,CAAC;AACjD,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAClE,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AACxF,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/components/spotBeam/index.js

@@ -0,0 +1,4 @@
+// A spot light with a visible, pattern-shaped beam (config.type 'spotBeam').
+export { default as SpotBeam } from './SpotBeam.js';
+export { BEAM_PATTERNS, createBeamPattern } from './beamPatterns.js';
+export { createSpotBeamMaterials, disposeSpotBeamMaterials } from './spotBeamMaterials.js';

package/dist/components/spotBeam/spotBeamMaterials.d.ts

@@ -0,0 +1,16 @@
+import { MeshBasicMaterial, ShaderMaterial } from 'three';
+export type BeamMode = 'none' | 'soft' | 'layered' | 'volumetric';
+export declare const BEAM_MODES: BeamMode[];
+export interface SpotBeamMaterials {
+    lens: MeshBasicMaterial;
+    halo: ShaderMaterial;
+    /** One cone shell, lit by how obliquely you look through it. One draw. */
+    soft: ShaderMaterial;
+    /** Nested shells: cheap depth, approximates the pattern. */
+    layered: ShaderMaterial;
+    /** Raymarched cone interior: the only mode where the pattern exists in the air. */
+    volumetric: ShaderMaterial;
+}
+export declare function createSpotBeamMaterials(): SpotBeamMaterials;
+export declare function disposeSpotBeamMaterials(m: SpotBeamMaterials): void;
+//# sourceMappingURL=spotBeamMaterials.d.ts.map

package/dist/components/spotBeam/spotBeamMaterials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spotBeamMaterials.d.ts","sourceRoot":"","sources":["../../../src/components/spotBeam/spotBeamMaterials.ts"],"names":[],"mappings":"AAcA,OAAO,EAAiD,iBAAiB,EAAE,cAAc,EAAW,MAAM,OAAO,CAAC;AAGlH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,YAAY,CAAC;AAElE,eAAO,MAAM,UAAU,EAAE,QAAQ,EAA8C,CAAC;AAEhF,MAAM,WAAW,iBAAiB;IAC9B,IAAI,EAAE,iBAAiB,CAAC;IACxB,IAAI,EAAE,cAAc,CAAC;IACrB,0EAA0E;IAC1E,IAAI,EAAE,cAAc,CAAC;IACrB,4DAA4D;IAC5D,OAAO,EAAE,cAAc,CAAC;IACxB,mFAAmF;IACnF,UAAU,EAAE,cAAc,CAAC;CAC9B;AA+RD,wBAAgB,uBAAuB,IAAI,iBAAiB,CAQ3D;AAED,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAEnE"}

package/dist/components/spotBeam/spotBeamMaterials.js

@@ -0,0 +1,307 @@
+// =============================================================================
+// spotBeamMaterials — the emitter, its halo, and the haze in the beam
+// =============================================================================
+//
+// The viewer has no tone mapping and no bloom, so everything bright here is
+// drawn by hand: an emissive lens face, a camera-facing halo, and the beam.
+//
+// The beam is a stack of nested cone shells rendered as one InstancedMesh. A
+// single shell can only ever sample the rim of the projected pattern; nesting
+// them (aFrac = 0 at the axis, 1 at the cone edge) samples the pattern across
+// its whole width, which is what makes a slot read as a slot in the air as well
+// as on the floor. Density is weighted towards the axis, the way a real cone
+// has more haze to look through down the middle.
+//
+import { AdditiveBlending, BackSide, Color, DoubleSide, MeshBasicMaterial, ShaderMaterial, Vector3 } from 'three';
+export const BEAM_MODES = ['none', 'soft', 'layered', 'volumetric'];
+const OUTPUT = /* glsl */ `
+    #include <tonemapping_fragment>
+    #include <colorspace_fragment>
+`;
+function haloMaterial() {
+    return new ShaderMaterial({
+        uniforms: {
+            uColor: { value: new Color(1, 0.9, 0.75) },
+            uStrength: { value: 0 },
+            uRadius: { value: 0.55 },
+        },
+        vertexShader: /* glsl */ `
+            uniform float uRadius;
+            varying vec2 vUv;
+            void main() {
+                vec4 mv = modelViewMatrix * vec4(0.0, 0.0, 0.0, 1.0);
+                float s = length(modelMatrix[0].xyz) * uRadius;
+                mv.xy += position.xy * s;
+                vUv = position.xy;
+                gl_Position = projectionMatrix * mv;
+            }`,
+        fragmentShader: /* glsl */ `
+            uniform vec3 uColor;
+            uniform float uStrength;
+            varying vec2 vUv;
+            void main() {
+                float d = length(vUv);
+                float a = (exp(-d * 9.0) + exp(-d * d * 5.0) * 0.3) * (1.0 - smoothstep(0.65, 1.0, d));
+                gl_FragColor = vec4(uColor * uStrength * a, 1.0);
+                ${OUTPUT}
+            }`,
+        transparent: true,
+        depthWrite: false,
+        blending: AdditiveBlending,
+    });
+}
+function beamMaterial() {
+    return new ShaderMaterial({
+        uniforms: {
+            uColor: { value: new Color(1, 0.9, 0.75) },
+            uStrength: { value: 0 },
+            uPenumbra: { value: 0.3 },
+            uPattern: { value: null },
+            uNoise: { value: 0.35 },
+            uTime: { value: 0 },
+            uLayers: { value: 6 },
+        },
+        vertexShader: /* glsl */ `
+            attribute float aFrac;          // 0 at the axis, 1 at the cone edge
+            varying float vFrac;
+            varying float vT;               // 0 at the lens, 1 at the far end
+            varying vec2 vPattern;          // where this point sits in the mask
+            varying vec3 vLocal;
+            void main() {
+                vec3 p = position;
+                vFrac = aFrac;
+                vT = clamp(p.y, 0.0, 1.0);
+                // Unit cone: at height y the rim sits at radius y, so dividing by
+                // y gives the projector's normalised coordinates — the same ones
+                // three uses to project the light's map.
+                vec2 proj = p.y > 1e-4 ? vec2(p.x, p.z) / p.y : vec2(0.0);
+                vPattern = proj * aFrac * 0.5 + 0.5;
+                vec3 scaled = vec3(p.x * aFrac, p.y, p.z * aFrac);
+                vLocal = scaled;
+                vec4 mv = modelViewMatrix * instanceMatrix * vec4(scaled, 1.0);
+                gl_Position = projectionMatrix * mv;
+            }`,
+        fragmentShader: /* glsl */ `
+            uniform vec3 uColor;
+            uniform float uStrength;
+            uniform float uPenumbra;
+            uniform sampler2D uPattern;
+            uniform float uNoise;
+            uniform float uTime;
+            uniform float uLayers;
+            varying float vFrac;
+            varying float vT;
+            varying vec2 vPattern;
+            varying vec3 vLocal;
+
+            // cheap value noise, for haze that drifts instead of sitting still
+            float hash(vec3 p) { return fract(sin(dot(p, vec3(127.1, 311.7, 74.7))) * 43758.5453); }
+            float vnoise(vec3 p) {
+                vec3 i = floor(p), f = fract(p);
+                f = f * f * (3.0 - 2.0 * f);
+                float n000 = hash(i), n100 = hash(i + vec3(1,0,0));
+                float n010 = hash(i + vec3(0,1,0)), n110 = hash(i + vec3(1,1,0));
+                float n001 = hash(i + vec3(0,0,1)), n101 = hash(i + vec3(1,0,1));
+                float n011 = hash(i + vec3(0,1,1)), n111 = hash(i + vec3(1,1,1));
+                return mix(mix(mix(n000,n100,f.x), mix(n010,n110,f.x), f.y),
+                           mix(mix(n001,n101,f.x), mix(n011,n111,f.x), f.y), f.z);
+            }
+
+            void main() {
+                float mask = texture2D(uPattern, vPattern).r;
+                if (mask < 0.004) discard;
+
+                // Density: thickest down the axis, thinning towards the rim, and
+                // fading with distance from the lens.
+                float core = pow(1.0 - vFrac * vFrac, 0.75);
+                float edge = mix(1.0, smoothstep(1.0, 0.55, vFrac), uPenumbra);
+                float fade = pow(1.0 - vT, 1.8);
+                float throat = smoothstep(0.0, 0.05, vT);
+
+                float haze = 1.0;
+                if (uNoise > 0.001) {
+                    float n = vnoise(vLocal * 3.5 + vec3(0.0, -uTime * 0.35, uTime * 0.12));
+                    haze = mix(1.0, 0.45 + n, uNoise);
+                }
+
+                float a = mask * core * edge * fade * throat * haze / uLayers;
+                gl_FragColor = vec4(uColor * uStrength * a, 1.0);
+                ${OUTPUT}
+            }`,
+        transparent: true,
+        depthWrite: false,
+        blending: AdditiveBlending,
+        side: DoubleSide,
+    });
+}
+/**
+ * One shell, brightest where the view grazes it. No pattern in the air, but it
+ * is a single draw and reads perfectly well in a hazy room.
+ */
+function softMaterial() {
+    return new ShaderMaterial({
+        uniforms: {
+            uColor: { value: new Color(1, 0.9, 0.75) },
+            uStrength: { value: 0 },
+            uPenumbra: { value: 0.3 },
+        },
+        vertexShader: /* glsl */ `
+            varying vec3 vNormal;
+            varying vec3 vView;
+            varying float vT;
+            void main() {
+                vec4 mv = modelViewMatrix * vec4(position, 1.0);
+                vNormal = normalize(normalMatrix * normal);
+                vView = normalize(-mv.xyz);
+                vT = clamp(position.y, 0.0, 1.0);
+                gl_Position = projectionMatrix * mv;
+            }`,
+        fragmentShader: /* glsl */ `
+            uniform vec3 uColor;
+            uniform float uStrength;
+            uniform float uPenumbra;
+            varying vec3 vNormal;
+            varying vec3 vView;
+            varying float vT;
+            void main() {
+                float graze = 1.0 - abs(dot(normalize(vNormal), normalize(vView)));
+                float body = pow(graze, 3.0 - uPenumbra);
+                float fade = pow(1.0 - vT, 2.0);
+                float throat = smoothstep(0.0, 0.05, vT);
+                gl_FragColor = vec4(uColor * uStrength * body * fade * throat, 1.0);
+                ${OUTPUT}
+            }`,
+        transparent: true,
+        depthWrite: false,
+        blending: AdditiveBlending,
+        side: DoubleSide,
+    });
+}
+/**
+ * The real thing: march the cone's interior from where the view ray enters it to
+ * where it leaves, sampling the projected mask at every step. Because each step
+ * knows its own position inside the cone, a slot is a slot in the air, blinds
+ * are blinds, and the haze thins with distance the way it should.
+ *
+ * Rendered on the cone's back faces so the volume is covered whether the camera
+ * is outside the beam or standing in it. Geometry is the unit cone (radius == y),
+ * so the ray maths works in that space and the mesh scale does the rest.
+ */
+function volumetricMaterial() {
+    return new ShaderMaterial({
+        uniforms: {
+            uColor: { value: new Color(1, 0.9, 0.75) },
+            uStrength: { value: 0 },
+            uPenumbra: { value: 0.3 },
+            uPattern: { value: null },
+            uNoise: { value: 0.35 },
+            uTime: { value: 0 },
+            uCamera: { value: new Vector3() },
+            uSteps: { value: 28 },
+        },
+        vertexShader: /* glsl */ `
+            varying vec3 vLocal;
+            void main() {
+                vLocal = position;
+                gl_Position = projectionMatrix * modelViewMatrix * vec4(position, 1.0);
+            }`,
+        fragmentShader: /* glsl */ `
+            uniform vec3 uColor;
+            uniform float uStrength;
+            uniform float uPenumbra;
+            uniform sampler2D uPattern;
+            uniform float uNoise;
+            uniform float uTime;
+            uniform vec3 uCamera;   // camera position in this cone's local space
+            uniform float uSteps;
+            varying vec3 vLocal;
+
+            float hash(vec3 p) { return fract(sin(dot(p, vec3(127.1, 311.7, 74.7))) * 43758.5453); }
+            float vnoise(vec3 p) {
+                vec3 i = floor(p), f = fract(p);
+                f = f * f * (3.0 - 2.0 * f);
+                float n000 = hash(i), n100 = hash(i + vec3(1,0,0));
+                float n010 = hash(i + vec3(0,1,0)), n110 = hash(i + vec3(1,1,0));
+                float n001 = hash(i + vec3(0,0,1)), n101 = hash(i + vec3(1,0,1));
+                float n011 = hash(i + vec3(0,1,1)), n111 = hash(i + vec3(1,1,1));
+                return mix(mix(mix(n000,n100,f.x), mix(n010,n110,f.x), f.y),
+                           mix(mix(n001,n101,f.x), mix(n011,n111,f.x), f.y), f.z);
+            }
+
+            void main() {
+                vec3 ro = uCamera;
+                vec3 rd = normalize(vLocal - ro);
+
+                // Infinite cone x^2 + z^2 = y^2, opening along +y.
+                float a = rd.x * rd.x + rd.z * rd.z - rd.y * rd.y;
+                float b = 2.0 * (ro.x * rd.x + ro.z * rd.z - ro.y * rd.y);
+                float c = ro.x * ro.x + ro.z * ro.z - ro.y * ro.y;
+
+                float t0, t1;
+                if (abs(a) < 1e-5) {
+                    if (abs(b) < 1e-6) discard;
+                    t0 = -c / b; t1 = t0;            // ray parallel to the surface
+                } else {
+                    float disc = b * b - 4.0 * a * c;
+                    if (disc < 0.0) discard;
+                    float sq = sqrt(disc);
+                    t0 = (-b - sq) / (2.0 * a);
+                    t1 = (-b + sq) / (2.0 * a);
+                    if (t0 > t1) { float tmp = t0; t0 = t1; t1 = tmp; }
+                }
+
+                // Keep the half with y in [0, 1] — the cone, not its mirror.
+                const int MAX_STEPS = 48;
+                float tEnter = max(t0, 0.0);
+                float tExit = max(t1, 0.0);
+                if (tExit <= tEnter) { tEnter = 0.0; tExit = max(t1, 0.0); }
+                if (tExit <= 0.0) discard;
+
+                float acc = 0.0;
+                float steps = clamp(uSteps, 8.0, float(MAX_STEPS));
+                float dt = (tExit - tEnter) / steps;
+                // Dither the start so slices do not band.
+                float jitter = hash(vec3(gl_FragCoord.xy, uTime)) * dt;
+
+                for (int i = 0; i < MAX_STEPS; i++) {
+                    if (float(i) >= steps) break;
+                    vec3 p = ro + rd * (tEnter + jitter + float(i) * dt);
+                    if (p.y <= 0.04 || p.y > 1.0) continue;   // skip the singular near field
+                    float r = length(p.xz) / p.y;
+                    if (r > 1.0) continue;
+
+                    vec2 uv = (p.xz / p.y) * 0.5 + 0.5;
+                    float mask = texture2D(uPattern, uv).r;
+                    if (mask < 0.004) continue;
+
+                    float edge = mix(1.0, smoothstep(1.0, 0.45, r), uPenumbra);
+                    float fall = 1.0 / (0.35 + p.y * p.y * 2.2);   // falls off from the lens, softened so the near field does not swamp the pattern
+                    float haze = 1.0;
+                    if (uNoise > 0.001) {
+                        float n = vnoise(p * 4.0 + vec3(0.0, -uTime * 0.3, uTime * 0.1));
+                        haze = mix(1.0, 0.45 + n, uNoise);
+                    }
+                    acc += mask * edge * fall * haze * dt;
+                }
+
+                gl_FragColor = vec4(uColor * uStrength * acc, 1.0);
+                ${OUTPUT}
+            }`,
+        transparent: true,
+        depthWrite: false,
+        blending: AdditiveBlending,
+        side: BackSide,
+    });
+}
+export function createSpotBeamMaterials() {
+    return {
+        lens: new MeshBasicMaterial({ color: '#0a0a0a', toneMapped: false }),
+        halo: haloMaterial(),
+        soft: softMaterial(),
+        layered: beamMaterial(),
+        volumetric: volumetricMaterial(),
+    };
+}
+export function disposeSpotBeamMaterials(m) {
+    Object.values(m).forEach((mat) => mat.dispose());
+}

package/dist/hooks/index.d.ts

@@ -45,6 +45,8 @@ export type { UseLightMouseMoveOptions } from './useLightMouseMove';
 export { useLightMouseMove } from './useLightMouseMove';
 export { useLightShadow } from './useLightShadow';
 export { LIGHT_STRUCTURAL, applyLightLive, useLightLive } from './useLightLive';
+export type { UseLightConfigResult } from './useLightConfig';
+export { applyLightConfig, useLightConfig } from './useLightConfig';
 export { useMaterialApplication } from './useMaterialApplication';
 export type { UseMaterialOptionsReturn } from './useMaterialOptions';
 export { useMaterialOptions } from './useMaterialOptions';

package/dist/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAKA,YAAY,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEhF,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhE,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE7D,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9D,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEpE,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAC3F,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtF,YAAY,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEvF,YAAY,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACtG,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/D,YAAY,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,YAAY,EAAE,4BAA4B,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AACzG,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAEhD,YAAY,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,YAAY,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEhF,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE,YAAY,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,YAAY,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC7G,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AACpG,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAE1E,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAC5G,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"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"}

package/dist/hooks/index.js

@@ -31,6 +31,7 @@ export { useLightHandlers } from './useLightHandlers.js';
 export { useLightMouseMove } from './useLightMouseMove.js';
 export { useLightShadow } from './useLightShadow.js';
 export { LIGHT_STRUCTURAL, applyLightLive, useLightLive } from './useLightLive.js';
+export { applyLightConfig, useLightConfig } from './useLightConfig.js';
 export { useMaterialApplication } from './useMaterialApplication.js';
 export { useMaterialOptions } from './useMaterialOptions.js';
 export { useMaterialUniforms } from './useMaterialUniforms.js';

package/dist/hooks/useLightConfig.d.ts

@@ -0,0 +1,25 @@
+import type { MutableRefObject, RefObject } from 'react';
+import type { Light, Object3D } from 'three';
+import type { AnimationOptions, MouseMoveDomain } from '@3driseai/3drise-core';
+/**
+ * Push a light config onto a THREE light. Only properties the light actually
+ * has are written, so one function covers every light type.
+ */
+export declare function applyLightConfig(light: Light, cfg: Record<string, any>): void;
+export interface UseLightConfigResult {
+    /** Committed config + live drags + animation overrides, refreshed every frame. */
+    merged: MutableRefObject<Record<string, any>>;
+    /** What the slider drags have written since the last commit. */
+    live: MutableRefObject<Record<string, string | number | boolean>>;
+}
+/**
+ * Registers the live-edit handle, evaluates the light's keyframe animations and
+ * its pointer bindings, and applies the merged config to the light.
+ *
+ * Call it before the component's own useFrame: R3F runs frame callbacks in
+ * subscription order, so a light with visuals of its own reads a `merged` that is
+ * already up to date for this frame.
+ */
+export declare function useLightConfig(rootRef: RefObject<Object3D | null>, lightRef: RefObject<Light | null>, id: string | undefined, config: Record<string, any>, animations: AnimationOptions[] | undefined, mouseMove?: MouseMoveDomain): UseLightConfigResult;
+export default useLightConfig;
+//# sourceMappingURL=useLightConfig.d.ts.map

package/dist/hooks/useLightConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLightConfig.d.ts","sourceRoot":"","sources":["../../src/hooks/useLightConfig.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEzD,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAS/E;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CA6B7E;AAED,MAAM,WAAW,oBAAoB;IACjC,kFAAkF;IAClF,MAAM,EAAE,gBAAgB,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IAC9C,gEAAgE;IAChE,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;CACrE;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC1B,OAAO,EAAE,SAAS,CAAC,QAAQ,GAAG,IAAI,CAAC,EACnC,QAAQ,EAAE,SAAS,CAAC,KAAK,GAAG,IAAI,CAAC,EACjC,EAAE,EAAE,MAAM,GAAG,SAAS,EACtB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,UAAU,EAAE,gBAAgB,EAAE,GAAG,SAAS,EAC1C,SAAS,CAAC,EAAE,eAAe,GAC5B,oBAAoB,CA2DtB;AAED,eAAe,cAAc,CAAC"}

package/dist/hooks/useLightConfig.js

@@ -0,0 +1,125 @@
+// =============================================================================
+// useLightConfig — one config → the THREE light, every frame
+// =============================================================================
+//
+// The light family's version of the generative config pattern (see
+// useConfigLive / configAnimations): one committed config in Redux, two
+// per-frame override layers, one merge point.
+//
+//   committed config  →  live drag overrides  →  keyframes  →  pointer (mouse move)
+//
+// `applyLightConfig` is the single door into the light: a knob it does not read
+// cannot be animated, which is exactly what core's LIGHTS_ANIMATABLE lists. The
+// merged config is also handed back through `merged`, so a light with visuals
+// of its own (the bulb's filament, glow and halo) reads the same values the
+// light got, instead of the committed config alone.
+//
+// This replaces useLightAnimation / useLightMouseMove (handleLightAnimations,
+// handleLightMouseMove) for createdObject lights: those only knew the six
+// properties of a THREE light, so a bulb's temperature, flicker or halo could
+// never be driven. LightsManager's ambient + sun still use that path — they are
+// scene lights, not config objects.
+//
+import { useEffect, useMemo, useRef } from 'react';
+import { Color } from 'three';
+import { DEFAULT_LIGHTS, getGenerativeAnimatable } from '@3driseai/3drise-core';
+import { useFrame } from '@react-three/fiber';
+import { applyConfigKeyframeAnimations, applyConfigMouseMove } from '../utils/configAnimations.js';
+import { useLightLive } from './useLightLive.js';
+import { kelvinToColor } from '../components/lightBulb/kelvin.js';
+const tmpColor = new Color();
+/**
+ * Push a light config onto a THREE light. Only properties the light actually
+ * has are written, so one function covers every light type.
+ */
+export function applyLightConfig(light, cfg) {
+    if (typeof cfg.intensity === 'number')
+        light.intensity = cfg.intensity;
+    // A type that has a colour-mode knob takes its colour from Kelvin in
+    // 'temperature' mode; everything else takes the colour knob. Read the knob
+    // rather than listing type names: `base` lays DEFAULT_LIGHTS under the config,
+    // so a type that has the knob always carries it and one that does not never
+    // will — and a new light type needs no edit here.
+    const byTemperature = typeof cfg.colorMode === 'string' && cfg.colorMode === 'temperature';
+    if (byTemperature) {
+        if (typeof cfg.temperature === 'number')
+            light.color.copy(kelvinToColor(cfg.temperature, tmpColor));
+    }
+    else if (typeof cfg.color === 'string' || cfg.color?.isColor) {
+        // A pointer binding on a colour interpolates to a THREE.Color, a keyframe
+        // or the committed config to a hex string; Color.set() takes either.
+        light.color.set(cfg.color);
+    }
+    const target = light;
+    if (typeof cfg.distance === 'number' && 'distance' in light)
+        target.distance = cfg.distance;
+    if (typeof cfg.decay === 'number' && 'decay' in light)
+        target.decay = cfg.decay;
+    if (typeof cfg.angle === 'number' && 'angle' in light)
+        target.angle = cfg.angle;
+    if (typeof cfg.penumbra === 'number' && 'penumbra' in light)
+        target.penumbra = cfg.penumbra;
+}
+/**
+ * Registers the live-edit handle, evaluates the light's keyframe animations and
+ * its pointer bindings, and applies the merged config to the light.
+ *
+ * Call it before the component's own useFrame: R3F runs frame callbacks in
+ * subscription order, so a light with visuals of its own reads a `merged` that is
+ * already up to date for this frame.
+ */
+export function useLightConfig(rootRef, lightRef, id, config, animations, mouseMove) {
+    // Fill the type's defaults under the committed config: a knob the saved config
+    // never stored (an older light has no `temperature`) has no value to drive
+    // from, and a keyframe or pointer binding on it would silently do nothing.
+    const base = useMemo(() => {
+        const merged = { ...(DEFAULT_LIGHTS[config?.type] ?? {}) };
+        // Skip undefined: a config that carries the key explicitly unset (a
+        // controller writing a cleared field) would otherwise erase the default
+        // and leave the knob with nothing to drive from.
+        for (const key of Object.keys(config ?? {})) {
+            if (config[key] !== undefined)
+                merged[key] = config[key];
+        }
+        return merged;
+    }, [config]);
+    const live = useLightLive(rootRef, lightRef, id, base);
+    const merged = useRef(base);
+    const animOverride = useRef({});
+    const animFrom = useRef({});
+    const animStart = useRef(performance.now());
+    // Editing the keyframes restarts them, and re-samples every `from`-less start value.
+    useEffect(() => {
+        animStart.current = performance.now();
+        animFrom.current = {};
+        for (const k of Object.keys(animOverride.current))
+            delete animOverride.current[k];
+    }, [animations]);
+    // A committed config supersedes the previous frame's merge until the next one.
+    useEffect(() => {
+        merged.current = base;
+    }, [base]);
+    const allowed = useMemo(() => new Set(getGenerativeAnimatable('lights', base).map((p) => p.value)), [base]);
+    useFrame((state) => {
+        const hasAnimations = !!animations?.length;
+        const hasPointer = !!mouseMove?.enabled && !!mouseMove.properties?.length;
+        const hasLive = Object.keys(live.current).length > 0;
+        if (!hasAnimations && !hasPointer && !hasLive) {
+            // Nothing overriding: the committed config is already on the light
+            // (R3F props), and useLightMouseMove owns the frame from here.
+            merged.current = base;
+            return;
+        }
+        // Keyframes first, pointer on top: a property bound to both follows the cursor.
+        applyConfigKeyframeAnimations(animations, animFrom.current, base, animOverride.current, performance.now() - animStart.current, allowed);
+        if (hasPointer)
+            applyConfigMouseMove(mouseMove.properties, base, animOverride.current, state.pointer, allowed);
+        const next = { ...base, ...live.current, ...animOverride.current };
+        merged.current = next;
+        const light = lightRef.current;
+        if (light)
+            applyLightConfig(light, next);
+    });
+    return { merged, live };
+}
+export default useLightConfig;

package/dist/hooks/useLightLive.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useLightLive.d.ts","sourceRoot":"","sources":["../../src/hooks/useLightLive.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACzD,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGvD,eAAO,MAAM,gBAAgB,EAAE,SAAS,MAAM,EAK7C,CAAC;AAKF,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAuB1H;AAED;;;GAGG;AACH,wBAAgB,YAAY,CACxB,OAAO,EAAE,SAAS,CAAC,QAAQ,GAAG,IAAI,CAAC,EACnC,QAAQ,EAAE,SAAS,CAAC,KAAK,GAAG,IAAI,CAAC,EACjC,EAAE,EAAE,MAAM,GAAG,SAAS,EACtB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC5B,gBAAgB,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAMnD;AAED,eAAe,YAAY,CAAC"}
+{"version":3,"file":"useLightLive.d.ts","sourceRoot":"","sources":["../../src/hooks/useLightLive.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACzD,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGvD,eAAO,MAAM,gBAAgB,EAAE,SAAS,MAAM,EAa7C,CAAC;AAKF,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAyB1H;AAED;;;GAGG;AACH,wBAAgB,YAAY,CACxB,OAAO,EAAE,SAAS,CAAC,QAAQ,GAAG,IAAI,CAAC,EACnC,QAAQ,EAAE,SAAS,CAAC,KAAK,GAAG,IAAI,CAAC,EACjC,EAAE,EAAE,MAAM,GAAG,SAAS,EACtB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC5B,gBAAgB,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAMnD;AAED,eAAe,YAAY,CAAC"}