@qlover/create-app 1.0.2 → 2.0.0

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

@@ -1,53 +0,0 @@
-import { appConfig as globalsAppConfig } from '@/core/globals';
-import { IOCContext } from '@/uikit/contexts/IOCContext';
-import { TestRouter } from './TestRouter';
-import { testIOC } from '../testIOC/TestIOC';
-import type { EnvConfigInterface } from '@qlover/corekit-bridge';
-export interface TestBootstrapsProviderProps {
-  children: React.ReactNode;
-  /**
-   * Initial URL path for the router
-   * @default ['/en/']
-   */
-  routerInitialEntries?: string[];
-  /**
-   * Initial index of the entries array
-   * @default 0
-   */
-  routerInitialIndex?: number;
-
-  /**
-   * The boot href
-   *
-   * @default `https://localhost.test:3000/en/`
-   */
-  bootHref?: string;
-
-  appConfig?: EnvConfigInterface;
-}
-
-const defaultBootHref = 'https://localhost.test:3000/en/';
-
-export function TestBootstrapsProvider({
-  children,
-  routerInitialEntries,
-  routerInitialIndex,
-  bootHref,
-  appConfig
-}: TestBootstrapsProviderProps) {
-  const IOC = testIOC.create({
-    pathname: bootHref ?? defaultBootHref,
-    appConfig: appConfig ?? globalsAppConfig
-  });
-
-  return (
-    <IOCContext.Provider value={IOC}>
-      <TestRouter
-        initialEntries={routerInitialEntries}
-        initialIndex={routerInitialIndex}
-      >
-        {children}
-      </TestRouter>
-    </IOCContext.Provider>
-  );
-}

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

@@ -1,46 +0,0 @@
-import { MemoryRouter } from 'react-router-dom';
-import type { ReactNode } from 'react';
-
-interface TestRouterProps {
-  children: ReactNode;
-  /**
-   * Initial URL path for the router
-   * @default '/en/'
-   */
-  initialEntries?: string[];
-  /**
-   * Initial index of the entries array
-   * @default 0
-   */
-  initialIndex?: number;
-}
-
-/**
- * TestRouter - A reusable router wrapper for tests
- *
- * Usage:
- * ```tsx
- * import { TestRouter } from '__tests__/__mocks__/components/TestRouter';
- *
- * render(
- *   <TestRouter initialEntries={['/en/dashboard']}>
- *     <YourComponent />
- *   </TestRouter>
- * );
- * ```
- */
-export function TestRouter({
-  children,
-  initialEntries = ['/en/'],
-  initialIndex = 0
-}: TestRouterProps) {
-  return (
-    <MemoryRouter
-      data-testid="TestRouter"
-      initialEntries={initialEntries}
-      initialIndex={initialIndex}
-    >
-      {children}
-    </MemoryRouter>
-  );
-}

package/dist/templates/react-app/__tests__/__mocks__/components/index.ts

@@ -1,12 +0,0 @@
-/**
- * Test Components - Reusable test wrappers
- *
- * These components provide common test infrastructure:
- * - TestRouter: Provides React Router context
- * - TestBootstrapsProvider: Provides IOC context + Router
- * - TestApp: Complete test wrapper (IOC + Router)
- */
-
-export { TestRouter } from './TestRouter';
-export { TestBootstrapsProvider } from './TestBootstrapsProvider';
-export { TestApp } from './TestApp';

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

