meticulous-ui 3.0.7 → 3.1.1

package/README.md

@@ -78,6 +78,7 @@ import blue from 'meticulous-ui/colors/blue';
 | `PageLoader`    | Renders a loader with line at the top of page                    |
 | `Button`        | Renders a button to click & take an action                       |
 | `Shimmer`       | Animated skeleton loading placeholder                            |
+| `Carousel`      | Carousel providing slider between components displaying slides   |
 | `RootComponent` | This is the required wrapper for any app that uses meticulous-ui |
 
 ## 📦 Icon Components

package/components/Carousel/Carousel.js

@@ -0,0 +1,189 @@
+import { jsxs as X, jsx as r } from "react/jsx-runtime";
+import { useState as a, useRef as T, useEffect as E } from "react";
+import le from "../Icons/ChevronLeft/ChevronLeft.js";
+import de from "../Icons/ChevronRight/ChevronRight.js";
+import { Wrapper as he, SlideArea as fe, NavButton as N, SlideViewport as me, SlideTrack as pe, PauseButton as ve, ProgressBar as we, DotsWrapper as ge, Dot as Me } from "./styles.js";
+const I = 50, R = 2e3, be = () => /* @__PURE__ */ X("svg", { width: 12, height: 12, viewBox: "0 0 12 12", fill: "currentColor", "aria-hidden": "true", children: [
+  /* @__PURE__ */ r("rect", { x: "2", y: "1", width: "3", height: "10", rx: "1" }),
+  /* @__PURE__ */ r("rect", { x: "7", y: "1", width: "3", height: "10", rx: "1" })
+] }), $e = () => /* @__PURE__ */ r("svg", { width: 12, height: 12, viewBox: "0 0 12 12", fill: "currentColor", "aria-hidden": "true", children: /* @__PURE__ */ r("path", { d: "M2 1.5l9 4.5-9 4.5V1.5z" }) }), ke = ({
+  data: P,
+  renderCarousel: q,
+  visibleSlides: k = 1,
+  overlayArrows: o = !1,
+  arrowTop: v,
+  areDotsHidden: Y = !1,
+  autoSlide: w = !1,
+  autoSlideSec: C = 3,
+  loop: l = !1,
+  dragToSlide: g = !1,
+  liveDrag: M = !1,
+  liveDragMobile: L = !0,
+  showProgress: G = !1,
+  defaultIndex: J = 0,
+  onSlideChange: y
+}) => {
+  var K;
+  const [n, b] = a(J), [B, d] = a(!0), [V, W] = a(!1), [h, f] = a(!1), [Q, m] = a(0), [F, p] = a(!1), [D, _] = a(!1), c = T(null), i = T(null), u = T(null), z = T(null);
+  E(() => {
+    const e = window.matchMedia("(max-width: 1024px)");
+    _(e.matches);
+    const t = (ue) => _(ue.matches);
+    return e.addEventListener("change", t), () => e.removeEventListener("change", t);
+  }, []);
+  const s = P.length - k, $ = () => b((e) => l && e === 0 ? s : Math.max(e - 1, 0)), x = () => b((e) => l && e >= s ? 0 : Math.min(e + 1, s));
+  E(() => {
+    y == null || y(n);
+  }, [n]);
+  const H = () => {
+    o && (clearTimeout(u.current), d(!0), u.current = setTimeout(() => d(!1), R));
+  }, Z = () => {
+    f(!0), o && (clearTimeout(u.current), d(!0));
+  }, S = () => {
+    f(!1), o && (u.current = setTimeout(() => d(!1), R));
+  };
+  E(() => {
+    if (o)
+      return u.current = setTimeout(() => d(!1), R), () => clearTimeout(u.current);
+  }, [o]), E(() => {
+    if (!w || h) return;
+    const e = setInterval(() => {
+      b((t) => t >= s ? 0 : t + 1);
+    }, C * 1e3);
+    return () => clearInterval(e);
+  }, [w, C, h, s]);
+  const U = (e) => l ? e : n === 0 && e > 0 || n === s && e < 0 ? e * 0.3 : e, ee = (e) => {
+    c.current = e.touches[0].clientX, L && D && p(!0), H();
+  }, te = (e) => {
+    !L || !D || c.current === null || m(U(e.touches[0].clientX - c.current));
+  }, re = (e) => {
+    if (L && D && (p(!1), m(0)), c.current === null) return;
+    const t = c.current - e.changedTouches[0].clientX;
+    t > I ? x() : t < -I && $(), c.current = null;
+  }, ne = (e) => {
+    g && (i.current = e.clientX, M && p(!0));
+  }, se = (e) => {
+    !g || !M || i.current === null || m(U(e.clientX - i.current));
+  }, oe = (e) => {
+    if (!g || i.current === null) return;
+    M && (p(!1), m(0));
+    const t = i.current - e.clientX;
+    t > I ? x() : t < -I && $(), i.current = null;
+  }, ie = (e) => {
+    e.key === "ArrowLeft" ? (e.preventDefault(), $()) : e.key === "ArrowRight" && (e.preventDefault(), x());
+  }, j = ((K = z.current) == null ? void 0 : K.clientWidth) ?? 0, ae = j > 0 ? Q / j * 100 : 0, ce = -(n * (100 / k)) + ae, A = v !== void 0 ? typeof v == "number" ? `${v}px` : v : void 0, O = s + 1;
+  return /* @__PURE__ */ X(
+    he,
+    {
+      onClick: H,
+      onMouseEnter: Z,
+      onMouseLeave: S,
+      onMouseMove: se,
+      onMouseUp: oe,
+      onKeyDown: ie,
+      role: "region",
+      "aria-label": "Carousel",
+      children: [
+        /* @__PURE__ */ X(
+          fe,
+          {
+            onTouchStart: ee,
+            onTouchMove: te,
+            onTouchEnd: re,
+            children: [
+              /* @__PURE__ */ r(
+                N,
+                {
+                  onClick: $,
+                  disabled: !l && n === 0,
+                  "aria-label": "Previous slide",
+                  $overlay: o,
+                  $visible: B,
+                  $arrowTop: A,
+                  $viewportFocused: V,
+                  children: /* @__PURE__ */ r(le, { size: 20, "aria-hidden": "true" })
+                }
+              ),
+              /* @__PURE__ */ r(
+                me,
+                {
+                  ref: z,
+                  tabIndex: 0,
+                  "aria-label": "Carousel slides. Use arrow keys to navigate.",
+                  $draggable: g,
+                  onFocus: () => {
+                    W(!0), f(!0);
+                  },
+                  onBlur: () => {
+                    W(!1), f(!1);
+                  },
+                  onMouseDown: ne,
+                  onMouseLeave: (e) => {
+                    e.buttons !== 1 && (M && F && (p(!1), m(0)), i.current = null);
+                  },
+                  children: /* @__PURE__ */ r(pe, { $translateX: ce, $visibleSlides: k, $dragging: F, children: P.map(q) })
+                }
+              ),
+              /* @__PURE__ */ r(
+                N,
+                {
+                  onClick: x,
+                  disabled: !l && n === s,
+                  "aria-label": "Next slide",
+                  $overlay: o,
+                  $visible: B,
+                  $arrowTop: A,
+                  $viewportFocused: V,
+                  children: /* @__PURE__ */ r(de, { size: 20, "aria-hidden": "true" })
+                }
+              ),
+              w && /* @__PURE__ */ r(
+                ve,
+                {
+                  onClick: () => f((e) => !e),
+                  "aria-label": h ? "Play slideshow" : "Pause slideshow",
+                  children: h ? /* @__PURE__ */ r($e, {}) : /* @__PURE__ */ r(be, {})
+                }
+              )
+            ]
+          }
+        ),
+        /* @__PURE__ */ X(
+          "div",
+          {
+            "aria-live": "polite",
+            "aria-atomic": "true",
+            style: {
+              position: "absolute",
+              width: 1,
+              height: 1,
+              overflow: "hidden",
+              clip: "rect(0,0,0,0)",
+              whiteSpace: "nowrap"
+            },
+            children: [
+              "Slide ",
+              n + 1,
+              " of ",
+              O
+            ]
+          }
+        ),
+        w && G && /* @__PURE__ */ r(we, { $duration: C, $paused: h }, n),
+        !Y && /* @__PURE__ */ r(ge, { children: Array.from({ length: O }).map((e, t) => /* @__PURE__ */ r(
+          Me,
+          {
+            $active: t === n,
+            onClick: () => b(t),
+            "aria-label": `Slide ${t + 1} of ${O}`,
+            "aria-current": t === n ? "true" : void 0
+          },
+          t
+        )) })
+      ]
+    }
+  );
+};
+export {
+  ke as default
+};

