@3driseai/3drise-viewer 0.1.35 → 0.1.38

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

@@ -1 +1 @@
-{"version":3,"file":"appliers.d.ts","sourceRoot":"","sources":["../../src/animationsV2/appliers.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAiB/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAKxC,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAKrE;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACjC,qDAAqD;IACrD,QAAQ,EAAE,GAAG,CAAC;IACd,yFAAyF;IACzF,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,GAAG,CAAC;IACpC,0EAA0E;IAC1E,SAAS,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,cAAc,GAAG,SAAS,CAAC;CACxD;AAWD,wBAAgB,kBAAkB,IAAI,IAAI,CAIzC;AAsOD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAMhE;AAED,uFAAuF;AACvF,mFAAmF;AACnF,wBAAgB,UAAU,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAIlH;AAED,mFAAmF;AACnF,wBAAgB,eAAe,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAKxF;AAED,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjE"}
+{"version":3,"file":"appliers.d.ts","sourceRoot":"","sources":["../../src/animationsV2/appliers.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAgB/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAKxC,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAKrE;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACjC,qDAAqD;IACrD,QAAQ,EAAE,GAAG,CAAC;IACd,yFAAyF;IACzF,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,GAAG,CAAC;IACpC,0EAA0E;IAC1E,SAAS,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,cAAc,GAAG,SAAS,CAAC;CACxD;AAWD,wBAAgB,kBAAkB,IAAI,IAAI,CAIzC;AAkOD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAMhE;AAED,uFAAuF;AACvF,mFAAmF;AACnF,wBAAgB,UAAU,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAIlH;AAED,mFAAmF;AACnF,wBAAgB,eAAe,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAKxF;AAED,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjE"}

package/dist/animationsV2/appliers.js

@@ -1,5 +1,5 @@
-import { findById, SceneStore, applySingleProperty, applyMaterialPropertyToObject, traverseSkippingEdgesAndEffects, EDGES_GROUP_KEY, } from '@3driseai/3drise-core';
-import { CONFIG_LIVE_KEY } from '../hooks/useConfigLive.js';
+import { findById, applySingleProperty, applyMaterialPropertyToObject, traverseSkippingEdgesAndEffects, EDGES_GROUP_KEY, } from '@3driseai/3drise-core';
+import { findConfigHandles } from '../hooks/useConfigLive.js';
 import { CLOUD_LIVE_KEY } from '../hooks/useCloudLive.js';
 import { OCEAN_LIVE_KEY } from '../hooks/useOceanLive.js';
 import { TERRAIN_LIVE_KEY } from '../hooks/useTerrainLive.js';
@@ -37,19 +37,13 @@ function objectFor(state) {
         objectCache.delete(state);
     return found;
 }
-function configHandleFor(state) {
+/** Every live handle of the object — one per layout slot, so the whole layout follows the clip. */
+function configHandlesFor(state) {
     const cached = handleCache.get(state);
-    if (cached && cached.alive)
+    if (cached && cached.length && cached.every(h => h.alive))
         return cached;
-    let found = null;
-    SceneStore.scene?.traverse((o) => {
-        if (found)
-            return;
-        const h = o.userData?.[CONFIG_LIVE_KEY];
-        if (h && h.alive && h.id === state)
-            found = h;
-    });
-    if (found)
+    const found = findConfigHandles(state);
+    if (found.length)
         handleCache.set(state, found);
     else
         handleCache.delete(state);
@@ -134,11 +128,12 @@ const applyEdgesMaterial = (_ctx, state, path, value) => {
     applyMaterialPropertyToObject(edges, path.slice('edgesSettings.materialSettings.'.length), value);
 };
 const applyConfig = (_ctx, state, path, value) => {
-    const handle = configHandleFor(state);
-    if (!handle)
+    const handles = configHandlesFor(state);
+    if (!handles.length)
         return false;
     if (typeof value === 'number' || typeof value === 'string' || typeof value === 'boolean') {
-        handle.set(path.slice('config.'.length), value);
+        for (const h of handles)
+            h.set(path.slice('config.'.length), value);
     }
 };
 // --- environment: the same live paths the controllers' sliders use -------------------

package/dist/animationsV2/sequenceUtils.d.ts

@@ -109,8 +109,21 @@ export declare function findCueConflicts(seq: AnimationSequence, clips: ClipLook
 export declare function newCue(command: SceneCommand, stepId: string, at: number, mode?: SequenceCue['mode']): SequenceCue;
 /** A clip cue at `at` seconds. */
 export declare function newClipCue(command: SceneCommand, at: number, mode?: TimelineCue['mode']): TimelineCue;
-/** Clip-local time (seconds, 0..clip.duration) of an entry at sequence time T. */
+/** Clip-local time (seconds, 0..clip.duration) of an entry at sequence time T — backwards for a reversed step clip. */
 export declare function entryLocalTime(entry: ScheduledClip, T: number): number;
+/**
+ * A clip's cue schedule played backwards: fire cues at duration − t; each on / off lane's
+ * spans mirrored (on over [a, b] becomes on over [D − b, D − a] — its apply / revert swap).
+ */
+export declare function mirrorCueSchedule(schedule: Array<{
+    cue: TimelineCue;
+    subject: string;
+    time: number;
+}>, duration: number): Array<{
+    cue: TimelineCue;
+    subject: string;
+    time: number;
+}>;
 /**
  * Whether an entry writes at sequence time T: from its start on, and after its end
  * only if its clip holds ('hold'); a 'restore' clip lets go at its end.

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

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

package/dist/animationsV2/sequenceUtils.js

@@ -39,7 +39,8 @@ export function resolveSequence(seq, clips) {
     for (const e of entries) {
         const speed = safeSpeed(e.stepClip.speed);
         const stepStart = steps[e.stepIndex].start;
-        for (const c of clipCueSchedule(e.clip)) {
+        const own = clipCueSchedule(e.clip);
+        for (const c of e.stepClip.reverse ? mirrorCueSchedule(own, e.clip.duration) : own) {
             const time = Math.min(e.end, e.start + c.time / speed);
             const cue = { ...c.cue, id: `${e.id}:${c.cue.id}`, stepId: seq.steps[e.stepIndex].id, at: time - stepStart };
             cues.push({ cue, subject: c.subject, stepIndex: e.stepIndex, time, fromClip: e.id });
@@ -175,10 +176,32 @@ export function newCue(command, stepId, at, mode = 'apply') {
 export function newClipCue(command, at, mode = 'apply') {
     return { id: uid('cue'), command, at: Math.max(0, at), mode };
 }
-/** Clip-local time (seconds, 0..clip.duration) of an entry at sequence time T. */
+/** Clip-local time (seconds, 0..clip.duration) of an entry at sequence time T — backwards for a reversed step clip. */
 export function entryLocalTime(entry, T) {
-    const local = (T - entry.start) * safeSpeed(entry.stepClip.speed);
-    return Math.min(entry.clip.duration, Math.max(0, local));
+    const local = Math.min(entry.clip.duration, Math.max(0, (T - entry.start) * safeSpeed(entry.stepClip.speed)));
+    return entry.stepClip.reverse ? entry.clip.duration - local : local;
+}
+/**
+ * A clip's cue schedule played backwards: fire cues at duration − t; each on / off lane's
+ * spans mirrored (on over [a, b] becomes on over [D − b, D − a] — its apply / revert swap).
+ */
+export function mirrorCueSchedule(schedule, duration) {
+    const out = [];
+    const lanes = new Map();
+    for (const c of schedule) {
+        if (c.cue.mode === 'fire')
+            out.push({ ...c, time: duration - c.time, cue: { ...c.cue, at: duration - c.time } });
+        else if (!lanes.has(c.subject))
+            lanes.set(c.subject, c.cue);
+    }
+    for (const [subject, first] of lanes) {
+        cueSpans({ cues: schedule.filter(c => !c.cue.muted), duration }, subject).forEach((s, i) => {
+            const on = duration - s.to, off = duration - s.from;
+            out.push({ subject, time: on, cue: { ...first, id: `${first.id}:r${i}on`, mode: 'apply', at: on } });
+            out.push({ subject, time: off, cue: { ...first, id: `${first.id}:r${i}off`, mode: 'revert', at: off } });
+        });
+    }
+    return out.sort((a, b) => a.time - b.time);
 }
 /**
  * Whether an entry writes at sequence time T: from its start on, and after its end

package/dist/animationsV2/types.d.ts

@@ -64,6 +64,8 @@ export interface StepClip {
     speed: number;
     /** Muted: keeps its place and length in the step, but drives nothing and fires none of its cues. */
     muted?: boolean;
+    /** Plays the clip backwards (its end pose first); its cues are mirrored too. Same place and length. */
+    reverse?: boolean;
 }
 /** Clips that start together. The step ends when its longest clip ends; then the next step starts. */
 export interface SequenceStep {

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

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

package/dist/components/ObjectNode.js

@@ -132,7 +132,7 @@ const ObjectNode = ({ node, onObjectReady, onObjectDispose, handleObjectClick })
         landscape: (obj, onObjectReady) => (_jsx(LandscapeObject, { settings: obj, ...relabel(obj) }, obj.id)),
         effect: (obj, _onObjectReady, slot = 0) => (_jsx(EffectsGenerator, { settings: {
                 config: obj.config,
-            }, id: slot === 0 ? obj.id : undefined, keyframes: obj.animations?.effect?.animations, mouseMove: obj.mouseMove?.effect, ...(slot === 0 ? relabel(obj) : NO_READY) }, obj.id)),
+            }, id: obj.id /* every layout slot: each copy registers its live handle, so clips and drags reach the whole layout */, keyframes: obj.animations?.effect?.animations, mouseMove: obj.mouseMove?.effect, ...(slot === 0 ? relabel(obj) : NO_READY) }, obj.id)),
         gallery: (obj, onObjectReady) => (_jsx(GalleryLayout, { createdObject: obj, handleObjectClick: handleObjectClick, ...relabel(obj) })),
         light: (obj, _onObjectReady, slot = 0) => (_jsx(LightObject, { createdObject: slot === 0 ? obj : withoutShadow(obj), ...(slot === 0 ? relabel(obj) : NO_READY) })),
         environment: (obj, onObjectReady) => (_jsx(EnvironmentObject, { createdObject: obj, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose })),

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 }) }));
 };