@moluoxixi/create-app 2.0.1

package/templates/common/base/src/apis/services/example.ts

@@ -0,0 +1,40 @@
+/**
+ * 示例服务
+ * 示例 API 接口
+ */
+
+import type {
+  ApiResponseType,
+  CreateExampleParamsType,
+  ExampleItemType,
+  ListResponseType,
+  PaginationParamsType,
+  UpdateExampleParamsType,
+} from '../types'
+
+import request from '../request'
+
+/** 获取示例列表 */
+export function getExampleList(params: PaginationParamsType): Promise<ListResponseType<ExampleItemType>> {
+  return request.get('/example/list', { params })
+}
+
+/** 获取示例详情 */
+export function getExampleDetail(id: string): Promise<ApiResponseType<ExampleItemType>> {
+  return request.get(`/example/${id}`)
+}
+
+/** 创建示例 */
+export function createExample(data: CreateExampleParamsType): Promise<ApiResponseType<ExampleItemType>> {
+  return request.post('/example', data)
+}
+
+/** 更新示例 */
+export function updateExample(id: string, data: UpdateExampleParamsType): Promise<ApiResponseType<ExampleItemType>> {
+  return request.put(`/example/${id}`, data)
+}
+
+/** 删除示例 */
+export function deleteExample(id: string): Promise<ApiResponseType<null>> {
+  return request.delete(`/example/${id}`)
+}

package/templates/common/base/src/apis/services/user.ts

@@ -0,0 +1,23 @@
+/**
+ * 用户服务
+ * 用户相关 API
+ */
+
+import type { ApiResponseType, LoginParamsType, LoginResponseType, UserInfoType } from '../types'
+
+import request from '../request'
+
+/** 用户登录 */
+export function login(params: LoginParamsType): Promise<ApiResponseType<LoginResponseType>> {
+  return request.post('/auth/login', params)
+}
+
+/** 获取用户信息 */
+export function getUserInfo(): Promise<ApiResponseType<UserInfoType>> {
+  return request.get('/user/info')
+}
+
+/** 用户登出 */
+export function logout(): Promise<ApiResponseType<null>> {
+  return request.post('/auth/logout')
+}

package/templates/common/base/src/apis/types/common.ts

@@ -0,0 +1,28 @@
+/**
+ * 通用类型定义
+ * API 响应通用类型
+ */
+
+/** 分页参数类型 */
+export interface PaginationParamsType {
+  page: number
+  pageSize: number
+}
+
+/** 分页响应类型 */
+export interface PaginationResponseType<T> {
+  list: T[]
+  total: number
+  page: number
+  pageSize: number
+}
+
+/** 通用响应类型 */
+export interface ApiResponseType<T = unknown> {
+  code: number
+  message: string
+  data: T
+}
+
+/** 列表响应类型 */
+export interface ListResponseType<T> extends ApiResponseType<PaginationResponseType<T>> {}

package/templates/common/base/src/apis/types/example.ts

@@ -0,0 +1,18 @@
+/**
+ * 示例类型定义
+ */
+
+/** 示例数据类型 */
+export interface ExampleItemType {
+  id: string
+  name: string
+  description: string
+  createdAt: string
+}
+
+/** 创建示例参数类型 */
+export type CreateExampleParamsType = Omit<ExampleItemType, 'id' | 'createdAt'>
+
+/** 更新示例参数类型 */
+export type UpdateExampleParamsType = Partial<ExampleItemType>
+

package/templates/common/base/src/apis/types/index.ts

@@ -0,0 +1,7 @@
+/**
+ * API 类型导出
+ */
+
+export * from './common'
+export * from './example'
+export * from './user'

package/templates/common/base/src/apis/types/user.ts

@@ -0,0 +1,24 @@
+/**
+ * 用户类型定义
+ */
+
+/** 用户信息类型 */
+export interface UserInfoType {
+  id: string
+  username: string
+  email: string
+  avatar?: string
+  roles: string[]
+}
+
+/** 登录参数类型 */
+export interface LoginParamsType {
+  username: string
+  password: string
+}
+
+/** 登录响应类型 */
+export interface LoginResponseType {
+  token: string
+  userInfo: UserInfoType
+}

package/templates/common/base/src/assets/fonts/index.css

@@ -0,0 +1,7 @@
+/**
+ * 字体配置
+ * 自定义字体导入
+ */
+
+/* 可在此添加自定义字体 */
+

package/templates/common/base/src/assets/styles/base.scss

