@factorialco/f0-react-native 0.26.0 → 0.28.0

package/lib/typescript/components/primitives/F0Text/AnimatedF0Text/AnimatedF0Text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnimatedF0Text.d.ts","sourceRoot":"","sources":["../../../../../../src/components/primitives/F0Text/AnimatedF0Text/AnimatedF0Text.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAMzB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AA+DjE,eAAO,MAAM,cAAc,qNAAsC,CAAA;AAEjE,YAAY,EAAE,mBAAmB,EAAE,CAAA"}

package/lib/typescript/components/primitives/F0Text/AnimatedF0Text/AnimatedF0Text.types.d.ts

@@ -0,0 +1,45 @@
+import type { TextProps as RNTextProps } from "react-native";
+import type { AnimatedProps } from "react-native-reanimated";
+import type { TextAlign, TextColor, TextDecoration, TextTransform, TypographyVariant } from "../F0Text/F0Text.types";
+/**
+ * Props for the AnimatedF0Text component.
+ *
+ * Combines F0Text semantic typography props with Reanimated animation
+ * capabilities (`entering`, `exiting`, `layout`, animated `style`).
+ */
+export interface AnimatedF0TextProps extends Omit<AnimatedProps<RNTextProps>, "className"> {
+    /**
+     * Semantic typography variant
+     * @default "body-sm-default"
+     */
+    variant?: TypographyVariant;
+    /**
+     * Text color from F0 semantic color system
+     * @default "default"
+     */
+    color?: TextColor;
+    /**
+     * Text alignment
+     * @default "left"
+     */
+    align?: TextAlign;
+    /**
+     * Text decoration
+     * @default "none"
+     */
+    decoration?: TextDecoration;
+    /**
+     * Text transform
+     * @default "none"
+     */
+    transform?: TextTransform;
+    /**
+     * Maximum number of lines before truncating with ellipsis
+     */
+    numberOfLines?: number;
+    /**
+     * Children content
+     */
+    children?: React.ReactNode;
+}
+//# sourceMappingURL=AnimatedF0Text.types.d.ts.map

package/lib/typescript/components/primitives/F0Text/AnimatedF0Text/AnimatedF0Text.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnimatedF0Text.types.d.ts","sourceRoot":"","sources":["../../../../../../src/components/primitives/F0Text/AnimatedF0Text/AnimatedF0Text.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,IAAI,WAAW,EAAE,MAAM,cAAc,CAAA;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAE5D,OAAO,KAAK,EACV,SAAS,EACT,SAAS,EACT,cAAc,EACd,aAAa,EACb,iBAAiB,EAClB,MAAM,wBAAwB,CAAA;AAE/B;;;;;GAKG;AACH,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAC/C,aAAa,CAAC,WAAW,CAAC,EAC1B,WAAW,CACZ;IACC;;;OAGG;IACH,OAAO,CAAC,EAAE,iBAAiB,CAAA;IAE3B;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,CAAA;IAEjB;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,CAAA;IAEjB;;;OAGG;IACH,UAAU,CAAC,EAAE,cAAc,CAAA;IAE3B;;;OAGG;IACH,SAAS,CAAC,EAAE,aAAa,CAAA;IAEzB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;CAC3B"}

package/lib/typescript/components/primitives/F0Text/AnimatedF0Text/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * AnimatedF0Text - Animated text primitive component
+ *
+ * @see AnimatedF0Text.md for documentation
+ */
+export { AnimatedF0Text } from "./AnimatedF0Text";
+export type { AnimatedF0TextProps } from "./AnimatedF0Text";
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/components/primitives/F0Text/AnimatedF0Text/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/components/primitives/F0Text/AnimatedF0Text/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA"}

package/lib/typescript/components/primitives/F0Text/F0Text/F0Text.d.ts

@@ -0,0 +1,8 @@
+import React from "react";
+import { Text as RNText } from "react-native";
+import { type F0TextProps } from "./F0Text.types";
+export declare const F0Text: React.MemoExoticComponent<React.ForwardRefExoticComponent<F0TextProps & React.RefAttributes<RNText>>>;
+export type { F0TextProps };
+export { TYPOGRAPHY_VARIANTS, TEXT_COLORS, TEXT_ALIGN, TEXT_DECORATIONS, TEXT_TRANSFORMS, } from "./F0Text.types";
+export type { TypographyVariant, TextColor, TextAlign, TextDecoration, TextTransform, } from "./F0Text.types";
+//# sourceMappingURL=F0Text.d.ts.map

