asheeui 0.6.2 → 0.6.3

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

@@ -1,64 +1,183 @@
 import { ReactNode } from 'react';
-import { Radius } from '../../shared/radius';
-import { Size } from '../../shared/size';
-import { Color, Variant } from '../../shared/variant';
+import { Color, Radius, Size, Variant } from '../../shared';
 import { TooltipPlacement } from '../tooltip/tooltip-config';
+/**
+ * Size key for the sidebar.
+ * Controls the width of the sidebar when expanded and collapsed.
+ */
 export type SidebarSizeKey = Size;
+/**
+ * Visual style variant of the sidebar.
+ * - `default`: Standard sidebar with border and background.
+ * - `bordered`: Sidebar with a thicker border.
+ * - `floating`: Sidebar with rounded corners and shadow (floating appearance).
+ * - `ghost`: Minimal sidebar with background only, no border.
+ */
 export type SidebarVariant = "default" | "bordered" | "floating" | "ghost";
+/**
+ * A single navigation item in the sidebar.
+ */
 export interface SidebarItem<T = string> {
-    /** Unique item identifier. */
+    /**
+     * Unique item identifier.
+     */
     id: T;
-    /** Display label or title. */
+    /**
+     * Display label or title.
+     */
     label: ReactNode;
-    /** URL or path for navigation. */
+    /**
+     * URL or path for navigation.
+     */
     href?: string;
-    /** Leading icon element. */
+    /**
+     * Leading icon element.
+     */
     icon?: ReactNode;
-    /** Optional trailing badge element or count. */
+    /**
+     * Optional trailing badge element or count.
+     */
     badge?: ReactNode;
-    /** Role string list for optional visibility filtering. */
+    /**
+     * Role string list for optional visibility filtering.
+     * When provided, the item is only shown to users with matching roles.
+     */
     roles?: string[];
-    /** Disables click interaction. */
+    /**
+     * Disables click interaction.
+     * @default false
+     */
     disabled?: boolean;
-    /** Target for link (e.g., "_blank"). */
+    /**
+     * Target for link (e.g., "_blank").
+     */
     target?: string;
-    /** Rel attribute for link. */
+    /**
+     * Rel attribute for link.
+     */
     rel?: string;
 }
+/**
+ * A section containing multiple sidebar items.
+ * Used to group related navigation items under a label.
+ */
 export interface SidebarSection<T = string> {
-    /** Unique section identifier. */
+    /**
+     * Unique section identifier.
+     */
     id: T;
-    /** Display label or title. */
+    /**
+     * Display label or title.
+     * Shown as a section header when the sidebar is expanded.
+     */
     label?: ReactNode;
-    /** Optional array of sidebar items within the section. */
+    /**
+     * Optional array of sidebar items within the section.
+     */
     items?: SidebarItem<T>[];
-    /** Role string list for optional visibility filtering. */
+    /**
+     * Role string list for optional visibility filtering.
+     * When provided, the section is only shown to users with matching roles.
+     */
     roles?: string[];
-    /** Disables click interaction for the entire section. */
+    /**
+     * Disables click interaction for the entire section.
+     * @default false
+     */
     disabled?: boolean;
 }
+/**
+ * Union type for sidebar content.
+ * Can be either a flat array of items or an array of sections.
+ */
 export type SidebarItems<T = string> = SidebarItem<T>[] | SidebarSection<T>[];