@@ -1,96 +0,0 @@
-import { vi } from 'vitest';
-import { MockAppConfig } from './MockAppConfig';
-import { MockDialogHandler } from './MockDialogHandler';
-import { MockLogger } from './MockLogger';
-
-export function createMockGlobals() {
-  const mockLogger = new MockLogger();
-  const mockAppConfig = new MockAppConfig();
-  const mockDialogHandler = new MockDialogHandler();
-
-  // Mock JSON serializer
-  const mockJSON = {
-    serialize: vi.fn((data) => JSON.stringify(data)),
-    deserialize: vi.fn((data) => JSON.parse(data)),
-    stringify: vi.fn((data) => JSON.stringify(data)),
-    parse: vi.fn((data) => JSON.parse(data))
-  };
-
-  const storageOptions: Record<string, any> = {
-    localStorage: {},
-    cookieStorage: {},
-    localStorageEncrypt: {}
-  };
-
-  // Mock localStorage with actual storage simulation
-  const mockLocalStorageData = storageOptions.localStorage ?? {};
-  const mockLocalStorage = {
-    get: vi.fn((key: string) => mockLocalStorageData[key]),
-    set: vi.fn((key: string, value: unknown) => {
-      mockLocalStorageData[key] = value;
-    }),
-    getItem: vi.fn((key: string) => mockLocalStorageData[key]),
-    setItem: vi.fn((key: string, value: unknown) => {
-      mockLocalStorageData[key] = value;
-    }),
-    remove: vi.fn((key: string) => {
-      delete mockLocalStorageData[key];
-    }),
-    removeItem: vi.fn((key: string) => {
-      delete mockLocalStorageData[key];
-    }),
-    clear: vi.fn(() => {
-      Object.keys(mockLocalStorageData).forEach((key) => {
-        delete mockLocalStorageData[key];
-      });
-    }),
-    has: vi.fn((key: string) => key in mockLocalStorageData),
-    keys: vi.fn(() => Object.keys(mockLocalStorageData)),
-    size: vi.fn(() => Object.keys(mockLocalStorageData).length)
-  };
-
-  // Mock localStorageEncrypt (same as localStorage for now)
-  const mockLocalStorageEncrypt = { ...mockLocalStorage };
-
-  // Mock cookieStorage
-  const mockCookieStorageData = storageOptions.cookieStorage ?? {};
-  const mockCookieStorage = {
-    get: vi.fn((key: string) => mockCookieStorageData[key]),
-    set: vi.fn((key: string, value: unknown, _options?: unknown) => {
-      mockCookieStorageData[key] = value;
-    }),
-    getItem: vi.fn((key: string) => mockCookieStorageData[key]),
-    setItem: vi.fn((key: string, value: unknown, _options?: unknown) => {
-      mockCookieStorageData[key] = value;
-    }),
-    remove: vi.fn((key: string) => {
-      delete mockCookieStorageData[key];
-    }),
-    removeItem: vi.fn((key: string) => {
-      delete mockCookieStorageData[key];
-    }),
-    clear: vi.fn(() => {
-      Object.keys(mockCookieStorageData).forEach((key) => {
-        delete mockCookieStorageData[key];
-      });
-    }),
-    has: vi.fn((key: string) => key in mockCookieStorageData),
-    keys: vi.fn(() => Object.keys(mockCookieStorageData)),
-    size: vi.fn(() => Object.keys(mockCookieStorageData).length)
-  };
-
-  // Add length property to prevent lodash.omit from treating this as array-like
-  // This is needed because BootstrapClient uses omit(globals, ...) and lodash
-  // checks for length property to determine if object is array-like
-  return {
-    logger: mockLogger,
-    appConfig: mockAppConfig,
-    dialogHandler: mockDialogHandler,
-    JSON: mockJSON,
-    localStorage: mockLocalStorage,
-    localStorageEncrypt: mockLocalStorageEncrypt,
-    cookieStorage: mockCookieStorage,
-    // Explicitly define length as undefined to satisfy lodash's isArrayLike check
-    length: undefined
-  };
-}

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

