generator-mico-cli 0.2.31 → 0.2.32

package/generators/h5-react/templates/packages/request/umi.d.ts

@@ -0,0 +1,94 @@
+declare module 'umi' {
+  type WithPromise<T> = T | Promise<T>;
+
+  type AxiosResponse = import('./axios.d').AxiosResponse;
+  type AxiosError = import('./axios.d').AxiosError;
+  type AxiosInstance = import('./axios.d').AxiosInstance;
+  type RequestError = import('./axios.d').RequestError;
+  type AxiosRequestConfig = import('./axios.d').AxiosRequestConfig;
+
+  export type RequestInterceptorAxios = (
+    config: RequestOptions,
+  ) => WithPromise<RequestOptions>;
+
+  export type RequestInterceptorUmiRequest = (
+    url: string,
+    config: RequestOptions,
+  ) => WithPromise<{ url: string; options: RequestOptions }>;
+
+  export type RequestInterceptor =
+    | RequestInterceptorAxios
+    | RequestInterceptorUmiRequest;
+
+  export type ErrorInterceptor = (error: Error) => Promise<Error>;
+
+  export type ResponseInterceptor = <T = any>(
+    response: AxiosResponse<T>,
+  ) => WithPromise<AxiosResponse<T>>;
+
+  export type RequestInterceptorTuple =
+    | [RequestInterceptor, ErrorInterceptor]
+    | [RequestInterceptor]
+    | RequestInterceptor;
+
+  export type ResponseInterceptorTuple =
+    | [ResponseInterceptor, ErrorInterceptor]
+    | [ResponseInterceptor]
+    | ResponseInterceptor;
+
+  export type RequestOptions = AxiosRequestConfig & {
+    skipErrorHandler?: boolean;
+    requestInterceptors?: RequestInterceptorTuple[];
+    responseInterceptors?: ResponseInterceptorTuple[];
+    getResponse?: boolean;
+  };
+
+  export type RequestConfig<T = any> = RequestOptions & {
+    errorConfig?: {
+      errorHandler?: (error: RequestError, opts: RequestOptions) => void;
+      errorThrower?: (res: T) => void;
+    };
+  };
+
+  export interface Request {
+    <T = any>(
+      url: string,
+      opts: RequestOptions & { getResponse: true },
+    ): Promise<AxiosResponse<T>>;
+    <T = any>(
+      url: string,
+      opts: RequestOptions & { getResponse: false },
+    ): Promise<T>;
+    <T = any>(url: string, opts?: RequestOptions): Promise<T>;
+    <T = any>(url: string): Promise<T>;
+  }
+
+  export const request: Request;
+
+  export type UseRequestService<R = any, P extends any[] = any[]> = (
+    ...args: P
+  ) => R | Promise<R>;
+
+  export type UseRequestResult<R = any, P extends any[] = any[]> = {
+    data?: R;
+    error?: Error;
+    loading: boolean;
+    params: P;
+    run: (...args: P) => Promise<R>;
+    runAsync: (...args: P) => Promise<R>;
+    refresh: () => void;
+    refreshAsync: () => Promise<R>;
+    mutate: (data?: R | ((oldData?: R) => R)) => void;
+    cancel: () => void;
+    [key: string]: any;
+  };
+
+  export const useRequest: <R = any, P extends any[] = any[]>(
+    service: UseRequestService<R, P>,
+    options?: any,
+  ) => UseRequestResult<R, P>;
+
+  export const UseRequestProvider: any;
+
+  export const getRequestInstance: () => AxiosInstance;
+}

package/generators/h5-react/templates/packages/typescript/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "<%= packageScope %>/typescript",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module",
+  "main": "./tsconfig.base.json",
+  "exports": {
+    ".": "./tsconfig.base.json",
+    "./react": "./tsconfig.react.json"
+  }
+}

package/generators/h5-react/templates/packages/typescript/tsconfig.base.json

