@giszhc/three-model-viewer 1.0.0 → 1.1.0

package/dist/loaders/ModelLoader.d.ts

@@ -5,29 +5,78 @@ export interface ManagedMeshMaterial {
     originalMaterial: THREE.Material | THREE.Material[];
     plainMaterial: THREE.Material;
 }
+export interface ModelLoaderOptions {
+    dracoDecoderPath?: string;
+    ktx2TranscoderPath?: string;
+    renderer?: THREE.WebGLRenderer;
+}
 export declare class ModelLoader {
     private currentZipContent;
+    private customBlobUrls;
     private managedMaterials;
     private isTextureEnabled;
     private displayStyle;
     private plainColor;
     private currentClippingPlanes;
+    private dracoDecoderPath;
+    private dracoLoader;
+    private ktx2TranscoderPath;
+    private ktx2Loader;
+    private renderer;
+    constructor(optionsOrDracoPath?: string | ModelLoaderOptions, renderer?: THREE.WebGLRenderer);
+    /**
+     * Set WebGLRenderer instance to allow KTX2Loader to query supported compressed texture formats
+     */
+    setRenderer(renderer: THREE.WebGLRenderer): void;
+    /**
+     * Set custom Draco decoder directory URL
+     */
+    setDracoDecoderPath(path: string): void;
+    /**
+     * Set custom KTX2 / Basis transcoder directory URL
+     */
+    setKTX2TranscoderPath(path: string): void;
+    /**
+     * Internal helper to create or retrieve cached DRACOLoader
+     */
+    private getDracoLoader;
+    /**
+     * Internal helper to create or retrieve cached KTX2Loader
+     */
+    private getKTX2Loader;
     /**
-     * Load model from a ZIP file containing .obj, .mtl, and image textures
+     * Internal helper to construct configured GLTFLoader
+     */
+    private createGLTFLoader;
+    /**
+     * Load model from a ZIP file containing .glb, .gltf, or .obj + textures
      */
     loadZip(source: File | Blob | ArrayBuffer | string, onProgress?: (percent: number, message: string) => void): Promise<ModelLoadResult>;
+    /**
+     * Load GLTF / GLB model from URL or ArrayBuffer
+     */
+    loadGLTF(source: string | ArrayBuffer, loadingManager?: THREE.LoadingManager, onProgress?: (percent: number, message: string) => void): Promise<ModelLoadResult>;
+    /**
+     * Load standalone GLB binary model from File, Blob, ArrayBuffer, or online URL
+     */
+    loadGLB(source: string | ArrayBuffer | Blob | File, onProgress?: (percent: number, message: string) => void): Promise<ModelLoadResult>;
     /**
      * Load model directly from OBJ and optional MTL URLs
      */
-    loadOBJ(objUrl: string, mtlUrl?: string, onProgress?: (percent: number, message: string) => void): Promise<ModelLoadResult>;
+    loadOBJ(objUrl: string, mtlUrl?: string, loadingManager?: THREE.LoadingManager, onProgress?: (percent: number, message: string) => void): Promise<ModelLoadResult>;
+    /**
+     * Intelligently load multiple user-selected files or drag-dropped files
+     * (Supports .zip, .glb, .gltf + companion .bin / textures, .obj + .mtl / textures)
+     */
+    loadFiles(fileList: FileList | File[], onProgress?: (percent: number, message: string) => void): Promise<ModelLoadResult>;
     /**
      * Post-process loaded model:
      * - Build BVH acceleration trees on all meshes
      * - Count vertices & faces
      * - Cache original materials and prepare clay/white-model materials
-     * - Calculate bounding box and center
+     * - Center model without breaking hierarchy/animations via a root group
      */
-    postProcessModel(group: THREE.Group): ModelLoadResult;
+    postProcessModel(group: THREE.Group, animations?: THREE.AnimationClip[], format?: 'obj' | 'gltf' | 'glb' | 'sample'): ModelLoadResult;
     /**
      * Internal helper to apply display style (solid/wireframe) to a managed mesh
      */
@@ -66,4 +115,8 @@ export declare class ModelLoader {
      * Clean up resources
      */
     cleanup(): void;
+    /**
+     * Complete destruction of loader and transcoders
+     */
+    destroy(): void;
 }

package/dist/loaders/ZipExtractor.d.ts

@@ -1,9 +1,12 @@
 import * as THREE from 'three';
 export interface ExtractedZipContent {
-    objContent: string | ArrayBuffer;
-    objFileName: string;
-    mtlContent: string | null;
-    mtlFileName: string | null;
+    format: 'obj' | 'gltf' | 'glb';
+    objContent?: string | ArrayBuffer;
+    objFileName?: string;
+    mtlContent?: string | null;
+    mtlFileName?: string | null;
+    gltfContent?: string | ArrayBuffer;
+    gltfFileName?: string;
     blobUrls: Map<string, string>;
     loadingManager: THREE.LoadingManager;
     dispose: () => void;

package/dist/types/index.d.ts

@@ -22,6 +22,8 @@ export interface ViewerOptions {
     showBoundingBox?: boolean;
     unit?: string;
     controlsType?: 'trackball' | 'orbit';
+    dracoDecoderPath?: string;
+    ktx2TranscoderPath?: string;
 }
 export interface ModelLoadResult {
     model: THREE.Group;
@@ -30,6 +32,8 @@ export interface ModelLoadResult {
     center: THREE.Vector3;
     vertexCount: number;
     faceCount: number;
+    animations?: THREE.AnimationClip[];
+    format?: 'obj' | 'gltf' | 'glb' | 'sample';
 }
 export interface MeasurementResult {
     id: string;
@@ -118,4 +122,8 @@ export type ViewerEvents = {
     'axislock:change': (lockedAxis: RotationLockAxis) => void;
     'style:change': (style: ModelDisplayStyle) => void;
     'pointsize:change'?: (size: number) => void;
+    'animation:play'?: (name: string) => void;
+    'animation:pause'?: () => void;
+    'animation:stop'?: () => void;
+    'animation:speed'?: (speed: number) => void;
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@giszhc/three-model-viewer",
-  "version": "1.0.0",
-  "description": "A modern, professional 3D model inspector and viewer SDK for Web applications. Features OBJ/MTL/ZIP loading, 3D measurements, dynamic dimensional bounding box, plane slicing, and high-res export.",
+  "version": "1.1.0",
+  "description": "A modern, professional 3D model inspector and viewer SDK for Web applications. Features GLTF/GLB/OBJ/ZIP loading, animation playback, 3D measurements, dynamic dimensional bounding box, plane slicing, and high-res export.",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -21,10 +21,18 @@
     "README.md",
     "LICENSE"
   ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
   "keywords": [
     "three",
     "threejs",
     "model-viewer",
+    "gltf",
+    "glb",
+    "draco",
+    "animation",
     "obj",
     "mtl",
     "zip",