@3driseai/3drise-viewer 0.1.35 → 0.1.37

package/dist/animationsV2/ClipsRuntime.d.ts.map

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

package/dist/animationsV2/ClipsRuntime.js

@@ -136,7 +136,9 @@ class ClipsRuntime {
             return false;
         const key = targetKey(state, node, path);
         this.live.set(key, value);
-        this.written.delete(key); // a clip holding the same value must write it again
+        // The live write wins over a clip that merely HOLDS this property: the clip writes again only
+        // when its winning value moves (a UI slider beside a scrubbed story must stick while the story
+        // stands still). Previously the mark was cleared here, so the held value came straight back.
         return true;
     }
     /** What was last written by `setLiveValue`, else the authored value (action patches included). */

package/dist/components/effects/HarmonicShellEffect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HarmonicShellEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/HarmonicShellEffect.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGpG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,MAAM,WAAW,wBAAyB,SAAQ,gBAAgB;IAC9D,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,mFAAmF;IACnF,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,8EAA8E;IAC9E,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,yEAAyE;IACzE,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B;AAoMD,QAAA,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAAE,CAAC,wBAAwB,CA6C3D,CAAC;AACF,eAAe,mBAAmB,CAAC"}
+{"version":3,"file":"HarmonicShellEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/HarmonicShellEffect.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGpG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAQhE,MAAM,WAAW,wBAAyB,SAAQ,gBAAgB;IAC9D,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,mFAAmF;IACnF,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,8EAA8E;IAC9E,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,yEAAyE;IACzE,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B;AAwCD,QAAA,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAAE,CAAC,wBAAwB,CA8I3D,CAAC;AACF,eAAe,mBAAmB,CAAC"}

package/dist/components/effects/HarmonicShellEffect.js

@@ -6,166 +6,23 @@ import { withConfigDefaults } from '../../utils/configAnimations.js';
 import { DEFAULT_GENERATIVE_EFFECTS, EFFECTS_ANIMATABLE } from "@3driseai/3drise-core";
 import { useObjectReady } from '../../hooks/useObjectReady.js';
 import { useConfigDriver } from '../../hooks/useConfigDriver.js';
+import { findById } from '../../utils/sceneQuery.js';
+import { shellAttach, shellAttached, shellRelease } from '../../operations/catalogue/inShell.js';
+import { isOperationOn } from '../../operations/runtime.js';
+import { SHELL_FRAG, SHELL_VERT, bakeObjectSdf, bakeShapeSdf, createHarmonicState, createShellUniforms, registerShellField, unregisterShellField, updateHarmonicWeights, } from './harmonicShellField.js';
 /**
  * An iridescent shell around the host, displaced by real spherical harmonics
  * up to l = 4 whose weights drift slowly. The colour is thin-film
  * interference, as on a soap bubble, and the lines where the harmonic field
  * crosses zero glow.
+ *
+ * With a target (text, a shape, or another scene object) the shell becomes it:
+ * `morph` 0 → 1 traces every vertex of the sphere onto the target's distance
+ * field (see harmonicShellField.ts), the harmonics keep breathing on it, and
+ * the triangles stretched across the gaps between letters fade out.
  */
