@coze-arch/cli 0.0.1-alpha.1fb1dc → 0.0.1-alpha.224471

package/lib/__templates__/expo/client/declarations.d.ts

@@ -0,0 +1,5 @@
+// declarations.d.ts
+
+declare module 'expo-file-system/legacy' {
+  export * from 'expo-file-system';
+}

package/lib/__templates__/expo/{eslint.config.mjs → client/eslint.config.mjs}

@@ -1,10 +1,11 @@
-import js from "@eslint/js";
-import globals from "globals";
-import tseslint from "typescript-eslint";
-import pluginReact from "eslint-plugin-react";
-import reactHooks from "eslint-plugin-react-hooks";
-import regexp from "eslint-plugin-regexp";
-import pluginImport from "eslint-plugin-import";
+import js from '@eslint/js';
+import globals from 'globals';
+import tseslint from 'typescript-eslint';
+import pluginReact from 'eslint-plugin-react';
+import reactHooks from 'eslint-plugin-react-hooks';
+import regexp from 'eslint-plugin-regexp';
+import pluginImport from 'eslint-plugin-import';
+import fontawesome6 from '../eslint-plugins/fontawesome6/index.js';
 
 export default [
   {
@@ -20,14 +21,14 @@ export default [
   regexp.configs["flat/recommended"],
   js.configs.recommended,
   ...tseslint.configs.recommended,
-  
+
   // React 的推荐配置
   pluginReact.configs.flat.recommended,
   pluginReact.configs.flat['jsx-runtime'],
   reactHooks.configs.flat.recommended,
   {
     files: ["**/*.{js,mjs,cjs,ts,mts,cts,jsx,tsx}"],
-    
+
     // 语言选项：设置全局变量
     languageOptions: {
       globals: {
@@ -52,6 +53,7 @@ export default [
 
     plugins: {
       import: pluginImport,
+      fontawesome6,
     },
     rules: {
       // 关闭代码风格规则
@@ -70,6 +72,7 @@ export default [
       'no-prototype-builtins': 'off',
       'react/react-in-jsx-scope': 'off',
       'react/jsx-uses-react': 'off',
+      'fontawesome6/valid-name': 'error',
     },
   },
 
@@ -91,7 +94,7 @@ export default [
       // 在 .js 文件中关闭 TS 规则
       '@typescript-eslint/no-require-imports': 'off',
       // 在 Node.js 文件中允许 require
-      '@typescript-eslint/no-var-requires': 'off', 
+      '@typescript-eslint/no-var-requires': 'off',
       'no-undef': 'off',
     },
   },

package/lib/__templates__/expo/client/hooks/useColorScheme.ts

@@ -1 +1,34 @@
-export { useColorScheme } from "react-native";
+import { useEffect, useState } from 'react';
+import { ColorSchemeName, useColorScheme as useReactNativeColorScheme, Platform } from 'react-native';
+
+export function useColorScheme() {
+  const systemColorScheme = useReactNativeColorScheme();
+  const [colorScheme, setColorScheme] = useState<ColorSchemeName>(systemColorScheme);
+
+  useEffect(() => {
+    setColorScheme(systemColorScheme);
+  }, [systemColorScheme])
+
+  useEffect(() => {
+    function handleMessage(e: MessageEvent<{ event: string; colorScheme: ColorSchemeName; } | undefined>) {
+      if (e.data?.event === 'coze.workbench.colorScheme') {
+        const cs = e.data.colorScheme;
+        if (typeof cs === 'string') {
+          setColorScheme(cs);
+        }
+      }
+    }
+
+    if (Platform.OS === 'web') {
+      window.addEventListener('message', handleMessage, false);
+    }
+
+    return () => {
+      if (Platform.OS === 'web') {
+        window.removeEventListener('message', handleMessage, false);
+      }
+    }
+  }, []);
+
+  return colorScheme;
+}

package/lib/__templates__/expo/client/hooks/useTheme.ts

@@ -1,13 +1,33 @@
-import { Colors } from "@/constants/theme";
-import { useColorScheme } from "@/hooks/useColorScheme";
+import { Colors } from '@/constants/theme';
+import { useColorScheme } from '@/hooks/useColorScheme';
 
-export function useTheme() {
-  const colorScheme = useColorScheme();
-  const isDark = colorScheme === "dark";
-  const theme = Colors[colorScheme ?? "light"];
+enum COLOR_SCHEME_CHOICE {
+  FOLLOW_SYSTEM = 'follow-system', // 跟随系统自动变化
+  DARK = 'dark', // 固定为 dark 主题，不随系统变化
+  LIGHT = 'light', // 固定为 light 主题，不随系统变化
+};
+
+const userPreferColorScheme: COLOR_SCHEME_CHOICE = COLOR_SCHEME_CHOICE.FOLLOW_SYSTEM;
+
+function getTheme(colorScheme?: 'dark' | 'light' | null) {
+  const isDark = colorScheme === 'dark';
+  const theme = Colors[colorScheme ?? 'light'];
 
   return {
     theme,
     isDark,
   };
 }
+
+function useTheme() {
+  const systemColorScheme = useColorScheme()
+  const colorScheme = userPreferColorScheme === COLOR_SCHEME_CHOICE.FOLLOW_SYSTEM ?
+    systemColorScheme :
+    userPreferColorScheme;
+
+  return getTheme(colorScheme);
+}
+
+export {
+  useTheme,
+}

package/lib/__templates__/expo/client/metro.config.js

@@ -0,0 +1,121 @@
+const { getDefaultConfig } = require('expo/metro-config');
+const { createProxyMiddleware } = require('http-proxy-middleware');
+const connect = require('connect');
+
+const config = getDefaultConfig(__dirname);
+
+// 安全地获取 Expo 的默认排除列表
+const existingBlockList = [].concat(config.resolver.blockList || []);
+
+config.resolver.blockList = [
+  ...existingBlockList,
+  /.*\/\.expo\/.*/, // Expo 的缓存和构建产物目录
+
+  // 1. 原生代码 (Java/C++/Objective-C)
+  /.*\/react-native\/ReactAndroid\/.*/,
+  /.*\/react-native\/ReactCommon\/.*/,
+
+  // 2. 纯开发和调试工具
+  // 这些工具只在开发电脑上运行，不会被打包到应用中
+  /.*\/@typescript-eslint\/eslint-plugin\/.*/,
+
+  // 3. 构建时数据
+  // 这个数据库只在打包过程中使用，应用运行时不需要
+  /.*\/caniuse-lite\/data\/.*/,
+
+  // 4. 通用规则
+  /.*\/__tests__\/.*/, // 排除所有测试目录
+  /.*\.git\/.*/, // 排除 Git 目录
+];
+
+const BACKEND_TARGET = 'http://localhost:9091';
+
+const apiProxy = createProxyMiddleware({
+  target: BACKEND_TARGET,
+  changeOrigin: true,
+  logLevel: 'debug',
+  proxyTimeout: 86400000,
+  onProxyReq: (proxyReq, req) => {
+    const accept = req.headers.accept || '';
+    if (accept.includes('text/event-stream')) {
+      proxyReq.setHeader('accept-encoding', 'identity');
+    }
+  },
+  onProxyRes: (proxyRes, req, res) => {
+    const contentType = proxyRes.headers['content-type'] || '';
+    if (contentType.includes('text/event-stream') || contentType.includes('application/stream')) {
+      res.setHeader('Cache-Control', 'no-cache');
+      res.setHeader('Connection', 'keep-alive');
+      res.setHeader('X-Accel-Buffering', 'no');
+      if (typeof res.flushHeaders === 'function') {
+        try { res.flushHeaders(); } catch {}
+      }
+    }
+  },
+});
+
+const streamProxy = createProxyMiddleware({
+  target: BACKEND_TARGET,
+  changeOrigin: true,
+  logLevel: 'debug',
+  ws: true,
+  proxyTimeout: 86400000,
+  onProxyReq: (proxyReq, req) => {
+    const upgrade = req.headers.upgrade;
+    const accept = req.headers.accept || '';
+    if (upgrade && upgrade.toLowerCase() === 'websocket') {
+      proxyReq.setHeader('Connection', 'upgrade');
+      proxyReq.setHeader('Upgrade', req.headers.upgrade);
+    } else if (accept.includes('text/event-stream')) {
+      proxyReq.setHeader('accept-encoding', 'identity');
+      proxyReq.setHeader('Connection', 'keep-alive');
+    }
+  },
+  onProxyRes: (proxyRes, req, res) => {
+    const contentType = proxyRes.headers['content-type'] || '';
+    if (contentType.includes('text/event-stream') || contentType.includes('application/stream')) {
+      res.setHeader('Cache-Control', 'no-cache');
+      res.setHeader('Connection', 'keep-alive');
+      res.setHeader('X-Accel-Buffering', 'no');
+      if (typeof res.flushHeaders === 'function') {
+        try { res.flushHeaders(); } catch {}
+      }
+    }
+  },
+});
+
+const shouldProxyToBackend = (url) => {
+  if (!url) return false;
+  if (/^\/api\/v\d+\//.test(url)) {
+    return true;
+  }
+  return false;
+};
+
+const isWebSocketRequest = (req) =>
+  !!(req.headers.upgrade && req.headers.upgrade.toLowerCase() === 'websocket');
+const isSSERequest = (req) => {
+  const accept = req.headers.accept || '';
+  return accept.includes('text/event-stream');
+};
+
+config.server = {
+  ...config.server,
+  enhanceMiddleware: (metroMiddleware, metroServer) => {
+    return connect()
+      .use((req, res, next) => {
+        if (shouldProxyToBackend(req.url)) {
+          console.log(`[Metro Proxy] Forwarding ${req.method} ${req.url}`);
+
+          if (isWebSocketRequest(req) || isSSERequest(req)) {
+            return streamProxy(req, res, next);
+          }
+          return apiProxy(req, res, next);
+        }
+        next();
+      })
+      .use(metroMiddleware);
+  },
+};
+
+module.exports = config;

package/lib/__templates__/expo/client/package.json

@@ -0,0 +1,93 @@
+{
+  "name": "expo-app",
+  "description": "<%= appName %>",
+  "main": "expo-router/entry",
+  "private": true,
+  "scripts": {
+    "check-deps": "npx depcheck",
+    "postinstall": "npm run install-missing",
+    "install-missing": "node ./scripts/install-missing-deps.js",
+    "lint": "expo lint",
+    "start": "expo start --web --clear",
+    "test": "jest --watchAll"
+  },
+  "jest": {
+    "preset": "jest-expo"
+  },
+  "dependencies": {
+    "@expo/metro-runtime": "^6.1.2",
+    "@expo/vector-icons": "^15.0.0",
+    "@react-native-async-storage/async-storage": "^2.2.0",
+    "@react-native-community/datetimepicker": "^8.5.0",
+    "@react-native-community/slider": "^5.0.1",
+    "@react-native-masked-view/masked-view": "^0.3.2",
+    "@react-native-picker/picker": "^2.11.0",
+    "@react-navigation/bottom-tabs": "^7.2.0",
+    "@react-navigation/native": "^7.0.14",
+    "dayjs": "^1.11.19",
+    "expo": "^54.0.7",
+    "expo-auth-session": "^7.0.9",
+    "expo-av": "~16.0.6",
+    "expo-blur": "~15.0.6",
+    "expo-camera": "~17.0.10",
+    "expo-constants": "~18.0.8",
+    "expo-crypto": "^15.0.7",
+    "expo-font": "~14.0.7",
+    "expo-haptics": "~15.0.6",
+    "expo-image-picker": "~17.0.7",
+    "expo-linear-gradient": "~15.0.6",
+    "expo-linking": "~8.0.7",
+    "expo-location": "~19.0.7",
+    "expo-image": "^3.0.11",
+    "expo-router": "~6.0.0",
+    "expo-splash-screen": "~31.0.8",
+    "expo-status-bar": "~3.0.7",
+    "expo-symbols": "~1.0.6",
+    "expo-system-ui": "~6.0.9",
+    "expo-web-browser": "~15.0.10",
+    "react": "19.1.0",
+    "react-dom": "19.1.0",
+    "react-native": "0.81.5",
+    "react-native-chart-kit": "^6.12.0",
+    "react-native-gesture-handler": "~2.28.0",
+    "react-native-keyboard-aware-scroll-view": "^0.9.5",
+    "react-native-modal-datetime-picker": "18.0.0",
+    "react-native-reanimated": "~4.1.0",
+    "react-native-safe-area-context": "~5.6.0",
+    "react-native-screens": "~4.16.0",
+    "react-native-svg": "15.15.0",
+    "react-native-toast-message": "^2.3.3",
+    "react-native-web": "^0.21.2",
+    "react-native-webview": "~13.15.0",
+    "react-native-worklets": "0.5.1",
+    "zod": "^4.2.1"
+  },
+  "devDependencies": {
+    "@babel/core": "^7.25.2",
+    "babel-plugin-module-resolver": "^5.0.2",
+    "babel-preset-expo": "^54.0.9",
+    "@eslint/js": "^9.27.0",
+    "@types/jest": "^29.5.12",
+    "@types/react": "~19.1.0",
+    "@types/react-test-renderer": "19.1.0",
+    "chalk": "^4.1.2",
+    "depcheck": "^1.4.7",
+    "esbuild": "0.27.2",
+    "eslint": "^9.39.2",
+    "eslint-formatter-compact": "^9.0.1",
+    "eslint-import-resolver-typescript": "^4.4.4",
+    "eslint-plugin-import": "^2.32.0",
+    "eslint-plugin-react": "^7.37.5",
+    "eslint-plugin-react-hooks": "^7.0.1",
+    "eslint-plugin-regexp": "^2.10.0",
+    "globals": "^16.1.0",
+    "jest": "^29.2.1",
+    "jest-expo": "~54.0.10",
+    "react-test-renderer": "19.1.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.8.3",
+    "typescript-eslint": "^8.32.1",
+    "connect": "^3.7.0",
+    "http-proxy-middleware": "^3.0.5"
+  }
+}

package/lib/__templates__/expo/client/screens/demo/index.tsx

@@ -0,0 +1,25 @@
+import { View, Text } from 'react-native';
+import { Image } from 'expo-image';
+
+import { useTheme } from '@/hooks/useTheme';
+import { Screen } from '@/components/Screen';
+import { styles } from './styles';
+
+export default function DemoPage() {
+  const { theme, isDark } = useTheme();
+
+  return (
+    <Screen backgroundColor={theme.backgroundRoot} statusBarStyle={isDark ? 'light' : 'dark'}>
+      <View
+        style={styles.container}
+      >
+        <Image
+          style={styles.logo}
+          source="https://lf-coze-web-cdn.coze.cn/obj/eden-cn/lm-lgvj/ljhwZthlaukjlkulzlp/coze-coding/expo/coze-loading.gif"
+        ></Image>
+        <Text style={{...styles.title, color: theme.textPrimary}}>APP 开发中</Text>
+        <Text style={{...styles.description, color: theme.textSecondary}}>即将为您呈现应用界面</Text>
+      </View>
+    </Screen>
+  );
+}

package/lib/__templates__/expo/client/screens/demo/styles.ts

@@ -0,0 +1,28 @@
+import { Spacing } from '@/constants/theme';
+import { StyleSheet } from 'react-native';
+
+export const styles = StyleSheet.create({
+  container: {
+    position: 'absolute',
+    top: 0,
+    left: 0,
+    width: '100%',
+    height: '100%',
+    display: 'flex',
+    flexDirection: 'column',
+    alignItems: 'center',
+    justifyContent: 'center',
+  },
+  logo: {
+    width: 130,
+    height: 109,
+  },
+  title: {
+    fontSize: 16,
+    fontWeight: 'bold',
+  },
+  description: {
+    fontSize: 14,
+    marginTop: Spacing.sm,
+  },
+});

package/lib/__templates__/expo/client/scripts/install-missing-deps.js

@@ -38,6 +38,7 @@ try {
   const ignoreFilePatterns = [
     /template\.config\.(ts|js)$/, // 模板配置文件
     /\.template\./, // 其他模板文件
+    /declarations\.d\.ts$/, // 项目配置文件
   ];
 
   // 过滤包：排除内部别名和只被模板文件引用的包

package/lib/__templates__/expo/client/tsconfig.json

@@ -0,0 +1,24 @@
+{
+  "extends": "expo/tsconfig.base",
+  "compilerOptions": {
+    "skipLibCheck": true,
+    "jsx": "react-jsx",
+    "baseUrl": ".",
+    "strict": true,
+    "noEmit": true,
+    "paths": {
+      "@/*": ["./*"]
+    }
+  },
+  "include": ["**/*.ts", "**/*.tsx", ".expo/types/**/*.ts", "expo-env.d.ts"],
+  "exclude": [
+    "node_modules",
+    "**/*.spec.ts",
+    "**/*.test.ts",
+    "**/*.spec.tsx",
+    "**/*.test.tsx",
+    "dist",
+    "build",
+    ".expo"
+  ]
+}

package/lib/__templates__/expo/client/utils/index.ts

@@ -1,9 +1,31 @@
+import { Platform } from 'react-native';
 import dayjs from 'dayjs';
 import utc from 'dayjs/plugin/utc';
 dayjs.extend(utc);
 
 const API_BASE = (process.env.EXPO_PUBLIC_API_BASE ?? '').replace(/\/$/, '');
 
+/**
+ * 创建跨平台兼容的文件对象，用于 FormData.append()
+ * - Web 端返回 File 对象
+ * - 移动端返回 { uri, type, name } 对象（RN fetch 会自动处理）
+ * @param fileUri Expo 媒体库（如 expo-image-picker、expo-camera）返回的 uri
+ * @param fileName 上传时的文件名，如 'photo.jpg'
+ * @param mimeType 文件 MIME 类型，如 'image/jpeg'、'audio/mpeg'
+ */
+export async function createFormDataFile(
+  fileUri: string,
+  fileName: string,
+  mimeType: string
+): Promise<File | { uri: string; type: string; name: string }> {
+  if (Platform.OS === 'web') {
+    const response = await fetch(fileUri);
+    const blob = await response.blob();
+    return new File([blob], fileName, { type: mimeType });
+  }
+  return { uri: fileUri, type: mimeType, name: fileName };
+}
+
 /**
  * 构建文件或图片完整的URL
  * @param url 相对或绝对路径

package/lib/__templates__/expo/eslint-plugins/fontawesome6/index.js

@@ -0,0 +1,9 @@
+const validName = require('./rule')
+
+const plugin = {
+  rules: {
+    'valid-name': validName,
+  },
+};
+
+module.exports = plugin