premium-react-loaders 1.0.1 → 1.1.0

package/dist/index27.js

@@ -0,0 +1,64 @@
+import { jsx } from "react/jsx-runtime";
+import { forwardRef } from "react";
+import { normalizeSize, getAnimationDuration, parseSizeToNumber } from "./index4.js";
+import { cn } from "./index3.js";
+const PulseBars = forwardRef(
+  ({
+    size = 40,
+    color = "#3b82f6",
+    barCount = 4,
+    speed = "normal",
+    className,
+    style,
+    testId = "pulse-bars",
+    visible = true,
+    ariaLabel = "Loading...",
+    ...rest
+  }, ref) => {
+    if (!visible) return null;
+    const sizeValue = parseSizeToNumber(size, 40);
+    const barWidth = Math.floor(sizeValue / (barCount * 2));
+    const animationDuration = getAnimationDuration(speed);
+    return /* @__PURE__ */ jsx(
+      "div",
+      {
+        ref,
+        "data-testid": testId,
+        className: cn("inline-flex items-center justify-center gap-1", className),
+        style: {
+          height: normalizeSize(size),
+          ...style
+        },
+        role: "status",
+        "aria-label": ariaLabel,
+        "aria-busy": "true",
+        ...rest,
+        children: Array.from({ length: barCount }).map((_, index) => {
+          const delays = [0, 0.2, 0.4, 0.1, 0.3, 0.5];
+          const delay = delays[index % delays.length];
+          return /* @__PURE__ */ jsx(
+            "div",
+            {
+              className: "rounded-sm",
+              style: {
+                width: `${barWidth}px`,
+                minHeight: "30%",
+                height: "100%",
+                backgroundColor: color,
+                animation: `pulse-wave ${animationDuration} ease-in-out infinite`,
+                animationDelay: `${delay}s`,
+                transformOrigin: "center"
+              }
+            },
+            index
+          );
+        })
+      }
+    );
+  }
+);
+PulseBars.displayName = "PulseBars";
+export {
+  PulseBars
+};
+//# sourceMappingURL=index27.js.map