+/**
+ * Theme configuration options for the Sidebar component.
+ *
+ * Set under `components.sidebar` in the AsheeUI config. Values feed the
+ * component-level fallback tier of the theme cascade.
+ */
 export interface SidebarConfig {
+    /**
+     * Size scale of the sidebar.
+     * Controls the width of the sidebar when expanded and collapsed.
+     *
+     * @default "md"
+     */
     size?: SidebarSizeKey;
+    /**
+     * Visual style variant.
+     * Controls the sidebar's appearance including borders and background.
+     */
     variant?: SidebarVariant;
+    /**
+     * Corner rounding of the sidebar container.
+     */
     radius?: Radius;
+    /**
+     * Corner rounding of individual navigation items.
+     */
     itemRadius?: Radius;
+    /**
+     * Visual variant for inactive navigation items.
+     */
     itemVariant?: Variant;
+    /**
+     * Visual variant for the active navigation item.
+     */
+    activeItemVariant?: Variant;
+    /**
+     * Theme color for the active navigation item.
+     */
     activeItemColor?: Color;
-    backButtonVariant?: Variant;
-    backButtonColor?: Color;
-    collapseButtonVariant?: Variant;
-    collapseButtonColor?: Color;
+    /**
+     * Whether the collapse button is shown.
+     * @default true
+     */
     showCollapseButton?: boolean;
+    /**
+     * Whether tooltips are shown for collapsed items.
+     * @default true
+     */
     showTooltips?: boolean;
+    /**
+     * Placement of tooltips relative to the item.
+     * @default "right"
+     */
     tooltipPlacement?: TooltipPlacement;
+    /**
+     * Visual variant for tooltips.
+     */
     tooltipVariant?: Variant;
+    /**
+     * Theme color for tooltips.
+     */
     tooltipColor?: Color;
+    /**
+     * Whether the sidebar has animations.
+     * @default true
+     */
     animated?: boolean;
+    /**
+     * Initial collapsed state for uncontrolled usage.
+     * @default false
+     */
     defaultCollapsed?: boolean;
+    /**
+     * Whether the sidebar can be collapsed.
+     * @default true
+     */
     collapsible?: boolean;
 }
+/**
+ * Default config values registered for the Sidebar component.
+ */
 export declare const defaultSidebarConfig: SidebarConfig;
+/**
+ * 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_SIDEBAR_CONFIG: Required<SidebarConfig>;
 declare module "../../libs/registry" {
     interface ComponentTypeConfigRegistry {

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

@@ -1 +1 @@
-{"version":3,"file":"sidebar-config.d.ts","sourceRoot":"","sources":["../../../src/components/sidebar/sidebar-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,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAElE,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC;AAClC,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC;AAE3E,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,MAAM;IACrC,8BAA8B;IAC9B,EAAE,EAAE,CAAC,CAAC;IACN,8BAA8B;IAC9B,KAAK,EAAE,SAAS,CAAC;IACjB,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,gDAAgD;IAChD,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,MAAM;IACxC,iCAAiC;IACjC,EAAE,EAAE,CAAC,CAAC;IACN,8BAA8B;IAC9B,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;IACzB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAGD,MAAM,MAAM,YAAY,CAAC,CAAC,GAAG,MAAM,IAAI,WAAW,CAAC,CAAC,CAAC,EAAE,GAAG,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;AAG9E,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,eAAe,CAAC,EAAE,KAAK,CAAC;IAGxB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,eAAe,CAAC,EAAE,KAAK,CAAC;IAGxB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,mBAAmB,CAAC,EAAE,KAAK,CAAC;IAG5B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAG7B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,KAAK,CAAC;IAGrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IAGnB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAGD,eAAO,MAAM,oBAAoB,EAAE,aAQlC,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,aAAa,CAmBlD,CAAC;AAEX,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,2BAA2B;QACnC,OAAO,EAAE,aAAa,CAAC;KACxB;CACF"}
+{"version":3,"file":"sidebar-config.d.ts","sourceRoot":"","sources":["../../../src/components/sidebar/sidebar-config.ts"],"names":[],"mappings":"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"}

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

@@ -1,27 +1,24 @@
 "use client";
 import { registerComponentDefaults as t } from "../../libs/registry.js";
-const o = {
+const e = {
   size: "md",
   showTooltips: !0,
   tooltipPlacement: "right",
   animated: !0,
   defaultCollapsed: !1,
-  // Default to expanded
   collapsible: !0,
-  // Default to collapsible
-  showCollapseButton: !0
-  // Default to showing collapse button
+  showCollapseButton: !0,
+  itemVariant: "ghost",
+  activeItemVariant: "solid",
+  activeItemColor: "primary"
 }, a = {
   size: "md",
   variant: "default",
   radius: "none",
   itemRadius: "md",
-  itemVariant: "solid",
+  itemVariant: "ghost",
+  activeItemVariant: "solid",
   activeItemColor: "primary",
-  backButtonVariant: "ghost",
-  backButtonColor: "secondary",
-  collapseButtonVariant: "ghost",
-  collapseButtonColor: "secondary",
   showTooltips: !0,
   tooltipPlacement: "right",
   tooltipVariant: "solid",
@@ -31,8 +28,8 @@ const o = {
   collapsible: !0,
   showCollapseButton: !0
 };
-t("sidebar", o);
+t("sidebar", e);
 export {
   a as FALLBACK_SIDEBAR_CONFIG,
-  o as defaultSidebarConfig
+  e as defaultSidebarConfig
 };

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

@@ -1,8 +1,32 @@
 import { SidebarSizeKey, SidebarVariant } from './sidebar-config';
+/**
+ * CSS classes for sidebar width when expanded.
+ * Maps size keys to Tailwind width classes.
+ */
 export declare const SIDEBAR_EXPANDED_WIDTH_CLASS: Record<SidebarSizeKey, string>;
