distark-render 1.0.4 → 1.0.6

package/dist/modules/animationDiff.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Animation Diff Utility
+ *
+ * Converts animation frames from full-state to diff-based format to reduce file size.
+ * Instead of storing complete frame data for each frame, only stores changes from the previous frame.
+ *
+ * Format (compact array):
+ * [
+ *   { ...complete first frame data... },           // Index 0: Base frame (full data)
+ *   { rotationValues: { head: 0.5 }, ... },        // Index 1: Only changed values
+ *   { selfRotationValues: { leftArm: 0.2 } },      // Index 2: Only changed values
+ *   ...
+ * ]
+ *
+ * Also supports legacy verbose format:
+ * {
+ *   version: "1.0",
+ *   baseFrame: { ...complete first frame data... },
+ *   diffs: [null, {...}, {...}, ...]
+ * }
+ */
+import type { RigData } from '../types.js';
+/**
+ * Frame data type - can be complete RigData or partial diff
+ */
+export type FrameData = Partial<RigData>;
+/**
+ * Diff-based animation format (compact array)
+ */
+export type DiffBasedAnimation = FrameData[];
+/**
+ * Legacy verbose format
+ */
+export interface VerboseDiffAnimation {
+    version: string;
+    baseFrame: FrameData;
+    diffs: (FrameData | null)[];
+}
+/**
+ * Animation data that can be in either format
+ */
+export type AnimationData = DiffBasedAnimation | VerboseDiffAnimation;
+/**
+ * Compression statistics
+ */
+export interface CompressionStats {
+    originalSize: number;
+    compressedSize: number;
+    savedBytes: number;
+    compressionRatio: string;
+}
+/**
+ * Convert full-state animation frames to diff-based format
+ * @param frames - Array of complete frame objects
+ * @returns Diff-based animation array [baseFrame, diff1, diff2, ...]
+ */
+export declare const createDiffBasedAnimation: (frames: FrameData[]) => DiffBasedAnimation;
+/**
+ * Convert diff-based animation back to full-state frames
+ * Supports both formats:
+ * - New format: [baseFrame, diff1, diff2, ...]
+ * - Old format: { baseFrame, diffs: [...] }
+ * @param diffBasedAnimation - Diff-based animation
+ * @returns Array of complete frame objects
+ */
+export declare const expandDiffBasedAnimation: (diffBasedAnimation: AnimationData) => FrameData[];
+/**
+ * Calculate compression ratio
+ * @param originalFrames - Original full-state frames
+ * @param diffBasedAnimation - Diff-based animation
+ * @returns Statistics about compression
+ */
+export declare const calculateCompressionStats: (originalFrames: FrameData[], diffBasedAnimation: DiffBasedAnimation) => CompressionStats;
+/**
+ * Validate that a diff-based animation can be properly expanded
+ * Supports both new array format and old object format
+ * @param diffBasedAnimation - Diff-based animation to validate
+ * @returns True if valid
+ */
+export declare const validateDiffBasedAnimation: (diffBasedAnimation: AnimationData) => boolean;
+/**
+ * Helper to check if animation data is in diff format
+ * Detects both new array format and old object format
+ * @param animationData - Animation data to check
+ * @returns True if in diff format
+ */
+export declare const isDiffBasedFormat: (animationData: any) => animationData is AnimationData;
+/**
+ * Smart loader that handles both formats
+ * @param animationData - Animation data in either format
+ * @returns Full-state frames array
+ */
+export declare const loadAnimation: (animationData: any) => FrameData[];
+/**
+ * Export animation in diff format with optional compression stats
+ * @param frames - Full-state frames
+ * @param showStats - Whether to log compression stats
+ * @returns Diff-based animation
+ */
+export declare const exportDiffAnimation: (frames: FrameData[], showStats?: boolean) => DiffBasedAnimation;
+//# sourceMappingURL=animationDiff.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"animationDiff.d.ts","sourceRoot":"","sources":["../../modules/animationDiff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAEzC;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,SAAS,EAAE,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,SAAS,CAAC;IACrB,KAAK,EAAE,CAAC,SAAS,GAAG,IAAI,CAAC,EAAE,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,kBAAkB,GAAG,oBAAoB,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;CAC5B;AA6FD;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,GAAI,QAAQ,SAAS,EAAE,KAAG,kBAiB9D,CAAC;AA+BF;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,GAAI,oBAAoB,aAAa,KAAG,SAAS,EAyCrF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,GAClC,gBAAgB,SAAS,EAAE,EAC3B,oBAAoB,kBAAkB,KACvC,gBAWF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,GAAI,oBAAoB,aAAa,KAAG,OAmB9E,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,eAAe,GAAG,KAAG,aAAa,IAAI,aAgDvE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,eAAe,GAAG,KAAG,SAAS,EAiB3D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,QAAQ,SAAS,EAAE,EAAE,YAAW,OAAc,KAAG,kBASpF,CAAC"}

