@fulgurjs/federation 6.8.7 → 6.9.0

package/dist/runtime.js

@@ -1,4 +1,4 @@
-var ve=/^v?(\d+)(?:\.(\d+))?(?:\.(\d+))?(?:-((?:[0-9A-Za-z-]+)(?:\.[0-9A-Za-z-]+)*))?(?:\+[0-9A-Za-z.-]+)?$/;function N(l){let d=ve.exec(String(l).trim());return d?{major:Number(d[1]),minor:Number(d[2]??0),patch:Number(d[3]??0),pre:d[4]?d[4].split("."):[]}:null}function $e(l,d){if(l.length===0&&d.length===0)return 0;if(l.length===0)return 1;if(d.length===0)return-1;let f=Math.max(l.length,d.length);for(let c=0;c<f;c++){let m=l[c],y=d[c];if(m===void 0)return-1;if(y===void 0)return 1;let b=/^\d+$/.test(m),v=/^\d+$/.test(y);if(b&&v){let M=Number(m)-Number(y);if(M!==0)return M}else{if(b!==v)return b?-1:1;if(m!==y)return m<y?-1:1}}return 0}function I(l,d){let f=N(l),c=N(d);return!f||!c?l<d?-1:l>d?1:0:f.major!==c.major?f.major-c.major:f.minor!==c.minor?f.minor-c.minor:f.patch!==c.patch?f.patch-c.patch:$e(f.pre,c.pre)}var Pe=/^[a-z]+[+:-]/i;function x(l,d){if(d===!1||d==null||d==="")return!0;let f=String(d).trim();return!f||f==="*"||f==="latest"||Pe.test(f)?!0:f.split("||").some(c=>_e(l,c.trim()))}function _e(l,d){if(!d||d==="*")return!N(l)?.pre.length;let f=d.split(/\s+-\s+/);if(f.length===2){let y=f[0].trim(),b=f[1].trim();return!(!x(l,`>=${y}`)||!x(l,`<=${b}`))}let c=N(l);if(!c)return!1;let m=ke(d);if(m===null)return!0;for(let y of m)if(!Te(c,l,y))return!1;return!(c.pre.length>0&&!m.some(y=>y.ver.pre.length>0)&&!m.some(b=>b.ver.major===c.major&&b.ver.minor===c.minor&&b.ver.patch===c.patch))}function ke(l){let d=[],f=l.trim().split(/\s+/).filter(Boolean);if(f.length===0)return null;for(let c of f){let m=/^(>=|<=|>|<|=|\^|~)?(.*)$/.exec(c);if(!m)return null;let y=m[1],b=m[2],v=Le(y,b);if(v===null)return null;d.push(...v)}return d}function Le(l,d){let f=Ae(d);if(!f)return null;let{ver:c,partial:m}=f;switch(l){case"^":{let y=Oe(c);return y?[{op:">=",ver:c},{op:"<",ver:y}]:null}case"~":{let y=m>=2?{major:c.major,minor:c.minor+1,patch:0,pre:[]}:{major:c.major+1,minor:0,patch:0,pre:[]};return[{op:">=",ver:c},{op:"<",ver:y}]}case">=":return[{op:">=",ver:c}];case">":return m===1?[{op:">=",ver:{major:c.major+1,minor:0,patch:0,pre:[]}}]:m===2?[{op:">=",ver:{major:c.major,minor:c.minor+1,patch:0,pre:[]}}]:[{op:">",ver:c}];case"<":return m===1?[{op:"<",ver:{major:c.major,minor:0,patch:0,pre:[]}}]:m===2?[{op:"<",ver:{major:c.major,minor:c.minor,patch:0,pre:[]}}]:[{op:"<",ver:c}];case"<=":return[{op:"<=",ver:c}];case"=":case void 0:return m===1?[{op:">=",ver:c},{op:"<",ver:{major:c.major+1,minor:0,patch:0,pre:[]}}]:m===2?[{op:">=",ver:c},{op:"<",ver:{major:c.major,minor:c.minor+1,patch:0,pre:[]}}]:[{op:"=",ver:c}];default:return null}}function Oe(l){return l.major>0?{major:l.major+1,minor:0,patch:0,pre:[]}:l.minor>0?{major:0,minor:l.minor+1,patch:0,pre:[]}:{major:0,minor:0,patch:l.patch+1,pre:[]}}function Ae(l){let d=l.replace(/^v/,"").trim();if(!d||d==="*"||d==="x"||d==="X")return{ver:{major:0,minor:0,patch:0,pre:[]},partial:0};let f=d.split("."),c=[],m=0;for(let v of f.slice(0,3))if(/^\d+$/.test(v))c.push(Number(v)),m++;else{if(v==="x"||v==="X"||v==="*")break;break}let y=d.split("-"),b=y.length>1?y.slice(1).join("-").split("+")[0].split("."):[];return m===0&&b.length===0?{ver:{major:0,minor:0,patch:0,pre:[]},partial:0}:{ver:{major:c[0]??0,minor:c[1]??0,patch:c[2]??0,pre:b},partial:m}}function Me(l,d){switch(d){case">=":return l>=0;case">":return l>0;case"<":return l<0;case"<=":return l<=0;case"=":return l===0}}function Te(l,d,f){let c=`${l.major}.${l.minor}.${l.patch}`+(l.pre.length?`-${l.pre.join(".")}`:"");if(f.upper)return!(!(I(c,`${f.ver.major}.${f.ver.minor}.${f.ver.patch}`+(f.ver.pre.length?`-${f.ver.pre.join(".")}`:""))>=0)||!(I(c,`${f.upper.major}.${f.upper.minor}.${f.upper.patch}`)<0));let m=I(c,`${f.ver.major}.${f.ver.minor}.${f.ver.patch}`+(f.ver.pre.length?`-${f.ver.pre.join(".")}`:"")),y=Me(m,f.op);return f.ver.pre.length>0&&l.pre.length===0&&(f.op===">"||f.op==="<")?!1:y}var w=class extends Error{code;details;constructor(d,f,c,m){super(`[fulgurjs:${d}] ${f}`,m),this.name="FgError",this.code=d,this.details=c}},E={REMOTE_LOAD_FAILED:"MFU-001",REMOTE_NAME_MISMATCH:"MFU-002",SHARE_STRICT_VERSION:"MFU-003",SHARE_NOT_AVAILABLE:"MFU-004",CONTAINER_REINIT_CONFLICT:"MFU-005",MODULE_NOT_EXPOSED:"MFU-006",PRELOAD_FAILED:"MFU-007",REMOTE_UNKNOWN:"MFU-008",EMPTY_EXPORTS:"MFU-009",SINGLETON_SKEW:"MFU-010",SETUP_INVALID_EXPORT:"MFU-011",SETUP_RUN_FAILED:"MFU-012",SETUP_SESSION_KEY_MISSING:"MFU-013",SETUP_RECURSION:"MFU-014"};var te="6.8.7";var Ie="__fulgurjsSetup",xe="__FULGURJS_APP_CONFIG__",G=15e3,oe=2,je=5,Ne=3e4,Ce=4e3,Ue=.2;function Ve(){let l=Object.create(null),d=new Map,f=[],c=new Set,m=new Map,y=(e,r)=>JSON.stringify([r.shareScope||"default",r.shareKey||e,r.requiredVersion??null,!!r.singleton,!!r.strictVersion]),b=new Map,v=new Map,M=new WeakMap,C=new WeakMap,_={},ie=()=>{for(let e of f)try{e.init?.(_)}catch(r){console.warn("[fulgurjs] \u8FD0\u884C\u65F6\u6269\u5C55\u521D\u59CB\u5316\u5931\u8D25\uFF0C\u8BE5\u6269\u5C55\u5C06\u4E0D\u53EF\u7528\uFF1A",e.name,r)}},U=new Map,V,F=e=>{let r=U.get(e);return r||U.set(e,r={}),r},X=()=>globalThis[xe]??{};async function B(e,r,n,o){let t=u=>u instanceof w?u:new w(E.SETUP_RUN_FAILED,`\u73B0\u8C61\uFF1A\u8FDC\u7A0B\u5E94\u7528 "${e}" \u7684 ${o} \u521D\u59CB\u5316\u5931\u8D25\u3002
+var ve=/^v?(\d+)(?:\.(\d+))?(?:\.(\d+))?(?:-((?:[0-9A-Za-z-]+)(?:\.[0-9A-Za-z-]+)*))?(?:\+[0-9A-Za-z.-]+)?$/;function N(l){let d=ve.exec(String(l).trim());return d?{major:Number(d[1]),minor:Number(d[2]??0),patch:Number(d[3]??0),pre:d[4]?d[4].split("."):[]}:null}function $e(l,d){if(l.length===0&&d.length===0)return 0;if(l.length===0)return 1;if(d.length===0)return-1;let f=Math.max(l.length,d.length);for(let c=0;c<f;c++){let m=l[c],y=d[c];if(m===void 0)return-1;if(y===void 0)return 1;let b=/^\d+$/.test(m),v=/^\d+$/.test(y);if(b&&v){let M=Number(m)-Number(y);if(M!==0)return M}else{if(b!==v)return b?-1:1;if(m!==y)return m<y?-1:1}}return 0}function I(l,d){let f=N(l),c=N(d);return!f||!c?l<d?-1:l>d?1:0:f.major!==c.major?f.major-c.major:f.minor!==c.minor?f.minor-c.minor:f.patch!==c.patch?f.patch-c.patch:$e(f.pre,c.pre)}var Pe=/^[a-z]+[+:-]/i;function x(l,d){if(d===!1||d==null||d==="")return!0;let f=String(d).trim();return!f||f==="*"||f==="latest"||Pe.test(f)?!0:f.split("||").some(c=>_e(l,c.trim()))}function _e(l,d){if(!d||d==="*")return!N(l)?.pre.length;let f=d.split(/\s+-\s+/);if(f.length===2){let y=f[0].trim(),b=f[1].trim();return!(!x(l,`>=${y}`)||!x(l,`<=${b}`))}let c=N(l);if(!c)return!1;let m=ke(d);if(m===null)return!0;for(let y of m)if(!Te(c,l,y))return!1;return!(c.pre.length>0&&!m.some(y=>y.ver.pre.length>0)&&!m.some(b=>b.ver.major===c.major&&b.ver.minor===c.minor&&b.ver.patch===c.patch))}function ke(l){let d=[],f=l.trim().split(/\s+/).filter(Boolean);if(f.length===0)return null;for(let c of f){let m=/^(>=|<=|>|<|=|\^|~)?(.*)$/.exec(c);if(!m)return null;let y=m[1],b=m[2],v=Le(y,b);if(v===null)return null;d.push(...v)}return d}function Le(l,d){let f=Ae(d);if(!f)return null;let{ver:c,partial:m}=f;switch(l){case"^":{let y=Oe(c);return y?[{op:">=",ver:c},{op:"<",ver:y}]:null}case"~":{let y=m>=2?{major:c.major,minor:c.minor+1,patch:0,pre:[]}:{major:c.major+1,minor:0,patch:0,pre:[]};return[{op:">=",ver:c},{op:"<",ver:y}]}case">=":return[{op:">=",ver:c}];case">":return m===1?[{op:">=",ver:{major:c.major+1,minor:0,patch:0,pre:[]}}]:m===2?[{op:">=",ver:{major:c.major,minor:c.minor+1,patch:0,pre:[]}}]:[{op:">",ver:c}];case"<":return m===1?[{op:"<",ver:{major:c.major,minor:0,patch:0,pre:[]}}]:m===2?[{op:"<",ver:{major:c.major,minor:c.minor,patch:0,pre:[]}}]:[{op:"<",ver:c}];case"<=":return[{op:"<=",ver:c}];case"=":case void 0:return m===1?[{op:">=",ver:c},{op:"<",ver:{major:c.major+1,minor:0,patch:0,pre:[]}}]:m===2?[{op:">=",ver:c},{op:"<",ver:{major:c.major,minor:c.minor+1,patch:0,pre:[]}}]:[{op:"=",ver:c}];default:return null}}function Oe(l){return l.major>0?{major:l.major+1,minor:0,patch:0,pre:[]}:l.minor>0?{major:0,minor:l.minor+1,patch:0,pre:[]}:{major:0,minor:0,patch:l.patch+1,pre:[]}}function Ae(l){let d=l.replace(/^v/,"").trim();if(!d||d==="*"||d==="x"||d==="X")return{ver:{major:0,minor:0,patch:0,pre:[]},partial:0};let f=d.split("."),c=[],m=0;for(let v of f.slice(0,3))if(/^\d+$/.test(v))c.push(Number(v)),m++;else{if(v==="x"||v==="X"||v==="*")break;break}let y=d.split("-"),b=y.length>1?y.slice(1).join("-").split("+")[0].split("."):[];return m===0&&b.length===0?{ver:{major:0,minor:0,patch:0,pre:[]},partial:0}:{ver:{major:c[0]??0,minor:c[1]??0,patch:c[2]??0,pre:b},partial:m}}function Me(l,d){switch(d){case">=":return l>=0;case">":return l>0;case"<":return l<0;case"<=":return l<=0;case"=":return l===0}}function Te(l,d,f){let c=`${l.major}.${l.minor}.${l.patch}`+(l.pre.length?`-${l.pre.join(".")}`:"");if(f.upper)return!(!(I(c,`${f.ver.major}.${f.ver.minor}.${f.ver.patch}`+(f.ver.pre.length?`-${f.ver.pre.join(".")}`:""))>=0)||!(I(c,`${f.upper.major}.${f.upper.minor}.${f.upper.patch}`)<0));let m=I(c,`${f.ver.major}.${f.ver.minor}.${f.ver.patch}`+(f.ver.pre.length?`-${f.ver.pre.join(".")}`:"")),y=Me(m,f.op);return f.ver.pre.length>0&&l.pre.length===0&&(f.op===">"||f.op==="<")?!1:y}var w=class extends Error{code;details;constructor(d,f,c,m){super(`[fulgurjs:${d}] ${f}`,m),this.name="FgError",this.code=d,this.details=c}},E={REMOTE_LOAD_FAILED:"MFU-001",REMOTE_NAME_MISMATCH:"MFU-002",SHARE_STRICT_VERSION:"MFU-003",SHARE_NOT_AVAILABLE:"MFU-004",CONTAINER_REINIT_CONFLICT:"MFU-005",MODULE_NOT_EXPOSED:"MFU-006",PRELOAD_FAILED:"MFU-007",REMOTE_UNKNOWN:"MFU-008",EMPTY_EXPORTS:"MFU-009",SINGLETON_SKEW:"MFU-010",SETUP_INVALID_EXPORT:"MFU-011",SETUP_RUN_FAILED:"MFU-012",SETUP_SESSION_KEY_MISSING:"MFU-013",SETUP_RECURSION:"MFU-014"};var te="6.9.0";var Ie="__fulgurjsSetup",xe="__FULGURJS_APP_CONFIG__",G=15e3,oe=2,je=5,Ne=3e4,Ce=4e3,Ue=.2;function Ve(){let l=Object.create(null),d=new Map,f=[],c=new Set,m=new Map,y=(e,r)=>JSON.stringify([r.shareScope||"default",r.shareKey||e,r.requiredVersion??null,!!r.singleton,!!r.strictVersion]),b=new Map,v=new Map,M=new WeakMap,C=new WeakMap,_={},ie=()=>{for(let e of f)try{e.init?.(_)}catch(r){console.warn("[fulgurjs] \u8FD0\u884C\u65F6\u6269\u5C55\u521D\u59CB\u5316\u5931\u8D25\uFF0C\u8BE5\u6269\u5C55\u5C06\u4E0D\u53EF\u7528\uFF1A",e.name,r)}},U=new Map,V,F=e=>{let r=U.get(e);return r||U.set(e,r={}),r},X=()=>globalThis[xe]??{};async function B(e,r,n,o){let t=u=>u instanceof w?u:new w(E.SETUP_RUN_FAILED,`\u73B0\u8C61\uFF1A\u8FDC\u7A0B\u5E94\u7528 "${e}" \u7684 ${o} \u521D\u59CB\u5316\u5931\u8D25\u3002
 \u539F\u56E0\uFF1A${String(u?.message??u)}
 \u4FEE\u6CD5\uFF1A\u68C0\u67E5\u5E76\u4FEE\u590D\u8BE5 ${o} \u51FD\u6570\u540E\u91CD\u65B0\u52A0\u8F7D\uFF1B\u5931\u8D25\u7F13\u5B58\u5DF2\u6E05\u9664\uFF0C\u53EF\u4EE5\u76F4\u63A5\u91CD\u8BD5\u3002`,{remote:e,phase:o},{cause:u});V=e;let s;try{s=r(n)}catch(u){throw t(u)}finally{V=void 0}try{await s}catch(u){throw t(u)}}async function ae(e,r,n,o){e.debug.setup="pending";try{if(e.manifestUrl)try{await H(`${e.name}/${n}`)}catch{}let t=await r.get(n),s=t?.default;if(typeof s!="function")throw new w(E.SETUP_INVALID_EXPORT,`\u73B0\u8C61\uFF1A\u8FDC\u7A0B\u5E94\u7528 "${e.name}" \u7684 setup \u6A21\u5757 "${n}" \u65E0\u6CD5\u521D\u59CB\u5316\u3002
 \u539F\u56E0\uFF1A\u9ED8\u8BA4\u5BFC\u51FA\u7C7B\u578B\u4E3A ${t==null?String(t):typeof s}\uFF0C\u5E94\u4E3A\u51FD\u6570\u3002

package/dist/vue-adapter.d.cts

@@ -1,7 +1,7 @@
 import { DefineComponent, Component } from 'vue';
 import { PageRouteLike } from './pages.cjs';
 import { R as ResolvedHostPage, H as HostPagesCoreOptions } from './host-pages-core-BFxp-IOj.cjs';
-import { b as FgModuleDefault, c as FgComponentLike, d as FgComponentEntry } from './remote-types-58hdbx6x.cjs';
+import { b as FgModuleDefault, c as FgComponentLike, d as FgComponentEntry } from './remote-types-CStGOJwu.cjs';
 import { FgRemoteTypes } from '@fulgurjs/federation/internal/registry.js';
 import './bridge-core-77BT1__I.cjs';
 import './context.cjs';

package/dist/vue-adapter.d.ts

@@ -1,7 +1,7 @@
 import { DefineComponent, Component } from 'vue';
 import { PageRouteLike } from './pages.js';
 import { R as ResolvedHostPage, H as HostPagesCoreOptions } from './host-pages-core-DLfMeDrO.js';
-import { b as FgModuleDefault, c as FgComponentLike, d as FgComponentEntry } from './remote-types-xf1B6_pK.js';
+import { b as FgModuleDefault, c as FgComponentLike, d as FgComponentEntry } from './remote-types-COmBhjRc.js';
 import { FgRemoteTypes } from '@fulgurjs/federation/internal/registry.js';
 import './bridge-core-CoQRVgnZ.js';
 import './context.js';

package/dist/vue-store.cjs

@@ -0,0 +1,40 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/vue-store.ts
+var vue_store_exports = {};
+__export(vue_store_exports, {
+  bindStoreToApp: () => bindStoreToApp
+});
+module.exports = __toCommonJS(vue_store_exports);
+function bindStoreToApp(useStore, pinia) {
+  return new Proxy(useStore, {
+    apply(target, receiver, args) {
+      if (args[0] == null) {
+        args[0] = typeof pinia === "function" ? pinia() : pinia;
+        if (args[0] == null) throw new Error("\u672C\u5E94\u7528\u7684 Pinia \u5C1A\u672A\u521B\u5EFA\u3002\u5148\u5728\u5E94\u7528\u88C5\u914D\u4E2D\u521B\u5EFA/\u5B89\u88C5 Pinia\uFF0C\u518D\u8C03\u7528\u7ED1\u5B9A\u7684 store\u3002");
+      }
+      return Reflect.apply(target, receiver, args);
+    }
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  bindStoreToApp
+});

package/dist/vue-store.d.cts

@@ -0,0 +1,4 @@
+/** Explicit ownership for Pinia-like store definitions; no Pinia dependency or global switching. */
+declare function bindStoreToApp<T extends (...args: never[]) => unknown>(useStore: T, pinia: Parameters<T>[0] | (() => Parameters<T>[0])): T;
+
+export { bindStoreToApp };

package/dist/vue-store.d.ts

@@ -0,0 +1,4 @@
+/** Explicit ownership for Pinia-like store definitions; no Pinia dependency or global switching. */
+declare function bindStoreToApp<T extends (...args: never[]) => unknown>(useStore: T, pinia: Parameters<T>[0] | (() => Parameters<T>[0])): T;
+
+export { bindStoreToApp };

package/dist/vue-store.js

@@ -0,0 +1,15 @@
+// src/vue-store.ts
+function bindStoreToApp(useStore, pinia) {
+  return new Proxy(useStore, {
+    apply(target, receiver, args) {
+      if (args[0] == null) {
+        args[0] = typeof pinia === "function" ? pinia() : pinia;
+        if (args[0] == null) throw new Error("\u672C\u5E94\u7528\u7684 Pinia \u5C1A\u672A\u521B\u5EFA\u3002\u5148\u5728\u5E94\u7528\u88C5\u914D\u4E2D\u521B\u5EFA/\u5B89\u88C5 Pinia\uFF0C\u518D\u8C03\u7528\u7ED1\u5B9A\u7684 store\u3002");
+      }
+      return Reflect.apply(target, receiver, args);
+    }
+  });
+}
+export {
+  bindStoreToApp
+};

package/dist/vue.d.ts

@@ -189,7 +189,7 @@ type FgComponentEntry<S extends string> = [keyof FgRemoteTypes] extends [never]
  */
 type FgBridgeEntry<S extends string> = [keyof FgRemoteTypes] extends [never] ? string : string extends S ? string : S extends keyof FgRemoteTypes ? FgRemoteTypes[S] extends {
     default: infer D;
-} ? D extends BridgeApp ? S : `非桥接入口 ${S}：桥接工厂只接受远程 defineBridgeApp 的默认导出（普通组件用 remoteComponent）` : `非桥接入口 ${S}：桥接工厂只接受远程 defineBridgeApp 的默认导出（普通组件用 remoteComponent）` : `未知远程入口 ${S}：请核对该远程的 exposes，或运行 npx @fulgurjs/federation types 同步类型`;
+} ? D extends BridgeApp ? S : `非桥接入口 ${S}：需要 defineApplication 或 defineBridgeApp 的默认导出（普通组件用 remoteComponent）` : `非桥接入口 ${S}：需要 defineApplication 或 defineBridgeApp 的默认导出（普通组件用 remoteComponent）` : `未知远程入口 ${S}：请核对该远程的 exposes，或运行 npx @fulgurjs/federation types 同步类型`;
 /** 桥接提供方声明的 props（defineBridgeApp<P> 的 phantom 标记 → 宿主侧提取） */
 type FgBridgePropsOf<B> = B extends {
     __fgBridgeProps?: infer P;
@@ -592,8 +592,21 @@ declare function createHostPages$1(options: HostPagesOptions, load: (spec: strin
     consumerApp?: unknown;
 }) => Promise<any>): HostPages;
 
+/** Shared start/stop bookkeeping; framework contracts retain their own rendering semantics. */
+
+interface ApplicationHandle {
+    element: HTMLElement;
+    /** Only disposes this start generation; an old handle cannot stop a replacement. */
+    unmount(): void;
+}
+type Application<P extends object> = BridgeApp & {
+    __fgBridgeProps?: P;
+} & {
+    start(target: string | HTMLElement, ...props: {} extends P ? [props?: P] : [props: P]): Promise<ApplicationHandle>;
+};
+
 /**
- * Vue 子应用桥接适配（/runtime 导出 defineBridgeApp；任务书 §3.3 D1/D2）。
+ * Vue 子应用桥接适配（/vue 导出 defineBridgeApp 与 defineApplication）。
  *
  * 工厂返回 VueApp，或已装配业务插件与守卫的 { app, router }；后者自动接线 memory
  * router、等待初始导航再安装。helper 管理挂载/卸载及每容器每代次的路由释放。
@@ -606,7 +619,7 @@ declare function createHostPages$1(options: HostPagesOptions, load: (spec: strin
  * - unmount 未知容器为 no-op；mount/unmount 的原始错误**原样抛出**——MFU-016 包装
  *   （真实 spec + phase + cause）由宿主适配器在生命周期边界统一完成（见 bridgeHostError）。
  *
- * 本文件零 React：/runtime 导入图隔离由 tests/runtime-entry-graph.test.ts 守护。
+ * 本文件零 React：/vue 导入图隔离由 tests/runtime-entry-graph.test.ts 守护。
  */
 
 /** 工厂第二参数：挂载生命周期与路由通道（URL 同步；不混入业务 props） */
@@ -633,7 +646,7 @@ type VueBridgeAppFactory<P = Record<string, unknown>> = (props: P, ctx?: VueBrid
  * 经注册表提取为包装组件的 appProps 类型；未声明具体 P 的远程保持
  * Record<string, unknown>（诚实通用面，绝不凭空推导业务字段）。
  */
-type FgBridgePropsMarker<P extends Record<string, unknown>> = {
+type FgBridgePropsMarker<P extends object> = {
     __fgBridgeProps?: P;
 };
 interface DefineVueBridgeAppOptions {
@@ -652,7 +665,21 @@ interface DefineVueBridgeAppOptions {
  * export default defineBridgeApp((props) => { const app = createApp(App, props); app.use(router); return app })
  * ```
  */
-declare function defineBridgeApp$1<P extends Record<string, unknown> = Record<string, unknown>>(factory: VueBridgeAppFactory<P>, options?: DefineVueBridgeAppOptions): BridgeApp & FgBridgePropsMarker<P>;
+declare function defineBridgeApp$1<P extends object = Record<string, unknown>>(factory: VueBridgeAppFactory<P>, options?: DefineVueBridgeAppOptions): BridgeApp & FgBridgePropsMarker<P>;
+interface VueApplicationContext extends VueBridgeAppContext {
+    mode: 'standalone' | 'bridge';
+    /** Always present; aborts when this application instance is stopped. */
+    signal: AbortSignal;
+}
+interface VueApplicationSetup extends VueBridgeAppSetup {
+    router: VueRouterLike & {
+        install(app: App): void;
+        isReady(): Promise<void>;
+    };
+}
+type VueApplicationFactory<P = Record<string, unknown>> = (props: P, context: VueApplicationContext) => App | VueApplicationSetup | Promise<App | VueApplicationSetup>;
+/** One assembly function for the standalone entry and the exposed application. */
+declare function defineApplication<P extends object = Record<string, unknown>>(factory: VueApplicationFactory<P>, options?: DefineVueBridgeAppOptions): Application<P>;
 
 /** Vue Router 4/5 的宿主导航端口与子应用 memory router 接线（统一入口 /vue 提供）。 */
 
@@ -729,11 +756,15 @@ declare function createBridgeSession(options?: {
     storageKey?: string;
 }): BridgeSession;
 
+/** Explicit ownership for Pinia-like store definitions; no Pinia dependency or global switching. */
+declare function bindStoreToApp<T extends (...args: never[]) => unknown>(useStore: T, pinia: Parameters<T>[0] | (() => Parameters<T>[0])): T;
+
 declare const remoteComponent: <S extends string>(spec: S & FgComponentEntry<S>, opts?: RemoteComponentOptions) => FgRemoteVueComponent<S>;
 /** 宿主页面适配器（绑定本包运行时的 loadRemote；选项与返回值类型见 vue-adapter） */
 declare function createHostPages(options: Parameters<typeof createHostPages$1>[0]): HostPages;
 /** Vue 子应用桥接契约（远程 ./bridge 模块默认导出） */
 declare const defineBridgeApp: typeof defineBridgeApp$1;
+
 /** Vue 宿主桥接工厂：返回 `{ appProps: P; sessionKey?: string | null }` 形态的包装组件 */
 declare const createVueBridgeApp: <P0 = _fulgurjs_federation_internal_registry_js.FgTypeAuto, S extends string = string>(spec: S & FgBridgeEntry<S>, options?: VueBridgeAppOptions) => FgVueBridgeWrapperResolved<P0, S>;
 
@@ -741,4 +772,4 @@ type RemoteSchema = Record<string, RemoteSchemaEntry>;
 /** 无插件转换的场景（构建、Node 导入）如实返回空清单。 */
 declare const remoteSchema: RemoteSchema;
 
-export { type AppContext, type BridgeApp, type BridgeHostRouting, type BridgeSession, type FgBridgeAppProps, type FgBridgeEntry, type FgBridgePropsOf, type FgComponentEntry, type FgRemoteVueComponent, type FgRuntime, type FgVueBridgeWrapper, type HostPages, type HostPagesOptions, type LoadRemoteOptions, type LoadShareOptions, type PageRouteLike, type PageViolation, type PagesOptions, type PreloadRemoteOptions, type RemoteComponentOptions, type RemoteConfig, type RemoteDebugInfo, type RemoteSchema, type RemoteSchemaEntry, type RemoteSetupContext, type RemoteSetupModule, type ResolvedHostPage, type RuntimeHooks, type RuntimePlugin, type ShareEntry, type ShareScope, type ShareScopeMap, type VueBridgeAppContext, type VueBridgeAppFactory, type VueBridgeAppOptions, type VueBridgeAppSetup, type VueBridgeRouterConnection, clearAppContext, clearSessionState, connectVueBridgeRouter, createBridgeSession, createHostPages, createVueBridgeApp, createVueBridgeNavigation, defineBridgeApp, definePages, getAppContext, getContainer, getLoadedShare, getRuntime, hasBridgeMount, initSharing, installVueBridgeRouter, loadRemote, loadShare, parseSpec, pinLoadedShare, preloadRemote, provideAppContext, registerPlugins, registerRemote, registerRemotes, registerShare, remoteComponent, remoteSchema, requireAppContext, shareScopeMap, unwrapDefault, validatePages, version };
+export { type AppContext, type Application, type ApplicationHandle, type BridgeApp, type BridgeHostRouting, type BridgeSession, type DefineVueBridgeAppOptions, type FgBridgeAppProps, type FgBridgeEntry, type FgBridgePropsOf, type FgComponentEntry, type FgRemoteVueComponent, type FgRuntime, type FgVueBridgeWrapper, type HostPages, type HostPagesOptions, type LoadRemoteOptions, type LoadShareOptions, type PageRouteLike, type PageViolation, type PagesOptions, type PreloadRemoteOptions, type RemoteComponentOptions, type RemoteConfig, type RemoteDebugInfo, type RemoteSchema, type RemoteSchemaEntry, type RemoteSetupContext, type RemoteSetupModule, type ResolvedHostPage, type RuntimeHooks, type RuntimePlugin, type ShareEntry, type ShareScope, type ShareScopeMap, type VueApplicationContext, type VueApplicationFactory, type VueApplicationSetup, type VueBridgeAppContext, type VueBridgeAppFactory, type VueBridgeAppOptions, type VueBridgeAppSetup, type VueBridgeRouterConnection, bindStoreToApp, clearAppContext, clearSessionState, connectVueBridgeRouter, createBridgeSession, createHostPages, createVueBridgeApp, createVueBridgeNavigation, defineApplication, defineBridgeApp, definePages, getAppContext, getContainer, getLoadedShare, getRuntime, hasBridgeMount, initSharing, installVueBridgeRouter, loadRemote, loadShare, parseSpec, pinLoadedShare, preloadRemote, provideAppContext, registerPlugins, registerRemote, registerRemotes, registerShare, remoteComponent, remoteSchema, requireAppContext, shareScopeMap, unwrapDefault, validatePages, version };

package/dist/vue.js

@@ -11,6 +11,8 @@ import { hasBridgeMount } from "./bridge-core.js";
 export const remoteComponent = createRemoteComponent(loadRemote);
 export const createHostPages = (options) => createHostPagesWithLoader(options, loadRemote);
 export const defineBridgeApp = defineVueBridgeApp;
+export { defineApplication } from "./bridge-app-vue.js";
+export { bindStoreToApp } from "./vue-store.js";
 export const createVueBridgeApp = createVueBridgeAppWithLoader(loadRemote);
 export { createVueBridgeNavigation, connectVueBridgeRouter, installVueBridgeRouter };
 export { createBridgeSession };

package/docs/en/reference/api.md

@@ -7,8 +7,8 @@
 | Entry | Purpose | Export surface |
 |---|---|---|
 | `@fulgurjs/federation` (package root) | Vite config | the `federation(options)` plugin + the `FederationOptions` type (full field set in the [configuration reference](configuration.md)) |
-| `@fulgurjs/federation/vue` | **The single entry for Vue apps** | full runtime + `provideAppContext`/`getAppContext`/`requireAppContext`/`clearAppContext` + `definePages`/`validatePages` + `remoteComponent` + `createHostPages` + `defineBridgeApp` + `createVueBridgeApp` + `createVueBridgeNavigation` + `connectVueBridgeRouter` + `remoteSchema` |
-| `@fulgurjs/federation/react` | **The single entry for React apps** | the same full runtime + context + pages (`createReactHostPages`) + `remoteComponent`/`useLoadRemote`/`RemoteErrorBoundary` + `defineBridgeApp` + `createReactBridgeApp` + `createReactBridgeNavigation` + `createReactBridgeRouter` + `remoteSchema` |
+| `@fulgurjs/federation/vue` | **The single entry for Vue apps** | full runtime + `provideAppContext`/`getAppContext`/`requireAppContext`/`clearAppContext` + `definePages`/`validatePages` + `remoteComponent` + `bindStoreToApp` + `createHostPages` + `defineApplication` + `defineBridgeApp` + `createVueBridgeApp` + `createVueBridgeNavigation` + `connectVueBridgeRouter` + `remoteSchema` |
+| `@fulgurjs/federation/react` | **The single entry for React apps** | the same full runtime + context + pages (`createReactHostPages`) + `remoteComponent`/`useLoadRemote`/`RemoteErrorBoundary` + `defineApplication` + `defineBridgeApp` + `createReactBridgeApp` + `createReactBridgeNavigation` + `createReactBridgeRouter` + `remoteSchema` |
 | `@fulgurjs/federation/runtime` | **Framework-agnostic** | full runtime (loadRemote/loadShare/initSharing/registerRemotes/registerShare/registerRemote/registerPlugins/preloadRemote/getContainer/getLoadedShare/pinLoadedShare/parseSpec/getRuntime/shareScopeMap/unwrapDefault/version/clearSessionState) + context + pages (`definePages`/`validatePages`) + `remoteSchema`; zero Vue/React/router dependency |
 
 <a id="runtime-api"></a>
@@ -644,3 +644,39 @@ A project can build its own runtime diagnostics page (route `meta.ignoreAuth`),
 ## Complete public types
 
 The [public type reference](types.md) lists every exported type and its fields by current import location.
+
+## One application for standalone and bridge startup: `defineApplication`
+
+
+Import from `@fulgurjs/federation/vue` or `@fulgurjs/federation/react`; no additional subpath. See [existing application assembly](../guide/existing-apps.md) for complete examples. `defineBridgeApp` remains available for bridge-only applications.
+
+| Item | Contract |
+|---|---|
+| Signature | `defineApplication<P extends object>(factory, options?) => Application<P>`; ordinary interfaces need no index signature |
+| Options | Existing `DefineVueBridgeAppOptions` / `DefineReactBridgeAppOptions`; routing defaults to false, set true for host URL synchronization |
+| Factory | Called for each mount/container; Vue accepts an asynchronous result, React requires a synchronous result |
+| context.mode | Required: standalone or bridge |
+| context.signal | Required, owned by this instance; aborted on unmount/external mount cancellation. Asynchronous tasks must observe it |
+| context.routing | Provided by a routing-enabled bridge host, absent during standalone startup |
+| Vue result | app or { app, router }; prefer the latter. Assemble stores, components, Providers and guards before returning an app whose router is not yet installed. Standalone uses a real web/hash router, installed and awaited by the plugin; bridge uses memory history: routing:true for host URL sync, or an automatically installed/awaited local memory router when sync is omitted |
+| React result | ReactElement or { element: ReactElement, dispose?: () => void }. Dispose synchronously releases instance-owned resources. Return createReactBridgeRouter's element/dispose for bridge mode or RouterProvider plus router.dispose for standalone mode |
+| start(target, props) | Selector or HTMLElement; props is required when P contains required fields. Resolves { element, unmount() } after Vue initial navigation/mount or React first root commit; does not await every page loader/request |
+| Pending cancellation | application.unmount(element) cancels a pending start with AbortError; callers handle rejection and late factory results do not remount |
+| Unmount | A handle only stops its own generation. Old handles cannot stop replacement instances. Failed unmount seals that definition's container until page refresh |
+| Repeated mounts | Unmount before another start/mount in the same container. Different containers need different app/router/store instances |
+| Host | The result implements BridgeApp (mount/unmount/routing) and is loaded by createVueBridgeApp/createReactBridgeApp; hosts do not call start |
+
+### Explicit store ownership: `bindStoreToApp` (Vue only)
+
+```ts
+import { bindStoreToApp } from '@fulgurjs/federation/vue'
+import { createPinia } from 'pinia'
+import { useCounterStore } from './stores/counter'
+const pinia = createPinia()
+const useCounter = bindStoreToApp(useCounterStore, pinia)
+const counter = useCounter()
+```
+
+Signature: `bindStoreToApp<T extends (...args: never[]) => unknown>(useStore: T, pinia: Parameters<T>[0] | (() => Parameters<T>[0])): T`. A proxy retains the function's parameter/return types and properties such as $id. An omitted/null first argument gets the bound instance; explicitly supplied instances are respected. No Pinia import, global activePinia mutation or global business store is introduced.
+
+A getter is suitable only for a module with one unambiguous default instance initialized later; an unavailable instance throws a readable error. Concurrent application containers must bind their actual instances per factory and inject the bound functions into their own trees. Do not use a module variable overwritten by each mount. Normal component injection can keep native useStore.

package/docs/en/reference/types.md

@@ -217,6 +217,8 @@ Import from: `@fulgurjs/federation/react`, `@fulgurjs/federation/runtime`, `@ful
 | `onSession` | yes | `(ctx: RemoteSetupContext) => void \| Promise<void>` | See the owning API for lifecycle and runtime defaults. |
 | `globalComponents` | yes | `Record<string, unknown>` | Static components retain their identity. Zero-argument functions with displayName/props/emits metadata are components; unmarked zero-argument functions are lazy loaders. See the setup API for installation and retry semantics. |
 
+| `pageProviders` | yes | `unknown[]` | Ancestor Providers required by remote components; each item is a component or zero-argument loader. Adapters wrap the actual consumer tree without copying the provider application. |
+
 ## AppContext
 
 Application and session context supplied by the host.
@@ -613,3 +615,28 @@ Return value of `createReactBridgeRouter`.
 | `element` | `ReactElement` | Return as the child application's root from the bridge factory. |
 | `routerReady` | `Promise<Router>` | Resolves when the memory router is wired; rejects if dependencies cannot load. Await this promise instead of assuming `element.props.router` exists synchronously. |
 | `dispose` | `() => void` | Release routing subscriptions and wiring during bridge cleanup. |
+
+## Application / ApplicationHandle
+
+入口 / Entry: `@fulgurjs/federation/vue`, `@fulgurjs/federation/react`.
+
+| 类型 / Type | 字段 / Fields |
+|---|---|
+| Application<P extends object> | BridgeApp + `__fgBridgeProps?: P` + `start(target: string \| HTMLElement, ...props: {} extends P ? [props?: P] : [props: P]): Promise<ApplicationHandle>` |
+| ApplicationHandle | `element: HTMLElement`, `unmount(): void` |
+| VueApplicationContext | `mode: 'standalone' \| 'bridge'`, `signal: AbortSignal`, `routing?: BridgeChildRoute` |
+| VueApplicationSetup | `app: VueApp`, `router: VueRouterLike & { install(app: VueApp): void; isReady(): Promise<void> }` |
+| VueApplicationFactory<P> | `(props: P, context: VueApplicationContext) => VueApp \| VueApplicationSetup \| Promise<VueApp \| VueApplicationSetup>` |
+| ReactApplicationContext | `mode: 'standalone' \| 'bridge'`, `signal: AbortSignal`, `routing?: BridgeChildRoute` |
+| ReactApplicationSetup | `element: ReactElement`, `dispose?: () => void` |
+| ReactApplicationFactory<P> | `(props: P, context: ReactApplicationContext) => ReactElement \| ReactApplicationSetup` |
+
+See the [API reference](api.md#one-application-for-standalone-and-bridge-startup-defineapplication) for lifecycle and defaults.
+
+## DefineVueBridgeAppOptions / DefineReactBridgeAppOptions
+
+Import Vue options from /vue and React options from /react. defineApplication and defineBridgeApp share their framework options type.
+
+| Field | Optional | Type | Default and purpose |
+|---|---|---|---|
+| routing | yes | boolean | false; true declares host URL synchronization. defineApplication can also install a local memory router without synchronization. |

package/docs/zh/reference/api.md

@@ -7,8 +7,8 @@
 | 入口 | 用途 | 导出面 |
 |---|---|---|
 | `@fulgurjs/federation`（包根） | Vite 配置 | `federation(options)` 插件 + `FederationOptions` 类型（字段全集见[配置参考](configuration.md)） |
-| `@fulgurjs/federation/vue` | **Vue 应用唯一入口** | 运行时全量 + `provideAppContext`/`getAppContext`/`requireAppContext`/`clearAppContext` + `definePages`/`validatePages` + `remoteComponent` + `createHostPages` + `defineBridgeApp` + `createVueBridgeApp` + `createVueBridgeNavigation` + `connectVueBridgeRouter` + `remoteSchema` |
-| `@fulgurjs/federation/react` | **React 应用唯一入口** | 同一运行时全量 + context + pages（`createReactHostPages`）+ `remoteComponent`/`useLoadRemote`/`RemoteErrorBoundary` + `defineBridgeApp` + `createReactBridgeApp` + `createReactBridgeNavigation` + `createReactBridgeRouter` + `remoteSchema` |
+| `@fulgurjs/federation/vue` | **Vue 应用唯一入口** | 运行时全量 + `provideAppContext`/`getAppContext`/`requireAppContext`/`clearAppContext` + `definePages`/`validatePages` + `remoteComponent` + `bindStoreToApp` + `createHostPages` + `defineApplication` + `defineBridgeApp` + `createVueBridgeApp` + `createVueBridgeNavigation` + `connectVueBridgeRouter` + `remoteSchema` |
+| `@fulgurjs/federation/react` | **React 应用唯一入口** | 同一运行时全量 + context + pages（`createReactHostPages`）+ `remoteComponent`/`useLoadRemote`/`RemoteErrorBoundary` + `defineApplication` + `defineBridgeApp` + `createReactBridgeApp` + `createReactBridgeNavigation` + `createReactBridgeRouter` + `remoteSchema` |
 | `@fulgurjs/federation/runtime` | **框架无关** | 运行时全量（loadRemote/loadShare/initSharing/registerRemotes/registerShare/registerRemote/registerPlugins/preloadRemote/getContainer/getLoadedShare/pinLoadedShare/parseSpec/getRuntime/shareScopeMap/unwrapDefault/version/clearSessionState）+ context + pages（`definePages`/`validatePages`）+ `remoteSchema`；零 Vue/React/router 依赖 |
 
 <a id="runtime-api"></a>
@@ -640,3 +640,47 @@ const PREFETCH_REMOTES: string[] = []
 ## 完整公共类型
 
 [公共类型参考](types.md) 按当前入口列出全部公开类型及字段。
+
+## 同一应用独立启动与桥接：`defineApplication`
+
+
+Vue 从 `@fulgurjs/federation/vue` 导入，React 从 `@fulgurjs/federation/react` 导入；不新增子路径。完整例子见[已有应用统一装配](../guide/existing-apps.md)。只需要桥接、不需要独立启动时，仍可使用 `defineBridgeApp`。
+
+```ts
+// Vue；React 使用同名入口，工厂返回 ReactElement 或 { element, dispose? }
+import { defineApplication } from '@fulgurjs/federation/vue'
+// application.ts 默认导出这个返回值；exposes 指向 application.ts。
+// 独立 main.ts 导入该默认导出，只调用 application.start('#app', props)。
+```
+
+| 项目 | 合同 |
+|---|---|
+| 签名 | `defineApplication<P extends object>(factory, options?) => Application<P>`；普通 interface 可用，不需要索引签名 |
+| options | 对应框架的 `DefineVueBridgeAppOptions` / `DefineReactBridgeAppOptions`；`routing` 默认 false，启用宿主 URL 同步时设 true |
+| 工厂调用 | 每个容器、每次挂载新调用；Vue 可返回 Promise，React 工厂必须同步返回 |
+| context.mode | 必有；`standalone` 为独立启动，`bridge` 为宿主挂载 |
+| context.signal | 必有；仅属于这次实例，卸载或外部挂载取消时 abort；异步任务必须自行遵守 signal |
+| context.routing | 桥接启用路由时由宿主提供；独立启动不提供，不能对它调用桥接连接器 |
+| Vue 返回值 | `app` 或 `{ app, router }`。推荐后者；工厂装配 Pinia、组件、Providers、守卫后返回尚未安装 router 的 app。独立模式传真实 web/hash router，插件安装并等待 isReady；桥接模式传 memory router；需要宿主 URL 同步时声明 routing:true，不同步时也可返回本地 router 自动安装/等待 |
+| React 返回值 | `ReactElement` 或 `{ element: ReactElement, dispose?: () => void }`；dispose 同步释放这次创建的 router/资源。桥接 createReactBridgeRouter 的 element/dispose 可直接返回；独立模式返回 RouterProvider 与 router.dispose |
+| `start(target, props)` | target 为选择器或 HTMLElement；P 有必填字段时 props 必填，否则可省略。Promise 成功得到 `{ element, unmount() }`；Vue 已等待初始路由、挂载，React 已完成首次根提交，不表示接口/页面所有异步内容完成 |
+| 启动途中取消 | 调用 `application.unmount(element)`；start 拒绝 AbortError。迟到工厂结果不得重挂载，调用方应处理拒绝 |
+| 卸载 | handle.unmount 只停止自己的启动代次；旧 handle 不停止同容器新实例。卸载失败后该定义会封锁容器，整页刷新后再用，不伪装成可重试成功 |
+| 重复挂载 | 同容器未卸载不得再次 start 或 mount；多容器必须各自创建 app/router/状态实例 |
+| 宿主使用 | 返回值也实现 BridgeApp（mount/unmount/routing），由 createVueBridgeApp/createReactBridgeApp 加载；宿主不会调用 start |
+
+### 显式绑定业务状态：`bindStoreToApp`（仅 Vue）
+
+```ts
+import { bindStoreToApp } from '@fulgurjs/federation/vue'
+import { createPinia } from 'pinia'
+import { useCounterStore } from './stores/counter'
+const pinia = createPinia()
+const useCounter = bindStoreToApp(useCounterStore, pinia)
+// 在这次 app 的装配中 provide useCounter；异步回调里无需依赖全局 activePinia。
+const counter = useCounter()
+```
+
+签名 `bindStoreToApp<T extends (...args: never[]) => unknown>(useStore: T, pinia: Parameters<T>[0] | (() => Parameters<T>[0])): T`。返回代理保持原函数的参数/返回类型和 `$id` 等属性；只有首参数省略或 null 时补绑定实例，显式传其他实例时尊重调用参数。不导入 Pinia、不调用 setActivePinia、不建立全局业务 store。
+
+getter 仅适合本模块明确只有一个默认实例且初始化较晚的情形；未就绪时抛可读错误。多容器并发请每次工厂绑定实际实例并向自身组件注入，不能用一个会被下一次挂载覆盖的模块变量。组件内正常 Pinia 注入继续使用原生 useStore。

package/docs/zh/reference/types.md

@@ -217,6 +217,8 @@ setup/onSession 收到的上下文.
 | `onSession` | yes | `(ctx: RemoteSetupContext) => void \| Promise<void>` | 见对应 API 合同。 |
 | `globalComponents` | yes | `Record<string, unknown>` | 远程暴露面依赖的「宿主全局注册组件」声明（键=组件注册名，值=组件对象或零参 loader）： 组件联邦（remoteComponent）把远程组件渲染进消费方 app 上下文，模板里的 字符串标签（如 <a-divider>）按消费方 app 的全局注册表解析——消费方没注册就 渲染成死元素。提供方在此声明后，运行时在每次 loadRemote 时把它们幂等注册到 当次传入的 consumerApp 上；无 consumerApp（无组件上下文的手动加载）时静默跳过。 值推荐「零参 loader（() => import('./X.vue')）」：setup 模块保持零重依赖， 组件只在本框架消费方真实渲染时才加载——Vue 适配器注册时自动包 defineAsyncComponent； 静态组件值仍支持；带 displayName/props/emits 的零参函数保留组件身份，未标记零参函数作 loader。运行时对值原样透传。 |
 
+| `pageProviders` | yes | `unknown[]` | 远程组件所需的祖先 Provider；元素为组件或零参 loader。由组件适配器包裹实际消费树，不复制提供方整个 app。 |
+
 ## AppContext
 
 宿主提供给远程模块的应用与会话上下文.
@@ -599,3 +601,28 @@ import type { ReactBridgeRouterConnection } from '@fulgurjs/federation/react'
 | `element` | `ReactElement` | 返回给桥接工厂，作为子应用根节点。 |
 | `routerReady` | `Promise<Router>` | 等待 memory router 完成接线；依赖缺失会 reject。需要访问 router 时等待此 Promise，不假设 `element.props.router` 同步存在。 |
 | `dispose` | `() => void` | 卸载时解除路由订阅与接线。与桥接生命周期清理一起调用。 |
+
+## Application / ApplicationHandle
+
+入口 / Entry: `@fulgurjs/federation/vue`, `@fulgurjs/federation/react`.
+
+| 类型 / Type | 字段 / Fields |
+|---|---|
+| Application<P extends object> | BridgeApp + `__fgBridgeProps?: P` + `start(target: string \| HTMLElement, ...props: {} extends P ? [props?: P] : [props: P]): Promise<ApplicationHandle>` |
+| ApplicationHandle | `element: HTMLElement`, `unmount(): void` |
+| VueApplicationContext | `mode: 'standalone' \| 'bridge'`, `signal: AbortSignal`, `routing?: BridgeChildRoute` |
+| VueApplicationSetup | `app: VueApp`, `router: VueRouterLike & { install(app: VueApp): void; isReady(): Promise<void> }` |
+| VueApplicationFactory<P> | `(props: P, context: VueApplicationContext) => VueApp \| VueApplicationSetup \| Promise<VueApp \| VueApplicationSetup>` |
+| ReactApplicationContext | `mode: 'standalone' \| 'bridge'`, `signal: AbortSignal`, `routing?: BridgeChildRoute` |
+| ReactApplicationSetup | `element: ReactElement`, `dispose?: () => void` |
+| ReactApplicationFactory<P> | `(props: P, context: ReactApplicationContext) => ReactElement \| ReactApplicationSetup` |
+
+调用顺序和默认值见 [API 参考](api.md#同一应用独立启动与桥接defineapplication)。
+
+## DefineVueBridgeAppOptions / DefineReactBridgeAppOptions
+
+Vue 从 `/vue` 导入，React 从 `/react` 导入；defineApplication 与 defineBridgeApp 共用对应框架的选项类型。
+
+| 字段 | 可省略 | 类型 | 默认与用途 |
+|---|---|---|---|
+| `routing` | 是 | `boolean` | false；true 声明宿主 URL 同步协议。defineApplication 不启用同步时也能安装本地 memory router。 |

package/examples/templates/README.md

@@ -1,5 +1,8 @@
 # fulgurjs-federation 模板（examples/templates/）
 
+> 五个模板统一使用 6.9.0 的 defineApplication 装配。按各模板 README 的冻结安装命令安装 registry 正式包。
+
+
 五个可独立复制、`pnpm install` 后直接运行的联邦接入模板。全部使用 **npm registry 正式包** `@fulgurjs/federation`（精确版本 + pnpm 锁文件，钉定版本见各模板 package.json；统一入口 /vue、/react、/runtime——模板代码即统一入口用法），不依赖本仓库源码、workspace 或父目录。
 
 ## 获取模板的两种方式

package/examples/templates/react-host-vue-remote/README.md

@@ -1,5 +1,8 @@
 # react-host-vue-remote：完整子应用桥接模板
 
+> 本目录是 6.9.0 源码候选：已改用 defineApplication，尚未测试和发布。源码依赖已锁定 6.9.0；正式发布前不要拿旧 registry 包运行这份代码。验收先使用本次候选 tarball，发布后再按下列冻结安装命令验证正式包。
+
+
 `react-host/` 是宿主，`vue-remote/` 是子应用。复制整个模板目录，在根目录运行：
 
 ```bash
@@ -22,3 +25,24 @@ pnpm dev
 - 改vue-remote（默认 5313）：① `vue-remote/package.json` 的 `dev` 与 `preview` 两个脚本的 `--port 5313`；② `react-host/fulgurjs.config.ts` 里 `remotes['bridge-vue-remote'].dev` 的 `http://localhost:5313`；③ 根 `scripts/dev.config.json` 里 vue-remote 的 `port`（**必改**：启动器预检/探活都读它）；④ 本 README 顶部端口表。
 - 改react-host（默认 5304）：① `react-host/package.json` 的 `dev`/`preview` `--port 5304`；② `scripts/dev.config.json`；③ 本 README 端口表。
 - 生产部署地址（`prod`，如 `/vue-remote`）是站点路径，与 dev 端口无关，改端口不要动它。改名（容器名）不建议：还需同步 spec 前缀与页面表。
+
+## 一键运行生产产物
+
+```bash
+pnpm build
+pnpm prod
+```
+
+`prod` 只服务本次 dist，不启动远程开发服务器。它复用 scripts/dev.config.json 的宿主端口，从实际构建入口推导 base，并把远程静态产物挂在同源子路径。无需为本地复现手写 Nginx；部署真实服务器时仍按部署指南配置。多宿主模板分别启动各宿主地址，不把两个宿主的根资源混在一起。先停止 dev，端口占用会失败并停止本次已起服务；不会关闭已有占用进程。Ctrl+C 关闭本次生产服务。
+
+## 插件代码阅读地图
+
+| 文件 | 职责 |
+|---|---|
+| `react-host/src/application.tsx` | 本应用唯一装配；main 只负责调用 start |
+| `vue-remote/src/application.ts` | 本应用唯一装配；main 只负责调用 start |
+| `react-host/fulgurjs.config.ts` | 本应用的远程地址、exposes、实际共享依赖 |
+| `vue-remote/fulgurjs.config.ts` | 本应用的远程地址、exposes、实际共享依赖 |
+| `scripts/dev.mjs` / `scripts/prod.mjs` | 统一开发/生产启动器；业务接入不复制它们到应用源码 |
+
+`application` 是新增的插件装配文件，`main` 是已有入口接线；页面组件、业务路由、权限和数据不是每个项目都必写的联邦配置。跨框架基础组合不逐页登记子应用菜单；逐页远程页面模板的页面表仅服务它所展示的逐页场景。`src/fulgurjs/types/` 是插件生成目录，按远程实际版本同步，不维护人工伪造的声明或旧缓存。

package/examples/templates/react-host-vue-remote/package.json

@@ -6,6 +6,7 @@
     "dev:remote": "pnpm --dir vue-remote dev",
     "dev:host": "pnpm --dir react-host dev",
     "dev": "node scripts/dev.mjs",
-    "build": "pnpm --dir vue-remote build && pnpm --dir react-host build"
+    "build": "pnpm --dir vue-remote build && pnpm --dir react-host build",
+    "prod": "node scripts/prod.mjs"
   }
 }

package/examples/templates/react-host-vue-remote/pnpm-lock.yaml

@@ -11,8 +11,8 @@ importers:
   react-host:
     dependencies:
       '@fulgurjs/federation':
-        specifier: 6.8.5
-        version: 6.8.5(react-dom@19.3.0(react@19.3.0))(react@19.3.0)(vite@6.4.4)(vue-router@4.6.4(vue@3.5.43(typescript@5.9.3)))(vue@3.5.43(typescript@5.9.3))
+        specifier: 6.9.0
+        version: 6.9.0(react-dom@19.3.0(react@19.3.0))(react@19.3.0)(vite@6.4.4)(vue-router@4.6.4(vue@3.5.43(typescript@5.9.3)))(vue@3.5.43(typescript@5.9.3))
       react:
         specifier: ^19.1.0
         version: 19.3.0
@@ -42,8 +42,8 @@ importers:
   vue-remote:
     dependencies:
       '@fulgurjs/federation':
-        specifier: 6.8.5
-        version: 6.8.5(react-dom@19.3.0(react@19.3.0))(react@19.3.0)(vite@6.4.4)(vue-router@4.6.4(vue@3.5.43(typescript@5.9.3)))(vue@3.5.43(typescript@5.9.3))
+        specifier: 6.9.0
+        version: 6.9.0(react-dom@19.3.0(react@19.3.0))(react@19.3.0)(vite@6.4.4)(vue-router@4.6.4(vue@3.5.43(typescript@5.9.3)))(vue@3.5.43(typescript@5.9.3))
       vue:
         specifier: ^3.5.13
         version: 3.5.43(typescript@5.9.3)
@@ -461,8 +461,8 @@ packages:
     cpu: [x64]
     os: [win32]
 
-  '@fulgurjs/federation@6.8.5':
-    resolution: {integrity: sha512-RsaN4n2ZgGBtI9zVQxDclS3QxYVKAZiCGipXR3umreAg651tIYCmtqkVjqPELSCPW9tg/rYQvzzs/SOV6ZiQfg==}
+  '@fulgurjs/federation@6.9.0':
+    resolution: {tarball: https://registry.npmjs.org/@fulgurjs/federation/-/federation-6.9.0.tgz}
     engines: {node: '>=18'}
     hasBin: true
     peerDependencies:
@@ -1259,7 +1259,7 @@ snapshots:
   '@esbuild/win32-x64@0.27.7':
     optional: true
 
-  '@fulgurjs/federation@6.8.5(react-dom@19.3.0(react@19.3.0))(react@19.3.0)(vite@6.4.4)(vue-router@4.6.4(vue@3.5.43(typescript@5.9.3)))(vue@3.5.43(typescript@5.9.3))':
+  '@fulgurjs/federation@6.9.0(react-dom@19.3.0(react@19.3.0))(react@19.3.0)(vite@6.4.4)(vue-router@4.6.4(vue@3.5.43(typescript@5.9.3)))(vue@3.5.43(typescript@5.9.3))':
     dependencies:
       es-module-lexer: 1.7.0
       esbuild: 0.27.7

package/examples/templates/react-host-vue-remote/pnpm-workspace.yaml

@@ -2,7 +2,7 @@ packages:
   - react-host
   - vue-remote
 minimumReleaseAgeExclude:
-  - '@fulgurjs/federation@6.8.5'
+  - '@fulgurjs/federation@6.9.0'
 # pnpm >=12 构建脚本批准（12 起弃用 onlyBuiltDependencies；pnpm 9-11 忽略本键：
 # esbuild >=0.16 二进制经 optionalDependencies 平台包分发，postinstall 仅校验，不阻塞安装）
 allowBuilds:

package/examples/templates/react-host-vue-remote/react-host/package.json

@@ -11,7 +11,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@fulgurjs/federation": "6.8.5",
+    "@fulgurjs/federation": "6.9.0",
     "react": "^19.1.0",
     "react-dom": "^19.1.0",
     "vue": "^3.5.13"

package/examples/templates/react-host-vue-remote/react-host/src/application.tsx

@@ -0,0 +1,62 @@
+import { StrictMode, useCallback, useState } from 'react'
+import { defineApplication } from '@fulgurjs/federation/react'
+import { clearAppContext } from '@fulgurjs/federation/react'
+import { createReactBridgeApp } from '@fulgurjs/federation/react'
+import { getLatestHostContext, login, logout } from './host-session'
+
+// 工厂选项：fallback（pending 占位）、error（节点或 (error, retry) => ReactNode）、
+// retries、timeout、getContext 与 Vue 宿主同语义
+const RemoteVueApp = createReactBridgeApp('bridge-vue-remote/bridge', {
+  retries: 1,
+  getContext: () => getLatestHostContext(),
+})
+
+function Host() {
+  const [sessionKey, setSessionKey] = useState<string | null>('login-1-alice')
+  const [userName, setUserName] = useState('Alice')
+  const [label, setLabel] = useState('来自 React 宿主')
+  const [readyCount, setReadyCount] = useState(0)
+
+  const handleReady = useCallback(() => setReadyCount((c) => c + 1), [])
+
+  const nextFrame = async (): Promise<void> => {
+    await new Promise((r) => requestAnimationFrame(() => r(null)))
+  }
+
+  const switchUser = async (): Promise<void> => {
+    setSessionKey(null)
+    await nextFrame()
+    clearAppContext()
+    login('login-2-bob', { id: 2, name: 'Bob' })
+    setUserName('Bob')
+    setSessionKey('login-2-bob')
+  }
+
+  const doLogout = async (): Promise<void> => {
+    setSessionKey(null)
+    await nextFrame()
+    clearAppContext()
+    logout()
+    setUserName('')
+  }
+
+  return (
+    <div style={{ fontFamily: 'sans-serif', padding: 16, maxWidth: 720 }}>
+      <h1>React 宿主 × Vue 子应用（@fulgurjs/federation/react）</h1>
+      <p data-testid="demo-session">{`会话：${sessionKey ?? '未登录'}（${userName || '—'}）· onReady 次数：${readyCount}`}</p>
+      <p>
+        <button data-testid="demo-switch" onClick={() => void switchUser()}>切换到 Bob（clearAppContext → 重挂）</button>
+        <button data-testid="demo-logout" onClick={() => void doLogout()}>登出（sessionKey → null）</button>
+      </p>
+      <section style={{ marginTop: 12 }}>
+        <RemoteVueApp sessionKey={sessionKey} appProps={{ label, onReady: handleReady }} />
+      </section>
+    </div>
+  )
+}
+
+export default defineApplication(() => (
+  <StrictMode>
+    <Host />
+  </StrictMode>
+))