@@ -0,0 +1,72 @@
+/**
+ * 基础样式
+ * CSS Reset 和全局基础样式
+ */
+
+*,
+*::before,
+*::after {
+  box-sizing: border-box;
+  margin: 0;
+  padding: 0;
+}
+
+html {
+  font-size: 16px;
+  line-height: 1.5;
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+}
+
+body {
+  min-height: 100vh;
+  font-family:
+    -apple-system,
+    BlinkMacSystemFont,
+    'Segoe UI',
+    Roboto,
+    'Helvetica Neue',
+    Arial,
+    sans-serif;
+}
+
+img,
+picture,
+video,
+canvas,
+svg {
+  display: block;
+  max-width: 100%;
+}
+
+input,
+button,
+textarea,
+select {
+  font: inherit;
+}
+
+p,
+h1,
+h2,
+h3,
+h4,
+h5,
+h6 {
+  overflow-wrap: break-word;
+}
+
+a {
+  color: inherit;
+  text-decoration: none;
+}
+
+ul,
+ol {
+  list-style: none;
+}
+
+#app {
+  min-height: 100vh;
+}
+

package/templates/common/base/src/assets/styles/custom.scss

@@ -0,0 +1,7 @@
+/**
+ * 自定义样式
+ * 项目特定的全局样式
+ */
+
+// 可在此添加项目特定的全局样式
+

package/templates/common/base/src/assets/styles/tailwind.scss

@@ -0,0 +1,6 @@
+/**
+ * Tailwind CSS 配置
+ */
+
+@import 'tailwindcss';
+

package/templates/common/base/src/constants/index.ts

@@ -0,0 +1,29 @@
+/**
+ * 常量定义
+ * 项目通用常量
+ */
+
+/** 本地存储键名 */
+export const STORAGE_KEYS = {
+  TOKEN: 'token',
+  USER_INFO: 'userInfo',
+  LANGUAGE: 'language',
+  THEME: 'theme',
+} as const;
+
+/** 响应码 */
+export const RESPONSE_CODE = {
+  SUCCESS: 200,
+  UNAUTHORIZED: 401,
+  FORBIDDEN: 403,
+  NOT_FOUND: 404,
+  SERVER_ERROR: 500,
+} as const;
+
+/** 分页默认配置 */
+export const PAGINATION = {
+  DEFAULT_PAGE: 1,
+  DEFAULT_PAGE_SIZE: 10,
+  PAGE_SIZE_OPTIONS: [10, 20, 50, 100],
+} as const;
+

package/templates/common/base/src/locales/lang/en.ts

@@ -0,0 +1,30 @@
+/**
+ * English Language Pack
+ */
+
+export default {
+  common: {
+    confirm: 'Confirm',
+    cancel: 'Cancel',
+    save: 'Save',
+    delete: 'Delete',
+    edit: 'Edit',
+    add: 'Add',
+    search: 'Search',
+    reset: 'Reset',
+    loading: 'Loading...',
+    success: 'Success',
+    error: 'Error',
+  },
+  menu: {
+    home: 'Home',
+    about: 'About',
+  },
+  user: {
+    login: 'Login',
+    logout: 'Logout',
+    username: 'Username',
+    password: 'Password',
+  },
+};
+

package/templates/common/base/src/locales/lang/es.ts

@@ -0,0 +1,30 @@
+/**
+ * Spanish Language Pack
+ */
+
+export default {
+  common: {
+    confirm: 'Confirmar',
+    cancel: 'Cancelar',
+    save: 'Guardar',
+    delete: 'Eliminar',
+    edit: 'Editar',
+    add: 'Agregar',
+    search: 'Buscar',
+    reset: 'Restablecer',
+    loading: 'Cargando...',
+    success: 'Éxito',
+    error: 'Error',
+  },
+  menu: {
+    home: 'Inicio',
+    about: 'Acerca de',
+  },
+  user: {
+    login: 'Iniciar sesión',
+    logout: 'Cerrar sesión',
+    username: 'Nombre de usuario',
+    password: 'Contraseña',
+  },
+};
+

package/templates/common/base/src/locales/lang/zh.ts

@@ -0,0 +1,30 @@
+/**
+ * 中文语言包
+ */
+
+export default {
+  common: {
+    confirm: '确认',
+    cancel: '取消',
+    save: '保存',
+    delete: '删除',
+    edit: '编辑',
+    add: '新增',
+    search: '搜索',
+    reset: '重置',
+    loading: '加载中...',
+    success: '操作成功',
+    error: '操作失败',
+  },
+  menu: {
+    home: '首页',
+    about: '关于',
+  },
+  user: {
+    login: '登录',
+    logout: '退出登录',
+    username: '用户名',
+    password: '密码',
+  },
+};
+

package/templates/common/base/src/utils/index.ts

