asheeui 0.6.2 → 0.6.3

package/dist/components/date-picker/date-picker-config.d.ts

@@ -1,10 +1,41 @@
 import { FieldConfig, FieldSizeKey } from '../field/field-config';
+/**
+ * The selection mode of the date picker.
+ * - `date`: Select only a date.
+ * - `time`: Select only a time.
+ * - `datetime`: Select both date and time.
+ */
 export type PickerMode = "date" | "time" | "datetime";
+/**
+ * Size key for the date picker.
+ * Maps to the FieldSizeKey type: "sm", "md", or "lg".
+ */
 export type DatePickerSizeKey = FieldSizeKey;
+/**
+ * Theme configuration options for the DatePicker component.
+ *
+ * Set under `components.datePicker` in the AsheeUI config. Values feed the
+ * component-level fallback tier of the theme cascade.
+ */
 export interface DatePickerConfig extends FieldConfig {
+    /**
+     * The selection mode of the picker.
+     * Controls whether the picker shows date, time, or both.
+     *
+     * @default "date"
+     */
     mode?: PickerMode;
 }
+/**
+ * Default config values registered for the DatePicker component.
+ * Inherits field label defaults and sets the default mode to "date".
+ */
 export declare const defaultDatePickerConfig: DatePickerConfig;
+/**
+ * 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_DATE_PICKER_CONFIG: Required<DatePickerConfig>;
 declare module "../../libs/registry" {
     interface ComponentTypeConfigRegistry {

package/dist/components/date-picker/date-picker-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"date-picker-config.d.ts","sourceRoot":"","sources":["../../../src/components/date-picker/date-picker-config.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,YAAY,EAClB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC;AACtD,MAAM,MAAM,iBAAiB,GAAG,YAAY,CAAC;AAE7C,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAED,eAAO,MAAM,uBAAuB,EAAE,gBAKrC,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,QAAQ,CAAC,gBAAgB,CASzD,CAAC;AAEX,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,2BAA2B;QACnC,UAAU,EAAE,gBAAgB,CAAC;KAC9B;CACF"}
+{"version":3,"file":"date-picker-config.d.ts","sourceRoot":"","sources":["../../../src/components/date-picker/date-picker-config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,YAAY,EAClB,MAAM,uBAAuB,CAAC;AAE/B;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC;AAEtD;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,YAAY,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD;;;;;OAKG;IACH,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAED;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,gBAGrC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,EAAE,QAAQ,CAAC,gBAAgB,CAGzD,CAAC;AAEX,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,2BAA2B;QACnC,UAAU,EAAE,gBAAgB,CAAC;KAC9B;CACF"}

package/dist/components/date-picker/date-picker-config.js

@@ -1,23 +1,15 @@
 "use client";
 import { registerComponentDefaults as e } from "../../libs/registry.js";
-import { FALLBACK_FIELD_CONFIG as t } from "../field/field-config.js";
-const r = {
-  size: "md",
-  labelAlign: "left",
-  mode: "date",
-  variant: "bordered"
-}, d = {
+import { FALLBACK_FIELD_CONFIG as t, defaultFieldConfig as o } from "../field/field-config.js";
+const i = {
+  ...o,
+  mode: "date"
+}, C = {
   ...t,
-  size: "md",
-  radius: "md",
-  variant: "bordered",
-  color: "primary",
-  status: "default",
-  labelAlign: "left",
   mode: "date"
 };
-e("datePicker", r);
+e("datePicker", i);
 export {
-  d as FALLBACK_DATE_PICKER_CONFIG,
-  r as defaultDatePickerConfig
+  C as FALLBACK_DATE_PICKER_CONFIG,
+  i as defaultDatePickerConfig
 };

package/dist/components/date-picker/date-picker-styles.d.ts

@@ -1,8 +1,28 @@
-import { Color } from '../../shared/variant';
+import { Color } from '../../shared';
 import { FieldSizeKey, FieldStatus } from '../field/field-config';
+/**
+ * CSS classes for date picker trigger size.
+ * Maps size keys to Tailwind classes that control the trigger's
+ * height, padding, and font size.
+ */
 export declare const DATE_PICKER_SIZE_CLASS: Record<FieldSizeKey, string>;
