@done-coding/admin-core 0.1.3-alpha.0 → 0.1.4-alpha.0

package/es/bridge/index.mjs

@@ -0,0 +1,75 @@
+function w() {
+  let l, h, c, T, I, k = !1, t, i, o, f, g, u, s, A;
+  const n = (e) => `admin bridge: ${e} 未注册`, r = () => {
+    if (!k) throw new Error("admin bridge: 未 init");
+  }, a = {
+    init(e) {
+      return l = e.appConfig, h = e.storage, c = e.routes, T = e.userInfoAccess, I = e.getUserInfoInitFn, k = !0, a;
+    },
+    register(e) {
+      r(), e.getToken && (t = e.getToken), e.goToLogin && (i = e.goToLogin), e.refreshToken && (o = e.refreshToken), e.refreshAuth && (f = e.refreshAuth), e.loginApi && (g = e.loginApi), e.logoutApi && (u = e.logoutApi), e.getUserInfoApi && (s = e.getUserInfoApi), e.refreshTokenApi && (A = e.refreshTokenApi);
+    },
+    // pre-init 同步 throw；post-init 未注册同步 throw；已注册返回 undefined 是合法业务态不 throw
+    // v3 终锁 Δ8b：零参 facade（BR-1 ③ 终裁——core 对 UserInfo 不透明 + 拦截器无 info 源）
+    getToken() {
+      if (r(), !t) throw new Error(n("getToken"));
+      return t();
+    },
+    // pre-init 同步 throw；post-init 同步对
+    goToLogin() {
+      if (r(), !i) throw new Error(n("goToLogin"));
+      i();
+    },
+    // 异步对：init-gate 优先于「异步对返 reject」——pre-init 一律同步 throw；
+    // post-init 未注册才返回 rejected Promise（既有降级语义保留）。
+    refreshToken() {
+      return r(), o ? o().then(() => {
+      }) : Promise.reject(new Error(n("refreshToken")));
+    },
+    // 异步对：同上
+    refreshAuth() {
+      return r(), f ? f().then(() => {
+      }) : Promise.reject(new Error(n("refreshAuth")));
+    },
+    // pre-init 同步 throw；post-init 返回 init 注册引用
+    getAppConfig() {
+      return r(), l;
+    },
+    // pre-init 同步 throw；post-init 返回 init 注册引用
+    getStorage() {
+      return r(), h;
+    },
+    // pre-init 同步 throw；post-init 返回 init 注册引用
+    getRoutes() {
+      return r(), c;
+    },
+    // pre-init 同步 throw；post-init 返回 init 注册引用（v3 终锁 Δ0d，镜像 getRoutes 范式）
+    getUserInfoAccess() {
+      return r(), T;
+    },
+    // pre-init 同步 throw；post-init 返回 init 注册引用（v3 终锁 Δ0d，镜像 getRoutes 范式）
+    getUserInfoInitFn() {
+      return r(), I;
+    },
+    // 异步对：pre-init 同步 throw；post-init 未注册返回 rejected 原生 Error（#4a-2 per-method 降级）
+    loginApi(e) {
+      return r(), g ? g(e) : Promise.reject(new Error(n("loginApi")));
+    },
+    // 异步对：同上
+    logoutApi() {
+      return r(), u ? u() : Promise.reject(new Error(n("logoutApi")));
+    },
+    // 异步对：同上
+    getUserInfoApi() {
+      return r(), s ? s() : Promise.reject(new Error(n("getUserInfoApi")));
+    },
+    // 异步对：同上
+    refreshTokenApi(e) {
+      return r(), A ? A(e) : Promise.reject(new Error(n("refreshTokenApi")));
+    }
+  };
+  return a;
+}
+export {
+  w as createAdminBridge
+};

package/es/hooks/activated.mjs