@@ -0,0 +1,23 @@
+{
+  "compilerOptions": {
+    "target": "esnext",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "incremental": true,
+    "baseUrl": "../../",
+    "paths": {
+      "@/*": ["${configDir}/src/*"],
+      // "<%= packageScope %>/*": ["./packages/*"]
+    }
+  },
+  "exclude": ["node_modules"]
+}
+  

package/generators/h5-react/templates/packages/typescript/tsconfig.react.json

@@ -0,0 +1,7 @@
+{
+  "extends": "./tsconfig.base.json",
+  "compilerOptions": {
+    "jsx": "react-jsx"
+  },
+}
+  

package/generators/h5-react/templates/packages/umi-config/eslint.config.ts

@@ -0,0 +1,12 @@
+import baseConfig from '<%= packageScope %>/eslint';
+import { defineConfig } from 'eslint/config';
+export default defineConfig([
+  ...baseConfig,
+  {
+    languageOptions: {
+      parserOptions: {
+        tsconfigRootDir: import.meta.dirname,
+      },
+    },
+  },
+]);

package/generators/h5-react/templates/packages/umi-config/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "<%= packageScope %>/umi-config",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module",
+  "main": "./src/index.ts",
+  "scripts": {
+    "lint": "eslint",
+    "lint:fix": "eslint --fix",
+    "postinstall": "umi setup",
+    "setup": "umi setup"
+  },
+  "exports": {
+    ".": "./src/index.ts",
+    "./config": "./src/config.ts",
+    "./config.dev": "./src/config.dev.ts",
+    "./config.prod.development": "./src/config.prod.development.ts",
+    "./config.prod": "./src/config.prod.ts",
+    "./config.prod.production": "./src/config.prod.production.ts",
+    "./config.prod.testing": "./src/config.prod.testing.ts"
+  },
+  "dependencies": {
+    "postcss-pxtorem": "^6.1.0"
+  },
+  "devDependencies": {
+    "umi": "catalog:",
+    "<%= packageScope %>/eslint": "workspace:^",
+    "@sentry/webpack-plugin": "^4.9.1",
+    "@types/postcss-pxtorem": "^6.1.0"
+  }
+}

package/generators/h5-react/templates/packages/umi-config/src/config.dev.ts

@@ -0,0 +1,34 @@
+// https://umijs.org/config/
+
+import { defineConfig } from 'umi';
+
+// ts
+import type { UmiConfig } from './type';
+
+const DEFAULT_PROXY = {
+  // 接口
+  '/api': {
+    target: 'https://api-test.micoplatform.com',
+    changeOrigin: true,
+    pathRewrite: {
+      '^/api': '',
+    },
+  },
+};
+
+/**
+ * @name dev 模式专属配置
+ * @description 仅产出 `umi dev` 阶段的 delta（默认 `/api` 代理）；
+ *              基础配置（mountElementId / 插件 / `monorepoRedirect` / ...）由子应用
+ *              `config/config.ts` 中的 {@link import('./config').createBaseConfig} 提供，
+ *              Umi 在加载时按 `config.ts` < `config.dev.ts` 顺序合并。
+ */
+export function createDevConfig(options: UmiConfig = {}): UmiConfig {
+  return defineConfig({
+    ...options,
+    proxy: {
+      ...DEFAULT_PROXY,
+      ...(options.proxy ?? {}),
+    },
+  });
+}

package/generators/h5-react/templates/packages/umi-config/src/config.prod.development.ts

@@ -0,0 +1,17 @@
+// https://umijs.org/config/
+
+import { defineConfig } from 'umi';
+
+// ts
+import type { UmiConfig } from './type';
+
+/**
+ * @name development 构建配置（`UMI_ENV=development`）
+ * @description 仅产出 development 环境的 delta；当前不上传 sourcemap、不挂 Sentry 插件，
+ *              故默认为空（保留扩展点）。构建公共 delta 由子应用 `config/config.prod.ts`
+ *              通过 {@link import('./config.prod').createProConfig} 注入；基础配置由
+ *              `config/config.ts` 提供。
+ */
+export function createDevelopmentConfig(options: UmiConfig = {}): UmiConfig {
+  return defineConfig(options);
+}

package/generators/h5-react/templates/packages/umi-config/src/config.prod.production.ts