+/**
+ * CSS classes for date picker calendar cell size.
+ * Maps size keys to Tailwind classes that control individual
+ * day cells in the calendar grid.
+ */
 export declare const DATE_PICKER_CELL_SIZE_CLASS: Record<FieldSizeKey, string>;
+/**
+ * CSS classes for date picker status border styles.
+ * Maps status values to Tailwind classes for border and
+ * focus ring colors.
+ */
 export declare const DATE_PICKER_STATUS_BORDER_CLASS: Record<FieldStatus, string>;
+/**
+ * CSS classes for calendar color variations.
+ * Maps color names to the corresponding background, text,
+ * border, and hover styles for calendar elements.
+ */
 export declare const CALENDAR_COLOR_CLASSES: Record<Color | string, {
     bg: string;
     text: string;

package/dist/components/date-picker/date-picker-styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"date-picker-styles.d.ts","sourceRoot":"","sources":["../../../src/components/date-picker/date-picker-styles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEvE,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAI/D,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAIpE,CAAC;AAEF,eAAO,MAAM,+BAA+B,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAQvE,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,MAAM,CACzC,KAAK,GAAG,MAAM,EACd;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAsC5D,CAAC"}
+{"version":3,"file":"date-picker-styles.d.ts","sourceRoot":"","sources":["../../../src/components/date-picker/date-picker-styles.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGvE;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAI/D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAIpE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,+BAA+B,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAC7C,CAAC;AAE5B;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CACzC,KAAK,GAAG,MAAM,EACd;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAsC5D,CAAC"}

package/dist/components/date-picker/date-picker-styles.js

@@ -1,18 +1,14 @@
 "use client";
-const r = {
+import { FIELD_STATUS_BORDER_CLASS as r } from "../field/field-styles.js";
+const t = {
   sm: "h-8 px-2.5 text-xs",
   md: "h-10 px-3 text-sm",
   lg: "h-12 px-4 text-base"
-}, e = {
+}, o = {
   sm: "size-7 text-xs",
   md: "size-8 text-xs",
   lg: "size-9 text-sm"
-}, o = {
-  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"
-}, s = {
+}, g = r, s = {
   default: {
     bg: "bg-foreground text-background",
     text: "text-foreground",
@@ -52,7 +48,7 @@ const r = {
 };
 export {
   s as CALENDAR_COLOR_CLASSES,
-  e as DATE_PICKER_CELL_SIZE_CLASS,
-  r as DATE_PICKER_SIZE_CLASS,
-  o as DATE_PICKER_STATUS_BORDER_CLASS
+  o as DATE_PICKER_CELL_SIZE_CLASS,
+  t as DATE_PICKER_SIZE_CLASS,
+  g as DATE_PICKER_STATUS_BORDER_CLASS
 };

package/dist/components/drawer/Drawer.d.ts

@@ -1,16 +1,106 @@
 import { HTMLAttributes, ReactNode } from 'react';
-import { DrawerPlacement, DrawerSize } from './drawer-config';
-export interface DrawerProps extends HTMLAttributes<HTMLDivElement> {
+import { DrawerConfig } from './drawer-config';
+type BaseDrawerProps = DrawerConfig & HTMLAttributes<HTMLDivElement>;
+/**
+ * Configuration options for the Drawer component.
+ */
+export interface DrawerProps extends BaseDrawerProps {
+    /**
+     * Whether the drawer is open.
+     * Controls the visibility of the drawer.
+     */
     isOpen: boolean;
+    /**
+     * Callback fired when the drawer should close.
+     * Called when the overlay is clicked, Escape is pressed, or the close button is triggered.
+     */
     onClose?: () => void;
-    placement?: DrawerPlacement;
-    size?: DrawerSize;
-    animated?: boolean;
-    closeOnOverlayClick?: boolean;
-    closeOnEsc?: boolean;
+    /**
+     * Extra classes applied to the overlay.
+     */
     overlayClassName?: string;
+    /**
+     * Extra classes applied to the drawer content.
+     */
     contentClassName?: string;
+    /**
+     * The content to display inside the drawer.
+     */
     children: ReactNode;
 }
+/**
+ * A sliding panel that appears from the edge of the screen.
+ *
+ * Drawer displays content in a panel that slides in from the right, left,
+ * top, or bottom edge. It supports overlay click and Escape key dismissal,
+ * animation controls, and sizing options. 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
+ * role="dialog", aria-modal, and proper focus management. It manages
+ * its own animation states to prevent transition flashes.
+ *
+ * @param props - Drawer configuration options and HTML div props.
+ * @param props.isOpen - Whether the drawer is open.
+ * @param props.onClose - Callback fired when the drawer should close.
+ * @param props.placement - The placement of the drawer. Defaults to "right".
+ * @param props.size - The size of the drawer. Defaults to "md".
+ * @param props.animated - Whether the drawer has slide animations. Defaults to true.
+ * @param props.closeOnOverlayClick - Whether clicking the overlay closes the drawer. Defaults to true.
+ * @param props.closeOnEsc - Whether pressing Escape closes the drawer. Defaults to true.
+ * @param props.overlayClassName - Extra classes for the overlay.
+ * @param props.contentClassName - Extra classes for the drawer content.
+ * @param props.children - The content to display inside the drawer.
+ * @param props.className - Extra classes for the container.
+ *
+ * @example
+ * ```tsx
+ * import { Drawer, Button } from "asheeui";
+ * import { useState } from "react";
+ *
+ * export function Example() {
+ *   const [isOpen, setIsOpen] = useState(false);
+ *
+ *   return (
+ *     <>
+ *       <Button onClick={() => setIsOpen(true)}>Open Drawer</Button>
+ *       <Drawer
+ *         isOpen={isOpen}
+ *         onClose={() => setIsOpen(false)}
+ *         placement="right"
+ *         size="md"
+ *       >
+ *         <div className="p-6">
+ *           <h2 className="text-xl font-bold">Drawer Content</h2>
+ *           <p>This is the drawer content.</p>
+ *           <Button onClick={() => setIsOpen(false)}>Close</Button>
+ *         </div>
+ *       </Drawer>
+ *     </>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Bottom drawer with custom sizing
+ * <Drawer
+ *   isOpen={isOpen}
+ *   onClose={onClose}
+ *   placement="bottom"
+ *   size="full"
+ *   overlayClassName="bg-black/50"
+ * >
+ *   <div className="p-6 max-h-[80vh] overflow-y-auto">
+ *     {content}
+ *   </div>
+ * </Drawer>
+ * ```
+ *
+ * @see DrawerConfig - The configuration type for component defaults.
+ * @see useAsheeConfig - Hook for accessing the global configuration.
+ */
 export declare const Drawer: import('react').ForwardRefExoticComponent<DrawerProps & import('react').RefAttributes<HTMLDivElement>>;
+export {};
 //# sourceMappingURL=Drawer.d.ts.map

package/dist/components/drawer/Drawer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Drawer.d.ts","sourceRoot":"","sources":["../../../src/components/drawer/Drawer.tsx"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,SAAS,EAIf,MAAM,OAAO,CAAC;AAIf,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,UAAU,EAEhB,MAAM,iBAAiB,CAAC;AASzB,MAAM,WAAW,WAAY,SAAQ,cAAc,CAAC,cAAc,CAAC;IACjE,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,eAAO,MAAM,MAAM,wGAwLlB,CAAC"}
+{"version":3,"file":"Drawer.d.ts","sourceRoot":"","sources":["../../../src/components/drawer/Drawer.tsx"],"names":[],"mappings":"AASA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,SAAS,EAIf,MAAM,OAAO,CAAC;AAIf,OAAO,EACL,KAAK,YAAY,EAIlB,MAAM,iBAAiB,CAAC;AASzB,KAAK,eAAe,GAAG,YAAY,GAAG,cAAc,CAAC,cAAc,CAAC,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,WAAY,SAAQ,eAAe;IAClD;;;OAGG;IACH,MAAM,EAAE,OAAO,CAAC;IAEhB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IAErB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwEG;AACH,eAAO,MAAM,MAAM,wGAwLlB,CAAC"}

package/dist/components/drawer/Drawer.js

@@ -4,14 +4,14 @@ import { forwardRef as q, useState as V, useEffect as C, useCallback as J } from
 import { useAsheeConfig as Q } from "../../libs/context.js";
 import { resolveCascade as a, resolveClassKey as R } from "../../utils/resolve-token.js";
 import { FALLBACK_DRAWER_CONFIG as t } from "./drawer-config.js";
-import { DRAWER_WIDTH_CLASS as U, DRAWER_HEIGHT_CLASS as X, DRAWER_ANIMATION_STATE as Y, DRAWER_BORDER_PLACEMENT_CLASS as b, DRAWER_CONTAINER_PLACEMENT_CLASS as h } from "./drawer-styles.js";
+import { DRAWER_WIDTH_CLASS as U, DRAWER_HEIGHT_CLASS as X, DRAWER_ANIMATION_STATE as Y, DRAWER_BORDER_PLACEMENT_CLASS as b, DRAWER_CONTAINER_PLACEMENT_CLASS as y } from "./drawer-styles.js";
 import { cn as d } from "../../utils/cn.js";
 const Z = q(
   ({
     isOpen: c,
     onClose: r,
-    placement: y,
-    size: N,
+    placement: N,
+    size: h,
     animated: O,
     closeOnOverlayClick: S,
     closeOnEsc: _,
@@ -40,12 +40,12 @@ const Z = q(
       }
     }, [c]);
     const m = a(
-      N,
+      h,
       e == null ? void 0 : e.size,
       void 0,
       t.size
     ), n = a(
-      y,
+      N,
       e == null ? void 0 : e.placement,
       void 0,
       t.placement
@@ -64,15 +64,15 @@ const Z = q(
       e == null ? void 0 : e.animated,
       void 0,
       t.animated
-    ), g = k ?? "bg-black/70 backdrop-blur-md", F = D ?? "bg-secondary", v = n === "left" || n === "right", H = v ? R(
+    ), g = k ?? "bg-black/70 backdrop-blur-md", F = D ?? "bg-secondary", A = n === "left" || n === "right", H = A ? R(
       m,
       U,
       t.size
-    ) : "w-full", K = v ? "h-full" : R(
+    ) : "w-full", K = A ? "h-full" : R(
       m,
       X,
       t.size
-    ), P = h[n] ?? h.right, M = b[n] ?? b.right, A = Y[n], E = o === "open" || o === "opening", j = p ? E ? A.open : A.closed : "", B = p ? E ? "drawer-backdrop-in" : "drawer-backdrop-out" : "", i = J(
+    ), P = y[n] ?? y.right, M = b[n] ?? b.right, E = Y[n], v = o === "open" || o === "opening", j = p ? v ? E.open : E.closed : "", B = p ? v ? "drawer-backdrop-in" : "drawer-backdrop-out" : "", i = J(
       (s) => {
         u && s.key === "Escape" && r && r();
       },
@@ -111,7 +111,7 @@ const Z = q(
             {
               style: x,
               className: d(
-                "relative z-10 flex flex-col text-foreground shadow-2xl border-border overflow-hidden",
+                "relative z-10 flex flex-col text-foreground shadow-2xl border-border",
                 M,
                 H,
                 K,

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

@@ -1,14 +1,67 @@
-import { Size } from '../../shared/size';
+import { Size } from '../../shared';
+/**
+ * The placement of the drawer on the screen.
+ * - `right`: Slides in from the right edge.
+ * - `left`: Slides in from the left edge.
+ * - `top`: Slides in from the top edge.
+ * - `bottom`: Slides in from the bottom edge.
+ */
 export type DrawerPlacement = "right" | "left" | "top" | "bottom";
+/**
+ * The size of the drawer.
+ * Can be "sm", "md", "lg", or "full" for full screen.
+ */
 export type DrawerSize = Size | "full";
+/**
+ * Theme configuration options for the Drawer component.
+ *
+ * Set under `components.drawer` in the AsheeUI config. Values feed the
+ * component-level fallback tier of the theme cascade.
+ */
 export interface DrawerConfig {
+    /**
+     * The size of the drawer.
+     * Controls the width for left/right drawers and height for top/bottom drawers.
+     *
+     * @default "md"
+     */
     size?: DrawerSize;
+    /**
+     * The placement of the drawer.
+     * Determines which edge the drawer slides in from.
+     *
+     * @default "right"
+     */
     placement?: DrawerPlacement;
+    /**
+     * Whether the drawer has slide animations.
+     * When false, the drawer appears and disappears instantly.
+     *
+     * @default true
+     */
     animated?: boolean;
+    /**
+     * Whether clicking on the overlay closes the drawer.
+     *
+     * @default true
+     */
     closeOnOverlayClick?: boolean;
+    /**
+     * Whether pressing the Escape key closes the drawer.
+     *
+     * @default true
+     */
     closeOnEsc?: boolean;
 }
+/**
+ * Default config values registered for the Drawer component.
+ */
 export declare const defaultDrawerConfig: DrawerConfig;
+/**
+ * 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_DRAWER_CONFIG: Required<DrawerConfig>;
 declare module "../../libs/registry" {
     interface ComponentTypeConfigRegistry {

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

@@ -1 +1 @@
-{"version":3,"file":"drawer-config.d.ts","sourceRoot":"","sources":["../../../src/components/drawer/drawer-config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAE9C,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;AAClE,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,MAAM,CAAC;AAEvC,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,eAAO,MAAM,mBAAmB,EAAE,YAMjC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAAC,YAAY,CAMhD,CAAC;AAEX,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,2BAA2B;QACnC,MAAM,EAAE,YAAY,CAAC;KACtB;CACF"}
+{"version":3,"file":"drawer-config.d.ts","sourceRoot":"","sources":["../../../src/components/drawer/drawer-config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEzC;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;AAElE;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,MAAM,CAAC;AAEvC;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;OAKG;IACH,IAAI,CAAC,EAAE,UAAU,CAAC;IAElB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,eAAe,CAAC;IAE5B;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,YAMjC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAAC,YAAY,CAMhD,CAAC;AAEX,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,2BAA2B;QACnC,MAAM,EAAE,YAAY,CAAC;KACtB;CACF"}

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

@@ -1,8 +1,29 @@
 import { DrawerPlacement, DrawerSize } from './drawer-config';
+/**
+ * CSS classes for drawer width based on size.
+ * Used for left and right placed drawers.
+ */
 export declare const DRAWER_WIDTH_CLASS: Record<DrawerSize, string>;
+/**
+ * CSS classes for drawer height based on size.
+ * Used for top and bottom placed drawers.
+ */
 export declare const DRAWER_HEIGHT_CLASS: Record<DrawerSize, string>;
+/**
+ * CSS classes for drawer container positioning.
+ * Controls the flex alignment of the container based on placement.
+ */
 export declare const DRAWER_CONTAINER_PLACEMENT_CLASS: Record<DrawerPlacement, string>;
+/**
+ * CSS classes for drawer border placement.
+ * Adds a border on the side where the drawer opens from.
+ */
 export declare const DRAWER_BORDER_PLACEMENT_CLASS: Record<DrawerPlacement, string>;
+/**
+ * CSS classes for drawer slide animations.
+ * Each placement has its own open and closed animation states.
+ * These classes should be defined in your global CSS with keyframe animations.
+ */
 export declare const DRAWER_ANIMATION_STATE: Record<DrawerPlacement, {
     closed: string;
     open: string;

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

@@ -1 +1 @@
-{"version":3,"file":"drawer-styles.d.ts","sourceRoot":"","sources":["../../../src/components/drawer/drawer-styles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAEnE,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAKzD,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAK1D,CAAC;AAEF,eAAO,MAAM,gCAAgC,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAM1E,CAAC;AAEJ,eAAO,MAAM,6BAA6B,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAKzE,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,MAAM,CACzC,eAAe,EACf;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAkBjC,CAAC"}
+{"version":3,"file":"drawer-styles.d.ts","sourceRoot":"","sources":["../../../src/components/drawer/drawer-styles.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAEnE;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAKzD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAK1D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gCAAgC,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAM1E,CAAC;AAEJ;;;GAGG;AACH,eAAO,MAAM,6BAA6B,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAKzE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CACzC,eAAe,EACf;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAkBjC,CAAC"}

package/dist/components/field/FieldShell.d.ts

@@ -1,17 +1,103 @@
 import { ReactNode } from 'react';
 import { FieldStatus, LabelAlign } from './field-config';
+/**
+ * Props for the FieldShell component.
+ * Provides a consistent wrapper for form field components.
+ */
 export interface FieldShellProps {
+    /**
+     * The ID of the field.
+     * Used to associate the label with the input via htmlFor.
+     */
     id: string;
+    /**
+     * The label text for the field.
+     */
     label?: string;
+    /**
+     * Alignment of the label relative to the field.
+     * @default "left"
+     */
     labelAlign?: LabelAlign;
+    /**
+     * Description text shown below the label.
+     */
     description?: string;
+    /**
+     * Optional ID for the description element.
+     * Used for accessibility to associate with the field.
+     */
     descriptionId?: string;
+    /**
+     * Validation message shown below the field.
+     */
     message?: string;
+    /**
+     * Optional ID for the message element.
+     * Used for accessibility to associate with the field.
+     */
     messageId?: string;
+    /**
+     * Validation status of the field.
+     * Controls the color of the message text.
+     * @default "default"
+     */
     status?: FieldStatus;
+    /**
+     * Whether the field is required.
+     * Adds a required indicator (*) to the label.
+     * @default false
+     */
     required?: boolean;
+    /**
+     * Whether the field is in a loading state.
+     * Shows a loading spinner next to the label.
+     * @default false
+     */
     isLoading?: boolean;
+    /**
+     * The field content to render.
+     * Typically an input, select, or other form control.
+     */
     children: ReactNode;
 }
+/**
+ * A wrapper component for form fields that provides consistent
+ * label, description, status message, and loading state handling.
+ *
+ * FieldShell is used internally by AsheeUI form components to ensure
+ * a uniform layout and behavior across the library. It automatically
+ * handles accessibility associations between labels, descriptions,
+ * status messages, and the field element.
+ *
+ * @param props - FieldShell configuration options.
+ * @param props.id - The ID of the field.
+ * @param props.label - The label text for the field.
+ * @param props.labelAlign - Alignment of the label. Defaults to "left".
+ * @param props.description - Description text shown below the label.
+ * @param props.descriptionId - Optional ID for the description element.
+ * @param props.message - Validation message shown below the field.
+ * @param props.messageId - Optional ID for the message element.
+ * @param props.status - Validation status. Defaults to "default".
+ * @param props.required - Whether the field is required. Defaults to false.
+ * @param props.isLoading - Whether the field is in a loading state. Defaults to false.
+ * @param props.children - The field content to render.
+ *
+ * @example
+ * ```tsx
+ * <FieldShell
+ *   id="email"
+ *   label="Email Address"
+ *   description="We'll never share your email."
+ *   message="Please enter a valid email"
+ *   status="error"
+ *   required
+ * >
+ *   <input id="email" type="email" />
+ * </FieldShell>
+ * ```
+ *
+ * @see FieldConfig - The configuration type for field components.
+ */
 export declare function FieldShell({ id, label, labelAlign, description, descriptionId, message, messageId, status, required, isLoading, children, }: FieldShellProps): import("react").JSX.Element;
 //# sourceMappingURL=FieldShell.d.ts.map

package/dist/components/field/FieldShell.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FieldShell.d.ts","sourceRoot":"","sources":["../../../src/components/field/FieldShell.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAc9D,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,wBAAgB,UAAU,CAAC,EACzB,EAAE,EACF,KAAK,EACL,UAAmB,EACnB,WAAW,EACX,aAAa,EACb,OAAO,EACP,SAAS,EACT,MAAkB,EAClB,QAAQ,EACR,SAAS,EACT,QAAQ,GACT,EAAE,eAAe,+BAqCjB"}
+{"version":3,"file":"FieldShell.d.ts","sourceRoot":"","sources":["../../../src/components/field/FieldShell.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAuB9D;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IAExB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IAErB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,UAAU,CAAC,EACzB,EAAE,EACF,KAAK,EACL,UAAmB,EACnB,WAAW,EACX,aAAa,EACb,OAAO,EACP,SAAS,EACT,MAAkB,EAClB,QAAQ,EACR,SAAS,EACT,QAAQ,GACT,EAAE,eAAe,+BAqCjB"}

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

@@ -1,19 +1,82 @@
-import { Radius } from '../../shared/radius';
-import { Size } from '../../shared/size';
-import { Color, Variant } from '../../shared/variant';
+import { Color, Radius, Size, Variant } from '../../shared';
+/**
+ * Size key for field components.
+ * Maps to the standard Size type: "sm", "md", or "lg".
+ */
 export type FieldSizeKey = Size;
+/**
+ * Validation status of a field.
+ * Controls visual feedback for different states.
+ */
 export type FieldStatus = "default" | "error" | "warning" | "success";
+/**
+ * Alignment of the label relative to the field.
+ * Controls text alignment of the label element.
+ */
 export type LabelAlign = "left" | "center" | "right";
+/**
+ * Theme configuration options shared by form field components.
+ *
+ * Set under `components.field` in the AsheeUI config. Values feed the
+ * component-level fallback tier of the theme cascade. Individual
+ * components may extend this interface with their own properties.
+ */
 export interface FieldConfig {
+    /**
+     * Size of the field.
+     * Controls the height, padding, and font size.
+     *
+     * @default "md"
+     */
     size?: FieldSizeKey;
+    /**
+     * Corner rounding of the field.
+     *
+     * @default "md"
+     */
     radius?: Radius;
+    /**
+     * Visual style variant of the field.
+     *
+     * @default "bordered"
+     */
     variant?: Variant;
+    /**
+     * Theme accent color of the field.
+     *
+     * @default "primary"
+     */
     color?: Color;
+    /**
+     * Alignment of the label relative to the field.
+     *
+     * @default "left"
+     */
     labelAlign?: LabelAlign;
+    /**
+     * Whether the field should stretch to fill its parent width.
+     *
+     * @default false
+     */
     fullWidth?: boolean;
+    /**
+     * Validation status of the field.
+     * Controls border color and message styling.
+     *
+     * @default "default"
+     */
     status?: FieldStatus;
 }
+/**
+ * Default config values registered for field components.
+ * These values are used as the base defaults for all field components.
+ */
 export declare const defaultFieldConfig: FieldConfig;
+/**
+ * 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_FIELD_CONFIG: Required<FieldConfig>;
 declare module "../../libs/registry" {
     interface ComponentTypeConfigRegistry {

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

@@ -1 +1 @@
-{"version":3,"file":"field-config.d.ts","sourceRoot":"","sources":["../../../src/components/field/field-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;AAE3D,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC;AAChC,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;AACtE,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAErD,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,eAAO,MAAM,kBAAkB,EAAE,WAIhC,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,WAAW,CAQ9C,CAAC;AAEX,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,2BAA2B;QACnC,KAAK,EAAE,WAAW,CAAC;KACpB;CACF"}
+{"version":3,"file":"field-config.d.ts","sourceRoot":"","sources":["../../../src/components/field/field-config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEjE;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC;AAEhC;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;AAEtE;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAErD;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;OAKG;IACH,IAAI,CAAC,EAAE,YAAY,CAAC;IAEpB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;OAIG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;IAEd;;;;OAIG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IAExB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,WAKhC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,WAAW,CAQ9C,CAAC;AAEX,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,2BAA2B;QACnC,KAAK,EAAE,WAAW,CAAC;KACpB;CACF"}

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

@@ -3,7 +3,8 @@ import { registerComponentDefaults as e } from "../../libs/registry.js";
 const l = {
   size: "md",
   labelAlign: "left",
-  fullWidth: !1
+  fullWidth: !1,
+  variant: "bordered"
 }, i = {
   size: "md",
   radius: "md",