@3driseai/3drise-core 1.0.1

package/dist/three/effects/SmokeRingEffectV.js

@@ -0,0 +1,174 @@
+import * as THREE from 'three';
+const ringVert = /* glsl */ `
+  attribute float aAngle;
+  attribute float aPuff;
+  attribute float aPhase;
+
+  uniform float uProgress;
+  uniform float uMaxRadius;
+  uniform float uThickness;
+  uniform float uRiseSpeed;
+  uniform float uBaseY;
+  uniform float u_time;
+
+  varying float vAlpha;
+
+  void main() {
+    if (uProgress < 0.0 || uProgress > 1.0) {
+      gl_PointSize = 0.0;
+      gl_Position  = vec4(0.0);
+      vAlpha = 0.0;
+      return;
+    }
+
+    float ringR = uMaxRadius * uProgress;
+
+    float tubeR = uThickness * (0.8 + 0.4 * uProgress);
+    float tubePhi = aPuff + u_time * 0.4 + aPhase;
+    float offR = tubeR * cos(tubePhi);
+    float offY = tubeR * sin(tubePhi);
+
+    float r   = ringR + offR;
+    float x   = cos(aAngle) * r;
+    float z   = sin(aAngle) * r;
+    float y   = uBaseY + uProgress * uRiseSpeed + offY;
+
+    float lifeAlpha = smoothstep(0.0, 0.12, uProgress) * smoothstep(1.0, 0.65, uProgress);
+    vAlpha = lifeAlpha;
+
+    float puffSize = uThickness * 50.0 * lifeAlpha;
+
+    vec4 mv = modelViewMatrix * vec4(x, y, z, 1.0);
+    gl_PointSize = puffSize * (200.0 / -mv.z);
+    gl_Position  = projectionMatrix * mv;
+  }
+`;
+const ringFrag = /* glsl */ `
+  uniform vec3  uSmokeColor;
+  uniform float uOpacity;
+  varying float vAlpha;
+
+  void main() {
+    if (vAlpha < 0.01) discard;
+    vec2  c = gl_PointCoord - 0.5;
+    float d = length(c);
+    if (d > 0.5) discard;
+    float g = exp(-d * d * 3.0);
+    gl_FragColor = vec4(uSmokeColor, g * vAlpha * uOpacity);
+  }
+`;
+const PUFFS_PER_RING = 120;
+export class SmokeRingEffectV {
+    scene;
+    group;
+    materials = [];
+    config;
+    boundingRadius;
+    ringStates = [];
+    constructor(scene, config, boundingRadius = 1) {
+        this.scene = scene;
+        this.config = config;
+        this.boundingRadius = boundingRadius;
+        this.group = new THREE.Group();
+        scene.add(this.group);
+        this.build();
+    }
+    build() {
+        const { ringCount, expansionRadius, riseSpeed, intervalSeconds, smokeColor, thickness, opacity, intensity } = this.config;
+        const N = Math.max(1, Math.min(ringCount, 4));
+        const maxR = this.boundingRadius * expansionRadius;
+        const tubeR = this.boundingRadius * thickness;
+        const riseH = this.boundingRadius * riseSpeed;
+        const sc = new THREE.Color(smokeColor);
+        const scv = new THREE.Vector3(sc.r, sc.g, sc.b);
+        this.ringStates = Array.from({ length: N }, (_, i) => ({
+            progress: 0,
+            timer: (i / N) * intervalSeconds,
+            active: false,
+        }));
+        for (let ri = 0; ri < N; ri++) {
+            const aAngle = new Float32Array(PUFFS_PER_RING);
+            const aPuff = new Float32Array(PUFFS_PER_RING);
+            const aPhase = new Float32Array(PUFFS_PER_RING);
+            for (let i = 0; i < PUFFS_PER_RING; i++) {
+                aAngle[i] = (i / PUFFS_PER_RING) * Math.PI * 2;
+                aPuff[i] = Math.random() * Math.PI * 2;
+                aPhase[i] = Math.random() * Math.PI * 2;
+            }
+            const geo = new THREE.BufferGeometry();
+            geo.setAttribute('position', new THREE.BufferAttribute(new Float32Array(PUFFS_PER_RING * 3), 3));
+            geo.setAttribute('aAngle', new THREE.BufferAttribute(aAngle, 1));
+            geo.setAttribute('aPuff', new THREE.BufferAttribute(aPuff, 1));
+            geo.setAttribute('aPhase', new THREE.BufferAttribute(aPhase, 1));
+            geo.frustumCulled = false;
+            const mat = new THREE.ShaderMaterial({
+                vertexShader: ringVert,
+                fragmentShader: ringFrag,
+                uniforms: {
+                    uProgress: { value: -1 },
+                    uMaxRadius: { value: maxR },
+                    uThickness: { value: tubeR * intensity },
+                    uRiseSpeed: { value: riseH },
+                    uBaseY: { value: -this.boundingRadius * 0.2 },
+                    u_time: { value: 0 },
+                    uSmokeColor: { value: scv },
+                    uOpacity: { value: opacity },
+                },
+                transparent: true,
+                depthWrite: false,
+                blending: THREE.NormalBlending,
+            });
+            this.materials.push(mat);
+            this.group.add(new THREE.Points(geo, mat));
+        }
+    }
+    update(elapsed, delta = 0.016) {
+        const { intervalSeconds, speed } = this.config;
+        const dt = delta * speed;
+        this.ringStates.forEach((ring, ri) => {
+            const mat = this.materials[ri];
+            if (!mat)
+                return;
+            mat.uniforms.u_time.value = elapsed;
+            if (ring.active) {
+                ring.progress += dt * 0.32;
+                if (ring.progress >= 1) {
+                    ring.active = false;
+                    ring.progress = 0;
+                    ring.timer = intervalSeconds / speed;
+                    mat.uniforms.uProgress.value = -1;
+                }
+                else {
+                    mat.uniforms.uProgress.value = ring.progress;
+                }
+            }
+            else {
+                ring.timer -= delta;
+                if (ring.timer <= 0) {
+                    ring.active = true;
+                    ring.progress = 0;
+                }
+            }
+        });
+    }
+    updateConfig(config, boundingRadius) {
+        this.config = config;
+        if (boundingRadius !== undefined)
+            this.boundingRadius = boundingRadius;
+        this.dispose(false);
+        this.build();
+    }
+    dispose(removeFromScene = true) {
+        this.group.traverse(child => {
+            const c = child;
+            if (c.geometry)
+                c.geometry.dispose();
+        });
+        this.materials.forEach(m => m.dispose());
+        this.materials = [];
+        this.ringStates = [];
+        this.group.clear();
+        if (removeFromScene && this.group.parent)
+            this.group.parent.remove(this.group);
+    }
+}

