@qlover/create-app 0.7.14 → 0.8.0

package/dist/templates/react-app/__tests__/src/core/bootstraps/BootstrapClient.test.ts

@@ -0,0 +1,153 @@
+/**
+ * BootstrapClient test-suite
+ *
+ * Coverage:
+ * 1. main method       – Bootstrap client main flow tests
+ * 2. parameter validation – Input parameter validation tests
+ * 3. error handling    – Error handling tests
+ * 4. integration       – Bootstrap flow integration tests
+ */
+
+import { testIOC } from '@__tests__/__mocks__/testIOC/TestIOC';
+import { I, type IOCIdentifierMap } from '@config/IOCIdentifier';
+import type { BootstrapClientArgs } from '@/core/bootstraps/BootstrapClient';
+import { BootstrapClient } from '@/core/bootstraps/BootstrapClient';
+import type { BootstrapsRegistryInterface } from '@/core/bootstraps/BootstrapsRegistry';
+import * as globals from '@/core/globals';
+import type {
+  BootstrapExecutorPlugin,
+  IOCContainerInterface,
+  IOCFunctionInterface
+} from '@qlover/corekit-bridge';
+import type { ExecutorPlugin } from '@qlover/fe-corekit';
+
+describe('BootstrapClient', () => {
+  describe('bootstrap start flow', () => {
+    const mockRoot = {
+      location: { href: 'http://localhost:3000/en' }
+    };
+
+    const testBootstrapPlugin: BootstrapExecutorPlugin = {
+      pluginName: 'test-bootstrap-1',
+      onExec: vi.fn().mockResolvedValue(undefined)
+    };
+
+    it('should bootstrap real strapup flow', async () => {
+      // 将 mock 函数提取出来，以便验证是否被调用
+      const mockRegister = vi.fn().mockReturnValue([testBootstrapPlugin]);
+
+      class TestBootstrapsRegistry implements BootstrapsRegistryInterface {
+        register = mockRegister;
+      }
+
+      const args: BootstrapClientArgs = {
+        root: mockRoot,
+        bootHref: mockRoot.location.href,
+        ioc: testIOC,
+        RegistryClass: TestBootstrapsRegistry
+      };
+
+      const result = await BootstrapClient.main(args);
+
+      expect(result).toEqual(args);
+      expect(globals.logger.info).toHaveBeenCalledWith('bootstrap start...');
+      expect(testBootstrapPlugin.onExec).toHaveBeenCalled();
+      // 验证 register 方法是否被调用
+      expect(mockRegister).toHaveBeenCalled();
+    });
+
+    it('should handle bootstrap I18nService', async () => {
+      // 将 mock 函数提取出来，以便验证是否被调用
+      const mockRegister = vi
+        .fn()
+        .mockImplementationOnce(
+          (
+            ioc: IOCFunctionInterface<IOCIdentifierMap, IOCContainerInterface>
+          ) => {
+            // TestIocRegister 中已经注册了，无法bind
+            return [ioc.get(I.I18nServiceInterface)];
+          }
+        );
+
+      class TestBootstrapsRegistry implements BootstrapsRegistryInterface {
+        register = mockRegister;
+      }
+
+      const args: BootstrapClientArgs = {
+        root: mockRoot,
+        bootHref: mockRoot.location.href,
+        ioc: testIOC,
+        RegistryClass: TestBootstrapsRegistry
+      };
+
+      await BootstrapClient.main(args);
+
+      const ioc = testIOC.getIoc();
+      expect(mockRegister).toBeCalled();
+      expect(ioc).toBeDefined();
+
+      const i18nService = ioc!.get(I.I18nServiceInterface);
+      expect(i18nService).toBeDefined();
+      // @ts-ignore
+      expect(i18nService.pathname).toBe(args.bootHref);
+
+      // mock i18n set language to en
+      i18nService.emit({ ...i18nService.state, language: 'en' });
+
+      expect(i18nService.state.language).toBe('en');
+    });
+
+    it('should handle bootstrap UserApiBootstarp', async () => {
+      const mockUserService: ExecutorPlugin = {
+        pluginName: 'TestUserService',
+        onBefore: vi.fn().mockResolvedValue(undefined)
+      };
+      // 将 mock 函数提取出来，以便验证是否被调用
+      const mockRegister = vi
+        .fn()
+        .mockImplementationOnce(
+          (
+            ioc: IOCFunctionInterface<IOCIdentifierMap, IOCContainerInterface>
+          ) => {
+            return [ioc.get(I.UserServiceInterface)];
+          }
+        );
+
+      class TestBootstrapsRegistry implements BootstrapsRegistryInterface {
+        register = mockRegister;
+      }
+
+      const args: BootstrapClientArgs = {
+        root: mockRoot,
+        bootHref: mockRoot.location.href,
+        ioc: testIOC,
+        iocRegister: {
+          register: vi
+            .fn()
+            .mockImplementationOnce(
+              (
+                ioc: IOCFunctionInterface<
+                  IOCIdentifierMap,
+                  IOCContainerInterface
+                >
+              ) => {
+                ioc.bind(I.UserServiceInterface, mockUserService as any);
+              }
+            )
+        },
+        RegistryClass: TestBootstrapsRegistry
+      };
+
+      await BootstrapClient.main(args);
+      const ioc = testIOC.getIoc();
+      expect(ioc).toBeDefined();
+
+      const userService = ioc!.get(I.UserServiceInterface);
+
+      expect(userService).toBeDefined();
+      expect(userService).toEqual(mockUserService);
+      expect(userService.pluginName).toBe('TestUserService');
+      expect(userService.onBefore).toBeCalled();
+    });
+  });
+});

