@castui/cast-ui 4.9.0 → 4.10.0

package/dist/theme/index.d.ts

@@ -1,4 +1,5 @@
 export { ThemeProvider, useTheme, type ThemeProviderProps, type Theme } from './ThemeContext';
 export { themes } from './themes';
+export { useMotion, type Motion } from './useMotion';
 export { applyCastTheme, type CastThemeFile, type CastThemeProps, } from './applyCastTheme';
 export type { DensityTheme, ComponentTokens, AccordionSizeTokens, AccordionThemeTokens, ButtonSizeTokens, ButtonThemeTokens, DialogSizeTokens, DialogThemeTokens, InputSizeTokens, InputThemeTokens, SelectContentTokens, SelectOptionTokens, SelectGroupTokens, SelectSeparatorTokens, SelectThemeTokens, ListItemTokens, ListSubheaderTokens, ListThemeTokens, CheckboxSizeTokens, CheckboxThemeTokens, AlertSizeTokens, AlertThemeTokens, ToggleSizeTokens, ToggleThemeTokens, CardSizeTokens, CardThemeTokens, BadgeSizeTokens, BadgeThemeTokens, RadioSizeTokens, RadioThemeTokens, ToastSizeTokens, ToastThemeTokens, ChipSizeTokens, ChipThemeTokens, AvatarSizeTokens, AvatarThemeTokens, PopoverSizeTokens, PopoverThemeTokens, TooltipSizeTokens, TooltipThemeTokens, ProgressSizeTokens, ProgressThemeTokens, TabsSizeTokens, TabsThemeTokens, SpinnerSizeTokens, SpinnerThemeTokens, BottomSheetThemeTokens, LinkSizeTokens, LinkThemeTokens, BreadcrumbsSizeTokens, BreadcrumbsThemeTokens, CodeBlockSizeTokens, CodeBlockThemeTokens, DrawerThemeTokens, MenuItemTokens, MenuGroupTokens, MenuThemeTokens, ToggleButtonGroupSizeTokens, ToggleButtonGroupThemeTokens, AppBarSizeTokens, AppBarThemeTokens, SliderSizeTokens, SliderThemeTokens, SpeedDialSizeTokens, SpeedDialThemeTokens, TableSizeTokens, TableThemeTokens, DeepPartial, } from './types';

package/dist/theme/index.js

@@ -1,10 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.applyCastTheme = exports.themes = exports.useTheme = exports.ThemeProvider = void 0;
+exports.applyCastTheme = exports.useMotion = exports.themes = exports.useTheme = exports.ThemeProvider = void 0;
 var ThemeContext_1 = require("./ThemeContext");
 Object.defineProperty(exports, "ThemeProvider", { enumerable: true, get: function () { return ThemeContext_1.ThemeProvider; } });
 Object.defineProperty(exports, "useTheme", { enumerable: true, get: function () { return ThemeContext_1.useTheme; } });
 var themes_1 = require("./themes");
 Object.defineProperty(exports, "themes", { enumerable: true, get: function () { return themes_1.themes; } });
+var useMotion_1 = require("./useMotion");
+Object.defineProperty(exports, "useMotion", { enumerable: true, get: function () { return useMotion_1.useMotion; } });
 var applyCastTheme_1 = require("./applyCastTheme");
 Object.defineProperty(exports, "applyCastTheme", { enumerable: true, get: function () { return applyCastTheme_1.applyCastTheme; } });

package/dist/theme/useMotion.d.ts

@@ -0,0 +1,32 @@
+/**
+ * useMotion — the single access point for animation in Cast UI.
+ *
+ * Returns the theme's motion tokens plus three runtime helpers:
+ *   reduceMotion     true when the OS "reduce motion" setting is on.
+ *   useNativeDriver  the Animated.timing native-driver flag (false on web).
+ *   scale(ms)        a duration in ms, collapsed to 0 when reduceMotion is on.
+ *
+ * Components read a semantic role for the value and wrap durations in scale(),
+ * so the whole library honours reduce-motion from one place:
+ *
+ *   const motion = useMotion();
+ *   Animated.timing(v, {
+ *     toValue: 1,
+ *     duration: motion.scale(motion.transition.standard.duration),
+ *     easing: motion.transition.standard.easing,
+ *     useNativeDriver: motion.useNativeDriver,
+ *   });
+ *
+ * For continuous loops (spinner, skeleton, progress), check reduceMotion and
+ * skip starting the loop.
+ */
+import type { MotionTokens } from '../tokens/motion';
+export type Motion = MotionTokens & {
+    /** True when the OS "reduce motion" accessibility setting is enabled. */
+    reduceMotion: boolean;
+    /** Animated useNativeDriver value. False on web (the web driver can't animate layout). */
+    useNativeDriver: boolean;
+    /** Returns the given duration, or 0 when reduce-motion is on. */
+    scale: (ms: number) => number;
+};
+export declare function useMotion(): Motion;