package/dist/three/effects/VolumetricFogEffectV.d.ts

@@ -0,0 +1,15 @@
+import * as THREE from 'three';
+import type { VolumetricFogConfig } from "../../types/generativeEffects";
+export declare class VolumetricFogEffectV {
+    private scene;
+    private group;
+    private materials;
+    private config;
+    private boundingRadius;
+    constructor(scene: THREE.Scene, config: VolumetricFogConfig, boundingRadius?: number);
+    private build;
+    update(elapsed: number, _delta?: number): void;
+    updateConfig(config: VolumetricFogConfig, boundingRadius?: number): void;
+    dispose(removeFromScene?: boolean): void;
+}
+//# sourceMappingURL=VolumetricFogEffectV.d.ts.map

package/dist/three/effects/VolumetricFogEffectV.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VolumetricFogEffectV.d.ts","sourceRoot":"","sources":["../../../src/three/effects/VolumetricFogEffectV.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AA8CzE,qBAAa,oBAAoB;IAC7B,OAAO,CAAC,KAAK,CAAC;IACd,OAAO,CAAC,KAAK,CAAC;IACd,OAAO,CAAC,SAAS,CAAM;IACvB,OAAO,CAAC,MAAM,CAAC;IACf,OAAO,CAAC,cAAc,CAAC;gBACX,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,mBAAmB,EAAE,cAAc,GAAE,MAAU;IAQvF,OAAO,CAAC,KAAK;IA4Cb,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,MAAc,GAAG,IAAI;IAIrD,YAAY,CAAC,MAAM,EAAE,mBAAmB,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI;IAOxE,OAAO,CAAC,eAAe,GAAE,OAAc,GAAG,IAAI;CAYjD"}

package/dist/three/effects/VolumetricFogEffectV.js

