@cdx-ui/components 0.0.1-beta.79 → 0.0.1-beta.80

package/lib/typescript/components/Toast/types.d.ts

@@ -0,0 +1,303 @@
+import { View } from 'react-native';
+import type { EntryOrExitLayoutType, WithTimingConfig } from 'react-native-reanimated';
+import type { ToastRootProps } from '@cdx-ui/primitives';
+import { ForgeIcon } from '@cdx-ui/icons';
+import type { AnimationRoot, AnimationValue } from '../../animation';
+import type { ToastComponentProps, ToastShowOptions } from '../../providers/toast';
+import type { ButtonProps } from '../Button';
+import type { IconButtonProps } from '../IconButton';
+import type { IconProps } from '../Icon';
+import { ToastColorProps } from './styles';
+/**
+ * Toast color types
+ */
+export type ToastColor = ToastColorProps['color'];
+/**
+ * Toast placement types.
+ *
+ * On web, `-start` and `-end` variants position the toast at the
+ * corresponding horizontal edge with a `max-width` of 460 px.
+ * The plain `top` / `bottom` values centre the toast horizontally.
+ *
+ * On native (iOS / Android), `-start` and `-end` degrade gracefully
+ * to edge-to-edge layout identical to their base `top` / `bottom`
+ * counterpart — the toast still spans the full width.
+ */
+export type ToastPlacement = 'top-start' | 'top' | 'top-end' | 'bottom-start' | 'bottom' | 'bottom-end';
+/**
+ * Animation configuration for toast root component
+ */
+export type ToastRootAnimation = AnimationRoot<{
+    opacity?: AnimationValue<{
+        /**
+         * Opacity interpolation values [start, end]
+         * Controls how fast toast items fade out as they move beyond the visible stack limits.
+         * When toasts are pushed out of view (beyond the last few visible items), their opacity
+         * gradually decreases to create a smooth disappearing effect.
+         * - First value: fully visible opacity (1) for items within visible stack
+         * - Second value: hidden opacity (0) for items pushed out of view
+         * @default [1, 0]
+         */
+        value?: [number, number];
+        /**
+         * Animation timing configuration
+         * @default { duration: 300 }
+         */
+        timingConfig?: WithTimingConfig;
+    }>;
+    translateY?: AnimationValue<{
+        /**
+         * Translate Y interpolation values [start, end]
+         * Controls how much of a toast item is visible when it's positioned behind the last visible toast.
+         * This creates a "peek" effect where stacked toasts are slightly offset vertically,
+         * allowing users to see a portion of the toast behind the current one.
+         * - First value: no offset (0) for the last/active toast
+         * - Second value: vertical offset in pixels (10) for toasts behind the last one
+         * Note: The offset direction is automatically adjusted based on placement (top/bottom)
+         * @default [0, 10] (multiplied by placement sign)
+         */
+        value?: [number, number];
+        /**
+         * Animation timing configuration
+         * @default { duration: 300 }
+         */
+        timingConfig?: WithTimingConfig;
+    }>;
+    scale?: AnimationValue<{
+        /**
+         * Scale interpolation values [start, end]
+         * Controls the size scaling of toast items in the stack.
+         * Toasts behind the active one are slightly scaled down to create depth and visual hierarchy.
+         * - First value: normal scale (1) for the active/last toast
+         * - Second value: scaled down value (0.97) for toasts positioned behind
+         * @default [1, 0.97]
+         */
+        value?: [number, number];
+        /**
+         * Animation timing configuration
+         * @default { duration: 300 }
+         */
+        timingConfig?: WithTimingConfig;
+    }>;
+    entering?: AnimationValue<{
+        /**
+         * Custom entering animation for top placement
+         * @default FadeInUp.springify().withInitialValues({ opacity: 1, transform: [{ translateY: -100 }] }).mass(3)
+         */
+        top?: EntryOrExitLayoutType;
+        /**
+         * Custom entering animation for bottom placement
+         * @default FadeInDown.springify().withInitialValues({ opacity: 1, transform: [{ translateY: 100 }] }).mass(3)
+         */
+        bottom?: EntryOrExitLayoutType;
+    }>;
+    exiting?: AnimationValue<{
+        /**
+         * Custom exiting animation for top placement
+         * @default Keyframe animation with translateY: -100, scale: 0.97, opacity: 0.5
+         */
+        top?: EntryOrExitLayoutType;
+        /**
+         * Custom exiting animation for bottom placement
+         * @default Keyframe animation with translateY: 100, scale: 0.97, opacity: 0.5
+         */
+        bottom?: EntryOrExitLayoutType;
+    }>;
+}>;
+/**
+ * Props for the Toast.Root component
+ */
+export interface ToastProps extends ToastRootProps, Omit<ToastComponentProps, 'id'> {
+    /**
+     * Color of the toast
+     * @default 'default'
+     */
+    color?: ToastColor;
+    /**
+     * Placement of the toast
+     * @default 'bottom'
+     */
+    placement?: ToastPlacement;
+    /**
+     * Additional CSS class for the toast container
+     *
+     * @note The following style properties are occupied by animations and cannot be set via className:
+     * - `opacity` - Animated for visibility transitions when toasts are pushed beyond visible stack limits
+     * - `transform` (translateY) - Animated for vertical position transitions when toasts are stacked, and for swipe-to-dismiss gestures
+     * - `transform` (scale) - Animated for size scaling transitions when toasts are stacked (toasts behind active one are scaled down)
+     * - `height` - Animated for height transitions when toast content changes
+     *
+     * To customize these properties, use the `animation` prop:
+     * ```tsx
+     * <Toast.Root
+     *   animation={{
+     *     opacity: {
+     *       value: [1, 0],
+     *       timingConfig: { duration: 300 }
+     *     },
+     *     translateY: {
+     *       value: [0, 10],
+     *       timingConfig: { duration: 300 }
+     *     },
+     *     scale: {
+     *       value: [1, 0.97],
+     *       timingConfig: { duration: 300 }
+     *     }
+     *   }}
+     * />
+     * ```
+     *
+     * To completely disable animated styles and use your own via className or style prop, set `isAnimatedStyleActive={false}`.
+     */
+    className?: string;
+    /**
+     * Animation configuration for toast
+     * - `false` or `"disabled"`: Disable only root animations
+     * - `"disable-all"`: Disable all animations including children
+     * - `true` or `undefined`: Use default animations
+     * - `object`: Custom animation configuration
+     */
+    animation?: ToastRootAnimation;
+    /**
+     * Whether the toast can be swiped to dismiss and dragged with rubber effect
+     * @default true
+     */
+    isSwipeable?: boolean;
+    /**
+     * Whether animated styles (react-native-reanimated) are active
+     * When `false`, the animated style is removed and you can implement custom logic
+     * This prop should only be used when you want to write custom styling logic instead of the default animated styles
+     * @default true
+     */
+    isAnimatedStyleActive?: boolean;
+}
+/**
+ * Props for the Toast.Title component
+ */
+export interface ToastTitleProps {
+    /**
+     * Content to be rendered as title
+     */
+    children?: React.ReactNode;
+    /**
+     * Additional CSS class for the title
+     */
+    className?: string;
+}
+/**
+ * Props for the Toast.Description component
+ */
+export interface ToastDescriptionProps {
+    /**
+     * Content to be rendered as description
+     */
+    children?: React.ReactNode;
+    /**
+     * Additional CSS class for the description
+     */
+    className?: string;
+}
+/**
+ * Props for the Toast.Icon component
+ */
+export interface ToastIconProps extends Omit<IconProps, 'children' | 'as'> {
+    asChild?: boolean;
+    /**
+     * Forge icon component to render. Required unless `asChild` is set.
+     */
+    as?: IconProps['as'];
+    /**
+     * Child element to render when `asChild` is set.
+     */
+    children?: React.ReactNode;
+}
+/**
+ * Props for the Toast.Action component
+ */
+export type ToastActionProps = ButtonProps;
+/**
+ * Props for the Toast.Close component
+ */
+export type ToastCloseProps = Omit<IconButtonProps, 'as'> & {
+    /**
+     * Forge icon component to render (icon-only control).
+     * @default CloseIcon
+     */
+    as?: ForgeIcon;
+};
+/**
+ * Context values shared between Toast components
+ */
+export interface ToastContextValue {
+    /**
+     * Color of the toast
+     */
+    color?: ToastColor;
+    /**
+     * Function to hide the toast
+     */
+    hide?: (ids?: (string & {}) | string[] | 'all') => void;
+    /**
+     * ID of the toast
+     */
+    id?: string;
+}
+/**
+ * Ref type for the Toast.Root component
+ */
+export type ToastRootRef = React.ComponentRef<typeof View>;
+/**
+ * Props for useToastRootAnimation hook
+ * Picks required properties from ToastRootProps and adds id from ToastComponentProps
+ */
+export type UseToastRootAnimationOptions = Pick<ToastProps, 'animation' | 'index' | 'total' | 'heights' | 'placement' | 'hide' | 'isSwipeable' | 'maxVisibleToasts'> & Pick<ToastComponentProps, 'id'>;
+/**
+ * Props for the DefaultToast component
+ * Used internally when showing toasts with string or config object (without component)
+ */
+export interface DefaultToastProps extends ToastComponentProps {
+    /**
+     * Color of the toast
+     * @default 'default'
+     */
+    color?: ToastProps['color'];
+    /**
+     * Placement of the toast
+     * @default 'bottom'
+     */
+    placement?: ToastProps['placement'];
+    /**
+     * Animation configuration for toast
+     */
+    animation?: ToastProps['animation'];
+    /**
+     * Whether the toast can be swiped to dismiss and dragged with rubber effect
+     */
+    isSwipeable?: ToastProps['isSwipeable'];
+    /**
+     * Label text for the toast
+     */
+    label?: string;
+    /**
+     * Description text for the toast
+     */
+    description?: string;
+    /**
+     * Action button label text
+     */
+    actionLabel?: string;
+    /**
+     * Callback function called when the action button is pressed
+     * Receives show and hide functions for programmatic toast control
+     */
+    onActionPress?: (helpers: {
+        show: (options: string | ToastShowOptions) => string;
+        hide: (ids?: (string & {}) | string[] | 'all') => void;
+    }) => void;
+    /**
+     * Forge icon component to display in the toast.
+     * Rendered via `Toast.Icon` internally — inherits color-aware coloring automatically.
+     */
+    icon?: ForgeIcon;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/components/Toast/types.d.ts.map

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

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

@@ -26,6 +26,7 @@ export * from './Select';
 export * from './VirtualizedList';
 export * from './Switch';
 export * from './Tile';
+export * from './Toast';
 export { HStack, VStack } from './Stack';
 export * from './Heading';
 export * from './Text';

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,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,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,QAAQ,CAAC;AACvB,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,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,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,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/lib/typescript/index.d.ts

@@ -2,6 +2,8 @@
 export * from './components';
 export * from './hooks';
 export * from './navigation';
+export { ToastProvider, useToast } from './providers/toast';
+export type * from './providers/toast';
 export { View, ScrollView, KeyboardAvoidingView } from 'react-native';
 export { SafeAreaView, useSafeAreaInsets } from 'react-native-safe-area-context';
 //# 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,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AACA,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC5D,mBAAmB,mBAAmB,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC"}

package/lib/typescript/providers/animation-settings/index.d.ts

@@ -0,0 +1,3 @@
+export { GlobalAnimationSettingsProvider, AnimationSettingsProvider, useGlobalAnimationSettings, useAnimationSettings, } from './provider';
+export type { GlobalAnimationSettingsContextValue, GlobalAnimationSettingsProviderProps, AnimationSettingsContextValue, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/providers/animation-settings/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/providers/animation-settings/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,+BAA+B,EAC/B,yBAAyB,EACzB,0BAA0B,EAC1B,oBAAoB,GACrB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,mCAAmC,EACnC,oCAAoC,EACpC,6BAA6B,GAC9B,MAAM,SAAS,CAAC"}

package/lib/typescript/providers/animation-settings/provider.d.ts

@@ -0,0 +1,28 @@
+import React from 'react';
+import type { GlobalAnimationSettingsContextValue, GlobalAnimationSettingsProviderProps, AnimationSettingsContextValue } from './types';
+declare const useGlobalAnimationSettings: () => GlobalAnimationSettingsContextValue;
+export { useGlobalAnimationSettings };
+/**
+ * GlobalAnimationSettingsProvider Component
+ *
+ * @description
+ * Provider component that controls global animation settings across the application.
+ * When animation is set to 'disable-all', all animations will be disabled globally.
+ * Additionally, if the user has enabled reduce motion in accessibility settings,
+ * all animations will be disabled automatically.
+ *
+ * The global setting is read directly via `useGlobalAnimationSettings`; the
+ * separate `AnimationSettingsProvider` handles per-subtree cascading. Both
+ * contexts are non-strict, so components can read them without a provider
+ * mounted (falling back to "animations enabled").
+ *
+ * @param {GlobalAnimationSettingsProviderProps} props - Provider props
+ * @param {AnimationRootDisableAll} [props.animation] - Global animation setting
+ * @param {ReactNode} props.children - Child components to wrap
+ */
+export declare const GlobalAnimationSettingsProvider: React.FC<GlobalAnimationSettingsProviderProps>;
+export declare const AnimationSettingsProvider: React.FunctionComponent<{
+    children: React.ReactNode;
+    value: AnimationSettingsContextValue;
+}>, useAnimationSettings: () => AnimationSettingsContextValue;
+//# sourceMappingURL=provider.d.ts.map

package/lib/typescript/providers/animation-settings/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../../src/providers/animation-settings/provider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,KAAK,EACV,mCAAmC,EACnC,oCAAoC,EACpC,6BAA6B,EAC9B,MAAM,SAAS,CAAC;AAEjB,QAAA,MAAiD,0BAA0B,2CAIvE,CAAC;AAEL,OAAO,EAAE,0BAA0B,EAAE,CAAC;AAEtC;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,+BAA+B,EAAE,KAAK,CAAC,EAAE,CAAC,oCAAoC,CAY1F,CAAC;AAEF,eAAO,MAAO,yBAAyB;;;IAAE,oBAAoB,qCAIzD,CAAC"}

package/lib/typescript/providers/animation-settings/types.d.ts

@@ -0,0 +1,35 @@
+import type { ReactNode } from 'react';
+import type { AnimationRootDisableAll } from '../../animation';
+/**
+ * Props for GlobalAnimationSettingsProvider component
+ */
+export interface GlobalAnimationSettingsProviderProps {
+    /**
+     * Global animation setting
+     * When set to 'disable-all', all animations across the app will be disabled
+     */
+    animation?: AnimationRootDisableAll;
+    /**
+     * Child components to render within the provider
+     */
+    children: ReactNode;
+}
+/**
+ * Context value for global animation settings
+ */
+export interface GlobalAnimationSettingsContextValue {
+    /**
+     * Whether all animations should be disabled globally
+     */
+    globalIsAllAnimationsDisabled: boolean;
+}
+/**
+ * Context value for global animation settings
+ */
+export interface AnimationSettingsContextValue {
+    /**
+     * Whether all animations should be disabled (cascading from parent)
+     */
+    isAllAnimationsDisabled: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/providers/animation-settings/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/providers/animation-settings/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,oCAAoC;IACnD;;;OAGG;IACH,SAAS,CAAC,EAAE,uBAAuB,CAAC;IACpC;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,mCAAmC;IAClD;;OAEG;IACH,6BAA6B,EAAE,OAAO,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C;;OAEG;IACH,uBAAuB,EAAE,OAAO,CAAC;CAClC"}

package/lib/typescript/providers/forge-design/index.d.ts

@@ -0,0 +1,3 @@
+export { default as ForgeDesignProvider } from './provider';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/providers/forge-design/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/providers/forge-design/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAC5D,cAAc,SAAS,CAAC"}

package/lib/typescript/providers/forge-design/provider.d.ts

@@ -0,0 +1,24 @@
+import React from 'react';
+import type { ForgeDesignProviderProps } from './types';
+/**
+ * ForgeDesignProvider Component
+ *
+ * @description
+ * Main provider component for HeroUI Native that configures the application
+ * with global settings. This component should wrap your entire application
+ * or the section where you want to use HeroUI Native components.
+ *
+ * Currently provides:
+ * - Global animation settings
+ * - Global text component configuration
+ * - Toast notification system
+ * - Portal management for overlays
+ *
+ * @param {ForgeDesignProviderProps} props - Provider configuration props
+ * @param {ReactNode} props.children - Child components to wrap
+ * @param {ForgeDesignConfig} [props.config] - Configuration object
+ *
+ */
+declare const ForgeDesignProvider: React.FC<ForgeDesignProviderProps>;
+export default ForgeDesignProvider;
+//# sourceMappingURL=provider.d.ts.map

package/lib/typescript/providers/forge-design/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../../src/providers/forge-design/provider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAO1B,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AAExD;;;;;;;;;;;;;;;;;;GAkBG;AACH,QAAA,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAAE,CAAC,wBAAwB,CA8B3D,CAAC;AAEF,eAAe,mBAAmB,CAAC"}

package/lib/typescript/providers/forge-design/types.d.ts

@@ -0,0 +1,82 @@
+import type { ReactNode } from 'react';
+import type { AnimationRootDisableAll } from '../../animation';
+import type { TextComponentContextValue } from '../text-component/types';
+import type { ToastProviderProps } from '../toast/types';
+/**
+ * Configuration object for ForgeDesignProvider
+ *
+ * @interface ForgeDesignConfig
+ * @extends TextComponentContextValue
+ *
+ * @description
+ * Contains configuration options for the HeroUI Native provider.
+ * Additional configuration options can be added in future versions.
+ */
+export interface ForgeDesignConfig extends TextComponentContextValue {
+    /**
+     * Global animation configuration
+     *
+     * @description
+     * When set to 'disable-all', all animations across the application will be disabled.
+     */
+    animation?: AnimationRootDisableAll;
+    /**
+     * Toast configuration
+     *
+     * @description
+     * Configure the global toast system including insets and wrapper components.
+     * Set to `false` or `'disabled'` to disable the toast provider entirely.
+     * Provide a `ToastProviderProps` object for custom configuration.
+     */
+    toast?: boolean | 'disabled' | ToastProviderProps;
+}
+/**
+ * Props for ForgeDesignProvider component
+ *
+ * @interface ForgeDesignProviderProps
+ *
+ * @description
+ * Main provider component props that wraps the entire application
+ * or a section of it to provide HeroUI Native functionality.
+ *
+ * @example
+ * ```tsx
+ * <ForgeDesignProvider config={{
+ *   textProps: {
+ *     allowFontScaling: false,
+ *     maxFontSizeMultiplier: 1.5
+ *   }
+ * }}>
+ *   <App />
+ * </ForgeDesignProvider>
+ * ```
+ */
+export interface ForgeDesignProviderProps {
+    /**
+     * Child components to render within the provider
+     *
+     * @description
+     * All children will have access to HeroUI Native theme
+     * and configuration through the provider.
+     */
+    children: ReactNode;
+    /**
+     * Configuration object for the provider
+     *
+     * @description
+     * Contains all configuration options including global text component configuration.
+     *
+     * @example
+     * ```tsx
+     * const config: ForgeDesignConfig = {
+     *   textProps: {
+     *     allowFontScaling: false,
+     *     adjustsFontSizeToFit: false,
+     *     maxFontSizeMultiplier: 1.5
+     *   }
+     * };
+     * ```
+     */
+    config?: ForgeDesignConfig;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/providers/forge-design/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/providers/forge-design/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzD;;;;;;;;;GASG;AACH,MAAM,WAAW,iBAAkB,SAAQ,yBAAyB;IAClE;;;;;OAKG;IACH,SAAS,CAAC,EAAE,uBAAuB,CAAC;IACpC;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,kBAAkB,CAAC;CACnD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;;;;OAMG;IACH,QAAQ,EAAE,SAAS,CAAC;IAEpB;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC5B"}

package/lib/typescript/providers/text-component/index.d.ts

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

package/lib/typescript/providers/text-component/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/providers/text-component/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC"}

package/lib/typescript/providers/text-component/provider.d.ts

@@ -0,0 +1,7 @@
+import type { TextComponentContextValue } from './types';
+declare const TextComponentProvider: import("react").FunctionComponent<{
+    children: import("react").ReactNode;
+    value: TextComponentContextValue;
+}>, useTextComponent: () => TextComponentContextValue;
+export { TextComponentProvider, useTextComponent };
+//# sourceMappingURL=provider.d.ts.map

package/lib/typescript/providers/text-component/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../../src/providers/text-component/provider.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AAEzD,QAAA,MAAO,qBAAqB;;;IAAE,gBAAgB,iCACoB,CAAC;AAEnE,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,CAAC"}

package/lib/typescript/providers/text-component/types.d.ts

@@ -0,0 +1,51 @@
+import type { TextProps } from 'react-native';
+/**
+ * Global text component configuration props.
+ * These props are carefully selected to include only those that make sense
+ * to configure globally across all Text components in the application.
+ *
+ * @description
+ * Includes accessibility and font scaling settings that typically
+ * should be consistent throughout the app for better UX.
+ */
+export interface TextComponentProps {
+    /**
+     * Specifies whether fonts should be scaled down automatically to fit given style constraints.
+     *
+     * @default false
+     */
+    adjustsFontSizeToFit?: TextProps['adjustsFontSizeToFit'];
+    /**
+     * Specifies whether fonts should scale to respect Text Size accessibility settings.
+     *
+     * @default true
+     */
+    allowFontScaling?: TextProps['allowFontScaling'];
+    /**
+     * Specifies the largest possible scale a font can reach when `allowFontScaling` is enabled.
+     *
+     * Possible values:
+     *
+     * - `null` or `undefined`: inherit from the parent node or the global default (0)
+     * - `0`: no max, ignore parent/global default
+     * - `>= 1`: sets the `maxFontSizeMultiplier` of this node to this value
+     *
+     * @default `undefined`
+     */
+    maxFontSizeMultiplier?: TextProps['maxFontSizeMultiplier'];
+    /**
+     * Specifies the smallest possible scale a font can reach when adjustsFontSizeToFit is enabled. (values 0.01-1.0).
+     *
+     * iOS only
+     *
+     * @default `undefined`
+     */
+    minimumFontScale?: TextProps['minimumFontScale'];
+}
+/**
+ * Context value for text component configuration
+ */
+export interface TextComponentContextValue {
+    textProps?: TextComponentProps;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/providers/text-component/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/providers/text-component/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,SAAS,CAAC,sBAAsB,CAAC,CAAC;IACzD;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,SAAS,CAAC,kBAAkB,CAAC,CAAC;IACjD;;;;;;;;;;OAUG;IACH,qBAAqB,CAAC,EAAE,SAAS,CAAC,uBAAuB,CAAC,CAAC;IAC3D;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,SAAS,CAAC,kBAAkB,CAAC,CAAC;CAClD;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,SAAS,CAAC,EAAE,kBAAkB,CAAC;CAChC"}

package/lib/typescript/providers/toast/index.d.ts

@@ -0,0 +1,5 @@
+export { ToastProvider, useToast } from './provider';
+export { useToastConfig } from './toast-config.context';
+export { useToastLifecycle } from './lifecycle.context';
+export type * from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/providers/toast/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,mBAAmB,SAAS,CAAC"}