@cdx-ui/components 0.0.1-beta.110 → 0.0.1-beta.112

package/lib/module/components/Link/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["forwardRef","Platform","Text","View","LinkRoot","LinkRootPrimitive","Slot","dataAttributes","mergeDataAttributes","useLinkInteractionContext","cn","Icon","linkIconVariants","linkLabelVariants","linkNativeUnderlineVariants","linkRootVariants","jsx","_jsx","LinkProvider","className","children","style","props","ref","rootClassName","slot","displayName","LinkLabel","asChild","visited","computedClassName","Comp","textElement","OS","LinkIcon","as","Link","Object","assign","Label"],"sourceRoot":"../../../../src","sources":["components/Link/index.tsx"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["forwardRef","Platform","Text","View","LinkRoot","LinkRootPrimitive","Slot","dataAttributes","mergeDataAttributes","useLinkInteractionContext","cn","Icon","linkIconVariants","linkLabelVariants","linkNativeUnderlineVariants","linkRootVariants","jsx","_jsx","LinkProvider","className","children","style","props","ref","rootClassName","slot","displayName","LinkLabel","asChild","visited","computedClassName","Comp","textElement","OS","LinkIcon","as","Link","Object","assign","Label"],"sourceRoot":"../../../../src","sources":["components/Link/index.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/components/index.js

@@ -8,6 +8,7 @@ export * from './BottomSheet';
 export * from './Box';
 export * from './Button';
 export * from './Card';
+export * from './Carousel';
 export * from './Checkbox';
 export * from './Chip';
 export * from './CurrencyInput';

package/lib/module/components/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["HStack","VStack"],"sourceRoot":"../../../src","sources":["components/index.ts"],"mappings":";;AAAA,cAAc,SAAS;AACvB,cAAc,eAAe;AAC7B,cAAc,UAAU;AACxB,cAAc,SAAS;AACvB,cAAc,eAAe;AAC7B,cAAc,OAAO;AACrB,cAAc,UAAU;AACxB,cAAc,QAAQ;AACtB,cAAc,YAAY;AAC1B,cAAc,QAAQ;AACtB,cAAc,iBAAiB;AAC/B,cAAc,UAAU;AACxB,cAAc,WAAW;AACzB,cAAc,SAAS;AACvB,cAAc,QAAQ;AACtB,cAAc,SAAS;AACvB,cAAc,uBAAuB;AACrC,cAAc,SAAS;AACvB,cAAc,YAAY;AAC1B,cAAc,QAAQ;AACtB,cAAc,YAAY;AAC1B,cAAc,eAAe;AAC7B,cAAc,YAAY;AAC1B,cAAc,qBAAqB;AACnC,cAAc,SAAS;AACvB,cAAc,eAAe;AAC7B,cAAc,UAAU;AACxB,cAAc,mBAAmB;AACjC,cAAc,UAAU;AACxB,cAAc,YAAY;AAC1B,cAAc,QAAQ;AACtB,cAAc,SAAS;AACvB,SAASA,MAAM,EAAEC,MAAM,QAAQ,SAAS;AACxC,cAAc,WAAW;AACzB,cAAc,QAAQ;AACtB,cAAc,QAAQ;AACtB,cAAc,cAAc;AAC5B,cAAc,qBAAqB","ignoreList":[]}
+{"version":3,"names":["HStack","VStack"],"sourceRoot":"../../../src","sources":["components/index.ts"],"mappings":";;AAAA,cAAc,SAAS;AACvB,cAAc,eAAe;AAC7B,cAAc,UAAU;AACxB,cAAc,SAAS;AACvB,cAAc,eAAe;AAC7B,cAAc,OAAO;AACrB,cAAc,UAAU;AACxB,cAAc,QAAQ;AACtB,cAAc,YAAY;AAC1B,cAAc,YAAY;AAC1B,cAAc,QAAQ;AACtB,cAAc,iBAAiB;AAC/B,cAAc,UAAU;AACxB,cAAc,WAAW;AACzB,cAAc,SAAS;AACvB,cAAc,QAAQ;AACtB,cAAc,SAAS;AACvB,cAAc,uBAAuB;AACrC,cAAc,SAAS;AACvB,cAAc,YAAY;AAC1B,cAAc,QAAQ;AACtB,cAAc,YAAY;AAC1B,cAAc,eAAe;AAC7B,cAAc,YAAY;AAC1B,cAAc,qBAAqB;AACnC,cAAc,SAAS;AACvB,cAAc,eAAe;AAC7B,cAAc,UAAU;AACxB,cAAc,mBAAmB;AACjC,cAAc,UAAU;AACxB,cAAc,YAAY;AAC1B,cAAc,QAAQ;AACtB,cAAc,SAAS;AACvB,SAASA,MAAM,EAAEC,MAAM,QAAQ,SAAS;AACxC,cAAc,WAAW;AACzB,cAAc,QAAQ;AACtB,cAAc,QAAQ;AACtB,cAAc,cAAc;AAC5B,cAAc,qBAAqB","ignoreList":[]}

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

@@ -1,9 +1,6 @@
 import { View, type ViewProps } from 'react-native';
-import type { TextProps } from '../Text';
 export interface BoxProps extends ViewProps {
     className?: string;
-    textProps?: TextProps;
 }
-/** @deprecated Use View instead */
 export declare const Box: import("react").ForwardRefExoticComponent<BoxProps & import("react").RefAttributes<View>>;
 //# sourceMappingURL=Box.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Box.d.ts","sourceRoot":"","sources":["../../../../src/components/Box/Box.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAEpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC,MAAM,WAAW,QAAS,SAAQ,SAAS;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,mCAAmC;AACnC,eAAO,MAAM,GAAG,2FAQf,CAAC"}
+{"version":3,"file":"Box.d.ts","sourceRoot":"","sources":["../../../../src/components/Box/Box.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAEpD,MAAM,WAAW,QAAS,SAAQ,SAAS;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,GAAG,2FAQf,CAAC"}

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

@@ -0,0 +1,70 @@
+import { type ReactElement, type ReactNode, type Ref, type RefObject } from 'react';
+import type { AccessibilityRole, AccessibilityState } from 'react-native';
+import type { SharedValue } from 'react-native-reanimated';
+import { type ICarouselInstance, type TCarouselProps } from 'react-native-reanimated-carousel';
+export type CarouselRef = ICarouselInstance;
+/**
+ * Full passthrough of `react-native-reanimated-carousel`'s own props (per `01-api-design.md`,
+ * Resolved Question #1) — re-exported under a Forge-owned name so consumers never import the
+ * adopted library directly. A type alias (not `interface extends`) because `TCarouselProps<T>`
+ * is itself a union-containing type (vertical/mode discriminants), which interfaces cannot extend.
+ */
+export type CarouselProps<T> = TCarouselProps<T> & {
+    className?: string;
+    /** Rendered inside the carousel's progress-sharing provider — use to compose `Carousel.Pagination`. */
+    children?: ReactNode;
+};
+declare const CarouselRoot: <T>(props: CarouselProps<T> & {
+    ref?: Ref<ICarouselInstance>;
+}) => ReactElement | null;
+export interface CarouselPaginationItemAccessibilityOverrides {
+    accessibilityLabel?: string;
+    accessibilityHint?: string;
+    accessibilityRole?: AccessibilityRole;
+    accessibilityState?: AccessibilityState;
+}
+export interface CarouselPaginationProps<T = unknown> {
+    /** Carousel items — must be the same array (or same length) passed to `Carousel`'s `data`. */
+    data: T[];
+    /** Lay dots out vertically instead of horizontally. @default true (horizontal) */
+    horizontal?: boolean;
+    /** Custom content per dot; defaults to the library's built-in dot rendering. */
+    renderItem?: (item: T, index: number) => ReactNode;
+    /** Dot size in pixels (both width and height). */
+    size?: number;
+    /** Included in the default accessibility label, e.g. `"Slide 1 of 4 - {carouselName}"`. */
+    carouselName?: string;
+    /** Per-dot accessibility overrides. Defaults to `"Slide N of M"` / `"Go to Slide N of M"`. */
+    paginationItemAccessibility?: (index: number, length: number) => CarouselPaginationItemAccessibilityOverrides;
+    className?: string;
+    /** Explicit progress value — only required when rendered outside `<Carousel>` (sibling composition). */
+    progress?: SharedValue<number>;
+    /** Explicit carousel ref for the default press-to-navigate behavior — only required outside `<Carousel>`. */
+    carouselRef?: RefObject<ICarouselInstance | null>;
+    /**
+     * Mirrors `Carousel`'s `loop` prop for shortest-path dot navigation.
+     * Defaults to `true` (same as `Carousel`) when omitted outside context.
+     */
+    loop?: boolean;
+    /** Overrides the default press-to-navigate behavior (`scrollTo({ index })`). */
+    onPress?: (index: number) => void;
+}
+declare const CarouselPagination: <T>(props: CarouselPaginationProps<T>) => ReactElement | null;
+type CarouselCompoundComponent = typeof CarouselRoot & {
+    Pagination: typeof CarouselPagination;
+};
+export declare const Carousel: CarouselCompoundComponent;
+export interface UseCarouselOptions {
+    /** Seed `progress` to match `Carousel`'s `defaultIndex` in sibling composition. @default 0 */
+    defaultIndex?: number;
+}
+export declare function useCarousel(options?: UseCarouselOptions): {
+    ref: RefObject<ICarouselInstance | null>;
+    /** Bind to `Carousel`'s `onProgressChange` and sibling `Carousel.Pagination`'s `progress`. */
+    progress: SharedValue<number>;
+    next: (opts?: Parameters<ICarouselInstance["next"]>[0]) => void | undefined;
+    prev: (opts?: Parameters<ICarouselInstance["prev"]>[0]) => void | undefined;
+    scrollTo: (opts?: Parameters<ICarouselInstance["scrollTo"]>[0]) => void | undefined;
+};
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/Carousel/index.tsx"],"names":[],"mappings":"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"}

package/lib/typescript/components/Carousel/paginationNavigation.d.ts

@@ -0,0 +1,12 @@
+import type { ICarouselInstance } from 'react-native-reanimated-carousel';
+type CarouselPaginationScrollAction = NonNullable<Parameters<ICarouselInstance['scrollTo']>[0]>;
+/**
+ * Resolves the shortest `scrollTo` action for pagination dot presses.
+ *
+ * In loop mode the library's absolute `scrollTo({ index })` can animate through every
+ * slide when the current index is past the halfway point of the loop buffer (e.g. index 2 → 3
+ * with four items). Relative `count` navigation avoids that wrap-around path.
+ */
+export declare function resolveCarouselPaginationScrollAction(currentIndex: number, targetIndex: number, dataLength: number, loop: boolean): CarouselPaginationScrollAction | null;
+export {};
+//# sourceMappingURL=paginationNavigation.d.ts.map

package/lib/typescript/components/Carousel/paginationNavigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paginationNavigation.d.ts","sourceRoot":"","sources":["../../../../src/components/Carousel/paginationNavigation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAE1E,KAAK,8BAA8B,GAAG,WAAW,CAAC,UAAU,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAEhG;;;;;;GAMG;AACH,wBAAgB,qCAAqC,CACnD,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,OAAO,GACZ,8BAA8B,GAAG,IAAI,CAevC"}

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

@@ -0,0 +1,8 @@
+import { type VariantProps } from 'class-variance-authority';
+/** Small default gap between dots — the library ships no default spacing between pagination items. */
+export declare const carouselPaginationContainerClassName = "gap-2 py-1";
+export declare const carouselPaginationDotVariants: (props?: ({
+    active?: boolean | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export type CarouselPaginationDotVariants = VariantProps<typeof carouselPaginationDotVariants>;
+//# sourceMappingURL=styles.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../../src/components/Carousel/styles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAElE,sGAAsG;AACtG,eAAO,MAAM,oCAAoC,eAAe,CAAC;AAEjE,eAAO,MAAM,6BAA6B;;8EAUxC,CAAC;AAEH,MAAM,MAAM,6BAA6B,GAAG,YAAY,CAAC,OAAO,6BAA6B,CAAC,CAAC"}

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

@@ -4,6 +4,7 @@ import { type ILinkProps } from '@cdx-ui/primitives';
 import { type IconProps } from '../Icon';
 export { LinkProvider, type LinkConfig, type LinkAction } from '@cdx-ui/primitives';
 export interface LinkProps extends ILinkProps {
+    asChild?: boolean;
     className?: string;
     children?: ReactNode;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/Link/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACnD,OAAO,EAAY,IAAI,EAAE,IAAI,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAML,KAAK,UAAU,EAChB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAQ,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AAQ/C,OAAO,EAAE,YAAY,EAAE,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAMpF,MAAM,WAAW,SAAU,SAAQ,UAAU;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,QAAA,MAAM,QAAQ,4FAcZ,CAAC;AAQH,MAAM,WAAW,cAAe,SAAQ,SAAS;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,QAAA,MAAM,SAAS,iGAwBd,CAAC;AAQF,MAAM,WAAW,aAAc,SAAQ,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC;CAAG;AAErE,QAAA,MAAM,QAAQ;yCAAwC,aAAa;;CAalE,CAAC;AAQF,KAAK,qBAAqB,GAAG,OAAO,QAAQ,GAAG;IAC7C,KAAK,EAAE,OAAO,SAAS,CAAC;IACxB,IAAI,EAAE,OAAO,QAAQ,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,IAAI,EAGX,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/Link/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACnD,OAAO,EAAY,IAAI,EAAE,IAAI,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAML,KAAK,UAAU,EAChB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAQ,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AAQ/C,OAAO,EAAE,YAAY,EAAE,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAMpF,MAAM,WAAW,SAAU,SAAQ,UAAU;IAC3C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,QAAA,MAAM,QAAQ,4FAcZ,CAAC;AAQH,MAAM,WAAW,cAAe,SAAQ,SAAS;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,QAAA,MAAM,SAAS,iGAwBd,CAAC;AAQF,MAAM,WAAW,aAAc,SAAQ,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC;CAAG;AAErE,QAAA,MAAM,QAAQ;yCAAwC,aAAa;;CAalE,CAAC;AAQF,KAAK,qBAAqB,GAAG,OAAO,QAAQ,GAAG;IAC7C,KAAK,EAAE,OAAO,SAAS,CAAC;IACxB,IAAI,EAAE,OAAO,QAAQ,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,IAAI,EAGX,qBAAqB,CAAC"}

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

@@ -6,6 +6,7 @@ export * from './BottomSheet';
 export * from './Box';
 export * from './Button';
 export * from './Card';
+export * from './Carousel';
 export * from './Checkbox';
 export * from './Chip';
 export * from './CurrencyInput';

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,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,uBAAuB,CAAC;AACtC,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACzC,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,uBAAuB,CAAC;AACtC,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACzC,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cdx-ui/components",
-  "version": "0.0.1-beta.110",
+  "version": "0.0.1-beta.112",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",
   "react-native": "src/index.ts",
@@ -45,7 +45,7 @@
     "@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-reanimated": ">=4.0.0",
     "react-native-safe-area-context": ">=4.0.0",
     "react-native-web": ">=0.19.0"
   },
@@ -66,10 +66,11 @@
   "dependencies": {
     "@gorhom/bottom-sheet": "^5.2.6",
     "class-variance-authority": "^0.7.1",
+    "react-native-reanimated-carousel": "5.0.0-beta.5",
     "uniwind": "1.10.0",
-    "@cdx-ui/primitives": "0.0.1-beta.110",
-    "@cdx-ui/utils": "0.0.1-beta.110",
-    "@cdx-ui/icons": "0.0.1-beta.110"
+    "@cdx-ui/utils": "0.0.1-beta.112",
+    "@cdx-ui/icons": "0.0.1-beta.112",
+    "@cdx-ui/primitives": "0.0.1-beta.112"
   },
   "devDependencies": {
     "@react-navigation/bottom-tabs": "*",

package/src/components/Box/Box.tsx

@@ -1,19 +1,15 @@
 import { type ForwardedRef, forwardRef } from 'react';
 import { View, type ViewProps } from 'react-native';
-import { WrapStringChild } from '../../utils/WrapStringChild';
-import type { TextProps } from '../Text';
 
 export interface BoxProps extends ViewProps {
   className?: string;
-  textProps?: TextProps;
 }
 
-/** @deprecated Use View instead */
 export const Box = forwardRef<View, BoxProps>(
-  ({ style, className, children, textProps, ...restProps }, ref: ForwardedRef<View>) => {
+  ({ children, ...restProps }, ref: ForwardedRef<View>) => {
     return (
-      <View ref={ref} style={style} className={className} {...restProps}>
-        <WrapStringChild textProps={textProps}>{children}</WrapStringChild>
+      <View ref={ref} {...restProps}>
+        {children}
       </View>
     );
   },

package/src/components/Carousel/index.tsx

@@ -0,0 +1,263 @@
+import {
+  forwardRef,
+  useCallback,
+  useRef,
+  type ReactElement,
+  type ReactNode,
+  type Ref,
+  type RefObject,
+} from 'react';
+import type { AccessibilityRole, AccessibilityState, ViewStyle } from 'react-native';
+import { useSharedValue } from 'react-native-reanimated';
+import type { SharedValue } from 'react-native-reanimated';
+import RNCarousel, {
+  Pagination as RNCarouselPagination,
+  type ICarouselInstance,
+  type TCarouselProps,
+} from 'react-native-reanimated-carousel';
+import { useResolveClassNames } from 'uniwind';
+import { cn, createContext, mergeRefs } from '@cdx-ui/utils';
+import { resolveCarouselPaginationScrollAction } from './paginationNavigation';
+import { carouselPaginationContainerClassName, carouselPaginationDotVariants } from './styles';
+
+export type CarouselRef = ICarouselInstance;
+
+/**
+ * Full passthrough of `react-native-reanimated-carousel`'s own props (per `01-api-design.md`,
+ * Resolved Question #1) — re-exported under a Forge-owned name so consumers never import the
+ * adopted library directly. A type alias (not `interface extends`) because `TCarouselProps<T>`
+ * is itself a union-containing type (vertical/mode discriminants), which interfaces cannot extend.
+ */
+export type CarouselProps<T> = TCarouselProps<T> & {
+  className?: string;
+  /** Rendered inside the carousel's progress-sharing provider — use to compose `Carousel.Pagination`. */
+  children?: ReactNode;
+};
+
+/** Mirrors the adopted library's private `DotStyle` shape (not exported) without importing it. */
+type CarouselDotStyle = Omit<ViewStyle, 'width' | 'height' | 'backgroundColor' | 'borderRadius'> & {
+  width?: number;
+  height?: number;
+  backgroundColor?: string;
+  borderRadius?: number;
+};
+
+interface CarouselContextValue {
+  progress: SharedValue<number>;
+  carouselRef: RefObject<ICarouselInstance | null>;
+  loop: boolean;
+}
+
+const [CarouselProgressProvider, useCarouselProgressContext] = createContext<CarouselContextValue>(
+  'CarouselProgress',
+  { strict: false },
+);
+
+function isSharedValueProgress(value: unknown): value is SharedValue<number> {
+  return typeof value === 'object' && value !== null && 'value' in value;
+}
+
+function CarouselInner<T>(
+  {
+    className,
+    style,
+    onProgressChange,
+    children,
+    loop = true,
+    defaultIndex = 0,
+    ...rest
+  }: CarouselProps<T>,
+  ref: Ref<ICarouselInstance>,
+) {
+  const internalRef = useRef<ICarouselInstance>(null);
+  const internalProgress = useSharedValue(defaultIndex);
+  const resolvedClassNameStyle = useResolveClassNames(cn(className));
+
+  const handleProgressChange = useCallback(
+    (offsetProgress: number, absoluteProgress: number) => {
+      internalProgress.value = absoluteProgress;
+      if (typeof onProgressChange === 'function') {
+        onProgressChange(offsetProgress, absoluteProgress);
+      }
+    },
+    [onProgressChange, internalProgress],
+  );
+
+  const consumerProgress = isSharedValueProgress(onProgressChange) ? onProgressChange : undefined;
+  const contextValue: CarouselContextValue = {
+    progress: consumerProgress ?? internalProgress,
+    carouselRef: internalRef,
+    loop,
+  };
+
+  return (
+    <CarouselProgressProvider value={contextValue}>
+      <RNCarousel
+        ref={mergeRefs(ref, internalRef)}
+        style={[resolvedClassNameStyle, style]}
+        onProgressChange={consumerProgress ?? handleProgressChange}
+        loop={loop}
+        defaultIndex={defaultIndex}
+        {...rest}
+      />
+      {children}
+    </CarouselProgressProvider>
+  );
+}
+
+const CarouselRoot = forwardRef(CarouselInner) as <T>(
+  props: CarouselProps<T> & { ref?: Ref<ICarouselInstance> },
+) => ReactElement | null;
+
+// =============================================================================
+// PAGINATION
+// =============================================================================
+
+export interface CarouselPaginationItemAccessibilityOverrides {
+  accessibilityLabel?: string;
+  accessibilityHint?: string;
+  accessibilityRole?: AccessibilityRole;
+  accessibilityState?: AccessibilityState;
+}
+
+export interface CarouselPaginationProps<T = unknown> {
+  /** Carousel items — must be the same array (or same length) passed to `Carousel`'s `data`. */
+  data: T[];
+  /** Lay dots out vertically instead of horizontally. @default true (horizontal) */
+  horizontal?: boolean;
+  /** Custom content per dot; defaults to the library's built-in dot rendering. */
+  renderItem?: (item: T, index: number) => ReactNode;
+  /** Dot size in pixels (both width and height). */
+  size?: number;
+  /** Included in the default accessibility label, e.g. `"Slide 1 of 4 - {carouselName}"`. */
+  carouselName?: string;
+  /** Per-dot accessibility overrides. Defaults to `"Slide N of M"` / `"Go to Slide N of M"`. */
+  paginationItemAccessibility?: (
+    index: number,
+    length: number,
+  ) => CarouselPaginationItemAccessibilityOverrides;
+  className?: string;
+  /** Explicit progress value — only required when rendered outside `<Carousel>` (sibling composition). */
+  progress?: SharedValue<number>;
+  /** Explicit carousel ref for the default press-to-navigate behavior — only required outside `<Carousel>`. */
+  carouselRef?: RefObject<ICarouselInstance | null>;
+  /**
+   * Mirrors `Carousel`'s `loop` prop for shortest-path dot navigation.
+   * Defaults to `true` (same as `Carousel`) when omitted outside context.
+   */
+  loop?: boolean;
+  /** Overrides the default press-to-navigate behavior (`scrollTo({ index })`). */
+  onPress?: (index: number) => void;
+}
+
+function CarouselPaginationComponent<T extends object>({
+  className,
+  progress: progressProp,
+  carouselRef: carouselRefProp,
+  loop: loopProp,
+  onPress,
+  ...rest
+}: CarouselPaginationProps<T>) {
+  // `strict: false` with no `defaultValue` means this returns `undefined` outside a
+  // `<Carousel>` provider at runtime; cast to communicate that to TypeScript, since
+  // `createContext`'s helper type always reports `T` (see `@cdx-ui/utils`).
+  const context = useCarouselProgressContext() as CarouselContextValue | undefined;
+  const progress = progressProp ?? context?.progress;
+  const carouselRef = carouselRefProp ?? context?.carouselRef;
+  const loop = loopProp ?? context?.loop ?? true;
+
+  if (!progress) {
+    throw new Error(
+      'Carousel.Pagination must be rendered inside <Carousel> or receive an explicit `progress` prop.',
+    );
+  }
+
+  if (!onPress && !carouselRef) {
+    throw new Error(
+      'Carousel.Pagination must be rendered inside <Carousel> or receive an explicit `carouselRef` prop (or a custom `onPress`).',
+    );
+  }
+
+  const handlePress = useCallback(
+    (index: number) => {
+      if (onPress) {
+        onPress(index);
+        return;
+      }
+
+      const carousel = carouselRef?.current;
+      if (!carousel) return;
+
+      const scrollAction = resolveCarouselPaginationScrollAction(
+        carousel.getCurrentIndex(),
+        index,
+        rest.data.length,
+        loop,
+      );
+
+      if (scrollAction) {
+        carousel.scrollTo(scrollAction);
+      }
+    },
+    [onPress, carouselRef, loop, rest.data.length],
+  );
+
+  const containerStyle = useResolveClassNames(cn(carouselPaginationContainerClassName, className));
+  const dotStyle = useResolveClassNames(carouselPaginationDotVariants({ active: false }));
+  const activeDotStyle = useResolveClassNames(carouselPaginationDotVariants({ active: true }));
+
+  return (
+    <RNCarouselPagination.Custom
+      {...rest}
+      progress={progress}
+      onPress={handlePress}
+      containerStyle={containerStyle}
+      dotStyle={{
+        width: 6,
+        height: 6,
+        ...(dotStyle as CarouselDotStyle),
+      }}
+      activeDotStyle={{
+        width: 18,
+        height: 6,
+        ...(activeDotStyle as CarouselDotStyle),
+      }}
+    />
+  );
+}
+
+CarouselPaginationComponent.displayName = 'Carousel.Pagination';
+
+const CarouselPagination = CarouselPaginationComponent as <T>(
+  props: CarouselPaginationProps<T>,
+) => ReactElement | null;
+
+type CarouselCompoundComponent = typeof CarouselRoot & {
+  Pagination: typeof CarouselPagination;
+};
+
+export const Carousel = Object.assign(CarouselRoot, {
+  Pagination: CarouselPagination,
+}) as CarouselCompoundComponent;
+
+// =============================================================================
+// HOOK
+// =============================================================================
+
+export interface UseCarouselOptions {
+  /** Seed `progress` to match `Carousel`'s `defaultIndex` in sibling composition. @default 0 */
+  defaultIndex?: number;
+}
+
+export function useCarousel(options?: UseCarouselOptions) {
+  const ref = useRef<ICarouselInstance>(null);
+  const progress = useSharedValue(options?.defaultIndex ?? 0);
+  return {
+    ref,
+    /** Bind to `Carousel`'s `onProgressChange` and sibling `Carousel.Pagination`'s `progress`. */
+    progress,
+    next: (opts?: Parameters<ICarouselInstance['next']>[0]) => ref.current?.next(opts),
+    prev: (opts?: Parameters<ICarouselInstance['prev']>[0]) => ref.current?.prev(opts),
+    scrollTo: (opts?: Parameters<ICarouselInstance['scrollTo']>[0]) => ref.current?.scrollTo(opts),
+  };
+}

package/src/components/Carousel/paginationNavigation.ts

@@ -0,0 +1,32 @@
+import type { ICarouselInstance } from 'react-native-reanimated-carousel';
+
+type CarouselPaginationScrollAction = NonNullable<Parameters<ICarouselInstance['scrollTo']>[0]>;
+
+/**
+ * Resolves the shortest `scrollTo` action for pagination dot presses.
+ *
+ * In loop mode the library's absolute `scrollTo({ index })` can animate through every
+ * slide when the current index is past the halfway point of the loop buffer (e.g. index 2 → 3
+ * with four items). Relative `count` navigation avoids that wrap-around path.
+ */
+export function resolveCarouselPaginationScrollAction(
+  currentIndex: number,
+  targetIndex: number,
+  dataLength: number,
+  loop: boolean,
+): CarouselPaginationScrollAction | null {
+  if (currentIndex === targetIndex) return null;
+
+  if (!loop) {
+    return { index: targetIndex, animated: true };
+  }
+
+  const forwardDelta = (targetIndex - currentIndex + dataLength) % dataLength;
+  const backwardDelta = (currentIndex - targetIndex + dataLength) % dataLength;
+
+  if (forwardDelta <= backwardDelta) {
+    return { count: forwardDelta, animated: true };
+  }
+
+  return { count: -backwardDelta, animated: true };
+}

package/src/components/Carousel/styles.ts

@@ -0,0 +1,18 @@
+import { cva, type VariantProps } from 'class-variance-authority';
+
+/** Small default gap between dots — the library ships no default spacing between pagination items. */
+export const carouselPaginationContainerClassName = 'gap-2 py-1';
+
+export const carouselPaginationDotVariants = cva('rounded-full', {
+  variants: {
+    active: {
+      true: 'bg-surface-neutral-strong',
+      false: 'bg-surface-neutral-subtle',
+    },
+  },
+  defaultVariants: {
+    active: false,
+  },
+});
+
+export type CarouselPaginationDotVariants = VariantProps<typeof carouselPaginationDotVariants>;

package/src/components/Link/index.tsx

@@ -24,6 +24,7 @@ export { LinkProvider, type LinkConfig, type LinkAction } from '@cdx-ui/primitiv
 // =============================================================================
 
 export interface LinkProps extends ILinkProps {
+  asChild?: boolean;
   className?: string;
   children?: ReactNode;
 }

package/src/components/index.ts

@@ -6,6 +6,7 @@ export * from './BottomSheet';
 export * from './Box';
 export * from './Button';
 export * from './Card';
+export * from './Carousel';
 export * from './Checkbox';
 export * from './Chip';
 export * from './CurrencyInput';

package/lib/commonjs/utils/WrapStringChild.js

@@ -1,22 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.WrapStringChild = WrapStringChild;
-var _react = require("react");
-var _Text = require("../components/Text");
-var _jsxRuntime = require("react/jsx-runtime");
-/** @deprecated Users should wrap their own children in a Text component themselves */
-function WrapStringChild({
-  children,
-  textProps
-}) {
-  return _react.Children.map(children, child => {
-    return typeof child === 'string' || typeof child === 'number' || /*#__PURE__*/(0, _react.isValidElement)(child) && child.type === _react.Fragment && child.props && typeof child.props === 'object' && 'children' in child.props && (typeof child.props.children === 'string' || typeof child.props.children === 'number') ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_Text.Text, {
-      ...textProps,
-      children: child
-    }) : child;
-  });
-}
-//# sourceMappingURL=WrapStringChild.js.map

package/lib/commonjs/utils/WrapStringChild.js.map

@@ -1 +0,0 @@
-{"version":3,"names":["_react","require","_Text","_jsxRuntime","WrapStringChild","children","textProps","Children","map","child","isValidElement","type","Fragment","props","jsx","Text"],"sourceRoot":"../../../src","sources":["utils/WrapStringChild.tsx"],"mappings":";;;;;;AAAA,IAAAA,MAAA,GAAAC,OAAA;AACA,IAAAC,KAAA,GAAAD,OAAA;AAA0D,IAAAE,WAAA,GAAAF,OAAA;AAO1D;AACO,SAASG,eAAeA,CAAC;EAAEC,QAAQ;EAAEC;AAAgC,CAAC,EAAa;EACxF,OAAOC,eAAQ,CAACC,GAAG,CAACH,QAAQ,EAAGI,KAAK,IAAK;IACvC,OAAO,OAAOA,KAAK,KAAK,QAAQ,IAC9B,OAAOA,KAAK,KAAK,QAAQ,IACxB,iBAAAC,qBAAc,EAACD,KAAK,CAAC,IACpBA,KAAK,CAACE,IAAI,KAAKC,eAAQ,IACvBH,KAAK,CAACI,KAAK,IACX,OAAOJ,KAAK,CAACI,KAAK,KAAK,QAAQ,IAC/B,UAAU,IAAIJ,KAAK,CAACI,KAAK,KACxB,OAAOJ,KAAK,CAACI,KAAK,CAACR,QAAQ,KAAK,QAAQ,IAAI,OAAOI,KAAK,CAACI,KAAK,CAACR,QAAQ,KAAK,QAAQ,CAAE,gBACzF,IAAAF,WAAA,CAAAW,GAAA,EAACZ,KAAA,CAAAa,IAAI;MAAA,GAAKT,SAAS;MAAAD,QAAA,EAAGI;IAAK,CAAO,CAAC,GAEnCA,KACD;EACH,CAAC,CAAC;AACJ","ignoreList":[]}

package/lib/module/utils/WrapStringChild.js

@@ -1,18 +0,0 @@
-"use strict";
-
-import { Children, Fragment, isValidElement } from 'react';
-import { Text } from '../components/Text';
-import { jsx as _jsx } from "react/jsx-runtime";
-/** @deprecated Users should wrap their own children in a Text component themselves */
-export function WrapStringChild({
-  children,
-  textProps
-}) {
-  return Children.map(children, child => {
-    return typeof child === 'string' || typeof child === 'number' || /*#__PURE__*/isValidElement(child) && child.type === Fragment && child.props && typeof child.props === 'object' && 'children' in child.props && (typeof child.props.children === 'string' || typeof child.props.children === 'number') ? /*#__PURE__*/_jsx(Text, {
-      ...textProps,
-      children: child
-    }) : child;
-  });
-}
-//# sourceMappingURL=WrapStringChild.js.map

package/lib/module/utils/WrapStringChild.js.map

@@ -1 +0,0 @@
-{"version":3,"names":["Children","Fragment","isValidElement","Text","jsx","_jsx","WrapStringChild","children","textProps","map","child","type","props"],"sourceRoot":"../../../src","sources":["utils/WrapStringChild.tsx"],"mappings":";;AAAA,SAASA,QAAQ,EAAEC,QAAQ,EAAEC,cAAc,QAAwB,OAAO;AAC1E,SAASC,IAAI,QAAwB,oBAAoB;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAO1D;AACA,OAAO,SAASC,eAAeA,CAAC;EAAEC,QAAQ;EAAEC;AAAgC,CAAC,EAAa;EACxF,OAAOR,QAAQ,CAACS,GAAG,CAACF,QAAQ,EAAGG,KAAK,IAAK;IACvC,OAAO,OAAOA,KAAK,KAAK,QAAQ,IAC9B,OAAOA,KAAK,KAAK,QAAQ,IACxB,aAAAR,cAAc,CAACQ,KAAK,CAAC,IACpBA,KAAK,CAACC,IAAI,KAAKV,QAAQ,IACvBS,KAAK,CAACE,KAAK,IACX,OAAOF,KAAK,CAACE,KAAK,KAAK,QAAQ,IAC/B,UAAU,IAAIF,KAAK,CAACE,KAAK,KACxB,OAAOF,KAAK,CAACE,KAAK,CAACL,QAAQ,KAAK,QAAQ,IAAI,OAAOG,KAAK,CAACE,KAAK,CAACL,QAAQ,KAAK,QAAQ,CAAE,gBACzFF,IAAA,CAACF,IAAI;MAAA,GAAKK,SAAS;MAAAD,QAAA,EAAGG;IAAK,CAAO,CAAC,GAEnCA,KACD;EACH,CAAC,CAAC;AACJ","ignoreList":[]}

package/lib/typescript/utils/WrapStringChild.d.ts

@@ -1,10 +0,0 @@
-import { type ReactNode } from 'react';
-import { type TextProps } from '../components/Text';
-interface WrapStringChildProps {
-    children: ReactNode;
-    textProps?: TextProps;
-}
-/** @deprecated Users should wrap their own children in a Text component themselves */
-export declare function WrapStringChild({ children, textProps }: WrapStringChildProps): ReactNode;
-export {};
-//# sourceMappingURL=WrapStringChild.d.ts.map