@3driseai/3drise-viewer 0.1.21 → 0.1.23

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

@@ -44,6 +44,9 @@ export { useLightHandlers } from './useLightHandlers';
 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';
@@ -70,7 +73,7 @@ export type { PathAnimationOptions } from './usePathAnimation';
 export { usePathAnimation } from './usePathAnimation';
 export { useRegisterScene } from './useRegisterScene';
 export { useSequenceAnimation } from './useSequenceAnimation';
-export { useShadowApplication } from './useShadowApplication';
+export { applyShadowFlags, useShadowApplication } from './useShadowApplication';
 export { useShapeGeometry } from './useShapeGeometry';
 export type { SkyAnimValues } from './useSkyAnimation';
 export { useSkyAnimation } from './useSkyAnimation';

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

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

package/dist/hooks/index.js

@@ -30,6 +30,8 @@ export { useLightAnimation } from './useLightAnimation.js';
 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';
@@ -51,7 +53,7 @@ export { useParticlesTextures } from './useParticlesTextures.js';
 export { usePathAnimation } from './usePathAnimation.js';
 export { useRegisterScene } from './useRegisterScene.js';
 export { useSequenceAnimation } from './useSequenceAnimation.js';
-export { useShadowApplication } from './useShadowApplication.js';
+export { applyShadowFlags, useShadowApplication } from './useShadowApplication.js';
 export { useShapeGeometry } from './useShapeGeometry.js';
 export { useSkyAnimation } from './useSkyAnimation.js';
 export { useSkySystem } from './useSkySystem.js';

package/dist/hooks/useConfigLive.d.ts

@@ -1,7 +1,7 @@
 import { type MutableRefObject, type RefObject } from 'react';
 import type { Object3D } from 'three';
 /**
- * Live config editing for the generative families (particles now, effects next),
+ * Live config editing for the generative families (particles, effects) and lights,
  * the counterpart to `useOceanLive` / `useTerrainLive`.
  *
  * A slider drag fires on every pointer-move. Routing that through Redux hands the
@@ -29,7 +29,7 @@ import type { Object3D } from 'three';
 export declare const CONFIG_LIVE_KEY = "__configLive";
 export type ConfigLiveValue = number | string | boolean;
 /** Generative families that support live config editing. */
