asheeui 0.6.2 → 0.6.3

package/dist/components/resizable-screen/ResizableScreen.js

@@ -1,157 +1,162 @@
 "use client";
-import { jsxs as V, jsx as w } from "react/jsx-runtime";
-import { forwardRef as W, useState as k, useRef as C, useCallback as A } from "react";
-import { useAsheeConfig as ee } from "../../libs/context.js";
-import { resolveCascade as s } from "../../utils/resolve-token.js";
-import { FALLBACK_RESIZABLE_SCREEN_CONFIG as o } from "./resizable-screen-config.js";
+import { jsxs as W, jsx as v } from "react/jsx-runtime";
+import { forwardRef as C, useState as k, useRef as ee, useCallback as A } from "react";
+import { useAsheeConfig as te } from "../../libs/context.js";
+import { resolveCascade as o } from "../../utils/resolve-token.js";
+import { FALLBACK_RESIZABLE_SCREEN_CONFIG as l } from "./resizable-screen-config.js";
 import { cn as c } from "../../utils/cn.js";
-const te = W(
+const re = C(
   ({
     children: H,
     left: I,
-    size: v,
-    defaultSize: N,
-    minSize: E,
-    maxSize: K,
-    step: M,
+    size: w,
+    defaultSize: M,
+    minSize: N,
+    maxSize: E,
+    step: K,
     orientation: L,
     hideHandle: j,
     onSizeChange: u,
-    handleClassName: S,
+    handleClassName: x,
     className: B,
     style: U,
     ..._
   }, d) => {
     var R;
-    const t = (R = ee().components) == null ? void 0 : R.resizableScreen, h = s(
-      E,
+    const t = (R = te().components) == null ? void 0 : R.resizableScreen, h = o(
+      N,
       t == null ? void 0 : t.minSize,
       void 0,
-      o.minSize
-    ), m = s(
-      K,
+      l.minSize
+    ), f = o(
+      E,
       t == null ? void 0 : t.maxSize,
       void 0,
-      o.maxSize
-    ), b = s(
-      M,
+      l.maxSize
+    ), D = o(
+      K,
       t == null ? void 0 : t.step,
       void 0,
-      o.step
-    ), z = s(
+      l.step
+    ), z = o(
       L,
       t == null ? void 0 : t.orientation,
       void 0,
-      o.orientation
-    ), F = s(
+      l.orientation
+    ), F = o(
       j,
       t == null ? void 0 : t.hideHandle,
       void 0,
-      o.hideHandle
-    ), T = v ?? I ?? N ?? (t == null ? void 0 : t.defaultSize) ?? o.defaultSize, [$, G] = k(T), [n, D] = k(!1), y = C(null), x = v !== void 0, l = x ? v : $, g = A(
-      (e) => Math.min(Math.max(e, h), m),
-      [h, m]
-    ), a = A(
+      l.hideHandle
+    ), O = o(
+      M,
+      t == null ? void 0 : t.defaultSize,
+      void 0,
+      l.defaultSize
+    ), T = w ?? I ?? O, [$, G] = k(T), [i, b] = k(!1), y = ee(null), S = w !== void 0, a = S ? w : $, g = A(
+      (e) => Math.min(Math.max(e, h), f),
+      [h, f]
+    ), s = A(
       (e) => {
         const r = g(e);
-        x || G(r), u == null || u(r);
+        S || G(r), u == null || u(r);
       },
-      [g, x, u]
-    ), O = (e) => {
-      e.preventDefault(), e.currentTarget.setPointerCapture(e.pointerId), D(!0);
-    }, X = (e) => {
-      if (!n || !y.current) return;
-      const r = y.current.getBoundingClientRect(), f = z === "horizontal", p = f ? r.width : r.height, J = f ? e.clientX - r.left : e.clientY - r.top;
+      [g, S, u]
+    ), X = (e) => {
+      e.preventDefault(), e.currentTarget.setPointerCapture(e.pointerId), b(!0);
+    }, Y = (e) => {
+      if (!i || !y.current) return;
+      const r = y.current.getBoundingClientRect(), m = z === "horizontal", p = m ? r.width : r.height, Q = m ? e.clientX - r.left : e.clientY - r.top;
       if (p > 0) {
-        const Q = J / p * 100;
-        a(Q);
+        const V = Q / p * 100;
+        s(V);
       }
     }, P = (e) => {
-      if (n) {
+      if (i) {
         try {
           e.currentTarget.releasePointerCapture(e.pointerId);
         } catch {
         }
-        D(!1);
+        b(!1);
       }
-    }, Y = (e) => {
-      const r = z === "horizontal", f = r ? "ArrowLeft" : "ArrowUp", p = r ? "ArrowRight" : "ArrowDown";
-      e.key === f ? (e.preventDefault(), a(l - b)) : e.key === p ? (e.preventDefault(), a(l + b)) : e.key === "Home" ? (e.preventDefault(), a(h)) : e.key === "End" && (e.preventDefault(), a(m));
-    }, [Z, q] = H, i = z === "horizontal";
-    return /* @__PURE__ */ V(
+    }, Z = (e) => {
+      const r = z === "horizontal", m = r ? "ArrowLeft" : "ArrowUp", p = r ? "ArrowRight" : "ArrowDown";
+      e.key === m ? (e.preventDefault(), s(a - D)) : e.key === p ? (e.preventDefault(), s(a + D)) : e.key === "Home" ? (e.preventDefault(), s(h)) : e.key === "End" && (e.preventDefault(), s(f));
+    }, [q, J] = H, n = z === "horizontal";
+    return /* @__PURE__ */ W(
       "div",
       {
         ref: (e) => {
           y.current = e, typeof d == "function" ? d(e) : d && (d.current = e);
         },
         className: c(
-          "w-full h-full min-h-[200px] min-w-0 min-h-0 relative flex",
-          n && "select-none",
-          i ? "flex-row" : "flex-col",
+          "w-full h-full min-h-50 min-w-0 relative flex",
+          i && "select-none",
+          n ? "flex-row" : "flex-col",
           B
         ),
         style: {
-          cursor: n ? i ? "col-resize" : "row-resize" : "default",
+          cursor: i ? n ? "col-resize" : "row-resize" : "default",
           ...U
         },
         ..._,
         children: [
-          /* @__PURE__ */ w(
+          /* @__PURE__ */ v(
             "div",
             {
               className: c(
-                "h-full w-full min-w-0 min-h-0 overflow-hidden shrink-0",
-                n ? "transition-none" : "transition-[width,height] duration-150 ease-out"
+                "h-full w-full min-w-0 min-h-0 overflow-clip shrink-0",
+                i ? "transition-none" : "transition-[width,height] duration-150 ease-out"
               ),
               style: {
-                [i ? "width" : "height"]: `${l}%`
+                [n ? "width" : "height"]: `${a}%`
               },
-              children: Z
+              children: q
             }
           ),
           !F && // biome-ignore lint/a11y/useSemanticElements: interactive resizable handle requires div styling
-          /* @__PURE__ */ w(
+          /* @__PURE__ */ v(
             "div",
             {
               role: "separator",
               tabIndex: 0,
-              "aria-valuenow": Math.round(l),
+              "aria-valuenow": Math.round(a),
               "aria-valuemin": h,
-              "aria-valuemax": m,
-              "aria-orientation": i ? "horizontal" : "vertical",
+              "aria-valuemax": f,
+              "aria-orientation": n ? "horizontal" : "vertical",
               "aria-label": "Resize panel split",
-              onPointerDown: O,
-              onPointerMove: X,
+              onPointerDown: X,
+              onPointerMove: Y,
               onPointerUp: P,
               onPointerCancel: P,
-              onKeyDown: Y,
+              onKeyDown: Z,
               className: c(
                 "relative z-20 shrink-0 flex items-center justify-center outline-none select-none group touch-none",
-                i ? "w-4 h-full cursor-col-resize -mx-2" : "h-4 w-full cursor-row-resize -my-2"
+                n ? "w-4 h-full cursor-col-resize -mx-2" : "h-4 w-full cursor-row-resize -my-2"
               ),
-              children: /* @__PURE__ */ w(
+              children: /* @__PURE__ */ v(
                 "div",
                 {
                   className: c(
                     "transition-colors duration-150",
-                    i ? "w-1 h-full" : "h-1 w-full",
-                    S || (n ? "bg-primary" : "bg-border group-hover:bg-primary/70 group-focus-visible:bg-primary")
+                    n ? "w-1 h-full" : "h-1 w-full",
+                    x || (i ? "bg-primary" : "bg-border group-hover:bg-primary/70 group-focus-visible:bg-primary")
                   )
                 }
               )
             }
           ),
-          /* @__PURE__ */ w(
+          /* @__PURE__ */ v(
             "div",
             {
               className: c(
-                "h-full w-full min-w-0 min-h-0 overflow-hidden shrink-0 flex-1",
-                n ? "transition-none" : "transition-[width,height] duration-150 ease-out"
+                "h-full w-full min-w-0 min-h-0 overflow-clip shrink-0 flex-1",
+                i ? "transition-none" : "transition-[width,height] duration-150 ease-out"
               ),
               style: {
-                [i ? "width" : "height"]: `${100 - l}%`
+                [n ? "width" : "height"]: `${100 - a}%`
               },
-              children: q
+              children: J
             }
           )
         ]
@@ -159,7 +164,7 @@ const te = W(
     );
   }
 );
-te.displayName = "ResizableScreen";
+re.displayName = "ResizableScreen";
 export {
-  te as ResizableScreen
+  re as ResizableScreen
 };

package/dist/components/resizable-screen/resizable-screen-config.d.ts

@@ -1,13 +1,75 @@
+/**
+ * ResizableScreen component configuration for AsheeUI.
+ * This file defines the configuration types and defaults for the ResizableScreen
+ * component, which provides a split panel layout with a draggable handle for
+ * resizing the primary panel. It registers the default configuration with the
+ * component registry and provides fallback values for the cascade resolution system.
+ */
+/**
+ * The orientation of the resizable split.
+ * - `horizontal`: Panels are side by side (left/right).
+ * - `vertical`: Panels are stacked (top/bottom).
+ */
 export type ResizableOrientation = "horizontal" | "vertical";
+/**
+ * Theme configuration options for the ResizableScreen component.
+ *
+ * Set under `components.resizableScreen` in the AsheeUI config. Values feed the
+ * component-level fallback tier of the theme cascade.
+ */
 export interface ResizableScreenConfig {
+    /**
+     * Default size of the primary panel as a percentage (0-100).
+     * Used when the component is uncontrolled.
+     *
+     * @default 50
+     */
     defaultSize?: number;
+    /**
+     * Minimum size of the primary panel as a percentage (0-100).
+     * Prevents the panel from being resized below this value.
+     *
+     * @default 20
+     */
     minSize?: number;
+    /**
+     * Maximum size of the primary panel as a percentage (0-100).
+     * Prevents the panel from being resized above this value.
+     *
+     * @default 80
+     */
     maxSize?: number;
+    /**
+     * Step size in percentage points for keyboard resizing.
+     * Controls how much the size changes per arrow key press.
+     *
+     * @default 2
+     */
     step?: number;
+    /**
+     * The orientation of the split layout.
+     * Controls whether panels are arranged side by side or stacked.
+     *
+     * @default "horizontal"
+     */
     orientation?: ResizableOrientation;
+    /**
+     * Whether to hide the resize handle.
+     * When true, the drag handle is not rendered.
+     *
+     * @default false
+     */
     hideHandle?: boolean;
 }
+/**
+ * Default config values registered for the ResizableScreen component.
+ */
 export declare const defaultResizableScreenConfig: ResizableScreenConfig;
+/**
+ * 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_RESIZABLE_SCREEN_CONFIG: Required<ResizableScreenConfig>;
 declare module "../../libs/registry" {
     interface ComponentTypeConfigRegistry {

package/dist/components/resizable-screen/resizable-screen-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resizable-screen-config.d.ts","sourceRoot":"","sources":["../../../src/components/resizable-screen/resizable-screen-config.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,oBAAoB,GAAG,YAAY,GAAG,UAAU,CAAC;AAE7D,MAAM,WAAW,qBAAqB;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,oBAAoB,CAAC;IACnC,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,eAAO,MAAM,4BAA4B,EAAE,qBAM1C,CAAC;AAEF,eAAO,MAAM,gCAAgC,EAAE,QAAQ,CAAC,qBAAqB,CAQjE,CAAC;AAEb,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,2BAA2B;QACnC,eAAe,EAAE,qBAAqB,CAAC;KACxC;CACF"}
+{"version":3,"file":"resizable-screen-config.d.ts","sourceRoot":"","sources":["../../../src/components/resizable-screen/resizable-screen-config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,YAAY,GAAG,UAAU,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;;OAKG;IACH,WAAW,CAAC,EAAE,oBAAoB,CAAC;IAEnC;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,eAAO,MAAM,4BAA4B,EAAE,qBAM1C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gCAAgC,EAAE,QAAQ,CAAC,qBAAqB,CAQjE,CAAC;AAEb,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,2BAA2B;QACnC,eAAe,EAAE,qBAAqB,CAAC;KACxC;CACF"}

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

@@ -1,31 +1,66 @@
+/**
+ * Scrollbar configuration for AsheeUI.
+ * This file defines the structural (non-color) theming options for scrollbars.
+ * Color properties (thumb/track) are handled separately through ColorVariant
+ * in the theme system. This config controls shape, size, and behavior which
+ * are theme-agnostic. It registers the default configuration with the
+ * component registry for theme-level overrides.
+ */
 /**
  * Structural (non-color) scrollbar theming.
  * Thumb/track colors already live in ColorVariant (scrollbarThumb/scrollbarTrack)
  * per theme - this config controls shape/behavior, which is theme-agnostic.
  */
 export interface ScrollbarConfig {
-    /** Thickness of the scrollbar. Applied via ::-webkit-scrollbar width/height. */
+    /**
+     * Thickness of the scrollbar.
+     * Applied via ::-webkit-scrollbar width and height properties.
+     * Accepts any valid CSS size value (e.g., "10px", "0.5rem").
+     */
     width: string;
-    /** Corner radius applied to the thumb (and track, if trackRadius isn't set). */
+    /**
+     * Corner radius applied to the thumb.
+     * Applied to both the thumb and track when trackRadius is not specified.
+     * Accepts any valid CSS radius value.
+     */
     radius: string;
-    /** Optional separate radius for the track; falls back to `radius` when omitted. */
+    /**
+     * Optional separate radius for the track.
+     * When provided, overrides the radius for the track only.
+     * Falls back to the main radius when omitted.
+     */
     trackRadius?: string;
     /**
-     * Creates an "inset" thumb look via a transparent border + background-clip,
-     * e.g. "3px" gives the thumb 3px of breathing room from the track edge.
+     * Creates an "inset" thumb look via a transparent border plus background-clip.
+     * For example, "3px" gives the thumb 3px of breathing room from the track edge.
+     * Accepts any valid CSS size value.
      */
     thumbBorder: string;
     /**
-     * Native `scrollbar-gutter` value - reserves space for the scrollbar so
-     * content doesn't shift when a scrollbar appears/disappears.
+     * Native `scrollbar-gutter` value.
+     * Reserves space for the scrollbar so content does not shift when a
+     * scrollbar appears or disappears.
+     *
+     * - `auto`: No space is reserved.
+     * - `stable`: Space is always reserved on the side where the scrollbar appears.
+     * - `stable both-edges`: Space is reserved on both sides.
      */
     gutter: "auto" | "stable" | "stable both-edges";
     /**
-     * Native `scrollbar-width` keyword fallback for engines that don't support
-     * the ::-webkit-scrollbar pseudo-elements (width/radius are ignored there).
+     * Native `scrollbar-width` keyword fallback.
+     * Used for engines that do not support the ::-webkit-scrollbar
+     * pseudo-elements. Width properties are ignored in those engines.
+     *
+     * - `auto`: Default browser scrollbar width.
+     * - `thin`: Thin scrollbar.
+     * - `none`: No scrollbar visible.
      */
     fallbackWidth: "auto" | "thin" | "none";
 }
+/**
+ * Default scrollbar configuration values.
+ * Provides a modern, subtle scrollbar with rounded thumb and stable gutter.
+ */
 export declare const defaultScrollbarConfig: ScrollbarConfig;
 declare module "../../libs/registry" {
     interface ComponentTypeConfigRegistry {

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

@@ -1 +1 @@
-{"version":3,"file":"scrollbar-config.d.ts","sourceRoot":"","sources":["../../../src/components/scrollbar/scrollbar-config.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,gFAAgF;IAChF,KAAK,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,MAAM,EAAE,MAAM,CAAC;IACf,mFAAmF;IACnF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,mBAAmB,CAAC;IAChD;;;OAGG;IACH,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;CACzC;AAED,eAAO,MAAM,sBAAsB,EAAE,eAMpC,CAAC;AAEF,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,2BAA2B;QACnC,SAAS,EAAE,eAAe,CAAC;KAC5B;CACF"}
+{"version":3,"file":"scrollbar-config.d.ts","sourceRoot":"","sources":["../../../src/components/scrollbar/scrollbar-config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;;;;;;OAQG;IACH,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,mBAAmB,CAAC;IAEhD;;;;;;;;OAQG;IACH,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;CACzC;AAED;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,eAMpC,CAAC;AAEF,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,2BAA2B;QACnC,SAAS,EAAE,eAAe,CAAC;KAC5B;CACF"}

package/dist/components/select/Select.d.ts

@@ -1,40 +1,180 @@
 import { ReactNode } from 'react';
-import { Radius } from '../../shared/radius';
-import { Size } from '../../shared/size';
-import { Color, Variant } from '../../shared/variant';
-import { FieldSizeKey, FieldStatus, LabelAlign } from '../field/field-config';
-import { SelectOption } from './select-config';
-export interface SelectProps extends Omit<React.SelectHTMLAttributes<HTMLSelectElement>, "size" | "color" | "onChange" | "value"> {
-    options: SelectOption[];
+import { SelectMenuOption } from '../select-menu/select-menu-config';
+import { SelectConfig } from './select-config';
+type BaseSelectProps = SelectConfig & Omit<React.SelectHTMLAttributes<HTMLSelectElement>, "color" | "size" | "value" | "onChange">;
+/**
+ * Configuration options for the Select component.
+ */
+export interface SelectProps extends BaseSelectProps {
+    /**
+     * Available options to select from.
+     * Each option must have a label and a unique value.
+     */
+    options: SelectMenuOption[];
+    /**
+     * Controlled selected value.
+     */
     value?: string | number;
+    /**
+     * Native change event handler.
+     * Receives a synthetic change event.
+     */
     onChange?: (e: React.ChangeEvent<HTMLSelectElement>) => void;
+    /**
+     * Value change handler.
+     * Receives the new selected value directly.
+     */
     onValueChange?: (value: string | number) => void;
-    size?: FieldSizeKey;
-    radius?: Radius;
-    variant?: Variant;
-    color?: Color;
-    status?: FieldStatus;
+    /**
+     * Label text for the field.
+     */
     label?: string;
-    labelAlign?: LabelAlign;
+    /**
+     * Description text shown below the label.
+     */
     description?: string;
+    /**
+     * Validation message shown below the field.
+     */
     message?: string;
+    /**
+     * Whether the field is required.
+     * @default false
+     */
     required?: boolean;
+    /**
+     * Whether the field is in a loading state.
+     * @default false
+     */
     isLoading?: boolean;
+    /**
+     * Whether search input is shown in the dropdown.
+     * @default false
+     */
     isSearch?: boolean;
+    /**
+     * Placeholder text for the search input.
+     * @default "Search options..."
+     */
     searchPlaceholder?: string;
+    /**
+     * Name attribute for the search input.
+     * @default "select-search"
+     */
     searchInputName?: string;
+    /**
+     * Initial value for uncontrolled usage.
+     */
     initialValue?: string | number;
+    /**
+     * Content rendered below the options list.
+     */
     belowList?: ReactNode;
+    /**
+     * Placeholder text shown when no value is selected.
+     * @default "Select..."
+     */
     placeholder?: string;
+    /**
+     * Custom background color for the trigger button.
+     * Accepts any CSS color value.
+     */
     buttonColor?: string;
+    /**
+     * Extra CSS classes for the trigger button.
+     */
     className?: string;
+    /**
+     * Extra CSS classes for the dropdown.
+     */
     dropdownClassName?: string;
+    /**
+     * Optional ID for the field.
+     */
     id?: string;
+    /**
+     * Name attribute for the select.
+     */
     name?: string;
-    menuVariant?: Variant;
-    menuColor?: Color;
-    menuRadius?: Radius;
-    menuSize?: Size;
 }
+/**
+ * A dropdown selector with search, label, validation, and configurable styles.
+ *
+ * Select renders a dropdown that allows selecting a single option from a list.
+ * It supports search filtering, controlled and uncontrolled selection state,
+ * validation states, and custom menu and trigger styles. Visual tokens resolve
+ * through the standard AsheeUI cascade system.
+ *
+ * The component uses Floating UI for positioning and accessibility, and
+ * integrates with the FieldShell for consistent label and validation handling.
+ *
+ * @param props - Select configuration options.
+ * @param props.options - Available options to select from.
+ * @param props.value - Controlled selected value.
+ * @param props.onChange - Native change event handler.
+ * @param props.onValueChange - Value change handler.
+ * @param props.label - Field label text.
+ * @param props.description - Description text.
+ * @param props.message - Validation message.
+ * @param props.required - Whether the field is required.
+ * @param props.isLoading - Loading state.
+ * @param props.disabled - Disabled state.
+ * @param props.isSearch - Whether search is enabled. Defaults to false.
+ * @param props.searchPlaceholder - Search placeholder. Defaults to "Search options...".
+ * @param props.initialValue - Initial value for uncontrolled usage.
+ * @param props.belowList - Content below the options list.
+ * @param props.placeholder - Placeholder text. Defaults to "Select...".
+ * @param props.buttonColor - Custom background color for the trigger.
+ * @param props.size - Size of the trigger. 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".
+ *
+ * @example
+ * ```tsx
+ * import { Select } from "asheeui";
+ * import { useState } from "react";
+ *
+ * export function Example() {
+ *   const [value, setValue] = useState<string | number>("react");
+ *
+ *   const options = [
+ *     { label: "React", value: "react" },
+ *     { label: "Vue", value: "vue" },
+ *     { label: "Svelte", value: "svelte" },
+ *   ];
+ *
+ *   return (
+ *     <Select
+ *       options={options}
+ *       value={value}
+ *       onValueChange={setValue}
+ *       label="Select Framework"
+ *       placeholder="Choose a framework..."
+ *     />
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // With search and validation
+ * <Select
+ *   options={fruits}
+ *   label="Favorite Fruit"
+ *   isSearch
+ *   status="error"
+ *   message="Please select a fruit"
+ *   required
+ * />
+ * ```
+ *
+ * @see SelectConfig - The configuration type for component defaults.
+ * @see SelectMenu - The dropdown menu component.
+ * @see FieldShell - The wrapper component for label and validation.
+ */
 export declare const Select: import('react').ForwardRefExoticComponent<SelectProps & import('react').RefAttributes<HTMLButtonElement>>;
+export {};
 //# sourceMappingURL=Select.d.ts.map

package/dist/components/select/Select.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Select.d.ts","sourceRoot":"","sources":["../../../src/components/select/Select.tsx"],"names":[],"mappings":"AAaA,OAAO,EAEL,KAAK,SAAS,EAKf,MAAM,OAAO,CAAC;AAGf,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EACL,KAAK,KAAK,EAEV,KAAK,OAAO,EACb,MAAM,sBAAsB,CAAC;AAQ9B,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,UAAU,EACX,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,iBAAiB,CAAC;AAKzB,MAAM,WAAW,WACf,SAAQ,IAAI,CACV,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAC7C,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,CACxC;IACD,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;IAC7D,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC;IACjD,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,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IAGd,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,KAAK,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,IAAI,CAAC;CACjB;AAID,eAAO,MAAM,MAAM,2GAmQlB,CAAC"}
+{"version":3,"file":"Select.d.ts","sourceRoot":"","sources":["../../../src/components/select/Select.tsx"],"names":[],"mappings":"AAsBA,OAAO,EAEL,KAAK,SAAS,EAKf,MAAM,OAAO,CAAC;AAkBf,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,EAA0B,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAK5E,KAAK,eAAe,GAAG,YAAY,GACjC,IAAI,CACF,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAC7C,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,CACxC,CAAC;AAEJ;;GAEG;AACH,MAAM,WAAW,WAAY,SAAQ,eAAe;IAClD;;;OAGG;IACH,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAE5B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAExB;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;IAE7D;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC;IAEjD;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAE/B;;OAEG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IAEtB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6EG;AACH,eAAO,MAAM,MAAM,2GA+OlB,CAAC"}