@fulgurjs/federation 6.11.6 → 6.12.0

package/dist/bridge-session-auto.cjs

@@ -0,0 +1,121 @@
+"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/bridge-session-auto.ts
+var bridge_session_auto_exports = {};
+__export(bridge_session_auto_exports, {
+  createAutomaticBridgeSession: () => createAutomaticBridgeSession
+});
+module.exports = __toCommonJS(bridge_session_auto_exports);
+var import_vue = require("vue");
+
+// src/context.ts
+var APP_CONTEXT_STORAGE_KEY = "__FULGURJS_APP_CONFIG__";
+function clearAppContext() {
+  const g = globalThis;
+  delete g[APP_CONTEXT_STORAGE_KEY];
+  try {
+    g.__FULGURJS_RUNTIME__?.clearSessionState?.();
+  } catch {
+  }
+}
+
+// src/bridge-session-auto.ts
+var PAGE_RECORDS = /* @__PURE__ */ Symbol.for("@fulgurjs/federation/automatic-sessions");
+var sessions = /* @__PURE__ */ new WeakMap();
+function records() {
+  const page = globalThis;
+  return page[PAGE_RECORDS] ??= /* @__PURE__ */ new Map();
+}
+function normalize(value) {
+  if (value === null || value === void 0) return value;
+  if (typeof value !== "string" && typeof value !== "number" || typeof value === "number" && !Number.isFinite(value) || !String(value).trim()) {
+    throw new TypeError("session \u5FC5\u987B\u540C\u6B65\u8FD4\u56DE\u975E\u7A7A\u7528\u6237\u6807\u8BC6\uFF08string/number\uFF09\u3001null\uFF08\u5DF2\u9000\u51FA\uFF09\u6216 undefined\uFF08\u8EAB\u4EFD\u521D\u59CB\u5316\u4E2D\uFF09\uFF1B\u4E0D\u8981\u8FD4\u56DE token\u3001\u5BF9\u8C61\u6216 Promise\u3002");
+  }
+  return String(value);
+}
+function createAutomaticBridgeSession(getIdentity, namespace) {
+  const key = `${namespace}:auto`;
+  const cached = sessions.get(getIdentity)?.get(key);
+  if (cached) return cached;
+  const sessionKey = (0, import_vue.ref)(null);
+  const error = (0, import_vue.shallowRef)();
+  const state = { sessionKey, error };
+  const entries = sessions.get(getIdentity) ?? /* @__PURE__ */ new Map();
+  entries.set(key, state);
+  sessions.set(getIdentity, entries);
+  const read = () => {
+    const memory = records().get(key);
+    if (memory) return memory;
+    try {
+      const saved = JSON.parse(sessionStorage.getItem(key) ?? "null");
+      if (saved && typeof saved === "object" && "identity" in saved && "sessionKey" in saved && typeof saved.identity === "string" && typeof saved.sessionKey === "string" && saved.sessionKey) {
+        const record = { identity: saved.identity, sessionKey: saved.sessionKey };
+        records().set(key, record);
+        return record;
+      }
+    } catch {
+    }
+  };
+  const save = (record) => {
+    if (record) records().set(key, record);
+    else records().delete(key);
+    try {
+      if (record) sessionStorage.setItem(key, JSON.stringify(record));
+      else sessionStorage.removeItem(key);
+    } catch {
+    }
+  };
+  const clearOwnedContext = (record) => {
+    const context = globalThis.__FULGURJS_APP_CONFIG__;
+    if (record && context?.sessionKey === record.sessionKey) clearAppContext();
+  };
+  (0, import_vue.effectScope)(true).run(() => (0, import_vue.watch)(() => {
+    try {
+      return { identity: normalize(getIdentity()), error: void 0 };
+    } catch (cause) {
+      return { identity: void 0, error: cause ?? new Error("session getter \u629B\u51FA\u4E86\u7A7A\u9519\u8BEF\u503C\u3002") };
+    }
+  }, (snapshot) => {
+    const saved = read();
+    error.value = snapshot.error;
+    if (snapshot.identity === void 0) {
+      sessionKey.value = null;
+      clearOwnedContext(saved);
+      return;
+    }
+    if (snapshot.identity === null) {
+      save(void 0);
+      sessionKey.value = null;
+      clearOwnedContext(saved);
+      return;
+    }
+    const record = saved?.identity === snapshot.identity ? saved : {
+      identity: snapshot.identity,
+      sessionKey: `s-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`
+    };
+    if (record !== saved) save(record);
+    sessionKey.value = record.sessionKey;
+  }, { immediate: true, flush: "sync" }));
+  return state;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createAutomaticBridgeSession
+});

