@nofinite/nui 1.1.2 → 2.0.0

package/dist/types/components/datepicker/DatePicker.d.ts

@@ -1,14 +1,26 @@
 export interface DatePickerProps {
+    /** Controlled value in YYYY-MM-DD format */
     value?: string;
+    /** Initial uncontrolled value in YYYY-MM-DD format */
     defaultValue?: string;
     onChange?: (v: string) => void;
     minDate?: string;
     maxDate?: string;
     placeholder?: string;
     name?: string;
+    /** Used for formatting the display date and weekdays. Defaults to 'en-US' */
     locale?: string;
     id?: string;
     className?: string;
+    disabled?: boolean;
+    /** Custom formatter for the trigger button label */
+    formatDisplay?: (date: Date) => string;
 }
-export declare function DatePicker({ value, defaultValue, onChange, minDate, maxDate, placeholder, name, locale, id, className, }: DatePickerProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * DatePicker Component
+ * * A robust, accessible date selection tool.
+ * Architecture Note: Implements smart collision detection to flip the popover
+ * above the trigger if it hits the bottom of the viewport.
+ */
+export declare function DatePicker({ value, defaultValue, onChange, minDate, maxDate, placeholder, name, locale, id, className, disabled, formatDisplay, }: DatePickerProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=DatePicker.d.ts.map

package/dist/types/components/datepicker/DatePicker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DatePicker.d.ts","sourceRoot":"","sources":["../../../../src/components/datepicker/DatePicker.tsx"],"names":[],"mappings":"AAKA,OAAO,kBAAkB,CAAC;AA4B1B,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAMD,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,YAAY,EACZ,QAAQ,EACR,OAAO,EACP,OAAO,EACP,WAA2B,EAC3B,IAAI,EACJ,MAAgB,EAChB,EAAE,EACF,SAAc,GACf,EAAE,eAAe,2CAiYjB"}
+{"version":3,"file":"DatePicker.d.ts","sourceRoot":"","sources":["../../../../src/components/datepicker/DatePicker.tsx"],"names":[],"mappings":"AAKA,OAAO,kBAAkB,CAAC;AAsB1B,MAAM,WAAW,eAAe;IAC9B,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oDAAoD;IACpD,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC;CACxC;AAMD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,YAAY,EACZ,QAAQ,EACR,OAAO,EACP,OAAO,EACP,WAA2B,EAC3B,IAAI,EACJ,MAAgB,EAChB,EAAE,EACF,SAAS,EACT,QAAgB,EAChB,aAAa,GACd,EAAE,eAAe,2CA6bjB"}

package/dist/types/components/daterangepicker/DateRangePicker.d.ts

@@ -14,6 +14,8 @@ export interface DateRangePickerProps {
     className?: string;
     nameFrom?: string;
     nameTo?: string;
+    disabled?: boolean;
+    formatDisplay?: (date: Date) => string;
 }
-export declare function DateRangePicker({ value, defaultValue, onChange, minDate, maxDate, placeholder, locale, id, className, nameFrom, nameTo, }: DateRangePickerProps): import("react/jsx-runtime").JSX.Element;
+export declare function DateRangePicker({ value, defaultValue, onChange, minDate, maxDate, placeholder, locale, id, className, nameFrom, nameTo, disabled, formatDisplay, }: DateRangePickerProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=DateRangePicker.d.ts.map

package/dist/types/components/daterangepicker/DateRangePicker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DateRangePicker.d.ts","sourceRoot":"","sources":["../../../../src/components/daterangepicker/DateRangePicker.tsx"],"names":[],"mappings":"AAcA,OAAO,uBAAuB,CAAC;AA8B/B,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,SAAS,KAAK,IAAI,CAAC;IAElC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAMD,wBAAgB,eAAe,CAAC,EAC9B,KAAK,EACL,YAAY,EACZ,QAAQ,EACR,OAAO,EACP,OAAO,EACP,WAA0B,EAC1B,MAAgB,EAChB,EAAE,EACF,SAAc,EACd,QAAQ,EACR,MAAM,GACP,EAAE,oBAAoB,2CAghBtB"}
+{"version":3,"file":"DateRangePicker.d.ts","sourceRoot":"","sources":["../../../../src/components/daterangepicker/DateRangePicker.tsx"],"names":[],"mappings":"AAaA,OAAO,uBAAuB,CAAC;AAuB/B,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,SAAS,KAAK,IAAI,CAAC;IAElC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC;CACxC;AAKD,wBAAgB,eAAe,CAAC,EAC9B,KAAK,EACL,YAAY,EACZ,QAAQ,EACR,OAAO,EACP,OAAO,EACP,WAA0B,EAC1B,MAAgB,EAChB,EAAE,EACF,SAAS,EACT,QAAQ,EACR,MAAM,EACN,QAAgB,EAChB,aAAa,GACd,EAAE,oBAAoB,2CAukBtB"}

package/dist/types/components/dialog/DialogProvider.d.ts

@@ -0,0 +1,2 @@
+export declare const DialogProvider: () => import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=DialogProvider.d.ts.map

package/dist/types/components/dialog/DialogProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DialogProvider.d.ts","sourceRoot":"","sources":["../../../../src/components/dialog/DialogProvider.tsx"],"names":[],"mappings":"AASA,eAAO,MAAM,cAAc,+CA4E1B,CAAC"}

package/dist/types/components/dialog/dialogStore.d.ts

@@ -0,0 +1,42 @@
+import { default as React } from 'react';
+export type DialogType = 'alert' | 'confirm';
+export interface DialogOptions {
+    title?: string;
+    message: React.ReactNode;
+    confirmText?: string;
+    cancelText?: string;
+    isDanger?: boolean;
+}
+export interface DialogState extends DialogOptions {
+    isOpen: boolean;
+    type: DialogType;
+    resolve: ((value: boolean) => void) | null;
+}
+export declare const dialogStore: {
+    getState: () => DialogState;
+    subscribe: (listener: () => void) => () => void;
+    setState: (newState: Partial<DialogState>) => void;
+};
+export interface ExternalToastOptions {
+    duration?: number;
+    description?: React.ReactNode;
+}
+type ToastEventPayload = {
+    variant: 'default' | 'success' | 'error' | 'warning';
+    message: React.ReactNode;
+    options?: ExternalToastOptions;
+};
+export declare const toastEmitter: {
+    subscribe: (listener: (payload: ToastEventPayload) => void) => () => void;
+    emit: (payload: ToastEventPayload) => void;
+};
+export declare const nui: {
+    confirm: (message: React.ReactNode, options?: Omit<DialogOptions, "message">) => Promise<boolean>;
+    alert: (message: React.ReactNode, options?: Omit<DialogOptions, "message">) => Promise<boolean>;
+    toast: (message: React.ReactNode, options?: ExternalToastOptions) => void;
+    success: (message: React.ReactNode, options?: ExternalToastOptions) => void;
+    error: (message: React.ReactNode, options?: ExternalToastOptions) => void;
+    warn: (message: React.ReactNode, options?: ExternalToastOptions) => void;
+};
+export {};
+//# sourceMappingURL=dialogStore.d.ts.map

package/dist/types/components/dialog/dialogStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialogStore.d.ts","sourceRoot":"","sources":["../../../../src/components/dialog/dialogStore.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAK1B,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,SAAS,CAAC;AAE7C,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,WAAY,SAAQ,aAAa;IAChD,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;CAC5C;AAUD,eAAO,MAAM,WAAW;;0BAEA,MAAM,IAAI;yBAMX,OAAO,CAAC,WAAW,CAAC;CAI1C,CAAC;AAOF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC/B;AAGD,KAAK,iBAAiB,GAAG;IACvB,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;IACrD,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,OAAO,CAAC,EAAE,oBAAoB,CAAC;CAChC,CAAC;AAIF,eAAO,MAAM,YAAY;0BACD,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI;oBAM1C,iBAAiB;CAGlC,CAAC;AAKF,eAAO,MAAM,GAAG;uBAGH,KAAK,CAAC,SAAS,YACd,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,KACvC,OAAO,CAAC,OAAO,CAAC;qBAgBR,KAAK,CAAC,SAAS,YACd,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,KACvC,OAAO,CAAC,OAAO,CAAC;qBAeF,KAAK,CAAC,SAAS,YAAY,oBAAoB;uBAG7C,KAAK,CAAC,SAAS,YAAY,oBAAoB;qBAGjD,KAAK,CAAC,SAAS,YAAY,oBAAoB;oBAGhD,KAAK,CAAC,SAAS,YAAY,oBAAoB;CAEhE,CAAC"}

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

@@ -1,12 +1,26 @@
 import { default as React } from 'react';
-export interface DrawerProps {
+export interface DrawerProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Controls the open/closed state of the drawer */
     open: boolean;
+    /** Callback fired when the drawer requests to be closed (e.g., Escape key, outside click) */
     onClose: () => void;
+    /** The edge of the screen the drawer attaches to. Defaults to 'right' */
     position?: 'left' | 'right' | 'bottom' | 'top';
-    className?: string;
-    children?: React.ReactNode;
+    /** Prevents the drawer from closing when the Escape key is pressed */
     disableEsc?: boolean;
+    /** Prevents the drawer from closing when a click occurs outside the content area */
     disableClickOutside?: boolean;
+    /** Custom class name applied to the backdrop overlay */
+    overlayClassName?: string;
 }
-export declare function Drawer({ open, onClose, position, className, children, disableEsc, disableClickOutside, }: DrawerProps): import("react/jsx-runtime").JSX.Element | null;
+/**
+ * Drawer Component
+ * * A sliding panel overlay for auxiliary content.
+ * * Architecture Note (2-Step Unmount):
+ * To allow smooth CSS exit transitions, the component uses two states:
+ * 1. `isMounted`: Controls presence in the React Tree (DOM).
+ * 2. `isVisible`: Controls the `data-state` attribute which triggers CSS transforms.
+ * Upon closing, `isVisible` flips immediately, then a 300ms timeout delays the `isMounted` flip.
+ */
+export declare const Drawer: React.ForwardRefExoticComponent<DrawerProps & React.RefAttributes<HTMLDivElement>>;
 //# sourceMappingURL=Drawer.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Drawer.d.ts","sourceRoot":"","sources":["../../../../src/components/drawer/Drawer.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;GAGG;AAEH,OAAO,KAAyC,MAAM,OAAO,CAAC;AAC9D,OAAO,cAAc,CAAC;AAKtB,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAE3B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,wBAAgB,MAAM,CAAC,EACrB,IAAI,EACJ,OAAO,EACP,QAAkB,EAClB,SAAc,EACd,QAAQ,EACR,UAAkB,EAClB,mBAA2B,GAC5B,EAAE,WAAW,kDA0Eb"}
+{"version":3,"file":"Drawer.d.ts","sourceRoot":"","sources":["../../../../src/components/drawer/Drawer.tsx"],"names":[],"mappings":"AAEA,OAAO,KAA+D,MAAM,OAAO,CAAC;AAWpF,OAAO,cAAc,CAAC;AAKtB,MAAM,WAAW,WAAY,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IACvE,mDAAmD;IACnD,IAAI,EAAE,OAAO,CAAC;IACd,6FAA6F;IAC7F,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;IAC/C,sEAAsE;IACtE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,oFAAoF;IACpF,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,wDAAwD;IACxD,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAMD;;;;;;;;GAQG;AACH,eAAO,MAAM,MAAM,oFAiIlB,CAAC"}

package/dist/types/components/dropdown/Dropdown.d.ts

@@ -1,18 +1,23 @@
-import { ReactNode } from 'react';
-export declare function Dropdown({ children }: {
-    children: ReactNode;
-}): import("react/jsx-runtime").JSX.Element;
-export declare function DropdownTrigger({ children, className, }: {
-    children: ReactNode;
-    className?: string;
-}): import("react/jsx-runtime").JSX.Element;
-export declare function DropdownMenu({ className, children, }: {
-    className?: string;
-    children: ReactNode;
-}): import("react/jsx-runtime").JSX.Element | null;
-export declare function DropdownItem({ children, onSelect, className, }: {
-    children: ReactNode;
+import { default as React } from 'react';
+export interface DropdownRootProps extends React.HTMLAttributes<HTMLDivElement> {
+    children: React.ReactNode;
+}
+export interface DropdownTriggerProps {
+    children: React.ReactNode;
+}
+export interface DropdownMenuProps extends React.HTMLAttributes<HTMLDivElement> {
+    children: React.ReactNode;
+    /** Aligns the popover menu relative to the trigger. Defaults to 'start' */
+    align?: 'start' | 'end';
+}
+export interface DropdownItemProps extends React.HTMLAttributes<HTMLDivElement> {
+    children: React.ReactNode;
+    /** Callback fired when the item is selected via click or keyboard */
     onSelect?: () => void;
-    className?: string;
-}): import("react/jsx-runtime").JSX.Element;
+}
+export declare const Dropdown: React.ForwardRefExoticComponent<DropdownRootProps & React.RefAttributes<HTMLDivElement>> & {
+    Trigger: React.ForwardRefExoticComponent<DropdownTriggerProps & React.RefAttributes<HTMLElement>>;
+    Menu: React.ForwardRefExoticComponent<DropdownMenuProps & React.RefAttributes<HTMLDivElement>>;
+    Item: React.ForwardRefExoticComponent<DropdownItemProps & React.RefAttributes<HTMLDivElement>>;
+};
 //# sourceMappingURL=Dropdown.d.ts.map

package/dist/types/components/dropdown/Dropdown.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Dropdown.d.ts","sourceRoot":"","sources":["../../../../src/components/dropdown/Dropdown.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAc,EAMZ,SAAS,EACV,MAAM,OAAO,CAAC;AAEf,OAAO,gBAAgB,CAAC;AA6BxB,wBAAgB,QAAQ,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,2CA8B7D;AAMD,wBAAgB,eAAe,CAAC,EAC9B,QAAQ,EACR,SAAc,GACf,EAAE;IACD,QAAQ,EAAE,SAAS,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,2CAcA;AAMD,wBAAgB,YAAY,CAAC,EAC3B,SAAc,EACd,QAAQ,GACT,EAAE;IACD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,SAAS,CAAC;CACrB,kDAsDA;AAMD,wBAAgB,YAAY,CAAC,EAC3B,QAAQ,EACR,QAAQ,EACR,SAAc,GACf,EAAE;IACD,QAAQ,EAAE,SAAS,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,2CAwBA"}
+{"version":3,"file":"Dropdown.d.ts","sourceRoot":"","sources":["../../../../src/components/dropdown/Dropdown.tsx"],"names":[],"mappings":"AAEA,OAAO,KAQN,MAAM,OAAO,CAAC;AAEf,OAAO,gBAAgB,CAAC;AAwBxB,MAAM,WAAW,iBAAkB,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IAC7E,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAkCD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAuED,MAAM,WAAW,iBAAkB,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IAC7E,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,2EAA2E;IAC3E,KAAK,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;CACzB;AAiGD,MAAM,WAAW,iBAAkB,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IAC7E,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB;AA4CD,eAAO,MAAM,QAAQ;;;;CAInB,CAAC"}

package/dist/types/components/fileuploader/FileUploader.d.ts

@@ -1,9 +1,28 @@
+import { default as React } from 'react';
 export interface FileUploaderProps {
+    /** Controlled state for the selected files */
+    value?: File[];
+    /** Uncontrolled initial state for the selected files */
+    defaultValue?: File[];
+    /** Callback fired when the list of selected files changes */
+    onChange?: (files: File[]) => void;
+    /** Whether to allow multiple files to be selected. Defaults to false. */
     multiple?: boolean;
+    /** A comma-separated list of allowed file extensions or MIME types (e.g., '.jpg, .png, application/pdf') */
     accept?: string;
-    onChange?: (files: File[]) => void;
+    /** Maximum allowed file size in bytes */
+    maxSize?: number;
+    /** Custom class name applied to the root container */
     className?: string;
-    placeholder?: string;
+    /** Custom text or element displayed inside the dropzone */
+    placeholder?: React.ReactNode;
+    /** Disables the dropzone and prevents file selection */
+    disabled?: boolean;
 }
-export declare function FileUploader({ multiple, accept, onChange, className, placeholder, }: FileUploaderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * FileUploader Component
+ * * A drag-and-drop zone for file uploads with built-in preview and file management.
+ * * Follows WAI-ARIA guidelines by delegating keyboard interactions to a hidden native file input.
+ */
+export declare function FileUploader({ value, defaultValue, onChange, multiple, accept, maxSize, className, placeholder, disabled, }: FileUploaderProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=FileUploader.d.ts.map

package/dist/types/components/fileuploader/FileUploader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FileUploader.d.ts","sourceRoot":"","sources":["../../../../src/components/fileuploader/FileUploader.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,oBAAoB,CAAC;AAE5B,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,YAAY,CAAC,EAC3B,QAAgB,EAChB,MAAM,EACN,QAAQ,EACR,SAAc,EACd,WAAkD,GACnD,EAAE,iBAAiB,2CA4FnB"}
+{"version":3,"file":"FileUploader.d.ts","sourceRoot":"","sources":["../../../../src/components/fileuploader/FileUploader.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAgE,MAAM,OAAO,CAAC;AAErF,OAAO,oBAAoB,CAAC;AAsB5B,MAAM,WAAW,iBAAiB;IAChC,8CAA8C;IAC9C,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IACf,wDAAwD;IACxD,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC;IACtB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,CAAC;IACnC,yEAAyE;IACzE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,4GAA4G;IAC5G,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9B,wDAAwD;IACxD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAMD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,EAC3B,KAAK,EACL,YAAY,EACZ,QAAQ,EACR,QAAgB,EAChB,MAAM,EACN,OAAO,EACP,SAAS,EACT,WAA0D,EAC1D,QAAgB,GACjB,EAAE,iBAAiB,2CA4JnB"}

package/dist/types/components/hovercard/HoverCard.d.ts

@@ -1,10 +1,50 @@
-import { ReactNode } from 'react';
+import { default as React } from 'react';
+export type HoverCardPlacement = 'top' | 'bottom';
 export interface HoverCardProps {
-    trigger: ReactNode;
-    children: ReactNode;
+    children: React.ReactNode;
+    /** Delay in milliseconds before the card opens. Defaults to 200ms. */
     openDelay?: number;
+    /** Delay in milliseconds before the card closes. Defaults to 300ms. */
     closeDelay?: number;
-    className?: string;
 }
-export declare function HoverCard({ trigger, children, openDelay, closeDelay, className, }: HoverCardProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * HoverCard Component (Root)
+ * * Implements a Compound Component Architecture.
+ * * Manages the delayed hover state and provides context to the Trigger and Content.
+ */
+export declare function HoverCardRoot({ children, openDelay, // Standard modern UI delay
+closeDelay, }: HoverCardProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace HoverCardRoot {
+    var displayName: string;
+}
+export interface HoverCardTriggerProps {
+    children: React.ReactElement;
+}
+/**
+ * HoverCard Trigger
+ * * Automatically clones the child element and injects necessary event listeners and ARIA attributes.
+ */
+export declare function HoverCardTrigger({ children }: HoverCardTriggerProps): React.ReactElement<React.HTMLProps<HTMLElement>, string | React.JSXElementConstructor<any>>;
+export declare namespace HoverCardTrigger {
+    var displayName: string;
+}
+export interface HoverCardContentProps extends React.HTMLAttributes<HTMLDivElement> {
+    children: React.ReactNode;
+    /** Preferred placement of the card relative to the trigger. Defaults to 'bottom' */
+    placement?: HoverCardPlacement;
+    /** Gap in pixels between the trigger and the card. Defaults to 8px. */
+    offset?: number;
+}
+/**
+ * HoverCard Content
+ * * Renders in a Portal and implements smart collision detection.
+ */
+export declare function HoverCardContent({ children, className, placement, offset, ...props }: HoverCardContentProps): import("react/jsx-runtime").JSX.Element | null;
+export declare namespace HoverCardContent {
+    var displayName: string;
+}
+export declare const HoverCard: typeof HoverCardRoot & {
+    Trigger: typeof HoverCardTrigger;
+    Content: typeof HoverCardContent;
+};
 //# sourceMappingURL=HoverCard.d.ts.map

package/dist/types/components/hovercard/HoverCard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HoverCard.d.ts","sourceRoot":"","sources":["../../../../src/components/hovercard/HoverCard.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAA+B,SAAS,EAAe,MAAM,OAAO,CAAC;AAC5E,OAAO,iBAAiB,CAAC;AAGzB,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,SAAS,CAAC;IACnB,QAAQ,EAAE,SAAS,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,SAAS,CAAC,EACxB,OAAO,EACP,QAAQ,EACR,SAAe,EACf,UAAgB,EAChB,SAAc,GACf,EAAE,cAAc,2CAoGhB"}
+{"version":3,"file":"HoverCard.d.ts","sourceRoot":"","sources":["../../../../src/components/hovercard/HoverCard.tsx"],"names":[],"mappings":"AAEA,OAAO,KASN,MAAM,OAAO,CAAC;AAGf,OAAO,iBAAiB,CAAC;AAEzB,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,QAAQ,CAAC;AA2BlD,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,SAAe,EAAE,2BAA2B;AAC5C,UAAgB,GACjB,EAAE,cAAc,2CA6ChB;yBAjDe,aAAa;;;AAuD7B,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,KAAK,CAAC,YAAY,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,QAAQ,EAAE,EAAE,qBAAqB,+FAsCnE;yBAtCe,gBAAgB;;;AA4ChC,MAAM,WAAW,qBAAsB,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IACjF,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,oFAAoF;IACpF,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAC/B,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,EACR,SAAS,EACT,SAAoB,EACpB,MAAU,EACV,GAAG,KAAK,EACT,EAAE,qBAAqB,kDAwGvB;yBA9Ge,gBAAgB;;;AAoHhC,eAAO,MAAM,SAAS;;;CAGpB,CAAC"}

package/dist/types/components/input/Input.d.ts

@@ -1,15 +1,25 @@
 import { default as React } from 'react';
 export interface InputProps extends React.InputHTMLAttributes<HTMLInputElement> {
-    /** Label for the input */
-    label?: string;
-    /** Helper text */
-    description?: string;
-    /** Error message */
-    error?: string;
-    /** Size variant (avoid HTML size conflict) */
+    /** The text label associated with the input field. */
+    label?: React.ReactNode;
+    /** Auxiliary text displayed below the input to provide additional context. */
+    description?: React.ReactNode;
+    /** Error message. Replaces the description text and applies error styling when present. */
+    error?: React.ReactNode;
+    /** Size variant of the input field. Defaults to 'md'. */
     inputSize?: 'sm' | 'md' | 'lg';
-    /** Custom wrapper class */
-    className?: string;
+    /** An icon element rendered on the left side (leading edge) inside the input. */
+    leftIcon?: React.ReactNode;
+    /** An icon element rendered on the right side (trailing edge) inside the input. */
+    rightIcon?: React.ReactNode;
+    /** Custom CSS class applied to the outermost wrapper element. */
+    wrapperClassName?: string;
 }
-export declare function Input({ label, description, error, inputSize, className, id, ...props }: InputProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Input Component
+ * * A fundamental form element for capturing user data.
+ * * Automatically generates stable IDs for strict WAI-ARIA compliance,
+ * linking the input to its label, description, and error messages.
+ */
+export declare const Input: React.ForwardRefExoticComponent<InputProps & React.RefAttributes<HTMLInputElement>>;
 //# sourceMappingURL=Input.d.ts.map

package/dist/types/components/input/Input.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Input.d.ts","sourceRoot":"","sources":["../../../../src/components/input/Input.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,aAAa,CAAC;AAErB,MAAM,WAAW,UACf,SAAQ,KAAK,CAAC,mBAAmB,CAAC,gBAAgB,CAAC;IACnD,0BAA0B;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,kBAAkB;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,8CAA8C;IAC9C,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAE/B,2BAA2B;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,KAAK,CAAC,EACpB,KAAK,EACL,WAAW,EACX,KAAK,EACL,SAAgB,EAChB,SAAc,EACd,EAAE,EACF,GAAG,KAAK,EACT,EAAE,UAAU,2CAoDZ"}
+{"version":3,"file":"Input.d.ts","sourceRoot":"","sources":["../../../../src/components/input/Input.tsx"],"names":[],"mappings":"AAEA,OAAO,KAA4B,MAAM,OAAO,CAAC;AAEjD,OAAO,aAAa,CAAC;AAMrB,MAAM,WAAW,UAAW,SAAQ,KAAK,CAAC,mBAAmB,CAAC,gBAAgB,CAAC;IAC7E,sDAAsD;IACtD,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,8EAA8E;IAC9E,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9B,2FAA2F;IAC3F,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,yDAAyD;IACzD,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC/B,iFAAiF;IACjF,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,mFAAmF;IACnF,SAAS,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC5B,iEAAiE;IACjE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAMD;;;;;GAKG;AACH,eAAO,MAAM,KAAK,qFAmFjB,CAAC"}

package/dist/types/components/layout/Container.d.ts

@@ -1,8 +1,12 @@
 import { default as React } from 'react';
-interface ContainerProps extends React.HTMLAttributes<HTMLDivElement> {
+export interface ContainerProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** The maximum width bounds for the container. Defaults to 'lg'. */
     size?: 'sm' | 'md' | 'lg' | 'xl' | 'full';
-    children?: React.ReactNode;
 }
-export declare function Container({ size, style, children, ...rest }: ContainerProps): import("react/jsx-runtime").JSX.Element;
-export {};
+/**
+ * Container Component
+ * * A structural primitive used to constrain content width to the current breakpoint.
+ * * Centers content horizontally and provides standard gutter padding.
+ */
+export declare const Container: React.ForwardRefExoticComponent<ContainerProps & React.RefAttributes<HTMLDivElement>>;
 //# sourceMappingURL=Container.d.ts.map

package/dist/types/components/layout/Container.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Container.d.ts","sourceRoot":"","sources":["../../../../src/components/layout/Container.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,UAAU,cAAe,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IACnE,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;IAC1C,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAUD,wBAAgB,SAAS,CAAC,EACxB,IAAW,EACX,KAAK,EACL,QAAQ,EACR,GAAG,IAAI,EACR,EAAE,cAAc,2CAehB"}
+{"version":3,"file":"Container.d.ts","sourceRoot":"","sources":["../../../../src/components/layout/Container.tsx"],"names":[],"mappings":"AACA,OAAO,KAAqB,MAAM,OAAO,CAAC;AAE1C,OAAO,cAAc,CAAC;AAEtB,MAAM,WAAW,cAAe,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IAC1E,oEAAoE;IACpE,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;CAC3C;AAED;;;;GAIG;AACH,eAAO,MAAM,SAAS,uFAgBpB,CAAC"}

package/dist/types/components/layout/Flex.d.ts

@@ -1,14 +1,31 @@
 import { default as React } from 'react';
-type Justify = 'start' | 'center' | 'end' | 'between' | 'around' | 'evenly';
-type Align = 'start' | 'center' | 'end' | 'stretch';
-interface FlexProps extends React.HTMLAttributes<HTMLDivElement> {
-    direction?: 'row' | 'column';
-    align?: Align;
-    justify?: Justify;
-    wrap?: 'wrap' | 'nowrap';
+export interface FlexProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Defines the flex-direction. Defaults to 'row'. */
+    direction?: 'row' | 'column' | 'row-reverse' | 'column-reverse';
+    /** Defines the align-items cross-axis behavior. Defaults to 'stretch'. */
+    align?: 'start' | 'center' | 'end' | 'stretch' | 'baseline';
+    /** Defines the justify-content main-axis behavior. Defaults to 'start'. */
+    justify?: 'start' | 'center' | 'end' | 'between' | 'around' | 'evenly';
+    /** Defines the flex-wrap behavior. Defaults to 'nowrap'. */
+    wrap?: 'wrap' | 'nowrap' | 'wrap-reverse';
+    /** The gap between flex items. Accepts numbers (px) or valid CSS strings. Defaults to 0. */
     gap?: number | string;
-    children?: React.ReactNode;
 }
-export declare function Flex({ direction, align, justify, wrap, gap, style, children, ...rest }: FlexProps): import("react/jsx-runtime").JSX.Element;
-export {};
+/**
+ * Flex Component
+ * * A highly configurable Flexbox container.
+ * * Uses data-attributes for standard flex properties and inline CSS variables
+ * to securely pass dynamic values (like gap) to the stylesheet without recalculating classes.
+ */
+export declare const Flex: React.ForwardRefExoticComponent<FlexProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Stack Component
+ * * Syntactic sugar for a vertical Flex container.
+ */
+export declare const Stack: React.ForwardRefExoticComponent<Omit<FlexProps, "direction"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * HStack Component
+ * * Syntactic sugar for a horizontal Flex container with vertically centered items.
+ */
+export declare const HStack: React.ForwardRefExoticComponent<Omit<FlexProps, "direction"> & React.RefAttributes<HTMLDivElement>>;
 //# sourceMappingURL=Flex.d.ts.map

package/dist/types/components/layout/Flex.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Flex.d.ts","sourceRoot":"","sources":["../../../../src/components/layout/Flex.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,KAAK,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE5E,KAAK,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,CAAC;AAEpD,UAAU,SAAU,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IAC9D,SAAS,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;IAC7B,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAED,wBAAgB,IAAI,CAAC,EACnB,SAAiB,EACjB,KAAiB,EACjB,OAAiB,EACjB,IAAe,EACf,GAAO,EACP,KAAK,EACL,QAAQ,EACR,GAAG,IAAI,EACR,EAAE,SAAS,2CAyBX"}
+{"version":3,"file":"Flex.d.ts","sourceRoot":"","sources":["../../../../src/components/layout/Flex.tsx"],"names":[],"mappings":"AACA,OAAO,KAAqB,MAAM,OAAO,CAAC;AAE1C,OAAO,cAAc,CAAC;AAEtB,MAAM,WAAW,SAAU,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IACrE,qDAAqD;IACrD,SAAS,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,aAAa,GAAG,gBAAgB,CAAC;IAChE,0EAA0E;IAC1E,KAAK,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,GAAG,UAAU,CAAC;IAC5D,2EAA2E;IAC3E,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACvE,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,cAAc,CAAC;IAC1C,4FAA4F;IAC5F,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,eAAO,MAAM,IAAI,kFA6Bf,CAAC;AAQH;;;GAGG;AACH,eAAO,MAAM,KAAK,qGAEhB,CAAC;AAGH;;;GAGG;AACH,eAAO,MAAM,MAAM,qGAEjB,CAAC"}

package/dist/types/components/layout/Grid.d.ts

@@ -1,10 +1,16 @@
 import { default as React } from 'react';
-interface GridProps extends React.HTMLAttributes<HTMLDivElement> {
-    columns?: number | string;
+export interface GridProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Number of fixed columns, or responsive auto algorithms. Defaults to 'auto-fit'. */
+    columns?: number | 'auto-fit' | 'auto-fill';
+    /** The gap between grid items. Accepts numbers (px) or valid CSS strings. Defaults to 16. */
     gap?: number | string;
+    /** The minimum width a column can shrink to before wrapping. Used with auto-fit/fill. Defaults to '250px'. */
     minColWidth?: string;
-    children?: React.ReactNode;
 }
-export declare function Grid({ columns, gap, minColWidth, style, children, ...rest }: GridProps): import("react/jsx-runtime").JSX.Element;
-export {};
+/**
+ * Grid Component
+ * * A responsive CSS Grid container.
+ * * Passes complex grid math to CSS via targeted variables for high performance.
+ */
+export declare const Grid: React.ForwardRefExoticComponent<GridProps & React.RefAttributes<HTMLDivElement>>;
 //# sourceMappingURL=Grid.d.ts.map

package/dist/types/components/layout/Grid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Grid.d.ts","sourceRoot":"","sources":["../../../../src/components/layout/Grid.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,UAAU,SAAU,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IAC9D,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAED,wBAAgB,IAAI,CAAC,EACnB,OAAoB,EACpB,GAAQ,EACR,WAAqB,EACrB,KAAK,EACL,QAAQ,EACR,GAAG,IAAI,EACR,EAAE,SAAS,2CAkBX"}
+{"version":3,"file":"Grid.d.ts","sourceRoot":"","sources":["../../../../src/components/layout/Grid.tsx"],"names":[],"mappings":"AACA,OAAO,KAAqB,MAAM,OAAO,CAAC;AAE1C,OAAO,cAAc,CAAC;AAEtB,MAAM,WAAW,SAAU,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IACrE,sFAAsF;IACtF,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,CAAC;IAC5C,6FAA6F;IAC7F,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,8GAA8G;IAC9G,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,eAAO,MAAM,IAAI,kFAyBf,CAAC"}

package/dist/types/components/link/Link.d.ts

@@ -0,0 +1,22 @@
+import { default as React } from 'react';
+export type LinkVariant = 'default' | 'primary' | 'muted' | 'danger';
+export type LinkUnderline = 'none' | 'hover' | 'always';
+export interface LinkProps extends React.AnchorHTMLAttributes<HTMLAnchorElement> {
+    variant?: LinkVariant;
+    underline?: LinkUnderline;
+    /** Automatically applies `target="_blank"` and `rel="noopener noreferrer"` for external routing security. */
+    isExternal?: boolean;
+    /** * Polymorphic Prop: When true, delegates rendering to its child.
+     * Crucial for integrating with framework routers like Next.js `<Link>` or React Router.
+     */
+    asChild?: boolean;
+}
+/**
+ * Link Component
+ * --------------
+ * Typographical navigation element designed to blend seamlessly into paragraphs, lists, and breadcrumbs.
+ * Architecture Note: For functional Call-to-Action links that require button-like padding and backgrounds,
+ * use the `<Button asChild>` component instead.
+ */
+export declare const Link: React.ForwardRefExoticComponent<LinkProps & React.RefAttributes<HTMLAnchorElement>>;
+//# sourceMappingURL=Link.d.ts.map

package/dist/types/components/link/Link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Link.d.ts","sourceRoot":"","sources":["../../../../src/components/link/Link.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,YAAY,CAAC;AAEpB,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;AACrE,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAExD,MAAM,WAAW,SAAU,SAAQ,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC;IAC9E,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,6GAA6G;IAC7G,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,IAAI,qFAoChB,CAAC"}

package/dist/types/components/megamenu/MegaMenu.d.ts

@@ -1,12 +1,9 @@
-export interface MegaMenuItem {
-    title: string;
-    description?: string;
-    href: string;
-}
-interface MegaMenuProps {
-    label: string;
-    items: MegaMenuItem[];
-}
-export declare function MegaMenu({ label, items }: MegaMenuProps): import("react/jsx-runtime").JSX.Element;
-export {};
+import { default as React } from 'react';
+export type MegaMenuProps = React.HTMLAttributes<HTMLDivElement>;
+export type MegaMenuTriggerProps = React.ButtonHTMLAttributes<HTMLButtonElement>;
+export type MegaMenuContentProps = React.HTMLAttributes<HTMLDivElement>;
+export declare const MegaMenu: React.ForwardRefExoticComponent<MegaMenuProps & React.RefAttributes<HTMLDivElement>> & {
+    Trigger: React.ForwardRefExoticComponent<MegaMenuTriggerProps & React.RefAttributes<HTMLButtonElement>>;
+    Content: React.ForwardRefExoticComponent<MegaMenuContentProps & React.RefAttributes<HTMLDivElement>>;
+};
 //# sourceMappingURL=MegaMenu.d.ts.map

package/dist/types/components/megamenu/MegaMenu.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MegaMenu.d.ts","sourceRoot":"","sources":["../../../../src/components/megamenu/MegaMenu.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,gBAAgB,CAAC;AAExB,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,UAAU,aAAa;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,wBAAgB,QAAQ,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,aAAa,2CAmDvD"}
+{"version":3,"file":"MegaMenu.d.ts","sourceRoot":"","sources":["../../../../src/components/megamenu/MegaMenu.tsx"],"names":[],"mappings":"AAEA,OAAO,KAA6E,MAAM,OAAO,CAAC;AAElG,OAAO,gBAAgB,CAAC;AAyBxB,MAAM,MAAM,aAAa,GAAG,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC;AAyEjE,MAAM,MAAM,oBAAoB,GAAG,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,CAAC;AAsDjF,MAAM,MAAM,oBAAoB,GAAG,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC;AAkCxE,eAAO,MAAM,QAAQ;;;CAGnB,CAAC"}

package/dist/types/components/modal/Modal.d.ts

@@ -1,16 +1,17 @@
 import { default as React } from 'react';
-export interface ModalProps {
+export interface ModalProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'title'> {
     open: boolean;
     onClose: () => void;
-    title?: string;
-    description?: string;
+    title?: React.ReactNode;
+    description?: React.ReactNode;
     labelledById?: string;
     describedById?: string;
     disableClickOutside?: boolean;
     disableEsc?: boolean;
-    initialFocusRef?: React.RefObject<HTMLElement>;
-    className?: string;
-    children?: React.ReactNode;
+    initialFocusRef?: React.RefObject<HTMLElement | null>;
+    overlayClassName?: string;
+    /** Hides the 'X' close button in the top right corner. */
+    hideCloseButton?: boolean;
 }
-export declare function Modal({ open, onClose, title, description, labelledById, describedById, disableClickOutside, disableEsc, initialFocusRef, className, children, }: ModalProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function Modal({ open, onClose, title, description, labelledById, describedById, disableClickOutside, disableEsc, hideCloseButton, initialFocusRef, className, overlayClassName, children, ...props }: ModalProps): import("react/jsx-runtime").JSX.Element | null;
 //# sourceMappingURL=Modal.d.ts.map

package/dist/types/components/modal/Modal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Modal.d.ts","sourceRoot":"","sources":["../../../../src/components/modal/Modal.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;;;;;;;GAQG;AAEH,OAAO,KAAyC,MAAM,OAAO,CAAC;AAC9D,OAAO,aAAa,CAAC;AAKrB,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,IAAI,CAAC;IAEpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB,eAAe,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAE/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAQD,wBAAgB,KAAK,CAAC,EACpB,IAAI,EACJ,OAAO,EACP,KAAK,EACL,WAAW,EACX,YAAY,EACZ,aAAa,EACb,mBAA2B,EAC3B,UAAkB,EAClB,eAAe,EACf,SAAc,EACd,QAAQ,GACT,EAAE,UAAU,kDAyIZ"}
+{"version":3,"file":"Modal.d.ts","sourceRoot":"","sources":["../../../../src/components/modal/Modal.tsx"],"names":[],"mappings":"AAEA,OAAO,KAA0D,MAAM,OAAO,CAAC;AAW/E,OAAO,aAAa,CAAC;AAMrB,MAAM,WAAW,UAAW,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IACrF,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAE9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,eAAe,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAEtD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,0DAA0D;IAC1D,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAMD,wBAAgB,KAAK,CAAC,EACpB,IAAI,EACJ,OAAO,EACP,KAAK,EACL,WAAW,EACX,YAAY,EACZ,aAAa,EACb,mBAA2B,EAC3B,UAAkB,EAClB,eAAuB,EACvB,eAAe,EACf,SAAS,EACT,gBAAgB,EAChB,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,UAAU,kDA6IZ"}

package/dist/types/components/multiselect/MultiSelect.d.ts

@@ -0,0 +1,33 @@
+import { default as React } from 'react';
+export type MultiSelectOption = {
+    value: string;
+    label: React.ReactNode;
+    disabled?: boolean;
+};
+export interface MultiSelectProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'value' | 'defaultValue' | 'onChange'> {
+    /** Array of available options */
+    options: MultiSelectOption[];
+    /** Controlled state for selected values */
+    value?: string[];
+    /** Uncontrolled initial state for selected values */
+    defaultValue?: string[];
+    /** Callback fired when the selection changes */
+    onChange?: (value: string[]) => void;
+    /** Text displayed when no options are selected */
+    placeholder?: string;
+    /** Name attribute applied to hidden inputs for native form submission */
+    name?: string;
+    /** Toggles error styling */
+    error?: boolean;
+    /** Number of tags to render before collapsing into a summary string (e.g., "3 selected") */
+    maxTags?: number;
+}
+/**
+ * MultiSelect Component
+ * * A custom, WAI-ARIA compliant dropdown for selecting multiple options.
+ * * Architecture Note: Unlike a standard Select, the dropdown list intentionally
+ * remains open after a selection is made, allowing the user to quickly select
+ * multiple items without repeatedly reopening the menu.
+ */
+export declare const MultiSelect: React.ForwardRefExoticComponent<MultiSelectProps & React.RefAttributes<HTMLButtonElement>>;
+//# sourceMappingURL=MultiSelect.d.ts.map

package/dist/types/components/multiselect/MultiSelect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultiSelect.d.ts","sourceRoot":"","sources":["../../../../src/components/multiselect/MultiSelect.tsx"],"names":[],"mappings":"AAEA,OAAO,KAQN,MAAM,OAAO,CAAC;AAGf,OAAO,mBAAmB,CAAC;AAM3B,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,OAAO,GAAG,cAAc,GAAG,UAAU,CAAC;IAClI,iCAAiC;IACjC,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,qDAAqD;IACrD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IACrC,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,4FAA4F;IAC5F,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAiBD;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,4FAgTtB,CAAC"}