@hanzogui/animation-helpers 8.3.0 → 8.3.2

package/dist/cjs/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAnimationConfigsForKeys = exports.getEffectiveAnimation = exports.getAnimatedProperties = exports.hasAnimation = exports.getAnimationForProperty = exports.normalizeTransition = void 0;
+var normalizeTransition_ts_1 = require("./normalizeTransition.js");
+Object.defineProperty(exports, "normalizeTransition", { enumerable: true, get: function () { return normalizeTransition_ts_1.normalizeTransition; } });
+Object.defineProperty(exports, "getAnimationForProperty", { enumerable: true, get: function () { return normalizeTransition_ts_1.getAnimationForProperty; } });
+Object.defineProperty(exports, "hasAnimation", { enumerable: true, get: function () { return normalizeTransition_ts_1.hasAnimation; } });
+Object.defineProperty(exports, "getAnimatedProperties", { enumerable: true, get: function () { return normalizeTransition_ts_1.getAnimatedProperties; } });
+Object.defineProperty(exports, "getEffectiveAnimation", { enumerable: true, get: function () { return normalizeTransition_ts_1.getEffectiveAnimation; } });
+Object.defineProperty(exports, "getAnimationConfigsForKeys", { enumerable: true, get: function () { return normalizeTransition_ts_1.getAnimationConfigsForKeys; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,mEAOiC;AAN/B,6HAAA,mBAAmB,OAAA;AACnB,iIAAA,uBAAuB,OAAA;AACvB,sHAAA,YAAY,OAAA;AACZ,+HAAA,qBAAqB,OAAA;AACrB,+HAAA,qBAAqB,OAAA;AACrB,oIAAA,0BAA0B,OAAA"}

package/dist/cjs/normalizeTransition.js

@@ -0,0 +1,229 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeTransition = normalizeTransition;
+exports.getAnimationForProperty = getAnimationForProperty;
+exports.hasAnimation = hasAnimation;
+exports.getAnimatedProperties = getAnimatedProperties;
+exports.getEffectiveAnimation = getEffectiveAnimation;
+exports.getAnimationConfigsForKeys = getAnimationConfigsForKeys;
+const SPRING_CONFIG_KEYS = new Set([
+    'stiffness',
+    'damping',
+    'mass',
+    'tension',
+    'friction',
+    'velocity',
+    'overshootClamping',
+    'duration',
+    'bounciness',
+    'speed',
+]);
+/**
+ * Check if a key is a spring config parameter
+ */
+function isSpringConfigKey(key) {
+    return SPRING_CONFIG_KEYS.has(key);
+}
+/**
+ * Normalizes the various transition prop formats into a consistent structure.
+ *
+ * Supported input formats:
+ * - String: "bouncy" -> { default: "bouncy", enter: null, exit: null, properties: {} }
+ * - Object: { x: 'quick', default: 'slow' } -> { default: "slow", enter: null, exit: null, properties: { x: "quick" } }
+ * - Object with enter/exit: { enter: 'bouncy', exit: 'quick' } -> { default: null, enter: "bouncy", exit: "quick", properties: {} }
+ * - Array: ['bouncy', { delay: 100, x: 'quick' }] -> { default: "bouncy", enter: null, exit: null, delay: 100, properties: { x: "quick" } }
+ *
+ * @param transition - The transition prop value in any supported format
+ * @returns Normalized transition object with consistent structure
+ */
+function normalizeTransition(transition) {
+    // Handle null/undefined
+    if (!transition) {
+        return {
+            default: null,
+            enter: null,
+            exit: null,
+            delay: undefined,
+            properties: {},
+        };
+    }
+    // String format: "bouncy"
+    if (typeof transition === 'string') {
+        return {
+            default: transition,
+            enter: null,
+            exit: null,
+            delay: undefined,
+            properties: {},
+        };
+    }
+    // Array format: ['bouncy', { delay: 100, x: 'quick', enter: 'slow', exit: 'fast' }]
+    // Also supports spring config overrides: ['bouncy', { stiffness: 1000, damping: 70 }]
+    if (Array.isArray(transition)) {
+        const [defaultAnimation, configObj] = transition;
+        const properties = {};
+        const springConfig = {};
+        let delay;
+        let enter = null;
+        let exit = null;
+        if (configObj && typeof configObj === 'object') {
+            for (const [key, value] of Object.entries(configObj)) {
+                if (key === 'delay' && typeof value === 'number') {
+                    delay = value;
+                }
+                else if (key === 'enter' && typeof value === 'string') {
+                    enter = value;
+                }
+                else if (key === 'exit' && typeof value === 'string') {
+                    exit = value;
+                }
+                else if (isSpringConfigKey(key) && value !== undefined) {
+                    // Spring config override: { stiffness: 1000, damping: 70 }
+                    Object.assign(springConfig, { [key]: value });
+                }
+                else if (value !== undefined) {
+                    // Property-specific animation: string or config object
+                    properties[key] = value;
+                }
+            }
+        }
+        return {
+            default: defaultAnimation,
+            enter,
+            exit,
+            delay,
+            properties,
+            config: Object.keys(springConfig).length > 0 ? springConfig : undefined,
+        };
+    }
+    // Object format: { x: 'quick', y: 'bouncy', default: 'slow', enter: 'bouncy', exit: 'quick' }
+    // Also supports spring config overrides: { default: 'bouncy', stiffness: 1000 }
+    if (typeof transition === 'object') {
+        const properties = {};
+        const springConfig = {};
+        let defaultAnimation = null;
+        let enter = null;
+        let exit = null;
+        let delay;
+        for (const [key, value] of Object.entries(transition)) {
+            if (key === 'default' && typeof value === 'string') {
+                defaultAnimation = value;
+            }
+            else if (key === 'enter' && typeof value === 'string') {
+                enter = value;
+            }
+            else if (key === 'exit' && typeof value === 'string') {
+                exit = value;
+            }
+            else if (key === 'delay' && typeof value === 'number') {
+                delay = value;
+            }
+            else if (isSpringConfigKey(key) && value !== undefined) {
+                // Spring config override: { stiffness: 1000, damping: 70 }
+                Object.assign(springConfig, { [key]: value });
+            }
+            else if (value !== undefined) {
+                // Property-specific animation: string or config object
+                properties[key] = value;
+            }
+        }
+        return {
+            default: defaultAnimation,
+            enter,
+            exit,
+            delay,
+            properties,
+            config: Object.keys(springConfig).length > 0 ? springConfig : undefined,
+        };
+    }
+    // Fallback
+    return {
+        default: null,
+        enter: null,
+        exit: null,
+        delay: undefined,
+        properties: {},
+    };
+}
+/**
+ * Gets the animation key for a specific property from a normalized transition.
+ * Falls back to the default animation if no property-specific one is defined.
+ *
+ * @param normalized - The normalized transition object
+ * @param property - The property name to get animation for (e.g., 'x', 'opacity')
+ * @returns The animation key/config or null if none defined
+ */
+function getAnimationForProperty(normalized, property) {
+    // Check for property-specific animation
+    const propertyAnimation = normalized.properties[property];
+    if (propertyAnimation !== undefined) {
+        return propertyAnimation;
+    }
+    // Fall back to default
+    return normalized.default;
+}
+/**
+ * Checks if the normalized transition has any animations defined.
+ */
+function hasAnimation(normalized) {
+    return (normalized.default !== null ||
+        normalized.enter !== null ||
+        normalized.exit !== null ||
+        Object.keys(normalized.properties).length > 0);
+}
+/**
+ * Gets all property names that have specific animations defined.
+ * Does not include 'default' in the list.
+ */
+function getAnimatedProperties(normalized) {
+    return Object.keys(normalized.properties);
+}
+/**
+ * Gets the effective animation key based on the current animation state.
+ * Priority: enter/exit specific > default > null
+ *
+ * @param normalized - The normalized transition object
+ * @param state - The animation state: 'enter', 'exit', or 'default'
+ * @returns The effective animation key or null
+ */
+function getEffectiveAnimation(normalized, state) {
+    if (state === 'enter' && normalized.enter) {
+        return normalized.enter;
+    }
+    if (state === 'exit' && normalized.exit) {
+        return normalized.exit;
+    }
+    return normalized.default;
+}
+/**
+ * Gets the resolved animation config for each key, looking up in animations config.
+ * Useful for calculating max duration across all animated properties.
+ *
+ * @param normalized - The normalized transition object
+ * @param animations - The animations config object (driver-specific format)
+ * @param keys - Property keys to get animations for
+ * @param defaultAnimation - The default animation value to fall back to
+ * @returns Map of key -> resolved animation config (or null if not found)
+ */
+function getAnimationConfigsForKeys(normalized, animations, keys, defaultAnimation) {
+    const result = new Map();
+    for (const key of keys) {
+        const propAnimation = normalized.properties[key];
+        let animationValue = null;
+        if (typeof propAnimation === 'string') {
+            animationValue = animations[propAnimation] ?? null;
+        }
+        else if (propAnimation &&
+            typeof propAnimation === 'object' &&
+            propAnimation.type) {
+            animationValue = animations[propAnimation.type] ?? null;
+        }
+        // fall back to default if no per-property config found
+        if (animationValue === null) {
+            animationValue = defaultAnimation;
+        }
+        result.set(key, animationValue);
+    }
+    return result;
+}
+//# sourceMappingURL=normalizeTransition.js.map

package/dist/cjs/normalizeTransition.js.map

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

package/dist/cjs/package.json

@@ -0,0 +1 @@
+{ "type": "commonjs" }

package/dist/cjs/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/cjs/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":""}

package/dist/esm/index.js

@@ -1,3 +1,2 @@
-import { normalizeTransition, getAnimationForProperty, hasAnimation, getAnimatedProperties, getEffectiveAnimation, getAnimationConfigsForKeys } from "./normalizeTransition.mjs";
-export { getAnimatedProperties, getAnimationConfigsForKeys, getAnimationForProperty, getEffectiveAnimation, hasAnimation, normalizeTransition };
-//# sourceMappingURL=index.js.map
+export { normalizeTransition, getAnimationForProperty, hasAnimation, getAnimatedProperties, getEffectiveAnimation, getAnimationConfigsForKeys, } from './normalizeTransition.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["normalizeTransition","getAnimationForProperty","hasAnimation","getAnimatedProperties","getEffectiveAnimation","getAnimationConfigsForKeys"],"sources":["../../src/index.ts"],"sourcesContent":[null],"mappings":"AAAA,SACEA,mBAAA,EACAC,uBAAA,EACAC,YAAA,EACAC,qBAAA,EACAC,qBAAA,EACAC,0BAAA,QACK","ignoreList":[]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,YAAY,EACZ,qBAAqB,EACrB,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,0BAA0B,CAAA"}

package/dist/esm/normalizeTransition.js

@@ -0,0 +1,221 @@
+const SPRING_CONFIG_KEYS = new Set([
+    'stiffness',
+    'damping',
+    'mass',
+    'tension',
+    'friction',
+    'velocity',
+    'overshootClamping',
+    'duration',
+    'bounciness',
+    'speed',
+]);
+/**
+ * Check if a key is a spring config parameter
+ */
+function isSpringConfigKey(key) {
+    return SPRING_CONFIG_KEYS.has(key);
+}
+/**
+ * Normalizes the various transition prop formats into a consistent structure.
+ *
+ * Supported input formats:
+ * - String: "bouncy" -> { default: "bouncy", enter: null, exit: null, properties: {} }
+ * - Object: { x: 'quick', default: 'slow' } -> { default: "slow", enter: null, exit: null, properties: { x: "quick" } }
+ * - Object with enter/exit: { enter: 'bouncy', exit: 'quick' } -> { default: null, enter: "bouncy", exit: "quick", properties: {} }
+ * - Array: ['bouncy', { delay: 100, x: 'quick' }] -> { default: "bouncy", enter: null, exit: null, delay: 100, properties: { x: "quick" } }
+ *
+ * @param transition - The transition prop value in any supported format
+ * @returns Normalized transition object with consistent structure
+ */
+export function normalizeTransition(transition) {
+    // Handle null/undefined
+    if (!transition) {
+        return {
+            default: null,
+            enter: null,
+            exit: null,
+            delay: undefined,
+            properties: {},
+        };
+    }
+    // String format: "bouncy"
+    if (typeof transition === 'string') {
+        return {
+            default: transition,
+            enter: null,
+            exit: null,
+            delay: undefined,
+            properties: {},
+        };
+    }
+    // Array format: ['bouncy', { delay: 100, x: 'quick', enter: 'slow', exit: 'fast' }]
+    // Also supports spring config overrides: ['bouncy', { stiffness: 1000, damping: 70 }]
+    if (Array.isArray(transition)) {
+        const [defaultAnimation, configObj] = transition;
+        const properties = {};
+        const springConfig = {};
+        let delay;
+        let enter = null;
+        let exit = null;
+        if (configObj && typeof configObj === 'object') {
+            for (const [key, value] of Object.entries(configObj)) {
+                if (key === 'delay' && typeof value === 'number') {
+                    delay = value;
+                }
+                else if (key === 'enter' && typeof value === 'string') {
+                    enter = value;
+                }
+                else if (key === 'exit' && typeof value === 'string') {
+                    exit = value;
+                }
+                else if (isSpringConfigKey(key) && value !== undefined) {
+                    // Spring config override: { stiffness: 1000, damping: 70 }
+                    Object.assign(springConfig, { [key]: value });
+                }
+                else if (value !== undefined) {
+                    // Property-specific animation: string or config object
+                    properties[key] = value;
+                }
+            }
+        }
+        return {
+            default: defaultAnimation,
+            enter,
+            exit,
+            delay,
+            properties,
+            config: Object.keys(springConfig).length > 0 ? springConfig : undefined,
+        };
+    }
+    // Object format: { x: 'quick', y: 'bouncy', default: 'slow', enter: 'bouncy', exit: 'quick' }
+    // Also supports spring config overrides: { default: 'bouncy', stiffness: 1000 }
+    if (typeof transition === 'object') {
+        const properties = {};
+        const springConfig = {};
+        let defaultAnimation = null;
+        let enter = null;
+        let exit = null;
+        let delay;
+        for (const [key, value] of Object.entries(transition)) {
+            if (key === 'default' && typeof value === 'string') {
+                defaultAnimation = value;
+            }
+            else if (key === 'enter' && typeof value === 'string') {
+                enter = value;
+            }
+            else if (key === 'exit' && typeof value === 'string') {
+                exit = value;
+            }
+            else if (key === 'delay' && typeof value === 'number') {
+                delay = value;
+            }
+            else if (isSpringConfigKey(key) && value !== undefined) {
+                // Spring config override: { stiffness: 1000, damping: 70 }
+                Object.assign(springConfig, { [key]: value });
+            }
+            else if (value !== undefined) {
+                // Property-specific animation: string or config object
+                properties[key] = value;
+            }
+        }
+        return {
+            default: defaultAnimation,
+            enter,
+            exit,
+            delay,
+            properties,
+            config: Object.keys(springConfig).length > 0 ? springConfig : undefined,
+        };
+    }
+    // Fallback
+    return {
+        default: null,
+        enter: null,
+        exit: null,
+        delay: undefined,
+        properties: {},
+    };
+}
+/**
+ * Gets the animation key for a specific property from a normalized transition.
+ * Falls back to the default animation if no property-specific one is defined.
+ *
+ * @param normalized - The normalized transition object
+ * @param property - The property name to get animation for (e.g., 'x', 'opacity')
+ * @returns The animation key/config or null if none defined
+ */
+export function getAnimationForProperty(normalized, property) {
+    // Check for property-specific animation
+    const propertyAnimation = normalized.properties[property];
+    if (propertyAnimation !== undefined) {
+        return propertyAnimation;
+    }
+    // Fall back to default
+    return normalized.default;
+}
+/**
+ * Checks if the normalized transition has any animations defined.
+ */
+export function hasAnimation(normalized) {
+    return (normalized.default !== null ||
+        normalized.enter !== null ||
+        normalized.exit !== null ||
+        Object.keys(normalized.properties).length > 0);
+}
+/**
+ * Gets all property names that have specific animations defined.
+ * Does not include 'default' in the list.
+ */
+export function getAnimatedProperties(normalized) {
+    return Object.keys(normalized.properties);
+}
+/**
+ * Gets the effective animation key based on the current animation state.
+ * Priority: enter/exit specific > default > null
+ *
+ * @param normalized - The normalized transition object
+ * @param state - The animation state: 'enter', 'exit', or 'default'
+ * @returns The effective animation key or null
+ */
+export function getEffectiveAnimation(normalized, state) {
+    if (state === 'enter' && normalized.enter) {
+        return normalized.enter;
+    }
+    if (state === 'exit' && normalized.exit) {
+        return normalized.exit;
+    }
+    return normalized.default;
+}
+/**
+ * Gets the resolved animation config for each key, looking up in animations config.
+ * Useful for calculating max duration across all animated properties.
+ *
+ * @param normalized - The normalized transition object
+ * @param animations - The animations config object (driver-specific format)
+ * @param keys - Property keys to get animations for
+ * @param defaultAnimation - The default animation value to fall back to
+ * @returns Map of key -> resolved animation config (or null if not found)
+ */
+export function getAnimationConfigsForKeys(normalized, animations, keys, defaultAnimation) {
+    const result = new Map();
+    for (const key of keys) {
+        const propAnimation = normalized.properties[key];
+        let animationValue = null;
+        if (typeof propAnimation === 'string') {
+            animationValue = animations[propAnimation] ?? null;
+        }
+        else if (propAnimation &&
+            typeof propAnimation === 'object' &&
+            propAnimation.type) {
+            animationValue = animations[propAnimation.type] ?? null;
+        }
+        // fall back to default if no per-property config found
+        if (animationValue === null) {
+            animationValue = defaultAnimation;
+        }
+        result.set(key, animationValue);
+    }
+    return result;
+}
+//# sourceMappingURL=normalizeTransition.js.map

package/dist/esm/normalizeTransition.js.map

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

package/dist/esm/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hanzogui/animation-helpers",
-  "version": "8.3.0",
+  "version": "8.3.2",
   "gitHead": "a49cc7ea6b93ba384e77a4880ae48ac4a5635c14",
   "license": "MIT",
   "source": "src/index.ts",
@@ -11,32 +11,32 @@
   ],
   "type": "module",
   "sideEffects": false,
-  "main": "dist/cjs",
-  "module": "dist/esm",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
   "types": "./types/index.d.ts",
   "exports": {
     "./package.json": "./package.json",
     ".": {
       "types": "./types/index.d.ts",
-      "react-native": "./dist/esm/index.native.js",
-      "browser": "./dist/esm/index.mjs",
-      "module": "./dist/esm/index.mjs",
-      "import": "./dist/esm/index.mjs",
-      "require": "./dist/cjs/index.cjs",
-      "default": "./dist/esm/index.mjs"
+      "react-native": "./dist/esm/index.js",
+      "browser": "./dist/esm/index.js",
+      "module": "./dist/esm/index.js",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js",
+      "default": "./dist/esm/index.js"
     }
   },
   "publishConfig": {
     "access": "public"
   },
   "scripts": {
-    "build": "hanzogui-build",
+    "build": "hanzogui-build --skip-native",
     "watch": "hanzogui-build --watch",
     "clean": "hanzogui-build clean",
     "clean:build": "hanzogui-build clean:build"
   },
   "devDependencies": {
-    "@hanzogui/build": "8.3.0"
+    "@hanzogui/build": "8.3.2"
   },
   "repository": {
     "type": "git",

package/src/index.ts

@@ -5,6 +5,10 @@ export {
   getAnimatedProperties,
   getEffectiveAnimation,
   getAnimationConfigsForKeys,
-} from './normalizeTransition'
+} from './normalizeTransition.ts'
 
-export type { AnimationConfig, NormalizedTransition, TransitionPropInput } from './types'
+export type {
+  AnimationConfig,
+  NormalizedTransition,
+  TransitionPropInput,
+} from './types.ts'

package/src/normalizeTransition.ts

@@ -3,7 +3,7 @@ import type {
   NormalizedTransition,
   SpringConfig,
   TransitionPropInput,
-} from './types'
+} from './types.ts'
 
 const SPRING_CONFIG_KEYS: Set<string> = new Set([
   'stiffness',
@@ -82,7 +82,7 @@ export function normalizeTransition(
           exit = value
         } else if (isSpringConfigKey(key) && value !== undefined) {
           // Spring config override: { stiffness: 1000, damping: 70 }
-          springConfig[key] = value as SpringConfig[keyof SpringConfig]
+          Object.assign(springConfig, { [key]: value })
         } else if (value !== undefined) {
           // Property-specific animation: string or config object
           properties[key] = value as string | AnimationConfig
@@ -121,7 +121,7 @@ export function normalizeTransition(
         delay = value
       } else if (isSpringConfigKey(key) && value !== undefined) {
         // Spring config override: { stiffness: 1000, damping: 70 }
-        springConfig[key] = value as SpringConfig[keyof SpringConfig]
+        Object.assign(springConfig, { [key]: value })
       } else if (value !== undefined) {
         // Property-specific animation: string or config object
         properties[key] = value as string | AnimationConfig

package/types/index.d.ts

@@ -1,4 +1,3 @@
-export { normalizeTransition, getAnimationForProperty, hasAnimation, getAnimatedProperties, getEffectiveAnimation, getAnimationConfigsForKeys } from "./normalizeTransition";
-export type { AnimationConfig, NormalizedTransition, TransitionPropInput } from "./types";
-
+export { normalizeTransition, getAnimationForProperty, hasAnimation, getAnimatedProperties, getEffectiveAnimation, getAnimationConfigsForKeys, } from './normalizeTransition.ts';
+export type { AnimationConfig, NormalizedTransition, TransitionPropInput, } from './types.ts';
 //# sourceMappingURL=index.d.ts.map

package/types/index.d.ts.map

@@ -1,11 +1 @@
-{
-  "mappings": "AAAA,SACE,qBACA,yBACA,cACA,uBACA,uBACA,kCACK;AAEP,cAAc,iBAAiB,sBAAsB,2BAA2B",
-  "names": [],
-  "sources": [
-    "src/index.ts"
-  ],
-  "version": 3,
-  "sourcesContent": [
-    "export {\n  normalizeTransition,\n  getAnimationForProperty,\n  hasAnimation,\n  getAnimatedProperties,\n  getEffectiveAnimation,\n  getAnimationConfigsForKeys,\n} from './normalizeTransition'\n\nexport type { AnimationConfig, NormalizedTransition, TransitionPropInput } from './types'\n"
-  ]
-}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,YAAY,EACZ,qBAAqB,EACrB,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,0BAA0B,CAAA;AAEjC,YAAY,EACV,eAAe,EACf,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,YAAY,CAAA"}