@coze-arch/cli 0.0.6 → 0.0.7-alpha.e6346c

package/lib/__templates__/nextjs/AGENTS.md

@@ -40,6 +40,13 @@
 - 安装所有依赖：`pnpm install`
 - 移除依赖：`pnpm remove <package>`
 
+## 验证规范
+
+每次开发完成后，都需要执行以下验证：
+
+- **静态检查**：`pnpm check:all`
+
+
 ## 开发规范
 
 - **项目理解加速**：初始可以依赖项目下`package.json`文件理解项目类型，如果没有或无法理解退化成阅读其他文件。

package/lib/__templates__/nextjs/package.json

@@ -4,6 +4,7 @@
   "private": true,
   "scripts": {
     "build": "bash ./scripts/build.sh",
+    "check:all": "run-p build lint ts-check",
     "dev": "bash ./scripts/dev.sh",
     "preinstall": "npx only-allow pnpm",
     "lint": "eslint",
@@ -78,6 +79,7 @@
     "@types/react-dom": "^19",
     "eslint": "^9",
     "eslint-config-next": "16.1.1",
+    "npm-run-all2": "^8.0.4",
     "only-allow": "^1.2.2",
     "react-dev-inspector": "^2.0.1",
     "shadcn": "latest",

package/lib/__templates__/nuxt-vue/AGENTS.md

@@ -37,6 +37,13 @@
 - 安装所有依赖：`pnpm install`
 - 移除依赖：`pnpm remove <package>`
 
+## 验证规范
+
+每次开发完成后，都需要执行以下验证：
+
+- **静态检查**：`pnpm check:all`
+
+
 ## 开发规范
 
 - 使用 Tailwind CSS 进行样式开发

package/lib/__templates__/nuxt-vue/eslint.config.mjs

@@ -0,0 +1,12 @@
+import withNuxt from './.nuxt/eslint.config.mjs';
+import { globalIgnores } from 'eslint/config';
+
+export default withNuxt(
+  globalIgnores([
+    '.nuxt/**',
+    '.output/**',
+    'dist/**',
+    'node_modules/**',
+    'scripts/**/*.js',
+  ]),
+);

package/lib/__templates__/nuxt-vue/package.json

@@ -5,11 +5,14 @@
   "type": "module",
   "scripts": {
     "build": "bash ./scripts/build.sh",
+    "check:all": "run-p build lint ts-check",
     "dev": "bash ./scripts/dev.sh",
     "generate": "nuxt generate",
+    "lint": "eslint",
     "preinstall": "npx only-allow pnpm",
     "preview": "nuxt preview",
-    "start": "bash ./scripts/start.sh"
+    "start": "bash ./scripts/start.sh",
+    "ts-check": "nuxt typecheck"
   },
   "dependencies": {
     "@nuxt/image": "^1.8.1",
@@ -19,10 +22,13 @@
     "vue-router": "^4.6.4"
   },
   "devDependencies": {
+    "@nuxt/eslint": "^1.5.0",
     "@nuxtjs/tailwindcss": "^6.14.0",
     "@types/node": "^20",
     "autoprefixer": "^10.4.20",
     "coze-coding-dev-sdk": "^0.7.16",
+    "eslint": "^9",
+    "npm-run-all2": "^8.0.4",
     "only-allow": "^1.2.2",
     "postcss": "^8.4.49",
     "tailwindcss": "^3.4.17",

package/lib/__templates__/taro/eslint.config.mjs

@@ -9,6 +9,130 @@ const compat = new FlatCompat({
   baseDirectory: __dirname,
 });
 
+const baseRestrictedSyntaxRules = [
+  {
+    selector: "MemberExpression[object.name='process'][property.name='env']",
+    message:
+      '工程规范：请勿在 src 目录下直接使用 process.env\n如需获取 URL 请求前缀，请使用已经注入全局的 PROJECT_DOMAIN',
+  },
+  {
+    selector:
+      ":matches(ExportNamedDeclaration, ExportDefaultDeclaration) :matches([id.name='Network'], [declaration.id.name='Network'])",
+    message:
+      "工程规范：禁止自行定义 Network，项目已提供 src/network.ts，请直接使用: import { Network } from '@/network'",
+  },
+  {
+    selector:
+      'Literal[value=/(^|\\s)(?:[^\\s:]+:)*(bg|text|border|divide|outline|ring|ring-offset|from|to|via|decoration|shadow|accent|caret|fill|stroke)-[a-z0-9-]+\\/([0-9]+|\\[[^\\]]+\\])/], TemplateElement[value.raw=/(^|\\s)(?:[^\\s:]+:)*(bg|text|border|divide|outline|ring|ring-offset|from|to|via|decoration|shadow|accent|caret|fill|stroke)-[a-z0-9-]+\\/([0-9]+|\\[[^\\]]+\\])/]',
+    message:
+      '微信小程序兼容性：禁用 Tailwind 颜色不透明度简写（如 bg-primary/10），该语法在微信小程序下 opacity 会丢失。请拆分写（如 bg-primary bg-opacity-10）。',
+  },
+  {
+    selector:
+      'Literal[value=/(^|\\s)peer-[a-z0-9-]+\\b/], TemplateElement[value.raw=/(^|\\s)peer-[a-z0-9-]+\\b/]',
+    message:
+      '微信小程序兼容性：不支持 Tailwind 的 peer-*（如 peer-checked、peer-disabled）。',
+  },
+  {
+    selector:
+      'Literal[value=/(^|\\s)group-[a-z0-9-]+\\b/], TemplateElement[value.raw=/(^|\\s)group-[a-z0-9-]+\\b/]',
+    message: '微信小程序兼容性：不支持 Tailwind 的 group-*（如 group-hover）。',
+  },
+  {
+    selector:
+      'Literal[value=/\\b(?!gap(?:-x|-y)?-)[a-zA-Z0-9-]+\\-[0-9]+\\.[0-9]+\\b/], TemplateElement[value.raw=/\\b(?!gap(?:-x|-y)?-)[a-zA-Z0-9-]+\\-[0-9]+\\.[0-9]+\\b/]',
+    message:
+      '微信小程序兼容性：禁用 Tailwind 小数值类名（如 space-y-1.5、w-0.5），请用整数替代（如 space-y-2、w-1）。',
+  },
+  {
+    selector:
+      ":matches(JSXAttribute[name.name='className'], CallExpression[callee.name=/^(cn|cva)$/]) :matches(Literal[value=/\\:has\\(/], TemplateElement[value.raw=/\\:has\\(/])",
+    message: '微信小程序兼容性：WXSS 不支持 :has(...)（会导致预览上传失败）。',
+  },
+  {
+    selector:
+      ":matches(JSXAttribute[name.name='className'], CallExpression[callee.name=/^(cn|cva)$/]) :matches(Literal[value=/(^|\\s)has-[^\\s]+/], TemplateElement[value.raw=/(^|\\s)has-[^\\s]+/])",
+    message:
+      '微信小程序兼容性：禁用 Tailwind 的 has-* 变体（会生成 :has，导致预览上传失败）。',
+  },
+  {
+    selector:
+      ":matches(JSXAttribute[name.name='className'], CallExpression[callee.name=/^(cn|cva)$/]) :matches(Literal[value=/\\[&>\\*/], TemplateElement[value.raw=/\\[&>\\*/])",
+    message:
+      '微信小程序兼容性：禁用 [&>*...]（可能生成非法 WXSS，如 >:last-child）。请改为 [&>view] 等明确标签。',
+  },
+  {
+    selector:
+      ":matches(JSXAttribute[name.name='className'], CallExpression[callee.name=/^(cn|cva)$/]) :matches(Literal[value=/\\[&[^\\]]*\\[data-/], TemplateElement[value.raw=/\\[&[^\\]]*\\[data-/])",
+    message:
+      '微信小程序兼容性：禁用 Tailwind 任意选择器里的属性选择器（如 [&>[data-...]]），可能导致预览上传失败。',
+  },
+  {
+    selector:
+      ":matches(JSXAttribute[name.name='className'], CallExpression[callee.name=/^(cn|cva)$/]) :matches(Literal[value=/\\[[^\\]]*&[^\\]]*~[^\\]]*\\]/], TemplateElement[value.raw=/\\[[^\\]]*&[^\\]]*~[^\\]]*\\]/])",
+    message: '微信小程序兼容性：WXSS 不支持 ~（会导致预览上传失败）。',
+  },
+  {
+    selector:
+      "JSXAttribute[name.name='color'][value.type='Literal'][value.value='currentColor'], JSXAttribute[name.name='color'] > JSXExpressionContainer > Literal[value='currentColor']",
+    message:
+      'lucide-react-taro 规范：禁止使用 color="currentColor"，小程序端不会按预期继承颜色。请改为显式颜色值，或通过 LucideTaroProvider 提供默认颜色。',
+  },
+];
+
+const pageRestrictedSyntaxRules = [
+  {
+    selector:
+      "ImportDeclaration[source.value='@tarojs/components'] ImportSpecifier[imported.name='Button']",
+    message:
+      "组件规范：Button 优先使用 '@/components/ui/button'，不要在页面中直接使用 '@tarojs/components' 的 Button。",
+  },
+  {
+    selector:
+      "ImportDeclaration[source.value='@tarojs/components'] ImportSpecifier[imported.name='Input']",
+    message:
+      "组件规范：Input 优先使用 '@/components/ui/input'，不要在页面中直接使用 '@tarojs/components' 的 Input。",
+  },
+  {
+    selector:
+      "ImportDeclaration[source.value='@tarojs/components'] ImportSpecifier[imported.name='Textarea']",
+    message:
+      "组件规范：Textarea 优先使用 '@/components/ui/textarea'，不要在页面中直接使用 '@tarojs/components' 的 Textarea。",
+  },
+  {
+    selector:
+      "ImportDeclaration[source.value='@tarojs/components'] ImportSpecifier[imported.name='Label']",
+    message:
+      "组件规范：Label 优先使用 '@/components/ui/label'，不要在页面中直接使用 '@tarojs/components' 的 Label。",
+  },
+  {
+    selector:
+      "ImportDeclaration[source.value='@tarojs/components'] ImportSpecifier[imported.name='Switch']",
+    message:
+      "组件规范：Switch 优先使用 '@/components/ui/switch'，不要在页面中直接使用 '@tarojs/components' 的 Switch。",
+  },
+  {
+    selector:
+      "ImportDeclaration[source.value='@tarojs/components'] ImportSpecifier[imported.name='Slider']",
+    message:
+      "组件规范：Slider 优先使用 '@/components/ui/slider'，不要在页面中直接使用 '@tarojs/components' 的 Slider。",
+  },
+  {
+    selector:
+      "ImportDeclaration[source.value='@tarojs/components'] ImportSpecifier[imported.name='Progress']",
+    message:
+      "组件规范：Progress 优先使用 '@/components/ui/progress'，不要在页面中直接使用 '@tarojs/components' 的 Progress。",
+  },
+];
+
+const indexPageRestrictedSyntaxRules = [
+  {
+    selector: 'JSXText[value=/\\s*应用开发中\\s*/]',
+    message:
+      '工程规范：检测到首页 (src/pages/index/index.tsx) 仍为默认占位页面，这会导致用户无法进入新增页面，请根据用户需求开发实际的首页功能与界面。如果已经开发了新的首页，也需要删除旧首页，并更新 src/app.config.ts 文件',
+  },
+];
+
 export default [
   ...compat.extends('taro/react'),
   {
@@ -25,80 +149,7 @@ export default [
     files: ['src/**/*.{js,jsx,ts,tsx}'],
     ignores: ['src/network.ts'],
     rules: {
-      'no-restricted-syntax': [
-        'error',
-        {
-          selector:
-            "MemberExpression[object.name='process'][property.name='env']",
-          message:
-            '工程规范：请勿在 src 目录下直接使用 process.env\n如需获取 URL 请求前缀，请使用已经注入全局的 PROJECT_DOMAIN',
-        },
-        {
-          selector:
-            ":matches(ExportNamedDeclaration, ExportDefaultDeclaration) :matches([id.name='Network'], [declaration.id.name='Network'])",
-          message:
-            "工程规范：禁止自行定义 Network，项目已提供 src/network.ts，请直接使用: import { Network } from '@/network'",
-        },
-        {
-          selector:
-            'Literal[value=/(^|\\s)(?:[^\\s:]+:)*(bg|text|border|divide|outline|ring|ring-offset|from|to|via|decoration|shadow|accent|caret|fill|stroke)-[a-z0-9-]+\\/([0-9]+|\\[[^\\]]+\\])/], TemplateElement[value.raw=/(^|\\s)(?:[^\\s:]+:)*(bg|text|border|divide|outline|ring|ring-offset|from|to|via|decoration|shadow|accent|caret|fill|stroke)-[a-z0-9-]+\\/([0-9]+|\\[[^\\]]+\\])/]',
-          message:
-            '微信小程序兼容性：禁用 Tailwind 颜色不透明度简写（如 bg-primary/10），该语法在微信小程序下 opacity 会丢失。请拆分写（如 bg-primary bg-opacity-10）。',
-        },
-        {
-          selector:
-            'Literal[value=/(^|\\s)peer-[a-z0-9-]+\\b/], TemplateElement[value.raw=/(^|\\s)peer-[a-z0-9-]+\\b/]',
-          message:
-            '微信小程序兼容性：不支持 Tailwind 的 peer-*（如 peer-checked、peer-disabled）。',
-        },
-        {
-          selector:
-            'Literal[value=/(^|\\s)group-[a-z0-9-]+\\b/], TemplateElement[value.raw=/(^|\\s)group-[a-z0-9-]+\\b/]',
-          message:
-            '微信小程序兼容性：不支持 Tailwind 的 group-*（如 group-hover）。',
-        },
-        {
-          selector:
-            'Literal[value=/\\b(?!gap(?:-x|-y)?-)[a-zA-Z0-9-]+\\-[0-9]+\\.[0-9]+\\b/], TemplateElement[value.raw=/\\b(?!gap(?:-x|-y)?-)[a-zA-Z0-9-]+\\-[0-9]+\\.[0-9]+\\b/]',
-          message:
-            '微信小程序兼容性：禁用 Tailwind 小数值类名（如 space-y-1.5、w-0.5），请用整数替代（如 space-y-2、w-1）。',
-        },
-        {
-          selector:
-            ":matches(JSXAttribute[name.name='className'], CallExpression[callee.name=/^(cn|cva)$/]) :matches(Literal[value=/\\:has\\(/], TemplateElement[value.raw=/\\:has\\(/])",
-          message:
-            '微信小程序兼容性：WXSS 不支持 :has(...)（会导致预览上传失败）。',
-        },
-        {
-          selector:
-            ":matches(JSXAttribute[name.name='className'], CallExpression[callee.name=/^(cn|cva)$/]) :matches(Literal[value=/(^|\\s)has-[^\\s]+/], TemplateElement[value.raw=/(^|\\s)has-[^\\s]+/])",
-          message:
-            '微信小程序兼容性：禁用 Tailwind 的 has-* 变体（会生成 :has，导致预览上传失败）。',
-        },
-        {
-          selector:
-            ":matches(JSXAttribute[name.name='className'], CallExpression[callee.name=/^(cn|cva)$/]) :matches(Literal[value=/\\[&>\\*/], TemplateElement[value.raw=/\\[&>\\*/])",
-          message:
-            '微信小程序兼容性：禁用 [&>*...]（可能生成非法 WXSS，如 >:last-child）。请改为 [&>view] 等明确标签。',
-        },
-        {
-          selector:
-            ":matches(JSXAttribute[name.name='className'], CallExpression[callee.name=/^(cn|cva)$/]) :matches(Literal[value=/\\[&[^\\]]*\\[data-/], TemplateElement[value.raw=/\\[&[^\\]]*\\[data-/])",
-          message:
-            '微信小程序兼容性：禁用 Tailwind 任意选择器里的属性选择器（如 [&>[data-...]]），可能导致预览上传失败。',
-        },
-        {
-          selector:
-            ":matches(JSXAttribute[name.name='className'], CallExpression[callee.name=/^(cn|cva)$/]) :matches(Literal[value=/\\[[^\\]]*&[^\\]]*~[^\\]]*\\]/], TemplateElement[value.raw=/\\[[^\\]]*&[^\\]]*~[^\\]]*\\]/])",
-          message: '微信小程序兼容性：WXSS 不支持 ~（会导致预览上传失败）。',
-        },
-        {
-          selector:
-            "JSXAttribute[name.name='color'][value.type='Literal'][value.value='currentColor'], JSXAttribute[name.name='color'] > JSXExpressionContainer > Literal[value='currentColor']",
-          message:
-            'lucide-react-taro 规范：禁止使用 color="currentColor"，小程序端不会按预期继承颜色。请改为显式颜色值，或通过 LucideTaroProvider 提供默认颜色。',
-        },
-      ],
+      'no-restricted-syntax': ['error', ...baseRestrictedSyntaxRules],
       'no-restricted-properties': [
         'error',
         {
@@ -123,15 +174,23 @@ export default [
     },
   },
   {
-    files: ['src/pages/intro/index.tsx'],
+    files: ['src/pages/**/*.tsx'],
     rules: {
       'no-restricted-syntax': [
         'error',
-        {
-          selector: 'JSXText[value=/应用开发中/]',
-          message:
-            '工程规范：检测到首页 (src/pages/intro/index) 仍为默认占位页面，这会导致用户无法进入新增页面，请根据用户需求开发实际的首页功能 and 界面。如果已经开发了新的首页，也需要删除旧首页，并更新 src/app.config.ts 文件',
-        },
+        ...baseRestrictedSyntaxRules,
+        ...pageRestrictedSyntaxRules,
+      ],
+    },
+  },
+  {
+    files: ['src/pages/index/index.tsx'],
+    rules: {
+      'no-restricted-syntax': [
+        'error',
+        ...baseRestrictedSyntaxRules,
+        ...pageRestrictedSyntaxRules,
+        ...indexPageRestrictedSyntaxRules,
       ],
     },
   },

package/lib/__templates__/taro/src/app.tsx

@@ -1,12 +1,14 @@
 import { PropsWithChildren } from 'react';
 import { LucideTaroProvider } from 'lucide-react-taro';
 import '@/app.css';
+import { Toaster } from '@/components/ui/toast';
 import { Preset } from './presets';
 
 const App = ({ children }: PropsWithChildren) => {
   return (
     <LucideTaroProvider defaultColor="#000" defaultSize={24}>
       <Preset>{children}</Preset>
+      <Toaster />
     </LucideTaroProvider>
   );
 };

package/lib/__templates__/taro/src/components/ui/carousel.tsx

@@ -175,8 +175,8 @@ const CarouselPrevious = React.forwardRef<
       className={cn(
         "absolute h-8 w-8 rounded-full z-10 bg-background bg-opacity-80 backdrop-blur-sm",
         orientation === "horizontal"
-          ? "-left-12 top-1/2 -translate-y-1/2"
-          : "-top-12 left-1/2 -translate-x-1/2 rotate-90",
+          ? "-left-12 top-0 bottom-0 my-auto"
+          : "-top-12 left-0 right-0 mx-auto rotate-90",
         className
       )}
       disabled={!canScrollPrev}
@@ -204,8 +204,8 @@ const CarouselNext = React.forwardRef<
       className={cn(
         "absolute h-8 w-8 rounded-full z-10 bg-background bg-opacity-80 backdrop-blur-sm",
         orientation === "horizontal"
-          ? "-right-12 top-1/2 -translate-y-1/2"
-          : "-bottom-12 left-1/2 -translate-x-1/2 rotate-90",
+          ? "-right-12 top-0 bottom-0 my-auto"
+          : "-bottom-12 left-0 right-0 mx-auto rotate-90",
         className
       )}
       disabled={!canScrollNext}

package/lib/__templates__/taro/src/components/ui/sheet.tsx

@@ -179,7 +179,7 @@ const SheetContent = React.forwardRef<
         >
           {children}
           <View 
-            className="absolute right-4 top-4 rounded-sm opacity-70 ring-offset-background transition-opacity hover:opacity-100 focus:outline-none focus:ring-2 focus:ring-ring focus:ring-offset-2 disabled:pointer-events-none data-[state=open]:bg-secondary"
+            className="absolute right-4 top-4 flex h-8 w-8 items-center justify-center rounded-sm opacity-70 ring-offset-background transition-opacity hover:opacity-100 focus:outline-none focus:ring-2 focus:ring-ring focus:ring-offset-2 disabled:pointer-events-none data-[state=open]:bg-secondary"
             data-state={state}
             onClick={(e) => {
                   e.stopPropagation()

package/lib/__templates__/taro/src/components/ui/toast.tsx

@@ -258,7 +258,7 @@ const Toaster = ({
     <Portal>
       <View
         className={cn(
-          "toaster fixed z-[100] flex p-4 w-full pointer-events-none",
+          "toaster fixed z-[2147483647] flex w-full pointer-events-none p-4",
           getPositionStyle(position),
           className
         )}

package/lib/__templates__/taro/src/presets/env.ts

@@ -0,0 +1 @@
+export const IS_H5_ENV = TARO_ENV === 'h5';

package/lib/__templates__/taro/src/presets/h5-container.tsx

@@ -1,8 +1,9 @@
 import { PropsWithChildren } from 'react';
+import { IS_H5_ENV } from './env';
 import { H5NavBar } from './h5-navbar';
 
 export const H5Container = ({ children }: PropsWithChildren) => {
-  if (TARO_ENV !== 'h5') {
+  if (!IS_H5_ENV) {
     return <>{children}</>;
   }