package/dist/index27.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index27.js","sources":["../src/components/pulse/PulseBars.tsx"],"sourcesContent":["import { forwardRef } from 'react';\nimport { PulseBarsProps } from '../../types';\nimport { cn, normalizeSize, getAnimationDuration, parseSizeToNumber } from '../../utils';\n\n/**\n * PulseBars - Equalizer-style bars loader\n *\n * A loader with bars that pulse like an audio equalizer.\n *\n * @example\n * ```tsx\n * <PulseBars size={40} color=\"#3b82f6\" />\n * <PulseBars size={48} barCount={6} speed=\"fast\" />\n * ```\n */\nexport const PulseBars = forwardRef<HTMLDivElement, PulseBarsProps>(\n  (\n    {\n      size = 40,\n      color = '#3b82f6',\n      barCount = 4,\n      speed = 'normal',\n      className,\n      style,\n      testId = 'pulse-bars',\n      visible = true,\n      ariaLabel = 'Loading...',\n      ...rest\n    },\n    ref\n  ) => {\n    if (!visible) return null;\n\n    const sizeValue = parseSizeToNumber(size, 40);\n    const barWidth = Math.floor(sizeValue / (barCount * 2));\n    const animationDuration = getAnimationDuration(speed);\n\n    return (\n      <div\n        ref={ref}\n        data-testid={testId}\n        className={cn('inline-flex items-center justify-center gap-1', className)}\n        style={{\n          height: normalizeSize(size),\n          ...style,\n        }}\n        role=\"status\"\n        aria-label={ariaLabel}\n        aria-busy=\"true\"\n        {...rest}\n      >\n        {Array.from({ length: barCount }).map((_, index) => {\n          // Random-looking delays for equalizer effect\n          const delays = [0, 0.2, 0.4, 0.1, 0.3, 0.5];\n          const delay = delays[index % delays.length];\n\n          return (\n            <div\n              key={index}\n              className=\"rounded-sm\"\n              style={{\n                width: `${barWidth}px`,\n                minHeight: '30%',\n                height: '100%',\n                backgroundColor: color,\n                animation: `pulse-wave ${animationDuration} ease-in-out infinite`,\n                animationDelay: `${delay}s`,\n                transformOrigin: 'center',\n              }}\n            />\n          );\n        })}\n      </div>\n    );\n  }\n);\n\nPulseBars.displayName = 'PulseBars';\n"],"names":[],"mappings":";;;;AAeO,MAAM,YAAY;AAAA,EACvB,CACE;AAAA,IACE,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,WAAW;AAAA,IACX,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,YAAY,kBAAkB,MAAM,EAAE;AAC5C,UAAM,WAAW,KAAK,MAAM,aAAa,WAAW,EAAE;AACtD,UAAM,oBAAoB,qBAAqB,KAAK;AAEpD,WACE;AAAA,MAAC;AAAA,MAAA;AAAA,QACC;AAAA,QACA,eAAa;AAAA,QACb,WAAW,GAAG,iDAAiD,SAAS;AAAA,QACxE,OAAO;AAAA,UACL,QAAQ,cAAc,IAAI;AAAA,UAC1B,GAAG;AAAA,QAAA;AAAA,QAEL,MAAK;AAAA,QACL,cAAY;AAAA,QACZ,aAAU;AAAA,QACT,GAAG;AAAA,QAEH,UAAA,MAAM,KAAK,EAAE,QAAQ,SAAA,CAAU,EAAE,IAAI,CAAC,GAAG,UAAU;AAElD,gBAAM,SAAS,CAAC,GAAG,KAAK,KAAK,KAAK,KAAK,GAAG;AAC1C,gBAAM,QAAQ,OAAO,QAAQ,OAAO,MAAM;AAE1C,iBACE;AAAA,YAAC;AAAA,YAAA;AAAA,cAEC,WAAU;AAAA,cACV,OAAO;AAAA,gBACL,OAAO,GAAG,QAAQ;AAAA,gBAClB,WAAW;AAAA,gBACX,QAAQ;AAAA,gBACR,iBAAiB;AAAA,gBACjB,WAAW,cAAc,iBAAiB;AAAA,gBAC1C,gBAAgB,GAAG,KAAK;AAAA,gBACxB,iBAAiB;AAAA,cAAA;AAAA,YACnB;AAAA,YAVK;AAAA,UAAA;AAAA,QAaX,CAAC;AAAA,MAAA;AAAA,IAAA;AAAA,EAGP;AACF;AAEA,UAAU,cAAc;"}

package/dist/index28.cjs

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const jsxRuntime = require("react/jsx-runtime");
+const react = require("react");
+const colors = require("./index4.cjs");
+const classNames = require("./index3.cjs");
+const TypingIndicator = react.forwardRef(
+  ({
+    size,
+    color = "#3b82f6",
+    dotCount = 3,
+    dotSize = 8,
+    gap = 4,
+    variant = "bounce",
+    speed = "normal",
+    className,
+    style,
+    testId = "typing-indicator",
+    visible = true,
+    ariaLabel = "Typing...",
+    ...rest
+  }, ref) => {
+    if (!visible) return null;
+    const animationDuration = colors.getAnimationDuration(speed);
+    const gapValue = colors.normalizeSize(gap);
+    return /* @__PURE__ */ jsxRuntime.jsx(
+      "div",
+      {
+        ref,
+        "data-testid": testId,
+        className: classNames.cn("inline-flex items-center", className),
+        style: {
+          gap: gapValue,
+          height: size ? colors.normalizeSize(size) : "auto",
+          ...style
+        },
+        role: "status",
+        "aria-label": ariaLabel,
+        "aria-busy": "true",
+        ...rest,
+        children: Array.from({ length: dotCount }).map((_, index) => /* @__PURE__ */ jsxRuntime.jsx(
+          "div",
+          {
+            className: "rounded-full",
+            style: {
+              width: colors.normalizeSize(dotSize),
+              height: colors.normalizeSize(dotSize),
+              backgroundColor: color,
+              animation: `typing-${variant} ${animationDuration} ease-in-out infinite`,
+              animationDelay: `${index * 0.2}s`
+            }
+          },
+          index
+        ))
+      }
+    );
+  }
+);
+TypingIndicator.displayName = "TypingIndicator";
+exports.TypingIndicator = TypingIndicator;
+//# sourceMappingURL=index28.cjs.map

package/dist/index28.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index28.cjs","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":["forwardRef","getAnimationDuration","normalizeSize","jsx","cn"],"mappings":";;;;;;AAiBO,MAAM,kBAAkBA,MAAAA;AAAAA,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,oBAAoBC,OAAAA,qBAAqB,KAAK;AACpD,UAAM,WAAWC,OAAAA,cAAc,GAAG;AAElC,WACEC,2BAAAA;AAAAA,MAAC;AAAA,MAAA;AAAA,QACC;AAAA,QACA,eAAa;AAAA,QACb,WAAWC,WAAAA,GAAG,4BAA4B,SAAS;AAAA,QACnD,OAAO;AAAA,UACL,KAAK;AAAA,UACL,QAAQ,OAAOF,qBAAc,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,UACxCC,2BAAAA;AAAAA,UAAC;AAAA,UAAA;AAAA,YAEC,WAAU;AAAA,YACV,OAAO;AAAA,cACL,OAAOD,OAAAA,cAAc,OAAO;AAAA,cAC5B,QAAQA,OAAAA,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;;"}

package/dist/index28.js

@@ -0,0 +1,61 @@
+import { jsx } from "react/jsx-runtime";
+import { forwardRef } from "react";
+import { normalizeSize, getAnimationDuration } from "./index4.js";
+import { cn } from "./index3.js";
+const TypingIndicator = forwardRef(
+  ({
+    size,
+    color = "#3b82f6",
+    dotCount = 3,
+    dotSize = 8,
+    gap = 4,
+    variant = "bounce",
+    speed = "normal",
+    className,
+    style,
+    testId = "typing-indicator",
+    visible = true,
+    ariaLabel = "Typing...",
+    ...rest
+  }, ref) => {
+    if (!visible) return null;
+    const animationDuration = getAnimationDuration(speed);
+    const gapValue = normalizeSize(gap);
+    return /* @__PURE__ */ jsx(
+      "div",
+      {
+        ref,
+        "data-testid": testId,
+        className: cn("inline-flex items-center", className),
+        style: {
+          gap: gapValue,
+          height: size ? normalizeSize(size) : "auto",
+          ...style
+        },
+        role: "status",
+        "aria-label": ariaLabel,
+        "aria-busy": "true",
+        ...rest,
+        children: Array.from({ length: dotCount }).map((_, index) => /* @__PURE__ */ jsx(
+          "div",
+          {
+            className: "rounded-full",
+            style: {
+              width: normalizeSize(dotSize),
+              height: normalizeSize(dotSize),
+              backgroundColor: color,
+              animation: `typing-${variant} ${animationDuration} ease-in-out infinite`,
+              animationDelay: `${index * 0.2}s`
+            }
+          },
+          index
+        ))
+      }
+    );
+  }
+);
+TypingIndicator.displayName = "TypingIndicator";
+export {
+  TypingIndicator
+};
+//# sourceMappingURL=index28.js.map

package/dist/index28.js.map

@@ -0,0 +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;"}

package/dist/index29.cjs

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const jsxRuntime = require("react/jsx-runtime");
+const react = require("react");
+const classNames = require("./index3.cjs");
+const LoaderOverlay = react.forwardRef(
+  ({
+    loading = false,
+    loader,
+    children,
+    position = "fixed",
+    backdropOpacity = 0.5,
+    backdropColor = "#000000",
+    blur = false,
+    className,
+    style,
+    testId = "loader-overlay",
+    ariaLabel = "Loading content...",
+    zIndex = 9999,
+    ...rest
+  }, ref) => {
+    const backdropStyles = {
+      backgroundColor: backdropColor,
+      opacity: backdropOpacity,
+      backdropFilter: blur ? "blur(4px)" : void 0,
+      WebkitBackdropFilter: blur ? "blur(4px)" : void 0
+    };
+    return /* @__PURE__ */ jsxRuntime.jsxs(
+      "div",
+      {
+        ref,
+        "data-testid": testId,
+        className: classNames.cn("relative", className),
+        style,
+        ...rest,
+        children: [
+          children,
+          loading && /* @__PURE__ */ jsxRuntime.jsxs(
+            "div",
+            {
+              className: classNames.cn(
+                "inset-0 flex items-center justify-center",
+                position === "fixed" ? "fixed" : "absolute"
+              ),
+              style: {
+                zIndex
+              },
+              role: "status",
+              "aria-label": ariaLabel,
+              "aria-busy": "true",
+              children: [
+                /* @__PURE__ */ jsxRuntime.jsx(
+                  "div",
+                  {
+                    className: "absolute inset-0",
+                    style: backdropStyles,
+                    "aria-hidden": "true"
+                  }
+                ),
+                /* @__PURE__ */ jsxRuntime.jsx("div", { className: "relative z-10", children: loader })
+              ]
+            }
+          )
+        ]
+      }
+    );
+  }
+);
+LoaderOverlay.displayName = "LoaderOverlay";
+exports.LoaderOverlay = LoaderOverlay;
+//# sourceMappingURL=index29.cjs.map

package/dist/index29.cjs.map

@@ -0,0 +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;;"}

package/dist/index29.js

@@ -0,0 +1,71 @@
+import { jsxs, jsx } from "react/jsx-runtime";
+import { forwardRef } from "react";
+import { cn } from "./index3.js";
+const LoaderOverlay = forwardRef(
+  ({
+    loading = false,
+    loader,
+    children,
+    position = "fixed",
+    backdropOpacity = 0.5,
+    backdropColor = "#000000",
+    blur = false,
+    className,
+    style,
+    testId = "loader-overlay",
+    ariaLabel = "Loading content...",
+    zIndex = 9999,
+    ...rest
+  }, ref) => {
+    const backdropStyles = {
+      backgroundColor: backdropColor,
+      opacity: backdropOpacity,
+      backdropFilter: blur ? "blur(4px)" : void 0,
+      WebkitBackdropFilter: blur ? "blur(4px)" : void 0
+    };
+    return /* @__PURE__ */ jsxs(
+      "div",
+      {
+        ref,
+        "data-testid": testId,
+        className: cn("relative", className),
+        style,
+        ...rest,
+        children: [
+          children,
+          loading && /* @__PURE__ */ jsxs(
+            "div",
+            {
+              className: cn(
+                "inset-0 flex items-center justify-center",
+                position === "fixed" ? "fixed" : "absolute"
+              ),
+              style: {
+                zIndex
+              },
+              role: "status",
+              "aria-label": ariaLabel,
+              "aria-busy": "true",
+              children: [
+                /* @__PURE__ */ jsx(
+                  "div",
+                  {
+                    className: "absolute inset-0",
+                    style: backdropStyles,
+                    "aria-hidden": "true"
+                  }
+                ),
+                /* @__PURE__ */ jsx("div", { className: "relative z-10", children: loader })
+              ]
+            }
+          )
+        ]
+      }
+    );
+  }
+);
+LoaderOverlay.displayName = "LoaderOverlay";
+export {
+  LoaderOverlay
+};
+//# sourceMappingURL=index29.js.map

package/dist/index29.js.map

@@ -0,0 +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;"}

package/dist/index3.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const clsx = require("./index25.cjs");
+const clsx = require("./index30.cjs");
 function cn(...inputs) {
   return clsx.clsx(inputs);
 }

package/dist/index3.js

@@ -1,4 +1,4 @@
-import { clsx } from "./index25.js";
+import { clsx } from "./index30.js";
 function cn(...inputs) {
   return clsx(inputs);
 }

package/dist/index30.cjs

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: "Module" } });
+function r(e) {
+  var t, f, n = "";
+  if ("string" == typeof e || "number" == typeof e) n += e;
+  else if ("object" == typeof e) if (Array.isArray(e)) {
+    var o = e.length;
+    for (t = 0; t < o; t++) e[t] && (f = r(e[t])) && (n && (n += " "), n += f);
+  } else for (f in e) e[f] && (n && (n += " "), n += f);
+  return n;
+}
+function clsx() {
+  for (var e, t, f = 0, n = "", o = arguments.length; f < o; f++) (e = arguments[f]) && (t = r(e)) && (n && (n += " "), n += t);
+  return n;
+}
+exports.clsx = clsx;
+exports.default = clsx;
+//# sourceMappingURL=index30.cjs.map

