@qlover/create-app 0.10.1 → 0.10.3

package/dist/templates/react-app/docs/zh/components/chat-message-refactor.md

@@ -11,12 +11,14 @@
 **文件：** `src/uikit/components/chatMessage/ChatRoot.tsx`
 
 **改动：**
+
 - 移除了内部的 `ChatMessageStore`、`MessageApi` 和 `ChatMessageBridge` 创建逻辑
 - 改为接收 `bridge` 和 `tt`（国际化对象）作为 props
 - 添加了 `ChatRootProps` 接口定义
 - 移除了内部的 `useI18nInterface` 调用
 
 **改造前：**
+
 ```typescript
 export function ChatRoot() {
   const messagesStore = useFactory(ChatMessageStore<string>);
@@ -29,7 +31,7 @@ export function ChatRoot() {
       gatewayOptions: { stream: true }
     }).use(new ChatSenderStrategy(SendFailureStrategy.KEEP_FAILED, logger));
   });
-  
+
   return (
     <div data-testid="ChatRoot">
       <MessagesList bridge={bridge} />
@@ -40,6 +42,7 @@ export function ChatRoot() {
 ```
 
 **改造后：**
+
 ```typescript
 export interface ChatRootProps {
   bridge: ChatMessageBridge<string>;
@@ -61,12 +64,14 @@ export function ChatRoot({ bridge, tt }: ChatRootProps) {
 **文件：** `src/pages/base/MessagePage.tsx`
 
 **改动：**
+
 - 在 MessagePage 中使用 `useI18nInterface` 获取国际化对象 `tt`
 - 在 MessagePage 中创建 `ChatMessageStore`、`MessageApi` 和 `ChatMessageBridge`
 - 将 `bridge` 和 `tt` 通过 props 传递给 `ChatRoot` 组件
 - 同时集成了 `MessageBaseList` 组件
 
 **实现：**
+
 ```typescript
 import { useFactory } from '@brain-toolkit/react-kit';
 import { chatMessageI18n } from '@config/i18n/chatMessageI18n';