package/components/Carousel/index.js

@@ -0,0 +1,4 @@
+import r from "./Carousel.js";
+export {
+  r as default
+};

package/components/Carousel/styles.js

@@ -0,0 +1,166 @@
+import o, { keyframes as i } from "styled-components";
+const d = o.div`
+  position: relative;
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  width: 100%;
+  gap: 12px;
+  outline: none;
+`, a = o.div`
+  position: relative;
+  width: 100%;
+`, s = o.div`
+  overflow: hidden;
+  width: 100%;
+  outline: none;
+  cursor: ${({ $draggable: e }) => e ? "grab" : "default"};
+
+  &:active {
+    cursor: ${({ $draggable: e }) => e ? "grabbing" : "default"};
+  }
+`, p = o.div`
+  display: flex;
+  width: 100%;
+  transform: translateX(${({ $translateX: e }) => e}%);
+  transition: ${({ $dragging: e }) => e ? "none" : "transform 0.35s ease"};
+
+  @media (prefers-reduced-motion: reduce) {
+    transition: none;
+  }
+
+  & > * {
+    flex: 0 0 ${({ $visibleSlides: e }) => 100 / e}%;
+    min-width: 0;
+    box-sizing: border-box;
+  }
+`, c = o.button`
+  position: absolute;
+  top: ${({ $arrowTop: e }) => e ?? "50%"};
+  transform: translateY(-50%);
+  z-index: 1;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 32px;
+  height: 32px;
+  border-radius: 50%;
+  border: 1px solid #e0e0e0;
+  background: #fff;
+  cursor: pointer;
+  color: #333;
+  transition:
+    background 0.15s,
+    opacity 0.3s;
+  padding: 0;
+
+  &:first-of-type {
+    left: ${({ $overlay: e }) => e ? "12px" : "-16px"};
+  }
+
+  &:last-of-type {
+    right: ${({ $overlay: e }) => e ? "12px" : "-16px"};
+  }
+
+  &:hover:not(:disabled) {
+    background: #f5f5f5;
+  }
+
+  &:disabled {
+    opacity: 0.3;
+    cursor: default;
+  }
+
+  &:focus-visible {
+    outline: none;
+    background: #ffe4ec;
+    border-color: #f9a8c0;
+  }
+
+  ${({ $viewportFocused: e }) => e && `
+    border-color: #bdbdbd;
+  `}
+
+  ${({ $overlay: e, $visible: t }) => e && !t && `
+    opacity: 0;
+    pointer-events: none;
+  `}
+`, l = o.div`
+  display: flex;
+  gap: 6px;
+  align-items: center;
+`, u = o.button`
+  width: ${({ $active: e }) => e ? "20px" : "8px"};
+  height: 8px;
+  border-radius: 4px;
+  border: none;
+  background: ${({ $active: e }) => e ? "#333" : "#ccc"};
+  cursor: pointer;
+  padding: 0;
+  transition:
+    width 0.2s ease,
+    background 0.2s ease;
+`, r = i`
+  from { width: 0%; }
+  to { width: 100%; }
+`, f = o.div`
+  width: 100%;
+  height: 3px;
+  background: #e0e0e0;
+  border-radius: 2px;
+  overflow: hidden;
+  position: relative;
+
+  &::after {
+    content: '';
+    position: absolute;
+    inset: 0;
+    width: 0%;
+    background: #333;
+    animation: ${r} ${({ $duration: e }) => e}s linear forwards;
+    animation-play-state: ${({ $paused: e }) => e ? "paused" : "running"};
+
+    @media (prefers-reduced-motion: reduce) {
+      animation: none;
+      width: 100%;
+    }
+  }
+`, b = o.button`
+  position: absolute;
+  bottom: 8px;
+  right: 8px;
+  z-index: 2;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 24px;
+  height: 24px;
+  border-radius: 50%;
+  border: 1px solid rgba(255, 255, 255, 0.6);
+  background: rgba(0, 0, 0, 0.35);
+  color: #fff;
+  cursor: pointer;
+  padding: 0;
+  backdrop-filter: blur(2px);
+  transition: background 0.15s;
+
+  &:hover {
+    background: rgba(0, 0, 0, 0.55);
+  }
+
+  &:focus-visible {
+    outline: 2px solid #fff;
+    outline-offset: 2px;
+  }
+`;
+export {
+  u as Dot,
+  l as DotsWrapper,
+  c as NavButton,
+  b as PauseButton,
+  f as ProgressBar,
+  a as SlideArea,
+  p as SlideTrack,
+  s as SlideViewport,
+  d as Wrapper
+};

