@axewo/fin-micro 0.0.0-stage → 2.0.0

package/dist/types/vue/router-view-impl.d.ts

@@ -0,0 +1,41 @@
+import { SlotsType } from 'vue';
+import { MicroTab } from '../sdk';
+import { MicroRouteErrorCode } from './router-view';
+/**
+ * 页签内的 Vue Router 页面出口，必须位于 MicroTabCache 内，并已通过 app.use(router) 安装 Vue Router 4.5+。
+ * 固定使用创建时的 tab.key/route；支持路由 props、嵌套 RouterView、命名视图及 useRoute 独立上下文。
+ * loading 插槽接收 { tab }，error 插槽接收 { tab, code, retry }；不提供插槽时也会展示加载/错误与重试。
+ *
+ * 这里只解析与加载页面，不启动导航事务、不执行 Vue Router 导航守卫、不修改宿主页签和权限。
+ * redirect 不替代宿主 canOpen；业务必须保证重定向目标属于该应用已授权页面，鉴权仍由宿主/core 负责。
+ * 页面定位等价于从 START_LOCATION 发起解析：相对 redirect 以应用根为基准，函数 redirect 按公开契约只接收目标 route。
+ * 建议 redirect 使用绝对 path 或 name；不会把其他页签的全局 currentRoute 当作本页的导航来源。
+ * 页面跳转和离页确认应使用页面 SDK；不要通过 RouterLink/router.push 把全局路由当作宿主页签导航。
+ * 懒加载无法取消网络请求；卸载后忽略迟到结果，不再写入组件状态。模块加载后的组件 setup/render 异常由 Vue 错误边界处理。
+ */
+export declare const MicroRouteViewImpl: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+    name: {
+        type: StringConstructor;
+        default: string;
+    };
+}>, () => import('vue').VNode<import('vue').RendererNode, import('vue').RendererElement, {
+    [key: string]: any;
+}> | import('vue').VNode<import('vue').RendererNode, import('vue').RendererElement, {
+    [key: string]: any;
+}>[], {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+    name: {
+        type: StringConstructor;
+        default: string;
+    };
+}>> & Readonly<{}>, {
+    name: string;
+}, SlotsType<{
+    loading: {
+        tab: MicroTab;
+    };
+    error: {
+        tab: MicroTab;
+        code: MicroRouteErrorCode;
+        retry: () => Promise<void>;
+    };
+}>, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;

package/dist/types/vue/router-view.d.ts

@@ -0,0 +1,42 @@
+import { SlotsType } from 'vue';
+import { MicroTab } from '../sdk';
+/** 稳定的脱敏错误分类；不包含模块地址、原始异常消息或堆栈。 */
+export type MicroRouteErrorCode = 'NOT_FOUND' | 'LOAD_FAILED' | 'REDIRECT_LOOP' | 'RESOLVE_FAILED';
+/**
+ * 固定页签的 Vue Router 页面出口，需放在 MicroTabCache 内，并已安装 Vue Router 4.5+。
+ * name 指定命名视图，默认 default；loading 插槽接收 { tab }，error 接收 { tab, code, retry }。
+ * 不提供插槽时仍显示加载、错误和重试按钮；retry 返回 Promise<void>，重复点击不会并发加载。
+ *
+ * 仅实际渲染本组件时才动态加载路由实现；旧的 /vue 缓存和 SDK 用户不必安装可选 vue-router peer。
+ * 内部组件以同步 setup 注入固定 tab 和路由上下文，不依赖 async setup 或 Suspense。
+ * 页面只解析与加载，不执行 router.push/replace 或导航守卫；导航、canOpen 和离页确认仍由宿主/core/SDK负责。
+ * redirect 不替代 canOpen，也不会更改宿主 tab.route；相对 redirect 与函数 from 均以 START_LOCATION 为来源。
+ * 支持 Composition API useRoute 的独立快照；Options API this.$route / 模板 $route 仍读全局路由，不支持页签隔离。
+ * 懒加载请求不可取消，卸载后忽略迟到结果；组件 setup/render 异常交由 Vue 错误边界处理。
+ */
+export declare const MicroRouteView: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+    name: {
+        type: StringConstructor;
+        default: string;
+    };
+}>, () => import('vue').VNode<import('vue').RendererNode, import('vue').RendererElement, {
+    [key: string]: any;
+}> | import('vue').VNode<import('vue').RendererNode, import('vue').RendererElement, {
+    [key: string]: any;
+}>[], {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+    name: {
+        type: StringConstructor;
+        default: string;
+    };
+}>> & Readonly<{}>, {
+    name: string;
+}, SlotsType<{
+    loading: {
+        tab: MicroTab;
+    };
+    error: {
+        tab: MicroTab;
+        code: MicroRouteErrorCode;
+        retry: () => Promise<void>;
+    };
+}>, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;