package/dist/templates/react-app/__tests__/src/core/bootstraps/BootstrapsApp.test.ts

@@ -1,10 +1,10 @@
-import { InversifyContainer } from '@/base/cases/InversifyContainer';
-import { BootstrapApp } from '@/core/bootstraps/BootstrapApp';
-import type { BootstrapAppArgs } from '@/core/bootstraps/BootstrapApp';
+import { browserGlobalsName } from '@config/common';
 import { createIOCFunction } from '@qlover/corekit-bridge';
+import { InversifyContainer } from '@/base/cases/InversifyContainer';
+import { BootstrapClient } from '@/core/bootstraps/BootstrapClient';
+import type { BootstrapClientArgs } from '@/core/bootstraps/BootstrapClient';
 import type { IOCIdentifierMap } from '@config/IOCIdentifier';
 import { name, version } from '../../../../package.json';
-import { browserGlobalsName } from '@config/common';
 
 // Mock IocRegisterImpl to properly handle registration
 vi.mock('@/core/registers/IocRegisterImpl', () => ({
@@ -25,7 +25,7 @@ vi.mock('@/core/bootstraps/BootstrapsRegistry', () => ({
 }));
 
 describe('BootstrapApp', () => {
-  let mockArgs: BootstrapAppArgs;
+  let mockArgs: BootstrapClientArgs;
   let mockIOC: ReturnType<typeof createIOCFunction<IOCIdentifierMap>>;
 
   beforeEach(() => {
@@ -40,13 +40,15 @@ describe('BootstrapApp', () => {
     mockArgs = {
       root: {},
       bootHref: 'http://localhost:3000',
-      IOC: mockIOC
+      ioc: {
+        create: vi.fn().mockReturnValue(mockIOC)
+      }
     };
   });
 
   describe('main', () => {
     it('should initialize bootstrap successfully', async () => {
-      const result = await BootstrapApp.main(mockArgs);
+      const result = await BootstrapClient.main(mockArgs);
 
       expect(result.bootHref).toBe('http://localhost:3000');
       // default inject env,globals var, ioc

package/dist/templates/react-app/__tests__/src/main.integration.test.tsx

@@ -1,4 +1,3 @@
-import { describe, it, expect, beforeAll, afterAll, beforeEach } from 'vitest';
 import { readFileSync, existsSync } from 'fs';
 import { join } from 'path';
 
@@ -41,7 +40,7 @@ describe('main.tsx Integration Tests', () => {
 
     // Check if it contains necessary imports
     expect(content).toContain('import');
-    expect(content).toContain('BootstrapApp');
+    expect(content).toContain('BootstrapClient');
     expect(content).toContain('createRoot');
   });
 
@@ -51,11 +50,11 @@ describe('main.tsx Integration Tests', () => {
     expect(existsSync(appPath)).toBe(true);
   });
 
-  it('should have BootstrapApp.ts file', () => {
-    // Test if BootstrapApp.ts file exists
+  it('should have BootstrapClient.ts file', () => {
+    // Test if BootstrapClient.ts file exists
     const bootstrapPath = join(
       process.cwd(),
-      'src/core/bootstraps/BootstrapApp.ts'
+      'src/core/bootstraps/BootstrapClient.ts'
     );
     expect(existsSync(bootstrapPath)).toBe(true);
   });

package/dist/templates/react-app/__tests__/src/main.test.tsx

@@ -1,8 +1,8 @@
-import { BootstrapApp } from '@/core/bootstraps/BootstrapApp';
+import { BootstrapClient } from '@/core/bootstraps/BootstrapClient';
 
 // Mock BootstrapApp
-vi.mock('@/core/bootstraps/BootstrapApp', () => ({
-  BootstrapApp: {
+vi.mock('@/core/bootstraps/BootstrapClient', () => ({
+  BootstrapClient: {
     main: vi.fn()
   }
 }));
@@ -33,7 +33,7 @@ describe('main.tsx', () => {
   describe('BootstrapApp initialization', () => {
     it('should call BootstrapApp.main()', async () => {
       await import('@/main');
-      expect(BootstrapApp.main).toHaveBeenCalledTimes(1);
+      expect(BootstrapClient.main).toHaveBeenCalledTimes(1);
     });
   });
 

package/dist/templates/react-app/__tests__/src/uikit/components/BaseHeader.test.tsx

@@ -1,86 +1,95 @@
+import { BootstrapTest } from '@__mocks__/BootstrapTest';
+import { TestApp } from '@__mocks__/components';
+import { I } from '@config/IOCIdentifier';
 import { render, screen } from '@testing-library/react';
-import { vi, expect } from 'vitest';
-import BaseHeader from '@/uikit/components/BaseHeader';
-import { PublicAssetsPath } from '@/base/cases/PublicAssetsPath';
+import type { IOCRegister } from '@/base/port/IOCInterface';
+import { UserService } from '@/base/services/UserService';
+import { BaseHeader } from '@/uikit/components/BaseHeader';
 
-// Mock dependencies
-const mockPublicAssetsPath = new PublicAssetsPath('');
-
-vi.mock('@/core/IOC', () => ({
-  IOC: vi.fn((key) => {
-    if (key === 'AppConfig') {
-      return { appName: 'Test App' };
-    }
-    if (key === PublicAssetsPath) {
-      return mockPublicAssetsPath;
-    }
-    return {};
-  })
-}));
-
-// Mock child components
-vi.mock('@/uikit/components/ThemeSwitcher', () => ({
-  default: () => <div data-testid="theme-switcher">Theme Switcher</div>
-}));
-
-interface LocaleLinkProps {
-  children: React.ReactNode;
-  href: string;
-  className?: string;
-}
-
-vi.mock('@/uikit/components/LocaleLink', () => ({
-  default: ({ children, href, className }: LocaleLinkProps) => (
-    <a href={href} className={className} data-testid="locale-link">
-      {children}
-    </a>
-  )
-}));
-
-vi.mock('@/uikit/components/LanguageSwitcher', () => ({
-  default: () => <div data-testid="language-switcher">Language Switcher</div>
-}));
-
-vi.mock('@/uikit/components/LogoutButton', () => ({
-  default: () => <div data-testid="logout-button">Logout</div>
-}));
+const BaseHeaderRegister: IOCRegister = {
+  register(ioc): void {
+    ioc.bind(I.UserServiceInterface, ioc.get(UserService));
+  }
+};
 
 describe('BaseHeader', () => {
+  beforeAll(async () => {
+    await BootstrapTest.main({
+      root: globalThis,
+      bootHref: 'http://localhost:3000/en/test',
+      iocRegister: BaseHeaderRegister
+    });
+  });
+
   it('renders header with correct structure', () => {
-    render(<BaseHeader />);
-    expect(screen.getByTestId('base-header')).toBeDefined();
+    render(
+      <TestApp>
+        <BaseHeader />
+      </TestApp>
+    );
+
+    const header = screen.getByTestId('BaseHeader');
+    expect(header).toBeDefined();
   });
 
   it('renders logo and app name correctly', () => {
-    render(<BaseHeader />);
-    const logo = screen.getByTestId('base-header-logo');
-    const appName = screen.getByTestId('base-header-app-name');
+    render(
+      <TestApp>
+        <BaseHeader />
+      </TestApp>
+    );
+
+    const logo = screen.getByTestId('BaseHeader-logo');
+    const appName = screen.getByTestId('BaseHeader-app-name');
 
     expect(logo).toBeDefined();
-    expect(logo.getAttribute('src')).toBe('/logo.svg');
     expect(logo.getAttribute('alt')).toBe('logo');
     expect(appName).toBeDefined();
-    expect(appName.textContent).toBe('Test App');
+    expect(appName.textContent).toBeTruthy();
   });
 
   it('renders theme and language switchers', () => {
-    render(<BaseHeader />);
-    expect(screen.getByTestId('theme-switcher')).toBeDefined();
-    expect(screen.getByTestId('language-switcher')).toBeDefined();
+    render(
+      <TestApp>
+        <BaseHeader />
+      </TestApp>
+    );
+
+    // Note: These components render as Ant Design Select components
+    // We can verify they exist by checking for their parent containers
+    const header = screen.getByTestId('BaseHeader');
+    expect(header).toBeDefined();
+    // The actual Select components might not have data-testid in production code
   });
 
   it('renders logout button when showLogoutButton is true', () => {
-    render(<BaseHeader showLogoutButton />);
-    expect(screen.getByTestId('logout-button')).toBeDefined();
+    render(
+      <TestApp>
+        <BaseHeader showLogoutButton />
+      </TestApp>
+    );
+
+    const logoutButton = screen.getByTestId('LogoutButton');
+    expect(logoutButton).toBeDefined();
   });
 
   it('does not render logout button when showLogoutButton is false', () => {
-    render(<BaseHeader showLogoutButton={false} />);
-    expect(screen.queryByTestId('logout-button')).toBeNull();
+    render(
+      <TestApp>
+        <BaseHeader showLogoutButton={false} />
+      </TestApp>
+    );
+
+    expect(screen.queryByTestId('LogoutButton')).toBeNull();
   });
 
   it('renders home link correctly', () => {
-    render(<BaseHeader />);
+    render(
+      <TestApp>
+        <BaseHeader />
+      </TestApp>
+    );
+
     const link = screen.getByTestId('locale-link');
     expect(link).toBeDefined();
     expect(link.getAttribute('href')).toBe('/');

package/dist/templates/react-app/config/IOCIdentifier.ts

@@ -1,17 +1,17 @@
-import type * as CorekitBridge from '@qlover/corekit-bridge';
-import type * as FeCorekit from '@qlover/fe-corekit';
-import type * as Logger from '@qlover/logger';
-import type { DialogHandler } from '@/base/cases/DialogHandler';
 import type { AppConfig } from '@/base/cases/AppConfig';
+import type { DialogHandler } from '@/base/cases/DialogHandler';
+import type { I18nKeyErrorPlugin } from '@/base/cases/I18nKeyErrorPlugin';
 import type { RequestStatusCatcher } from '@/base/cases/RequestStatusCatcher';
+import type { ExecutorPageBridgeInterface } from '@/base/port/ExecutorPageBridgeInterface';
+import type { JSONStoragePageBridgeInterface } from '@/base/port/JSONStoragePageBridgeInterface';
+import type { RequestPageBridgeInterface } from '@/base/port/RequestPageBridgeInterface';
 import type { I18nService } from '@/base/services/I18nService';
 import type { ProcesserExecutor } from '@/base/services/ProcesserExecutor';
 import type { RouteService } from '@/base/services/RouteService';
 import type { UserService } from '@/base/services/UserService';
-import type { I18nKeyErrorPlugin } from '@/base/cases/I18nKeyErrorPlugin';
-import type { ExecutorPageBridgeInterface } from '@/base/port/ExecutorPageBridgeInterface';
-import type { JSONStoragePageBridgeInterface } from '@/base/port/JSONStoragePageBridgeInterface';
-import type { RequestPageBridgeInterface } from '@/base/port/RequestPageBridgeInterface';
+import type * as CorekitBridge from '@qlover/corekit-bridge';
+import type * as FeCorekit from '@qlover/fe-corekit';
+import type * as Logger from '@qlover/logger';
 
 /**
  * IOC identifier

package/dist/templates/react-app/config/Identifier/{common.error.ts → common/common.error.ts}

@@ -3,32 +3,32 @@
  * @localZh 本地未找到 user token
  * @localEn Local no user token
  */
-export const LOCAL_NO_USER_TOKEN = 'err.local.no.user.token';
+export const LOCAL_NO_USER_TOKEN = 'common:no.user.token';
 
 /**
  * @description 全局未找到 window
  * @localZh 全局未找到 window
  * @localEn Global no window
  */
-export const GLOBAL_NO_WINDOW = 'err.global.no.window';
+export const GLOBAL_NO_WINDOW = 'common:global.no.window';
 
 /**
  * @description 必须在 PageProvider 中使用
  * @localZh 必须在 PageProvider 中使用
  * @localEn Must be used in PageProvider
  */
-export const WITHIN_PAGE_PROVIDER = 'err.within.page.provider';
+export const WITHIN_PAGE_PROVIDER = 'common:within.page.provider';
 
 /**
  * @description 响应内容没有 token 值
  * @localZh 响应内容没有 token 值
  * @localEn Response not token value
  */
-export const RES_NO_TOKEN = 'err.response.no.token';
+export const RES_NO_TOKEN = 'common:response.no.token';
 
 /**
  * @description 未找到组件
  * @localZh 未找到组件
  * @localEn Not found component
  */
-export const NOT_FOUND_COMPONENT = 'err.not.found.component';
+export const NOT_FOUND_COMPONENT = 'common:not.found.component';

package/dist/templates/react-app/config/Identifier/{common.ts → common/common.ts}

@@ -3,60 +3,60 @@
  * @localZh 默认主题
  * @localEn Default Theme
  */
-export const HEADER_THEME_DEFAULT = 'header.theme.default';
+export const HEADER_THEME_DEFAULT = 'common:theme.default';
 
 /**
  * @description Theme switcher dark theme label
  * @localZh 暗色主题
  * @localEn Dark Theme
  */
-export const HEADER_THEME_DARK = 'header.theme.dark';
+export const HEADER_THEME_DARK = 'common:theme.dark';
 
 /**
  * @description Theme switcher pink theme label
  * @localZh 粉色主题
  * @localEn Pink Theme
  */
-export const HEADER_THEME_PINK = 'header.theme.pink';
+export const HEADER_THEME_PINK = 'common:theme.pink';
 
 /**
  * @description logout dialog title
  * @localZh 登出
  * @localEn Logout
  */
-export const AUTH_LOGOUT_DIALOG_TITLE = 'auth.logout.dialog.title';
+export const AUTH_LOGOUT_DIALOG_TITLE = 'common:logout.dialog.title';
 
 /**
  * @description logout dialog content
  * @localZh 确定要登出吗？
  * @localEn Are you sure you want to logout?
  */
-export const AUTH_LOGOUT_DIALOG_CONTENT = 'auth.logout.dialog.content';
+export const AUTH_LOGOUT_DIALOG_CONTENT = 'common:logout.dialog.content';
 
 /**
  * @description 404 page title
  * @localZh 404 页面未找到
  * @localEn 404 Page Not Found
  */
-export const PAGE_404_TITLE = 'page.404.title';
+export const PAGE_404_TITLE = 'common:404.title';
 
 /**
  * @description 404 page description
  * @localZh 404 页面描述
  * @localEn 404 Page Description
  */
-export const PAGE_404_DESCRIPTION = 'page.404.description';
+export const PAGE_404_DESCRIPTION = 'common:404.description';
 
 /**
  * @description 500 page title
  * @localZh 500 页面错误
  * @localEn 500 Page Error
  */
-export const PAGE_500_TITLE = 'page.500.title';
+export const PAGE_500_TITLE = 'common:500.title';
 
 /**
  * @description 500 page description
  * @localZh 500 页面描述
  * @localEn 500 Page Description
  */
-export const PAGE_500_DESCRIPTION = 'page.500.description';
+export const PAGE_500_DESCRIPTION = 'common:500.description';

package/dist/templates/react-app/config/Identifier/common/index.ts

@@ -0,0 +1,2 @@
+export * from './common.error';
+export * from './common';

package/dist/templates/react-app/config/Identifier/index.ts

@@ -1,10 +1,2 @@
 export * from './common';
-export * from './common.error';
-export * from './page.about';
-export * from './page.executor';
-export * from './page.home';
-export * from './page.identifiter';
-export * from './page.jsonStorage';
-export * from './page.login';
-export * from './page.register';
-export * from './page.request';
+export * from './pages';

package/dist/templates/react-app/config/Identifier/pages/index.ts

@@ -0,0 +1,8 @@
+export * from './page.about';
+export * from './page.executor';
+export * from './page.home';
+export * from './page.identifiter';
+export * from './page.jsonStorage';
+export * from './page.login';
+export * from './page.register';
+export * from './page.request';