package/dist/theme/useMotion.js

@@ -0,0 +1,55 @@
+"use strict";
+/**
+ * useMotion — the single access point for animation in Cast UI.
+ *
+ * Returns the theme's motion tokens plus three runtime helpers:
+ *   reduceMotion     true when the OS "reduce motion" setting is on.
+ *   useNativeDriver  the Animated.timing native-driver flag (false on web).
+ *   scale(ms)        a duration in ms, collapsed to 0 when reduceMotion is on.
+ *
+ * Components read a semantic role for the value and wrap durations in scale(),
+ * so the whole library honours reduce-motion from one place:
+ *
+ *   const motion = useMotion();
+ *   Animated.timing(v, {
+ *     toValue: 1,
+ *     duration: motion.scale(motion.transition.standard.duration),
+ *     easing: motion.transition.standard.easing,
+ *     useNativeDriver: motion.useNativeDriver,
+ *   });
+ *
+ * For continuous loops (spinner, skeleton, progress), check reduceMotion and
+ * skip starting the loop.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useMotion = useMotion;
+const react_1 = require("react");
+const react_native_1 = require("react-native");
+const ThemeContext_1 = require("./ThemeContext");
+function useMotion() {
+    const { motion } = (0, ThemeContext_1.useTheme)();
+    const [reduceMotion, setReduceMotion] = (0, react_1.useState)(false);
+    (0, react_1.useEffect)(() => {
+        let active = true;
+        const read = react_native_1.AccessibilityInfo.isReduceMotionEnabled;
+        if (typeof read === 'function') {
+            read()
+                .then((value) => {
+                if (active)
+                    setReduceMotion(!!value);
+            })
+                .catch(() => { });
+        }
+        const sub = react_native_1.AccessibilityInfo.addEventListener?.('reduceMotionChanged', (value) => setReduceMotion(!!value));
+        return () => {
+            active = false;
+            sub?.remove?.();
+        };
+    }, []);
+    return {
+        ...motion,
+        reduceMotion,
+        useNativeDriver: react_native_1.Platform.OS !== 'web',
+        scale: (ms) => (reduceMotion ? 0 : ms),
+    };
+}

package/dist/tokens/index.d.ts

@@ -2,3 +2,4 @@ export { lightColors, darkColors, colorSchemes, intentColors, disabledColors, co
 export { fontFamily, fontWeight, label, title, body, heading, display, caption, type LabelSize, } from './typography';
 export { iconSize, type IconSize } from './icon';
 export { breakpoints, breakpointOrder, resolveBreakpoint, resolveResponsiveValue, type Breakpoint, type BreakpointKey, } from './breakpoints';
+export { duration, cycle, easing, easingBezier, spring, transition, feedback, loop, motionTokens, resolveMotion, type MotionTokens, type MotionTransition, type MotionOverrides, type MotionDurations, type MotionCycles, type EasingName, type EasingBezierPoints, type SpringConfig, } from './motion';

package/dist/tokens/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveResponsiveValue = exports.resolveBreakpoint = exports.breakpointOrder = exports.breakpoints = exports.iconSize = exports.caption = exports.display = exports.heading = exports.body = exports.title = exports.label = exports.fontWeight = exports.fontFamily = exports.tableColors = exports.sliderColors = exports.skeletonColors = exports.avatarColors = exports.radioColors = exports.tabsColors = exports.progressColors = exports.toggleColors = exports.checkboxColors = exports.listColors = exports.errorTokens = exports.tagTokens = exports.menuColors = exports.selectColors = exports.overlayTokens = exports.textTokens = exports.surfaceTokens = exports.controlTokens = exports.disabledColors = exports.intentColors = exports.colorSchemes = exports.darkColors = exports.lightColors = void 0;
+exports.resolveMotion = exports.motionTokens = exports.loop = exports.feedback = exports.transition = exports.spring = exports.easingBezier = exports.easing = exports.cycle = exports.duration = exports.resolveResponsiveValue = exports.resolveBreakpoint = exports.breakpointOrder = exports.breakpoints = exports.iconSize = exports.caption = exports.display = exports.heading = exports.body = exports.title = exports.label = exports.fontWeight = exports.fontFamily = exports.tableColors = exports.sliderColors = exports.skeletonColors = exports.avatarColors = exports.radioColors = exports.tabsColors = exports.progressColors = exports.toggleColors = exports.checkboxColors = exports.listColors = exports.errorTokens = exports.tagTokens = exports.menuColors = exports.selectColors = exports.overlayTokens = exports.textTokens = exports.surfaceTokens = exports.controlTokens = exports.disabledColors = exports.intentColors = exports.colorSchemes = exports.darkColors = exports.lightColors = void 0;
 var colors_1 = require("./colors");
 Object.defineProperty(exports, "lightColors", { enumerable: true, get: function () { return colors_1.lightColors; } });
 Object.defineProperty(exports, "darkColors", { enumerable: true, get: function () { return colors_1.darkColors; } });
@@ -41,3 +41,14 @@ Object.defineProperty(exports, "breakpoints", { enumerable: true, get: function
 Object.defineProperty(exports, "breakpointOrder", { enumerable: true, get: function () { return breakpoints_1.breakpointOrder; } });
 Object.defineProperty(exports, "resolveBreakpoint", { enumerable: true, get: function () { return breakpoints_1.resolveBreakpoint; } });
 Object.defineProperty(exports, "resolveResponsiveValue", { enumerable: true, get: function () { return breakpoints_1.resolveResponsiveValue; } });
+var motion_1 = require("./motion");
+Object.defineProperty(exports, "duration", { enumerable: true, get: function () { return motion_1.duration; } });
+Object.defineProperty(exports, "cycle", { enumerable: true, get: function () { return motion_1.cycle; } });
+Object.defineProperty(exports, "easing", { enumerable: true, get: function () { return motion_1.easing; } });
+Object.defineProperty(exports, "easingBezier", { enumerable: true, get: function () { return motion_1.easingBezier; } });
+Object.defineProperty(exports, "spring", { enumerable: true, get: function () { return motion_1.spring; } });
+Object.defineProperty(exports, "transition", { enumerable: true, get: function () { return motion_1.transition; } });
+Object.defineProperty(exports, "feedback", { enumerable: true, get: function () { return motion_1.feedback; } });
+Object.defineProperty(exports, "loop", { enumerable: true, get: function () { return motion_1.loop; } });
+Object.defineProperty(exports, "motionTokens", { enumerable: true, get: function () { return motion_1.motionTokens; } });
+Object.defineProperty(exports, "resolveMotion", { enumerable: true, get: function () { return motion_1.resolveMotion; } });

package/dist/tokens/motion.d.ts

@@ -0,0 +1,196 @@
+/**
+ * Motion tokens — the single source for animation timing across Cast UI.
+ *
+ * Two layers, mirroring the colour and spacing token system:
+ *   Primitive  raw durations, cubic-bezier easings, spring configs.
+ *   Semantic   named roles (transition / feedback / loop) that components read.
+ *
+ * Motion is constant across density and colour mode. Density changes spacing
+ * only. Easings are real cubic-beziers, so the same numbers map 1:1 to the
+ * `motion` variable collection in the Figma kit and to CSS.
+ *
+ * Components never read a raw number. They read a semantic role through
+ * useMotion(), for example motion.transition.standard or motion.loop.spin.
+ *
+ * Theming: a cast-theme.json can carry a `motion` block (exported by the
+ * cast-sync plugin from the kit's `motion` variable collection). ThemeProvider
+ * accepts those primitive-level overrides via its `motion` prop and
+ * `resolveMotion` rebuilds every semantic role from them, so a brand can
+ * re-tune timing with no code changes.
+ */
+type EasingFn = (value: number) => number;
+export type EasingName = 'standard' | 'entrance' | 'exit' | 'emphasized' | 'linear';
+/** Cubic-bezier control points as [x1, y1, x2, y2]. */
+export type EasingBezierPoints = readonly [number, number, number, number];
+export type MotionDurations = {
+    /** Micro feedback, e.g. a press. */
+    instant: number;
+    /** Small enters/exits and expands. */
+    fast: number;
+    /** The general state-to-state duration. */
+    base: number;
+    /** Large surfaces or long distances. */
+    slow: number;
+};
+export type MotionCycles = {
+    /** Skeleton fade half-cycle. */
+    pulse: number;
+    /** Spinner full rotation. */
+    spin: number;
+    /** Progress indeterminate sweep. */
+    sweep: number;
+};
+export type SpringConfig = {
+    damping: number;
+    stiffness: number;
+    mass: number;
+};
+export type MotionTransition = {
+    duration: number;
+    easing: EasingFn;
+};
+export type MotionTokens = {
+    duration: MotionDurations;
+    cycle: MotionCycles;
+    easing: Record<EasingName, EasingFn>;
+    easingBezier: Record<EasingName, EasingBezierPoints>;
+    spring: {
+        overlay: SpringConfig;
+    };
+    transition: {
+        standard: MotionTransition;
+        enter: MotionTransition;
+        exit: MotionTransition;
+        expand: MotionTransition;
+    };
+    feedback: {
+        press: MotionTransition & {
+            scale: number;
+        };
+        shake: MotionTransition & {
+            amplitude: number;
+        };
+        pop: MotionTransition;
+    };
+    loop: {
+        spin: MotionTransition;
+        pulse: MotionTransition & {
+            from: number;
+            to: number;
+        };
+        indeterminate: MotionTransition;
+    };
+};
+/**
+ * Primitive-level motion overrides, the shape a cast-theme.json `motion`
+ * block maps onto. Only numbers and beziers — semantic roles are rebuilt
+ * from these by `resolveMotion`, never overridden directly.
+ */
+export type MotionOverrides = {
+    duration?: Partial<MotionDurations>;
+    cycle?: Partial<MotionCycles>;
+    easingBezier?: Partial<Record<EasingName, EasingBezierPoints>>;
+    spring?: {
+        overlay?: Partial<SpringConfig>;
+    };
+    feedback?: {
+        press?: {
+            scale?: number;
+        };
+        shake?: {
+            amplitude?: number;
+        };
+    };
+    loop?: {
+        pulse?: {
+            from?: number;
+            to?: number;
+        };
+    };
+};
+/** Primitive: transition durations in ms (state to state). */
+export declare const duration: MotionDurations;
+/** Primitive: loop cycle lengths in ms (continuous, not state to state). */
+export declare const cycle: MotionCycles;
+/**
+ * Primitive: easing control points as cubic-bezier [x1, y1, x2, y2].
+ * This is the design-side value. The `motion` collection in the Figma kit
+ * carries these exact numbers (easing/{name}/{x1,y1,x2,y2}).
+ */
+export declare const easingBezier: Record<EasingName, EasingBezierPoints>;
+/** Primitive: easing as runtime functions (the code-side value). */
+export declare const easing: Record<EasingName, EasingFn>;
+/** Primitive: spring configs for Animated.spring. */
+export declare const spring: {
+    overlay: SpringConfig;
+};
+export declare const transition: {
+    /** General state-to-state fade or slide. Backdrops, overlay fades. */
+    standard: {
+        duration: number;
+        easing: EasingFn;
+    };
+    /** Something appearing. Decelerates as it lands. */
+    enter: {
+        duration: number;
+        easing: EasingFn;
+    };
+    /** Something leaving. Accelerates as it goes. */
+    exit: {
+        duration: number;
+        easing: EasingFn;
+    };
+    /** Expand or collapse. Accordion chevron, height reveals. */
+    expand: {
+        duration: number;
+        easing: EasingFn;
+    };
+};
+export declare const feedback: {
+    /** Press-down scale on a pressable (reserved for future use). */
+    press: {
+        duration: number;
+        easing: EasingFn;
+        scale: number;
+    };
+    /** Error shake, e.g. input rejection. amplitude in px (future use). */
+    shake: {
+        duration: number;
+        easing: EasingFn;
+        amplitude: number;
+    };
+    /** Pop-in for a check, badge, or toast (future use). */
+    pop: {
+        duration: number;
+        easing: EasingFn;
+    };
+};
+export declare const loop: {
+    /** Spinner rotation. */
+    spin: {
+        duration: number;
+        easing: EasingFn;
+    };
+    /** Skeleton pulse. Fades opacity between from and to. */
+    pulse: {
+        duration: number;
+        easing: EasingFn;
+        from: number;
+        to: number;
+    };
+    /** Progress indeterminate sweep. */
+    indeterminate: {
+        duration: number;
+        easing: EasingFn;
+    };
+};
+/** The full default motion token set, exposed on the theme as `theme.motion`. */
+export declare const motionTokens: MotionTokens;
+/**
+ * Resolve a full motion token set from primitive-level overrides.
+ * With no overrides this returns the shared default set (no allocation).
+ * Semantic roles are always rebuilt from the merged primitives, so a
+ * duration override flows into every role that uses it.
+ */
+export declare function resolveMotion(overrides?: MotionOverrides): MotionTokens;
+export {};