package/dist/modules/animationDiff.js

@@ -0,0 +1,327 @@
+/**
+ * Animation Diff Utility
+ *
+ * Converts animation frames from full-state to diff-based format to reduce file size.
+ * Instead of storing complete frame data for each frame, only stores changes from the previous frame.
+ *
+ * Format (compact array):
+ * [
+ *   { ...complete first frame data... },           // Index 0: Base frame (full data)
+ *   { rotationValues: { head: 0.5 }, ... },        // Index 1: Only changed values
+ *   { selfRotationValues: { leftArm: 0.2 } },      // Index 2: Only changed values
+ *   ...
+ * ]
+ *
+ * Also supports legacy verbose format:
+ * {
+ *   version: "1.0",
+ *   baseFrame: { ...complete first frame data... },
+ *   diffs: [null, {...}, {...}, ...]
+ * }
+ */
+/**
+ * Deep comparison to check if two values are equal
+ */
+const isEqual = (a, b) => {
+    if (a === b)
+        return true;
+    if (a == null || b == null)
+        return false;
+    if (typeof a !== typeof b)
+        return false;
+    if (typeof a === 'object') {
+        const keysA = Object.keys(a);
+        const keysB = Object.keys(b);
+        if (keysA.length !== keysB.length)
+            return false;
+        return keysA.every(key => isEqual(a[key], b[key]));
+    }
+    return false;
+};
+/**
+ * Create a diff object containing only changed properties
+ * @param prevFrame - Previous frame data
+ * @param currentFrame - Current frame data
+ * @returns Diff object or null if no changes
+ */
+const createFrameDiff = (prevFrame, currentFrame) => {
+    if (!prevFrame || !currentFrame)
+        return currentFrame;
+    const diff = {};
+    let hasChanges = false;
+    // Properties that might change between frames
+    const diffableProps = [
+        'rotationValues',
+        'selfRotationValues',
+        'dimensionValues',
+        'pivotPoints',
+        'jointOffset',
+        'zIndexValues',
+        'eyes',
+        'mouth',
+        'visibility',
+        'imageScale',
+        'flipX',
+        'flipHead'
+    ];
+    diffableProps.forEach(prop => {
+        if (!currentFrame.hasOwnProperty(prop))
+            return;
+        const prevValue = prevFrame[prop];
+        const currentValue = currentFrame[prop];
+        // If the property doesn't exist in previous frame, include it entirely
+        if (!prevFrame.hasOwnProperty(prop)) {
+            diff[prop] = currentValue;
+            hasChanges = true;
+            return;
+        }
+        // For objects, diff at the property level
+        if (typeof currentValue === 'object' && !Array.isArray(currentValue) && currentValue !== null) {
+            const propDiff = {};
+            let hasPropChanges = false;
+            Object.keys(currentValue).forEach(key => {
+                const prevVal = prevValue?.[key];
+                const currVal = currentValue[key];
+                if (!isEqual(prevVal, currVal)) {
+                    propDiff[key] = currVal;
+                    hasPropChanges = true;
+                }
+            });
+            if (hasPropChanges) {
+                diff[prop] = propDiff;
+                hasChanges = true;
+            }
+        }
+        else {
+            // For non-objects, include if different
+            if (!isEqual(prevValue, currentValue)) {
+                diff[prop] = currentValue;
+                hasChanges = true;
+            }
+        }
+    });
+    return hasChanges ? diff : null;
+};
+/**
+ * Convert full-state animation frames to diff-based format
+ * @param frames - Array of complete frame objects
+ * @returns Diff-based animation array [baseFrame, diff1, diff2, ...]
+ */
+export const createDiffBasedAnimation = (frames) => {
+    if (!frames || frames.length === 0) {
+        return [];
+    }
+    // First element is the complete base frame
+    const result = [{ ...frames[0] }];
+    // Subsequent elements are diffs from the previous frame
+    for (let i = 1; i < frames.length; i++) {
+        const prevFrame = frames[i - 1];
+        const currentFrame = frames[i];
+        const diff = createFrameDiff(prevFrame, currentFrame);
+        result.push(diff || {}); // Use empty object if no changes
+    }
+    return result;
+};
+/**
+ * Apply a diff to a frame to get the next frame state
+ * @param baseFrame - Base frame to apply diff to
+ * @param diff - Diff object
+ * @returns Resulting frame
+ */
+const applyDiff = (baseFrame, diff) => {
+    if (!diff)
+        return { ...baseFrame };
+    const result = { ...baseFrame };
+    Object.keys(diff).forEach(prop => {
+        const diffValue = diff[prop];
+        // If the diff value is an object, merge it with the base
+        if (typeof diffValue === 'object' && !Array.isArray(diffValue) && diffValue !== null) {
+            result[prop] = {
+                ...result[prop],
+                ...diffValue
+            };
+        }
+        else {
+            // Otherwise, replace entirely
+            result[prop] = diffValue;
+        }
+    });
+    return result;
+};
+/**
+ * Convert diff-based animation back to full-state frames
+ * Supports both formats:
+ * - New format: [baseFrame, diff1, diff2, ...]
+ * - Old format: { baseFrame, diffs: [...] }
+ * @param diffBasedAnimation - Diff-based animation
+ * @returns Array of complete frame objects
+ */
+export const expandDiffBasedAnimation = (diffBasedAnimation) => {
+    if (!diffBasedAnimation) {
+        return [];
+    }
+    // Handle new compact array format: [baseFrame, diff1, diff2, ...]
+    if (Array.isArray(diffBasedAnimation)) {
+        if (diffBasedAnimation.length === 0)
+            return [];
+        const frames = [];
+        let currentFrame = { ...diffBasedAnimation[0] }; // First element is base frame
+        frames.push(currentFrame);
+        // Apply each subsequent diff
+        for (let i = 1; i < diffBasedAnimation.length; i++) {
+            currentFrame = applyDiff(currentFrame, diffBasedAnimation[i]);
+            frames.push({ ...currentFrame });
+        }
+        return frames;
+    }
+    // Handle old verbose format: { baseFrame, diffs: [...] }
+    const verboseFormat = diffBasedAnimation;
+    if (verboseFormat.baseFrame && verboseFormat.diffs) {
+        const { baseFrame, diffs } = verboseFormat;
+        const frames = [];
+        let currentFrame = { ...baseFrame };
+        frames.push(currentFrame);
+        // Apply each diff to reconstruct frames
+        for (let i = 1; i < diffs.length; i++) {
+            currentFrame = applyDiff(currentFrame, diffs[i]);
+            frames.push({ ...currentFrame });
+        }
+        return frames;
+    }
+    return [];
+};
+/**
+ * Calculate compression ratio
+ * @param originalFrames - Original full-state frames
+ * @param diffBasedAnimation - Diff-based animation
+ * @returns Statistics about compression
+ */
+export const calculateCompressionStats = (originalFrames, diffBasedAnimation) => {
+    const originalSize = JSON.stringify(originalFrames).length;
+    const compressedSize = JSON.stringify(diffBasedAnimation).length;
+    const ratio = ((1 - compressedSize / originalSize) * 100).toFixed(2);
+    return {
+        originalSize,
+        compressedSize,
+        savedBytes: originalSize - compressedSize,
+        compressionRatio: ratio + '%'
+    };
+};
+/**
+ * Validate that a diff-based animation can be properly expanded
+ * Supports both new array format and old object format
+ * @param diffBasedAnimation - Diff-based animation to validate
+ * @returns True if valid
+ */
+export const validateDiffBasedAnimation = (diffBasedAnimation) => {
+    if (!diffBasedAnimation)
+        return false;
+    // New compact array format: [baseFrame, diff1, diff2, ...]
+    if (Array.isArray(diffBasedAnimation)) {
+        if (diffBasedAnimation.length === 0)
+            return false;
+        // First element should be a complete frame (has rotationValues or other base properties)
+        if (!diffBasedAnimation[0] || typeof diffBasedAnimation[0] !== 'object')
+            return false;
+        return true;
+    }
+    // Old verbose format: { version, baseFrame, diffs }
+    const verboseFormat = diffBasedAnimation;
+    if (!verboseFormat.version)
+        return false;
+    if (!verboseFormat.baseFrame)
+        return false;
+    if (!Array.isArray(verboseFormat.diffs))
+        return false;
+    if (verboseFormat.diffs.length === 0)
+        return false;
+    return true;
+};
+/**
+ * Helper to check if animation data is in diff format
+ * Detects both new array format and old object format
+ * @param animationData - Animation data to check
+ * @returns True if in diff format
+ */
+export const isDiffBasedFormat = (animationData) => {
+    if (!animationData)
+        return false;
+    // New compact array format: [baseFrame, diff1, diff2, ...]
+    // Heuristic: If it's an array where first element has full frame data
+    // and second element (if exists) has partial data, it's likely diff format
+    if (Array.isArray(animationData)) {
+        if (animationData.length === 0)
+            return false;
+        const firstFrame = animationData[0];
+        if (!firstFrame || typeof firstFrame !== 'object')
+            return false;
+        // If first frame has rotationValues or other key properties, check if it's diff format
+        const hasKeyProperties = firstFrame.rotationValues ||
+            firstFrame.dimensionValues ||
+            firstFrame.imagePaths ||
+            firstFrame.rotation !== undefined ||
+            firstFrame.width !== undefined;
+        if (hasKeyProperties) {
+            // If there's a second element
+            if (animationData.length > 1) {
+                const secondFrame = animationData[1];
+                // If second frame has fewer top-level keys than first, likely a diff
+                const firstKeys = Object.keys(firstFrame).length;
+                const secondKeys = Object.keys(secondFrame).length;
+                // Diff format has fewer keys in subsequent frames (only changed properties)
+                if (secondKeys < firstKeys)
+                    return true;
+                // Also check if second frame is missing metadata that first frame has
+                if (firstFrame.imagePaths && !secondFrame.imagePaths)
+                    return true;
+                if (firstFrame.imageScale !== undefined && !secondFrame.hasOwnProperty('imageScale'))
+                    return true;
+                if (firstFrame.dimensionValues && !secondFrame.dimensionValues)
+                    return true;
+            }
+            // Single frame could be either format, default to full-state
+            return false;
+        }
+    }
+    // Old verbose format: { version, baseFrame, diffs }
+    return (animationData &&
+        typeof animationData === 'object' &&
+        'baseFrame' in animationData &&
+        'diffs' in animationData);
+};
+/**
+ * Smart loader that handles both formats
+ * @param animationData - Animation data in either format
+ * @returns Full-state frames array
+ */
+export const loadAnimation = (animationData) => {
+    if (!animationData)
+        return [];
+    // Check if it's diff-based format first
+    if (isDiffBasedFormat(animationData)) {
+        console.log('📊 Detected diff-based animation format, expanding...');
+        return expandDiffBasedAnimation(animationData);
+    }
+    // If it's already an array and not diff-based, assume it's full-state format
+    if (Array.isArray(animationData)) {
+        return animationData;
+    }
+    // Unknown format
+    console.warn('Unknown animation format');
+    return [];
+};
+/**
+ * Export animation in diff format with optional compression stats
+ * @param frames - Full-state frames
+ * @param showStats - Whether to log compression stats
+ * @returns Diff-based animation
+ */
+export const exportDiffAnimation = (frames, showStats = true) => {
+    const diffAnimation = createDiffBasedAnimation(frames);
+    if (showStats && frames.length > 0) {
+        const stats = calculateCompressionStats(frames, diffAnimation);
+        console.log('Animation Compression Stats:', stats);
+    }
+    return diffAnimation;
+};
+//# sourceMappingURL=animationDiff.js.map

