@coze-arch/cli 0.0.1-alpha.3002ee → 0.0.1-alpha.3260db

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

@@ -0,0 +1,373 @@
+import type { SharedValue } from 'react-native-reanimated';
+import type { ToastRootProps } from '../../components/toast/toast.types';
+
+/**
+ * Global toast configuration
+ * These values are used as defaults for all toasts unless overridden locally
+ */
+export interface ToastGlobalConfig
+  extends Pick<
+    ToastRootProps,
+    'variant' | 'placement' | 'isSwipeable' | 'animation'
+  > {}
+
+/**
+ * Insets for spacing from screen edges
+ */
+export interface ToastInsets {
+  /**
+   * Inset from the top edge in pixels (added to safe area inset)
+   * @default Platform-specific: iOS = 0, Android = 12
+   */
+  top?: number;
+  /**
+   * Inset from the bottom edge in pixels (added to safe area inset)
+   * @default Platform-specific: iOS = 6, Android = 12
+   */
+  bottom?: number;
+  /**
+   * Inset from the left edge in pixels (added to safe area inset)
+   * @default 12
+   */
+  left?: number;
+  /**
+   * Inset from the right edge in pixels (added to safe area inset)
+   * @default 12
+   */
+  right?: number;
+}
+
+/**
+ * Props for the ToastProvider component
+ */
+export interface ToastProviderProps {
+  /**
+   * When true, uses a regular View instead of FullWindowOverlay on iOS for toasts.
+   * Enables React Native element inspector but toasts won't appear above native modals.
+   * @default false
+   */
+  disableFullWindowOverlay?: boolean;
+  /**
+   * Global toast configuration
+   * These values are used as defaults for all toasts unless overridden locally
+   * Local configs have precedence over global config
+   */
+  defaultProps?: ToastGlobalConfig;
+  /**
+   * Insets for spacing from screen edges (added to safe area insets)
+   * @default Platform-specific:
+   *   - iOS: { top: 0, bottom: 6, left: 12, right: 12 }
+   *   - Android: { top: 12, bottom: 12, left: 12, right: 12 }
+   */
+  insets?: ToastInsets;
+  /**
+   * Maximum number of visible toasts before opacity starts fading
+   * Controls when toast items begin to fade out as they move beyond the visible stack
+   * @default 3
+   */
+  maxVisibleToasts?: number;
+  /**
+   * 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
+   *
+   * @example
+   * ```tsx
+   * <ToastProvider
+   *   contentWrapper={(children) => (
+   *     <KeyboardAvoidingView
+   *       behavior="padding"
+   *       keyboardVerticalOffset={24}
+   *       className="flex-1"
+   *     >
+   *       {children}
+   *     </KeyboardAvoidingView>
+   *   )}
+   * >
+   * ```
+   */
+  contentWrapper?: (children: React.ReactNode) => React.ReactElement;
+  /**
+   * Children to render
+   */
+  children?: React.ReactNode;
+}
+
+/**
+ * Props passed to the toast component function
+ */
+export interface ToastComponentProps {
+  /**
+   * The unique ID of the toast
+   */
+  id: string;
+  /**
+   * The index of the toast in the array (0-based)
+   */
+  index: number;
+  /**
+   * The total number of toasts currently displayed
+   */
+  total: SharedValue<number>;
+  /**
+   * Heights of all toast items, keyed by toast ID
+   */
+  heights: SharedValue<Record<string, number>>;
+  /**
+   * Maximum number of visible toasts before opacity starts fading
+   * Controls when toast items begin to fade out as they move beyond the visible stack
+   * @default 3
+   */
+  maxVisibleToasts?: number;
+  /**
+   * Show a new toast
+   */
+  show: (options: string | ToastShowOptions) => string;
+  /**
+   * 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
+   */
+  hide: (ids?: string | string[] | 'all') => void;
+}
+
+/**
+ * Configuration for showing a default styled toast (usage pattern 2)
+ * Used when component is not provided
+ */
+export interface ToastShowConfig
+  extends Pick<
+    ToastRootProps,
+    'variant' | 'placement' | 'isSwipeable' | 'animation'
+  > {
+  /**
+   * Duration in milliseconds before the toast automatically disappears
+   * Set to `'persistent'` to prevent auto-hide (toast will remain until manually dismissed)
+   * @default 4000
+   */
+  duration?: number | 'persistent';
+  /**
+   * Optional ID for the toast
+   * If not provided, one will be generated automatically
+   */
+  id?: string;
+  /**
+   * 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;
+  /**
+   * Icon element to display in the toast
+   */
+  icon?: React.ReactNode;
+  /**
+   * Callback function called when the toast is shown
+   */
+  onShow?: () => void;
+  /**
+   * Callback function called when the toast is hidden
+   */
+  onHide?: () => void;
+}
+
+/**
+ * Options for showing a toast with custom component (usage pattern 3)
+ * Used when component is provided
+ */
+export interface ToastShowOptionsWithComponent {
+  /**
+   * Optional ID for the toast
+   * If not provided, one will be generated automatically
+   */
+  id?: string;
+  /**
+   * A function that receives toast props and returns a React element
+   */
+  component: (props: ToastComponentProps) => React.ReactElement;
+  /**
+   * Duration in milliseconds before the toast automatically disappears
+   * Set to `'persistent'` to prevent auto-hide (toast will remain until manually dismissed)
+   * @default 4000
+   */
+  duration?: number | 'persistent';
+  /**
+   * Callback function called when the toast is shown
+   */
+  onShow?: () => void;
+  /**
+   * Callback function called when the toast is hidden
+   */
+  onHide?: () => void;
+}
+
+/**
+ * Conditional type for toast show options
+ * - If component is provided: only id, component, onShow, onHide are allowed
+ * - If component is NOT provided: all config props are available
+ */
+export type ToastShowOptions =
+  | ToastShowOptionsWithComponent
+  | (ToastShowConfig & { component?: never });
+
+/**
+ * Represents a single toast item in the state
+ */
+export interface ToastItem {
+  /**
+   * Unique identifier for the toast
+   */
+  id: string;
+  /**
+   * A function that receives toast props and returns a React element
+   */
+  component: (props: ToastComponentProps) => React.ReactElement;
+  /**
+   * Duration in milliseconds before the toast automatically disappears
+   * Set to `'persistent'` to prevent auto-hide (toast will remain until manually dismissed)
+   * @default 4000
+   */
+  duration?: number | 'persistent';
+  /**
+   * Callback function called when the toast is shown
+   */
+  onShow?: () => void;
+  /**
+   * Callback function called when the toast is hidden
+   */
+  onHide?: () => void;
+}
+
+/**
+ * Actions for the toast reducer
+ */
+export type ToastAction =
+  | { type: 'SHOW'; payload: ToastItem }
+  | { type: 'HIDE'; payload: { ids: string[] } }
+  | { type: 'HIDE_ALL' };
+
+/**
+ * Toast manager API
+ */
+export interface ToastManager {
+  /**
+   * Show a toast
+   * @param options - Toast configuration options or simple string
+   * @returns The ID of the shown toast
+   *
+   * @example
+   * ```tsx
+   * const toast = useToast();
+   *
+   * // Simple string (usage pattern 1)
+   * toast.show('This is toast');
+   *
+   * // Config object with default styling (usage pattern 2)
+   * toast.show({
+   *   label: 'Success!',
+   *   description: 'Your action was completed',
+   *   variant: 'success',
+   *   actionLabel: 'Undo',
+   *   onActionPress: ({ show, hide }) => hide(),
+   * });
+   *
+   * // Custom component (usage pattern 3)
+   * toast.show({
+   *   component: (props) => <Toast>Hello</Toast>,
+   * });
+   *
+   * // With custom ID
+   * toast.show({ id: 'my-toast', component: (props) => <Toast>Hello</Toast> });
+   * ```
+   */
+  show: (options: string | ToastShowOptions) => string;
+
+  /**
+   * Hide one or more toasts
+   *
+   * @param ids - Optional ID(s) of toast(s) to hide
+   * - No argument: hides the last toast in the array
+   * - "all": hides all toasts
+   * - Single ID: hides that toast
+   * - Array of IDs: hides those toasts
+   *
+   * @example
+   * ```tsx
+   * const toast = useToast();
+   *
+   * toast.hide();                    // Hide the last toast
+   * toast.hide('all');               // Hide all toasts
+   * toast.hide('my-toast');          // Hide specific toast
+   * toast.hide(['toast-1', 'toast-2']); // Hide multiple toasts
+   * ```
+   */
+  hide: (ids?: string | string[] | 'all') => void;
+}
+
+/**
+ * Props for the ToastItemRenderer component
+ */
+export interface ToastItemRendererProps {
+  /**
+   * The toast item to render
+   */
+  toastItem: ToastItem;
+  /**
+   * The index of the toast in the array (0-based)
+   */
+  index: number;
+  /**
+   * The total number of toasts currently displayed
+   */
+  total: SharedValue<number>;
+  /**
+   * Heights of all toast items, keyed by toast ID
+   */
+  heights: SharedValue<Record<string, number>>;
+  /**
+   * Maximum number of visible toasts before opacity starts fading
+   * Controls when toast items begin to fade out as they move beyond the visible stack
+   * @default 3
+   */
+  maxVisibleToasts?: number;
+  /**
+   * Show a new toast
+   */
+  show: (options: string | ToastShowOptions) => string;
+  /**
+   * 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
+   */
+  hide: (ids?: string | string[] | 'all') => void;
+}
+
+/**
+ * Context value for the toast provider
+ */
+export interface ToasterContextValue {
+  toast: ToastManager;
+  /**
+   * Whether any toast is currently visible
+   */
+  isToastVisible: boolean;
+}

