distark-render 1.0.0

package/dist/modules/mouthSystem.js

@@ -0,0 +1,277 @@
+/**
+ * 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.
+ */
+/**
+ * MouthSystem class - Manages mouth animation state
+ */
+export class MouthSystem {
+    /**
+     * 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, availableMouths = new Set(['closed', 'neutral']), config = {}) {
+        this.characterId = characterId;
+        this.availableMouths = availableMouths;
+        this.config = {
+            volumeThreshold: config.volumeThreshold ?? 10,
+            mouthChangeInterval: config.mouthChangeInterval ?? 120, // ms
+            talkingMouths: config.talkingMouths ?? MouthSystem.DEFAULT_TALKING_MOUTHS,
+            visemeMapping: config.visemeMapping ?? MouthSystem.DEFAULT_VISEME_MAPPING
+        };
+        this.state = {
+            currentMouthKey: 'neutral',
+            lastMouthChangeTime: 0,
+            currentVolume: 0,
+            mode: 'manual'
+        };
+    }
+    /**
+     * Get current mouth state
+     */
+    getState() {
+        return { ...this.state };
+    }
+    /**
+     * Get current mouth shape
+     */
+    getCurrentMouth() {
+        return this.state.currentMouthKey;
+    }
+    /**
+     * Manually set mouth shape
+     */
+    setMouthShape(shape) {
+        if (this.availableMouths.has(shape)) {
+            this.state.currentMouthKey = shape;
+            this.state.mode = 'manual';
+        }
+        else {
+            console.warn(`Mouth shape "${shape}" not available for character ${this.characterId}`);
+        }
+    }
+    /**
+     * Set available mouth shapes
+     */
+    setAvailableMouths(mouths) {
+        this.availableMouths = new Set(mouths);
+    }
+    /**
+     * Update mouth animation based on audio volume
+     * @param currentTime - Current time in milliseconds
+     * @param audioData - Audio analysis data
+     */
+    updateFromAudio(currentTime, audioData) {
+        this.state.mode = 'audio';
+        // Get audio volume from analyser
+        if (audioData.analyser && audioData.dataArray && audioData.audioElement && !audioData.audioElement.paused) {
+            audioData.analyser.getByteFrequencyData(audioData.dataArray);
+            // Calculate average volume
+            let sum = 0;
+            for (let i = 0; i < audioData.dataArray.length; i++) {
+                sum += audioData.dataArray[i];
+            }
+            const avgVolume = sum / audioData.dataArray.length;
+            this.state.currentVolume = avgVolume;
+            // Update mouth based on volume
+            if (avgVolume < (this.config.volumeThreshold ?? 10)) {
+                // Low volume: close mouth
+                this.state.currentMouthKey = this.availableMouths.has('neutral') ? 'neutral' : 'closed';
+            }
+            else {
+                // Speaking: change mouth shape periodically
+                const timeSinceLastChange = currentTime - this.state.lastMouthChangeTime;
+                if (timeSinceLastChange > (this.config.mouthChangeInterval ?? 120)) {
+                    // Filter available talking mouths
+                    const availableTalkingMouths = (this.config.talkingMouths ?? []).filter(mouth => this.availableMouths.has(mouth));
+                    if (availableTalkingMouths.length > 0) {
+                        const randomIndex = Math.floor(Math.random() * availableTalkingMouths.length);
+                        this.state.currentMouthKey = availableTalkingMouths[randomIndex];
+                    }
+                    else {
+                        // Fallback: use any available mouth except neutral/closed
+                        const fallbackMouths = Array.from(this.availableMouths).filter(m => m !== 'neutral' && m !== 'closed');
+                        if (fallbackMouths.length > 0) {
+                            const randomIndex = Math.floor(Math.random() * fallbackMouths.length);
+                            this.state.currentMouthKey = fallbackMouths[randomIndex];
+                        }
+                    }
+                    this.state.lastMouthChangeTime = currentTime;
+                }
+            }
+        }
+        else {
+            // No audio or paused: reset to neutral
+            this.state.currentVolume = 0;
+            this.state.currentMouthKey = this.availableMouths.has('neutral') ? 'neutral' : 'closed';
+        }
+    }
+    /**
+     * Update mouth animation based on viseme data
+     * @param viseme - Viseme identifier (e.g., 'A', 'E', 'O')
+     */
+    updateFromViseme(viseme) {
+        this.state.mode = 'viseme';
+        const mapping = this.config.visemeMapping ?? MouthSystem.DEFAULT_VISEME_MAPPING;
+        const mappedShape = mapping[viseme];
+        if (mappedShape && this.availableMouths.has(mappedShape)) {
+            this.state.currentMouthKey = mappedShape;
+        }
+        else {
+            // Fallback to closed if viseme not found
+            this.state.currentMouthKey = this.availableMouths.has('closed') ? 'closed' : 'neutral';
+        }
+    }
+    /**
+     * Reset mouth to neutral/closed state
+     */
+    reset() {
+        this.state.currentMouthKey = this.availableMouths.has('neutral') ? 'neutral' : 'closed';
+        this.state.currentVolume = 0;
+        this.state.lastMouthChangeTime = 0;
+        this.state.mode = 'manual';
+    }
+    /**
+     * 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() {
+        const currentMouth = this.state.currentMouthKey === 'neutral' ? 'closed' : this.state.currentMouthKey;
+        // Map mouth shape to possible image key variations
+        const keyMappings = {
+            'closed': ['mouth_closed', 'closed', 'neutral'],
+            'slightly-open': ['mouth_slightly_open', 'slightly-open', 'half-open'],
+            'half-open': ['mouth_half_open', 'half-open', 'slightly-open'],
+            'open': ['mouth_open', 'open'],
+            'wide-open': ['mouth_wide_open', 'wide-open'],
+            'ah': ['mouth_ah', 'ah'],
+            'ee': ['mouth_ee', 'ee'],
+            'woo': ['mouth_woo', 'woo'],
+            'ds': ['mouth_ds', 'ds'],
+            'neutral': ['mouth_closed', 'closed', 'neutral']
+        };
+        const candidates = keyMappings[currentMouth] || [currentMouth];
+        // Return the first candidate (renderRig will try all variants)
+        return candidates[0];
+    }
+    /**
+     * Get all possible image key candidates for current mouth
+     * Used by renderRig to try multiple image name variations
+     */
+    getMouthImageKeyCandidates() {
+        const currentMouth = this.state.currentMouthKey === 'neutral' ? 'closed' : this.state.currentMouthKey;
+        const keyMappings = {
+            'closed': ['mouth_closed', 'closed', 'neutral'],
+            'slightly-open': ['mouth_slightly_open', 'slightly-open', 'half-open'],
+            'half-open': ['mouth_half_open', 'half-open', 'slightly-open'],
+            'open': ['mouth_open', 'open'],
+            'wide-open': ['mouth_wide_open', 'wide-open'],
+            'ah': ['mouth_ah', 'ah'],
+            'ee': ['mouth_ee', 'ee'],
+            'woo': ['mouth_woo', 'woo'],
+            'ds': ['mouth_ds', 'ds'],
+            'neutral': ['mouth_closed', 'closed', 'neutral']
+        };
+        return keyMappings[currentMouth] || [currentMouth];
+    }
+    /**
+     * Get configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Update configuration
+     */
+    updateConfig(config) {
+        this.config = { ...this.config, ...config };
+    }
+    /**
+     * Get debug information
+     */
+    getDebugInfo() {
+        return `Mouth System [${this.characterId}]
+  Current: ${this.state.currentMouthKey}
+  Mode: ${this.state.mode}
+  Volume: ${this.state.currentVolume.toFixed(1)}
+  Available: [${Array.from(this.availableMouths).join(', ')}]`;
+    }
+}
+/**
+ * Default viseme to mouth shape mapping
+ */
+MouthSystem.DEFAULT_VISEME_MAPPING = {
+    'X': 'closed',
+    'A': 'open',
+    'B': 'closed',
+    'C': 'half-open',
+    'D': 'ds',
+    'E': 'ee',
+    'F': 'half-open',
+    'G': 'half-open',
+    'H': 'slightly-open',
+    'I': 'ee',
+    'J': 'slightly-open',
+    'K': 'half-open',
+    'L': 'slightly-open',
+    'M': 'closed',
+    'N': 'slightly-open',
+    'O': 'woo',
+    'P': 'closed',
+    'Q': 'woo',
+    'R': 'slightly-open',
+    'S': 'slightly-open',
+    'T': 'ds',
+    'U': 'woo',
+    'V': 'half-open',
+    'W': 'woo',
+    'Y': 'ee',
+    'Z': 'slightly-open'
+};
+/**
+ * Default talking mouths (used for random audio-based animation)
+ */
+MouthSystem.DEFAULT_TALKING_MOUTHS = [
+    'slightly-open',
+    'half-open',
+    'open',
+    'wide-open',
+    'ah',
+    'ee',
+    'woo'
+];
+/**
+ * Factory function to create mouth system
+ */
+export function createMouthSystem(characterId, availableMouths = ['closed', 'neutral'], config = {}) {
+    return new MouthSystem(characterId, new Set(availableMouths), config);
+}
+/**
+ * Helper: Extract available mouth shapes from rig data
+ */
+export function extractMouthShapesFromRigData(rigData) {
+    const mouths = [];
+    const mouthTypes = [
+        'closed', 'slightly-open', 'half-open', 'ds', 'open', 'ee', 'wide-open', 'ah', 'woo', 'neutral'
+    ];
+    if (rigData.imagePaths) {
+        for (const mouthType of mouthTypes) {
+            if (rigData.imagePaths[mouthType] || rigData.imagePaths[`mouth_${mouthType}`]) {
+                mouths.push(mouthType);
+            }
+        }
+    }
+    // Always include at least closed/neutral as fallback
+    if (mouths.length === 0) {
+        mouths.push('closed', 'neutral');
+    }
+    return mouths;
+}
+//# sourceMappingURL=mouthSystem.js.map

