@coze-arch/cli 0.0.1-alpha.01c0ee

package/lib/__templates__/expo/client/app/+not-found.tsx

@@ -0,0 +1,30 @@
+import { View, Text, StyleSheet } from 'react-native';
+import { Link } from 'expo-router';
+import { useTheme } from '@/hooks/useTheme';
+import { Spacing } from '@/constants/theme';
+
+export default function NotFoundScreen() {
+  const { theme } = useTheme();
+
+  return (
+    <View style={[styles.container, { backgroundColor: theme.backgroundRoot }]}>
+      <Text>
+        页面不存在
+      </Text>
+      <Link href="/" style={[styles.gohome]}>
+        返回首页
+      </Link>
+    </View>
+  );
+}
+
+const styles = StyleSheet.create({
+  container: {
+    flex: 1,
+    justifyContent: 'center',
+    alignItems: 'center',
+  },
+  gohome: {
+    marginTop: Spacing['2xl'],
+  },
+});

package/lib/__templates__/expo/client/app/_layout.tsx

@@ -0,0 +1,36 @@
+import { useEffect } from 'react';
+import { GestureHandlerRootView } from 'react-native-gesture-handler';
+import { Stack } from 'expo-router';
+import { StatusBar } from 'expo-status-bar';
+import { LogBox } from 'react-native';
+import Toast from 'react-native-toast-message';
+import { AuthProvider } from "@/contexts/AuthContext";
+import { ColorSchemeProvider } from '@/hooks/useColorScheme';
+
+LogBox.ignoreLogs([
+  "TurboModuleRegistry.getEnforcing(...): 'RNMapsAirModule' could not be found",
+  // 添加其它想暂时忽略的错误或警告信息
+]);
+
+export default function RootLayout() {
+  return (
+    <AuthProvider>
+      <ColorSchemeProvider>
+        <GestureHandlerRootView style={{ flex: 1 }}>
+          <StatusBar style="dark"></StatusBar>
+          <Stack screenOptions={{
+            // 设置所有页面的切换动画为从右侧滑入，适用于iOS 和 Android
+            animation: 'slide_from_right',
+            gestureEnabled: true,
+            gestureDirection: 'horizontal',
+            // 隐藏自带的头部
+            headerShown: false
+          }}>
+            <Stack.Screen name="index" options={{ title: "" }} />
+          </Stack>
+          <Toast />
+        </GestureHandlerRootView>
+      </ColorSchemeProvider>
+    </AuthProvider>
+  );
+}

package/lib/__templates__/expo/client/app/index.tsx

@@ -0,0 +1 @@
+export { default } from '@/screens/demo';

package/lib/__templates__/expo/client/app.config.ts

