@axewo/fin-micro 0.0.0-stage → 2.0.0

package/dist/core.mjs

@@ -0,0 +1,654 @@
+import { createNotificationBus as We, NavigationError as p, HostCallError as N } from "./sdk.mjs";
+function qe(Re, x = {}) {
+  var Ae;
+  const Z = /* @__PURE__ */ new Map(), pe = /* @__PURE__ */ new Map(), z = (e) => typeof e == "string" && !!e.trim() && !/[\u0000-\u001f\u007f]/.test(e), de = (e) => z(e) && e.startsWith("/") && !e.startsWith("//") && !e.includes("\\"), we = (e) => e.split(/[?#]/, 1)[0];
+  for (const e of Re) {
+    let s = function(r) {
+      if (!Array.isArray(r)) throw new Error("menus 必须为数组");
+      return Object.freeze(
+        r.map((i) => {
+          if (!i || !z(i.menuId) || !z(i.name) || c.has(i.menuId))
+            throw new Error("菜单标识/名称无效或菜单标识重复");
+          if (c.add(i.menuId), i.children !== void 0) {
+            if (i.target !== void 0 || !Array.isArray(i.children) || !i.children.length)
+              throw new Error("菜单分组需要非空 children 且不能配置 target");
+            return Object.freeze({
+              menuId: i.menuId,
+              name: i.name,
+              children: s(i.children)
+            });
+          }
+          if (!i.target || !z(i.target.tabId) || !de(i.target.route))
+            throw new Error("菜单叶节点需要有效 target");
+          return h.add(i.menuId), b.push({ pathPrefix: we(i.target.route), menuId: i.menuId }), Object.freeze({
+            menuId: i.menuId,
+            name: i.name,
+            target: Object.freeze({ tabId: i.target.tabId, route: i.target.route })
+          });
+        })
+      );
+    };
+    if (Z.has(e.appId)) throw new Error(`重复的 appId: ${e.appId}`);
+    if (e.kind === "local") {
+      if (e.entry !== void 0) throw new Error("本地应用不能配置 entry");
+    } else {
+      if (e.kind !== void 0 && e.kind !== "remote") throw new Error("未知应用类型");
+      const r = new URL(e.entry);
+      if (!["http:", "https:"].includes(r.protocol)) throw new Error("子应用地址必须使用 HTTP(S)");
+    }
+    const c = /* @__PURE__ */ new Set(), h = /* @__PURE__ */ new Set(), b = [], u = e.menus === void 0 ? void 0 : s(e.menus);
+    if (e.menuRoutes !== void 0 && !Array.isArray(e.menuRoutes))
+      throw new Error("menuRoutes 必须为数组");
+    const o = (Ae = e.menuRoutes) == null ? void 0 : Ae.map((r) => {
+      if (!r || !de(r.pathPrefix) || /[?#]/.test(r.pathPrefix) || !h.has(r.menuId))
+        throw new Error("菜单归属规则需要有效路径与本应用可导航叶节点");
+      return Object.freeze({ pathPrefix: r.pathPrefix, menuId: r.menuId });
+    });
+    b.push(...(o ?? []).map((r) => ({ ...r })));
+    const t = /* @__PURE__ */ new Map();
+    for (const r of b) {
+      if (r.pathPrefix = r.pathPrefix.replace(/\/+$/, "") || "/", t.has(r.pathPrefix) && t.get(r.pathPrefix) !== r.menuId)
+        throw new Error("菜单归属前缀冲突");
+      t.set(r.pathPrefix, r.menuId);
+    }
+    pe.set(e.appId, {
+      leaves: h,
+      routes: b.sort((r, i) => i.pathPrefix.length - r.pathPrefix.length)
+    }), Z.set(
+      e.appId,
+      Object.freeze({
+        appId: e.appId,
+        name: e.name,
+        ...e.kind === "local" ? { kind: "local" } : { ...e.kind ? { kind: e.kind } : {}, entry: e.entry },
+        ...u ? { menus: u } : {},
+        ...o ? { menuRoutes: Object.freeze(o) } : {}
+      })
+    );
+  }
+  const ae = We(), xe = Object.freeze({ source: "host" }), le = {
+    on(e, s) {
+      return ae.on(e, ({ payload: c, metadata: h }) => q(() => s(c, h)));
+    },
+    emit(e, s) {
+      ae.emit(e, { payload: s, metadata: xe });
+    },
+    clear: () => ae.clear()
+  }, ie = x.callTimeoutMs ?? 3e4;
+  if (!Number.isFinite(ie) || ie <= 0 || ie > 2147483647)
+    throw new Error("callTimeoutMs 必须为不超过2147483647的正有限数");
+  const K = /* @__PURE__ */ new Set();
+  function ke(e, s) {
+    if (!e || typeof e.authenticated != "boolean" || !Array.isArray(e.permissions) || !e.permissions.every((c) => typeof c == "string") || e.user !== void 0 && (!e.user || typeof e.user.id != "string" || e.user.name !== void 0 && typeof e.user.name != "string"))
+      throw new Error("会话快照无效");
+    return Object.freeze({
+      authenticated: e.authenticated,
+      permissions: Object.freeze([...e.permissions]),
+      ...e.user ? { user: Object.freeze({ id: e.user.id, ...e.user.name !== void 0 ? { name: e.user.name } : {} }) } : {},
+      revision: s
+    });
+  }
+  let ee = ke(x.session ?? { authenticated: !1, permissions: [] }, 0);
+  function ze(e) {
+    j(), ee = ke(e, ee.revision + 1);
+    const s = ee;
+    for (const c of [...K]) {
+      if (s !== ee) break;
+      K.has(c) && q(() => c(s));
+    }
+    return s;
+  }
+  const te = /* @__PURE__ */ new Set(), re = /* @__PURE__ */ new Map(), ve = new Map(
+    Object.entries(x.capabilities ?? {}).filter(([, e]) => e !== void 0).map(([e, s]) => {
+      const c = s;
+      return [
+        e,
+        { handler: c.handler, apps: c.apps ? new Set(c.apps) : void 0 }
+      ];
+    })
+  ), B = /* @__PURE__ */ new Map(), G = /* @__PURE__ */ new Map();
+  let d = { tabs: [], activeTabId: null }, be = 0, D = !1, W = 0, Ee = Promise.resolve();
+  const oe = /* @__PURE__ */ new Map(), U = /* @__PURE__ */ new Map(), _e = (e) => {
+    var s;
+    try {
+      (s = x.onError) == null || s.call(x, e);
+    } catch {
+    }
+  }, q = (e) => {
+    try {
+      e();
+    } catch (s) {
+      _e(s);
+    }
+  }, j = () => {
+    if (D) throw new Error("MicroHost 已销毁");
+  }, ce = () => ({ tabs: [...d.tabs], activeTabId: d.activeTabId }), ne = () => {
+    W++;
+    for (const e of [...te])
+      te.has(e) && q(() => e(ce()));
+  };
+  function me(e) {
+    return j(), te.add(e), () => {
+      te.delete(e);
+    };
+  }
+  const ue = x.canNavigate, ge = x.canOpen;
+  function Y(e) {
+    if (!ge) return;
+    const s = Object.freeze({
+      appId: e.appId,
+      tabId: e.tabId,
+      title: e.title,
+      route: e.route,
+      ...e.activeMenuId !== void 0 ? { activeMenuId: e.activeMenuId } : {}
+    });
+    try {
+      const c = ge(s);
+      if (c === !0) return;
+      c && (typeof c == "object" || typeof c == "function") && Promise.resolve(c).catch(() => {
+      });
+    } catch {
+    }
+    throw new p("FORBIDDEN", "无权访问该页面（权限策略必须同步返回 true）");
+  }
+  function he(e, s = !1) {
+    var o;
+    if (j(), !e || !z(e.title) || e.title.length > 500)
+      throw new Error("页签标题无效");
+    if (!Z.has(e.appId)) throw new Error(`未知子应用: ${e.appId}`);
+    if (!z(e.tabId) || !de(e.route))
+      throw new Error("需要 tabId 与应用内绝对路由");
+    const c = pe.get(e.appId);
+    if (e.activeMenuId !== void 0 && !c.leaves.has(e.activeMenuId))
+      throw new Error("activeMenuId 必须指向本应用可导航叶节点");
+    const h = we(e.route), b = e.activeMenuId ?? ((o = c.routes.find(
+      (t) => t.pathPrefix === "/" || h === t.pathPrefix || h.startsWith(`${t.pathPrefix}/`)
+    )) == null ? void 0 : o.menuId);
+    let u = d.tabs.find((t) => t.tabId === e.tabId);
+    if (u && (u.appId !== e.appId || u.route !== e.route && !s))
+      throw new Error("tabId 已绑定到其他页面");
+    return u && u.route !== e.route && (u = void 0), Y(u ?? { ...e, activeMenuId: b }), u || (u = Object.freeze({
+      appId: e.appId,
+      tabId: e.tabId,
+      title: e.title,
+      route: e.route,
+      ...b !== void 0 ? { activeMenuId: b } : {},
+      key: `${e.tabId}:${++be}`
+    })), u;
+  }
+  function He(e) {
+    const s = he(e);
+    return d = {
+      tabs: d.tabs.includes(s) ? d.tabs : [...d.tabs, s],
+      activeTabId: s.tabId
+    }, ne(), s;
+  }
+  function Fe(e, s, c) {
+    if (j(), typeof s.title != "string" || !s.title.trim() || s.title.length > 500 || /[\u0000-\u001f\u007f]/.test(s.title))
+      throw new Error("页签标题无效");
+    const h = d.tabs.find(
+      (u) => u.tabId === e && (!c || u.key === c)
+    );
+    if (!h) return;
+    const b = Object.freeze({ ...h, title: s.title });
+    return d = { ...d, tabs: d.tabs.map((u) => u === h ? b : u) }, ne(), b;
+  }
+  function $e(e) {
+    j();
+    const s = d.tabs.find((c) => c.tabId === e);
+    return s ? (Y(s), d = { ...d, activeTabId: e }, ne(), !0) : !1;
+  }
+  function Ce(e, s) {
+    var u;
+    j();
+    const c = d.tabs.findIndex(
+      (o) => o.tabId === e && (!s || o.key === s)
+    );
+    if (c < 0) return !1;
+    const h = d.tabs[c], b = d.tabs.filter((o) => o !== h);
+    if (d = {
+      tabs: b,
+      activeTabId: d.activeTabId === e ? ((u = b[Math.min(c, b.length - 1)]) == null ? void 0 : u.tabId) ?? null : d.activeTabId
+    }, Oe(h.key), !b.some((o) => o.appId === h.appId)) {
+      for (const o of [...G.get(h.appId) ?? []]) q(o);
+      G.delete(h.appId), re.delete(h.appId);
+    }
+    return ne(), !0;
+  }
+  function Oe(e) {
+    oe.delete(e), U.delete(e);
+    for (const s of [...B.get(e) ?? []]) q(s);
+    B.delete(e);
+  }
+  function Ve(e) {
+    return J(e);
+  }
+  function J(e, s, c, h = !1, b, u = !1) {
+    var o;
+    try {
+      if (D) throw new p("HOST_DISPOSED", "MicroHost 已销毁");
+      if (!e || !["open", "activate", "refresh", "close", "closeMany", "back"].includes(e.type))
+        throw new p("INVALID_OPERATION", "导航命令无效");
+      const t = {
+        ...e,
+        ..."target" in e && e.target ? { target: { ...e.target } } : {},
+        ..."anchor" in e && e.anchor ? { anchor: { ...e.anchor } } : {}
+      }, r = (n) => !!n && z(n.tabId) && (n.key === void 0 || z(n.key));
+      if (["activate", "refresh", "close"].includes(t.type) && (!("target" in t) || !r(t.target)))
+        throw new p("INVALID_OPERATION", "导航需要合法目标引用");
+      if ("target" in t && t.target !== void 0 && !r(t.target) || "anchor" in t && t.anchor !== void 0 && !r(t.anchor))
+        throw new p("INVALID_OPERATION", "导航引用无效");
+      if (t.type === "closeMany" && t.exclude !== void 0) {
+        if (!Array.isArray(t.exclude) || !t.exclude.every(r))
+          throw new p("INVALID_OPERATION", "批量排除引用无效");
+        t.exclude = Object.freeze(
+          t.exclude.map(
+            (n) => {
+              var g;
+              return Object.freeze({
+                tabId: n.tabId,
+                ...n.key !== void 0 ? { key: n.key } : { key: (g = d.tabs.find((k) => k.tabId === n.tabId)) == null ? void 0 : g.key }
+              });
+            }
+          )
+        );
+      }
+      if (t.type === "open") {
+        const n = t.input;
+        if (!n) throw new p("INVALID_OPERATION", "导航目标无效");
+        t.input = Object.freeze({
+          appId: n.appId,
+          tabId: n.tabId,
+          title: n.title,
+          route: n.route,
+          ...n.activeMenuId !== void 0 ? { activeMenuId: n.activeMenuId } : {}
+        });
+      }
+      if ("closeFallback" in t && t.closeFallback !== void 0) {
+        if (!r(t.closeFallback)) throw new p("INVALID_OPERATION", "关闭回落引用无效");
+        const n = t.closeFallback;
+        t.closeFallback = Object.freeze({ tabId: n.tabId, key: n.key ?? ((o = d.tabs.find((g) => g.tabId === n.tabId)) == null ? void 0 : o.key) });
+      }
+      "fallback" in t && t.fallback && (t.fallback = Object.freeze({ ...t.fallback })), "target" in t && t.target && Object.freeze(t.target), "anchor" in t && t.anchor && Object.freeze(t.anchor), Object.freeze(t);
+      const i = (n) => d.tabs.find(
+        (g) => n ? g.tabId === n.tabId && (!n.key || g.key === n.key) : g.tabId === d.activeTabId
+      ), w = "target" in t ? i(t.target) : void 0, v = t.type === "closeMany" && t.scope !== "all" ? t.anchor ? i(t.anchor) : c ? d.tabs.find((n) => n.key === c) : i() : void 0, S = i(), f = t.type === "open" ? d.tabs.find((n) => n.tabId === t.input.tabId) : void 0, I = u && c ? d.tabs.find((n) => n.key === c) : void 0, E = I && s ? Object.freeze({ appId: s, tab: Object.freeze({ ...I }) }) : void 0, _ = u && t.type === "open" && !!s && t.input.appId !== s, L = () => {
+        if (!(!_ || t.type !== "open")) {
+          try {
+            const n = E && (ue == null ? void 0 : ue(E, t.input));
+            if (n === !0) return;
+            n && (typeof n == "object" || typeof n == "function") && Promise.resolve(n).catch(() => {
+            });
+          } catch {
+          }
+          throw new p("FORBIDDEN", "无权跨应用导航（权限策略必须同步返回 true）");
+        }
+      }, H = (n) => !s || n.appId === s;
+      if (w && !H(w) || v && !H(v) || t.type === "open" && s && t.input.appId !== s && !_ || t.type === "back" && t.fallback && s && t.fallback.appId !== s)
+        throw new p("FORBIDDEN", "页面只能操作本应用");
+      if (t.type === "closeMany" && !["all", "others", "left", "right"].includes(t.scope))
+        throw new p("INVALID_OPERATION", "批量范围无效");
+      const F = v ? d.tabs.indexOf(v) : -1, Q = t.type === "closeMany" ? d.tabs.filter(
+        (n, g) => {
+          var k;
+          return H(n) && !((k = t.exclude) != null && k.some((C) => C.tabId === n.tabId && C.key === n.key)) && (t.scope === "all" || F >= 0 && (t.scope === "others" ? n.key !== v.key : t.scope === "left" ? g < F : g > F));
+        }
+      ) : [], m = t.type === "back" ? w ?? (!("target" in t) || !t.target ? S : void 0) : w, $ = async () => {
+        var Te, Pe, De, Me, je, Se;
+        const n = (a) => ({
+          status: a,
+          affected: []
+        });
+        if (D) throw new p("HOST_DISPOSED", "MicroHost 已销毁");
+        if ((Te = t.signal) != null && Te.aborted) return n("stale");
+        if (c && !h && (b != null && b() || !d.tabs.some((a) => a.key === c)))
+          throw new p("PAGE_RELEASED", "页面上下文已释放");
+        if (t.type === "open" && (f ? !d.tabs.some((a) => a.key === f.key) : d.tabs.some((a) => a.tabId === t.input.tabId)) || m && !d.tabs.some((a) => a.key === m.key) || v && !d.tabs.some((a) => a.key === v.key) || Q.some((a) => !d.tabs.some((O) => O.key === a.key)))
+          return n("stale");
+        if (t.type !== "open" && t.type !== "closeMany" && !m) return n("noop");
+        const g = W;
+        if (L(), c && !h && (b != null && b() || !d.tabs.some((a) => a.key === c)))
+          throw new p("PAGE_RELEASED", "页面上下文已释放");
+        if (W !== g || D || (Pe = t.signal) != null && Pe.aborted) return n("stale");
+        const k = d, C = W;
+        let y = [...d.tabs], l, M = [], V = d.activeTabId;
+        try {
+          if (t.type === "open" && (l = he(t.input, !0), f && f.key !== l.key ? (M = [f], y = y.map((a) => a.key === f.key ? l : a)) : y.some((a) => a.key === l.key) || y.push(l), V = l.tabId), t.type === "activate" && (l = m, Y(l), V = l.tabId), t.type === "refresh" && (Y(m), M = [m], l = Object.freeze({
+            ...m,
+            key: `${m.tabId}:${++be}`
+          }), y = y.map((a) => a.key === m.key ? l : a)), (t.type === "close" || t.type === "back") && (M = [m]), t.type === "closeMany" && (M = Q), M.length && t.type !== "refresh" && t.type !== "open") {
+            const a = new Set(M.map((A) => A.key)), O = k.tabs.findIndex((A) => A.tabId === k.activeTabId);
+            if (y = y.filter((A) => !a.has(A.key)), t.type === "back") {
+              const A = U.get(m.key);
+              l = y.find((P) => P.key === A && H(P)), !l && t.fallback && (l = he(t.fallback), a.has(l.key) && (l = Object.freeze({ ...l, key: `${l.tabId}:${++be}` })), y.some((P) => P.key === l.key) || y.push(l));
+              const T = k.tabs.filter((P) => H(P)), R = T.findIndex((P) => P.key === m.key);
+              l ?? (l = T.slice(0, R).reverse().find((P) => y.some((se) => se.key === P.key)) ?? T.slice(R + 1).find((P) => y.some((se) => se.key === P.key))), l ?? (l = y[Math.min(O, y.length - 1)]), l && Y(l), V = (l == null ? void 0 : l.tabId) ?? null;
+            } else if (M.some((A) => A.tabId === V)) {
+              const A = "closeFallback" in t ? t.closeFallback : void 0, T = A ? y.find((R) => R.tabId === A.tabId && R.key === A.key && H(R)) : void 0;
+              T && (Y(T), l = T), V = ((De = T ?? y[Math.min(O, y.length - 1)]) == null ? void 0 : De.tabId) ?? null;
+            }
+          }
+        } catch (a) {
+          throw a instanceof p ? a : new p("INVALID_OPERATION", "导航参数无效");
+        }
+        if (y.length === k.tabs.length && y.every((a, O) => a.key === k.tabs[O].key) && V === k.activeTabId)
+          return n("noop");
+        const Ie = [...M], fe = k.tabs.find((a) => a.tabId === k.activeTabId);
+        fe && fe.tabId !== V && !Ie.some((a) => a.key === fe.key) && Ie.push(fe);
+        for (const a of Ie)
+          for (const O of [...oe.get(a.key) ?? []]) {
+            let A;
+            const T = t.signal;
+            let R = () => {
+            };
+            try {
+              const P = Promise.resolve(O({ operation: t, tab: a })), se = new Promise((Le) => {
+                if (!T) return;
+                const Ne = () => Le();
+                T.addEventListener("abort", Ne, { once: !0 }), R = () => T.removeEventListener("abort", Ne), T.aborted && Le();
+              });
+              A = await Promise.race([P, se]);
+            } catch {
+              if (T != null && T.aborted) return n("stale");
+              throw new p("GUARD_FAILED", "离页守卫执行失败");
+            } finally {
+              R();
+            }
+            if (W !== C || D || (Me = t.signal) != null && Me.aborted) return n("stale");
+            if (A === !1) return n("cancelled");
+          }
+        if (W !== C || D || (je = t.signal) != null && je.aborted) return n("stale");
+        if (b != null && b()) throw new p("PAGE_RELEASED", "页面上下文已释放");
+        if (L(), l && Y(l), b != null && b()) throw new p("PAGE_RELEASED", "页面上下文已释放");
+        if (W !== C || D || (Se = t.signal) != null && Se.aborted) return n("stale");
+        if (d = { tabs: y, activeTabId: V }, t.type === "open" && l && c && !_ && l.key !== c && !U.has(l.key) && U.set(l.key, c), t.type === "refresh" && l) {
+          const a = U.get(m.key);
+          a && U.set(l.key, a);
+        }
+        for (const a of M) Oe(a.key);
+        for (const a of new Set(M.map((O) => O.appId)))
+          if (!y.some((O) => O.appId === a)) {
+            for (const O of [...G.get(a) ?? []]) q(O);
+            G.delete(a), re.delete(a);
+          }
+        const ye = [
+          ...M,
+          ...y.filter((a) => !k.tabs.some((O) => O.key === a.key))
+        ];
+        return !ye.length && l && ye.push(l), ne(), {
+          status: "committed",
+          affected: ye.map((a) => ({ tabId: a.tabId, key: a.key })),
+          ...l ? { tab: l } : {}
+        };
+      }, X = Ee.then($);
+      return Ee = X.catch(() => {
+      }), X;
+    } catch (t) {
+      return Promise.reject(t);
+    }
+  }
+  function Be(e) {
+    if (j(), !Z.has(e)) throw new Error(`未知子应用: ${e}`);
+    const s = re.get(e);
+    if (s) return s;
+    let c = !0;
+    const h = /* @__PURE__ */ new Set([
+      () => {
+        c = !1;
+      }
+    ]);
+    G.set(e, h);
+    async function b(o, t, r, i = {}) {
+      const w = () => {
+        if (D) throw new N("HOST_DISPOSED", "MicroHost 已销毁");
+        if (r && (r.released() || !d.tabs.some((L) => L.key === r.key)))
+          throw new N("PAGE_RELEASED", "页面上下文已释放");
+        if (!c) throw new N("BRIDGE_RELEASED", "应用 bridge 已释放");
+      };
+      w();
+      const v = ve.get(o);
+      if (!v) throw new N("UNKNOWN_CAPABILITY", `未注册宿主能力: ${o}`);
+      if (v.apps && !v.apps.has(e))
+        throw new N("FORBIDDEN", `应用无权调用宿主能力: ${o}`);
+      const S = i.timeoutMs ?? ie;
+      if (!Number.isFinite(S) || S <= 0 || S > 2147483647)
+        throw new TypeError("timeoutMs 必须为不超过2147483647的正有限数");
+      const f = i.signal;
+      if (f != null && f.aborted) throw new N("CANCELLED", "宿主能力调用已取消");
+      const I = new AbortController(), E = r ? d.tabs.find((L) => L.key === r.key) : void 0, _ = Object.freeze({
+        appId: e,
+        signal: I.signal,
+        ...E ? { tab: Object.freeze({ ...E }) } : {},
+        isActive: () => !I.signal.aborted && !D && c && (!r || !r.released() && d.tabs.some((L) => L.key === r.key))
+      });
+      return new Promise((L, H) => {
+        let F = !1, Q;
+        const m = () => {
+          Q !== void 0 && clearTimeout(Q), f == null || f.removeEventListener("abort", X), h.delete(n), r == null || r.cleanups.delete(n);
+        }, $ = (k) => {
+          F || (F = !0, m(), H(k), I.abort());
+        }, X = () => $(new N("CANCELLED", "宿主能力调用已取消")), n = () => {
+          try {
+            w();
+          } catch (k) {
+            $(k);
+          }
+        };
+        if (h.add(n), r == null || r.cleanups.add(n), f == null || f.addEventListener("abort", X, { once: !0 }), Q = setTimeout(() => $(new N("TIMEOUT", "宿主能力调用超时")), S), f != null && f.aborted) {
+          X();
+          return;
+        }
+        let g;
+        try {
+          g = v.handler(_, ...t);
+        } catch {
+          $(new N("HANDLER_FAILED", `宿主能力执行失败: ${o}`));
+          return;
+        }
+        Promise.resolve(g).then((k) => {
+          if (!F) {
+            try {
+              w();
+            } catch (C) {
+              $(C);
+              return;
+            }
+            F = !0, m(), L(k);
+          }
+        }, () => $(new N("HANDLER_FAILED", `宿主能力执行失败: ${o}`)));
+      });
+    }
+    const u = {
+      appId: e,
+      getState: ce,
+      callHost(o, ...t) {
+        return b(o, t);
+      },
+      callHostWithOptions(o, t, ...r) {
+        return b(o, r, void 0, t);
+      },
+      protocol() {
+        if (j(), !c) throw new Error("应用 bridge 已释放");
+        return Object.freeze({
+          version: "1.0",
+          capabilities: Object.freeze([...ve].filter(([, o]) => !o.apps || o.apps.has(e)).map(([o]) => o)),
+          features: Object.freeze(["call-options", "session", "event-metadata", "navigate-to"])
+        });
+      },
+      negotiate(o = {}) {
+        const t = u.protocol(), r = Object.freeze((o.capabilities ?? []).filter((i) => !t.capabilities.includes(i)));
+        return Object.freeze({ compatible: (!o.version || o.version === t.version) && !r.length, protocol: t, missingCapabilities: r });
+      },
+      getSession() {
+        if (j(), !c) throw new Error("应用 bridge 已释放");
+        return ee;
+      },
+      subscribeSession(o) {
+        const t = u.getSession(), r = (w) => o(w), i = () => {
+          K.delete(r), h.delete(i);
+        };
+        return K.add(r), h.add(i), q(() => o(t)), i;
+      },
+      subscribe(o) {
+        if (!c) throw new Error("应用 bridge 已释放");
+        const t = me(o), r = () => {
+          t(), h.delete(r);
+        };
+        return h.add(r), r;
+      },
+      ready(o) {
+        const t = (i) => {
+          const w = i.tabs.find(
+            (v) => v.tabId === i.activeTabId && v.appId === e
+          );
+          w && o(w);
+        }, r = u.subscribe(t);
+        try {
+          t(ce());
+        } catch (i) {
+          throw r(), i;
+        }
+        return r;
+      },
+      bindPage(o) {
+        const t = d.tabs.find((r) => r.tabId === o && r.appId === e);
+        if (!t) throw new Error("页面不属于该应用");
+        return u.page(t.key);
+      },
+      page(o) {
+        if (j(), !c) throw new Error("应用 bridge 已释放");
+        const t = d.tabs.find((f) => f.key === o && f.appId === e);
+        if (!t) throw new Error("页面上下文不存在或不属于该应用");
+        let r = !1;
+        const i = /* @__PURE__ */ new Set(), w = () => {
+          if (D) throw new p("HOST_DISPOSED", "MicroHost 已销毁");
+          if (r || !d.tabs.some((f) => f.key === o))
+            throw new p("PAGE_RELEASED", "页面上下文已释放");
+        }, v = () => {
+          var f;
+          r = !0, i.forEach((I) => I()), i.clear(), (f = B.get(o)) == null || f.delete(v);
+        };
+        let S = B.get(o);
+        return S || B.set(o, S = /* @__PURE__ */ new Set()), S.add(v), {
+          get tab() {
+            return d.tabs.find((f) => f.key === o) ?? t;
+          },
+          callHost(f, ...I) {
+            return b(f, I, { key: o, released: () => r, cleanups: i });
+          },
+          callHostWithOptions(f, I, ...E) {
+            return b(f, E, { key: o, released: () => r, cleanups: i }, I);
+          },
+          async openTab(f) {
+            w();
+            const I = await J(
+              { type: "open", input: f },
+              e,
+              o,
+              !1,
+              () => r
+            );
+            if (I.tab) return I.tab;
+            const E = d.tabs.find(
+              (_) => _.tabId === f.tabId && _.appId === e
+            );
+            if (I.status === "noop" && E) return E;
+            throw new p(
+              I.status === "cancelled" ? "CANCELLED" : "STALE",
+              "导航未提交"
+            );
+          },
+          async navigateTo(f, I = {}) {
+            return w(), J(
+              { type: "open", input: f, signal: I.signal },
+              e,
+              o,
+              !1,
+              () => r,
+              !0
+            );
+          },
+          // 释放后仅允许关闭捕获的原 key；所有守卫仍然执行，不能误关同 id 新生命周期。
+          async closeCurrent() {
+            return D ? !1 : (await J(
+              { type: "close", target: { tabId: t.tabId, key: o } },
+              e,
+              void 0,
+              !0
+            )).status === "committed";
+          },
+          beforeLeave(f) {
+            if (w(), typeof f != "function")
+              throw new p("INVALID_OPERATION", "离页守卫必须为函数");
+            let I = oe.get(o);
+            I || oe.set(o, I = /* @__PURE__ */ new Set()), I.add(f);
+            const E = () => {
+              I.delete(f), i.delete(E);
+            };
+            return i.add(E), E;
+          },
+          async refreshCurrent() {
+            return w(), J(
+              { type: "refresh", target: { tabId: t.tabId, key: o } },
+              e,
+              o,
+              !1,
+              () => r
+            );
+          },
+          async back(f) {
+            return w(), J(
+              { type: "back", target: { tabId: t.tabId, key: o }, fallback: f },
+              e,
+              o,
+              !1,
+              () => r
+            );
+          },
+          async operate(f) {
+            return w(), J(f, e, o, !1, () => r);
+          },
+          emit(f, I) {
+            w(), ae.emit(f, { payload: I, metadata: Object.freeze({ source: "app", appId: e, tabKey: o }) });
+          },
+          on(f, I) {
+            w();
+            const E = le.on(f, I);
+            return i.add(E), () => {
+              E(), i.delete(E);
+            };
+          },
+          dispose: v
+        };
+      }
+    };
+    return re.set(e, u), u;
+  }
+  function Ge() {
+    if (!D) {
+      D = !0;
+      for (const e of B.values()) [...e].forEach((s) => s());
+      B.clear(), oe.clear(), U.clear();
+      for (const e of G.values()) [...e].forEach((s) => s());
+      G.clear(), te.clear(), K.clear(), re.clear(), le.clear(), d = { tabs: [], activeTabId: null };
+    }
+  }
+  return {
+    /** 注册应用的冻结元信息；不暴露 capabilities 注册表。 */
+    apps: [...Z.values()],
+    getState: ce,
+    subscribe: me,
+    openTab: He,
+    activateTab: $e,
+    closeTab: Ce,
+    updateTab: Fe,
+    updateSession: ze,
+    operate: Ve,
+    bridge: Be,
+    /** 宿主侧业务事件总线；无响应广播，来源元信息由宿主生成，异常通过 onError 隔离。 */
+    bus: le,
+    dispose: Ge
+  };
+}
+export {
+  qe as createMicroHost
+};

package/dist/iframe.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const v={TIMEOUT:"请求超时",CANCELLED:"请求已取消",DISPOSED:"连接已释放",LIMIT_EXCEEDED:"请求数量超过限制",UNKNOWN_METHOD:"未开放此方法",HANDLER_FAILED:"远端调用失败",SERIALIZATION_FAILED:"消息无法发送或序列化"};class g extends Error{constructor(a){super(v[a]),this.code=a,this.name="IframeRpcError"}}const x=n=>typeof n=="object"&&n!==null&&!Array.isArray(n),p=n=>typeof n=="string"&&n.length>0&&n.length<=128,M=n=>Number.isFinite(n)&&n>0&&n<=2147483647;function U(n){let a;try{a=new URL(n.remoteOrigin)}catch{throw new TypeError("remoteOrigin 必须是精确 HTTP(S) origin")}if(!["https:","http:"].includes(a.protocol)||a.origin!==n.remoteOrigin)throw new TypeError("remoteOrigin 必须是精确 HTTP(S) origin");if(!p(n.channel)||!p(n.sessionId))throw new TypeError("channel/sessionId 必须为 1 至 128 字符");const y=n.timeoutMs??3e4,u=n.handlerTimeoutMs??y,o=n.maxPending??100;if(!M(u)||!M(y)||!Number.isSafeInteger(o)||o<1)throw new TypeError("请求超时或数量限制非法");const{localWindow:f,remoteWindow:A,remoteOrigin:N,channel:P,sessionId:R}=n,E=new Map,m=new Map,D=(r,e)=>{const t=m.get(r);t&&(m.delete(r),clearTimeout(t.timer),e&&t.controller.abort())},T=new Map;let C=0,_=0,i=!1;const L=r=>A.postMessage({protocol:"fin-micro-rpc",version:1,channel:P,sessionId:R,...r},N),O=r=>{try{L(r)}catch{}},h=(r,e)=>O({type:"error",requestId:r,code:e}),w=(r,e,t)=>{const s=T.get(r);s&&(T.delete(r),s.cleanup(),e?s.reject(new g(e)):s.resolve(t))},j=r=>{if(i||r.source!==A||r.origin!==N)return;const e=r.data;if(!x(e)||e.protocol!=="fin-micro-rpc"||e.version!==1||e.channel!==P||e.sessionId!==R||!p(e.requestId))return;const t=e.requestId;if(e.type==="result"){if(!Object.hasOwn(e,"result"))return;w(t,void 0,e.result)}else if(e.type==="error"){if(typeof e.code!="string"||!Object.hasOwn(v,e.code))return;w(t,e.code)}else if(e.type==="cancel")D(t,!0);else if(e.type==="request"){if(!p(e.method)||!Array.isArray(e.args)||!/^[1-9]\d{0,15}$/.test(t))return;const s=Number(t);if(!Number.isSafeInteger(s)||s<=C)return;if(C=s,m.size>=o){h(t,"LIMIT_EXCEEDED");return}const l=E.get(e.method);if(!l){h(t,"UNKNOWN_METHOD");return}const c=new AbortController,b=setTimeout(()=>{D(t,!0),i||h(t,"TIMEOUT")},u);m.set(t,{controller:c,timer:b}),Promise.resolve().then(()=>{if(!(i||c.signal.aborted))return l(e.args,{signal:c.signal})}).then(d=>{if(!(i||c.signal.aborted))try{L({type:"result",requestId:t,result:d})}catch{h(t,"SERIALIZATION_FAILED")}},()=>{!i&&!c.signal.aborted&&h(t,"HANDLER_FAILED")}).finally(()=>{var d;((d=m.get(t))==null?void 0:d.controller)===c&&D(t,!1)})}};return f.addEventListener("message",j),{request(r,e,t={}){var c;if(i)return Promise.reject(new g("DISPOSED"));if(!p(r)||!Array.isArray(e))return Promise.reject(new TypeError("方法与参数非法"));const s=t.timeoutMs??y;if(!M(s))return Promise.reject(new TypeError("timeoutMs 非法"));if((c=t.signal)!=null&&c.aborted)return Promise.reject(new g("CANCELLED"));if(T.size>=o||_>=Number.MAX_SAFE_INTEGER)return Promise.reject(new g("LIMIT_EXCEEDED"));const l=String(++_);return new Promise((b,d)=>{const q=S=>{w(l,S),O({type:"cancel",requestId:l})},H=()=>q("CANCELLED"),F=setTimeout(()=>q("TIMEOUT"),s),I=t.signal;T.set(l,{resolve:S=>b(S),reject:d,cleanup(){clearTimeout(F),I==null||I.removeEventListener("abort",H)}}),I==null||I.addEventListener("abort",H,{once:!0});try{L({type:"request",requestId:l,method:r,args:e})}catch{w(l,"SERIALIZATION_FAILED")}})},expose(r,e){if(i)throw new g("DISPOSED");if(!p(r)||typeof e!="function"||E.has(r))throw new TypeError("方法非法或已注册");E.set(r,e);let t=!0;return()=>{t&&(t=!1,E.get(r)===e&&E.delete(r))}},dispose(){if(!i){i=!0,f.removeEventListener("message",j);for(const r of T.keys())w(r,"DISPOSED"),O({type:"cancel",requestId:r});for(const r of m.keys())D(r,!0);E.clear()}}}}function W(n,a,y){const u=[];try{for(const o of new Set(y))u.push(n.expose(o,(f,{signal:A})=>a.callHostWithOptions(o,{signal:A},...f)))}catch(o){throw u.forEach(f=>f()),o}return()=>u.forEach(o=>o())}exports.IframeRpcError=g;exports.createIframeRpc=U;exports.exposeHostCapabilities=W;