@@ -112,11 +117,13 @@ export default function MessagePage() {
 ### 3. 子组件改造（MessagesList、FocusBar、MessageItem）
 
 **改动：**
+
 - 移除了所有子组件内部的 `useI18nInterface` 调用
 - 改为通过 props 接收 `tt` 参数
 - 更新了各组件的 Props 接口定义
 
 **示例 - MessagesList：**
+
 ```typescript
 // 改造前
 export function MessagesList({ bridge, ... }: MessagesListProps) {
@@ -139,37 +146,44 @@ export function MessagesList({ bridge, tt, ... }: MessagesListProps) {
 ### 4. 删除独立的 ChatMessagePage
 
 **删除的文件：**
+
 - `src/pages/base/ChatMessagePage.tsx`
 - `config/Identifier/pages/page.chat.ts`
 - `config/i18n/chatI18n.ts`
 
 **更新的文件：**
+
 - `config/app.router.ts` - 移除了 `/chat` 路由配置
 - `config/Identifier/pages/index.ts` - 移除了 `page.chat` 导出
 
 ## 重构优势
 
 ### 1. 提高组件复用性
+
 - `ChatRoot` 现在是一个纯展示组件，可以在任何地方使用
 - `bridge` 和 `tt` 的创建和配置由父组件控制，更加灵活
 - 父组件可以自定义国际化内容，支持不同语言环境
 
 ### 2. 简化路由结构
+
 - 减少了不必要的路由层级
 - 将聊天功能直接集成到消息页面中，符合业务逻辑
 
 ### 3. 更好的关注点分离
+
 - `ChatRoot` 及其子组件只关注 UI 展示
 - 业务逻辑（store、api、bridge）在页面层管理
 - 国际化配置在页面层统一管理
 - 更容易测试和维护
 
 ### 4. 减少样板代码
+
 - 不需要为聊天功能创建单独的页面
 - 不需要为页面创建单独的 i18n 配置
 - 子组件不需要重复调用 `useI18nInterface`
 
 ### 5. 提升性能
+
 - 减少了 hook 调用次数（多个子组件共享同一个 `tt` 对象）
 - 避免了重复的国际化配置解析
 
@@ -197,7 +211,7 @@ import { MessageApi } from '@/uikit/components/chatMessage/MessageApi';
 function MyCustomChatPage() {
   // 获取国际化对象
   const tt = useI18nInterface(chatMessageI18n);
-  
+
   const messagesStore = useFactory(ChatMessageStore<string>);
   const messageApi = useFactory(MessageApi, messagesStore);
 
@@ -206,7 +220,7 @@ function MyCustomChatPage() {
       gateway: messageApi,
       logger: logger,
       senderName: 'MyCustomSender',
-      gatewayOptions: { 
+      gatewayOptions: {
         stream: true,
         // 可以自定义其他选项
       }
@@ -241,7 +255,7 @@ const customI18n: ChatMessageI18nInterface = {
 function MyCustomChatPage() {
   const tt = useI18nInterface(customI18n);
   // ... 其他逻辑
-  
+
   return <ChatRoot bridge={bridge} tt={tt} />;
 }
 ```
@@ -267,4 +281,3 @@ function MyCustomChatPage() {
 - [ChatMessage 组件文档](./chat-message-component.md)
 - [MessagePage 简化说明](./message-page-简化说明.md)
 - [开发指南](./development-guide.md)
-

package/dist/templates/react-app/docs/zh/components/message-base-list-component.md

@@ -52,17 +52,17 @@ export default function MessagePage() {
 
 ### 支持的文本
 
-| 文本项 | 中文 | 英文 |
-|--------|------|------|
-| 标题 | 消息网关测试 | Message Gateway Test |
-| 描述 | 发送消息并等待网关响应 | Send messages and wait for gateway response |
-| 空状态 | 暂无消息 | No messages yet |
-| 用户标签 | 你 | You |
-| 网关标签 | 网关 | Gateway |
-| 处理中 | 处理中... | Processing... |
-| 失败标签 | 网关（失败） | Gateway (Failed) |
-| 网关响应 | 网关响应 | Gateway Response |
-| 发送按钮 | 发送 | Send |
+| 文本项   | 中文                   | 英文                                        |
+| -------- | ---------------------- | ------------------------------------------- |
+| 标题     | 消息网关测试           | Message Gateway Test                        |
+| 描述     | 发送消息并等待网关响应 | Send messages and wait for gateway response |
+| 空状态   | 暂无消息               | No messages yet                             |
+| 用户标签 | 你                     | You                                         |
+| 网关标签 | 网关                   | Gateway                                     |
+| 处理中   | 处理中...              | Processing...                               |
+| 失败标签 | 网关（失败）           | Gateway (Failed)                            |
+| 网关响应 | 网关响应               | Gateway Response                            |
+| 发送按钮 | 发送                   | Send                                        |
 
 ## 🧪 测试功能
 
@@ -169,4 +169,3 @@ UI 自动更新显示
 ## 🎉 总结
 
 `MessageBaseList` 是一个功能完整、样式美观的消息组件，完全支持国际化，适合用于测试和展示消息网关功能。
-

package/dist/templates/react-app/docs/zh/request.md

@@ -158,9 +158,7 @@ apiAdapter.usePlugin(new ApiMockPlugin(mockDataJson, logger));
 
 ```typescript
 @injectable()
-export class RequestLogger
-  implements ExecutorPlugin<RequestAdapterFetchConfig>
-{
+export class RequestLogger implements ExecutorPlugin<RequestAdapterFetchConfig> {
   readonly pluginName = 'RequestLogger';
 
   onBefore(context) {

package/dist/templates/react-app/eslint.config.mjs

@@ -4,10 +4,9 @@ import { FlatCompat } from '@eslint/eslintrc';
 import importPlugin from 'eslint-plugin-import';
 import prettierPlugin from 'eslint-plugin-prettier';
 import unusedImports from 'eslint-plugin-unused-imports';
-import qloverEslint from '@qlover/eslint-plugin';
+import qloverEslint, { restrictSpecificGlobals } from '@qlover/eslint-plugin';
 import tseslint from 'typescript-eslint';
 import globals from 'globals';
-import { restrictSpecificGlobals } from './makes/eslint-utils.mjs';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
@@ -80,7 +79,7 @@ const eslintConfig = [
       'jest.config.*',
       'babel.config.*',
       'playwright.config.*',
-      
+
       // static assets
       'public/**',
       '**/*.min.js',
@@ -116,8 +115,14 @@ const eslintConfig = [
     },
     rules: {
       '@qlover-eslint/ts-class-method-return': 'error',
-      '@qlover-eslint/require-root-testid': 'error',
-      // 禁用 import 路径解析检查，TypeScript 编译器会处理
+      '@qlover-eslint/ts-class-member-accessibility': 'error',
+      '@qlover-eslint/ts-class-override': 'error',
+      '@qlover-eslint/require-root-testid': [
+        'error',
+        {
+          exclude: ['/Provider$/']
+        }
+      ], // 禁用 import 路径解析检查，TypeScript 编译器会处理
       'import/no-unresolved': 'off',
       // 禁用原始的 no-unused-vars，使用 unused-imports 的规则替代
       '@typescript-eslint/no-unused-vars': 'off',

package/dist/templates/react-app/src/App.tsx

@@ -24,7 +24,7 @@ const allPages = (function getAllPages() {
 
 function App() {
   return (
-    <BootstrapsProvider data-testid="App">
+    <BootstrapsProvider>
       <ComboProvider themeConfig={themeConfig}>
         <AppRouterProvider pages={allPages} />
       </ComboProvider>

package/dist/templates/react-app/src/base/apis/feApi/FeApi.ts

@@ -10,9 +10,9 @@ export class FeApi extends RequestScheduler<FeApiConfig> {
     super(adapter);
   }
 
-  stop(_config: FeApiConfig): void {}
+  public stop(_config: FeApiConfig): void {}
 
-  async getIpInfo(): Promise<FeApiGetIpInfo['response']> {
+  public async getIpInfo(): Promise<FeApiGetIpInfo['response']> {
     return this.get('http://ip-api.com/json/') as unknown as Promise<
       FeApiGetIpInfo['response']
     >;

package/dist/templates/react-app/src/base/apis/feApi/FeApiBootstarp.ts

@@ -23,8 +23,7 @@ import type {
  * extends:
  */
 export interface FeApiConfig<Request = unknown>
-  extends RequestAdapterConfig<Request>,
-    ApiMockPluginConfig {}
+  extends RequestAdapterConfig<Request>, ApiMockPluginConfig {}
 
 /**
  * FeApiResponse
@@ -35,8 +34,10 @@ export interface FeApiConfig<Request = unknown>
  * extends:
  * - RequestAdapterResponse<Request, Response>
  */
-export interface FeApiResponse<Request = unknown, Response = unknown>
-  extends RequestAdapterResponse<Request, Response> {}
+export interface FeApiResponse<
+  Request = unknown,
+  Response = unknown
+> extends RequestAdapterResponse<Request, Response> {}
 
 /**
  * FeApi common transaction
@@ -45,18 +46,20 @@ export interface FeApiResponse<Request = unknown, Response = unknown>
  *
  * add data property
  */
-export interface FeApiTransaction<Request = unknown, Response = unknown>
-  extends RequestTransactionInterface<
-    FeApiConfig<Request>,
-    FeApiResponse<Request, Response>['data']
-  > {
+export interface FeApiTransaction<
+  Request = unknown,
+  Response = unknown
+> extends RequestTransactionInterface<
+  FeApiConfig<Request>,
+  FeApiResponse<Request, Response>['data']
+> {
   data: FeApiConfig<Request>['data'];
 }
 
 export class FeApiBootstarp implements BootstrapExecutorPlugin {
-  readonly pluginName = 'FeApiBootstarp';
+  public readonly pluginName = 'FeApiBootstarp';
 
-  onBefore({ parameters: { ioc } }: BootstrapContext): void {
+  public onBefore({ parameters: { ioc } }: BootstrapContext): void {
     ioc
       .get<FeApi>(FeApi)
       .usePlugin(new FetchURLPlugin())

package/dist/templates/react-app/src/base/apis/userApi/UserApi.ts

@@ -43,23 +43,22 @@ export class UserApi
     super(adapter);
   }
 
-  getStore(): UserAuthStoreInterface<UserInfo> | null {
+  public getStore(): UserAuthStoreInterface<UserInfo> | null {
     return this.store;
   }
 
   /**
-   * @override
    * @param store
    */
-  setStore(store: UserAuthStoreInterface<UserInfo>): void {
+  public setStore(store: UserAuthStoreInterface<UserInfo>): void {
     this.store = store;
   }
 
-  stop(request: UserApiConfig): Promise<void> | void {
+  public stop(request: UserApiConfig): Promise<void> | void {
     this.abortPlugin.abort(request);
   }
 
-  async getRandomUser(): Promise<GetIpInfoTransaction['response']> {
+  public async getRandomUser(): Promise<GetIpInfoTransaction['response']> {
     return this.request<GetIpInfoTransaction>({
       url: 'https://randomuser.me/api/',
       method: 'GET',
@@ -67,7 +66,7 @@ export class UserApi
     });
   }
 
-  async testApiCatchResult(): Promise<
+  public async testApiCatchResult(): Promise<
     UserApiTestApiCatchResultTransaction['response']
   > {
     return this.request<UserApiTestApiCatchResultTransaction>({
@@ -79,11 +78,10 @@ export class UserApi
   }
 
   /**
-   * @override
    * @param params
    * @returns
    */
-  async login(
+  public async login(
     params: UserApiLoginTransaction['data']
   ): Promise<UserCredential> {
     const response = await this.post<UserApiLoginTransaction>(
@@ -103,11 +101,10 @@ export class UserApi
   }
 
   /**
-   * @override
    * @param params
    * @returns
    */
-  register(
+  public register(
     params: UserApiRegisterTransaction['data']
   ): Promise<UserApiRegisterTransaction['response']['data']> {
     // @ts-expect-error - TODO: implement
@@ -115,26 +112,23 @@ export class UserApi
   }
 
   /**
-   * @override
    * @returns
    */
-  async refreshUserInfo(): Promise<UserInfo> {
+  public async refreshUserInfo(): Promise<UserInfo> {
     return this.getUserInfo();
   }
 
   /**
-   * @override
    * @returns
    */
-  logout(): Promise<any> {
+  public logout(): Promise<any> {
     return this.post('/api/logout');
   }
 
   /**
-   * @override
    * @returns
    */
-  async getUserInfo(_credential?: UserCredential): Promise<UserInfo> {
+  public async getUserInfo(_credential?: UserCredential): Promise<UserInfo> {
     const response =
       await this.get<UserApiGetUserInfoTransaction>('/api/userinfo');
 

package/dist/templates/react-app/src/base/apis/userApi/UserApiBootstarp.ts

@@ -27,7 +27,8 @@ import type {
  * - ApiCatchPluginConfig
  */
 export interface UserApiConfig<Request = unknown>
-  extends RequestAdapterConfig<Request>,
+  extends
+    RequestAdapterConfig<Request>,
     ApiMockPluginOptions,
     ApiCatchPluginConfig {}
 
@@ -41,8 +42,7 @@ export interface UserApiConfig<Request = unknown>
  * - RequestAdapterResponse<Request, Response>
  */
 export interface UserApiResponse<Request = unknown, Response = unknown>
-  extends RequestAdapterResponse<Request, Response>,
-    ApiCatchPluginResponse {}
+  extends RequestAdapterResponse<Request, Response>, ApiCatchPluginResponse {}
 
 /**
  * UserApi common transaction
@@ -51,18 +51,20 @@ export interface UserApiResponse<Request = unknown, Response = unknown>
  *
  * add data property
  */
-export interface UserApiTransaction<Request = unknown, Response = unknown>
-  extends RequestTransactionInterface<
-    UserApiConfig<Request>,
-    UserApiResponse<Request, Response>
-  > {
+export interface UserApiTransaction<
+  Request = unknown,
+  Response = unknown
+> extends RequestTransactionInterface<
+  UserApiConfig<Request>,
+  UserApiResponse<Request, Response>
+> {
   data: UserApiConfig<Request>['data'];
 }
 
 export class UserApiBootstarp implements BootstrapExecutorPlugin {
-  readonly pluginName = 'UserApiBootstarp';
+  public readonly pluginName = 'UserApiBootstarp';
 
-  onBefore({ parameters: { ioc } }: BootstrapContext): void {
+  public onBefore({ parameters: { ioc } }: BootstrapContext): void {
     ioc
       .get<UserApi>(UserApi)
       .usePlugin(new FetchURLPlugin())

package/dist/templates/react-app/src/base/cases/AppConfig.ts

@@ -43,31 +43,31 @@ export class AppConfig implements EnvConfigInterface {
    * Application name identifier
    * @description Injected from VITE_APP_NAME environment variable
    */
-  readonly appName = '';
+  public readonly appName = '';
 
   /**
    * Current version of the application
    * @description Injected from VITE_APP_VERSION environment variable
    */
-  readonly appVersion = '';
+  public readonly appVersion = '';
 
   /**
    * Storage key for user authentication token
    * @description Injected from VITE_USER_TOKEN_STORAGE_KEY environment variable
    */
-  readonly userTokenStorageKey = '__fe_user_token__';
+  public readonly userTokenStorageKey = '__fe_user_token__';
 
   /**
    * Storage key for user information
    * @description Injected from VITE_USER_INFO_STORAGE_KEY environment variable
    */
-  readonly userInfoStorageKey = '__fe_user_info__';
+  public readonly userInfoStorageKey = '__fe_user_info__';
 
   /**
    * Available OpenAI model configurations
    * @description List of supported OpenAI models for the application
    */
-  readonly openAiModels = [
+  public readonly openAiModels = [
     'gpt-4o-mini',
     'gpt-3.5-turbo',
     'gpt-3.5-turbo-2',
@@ -76,48 +76,48 @@ export class AppConfig implements EnvConfigInterface {
   ];
 
   /** Base URL for OpenAI API endpoints */
-  readonly openAiBaseUrl = '';
+  public readonly openAiBaseUrl = '';
 
   /** Authentication token for OpenAI API */
-  readonly openAiToken = '';
+  public readonly openAiToken = '';
 
   /** Prefix for OpenAI authentication token */
-  readonly openAiTokenPrefix = '';
+  public readonly openAiTokenPrefix = '';
 
   /** Flag indicating if OpenAI token is required */
-  readonly openAiRequireToken = true;
+  public readonly openAiRequireToken = true;
 
   /** Default login username */
-  readonly loginUser = '';
+  public readonly loginUser = '';
 
   /** Default login password */
-  readonly loginPassword = '';
+  public readonly loginPassword = '';
 
   /** Base URL for frontend API endpoints */
-  readonly feApiBaseUrl = '';
+  public readonly feApiBaseUrl = '';
 
   /** Base URL for user-related API endpoints */
-  readonly userApiBaseUrl = '';
+  public readonly userApiBaseUrl = '';
 
   /** Base URL for AI service API endpoints */
-  readonly aiApiBaseUrl = 'https://api.openai.com/v1';
+  public readonly aiApiBaseUrl = 'https://api.openai.com/v1';
 
   /** Authentication token for AI service API */
-  readonly aiApiToken = '';
+  public readonly aiApiToken = '';
 
   /** Prefix for AI service authentication token */
-  readonly aiApiTokenPrefix = 'Bearer';
+  public readonly aiApiTokenPrefix = 'Bearer';
 
   /** Flag indicating if AI service token is required */
-  readonly aiApiRequireToken = true;
+  public readonly aiApiRequireToken = true;
 
   /**
    * Project startup href, usually from window.location.href
    */
-  readonly bootHref = '';
+  public readonly bootHref = '';
 
   /** Flag indicating if the current environment is production */
-  get isProduction(): boolean {
+  public get isProduction(): boolean {
     return this.env === 'production';
   }
 }

package/dist/templates/react-app/src/base/cases/DialogHandler.ts

@@ -11,8 +11,7 @@ import type {
 import type { ModalFuncProps } from 'antd';
 
 export interface DialogHandlerOptions
-  extends NotificationOptions,
-    ModalFuncProps {
+  extends NotificationOptions, ModalFuncProps {
   content: string;
 }
 
@@ -46,15 +45,24 @@ export class DialogHandler
     notification?: NotificationApi;
   } = {};
 
-  setMessage(message: MessageApi): void {
+  /**
+   * @override
+   */
+  public setMessage(message: MessageApi): void {
     this.antds.message = message;
   }
 
-  setModal(modal: ModalApi): void {
+  /**
+   * @override
+   */
+  public setModal(modal: ModalApi): void {
     this.antds.modal = modal;
   }
 
-  setNotification(notification: NotificationApi): void {
+  /**
+   * @override
+   */
+  public setNotification(notification: NotificationApi): void {
     this.antds.notification = notification;
   }
 
@@ -67,10 +75,16 @@ export class DialogHandler
     return 'An unknown error occurred';
   }
 
+  /**
+   * @override
+   */
   public success(msg: string, options?: NotificationOptions): void {
     this.antds.message?.success({ content: msg, ...options });
   }
 
+  /**
+   * @override
+   */
   public error(msg: string, options?: NotificationOptions): void {
     this.antds.message?.error({
       content: options?.error ? this.formatErrorMessage(options.error) : msg,
@@ -78,14 +92,23 @@ export class DialogHandler
     });
   }
 
+  /**
+   * @override
+   */
   public info(msg: string, options?: NotificationOptions): void {
     this.antds.message?.info({ content: msg, ...options });
   }
 
+  /**
+   * @override
+   */
   public warn(msg: string, options?: NotificationOptions): void {
     this.antds.message?.warning({ content: msg, ...options });
   }
 
+  /**
+   * @override
+   */
   public confirm(options: DialogHandlerOptions): void {
     this.antds.modal?.confirm(options);
   }

package/dist/templates/react-app/src/base/cases/I18nKeyErrorPlugin.ts

@@ -15,7 +15,7 @@ import type { LoggerInterface } from '@qlover/logger';
  */
 @injectable()
 export class I18nKeyErrorPlugin implements ExecutorPlugin {
-  readonly pluginName = 'I18nKeyErrorPlugin';
+  public readonly pluginName = 'I18nKeyErrorPlugin';
 
   constructor(
     @inject(IOCIdentifier.Logger) protected logger: LoggerInterface,
@@ -27,7 +27,10 @@ export class I18nKeyErrorPlugin implements ExecutorPlugin {
     return this.i18nService.t(id);
   }
 
-  onError(context: ExecutorContext<unknown>): Error | void {
+  /**
+   * @override
+   */
+  public onError(context: ExecutorContext<unknown>): Error | void {
     const { error } = context;
 
     if (!error) {

package/dist/templates/react-app/src/base/cases/InversifyContainer.ts

@@ -17,15 +17,27 @@ export class InversifyContainer implements IOCContainerInterface {
     });
   }
 
-  bind<T>(key: ServiceIdentifier<T>, value: T): void {
+  /**
+   * @override
+   */
+  public bind<T>(key: ServiceIdentifier<T>, value: T): void {
     this.container.bind<T>(key).toConstantValue(value);
   }
 
-  get<K extends keyof IOCIdentifierMap>(
+  /**
+   * @override
+   */
+  public get<K extends keyof IOCIdentifierMap>(
     serviceIdentifier: K
   ): IOCIdentifierMap[K];
-  get<T>(serviceIdentifier: ServiceIdentifier<T>): T;
-  get<T, K extends keyof IOCIdentifierMap>(
+  /**
+   * @override
+   */
+  public get<T>(serviceIdentifier: ServiceIdentifier<T>): T;
+  /**
+   * @override
+   */
+  public get<T, K extends keyof IOCIdentifierMap>(
     serviceIdentifier: ServiceIdentifier<T> | K
   ): T | IOCIdentifierMap[K] {
     return this.container.get<T>(serviceIdentifier);

package/dist/templates/react-app/src/base/cases/PublicAssetsPath.ts

@@ -11,7 +11,7 @@ import { injectable } from 'inversify';
 export class PublicAssetsPath {
   constructor(protected prefix: string = routerPrefix) {}
 
-  getPath(path: string): string {
+  public getPath(path: string): string {
     if (!this.prefix) {
       return path.startsWith('/') ? path : `/${path}`;
     }