@coze-arch/cli 0.0.10 → 0.0.11

package/lib/__templates__/expo/client/heroui/providers/toast/provider.tsx

@@ -0,0 +1,431 @@
+import {
+  createContext,
+  useCallback,
+  useContext,
+  useMemo,
+  useReducer,
+  useRef,
+} from 'react';
+import { View } from 'react-native';
+import { useSharedValue } from 'react-native-reanimated';
+import { DefaultToast } from '../../components/toast/toast';
+import { InsetsContainer } from './insets-container';
+import { toastReducer } from './reducer';
+import { ToastConfigContext } from './toast-config.context';
+import { ToastItemRenderer } from './toast-item-renderer';
+import type {
+  ToastComponentProps,
+  ToasterContextValue,
+  ToastGlobalConfig,
+  ToastProviderProps,
+  ToastShowConfig,
+  ToastShowOptions,
+  ToastShowOptionsWithComponent,
+} from './types';
+
+const DEFAULT_DURATION = 4000;
+
+/**
+ * Context for toast manager
+ */
+const ToasterContext = createContext<ToasterContextValue | null>(null);
+
+/**
+ * Merges global config with local config, ensuring local config takes precedence
+ * Only includes defined values from localConfig to avoid overriding global config with undefined
+ */
+function mergeToastConfig(
+  globalConfig: ToastGlobalConfig | undefined,
+  localConfig: Partial<ToastGlobalConfig>
+): Partial<ToastGlobalConfig> {
+  const result: Partial<ToastGlobalConfig> = { ...globalConfig };
+
+  // Only override with defined values from localConfig
+  if (localConfig.variant !== undefined) {
+    result.variant = localConfig.variant;
+  }
+  if (localConfig.placement !== undefined) {
+    result.placement = localConfig.placement;
+  }
+  if (localConfig.isSwipeable !== undefined) {
+    result.isSwipeable = localConfig.isSwipeable;
+  }
+  if (localConfig.animation !== undefined) {
+    result.animation = localConfig.animation;
+  }
+
+  return result;
+}
+
+/**
+ * Creates a component function for simple string toast
+ */
+function createStringToastComponent(
+  label: string,
+  globalConfig: ToastGlobalConfig | undefined
+): (props: ToastComponentProps) => React.ReactElement {
+  return (props: ToastComponentProps) => {
+    const mergedConfig = mergeToastConfig(globalConfig, {
+      variant: 'default',
+    });
+    return (
+      <DefaultToast
+        {...props}
+        label={label}
+        variant={mergedConfig.variant}
+        placement={mergedConfig.placement}
+        isSwipeable={mergedConfig.isSwipeable}
+        animation={mergedConfig.animation}
+      />
+    );
+  };
+}
+
+/**
+ * Creates a component function for config-based toast
+ */
+function createConfigToastComponent(
+  config: ToastShowConfig,
+  globalConfig: ToastGlobalConfig | undefined
+): (props: ToastComponentProps) => React.ReactElement {
+  return (props: ToastComponentProps) => {
+    const mergedConfig = mergeToastConfig(globalConfig, {
+      variant: config.variant,
+      placement: config.placement,
+      isSwipeable: config.isSwipeable,
+      animation: config.animation,
+    });
+    return (
+      <DefaultToast
+        {...props}
+        variant={mergedConfig.variant}
+        placement={mergedConfig.placement}
+        isSwipeable={mergedConfig.isSwipeable}
+        animation={mergedConfig.animation}
+        label={config.label}
+        description={config.description}
+        actionLabel={config.actionLabel}
+        onActionPress={config.onActionPress}
+        icon={config.icon}
+      />
+    );
+  };
+}
+
+/**
+ * Toast provider component
+ * Wraps your app to enable toast functionality
+ */
+export function ToastProvider({
+  defaultProps,
+  insets,
+  maxVisibleToasts = 3,
+  contentWrapper,
+  children,
+  disableFullWindowOverlay = false,
+}: ToastProviderProps) {
+  const [toasts, dispatch] = useReducer(toastReducer, []);
+
+  /**
+   * Memoize global config to prevent unnecessary re-renders
+   */
+  const globalConfig = useMemo<ToastGlobalConfig | undefined>(
+    () => defaultProps,
+    [defaultProps]
+  );
+
+  const isToastVisible = toasts.length > 0;
+
+  const heights = useSharedValue<Record<string, number>>({});
+
+  const total = useSharedValue<number>(0);
+
+  const idCounter = useRef(0);
+  const timeoutRefs = useRef<Map<string, NodeJS.Timeout>>(new Map());
+  const hideRef = useRef<((ids?: string | string[] | 'all') => void) | null>(
+    null
+  );
+
+  /**
+   * Hide one or more toasts
+   * - No argument: hides the last toast in the array
+   * - "all": hides all toasts
+   * - Single ID: hides that toast
+   * - Array of IDs: hides those toasts
+   */
+  const hide = useCallback(
+    (ids?: string | string[] | 'all') => {
+      if (ids === undefined) {
+        // Hide the last toast in the array
+        if (toasts.length > 0) {
+          const lastToast = toasts[toasts.length - 1];
+          if (!lastToast) return;
+
+          // Clear timeout if exists
+          const timeout = timeoutRefs.current.get(lastToast.id);
+          if (timeout) {
+            clearTimeout(timeout);
+            timeoutRefs.current.delete(lastToast.id);
+          }
+
+          if (lastToast.onHide) {
+            lastToast.onHide();
+          }
+
+          dispatch({
+            type: 'HIDE',
+            payload: { ids: [lastToast.id] },
+          });
+
+          heights.modify(<T extends Record<string, number>>(value: T): T => {
+            'worklet';
+            const result = { ...value };
+            delete result[lastToast.id];
+            return result;
+          });
+
+          total.set((value) => value - 1);
+        }
+      } else if (ids === 'all') {
+        // Clear all timeouts
+        timeoutRefs.current.forEach((timeout) => {
+          clearTimeout(timeout);
+        });
+        timeoutRefs.current.clear();
+
+        // Hide all toasts - call onHide for each toast before hiding
+        toasts.forEach((toast) => {
+          if (toast.onHide) {
+            toast.onHide();
+          }
+        });
+        dispatch({ type: 'HIDE_ALL' });
+        heights.set({});
+        total.set(0);
+      } else {
+        // Hide specific toast(s) - call onHide for each toast before hiding
+        const idsArray = Array.isArray(ids) ? ids : [ids];
+        const idsToRemove = idsArray;
+        let removedCount = 0;
+
+        // Find and call onHide callbacks before removing, and clear timeouts
+        idsToRemove.forEach((id) => {
+          // Clear timeout if exists
+          const timeout = timeoutRefs.current.get(id);
+          if (timeout) {
+            clearTimeout(timeout);
+            timeoutRefs.current.delete(id);
+          }
+
+          const toast = toasts.find((t) => String(t.id) === String(id));
+          if (toast) {
+            removedCount++;
+            if (toast.onHide) {
+              toast.onHide();
+            }
+          }
+        });
+
+        if (removedCount > 0) {
+          dispatch({
+            type: 'HIDE',
+            payload: { ids: idsArray },
+          });
+
+          heights.modify(<T extends Record<string, number>>(value: T): T => {
+            'worklet';
+            const result = { ...value };
+            for (const id of idsToRemove) {
+              delete result[id];
+            }
+            return result;
+          });
+
+          total.set((value) => value - removedCount);
+        }
+      }
+    },
+    [total, heights, toasts]
+  );
+
+  // Keep hide ref up to date
+  hideRef.current = hide;
+
+  /**
+   * Show a toast
+   * Supports three usage patterns:
+   * 1. Simple string: toast.show('This is toast')
+   * 2. Config object: toast.show({ label, variant, ... })
+   * 3. Custom component: toast.show({ component: (props) => <Toast>...</Toast> })
+   */
+  const show = useCallback(
+    (options: string | ToastShowOptions): string => {
+      let normalizedOptions: ToastShowOptionsWithComponent;
+      let duration: number | 'persistent' | undefined = DEFAULT_DURATION; // Default duration
+      let explicitId: string | undefined;
+
+      // Case 1: Simple string
+      if (typeof options === 'string') {
+        normalizedOptions = {
+          id: undefined,
+          component: createStringToastComponent(options, globalConfig),
+          duration: DEFAULT_DURATION,
+        };
+        duration = DEFAULT_DURATION;
+        explicitId = undefined;
+      }
+      // Case 2: Config object without component
+      else if (!('component' in options) || options.component === undefined) {
+        const config = options as ToastShowConfig;
+        duration = config.duration ?? DEFAULT_DURATION;
+        explicitId = config.id;
+        normalizedOptions = {
+          id: config.id,
+          component: createConfigToastComponent(config, globalConfig),
+          duration,
+          onShow: config.onShow,
+          onHide: config.onHide,
+        };
+      }
+      // Case 3: Config object with component (existing behavior)
+      else {
+        normalizedOptions = options as ToastShowOptionsWithComponent;
+        duration = normalizedOptions.duration ?? DEFAULT_DURATION;
+        explicitId = normalizedOptions.id;
+      }
+
+      const id =
+        normalizedOptions.id ?? `toast-${Date.now()}-${idCounter.current++}`;
+
+      // If an explicit ID was provided, check if a toast with that ID already exists
+      // If it exists, skip adding a new toast and return the existing ID
+      if (explicitId !== undefined) {
+        const existingToast = toasts.find(
+          (toast) => String(toast.id) === String(explicitId)
+        );
+        if (existingToast) {
+          return existingToast.id;
+        }
+      }
+
+      dispatch({
+        type: 'SHOW',
+        payload: {
+          id,
+          component: normalizedOptions.component,
+          duration,
+          onShow: normalizedOptions.onShow,
+          onHide: normalizedOptions.onHide,
+        },
+      });
+
+      total.set((value) => value + 1);
+
+      if (normalizedOptions.onShow) {
+        normalizedOptions.onShow();
+      }
+
+      // Set up auto-dismiss timeout synchronously
+      if (
+        duration !== 'persistent' &&
+        typeof duration === 'number' &&
+        !isNaN(duration) &&
+        duration > 0 &&
+        duration !== Infinity
+      ) {
+        // Handle immediate dismissal
+        if (duration === 0) {
+          if (hideRef.current) {
+            hideRef.current(id);
+          }
+        } else {
+          const timeout = setTimeout(() => {
+            if (hideRef.current) {
+              hideRef.current(id);
+            }
+            timeoutRefs.current.delete(id);
+          }, duration);
+          timeoutRefs.current.set(id, timeout);
+        }
+      }
+
+      return id;
+    },
+    [total, toasts, globalConfig]
+  );
+
+  const contextValue = useMemo<ToasterContextValue>(
+    () => ({
+      toast: {
+        show,
+        hide,
+      },
+      isToastVisible,
+    }),
+    [show, hide, isToastVisible]
+  );
+
+  return (
+    <ToastConfigContext.Provider value={globalConfig}>
+      <ToasterContext.Provider value={contextValue}>
+        {children}
+        {toasts.length > 0 && (
+          <InsetsContainer
+            insets={insets}
+            contentWrapper={contentWrapper}
+            disableFullWindowOverlay={disableFullWindowOverlay}
+          >
+            <View className="flex-1">
+              {toasts.map((toastItem, index) => (
+                <ToastItemRenderer
+                  key={toastItem.id}
+                  toastItem={toastItem}
+                  show={show}
+                  hide={hide}
+                  index={index}
+                  total={total}
+                  heights={heights}
+                  maxVisibleToasts={maxVisibleToasts}
+                />
+              ))}
+            </View>
+          </InsetsContainer>
+        )}
+      </ToasterContext.Provider>
+    </ToastConfigContext.Provider>
+  );
+}
+
+/**
+ * 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 function useToast() {
+  const context = useContext(ToasterContext);
+
+  if (!context) {
+    throw new Error('useToast must be used within a ToastProvider provider');
+  }
+
+  return {
+    toast: context.toast,
+    isToastVisible: context.isToastVisible,
+  };
+}

package/lib/__templates__/expo/client/heroui/providers/toast/reducer.ts

@@ -0,0 +1,34 @@
+import type { ToastAction, ToastItem } from './types';
+
+/**
+ * Reducer for managing toast state
+ */
+export function toastReducer(
+  state: ToastItem[],
+  action: ToastAction
+): ToastItem[] {
+  switch (action.type) {
+    case 'SHOW': {
+      // Remove existing toast with same ID if it exists
+      const filtered = state.filter((toast) => toast.id !== action.payload.id);
+      // Add new toast
+      return [...filtered, action.payload];
+    }
+
+    case 'HIDE': {
+      // Hide specific toasts by ID
+      // Use loose equality to handle string/number ID comparisons
+      return state.filter(
+        (toast) =>
+          !action.payload.ids.some((id) => String(id) === String(toast.id))
+      );
+    }
+
+    case 'HIDE_ALL':
+      // Hide all toasts
+      return [];
+
+    default:
+      return state;
+  }
+}

