@sudobility/components-rn 1.0.21 → 1.0.22

package/dist/lib/utils.d.ts

@@ -1,8 +1,13 @@
 import { ClassValue } from 'clsx';
 /**
  * Merges class names for React Native with NativeWind.
- * Unlike web version, we don't need tailwind-merge since NativeWind
- * processes Tailwind classes at build time.
+ *
+ * Unlike the web version (`@sudobility/components`), this does NOT use
+ * `tailwind-merge` since NativeWind processes Tailwind classes at build
+ * time and handles conflict resolution internally.
+ *
+ * @param inputs - Class values to merge (strings, arrays, objects, etc.)
+ * @returns A single merged class name string
  */
 export declare function cn(...inputs: ClassValue[]): string;
 //# sourceMappingURL=utils.d.ts.map

package/dist/lib/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/lib/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAQ,MAAM,MAAM,CAAC;AAE7C;;;;GAIG;AACH,wBAAgB,EAAE,CAAC,GAAG,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAElD"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/lib/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAQ,MAAM,MAAM,CAAC;AAE7C;;;;;;;;;GASG;AACH,wBAAgB,EAAE,CAAC,GAAG,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAElD"}

package/dist/ui/Alert/Alert.d.ts

@@ -1,5 +1,11 @@
 import { default as React } from 'react';
 import { ViewProps } from 'react-native';
