mbt-3d 0.4.8 → 0.4.9

package/dist/index.d.ts

@@ -255,6 +255,12 @@ export declare interface AnimatedModelProps extends Omit<ModelProps, 'onLoad'> {
     materialTextures?: Record<string, MaterialTextures | string>;
     /** Enable verbose material texture logs for this model instance. Default: false */
     materialTextureLogging?: boolean;
+    /**
+     * Names of eye bone objects to animate with mouse-follow behavior.
+     * When provided, the model's eyes will track the mouse cursor.
+     * @example eyeNames={['Eye_L', 'Eye_R']}
+     */
+    eyeNames?: string[];
     /** Callback when model loads with extended metadata including animations */
     onLoad?: (info: AnimatedModelInfo) => void;
 }
@@ -918,6 +924,19 @@ declare interface UseClonedModelOptions {
     onError?: (error: Error) => void;
 }
 
+/**
+ * Animates eye bones to follow the mouse cursor.
+ *
+ * @param scene - The THREE.Group scene containing the eye bones
+ * @param eyeNames - Names of eye bone objects to animate. Pass an empty array to disable.
+ *
+ * @example
+ * ```tsx
+ * useEyeAnimation(scene, ['Eye_L', 'Eye_R']);
+ * ```
+ */
+export declare const useEyeAnimation: (scene: THREE.Object3D, eyeNames?: readonly string[]) => void;
+
 /**
  * Hook for managing material colors in a 3D scene
  *