generator-mico-cli 0.2.29 → 0.2.31

package/generators/subapp-react/templates/homepage/src/common/locale.ts

@@ -0,0 +1,80 @@
+/**
+ * 语言管理（与主应用 layout `umi_locale` 规则一致：URL > localStorage > 浏览器）
+ * 独立运行子应用时使用；qiankun 下 {@link getSubappCurrentLocale} 优先主应用 props.locale
+ */
+
+const LOCALE_STORAGE_KEY = 'umi_locale';
+const URL_PARAM_KEY = 'lang';
+
+export const SUPPORTED_LOCALES = ['zh-CN', 'en-US'] as const;
+export type SupportedLocale = (typeof SUPPORTED_LOCALES)[number];
+
+export const LOCALE = {
+  ZH_CN: 'zh-CN',
+  EN_US: 'en-US',
+} as const;
+
+const DEFAULT_LOCALE: SupportedLocale = 'en-US';
+
+function getLocaleFromUrl(): string | null {
+  if (typeof window === 'undefined') {
+    return null;
+  }
+  const urlParams = new URLSearchParams(window.location.search);
+  return urlParams.get(URL_PARAM_KEY);
+}
+
+function getLocaleFromStorage(): string | null {
+  if (typeof window === 'undefined') {
+    return null;
+  }
+  try {
+    return localStorage.getItem(LOCALE_STORAGE_KEY);
+  } catch {
+    return null;
+  }
+}
+
+function getBrowserLocale(): SupportedLocale {
+  if (typeof window === 'undefined') {
+    return DEFAULT_LOCALE;
+  }
+  const browserLang = navigator.language || (navigator as { userLanguage?: string }).userLanguage;
+  const locales = [...SUPPORTED_LOCALES];
+  if (locales.includes(browserLang as SupportedLocale)) {
+    return browserLang as SupportedLocale;
+  }
+  const langPrefix = browserLang.split('-')[0];
+  const matchedLocale = locales.find((locale) => locale.startsWith(langPrefix));
+  return matchedLocale || DEFAULT_LOCALE;
+}
+
+function isValidLocale(locale: string | null): locale is SupportedLocale {
+  if (!locale) {
+    return false;
+  }
+  return ([...SUPPORTED_LOCALES] as string[]).includes(locale);
+}
+
+export function getCurrentLocale(): SupportedLocale {
+  const urlLocale = getLocaleFromUrl();
+  if (isValidLocale(urlLocale)) {
+    return urlLocale;
+  }
+  const storageLocale = getLocaleFromStorage();
+  if (isValidLocale(storageLocale)) {
+    return storageLocale;
+  }
+  return getBrowserLocale();
+}
+
+export function setLocaleToStorage(locale: SupportedLocale): void {
+  if (typeof window === 'undefined') {
+    return;
+  }
+  try {
+    localStorage.setItem(LOCALE_STORAGE_KEY, locale);
+  } catch (error) {
+    console.error('Failed to save locale to localStorage:', error);
+  }
+}

package/generators/subapp-react/templates/homepage/src/common/logger.ts

@@ -1,38 +1,70 @@
 /**
  * 日志工具
- * 仅在开发环境下输出日志，生产环境自动静默
+ * - 开发环境：全量输出
+ * - 生产环境：默认仅 `error` 带前缀输出；可在**首屏 URL** 带 query 打开全量 `log` / `info` / `warn`（与 layout `apps/layout` 的 logger 行为一致）
  *
- * 使用 bind 保持原始调用位置，避免错误栈指向 logger 内部
+ * 生产开启方式：首次进入页面时地址栏带 `?debug=1`（或 `debug=true` / `yes`），
+ * 在**本 JS 模块加载时刻**解析一次并固定，后续路由或 query 变更**不会**再切换日志级别（需整页刷新带参 URL）。
+ *
+ * **安全与合规**：`debug` 仅用于临时排障；全量日志可能在控制台暴露业务或个人信息，**勿长期公开或转发**带 `debug` 的生产链接；若接入日志采集需自行脱敏。
+ *
+ * 使用 bind 保持原始调用位置，避免错误栈指向 logger 内部（在开启详细日志时）
  */
 
 const isDev = process.env.NODE_ENV === 'development';
 
-// 空操作函数（生产环境使用）
-const noop = (): void => {};
+/** Query 参数名；与主应用 layout 一致，勿随意改名以免已分享的排障链接失效 */
+export const DEBUG_LOGS_QUERY_KEY = 'debug';
 