package/dist/types/vue/tab-context.d.ts

@@ -0,0 +1,6 @@
+import { InjectionKey } from 'vue';
+import { MicroTab } from '../sdk';
+/** 页签边界注入创建时的身份，不会随宿主活动页改变。 */
+export declare const microTabKey: InjectionKey<MicroTab>;
+/** 在缓存页面 setup 中取得创建时的页签快照；必须位于 MicroTabCache 默认插槽内。 */
+export declare function useMicroTab(): MicroTab;

package/dist/vue.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("vue"),f=require("./sdk.cjs"),d=Symbol("micro-tab");function m(){const t=e.inject(d);if(!t)throw new Error("useMicroTab 必须在 MicroTabCache 内调用");return t}const y=e.defineComponent({name:"MicroRouteView",props:{name:{type:String,default:"default"}},slots:Object,setup(t,{slots:n}){const i=m(),a=e.shallowRef(),r=e.shallowRef(!1);let u=!1,c=!1;async function o(){if(!(u||c)){c=!0,r.value=!1;try{const l=await Promise.resolve().then(()=>require("./router-view-impl-BvOToV_Z.cjs"));u||(a.value=l.MicroRouteViewImpl)}catch{u||(r.value=!0)}finally{c=!1}}}return e.onBeforeUnmount(()=>{u=!0}),o(),()=>{var l,s;return a.value?e.h(a.value,{name:t.name},n):r.value?((l=n.error)==null?void 0:l.call(n,{tab:i,code:"LOAD_FAILED",retry:o}))??e.h("div",{role:"alert","data-micro-route-error":"LOAD_FAILED"},[e.h("p","页面加载失败（LOAD_FAILED）"),e.h("button",{type:"button",onClick:o},"重新加载")]):((s=n.loading)==null?void 0:s.call(n,{tab:i}))??e.h("p",{role:"status"},"页面加载中…")}}});function v(t){return{hasPermission:n=>f.hasPermission(e.toValue(t),n),hasAny:n=>f.hasAny(e.toValue(t),n),hasAll:n=>f.hasAll(e.toValue(t),n),can:n=>e.computed(()=>f.hasPermission(e.toValue(t),e.toValue(n)))}}const b=e.defineComponent({name:"MicroAppContainer",props:{appId:{type:String,required:!0},runtime:{type:Object,required:!0},retryDisabled:Boolean},setup(t){const n=e.shallowRef(),i=e.shallowRef(""),a=e.shallowRef(!1);let r=!1;async function u(c=!1){if(!(r||a.value||!c&&t.retryDisabled)){a.value=!0,i.value="";try{await t.runtime.mount(t.appId,n.value)}catch{r||(i.value="子应用加载失败，请重试或联系管理员")}finally{r||(a.value=!1)}}}return e.onMounted(()=>{u(!0)}),e.onBeforeUnmount(()=>{r=!0,t.runtime.unmount(t.appId).catch(()=>console.error("[fin-micro] 子应用资源释放失败"))}),()=>e.h("section",{style:{height:"100%",minHeight:"420px"},"aria-busy":a.value},[i.value?e.h("div",{role:"alert"},[e.h("p",i.value),e.h("button",{type:"button",disabled:t.retryDisabled||a.value,onClick:()=>{u()}},"重新加载")]):null,a.value?e.h("p",{role:"status"},"子应用加载中…"):null,e.h("div",{ref:n,style:{height:"100%",minHeight:"420px"}})])}});function p(t){const n=e.shallowRef(t.getState()),i=t.subscribe(a=>{n.value=a});return e.onBeforeUnmount(i),n}const M=e.defineComponent({name:"MicroTabBoundary",props:{tab:{type:Object,required:!0},active:Boolean},setup(t,{slots:n}){const i=Object.freeze({...t.tab});e.provide(d,i);const a=e.defineComponent({name:"MicroTabContent",setup:()=>()=>{var r;return(r=n.default)==null?void 0:r.call(n,{tab:i})}});return()=>e.h("section",{hidden:!t.active,"data-micro-tab":i.key},[e.h(e.KeepAlive,null,{default:()=>t.active?e.h(a):null})])}}),w=e.defineComponent({name:"MicroTabCache",props:{tabs:{type:Array,required:!0},activeKey:String,max:{type:Number,default:20}},setup(t,{slots:n}){const i=e.shallowRef([]);return e.watch(()=>[t.tabs,t.activeKey,t.max],()=>{const a=new Set(t.tabs.map(o=>o.key));let r=i.value.filter(o=>a.has(o.key));const u=t.tabs.find(o=>o.key===t.activeKey);u&&(r=[...r.filter(o=>o.key!==u.key),u]);const c=Number.isFinite(t.max)?Math.max(1,Math.floor(t.max)):20;for(;r.length>c;){const o=r.findIndex(l=>l.key!==t.activeKey);if(o<0)break;r.splice(o,1)}i.value=r},{immediate:!0,flush:"sync"}),()=>i.value.map(a=>e.h(M,{key:a.key,tab:a,active:a.key===t.activeKey},n))}});function g(t,n,i=()=>console.error("[fin-micro] 路由同步失败")){let a=!1,r,u=!1,c=0;async function o(){if(!u){u=!0;try{let s=-1;for(;!a&&r&&s!==c;){s=c;try{await n.replace(r.route,r)}catch(h){try{i(h)}catch{}}}}finally{u=!1}}}const l=t.ready(s=>{r=s,c++,o()});return()=>{a=!0,l()}}function k(t,n){const i=t.page(n.key);return e.onBeforeUnmount(i.dispose),i}exports.MicroAppContainer=b;exports.MicroRouteView=y;exports.MicroTabCache=w;exports.connectMicroRouter=g;exports.useMicroHost=p;exports.useMicroPage=k;exports.useMicroTab=m;exports.usePermission=v;

