@qlover/create-app 1.1.0 → 2.0.0

package/dist/templates/react-app/README.en.md

@@ -1,274 +0,0 @@
-# FE-React Template
-
-A modern React frontend project template integrated with multiple practical features and best practices.
-
-[中文](./README.md)
-
-## 🌟 Highlights
-
-- 🚀 Fast development experience based on Vite
-- 🎨 Theme system integrated with Tailwind CSS
-- 🌍 Complete internationalization support (Chinese and English)
-- 🔄 TypeScript-based IOC container
-- 📡 Unified API request handling
-- 🎮 Controller pattern state management
-- 📦 Package management using pnpm
-- 🧪 Built-in testing support
-
-## 🔧 Requirements
-
-- Node.js >= 16
-- pnpm >= 8.0
-
-## 📁 Project Structure
-
-```tree
-├── config/                 # Configuration files directory
-│   ├── app.router.json     # Route page configuration
-│   ├── common.ts           # Application common configuration
-│   ├── app.router.json     # Route configuration
-│   ├── i18n.ts             # Internationalization configuration
-│   └── theme.json          # Theme configuration
-├── lib/                    # Common library directory
-├── public/                 # Static assets directory
-├── src/
-│   ├── base/           # Base code
-│   ├── core/           # Core code
-│   ├── pages/          # Page components
-│   ├── services/       # Service layer
-│   └── uikit/          # UI component library
-└── vite.config.ts      # Vite configuration file
-```
-
-## 🚀 Quick Start
-
-### Install Dependencies
-
-```bash
-pnpm install
-```
-
-### Development Mode
-
-```bash
-pnpm dev
-```
-
-### Build Project
-
-```bash
-pnpm build
-```
-
-### Run Tests
-
-```bash
-# Run unit tests
-pnpm test
-
-# Run E2E tests
-pnpm test:e2e
-
-# Run E2E tests (UI mode)
-pnpm test:e2e:ui
-```
-
-## 📚 Documentation Guide
-
-The project provides detailed development documentation covering all major features and best practices:
-
-### 🚀 Getting Started
-
-- **[📖 Project Documentation](./docs/en/index.md)** - Architecture overview, core concepts, and complete documentation navigation
-- **[Development Guide](./docs/en/development-guide.md)** - 📝 Complete page development process
-
-### 🎯 Core Features
-
-- **[Bootstrap Initializer](./docs/en/bootstrap.md)** - ⚡ Application startup and initialization
-- **[IOC Container](./docs/en/ioc.md)** - 🔌 Dependency injection and UI separation
-- **[Store State Management](./docs/en/store.md)** - 📡 How the application layer notifies the UI layer
-- **[Environment Variable Management](./docs/en/env.md)** - ⚙️ Multi-environment configuration
-- **[Internationalization](./docs/en/i18n.md)** - 🌍 i18n Key and translation management
-
-### 🧪 Testing Documentation
-
-- **[Playwright E2E Testing](./docs/en/playwright/)** - 🎭 Complete end-to-end testing documentation
-  - [Overview](./docs/en/playwright/overview.md)
-  - [Quick Start](./docs/en/playwright/quickstart.md)
-  - [Testing Guide](./docs/en/playwright/testing-guide.md)
-  - [Setup Complete](./docs/en/playwright/setup-complete.md)
-- [Unit Testing Guide](./docs/en/test-guide.md) - Vitest unit testing
-
-### 📖 Additional Documentation
-
-- [Why Disable Global Variables](./docs/en/why-no-globals.md) - Global variable usage guidelines
-- [Route Management](./docs/en/router.md) - Route configuration instructions
-- [Theme System](./docs/en/theme.md) - Theme configuration and switching
-- [Request Handling](./docs/en/request.md) - API request handling
-- [TypeScript Guide](./docs/en/typescript-guide.md) - TypeScript conventions
-
-## 🔨 Core Features
-
-### IOC Container
-
-- TypeScript-based dependency injection system
-- Supports automatic service registration and dependency management
-- Provides complete type inference
-
-### Environment Configuration
-
-[Vite Environment Variables and Modes](https://cn.vite.dev/guide/env-and-mode#env-variables-and-modes)
-
-`vite dev` defaults NODE_ENV to development, it will load possible `.env[mode]` files, such as .env.local -> .env
-
-`vite build` defaults NODE_ENV to production, it will load possible `.env[mode]` files, such as .env.production -> .env
-
-Node.js NODE_ENV only supports development, production, test
-
-This is completely different from mode in vite, mode can specify different modes through `--mode` to load different env configurations
-
-For example:
-
-```bash
-vite dev --mode staging # Load .env.staging
-vite dev --mode local # Load .env.local
-```
-
-### Internationalization Support
-
-- Complete internationalization solution based on i18next
-- Supports Chinese (zh) and English (en) bilingual switching
-- Automatic internationalization resource generation based on TypeScript comments
-- URL path language detection and switching
-- Built-in language switching component
-
-### Theme System
-
-- Theme configuration based on Tailwind CSS
-- Supports dark/light mode
-- Custom design token system
-
-### API Integration
-
-The project provides a powerful API request handling mechanism based on a plugin architecture design:
-
-#### Request Controller
-
-Use `RequestController` to manage API requests uniformly:
-
-```typescript
-@injectable()
-export class RequestController extends StoreInterface<RequestControllerState> {
-  constructor(
-    @inject(FeApi) private readonly feApi: FeApi,
-    @inject(UserApi) private readonly userApi: UserApi
-  ) {
-    super(createDefaultState);
-  }
-
-  // API call example
-  async onRandomUser() {
-    if (this.state.randomUserState.loading) return;
-
-    this.setState({
-      randomUserState: { loading: true, result: null, error: null }
-    });
-
-    try {
-      const result = await this.userApi.getRandomUser();
-      this.setState({
-        randomUserState: { loading: false, result, error: null }
-      });
-    } catch (error) {
-      this.setState({
-        randomUserState: { loading: false, result: null, error }
-      });
-    }
-  }
-}
-```
-
-### Controller Pattern
-
-Provides multiple out-of-the-box controllers:
-
-- JSONStorageController
-- RequestController
-- RouterController
-- UserController
-- ThemeController
-
-## 🛠️ Development Guide
-
-### API Development Specifications
-
-1. Define interfaces in `src/base/apis`
-2. Support Mock data configuration
-
-### Adding New Pages Process
-
-1. Create page components in `src/pages`
-2. Update `config/app.router.json`
-3. Add corresponding controller (if needed)
-
-### Build Optimization
-
-The project uses Vite for building and has been optimized with the following:
-
-#### Code Splitting
-
-Automatic intelligent code splitting, dividing code into the following main chunks:
-
-- react-vendor: React core library
-- antd-core: Ant Design core components
-- antd-basic: Basic UI components
-- antd-advanced: Advanced UI components
-- utils: Utility functions
-- i18n: Internationalization related
-
-#### Build Optimization Configuration
-
-```typescript
-build: {
-  // Chunk size warning limit set to 600kb
-  chunkSizeWarningLimit: 600,
-  // Use terser for code minification
-  minify: 'terser',
-  terserOptions: {
-    compress: {
-      // Remove console output and debugger statements
-      drop_console: true,
-      drop_debugger: true,
-      // Remove specific console function calls
-      pure_funcs: ['console.log', 'console.info', 'console.debug']
-    }
-  }
-}
-```
-
-### Project Configuration
-
-#### Environment Variables
-
-- Use `@qlover/corekit-bridge/vite-env-config` to manage environment variables
-- Automatically inject application name and version information
-- Support environment variable prefix configuration
-
-#### Style Configuration
-
-- Integrated with Tailwind CSS
-- On-demand loading of Ant Design component styles
-- Support theme mode override
-
-#### Development Server
-
-```bash
-# Default port 3200, can be configured via environment variables
-VITE_SERVER_PORT=3000 pnpm dev
-```
-
-#### Test Configuration
-
-- Use Vitest for unit testing
-- Support JSDOM environment
-- Built-in test tool configuration

package/dist/templates/react-app/README.md

@@ -1,273 +0,0 @@
-# FE-React Template
-
-一个现代化的 React 前端项目模板，集成了多项实用功能和最佳实践。
-
-[English](./README.en.md)
-
-## 🌟 特性亮点
-
-- 🚀 基于 Vite 的快速开发体验
-- 🎨 集成 Tailwind CSS 的主题系统
-- 🌍 完善的国际化支持（中英文）
-- 🔄 基于 TypeScript 的 IOC 容器
-- 📡 统一的 API 请求处理
-- 🎮 控制器模式的状态管理
-- 📦 使用 pnpm 进行包管理
-- 🧪 内置测试支持
-
-## 🔧 环境要求
-
-- Node.js >= 16
-- pnpm >= 8.0
-
-## 📁 项目结构
-
-```tree
-├── config/                 # 配置文件目录
-│   ├── app.router.json     # 路由页面配置
-│   ├── common.ts           # 应用通用配置
-│   ├── app.router.json     # 路由配置
-│   ├── i18n.ts             # 国际化配置
-│   └── theme.json          # 主题配置
-├── lib/                    # 公共库目录
-├── public/                 # 静态资源目录
-├── src/
-│   ├── base/           # 基础代码
-│   ├── core/           # 核心代码
-│   ├── pages/          # 页面组件
-│   ├── services/       # 服务层
-│   └── uikit/          # UI 组件库
-└── vite.config.ts      # Vite 配置文件
-```
-
-## 🚀 快速开始
-
-### 安装依赖
-
-```bash
-pnpm install
-```
-
-### 开发模式
-
-```bash
-pnpm dev
-```
-
-### 构建项目
-
-```bash
-pnpm build
-```
-
-### 运行测试
-
-```bash
-# 运行单元测试
-pnpm test
-
-# 运行 E2E 测试
-pnpm test:e2e
-
-# 运行 E2E 测试（UI 模式）
-pnpm test:e2e:ui
-```
-
-## 📚 文档指南
-
-项目提供了详细的开发文档，涵盖了所有主要功能和最佳实践：
-
-### 🚀 快速上手
-
-- **[📖 项目文档](./docs/zh/index.md)** - 架构概览、核心理念和完整文档导航
-- **[开发指南](./docs/zh/development-guide.md)** - 📝 完整的页面开发流程
-
-### 🎯 核心功能
-
-- **[Bootstrap 启动器](./docs/zh/bootstrap.md)** - ⚡ 应用启动和初始化
-- **[IOC 容器](./docs/zh/ioc.md)** - 🔌 依赖注入和 UI 分离
-- **[Store 状态管理](./docs/zh/store.md)** - 📡 应用层如何通知 UI 层
-- **[环境变量管理](./docs/zh/env.md)** - ⚙️ 多环境配置
-- **[国际化](./docs/zh/i18n.md)** - 🌍 i18n Key 和翻译管理
-
-### 🧪 测试文档
-
-- **[Playwright E2E 测试](./docs/zh/playwright/)** - 🎭 端到端测试完整文档
-  - [快速入门](./docs/zh/playwright/quickstart.md)
-  - [详细测试指南](./docs/zh/playwright/testing-guide.md)
-  - [设置完成指南](./docs/zh/playwright/setup-complete.md)
-- [单元测试指南](./docs/zh/test-guide.md) - Vitest 单元测试
-
-### 📖 辅助文档
-
-- [为什么要禁用全局变量](./docs/zh/why-no-globals.md) - 全局变量使用规范
-- [路由管理](./docs/zh/router.md) - 路由配置说明
-- [主题系统](./docs/zh/theme.md) - 主题配置和切换
-- [请求处理](./docs/zh/request.md) - API 请求处理
-- [TypeScript 指南](./docs/zh/typescript-guide.md) - TypeScript 规范
-
-## 🔨 核心功能
-
-### IOC 容器
-
-- 基于 TypeScript 的依赖注入系统
-- 支持服务自动注册和依赖管理
-- 提供完整的类型推导
-
-### 环境配置
-
-[vite 环境变量和模式](https://cn.vite.dev/guide/env-and-mode#env-variables-and-modes)
-
-`vite dev` 默认 NODE_ENV 表示为 development, 他会加载可能的 `.env[mode]` 文件, 比如 .env.local -> .env
-
-`vite build` 默认 NODE_ENV 表示为 production, 他会加载可能的 `.env[mode]` 文件, 比如 .env.production -> .env
-
-Node.js NODE_ENV 只支持 development,production,test
-
-这个和 vite 中的 mode 是完全不一样的, mode 可以根据 `--mode` 指定不同模式，来加载不同的 env 配置
-
-比如:
-
-```bash
-vite dev --mode staging # 加载 .env.staging
-vite dev --mode local # 加载 .env.local
-```
-
-### 国际化支持
-
-- 基于 i18next 的完整国际化解决方案
-- 支持中文(zh)和英文(en)双语切换
-- 基于 TypeScript 注释的自动国际化资源生成
-- URL 路径语言检测和切换
-- 内置语言切换组件
-
-### 主题系统
-
-- 基于 Tailwind CSS 的主题配置
-- 支持暗色/亮色模式
-- 自定义设计令牌系统
-
-### API 集成
-
-项目提供了强大的 API 请求处理机制，基于插件化架构设计：
-
-#### 请求控制器
-
-使用 `RequestController` 统一管理 API 请求：
-
-```typescript
-@injectable()
-export class RequestController extends StoreInterface<RequestControllerState> {
-  constructor(
-    @inject(FeApi) private readonly feApi: FeApi,
-    @inject(UserApi) private readonly userApi: UserApi
-  ) {
-    super(createDefaultState);
-  }
-
-  // API 调用示例
-  async onRandomUser() {
-    if (this.state.randomUserState.loading) return;
-
-    this.setState({
-      randomUserState: { loading: true, result: null, error: null }
-    });
-
-    try {
-      const result = await this.userApi.getRandomUser();
-      this.setState({
-        randomUserState: { loading: false, result, error: null }
-      });
-    } catch (error) {
-      this.setState({
-        randomUserState: { loading: false, result: null, error }
-      });
-    }
-  }
-}
-```
-
-### 控制器模式
-
-提供多个开箱即用的控制器：
-
-- JSONStorageController
-- RequestController
-- RouterController
-- UserController
-- ThemeController
-
-## 🛠️ 开发指南
-
-### API 开发规范
-
-1. 在 `src/base/apis` 定义接口
-2. 支持 Mock 数据配置
-
-### 新增页面流程
-
-1. 在 `src/pages` 创建页面组件
-2. 更新 `config/app.router.json`
-3. 添加对应的控制器（如需要）
-
-### 构建优化
-
-项目使用 Vite 进行构建，并进行了以下优化：
-
-#### 代码分割
-
-自动进行智能代码分割，将代码分为以下几个主要块：
-
-- react-vendor: React 核心库
-- antd-core: Ant Design 核心组件
-- antd-basic: 基础 UI 组件
-- antd-advanced: 高级 UI 组件
-- utils: 工具函数
-- i18n: 国际化相关
-
-#### 构建优化配置
-
-```typescript
-build: {
-  // 分块大小警告限制设置为 600kb
-  chunkSizeWarningLimit: 600,
-  // 使用 terser 进行代码压缩
-  minify: 'terser',
-  terserOptions: {
-    compress: {
-      // 移除控制台输出和调试器语句
-      drop_console: true,
-      drop_debugger: true,
-      // 移除特定的控制台函数调用
-      pure_funcs: ['console.log', 'console.info', 'console.debug']
-    }
-  }
-}
-```
-
-### 项目配置
-
-#### 环境变量
-
-- 使用 `@qlover/corekit-bridge/vite-env-config` 管理环境变量
-- 自动注入应用名称和版本信息
-- 支持环境变量前缀配置
-
-#### 样式配置
-
-- 集成 Tailwind CSS
-- 按需加载 Ant Design 组件样式
-- 支持主题模式覆盖
-
-#### 开发服务器
-
-```bash
-# 默认端口 3200，可通过环境变量配置
-VITE_SERVER_PORT=3000 pnpm dev
-```
-
-#### 测试配置
-
-- 使用 Vitest 进行单元测试
-- 支持 JSDOM 环境
-- 内置测试工具配置

package/dist/templates/react-app/__tests__/__mocks__/BootstrapTest.ts

@@ -1,16 +0,0 @@
-import type { BootstrapClientArgs } from '@/core/bootstraps/BootstrapClient';
-import { BootstrapClient } from '@/core/bootstraps/BootstrapClient';
-import { testIOC } from './testIOC/TestIOC';
-
-export interface BootstrapTestArgs extends Omit<BootstrapClientArgs, 'ioc'> {
-  ioc?: BootstrapClientArgs['ioc'];
-}
-
-export class BootstrapTest {
-  public static async main(
-    args: BootstrapTestArgs
-  ): Promise<BootstrapClientArgs> {
-    const result = await BootstrapClient.main({ ...args, ioc: testIOC });
-    return result;
-  }
-}

package/dist/templates/react-app/__tests__/__mocks__/MockAppConfig.ts

@@ -1,48 +0,0 @@
-import { name, version } from '../../package.json';
-import type { EnvConfigInterface } from '@qlover/corekit-bridge';
-
-export class MockAppConfig implements EnvConfigInterface {
-  public appName = name;
-
-  public appVersion = version;
-
-  public env: string = 'test';
-
-  public userTokenStorageKey = '__fe_user_token__';
-
-  public userInfoStorageKey = '__fe_user_info__';
-
-  public openAiModels = [
-    'gpt-4o-mini',
-    'gpt-3.5-turbo',
-    'gpt-3.5-turbo-2',
-    'gpt-4',
-    'gpt-4-32k'
-  ];
-
-  public openAiBaseUrl = '';
-
-  public openAiToken = '';
-
-  public openAiTokenPrefix = '';
-
-  public openAiRequireToken = true;
-
-  public loginUser = '';
-
-  public loginPassword = '';
-
-  public feApiBaseUrl = '';
-
-  public userApiBaseUrl = '';
-
-  public aiApiBaseUrl = 'https://api.openai.com/v1';
-
-  public aiApiToken = '';
-
-  public aiApiTokenPrefix = 'Bearer';
-
-  public aiApiRequireToken = true;
-
-  public bootHref = '';
-}

package/dist/templates/react-app/__tests__/__mocks__/MockDialogHandler.ts

@@ -1,17 +0,0 @@
-import { vi } from 'vitest';
-import type { DialogHandlerOptions } from '@/base/cases/DialogHandler';
-import type { AntdStaticApiInterface } from '@brain-toolkit/antd-theme-override/react';
-import type { UIDialogInterface } from '@qlover/corekit-bridge';
-
-export class MockDialogHandler
-  implements UIDialogInterface<DialogHandlerOptions>, AntdStaticApiInterface
-{
-  public setMessage = vi.fn();
-  public setModal = vi.fn();
-  public setNotification = vi.fn();
-  public success = vi.fn();
-  public error = vi.fn();
-  public info = vi.fn();
-  public warn = vi.fn();
-  public confirm = vi.fn();
-}

package/dist/templates/react-app/__tests__/__mocks__/MockLogger.ts

@@ -1,14 +0,0 @@
-import { vi } from 'vitest';
-import type { LoggerInterface } from '@qlover/logger';
-
-export class MockLogger implements LoggerInterface {
-  public info = vi.fn();
-  public error = vi.fn();
-  public debug = vi.fn();
-  public warn = vi.fn();
-  public trace = vi.fn();
-  public log = vi.fn();
-  public fatal = vi.fn();
-  public addAppender = vi.fn();
-  public context = vi.fn();
-}

package/dist/templates/react-app/__tests__/__mocks__/components/TestApp.tsx

@@ -1,38 +0,0 @@
-import {
-  TestBootstrapsProvider,
-  type TestBootstrapsProviderProps
-} from './TestBootstrapsProvider';
-
-/**
- * TestApp - Complete test wrapper with IOC and Router
- *
- * Usage:
- * ```tsx
- * import { TestApp } from '__tests__/__mocks__/components/TestApp';
- *
- * render(
- *   <TestApp routerInitialEntries={['/en/dashboard']}>
- *     <YourComponent />
- *   </TestApp>
- * );
- * ```
- */
-export function TestApp({
-  children,
-  routerInitialEntries,
-  routerInitialIndex,
-  bootHref,
-  appConfig
-}: TestBootstrapsProviderProps) {
-  return (
-    <TestBootstrapsProvider
-      data-testid="TestApp"
-      routerInitialEntries={routerInitialEntries}
-      routerInitialIndex={routerInitialIndex}
-      bootHref={bootHref}
-      appConfig={appConfig}
-    >
-      {children}
-    </TestBootstrapsProvider>
-  );
-}