package/lib/__templates__/expo/client/heroui/styles/index.css

@@ -0,0 +1,3 @@
+@import './variables.css';
+@import './utilities.css';
+@import './theme.css';

package/lib/__templates__/expo/client/heroui/styles/theme.css

@@ -0,0 +1,112 @@
+@theme inline static {
+  --color-background: var(--background);
+  --color-foreground: var(--foreground);
+
+  --color-surface: var(--surface);
+  --color-surface-foreground: var(--surface-foreground);
+  --color-surface-hover: color-mix(in oklab, var(--surface) 92%, var(--surface-foreground) 8%);
+
+  --color-surface-secondary: var(--surface-secondary);
+  --color-surface-secondary-foreground: var(--surface-secondary-foreground);
+
+  --color-surface-tertiary: var(--surface-tertiary);
+  --color-surface-tertiary-foreground: var(--surface-tertiary-foreground);
+
+  --color-overlay: var(--overlay);
+  --color-overlay-foreground: var(--overlay-foreground);
+
+  --color-muted: var(--muted);
+
+  --color-accent: var(--accent);
+  --color-accent-foreground: var(--accent-foreground);
+
+  --color-segment: var(--segment);
+  --color-segment-foreground: var(--segment-foreground);
+
+  --color-border: var(--border);
+  --color-separator: var(--separator);
+  --color-focus: var(--focus);
+  --color-link: var(--link);
+
+  --color-default: var(--default);
+  --color-default-foreground: var(--default-foreground);
+
+  --color-success: var(--success);
+  --color-success-foreground: var(--success-foreground);
+
+  --color-warning: var(--warning);
+  --color-warning-foreground: var(--warning-foreground);
+
+  --color-danger: var(--danger);
+  --color-danger-foreground: var(--danger-foreground);
+
+  /* Form Field Tokens */
+  --color-field: var(--field-background, var(--default));
+  --color-field-foreground: var(--field-foreground, var(--foreground));
+  --color-field-placeholder: var(--field-placeholder, var(--muted));
+  --color-field-border: var(--field-border, var(--border));
+  --radius-field: var(--field-radius, var(--radius-xl));
+  --border-width-field: var(--field-border-width, var(--border-width));
+
+  --shadow-surface: var(--surface-shadow);
+  --shadow-overlay: var(--overlay-shadow);
+  --shadow-field: var(--field-shadow);
+
+  /* Calculated Variables */
+
+  /* Colors */
+
+  /* --- background shades --- */
+  --color-background-secondary: color-mix(in oklab, var(--background) 96%, var(--foreground) 4%);
+  --color-background-tertiary: color-mix(in oklab, var(--background) 92%, var(--foreground) 8%);
+  --color-background-inverse: var(--foreground);
+
+  /* ------------------------- */
+  --color-default-hover: color-mix(in oklab, var(--default) 96%, var(--default-foreground) 4%);
+  --color-accent-hover: color-mix(in oklab, var(--accent) 90%, var(--accent-foreground) 10%);
+  --color-success-hover: color-mix(in oklab, var(--success) 90%, var(--success-foreground) 10%);
+  --color-warning-hover: color-mix(in oklab, var(--warning) 90%, var(--warning-foreground) 10%);
+  --color-danger-hover: color-mix(in oklab, var(--danger) 90%, var(--danger-foreground) 10%);
+
+  /* Form Field Colors */ 
+  --color-field-hover: color-mix(in oklab, var(--field-background, var(--default)) 90%, var(--field-foreground, var(--foreground)) 2%);
+  --color-field-focus: var(--field-background, var(--default));
+  --color-field-border-hover: color-mix(in oklab, var(--field-border, var(--border)) 88%, var(--field-foreground, var(--foreground)) 10%);
+  --color-field-border-focus: color-mix(in oklab, var(--field-border, var(--border)) 74%, var(--field-foreground, var(--foreground)) 22%);
+
+  /* Soft Colors */
+  --color-accent-soft: color-mix(in oklab, var(--accent) 15%, transparent);
+  --color-accent-soft-foreground: var(--accent);
+  --color-accent-soft-hover: color-mix(in oklab, var(--accent) 20%, transparent);
+
+  --color-danger-soft: color-mix(in oklab, var(--danger) 15%, transparent);
+  --color-danger-soft-foreground: var(--danger);
+  --color-danger-soft-hover: color-mix(in oklab, var(--danger) 20%, transparent);
+
+  --color-warning-soft: color-mix(in oklab, var(--warning) 15%, transparent);
+  --color-warning-soft-foreground: var(--warning);
+  --color-warning-soft-hover: color-mix(in oklab, var(--warning) 20%, transparent);
+
+  --color-success-soft: color-mix(in oklab, var(--success) 15%, transparent);
+  --color-success-soft-foreground: var(--success);
+  --color-success-soft-hover: color-mix(in oklab, var(--success) 20%, transparent);
+
+  /* Separator Colors - Levels */
+  --color-separator-secondary: color-mix(in oklab, var(--surface) 85%, var(--surface-foreground) 15%);
+  --color-separator-tertiary: color-mix(in oklab, var(--surface) 81%, var(--surface-foreground) 19%);
+
+  /* Border Colors - Levels (progressive contrast: default → secondary → tertiary) */
+  /* Light mode: lighter → darker | Dark mode: darker → lighter */
+  --color-border-secondary: color-mix(in oklab, var(--surface) 78%, var(--surface-foreground) 22%);
+  --color-border-tertiary: color-mix(in oklab, var(--surface) 66%, var(--surface-foreground) 34%);
+
+  /* Radius and default sizes - defaults can change by just changing the --radius */
+  --radius-xs: calc(var(--radius) * 0.25); /* 0.125rem (2px) */
+  --radius-sm: calc(var(--radius) * 0.5); /* 0.25rem (4px) */
+  --radius-md: calc(var(--radius) * 0.75); /* 0.375rem (6px) */
+  --radius-lg: calc(var(--radius) * 1); /* 0.5rem (8px) */
+  --radius-xl: calc(var(--radius) * 1.5); /* 0.75rem (12px) */
+  --radius-2xl: calc(var(--radius) * 2); /* 1rem (16px) */
+  --radius-3xl: calc(var(--radius) * 3); /* 1.5rem (24px) */
+  --radius-4xl: calc(var(--radius) * 4); /* 2rem (32px) */
+}

