@3driseai/3drise-core 1.0.1

package/dist/utils/frameAnimations.js

@@ -0,0 +1,449 @@
+// =============================================================================
+// FRAME ANIMATIONS - Centralized Transform and Color Effects
+// =============================================================================
+// All per-frame animation effects for 3D objects
+// Used with useFrame() hook in React Three Fiber components
+import { easing } from "maath";
+import { Color } from "three";
+// =============================================================================
+// LEGACY FUNCTIONS (for backward compatibility)
+// =============================================================================
+export function applyRotationEffects(group, effects, hovered, isActive, dt, spinSpeed, flipSpeed, originalRotation, name) {
+    let targetRotY = originalRotation[1];
+    const shouldSpin = effects.includes('spin') && !isActive && hovered;
+    const shouldFlip = effects.includes('flip') && !isActive && hovered;
+    if (shouldSpin) {
+        group.rotation.y += dt * spinSpeed;
+    }
+    else if (shouldFlip) {
+        targetRotY = originalRotation[1] + Math.PI;
+        easing.damp(group.rotation, 'y', targetRotY, flipSpeed, dt);
+    }
+    else {
+        easing.damp(group.rotation, 'y', originalRotation[1], 0.3, dt);
+    }
+}
+export function applyScaleEffects(object, effects, hovered, isActive, hoverScale, dt, originalScale) {
+    const shouldScale = effects.includes('scale') && !isActive && hovered;
+    console.log("applyScaleEffects - shouldScale:", object);
+    if (shouldScale) {
+        easing.damp3(object.scale, [originalScale[0] * hoverScale, originalScale[1] * hoverScale, originalScale[2] * hoverScale], 0.1, dt);
+    }
+    else {
+        easing.damp3(object.scale, originalScale, 0.1, dt);
+    }
+}
+export function applyColorEffects(object, effects, hovered, baseColor, hoverColor, dt) {
+    const shouldColor = effects.includes('color');
+    const targetColor = hoverColor;
+    if (shouldColor) {
+        if (hovered) {
+            object.traverse((child) => {
+                if (child.material && child.material.color) {
+                    easing.dampC(child.material.color, targetColor, 0.1, dt);
+                }
+            });
+        }
+        else {
+            object.traverse((child) => {
+                if (child.material && child.material.color) {
+                    easing.dampC(child.material.color, baseColor, 0.1, dt);
+                }
+            });
+        }
+    }
+}
+// =============================================================================
+// NEW UNIFIED EFFECT SYSTEM
+// =============================================================================
+/**
+ * Check if an effect should be active based on trigger mode and current state
+ * NOTE: V2 effects don't have triggerMode - they're organized by location:
+ *   - effects.transform = always active
+ *   - interactions.hover.effects.transform = hover-triggered
+ * When triggerMode is undefined, default to 'always' (V2 continuous effects)
+ */
+export function shouldEffectBeActive(effect, hovered, clicked) {
+    if (!effect.enabled)
+        return false;
+    // V2 effects don't have triggerMode - default to always active
+    const mode = effect.triggerMode ?? 'always';
+    switch (mode) {
+        case 'always':
+            return true;
+        case 'hover':
+            return hovered;
+        case 'click':
+            return clicked;
+        default:
+            return true; // Safe default: run the effect
+    }
+}
+/**
+ * Get enabled effects filtered by trigger state
+ */
+export function getActiveEffects(effects, hovered, clicked) {
+    return effects.filter(effect => shouldEffectBeActive(effect, hovered, clicked));
+}
+// =============================================================================
+// TRANSFORM EFFECT IMPLEMENTATIONS
+// =============================================================================
+/**
+ * Apply wave effect - oscillating Y position
+ */
+export function applyWaveEffect(object, effect, time, originalY) {
+    const options = effect.options;
+    const amplitude = options?.amplitude ?? 0.1;
+    const frequency = options?.frequency ?? 2;
+    const speed = effect.speed ?? 1;
+    const intensity = effect.intensity ?? 1;
+    object.position.y = originalY + Math.sin(time * frequency * speed) * amplitude * intensity;
+}
+/**
+ * Apply float effect - gentle floating in multiple directions
+ */
+export function applyFloatEffect(object, effect, time, originalPosition) {
+    const options = effect.options;
+    const speed = effect.speed ?? 1;
+    const intensity = effect.intensity ?? 1;
+    const ampX = (options?.amplitudeX ?? 0.05) * intensity;
+    const ampY = (options?.amplitudeY ?? 0.1) * intensity;
+    const ampZ = (options?.amplitudeZ ?? 0.03) * intensity;
+    object.position.x = originalPosition.x + Math.cos(time * speed * 0.5) * ampX;
+    object.position.y = originalPosition.y + Math.sin(time * speed) * ampY;
+    object.position.z = originalPosition.z + Math.sin(time * speed * 0.3) * ampZ;
+}
+/**
+ * Apply pulse effect - rhythmic scale animation
+ */
+export function applyPulseEffect(object, effect, time, originalScale) {
+    const options = effect.options;
+    const speed = effect.speed ?? 2;
+    const minScale = options?.minScale ?? 0.95;
+    const maxScale = options?.maxScale ?? 1.05;
+    const range = maxScale - minScale;
+    const scaleFactor = minScale + (Math.sin(time * speed) + 1) * 0.5 * range;
+    object.scale.set(originalScale.x * scaleFactor, originalScale.y * scaleFactor, originalScale.z * scaleFactor);
+}
+/**
+ * Apply shake effect - random vibration
+ */
+export function applyShakeEffect(object, effect, originalPosition) {
+    const options = effect.options;
+    const intensity = effect.intensity ?? 1;
+    const ampX = (options?.amplitudeX ?? 0.02) * intensity;
+    const ampY = (options?.amplitudeY ?? 0.02) * intensity;
+    object.position.x = originalPosition.x + (Math.random() - 0.5) * ampX;
+    object.position.y = originalPosition.y + (Math.random() - 0.5) * ampY;
+}
+/**
+ * Apply bounce effect - bouncing motion
+ */
+export function applyBounceEffect(object, effect, time, originalY) {
+    const options = effect.options;
+    const speed = effect.speed ?? 3;
+    const bounceHeight = options?.bounceHeight ?? 0.2;
+    const intensity = effect.intensity ?? 1;
+    object.position.y = originalY + Math.abs(Math.sin(time * speed)) * bounceHeight * intensity;
+}
+/**
+ * Apply rotate3d effect - subtle 3D rotation
+ */
+export function applyRotate3DEffect(object, effect, time, originalRotation) {
+    const options = effect.options;
+    const speed = effect.speed ?? 1;
+    const intensity = (effect.intensity ?? 1) * 0.1;
+    if (options?.axisX !== false) {
+        object.rotation.x = originalRotation.x + Math.cos(time * speed * 0.7) * intensity * 0.5;
+    }
+    if (options?.axisY !== false) {
+        object.rotation.y = originalRotation.y + Math.sin(time * speed) * intensity;
+    }
+    if (options?.axisZ) {
+        object.rotation.z = originalRotation.z + Math.sin(time * speed * 0.5) * intensity * 0.3;
+    }
+}
+/**
+ * Apply fade effect - pulsing opacity
+ * Returns the calculated opacity value
+ */
+export function applyFadeEffect(effect, time) {
+    const options = effect.options;
+    const speed = effect.speed ?? 1;
+    const fadeMin = options?.fadeMin ?? 0.3;
+    const fadeMax = options?.fadeMax ?? 1;
+    const range = fadeMax - fadeMin;
+    return fadeMin + (Math.sin(time * speed) + 1) * 0.5 * range;
+}
+/**
+ * Apply spin effect - continuous rotation
+ */
+export function applySpinEffect(object, effect, dt) {
+    const options = effect.options;
+    const speed = effect.speed ?? 1;
+    const axis = options?.axis ?? 'y';
+    object.rotation[axis] += dt * speed;
+}
+/**
+ * Apply sway effect - pendulum-like rotation
+ */
+export function applySwayEffect(object, effect, time, originalRotation) {
+    const options = effect.options;
+    const speed = effect.speed ?? 1;
+    const angle = options?.angle ?? 0.2;
+    const axis = options?.axis ?? 'z';
+    const intensity = effect.intensity ?? 1;
+    object.rotation[axis] = originalRotation[axis] + Math.sin(time * speed) * angle * intensity;
+}
+/**
+ * Apply flip effect - 180° rotation on trigger (with easing)
+ */
+export function applyFlipEffect(object, effect, isActive, dt, originalRotation, sensitivity = 0.5) {
+    const options = effect.options;
+    const axis = options?.axis ?? 'y';
+    const speed = effect.speed ?? 0.3;
+    const dampSpeed = speed * (1 - sensitivity * 0.5); // Lower sensitivity = slower
+    const targetRotation = isActive
+        ? originalRotation[axis] + Math.PI
+        : originalRotation[axis];
+    easing.damp(object.rotation, axis, targetRotation, dampSpeed, dt);
+}
+/**
+ * Apply scale effect - scale up/down on trigger (with easing)
+ */
+export function applyScaleEffect(object, effect, isActive, dt, originalScale, sensitivity = 0.5) {
+    const options = effect.options;
+    const targetScale = options?.targetScale ?? 1.2;
+    const speed = effect.speed ?? 0.1;
+    const dampSpeed = speed * (1 - sensitivity * 0.5);
+    const scale = isActive
+        ? [originalScale.x * targetScale, originalScale.y * targetScale, originalScale.z * targetScale]
+        : [originalScale.x, originalScale.y, originalScale.z];
+    easing.damp3(object.scale, scale, dampSpeed, dt);
+}
+// =============================================================================
+// COLOR EFFECT IMPLEMENTATIONS
+// =============================================================================
+/**
+ * Get color value from material at a given property path
+ */
+function getColorFromPath(material, path) {
+    const parts = path.split('.');
+    let current = material;
+    for (const part of parts) {
+        if (current === null || current === undefined)
+            return null;
+        current = current[part];
+    }
+    if (current?.value instanceof Color)
+        return current.value;
+    if (current instanceof Color)
+        return current;
+    return null;
+}
+/**
+ * Apply color transition effect - smooth transition to target color
+ */
+export function applyColorTransitionEffect(object, effect, isActive, dt, baseColors, applyToChildren = true, sensitivity = 0.5) {
+    const targetProperties = effect.targetProperties ?? ['color'];
+    const targetColor = isActive ? effect.targetColor : null;
+    const dampSpeed = 0.1 * (1 - sensitivity * 0.5);
+    const applyToMaterial = (material) => {
+        for (const propPath of targetProperties) {
+            const color = getColorFromPath(material, propPath);
+            if (color) {
+                const baseColor = baseColors[propPath] || '#ffffff';
+                easing.dampC(color, targetColor || baseColor, dampSpeed, dt);
+            }
+        }
+    };
+    if (applyToChildren) {
+        object.traverse((child) => {
+            if (child.material) {
+                applyToMaterial(child.material);
+            }
+        });
+    }
+    else {
+        const mesh = object;
+        if (mesh.material) {
+            applyToMaterial(mesh.material);
+        }
+    }
+}
+/**
+ * Apply pulse color effect - pulsing between base and target color
+ */
+export function applyPulseColorEffect(object, effect, time, baseColors, applyToChildren = true) {
+    const targetProperties = effect.targetProperties ?? ['color'];
+    const speed = effect.speed ?? 1;
+    const intensity = effect.intensity ?? 1;
+    // Calculate blend factor (0-1 oscillating)
+    const blend = (Math.sin(time * speed * 2) + 1) * 0.5 * intensity;
+    const baseColorObj = new Color();
+    const targetColorObj = new Color(effect.targetColor);
+    const resultColor = new Color();
+    const applyToMaterial = (material) => {
+        for (const propPath of targetProperties) {
+            const color = getColorFromPath(material, propPath);
+            if (color) {
+                const baseColor = baseColors[propPath] || '#ffffff';
+                baseColorObj.set(baseColor);
+                resultColor.copy(baseColorObj).lerp(targetColorObj, blend);
+                color.copy(resultColor);
+            }
+        }
+    };
+    if (applyToChildren) {
+        object.traverse((child) => {
+            if (child.material) {
+                applyToMaterial(child.material);
+            }
+        });
+    }
+    else {
+        const mesh = object;
+        if (mesh.material) {
+            applyToMaterial(mesh.material);
+        }
+    }
+}
+// =============================================================================
+// ORCHESTRATORS - Apply multiple effects
+// =============================================================================
+/**
+ * Apply all transform effects to an object
+ */
+export function applyTransformEffects(object, effects, time, dt, state, hovered, clicked, sensitivity = 0.5) {
+    let result = {};
+    // console.log(hovered)
+    for (const effect of effects) {
+        const isActive = shouldEffectBeActive(effect, hovered, clicked);
+        // console.log(`Effect ${effect.type} is ${isActive ? 'active' : 'inactive'} (hovered: ${hovered}, clicked: ${clicked})`);
+        // Continuous effects (triggerMode doesn't affect animation, only whether it runs)
+        if (!isActive)
+            continue;
+        switch (effect.type) {
+            case 'wave':
+                applyWaveEffect(object, effect, time, state.originalPosition.y);
+                break;
+            case 'float':
+                applyFloatEffect(object, effect, time, state.originalPosition);
+                break;
+            case 'pulse':
+                applyPulseEffect(object, effect, time, state.originalScale);
+                break;
+            case 'shake':
+                applyShakeEffect(object, effect, state.originalPosition);
+                break;
+            case 'bounce':
+                applyBounceEffect(object, effect, time, state.originalPosition.y);
+                break;
+            case 'rotate3d':
+                applyRotate3DEffect(object, effect, time, state.originalRotation);
+                break;
+            case 'fade':
+                result.opacity = applyFadeEffect(effect, time);
+                break;
+            case 'spin':
+                applySpinEffect(object, effect, dt);
+                break;
+            case 'sway':
+                applySwayEffect(object, effect, time, state.originalRotation);
+                break;
+        }
+    }
+    // Triggered effects (need to run even when not active to ease back)
+    for (const effect of effects) {
+        if (!effect.enabled)
+            continue;
+        const isActive = shouldEffectBeActive(effect, hovered, clicked);
+        switch (effect.type) {
+            case 'flip':
+                applyFlipEffect(object, effect, isActive, dt, state.originalRotation, sensitivity);
+                break;
+            case 'scale':
+                applyScaleEffect(object, effect, isActive, dt, state.originalScale, sensitivity);
+                break;
+        }
+    }
+    return result;
+}
+/**
+ * Apply all color effects to an object
+ */
+export function applyAllColorEffects(object, effects, time, dt, baseColors, hovered, clicked, applyToChildren = true, sensitivity = 0.5) {
+    for (const effect of effects) {
+        if (!effect.enabled)
+            continue;
+        const isActive = shouldEffectBeActive(effect, hovered, clicked);
+        switch (effect.type) {
+            case 'color-transition':
+                applyColorTransitionEffect(object, effect, isActive, dt, baseColors, applyToChildren, sensitivity);
+                break;
+            case 'pulse-color':
+                if (isActive) {
+                    applyPulseColorEffect(object, effect, time, baseColors, applyToChildren);
+                }
+                break;
+            // gradient-color would need shader support
+        }
+    }
+}
+// =============================================================================
+// EFFECT STATE UTILITIES
+// =============================================================================
+/**
+ * Create effect state from an Object3D
+ */
+export function createEffectStateFromObject(object) {
+    return {
+        originalPosition: {
+            x: object.position.x,
+            y: object.position.y,
+            z: object.position.z
+        },
+        originalScale: {
+            x: object.scale.x,
+            y: object.scale.y,
+            z: object.scale.z
+        },
+        originalRotation: {
+            x: object.rotation.x,
+            y: object.rotation.y,
+            z: object.rotation.z
+        },
+        originalOpacity: 1,
+        originalColors: {},
+        time: 0,
+        isTriggered: false,
+    };
+}
+/**
+ * Extract base colors from an object's materials
+ */
+export function extractBaseColors(object, targetProperties = ['color'], applyToChildren = true) {
+    const colors = {};
+    const extractFromMaterial = (material) => {
+        for (const propPath of targetProperties) {
+            const color = getColorFromPath(material, propPath);
+            if (color && !colors[propPath]) {
+                colors[propPath] = '#' + color.getHexString();
+            }
+        }
+    };
+    if (applyToChildren) {
+        object.traverse((child) => {
+            if (child.material) {
+                extractFromMaterial(child.material);
+            }
+        });
+    }
+    else {
+        const mesh = object;
+        if (mesh.material) {
+            extractFromMaterial(mesh.material);
+        }
+    }
+    return colors;
+}