@@ -1,110 +0,0 @@
-/**
- * Mock i18next-http-backend for testing
- *
- * This mock prevents network requests while still allowing i18next to work properly.
- * It loads translation data directly from JSON files, enabling translation testing.
- */
-
-import enCommon from '../../public/locales/en/common.json';
-import zhCommon from '../../public/locales/zh/common.json';
-import type { i18n as I18nType } from 'i18next';
-
-// Translation resources loaded from JSON files
-const resources: Record<string, Record<string, Record<string, string>>> = {
-  en: {
-    common: enCommon as Record<string, string>
-  },
-  zh: {
-    common: zhCommon as Record<string, string>
-  }
-};
-
-/**
- * Mock HttpApi backend class for i18next
- * Implements the backend interface to avoid network requests
- */
-export class MockHttpBackend {
-  public type = 'backend';
-
-  /**
-   * Initialize the backend
-   * This is called by i18next when .use() is called
-   */
-  public init(
-    _services: unknown,
-    _backendOptions: unknown,
-    _i18nextOptions: unknown,
-    i18nextInstance: I18nType
-  ): void {
-    // Preload resources directly into i18next
-    if (
-      i18nextInstance &&
-      typeof i18nextInstance.addResourceBundle === 'function'
-    ) {
-      // Add resources for all languages and namespaces
-      Object.keys(resources).forEach((lng) => {
-        Object.keys(resources[lng]).forEach((ns) => {
-          i18nextInstance.addResourceBundle(
-            lng,
-            ns,
-            resources[lng][ns],
-            true,
-            true
-          );
-        });
-      });
-    }
-  }
-
-  /**
-   * Read translation data for a language and namespace
-   * This method is called by i18next to load translations
-   */
-  public read(
-    language: string,
-    namespace: string,
-    callback: (error: Error | null, data?: Record<string, string>) => void
-  ): void {
-    try {
-      const data = resources[language]?.[namespace];
-      if (data) {
-        // Return immediately with the data
-        callback(null, data);
-      } else {
-        callback(new Error(`Translation not found: ${language}/${namespace}`));
-      }
-    } catch (error) {
-      callback(error as Error);
-    }
-  }
-
-  /**
-   * Load URL - called by i18next-http-backend to load from URL
-   * We intercept this and return data from memory instead
-   */
-  public loadUrl(
-    _url: string,
-    callback: (error: Error | null, data?: Record<string, string>) => void
-  ): void {
-    // Extract language and namespace from URL if possible
-    // Format: /locales/{{lng}}/{{ns}}.json
-    const match = _url.match(/locales\/([^/]+)\/([^/]+)\.json/);
-    if (match) {
-      const [, lng, ns] = match;
-      const data = resources[lng]?.[ns];
-      if (data) {
-        callback(null, data);
-        return;
-      }
-    }
-    // Fallback: return empty object
-    callback(null, {});
-  }
-
-  /**
-   * Create - not used in our mock
-   */
-  public create(): void {
-    // No-op
-  }
-}

package/dist/templates/react-app/__tests__/__mocks__/testIOC/TestIOC.ts

@@ -1,55 +0,0 @@
-import { createIOCFunction } from '@qlover/corekit-bridge';
-import { InversifyContainer } from '@/base/cases/InversifyContainer';
-import type {
-  IOCInterface,
-  IocRegisterOptions
-} from '@/base/port/IOCInterface';
-import type { IOCIdentifierMap } from '@config/IOCIdentifier';
-import { TestIOCRegister } from './TestIOCRegister';
-import type {
-  IOCContainerInterface,
-  IOCFunctionInterface
-} from '@qlover/corekit-bridge';
-
-export class TestIOC implements IOCInterface<
-  IOCIdentifierMap,
-  IOCContainerInterface
-> {
-  protected ioc: IOCFunctionInterface<
-    IOCIdentifierMap,
-    IOCContainerInterface
-  > | null = null;
-
-  public getIoc(): IOCFunctionInterface<
-    IOCIdentifierMap,
-    IOCContainerInterface
-  > | null {
-    return this.ioc;
-  }
-
-  /**
-   * @override
-   */
-  public create(
-    options: IocRegisterOptions
-  ): IOCFunctionInterface<IOCIdentifierMap, IOCContainerInterface> {
-    if (this.ioc) {
-      return this.ioc;
-    }
-
-    this.ioc = createIOCFunction<IOCIdentifierMap>(new InversifyContainer());
-
-    // move to BootstrapClient
-    const register = new TestIOCRegister(options);
-    // const register = new ClientIOCRegister({
-    //   pathname: '/en/test',
-    //   appConfig: appConfig
-    // });
-
-    register.register(this.ioc.implemention!, this.ioc);
-
-    return this.ioc;
-  }
-}
-
-export const testIOC = new TestIOC();

package/dist/templates/react-app/__tests__/__mocks__/testIOC/TestIOCRegister.ts

