@stowkit/three-loader 0.1.35 → 0.1.39

package/dist/StowKitPack.d.ts

@@ -101,6 +101,10 @@ export declare class StowKitPack {
         action: THREE.AnimationAction;
         clip: THREE.AnimationClip;
     }>;
+    /**
+     * Retarget animation clip to match skeleton bone names
+     */
+    private retargetAnimationClip;
     /**
      * Load animation clip by index
      */

package/dist/StowKitPack.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StowKitPack.d.ts","sourceRoot":"","sources":["../src/StowKitPack.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,0CAA0C,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAC;AACxE,OAAO,EAAE,aAAa,EAAc,MAAM,iBAAiB,CAAC;AAI5D;;GAEG;AACH,qBAAa,WAAW;IACb,MAAM,EAAE,aAAa,CAAC;IAC7B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,YAAY,CAA4D;IAChF,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,GAAE,MAAW,EAAE,WAAW,GAAE,MAAW;IAQnI;;OAEG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;IAsB7D;;OAEG;YACW,gBAAgB;IA4U9B;;OAEG;IACG,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;IAoCvD;;OAEG;IACG,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC;IA4BtE;;OAEG;IACG,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;IA0BvF;;OAEG;IACH,UAAU;IAIV;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG;IAIhC;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAI/C;;OAEG;IACH,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAKnD;;OAEG;IACG,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;IAUjE;;OAEG;IACG,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;IAY1D;;OAEG;IACG,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC;IAMzE;;OAEG;IACG,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAiBlE;;OAEG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM;IAMlC;;OAEG;IACH,oBAAoB,CAAC,KAAK,EAAE,MAAM;IAIlC;;OAEG;IACH,kBAAkB,CAAC,KAAK,EAAE,MAAM;IAKhC;;OAEG;IACG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC;IAQvE;;OAEG;IACG,aAAa,CACf,gBAAgB,EAAE,KAAK,CAAC,KAAK,EAC7B,aAAa,EAAE,MAAM,GACtB,OAAO,CAAC;QAAE,KAAK,EAAE,KAAK,CAAC,cAAc,CAAC;QAAC,MAAM,EAAE,KAAK,CAAC,eAAe,CAAC;QAAC,IAAI,EAAE,KAAK,CAAC,aAAa,CAAA;KAAE,CAAC;IAUrG;;OAEG;IACG,oBAAoB,CACtB,gBAAgB,EAAE,KAAK,CAAC,KAAK,EAC7B,cAAc,EAAE,MAAM,GACvB,OAAO,CAAC;QAAE,KAAK,EAAE,KAAK,CAAC,cAAc,CAAC;QAAC,MAAM,EAAE,KAAK,CAAC,eAAe,CAAC;QAAC,IAAI,EAAE,KAAK,CAAC,aAAa,CAAA;KAAE,CAAC;IAUrG;;OAEG;IACG,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC;IAW3E;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA+H1B;;OAEG;IACH,OAAO,CAAC,cAAc;IAQtB;;OAEG;IACH,OAAO,IAAI,IAAI;YAMD,oBAAoB;YA0DpB,eAAe;IA6E7B,OAAO,CAAC,sBAAsB;IAwB9B,OAAO,CAAC,iBAAiB;CAM5B"}
+{"version":3,"file":"StowKitPack.d.ts","sourceRoot":"","sources":["../src/StowKitPack.ts"],"names":[],"mappings":"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"}

package/dist/stowkit-three-loader.esm.js

@@ -590,11 +590,19 @@ class StowKitPack {
             materialData.push({ name, schemaId, propertyCount, properties: [] });
             metadataOffset += 196;
         }
-        // Skip Node array and node_mesh_indices (not needed for rendering)
-        // Node struct: transform[16 floats] + name[64 bytes] + mesh_index[4 bytes] + parent_index[4 bytes] = 116 bytes
+        // Parse Node array to calculate total mesh indices
+        // Node struct: name[64] + parent_index[4] + position[12] + rotation[16] + scale[12] + mesh_count[4] + first_mesh_index[4] = 116 bytes
         const NODE_STRIDE = 116;
+        let totalMeshIndices = 0;
+        for (let n = 0; n < nodeCount; n++) {
+            const nodeOffset = metadataOffset + n * NODE_STRIDE;
+            // mesh_count is at offset 64 + 4 + 12 + 16 + 12 = 108 within Node struct
+            const meshCount = metaView.getUint32(nodeOffset + 108, true);
+            totalMeshIndices += meshCount;
+        }
         metadataOffset += nodeCount * NODE_STRIDE;