package/lib/__templates__/expo/client/heroui/providers/toast/toast-config.context.ts

@@ -0,0 +1,27 @@
+import { createContext, useContext } from 'react';
+import type { ToastGlobalConfig } from './types';
+
+/**
+ * Context for global toast configuration
+ * Extracted to separate file to avoid circular dependencies with toast component
+ */
+const ToastConfigContext = createContext<ToastGlobalConfig | undefined>(
+  undefined
+);
+
+/**
+ * Hook to access global toast configuration
+ *
+ * @returns Global toast configuration or undefined if not set
+ *
+ * @example
+ * ```tsx
+ * const globalConfig = useToastConfig();
+ * // Use globalConfig.variant, globalConfig.placement, etc.
+ * ```
+ */
+export function useToastConfig(): ToastGlobalConfig | undefined {
+  return useContext(ToastConfigContext);
+}
+
+export { ToastConfigContext };

package/lib/__templates__/expo/client/heroui/providers/toast/toast-item-renderer.tsx

@@ -0,0 +1,45 @@
+import { memo } from 'react';
+import type { ToastItemRendererProps } from './types';
+
+/**
+ * Memoized toast item component to prevent unnecessary re-renders
+ * Only re-renders when the toast item itself changes
+ */
+export const ToastItemRenderer = memo(
+  ({
+    toastItem,
+    show,
+    hide,
+    index,
+    total,
+    heights,
+    maxVisibleToasts,
+  }: ToastItemRendererProps) => {
+    if (typeof toastItem.component !== 'function') {
+      throw new Error(
+        'Toast component must be a function that receives ToastComponentProps'
+      );
+    }
+
+    const content = toastItem.component({
+      id: toastItem.id,
+      index,
+      total,
+      heights,
+      maxVisibleToasts,
+      show,
+      hide,
+    });
+
+    return content;
+  },
+  (prevProps, nextProps) => {
+    // Only re-render if the toast ID, component reference, or index changed
+    // show, hide, total, and heights are stable references, so we don't need to compare them
+    return (
+      prevProps.toastItem.id === nextProps.toastItem.id &&
+      prevProps.toastItem.component === nextProps.toastItem.component &&
+      prevProps.index === nextProps.index
+    );
+  }
+);