package/dist/utils/galleriesUtils.d.ts

@@ -0,0 +1,10 @@
+import { type GalleryLayoutSettings, type FrameData, type GalleryConfig, type GalleryLayout } from "../types/gallery";
+export declare const defaultImageUrls: string[];
+export declare const createNumberOfDefaultImages: (num: number) => string[];
+export declare const getInitialLayoutSettings: (layout: GalleryLayout) => GalleryLayoutSettings;
+export declare const updateCurrentLayoutSettings: (currentSettings: GalleryLayoutSettings, newSettings?: Partial<GalleryLayoutSettings>) => {
+    frames: FrameData[];
+    layoutSettings: GalleryLayoutSettings;
+};
+export declare const defaultGalleryState: GalleryConfig;
+//# sourceMappingURL=galleriesUtils.d.ts.map

package/dist/utils/galleriesUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"galleriesUtils.d.ts","sourceRoot":"","sources":["../../src/utils/galleriesUtils.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,qBAAqB,EAAE,KAAK,SAAS,EAAE,KAAK,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAKtH,eAAO,MAAM,gBAAgB,EAAE,MAAM,EAqBpC,CAAC;AACF,eAAO,MAAM,2BAA2B,GAAI,KAAK,MAAM,KAAG,MAAM,EAM/D,CAAC;AAIF,eAAO,MAAM,wBAAwB,GAAI,QAAQ,aAAa,KAAG,qBAuBhE,CAAC;AACF,eAAO,MAAM,2BAA2B,GAAI,iBAAiB,qBAAqB,EAAE,cAAc,OAAO,CAAC,qBAAqB,CAAC,KAAG;IAC3H,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,cAAc,EAAE,qBAAqB,CAAC;CA8B7C,CAAC;AAIF,eAAO,MAAM,mBAAmB,EAAE,aAgEjC,CAAC"}