@@ -0,0 +1,83 @@
+/**
+ * 工具函数
+ * 通用工具方法
+ */
+
+/**
+ * 延迟执行
+ * @param ms 延迟毫秒数
+ */
+export function sleep(ms: number): Promise<void> {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+/**
+ * 深拷贝
+ * @param obj 要拷贝的对象
+ */
+export function deepClone<T>(obj: T): T {
+  return JSON.parse(JSON.stringify(obj));
+}
+
+/**
+ * 防抖函数
+ * @param fn 要防抖的函数
+ * @param delay 延迟时间
+ */
+export function debounce<T extends (...args: unknown[]) => unknown>(
+  fn: T,
+  delay: number
+): (...args: Parameters<T>) => void {
+  let timer: ReturnType<typeof setTimeout> | null = null;
+  return function (this: unknown, ...args: Parameters<T>) {
+    if (timer) {
+      clearTimeout(timer);
+    }
+    timer = setTimeout(() => {
+      fn.apply(this, args);
+    }, delay);
+  };
+}
+
+/**
+ * 节流函数
+ * @param fn 要节流的函数
+ * @param delay 间隔时间
+ */
+export function throttle<T extends (...args: unknown[]) => unknown>(
+  fn: T,
+  delay: number
+): (...args: Parameters<T>) => void {
+  let lastTime = 0;
+  return function (this: unknown, ...args: Parameters<T>) {
+    const now = Date.now();
+    if (now - lastTime >= delay) {
+      lastTime = now;
+      fn.apply(this, args);
+    }
+  };
+}
+
+/**
+ * 格式化日期
+ * @param date 日期
+ * @param format 格式
+ */
+export function formatDate(date: Date | string | number, format = 'YYYY-MM-DD HH:mm:ss'): string {
+  const d = new Date(date);
+  const year = d.getFullYear();
+  const month = String(d.getMonth() + 1).padStart(2, '0');
+  const day = String(d.getDate()).padStart(2, '0');
+  const hours = String(d.getHours()).padStart(2, '0');
+  const minutes = String(d.getMinutes()).padStart(2, '0');
+  const seconds = String(d.getSeconds()).padStart(2, '0');
+
+  return format
+    .replace('YYYY', String(year))
+    .replace('MM', month)
+    .replace('DD', day)
+    .replace('HH', hours)
+    .replace('mm', minutes)
+    .replace('ss', seconds);
+}
+

package/templates/common/features/husky/.cz-config.cjs

@@ -0,0 +1,35 @@
+/**
+ * Commitizen 自定义配置
+ * 定义 commit 类型和提交规范
+ */
+
+module.exports = {
+  types: [
+    { value: 'feat', name: 'feat:     ✨ 新功能' },
+    { value: 'fix', name: 'fix:      🐛 修复 Bug' },
+    { value: 'docs', name: 'docs:     📝 文档更新' },
+    { value: 'style', name: 'style:    💄 代码格式（不影响功能）' },
+    { value: 'refactor', name: 'refactor: ♻️  代码重构' },
+    { value: 'perf', name: 'perf:     ⚡ 性能优化' },
+    { value: 'test', name: 'test:     ✅ 测试相关' },
+    { value: 'build', name: 'build:    📦 构建相关' },
+    { value: 'ci', name: 'ci:       🔧 CI 配置' },
+    { value: 'chore', name: 'chore:    🔨 其他修改' },
+    { value: 'revert', name: 'revert:   ⏪ 回退' },
+  ],
+  scopes: [],
+  messages: {
+    type: '请选择提交类型:',
+    scope: '请输入修改范围（可选）:',
+    customScope: '请输入自定义修改范围:',
+    subject: '请简要描述提交（必填）:',
+    body: '请输入详细描述（可选）:',
+    breaking: '列出任何破坏性变更（可选）:',
+    footer: '请输入要关闭的 issue（可选）:',
+    confirmCommit: '确认使用以上信息提交？',
+  },
+  allowCustomScopes: true,
+  allowBreakingChanges: ['feat', 'fix'],
+  skipQuestions: ['scope', 'body', 'breaking', 'footer'],
+  subjectLimit: 100,
+}

package/templates/common/features/husky/.husky/commit-msg

@@ -0,0 +1,9 @@
+#!/usr/bin/env sh
+. "$(dirname -- "$0")/_/husky.sh"
+
+COMMIT_LOCATION="${PWD}/.git/COMMIT_EDITMSG"
+if [ -f "$COMMIT_LOCATION" ]; then
+  npx --no-install commitlint --edit "${COMMIT_LOCATION}"
+else
+  npx --no-install commitlint --edit "$1"
+fi

package/templates/common/features/husky/.husky/install.mjs

@@ -0,0 +1,6 @@
+// Skip Husky install in production and CI
+if (process.env.NODE_ENV === 'production' || process.env.CI === 'true') {
+  process.exit(0)
+}
+const husky = (await import('husky')).default
+console.log(husky())

package/templates/common/features/husky/.husky/pre-commit

@@ -0,0 +1,4 @@
+#!/usr/bin/env sh
+. "$(dirname -- "$0")/_/husky.sh"
+
+pnpm lint-staged

package/templates/common/features/husky/commitlint.config.ts

@@ -0,0 +1,32 @@
+/**
+ * Commitlint 配置
+ * 验证 commit message 格式
+ */
+
+import type { UserConfig } from '@commitlint/types'
+
+const config: UserConfig = {
+  extends: ['@commitlint/config-conventional'],
+  rules: {
+    'type-enum': [
+      2,
+      'always',
+      [
+        'feat',
+        'fix',
+        'docs',
+        'style',
+        'refactor',
+        'perf',
+        'test',
+        'build',
+        'ci',
+        'chore',
+        'revert',
+      ],
+    ],
+    'subject-case': [0],
+  },
+}
+
+export default config

package/templates/common/features/husky/package.json

@@ -0,0 +1,28 @@
+{
+  "scripts": {
+    "prepare": "node .husky/install.mjs",
+    "lint-staged": "lint-staged",
+    "commit": "git add . && git-cz"
+  },
+  "lint-staged": {
+    "*.{js,jsx,ts,tsx,vue,css,scss,less}": [
+      "eslint --fix --no-warn-ignored"
+    ]
+  },
+  "config": {
+    "commitizen": {
+      "path": "cz-customizable"
+    },
+    "cz-customizable": {
+      "config": ".cz-config.cjs"
+    }
+  },
+  "devDependencies": {
+    "@commitlint/cli": "catalog:dev",
+    "@commitlint/config-conventional": "catalog:dev",
+    "commitizen": "catalog:dev",
+    "cz-customizable": "catalog:dev",
+    "husky": "catalog:dev",
+    "lint-staged": "catalog:dev"
+  }
+}

package/templates/common/features/husky/pnpm-workspace.yaml

@@ -0,0 +1,9 @@
+catalogs:
+  dev:
+    "@commitlint/cli": ^19.8.0
+    "@commitlint/config-conventional": ^19.8.0
+    commitizen: ^4.3.1
+    cz-customizable: ^7.4.0
+    husky: ^9.1.7
+    lint-staged: ^15.5.1
+

package/templates/react/base/env.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 环境变量类型声明
+ */
+
+/// <reference types="vite/client" />
+
+interface ImportMetaEnv {
+  readonly VITE_APP_CODE: string
+  readonly VITE_APP_TITLE: string
+  readonly VITE_APP_PORT: number
+  readonly VITE_APP_VERSION: string
+  readonly VITE_APP_ENV: string
+  readonly VITE_API_BASE_URL: string
+  readonly VITE_SENTRY: boolean
+}
+
+interface ImportMeta {
+  readonly env: ImportMetaEnv
+}

package/templates/react/base/index.html

@@ -0,0 +1,14 @@
+<!DOCTYPE html>
+<html lang="zh-CN">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="/favicon.ico" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>%VITE_APP_TITLE%</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>
+

package/templates/react/base/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "react-project",
+  "scripts": {
+    "type-check": "tsc --noEmit"
+  },
+  "dependencies": {
+    "react": "catalog:build",
+    "react-dom": "catalog:build"
+  },
+  "devDependencies": {
+    "@types/react": "catalog:type",
+    "@types/react-dom": "catalog:type",
+    "@vitejs/plugin-react": "catalog:dev"
+  }
+}

package/templates/react/base/pnpm-workspace.yaml

@@ -0,0 +1,9 @@
+catalogs:
+  build:
+    react: ^18.3.1
+    react-dom: ^18.3.1
+  dev:
+    "@vitejs/plugin-react": ^4.3.4
+  type:
+    "@types/react": ^18.3.12
+    "@types/react-dom": ^18.3.1

package/templates/react/base/src/App.tsx

@@ -0,0 +1,18 @@
+/**
+ * 根组件
+ */
+
+import { Route, Routes } from 'react-router-dom'
+import Home from '@/pages/home'
+import About from '@/pages/about'
+
+function App(): JSX.Element {
+  return (
+    <Routes>
+      <Route path="/" element={<Home />} />
+      <Route path="/about" element={<About />} />
+    </Routes>
+  )
+}
+
+export default App

package/templates/react/base/src/assets/styles/main.scss

@@ -0,0 +1,8 @@
+/**
+ * 主样式文件
+ * 导入所有样式
+ */
+
+@import './base.scss';
+@import './custom.scss';
+@import './tailwind.scss';