@nofinite/nui 1.1.2 → 2.0.2

package/dist/types/components/tabs/Tabs.d.ts

@@ -1,14 +1,27 @@
 import { default as React } from 'react';
-export interface TabItem {
-    id: string;
-    label: string;
-    content: React.ReactNode;
-}
-interface TabsProps {
-    tabs: TabItem[];
-    defaultTab?: string;
-    className?: string;
-}
-export declare function Tabs({ tabs, defaultTab, className }: TabsProps): import("react/jsx-runtime").JSX.Element;
-export {};
+export interface TabsProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange'> {
+    /** Controlled state value representing the active tab */
+    value?: string;
+    /** Uncontrolled initial value */
+    defaultValue?: string;
+    /** Callback fired when the active tab changes */
+    onChange?: (value: string) => void;
+    children: React.ReactNode;
+}
+export interface TabsListProps extends React.HTMLAttributes<HTMLDivElement> {
+    children: React.ReactNode;
+}
+export interface TabsTriggerProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
+    /** The unique identifier associated with this tab's content */
+    value: string;
+}
+export interface TabsContentProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** The unique identifier connecting this panel to its trigger */
+    value: string;
+}
+export declare const Tabs: React.ForwardRefExoticComponent<TabsProps & React.RefAttributes<HTMLDivElement>> & {
+    List: React.ForwardRefExoticComponent<TabsListProps & React.RefAttributes<HTMLDivElement>>;
+    Trigger: React.ForwardRefExoticComponent<TabsTriggerProps & React.RefAttributes<HTMLButtonElement>>;
+    Content: React.ForwardRefExoticComponent<TabsContentProps & React.RefAttributes<HTMLDivElement>>;
+};
 //# sourceMappingURL=Tabs.d.ts.map

package/dist/types/components/tabs/Tabs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Tabs.d.ts","sourceRoot":"","sources":["../../../../src/components/tabs/Tabs.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAsC,MAAM,OAAO,CAAC;AAC3D,OAAO,YAAY,CAAC;AAEpB,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC;CAC1B;AAED,UAAU,SAAS;IACjB,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,SAAc,EAAE,EAAE,SAAS,2CAqEnE"}
+{"version":3,"file":"Tabs.d.ts","sourceRoot":"","sources":["../../../../src/components/tabs/Tabs.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAyE,MAAM,OAAO,CAAC;AAE9F,OAAO,YAAY,CAAC;AAyBpB,MAAM,WAAW,SAAU,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,UAAU,CAAC;IACvF,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAoCD,MAAM,WAAW,aAAc,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IACzE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AA+DD,MAAM,WAAW,gBAAiB,SAAQ,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC;IACrF,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAC;CACf;AAkDD,MAAM,WAAW,gBAAiB,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IAC5E,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAC;CACf;AAmCD,eAAO,MAAM,IAAI;;;;CAIf,CAAC"}

package/dist/types/components/textarea/Textarea.d.ts

@@ -1,14 +1,17 @@
 import { default as React } from 'react';
 export interface TextareaProps extends React.TextareaHTMLAttributes<HTMLTextAreaElement> {
-    /** Show character counter */
+    /** Displays a character counter below the textarea */
     showCount?: boolean;
-    /** Enable auto resizing of height */
+    /** Enables automatic vertical resizing based on content. Defaults to true. */
     autoGrow?: boolean;
-    /** Visual error state */
+    /** Applies visual error styling and WAI-ARIA invalid states */
     error?: boolean;
-    /** Used for aria-describedby */
+    /** The ID of the element describing this input (for screen readers) */
     helperId?: string;
 }
+/**
+ * Textarea Component
+ * * A multi-line text input that supports automatic resizing and character counting.
+ */
 export declare const Textarea: React.ForwardRefExoticComponent<TextareaProps & React.RefAttributes<HTMLTextAreaElement>>;
-export default Textarea;
 //# sourceMappingURL=Textarea.d.ts.map

package/dist/types/components/textarea/Textarea.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Textarea.d.ts","sourceRoot":"","sources":["../../../../src/components/textarea/Textarea.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAON,MAAM,OAAO,CAAC;AAEf,OAAO,gBAAgB,CAAC;AAExB,MAAM,WAAW,aACf,SAAQ,KAAK,CAAC,sBAAsB,CAAC,mBAAmB,CAAC;IACzD,6BAA6B;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,yBAAyB;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AASD,eAAO,MAAM,QAAQ,2FA8FpB,CAAC;AAIF,eAAe,QAAQ,CAAC"}
+{"version":3,"file":"Textarea.d.ts","sourceRoot":"","sources":["../../../../src/components/textarea/Textarea.tsx"],"names":[],"mappings":"AAEA,OAAO,KAMN,MAAM,OAAO,CAAC;AAEf,OAAO,gBAAgB,CAAC;AAMxB,MAAM,WAAW,aACf,SAAQ,KAAK,CAAC,sBAAsB,CAAC,mBAAmB,CAAC;IACzD,sDAAsD;IACtD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAMD;;;GAGG;AACH,eAAO,MAAM,QAAQ,2FA+HpB,CAAC"}

package/dist/types/components/timepicker/TimePicker.d.ts

@@ -0,0 +1,26 @@
+import { default as React } from 'react';
+export interface TimePickerProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange' | 'value' | 'defaultValue'> {
+    /** Standard HTML5 time format: HH:mm (24-hour format internally) */
+    value?: string;
+    /** Uncontrolled default time */
+    defaultValue?: string;
+    /** Callback fired when a time segment is selected */
+    onChange?: (v: string) => void;
+    /** 12-hour or 24-hour clock formatting. Defaults to 12. */
+    clockType?: 12 | 24;
+    /** Step interval for the minute column. Defaults to 1. */
+    minuteStep?: number;
+    /** Placeholder text when empty */
+    placeholder?: string;
+    /** Name attribute for the hidden input (for native forms) */
+    name?: string;
+    /** Disables the time picker trigger */
+    disabled?: boolean;
+}
+/**
+ * TimePicker Component
+ * * A highly usable dropdown for selecting hours, minutes, and periods.
+ * * Uses smart positioning and automatic scroll-to-selected logic.
+ */
+export declare const TimePicker: React.ForwardRefExoticComponent<TimePickerProps & React.RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=TimePicker.d.ts.map