package/dist/utils/galleriesUtils.js

@@ -0,0 +1,162 @@
+import { GalleryCreator } from './GalleryCreator.js';
+import { pexel } from '../data/images.js';
+import { FrontSide } from 'three';
+import { defaultParticlesSettings } from '../data/particlesSettings.js';
+import { getLayoutSettings } from './GalleryLayouts.js';
+// =============================================================================
+// DEFAULT IMAGE URLS
+// =============================================================================
+export const defaultImageUrls = [
+    pexel(1103970),
+    pexel(416430),
+    pexel(310452),
+    pexel(327482),
+    pexel(325185),
+    pexel(358574),
+    pexel(227675),
+    pexel(911738),
+    pexel(1738986),
+    pexel(1181467),
+    pexel(1181605),
+    pexel(1181719),
+    pexel(1181403),
+    pexel(1181282),
+    pexel(1181396),
+    pexel(1181677),
+    pexel(1181248),
+    pexel(1181263),
+    pexel(1181424),
+    pexel(1181675),
+];
+export const createNumberOfDefaultImages = (num) => {
+    const urls = [];
+    for (let i = 0; i < num; i++) {
+        urls.push(defaultImageUrls[i % defaultImageUrls.length]);
+    }
+    return urls;
+};
+// =============================================================================
+// LAYOUT SETTINGS HELPERS
+// =============================================================================
+export const getInitialLayoutSettings = (layout) => {
+    const galleryState = {
+        geometryType: 'plane',
+        columns: 3,
+        width: 1,
+        height: 1,
+        spacing: 3.5,
+        startX: 0,
+        startY: 0,
+        radius: 5,
+        rotations: 2,
+        heightIncrement: 0.5,
+        arcAngle: Math.PI,
+        amplitude: 2,
+        frequency: 2,
+        layers: 3,
+        depth: 20,
+        scaleFactor: 0.8,
+        bounds: 8,
+        layout,
+        numImages: 20,
+    };
+    return getLayoutSettings(layout, galleryState);
+};
+export const updateCurrentLayoutSettings = (currentSettings, newSettings) => {
+    console.log('Updating layout settings for gallery:', currentSettings);
+    const galleryState = {
+        geometryType: newSettings?.geometryType ?? currentSettings.geometryType,
+        columns: newSettings?.columns ?? currentSettings.columns ?? 3,
+        width: newSettings?.width ?? currentSettings.width ?? 1,
+        height: newSettings?.height ?? currentSettings.height ?? 1,
+        spacing: newSettings?.spacing ?? currentSettings.spacing ?? 3.5,
+        startX: newSettings?.startX ?? currentSettings.startX ?? 0,
+        startY: newSettings?.startY ?? currentSettings.startY ?? 0,
+        radius: newSettings?.radius ?? currentSettings.radius ?? 5,
+        rotations: newSettings?.rotations ?? currentSettings.rotations ?? 2,
+        heightIncrement: newSettings?.heightIncrement ?? currentSettings.heightIncrement ?? 0.5,
+        arcAngle: newSettings?.arcAngle ?? currentSettings.arcAngle ?? Math.PI,
+        amplitude: newSettings?.amplitude ?? currentSettings.amplitude ?? 2,
+        frequency: newSettings?.frequency ?? currentSettings.frequency ?? 2,
+        layers: newSettings?.layers ?? currentSettings.layers ?? 3,
+        depth: newSettings?.depth ?? currentSettings.depth ?? 20,
+        scaleFactor: newSettings?.scaleFactor ?? currentSettings.scaleFactor ?? 0.8,
+        bounds: newSettings?.bounds ?? currentSettings.bounds ?? 8,
+        outerFrameScale: newSettings?.outerFrameScale ?? currentSettings.outerFrameScale ?? 1,
+        numImages: newSettings?.numImages ?? currentSettings.numImages ?? 20,
+        layout: newSettings?.layout ?? currentSettings.layout,
+    };
+    const frames = GalleryCreator.generateGallery(currentSettings.imageUrls && currentSettings.imageUrls.length > 0
+        ? currentSettings.imageUrls
+        : createNumberOfDefaultImages(galleryState.numImages ?? 20), galleryState);
+    const layoutSettings = getLayoutSettings(currentSettings.layout, galleryState);
+    return { frames, layoutSettings };
+};
+// =============================================================================
+// DEFAULT STATE
+// =============================================================================
+export const defaultGalleryState = {
+    layout: 'tunnel',
+    assetId: null,
+    currentImageUrl: '',
+    animationId: 'yoyo-sequence-1',
+    generalSettings: {
+        visible: false,
+        name: 'New Gallery',
+        description: 'Default gallery description',
+        side: FrontSide,
+        imageUrls: [],
+        autoAnimationSpeed: 2,
+    },
+    generatedFrames: [],
+    mainImageSettings: {
+        ...defaultParticlesSettings,
+        name: 'New Gallery display',
+        meshSettings: {
+            ...defaultParticlesSettings.meshSettings,
+            scale: [8, 4.5, 1],
+        },
+        config: {
+            ...defaultParticlesSettings.config,
+            count: 10000,
+            paths: false,
+        },
+    },
+    gallerySettings: {
+        type: 'gallery',
+        id: `gallery-${Date.now()}`,
+        name: 'New Gallery layout',
+        meshSettings: {
+            id: `mesh-${Date.now()}`,
+            name: 'Default Main Image Settings',
+            visible: true,
+            position: [0, 5, 0],
+            rotation: [0, 0, 0],
+            scale: [1, 1, 1],
+            anchor: null,
+        },
+        materialSettings: {
+            materialType: 'basic',
+            materialName: 'Standard',
+            color: '#ffffff',
+            opacity: 1.0,
+        },
+        // hoverSettings: {
+        //   sensitivity: 0.5,
+        //   applyToChildren: true,
+        // },
+        actions: [
+            {
+                enabled: true,
+                mouseEvent: 'click',
+                operations: ['zoom'],
+                settings: {
+                    distance: 2,
+                    duration: 1.0,
+                    ease: 'power2.out',
+                },
+            },
+        ],
+        config: getInitialLayoutSettings('scattered'),
+    },
+};

