@qlover/create-app 0.4.1 → 0.4.2

package/CHANGELOG.md

@@ -1,5 +1,42 @@
 # @qlover/create-app
 
+## 0.4.2
+
+### Patch Changes
+
+#### ✨ Features
+
+- **create-app:** enhance routing and configuration with router prefix and new services ([b32795d](https://github.com/qlover/fe-base/commit/b32795d02af4234d4708a5bdcb111bf8d2a54bd6)) ([#430](https://github.com/qlover/fe-base/pull/430))
+
+  - Introduced a router prefix in the configuration to manage asset paths and API routes more effectively.
+  - Updated the application to utilize the new RouteService for routing logic, replacing the previous RouterController.
+  - Refactored user authentication handling to use UserService, improving modularity and maintainability.
+  - Added PublicAssetsPath service to manage public asset paths dynamically based on the router prefix.
+  - Updated localization files to include additional keys and ensure consistency across languages.
+  - Modified various components to integrate the new services and ensure proper routing and asset management.
+
+  This update enhances the overall structure and flexibility of the application, paving the way for future improvements.
+
+- **create-app:** enhance login and registration features with improved localization and form handling ([a3724e5](https://github.com/qlover/fe-base/commit/a3724e5e75c8708dd00684ece563d9e1c63c0d00)) ([#430](https://github.com/qlover/fe-base/pull/430))
+
+  - Updated routing configuration to include localized titles for various pages, enhancing user experience.
+  - Added new keys for login and registration in localization files for both English and Chinese.
+  - Implemented a registration form with validation and user feedback, integrating with the UserService for account creation.
+  - Enhanced the Login component to utilize localized strings for better accessibility and clarity.
+  - Refactored the I18nService to support dynamic title updates based on the current route.
+
+  This update significantly improves the user interface and experience for authentication processes within the application.
+
+- **create-app:** refactor internationalization and store management ([c86ed98](https://github.com/qlover/fe-base/commit/c86ed9818d844d4059878c11897051a6c504a333)) ([#430](https://github.com/qlover/fe-base/pull/430))
+
+  - Updated file structure for internationalization resources, moving identifiers to a new directory for better organization.
+  - Introduced new error and i18n identifier files to enhance localization support.
+  - Refactored store management by implementing a new StoreInterface, improving state management across services.
+  - Replaced deprecated useSliceStore with a new useStore hook for better integration with the updated store architecture.
+  - Enhanced README documentation to reflect changes in project structure and build optimizations.
+
+  This update significantly improves the maintainability and scalability of the application, paving the way for future enhancements.
+
 ## 0.4.1
 
 ### Patch Changes

package/dist/index.js

@@ -2378,7 +2378,7 @@ var Generator = class {
 
 // package.json
 var package_default = {
-  version: "0.4.1",
+  version: "0.4.2",
   description: "Create a new app with a single command"};
 function programArgs() {
   const program = new Command();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qlover/create-app",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "Create a new app with a single command",
   "private": false,
   "type": "module",

package/templates/react-app/.env

@@ -10,7 +10,6 @@ FE_RELEASE=false
 FE_RELEASE_ENV=production
 
 # ===== build
-VITE_PUBLIC_PATH=
 VITE_SERVER_PORT=3200
 
 # ===== app config
@@ -21,5 +20,5 @@ VITE_OPEN_AI_TOKEN=sk-proj-1234567890
 VITE_OPEN_AI_TOKEN_PREFIX=Bearer
 VITE_OPEN_AI_REQUIRE_TOKEN=true
 VITE_LOGIN_USER=admin
-VITE_LOGIN_PASSWORD=123456
+VITE_LOGIN_PASSWORD=prod-123456
 VITE_FE_API_BASE_URL=https://feapi.example.com/

package/templates/react-app/README.md

@@ -85,7 +85,7 @@ pnpm test
 项目使用 `@brain-toolkit/ts2locales` 插件从 TypeScript 注释自动生成国际化资源：
 
 ```typescript
-// config/Identifier.I18n.ts
+// config/Identifier/I18n.ts
 export const Messages = {
   /**
    * @description Home page welcome message
@@ -116,11 +116,11 @@ export default defineConfig({
       locales: i18nConfig.supportedLngs,
       options: [
         {
-          source: './config/Identifier.Error.ts',
+          source: './config/Identifier/Error.ts',
           target: './public/locales/{{lng}}/common.json'
         },
         {
-          source: './config/Identifier.I18n.ts',
+          source: './config/Identifier/I18n.ts',
           target: './public/locales/{{lng}}/common.json'
         }
       ]
@@ -147,7 +147,7 @@ await i18nService.changeLanguage('zh');
 
 ```typescript
 import { useBaseRoutePage } from '@/uikit/contexts/BaseRouteContext';
-import * as i18nKeys from '@config/Identifier.I18n';
+import * as i18nKeys from '@config/Identifier/I18n';
 
 function MyComponent() {
   const { t } = useBaseRoutePage();
@@ -181,8 +181,8 @@ function Header() {
 
 1. 国际化标识符管理：
 
-   - 在 `config/Identifier.I18n.ts` 中集中管理UI文本
-   - 在 `config/Identifier.Error.ts` 中集中管理错误信息
+   - 在 `config/Identifier/I18n.ts` 中集中管理UI文本
+   - 在 `config/Identifier/Error.ts` 中集中管理错误信息
    - 使用有意义的 key 命名（如：'page.home.title'）
 
 2. TypeScript 注释规范：
@@ -198,7 +198,7 @@ function Header() {
 
 4. 组件开发：
    - 使用 `useBaseRoutePage` hook 获取翻译函数
-   - 从 `@config/Identifier.I18n` 引入国际化 key
+   - 从 `@config/Identifier/I18n` 引入国际化 key
    - 避免硬编码文本，始终使用国际化 key
 
 ### 主题系统
@@ -217,7 +217,7 @@ function Header() {
 
 ```typescript
 @injectable()
-export class RequestController extends SliceStore<RequestControllerState> {
+export class RequestController extends StoreInterface<RequestControllerState> {
   constructor(
     @inject(FeApi) private readonly feApi: FeApi,
     @inject(UserApi) private readonly userApi: UserApi
@@ -375,3 +375,65 @@ const response = await api.request({
 1. 在 `public/locales` 添加翻译文件
 2. 使用 `useTranslation` hook 进行调用
 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/templates/react-app/config/app.router.json

@@ -19,7 +19,7 @@
             "index": true,
             "element": "base/Home",
             "meta": {
-              "title": "fe-utils/home",
+              "title": "page.home.title",
               "icon": "home",
               "localNamespace": "common"
             }
@@ -28,7 +28,7 @@
             "path": "about",
             "element": "base/About",
             "meta": {
-              "title": "关于",
+              "title": "page.about.title",
               "icon": "info",
               "localNamespace": "common"
             }
@@ -37,7 +37,7 @@
             "path": "jsonStorage",
             "element": "base/JSONStorage",
             "meta": {
-              "title": "FE-Utils JSONStorage",
+              "title": "page.jsonstorage.title",
               "icon": "info",
               "localNamespace": "common"
             }
@@ -46,7 +46,7 @@
             "path": "request",
             "element": "base/Request",
             "meta": {
-              "title": "FE-Utils Request",
+              "title": "page.request.title",
               "icon": "info",
               "localNamespace": "common"
             }
@@ -55,7 +55,7 @@
             "path": "executor",
             "element": "base/Executor",
             "meta": {
-              "title": "FE-Utils Executor",
+              "title": "page.executor.title",
               "icon": "info",
               "localNamespace": "common"
             }
@@ -64,7 +64,7 @@
             "path": "errorIdentifier",
             "element": "base/ErrorIdentifier",
             "meta": {
-              "title": "FE-Utils ErrorIdentifier",
+              "title": "page.error_identifier.title",
               "icon": "info",
               "localNamespace": "common"
             }
@@ -74,7 +74,7 @@
             "element": "404",
             "meta": {
               "category": "common",
-              "title": "404",
+              "title": "page.404.title",
               "layout": "blank",
               "localNamespace": "common"
             }
@@ -84,7 +84,7 @@
             "element": "500",
             "meta": {
               "category": "common",
-              "title": "500",
+              "title": "page.500.title",
               "layout": "blank",
               "localNamespace": "common"
             }
@@ -107,7 +107,7 @@
             "path": "login",
             "element": "auth/Login",
             "meta": {
-              "title": "登录",
+              "title": "page.login.title",
               "icon": "info",
               "localNamespace": "common"
             }
@@ -116,7 +116,7 @@
             "path": "register",
             "element": "auth/Register",
             "meta": {
-              "title": "注册",
+              "title": "page.register.title",
               "icon": "info",
               "localNamespace": "common"
             }
@@ -129,7 +129,7 @@
         "element": "404",
         "meta": {
           "category": "common",
-          "title": "404",
+          "title": "page.404.title",
           "layout": "blank",
           "localNamespace": "common"
         }
@@ -139,7 +139,7 @@
         "element": "500",
         "meta": {
           "category": "common",
-          "title": "500",
+          "title": "page.500.title",
           "layout": "blank",
           "localNamespace": "common"
         }
@@ -149,7 +149,7 @@
         "element": "404",
         "meta": {
           "category": "common",
-          "title": "404",
+          "title": "page.404.title",
           "layout": "blank",
           "localNamespace": "common"
         }

package/templates/react-app/config/common.ts

@@ -29,3 +29,11 @@ export const loggerStyles = {
   trace: { color: '#808080' },
   log: { color: '#000000' }
 };
+
+/**
+ * 路由前缀
+ *
+ * - 需要以 / 开头
+ * - 但是不能只有 /
+ */
+export const routerPrefix = '/router-root';

package/templates/react-app/config/i18n.ts

@@ -1,3 +1,5 @@
+import { routerPrefix } from './common';
+
 export default {
   fallbackLng: 'en',
   debug: false,
@@ -7,7 +9,7 @@ export default {
   ns: ['common'],
   defaultNS: 'common',
   backend: {
-    loadPath: '/locales/{{lng}}/{{ns}}.json'
+    loadPath: routerPrefix + '/locales/{{lng}}/{{ns}}.json'
   },
   supportedLngs: ['en', 'zh']
 } as const;

package/templates/react-app/config/{Identifier.I18n.ts → identifier/I18n.ts}

@@ -152,6 +152,20 @@ export const LOGIN_PASSWORD = 'login.password';
  */
 export const LOGIN_BUTTON = 'login.login';
 
+/**
+ * @description Login page description
+ * @localZh 欢迎来到未来学习
+ * @localEn Welcome to the future of learning
+ */
+export const LOGIN_WELCOME = 'login.welcome';
+
+/**
+ * @description Login page description
+ * @localZh 解锁个性化 AI 驱动的学习体验，加速您的知识旅程。
+ * @localEn Unlock personalized AI-powered learning experiences designed to accelerate your knowledge journey.
+ */
+export const LOGIN_SUBTITLE = 'login.subtitle';
+
 /**
  * @description Request timeout message
  * @localZh 请求超时
@@ -367,7 +381,7 @@ export const PAGE_EXECUTOR_TITLE = 'page.executor.title';
  * @localZh 错误标识符
  * @localEn Error Identifier
  */
-export const PAGE_ERROR_IDENTIFIER_TITLE = 'page.error.identifier.title';
+export const PAGE_ERROR_IDENTIFIER_TITLE = 'page.error_identifier.title';
 
 /**
  * @description Error Identifier page description
@@ -847,8 +861,8 @@ export const PAGE_ERROR_IDENTIFIER_MAIN_TITLE =
 
 /**
  * @description ErrorIdentifier page description
- * @localZh 来自 '@config/Identifier.Error' 的标识符
- * @localEn Identifier From: '@config/Identifier.Error'
+ * @localZh 来自 '@config/Identifier/Error' 的标识符
+ * @localEn Identifier From: '@config/Identifier/Error'
  */
 export const PAGE_ERROR_IDENTIFIER_SOURCE_DESCRIPTION =
   'page.error.identifier.source_description';
@@ -1046,3 +1060,307 @@ export const COMMON_OK = 'common.ok';
  * @Codebase
  */
 export const COMMON_CANCEL = 'common.cancel';
+
+/**
+ * @description Login page forgot password text
+ * @localZh 忘记密码？
+ * @localEn Forgot your password?
+ */
+export const LOGIN_FORGOT_PASSWORD = 'login.forgot_password';
+
+/**
+ * @description Login page continue with text
+ * @localZh 或继续使用
+ * @localEn or continue with
+ */
+export const LOGIN_CONTINUE_WITH = 'login.continue_with';
+
+/**
+ * @description Login with Google button text
+ * @localZh 使用 Google 登录
+ * @localEn Sign in with Google
+ */
+export const LOGIN_WITH_GOOGLE = 'login.with_google';
+
+/**
+ * @description Login page no account text
+ * @localZh 还没有账号？
+ * @localEn Don't have an account?
+ */
+export const LOGIN_NO_ACCOUNT = 'login.no_account';
+
+/**
+ * @description Login page create account link text
+ * @localZh 在此创建
+ * @localEn Create one here
+ */
+export const LOGIN_CREATE_ACCOUNT = 'login.create_account';
+
+/**
+ * @description Login page email validation message
+ * @localZh 请输入您的邮箱！
+ * @localEn Please input your email!
+ */
+export const LOGIN_EMAIL_REQUIRED = 'login.email_required';
+
+/**
+ * @description Login page password validation message
+ * @localZh 请输入您的密码！
+ * @localEn Please input your password!
+ */
+export const LOGIN_PASSWORD_REQUIRED = 'login.password_required';
+
+/**
+ * @description Login page feature item - AI learning paths
+ * @localZh AI驱动的个性化学习路径
+ * @localEn AI-powered personalized learning paths
+ */
+export const LOGIN_FEATURE_AI_PATHS = 'login.feature.ai_paths';
+
+/**
+ * @description Login page feature item - Smart recommendations
+ * @localZh 智能内容推荐
+ * @localEn Smart content recommendations
+ */
+export const LOGIN_FEATURE_SMART_RECOMMENDATIONS =
+  'login.feature.smart_recommendations';
+
+/**
+ * @description Login page feature item - Progress tracking
+ * @localZh 实时进度追踪
+ * @localEn Real-time progress tracking
+ */
+export const LOGIN_FEATURE_PROGRESS_TRACKING =
+  'login.feature.progress_tracking';
+
+/**
+ * @description Login page email input title
+ * @localZh 输入邮箱
+ * @localEn Enter email
+ */
+export const LOGIN_EMAIL_TITLE = 'login.email.title';
+
+/**
+ * @description Login page password input title
+ * @localZh 输入密码
+ * @localEn Enter password
+ */
+export const LOGIN_PASSWORD_TITLE = 'login.password.title';
+
+/**
+ * @description Login page forgot password link title
+ * @localZh 重置密码
+ * @localEn Reset password
+ */
+export const LOGIN_FORGOT_PASSWORD_TITLE = 'login.forgot_password.title';
+
+/**
+ * @description Login page submit button title
+ * @localZh 登录账号
+ * @localEn Sign in to account
+ */
+export const LOGIN_BUTTON_TITLE = 'login.button.title';
+
+/**
+ * @description Login page Google sign in button title
+ * @localZh 使用Google账号登录
+ * @localEn Sign in with Google account
+ */
+export const LOGIN_WITH_GOOGLE_TITLE = 'login.with_google.title';
+
+/**
+ * @description Login page create account link title
+ * @localZh 创建新账号
+ * @localEn Create new account
+ */
+export const LOGIN_CREATE_ACCOUNT_TITLE = 'login.create_account.title';
+
+/**
+ * @description Register page title
+ * @localZh 创建账号
+ * @localEn Create Account
+ */
+export const REGISTER_TITLE = 'register.title';
+
+/**
+ * @description Register page subtitle
+ * @localZh 开始您的学习之旅
+ * @localEn Start your learning journey
+ */
+export const REGISTER_SUBTITLE = 'register.subtitle';
+
+/**
+ * @description Register page username field
+ * @localZh 用户名
+ * @localEn Username
+ */
+export const REGISTER_USERNAME = 'register.username';
+
+/**
+ * @description Register page username required message
+ * @localZh 请输入用户名！
+ * @localEn Please input your username!
+ */
+export const REGISTER_USERNAME_REQUIRED = 'register.username_required';
+
+/**
+ * @description Register page email field
+ * @localZh 邮箱
+ * @localEn Email
+ */
+export const REGISTER_EMAIL = 'register.email';
+
+/**
+ * @description Register page email required message
+ * @localZh 请输入邮箱！
+ * @localEn Please input your email!
+ */
+export const REGISTER_EMAIL_REQUIRED = 'register.email_required';
+
+/**
+ * @description Register page password field
+ * @localZh 密码
+ * @localEn Password
+ */
+export const REGISTER_PASSWORD = 'register.password';
+
+/**
+ * @description Register page password required message
+ * @localZh 请输入密码！
+ * @localEn Please input your password!
+ */
+export const REGISTER_PASSWORD_REQUIRED = 'register.password_required';
+
+/**
+ * @description Register page confirm password field
+ * @localZh 确认密码
+ * @localEn Confirm Password
+ */
+export const REGISTER_CONFIRM_PASSWORD = 'register.confirm_password';
+
+/**
+ * @description Register page confirm password required message
+ * @localZh 请确认密码！
+ * @localEn Please confirm your password!
+ */
+export const REGISTER_CONFIRM_PASSWORD_REQUIRED =
+  'register.confirm_password_required';
+
+/**
+ * @description Register page passwords don't match message
+ * @localZh 两次输入的密码不匹配！
+ * @localEn The passwords you entered don't match!
+ */
+export const REGISTER_PASSWORD_MISMATCH = 'register.password_mismatch';
+
+/**
+ * @description Register page submit button
+ * @localZh 注册
+ * @localEn Register
+ */
+export const REGISTER_BUTTON = 'register.button';
+
+/**
+ * @description Register page terms and conditions text
+ * @localZh 注册即表示您同意我们的
+ * @localEn By registering, you agree to our
+ */
+export const REGISTER_TERMS_PREFIX = 'register.terms_prefix';
+
+/**
+ * @description Register page terms and conditions link
+ * @localZh 服务条款
+ * @localEn Terms of Service
+ */
+export const REGISTER_TERMS_LINK = 'register.terms_link';
+
+/**
+ * @description Register page privacy policy text
+ * @localZh 和
+ * @localEn and
+ */
+export const REGISTER_TERMS_AND = 'register.terms_and';
+
+/**
+ * @description Register page privacy policy link
+ * @localZh 隐私政策
+ * @localEn Privacy Policy
+ */
+export const REGISTER_PRIVACY_LINK = 'register.privacy_link';
+
+/**
+ * @description Register page have account text
+ * @localZh 已有账号？
+ * @localEn Already have an account?
+ */
+export const REGISTER_HAVE_ACCOUNT = 'register.have_account';
+
+/**
+ * @description Register page login link
+ * @localZh 登录
+ * @localEn Sign in
+ */
+export const REGISTER_LOGIN_LINK = 'register.login_link';
+
+/**
+ * @description Register page feature item - Personalized Learning
+ * @localZh 个性化学习体验
+ * @localEn Personalized Learning Experience
+ */
+export const REGISTER_FEATURE_PERSONALIZED = 'register.feature.personalized';
+
+/**
+ * @description Register page feature item - Expert Support
+ * @localZh 专家支持和指导
+ * @localEn Expert Support and Guidance
+ */
+export const REGISTER_FEATURE_SUPPORT = 'register.feature.support';
+
+/**
+ * @description Register page feature item - Learning Community
+ * @localZh 活跃的学习社区
+ * @localEn Active Learning Community
+ */
+export const REGISTER_FEATURE_COMMUNITY = 'register.feature.community';
+
+/**
+ * @description Register page terms agreement required message
+ * @localZh 请同意服务条款和隐私政策
+ * @localEn Please agree to the Terms of Service and Privacy Policy
+ */
+export const REGISTER_TERMS_REQUIRED = 'register.terms_required';
+
+/**
+ * @description Home page title
+ * @localZh 首页
+ * @localEn Home
+ */
+export const PAGE_HOME_TITLE = 'page.home.title';
+
+/**
+ * @description 404 page title
+ * @localZh 404 - 页面未找到
+ * @localEn 404 - Page Not Found
+ */
+export const PAGE_404_TITLE = 'page.404.title';
+
+/**
+ * @description 500 page title
+ * @localZh 500 - 服务器错误
+ * @localEn 500 - Server Error
+ */
+export const PAGE_500_TITLE = 'page.500.title';
+
+/**
+ * @description Login page title
+ * @localZh 登录
+ * @localEn Login
+ */
+export const PAGE_LOGIN_TITLE = 'page.login.title';
+
+/**
+ * @description Register page title
+ * @localZh 注册
+ * @localEn Register
+ */
+export const PAGE_REGISTER_TITLE = 'page.register.title';