package/dist/index30.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index30.cjs","sources":["../node_modules/clsx/dist/clsx.mjs"],"sourcesContent":["function r(e){var t,f,n=\"\";if(\"string\"==typeof e||\"number\"==typeof e)n+=e;else if(\"object\"==typeof e)if(Array.isArray(e)){var o=e.length;for(t=0;t<o;t++)e[t]&&(f=r(e[t]))&&(n&&(n+=\" \"),n+=f)}else for(f in e)e[f]&&(n&&(n+=\" \"),n+=f);return n}export function clsx(){for(var e,t,f=0,n=\"\",o=arguments.length;f<o;f++)(e=arguments[f])&&(t=r(e))&&(n&&(n+=\" \"),n+=t);return n}export default clsx;"],"names":[],"mappings":";;AAAA,SAAS,EAAE,GAAE;AAAC,MAAI,GAAE,GAAE,IAAE;AAAG,MAAG,YAAU,OAAO,KAAG,YAAU,OAAO,EAAE,MAAG;AAAA,WAAU,YAAU,OAAO,EAAE,KAAG,MAAM,QAAQ,CAAC,GAAE;AAAC,QAAI,IAAE,EAAE;AAAO,SAAI,IAAE,GAAE,IAAE,GAAE,IAAI,GAAE,CAAC,MAAI,IAAE,EAAE,EAAE,CAAC,CAAC,OAAK,MAAI,KAAG,MAAK,KAAG;AAAA,EAAE,MAAM,MAAI,KAAK,EAAE,GAAE,CAAC,MAAI,MAAI,KAAG,MAAK,KAAG;AAAG,SAAO;AAAC;AAAQ,SAAS,OAAM;AAAC,WAAQ,GAAE,GAAE,IAAE,GAAE,IAAE,IAAG,IAAE,UAAU,QAAO,IAAE,GAAE,IAAI,EAAC,IAAE,UAAU,CAAC,OAAK,IAAE,EAAE,CAAC,OAAK,MAAI,KAAG,MAAK,KAAG;AAAG,SAAO;AAAC;;;","x_google_ignoreList":[0]}