+/**
+ * CSS classes for sidebar width when collapsed.
+ * Maps size keys to Tailwind width classes.
+ */
 export declare const SIDEBAR_COLLAPSED_WIDTH_CLASS: Record<SidebarSizeKey, string>;
+/**
+ * CSS classes for sidebar header height and padding.
+ * Maps size keys to Tailwind height and padding classes.
+ */
 export declare const SIDEBAR_HEADER_CLASS: Record<SidebarSizeKey, string>;
+/**
+ * CSS classes for section label typography and spacing.
+ * Maps size keys to Tailwind text size and padding classes.
+ */
 export declare const SIDEBAR_SECTION_LABEL_CLASS: Record<SidebarSizeKey, string>;
+/**
+ * CSS classes for individual navigation items.
+ * Maps size keys to Tailwind height, text size, and padding classes.
+ */
 export declare const SIDEBAR_ITEM_CLASS: Record<SidebarSizeKey, string>;
+/**
+ * CSS classes for sidebar variants.
+ * Each variant has a distinct border, background, and shadow treatment.
+ */
 export declare const SIDEBAR_VARIANT_CLASS: Record<SidebarVariant, string>;
 //# sourceMappingURL=sidebar-styles.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"sidebar-styles.d.ts","sourceRoot":"","sources":["../../../src/components/sidebar/sidebar-styles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvE,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAIvE,CAAC;AAEF,eAAO,MAAM,6BAA6B,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAIxE,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAI/D,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAItE,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAI7D,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAMhE,CAAC"}