@@ -0,0 +1,42 @@
+// https://umijs.org/config/
+
+import { defineConfig } from 'umi';
+import { applySentryPlugin } from './plugins/apply-sentry-plugin';
+
+//ts
+import type { UmiConfig } from './type';
+
+export interface ProductionConfigOptions {
+  /**
+   * @name 应用名称
+   * @description 用于 Sentry sourcemap 上传的 `urlPrefix` 段；与 `apps/<目录>/package.json` 的
+   *              `name` 一致；同时与子应用 `config/config.prod.ts` 中传给 `createProConfig` 的
+   *              `appName` 保持一致
+   */
+  appName: string;
+}
+
+/**
+ * @name production 构建配置（`UMI_ENV=production`）
+ * @description 仅产出 production 环境的 delta：`hidden-source-map` + Sentry sourcemap 上传。
+ *              构建公共 delta 由子应用 `config/config.prod.ts` 通过
+ *              {@link import('./config.prod').createProConfig} 注入；基础配置由
+ *              `config/config.ts` 提供。
+ */
+export function createProductionConfig(
+  { appName }: ProductionConfigOptions,
+  options: UmiConfig = {},
+): UmiConfig {
+  return defineConfig({
+    ...options,
+    devtool: 'hidden-source-map',
+    chainWebpack(memo, args) {
+      memo.optimization.runtimeChunk(false);
+      memo.plugins.delete('runtimePublicPath');
+      memo.output.chunkFilename('[name].[contenthash:8].async.js');
+      applySentryPlugin({ memo, appName });
+      options.chainWebpack?.(memo, args);
+      return memo;
+    },
+  });
+}

package/generators/h5-react/templates/packages/umi-config/src/config.prod.testing.ts

@@ -0,0 +1,17 @@
+// https://umijs.org/config/
+
+import { defineConfig } from 'umi';
+
+// ts
+import type { UmiConfig } from './type';
+
+/**
+ * @name testing 构建配置（`UMI_ENV=testing`）
+ * @description 仅产出 testing 环境的 delta；当前不上传 sourcemap、不挂 Sentry 插件，
+ *              故默认为空（保留扩展点）。构建公共 delta 由子应用 `config/config.prod.ts`
+ *              通过 {@link import('./config.prod').createProConfig} 注入；基础配置由
+ *              `config/config.ts` 提供。
+ */
+export function createTestingConfig(options: UmiConfig = {}): UmiConfig {
+  return defineConfig(options);
+}

package/generators/h5-react/templates/packages/umi-config/src/config.prod.ts

@@ -0,0 +1,56 @@
+// https://umijs.org/config/
+import { defineConfig } from 'umi';
+
+// ts
+import type { UmiConfig } from './type';
+
+export interface ProConfigOptions {
+  /**
+   * @name 应用名称
+   * @description 用于 `publicPath` / `cssPublicPath` 拼接，与 `apps/<目录>/package.json` 的 `name` 一致；
+   *              同时作为 Sentry sourcemap 上传的 `urlPrefix` 段
+   */
+  appName: string;
+}
+
+/**
+ * @name 构建公共配置
+ * @description 仅产出构建阶段共享的 delta：`publicPath: 'auto'` / `cssPublicPath: './'`、
+ *              `externals`（react / react-dom / @common-web/sentry）、
+ *              `chainWebpack` 中 `runtimeChunk(false)` + 删除 `runtimePublicPath` 插件 +
+ *              自定义异步 chunk 文件名（runtime 内联进入口 `umi.js`，宿主页只引一个入口 JS，
+ *              动态 `import()` 仍可按需切片，由 webpack 5 按 `document.currentScript.src` 解析 publicPath）。
+ */
+export function createProConfig(options: UmiConfig = {}): UmiConfig {
+  return defineConfig({
+    publicPath: 'auto',
+    cssPublicPath: './',
+
+    /**
+     * @name 外部依赖配置
+     * @description 将大型公共库排除打包，运行时从主应用获取
+     * @doc https://umijs.org/docs/api/config#externals
+     */
+    externals: {
+      react: 'React',
+      'react-dom': 'ReactDOM',
+      '@common-web/sentry': 'CommonWebSentry',
+    },
+    ...options,
+
+    /**
+     * @name 代码分割策略
+     * @description
+     * - `runtimeChunk(false)`：webpack runtime **必须内联进入口 `umi.js`**，宿主页只引一个入口 JS
+     * - 删除 `runtimePublicPath`：避免 Umi 用 `window.publicPath` 写空字符串覆盖 `publicPath: 'auto'`
+     *   异步 chunk 会沿用 webpack 5 按 `document.currentScript.src` 推算出的 publicPath
+     */
+    chainWebpack(memo, args) {
+      memo.optimization.runtimeChunk(false);
+      memo.plugins.delete('runtimePublicPath');
+      memo.output.chunkFilename('[name].[contenthash:8].async.js');
+      options.chainWebpack?.(memo, args);
+      return memo;
+    },
+  });
+}

