mbt-3d 0.4.1 → 0.4.3

package/dist/index.d.ts

@@ -49,6 +49,7 @@ declare interface AmbientLightConfig {
  * @param meshVisibility - Mesh visibility as key-value pairs. Example: `{ "Hairgirl1": true, "Hairgirl2": false }`
  * @param materialColors - Material colors as key-value pairs. Example: `{ "Hair_girl_1": "#ff0000" }`
  * @param materialTextures - Material texture maps. Example: `{ "Metal": { map: "/tex.webp", normalMap: "/normal.webp" } }`
+ * @param materialTextureLogging - Enable verbose material texture logs for this model instance. Default: `false`
  * @param children - Child components, typically BoneAttachment components for attaching items
  * @param onLoad - Callback when model loads. Receives AnimatedModelInfo object: `{ meshes, materials, bones, nodeCount, animations, morphTargetNames }`
  * @param onError - Callback when model fails to load. Receives Error object
@@ -195,6 +196,8 @@ export declare interface AnimatedModelProps extends Omit<ModelProps, 'onLoad'> {
     materialColors?: Record<string, string | [number, number, number]>;
     /** Material textures as key-value pairs { materialName: textures }. Example: { "Metal": { map: "/tex.webp" } } */
     materialTextures?: Record<string, MaterialTextures | string>;
+    /** Enable verbose material texture logs for this model instance. Default: false */
+    materialTextureLogging?: boolean;
     /** Callback when model loads with extended metadata including animations */
     onLoad?: (info: AnimatedModelInfo) => void;
 }
@@ -376,6 +379,7 @@ declare interface MaterialTextures_2 {
  * @param meshVisibility - Mesh visibility as key-value pairs. Example: `{ "Part1": true, "Part2": false }`
  * @param materialColors - Material colors as key-value pairs. Example: `{ "MaterialName": "#ff0000" }`
  * @param materialTextures - Material texture maps. Example: `{ "Metal": { map: "/tex.webp", normalMap: "/normal.webp" } }`
+ * @param materialTextureLogging - Enable verbose material texture logs for this model instance. Default: `false`
  * @param onLoad - Callback when model finishes loading. Receives ModelInfo object with metadata: `{ meshes, materials, bones, nodeCount }`
  * @param onError - Callback when model fails to load. Receives Error object
  *
@@ -391,7 +395,7 @@ declare interface MaterialTextures_2 {
  * />
  * ```
  */
-export declare function Model({ url, position, rotation, scale, meshVisibility, materialColors, materialTextures, onLoad, onError: _onError, }: ModelProps): JSX_2.Element;
+export declare function Model({ url, position, rotation, scale, meshVisibility, materialColors, materialTextures, materialTextureLogging, onLoad, onError: _onError, }: ModelProps): JSX_2.Element;
 
 export declare namespace Model {
     var preload: (url: string) => void;
@@ -439,6 +443,8 @@ export declare interface ModelProps {
     materialColors?: Record<string, string | [number, number, number]>;
     /** Material textures as key-value pairs { materialName: textures }. Example: { "Metal": { map: "/tex.webp" } } */
     materialTextures?: Record<string, MaterialTextures | string>;
+    /** Enable verbose material texture logs for this model instance. Default: false */
+    materialTextureLogging?: boolean;
     /** Callback when model finishes loading with metadata */
     onLoad?: (info: ModelInfo) => void;
     /** Callback when model fails to load */
@@ -469,6 +475,7 @@ export declare interface ModelProps {
  * @param meshVisibility - Mesh visibility as key-value pairs. Example: `{ "Hairgirl1": true, "Hairgirl2": false }`
  * @param materialColors - Material colors as key-value pairs. Example: `{ "Hair_girl_1": "#ff0000" }`
  * @param materialTextures - Material texture maps. Example: `{ "Metal": { map: "/tex.webp", normalMap: "/normal.webp" } }`
+ * @param materialTextureLogging - Enable verbose material texture logs for this model instance. Default: `false`
  * @param onMorphTargetsFound - Callback when morph targets are discovered from the model. Receives array of morph target names: `["muscular", "thin", "fat"]`
  * @param onLoad - Callback when model finishes loading. Receives ModelInfo object with metadata: `{ meshes, materials, bones, nodeCount }`
  * @param onError - Callback when model fails to load. Receives Error object
@@ -569,6 +576,8 @@ export declare interface MorphableModelProps extends ModelProps {
     materialColors?: Record<string, string | [number, number, number]>;
     /** Material textures as key-value pairs { materialName: textures }. Example: { "Metal": { map: "/tex.webp" } } */
     materialTextures?: Record<string, MaterialTextures | string>;
+    /** Enable verbose material texture logs for this model instance. Default: false */
+    materialTextureLogging?: boolean;
     /** Callback when morph targets are discovered from the model */
     onMorphTargetsFound?: (names: string[]) => void;
 }
@@ -857,14 +866,25 @@ export declare function useMaterialColor(scene: THREE.Object3D, initialColors?:
  *
  * @param scene - The THREE.Object3D scene containing meshes with materials
  * @param textures - Initial texture maps for materials { materialName: textureConfig }
+ * @param options - Hook runtime options
  * @returns Methods to control material textures
  */
-export declare function useMaterialTexture(scene: THREE.Object3D, textures?: Record<string, MaterialTextures_2 | string>): {
+export declare function useMaterialTexture(scene: THREE.Object3D, textures?: Record<string, MaterialTextures_2 | string>, options?: UseMaterialTextureOptions): {
     setMaterialTextures: (materialName: string, textureConfig: MaterialTextures_2 | string) => void;
     getMaterialNames: () => string[];
     clearMaterialTextures: (materialName: string) => void;
 };
 
+/**
+ * Runtime options for useMaterialTexture hook.
+ */
+declare interface UseMaterialTextureOptions {
+    /**
+     * Enable verbose texture lifecycle logs (disabled by default).
+     */
+    enableLogging?: boolean;
+}
+
 /**
  * Hook for managing mesh visibility in a 3D scene
  *