asheeui 0.6.2 → 0.6.3

package/dist/components/card/card-config.js

@@ -5,7 +5,6 @@ const e = {
   imagePosition: "top",
   imageRatio: "video",
   imageFit: "cover",
-  isClickable: !1,
   animate: !0
 };
 i("card", e);
@@ -17,7 +16,6 @@ const o = {
   imageRatio: "video",
   imageFit: "cover",
   imageLoading: "lazy",
-  isClickable: !1,
   animate: !0
 };
 export {

package/dist/components/card/card-styles.d.ts

@@ -1,7 +1,23 @@
-import { Size } from '../../shared/size';
+import { Size } from '../../shared';
 import { CardVariant } from './card-config';
+/**
+ * CSS classes for card padding based on size.
+ * Controls the internal padding of the card content area.
+ */
 export declare const CARD_PADDING_CLASS: Record<Size, string>;
+/**
+ * CSS classes for card gap based on size.
+ * Controls the spacing between card sections.
+ */
 export declare const CARD_GAP_CLASS: Record<Size, string>;
+/**
+ * CSS classes for card header gap based on size.
+ * Controls the spacing between header elements (title, description, header).
+ */
 export declare const CARD_HEADER_GAP_CLASS: Record<Size, string>;
+/**
+ * CSS classes for card variants.
+ * Each variant has a distinct background, border, and shadow treatment.
+ */
 export declare const CARD_VARIANT_CLASS: Record<CardVariant, string>;
 //# sourceMappingURL=card-styles.d.ts.map

package/dist/components/card/card-styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"card-styles.d.ts","sourceRoot":"","sources":["../../../src/components/card/card-styles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAInD,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAI/C,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAItD,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAK1D,CAAC"}
+{"version":3,"file":"card-styles.d.ts","sourceRoot":"","sources":["../../../src/components/card/card-styles.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAInD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAI/C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAItD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAK1D,CAAC"}

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

@@ -1,31 +1,126 @@
 import { HTMLAttributes, ReactNode } from 'react';
-import { CarouselItem, CarouselRadiusKey, CarouselSizeKey, CarouselVariant } from './carousel-config';
-export interface CarouselProps extends Omit<HTMLAttributes<HTMLDivElement>, "onChange"> {
+import { CarouselConfig, CarouselItem } from './carousel-config';
+type BaseCarouselProps = CarouselConfig & Omit<HTMLAttributes<HTMLDivElement>, "onChange">;
+/**
+ * Configuration options for the Carousel component.
+ */
+export interface CarouselProps extends BaseCarouselProps {
+    /**
+     * Array of items to display in the carousel.
+     * Each item must have content and an optional id.
+     */
     items?: CarouselItem[];
-    variant?: CarouselVariant;
-    size?: CarouselSizeKey;
-    radius?: CarouselRadiusKey;
-    autoPlay?: boolean;
-    autoPlayInterval?: number;
-    loop?: boolean;
-    showControls?: boolean;
-    showIndicators?: boolean;
-    pauseOnHover?: boolean;
-    disableAnimation?: boolean;
+    /**
+     * Initial slide index for uncontrolled usage.
+     * @default 0
+     */
     defaultIndex?: number;
+    /**
+     * Controlled slide index.
+     * When provided, the component becomes controlled.
+     */
     index?: number;
+    /**
+     * Callback fired when the slide index changes.
+     * Called with the new slide index.
+     */
     onIndexChange?: (index: number) => void;
+    /**
+     * Custom render function for the previous control button.
+     * Receives onClick handler and disabled state.
+     */
     renderPrevControl?: (props: {
         onClick: () => void;
         disabled: boolean;
     }) => ReactNode;
+    /**
+     * Custom render function for the next control button.
+     * Receives onClick handler and disabled state.
+     */
     renderNextControl?: (props: {
         onClick: () => void;
         disabled: boolean;
     }) => ReactNode;
+    /**
+     * Extra classes applied to each slide item container.
+     */
     itemClassName?: string;
+    /**
+     * Extra classes applied to control buttons.
+     */
     controlClassName?: string;
+    /**
+     * Extra classes applied to indicator buttons.
+     */
     indicatorClassName?: string;
 }
+/**
+ * A slideshow container for displaying content in a horizontal carousel.
+ *
+ * Carousel supports autoplay, loop mode, navigation controls, indicator dots,
+ and touch/swipe interactions. Visual tokens (`variant`, `size`, `radius`,
+ * `autoPlay`, `loop`, `showControls`, `showIndicators`, `pauseOnHover`)
+ * resolve through the standard AsheeUI cascade: prop, component config,
+ * global theme defaults, and the built-in fallback.
+ *
+ * The component automatically handles accessibility attributes including
+ * ARIA labels for controls and indicators. It supports both mouse and
+ * touch interactions for swipe gestures.
+ *
+ * @param props - Carousel configuration options and HTML div element props.
+ * @param props.items - Array of items to display.
+ * @param props.variant - Visual style variant. Defaults to "bordered".
+ * @param props.size - Height scale. Defaults to "md".
+ * @param props.radius - Corner rounding. Defaults to "lg".
+ * @param props.autoPlay - Enable autoplay. Defaults to false.
+ * @param props.autoPlayInterval - Autoplay interval in ms. Defaults to 5000.
+ * @param props.loop - Enable loop mode. Defaults to true.
+ * @param props.showControls - Show navigation controls. Defaults to true.
+ * @param props.showIndicators - Show indicator dots. Defaults to true.
+ * @param props.pauseOnHover - Pause autoplay on hover. Defaults to true.
+ * @param props.disableAnimation - Disable transitions. Defaults to false.
+ * @param props.defaultIndex - Initial slide index. Defaults to 0.
+ * @param props.index - Controlled slide index.
+ * @param props.onIndexChange - Change callback with slide index.
+ * @param props.renderPrevControl - Custom previous control renderer.
+ * @param props.renderNextControl - Custom next control renderer.
+ * @param props.itemClassName - Extra classes for slide items.
+ * @param props.controlClassName - Extra classes for controls.
+ * @param props.indicatorClassName - Extra classes for indicators.
+ * @param props.children - Child elements as slides (alternative to items).
+ *
+ * @example
+ * ```tsx
+ * import { Carousel } from "asheeui";
+ *
+ * export function Example() {
+ *   return (
+ *     <Carousel
+ *       autoPlay
+ *       loop
+ *       items={[
+ *         { content: <div>Slide 1</div> },
+ *         { content: <div>Slide 2</div> },
+ *         { content: <div>Slide 3</div> },
+ *       ]}
+ *     />
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Using children instead of items
+ * <Carousel autoPlay>
+ *   <div>Slide 1</div>
+ *   <div>Slide 2</div>
+ *   <div>Slide 3</div>
+ * </Carousel>
+ * ```
+ *
+ * @see CarouselConfig - The configuration type for component defaults.
+ * @see useAsheeConfig - Hook for accessing the global configuration.
+ */
 export declare const Carousel: import('react').ForwardRefExoticComponent<CarouselProps & import('react').RefAttributes<HTMLDivElement>>;
+export {};
 //# 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":"AAEA,OAAO,EAEL,KAAK,cAAc,EAEnB,KAAK,SAAS,EAOf,MAAM,OAAO,CAAC;AAWf,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,eAAe,EAErB,MAAM,mBAAmB,CAAC;AAS3B,MAAM,WAAW,aACf,SAAQ,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,UAAU,CAAC;IACxD,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC;IACvB,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE;QAC1B,OAAO,EAAE,MAAM,IAAI,CAAC;QACpB,QAAQ,EAAE,OAAO,CAAC;KACnB,KAAK,SAAS,CAAC;IAChB,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE;QAC1B,OAAO,EAAE,MAAM,IAAI,CAAC;QACpB,QAAQ,EAAE,OAAO,CAAC;KACnB,KAAK,SAAS,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,eAAO,MAAM,QAAQ,0GA6VpB,CAAC"}
+{"version":3,"file":"Carousel.d.ts","sourceRoot":"","sources":["../../../src/components/carousel/Carousel.tsx"],"names":[],"mappings":"AAUA,OAAO,EAEL,KAAK,cAAc,EAEnB,KAAK,SAAS,EAOf,MAAM,OAAO,CAAC;AAYf,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,YAAY,EAGlB,MAAM,mBAAmB,CAAC;AAY3B,KAAK,iBAAiB,GAAG,cAAc,GACrC,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,UAAU,CAAC,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,iBAAiB;IACtD;;;OAGG;IACH,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC;IAEvB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAExC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE;QAC1B,OAAO,EAAE,MAAM,IAAI,CAAC;QACpB,QAAQ,EAAE,OAAO,CAAC;KACnB,KAAK,SAAS,CAAC;IAEhB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE;QAC1B,OAAO,EAAE,MAAM,IAAI,CAAC;QACpB,QAAQ,EAAE,OAAO,CAAC;KACnB,KAAK,SAAS,CAAC;IAEhB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkEG;AACH,eAAO,MAAM,QAAQ,0GA0VpB,CAAC"}

package/dist/components/carousel/Carousel.js

@@ -1,34 +1,34 @@
 "use client";
 import { jsxs as T, jsx as l, Fragment as Ae } from "react/jsx-runtime";
-import { forwardRef as Se, useId as Pe, useMemo as Ne, useState as p, useRef as ke, useCallback as j, useEffect as Le } from "react";
+import { forwardRef as Se, useId as Pe, useMemo as ke, useState as m, useRef as Ne, useCallback as j, useEffect as Le } from "react";
 import { ChevronLeftIcon as Re } from "../../icons/ChevronLeftIcon.js";
 import { ChevronRightIcon as De } from "../../icons/ChevronRightIcon.js";
 import { useAsheeConfig as Oe } from "../../libs/context.js";
-import { RADIUS_CLASS as Ie } from "../../shared/radius.js";
-import { resolveCascade as d, resolveRadiusKey as _e, resolveClassKey as A } from "../../utils/resolve-token.js";
+import { resolveCascade as u, resolveRadiusKey as Ie, resolveClassKey as A } from "../../utils/resolve-token.js";
 import { FALLBACK_CAROUSEL_CONFIG as s } from "./carousel-config.js";
-import { CAROUSEL_HEIGHT_CLASS as Ee, CAROUSEL_PADDING_CLASS as He, CAROUSEL_VARIANT_CLASS as F } from "./carousel-styles.js";
-import { cn as u } from "../../utils/cn.js";
+import { CAROUSEL_HEIGHT_CLASS as _e, CAROUSEL_PADDING_CLASS as Ee, CAROUSEL_VARIANT_CLASS as F } from "./carousel-styles.js";
+import { RADIUS_CLASS as He } from "../../shared/radius.js";
+import { cn as d } from "../../utils/cn.js";
 const G = 50, ze = Se(
   ({
     items: h = [],
     variant: $,
-    size: V,
-    radius: X,
-    autoPlay: x,
-    autoPlayInterval: B,
-    loop: C,
+    size: C,
+    radius: V,
+    autoPlay: X,
+    autoPlayInterval: x,
+    loop: B,
     showControls: W,
     showIndicators: q,
     pauseOnHover: J,
     disableAnimation: Q = !1,
     defaultIndex: Y = 0,
     index: S,
-    onIndexChange: n,
+    onIndexChange: i,
     renderPrevControl: P,
-    renderNextControl: N,
+    renderNextControl: k,
     itemClassName: Z,
-    controlClassName: k,
+    controlClassName: N,
     indicatorClassName: ee,
     className: re,
     style: oe,
@@ -37,84 +37,84 @@ const G = 50, ze = Se(
     ...se
   }, le) => {
     var M;
-    const y = Oe(), e = (M = y.components) == null ? void 0 : M.carousel, ae = Pe(), ne = te ?? ae, L = d(
-      V,
+    const y = Oe(), e = (M = y.components) == null ? void 0 : M.carousel, ae = Pe(), ie = te ?? ae, L = u(
+      C,
       e == null ? void 0 : e.size,
       void 0,
       s.size
-    ), ie = d(
+    ), ne = u(
       $,
       e == null ? void 0 : e.variant,
       y.defaultVariant,
       s.variant
-    ), de = _e(
-      X,
+    ), ue = Ie(
+      V,
       e == null ? void 0 : e.radius,
       y.defaultRadius,
       s.radius
-    ), R = d(
-      x,
+    ), R = u(
+      X,
       e == null ? void 0 : e.autoPlay,
       void 0,
       s.autoPlay
-    ), D = d(
-      B,
+    ), D = u(
+      x,
       e == null ? void 0 : e.autoPlayInterval,
       void 0,
       s.autoPlayInterval
-    ), f = d(
-      C,
+    ), f = u(
+      B,
       e == null ? void 0 : e.loop,
       void 0,
       s.loop
-    ), ue = d(
+    ), de = u(
       W,
       e == null ? void 0 : e.showControls,
       void 0,
       s.showControls
-    ), ce = d(
+    ), ce = u(
       q,
       e == null ? void 0 : e.showIndicators,
       void 0,
       s.showIndicators
-    ), O = d(
+    ), O = u(
       J,
       e == null ? void 0 : e.pauseOnHover,
       void 0,
       s.pauseOnHover
     ), fe = A(
       L,
-      Ee,
+      _e,
       s.size
     ), ve = A(
       L,
-      He,
+      Ee,
       s.size
     ), be = A(
-      de,
-      Ie,
+      ue,
+      He,
       s.radius
-    ), me = F[ie] ?? F.bordered, t = Ne(() => h.length > 0 ? h : c ? (Array.isArray(c) ? c : [c]).map((o, we) => ({
+    ), pe = F[ne] ?? F.bordered, t = ke(() => h.length > 0 ? h : c ? (Array.isArray(c) ? c : [c]).map((o, we) => ({
       id: `slide-${we}`,
       content: o
-    })) : [], [h, c]), v = S !== void 0, [pe, I] = p(Y), a = v ? S : pe, [_, m] = p(!1), [b, E] = p(!1), [g, w] = p(0), H = ke(0), i = j(
+    })) : [], [h, c]), v = S !== void 0, [me, I] = m(Y), a = v ? S : me, [_, p] = m(!1), [b, E] = m(!1), [g, w] = m(0), H = Ne(0), n = j(
       (r) => {
         if (t.length <= 1) return;
         let o = a + r;
-        o < 0 ? o = f ? t.length - 1 : 0 : o >= t.length && (o = f ? 0 : t.length - 1), o !== a && (v || I(o), n == null || n(o));
+        o < 0 ? o = f ? t.length - 1 : 0 : o >= t.length && (o = f ? 0 : t.length - 1), o !== a && (v || I(o), i == null || i(o));
       },
-      [a, t.length, f, v, n]
+      [a, t.length, f, v, i]
     ), he = j(
       (r) => {
-        r === a || r < 0 || r >= t.length || (v || I(r), n == null || n(r));
+        r === a || r < 0 || r >= t.length || (v || I(r), i == null || i(r));
       },
-      [a, t.length, v, n]
+      [a, t.length, v, i]
     );
     Le(() => {
       if (!R || O && _ || b || t.length <= 1)
         return;
       const r = setInterval(() => {
-        i(1);
+        n(1);
       }, D);
       return () => clearInterval(r);
     }, [
@@ -124,7 +124,7 @@ const G = 50, ze = Se(
       _,
       b,
       t.length,
-      i
+      n
     ]);
     const ye = (r) => {
       r.target.closest("button") || (E(!0), H.current = r.clientX, w(0), r.currentTarget.setPointerCapture(r.pointerId));
@@ -133,23 +133,22 @@ const G = 50, ze = Se(
       const o = r.clientX - H.current;
       w(o);
     }, z = () => {
-      b && (E(!1), g < -G ? i(1) : g > G && i(-1), w(0));
+      b && (E(!1), g < -G ? n(1) : g > G && n(-1), w(0));
     }, U = !f && a === 0, K = !f && a === t.length - 1;
     return /* @__PURE__ */ T(
       "div",
       {
         ref: le,
-        id: ne,
-        onMouseEnter: () => m(!0),
-        onMouseLeave: () => m(!1),
-        onFocus: () => m(!0),
-        onBlur: () => m(!1),
-        className: u(
-          "relative overflow-hidden w-full select-none flex flex-col group",
-          me,
+        id: ie,
+        onMouseEnter: () => p(!0),
+        onMouseLeave: () => p(!1),
+        onFocus: () => p(!0),
+        onBlur: () => p(!1),
+        className: d(
+          "relative overflow-clip w-full select-none flex flex-col group",
+          pe,
           be,
           fe,
-          e == null ? void 0 : e.className,
           re
         ),
         style: oe,
@@ -162,11 +161,11 @@ const G = 50, ze = Se(
               onPointerMove: ge,
               onPointerUp: z,
               onPointerCancel: z,
-              className: "relative w-full h-full overflow-hidden flex-1 touch-pan-y cursor-grab active:cursor-grabbing",
+              className: "relative w-full h-full overflow-clip flex-1 touch-pan-y cursor-grab active:cursor-grabbing",
               children: /* @__PURE__ */ l(
                 "div",
                 {
-                  className: u(
+                  className: d(
                     "flex w-full h-full",
                     !b && !Q && "transition-transform duration-300 ease-out"
                   ),
@@ -176,8 +175,8 @@ const G = 50, ze = Se(
                   children: t.map((r, o) => /* @__PURE__ */ l(
                     "div",
                     {
-                      className: u(
-                        "w-full h-full shrink-0 flex items-center justify-center overflow-hidden",
+                      className: d(
+                        "w-full h-full shrink-0 flex items-center justify-center overflow-clip",
                         ve,
                         Z
                       ),
@@ -189,9 +188,9 @@ const G = 50, ze = Se(
               )
             }
           ),
-          ue && t.length > 1 && /* @__PURE__ */ T(Ae, { children: [
+          de && t.length > 1 && /* @__PURE__ */ T(Ae, { children: [
             P ? P({
-              onClick: () => i(-1),
+              onClick: () => n(-1),
               disabled: U
             }) : /* @__PURE__ */ l(
               "button",
@@ -199,16 +198,16 @@ const G = 50, ze = Se(
                 type: "button",
                 "aria-label": "Previous Slide",
                 disabled: U,
-                onClick: () => i(-1),
-                className: u(
+                onClick: () => n(-1),
+                className: d(
                   "absolute left-3 top-1/2 -translate-y-1/2 z-20 p-2.5 rounded-full bg-background/80 hover:bg-background text-foreground border border-border/50 backdrop-blur-md shadow-md transition-all duration-200 focus:outline-none focus-visible:ring-2 focus-visible:ring-primary disabled:opacity-30 disabled:cursor-not-allowed",
-                  k
+                  N
                 ),
                 children: /* @__PURE__ */ l(Re, { className: "w-5 h-5" })
               }
             ),
-            N ? N({
-              onClick: () => i(1),
+            k ? k({
+              onClick: () => n(1),
               disabled: K
             }) : /* @__PURE__ */ l(
               "button",
@@ -216,10 +215,10 @@ const G = 50, ze = Se(
                 type: "button",
                 "aria-label": "Next Slide",
                 disabled: K,
-                onClick: () => i(1),
-                className: u(
+                onClick: () => n(1),
+                className: d(
                   "absolute right-3 top-1/2 -translate-y-1/2 z-20 p-2.5 rounded-full bg-background/80 hover:bg-background text-foreground border border-border/50 backdrop-blur-md shadow-md transition-all duration-200 focus:outline-none focus-visible:ring-2 focus-visible:ring-primary disabled:opacity-30 disabled:cursor-not-allowed",
-                  k
+                  N
                 ),
                 children: /* @__PURE__ */ l(De, { className: "w-5 h-5" })
               }
@@ -231,7 +230,7 @@ const G = 50, ze = Se(
               type: "button",
               "aria-label": `Go to slide ${o + 1}`,
               onClick: () => he(o),
-              className: u(
+              className: d(
                 "h-2 rounded-full transition-all duration-300 focus:outline-none focus-visible:ring-1 focus-visible:ring-primary",
                 o === a ? "w-6 bg-primary" : "w-2 bg-foreground/40 hover:bg-foreground/70",
                 ee

package/dist/components/carousel/carousel-config.d.ts

@@ -1,31 +1,117 @@
 import { ReactNode } from 'react';
-import { Radius } from '../../shared/radius';
-import { Size } from '../../shared/size';
+import { Radius, Size } from '../../shared';
+/**
+ * Visual style of the carousel.
+ * - `bordered`: Card with border and background.
+ * - `ghost`: Transparent background without border.
+ */
 export type CarouselVariant = "bordered" | "ghost";
-export type CarouselSizeKey = Size;
-export type CarouselRadiusKey = Radius;
+/**
+ * A single carousel slide item.
+ */
 export interface CarouselItem {
+    /**
+     * Optional unique identifier for the slide.
+     * Used for React keys and accessibility.
+     */
     id?: string;
+    /**
+     * The content to display in the slide.
+     * Can be any React node.
+     */
     content: ReactNode;
 }
+/**
+ * Theme configuration options for the Carousel component.
+ *
+ * Set under `components.carousel` in the AsheeUI config. Values feed the
+ * component-level fallback tier of the theme cascade.
+ */
 export interface CarouselConfig {
+    /**
+     * Visual style variant.
+     * Controls the carousel's background and border treatment.
+     *
+     * @default "bordered"
+     */
     variant?: CarouselVariant;
-    size?: CarouselSizeKey;
-    radius?: CarouselRadiusKey;
+    /**
+     * Height scale of the carousel.
+     * Controls the fixed height of the carousel container.
+     *
+     * @default "md"
+     */
+    size?: Size;
+    /**
+     * Corner rounding.
+     * Controls the border-radius of the carousel.
+     *
+     * @default "lg"
+     */
+    radius?: Radius;
+    /**
+     * Whether the carousel should autoplay.
+     * When true, slides advance automatically.
+     *
+     * @default false
+     */
     autoPlay?: boolean;
+    /**
+     * Interval in milliseconds between autoplay transitions.
+     *
+     * @default 5000
+     */
     autoPlayInterval?: number;
+    /**
+     * Whether the carousel should loop.
+     * When true, wraps from last to first slide and vice versa.
+     *
+     * @default true
+     */
     loop?: boolean;
+    /**
+     * Whether to show navigation controls.
+     *
+     * @default true
+     */
     showControls?: boolean;
+    /**
+     * Whether to show indicator dots.
+     *
+     * @default true
+     */
     showIndicators?: boolean;
+    /**
+     * Whether autoplay should pause when hovering.
+     *
+     * @default true
+     */
     pauseOnHover?: boolean;
-    className?: string;
+    /**
+     * Disables all slide transition animations.
+     * When true, slides snap instantly.
+     *
+     * @default false
+     */
+    disableAnimation?: boolean;
 }
+/**
+ * Default config values registered for the Carousel component.
+ *
+ * `variant` and `radius` are intentionally absent so they inherit from
+ * the global `defaultVariant` / `defaultRadius`.
+ */
 export declare const defaultCarouselConfig: CarouselConfig;
 declare module "../../libs/registry" {
     interface ComponentTypeConfigRegistry {
         carousel: CarouselConfig;
     }
 }
+/**
+ * Hard fallback values used when no config tier provides a value.
+ * These values are used when instance props, component config,
+ * and global defaults are all undefined.
+ */
 export declare const FALLBACK_CAROUSEL_CONFIG: {
     readonly size: "md";
     readonly variant: "bordered";
@@ -36,5 +122,6 @@ export declare const FALLBACK_CAROUSEL_CONFIG: {
     readonly showControls: true;
     readonly showIndicators: true;
     readonly pauseOnHover: true;
+    readonly disableAnimation: false;
 };
 //# sourceMappingURL=carousel-config.d.ts.map

package/dist/components/carousel/carousel-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"carousel-config.d.ts","sourceRoot":"","sources":["../../../src/components/carousel/carousel-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAE9C,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,OAAO,CAAC;AACnD,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC;AACnC,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC;AAEvC,MAAM,WAAW,YAAY;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,SAAS,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,qBAAqB,EAAE,cAQnC,CAAC;AAEF,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,2BAA2B;QACnC,QAAQ,EAAE,cAAc,CAAC;KAC1B;CACF;AAID,eAAO,MAAM,wBAAwB;;;;;;;;;;CAU3B,CAAC"}
+{"version":3,"file":"carousel-config.d.ts","sourceRoot":"","sources":["../../../src/components/carousel/carousel-config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEjD;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,OAAO,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ;;;OAGG;IACH,OAAO,EAAE,SAAS,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,eAAe,CAAC;IAE1B;;;;;OAKG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC;IAEZ;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;;;OAKG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,EAAE,cASnC,CAAC;AAEF,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,2BAA2B;QACnC,QAAQ,EAAE,cAAc,CAAC;KAC1B;CACF;AAID;;;;GAIG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;CAW3B,CAAC"}

package/dist/components/carousel/carousel-config.js

@@ -7,10 +7,11 @@ const o = {
   loop: !0,
   showControls: !0,
   showIndicators: !0,
-  pauseOnHover: !0
+  pauseOnHover: !0,
+  disableAnimation: !1
 };
 e("carousel", o);
-const r = {
+const a = {
   size: "md",
   variant: "bordered",
   radius: "lg",
@@ -19,9 +20,10 @@ const r = {
   loop: !0,
   showControls: !0,
   showIndicators: !0,
-  pauseOnHover: !0
+  pauseOnHover: !0,
+  disableAnimation: !1
 };
 export {
-  r as FALLBACK_CAROUSEL_CONFIG,
+  a as FALLBACK_CAROUSEL_CONFIG,
   o as defaultCarouselConfig
 };