@@ -1,40 +1,48 @@
-import { watch as d, ref as n, computed as c, onMounted as o, onActivated as s, onDeactivated as r, onBeforeUnmount as u } from "vue";
-const v = () => {
-  const e = n({
+import { watch as o, ref as n, computed as v, readonly as r, onMounted as u, onActivated as A, onDeactivated as m, onBeforeUnmount as f } from "vue";
+const s = (e) => {
+  const t = n({
     isActivated: !1,
     triggerType: "mounted"
-  }), i = c(() => e.value.isActivated), t = (a) => {
-    e.value = a;
+  }), i = v(() => t.value.isActivated), a = v(() => r(t.value)), d = (c) => {
+    t.value = c;
   };
-  return o(() => {
-    t({ isActivated: !0, triggerType: "mounted" }), s(() => {
-      t({ isActivated: !0, triggerType: "activated" });
+  return u(() => {
+    d({ isActivated: !0, triggerType: "mounted" }), A(() => {
+      d({ isActivated: !0, triggerType: "activated" });
     });
-  }), r(() => {
-    t({ isActivated: !1, triggerType: "deactivated" });
-  }), u(() => {
-    t({ isActivated: !1, triggerType: "unmounted" });
-  }), {
+  }), m(() => {
+    d({ isActivated: !1, triggerType: "deactivated" });
+  }), f(() => {
+    d({ isActivated: !1, triggerType: "unmounted" });
+  }), o(
+    t,
+    (c) => {
+      e == null || e(c);
+    },
+    {
+      immediate: !0
+    }
+  ), {
     isActivated: i,
-    activatedInfo: c(() => e.value)
+    activatedInfo: a
   };
-}, g = (e) => {
-  const { activatedInfo: i } = v();
-  d(
-    i,
-    (t) => {
-      t.isActivated && e(t);
+}, l = (e) => {
+  const { activatedInfo: t } = s();
+  o(
+    t,
+    (i) => {
+      i.isActivated && e(i);
     },
     {
       immediate: !0
     }
   );
-}, m = (e, i) => {
-  const { activatedInfo: t } = v();
-  d(
-    t,
+}, p = (e, t) => {
+  const { activatedInfo: i } = s();
+  o(
+    i,
     (a) => {
-      a.isActivated ? e(a) : i(a);
+      a.isActivated ? e(a) : t(a);
     },
     {
       immediate: !0
@@ -42,7 +50,7 @@ const v = () => {
   );
 };
 export {
-  v as useActivated,
-  m as useActivatedEvent,
-  g as useActivatedExec
+  s as useActivated,
+  p as useActivatedEvent,
+  l as useActivatedExec
 };

package/es/index.mjs

@@ -5,120 +5,124 @@ import { miscInstall as a } from "./components/misc/index.mjs";
 import { modalInstall as m } from "./components/modal/index.mjs";
 import { tableInstall as f } from "./components/table/index.mjs";
 import { listPageInstall as s } from "./components/list-page/index.mjs";
-import { default as _ } from "./components/misc/ActionButton.vue.mjs";
-import { default as T } from "./components/misc/ActionButtonDanger.vue.mjs";
-import { default as C } from "./components/misc/ActionButtonWarn.vue.mjs";
-import { default as F } from "./components/modal/DetailModal.vue.mjs";
-import { default as R } from "./components/form/FormMain.vue.mjs";
-import { default as O } from "./components/form/FormRadioGroup.vue.mjs";
-import { default as D } from "./components/form/FormSelect.vue.mjs";
-import { default as h } from "./components/form/FormTree.vue.mjs";
-import { default as b } from "./components/form/FormVerifyCode.vue.mjs";
-import { default as v } from "./components/display/HeightProvider.vue.mjs";
-import { default as V } from "./components/menu/MenuItemSub.vue.mjs";
-import { default as U } from "./components/menu/MenuTree.vue.mjs";
-import { default as W } from "./components/misc/TriggerAutoImport.vue.mjs";
-import { default as k } from "./components/display/WatchSize.vue.mjs";
-import { APP_API_LIST_MODEL_KEY_CONFIG as X } from "./config/list-model.mjs";
-import { default as Q } from "./components/misc/AutoRefresh.vue.mjs";
-import { BODY_CONTENT_VIEWPORT_HEIGHT as q, FULLSCREEN_HEIGHT_CHANNEL as J } from "./inject/key.mjs";
-import { default as $ } from "./components/modal/ConfirmModal.vue.mjs";
-import { EXPORT_MAX_LIMIT as te, OPERATE_COLUMN_PROP as oe, exportCSV as re, pickExportColumns as ae } from "./utils/export.mjs";
-import { FORM_CONFIG_SELECT_ALL_VALUE as fe, getConfirmPasswordRule as se, passwordRule as le, setFormComponentType as ue } from "./helpers/form.mjs";
-import { FORM_ITEM_CHANGE_LOADING as pe, generateFormData as ne, getBlurSubmit as xe, getChangeSubmit as de, getDatePickerShortcuts as ce, getEnterSubmit as Ee, getPlaceholder as Ie, getVModelSugar as _e, parseFormData as ge, resolveFormLayout as Te, setInputComponent as Ae, setSelectComponent as Ce, stringifyFormData as Me, swiftFormItemConfig as Fe } from "./components/form/utils.mjs";
-import { default as Re } from "./components/form/FormSearch.vue.mjs";
-import { default as Oe } from "./components/form/FormVerifyImage.vue.mjs";
-import { default as De } from "./components/list-page/ListPage.vue.mjs";
-import { ROUTE_MODULE_LEVEL as he, TabsMainReplaceQueryKey as ye } from "./config/route.mjs";
-import { default as Ge } from "./components/table/TableMain.vue.mjs";
-import { default as He } from "./components/display/TabsMain.vue.mjs";
-import { countAll as we, createListApi as Ue, fetchListAll as Be } from "./helpers/list-helper.mjs";
-import { createGenerateRouteMetaRawTree as Ke } from "./helpers/route.mjs";
-import { createStorageWithNamespace as ze } from "./helpers/storage.mjs";
-import { createUseState as Ye } from "./helpers/state.mjs";
-import { flatRouteMetaResolveRaw as je, getRoutePermissionKey as qe } from "./utils/router.mjs";
-import { getId as Ze } from "./utils/id.mjs";
-import { timeCountDown as et } from "./utils/time.mjs";
-import { useActivated as ot, useActivatedEvent as rt, useActivatedExec as at } from "./hooks/activated.mjs";
-import { useFeelSize as ft } from "./hooks/feel-size.mjs";
-import { useMenusDataDispatch as lt } from "./hooks/menus-dispatch.mjs";
-import { useTimeout as it } from "./hooks/timeout.mjs";
+import { createAdminBridge as g } from "./bridge/index.mjs";
+import { default as A } from "./components/misc/ActionButton.vue.mjs";
+import { default as C } from "./components/misc/ActionButtonDanger.vue.mjs";
+import { default as F } from "./components/misc/ActionButtonWarn.vue.mjs";
+import { default as R } from "./components/modal/DetailModal.vue.mjs";
+import { default as O } from "./components/form/FormMain.vue.mjs";
+import { default as D } from "./components/form/FormRadioGroup.vue.mjs";
+import { default as h } from "./components/form/FormSelect.vue.mjs";
+import { default as b } from "./components/form/FormTree.vue.mjs";
+import { default as v } from "./components/form/FormVerifyCode.vue.mjs";
+import { default as U } from "./components/display/HeightProvider.vue.mjs";
+import { default as w } from "./components/menu/MenuItemSub.vue.mjs";
+import { default as W } from "./components/menu/MenuTree.vue.mjs";
+import { default as k } from "./components/misc/TriggerAutoImport.vue.mjs";
+import { default as X } from "./components/display/WatchSize.vue.mjs";
+import { APP_API_LIST_MODEL_KEY_CONFIG as Q } from "./config/list-model.mjs";
+import { default as q } from "./components/misc/AutoRefresh.vue.mjs";
+import { BODY_CONTENT_VIEWPORT_HEIGHT as Z, FULLSCREEN_HEIGHT_CHANNEL as $ } from "./inject/key.mjs";
+import { default as te } from "./components/modal/ConfirmModal.vue.mjs";
+import { EXPORT_MAX_LIMIT as re, OPERATE_COLUMN_PROP as ae, exportCSV as me, pickExportColumns as fe } from "./utils/export.mjs";
+import { FORM_CONFIG_SELECT_ALL_VALUE as le, getConfirmPasswordRule as ue, passwordRule as ie, setFormComponentType as pe } from "./helpers/form.mjs";
+import { FORM_ITEM_CHANGE_LOADING as xe, generateFormData as de, getBlurSubmit as ce, getChangeSubmit as Ee, getDatePickerShortcuts as Ie, getEnterSubmit as ge, getPlaceholder as _e, getVModelSugar as Ae, parseFormData as Te, resolveFormLayout as Ce, setInputComponent as Me, setSelectComponent as Fe, stringifyFormData as Le, swiftFormItemConfig as Re } from "./components/form/utils.mjs";
+import { default as Oe } from "./components/form/FormSearch.vue.mjs";
+import { default as De } from "./components/form/FormVerifyImage.vue.mjs";
+import { default as he } from "./components/list-page/ListPage.vue.mjs";
+import { ROUTE_MODULE_LEVEL as be, TabsMainReplaceQueryKey as Ge } from "./config/route.mjs";
+import { default as He } from "./components/table/TableMain.vue.mjs";
+import { default as Ve } from "./components/display/TabsMain.vue.mjs";
+import { countAll as Be, createListApi as We, fetchListAll as Ke } from "./helpers/list-helper.mjs";
+import { createGenerateRouteMetaRawTree as ze } from "./helpers/route.mjs";
+import { createStorageWithNamespace as Ye } from "./helpers/storage.mjs";
+import { createUseState as je } from "./helpers/state.mjs";
+import { createUserStore as Je } from "./store/user.mjs";
+import { flatRouteMetaResolveRaw as $e, getRoutePermissionKey as et } from "./utils/router.mjs";
+import { getId as ot } from "./utils/id.mjs";
+import { timeCountDown as at } from "./utils/time.mjs";
+import { useActivated as ft, useActivatedEvent as st, useActivatedExec as lt } from "./hooks/activated.mjs";
+import { useFeelSize as it } from "./hooks/feel-size.mjs";
+import { useMenusDataDispatch as nt } from "./hooks/menus-dispatch.mjs";
+import { useTimeout as dt } from "./hooks/timeout.mjs";
 const c = {
   install(e) {
     e.use(t), e.use(o), e.use(r), e.use(a), e.use(m), e.use(f), e.use(s);
   }
 };
 export {
-  X as APP_API_LIST_MODEL_KEY_CONFIG,
-  _ as ActionButton,
-  T as ActionButtonDanger,
-  C as ActionButtonWarn,
-  Q as AutoRefresh,
-  q as BODY_CONTENT_VIEWPORT_HEIGHT,
-  $ as ConfirmModal,
-  F as DetailModal,
-  te as EXPORT_MAX_LIMIT,
-  fe as FORM_CONFIG_SELECT_ALL_VALUE,
-  pe as FORM_ITEM_CHANGE_LOADING,
-  J as FULLSCREEN_HEIGHT_CHANNEL,
-  R as FormMain,
-  O as FormRadioGroup,
-  Re as FormSearch,
-  D as FormSelect,
-  h as FormTree,
-  b as FormVerifyCode,
-  Oe as FormVerifyImage,
-  v as HeightProvider,
-  De as ListPage,
-  V as MenuItemSub,
-  U as MenuTree,
-  oe as OPERATE_COLUMN_PROP,
-  he as ROUTE_MODULE_LEVEL,
-  Ge as TableMain,
-  He as TabsMain,
-  ye as TabsMainReplaceQueryKey,
-  W as TriggerAutoImport,
-  k as WatchSize,
-  we as countAll,
-  Ke as createGenerateRouteMetaRawTree,
-  Ue as createListApi,
-  ze as createStorageWithNamespace,
-  Ye as createUseState,
+  Q as APP_API_LIST_MODEL_KEY_CONFIG,
+  A as ActionButton,
+  C as ActionButtonDanger,
+  F as ActionButtonWarn,
+  q as AutoRefresh,
+  Z as BODY_CONTENT_VIEWPORT_HEIGHT,
+  te as ConfirmModal,
+  R as DetailModal,
+  re as EXPORT_MAX_LIMIT,
+  le as FORM_CONFIG_SELECT_ALL_VALUE,
+  xe as FORM_ITEM_CHANGE_LOADING,
+  $ as FULLSCREEN_HEIGHT_CHANNEL,
+  O as FormMain,
+  D as FormRadioGroup,
+  Oe as FormSearch,
+  h as FormSelect,
+  b as FormTree,
+  v as FormVerifyCode,
+  De as FormVerifyImage,
+  U as HeightProvider,
+  he as ListPage,
+  w as MenuItemSub,
+  W as MenuTree,
+  ae as OPERATE_COLUMN_PROP,
+  be as ROUTE_MODULE_LEVEL,
+  He as TableMain,
+  Ve as TabsMain,
+  Ge as TabsMainReplaceQueryKey,
+  k as TriggerAutoImport,
+  X as WatchSize,
+  Be as countAll,
+  g as createAdminBridge,
+  ze as createGenerateRouteMetaRawTree,
+  We as createListApi,
+  Ye as createStorageWithNamespace,
+  je as createUseState,
+  Je as createUserStore,
   r as displayInstall,
-  re as exportCSV,
-  Be as fetchListAll,
-  je as flatRouteMetaResolveRaw,
+  me as exportCSV,
+  Ke as fetchListAll,
+  $e as flatRouteMetaResolveRaw,
   t as formInstall,
-  ne as generateFormData,
-  xe as getBlurSubmit,
-  de as getChangeSubmit,
-  se as getConfirmPasswordRule,
-  ce as getDatePickerShortcuts,
-  Ee as getEnterSubmit,
-  Ze as getId,
-  Ie as getPlaceholder,
-  qe as getRoutePermissionKey,
-  _e as getVModelSugar,
+  de as generateFormData,
+  ce as getBlurSubmit,
+  Ee as getChangeSubmit,
+  ue as getConfirmPasswordRule,
+  Ie as getDatePickerShortcuts,
+  ge as getEnterSubmit,
+  ot as getId,
+  _e as getPlaceholder,
+  et as getRoutePermissionKey,
+  Ae as getVModelSugar,
   c as installComponents,
   s as listPageInstall,
   o as menuInstall,
   a as miscInstall,
   m as modalInstall,
-  ge as parseFormData,
-  le as passwordRule,
-  ae as pickExportColumns,
-  Te as resolveFormLayout,
-  ue as setFormComponentType,
-  Ae as setInputComponent,
-  Ce as setSelectComponent,
-  Me as stringifyFormData,
-  Fe as swiftFormItemConfig,
+  Te as parseFormData,
+  ie as passwordRule,
+  fe as pickExportColumns,
+  Ce as resolveFormLayout,
+  pe as setFormComponentType,
+  Me as setInputComponent,
+  Fe as setSelectComponent,
+  Le as stringifyFormData,
+  Re as swiftFormItemConfig,
   f as tableInstall,
-  et as timeCountDown,
-  ot as useActivated,
-  rt as useActivatedEvent,
-  at as useActivatedExec,
-  ft as useFeelSize,
-  lt as useMenusDataDispatch,
-  it as useTimeout
+  at as timeCountDown,
+  ft as useActivated,
+  st as useActivatedEvent,
+  lt as useActivatedExec,
+  it as useFeelSize,
+  nt as useMenusDataDispatch,
+  dt as useTimeout
 };

package/es/store/user.mjs

@@ -0,0 +1,91 @@
+import { defineStore as L } from "pinia";
+import { computed as s, watch as A } from "vue";
+import R from "lodash/get";
+import M from "lodash/set";
+import O from "lodash/cloneDeep";
+import { createUseState as H } from "../helpers/state.mjs";
+import { createGenerateRouteMetaRawTree as K } from "../helpers/route.mjs";
+import { flatRouteMetaResolveRaw as b } from "../utils/router.mjs";
+function Q(S) {
+  const { bridge: o } = S;
+  return L("USER", () => {
+    const T = o.getUserInfoInitFn(), l = o.getUserInfoAccess(), p = (e) => typeof e == "string" ? {
+      get: (t) => R(t, e),
+      set: (t, f) => {
+        const d = O(t);
+        return M(d, e, f), d;
+      }
+    } : { get: e.get, set: e.set }, c = p(l.token), g = p(l.refreshToken), k = (e) => R(e, "permission"), P = o.getAppConfig().APP_CACHE_CONFIG.namespace, n = H(P)(
+      T(),
+      {
+        moduleKey: "USER_STORE",
+        debug: !1,
+        cache: !0
+      }
+    ), r = s(() => n.state), a = s(() => c.get(r.value)), u = s(() => !!a.value), v = s(() => g.get(r.value)), h = s(() => k(r.value) || []), I = K(
+      o.getAppConfig().APP_ROUTER_META_DEFAULT_CONFIG
+    ), y = s(
+      () => I(o.getRoutes(), {
+        // 配置权限且有权限 或 (未配置权限无子路由(即末端子路由) 或 子路由有权限)
+        filterFn: (e, t, f) => e.checkPermission ? h.value.includes(e.permissionKey) : !f || t,
+        sortFn: (e, t) => e.menuSort - t.menuSort
+      })
+    ), U = s(() => b(y.value)), _ = s(() => U.value.map((e) => e.path)), m = () => {
+      n.resetState();
+    }, F = async () => {
+      try {
+        u.value && await o.logoutApi();
+      } catch (e) {
+        console.error("退出登录失败", e);
+      }
+      m();
+    }, w = async (e) => {
+      m();
+      const { data: t } = await o.loginApi(e);
+      n.updateState(t);
+    }, i = async () => {
+      const { data: e } = await o.getUserInfoApi(), t = g.set(
+        c.set(e, a.value),
+        v.value
+      );
+      return n.updateState(t), e;
+    }, E = async () => {
+      const { data: e } = await o.refreshTokenApi({
+        Authorization: v.value
+      });
+      n.updateState(
+        c.set(r.value, e.token)
+      );
+    };
+    o.register({
+      getToken: () => a.value,
+      refreshToken: E,
+      refreshAuth: i
+    });
+    const C = (e) => _.value.includes(e), G = (e) => h.value.includes(e);
+    return A(
+      u,
+      (e, t) => {
+        e && (t ?? i());
+      },
+      {
+        immediate: !0
+      }
+    ), A(a, (e, t) => {
+      e && t && i();
+    }), {
+      userInfo: r,
+      token: a,
+      isLogin: u,
+      login: w,
+      logout: F,
+      noApiLogout: m,
+      getInfo: i,
+      havePermissionByPath: C,
+      havePermissionByKey: G
+    };
+  });
+}
+export {
+  Q as createUserStore
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@done-coding/admin-core",
-  "version": "0.1.3-alpha.0",
+  "version": "0.1.4-alpha.0",
   "description": "后台管理核心",
   "private": false,
   "main": "lib/index.cjs",
@@ -33,7 +33,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://gitee.com/justsosu/done-coding-admin-monorepo",
+    "url": "https://github.com/done-coding/done-coding-admin.git",
     "directory": "packages/core"
   },
   "publishConfig": {
@@ -77,5 +77,5 @@
     "node": ">=18.0.0",
     "pnpm": ">=9.0.0"
   },
-  "gitHead": "6a0147ea0ad6d63c437e30a18ebbe5f47f6d1743"
+  "gitHead": "e53455556dc0b6be614016fc8db37a028ec48986"
 }

package/types/bridge/index.d.ts

@@ -0,0 +1,261 @@
+import { RouteRecordRaw } from 'vue-router';
+
+/**
+ * 认证桥接无状态纯工厂。
+ *
+ * core 模块级零状态——每次调用 `createAdminBridge()` 在函数作用域内新建一组
+ * 闭包变量，返回实例方法闭包持有这组引用。core [MUST NOT] 持已实例化单例
+ * （避免 dist/src 双 module instance 分裂，规避机制见 design §2.3，
+ * 结构上不持单例，[MUST NOT] 用 Symbol.for / globalThis 兜底）。
+ */
+/**
+ * register 入参类型，全字段 optional + 「有值才更新」增量合并。
+ *
+ * #4e 增 4 个增量可选业务 api（loginApi/logoutApi/getUserInfoApi/refreshTokenApi），
+ * 由 `createUserStore` 薄壳侧 register 注入；getToken/refreshToken/refreshAuth 由
+ * `createUserStore` core 工厂 setup 内自 register（裁决 2/3）。
+ */
+export interface AdminBridgeRegisterOptions<UserInfo = unknown, LoginParams = unknown> {
+    /** 取 token（v3 终锁 BR-1 ③ 终裁：零参 facade——core 对 UserInfo 不透明 + 拦截器无 info 源，泛型 `<UserInfo>` 纯透传不沾 getToken 签名） */
+    getToken?: () => string | undefined;
+    /** 跳转登录 */
+    goToLogin?: () => void;
+    /** 刷新 token */
+    refreshToken?: () => Promise<unknown>;
+    /** 刷新鉴权（重新拉取用户信息） */
+    refreshAuth?: () => Promise<unknown>;
+    /** 登录 api（对应 app accountLogin），增量可选 */
+    loginApi?: (params: LoginParams) => Promise<{
+        data: UserInfo;
+    }>;
+    /** 退出登录 api（对应 app accountLogout），增量可选 */
+    logoutApi?: () => Promise<unknown>;
+    /** 取用户信息 api（对应 app getLoginAccountInfo，含 {user_info} wrapper 连壳，见 design D2），增量可选 */
+    getUserInfoApi?: () => Promise<{
+        data: UserInfo;
+    }>;
+    /** 刷新 token api（对应 app refreshAccountToken），增量可选 */
+    refreshTokenApi?: (headers: {
+        Authorization: string;
+    }) => Promise<{
+        data: {
+            token: string;
+        };
+    }>;
+}
+/**
+ * pinia persist storage 适配器最小接口。
+ *
+ * 仅约束 `store/app.ts` persist 适配器实际依赖的三方法，是浏览器 `Storage`
+ * 的结构子集——`createStorageWithNamespace()` 返回的命名空间 Storage 可直接赋值兼容。
+ */
+export interface StorageLike {
+    /** 读取键值，未命中返回 null */
+    getItem: (key: string) => string | null;
+    /** 写入键值 */
+    setItem: (key: string, value: string) => void;
+    /** 删除键值 */
+    removeItem: (key: string) => void;
+}
+/**
+ * 应用主题颜色类型。
+ *
+ * 镜像 app 端 `@/config` `AppThemeColor` 全字段——store/app 的 `theme`
+ * computed 透出后由 app-layout 消费点访问 `primaryColor` 等全字段，故 [MUST]
+ * 完整镜像，[MUST NOT] 收窄到 store/app 体内直接读的子集（否则消费点 TS2339）。
+ */
+export interface AppThemeColor {
+    /** 背景色 */
+    bodyColor: string;
+    /** 基础色 */
+    baseColor: string;
+    /** 主色调 */
+    primaryColor: string;
+    /** 成功色 */
+    successColor: string;
+    /** 警告色 */
+    warningColor: string;
+    /** 危险色 */
+    dangerColor: string;
+    /** 错误色 */
+    errorColor: string;
+    /** 信息色 */
+    infoColor: string;
+}
+/**
+ * `store/app.ts` 实际消费的 app config 子集结构。
+ *
+ * 字段名与层级镜像 app 端 `@/config` 原结构（[MUST NOT] 重命名）；覆盖
+ * store/app 现消费字段（含 `theme` 透出后消费点所需全字段），[MUST NOT] 扩面
+ * 到全量 app config。core 不能 import app，故在此显式定义等价 interface。
+ */
+export interface AppConfig {
+    /** 应用基础信息（store/app 仅取 name） */
+    APP_BASE_INFO: {
+        /** 应用名称 */
+        name: string;
+    };
+    /** 应用布局-header 配置（store/app 仅取 height） */
+    APP_LAYOUT_HEADER_CONFIG: {
+        /** header 高度(px) */
+        height: number;
+    };
+    /** 应用布局-footer 配置（store/app 仅取 height） */
+    APP_LAYOUT_FOOTER_CONFIG: {
+        /** footer 高度(px) */
+        height: number;
+    };
+    /** 应用布局-sidebar 配置（store/app 取 collapseWidth / width） */
+    APP_LAYOUT_SIDEBAR_CONFIG: {
+        /** [展开的]宽度(px) */
+        width: number;
+        /** 折叠起来的宽度(px) */
+        collapseWidth: number;
+    };
+    /** 应用布局-页面主体配置（store/app 仅取 shimPadding） */
+    APP_LAYOUT_BODY_CONFIG: {
+        /** 页面主体 padding - 默认值(px) */
+        shimPadding: number;
+    };
+    /** 应用主题配置（store/app 取 dark / light，各为完整 AppThemeColor） */
+    APP_THEME_CONFIG: {
+        /** 亮色主题 */
+        light: AppThemeColor;
+        /** 暗色主题 */
+        dark: AppThemeColor;
+    };
+    /** 应用路由元信息默认配置（store/app 取 show* 四项；createUserStore 经此取 menuShow/needLogin 默认） */
+    APP_ROUTER_META_DEFAULT_CONFIG: {
+        /** 各路由[未配置情况下]默认是否展示 header */
+        showHeader: boolean;
+        /** 各路由[未配置情况下]默认是否展示 footer */
+        showFooter: boolean;
+        /** 各路由[未配置情况下]默认是否展示 sidebar */
+        showSidebar: boolean;
+        /** 默认是否展示 breadcrumb */
+        showBreadcrumb: boolean;
+        /** 各路由[未配置情况下]默认是否展示在菜单 */
+        menuShow: boolean;
+        /** 各路由[未配置情况下]默认是否需要登录 */
+        needLogin: boolean;
+    };
+    /** 应用缓存配置（#4e additive 第 8 项；createUserStore 经 namespace 实例化 useState） */
+    APP_CACHE_CONFIG: {
+        /** 缓存命名空间 */
+        namespace: string;
+    };
+}
+/**
+ * UserInfo 单字段取写访问器（v3 终锁 Δ0a）。
+ *
+ * 两档形态（解析优先级 `typeof === "string"`）：
+ * - **string 点路径串**（如 `"token"` / `"auth.t"`）：core 内经 `lodash/get` 读、
+ *   `lodash/cloneDeep` then `lodash/set` 写（先 clone 产新对象再 set，不可变，
+ *   1:1 镜像现行 spread 语义；见 design D2-bis）。`UserInfo` 对 core 完全不透明。
+ * - **显式方法档** `{ get, set }`：app 自定取写逻辑（嵌套字段 / 自定义合并），
+ *   `set` [MUST] 产新对象（app 自负不可变，core 不包装、无 lodash 介入）。
+ *
+ * permission [MUST NOT] 入本访问器——core route-permission-tree 经固定约定路径
+ * `"permission"` 读（design D-a 记账，本期维持现状）。
+ */
+export type UserInfoFieldAccess<UserInfo = unknown> = string | {
+    /** 从 userInfo 读取该字段字符串值（未命中返回 undefined） */
+    get: (info: UserInfo) => string | undefined;
+    /** 写入该字段并返回新 userInfo（[MUST] 产新对象不 mutate 入参） */
+    set: (info: UserInfo, v: string | undefined) => UserInfo;
+};
+/**
+ * UserInfo 的 token / refreshToken 双字段访问器集（v3 终锁 Δ0a）。
+ *
+ * 经 `bridge.init({ userInfoAccess })` 注入 → createUserStore 经
+ * `bridge.getUserInfoAccess()` 取，使 core 对 UserInfo token/refreshToken
+ * 字段名零硬编（用户终锁 1/6）。permission **不入此集**（design D-a）。
+ */
+export interface UserInfoAccess<UserInfo = unknown> {
+    /** token 字段访问器（string 点路径串 / 显式 `{get,set}`） */
+    token: UserInfoFieldAccess<UserInfo>;
+    /** refreshToken 字段访问器（string 点路径串 / 显式 `{get,set}`） */
+    refreshToken: UserInfoFieldAccess<UserInfo>;
+}
+/**
+ * `init` 入参类型，全入参均必传（类型层 required，非 optional）。
+ *
+ * `appConfig` 与 `storage` 均为 env-driven、不依赖 core、app pre-Vue 即可备好；
+ * `routes`（#4e additive）为 app 嵌套路由树（带 children），createUserStore 经此算权限树；
+ * `userInfoAccess` / `getUserInfoInitFn`（v3 终锁 Δ0b）为 createUserStore token/refreshToken
+ * 取写 + 用户信息空保底注入面（core 对 UserInfo 不透明，业务 shape 不下沉，规则 8）。
+ */
+export interface AdminBridgeInitOptions<UserInfo = unknown> {
+    /** store/app + createUserStore 消费的 app config 子集（必传） */
+    appConfig: AppConfig;
+    /** pinia persist storage 适配器（必传） */
+    storage: StorageLike;
+    /** app 嵌套路由树（必传，#4e additive；createUserStore 权限树依赖 children 嵌套，[MUST NOT] 传扁平化数据） */
+    routes: RouteRecordRaw[];
+    /** UserInfo token/refreshToken 取写访问器（v3 终锁 Δ0b；createUserStore 经此取写，core 不透明 UserInfo，permission 不入） */
+    userInfoAccess: UserInfoAccess<UserInfo>;
+    /** 用户信息空保底工厂（v3 终锁 Δ0b；恒返非空业务字段默认值对象，createUserStore useState 经此取初值，core 不锁业务 shape） */
+    getUserInfoInitFn: () => UserInfo;
+}
+/**
+ * 认证桥接实例类型。
+ *
+ * 调用侧 4 auth 方法签名与原 app `@/config` facade 完全一致；新增
+ * `init` 启动期一次性注入 + `getAppConfig` / `getStorage` / `getRoutes` post-init 取注册引用。
+ */
+export interface AdminBridge<UserInfo = unknown, LoginParams = unknown> {
+    /**
+     * 启动期一次性注入 appConfig / storage / routes / userInfoAccess / getUserInfoInitFn
+     * （重复调用运行时幂等覆盖，[MUST NOT] throw/warn；v3 终锁 Δ0c：类型层返回
+     * `Omit<AdminBridge,"init">` 防重复 init 误用 + 支持链式，语句式 `bridge.init({...})`
+     * 调用继续合法不强制消费返回值）。
+     */
+    init: (options: AdminBridgeInitOptions<UserInfo>) => Omit<AdminBridge<UserInfo, LoginParams>, "init">;
+    /** 注册 auth fn + 业务 api（增量合并，多次调用就近增量，后注册覆盖前注册） */
+    register: (options: AdminBridgeRegisterOptions<UserInfo, LoginParams>) => void;
+    /** 取 token（v3 终锁 BR-1 ③ 终裁零参；现有无参调用 `bridge.getToken()` 继续合法，泛型 `<UserInfo>` 纯透传不沾本签名） */
+    getToken: () => string | undefined;
+    /** 跳转登录 */
+    goToLogin: () => void;
+    /** 刷新 token */
+    refreshToken: () => Promise<void>;
+    /** 刷新鉴权 */
+    refreshAuth: () => Promise<void>;
+    /** post-init 返回 `init` 注册的 appConfig 引用；pre-init 同步 throw */
+    getAppConfig: () => AppConfig;
+    /** post-init 返回 `init` 注册的 storage 引用；pre-init 同步 throw */
+    getStorage: () => StorageLike;
+    /** post-init 返回 `init` 注册的 routes 引用；pre-init 同步 throw */
+    getRoutes: () => RouteRecordRaw[];
+    /** post-init 返回 `init` 注册的 userInfoAccess 引用；pre-init 同步 throw（v3 终锁 Δ0d，镜像 getRoutes 范式） */
+    getUserInfoAccess: () => UserInfoAccess<UserInfo>;
+    /** post-init 返回 `init` 注册的 getUserInfoInitFn 引用；pre-init 同步 throw（v3 终锁 Δ0d，镜像 getRoutes 范式） */
+    getUserInfoInitFn: () => () => UserInfo;
+    /** 登录 api（createUserStore login 内调；未注册被调同步 throw 原生 Error 前 reject——异步对 reject 原生 Error） */
+    loginApi: (params: LoginParams) => Promise<{
+        data: UserInfo;
+    }>;
+    /** 退出登录 api（createUserStore logout 内调；未注册被调 reject 原生 Error） */
+    logoutApi: () => Promise<unknown>;
+    /** 取用户信息 api（createUserStore getInfo 内调；连壳 {user_info} 见 design D2；未注册被调 reject 原生 Error） */
+    getUserInfoApi: () => Promise<{
+        data: UserInfo;
+    }>;
+    /** 刷新 token api（createUserStore refreshTokenFn 内调；未注册被调 reject 原生 Error） */
+    refreshTokenApi: (headers: {
+        Authorization: string;
+    }) => Promise<{
+        data: {
+            token: string;
+        };
+    }>;
+}
+/**
+ * 认证桥接无状态纯工厂：每次调用返回一个独立的 `AdminBridge` 实例，
+ * 实例状态（appConfig / storage / routes / fn 引用 + initialized 闸）仅存在于
+ * 本次调用的闭包内，工厂自身零状态。
+ *
+ * @example
+ *   const appAdminBridge = createAdminBridge<LoginAccountInfo, AccountLoginParams>();
+ */
+export declare function createAdminBridge<UserInfo = unknown, LoginParams = unknown>(): AdminBridge<UserInfo, LoginParams>;

package/types/hooks/activated.d.ts

@@ -4,14 +4,18 @@ export interface ActivatedInfo {
     triggerType: "mounted" | "activated" | "deactivated" | "unmounted";
 }
 /** 是否激活 */
-export declare const useActivated: () => {
+export declare const useActivated: (watchFn?: (info: ActivatedInfo) => void) => {
     isActivated: globalThis.ComputedRef<boolean>;
     activatedInfo: globalThis.ComputedRef<{
-        isActivated: boolean;
-        triggerType: "mounted" | "activated" | "deactivated" | "unmounted";
+        readonly isActivated: boolean;
+        readonly triggerType: "mounted" | "activated" | "deactivated" | "unmounted";
     }>;
 };
-/** 激活时执行时间 */
+/**
+ * @deprecated 请使用 useActivated 替代
+ * 激活时执行时间 */
 export declare const useActivatedExec: (callback: (info: ActivatedInfo) => void) => void;
-/** 激活时监听事件 */
+/**
+ * @deprecated 请使用 useActivated 替代
+ * 激活时监听事件 */
 export declare const useActivatedEvent: (bind: (info: ActivatedInfo) => void, unbind: (info: ActivatedInfo) => void) => void;

package/types/index.d.ts

@@ -20,5 +20,7 @@ export * from './types';
 export * from './config';
 export * from './inject';
 export * from './helpers';
+export * from './bridge';
+export * from './store';
 export { formInstall, menuInstall, displayInstall, miscInstall, modalInstall, tableInstall, listPageInstall, };
 export declare const installComponents: Plugin;

package/types/store/index.d.ts

@@ -0,0 +1 @@
+export * from './user';

package/types/store/user.d.ts

@@ -0,0 +1,62 @@
+import { ComputedRef } from 'vue';
+import { AdminBridge } from '../bridge';
+import { RoutePermission } from '../types';
+
+/**
+ * createUserStore 工厂依赖（v3 终锁 Δ1：deps 收敛单字段 `{ bridge }`）。
+ *
+ * 业务类型 shape 经泛型 `<UserInfo, LoginParams>` 注入（core 不锁 shape，规则 8）；
+ * 运行时配置 + 注入面全部经 `bridge`——`getAppConfig` / `getRoutes` / 4 业务 api /
+ * `getUserInfoInitFn()`（用户信息空保底工厂，替代 0fd94cc `userInfoInit` deps 字段）/
+ * `getUserInfoAccess()`（token/refreshToken 取写访问器，core 对 UserInfo 不透明）。
+ * permission 不入访问器——core route-permission-tree 经固定约定路径 `"permission"`
+ * 读（用户终锁 4，design D-a 记账）。
+ */
+export interface CreateUserStoreDeps<UserInfo, LoginParams = unknown> {
+    /** app 侧 admin bridge 单例（注入而非 core 持单例，守规则 8；userInfoInit/userInfoAccess 经 bridge.init 注入，本工厂经 bridge.getUserInfoInitFn()/getUserInfoAccess() 读） */
+    bridge: AdminBridge<UserInfo, LoginParams>;
+}
+/**
+ * 用户 store 泛型工厂下沉 core。
+ *
+ * 返回 `defineStore("USER", setup)` 结果（store id 保持 `"USER"`；core 工厂
+ * 无状态，store 实例由 app 侧 pinia 管理，规则 8）。setup 内 1:1 镜像原
+ * `packages/app/src/store/user.ts` 全部运行时行为（actions / computed / watch /
+ * return / 路由权限计算），[MUST NOT] 重构 / 精简 / 调整顺序。
+ *
+ * @example
+ *   export const useUserStore = createUserStore<LoginAccountInfo, AccountLoginParams>({
+ *     bridge: appAdminBridge,
+ *   });
+ */
+export declare function createUserStore<UserInfo, LoginParams = unknown>(deps: CreateUserStoreDeps<UserInfo, LoginParams>): import('pinia').StoreDefinition<"USER", Pick<{
+    userInfo: ComputedRef<UserInfo>;
+    token: ComputedRef<string | undefined>;
+    isLogin: ComputedRef<boolean>;
+    login: (params: LoginParams) => Promise<void>;
+    logout: () => Promise<void>;
+    noApiLogout: () => void;
+    getInfo: () => Promise<UserInfo>;
+    havePermissionByPath: (path: string) => boolean;
+    havePermissionByKey: (key?: RoutePermission["key"]) => boolean;
+}, never>, Pick<{
+    userInfo: ComputedRef<UserInfo>;
+    token: ComputedRef<string | undefined>;
+    isLogin: ComputedRef<boolean>;
+    login: (params: LoginParams) => Promise<void>;
+    logout: () => Promise<void>;
+    noApiLogout: () => void;
+    getInfo: () => Promise<UserInfo>;
+    havePermissionByPath: (path: string) => boolean;
+    havePermissionByKey: (key?: RoutePermission["key"]) => boolean;
+}, "userInfo" | "token" | "isLogin">, Pick<{
+    userInfo: ComputedRef<UserInfo>;
+    token: ComputedRef<string | undefined>;
+    isLogin: ComputedRef<boolean>;
+    login: (params: LoginParams) => Promise<void>;
+    logout: () => Promise<void>;
+    noApiLogout: () => void;
+    getInfo: () => Promise<UserInfo>;
+    havePermissionByPath: (path: string) => boolean;
+    havePermissionByKey: (key?: RoutePermission["key"]) => boolean;
+}, "login" | "logout" | "noApiLogout" | "getInfo" | "havePermissionByPath" | "havePermissionByKey">>;