distark-render 1.0.0

package/dist/modules/imageLoad.js

@@ -0,0 +1,259 @@
+/**
+ * Image Loading Module
+ * Handles loading images from MD5 hashes or URLs with caching support
+ */
+/**
+ * ImageLoader class - Handles loading and caching images for character rigs
+ */
+export class ImageLoader {
+    /**
+     * Creates a new ImageLoader instance
+     * @param baseHost - The base URL for the API (default: 'https://orchestrator.distark.com')
+     */
+    constructor(baseHost = 'https://orchestrator.distark.com') {
+        this.baseHost = baseHost;
+        this.imageCache = new Map();
+    }
+    /**
+     * Set the base host for image loading
+     * @param host - The base URL for the API
+     */
+    setBaseHost(host) {
+        this.baseHost = host;
+    }
+    /**
+     * Get the current base host
+     * @returns The current base host URL
+     */
+    getBaseHost() {
+        return this.baseHost;
+    }
+    /**
+     * Resolve an image source (hash or URL) to a full URL
+     * @param imageData - Image hash, URL, or data URL
+     * @returns Full URL or null if invalid
+     */
+    resolveImageSource(imageData) {
+        if (!imageData || typeof imageData !== 'string') {
+            return null;
+        }
+        // Check if it's an MD5 hash (32-character hex string)
+        const md5Regex = /^[a-f0-9]{32}$/i;
+        if (md5Regex.test(imageData)) {
+            return `${this.baseHost}/api/v1/artifacts/${imageData}`;
+        }
+        // Check if it's a truncated hash (ends with ...)
+        const truncatedHashRegex = /^[a-f0-9]{20,31}\.{3}$/i;
+        if (truncatedHashRegex.test(imageData)) {
+            const hash = imageData.replace(/\.{3}$/, '');
+            console.warn(`Truncated hash detected for ${imageData}, attempting to load with partial hash`);
+            return `${this.baseHost}/api/v1/artifacts/${hash}`;
+        }
+        // Return as-is for URLs and data URLs
+        if (imageData.startsWith('http://') ||
+            imageData.startsWith('https://') ||
+            imageData.startsWith('data:')) {
+            return imageData;
+        }
+        return null;
+    }
+    /**
+     * Load an image from a URL/hash and invoke callbacks
+     * @param key - Unique key for the image
+     * @param imageData - Image hash or URL
+     * @param onLoad - Callback when image loads successfully
+     * @param onError - Callback when image fails to load (optional)
+     */
+    loadImage(key, imageData, onLoad, onError) {
+        const imageUrl = this.resolveImageSource(imageData);
+        if (!imageUrl) {
+            console.warn(`Could not resolve image source for ${key}: ${imageData}`);
+            if (onError) {
+                onError(key, 'Invalid image source');
+            }
+            return;
+        }
+        console.log(`📥 Loading image for ${key} from: ${imageUrl.substring(0, 100)}...`);
+        const img = new Image();
+        img.crossOrigin = 'anonymous'; // Enable CORS
+        img.onload = () => {
+            console.log(`✓ Successfully loaded image for ${key} (${img.width}x${img.height})`);
+            if (onLoad) {
+                onLoad(key, img);
+            }
+        };
+        img.onerror = (err) => {
+            console.error(`✗ Failed to load image for ${key}`);
+            console.error(`   URL: ${imageUrl}`);
+            console.error(`   Error:`, err);
+            if (onError) {
+                onError(key, err);
+            }
+        };
+        img.src = imageUrl;
+    }
+    /**
+     * Load multiple images in parallel
+     * @param imagesToLoad - Array of {key, hash} objects
+     * @param onProgress - Optional callback for progress updates
+     * @returns Promise that resolves with loaded images map
+     */
+    async loadImages(imagesToLoad, onProgress) {
+        const loadedImages = {};
+        let loaded = 0;
+        let failed = 0;
+        const total = imagesToLoad.length;
+        const loadPromises = imagesToLoad.map(({ key, hash }) => {
+            return new Promise((resolve) => {
+                this.loadImage(key, hash, (loadedKey, img) => {
+                    loadedImages[loadedKey] = img;
+                    loaded++;
+                    if (onProgress) {
+                        onProgress(loaded, total, failed);
+                    }
+                    resolve();
+                }, () => {
+                    failed++;
+                    if (onProgress) {
+                        onProgress(loaded, total, failed);
+                    }
+                    resolve();
+                });
+            });
+        });
+        await Promise.all(loadPromises);
+        return loadedImages;
+    }
+    /**
+     * Get the image cache
+     * @returns The image cache Map
+     */
+    getImageCache() {
+        return this.imageCache;
+    }
+    /**
+     * Clear the image cache
+     */
+    clearImageCache() {
+        this.imageCache.clear();
+        console.log('🗑️ Image cache cleared');
+    }
+    /**
+     * Get image from cache or return undefined
+     * @param key - Image key
+     */
+    getCachedImage(key) {
+        return this.imageCache.get(key);
+    }
+    /**
+     * Manually add image to cache
+     * @param key - Image key
+     * @param image - Image element
+     */
+    cacheImage(key, image) {
+        this.imageCache.set(key, image);
+    }
+    /**
+     * Load image with caching support
+     * Checks cache first, only loads if not cached
+     */
+    loadImageWithCache(key, imageData, onLoad, onError) {
+        // Check cache first
+        const cached = this.imageCache.get(key);
+        if (cached) {
+            console.log(`✓ Using cached image for ${key}`);
+            if (onLoad) {
+                onLoad(key, cached);
+            }
+            return;
+        }
+        // Not in cache, load it
+        this.loadImage(key, imageData, (loadedKey, img) => {
+            // Add to cache
+            this.imageCache.set(loadedKey, img);
+            console.log(`💾 Cached image for ${loadedKey}`);
+            if (onLoad) {
+                onLoad(loadedKey, img);
+            }
+        }, onError);
+    }
+    /**
+     * Load all images for a character rig and populate the cache
+     * @param rigData - Character rig data
+     * @param useCache - Whether to use existing cache (default: true)
+     * @param onProgress - Progress callback
+     * @returns Promise that resolves with the image cache as a plain object
+     */
+    async loadAllRigImages(rigData, useCache = true, onProgress) {
+        const imagesToLoad = [];
+        // Collect all image paths from imagePaths
+        if (rigData.imagePaths) {
+            for (const [key, hash] of Object.entries(rigData.imagePaths)) {
+                if (hash && typeof hash === 'string' && !hash.includes('[MEDIA_REMOVED]')) {
+                    const imageKey = `imagePaths.${key}`;
+                    // Skip if already in cache and useCache is true
+                    if (!useCache || !this.imageCache.has(imageKey)) {
+                        imagesToLoad.push({ key: imageKey, hash });
+                    }
+                }
+            }
+        }
+        // Collect all eye images
+        if (rigData.eyes) {
+            for (const [key, value] of Object.entries(rigData.eyes)) {
+                if (typeof value === 'string' && !value.includes('[MEDIA_REMOVED]') &&
+                    (key.includes('Image') || key.includes('Iris') || key.includes('Lid'))) {
+                    const imageKey = `eyes.${key}`;
+                    // Skip if already in cache and useCache is true
+                    if (!useCache || !this.imageCache.has(imageKey)) {
+                        imagesToLoad.push({ key: imageKey, hash: value });
+                    }
+                }
+            }
+        }
+        console.log(`📦 Loading ${imagesToLoad.length} images for character rig...`);
+        let loaded = 0;
+        let failed = 0;
+        const total = imagesToLoad.length;
+        // If nothing to load, return cache immediately
+        if (total === 0) {
+            console.log('✓ All images already cached!');
+            const result = {};
+            this.imageCache.forEach((img, key) => {
+                result[key] = img;
+            });
+            console.log('📦 Image Cache:', result);
+            return result;
+        }
+        const loadPromises = imagesToLoad.map(({ key, hash }) => {
+            return new Promise((resolve) => {
+                this.loadImage(key, hash, (loadedKey, img) => {
+                    this.imageCache.set(loadedKey, img);
+                    loaded++;
+                    if (onProgress) {
+                        onProgress(loaded, total, failed);
+                    }
+                    resolve();
+                }, () => {
+                    failed++;
+                    if (onProgress) {
+                        onProgress(loaded, total, failed);
+                    }
+                    resolve();
+                });
+            });
+        });
+        await Promise.all(loadPromises);
+        console.log(`✓ Loaded ${loaded}/${total} images (${failed} failed)`);
+        // Return cache as plain object
+        const result = {};
+        this.imageCache.forEach((img, key) => {
+            result[key] = img;
+        });
+        console.log('📦 Image Cache:', result);
+        return result;
+    }
+}
+// Export a default instance for backwards compatibility
+export const defaultImageLoader = new ImageLoader();
+//# sourceMappingURL=imageLoad.js.map