package/dist/vue.mjs

@@ -0,0 +1,180 @@
+import { inject as p, defineComponent as y, shallowRef as d, onBeforeUnmount as m, h as u, onMounted as M, provide as g, KeepAlive as k, watch as A, computed as w, toValue as s } from "vue";
+import { hasPermission as v, hasAll as x, hasAny as C } from "./sdk.mjs";
+const b = Symbol("micro-tab");
+function D() {
+  const e = p(b);
+  if (!e) throw new Error("useMicroTab 必须在 MicroTabCache 内调用");
+  return e;
+}
+const O = y({
+  name: "MicroRouteView",
+  props: { name: { type: String, default: "default" } },
+  slots: Object,
+  setup(e, { slots: t }) {
+    const r = D(), a = d(), n = d(!1);
+    let o = !1, c = !1;
+    async function i() {
+      if (!(o || c)) {
+        c = !0, n.value = !1;
+        try {
+          const l = await import("./router-view-impl-B1NzCGKV.mjs");
+          o || (a.value = l.MicroRouteViewImpl);
+        } catch {
+          o || (n.value = !0);
+        } finally {
+          c = !1;
+        }
+      }
+    }
+    return m(() => {
+      o = !0;
+    }), i(), () => {
+      var l, f;
+      return a.value ? u(a.value, { name: e.name }, t) : n.value ? ((l = t.error) == null ? void 0 : l.call(t, { tab: r, code: "LOAD_FAILED", retry: i })) ?? u("div", { role: "alert", "data-micro-route-error": "LOAD_FAILED" }, [
+        u("p", "页面加载失败（LOAD_FAILED）"),
+        u("button", { type: "button", onClick: i }, "重新加载")
+      ]) : ((f = t.loading) == null ? void 0 : f.call(t, { tab: r })) ?? u("p", { role: "status" }, "页面加载中…");
+    };
+  }
+});
+function L(e) {
+  return {
+    hasPermission: (t) => v(s(e), t),
+    hasAny: (t) => C(s(e), t),
+    hasAll: (t) => x(s(e), t),
+    can: (t) => w(() => v(s(e), s(t)))
+  };
+}
+const S = y({
+  name: "MicroAppContainer",
+  props: {
+    appId: { type: String, required: !0 },
+    runtime: { type: Object, required: !0 },
+    retryDisabled: Boolean
+  },
+  setup(e) {
+    const t = d(), r = d(""), a = d(!1);
+    let n = !1;
+    async function o(c = !1) {
+      if (!(n || a.value || !c && e.retryDisabled)) {
+        a.value = !0, r.value = "";
+        try {
+          await e.runtime.mount(e.appId, t.value);
+        } catch {
+          n || (r.value = "子应用加载失败，请重试或联系管理员");
+        } finally {
+          n || (a.value = !1);
+        }
+      }
+    }
+    return M(() => {
+      o(!0);
+    }), m(() => {
+      n = !0, e.runtime.unmount(e.appId).catch(() => console.error("[fin-micro] 子应用资源释放失败"));
+    }), () => u("section", { style: { height: "100%", minHeight: "420px" }, "aria-busy": a.value }, [
+      r.value ? u("div", { role: "alert" }, [
+        u("p", r.value),
+        u("button", { type: "button", disabled: e.retryDisabled || a.value, onClick: () => {
+          o();
+        } }, "重新加载")
+      ]) : null,
+      a.value ? u("p", { role: "status" }, "子应用加载中…") : null,
+      u("div", { ref: t, style: { height: "100%", minHeight: "420px" } })
+    ]);
+  }
+});
+function j(e) {
+  const t = d(e.getState()), r = e.subscribe((a) => {
+    t.value = a;
+  });
+  return m(r), t;
+}
+const T = y({
+  name: "MicroTabBoundary",
+  props: {
+    tab: { type: Object, required: !0 },
+    active: Boolean
+  },
+  setup(e, { slots: t }) {
+    const r = Object.freeze({ ...e.tab });
+    g(b, r);
+    const a = y({ name: "MicroTabContent", setup: () => () => {
+      var n;
+      return (n = t.default) == null ? void 0 : n.call(t, { tab: r });
+    } });
+    return () => u("section", { hidden: !e.active, "data-micro-tab": r.key }, [
+      u(k, null, { default: () => e.active ? u(a) : null })
+    ]);
+  }
+}), B = y({
+  name: "MicroTabCache",
+  props: {
+    tabs: { type: Array, required: !0 },
+    activeKey: String,
+    max: { type: Number, default: 20 }
+  },
+  setup(e, { slots: t }) {
+    const r = d([]);
+    return A(() => [e.tabs, e.activeKey, e.max], () => {
+      const a = new Set(e.tabs.map((i) => i.key));
+      let n = r.value.filter((i) => a.has(i.key));
+      const o = e.tabs.find((i) => i.key === e.activeKey);
+      o && (n = [...n.filter((i) => i.key !== o.key), o]);
+      const c = Number.isFinite(e.max) ? Math.max(1, Math.floor(e.max)) : 20;
+      for (; n.length > c; ) {
+        const i = n.findIndex((l) => l.key !== e.activeKey);
+        if (i < 0) break;
+        n.splice(i, 1);
+      }
+      r.value = n;
+    }, { immediate: !0, flush: "sync" }), () => r.value.map((a) => u(T, {
+      key: a.key,
+      tab: a,
+      active: a.key === e.activeKey
+    }, t));
+  }
+});
+function R(e, t, r = () => console.error("[fin-micro] 路由同步失败")) {
+  let a = !1, n, o = !1, c = 0;
+  async function i() {
+    if (!o) {
+      o = !0;
+      try {
+        let f = -1;
+        for (; !a && n && f !== c; ) {
+          f = c;
+          try {
+            await t.replace(n.route, n);
+          } catch (h) {
+            try {
+              r(h);
+            } catch {
+            }
+          }
+        }
+      } finally {
+        o = !1;
+      }
+    }
+  }
+  const l = e.ready((f) => {
+    n = f, c++, i();
+  });
+  return () => {
+    a = !0, l();
+  };
+}
+function q(e, t) {
+  const r = e.page(t.key);
+  return m(r.dispose), r;
+}
+export {
+  S as MicroAppContainer,
+  O as MicroRouteView,
+  B as MicroTabCache,
+  R as connectMicroRouter,
+  j as useMicroHost,
+  q as useMicroPage,
+  D as useMicroTab,
+  L as usePermission
+};