package/generators/h5-react/templates/packages/umi-config/src/config.ts

@@ -0,0 +1,86 @@
+// https://umijs.org/config/
+
+import postcssPxtorem from 'postcss-pxtorem';
+import { defineConfig } from 'umi';
+
+// ts
+import type { UmiConfig } from './type';
+
+/**
+ * @name 应用基础配置
+ * @description 子应用 `config/config.ts` 的入口；包含 dev / build 都会用到的全部公共字段
+ *              （挂载点、history、Tailwind / request 插件、`monorepoRedirect`、`postcss-pxtorem` 等，
+ *              `codeSplitting` 沿用 Umi 默认 `bigVendors` 策略，不在此显式声明）。
+ *              `config.dev` / `config.prod.development` / `config.prod.testing` / `config.prod.production` 仅产出
+ *              对应环境的 delta，由 Umi 在加载时与本配置浅合并。
+ */
+export function createBaseConfig(options: UmiConfig = {}): UmiConfig {
+  return defineConfig({
+    /**
+     * @name 挂载元素 ID
+     * @description React 应用挂载的 DOM 元素 id
+     */
+    mountElementId: 'root',
+
+    publicPath: '/',
+
+    /**
+     * @name 基础路径
+     * @description 子应用的路由前缀
+     */
+    base: '/',
+
+    /**
+     * @name 路由历史模式
+     * @description 使用 Hash 路由（URL 形如 `/#/path`），无需服务端 fallback
+     */
+    history: { type: 'hash' },
+
+    /**
+     * @name 构建产物文件名 hash
+     * @description 为静态资源文件名追加内容 hash，利于缓存与更新
+     */
+    hash: false,
+
+    /**
+     * @name Tailwind CSS / Request 插件
+     * @doc https://umijs.org/docs/max/tailwindcss
+     */
+    plugins: ['@umijs/plugins/dist/tailwindcss', '@umijs/plugins/dist/request'],
+    tailwindcss: {},
+    request: {},
+
+    monorepoRedirect: {
+      srcDir: ['src'],
+      peerDeps: true,
+    },
+    mfsu: false,
+
+    /**
+     * @name moment 的国际化配置
+     */
+    ignoreMomentLocale: true,
+
+    /**
+     * @name 快速热更新配置
+     */
+    fastRefresh: true,
+
+    /**
+     * @name 其他配置
+     */
+    esbuildMinifyIIFE: true,
+
+    define: {
+      'process.env.NODE_ENV': process.env.NODE_ENV,
+    },
+    extraPostCSSPlugins: [
+      postcssPxtorem({
+        rootValue: 16,
+        propList: ['*'],
+        minPixelValue: 2,
+      }),
+    ],
+    ...options,
+  });
+}

package/generators/h5-react/templates/packages/umi-config/src/index.ts