package/dist/tokens/motion.js

@@ -0,0 +1,175 @@
+"use strict";
+/**
+ * Motion tokens — the single source for animation timing across Cast UI.
+ *
+ * Two layers, mirroring the colour and spacing token system:
+ *   Primitive  raw durations, cubic-bezier easings, spring configs.
+ *   Semantic   named roles (transition / feedback / loop) that components read.
+ *
+ * Motion is constant across density and colour mode. Density changes spacing
+ * only. Easings are real cubic-beziers, so the same numbers map 1:1 to the
+ * `motion` variable collection in the Figma kit and to CSS.
+ *
+ * Components never read a raw number. They read a semantic role through
+ * useMotion(), for example motion.transition.standard or motion.loop.spin.
+ *
+ * Theming: a cast-theme.json can carry a `motion` block (exported by the
+ * cast-sync plugin from the kit's `motion` variable collection). ThemeProvider
+ * accepts those primitive-level overrides via its `motion` prop and
+ * `resolveMotion` rebuilds every semantic role from them, so a brand can
+ * re-tune timing with no code changes.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.motionTokens = exports.loop = exports.feedback = exports.transition = exports.spring = exports.easing = exports.easingBezier = exports.cycle = exports.duration = void 0;
+exports.resolveMotion = resolveMotion;
+const react_native_1 = require("react-native");
+/** Primitive: transition durations in ms (state to state). */
+exports.duration = {
+    instant: 100,
+    fast: 150,
+    base: 220,
+    slow: 320,
+};
+/** Primitive: loop cycle lengths in ms (continuous, not state to state). */
+exports.cycle = {
+    pulse: 700,
+    spin: 800,
+    sweep: 1200,
+};
+/**
+ * Primitive: easing control points as cubic-bezier [x1, y1, x2, y2].
+ * This is the design-side value. The `motion` collection in the Figma kit
+ * carries these exact numbers (easing/{name}/{x1,y1,x2,y2}).
+ */
+exports.easingBezier = {
+    standard: [0.4, 0, 0.2, 1],
+    entrance: [0, 0, 0.2, 1],
+    exit: [0.4, 0, 1, 1],
+    emphasized: [0.7, -0.4, 0.4, 1.4],
+    linear: [0, 0, 1, 1],
+};
+/**
+ * Build a lazy easing function from bezier points. The Easing function is
+ * only created when an animation actually runs, so importing the tokens
+ * never touches the native Easing API. That keeps the library safe to
+ * import in any environment.
+ */
+function lazyEasing(points, linear) {
+    let fn = null;
+    return (value) => {
+        if (!fn) {
+            fn = linear ? react_native_1.Easing.linear : react_native_1.Easing.bezier(points[0], points[1], points[2], points[3]);
+        }
+        return fn(value);
+    };
+}
+function isLinear(points) {
+    return points[0] === 0 && points[1] === 0 && points[2] === 1 && points[3] === 1;
+}
+function buildEasings(beziers) {
+    return {
+        standard: lazyEasing(beziers.standard, isLinear(beziers.standard)),
+        entrance: lazyEasing(beziers.entrance, isLinear(beziers.entrance)),
+        exit: lazyEasing(beziers.exit, isLinear(beziers.exit)),
+        emphasized: lazyEasing(beziers.emphasized, isLinear(beziers.emphasized)),
+        linear: lazyEasing(beziers.linear, isLinear(beziers.linear)),
+    };
+}
+/** Primitive: easing as runtime functions (the code-side value). */
+exports.easing = buildEasings(exports.easingBezier);
+/** Primitive: spring configs for Animated.spring. */
+exports.spring = {
+    /** Overlay surfaces sliding in (drawer, bottom sheet). */
+    overlay: { damping: 22, stiffness: 220, mass: 0.9 },
+};
+function buildRoles(p) {
+    return {
+        transition: {
+            /** General state-to-state fade or slide. Backdrops, overlay fades. */
+            standard: { duration: p.duration.base, easing: p.easing.standard },
+            /** Something appearing. Decelerates as it lands. */
+            enter: { duration: p.duration.fast, easing: p.easing.entrance },
+            /** Something leaving. Accelerates as it goes. */
+            exit: { duration: p.duration.fast, easing: p.easing.exit },
+            /** Expand or collapse. Accordion chevron, height reveals. */
+            expand: { duration: p.duration.fast, easing: p.easing.standard },
+        },
+        feedback: {
+            /** Press-down scale on a pressable (reserved for future use). */
+            press: { duration: p.duration.instant, easing: p.easing.standard, scale: p.press.scale },
+            /** Error shake, e.g. input rejection. amplitude in px (future use). */
+            shake: { duration: p.duration.base, easing: p.easing.standard, amplitude: p.shake.amplitude },
+            /** Pop-in for a check, badge, or toast (future use). */
+            pop: { duration: p.duration.fast, easing: p.easing.emphasized },
+        },
+        loop: {
+            /** Spinner rotation. */
+            spin: { duration: p.cycle.spin, easing: p.easing.linear },
+            /** Skeleton pulse. Fades opacity between from and to. */
+            pulse: { duration: p.cycle.pulse, easing: p.easing.standard, from: p.pulse.from, to: p.pulse.to },
+            /** Progress indeterminate sweep. */
+            indeterminate: { duration: p.cycle.sweep, easing: p.easing.standard },
+        },
+    };
+}
+const defaultRoles = buildRoles({
+    duration: exports.duration,
+    cycle: exports.cycle,
+    easing: exports.easing,
+    press: { scale: 0.97 },
+    shake: { amplitude: 4 },
+    pulse: { from: 1, to: 0.5 },
+});
+exports.transition = defaultRoles.transition;
+exports.feedback = defaultRoles.feedback;
+exports.loop = defaultRoles.loop;
+/** The full default motion token set, exposed on the theme as `theme.motion`. */
+exports.motionTokens = {
+    duration: exports.duration,
+    cycle: exports.cycle,
+    easing: exports.easing,
+    easingBezier: exports.easingBezier,
+    spring: exports.spring,
+    transition: exports.transition,
+    feedback: exports.feedback,
+    loop: exports.loop,
+};
+/**
+ * Resolve a full motion token set from primitive-level overrides.
+ * With no overrides this returns the shared default set (no allocation).
+ * Semantic roles are always rebuilt from the merged primitives, so a
+ * duration override flows into every role that uses it.
+ */
+function resolveMotion(overrides) {
+    if (!overrides)
+        return exports.motionTokens;
+    const mergedDuration = { ...exports.duration, ...(overrides.duration ?? {}) };
+    const mergedCycle = { ...exports.cycle, ...(overrides.cycle ?? {}) };
+    const mergedBezier = {
+        ...exports.easingBezier,
+        ...(overrides.easingBezier ?? {}),
+    };
+    const mergedEasing = overrides.easingBezier ? buildEasings(mergedBezier) : exports.easing;
+    const mergedSpring = {
+        overlay: { ...exports.spring.overlay, ...(overrides.spring?.overlay ?? {}) },
+    };
+    const roles = buildRoles({
+        duration: mergedDuration,
+        cycle: mergedCycle,
+        easing: mergedEasing,
+        press: { scale: overrides.feedback?.press?.scale ?? 0.97 },
+        shake: { amplitude: overrides.feedback?.shake?.amplitude ?? 4 },
+        pulse: {
+            from: overrides.loop?.pulse?.from ?? 1,
+            to: overrides.loop?.pulse?.to ?? 0.5,
+        },
+    });
+    return {
+        duration: mergedDuration,
+        cycle: mergedCycle,
+        easing: mergedEasing,
+        easingBezier: mergedBezier,
+        spring: mergedSpring,
+        ...roles,
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@castui/cast-ui",
-  "version": "4.9.0",
+  "version": "4.10.0",
   "description": "A cross-platform design system for React Native (iOS, Android, Web) with multi-theme support.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -65,6 +65,7 @@
     "react-dom": "^19.2.4",
     "react-native": "^0.84.0",
     "react-native-web": "^0.21.2",
+    "remark-gfm": "^4.0.0",
     "storybook": "^10.2.8",
     "typescript": "^5.9.3"
   },