@farris/cli 2.3.1 → 2.3.2

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
 });