mbt-3d 0.4.6 → 0.4.8

package/dist/index.d.ts

@@ -663,6 +663,14 @@ declare interface PointLightConfig extends BaseLightConfig {
 
 export declare function preloadModel(url: string): void;
 
+/**
+ * Preload standard (non-KTX2) textures into the global cache.
+ * Call this as early as possible (e.g. when inventory data loads) to ensure
+ * textures are ready before the model is mounted.
+ * KTX2 textures require a WebGL renderer — preload them via usePreloadTextures hook instead.
+ */
+export declare function preloadTextures(textures: Record<string, MaterialTextures_2 | string>): void;
+
 /**
  * WebGL renderer settings for light response and color mapping.
  * Useful for physically based lighting tests.
@@ -696,6 +704,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`
@@ -794,6 +803,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?: {