package/lib/typescript/components/primitives/F0Text/F0Text/F0Text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"F0Text.d.ts","sourceRoot":"","sources":["../../../../../../src/components/primitives/F0Text/F0Text/F0Text.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAE,IAAI,IAAI,MAAM,EAAE,MAAM,cAAc,CAAA;AAK7C,OAAO,EAAwB,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAoDvE,eAAO,MAAM,MAAM,uGAA8B,CAAA;AAGjD,YAAY,EAAE,WAAW,EAAE,CAAA;AAC3B,OAAO,EACL,mBAAmB,EACnB,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,eAAe,GAChB,MAAM,gBAAgB,CAAA;AACvB,YAAY,EACV,iBAAiB,EACjB,SAAS,EACT,SAAS,EACT,cAAc,EACd,aAAa,GACd,MAAM,gBAAgB,CAAA"}

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

@@ -0,0 +1,144 @@
+import { type VariantProps } from "tailwind-variants";
+/**
+ * Text component variants using tailwind-variants
+ * Font weights (font-normal, font-medium, font-semibold) map to
+ * Inter font families (Inter-Regular, Inter-Medium, Inter-SemiBold)
+ */
+export declare const textVariants: import("tailwind-variants").TVReturnType<{
+    variant: {
+        "heading-xl": string;
+        "heading-lg": string;
+        "heading-md": string;
+        "heading-sm": string;
+        "body-md-default": string;
+        "body-md-medium": string;
+        "body-md-semibold": string;
+        "body-sm-default": string;
+        "body-sm-medium": string;
+        "body-sm-semibold": string;
+        "body-xs-medium": string;
+    };
+    color: {
+        default: string;
+        secondary: string;
+        tertiary: string;
+        inverse: string;
+        "inverse-secondary": string;
+        disabled: string;
+        accent: string;
+        critical: string;
+        info: string;
+        warning: string;
+        positive: string;
+        selected: string;
+    };
+    align: {
+        left: string;
+        center: string;
+        right: string;
+        justify: string;
+    };
+    decoration: {
+        none: string;
+        underline: string;
+        "line-through": string;
+    };
+    transform: {
+        none: string;
+        uppercase: string;
+        lowercase: string;
+        capitalize: string;
+    };
+}, undefined, "", {
+    variant: {
+        "heading-xl": string;
+        "heading-lg": string;
+        "heading-md": string;
+        "heading-sm": string;
+        "body-md-default": string;
+        "body-md-medium": string;
+        "body-md-semibold": string;
+        "body-sm-default": string;
+        "body-sm-medium": string;
+        "body-sm-semibold": string;
+        "body-xs-medium": string;
+    };
+    color: {
+        default: string;
+        secondary: string;
+        tertiary: string;
+        inverse: string;
+        "inverse-secondary": string;
+        disabled: string;
+        accent: string;
+        critical: string;
+        info: string;
+        warning: string;
+        positive: string;
+        selected: string;
+    };
+    align: {
+        left: string;
+        center: string;
+        right: string;
+        justify: string;
+    };
+    decoration: {
+        none: string;
+        underline: string;
+        "line-through": string;
+    };
+    transform: {
+        none: string;
+        uppercase: string;
+        lowercase: string;
+        capitalize: string;
+    };
+}, undefined, import("tailwind-variants").TVReturnType<{
+    variant: {
+        "heading-xl": string;
+        "heading-lg": string;
+        "heading-md": string;
+        "heading-sm": string;
+        "body-md-default": string;
+        "body-md-medium": string;
+        "body-md-semibold": string;
+        "body-sm-default": string;
+        "body-sm-medium": string;
+        "body-sm-semibold": string;
+        "body-xs-medium": string;
+    };
+    color: {
+        default: string;
+        secondary: string;
+        tertiary: string;
+        inverse: string;
+        "inverse-secondary": string;
+        disabled: string;
+        accent: string;
+        critical: string;
+        info: string;
+        warning: string;
+        positive: string;
+        selected: string;
+    };
+    align: {
+        left: string;
+        center: string;
+        right: string;
+        justify: string;
+    };
+    decoration: {
+        none: string;
+        underline: string;
+        "line-through": string;
+    };
+    transform: {
+        none: string;
+        uppercase: string;
+        lowercase: string;
+        capitalize: string;
+    };
+}, undefined, "", unknown, unknown, undefined>>;
+export type TextVariants = VariantProps<typeof textVariants>;
+//# sourceMappingURL=F0Text.styles.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"F0Text.styles.d.ts","sourceRoot":"","sources":["../../../../../../src/components/primitives/F0Text/F0Text/F0Text.styles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAM,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAEzD;;;;GAIG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+CA6DvB,CAAA;AAEF,MAAM,MAAM,YAAY,GAAG,YAAY,CAAC,OAAO,YAAY,CAAC,CAAA"}