package/dist/bridge-session-auto.d.cts

@@ -0,0 +1,21 @@
+import { Ref, ShallowRef } from 'vue';
+
+/**
+ * @author Jason.chen
+ * Vue 桥接的自动登录代次。调用方只提供响应式的业务身份，生成、恢复、换号和登出由插件管理。
+ *
+ * 不观察 token：同一用户的 token 轮换不应重挂。身份只能是非敏感业务标识，不能传凭据。
+ * 同页多个远程共用一个命名空间的记录；存储不可用时仍通过页面镜像保持相同代次。
+ * 观察器按身份getter/命名空间复用，生命周期属于宿主页面而非远程视图：离开远程页后登出
+ * 也必须清理上下文。业务应提供稳定的store getter，不捕获只在已卸载组件中更新的局部状态。
+ */
+
+type BridgeSessionIdentity = string | number | null | undefined;
+interface AutomaticSession {
+    sessionKey: Ref<string | null>;
+    error: ShallowRef<unknown>;
+}
+/** 内部使用；不增加公共导入入口，不要求应用新建 session.ts。 */
+declare function createAutomaticBridgeSession(getIdentity: () => BridgeSessionIdentity, namespace: string): AutomaticSession;
+
+export { type BridgeSessionIdentity, createAutomaticBridgeSession };

package/dist/bridge-session-auto.d.ts

@@ -0,0 +1,21 @@
+import { Ref, ShallowRef } from 'vue';
+
+/**
+ * @author Jason.chen
+ * Vue 桥接的自动登录代次。调用方只提供响应式的业务身份，生成、恢复、换号和登出由插件管理。
+ *
+ * 不观察 token：同一用户的 token 轮换不应重挂。身份只能是非敏感业务标识，不能传凭据。
+ * 同页多个远程共用一个命名空间的记录；存储不可用时仍通过页面镜像保持相同代次。
+ * 观察器按身份getter/命名空间复用，生命周期属于宿主页面而非远程视图：离开远程页后登出
+ * 也必须清理上下文。业务应提供稳定的store getter，不捕获只在已卸载组件中更新的局部状态。
+ */
+
+type BridgeSessionIdentity = string | number | null | undefined;
+interface AutomaticSession {
+    sessionKey: Ref<string | null>;
+    error: ShallowRef<unknown>;
+}
+/** 内部使用；不增加公共导入入口，不要求应用新建 session.ts。 */
+declare function createAutomaticBridgeSession(getIdentity: () => BridgeSessionIdentity, namespace: string): AutomaticSession;
+
+export { type BridgeSessionIdentity, createAutomaticBridgeSession };

package/dist/bridge-session-auto.js

