@nofinite/nui 1.1.2 → 2.0.0

package/dist/types/components/alert/Alert.d.ts

@@ -1,13 +1,26 @@
 import { default as React } from 'react';
-type AlertType = 'info' | 'success' | 'warning' | 'error';
-interface AlertProps {
-    type?: AlertType;
-    title?: string;
+type AlertVariant = 'info' | 'success' | 'warning' | 'error';
+/**
+ * We Omit 'title' from the standard HTML attributes because the native HTML 'title'
+ * expects a string (for native tooltips). We override it here to accept ReactNode,
+ * allowing for rich text, icons, or custom JSX inside the alert's title area.
+ */
+interface AlertProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'title'> {
+    variant?: AlertVariant;
+    title?: React.ReactNode;
     children?: React.ReactNode;
+    /** Determines if the close icon button is rendered */
     closable?: boolean;
+    /** Callback fired when the close button is clicked.
+     * Note: The component is controlled; it does not unmount itself.
+     */
     onClose?: () => void;
     className?: string;
 }
-export declare function Alert({ type, title, children, closable, onClose, className, }: AlertProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Alert Component
+ * * Used to communicate important messages to the user.
+ */
+export declare function Alert({ variant, title, children, closable, onClose, className, ...props }: AlertProps): import("react/jsx-runtime").JSX.Element;
 export {};
 //# sourceMappingURL=Alert.d.ts.map

package/dist/types/components/alert/Alert.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Alert.d.ts","sourceRoot":"","sources":["../../../../src/components/alert/Alert.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,aAAa,CAAC;AAErB,KAAK,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAE1D,UAAU,UAAU;IAClB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,KAAK,CAAC,EACpB,IAAa,EACb,KAAK,EACL,QAAQ,EACR,QAAgB,EAChB,OAAO,EACP,SAAc,GACf,EAAE,UAAU,2CAyBZ"}
+{"version":3,"file":"Alert.d.ts","sourceRoot":"","sources":["../../../../src/components/alert/Alert.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,aAAa,CAAC;AAErB,KAAK,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAE7D;;;;GAIG;AACH,UAAU,UAAW,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAC9E,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,sDAAsD;IACtD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,EACpB,OAAgB,EAChB,KAAK,EACL,QAAQ,EACR,QAAgB,EAChB,OAAO,EACP,SAAS,EACT,GAAG,KAAK,EACT,EAAE,UAAU,2CAmCZ"}

package/dist/types/components/avatar/Avatar.d.ts

@@ -1,18 +1,22 @@
 import { default as React } from 'react';
-type AvatarSize = 'sm' | 'md' | 'lg' | 'xl';
-type AvatarShape = 'circle' | 'rounded' | 'square';
-type Status = 'online' | 'offline' | 'busy' | undefined;
-interface AvatarProps {
+export type AvatarSize = 'sm' | 'md' | 'lg' | 'xl';
+export type AvatarShape = 'circle' | 'rounded' | 'square';
+export type AvatarStatus = 'online' | 'offline' | 'busy' | 'away';
+export interface AvatarProps extends React.HTMLAttributes<HTMLDivElement> {
     src?: string;
     alt?: string;
     name?: string;
     size?: AvatarSize;
     shape?: AvatarShape;
-    status?: Status;
+    status?: AvatarStatus;
+    fallbackIcon?: React.ReactNode;
     loading?: boolean;
     className?: string;
-    fallbackIcon?: React.ReactNode;
 }
-export declare function Avatar({ src, alt, name, size, shape, status, loading, className, fallbackIcon, }: AvatarProps): import("react/jsx-runtime").JSX.Element;
-export {};
+/**
+ * Avatar Component
+ * * A visual representation of a user or entity.
+ * Implements a strict fallback sequence: Image -> Initials -> Fallback Icon -> Default Icon.
+ */
+export declare function Avatar({ src, alt, name, size, shape, status, fallbackIcon, loading, className, ...props }: AvatarProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=Avatar.d.ts.map

package/dist/types/components/avatar/Avatar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Avatar.d.ts","sourceRoot":"","sources":["../../../../src/components/avatar/Avatar.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAmB,MAAM,OAAO,CAAC;AACxC,OAAO,cAAc,CAAC;AAEtB,KAAK,UAAU,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAC5C,KAAK,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;AACnD,KAAK,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;AAExD,UAAU,WAAW;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAChC;AASD,wBAAgB,MAAM,CAAC,EACrB,GAAG,EACH,GAAG,EACH,IAAI,EACJ,IAAW,EACX,KAAgB,EAChB,MAAM,EACN,OAAe,EACf,SAAc,EACd,YAAY,GACb,EAAE,WAAW,2CA6Cb"}
+{"version":3,"file":"Avatar.d.ts","sourceRoot":"","sources":["../../../../src/components/avatar/Avatar.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAmB,MAAM,OAAO,CAAC;AAExC,OAAO,cAAc,CAAC;AAEtB,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AACnD,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;AAC1D,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;AAElE,MAAM,WAAW,WAAY,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IACvE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,YAAY,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAcD;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,EACrB,GAAG,EACH,GAAG,EACH,IAAI,EACJ,IAAW,EACX,KAAgB,EAChB,MAAM,EACN,YAAY,EACZ,OAAO,EACP,SAAS,EACT,GAAG,KAAK,EACT,EAAE,WAAW,2CAmDb"}

package/dist/types/components/avatar/AvatarGroup.d.ts

@@ -1,10 +1,17 @@
 import { default as React } from 'react';
-interface AvatarGroupProps {
-    children: React.ReactNode[];
+import { AvatarSize } from './Avatar';
+interface AvatarGroupProps extends React.HTMLAttributes<HTMLDivElement> {
+    children?: React.ReactNode;
+    /** Maximum number of avatars to display before truncating */
     max?: number;
-    size?: 'sm' | 'md' | 'lg' | 'xl';
+    /** Size passed down to all nested Avatar components */
+    size?: AvatarSize;
     className?: string;
 }
-export declare function AvatarGroup({ children, max, size, className, }: AvatarGroupProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * AvatarGroup Component
+ * * Visually groups multiple Avatar components together, handling truncation and overlapping.
+ */
+export declare function AvatarGroup({ children, max, size, className, ...props }: AvatarGroupProps): import("react/jsx-runtime").JSX.Element;
 export {};
 //# sourceMappingURL=AvatarGroup.d.ts.map

package/dist/types/components/avatar/AvatarGroup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AvatarGroup.d.ts","sourceRoot":"","sources":["../../../../src/components/avatar/AvatarGroup.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,cAAc,CAAC;AAEtB,UAAU,gBAAgB;IACxB,QAAQ,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,WAAW,CAAC,EAC1B,QAAQ,EACR,GAAO,EACP,IAAW,EACX,SAAc,GACf,EAAE,gBAAgB,2CAwBlB"}
+{"version":3,"file":"AvatarGroup.d.ts","sourceRoot":"","sources":["../../../../src/components/avatar/AvatarGroup.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,UAAU,EAAe,MAAM,UAAU,CAAC;AACnD,OAAO,cAAc,CAAC;AAEtB,UAAU,gBAAiB,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IACrE,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,6DAA6D;IAC7D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,EAC1B,QAAQ,EACR,GAAO,EACP,IAAW,EACX,SAAS,EACT,GAAG,KAAK,EACT,EAAE,gBAAgB,2CAkClB"}

package/dist/types/components/badge/Badge.d.ts

@@ -1,22 +1,30 @@
 import { default as React } from 'react';
-type Variant = 'default' | 'primary' | 'success' | 'warning' | 'danger';
-type Size = 'sm' | 'md' | 'lg';
-interface BadgeProps {
+export type BadgeVariant = 'default' | 'primary' | 'success' | 'warning' | 'danger' | 'outline';
+export type BadgeSize = 'sm' | 'md' | 'lg';
+export interface BadgeProps extends React.HTMLAttributes<HTMLSpanElement> {
     children?: React.ReactNode;
+    /** Displays a numerical count inside the badge */
     count?: number;
+    /** The maximum number to display before showing a '+' (e.g., 99+) */
     max?: number;
-    variant?: Variant;
-    size?: Size;
+    variant?: BadgeVariant;
+    size?: BadgeSize;
+    /** Rounds the edges to create a pill shape */
     pill?: boolean;
+    /** Renders a small, empty circular indicator instead of text */
     dot?: boolean;
+    /** If provided, renders the badge as an <a> tag */
     href?: string;
-    onClick?: () => void;
-    ariaLabel?: string;
-    className?: string;
-    title?: string;
+    /** If provided, renders the badge as a <button> tag */
+    onClick?: React.MouseEventHandler<HTMLElement>;
     iconLeft?: React.ReactNode;
     iconRight?: React.ReactNode;
 }
-export declare function Badge({ children, count, max, variant, size, pill, dot, href, onClick, ariaLabel, className, title, iconLeft, iconRight, }: BadgeProps): import("react/jsx-runtime").JSX.Element;
-export {};
+/**
+ * Badge Component
+ * * A small status descriptor for UI elements.
+ * Architecture Note: Dynamically renders as a <span>, <a>, or <button> based on
+ * the presence of `href` or `onClick` props to ensure strict semantic HTML.
+ */
+export declare function Badge({ children, count, max, variant, size, pill, dot, href, onClick, className, iconLeft, iconRight, ...props }: BadgeProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=Badge.d.ts.map

package/dist/types/components/badge/Badge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Badge.d.ts","sourceRoot":"","sources":["../../../../src/components/badge/Badge.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,aAAa,CAAC;AAErB,KAAK,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AACxE,KAAK,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE/B,UAAU,UAAU;IAClB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAG3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IAEd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IAErB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,SAAS,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC7B;AAkBD,wBAAgB,KAAK,CAAC,EACpB,QAAQ,EACR,KAAK,EACL,GAAG,EACH,OAAmB,EACnB,IAAW,EACX,IAAY,EACZ,GAAW,EACX,IAAI,EACJ,OAAO,EACP,SAAS,EACT,SAAc,EACd,KAAK,EACL,QAAQ,EACR,SAAS,GACV,EAAE,UAAU,2CA4GZ"}
+{"version":3,"file":"Badge.d.ts","sourceRoot":"","sources":["../../../../src/components/badge/Badge.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,aAAa,CAAC;AAErB,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;AAChG,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE3C,MAAM,WAAW,UAAW,SAAQ,KAAK,CAAC,cAAc,CAAC,eAAe,CAAC;IACvE,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,8CAA8C;IAC9C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,gEAAgE;IAChE,GAAG,CAAC,EAAE,OAAO,CAAC;IAEd,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,OAAO,CAAC,EAAE,KAAK,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAE/C,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,SAAS,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC7B;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,EACpB,QAAQ,EACR,KAAK,EACL,GAAQ,EACR,OAAmB,EACnB,IAAW,EACX,IAAY,EACZ,GAAW,EACX,IAAI,EACJ,OAAO,EACP,SAAS,EACT,QAAQ,EACR,SAAS,EACT,GAAG,KAAK,EACT,EAAE,UAAU,2CAkEZ"}

package/dist/types/components/badge/BadgeGroup.d.ts

@@ -1,9 +1,12 @@
 import { default as React } from 'react';
-interface BadgeGroupProps {
-    items: React.ReactNode[];
+interface BadgeGroupProps extends React.HTMLAttributes<HTMLDivElement> {
+    children?: React.ReactNode;
     max?: number;
-    className?: string;
 }
-export declare function BadgeGroup({ items, max, className, }: BadgeGroupProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * BadgeGroup Component
+ * * Visually groups multiple Badges together, handling overflow truncation.
+ */
+export declare function BadgeGroup({ children, max, className, ...props }: BadgeGroupProps): import("react/jsx-runtime").JSX.Element;
 export {};
 //# sourceMappingURL=BadgeGroup.d.ts.map

package/dist/types/components/badge/BadgeGroup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BadgeGroup.d.ts","sourceRoot":"","sources":["../../../../src/components/badge/BadgeGroup.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,UAAU,eAAe;IACvB,KAAK,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,GAAO,EACP,SAAc,GACf,EAAE,eAAe,2CAajB"}
+{"version":3,"file":"BadgeGroup.d.ts","sourceRoot":"","sources":["../../../../src/components/badge/BadgeGroup.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,aAAa,CAAC;AAErB,UAAU,eAAgB,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IAEpE,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,EACzB,QAAQ,EACR,GAAO,EACP,SAAS,EACT,GAAG,KAAK,EACT,EAAE,eAAe,2CAmBjB"}

package/dist/types/components/breadcrumbs/Breadcrumbs.d.ts

@@ -1,15 +1,23 @@
 import { default as React } from 'react';
-export interface Crumb {
+export interface BreadcrumbItem {
     label: React.ReactNode;
+    /** If provided, renders the item as an <a> tag */
     href?: string;
-    onClick?: () => void;
+    /** Triggered when the breadcrumb is clicked */
+    onClick?: (e: React.MouseEvent) => void;
 }
-export interface BreadcrumbsProps {
-    items: Crumb[];
+export interface BreadcrumbsProps extends React.HTMLAttributes<HTMLElement> {
+    items: BreadcrumbItem[];
+    /** The maximum number of items to display before truncating the middle path. Default: 5 */
     maxItems?: number;
+    /** The visual separator between items. Default: '›' */
     separator?: React.ReactNode;
     className?: string;
 }
-export declare function Breadcrumbs({ items, maxItems, // default collapse threshold
-separator, className, }: BreadcrumbsProps): import("react/jsx-runtime").JSX.Element | null;
+/**
+ * Breadcrumbs Component
+ * * A navigation aid that helps users understand their current location within a website.
+ * Implements strict WAI-ARIA navigation patterns.
+ */
+export declare function Breadcrumbs({ items, maxItems, separator, className, ...props }: BreadcrumbsProps): import("react/jsx-runtime").JSX.Element | null;
 //# sourceMappingURL=Breadcrumbs.d.ts.map

package/dist/types/components/breadcrumbs/Breadcrumbs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Breadcrumbs.d.ts","sourceRoot":"","sources":["../../../../src/components/breadcrumbs/Breadcrumbs.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,mBAAmB,CAAC;AAE3B,MAAM,WAAW,KAAK;IACpB,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,KAAK,EAAE,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,WAAW,CAAC,EAC1B,KAAK,EACL,QAAY,EAAE,6BAA6B;AAC3C,SAAe,EACf,SAAc,GACf,EAAE,gBAAgB,kDA4DlB"}
+{"version":3,"file":"Breadcrumbs.d.ts","sourceRoot":"","sources":["../../../../src/components/breadcrumbs/Breadcrumbs.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,mBAAmB,CAAC;AAE3B,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,kDAAkD;IAClD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,UAAU,KAAK,IAAI,CAAC;CACzC;AAED,MAAM,WAAW,gBAAiB,SAAQ,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC;IACzE,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,SAAS,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,EAC1B,KAAK,EACL,QAAY,EACZ,SAAe,EACf,SAAS,EACT,GAAG,KAAK,EACT,EAAE,gBAAgB,kDAgFlB"}

package/dist/types/components/button/Button.d.ts

@@ -1,15 +1,30 @@
 import { default as React } from 'react';
+export type ButtonVariant = 'default' | 'primary' | 'outline' | 'ghost' | 'danger' | 'link';
+export type ButtonSize = 'sm' | 'md' | 'lg' | 'icon';
 export interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
-    /**
-     * Visual appearance of the button.
-     * "default" = subtle background
-     * "primary" = strong emphasis (blue)
+    /** The visual style of the button. */
+    variant?: ButtonVariant;
+    /** The dimensional size of the button (controls padding and height). */
+    size?: ButtonSize;
+    /** Automatically disables the button and replaces the left icon with a loading spinner. */
+    isLoading?: boolean;
+    /** An element (usually an SVG or Icon component) placed before the text. */
+    iconLeft?: React.ReactNode;
+    /** An element (usually an SVG or Icon component) placed after the text. */
+    iconRight?: React.ReactNode;
+    /** * Polymorphic Prop: When true, the button will render as its immediate child element
+     * (e.g., a Next.js `<Link>` or an `<a>` tag) instead of a native `<button>`,
+     * while inheriting all button styles.
      */
-    variant?: 'default' | 'primary';
-    /**
-     * Adjusts padding & font-size.
-     */
-    size?: 'sm' | 'md' | 'lg';
+    asChild?: boolean;
 }
-export declare function Button({ variant, size, className, ...props }: ButtonProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Button Component
+ * ----------------
+ * The primary interactive element for user actions.
+ * * Architecture Note:
+ * - Automatically handles its disabled state when `isLoading` is true to prevent double-submissions.
+ * - Supports polymorphism via the `asChild` prop for seamless router integration.
+ */
+export declare const Button: React.ForwardRefExoticComponent<ButtonProps & React.RefAttributes<HTMLButtonElement>>;
 //# sourceMappingURL=Button.d.ts.map

package/dist/types/components/button/Button.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Button.d.ts","sourceRoot":"","sources":["../../../../src/components/button/Button.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,cAAc,CAAC;AAEtB,MAAM,WAAW,WACf,SAAQ,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC;IACrD;;;;OAIG;IACH,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAEhC;;OAEG;IACH,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;CAC3B;AAED,wBAAgB,MAAM,CAAC,EACrB,OAAmB,EACnB,IAAW,EACX,SAAc,EACd,GAAG,KAAK,EACT,EAAE,WAAW,2CAYb"}
+{"version":3,"file":"Button.d.ts","sourceRoot":"","sources":["../../../../src/components/button/Button.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,cAAc,CAAC;AAEtB,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAC5F,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;AAErD,MAAM,WAAW,WAAY,SAAQ,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC;IAChF,sCAAsC;IACtC,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,wEAAwE;IACxE,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,2FAA2F;IAC3F,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,2EAA2E;IAC3E,SAAS,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC5B;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,MAAM,uFA0DlB,CAAC"}

package/dist/types/components/card/Card.d.ts

@@ -1,27 +1,18 @@
 import { default as React } from 'react';
-interface CardProps {
-    children: React.ReactNode;
-    className?: string;
+export interface CardProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** If true, makes the card interactive via mouse and keyboard (Enter/Space) */
     clickable?: boolean;
+    /** If true, adds a shadow elevation effect on hover */
     hover?: boolean;
-    onClick?: () => void;
 }
-declare function CardRoot({ children, className, clickable, hover, onClick, }: CardProps): import("react/jsx-runtime").JSX.Element;
-declare function Header({ children }: {
-    children: React.ReactNode;
-}): import("react/jsx-runtime").JSX.Element;
-declare function Body({ children }: {
-    children: React.ReactNode;
-}): import("react/jsx-runtime").JSX.Element;
-declare function Footer({ children }: {
-    children: React.ReactNode;
-}): import("react/jsx-runtime").JSX.Element;
-declare function Divider(): import("react/jsx-runtime").JSX.Element;
-export declare const Card: typeof CardRoot & {
-    Header: typeof Header;
-    Body: typeof Body;
-    Footer: typeof Footer;
-    Divider: typeof Divider;
+/**
+ * Compound Component Architecture
+ * Exposes sub-components via dot notation (e.g., <Card.Header>) for a cleaner API.
+ */
+export declare const Card: React.ForwardRefExoticComponent<CardProps & React.RefAttributes<HTMLDivElement>> & {
+    Header: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+    Body: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+    Footer: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+    Divider: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLHRElement> & React.RefAttributes<HTMLHRElement>>;
 };
-export {};
 //# sourceMappingURL=Card.d.ts.map

package/dist/types/components/card/Card.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Card.d.ts","sourceRoot":"","sources":["../../../../src/components/card/Card.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,YAAY,CAAC;AAEpB,UAAU,SAAS;IACjB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED,iBAAS,QAAQ,CAAC,EAChB,QAAQ,EACR,SAAc,EACd,SAAiB,EACjB,KAAa,EACb,OAAO,GACR,EAAE,SAAS,2CAuBX;AAED,iBAAS,MAAM,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,2CAE1D;AAED,iBAAS,IAAI,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,2CAExD;AAED,iBAAS,MAAM,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,2CAE1D;AAED,iBAAS,OAAO,4CAEf;AAED,eAAO,MAAM,IAAI;;;;;CAKf,CAAC"}
+{"version":3,"file":"Card.d.ts","sourceRoot":"","sources":["../../../../src/components/card/Card.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,YAAY,CAAC;AAEpB,MAAM,WAAW,SAAU,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IACrE,+EAA+E;IAC/E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,uDAAuD;IACvD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AA6ED;;;GAGG;AACH,eAAO,MAAM,IAAI;;;;;CAKf,CAAC"}

package/dist/types/components/checkbox/Checkbox.d.ts

@@ -1,15 +1,20 @@
 import { default as React } from 'react';
-interface CheckboxProps {
+export interface CheckboxProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, 'onChange'> {
+    /** If provided, makes the checkbox a controlled component. */
     checked?: boolean;
+    /** If provided, sets the initial state of an uncontrolled checkbox. */
     defaultChecked?: boolean;
+    /** Sets the visual state to mixed/indeterminate. This is visually distinct from checked/unchecked. */
     indeterminate?: boolean;
+    /** Callback fired when the state changes. */
     onChange?: (checked: boolean) => void;
     label?: React.ReactNode;
-    disabled?: boolean;
-    name?: string;
-    value?: string;
-    className?: string;
 }
-export declare function Checkbox({ checked, defaultChecked, indeterminate, onChange, label, disabled, name, value, className, }: CheckboxProps): import("react/jsx-runtime").JSX.Element;
-export {};
+/**
+ * Checkbox Component
+ * * A control that allows the user to toggle between checked and not checked.
+ * Architecture Note: This component seamlessly handles both controlled and uncontrolled
+ * paradigms, and directly manipulates the DOM node to support the HTML5 'indeterminate' property.
+ */
+export declare const Checkbox: React.ForwardRefExoticComponent<CheckboxProps & React.RefAttributes<HTMLInputElement>>;
 //# sourceMappingURL=Checkbox.d.ts.map

package/dist/types/components/checkbox/Checkbox.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Checkbox.d.ts","sourceRoot":"","sources":["../../../../src/components/checkbox/Checkbox.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAA4B,MAAM,OAAO,CAAC;AACjD,OAAO,gBAAgB,CAAC;AAExB,UAAU,aAAa;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAEtC,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,QAAQ,CAAC,EACvB,OAAO,EACP,cAAc,EACd,aAAqB,EACrB,QAAQ,EACR,KAAK,EACL,QAAgB,EAChB,IAAI,EACJ,KAAK,EACL,SAAc,GACf,EAAE,aAAa,2CAkDf"}
+{"version":3,"file":"Checkbox.d.ts","sourceRoot":"","sources":["../../../../src/components/checkbox/Checkbox.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAkD,MAAM,OAAO,CAAC;AAEvE,OAAO,gBAAgB,CAAC;AAExB,MAAM,WAAW,aAAc,SAAQ,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,EAAE,UAAU,CAAC;IAClG,8DAA8D;IAC9D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,uEAAuE;IACvE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,sGAAsG;IACtG,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CACzB;AAED;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,wFA8FpB,CAAC"}

package/dist/types/components/chip/Chip.d.ts

@@ -1,21 +1,24 @@
 import { default as React } from 'react';
-export interface ChipProps {
+export type ChipSize = 'sm' | 'md';
+export interface ChipProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onSelect'> {
     children: React.ReactNode;
-    /** Removable chip — shows close button */
+    /** If true, renders a trailing 'X' button that triggers onRemove */
     removable?: boolean;
-    /** Selected chip state */
+    /** Controls the visual and ARIA active state of the chip */
     selected?: boolean;
-    /** Left icon element */
     iconLeft?: React.ReactNode;
-    /** Right icon element */
     iconRight?: React.ReactNode;
-    /** Chip size */
-    size?: 'sm' | 'md';
-    /** Remove handler */
+    size?: ChipSize;
+    /** Callback fired when the 'X' button is clicked */
     onRemove?: () => void;
-    /** Select handler */
+    /** Callback fired when the main body of the chip is clicked or activated via keyboard */
     onSelect?: () => void;
-    className?: string;
 }
-export declare function Chip({ children, removable, selected, iconLeft, iconRight, size, onRemove, onSelect, className, }: ChipProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Chip Component
+ * * A compact element representing an input, attribute, or action.
+ * Architecture Note: Dynamically switches between a static visual element and an
+ * interactive button role depending on the presence of `onSelect` or `onClick`.
+ */
+export declare const Chip: React.ForwardRefExoticComponent<ChipProps & React.RefAttributes<HTMLDivElement>>;
 //# sourceMappingURL=Chip.d.ts.map

package/dist/types/components/chip/Chip.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Chip.d.ts","sourceRoot":"","sources":["../../../../src/components/chip/Chip.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,YAAY,CAAC;AAEpB,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAE1B,0CAA0C;IAC1C,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,wBAAwB;IACxB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAE3B,yBAAyB;IACzB,SAAS,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAE5B,gBAAgB;IAChB,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAEnB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IAEtB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IAEtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,IAAI,CAAC,EACnB,QAAQ,EACR,SAAiB,EACjB,QAAgB,EAChB,QAAQ,EACR,SAAS,EACT,IAAW,EACX,QAAQ,EACR,QAAQ,EACR,SAAc,GACf,EAAE,SAAS,2CAsCX"}
+{"version":3,"file":"Chip.d.ts","sourceRoot":"","sources":["../../../../src/components/chip/Chip.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAqB,MAAM,OAAO,CAAC;AAE1C,OAAO,YAAY,CAAC;AAEpB,MAAM,MAAM,QAAQ,GAAG,IAAI,GAAG,IAAI,CAAC;AAEnC,MAAM,WAAW,SAAU,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,UAAU,CAAC;IACvF,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,oEAAoE;IACpE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,SAAS,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC5B,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,yFAAyF;IACzF,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB;AAED;;;;;GAKG;AACH,eAAO,MAAM,IAAI,kFAwFhB,CAAC"}

package/dist/types/components/combobox/Combobox.d.ts

@@ -4,21 +4,32 @@ export interface ComboboxOption {
     value: string;
     icon?: React.ReactNode;
 }
-interface ComboboxProps {
+export interface ComboboxProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange' | 'defaultValue'> {
     options: ComboboxOption[];
+    /** Controlled value of the combobox */
     value?: string;
+    /** Initial uncontrolled value */
     defaultValue?: string;
+    /** Callback fired when an option is selected */
     onChange?: (value: string) => void;
     placeholder?: string;
     disabled?: boolean;
-    className?: string;
+    /** Message displayed when filtering returns zero results */
     emptyMessage?: string;
+    /** Custom filter function. Defaults to simple substring matching on the label. */
     filter?: (input: string, option: ComboboxOption) => boolean;
     leftIcon?: React.ReactNode;
     rightIcon?: React.ReactNode;
+    /** Custom renderer for the entire option row */
     renderOption?: (option: ComboboxOption, active: boolean) => React.ReactNode;
+    /** Custom renderer strictly for the option's icon */
     renderOptionIcon?: (option: ComboboxOption) => React.ReactNode;
 }
-export declare function Combobox({ options, value, defaultValue, onChange, placeholder, disabled, className, emptyMessage, filter, leftIcon, rightIcon, renderOption, renderOptionIcon, }: ComboboxProps): import("react/jsx-runtime").JSX.Element;
-export {};
+/**
+ * Combobox Component
+ * * A text input that provides a dropdown list of options to help users enter data.
+ * Architecture Note: Implements the WAI-ARIA Combobox pattern, supporting full keyboard
+ * navigation (Arrow keys, Enter, Escape) and click-outside dismissal.
+ */
+export declare const Combobox: React.ForwardRefExoticComponent<ComboboxProps & React.RefAttributes<HTMLDivElement>>;
 //# sourceMappingURL=Combobox.d.ts.map

package/dist/types/components/combobox/Combobox.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Combobox.d.ts","sourceRoot":"","sources":["../../../../src/components/combobox/Combobox.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;GAMG;AACH;;;;;;;;GAQG;AAEH,OAAO,KAMN,MAAM,OAAO,CAAC;AAEf,OAAO,gBAAgB,CAAC;AAKxB,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CACxB;AAED,UAAU,aAAa;IACrB,OAAO,EAAE,cAAc,EAAE,CAAC;IAE1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAEnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,KAAK,OAAO,CAAC;IAE5D,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,SAAS,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAE5B,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,KAAK,KAAK,CAAC,SAAS,CAAC;IAC5E,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,KAAK,CAAC,SAAS,CAAC;CAChE;AAED,wBAAgB,QAAQ,CAAC,EACvB,OAAO,EACP,KAAK,EACL,YAAY,EACZ,QAAQ,EACR,WAAyB,EACzB,QAAgB,EAChB,SAAc,EACd,YAAiC,EACjC,MAAM,EACN,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,gBAAgB,GACjB,EAAE,aAAa,2CA+Kf"}
+{"version":3,"file":"Combobox.d.ts","sourceRoot":"","sources":["../../../../src/components/combobox/Combobox.tsx"],"names":[],"mappings":"AAEA,OAAO,KAQN,MAAM,OAAO,CAAC;AAEf,OAAO,gBAAgB,CAAC;AAExB,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CACxB;AAED,MAAM,WAAW,aAAc,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,UAAU,GAAG,cAAc,CAAC;IAC5G,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,4DAA4D;IAC5D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kFAAkF;IAClF,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,KAAK,OAAO,CAAC;IAC5D,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,SAAS,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC5B,gDAAgD;IAChD,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,KAAK,KAAK,CAAC,SAAS,CAAC;IAC5E,qDAAqD;IACrD,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,KAAK,CAAC,SAAS,CAAC;CAChE;AAED;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,sFAqNpB,CAAC"}

package/dist/types/components/commandpalette/CommandPalette.d.ts

@@ -3,6 +3,7 @@ export interface CommandItem {
     id: string;
     label: string;
     icon?: ReactNode;
+    /** Displayed as a <kbd> hint, e.g., "⌘ K" */
     shortcut?: string;
     description?: string;
     onSelect?: () => void;
@@ -11,11 +12,19 @@ export interface CommandSection {
     title?: string;
     items: CommandItem[];
 }
-interface CommandPaletteProps {
+export interface CommandPaletteProps {
     sections: CommandSection[];
     placeholder?: string;
     className?: string;
+    /** Forces the palette open/closed. If undefined, it operates purely via Cmd+K internally. */
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
 }
-export declare function CommandPalette({ sections, placeholder, className, }: CommandPaletteProps): import("react/jsx-runtime").JSX.Element | null;
-export {};
+/**
+ * CommandPalette Component
+ * * A fast, composable, unstyled command menu for React.
+ * Architecture Note: Manages a nested data structure (Sections > Items) but mathematically
+ * flattens it for seamless O(1) keyboard navigation across section boundaries.
+ */
+export declare function CommandPalette({ sections, placeholder, className, open: controlledOpen, onOpenChange, }: CommandPaletteProps): import("react/jsx-runtime").JSX.Element | null;
 //# sourceMappingURL=CommandPalette.d.ts.map

package/dist/types/components/commandpalette/CommandPalette.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CommandPalette.d.ts","sourceRoot":"","sources":["../../../../src/components/commandpalette/CommandPalette.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAIL,SAAS,EAEV,MAAM,OAAO,CAAC;AACf,OAAO,sBAAsB,CAAC;AAG9B,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAED,UAAU,mBAAmB;IAC3B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,cAAc,CAAC,EAC7B,QAAQ,EACR,WAAgC,EAChC,SAAc,GACf,EAAE,mBAAmB,kDAmLrB"}
+{"version":3,"file":"CommandPalette.d.ts","sourceRoot":"","sources":["../../../../src/components/commandpalette/CommandPalette.tsx"],"names":[],"mappings":"AAEA,OAAO,EAIL,SAAS,EAGV,MAAM,OAAO,CAAC;AAEf,OAAO,sBAAsB,CAAC;AAM9B,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6FAA6F;IAC7F,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACxC;AAMD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,EAC7B,QAAQ,EACR,WAAgC,EAChC,SAAS,EACT,IAAI,EAAE,cAAc,EACpB,YAAY,GACb,EAAE,mBAAmB,kDA2OrB"}

package/dist/types/components/contextmenu/ContextMenu.d.ts

@@ -1,5 +1,5 @@
 import { ReactNode } from 'react';
-export interface MenuItem {
+export interface ContextMenuItem {
     label?: string;
     icon?: ReactNode;
     onSelect?: () => void;
@@ -7,11 +7,19 @@ export interface MenuItem {
     disabled?: boolean;
     type?: 'item' | 'separator';
 }
-interface ContextMenuProps {
-    trigger: ReactNode;
-    items: MenuItem[];
+export interface ContextMenuProps {
+    children: ReactNode;
+    items: ContextMenuItem[];
     className?: string;
+    /** * If true, the ContextMenu will not wrap children in a <div>.
+     * Instead, it clones the child and directly attaches the onContextMenu event.
+     * Child MUST be a valid single React Element.
+     */
+    asChild?: boolean;
 }
-export declare function ContextMenu({ trigger, items, className, }: ContextMenuProps): import("react/jsx-runtime").JSX.Element;
-export {};
+/**
+ * ContextMenu Component
+ * * A custom right-click menu that replaces the browser's native context menu.
+ */
+export declare function ContextMenu({ children, items, className, asChild, }: ContextMenuProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=ContextMenu.d.ts.map

package/dist/types/components/contextmenu/ContextMenu.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ContextMenu.d.ts","sourceRoot":"","sources":["../../../../src/components/contextmenu/ContextMenu.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH;;;;;;;;;;;GAWG;AAEH,OAAc,EAIZ,SAAS,EAEV,MAAM,OAAO,CAAC;AACf,OAAO,mBAAmB,CAAC;AAG3B,MAAM,WAAW,QAAQ;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;CAC7B;AAED,UAAU,gBAAgB;IACxB,OAAO,EAAE,SAAS,CAAC;IACnB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,WAAW,CAAC,EAC1B,OAAO,EACP,KAAK,EACL,SAAc,GACf,EAAE,gBAAgB,2CAwJlB"}
+{"version":3,"file":"ContextMenu.d.ts","sourceRoot":"","sources":["../../../../src/components/contextmenu/ContextMenu.tsx"],"names":[],"mappings":"AAEA,OAAc,EAKZ,SAAS,EAEV,MAAM,OAAO,CAAC;AAEf,OAAO,mBAAmB,CAAC;AAM3B,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,SAAS,CAAC;IACpB,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAMD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,EAC1B,QAAQ,EACR,KAAK,EACL,SAAS,EACT,OAAe,GAChB,EAAE,gBAAgB,2CA6NlB"}

package/dist/types/components/datagrid/DataGrid.d.ts

@@ -1,28 +1,40 @@
 import { default as React } from 'react';
 export type DataRow = Record<string, unknown> & {
+    /** Strongly recommended to provide an ID for reliable row selection */
     id?: string | number;
 };
-export type DataGridColumn<T extends DataRow = DataRow> = {
-    key: keyof T & string;
+export type DataGridColumn<T> = {
+    /** The key must exist on the generic type T */
+    key: Extract<keyof T, string>;
     title: React.ReactNode;
     sortable?: boolean;
     width?: number | string;
     align?: 'left' | 'center' | 'right';
+    /** Custom render function for the cell content. Useful for formatting dates or rendering JSX. */
     render?: (row: T) => React.ReactNode;
+    /** Custom sort function. If omitted, the grid falls back to a robust default string/number sort. */
+    sortFn?: (a: T, b: T) => number;
 };
-export interface DataGridProps<T extends DataRow = DataRow> {
+export interface DataGridProps<T> {
     columns: DataGridColumn<T>[];
     rows: T[];
+    /** Controlled page number */
     page?: number;
     pageSize?: number;
     onPageChange?: (page: number) => void;
     selectable?: boolean;
+    /** Controlled selection state */
     selectedRowIds?: Set<string | number>;
     onSelectionChange?: (ids: Set<string | number>) => void;
     onRowClick?: (row: T) => void;
+    /** Renders a floating action column on the far right of the grid */
     renderRowActions?: (row: T) => React.ReactNode;
     className?: string;
     disablePagination?: boolean;
 }
-export declare function DataGrid<T extends DataRow = DataRow>({ columns, rows, page: controlledPage, pageSize, onPageChange, selectable, selectedRowIds, onSelectionChange, onRowClick, renderRowActions, className, disablePagination, }: DataGridProps<T>): import("react/jsx-runtime").JSX.Element;
+/**
+ * DataGrid Component
+ * * A highly performant, accessible table for displaying structured data.
+ */
+export declare function DataGrid<T>({ columns, rows, page: controlledPage, pageSize, onPageChange, selectable, selectedRowIds, onSelectionChange, onRowClick, renderRowActions, className, disablePagination, }: DataGridProps<T>): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=DataGrid.d.ts.map

package/dist/types/components/datagrid/DataGrid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DataGrid.d.ts","sourceRoot":"","sources":["../../../../src/components/datagrid/DataGrid.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAA4B,MAAM,OAAO,CAAC;AACjD,OAAO,gBAAgB,CAAC;AAExB,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAC9C,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,IAAI;IACxD,GAAG,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC;IACtB,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IACpC,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,KAAK,CAAC,SAAS,CAAC;CACtC,CAAC;AAEF,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO;IACxD,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7B,IAAI,EAAE,CAAC,EAAE,CAAC;IAEV,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAEtC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,cAAc,CAAC,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IACtC,iBAAiB,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,IAAI,CAAC;IAExD,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,CAAC;IAC9B,gBAAgB,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,KAAK,CAAC,SAAS,CAAC;IAE/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAID,wBAAgB,QAAQ,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,EAAE,EACpD,OAAO,EACP,IAAI,EACJ,IAAI,EAAE,cAAc,EACpB,QAAa,EACb,YAAY,EAEZ,UAAkB,EAClB,cAAc,EACd,iBAAiB,EAEjB,UAAU,EACV,gBAAgB,EAChB,SAAc,EACd,iBAAyB,GAC1B,EAAE,aAAa,CAAC,CAAC,CAAC,2CAkVlB"}
+{"version":3,"file":"DataGrid.d.ts","sourceRoot":"","sources":["../../../../src/components/datagrid/DataGrid.tsx"],"names":[],"mappings":"AAEA,OAAO,KAA4B,MAAM,OAAO,CAAC;AAEjD,OAAO,gBAAgB,CAAC;AAMxB,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAC9C,uEAAuE;IACvE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI;IAC9B,+CAA+C;IAC/C,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;IAC9B,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IACpC,iGAAiG;IACjG,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,KAAK,CAAC,SAAS,CAAC;IACrC,oGAAoG;IACpG,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,MAAM,CAAC;CACjC,CAAC;AAEF,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7B,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,6BAA6B;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,iCAAiC;IACjC,cAAc,CAAC,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IACtC,iBAAiB,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,IAAI,CAAC;IACxD,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,CAAC;IAC9B,oEAAoE;IACpE,gBAAgB,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,KAAK,CAAC,SAAS,CAAC;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAQD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,EAC1B,OAAO,EACP,IAAI,EACJ,IAAI,EAAE,cAAc,EACpB,QAAa,EACb,YAAY,EACZ,UAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,UAAU,EACV,gBAAgB,EAChB,SAAS,EACT,iBAAyB,GAC1B,EAAE,aAAa,CAAC,CAAC,CAAC,2CA2TlB"}