premium-react-loaders 1.1.0 → 1.3.0

package/dist/index28.js

@@ -1,6 +1,7 @@
 import { jsx } from "react/jsx-runtime";
 import { forwardRef } from "react";
-import { normalizeSize, getAnimationDuration } from "./index4.js";
+import { useReducedMotion, useLoaderVisibility, getEffectiveDuration } from "./index31.js";
+import { normalizeSize } from "./index4.js";
 import { cn } from "./index3.js";
 const TypingIndicator = forwardRef(
   ({
@@ -11,6 +12,11 @@ const TypingIndicator = forwardRef(
     gap = 4,
     variant = "bounce",
     speed = "normal",
+    reverse = false,
+    respectMotionPreference = true,
+    delay = 0,
+    minDuration = 0,
+    transition,
     className,
     style,
     testId = "typing-indicator",
@@ -18,8 +24,15 @@ const TypingIndicator = forwardRef(
     ariaLabel = "Typing...",
     ...rest
   }, ref) => {
-    if (!visible) return null;
-    const animationDuration = getAnimationDuration(speed);
+    const prefersReducedMotion = useReducedMotion();
+    const effectiveDuration = getEffectiveDuration(speed, respectMotionPreference, prefersReducedMotion);
+    const { shouldRender, opacity, transitionStyle } = useLoaderVisibility(
+      visible,
+      delay,
+      minDuration,
+      transition
+    );
+    if (!shouldRender) return null;
     const gapValue = normalizeSize(gap);
     return /* @__PURE__ */ jsx(
       "div",
@@ -30,7 +43,9 @@ const TypingIndicator = forwardRef(
         style: {
           gap: gapValue,
           height: size ? normalizeSize(size) : "auto",
-          ...style
+          ...style,
+          opacity,
+          transition: transitionStyle
         },
         role: "status",
         "aria-label": ariaLabel,
@@ -44,8 +59,8 @@ const TypingIndicator = forwardRef(
               width: normalizeSize(dotSize),
               height: normalizeSize(dotSize),
               backgroundColor: color,
-              animation: `typing-${variant} ${animationDuration} ease-in-out infinite`,
-              animationDelay: `${index * 0.2}s`
+              animation: `typing-${variant} ${effectiveDuration} ease-in-out infinite`,
+              animationDelay: reverse ? `${(dotCount - index - 1) * 0.2}s` : `${index * 0.2}s`
             }
           },
           index

package/dist/index28.js.map

@@ -1 +1 @@
-{"version":3,"file":"index28.js","sources":["../src/components/pulse/TypingIndicator.tsx"],"sourcesContent":["import { forwardRef } from 'react';\nimport { TypingIndicatorProps } from '../../types';\nimport { cn, normalizeSize, getAnimationDuration } from '../../utils';\n\n/**\n * TypingIndicator - Chat typing indicator\n *\n * A loader for messaging/chat applications showing typing activity.\n *\n * @example\n * ```tsx\n * <TypingIndicator />\n * <TypingIndicator variant=\"fade\" />\n * <TypingIndicator dotCount={5} color=\"#3b82f6\" />\n * <TypingIndicator dotSize={10} gap={6} />\n * ```\n */\nexport const TypingIndicator = forwardRef<HTMLDivElement, TypingIndicatorProps>(\n  (\n    {\n      size,\n      color = '#3b82f6',\n      dotCount = 3,\n      dotSize = 8,\n      gap = 4,\n      variant = 'bounce',\n      speed = 'normal',\n      className,\n      style,\n      testId = 'typing-indicator',\n      visible = true,\n      ariaLabel = 'Typing...',\n      ...rest\n    },\n    ref\n  ) => {\n    if (!visible) return null;\n\n    const animationDuration = getAnimationDuration(speed);\n    const gapValue = normalizeSize(gap);\n\n    return (\n      <div\n        ref={ref}\n        data-testid={testId}\n        className={cn('inline-flex items-center', className)}\n        style={{\n          gap: gapValue,\n          height: size ? normalizeSize(size) : 'auto',\n          ...style,\n        }}\n        role=\"status\"\n        aria-label={ariaLabel}\n        aria-busy=\"true\"\n        {...rest}\n      >\n        {Array.from({ length: dotCount }).map((_, index) => (\n          <div\n            key={index}\n            className=\"rounded-full\"\n            style={{\n              width: normalizeSize(dotSize),\n              height: normalizeSize(dotSize),\n              backgroundColor: color,\n              animation: `typing-${variant} ${animationDuration} ease-in-out infinite`,\n              animationDelay: `${index * 0.2}s`,\n            }}\n          />\n        ))}\n      </div>\n    );\n  }\n);\n\nTypingIndicator.displayName = 'TypingIndicator';\n"],"names":[],"mappings":";;;;AAiBO,MAAM,kBAAkB;AAAA,EAC7B,CACE;AAAA,IACE;AAAA,IACA,QAAQ;AAAA,IACR,WAAW;AAAA,IACX,UAAU;AAAA,IACV,MAAM;AAAA,IACN,UAAU;AAAA,IACV,QAAQ;AAAA,IACR;AAAA,IACA;AAAA,IACA,SAAS;AAAA,IACT,UAAU;AAAA,IACV,YAAY;AAAA,IACZ,GAAG;AAAA,EAAA,GAEL,QACG;AACH,QAAI,CAAC,QAAS,QAAO;AAErB,UAAM,oBAAoB,qBAAqB,KAAK;AACpD,UAAM,WAAW,cAAc,GAAG;AAElC,WACE;AAAA,MAAC;AAAA,MAAA;AAAA,QACC;AAAA,QACA,eAAa;AAAA,QACb,WAAW,GAAG,4BAA4B,SAAS;AAAA,QACnD,OAAO;AAAA,UACL,KAAK;AAAA,UACL,QAAQ,OAAO,cAAc,IAAI,IAAI;AAAA,UACrC,GAAG;AAAA,QAAA;AAAA,QAEL,MAAK;AAAA,QACL,cAAY;AAAA,QACZ,aAAU;AAAA,QACT,GAAG;AAAA,QAEH,UAAA,MAAM,KAAK,EAAE,QAAQ,UAAU,EAAE,IAAI,CAAC,GAAG,UACxC;AAAA,UAAC;AAAA,UAAA;AAAA,YAEC,WAAU;AAAA,YACV,OAAO;AAAA,cACL,OAAO,cAAc,OAAO;AAAA,cAC5B,QAAQ,cAAc,OAAO;AAAA,cAC7B,iBAAiB;AAAA,cACjB,WAAW,UAAU,OAAO,IAAI,iBAAiB;AAAA,cACjD,gBAAgB,GAAG,QAAQ,GAAG;AAAA,YAAA;AAAA,UAChC;AAAA,UARK;AAAA,QAAA,CAUR;AAAA,MAAA;AAAA,IAAA;AAAA,EAGP;AACF;AAEA,gBAAgB,cAAc;"}
+{"version":3,"file":"index28.js","sources":["../src/components/pulse/TypingIndicator.tsx"],"sourcesContent":["import { forwardRef } from 'react';\nimport { TypingIndicatorProps } from '../../types';\nimport { cn, normalizeSize, useReducedMotion, getEffectiveDuration, useLoaderVisibility } from '../../utils';\n\n/**\n * TypingIndicator - Chat typing indicator\n *\n * A loader for messaging/chat applications showing typing activity.\n *\n * @example\n * ```tsx\n * <TypingIndicator />\n * <TypingIndicator variant=\"fade\" />\n * <TypingIndicator dotCount={5} color=\"#3b82f6\" />\n * <TypingIndicator dotSize={10} gap={6} />\n * ```\n */\nexport const TypingIndicator = forwardRef<HTMLDivElement, TypingIndicatorProps>(\n  (\n    {\n      size,\n      color = '#3b82f6',\n      dotCount = 3,\n      dotSize = 8,\n      gap = 4,\n      variant = 'bounce',\n      speed = 'normal',\n      reverse = false,\n      respectMotionPreference = true,\n      delay = 0,\n      minDuration = 0,\n      transition,\n      className,\n      style,\n      testId = 'typing-indicator',\n      visible = true,\n      ariaLabel = 'Typing...',\n      ...rest\n    },\n    ref\n  ) => {\n    const prefersReducedMotion = useReducedMotion();\n    const effectiveDuration = getEffectiveDuration(speed, respectMotionPreference, prefersReducedMotion);\n    const { shouldRender, opacity, transitionStyle } = useLoaderVisibility(\n      visible,\n      delay,\n      minDuration,\n      transition\n    );\n\n    if (!shouldRender) return null;\n    const gapValue = normalizeSize(gap);\n\n    return (\n      <div\n        ref={ref}\n        data-testid={testId}\n        className={cn('inline-flex items-center', className)}\n        style={{\n          gap: gapValue,\n          height: size ? normalizeSize(size) : 'auto',\n          ...style,\n          opacity,\n          transition: transitionStyle,\n        }}\n        role=\"status\"\n        aria-label={ariaLabel}\n        aria-busy=\"true\"\n        {...rest}\n      >\n        {Array.from({ length: dotCount }).map((_, index) => (\n          <div\n            key={index}\n            className=\"rounded-full\"\n            style={{\n              width: normalizeSize(dotSize),\n              height: normalizeSize(dotSize),\n              backgroundColor: color,\n              animation: `typing-${variant} ${effectiveDuration} ease-in-out infinite`,\n              animationDelay: reverse ? `${(dotCount - index - 1) * 0.2}s` : `${index * 0.2}s`,\n            }}\n          />\n        ))}\n      </div>\n    );\n  }\n);\n\nTypingIndicator.displayName = 'TypingIndicator';\n"],"names":[],"mappings":";;;;;AAiBO,MAAM,kBAAkB;AAAA,EAC7B,CACE;AAAA,IACE;AAAA,IACA,QAAQ;AAAA,IACR,WAAW;AAAA,IACX,UAAU;AAAA,IACV,MAAM;AAAA,IACN,UAAU;AAAA,IACV,QAAQ;AAAA,IACR,UAAU;AAAA,IACV,0BAA0B;AAAA,IAC1B,QAAQ;AAAA,IACR,cAAc;AAAA,IACd;AAAA,IACA;AAAA,IACA;AAAA,IACA,SAAS;AAAA,IACT,UAAU;AAAA,IACV,YAAY;AAAA,IACZ,GAAG;AAAA,EAAA,GAEL,QACG;AACH,UAAM,uBAAuB,iBAAA;AAC7B,UAAM,oBAAoB,qBAAqB,OAAO,yBAAyB,oBAAoB;AACnG,UAAM,EAAE,cAAc,SAAS,gBAAA,IAAoB;AAAA,MACjD;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IAAA;AAGF,QAAI,CAAC,aAAc,QAAO;AAC1B,UAAM,WAAW,cAAc,GAAG;AAElC,WACE;AAAA,MAAC;AAAA,MAAA;AAAA,QACC;AAAA,QACA,eAAa;AAAA,QACb,WAAW,GAAG,4BAA4B,SAAS;AAAA,QACnD,OAAO;AAAA,UACL,KAAK;AAAA,UACL,QAAQ,OAAO,cAAc,IAAI,IAAI;AAAA,UACrC,GAAG;AAAA,UACH;AAAA,UACA,YAAY;AAAA,QAAA;AAAA,QAEd,MAAK;AAAA,QACL,cAAY;AAAA,QACZ,aAAU;AAAA,QACT,GAAG;AAAA,QAEH,UAAA,MAAM,KAAK,EAAE,QAAQ,UAAU,EAAE,IAAI,CAAC,GAAG,UACxC;AAAA,UAAC;AAAA,UAAA;AAAA,YAEC,WAAU;AAAA,YACV,OAAO;AAAA,cACL,OAAO,cAAc,OAAO;AAAA,cAC5B,QAAQ,cAAc,OAAO;AAAA,cAC7B,iBAAiB;AAAA,cACjB,WAAW,UAAU,OAAO,IAAI,iBAAiB;AAAA,cACjD,gBAAgB,UAAU,IAAI,WAAW,QAAQ,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG;AAAA,YAAA;AAAA,UAC/E;AAAA,UARK;AAAA,QAAA,CAUR;AAAA,MAAA;AAAA,IAAA;AAAA,EAGP;AACF;AAEA,gBAAgB,cAAc;"}

package/dist/index29.cjs

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const jsxRuntime = require("react/jsx-runtime");
 const react = require("react");
+const hooks = require("./index31.cjs");
 const classNames = require("./index3.cjs");
 const LoaderOverlay = react.forwardRef(
   ({
@@ -12,6 +13,9 @@ const LoaderOverlay = react.forwardRef(
     backdropOpacity = 0.5,
     backdropColor = "#000000",
     blur = false,
+    delay = 0,
+    minDuration = 0,
+    transition,
     className,
     style,
     testId = "loader-overlay",
@@ -19,6 +23,12 @@ const LoaderOverlay = react.forwardRef(
     zIndex = 9999,
     ...rest
   }, ref) => {
+    const { shouldRender, opacity, transitionStyle } = hooks.useLoaderVisibility(
+      loading,
+      delay,
+      minDuration,
+      transition
+    );
     const backdropStyles = {
       backgroundColor: backdropColor,
       opacity: backdropOpacity,
@@ -35,7 +45,7 @@ const LoaderOverlay = react.forwardRef(
         ...rest,
         children: [
           children,
-          loading && /* @__PURE__ */ jsxRuntime.jsxs(
+          shouldRender && /* @__PURE__ */ jsxRuntime.jsxs(
             "div",
             {
               className: classNames.cn(
@@ -43,7 +53,9 @@ const LoaderOverlay = react.forwardRef(
                 position === "fixed" ? "fixed" : "absolute"
               ),
               style: {
-                zIndex
+                zIndex,
+                opacity,
+                transition: transitionStyle
               },
               role: "status",
               "aria-label": ariaLabel,

package/dist/index29.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index29.cjs","sources":["../src/components/overlay/LoaderOverlay.tsx"],"sourcesContent":["import { forwardRef } from 'react';\nimport { LoaderOverlayProps } from '../../types';\nimport { cn } from '../../utils';\n\n/**\n * LoaderOverlay - Overlay wrapper for displaying loaders over content\n *\n * A flexible overlay component that displays a loader over content during loading states.\n * Supports both full-screen and container-relative positioning.\n *\n * @example\n * ```tsx\n * // Full screen overlay\n * <LoaderOverlay loading={isLoading} loader={<SpinnerCircle />}>\n *   <YourContent />\n * </LoaderOverlay>\n *\n * // Container overlay with custom backdrop\n * <LoaderOverlay\n *   loading={isLoading}\n *   loader={<SpinnerRing />}\n *   position=\"absolute\"\n *   backdropOpacity={0.7}\n *   blur\n * >\n *   <YourContent />\n * </LoaderOverlay>\n * ```\n */\nexport const LoaderOverlay = forwardRef<HTMLDivElement, LoaderOverlayProps>(\n  (\n    {\n      loading = false,\n      loader,\n      children,\n      position = 'fixed',\n      backdropOpacity = 0.5,\n      backdropColor = '#000000',\n      blur = false,\n      className,\n      style,\n      testId = 'loader-overlay',\n      ariaLabel = 'Loading content...',\n      zIndex = 9999,\n      ...rest\n    },\n    ref\n  ) => {\n    const backdropStyles = {\n      backgroundColor: backdropColor,\n      opacity: backdropOpacity,\n      backdropFilter: blur ? 'blur(4px)' : undefined,\n      WebkitBackdropFilter: blur ? 'blur(4px)' : undefined,\n    };\n\n    return (\n      <div\n        ref={ref}\n        data-testid={testId}\n        className={cn('relative', className)}\n        style={style}\n        {...rest}\n      >\n        {children}\n\n        {loading && (\n          <div\n            className={cn(\n              'inset-0 flex items-center justify-center',\n              position === 'fixed' ? 'fixed' : 'absolute'\n            )}\n            style={{\n              zIndex,\n            }}\n            role=\"status\"\n            aria-label={ariaLabel}\n            aria-busy=\"true\"\n          >\n            {/* Backdrop */}\n            <div\n              className=\"absolute inset-0\"\n              style={backdropStyles}\n              aria-hidden=\"true\"\n            />\n\n            {/* Loader */}\n            <div className=\"relative z-10\">{loader}</div>\n          </div>\n        )}\n      </div>\n    );\n  }\n);\n\nLoaderOverlay.displayName = 'LoaderOverlay';\n"],"names":["forwardRef","jsxs","cn","jsx"],"mappings":";;;;;AA6BO,MAAM,gBAAgBA,MAAAA;AAAAA,EAC3B,CACE;AAAA,IACE,UAAU;AAAA,IACV;AAAA,IACA;AAAA,IACA,WAAW;AAAA,IACX,kBAAkB;AAAA,IAClB,gBAAgB;AAAA,IAChB,OAAO;AAAA,IACP;AAAA,IACA;AAAA,IACA,SAAS;AAAA,IACT,YAAY;AAAA,IACZ,SAAS;AAAA,IACT,GAAG;AAAA,EAAA,GAEL,QACG;AACH,UAAM,iBAAiB;AAAA,MACrB,iBAAiB;AAAA,MACjB,SAAS;AAAA,MACT,gBAAgB,OAAO,cAAc;AAAA,MACrC,sBAAsB,OAAO,cAAc;AAAA,IAAA;AAG7C,WACEC,2BAAAA;AAAAA,MAAC;AAAA,MAAA;AAAA,QACC;AAAA,QACA,eAAa;AAAA,QACb,WAAWC,WAAAA,GAAG,YAAY,SAAS;AAAA,QACnC;AAAA,QACC,GAAG;AAAA,QAEH,UAAA;AAAA,UAAA;AAAA,UAEA,WACCD,2BAAAA;AAAAA,YAAC;AAAA,YAAA;AAAA,cACC,WAAWC,WAAAA;AAAAA,gBACT;AAAA,gBACA,aAAa,UAAU,UAAU;AAAA,cAAA;AAAA,cAEnC,OAAO;AAAA,gBACL;AAAA,cAAA;AAAA,cAEF,MAAK;AAAA,cACL,cAAY;AAAA,cACZ,aAAU;AAAA,cAGV,UAAA;AAAA,gBAAAC,2BAAAA;AAAAA,kBAAC;AAAA,kBAAA;AAAA,oBACC,WAAU;AAAA,oBACV,OAAO;AAAA,oBACP,eAAY;AAAA,kBAAA;AAAA,gBAAA;AAAA,gBAIdA,2BAAAA,IAAC,OAAA,EAAI,WAAU,iBAAiB,UAAA,OAAA,CAAO;AAAA,cAAA;AAAA,YAAA;AAAA,UAAA;AAAA,QACzC;AAAA,MAAA;AAAA,IAAA;AAAA,EAIR;AACF;AAEA,cAAc,cAAc;;"}
+{"version":3,"file":"index29.cjs","sources":["../src/components/overlay/LoaderOverlay.tsx"],"sourcesContent":["import { forwardRef } from 'react';\nimport { LoaderOverlayProps } from '../../types';\nimport { cn, useLoaderVisibility } from '../../utils';\n\n/**\n * LoaderOverlay - Overlay wrapper for displaying loaders over content\n *\n * A flexible overlay component that displays a loader over content during loading states.\n * Supports both full-screen and container-relative positioning.\n *\n * @example\n * ```tsx\n * // Full screen overlay\n * <LoaderOverlay loading={isLoading} loader={<SpinnerCircle />}>\n *   <YourContent />\n * </LoaderOverlay>\n *\n * // Container overlay with custom backdrop\n * <LoaderOverlay\n *   loading={isLoading}\n *   loader={<SpinnerRing />}\n *   position=\"absolute\"\n *   backdropOpacity={0.7}\n *   blur\n * >\n *   <YourContent />\n * </LoaderOverlay>\n * ```\n */\nexport const LoaderOverlay = forwardRef<HTMLDivElement, LoaderOverlayProps>(\n  (\n    {\n      loading = false,\n      loader,\n      children,\n      position = 'fixed',\n      backdropOpacity = 0.5,\n      backdropColor = '#000000',\n      blur = false,\n      delay = 0,\n      minDuration = 0,\n      transition,\n      className,\n      style,\n      testId = 'loader-overlay',\n      ariaLabel = 'Loading content...',\n      zIndex = 9999,\n      ...rest\n    },\n    ref\n  ) => {\n    const { shouldRender, opacity, transitionStyle } = useLoaderVisibility(\n      loading,\n      delay,\n      minDuration,\n      transition\n    );\n\n    const backdropStyles = {\n      backgroundColor: backdropColor,\n      opacity: backdropOpacity,\n      backdropFilter: blur ? 'blur(4px)' : undefined,\n      WebkitBackdropFilter: blur ? 'blur(4px)' : undefined,\n    };\n\n    return (\n      <div\n        ref={ref}\n        data-testid={testId}\n        className={cn('relative', className)}\n        style={style}\n        {...rest}\n      >\n        {children}\n\n        {shouldRender && (\n          <div\n            className={cn(\n              'inset-0 flex items-center justify-center',\n              position === 'fixed' ? 'fixed' : 'absolute'\n            )}\n            style={{\n              zIndex,\n              opacity,\n              transition: transitionStyle,\n            }}\n            role=\"status\"\n            aria-label={ariaLabel}\n            aria-busy=\"true\"\n          >\n            {/* Backdrop */}\n            <div\n              className=\"absolute inset-0\"\n              style={backdropStyles}\n              aria-hidden=\"true\"\n            />\n\n            {/* Loader */}\n            <div className=\"relative z-10\">{loader}</div>\n          </div>\n        )}\n      </div>\n    );\n  }\n);\n\nLoaderOverlay.displayName = 'LoaderOverlay';\n"],"names":["forwardRef","useLoaderVisibility","jsxs","cn","jsx"],"mappings":";;;;;;AA6BO,MAAM,gBAAgBA,MAAAA;AAAAA,EAC3B,CACE;AAAA,IACE,UAAU;AAAA,IACV;AAAA,IACA;AAAA,IACA,WAAW;AAAA,IACX,kBAAkB;AAAA,IAClB,gBAAgB;AAAA,IAChB,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,cAAc;AAAA,IACd;AAAA,IACA;AAAA,IACA;AAAA,IACA,SAAS;AAAA,IACT,YAAY;AAAA,IACZ,SAAS;AAAA,IACT,GAAG;AAAA,EAAA,GAEL,QACG;AACH,UAAM,EAAE,cAAc,SAAS,gBAAA,IAAoBC,MAAAA;AAAAA,MACjD;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IAAA;AAGF,UAAM,iBAAiB;AAAA,MACrB,iBAAiB;AAAA,MACjB,SAAS;AAAA,MACT,gBAAgB,OAAO,cAAc;AAAA,MACrC,sBAAsB,OAAO,cAAc;AAAA,IAAA;AAG7C,WACEC,2BAAAA;AAAAA,MAAC;AAAA,MAAA;AAAA,QACC;AAAA,QACA,eAAa;AAAA,QACb,WAAWC,WAAAA,GAAG,YAAY,SAAS;AAAA,QACnC;AAAA,QACC,GAAG;AAAA,QAEH,UAAA;AAAA,UAAA;AAAA,UAEA,gBACCD,2BAAAA;AAAAA,YAAC;AAAA,YAAA;AAAA,cACC,WAAWC,WAAAA;AAAAA,gBACT;AAAA,gBACA,aAAa,UAAU,UAAU;AAAA,cAAA;AAAA,cAEnC,OAAO;AAAA,gBACL;AAAA,gBACA;AAAA,gBACA,YAAY;AAAA,cAAA;AAAA,cAEd,MAAK;AAAA,cACL,cAAY;AAAA,cACZ,aAAU;AAAA,cAGV,UAAA;AAAA,gBAAAC,2BAAAA;AAAAA,kBAAC;AAAA,kBAAA;AAAA,oBACC,WAAU;AAAA,oBACV,OAAO;AAAA,oBACP,eAAY;AAAA,kBAAA;AAAA,gBAAA;AAAA,gBAIdA,2BAAAA,IAAC,OAAA,EAAI,WAAU,iBAAiB,UAAA,OAAA,CAAO;AAAA,cAAA;AAAA,YAAA;AAAA,UAAA;AAAA,QACzC;AAAA,MAAA;AAAA,IAAA;AAAA,EAIR;AACF;AAEA,cAAc,cAAc;;"}

package/dist/index29.js

@@ -1,5 +1,6 @@
 import { jsxs, jsx } from "react/jsx-runtime";
 import { forwardRef } from "react";
+import { useLoaderVisibility } from "./index31.js";
 import { cn } from "./index3.js";
 const LoaderOverlay = forwardRef(
   ({
@@ -10,6 +11,9 @@ const LoaderOverlay = forwardRef(
     backdropOpacity = 0.5,
     backdropColor = "#000000",
     blur = false,
+    delay = 0,
+    minDuration = 0,
+    transition,
     className,
     style,
     testId = "loader-overlay",
@@ -17,6 +21,12 @@ const LoaderOverlay = forwardRef(
     zIndex = 9999,
     ...rest
   }, ref) => {
+    const { shouldRender, opacity, transitionStyle } = useLoaderVisibility(
+      loading,
+      delay,
+      minDuration,
+      transition
+    );
     const backdropStyles = {
       backgroundColor: backdropColor,
       opacity: backdropOpacity,
@@ -33,7 +43,7 @@ const LoaderOverlay = forwardRef(
         ...rest,
         children: [
           children,
-          loading && /* @__PURE__ */ jsxs(
+          shouldRender && /* @__PURE__ */ jsxs(
             "div",
             {
               className: cn(
@@ -41,7 +51,9 @@ const LoaderOverlay = forwardRef(
                 position === "fixed" ? "fixed" : "absolute"
               ),
               style: {
-                zIndex
+                zIndex,
+                opacity,
+                transition: transitionStyle
               },
               role: "status",
               "aria-label": ariaLabel,

package/dist/index29.js.map

@@ -1 +1 @@
-{"version":3,"file":"index29.js","sources":["../src/components/overlay/LoaderOverlay.tsx"],"sourcesContent":["import { forwardRef } from 'react';\nimport { LoaderOverlayProps } from '../../types';\nimport { cn } from '../../utils';\n\n/**\n * LoaderOverlay - Overlay wrapper for displaying loaders over content\n *\n * A flexible overlay component that displays a loader over content during loading states.\n * Supports both full-screen and container-relative positioning.\n *\n * @example\n * ```tsx\n * // Full screen overlay\n * <LoaderOverlay loading={isLoading} loader={<SpinnerCircle />}>\n *   <YourContent />\n * </LoaderOverlay>\n *\n * // Container overlay with custom backdrop\n * <LoaderOverlay\n *   loading={isLoading}\n *   loader={<SpinnerRing />}\n *   position=\"absolute\"\n *   backdropOpacity={0.7}\n *   blur\n * >\n *   <YourContent />\n * </LoaderOverlay>\n * ```\n */\nexport const LoaderOverlay = forwardRef<HTMLDivElement, LoaderOverlayProps>(\n  (\n    {\n      loading = false,\n      loader,\n      children,\n      position = 'fixed',\n      backdropOpacity = 0.5,\n      backdropColor = '#000000',\n      blur = false,\n      className,\n      style,\n      testId = 'loader-overlay',\n      ariaLabel = 'Loading content...',\n      zIndex = 9999,\n      ...rest\n    },\n    ref\n  ) => {\n    const backdropStyles = {\n      backgroundColor: backdropColor,\n      opacity: backdropOpacity,\n      backdropFilter: blur ? 'blur(4px)' : undefined,\n      WebkitBackdropFilter: blur ? 'blur(4px)' : undefined,\n    };\n\n    return (\n      <div\n        ref={ref}\n        data-testid={testId}\n        className={cn('relative', className)}\n        style={style}\n        {...rest}\n      >\n        {children}\n\n        {loading && (\n          <div\n            className={cn(\n              'inset-0 flex items-center justify-center',\n              position === 'fixed' ? 'fixed' : 'absolute'\n            )}\n            style={{\n              zIndex,\n            }}\n            role=\"status\"\n            aria-label={ariaLabel}\n            aria-busy=\"true\"\n          >\n            {/* Backdrop */}\n            <div\n              className=\"absolute inset-0\"\n              style={backdropStyles}\n              aria-hidden=\"true\"\n            />\n\n            {/* Loader */}\n            <div className=\"relative z-10\">{loader}</div>\n          </div>\n        )}\n      </div>\n    );\n  }\n);\n\nLoaderOverlay.displayName = 'LoaderOverlay';\n"],"names":[],"mappings":";;;AA6BO,MAAM,gBAAgB;AAAA,EAC3B,CACE;AAAA,IACE,UAAU;AAAA,IACV;AAAA,IACA;AAAA,IACA,WAAW;AAAA,IACX,kBAAkB;AAAA,IAClB,gBAAgB;AAAA,IAChB,OAAO;AAAA,IACP;AAAA,IACA;AAAA,IACA,SAAS;AAAA,IACT,YAAY;AAAA,IACZ,SAAS;AAAA,IACT,GAAG;AAAA,EAAA,GAEL,QACG;AACH,UAAM,iBAAiB;AAAA,MACrB,iBAAiB;AAAA,MACjB,SAAS;AAAA,MACT,gBAAgB,OAAO,cAAc;AAAA,MACrC,sBAAsB,OAAO,cAAc;AAAA,IAAA;AAG7C,WACE;AAAA,MAAC;AAAA,MAAA;AAAA,QACC;AAAA,QACA,eAAa;AAAA,QACb,WAAW,GAAG,YAAY,SAAS;AAAA,QACnC;AAAA,QACC,GAAG;AAAA,QAEH,UAAA;AAAA,UAAA;AAAA,UAEA,WACC;AAAA,YAAC;AAAA,YAAA;AAAA,cACC,WAAW;AAAA,gBACT;AAAA,gBACA,aAAa,UAAU,UAAU;AAAA,cAAA;AAAA,cAEnC,OAAO;AAAA,gBACL;AAAA,cAAA;AAAA,cAEF,MAAK;AAAA,cACL,cAAY;AAAA,cACZ,aAAU;AAAA,cAGV,UAAA;AAAA,gBAAA;AAAA,kBAAC;AAAA,kBAAA;AAAA,oBACC,WAAU;AAAA,oBACV,OAAO;AAAA,oBACP,eAAY;AAAA,kBAAA;AAAA,gBAAA;AAAA,gBAId,oBAAC,OAAA,EAAI,WAAU,iBAAiB,UAAA,OAAA,CAAO;AAAA,cAAA;AAAA,YAAA;AAAA,UAAA;AAAA,QACzC;AAAA,MAAA;AAAA,IAAA;AAAA,EAIR;AACF;AAEA,cAAc,cAAc;"}
+{"version":3,"file":"index29.js","sources":["../src/components/overlay/LoaderOverlay.tsx"],"sourcesContent":["import { forwardRef } from 'react';\nimport { LoaderOverlayProps } from '../../types';\nimport { cn, useLoaderVisibility } from '../../utils';\n\n/**\n * LoaderOverlay - Overlay wrapper for displaying loaders over content\n *\n * A flexible overlay component that displays a loader over content during loading states.\n * Supports both full-screen and container-relative positioning.\n *\n * @example\n * ```tsx\n * // Full screen overlay\n * <LoaderOverlay loading={isLoading} loader={<SpinnerCircle />}>\n *   <YourContent />\n * </LoaderOverlay>\n *\n * // Container overlay with custom backdrop\n * <LoaderOverlay\n *   loading={isLoading}\n *   loader={<SpinnerRing />}\n *   position=\"absolute\"\n *   backdropOpacity={0.7}\n *   blur\n * >\n *   <YourContent />\n * </LoaderOverlay>\n * ```\n */\nexport const LoaderOverlay = forwardRef<HTMLDivElement, LoaderOverlayProps>(\n  (\n    {\n      loading = false,\n      loader,\n      children,\n      position = 'fixed',\n      backdropOpacity = 0.5,\n      backdropColor = '#000000',\n      blur = false,\n      delay = 0,\n      minDuration = 0,\n      transition,\n      className,\n      style,\n      testId = 'loader-overlay',\n      ariaLabel = 'Loading content...',\n      zIndex = 9999,\n      ...rest\n    },\n    ref\n  ) => {\n    const { shouldRender, opacity, transitionStyle } = useLoaderVisibility(\n      loading,\n      delay,\n      minDuration,\n      transition\n    );\n\n    const backdropStyles = {\n      backgroundColor: backdropColor,\n      opacity: backdropOpacity,\n      backdropFilter: blur ? 'blur(4px)' : undefined,\n      WebkitBackdropFilter: blur ? 'blur(4px)' : undefined,\n    };\n\n    return (\n      <div\n        ref={ref}\n        data-testid={testId}\n        className={cn('relative', className)}\n        style={style}\n        {...rest}\n      >\n        {children}\n\n        {shouldRender && (\n          <div\n            className={cn(\n              'inset-0 flex items-center justify-center',\n              position === 'fixed' ? 'fixed' : 'absolute'\n            )}\n            style={{\n              zIndex,\n              opacity,\n              transition: transitionStyle,\n            }}\n            role=\"status\"\n            aria-label={ariaLabel}\n            aria-busy=\"true\"\n          >\n            {/* Backdrop */}\n            <div\n              className=\"absolute inset-0\"\n              style={backdropStyles}\n              aria-hidden=\"true\"\n            />\n\n            {/* Loader */}\n            <div className=\"relative z-10\">{loader}</div>\n          </div>\n        )}\n      </div>\n    );\n  }\n);\n\nLoaderOverlay.displayName = 'LoaderOverlay';\n"],"names":[],"mappings":";;;;AA6BO,MAAM,gBAAgB;AAAA,EAC3B,CACE;AAAA,IACE,UAAU;AAAA,IACV;AAAA,IACA;AAAA,IACA,WAAW;AAAA,IACX,kBAAkB;AAAA,IAClB,gBAAgB;AAAA,IAChB,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,cAAc;AAAA,IACd;AAAA,IACA;AAAA,IACA;AAAA,IACA,SAAS;AAAA,IACT,YAAY;AAAA,IACZ,SAAS;AAAA,IACT,GAAG;AAAA,EAAA,GAEL,QACG;AACH,UAAM,EAAE,cAAc,SAAS,gBAAA,IAAoB;AAAA,MACjD;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IAAA;AAGF,UAAM,iBAAiB;AAAA,MACrB,iBAAiB;AAAA,MACjB,SAAS;AAAA,MACT,gBAAgB,OAAO,cAAc;AAAA,MACrC,sBAAsB,OAAO,cAAc;AAAA,IAAA;AAG7C,WACE;AAAA,MAAC;AAAA,MAAA;AAAA,QACC;AAAA,QACA,eAAa;AAAA,QACb,WAAW,GAAG,YAAY,SAAS;AAAA,QACnC;AAAA,QACC,GAAG;AAAA,QAEH,UAAA;AAAA,UAAA;AAAA,UAEA,gBACC;AAAA,YAAC;AAAA,YAAA;AAAA,cACC,WAAW;AAAA,gBACT;AAAA,gBACA,aAAa,UAAU,UAAU;AAAA,cAAA;AAAA,cAEnC,OAAO;AAAA,gBACL;AAAA,gBACA;AAAA,gBACA,YAAY;AAAA,cAAA;AAAA,cAEd,MAAK;AAAA,cACL,cAAY;AAAA,cACZ,aAAU;AAAA,cAGV,UAAA;AAAA,gBAAA;AAAA,kBAAC;AAAA,kBAAA;AAAA,oBACC,WAAU;AAAA,oBACV,OAAO;AAAA,oBACP,eAAY;AAAA,kBAAA;AAAA,gBAAA;AAAA,gBAId,oBAAC,OAAA,EAAI,WAAU,iBAAiB,UAAA,OAAA,CAAO;AAAA,cAAA;AAAA,YAAA;AAAA,UAAA;AAAA,QACzC;AAAA,MAAA;AAAA,IAAA;AAAA,EAIR;AACF;AAEA,cAAc,cAAc;"}

package/dist/index31.cjs

@@ -0,0 +1,126 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const react = require("react");
+function useReducedMotion() {
+  const [prefersReducedMotion, setPrefersReducedMotion] = react.useState(false);
+  react.useEffect(() => {
+    if (typeof window === "undefined" || !window.matchMedia) {
+      return;
+    }
+    const mediaQuery = window.matchMedia("(prefers-reduced-motion: reduce)");
+    setPrefersReducedMotion(mediaQuery.matches);
+    const handleChange = (event) => {
+      setPrefersReducedMotion(event.matches);
+    };
+    if (mediaQuery.addEventListener) {
+      mediaQuery.addEventListener("change", handleChange);
+      return () => mediaQuery.removeEventListener("change", handleChange);
+    } else {
+      mediaQuery.addListener(handleChange);
+      return () => mediaQuery.removeListener(handleChange);
+    }
+  }, []);
+  return prefersReducedMotion;
+}
+function getEffectiveDuration(speed, respectMotionPreference, prefersReducedMotion) {
+  if (respectMotionPreference && prefersReducedMotion) {
+    return "0.01ms";
+  }
+  if (typeof speed === "number") {
+    const validSpeed = !isNaN(speed) && speed > 0 ? Math.max(50, Math.min(1e4, speed)) : 1e3;
+    return `${validSpeed}ms`;
+  }
+  const speedMap = {
+    slow: "2s",
+    normal: "1s",
+    fast: "0.5s"
+  };
+  return speedMap[speed] || speedMap.normal;
+}
+function useLoaderVisibility(visible = true, delay = 0, minDuration = 0, transition) {
+  const transitionDuration = transition === true ? 150 : typeof transition === "number" ? transition : 0;
+  const hasTransition = transitionDuration > 0;
+  const [shouldRender, setShouldRender] = react.useState(visible && delay === 0);
+  const [isTransitioning, setIsTransitioning] = react.useState(visible && delay === 0 && hasTransition);
+  const showTimeRef = react.useRef(visible && delay === 0 ? Date.now() : null);
+  const delayTimerRef = react.useRef(null);
+  const minDurationTimerRef = react.useRef(null);
+  const transitionTimerRef = react.useRef(null);
+  react.useEffect(() => {
+    if (delayTimerRef.current) {
+      clearTimeout(delayTimerRef.current);
+      delayTimerRef.current = null;
+    }
+    if (minDurationTimerRef.current) {
+      clearTimeout(minDurationTimerRef.current);
+      minDurationTimerRef.current = null;
+    }
+    if (transitionTimerRef.current) {
+      clearTimeout(transitionTimerRef.current);
+      transitionTimerRef.current = null;
+    }
+    if (visible) {
+      if (delay > 0) {
+        delayTimerRef.current = setTimeout(() => {
+          setShouldRender(true);
+          showTimeRef.current = Date.now();
+          if (hasTransition) {
+            setIsTransitioning(true);
+          }
+        }, delay);
+      } else {
+        setShouldRender(true);
+        showTimeRef.current = Date.now();
+        if (hasTransition) {
+          setIsTransitioning(true);
+        }
+      }
+    } else {
+      const hideLoader = () => {
+        if (hasTransition) {
+          setIsTransitioning(false);
+          transitionTimerRef.current = setTimeout(() => {
+            setShouldRender(false);
+            showTimeRef.current = null;
+          }, transitionDuration);
+        } else {
+          setShouldRender(false);
+          showTimeRef.current = null;
+        }
+      };
+      if (showTimeRef.current !== null && minDuration > 0) {
+        const elapsedTime = Date.now() - showTimeRef.current;
+        const remainingTime = minDuration - elapsedTime;
+        if (remainingTime > 0) {
+          minDurationTimerRef.current = setTimeout(hideLoader, remainingTime);
+        } else {
+          hideLoader();
+        }
+      } else {
+        hideLoader();
+      }
+    }
+    return () => {
+      if (delayTimerRef.current) {
+        clearTimeout(delayTimerRef.current);
+      }
+      if (minDurationTimerRef.current) {
+        clearTimeout(minDurationTimerRef.current);
+      }
+      if (transitionTimerRef.current) {
+        clearTimeout(transitionTimerRef.current);
+      }
+    };
+  }, [visible, delay, minDuration, hasTransition, transitionDuration]);
+  const opacity = hasTransition ? isTransitioning ? 1 : 0 : 1;
+  const transitionStyle = hasTransition ? `opacity ${transitionDuration}ms ease-in-out` : "none";
+  return {
+    shouldRender,
+    opacity,
+    transitionStyle
+  };
+}
+exports.getEffectiveDuration = getEffectiveDuration;
+exports.useLoaderVisibility = useLoaderVisibility;
+exports.useReducedMotion = useReducedMotion;
+//# sourceMappingURL=index31.cjs.map

package/dist/index31.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index31.cjs","sources":["../src/utils/hooks.ts"],"sourcesContent":["import { useEffect, useState, useRef } from 'react';\n\n/**\n * Hook to detect user's reduced motion preference\n * Returns true if user prefers reduced motion\n */\nexport function useReducedMotion(): boolean {\n  const [prefersReducedMotion, setPrefersReducedMotion] = useState(false);\n\n  useEffect(() => {\n    // Check if matchMedia is available (SSR safety)\n    if (typeof window === 'undefined' || !window.matchMedia) {\n      return;\n    }\n\n    const mediaQuery = window.matchMedia('(prefers-reduced-motion: reduce)');\n\n    // Set initial value\n    setPrefersReducedMotion(mediaQuery.matches);\n\n    // Listen for changes\n    const handleChange = (event: MediaQueryListEvent) => {\n      setPrefersReducedMotion(event.matches);\n    };\n\n    // Use addEventListener if available (modern browsers)\n    if (mediaQuery.addEventListener) {\n      mediaQuery.addEventListener('change', handleChange);\n      return () => mediaQuery.removeEventListener('change', handleChange);\n    } else {\n      // Fallback for older browsers\n      mediaQuery.addListener(handleChange);\n      return () => mediaQuery.removeListener(handleChange);\n    }\n  }, []);\n\n  return prefersReducedMotion;\n}\n\n/**\n * Get effective animation duration based on speed and reduced motion preference\n */\nexport function getEffectiveDuration(\n  speed: 'slow' | 'normal' | 'fast' | number,\n  respectMotionPreference: boolean,\n  prefersReducedMotion: boolean\n): string {\n  // If user prefers reduced motion and we should respect it, use a very short duration\n  if (respectMotionPreference && prefersReducedMotion) {\n    return '0.01ms';\n  }\n\n  if (typeof speed === 'number') {\n    const validSpeed = !isNaN(speed) && speed > 0 ? Math.max(50, Math.min(10000, speed)) : 1000;\n    return `${validSpeed}ms`;\n  }\n\n  const speedMap = {\n    slow: '2s',\n    normal: '1s',\n    fast: '0.5s',\n  };\n\n  return speedMap[speed] || speedMap.normal;\n}\n\n/**\n * Hook to manage loader visibility with delay, minimum duration, and transitions\n * Prevents flashing on fast loads and jarring quick disappears\n */\nexport function useLoaderVisibility(\n  visible: boolean = true,\n  delay: number = 0,\n  minDuration: number = 0,\n  transition?: boolean | number\n): {\n  shouldRender: boolean;\n  opacity: number;\n  transitionStyle: string;\n} {\n  // Calculate transition duration\n  const transitionDuration =\n    transition === true ? 150 : typeof transition === 'number' ? transition : 0;\n  const hasTransition = transitionDuration > 0;\n\n  // Initialize shouldRender based on visible state and delay\n  // If visible and no delay, render immediately; otherwise start hidden\n  const [shouldRender, setShouldRender] = useState(visible && delay === 0);\n  const [isTransitioning, setIsTransitioning] = useState(visible && delay === 0 && hasTransition);\n  const showTimeRef = useRef<number | null>(visible && delay === 0 ? Date.now() : null);\n  const delayTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const minDurationTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const transitionTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n\n  useEffect(() => {\n    // Clear any existing timers\n    if (delayTimerRef.current) {\n      clearTimeout(delayTimerRef.current);\n      delayTimerRef.current = null;\n    }\n    if (minDurationTimerRef.current) {\n      clearTimeout(minDurationTimerRef.current);\n      minDurationTimerRef.current = null;\n    }\n    if (transitionTimerRef.current) {\n      clearTimeout(transitionTimerRef.current);\n      transitionTimerRef.current = null;\n    }\n\n    if (visible) {\n      // Show loader after delay\n      if (delay > 0) {\n        delayTimerRef.current = setTimeout(() => {\n          setShouldRender(true);\n          showTimeRef.current = Date.now();\n          // Trigger transition\n          if (hasTransition) {\n            setIsTransitioning(true);\n          }\n        }, delay);\n      } else {\n        setShouldRender(true);\n        showTimeRef.current = Date.now();\n        // Trigger transition\n        if (hasTransition) {\n          setIsTransitioning(true);\n        }\n      }\n    } else {\n      // Hide loader, but respect minimum duration if it was shown\n      const hideLoader = () => {\n        if (hasTransition) {\n          setIsTransitioning(false);\n          // Wait for transition to complete before unmounting\n          transitionTimerRef.current = setTimeout(() => {\n            setShouldRender(false);\n            showTimeRef.current = null;\n          }, transitionDuration);\n        } else {\n          setShouldRender(false);\n          showTimeRef.current = null;\n        }\n      };\n\n      if (showTimeRef.current !== null && minDuration > 0) {\n        const elapsedTime = Date.now() - showTimeRef.current;\n        const remainingTime = minDuration - elapsedTime;\n\n        if (remainingTime > 0) {\n          minDurationTimerRef.current = setTimeout(hideLoader, remainingTime);\n        } else {\n          hideLoader();\n        }\n      } else {\n        hideLoader();\n      }\n    }\n\n    // Cleanup timers on unmount or when dependencies change\n    return () => {\n      if (delayTimerRef.current) {\n        clearTimeout(delayTimerRef.current);\n      }\n      if (minDurationTimerRef.current) {\n        clearTimeout(minDurationTimerRef.current);\n      }\n      if (transitionTimerRef.current) {\n        clearTimeout(transitionTimerRef.current);\n      }\n    };\n  }, [visible, delay, minDuration, hasTransition, transitionDuration]);\n\n  // Calculate opacity based on transition state\n  const opacity = hasTransition ? (isTransitioning ? 1 : 0) : 1;\n\n  // Build transition style\n  const transitionStyle = hasTransition\n    ? `opacity ${transitionDuration}ms ease-in-out`\n    : 'none';\n\n  return {\n    shouldRender,\n    opacity,\n    transitionStyle,\n  };\n}\n"],"names":["useState","useEffect","useRef"],"mappings":"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"}

package/dist/index31.js

@@ -0,0 +1,126 @@
+import { useState, useRef, useEffect } from "react";
+function useReducedMotion() {
+  const [prefersReducedMotion, setPrefersReducedMotion] = useState(false);
+  useEffect(() => {
+    if (typeof window === "undefined" || !window.matchMedia) {
+      return;
+    }
+    const mediaQuery = window.matchMedia("(prefers-reduced-motion: reduce)");
+    setPrefersReducedMotion(mediaQuery.matches);
+    const handleChange = (event) => {
+      setPrefersReducedMotion(event.matches);
+    };
+    if (mediaQuery.addEventListener) {
+      mediaQuery.addEventListener("change", handleChange);
+      return () => mediaQuery.removeEventListener("change", handleChange);
+    } else {
+      mediaQuery.addListener(handleChange);
+      return () => mediaQuery.removeListener(handleChange);
+    }
+  }, []);
+  return prefersReducedMotion;
+}
+function getEffectiveDuration(speed, respectMotionPreference, prefersReducedMotion) {
+  if (respectMotionPreference && prefersReducedMotion) {
+    return "0.01ms";
+  }
+  if (typeof speed === "number") {
+    const validSpeed = !isNaN(speed) && speed > 0 ? Math.max(50, Math.min(1e4, speed)) : 1e3;
+    return `${validSpeed}ms`;
+  }
+  const speedMap = {
+    slow: "2s",
+    normal: "1s",
+    fast: "0.5s"
+  };
+  return speedMap[speed] || speedMap.normal;
+}
+function useLoaderVisibility(visible = true, delay = 0, minDuration = 0, transition) {
+  const transitionDuration = transition === true ? 150 : typeof transition === "number" ? transition : 0;
+  const hasTransition = transitionDuration > 0;
+  const [shouldRender, setShouldRender] = useState(visible && delay === 0);
+  const [isTransitioning, setIsTransitioning] = useState(visible && delay === 0 && hasTransition);
+  const showTimeRef = useRef(visible && delay === 0 ? Date.now() : null);
+  const delayTimerRef = useRef(null);
+  const minDurationTimerRef = useRef(null);
+  const transitionTimerRef = useRef(null);
+  useEffect(() => {
+    if (delayTimerRef.current) {
+      clearTimeout(delayTimerRef.current);
+      delayTimerRef.current = null;
+    }
+    if (minDurationTimerRef.current) {
+      clearTimeout(minDurationTimerRef.current);
+      minDurationTimerRef.current = null;
+    }
+    if (transitionTimerRef.current) {
+      clearTimeout(transitionTimerRef.current);
+      transitionTimerRef.current = null;
+    }
+    if (visible) {
+      if (delay > 0) {
+        delayTimerRef.current = setTimeout(() => {
+          setShouldRender(true);
+          showTimeRef.current = Date.now();
+          if (hasTransition) {
+            setIsTransitioning(true);
+          }
+        }, delay);
+      } else {
+        setShouldRender(true);
+        showTimeRef.current = Date.now();
+        if (hasTransition) {
+          setIsTransitioning(true);
+        }
+      }
+    } else {
+      const hideLoader = () => {
+        if (hasTransition) {
+          setIsTransitioning(false);
+          transitionTimerRef.current = setTimeout(() => {
+            setShouldRender(false);
+            showTimeRef.current = null;
+          }, transitionDuration);
+        } else {
+          setShouldRender(false);
+          showTimeRef.current = null;
+        }
+      };
+      if (showTimeRef.current !== null && minDuration > 0) {
+        const elapsedTime = Date.now() - showTimeRef.current;
+        const remainingTime = minDuration - elapsedTime;
+        if (remainingTime > 0) {
+          minDurationTimerRef.current = setTimeout(hideLoader, remainingTime);
+        } else {
+          hideLoader();
+        }
+      } else {
+        hideLoader();
+      }
+    }
+    return () => {
+      if (delayTimerRef.current) {
+        clearTimeout(delayTimerRef.current);
+      }
+      if (minDurationTimerRef.current) {
+        clearTimeout(minDurationTimerRef.current);
+      }
+      if (transitionTimerRef.current) {
+        clearTimeout(transitionTimerRef.current);
+      }
+    };
+  }, [visible, delay, minDuration, hasTransition, transitionDuration]);
+  const opacity = hasTransition ? isTransitioning ? 1 : 0 : 1;
+  const transitionStyle = hasTransition ? `opacity ${transitionDuration}ms ease-in-out` : "none";
+  return {
+    shouldRender,
+    opacity,
+    transitionStyle
+  };
+}
+export {
+  getEffectiveDuration,
+  useLoaderVisibility,
+  useReducedMotion
+};
+//# sourceMappingURL=index31.js.map

package/dist/index31.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index31.js","sources":["../src/utils/hooks.ts"],"sourcesContent":["import { useEffect, useState, useRef } from 'react';\n\n/**\n * Hook to detect user's reduced motion preference\n * Returns true if user prefers reduced motion\n */\nexport function useReducedMotion(): boolean {\n  const [prefersReducedMotion, setPrefersReducedMotion] = useState(false);\n\n  useEffect(() => {\n    // Check if matchMedia is available (SSR safety)\n    if (typeof window === 'undefined' || !window.matchMedia) {\n      return;\n    }\n\n    const mediaQuery = window.matchMedia('(prefers-reduced-motion: reduce)');\n\n    // Set initial value\n    setPrefersReducedMotion(mediaQuery.matches);\n\n    // Listen for changes\n    const handleChange = (event: MediaQueryListEvent) => {\n      setPrefersReducedMotion(event.matches);\n    };\n\n    // Use addEventListener if available (modern browsers)\n    if (mediaQuery.addEventListener) {\n      mediaQuery.addEventListener('change', handleChange);\n      return () => mediaQuery.removeEventListener('change', handleChange);\n    } else {\n      // Fallback for older browsers\n      mediaQuery.addListener(handleChange);\n      return () => mediaQuery.removeListener(handleChange);\n    }\n  }, []);\n\n  return prefersReducedMotion;\n}\n\n/**\n * Get effective animation duration based on speed and reduced motion preference\n */\nexport function getEffectiveDuration(\n  speed: 'slow' | 'normal' | 'fast' | number,\n  respectMotionPreference: boolean,\n  prefersReducedMotion: boolean\n): string {\n  // If user prefers reduced motion and we should respect it, use a very short duration\n  if (respectMotionPreference && prefersReducedMotion) {\n    return '0.01ms';\n  }\n\n  if (typeof speed === 'number') {\n    const validSpeed = !isNaN(speed) && speed > 0 ? Math.max(50, Math.min(10000, speed)) : 1000;\n    return `${validSpeed}ms`;\n  }\n\n  const speedMap = {\n    slow: '2s',\n    normal: '1s',\n    fast: '0.5s',\n  };\n\n  return speedMap[speed] || speedMap.normal;\n}\n\n/**\n * Hook to manage loader visibility with delay, minimum duration, and transitions\n * Prevents flashing on fast loads and jarring quick disappears\n */\nexport function useLoaderVisibility(\n  visible: boolean = true,\n  delay: number = 0,\n  minDuration: number = 0,\n  transition?: boolean | number\n): {\n  shouldRender: boolean;\n  opacity: number;\n  transitionStyle: string;\n} {\n  // Calculate transition duration\n  const transitionDuration =\n    transition === true ? 150 : typeof transition === 'number' ? transition : 0;\n  const hasTransition = transitionDuration > 0;\n\n  // Initialize shouldRender based on visible state and delay\n  // If visible and no delay, render immediately; otherwise start hidden\n  const [shouldRender, setShouldRender] = useState(visible && delay === 0);\n  const [isTransitioning, setIsTransitioning] = useState(visible && delay === 0 && hasTransition);\n  const showTimeRef = useRef<number | null>(visible && delay === 0 ? Date.now() : null);\n  const delayTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const minDurationTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const transitionTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n\n  useEffect(() => {\n    // Clear any existing timers\n    if (delayTimerRef.current) {\n      clearTimeout(delayTimerRef.current);\n      delayTimerRef.current = null;\n    }\n    if (minDurationTimerRef.current) {\n      clearTimeout(minDurationTimerRef.current);\n      minDurationTimerRef.current = null;\n    }\n    if (transitionTimerRef.current) {\n      clearTimeout(transitionTimerRef.current);\n      transitionTimerRef.current = null;\n    }\n\n    if (visible) {\n      // Show loader after delay\n      if (delay > 0) {\n        delayTimerRef.current = setTimeout(() => {\n          setShouldRender(true);\n          showTimeRef.current = Date.now();\n          // Trigger transition\n          if (hasTransition) {\n            setIsTransitioning(true);\n          }\n        }, delay);\n      } else {\n        setShouldRender(true);\n        showTimeRef.current = Date.now();\n        // Trigger transition\n        if (hasTransition) {\n          setIsTransitioning(true);\n        }\n      }\n    } else {\n      // Hide loader, but respect minimum duration if it was shown\n      const hideLoader = () => {\n        if (hasTransition) {\n          setIsTransitioning(false);\n          // Wait for transition to complete before unmounting\n          transitionTimerRef.current = setTimeout(() => {\n            setShouldRender(false);\n            showTimeRef.current = null;\n          }, transitionDuration);\n        } else {\n          setShouldRender(false);\n          showTimeRef.current = null;\n        }\n      };\n\n      if (showTimeRef.current !== null && minDuration > 0) {\n        const elapsedTime = Date.now() - showTimeRef.current;\n        const remainingTime = minDuration - elapsedTime;\n\n        if (remainingTime > 0) {\n          minDurationTimerRef.current = setTimeout(hideLoader, remainingTime);\n        } else {\n          hideLoader();\n        }\n      } else {\n        hideLoader();\n      }\n    }\n\n    // Cleanup timers on unmount or when dependencies change\n    return () => {\n      if (delayTimerRef.current) {\n        clearTimeout(delayTimerRef.current);\n      }\n      if (minDurationTimerRef.current) {\n        clearTimeout(minDurationTimerRef.current);\n      }\n      if (transitionTimerRef.current) {\n        clearTimeout(transitionTimerRef.current);\n      }\n    };\n  }, [visible, delay, minDuration, hasTransition, transitionDuration]);\n\n  // Calculate opacity based on transition state\n  const opacity = hasTransition ? (isTransitioning ? 1 : 0) : 1;\n\n  // Build transition style\n  const transitionStyle = hasTransition\n    ? `opacity ${transitionDuration}ms ease-in-out`\n    : 'none';\n\n  return {\n    shouldRender,\n    opacity,\n    transitionStyle,\n  };\n}\n"],"names":[],"mappings":"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"}

package/dist/index4.cjs

@@ -27,6 +27,16 @@ function getAnimationDuration(speed = "normal") {
   return speedMap[speed] || speedMap.normal;
 }
 function normalizeSize(size) {
+  const sizePresetMap = {
+    xs: 16,
+    sm: 24,
+    md: 40,
+    lg: 56,
+    xl: 72
+  };
+  if (typeof size === "string" && size in sizePresetMap) {
+    return `${sizePresetMap[size]}px`;
+  }
   if (typeof size === "number") {
     return `${size}px`;
   }

package/dist/index4.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index4.cjs","sources":["../src/utils/colors.ts"],"sourcesContent":["/**\n * Check if a color is a valid hex color\n */\nexport function isHexColor(color: string): boolean {\n  return /^#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})$/.test(color);\n}\n\n/**\n * Check if a color is a valid RGB/RGBA color\n */\nexport function isRgbColor(color: string): boolean {\n  return /^rgba?\\([\\d\\s,./]+\\)$/.test(color);\n}\n\n/**\n * Convert hex color to RGB\n */\nexport function hexToRgb(hex: string): { r: number; g: number; b: number } | null {\n  const result = /^#?([a-f\\d]{2})([a-f\\d]{2})([a-f\\d]{2})$/i.exec(hex);\n  return result\n    ? {\n        r: parseInt(result[1], 16),\n        g: parseInt(result[2], 16),\n        b: parseInt(result[3], 16),\n      }\n    : null;\n}\n\n/**\n * Get animation duration in CSS format\n */\nexport function getAnimationDuration(speed: 'slow' | 'normal' | 'fast' | number = 'normal'): string {\n  if (typeof speed === 'number') {\n    // Validate number is valid and positive, clamp to reasonable range (50ms - 10000ms)\n    const validSpeed = !isNaN(speed) && speed > 0 ? Math.max(50, Math.min(10000, speed)) : 1000;\n    return `${validSpeed}ms`;\n  }\n\n  const speedMap = {\n    slow: '2s',\n    normal: '1s',\n    fast: '0.5s',\n  };\n\n  return speedMap[speed] || speedMap.normal;\n}\n\n/**\n * Normalize size value to CSS string\n */\nexport function normalizeSize(size?: number | string): string {\n  if (typeof size === 'number') {\n    return `${size}px`;\n  }\n  return size || 'auto';\n}\n\n/**\n * Safely parse size to number with fallback\n */\nexport function parseSizeToNumber(size: number | string | undefined, fallback: number): number {\n  if (typeof size === 'number') {\n    return !isNaN(size) && size > 0 ? size : fallback;\n  }\n\n  if (typeof size === 'string') {\n    const parsed = parseInt(size, 10);\n    return !isNaN(parsed) && parsed > 0 ? parsed : fallback;\n  }\n\n  return fallback;\n}\n\n/**\n * Calculate relative luminance of a color (0-1 scale)\n * Used for determining if text should be light or dark for contrast\n */\nexport function getColorLuminance(color: string): number {\n  // Try to parse hex color\n  if (isHexColor(color)) {\n    const rgb = hexToRgb(color);\n    if (rgb) {\n      // Convert RGB to relative luminance using WCAG formula\n      const { r, g, b } = rgb;\n      const [rs, gs, bs] = [r, g, b].map((c) => {\n        const val = c / 255;\n        return val <= 0.03928 ? val / 12.92 : Math.pow((val + 0.055) / 1.055, 2.4);\n      });\n      return 0.2126 * rs + 0.7152 * gs + 0.0722 * bs;\n    }\n  }\n\n  // Try to parse RGB/RGBA color\n  if (isRgbColor(color)) {\n    const match = color.match(/rgba?\\((\\d+),\\s*(\\d+),\\s*(\\d+)/);\n    if (match) {\n      const [, r, g, b] = match.map(Number);\n      const [rs, gs, bs] = [r, g, b].map((c) => {\n        const val = c / 255;\n        return val <= 0.03928 ? val / 12.92 : Math.pow((val + 0.055) / 1.055, 2.4);\n      });\n      return 0.2126 * rs + 0.7152 * gs + 0.0722 * bs;\n    }\n  }\n\n  // Default to 0.5 (medium luminance) if unable to parse\n  return 0.5;\n}\n\n/**\n * Get contrast color (black or white) based on background luminance\n */\nexport function getContrastColor(backgroundColor: string): string {\n  const luminance = getColorLuminance(backgroundColor);\n  // WCAG standard: use white text on dark backgrounds (luminance < 0.5)\n  return luminance < 0.5 ? '#ffffff' : '#000000';\n}\n"],"names":[],"mappings":";;AAGO,SAAS,WAAW,OAAwB;AACjD,SAAO,qCAAqC,KAAK,KAAK;AACxD;AAKO,SAAS,WAAW,OAAwB;AACjD,SAAO,wBAAwB,KAAK,KAAK;AAC3C;AAKO,SAAS,SAAS,KAAyD;AAChF,QAAM,SAAS,4CAA4C,KAAK,GAAG;AACnE,SAAO,SACH;AAAA,IACE,GAAG,SAAS,OAAO,CAAC,GAAG,EAAE;AAAA,IACzB,GAAG,SAAS,OAAO,CAAC,GAAG,EAAE;AAAA,IACzB,GAAG,SAAS,OAAO,CAAC,GAAG,EAAE;AAAA,EAAA,IAE3B;AACN;AAKO,SAAS,qBAAqB,QAA6C,UAAkB;AAClG,MAAI,OAAO,UAAU,UAAU;AAE7B,UAAM,aAAa,CAAC,MAAM,KAAK,KAAK,QAAQ,IAAI,KAAK,IAAI,IAAI,KAAK,IAAI,KAAO,KAAK,CAAC,IAAI;AACvF,WAAO,GAAG,UAAU;AAAA,EACtB;AAEA,QAAM,WAAW;AAAA,IACf,MAAM;AAAA,IACN,QAAQ;AAAA,IACR,MAAM;AAAA,EAAA;AAGR,SAAO,SAAS,KAAK,KAAK,SAAS;AACrC;AAKO,SAAS,cAAc,MAAgC;AAC5D,MAAI,OAAO,SAAS,UAAU;AAC5B,WAAO,GAAG,IAAI;AAAA,EAChB;AACA,SAAO,QAAQ;AACjB;AAKO,SAAS,kBAAkB,MAAmC,UAA0B;AAC7F,MAAI,OAAO,SAAS,UAAU;AAC5B,WAAO,CAAC,MAAM,IAAI,KAAK,OAAO,IAAI,OAAO;AAAA,EAC3C;AAEA,MAAI,OAAO,SAAS,UAAU;AAC5B,UAAM,SAAS,SAAS,MAAM,EAAE;AAChC,WAAO,CAAC,MAAM,MAAM,KAAK,SAAS,IAAI,SAAS;AAAA,EACjD;AAEA,SAAO;AACT;AAMO,SAAS,kBAAkB,OAAuB;AAEvD,MAAI,WAAW,KAAK,GAAG;AACrB,UAAM,MAAM,SAAS,KAAK;AAC1B,QAAI,KAAK;AAEP,YAAM,EAAE,GAAG,GAAG,EAAA,IAAM;AACpB,YAAM,CAAC,IAAI,IAAI,EAAE,IAAI,CAAC,GAAG,GAAG,CAAC,EAAE,IAAI,CAAC,MAAM;AACxC,cAAM,MAAM,IAAI;AAChB,eAAO,OAAO,UAAU,MAAM,QAAQ,KAAK,KAAK,MAAM,SAAS,OAAO,GAAG;AAAA,MAC3E,CAAC;AACD,aAAO,SAAS,KAAK,SAAS,KAAK,SAAS;AAAA,IAC9C;AAAA,EACF;AAGA,MAAI,WAAW,KAAK,GAAG;AACrB,UAAM,QAAQ,MAAM,MAAM,gCAAgC;AAC1D,QAAI,OAAO;AACT,YAAM,CAAA,EAAG,GAAG,GAAG,CAAC,IAAI,MAAM,IAAI,MAAM;AACpC,YAAM,CAAC,IAAI,IAAI,EAAE,IAAI,CAAC,GAAG,GAAG,CAAC,EAAE,IAAI,CAAC,MAAM;AACxC,cAAM,MAAM,IAAI;AAChB,eAAO,OAAO,UAAU,MAAM,QAAQ,KAAK,KAAK,MAAM,SAAS,OAAO,GAAG;AAAA,MAC3E,CAAC;AACD,aAAO,SAAS,KAAK,SAAS,KAAK,SAAS;AAAA,IAC9C;AAAA,EACF;AAGA,SAAO;AACT;AAKO,SAAS,iBAAiB,iBAAiC;AAChE,QAAM,YAAY,kBAAkB,eAAe;AAEnD,SAAO,YAAY,MAAM,YAAY;AACvC;;;;;;;;;"}
+{"version":3,"file":"index4.cjs","sources":["../src/utils/colors.ts"],"sourcesContent":["/**\n * Check if a color is a valid hex color\n */\nexport function isHexColor(color: string): boolean {\n  return /^#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})$/.test(color);\n}\n\n/**\n * Check if a color is a valid RGB/RGBA color\n */\nexport function isRgbColor(color: string): boolean {\n  return /^rgba?\\([\\d\\s,./]+\\)$/.test(color);\n}\n\n/**\n * Convert hex color to RGB\n */\nexport function hexToRgb(hex: string): { r: number; g: number; b: number } | null {\n  const result = /^#?([a-f\\d]{2})([a-f\\d]{2})([a-f\\d]{2})$/i.exec(hex);\n  return result\n    ? {\n        r: parseInt(result[1], 16),\n        g: parseInt(result[2], 16),\n        b: parseInt(result[3], 16),\n      }\n    : null;\n}\n\n/**\n * Get animation duration in CSS format\n */\nexport function getAnimationDuration(speed: 'slow' | 'normal' | 'fast' | number = 'normal'): string {\n  if (typeof speed === 'number') {\n    // Validate number is valid and positive, clamp to reasonable range (50ms - 10000ms)\n    const validSpeed = !isNaN(speed) && speed > 0 ? Math.max(50, Math.min(10000, speed)) : 1000;\n    return `${validSpeed}ms`;\n  }\n\n  const speedMap = {\n    slow: '2s',\n    normal: '1s',\n    fast: '0.5s',\n  };\n\n  return speedMap[speed] || speedMap.normal;\n}\n\n/**\n * Normalize size value to CSS string\n * Supports size presets ('xs', 'sm', 'md', 'lg', 'xl'), numeric values, or CSS strings\n */\nexport function normalizeSize(size?: 'xs' | 'sm' | 'md' | 'lg' | 'xl' | number | string): string {\n  // Handle size presets\n  const sizePresetMap = {\n    xs: 16,\n    sm: 24,\n    md: 40,\n    lg: 56,\n    xl: 72,\n  };\n\n  if (typeof size === 'string' && size in sizePresetMap) {\n    return `${sizePresetMap[size as keyof typeof sizePresetMap]}px`;\n  }\n\n  if (typeof size === 'number') {\n    return `${size}px`;\n  }\n  return size || 'auto';\n}\n\n/**\n * Safely parse size to number with fallback\n */\nexport function parseSizeToNumber(size: number | string | undefined, fallback: number): number {\n  if (typeof size === 'number') {\n    return !isNaN(size) && size > 0 ? size : fallback;\n  }\n\n  if (typeof size === 'string') {\n    const parsed = parseInt(size, 10);\n    return !isNaN(parsed) && parsed > 0 ? parsed : fallback;\n  }\n\n  return fallback;\n}\n\n/**\n * Calculate relative luminance of a color (0-1 scale)\n * Used for determining if text should be light or dark for contrast\n */\nexport function getColorLuminance(color: string): number {\n  // Try to parse hex color\n  if (isHexColor(color)) {\n    const rgb = hexToRgb(color);\n    if (rgb) {\n      // Convert RGB to relative luminance using WCAG formula\n      const { r, g, b } = rgb;\n      const [rs, gs, bs] = [r, g, b].map((c) => {\n        const val = c / 255;\n        return val <= 0.03928 ? val / 12.92 : Math.pow((val + 0.055) / 1.055, 2.4);\n      });\n      return 0.2126 * rs + 0.7152 * gs + 0.0722 * bs;\n    }\n  }\n\n  // Try to parse RGB/RGBA color\n  if (isRgbColor(color)) {\n    const match = color.match(/rgba?\\((\\d+),\\s*(\\d+),\\s*(\\d+)/);\n    if (match) {\n      const [, r, g, b] = match.map(Number);\n      const [rs, gs, bs] = [r, g, b].map((c) => {\n        const val = c / 255;\n        return val <= 0.03928 ? val / 12.92 : Math.pow((val + 0.055) / 1.055, 2.4);\n      });\n      return 0.2126 * rs + 0.7152 * gs + 0.0722 * bs;\n    }\n  }\n\n  // Default to 0.5 (medium luminance) if unable to parse\n  return 0.5;\n}\n\n/**\n * Get contrast color (black or white) based on background luminance\n */\nexport function getContrastColor(backgroundColor: string): string {\n  const luminance = getColorLuminance(backgroundColor);\n  // WCAG standard: use white text on dark backgrounds (luminance < 0.5)\n  return luminance < 0.5 ? '#ffffff' : '#000000';\n}\n"],"names":[],"mappings":";;AAGO,SAAS,WAAW,OAAwB;AACjD,SAAO,qCAAqC,KAAK,KAAK;AACxD;AAKO,SAAS,WAAW,OAAwB;AACjD,SAAO,wBAAwB,KAAK,KAAK;AAC3C;AAKO,SAAS,SAAS,KAAyD;AAChF,QAAM,SAAS,4CAA4C,KAAK,GAAG;AACnE,SAAO,SACH;AAAA,IACE,GAAG,SAAS,OAAO,CAAC,GAAG,EAAE;AAAA,IACzB,GAAG,SAAS,OAAO,CAAC,GAAG,EAAE;AAAA,IACzB,GAAG,SAAS,OAAO,CAAC,GAAG,EAAE;AAAA,EAAA,IAE3B;AACN;AAKO,SAAS,qBAAqB,QAA6C,UAAkB;AAClG,MAAI,OAAO,UAAU,UAAU;AAE7B,UAAM,aAAa,CAAC,MAAM,KAAK,KAAK,QAAQ,IAAI,KAAK,IAAI,IAAI,KAAK,IAAI,KAAO,KAAK,CAAC,IAAI;AACvF,WAAO,GAAG,UAAU;AAAA,EACtB;AAEA,QAAM,WAAW;AAAA,IACf,MAAM;AAAA,IACN,QAAQ;AAAA,IACR,MAAM;AAAA,EAAA;AAGR,SAAO,SAAS,KAAK,KAAK,SAAS;AACrC;AAMO,SAAS,cAAc,MAAmE;AAE/F,QAAM,gBAAgB;AAAA,IACpB,IAAI;AAAA,IACJ,IAAI;AAAA,IACJ,IAAI;AAAA,IACJ,IAAI;AAAA,IACJ,IAAI;AAAA,EAAA;AAGN,MAAI,OAAO,SAAS,YAAY,QAAQ,eAAe;AACrD,WAAO,GAAG,cAAc,IAAkC,CAAC;AAAA,EAC7D;AAEA,MAAI,OAAO,SAAS,UAAU;AAC5B,WAAO,GAAG,IAAI;AAAA,EAChB;AACA,SAAO,QAAQ;AACjB;AAKO,SAAS,kBAAkB,MAAmC,UAA0B;AAC7F,MAAI,OAAO,SAAS,UAAU;AAC5B,WAAO,CAAC,MAAM,IAAI,KAAK,OAAO,IAAI,OAAO;AAAA,EAC3C;AAEA,MAAI,OAAO,SAAS,UAAU;AAC5B,UAAM,SAAS,SAAS,MAAM,EAAE;AAChC,WAAO,CAAC,MAAM,MAAM,KAAK,SAAS,IAAI,SAAS;AAAA,EACjD;AAEA,SAAO;AACT;AAMO,SAAS,kBAAkB,OAAuB;AAEvD,MAAI,WAAW,KAAK,GAAG;AACrB,UAAM,MAAM,SAAS,KAAK;AAC1B,QAAI,KAAK;AAEP,YAAM,EAAE,GAAG,GAAG,EAAA,IAAM;AACpB,YAAM,CAAC,IAAI,IAAI,EAAE,IAAI,CAAC,GAAG,GAAG,CAAC,EAAE,IAAI,CAAC,MAAM;AACxC,cAAM,MAAM,IAAI;AAChB,eAAO,OAAO,UAAU,MAAM,QAAQ,KAAK,KAAK,MAAM,SAAS,OAAO,GAAG;AAAA,MAC3E,CAAC;AACD,aAAO,SAAS,KAAK,SAAS,KAAK,SAAS;AAAA,IAC9C;AAAA,EACF;AAGA,MAAI,WAAW,KAAK,GAAG;AACrB,UAAM,QAAQ,MAAM,MAAM,gCAAgC;AAC1D,QAAI,OAAO;AACT,YAAM,CAAA,EAAG,GAAG,GAAG,CAAC,IAAI,MAAM,IAAI,MAAM;AACpC,YAAM,CAAC,IAAI,IAAI,EAAE,IAAI,CAAC,GAAG,GAAG,CAAC,EAAE,IAAI,CAAC,MAAM;AACxC,cAAM,MAAM,IAAI;AAChB,eAAO,OAAO,UAAU,MAAM,QAAQ,KAAK,KAAK,MAAM,SAAS,OAAO,GAAG;AAAA,MAC3E,CAAC;AACD,aAAO,SAAS,KAAK,SAAS,KAAK,SAAS;AAAA,IAC9C;AAAA,EACF;AAGA,SAAO;AACT;AAKO,SAAS,iBAAiB,iBAAiC;AAChE,QAAM,YAAY,kBAAkB,eAAe;AAEnD,SAAO,YAAY,MAAM,YAAY;AACvC;;;;;;;;;"}

package/dist/index4.js

@@ -25,6 +25,16 @@ function getAnimationDuration(speed = "normal") {
   return speedMap[speed] || speedMap.normal;
 }
 function normalizeSize(size) {
+  const sizePresetMap = {
+    xs: 16,
+    sm: 24,
+    md: 40,
+    lg: 56,
+    xl: 72
+  };
+  if (typeof size === "string" && size in sizePresetMap) {
+    return `${sizePresetMap[size]}px`;
+  }
   if (typeof size === "number") {
     return `${size}px`;
   }

package/dist/index4.js.map

@@ -1 +1 @@
-{"version":3,"file":"index4.js","sources":["../src/utils/colors.ts"],"sourcesContent":["/**\n * Check if a color is a valid hex color\n */\nexport function isHexColor(color: string): boolean {\n  return /^#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})$/.test(color);\n}\n\n/**\n * Check if a color is a valid RGB/RGBA color\n */\nexport function isRgbColor(color: string): boolean {\n  return /^rgba?\\([\\d\\s,./]+\\)$/.test(color);\n}\n\n/**\n * Convert hex color to RGB\n */\nexport function hexToRgb(hex: string): { r: number; g: number; b: number } | null {\n  const result = /^#?([a-f\\d]{2})([a-f\\d]{2})([a-f\\d]{2})$/i.exec(hex);\n  return result\n    ? {\n        r: parseInt(result[1], 16),\n        g: parseInt(result[2], 16),\n        b: parseInt(result[3], 16),\n      }\n    : null;\n}\n\n/**\n * Get animation duration in CSS format\n */\nexport function getAnimationDuration(speed: 'slow' | 'normal' | 'fast' | number = 'normal'): string {\n  if (typeof speed === 'number') {\n    // Validate number is valid and positive, clamp to reasonable range (50ms - 10000ms)\n    const validSpeed = !isNaN(speed) && speed > 0 ? Math.max(50, Math.min(10000, speed)) : 1000;\n    return `${validSpeed}ms`;\n  }\n\n  const speedMap = {\n    slow: '2s',\n    normal: '1s',\n    fast: '0.5s',\n  };\n\n  return speedMap[speed] || speedMap.normal;\n}\n\n/**\n * Normalize size value to CSS string\n */\nexport function normalizeSize(size?: number | string): string {\n  if (typeof size === 'number') {\n    return `${size}px`;\n  }\n  return size || 'auto';\n}\n\n/**\n * Safely parse size to number with fallback\n */\nexport function parseSizeToNumber(size: number | string | undefined, fallback: number): number {\n  if (typeof size === 'number') {\n    return !isNaN(size) && size > 0 ? size : fallback;\n  }\n\n  if (typeof size === 'string') {\n    const parsed = parseInt(size, 10);\n    return !isNaN(parsed) && parsed > 0 ? parsed : fallback;\n  }\n\n  return fallback;\n}\n\n/**\n * Calculate relative luminance of a color (0-1 scale)\n * Used for determining if text should be light or dark for contrast\n */\nexport function getColorLuminance(color: string): number {\n  // Try to parse hex color\n  if (isHexColor(color)) {\n    const rgb = hexToRgb(color);\n    if (rgb) {\n      // Convert RGB to relative luminance using WCAG formula\n      const { r, g, b } = rgb;\n      const [rs, gs, bs] = [r, g, b].map((c) => {\n        const val = c / 255;\n        return val <= 0.03928 ? val / 12.92 : Math.pow((val + 0.055) / 1.055, 2.4);\n      });\n      return 0.2126 * rs + 0.7152 * gs + 0.0722 * bs;\n    }\n  }\n\n  // Try to parse RGB/RGBA color\n  if (isRgbColor(color)) {\n    const match = color.match(/rgba?\\((\\d+),\\s*(\\d+),\\s*(\\d+)/);\n    if (match) {\n      const [, r, g, b] = match.map(Number);\n      const [rs, gs, bs] = [r, g, b].map((c) => {\n        const val = c / 255;\n        return val <= 0.03928 ? val / 12.92 : Math.pow((val + 0.055) / 1.055, 2.4);\n      });\n      return 0.2126 * rs + 0.7152 * gs + 0.0722 * bs;\n    }\n  }\n\n  // Default to 0.5 (medium luminance) if unable to parse\n  return 0.5;\n}\n\n/**\n * Get contrast color (black or white) based on background luminance\n */\nexport function getContrastColor(backgroundColor: string): string {\n  const luminance = getColorLuminance(backgroundColor);\n  // WCAG standard: use white text on dark backgrounds (luminance < 0.5)\n  return luminance < 0.5 ? '#ffffff' : '#000000';\n}\n"],"names":[],"mappings":"AAGO,SAAS,WAAW,OAAwB;AACjD,SAAO,qCAAqC,KAAK,KAAK;AACxD;AAKO,SAAS,WAAW,OAAwB;AACjD,SAAO,wBAAwB,KAAK,KAAK;AAC3C;AAKO,SAAS,SAAS,KAAyD;AAChF,QAAM,SAAS,4CAA4C,KAAK,GAAG;AACnE,SAAO,SACH;AAAA,IACE,GAAG,SAAS,OAAO,CAAC,GAAG,EAAE;AAAA,IACzB,GAAG,SAAS,OAAO,CAAC,GAAG,EAAE;AAAA,IACzB,GAAG,SAAS,OAAO,CAAC,GAAG,EAAE;AAAA,EAAA,IAE3B;AACN;AAKO,SAAS,qBAAqB,QAA6C,UAAkB;AAClG,MAAI,OAAO,UAAU,UAAU;AAE7B,UAAM,aAAa,CAAC,MAAM,KAAK,KAAK,QAAQ,IAAI,KAAK,IAAI,IAAI,KAAK,IAAI,KAAO,KAAK,CAAC,IAAI;AACvF,WAAO,GAAG,UAAU;AAAA,EACtB;AAEA,QAAM,WAAW;AAAA,IACf,MAAM;AAAA,IACN,QAAQ;AAAA,IACR,MAAM;AAAA,EAAA;AAGR,SAAO,SAAS,KAAK,KAAK,SAAS;AACrC;AAKO,SAAS,cAAc,MAAgC;AAC5D,MAAI,OAAO,SAAS,UAAU;AAC5B,WAAO,GAAG,IAAI;AAAA,EAChB;AACA,SAAO,QAAQ;AACjB;AAKO,SAAS,kBAAkB,MAAmC,UAA0B;AAC7F,MAAI,OAAO,SAAS,UAAU;AAC5B,WAAO,CAAC,MAAM,IAAI,KAAK,OAAO,IAAI,OAAO;AAAA,EAC3C;AAEA,MAAI,OAAO,SAAS,UAAU;AAC5B,UAAM,SAAS,SAAS,MAAM,EAAE;AAChC,WAAO,CAAC,MAAM,MAAM,KAAK,SAAS,IAAI,SAAS;AAAA,EACjD;AAEA,SAAO;AACT;AAMO,SAAS,kBAAkB,OAAuB;AAEvD,MAAI,WAAW,KAAK,GAAG;AACrB,UAAM,MAAM,SAAS,KAAK;AAC1B,QAAI,KAAK;AAEP,YAAM,EAAE,GAAG,GAAG,EAAA,IAAM;AACpB,YAAM,CAAC,IAAI,IAAI,EAAE,IAAI,CAAC,GAAG,GAAG,CAAC,EAAE,IAAI,CAAC,MAAM;AACxC,cAAM,MAAM,IAAI;AAChB,eAAO,OAAO,UAAU,MAAM,QAAQ,KAAK,KAAK,MAAM,SAAS,OAAO,GAAG;AAAA,MAC3E,CAAC;AACD,aAAO,SAAS,KAAK,SAAS,KAAK,SAAS;AAAA,IAC9C;AAAA,EACF;AAGA,MAAI,WAAW,KAAK,GAAG;AACrB,UAAM,QAAQ,MAAM,MAAM,gCAAgC;AAC1D,QAAI,OAAO;AACT,YAAM,CAAA,EAAG,GAAG,GAAG,CAAC,IAAI,MAAM,IAAI,MAAM;AACpC,YAAM,CAAC,IAAI,IAAI,EAAE,IAAI,CAAC,GAAG,GAAG,CAAC,EAAE,IAAI,CAAC,MAAM;AACxC,cAAM,MAAM,IAAI;AAChB,eAAO,OAAO,UAAU,MAAM,QAAQ,KAAK,KAAK,MAAM,SAAS,OAAO,GAAG;AAAA,MAC3E,CAAC;AACD,aAAO,SAAS,KAAK,SAAS,KAAK,SAAS;AAAA,IAC9C;AAAA,EACF;AAGA,SAAO;AACT;AAKO,SAAS,iBAAiB,iBAAiC;AAChE,QAAM,YAAY,kBAAkB,eAAe;AAEnD,SAAO,YAAY,MAAM,YAAY;AACvC;"}
+{"version":3,"file":"index4.js","sources":["../src/utils/colors.ts"],"sourcesContent":["/**\n * Check if a color is a valid hex color\n */\nexport function isHexColor(color: string): boolean {\n  return /^#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})$/.test(color);\n}\n\n/**\n * Check if a color is a valid RGB/RGBA color\n */\nexport function isRgbColor(color: string): boolean {\n  return /^rgba?\\([\\d\\s,./]+\\)$/.test(color);\n}\n\n/**\n * Convert hex color to RGB\n */\nexport function hexToRgb(hex: string): { r: number; g: number; b: number } | null {\n  const result = /^#?([a-f\\d]{2})([a-f\\d]{2})([a-f\\d]{2})$/i.exec(hex);\n  return result\n    ? {\n        r: parseInt(result[1], 16),\n        g: parseInt(result[2], 16),\n        b: parseInt(result[3], 16),\n      }\n    : null;\n}\n\n/**\n * Get animation duration in CSS format\n */\nexport function getAnimationDuration(speed: 'slow' | 'normal' | 'fast' | number = 'normal'): string {\n  if (typeof speed === 'number') {\n    // Validate number is valid and positive, clamp to reasonable range (50ms - 10000ms)\n    const validSpeed = !isNaN(speed) && speed > 0 ? Math.max(50, Math.min(10000, speed)) : 1000;\n    return `${validSpeed}ms`;\n  }\n\n  const speedMap = {\n    slow: '2s',\n    normal: '1s',\n    fast: '0.5s',\n  };\n\n  return speedMap[speed] || speedMap.normal;\n}\n\n/**\n * Normalize size value to CSS string\n * Supports size presets ('xs', 'sm', 'md', 'lg', 'xl'), numeric values, or CSS strings\n */\nexport function normalizeSize(size?: 'xs' | 'sm' | 'md' | 'lg' | 'xl' | number | string): string {\n  // Handle size presets\n  const sizePresetMap = {\n    xs: 16,\n    sm: 24,\n    md: 40,\n    lg: 56,\n    xl: 72,\n  };\n\n  if (typeof size === 'string' && size in sizePresetMap) {\n    return `${sizePresetMap[size as keyof typeof sizePresetMap]}px`;\n  }\n\n  if (typeof size === 'number') {\n    return `${size}px`;\n  }\n  return size || 'auto';\n}\n\n/**\n * Safely parse size to number with fallback\n */\nexport function parseSizeToNumber(size: number | string | undefined, fallback: number): number {\n  if (typeof size === 'number') {\n    return !isNaN(size) && size > 0 ? size : fallback;\n  }\n\n  if (typeof size === 'string') {\n    const parsed = parseInt(size, 10);\n    return !isNaN(parsed) && parsed > 0 ? parsed : fallback;\n  }\n\n  return fallback;\n}\n\n/**\n * Calculate relative luminance of a color (0-1 scale)\n * Used for determining if text should be light or dark for contrast\n */\nexport function getColorLuminance(color: string): number {\n  // Try to parse hex color\n  if (isHexColor(color)) {\n    const rgb = hexToRgb(color);\n    if (rgb) {\n      // Convert RGB to relative luminance using WCAG formula\n      const { r, g, b } = rgb;\n      const [rs, gs, bs] = [r, g, b].map((c) => {\n        const val = c / 255;\n        return val <= 0.03928 ? val / 12.92 : Math.pow((val + 0.055) / 1.055, 2.4);\n      });\n      return 0.2126 * rs + 0.7152 * gs + 0.0722 * bs;\n    }\n  }\n\n  // Try to parse RGB/RGBA color\n  if (isRgbColor(color)) {\n    const match = color.match(/rgba?\\((\\d+),\\s*(\\d+),\\s*(\\d+)/);\n    if (match) {\n      const [, r, g, b] = match.map(Number);\n      const [rs, gs, bs] = [r, g, b].map((c) => {\n        const val = c / 255;\n        return val <= 0.03928 ? val / 12.92 : Math.pow((val + 0.055) / 1.055, 2.4);\n      });\n      return 0.2126 * rs + 0.7152 * gs + 0.0722 * bs;\n    }\n  }\n\n  // Default to 0.5 (medium luminance) if unable to parse\n  return 0.5;\n}\n\n/**\n * Get contrast color (black or white) based on background luminance\n */\nexport function getContrastColor(backgroundColor: string): string {\n  const luminance = getColorLuminance(backgroundColor);\n  // WCAG standard: use white text on dark backgrounds (luminance < 0.5)\n  return luminance < 0.5 ? '#ffffff' : '#000000';\n}\n"],"names":[],"mappings":"AAGO,SAAS,WAAW,OAAwB;AACjD,SAAO,qCAAqC,KAAK,KAAK;AACxD;AAKO,SAAS,WAAW,OAAwB;AACjD,SAAO,wBAAwB,KAAK,KAAK;AAC3C;AAKO,SAAS,SAAS,KAAyD;AAChF,QAAM,SAAS,4CAA4C,KAAK,GAAG;AACnE,SAAO,SACH;AAAA,IACE,GAAG,SAAS,OAAO,CAAC,GAAG,EAAE;AAAA,IACzB,GAAG,SAAS,OAAO,CAAC,GAAG,EAAE;AAAA,IACzB,GAAG,SAAS,OAAO,CAAC,GAAG,EAAE;AAAA,EAAA,IAE3B;AACN;AAKO,SAAS,qBAAqB,QAA6C,UAAkB;AAClG,MAAI,OAAO,UAAU,UAAU;AAE7B,UAAM,aAAa,CAAC,MAAM,KAAK,KAAK,QAAQ,IAAI,KAAK,IAAI,IAAI,KAAK,IAAI,KAAO,KAAK,CAAC,IAAI;AACvF,WAAO,GAAG,UAAU;AAAA,EACtB;AAEA,QAAM,WAAW;AAAA,IACf,MAAM;AAAA,IACN,QAAQ;AAAA,IACR,MAAM;AAAA,EAAA;AAGR,SAAO,SAAS,KAAK,KAAK,SAAS;AACrC;AAMO,SAAS,cAAc,MAAmE;AAE/F,QAAM,gBAAgB;AAAA,IACpB,IAAI;AAAA,IACJ,IAAI;AAAA,IACJ,IAAI;AAAA,IACJ,IAAI;AAAA,IACJ,IAAI;AAAA,EAAA;AAGN,MAAI,OAAO,SAAS,YAAY,QAAQ,eAAe;AACrD,WAAO,GAAG,cAAc,IAAkC,CAAC;AAAA,EAC7D;AAEA,MAAI,OAAO,SAAS,UAAU;AAC5B,WAAO,GAAG,IAAI;AAAA,EAChB;AACA,SAAO,QAAQ;AACjB;AAKO,SAAS,kBAAkB,MAAmC,UAA0B;AAC7F,MAAI,OAAO,SAAS,UAAU;AAC5B,WAAO,CAAC,MAAM,IAAI,KAAK,OAAO,IAAI,OAAO;AAAA,EAC3C;AAEA,MAAI,OAAO,SAAS,UAAU;AAC5B,UAAM,SAAS,SAAS,MAAM,EAAE;AAChC,WAAO,CAAC,MAAM,MAAM,KAAK,SAAS,IAAI,SAAS;AAAA,EACjD;AAEA,SAAO;AACT;AAMO,SAAS,kBAAkB,OAAuB;AAEvD,MAAI,WAAW,KAAK,GAAG;AACrB,UAAM,MAAM,SAAS,KAAK;AAC1B,QAAI,KAAK;AAEP,YAAM,EAAE,GAAG,GAAG,EAAA,IAAM;AACpB,YAAM,CAAC,IAAI,IAAI,EAAE,IAAI,CAAC,GAAG,GAAG,CAAC,EAAE,IAAI,CAAC,MAAM;AACxC,cAAM,MAAM,IAAI;AAChB,eAAO,OAAO,UAAU,MAAM,QAAQ,KAAK,KAAK,MAAM,SAAS,OAAO,GAAG;AAAA,MAC3E,CAAC;AACD,aAAO,SAAS,KAAK,SAAS,KAAK,SAAS;AAAA,IAC9C;AAAA,EACF;AAGA,MAAI,WAAW,KAAK,GAAG;AACrB,UAAM,QAAQ,MAAM,MAAM,gCAAgC;AAC1D,QAAI,OAAO;AACT,YAAM,CAAA,EAAG,GAAG,GAAG,CAAC,IAAI,MAAM,IAAI,MAAM;AACpC,YAAM,CAAC,IAAI,IAAI,EAAE,IAAI,CAAC,GAAG,GAAG,CAAC,EAAE,IAAI,CAAC,MAAM;AACxC,cAAM,MAAM,IAAI;AAChB,eAAO,OAAO,UAAU,MAAM,QAAQ,KAAK,KAAK,MAAM,SAAS,OAAO,GAAG;AAAA,MAC3E,CAAC;AACD,aAAO,SAAS,KAAK,SAAS,KAAK,SAAS;AAAA,IAC9C;AAAA,EACF;AAGA,SAAO;AACT;AAKO,SAAS,iBAAiB,iBAAiC;AAChE,QAAM,YAAY,kBAAkB,eAAe;AAEnD,SAAO,YAAY,MAAM,YAAY;AACvC;"}