@3driseai/3drise-viewer 0.1.2 → 0.1.3

package/dist/components/cursor/clickActions/index.js

@@ -0,0 +1,10 @@
+// Cursor click actions — one-shot effects spawned on pointer down.
+export { default as BoltFlashAction } from './BoltFlashAction.js';
+export { default as GlyphInscriptionAction } from './GlyphInscriptionAction.js';
+export { default as ImplosionAction } from './ImplosionAction.js';
+export { default as PhaseShiftAction } from './PhaseShiftAction.js';
+export { default as PlasmaBombAction } from './PlasmaBombAction.js';
+export { default as RealityTearAction } from './RealityTearAction.js';
+export { default as ShockwaveAction } from './ShockwaveAction.js';
+export { default as SparklesBurstAction } from './SparklesBurstAction.js';
+export { default as VoronoiFractureAction } from './VoronoiFractureAction.js';

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

@@ -0,0 +1,21 @@
+export type { CursorActionsProps } from './CursorActions';
+export type { CursorControllerProps } from './CursorController';
+export type { CursorEffectsProps, CursorTypeProps } from './CursorEffects';
+export { default as CursorController } from './CursorController';
+export { default as CursorActions } from './CursorActions';
+export { default as CursorEffects } from './CursorEffects';
+export { default as AuraCursor } from './AuraCursor';
+export { default as AuroraCursor } from './AuroraCursor';
+export { default as BubblesCursor } from './BubblesCursor';
+export { default as CometCursor } from './CometCursor';
+export { default as CrosshairCursor } from './CrosshairCursor';
+export { default as FerrofluidCursor } from './FerrofluidCursor';
+export { default as GlyphRingCursor } from './GlyphRingCursor';
+export { default as LightningCursor } from './LightningCursor';
+export { default as LiquidMetalCursor } from './LiquidMetalCursor';
+export { default as OrbCursor } from './OrbCursor';
+export { default as PlasmaWhipCursor } from './PlasmaWhipCursor';
+export { default as SparklesCursor } from './SparklesCursor';
+export { default as TeslaCursor } from './TeslaCursor';
+export * from './clickActions';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/cursor/index.ts"],"names":[],"mappings":"AAEA,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAGhE,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAE3E,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAG3D,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,eAAe,CAAC;AAEvD,cAAc,gBAAgB,CAAC"}

package/dist/components/cursor/index.js

@@ -0,0 +1,19 @@
+// Cursor module — cursor controller, effect renderers and per-cursor visuals.
+export { default as CursorController } from './CursorController.js';
+export { default as CursorActions } from './CursorActions.js';
+export { default as CursorEffects } from './CursorEffects.js';
+// Cursor variants
+export { default as AuraCursor } from './AuraCursor.js';
+export { default as AuroraCursor } from './AuroraCursor.js';
+export { default as BubblesCursor } from './BubblesCursor.js';
+export { default as CometCursor } from './CometCursor.js';
+export { default as CrosshairCursor } from './CrosshairCursor.js';
+export { default as FerrofluidCursor } from './FerrofluidCursor.js';
+export { default as GlyphRingCursor } from './GlyphRingCursor.js';
+export { default as LightningCursor } from './LightningCursor.js';
+export { default as LiquidMetalCursor } from './LiquidMetalCursor.js';
+export { default as OrbCursor } from './OrbCursor.js';
+export { default as PlasmaWhipCursor } from './PlasmaWhipCursor.js';
+export { default as SparklesCursor } from './SparklesCursor.js';
+export { default as TeslaCursor } from './TeslaCursor.js';
+export * from './clickActions/index.js';

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

@@ -1,6 +1,7 @@
 import React from "react";
 import type { AuraConfig, AnimationOptions } from "@3driseai/3drise-core";
