generator-mico-cli 0.2.28 → 0.2.30

package/generators/micro-react/templates/packages/common-intl/src/utils.ts

@@ -1,482 +0,0 @@
-import { isIndexedDBSupported, openDatabase } from './indexedDBUtils';
-
-// ============ Window 类型扩展 ============
-
-/**
- * 扩展 Window 接口，声明微前端共享的全局翻译缓存
- */
-declare global {
-	interface Window {
-		__MICO_COMMON_INTL_TRANSLATIONS__?: Record<string, Record<string, string>>;
-	}
-}
-
-// ============ 常量定义 ============
-
-export const LANG = {
-  ZH_CN: 'zh_CN',
-  EN_US: 'en',
-  /** 阿拉伯语 */
-  AR_SA: 'ar',
-  /** 土耳其语 */
-  TR_TR: 'tr',
-} as const;
-
-export type ILang = (typeof LANG)[keyof typeof LANG];
-
-// ============ 类型定义 ============
-
-/**
- * 消息提示实例接口
- */
-export interface IMessageInstance {
-  error: (message: string) => unknown;
-  warning: (message: string) => unknown;
-}
-
-/**
- * 初始化国际化参数接口
- */
-export interface IInitIntlParams {
-  /** 请求实例，用于请求多语言数据 */
-  requestInstance: (
-    url: string,
-    options: { method: string; params: Record<string, string> },
-  ) => Promise<{
-    code: number;
-    data?: Record<string, string>;
-    errorMessage?: string;
-  }>;
-  /** 消息提示实例，必填，外部自定义消息提示 */
-  messageInstance: IMessageInstance;
-  /** 获取多语言数据的参数 */
-  fetchMultilingualDataParams: {
-    tag: string;
-    lang: ILang;
-    app_name: string;
-  };
-  /** IndexedDB 参数，可选 */
-  indexedDBParams?: {
-    dbName?: string;
-    dbVersion?: number;
-    storeName?: string;
-    keyPathKey?: string;
-  };
-}
-
-/**
- * i18n 函数参数接口
- */
-export interface II18nParams {
-  /** 翻译文案的 key */
-  key: string;
-  /** 插值数组 [AA, BB, CC, ... ZZ]，用于替换文案中的占位符 %AA% %BB% %CC% ... %ZZ% 等 */
-  interpolations?: Array<string | number | undefined>;
-  /** 兜底文案，当找不到翻译时返回 */
-  defaultMessage: string;
-}
-
-// ============ API 配置 ============
-
-const API_CONFIG = {
-  development: 'https://api-test.micoplatform.com/lang_server/pull',
-  testing: 'https://api-test.micoplatform.com/lang_server/pull',
-  production: 'https://api.micoplatform.com/lang_server/pull',
-};
-
-// ============ 全局状态 ============
-
-/**
- * 语言管理工具
- * 支持三种配置渠道，优先级从高到低：
- * 1. URL 参数 (lang)
- * 2. localStorage 配置 (umi_locale)
- * 3. 默认浏览器语言
- */
-
-const LOCALE_STORAGE_KEY = 'umi_locale';
-const URL_PARAM_KEY = 'lang';
-
-/**
- * 支持的语言列表
- */
-export const SUPPORTED_LOCALES = Object.values(LANG) as ILang[];
-
-/**
- * 默认语言
- */
-const DEFAULT_LOCALE: ILang = LANG.EN_US;
-
-/**
- * 从 URL 参数获取语言
- */
-function getLocaleFromUrl(): string | null {
-  if (typeof window === 'undefined') {
-    return null;
-  }
-  const urlParams = new URLSearchParams(window.location.search);
-  return urlParams.get(URL_PARAM_KEY);
-}
-
-/**
- * 从 localStorage 获取语言
- */
-function getLocaleFromStorage(): string | null {
-  if (typeof window === 'undefined') {
-    return null;
-  }
-  try {
-    return localStorage.getItem(LOCALE_STORAGE_KEY);
-  } catch {
-    return null;
-  }
-}
-
-/**
- * 获取浏览器默认语言
- */
-function getBrowserLocale(): ILang {
-  if (typeof window === 'undefined') {
-    return DEFAULT_LOCALE;
-  }
-  const browserLang = navigator.language;
-  // 检查语言前缀（如 zh-TW -> zh-CN）
-  const langPrefix = browserLang.split('-')[0];
-  const matchedLocale = SUPPORTED_LOCALES.find((locale) =>
-    locale.startsWith(langPrefix),
-  );
-  return matchedLocale || DEFAULT_LOCALE;
-}
-
-/**
- * 验证语言是否支持
- */
-function isValidLocale(locale: string | null): locale is ILang {
-  if (!locale) {
-    return false;
-  }
-  return SUPPORTED_LOCALES.includes(locale as ILang);
-}
-
-/**
- * 获取当前语言（按优先级）
- * 优先级：URL 参数 > localStorage > 浏览器默认语言
- */
-export function getCurrentLocale(): ILang {
-  // 1. 优先从 URL 参数获取
-  const urlLocale = getLocaleFromUrl();
-  if (isValidLocale(urlLocale)) {
-    return urlLocale;
-  }
-
-  // 2. 从 localStorage 获取
-  const storageLocale = getLocaleFromStorage();
-  if (isValidLocale(storageLocale)) {
-    return storageLocale;
-  }
-
-  // 3. 使用浏览器默认语言
-  return getBrowserLocale();
-}
-
-/**
- * 设置语言到 localStorage
- */
-export function setLocaleToStorage(locale: ILang): void {
-  if (typeof window === 'undefined') {
-    return;
-  }
-  try {
-    localStorage.setItem(LOCALE_STORAGE_KEY, locale);
-  } catch (error) {
-    console.error('Failed to save locale to localStorage:', error);
-  }
-}
-
-/**
- * 获取共享的翻译缓存对象
- */
-function getSharedTranslationsCache(): Record<string, Record<string, string>> {
-	if (typeof window !== "undefined") {
-		if (!window.__MICO_COMMON_INTL_TRANSLATIONS__) {
-			window.__MICO_COMMON_INTL_TRANSLATIONS__ = {};
-		}
-		return window.__MICO_COMMON_INTL_TRANSLATIONS__;
-	}
-  // 非浏览器环境使用本地缓存
-  return {};
-}
-
-/**
- * IndexedDB 配置
- */
-let dbConfig = {
-  dbName: 'mico_cs_i18n_db',
-  dbVersion: 1,
-  storeName: 'translations',
-  keyPathKey: 'locale',
-};
-
-// ============ IndexedDB 存储相关 ============
-
-/**
- * 将翻译数据存储到 IndexedDB
- * @param locale 语言环境
- * @param translations 翻译数据
- */
-async function saveTranslationsToStorage(
-  locale: ILang,
-  translations: Record<string, string>,
-): Promise<void> {
-  // 同时更新全局变量缓存（使用共享缓存，支持微前端）
-  getSharedTranslationsCache()[locale] = translations;
-
-  if (!isIndexedDBSupported()) {
-    return;
-  }
-
-  try {
-    const database = await openDatabase(
-      dbConfig.dbName,
-      dbConfig.dbVersion,
-      dbConfig.storeName,
-      dbConfig.keyPathKey,
-    );
-    const transaction = database.transaction(dbConfig.storeName, 'readwrite');
-    const store = transaction.objectStore(dbConfig.storeName);
-
-    return new Promise((resolve, reject) => {
-      const request = store.put({ locale, translations });
-      request.onsuccess = () => resolve();
-      request.onerror = () => reject(request.error);
-    });
-  } catch (error) {
-    console.error('保存翻译数据到 IndexedDB 失败:', error);
-  }
-}
-
-/**
- * 从 IndexedDB 获取翻译数据
- * @param locale 语言环境
- */
-async function getTranslationsFromStorage(
-  locale: ILang,
-): Promise<Record<string, string> | null> {
-  // 优先从全局变量缓存获取（使用共享缓存，支持微前端）
-  const sharedCache = getSharedTranslationsCache();
-  if (sharedCache[locale]) {
-    return sharedCache[locale];
-  }
-
-  if (!isIndexedDBSupported()) {
-    return null;
-  }
-
-  try {
-    const database = await openDatabase(
-      dbConfig.dbName,
-      dbConfig.dbVersion,
-      dbConfig.storeName,
-      dbConfig.keyPathKey,
-    );
-    const transaction = database.transaction(dbConfig.storeName, 'readonly');
-    const store = transaction.objectStore(dbConfig.storeName);
-
-    return new Promise((resolve, reject) => {
-      const request = store.get(locale);
-      request.onsuccess = () => {
-        const result = request.result;
-        if (result) {
-          // 同步到全局变量缓存（使用共享缓存，支持微前端）
-          getSharedTranslationsCache()[locale] = result.translations;
-          resolve(result.translations);
-        } else {
-          resolve(null);
-        }
-      };
-      request.onerror = () => reject(request.error);
-    });
-  } catch (error) {
-    console.error('从 IndexedDB 获取翻译数据失败:', error);
-    return null;
-  }
-}
-
-/**
- * 同步获取翻译数据（仅从全局变量缓存获取）
- * @param locale 语言环境
- */
-function getTranslationsFromCacheSync(
-  locale: ILang,
-): Record<string, string> | null {
-  // 使用共享缓存，支持微前端
-  return getSharedTranslationsCache()[locale] || null;
-}
-
-// ============ i18n 函数 ============
-
-/**
- * 国际化翻译函数
- *
- * 从全局变量缓存中获取翻译后的文案，支持插值替换
- *
- * @param params 参数对象
- * @param params.key 翻译文案的 key
- * @param params.interpolations 插值数组，用于替换文案中的占位符
- * @param params.defaultMessage 兜底文案，当找不到翻译时返回
- * @returns 翻译后的文案
- *
- * @example
- * // 无插值示例
- * i18n({ key: 'common_cancel', defaultMessage: '取消' })
- * // 返回 'Cancel' 或兜底文案 '取消'
- *
- * @example
- * // 单个插值示例
- * i18n({ key: 'common_page_total_count', interpolations: [pagination.total], defaultMessage: `总数量: ${pagination.total}条` })
- * // 如果翻译文案为 '总数量: %AA%条'，则返回 '总数量: 100条'
- *
- * @example
- * // 多个插值示例
- * i18n({ key: 'some_key', interpolations: [valueA, valueB, valueC], defaultMessage: `XXX${valueA}YYY${valueB}ZZZ${valueC}` })
- * // 如果翻译文案为 'XXX%AA%YYY%BB%ZZZ%CC%'，则按顺序替换占位符
- */
-export function i18n({
-  key,
-  interpolations = [],
-  defaultMessage,
-}: II18nParams): string {
-  // 从缓存同步获取翻译数据（使用共享语言环境，支持微前端）
-  const translations = getTranslationsFromCacheSync(getCurrentLocale());
-
-  // 获取翻译文案，如果没有则使用兜底文案
-  let text = translations?.[key] || defaultMessage;
-
-  // 处理插值替换
-  // 占位符格式：%AA% %BB% %CC% ... %ZZ%
-  if (interpolations.length > 0) {
-    const placeholderPattern = /%([A-Z]{2})%/g;
-    let placeholderIndex = 0;
-
-    text = text.replace(placeholderPattern, () => {
-      if (placeholderIndex < interpolations.length) {
-        const value = interpolations[placeholderIndex];
-        placeholderIndex++;
-        return String(value ?? '');
-      }
-      return '';
-    });
-  }
-
-  return text;
-}
-
-// ============ 初始化函数 ============
-
-/**
- * 初始化国际化模块
- *
- * @param params 初始化参数
- * @returns 返回配置好的 fetchMultilingualData 函数
- *
- * @example
- * const fetchMultilingualData = initIntl({
- *   requestInstance: request,
- *   messageInstance: {
- *     error: (msg) => Toast.error(msg),
- *     warning: (msg) => Toast.warn(msg),
- *   },
- *   fetchMultilingualDataParams: {
- *     tag: 'cs_fe_mobile',
- *     lang: 'zh-CN',
- *     app_name: 'middle',
- *   },
- *   indexedDBParams: {
- *     dbName: 'mico_cs_mobile_i18n_db',
- *   },
- * });
- */
-export function initIntl(params: IInitIntlParams) {
-  const {
-    requestInstance,
-    messageInstance,
-    fetchMultilingualDataParams,
-    indexedDBParams,
-  } = params;
-
-  // 合并默认 IndexedDB 参数
-  dbConfig = {
-    dbName: 'mico_cs_i18n_db',
-    dbVersion: 1,
-    storeName: 'translations',
-    keyPathKey: 'locale',
-    ...indexedDBParams,
-  };
-
-  // 设置当前语言环境到 window，支持微前端共享
-  // setCurrentLocaleToGlobal(fetchMultilingualDataParams.lang);
-
-  /**
-   * 获取多语言中台接口
-   * @returns Promise 回调可以获取当前多语言数据
-   */
-  return function fetchMultilingualData(): Promise<Record<string, string>> {
-    const { tag, lang, app_name } = fetchMultilingualDataParams;
-
-    // 验证必填参数
-    if (!tag) {
-      throw new Error('参数 tag 不能为空');
-    }
-    if (!lang) {
-      throw new Error('参数 lang 不能为空');
-    }
-    if (!app_name) {
-      throw new Error('参数 app_name 不能为空');
-    }
-
-    // @ts-expect-error - process.env 类型在不同构建环境中可能不兼容
-    return requestInstance(process.env.LOCALE_REQUEST_URL || API_CONFIG[process.env.REACT_APP_ENV as keyof typeof API_CONFIG] || API_CONFIG.production, {
-      method: 'GET',
-      params: {
-        tag,
-        lang,
-        app_name,
-      },
-    })
-      .then((response) => {
-        if (response.code !== 0) {
-          const errorMessage = `${
-            response.errorMessage || '获取多语言文案失败'
-          }。响应码：${response.code}`;
-          console.error(errorMessage, response);
-          messageInstance.error(errorMessage);
-          return {};
-        }
-
-        const translations = response.data || {};
-
-        // 存储到 IndexedDB 和全局变量缓存
-        saveTranslationsToStorage(getCurrentLocale(), translations).catch(
-          (error) => {
-            console.error('存储翻译数据失败:', error);
-          },
-        );
-
-        return translations;
-      })
-      .catch(async (error) => {
-        const errorMessage = error.message || '获取多语言文案失败';
-        console.error(errorMessage, error);
-        messageInstance.warning(errorMessage);
-
-        const cachedTranslations =
-          await getTranslationsFromStorage(getCurrentLocale());
-        if (cachedTranslations) {
-          console.warn('使用本地缓存的翻译文案');
-          return cachedTranslations;
-        }
-
-        return {};
-      });
-  };
-}

package/generators/micro-react/templates/packages/common-intl/vite.config.ts

@@ -1,25 +0,0 @@
-import { defineConfig } from 'vite';
-import dts from 'vite-plugin-dts';
-
-export default defineConfig({
-  plugins: [
-    dts({
-      insertTypesEntry: true,
-      outDir: 'dist',
-    }),
-  ],
-  build: {
-    lib: {
-      entry: './src/index.ts',
-      formats: ['es'],
-      fileName: 'index',
-    },
-    outDir: 'dist',
-    emptyOutDir: true,
-    sourcemap: false,
-    rollupOptions: {
-      // 不打包外部依赖
-      external: [],
-    },
-  },
-});