@cdx-ui/components 0.0.1-beta.13 → 0.0.1-beta.130

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"}

package/lib/typescript/providers/toast/insets-container.d.ts

@@ -0,0 +1,72 @@
+import type { ReactNode } from 'react';
+import type { ToastInsets } from './types';
+interface InsetsContainerProps {
+    /**
+     * When true, uses a regular View instead of FullWindowOverlay on iOS.
+     * Enables element inspector but toasts won't appear above native modals.
+     * @default false
+     */
+    disableFullWindowOverlay: boolean;
+    /**
+     * Controls whether VoiceOver treats the overlay window as a modal container.
+     * When `false`, VoiceOver can still access elements behind the overlay.
+     * When `true`, VoiceOver is restricted to elements inside the overlay.
+     * @default false
+     * @platform ios
+     * @unstable This prop maps directly to the native `accessibilityViewIsModal`
+     * on the container view and may change in a future react-native-screens release.
+     */
+    unstable_accessibilityContainerViewIsModal?: boolean;
+    /**
+     * Optional inset values for all edges
+     * If not provided, defaults to platform-specific values:
+     * - iOS: safe area insets + 0px (top), + 6px (bottom), + 12px (left/right)
+     * - Android: safe area insets + 12px (all edges)
+     */
+    insets?: ToastInsets;
+    /**
+     * Accessible label for the toast notification region on web.
+     * @default 'Notifications'
+     * @platform web
+     */
+    announceLabel?: string;
+    /**
+     * Custom wrapper function to wrap the toast content
+     * Receives children and should return a component that wraps them
+     * The wrapper should apply flex: 1 (via className or style) to ensure proper layout
+     * Can be any component wrapper - KeyboardAvoidingView, View, or any custom component
+     */
+    contentWrapper?: (children: ReactNode) => React.ReactElement;
+    /**
+     * Pause all auto-dismiss timers (WCAG 2.2.1).
+     */
+    pauseAll: () => void;
+    /**
+     * Resume all auto-dismiss timers.
+     */
+    resumeAll: () => void;
+    /**
+     * Hide the front-most toast. Used by the Escape key handler on web.
+     */
+    hide: () => void;
+    /**
+     * Children to render inside the container
+     */
+    children: ReactNode;
+}
+/**
+ * Container component that applies inset padding to position toasts
+ * away from screen edges and safe areas
+ *
+ * Combines custom insets with safe area insets:
+ * - If custom inset is provided, it overrides safe area + default padding
+ * - If not provided, uses platform-specific defaults:
+ *   - iOS: safe area inset + 0px for top, + 6px for bottom, + 12px for left/right
+ *   - Android: safe area inset + 12px for all edges
+ *
+ * On web, wires pointer/focus/visibility listeners to pause/resume timers
+ * per WCAG 2.2.1 (keyboard/pointer/hidden-tab pausing).
+ */
+export declare function InsetsContainer({ insets, announceLabel, contentWrapper, children, disableFullWindowOverlay, unstable_accessibilityContainerViewIsModal, pauseAll, resumeAll, hide, }: Readonly<InsetsContainerProps>): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=insets-container.d.ts.map

package/lib/typescript/providers/toast/insets-container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insets-container.d.ts","sourceRoot":"","sources":["../../../../src/providers/toast/insets-container.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAKvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAI3C,UAAU,oBAAoB;IAC5B;;;;OAIG;IACH,wBAAwB,EAAE,OAAO,CAAC;IAClC;;;;;;;;OAQG;IACH,0CAA0C,CAAC,EAAE,OAAO,CAAC;IACrD;;;;;OAKG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,SAAS,KAAK,KAAK,CAAC,YAAY,CAAC;IAC7D;;OAEG;IACH,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB;;OAEG;IACH,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB;;OAEG;IACH,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,EAC9B,MAAM,EACN,aAA+B,EAC/B,cAAc,EACd,QAAQ,EACR,wBAAwB,EACxB,0CAA0C,EAC1C,QAAQ,EACR,SAAS,EACT,IAAI,GACL,EAAE,QAAQ,CAAC,oBAAoB,CAAC,2CAgJhC"}

package/lib/typescript/providers/toast/lifecycle.context.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Internal context that exposes the pending-removal lifecycle for web toasts.
+ *
+ * Web toasts stay mounted after `hide()` is dispatched so the CSS exit
+ * transition can play. The toast component reads `pendingRemovalIds` to
+ * flip its `data-state="closed"` attribute and calls `remove(id)` when
+ * the CSS transition completes (or a safety timeout fires).
+ *
+ * On native this context is provided but effectively unused — Reanimated's
+ * `exiting` layout animation plays before unmount, so nothing lingers.
+ *
+ * @internal
+ */
+export interface ToastLifecycleContextValue {
+    /** Force-remove a toast from the array once its exit transition has played. */
+    remove: (id: string) => void;
+    /** IDs of toasts that have been marked closed but are still mounted. */
+    pendingRemovalIds: ReadonlySet<string>;
+    /** ID of the front-most (last non-pending) toast, or null if none. */
+    frontmostId: string | null;
+}
+export declare const ToastLifecycleContext: import("react").Context<ToastLifecycleContextValue | null>;
+/**
+ * Access the toast lifecycle context.
+ *
+ * Returns `null` when the styled Toast is rendered outside a `ToastProvider`
+ * (e.g. in isolated unit tests) so callers must handle the null case.
+ *
+ * @internal
+ */
+export declare function useToastLifecycle(): ToastLifecycleContextValue | null;
+//# sourceMappingURL=lifecycle.context.d.ts.map