@@ -0,0 +1,88 @@
+import {
+  clearAppContext
+} from "./chunk-TSYLDY6H.js";
+import "./chunk-OF2JCXTZ.js";
+
+// src/bridge-session-auto.ts
+import { effectScope, ref, shallowRef, watch } from "vue";
+var PAGE_RECORDS = /* @__PURE__ */ Symbol.for("@fulgurjs/federation/automatic-sessions");
+var sessions = /* @__PURE__ */ new WeakMap();
+function records() {
+  const page = globalThis;
+  return page[PAGE_RECORDS] ??= /* @__PURE__ */ new Map();
+}
+function normalize(value) {
+  if (value === null || value === void 0) return value;
+  if (typeof value !== "string" && typeof value !== "number" || typeof value === "number" && !Number.isFinite(value) || !String(value).trim()) {
+    throw new TypeError("session \u5FC5\u987B\u540C\u6B65\u8FD4\u56DE\u975E\u7A7A\u7528\u6237\u6807\u8BC6\uFF08string/number\uFF09\u3001null\uFF08\u5DF2\u9000\u51FA\uFF09\u6216 undefined\uFF08\u8EAB\u4EFD\u521D\u59CB\u5316\u4E2D\uFF09\uFF1B\u4E0D\u8981\u8FD4\u56DE token\u3001\u5BF9\u8C61\u6216 Promise\u3002");
+  }
+  return String(value);
+}
+function createAutomaticBridgeSession(getIdentity, namespace) {
+  const key = `${namespace}:auto`;
+  const cached = sessions.get(getIdentity)?.get(key);
+  if (cached) return cached;
+  const sessionKey = ref(null);
+  const error = shallowRef();
+  const state = { sessionKey, error };
+  const entries = sessions.get(getIdentity) ?? /* @__PURE__ */ new Map();
+  entries.set(key, state);
+  sessions.set(getIdentity, entries);
+  const read = () => {
+    const memory = records().get(key);
+    if (memory) return memory;
+    try {
+      const saved = JSON.parse(sessionStorage.getItem(key) ?? "null");
+      if (saved && typeof saved === "object" && "identity" in saved && "sessionKey" in saved && typeof saved.identity === "string" && typeof saved.sessionKey === "string" && saved.sessionKey) {
+        const record = { identity: saved.identity, sessionKey: saved.sessionKey };
+        records().set(key, record);
+        return record;
+      }
+    } catch {
+    }
+  };
+  const save = (record) => {
+    if (record) records().set(key, record);
+    else records().delete(key);
+    try {
+      if (record) sessionStorage.setItem(key, JSON.stringify(record));
+      else sessionStorage.removeItem(key);
+    } catch {
+    }
+  };
+  const clearOwnedContext = (record) => {
+    const context = globalThis.__FULGURJS_APP_CONFIG__;
+    if (record && context?.sessionKey === record.sessionKey) clearAppContext();
+  };
+  effectScope(true).run(() => watch(() => {
+    try {
+      return { identity: normalize(getIdentity()), error: void 0 };
+    } catch (cause) {
+      return { identity: void 0, error: cause ?? new Error("session getter \u629B\u51FA\u4E86\u7A7A\u9519\u8BEF\u503C\u3002") };
+    }
+  }, (snapshot) => {
+    const saved = read();
+    error.value = snapshot.error;
+    if (snapshot.identity === void 0) {
+      sessionKey.value = null;
+      clearOwnedContext(saved);
+      return;
+    }
+    if (snapshot.identity === null) {
+      save(void 0);
+      sessionKey.value = null;
+      clearOwnedContext(saved);
+      return;
+    }
+    const record = saved?.identity === snapshot.identity ? saved : {
+      identity: snapshot.identity,
+      sessionKey: `s-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`
+    };
+    if (record !== saved) save(record);
+    sessionKey.value = record.sessionKey;
+  }, { immediate: true, flush: "sync" }));
+  return state;
+}
+export {
+  createAutomaticBridgeSession
+};

package/dist/{chunk-HDRZBSND.js → chunk-2MWIIRQZ.js}

@@ -37,7 +37,7 @@ function releaseBridgeSession(sessionKey) {
   if (n <= 1) activeBridgeSessions.delete(sessionKey);
   else activeBridgeSessions.set(sessionKey, n - 1);
 }
