asheeui 0.6.2 → 0.6.3

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

@@ -1,15 +1,73 @@
-import { Radius } from '../../shared/radius';
+import { Radius } from '../../shared';
+/**
+ * Position of the modal on the screen.
+ * - `center`: Vertically and horizontally centered.
+ * - `top`: Aligned to the top of the viewport.
+ * - `bottom`: Aligned to the bottom of the viewport.
+ */
 export type ModalPosition = "center" | "top" | "bottom";
+/**
+ * Size key for the modal.
+ * Controls the width of the modal dialog.
+ */
 export type ModalSizeKey = "sm" | "md" | "lg" | "xl" | "full";
+/**
+ * Theme configuration options for the Modal component.
+ *
+ * Set under `components.modal` in the AsheeUI config. Values feed the
+ * component-level fallback tier of the theme cascade.
+ */
 export interface ModalConfig {
+    /**
+     * Size of the modal.
+     * Controls the width of the modal dialog.
+     *
+     * @default "md"
+     */
     size?: ModalSizeKey;
+    /**
+     * Position of the modal on the screen.
+     * Controls where the modal appears vertically.
+     *
+     * @default "center"
+     */
     position?: ModalPosition;
+    /**
+     * Corner rounding of the modal.
+     * Controls the border-radius of the modal content.
+     *
+     * @default "lg"
+     */
     radius?: Radius;
+    /**
+     * Whether the modal has entrance and exit animations.
+     * When false, the modal appears and disappears instantly.
+     *
+     * @default true
+     */
     animated?: boolean;
+    /**
+     * Whether clicking on the backdrop closes the modal.
+     *
+     * @default true
+     */
     closeOnBackdropClick?: boolean;
+    /**
+     * Whether pressing the Escape key closes the modal.
+     *
+     * @default true
+     */
     closeOnEscape?: boolean;
 }
+/**
+ * Default config values registered for the Modal component.
+ */
 export declare const defaultModalConfig: ModalConfig;
+/**
+ * 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_MODAL_CONFIG: Required<ModalConfig>;
 declare module "../../libs/registry" {
     interface ComponentTypeConfigRegistry {

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

@@ -1 +1 @@
-{"version":3,"file":"modal-config.d.ts","sourceRoot":"","sources":["../../../src/components/modal/modal-config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAElD,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,CAAC;AACxD,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;AAE9D,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,eAAO,MAAM,kBAAkB,EAAE,WAMhC,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,WAAW,CAO9C,CAAC;AAEX,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,2BAA2B;QACnC,KAAK,EAAE,WAAW,CAAC;KACpB;CACF"}
+{"version":3,"file":"modal-config.d.ts","sourceRoot":"","sources":["../../../src/components/modal/modal-config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,CAAC;AAExD;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;AAE9D;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;OAKG;IACH,IAAI,CAAC,EAAE,YAAY,CAAC;IAEpB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,aAAa,CAAC;IAEzB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAE/B;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,WAMhC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,WAAW,CAO9C,CAAC;AAEX,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,2BAA2B;QACnC,KAAK,EAAE,WAAW,CAAC;KACpB;CACF"}

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

@@ -1,5 +1,12 @@
 import { ModalPosition, ModalSizeKey } from './modal-config';
+/**
+ * CSS classes for modal maximum width based on size.
+ * Controls the width constraint of the modal content.
+ */
 export declare const MODAL_MAX_WIDTH_CLASS: Record<ModalSizeKey, string>;
-export declare const MODAL_PADDING_CLASS: Record<ModalSizeKey, string>;
+/**
+ * CSS classes for modal position.
+ * Controls the vertical alignment of the modal.
+ */
 export declare const MODAL_POSITION_CLASS: Record<ModalPosition, string>;
 //# sourceMappingURL=modal-styles.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"modal-styles.d.ts","sourceRoot":"","sources":["../../../src/components/modal/modal-styles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAElE,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAM9D,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAM5D,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAI9D,CAAC"}