@@ -0,0 +1,25 @@
+/**
+ * <%= projectName %>/umi-config
+ *
+ * 子应用 Umi 配置工厂。Umi 在加载时按
+ * config.ts < config.[UMI_ENV].ts < config.[dev|prod].ts < config.[dev|prod].[UMI_ENV].ts 的优先级**叠加合并**，
+ * 因此本包遵循"基础 + 环境 delta"的拆分；6 个工厂彼此**无继承**，由 Umi 在
+ * 子应用 config 目录加载时按文件名约定自然合并：
+ *
+ *   - config             → 子应用 config/config.ts 的入口（基础公共配置 + 路由）
+ *   - config.dev         → umi dev 阶段（dev 专属 delta，仅默认 /api 代理）
+ *   - config.prod        → umi build 阶段公共 delta（PUBLIC_PATH / chainWebpack / externals 等）
+ *   - config.prod.development → UMI_ENV=development umi build（环境专属 delta，当前为空）
+ *   - config.prod.testing     → UMI_ENV=testing umi build（环境专属 delta，当前为空）
+ *   - config.prod.production  → UMI_ENV=production umi build（环境专属 delta：sourcemap + Sentry）
+ */
+
+export { createBaseConfig } from './config';
+export { createDevConfig } from './config.dev';
+export { createProConfig, type ProConfigOptions } from './config.prod';
+export { createDevelopmentConfig } from './config.prod.development';
+export {
+  createProductionConfig,
+  type ProductionConfigOptions,
+} from './config.prod.production';
+export { createTestingConfig } from './config.prod.testing';

package/generators/h5-react/templates/packages/umi-config/src/plugins/apply-sentry-plugin.ts

@@ -0,0 +1,57 @@
+import { sentryWebpackPlugin } from '@sentry/webpack-plugin';
+import { version } from '../../../../package.json';
+
+import { defineConfig } from 'umi';
+type ChainWebpack = Parameters<typeof defineConfig>[0]['chainWebpack'] & {};
+type Memo = Parameters<ChainWebpack>[0];
+
+interface ApplySentryPluginOptions {
+  /** webpack-chain 实例（Umi chainWebpack 的参数） */
+  memo: Memo;
+  /** 应用名称，用于 urlPrefix 路径 */
+  appName: string;
+  /** Sentry project 名称，默认 '<%= projectName %>' */
+  project?: string;
+}
+
+/**
+ * 往 webpack-chain 配置上挂载 Sentry sourcemap 上传插件
+ */
+export function applySentryPlugin({
+  memo,
+  appName,
+  project = '<%= projectName %>',
+}: ApplySentryPluginOptions) {
+  // 使用 Legacy Upload 方式，自托管 Sentry 不支持 Debug ID / Artifact Bundle
+  memo.plugin('sentry').use(
+    class {
+      apply(compiler: unknown) {
+        sentryWebpackPlugin({
+          url: 'https://sentry.micoworld.net',
+          org: 'micocenter',
+          project,
+          authToken: process.env.SENTRY_AUTH_TOKEN,
+          release: {
+            name: version,
+            uploadLegacySourcemaps: {
+              // source map 文件路径
+              paths: ['./dist'],
+              ignore: ['node_modules'],
+              ext: ['js', 'map'],
+              // URL 前缀
+              urlPrefix: `~/<%= cdnPrefixPath %><%= projectName %>/${version}/${appName}`,
+            },
+          },
+          sourcemaps: {
+            disable: true,
+            // 上传后删除的 source map 文件
+            filesToDeleteAfterUpload: ['dist/**/*.map'],
+          },
+          errorHandler: (err: Error) => {
+            console.warn('SentryCliPlugin error:', err);
+          },
+        }).apply(compiler);
+      }
+    },
+  );
+}

package/generators/h5-react/templates/packages/umi-config/src/type.d.ts

@@ -0,0 +1,3 @@
+import { defineConfig } from 'umi';
+
+export type UmiConfig = ReturnType<typeof defineConfig>;

package/generators/h5-react/templates/packages/umi-config/tsconfig.json

@@ -0,0 +1,3 @@
+{
+  "extends": "./src/.umi/tsconfig.json"
+}

package/generators/h5-react/templates/packages/utils/eslint.config.ts