-function resolveBridgeContext(spec, controlled, getContext) {
+function resolveBridgeContext(spec, controlled, getContext, managedSession = false) {
   if (getContext) {
     let snapshot;
     try {
@@ -48,6 +48,9 @@ function resolveBridgeContext(spec, controlled, getContext) {
     if (snapshot === null || typeof snapshot !== "object" || typeof snapshot.then === "function") {
       throw bridgeLifecycleError("getContext", spec, describeContextValue(snapshot));
     }
+    if (managedSession && controlled !== void 0 && snapshot.sessionKey === void 0) {
+      snapshot = { ...snapshot, sessionKey: controlled };
+    }
     if (controlled !== void 0 && snapshot.sessionKey !== controlled) {
       throw bridgeSessionMismatchError(spec, controlled, snapshot.sessionKey, { reason: "getter-snapshot" });
     }

package/dist/cli.js

@@ -1804,6 +1804,26 @@ async function validateSource(file, source) {
   const loader = /\.tsx$/.test(file) ? "tsx" : /\.jsx$/.test(file) ? "jsx" : /\.[cm]?ts$/.test(file) ? "ts" : "js";
   await transform(source, { loader, sourcefile: file, format: "esm", target: "es2022", logLevel: "silent" });
 }
+async function describeStartup(entry, application, source, framework) {
+  const { transform } = requireHere("esbuild");
+  const loader = /\.[jt]sx$/.test(entry) ? "tsx" : "ts";
+  const output = await transform(source, { loader, sourcefile: entry, format: "esm", target: "es2022", logLevel: "silent" });
+  await init;
+  const [items] = parse(output.code);
+  return {
+    entry,
+    application,
+    imports: [...new Set(items.flatMap((item) => item.n ? [item.n] : []))],
+    steps: [
+      `\u53EA\u8BFB\u53D6 ${entry} \u4E0E\u4E0B\u5217\u5B9E\u9645\u5BFC\u5165\u7684\u88C5\u914D\u6A21\u5757\uFF0C\u5148\u4FDD\u7559\u539F\u6709\u8C03\u7528\u987A\u5E8F\u3001\u6837\u5F0F\u3001\u6743\u9650\u4E0E\u63D2\u4EF6\uFF1B\u4E0D\u6574\u6539\u5168\u4E1A\u52A1 TS\u3002`,
+      `\u5728 ${application} \u9ED8\u8BA4\u5BFC\u51FA defineApplication \u5DE5\u5382\uFF1B\u5C06\u539F\u542F\u52A8\u51FD\u6570\u7684\u88C5\u914D\u642C\u5165\uFF0CApp/router/store \u6309\u5F53\u524D\u5B9E\u4F8B\u521B\u5EFA\uFF0C\u4E0D\u53E6\u5EFA bridge \u8F6C\u53D1\u58F3\u3002`,
+      framework === "vue" ? "\u6309\u5DE5\u5382 mode \u9009\u62E9 memory/web history\uFF0C\u5B88\u536B\u5728\u8FD4\u56DE\u524D\u5B89\u88C5\uFF0C\u8FD4\u56DE { app, router }\uFF0C\u79FB\u9664\u5DE5\u5382\u5185 app.mount/app.use(router)\uFF1B\u4F7F\u7528 URL \u540C\u6B65\u65F6\u58F0\u660E { routing: true }\u3002" : "\u5DE5\u5382\u8FD4\u56DE JSX \u6216 { element, dispose }\uFF0C\u4FDD\u7559\u539F Provider\uFF1B\u72EC\u7ACB\u8FD0\u884C\u4F7F\u7528 browser router\uFF0C\u6865\u63A5\u4F7F\u7528\u53D7\u63A7 memory router\u3002",
+      `\u5C06 ${entry} \u7CBE\u7B80\u4E3A\u5BFC\u5165\u8BE5\u5DE5\u5382\u5E76\u8C03\u7528 application.start(\u539F\u6302\u8F7D\u9009\u62E9\u5668)\uFF1B\u5148\u786E\u8BA4\u539F\u88C5\u914D\u5B8C\u6574\u8FC1\u5165\uFF0C\u518D\u5220\u9664\u65E7\u542F\u52A8\u4F53\u3002`,
+      `\u91CD\u65B0\u6267\u884C\u539F\u8BA1\u5212\u5E76\u8FFD\u52A0 --application ${application}\uFF1B\u5DF2\u6709\u914D\u7F6E\u4E0D\u8986\u76D6\uFF0C\u6838\u5BF9 ./bridge \u662F\u5426\u76F4\u63A5\u6307\u5411\u8FD9\u4E00\u4E2A\u6587\u4EF6\u3002`,
+      "\u6309\u201C\u5DF2\u6709\u5B8C\u6574\u5E94\u7528\u9996\u6B21\u63A5\u5165\u201D\u6307\u5357\u4F9D\u6B21\u786E\u8BA4\u72EC\u7ACB\u542F\u52A8\u3001\u6865\u63A5\u9996\u5C4F\u3001\u771F\u5B9E\u6570\u636E\u3001\u5BFC\u822A\u3001\u91CD\u8FDB\uFF1B\u9996\u6B21\u63A5\u901A\u4E0E\u751F\u4EA7\u4EA4\u4ED8\u5206\u5F00\u8BB0\u5F55\uFF0C\u4E0D\u80FD\u628A\u6784\u5EFA\u5F53\u9875\u9762\u901A\u8FC7\u3002"
+    ]
+  };
+}
 function rejectSymlink(file, label) {
   try {
     if (fs2.lstatSync(file).isSymbolicLink()) throw new Error(`\u4E0D\u6539\u5199\u7B26\u53F7\u94FE\u63A5\uFF1A${label}`);
@@ -2011,7 +2031,7 @@ import fulgurjsConfig from './fulgurjs.config'
   await validateSource(file, result);
   return result;
 }
-async function applicationFromEntry(file, source, framework) {
+async function applicationFromEntry(file, source, framework, appFile) {
   await validateSource(file, source);
   await init;
   const header2 = source.match(/^\s*(?:(?:\/\/[^\n]*(?:\n|$)|\/\*[\s\S]*?\*\/)\s*)*/)?.[0] ?? "";
@@ -2033,7 +2053,14 @@ async function applicationFromEntry(file, source, framework) {
     const spec = items[0].n;
     if (/router|pinia|vuex|redux|zustand/i.test(spec)) throw new Error("\u5165\u53E3\u4F9D\u8D56\u4E1A\u52A1\u8DEF\u7531\u6216\u72B6\u6001\uFF1B\u6309 existing-apps \u6307\u5357\u5C06\u5B83\u4EEC\u5728\u5DE5\u5382\u5185\u6309\u5B9E\u4F8B\u521B\u5EFA\uFF0C\u4E0D\u81EA\u52A8\u6539\u5199");
     importStatements.push({ spec, code: statement });
-    if (spec !== "react-dom/client") declarations.push(statement);
+    if (spec !== "react-dom/client") {
+      const edit = new MagicString(statement);
+      if (spec.startsWith(".")) {
+        const rebased = path2.posix.relative(path2.posix.dirname(appFile), path2.posix.join(path2.posix.dirname(file), spec));
+        edit.overwrite(items[0].s, items[0].e, rebased.startsWith(".") ? rebased : "./" + rebased);
+      }
+      declarations.push(edit.toString());
+    }
     body = body.slice(match[0].length);
   }
   body = body.trim();
@@ -2061,9 +2088,10 @@ import { defineApplication } from '@fulgurjs/federation/${framework}'
 
 export default defineApplication(() => ${expression})
 `;
+  const relativeApp = path2.posix.relative(path2.posix.dirname(file), appFile).replace(/\.tsx?$/, "");
   const main2 = `${OWNER}
-${header2}// \u72EC\u7ACB\u5165\u53E3\u4F7F\u7528\u540C\u4E00\u4EFD\u88C5\u914D\uFF1B\u5BBF\u4E3B\u76F4\u63A5\u52A0\u8F7D application \u7684\u9ED8\u8BA4\u5BFC\u51FA\uFF0C\u4E0D\u590D\u5236\u542F\u52A8\u903B\u8F91\u3002
-import application from './application'
+${header2}// \u72EC\u7ACB\u5165\u53E3\u53EA\u8D1F\u8D23\u542F\u52A8\uFF1B\u72EC\u7ACB\u4E0E\u5D4C\u5165\u8FD0\u884C\u5171\u7528 fulgurjs/exposes/ \u4E2D\u7684\u540C\u4E00\u4EFD\u88C5\u914D\u3002
+import application from '${relativeApp.startsWith(".") ? relativeApp : "./" + relativeApp}'
 void application.start(${JSON.stringify(target)}).catch(console.error)
 `;
   await validateSource(framework === "react" ? "application.tsx" : "application.ts", application);
@@ -2121,26 +2149,37 @@ async function planIntegration(input) {
   }
   const appExt = framework === "react" ? "tsx" : "ts";
   let exposes = input.exposes ?? {};
+  if (input.application && (plan.kind !== "app" || plan.role === "consumer")) task("--application", "\u4EC5\u7528\u4E8E --kind app \u4E14\u89D2\u8272\u4E3A provider/dual\uFF1B\u7EAF\u5BBF\u4E3B\u4E0D\u9700\u8981\u66B4\u9732\u5E94\u7528\u88C5\u914D\u3002");
   if (plan.kind === "app" && plan.role !== "consumer") {
-    const appFile = `src/application.${appExt}`;
+    const appFile = input.application ? safe(input.application) : `src/fulgurjs/exposes/application.${appExt}`;
     const existing = read(appFile);
     if (existing) {
-      if (!existing.startsWith(OWNER) && !/export\s+default\s+defineApplication(?:<[^;]+?>)?\s*\(/.test(existing)) task(appFile, "\u5DF2\u6709\u5E94\u7528\u88C5\u914D\u6587\u4EF6\uFF0C\u65E0\u6CD5\u786E\u8BA4\u9ED8\u8BA4\u5BFC\u51FA\u7684 defineApplication\uFF1B\u4FDD\u7559\u539F\u4EE3\u7801\uFF0C\u5148\u6309\u6307\u5357\u6838\u5B9E\u88C5\u914D");
-      else {
+      try {
+        await validateSource(appFile, existing);
+        if (!/export\s+default\s+defineApplication(?:<[^;]+?>)?\s*\(/.test(existing)) throw new Error("\u65E0\u6CD5\u786E\u8BA4\u9ED8\u8BA4\u5BFC\u51FA\u7684 defineApplication \u5DE5\u5382\uFF1B\u4E0D\u6267\u884C\u4E1A\u52A1\u6A21\u5757\uFF0C\u4E0D\u6309\u6587\u4EF6\u540D\u731C\u5951\u7EA6");
         exposes = { ...exposes, "./bridge": "./" + appFile };
-        plan.evidence.push(`${appFile}\uFF1A\u4FDD\u7559\u5DF2\u751F\u6210\u88C5\u914D`);
+        plan.evidence.push(`${appFile}\uFF1A\u590D\u7528\u5DF2\u6709\u7EDF\u4E00\u88C5\u914D\uFF0C\u4FDD\u7559\u539F\u5185\u5BB9\uFF0C\u4E0D\u751F\u6210\u8F6C\u53D1\u58F3`);
+        task(input.entry ?? "src/main.ts(x)", `\u6838\u5BF9\u72EC\u7ACB\u5165\u53E3\u53EA\u8C03\u7528 ${appFile} \u7684 application.start\uFF1B--application \u4E0D\u5220\u9664\u6216\u8986\u76D6\u539F\u4E1A\u52A1\u542F\u52A8\u4F53\u3002`, false);
+      } catch (error) {
+        task(appFile, String(error.message));
       }
+    } else if (input.application) {
+      task(appFile, "--application \u5FC5\u987B\u6307\u5411\u5B9E\u9645\u5B58\u5728\u7684\u88C5\u914D\u6587\u4EF6\uFF1B\u5148\u6309\u6574\u7406\u6E05\u5355\u8FC1\u5165\u539F\u542F\u52A8\u903B\u8F91\uFF0C\u4E0D\u751F\u6210\u5047\u4E1A\u52A1\u5DE5\u5382\u3002");
     } else {
       const candidates = input.entry ? [safe(input.entry)] : [`src/main.${framework === "react" ? "tsx" : "ts"}`, `src/main.${framework === "react" ? "jsx" : "js"}`].filter((f) => read(f) !== null);
       if (candidates.length !== 1 || read(candidates[0]) === null) task("src/main", "\u65E0\u6CD5\u5B9A\u4F4D\u552F\u4E00\u542F\u52A8\u5165\u53E3\uFF0C\u8BF7\u663E\u5F0F\u6307\u5B9A --entry <\u5F53\u524D\u5E94\u7528\u5185\u8DEF\u5F84>");
       else {
         try {
-          const entry = candidates[0], result = await applicationFromEntry(entry, read(entry), framework);
+          const entry = candidates[0], result = await applicationFromEntry(entry, read(entry), framework, appFile);
           add(appFile, result.application, "\u5C06\u53EF\u8BC1\u660E\u7684\u6700\u5C0F\u542F\u52A8\u903B\u8F91\u63D0\u53D6\u4E3A\u72EC\u7ACB/\u6865\u63A5\u5171\u7528\u5DE5\u5382");
           add(entry, result.main, "\u72EC\u7ACB\u5165\u53E3\u6539\u4E3A application.start\uFF1B\u6302\u8F7D\u8D23\u4EFB\u4EA4\u7ED9\u63D2\u4EF6", true);
           exposes = { ...exposes, "./bridge": "./" + appFile };
         } catch (error) {
-          task(candidates[0], `${error.message}\u3002\u53C2\u8003 docs/zh/guide/existing-apps.md\uFF1B\u6865\u63A5\u8DEF\u7531\u5FC5\u987B\u4F7F\u7528\u53D7\u63A7 memory\uFF0C\u72EC\u7ACB\u6A21\u5F0F\u7EE7\u7EED web history\u3002`);
+          try {
+            plan.startup = await describeStartup(candidates[0], appFile, read(candidates[0]), framework);
+          } catch {
+          }
+          task(candidates[0], `${error.message}\u3002\u5B8C\u6574\u8DEF\u5F84\u89C1 docs/zh/guide/first-integration.md\uFF1B\u4E0B\u65B9\u9010\u6B65\u6574\u7406\u6E05\u5355\u53EA\u8FC1\u79FB\u63A5\u7EBF\uFF0C\u4E0D\u8981\u6C42\u5168\u9879\u76EE TS \u6E05\u96F6\u3002`);
         }
       }
     }
@@ -2186,7 +2225,7 @@ export default ${JSON.stringify(body, null, 2)} satisfies FederationOptions
   }
   if (plan.kind === "app" && plan.role !== "provider") {
     const remote = remoteEntries[0]?.[0];
-    if (remote) add(`src/fulgurjs/RemoteApplication.${framework === "react" ? "tsx" : "vue"}`, hostView(framework, remote), "\u751F\u6210\u53EF\u653E\u8FDB\u5DF2\u6709\u8DEF\u7531\u7684\u6302\u8F7D\u89C6\u56FE\uFF1B\u8DEF\u7531\u548C\u767B\u5F55\u4E0A\u4E0B\u6587\u7531\u5E94\u7528\u660E\u786E\u51B3\u5B9A");
+    if (remote) add(`src/fulgurjs/host/RemoteApplication.${framework === "react" ? "tsx" : "vue"}`, hostView(framework, remote), "\u5728 host/ \u96C6\u4E2D\u751F\u6210\u6302\u8F7D\u89C6\u56FE\uFF1B\u8DEF\u7531\u548C\u767B\u5F55\u4E0A\u4E0B\u6587\u7531\u5E94\u7528\u660E\u786E\u51B3\u5B9A");
     task("\u5BBF\u4E3B\u8DEF\u7531", "\u5C06 RemoteApplication \u89C6\u56FE\u52A0\u5165\u5DF2\u6709\u9875\u9762/\u8DEF\u7531\u3002\u542F\u7528 URL \u540C\u6B65\u65F6\uFF0C\u6309\u6307\u5357\u7ED1\u5B9A\u5BBF\u4E3B\u5BFC\u822A\u7AEF\u53E3\u4E0E\u4E00\u4E2A\u9759\u6001\u6302\u8F7D\u524D\u7F00\uFF1B\u4E0D\u91CD\u590D\u767B\u8BB0\u5B50\u5E94\u7528\u83DC\u5355\u3002", false);
     task("\u4F1A\u8BDD\u4E0E\u4E1A\u52A1\u4E0A\u4E0B\u6587", "\u6709\u767B\u5F55\u9700\u6C42\u65F6\u660E\u786E token getter/sessionKey\u3001\u6743\u9650\u4E0E\u4E3B\u9898\u5F52\u5C5E\uFF1B\u6CA1\u6709\u9700\u6C42\u4E0D\u589E\u52A0\u6587\u4EF6\u3002\u5DE5\u5177\u4E0D\u731C\u51ED\u636E\uFF0C\u4E5F\u4E0D\u590D\u5236\u6574\u4E2A\u4E1A\u52A1 app \u7684\u72B6\u6001\u3002", false);
   } else if (plan.role !== "provider") {
@@ -2301,6 +2340,15 @@ function rollbackIntegration(cwd) {
 }
 function formatIntegrationPlan(plan) {
   const lines = ["[fulgurjs:init] \u63A5\u5165\u9884\u89C8\uFF08\u9ED8\u8BA4\u4E0D\u5199\u5165\u3001\u4E0D\u5B89\u88C5\u4F9D\u8D56\u3001\u4E0D\u6267\u884C\u4E1A\u52A1\u4EE3\u7801\uFF09", ...plan.evidence];
+  if (plan.startup) {
+    lines.push(
+      `
+\u542F\u52A8\u903B\u8F91\u6574\u7406\uFF1A${plan.startup.entry} \u2192 ${plan.startup.application}`,
+      "\u5165\u53E3\u5B9E\u9645\u5BFC\u5165\uFF08\u4E0D\u4EE3\u8868\u8FD9\u4E9B\u4F9D\u8D56\u90FD\u5E94 shared\uFF09\uFF1A",
+      ...plan.startup.imports.map((item) => `  ${item}`),
+      ...plan.startup.steps.map((step, index) => `${index + 1}. ${step}`)
+    );
+  }
   for (const edit of plan.edits) {
     lines.push(`
 --- ${edit.before === null ? "/dev/null" : edit.file}
@@ -3139,7 +3187,7 @@ var RUNTIME_VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    RUNTIME_VERSION = "6.11.6";
+    RUNTIME_VERSION = "6.12.0";
   }
 });
 
@@ -5892,9 +5940,12 @@ var HELP = `fulgurjs \u2014 Vite Module Federation CLI (@fulgurjs/federation)
 \u5DF2\u6709\u9879\u76EE\uFF08\u5355\u9879\u76EE fulgurjs.config.ts \u5728\u5E94\u7528\u6839\u76EE\u5F55\uFF1B\u547D\u4EE4\u9ED8\u8BA4\u8BFB ./fulgurjs.config.ts\uFF09\uFF1A
   fulgurjs init --plan [--kind component|app] [--role consumer|provider|dual]
                 [--remote \u540D\u79F0=http://\u5F00\u53D1\u5730\u5740] [--expose ./\u952E=./\u6E90\u6587\u4EF6]
-                [--name \u5BB9\u5668\u540D] [--entry src/main.ts] [--framework vue|react] [--json]
+                [--name \u5BB9\u5668\u540D] [--entry src/main.ts] [--application src/fulgurjs/exposes/application.ts]
+                [--framework vue|react] [--json]
                                                  \u53EA\u626B\u63CF\u5E76\u9884\u89C8\u5B8C\u6574\u5DEE\u5F02\u4E0E\u4EBA\u5DE5\u5F85\u529E\uFF1B\u53EF\u91CD\u590D remote/expose\u3002
                                                  --kind \u9ED8\u8BA4 component\uFF1Bapp \u652F\u6301\u7B80\u5355\u5165\u53E3\u63D0\u53D6\u4E0E\u5BBF\u4E3B\u89C6\u56FE\u3002
+                                                 \u5DF2\u6709\u590D\u6742\u88C5\u914D\u7528 --application \u590D\u7528\u771F\u5B9E\u9ED8\u8BA4\u5BFC\u51FA\uFF1B
+                                                 \u65E0\u6CD5\u81EA\u52A8\u63D0\u53D6\u65F6\u8F93\u51FA\u5F53\u524D\u5165\u53E3\u5BFC\u5165\u4E0E\u9010\u6B65\u6574\u7406\u6E05\u5355\uFF0C\u4E0D\u731C\u4E1A\u52A1\u3002
                                                  --write \u663E\u5F0F\u5E94\u7528\uFF1B\u963B\u65AD\u9879\u5B58\u5728\u65F6\u6574\u6279\u4E0D\u5199\uFF0C\u4E0D\u8986\u76D6\u5DF2\u6709\u914D\u7F6E\u3002
   fulgurjs init --rollback                         \u6062\u590D\u88AB\u4E2D\u65AD\u7684\u8BA1\u5212\u5199\u5165\uFF1B\u6709\u540E\u7EED\u4EBA\u5DE5\u7F16\u8F91\u65F6\u62D2\u7EDD\u8986\u76D6\u3002
   fulgurjs init [--out <\u8DEF\u5F84>] [--framework vue|react] [--role consumer|provider|dual] [--force]
@@ -5982,7 +6033,7 @@ async function main() {
     if (has("--plan") || has("--write")) {
       try {
         if (has("--config") || has("--out") || has("--force")) throw new Error("\u63A5\u5165\u8BA1\u5212\u4E0D\u80FD\u540C\u65F6\u4F7F\u7528 --config/--out/--force\uFF1B\u5DF2\u6709\u914D\u7F6E\u8BF7\u5355\u72EC\u8FD0\u884C doctor --config \u68C0\u67E5\u3002");
-        const values = ["--kind", "--role", "--framework", "--name", "--entry", "--remote", "--expose"];
+        const values = ["--kind", "--role", "--framework", "--name", "--entry", "--application", "--remote", "--expose"];
         for (let i = 1; i < argv.length; i++) {
           if (["--plan", "--write", "--json"].includes(argv[i])) continue;
           if (!values.includes(argv[i])) throw new Error(`\u672A\u77E5\u63A5\u5165\u8BA1\u5212\u53C2\u6570\uFF1A${argv[i]}`);
@@ -6006,7 +6057,7 @@ async function main() {
           return result2;
         };
         const { planIntegration: planIntegration2, formatIntegrationPlan: formatIntegrationPlan2, applyIntegration: applyIntegration2 } = await Promise.resolve().then(() => (init_init_plan(), init_plan_exports));
-        const plan = await planIntegration2({ cwd: process.cwd(), kind, role, framework: framework2, name: argOf("--name"), entry: argOf("--entry"), remotes: pairs("--remote"), exposes: pairs("--expose") });
+        const plan = await planIntegration2({ cwd: process.cwd(), kind, role, framework: framework2, name: argOf("--name"), entry: argOf("--entry"), application: argOf("--application"), remotes: pairs("--remote"), exposes: pairs("--expose") });
         const blocked = plan.tasks.some((task) => task.blocking);
         if (has("--write") && !blocked) applyIntegration2(plan);
         const written = has("--write") && !blocked;
@@ -6020,7 +6071,7 @@ async function main() {
         return 1;
       }
     }
-    if (["--kind", "--remote", "--expose", "--entry", "--name"].some(has)) {
+    if (["--kind", "--remote", "--expose", "--entry", "--application", "--name"].some(has)) {
       console.error("[fulgurjs:init] \u63A5\u5165\u8BA1\u5212\u53C2\u6570\u9700\u8981 --plan\uFF08\u9884\u89C8\uFF09\u6216 --write\uFF08\u663E\u5F0F\u5199\u5165\uFF09\u3002");
       return 2;
     }