@@ -0,0 +1,127 @@
+import * as THREE from 'three';
+const fogVert = /* glsl */ `
+  attribute float aT;
+  attribute vec3  aCenter;
+  attribute float aPhase;
+  attribute float aSize;
+
+  uniform float u_time;
+  uniform float uDrift;
+  uniform float uFogRadius;
+
+  varying float vAlpha;
+
+  void main() {
+    float t = fract(aT + u_time * 0.05);
+
+    float dx = sin(u_time * uDrift + aPhase)          * uFogRadius * 0.18;
+    float dz = cos(u_time * uDrift * 0.7 + aPhase * 1.3) * uFogRadius * 0.14;
+    float dy = sin(u_time * 0.25 + aPhase) * uFogRadius * 0.06;
+
+    vec3 pos = aCenter + vec3(dx, dy, dz);
+
+    float pulse = 0.55 + 0.45 * sin(u_time * 0.35 + aPhase * 2.1);
+    vAlpha = pulse;
+
+    vec4 mv = modelViewMatrix * vec4(pos, 1.0);
+    gl_PointSize = aSize * (220.0 / -mv.z);
+    gl_Position  = projectionMatrix * mv;
+  }
+`;
+const fogFrag = /* glsl */ `
+  uniform vec3  uFogColor;
+  uniform float uDensity;
+  varying float vAlpha;
+
+  void main() {
+    vec2  c = gl_PointCoord - 0.5;
+    float d = length(c);
+    if (d > 0.5) discard;
+
+    float g = exp(-d * d * 2.2);
+
+    gl_FragColor = vec4(uFogColor, g * vAlpha * uDensity);
+  }
+`;
+export class VolumetricFogEffectV {
+    scene;
+    group;
+    materials = [];
+    config;
+    boundingRadius;
+    constructor(scene, config, boundingRadius = 1) {
+        this.scene = scene;
+        this.config = config;
+        this.boundingRadius = boundingRadius;
+        this.group = new THREE.Group();
+        scene.add(this.group);
+        this.build();
+    }
+    build() {
+        const { particleCount, fogRadius, driftSpeed, fogColor, density, opacity, intensity } = this.config;
+        const r = this.boundingRadius * fogRadius;
+        const N = Math.max(20, Math.min(particleCount, 200));
+        const aT = new Float32Array(N);
+        const aCenter = new Float32Array(N * 3);
+        const aPhase = new Float32Array(N);
+        const aSize = new Float32Array(N);
+        for (let i = 0; i < N; i++) {
+            aT[i] = i / N;
+            const angle = Math.random() * Math.PI * 2;
+            const rad = Math.sqrt(Math.random()) * r;
+            const yOff = (Math.random() - 0.3) * this.boundingRadius * 0.35;
+            aCenter[i * 3] = Math.cos(angle) * rad;
+            aCenter[i * 3 + 1] = yOff - this.boundingRadius * 0.3;
+            aCenter[i * 3 + 2] = Math.sin(angle) * rad;
+            aPhase[i] = Math.random() * Math.PI * 2;
+            aSize[i] = (50 + Math.random() * 70) * intensity;
+        }
+        const g = new THREE.BufferGeometry();
+        g.setAttribute('position', new THREE.BufferAttribute(new Float32Array(N * 3), 3));
+        g.setAttribute('aT', new THREE.BufferAttribute(aT, 1));
+        g.setAttribute('aCenter', new THREE.BufferAttribute(aCenter, 3));
+        g.setAttribute('aPhase', new THREE.BufferAttribute(aPhase, 1));
+        g.setAttribute('aSize', new THREE.BufferAttribute(aSize, 1));
+        g.frustumCulled = false;
+        const fc = new THREE.Color(fogColor);
+        const m = new THREE.ShaderMaterial({
+            vertexShader: fogVert,
+            fragmentShader: fogFrag,
+            uniforms: {
+                u_time: { value: 0 },
+                uDrift: { value: driftSpeed },
+                uFogRadius: { value: r },
+                uFogColor: { value: new THREE.Vector3(fc.r, fc.g, fc.b) },
+                uDensity: { value: density * opacity },
+            },
+            transparent: true,
+            depthWrite: false,
+            blending: THREE.NormalBlending,
+        });
+        this.materials.push(m);
+        this.group.add(new THREE.Points(g, m));
+    }
+    update(elapsed, _delta = 0.016) {
+        for (const mat of this.materials)
+            mat.uniforms.u_time.value = elapsed;
+    }
+    updateConfig(config, boundingRadius) {
+        this.config = config;
+        if (boundingRadius !== undefined)
+            this.boundingRadius = boundingRadius;
+        this.dispose(false);
+        this.build();
+    }
+    dispose(removeFromScene = true) {
+        this.group.traverse(child => {
+            const c = child;
+            if (c.geometry)
+                c.geometry.dispose();
+        });
+        this.materials.forEach(m => m.dispose());
+        this.materials = [];
+        this.group.clear();
+        if (removeFromScene && this.group.parent)
+            this.group.parent.remove(this.group);
+    }
+}

