@4399ywkf/cli 1.0.7 → 1.0.8

package/dist/templates/app/package.json.tpl

@@ -59,20 +59,11 @@
     "universal-cookie": "^8.0.1",
     "url-join": "^5.0.0",
     "uuid": "^11.0.3",
+    "zod": "^4.2.1",
     "zustand": "^5.0.5",
     "zustand-utils": "^2.1.1"
   },
   "devDependencies": {
-    "@babel/core": "^7.26.0",
-    "@babel/plugin-proposal-class-properties": "^7.18.6",
-    "@babel/plugin-proposal-decorators": "^7.25.9",
-    "@babel/plugin-proposal-optional-chaining": "^7.21.0",
-    "@babel/plugin-syntax-dynamic-import": "^7.8.3",
-    "@babel/plugin-transform-runtime": "^7.25.9",
-    "@babel/preset-env": "^7.26.0",
-    "@babel/preset-react": "^7.25.9",
-    "@babel/runtime": "^7.26.0",
-    "@babel/runtime-corejs3": "^7.26.0",
     "@biomejs/biome": "2.3.2",
     "@pmmmwh/react-refresh-webpack-plugin": "^0.5.15",
     "@rsdoctor/rspack-plugin": "^1.3.8",

package/dist/templates/app/react-app-env.d.ts

@@ -1,13 +1,18 @@
 // typings.d.ts
-declare module '*.css';
-declare module '*.less';
-declare module '*.png';
-declare module '*.jpeg';
-declare module '*.jpg';
-declare module '*.scss';
-declare module '*.svg' {
+declare module "*.css";
+declare module "*.less";
+declare module "*.png";
+declare module "*.jpeg";
+declare module "*.jpg";
+declare module "*.scss";
+declare module "*.woff";
+declare module "*.woff2";
+declare module "*.ttf";
+declare module "*.eot";
+declare module "*.otf";
+declare module "*.svg" {
   export function ReactComponent(
-    props: React.SVGProps<SVGSVGElement>,
+    props: React.SVGProps<SVGSVGElement>
   ): React.ReactElement;
   const url: string;
   export default url;

package/dist/templates/app/src/bootstrap/index.ts

@@ -0,0 +1,34 @@
+import "dayjs/locale/zh-cn";
+import dayjs from "dayjs";
+import { ConfigProvider } from "antd";
+import { env } from "@/config/env";
+
+interface BootstrapConfig {
+  appName: string;
+}
+
+/**
+ * 应用启动前的初始化配置
+ */
+export function bootstrap(config: BootstrapConfig) {
+  const { appName } = config;
+
+  // 配置 dayjs 国际化
+  dayjs.locale("zh-cn");
+
+  // 配置 antd 静态方法的前缀
+  ConfigProvider.config({
+    prefixCls: appName,
+  });
+
+  console.log(`✅ Application [${appName}] bootstrapped successfully`);
+}
+
+/**
+ * 使用环境变量初始化应用
+ */
+export function bootstrapWithEnv() {
+  bootstrap({
+    appName: env.APP_NAME,
+  });
+}

package/dist/templates/app/src/config/env.ts

@@ -0,0 +1,84 @@
+import { z } from "zod";
+
+/**
+ * 环境变量 Schema 定义
+ */
+const envSchema = z.object({
+  // Node 环境
+  NODE_ENV: z
+    .enum(["development", "test", "testDevelopment", "production"])
+    .default("development"),
+
+  // 应用配置
+  APP_NAME: z.string().min(1, "应用名称不能为空").default("app"),
+  APP_CNAME: z.string().default("应用"),
+  BASENAME: z.string().optional(),
+
+  // API 配置
+  API_PREFIX: z.string().default("/api"),
+  API_TIMEOUT: z
+    .string()
+    .transform(Number)
+    .pipe(z.number().positive())
+    .default(30000),
+
+  // Cookie 配置
+  COOKIE_NAME: z.string().default("access_token"),
+
+  // 其他配置
+  HELP_CENTER_URL: z.string().url().optional(),
+  OUTPUT_PATH: z.string().default("dist"),
+  PUBLIC_PATH: z.string().default("/"),
+});
+
+/**
+ * 安全解析环境变量（开发模式下使用默认值）
+ */
+function safeParseEnv() {
+  const result = envSchema.safeParse(process.env);
+
+  if (!result.success) {
+    if (process.env.NODE_ENV === "production") {
+      // 生产环境严格校验
+      console.error("❌ 环境变量验证失败:");
+      result.error.issues.forEach((err) => {
+        console.error(`  - ${err.path.join(".")}: ${err.message}`);
+      });
+      throw new Error("环境变量配置错误");
+    } else {
+      // 开发环境警告但不中断
+      console.warn("⚠️ 环境变量验证警告:");
+      result.error.issues.forEach((err) => {
+        console.warn(`  - ${err.path.join(".")}: ${err.message}`);
+      });
+    }
+  }
+
+  return result.success ? result.data : envSchema.parse({});
+}
+
+/**
+ * 导出类型安全的环境变量
+ */
+export const env = safeParseEnv();
+
+/**
+ * 环境变量类型
+ */
+export type Env = z.infer<typeof envSchema>;
+
+/**
+ * 工具函数：判断是否为开发环境
+ */
+export const isDev = env.NODE_ENV === "development";
+
+/**
+ * 工具函数：判断是否为生产环境
+ */
+export const isProd = env.NODE_ENV === "production";
+
+/**
+ * 工具函数：判断是否为测试环境
+ */
+export const isTest =
+  env.NODE_ENV === "test" || env.NODE_ENV === "testDevelopment";

package/dist/templates/app/src/index.tsx

@@ -1,53 +1,19 @@
-import "dayjs/locale/zh-cn";
-
-import { renderClient } from "@config/router";
-import { ConfigProvider } from "antd";
-import dayjs from "dayjs";
-import React from "react";
-
-import { createRouter } from "@/routes";
-import { openUpdateVersionNotify } from "@/utils/updateVersion";
-
-dayjs.locale("zh-cn");
-
 import "./index.css";
-
-const AppName = process.env.APP_NAME ?? "";
-const BASENAME = process.env.BASENAME;
-const VERSION_NOTIFY_TIME = process.env.VERSION_NOTIFY_TIME;
-
-// 配置antd 静态方法使用的
-ConfigProvider.config({
-  prefixCls: AppName,
-});
-
-const context = {
-  basename: BASENAME,
-  rootElement: document.getElementById(AppName) ?? document.body,
-};
-
-openUpdateVersionNotify(Number(VERSION_NOTIFY_TIME));
-
-// 子应用接入
-export const provider = () => {
-  let root: any = null;
-  return {
-    destroy() {
-      root?.unmount();
-    },
-    render({ basename }) {
-      // 更改basename的值
-      context.basename = basename;
-      root = renderClient(context);
-      window.Garfish.channel.emit("router", {
-        name: AppName,
-        routes: createRouter(basename),
-      });
-    },
-  };
-};
-
-// 添加单独启动逻辑
-if (!window.__GARFISH__) {
-  renderClient(context);
+import { renderClient } from "@config/router";
+import { bootstrapWithEnv } from "@/bootstrap";
+import { createGarfishProvider, isMicroApp } from "@/micro/garfish";
+import { env } from "@/config/env";
+
+// 初始化应用
+bootstrapWithEnv();
+
+// 微前端模式：导出 Garfish 生命周期
+export const provider = createGarfishProvider(env.APP_NAME);
+
+// 独立运行模式：直接渲染
+if (!isMicroApp()) {
+  renderClient({
+    basename: env.BASENAME,
+    rootElement: document.getElementById(env.APP_NAME) ?? document.body,
+  });
 }

package/dist/templates/app/src/layout/Locale.tsx

@@ -1,17 +1,17 @@
-import { ConfigProvider } from 'antd';
-import type { Locale as AntdLocale } from 'antd/es/locale';
-import dayjs from 'dayjs';
+import { ConfigProvider } from "antd";
+import type { Locale as AntdLocale } from "antd/es/locale";
+import dayjs from "dayjs";
 import React, {
   type PropsWithChildren,
   memo,
   useEffect,
   useState,
-} from 'react';
+} from "react";
 
-import { isRtlLang } from 'rtl-detect';
+import { isRtlLang } from "rtl-detect";
 
-import { createI18nNext } from '@/locales/create';
-import { getAntdLocale } from '@/utils/locale';
+import { createI18nNext } from "@/locales/create";
+import { getAntdLocale } from "@/utils/locale";
 
 const updateDayjs = async (lang: string) => {
   // load default lang
@@ -19,12 +19,12 @@ const updateDayjs = async (lang: string) => {
   try {
     // dayjs locale is using `en` instead of `en-US`
     // refs: https://github.com/lobehub/lobe-chat/issues/3396
-    const locale = lang.toLowerCase() === 'en-us' ? 'en' : lang.toLowerCase();
+    const locale = lang.toLowerCase() === "en-us" ? "en" : lang.toLowerCase();
 
     dayJSLocale = await import(`dayjs/locale/${locale}.js`);
   } catch {
     console.warn(`dayjs locale for ${lang} not found, fallback to en`);
-    dayJSLocale = await import('dayjs/locale/en.js');
+    dayJSLocale = await import("dayjs/locale/en.js");
   }
 
   dayjs.locale(dayJSLocale.default);
@@ -41,8 +41,6 @@ const Locale = memo<LocaleLayoutProps>(
     const [lang, setLang] = useState(defaultLang);
     const [locale, setLocale] = useState(antdLocale);
 
-    console.log(antdLocale, defaultLang);
-
     // if on browser side, init i18n instance only once
     if (!i18n.instance.isInitialized)
       // console.debug('locale', lang);
@@ -65,25 +63,23 @@ const Locale = memo<LocaleLayoutProps>(
         await updateDayjs(lng);
       };
 
-      i18n.instance.on('languageChanged', handleLang);
+      i18n.instance.on("languageChanged", handleLang);
       return () => {
-        i18n.instance.off('languageChanged', handleLang);
+        i18n.instance.off("languageChanged", handleLang);
       };
     }, [i18n, lang]);
 
     // detect document direction
-    const documentDir = isRtlLang(lang) ? 'rtl' : 'ltr';
-
-    console.log(documentDir, locale);
+    const documentDir = isRtlLang(lang) ? "rtl" : "ltr";
 
     return (
       <ConfigProvider direction={documentDir} locale={locale as AntdLocale}>
         {children}
       </ConfigProvider>
     );
-  },
+  }
 );
 
-Locale.displayName = 'Locale';
+Locale.displayName = "Locale";
 
 export default Locale;

package/dist/templates/app/src/layout/MainContentWrap.tsx

@@ -1,19 +1,15 @@
-import { ConfigProvider, theme } from 'antd';
-import type { Locale as AntdLocale } from 'antd/es/locale';
-import React, { useState, useEffect } from 'react';
+import React, { useState, useEffect } from "react";
 
-import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
-import { Outlet } from 'react-router';
-import '../index.css';
-import { DEFAULT_LANG } from '@/const/locale';
-import { useRouteTitle } from '@/hooks/useRouteTitle';
-import { getAntdLocale } from '@/utils/locale';
-import queryString from 'query-string';
-import Locale from './Locale';
-import AppTheme from './ThemeContext';
+import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
+import { Outlet } from "react-router";
+import "../index.css";
+import { DEFAULT_LANG } from "@/const/locale";
+import { getAntdLocale } from "@/utils";
+import queryString from "query-string";
+import Locale from "./Locale";
+import AppTheme from "./ThemeContext";
 
 export const MainContentWrap = () => {
-  useRouteTitle();
   const [antdLocale, setAntdLocale] = useState<unknown>(null);
   const [isLocaleLoaded, setIsLocaleLoaded] = useState(false);
 
@@ -32,11 +28,11 @@ export const MainContentWrap = () => {
     const loadLocale = async () => {
       try {
         const loadedLocale = await getAntdLocale(
-          (lang as string) ?? DEFAULT_LANG,
+          (lang as string) ?? DEFAULT_LANG
         );
         setAntdLocale(loadedLocale);
       } catch (error) {
-        console.error('Failed to load locale:', error);
+        console.error("Failed to load locale:", error);
         // 保持默认的中文 locale
       } finally {
         setIsLocaleLoaded(true);

package/dist/templates/app/src/layout/ThemeContext.tsx

@@ -1,14 +1,16 @@
-import ThemeProvider from '@/components/ThemeProvider';
-import { CLOUD_THEME_APPEARANCE } from '@/const/theme';
-import { setCookie } from '@/utils/cookie';
+import ThemeProvider from "@/components/ThemeProvider";
+import { CLOUD_THEME_APPEARANCE } from "@/const/theme";
+import { setCookie } from "@/utils/cookie";
 
 // import { useGlobalStore } from "@store/global";
-import React, { memo, useEffect, type ReactNode } from 'react';
+import React, { memo, useEffect, type ReactNode } from "react";
+
+import { SYSTEM_PREFIX } from "@/const/system";
+import { GlobalStyle } from "@/styles";
+import { useUserStore } from "@store/user";
+import { createStyles } from "antd-style";
+import HarmonyOS_Sans_Regular from "@public/fonts/HarmonyOS_Sans_Regular.woff2";
 
-import { SYSTEM_PREFIX } from '@/const/system';
-import { GlobalStyle } from '@/styles';
-import { useUserStore } from '@store/user';
-import { createStyles } from 'antd-style';
 const useStyles = createStyles(({ css, token }) => ({
   app: css`
     position: relative;
@@ -70,55 +72,56 @@ interface AppThemeProps {
 }
 
 const AppTheme = memo(({ children }: AppThemeProps) => {
-  const themeMode = useUserStore(s => s.themeMode);
-  const animationMode = useUserStore(s => s.animationMode);
-  const neutralColor = useUserStore(s => s.neutralColor);
-  const primaryColor = useUserStore(s => s.primaryColor);
+  const themeMode = useUserStore((s) => s.themeMode);
+  const animationMode = useUserStore((s) => s.animationMode);
+  const neutralColor = useUserStore((s) => s.neutralColor);
+  const primaryColor = useUserStore((s) => s.primaryColor);
   const { styles, cx } = useStyles();
 
   useEffect(() => {
     // Update data-theme accordingly if user selects light or dark
-    if (themeMode !== 'auto') {
+    if (themeMode !== "auto") {
       document.documentElement.dataset.theme = themeMode;
       return;
     }
 
     // For auto mode, we need to watch system preferences
-    const mediaQuery = window.matchMedia('(prefers-color-scheme: dark)');
+    const mediaQuery = window.matchMedia("(prefers-color-scheme: dark)");
 
     // Set initial theme based on system preference
     document.documentElement.dataset.theme = mediaQuery.matches
-      ? 'dark'
-      : 'light';
+      ? "dark"
+      : "light";
 
     // Update theme when system preference changes
     function handleChange(e) {
-      document.documentElement.dataset.theme = e.matches ? 'dark' : 'light';
+      document.documentElement.dataset.theme = e.matches ? "dark" : "light";
     }
 
-    mediaQuery.addEventListener('change', handleChange);
-    return () => mediaQuery.removeEventListener('change', handleChange);
+    mediaQuery.addEventListener("change", handleChange);
+    return () => mediaQuery.removeEventListener("change", handleChange);
   }, [themeMode]);
 
   return (
     <ThemeProvider
       prefixCls={SYSTEM_PREFIX}
-      appearance={themeMode !== 'auto' ? themeMode : undefined}
+      appearance={themeMode !== "auto" ? themeMode : undefined}
       className={cx(styles.app, styles.scrollbar, styles.scrollbarPolyfill)}
       customTheme={{
         neutralColor: neutralColor,
         primaryColor: primaryColor,
       }}
+      customFonts={[HarmonyOS_Sans_Regular]}
       theme={{
         cssVar: true,
         token: {
-          motion: animationMode !== 'disabled',
-          motionUnit: animationMode === 'agile' ? 0.05 : 0.1,
+          motion: animationMode !== "disabled",
+          motionUnit: animationMode === "agile" ? 0.05 : 0.1,
         },
       }}
       themeMode={themeMode}
-      onAppearanceChange={appearance => {
-        if (themeMode !== 'auto') return;
+      onAppearanceChange={(appearance) => {
+        if (themeMode !== "auto") return;
 
         setCookie(CLOUD_THEME_APPEARANCE, appearance);
       }}

package/dist/templates/app/src/locales/default/common.ts

@@ -1 +1,3 @@
-export default {};
+export default {
+  appName: "Chat应用",
+};

package/dist/templates/app/src/micro/garfish.ts

@@ -0,0 +1,53 @@
+import type { Root } from "react-dom";
+import { renderClient } from "@config/router";
+import { createRouter } from "@/routes";
+
+interface GarfishProvider {
+  render: (props: { basename: string }) => void;
+  destroy: () => void;
+}
+
+interface RenderContext {
+  basename?: string;
+  rootElement: HTMLElement | null;
+}
+
+/**
+ * Garfish 微前端生命周期适配器
+ */
+export function createGarfishProvider(appName: string): GarfishProvider {
+  let root: Root | null = null;
+
+  return {
+    render({ basename }: { basename: string }) {
+      const context: RenderContext = {
+        basename,
+        rootElement: document.getElementById(appName) ?? document.body,
+      };
+
+      root = renderClient(context);
+
+      // 向主应用通知路由信息
+      if (window.Garfish?.channel) {
+        window.Garfish.channel.emit("router", {
+          name: appName,
+          routes: createRouter(basename),
+        });
+      }
+    },
+
+    destroy() {
+      if (root) {
+        root.unmount();
+        root = null;
+      }
+    },
+  };
+}
+
+/**
+ * 判断是否在微前端环境中运行
+ */
+export function isMicroApp(): boolean {
+  return typeof window !== "undefined" && Boolean(window.__GARFISH__);
+}