asheeui 0.6.2 → 0.6.3

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

@@ -1 +1 @@
-{"version":3,"file":"tabs-styles.d.ts","sourceRoot":"","sources":["../../../src/components/tabs/tabs-styles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAIzD,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAI5D,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAIvD,CAAC"}
+{"version":3,"file":"tabs-styles.d.ts","sourceRoot":"","sources":["../../../src/components/tabs/tabs-styles.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEzC;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAIlD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAIrD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAIhD,CAAC"}

package/dist/components/textarea/Textarea.d.ts

@@ -1,21 +1,115 @@
 import { default as React, TextareaHTMLAttributes } from 'react';
-import { Radius } from '../../shared/radius';
-import { Color, Variant } from '../../shared/variant';
-import { FieldSizeKey, FieldStatus, LabelAlign } from '../field/field-config';
-export interface TextAreaProps extends Omit<TextareaHTMLAttributes<HTMLTextAreaElement>, "size" | "color" | "children"> {
-    size?: FieldSizeKey;
-    radius?: Radius;
-    variant?: Variant;
-    color?: Color;
-    status?: FieldStatus;
+import { TextAreaConfig } from './textarea-config';
+type BaseTextAreaProps = TextAreaConfig & Omit<TextareaHTMLAttributes<HTMLTextAreaElement>, "size" | "color" | "children">;
+/**
+ * Configuration options for the TextArea component.
+ */
+export interface TextAreaProps extends BaseTextAreaProps {
+    /**
+     * Label text for the textarea.
+     * Displayed above the input field.
+     */
     label?: string;
+    /**
+     * Whether the textarea is in a loading state.
+     * Shows a loading spinner next to the label.
+     *
+     * @default false
+     */
     isLoading?: boolean;
-    labelAlign?: LabelAlign;
+    /**
+     * Description text shown below the label.
+     * Provides additional context about the textarea.
+     */
     description?: string;
+    /**
+     * Validation message shown below the textarea.
+     * Color is determined by the status prop.
+     */
     message?: string;
+    /**
+     * Whether the field is required.
+     * Adds a required indicator (*) to the label.
+     *
+     * @default false
+     */
     required?: boolean;
-    rows?: number;
+    /**
+     * Whether the virtual keyboard should be enabled for mobile devices.
+     * Controls the inputmode attribute.
+     *
+     * @default true
+     */
     enableVirtualKeyboard?: boolean;
 }
+/**
+ * A multi-line text input with label, description, validation message,
+ * and virtual keyboard support.
+ *
+ * TextArea renders a textarea with consistent styling and field layout.
+ * It supports validation states, loading state, configurable rows, and
+ * the standard AsheeUI cascade for visual tokens. The component integrates
+ * with FieldShell for label, description, and message handling.
+ *
+ * The component automatically handles accessibility attributes including
+ * aria-invalid, aria-describedby, and proper focus management. It also
+ * supports mobile virtual keyboard control via the enableVirtualKeyboard prop.
+ *
+ * @param props - TextArea configuration options and native textarea props.
+ * @param props.label - Label text for the textarea.
+ * @param props.isLoading - Loading state. Defaults to false.
+ * @param props.description - Description text.
+ * @param props.message - Validation message.
+ * @param props.required - Whether the field is required. Defaults to false.
+ * @param props.enableVirtualKeyboard - Enable mobile virtual keyboard. Defaults to true.
+ * @param props.rows - Number of visible text rows. Defaults to 4.
+ * @param props.size - Size of the textarea. Defaults to "md".
+ * @param props.radius - Corner rounding. Defaults to "md".
+ * @param props.variant - Visual style variant. Defaults to "bordered".
+ * @param props.color - Theme accent color. Defaults to "primary".
+ * @param props.status - Validation status.
+ * @param props.labelAlign - Alignment of the label. Defaults to "left".
+ * @param props.disabled - Whether the textarea is disabled.
+ * @param props.className - Extra CSS classes for the textarea.
+ * @param props.id - Optional ID for the field.
+ * @param props.style - Inline styles for the textarea.
+ *
+ * @example
+ * ```tsx
+ * import { TextArea } from "asheeui";
+ * import { useState } from "react";
+ *
+ * export function Example() {
+ *   const [value, setValue] = useState("");
+ *
+ *   return (
+ *     <TextArea
+ *       label="Message"
+ *       description="Write your message here"
+ *       placeholder="Type your message..."
+ *       value={value}
+ *       onChange={(e) => setValue(e.target.value)}
+ *       rows={6}
+ *     />
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // With validation state
+ * <TextArea
+ *   label="Feedback"
+ *   status="error"
+ *   message="Feedback must be at least 10 characters"
+ *   required
+ * />
+ * ```
+ *
+ * @see TextAreaConfig - The configuration type for component defaults.
+ * @see FieldShell - The wrapper component for label and validation.
+ * @see useAsheeConfig - Hook for accessing the global configuration.
+ */
 export declare const TextArea: React.ForwardRefExoticComponent<TextAreaProps & React.RefAttributes<HTMLTextAreaElement>>;
+export {};
 //# sourceMappingURL=Textarea.d.ts.map

package/dist/components/textarea/Textarea.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Textarea.d.ts","sourceRoot":"","sources":["../../../src/components/textarea/Textarea.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,EAEZ,KAAK,sBAAsB,EAK5B,MAAM,OAAO,CAAC;AAEf,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EACL,KAAK,KAAK,EAEV,KAAK,OAAO,EACb,MAAM,sBAAsB,CAAC;AAQ9B,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,UAAU,EACX,MAAM,uBAAuB,CAAC;AAa/B,MAAM,WAAW,aACf,SAAQ,IAAI,CACV,sBAAsB,CAAC,mBAAmB,CAAC,EAC3C,MAAM,GAAG,OAAO,GAAG,UAAU,CAC9B;IACD,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAID,eAAO,MAAM,QAAQ,2FAyKpB,CAAC"}
+{"version":3,"file":"Textarea.d.ts","sourceRoot":"","sources":["../../../src/components/textarea/Textarea.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,EAEZ,KAAK,sBAAsB,EAK5B,MAAM,OAAO,CAAC;AAkBf,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAQ3B,KAAK,iBAAiB,GAAG,cAAc,GACrC,IAAI,CACF,sBAAsB,CAAC,mBAAmB,CAAC,EAC3C,MAAM,GAAG,OAAO,GAAG,UAAU,CAC9B,CAAC;AAEJ;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,iBAAiB;IACtD;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmEG;AACH,eAAO,MAAM,QAAQ,2FA4KpB,CAAC"}

package/dist/components/textarea/Textarea.js

@@ -1,21 +1,21 @@
 "use client";
 import { jsx as h } from "react/jsx-runtime";
-import { forwardRef as W, useRef as Y, useImperativeHandle as g, useId as q, useCallback as T } from "react";
+import { forwardRef as W, useRef as Y, useImperativeHandle as g, useId as q, useCallback as K } from "react";
 import { useAsheeConfig as ee } from "../../libs/context.js";
-import { RADIUS_CLASS as re } from "../../shared/radius.js";
-import { resolveVariantClass as se } from "../../shared/variant.js";
-import { resolveCascade as o, resolveRadiusKey as ae, resolveClassKey as oe } from "../../utils/resolve-token.js";
-import { FieldShell as le } from "../field/FieldShell.js";
+import { resolveCascade as o, resolveRadiusKey as re, resolveClassKey as se } from "../../utils/resolve-token.js";
+import { FieldShell as ae } from "../field/FieldShell.js";
 import { FALLBACK_TEXTAREA_CONFIG as r } from "./textarea-config.js";
-import { TEXTAREA_STATUS_BORDER_CLASS as te, TEXTAREA_SIZE_CLASS as de } from "./textarea-styles.js";
-import { useKeyboardField as ie } from "../keyboard/use-keyboard-field.js";
+import { TEXTAREA_STATUS_BORDER_CLASS as oe, TEXTAREA_SIZE_CLASS as le } from "./textarea-styles.js";
+import { useKeyboardField as te } from "../keyboard/use-keyboard-field.js";
+import { resolveVariantClass as de } from "../../shared/variant.js";
+import { RADIUS_CLASS as ie } from "../../shared/radius.js";
 import { cn as ne } from "../../utils/cn.js";
 const ue = W(
   ({
-    size: I,
-    radius: x,
-    variant: E,
-    color: K,
+    size: T,
+    radius: I,
+    variant: x,
+    color: E,
     status: _,
     label: w,
     labelAlign: L,
@@ -36,34 +36,34 @@ const ue = W(
     var S;
     const d = ee(), e = (S = d.components) == null ? void 0 : S.textarea, n = Y(null);
     g(k, () => n.current);
-    const D = q(), a = C ?? D, f = u ? `${a}-description` : void 0, A = c ? `${a}-message` : void 0, O = [f, A].filter(Boolean).join(" ") || void 0, { handleFocus: p, handleBlur: b } = ie(a, n, X), U = T(
+    const D = q(), a = C ?? D, f = u ? `${a}-description` : void 0, A = c ? `${a}-message` : void 0, O = [f, A].filter(Boolean).join(" ") || void 0, { handleFocus: p, handleBlur: b } = te(a, n, X), U = K(
       (s) => {
         p(s), l == null || l(s);
       },
       [p, l]
-    ), V = T(
+    ), V = K(
       (s) => {
         b(), t == null || t(s);
       },
       [b, t]
     ), $ = o(
-      I,
+      T,
       e == null ? void 0 : e.size,
       void 0,
       r.size
-    ), R = o(
-      E,
+    ), y = o(
+      x,
       e == null ? void 0 : e.variant,
       d.defaultVariant,
       r.variant
     ), G = o(
-      K,
+      E,
       e == null ? void 0 : e.color,
       d.defaultColor,
       r.color
-    ), y = (s) => s === "full" ? "xl" : s, H = ae(
-      y(x),
-      y(e == null ? void 0 : e.radius),
+    ), R = (s) => s === "full" ? "xl" : s, H = re(
+      R(I),
+      R(e == null ? void 0 : e.radius),
       d.defaultRadius,
       r.radius
     ), i = _ ?? r.status, Z = o(
@@ -76,13 +76,16 @@ const ue = W(
       e == null ? void 0 : e.rows,
       void 0,
       r.rows
-    ), M = se(R, G), P = i !== "default" ? te[i] : "", Q = R === "underlined" ? "rounded-none" : oe(
+    ), M = de(
+      y,
+      G
+    ), P = i !== "default" ? oe[i] : "", Q = y === "underlined" ? "rounded-none" : se(
       H,
-      re,
+      ie,
       r.radius
     );
     return /* @__PURE__ */ h(
-      le,
+      ae,
       {
         id: a,
         label: w,
@@ -111,7 +114,7 @@ const ue = W(
               "resize-y w-full text-foreground outline-none transition-colors shrink-0",
               "focus-visible:ring-2 focus-visible:ring-offset-2",
               "disabled:pointer-events-none disabled:opacity-50",
-              de[$],
+              le[$],
               M,
               P,
               Q,

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

@@ -1,8 +1,29 @@
 import { FieldConfig } from '../field/field-config';
+/**
+ * Theme configuration options for the TextArea component.
+ *
+ * Set under `components.textarea` in the AsheeUI config. Values feed the
+ * component-level fallback tier of the theme cascade.
+ */
 export interface TextAreaConfig extends FieldConfig {
+    /**
+     * Default number of visible text rows.
+     * Controls the initial height of the textarea.
+     *
+     * @default 4
+     */
     rows?: number;
 }
+/**
+ * Default config values registered for the TextArea component.
+ * Inherits field defaults and sets default rows to 4.
+ */
 export declare const defaultTextAreaConfig: TextAreaConfig;
+/**
+ * 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_TEXTAREA_CONFIG: Required<TextAreaConfig>;
 declare module "../../libs/registry" {
     interface ComponentTypeConfigRegistry {

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

@@ -1 +1 @@
-{"version":3,"file":"textarea-config.d.ts","sourceRoot":"","sources":["../../../src/components/textarea/textarea-config.ts"],"names":[],"mappings":"AACA,OAAO,EAAyB,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEhF,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,qBAAqB,EAAE,cAKnC,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,QAAQ,CAAC,cAAc,CASpD,CAAC;AAEX,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,2BAA2B;QACnC,QAAQ,EAAE,cAAc,CAAC;KAC1B;CACF"}
+{"version":3,"file":"textarea-config.d.ts","sourceRoot":"","sources":["../../../src/components/textarea/textarea-config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAGL,KAAK,WAAW,EACjB,MAAM,uBAAuB,CAAC;AAE/B;;;;;GAKG;AACH,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,cAGnC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,QAAQ,CAAC,cAAc,CAGpD,CAAC;AAEX,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,2BAA2B;QACnC,QAAQ,EAAE,cAAc,CAAC;KAC1B;CACF"}

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

@@ -1,23 +1,15 @@
 "use client";
 import { registerComponentDefaults as e } from "../../libs/registry.js";
-import { FALLBACK_FIELD_CONFIG as r } from "../field/field-config.js";
-const t = {
-  size: "md",
-  labelAlign: "left",
-  variant: "bordered",
+import { FALLBACK_FIELD_CONFIG as t, defaultFieldConfig as o } from "../field/field-config.js";
+const r = {
+  ...o,
   rows: 4
-}, i = {
-  ...r,
-  size: "md",
-  radius: "md",
-  variant: "bordered",
-  color: "primary",
-  status: "default",
-  labelAlign: "left",
+}, n = {
+  ...t,
   rows: 4
 };
-e("textarea", t);
+e("textarea", r);
 export {
-  i as FALLBACK_TEXTAREA_CONFIG,
-  t as defaultTextAreaConfig
+  n as FALLBACK_TEXTAREA_CONFIG,
+  r as defaultTextAreaConfig
 };

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

@@ -1,4 +1,13 @@
 import { FieldSizeKey, FieldStatus } from '../field/field-config';
+/**
+ * CSS classes for textarea padding and font size.
+ * Maps size keys to Tailwind padding and text size classes.
+ */
 export declare const TEXTAREA_SIZE_CLASS: Record<FieldSizeKey, string>;
+/**
+ * CSS classes for textarea status border styles.
+ * Maps status values to Tailwind classes for border and
+ * focus ring colors. Re-exports FIELD_STATUS_BORDER_CLASS.
+ */
 export declare const TEXTAREA_STATUS_BORDER_CLASS: Record<FieldStatus, string>;
 //# sourceMappingURL=textarea-styles.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"textarea-styles.d.ts","sourceRoot":"","sources":["../../../src/components/textarea/textarea-styles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEvE,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAI5D,CAAC;AAEF,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAQpE,CAAC"}
+{"version":3,"file":"textarea-styles.d.ts","sourceRoot":"","sources":["../../../src/components/textarea/textarea-styles.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGvE;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAI5D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAC1C,CAAC"}

package/dist/components/textarea/textarea-styles.js

@@ -1,15 +1,11 @@
 "use client";
-const s = {
+import { FIELD_STATUS_BORDER_CLASS as t } from "../field/field-styles.js";
+const A = {
   sm: "p-2 text-xs",
   md: "p-3 text-sm",
   lg: "p-4 text-base"
-}, e = {
-  default: "",
-  error: "border-danger focus-visible:border-danger focus-visible:ring-danger/20",
-  warning: "border-warning focus-visible:border-warning focus-visible:ring-warning/20",
-  success: "border-success focus-visible:border-success focus-visible:ring-success/20"
-};
+}, E = t;
 export {
-  s as TEXTAREA_SIZE_CLASS,
-  e as TEXTAREA_STATUS_BORDER_CLASS
+  A as TEXTAREA_SIZE_CLASS,
+  E as TEXTAREA_STATUS_BORDER_CLASS
 };

package/dist/components/toast/ToastItem.d.ts

@@ -1,15 +1,69 @@
-import { Radius } from '../../shared/radius';
-import { Color, Variant } from '../../shared/variant';
-import { ToastItemData, ToastPlacement, ToastSizeKey } from './toast-config';
+import { Color, Radius, Size, Variant } from '../../shared';
+import { ToastItemData, ToastPlacement } from './toast-config';
+/**
+ * Props for the ToastItem component.
+ * Extends ToastItemData with additional configuration and callbacks.
+ */
 export interface ToastItemProps extends ToastItemData {
+    /**
+     * Callback fired when the toast should be dismissed.
+     */
     onDismiss: (id: string) => void;
+    /**
+     * Placement of the toast container.
+     * Determines the animation direction.
+     */
     placement: ToastPlacement;
-    size: ToastSizeKey;
+    /**
+     * Size scale of the toast.
+     */
+    size: Size;
+    /**
+     * Visual style variant of the toast.
+     */
     variant: Variant;
+    /**
+     * Theme color of the toast.
+     * Overrides the auto-detected color from the type.
+     */
     color?: Color;
+    /**
+     * Corner rounding of the toast.
+     */
     radius: Radius;
+    /**
+     * Whether the toast has animations.
+     */
     animated?: boolean;
 }
+/**
+ * A single toast notification item.
+ *
+ * ToastItem renders a toast notification with icon, title, message,
+ * optional action, and dismiss button. It supports pause on hover,
+ * enter/exit animations, and configurable styling. The component uses
+ * the usePausableTimeout hook to pause auto-dismissal during hover.
+ *
+ * @param props - ToastItem configuration options.
+ * @param props.id - Unique identifier for the toast.
+ * @param props.title - Optional title text.
+ * @param props.message - The main message content.
+ * @param props.type - Type of toast. Defaults to "info".
+ * @param props.timeout - Duration before auto-dismissal. Defaults to 3500.
+ * @param props.icon - Custom icon element.
+ * @param props.action - Action element rendered below the message.
+ * @param props.dismissible - Whether the toast can be dismissed. Defaults to true.
+ * @param props.onDismiss - Callback fired when the toast is dismissed.
+ * @param props.placement - Placement of the toast container.
+ * @param props.size - Size scale of the toast.
+ * @param props.variant - Visual style variant.
+ * @param props.color - Theme color override.
+ * @param props.radius - Corner rounding.
+ * @param props.animated - Whether the toast has animations.
+ *
+ * @see ToastItemData - The data structure for toast notifications.
+ * @see usePausableTimeout - Hook for pausing auto-dismissal.
+ */
 export declare function ToastItem({ id, title, message, type, timeout, icon, action, dismissible, onDismiss, placement, size, variant, color, radius, animated, }: ToastItemProps): import("react").JSX.Element;
 export declare namespace ToastItem {
     var displayName: string;

package/dist/components/toast/ToastItem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ToastItem.d.ts","sourceRoot":"","sources":["../../../src/components/toast/ToastItem.tsx"],"names":[],"mappings":"AASA,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EACL,KAAK,KAAK,EAEV,KAAK,OAAO,EACb,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,YAAY,EAElB,MAAM,gBAAgB,CAAC;AAkDxB,MAAM,WAAW,cAAe,SAAQ,aAAa;IACnD,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,SAAS,EAAE,cAAc,CAAC;IAC1B,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,SAAS,CAAC,EACxB,EAAE,EACF,KAAK,EACL,OAAO,EACP,IAAa,EACb,OAAc,EACd,IAAI,EACJ,MAAM,EACN,WAAkB,EAClB,SAAS,EACT,SAAS,EACT,IAAI,EACJ,OAAO,EACP,KAAK,EACL,MAAM,EACN,QAAQ,GACT,EAAE,cAAc,+BAyHhB;yBAzIe,SAAS"}
+{"version":3,"file":"ToastItem.d.ts","sourceRoot":"","sources":["../../../src/components/toast/ToastItem.tsx"],"names":[],"mappings":"AAgBA,OAAO,EACL,KAAK,KAAK,EAEV,KAAK,MAAM,EAEX,KAAK,IAAI,EACT,KAAK,OAAO,EACb,MAAM,cAAc,CAAC;AAGtB,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,cAAc,EAEpB,MAAM,gBAAgB,CAAC;AA0DxB;;;GAGG;AACH,MAAM,WAAW,cAAe,SAAQ,aAAa;IACnD;;OAEG;IACH,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAEhC;;;OAGG;IACH,SAAS,EAAE,cAAc,CAAC;IAE1B;;OAEG;IACH,IAAI,EAAE,IAAI,CAAC;IAEX;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;;OAGG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;IAEd;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,SAAS,CAAC,EACxB,EAAE,EACF,KAAK,EACL,OAAO,EACP,IAAa,EACb,OAAc,EACd,IAAI,EACJ,MAAM,EACN,WAAkB,EAClB,SAAS,EACT,SAAS,EACT,IAAI,EACJ,OAAO,EACP,KAAK,EACL,MAAM,EACN,QAAQ,GACT,EAAE,cAAc,+BAyHhB;yBAzIe,SAAS"}

package/dist/components/toast/ToastItem.js

@@ -7,13 +7,13 @@ import { ErrorIcon as z } from "../../icons/ErrorIcon.js";
 import { InfoIcon as B } from "../../icons/InfoIcon.js";
 import { WarningIcon as H } from "../../icons/WarningIcon.js";
 import { useAsheeConfig as R } from "../../libs/context.js";
-import { RADIUS_CLASS as U } from "../../shared/radius.js";
-import { resolveVariantClass as V } from "../../shared/variant.js";
-import { resolveCascade as q, resolveClassKey as a } from "../../utils/resolve-token.js";
+import { resolveCascade as U, resolveClassKey as a } from "../../utils/resolve-token.js";
 import { FALLBACK_TOAST_CONFIG as n } from "./toast-config.js";
-import { TOAST_WIDTH_CLASS as J, TOAST_PADDING_CLASS as Q, TOAST_FONT_CLASS as X, TOAST_TITLE_FONT_CLASS as Y, TOAST_ANIMATION_STATE as Z } from "./toast-styles.js";
-import { usePausableTimeout as $ } from "./use-pausable-timeout.js";
+import { TOAST_WIDTH_CLASS as V, TOAST_PADDING_CLASS as q, TOAST_FONT_CLASS as J, TOAST_TITLE_FONT_CLASS as Q, TOAST_ANIMATION_STATE as X } from "./toast-styles.js";
+import { usePausableTimeout as Y } from "./use-pausable-timeout.js";
+import { RADIUS_CLASS as Z } from "../../shared/radius.js";
 import { cn as s } from "../../utils/cn.js";
+import { resolveVariantClass as $ } from "../../shared/variant.js";
 function ee(r = "info") {
   switch (r) {
     case "success":
@@ -53,14 +53,14 @@ function te({
   onDismiss: c,
   placement: x,
   size: i,
-  variant: d,
+  variant: p,
   color: I,
   radius: S,
-  animated: p
+  animated: d
 }) {
   var h;
-  const l = (h = R().components) == null ? void 0 : h.toast, [m, b] = G(!1), g = q(
-    p,
+  const l = (h = R().components) == null ? void 0 : h.toast, [m, b] = G(!1), g = U(
+    d,
     l == null ? void 0 : l.animated,
     void 0,
     n.animated
@@ -68,40 +68,40 @@ function te({
     g && !m ? (b(!0), setTimeout(() => {
       c(r);
     }, 150)) : c(r);
-  }, [g, m, c, r]), { pause: _, resume: k } = $(w, v), O = I ?? ee(u), y = d === "solid", L = a(
+  }, [g, m, c, r]), { pause: _, resume: k } = Y(w, v), O = I ?? ee(u), y = p === "solid", L = a(
     i,
-    J,
+    V,
     n.size
   ), E = a(
     i,
-    Q,
+    q,
     n.size
   ), F = a(
     i,
-    X,
+    J,
     n.size
   ), D = a(
     i,
-    Y,
+    Q,
     n.size
   ), M = a(
     S,
-    U,
+    Z,
     n.radius
-  ), T = Z[x], j = p ? m ? T.exit : T.enter : "";
+  ), T = X[x], j = d ? m ? T.exit : T.enter : "";
   return /* @__PURE__ */ C(
     "div",
     {
       onMouseEnter: _,
       onMouseLeave: k,
       className: s(
-        "pointer-events-auto relative flex gap-3 items-start shadow-lg border backdrop-blur-md select-none overflow-hidden transition-all duration-200 active:scale-[0.99]",
+        "pointer-events-auto relative flex gap-3 items-start shadow-lg border backdrop-blur-md select-none overflow-clip transition-all duration-200 active:scale-[0.99]",
         "bg-background",
         L,
         E,
         M,
         j,
-        V(d, O)
+        $(p, O)
       ),
       children: [
         /* @__PURE__ */ e("div", { className: "shrink-0 pt-0.5 ps-1", children: A ?? re(u, y) }),

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

@@ -1,32 +1,130 @@
 import { ReactNode } from 'react';
-import { Radius } from '../../shared/radius';
-import { Size } from '../../shared/size';
-import { Variant } from '../../shared/variant';
+import { Radius, Size, Variant } from '../../shared';
+/**
+ * Type of toast notification.
+ * Determines the icon and color styling.
+ */
 export type ToastType = "success" | "error" | "info" | "warning" | "default";
+/**
+ * Placement of the toast container on the screen.
+ * Controls where toasts appear and animate from.
+ */
 export type ToastPlacement = "top-right" | "top-left" | "bottom-right" | "bottom-left" | "top-center" | "bottom-center";
-export type ToastSizeKey = Size;
+/**
+ * Data structure for a single toast notification.
+ */
 export interface ToastItemData {
+    /**
+     * Unique identifier for the toast.
+     */
     id: string;
+    /**
+     * Optional title text.
+     * Displayed above the message in bold.
+     */
     title?: ReactNode;
+    /**
+     * The main message content.
+     */
     message: ReactNode;
+    /**
+     * Type of toast.
+     * Controls icon and color styling.
+     *
+     * @default "info"
+     */
     type?: ToastType;
+    /**
+     * Duration in milliseconds before auto-dismissal.
+     * Set to 0 or negative to disable auto-dismiss.
+     *
+     * @default 3500
+     */
     timeout?: number;
+    /**
+     * Custom icon element.
+     * Overrides the default icon for the toast type.
+     */
     icon?: ReactNode;
+    /**
+     * Action element rendered below the message.
+     * Typically a button for user interaction.
+     */
     action?: ReactNode;
+    /**
+     * Whether the toast can be dismissed by the user.
+     * When true, shows a close button.
+     *
+     * @default true
+     */
     dismissible?: boolean;
 }
+/**
+ * Theme configuration options for the Toast system.
+ *
+ * Set under `components.toast` in the AsheeUI config. Values feed the
+ * component-level fallback tier of the theme cascade.
+ */
 export interface ToastConfig {
-    size?: ToastSizeKey;
+    /**
+     * Size scale of toast notifications.
+     * Controls the width and padding of toasts.
+     *
+     * @default "md"
+     */
+    size?: Size;
+    /**
+     * Placement of the toast container.
+     * Controls where toasts appear on screen.
+     *
+     * @default "top-right"
+     */
     placement?: ToastPlacement;
+    /**
+     * Visual style variant of toasts.
+     * Controls the background and border treatment.
+     *
+     * @default "bordered"
+     */
     variant?: Variant;
+    /**
+     * Corner rounding of toast notifications.
+     *
+     * @default "md"
+     */
     radius?: Radius;
+    /**
+     * Whether toasts have enter and exit animations.
+     *
+     * @default true
+     */
     animated?: boolean;
+    /**
+     * Default timeout duration in milliseconds.
+     * Used when a toast does not specify its own timeout.
+     *
+     * @default 3500
+     */
     defaultTimeout?: number;
+    /**
+     * Maximum number of toasts to display at once.
+     * Older toasts are removed when this limit is exceeded.
+     *
+     * @default 5
+     */
     maxToasts?: number;
 }
+/**
+ * Default config values registered for the Toast component.
+ */
 export declare const defaultToastConfig: ToastConfig;
+/**
+ * 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_TOAST_CONFIG: {
-    readonly size: ToastSizeKey;
+    readonly size: Size;
     readonly placement: ToastPlacement;
     readonly variant: Variant;
     readonly radius: Radius;