@@ -1,74 +0,0 @@
-import { baseNoLocaleRoutes, baseRoutes } from '@config/app.router';
-import { routerPrefix, useLocaleRoutes } from '@config/common';
-import { I } from '@config/IOCIdentifier';
-import { themeConfig } from '@config/theme';
-import { ThemeService } from '@qlover/corekit-bridge';
-import type { IocRegisterOptions } from '@/base/port/IOCInterface';
-import { I18nService } from '@/base/services/I18nService';
-import { RouteService } from '@/base/services/RouteService';
-import * as globals from '@/core/globals';
-import { NavigateBridge } from '@/uikit/bridges/NavigateBridge';
-import type {
-  IOCContainerInterface,
-  IOCManagerInterface,
-  IOCRegisterInterface,
-  ThemeServiceProps
-} from '@qlover/corekit-bridge';
-
-/**
- * TestIOCRegister - Register mock services for testing
- */
-export class TestIOCRegister implements IOCRegisterInterface<
-  IOCContainerInterface,
-  IocRegisterOptions
-> {
-  constructor(protected options: IocRegisterOptions) {}
-
-  protected registerGlobals(ioc: IOCContainerInterface): void {
-    const { appConfig, dialogHandler, localStorageEncrypt, JSON, logger } =
-      globals;
-
-    ioc.bind(I.JSONSerializer, JSON);
-    ioc.bind(I.Logger, logger);
-    ioc.bind(I.AppConfig, appConfig);
-    ioc.bind(I.EnvConfigInterface, appConfig);
-    ioc.bind(I.DialogHandler, dialogHandler);
-    ioc.bind(I.UIDialogInterface, dialogHandler);
-    ioc.bind(I.AntdStaticApiInterface, dialogHandler);
-    ioc.bind(I.LocalStorage, globals.localStorage);
-    ioc.bind(I.LocalStorageEncrypt, localStorageEncrypt);
-    ioc.bind(I.CookieStorage, globals.cookieStorage);
-  }
-
-  /**
-   * @override
-   */
-  public register(
-    ioc: IOCContainerInterface,
-    _manager: IOCManagerInterface<IOCContainerInterface>
-  ): void {
-    this.registerGlobals(ioc);
-
-    ioc.bind(I.I18nServiceInterface, new I18nService(this.options.pathname));
-    ioc.bind(
-      I.RouteServiceInterface,
-      new RouteService(
-        ioc.get(NavigateBridge),
-        ioc.get(I.I18nServiceInterface),
-        {
-          routes: useLocaleRoutes ? baseRoutes : baseNoLocaleRoutes,
-          logger: ioc.get(I.Logger),
-          hasLocalRoutes: useLocaleRoutes,
-          routerPrefix: routerPrefix
-        }
-      )
-    );
-    ioc.bind(
-      I.ThemeService,
-      new ThemeService({
-        ...(themeConfig as unknown as ThemeServiceProps),
-        storage: ioc.get(I.LocalStorage)
-      })
-    );
-  }
-}

package/dist/templates/react-app/__tests__/setup/index.ts

@@ -1 +0,0 @@
-import './setupGlobal';

package/dist/templates/react-app/__tests__/setup/setupGlobal.ts

@@ -1,64 +0,0 @@
-import { createMockGlobals } from '__tests__/__mocks__/createMockGlobals';
-
-// 设置测试环境
-beforeEach(() => {
-  // 清理DOM
-  document.body.innerHTML = '';
-
-  // 创建root元素（如果不存在）
-  if (!document.getElementById('root')) {
-    const rootElement = document.createElement('div');
-    rootElement.id = 'root';
-    document.body.appendChild(rootElement);
-  }
-});
-
-afterEach(() => {
-  // 清理所有mock
-  vi.clearAllMocks();
-});
-
-// 全局测试配置
-global.ResizeObserver = vi.fn().mockImplementation(() => ({
-  observe: vi.fn(),
-  unobserve: vi.fn(),
-  disconnect: vi.fn()
-}));
-
-// Mock window.matchMedia
-Object.defineProperty(window, 'matchMedia', {
-  writable: true,
-  value: vi.fn().mockImplementation((query) => ({
-    matches: false,
-    media: query,
-    onchange: null,
-    addListener: vi.fn(), // deprecated
-    removeListener: vi.fn(), // deprecated
-    addEventListener: vi.fn(),
-    removeEventListener: vi.fn(),
-    dispatchEvent: vi.fn()
-  }))
-});
-
-// Mock IntersectionObserver
-global.IntersectionObserver = vi.fn().mockImplementation(() => ({
-  observe: vi.fn(),
-  unobserve: vi.fn(),
-  disconnect: vi.fn()
-}));
-
-// Mock globals
-vi.mock('@/core/globals', () => createMockGlobals());
-
-// Mock i18next-http-backend to avoid network requests in tests
-// This prevents timeout issues when I18nService tries to load language files
-// The mock loads translations directly from JSON files, enabling translation testing
-vi.mock('i18next-http-backend', async () => {
-  const { MockHttpBackend } = await import('@__mocks__/i18nextHttpBackend');
-  return { default: MockHttpBackend };
-});
-
-// Mock i18next-browser-languagedetector to avoid browser API calls
-vi.mock('i18next-browser-languagedetector', () => ({
-  default: {}
-}));

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

