@axewo/fin-micro 0.0.0-stage → 1.0.0

package/dist/core.mjs

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