@@ -0,0 +1,12 @@
+import baseConfig from '<%= packageScope %>/eslint';
+import { defineConfig } from 'eslint/config';
+export default defineConfig([
+  ...baseConfig,
+  {
+    languageOptions: {
+      parserOptions: {
+        tsconfigRootDir: import.meta.dirname,
+      },
+    },
+  },
+]);

package/generators/h5-react/templates/packages/utils/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "<%= packageScope %>/utils",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module",
+  "main": "./src/index.ts",
+  "scripts": {
+    "lint": "eslint",
+    "lint:fix": "eslint --fix"
+  },
+  "exports": {
+    ".": "./src/index.ts",
+    "./*": "./src/*.ts"
+  },
+  "dependencies": {
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "dayjs": "^1.11.20",
+    "spark-md5": "^3.0.2",
+    "tailwind-merge": "^3.5.0"
+  },
+  "devDependencies": {
+    "<%= packageScope %>/eslint": "workspace:^",
+    "<%= packageScope %>/typescript": "workspace:^",
+    "@types/spark-md5": "^3.0.5"
+  }
+}

package/generators/h5-react/templates/packages/utils/src/date.ts

@@ -0,0 +1,21 @@
+import dayjs, { type ConfigType } from 'dayjs';
+
+/**
+ * 格式化日期
+ * @param date 日期
+ * @param format 格式
+ * @returns 格式化后的日期
+ */
+export function formatDate(date: ConfigType, format: string = 'YYYY.MM.DD') {
+  return dayjs(date).format(format);
+}
+
+/**
+ * 格式化日期（秒）
+ * @param Second 秒
+ * @param format 格式
+ * @returns 格式化后的日期
+ */
+export function formatDateBySecond(Second: number, format?: string) {
+  return formatDate(Second * 1000, format);
+}

package/generators/h5-react/templates/packages/utils/src/env.ts

@@ -0,0 +1,40 @@
+/**
+ * 是否是开发环境
+ */
+export const isDev = process.env.UMI_APP_ENV === 'development';
+
+/**
+ * 是否是测试环境
+ */
+export const isTest = process.env.UMI_APP_ENV === 'testing';
+
+/**
+ * 是否是生产环境
+ */
+export const isProd = process.env.UMI_APP_ENV === 'production';
+
+/**
+ * 是否是调试环境
+ */
+export const isDebug = isDev || isTest;
+
+/**
+ * 是否是Android
+ */
+export const isAndroid = (() => {
+  const userAgent = window.navigator.userAgent || '';
+  return userAgent.indexOf('Android') > -1 || userAgent.indexOf('Adr') > -1;
+})();
+
+/**
+ * 是否是iOS（含 iPadOS 13+ 默认的桌面版 UA）
+ */
+export const isIOS = (() => {
+  const userAgent = window.navigator.userAgent || '';
+  if (/\(i[^;]+;( U;)? CPU.+Mac OS X/.test(userAgent)) return true;
+  // iPadOS 13+ 默认使用 Mac 桌面 UA，需通过触控点数量识别
+  return (
+    /Macintosh;.*Mac OS X/.test(userAgent) &&
+    (window.navigator.maxTouchPoints ?? 0) > 1
+  );
+})();

package/generators/h5-react/templates/packages/utils/src/index.ts

@@ -0,0 +1,3 @@
+export * from './env';
+export * from './md5';
+export * from './tailwind';

package/generators/h5-react/templates/packages/utils/src/md5.ts

@@ -0,0 +1,17 @@
+import SparkMD5 from 'spark-md5';
+
+/**
+ * 计算文件的MD5值的Base64编码
+ * @param arrayBuffer 文件的二进制数据
+ * @returns 文件的MD5值的Base64编码
+ */
+export function md5DigestBase64(arrayBuffer: ArrayBuffer) {
+  const spark = new SparkMD5.ArrayBuffer();
+  spark.append(arrayBuffer);
+  const raw = spark.end(true); // 16 字节二进制字符串
+  let bin = '';
+  for (let i = 0; i < raw.length; i++) {
+    bin += String.fromCharCode(raw.charCodeAt(i) & 0xff);
+  }
+  return btoa(bin);
+}