@farris/cli 2.3.0 → 2.3.2

package/templates/mobile/src/router/index.ts

@@ -1,4 +1,4 @@
-import { createRouter, createWebHistory, type RouteRecordRaw } from 'vue-router';
+import { createRouter, createWebHashHistory, type RouteRecordRaw } from 'vue-router';
 
 // 生成器（farris-cli generate view --with-route）依赖下面的 routes 数组赋值形式；
 // 改动结构会导致路由无法自动注册。
@@ -16,7 +16,8 @@ export const routes: RouteRecordRaw[] = [
 ];
 
 const router = createRouter({
-  history: createWebHistory(import.meta.env.BASE_URL),
+  // hash 路由：微前端（IBP）下子应用 location 由宿主接管，hash 模式最稳妥
+  history: createWebHashHistory(),
   routes
 });
 

package/templates/web/.gitignore.tpl

@@ -11,6 +11,7 @@ node_modules
 package-lock.json
 .DS_Store
 dist
+dist-es
 dist-ssr
 coverage
 *.local

package/templates/web/farris.config.mjs

@@ -1,6 +1,10 @@
 import { fileURLToPath, URL } from 'node:url';
 
 export default {
+  // 相对路径 base：微前端（IBP）与静态托管（iGIX iframe）都适用
+  base: './',
+  routerMode: 'hash',
+  // iife: IBP 微前端单文件产物（默认）；如需普通 ESM 站点产物，执行 pnpm build:es
   format: "<%= format %>",
   // 输出目录  App模式默认值 './dist' Lib模式 './lib'
   // outDir: fileURLToPath(new URL('./dist', import.meta.url)),

package/templates/web/package.json

@@ -6,6 +6,7 @@
   "scripts": {
     "dev": "farris-cli dev",
     "build": "farris-cli build -ep",
+    "build:es": "farris-cli build --format es --outDir dist-es",
     "preview": "farris-cli preview",
     "test": "vitest run",
     "test:watch": "vitest",
@@ -23,6 +24,7 @@
     "@farris/cli": "<%= cliVersion %>",
     "@rushstack/eslint-patch": "^1.8.0",
     "@vitejs/plugin-vue": "^5.2.4",
+    "@vitejs/plugin-vue-jsx": "^3.0.0",
     "@vue/eslint-config-prettier": "^9.0.0",
     "@vue/eslint-config-typescript": "^13.0.0",
     "@vue/test-utils": "^2.4.6",
@@ -33,6 +35,7 @@
     "prettier": "^3.2.5",
     "typescript": "~5.4.0",
     "vite": "^5.4.19",
+    "vite-plugin-css-injected-by-js": "^3.5.2",
     "vitest": "^3.2.4",
     "vue-tsc": "^2.2.0",
     "sass": "^1.90.0"

package/templates/web/src/App.vue

@@ -1,5 +1,9 @@
 <script setup lang="ts">
 import { RouterLink, RouterView } from 'vue-router';
+import { setupMicroAppContext } from './micro/context';
+
+// 微前端环境：订阅主应用下发的上下文（语言 / 主题）
+setupMicroAppContext();
 </script>
 
 <template>

package/templates/web/src/main.ts

@@ -1,13 +1,47 @@
-import { createApp } from 'vue';
+import { createApp, type App as VueApp } from 'vue';
 import FarrisVue from '@farris/ui-vue';
 import '@farris/ui-vue/index.css';
 import App from './App.vue';
 import router from './router';<%= styleImport %>
 import { localResources } from './locales';
 
-const app = createApp(App);
+let app: VueApp | null = null;
 
-app.use(FarrisVue, { basePath: '', locale: 'zh-CN', localResources });
-app.use(router);
+/** 挂载应用（微前端宿主会调用 window.mount） */
+function mount(): void {
+  if (app) {
+    return;
+  }
+  app = createApp(App);
+  app.use(FarrisVue, { basePath: '', locale: 'zh-CN', localResources });
+  app.use(router);
+  app.mount('#app');
 
-app.mount('#app');
+  // 微前端环境：按平台下发的 initialPath 定位菜单配置的页面（fullPath）
+  // hash 路由必须保留这段兜底；history 路由下平台 defaultPage 已能直接命中，这里是幂等兜底
+  if (window.__MICRO_APP_ENVIRONMENT__) {
+    const rawPath = window.microApp?.getData?.()?.initialPath;
+    if (typeof rawPath === 'string' && rawPath !== '') {
+      // 平台下发的 initialPath 通常不带前导斜杠（如 'form'），这里统一归一化
+      const initialPath = rawPath.startsWith('/') ? rawPath : '/' + rawPath;
+      if (initialPath !== '/') {
+        router.isReady().then(() => router.replace(initialPath)).catch(() => undefined);
+      }
+    }
+  }
+}
+
+/** 卸载应用（微前端宿主会调用 window.unmount） */
+function unmount(): void {
+  app?.unmount();
+  app = null;
+}
+
+// 微前端（micro-app）生命周期契约：必须暴露到 window
+window.mount = mount;
+window.unmount = unmount;
+
+// 独立运行（浏览器直接访问 / iframe 嵌入）时自动挂载
+if (!window.__MICRO_APP_ENVIRONMENT__) {
+  mount();
+}

package/templates/web/src/micro/context.ts

@@ -0,0 +1,26 @@
+import { LocaleService } from '@farris/ui-vue';
+
+/**
+ * 订阅主应用通过 microApp.setGlobalData 下发的运行上下文（语言 / 主题）。
+ * 仅在微前端（micro-app）环境中生效，独立运行时不做任何处理。
+ */
+export function setupMicroAppContext(): void {
+    if (!window.__MICRO_APP_ENVIRONMENT__) {
+        return;
+    }
+
+    window.microApp?.addGlobalDataListener?.((data) => {
+        if (!data) {
+            return;
+        }
+        // 语言：主应用下发 language，同步 Farris 组件库语言
+        const i18n = (LocaleService as any)?.i18n;
+        if (typeof data.language === 'string' && i18n?.global?.locale) {
+            i18n.global.locale.value = data.language;
+        }
+        // 主题：主应用下发 theme，写入根元素供主题样式使用
+        if (typeof data.theme === 'string') {
+            document.documentElement.setAttribute('data-theme', data.theme);
+        }
+    }, true);
+}

package/templates/web/src/micro-app.d.ts

@@ -0,0 +1,20 @@
+export {};
+
+declare global {
+  interface Window {
+    /** micro-app 子应用环境标记（由宿主注入） */
+    __MICRO_APP_ENVIRONMENT__?: boolean;
+    /** 宿主注入的 micro-app API */
+    microApp?: {
+      addGlobalDataListener?: (callback: (data: any) => void, immediately?: boolean) => void;
+      setGlobalData?: (data: Record<string, any>) => void;
+      getData?: () => Record<string, any> | null;
+      router?: {
+        getBaseAppRouter?: () => any;
+      };
+    };
+    /** 微前端生命周期：宿主会调用这两个方法 */
+    mount?: () => void;
+    unmount?: () => void;
+  }
+}

package/templates/web/src/router/index.ts

@@ -1,4 +1,4 @@
-import { createRouter, createWebHistory, type RouteRecordRaw } from 'vue-router';
+import { createRouter, createWebHashHistory, type RouteRecordRaw } from 'vue-router';
 
 // 生成器（farris-cli generate view --with-route）依赖下面的 routes 数组赋值形式；
 // 改动结构会导致路由无法自动注册。
@@ -16,7 +16,8 @@ export const routes: RouteRecordRaw[] = [
 ];
 
 const router = createRouter({
-  history: createWebHistory(import.meta.env.BASE_URL),
+  // hash 路由：微前端（IBP）下子应用 location 由宿主接管，hash 模式最稳妥
+  history: createWebHashHistory(),
   routes
 });