@vkzstudio/muza-ui 1.5.2 → 1.7.0

package/dist/components/Button/Button.js

@@ -1,69 +1,71 @@
-import { jsxs as j, jsx as o } from "react/jsx-runtime";
-import * as m from "react";
-import { Slot as v, Slottable as u } from "@radix-ui/react-slot";
+import { jsxs as h, jsx as a } from "react/jsx-runtime";
+import * as s from "react";
+import { Slot as j, Slottable as c } from "@radix-ui/react-slot";
 import "class-variance-authority";
-import { cn as c } from "../../utils/cn.js";
-import { Typography as w } from "../Typography/Typography.js";
-import { ButtonLoader as E } from "./ButtonLoader.js";
+import { cn as b } from "../../utils/cn.js";
+import { Typography as v } from "../Typography/Typography.js";
+import { ButtonLoader as w } from "./ButtonLoader.js";
 import { buttonVariants as R } from "./buttonVariants.js";
-const S = m.forwardRef(
+const S = s.forwardRef(
   ({
     className: y,
-    variant: b,
-    size: a,
-    fullWidth: x,
-    asChild: p = !1,
-    icon: r,
-    iconPosition: n = "start",
-    secondIcon: s,
+    variant: x,
+    size: o,
+    fullWidth: N,
+    asChild: e = !1,
+    icon: m,
+    iconPosition: l = "start",
+    secondIcon: n,
     ghost: d = !1,
     danger: f = !1,
-    loading: e = !1,
+    loading: p = !1,
     children: t,
-    ...h
-  }, N) => {
-    const g = p ? v : "button", i = a === "icon" || d, l = (L) => /* @__PURE__ */ o(
-      w,
+    ...g
+  }, B) => {
+    const E = e ? j : "button", i = o === "icon" || d, u = (V) => /* @__PURE__ */ a(
+      v,
       {
         variant: "cta",
-        size: a === "sm" || a === "xs" ? "sm" : "base",
+        size: o === "sm" || o === "xs" ? "sm" : "base",
         weight: "medium",
         component: "span",
         fixY: !0,
-        className: c("transition-opacity", {
-          "opacity-0": e
+        className: b("transition-opacity", {
+          "opacity-0": p
         }),
-        children: L
+        children: V
       }
-    ), B = () => p ? m.isValidElement(t) ? /* @__PURE__ */ o(u, { children: m.cloneElement(
+    ), r = e && s.isValidElement(t) ? t.props.children : t, L = () => e ? s.isValidElement(t) ? /* @__PURE__ */ a(c, { children: s.cloneElement(
       t,
       void 0,
-      l(t.props.children)
-    ) }) : /* @__PURE__ */ o(u, { children: t }) : t && l(t);
-    return /* @__PURE__ */ j(
-      g,
+      // Skip the label wrapper for icon-only children so the flex gap
+      // doesn't offset the icon.
+      r && u(r)
+    ) }) : /* @__PURE__ */ a(c, { children: t }) : t && u(t);
+    return /* @__PURE__ */ h(
+      E,
       {
-        className: c(
+        className: b(
           R({
-            variant: b,
-            size: a,
-            fullWidth: x,
-            iconOnly: a === "icon" || !t,
+            variant: x,
+            size: o,
+            fullWidth: N,
+            iconOnly: o === "icon" || !r,
             ghost: i,
             danger: f,
-            loading: e,
+            loading: p,
             className: y
           })
         ),
-        ref: N,
+        ref: B,
         "data-ghost": i,
         "data-danger": f,
-        ...h,
+        ...g,
         children: [
-          e && /* @__PURE__ */ o("span", { className: "absolute", children: /* @__PURE__ */ o(E, {}) }),
-          (s || n === "start") && r,
-          B(),
-          s || n === "end" && r
+          p && /* @__PURE__ */ a("span", { className: "absolute", children: /* @__PURE__ */ a(w, {}) }),
+          (n || l === "start") && m,
+          L(),
+          n || l === "end" && m
         ]
       }
     );

package/dist/components/Button/Button.stories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Button.stories.d.ts","sourceRoot":"","sources":["../../../src/components/Button/Button.stories.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAW3D,OAAO,EAAE,MAAM,EAAoB,MAAM,UAAU,CAAA;AAoBnD,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,OAAO,MAAM,CAqF7B,CAAA;AAED,eAAe,IAAI,CAAA;AACnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,MAAM,CAAC,CAAA;AAEpC,eAAO,MAAM,OAAO,EAAE,KAarB,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,KAetB,CAAA;AAED,eAAO,MAAM,eAAe,EAAE,KAe7B,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,KAoCtB,CAAA;AAED,eAAO,MAAM,SAAS,EAAE,KAgBvB,CAAA;AAED,eAAO,MAAM,WAAW,EAAE,KAyCzB,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,KAkDtB,CAAA;AAED,eAAO,MAAM,iBAAiB,EAAE,KAmF/B,CAAA;AAED,eAAO,MAAM,YAAY,EAAE,KA8D1B,CAAA;AAED,eAAO,MAAM,cAAc,EAAE,KAgB5B,CAAA;AAED,eAAO,MAAM,aAAa,EAAE,KAgB3B,CAAA;AAcD,eAAO,MAAM,gBAAgB,EAAE,KAqL9B,CAAA;AAED,eAAO,MAAM,iBAAiB,EAAE,KAgC/B,CAAA"}
+{"version":3,"file":"Button.stories.d.ts","sourceRoot":"","sources":["../../../src/components/Button/Button.stories.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAW3D,OAAO,EAAE,MAAM,EAAoB,MAAM,UAAU,CAAA;AAoBnD,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,OAAO,MAAM,CAqF7B,CAAA;AAED,eAAe,IAAI,CAAA;AACnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,MAAM,CAAC,CAAA;AAEpC,eAAO,MAAM,OAAO,EAAE,KAarB,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,KAetB,CAAA;AAED,eAAO,MAAM,eAAe,EAAE,KAe7B,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,KAoCtB,CAAA;AAED,eAAO,MAAM,SAAS,EAAE,KAgBvB,CAAA;AAED,eAAO,MAAM,WAAW,EAAE,KAyCzB,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,KAkDtB,CAAA;AAED,eAAO,MAAM,iBAAiB,EAAE,KAmF/B,CAAA;AAED,eAAO,MAAM,YAAY,EAAE,KA8D1B,CAAA;AAED,eAAO,MAAM,cAAc,EAAE,KAgB5B,CAAA;AAED,eAAO,MAAM,aAAa,EAAE,KAgB3B,CAAA;AAcD,eAAO,MAAM,gBAAgB,EAAE,KAqM9B,CAAA;AAED,eAAO,MAAM,iBAAiB,EAAE,KAgC/B,CAAA"}

package/dist/components/Carousel/Carousel.d.ts

@@ -66,6 +66,10 @@ export interface CarouselProps {
      * Embla plugins forwarded as the second argument to `useEmblaCarousel`
      * (autoplay, classnames, fade, etc.).
      *
+     * For a self-running carousel, prefer the {@link CarouselProps.autoplay}
+     * prop — it appends this same plugin with sensible pause/resume defaults.
+     * Reach for `plugins` directly when you need Embla's full option set.
+     *
      * @example
      * import Autoplay from 'embla-carousel-autoplay'
      * <Carousel plugins={[Autoplay({ delay: 4000 })]}>...</Carousel>
@@ -73,6 +77,40 @@ export interface CarouselProps {
      * @see CarouselPlugin
      */
     plugins?: CarouselPlugin;
+    /**
+     * Advances to the next slide on a timer, with no user input. A convenience
+     * layer over {@link CarouselProps.plugins} — it appends Embla's official
+     * `Autoplay` plugin, so consumer-supplied plugins keep working alongside it.
+     *
+     * Pause/resume behaviour:
+     * - Pauses while the pointer hovers the carousel, resumes on leave (mouse
+     *   only — a touch tap does not count as hovering).
+     * - Pauses on pointer down and resumes once the slide settles; a tap that
+     *   never moves the track resumes too.
+     *
+     * Does nothing when the user's `prefers-reduced-motion: reduce` setting is
+     * active, when there is only one slide, or when `plugins` already contains
+     * an `Autoplay` instance (yours wins — a second one is never stacked).
+     *
+     * With `options={{ loop: true }}` the last slide wraps seamlessly to the
+     * first; without it, the carousel rewinds to the first slide instead.
+     *
+     * @default false
+     *
+     * @example
+     * <Carousel autoplay options={{ loop: true }}>...</Carousel>
+     */
+    autoplay?: boolean;
+    /**
+     * Milliseconds a slide stays on screen before {@link CarouselProps.autoplay}
+     * advances to the next one. Ignored when `autoplay` is `false`.
+     *
+     * @default 5000
+     *
+     * @example
+     * <Carousel autoplay autoplayDelay={3000}>...</Carousel>
+     */
+    autoplayDelay?: number;
     /**
      * Controls scroll direction. Also drives keyboard navigation
      * (←/→ for horizontal, ↑/↓ for vertical).
@@ -92,7 +130,66 @@ export interface CarouselProps {
      */
     setApi?: (api: CarouselApi) => void;
 }
-declare const Carousel: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & CarouselProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Carousel state and controls shared with every descendant, and the return
+ * value of {@link useCarousel}. Alongside the members below it carries the
+ * root's own {@link CarouselProps} (`options`, `orientation`, `plugins`).
+ */
+export interface CarouselContextValue extends CarouselProps {
+    /**
+     * Ref callback for the scrolling viewport, applied by `CarouselContent`.
+     * Only needed when replacing `CarouselContent` with your own element.
+     */
+    carouselRef: ReturnType<typeof useEmblaCarousel>[0];
+    /**
+     * Imperative Embla API, or `undefined` until the carousel has mounted.
+     *
+     * @see CarouselApi
+     */
+    api: CarouselApi;
+    /** Scrolls to the previous slide. No-op at the start without `loop`. */
+    scrollPrev: () => void;
+    /** Scrolls to the next slide. No-op at the end without `loop`. */
+    scrollNext: () => void;
+    /** Whether a previous slide exists to scroll to. */
+    canScrollPrev: boolean;
+    /** Whether a next slide exists to scroll to. */
+    canScrollNext: boolean;
+    /** Index of the active slide (0-based). */
+    selectedIndex: number;
+    /** Scrolls to a slide by index (0-based). */
+    scrollTo: (index: number) => void;
+    /** Number of scroll snap points — i.e. navigable positions, not slides. */
+    slidesCount: number;
+}
+/**
+ * Reads the state and controls of the nearest `Carousel` ancestor. Use it to
+ * build custom controls — a slide counter, a progress bar, a bespoke dot
+ * strip — without threading the Embla API through `setApi` yourself.
+ *
+ * Throws when called outside a `<Carousel>`.
+ *
+ * @example
+ * const SlideCounter = () => {
+ *   const { selectedIndex, slidesCount } = useCarousel()
+ *   return <span>{selectedIndex + 1} / {slidesCount}</span>
+ * }
+ *
+ * <Carousel>
+ *   <CarouselContent>...</CarouselContent>
+ *   <SlideCounter />
+ * </Carousel>
+ *
+ * @see CarouselContextValue
+ */
+declare const useCarousel: () => CarouselContextValue;
+/**
+ * Full prop set accepted by the Carousel root element — {@link CarouselProps}
+ * plus all standard `<div>` attributes.
+ */
+export interface CarouselRootProps extends React.HTMLAttributes<HTMLDivElement>, CarouselProps {
+}
+declare const Carousel: React.ForwardRefExoticComponent<CarouselRootProps & React.RefAttributes<HTMLDivElement>>;
 /**
  * Props for the CarouselContent component. Wraps the scrolling track and
  * lays out its `CarouselItem` children along the active orientation axis.
@@ -172,5 +269,5 @@ export interface CarouselDotsProps {
     buttonAriaLabel?: string;
 }
 declare const CarouselDots: React.FC<CarouselDotsProps>;
-export { Carousel, CarouselContent, CarouselItem, CarouselPrevious, CarouselNext, CarouselDots, };
+export { Carousel, CarouselContent, CarouselItem, CarouselPrevious, CarouselNext, CarouselDots, useCarousel, };
 //# sourceMappingURL=Carousel.d.ts.map

package/dist/components/Carousel/Carousel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Carousel.d.ts","sourceRoot":"","sources":["../../../src/components/Carousel/Carousel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,gBAAgB,EAAE,EACvB,KAAK,oBAAoB,EAC1B,MAAM,sBAAsB,CAAA;AAG7B,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAI5C;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,WAAW,GAAG,oBAAoB,CAAC,CAAC,CAAC,CAAA;AAEjD,KAAK,qBAAqB,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAEhE;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAAA;AAEtD;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAAA;AAErD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,EAAE,eAAe,CAAA;IACzB;;;;;;;;;;OAUG;IACH,KAAK,CAAC,EAAE,WAAW,CAAC,eAAe,CAAC,CAAC,OAAO,CAAC,CAAA;IAC7C;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,cAAc,CAAA;IACxB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,CAAA;IACvC;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,IAAI,CAAA;CACpC;AAwBD,QAAA,MAAM,QAAQ,6HA2Ib,CAAA;AAGD;;;;;GAKG;AACH,MAAM,WAAW,oBACf,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IAC5C;;;;;;;;OAQG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B;AAED,QAAA,MAAM,eAAe,6FA4BpB,CAAA;AAGD;;;;;;;;;GASG;AACH,MAAM,MAAM,iBAAiB,GAAG,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,CAAA;AAEpE,QAAA,MAAM,YAAY,0FAoBjB,CAAA;AAGD;;;;;;;GAOG;AACH,MAAM,WAAW,sBACf,SAAQ,IAAI,CACV,KAAK,CAAC,wBAAwB,CAAC,OAAO,WAAW,CAAC,EAClD,WAAW,GAAG,YAAY,CAC3B;IACD;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;;;;OAOG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B;AAED,QAAA,MAAM,gBAAgB,kGAkDrB,CAAA;AAGD,QAAA,MAAM,YAAY,kGAkDjB,CAAA;AAGD;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,QAAA,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAuB7C,CAAA;AAED,OAAO,EACL,QAAQ,EACR,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,YAAY,GACb,CAAA"}
+{"version":3,"file":"Carousel.d.ts","sourceRoot":"","sources":["../../../src/components/Carousel/Carousel.tsx"],"names":[],"mappings":"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"}