-interface AuraEffectProps {
+import type { ObjectReadyProps } from '../../types/objectReady';
+interface AuraEffectProps extends ObjectReadyProps {
     boundingRadius: number;
     config: AuraConfig;
     animations?: AnimationOptions[];

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

@@ -1 +1 @@
-{"version":3,"file":"AuraEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/AuraEffect.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC1E,UAAU,eAAe;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC;AAgFD,QAAA,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CA2CzC,CAAC;AACF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"AuraEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/AuraEffect.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,UAAU,eAAgB,SAAQ,gBAAgB;IAC9C,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC;AAgFD,QAAA,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CA6CzC,CAAC;AACF,eAAe,UAAU,CAAC"}

package/dist/components/effects/AuraEffect.js

@@ -3,6 +3,7 @@ import { useRef, useMemo } from 'react';
 import { useFrame } from '@react-three/fiber';
 import * as THREE from 'three';
 import { applyGenerativeAnimations } from '../../utils/handleGenerativeEffectsAnimations.js';
+import { useObjectReady } from '../../hooks/useObjectReady.js';
 const vertexShader = /* glsl */ `
   varying vec3 vNormal;
   varying vec3 vViewDir;
@@ -80,9 +81,11 @@ const fragmentShader = /* glsl */ `
     gl_FragColor = vec4(col, alpha);
   }
 `;
-const AuraEffect = ({ boundingRadius, config, animations }) => {
+const AuraEffect = ({ boundingRadius, config, animations, onObjectReady, onObjectDispose }) => {
     const { layerCount, fresnelPower, pulseSpeed, innerColor, outerColor, noiseAmount, sizeMultiplier, opacity, speed, intensity } = config;
     const startValuesCacheRef = useRef({});
+    const rootRef = useRef(null);
+    useObjectReady(rootRef, config, onObjectReady, onObjectDispose);
     // Derive a single base hue from the innerColor
     const baseHue = useMemo(() => {
         const c = new THREE.Color(innerColor);
@@ -117,7 +120,7 @@ const AuraEffect = ({ boundingRadius, config, animations }) => {
         }
     });
     const baseR = boundingRadius * sizeMultiplier;
-    return (_jsx("group", { children: Array.from({ length: layerCount }, (_, i) => {
+    return (_jsx("group", { ref: rootRef, children: Array.from({ length: layerCount }, (_, i) => {
             // Non-linear layer spacing: outer layers spread wider
             const layerT = layerCount > 1 ? i / (layerCount - 1) : 0;
             const r = baseR * (1 + layerT * layerT * 0.5);

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

@@ -1,6 +1,7 @@
 import React from "react";
 import type { AuroraConfig, AnimationOptions } from "@3driseai/3drise-core";
-interface AuroraEffectProps {
+import type { ObjectReadyProps } from '../../types/objectReady';
+interface AuroraEffectProps extends ObjectReadyProps {
     boundingRadius: number;
     config: AuroraConfig;
     animations?: AnimationOptions[];

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

@@ -1 +1 @@
-{"version":3,"file":"AuroraEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/AuroraEffect.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC5E,UAAU,iBAAiB;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,YAAY,CAAC;IACrB,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC;AAqDD,QAAA,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAuD7C,CAAC;AACF,eAAe,YAAY,CAAC"}
+{"version":3,"file":"AuroraEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/AuroraEffect.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE5E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,UAAU,iBAAkB,SAAQ,gBAAgB;IAChD,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,YAAY,CAAC;IACrB,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC;AAqDD,QAAA,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAwD7C,CAAC;AACF,eAAe,YAAY,CAAC"}

package/dist/components/effects/AuroraEffect.js

@@ -3,6 +3,7 @@ import { useRef, useMemo } from 'react';
 import { useFrame } from '@react-three/fiber';
 import * as THREE from 'three';
 import { applyGenerativeAnimations } from '../../utils/handleGenerativeEffectsAnimations.js';
+import { useObjectReady } from '../../hooks/useObjectReady.js';
 const ribbonVert = /* glsl */ `
   uniform float u_time;
   uniform float uPhase;
@@ -53,9 +54,10 @@ const ribbonFrag = /* glsl */ `
     gl_FragColor = vec4(col, alpha);
   }
 `;
-const AuroraEffect = ({ boundingRadius, config, animations }) => {
+const AuroraEffect = ({ boundingRadius, config, animations, onObjectReady, onObjectDispose }) => {
     const { ribbonCount, waveAmplitude, colorShift, arcWidth, opacity, speed, intensity } = config;
     const groupRef = useRef(null);
+    useObjectReady(groupRef, config, onObjectReady, onObjectDispose);
     const ribbons = useMemo(() => {
         const N = Math.max(3, Math.min(ribbonCount, 10));
         const r = boundingRadius;

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

@@ -1,6 +1,7 @@
 import React from "react";
 import type { BlackHoleConfig, AnimationOptions } from "@3driseai/3drise-core";
-interface BlackHoleEffectProps {
+import type { ObjectReadyProps } from '../../types/objectReady';
+interface BlackHoleEffectProps extends ObjectReadyProps {
     boundingRadius: number;
     config: BlackHoleConfig;
     animations?: AnimationOptions[];

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

@@ -1 +1 @@
-{"version":3,"file":"BlackHoleEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/BlackHoleEffect.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC/E,UAAU,oBAAoB;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,eAAe,CAAC;IACxB,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC;AAsHD,QAAA,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CAuEnD,CAAC;AACF,eAAe,eAAe,CAAC"}
+{"version":3,"file":"BlackHoleEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/BlackHoleEffect.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE/E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,UAAU,oBAAqB,SAAQ,gBAAgB;IACnD,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,eAAe,CAAC;IACxB,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC;AAsHD,QAAA,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CAwEnD,CAAC;AACF,eAAe,eAAe,CAAC"}

package/dist/components/effects/BlackHoleEffect.js

@@ -3,6 +3,7 @@ import { useRef, useMemo } from 'react';
 import { useFrame } from '@react-three/fiber';
 import * as THREE from 'three';
 import { applyGenerativeAnimations } from '../../utils/handleGenerativeEffectsAnimations.js';
+import { useObjectReady } from '../../hooks/useObjectReady.js';
 // ── Accretion disk shader ─────────────────────────────────────────────────────
 const diskVert = /* glsl */ `
   varying vec2 vUv;
@@ -118,10 +119,11 @@ const jetFrag = /* glsl */ `
     gl_FragColor = vec4(uJetColor, a);
   }
 `;
-const BlackHoleEffect = ({ boundingRadius, config, animations }) => {
+const BlackHoleEffect = ({ boundingRadius, config, animations, onObjectReady, onObjectDispose }) => {
     const { diskColor, jetEnabled, jetColor, rotationSpeed, tilt, opacity, speed, intensity } = config;
     const startValuesCacheRef = useRef({});
     const groupRef = useRef(null);
+    useObjectReady(groupRef, config, onObjectReady, onObjectDispose);
     const r = boundingRadius;
     const { diskMat, lensMat, jetMat1, jetMat2, jetGeo } = useMemo(() => {
         const dc = new THREE.Color(diskColor);

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

@@ -1,6 +1,7 @@
 import React from "react";
 import type { ConstellationConfig, AnimationOptions } from "@3driseai/3drise-core";
-interface ConstellationEffectProps {
+import type { ObjectReadyProps } from '../../types/objectReady';
+interface ConstellationEffectProps extends ObjectReadyProps {
     boundingRadius: number;
     config: ConstellationConfig;
     animations?: AnimationOptions[];

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

@@ -1 +1 @@
-{"version":3,"file":"ConstellationEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/ConstellationEffect.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACnF,UAAU,wBAAwB;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC;AAiGD,QAAA,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAAE,CAAC,wBAAwB,CAwF3D,CAAC;AACF,eAAe,mBAAmB,CAAC"}
+{"version":3,"file":"ConstellationEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/ConstellationEffect.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEnF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,UAAU,wBAAyB,SAAQ,gBAAgB;IACvD,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC;AAiGD,QAAA,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAAE,CAAC,wBAAwB,CAyF3D,CAAC;AACF,eAAe,mBAAmB,CAAC"}

package/dist/components/effects/ConstellationEffect.js

@@ -3,6 +3,7 @@ import { useRef, useMemo } from 'react';
 import { useFrame } from '@react-three/fiber';
 import * as THREE from 'three';
 import { applyGenerativeAnimations } from '../../utils/handleGenerativeEffectsAnimations.js';
+import { useObjectReady } from '../../hooks/useObjectReady.js';
 // Stars: per-particle twinkle + size variation
 const starVertShader = /* glsl */ `
   attribute float aPhase;
@@ -97,10 +98,11 @@ function fibonacciSphere(count, radius) {
     }
     return positions;
 }
-const ConstellationEffect = ({ boundingRadius, config, animations }) => {
+const ConstellationEffect = ({ boundingRadius, config, animations, onObjectReady, onObjectDispose }) => {
     const { starCount, connectRadius, orbitRadius, twinkleSpeed, lineOpacity, starSize, color, opacity, speed } = config;
     const startValuesCacheRef = useRef({});
     const groupRef = useRef(null);
+    useObjectReady(groupRef, config, onObjectReady, onObjectDispose);
     const r = boundingRadius * orbitRadius;
     const connR = boundingRadius * connectRadius;
     const colorVec = useMemo(() => {

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

@@ -0,0 +1,19 @@
+import * as THREE from "three";
+declare global {
+    namespace JSX {
+        interface IntrinsicElements {
+            sunCoronaMaterial: any;
+        }
+    }
+}
+import type { ObjectReadyProps } from '../../types/objectReady';
+export type CoronaProps = ObjectReadyProps & {
+    /** Radius of the core this corona surrounds. Default 1. */
+    radius?: number;
+    /** Shell size relative to the core. Default 1.25. Synced with u_shellScale. */
+    shellScale?: number;
+    /** Uniform overrides for SunCoronaMaterial (u_intensity, u_innerColor, ...). */
+    uniforms?: Record<string, number | THREE.Vector3 | number[]>;
+};
+export default function Corona({ radius, shellScale, uniforms, onObjectReady, onObjectDispose }: CoronaProps): import("react").JSX.Element;
+//# sourceMappingURL=Corona.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Corona.d.ts","sourceRoot":"","sources":["../../../src/components/effects/Corona.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,GAAG,CAAC;QACV,UAAU,iBAAiB;YACvB,iBAAiB,EAAE,GAAG,CAAC;SAC1B;KACJ;CACJ;AAGD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,MAAM,MAAM,WAAW,GAAG,gBAAgB,GAAG;IACzC,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,OAAO,GAAG,MAAM,EAAE,CAAC,CAAC;CAChE,CAAC;AAEF,MAAM,CAAC,OAAO,UAAU,MAAM,CAAC,EAAE,MAAU,EAAE,UAAiB,EAAE,QAAQ,EAAE,aAAa,EAAE,eAAe,EAAE,EAAE,WAAW,+BAStH"}

package/dist/components/effects/Corona.js

@@ -0,0 +1,15 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import * as THREE from "three";
+import { useRef } from "react";
+import { useFrame } from "@react-three/fiber";
+import { useObjectReady } from '../../hooks/useObjectReady.js';
+export default function Corona({ radius = 1, shellScale = 1.25, uniforms, onObjectReady, onObjectDispose }) {
+    const matRef = useRef(null);
+    const rootRef = useRef(null);
+    useObjectReady(rootRef, { radius, shellScale, uniforms }, onObjectReady, onObjectDispose);
+    useFrame((_, delta) => {
+        if (matRef.current)
+            matRef.current.u_time += delta;
+    });
+    return (_jsxs("mesh", { ref: rootRef, scale: radius * shellScale, children: [_jsx("sphereGeometry", { args: [1, 64, 64] }), _jsx("coronaMaterial", { ref: matRef, u_shellScale: shellScale, side: THREE.BackSide, transparent: true, depthWrite: false, blending: THREE.AdditiveBlending, ...uniforms })] }));
+}

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

@@ -1,6 +1,7 @@
 import React from "react";
 import type { DataStreamConfig, AnimationOptions } from "@3driseai/3drise-core";
-interface DataStreamEffectProps {
+import type { ObjectReadyProps } from '../../types/objectReady';
+interface DataStreamEffectProps extends ObjectReadyProps {
     boundingRadius: number;
     config: DataStreamConfig;
     animations?: AnimationOptions[];

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

@@ -1 +1 @@
-{"version":3,"file":"DataStreamEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/DataStreamEffect.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAChF,UAAU,qBAAqB;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,gBAAgB,CAAC;IACzB,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC;AAqFD,QAAA,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CAiDrD,CAAC;AACF,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"DataStreamEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/DataStreamEffect.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEhF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,UAAU,qBAAsB,SAAQ,gBAAgB;IACpD,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,gBAAgB,CAAC;IACzB,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC;AAqFD,QAAA,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CAmDrD,CAAC;AACF,eAAe,gBAAgB,CAAC"}

package/dist/components/effects/DataStreamEffect.js

@@ -3,6 +3,7 @@ import { useRef, useMemo } from 'react';
 import { useFrame } from '@react-three/fiber';
 import * as THREE from 'three';
 import { applyGenerativeAnimations } from '../../utils/handleGenerativeEffectsAnimations.js';
+import { useObjectReady } from '../../hooks/useObjectReady.js';
 // Dual counter-rotating helices with cold→hot color gradient.
 // All animation is GPU-side — only u_time updates per frame.
 const vertexShader = /* glsl */ `
@@ -85,9 +86,11 @@ const fragmentShader = /* glsl */ `
     gl_FragColor = vec4(vColor, vAlpha * uOpacity * (glow + star));
   }
 `;
-const DataStreamEffect = ({ boundingRadius, config, animations }) => {
+const DataStreamEffect = ({ boundingRadius, config, animations, onObjectReady, onObjectDispose }) => {
     const { particleCount, spiralTurns, streamRadius, inward, particleSize, opacity, speed, intensity } = config;
     const startValuesCacheRef = useRef({});
+    const rootRef = useRef(null);
+    useObjectReady(rootRef, config, onObjectReady, onObjectDispose);
     const r = boundingRadius * streamRadius;
     const h = boundingRadius * 2.6;
     const { geometry, material } = useMemo(() => {
@@ -133,6 +136,6 @@ const DataStreamEffect = ({ boundingRadius, config, animations }) => {
             applyGenerativeAnimations([material], animations, startValuesCacheRef.current, Date.now(), false);
         }
     });
-    return _jsx("points", { geometry: geometry, material: material });
+    return _jsx("points", { ref: rootRef, geometry: geometry, material: material });
 };
 export default DataStreamEffect;

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

@@ -1,6 +1,7 @@
 import React from "react";
 import type { DnaHelixConfig, AnimationOptions } from "@3driseai/3drise-core";
-interface DnaHelixEffectProps {
+import type { ObjectReadyProps } from '../../types/objectReady';
+interface DnaHelixEffectProps extends ObjectReadyProps {
     boundingRadius: number;
     config: DnaHelixConfig;
     animations?: AnimationOptions[];

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

@@ -1 +1 @@
-{"version":3,"file":"DnaHelixEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/DnaHelixEffect.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9E,UAAU,mBAAmB;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,cAAc,CAAC;IACvB,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC;AA0ED,QAAA,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CAyOjD,CAAC;AACF,eAAe,cAAc,CAAC"}
+{"version":3,"file":"DnaHelixEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/DnaHelixEffect.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,UAAU,mBAAoB,SAAQ,gBAAgB;IAClD,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,cAAc,CAAC;IACvB,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC;AA0ED,QAAA,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CA0OjD,CAAC;AACF,eAAe,cAAc,CAAC"}

package/dist/components/effects/DnaHelixEffect.js

@@ -3,6 +3,7 @@ import { useRef, useMemo } from 'react';
 import { useFrame } from '@react-three/fiber';
 import * as THREE from 'three';
 import { applyGenerativeAnimations } from '../../utils/handleGenerativeEffectsAnimations.js';
+import { useObjectReady } from '../../hooks/useObjectReady.js';
 // ── Pulsing junction-dot shader ───────────────────────────────────────────────
 const dotVert = /* glsl */ `
   attribute float aPhase;
@@ -74,10 +75,11 @@ function helixAt(t, si, numStrands, r, h) {
     return new THREE.Vector3(Math.cos(angle) * r, t * h - h / 2, Math.sin(angle) * r);
 }
 // ── Component ─────────────────────────────────────────────────────────────────
-const DnaHelixEffect = ({ boundingRadius, config, animations }) => {
+const DnaHelixEffect = ({ boundingRadius, config, animations, onObjectReady, onObjectDispose }) => {
     const { particleCount, strandCount, helixRadius, helixHeight, basePairColor, runningLightEnabled, opacity, speed, intensity, } = config;
     const startValuesCacheRef = useRef({});
     const groupRef = useRef(null);
+    useObjectReady(groupRef, config, onObjectReady, onObjectDispose);
     const washProgress = useRef(0);
     const r = boundingRadius * helixRadius;
     const h = boundingRadius * helixHeight;

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

@@ -1,6 +1,7 @@
 import type { Object3D } from 'three';
 import { AnimationOptions, FireConfig } from "@3driseai/3drise-core";
-export interface FireProps {
+import type { ObjectReadyProps } from '../../types/objectReady';
+export interface FireProps extends ObjectReadyProps {
     /**
      * Host object to wrap. When provided, the fire auto-fits the host's
      * bounding sphere. mode 'wrap' scatters flame tongues across the host's
@@ -15,6 +16,6 @@ export interface FireProps {
     config: FireConfig;
     animations?: AnimationOptions[];
 }
-declare const Fire: ({ hostRef, config, animations }: FireProps) => import("react").JSX.Element;
+declare const Fire: ({ hostRef, config, animations, onObjectReady, onObjectDispose }: FireProps) => import("react").JSX.Element;
 export default Fire;
 //# sourceMappingURL=Fire.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Fire.d.ts","sourceRoot":"","sources":["../../../src/components/effects/Fire.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAGtC,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACrE,MAAM,WAAW,SAAS;IACtB;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC;AAqFD,QAAA,MAAM,IAAI,GAAI,iCAAiC,SAAS,gCAwHvD,CAAC;AACF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"Fire.d.ts","sourceRoot":"","sources":["../../../src/components/effects/Fire.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAGtC,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAErE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,MAAM,WAAW,SAAU,SAAQ,gBAAgB;IAC/C;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC;AAqFD,QAAA,MAAM,IAAI,GAAI,iEAAiE,SAAS,gCAyHvF,CAAC;AACF,eAAe,IAAI,CAAC"}

package/dist/components/effects/Fire.js

@@ -2,6 +2,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Box3, Sphere, Color, Vector3, Matrix4, PlaneGeometry, InstancedBufferGeometry, InstancedBufferAttribute, } from 'three';
 import { useEffect, useLayoutEffect, useMemo, useRef } from 'react';
 import { useFrame } from '@react-three/fiber';
+import { useObjectReady } from '../../hooks/useObjectReady.js';
 // Add to FireConfig in 3drize-core:
 //   mode?: 'crown' | 'wrap'   // wrap scatters tongues over the host surface
 //   coverage?: number         // 0..1 — how far down the host burns (wrap)
@@ -84,8 +85,9 @@ function sampleSurface(host, count) {
     }
     return points;
 }
-const Fire = ({ hostRef, config, animations }) => {
+const Fire = ({ hostRef, config, animations, onObjectReady, onObjectDispose }) => {
     const group = useRef(null);
+    useObjectReady(group, config, onObjectReady, onObjectDispose);
     const material = useRef(null);
     const lightRef = useRef(null);
     const { radius = 1, height = 2.5, radiusScale = 1, heightScale = 1, intensity = 1, speed = 1, turbulence = 1.5, sway = 1, tint = '#ffffff', light = true, mode = 'tongues', coverage = 0.85, tongues = 36, } = config;

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

@@ -1,6 +1,7 @@
 import React from "react";
 import type { FireConfig, AnimationOptions } from "@3driseai/3drise-core";
-interface FireEffectProps {
+import type { ObjectReadyProps } from '../../types/objectReady';
+interface FireEffectProps extends ObjectReadyProps {
     boundingRadius: number;
     config: FireConfig;
     animations?: AnimationOptions[];

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

@@ -1 +1 @@
-{"version":3,"file":"FireEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/FireEffect.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC1E,UAAU,eAAe;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC;AAwGD,QAAA,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAsFzC,CAAC;AACF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"FireEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/FireEffect.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,UAAU,eAAgB,SAAQ,gBAAgB;IAC9C,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC;AAwGD,QAAA,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAwFzC,CAAC;AACF,eAAe,UAAU,CAAC"}

package/dist/components/effects/FireEffect.js

@@ -3,6 +3,7 @@ import { useMemo, useRef } from 'react';
 import { useFrame } from '@react-three/fiber';
 import * as THREE from 'three';
 import { applyGenerativeAnimations } from '../../utils/handleGenerativeEffectsAnimations.js';
+import { useObjectReady } from '../../hooks/useObjectReady.js';
 // ── Flame particle vertex shader ──────────────────────────────────────────────
 const flameVert = /* glsl */ `
   attribute float aT;       // lifetime position 0..1 (base→tip)
@@ -104,9 +105,11 @@ const emberFrag = /* glsl */ `
     gl_FragColor = vec4(1.0, 0.65 + (1.0 - vT) * 0.35, 0.2 * (1.0 - vT), alpha);
   }
 `;
-const FireEffect = ({ boundingRadius, config, animations }) => {
+const FireEffect = ({ boundingRadius, config, animations, onObjectReady, onObjectDispose }) => {
     const { particleCount, height, spread, flameColor, tipColor, opacity, speed, intensity } = config;
     const startValuesCacheRef = useRef({});
+    const rootRef = useRef(null);
+    useObjectReady(rootRef, config, onObjectReady, onObjectDispose);
     const h = boundingRadius * height;
     const s = boundingRadius * spread;
     const { flameGeo, flameMat, emberGeo, emberMat } = useMemo(() => {
@@ -189,6 +192,6 @@ const FireEffect = ({ boundingRadius, config, animations }) => {
             applyGenerativeAnimations([flameMat, emberMat], animations, startValuesCacheRef.current, Date.now(), false);
         }
     });
-    return (_jsxs("group", { position: [0, boundingRadius * 0.1, 0], children: [_jsx("points", { geometry: flameGeo, material: flameMat }), _jsx("points", { geometry: emberGeo, material: emberMat })] }));
+    return (_jsxs("group", { ref: rootRef, position: [0, boundingRadius * 0.1, 0], children: [_jsx("points", { geometry: flameGeo, material: flameMat }), _jsx("points", { geometry: emberGeo, material: emberMat })] }));
 };
 export default FireEffect;

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

@@ -0,0 +1,25 @@
+import { Vector3, Object3D } from "three";
+import { AnimationOptions, FlaresConfig } from "@3driseai/3drise-core";
+declare global {
+    namespace JSX {
+        interface IntrinsicElements {
+            flareMaterial: any;
+        }
+    }
+}
+import type { ObjectReadyProps } from '../../types/objectReady';
+export type FlaresProps = ObjectReadyProps & {
+    /**
+     * true  -> silhouette mode: bursts root on the enclosing object's actual
+     *          screen silhouette (mask render pass).
+     * false -> plane mode: circular limb billboard (default).
+     */
+    hostRef?: Object3D | null;
+    /** Root the bursts at the center (shooting from source) instead of the limb. */
+    config: FlaresConfig;
+    /** Uniform overrides for FlareMaterial (u_frequency, u_reach, ...). */
+    uniforms?: Record<string, number | Vector3 | number[]>;
+    animations?: AnimationOptions[];
+};
+export default function Flares({ hostRef, config, uniforms, animations, onObjectReady, onObjectDispose }: FlaresProps): import("react").JSX.Element;
+//# sourceMappingURL=Flares.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Flares.d.ts","sourceRoot":"","sources":["../../../src/components/effects/Flares.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAwE,OAAO,EAA8B,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC5I,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,GAAG,CAAC;QACV,UAAU,iBAAiB;YACvB,aAAa,EAAE,GAAG,CAAC;SACtB;KACJ;CACJ;AAGD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,MAAM,MAAM,WAAW,GAAG,gBAAgB,GAAG;IACzC;;;;OAIG;IACH,OAAO,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1B,gFAAgF;IAChF,MAAM,EAAE,YAAY,CAAC;IACrB,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAC,CAAC;IACvD,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC,CAAC;AAUF,MAAM,CAAC,OAAO,UAAU,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,EAAE,EAAE,WAAW,+BA2HpH"}

package/dist/components/effects/Flares.js

@@ -0,0 +1,136 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useMemo, useRef } from "react";
+import { useFrame, useThree } from "@react-three/fiber";
+import { WebGLRenderTarget, MeshBasicMaterial, AdditiveBlending, Box3, Sphere, Vector3, Vector2, Quaternion, Color, Object3D } from "three";
+import { useObjectReady } from '../../hooks/useObjectReady.js';
+const tmpBox = new Box3();
+const tmpSphere = new Sphere();
+const tmpVec = new Vector3();
+const tmpVec2 = new Vector2();
+const tmpQuat = new Quaternion();
+const tmpRight = new Vector3();
+const tmpColor = new Color();
+export default function Flares({ hostRef, config, uniforms, animations, onObjectReady, onObjectDispose }) {
+    const { gl, scene } = useThree();
+    const anchorRef = useRef(null);
+    useObjectReady(anchorRef, config, onObjectReady, onObjectDispose);
+    const meshRef = useRef(null);
+    const matRef = useRef(null);
+    const { radius, padding = 1.2, fitKey, shooting, maskResolution = 512, maskLayer = 31 } = config;
+    const maskTarget = useMemo(() => hostRef
+        ? new WebGLRenderTarget(maskResolution, maskResolution, {
+            depthBuffer: true,
+            stencilBuffer: false,
+            samples: 4 // MSAA mask (WebGL2) -> smooth silhouette edges
+        })
+        : null, [hostRef, maskResolution]);
+    const maskMaterial = useMemo(() => new MeshBasicMaterial({ color: 0xffffff }), []);
+    useEffect(() => () => maskTarget?.dispose(), [maskTarget]);
+    // Fit the billboard to the host object + tag the host for the mask pass.
+    useEffect(() => {
+        const anchor = anchorRef.current;
+        const mesh = meshRef.current;
+        if (!anchor || !mesh)
+            return;
+        const host = hostRef && hostRef instanceof Object3D ? hostRef : anchor;
+        // Silhouette mode: tag every host node (except us) with the mask layer.
+        if (hostRef && host) {
+            host.traverse((o) => o.layers.enable(maskLayer));
+            anchor.traverse((o) => o.layers.disable(maskLayer));
+        }
+        if (radius !== undefined) {
+            anchor.position.set(0, 0, 0);
+            mesh.scale.setScalar(radius * padding);
+            return;
+        }
+        if (!host)
+            return;
+        // Bounding box of every sibling except ourselves (world space).
+        tmpBox.makeEmpty();
+        let hasGeometry = false;
+        for (const child of host.children) {
+            if (child === anchor)
+                continue;
+            const childBox = new Box3().setFromObject(child);
+            if (!childBox.isEmpty()) {
+                tmpBox.union(childBox);
+                hasGeometry = true;
+            }
+        }
+        // Host itself may be a mesh (Flares nested directly inside it).
+        if (host.geometry) {
+            const g = host.geometry;
+            if (!g.boundingBox)
+                g.computeBoundingBox();
+            if (g.boundingBox) {
+                tmpBox.union(g.boundingBox.clone().applyMatrix4(host.matrixWorld));
+                hasGeometry = true;
+            }
+        }
+        if (!hasGeometry)
+            return;
+        tmpBox.getBoundingSphere(tmpSphere);
+        host.updateWorldMatrix(true, false);
+        const localCenter = host.worldToLocal(tmpSphere.center.clone());
+        host.getWorldScale(tmpVec);
+        const worldScale = Math.max(tmpVec.x, tmpVec.y, tmpVec.z) || 1;
+        anchor.position.copy(localCenter);
+        mesh.scale.setScalar((tmpSphere.radius / worldScale) * padding);
+    }, [radius, padding, fitKey, hostRef, maskLayer]);
+    useFrame(({ camera: cam }, delta) => {
+        const mat = matRef.current;
+        const mesh = meshRef.current;
+        if (mat)
+            mat.u_time += delta;
+        // World-space billboard: compensate for inherited rotation.
+        if (mesh && hostRef) {
+            hostRef.getWorldQuaternion(tmpQuat).invert();
+            mesh.quaternion.copy(tmpQuat).multiply(cam.quaternion);
+        }
+        // --- Silhouette mask pass: render only the host, white on black. ---
+        if (hostRef && maskTarget && mat && mesh) {
+            const prevOverride = scene.overrideMaterial;
+            const prevBackground = scene.background;
+            const prevTarget = gl.getRenderTarget();
+            const prevLayers = cam.layers.mask;
+            gl.getClearColor(tmpColor);
+            const prevClearAlpha = gl.getClearAlpha();
+            scene.overrideMaterial = maskMaterial;
+            scene.background = null;
+            cam.layers.set(maskLayer);
+            gl.setRenderTarget(maskTarget);
+            gl.setClearColor(0x000000, 1);
+            gl.clear();
+            gl.render(scene, cam);
+            gl.setRenderTarget(prevTarget);
+            gl.setClearColor(tmpColor, prevClearAlpha);
+            scene.overrideMaterial = prevOverride;
+            scene.background = prevBackground;
+            cam.layers.mask = prevLayers;
+            // Feed the shader: mask, buffer size, host center in screen UV.
+            mat.u_mask = maskTarget.texture;
+            gl.getDrawingBufferSize(tmpVec2);
+            mat.u_resolution.set(tmpVec2.x, tmpVec2.y);
+            const anchor = anchorRef.current;
+            anchor.getWorldPosition(tmpVec).project(cam);
+            const cx = tmpVec.x * 0.5 + 0.5;
+            const cy = tmpVec.y * 0.5 + 0.5;
+            mat.u_center.set(cx, cy);
+            // Bounding-silhouette radius in aspect-corrected screen UV: project a
+            // point one limb-unit to the camera's right of the center.
+            mesh.getWorldScale(tmpVec);
+            const worldLimb = Math.max(tmpVec.x, tmpVec.y, tmpVec.z);
+            tmpRight.setFromMatrixColumn(cam.matrixWorld, 0).multiplyScalar(worldLimb);
+            anchor.getWorldPosition(tmpVec).add(tmpRight).project(cam);
+            const aspect = tmpVec2.x / tmpVec2.y;
+            const dx = (tmpVec.x * 0.5 + 0.5 - cx) * aspect;
+            const dy = tmpVec.y * 0.5 + 0.5 - cy;
+            mat.u_limbScreen = Math.max(Math.hypot(dx, dy), 1e-4);
+            mat.u_maskEnabled = 1;
+        }
+        else if (mat) {
+            mat.u_maskEnabled = 0;
+        }
+    });
+    return (_jsx("group", { ref: anchorRef, children: _jsxs("mesh", { ref: meshRef, renderOrder: 2, children: [_jsx("planeGeometry", { args: [4.4, 4.4] }), _jsx("flareMaterial", { ref: matRef, transparent: true, depthWrite: false, depthTest: !hostRef && !shooting, blending: AdditiveBlending, u_shootEnabled: shooting ? 1 : 0, ...uniforms })] }) }));
+}

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

@@ -1,6 +1,7 @@
 import React from "react";
 import type { ForcefieldConfig, AnimationOptions } from "@3driseai/3drise-core";
-interface ForcefieldEffectProps {
+import type { ObjectReadyProps } from '../../types/objectReady';
+interface ForcefieldEffectProps extends ObjectReadyProps {
     boundingRadius: number;
     config: ForcefieldConfig;
     animations?: AnimationOptions[];

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

@@ -1 +1 @@
-{"version":3,"file":"ForcefieldEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/ForcefieldEffect.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAChF,UAAU,qBAAqB;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,gBAAgB,CAAC;IACzB,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC;AA6ED,QAAA,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CAmDrD,CAAC;AACF,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"ForcefieldEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/ForcefieldEffect.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEhF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,UAAU,qBAAsB,SAAQ,gBAAgB;IACpD,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,gBAAgB,CAAC;IACzB,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC;AA6ED,QAAA,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CAoDrD,CAAC;AACF,eAAe,gBAAgB,CAAC"}