package/lib/typescript/components/primitives/F0Text/F0Text/F0Text.types.d.ts

@@ -0,0 +1,86 @@
+import type { TextProps as RNTextProps } from "react-native";
+/**
+ * Props that must not be passed through to the underlying RN Text
+ * (`style` and `className` are handled by F0 instead).
+ * Used with omitProps for runtime safety.
+ */
+export declare const F0_TEXT_BANNED_PROPS: readonly ["style", "className"];
+/**
+ * Typography variant types based on semantic design tokens
+ */
+export declare const TYPOGRAPHY_VARIANTS: readonly ["heading-xl", "heading-lg", "heading-md", "heading-sm", "body-md-default", "body-md-medium", "body-md-semibold", "body-sm-default", "body-sm-medium", "body-sm-semibold", "body-xs-medium"];
+export type TypographyVariant = (typeof TYPOGRAPHY_VARIANTS)[number];
+/**
+ * Text color variants aligned with F0 semantic color system
+ */
+export declare const TEXT_COLORS: readonly ["default", "secondary", "tertiary", "inverse", "inverse-secondary", "disabled", "accent", "critical", "info", "warning", "positive", "selected"];
+export type TextColor = (typeof TEXT_COLORS)[number];
+/**
+ * Text alignment options
+ */
+export declare const TEXT_ALIGN: readonly ["left", "center", "right", "justify"];
+export type TextAlign = (typeof TEXT_ALIGN)[number];
+/**
+ * Text decoration options
+ */
+export declare const TEXT_DECORATIONS: readonly ["none", "underline", "line-through"];
+export type TextDecoration = (typeof TEXT_DECORATIONS)[number];
+/**
+ * Text transform options
+ */
+export declare const TEXT_TRANSFORMS: readonly ["none", "uppercase", "lowercase", "capitalize"];
+export type TextTransform = (typeof TEXT_TRANSFORMS)[number];
+/**
+ * Internal props for the F0Text component.
+ * @private
+ */
+interface F0TextPropsInternal extends Omit<RNTextProps, "style"> {
+    /**
+     * Semantic typography variant
+     * @default "body-sm-default"
+     */
+    variant?: TypographyVariant;
+    /**
+     * Text color from F0 semantic color system
+     * @default "default"
+     */
+    color?: TextColor;
+    /**
+     * Text alignment
+     * @default "left"
+     */
+    align?: TextAlign;
+    /**
+     * Text decoration
+     * @default "none"
+     */
+    decoration?: TextDecoration;
+    /**
+     * Text transform
+     * @default "none"
+     */
+    transform?: TextTransform;
+    /**
+     * Maximum number of lines before truncating with ellipsis
+     */
+    numberOfLines?: number;
+    /**
+     * Children content
+     */
+    children?: React.ReactNode;
+    /**
+     * Excluded from public API via Omit<F0TextPropsInternal, "className">.
+     * @private
+     */
+    className?: string;
+}
+/**
+ * Public props for the F0Text component
+ *
+ * Note: `className` and `style` props are NOT available.
+ * Use semantic props (variant, color, align, etc.) for typography.
+ * For spacing/layout, wrap F0Text in a View with className.
+ */
+export type F0TextProps = Omit<F0TextPropsInternal, "className">;
+export {};
+//# sourceMappingURL=F0Text.types.d.ts.map