@@ -0,0 +1,76 @@
+import { ExpoConfig, ConfigContext } from 'expo/config';
+
+const appName = process.env.COZE_PROJECT_NAME || process.env.EXPO_PUBLIC_COZE_PROJECT_NAME || '应用';
+const projectId = process.env.COZE_PROJECT_ID || process.env.EXPO_PUBLIC_COZE_PROJECT_ID;
+const slugAppName = projectId ? `app${projectId}` : 'myapp';
+
+export default ({ config }: ConfigContext): ExpoConfig => {
+  return {
+    ...config,
+    "name": appName,
+    "slug": slugAppName,
+    "version": "1.0.0",
+    "orientation": "portrait",
+    "icon": "./assets/images/icon.png",
+    "scheme": "myapp",
+    "userInterfaceStyle": "automatic",
+    "newArchEnabled": true,
+    "ios": {
+      "supportsTablet": true
+    },
+    "android": {
+      "adaptiveIcon": {
+        "foregroundImage": "./assets/images/adaptive-icon.png",
+        "backgroundColor": "#ffffff"
+      },
+      "package": `com.anonymous.x${projectId || '0'}`
+    },
+    "web": {
+      "bundler": "metro",
+      "output": "single",
+      "favicon": "./assets/images/favicon.png"
+    },
+    "plugins": [
+      process.env.EXPO_PUBLIC_BACKEND_BASE_URL ? [
+        "expo-router",
+        {
+          "origin": process.env.EXPO_PUBLIC_BACKEND_BASE_URL
+        }
+      ] : 'expo-router',
+      [
+        "expo-splash-screen",
+        {
+          "image": "./assets/images/splash-icon.png",
+          "imageWidth": 200,
+          "resizeMode": "contain",
+          "backgroundColor": "#ffffff"
+        }
+      ],
+      [
+        "expo-image-picker",
+        {
+          "photosPermission": `允许${appName}访问您的相册，以便您上传或保存图片。`,
+          "cameraPermission": `允许${appName}使用您的相机，以便您直接拍摄照片上传。`,
+          "microphonePermission": `允许${appName}访问您的麦克风，以便您拍摄带有声音的视频。`
+        }
+      ],
+      [
+        "expo-location",
+        {
+          "locationWhenInUsePermission": `${appName}需要访问您的位置以提供周边服务及导航功能。`
+        }
+      ],
+      [
+        "expo-camera",
+        {
+          "cameraPermission": `${appName}需要访问相机以拍摄照片和视频。`,
+          "microphonePermission": `${appName}需要访问麦克风以录制视频声音。`,
+          "recordAudioAndroid": true
+        }
+      ]
+    ],
+    "experiments": {
+      "typedRoutes": true
+    }
+  }
+}

package/lib/__templates__/expo/client/components/Screen.tsx

