@nofinite/nui 1.1.2 → 2.0.1

package/dist/types/components/popover/Popover.d.ts

@@ -1,21 +1,59 @@
 import { default as React } from 'react';
-type Placement = 'top' | 'bottom' | 'left' | 'right';
-export declare function Popover({ children }: {
+export type PopoverPlacement = 'top' | 'bottom' | 'left' | 'right';
+export interface PopoverRootProps {
     children: React.ReactNode;
-}): import("react/jsx-runtime").JSX.Element;
-export declare function PopoverTrigger({ children, className, }: {
+    defaultOpen?: boolean;
+}
+/**
+ * Popover Component (Root)
+ * * A non-modal dialog that floats around a trigger element.
+ * * Uses Compound Component Architecture.
+ */
+export declare function PopoverRoot({ children, defaultOpen }: PopoverRootProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace PopoverRoot {
+    var displayName: string;
+}
+export interface PopoverTriggerProps {
+    children: React.ReactElement;
+}
+/**
+ * Popover Trigger
+ * * Automatically clones the child element and injects necessary event listeners and ARIA attributes.
+ */
+export declare function PopoverTrigger({ children }: PopoverTriggerProps): React.ReactElement<React.HTMLProps<HTMLElement>, string | React.JSXElementConstructor<any>>;
+export declare namespace PopoverTrigger {
+    var displayName: string;
+}
+export interface PopoverContentProps extends React.HTMLAttributes<HTMLDivElement> {
     children: React.ReactNode;
-    className?: string;
-}): import("react/jsx-runtime").JSX.Element;
-export declare function PopoverContent({ children, className, placement, offset, }: {
-    children: React.ReactNode;
-    className?: string;
-    placement?: Placement;
+    /** Preferred placement of the popover relative to the trigger. Defaults to 'bottom' */
+    placement?: PopoverPlacement;
+    /** Gap in pixels between the trigger and the popover. Defaults to 8px. */
     offset?: number;
-}): import("react/jsx-runtime").JSX.Element | null;
-export declare function PopoverClose({ children, className, }: {
-    children?: React.ReactNode;
-    className?: string;
-}): import("react/jsx-runtime").JSX.Element;
-export {};
+}
+/**
+ * Popover Content
+ * * Renders inside a Portal and implements smart collision detection to stay in the viewport.
+ * * Automatically traps focus when open.
+ */
+export declare function PopoverContent({ children, className, placement, offset, ...props }: PopoverContentProps): import("react/jsx-runtime").JSX.Element | null;
+export declare namespace PopoverContent {
+    var displayName: string;
+}
+export interface PopoverCloseProps {
+    children: React.ReactElement;
+}
+/**
+ * Popover Close
+ * * Optional headless wrapper that injects a close action into a child button.
+ */
+export declare function PopoverClose({ children }: PopoverCloseProps): React.ReactElement<React.HTMLProps<HTMLElement>, string | React.JSXElementConstructor<any>>;
+export declare namespace PopoverClose {
+    var displayName: string;
+}
+export declare const Popover: typeof PopoverRoot & {
+    Trigger: typeof PopoverTrigger;
+    Content: typeof PopoverContent;
+    Close: typeof PopoverClose;
+};
 //# sourceMappingURL=Popover.d.ts.map

package/dist/types/components/popover/Popover.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Popover.d.ts","sourceRoot":"","sources":["../../../../src/components/popover/Popover.tsx"],"names":[],"mappings":"AAAA,OAAO,KAQN,MAAM,OAAO,CAAC;AAEf,OAAO,eAAe,CAAC;AAMvB,KAAK,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AAmBrD,wBAAgB,OAAO,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,2CAqBlE;AAKD,wBAAgB,cAAc,CAAC,EAC7B,QAAQ,EACR,SAAc,GACf,EAAE;IACD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,2CA0BA;AAKD,wBAAgB,cAAc,CAAC,EAC7B,QAAQ,EACR,SAAc,EACd,SAAoB,EACpB,MAAU,GACX,EAAE;IACD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,kDAwFA;AAKD,wBAAgB,YAAY,CAAC,EAC3B,QAAkB,EAClB,SAAc,GACf,EAAE;IACD,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,2CAWA"}
+{"version":3,"file":"Popover.d.ts","sourceRoot":"","sources":["../../../../src/components/popover/Popover.tsx"],"names":[],"mappings":"AAEA,OAAO,KASN,MAAM,OAAO,CAAC;AAGf,OAAO,eAAe,CAAC;AAEvB,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AAyBnE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,EAAE,QAAQ,EAAE,WAAmB,EAAE,EAAE,gBAAgB,2CAkB9E;yBAlBe,WAAW;;;AAyB3B,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,KAAK,CAAC,YAAY,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAAE,QAAQ,EAAE,EAAE,mBAAmB,+FAkC/D;yBAlCe,cAAc;;;AAwC9B,MAAM,WAAW,mBAAoB,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IAC/E,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,uFAAuF;IACvF,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAC7B,QAAQ,EACR,SAAS,EACT,SAAoB,EACpB,MAAU,EACV,GAAG,KAAK,EACT,EAAE,mBAAmB,kDAuJrB;yBA7Je,cAAc;;;AAoK9B,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,KAAK,CAAC,YAAY,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,EAAE,QAAQ,EAAE,EAAE,iBAAiB,+FAW3D;yBAXe,YAAY;;;AAiB5B,eAAO,MAAM,OAAO;;;;CAIlB,CAAC"}

package/dist/types/components/progress/Progress.d.ts

@@ -1,13 +1,23 @@
-export interface ProgressProps {
-    /** Current value (determinate mode). */
+import { default as React } from 'react';
+export interface ProgressProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** The current progress value */
     value?: number;
-    /** Maximum value (default: 100). */
+    /** The maximum possible value. Defaults to 100. */
     max?: number;
-    /** Indeterminate mode when value is undefined. */
+    /** Forces the progress bar into an animated indeterminate state */
     indeterminate?: boolean;
-    /** Optional label for screen readers. */
+    /** The visual height of the progress bar. Defaults to 'md'. */
+    size?: 'sm' | 'md' | 'lg';
+    /** The semantic color variant. Defaults to 'default'. */
+    variant?: 'default' | 'success' | 'warning' | 'danger';
+    /** WAI-ARIA hidden label for screen readers. Defaults to 'Progress'. */
     label?: string;
-    className?: string;
 }
-export declare function Progress({ value, max, indeterminate, label, className, }: ProgressProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Progress Component
+ * * A WAI-ARIA compliant progress bar indicating the completion status of a task.
+ * * Architecture Note: Uses CSS `transform: translateX` instead of `width` for
+ * hardware-accelerated (GPU) 60fps rendering to prevent layout thrashing on the main thread.
+ */
+export declare const Progress: React.ForwardRefExoticComponent<ProgressProps & React.RefAttributes<HTMLDivElement>>;
 //# sourceMappingURL=Progress.d.ts.map

package/dist/types/components/progress/Progress.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Progress.d.ts","sourceRoot":"","sources":["../../../../src/components/progress/Progress.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,gBAAgB,CAAC;AAExB,MAAM,WAAW,aAAa;IAC5B,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,oCAAoC;IACpC,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,kDAAkD;IAClD,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,QAAQ,CAAC,EACvB,KAAK,EACL,GAAS,EACT,aAAqB,EACrB,KAAkB,EAClB,SAAc,GACf,EAAE,aAAa,2CAoBf"}
+{"version":3,"file":"Progress.d.ts","sourceRoot":"","sources":["../../../../src/components/progress/Progress.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAqB,MAAM,OAAO,CAAC;AAE1C,OAAO,gBAAgB,CAAC;AAMxB,MAAM,WAAW,aAAc,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IACzE,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,+DAA+D;IAC/D,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1B,yDAAyD;IACzD,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;IACvD,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,sFAgDnB,CAAC"}

package/dist/types/components/radiogroup/RadioGroup.d.ts

@@ -1,18 +1,23 @@
 import { default as React } from 'react';
-export interface RadioOption {
-    label: React.ReactNode;
-    value: string;
-    disabled?: boolean;
-}
-interface RadioGroupProps {
-    options: RadioOption[];
+export interface RadioGroupProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange' | 'dir'> {
+    /** Controlled state value */
     value?: string;
+    /** Uncontrolled default value */
     defaultValue?: string;
+    /** Callback fired when a new radio item is selected */
     onChange?: (value: string) => void;
+    /** The name attribute applied to all children to group them natively for forms */
     name?: string;
+    /** Disables the entire radio group */
     disabled?: boolean;
-    className?: string;
+    /** Determines the flex layout direction of the group */
+    orientation?: 'horizontal' | 'vertical';
+}
+export interface RadioItemProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, 'value' | 'name' | 'onChange' | 'type'> {
+    /** The unique value of this specific radio option */
+    value: string;
 }
-export declare function RadioGroup({ options, value, defaultValue, onChange, name, disabled, className, }: RadioGroupProps): import("react/jsx-runtime").JSX.Element;
-export {};
+export declare const RadioGroup: React.ForwardRefExoticComponent<RadioGroupProps & React.RefAttributes<HTMLDivElement>> & {
+    Item: React.ForwardRefExoticComponent<RadioItemProps & React.RefAttributes<HTMLInputElement>>;
+};
 //# sourceMappingURL=RadioGroup.d.ts.map

package/dist/types/components/radiogroup/RadioGroup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RadioGroup.d.ts","sourceRoot":"","sources":["../../../../src/components/radiogroup/RadioGroup.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAwC,MAAM,OAAO,CAAC;AAC7D,OAAO,kBAAkB,CAAC;AAE1B,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,UAAU,eAAe;IACvB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,UAAU,CAAC,EACzB,OAAO,EACP,KAAK,EACL,YAAY,EACZ,QAAQ,EACR,IAAI,EACJ,QAAgB,EAChB,SAAc,GACf,EAAE,eAAe,2CAyFjB"}
+{"version":3,"file":"RadioGroup.d.ts","sourceRoot":"","sources":["../../../../src/components/radiogroup/RadioGroup.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAuE,MAAM,OAAO,CAAC;AAE5F,OAAO,kBAAkB,CAAC;AAyB1B,MAAM,WAAW,eAAgB,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,UAAU,GAAG,KAAK,CAAC;IACrG,6BAA6B;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,kFAAkF;IAClF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wDAAwD;IACxD,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,CAAC;CACzC;AAuDD,MAAM,WAAW,cAAe,SAAQ,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC;IAC/H,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;CACf;AA2CD,eAAO,MAAM,UAAU;;CAErB,CAAC"}

package/dist/types/components/rating/Rating.d.ts

@@ -1,19 +1,33 @@
 import { default as React } from 'react';
-export interface RatingProps {
-    /** Current value (1–max). If undefined → uncontrolled mode */
+export interface RatingProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange'> {
+    /** Controlled state value */
     value?: number;
-    /** Max number of stars */
+    /** Uncontrolled initial value */
+    defaultValue?: number;
+    /** The maximum possible rating. Determines how many icons to render. Defaults to 5. */
     max?: number;
-    /** Change handler */
+    /** Callback fired when a rating is selected */
     onChange?: (value: number) => void;
-    /** Custom icon */
+    /** Custom React node for the empty state */
     icon?: React.ReactNode;
-    /** Custom filled icon */
+    /** Custom React node for the filled state */
     iconFilled?: React.ReactNode;
-    /** Size */
+    /** Size variant */
     size?: 'sm' | 'md' | 'lg';
-    /** Optional class */
-    className?: string;
+    /** Makes the rating strictly decorative */
+    readOnly?: boolean;
+    /** Disables interactions and applies a muted style */
+    disabled?: boolean;
+    /** Enables fractional half-step selections (e.g., 3.5 stars) */
+    allowHalf?: boolean;
 }
-export declare function Rating({ value, max, onChange, icon, iconFilled, size, className, }: RatingProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Rating Component
+ * * A WAI-ARIA compliant slider that allows users to provide a numerical rating.
+ * * Architecture Note (Fractional Display):
+ * The component supports infinitely precise fractional rendering (e.g., 4.7 stars).
+ * It achieves this by overlaying an `absolute` filled icon on top of the empty icon
+ * and using CSS `overflow: hidden` combined with an inline `width: X%` style to "clip" the SVG.
+ */
+export declare function Rating({ value, defaultValue, max, onChange, icon, iconFilled, size, readOnly, disabled, allowHalf, className, ...props }: RatingProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=Rating.d.ts.map

package/dist/types/components/rating/Rating.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Rating.d.ts","sourceRoot":"","sources":["../../../../src/components/rating/Rating.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAmB,MAAM,OAAO,CAAC;AACxC,OAAO,cAAc,CAAC;AAEtB,MAAM,WAAW,WAAW;IAC1B,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,0BAA0B;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,qBAAqB;IACrB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAEnC,kBAAkB;IAClB,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAEvB,yBAAyB;IACzB,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAE7B,WAAW;IACX,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAE1B,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,MAAM,CAAC,EACrB,KAAK,EACL,GAAO,EACP,QAAQ,EACR,IAAU,EACV,UAAgB,EAChB,IAAW,EACX,SAAc,GACf,EAAE,WAAW,2CAgDb"}
+{"version":3,"file":"Rating.d.ts","sourceRoot":"","sources":["../../../../src/components/rating/Rating.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAgC,MAAM,OAAO,CAAC;AAErD,OAAO,cAAc,CAAC;AAoBtB,MAAM,WAAW,WAAY,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,UAAU,CAAC;IACzF,6BAA6B;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uFAAuF;IACvF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,4CAA4C;IAC5C,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC7B,mBAAmB;IACnB,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1B,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sDAAsD;IACtD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gEAAgE;IAChE,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAMD;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,EACrB,KAAK,EACL,YAAgB,EAChB,GAAO,EACP,QAAQ,EACR,IAAuB,EACvB,UAA8B,EAC9B,IAAW,EACX,QAAgB,EAChB,QAAgB,EAChB,SAAiB,EACjB,SAAS,EACT,GAAG,KAAK,EACT,EAAE,WAAW,2CA0Hb"}

package/dist/types/components/resizable/Resizable.d.ts

@@ -0,0 +1,24 @@
+import { default as React } from 'react';
+export interface ResizableProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** The flex layout direction. Defaults to 'horizontal'. */
+    direction?: 'horizontal' | 'vertical';
+    /** Callback fired when the user completes a resize action, providing an array of panel sizes (percentages) */
+    onLayout?: (sizes: number[]) => void;
+}
+export interface ResizablePanelProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** The initial size of the panel as a percentage of the available space (0-100) */
+    defaultSize?: number;
+    /** The absolute minimum size the panel can shrink to */
+    minSize?: number;
+    /** The absolute maximum size the panel can grow to */
+    maxSize?: number;
+}
+export interface ResizableHandleProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Renders a visual grip icon in the center of the handle */
+    withIcon?: boolean;
+}
+export declare const Resizable: React.ForwardRefExoticComponent<ResizableProps & React.RefAttributes<HTMLDivElement>> & {
+    Panel: React.ForwardRefExoticComponent<ResizablePanelProps & React.RefAttributes<HTMLDivElement>>;
+    Handle: React.ForwardRefExoticComponent<ResizableHandleProps & React.RefAttributes<HTMLDivElement>>;
+};
+//# sourceMappingURL=Resizable.d.ts.map

package/dist/types/components/resizable/Resizable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Resizable.d.ts","sourceRoot":"","sources":["../../../../src/components/resizable/Resizable.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAsF,MAAM,OAAO,CAAC;AAE3G,OAAO,iBAAiB,CAAC;AAwBzB,MAAM,WAAW,cAAe,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IAC1E,2DAA2D;IAC3D,SAAS,CAAC,EAAE,YAAY,GAAG,UAAU,CAAC;IACtC,8GAA8G;IAC9G,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;CACtC;AAsND,MAAM,WAAW,mBAAoB,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IAC/E,mFAAmF;IACnF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA8BD,MAAM,WAAW,oBAAqB,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IAChF,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAiDD,eAAO,MAAM,SAAS;;;CAGpB,CAAC"}

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

@@ -1,20 +1,29 @@
 import { default as React } from 'react';
-type Option = {
+export type SelectOption = {
     value: string;
     label: React.ReactNode;
     disabled?: boolean;
 };
-interface SelectProps {
-    options: Option[];
+export interface SelectProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'value' | 'defaultValue' | 'onChange'> {
+    /** Array of available options */
+    options: SelectOption[];
+    /** Controlled state value */
     value?: string;
+    /** Uncontrolled initial value */
     defaultValue?: string;
+    /** Callback fired when an option is selected */
     onChange?: (value: string) => void;
+    /** Text displayed when no option is selected */
     placeholder?: string;
-    disabled?: boolean;
+    /** Name attribute applied to the hidden input for native form submission */
     name?: string;
-    id?: string;
-    className?: string;
+    /** Applies error styling to the trigger button */
+    error?: boolean;
 }
-export declare function Select({ options, value, defaultValue, onChange, placeholder, disabled, name, id, className, }: SelectProps): import("react/jsx-runtime").JSX.Element;
-export {};
+/**
+ * Select Component
+ * * A highly accessible dropdown select menu.
+ * * Automatically manages focus, keyboard typeahead navigation, and viewport collision detection.
+ */
+export declare const Select: React.ForwardRefExoticComponent<SelectProps & React.RefAttributes<HTMLButtonElement>>;
 //# sourceMappingURL=Select.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Select.d.ts","sourceRoot":"","sources":["../../../../src/components/select/Select.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAMN,MAAM,OAAO,CAAC;AACf,OAAO,cAAc,CAAC;AAGtB,KAAK,MAAM,GAAG;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,UAAU,WAAW;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAaD,wBAAgB,MAAM,CAAC,EACrB,OAAO,EACP,KAAK,EACL,YAAY,EACZ,QAAQ,EACR,WAAyB,EACzB,QAAgB,EAChB,IAAI,EACJ,EAAE,EACF,SAAc,GACf,EAAE,WAAW,2CA+Ob"}
+{"version":3,"file":"Select.d.ts","sourceRoot":"","sources":["../../../../src/components/select/Select.tsx"],"names":[],"mappings":"AAEA,OAAO,KAQN,MAAM,OAAO,CAAC;AAEf,OAAO,cAAc,CAAC;AAMtB,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,MAAM,WAAW,WAAY,SAAQ,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,OAAO,GAAG,cAAc,GAAG,UAAU,CAAC;IAC7H,iCAAiC;IACjC,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,6BAA6B;IAC7B,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,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAiBD;;;;GAIG;AACH,eAAO,MAAM,MAAM,uFAoQjB,CAAC"}

package/dist/types/components/skeleton/Skeleton.d.ts

@@ -1,44 +1,45 @@
 import { default as React } from 'react';
-type Size = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
-interface SkeletonProps {
-    size?: Size;
+type SkeletonSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+export interface SkeletonProps extends React.HTMLAttributes<HTMLSpanElement> {
+    /** The predefined height mapping for the skeleton */
+    size?: SkeletonSize;
+    /** Explicit width override (supports numbers as px, or strings like '100%') */
     width?: number | string;
+    /** Explicit height override (supports numbers as px, or strings like '50px') */
+    height?: number | string;
+    /** Enables or disables the sweeping shimmer animation. Defaults to true. */
     animated?: boolean;
+    /** Forces the skeleton into a perfect circle, ignoring the size height */
     circle?: boolean;
+    /** Hides the element from screen readers. Defaults to true (recommended). */
     ariaHidden?: boolean;
-    className?: string;
-    style?: React.CSSProperties;
 }
-export declare function Skeleton({ size, width, animated, circle, ariaHidden, className, style, }: SkeletonProps): import("react/jsx-runtime").JSX.Element;
-export declare namespace Skeleton {
-    var Text: ({ width, size, }: {
-        width?: number | string;
-        size?: Size;
-    }) => import("react/jsx-runtime").JSX.Element;
-    var Paragraph: ({ lines, size, }: {
-        lines?: number;
-        size?: Size;
-    }) => import("react/jsx-runtime").JSX.Element;
-    var Avatar: typeof AvatarSkeleton;
-    var Button: typeof ButtonSkeleton;
-    var Card: typeof CardSkeleton;
+export interface SkeletonTextProps extends React.HTMLAttributes<HTMLSpanElement> {
+    width?: number | string;
+    size?: SkeletonSize;
+}
+declare function Text({ width, size, className, ...props }: SkeletonTextProps): import("react/jsx-runtime").JSX.Element;
+export interface SkeletonParagraphProps extends React.HTMLAttributes<HTMLDivElement> {
+    lines?: number;
+    size?: SkeletonSize;
+}
+declare function Paragraph({ lines, size, className, ...props }: SkeletonParagraphProps): import("react/jsx-runtime").JSX.Element;
+export interface SkeletonAvatarProps extends React.HTMLAttributes<HTMLSpanElement> {
+    size?: number | string;
+}
+declare function Avatar({ size, className, ...props }: SkeletonAvatarProps): import("react/jsx-runtime").JSX.Element;
+export interface SkeletonButtonProps extends React.HTMLAttributes<HTMLSpanElement> {
+    width?: number | string;
+    height?: number | string;
 }
-/**
- * Avatar placeholder, circle with dynamic size
- */
-declare function AvatarSkeleton({ size }: {
-    size?: number;
-}): import("react/jsx-runtime").JSX.Element;
-/**
- * Button skeleton (pill-like shape)
- */
-declare function ButtonSkeleton({ width, height, }: {
-    width?: number;
-    height?: number;
-}): import("react/jsx-runtime").JSX.Element;
-/**
- * Card Skeleton: header + lines + footer bar
- */
-declare function CardSkeleton(): import("react/jsx-runtime").JSX.Element;
-export default Skeleton;
+declare function Button({ width, height, className, ...props }: SkeletonButtonProps): import("react/jsx-runtime").JSX.Element;
+declare function Card({ className, style, ...props }: React.HTMLAttributes<HTMLDivElement>): import("react/jsx-runtime").JSX.Element;
+export declare const Skeleton: React.ForwardRefExoticComponent<SkeletonProps & React.RefAttributes<HTMLSpanElement>> & {
+    Text: typeof Text;
+    Paragraph: typeof Paragraph;
+    Avatar: typeof Avatar;
+    Button: typeof Button;
+    Card: typeof Card;
+};
+export {};
 //# sourceMappingURL=Skeleton.d.ts.map

package/dist/types/components/skeleton/Skeleton.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Skeleton.d.ts","sourceRoot":"","sources":["../../../../src/components/skeleton/Skeleton.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH;;;;;;;;;GASG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,gBAAgB,CAAC;AAExB,KAAK,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE7C,UAAU,aAAa;IACrB,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;CAC7B;AAQD,wBAAgB,QAAQ,CAAC,EACvB,IAAW,EACX,KAAK,EACL,QAAe,EACf,MAAc,EACd,UAAiB,EACjB,SAAc,EACd,KAAK,GACN,EAAE,aAAa,2CAuBf;yBA/Be,QAAQ;iCA4CrB;QACD,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QACxB,IAAI,CAAC,EAAE,IAAI,CAAC;KACb;sCAWE;QACD,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,IAAI,CAAC;KACb;;;;;AAcD;;GAEG;AACH,iBAAS,cAAc,CAAC,EAAE,IAAS,EAAE,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,2CAEvD;AAED;;GAEG;AACH,iBAAS,cAAc,CAAC,EACtB,KAAW,EACX,MAAW,GACZ,EAAE;IACD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,2CAYA;AAED;;GAEG;AACH,iBAAS,YAAY,4CAQpB;AASD,eAAe,QAAQ,CAAC"}
+{"version":3,"file":"Skeleton.d.ts","sourceRoot":"","sources":["../../../../src/components/skeleton/Skeleton.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,gBAAgB,CAAC;AAMxB,KAAK,YAAY,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAErD,MAAM,WAAW,aAAc,SAAQ,KAAK,CAAC,cAAc,CAAC,eAAe,CAAC;IAC1E,qDAAqD;IACrD,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAwDD,MAAM,WAAW,iBAAkB,SAAQ,KAAK,CAAC,cAAc,CAAC,eAAe,CAAC;IAC9E,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,YAAY,CAAC;CACrB;AAED,iBAAS,IAAI,CAAC,EAAE,KAAc,EAAE,IAAW,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,iBAAiB,2CAEpF;AAED,MAAM,WAAW,sBAAuB,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IAClF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,YAAY,CAAC;CACrB;AAED,iBAAS,SAAS,CAAC,EAAE,KAAS,EAAE,IAAW,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,sBAAsB,2CAiBzF;AAED,MAAM,WAAW,mBAAoB,SAAQ,KAAK,CAAC,cAAc,CAAC,eAAe,CAAC;IAChF,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACxB;AAED,iBAAS,MAAM,CAAC,EAAE,IAAS,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,mBAAmB,2CAGtE;AAED,MAAM,WAAW,mBAAoB,SAAQ,KAAK,CAAC,cAAc,CAAC,eAAe,CAAC;IAChF,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC1B;AAED,iBAAS,MAAM,CAAC,EAAE,KAAW,EAAE,MAAW,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,mBAAmB,2CAUrF;AAED,iBAAS,IAAI,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,2CAkBjF;AAMD,eAAO,MAAM,QAAQ;;;;;;CAMnB,CAAC"}

package/dist/types/components/slider/Slider.d.ts

@@ -1,13 +1,24 @@
-interface SliderProps {
+import { default as React } from 'react';
+export interface SliderProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange' | 'defaultValue'> {
+    /** The minimum allowed value. Defaults to 0. */
     min?: number;
+    /** The maximum allowed value. Defaults to 100. */
     max?: number;
+    /** The interval between valid values. Defaults to 1. */
     step?: number;
+    /** The controlled value of the slider. */
     value?: number;
+    /** The initial uncontrolled value of the slider. */
     defaultValue?: number;
+    /** Callback fired when the value changes. */
     onChange?: (value: number) => void;
+    /** Disables the slider and prevents interaction. */
     disabled?: boolean;
-    className?: string;
 }
-export declare function Slider({ min, max, step, value, defaultValue, onChange, disabled, className, }: SliderProps): import("react/jsx-runtime").JSX.Element;
-export {};
+/**
+ * Slider Component
+ * * A WAI-ARIA compliant input that allows users to select a value from a given range.
+ * * Automatically handles global window pointer events for smooth dragging outside the hit area.
+ */
+export declare function Slider({ min, max, step, value, defaultValue, onChange, disabled, className, ...props }: SliderProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=Slider.d.ts.map

package/dist/types/components/slider/Slider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Slider.d.ts","sourceRoot":"","sources":["../../../../src/components/slider/Slider.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,cAAc,CAAC;AAEtB,UAAU,WAAW;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,MAAM,CAAC,EACrB,GAAO,EACP,GAAS,EACT,IAAQ,EACR,KAAK,EACL,YAAY,EACZ,QAAQ,EACR,QAAgB,EAChB,SAAc,GACf,EAAE,WAAW,2CAuJb"}
+{"version":3,"file":"Slider.d.ts","sourceRoot":"","sources":["../../../../src/components/slider/Slider.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAmD,MAAM,OAAO,CAAC;AAExE,OAAO,cAAc,CAAC;AAMtB,MAAM,WAAW,WAAY,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,UAAU,GAAG,cAAc,CAAC;IAC1G,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,oDAAoD;IACpD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAMD;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,EACrB,GAAO,EACP,GAAS,EACT,IAAQ,EACR,KAAK,EACL,YAAY,EACZ,QAAQ,EACR,QAAgB,EAChB,SAAS,EACT,GAAG,KAAK,EACT,EAAE,WAAW,2CAsKb"}

package/dist/types/components/spinner/Spinner.d.ts

@@ -1,7 +1,17 @@
-export interface SpinnerProps {
-    size?: 'sm' | 'md' | 'lg';
-    className?: string;
+import { default as React } from 'react';
+export interface SpinnerProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** The predefined size of the spinner. Defaults to 'md'. */
+    size?: 'sm' | 'md' | 'lg' | 'xl';
+    /** The color theme variant. Defaults to 'primary'. */
+    variant?: 'primary' | 'muted' | 'inverse';
+    /** WAI-ARIA label read by screen readers. Defaults to 'Loading...'. */
     label?: string;
 }
-export declare function Spinner({ size, className, label, }: SpinnerProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Spinner Component
+ * * A visual indicator for loading states.
+ * * WAI-ARIA compliant: Uses role="status" to announce the loading state politely
+ * to screen readers without immediately interrupting the user.
+ */
+export declare const Spinner: React.ForwardRefExoticComponent<SpinnerProps & React.RefAttributes<HTMLDivElement>>;
 //# sourceMappingURL=Spinner.d.ts.map

package/dist/types/components/spinner/Spinner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Spinner.d.ts","sourceRoot":"","sources":["../../../../src/components/spinner/Spinner.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,eAAe,CAAC;AAEvB,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,OAAO,CAAC,EACtB,IAAW,EACX,SAAc,EACd,KAAiB,GAClB,EAAE,YAAY,2CAUd"}
+{"version":3,"file":"Spinner.d.ts","sourceRoot":"","sources":["../../../../src/components/spinner/Spinner.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAqB,MAAM,OAAO,CAAC;AAE1C,OAAO,eAAe,CAAC;AAMvB,MAAM,WAAW,YAAa,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IACxE,4DAA4D;IAC5D,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IACjC,sDAAsD;IACtD,OAAO,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;IAC1C,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD;;;;;GAKG;AACH,eAAO,MAAM,OAAO,qFAgDlB,CAAC"}

package/dist/types/components/stepper/Stepper.d.ts

@@ -1,12 +1,26 @@
 import { default as React } from 'react';
 export interface StepItem {
+    /** The primary title of the step */
     label: React.ReactNode;
+    /** Secondary descriptive text displayed below the label */
+    description?: React.ReactNode;
+    /** Marks the step with an "(Optional)" tag */
+    optional?: boolean;
 }
-export interface StepperProps {
+export interface StepperProps extends Omit<React.HTMLAttributes<HTMLElement>, 'onChange'> {
+    /** Array of steps. Can be simple strings or rich objects. */
     steps: (string | StepItem)[];
+    /** The 0-based index of the currently active step. */
     active: number;
+    /** Callback fired when a step is clicked. */
     onChange?: (index: number) => void;
-    className?: string;
+    /** Prevents the user from clicking on steps that come after the currently active one. */
+    disableFuture?: boolean;
 }
-export declare function Stepper({ steps, active, onChange, className, }: StepperProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Stepper Component
+ * * A visual indicator for multi-step workflows.
+ * * Uses standard `<nav>` and `<ol>` HTML elements for strict WAI-ARIA compliance.
+ */
+export declare const Stepper: React.ForwardRefExoticComponent<StepperProps & React.RefAttributes<HTMLElement>>;
 //# sourceMappingURL=Stepper.d.ts.map

package/dist/types/components/stepper/Stepper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Stepper.d.ts","sourceRoot":"","sources":["../../../../src/components/stepper/Stepper.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,eAAe,CAAC;AAEvB,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,CAAC,MAAM,GAAG,QAAQ,CAAC,EAAE,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,OAAO,CAAC,EACtB,KAAK,EACL,MAAM,EACN,QAAQ,EACR,SAAc,GACf,EAAE,YAAY,2CA0Cd"}
+{"version":3,"file":"Stepper.d.ts","sourceRoot":"","sources":["../../../../src/components/stepper/Stepper.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAqB,MAAM,OAAO,CAAC;AAE1C,OAAO,eAAe,CAAC;AAMvB,MAAM,WAAW,QAAQ;IACvB,oCAAoC;IACpC,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9B,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,YAAa,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,UAAU,CAAC;IACvF,6DAA6D;IAC7D,KAAK,EAAE,CAAC,MAAM,GAAG,QAAQ,CAAC,EAAE,CAAC;IAC7B,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,yFAAyF;IACzF,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAMD;;;;GAIG;AACH,eAAO,MAAM,OAAO,kFAiFlB,CAAC"}

package/dist/types/components/switch/Switch.d.ts

@@ -1,15 +1,30 @@
 import { default as React } from 'react';
-interface SwitchProps {
+export interface SwitchProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'onChange' | 'value'> {
+    /** The controlled checked state of the switch */
     checked?: boolean;
+    /** The uncontrolled default checked state */
     defaultChecked?: boolean;
+    /** Callback fired when the state changes */
     onChange?: (checked: boolean) => void;
+    /** Disables the switch, preventing interaction */
     disabled?: boolean;
+    /** The primary text label for the switch */
     label?: React.ReactNode;
-    id?: string;
+    /** Secondary descriptive text linked via WAI-ARIA */
+    description?: React.ReactNode;
+    /** Name attribute for native form submission */
     name?: string;
+    /** Value submitted in a native form when checked. Defaults to "on". */
     value?: string;
-    className?: string;
+    /** The visual size variant. Defaults to 'md'. */
+    size?: 'sm' | 'md';
+    /** Additional CSS classes for the outer wrapping div */
+    wrapperClassName?: string;
 }
-export declare function Switch({ checked, defaultChecked, onChange, disabled, label, id, name, value, className, }: SwitchProps): import("react/jsx-runtime").JSX.Element;
-export {};
+/**
+ * Switch Component
+ * * A WAI-ARIA compliant toggle switch used to turn settings on or off.
+ * * Automatically handles native form submission using a hidden input.
+ */
+export declare const Switch: React.ForwardRefExoticComponent<SwitchProps & React.RefAttributes<HTMLButtonElement>>;
 //# sourceMappingURL=Switch.d.ts.map

package/dist/types/components/switch/Switch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Switch.d.ts","sourceRoot":"","sources":["../../../../src/components/switch/Switch.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH;;;GAGG;AAEH,OAAO,KAA4B,MAAM,OAAO,CAAC;AACjD,OAAO,cAAc,CAAC;AAEtB,UAAU,WAAW;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAEtC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,MAAM,CAAC,EACrB,OAAO,EACP,cAAc,EACd,QAAQ,EACR,QAAgB,EAChB,KAAK,EACL,EAAE,EACF,IAAI,EACJ,KAAK,EACL,SAAc,GACf,EAAE,WAAW,2CAsFb"}
+{"version":3,"file":"Switch.d.ts","sourceRoot":"","sources":["../../../../src/components/switch/Switch.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAsC,MAAM,OAAO,CAAC;AAE3D,OAAO,cAAc,CAAC;AAMtB,MAAM,WAAW,WAAY,SAAQ,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC;IAC5G,iDAAiD;IACjD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,6CAA6C;IAC7C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAEtC,kDAAkD;IAClD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,qDAAqD;IACrD,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAE9B,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAEnB,wDAAwD;IACxD,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAMD;;;;GAIG;AACH,eAAO,MAAM,MAAM,uFA2HlB,CAAC"}

package/dist/types/components/table/Table.d.ts

@@ -1,14 +1,34 @@
+import { default as React } from 'react';
 export interface TableColumn<T> {
+    /** The key from your data object that this column maps to */
     key: keyof T;
+    /** The text displayed in the table header */
     label: string;
+    /** Enables clicking the header to sort the table by this column */
     sortable?: boolean;
+    /** Aligns the text in the column header and cells. Defaults to 'left' */
+    align?: 'left' | 'center' | 'right';
+    /** Custom render function for the cell. Useful for formatting (e.g., currency) or custom UI (e.g., status badges) */
+    render?: (row: T) => React.ReactNode;
+    /** Optional custom sorting function to override the default alphabetic/numeric sort */
+    sortFn?: (a: T, b: T) => number;
 }
-interface TableProps<T> {
+export interface TableProps<T> {
+    /** Array of column configuration objects */
     columns: TableColumn<T>[];
+    /** Array of data objects to render */
     data: T[];
-    emptyText?: string;
+    /** A unique identifier for each row (string/number key, or a function that returns a string) */
+    rowKey: keyof T | ((row: T) => string);
+    /** Text or React Node to display when the data array is empty */
+    emptyText?: React.ReactNode;
+    /** Custom class applied to the <table> element */
     className?: string;
 }
-export declare function Table<T extends Record<string, any>>({ columns, data, emptyText, className, }: TableProps<T>): import("react/jsx-runtime").JSX.Element;
-export {};
+/**
+ * Table Component
+ * * A highly generic data table that supports automatic sorting and custom cell rendering.
+ * * Uses strict TypeScript generics (`<T>`) so it can perfectly map to any data shape passed into it.
+ */
+export declare function Table<T>({ columns, data, rowKey, emptyText, className, }: TableProps<T>): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=Table.d.ts.map

package/dist/types/components/table/Table.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Table.d.ts","sourceRoot":"","sources":["../../../../src/components/table/Table.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,aAAa,CAAC;AAErB,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,GAAG,EAAE,MAAM,CAAC,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,UAAU,UAAU,CAAC,CAAC;IACpB,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1B,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAOD,wBAAgB,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,EACnD,OAAO,EACP,IAAI,EACJ,SAA+B,EAC/B,SAAc,GACf,EAAE,UAAU,CAAC,CAAC,CAAC,2CA4Ff"}
+{"version":3,"file":"Table.d.ts","sourceRoot":"","sources":["../../../../src/components/table/Table.tsx"],"names":[],"mappings":"AAEA,OAAO,KAA4B,MAAM,OAAO,CAAC;AAEjD,OAAO,aAAa,CAAC;AAMrB,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,6DAA6D;IAC7D,GAAG,EAAE,MAAM,CAAC,CAAC;IACb,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IACpC,qHAAqH;IACrH,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,KAAK,CAAC,SAAS,CAAC;IACrC,uFAAuF;IACvF,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,4CAA4C;IAC5C,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1B,sCAAsC;IACtC,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,gGAAgG;IAChG,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,MAAM,CAAC,CAAC;IACvC,iEAAiE;IACjE,SAAS,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC5B,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAWD;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,EACvB,OAAO,EACP,IAAI,EACJ,MAAM,EACN,SAA+B,EAC/B,SAAS,GACV,EAAE,UAAU,CAAC,CAAC,CAAC,2CAiJf"}