@lark-apaas/coding-templates 0.1.12 → 0.1.14

package/template-apex/shared/types.ts

@@ -0,0 +1,9 @@
+// 前后端共享类型定义
+// shared 是最底层模块，不依赖 client 或 server
+
+export interface Todo {
+  id: number;
+  title: string;
+  completed: boolean;
+  createdAt: string;
+}

package/template-apex/tsconfig.app.json

@@ -0,0 +1,33 @@
+{
+  "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/*"],
+      "@shared/*": ["./shared/*"]
+    }
+  },
+  "include": ["client/src", "shared"]
+}

package/template-apex/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["./client/src/*"],
+      "@shared/*": ["./shared/*"]
+    }
+  },
+  "files": [],
+  "references": [
+    { "path": "./tsconfig.app.json" },
+    { "path": "./tsconfig.node.json" }
+  ]
+}

package/template-apex/tsconfig.node.json

@@ -0,0 +1,31 @@
+{
+  "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/*"]
+    }
+  },
+  "include": ["vite.config.ts", "server", "shared"]
+}

package/template-apex/tsconfig.server.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ES2023",
+    "lib": ["ES2023"],
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "types": ["node"],
+    "skipLibCheck": true,
+    "strict": true,
+    "erasableSyntaxOnly": true,
+    "outDir": "./dist/server",
+    "rootDir": ".",
+    "baseUrl": ".",
+    "paths": {
+      "@shared/*": ["./shared/*"]
+    }
+  },
+  "include": ["server", "shared"]
+}

package/template-apex/vite.config.ts

@@ -0,0 +1,18 @@
+import path from 'path'
+import { defineConfig } from '@lark-apaas/coding-vite-preset'
+
+// https://vite.dev/config/
+export default defineConfig({
+  root: path.resolve(__dirname, 'client'),
+  resolve: {
+    alias: {
+      '@': path.resolve(__dirname, 'client/src'),
+      '@shared': path.resolve(__dirname, 'shared'),
+    },
+  },
+  server: {
+    proxy: {
+      '/api': 'http://localhost:3000',
+    },
+  },
+})

package/template-vite-react/README.md

@@ -21,8 +21,8 @@ client/src/
 ├── components/          # 基础 UI 组件（禁止存放业务组件）
 │   └── ui/              # shadcn/ui 内置组件（勿手动修改）
 ├── pages/               # 页面模块（每个页面一个目录）
-│   └── home/
-│       ├── index.tsx           # 页面入口
+│   └── HomePage/        # 页面目录使用 PascalCase 命名
+│       ├── HomePage.tsx        # 页面入口文件与目录同名
 │       └── components/         # 页面专属组件
 ├── hooks/               # 自定义 Hooks
 └── lib/                 # 工具函数（cn() 等）
@@ -88,17 +88,32 @@ export default function DashboardPage() {
 新增页面在 `client/src/app.tsx` 中注册：
 
 ```tsx
-<Route element={<Layout />}>
-  <Route index element={<HomePage />} />
-  <Route path="dashboard" element={<DashboardPage />} />
-  <Route path="*" element={<NotFoundPage />} />
-</Route>
+import { BrowserRouter, Routes, Route } from "react-router-dom";
+import { Layout } from "@/components/layout";
+import HomePage from "@/pages/HomePage/HomePage";
+import NotFoundPage from "@/pages/NotFoundPage/NotFoundPage";
+
+declare const __APP_BASE_PATH__: string;
+
+export default function App() {
+  return (
+    <BrowserRouter basename={__APP_BASE_PATH__}>
+      <Routes>
+        <Route element={<Layout />}>
+          <Route index element={<HomePage />} />
+          <Route path="*" element={<NotFoundPage />} />
+        </Route>
+      </Routes>
+    </BrowserRouter>
+  );
+}
 ```
 
 **新增页面步骤：**
 
-1. 在 `client/src/pages/` 下新建页面目录和 `index.tsx`
+1. 在 `client/src/pages/` 下新建页面目录（如 `DashboardPage`）和 `DashboardPage.tsx`
 2. 在 `app.tsx` 的 `<Routes>` 内添加 `<Route>` 配置
+3. **必须调整首页路由**：根据业务需求修改 `index` 路由对应的页面组件（默认的 `HomePage` 仅作为示例，实际开发时需替换为真实的业务首页）
 
 **路由跳转必须使用 react-router-dom：**
 

package/template-vite-react/client/src/app.tsx

@@ -1,7 +1,7 @@
 import { BrowserRouter, Routes, Route } from "react-router-dom";
 import { Layout } from "@/components/layout";
-import HomePage from "@/pages/home";
-import NotFoundPage from "@/pages/not-found";
+import HomePage from "@/pages/HomePage/HomePage";
+import NotFoundPage from "@/pages/NotFoundPage/NotFoundPage";
 
 declare const __APP_BASE_PATH__: string;
 

package/template-vite-react/client/src/components/layout.tsx

@@ -2,10 +2,8 @@ import { Outlet } from "react-router-dom";
 
 export function Layout() {
   return (
-    <div className="min-h-screen bg-background text-foreground">
-      <main className="container mx-auto px-4 py-8">
-        <Outlet />
-      </main>
+    <div className="w-screen h-screen">
+      <Outlet />
     </div>
   );
 }

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-vite-react/client/src/pages/{home/index.tsx → HomePage/HomePage.tsx}

@@ -5,7 +5,7 @@ export default function HomePage() {
         👋 Hello OpenClaw
       </h1>
       <p className="text-lg text-muted-foreground">
-        Start building your app by editing <code className="px-1.5 py-0.5 rounded bg-muted font-mono text-sm">client/src/pages/home/index.tsx</code>
+        Start building your app by editing <code className="px-1.5 py-0.5 rounded bg-muted font-mono text-sm">client/src/pages/HomePage/HomePage.tsx</code>
       </p>
     </div>
   );

package/template-vite-react/client/src/pages/NotFoundPage/NotFoundPage.tsx

@@ -0,0 +1,11 @@
+import { Link } from "react-router-dom";
+
+export default function NotFoundPage() {
+  return (
+    <div className="flex flex-col items-center justify-center py-24">
+      <h1 className="text-6xl font-bold mb-4">404</h1>
+      <p className="text-lg text-muted-foreground mb-8">页面不存在</p>
+      <Link to="/" className="text-primary hover:underline">返回首页</Link>
+    </div>
+  );
+}