package/lib/typescript/components/primitives/F0Text/F0Text/F0Text.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"F0Text.types.d.ts","sourceRoot":"","sources":["../../../../../../src/components/primitives/F0Text/F0Text/F0Text.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,IAAI,WAAW,EAAE,MAAM,cAAc,CAAA;AAE5D;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,iCAAkC,CAAA;AAEnE;;GAEG;AACH,eAAO,MAAM,mBAAmB,uMAYtB,CAAA;AAEV,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEpE;;GAEG;AACH,eAAO,MAAM,WAAW,4JAad,CAAA;AAEV,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAA;AAEpD;;GAEG;AACH,eAAO,MAAM,UAAU,iDAAkD,CAAA;AAEzE,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAA;AAEnD;;GAEG;AACH,eAAO,MAAM,gBAAgB,gDAAiD,CAAA;AAE9E,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE9D;;GAEG;AACH,eAAO,MAAM,eAAe,2DAKlB,CAAA;AAEV,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAA;AAE5D;;;GAGG;AACH,UAAU,mBAAoB,SAAQ,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9D;;;OAGG;IACH,OAAO,CAAC,EAAE,iBAAiB,CAAA;IAE3B;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,CAAA;IAEjB;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,CAAA;IAEjB;;;OAGG;IACH,UAAU,CAAC,EAAE,cAAc,CAAA;IAE3B;;;OAGG;IACH,SAAS,CAAC,EAAE,aAAa,CAAA;IAEzB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAE1B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,mBAAmB,EAAE,WAAW,CAAC,CAAA"}

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

@@ -0,0 +1,9 @@
+/**
+ * F0Text - Text primitive component
+ *
+ * @see F0Text.md for documentation
+ */
+export { F0Text } from "./F0Text";
+export type { F0TextProps, TypographyVariant, TextColor, TextAlign, TextDecoration, TextTransform, } from "./F0Text";
+export { TYPOGRAPHY_VARIANTS, TEXT_COLORS, TEXT_ALIGN, TEXT_DECORATIONS, TEXT_TRANSFORMS, } from "./F0Text";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/components/primitives/F0Text/F0Text/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACjC,YAAY,EACV,WAAW,EACX,iBAAiB,EACjB,SAAS,EACT,SAAS,EACT,cAAc,EACd,aAAa,GACd,MAAM,UAAU,CAAA;AACjB,OAAO,EACL,mBAAmB,EACnB,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,eAAe,GAChB,MAAM,UAAU,CAAA"}

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

@@ -0,0 +1,12 @@
+/**
+ * F0Text - Text primitive components
+ *
+ * @see F0Text/F0Text.md for documentation
+ * @see AnimatedF0Text/AnimatedF0Text.md for animated variant documentation
+ */
+export { F0Text } from "./F0Text";
+export type { F0TextProps, TypographyVariant, TextColor, TextAlign, TextDecoration, TextTransform, } from "./F0Text";
+export { TYPOGRAPHY_VARIANTS, TEXT_COLORS, TEXT_ALIGN, TEXT_DECORATIONS, TEXT_TRANSFORMS, } from "./F0Text";
+export { AnimatedF0Text } from "./AnimatedF0Text";
+export type { AnimatedF0TextProps } from "./AnimatedF0Text";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/primitives/F0Text/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACjC,YAAY,EACV,WAAW,EACX,iBAAiB,EACjB,SAAS,EACT,SAAS,EACT,cAAc,EACd,aAAa,GACd,MAAM,UAAU,CAAA;AACjB,OAAO,EACL,mBAAmB,EACnB,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,eAAe,GAChB,MAAM,UAAU,CAAA;AAEjB,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA"}

package/lib/typescript/index.d.ts

@@ -1,4 +1,4 @@
 export * from "./components/exports";
 export * from "./icons";
-export { cn } from "./lib/utils";
+export { cn, omitProps } from "./lib/utils";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,cAAc,sBAAsB,CAAA;AAGpC,cAAc,SAAS,CAAA;AAGvB,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,cAAc,sBAAsB,CAAA;AAGpC,cAAc,SAAS,CAAA;AAGvB,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA"}

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

@@ -1,3 +1,12 @@
 import { type CnOptions } from "tailwind-variants";
 export declare function cn(...args: CnOptions): string;
+/**
+ * Omits specified keys from an object at runtime.
+ * Used to filter blocked props (e.g. style, className) before spreading to primitives.
+ *
+ * @example
+ * omitProps(rest, ["style"])
+ * omitProps(rest, ["style", "className"])
+ */
+export declare function omitProps<T extends Record<string, unknown>, K extends string>(obj: T, keys: readonly K[]): Omit<T, K>;
 //# sourceMappingURL=utils.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/lib/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAE3D,wBAAgB,EAAE,CAAC,GAAG,IAAI,EAAE,SAAS,GAAG,MAAM,CAM7C"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/lib/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAE3D,wBAAgB,EAAE,CAAC,GAAG,IAAI,EAAE,SAAS,GAAG,MAAM,CAM7C;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,SAAS,MAAM,EAC3E,GAAG,EAAE,CAAC,EACN,IAAI,EAAE,SAAS,CAAC,EAAE,GACjB,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAMZ"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@factorialco/f0-react-native",