package/dist/index30.js

@@ -0,0 +1,18 @@
+function r(e) {
+  var t, f, n = "";
+  if ("string" == typeof e || "number" == typeof e) n += e;
+  else if ("object" == typeof e) if (Array.isArray(e)) {
+    var o = e.length;
+    for (t = 0; t < o; t++) e[t] && (f = r(e[t])) && (n && (n += " "), n += f);
+  } else for (f in e) e[f] && (n && (n += " "), n += f);
+  return n;
+}
+function clsx() {
+  for (var e, t, f = 0, n = "", o = arguments.length; f < o; f++) (e = arguments[f]) && (t = r(e)) && (n && (n += " "), n += t);
+  return n;
+}
+export {
+  clsx,
+  clsx as default
+};
+//# sourceMappingURL=index30.js.map

package/dist/index30.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index30.js","sources":["../node_modules/clsx/dist/clsx.mjs"],"sourcesContent":["function r(e){var t,f,n=\"\";if(\"string\"==typeof e||\"number\"==typeof e)n+=e;else if(\"object\"==typeof e)if(Array.isArray(e)){var o=e.length;for(t=0;t<o;t++)e[t]&&(f=r(e[t]))&&(n&&(n+=\" \"),n+=f)}else for(f in e)e[f]&&(n&&(n+=\" \"),n+=f);return n}export function clsx(){for(var e,t,f=0,n=\"\",o=arguments.length;f<o;f++)(e=arguments[f])&&(t=r(e))&&(n&&(n+=\" \"),n+=t);return n}export default clsx;"],"names":[],"mappings":"AAAA,SAAS,EAAE,GAAE;AAAC,MAAI,GAAE,GAAE,IAAE;AAAG,MAAG,YAAU,OAAO,KAAG,YAAU,OAAO,EAAE,MAAG;AAAA,WAAU,YAAU,OAAO,EAAE,KAAG,MAAM,QAAQ,CAAC,GAAE;AAAC,QAAI,IAAE,EAAE;AAAO,SAAI,IAAE,GAAE,IAAE,GAAE,IAAI,GAAE,CAAC,MAAI,IAAE,EAAE,EAAE,CAAC,CAAC,OAAK,MAAI,KAAG,MAAK,KAAG;AAAA,EAAE,MAAM,MAAI,KAAK,EAAE,GAAE,CAAC,MAAI,MAAI,KAAG,MAAK,KAAG;AAAG,SAAO;AAAC;AAAQ,SAAS,OAAM;AAAC,WAAQ,GAAE,GAAE,IAAE,GAAE,IAAE,IAAG,IAAE,UAAU,QAAO,IAAE,GAAE,IAAI,EAAC,IAAE,UAAU,CAAC,OAAK,IAAE,EAAE,CAAC,OAAK,MAAI,KAAG,MAAK,KAAG;AAAG,SAAO;AAAC;","x_google_ignoreList":[0]}