package/dist/modules/imageLoad.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imageLoad.js","sourceRoot":"","sources":["../../modules/imageLoad.ts"],"names":[],"mappings":"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"}

package/dist/modules/mouthSystem.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Mouth System Module
+ * Handles mouth animation based on audio volume, visemes, or manual control
+ *
+ * Note: This module does NOT handle rendering - it only manages state.
+ * The renderRig module handles actual rendering of mouth images.
+ */
+/**
+ * Mouth shape types (viseme-based and general shapes)
+ */
+export type MouthShape = 'closed' | 'slightly-open' | 'half-open' | 'ds' | 'open' | 'ee' | 'wide-open' | 'ah' | 'woo' | 'neutral';
+/**
+ * Audio analysis data structure
+ */
+export interface AudioAnalysisData {
+    analyser: AnalyserNode;
+    dataArray: Uint8Array<ArrayBuffer>;
+    audioElement: HTMLAudioElement;
+}
+/**
+ * Viseme mapping data (phoneme to mouth shape)
+ */
+export interface VisemeData {
+    viseme: string;
+    timestamp: number;
+}
+/**
+ * Mouth animation mode
+ */
+export type MouthAnimationMode = 'manual' | 'audio' | 'viseme';
+/**
+ * Mouth data configuration
+ */
+export interface MouthData {
+    mouthWidth?: number;
+    mouthHeight?: number;
+    mouthSize?: number;
+    mouthXCoor?: number;
+    mouthYCoor?: number;
+    [key: string]: number | undefined;
+}
+/**
+ * Mouth state
+ */
+export interface MouthState {
+    currentMouthKey: MouthShape;
+    lastMouthChangeTime: number;
+    currentVolume: number;
+    mode: MouthAnimationMode;
+}
+/**
+ * Mouth configuration
+ */
+export interface MouthConfig {
+    volumeThreshold?: number;
+    mouthChangeInterval?: number;
+    talkingMouths?: MouthShape[];
+    visemeMapping?: Record<string, MouthShape>;
+}
+/**
+ * MouthSystem class - Manages mouth animation state
+ */
+export declare class MouthSystem {
+    private state;
+    private config;
+    private characterId;
+    private availableMouths;
+    /**
+     * Default viseme to mouth shape mapping
+     */
+    private static readonly DEFAULT_VISEME_MAPPING;
+    /**
+     * Default talking mouths (used for random audio-based animation)
+     */
+    private static readonly DEFAULT_TALKING_MOUTHS;
+    /**
+     * Creates a new MouthSystem instance
+     * @param characterId - Unique identifier for the character
+     * @param availableMouths - Set of available mouth shapes for this character
+     * @param config - Optional mouth configuration
+     */
+    constructor(characterId: string, availableMouths?: Set<MouthShape>, config?: MouthConfig);
+    /**
+     * Get current mouth state
+     */
+    getState(): MouthState;
+    /**
+     * Get current mouth shape
+     */
+    getCurrentMouth(): MouthShape;
+    /**
+     * Manually set mouth shape
+     */
+    setMouthShape(shape: MouthShape): void;
+    /**
+     * Set available mouth shapes
+     */
+    setAvailableMouths(mouths: MouthShape[]): void;
+    /**
+     * Update mouth animation based on audio volume
+     * @param currentTime - Current time in milliseconds
+     * @param audioData - Audio analysis data
+     */
+    updateFromAudio(currentTime: number, audioData: AudioAnalysisData): void;
+    /**
+     * Update mouth animation based on viseme data
+     * @param viseme - Viseme identifier (e.g., 'A', 'E', 'O')
+     */
+    updateFromViseme(viseme: string): void;
+    /**
+     * Reset mouth to neutral/closed state
+     */
+    reset(): void;
+    /**
+     * Get the image key for the current mouth shape
+     * This is used by renderRig to determine which image to render
+     *
+     * @returns The image key for the current mouth (e.g., 'imagePaths.mouth_open')
+     */
+    getCurrentMouthImageKey(): string;
+    /**
+     * Get all possible image key candidates for current mouth
+     * Used by renderRig to try multiple image name variations
+     */
+    getMouthImageKeyCandidates(): string[];
+    /**
+     * Get configuration
+     */
+    getConfig(): MouthConfig;
+    /**
+     * Update configuration
+     */
+    updateConfig(config: Partial<MouthConfig>): void;
+    /**
+     * Get debug information
+     */
+    getDebugInfo(): string;
+}
+/**
+ * Factory function to create mouth system
+ */
+export declare function createMouthSystem(characterId: string, availableMouths?: MouthShape[], config?: MouthConfig): MouthSystem;
+/**
+ * Helper: Extract available mouth shapes from rig data
+ */
+export declare function extractMouthShapesFromRigData(rigData: any): MouthShape[];
+//# sourceMappingURL=mouthSystem.d.ts.map

package/dist/modules/mouthSystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mouthSystem.d.ts","sourceRoot":"","sources":["../../modules/mouthSystem.ts"],"names":[],"mappings":"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"}