package/package.json

@@ -1,6 +1,94 @@
 {
   "name": "@axewo/fin-micro",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "2.0.0",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    },
+    "./browser": {
+      "types": "./dist/types/browser/index.d.ts",
+      "import": "./dist/browser.mjs",
+      "require": "./dist/browser.cjs"
+    },
+    "./iframe": {
+      "types": "./dist/types/iframe/index.d.ts",
+      "import": "./dist/iframe.mjs",
+      "require": "./dist/iframe.cjs"
+    },
+    "./sdk": {
+      "types": "./dist/types/sdk/index.d.ts",
+      "import": "./dist/sdk.mjs",
+      "require": "./dist/sdk.cjs"
+    },
+    "./core": {
+      "types": "./dist/types/core/index.d.ts",
+      "import": "./dist/core.mjs",
+      "require": "./dist/core.cjs"
+    },
+    "./vue": {
+      "types": "./dist/types/vue/index.d.ts",
+      "import": "./dist/vue.mjs",
+      "require": "./dist/vue.cjs"
+    },
+    "./runtime": {
+      "types": "./dist/types/runtime/index.d.ts",
+      "import": "./dist/runtime.mjs",
+      "require": "./dist/runtime.cjs"
+    }
+  },
+  "bin": {
+    "fin-micro": "./cli/index.mjs"
+  },
+  "files": [
+    "dist/**/*.mjs",
+    "dist/**/*.cjs",
+    "dist/**/*.d.ts",
+    "cli/index.mjs",
+    "scaffold"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": false,
+  "peerDependencies": {
+    "vue": "^3.4.0",
+    "vue-router": "^4.5.0"
+  },
+  "peerDependenciesMeta": {
+    "vue": {
+      "optional": true
+    },
+    "vue-router": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "wujie": "2.1.0"
+  },
+  "devDependencies": {
+    "vue-router": "^4.5.0",
+    "vue": "^3.5.0",
+    "vite": "^5.4.0",
+    "vite-plugin-dts": "^4.3.0",
+    "vitest": "^2.1.0",
+    "vue-tsc": "^2.1.0",
+    "typescript": "^5.6.0"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "vite build",
+    "test": "node ../../node_modules/vitest/vitest.mjs run",
+    "typecheck": "vue-tsc --noEmit -p tsconfig.json",
+    "test:cli": "node --test cli/create.test.mjs cli/scaffold.test.mjs",
+    "check:package": "node scripts/check-package.mjs"
+  }
 }