package/dist/utils/getAnimatableProperties.d.ts

@@ -0,0 +1,30 @@
+import type { MouseMoveInteraction, MouseMoveInteractions, ObjectAnimations } from "../types/objectSettings";
+export type AnimatableDomain = 'transform' | 'material' | 'edges' | 'light' | 'clouds' | 'rain';
+export interface AnimatableProperty {
+    value: string;
+    label: string;
+}
+export interface AnimatableTarget {
+    id?: string;
+    meshSettings?: Record<string, any>;
+    materialSettings?: Record<string, any>;
+    edgesSettings?: {
+        type?: 'tube' | 'cube';
+        materialSettings?: Record<string, any>;
+    };
+    config?: ({
+        type?: string;
+    } & Record<string, any>);
+    animations?: ObjectAnimations;
+    mouseMove?: MouseMoveInteractions | MouseMoveInteraction;
+}
+/** camelCase / kebab-ish → "Title Case". */
+export declare function toAnimatableLabel(key: string): string;
+export declare function getAnimatableProperties(settings: AnimatableTarget, domain: AnimatableDomain): AnimatableProperty[];
+/**
+ * Detect which domain a property name belongs to, for a given target. Used by
+ * the runtime + UI to migrate flat MouseMove arrays into the new per-domain
+ * shape, and to route the runtime's combined dispatch.
+ */
+export declare function detectAnimatableDomain(settings: AnimatableTarget, propertyName: string): AnimatableDomain | null;
+//# sourceMappingURL=getAnimatableProperties.d.ts.map

package/dist/utils/getAnimatableProperties.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getAnimatableProperties.d.ts","sourceRoot":"","sources":["../../src/utils/getAnimatableProperties.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC7G,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEhG,MAAM,WAAW,kBAAkB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC7B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACnC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACvC,aAAa,CAAC,EAAE;QACZ,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAC1C,CAAC;IACF,MAAM,CAAC,EAAE,CAAC;QACN,IAAI,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IACzB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,SAAS,CAAC,EAAE,qBAAqB,GAAG,oBAAoB,CAAC;CAC5D;AA+DD,4CAA4C;AAC5C,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKrD;AAwDD,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,gBAAgB,GAAG,kBAAkB,EAAE,CAiBlH;AACD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAwBhH"}