-  "version": "0.26.0",
+  "version": "0.28.0",
   "type": "module",
   "description": "React Native components for F0 Design System",
   "main": "expo-router/entry",

package/src/components/exports.ts

@@ -14,3 +14,6 @@ export * from "./Tags/exports"
 export * from "./experimental/Lists/DataList"
 export * from "./experimental/Lists/DetailsItem"
 export * from "./experimental/Lists/DetailsItemsList"
+
+// Export primitives
+export * from "./primitives/F0Text"

package/src/components/primitives/F0Text/AnimatedF0Text/AnimatedF0Text.md

@@ -0,0 +1,159 @@
+# AnimatedF0Text
+
+Animated text primitive for React Native with semantic typography variants and Reanimated animation support.
+
+## Features
+
+- All F0Text semantic typography variants and colors
+- Reanimated `entering`/`exiting` layout animations
+- Animated `style` prop for custom animations via `useAnimatedStyle`
+- Layout transition animations
+- Shares the same typography system as F0Text
+- Performance optimized with React.memo and useMemo
+
+## Installation
+
+```tsx
+import { AnimatedF0Text } from "@factorialco/f0-react-native"
+```
+
+Requires `react-native-reanimated` as a peer dependency.
+
+## When to use AnimatedF0Text vs F0Text
+
+| Use case                                          | Component        |
+| ------------------------------------------------- | ---------------- |
+| Static text, no animation                         | `F0Text`         |
+| Text that fades in/out                            | `AnimatedF0Text` |
+| Text with entering/exiting transitions            | `AnimatedF0Text` |
+| Text driven by animated values (scroll, gestures) | `AnimatedF0Text` |
+
+## Usage
+
+### Entering/Exiting Animations
+
+<!-- prettier-ignore -->
+```tsx
+import { AnimatedF0Text } from "@factorialco/f0-react-native"
+import { FadeIn, FadeOut, SlideInLeft } from "react-native-reanimated"
+
+<>
+  <AnimatedF0Text
+    variant="heading-xl"
+    entering={FadeIn.duration(300)}
+    exiting={FadeOut.duration(200)}
+  >
+    Welcome back
+  </AnimatedF0Text>
+
+  <AnimatedF0Text variant="heading-md" entering={SlideInLeft.springify()}>
+    Slide in heading
+  </AnimatedF0Text>
+</>
+```
+
+### Custom Animated Styles
+
+<!-- prettier-ignore -->
+```tsx
+import { AnimatedF0Text } from "@factorialco/f0-react-native"
+import { useAnimatedStyle, useSharedValue, withTiming } from "react-native-reanimated"
+
+const opacity = useSharedValue(0)
+
+const animatedStyle = useAnimatedStyle(() => ({
+  opacity: opacity.value,
+  transform: [{ translateY: withTiming(opacity.value * -10) }],
+}))
+
+<>
+  <AnimatedF0Text variant="body-md-default" style={animatedStyle}>
+    Custom animated text
+  </AnimatedF0Text>
+</>
+```
+
+### Layout Transitions
+
+<!-- prettier-ignore -->
+```tsx
+import { AnimatedF0Text } from "@factorialco/f0-react-native"
+import { LinearTransition } from "react-native-reanimated"
+
+<>
+  <AnimatedF0Text
+    variant="body-sm-default"
+    layout={LinearTransition.springify()}
+  >
+    {dynamicContent}
+  </AnimatedF0Text>
+</>
+```
+
+## API Reference
+
+### Props
+
+AnimatedF0Text accepts all F0Text semantic props plus Reanimated animation props.
+
+#### Typography Props (shared with F0Text)
+
+| Prop            | Type                | Default             | Description                              |
+| --------------- | ------------------- | ------------------- | ---------------------------------------- |
+| `variant`       | `TypographyVariant` | `'body-sm-default'` | Typography variant                       |
+| `color`         | `TextColor`         | `'default'`         | Text color from F0 semantic color system |
+| `align`         | `TextAlign`         | `'left'`            | Text alignment                           |
+| `decoration`    | `TextDecoration`    | `'none'`            | Text decoration                          |
+| `transform`     | `TextTransform`     | `'none'`            | Text transform                           |
+| `numberOfLines` | `number`            | `undefined`         | Max lines before truncation              |
+
+#### Animation Props
+
+| Prop       | Type                                              | Description                                                    |
+| ---------- | ------------------------------------------------- | -------------------------------------------------------------- |
+| `entering` | `EntryOrExitLayoutType`                           | Reanimated entering animation (e.g. `FadeIn`, `SlideInLeft`)   |
+| `exiting`  | `EntryOrExitLayoutType`                           | Reanimated exiting animation (e.g. `FadeOut`, `SlideOutRight`) |
+| `layout`   | `BaseAnimationBuilder \| LayoutAnimationFunction` | Layout transition animation                                    |
+| `style`    | `AnimatedStyle`                                   | Animated style from `useAnimatedStyle`                         |
+
+All React Native `TextProps` are also supported (onPress, testID, etc.).
+
+### Typography Variants
+
+See [F0Text documentation](../F0Text/F0Text.md) for the full list of typography variants and colors.
+
+## Architecture
+
+```
+F0Text/                        # Parent folder for text primitives
+├── F0Text/                    # Static text component
+│   ├── F0Text.tsx
+│   ├── F0Text.types.ts        # Shared types (TypographyVariant, TextColor, etc.)
+│   ├── F0Text.styles.ts       # Shared styles (textVariants)
+│   ├── F0Text.md
+│   ├── index.ts
+│   └── __tests__/
+├── AnimatedF0Text/            # Animated text component
+│   ├── AnimatedF0Text.tsx     # Animated text (Reanimated Animated.Text)
+│   ├── AnimatedF0Text.types.ts
+│   ├── AnimatedF0Text.md
+│   ├── index.ts
+│   └── __tests__/
+└── index.ts                   # Barrel re-exporting both
+```
+
+- **Types** are imported from `../F0Text/F0Text.types.ts` (`TypographyVariant`, `TextColor`, etc.)
+- **Styles** are imported from `../F0Text/F0Text.styles.ts` (`textVariants`)
+
+This ensures both components always produce identical typography output.
+
+## Accessibility
+
+- Fully supports React Native `Text` accessibility props
+- Animations respect the device's reduced motion setting when using Reanimated's built-in animations
+
+## Performance
+
+- **React.memo**: Prevents re-renders when props unchanged
+- **useMemo**: Memoizes className computation
+- Only imported when animation is needed (tree-shakeable)

