mbt-3d 0.4.8 → 0.4.10

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;
 }
@@ -452,7 +458,7 @@ declare interface MaterialTextures_2 {
  * />
  * ```
  */
-export declare function Model({ url, position, rotation, scale, meshVisibility, materialColors, materialTextures, materialTextureLogging, onLoad, onError: _onError, }: ModelProps): JSX_2.Element;
+export declare function Model({ url, position, rotation, scale, meshVisibility, materialColors, materialTextures, materialTextureLogging, onLoad, onTexturesLoaded, onError: _onError, }: ModelProps): JSX_2.Element;
 
 export declare namespace Model {
     var preload: (url: string) => void;
@@ -506,6 +512,8 @@ export declare interface ModelProps {
     onLoad?: (info: ModelInfo) => void;
     /** Callback when model fails to load */
     onError?: (error: Error) => void;
+    /** Callback when textures have finished loading and applying */
+    onTexturesLoaded?: () => void;
 }
 
 /**
@@ -918,6 +926,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
  *
@@ -954,6 +975,10 @@ declare interface UseMaterialTextureOptions {
      * Enable verbose texture lifecycle logs (disabled by default).
      */
     enableLogging?: boolean;
+    /**
+     * Callback fired when all textures for the material have finished downloading and applying.
+     */
+    onTexturesLoaded?: () => void;
 }
 
 /**