package/lib/__templates__/expo/client/heroui/styles/utilities.css

@@ -0,0 +1,8 @@
+@layer utilities {
+  .h-hairline {
+    height: hairlineWidth();
+  }
+  .w-hairline {
+    width: hairlineWidth();
+  }
+}

package/lib/__templates__/expo/client/heroui/styles/variables.css

@@ -0,0 +1,146 @@
+@theme {
+  /* Primitive Colors (Do not change between light and dark) */
+  --white: oklch(100% 0 0);
+  --black: oklch(0% 0 0);
+  --snow: oklch(0.9911 0 0);
+  --eclipse: oklch(0.2103 0.0059 285.89);
+
+  /* Border */
+  --border-width: 1px;
+  --field-border-width: 0px;
+
+  /* Base radius */
+  --radius: 0.5rem;
+  --field-radius: calc(var(--radius) * 1.5);
+
+  /* Opacity */
+  --opacity-disabled: 0.5;
+}
+
+@layer theme {
+  :root {
+    @variant light {
+      /* Base Colors */
+      --background: oklch(0.9702 0 0);
+      --foreground: var(--eclipse);
+
+      /* Surface: Used for non-overlay components (cards, accordions, disclosure groups) */
+      --surface: var(--white);
+      --surface-foreground: var(--foreground);
+
+      --surface-secondary: oklch(0.9524 0.0013 286.37);
+      --surface-secondary-foreground: var(--foreground);
+
+      --surface-tertiary: oklch(0.9373 0.0013 286.37);
+      --surface-tertiary-foreground: var(--foreground);
+
+      /* Overlay: Used for floating/overlay components (dialogs, popovers, modals, menus) */
+      --overlay: var(--white);
+      --overlay-foreground: var(--foreground);
+
+      --muted: oklch(0.5517 0.0138 285.94);
+
+      --default: oklch(94% 0.001 286.375);
+      --default-foreground: var(--eclipse);
+
+      --accent: oklch(0.6204 0.195 253.83);
+      --accent-foreground: var(--snow);
+
+      /* Form Fields */
+      --field-background: var(--white);
+      --field-foreground: oklch(0.2103 0.0059 285.89);
+      --field-placeholder: var(--muted);
+      --field-border: transparent; /* no border by default on form fields */
+
+      /* Status Colors */
+      --success: oklch(0.7329 0.1935 150.81);
+      --success-foreground: var(--eclipse);
+
+      --warning: oklch(0.7819 0.1585 72.33);
+      --warning-foreground: var(--eclipse);
+
+      --danger: oklch(0.6532 0.2328 25.74);
+      --danger-foreground: var(--snow);
+
+      /* Component Colors */
+      --segment: var(--white);
+      --segment-foreground: var(--eclipse);
+
+      /* Misc Colors */
+      --border: oklch(90% 0.004 286.32);
+      --separator: oklch(74% 0.004 286.32);
+      --focus: var(--accent);
+      --link: var(--foreground);
+
+      /* Shadows */
+      --surface-shadow:
+        0 2px 4px 0 rgba(0, 0, 0, 0.04), 0 1px 2px 0 rgba(0, 0, 0, 0.06),
+        0 0 1px 0 rgba(0, 0, 0, 0.06);
+      --overlay-shadow:
+        0 2px 8px 0 rgba(0, 0, 0, 0.02), 0 -6px 12px 0 rgba(0, 0, 0, 0.01),
+        0 14px 28px 0 rgba(0, 0, 0, 0.03);
+      --field-shadow:
+        0 2px 4px 0 rgba(0, 0, 0, 0.04), 0 1px 2px 0 rgba(0, 0, 0, 0.06),
+        0 0 1px 0 rgba(0, 0, 0, 0.06);
+    }
+
+    @variant dark {
+      /* Base Colors */
+      --background: oklch(12% 0.005 285.823);
+      --foreground: var(--snow);
+
+      /* Surface: Used for non-overlay components (cards, accordions, disclosure groups) */
+      --surface: oklch(0.2103 0.0059 285.89);
+      --surface-foreground: var(--foreground);
+
+      --surface-secondary: oklch(0.257 0.0037 286.14);
+      --surface-secondary-foreground: var(--foreground);
+
+      --surface-tertiary: oklch(0.2721 0.0024 247.91);
+      --surface-tertiary-foreground: var(--foreground);
+
+      /* Overlay: Used for floating/overlay components (dialogs, popovers, modals, menus) - lighter for contrast */
+      --overlay: oklch(0.2103 0.0059 285.89);
+      --overlay-foreground: var(--foreground);
+
+      --muted: oklch(70.5% 0.015 286.067);
+
+      --default: oklch(27.4% 0.006 286.033);
+      --default-foreground: var(--snow);
+
+      --accent: oklch(0.6204 0.195 253.83);
+      --accent-foreground: var(--snow);
+
+      /* Form Field Defaults - Colors (only the ones that are different from light theme) */
+      --field-background: oklch(0.2103 0.0059 285.89);
+      --field-foreground: var(--foreground);
+      --field-placeholder: var(--muted);
+      --field-border: transparent; /* no border by default on form fields */
+
+      /* Status Colors */
+      --success: oklch(0.7329 0.1935 150.81);
+      --success-foreground: var(--eclipse);
+
+      --warning: oklch(0.8203 0.1388 76.34);
+      --warning-foreground: var(--eclipse);
+
+      --danger: oklch(0.594 0.1967 24.63);
+      --danger-foreground: var(--snow);
+
+      /* Component Colors */
+      --segment: oklch(0.3964 0.01 285.93);
+      --segment-foreground: var(--foreground);
+
+      /* Misc Colors */
+      --border: oklch(28% 0.006 286.033);
+      --separator: oklch(40% 0.006 286.033);
+      --focus: var(--accent);
+      --link: var(--foreground);
+
+      /* Shadows */
+      --surface-shadow: 0 0 0 0 transparent inset; /* No shadow on dark mode */
+      --overlay-shadow: 0 0 1px 0 rgba(255, 255, 255, 0.2) inset;
+      --field-shadow: 0 0 0 0 transparent inset; /* Transparent shadow to allow ring utilities to work */
+    }
+  }
+}