@nofinite/nui 1.1.2 → 2.0.0

package/dist/types/components/nuiprovider/NUIProvider.d.ts

@@ -0,0 +1,29 @@
+import { default as React } from 'react';
+export type ThemeMode = 'light' | 'dark' | 'system';
+export interface NUIProviderProps {
+    children: React.ReactNode;
+    /** The default theme if nothing is in local storage. Defaults to 'system'. */
+    defaultTheme?: ThemeMode;
+    /** The local storage key used to persist the theme preference. Defaults to 'nui-theme'. */
+    storageKey?: string;
+}
+export interface ThemeContextState {
+    /** The user's selected preference (includes 'system') */
+    theme: ThemeMode;
+    /** The actual calculated theme currently rendered in the DOM ('light' or 'dark') */
+    resolvedTheme: 'light' | 'dark';
+    /** Function to update the theme */
+    setTheme: (theme: ThemeMode) => void;
+}
+/**
+ * useTheme Hook
+ * * Consumes the NUI Theme context to read or update the current theme.
+ */
+export declare function useTheme(): ThemeContextState;
+/**
+ * NUIProvider
+ * * The root provider for the NUI component library.
+ * * Manages theme state, synchronizes with localStorage, and listens for system preference changes.
+ */
+export declare function NUIProvider({ children, defaultTheme, storageKey, }: NUIProviderProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=NUIProvider.d.ts.map

package/dist/types/components/nuiprovider/NUIProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NUIProvider.d.ts","sourceRoot":"","sources":["../../../../src/components/nuiprovider/NUIProvider.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAsE,MAAM,OAAO,CAAC;AAM3F,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEpD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,8EAA8E;IAC9E,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,2FAA2F;IAC3F,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,yDAAyD;IACzD,KAAK,EAAE,SAAS,CAAC;IACjB,oFAAoF;IACpF,aAAa,EAAE,OAAO,GAAG,MAAM,CAAC;IAChC,mCAAmC;IACnC,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;CACtC;AAQD;;;GAGG;AACH,wBAAgB,QAAQ,sBAMvB;AAMD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,EAC1B,QAAQ,EACR,YAAuB,EACvB,UAAwB,GACzB,EAAE,gBAAgB,2CAkElB"}

package/dist/types/components/pagination/Pagination.d.ts

@@ -1,9 +1,23 @@
-export interface PaginationProps {
+import { default as React } from 'react';
+export interface PaginationProps extends Omit<React.HTMLAttributes<HTMLElement>, 'onChange'> {
+    /** The current active page number (1-indexed) */
     page: number;
+    /** The total number of pages available */
     total: number;
-    onChange: (p: number) => void;
+    /** Callback fired when a new page is selected */
+    onChange: (page: number) => void;
+    /** Number of page links to show on each side of the current page. Defaults to 1. */
     siblings?: number;
+    /** Custom class name applied to the root navigation element */
     className?: string;
+    /** Disables all interaction with the pagination controls */
+    disabled?: boolean;
 }
-export declare function Pagination({ page, total, onChange, siblings, className, }: PaginationProps): import("react/jsx-runtime").JSX.Element | null;
+/**
+ * Pagination Component
+ * * A navigation structure for splitting large lists across multiple pages.
+ * * Automatically calculates when to collapse page ranges into ellipses based on siblings.
+ * * Uses standard <nav> and <ul> elements for WAI-ARIA compliance.
+ */
+export declare function Pagination({ page, total, onChange, siblings, className, disabled, ...props }: PaginationProps): import("react/jsx-runtime").JSX.Element | null;
 //# sourceMappingURL=Pagination.d.ts.map

package/dist/types/components/pagination/Pagination.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Pagination.d.ts","sourceRoot":"","sources":["../../../../src/components/pagination/Pagination.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;;;;;;GAQG;AAEH,OAAO,kBAAkB,CAAC;AAE1B,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,UAAU,CAAC,EACzB,IAAI,EACJ,KAAK,EACL,QAAQ,EACR,QAAY,EACZ,SAAc,GACf,EAAE,eAAe,kDAmFjB"}
+{"version":3,"file":"Pagination.d.ts","sourceRoot":"","sources":["../../../../src/components/pagination/Pagination.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkB,MAAM,OAAO,CAAC;AAEvC,OAAO,kBAAkB,CAAC;AAM1B,MAAM,WAAW,eAAgB,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,UAAU,CAAC;IAC1F,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,oFAAoF;IACpF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAQD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,EACzB,IAAI,EACJ,KAAK,EACL,QAAQ,EACR,QAAY,EACZ,SAAS,EACT,QAAgB,EAChB,GAAG,KAAK,EACT,EAAE,eAAe,kDAuIjB"}

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