mbt-3d 0.4.7 → 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;
 }
@@ -704,6 +710,7 @@ export declare interface RendererConfig {
  * @param camera - Camera configuration object. Example: `{ position: [0, 2, 5], fov: 45 }`
  * @param camera.position - Camera position as [x, y, z]. Example: `[0, 2, 5]`. Default: `[0, 2, 5]`
  * @param camera.fov - Field of view in degrees. Example: `45`. Default: `45`
+ * @param camera.roll - Camera roll angle around viewing direction in degrees. Example: `45`. Default: `0`
  * @param controls - OrbitControls configuration object. Example: `{ enablePan: false, minDistance: 2, maxDistance: 10 }`
  * @param controls.enabled - Enable/disable all controls. Default: `true`
  * @param controls.enablePan - Enable camera panning with middle mouse. Default: `true`
@@ -802,6 +809,8 @@ export declare interface Scene3DProps {
         position?: [number, number, number];
         /** Field of view in degrees. Default: 45 */
         fov?: number;
+        /** Camera roll angle around view direction in degrees. Default: 0 */
+        roll?: number;
     };
     /** OrbitControls configuration for camera rotation */
     controls?: {
@@ -915,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
  *