package/dist/types/actions.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Action Types
+ * Defines the structure for UI actions that can trigger animations, toggle elements, or load projects
+ */
+export type OperationTypes = 'zoom' | 'moveToFront' | 'displayImage' | 'glow' | 'vanish' | 'focus' | 'playAnimation' | 'create' | 'update' | 'delete' | 'toggle' | 'loadProject' | 'none';
+export interface Action {
+    /** Unique identifier for this action */
+    /** Name of the action */
+    name: string;
+    operation: OperationTypes;
+    elementId: string;
+    /** Description of the action */
+    schemaType: string;
+    targetIds?: string[];
+    description?: string;
+    /** Animation sequence IDs to play when this action is executed */
+    animationIds?: string[];
+    /** UI element IDs to toggle (show/hide) when this action is executed */
+    /** Project ID to load when this action is executed */
+    loadProject?: string;
+    payload?: Record<string, any>;
+}
+export type ActionsSet = {
+    id: string;
+    name: string;
+    description?: string;
+    actions: Action[];
+};
+export {};
+//# sourceMappingURL=actions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/types/actions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,aAAa,GAAG,cAAc,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,eAAe,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,aAAa,GAAG,MAAM,CAAC;AAE1L,MAAM,WAAW,MAAM;IACnB,wCAAwC;IACxC,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,cAAc,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,wEAAwE;IACxE,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACjC;AAED,MAAM,MAAM,UAAU,GAAG;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;CACrB,CAAC;AACF,OAAO,EAAE,CAAC"}

package/dist/types/actions.js

@@ -0,0 +1,5 @@
+/**
+ * Action Types
+ * Defines the structure for UI actions that can trigger animations, toggle elements, or load projects
+ */
+export {};

package/dist/types/animations.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Animation Step Types
+ * Defines the structure for animation sequences
+ */
+import type { CreatedObjectSettings, Vector3Array } from "./scene3d";
+export type Transition = {
+    state: string;
+    pathId?: string;
+    properties: {
+        to: Record<string, any>;
+        from?: Record<string, any>;
+    };
+};
+export interface TransitionStep {
+    /** Duration of this animation step in seconds */
+    duration: number;
+    /** Properties to pass to the dispatcher for this state */
+    transitions: Transition[];
+    /** Optional delay before this step starts (in seconds) */
+    delay?: number;
+    /** Optional stagger between each transition in seconds (0 = all simultaneous) */
+    stagger?: number;
+    /** Optional easing function name */
+    ease?: string;
+    /** Optional callback when this step completes */
+    onComplete?: () => void;
+}
+export interface AnimationSequence {
+    /** Unique identifier for this sequence */
+    id: string;
+    /** Name of the animation sequence */
+    name: string;
+    /** Description of the animation sequence */
+    description?: string;
+    /** Array of animation steps to execute */
+    steps: TransitionStep[];
+    /** Whether this sequence should loop */
+    loop?: boolean;
+    /** Whether this sequence should yoyo (play forwards then backwards) */
+    yoyo?: boolean;
+    /** Current step index being executed */
+    currentStep?: number;
+    /** Whether this sequence is currently playing */
+    isPlaying?: boolean;
+    /** Whether this sequence is paused */
+    isPaused?: boolean;
+    /** Progress of the animation (0-1) */
+    progress?: number;
+    assetId?: string | null;
+    isDirty?: boolean;
+}
+export interface PathGeometrySettings {
+    /** Type of geometry to render */
+    type: 'none' | 'road' | 'tube' | 'walls' | 'line' | 'particles';
+    /** Width for road geometry */
+    width?: number;
+    /** Radius for tube geometry */
+    radius?: number;
+    /** Number of radial segments for tube */
+    segments?: number;
+    /** Number of lanes on each side (0 = no lane dividers) */
+    numLanes?: number;
+    /** Color of the geometry */
+    color?: string;
+    /** Color of lane divider lines */
+    dividerColor?: string;
+}
+export interface PathConfig {
+    /** Unique identifier for this sequence */
+    id: string;
+    /** Name of the animation sequence */
+    name: string;
+    /** Description of the animation sequence */
+    description?: string;
+    /** Array of animation steps to execute */
+    points: Vector3Array[];
+    /** Progress of the path animation (0-1) */
+    progress?: number;
+    /** Curve smoothness percentage (0-100). 0 = sharp corners, 100 = maximum smoothing */
+    curve?: number;
+    /** Corner smoothing radius (0-100). Higher values create more rounded corners */
+    smoothCorners?: number;
+    /** 3D geometry settings for rendering road/tube along path */
+    geometry?: PathGeometrySettings;
+    /** Whether to apply rotation to face movement direction (default: true) */
+    applyRotation?: boolean;
+    /** Position offset to add to the calculated path position [x, y, z] */
+    offset?: Vector3Array;
+    pointSize?: number;
+    lineWidth?: number;
+}
+export type PathSettings = CreatedObjectSettings & {
+    config: PathConfig;
+};
+export interface AnimationPlaybackOptions {
+    /** Start from a specific step index */
+    startStep?: number;
+    /** Whether to loop the sequence */
+    loop?: boolean;
+    /** Speed multiplier (1.0 = normal speed) */
+    speed?: number;
+    reverse?: boolean;
+    /** Callback when sequence completes */
+    onComplete?: () => void;
+    /** Internal flag to track yoyo return pass (do not set manually) */
+    _isYoyoReturn?: boolean;
+}
+export {};
+//# sourceMappingURL=animations.d.ts.map

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

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