package/index.js

@@ -2,50 +2,52 @@ import { default as a } from "./components/Pagination/Pagination.js";
 import { default as r, ToastContainer as f } from "./components/Toast/Toast.js";
 import { default as d } from "./components/Spinner/Spinner.js";
 import { default as s } from "./components/Loader/Loader.js";
-import { default as u } from "./components/PageLoader/PageLoader.js";
+import { default as m } from "./components/PageLoader/PageLoader.js";
 import { default as n } from "./components/OtpInput/OtpInput.js";
 import { default as c } from "./components/Dropdown/Dropdown.js";
-import { default as P } from "./components/RootComponent/RootComponent.js";
-import { default as C } from "./components/Selectbox/Selectbox.js";
+import { default as C } from "./components/RootComponent/RootComponent.js";
+import { default as T } from "./components/Selectbox/Selectbox.js";
 import { default as S } from "./components/Button/Button.js";
 import { default as h } from "./components/Timer/Timer.js";
 import { default as R } from "./components/Shimmer/Shimmer.js";
 import { default as w } from "./components/VideoPlayer/VideoPlayer.js";
 import { default as B } from "./components/Image/Image.js";
-import { default as F } from "./components/Typography/Headings/index.js";
-import { default as H } from "./components/Typography/P/P.js";
-import { default as U } from "./components/Input/Input/Input.js";
-import { default as j } from "./components/Input/Textarea/Textarea.js";
-import { default as v } from "./components/Input/Checkbox/Checkbox.js";
-import { default as A } from "./components/Input/RadioGroup/RadioGroup.js";
-import { default as J } from "./components/Input/FileUploader/FileUploader.js";
-import { default as M } from "./colors/index.js";
-import { default as Q } from "./utils/index.js";
-import { default as X } from "./components/Icons/index.js";
+import { default as F } from "./components/Carousel/Carousel.js";
+import { default as H } from "./components/Typography/Headings/index.js";
+import { default as U } from "./components/Typography/P/P.js";
+import { default as j } from "./components/Input/Input/Input.js";
+import { default as v } from "./components/Input/Textarea/Textarea.js";
+import { default as A } from "./components/Input/Checkbox/Checkbox.js";
+import { default as J } from "./components/Input/RadioGroup/RadioGroup.js";
+import { default as M } from "./components/Input/FileUploader/FileUploader.js";
+import { default as Q } from "./colors/index.js";
+import { default as X } from "./utils/index.js";
+import { default as Z } from "./components/Icons/index.js";
 export {
   S as Button,
-  v as Checkbox,
+  F as Carousel,
+  A as Checkbox,
   c as Dropdown,
-  J as FileUploader,
-  F as Headings,
+  M as FileUploader,
+  H as Headings,
   B as Image,
-  U as Input,
+  j as Input,
   s as Loader,
   n as OtpInput,
-  H as P,
-  u as PageLoader,
+  U as P,
+  m as PageLoader,
   a as Pagination,
-  A as RadioGroup,
-  P as RootComponent,
-  C as Selectbox,
+  J as RadioGroup,
+  C as RootComponent,
+  T as Selectbox,
   R as Shimmer,
   d as Spinner,
-  j as Textarea,
+  v as Textarea,
   h as Timer,
   r as Toast,
   f as ToastContainer,
   w as VideoPlayer,
-  M as colors,
-  X as icons,
-  Q as utils
+  Q as colors,
+  Z as icons,
+  X as utils
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "meticulous-ui",
-  "version": "3.0.7",
+  "version": "3.1.1",
   "license": "MIT",
   "description": "A comprehensive React UI component library with a wide range of customizable components, icons, colors, and utilities for building modern web applications.",
   "main": "./index.js",