package/src/components/primitives/F0Text/AnimatedF0Text/AnimatedF0Text.tsx

@@ -0,0 +1,72 @@
+import React from "react"
+import { Text as RNText } from "react-native"
+import Animated from "react-native-reanimated"
+
+import { textVariants } from "../F0Text/F0Text.styles"
+
+import type { AnimatedF0TextProps } from "./AnimatedF0Text.types"
+
+const AnimatedText = Animated.createAnimatedComponent(RNText)
+
+/**
+ * AnimatedF0Text - Animated text primitive with semantic typography variants
+ *
+ * Uses Reanimated's Animated.Text under the hood while sharing the same
+ * typography system as F0Text. Supports `entering`, `exiting`, `layout`
+ * animations and animated `style` props.
+ *
+ * @example
+ * <AnimatedF0Text variant="heading-xl" entering={FadeIn.duration(300)}>
+ *   Welcome back
+ * </AnimatedF0Text>
+ */
+const AnimatedF0TextComponent = React.forwardRef<
+  React.ComponentRef<typeof AnimatedText>,
+  AnimatedF0TextProps
+>(
+  (
+    {
+      variant = "body-sm-default",
+      color = "default",
+      align = "left",
+      decoration = "none",
+      transform = "none",
+      children,
+      numberOfLines,
+      style,
+      ...rest
+    },
+    ref
+  ) => {
+    const textClassName = React.useMemo(
+      () =>
+        textVariants({
+          variant,
+          color,
+          align,
+          decoration,
+          transform,
+        }),
+      [variant, color, align, decoration, transform]
+    )
+
+    return (
+      <AnimatedText
+        ref={ref}
+        {...rest}
+        className={textClassName}
+        style={style}
+        numberOfLines={numberOfLines}
+        ellipsizeMode={numberOfLines ? "tail" : undefined}
+      >
+        {children}
+      </AnimatedText>
+    )
+  }
+)
+
+AnimatedF0TextComponent.displayName = "AnimatedF0Text"
+
+export const AnimatedF0Text = React.memo(AnimatedF0TextComponent)
+
+export type { AnimatedF0TextProps }