@@ -0,0 +1,314 @@
+import React, { useEffect } from 'react';
+import {
+  Platform,
+  StyleSheet,
+  ScrollView,
+  View,
+  TouchableWithoutFeedback,
+  Keyboard,
+  ViewStyle,
+  FlatList,
+  SectionList,
+  Modal,
+} from 'react-native';
+import { useSafeAreaInsets, Edge } from 'react-native-safe-area-context';
+import { StatusBar } from 'expo-status-bar';
+// 引入 KeyboardAware 系列组件
+import {
+  KeyboardAwareScrollView,
+  KeyboardAwareFlatList,
+  KeyboardAwareSectionList
+} from 'react-native-keyboard-aware-scroll-view';
+
+/**
+ * # Screen 组件使用指南
+ *
+ * 核心原则：统一使用手动安全区管理 (padding)，支持沉浸式布局，解决 iOS/Android 状态栏一致性问题。
+ *
+ * ## 1. 普通页面 (默认)
+ * - 场景：标准的白底或纯色背景页面，Header 在安全区下方。
+ * - 用法：`<Screen>{children}</Screen>`
+ * - 行为：自动处理上下左右安全区，状态栏文字黑色。
+ *
+ * ## 2. 沉浸式 Header (推荐)
+ * - 场景：Header 背景色/图片需要延伸到状态栏 (如首页、个人中心)。
+ * - 用法：`<Screen safeAreaEdges={['left', 'right', 'bottom']}>` (去掉 'top')
+ * - 配合：页面内部 Header 组件必须手动添加 paddingTop:
+ *   ```tsx
+ *   const insets = useSafeAreaInsets();
+ *   <View style={{ paddingTop: insets.top + 12, backgroundColor: '...' }}>
+ *   ```
+ *
+ * ## 3. 底部有 TabBar 或 悬浮按钮
+ * - 场景：页面底部有固定导航栏，或者需要精细控制底部留白。
+ * - 用法：`<Screen safeAreaEdges={['top', 'left', 'right']}>` (去掉 'bottom')
+ * - 配合：
+ *   - 若是滚动页：`<ScrollView contentContainerStyle={{ paddingBottom: insets.bottom + 80 }}>`
+ *   - 若是固定页：`<View style={{ paddingBottom: insets.bottom + 60 }}>`
+ *
+ * ## 4. 滚动列表/表单
+ * - 场景：长内容，需要键盘避让。
+ * - 用法：`<Screen>{children}</Screen>`
+ * - 行为：若子树不包含 ScrollView/FlatList/SectionList，则外层自动使用 ScrollView，
+ *        自动处理键盘遮挡，底部安全区会自动加在内容末尾。
+ */
+interface ScreenProps {
+  children: React.ReactNode;
+  /** 背景色，默认 #fff */
+  backgroundColor?: string;
+  /**
+   * 状态栏样式
+   * - 'dark': 黑色文字 (默认)
+   * - 'light': 白色文字 (深色背景时用)
+   */
+  statusBarStyle?: 'auto' | 'inverted' | 'light' | 'dark';
+  /**
+   * 状态栏背景色
+   * - 默认 'transparent' 以支持沉浸式
+   * - Android 下如果需要不透明，可传入具体颜色
+   */
+  statusBarColor?: string;
+  /**
+   * 安全区控制 (关键属性)
+   * - 默认: ['top', 'left', 'right', 'bottom'] (全避让)
+   * - 沉浸式 Header: 去掉 'top'
+   * - 自定义底部: 去掉 'bottom'
+   */
+  safeAreaEdges?: Edge[];
+  /** 自定义容器样式 */
+  style?: ViewStyle;
+}
+
+type KeyboardAwareProps = {
+  element: React.ReactElement<any, any>;
+  extraPadding: number;
+  contentInsetBehaviorIOS: 'automatic' | 'never';
+};
+
+const KeyboardAwareScrollable = ({
+  element,
+  extraPadding,
+  contentInsetBehaviorIOS,
+}: KeyboardAwareProps) => {
+  // 获取原始组件的 props
+  const childAttrs: any = (element as any).props || {};
+  const originStyle = childAttrs['contentContainerStyle'];
+  const styleArray = Array.isArray(originStyle) ? originStyle : originStyle ? [originStyle] : [];
+  const merged = Object.assign({}, ...styleArray);
+  const currentPB = typeof merged.paddingBottom === 'number' ? merged.paddingBottom : 0;
+
+  // 合并 paddingBottom (安全区 + 额外留白)
+  const enhancedContentStyle = [{ ...merged, paddingBottom: currentPB + extraPadding }];
+
+  // 基础配置 props，用于传递给 KeyboardAware 组件
+  const commonProps = {
+    ...childAttrs,
+    contentContainerStyle: enhancedContentStyle,
+    keyboardShouldPersistTaps: childAttrs['keyboardShouldPersistTaps'] ?? 'handled',
+    keyboardDismissMode: childAttrs['keyboardDismissMode'] ?? 'on-drag',
+    enableOnAndroid: true,
+    // 类似于原代码中的 setTimeout/scrollToEnd 逻辑，这里设置额外的滚动高度确保输入框可见
+    extraHeight: 100,
+    // 禁用自带的 ScrollView 自动 inset，由外部 padding 控制
+    enableAutomaticScroll: true,
+    ...(Platform.OS === 'ios'
+      ? { contentInsetAdjustmentBehavior: childAttrs['contentInsetAdjustmentBehavior'] ?? contentInsetBehaviorIOS }
+      : {}),
+  };
+
+  const t = (element as any).type;
+
+  // 根据组件类型返回对应的 KeyboardAware 版本
+  // 注意：不再使用 KeyboardAvoidingView，直接替换为增强版 ScrollView
+  if (t === ScrollView) {
+    return <KeyboardAwareScrollView {...commonProps} />;
+  }
+
+  if (t === FlatList) {
+    return <KeyboardAwareFlatList {...commonProps} />;
+  }
+
+  if (t === SectionList) {
+    return <KeyboardAwareSectionList {...commonProps} />;
+  }
+
+  // 理论上不应运行到这里，如果是非标准组件则原样返回，仅修改样式
+  return React.cloneElement(element, {
+    contentContainerStyle: enhancedContentStyle,
+    keyboardShouldPersistTaps: childAttrs['keyboardShouldPersistTaps'] ?? 'handled',
+    keyboardDismissMode: childAttrs['keyboardDismissMode'] ?? 'on-drag',
+  });
+};
+
+export const Screen = ({
+  children,
+  backgroundColor = '#fff',
+  statusBarStyle = 'dark',
+  statusBarColor = 'transparent',
+  safeAreaEdges = ['top', 'left', 'right', 'bottom'],
+  style,
+}: ScreenProps) => {
+  const insets = useSafeAreaInsets();
+  const [keyboardShown, setKeyboardShown] = React.useState(false);
+
+  useEffect(() => {
+    const showEvent = Platform.OS === 'ios' ? 'keyboardWillShow' : 'keyboardDidShow';
+    const hideEvent = Platform.OS === 'ios' ? 'keyboardWillHide' : 'keyboardDidHide';
+    const s1 = Keyboard.addListener(showEvent, () => setKeyboardShown(true));
+    const s2 = Keyboard.addListener(hideEvent, () => setKeyboardShown(false));
+    return () => { s1.remove(); s2.remove(); };
+  }, []);
+
+  // 自动检测：若子树中包含 ScrollView/FlatList/SectionList，则认为页面自身处理滚动
+  const isNodeScrollable = (node: React.ReactNode): boolean => {
+    const isScrollableElement = (el: unknown): boolean => {
+      if (!React.isValidElement(el)) return false;
+      const element = el as React.ReactElement<any, any>;
+      const t = element.type;
+      // 不递归检查 Modal 内容，避免将弹窗内的 ScrollView 误判为页面已具备垂直滚动
+      if (t === Modal) return false;
+      const props = element.props as Record<string, unknown> | undefined;
+      // 仅识别“垂直”滚动容器；横向滚动不视为页面已处理垂直滚动
+      // eslint-disable-next-line react/prop-types
+      const isHorizontal = !!(props && (props as any).horizontal === true);
+      if ((t === ScrollView || t === FlatList || t === SectionList) && !isHorizontal) return true;
+      const c: React.ReactNode | undefined = props && 'children' in props
+        ? (props.children as React.ReactNode)
+        : undefined;
+      if (Array.isArray(c)) return c.some(isScrollableElement);
+      return c ? isScrollableElement(c) : false;
+    };
+    if (Array.isArray(node)) return node.some(isScrollableElement);
+    return isScrollableElement(node);
+  };
+
+  const childIsNativeScrollable = isNodeScrollable(children);
+
+  // 说明：避免双重补白
+  // KeyboardAwareScrollView 内部会自动处理键盘高度。
+  // 我们主要关注非键盘状态下的 Safe Area 管理。
+
+  // 解析安全区设置
+  const hasTop = safeAreaEdges.includes('top');
+  const hasBottom = safeAreaEdges.includes('bottom');
+  const hasLeft = safeAreaEdges.includes('left');
+  const hasRight = safeAreaEdges.includes('right');
+
+  // 强制禁用 iOS 自动调整内容区域，完全由手动 padding 控制，消除系统自动计算带来的多余空白
+  const contentInsetBehaviorIOS = 'never';
+
+  const wrapperStyle: ViewStyle = {
+    flex: 1,
+    backgroundColor,
+    paddingTop: hasTop ? insets.top : 0,
+    paddingLeft: hasLeft ? insets.left : 0,
+    paddingRight: hasRight ? insets.right : 0,
+    // 当页面不使用外层 ScrollView 时（子树本身可滚动），由外层 View 负责底部安全区
+    paddingBottom: (childIsNativeScrollable && hasBottom)
+      ? (keyboardShown ? 0 : insets.bottom)
+      : 0,
+  };
+
+  // 若子树不可滚动，则外层使用 KeyboardAwareScrollView 提供“全局页面滑动”能力
+  const useScrollContainer = !childIsNativeScrollable;
+
+  // 2. 滚动容器配置
+  // 如果使用滚动容器，则使用 KeyboardAwareScrollView 替代原有的 ScrollView
+  const Container = useScrollContainer ? KeyboardAwareScrollView : View;
+
+  const containerProps = useScrollContainer ? {
+    contentContainerStyle: {
+      flexGrow: 1,
+      // 滚动模式下，Bottom 安全区由内容容器处理，保证内容能完整显示且不被 Home Indicator 遮挡，同时背景色能延伸到底部
+      paddingBottom: hasBottom ? (keyboardShown ? 0 : insets.bottom) : 0,
+    },
+    keyboardShouldPersistTaps: 'handled' as const,
+    showsVerticalScrollIndicator: false,
+    keyboardDismissMode: 'on-drag' as const,
+    enableOnAndroid: true,
+    extraHeight: 100, // 替代原代码手动计算的 offset
+    // iOS 顶部白条修复：强制不自动添加顶部安全区
+    ...(Platform.OS === 'ios'
+      ? { contentInsetAdjustmentBehavior: contentInsetBehaviorIOS }
+      : {}),
+  } : {};
+
+  // 3. 若子元素自身包含滚动容器，给该滚动容器单独添加键盘避让，不影响其余固定元素（如底部栏）
+  const wrapScrollableWithKeyboardAvoid = (nodes: React.ReactNode): React.ReactNode => {
+    const isVerticalScrollable = (el: React.ReactElement<any, any>): boolean => {
+      const t = el.type;
+      const elementProps = (el as any).props || {};
+      const isHorizontal = !!(elementProps as any).horizontal;
+      return (t === ScrollView || t === FlatList || t === SectionList) && !isHorizontal;
+    };
+
+    const wrapIfNeeded = (el: React.ReactElement<any, any>, idx?: number): React.ReactElement => {
+      if (isVerticalScrollable(el)) {
+        return (
+          <KeyboardAwareScrollable
+            key={el.key ?? idx}
+            element={el}
+            extraPadding={keyboardShown ? 0 : (hasBottom ? insets.bottom : 0)}
+            contentInsetBehaviorIOS={contentInsetBehaviorIOS}
+          />
+        );
+      }
+      return el;
+    };
+
+    if (Array.isArray(nodes)) {
+      return nodes.map((n, idx) => {
+        if (React.isValidElement(n)) {
+          return wrapIfNeeded(n as React.ReactElement<any, any>, idx);
+        }
+        return n;
+      });
+    }
+    if (React.isValidElement(nodes)) {
+      return wrapIfNeeded(nodes as React.ReactElement<any, any>, 0);
+    }
+    return nodes;
+  };
+
+  return (
+    // 核心原则：严禁使用 SafeAreaView，统一使用 View + padding 手动管理
+    <View style={wrapperStyle}>
+      {/* 状态栏配置：强制透明背景 + 沉浸式，以支持背景图延伸 */}
+      <StatusBar
+        style={statusBarStyle}
+        backgroundColor={statusBarColor}
+        translucent
+      />
+
+      {/* 键盘避让：仅当外层使用 ScrollView 时启用，避免固定底部栏随键盘上移 */}
+      {useScrollContainer ? (
+         // 替换为 KeyboardAwareScrollView，移除原先的 KeyboardAvoidingView 包裹
+         // 因为 KeyboardAwareScrollView 已经内置了处理逻辑
+        <Container style={[styles.innerContainer, style]} {...containerProps}>
+          {children}
+        </Container>
+      ) : (
+        // 页面自身已处理滚动，不启用全局键盘避让，保证固定底部栏不随键盘上移
+        childIsNativeScrollable ? (
+          <View style={[styles.innerContainer, style]}>
+            {wrapScrollableWithKeyboardAvoid(children)}
+          </View>
+        ) : (
+          <TouchableWithoutFeedback onPress={Keyboard.dismiss} disabled={Platform.OS === 'web'}>
+            <View style={[styles.innerContainer, style]}>
+              {children}
+            </View>
+          </TouchableWithoutFeedback>
+        )
+      )}
+    </View>
+  );
+};
+
+const styles = StyleSheet.create({
+  innerContainer: {
+    flex: 1,
+    // 确保内部容器透明，避免背景色遮挡
+    backgroundColor: 'transparent',
+  },
+});