@lark-apaas/coding-templates 0.1.17 → 0.1.19

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/coding-templates",
-  "version": "0.1.17",
+  "version": "0.1.19",
   "description": "OpenClaw project templates for mclaw CLI",
   "publishConfig": {
     "access": "public"

package/template-apex/eslint.config.js

@@ -1,54 +1,14 @@
-import js from '@eslint/js'
-import globals from 'globals'
-import reactHooks from 'eslint-plugin-react-hooks'
-import reactRefresh from 'eslint-plugin-react-refresh'
-import tseslint from 'typescript-eslint'
-import { defineConfig, globalIgnores } from 'eslint/config'
+import { eslintPresets } from '@lark-apaas/coding-presets'
 
-export default defineConfig([
-  globalIgnores(['dist']),
-  {
+export default [
+  // 客户端：React + TypeScript
+  ...eslintPresets.client.map(config => config.ignores ? config : {
+    ...config,
     files: ['client/**/*.{ts,tsx}'],
-    extends: [
-      js.configs.recommended,
-      tseslint.configs.recommended,
-      reactHooks.configs.flat.recommended,
-      reactRefresh.configs.vite,
-    ],
-    languageOptions: {
-      ecmaVersion: 2020,
-      globals: globals.browser,
-    },
-    rules: {
-      // 关闭仅语法相关、不影响编译和运行时的规则
-      'react-refresh/only-export-components': 'off',
-      '@typescript-eslint/no-unused-vars': 'off',
-      '@typescript-eslint/no-explicit-any': 'off',
-      '@typescript-eslint/no-empty-object-type': 'off',
-      '@typescript-eslint/no-require-imports': 'off',
-      'no-empty': 'off',
-      'prefer-const': 'off',
-      'no-unused-labels': 'off',
-    },
-  },
-  {
+  }),
+  // 服务端：Node.js + TypeScript
+  ...eslintPresets.server.map(config => config.ignores ? config : {
+    ...config,
     files: ['server/**/*.ts', 'shared/**/*.ts'],
-    extends: [
-      js.configs.recommended,
-      tseslint.configs.recommended,
-    ],
-    languageOptions: {
-      ecmaVersion: 2020,
-      globals: globals.node,
-    },
-    rules: {
-      '@typescript-eslint/no-unused-vars': 'off',
-      '@typescript-eslint/no-explicit-any': 'off',
-      '@typescript-eslint/no-empty-object-type': 'off',
-      '@typescript-eslint/no-require-imports': 'off',
-      'no-empty': 'off',
-      'prefer-const': 'off',
-      'no-unused-labels': 'off',
-    },
-  },
-])
+  }),
+]

package/template-apex/package.json

@@ -74,19 +74,15 @@
     "zod": "^4.3.6"
   },
   "devDependencies": {
-    "@eslint/js": "^9",
+    "@lark-apaas/coding-presets": "^0.1.0",
     "@lark-apaas/coding-vite-preset": "^0.1.0",
     "@types/express": "^5",
     "@types/node": "^24",
     "@types/react": "^19",
     "@types/react-dom": "^19",
     "eslint": "^9",
-    "eslint-plugin-react-hooks": "^7",
-    "eslint-plugin-react-refresh": "^0.5",
-    "globals": "^17",
     "tsx": "^4",
     "typescript": "~5.9",
-    "typescript-eslint": "^8",
     "vite": "^8"
   }
 }

package/template-apex/tsconfig.app.json