-        metadataOffset += nodeCount * 4;
+        // Skip node_mesh_indices array (totalMeshIndices entries, not nodeCount!)
+        metadataOffset += totalMeshIndices * 4;
         // Parse material properties
         const PROPERTY_STRIDE = 144;
         for (let i = 0; i < materialCount; i++) {
@@ -672,7 +680,8 @@ class StowKitPack {
             const bone = bones[i];
             const bindPose = bindPoses[i];
             const parentIndex = parentIndices[i];
-            if (parentIndex < 0) {
+            if (parentIndex < 0 || parentIndex >= bindPoses.length) {
+                // Root bone or invalid parent - use bind pose directly
                 const pos = new THREE.Vector3();
                 const quat = new THREE.Quaternion();
                 const scale = new THREE.Vector3();
@@ -702,7 +711,9 @@ class StowKitPack {
             const material = new THREE.MeshStandardMaterial({
                 side: THREE.DoubleSide,
                 name: mat.name || `Material_${i}`,
-                color: new THREE.Color(0.8, 0.8, 0.8) // Default gray
+                color: new THREE.Color(0.8, 0.8, 0.8), // Default gray
+                metalness: 0.5,
+                roughness: 0.5
             });
             // Apply non-texture properties
             for (const prop of mat.properties) {
@@ -769,6 +780,8 @@ class StowKitPack {
         skinnedMesh.bind(skeleton, skinnedMesh.matrixWorld);
         skinnedMesh.normalizeSkinWeights();
         skinnedMesh.updateMatrixWorld(true);
+        // Ensure frustum culling doesn't hide the mesh if bounds are wrong
+        skinnedMesh.frustumCulled = false;
         const container = new THREE.Group();
         container.name = stringId || 'SkinnedMesh';
         container.add(boneContainer);
@@ -975,22 +988,99 @@ class StowKitPack {
      */
     async loadAnimation(skinnedMeshGroup, animationPath) {
         const clip = await this.loadAnimationClip(animationPath);
+        const retargetedClip = this.retargetAnimationClip(clip, skinnedMeshGroup);
         const mixer = new THREE.AnimationMixer(skinnedMeshGroup);
-        const action = mixer.clipAction(clip);
+        const action = mixer.clipAction(retargetedClip);
         action.setLoop(THREE.LoopRepeat, Infinity);
         action.play();
-        return { mixer, action, clip };
+        return { mixer, action, clip: retargetedClip };
     }
     /**
      * Load and play animation by index
      */
     async loadAnimationByIndex(skinnedMeshGroup, animationIndex) {
         const clip = await this.loadAnimationClipByIndex(animationIndex);
+        const retargetedClip = this.retargetAnimationClip(clip, skinnedMeshGroup);
         const mixer = new THREE.AnimationMixer(skinnedMeshGroup);
-        const action = mixer.clipAction(clip);
+        const action = mixer.clipAction(retargetedClip);
         action.setLoop(THREE.LoopRepeat, Infinity);
         action.play();
-        return { mixer, action, clip };
+        return { mixer, action, clip: retargetedClip };
+    }
+    /**
+     * Retarget animation clip to match skeleton bone names
+     */
+    retargetAnimationClip(clip, skinnedMeshGroup) {
+        // Collect all bone names from the skeleton
+        const skeletonBoneNames = new Set();
+        skinnedMeshGroup.traverse((child) => {
+            if (child.isBone) {
+                skeletonBoneNames.add(child.name);
+            }
+        });
+        // Build a mapping from animation bone names to skeleton bone names
+        // Try to match by suffix (e.g., "CharacterRig_MainHipJ" -> "MainHipJ")
+        const boneNameMap = new Map();
+        for (const track of clip.tracks) {
+            const trackParts = track.name.split('.');
+            const animBoneName = trackParts[0];
+            if (skeletonBoneNames.has(animBoneName)) {
+                // Exact match - no remapping needed
+                continue;
+            }
+            // Try to find a match by suffix
+            for (const skelBoneName of skeletonBoneNames) {
+                // Check if animation bone name ends with skeleton bone name
+                // e.g., "CharacterRig_MainHipJ" contains "MainHipJ"
+                if (animBoneName.endsWith(skelBoneName) ||
+                    animBoneName.endsWith('_' + skelBoneName) ||
+                    skelBoneName.endsWith(animBoneName) ||
+                    skelBoneName.endsWith('_' + animBoneName)) {
+                    boneNameMap.set(animBoneName, skelBoneName);
+                    break;
+                }
+                // Also try matching without common prefixes
+                const animSuffix = animBoneName.replace(/^.*_/, '');
+                const skelSuffix = skelBoneName.replace(/^.*_/, '');
+                if (animSuffix === skelSuffix && animSuffix.length > 2) {
+                    boneNameMap.set(animBoneName, skelBoneName);
+                    break;
+                }
+            }
+        }
+        // If no remapping needed, return original clip
+        if (boneNameMap.size === 0) {
+            return clip;
+        }
+        console.log(`[StowKit] Retargeting animation: ${boneNameMap.size} bones remapped`);
+        // Create new tracks with remapped names
+        const newTracks = [];
+        for (const track of clip.tracks) {
+            const trackParts = track.name.split('.');
+            const animBoneName = trackParts[0];
+            const property = trackParts.slice(1).join('.');
+            const mappedBoneName = boneNameMap.get(animBoneName) || animBoneName;
+            const newTrackName = `${mappedBoneName}.${property}`;
+            // Clone the track with the new name
+            // Use generic KeyframeTrack constructor to avoid type issues with specific track types
+            const times = track.times;
+            const values = track.values;
+            let newTrack;
+            if (track instanceof THREE.VectorKeyframeTrack) {
+                newTrack = new THREE.VectorKeyframeTrack(newTrackName, times, values);
+            }
+            else if (track instanceof THREE.QuaternionKeyframeTrack) {
+                newTrack = new THREE.QuaternionKeyframeTrack(newTrackName, times, values);
+            }
+            else if (track instanceof THREE.NumberKeyframeTrack) {
+                newTrack = new THREE.NumberKeyframeTrack(newTrackName, times, values);
+            }
+            else {
+                newTrack = new THREE.KeyframeTrack(newTrackName, times, values);
+            }
+            newTracks.push(newTrack);
+        }
+        return new THREE.AnimationClip(clip.name, clip.duration, newTracks);
     }
     /**
      * Load animation clip by index
@@ -1172,6 +1262,8 @@ class StowKitPack {
             URL.revokeObjectURL(url);
             PerfLogger.log(`[Perf] ✓ Texture "${textureName}": 0ms (IndexedDB cache)`);
             const texture = new THREE.CompressedTexture([{ data: cached.data, width: cached.width, height: cached.height }], cached.width, cached.height, cached.format, THREE.UnsignedByteType);
+            // All textures default to sRGB. Data textures are set to linear in applyTextureToMaterial.
+            texture.colorSpace = THREE.SRGBColorSpace;
             texture.needsUpdate = true;
             return texture;
         }
@@ -1179,6 +1271,9 @@ class StowKitPack {
             const texture = await new Promise((resolve, reject) => {
                 this.ktx2Loader.load(url, (texture) => {
                     URL.revokeObjectURL(url);
+                    // All textures default to sRGB. Data textures (normal, metallic, roughness)
+                    // are set back to linear in applyTextureToMaterial.
+                    texture.colorSpace = THREE.SRGBColorSpace;
                     texture.needsUpdate = true;
                     resolve(texture);
                 }, undefined, (error) => {
@@ -1212,18 +1307,26 @@ class StowKitPack {
         const propNameLower = propertyName.toLowerCase();
         if (propNameLower === 'maintex' || propNameLower.includes('diffuse') ||
             propNameLower.includes('albedo') || propNameLower.includes('base')) {
+            // Color texture - keep sRGB (default)
             material.map = texture;
         }
         else if (propNameLower.includes('normal')) {
+            // Data texture - use linear
+            texture.colorSpace = THREE.LinearSRGBColorSpace;
             material.normalMap = texture;
         }
         else if (propNameLower.includes('metallic')) {
+            // Data texture - use linear
+            texture.colorSpace = THREE.LinearSRGBColorSpace;
             material.metalnessMap = texture;
         }
         else if (propNameLower.includes('roughness')) {
+            // Data texture - use linear
+            texture.colorSpace = THREE.LinearSRGBColorSpace;
             material.roughnessMap = texture;
         }
         else {
+            // Default to color texture - keep sRGB
             material.map = texture;
         }
         material.needsUpdate = true;