package/dist/modules/animationDiff.js.map

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

package/dist/modules/eyeSystem.d.ts

@@ -2,7 +2,18 @@
  * Eye System Module
  * Handles eye blinking, gaze direction, and eye movement for character rigs
  */
-import type { EyeData, EyeDirection, EyelidState, EyeMovementConfig, EyeState, Position } from '../types.js';
+import type { EyeData, EyeDirection, EyeSockets, EyelidState, EyeMovementConfig, EyeState, Position } from '../types.js';
+/** Options for creating an EyeSystem with socket-derived movement ranges */
+export interface EyeSystemOptions {
+    /** Eye configuration data from rig */
+    eyeData: EyeData;
+    /** Eye socket polygons for left/right eyes - used to compute iris movement bounds */
+    eyeSockets?: EyeSockets;
+    /** Character/head width (for scaling socket coords when in 0-100 percent space) */
+    headWidth?: number;
+    /** Character/head height (for scaling socket coords when in 0-100 percent space) */
+    headHeight?: number;
+}
 /**
  * EyeSystem class - Manages eye animation, blinking, and gaze for characters
  */
@@ -15,15 +26,19 @@ export declare class EyeSystem {
      */
     private readonly baseIrisCoords;
     /**
-     * Default eye movement ranges for different directions
+     * Movement ranges per direction (derived from eye sockets or defaults)
+     */
+    private readonly movementRanges;
+    /**
+     * Max pixel range for manual positions (-2 to 2 scale) - used in setManualIrisPositions
      */
-    private static readonly EYE_MOVEMENT_RANGES;
+    private readonly manualScaleFactor;
     /**
      * Creates a new EyeSystem instance
      * @param characterId - Unique identifier for the character
-     * @param eyeData - Eye configuration data from rig
+     * @param eyeDataOrOptions - Eye configuration data, or options object with eyeData + optional eyeSockets/headWidth/headHeight
      */
-    constructor(characterId: string, eyeData: EyeData);
+    constructor(characterId: string, eyeDataOrOptions: EyeData | EyeSystemOptions);
     /**
      * Get current eye state
      */
@@ -138,6 +153,18 @@ export declare class EyeSystem {
 }
 /**
  * Factory function to create eye system from rig data
+ * @param characterId - Unique identifier for the character
+ * @param eyeDataOrRigData - Eye configuration data, or full RigData object (will extract eyes and eyeSockets)
+ * @param options - Optional: { eyeSockets, headWidth, headHeight } - when provided, movement ranges are computed from eye socket polygons
  */
-export declare function createEyeSystem(characterId: string, eyeData: EyeData): EyeSystem;
+export declare function createEyeSystem(characterId: string, eyeDataOrRigData: EyeData | {
+    eyes?: EyeData;
+    eyeSockets?: EyeSockets;
+    width?: number;
+    height?: number;
+}, options?: {
+    eyeSockets?: EyeSockets;
+    headWidth?: number;
+    headHeight?: number;
+}): EyeSystem;
 //# sourceMappingURL=eyeSystem.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"eyeSystem.d.ts","sourceRoot":"","sources":["../../modules/eyeSystem.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACR,OAAO,EACP,YAAY,EACZ,WAAW,EACX,iBAAiB,EACjB,QAAQ,EACR,QAAQ,EACX,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,qBAAa,SAAS;IAClB,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,WAAW,CAAS;IAE5B;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,cAAc,CAK7B;IAEF;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAWzC;IAEF;;;;OAIG;gBACS,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;IAgCjD;;OAEG;IACH,QAAQ,IAAI,QAAQ;IAIpB;;OAEG;IACH,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAQtC;;OAEG;IACH,OAAO,CAAC,WAAW;IAKnB;;;OAGG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAwCzC;;;;OAIG;IACH,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAsCzE;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,YAAY,GAAG,IAAI;IAY9C;;;;OAIG;IACH,4BAA4B,CAAC,SAAS,EAAE,QAAQ,EAAE,YAAY,GAAE,QAAyB,GAAG,YAAY;IAoBxG;;OAEG;IACH,iBAAiB,IAAI,IAAI;IAMzB;;;;;;OAMG;IACH,MAAM,CACF,WAAW,EAAE,MAAM,EACnB,SAAS,GAAE,OAAe,EAC1B,oBAAoB,CAAC,EAAE,QAAQ,EAC/B,YAAY,GAAE,QAAyB,GACxC,IAAI;IA0CP;;OAEG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM;IAejD;;OAEG;IACH,gBAAgB,IAAI;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,KAAK,EAAE,QAAQ,CAAA;KAAE;IAOvD;;OAEG;IACH,cAAc,IAAI,WAAW;IAI7B;;OAEG;IACH,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAI5C;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIxC;;OAEG;IACH,UAAU,IAAI,IAAI;IAMlB;;;;OAIG;IACH,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAM5C;;;;;;;;;;;;;;;;;;OAkBG;IACH,sBAAsB,CAClB,YAAY,EAAE;QAAE,IAAI,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,KAAK,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,EACjF,WAAW,EAAE,MAAM,GACpB,IAAI;IAkBP;;OAEG;IACH,YAAY,IAAI,MAAM;CAQzB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,SAAS,CAEhF"}
+{"version":3,"file":"eyeSystem.d.ts","sourceRoot":"","sources":["../../modules/eyeSystem.ts"],"names":[],"mappings":"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"}