+{"version":3,"file":"sidebar-styles.d.ts","sourceRoot":"","sources":["../../../src/components/sidebar/sidebar-styles.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvE;;;GAGG;AACH,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAIvE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,6BAA6B,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAIxE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAI/D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAItE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAI7D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAMhE,CAAC"}

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

@@ -1,7 +1,4 @@
-import { Size } from '../../shared/size';
-import { Color } from '../../shared/variant';
-/** Pixel-size scale of the spinner. */
-export type SpinnerSizeKey = Size;
+import { Color, Size } from '../../shared';
 /**
  * Theme configuration options for the Spinner component.
  *
@@ -9,22 +6,29 @@ export type SpinnerSizeKey = Size;
  * the component-level fallback tier of the theme cascade.
  */
 export interface SpinnerConfig {
-    /** Pixel-size scale.
+    /**
+     * Pixel-size scale.
+     * Controls the dimensions of the spinner.
      *
      * @default "md"
      */
-    size?: SpinnerSizeKey;
-    /** Theme accent color.
+    size?: Size;
+    /**
+     * Theme accent color.
+     * Controls the color of the spinner.
      *
      * @default "primary"
      */
     color?: Color;
-    /** CSS `animation-duration` for one rotation.
+    /**
+     * CSS `animation-duration` for one rotation.
+     * Controls how fast the spinner rotates.
      *
      * @default "0.75s"
      */
     speed?: string;
-    /** Extra classes applied to every spinner instance.
+    /**
+     * Extra classes applied to every spinner instance.
      *
      * @default ""
      */
@@ -39,6 +43,8 @@ export interface SpinnerConfig {
 export declare const defaultSpinnerConfig: SpinnerConfig;
 /**
  * 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_SPINNER_CONFIG: Required<SpinnerConfig>;
 declare module "../../libs/registry" {

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

@@ -1 +1 @@
-{"version":3,"file":"spinner-config.d.ts","sourceRoot":"","sources":["../../../src/components/spinner/spinner-config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAElD,uCAAuC;AACvC,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC;AAElC;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB;;;OAGG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;IACd;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,EAAE,aAGlC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,aAAa,CAKlD,CAAC;AAEX,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,2BAA2B;QACnC,OAAO,EAAE,aAAa,CAAC;KACxB;CACF"}
+{"version":3,"file":"spinner-config.d.ts","sourceRoot":"","sources":["../../../src/components/spinner/spinner-config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC;IAEZ;;;;;OAKG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;IAEd;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,EAAE,aAGlC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,aAAa,CAKlD,CAAC;AAEX,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,2BAA2B;QACnC,OAAO,EAAE,aAAa,CAAC;KACxB;CACF"}

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

@@ -1,5 +1,12 @@
-import { Color } from '../../shared/variant';
-import { SpinnerSizeKey } from './spinner-config';
-export declare const SPINNER_SIZE_CLASS: Record<SpinnerSizeKey, string>;
+import { Color, Size } from '../../shared';
+/**
+ * CSS classes for spinner size.
+ * Maps size keys to Tailwind width and height classes.
+ */
+export declare const SPINNER_SIZE_CLASS: Record<Size, string>;
+/**
+ * CSS classes for spinner colors.
+ * Maps color keys to Tailwind text color classes.
+ */
 export declare const SPINNER_COLOR_CLASS: Record<Color, string>;
 //# sourceMappingURL=spinner-styles.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"spinner-styles.d.ts","sourceRoot":"","sources":["../../../src/components/spinner/spinner-styles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAI7D,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAOrD,CAAC"}
+{"version":3,"file":"spinner-styles.d.ts","sourceRoot":"","sources":["../../../src/components/spinner/spinner-styles.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAInD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAOrD,CAAC"}

package/dist/components/spinner/spinner.d.ts

@@ -1,27 +1,10 @@
 import { SVGAttributes } from 'react';
-import { Color } from '../../shared/variant';
-import { SpinnerSizeKey } from './spinner-config';
+import { SpinnerConfig } from './spinner-config';
 /**
  * Configuration options for the Spinner component.
  */
-export interface SpinnerProps extends SVGAttributes<SVGSVGElement> {
-    /** Pixel-size scale.
-     *
-     * @default "md"
-     */
-    size?: SpinnerSizeKey;
-    /** Theme accent color.
-     *
-     * @default "primary"
-     */
-    color?: Color;
-    /** CSS `animation-duration` for one rotation.
-     *
-     * @default "0.75s"
-     */
-    speed?: string;
-    /** Extra classes merged with internal styles. */
-    className?: string;
+type BaseSpinnerProps = SpinnerConfig & Omit<SVGAttributes<SVGSVGElement>, "color" | "className">;
+export interface SpinnerProps extends BaseSpinnerProps {
 }
 /**
  * An animated SVG loading indicator.
@@ -32,11 +15,16 @@ export interface SpinnerProps extends SVGAttributes<SVGSVGElement> {
  * technology (`aria-hidden`); pair it with a visually hidden label or
  * text for meaningful loading feedback.
  *
+ * The spinner uses a standard circular progress indicator design with
+ * a semi-transparent track and a solid arc that rotates. The rotation
+ * is powered by CSS animation with configurable duration.
+ *
  * @param props - Spinner configuration options and SVG attributes.
  * @param props.size - Pixel-size scale. Defaults to "md".
  * @param props.color - Theme accent color. Defaults to "primary".
  * @param props.speed - Rotation duration. Defaults to "0.75s".
  * @param props.className - Extra classes for the SVG element.
+ * @param props.style - Inline styles for the SVG element.
  *
  * @example
  * ```tsx
@@ -46,6 +34,25 @@ export interface SpinnerProps extends SVGAttributes<SVGSVGElement> {
  *   return <Spinner size="lg" color="primary" />;
  * }
  * ```
+ *
+ * @example
+ * ```tsx
+ * // Custom speed and color
+ * <Spinner size="sm" color="success" speed="1.2s" />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // With loading text for accessibility
+ * <div role="status">
+ *   <Spinner />
+ *   <span className="sr-only">Loading...</span>
+ * </div>
+ * ```
+ *
+ * @see SpinnerConfig - The configuration type for component defaults.
+ * @see useAsheeConfig - Hook for accessing the global configuration.
  */
 export declare const Spinner: import('react').ForwardRefExoticComponent<SpinnerProps & import('react').RefAttributes<SVGSVGElement>>;
+export {};
 //# sourceMappingURL=spinner.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"spinner.d.ts","sourceRoot":"","sources":["../../../src/components/spinner/spinner.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAc,KAAK,aAAa,EAAE,MAAM,OAAO,CAAC;AAEvD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAGlD,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,kBAAkB,CAAC;AAG1B;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,aAAa,CAAC,aAAa,CAAC;IAChE;;;OAGG;IACH,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB;;;OAGG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;IACd;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,OAAO,wGA8EnB,CAAC"}
+{"version":3,"file":"spinner.d.ts","sourceRoot":"","sources":["../../../src/components/spinner/spinner.tsx"],"names":[],"mappings":"AAUA,OAAO,EAAc,KAAK,aAAa,EAAE,MAAM,OAAO,CAAC;AAKvD,OAAO,EAA2B,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAG/E;;GAEG;AACH,KAAK,gBAAgB,GAAG,aAAa,GACnC,IAAI,CAAC,aAAa,CAAC,aAAa,CAAC,EAAE,OAAO,GAAG,WAAW,CAAC,CAAC;AAE5D,MAAM,WAAW,YAAa,SAAQ,gBAAgB;CAAG;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,eAAO,MAAM,OAAO,wGA4EnB,CAAC"}

package/dist/components/spinner/spinner.js

@@ -1,48 +1,48 @@
 "use client";
-import { jsxs as h, jsx as a } from "react/jsx-runtime";
-import { forwardRef as y } from "react";
+import { jsxs as f, jsx as a } from "react/jsx-runtime";
+import { forwardRef as h } from "react";
 import { useAsheeConfig as z } from "../../libs/context.js";
 import { resolveCascade as o, resolveClassKey as t } from "../../utils/resolve-token.js";
-import { FALLBACK_SPINNER_CONFIG as e } from "./spinner-config.js";
+import { FALLBACK_SPINNER_CONFIG as r } from "./spinner-config.js";
 import { SPINNER_SIZE_CLASS as _, SPINNER_COLOR_CLASS as x } from "./spinner-styles.js";
 import { cn as A } from "../../utils/cn.js";
-const I = y(
+const I = h(
   ({ size: c, color: i, speed: m, className: p, style: n, ...d }, N) => {
     var l;
-    const s = z(), r = (l = s.components) == null ? void 0 : l.spinner, S = o(
+    const s = z(), e = (l = s.components) == null ? void 0 : l.spinner, S = o(
       c,
-      r == null ? void 0 : r.size,
+      e == null ? void 0 : e.size,
       void 0,
-      e.size
+      r.size
     ), v = o(
       i,
-      r == null ? void 0 : r.color,
+      e == null ? void 0 : e.color,
       s.defaultColor,
-      e.color
+      r.color
     ), u = o(
       m,
-      r == null ? void 0 : r.speed,
+      e == null ? void 0 : e.speed,
       void 0,
-      e.speed
-    ), C = t(
+      r.speed
+    ), y = t(
       S,
       _,
-      e.size
-    ), f = t(
+      r.size
+    ), C = t(
       v,
       x,
-      e.color
+      r.color
     );
-    return /* @__PURE__ */ h(
+    return /* @__PURE__ */ f(
       "svg",
       {
         ref: N,
         "aria-hidden": "true",
         className: A(
           "animate-spin shrink-0",
+          y,
           C,
-          f,
-          r == null ? void 0 : r.className,
+          e == null ? void 0 : e.className,
           p
         ),
         style: {

package/dist/components/switch/Switch.d.ts

@@ -1,21 +1,121 @@
 import { ChangeEvent, InputHTMLAttributes } from 'react';
-import { Radius } from '../../shared/radius';
-import { Color } from '../../shared/variant';
-import { FieldSizeKey, FieldStatus, LabelAlign } from '../field/field-config';
-export interface SwitchProps extends Omit<InputHTMLAttributes<HTMLInputElement>, "size" | "onChange" | "children" | "color"> {
-    size?: FieldSizeKey;
-    color?: Color;
-    radius?: Radius;
-    status?: FieldStatus;
+import { SwitchConfig } from './switch-config';
+type BaseSwitchProps = SwitchConfig & Omit<InputHTMLAttributes<HTMLInputElement>, "size" | "onChange" | "children" | "color">;
+/**
+ * Configuration options for the Switch component.
+ */
+export interface SwitchProps extends BaseSwitchProps {
+    /**
+     * Label text for the switch.
+     * Displayed next to the toggle.
+     */
     label?: string;
-    labelAlign?: LabelAlign;
+    /**
+     * Description text shown below the label.
+     * Provides additional context for the switch.
+     */
     description?: string;
+    /**
+     * Validation message shown below the switch.
+     * 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;
+    /**
+     * Whether the switch is in a loading state.
+     * Disables interaction and shows loading indication.
+     *
+     * @default false
+     */
     isLoading?: boolean;
+    /**
+     * Controlled checked state.
+     * When provided, the component becomes controlled.
+     */
     checked?: boolean;
+    /**
+     * Uncontrolled initial checked state.
+     * @default false
+     */
     defaultChecked?: boolean;
+    /**
+     * Callback fired when the switch state changes.
+     * Receives the new checked state and the change event.
+     */
     onChange?: (checked: boolean, event: ChangeEvent<HTMLInputElement>) => void;
 }
+/**
+ * A toggle switch with label, description, and validation support.
+ *
+ * Switch renders a toggle input that can be checked or unchecked. It
+ * supports controlled and uncontrolled usage, validation states, 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
+ * role="switch", aria-checked, aria-invalid, and aria-busy for loading
+ * states. It also supports proper focus management through the native
+ * input element.
+ *
+ * @param props - Switch configuration options.
+ * @param props.label - Label text for the switch.
+ * @param props.description - Description text.
+ * @param props.message - Validation message.
+ * @param props.required - Whether the field is required. Defaults to false.
+ * @param props.isLoading - Loading state. Defaults to false.
+ * @param props.checked - Controlled checked state.
+ * @param props.defaultChecked - Uncontrolled initial checked state. Defaults to false.
+ * @param props.onChange - Callback fired when the switch state changes.
+ * @param props.size - Size scale. Defaults to "md".
+ * @param props.color - Theme accent color. Defaults to "primary".
+ * @param props.radius - Corner rounding. Defaults to "full".
+ * @param props.status - Validation status. Defaults to "default".
+ * @param props.labelAlign - Alignment of the label. Defaults to "left".
+ * @param props.disabled - Whether the switch is disabled.
+ * @param props.className - Extra CSS classes for the switch.
+ * @param props.id - Optional ID for the switch.
+ *
+ * @example
+ * ```tsx
+ * import { Switch } from "asheeui";
+ * import { useState } from "react";
+ *
+ * export function Example() {
+ *   const [checked, setChecked] = useState(false);
+ *
+ *   return (
+ *     <Switch
+ *       label="Enable notifications"
+ *       description="Receive email notifications for updates"
+ *       checked={checked}
+ *       onChange={(checked) => setChecked(checked)}
+ *     />
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // With validation
+ * <Switch
+ *   label="Terms accepted"
+ *   status="error"
+ *   message="You must accept the terms to continue"
+ *   required
+ * />
+ * ```
+ *
+ * @see SwitchConfig - 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 Switch: import('react').ForwardRefExoticComponent<SwitchProps & import('react').RefAttributes<HTMLInputElement>>;
+export {};
 //# sourceMappingURL=Switch.d.ts.map