-/**
- * 创建带前缀的日志函数
- * 使用 bind 绑定前缀，保持控制台显示正确的调用位置
- */
-const createLogger = (prefix: string) => {
-  if (!isDev) {
-    // 生产环境返回空操作
-    return {
-      log: noop,
-      info: noop,
-      warn: noop,
-      error: noop,
-    };
+/** 模块初始化时读取一次 `location.search`，之后不变 */
+function readVerboseDebugQueryOnce(): boolean {
+  if (typeof window === 'undefined') {
+    return false;
+  }
+  try {
+    const v = new URLSearchParams(window.location.search).get(DEBUG_LOGS_QUERY_KEY);
+    if (v == null || v === '') {
+      return false;
+    }
+    const normalized = v.toLowerCase();
+    return normalized === '1' || normalized === 'true' || normalized === 'yes';
+  } catch {
+    return false;
   }
+}
 
-  const formattedPrefix = `[${prefix}]`;
+/** 开发环境，或生产环境首屏 URL 已带 `debug` 开关（模块加载时确定）；供业务侧按需分支 */
+export const isAppDebugLogsEnabled: boolean = isDev || readVerboseDebugQueryOnce();
+
+const noop = (): void => {};
 
+function createVerboseHandlers(formattedPrefix: string) {
   return {
     log: console.log.bind(console, formattedPrefix),
     info: console.info.bind(console, formattedPrefix),
     warn: console.warn.bind(console, formattedPrefix),
     error: console.error.bind(console, formattedPrefix),
   };
+}
+
+function createQuietHandlers(formattedPrefix: string) {
+  return {
+    log: noop,
+    info: noop,
+    warn: noop,
+    error: console.error.bind(console, formattedPrefix),
+  };
+}
+
+/**
+ * 创建带前缀的日志函数
+ * 使用 bind 绑定前缀，保持控制台显示正确的调用位置（在开启详细日志时）
+ */
+const createLogger = (prefix: string) => {
+  const formattedPrefix = `[${prefix}]`;
+  return isAppDebugLogsEnabled
+    ? createVerboseHandlers(formattedPrefix)
+    : createQuietHandlers(formattedPrefix);
 };
 
 // 预定义的日志实例

package/generators/subapp-react/templates/homepage/src/common/mainApp.ts

@@ -15,6 +15,8 @@ export interface IMicroAppProps {
   request?: <T = any>(url: string, options?: any) => Promise<T>;
   /** 当前路由路径（由主应用传递，用于子应用内部路由切换） */
   routePath?: string;
+  /** 当前语言（与主应用 getCurrentLocale 一致，如 zh-CN / en-US），供国际化与 common-intl 对齐 */
+  locale?: string;
   /**
    * 按钮权限列表（与主应用 fetchUserInfo.button_perms 一致，由主应用 MicroAppLoader 注入）
    */

package/generators/subapp-react/templates/homepage/src/locales/en-US.ts

@@ -0,0 +1,6 @@
+export default {
+  'page.subapp.home.demoSectionTitle': 'i18n demo',
+  'page.subapp.home.title': 'Subapp home',
+  'page.subapp.home.umiOnly':
+    'Fallback copy provided only in subapp Umi locales',
+};

package/generators/subapp-react/templates/homepage/src/locales/zh-CN.ts

@@ -0,0 +1,6 @@
+export default {
+  'page.subapp.home.demoSectionTitle': '国际化示例',
+  'page.subapp.home.title': '子应用首页',
+  /** 仅存在于子应用 locales，用于演示 intl 无该 key 时走 Umi 兜底 */
+  'page.subapp.home.umiOnly': '仅子应用 Umi locales 提供的兜底文案',
+};

package/generators/subapp-react/templates/homepage/src/pages/index.less

@@ -28,6 +28,16 @@
     margin-bottom: @spacing-lg;
   }
 
+  &-intl-hint {
+    margin-bottom: @spacing-sm;
+    color: @color-text-2;
+  }
+
+  &-intl-meta {
+    font-size: @font-size-sm;
+    margin-top: @spacing-md;
+  }
+
   &-card {
     padding: @card-padding;
     // 卡片背景色 - 使用 color-text-5（亮色模式为白色）

package/generators/subapp-react/templates/homepage/src/pages/index.tsx

@@ -1,4 +1,5 @@
 import PermissionFilter from '@/components/PermissionFilter';
+import { useSubappIntl } from '@/common/intl';
 import { getRequestSource, request } from '@/common/request';
 import {
   Alert,
@@ -55,6 +56,14 @@ interface IListItem {
  * 4. Less 变量自动适配主应用的主题切换
  */
 export default function HomePage() {
+  const {
+    formatMessage,
+    commonIntlEnabled,
+    locale,
+    subappOwnIntl,
+    subappOwnIntlTag,
+  } = useSubappIntl();
+
   const [loading, setLoading] = useState(false);
   const [userInfo, setUserInfo] = useState<IUserInfo | null>(null);
   const [stats, setStats] = useState<IStatsData | null>(null);
@@ -144,6 +153,48 @@ export default function HomePage() {
 
       <Divider />
 
+      <Card
+        title={formatMessage({
+          id: 'page.subapp.home.demoSectionTitle',
+          defaultMessage: '国际化示例',
+        })}
+        style={{ marginBottom: 16 }}
+      >
+        <Title heading={4}>
+          {formatMessage({
+            id: 'page.subapp.home.title',
+            defaultMessage: '子应用首页',
+          })}
+        </Title>
+        <Paragraph className="subapp-intl-hint">
+          common-intl 优先样例(使用主应用的tag)：
+          {formatMessage({
+            id: 'cs_web_workbench_userlist_chat',
+            defaultMessage: '看到该文案代表未启用 主应用commonIntl 或中台无该 key',
+          })}
+        </Paragraph>
+        <Paragraph className="subapp-intl-hint">
+          common-intl 优先样例(使用子应用的tag)：
+          {formatMessage({
+            id: 'sdk_h5_ticket_you_can_leave_us_a_message_we_will_reply_within_24_hours',
+            defaultMessage: '看到该文案代表未启用 子应用commonIntl 或中台无该 key',
+          })}
+        </Paragraph>
+        <Paragraph className="<%= appName %>-intl-hint">
+          仅子应用 locales 的 key（intl 通常无该 key）：
+          {formatMessage({
+            id: 'page.subapp.home.umiOnly',
+            defaultMessage: '若仍见此默认文案，请检查 locales 是否注册该 id',
+          })}
+        </Paragraph>
+        <Paragraph type="secondary" className="<%= appName %>-intl-meta">
+          commonIntlEnabled: {String(commonIntlEnabled)} · locale: {locale}
+          {subappOwnIntl
+            ? ` · subappOwnIntl: true · tag: ${subappOwnIntlTag ?? '-'}`
+            : ' · subappOwnIntl: false'}
+        </Paragraph>
+      </Card>
+
       {/* 请求示例 */}
       <Spin loading={loading} style={{ display: 'block' }}>
         <Card

package/generators/subapp-react/templates/homepage/typings.d.ts

@@ -87,6 +87,18 @@ declare global {
     __MICO_CONFIG__?: {
       appName?: string;
       apiBaseUrl?: string;
+      /** 多语言中台（与 commonIntl 二选一字段名，见 common-intl intlRuntime） */
+      intl?: {
+        tag: string;
+        app_name: string;
+        indexedDBParams?: { dbName?: string };
+      };
+      /** 多语言中台保底配置（可选）；与 packages/common-intl README、子应用可选 intl 模块配合 */
+      commonIntl?: {
+        tag: string;
+        app_name: string;
+        indexedDBParams?: { dbName?: string };
+      };
       [key: string]: unknown;
     };
   }

package/generators/subapp-umd/README.md

@@ -0,0 +1,37 @@
+# subapp-umd 生成器
+
+在已有 Monorepo 的 `packages/` 下创建 UMD 组件包（Webpack 构建）。详见 [docs/generators.md#subapp-umd](../../docs/generators.md#subapp-umd)。
+
+## 快速索引
+
+| 文件 | 职责 |
+|---|---|
+| `index.js` | 生成器主体；无跨模块联动修改 |
+| `meta.json` | `mico list` 展示信息 |
+| `ignore-list.json` | 模板过滤清单 |
+| `templates/` | 模板根 |
+
+## 使用
+
+```bash
+cd <monorepo-root>
+mico create subapp-umd
+```
+
+要求 monorepo 根包含 `packages/` 目录。
+
+## Prompt 默认值
+
+| name | 默认 |
+|---|---|
+| `appName` | `.micorc.defaultUmdName` ?? `'my-widget'` |
+| `umdGlobalName` | `toPascal(appName)` |
+| `packageScope` | `.micorc.packageScope` ?? `detectPackageScope()` ?? `'@my-project'` |
+| `devPort` | `.micorc.umdDevPort` ?? `'9100'` |
+
+## 运行产物
+
+| URL | 说明 |
+|---|---|
+| `http://localhost:<devPort>/` | HTML 预览页 |
+| `http://localhost:<devPort>/<appName>.umd.js` | UMD JS，供主应用通过 `jsUrls` 接入 |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "generator-mico-cli",
-  "version": "0.2.29",
+  "version": "0.2.31",
   "description": "Yeoman generator for Mico CLI projects",
   "keywords": [
     "yeoman-generator",