@fulgurjs/federation 2.0.1 → 2.0.3

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   RUNTIME_VERSION
-} from "./chunk-I5FNKR7E.js";
+} from "./chunk-RQPLFDDT.js";
 
 // src/index.ts
 import path5 from "path";
@@ -366,28 +366,45 @@ import path2 from "path";
 function jsonReplacer(_k, v) {
   return v;
 }
-function genSharedFacade(specifier, exportNames) {
+function genSharedFacade(specifier, exportNames, dynamic = false) {
   const names = (exportNames ?? []).filter(
     (n) => n !== "default" && /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(n)
   );
-  if (names.length === 0) {
+  if (!dynamic) {
+    if (names.length === 0) {
+      return [
+        `import * as __fulgurjs_facade from ${JSON.stringify(specifier)};`,
+        `export * from ${JSON.stringify(specifier)};`,
+        `export default __fulgurjs_facade.default ?? __fulgurjs_facade;`,
+        ""
+      ].join("\n");
+    }
     return [
       `import * as __fulgurjs_facade from ${JSON.stringify(specifier)};`,
+      ...names.map((n) => `export const ${n} = __fulgurjs_facade[${JSON.stringify(n)}];`),
+      `export default __fulgurjs_facade.default ?? __fulgurjs_facade;`,
+      ""
+    ].join("\n");
+  }
+  if (names.length === 0) {
+    return [
+      `const __fulgurjs_facade = await import(${JSON.stringify(specifier)});`,
       `export * from ${JSON.stringify(specifier)};`,
       `export default __fulgurjs_facade.default ?? __fulgurjs_facade;`,
       ""
     ].join("\n");
   }
   return [
-    `import * as __fulgurjs_facade from ${JSON.stringify(specifier)};`,
-    ...names.map((n) => `export const ${n} = __fulgurjs_facade[${JSON.stringify(n)}];`),
-    `export default __fulgurjs_facade.default ?? __fulgurjs_facade;`,
+    `const __fulgurjs_facade = await import(${JSON.stringify(specifier)});`,
+    `const __fulgurjs_ns = { ...__fulgurjs_facade };`,
+    ...names.map((n) => `export const ${n} = __fulgurjs_ns[${JSON.stringify(n)}];`),
+    `export default __fulgurjs_ns.default ?? __fulgurjs_ns;`,
     ""
   ].join("\n");
 }
-function genSharedNsFacade(item, loadShareCall, exportNames) {
+function genSharedNsFacade(item, loadShareCall, exportNames, dynamic = false) {
   const lines = [
-    `import { loadShare as __fulgurjs_loadShare, unwrapDefault as __fulgurjsU } from "virtual:fulgurjs-runtime";`,
+    dynamic ? `const { loadShare: __fulgurjs_loadShare, unwrapDefault: __fulgurjsU } = await import("virtual:fulgurjs-runtime");` : `import { loadShare as __fulgurjs_loadShare, unwrapDefault as __fulgurjsU } from "virtual:fulgurjs-runtime";`,
     `const __fulgurjs_m = await ${loadShareCall};`,
     `const __fulgurjs_d = __fulgurjsU(__fulgurjs_m);`,
     `export default __fulgurjs_d;`
@@ -401,9 +418,9 @@ function genSharedNsFacade(item, loadShareCall, exportNames) {
   lines.push("");
   return lines.join("\n");
 }
-function genBindingFacade(item, bindings, loadShareCall) {
+function genBindingFacade(item, bindings, loadShareCall, dynamic = false) {
   const lines = [
-    `import { loadShare as __fulgurjs_loadShare, unwrapDefault as __fulgurjsU } from "virtual:fulgurjs-runtime";`,
+    dynamic ? `const { loadShare: __fulgurjs_loadShare, unwrapDefault: __fulgurjsU } = await import("virtual:fulgurjs-runtime");` : `import { loadShare as __fulgurjs_loadShare, unwrapDefault as __fulgurjsU } from "virtual:fulgurjs-runtime";`,
     `const __fulgurjs_m = await ${loadShareCall};`
   ];
   const seen = /* @__PURE__ */ new Set();
@@ -419,9 +436,9 @@ function genBindingFacade(item, bindings, loadShareCall) {
   lines.push("");
   return lines.join("\n");
 }
-function genRemoteBindingFacade(remoteSpec, bindings) {
+function genRemoteBindingFacade(remoteSpec, bindings, dynamic = false) {
   const lines = [
-    `import { loadRemote as __fulgurjs_loadRemote, unwrapDefault as __fulgurjsU } from "virtual:fulgurjs-runtime";`,
+    dynamic ? `const { loadRemote: __fulgurjs_loadRemote, unwrapDefault: __fulgurjsU } = await import("virtual:fulgurjs-runtime");` : `import { loadRemote as __fulgurjs_loadRemote, unwrapDefault: __fulgurjsU } from "virtual:fulgurjs-runtime";`.replace("unwrapDefault: __fulgurjsU", "unwrapDefault as __fulgurjsU"),
     `const __fulgurjs_m = await __fulgurjs_loadRemote(${JSON.stringify(remoteSpec)});`
   ];
   const seen = /* @__PURE__ */ new Set();
@@ -488,13 +505,17 @@ function manifestUrlFor(r, command) {
   const entry = command === "serve" ? r.devEntry : r.prodEntry;
   if (!entry) return null;
   try {
-    const u = new URL(entry);
+    const hasScheme = /^[a-z][a-z\d+.-]*:/i.test(entry);
+    const isProtocolRelative = entry.startsWith("//");
+    const u = new URL(entry, hasScheme ? void 0 : "http://fulgurjs.invalid");
     if (u.pathname.includes("@fulgurjs-entry.js")) {
       u.pathname = u.pathname.replace("@fulgurjs-entry.js", "@fulgurjs-manifest.json");
     } else {
       u.pathname = u.pathname.replace(/[^/]*$/, "") + "fulgurjs-manifest.json";
     }
-    return u.href;
+    if (hasScheme) return u.href;
+    if (isProtocolRelative) return `//${u.host}${u.pathname}${u.search}${u.hash}`;
+    return `${u.pathname}${u.search}${u.hash}`;
   } catch {
     return null;
   }
@@ -778,6 +799,10 @@ function parseImportClause(clause) {
   return { ns: nsMatch?.[1] ?? null, bindings, defaultLocal };
 }
 var JS_EXT_RE = /\.(m|c)?[jt]sx?$/;
+function inSharedClosure(moduleId, roots) {
+  if (!roots || roots.length === 0) return false;
+  return roots.some((r) => moduleId.startsWith(r.root));
+}
 function isTransformableId(id, allowNodeModules = false) {
   const clean = id.split("?")[0];
   if (!JS_EXT_RE.test(clean) && !clean.endsWith(".vue")) return false;
@@ -828,6 +853,7 @@ function remoteFacadeSpecFor(ctx, remoteName, exposeName, bindings) {
 }
 async function transformModule(code, id, ctx) {
   const { options } = ctx;
+  const clean = id.split("?")[0];
   if (options.shared.length === 0 && options.remotes.length === 0) return null;
   const candidates = [];
   for (const s2 of options.shared) candidates.push(s2.configKey.replace(/\/$/, ""));
@@ -914,7 +940,8 @@ export { ${nsAs[1]} };`);
       while (code[stmtEnd] === ";") stmtEnd++;
       const head = code.slice(stmtStart, stmtStart + 24);
       if (/^\s*(import|export)\s+type[\s{]/.test(head)) continue;
-      const shared2 = matcher ? matchShared(spec2, matcher) : null;
+      const matched2 = matcher ? matchShared(spec2, matcher) : null;
+      const shared2 = matched2 && inSharedClosure(clean, ctx.sharedClosureRoots) ? null : matched2;
       const firstSeg2 = spec2.split("/")[0];
       const remote2 = remotesByKey.get(firstSeg2);
       const exposeName2 = remote2 ? remoteExposeName(spec2, remote2.key) : null;
@@ -947,7 +974,8 @@ export { ${nsAs[1]} };`);
     const literal = specExpr.match(/^['"](.*)['"]$/s);
     if (!literal) continue;
     const spec = remap(literal[1]);
-    const shared = matcher ? matchShared(spec, matcher) : null;
+    const matched = matcher ? matchShared(spec, matcher) : null;
+    const shared = matched && inSharedClosure(clean, ctx.sharedClosureRoots) ? null : matched;
     const firstSeg = spec.split("/")[0];
     const remote = remotesByKey.get(firstSeg);
     const exposeName = remote ? remoteExposeName(spec, remote.key) : null;
@@ -1262,7 +1290,7 @@ function syncViteCacheMarker(root, pluginVersion, log) {
 }
 
 // src/runtime-code.gen.ts
-var runtime_code_gen_default = 'var X=/^v?(\\d+)(?:\\.(\\d+))?(?:\\.(\\d+))?(?:-((?:[0-9A-Za-z-]+)(?:\\.[0-9A-Za-z-]+)*))?(?:\\+[0-9A-Za-z.-]+)?$/;function T(t){let n=X.exec(String(t).trim());return n?{major:Number(n[1]),minor:Number(n[2]??0),patch:Number(n[3]??0),pre:n[4]?n[4].split("."):[]}:null}function Y(t,n){if(t.length===0&&n.length===0)return 0;if(t.length===0)return 1;if(n.length===0)return-1;let o=Math.max(t.length,n.length);for(let r=0;r<o;r++){let l=t[r],m=n[r];if(l===void 0)return-1;if(m===void 0)return 1;let y=/^\\d+$/.test(l),E=/^\\d+$/.test(m);if(y&&E){let w=Number(l)-Number(m);if(w!==0)return w}else{if(y!==E)return y?-1:1;if(l!==m)return l<m?-1:1}}return 0}function v(t,n){let o=T(t),r=T(n);return!o||!r?t<n?-1:t>n?1:0:o.major!==r.major?o.major-r.major:o.minor!==r.minor?o.minor-r.minor:o.patch!==r.patch?o.patch-r.patch:Y(o.pre,r.pre)}var Z=/^[a-z]+[+:-]/i;function O(t,n){if(n===!1||n==null||n==="")return!0;let o=String(n).trim();return!o||o==="*"||o==="latest"||Z.test(o)?!0:o.split("||").some(r=>Q(t,r.trim()))}function Q(t,n){if(!n||n==="*")return!T(t)?.pre.length;let o=n.split(/\\s+-\\s+/);if(o.length===2){let m=o[0].trim(),y=o[1].trim();return!(!O(t,`>=${m}`)||!O(t,`<=${y}`))}let r=T(t);if(!r)return!1;let l=ee(n);if(l===null)return!0;for(let m of l)if(!ie(r,t,m))return!1;return!(r.pre.length>0&&!l.some(m=>m.ver.pre.length>0)&&!l.some(y=>y.ver.major===r.major&&y.ver.minor===r.minor&&y.ver.patch===r.patch))}function ee(t){let n=[],o=t.trim().split(/\\s+/).filter(Boolean);if(o.length===0)return null;for(let r of o){let l=/^(>=|<=|>|<|=|\\^|~)?(.*)$/.exec(r);if(!l)return null;let m=l[1],y=l[2],E=re(m,y);if(E===null)return null;n.push(...E)}return n}function re(t,n){let o=ne(n);if(!o)return null;let{ver:r,partial:l}=o;switch(t){case"^":{let m=te(r);return m?[{op:">=",ver:r},{op:"<",ver:m}]:null}case"~":{let m=l>=2?{major:r.major,minor:r.minor+1,patch:0,pre:[]}:{major:r.major+1,minor:0,patch:0,pre:[]};return[{op:">=",ver:r},{op:"<",ver:m}]}case">=":return[{op:">=",ver:r}];case">":return l===1?[{op:">=",ver:{major:r.major+1,minor:0,patch:0,pre:[]}}]:l===2?[{op:">=",ver:{major:r.major,minor:r.minor+1,patch:0,pre:[]}}]:[{op:">",ver:r}];case"<":return l===1?[{op:"<",ver:{major:r.major,minor:0,patch:0,pre:[]}}]:l===2?[{op:"<",ver:{major:r.major,minor:r.minor,patch:0,pre:[]}}]:[{op:"<",ver:r}];case"<=":return[{op:"<=",ver:r}];case"=":case void 0:return l===1?[{op:">=",ver:r},{op:"<",ver:{major:r.major+1,minor:0,patch:0,pre:[]}}]:l===2?[{op:">=",ver:r},{op:"<",ver:{major:r.major,minor:r.minor+1,patch:0,pre:[]}}]:[{op:"=",ver:r}];default:return null}}function te(t){return t.major>0?{major:t.major+1,minor:0,patch:0,pre:[]}:t.minor>0?{major:0,minor:t.minor+1,patch:0,pre:[]}:{major:0,minor:0,patch:t.patch+1,pre:[]}}function ne(t){let n=t.replace(/^v/,"").trim();if(!n||n==="*"||n==="x"||n==="X")return{ver:{major:0,minor:0,patch:0,pre:[]},partial:0};let o=n.split("."),r=[],l=0;for(let E of o.slice(0,3))if(/^\\d+$/.test(E))r.push(Number(E)),l++;else{if(E==="x"||E==="X"||E==="*")break;break}let m=n.split("-"),y=m.length>1?m.slice(1).join("-").split("+")[0].split("."):[];return l===0&&y.length===0?{ver:{major:0,minor:0,patch:0,pre:[]},partial:0}:{ver:{major:r[0]??0,minor:r[1]??0,patch:r[2]??0,pre:y},partial:l}}function oe(t,n){switch(n){case">=":return t>=0;case">":return t>0;case"<":return t<0;case"<=":return t<=0;case"=":return t===0}}function ie(t,n,o){let r=`${t.major}.${t.minor}.${t.patch}`+(t.pre.length?`-${t.pre.join(".")}`:"");if(o.upper)return!(!(v(r,`${o.ver.major}.${o.ver.minor}.${o.ver.patch}`+(o.ver.pre.length?`-${o.ver.pre.join(".")}`:""))>=0)||!(v(r,`${o.upper.major}.${o.upper.minor}.${o.upper.patch}`)<0));let l=v(r,`${o.ver.major}.${o.ver.minor}.${o.ver.patch}`+(o.ver.pre.length?`-${o.ver.pre.join(".")}`:"")),m=oe(l,o.op);return o.ver.pre.length>0&&t.pre.length===0&&(o.op===">"||o.op==="<")?!1:m}var g=class extends Error{code;details;constructor(n,o,r){super(`[fulgurjs:${n}] ${o}`),this.name="FgError",this.code=n,this.details=r}},S={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"};var U="2.0.1";var A=15e3,P=2,ae=5,se=3e4;function ce(){let t={},n=new Map,o=[],r=new Map,l=new WeakMap,m={},y=()=>{for(let e of o)try{e.init?.(m)}catch(i){console.warn("[fulgurjs] runtimePlugin init failed:",e.name,i)}},E=e=>t[e]??={};function w(e){try{m.onRemoteError?.(e)}catch{}typeof window<"u"&&window.dispatchEvent(new CustomEvent("fulgurjs:error",{detail:e}))}function F(e="default"){return E(e),t}function V(e,i,a,c,R={}){let s=E(e||"default"),u=s[i]??={};u[a]||(u[a]={version:a,get:c,from:R.from??"unknown",eager:!!R.eager,loaded:!!R.loaded})}function I(e){for(let i of e){let a=n.get(i.name);n.set(i.name,{timeout:A,retries:P,...a,...i,state:a?.state??"idle",breakerState:a?.breakerState??{fails:0,openUntil:0},debug:a?.debug??{entry:i.entry,status:"idle"}})}}function D(e){I([e])}function H(e){o.push(...e),y()}async function K(e,i={}){let a=i.shareScope||"default",c=i.shareKey||e,s=E(a)[c]||{},u=Object.keys(s),d=i.requiredVersion,f=u.filter(p=>d===void 0||d===!1||O(p,d)),_;if(i.singleton&&u.length>0){let p=u.filter(h=>s[h].loaded);if(_=[...p.length?p:u].sort(v).pop(),u.length>1||!f.includes(_)){let h=s[_],j=`singleton skew "${c}": req "${d??"any"}" use ${_} from ${h.from}`;if(i.strictVersion){let M=new g(S.SHARE_STRICT_VERSION,j,{shareKey:c,requiredVersion:d});throw w({remote:h.from,error:M}),M}console.warn(`[fulgurjs:MFU-010] ${j}`)}}else if(_=[...f].sort(v).pop(),!_){if(i.strictVersion){let h=new g(S.SHARE_STRICT_VERSION,`no satisfying version for "${c}" (required "${d}") in share scope "${a}"`);throw w({remote:c,error:h}),h}if(i.fallback)return i.fallback();let p=new g(S.SHARE_NOT_AVAILABLE,`shared "${c}" (${d??"any"}) unavailable in scope "${a}" (no local fallback)`,{shareKey:c,requiredVersion:d});throw w({remote:c,error:p}),p}let $=s[_];if(m.resolveShare){let p=await m.resolveShare({shareKey:c,shareScope:a,requiredVersion:d,picked:$,available:Object.values(s)});p&&($=p)}return $.loaded=!0,$.get()}function q(e,i,a){return new Promise((c,R)=>{let s=setTimeout(()=>R(new Error(`timeout after ${i}ms: ${a}`)),i);e.then(u=>{clearTimeout(s),c(u)},u=>{clearTimeout(s),R(u)})})}let z=e=>new Promise(i=>setTimeout(i,e));function k(e,i){if(!e||typeof e.get!="function")throw new Error(`remoteEntry of "${i.name}" does not export a container interface (get/init)`);if(e.name&&i.name&&e.name!==i.name){let a=`remoteEntry self-reported name "${e.name}" mismatches configured name "${i.name}"`;if(i.promise)console.warn(`[fulgurjs] ${a} (promise-based remote, continuing)`);else throw Object.assign(new Error(a),{code:S.REMOTE_NAME_MISMATCH})}}async function L(e,i){return q(import(e),i.timeout??A,`load remoteEntry ${e}`)}async function x(e,i){let a=e.shareScope||"default";if(e.container){let s=l.get(e.container);if(s&&s!==a)throw new g(S.CONTAINER_REINIT_CONFLICT,`container "${e.name}" already initialized with share scope "${s}", cannot re-init with "${a}"`);return e.container}if(e.containerPromise)return e.containerPromise;let c=e.breakerState;if(c.openUntil>Date.now()){let s=new g(S.REMOTE_LOAD_FAILED,`circuit breaker open for remote "${e.name}" until ${new Date(c.openUntil).toISOString()}`,{remote:e.name});throw w({remote:e.name,error:s}),s}e.state="loading",e.debug.status="loading";let R=(async()=>{let s=[];if(e.promise)s.push(async()=>{let p=await e.promise(),h=typeof p=="string"?await L(p,e):p;return k(h,e),h});else for(let p of[e.entry,...e.fallback??[]])s.push(async()=>{let h=await L(p,e);return k(h,e),h});let u,d,f=!1,_=i?.retries??e.retries??P;for(let p of s){for(let h=0;h<=_;h++){let j=performance.now();try{u=await p(),e.lastLoadMs=Math.round(performance.now()-j),e.debug.lastLoadMs=e.lastLoadMs,f=!0;break}catch(M){if(d=M,M?.code)throw M;h<_&&await z(200*2**h)}}if(f)break}if(!f||!u){let p=[];throw/^https?:\\/\\//.test(e.entry)&&typeof location<"u"?(p.push(`1. is the remote dev server running?  try opening ${e.entry} in the browser \\u2014 it must return JS, not HTML/an error`),p.push("2. is the URL correct in federation({ remotes })?  dev and prod entries can differ"),p.push("3. CORS: the remote dev server must allow cross-origin requests (fulgurjs-federation enables server.cors automatically; a custom server config may have disabled it)")):(p.push(`1. is the remote deployed and reachable?  try opening ${e.entry} in the browser \\u2014 it must return JS`),p.push("2. NGINX/CDN routing: the entry path must serve the remoteEntry JS file (check try_files / fallback rules)")),new g(S.REMOTE_LOAD_FAILED,`failed to load remote "${e.name}" from ${e.entry}: ${String(d?.message??d)}\n`+p.join(`\n`),{remote:e.name})}k(u,e);let $=l.get(u);if($&&$!==a)throw new g(S.CONTAINER_REINIT_CONFLICT,`container "${e.name}" already initialized with share scope "${$}", cannot re-init with "${a}"`);return typeof u.init=="function"&&await u.init(t),l.set(u,a),e.container=u,e.state="loaded",e.debug.status="loaded",c.fails=0,u})();e.containerPromise=R;try{return await R}catch(s){if(e.containerPromise=void 0,e.state="failed",e.debug.status="failed",e.debug.error=String(s?.message??s),c.fails+=1,c.fails>=ae&&(c.openUntil=Date.now()+se,c.fails=0),s instanceof g)throw w({remote:e.name,error:s}),s;if(s?.code)throw w({remote:e.name,error:s}),s;let u=new g(S.REMOTE_LOAD_FAILED,String(s?.message??s),{remote:e.name});throw w({remote:e.name,error:u}),u}}function N(e){let i=e.indexOf("/");return i===-1?{remote:e,module:""}:{remote:e.slice(0,i),module:G(e.slice(i+1))}}function G(e){return e?e.startsWith(".")?e:`./${e}`:""}async function J(e,i){let{remote:a,module:c}=N(e);m.beforeLoadRemote?.({remote:a,module:c});let R=n.get(a);if(!R)throw new g(S.REMOTE_UNKNOWN,`unknown remote "${a}". Register it via federation({ remotes }) or registerRemote().`,{remote:a});let s;try{s=await x(R,{retries:i?.retries})}catch(f){if(i?.fallbackModule)return console.error(`[fulgurjs] loadRemote("${e}") failed; returning fallbackModule (\\u663E\\u5F0F\\u964D\\u7EA7\\uFF0C\\u9519\\u8BEF\\u5DF2\\u900F\\u51FA)`,f),w({remote:a,error:f}),await i.fallbackModule();throw f}if(!c)return s;let u=`${a}@${R.shareScope||"default"}#${c}`;r.has(u)||r.set(u,s.get(c).catch(f=>{throw r.delete(u),f instanceof g||f?.code?f:new g(S.REMOTE_LOAD_FAILED,`failed to load module "${c}" from remote "${a}": ${String(f?.message??f)}`,{remote:a,module:c})}));let d;try{d=await r.get(u)}catch(f){if(i?.fallbackModule)return console.error(`[fulgurjs] loadRemote("${e}") failed; returning fallbackModule (\\u663E\\u5F0F\\u964D\\u7EA7\\uFF0C\\u9519\\u8BEF\\u5DF2\\u900F\\u51FA)`,f),w({remote:a,error:f}),await i.fallbackModule();throw f}if(m.afterLoadRemote?.({remote:a,module:c,module_ns:d}),d&&typeof d=="object"&&Object.keys(d).length===0){let f=new g(S.EMPTY_EXPORTS,`no exports: ${c} @ ${a}`,{remote:a,module:c});w({remote:a,error:f}),console.error(`[fulgurjs:MFU-009] ${f.message}`)}return d}function W(e){let i=n.get(e);if(!i)throw new g(S.REMOTE_UNKNOWN,`unknown remote "${e}"`,{remote:e});return x(i)}async function B(e,i={}){let{remote:a}=N(e),c=n.get(a);if(!c)throw new g(S.REMOTE_UNKNOWN,`unknown remote "${a}"`,{remote:a});let R=i.mode??"preload",s=(u,d)=>{if(typeof document>"u"||document.querySelector(`link[href="${u}"]`))return;let f=document.createElement("link");f.rel=d==="style"?"stylesheet":"modulepreload",f.href=u,R==="prefetch"&&(f.fetchPriority="low"),document.head.appendChild(f)};try{if(c.manifestUrl){let u=await fetch(c.manifestUrl,{cache:"no-cache"});if(u.ok){let d=await u.json();s(c.entry,"modulepreload");let f=d.exposes??{};for(let _ of Object.keys(f)){let $=f[_];$?.file&&s(new URL($.file,c.entry).href,"modulepreload");for(let p of $?.css??[])s(new URL(p,c.entry).href,"style")}return}}s(c.entry,"modulepreload")}catch(u){w({remote:a,error:new g(S.PRELOAD_FAILED,String(u?.message??u),{remote:a})})}}return typeof window>"u"||(window.__FULGURJS_SCOPE__=t,window.__FULGURJS_INFO__={get remotes(){let e={};for(let[i,a]of n)e[i]={...a.debug,entry:a.entry};return e},errors:[]}),{shareScopeMap:t,initSharing:F,registerShare:V,registerRemotes:I,registerRemote:D,registerPlugins:H,loadShare:K,loadRemote:J,getContainer:W,preloadRemote:B,parseSpec:N}}var C=globalThis,b=C.__FULGURJS_RUNTIME__??ce();C.__FULGURJS_RUNTIME__=b;try{Object.freeze(b)}catch{}var he=U;function ye(){return b}var Ee=b.initSharing,Re=b.registerShare,Se=b.registerRemotes,we=b.registerRemote,be=b.registerPlugins,_e=b.loadShare,$e=b.loadRemote,Me=b.getContainer,ve=b.preloadRemote,je=b.shareScopeMap;function Te(t){if(t&&typeof t=="object"&&"default"in t){let n=t.default;return n!==void 0?n:t}return t}var Oe=b;export{Oe as default,Me as getContainer,ye as getRuntime,Ee as initSharing,$e as loadRemote,_e as loadShare,ve as preloadRemote,be as registerPlugins,we as registerRemote,Se as registerRemotes,Re as registerShare,b as runtime,je as shareScopeMap,Te as unwrapDefault,he as version};\n';
+var runtime_code_gen_default = 'var re=/^v?(\\d+)(?:\\.(\\d+))?(?:\\.(\\d+))?(?:-((?:[0-9A-Za-z-]+)(?:\\.[0-9A-Za-z-]+)*))?(?:\\+[0-9A-Za-z.-]+)?$/;function P(t){let n=re.exec(String(t).trim());return n?{major:Number(n[1]),minor:Number(n[2]??0),patch:Number(n[3]??0),pre:n[4]?n[4].split("."):[]}:null}function te(t,n){if(t.length===0&&n.length===0)return 0;if(t.length===0)return 1;if(n.length===0)return-1;let o=Math.max(t.length,n.length);for(let r=0;r<o;r++){let m=t[r],d=n[r];if(m===void 0)return-1;if(d===void 0)return 1;let S=/^\\d+$/.test(m),w=/^\\d+$/.test(d);if(S&&w){let L=Number(m)-Number(d);if(L!==0)return L}else{if(S!==w)return S?-1:1;if(m!==d)return m<d?-1:1}}return 0}function T(t,n){let o=P(t),r=P(n);return!o||!r?t<n?-1:t>n?1:0:o.major!==r.major?o.major-r.major:o.minor!==r.minor?o.minor-r.minor:o.patch!==r.patch?o.patch-r.patch:te(o.pre,r.pre)}var ne=/^[a-z]+[+:-]/i;function N(t,n){if(n===!1||n==null||n==="")return!0;let o=String(n).trim();return!o||o==="*"||o==="latest"||ne.test(o)?!0:o.split("||").some(r=>oe(t,r.trim()))}function oe(t,n){if(!n||n==="*")return!P(t)?.pre.length;let o=n.split(/\\s+-\\s+/);if(o.length===2){let d=o[0].trim(),S=o[1].trim();return!(!N(t,`>=${d}`)||!N(t,`<=${S}`))}let r=P(t);if(!r)return!1;let m=ie(n);if(m===null)return!0;for(let d of m)if(!ue(r,t,d))return!1;return!(r.pre.length>0&&!m.some(d=>d.ver.pre.length>0)&&!m.some(S=>S.ver.major===r.major&&S.ver.minor===r.minor&&S.ver.patch===r.patch))}function ie(t){let n=[],o=t.trim().split(/\\s+/).filter(Boolean);if(o.length===0)return null;for(let r of o){let m=/^(>=|<=|>|<|=|\\^|~)?(.*)$/.exec(r);if(!m)return null;let d=m[1],S=m[2],w=se(d,S);if(w===null)return null;n.push(...w)}return n}function se(t,n){let o=ce(n);if(!o)return null;let{ver:r,partial:m}=o;switch(t){case"^":{let d=ae(r);return d?[{op:">=",ver:r},{op:"<",ver:d}]:null}case"~":{let d=m>=2?{major:r.major,minor:r.minor+1,patch:0,pre:[]}:{major:r.major+1,minor:0,patch:0,pre:[]};return[{op:">=",ver:r},{op:"<",ver:d}]}case">=":return[{op:">=",ver:r}];case">":return m===1?[{op:">=",ver:{major:r.major+1,minor:0,patch:0,pre:[]}}]:m===2?[{op:">=",ver:{major:r.major,minor:r.minor+1,patch:0,pre:[]}}]:[{op:">",ver:r}];case"<":return m===1?[{op:"<",ver:{major:r.major,minor:0,patch:0,pre:[]}}]:m===2?[{op:"<",ver:{major:r.major,minor:r.minor,patch:0,pre:[]}}]:[{op:"<",ver:r}];case"<=":return[{op:"<=",ver:r}];case"=":case void 0:return m===1?[{op:">=",ver:r},{op:"<",ver:{major:r.major+1,minor:0,patch:0,pre:[]}}]:m===2?[{op:">=",ver:r},{op:"<",ver:{major:r.major,minor:r.minor+1,patch:0,pre:[]}}]:[{op:"=",ver:r}];default:return null}}function ae(t){return t.major>0?{major:t.major+1,minor:0,patch:0,pre:[]}:t.minor>0?{major:0,minor:t.minor+1,patch:0,pre:[]}:{major:0,minor:0,patch:t.patch+1,pre:[]}}function ce(t){let n=t.replace(/^v/,"").trim();if(!n||n==="*"||n==="x"||n==="X")return{ver:{major:0,minor:0,patch:0,pre:[]},partial:0};let o=n.split("."),r=[],m=0;for(let w of o.slice(0,3))if(/^\\d+$/.test(w))r.push(Number(w)),m++;else{if(w==="x"||w==="X"||w==="*")break;break}let d=n.split("-"),S=d.length>1?d.slice(1).join("-").split("+")[0].split("."):[];return m===0&&S.length===0?{ver:{major:0,minor:0,patch:0,pre:[]},partial:0}:{ver:{major:r[0]??0,minor:r[1]??0,patch:r[2]??0,pre:S},partial:m}}function le(t,n){switch(n){case">=":return t>=0;case">":return t>0;case"<":return t<0;case"<=":return t<=0;case"=":return t===0}}function ue(t,n,o){let r=`${t.major}.${t.minor}.${t.patch}`+(t.pre.length?`-${t.pre.join(".")}`:"");if(o.upper)return!(!(T(r,`${o.ver.major}.${o.ver.minor}.${o.ver.patch}`+(o.ver.pre.length?`-${o.ver.pre.join(".")}`:""))>=0)||!(T(r,`${o.upper.major}.${o.upper.minor}.${o.upper.patch}`)<0));let m=T(r,`${o.ver.major}.${o.ver.minor}.${o.ver.patch}`+(o.ver.pre.length?`-${o.ver.pre.join(".")}`:"")),d=le(m,o.op);return o.ver.pre.length>0&&t.pre.length===0&&(o.op===">"||o.op==="<")?!1:d}var R=class extends Error{code;details;constructor(n,o,r){super(`[fulgurjs:${n}] ${o}`),this.name="FgError",this.code=n,this.details=r}},b={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"};var V="2.0.3";var H=15e3,K=2,me=5,fe=3e4;function pe(){let t={},n=new Map,o=[],r=new Map,m=new Map,d=new WeakMap,S=new WeakMap,w={},L=()=>{for(let e of o)try{e.init?.(w)}catch(i){console.warn("[fulgurjs] runtimePlugin init failed:",e.name,i)}},I=e=>t[e]??={};function $(e){try{w.onRemoteError?.(e)}catch{}typeof window<"u"&&window.dispatchEvent(new CustomEvent("fulgurjs:error",{detail:e}))}function z(e="default"){return I(e),t}function W(e,i,s,l,h={}){let c=I(e||"default"),f=c[i]??={};f[s]||(f[s]={version:s,get:l,from:h.from??"unknown",eager:!!h.eager,loaded:!!h.loaded})}function A(e){for(let i of e){let s=n.get(i.name);n.set(i.name,{timeout:H,retries:K,...s,...i,state:s?.state??"idle",breakerState:s?.breakerState??{fails:0,openUntil:0},debug:s?.debug??{entry:i.entry,status:"idle"}})}}function G(e){A([e])}function J(e){o.push(...e),L()}async function B(e,i={}){let s=i.shareScope||"default",l=i.shareKey||e,c=I(s)[l]||{},f=Object.keys(c),y=i.requiredVersion,g=f.filter(a=>y===void 0||y===!1||N(a,y)),u;if(i.singleton&&f.length>0){let a=f.filter(p=>c[p].loaded);if(u=[...a.length?a:f].sort(T).pop(),f.length>1||!g.includes(u)){let p=c[u],j=`singleton skew "${l}": req "${y??"any"}" use ${u} from ${p.from}`;if(i.strictVersion){let _=new R(b.SHARE_STRICT_VERSION,j,{shareKey:l,requiredVersion:y});throw $({remote:p.from,error:_}),_}console.warn(`[fulgurjs:MFU-010] ${j}`)}}else if(u=[...g].sort(T).pop(),!u){if(i.strictVersion){let p=new R(b.SHARE_STRICT_VERSION,`no satisfying version for "${l}" (required "${y}") in share scope "${s}"`);throw $({remote:l,error:p}),p}if(i.fallback)return i.fallback();let a=new R(b.SHARE_NOT_AVAILABLE,`shared "${l}" (${y??"any"}) unavailable in scope "${s}" (no local fallback)`,{shareKey:l,requiredVersion:y});throw $({remote:l,error:a}),a}let E=c[u];if(w.resolveShare){let a=await w.resolveShare({shareKey:l,shareScope:s,requiredVersion:y,picked:E,available:Object.values(c)});a&&(E=a)}return E.loaded=!0,E.get()}function X(e,i,s){return new Promise((l,h)=>{let c=setTimeout(()=>h(new Error(`timeout after ${i}ms: ${s}`)),i);e.then(f=>{clearTimeout(c),l(f)},f=>{clearTimeout(c),h(f)})})}let Y=e=>new Promise(i=>setTimeout(i,e));function k(e,i){if(!e||typeof e.get!="function")throw new Error(`remoteEntry of "${i.name}" does not export a container interface (get/init)`);if(e.name&&i.name&&e.name!==i.name){let s=`remoteEntry self-reported name "${e.name}" mismatches configured name "${i.name}"`;if(i.promise)console.warn(`[fulgurjs] ${s} (promise-based remote, continuing)`);else throw Object.assign(new Error(s),{code:b.REMOTE_NAME_MISMATCH})}}async function x(e,i){return X(import(e),i.timeout??H,`load remoteEntry ${e}`)}async function C(e,i){let s=e.shareScope||"default";if(e.container){let c=S.get(e.container);if(c&&c!==s)throw new R(b.CONTAINER_REINIT_CONFLICT,`container "${e.name}" already initialized with share scope "${c}", cannot re-init with "${s}"`);return e.container}if(e.containerPromise)return e.containerPromise;let l=e.breakerState;if(l.openUntil>Date.now()){let c=new R(b.REMOTE_LOAD_FAILED,`circuit breaker open for remote "${e.name}" until ${new Date(l.openUntil).toISOString()}`,{remote:e.name});throw $({remote:e.name,error:c}),c}e.state="loading",e.debug.status="loading";let h=(async()=>{let c=[];if(e.promise)c.push(async()=>{let a=await e.promise(),p=typeof a=="string"?await x(a,e):a;return k(p,e),p});else for(let a of[e.entry,...e.fallback??[]])c.push(async()=>{let p=await x(a,e);return k(p,e),p});let f,y,g=!1,u=i?.retries??e.retries??K;for(let a of c){for(let p=0;p<=u;p++){let j=performance.now();try{f=await a(),e.lastLoadMs=Math.round(performance.now()-j),e.debug.lastLoadMs=e.lastLoadMs,g=!0;break}catch(_){if(y=_,_?.code)throw _;p<u&&await Y(200*2**p)}}if(g)break}if(!g||!f){let a=[];throw/^https?:\\/\\//.test(e.entry)&&typeof location<"u"?(a.push(`1. is the remote dev server running?  try opening ${e.entry} in the browser \\u2014 it must return JS, not HTML/an error`),a.push("2. is the URL correct in federation({ remotes })?  dev and prod entries can differ"),a.push("3. CORS: the remote dev server must allow cross-origin requests (fulgurjs-federation enables server.cors automatically; a custom server config may have disabled it)")):(a.push(`1. is the remote deployed and reachable?  try opening ${e.entry} in the browser \\u2014 it must return JS`),a.push("2. NGINX/CDN routing: the entry path must serve the remoteEntry JS file (check try_files / fallback rules)")),new R(b.REMOTE_LOAD_FAILED,`failed to load remote "${e.name}" from ${e.entry}: ${String(y?.message??y)}\n`+a.join(`\n`),{remote:e.name})}k(f,e);let E=S.get(f);if(E&&E!==s)throw new R(b.CONTAINER_REINIT_CONFLICT,`container "${e.name}" already initialized with share scope "${E}", cannot re-init with "${s}"`);return typeof f.init=="function"&&await f.init(t),S.set(f,s),e.container=f,e.state="loaded",e.debug.status="loaded",l.fails=0,f})();e.containerPromise=h;try{return await h}catch(c){if(e.containerPromise=void 0,e.state="failed",e.debug.status="failed",e.debug.error=String(c?.message??c),l.fails+=1,l.fails>=me&&(l.openUntil=Date.now()+fe,l.fails=0),c instanceof R)throw $({remote:e.name,error:c}),c;if(c?.code)throw $({remote:e.name,error:c}),c;let f=new R(b.REMOTE_LOAD_FAILED,String(c?.message??c),{remote:e.name});throw $({remote:e.name,error:f}),f}}function U(e){let i=e.indexOf("/");return i===-1?{remote:e,module:""}:{remote:e.slice(0,i),module:F(e.slice(i+1))}}function F(e){return e?e.startsWith(".")?e:`./${e}`:""}async function Z(e,i){let{remote:s,module:l}=U(e);w.beforeLoadRemote?.({remote:s,module:l});let h=n.get(s);if(!h)throw new R(b.REMOTE_UNKNOWN,`unknown remote "${s}". Register it via federation({ remotes }) or registerRemote().`,{remote:s});let c;try{let g=l&&h.manifestUrl?D(e):Promise.resolve();[c]=await Promise.all([C(h,{retries:i?.retries}),g])}catch(g){if(i?.fallbackModule)return console.error(`[fulgurjs] loadRemote("${e}") failed; returning fallbackModule (\\u663E\\u5F0F\\u964D\\u7EA7\\uFF0C\\u9519\\u8BEF\\u5DF2\\u900F\\u51FA)`,g),$({remote:s,error:g}),await i.fallbackModule();throw g}if(!l)return c;let f=`${s}@${h.shareScope||"default"}#${l}`;r.has(f)||r.set(f,c.get(l).catch(g=>{throw r.delete(f),g instanceof R||g?.code?g:new R(b.REMOTE_LOAD_FAILED,`failed to load module "${l}" from remote "${s}": ${String(g?.message??g)}`,{remote:s,module:l})}));let y;try{y=await r.get(f)}catch(g){if(i?.fallbackModule)return console.error(`[fulgurjs] loadRemote("${e}") failed; returning fallbackModule (\\u663E\\u5F0F\\u964D\\u7EA7\\uFF0C\\u9519\\u8BEF\\u5DF2\\u900F\\u51FA)`,g),$({remote:s,error:g}),await i.fallbackModule();throw g}if(w.afterLoadRemote?.({remote:s,module:l,module_ns:y}),y&&typeof y=="object"&&Object.keys(y).length===0){let g=new R(b.EMPTY_EXPORTS,`no exports: ${l} @ ${s}`,{remote:s,module:l});$({remote:s,error:g}),console.error(`[fulgurjs:MFU-009] ${g.message}`)}return y}function Q(e){let i=n.get(e);if(!i)throw new R(b.REMOTE_UNKNOWN,`unknown remote "${e}"`,{remote:e});return C(i)}async function D(e,i={}){let{remote:s,module:l}=U(e),h=n.get(s);if(!h)throw new R(b.REMOTE_UNKNOWN,`unknown remote "${s}"`,{remote:s});let c=i.mode??"preload",f=(u,E)=>{if(u.sheet)return Promise.resolve();let a=d.get(u);if(a)return a;let p=new Promise(j=>{let _=()=>{u.removeEventListener("load",_),u.removeEventListener("error",v),j()},v=()=>{$({remote:s,error:new R(b.PRELOAD_FAILED,`failed to load remote stylesheet ${E}`,{remote:s})}),_()};u.addEventListener("load",_,{once:!0}),u.addEventListener("error",v,{once:!0}),u.sheet&&_()});return d.set(u,p),p},y=(u,E)=>{if(typeof document>"u")return Promise.resolve();let a=document.querySelector(`link[href="${u}"]`);if(a)return E==="style"&&c==="preload"?d.get(a)??Promise.resolve():Promise.resolve();let p=document.createElement("link");p.rel=E==="style"?"stylesheet":"modulepreload",p.href=u,c==="prefetch"&&(p.fetchPriority="low");let j=E==="style"?f(p,u):Promise.resolve();return document.head.appendChild(p),E==="style"&&c==="preload"?j:Promise.resolve()},g=u=>{let E=typeof document<"u"?document.baseURI:void 0,a=new URL(h.entry,E||"http://fulgurjs.invalid/");return new URL(u,a).href};try{if(h.manifestUrl){let u=m.get(h.manifestUrl);u||(u=fetch(h.manifestUrl,{cache:"no-cache"}).then(a=>a.ok?a.json():void 0),m.set(h.manifestUrl,u),u.then(a=>{a||m.delete(h.manifestUrl)},()=>m.delete(h.manifestUrl)));let E=await u;if(E){await y(h.entry,"modulepreload");let a=E.exposes,p=Array.isArray(a)?a.filter(v=>v&&typeof v=="object").map(v=>[String(v.name??""),v]):a&&typeof a=="object"?Object.entries(a):[],j=l?p.filter(([v,O])=>F(String(O?.name??v))===l):p,_=[];for(let[,v]of j)if(typeof v?.file=="string"&&await y(g(v.file),"modulepreload"),Array.isArray(v?.css))for(let O of v.css){if(typeof O!="string")continue;let ee=y(g(O),"style");c==="preload"&&_.push(ee)}await Promise.all(_);return}}await y(h.entry,"modulepreload")}catch(u){$({remote:s,error:new R(b.PRELOAD_FAILED,String(u?.message??u),{remote:s})})}}return typeof window>"u"||(window.__FULGURJS_SCOPE__=t,window.__FULGURJS_INFO__={get remotes(){let e={};for(let[i,s]of n)e[i]={...s.debug,entry:s.entry};return e},errors:[]}),{shareScopeMap:t,initSharing:z,registerShare:W,registerRemotes:A,registerRemote:G,registerPlugins:J,loadShare:B,loadRemote:Z,getContainer:Q,preloadRemote:D,parseSpec:U}}var q=globalThis,M=q.__FULGURJS_RUNTIME__??pe();q.__FULGURJS_RUNTIME__=M;try{Object.freeze(M)}catch{}var we=V;function be(){return M}var ve=M.initSharing,_e=M.registerShare,Me=M.registerRemotes,$e=M.registerRemote,je=M.registerPlugins,Te=M.loadShare,Le=M.loadRemote,Oe=M.getContainer,Pe=M.preloadRemote,Ne=M.shareScopeMap;function Ie(t){if(t&&typeof t=="object"&&"default"in t){let n=t.default;return n!==void 0?n:t}return t}var ke=M;export{ke as default,Oe as getContainer,be as getRuntime,ve as initSharing,Le as loadRemote,Te as loadShare,Pe as preloadRemote,je as registerPlugins,$e as registerRemote,Me as registerRemotes,_e as registerShare,M as runtime,Ne as shareScopeMap,Ie as unwrapDefault,we as version};\n';
 
 // src/index.ts
 function readRuntimeCode() {
@@ -1303,6 +1331,29 @@ function injectInitScript(html, scriptSrc) {
   }
   return tag + html;
 }
+var RUNTIME_CHUNK_NAME = "fulgurjs-runtime";
+var REMOTE_FACADE_CHUNK_NAME = "fulgurjs-remote-facades";
+function facadeChunkOf(id) {
+  const bare = id.split("?")[0];
+  if (bare === "virtual:fulgurjs-runtime" || bare === "virtual:fulgurjs-runtime-proxy") {
+    return RUNTIME_CHUNK_NAME;
+  }
+  if (bare.startsWith("virtual:fulgurjs-shared:")) {
+    const body = bare.slice("virtual:fulgurjs-shared:".length);
+    if (body.startsWith("__remote__/")) {
+      const remoteName = body.slice("__remote__/".length).split("/")[0] || "unknown";
+      return REMOTE_FACADE_CHUNK_NAME + "-" + remoteName.replace(/[^A-Za-z0-9_-]/g, "_");
+    }
+    const shareKey = body.split("?")[0];
+    return "fulgurjs-shared-" + (shareKey.replace(/[^A-Za-z0-9_-]/g, "_") || "unknown");
+  }
+  if (bare.startsWith("virtual:fulgurjs-shared-ns:") || bare.startsWith("virtual:fulgurjs-cjs-ns:")) {
+    const prefix = bare.startsWith("virtual:fulgurjs-shared-ns:") ? "virtual:fulgurjs-shared-ns:" : "virtual:fulgurjs-cjs-ns:";
+    const shareKey = bare.slice(prefix.length);
+    return "fulgurjs-shared-" + (shareKey.replace(/[^A-Za-z0-9_-]/g, "_") || "unknown");
+  }
+  return null;
+}
 function federation(options) {
   const warnedUnknownPrefixes = /* @__PURE__ */ new Set();
   let remoteSchemaPromise = null;
@@ -1313,7 +1364,10 @@ function federation(options) {
     exposeFiles: {},
     resolvedSharedPaths: /* @__PURE__ */ new Map(),
     entryAbsPaths: /* @__PURE__ */ new Set(),
-    entryInitInjected: /* @__PURE__ */ new Set()
+    entryInitInjected: /* @__PURE__ */ new Set(),
+    manualChunkGroups: /* @__PURE__ */ new Map(),
+    sharedClosureRoots: [],
+    facadeDynamic: false
   };
   const pre = {
     name: "fulgurjs:core",
@@ -1381,6 +1435,43 @@ export { default } from ${JSON.stringify(url)};
           ;
           extra.build = { target: "es2022" };
         }
+        if (normalized.remotes.length > 0 && normalized.devSharedSelf) {
+          state.facadeDynamic = true;
+          const userOutput = userConfig.build?.rollupOptions?.output;
+          if (Array.isArray(userOutput)) {
+            console.warn(
+              formatFulgurjsDiagnostic({
+                code: "BLD-006",
+                symptom: "build.rollupOptions.output is an array; fulgurjs cannot inject the shared-facade chunk guard automatically",
+                cause: "devSharedSelf \u95E8\u9762\u5316 + manualChunks \u5F3A\u5236\u5206\u7EC4\u53EF\u80FD\u5F62\u6210 chunk \u5FAA\u73AF\u4F9D\u8D56\uFF08\u8FD0\u884C\u65F6 TypeError\uFF1A\u534F\u5546\u51FD\u6570\u672A\u521D\u59CB\u5316\uFF09",
+                fix: `\u5728\u6BCF\u4E2A output \u9879\u7684 manualChunks \u6700\u524D\u9762\u52A0\u5206\u652F\uFF1Aif (id.startsWith('virtual:fulgurjs-')) return 'fulgurjs-shared-facades'`
+              })
+            );
+          } else {
+            const userManualChunks = userOutput?.manualChunks;
+            if (typeof userManualChunks === "function") {
+              const userFn = userManualChunks;
+              const wrapped = (id, meta) => {
+                const facade = facadeChunkOf(id);
+                if (facade) return facade;
+                return userFn(id, meta);
+              };
+              const extraBuild = extra.build ??= {};
+              extraBuild.rollupOptions = { ...extraBuild.rollupOptions ?? {}, output: { manualChunks: wrapped } };
+            } else if (userManualChunks && typeof userManualChunks === "object") {
+              state.manualChunkSpecsPending = Object.entries(userManualChunks).flatMap(
+                ([group, specs]) => specs.map((s) => [group, s])
+              );
+              const wrapped = (id) => {
+                const facade = facadeChunkOf(id);
+                if (facade) return facade;
+                return state.manualChunkGroups.get(id.split("?")[0]) ?? state.manualChunkGroups.get(id);
+              };
+              const extraBuild = extra.build ??= {};
+              extraBuild.rollupOptions = { ...extraBuild.rollupOptions ?? {}, output: { manualChunks: wrapped } };
+            }
+          }
+        }
       }
       for (const w of normalized.warnings) console.warn(`[fulgurjs] ${w}`);
       return extra;
@@ -1422,7 +1513,7 @@ export { default } from ${JSON.stringify(url)};
       const query = q === -1 ? "" : s.slice(q);
       const bareClean = bare.startsWith("\0") ? bare.slice(1) : bare;
       const n = state.normalized;
-      if (n && !bareClean.startsWith("\0") && !bareClean.startsWith(".") && !bareClean.startsWith("/") && !bareClean.startsWith("virtual:")) {
+      if (n && !bare.startsWith("\0") && !bareClean.startsWith(".") && !bareClean.startsWith("/") && !bareClean.startsWith("virtual:")) {
         const slash = bareClean.indexOf("/");
         if (slash > 0) {
           const prefix = bareClean.slice(0, slash);
@@ -1485,7 +1576,7 @@ export { default } from ${JSON.stringify(url)};
             if (!names.includes(compat)) names.push(compat);
           }
         }
-        return genSharedNsFacade(item, serializeShareCallForFacade(item), names);
+        return genSharedNsFacade(item, serializeShareCallForFacade(item), names, state.facadeDynamic);
       }
       if (clean.startsWith("virtual:fulgurjs-shared:") && state.normalized) {
         const body = clean.slice("virtual:fulgurjs-shared:".length);
@@ -1494,14 +1585,14 @@ export { default } from ${JSON.stringify(url)};
           const item2 = state.normalized.shared.find((x) => x.shareKey === body);
           if (item2 && item2.import !== false) {
             const names = /^(\.|\/)/.test(item2.import) ? [] : enumerateCjsExports(item2.import, state.normalized.root);
-            return genSharedFacade(item2.import, names);
+            return genSharedFacade(item2.import, names, state.facadeDynamic);
           }
           return null;
         }
         const entry = getFacadeEntry(raw.slice(f + 3));
         if (!entry) return null;
         if (entry.remoteName && entry.exposeName) {
-          return genRemoteBindingFacade(entry.remoteName + "/" + entry.exposeName, entry.bindings);
+          return genRemoteBindingFacade(entry.remoteName + "/" + entry.exposeName, entry.bindings, state.facadeDynamic);
         }
         const item = state.normalized.shared.find((x) => x.shareKey === entry.shareKey);
         if (!item || item.import === false) return null;
@@ -1514,7 +1605,7 @@ export { default } from ${JSON.stringify(url)};
           "fallback: () => import(" + JSON.stringify(item.import) + ")"
         ];
         const call = "__fulgurjs_loadShare(" + JSON.stringify(item.shareKey) + ", { " + opts.join(", ") + " })";
-        return genBindingFacade(item, entry.bindings, call);
+        return genBindingFacade(item, entry.bindings, call, state.facadeDynamic);
       }
       return null;
     },
@@ -1535,7 +1626,8 @@ ${code}`, map: null };
             options: state.normalized,
             rewriteShared: true,
             allowNodeModules,
-            cjsRequireRewrite: true
+            cjsRequireRewrite: true,
+            sharedClosureRoots: state.sharedClosureRoots
           });
         }
         return null;
@@ -1547,7 +1639,8 @@ ${code}`, map: null };
         // 双角色宿主可显式 devSharedSelf: true 参与协商
         rewriteShared: state.command === "build" || state.normalized.devSharedSelf,
         allowNodeModules,
-        cjsRequireRewrite: state.command === "build"
+        cjsRequireRewrite: state.command === "build",
+        sharedClosureRoots: state.sharedClosureRoots
       });
     },
     transformIndexHtml: {
@@ -1572,6 +1665,68 @@ ${code}`, map: null };
     async buildStart() {
       if (state.command !== "build" || !state.normalized) return;
       const n = state.normalized;
+      if (state.manualChunkSpecsPending) {
+        for (const [group, specifier] of state.manualChunkSpecsPending) {
+          try {
+            const r = await this.resolve(specifier, path5.join(n.root, "index.html"));
+            if (r?.id) {
+              state.manualChunkGroups.set(r.id, group);
+              state.manualChunkGroups.set(r.id.split("?")[0], group);
+            } else {
+              console.warn(
+                `[fulgurjs] manualChunks: could not resolve "${specifier}" for group "${group}"; those modules will fall back to automatic chunking. (Their shared-negotiation facades are still guarded.)`
+              );
+            }
+          } catch {
+            console.warn(
+              `[fulgurjs] manualChunks: resolving "${specifier}" (group "${group}") failed; those modules will fall back to automatic chunking.`
+            );
+          }
+        }
+        state.manualChunkSpecsPending = void 0;
+      }
+      if (n.remotes.length > 0 && n.devSharedSelf && state.sharedClosureRoots.length === 0) {
+        const rootKeys = /* @__PURE__ */ new Map();
+        const pkgRootOf = (file) => {
+          const NM = "/node_modules/";
+          const i = file.lastIndexOf(NM);
+          if (i === -1) return null;
+          const rest = file.slice(i + NM.length);
+          const segs = rest.split("/");
+          const pkgDir = segs[0].startsWith("@") ? segs.slice(0, 2).join("/") : segs[0];
+          return file.slice(0, i + NM.length) + pkgDir + "/";
+        };
+        for (const item of n.shared) {
+          if (item.import === false) continue;
+          const selfFile = await this.resolve(item.import, path5.join(n.root, "index.html")).then(
+            (r) => r?.id?.split("?")[0] ?? null
+          ).catch(() => null);
+          for (const alias of item.aliases) {
+            if (alias.endsWith("/")) continue;
+            let file = null;
+            if (selfFile) {
+              try {
+                const req = createRequire2(selfFile);
+                file = req.resolve(`${alias}/package.json`, { paths: [selfFile] }).replace(/\/package\.json$/, "");
+              } catch {
+                file = null;
+              }
+            }
+            if (!file) {
+              file = await this.resolve(alias, path5.join(n.root, "index.html")).then(
+                (r) => r?.id?.split("?")[0] ?? null
+              ).catch(() => null);
+            }
+            if (!file) continue;
+            const root = pkgRootOf(file);
+            if (!root) continue;
+            let keys = rootKeys.get(root);
+            if (!keys) rootKeys.set(root, keys = /* @__PURE__ */ new Set());
+            keys.add(item.shareKey);
+          }
+        }
+        state.sharedClosureRoots = [...rootKeys.entries()].map(([root, keys]) => ({ root, keys }));
+      }
       if (n.exposes.length > 0) {
         for (const e of n.exposes) {
           const resolved = await this.resolve(e.import, path5.join(n.root, "index.html"));
@@ -1589,33 +1744,50 @@ ${code}`, map: null };
         });
       }
     },
-    async generateBundle(_opts, bundle) {
-      const n = state.normalized;
-      if (state.command !== "build" || !n || n.exposes.length === 0 || !n.manifest) return;
-      const facadeToChunk = {};
-      for (const [fileName, chunk] of Object.entries(bundle)) {
-        if (chunk.type !== "chunk") continue;
-        const facade = chunk.facadeModuleId?.split("?")[0];
-        if (facade) {
-          const viteMeta = chunk.viteMetadata;
-          facadeToChunk[facade] = {
-            file: fileName,
-            css: viteMeta ? [...viteMeta.importedCss ?? []] : []
+    generateBundle: {
+      order: "post",
+      handler(_opts, bundle) {
+        const n = state.normalized;
+        if (state.command !== "build" || !n || n.exposes.length === 0 || !n.manifest) return;
+        const collectStaticCss = (entryFile) => {
+          const visited = /* @__PURE__ */ new Set();
+          const cssFiles = /* @__PURE__ */ new Set();
+          const visit = (fileName) => {
+            if (visited.has(fileName)) return;
+            visited.add(fileName);
+            const chunk = bundle[fileName];
+            if (!chunk || chunk.type !== "chunk") return;
+            const viteMeta = chunk.viteMetadata;
+            for (const css of viteMeta?.importedCss ?? []) cssFiles.add(css);
+            for (const importedFile of chunk.imports) visit(importedFile);
           };
+          visit(entryFile);
+          return [...cssFiles];
+        };
+        const facadeToChunk = {};
+        for (const [fileName, chunk] of Object.entries(bundle)) {
+          if (chunk.type !== "chunk") continue;
+          const facade = chunk.facadeModuleId?.split("?")[0];
+          if (facade) {
+            facadeToChunk[facade] = {
+              file: fileName,
+              css: collectStaticCss(fileName)
+            };
+          }
         }
+        for (const e of n.exposes) {
+          const abs = state.exposeAbsPaths[e.import];
+          const hit = abs ? facadeToChunk[abs] : void 0;
+          if (hit) state.exposeFiles[e.name] = hit;
+        }
+        const entryChunkName = Object.keys(bundle).find((k) => bundle[k].type === "chunk" && k === n.filename);
+        const manifest = genProdManifest(n, state.exposeFiles, entryChunkName ?? n.filename);
+        this.emitFile({
+          type: "asset",
+          fileName: "fulgurjs-manifest.json",
+          source: JSON.stringify(manifest, null, 2)
+        });
       }
-      for (const e of n.exposes) {
-        const abs = state.exposeAbsPaths[e.import];
-        const hit = abs ? facadeToChunk[abs] : void 0;
-        if (hit) state.exposeFiles[e.name] = hit;
-      }
-      const entryChunkName = Object.keys(bundle).find((k) => bundle[k].type === "chunk" && k === n.filename);
-      const manifest = genProdManifest(n, state.exposeFiles, entryChunkName ?? n.filename);
-      this.emitFile({
-        type: "asset",
-        fileName: "fulgurjs-manifest.json",
-        source: JSON.stringify(manifest, null, 2)
-      });
     },
     configureServer(server) {
       const n = state.normalized;
@@ -1701,13 +1873,26 @@ ${code}`, map: null };
       if (state.command === "serve" && code.includes("virtual:fulgurjs-runtime") && !code.includes("virtual:fulgurjs-runtime-proxy") && isExposeTargetFile(clean, state.normalized.root, state.normalized.exposes)) {
         return { code: code.split("virtual:fulgurjs-runtime").join("virtual:fulgurjs-runtime-proxy"), map: null };
       }
-      if (isPluginProcessedModule(code)) return null;
-      if (state.command === "build" && !/\.vue(\?|$)/.test(id)) return null;
+      if (state.command === "serve" && isPluginProcessedModule(code)) return null;
       if (/type=(style|template)/.test(id)) return null;
       const isJsLike = /\.(m|c)?[jt]sx?$/.test(clean) || clean.endsWith(".vue");
       if (!isJsLike) return null;
       const devRewriteAll = state.command === "serve" && state.normalized.devSharedSelf;
-      if (clean.includes("node_modules") && !id.includes(".vite/deps") && !devRewriteAll) return null;
+      const isPureRemoteBuild = state.normalized.exposes.length > 0 && state.normalized.remotes.length === 0;
+      if (state.command === "serve" && clean.includes("node_modules") && !id.includes(".vite/deps") && !devRewriteAll) {
+        return null;
+      }
+      if (state.command === "build" && !/\.vue(\?|$)/.test(id)) {
+        const quickCheck = /require\s*\(\s*["']|(?:from|import)\s*["']/.test(code);
+        if (!quickCheck) return null;
+        const allowNodeModules = isPureRemoteBuild;
+        return transformModule(code, id, {
+          options: state.normalized,
+          rewriteShared: true,
+          allowNodeModules,
+          sharedClosureRoots: state.sharedClosureRoots
+        });
+      }
       const rewriteShared = state.command === "build" || state.normalized.devSharedSelf;
       const remapSpecifier = (spec) => {
         if (state.normalized.shared.some((s) => s.aliases.includes(spec))) return spec;
@@ -1721,7 +1906,14 @@ ${code}`, map: null };
         if (!cleanPath.startsWith("/")) return null;
         return state.resolvedSharedPaths.get(cleanPath) ?? null;
       };
-      return transformModule(code, id, { options: state.normalized, remapSpecifier, rewriteShared });
+      const __r = await transformModule(code, id, {
+        options: state.normalized,
+        remapSpecifier,
+        rewriteShared,
+        allowNodeModules: state.command === "build" ? isPureRemoteBuild || state.normalized.devSharedSelf : void 0,
+        sharedClosureRoots: state.sharedClosureRoots
+      });
+      return __r;
     }
   };
   function warmResolvedSharedPaths(server) {