package/dist/types/components/timepicker/TimePicker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimePicker.d.ts","sourceRoot":"","sources":["../../../../src/components/timepicker/TimePicker.tsx"],"names":[],"mappings":"AAEA,OAAO,KAQN,MAAM,OAAO,CAAC;AAGf,OAAO,kBAAkB,CAAC;AA4C1B,MAAM,WAAW,eAAgB,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,cAAc,CAAC;IACxH,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAE/B,2DAA2D;IAC3D,SAAS,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC;IACpB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAMD;;;;GAIG;AACH,eAAO,MAAM,UAAU,wFA+OrB,CAAC"}

package/dist/types/components/timerangepicker/TimeRangePicker.d.ts

@@ -0,0 +1,32 @@
+import { default as React } from 'react';
+export interface TimeRange {
+    from?: string;
+    to?: string;
+}
+export interface TimeRangePickerProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange' | 'value' | 'defaultValue'> {
+    /** Controlled time range object */
+    value?: TimeRange;
+    /** Uncontrolled default time range object */
+    defaultValue?: TimeRange;
+    /** Callback fired when either the start or end time changes */
+    onChange?: (v: TimeRange) => void;
+    /** Uses 12-hour or 24-hour clock formatting. Defaults to 12. */
+    clockType?: 12 | 24;
+    /** Step interval for the minute column. Defaults to 1. */
+    minuteStep?: number;
+    /** Placeholder text displayed when no range is selected */
+    placeholder?: string;
+    /** Name attribute applied to the "from" hidden input for native forms */
+    nameFrom?: string;
+    /** Name attribute applied to the "to" hidden input for native forms */
+    nameTo?: string;
+    /** Disables the picker entirely */
+    disabled?: boolean;
+}
+/**
+ * TimeRangePicker Component
+ * * A dual-state dropdown for selecting a start and end time.
+ * * Features automatic scrolling, safe boundary positioning, and WAI-ARIA compliance.
+ */
+export declare const TimeRangePicker: React.ForwardRefExoticComponent<TimeRangePickerProps & React.RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=TimeRangePicker.d.ts.map

package/dist/types/components/timerangepicker/TimeRangePicker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimeRangePicker.d.ts","sourceRoot":"","sources":["../../../../src/components/timerangepicker/TimeRangePicker.tsx"],"names":[],"mappings":"AAEA,OAAO,KAQN,MAAM,OAAO,CAAC;AAGf,OAAO,uBAAuB,CAAC;AA2C/B,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,oBAAqB,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,cAAc,CAAC;IAC7H,mCAAmC;IACnC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,6CAA6C;IAC7C,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,SAAS,KAAK,IAAI,CAAC;IAElC,gEAAgE;IAChE,SAAS,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC;IACpB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAMD;;;;GAIG;AACH,eAAO,MAAM,eAAe,6FA2S1B,CAAC"}

package/dist/types/components/toast/Toast.d.ts

@@ -1,16 +1,32 @@
 import { default as React } from 'react';