package/scaffold/base/index.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="zh-CN">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>__PROJECT_NAME__</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.ts"></script>
+  </body>
+</html>

package/scaffold/base/package.json.template

@@ -0,0 +1,33 @@
+{
+  "name": "__PROJECT_NAME__",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "check:runtime": "node scripts/check-runtime.mjs",
+    "predev": "npm run check:runtime",
+    "prebuild": "npm run check:runtime",
+    "dev": "vite",
+    "build": "vue-tsc --noEmit && vite build",
+    "preview": "vite preview",
+    "typecheck": "vue-tsc --noEmit"
+  },
+  "dependencies": {
+    "@axewo/fin-core": "2.1.1",
+    "@axewo/fin-micro": "__FIN_MICRO_VERSION__",
+    "@axewo/fin-ui": "__FIN_UI_VERSION__",
+    "@axewo/fin-editor": "2.0.1",
+    "@element-plus/icons-vue": "2.3.2",
+    "element-plus": "2.14.2",
+    "pinia": "2.3.1",
+    "vue": "3.5.13",
+    "vue-i18n": "^9.14.0",
+    "vue-router": "4.5.0"
+  },
+  "devDependencies": {
+    "@vitejs/plugin-vue": "5.2.1",
+    "typescript": "5.6.3",
+    "vite": "5.4.14",
+    "vue-tsc": "2.2.0"
+  }
+}

