@cdx-ui/components 0.0.1-alpha.2 → 0.0.1-alpha.20

package/lib/typescript/components/Switch/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/Switch/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAgB,MAAM,oBAAoB,CAAC;AAErE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAInD,MAAM,WAAW,WAAY,SAAQ,YAAY,EAAE,kBAAkB;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,MAAM,mKAAkB,CAAC;AAEtC,YAAY,EAAE,kBAAkB,EAAE,CAAC"}

package/lib/typescript/components/Switch/styles.d.ts

@@ -0,0 +1,26 @@
+import { type VariantProps } from 'class-variance-authority';
+export declare const switchThumbColorVariants: (props?: ({
+    isDisabled?: boolean | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export declare const switchTrackOnVariants: (props?: ({
+    isInvalid?: boolean | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export declare const switchTrackOffVariants: (props?: ({
+    isInvalid?: boolean | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export declare const switchIosBgVariants: (props?: ({
+    isInvalid?: boolean | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export declare const switchTrackVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export declare const switchWebTrackColorVariants: (props?: ({
+    isChecked?: boolean | null | undefined;
+    isInvalid?: boolean | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export declare const switchThumbVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+    isChecked?: boolean | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export type SwitchVariantProps = VariantProps<typeof switchTrackVariants>;
+//# sourceMappingURL=styles.d.ts.map

package/lib/typescript/components/Switch/styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../../src/components/Switch/styles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAMlE,eAAO,MAAM,wBAAwB;;8EAQnC,CAAC;AAEH,eAAO,MAAM,qBAAqB;;8EAQhC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;8EAQjC,CAAC;AAEH,eAAO,MAAM,mBAAmB;;8EAQ9B,CAAC;AAMH,eAAO,MAAM,mBAAmB;;8EAoB/B,CAAC;AAEF,eAAO,MAAM,2BAA2B;;;8EAmBtC,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;8EAwB/B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,YAAY,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/lib/typescript/components/Text/index.d.ts

@@ -1,2 +1,10 @@
-export * from './Text';
+import { type ComponentPropsWithoutRef } from 'react';
+import { Text as RNText } from 'react-native';
+import { TextVariantProps } from './styles';
+export type TextProps = TextVariantProps & ComponentPropsWithoutRef<typeof RNText> & {
+    className?: string;
+};
+export declare const Text: import("react").ForwardRefExoticComponent<TextVariantProps & import("react-native").TextProps & {
+    className?: string;
+} & import("react").RefAttributes<RNText>>;
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/components/Text/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/Text/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/Text/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,wBAAwB,EAAqB,MAAM,OAAO,CAAC;AACrF,OAAO,EAAE,IAAI,IAAI,MAAM,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,EAAa,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEvD,MAAM,MAAM,SAAS,GAAG,gBAAgB,GACtC,wBAAwB,CAAC,OAAO,MAAM,CAAC,GAAG;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnE,eAAO,MAAM,IAAI;gBAFyC,MAAM;0CAO9D,CAAC"}

package/lib/typescript/components/Text/styles.d.ts

@@ -0,0 +1,6 @@
+import { type VariantProps } from 'class-variance-authority';
+export declare const textStyle: (props?: ({
+    size?: "sm" | "md" | "lg" | "xl" | "xs" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export type TextVariantProps = VariantProps<typeof textStyle>;
+//# sourceMappingURL=styles.d.ts.map

package/lib/typescript/components/Text/styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../../src/components/Text/styles.tsx"],"names":[],"mappings":"AACA,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGlE,eAAO,MAAM,SAAS;;8EAmBrB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,YAAY,CAAC,OAAO,SAAS,CAAC,CAAC"}

package/lib/typescript/components/VirtualizedList/index.d.ts

@@ -0,0 +1,8 @@
+import type { ForwardedRef, ReactElement } from 'react';
+import { type FlashListProps, type FlashListRef } from '@shopify/flash-list';
+export type VirtualizedListRef = FlashListRef<unknown>;
+export type VirtualizedListProps<T = unknown> = FlashListProps<T>;
+export declare const VirtualizedList: <T>(props: VirtualizedListProps<T> & {
+    ref?: ForwardedRef<FlashListRef<T>>;
+}) => ReactElement | null;
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/components/VirtualizedList/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/VirtualizedList/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAExD,OAAO,EAAa,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExF,MAAM,MAAM,kBAAkB,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;AACvD,MAAM,MAAM,oBAAoB,CAAC,CAAC,GAAG,OAAO,IAAI,cAAc,CAAC,CAAC,CAAC,CAAC;AASlE,eAAO,MAAM,eAAe,EAAuC,CAAC,CAAC,EACnE,KAAK,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAAG;IAAE,GAAG,CAAC,EAAE,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAA;CAAE,KACrE,YAAY,GAAG,IAAI,CAAC"}

package/lib/typescript/components/index.d.ts

@@ -1,7 +1,16 @@
+export * from './Avatar';
 export * from './Box';
 export * from './Button';
+export * from './Chip';
+export * from './Card';
+export * from './Checkbox';
 export * from './Input';
+export * from './Link';
 export * from './Select';
+export * from './VirtualizedList';
+export * from './Switch';
 export { HStack, VStack } from './Stack';
+export * from './Heading';
 export * from './Text';
+export * from './Icon';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/components/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACzC,cAAc,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACzC,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC"}

package/lib/typescript/metro/withCdxMetroConfig.d.ts

@@ -0,0 +1,19 @@
+import type { MetroConfig } from 'metro-config';
+export interface CdxMetroConfigOptions {
+    /** Path to the CSS entry file (e.g., `'./global.css'`). */
+    cssEntryFile: string;
+    /** Path where generated Tailwind class type definitions are written. */
+    generatedTypesFile?: string;
+}
+/**
+ * Wraps a Metro config with CDX UI's styling-layer configuration.
+ *
+ * Today this delegates to Uniwind. If the styling layer is swapped (see
+ * `docs/research/uniwind-to-nativewind-contingency.md`), only the internals
+ * of this function change — consuming Metro configs stay the same.
+ *
+ * Must be the **outermost** Metro config wrapper (after any other wrappers
+ * like `withStorybook`).
+ */
+export declare function withCdxMetroConfig<T extends MetroConfig>(config: T, options: CdxMetroConfigOptions): T;
+//# sourceMappingURL=withCdxMetroConfig.d.ts.map

package/lib/typescript/metro/withCdxMetroConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"withCdxMetroConfig.d.ts","sourceRoot":"","sources":["../../../src/metro/withCdxMetroConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,MAAM,WAAW,qBAAqB;IACpC,2DAA2D;IAC3D,YAAY,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,WAAW,EACtD,MAAM,EAAE,CAAC,EACT,OAAO,EAAE,qBAAqB,GAC7B,CAAC,CAKH"}

package/lib/typescript/styles/index.d.ts

@@ -0,0 +1,2 @@
+export * from './primitives';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/styles/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/styles/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC"}

package/lib/typescript/styles/primitives.d.ts

@@ -0,0 +1,85 @@
+export declare const COLOR_BG_PRIMARY = "bg-white";
+export declare const COLOR_BG_SUBTLE = "bg-slate-50";
+export declare const COLOR_BG_MUTED = "bg-slate-100";
+export declare const COLOR_BG_INVERSE = "bg-slate-900";
+export declare const COLOR_BORDER_DEFAULT = "border-slate-200";
+export declare const COLOR_BORDER_STRONG = "border-slate-300";
+export declare const COLOR_BORDER_FOCUS = "border-slate-900";
+export declare const COLOR_BORDER_INVALID = "border-red-500";
+export declare const COLOR_TEXT_PRIMARY = "text-slate-900";
+export declare const COLOR_TEXT_SECONDARY = "text-slate-500";
+export declare const COLOR_TEXT_MUTED = "text-slate-400";
+export declare const COLOR_TEXT_INVERSE = "text-white";
+export declare const COLOR_TEXT_PLACEHOLDER = "text-slate-400";
+export declare const COLOR_TEXT_INVALID = "text-red-600";
+export declare const COLOR_BRAND_DEFAULT = "bg-slate-900";
+export declare const COLOR_BRAND_HOVER = "bg-slate-800";
+export declare const COLOR_BRAND_ACTIVE = "bg-slate-700";
+export declare const COLOR_ACCENT_DEFAULT = "bg-slate-900";
+export declare const COLOR_ACCENT_BORDER = "border-slate-900";
+export declare const SEMANTIC_COLORS: {
+    readonly action: {
+        readonly bg: "bg-slate-900";
+        readonly bgHover: "bg-slate-800";
+        readonly bgActive: "bg-slate-700";
+        readonly border: "border-slate-900";
+        readonly text: "text-slate-900";
+        readonly ring: "ring-slate-400/50";
+    };
+    readonly danger: {
+        readonly bg: "bg-red-600";
+        readonly bgHover: "bg-red-700";
+        readonly bgActive: "bg-red-800";
+        readonly border: "border-red-600";
+        readonly text: "text-red-600";
+        readonly ring: "ring-red-400/50";
+    };
+    readonly warning: {
+        readonly bg: "bg-amber-500";
+        readonly bgHover: "bg-amber-600";
+        readonly bgActive: "bg-amber-700";
+        readonly border: "border-amber-500";
+        readonly text: "text-amber-600";
+        readonly ring: "ring-amber-400/50";
+    };
+    readonly success: {
+        readonly bg: "bg-green-600";
+        readonly bgHover: "bg-green-700";
+        readonly bgActive: "bg-green-800";
+        readonly border: "border-green-600";
+        readonly text: "text-green-600";
+        readonly ring: "ring-green-400/50";
+    };
+    readonly info: {
+        readonly bg: "bg-sky-500";
+        readonly bgHover: "bg-sky-600";
+        readonly bgActive: "bg-sky-700";
+        readonly border: "border-sky-500";
+        readonly text: "text-sky-600";
+        readonly ring: "ring-sky-400/50";
+    };
+};
+export declare const FOCUS_RING = "ring-2 ring-slate-400/50 ring-offset-2";
+export declare const RADIUS_SM = "rounded-lg";
+export declare const RADIUS_MD = "rounded-xl";
+export declare const RADIUS_FULL = "rounded-full";
+export declare const SHADOW_SM = "shadow-sm";
+export declare const SHADOW_MD = "shadow-md";
+export declare const SIZE_SCALE: {
+    readonly default: {
+        readonly height: "h-10";
+        readonly px: "px-4";
+        readonly gap: "gap-2";
+        readonly text: "text-base";
+    };
+    readonly small: {
+        readonly height: "h-8";
+        readonly px: "px-3";
+        readonly gap: "gap-1.5";
+        readonly text: "text-sm";
+    };
+};
+export declare const TRANSITION_COLORS = "transition-colors duration-150";
+export declare const DISABLED_OPACITY = "data-[disabled=true]:opacity-50";
+export declare const DISABLED_CURSOR = "data-[disabled=true]:cursor-not-allowed data-[disabled=true]:pointer-events-none";
+//# sourceMappingURL=primitives.d.ts.map

package/lib/typescript/styles/primitives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../../src/styles/primitives.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,gBAAgB,aAAa,CAAC;AAC3C,eAAO,MAAM,eAAe,gBAAgB,CAAC;AAC7C,eAAO,MAAM,cAAc,iBAAiB,CAAC;AAC7C,eAAO,MAAM,gBAAgB,iBAAiB,CAAC;AAG/C,eAAO,MAAM,oBAAoB,qBAAqB,CAAC;AACvD,eAAO,MAAM,mBAAmB,qBAAqB,CAAC;AACtD,eAAO,MAAM,kBAAkB,qBAAqB,CAAC;AACrD,eAAO,MAAM,oBAAoB,mBAAmB,CAAC;AAGrD,eAAO,MAAM,kBAAkB,mBAAmB,CAAC;AACnD,eAAO,MAAM,oBAAoB,mBAAmB,CAAC;AACrD,eAAO,MAAM,gBAAgB,mBAAmB,CAAC;AACjD,eAAO,MAAM,kBAAkB,eAAe,CAAC;AAC/C,eAAO,MAAM,sBAAsB,mBAAmB,CAAC;AACvD,eAAO,MAAM,kBAAkB,iBAAiB,CAAC;AAGjD,eAAO,MAAM,mBAAmB,iBAAiB,CAAC;AAClD,eAAO,MAAM,iBAAiB,iBAAiB,CAAC;AAChD,eAAO,MAAM,kBAAkB,iBAAiB,CAAC;AAGjD,eAAO,MAAM,oBAAoB,iBAAiB,CAAC;AACnD,eAAO,MAAM,mBAAmB,qBAAqB,CAAC;AAItD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyClB,CAAC;AAGX,eAAO,MAAM,UAAU,2CAA2C,CAAC;AAGnE,eAAO,MAAM,SAAS,eAAe,CAAC;AACtC,eAAO,MAAM,SAAS,eAAe,CAAC;AACtC,eAAO,MAAM,WAAW,iBAAiB,CAAC;AAG1C,eAAO,MAAM,SAAS,cAAc,CAAC;AACrC,eAAO,MAAM,SAAS,cAAc,CAAC;AAMrC,eAAO,MAAM,UAAU;;;;;;;;;;;;;CAGb,CAAC;AAGX,eAAO,MAAM,iBAAiB,mCAAmC,CAAC;AAGlE,eAAO,MAAM,gBAAgB,oCAAoC,CAAC;AAClE,eAAO,MAAM,eAAe,qFACwD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cdx-ui/components",
-  "version": "0.0.1-alpha.2",
+  "version": "0.0.1-alpha.20",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",
   "react-native": "src/index.ts",
@@ -9,13 +9,18 @@
   "exports": {
     ".": {
       "react-native": "./src/index.ts",
-      "source": "./src/index.ts",
       "types": "./lib/typescript/index.d.ts",
       "import": "./lib/module/index.js",
       "require": "./lib/commonjs/index.js",
       "default": "./lib/module/index.js"
     },
-    "./styles.css": "./src/styles.css"
+    "./styles.css": "./src/styles.css",
+    "./metro": {
+      "types": "./lib/typescript/metro/withCdxMetroConfig.d.ts",
+      "require": "./lib/commonjs/metro/withCdxMetroConfig.js",
+      "import": "./lib/module/metro/withCdxMetroConfig.js",
+      "default": "./lib/commonjs/metro/withCdxMetroConfig.js"
+    }
   },
   "files": [
     "lib",
@@ -36,29 +41,32 @@
     ]
   },
   "peerDependencies": {
-    "react": "*",
-    "react-native": "*",
-    "react-native-web": "*",
-    "uniwind": "*"
+    "@shopify/flash-list": ">=2.0.0",
+    "react": "^18.2.0 || ^19.0.0",
+    "react-native": ">=0.76.0",
+    "react-native-reanimated": ">=3.0.0",
+    "react-native-web": ">=0.19.0"
   },
   "peerDependenciesMeta": {
-    "react-native": {
+    "@shopify/flash-list": {
       "optional": true
     },
-    "react-native-web": {
+    "react-native": {
       "optional": true
     },
-    "react-dom": {
+    "react-native-reanimated": {
       "optional": true
     },
-    "uniwind": {
+    "react-native-web": {
       "optional": true
     }
   },
   "dependencies": {
     "class-variance-authority": "^0.7.1",
-    "@cdx-ui/primitives": "0.0.1-alpha.2",
-    "@cdx-ui/utils": "0.0.1-alpha.2"
+    "uniwind": "1.4.1",
+    "@cdx-ui/primitives": "0.0.1-alpha.20",
+    "@cdx-ui/utils": "0.0.1-alpha.20",
+    "@cdx-ui/icons": "0.0.1-alpha.20"
   },
   "devDependencies": {
     "@types/react": "*",

package/src/components/Avatar/index.tsx

@@ -0,0 +1,174 @@
+import { forwardRef, type ReactNode } from 'react';
+import { Image, Text, View, type ImageProps, type TextProps, type ViewProps } from 'react-native';
+import { createAvatar, type IAvatarImageProps, type IAvatarProps } from '@cdx-ui/primitives';
+import { cn, useStyleContext, withStyleContext } from '@cdx-ui/utils';
+import { Icon as IconComponent, type IconProps } from '../Icon';
+import {
+  type AvatarVariantProps,
+  avatarBadgeVariants,
+  avatarIconVariants,
+  avatarTextVariants,
+  avatarImageVariants,
+  avatarRootVariants,
+} from './styles';
+
+const SCOPE = 'AVATAR';
+
+const Root = withStyleContext(View, SCOPE);
+
+const useAvatarStyleContext = () => useStyleContext(SCOPE) as AvatarVariantProps;
+
+const AvatarPrimitive = createAvatar({
+  Root,
+  Image,
+  Text,
+  Icon: IconComponent,
+  Badge: View,
+});
+
+// =============================================================================
+// AVATAR ROOT
+// =============================================================================
+
+export interface AvatarProps extends ViewProps, IAvatarProps, AvatarVariantProps {
+  className?: string;
+  children?: ReactNode;
+}
+
+const AvatarRoot = forwardRef<View, AvatarProps>(
+  ({ size = 'lg', className, children, style, ...props }, ref) => {
+    const computedClassName = cn(avatarRootVariants({ size }), className);
+
+    return (
+      <AvatarPrimitive
+        ref={ref as never}
+        className={computedClassName}
+        style={style}
+        context={{ size }}
+        {...props}
+      >
+        {children}
+      </AvatarPrimitive>
+    );
+  },
+);
+
+AvatarRoot.displayName = 'Avatar';
+
+// =============================================================================
+// AVATAR IMAGE
+// =============================================================================
+
+export interface AvatarImageProps extends Omit<ImageProps, 'source'>, IAvatarImageProps {
+  className?: string;
+}
+
+const AvatarImage = forwardRef<Image, AvatarImageProps>(({ className, style, ...props }, ref) => {
+  const computedClassName = cn(avatarImageVariants(), className);
+
+  return (
+    <AvatarPrimitive.Image
+      ref={ref as never}
+      className={computedClassName}
+      style={style}
+      {...props}
+    />
+  );
+});
+
+AvatarImage.displayName = 'Avatar.Image';
+
+// =============================================================================
+// AVATAR TEXT
+// =============================================================================
+
+export interface AvatarTextProps extends TextProps {
+  className?: string;
+  children?: ReactNode;
+}
+
+const AvatarText = forwardRef<Text, AvatarTextProps>(
+  ({ className, children, style, ...props }, ref) => {
+    const { size } = useAvatarStyleContext();
+    const computedClassName = cn(avatarTextVariants({ size }), className);
+
+    return (
+      <AvatarPrimitive.Text
+        ref={ref as never}
+        className={computedClassName}
+        style={style}
+        {...props}
+      >
+        {children}
+      </AvatarPrimitive.Text>
+    );
+  },
+);
+
+AvatarText.displayName = 'Avatar.Text';
+
+// =============================================================================
+// AVATAR ICON
+// =============================================================================
+
+export interface AvatarIconProps extends Omit<IconProps, 'children'> {
+  className?: string;
+}
+
+const AvatarIcon = ({ className, style, ...props }: AvatarIconProps) => {
+  const { size } = useAvatarStyleContext();
+  const computedClassName = cn(avatarIconVariants({ size }), className);
+
+  return <AvatarPrimitive.Icon className={computedClassName} style={style} {...props} />;
+};
+
+AvatarIcon.displayName = 'Avatar.Icon';
+
+// =============================================================================
+// AVATAR BADGE
+// =============================================================================
+
+export interface AvatarBadgeProps extends ViewProps {
+  className?: string;
+  children?: ReactNode;
+}
+
+const AvatarBadge = forwardRef<View, AvatarBadgeProps>(
+  ({ className, children, style, ...props }, ref) => {
+    const { size } = useAvatarStyleContext();
+    const computedClassName = cn(avatarBadgeVariants({ size }), className);
+
+    return (
+      <AvatarPrimitive.Badge
+        ref={ref as never}
+        className={computedClassName}
+        style={style}
+        {...props}
+      >
+        {children}
+      </AvatarPrimitive.Badge>
+    );
+  },
+);
+
+AvatarBadge.displayName = 'Avatar.Badge';
+
+// =============================================================================
+// COMPOUND COMPONENT
+// =============================================================================
+
+type AvatarCompoundComponent = typeof AvatarRoot & {
+  Image: typeof AvatarImage;
+  Text: typeof AvatarText;
+  Icon: typeof AvatarIcon;
+  Badge: typeof AvatarBadge;
+};
+
+export const Avatar = Object.assign(AvatarRoot, {
+  Image: AvatarImage,
+  Text: AvatarText,
+  Icon: AvatarIcon,
+  Badge: AvatarBadge,
+}) as AvatarCompoundComponent;
+
+export type { AvatarVariantProps };

package/src/components/Avatar/styles.ts

@@ -0,0 +1,83 @@
+import { cva, type VariantProps } from 'class-variance-authority';
+import { COLOR_BG_MUTED, COLOR_TEXT_SECONDARY, RADIUS_FULL } from '../../styles/primitives';
+
+// ── Root ─────────────────────────────────────────────────
+
+export const avatarRootVariants = cva(
+  [RADIUS_FULL, 'relative items-center justify-center', COLOR_BG_MUTED],
+  {
+    variants: {
+      size: {
+        sm: 'w-8 h-8',
+        md: 'w-10 h-10',
+        lg: 'w-12 h-12',
+        xl: 'w-16 h-16',
+        '2xl': 'w-20 h-20',
+      },
+    },
+    defaultVariants: {
+      size: 'lg',
+    },
+  },
+);
+
+// ── Image ────────────────────────────────────────────────
+
+export const avatarImageVariants = cva([
+  'absolute top-0 left-0 w-full h-full',
+  RADIUS_FULL,
+  'overflow-hidden',
+]);
+
+// ── Text ─────────────────────────────────────────────────
+
+export const avatarTextVariants = cva([COLOR_TEXT_SECONDARY, 'font-semibold'], {
+  variants: {
+    size: {
+      sm: 'text-xs',
+      md: 'text-sm',
+      lg: 'text-base',
+      xl: 'text-xl',
+      '2xl': 'text-2xl',
+    },
+  },
+  defaultVariants: {
+    size: 'lg',
+  },
+});
+
+// ── Icon ─────────────────────────────────────────────────
+
+export const avatarIconVariants = cva([COLOR_TEXT_SECONDARY], {
+  variants: {
+    size: {
+      sm: 'size-4',
+      md: 'size-5',
+      lg: 'size-6',
+      xl: 'size-8',
+      '2xl': 'size-10',
+    },
+  },
+  defaultVariants: {
+    size: 'lg',
+  },
+});
+
+// ── Badge ────────────────────────────────────────────────
+
+export const avatarBadgeVariants = cva(['absolute border-2 border-white', RADIUS_FULL], {
+  variants: {
+    size: {
+      sm: 'w-2.5 h-2.5 bottom-0 right-0',
+      md: 'w-3 h-3 bottom-0 right-0',
+      lg: 'w-3.5 h-3.5 bottom-0 right-0',
+      xl: 'w-4 h-4 bottom-0.5 right-0.5',
+      '2xl': 'w-5 h-5 bottom-0.5 right-0.5',
+    },
+  },
+  defaultVariants: {
+    size: 'lg',
+  },
+});
+
+export type AvatarVariantProps = VariantProps<typeof avatarRootVariants>;

package/src/components/Box/Box.tsx

@@ -8,6 +8,7 @@ export interface BoxProps extends ViewProps {
   textProps?: TextProps;
 }
 
+/** @deprecated Use View instead */
 export const Box = forwardRef<View, BoxProps>(
   ({ style, className, children, textProps, ...restProps }, ref: ForwardedRef<View>) => {
     return (

package/src/components/Button/index.tsx

@@ -11,10 +11,12 @@ import {
 } from 'react-native';
 import { createButton, type IButtonProps } from '@cdx-ui/primitives';
 import { cn, useStyleContext, withStyleContext } from '@cdx-ui/utils';
+import { Icon, IconProps } from '../Icon';
 import {
   type ButtonGroupVariantProps,
   type ButtonVariantProps,
   buttonGroupVariants,
+  buttonIconVariants,
   buttonRootVariants,
   buttonSpinnerVariants,
   buttonTextVariants,
@@ -46,9 +48,10 @@ export interface ButtonProps extends PressableProps, IButtonProps, ButtonVariant
 const ButtonRoot = forwardRef<View, ButtonProps>(
   (
     {
-      variant = 'solid',
-      color = 'primary',
-      size = 'md',
+      variant = 'strong',
+      color = 'action',
+      size = 'default',
+      mode = 'light',
       fullWidth = false,
       className,
       children,
@@ -58,7 +61,7 @@ const ButtonRoot = forwardRef<View, ButtonProps>(
     ref,
   ) => {
     const computedClassName = cn(
-      buttonRootVariants({ variant, color, size, fullWidth }),
+      buttonRootVariants({ variant, color, size, mode, fullWidth }),
       className,
     );
 
@@ -67,7 +70,7 @@ const ButtonRoot = forwardRef<View, ButtonProps>(
         ref={ref}
         className={computedClassName}
         style={style}
-        context={{ variant, color, size, fullWidth }}
+        context={{ variant, color, size, mode, fullWidth }}
         {...props}
       >
         {children}
@@ -89,9 +92,9 @@ export interface ButtonTextProps extends TextProps {
 
 const ButtonLabel = forwardRef<Text, ButtonTextProps>(
   ({ className, children, style, ...props }, ref) => {
-    const { variant, color, size } = useButtonStyleContext();
+    const { variant, color, size, mode } = useButtonStyleContext();
 
-    const computedClassName = cn(buttonTextVariants({ variant, color, size }), className);
+    const computedClassName = cn(buttonTextVariants({ variant, color, size, mode }), className);
 
     return (
       <ButtonPrimitive.Text ref={ref} className={computedClassName} style={style} {...props}>
@@ -135,13 +138,15 @@ const ButtonGroup = forwardRef<View, ButtonGroupProps>(
 
 ButtonGroup.displayName = 'Button.Group';
 
-export interface ButtonIconProps extends ViewProps {
-  className?: string;
-}
+export interface ButtonIconProps extends Omit<IconProps, 'children'> {}
 
-const ButtonIcon = forwardRef<View, ButtonIconProps>(({ className, style, ...props }, ref) => {
-  return <ButtonPrimitive.Icon ref={ref} className={className} style={style} {...props} />;
-});
+const ButtonIcon = ({ className, style, as, ...props }: ButtonIconProps) => {
+  const { size } = useButtonStyleContext();
+
+  const computedClassName = cn(buttonIconVariants({ size }), className);
+
+  return <Icon as={as} className={computedClassName} style={style} {...props} />;
+};
 
 ButtonIcon.displayName = 'Button.Icon';
 
@@ -152,8 +157,11 @@ export interface ButtonSpinnerProps extends ActivityIndicatorProps {
 
 const ButtonSpinner = forwardRef<ActivityIndicator, ButtonSpinnerProps>(
   ({ className, colorClassName, style, ...props }, ref) => {
-    const { variant, color } = useButtonStyleContext();
-    const computedColorClassName = cn(buttonSpinnerVariants({ variant, color }), colorClassName);
+    const { variant, color, mode } = useButtonStyleContext();
+    const computedColorClassName = cn(
+      buttonSpinnerVariants({ variant, color, mode }),
+      colorClassName,
+    );
 
     return (
       <ButtonPrimitive.Spinner