package/dist/modules/mouthSystem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mouthSystem.js","sourceRoot":"","sources":["../../modules/mouthSystem.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA0EH;;GAEG;AACH,MAAM,OAAO,WAAW;IAmDtB;;;;;OAKG;IACH,YACE,WAAmB,EACnB,kBAAmC,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,EACjE,SAAsB,EAAE;QAExB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QAEvC,IAAI,CAAC,MAAM,GAAG;YACZ,eAAe,EAAE,MAAM,CAAC,eAAe,IAAI,EAAE;YAC7C,mBAAmB,EAAE,MAAM,CAAC,mBAAmB,IAAI,GAAG,EAAE,KAAK;YAC7D,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,WAAW,CAAC,sBAAsB;YACzE,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,WAAW,CAAC,sBAAsB;SAC1E,CAAC;QAEF,IAAI,CAAC,KAAK,GAAG;YACX,eAAe,EAAE,SAAS;YAC1B,mBAAmB,EAAE,CAAC;YACtB,aAAa,EAAE,CAAC;YAChB,IAAI,EAAE,QAAQ;SACf,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,eAAe;QACb,OAAO,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,KAAiB;QAC7B,IAAI,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACpC,IAAI,CAAC,KAAK,CAAC,eAAe,GAAG,KAAK,CAAC;YACnC,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,QAAQ,CAAC;QAC7B,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,gBAAgB,KAAK,iCAAiC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QACzF,CAAC;IACH,CAAC;IAED;;OAEG;IACH,kBAAkB,CAAC,MAAoB;QACrC,IAAI,CAAC,eAAe,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;IAED;;;;OAIG;IACH,eAAe,CAAC,WAAmB,EAAE,SAA4B;QAC/D,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,OAAO,CAAC;QAE1B,iCAAiC;QACjC,IAAI,SAAS,CAAC,QAAQ,IAAI,SAAS,CAAC,SAAS,IAAI,SAAS,CAAC,YAAY,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;YAC1G,SAAS,CAAC,QAAQ,CAAC,oBAAoB,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;YAE7D,2BAA2B;YAC3B,IAAI,GAAG,GAAG,CAAC,CAAC;YACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACpD,GAAG,IAAI,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;YAChC,CAAC;YACD,MAAM,SAAS,GAAG,GAAG,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC;YACnD,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,SAAS,CAAC;YAErC,+BAA+B;YAC/B,IAAI,SAAS,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,IAAI,EAAE,CAAC,EAAE,CAAC;gBACpD,0BAA0B;gBAC1B,IAAI,CAAC,KAAK,CAAC,eAAe,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC;YAC1F,CAAC;iBAAM,CAAC;gBACN,4CAA4C;gBAC5C,MAAM,mBAAmB,GAAG,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC;gBAEzE,IAAI,mBAAmB,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,mBAAmB,IAAI,GAAG,CAAC,EAAE,CAAC;oBACnE,kCAAkC;oBAClC,MAAM,sBAAsB,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,MAAM,CACrE,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,CACzC,CAAC;oBAEF,IAAI,sBAAsB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACtC,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;wBAC9E,IAAI,CAAC,KAAK,CAAC,eAAe,GAAG,sBAAsB,CAAC,WAAW,CAAC,CAAC;oBACnE,CAAC;yBAAM,CAAC;wBACN,0DAA0D;wBAC1D,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,MAAM,CAC5D,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,QAAQ,CACvC,CAAC;wBACF,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;4BAC9B,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;4BACtE,IAAI,CAAC,KAAK,CAAC,eAAe,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;wBAC3D,CAAC;oBACH,CAAC;oBAED,IAAI,CAAC,KAAK,CAAC,mBAAmB,GAAG,WAAW,CAAC;gBAC/C,CAAC;YACH,CAAC;QACH,CAAC;aAAM,CAAC;YACN,uCAAuC;YACvC,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,CAAC,CAAC;YAC7B,IAAI,CAAC,KAAK,CAAC,eAAe,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC1F,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,gBAAgB,CAAC,MAAc;QAC7B,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,QAAQ,CAAC;QAE3B,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,IAAI,WAAW,CAAC,sBAAsB,CAAC;QAChF,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;QAEpC,IAAI,WAAW,IAAI,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;YACzD,IAAI,CAAC,KAAK,CAAC,eAAe,GAAG,WAAW,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,yCAAyC;YACzC,IAAI,CAAC,KAAK,CAAC,eAAe,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;QACzF,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,eAAe,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC;QACxF,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,CAAC,CAAC;QAC7B,IAAI,CAAC,KAAK,CAAC,mBAAmB,GAAG,CAAC,CAAC;QACnC,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,QAAQ,CAAC;IAC7B,CAAC;IAED;;;;;OAKG;IACH,uBAAuB;QACrB,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC;QAEtG,mDAAmD;QACnD,MAAM,WAAW,GAAiC;YAChD,QAAQ,EAAE,CAAC,cAAc,EAAE,QAAQ,EAAE,SAAS,CAAC;YAC/C,eAAe,EAAE,CAAC,qBAAqB,EAAE,eAAe,EAAE,WAAW,CAAC;YACtE,WAAW,EAAE,CAAC,iBAAiB,EAAE,WAAW,EAAE,eAAe,CAAC;YAC9D,MAAM,EAAE,CAAC,YAAY,EAAE,MAAM,CAAC;YAC9B,WAAW,EAAE,CAAC,iBAAiB,EAAE,WAAW,CAAC;YAC7C,IAAI,EAAE,CAAC,UAAU,EAAE,IAAI,CAAC;YACxB,IAAI,EAAE,CAAC,UAAU,EAAE,IAAI,CAAC;YACxB,KAAK,EAAE,CAAC,WAAW,EAAE,KAAK,CAAC;YAC3B,IAAI,EAAE,CAAC,UAAU,EAAE,IAAI,CAAC;YACxB,SAAS,EAAE,CAAC,cAAc,EAAE,QAAQ,EAAE,SAAS,CAAC;SACjD,CAAC;QAEF,MAAM,UAAU,GAAG,WAAW,CAAC,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAE/D,+DAA+D;QAC/D,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IAED;;;OAGG;IACH,0BAA0B;QACxB,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC;QAEtG,MAAM,WAAW,GAAiC;YAChD,QAAQ,EAAE,CAAC,cAAc,EAAE,QAAQ,EAAE,SAAS,CAAC;YAC/C,eAAe,EAAE,CAAC,qBAAqB,EAAE,eAAe,EAAE,WAAW,CAAC;YACtE,WAAW,EAAE,CAAC,iBAAiB,EAAE,WAAW,EAAE,eAAe,CAAC;YAC9D,MAAM,EAAE,CAAC,YAAY,EAAE,MAAM,CAAC;YAC9B,WAAW,EAAE,CAAC,iBAAiB,EAAE,WAAW,CAAC;YAC7C,IAAI,EAAE,CAAC,UAAU,EAAE,IAAI,CAAC;YACxB,IAAI,EAAE,CAAC,UAAU,EAAE,IAAI,CAAC;YACxB,KAAK,EAAE,CAAC,WAAW,EAAE,KAAK,CAAC;YAC3B,IAAI,EAAE,CAAC,UAAU,EAAE,IAAI,CAAC;YACxB,SAAS,EAAE,CAAC,cAAc,EAAE,QAAQ,EAAE,SAAS,CAAC;SACjD,CAAC;QAEF,OAAO,WAAW,CAAC,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACrD,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,MAA4B;QACvC,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO,iBAAiB,IAAI,CAAC,WAAW;aAC/B,IAAI,CAAC,KAAK,CAAC,eAAe;UAC7B,IAAI,CAAC,KAAK,CAAC,IAAI;YACb,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;gBAC/B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;IAC7D,CAAC;;AA5QD;;GAEG;AACqB,kCAAsB,GAA+B;IAC3E,GAAG,EAAE,QAAQ;IACb,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,QAAQ;IACb,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,eAAe;IACpB,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,eAAe;IACpB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,eAAe;IACpB,GAAG,EAAE,QAAQ;IACb,GAAG,EAAE,eAAe;IACpB,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,QAAQ;IACb,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,eAAe;IACpB,GAAG,EAAE,eAAe;IACpB,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,eAAe;CACrB,CAAC;AAEF;;GAEG;AACqB,kCAAsB,GAAiB;IAC7D,eAAe;IACf,WAAW;IACX,MAAM;IACN,WAAW;IACX,IAAI;IACJ,IAAI;IACJ,KAAK;CACN,CAAC;AAoOJ;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,WAAmB,EACnB,kBAAgC,CAAC,QAAQ,EAAE,SAAS,CAAC,EACrD,SAAsB,EAAE;IAExB,OAAO,IAAI,WAAW,CAAC,WAAW,EAAE,IAAI,GAAG,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC,CAAC;AACxE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,6BAA6B,CAAC,OAAY;IACxD,MAAM,MAAM,GAAiB,EAAE,CAAC;IAChC,MAAM,UAAU,GAAiB;QAC/B,QAAQ,EAAE,eAAe,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS;KAChG,CAAC;IAEF,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QACvB,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,IAAI,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,SAAS,SAAS,EAAE,CAAC,EAAE,CAAC;gBAC9E,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IAED,qDAAqD;IACrD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IACnC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/modules/renderRig.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Rendering-agnostic character rig data generator
+ * Computes all transforms and returns a data structure that can be used with any rendering library
+ */
+import { ImageLoader } from './imageLoad.js';
+import type { RigData, RenderOptions, RigRenderData, Position } from '../types.js';
+/**
+ * CharacterRigRenderer class - Handles character rig computation and rendering
+ */
+export declare class CharacterRigRenderer {
+    private imageLoader;
+    /**
+     * Creates a new CharacterRigRenderer instance
+     * @param imageLoader - Optional ImageLoader instance (creates a new one if not provided)
+     */
+    constructor(imageLoader?: ImageLoader);
+    /**
+     * Get the ImageLoader instance
+     * @returns The ImageLoader instance
+     */
+    getImageLoader(): ImageLoader;
+    /**
+     * Helper: apply parent transform to get world space position
+     */
+    private applyTransform;
+    /**
+     * Computes all character rig objects with their final transforms and properties
+     */
+    computeCharacterRigData(rigData: RigData, options?: RenderOptions): RigRenderData;
+    /**
+     * Universal Canvas renderer - handles both sync (with cache) and async (loads images)
+     *
+     * @param canvas - Canvas element to render to
+     * @param rigData - Character rig data
+     * @param loadedImages - Optional pre-loaded images. If not provided, will check cache or load from network
+     * @param cameraOffset - Camera offset for positioning
+     * @param showPivotPoints - Whether to show pivot points for debugging
+     * @returns Promise that resolves when rendering is complete
+     *
+     * @example
+     * // With pre-loaded images (fast, synchronous path)
+     * await renderer.render(canvas, rigData, myImages);
+     *
+     * @example
+     * // Without images - auto-loads if needed (async path)
+     * await renderer.render(canvas, rigData);
+     */
+    render(canvas: HTMLCanvasElement, rigData: RigData, loadedImages?: Record<string, HTMLImageElement | HTMLCanvasElement>, cameraOffset?: Position, showPivotPoints?: boolean): Promise<void>;
+}
+export declare const defaultRenderer: CharacterRigRenderer;
+export declare function renderCharacterRig(canvas: HTMLCanvasElement, rigData: RigData, loadedImages?: Record<string, HTMLImageElement | HTMLCanvasElement>, cameraOffset?: Position, showPivotPoints?: boolean): Promise<void>;
+export declare function computeCharacterRigData(rigData: RigData, options?: RenderOptions): RigRenderData;
+//# sourceMappingURL=renderRig.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"renderRig.d.ts","sourceRoot":"","sources":["../../modules/renderRig.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7C,OAAO,KAAK,EACR,OAAO,EACP,aAAa,EACb,aAAa,EAGb,QAAQ,EACX,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,qBAAa,oBAAoB;IAC7B,OAAO,CAAC,WAAW,CAAc;IAEjC;;;OAGG;gBACS,WAAW,CAAC,EAAE,WAAW;IAIrC;;;OAGG;IACH,cAAc,IAAI,WAAW;IAI7B;;OAEG;IACH,OAAO,CAAC,cAAc;IAYtB;;OAEG;IACH,uBAAuB,CACnB,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,aAAkB,GAC5B,aAAa;IAstChB;;;;;;;;;;;;;;;;;OAiBG;IACG,MAAM,CACR,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,OAAO,EAChB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,iBAAiB,CAAC,EACnE,YAAY,GAAE,QAAyB,EACvC,eAAe,GAAE,OAAc,GAChC,OAAO,CAAC,IAAI,CAAC;CA8EnB;AAGD,eAAO,MAAM,eAAe,sBAA6B,CAAC;AAG1D,wBAAsB,kBAAkB,CACpC,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,OAAO,EAChB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,iBAAiB,CAAC,EACnE,YAAY,GAAE,QAAyB,EACvC,eAAe,GAAE,OAAc,GAChC,OAAO,CAAC,IAAI,CAAC,CAEf;AAGD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,GAAE,aAAkB,GAAG,aAAa,CAEpG"}