package/dist/types/animations.js

@@ -0,0 +1,5 @@
+/**
+ * Animation Step Types
+ * Defines the structure for animation sequences
+ */
+export {};

package/dist/types/common.d.ts

@@ -0,0 +1,20 @@
+export type Vector2Array = [number, number];
+export type Vector3Array = [number, number, number];
+export type QuaternionArray = [number, number, number, number];
+export type AnchorPosition = 'top-left' | 'top-center' | 'top-right' | 'center-left' | 'center' | 'center-right' | 'bottom-left' | 'bottom-center' | 'bottom-right';
+export interface AnchorOffset {
+    x?: number;
+    y?: number;
+    z?: number;
+}
+export type AnchorSettings = {
+    enabled: boolean;
+    anchor: AnchorPosition;
+    fixedPosition?: boolean;
+    fixedSize?: boolean;
+    fixedRotation?: boolean;
+    offset?: AnchorOffset;
+    padding?: number;
+};
+export {};
+//# sourceMappingURL=common.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/types/common.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE5C,MAAM,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAEpD,MAAM,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAE/D,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,YAAY,GAAG,WAAW,GAAG,aAAa,GAAG,QAAQ,GAAG,cAAc,GAAG,aAAa,GAAG,eAAe,GAAG,cAAc,CAAC;AAEpK,MAAM,WAAW,YAAY;IACzB,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,cAAc,GAAG;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,cAAc,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AACF,OAAO,EAAE,CAAC"}

package/dist/types/common.js

@@ -0,0 +1 @@
+export {};

package/dist/types/cursor.d.ts

