@sage-rsc/talking-head-react 1.3.1 → 1.3.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sage-rsc/talking-head-react",
-  "version": "1.3.1",
+  "version": "1.3.3",
   "description": "A reusable React component for 3D talking avatars with lip-sync and text-to-speech",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -9,7 +9,8 @@
   "sideEffects": false,
   "files": [
     "dist",
-    "src"
+    "src",
+    "scripts"
   ],
   "exports": {
     ".": {

package/scripts/generate-animation-manifest.js

@@ -0,0 +1,73 @@
+#!/usr/bin/env node
+/**
+ * Generate animation manifest.json from directory structure
+ * 
+ * Usage: node scripts/generate-animation-manifest.js [animations-directory]
+ * 
+ * This script scans a directory for FBX files and generates a manifest.json
+ * that groups them by subdirectory or filename pattern.
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const animationsDir = process.argv[2] || './public/animations';
+const outputFile = path.join(animationsDir, 'manifest.json');
+
+function scanDirectory(dir) {
+  const groups = {};
+  
+  if (!fs.existsSync(dir)) {
+    console.error(`Directory does not exist: ${dir}`);
+    return groups;
+  }
+
+  const items = fs.readdirSync(dir, { withFileTypes: true });
+  
+  for (const item of items) {
+    const fullPath = path.join(dir, item.name);
+    
+    if (item.isDirectory()) {
+      // Scan subdirectory for FBX files
+      const subFiles = fs.readdirSync(fullPath)
+        .filter(file => file.toLowerCase().endsWith('.fbx'))
+        .map(file => `/animations/${item.name}/${file}`);
+      
+      if (subFiles.length > 0) {
+        groups[item.name] = subFiles;
+        console.log(`Found ${subFiles.length} animations in ${item.name}/`);
+      }
+    } else if (item.isFile() && item.name.toLowerCase().endsWith('.fbx')) {
+      // File in root directory - add to a default group or create one
+      const groupName = 'default';
+      if (!groups[groupName]) {
+        groups[groupName] = [];
+      }
+      groups[groupName].push(`/animations/${item.name}`);
+    }
+  }
+  
+  return groups;
+}
+
+// Generate manifest
+const groups = scanDirectory(animationsDir);
+
+const manifest = {
+  animations: groups,
+  generated: new Date().toISOString()
+};
+
+// Write manifest file
+fs.writeFileSync(outputFile, JSON.stringify(manifest, null, 2));
+
+console.log(`\n✅ Generated manifest.json at ${outputFile}`);
+console.log(`📦 Found ${Object.keys(groups).length} animation groups:`);
+Object.entries(groups).forEach(([group, files]) => {
+  console.log(`   - ${group}: ${files.length} animations`);
+});
+

package/scripts/identify-customizations.sh

@@ -0,0 +1,37 @@
+#!/bin/bash
+# Script to identify customizations in talkinghead.mjs
+
+echo "=== CUSTOMIZATIONS IN talkinghead.mjs ==="
+echo ""
+
+echo "1. Position Locking Methods:"
+echo "----------------------------"
+grep -n "lockAvatarPosition\|unlockAvatarPosition\|maintainLockedPosition" src/lib/talkinghead.mjs | head -20
+echo ""
+
+echo "2. Bone Mapping Code:"
+echo "---------------------"
+grep -n "mapBoneName\|Ready Player Me\|bone mapping\|FBX bone names" src/lib/talkinghead.mjs -i | head -20
+echo ""
+
+echo "3. Position Locking Integration:"
+echo "---------------------------------"
+grep -n "positionWasLocked\|lockAvatarPosition\|unlockAvatarPosition" src/lib/talkinghead.mjs | head -20
+echo ""
+
+echo "4. Custom Properties:"
+echo "---------------------"
+grep -n "this\.lockedPosition\|this\.originalPosition\|this\.positionWasLocked" src/lib/talkinghead.mjs | head -20
+echo ""
+
+echo "=== CUSTOM FILES ==="
+echo ""
+echo "React Components:"
+ls -1 src/components/*.jsx 2>/dev/null
+echo ""
+echo "Custom Config Files:"
+ls -1 src/config/*.js 2>/dev/null
+echo ""
+echo "Custom Loaders:"
+ls -1 src/lib/*FBX*.js 2>/dev/null
+