package/scaffold/base/scripts/check-runtime.mjs

@@ -0,0 +1,43 @@
+import { readdir, readFile } from 'node:fs/promises'
+import { join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+// 构建前检查安装包的实际导出，避免 Vite 链接失败被误认为登录或网络问题。
+const imports = new Map()
+let hostRouter = false
+async function scan(directory) {
+  for (const entry of await readdir(directory, { withFileTypes: true })) {
+    const file = join(directory, entry.name)
+    if (entry.isDirectory()) await scan(file)
+    else if (/\.(ts|vue)$/.test(entry.name)) {
+      const source = await readFile(file, 'utf8')
+      if (source.includes('connectWorkspaceRouter')) hostRouter = true
+      for (const match of source.matchAll(/import\s*\{([^}]+)\}\s*from\s*['"](@axewo\/[^'"]+)['"]/g)) {
+        const names = imports.get(match[2]) ?? new Set()
+        for (const part of match[1].split(',')) {
+          const name = part.trim()
+          if (name && !name.startsWith('type ')) names.add(name.split(/\s+as\s+/)[0])
+        }
+        imports.set(match[2], names)
+      }
+    }
+  }
+}
+export async function checkRuntime() {
+  await scan(fileURLToPath(new URL('../src', import.meta.url)))
+  const problems = []
+  for (const [specifier, names] of imports) {
+    try {
+      const module = await import(specifier)
+      for (const name of names) if (!(name in module)) problems.push(`${specifier} 缺少导出 ${name}`)
+      if (specifier === '@axewo/fin-micro' && hostRouter && module.hostRouterProtocol !== 1) {
+        problems.push('@axewo/fin-micro 缺少 hostRouterProtocol=1（真实 host 路由、local 页面和 url:false 连接器能力）')
+      }
+    } catch { problems.push(`${specifier} 无法加载，请检查安装版本及其依赖（不输出原始异常）`) }
+  }
+  if (problems.length) {
+    console.error('启动依赖能力检查失败：\n' + problems.join('\n') + '\n请安装与生成器配套构建的包，并重新运行 npm run check:runtime；不会自动改依赖。')
+    process.exitCode = 1
+  } else console.log('启动依赖能力检查通过')
+}
+await checkRuntime()

package/scaffold/base/src/components/.gitkeep

@@ -0,0 +1 @@
+# 预留可复用业务组件目录；宿主专属结构组件位于 layout。

package/scaffold/base/src/components/AppProviders.vue

@@ -0,0 +1,25 @@
+<script setup lang="ts">
+import { computed } from 'vue'
+import { FConfigProvider, useFinLocale, zhCN, en, type FinConfig } from '@axewo/fin-ui'
+import { ElConfigProvider } from 'element-plus'
+import elZhCN from 'element-plus/es/locale/lang/zh-cn'
+import elEn from 'element-plus/es/locale/lang/en'
+
+const props = withDefaults(defineProps<{ size?: FinConfig['size'] }>(), { size: 'default' })
+// bootstrap 已为当前应用安装 i18n；切换全局 locale 时，两套组件库同步更新。
+const { locale } = useFinLocale()
+const config = computed<FinConfig>(() => ({
+  locale: locale.value === 'en' ? en : zhCN,
+  size: props.size,
+}))
+const elementLocale = computed(() => locale.value === 'en' ? elEn : elZhCN)
+</script>
+
+<template>
+  <!-- config.locale 仅注入语言包，不能代替 app 安装 vue-i18n。 -->
+  <FConfigProvider :config="config">
+    <ElConfigProvider :locale="elementLocale" :size="config.size">
+      <slot />
+    </ElConfigProvider>
+  </FConfigProvider>
+</template>