@@ -0,0 +1,142 @@
+export type CursorType = 'comet' | 'lightning' | 'sparkles' | 'crosshair' | 'orb' | 'aura' | 'liquidMetal' | 'aurora' | 'glyphs' | 'ferrofluid' | 'plasmaWhip' | 'tesla' | 'bubbles';
+export type ClickActionType = 'none' | 'shockwave' | 'sparklesBurst' | 'boltFlash' | 'realityTear' | 'implosion' | 'voronoiFracture' | 'phaseShift' | 'plasmaBomb' | 'glyphInscription';
+export type CursorPickMode = 'raycast-scene' | 'raycast-plane' | 'none';
+export interface CursorBaseConfig {
+    enabled: boolean;
+    type: CursorType;
+    color: string;
+    scale: number;
+    intensity: number;
+    opacity: number;
+    idleFadeMs: number;
+    pickMode: CursorPickMode;
+    planeDistance: number;
+}
+export interface CometCursorConfig extends CursorBaseConfig {
+    type: 'comet';
+    trailLength: number;
+    particleCount: number;
+}
+export interface LightningCursorConfig extends CursorBaseConfig {
+    type: 'lightning';
+    segmentCount: number;
+    jitter: number;
+    arcRange: number;
+}
+export interface SparklesCursorConfig extends CursorBaseConfig {
+    type: 'sparkles';
+    particleCount: number;
+    gravity: number;
+    lifetimeMs: number;
+}
+export interface CrosshairCursorConfig extends CursorBaseConfig {
+    type: 'crosshair';
+    showLabel: boolean;
+    outlineColor: string;
+}
+export interface OrbCursorConfig extends CursorBaseConfig {
+    type: 'orb';
+    innerColor: string;
+    outerColor: string;
+    pulseSpeed: number;
+}
+export interface AuraCursorConfig extends CursorBaseConfig {
+    type: 'aura';
+    falloff: number;
+}
+export interface LiquidMetalCursorConfig extends CursorBaseConfig {
+    type: 'liquidMetal';
+    metalness: number;
+    roughness: number;
+    morphSpeed: number;
+}
+export interface AuroraCursorConfig extends CursorBaseConfig {
+    type: 'aurora';
+    trailLength: number;
+    ribbonWidth: number;
+    flowSpeed: number;
+}
+export interface GlyphRingCursorConfig extends CursorBaseConfig {
+    type: 'glyphs';
+    glyphCount: number;
+    ringRadius: number;
+    rotationSpeed: number;
+}
+export interface FerrofluidCursorConfig extends CursorBaseConfig {
+    type: 'ferrofluid';
+    spikeCount: number;
+    reach: number;
+    metalness: number;
+}
+export interface PlasmaWhipCursorConfig extends CursorBaseConfig {
+    type: 'plasmaWhip';
+    pointCount: number;
+    thickness: number;
+    flowSpeed: number;
+}
+export interface TeslaCursorConfig extends CursorBaseConfig {
+    type: 'tesla';
+    pointColor: string;
+    pointSize: number;
+    lineThickness: number;
+    trailLength: number;
+    pulseCount: number;
+    pulseSpeed: number;
+}
+export interface BubblesCursorConfig extends CursorBaseConfig {
+    type: 'bubbles';
+    spawnRate: number;
+    floatSpeed: number;
+    iridescence: number;
+    lifetimeMs: number;
+}
+export type CursorConfig = CometCursorConfig | LightningCursorConfig | SparklesCursorConfig | CrosshairCursorConfig | OrbCursorConfig | AuraCursorConfig | LiquidMetalCursorConfig | AuroraCursorConfig | GlyphRingCursorConfig | FerrofluidCursorConfig | PlasmaWhipCursorConfig | TeslaCursorConfig | BubblesCursorConfig;
+export interface ClickActionBaseConfig {
+    color: string;
+    scale: number;
+    durationMs: number;
+}
+export interface NoneActionConfig extends ClickActionBaseConfig {
+    type: 'none';
+}
+export interface ShockwaveActionConfig extends ClickActionBaseConfig {
+    type: 'shockwave';
+}
+export interface SparklesBurstActionConfig extends ClickActionBaseConfig {
+    type: 'sparklesBurst';
+    rayCount: number;
+}
+export interface BoltFlashActionConfig extends ClickActionBaseConfig {
+    type: 'boltFlash';
+}
+export interface RealityTearActionConfig extends ClickActionBaseConfig {
+    type: 'realityTear';
+    tearWidth: number;
+}
+export interface ImplosionActionConfig extends ClickActionBaseConfig {
+    type: 'implosion';
+    bandCount: number;
+}
+export interface VoronoiFractureActionConfig extends ClickActionBaseConfig {
+    type: 'voronoiFracture';
+    shardCount: number;
+}
+export interface PhaseShiftActionConfig extends ClickActionBaseConfig {
+    type: 'phaseShift';
+    radius: number;
+}
+export interface PlasmaBombActionConfig extends ClickActionBaseConfig {
+    type: 'plasmaBomb';
+    ringWidth: number;
+}
+export interface GlyphInscriptionActionConfig extends ClickActionBaseConfig {
+    type: 'glyphInscription';
+    glyphCount: number;
+}
+export type ClickActionConfig = NoneActionConfig | ShockwaveActionConfig | SparklesBurstActionConfig | BoltFlashActionConfig | RealityTearActionConfig | ImplosionActionConfig | VoronoiFractureActionConfig | PhaseShiftActionConfig | PlasmaBombActionConfig | GlyphInscriptionActionConfig;
+export interface CursorModuleConfig {
+    effects: CursorConfig[];
+    clickActions: ClickActionConfig[];
+}
+export {};
+//# sourceMappingURL=cursor.d.ts.map

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

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

package/dist/types/cursor.js

@@ -0,0 +1 @@
+export {};