+{"version":3,"file":"modal-styles.d.ts","sourceRoot":"","sources":["../../../src/components/modal/modal-styles.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAElE;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAM9D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAI9D,CAAC"}

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

@@ -1,23 +1,16 @@
 "use client";
-const l = {
+const m = {
   sm: "max-w-sm",
   md: "max-w-lg",
   lg: "max-w-2xl",
   xl: "max-w-4xl",
   full: "max-w-[calc(100vw-2rem)]"
-}, m = {
-  sm: "p-5",
-  md: "p-6",
-  lg: "p-7",
-  xl: "p-8",
-  full: "p-8"
-}, t = {
+}, l = {
   center: "",
   top: "self-start mt-12",
   bottom: "self-end mb-12"
 };
 export {
-  l as MODAL_MAX_WIDTH_CLASS,
-  m as MODAL_PADDING_CLASS,
-  t as MODAL_POSITION_CLASS
+  m as MODAL_MAX_WIDTH_CLASS,
+  l as MODAL_POSITION_CLASS
 };

package/dist/components/multi-select/MultiSelect.d.ts

@@ -1,45 +1,174 @@
 import { HTMLAttributes, 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 { MultiSelectOption } from './multi-select-config';
-export interface MultiSelectProps extends Omit<HTMLAttributes<HTMLDivElement>, "onChange"> {
-    options: MultiSelectOption[];
+import { SelectMenuOption } from '../select-menu';
+import { MultiSelectConfig } from './multi-select-config';
+type BaseMultiSelectProps = MultiSelectConfig & Omit<HTMLAttributes<HTMLDivElement>, "color" | "size" | "onChange">;
+/**
+ * Configuration options for the MultiSelect component.
+ */
+export interface MultiSelectProps extends BaseMultiSelectProps {
+    /**
+     * Available options to select from.
+     * Each option must have a label and a unique value.
+     */
+    options: SelectMenuOption[];
+    /**
+     * Controlled selected values.
+     * Array of selected option values.
+     */
     value?: (string | number)[];
+    /**
+     * Callback fired when the selection changes.
+     * Receives the updated array of selected values.
+     */
     onChange?: (values: (string | number)[]) => void;
+    /**
+     * Label shown in the trigger when no items are selected.
+     * @default "Select Options..."
+     */
     InputLabel?: string;
+    /**
+     * Whether search input is shown in the dropdown.
+     * @default true
+     */
     isSearch?: boolean;
+    /**
+     * Placeholder text for the search input.
+     * @default "Search..."
+     */
     searchPlaceholder?: string;
+    /**
+     * Name attribute for the search input.
+     * @default "multiselect-search"
+     */
     searchInputName?: string;
+    /**
+     * Content rendered below the options list.
+     */
     belowList?: ReactNode;
-    chipOptions?: MultiSelectOption[];
+    /**
+     * Custom chip options for legacy or external control.
+     * When provided, this overrides the derived chips from value.
+     */
+    chipOptions?: SelectMenuOption[];
+    /**
+     * Custom handler for removing a chip.
+     * For legacy or external control patterns.
+     */
     handleRemoveChip?: (id: string | number) => void;
-    handleAddChip?: (item: MultiSelectOption) => void;
+    /**
+     * Custom handler for adding a chip.
+     * For legacy or external control patterns.
+     */
+    handleAddChip?: (item: SelectMenuOption) => void;
+    /**
+     * Label shown above the chip list.
+     */
     chipLabel?: string;
+    /**
+     * Whether to hide the chip display section.
+     * @default false
+     */
     disableChipDisplay?: boolean;
-    chipVariant?: Variant;
-    chipColor?: Color;
-    chipRadius?: Radius;
-    chipSize?: Size;
-    menuVariant?: Variant;
-    menuColor?: Color;
-    menuRadius?: Radius;
-    menuSize?: Size;
-    variant?: Variant;
-    color?: Color;
-    size?: FieldSizeKey;
-    radius?: Radius;
-    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 the field is disabled.
+     * @default false
+     */
     disabled?: boolean;
+    /**
+     * Extra classes for the container.
+     */
     containerClassName?: string;
+    /**
+     * Extra classes for the dropdown.
+     */
     dropdownClassName?: string;
 }
+/**
+ * A multi-select dropdown with search, chips, and configurable styles.
+ *
+ * MultiSelect renders a dropdown that allows selecting multiple options
+ * from a list. Selected options are displayed as chips below the trigger.
+ * It supports search filtering, controlled selection state, validation
+ * states, and custom menu and chip 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 - MultiSelect configuration options.
+ * @param props.options - Available options to select from.
+ * @param props.value - Controlled selected values.
+ * @param props.onChange - Callback fired when selection changes.
+ * @param props.InputLabel - Label shown in trigger. Defaults to "Select Options...".
+ * @param props.isSearch - Whether search is enabled. Defaults to true.
+ * @param props.searchPlaceholder - Search placeholder. Defaults to "Search...".
+ * @param props.belowList - Content below the options list.
+ * @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.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 { MultiSelect } from "asheeui";
+ * import { useState } from "react";
+ *
+ * export function Example() {
+ *   const [values, setValues] = useState<(string | number)[]>([]);
+ *
+ *   const options = [
+ *     { label: "React", value: "react" },
+ *     { label: "Vue", value: "vue" },
+ *     { label: "Svelte", value: "svelte" },
+ *   ];
+ *
+ *   return (
+ *     <MultiSelect
+ *       options={options}
+ *       value={values}
+ *       onChange={setValues}
+ *       label="Select Frameworks"
+ *       InputLabel="Choose frameworks..."
+ *     />
+ *   );
+ * }
+ * ```
+ *
+ * @see MultiSelectConfig - The configuration type for component defaults.
+ * @see SelectMenu - The dropdown menu component.
+ * @see FieldShell - The wrapper component for label and validation.
+ */
 export declare const MultiSelect: import('react').ForwardRefExoticComponent<MultiSelectProps & import('react').RefAttributes<HTMLButtonElement>>;
+export {};
 //# sourceMappingURL=MultiSelect.d.ts.map

package/dist/components/multi-select/MultiSelect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MultiSelect.d.ts","sourceRoot":"","sources":["../../../src/components/multi-select/MultiSelect.tsx"],"names":[],"mappings":"AAaA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,SAAS,EAKf,MAAM,OAAO,CAAC;AAIf,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAU3D,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,UAAU,EACX,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AAU/B,MAAM,WAAW,gBACf,SAAQ,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,UAAU,CAAC;IACxD,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,KAAK,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAC5B,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,KAAK,IAAI,CAAC;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,SAAS,CAAC;IAGtB,WAAW,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAClC,gBAAgB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC;IACjD,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAG7B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,KAAK,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,IAAI,CAAC;IAGhB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,KAAK,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,IAAI,CAAC;IAGhB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,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,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAID,eAAO,MAAM,WAAW,gHAwYvB,CAAC"}
+{"version":3,"file":"MultiSelect.d.ts","sourceRoot":"","sources":["../../../src/components/multi-select/MultiSelect.tsx"],"names":[],"mappings":"AAsBA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,SAAS,EAKf,MAAM,OAAO,CAAC;AAgBf,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AAU/B,KAAK,oBAAoB,GAAG,iBAAiB,GAC3C,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,UAAU,CAAC,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,oBAAoB;IAC5D;;;OAGG;IACH,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAE5B;;;OAGG;IACH,KAAK,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAE5B;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,KAAK,IAAI,CAAC;IAEjD;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,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,SAAS,CAAC,EAAE,SAAS,CAAC;IAEtB;;;OAGG;IACH,WAAW,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAEjC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC;IAEjD;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAEjD;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;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;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AACH,eAAO,MAAM,WAAW,gHAiWvB,CAAC"}