asheeui 0.6.2 → 0.6.3

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

@@ -1 +1 @@
-{"version":3,"file":"toast-config.d.ts","sourceRoot":"","sources":["../../../src/components/toast/toast-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;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEpD,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;AAC7E,MAAM,MAAM,cAAc,GACtB,WAAW,GACX,UAAU,GACV,cAAc,GACd,aAAa,GACb,YAAY,GACZ,eAAe,CAAC;AACpB,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC;AAEhC,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,OAAO,EAAE,SAAS,CAAC;IACnB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,kBAAkB,EAAE,WAQhC,CAAC;AAEF,eAAO,MAAM,qBAAqB;mBAClB,YAAY;wBACA,cAAc;sBACpB,OAAO;qBACX,MAAM;;;;CAId,CAAC;AAEX,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,2BAA2B;QACnC,KAAK,EAAE,WAAW,CAAC;KACpB;CACF"}
+{"version":3,"file":"toast-config.d.ts","sourceRoot":"","sources":["../../../src/components/toast/toast-config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE1D;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;AAE7E;;;GAGG;AACH,MAAM,MAAM,cAAc,GACtB,WAAW,GACX,UAAU,GACV,cAAc,GACd,aAAa,GACb,YAAY,GACZ,eAAe,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAElB;;OAEG;IACH,OAAO,EAAE,SAAS,CAAC;IAEnB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC;IAEjB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC;IAEjB;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;IAEnB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;OAKG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC;IAEZ;;;;;OAKG;IACH,SAAS,CAAC,EAAE,cAAc,CAAC;IAE3B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,WAQhC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB;mBAClB,IAAI;wBACQ,cAAc;sBACpB,OAAO;qBACX,MAAM;;;;CAId,CAAC;AAEX,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,2BAA2B;QACnC,KAAK,EAAE,WAAW,CAAC;KACpB;CACF"}

package/dist/components/toast/toast-context.d.ts

@@ -1,31 +1,143 @@
 import { ReactNode } from 'react';
-import { Radius } from '../../shared/radius';
-import { Variant } from '../../shared/variant';
-import { ToastItemData, ToastPlacement, ToastSizeKey } from './toast-config';
+import { ToastConfig, ToastItemData } from './toast-config';
+/**
+ * Options for showing a toast notification.
+ * Extends ToastItemData but makes id optional.
+ */
 export interface ToastShowOptions extends Omit<ToastItemData, "id"> {
+    /**
+     * Optional unique identifier for the toast.
+     * If not provided, a random ID is generated.
+     */
     id?: string;
 }
+/**
+ * Context type for the toast system.
+ * Provides methods for showing and managing toast notifications.
+ */
 export interface ToastContextType {
+    /**
+     * Array of currently active toast items.
+     */
     toasts: ToastItemData[];
+    /**
+     * Show a toast with the given options.
+     * Returns the toast ID.
+     */
     toast: (options: ToastShowOptions | string) => string;
+    /**
+     * Show a success toast.
+     * Returns the toast ID.
+     */
     success: (message: ReactNode, options?: Partial<ToastShowOptions>) => string;
+    /**
+     * Show an error toast.
+     * Returns the toast ID.
+     */
     error: (message: ReactNode, options?: Partial<ToastShowOptions>) => string;
+    /**
+     * Show an info toast.
+     * Returns the toast ID.
+     */
     info: (message: ReactNode, options?: Partial<ToastShowOptions>) => string;
+    /**
+     * Show a warning toast.
+     * Returns the toast ID.
+     */
     warning: (message: ReactNode, options?: Partial<ToastShowOptions>) => string;
+    /**
+     * Remove a toast by ID.
+     */
     removeToast: (id: string) => void;
+    /**
+     * Clear all active toasts.
+     */
     clearToasts: () => void;
 }
-export interface ToastProviderProps {
+/**
+ * Props for the ToastProvider component.
+ * Extends ToastConfig with children and className.
+ */
+export interface ToastProviderProps extends ToastConfig {
+    /**
+     * Child components to render.
+     */
     children: ReactNode;
-    size?: ToastSizeKey;
-    placement?: ToastPlacement;
-    variant?: Variant;
-    radius?: Radius;
-    defaultTimeout?: number;
-    maxToasts?: number;
-    animated?: boolean;
+    /**
+     * Extra classes for the toast container.
+     */
     className?: string;
 }
+/**
+ * Provider component for the toast notification system.
+ *
+ * ToastProvider wraps your application and provides toast notification
+ * functionality through the useToast hook. It manages the toast queue,
+ * rendering, and dismissal logic, and automatically positions toasts
+ * based on the configured placement.
+ *
+ * @param props - ToastProvider configuration options.
+ * @param props.children - Child components.
+ * @param props.size - Size scale of toasts. Defaults to "md".
+ * @param props.placement - Placement of toasts. Defaults to "top-right".
+ * @param props.variant - Visual style variant. Defaults to "bordered".
+ * @param props.radius - Corner rounding. Defaults to "md".
+ * @param props.defaultTimeout - Default timeout in ms. Defaults to 3500.
+ * @param props.maxToasts - Maximum number of toasts. Defaults to 5.
+ * @param props.animated - Whether toasts have animations. Defaults to true.
+ * @param props.className - Extra classes for the toast container.
+ *
+ * @example
+ * ```tsx
+ * import { ToastProvider, useToast } from "asheeui";
+ *
+ * function App() {
+ *   return (
+ *     <ToastProvider>
+ *       <MyComponent />
+ *     </ToastProvider>
+ *   );
+ * }
+ *
+ * function MyComponent() {
+ *   const toast = useToast();
+ *
+ *   return (
+ *     <button onClick={() => toast.success("Operation successful!")}>
+ *       Show Toast
+ *     </button>
+ *   );
+ * }
+ * ```
+ *
+ * @see useToast - Hook for showing toast notifications.
+ * @see ToastConfig - The configuration type for the toast system.
+ */
 export declare function ToastProvider({ children, size, placement, variant, radius, defaultTimeout, maxToasts, animated, className, }: ToastProviderProps): import("react").JSX.Element;
+/**
+ * Hook for accessing the toast system.
+ *
+ * useToast returns methods for showing toast notifications with
+ * different types (success, error, info, warning). It must be used
+ * within a ToastProvider component.
+ *
+ * @returns The toast context with methods for showing and managing toasts.
+ *         If used outside a ToastProvider, returns safe fallback methods.
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const toast = useToast();
+ *
+ *   const handleClick = () => {
+ *     toast.success("Saved successfully!");
+ *   };
+ *
+ *   return <button onClick={handleClick}>Save</button>;
+ * }
+ * ```
+ *
+ * @see ToastProvider - The provider component that enables the toast system.
+ */
 export declare function useToast(): ToastContextType;
 //# sourceMappingURL=toast-context.d.ts.map

package/dist/components/toast/toast-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toast-context.d.ts","sourceRoot":"","sources":["../../../src/components/toast/toast-context.tsx"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,SAAS,EAKf,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAIpD,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,YAAY,EAClB,MAAM,gBAAgB,CAAC;AAIxB,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC;IACjE,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,KAAK,EAAE,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,KAAK,MAAM,CAAC;IACtD,OAAO,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,KAAK,MAAM,CAAC;IAC7E,KAAK,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,KAAK,MAAM,CAAC;IAC3E,IAAI,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,KAAK,MAAM,CAAC;IAC1E,OAAO,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,KAAK,MAAM,CAAC;IAC7E,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB;AAMD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,SAAS,CAAC;IACpB,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,IAAI,EACJ,SAAS,EACT,OAAO,EACP,MAAM,EACN,cAAc,EACd,SAAS,EACT,QAAQ,EACR,SAAS,GACV,EAAE,kBAAkB,+BA4KpB;AAID,wBAAgB,QAAQ,qBAevB"}
+{"version":3,"file":"toast-context.d.ts","sourceRoot":"","sources":["../../../src/components/toast/toast-context.tsx"],"names":[],"mappings":"AAUA,OAAO,EAEL,KAAK,SAAS,EAKf,MAAM,OAAO,CAAC;AAMf,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,aAAa,EAEnB,MAAM,gBAAgB,CAAC;AAIxB;;;GAGG;AACH,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC;IACjE;;;OAGG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,MAAM,EAAE,aAAa,EAAE,CAAC;IAExB;;;OAGG;IACH,KAAK,EAAE,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,KAAK,MAAM,CAAC;IAEtD;;;OAGG;IACH,OAAO,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,KAAK,MAAM,CAAC;IAE7E;;;OAGG;IACH,KAAK,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,KAAK,MAAM,CAAC;IAE3E;;;OAGG;IACH,IAAI,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,KAAK,MAAM,CAAC;IAE1E;;;OAGG;IACH,OAAO,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,KAAK,MAAM,CAAC;IAE7E;;OAEG;IACH,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAElC;;OAEG;IACH,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB;AAMD;;;GAGG;AACH,MAAM,WAAW,kBAAmB,SAAQ,WAAW;IACrD;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;IAEpB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,IAAI,EACJ,SAAS,EACT,OAAO,EACP,MAAM,EACN,cAAc,EACd,SAAS,EACT,QAAQ,EACR,SAAS,GACV,EAAE,kBAAkB,+BA4KpB;AAID;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,QAAQ,qBAevB"}

package/dist/components/toast/toast-context.js

@@ -9,8 +9,8 @@ import { cn as X } from "../../utils/cn.js";
 const D = H(null);
 function st({
   children: m,
-  size: I,
-  placement: K,
+  size: K,
+  placement: I,
   variant: S,
   radius: U,
   defaultTimeout: j,
@@ -19,25 +19,25 @@ function st({
   className: R
 }) {
   var h;
-  const [d, c] = g([]), l = J(), t = (h = l.components) == null ? void 0 : h.toast, V = i(
-    I,
+  const [c, l] = g([]), d = J(), t = (h = d.components) == null ? void 0 : h.toast, V = i(
+    K,
     t == null ? void 0 : t.size,
     void 0,
     n.size
   ), r = i(
-    K,
+    I,
     t == null ? void 0 : t.placement,
     void 0,
     n.placement
   ), F = i(
     S,
     t == null ? void 0 : t.variant,
-    l.defaultVariant,
+    d.defaultVariant,
     n.variant
   ), L = Q(
     U,
     t == null ? void 0 : t.radius,
-    l.defaultRadius,
+    d.defaultRadius,
     n.radius
   ), v = i(
     N,
@@ -54,14 +54,14 @@ function st({
     t == null ? void 0 : t.animated,
     void 0,
     n.animated
-  ), f = a((e) => {
-    c((o) => o.filter((p) => p.id !== e));
+  ), p = a((e) => {
+    l((o) => o.filter((f) => f.id !== e));
   }, []), x = a(() => {
-    c([]);
+    l([]);
   }, []), s = a(
     (e) => {
       var z;
-      const o = typeof e == "object" && e.id ? e.id : typeof window < "u" && ((z = window.crypto) != null && z.randomUUID) ? window.crypto.randomUUID() : String(Date.now()), p = typeof e == "string" ? {
+      const o = typeof e == "object" && e.id ? e.id : typeof window < "u" && ((z = window.crypto) != null && z.randomUUID) ? window.crypto.randomUUID() : String(Date.now()), f = typeof e == "string" ? {
         id: o,
         message: e,
         timeout: u,
@@ -72,9 +72,9 @@ function st({
         timeout: e.timeout ?? u,
         type: e.type ?? "info"
       };
-      return c((_) => {
+      return l((_) => {
         const k = _.filter((B) => B.id !== o);
-        return [p, ...k].slice(0, v);
+        return [f, ...k].slice(0, v);
       }), o;
     },
     [u, v]
@@ -92,16 +92,16 @@ function st({
     [s]
   ), O = q(
     () => ({
-      toasts: d,
+      toasts: c,
       toast: s,
       success: T,
       error: y,
       info: w,
       warning: b,
-      removeToast: f,
+      removeToast: p,
       clearToasts: x
     }),
-    [d, s, T, y, w, b, f, x]
+    [c, s, T, y, w, b, p, x]
   );
   return /* @__PURE__ */ G(D.Provider, { value: O, children: [
     m,
@@ -110,7 +110,7 @@ function st({
       {
         "aria-label": "Notifications",
         className: X(
-          "fixed z-50 flex flex-col gap-3 pointer-events-none p-4 max-h-screen overflow-hidden",
+          "fixed z-50 flex flex-col gap-3 pointer-events-none p-4 max-h-screen overflow-clip",
           r === "top-right" && "top-0 right-0 items-end",
           r === "top-left" && "top-0 left-0 items-start",
           r === "bottom-right" && "bottom-0 right-0 items-end",
@@ -119,7 +119,7 @@ function st({
           r === "bottom-center" && "bottom-0 left-1/2 -translate-x-1/2 items-center",
           R
         ),
-        children: d.map((e) => /* @__PURE__ */ A(
+        children: c.map((e) => /* @__PURE__ */ A(
           W,
           {
             ...e,
@@ -127,7 +127,7 @@ function st({
             size: V,
             variant: F,
             radius: L,
-            onDismiss: f,
+            onDismiss: p,
             animated: M
           },
           e.id

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

@@ -1,8 +1,30 @@
-import { ToastPlacement, ToastSizeKey } from './toast-config';
-export declare const TOAST_WIDTH_CLASS: Record<ToastSizeKey, string>;
-export declare const TOAST_PADDING_CLASS: Record<ToastSizeKey, string>;
-export declare const TOAST_FONT_CLASS: Record<ToastSizeKey, string>;
-export declare const TOAST_TITLE_FONT_CLASS: Record<ToastSizeKey, string>;
+import { Size } from '../../shared';
+import { ToastPlacement } from './toast-config';
+/**
+ * CSS classes for toast width based on size.
+ * Maps size keys to Tailwind width classes.
+ */
+export declare const TOAST_WIDTH_CLASS: Record<Size, string>;
+/**
+ * CSS classes for toast padding based on size.
+ * Maps size keys to Tailwind padding classes.
+ */
+export declare const TOAST_PADDING_CLASS: Record<Size, string>;
+/**
+ * CSS classes for toast message font size.
+ * Maps size keys to Tailwind text size classes.
+ */
+export declare const TOAST_FONT_CLASS: Record<Size, string>;
+/**
+ * CSS classes for toast title font size.
+ * Maps size keys to Tailwind text size and weight classes.
+ */
+export declare const TOAST_TITLE_FONT_CLASS: Record<Size, string>;
+/**
+ * CSS classes for toast enter and exit animations.
+ * Each placement has its own enter and exit animation classes.
+ * These classes should be defined in your global CSS with keyframe animations.
+ */
 export declare const TOAST_ANIMATION_STATE: Record<ToastPlacement, {
     enter: string;
     exit: string;

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

@@ -1 +1 @@
-{"version":3,"file":"toast-styles.d.ts","sourceRoot":"","sources":["../../../src/components/toast/toast-styles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnE,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAI1D,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAI5D,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAIzD,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAI/D,CAAC;AAGF,eAAO,MAAM,qBAAqB,EAAE,MAAM,CACxC,cAAc,EACd;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CA0BhC,CAAC"}
+{"version":3,"file":"toast-styles.d.ts","sourceRoot":"","sources":["../../../src/components/toast/toast-styles.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAIlD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAIpD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAIjD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAIvD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CACxC,cAAc,EACd;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CA0BhC,CAAC"}

package/dist/components/toast/use-pausable-timeout.d.ts

@@ -1,3 +1,32 @@
+/**
+ * Hook that creates a pausable timeout.
+ *
+ * usePausableTimeout returns pause and resume functions that control
+ * a timeout callback. This is useful for scenarios like toast notifications
+ * where the auto-dismiss timer should pause when the user hovers over the
+ * element and resume when they leave.
+ *
+ * @param callback - The function to call when the timeout completes.
+ * @param delay - The delay in milliseconds before the callback is called.
+ *                If 0 or negative, the timeout is disabled.
+ * @returns An object with pause and resume functions.
+ *
+ * @example
+ * ```tsx
+ * const { pause, resume } = usePausableTimeout(() => {
+ *   console.log('Timeout completed!');
+ * }, 3000);
+ *
+ * return (
+ *   <div
+ *     onMouseEnter={pause}
+ *     onMouseLeave={resume}
+ *   >
+ *     Hover to pause the timeout
+ *   </div>
+ * );
+ * ```
+ */
 export declare function usePausableTimeout(callback: () => void, delay?: number): {
     pause: () => void;
     resume: () => void;

package/dist/components/toast/use-pausable-timeout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-pausable-timeout.d.ts","sourceRoot":"","sources":["../../../src/components/toast/use-pausable-timeout.ts"],"names":[],"mappings":"AAIA,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,KAAK,CAAC,EAAE,MAAM;;;EA8BtE"}
+{"version":3,"file":"use-pausable-timeout.d.ts","sourceRoot":"","sources":["../../../src/components/toast/use-pausable-timeout.ts"],"names":[],"mappings":"AAUA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,KAAK,CAAC,EAAE,MAAM;;;EA8BtE"}

package/dist/components/tooltip/Tooltip.d.ts

@@ -1,23 +1,83 @@
 import { ReactElement, ReactNode } from 'react';
-import { Radius } from '../../shared/radius';
-import { Color, Variant } from '../../shared/variant';
-import { TooltipPlacement, TooltipSizeKey } from './tooltip-config';
-export interface TooltipProps {
+import { TooltipConfig } from './tooltip-config';
+type BaseTooltipProps = TooltipConfig;
+/**
+ * Configuration options for the Tooltip component.
+ */
+export interface TooltipProps extends BaseTooltipProps {
+    /**
+     * The content to display inside the tooltip.
+     * When empty or null, the tooltip is not shown.
+     */
     content: ReactNode;
+    /**
+     * The child element that triggers the tooltip.
+     * Can be any React element or a string.
+     */
     children: ReactElement | ReactNode;
-    variant?: Variant;
-    color?: Color;
-    size?: TooltipSizeKey;
-    placement?: TooltipPlacement;
-    delay?: number | {
-        open?: number;
-        close?: number;
-    };
-    offset?: number;
-    radius?: Radius;
-    showArrow?: boolean;
+    /**
+     * Whether the tooltip is disabled.
+     * When true, the tooltip does not appear on hover or focus.
+     *
+     * @default false
+     */
     isDisabled?: boolean;
-    className?: string;
 }
+/**
+ * A floating tooltip that appears on hover or focus of a child element.
+ *
+ * Tooltip renders a floating popup with additional information that appears
+ * when the user hovers or focuses the trigger element. It supports configurable
+ * placement, delay, offset, radius, arrow, and styling through the standard
+ * AsheeUI cascade system.
+ *
+ * The component uses Floating UI for positioning and accessibility, and
+ * automatically handles viewport edge detection and flipping. It is fully
+ * accessible with keyboard focus support.
+ *
+ * @param props - Tooltip configuration options.
+ * @param props.content - The content to display inside the tooltip.
+ * @param props.children - The child element that triggers the tooltip.
+ * @param props.isDisabled - Whether the tooltip is disabled. Defaults to false.
+ * @param props.variant - Visual style variant. Defaults to "solid".
+ * @param props.color - Theme accent color. Defaults to "secondary".
+ * @param props.size - Size scale. Defaults to "md".
+ * @param props.placement - Placement relative to the trigger. Defaults to "top".
+ * @param props.delay - Delay before showing/hiding. Defaults to 200.
+ * @param props.offset - Offset from the trigger. Defaults to 8.
+ * @param props.radius - Corner rounding. Defaults to "md".
+ * @param props.showArrow - Whether to show a pointer arrow. Defaults to false.
+ * @param props.className - Extra classes for the tooltip.
+ *
+ * @example
+ * ```tsx
+ * import { Tooltip, Button } from "asheeui";
+ *
+ * export function Example() {
+ *   return (
+ *     <Tooltip content="This is a tooltip">
+ *       <Button>Hover me</Button>
+ *     </Tooltip>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // With custom placement and arrow
+ * <Tooltip
+ *   content="Delete this item"
+ *   placement="bottom"
+ *   showArrow
+ *   color="danger"
+ * >
+ *   <TrashIcon />
+ * </Tooltip>
+ * ```
+ *
+ * @see TooltipConfig - The configuration type for component defaults.
+ * @see useAsheeConfig - Hook for accessing the global configuration.
+ */
 export declare const Tooltip: import('react').ForwardRefExoticComponent<TooltipProps & import('react').RefAttributes<HTMLDivElement>>;
+export {};
 //# sourceMappingURL=Tooltip.d.ts.map

package/dist/components/tooltip/Tooltip.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Tooltip.d.ts","sourceRoot":"","sources":["../../../src/components/tooltip/Tooltip.tsx"],"names":[],"mappings":"AAiBA,OAAO,EAIL,KAAK,YAAY,EACjB,KAAK,SAAS,EAGf,MAAM,OAAO,CAAC;AAEf,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EACL,KAAK,KAAK,EAEV,KAAK,OAAO,EACb,MAAM,sBAAsB,CAAC;AAO9B,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACpB,MAAM,kBAAkB,CAAC;AAO1B,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,SAAS,CAAC;IACnB,QAAQ,EAAE,YAAY,GAAG,SAAS,CAAC;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,GAAG;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,OAAO,yGA2MnB,CAAC"}
+{"version":3,"file":"Tooltip.d.ts","sourceRoot":"","sources":["../../../src/components/tooltip/Tooltip.tsx"],"names":[],"mappings":"AAyBA,OAAO,EAIL,KAAK,YAAY,EACjB,KAAK,SAAS,EAGf,MAAM,OAAO,CAAC;AAcf,OAAO,EAEL,KAAK,aAAa,EAGnB,MAAM,kBAAkB,CAAC;AAO1B,KAAK,gBAAgB,GAAG,aAAa,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IACpD;;;OAGG;IACH,OAAO,EAAE,SAAS,CAAC;IAEnB;;;OAGG;IACH,QAAQ,EAAE,YAAY,GAAG,SAAS,CAAC;IAEnC;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,eAAO,MAAM,OAAO,yGAyMnB,CAAC"}

package/dist/components/tooltip/Tooltip.js

@@ -1,14 +1,14 @@
 "use client";
-import { jsx as a, Fragment as y, jsxs as h } from "react/jsx-runtime";
+import { jsx as a, Fragment as S, jsxs as h } from "react/jsx-runtime";
 import { offset as J, flip as Q, shift as W, arrow as Z, useFloating as $, autoUpdate as ee, useHover as se, useFocus as oe, useDismiss as re, useRole as te, useInteractions as ae, FloatingPortal as le, FloatingArrow as ne } from "@floating-ui/react";
 import { forwardRef as de, useRef as ie, useState as me, isValidElement as pe, cloneElement as ce } from "react";
 import { useAsheeConfig as ue } from "../../libs/context.js";
-import { RADIUS_CLASS as fe } from "../../shared/radius.js";
-import { resolveVariantClass as ve } from "../../shared/variant.js";
-import { resolveCascade as o, resolveRadiusKey as we, resolveClassKey as i } from "../../utils/resolve-token.js";
+import { resolveCascade as o, resolveRadiusKey as fe, resolveClassKey as i } from "../../utils/resolve-token.js";
 import { FALLBACK_TOOLTIP_CONFIG as s } from "./tooltip-config.js";
-import { TOOLTIP_PADDING_X_CLASS as Ae, TOOLTIP_PADDING_Y_CLASS as Oe, TOOLTIP_FONT_CLASS as Se } from "./tooltip-styles.js";
-import { cn as ye } from "../../utils/cn.js";
+import { TOOLTIP_PADDING_X_CLASS as ve, TOOLTIP_PADDING_Y_CLASS as we, TOOLTIP_FONT_CLASS as ye } from "./tooltip-styles.js";
+import { RADIUS_CLASS as Ae } from "../../shared/radius.js";
+import { cn as Oe } from "../../utils/cn.js";
+import { resolveVariantClass as Se } from "../../shared/variant.js";
 const he = de(
   ({
     content: u,
@@ -24,13 +24,13 @@ const he = de(
     isDisabled: l = !1,
     className: z
   }, n) => {
-    var S;
-    const d = ue(), e = (S = d.components) == null ? void 0 : S.tooltip, f = ie(null), [v, x] = me(!1), m = o(
+    var O;
+    const d = ue(), e = (O = d.components) == null ? void 0 : O.tooltip, f = ie(null), [v, K] = me(!1), m = o(
       _,
       e == null ? void 0 : e.size,
       void 0,
       s.size
-    ), K = o(
+    ), x = o(
       F,
       e == null ? void 0 : e.placement,
       void 0,
@@ -55,50 +55,50 @@ const he = de(
       e == null ? void 0 : e.showArrow,
       void 0,
       s.showArrow
-    ), E = we(
+    ), E = fe(
       N,
       e == null ? void 0 : e.radius,
       d.defaultRadius,
       s.radius
     ), G = i(
       m,
-      Ae,
+      ve,
       s.size
     ), j = i(
       m,
-      Oe,
+      we,
       s.size
     ), U = i(
       m,
-      Se,
+      ye,
       s.size
     ), X = i(
       E,
-      fe,
+      Ae,
       s.radius
-    ), A = [
+    ), y = [
       J(g),
       Q({ padding: 8 }),
       W({ padding: 8 })
     ];
-    w && A.push(Z({ element: f }));
+    w && y.push(Z({ element: f }));
     const { refs: p, floatingStyles: Y, context: t } = $({
       open: v && !l,
-      onOpenChange: x,
-      placement: K,
+      onOpenChange: K,
+      placement: x,
       whileElementsMounted: ee,
-      middleware: A
+      middleware: y
     }), k = se(t, {
       delay: b,
       enabled: !l
-    }), B = oe(t, { enabled: !l }), H = re(t), M = te(t, { role: "tooltip" }), { getReferenceProps: O, getFloatingProps: q } = ae([
+    }), B = oe(t, { enabled: !l }), H = re(t), M = te(t, { role: "tooltip" }), { getReferenceProps: A, getFloatingProps: q } = ae([
       k,
       B,
       H,
       M
     ]), C = pe(r) ? ce(
       r,
-      O({
+      A({
         ref: p.setReference,
         ...r.props
       })
@@ -106,12 +106,12 @@ const he = de(
       "span",
       {
         ref: p.setReference,
-        ...O(),
+        ...A(),
         className: "inline-flex",
         children: r
       }
     );
-    return !u || l ? /* @__PURE__ */ a(y, { children: r }) : /* @__PURE__ */ h(y, { children: [
+    return !u || l ? /* @__PURE__ */ a(S, { children: r }) : /* @__PURE__ */ h(S, { children: [
       C,
       /* @__PURE__ */ a(le, { children: v && /* @__PURE__ */ a(
         "div",
@@ -125,13 +125,13 @@ const he = de(
           children: /* @__PURE__ */ h(
             "div",
             {
-              className: ye(
+              className: Oe(
                 "font-medium border whitespace-nowrap select-none bg-background shadow-md transition-all duration-150 ease-out animate-in fade-in-0 zoom-in-95",
                 G,
                 j,
                 U,
                 X,
-                ve(D, V),
+                Se(D, V),
                 e == null ? void 0 : e.className,
                 z
               ),