-/** Band (l) of each of the 24 real-SH terms in the shader. */
-const SH_BANDS = [1, 1, 1, 2, 2, 2, 2, 2, 3, 3, 3, 3, 3, 3, 3, 4, 4, 4, 4, 4, 4, 4, 4, 4];
-function mulberry32(seed) {
-    return () => {
-        seed |= 0;
-        seed = (seed + 0x6d2b79f5) | 0;
-        let r = Math.imul(seed ^ (seed >>> 15), 1 | seed);
-        r = (r + Math.imul(r ^ (r >>> 7), 61 | r)) ^ r;
-        return ((r ^ (r >>> 14)) >>> 0) / 4294967296;
-    };
-}
-/** Fixed per-term frequencies and phases, so the same config always moves the same way. */
-function createHarmonicState() {
-    const rand = mulberry32(7);
-    const f1 = new Float32Array(24), f2 = new Float32Array(24), p1 = new Float32Array(24), p2 = new Float32Array(24);
-    for (let i = 0; i < 24; i++) {
-        f1[i] = 0.13 + 0.3 * rand();
-        f2[i] = 0.07 + 0.2 * rand();
-        p1[i] = rand() * Math.PI * 2;
-        p2[i] = rand() * Math.PI * 2;
-    }
-    // per-band gate, eased so changing `degree` blends bands in and out
-    return { f1, f2, p1, p2, gate: new Float32Array([0, 0, 0, 0, 0]) };
-}
-/**
- * Writes the 24 weights for time T into `out`. Bands above `degree` fade
- * out; the top band leads and lower bands sit at about half strength.
- */
-function updateHarmonicWeights(state, out, T, degree, dt) {
-    const deg = Math.round(Math.min(Math.max(degree, 1), 4));
-    const ease = Math.min(1, dt * 2.5);
-    let energy = 0;
-    for (let l = 1; l <= 4; l++) {
-        // l = 1 only shifts the shell sideways, so it stays quiet unless it is the only band
-        const target = l > deg ? 0 : l === deg ? 1 : l === 1 ? 0.2 : 0.55;
-        state.gate[l] += (target - state.gate[l]) * ease;
-        energy += state.gate[l] * state.gate[l] * (2 * l + 1);
-    }
-    const norm = 1 / Math.sqrt(Math.max(energy / 5, 1e-3));
-    for (let i = 0; i < 24; i++) {
-        const g = state.gate[SH_BANDS[i]];
-        out[i] = g * norm * (0.7 * Math.sin(T * state.f1[i] + state.p1[i]) + 0.3 * Math.sin(T * state.f2[i] + state.p2[i]));
-    }
-}
-const vert = /* glsl */ `
-  uniform float uW[24];
-  uniform float uAmplitude;
-  uniform float uBound;
-  uniform float uSizeMultiplier;
-  varying vec3  vNormal;
-  varying vec3  vViewDir;
-  varying float vField;
-
-  // Real spherical harmonics for l = 1..4, as polynomials in the unit vector,
-  // each scaled so its peak is about 1. The CPU animates the 24 weights.
-  float sh(vec3 n){
-    float x = n.x, y = n.y, z = n.z;
-    float x2 = x * x, y2 = y * y, z2 = z * z;
-    float s = 0.0;
-    s += uW[0] * y + uW[1] * z + uW[2] * x;
-    s += uW[3] * 2.0 * x * y + uW[4] * 2.0 * y * z + uW[5] * (1.5 * z2 - 0.5)
-       + uW[6] * 2.0 * x * z + uW[7] * (x2 - y2);
-    s += uW[8]  * y * (3.0 * x2 - y2)
-       + uW[9]  * 5.2 * x * y * z
-       + uW[10] * 0.8 * y * (5.0 * z2 - 1.0)
-       + uW[11] * 0.5 * z * (5.0 * z2 - 3.0)
-       + uW[12] * 0.8 * x * (5.0 * z2 - 1.0)
-       + uW[13] * 2.6 * z * (x2 - y2)
-       + uW[14] * x * (x2 - 3.0 * y2);
-    s += uW[15] * 4.0 * x * y * (x2 - y2)
-       + uW[16] * 3.0 * y * z * (3.0 * x2 - y2)
-       + uW[17] * 1.5 * x * y * (7.0 * z2 - 1.0)
-       + uW[18] * 0.95 * y * z * (7.0 * z2 - 3.0)
-       + uW[19] * 0.125 * (35.0 * z2 * z2 - 30.0 * z2 + 3.0)
-       + uW[20] * 0.95 * x * z * (7.0 * z2 - 3.0)
-       + uW[21] * 0.78 * (x2 - y2) * (7.0 * z2 - 1.0)
-       + uW[22] * 3.0 * x * z * (x2 - 3.0 * y2)
-       + uW[23] * (x2 * (x2 - 3.0 * y2) - y2 * (3.0 * x2 - y2));
-    return s;
-  }
-
-  vec3 shellPoint(vec3 n, out float f){
-    f = sh(n);
-    return n * uBound * uSizeMultiplier * (1.0 + uAmplitude * f);
-  }
-
-  void main(){
-    vec3 n = normalize(position);
-    float f, f1, f2;
-    vec3 p0 = shellPoint(n, f);
-
-    // normal from two nearby points on the displaced surface
-    vec3 up = abs(n.y) > 0.99 ? vec3(1.0, 0.0, 0.0) : vec3(0.0, 1.0, 0.0);
-    vec3 t1 = normalize(cross(n, up));
-    vec3 t2 = cross(n, t1);
-    vec3 p1 = shellPoint(normalize(n + t1 * 0.01), f1);
-    vec3 p2 = shellPoint(normalize(n + t2 * 0.01), f2);
-    vec3 nrm = normalize(cross(p1 - p0, p2 - p0));
-    if (dot(nrm, n) < 0.0) nrm = -nrm;
-
-    vField = f;
-    vec4 mv = modelViewMatrix * vec4(p0, 1.0);
-    vNormal = normalize(normalMatrix * nrm);
-    vViewDir = normalize(-mv.xyz);
-    gl_Position = projectionMatrix * mv;
-  }
-`;
-const frag = /* glsl */ `
-  uniform vec3  uColor;
-  uniform vec3  uRimColor;
-  uniform float uOpacity;
-  uniform float uIntensity;
-  uniform float uFilmThickness;
-  uniform float uNodalLines;
-  uniform float uTint;
-  varying vec3  vNormal;
-  varying vec3  vViewDir;
-  varying float vField;
-
-  const float TAU = 6.28318530718;
-
-  void main(){
-    vec3 N = normalize(vNormal);
-    vec3 V = normalize(vViewDir);
-    float ndv = abs(dot(N, V));
-
-    // Thin-film interference, as on a soap bubble: a film of index 1.33 and
-    // thickness d delays the inner reflection by 2*n*d*cos(theta_t). Each
-    // wavelength interferes on its own, which splits white light into bands.
-    // The film is thicker where the harmonic pushes the shell out, so the
-    // colour bands follow the shape.
-    float cosT = sqrt(max(1.0 - (1.0 - ndv * ndv) / (1.33 * 1.33), 0.0));
-    float opd  = 2.0 * 1.33 * uFilmThickness * (1.0 + 0.35 * vField) * cosT;
-    vec3 film  = 0.5 + 0.5 * cos(TAU * opd / vec3(650.0, 532.0, 450.0));
-    // tint: keep the film's light and dark bands, carry them in the base colour
-    float lum  = dot(film, vec3(0.299, 0.587, 0.114));
-    film = mix(film, lum * uColor * 1.7 + film * 0.12, uTint);
-
-    float fres = pow(1.0 - ndv, 3.0);
-    vec3 col = uColor * 0.25 + film * (0.2 + 0.8 * fres);
-    col = mix(col, uRimColor, fres * 0.45);
-
-    // nodal lines: where the harmonic field crosses zero
-    float nd = abs(vField) / max(fwidth(vField), 1e-4);
-    float nodal = (1.0 - smoothstep(0.5, 1.5, nd)) * uNodalLines;
-    col += uRimColor * nodal * 1.5;
-
-    float a = (0.06 + 0.9 * fres + nodal * 0.8) * uOpacity;
-    if (a < 0.003) discard;
-    gl_FragColor = vec4(col * uIntensity, a);
-  }
-`;
-/** Nothing rebuilds the shell: the vertex shader displaces a unit sphere. */
-const STRUCTURAL = [];
+/** Knobs that rebuild the target field (never driven per frame). The sphere itself never rebuilds. */
+const STRUCTURAL = ['target', 'text', 'font', 'shape', 'targetObject'];
 /** Knobs a keyframe or pointer binding may drive per frame — exactly what applyConfig pushes. */
 const ANIMATABLE = new Set(EFFECTS_ANIMATABLE.harmonicShell.map((p) => p.value));
 /** The single push point: every config knob reaches its uniform here. */