@@ -1,28 +1,8 @@
 {
+  "extends": "@lark-apaas/coding-presets/lib/tsconfig/tsconfig.app.json",
   "compilerOptions": {
     "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.app.tsbuildinfo",
-    "target": "ES2023",
-    "useDefineForClassFields": true,
-    "lib": ["ES2023", "DOM", "DOM.Iterable"],
-    "module": "ESNext",
     "types": ["vite/client"],
-    "skipLibCheck": true,
-
-    /* Bundler mode */
-    "moduleResolution": "bundler",
-    "allowImportingTsExtensions": true,
-    "verbatimModuleSyntax": true,
-    "moduleDetection": "force",
-    "noEmit": true,
-    "jsx": "react-jsx",
-
-    /* Linting */
-    "strict": true,
-    "noUnusedLocals": true,
-    "noUnusedParameters": true,
-    "erasableSyntaxOnly": true,
-    "noFallthroughCasesInSwitch": true,
-    "noUncheckedSideEffectImports": true,
     "baseUrl": ".",
     "paths": {
       "@/*": ["./client/src/*"],

package/template-apex/tsconfig.node.json

@@ -1,27 +1,7 @@
 {
+  "extends": "@lark-apaas/coding-presets/lib/tsconfig/tsconfig.node.json",
   "compilerOptions": {
     "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.node.tsbuildinfo",
-    "target": "ES2023",
-    "lib": ["ES2023"],
-    "module": "ESNext",
-    "types": ["node"],
-    "skipLibCheck": true,
-
-    /* Bundler mode */
-    "moduleResolution": "bundler",
-    "allowImportingTsExtensions": true,
-    "verbatimModuleSyntax": true,
-    "moduleDetection": "force",
-    "noEmit": true,
-
-    /* Linting */
-    "strict": true,
-    "noUnusedLocals": true,
-    "noUnusedParameters": true,
-    "erasableSyntaxOnly": true,
-    "noFallthroughCasesInSwitch": true,
-    "noUncheckedSideEffectImports": true,
-
     "baseUrl": ".",
     "paths": {
       "@shared/*": ["./shared/*"]

package/template-apex/tsconfig.server.json

@@ -1,15 +1,9 @@
 {
+  "extends": "@lark-apaas/coding-presets/lib/tsconfig/tsconfig.node.json",
   "compilerOptions": {
-    "target": "ES2023",
-    "lib": ["ES2023"],
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "types": ["node"],
-    "skipLibCheck": true,
-    "strict": true,
-    "erasableSyntaxOnly": true,
     "outDir": "./dist/server",
     "rootDir": ".",
+    "noEmit": false,
     "baseUrl": ".",
     "paths": {
       "@shared/*": ["./shared/*"]

package/template-vite-react/README.md

@@ -21,7 +21,7 @@ client/src/
 ├── components/          # 基础 UI 组件（禁止存放业务组件）
 │   └── ui/              # shadcn/ui 内置组件（勿手动修改）
 ├── pages/               # 页面模块（每个页面一个目录）
-│   └── HomePage/        # 页面目录使用 PascalCase 命名
+│   └── HomePage/        # 占位示例页，开发时替换为业务首页
 │       ├── HomePage.tsx        # 页面入口文件与目录同名
 │       └── components/         # 页面专属组件
 ├── hooks/               # 自定义 Hooks
@@ -35,7 +35,7 @@ client/src/
 **页面文件只做骨架编排，不包含具体 UI 实现。**
 
 ```tsx
-// client/src/pages/dashboard/index.tsx
+// client/src/pages/DashboardPage/DashboardPage.tsx
 import { StatsSection } from "./components/stats-section";
 import { DataTableSection } from "./components/data-table-section";
 
@@ -64,7 +64,7 @@ export default function DashboardPage() {
 
 **1. 页面文件 = 纯布局组合器**
 
-- `index.tsx` 只做 import + JSX 排列，**禁止包含** `useState`、`useEffect`、数据请求或业务逻辑
+- 页面入口文件（如 `DashboardPage.tsx`）只做 import + JSX 排列，**禁止包含** `useState`、`useEffect`、数据请求或业务逻辑
 - 页面文件无 props 接口定义，不承担任何数据协调职责
 
 **2. Section 自包含原则**
@@ -73,7 +73,7 @@ export default function DashboardPage() {
 - **数据获取**（API 调用、fetch）— 即使多个 Section 需要同一份数据，各自获取
 - **状态管理**（useState、useReducer）
 - **类型定义**（写在同文件或同目录下的 `types.ts`）
-- **子组件**（如需拆分，放在同级目录，如 `components/stats-section/` 目录化）
+- **子组件**（如需拆分，平铺在 `components/` 目录下，禁止嵌套子目录）
 
 **3. 禁止 Section 间横向依赖**
 
@@ -85,12 +85,18 @@ export default function DashboardPage() {
 
 ## 路由注册
 
-新增页面在 `client/src/app.tsx` 中注册：
+新增页面在 `client/src/app.tsx` 中注册。
+
+> ⚠️ **首页路由替换（必做）**
+>
+> 模板默认的 `HomePage` 是占位示例页，**不是业务首页**。开发时必须将 `index` 路由替换为真实的业务首页组件（如 `DashboardPage`），并删除 `HomePage` 目录。
+
+**替换后的路由示例：**
 
 ```tsx
 import { BrowserRouter, Routes, Route } from "react-router-dom";
 import { Layout } from "@/components/layout";
-import HomePage from "@/pages/HomePage/HomePage";
+import DashboardPage from "@/pages/DashboardPage/DashboardPage";
 import NotFoundPage from "@/pages/NotFoundPage/NotFoundPage";
 
 declare const __APP_BASE_PATH__: string;
@@ -100,7 +106,8 @@ export default function App() {
     <BrowserRouter basename={__APP_BASE_PATH__}>
       <Routes>
         <Route element={<Layout />}>
-          <Route index element={<HomePage />} />
+          {/* 将 index 路由指向真实的业务首页 */}
+          <Route index element={<DashboardPage />} />
           <Route path="*" element={<NotFoundPage />} />
         </Route>
       </Routes>
@@ -111,9 +118,8 @@ export default function App() {
 
 **新增页面步骤：**
 
-1. 在 `client/src/pages/` 下新建页面目录（如 `DashboardPage`）和 `DashboardPage.tsx`
+1. 在 `client/src/pages/` 下新建页面目录（如 `SettingsPage`）和 `SettingsPage.tsx`
 2. 在 `app.tsx` 的 `<Routes>` 内添加 `<Route>` 配置
-3. **必须调整首页路由**：根据业务需求修改 `index` 路由对应的页面组件（默认的 `HomePage` 仅作为示例，实际开发时需替换为真实的业务首页）
 
 **路由跳转必须使用 react-router-dom：**
 
@@ -204,7 +210,7 @@ export default function App() {
 |--------|---------|
 | 页面拆分 | 页面文件只做骨架编排（无 state/effect/逻辑）；每个 Section 自包含数据+状态+类型；兄弟 Section 间无互相 import；单文件 ≤150 行 |
 | 命名规范 | 文件名 kebab-case，组件名 PascalCase |
-| 路由注册 | 新页面已在 `app.tsx` 注册；跳转使用 `<Link>` / `useNavigate()`，无 `<a href>` |
+| 路由注册 | 默认 `HomePage` 已替换为业务首页；新页面已在 `app.tsx` 注册；跳转使用 `<Link>` / `useNavigate()`，无 `<a href>` |
 | 主题色 | 使用语义化变量类（`bg-background`、`text-primary` 等）；未硬编码颜色值 |
 | 主题修改 | 仅增量覆盖变更的变量；新增色同时注册 `:root` 和 `@theme inline` |
 | 响应式 | 容器 `max-w-*` + `mx-auto`；多列布局窄屏退化单列；flex 有 `min-w-0` |

package/template-vite-react/client/src/lib/utils.ts

@@ -1,6 +1,6 @@
-import { clsx, type ClassValue } from "clsx"
-import { twMerge } from "tailwind-merge"
+import { clsx, type ClassValue } from "clsx";
+import { twMerge } from "tailwind-merge";
 
 export function cn(...inputs: ClassValue[]) {
-  return twMerge(clsx(inputs))
+  return twMerge(clsx(inputs));
 }

package/template-apex/client/src/lib/utils.ts

@@ -1,6 +0,0 @@
-import { clsx, type ClassValue } from "clsx"
-import { twMerge } from "tailwind-merge"
-
-export function cn(...inputs: ClassValue[]) {
-  return twMerge(clsx(inputs))
-}