-interface ToastContextValue {
-    show: (message: string, timeout?: number) => void;
+export type ToastVariant = 'default' | 'success' | 'error' | 'warning';
+export interface ToastOptions {
+    /** Time in milliseconds before the toast auto-dismisses. Set to Infinity to disable. Defaults to 4000. */
+    duration?: number;
+    /** The semantic visual variant of the toast. Defaults to 'default'. */
+    variant?: ToastVariant;
+    /** Secondary descriptive text displayed below the main message. */
+    description?: React.ReactNode;
 }
-interface ToastProps {
+export interface ToastData extends ToastOptions {
     id: string;
-    message: string;
-    onClose: (id: string) => void;
+    message: React.ReactNode;
+}
+interface ToastContextValue {
+    /** Displays a new toast notification and returns its unique ID */
+    show: (message: React.ReactNode, options?: ToastOptions) => string;
+    /** Programmatically triggers the exit animation and removes the toast by ID */
+    dismiss: (id: string) => void;
 }
-export declare function Toast({ id, message, onClose }: ToastProps): import("react/jsx-runtime").JSX.Element;
+export declare function useToast(): ToastContextValue;
+/**
+ * Toast Provider
+ * * Wraps your application to provide the `useToast` hook.
+ * * Automatically manages the WAI-ARIA live region Portal for rendering notifications.
+ * * Note: Does not use `forwardRef` as it strictly returns a Context Provider and a Portal.
+ */
 export declare function ToastProvider({ children }: {
     children: React.ReactNode;
 }): import("react/jsx-runtime").JSX.Element;
-export declare function useToast(): ToastContextValue;
 export {};
 //# sourceMappingURL=Toast.d.ts.map

package/dist/types/components/toast/Toast.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Toast.d.ts","sourceRoot":"","sources":["../../../../src/components/toast/Toast.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAA2D,MAAM,OAAO,CAAC;AAEhF,OAAO,aAAa,CAAC;AAOrB,UAAU,iBAAiB;IACzB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CACnD;AAED,UAAU,UAAU;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/B;AAED,wBAAgB,KAAK,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,UAAU,2CAazD;AAID,wBAAgB,aAAa,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,2CAoCxE;AAED,wBAAgB,QAAQ,sBAIvB"}
+{"version":3,"file":"Toast.d.ts","sourceRoot":"","sources":["../../../../src/components/toast/Toast.tsx"],"names":[],"mappings":"AAEA,OAAO,KAA8E,MAAM,OAAO,CAAC;AAGnG,OAAO,aAAa,CAAC;AAMrB,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;AAEvE,MAAM,WAAW,YAAY;IAC3B,0GAA0G;IAC1G,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,mEAAmE;IACnE,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,SAAU,SAAQ,YAAY;IAC7C,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC;CAC1B;AAED,UAAU,iBAAiB;IACzB,kEAAkE;IAClE,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,YAAY,KAAK,MAAM,CAAC;IACnE,+EAA+E;IAC/E,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/B;AAQD,wBAAgB,QAAQ,sBAIvB;AAMD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,2CAuDxE"}

package/dist/types/components/tooltip/Tooltip.d.ts

@@ -1,10 +1,21 @@
 import { default as React } from 'react';
+export type TooltipPlacement = 'top' | 'bottom';
 export interface TooltipProps {
-    label: string;
-    children: React.ReactNode;
+    /** The text or content displayed inside the tooltip */
+    label: React.ReactNode;
+    /** The trigger element. Must be a single valid React Element (like a button) */
+    children: React.ReactElement;
+    /** Additional CSS classes for the tooltip container */
     className?: string;
+    /** Delay in milliseconds before showing the tooltip on hover/focus. Defaults to 200. */
     delay?: number;
+    /** Distance in pixels between the tooltip and the trigger. Defaults to 8. */
     offset?: number;
 }
+/**
+ * Tooltip Component
+ * * A contextual popup that displays information when hovering or focusing an element.
+ * * Uses a custom math engine to calculate collision-safe positioning and dynamic arrow rendering.
+ */
 export declare function Tooltip({ label, children, className, delay, offset, }: TooltipProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=Tooltip.d.ts.map

package/dist/types/components/tooltip/Tooltip.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Tooltip.d.ts","sourceRoot":"","sources":["../../../../src/components/tooltip/Tooltip.tsx"],"names":[],"mappings":"AAAA,OAAO,KAON,MAAM,OAAO,CAAC;AACf,OAAO,eAAe,CAAC;AAKvB,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,OAAO,CAAC,EACtB,KAAK,EACL,QAAQ,EACR,SAAc,EACd,KAAW,EACX,MAAU,GACX,EAAE,YAAY,2CAkId"}
+{"version":3,"file":"Tooltip.d.ts","sourceRoot":"","sources":["../../../../src/components/tooltip/Tooltip.tsx"],"names":[],"mappings":"AAEA,OAAO,KAON,MAAM,OAAO,CAAC;AAGf,OAAO,eAAe,CAAC;AAMvB,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEhD,MAAM,WAAW,YAAY;IAC3B,uDAAuD;IACvD,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,gFAAgF;IAChF,QAAQ,EAAE,KAAK,CAAC,YAAY,CAAC;IAC7B,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wFAAwF;IACxF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAMD;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,EACtB,KAAK,EACL,QAAQ,EACR,SAAS,EACT,KAAW,EACX,MAAU,GACX,EAAE,YAAY,2CAiLd"}

package/dist/types/components/treeview/TreeView.d.ts

@@ -1,16 +1,30 @@
 import { default as React } from 'react';
 export interface TreeNode {
+    /** Unique identifier for the node */
     id: string;
-    label: string;
+    /** Text or element to display */
+    label: React.ReactNode;
+    /** Optional icon to display next to the label */
     icon?: React.ReactNode;
+    /** Nested children nodes */
     children?: TreeNode[];
+    /** Prevents interaction and applies muted styles */
+    disabled?: boolean;
 }
-interface TreeViewProps {
+export interface TreeViewProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onSelect'> {
+    /** The hierarchical data structure to render */
     data: TreeNode[];
+    /** The ID of the currently selected node (Controlled) */
     selectedId?: string;
-    onSelect?: (id: string) => void;
-    className?: string;
+    /** Array of node IDs to expand by default on initial render */
+    defaultExpandedIds?: string[];
+    /** Callback fired when a node is selected */
+    onSelect?: (id: string, node: TreeNode) => void;
 }
-export declare function TreeView({ data, selectedId, onSelect, className, }: TreeViewProps): import("react/jsx-runtime").JSX.Element;
-export {};
+/**
+ * TreeView Component
+ * * A hierarchical list display with nested collapsible folders.
+ * * Fully WAI-ARIA compliant with a smart roving tabindex for keyboard navigation.
+ */
+export declare const TreeView: React.ForwardRefExoticComponent<TreeViewProps & React.RefAttributes<HTMLDivElement>>;
 //# sourceMappingURL=TreeView.d.ts.map

package/dist/types/components/treeview/TreeView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TreeView.d.ts","sourceRoot":"","sources":["../../../../src/components/treeview/TreeView.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAmB,MAAM,OAAO,CAAC;AACxC,OAAO,gBAAgB,CAAC;AAExB,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC;CACvB;AAED,UAAU,aAAa;IACrB,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,QAAQ,CAAC,EACvB,IAAI,EACJ,UAAU,EACV,QAAQ,EACR,SAAc,GACf,EAAE,aAAa,2CA8Kf"}
+{"version":3,"file":"TreeView.d.ts","sourceRoot":"","sources":["../../../../src/components/treeview/TreeView.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAoD,MAAM,OAAO,CAAC;AAEzE,OAAO,gBAAgB,CAAC;AAMxB,MAAM,WAAW,QAAQ;IACvB,qCAAqC;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,iCAAiC;IACjC,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,iDAAiD;IACjD,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC;IACtB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,aAAc,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,UAAU,CAAC;IAC3F,gDAAgD;IAChD,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC;CACjD;AAMD;;;;GAIG;AACH,eAAO,MAAM,QAAQ,sFA8LnB,CAAC"}

package/dist/types/components/virtuallist/VirtualList.d.ts

@@ -1,23 +1,19 @@
 import { default as React } from 'react';
-export interface VirtualListProps<T> {
+export interface VirtualListProps<T> extends Omit<React.HTMLAttributes<HTMLDivElement>, 'children'> {
+    /** Array of data items to render */
     items: T[];
-    /** Height of the viewport container */
+    /** Height of the scrollable viewport in pixels */
     height: number;
-    /** Fixed height for each row */
+    /** Fixed height for each row in pixels. Defaults to 40. */
     itemHeight?: number;
-    /** Renderer function */
+    /** Extra rows to render above and below the viewport to prevent white flashes during fast scrolling */
+    overscan?: number;
+    /** Extracts a unique React key for each item. Crucial for stable rendering during sorts/filters! */
+    keyExtractor?: (item: T, index: number) => string | number;
+    /** The render function for the row */
     renderItem: (item: T, index: number) => React.ReactNode;
-    /** Optional class */
-    className?: string;
 }
-/**
- * Virtualized List (Fixed Row Height)
- * -----------------------------------
- * • Ultra-fast
- * • Handles 10k+ rows easily
- * • Smooth scroll
- * • Zero dependencies
- * • Precision scrolling
- */
-export declare function VirtualList<T>({ items, height, itemHeight, renderItem, className, }: VirtualListProps<T>): import("react/jsx-runtime").JSX.Element;
+export declare const VirtualList: <T>(props: VirtualListProps<T> & {
+    ref?: React.ForwardedRef<HTMLDivElement>;
+}) => React.ReactElement;
 //# sourceMappingURL=VirtualList.d.ts.map

package/dist/types/components/virtuallist/VirtualList.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VirtualList.d.ts","sourceRoot":"","sources":["../../../../src/components/virtuallist/VirtualList.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAyD,MAAM,OAAO,CAAC;AAC9E,OAAO,mBAAmB,CAAC;AAE3B,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wBAAwB;IACxB,UAAU,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,KAAK,CAAC,SAAS,CAAC;IACxD,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,EAC7B,KAAK,EACL,MAAM,EACN,UAAe,EACf,UAAU,EACV,SAAc,GACf,EAAE,gBAAgB,CAAC,CAAC,CAAC,2CA6DrB"}
+{"version":3,"file":"VirtualList.d.ts","sourceRoot":"","sources":["../../../../src/components/virtuallist/VirtualList.tsx"],"names":[],"mappings":"AAEA,OAAO,KAA6D,MAAM,OAAO,CAAC;AAElF,OAAO,mBAAmB,CAAC;AAM3B,MAAM,WAAW,gBAAgB,CAAC,CAAC,CAAE,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,UAAU,CAAC;IACjG,oCAAoC;IACpC,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uGAAuG;IACvG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oGAAoG;IACpG,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,MAAM,CAAC;IAC3D,sCAAsC;IACtC,UAAU,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,KAAK,CAAC,SAAS,CAAC;CACzD;AAqHD,eAAO,MAAM,WAAW,EAAmC,CAAC,CAAC,EAC3D,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG;IAAE,GAAG,CAAC,EAAE,KAAK,CAAC,YAAY,CAAC,cAAc,CAAC,CAAA;CAAE,KACtE,KAAK,CAAC,YAAY,CAAC"}

package/dist/types/index.d.ts

@@ -1,3 +1,4 @@
+export * from './components/nuiprovider/NUIProvider';
 export * from './components/button/Button';
 export * from './components/modal/Modal';
 export * from './components/dropdown/Dropdown';
@@ -28,8 +29,6 @@ export * from './components/megamenu/MegaMenu';
 export * from './components/layout/Container';
 export * from './components/layout/Grid';
 export * from './components/layout/Flex';
-export * from './components/layout/Stack';
-export * from './components/layout/HStack';
 export * from './components/textarea/Textarea';
 export * from './components/popover/Popover';
 export * from './components/pagination/Pagination';
@@ -46,6 +45,11 @@ export * from './components/commandpalette/CommandPalette';
 export * from './components/treeview/TreeView';
 export * from './components/datagrid/DataGrid';
 export * from './components/virtuallist/VirtualList';
-export * from './theme/NUIProvider';
-export * from './theme/useTheme';
+export * from './components/timepicker/TimePicker';
+export * from './components/timerangepicker/TimeRangePicker';
+export * from './components/multiselect/MultiSelect';
+export * from './components/resizable/Resizable';
+export * from './components/link/Link';
+export * from './components/dialog/dialogStore';
+export * from './components/dialog/DialogProvider';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,eAAe,CAAC;AAEvB,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0BAA0B,CAAC;AACzC,cAAc,kCAAkC,CAAC;AACjD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oCAAoC,CAAC;AACnD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oCAAoC,CAAC;AACnD,cAAc,8CAA8C,CAAC;AAC7D,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iCAAiC,CAAC;AAChD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oCAAoC,CAAC;AACnD,cAAc,sCAAsC,CAAC;AACrD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kCAAkC,CAAC;AACjD,cAAc,wCAAwC,CAAC;AACvD,cAAc,sCAAsC,CAAC;AACrD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,sCAAsC,CAAC;AAGrD,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,oBAAoB,CAAC;AAC5B,OAAO,oBAAoB,CAAC;AAC5B,OAAO,wBAAwB,CAAC;AAIhC,cAAc,sCAAsC,CAAC;AACrD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0BAA0B,CAAC;AACzC,cAAc,kCAAkC,CAAC;AACjD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oCAAoC,CAAC;AACnD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oCAAoC,CAAC;AACnD,cAAc,8CAA8C,CAAC;AAC7D,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iCAAiC,CAAC;AAChD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oCAAoC,CAAC;AACnD,cAAc,sCAAsC,CAAC;AACrD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kCAAkC,CAAC;AACjD,cAAc,wCAAwC,CAAC;AACvD,cAAc,sCAAsC,CAAC;AACrD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,sCAAsC,CAAC;AACrD,cAAc,oCAAoC,CAAC;AACnD,cAAc,8CAA8C,CAAC;AAC7D,cAAc,sCAAsC,CAAC;AACrD,cAAc,kCAAkC,CAAC;AACjD,cAAc,wBAAwB,CAAC;AACvC,cAAc,iCAAiC,CAAC;AAChD,cAAc,oCAAoC,CAAC"}

package/dist/types/utils/cn/cn.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Represents a dictionary of class names where the key is the class string
+ * and the value is a boolean (or nullish) indicating if it should be applied.
+ */
+type ClassDictionary = Record<string, boolean | undefined | null>;
+/**
+ * A recursive type representing the valid inputs for the cn utility.
+ * Accepts strings, numbers, booleans, null/undefined, dictionaries, or an array of these.
+ */
+export type ClassValue = string | number | boolean | undefined | null | ClassDictionary | ClassValue[];
+/**
+ * Conditionally joins class names together into a single string.
+ * Evaluates objects for truthy values and recursively flattens nested arrays.
+ * * @param inputs - A variadic list of class values to evaluate and merge.
+ * @returns A space-separated string of the active class names.
+ */
+export declare function cn(...inputs: ClassValue[]): string;
+export {};
+//# sourceMappingURL=cn.d.ts.map

package/dist/types/utils/cn/cn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cn.d.ts","sourceRoot":"","sources":["../../../../src/utils/cn/cn.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,KAAK,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI,CAAC,CAAC;AAElE;;;GAGG;AACH,MAAM,MAAM,UAAU,GAClB,MAAM,GACN,MAAM,GACN,OAAO,GACP,SAAS,GACT,IAAI,GACJ,eAAe,GACf,UAAU,EAAE,CAAC;AAEjB;;;;;GAKG;AACH,wBAAgB,EAAE,CAAC,GAAG,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CA+BlD"}

package/dist/types/utils/generateid/generateId.d.ts

@@ -1,2 +1,9 @@
+/**
+ * Generates a unique, alphanumeric identifier with a specific prefix.
+ * Useful for linking DOM elements (e.g., matching a <label> to an <input>).
+ *
+ * @param prefix - The string to prepend to the generated random string.
+ * @returns A unique identifier string in the format `prefix-xxxxxx`.
+ */
 export declare function generateId(prefix: string): string;
 //# sourceMappingURL=generateId.d.ts.map

package/dist/types/utils/generateid/generateId.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generateId.d.ts","sourceRoot":"","sources":["../../../../src/utils/generateid/generateId.ts"],"names":[],"mappings":"AAAA,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,UAExC"}
+{"version":3,"file":"generateId.d.ts","sourceRoot":"","sources":["../../../../src/utils/generateid/generateId.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEjD"}

package/dist/types/utils/index.d.ts

@@ -6,4 +6,6 @@ export * from './portal/portal';
 export * from './restorefocus/restoreFocus';
 export * from './scrolllock/scrollLock';
 export * from './trapfocus/trapFocus';
+export * from './cn/cn';
+export * from './slot/slot';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iCAAiC,CAAC;AAChD,cAAc,iBAAiB,CAAC;AAChC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iCAAiC,CAAC;AAChD,cAAc,iBAAiB,CAAC;AAChC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC"}

package/dist/types/utils/inertmanager/inertManager.d.ts

@@ -8,6 +8,19 @@
  *
  * This is REQUIRED for WCAG-level dialog compliance.
  */
+/**
+ * Applies `inert` and `aria-hidden` attributes to all sibling elements of the provided modal.
+ * This ensures focus is trapped and the rest of the page is hidden from screen readers.
+ *
+ * @param modalElement - The modal or overlay HTML element whose siblings should be disabled.
+ * @returns An array of the HTMLElements that were modified, which is needed for cleanup.
+ */
 export declare function applyInertToSiblings(modalElement: HTMLElement): HTMLElement[];
+/**
+ * Restores previously disabled sibling elements to their normal interactive state
+ * by removing the `inert` and `aria-hidden` attributes.
+ *
+ * @param elements - The array of HTMLElements previously modified by `applyInertToSiblings`.
+ */
 export declare function removeInertFromSiblings(elements: HTMLElement[]): void;
 //# sourceMappingURL=inertManager.d.ts.map

package/dist/types/utils/inertmanager/inertManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inertManager.d.ts","sourceRoot":"","sources":["../../../../src/utils/inertmanager/inertManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,WAAW,iBAe7D;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,WAAW,EAAE,QAK9D"}
+{"version":3,"file":"inertManager.d.ts","sourceRoot":"","sources":["../../../../src/utils/inertmanager/inertManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,WAAW,GAAG,WAAW,EAAE,CAe7E;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI,CAKrE"}

package/dist/types/utils/keyboardnav/keyboardNav.d.ts

@@ -1,11 +1,22 @@
 /**
- * createKeyboardNavigation
- * -------------------------
- * Enables arrow-key navigation between items.
- * Compliant with WAI-ARIA authoring practices.
+ * Configuration options for the keyboard navigation utility.
  */
-export declare function createKeyboardNavigation(options: {
+export interface KeyboardNavigationOptions {
+    /** Array of focusable HTML elements to navigate between. */
     items: HTMLElement[];
+    /** Callback function triggered when an item is selected via Enter or Space key. */
     onSelect: (index: number) => void;
-}): (e: KeyboardEvent) => void;
+}
+/**
+ * createKeyboardNavigation
+ * -------------------------
+ * Creates a keyboard event handler that enables arrow-key navigation
+ * between a provided list of HTML elements. It supports wrapping from
+ * the last item to the first, and vice versa.
+ * * Compliant with basic WAI-ARIA authoring practices for list/menu navigation.
+ *
+ * @param options - The configuration options containing the items and selection callback.
+ * @returns A function meant to be attached to a 'keydown' event listener.
+ */
+export declare function createKeyboardNavigation(options: KeyboardNavigationOptions): (e: KeyboardEvent) => void;
 //# sourceMappingURL=keyboardNav.d.ts.map

package/dist/types/utils/keyboardnav/keyboardNav.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"keyboardNav.d.ts","sourceRoot":"","sources":["../../../../src/utils/keyboardnav/keyboardNav.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE;IAChD,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC,IACkB,GAAG,aAAa,UAqBlC"}
+{"version":3,"file":"keyboardNav.d.ts","sourceRoot":"","sources":["../../../../src/utils/keyboardnav/keyboardNav.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,4DAA4D;IAC5D,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,mFAAmF;IACnF,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,yBAAyB,IACxD,GAAG,aAAa,UAqBlC"}

package/dist/types/utils/onclickoutside/onClickOutside.d.ts

@@ -1,3 +1,11 @@
 import { default as React } from 'react';
-export declare function onClickOutside<T extends HTMLElement>(ref: React.RefObject<T | null>, handler: () => void): () => void;
+/**
+ * Executes a callback handler when the user clicks or taps outside of the referenced element(s).
+ * Supports both single DOM elements and arrays of elements (useful for complex UI like modals or dropdowns with triggers).
+ *
+ * @param refs - A single React ref or an array of React refs representing the elements to ignore.
+ * @param handler - The callback function to execute when an outside click/tap is detected.
+ * @returns A cleanup function that removes the attached event listeners.
+ */
+export declare function onClickOutside(refs: React.RefObject<HTMLElement | null> | Array<React.RefObject<HTMLElement | null>>, handler: (e: MouseEvent | TouchEvent) => void): () => void;
 //# sourceMappingURL=onClickOutside.d.ts.map

package/dist/types/utils/onclickoutside/onClickOutside.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"onClickOutside.d.ts","sourceRoot":"","sources":["../../../../src/utils/onclickoutside/onClickOutside.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,wBAAgB,cAAc,CAAC,CAAC,SAAS,WAAW,EAClD,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,GAAG,IAAI,CAAC,EAC9B,OAAO,EAAE,MAAM,IAAI,cAWpB"}
+{"version":3,"file":"onClickOutside.d.ts","sourceRoot":"","sources":["../../../../src/utils/onclickoutside/onClickOutside.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC,EACtF,OAAO,EAAE,CAAC,CAAC,EAAE,UAAU,GAAG,UAAU,KAAK,IAAI,cA0B9C"}

package/dist/types/utils/portal/portal.d.ts

@@ -1,4 +1,17 @@
+import { default as React } from 'react';
+/**
+ * Portal Component
+ * ----------------
+ * Safely escapes the current React DOM hierarchy and renders children directly into `document.body`.
+ * Essential for building overlays, modals, tooltips, and dropdowns that need to break out of
+ * `overflow: hidden` containers and manage global z-index layering.
+ * * Note: In SSR environments, the parent consuming this component should ensure it is only
+ * rendered on the client (e.g., using a `mounted` state) to prevent hydration errors.
+ *
+ * @param props.children - The React nodes to be portaled to the document body.
+ * @returns A React Portal directly targeting `document.body`.
+ */
 export declare function Portal({ children }: {
     children: React.ReactNode;
-}): import('react').ReactPortal;
+}): React.ReactPortal;
 //# sourceMappingURL=portal.d.ts.map

package/dist/types/utils/portal/portal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"portal.d.ts","sourceRoot":"","sources":["../../../../src/utils/portal/portal.ts"],"names":[],"mappings":"AAQA,wBAAgB,MAAM,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,+BAEjE"}
+{"version":3,"file":"portal.d.ts","sourceRoot":"","sources":["../../../../src/utils/portal/portal.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,qBAEjE"}

package/dist/types/utils/restorefocus/restoreFocus.d.ts

@@ -1,8 +1,12 @@
 /**
- * restoreFocus
- * -------------
- * Restores focus to a previously focused element.
- * Required for WCAG compliance on modals/dialogs.
+ * Restores keyboard focus to a previously focused element.
+ * --------------------------------------------------------
+ * This is a strict WCAG accessibility requirement for modals, dialogs, and popovers.
+ * When an overlay closes, the user's focus must be returned to the element
+ * that originally triggered the overlay, preventing screen readers and keyboard
+ * users from losing their place on the page.
+ *
+ * @param element - The HTML element to receive focus. Safely ignores `null` or `undefined`.
  */
 export declare function restoreFocus(element: HTMLElement | null): void;
 //# sourceMappingURL=restoreFocus.d.ts.map

package/dist/types/utils/restorefocus/restoreFocus.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"restoreFocus.d.ts","sourceRoot":"","sources":["../../../../src/utils/restorefocus/restoreFocus.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,QAEvD"}
+{"version":3,"file":"restoreFocus.d.ts","sourceRoot":"","sources":["../../../../src/utils/restorefocus/restoreFocus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI,CAE9D"}

package/dist/types/utils/scrolllock/scrollLock.d.ts

@@ -1,11 +1,19 @@
 /**
  * scrollLock
  * ----------
- * Locks page scrolling while overlays are open.
- * Prevents background content movement.
+ * Utility to temporarily disable document scrolling.
+ * Essential for maintaining context when modals, drawers, or fullscreen overlays are open.
+ * Prevents the background content from moving while the user interacts with the overlay.
  */
 export declare const scrollLock: {
+    /**
+     * Locks the page scroll by applying `overflow: hidden` directly to the body's inline style.
+     */
     lock(): void;
+    /**
+     * Unlocks the page scroll by clearing the inline `overflow` style.
+     * This allows the body to fall back to its default state defined in the CSS stylesheets.
+     */
     unlock(): void;
 };
 //# sourceMappingURL=scrollLock.d.ts.map

package/dist/types/utils/scrolllock/scrollLock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scrollLock.d.ts","sourceRoot":"","sources":["../../../../src/utils/scrolllock/scrollLock.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,UAAU;;;CAOtB,CAAC"}
+{"version":3,"file":"scrollLock.d.ts","sourceRoot":"","sources":["../../../../src/utils/scrolllock/scrollLock.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,UAAU;IACrB;;OAEG;YACK,IAAI;IAIZ;;;OAGG;cACO,IAAI;CAGf,CAAC"}

package/dist/types/utils/slot/slot.d.ts

@@ -0,0 +1,12 @@
+import { default as React } from 'react';
+export declare const Slottable: {
+    ({ children }: {
+        children: React.ReactNode;
+    }): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export interface SlotProps extends React.HTMLAttributes<HTMLElement> {
+    children?: React.ReactNode;
+}
+export declare const Slot: React.ForwardRefExoticComponent<SlotProps & React.RefAttributes<HTMLElement>>;
+//# sourceMappingURL=slot.d.ts.map

package/dist/types/utils/slot/slot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slot.d.ts","sourceRoot":"","sources":["../../../../src/utils/slot/slot.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAmE1B,eAAO,MAAM,SAAS;mBAAkB;QAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;KAAE;;CAEpE,CAAC;AAgCF,MAAM,WAAW,SAAU,SAAQ,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC;IAClE,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAED,eAAO,MAAM,IAAI,+EAuCf,CAAC"}

package/dist/types/utils/trapfocus/trapFocus.d.ts

@@ -1,8 +1,12 @@
 /**
  * trapFocus
  * ---------
- * WCAG-compliant focus trap for modals, dialogs, menus.
- * Prevents keyboard users from escaping the component.
+ * A WCAG-compliant focus trap utility for modals, dialogs, and off-canvas menus.
+ * Prevents keyboard-only users (and screen readers) from tabbing out of the active
+ * component and interacting with background elements.
+ *
+ * @param container - The DOM element containing the focusable items.
+ * @returns A cleanup function to remove the 'keydown' event listener when the container unmounts.
  */
 export declare function trapFocus(container: HTMLElement): () => void;
 //# sourceMappingURL=trapFocus.d.ts.map