@@ -1,115 +0,0 @@
-import { routerPrefix } from '@config/common';
-import { render, screen } from '@testing-library/react';
-import { testIOC } from '__tests__/__mocks__/testIOC/TestIOC';
-import { describe, it, expect, vi, beforeAll } from 'vitest';
-import App from '@/App';
-import { BootstrapClient } from '@/core/bootstraps/BootstrapClient';
-
-// Mock CSS imports
-vi.mock('@/styles/css/index.css', () => ({}));
-
-// Mock RouterProvider
-vi.mock('react-router-dom', () => ({
-  createBrowserRouter: vi.fn((routes, options) => ({
-    routes,
-    basename: options?.basename
-  })),
-  RouterProvider: ({ router }: any) => (
-    <div data-testid="router-provider">
-      <div data-testid="router-basename">{router?.basename}</div>
-      <div data-testid="router-routes-count">{router?.routes?.length || 0}</div>
-    </div>
-  ),
-  useNavigate: () => vi.fn()
-}));
-
-// Mock AntdThemeProvider
-vi.mock('@brain-toolkit/antd-theme-override/react', () => ({
-  AntdThemeProvider: ({ children, theme }: any) => (
-    <div data-testid="antd-theme-provider">
-      <div data-testid="theme-key">{theme?.cssVar?.key}</div>
-      <div data-testid="theme-prefix">{theme?.cssVar?.prefix}</div>
-      {children}
-    </div>
-  )
-}));
-
-// Mock react-kit
-vi.mock('@brain-toolkit/react-kit', () => ({
-  useMountedClient: () => true,
-  useStore: (_service: any, selector?: any) => {
-    if (selector) {
-      return [
-        { path: '/', component: 'HomePage' },
-        { path: '/about', component: 'AboutPage' }
-      ];
-    }
-    return [];
-  }
-}));
-
-// Mock ComboProvider - force children to render
-vi.mock('@/uikit/components/ComboProvider', () => ({
-  ComboProvider: ({ children }: any) => children
-}));
-
-// Mock AppRouterProvider - return our mocked router structure
-vi.mock('@/uikit/components/AppRouterProvider', () => ({
-  AppRouterProvider: () => (
-    <div data-testid="router-provider">
-      <div data-testid="router-basename">{routerPrefix}</div>
-      <div data-testid="router-routes-count">0</div>
-    </div>
-  )
-}));
-
-// Import App after all mocks
-import { ClientIOCRegister } from '@/core/clientIoc/ClientIOCRegister';
-import { appConfig } from '@/core/globals';
-
-describe('App Component with IOC Initialization', () => {
-  beforeAll(async () => {
-    /**
-     * Initialize IOC container with BootstrapClient.main()
-     * This is essential to register all services including DialogHandler
-     *
-     * Without this initialization, you'll get:
-     * "No bindings found for service: DialogHandler"
-     */
-    await BootstrapClient.main({
-      root: globalThis,
-      bootHref: 'http://localhost:3000',
-      ioc: testIOC,
-      iocRegister: new ClientIOCRegister({
-        pathname: '/',
-        appConfig: appConfig
-      })
-    });
-  });
-
-  it('should render without crashing', () => {
-    const { container } = render(<App />);
-    expect(container).toBeDefined();
-  });
-
-  it('should initialize and render the app structure', () => {
-    render(<App />);
-
-    // App should render successfully after IOC initialization
-    const routerProvider = screen.getByTestId('router-provider');
-    expect(routerProvider).toBeDefined();
-  });
-
-  it('should configure router with correct basename', () => {
-    render(<App />);
-
-    const routerBasename = screen.getByTestId('router-basename');
-    expect(routerBasename.textContent).toBe(routerPrefix);
-  });
-
-  it('should render without DialogHandler binding errors', () => {
-    // This test verifies that BootstrapClient.main() correctly initialized the IOC container
-    // If DialogHandler was not registered, this would throw an error
-    expect(() => render(<App />)).not.toThrow();
-  });
-});