asheeui 0.6.2 → 0.6.5

package/dist/components/autocomplete/Autocomplete.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Autocomplete.d.ts","sourceRoot":"","sources":["../../../src/components/autocomplete/Autocomplete.tsx"],"names":[],"mappings":"AAaA,OAAO,EAEL,KAAK,SAAS,EAKf,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAG3D,OAAO,EAAS,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAExD,OAAO,EAEL,KAAK,kBAAkB,EAExB,MAAM,uBAAuB,CAAC;AAI/B;;GAEG;AACH,MAAM,WAAW,iBACf,SAAQ,IAAI,CAAC,UAAU,EAAE,OAAO,GAAG,UAAU,CAAC;IAC9C;;;OAGG;IACH,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,yDAAyD;IACzD,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAC9E,0DAA0D;IAC1D,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,+CAA+C;IAC/C,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,sDAAsD;IACtD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAG3B;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,SAAS,CAAC,EAAE,KAAK,CAAC;IAClB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,IAAI,CAAC;CACjB;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,eAAO,MAAM,YAAY,gHAiMxB,CAAC"}
+{"version":3,"file":"Autocomplete.d.ts","sourceRoot":"","sources":["../../../src/components/autocomplete/Autocomplete.tsx"],"names":[],"mappings":"AAsBA,OAAO,EAEL,KAAK,SAAS,EAKf,MAAM,OAAO,CAAC;AAKf,OAAO,EAAS,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,OAAO,EACL,KAAK,kBAAkB,EAExB,MAAM,uBAAuB,CAAC;AAI/B,KAAK,qBAAqB,GAAG,kBAAkB,GAC7C,IAAI,CAAC,UAAU,EAAE,OAAO,GAAG,UAAU,CAAC,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,qBAAqB;IAC9D;;;;;OAKG;IACH,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAE5B;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAExB;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,MAAM,CAAC,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAE5E;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAE7C;;;;;;;;OAQG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IAEtB;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AACH,eAAO,MAAM,YAAY,gHAoMxB,CAAC"}

package/dist/components/autocomplete/Autocomplete.js

@@ -1,135 +1,142 @@
 "use client";