package/scaffold/base/src/hooks/.gitkeep

@@ -0,0 +1 @@
+# 预留业务组合函数目录；不要在此复制核心导航、权限或页签状态机。

package/scaffold/base/src/layout/.gitkeep

@@ -0,0 +1 @@
+# 预留布局组件目录；仅在页面有实际布局职责时添加组件。

package/scaffold/base/src/locales/.gitkeep

@@ -0,0 +1 @@
+# 预留语言资源目录；当前模板未启用国际化，也未引入国际化依赖。

package/scaffold/base/src/locales/en.ts

@@ -0,0 +1,12 @@
+// 与中文保持相同的业务词条结构。
+export default {
+  demo: {
+    title: 'Locale and state demo',
+    description: 'Switch language, increment or reset. State belongs only to this app.',
+    count: 'Count: {count}',
+    doubled: 'Double count: {count}',
+    increment: 'Increment',
+    reset: 'Reset',
+    switchLanguage: 'Switch language',
+  },
+}

package/scaffold/base/src/locales/index.ts

@@ -0,0 +1,13 @@
+import type { App } from 'vue'
+import { installFinI18n } from '@axewo/fin-ui'
+import zhCN from './zh-CN'
+import en from './en'
+
+/** 每次 createApp 后独立安装，不在模块级共享可变 i18n 实例。 */
+export function installAppLocale(app: App): void {
+  // 工厂递归合并业务词条，不覆盖 fin-ui 内置语言包。
+  installFinI18n(app, {
+    locale: 'zh-CN', fallbackLocale: 'zh-CN', legacy: false,
+    messages: { 'zh-CN': zhCN, en },
+  })
+}

package/scaffold/base/src/locales/zh-CN.ts

@@ -0,0 +1,12 @@
+// 业务词条使用独立命名空间，与 fin-ui 内置 fin.* 词条合并。
+export default {
+  demo: {
+    title: '国际化与状态示例',
+    description: '切换语言、增加计数或重置，状态仅属于当前应用。',
+    count: '当前计数：{count}',
+    doubled: '双倍计数：{count}',
+    increment: '增加',
+    reset: '重置',
+    switchLanguage: '切换语言',
+  },
+}

package/scaffold/base/src/main.ts

@@ -0,0 +1,22 @@
+import 'element-plus/dist/index.css'
+import '@axewo/fin-ui/style.css'
+import './styles/index.css'
+import { createStartupLifecycle } from './utils/errorUtils'
+
+// 动态导入使配置解析等模块求值错误也进入脱敏启动边界。
+const { mount, unmount } = createStartupLifecycle(() => import('./bootstrap'))
+
+// 普通应用直接启动；Vue 子应用模板覆盖本入口，接入微前端生命周期。
+// fin-ui 公开根入口依赖 editor 与 icons，依赖已在公共 package.json 中显式声明。
+void mount()
+function onPageHide(event: PageTransitionEvent) {
+  // BFCache 返回时继续使用同一应用；保留监听以处理之后的普通离开。
+  if (!event.persisted) dispose()
+}
+function dispose() {
+  // 基座只清理自身实例，不注册 Wujie 子应用全局回调。
+  window.removeEventListener('pagehide', onPageHide)
+  unmount()
+}
+window.addEventListener('pagehide', onPageHide)
+if (import.meta.hot) import.meta.hot.dispose(dispose)

package/scaffold/base/src/router/.gitkeep

@@ -0,0 +1 @@
+# 路由目录由对应模板提供；宿主地址由 connectMicroBrowser 管理，不创建第二个 Vue Router。

package/scaffold/base/src/router/demo.ts

@@ -0,0 +1,6 @@
+import type { RouteRecordRaw } from 'vue-router'
+
+// 仅定义本地页面，不授予宿主菜单/页签权限；host 默认不自动安装。
+export const demoRoutes: RouteRecordRaw[] = [
+  { path: '/demo', name: 'demo', component: () => import('../views/DemoView.vue') },
+]

package/scaffold/base/src/router/index.ts