@@ -173,15 +30,19 @@ function applyConfig(u, c, bound) {
     u.uSpeed.value = c.speed;
     u.uIntensity.value = c.intensity;
     u.uOpacity.value = c.opacity;
-    u.uColor.value.set(c.color);
-    u.uRimColor.value.set(c.rimColor);
-    u.uAmplitude.value = c.amplitude;
-    u.uBound.value = bound;
-    u.uSizeMultiplier.value = c.sizeMultiplier;
-    u.uFilmThickness.value = c.filmThickness;
+    u.uHshColor.value.set(c.color);
+    u.uHshRim.value.set(c.rimColor);
+    u.uHshAmplitude.value = c.amplitude;
+    u.uHshBound.value = bound;
+    u.uHshSize.value = c.sizeMultiplier;
+    u.uHshFilm.value = c.filmThickness;
     u.uNodalLines.value = c.nodalLines;
     u.uDegree.value = c.degree;
-    u.uTint.value = c.tint ?? 0;
+    u.uHshTint.value = c.tint ?? 0;
+    u.uHshMorph.value = c.morph ?? 0;
+    u.uHshDepth.value = (c.depth ?? 0.25) * bound;
+    u.uBreath.value = c.breath ?? 0.12;
+    u.uWeb.value = (c.webCut ?? 0.02) * bound;
 }
 const HarmonicShellEffect = ({ boundingRadius, config, id, keyframes, mouseMove, onObjectReady, onObjectDispose }) => {
     const cfg = useMemo(() => withConfigDefaults(DEFAULT_GENERATIVE_EFFECTS.harmonicShell, config), [config]);
@@ -189,34 +50,165 @@ const HarmonicShellEffect = ({ boundingRadius, config, id, keyframes, mouseMove,
     useObjectReady(rootRef, config, onObjectReady, onObjectDispose);
     const state = useMemo(createHarmonicState, []);
     const uniforms = useMemo(() => ({
-        uTime: { value: 0 },
+        ...createShellUniforms(),
         uSpeed: { value: 1 },
         uIntensity: { value: 1 },
         uOpacity: { value: 1 },
-        uColor: { value: new THREE.Color() },
-        uRimColor: { value: new THREE.Color() },
-        uAmplitude: { value: 0.22 },
-        uBound: { value: 1 },
-        uSizeMultiplier: { value: 1.35 },
-        uFilmThickness: { value: 380 },
         uNodalLines: { value: 0.6 },
         uDegree: { value: 3 },
-        uTint: { value: 0 },
-        uW: { value: new Float32Array(24) },
+        uBreath: { value: 0.12 },
+        uWeb: { value: 0.02 },
     }), []);
-    const material = useMemo(() => new THREE.ShaderMaterial({ vertexShader: vert, fragmentShader: frag, uniforms, transparent: true, depthWrite: false, blending: THREE.AdditiveBlending }), [uniforms]);
+    const material = useMemo(() => new THREE.ShaderMaterial({ vertexShader: SHELL_VERT, fragmentShader: SHELL_FRAG, uniforms, transparent: true, depthWrite: false, blending: THREE.AdditiveBlending, side: THREE.DoubleSide }), [uniforms]);
     useEffect(() => () => material.dispose(), [material]);
     // the vertex shader displaces a unit sphere, so the mesh never needs rebuilding
     const geometry = useMemo(() => new THREE.SphereGeometry(1, 192, 128), []);
     useEffect(() => () => geometry.dispose(), [geometry]);
+    // the field other objects read (the inShell effect): registered while mounted
+    const field = useMemo(() => ({ root: null, uniforms: uniforms, inv: new THREE.Matrix4(), target: null }), [uniforms]);
+    useEffect(() => {
+        if (!rootRef.current)
+            return;
+        field.root = rootRef.current;
+        registerShellField(field);
+        return () => unregisterShellField(field);
+    }, [field]);
     const push = useCallback((merged) => {
         applyConfig(uniforms, merged, boundingRadius);
     }, [uniforms, boundingRadius]);
     useLayoutEffect(() => { push(cfg); }, [push, cfg]);
     useConfigDriver({ rootRef, id, family: 'effects', base: cfg, structural: STRUCTURAL, allowed: ANIMATABLE, keyframes, mouseMove, push });
+    // ── the target field: rebuilt when a structural knob changes ──
+    const targetKind = cfg.target ?? 'none';
+    const targetObjectId = cfg.targetObject ?? '';
+    const targetRef = useRef(null);
+    useEffect(() => {
+        let cancelled = false;
+        const u = uniforms;
+        targetRef.current = null;
+        field.target = null;
+        if (targetKind === 'text' || targetKind === 'shape') {
+            const kind = targetKind === 'text' ? 'text' : (cfg.shape ?? 'star');
+            // the field spans a little more than the resting shell, so letters can reach past the sphere
+            bakeShapeSdf(kind, String(cfg.text ?? ''), String(cfg.font ?? 'sans'), boundingRadius * cfg.sizeMultiplier * 1.15).then((sdf) => {
+                if (cancelled || !sdf)
+                    return;
+                const old = u.uHshSdf.value;
+                u.uHshSdf.value = sdf.tex;
+                u.uHshSdfHalf.value.set(sdf.half, sdf.half);
+                u.uHshMode.value = 1;
+                if (old && old.image?.width > 1)
+                    old.dispose();
+            });
+        }
+        else if (targetKind === 'object' && targetObjectId) {
+            // the object may land after us (a model loading): look again until it is there
+            let tries = 0;
+            const find = () => {
+                if (cancelled)
+                    return;
+                const obj = findById(targetObjectId);
+                if (!obj) {
+                    if (tries++ < 60)
+                        setTimeout(find, 500);
+                    else
+                        console.warn(`[harmonicShell] target object "${targetObjectId}" not found in the scene`);
+                    return;
+                }
+                bakeObjectSdf(obj).then((sdf) => {
+                    if (cancelled || !sdf)
+                        return;
+                    targetRef.current = obj;
+                    field.target = obj;
+                    u.uHshSdf3.value = sdf.tex;
+                    u.uHshSdf3Min.value.copy(sdf.min);
+                    u.uHshSdf3Size.value.copy(sdf.size);
+                    u.uHshMode.value = 2;
+                }).catch((err) => console.warn('[harmonicShell] object field bake failed', err));
+            };
+            find();
+        }
+        else {
+            u.uHshMode.value = 0;
+        }
+        return () => { cancelled = true; };
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [targetKind, targetObjectId, cfg.text, cfg.font, cfg.shape, boundingRadius, uniforms, field]);
+    // ── objects crossing the shell show it: the inShell layer, attached and released at runtime ──
+    const inside = useMemo(() => ({ frame: 0, on: new Set(), box: new THREE.Box3(), sphere: new THREE.Sphere(), centre: new THREE.Vector3(), scale: new THREE.Vector3() }), []);
+    // the objects the shell affects (ids on the shell's config; nothing on them). Looked up each scan: they may land later or be replaced.
+    const insideIds = useMemo(() => (Array.isArray(cfg.insideObjects) ? cfg.insideObjects.filter((v) => typeof v === 'string' && v) : []), [cfg.insideObjects]);
+    const insideIdsRef = useRef(insideIds);
+    insideIdsRef.current = insideIds;
+    const look = useMemo(() => ({ look: cfg.insideLook === 'ghost' ? 'ghost' : 'film', bands: cfg.insideBands ?? 1, seam: cfg.insideSeam ?? 1, warp: cfg.insideWarp ?? 0.6, core: cfg.insideCore ?? 0.5 }), [cfg.insideLook, cfg.insideBands, cfg.insideSeam, cfg.insideWarp, cfg.insideCore]);
+    const lookRef = useRef(look);
+    lookRef.current = look;
+    // the look changed: push it to everything the shell is on
+    useEffect(() => { inside.on.forEach((o) => shellAttach(o, look)); }, [look, inside]);
+    useEffect(() => () => { inside.on.forEach((o) => shellRelease(o)); inside.on.clear(); }, [inside]);
+    // Objects not on the list are never touched. No separate pre-warm: the runtime's warm pass applies and quietly reverts the operation, and
+    // that revert would strip a layer the shell has just attached. The attach compiles its program
+    // in the background before anything shows (runProgress), and fires when the bounds touch — before
+    // any pixel is inside — so the compile is hidden on the first crossing.
+    const scanInside = () => {
+        const root = rootRef.current;
+        if (!root)
+            return;
+        const ids = insideIdsRef.current;
+        if (!ids.length) {
+            if (inside.on.size) {
+                inside.on.forEach((o) => shellRelease(o));
+                inside.on.clear();
+            }
+            return;
+        }
+        inside.centre.setFromMatrixPosition(root.matrixWorld);
+        root.matrixWorld.decompose(new THREE.Vector3(), new THREE.Quaternion(), inside.scale);
+        const R = uniforms.uHshBound.value * uniforms.uHshSize.value * (1 + uniforms.uHshAmplitude.value) * Math.max(inside.scale.x, inside.scale.y, inside.scale.z);
+        const seen = new Set();
+        for (const id of ids) {
+            const o = findById(id);
+            // objects with real meshes (mesh / model); the shell's own wrap target is the shell, not something inside it
+            if (!o || o.userData?.visualFx !== true || o.userData.objectType === 'group' || o === targetRef.current || !o.visible)
+                continue;
+            inside.box.setFromObject(o);
+            if (inside.box.isEmpty())
+                continue;
+            inside.box.getBoundingSphere(inside.sphere);
+            const d = inside.sphere.center.distanceTo(inside.centre);
+            const was = inside.on.has(o);
+            // a little hysteresis, so an object resting on the boundary doesn't flicker on and off
+            if (d < R + inside.sphere.radius * (was ? 1.15 : 1.0))
+                seen.add(o);
+        }
+        for (const o of seen)
+            if (!inside.on.has(o) && shellAttach(o, lookRef.current, isOperationOn('inShell', o)))
+                inside.on.add(o);
+        for (const o of inside.on)
+            if (!seen.has(o)) {
+                inside.on.delete(o);
+                shellRelease(o);
+            }
+        for (const o of inside.on)
+            if (!shellAttached(o))
+                inside.on.delete(o); // taken away underneath (an own effect reverted) → re-attached next scan
+    };
+    const _m = useMemo(() => new THREE.Matrix4(), []);
     useFrame((_, delta) => {
-        uniforms.uTime.value += delta * uniforms.uSpeed.value;
-        updateHarmonicWeights(state, uniforms.uW.value, uniforms.uTime.value, uniforms.uDegree.value, delta);
+        if (++inside.frame % 6 === 0)
+            scanInside();
+        uniforms.uHshTime.value += delta * uniforms.uSpeed.value;
+        updateHarmonicWeights(state, uniforms.uHshW.value, uniforms.uHshTime.value, uniforms.uDegree.value, delta);
+        const root = rootRef.current;
+        if (root) {
+            field.inv.copy(root.matrixWorld).invert();
+            const t = targetRef.current;
+            // shell-local → the target object's local space (where its field was baked), live: both may move
+            if (t && uniforms.uHshMode.value === 2) {
+                uniforms.uHshSdf3Inv.value.copy(_m.copy(t.matrixWorld).invert()).multiply(root.matrixWorld);
+                uniforms.uHshSdf3Mat.value.copy(uniforms.uHshSdf3Inv.value).invert();
+            }
+        }
     });
     return (_jsx("group", { ref: rootRef, children: _jsx("mesh", { geometry: geometry, material: material }) }));
 };

package/dist/components/effects/harmonicShellField.d.ts

@@ -0,0 +1,77 @@
+import * as THREE from 'three';
+import type { Object3D } from 'three';
+export interface HarmonicState {
+    f1: Float32Array;
+    f2: Float32Array;
+    p1: Float32Array;
+    p2: Float32Array;
+    gate: Float32Array;
+}
+/** Fixed per-term frequencies and phases, so the same config always moves the same way. */
+export declare function createHarmonicState(): HarmonicState;
+/**
+ * Writes the 24 weights for time T into `out`. Bands above `degree` fade
+ * out; the top band leads and lower bands sit at about half strength.
+ */
+export declare function updateHarmonicWeights(state: HarmonicState, out: Float32Array, T: number, degree: number, dt: number): void;
+/** The shared uniforms, declared (the shell's own ShaderMaterial; a layered material gets them from the kit). */
+export declare const HSH_FIELD_DECL = "\n  uniform float uHshW[24];\n  uniform float uHshAmplitude; uniform float uHshBound; uniform float uHshSize;\n  uniform vec3 uHshColor; uniform vec3 uHshRim; uniform float uHshFilm; uniform float uHshTint; uniform float uHshTime;\n  uniform float uHshMorph; uniform float uHshMode;\n  uniform sampler2D uHshSdf; uniform vec2 uHshSdfHalf; uniform float uHshDepth;\n  uniform sampler3D uHshSdf3; uniform vec3 uHshSdf3Min; uniform vec3 uHshSdf3Size; uniform mat4 uHshSdf3Inv; uniform mat4 uHshSdf3Mat;\n";
+/**
+ * The field, for any shader (after the declarations): the harmonic polynomial, the
+ * thin film, and the target distance functions. Include once per stage.
+ */
+export declare const HSH_FIELD_FUNCS = "\n\n  // Real spherical harmonics for l = 1..4, as polynomials in the unit vector,\n  // each scaled so its peak is about 1. The CPU animates the 24 weights.\n  float hshSh(vec3 n){\n    float x = n.x, y = n.y, z = n.z;\n    float x2 = x * x, y2 = y * y, z2 = z * z;\n    float s = 0.0;\n    s += uHshW[0] * y + uHshW[1] * z + uHshW[2] * x;\n    s += uHshW[3] * 2.0 * x * y + uHshW[4] * 2.0 * y * z + uHshW[5] * (1.5 * z2 - 0.5)\n       + uHshW[6] * 2.0 * x * z + uHshW[7] * (x2 - y2);\n    s += uHshW[8]  * y * (3.0 * x2 - y2)\n       + uHshW[9]  * 5.2 * x * y * z\n       + uHshW[10] * 0.8 * y * (5.0 * z2 - 1.0)\n       + uHshW[11] * 0.5 * z * (5.0 * z2 - 3.0)\n       + uHshW[12] * 0.8 * x * (5.0 * z2 - 1.0)\n       + uHshW[13] * 2.6 * z * (x2 - y2)\n       + uHshW[14] * x * (x2 - 3.0 * y2);\n    s += uHshW[15] * 4.0 * x * y * (x2 - y2)\n       + uHshW[16] * 3.0 * y * z * (3.0 * x2 - y2)\n       + uHshW[17] * 1.5 * x * y * (7.0 * z2 - 1.0)\n       + uHshW[18] * 0.95 * y * z * (7.0 * z2 - 3.0)\n       + uHshW[19] * 0.125 * (35.0 * z2 * z2 - 30.0 * z2 + 3.0)\n       + uHshW[20] * 0.95 * x * z * (7.0 * z2 - 3.0)\n       + uHshW[21] * 0.78 * (x2 - y2) * (7.0 * z2 - 1.0)\n       + uHshW[22] * 3.0 * x * z * (x2 - 3.0 * y2)\n       + uHshW[23] * (x2 * (x2 - 3.0 * y2) - y2 * (3.0 * x2 - y2));\n    return s;\n  }\n\n  // The resting shell: radius along direction n, in shell-local units.\n  float hshRadius(vec3 n, out float field){\n    field = hshSh(n);\n    return uHshBound * uHshSize * (1.0 + uHshAmplitude * field);\n  }\n\n  // Thin-film interference, as on a soap bubble: a film of index 1.33 and\n  // thickness d delays the inner reflection by 2*n*d*cos(theta_t). Each\n  // wavelength interferes on its own, which splits white light into bands.\n  vec3 hshFilm(float ndv, float field){\n    float cosT = sqrt(max(1.0 - (1.0 - ndv * ndv) / (1.33 * 1.33), 0.0));\n    float opd  = 2.0 * 1.33 * uHshFilm * (1.0 + 0.35 * field) * cosT;\n    vec3 film  = 0.5 + 0.5 * cos(6.28318530718 * opd / vec3(650.0, 532.0, 450.0));\n    float lum  = dot(film, vec3(0.299, 0.587, 0.114));\n    return mix(film, lum * uHshColor * 1.7 + film * 0.12, uHshTint);\n  }\n\n  // \u2500\u2500 the target: signed distance in shell-local units (negative inside) \u2500\u2500\n  float hshSdf2(vec2 p){\n    vec2 uv = p / (2.0 * uHshSdfHalf) + 0.5;\n    vec2 c = clamp(uv, 0.0, 1.0);\n    return texture2D(uHshSdf, c).r + length((uv - c) * 2.0 * uHshSdfHalf);\n  }\n  float hshSdf(vec3 p){\n    if (uHshMode > 1.5) {\n      // an object's own field, baked in its local space\n      vec3 q = (uHshSdf3Inv * vec4(p, 1.0)).xyz;\n      vec3 uvw = (q - uHshSdf3Min) / uHshSdf3Size; vec3 c = clamp(uvw, 0.0, 1.0);\n      return texture(uHshSdf3, c).r + length((uvw - c) * uHshSdf3Size);\n    }\n    // text / shape: the 2D field extruded to \u00B1depth\n    float d2 = hshSdf2(p.xy); float dz = abs(p.z) - uHshDepth;\n    vec2 w = max(vec2(d2, dz), 0.0);\n    return min(max(d2, dz), 0.0) + length(w);\n  }\n  vec3 hshSdfGrad(vec3 p){\n    float e = 0.012;\n    vec3 g = vec3(hshSdf(p + vec3(e, 0, 0)) - hshSdf(p - vec3(e, 0, 0)),\n                  hshSdf(p + vec3(0, e, 0)) - hshSdf(p - vec3(0, e, 0)),\n                  hshSdf(p + vec3(0, 0, e)) - hshSdf(p - vec3(0, 0, e)));\n    float l = length(g); return l > 1e-6 ? g / l : vec3(0.0, 0.0, 1.0);\n  }\n\n  // Signed distance from a shell-local point to the shell's CURRENT surface\n  // (the resting shell blended with the target by uHshMorph). 'field' is the\n  // harmonic value in that direction, for the film.\n  // Where a sphere vertex starts its trace: the resting shell point stretched to the\n  // target's extent, so a wide word or a long object gets vertices along its whole length\n  // instead of everything converging on the part nearest the centre.\n  vec3 hshTraceStart(vec3 p0){\n    float R0 = uHshBound * uHshSize;\n    if (uHshMode > 1.5) {\n      vec3 c = uHshSdf3Min + 0.5 * uHshSdf3Size;        // the target's centre, in its own space\n      vec3 h = uHshSdf3Size * 0.44;                       // half extents (the baked box is padded 12%)\n      vec3 ct = (uHshSdf3Inv * vec4(0.0, 0.0, 0.0, 1.0)).xyz;\n      vec3 qt = (uHshSdf3Inv * vec4(p0, 1.0)).xyz;\n      qt = c + (qt - ct) * (h / R0);\n      return (uHshSdf3Mat * vec4(qt, 1.0)).xyz;\n    }\n    return p0 * vec3(uHshSdfHalf / R0, max(uHshDepth, 0.05) / R0);\n  }\n\n  float hshDist(vec3 p, out float field){\n    float r = length(p); vec3 n = r > 1e-5 ? p / r : vec3(0.0, 1.0, 0.0);\n    float dS = r - hshRadius(n, field);\n    return uHshMode > 0.5 && uHshMorph > 0.0 ? mix(dS, hshSdf(p), uHshMorph) : dS;\n  }\n";
+/** Declarations + functions: the whole field for a shader that declares nothing itself. */
+export declare const HSH_FIELD_GLSL: string;
+/** The shell's own material: the sphere displaced by the field, traced onto the target when it has one. */
+export declare const SHELL_VERT = "\n  uniform float uBreath;\n  varying vec3  vNormal;\n  varying vec3  vViewDir;\n  varying float vField;\n  varying vec3  vLocal;\n  \n  uniform float uHshW[24];\n  uniform float uHshAmplitude; uniform float uHshBound; uniform float uHshSize;\n  uniform vec3 uHshColor; uniform vec3 uHshRim; uniform float uHshFilm; uniform float uHshTint; uniform float uHshTime;\n  uniform float uHshMorph; uniform float uHshMode;\n  uniform sampler2D uHshSdf; uniform vec2 uHshSdfHalf; uniform float uHshDepth;\n  uniform sampler3D uHshSdf3; uniform vec3 uHshSdf3Min; uniform vec3 uHshSdf3Size; uniform mat4 uHshSdf3Inv; uniform mat4 uHshSdf3Mat;\n\n\n  // Real spherical harmonics for l = 1..4, as polynomials in the unit vector,\n  // each scaled so its peak is about 1. The CPU animates the 24 weights.\n  float hshSh(vec3 n){\n    float x = n.x, y = n.y, z = n.z;\n    float x2 = x * x, y2 = y * y, z2 = z * z;\n    float s = 0.0;\n    s += uHshW[0] * y + uHshW[1] * z + uHshW[2] * x;\n    s += uHshW[3] * 2.0 * x * y + uHshW[4] * 2.0 * y * z + uHshW[5] * (1.5 * z2 - 0.5)\n       + uHshW[6] * 2.0 * x * z + uHshW[7] * (x2 - y2);\n    s += uHshW[8]  * y * (3.0 * x2 - y2)\n       + uHshW[9]  * 5.2 * x * y * z\n       + uHshW[10] * 0.8 * y * (5.0 * z2 - 1.0)\n       + uHshW[11] * 0.5 * z * (5.0 * z2 - 3.0)\n       + uHshW[12] * 0.8 * x * (5.0 * z2 - 1.0)\n       + uHshW[13] * 2.6 * z * (x2 - y2)\n       + uHshW[14] * x * (x2 - 3.0 * y2);\n    s += uHshW[15] * 4.0 * x * y * (x2 - y2)\n       + uHshW[16] * 3.0 * y * z * (3.0 * x2 - y2)\n       + uHshW[17] * 1.5 * x * y * (7.0 * z2 - 1.0)\n       + uHshW[18] * 0.95 * y * z * (7.0 * z2 - 3.0)\n       + uHshW[19] * 0.125 * (35.0 * z2 * z2 - 30.0 * z2 + 3.0)\n       + uHshW[20] * 0.95 * x * z * (7.0 * z2 - 3.0)\n       + uHshW[21] * 0.78 * (x2 - y2) * (7.0 * z2 - 1.0)\n       + uHshW[22] * 3.0 * x * z * (x2 - 3.0 * y2)\n       + uHshW[23] * (x2 * (x2 - 3.0 * y2) - y2 * (3.0 * x2 - y2));\n    return s;\n  }\n\n  // The resting shell: radius along direction n, in shell-local units.\n  float hshRadius(vec3 n, out float field){\n    field = hshSh(n);\n    return uHshBound * uHshSize * (1.0 + uHshAmplitude * field);\n  }\n\n  // Thin-film interference, as on a soap bubble: a film of index 1.33 and\n  // thickness d delays the inner reflection by 2*n*d*cos(theta_t). Each\n  // wavelength interferes on its own, which splits white light into bands.\n  vec3 hshFilm(float ndv, float field){\n    float cosT = sqrt(max(1.0 - (1.0 - ndv * ndv) / (1.33 * 1.33), 0.0));\n    float opd  = 2.0 * 1.33 * uHshFilm * (1.0 + 0.35 * field) * cosT;\n    vec3 film  = 0.5 + 0.5 * cos(6.28318530718 * opd / vec3(650.0, 532.0, 450.0));\n    float lum  = dot(film, vec3(0.299, 0.587, 0.114));\n    return mix(film, lum * uHshColor * 1.7 + film * 0.12, uHshTint);\n  }\n\n  // \u2500\u2500 the target: signed distance in shell-local units (negative inside) \u2500\u2500\n  float hshSdf2(vec2 p){\n    vec2 uv = p / (2.0 * uHshSdfHalf) + 0.5;\n    vec2 c = clamp(uv, 0.0, 1.0);\n    return texture2D(uHshSdf, c).r + length((uv - c) * 2.0 * uHshSdfHalf);\n  }\n  float hshSdf(vec3 p){\n    if (uHshMode > 1.5) {\n      // an object's own field, baked in its local space\n      vec3 q = (uHshSdf3Inv * vec4(p, 1.0)).xyz;\n      vec3 uvw = (q - uHshSdf3Min) / uHshSdf3Size; vec3 c = clamp(uvw, 0.0, 1.0);\n      return texture(uHshSdf3, c).r + length((uvw - c) * uHshSdf3Size);\n    }\n    // text / shape: the 2D field extruded to \u00B1depth\n    float d2 = hshSdf2(p.xy); float dz = abs(p.z) - uHshDepth;\n    vec2 w = max(vec2(d2, dz), 0.0);\n    return min(max(d2, dz), 0.0) + length(w);\n  }\n  vec3 hshSdfGrad(vec3 p){\n    float e = 0.012;\n    vec3 g = vec3(hshSdf(p + vec3(e, 0, 0)) - hshSdf(p - vec3(e, 0, 0)),\n                  hshSdf(p + vec3(0, e, 0)) - hshSdf(p - vec3(0, e, 0)),\n                  hshSdf(p + vec3(0, 0, e)) - hshSdf(p - vec3(0, 0, e)));\n    float l = length(g); return l > 1e-6 ? g / l : vec3(0.0, 0.0, 1.0);\n  }\n\n  // Signed distance from a shell-local point to the shell's CURRENT surface\n  // (the resting shell blended with the target by uHshMorph). 'field' is the\n  // harmonic value in that direction, for the film.\n  // Where a sphere vertex starts its trace: the resting shell point stretched to the\n  // target's extent, so a wide word or a long object gets vertices along its whole length\n  // instead of everything converging on the part nearest the centre.\n  vec3 hshTraceStart(vec3 p0){\n    float R0 = uHshBound * uHshSize;\n    if (uHshMode > 1.5) {\n      vec3 c = uHshSdf3Min + 0.5 * uHshSdf3Size;        // the target's centre, in its own space\n      vec3 h = uHshSdf3Size * 0.44;                       // half extents (the baked box is padded 12%)\n      vec3 ct = (uHshSdf3Inv * vec4(0.0, 0.0, 0.0, 1.0)).xyz;\n      vec3 qt = (uHshSdf3Inv * vec4(p0, 1.0)).xyz;\n      qt = c + (qt - ct) * (h / R0);\n      return (uHshSdf3Mat * vec4(qt, 1.0)).xyz;\n    }\n    return p0 * vec3(uHshSdfHalf / R0, max(uHshDepth, 0.05) / R0);\n  }\n\n  float hshDist(vec3 p, out float field){\n    float r = length(p); vec3 n = r > 1e-5 ? p / r : vec3(0.0, 1.0, 0.0);\n    float dS = r - hshRadius(n, field);\n    return uHshMode > 0.5 && uHshMorph > 0.0 ? mix(dS, hshSdf(p), uHshMorph) : dS;\n  }\n\n\n  vec3 shellPoint(vec3 n, out float f){ return n * hshRadius(n, f); }\n\n  void main(){\n    vec3 n = normalize(position);\n    float f, f1, f2;\n    vec3 p0 = shellPoint(n, f);\n\n    // normal from two nearby points on the displaced surface\n    vec3 up = abs(n.y) > 0.99 ? vec3(1.0, 0.0, 0.0) : vec3(0.0, 1.0, 0.0);\n    vec3 t1 = normalize(cross(n, up));\n    vec3 t2 = cross(n, t1);\n    vec3 p1 = shellPoint(normalize(n + t1 * 0.01), f1);\n    vec3 p2 = shellPoint(normalize(n + t2 * 0.01), f2);\n    vec3 nrm = normalize(cross(p1 - p0, p2 - p0));\n    if (dot(nrm, n) < 0.0) nrm = -nrm;\n\n    vec3 p = p0; vec3 N = nrm;\n    if (uHshMode > 0.5 && uHshMorph > 0.0) {\n      // trace the vertex onto the target surface along the field's gradient\n      vec3 q = hshTraceStart(p0);\n      for (int i = 0; i < 12; i++) { float d = hshSdf(q); q -= d * hshSdfGrad(q) * 0.85; }\n      vec3 g = hshSdfGrad(q);\n      // the harmonics keep breathing on the target, along its normal\n      q += g * uHshBound * uHshAmplitude * uBreath * f;\n      p = mix(p0, q, uHshMorph);\n      N = normalize(mix(nrm, g, uHshMorph));\n    }\n\n    vLocal = p;\n    vField = f;\n    vec4 mv = modelViewMatrix * vec4(p, 1.0);\n    vNormal = normalize(normalMatrix * N);\n    vViewDir = normalize(-mv.xyz);\n    gl_Position = projectionMatrix * mv;\n  }\n";
+export declare const SHELL_FRAG = "\n  uniform float uOpacity;\n  uniform float uIntensity;\n  uniform float uNodalLines;\n  uniform float uWeb;\n  varying vec3  vNormal;\n  varying vec3  vViewDir;\n  varying float vField;\n  varying vec3  vLocal;\n  \n  uniform float uHshW[24];\n  uniform float uHshAmplitude; uniform float uHshBound; uniform float uHshSize;\n  uniform vec3 uHshColor; uniform vec3 uHshRim; uniform float uHshFilm; uniform float uHshTint; uniform float uHshTime;\n  uniform float uHshMorph; uniform float uHshMode;\n  uniform sampler2D uHshSdf; uniform vec2 uHshSdfHalf; uniform float uHshDepth;\n  uniform sampler3D uHshSdf3; uniform vec3 uHshSdf3Min; uniform vec3 uHshSdf3Size; uniform mat4 uHshSdf3Inv; uniform mat4 uHshSdf3Mat;\n\n\n  // Real spherical harmonics for l = 1..4, as polynomials in the unit vector,\n  // each scaled so its peak is about 1. The CPU animates the 24 weights.\n  float hshSh(vec3 n){\n    float x = n.x, y = n.y, z = n.z;\n    float x2 = x * x, y2 = y * y, z2 = z * z;\n    float s = 0.0;\n    s += uHshW[0] * y + uHshW[1] * z + uHshW[2] * x;\n    s += uHshW[3] * 2.0 * x * y + uHshW[4] * 2.0 * y * z + uHshW[5] * (1.5 * z2 - 0.5)\n       + uHshW[6] * 2.0 * x * z + uHshW[7] * (x2 - y2);\n    s += uHshW[8]  * y * (3.0 * x2 - y2)\n       + uHshW[9]  * 5.2 * x * y * z\n       + uHshW[10] * 0.8 * y * (5.0 * z2 - 1.0)\n       + uHshW[11] * 0.5 * z * (5.0 * z2 - 3.0)\n       + uHshW[12] * 0.8 * x * (5.0 * z2 - 1.0)\n       + uHshW[13] * 2.6 * z * (x2 - y2)\n       + uHshW[14] * x * (x2 - 3.0 * y2);\n    s += uHshW[15] * 4.0 * x * y * (x2 - y2)\n       + uHshW[16] * 3.0 * y * z * (3.0 * x2 - y2)\n       + uHshW[17] * 1.5 * x * y * (7.0 * z2 - 1.0)\n       + uHshW[18] * 0.95 * y * z * (7.0 * z2 - 3.0)\n       + uHshW[19] * 0.125 * (35.0 * z2 * z2 - 30.0 * z2 + 3.0)\n       + uHshW[20] * 0.95 * x * z * (7.0 * z2 - 3.0)\n       + uHshW[21] * 0.78 * (x2 - y2) * (7.0 * z2 - 1.0)\n       + uHshW[22] * 3.0 * x * z * (x2 - 3.0 * y2)\n       + uHshW[23] * (x2 * (x2 - 3.0 * y2) - y2 * (3.0 * x2 - y2));\n    return s;\n  }\n\n  // The resting shell: radius along direction n, in shell-local units.\n  float hshRadius(vec3 n, out float field){\n    field = hshSh(n);\n    return uHshBound * uHshSize * (1.0 + uHshAmplitude * field);\n  }\n\n  // Thin-film interference, as on a soap bubble: a film of index 1.33 and\n  // thickness d delays the inner reflection by 2*n*d*cos(theta_t). Each\n  // wavelength interferes on its own, which splits white light into bands.\n  vec3 hshFilm(float ndv, float field){\n    float cosT = sqrt(max(1.0 - (1.0 - ndv * ndv) / (1.33 * 1.33), 0.0));\n    float opd  = 2.0 * 1.33 * uHshFilm * (1.0 + 0.35 * field) * cosT;\n    vec3 film  = 0.5 + 0.5 * cos(6.28318530718 * opd / vec3(650.0, 532.0, 450.0));\n    float lum  = dot(film, vec3(0.299, 0.587, 0.114));\n    return mix(film, lum * uHshColor * 1.7 + film * 0.12, uHshTint);\n  }\n\n  // \u2500\u2500 the target: signed distance in shell-local units (negative inside) \u2500\u2500\n  float hshSdf2(vec2 p){\n    vec2 uv = p / (2.0 * uHshSdfHalf) + 0.5;\n    vec2 c = clamp(uv, 0.0, 1.0);\n    return texture2D(uHshSdf, c).r + length((uv - c) * 2.0 * uHshSdfHalf);\n  }\n  float hshSdf(vec3 p){\n    if (uHshMode > 1.5) {\n      // an object's own field, baked in its local space\n      vec3 q = (uHshSdf3Inv * vec4(p, 1.0)).xyz;\n      vec3 uvw = (q - uHshSdf3Min) / uHshSdf3Size; vec3 c = clamp(uvw, 0.0, 1.0);\n      return texture(uHshSdf3, c).r + length((uvw - c) * uHshSdf3Size);\n    }\n    // text / shape: the 2D field extruded to \u00B1depth\n    float d2 = hshSdf2(p.xy); float dz = abs(p.z) - uHshDepth;\n    vec2 w = max(vec2(d2, dz), 0.0);\n    return min(max(d2, dz), 0.0) + length(w);\n  }\n  vec3 hshSdfGrad(vec3 p){\n    float e = 0.012;\n    vec3 g = vec3(hshSdf(p + vec3(e, 0, 0)) - hshSdf(p - vec3(e, 0, 0)),\n                  hshSdf(p + vec3(0, e, 0)) - hshSdf(p - vec3(0, e, 0)),\n                  hshSdf(p + vec3(0, 0, e)) - hshSdf(p - vec3(0, 0, e)));\n    float l = length(g); return l > 1e-6 ? g / l : vec3(0.0, 0.0, 1.0);\n  }\n\n  // Signed distance from a shell-local point to the shell's CURRENT surface\n  // (the resting shell blended with the target by uHshMorph). 'field' is the\n  // harmonic value in that direction, for the film.\n  // Where a sphere vertex starts its trace: the resting shell point stretched to the\n  // target's extent, so a wide word or a long object gets vertices along its whole length\n  // instead of everything converging on the part nearest the centre.\n  vec3 hshTraceStart(vec3 p0){\n    float R0 = uHshBound * uHshSize;\n    if (uHshMode > 1.5) {\n      vec3 c = uHshSdf3Min + 0.5 * uHshSdf3Size;        // the target's centre, in its own space\n      vec3 h = uHshSdf3Size * 0.44;                       // half extents (the baked box is padded 12%)\n      vec3 ct = (uHshSdf3Inv * vec4(0.0, 0.0, 0.0, 1.0)).xyz;\n      vec3 qt = (uHshSdf3Inv * vec4(p0, 1.0)).xyz;\n      qt = c + (qt - ct) * (h / R0);\n      return (uHshSdf3Mat * vec4(qt, 1.0)).xyz;\n    }\n    return p0 * vec3(uHshSdfHalf / R0, max(uHshDepth, 0.05) / R0);\n  }\n\n  float hshDist(vec3 p, out float field){\n    float r = length(p); vec3 n = r > 1e-5 ? p / r : vec3(0.0, 1.0, 0.0);\n    float dS = r - hshRadius(n, field);\n    return uHshMode > 0.5 && uHshMorph > 0.0 ? mix(dS, hshSdf(p), uHshMorph) : dS;\n  }\n\n\n  void main(){\n    vec3 N = normalize(vNormal);\n    vec3 V = normalize(vViewDir);\n    float ndv = abs(dot(N, V));\n\n    // the film is thicker where the harmonic pushes the shell out, so the colour bands follow the shape\n    vec3 film = hshFilm(ndv, vField);\n\n    float fres = pow(1.0 - ndv, 3.0);\n    vec3 col = uHshColor * 0.25 + film * (0.2 + 0.8 * fres);\n    col = mix(col, uHshRim, fres * 0.45);\n\n    // nodal lines: where the harmonic field crosses zero\n    float nd = abs(vField) / max(fwidth(vField), 1e-4);\n    float nodal = (1.0 - smoothstep(0.5, 1.5, nd)) * uNodalLines;\n    col += uHshRim * nodal * 1.5;\n\n    float a = (0.06 + 0.9 * fres + nodal * 0.8) * uOpacity;\n    // webbing between letters: pixels that are not on the target fade out as the morph completes\n    if (uHshMode > 0.5 && uHshMorph > 0.0) { float d = abs(hshSdf(vLocal)); a *= 1.0 - uHshMorph * smoothstep(uWeb, uWeb * 3.0, d); }\n    if (a < 0.003) discard;\n    gl_FragColor = vec4(col * uIntensity, a);\n  }\n";
+export type HshUniforms = Record<string, THREE.IUniform>;
+/** Fresh uniform objects for one shell (the shell writes them every frame; effects read them). */
+export declare function createShellUniforms(): HshUniforms;
+/** The keys an effect copies from a shell into its own uniforms (everything but the time, which it keeps). */
+export declare const HSH_SHARED_KEYS: readonly ["uHshW", "uHshAmplitude", "uHshBound", "uHshSize", "uHshColor", "uHshRim", "uHshFilm", "uHshTint", "uHshMorph", "uHshMode", "uHshSdf", "uHshSdfHalf", "uHshDepth", "uHshSdf3", "uHshSdf3Min", "uHshSdf3Size", "uHshSdf3Inv", "uHshSdf3Mat"];
+/** Copy a shell's current values into another uniform set (objects are shared by reference, scalars by value). */
+export declare function copyShellUniforms(from: HshUniforms, to: HshUniforms): void;
+export interface ShellField {
+    /** The shell's root group (its world matrix is the field's frame). */
+    root: Object3D;
+    uniforms: HshUniforms;
+    /** World → shell-local, refreshed by the shell every frame. */
+    inv: THREE.Matrix4;
+    /** The object the shell is wrapping right now (mode object), so it can be left out of the inside look. */
+    target: Object3D | null;
+}
+export declare function registerShellField(f: ShellField): void;
+export declare function unregisterShellField(f: ShellField): void;
+export declare const shellFields: () => ReadonlySet<ShellField>;
+/** The shell whose centre is nearest a world point (what `inShell` reacts to), or null when the scene has none. */
+export declare function nearestShellField(worldPos: THREE.Vector3): ShellField | null;
+export declare const SHELL_SHAPES: readonly ["star", "heart", "ring", "hexagon", "triangle", "cross", "disc", "square", "diamond", "pentagon", "octagon", "sparkle", "hexstar", "crescent", "drop", "bolt", "arrow", "cloud", "flower", "gear", "shield", "leaf", "capsule", "infinity", "chevron", "hourglass", "clover", "spade", "sun", "halfmoon"];
+export type ShellShape = (typeof SHELL_SHAPES)[number];
+/** CSS font families the `font` option maps to (the page's own fonts, with system fallbacks). */
+export declare const SHELL_FONTS: Record<string, string>;
+export interface Sdf2 {
+    tex: THREE.DataTexture;
+    half: number;
+}
+/**
+ * The 2D field of a word or a shape, sized to the shell: `half` is the half-width it
+ * spans in shell-local units (the shell's resting radius, a little more).
+ * Text waits for the page font once (document.fonts), then draws.
+ */
+export declare function bakeShapeSdf(kind: 'text' | ShellShape, text: string, font: string, half: number): Promise<Sdf2 | null>;
+export interface Sdf3 {
+    tex: THREE.Data3DTexture;
+    min: THREE.Vector3;
+    size: THREE.Vector3;
+}
+/**
+ * The object's signed distance field in its root-local space: all its meshes merged
+ * (position only, see mergedPositions), sampled on a 48³ grid with the BVH's
+ * closest-point query, sign from the hit face. Baked in slices so the page stays
+ * responsive; cached on the root until its geometry changes. ~100–300 ms for a
+ * typical model on a desktop CPU — do it at load (pre-bake), never on trigger.
+ */
+export declare function bakeObjectSdf(root: Object3D): Promise<Sdf3 | null>;
+//# sourceMappingURL=harmonicShellField.d.ts.map

package/dist/components/effects/harmonicShellField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harmonicShellField.d.ts","sourceRoot":"","sources":["../../../src/components/effects/harmonicShellField.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAgBtC,MAAM,WAAW,aAAa;IAC1B,EAAE,EAAE,YAAY,CAAC;IAAC,EAAE,EAAE,YAAY,CAAC;IAAC,EAAE,EAAE,YAAY,CAAC;IAAC,EAAE,EAAE,YAAY,CAAC;IACvE,IAAI,EAAE,YAAY,CAAC;CACtB;AAED,2FAA2F;AAC3F,wBAAgB,mBAAmB,IAAI,aAAa,CAUnD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,YAAY,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAe1H;AAID,iHAAiH;AACjH,eAAO,MAAM,cAAc,0fAO1B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,miJAiG3B,CAAC;AAEF,2FAA2F;AAC3F,eAAO,MAAM,cAAc,QAAmC,CAAC;AAE/D,2GAA2G;AAC3G,eAAO,MAAM,UAAU,y9MA2CtB,CAAC;AAEF,eAAO,MAAM,UAAU,quMAkCtB,CAAC;AAKF,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;AAczD,kGAAkG;AAClG,wBAAgB,mBAAmB,IAAI,WAAW,CAUjD;AAED,8GAA8G;AAC9G,eAAO,MAAM,eAAe,uPAGlB,CAAC;AAEX,kHAAkH;AAClH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,WAAW,QAMnE;AAID,MAAM,WAAW,UAAU;IACvB,sEAAsE;IACtE,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,WAAW,CAAC;IACtB,+DAA+D;IAC/D,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC;IACnB,0GAA0G;IAC1G,MAAM,EAAE,QAAQ,GAAG,IAAI,CAAC;CAC3B;AAID,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,UAAU,QAAoB;AACpE,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,UAAU,QAAuB;AACzE,eAAO,MAAM,WAAW,QAAO,WAAW,CAAC,UAAU,CAAW,CAAC;AAGjE,mHAAmH;AACnH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,KAAK,CAAC,OAAO,GAAG,UAAU,GAAG,IAAI,CAQ5E;AAID,eAAO,MAAM,YAAY,qTAKf,CAAC;AACX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD,iGAAiG;AACjG,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAK9C,CAAC;AAsBF,MAAM,WAAW,IAAI;IAAG,GAAG,EAAE,KAAK,CAAC,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AA2G9D;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAK5H;AAID,MAAM,WAAW,IAAI;IAAG,GAAG,EAAE,KAAK,CAAC,aAAa,CAAC;IAAC,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC;IAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAA;CAAE;AA8C3F;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CA4CxE"}