package/lib/typescript/providers/toast/lifecycle.context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.context.d.ts","sourceRoot":"","sources":["../../../../src/providers/toast/lifecycle.context.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,0BAA0B;IACzC,+EAA+E;IAC/E,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,wEAAwE;IACxE,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACvC,sEAAsE;IACtE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,eAAO,MAAM,qBAAqB,4DAAyD,CAAC;AAE5F;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,IAAI,0BAA0B,GAAG,IAAI,CAErE"}

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

@@ -0,0 +1,32 @@
+import type { ToastProviderProps } from './types';
+/**
+ * Toast provider component
+ * Wraps your app to enable toast functionality
+ */
+export declare function ToastProvider({ defaultProps, insets, maxVisibleToasts, contentWrapper, children, disableFullWindowOverlay, unstable_accessibilityContainerViewIsModal, announceLabel, }: Readonly<ToastProviderProps>): import("react/jsx-runtime").JSX.Element;
+/**
+ * Hook to access toast functionality
+ *
+ * @returns Object containing toast manager and visibility state
+ *
+ * @example
+ * ```tsx
+ * const { toast, isToastVisible } = useToast();
+ *
+ * // Show a toast
+ * toast.show({ component: <Toast>Hello</Toast> });
+ *
+ * // Hide a toast
+ * toast.hide('my-toast');
+ *
+ * // Check if any toast is visible
+ * if (isToastVisible) {
+ *   console.log('A toast is currently displayed');
+ * }
+ * ```
+ */
+export declare function useToast(): {
+    toast: import("./types").ToastManager;
+    isToastVisible: boolean;
+};
+//# sourceMappingURL=provider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../../src/providers/toast/provider.tsx"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAIV,kBAAkB,EAInB,MAAM,SAAS,CAAC;AA2FjB;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAC5B,YAAY,EACZ,MAAM,EACN,gBAAoB,EACpB,cAAc,EACd,QAAQ,EACR,wBAAgC,EAChC,0CAA0C,EAC1C,aAAa,GACd,EAAE,QAAQ,CAAC,kBAAkB,CAAC,2CAwZ9B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,QAAQ;;;EAWvB"}

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

@@ -0,0 +1,14 @@
+import type { ToastAction, ToastItem } from './types';
+/**
+ * Reducer for managing toast state
+ *
+ * Removal is a two-phase flow so web can play its CSS exit transition
+ * before the DOM node is unmounted:
+ *   `MARK_CLOSED` → flips `pendingRemoval: true` (node stays mounted).
+ *   `REMOVE`      → filters the toast out of the array (node unmounts).
+ *
+ * Native dispatches `REMOVE` directly since Reanimated's `exiting`
+ * layout animation plays before unmount without a lingering state.
+ */
+export declare function toastReducer(state: ToastItem[], action: ToastAction): ToastItem[];
+//# sourceMappingURL=reducer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reducer.d.ts","sourceRoot":"","sources":["../../../../src/providers/toast/reducer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEtD;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,WAAW,GAAG,SAAS,EAAE,CA0BjF"}

package/lib/typescript/providers/toast/toast-config.context.d.ts

@@ -0,0 +1,20 @@
+import type { ToastGlobalConfig } from './types';
+/**
+ * Context for global toast configuration
+ * Extracted to separate file to avoid circular dependencies with toast component
+ */
+declare const ToastConfigContext: import("react").Context<ToastGlobalConfig | undefined>;
+/**
+ * Hook to access global toast configuration
+ *
+ * @returns Global toast configuration or undefined if not set
+ *
+ * @example
+ * ```tsx
+ * const globalConfig = useToastConfig();
+ * // Use globalConfig.color, globalConfig.placement, etc.
+ * ```
+ */
+export declare function useToastConfig(): ToastGlobalConfig | undefined;
+export { ToastConfigContext };
+//# sourceMappingURL=toast-config.context.d.ts.map

package/lib/typescript/providers/toast/toast-config.context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toast-config.context.d.ts","sourceRoot":"","sources":["../../../../src/providers/toast/toast-config.context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD;;;GAGG;AACH,QAAA,MAAM,kBAAkB,wDAA0D,CAAC;AAEnF;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,IAAI,iBAAiB,GAAG,SAAS,CAE9D;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/lib/typescript/providers/toast/toast-item-renderer.d.ts

@@ -0,0 +1,7 @@
+import type { ToastItemRendererProps } from './types';
+/**
+ * Memoized toast item component to prevent unnecessary re-renders
+ * Only re-renders when the toast item itself changes
+ */
+export declare const ToastItemRenderer: import("react").MemoExoticComponent<({ toastItem, show, hide, index, total, heights, maxVisibleToasts }: ToastItemRendererProps) => import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>>>;
+//# sourceMappingURL=toast-item-renderer.d.ts.map

package/lib/typescript/providers/toast/toast-item-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toast-item-renderer.d.ts","sourceRoot":"","sources":["../../../../src/providers/toast/toast-item-renderer.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAEtD;;;GAGG;AACH,eAAO,MAAM,iBAAiB,2GACyC,sBAAsB,gGA+B5F,CAAC"}