@@ -0,0 +1,13 @@
+import { createMemoryHistory, createRouter, type RouteRecordRaw, type Router } from 'vue-router'
+
+/**
+ * 每轮挂载创建独立路由，默认使用空路由表，业务可通过参数传入本地页面。
+ * 此通用工厂不拥有地址栏；host overlay 用真实 history 路由覆盖本文件，vue overlay 按嵌入模式选历史。
+ * 独立使用本工厂时须由调用方负责 URL 适配；本地路由不替代平台认证及 canOpen 检查。
+ * @param routes 本地页面路由表；省略时为空，不自动添加业务页面。
+ * @returns 独立 Router；调用方安装到 App，并在卸载时销毁 history。
+ * @throws 无效路由配置导致的 Vue Router 初始化异常原样抛出。
+ */
+export function createAppRouter(routes: RouteRecordRaw[] = []): Router {
+  return createRouter({ history: createMemoryHistory(), routes })
+}

package/scaffold/base/src/stores/.gitkeep

@@ -0,0 +1 @@
+# 预留跨页面业务状态目录；当前模板没有需要共享的业务状态，未引入状态管理依赖。

package/scaffold/base/src/stores/demo.ts

@@ -0,0 +1,12 @@
+import { computed, ref } from 'vue'
+import { defineStore } from 'pinia'
+
+// 只定义 store，不在模块顶层实例化；状态由当前应用安装的 Pinia 隔离。
+export const useDemoStore = defineStore('demo', () => {
+  const count = ref(0)
+  const doubled = computed(() => count.value * 2)
+  function increment(): void { count.value++ }
+  // setup store 显式提供重置 action，不使用 options store 的默认 $reset。
+  function reset(): void { count.value = 0 }
+  return { count, doubled, increment, reset }
+})

package/scaffold/base/src/stores/index.ts

@@ -0,0 +1,11 @@
+import { createPinia, type Pinia } from 'pinia'
+
+/**
+ * 每个 Vue App、每轮挂载独立创建状态容器，禁止导出跨应用共享的模块级单例。
+ * @returns 未安装的独立 Pinia；调用方通过 app.use 安装，卸载时通过 disposePinia 释放。
+ * @throws 不额外包装底层初始化异常。
+ * @remarks 无参数；业务 store 需在安装后使用，组件外调用须显式传入所属 Pinia。
+ */
+export function createAppPinia(): Pinia {
+  return createPinia()
+}

package/scaffold/base/src/styles/index.css

@@ -0,0 +1,18 @@
+:root { font-family: 'PingFang SC', 'Microsoft YaHei', sans-serif; color: #243247; background: #f4f6fa; font-synthesis: none; }
+* { box-sizing: border-box; }
+body { margin: 0; }
+button, input { font: inherit; }
+#app { min-height: 100vh; }
+.page { padding: 24px; }
+.panel { background: white; border-radius: 10px; padding: 24px; }
+.actions { display: flex; align-items: center; gap: 12px; margin: 16px 0; flex-wrap: wrap; }
+.feedback { color: #b45309; padding: 12px 24px; }
+.login { max-width: 440px; margin: 14vh auto; }
+.shell { display: grid; grid-template: 64px 1fr / 240px minmax(0, 1fr); height: 100vh; }
+.shell-header { grid-column: 1 / -1; display: flex; align-items: center; justify-content: space-between; padding: 0 24px; background: white; border-bottom: 1px solid #e5e7eb; }
+.sidebar { overflow: auto; background: white; border-right: 1px solid #e5e7eb; }
+.workspace { min-width: 0; overflow: auto; }
+.tabbar { display: flex; gap: 6px; padding: 12px; background: #fff; overflow: auto; }
+.tabbar .tab { display: flex; align-items: center; gap: 4px; }
+.micro-workspace { padding: 16px; }
+@media (max-width: 760px) { .shell { grid-template-columns: 170px minmax(0, 1fr); } .page { padding: 12px; } }

package/scaffold/base/src/types/.gitkeep

@@ -0,0 +1 @@
+# 预留跨模块业务类型目录；SDK 类型直接从对应依赖导入。