package/dist/index4.cjs

@@ -1,15 +1,30 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-function getAnimationDuration(speed) {
+function isHexColor(color) {
+  return /^#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})$/.test(color);
+}
+function isRgbColor(color) {
+  return /^rgba?\([\d\s,./]+\)$/.test(color);
+}
+function hexToRgb(hex) {
+  const result = /^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(hex);
+  return result ? {
+    r: parseInt(result[1], 16),
+    g: parseInt(result[2], 16),
+    b: parseInt(result[3], 16)
+  } : null;
+}
+function getAnimationDuration(speed = "normal") {
   if (typeof speed === "number") {
-    return `${speed}ms`;
+    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];
+  return speedMap[speed] || speedMap.normal;
 }
 function normalizeSize(size) {
   if (typeof size === "number") {
@@ -17,6 +32,51 @@ function normalizeSize(size) {
   }
   return size || "auto";
 }
+function parseSizeToNumber(size, fallback) {
+  if (typeof size === "number") {
+    return !isNaN(size) && size > 0 ? size : fallback;
+  }
+  if (typeof size === "string") {
+    const parsed = parseInt(size, 10);
+    return !isNaN(parsed) && parsed > 0 ? parsed : fallback;
+  }
+  return fallback;
+}
+function getColorLuminance(color) {
+  if (isHexColor(color)) {
+    const rgb = hexToRgb(color);
+    if (rgb) {
+      const { r, g, b } = rgb;
+      const [rs, gs, bs] = [r, g, b].map((c) => {
+        const val = c / 255;
+        return val <= 0.03928 ? val / 12.92 : Math.pow((val + 0.055) / 1.055, 2.4);
+      });
+      return 0.2126 * rs + 0.7152 * gs + 0.0722 * bs;
+    }
+  }
+  if (isRgbColor(color)) {
+    const match = color.match(/rgba?\((\d+),\s*(\d+),\s*(\d+)/);
+    if (match) {
+      const [, r, g, b] = match.map(Number);
+      const [rs, gs, bs] = [r, g, b].map((c) => {
+        const val = c / 255;
+        return val <= 0.03928 ? val / 12.92 : Math.pow((val + 0.055) / 1.055, 2.4);
+      });
+      return 0.2126 * rs + 0.7152 * gs + 0.0722 * bs;
+    }
+  }
+  return 0.5;
+}
+function getContrastColor(backgroundColor) {
+  const luminance = getColorLuminance(backgroundColor);
+  return luminance < 0.5 ? "#ffffff" : "#000000";
+}
 exports.getAnimationDuration = getAnimationDuration;
+exports.getColorLuminance = getColorLuminance;
+exports.getContrastColor = getContrastColor;
+exports.hexToRgb = hexToRgb;
+exports.isHexColor = isHexColor;
+exports.isRgbColor = isRgbColor;
 exports.normalizeSize = normalizeSize;
+exports.parseSizeToNumber = parseSizeToNumber;
 //# sourceMappingURL=index4.cjs.map

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): string {\n  if (typeof speed === 'number') {\n    return `${speed}ms`;\n  }\n\n  const speedMap = {\n    slow: '2s',\n    normal: '1s',\n    fast: '0.5s',\n  };\n\n  return speedMap[speed];\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"],"names":[],"mappings":";;AA+BO,SAAS,qBAAqB,OAAoD;AACvF,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,GAAG,KAAK;AAAA,EACjB;AAEA,QAAM,WAAW;AAAA,IACf,MAAM;AAAA,IACN,QAAQ;AAAA,IACR,MAAM;AAAA,EAAA;AAGR,SAAO,SAAS,KAAK;AACvB;AAKO,SAAS,cAAc,MAAgC;AAC5D,MAAI,OAAO,SAAS,UAAU;AAC5B,WAAO,GAAG,IAAI;AAAA,EAChB;AACA,SAAO,QAAQ;AACjB;;;"}
+{"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;;;;;;;;;"}

package/dist/index4.js

@@ -1,13 +1,28 @@
-function getAnimationDuration(speed) {
+function isHexColor(color) {
+  return /^#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})$/.test(color);
+}
+function isRgbColor(color) {
+  return /^rgba?\([\d\s,./]+\)$/.test(color);
+}
+function hexToRgb(hex) {
+  const result = /^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(hex);
+  return result ? {
+    r: parseInt(result[1], 16),
+    g: parseInt(result[2], 16),
+    b: parseInt(result[3], 16)
+  } : null;
+}
+function getAnimationDuration(speed = "normal") {
   if (typeof speed === "number") {
-    return `${speed}ms`;
+    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];
+  return speedMap[speed] || speedMap.normal;
 }
 function normalizeSize(size) {
   if (typeof size === "number") {
@@ -15,8 +30,53 @@ function normalizeSize(size) {
   }
   return size || "auto";
 }
+function parseSizeToNumber(size, fallback) {
+  if (typeof size === "number") {
+    return !isNaN(size) && size > 0 ? size : fallback;
+  }
+  if (typeof size === "string") {
+    const parsed = parseInt(size, 10);
+    return !isNaN(parsed) && parsed > 0 ? parsed : fallback;
+  }
+  return fallback;
+}
+function getColorLuminance(color) {
+  if (isHexColor(color)) {
+    const rgb = hexToRgb(color);
+    if (rgb) {
+      const { r, g, b } = rgb;
+      const [rs, gs, bs] = [r, g, b].map((c) => {
+        const val = c / 255;
+        return val <= 0.03928 ? val / 12.92 : Math.pow((val + 0.055) / 1.055, 2.4);
+      });
+      return 0.2126 * rs + 0.7152 * gs + 0.0722 * bs;
+    }
+  }
+  if (isRgbColor(color)) {
+    const match = color.match(/rgba?\((\d+),\s*(\d+),\s*(\d+)/);
+    if (match) {
+      const [, r, g, b] = match.map(Number);
+      const [rs, gs, bs] = [r, g, b].map((c) => {
+        const val = c / 255;
+        return val <= 0.03928 ? val / 12.92 : Math.pow((val + 0.055) / 1.055, 2.4);
+      });
+      return 0.2126 * rs + 0.7152 * gs + 0.0722 * bs;
+    }
+  }
+  return 0.5;
+}
+function getContrastColor(backgroundColor) {
+  const luminance = getColorLuminance(backgroundColor);
+  return luminance < 0.5 ? "#ffffff" : "#000000";
+}
 export {
   getAnimationDuration,
-  normalizeSize
+  getColorLuminance,
+  getContrastColor,
+  hexToRgb,
+  isHexColor,
+  isRgbColor,
+  normalizeSize,
+  parseSizeToNumber
 };
 //# sourceMappingURL=index4.js.map

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): string {\n  if (typeof speed === 'number') {\n    return `${speed}ms`;\n  }\n\n  const speedMap = {\n    slow: '2s',\n    normal: '1s',\n    fast: '0.5s',\n  };\n\n  return speedMap[speed];\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"],"names":[],"mappings":"AA+BO,SAAS,qBAAqB,OAAoD;AACvF,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,GAAG,KAAK;AAAA,EACjB;AAEA,QAAM,WAAW;AAAA,IACf,MAAM;AAAA,IACN,QAAQ;AAAA,IACR,MAAM;AAAA,EAAA;AAGR,SAAO,SAAS,KAAK;AACvB;AAKO,SAAS,cAAc,MAAgC;AAC5D,MAAI,OAAO,SAAS,UAAU;AAC5B,WAAO,GAAG,IAAI;AAAA,EAChB;AACA,SAAO,QAAQ;AACjB;"}
+{"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;"}