-export type ConfigLiveFamily = 'particles' | 'effects';
+export type ConfigLiveFamily = 'particles' | 'effects' | 'lights';
 export interface ConfigLiveHandle {
     id: string;
     family: ConfigLiveFamily;

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

@@ -1 +1 @@
-{"version":3,"file":"useConfigLive.d.ts","sourceRoot":"","sources":["../../src/hooks/useConfigLive.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,gBAAgB,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAChG,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAGtC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,oFAAoF;AACpF,eAAO,MAAM,eAAe,iBAAiB,CAAC;AAE9C,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAExD,4DAA4D;AAC5D,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,SAAS,CAAC;AAEvD,MAAM,WAAW,gBAAgB;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,gBAAgB,CAAC;IACzB,+DAA+D;IAC/D,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI,CAAC;CAClD;AAgBD,sFAAsF;AACtF,wBAAgB,aAAa,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG;IAAE,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI,CAAA;CAAE,CAYpG;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAC/B,OAAO,EAAE,SAAS,CAAC,QAAQ,GAAG,IAAI,CAAC,EACnC,EAAE,EAAE,MAAM,GAAG,SAAS,EACtB,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,KAAK,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,KAAK,IAAI,GAC5D,gBAAgB,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CA8BnD;AAED,eAAe,aAAa,CAAC"}
+{"version":3,"file":"useConfigLive.d.ts","sourceRoot":"","sources":["../../src/hooks/useConfigLive.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,gBAAgB,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAChG,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAGtC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,oFAAoF;AACpF,eAAO,MAAM,eAAe,iBAAiB,CAAC;AAE9C,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAExD,4DAA4D;AAC5D,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;AAElE,MAAM,WAAW,gBAAgB;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,gBAAgB,CAAC;IACzB,+DAA+D;IAC/D,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI,CAAC;CAClD;AAgBD,sFAAsF;AACtF,wBAAgB,aAAa,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG;IAAE,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI,CAAA;CAAE,CAYpG;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAC/B,OAAO,EAAE,SAAS,CAAC,QAAQ,GAAG,IAAI,CAAC,EACnC,EAAE,EAAE,MAAM,GAAG,SAAS,EACtB,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,KAAK,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,KAAK,IAAI,GAC5D,gBAAgB,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CA8BnD;AAED,eAAe,aAAa,CAAC"}

package/dist/hooks/useConfigLive.js

@@ -1,7 +1,7 @@
 import { useLayoutEffect, useMemo, useRef } from 'react';
 import { SceneStore } from '@3driseai/3drise-core';
 /**
- * Live config editing for the generative families (particles now, effects next),
+ * Live config editing for the generative families (particles, effects) and lights,
  * the counterpart to `useOceanLive` / `useTerrainLive`.
  *
  * A slider drag fires on every pointer-move. Routing that through Redux hands the

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

@@ -0,0 +1,12 @@
+import type { MutableRefObject, RefObject } from 'react';
+import type { Light, Object3D } from 'three';
+import type { ConfigLiveValue } from './useConfigLive';
+export declare const LIGHT_STRUCTURAL: readonly string[];
+export declare function applyLightLive(light: Light, overrides: Record<string, ConfigLiveValue>, config: Record<string, any>): void;
+/**
+ * Registers the live handle on `rootRef` (found by `id`) and applies drags to
+ * `lightRef`. Returns the ref of everything dragged since the last commit.
+ */
+export declare function useLightLive(rootRef: RefObject<Object3D | null>, lightRef: RefObject<Light | null>, id: string | undefined, config: Record<string, any>): MutableRefObject<Record<string, ConfigLiveValue>>;
+export default useLightLive;
+//# sourceMappingURL=useLightLive.d.ts.map

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

@@ -0,0 +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,EAU7C,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"}

package/dist/hooks/useLightLive.js

@@ -0,0 +1,53 @@
+import { useConfigLiveHandle } from './useConfigLive.js';
+import { kelvinToColor } from '../components/lightBulb/kelvin.js';
+export const LIGHT_STRUCTURAL = [
+    'shape', 'glass', 'glassTint', 'colorMode', 'on', 'targetPosition',
+    // spotBeam: the gobo is redrawn and the beam/emitter geometry is rebuilt.
+    'pattern', 'patternSoftness', 'patternRotation', 'beamMode', 'emitter',
+    // ledArray: the die layout is rebuilt. fluorescentTube: the tube geometry is.
+    'layout', 'count', 'rows', 'spacing', 'dieSize',
+    'tubes', 'tubeSpacing', 'length', 'diameter', 'startup',
+    'shadow.enabled', 'shadow.mapSize', 'shadow.cameraNear', 'shadow.cameraFar',
+    'shadow.cameraLeft', 'shadow.cameraRight', 'shadow.cameraTop', 'shadow.cameraBottom',
+    'shadow.cameraFov', 'shadow.focus',
+];
+const DIRECT = ['intensity', 'decay', 'distance', 'angle', 'penumbra'];
+const SHADOW = ['bias', 'normalBias', 'radius', 'intensity'];
+export function applyLightLive(light, overrides, config) {
+    // A type that has a colour-mode knob drives the light from either `color` or
+    // `temperature`; the plain lights only ever have `color`. Read the knob, not a
+    // list of type names — `config` here is the defaults-merged base.
+    const colorMode = typeof config?.colorMode === 'string' ? config.colorMode : 'color';
+    for (const [key, value] of Object.entries(overrides)) {
+        if (DIRECT.includes(key)) {
+            if (typeof value === 'number' && key in light)
+                light[key] = value;
+        }
+        else if (key === 'color') {
+            if (colorMode === 'color' && typeof value === 'string')
+                light.color.set(value);
+        }
+        else if (key === 'temperature') {
+            if (colorMode === 'temperature' && typeof value === 'number')
+                kelvinToColor(value, light.color);
+        }
+        else if (key.startsWith('shadow.')) {
+            const k = key.slice(7);
+            const shadow = light.shadow;
+            if (SHADOW.includes(k) && typeof value === 'number' && shadow)
+                shadow[k] = value;
+        }
+    }
+}
+/**
+ * Registers the live handle on `rootRef` (found by `id`) and applies drags to
+ * `lightRef`. Returns the ref of everything dragged since the last commit.
+ */
+export function useLightLive(rootRef, lightRef, id, config) {
+    return useConfigLiveHandle(rootRef, id, 'lights', config, LIGHT_STRUCTURAL, (overrides) => {
+        const light = lightRef.current;
+        if (light)
+            applyLightLive(light, overrides, config);
+    });
+}
+export default useLightLive;

package/dist/hooks/useShadowApplication.d.ts

@@ -1,3 +1,11 @@
+import { Object3D } from "three";
 import type { Object3DSource } from "../utils/resolveObject3D";
+/**
+ * Set castShadow / receiveShadow on every mesh under `obj`. Callers resolve an
+ * unset flag with `resolveShadowFlags(type, meshSettings)` from core, which
+ * falls back to the object type's default. Shared with ModelPrimitive, which
+ * calls it for models that attach after this hook's effect has already run.
+ */
+export declare const applyShadowFlags: (obj: Object3D, castShadow: boolean | undefined, receiveShadow: boolean | undefined) => void;
 export declare const useShadowApplication: (source: Object3DSource, castShadow: boolean | undefined, receiveShadow: boolean | undefined, triggerKey?: unknown) => void;
 //# sourceMappingURL=useShadowApplication.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"useShadowApplication.d.ts","sourceRoot":"","sources":["../../src/hooks/useShadowApplication.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/D,eAAO,MAAM,oBAAoB,GAAI,QAAQ,cAAc,EAAE,YAAY,OAAO,GAAG,SAAS,EAAE,eAAe,OAAO,GAAG,SAAS,EAAE,aAAa,OAAO,KAAG,IAgBxJ,CAAC"}
+{"version":3,"file":"useShadowApplication.d.ts","sourceRoot":"","sources":["../../src/hooks/useShadowApplication.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEjC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/D;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,KAAK,QAAQ,EAAE,YAAY,OAAO,GAAG,SAAS,EAAE,eAAe,OAAO,GAAG,SAAS,KAAG,IAwBrH,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,QAAQ,cAAc,EAAE,YAAY,OAAO,GAAG,SAAS,EAAE,eAAe,OAAO,GAAG,SAAS,EAAE,aAAa,OAAO,KAAG,IASxJ,CAAC"}