+/**
+ * Props for the Alert component.
+ *
+ * Supports semantic variants (info, success, warning, attention, error)
+ * with design system styling, optional custom icons, and compound content.
+ */
 export interface AlertProps extends ViewProps {
     variant?: 'info' | 'success' | 'warning' | 'attention' | 'error';
     title?: string;
@@ -7,10 +13,12 @@ export interface AlertProps extends ViewProps {
     icon?: React.ReactNode;
     children?: React.ReactNode;
 }
+/** Alert title sub-component with bold font styling. */
 export declare const AlertTitle: React.FC<{
     children: React.ReactNode;
     className?: string;
 }>;
+/** Alert description sub-component with smaller text styling. */
 export declare const AlertDescription: React.FC<{
     children: React.ReactNode;
     className?: string;

package/dist/ui/Alert/Alert.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Alert.d.ts","sourceRoot":"","sources":["../../../src/ui/Alert/Alert.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAI1D,MAAM,WAAW,UAAW,SAAQ,SAAS;IAC3C,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAWD,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC;IAChC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAEA,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC;IACtC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAEA,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC,UAAU,CA8BtC,CAAC"}
+{"version":3,"file":"Alert.d.ts","sourceRoot":"","sources":["../../../src/ui/Alert/Alert.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAI1D;;;;;GAKG;AACH,MAAM,WAAW,UAAW,SAAQ,SAAS;IAC3C,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAWD,wDAAwD;AACxD,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC;IAChC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAEA,CAAC;AAEF,iEAAiE;AACjE,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC;IACtC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAEA,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC,UAAU,CA8BtC,CAAC"}

package/dist/ui/Button/Button.shared.d.ts

@@ -11,15 +11,30 @@ export interface ButtonBaseProps {
     children: ReactNode;
 }
 /**
- * Map size abbreviations to design system variant keys
+ * Map size abbreviations to design system variant keys.
+ *
+ * @param size - The abbreviated size key ('sm', 'lg', or 'default')
+ * @returns The full design system variant key ('small', 'large', or 'default')
  */
 export declare const mapSizeToVariantKey: (size: string | undefined) => string;
 /**
- * Get button variant class from design system
+ * Get button variant class string from the design system.
+ *
+ * Handles gradient variants, web3 variants (wallet/connect/disconnect),
+ * and standard variants with size modifiers.
+ *
+ * @param variantName - The button variant name (e.g., 'primary', 'gradient', 'wallet')
+ * @param sizeName - Optional size abbreviation ('sm' or 'lg')
+ * @param v - The design system variants object
+ * @returns A Tailwind class string from the design system
  */
 export declare const getButtonVariantClass: (variantName: string, sizeName: string | undefined, v: any) => string;
 /**
- * Shared button state logic
+ * Shared button state logic for determining disabled and spinner visibility.
+ *
+ * @param loading - Whether the button is in a loading state
+ * @param disabled - Whether the button is explicitly disabled
+ * @returns An object with `isDisabled` and `showSpinner` booleans
  */
 export declare const useButtonState: (loading: boolean | undefined, disabled: boolean | undefined) => {
     isDisabled: boolean;

package/dist/ui/Button/Button.shared.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Button.shared.d.ts","sourceRoot":"","sources":["../../../src/ui/Button/Button.shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EACJ,SAAS,GACT,SAAS,GACT,WAAW,GACX,SAAS,GACT,OAAO,GACP,aAAa,GACb,qBAAqB,GACrB,SAAS,GACT,MAAM,GACN,UAAU,GACV,oBAAoB,GACpB,kBAAkB,GAClB,QAAQ,GACR,SAAS,GACT,YAAY,CAAC;IACjB,IAAI,CAAC,EAAE,SAAS,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;IACxC,SAAS,CAAC,EACN,MAAM,GACN,OAAO,GACP,MAAM,GACN,OAAO,GACP,MAAM,GACN,SAAS,GACT,KAAK,GACL,SAAS,GACT,aAAa,GACb,YAAY,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAAI,MAAM,MAAM,GAAG,SAAS,KAAG,MAQ9D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAChC,aAAa,MAAM,EACnB,UAAU,MAAM,GAAG,SAAS,EAC5B,GAAG,GAAG,KACL,MAYF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,GACzB,SAAS,OAAO,GAAG,SAAS,EAC5B,UAAU,OAAO,GAAG,SAAS;;;CAI7B,CAAC"}
+{"version":3,"file":"Button.shared.d.ts","sourceRoot":"","sources":["../../../src/ui/Button/Button.shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EACJ,SAAS,GACT,SAAS,GACT,WAAW,GACX,SAAS,GACT,OAAO,GACP,aAAa,GACb,qBAAqB,GACrB,SAAS,GACT,MAAM,GACN,UAAU,GACV,oBAAoB,GACpB,kBAAkB,GAClB,QAAQ,GACR,SAAS,GACT,YAAY,CAAC;IACjB,IAAI,CAAC,EAAE,SAAS,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;IACxC,SAAS,CAAC,EACN,MAAM,GACN,OAAO,GACP,MAAM,GACN,OAAO,GACP,MAAM,GACN,SAAS,GACT,KAAK,GACL,SAAS,GACT,aAAa,GACb,YAAY,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,MAAM,MAAM,GAAG,SAAS,KAAG,MAQ9D,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,qBAAqB,GAChC,aAAa,MAAM,EACnB,UAAU,MAAM,GAAG,SAAS,EAC5B,GAAG,GAAG,KACL,MAYF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GACzB,SAAS,OAAO,GAAG,SAAS,EAC5B,UAAU,OAAO,GAAG,SAAS;;;CAI7B,CAAC"}

package/dist/ui/Card/Card.d.ts

@@ -1,5 +1,12 @@
 import { default as React } from 'react';
 import { ViewProps } from 'react-native';
+/**
+ * Props for the Card component.
+ *
+ * Supports multiple visual variants (bordered, elevated, info, success, etc.),
+ * configurable padding, optional icon display, and a close button for
+ * info-type variants.
+ */
 export interface CardProps extends ViewProps {
     variant?: 'default' | 'bordered' | 'elevated' | 'info' | 'success' | 'warning' | 'error' | 'callout';
     padding?: 'none' | 'sm' | 'md' | 'lg';
@@ -10,13 +17,38 @@ export interface CardProps extends ViewProps {
     /** For info variants: show close button */
     onClose?: () => void;
 }
+/**
+ * Card component for React Native.
+ *
+ * A versatile container with variant-based styling from the design system.
+ * Info-type variants (info, success, warning, error) support an optional
+ * icon and close button.
+ *
+ * @example
+ * ```tsx
+ * <Card variant="elevated" padding="md">
+ *   <CardHeader title="Title" description="Subtitle" />
+ *   <CardContent><Text>Body</Text></CardContent>
+ *   <CardFooter><Button>Action</Button></CardFooter>
+ * </Card>
+ * ```
+ */
 export declare const Card: React.FC<CardProps>;
+/** Props for the CardHeader sub-component. */
 interface CardHeaderProps extends ViewProps {
+    /** Card title rendered as a heading. */
     title?: string;
+    /** Card description rendered below the title. */
     description?: string;
 }
+/**
+ * Card header sub-component with optional title and description.
+ * Uses design system text variants for consistent typography.
+ */
 export declare const CardHeader: React.FC<CardHeaderProps>;
+/** Card body content area. */
 export declare const CardContent: React.FC<ViewProps>;
+/** Card footer area, rendered as a horizontal row with top padding. */
 export declare const CardFooter: React.FC<ViewProps>;
 export {};
 //# sourceMappingURL=Card.d.ts.map

package/dist/ui/Card/Card.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Card.d.ts","sourceRoot":"","sources":["../../../src/ui/Card/Card.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAyB,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAIrE,MAAM,WAAW,SAAU,SAAQ,SAAS;IAC1C,OAAO,CAAC,EACJ,SAAS,GACT,UAAU,GACV,UAAU,GACV,MAAM,GACN,SAAS,GACT,SAAS,GACT,OAAO,GACP,SAAS,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IACtC,qDAAqD;IACrD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2CAA2C;IAC3C,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAYD,eAAO,MAAM,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC,SAAS,CAmDpC,CAAC;AAEF,UAAU,eAAgB,SAAQ,SAAS;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAgBhD,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC,SAAS,CAU3C,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,SAAS,CAU1C,CAAC"}
+{"version":3,"file":"Card.d.ts","sourceRoot":"","sources":["../../../src/ui/Card/Card.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAyB,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAIrE;;;;;;GAMG;AACH,MAAM,WAAW,SAAU,SAAQ,SAAS;IAC1C,OAAO,CAAC,EACJ,SAAS,GACT,UAAU,GACV,UAAU,GACV,MAAM,GACN,SAAS,GACT,SAAS,GACT,OAAO,GACP,SAAS,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IACtC,qDAAqD;IACrD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2CAA2C;IAC3C,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAYD;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC,SAAS,CAmDpC,CAAC;AAEF,8CAA8C;AAC9C,UAAU,eAAgB,SAAQ,SAAS;IACzC,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAgBhD,CAAC;AAEF,8BAA8B;AAC9B,eAAO,MAAM,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC,SAAS,CAU3C,CAAC;AAEF,uEAAuE;AACvE,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,SAAS,CAU1C,CAAC"}

package/dist/ui/Spinner/Spinner.d.ts

@@ -1,10 +1,18 @@
 import { default as React } from 'react';
 import { ViewProps } from 'react-native';
+/**
+ * Props for the Spinner loading indicator component.
+ */
 export interface SpinnerProps extends ViewProps {
+    /** Size of the activity indicator. */
     size?: 'small' | 'default' | 'large' | 'extraLarge';
+    /** Color variant for the spinner. */
     variant?: 'default' | 'white' | 'success' | 'warning' | 'error';
+    /** Accessibility label for screen readers. */
     accessibilityLabel?: string;
+    /** Text shown below the spinner when showText is true. */
     loadingText?: string;
+    /** Whether to display loading text below the spinner. */
     showText?: boolean;
 }
 /**

package/dist/ui/Spinner/Spinner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Spinner.d.ts","sourceRoot":"","sources":["../../../src/ui/Spinner/Spinner.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAiC,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAG7E,MAAM,WAAW,YAAa,SAAQ,SAAS;IAC7C,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,YAAY,CAAC;IACpD,OAAO,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;IAChE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAiBD;;;;;;;GAOG;AACH,eAAO,MAAM,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,YAAY,CA2B1C,CAAC"}
+{"version":3,"file":"Spinner.d.ts","sourceRoot":"","sources":["../../../src/ui/Spinner/Spinner.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAiC,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAG7E;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,SAAS;IAC7C,sCAAsC;IACtC,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,YAAY,CAAC;IACpD,qCAAqC;IACrC,OAAO,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;IAChE,8CAA8C;IAC9C,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAiBD;;;;;;;GAOG;AACH,eAAO,MAAM,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,YAAY,CA2B1C,CAAC"}

package/dist/ui/Toast/Toast.d.ts

@@ -1,4 +1,5 @@
 import { default as React } from 'react';
+/** Data structure representing a single toast notification. */
 export interface ToastMessage {
     id: string;
     title?: string;
@@ -16,11 +17,21 @@ export interface ToastProps {
     /** Remove toast handler */
     onRemove: (id: string) => void;
 }
+/** Context value provided by ToastProvider for managing toast notifications. */
 export interface ToastContextValue {
     toasts: ToastMessage[];
     addToast: (toast: Omit<ToastMessage, 'id'>) => void;
     removeToast: (id: string) => void;
 }
+/**
+ * Hook to access the toast notification system.
+ *
+ * Must be used within a ToastProvider. Returns functions to add and remove
+ * toast notifications, plus the current list of active toasts.
+ *
+ * @returns The toast context value with addToast, removeToast, and toasts
+ * @throws Error if used outside of a ToastProvider
+ */
 export declare const useToast: () => ToastContextValue;
 /**
  * Toast Component

package/dist/ui/Toast/Toast.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Toast.d.ts","sourceRoot":"","sources":["../../../src/ui/Toast/Toast.tsx"],"names":[],"mappings":"AAAA,OAAO,KAON,MAAM,OAAO,CAAC;AAIf,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,IAAI,CAAC;KACrB,CAAC;CACH;AAED,MAAM,WAAW,UAAU;IACzB,oBAAoB;IACpB,KAAK,EAAE,YAAY,CAAC;IACpB,2BAA2B;IAC3B,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,QAAQ,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,KAAK,IAAI,CAAC;IACpD,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAID,eAAO,MAAM,QAAQ,yBAMpB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC,UAAU,CAoFtC,CAAC;AAwBF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,CA+BjE,CAAC"}
+{"version":3,"file":"Toast.d.ts","sourceRoot":"","sources":["../../../src/ui/Toast/Toast.tsx"],"names":[],"mappings":"AAAA,OAAO,KAON,MAAM,OAAO,CAAC;AAIf,+DAA+D;AAC/D,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,IAAI,CAAC;KACrB,CAAC;CACH;AAED,MAAM,WAAW,UAAU;IACzB,oBAAoB;IACpB,KAAK,EAAE,YAAY,CAAC;IACpB,2BAA2B;IAC3B,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AAED,gFAAgF;AAChF,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,QAAQ,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,KAAK,IAAI,CAAC;IACpD,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAID;;;;;;;;GAQG;AACH,eAAO,MAAM,QAAQ,yBAMpB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC,UAAU,CAoFtC,CAAC;AAwBF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,CA+BjE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sudobility/components-rn",
-  "version": "1.0.21",
+  "version": "1.0.22",
   "description": "React Native UI components and design system - Ported from @sudobility/components",
   "type": "module",
   "main": "dist/index.js",
@@ -48,8 +48,8 @@
   ],
   "author": "Sudobility",
   "peerDependencies": {
-    "@sudobility/design": "^1.1.19",
-    "@sudobility/types": "^1.9.53",
+    "@sudobility/design": "^1.1.20",
+    "@sudobility/types": "^1.9.54",
     "nativewind": ">=4.0.0",
     "react": "^18.0.0 || ^19.0.0",
     "react-native": ">=0.72.0",
@@ -62,8 +62,8 @@
   },
   "devDependencies": {
     "@eslint/js": "^9.15.0",
-    "@sudobility/design": "^1.1.19",
-    "@sudobility/types": "^1.9.53",
+    "@sudobility/design": "^1.1.20",
+    "@sudobility/types": "^1.9.54",
     "@testing-library/jest-native": "^5.4.3",
     "@testing-library/react-native": "^13.3.3",
     "@types/jest": "^29.5.0",

package/src/lib/utils.ts

@@ -2,8 +2,13 @@ import { type ClassValue, clsx } from 'clsx';
 
 /**
  * Merges class names for React Native with NativeWind.
- * Unlike web version, we don't need tailwind-merge since NativeWind
- * processes Tailwind classes at build time.
+ *
+ * Unlike the web version (`@sudobility/components`), this does NOT use
+ * `tailwind-merge` since NativeWind processes Tailwind classes at build
+ * time and handles conflict resolution internally.
+ *
+ * @param inputs - Class values to merge (strings, arrays, objects, etc.)
+ * @returns A single merged class name string
  */
 export function cn(...inputs: ClassValue[]): string {
   return clsx(inputs);

package/src/ui/Alert/Alert.tsx

@@ -3,6 +3,12 @@ import { View, Text, type ViewProps } from 'react-native';
 import { cn } from '../../lib/utils';
 import { variants as v } from '@sudobility/design';
 
+/**
+ * Props for the Alert component.
+ *
+ * Supports semantic variants (info, success, warning, attention, error)
+ * with design system styling, optional custom icons, and compound content.
+ */
 export interface AlertProps extends ViewProps {
   variant?: 'info' | 'success' | 'warning' | 'attention' | 'error';
   title?: string;
@@ -20,6 +26,7 @@ const defaultIcons: Record<string, string> = {
   error: '✕',
 };
 
+/** Alert title sub-component with bold font styling. */
 export const AlertTitle: React.FC<{
   children: React.ReactNode;
   className?: string;
@@ -27,6 +34,7 @@ export const AlertTitle: React.FC<{
   <Text className={cn('font-medium mb-1', className)}>{children}</Text>
 );
 
+/** Alert description sub-component with smaller text styling. */
 export const AlertDescription: React.FC<{
   children: React.ReactNode;
   className?: string;

package/src/ui/Button/Button.shared.ts

@@ -38,7 +38,10 @@ export interface ButtonBaseProps {
 }
 
 /**
- * Map size abbreviations to design system variant keys
+ * Map size abbreviations to design system variant keys.
+ *
+ * @param size - The abbreviated size key ('sm', 'lg', or 'default')
+ * @returns The full design system variant key ('small', 'large', or 'default')
  */
 export const mapSizeToVariantKey = (size: string | undefined): string => {
   if (!size) return 'default';
@@ -51,7 +54,15 @@ export const mapSizeToVariantKey = (size: string | undefined): string => {
 };
 
 /**
- * Get button variant class from design system
+ * Get button variant class string from the design system.
+ *
+ * Handles gradient variants, web3 variants (wallet/connect/disconnect),
+ * and standard variants with size modifiers.
+ *
+ * @param variantName - The button variant name (e.g., 'primary', 'gradient', 'wallet')
+ * @param sizeName - Optional size abbreviation ('sm' or 'lg')
+ * @param v - The design system variants object
+ * @returns A Tailwind class string from the design system
  */
 export const getButtonVariantClass = (
   variantName: string,
@@ -72,7 +83,11 @@ export const getButtonVariantClass = (
 };
 
 /**
- * Shared button state logic
+ * Shared button state logic for determining disabled and spinner visibility.
+ *
+ * @param loading - Whether the button is in a loading state
+ * @param disabled - Whether the button is explicitly disabled
+ * @returns An object with `isDisabled` and `showSpinner` booleans
  */
 export const useButtonState = (
   loading: boolean | undefined,

package/src/ui/Card/Card.tsx

@@ -3,6 +3,13 @@ import { View, Text, Pressable, type ViewProps } from 'react-native';
 import { cn } from '../../lib/utils';
 import { textVariants, getCardVariantColors } from '@sudobility/design';
 
+/**
+ * Props for the Card component.
+ *
+ * Supports multiple visual variants (bordered, elevated, info, success, etc.),
+ * configurable padding, optional icon display, and a close button for
+ * info-type variants.
+ */
 export interface CardProps extends ViewProps {
   variant?:
     | 'default'
@@ -32,6 +39,22 @@ const paddingStyles = {
   lg: 'p-8',
 };
 
+/**
+ * Card component for React Native.
+ *
+ * A versatile container with variant-based styling from the design system.
+ * Info-type variants (info, success, warning, error) support an optional
+ * icon and close button.
+ *
+ * @example
+ * ```tsx
+ * <Card variant="elevated" padding="md">
+ *   <CardHeader title="Title" description="Subtitle" />
+ *   <CardContent><Text>Body</Text></CardContent>
+ *   <CardFooter><Button>Action</Button></CardFooter>
+ * </Card>
+ * ```
+ */
 export const Card: React.FC<CardProps> = ({
   variant = 'elevated',
   padding = 'md',
@@ -85,11 +108,18 @@ export const Card: React.FC<CardProps> = ({
   );
 };
 
+/** Props for the CardHeader sub-component. */
 interface CardHeaderProps extends ViewProps {
+  /** Card title rendered as a heading. */
   title?: string;
+  /** Card description rendered below the title. */
   description?: string;
 }
 
+/**
+ * Card header sub-component with optional title and description.
+ * Uses design system text variants for consistent typography.
+ */
 export const CardHeader: React.FC<CardHeaderProps> = ({
   title,
   description,
@@ -108,6 +138,7 @@ export const CardHeader: React.FC<CardHeaderProps> = ({
   );
 };
 
+/** Card body content area. */
 export const CardContent: React.FC<ViewProps> = ({
   className,
   children,
@@ -120,6 +151,7 @@ export const CardContent: React.FC<ViewProps> = ({
   );
 };
 
+/** Card footer area, rendered as a horizontal row with top padding. */
 export const CardFooter: React.FC<ViewProps> = ({
   className,
   children,

package/src/ui/Spinner/Spinner.tsx

@@ -2,11 +2,19 @@ import React from 'react';
 import { View, ActivityIndicator, Text, type ViewProps } from 'react-native';
 import { cn } from '../../lib/utils';
 
+/**
+ * Props for the Spinner loading indicator component.
+ */
 export interface SpinnerProps extends ViewProps {
+  /** Size of the activity indicator. */
   size?: 'small' | 'default' | 'large' | 'extraLarge';
+  /** Color variant for the spinner. */
   variant?: 'default' | 'white' | 'success' | 'warning' | 'error';
+  /** Accessibility label for screen readers. */
   accessibilityLabel?: string;
+  /** Text shown below the spinner when showText is true. */
   loadingText?: string;
+  /** Whether to display loading text below the spinner. */
   showText?: boolean;
 }
 

package/src/ui/Toast/Toast.tsx

@@ -9,6 +9,7 @@ import React, {
 import { View, Text, Pressable, Animated, SafeAreaView } from 'react-native';
 import { cn } from '../../lib/utils';
 
+/** Data structure representing a single toast notification. */
 export interface ToastMessage {
   id: string;
   title?: string;
@@ -28,6 +29,7 @@ export interface ToastProps {
   onRemove: (id: string) => void;
 }
 
+/** Context value provided by ToastProvider for managing toast notifications. */
 export interface ToastContextValue {
   toasts: ToastMessage[];
   addToast: (toast: Omit<ToastMessage, 'id'>) => void;
@@ -36,6 +38,15 @@ export interface ToastContextValue {
 
 const ToastContext = createContext<ToastContextValue | undefined>(undefined);
 
+/**
+ * Hook to access the toast notification system.
+ *
+ * Must be used within a ToastProvider. Returns functions to add and remove
+ * toast notifications, plus the current list of active toasts.
+ *
+ * @returns The toast context value with addToast, removeToast, and toasts
+ * @throws Error if used outside of a ToastProvider
+ */
 export const useToast = () => {
   const context = useContext(ToastContext);
   if (!context) {