-import { jsxs as g, jsx as x } from "react/jsx-runtime";
-import { useFloating as C, autoUpdate as ee, offset as te, flip as se, shift as re, useFocus as oe, useDismiss as ie, useRole as le, useInteractions as ce } from "@floating-ui/react";
-import { forwardRef as me, useMemo as R, useState as y, useEffect as ae, useCallback as A } from "react";
-import { useAsheeConfig as ue } from "../../libs/context.js";
-import { resolveCascade as p, resolveRadiusKey as fe } from "../../utils/resolve-token.js";
-import { Input as de } from "../input/Input.js";
-import { SelectMenu as ne } from "../select-menu/SelectMenu.js";
-import { FALLBACK_AUTOCOMPLETE_CONFIG as l } from "./autocomplete-config.js";
-const pe = me(
+import { jsxs as g, jsx as z } from "react/jsx-runtime";
+import { useFloating as V, autoUpdate as C, offset as ee, flip as te, shift as se, size as re, useFocus as oe, useDismiss as ie, useRole as le, useInteractions as ce } from "@floating-ui/react";
+import { forwardRef as ae, useMemo as F, useState as A, useEffect as fe, useCallback as K } from "react";
+import { useAsheeConfig as me } from "../../libs/context.js";
+import { resolveCascade as S, resolveRadiusKey as de } from "../../utils/resolve-token.js";
+import { Input as pe } from "../input/Input.js";
+import { SelectMenu as ue } from "../select-menu/SelectMenu.js";
+import { FALLBACK_AUTOCOMPLETE_CONFIG as n } from "./autocomplete-config.js";
+const ne = ae(
   ({
     options: o = [],
     value: s,
     onValueChange: r,
     onInputChange: c,
-    allowCustomValue: z = !1,
+    allowCustomValue: b = !1,
     belowList: w,
     dropdownClassName: L,
-    menuVariant: E,
-    menuColor: K,
-    menuRadius: N,
-    menuSize: P,
+    menu: E,
+    variant: M,
+    color: P,
+    radius: j,
+    size: N,
     endContent: T,
-    onClick: S,
+    onClick: y,
     disabled: O,
-    placeholder: j = "Type to search...",
-    className: U,
-    size: _,
+    placeholder: U = "Type to search...",
+    className: _,
     ...B
-  }, m) => {
-    var b;
-    const a = ue(), t = (b = a.components) == null ? void 0 : b.autocomplete, i = R(
+  }, a) => {
+    var R;
+    const f = me(), t = (R = f.components) == null ? void 0 : R.autocomplete, i = F(
       () => o.find((e) => e.value === s),
       [o, s]
-    ), [v, u] = y(!1), [f, d] = y(
+    ), [x, m] = A(!1), [d, p] = A(
       () => i ? i.label : String(s ?? "")
     );
-    ae(() => {
-      i ? d(i.label) : s != null && d(String(s));
+    fe(() => {
+      i ? p(i.label) : s != null && p(String(s));
     }, [i, s]);
-    const { refs: M, floatingStyles: D, context: n } = C({
-      open: v,
-      onOpenChange: (e) => !O && u(e),
+    const { refs: v, floatingStyles: D, context: u } = V({
+      open: x,
+      onOpenChange: (e) => !O && m(e),
       placement: "bottom-start",
-      whileElementsMounted: ee,
-      middleware: [te(4), se(), re({ padding: 8 })]
-    }), G = oe(n), I = ie(n), q = le(n, { role: "combobox" }), { getReferenceProps: H, getFloatingProps: J } = ce([
+      whileElementsMounted: C,
+      middleware: [
+        ee(4),
+        te(),
+        se({ padding: 8 }),
+        re({
+          apply({ availableHeight: e, elements: l }) {
+            Object.assign(l.floating.style, {
+              maxHeight: `${e}px`
+            });
+          }
+        })
+      ]
+    }), G = oe(u), H = ie(u), I = le(u, { role: "combobox" }), { getReferenceProps: $, getFloatingProps: q } = ce([
       G,
-      I,
-      q
-    ]), Q = p(
-      _,
-      t == null ? void 0 : t.size,
-      void 0,
-      l.size
-    ), W = p(
-      E,
-      t == null ? void 0 : t.menuVariant,
-      a.defaultVariant,
-      l.variant
-    ), X = p(
-      K,
-      t == null ? void 0 : t.menuColor,
-      a.defaultColor,
-      l.color
-    ), Y = fe(
-      N,
-      t == null ? void 0 : t.menuRadius,
-      a.defaultRadius,
-      l.radius
-    ), Z = p(
+      H,
+      I
+    ]), J = S(
+      M,
+      t == null ? void 0 : t.variant,
+      f.defaultVariant,
+      n.variant
+    ), Q = S(
       P,
-      t == null ? void 0 : t.menuSize,
+      t == null ? void 0 : t.color,
+      f.defaultColor,
+      n.color
+    ), W = de(
+      j,
+      t == null ? void 0 : t.radius,
+      f.defaultRadius,
+      n.radius
+    ), X = S(
+      N,
+      t == null ? void 0 : t.size,
       void 0,
-      l.menuSize
-    ), $ = R(() => f.trim() ? o.filter(
-      (e) => e.label.toLowerCase().includes(f.toLowerCase())
-    ) : o, [o, f]), k = A(
+      n.size
+    ), Y = F(() => d.trim() ? o.filter(
+      (e) => e.label.toLowerCase().includes(d.toLowerCase())
+    ) : o, [o, d]), Z = K(
       (e) => {
-        const F = e.target.value;
-        d(F), c == null || c(F), u(!0), z && (r == null || r(F));
+        const l = e.target.value;
+        p(l), c == null || c(l), m(!0), b && (r == null || r(l));
       },
-      [z, c, r]
-    ), h = A(
+      [b, c, r]
+    ), k = K(
       (e) => {
-        d(e.label), r == null || r(e.value, e), u(!1);
+        p(e.label), r == null || r(e.value, e), m(!1);
       },
       [r]
-    ), V = R(
+    ), h = F(
       () => s != null ? [s] : [],
       [s]
     );
     return /* @__PURE__ */ g("div", { className: "w-full relative inline-block", children: [
-      /* @__PURE__ */ x(
-        de,
+      /* @__PURE__ */ z(
+        pe,
         {
           ref: (e) => {
-            M.setReference(e), typeof m == "function" ? m(e) : m && (m.current = e);
+            v.setReference(e), typeof a == "function" ? a(e) : a && (a.current = e);
           },
-          size: Q,
+          variant: J,
+          radius: W,
+          color: Q,
+          size: X,
           disabled: O,
-          placeholder: j,
-          value: f,
-          onChange: k,
+          placeholder: U,
+          value: d,
+          onChange: Z,
           onClick: (e) => {
-            O || u(!0), S == null || S(e);
+            O || m(!0), y == null || y(e);
           },
-          "aria-expanded": v,
-          "aria-autocomplete": "list",
+          "aria-expanded": x,
+          "aria-autocomplete": "none",
           endContent: T,
-          className: U,
-          ...H(B)
+          className: _,
+          ...$(B)
         }
       ),
-      /* @__PURE__ */ x(
-        ne,
+      /* @__PURE__ */ z(
+        ue,
         {
-          isOpen: v,
-          context: n,
+          isOpen: x,
+          context: u,
           floatingStyles: D,
-          getFloatingProps: J,
-          setFloatingRef: M.setFloating,
-          options: $,
-          selectedValues: V,
-          onSelectOption: h,
+          getFloatingProps: q,
+          setFloatingRef: v.setFloating,
+          options: Y,
+          selectedValues: h,
+          onSelectOption: k,
           isSearch: !1,
           belowList: w,
           dropdownClassName: L,
-          variant: W,
-          color: X,
-          radius: Y,
-          size: Z,
+          menuProps: E,
+          menuConfig: t == null ? void 0 : t.menu,
           initialFocus: -1,
           returnFocus: !1
         }
@@ -137,7 +144,7 @@ const pe = me(
     ] });
   }
 );
-pe.displayName = "Autocomplete";
+ne.displayName = "Autocomplete";
 export {
-  pe as Autocomplete
+  ne as Autocomplete
 };

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

@@ -1,25 +1,5 @@
-import { Radius } from '../../shared/radius';
-import { Size } from '../../shared/size';
-import { Color, Variant } from '../../shared/variant';
-import { FieldConfig, FieldSizeKey } from '../field/field-config';
-/** Density scale used by the autocomplete trigger and menu. */
-export type AutocompleteSizeKey = FieldSizeKey;
-/**
- * A single selectable autocomplete suggestion.
- */
-export interface AutocompleteOption {
-    /** Text displayed in the input and in the options list. */
-    label: string;
-    /** Stable identifier returned via `onValueChange`. */
-    value: string | number;
-    /** Disables the option when `true`.
-     *
-     * @default false
-     */
-    disabled?: boolean;
-    /** Allows arbitrary option metadata (e.g. icons, descriptions). */
-    [key: string]: unknown;
-}
+import { FieldConfig } from '../field/field-config';
+import { SelectMenuConfig } from '../select-menu';
 /**
  * Theme configuration options for the Autocomplete component.
  *
@@ -28,46 +8,11 @@ export interface AutocompleteOption {
  * the AsheeUI config.
  */
 export interface AutocompleteConfig extends FieldConfig {
-    /** Trigger density scale.
-     *
-     * @default "md"
-     */
-    size?: AutocompleteSizeKey;
-    /** Trigger and menu corner rounding.
-     *
-     * @default "md"
-     */
-    radius?: Radius;
-    /** Visual style of the trigger input.
-     *
-     * @default "bordered"
-     */
-    variant?: Variant;
-    /** Theme accent color of the trigger input.
-     *
-     * @default "primary"
-     */
-    color?: Color;
-    /** Visual style of the dropdown menu.
-     *
-     * @default "solid"
-     */
-    menuVariant?: Variant;
-    /** Theme accent color of the dropdown menu.
-     *
-     * @default "default"
-     */
-    menuColor?: Color;
-    /** Corner rounding of the dropdown menu.
-     *
-     * @default "md"
-     */
-    menuRadius?: Radius;
-    /** Density scale of the dropdown menu.
-     *
-     * @default "sm"
+    /**
+     * Configuration for the dropdown menu that displays suggestions.
+     * Controls the menu's visual appearance and behavior.
      */
-    menuSize?: Size;
+    menu?: SelectMenuConfig;
 }
 /**
  * Default config values registered for the Autocomplete component.
@@ -77,8 +22,10 @@ export interface AutocompleteConfig extends FieldConfig {
 export declare const defaultAutocompleteConfig: AutocompleteConfig;
 /**
  * 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_AUTOCOMPLETE_CONFIG: Required<AutocompleteConfig>;
+export declare const FALLBACK_AUTOCOMPLETE_CONFIG: Required<FieldConfig>;
 declare module "../../libs/registry" {
     interface ComponentTypeConfigRegistry {
         autocomplete: AutocompleteConfig;

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

@@ -1 +1 @@
-{"version":3,"file":"autocomplete-config.d.ts","sourceRoot":"","sources":["../../../src/components/autocomplete/autocomplete-config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,YAAY,EAClB,MAAM,uBAAuB,CAAC;AAE/B,+DAA+D;AAC/D,MAAM,MAAM,mBAAmB,GAAG,YAAY,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mEAAmE;IACnE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,kBAAmB,SAAQ,WAAW;IACrD;;;OAGG;IACH,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAC3B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAGhB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;IAGd;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,SAAS,CAAC,EAAE,KAAK,CAAC;IAClB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,IAAI,CAAC;CACjB;AAED;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,EAAE,kBAIvC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,4BAA4B,EAAE,QAAQ,CAAC,kBAAkB,CAWrE,CAAC;AAEF,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,2BAA2B;QACnC,YAAY,EAAE,kBAAkB,CAAC;KAClC;CACF"}
+{"version":3,"file":"autocomplete-config.d.ts","sourceRoot":"","sources":["../../../src/components/autocomplete/autocomplete-config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAGL,KAAK,WAAW,EACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD;;;;;;GAMG;AACH,MAAM,WAAW,kBAAmB,SAAQ,WAAW;IACrD;;;OAGG;IACH,IAAI,CAAC,EAAE,gBAAgB,CAAC;CACzB;AAED;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,EAAE,kBAAuC,CAAC;AAEhF;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,uBAAwB,CAAC;AAElE,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,2BAA2B;QACnC,YAAY,EAAE,kBAAkB,CAAC;KAClC;CACF"}

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

@@ -1,24 +1,9 @@
 "use client";
-import { registerComponentDefaults as e } from "../../libs/registry.js";
-import { FALLBACK_FIELD_CONFIG as o } from "../field/field-config.js";
-const r = {
-  size: "md",
-  labelAlign: "left",
-  variant: "bordered"
-}, m = {
-  ...o,
-  size: "md",
-  radius: "md",
-  variant: "bordered",
-  color: "primary",
-  labelAlign: "left",
-  menuVariant: "solid",
-  menuColor: "secondary",
-  menuRadius: "md",
-  menuSize: "sm"
-};
-e("autocomplete", r);
+import { registerComponentDefaults as o } from "../../libs/registry.js";
+import { FALLBACK_FIELD_CONFIG as t, defaultFieldConfig as e } from "../field/field-config.js";
+const C = e, l = t;
+o("autocomplete", C);
 export {
-  m as FALLBACK_AUTOCOMPLETE_CONFIG,
-  r as defaultAutocompleteConfig
+  l as FALLBACK_AUTOCOMPLETE_CONFIG,
+  C as defaultAutocompleteConfig
 };

package/dist/components/button/Button.d.ts

@@ -1,54 +1,44 @@
-import { ReactNode } from 'react';
-import { Color, Variant } from '../../shared/variant';
-import { ButtonRadiusKey, ButtonSizeKey } from './button-config';
+import { ButtonConfig } from './button-config';
 /**
  * Visual and behavioural options shared by button-like elements.
+ * This type combines the ButtonConfig with native button HTML attributes.
  */
-export interface ButtonCommonProps {
-    /** Visual style variant.
-     *
-     * @default "bordered"
-     */
-    variant?: Variant;
-    /** Theme accent color.
-     *
-     * @default "primary"
-     */
-    color?: Color;
-    /** Padding and font-size scale.
-     *
-     * @default "md"
-     */
-    size?: ButtonSizeKey;
-    /** Corner rounding.
-     *
-     * @default "md"
-     */
-    radius?: ButtonRadiusKey;
-    /** Enables the press-down scale animation.
+export type BaseButtonProps = ButtonConfig & Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "color" | "disabled">;
+/**
+ * Configuration options for the Button component.
+ *
+ * @see {@link ButtonCommonProps} for the shared visual props.
+ */
+interface ButtonProps extends BaseButtonProps {
+    /**
+     * Whether the button is in a disabled state.
+     * Disabled buttons cannot be interacted with and appear dimmed.
      *
-     * @default true
+     * @default false
      */
-    animate?: boolean;
-    /** Makes the button stretch to fill its parent width.
+    isDisabled?: boolean;
+    /**
+     * Shows a loading spinner and blocks interaction.
+     * When true, the button displays a spinner and prevents clicks.
      *
      * @default false
      */
-    fullWidth?: boolean;
-    /** Disables pointer events and dims the button.
+    isLoading?: boolean;
+    /**
+     * Native button type.
+     * Controls the button's behavior in forms.
      *
-     * @default false
+     * @default "button"
      */
-    isDisabled?: boolean;
-    /** Shows a loading spinner and blocks interaction.
+    type?: "button" | "submit" | "reset";
+    /**
+     * Switches to the compact icon-only layout.
+     * When true, the button becomes square and removes text padding.
      *
      * @default false
      */
-    isLoading?: boolean;
-    /** Extra classes merged with internal styles. */
-    className?: string;
+    icon?: boolean;
 }
-type CleanButtonProps = Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "color" | "disabled" | "className" | "children">;
 /**
  * A clickable element that triggers an action or event.
  *
@@ -57,6 +47,10 @@ type CleanButtonProps = Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "col
  * Visual tokens 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-disabled, aria-busy for loading states, and proper focus management.
+ * Icon-only buttons should provide an aria-label for accessibility.
+ *
  * @param props - Button configuration options and native button props.
  * @param props.variant - Visual style variant. Defaults to "bordered".
  * @param props.color - Theme accent color. Defaults to "primary".
@@ -69,6 +63,7 @@ type CleanButtonProps = Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "col
  * @param props.type - Native button type. Defaults to "button".
  * @param props.icon - Icon-only compact layout. Defaults to false.
  * @param props.children - Button label content.
+ * @param props.className - Extra CSS classes for the button.
  *
  * @example
  * ```tsx
@@ -86,20 +81,24 @@ type CleanButtonProps = Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "col
  *   );
  * }
  * ```
+ *
+ * @example
+ * ```tsx
+ * // Icon-only button with loading state
+ * <Button
+ *   icon
+ *   isLoading
+ *   aria-label="Refresh content"
+ *   onClick={handleRefresh}
+ * >
+ *   <RefreshIcon />
+ * </Button>
+ * ```
+ *
+ * @see ButtonConfig - The configuration type for component defaults.
+ * @see resolveVariantClass - Utility for resolving variant and color styles.
+ * @see useAsheeConfig - Hook for accessing the global configuration.
  */
-export declare const Button: import('react').ForwardRefExoticComponent<ButtonCommonProps & CleanButtonProps & {
-    /** Native button type.
-     *
-     * @default "button"
-     */
-    type?: "button" | "submit" | "reset";
-    /** Switches to the compact icon-only layout.
-     *
-     * @default false
-     */
-    icon?: boolean;
-    /** Button label content. */
-    children?: ReactNode;
-} & import('react').RefAttributes<HTMLButtonElement>>;
+export declare const Button: import('react').ForwardRefExoticComponent<ButtonProps & import('react').RefAttributes<HTMLButtonElement>>;
 export {};
 //# sourceMappingURL=Button.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Button.d.ts","sourceRoot":"","sources":["../../../src/components/button/Button.tsx"],"names":[],"mappings":"AAEA,OAAO,EAA+B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAGpE,OAAO,EACL,KAAK,KAAK,EAEV,KAAK,OAAO,EACb,MAAM,sBAAsB,CAAC;AAQ9B,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,aAAa,EAEnB,MAAM,iBAAiB,CAAC;AAGzB;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;IACd;;;OAGG;IACH,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB;;;OAGG;IACH,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,KAAK,gBAAgB,GAAG,IAAI,CAC1B,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAC7C,OAAO,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,CAChD,CAAC;AAuBF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,eAAO,MAAM,MAAM;IApDf;;;OAGG;WACI,QAAQ,GAAG,QAAQ,GAAG,OAAO;IACpC;;;OAGG;WACI,OAAO;IACd,4BAA4B;eACjB,SAAS;qDAyJvB,CAAC"}
+{"version":3,"file":"Button.d.ts","sourceRoot":"","sources":["../../../src/components/button/Button.tsx"],"names":[],"mappings":"AA2BA,OAAO,EAAE,KAAK,YAAY,EAA0B,MAAM,iBAAiB,CAAC;AAG5E;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,YAAY,GACxC,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC,CAAC;AAE5E;;;;GAIG;AACH,UAAU,WAAY,SAAQ,eAAe;IAC3C;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;IAErC;;;;;OAKG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DG;AACH,eAAO,MAAM,MAAM,2GAgHlB,CAAC"}

package/dist/components/button/Button.js

@@ -2,13 +2,13 @@
 import { jsxs as D, jsx as c } from "react/jsx-runtime";
 import { forwardRef as W } from "react";
 import { useAsheeConfig as j } from "../../libs/context.js";
-import { UnderlineRadius as f, RADIUS_CLASS as F } from "../../shared/radius.js";
-import { resolveVariantClass as V } from "../../shared/variant.js";
-import { resolveCascade as r, resolveRadiusKey as k, resolveClassKey as w } from "../../utils/resolve-token.js";
-import { Spinner as E } from "../spinner/spinner.js";
+import { resolveCascade as r, resolveRadiusKey as F, resolveClassKey as V } from "../../utils/resolve-token.js";
+import { Spinner as k } from "../spinner/spinner.js";
 import { FALLBACK_BUTTON_CONFIG as s } from "./button-config.js";
-import { BUTTON_ICON_SIZE_CLASS as Z, BUTTON_SIZE_CLASS as G } from "./button-styles.js";
-import { cn as q } from "../../utils/cn.js";
+import { BUTTON_ICON_SIZE_CLASS as w, BUTTON_SIZE_CLASS as E } from "./button-styles.js";
+import { cn as Z } from "../../utils/cn.js";
+import { UnderlineRadius as f, RADIUS_CLASS as G } from "../../shared/radius.js";
+import { resolveVariantClass as q } from "../../shared/variant.js";
 const H = W(
   (v, p) => {
     var m;
@@ -26,13 +26,13 @@ const H = W(
       children: B,
       type: I = "button",
       onClick: o,
-      ...R
+      ...K
     } = v, i = j(), e = (m = i.components) == null ? void 0 : m.button, t = r(
       b,
       e == null ? void 0 : e.variant,
       i.defaultVariant,
       s.variant
-    ), T = r(
+    ), R = r(
       y,
       e == null ? void 0 : e.color,
       i.defaultColor,
@@ -42,12 +42,12 @@ const H = W(
       e == null ? void 0 : e.size,
       void 0,
       s.size
-    ), z = k(
+    ), T = F(
       N,
       e == null ? void 0 : e.radius,
       i.defaultRadius,
       s.radius
-    ), K = r(
+    ), z = r(
       S,
       e == null ? void 0 : e.animate,
       s.animate,
@@ -57,24 +57,24 @@ const H = W(
       e == null ? void 0 : e.fullWidth,
       void 0,
       s.fullWidth
-    ), U = d ? Z[l] : G[l], n = _ || a, x = (u) => {
+    ), U = d ? w[l] : E[l], n = _ || a, x = (u) => {
       if (n) {
         u.preventDefault();
         return;
       }
       o == null || o(u);
-    }, C = q(
+    }, C = Z(
       "inline-flex items-center justify-center font-medium transition-colors select-none shrink-0",
       "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-primary focus-visible:ring-offset-2",
       "disabled:pointer-events-none disabled:opacity-50",
       "aria-disabled:pointer-events-none aria-disabled:opacity-50",
       O && "w-full",
-      K && "motion-safe:transition-transform motion-safe:duration-100 motion-safe:active:scale-[0.99]",
-      V(t, T),
+      z && "motion-safe:transition-transform motion-safe:duration-100 motion-safe:active:scale-[0.99]",
+      q(t, R),
       U,
-      w(
-        f(t, z),
-        F,
+      V(
+        f(t, T),
+        G,
         f(t, s.radius)
       ),
       L
@@ -89,9 +89,9 @@ const H = W(
         "aria-busy": a,
         onClick: x,
         className: C,
-        ...R,
+        ...K,
         children: [
-          a && /* @__PURE__ */ c(E, { className: l }),
+          a && /* @__PURE__ */ c(k, { className: l }),
           a && /* @__PURE__ */ c("span", { className: "sr-only", children: "Loading" }),
           a && d ? null : B
         ]