@done-coding/admin-core 0.8.3-alpha.0 → 0.9.1-alpha.0

package/docs/nested-config-paradigm.md

@@ -0,0 +1,80 @@
+# 配置化嵌套范式（FormMain 套 FormMain / PanelMain 套 PanelMain / 交叉互套）— 实现纪要
+
+> **定位**：**P1/P2/P3 已实现纪要**。本文原为设计提案（design-only），其后 nest 联结组件落地，P1（校验穿透）、P2（Panel 嵌套）、P3（布局 rebase span 值轴）均已实现，**实现走了比初版设想更干净的路**；仅 P3 的**断点选择轴**（容器查询）留后续 opt-in。
+> **实现去向**：4 个联结薄壳（C1 `FormItemNestForm` / C4 `FormItemNestFormList` / C2 `PanelItemNestPanel` / C3 `PanelItemNestForm`）+ 配套 helper（`nestFormItem` / `nestFormItemList` / `nestPanelItem` / `nestPanelForm`）。
+> **上位原则**：KB `paradigm.md` §3.0.1「非顶级子空间挂载薄壳（递归下探二等公民层）」——本文是该范式在 Form/Panel 自嵌套 + 交叉嵌套切片上的工程纪要。
+
+---
+
+## 1. 范式：薄壳即嵌套（已落地）
+
+FormMain / PanelMain **本身没有**「表单套表单 / 面板套面板」的一等 prop 支持，但**也不需要**——两族配置化 item 的渲染出口（`render` / `editorRender`）本就是**开放契约**：返回 `VNode[]` 即可，内容由配置方决定。
+
+> 嵌套 = 在一个 item 的 `render`/`editorRender` 里套一层**薄壳**（联结组件），薄壳内部挂一个**新的配置化容器**（子 FormMain / PanelMain）。只要薄壳对外仍满足父容器对该 item 的契约（值、校验、布局），父容器无感知，嵌套即成立。
+
+三种形态（无界组合，均已落地）：
+- **Form 套 Form**：C1 `FormItemNestForm`（1:1）/ C4 `FormItemNestFormList`（1:N 数组）。
+- **Panel 套 Panel**：C2 `PanelItemNestPanel`（纯展示）。
+- **交叉互套**：C3 `PanelItemNestForm`（Panel 项编辑态内嵌 FormMain）。
+
+> KB 视角的本体定位：联结薄壳 = 把**空间二等公民**（子 FormMain/PanelMain，当不了空间根）适配成满足父 item 契约的可嵌挂载件，**非空间一等公民**。见 `paradigm.md` §3.0.1。
+
+---
+
+## 2. P1 校验穿透 — ✅ 已实现（registry 级联，非初版 validator 桥）
+
+### 实际落地
+
+- **form 族经 registry 级联**：`FormItemNestForm`（C1）/ `FormItemNestFormList`（C4）经 `useNestForm` / `useNestFormList` 把子 `FormMain` 的 `{ validate, clearValidate, resetFields }` 注册进**最近祖先 FormMain** 的 `exposeMap`（`NestFormExposeMap = shallowReactive<Record<itemKey, NestFormExpose>>`，`nest-registry.ts`）。父顶层一次 `validate/clearValidate/resetFields` 即经 `exposeMap` 级联到子（C4 为聚合 expose + fan-out 遍历 N 行）。
+- **对齐 hideKeyList**：父 FormMain `validate` 按 item key 过滤——整 list 被 hide 时不级联（ADR-8）。
+- **panel 族不接 registry**：panel 是 per-item submit、无父顶层 validate，故 C3 `PanelItemNestForm` 改走组件内**局部 `validateChild`**（提交前自校验，reject 留编辑态）；C2 纯展示无校验。
+
+> **与初版提案的差异（求真）**：提案曾设想用 item `rules` 的 async `validator` 作「校验穿透桥」。**实现未采用**——registry/exposeMap 级联更干净（无需把子 formInstance 塞进规则闭包，天然对齐 hideKeyList）。初版 validator 桥设想已废弃，不再保留为方向。
+
+---
+
+## 3. P2 PanelMain 嵌套 — ✅ 已实现
+
+- **展示态**（C2 `PanelItemNestPanel`）：内层 PanelMain 置 `itemCard=false` → 子项平铺（"一项展示多字段"观感，本质潜套 PanelMain）；值贯通 = `render` 的 `scope.value` 嵌套对象只读直供子 PanelMain。
+- **编辑态**（C3 `PanelItemNestForm`）：经 `editorRender`（优先级高于 `editorConfig`，互斥）挂子 FormMain；`PanelEditSwitch` 进编辑深克隆**草稿**，子 FormMain 绑草稿 in-place，校验通过 `submitFn(草稿) → closeEdit` **回流**真实 data，取消弃草稿。这正是「配置式 `editorConfig` 单字段表达不了的多字段子表单」的合规 escape hatch。
+
+---
+
+## 4. P3 嵌套后的布局继承（layout 基于父 item 实际宽而非屏幕）— ✅ 已实现（span 值轴；断点选择轴留 opt-in）
+
+### 落地（2026-06-13）
+
+- 4 联结薄壳现经 `layoutScale` 累乘因子向子 FormMain/PanelMain 传 rebase 因子：`childScale = parentScale × (24 / 父item span)`，子 `resolveFormLayout(span, scale)` 把 span×scale 后 `ceilToTier` 到档集 `{6,8,12,24}`（封顶 24）。**默认开**；helper 加 `rebase?: boolean`（缺省 `true`，`false` = 逆向逃生口原样直透）。
+- 链路：`FormMain`/`PanelMain` 加 prop `layoutScale`（缺省 1）+ provide `NEST_LAYOUT_SCALE_KEY`；薄壳 `useNestLayoutScale` inject 父 scale 叠本层因子；helper 经 `resolveLayoutSpan(layout)` 把父 item 代表 span 传薄壳。
+- 不变量：叶子字段绝对宽 ≈ `(authoredSpan/24) × 屏宽`，与嵌套深度无关。
+- 设计 + worked examples 见 `docs/specs/2026-06-13-045727-moderate-嵌套布局rebase-P3/design.md`。
+
+### 解决的缺口
+
+外层 item 用窄栅格（如父 `span:12` = 半宽容器）时，子字段 `span` 相对**容器**算百分比 → 嵌套层过挤；rebase 按父 item 实际分配宽放大子 span，维持字段绝对宽与顶级一致。
+
+### 已知近似（v1 接受）
+
+- 仅修 **span 值轴**；**断点选择轴**（el 的 `xs/sm/md/lg/xl` 由 **window 宽** media query 选档，非容器宽）留后续 opt-in 容器查询治理。
+- 3+ 层且中间层被 ceil/clamp 时，因子用 authored span 略欠精；2 层常见场景精确。
+
+---
+
+## 5. 状态小结
+
+| # | 缺口 | 状态 | 实际落地 / 遗留 |
+|---|---|---|---|
+| P1 | 校验穿透 | ✅ 已实现 | form 族 registry/exposeMap 级联（C1/C4，ADR-1/8）；panel 族局部 validateChild（C3）/ 无校验（C2）。初版 validator 桥设想已废 |
+| P2 | Panel 嵌套 | ✅ 已实现 | C2 展示（itemCard 平铺）+ C3 编辑（editorRender 挂子 FormMain + 草稿回流） |
+| P3 | 布局继承 rebase | ✅ 已实现（span 值轴） | layoutScale 累乘链 + ceilToTier 档集；断点选择轴留 opt-in 容器查询 |
+
+**遗留边界**：本文不再据 P1/P2/P3 实现展开（已落地，API 见 KB 组件档 + MIGRATION §38）；唯一未做项为 P3 的**断点选择轴**（容器查询替代 viewport 媒体断点），留后续 opt-in spec。
+
+---
+
+## 附：相关源码 / KB 锚点
+
+- 联结薄壳源：`packages/core/src/components/form/{FormItemNestForm,FormItemNestFormList}.vue` + `{nest-form-item,nest-form-item-list}.ts`；`packages/core/src/components/panel/{PanelItemNestPanel,PanelItemNestForm}.vue` + `{nest-panel-item,nest-panel-form}.ts`
+- registry 基建：`packages/core/src/components/form/{nest-registry,use-nest-form,use-nest-form-list}.ts`
+- 上位范式 + 组件 API（KB）：`~/.claude/knowledge/admin-core/paradigm.md` §3.0.1；`components/{FormItemNestForm,FormItemNestFormList,PanelItemNestPanel,PanelItemNestForm}.md`
+- 嵌套三件套实现 spec（含 ADR-1/5/6/8）：`docs/specs/2026-06-12-020608-complex-配置化嵌套联结组件Nest三件套/`

package/es/bridge/config-hook.mjs

@@ -0,0 +1,37 @@
+import { reactive as e, readonly as r } from "vue";
+function s(o) {
+  const c = e(o.APP_BASE_INFO), _ = e(o.APP_LAYOUT_HEADER_CONFIG), A = e(o.APP_LAYOUT_FOOTER_CONFIG), O = e(o.APP_LAYOUT_SIDEBAR_CONFIG), P = e(o.APP_LAYOUT_BREADCRUMB_CONFIG), t = e(o.APP_LAYOUT_BODY_CONFIG), a = e(o.APP_LAYOUT_VIEWPORT_CONFIG), I = e(o.APP_THEME_CONFIG), F = {
+    APP_BASE_INFO: c,
+    APP_LAYOUT_HEADER_CONFIG: _,
+    APP_LAYOUT_FOOTER_CONFIG: A,
+    APP_LAYOUT_SIDEBAR_CONFIG: O,
+    APP_LAYOUT_BREADCRUMB_CONFIG: P,
+    APP_LAYOUT_BODY_CONFIG: t,
+    APP_LAYOUT_VIEWPORT_CONFIG: a,
+    APP_THEME_CONFIG: I
+  }, T = e({
+    header: _,
+    footer: A,
+    sidebar: O,
+    breadcrumb: P,
+    body: t,
+    viewport: a
+  });
+  return {
+    update: (E, B) => {
+      Object.assign(F[E], B);
+    },
+    roBaseInfo: r(c),
+    roHeader: r(_),
+    roFooter: r(A),
+    roSidebar: r(O),
+    roBreadcrumb: r(P),
+    roBody: r(t),
+    roViewport: r(a),
+    roTheme: r(I),
+    roLayout: r(T)
+  };
+}
+export {
+  s as createBridgeConfigHook
+};

package/es/bridge/index.mjs

@@ -1,104 +1,199 @@
-import { createStorageWithNamespace as a } from "./storage.mjs";
-import { createUseState as c } from "./state.mjs";
-import { createGenerateRouteMetaRawTree as o } from "./route.mjs";
-function l(e) {
-  const F = e.APP_CACHE_CONFIG.namespace;
+import { computed as h } from "vue";
+import { createStorageWithNamespace as G } from "./storage.mjs";
+import { createUseState as d } from "./state.mjs";
+import { createGenerateRouteMetaRawTree as l } from "./route.mjs";
+import { createBridgeConfigHook as L } from "./config-hook.mjs";
+import { createBridgePluginHost as B } from "./plugin.mjs";
+import { createBridgeThemeHook as k } from "./theme.mjs";
+import { ADMIN_BRIDGE_KEY as Y } from "../inject/key.mjs";
+function V(r) {
+  const F = r.APP_CACHE_CONFIG.namespace;
   let _;
   F === "" ? (console.error(
     "[adminBridge] APP_CACHE_CONFIG.namespace 为空，已兜底为 'ADMIN_CORE'"
-  ), _ = "ADMIN_CORE") : _ = F, Object.freeze(e);
-  const g = a(_), C = e.routes, u = e.getUserInfoInitFn, N = e.userInfoAccess, i = c(_), R = o(
-    e.APP_ROUTER_META_DEFAULT_CONFIG
-  ), U = Object.freeze({
-    header: e.APP_LAYOUT_HEADER_CONFIG,
-    footer: e.APP_LAYOUT_FOOTER_CONFIG,
-    sidebar: e.APP_LAYOUT_SIDEBAR_CONFIG,
-    breadcrumb: e.APP_LAYOUT_BREADCRUMB_CONFIG,
-    body: e.APP_LAYOUT_BODY_CONFIG
-  });
-  let t, P, n, O, T, I, f, E;
-  const A = (r) => `admin bridge: ${r} 未注册`;
-  return {
-    register(r) {
-      r.getToken && (t = r.getToken), r.goToLogin && (P = r.goToLogin), r.refreshToken && (n = r.refreshToken), r.refreshAuth && (O = r.refreshAuth), r.loginApi && (T = r.loginApi), r.logoutApi && (I = r.logoutApi), r.getUserInfoApi && (f = r.getUserInfoApi), r.refreshTokenApi && (E = r.refreshTokenApi);
+  ), _ = "ADMIN_CORE") : _ = F, Object.freeze(r);
+  const a = G(_), u = r.routes, C = r.getUserInfoInitFn, N = r.userInfoAccess, m = d(_), s = l(
+    r.APP_ROUTER_META_DEFAULT_CONFIG
+  ), t = L({
+    APP_BASE_INFO: r.APP_BASE_INFO,
+    APP_THEME_CONFIG: r.APP_THEME_CONFIG,
+    APP_LAYOUT_HEADER_CONFIG: r.APP_LAYOUT_HEADER_CONFIG,
+    APP_LAYOUT_FOOTER_CONFIG: r.APP_LAYOUT_FOOTER_CONFIG,
+    APP_LAYOUT_SIDEBAR_CONFIG: r.APP_LAYOUT_SIDEBAR_CONFIG,
+    APP_LAYOUT_BREADCRUMB_CONFIG: r.APP_LAYOUT_BREADCRUMB_CONFIG,
+    APP_LAYOUT_BODY_CONFIG: r.APP_LAYOUT_BODY_CONFIG,
+    // viewport 边框：app 可整体不传 / 传部分字段，与核内默认四边 0 浅合并补全
+    // （config-hook reactive 入参 [MUST] 全字段非 undefined，故此处合并而非透传）。
+    APP_LAYOUT_VIEWPORT_CONFIG: {
+      paddingTop: 0,
+      paddingRight: 0,
+      paddingBottom: 0,
+      paddingLeft: 0,
+      ...r.APP_LAYOUT_VIEWPORT_CONFIG
+    }
+  }), P = k({
+    initConfig: r.APP_THEME_CONFIG,
+    update: t.update,
+    storage: a
+  }), c = h(
+    () => P.themeIsDark.value ? t.roTheme.dark : t.roTheme.light
+  );
+  let n, o, O, T, I, i, E, f;
+  const A = (e) => `admin bridge: ${e} 未注册`, R = B(), g = {
+    register(e) {
+      e.getToken && (n = e.getToken), e.goToLogin && (o = e.goToLogin), e.refreshToken && (O = e.refreshToken), e.refreshAuth && (T = e.refreshAuth), e.loginApi && (I = e.loginApi), e.logoutApi && (i = e.logoutApi), e.getUserInfoApi && (E = e.getUserInfoApi), e.refreshTokenApi && (f = e.refreshTokenApi);
     },
     // 已注册返回 undefined 是合法业务态不 throw
     // v3 终锁 Δ8b：零参 facade（BR-1 ③ 终裁——core 对 UserInfo 不透明 + 拦截器无 info 源）
     getToken() {
-      if (!t) throw new Error(A("getToken"));
-      return t();
+      if (!n) throw new Error(A("getToken"));
+      return n();
     },
     goToLogin() {
-      if (!P) throw new Error(A("goToLogin"));
-      P();
+      if (!o) throw new Error(A("goToLogin"));
+      o();
     },
     // 异步对：未注册才返回 rejected Promise（既有降级语义保留）。
     refreshToken() {
-      return n ? n().then(() => {
+      return O ? O().then(() => {
       }) : Promise.reject(new Error(A("refreshToken")));
     },
     refreshAuth() {
-      return O ? O().then(() => {
+      return T ? T().then(() => {
       }) : Promise.reject(new Error(A("refreshAuth")));
     },
     getStorage() {
-      return g;
+      return a;
     },
     getRoutes() {
-      return C;
+      return u;
     },
     getUserInfoInitFn() {
-      return u;
+      return C;
     },
-    useState: i,
-    generateRouteMetaRawTree: R,
+    useState: m,
+    generateRouteMetaRawTree: s,
     // ============ #2.5 期 12 readonly 属性值挂载（per ADR-1 sibling pattern 复用 useState / generateRouteMetaRawTree） ============
-    /** 应用基础信息（per #2.5 期 REQ-1 直接挂载形态） */
-    APP_BASE_INFO: e.APP_BASE_INFO,
+    // 插件系统一期：本期 7 字段（BASE_INFO / 5 布局子 / THEME）+ APP_LAYOUT_CONFIG
+    // 改挂 configHook 的 readonly(reactive()) 响应式只读视图——经 bridge.update 跟随。
+    /**
+     * 应用基础信息（**响应式只读视图**，插件系统一期改）。
+     *
+     * 现为 vue `readonly(reactive(...))` 包裹——经 `bridge.update("APP_BASE_INFO", partial)`
+     * 更新后本属性自动跟随。[SHOULD] 在 `computed` / 响应式上下文中读取，[MUST NOT]
+     * 解构或一次性快照取值（`const x = bridge.APP_BASE_INFO.foo` ⚠️ 快照定格，update 后不变）。
+     */
+    APP_BASE_INFO: t.roBaseInfo,
     /** 应用环境信息（per #2.5 期 REQ-1） */
-    APP_ENV_INFO: e.APP_ENV_INFO,
+    APP_ENV_INFO: r.APP_ENV_INFO,
     /** 应用缓存配置（per #2.5 期 REQ-1） */
-    APP_CACHE_CONFIG: e.APP_CACHE_CONFIG,
-    /** 应用布局-header 配置（per #2.5 期 REQ-1） */
-    APP_LAYOUT_HEADER_CONFIG: e.APP_LAYOUT_HEADER_CONFIG,
-    /** 应用布局-footer 配置（per #2.5 期 REQ-1） */
-    APP_LAYOUT_FOOTER_CONFIG: e.APP_LAYOUT_FOOTER_CONFIG,
-    /** 应用布局-sidebar 配置（per #2.5 期 REQ-1） */
-    APP_LAYOUT_SIDEBAR_CONFIG: e.APP_LAYOUT_SIDEBAR_CONFIG,
-    /** 应用布局-面包屑配置（per #2.5 期 REQ-1） */
-    APP_LAYOUT_BREADCRUMB_CONFIG: e.APP_LAYOUT_BREADCRUMB_CONFIG,
-    /** 应用布局-页面主体配置（per #2.5 期 REQ-1） */
-    APP_LAYOUT_BODY_CONFIG: e.APP_LAYOUT_BODY_CONFIG,
-    /** 应用布局聚合配置（per #2.5 期 ADR-3 bridge 内部聚合派生） */
-    APP_LAYOUT_CONFIG: U,
+    APP_CACHE_CONFIG: r.APP_CACHE_CONFIG,
+    /**
+     * 应用布局-header 配置（**响应式只读视图**，插件系统一期改）。
+     *
+     * `readonly(reactive(...))` 包裹——`bridge.update("APP_LAYOUT_HEADER_CONFIG", partial)`
+     * 后自动跟随。[SHOULD] 响应式上下文 / `computed` 读取，[MUST NOT] 解构/快照（⚠️ 定格）。
+     */
+    APP_LAYOUT_HEADER_CONFIG: t.roHeader,
+    /**
+     * 应用布局-footer 配置（**响应式只读视图**，插件系统一期改）。
+     *
+     * `readonly(reactive(...))`——`bridge.update("APP_LAYOUT_FOOTER_CONFIG", partial)`
+     * 后跟随。[SHOULD] 响应式上下文读取，[MUST NOT] 解构/快照（⚠️ 定格）。
+     */
+    APP_LAYOUT_FOOTER_CONFIG: t.roFooter,
+    /**
+     * 应用布局-sidebar 配置（**响应式只读视图**，插件系统一期改）。
+     *
+     * `readonly(reactive(...))`——`bridge.update("APP_LAYOUT_SIDEBAR_CONFIG", partial)`
+     * 后跟随（一级浅合并，传 `{width}` 保留 `collapseWidth`）。[SHOULD] 响应式上下文
+     * 读取，[MUST NOT] 解构/快照（⚠️ 定格）。
+     */
+    APP_LAYOUT_SIDEBAR_CONFIG: t.roSidebar,
+    /**
+     * 应用布局-面包屑配置（**响应式只读视图**，插件系统一期改）。
+     *
+     * `readonly(reactive(...))`——`bridge.update("APP_LAYOUT_BREADCRUMB_CONFIG", partial)`
+     * 后跟随。[SHOULD] 响应式上下文读取，[MUST NOT] 解构/快照（⚠️ 定格）。
+     */
+    APP_LAYOUT_BREADCRUMB_CONFIG: t.roBreadcrumb,
+    /**
+     * 应用布局-页面主体配置（**响应式只读视图**，插件系统一期改）。
+     *
+     * `readonly(reactive(...))`——`bridge.update("APP_LAYOUT_BODY_CONFIG", partial)`
+     * 后跟随。[SHOULD] 响应式上下文读取，[MUST NOT] 解构/快照（⚠️ 定格）。
+     */
+    APP_LAYOUT_BODY_CONFIG: t.roBody,
+    /**
+     * 应用布局-视口边框配置（**响应式只读视图**）。
+     *
+     * `readonly(reactive(...))`——`bridge.update("APP_LAYOUT_VIEWPORT_CONFIG", partial)`
+     * 后跟随（一级浅合并，传 `{paddingTop}` 保留其余三边）。store/app 经此派生 viewport
+     * padding 给 Header/Sidebar fixed 锚点 + AppBody calc。[MUST NOT] 解构/快照（⚠️ 定格）。
+     */
+    APP_LAYOUT_VIEWPORT_CONFIG: t.roViewport,
+    /**
+     * 应用布局聚合配置（**响应式只读视图**，插件系统一期改）。
+     *
+     * 聚合 5 子布局配置的响应式只读视图；5 子任一 `update` 后本聚合的对应子字段跟随。
+     * `readonly(reactive({header, footer, sidebar, breadcrumb, body}))`——不再是
+     * `Object.freeze` 静态聚合。[SHOULD] 响应式上下文读取，[MUST NOT] 解构/快照（⚠️ 定格）。
+     */
+    APP_LAYOUT_CONFIG: t.roLayout,
     /** 应用路由元信息默认配置（per #2.5 期 REQ-1） */
-    APP_ROUTER_META_DEFAULT_CONFIG: e.APP_ROUTER_META_DEFAULT_CONFIG,
+    APP_ROUTER_META_DEFAULT_CONFIG: r.APP_ROUTER_META_DEFAULT_CONFIG,
     /** 应用路由配置（per #2.5 期 REQ-1） */
-    APP_ROUTER_CONFIG: e.APP_ROUTER_CONFIG,
+    APP_ROUTER_CONFIG: r.APP_ROUTER_CONFIG,
     /** 应用路由路径配置（per #7.3 期 readonly 挂载） */
-    APP_ROUTER_PATHS_CONFIG: e.APP_ROUTER_PATHS_CONFIG,
-    /** 应用主题配置（per #2.5 期 REQ-1） */
-    APP_THEME_CONFIG: e.APP_THEME_CONFIG,
+    APP_ROUTER_PATHS_CONFIG: r.APP_ROUTER_PATHS_CONFIG,
+    /**
+     * 应用主题配置（**响应式只读视图**，插件系统一期改）。
+     *
+     * `readonly(reactive(...))`——`bridge.update("APP_THEME_CONFIG", {light: newLight})`
+     * 一级浅合并整体替换 `light`、保留 `dark`，后自动跟随。[SHOULD] 响应式上下文读取，
+     * [MUST NOT] 解构/快照（⚠️ 定格）。
+     */
+    APP_THEME_CONFIG: t.roTheme,
+    /** 主题模块（架构反转：风格切换真相源在 bridge；插件经 theme.add 注册风格） */
+    theme: P.theme,
+    /** 当前风格名（响应式只读真相源） */
+    themeStyle: P.themeStyle,
+    /** 是否暗色（响应式只读真相源；appStore / 挂值 composable 读此） */
+    themeIsDark: P.themeIsDark,
+    /** 当前生效 JS 主题色（输出 B；MenuTree/布局直读、appStore.theme 转发） */
+    themeColors: c,
     /** 用户信息字段访问器集（第一宪法：业务注入 get/set 读写 token/refreshToken/permission） */
     userInfoAccess: N,
+    // 插件系统一期：update（REQ-1）+ install（REQ-9）挂载。
+    // install 箭头函数闭包引用 bridgeInstance（[MUST NOT] 用 this——strict
+    // noImplicitThis）；provide 整 bridge 自身；零单例（[MUST NOT] globalThis/模块级缓存）。
+    update: t.update,
+    use: (e, U) => R.use({
+      bridge: g,
+      update: t.update,
+      plugin: e,
+      options: U
+    }),
+    install: (e) => (e.provide(Y, g), e),
     // 异步对：未注册返回 rejected 原生 Error（#4a-2 per-method 降级）
-    loginApi(r) {
-      return T ? T(r) : Promise.reject(new Error(A("loginApi")));
+    loginApi(e) {
+      return I ? I(e) : Promise.reject(new Error(A("loginApi")));
     },
     logoutApi() {
-      return I ? I() : Promise.reject(new Error(A("logoutApi")));
+      return i ? i() : Promise.reject(new Error(A("logoutApi")));
     },
     getUserInfoApi() {
-      return f ? f() : Promise.reject(new Error(A("getUserInfoApi")));
+      return E ? E() : Promise.reject(new Error(A("getUserInfoApi")));
     },
-    refreshTokenApi(r) {
-      return E ? E(r) : Promise.reject(new Error(A("refreshTokenApi")));
+    refreshTokenApi(e) {
+      return f ? f(e) : Promise.reject(new Error(A("refreshTokenApi")));
     }
   };
+  return g;
 }
 export {
-  l as createAdminBridge,
-  o as createGenerateRouteMetaRawTree,
-  a as createStorageWithNamespace,
-  c as createUseState
+  V as createAdminBridge,
+  l as createGenerateRouteMetaRawTree,
+  G as createStorageWithNamespace,
+  d as createUseState
 };

package/es/bridge/plugin.mjs

@@ -0,0 +1,29 @@
+import f from "lodash/omit";
+function d() {
+  const i = /* @__PURE__ */ new WeakSet(), o = /* @__PURE__ */ new Set();
+  return { use: (u) => {
+    const { bridge: t, update: l, plugin: n, options: g } = u, s = n, r = typeof n == "function" ? n : n.install, e = typeof n == "function" ? void 0 : n.name;
+    if (typeof r != "function")
+      throw new Error("admin bridge plugin: install must be a function");
+    if (i.has(s) || e && o.has(e))
+      return t;
+    const a = f(t, [
+      "init",
+      "register",
+      "getToken",
+      "goToLogin",
+      "refreshToken",
+      "refreshAuth",
+      "loginApi",
+      "logoutApi",
+      "getUserInfoApi",
+      "refreshTokenApi",
+      "use",
+      "install"
+    ]);
+    return r({ bridge: a, update: l }, g), i.add(s), e && o.add(e), t;
+  } };
+}
+export {
+  d as createBridgePluginHost
+};

package/es/bridge/theme.mjs

@@ -0,0 +1,65 @@
+import { ref as f, readonly as d } from "vue";
+const o = "default", E = "默认", b = "admin-core-theme", I = (t) => ({
+  light: { ...t.light },
+  dark: { ...t.dark }
+}), A = (t, c) => {
+  const r = t.getItem(c);
+  if (!r) return null;
+  try {
+    const s = JSON.parse(r);
+    return s && typeof s == "object" ? s : null;
+  } catch {
+    return null;
+  }
+};
+function _(t) {
+  const c = t.storageKey ?? b, r = /* @__PURE__ */ new Map(), s = f(o), u = f(!1), g = f([]), n = f({});
+  let i = o;
+  const a = A(t.storage, c);
+  a && (typeof a.themeStyle == "string" && a.themeStyle && (i = a.themeStyle), typeof a.themeIsDark == "boolean" && (u.value = a.themeIsDark));
+  const h = () => {
+    t.storage.setItem(
+      c,
+      JSON.stringify({
+        themeStyle: s.value,
+        themeIsDark: u.value
+      })
+    );
+  }, v = () => {
+    g.value = Array.from(r.keys());
+  }, m = (e) => {
+    t.update("APP_THEME_CONFIG", { light: e.light, dark: e.dark });
+  }, y = (e) => {
+    const l = r.get(e);
+    if (!l) {
+      const k = r.get(o);
+      if (!k) return;
+      m(k), s.value = o, h();
+      return;
+    }
+    m(l), s.value = e, h();
+  }, S = (e) => {
+    u.value = !!e, h();
+  }, p = (e, l) => {
+    r.set(e, I(l.config)), n.value = { ...n.value, [e]: l.label ?? e }, v(), e === i && s.value !== i && y(e);
+  }, L = (e) => {
+    if (e === o || !r.delete(e)) return;
+    const l = { ...n.value };
+    delete l[e], n.value = l, v(), s.value === e && y(o);
+  }, D = (e) => n.value[e] ?? e;
+  return p(o, { config: t.initConfig, label: E }), {
+    theme: {
+      add: p,
+      remove: L,
+      setStyle: y,
+      setDark: S,
+      list: d(g),
+      labelOf: D
+    },
+    themeStyle: d(s),
+    themeIsDark: d(u)
+  };
+}
+export {
+  _ as createBridgeThemeHook
+};

package/es/components/app-layout/AppBody.vue.mjs

@@ -1,7 +1,7 @@
 import o from "./AppBody.vue2.mjs";
 /* empty css              */
 import p from "../../_virtual/_plugin-vue_export-helper.mjs";
-const m = /* @__PURE__ */ p(o, [["__scopeId", "data-v-265945fd"]]);
+const m = /* @__PURE__ */ p(o, [["__scopeId", "data-v-ae442089"]]);
 export {
   m as default
 };

package/es/components/app-layout/AppBody.vue2.mjs

@@ -1,87 +1,85 @@
-import { ElAffix as V } from "element-plus/es";
-import "element-plus/es/components/base/style/css";
-import "element-plus/es/components/affix/style/css";
-import { defineComponent as F, useCssVars as N, unref as t, inject as v, ref as A, provide as H, computed as o, watch as I, resolveComponent as U, openBlock as i, createElementBlock as Y, normalizeStyle as E, createElementVNode as k, createBlock as s, withCtx as b, createVNode as P, createCommentVNode as a, KeepAlive as G, resolveDynamicComponent as w, renderSlot as D } from "vue";
-import $ from "./AppBreadcrumb.vue.mjs";
-import z from "lodash/debounce";
-import { APP_LAYOUT_APP_STORE_KEY as K, APP_LAYOUT_BRIDGE_KEY as M, BODY_CONTENT_VIEWPORT_HEIGHT as j } from "../../inject/key.mjs";
-import { useActivatedExec as W, useActivatedEvent as q } from "../../hooks/activated.mjs";
-const re = /* @__PURE__ */ F({
+import { defineComponent as T, useCssVars as V, inject as _, ref as h, computed as t, provide as L, watch as F, resolveComponent as H, openBlock as n, createElementBlock as N, normalizeStyle as A, createElementVNode as I, createBlock as r, unref as E, withCtx as b, createVNode as w, createCommentVNode as a, KeepAlive as k, resolveDynamicComponent as S, renderSlot as U } from "vue";
+import { ElAffix as Y } from "element-plus";
+import G from "./AppBreadcrumb.vue.mjs";
+import $ from "lodash/debounce";
+import { APP_LAYOUT_APP_STORE_KEY as D, APP_LAYOUT_BRIDGE_KEY as z, BODY_CONTENT_VIEWPORT_HEIGHT as K } from "../../inject/key.mjs";
+import { useActivatedExec as M, useActivatedEvent as j } from "../../hooks/activated.mjs";
+const te = /* @__PURE__ */ T({
   __name: "AppBody",
   props: {
     menuFlatList: { default: () => [] }
   },
-  setup(S) {
-    N((e) => ({
-      ba2eb370: t(l)
+  setup(P) {
+    V((e) => ({
+      ae6fc168: s.value
     }));
-    const n = v(K), c = v(M), x = c.APP_LAYOUT_BREADCRUMB_CONFIG, C = c.APP_ROUTER_CONFIG, d = A(!1), m = x.height, u = A(0);
-    H(j, u);
-    const g = o(() => n.bodyShimPadding), p = o(() => n.bodyShimStyle), O = o(() => n.bodyStyle), f = o(() => n.showBreadcrumb), B = o(() => parseFloat(`${n.bodyStyle.paddingTop ?? 0}`) || 0), l = o(
-      () => `calc(${p.value.minHeight} - ${f.value && d.value ? m : 0}px - ${g.value * 2}px)`
-    ), R = (e) => {
-      d.value = e;
-    }, r = z(() => {
+    const o = _(D), l = _(z), g = l.APP_ROUTER_CONFIG, c = h(!1), u = t(() => l.APP_LAYOUT_BREADCRUMB_CONFIG.height), d = h(0);
+    L(K, d);
+    const x = t(() => o.bodyShimPadding), m = t(() => o.bodyShimStyle), C = t(() => o.bodyStyle), p = t(() => o.showBreadcrumb), O = t(() => parseFloat(`${o.bodyStyle.paddingTop ?? 0}`) || 0), s = t(
+      () => `calc(${m.value.minHeight} - ${p.value && c.value ? u.value : 0}px - ${x.value * 2}px)`
+    ), B = (e) => {
+      c.value = e;
+    }, i = $(() => {
       const e = document.createElement("div");
-      e.style.height = l.value, e.style.position = "fixed", e.style.left = "100%", e.style.top = "100%", e.style.opacity = "0", e.style.pointerEvents = "none", document.body.appendChild(e), u.value = e.clientHeight, e.remove();
+      e.style.height = s.value, e.style.position = "fixed", e.style.left = "100%", e.style.top = "100%", e.style.opacity = "0", e.style.pointerEvents = "none", document.body.appendChild(e), d.value = e.clientHeight, e.remove();
     }, 16);
-    return W(() => {
-      r();
-    }), q(
+    return M(() => {
+      i();
+    }), j(
       () => {
-        window.addEventListener("resize", r);
+        window.addEventListener("resize", i);
       },
       () => {
-        window.removeEventListener("resize", r);
+        window.removeEventListener("resize", i);
       }
-    ), I(l, () => {
-      r();
-    }), (e, J) => {
-      const T = V, L = U("RouterView");
-      return i(), Y("div", {
+    ), F(s, () => {
+      i();
+    }), (e, W) => {
+      const R = H("RouterView");
+      return n(), N("div", {
         class: "app-body",
-        style: E(t(O))
+        style: A(C.value)
       }, [
-        k("div", {
+        I("div", {
           class: "app-body-shim",
-          style: E(t(p))
+          style: A(m.value)
         }, [
-          t(f) ? (i(), s(T, {
+          p.value ? (n(), r(E(Y), {
             key: 0,
-            offset: t(B)
+            offset: O.value
           }, {
             default: b(() => [
-              P($, {
-                height: t(m),
-                menuFlatList: S.menuFlatList,
-                onShow: R
+              w(G, {
+                height: u.value,
+                menuFlatList: P.menuFlatList,
+                onShow: B
               }, null, 8, ["height", "menuFlatList"])
             ]),
             _: 1
           }, 8, ["offset"])) : a("", !0),
-          P(L, null, {
+          w(R, null, {
             default: b(({
-              Component: _,
+              Component: f,
               route: {
-                path: y,
-                meta: { keepAlive: h }
+                path: v,
+                meta: { keepAlive: y }
               }
             }) => [
-              (i(), s(G, {
-                max: t(C).keepAliveMaxCount
+              (n(), r(k, {
+                max: E(g).keepAliveMaxCount
               }, [
-                h ? (i(), s(w(_), { key: y })) : a("", !0)
+                y ? (n(), r(S(f), { key: v })) : a("", !0)
               ], 1032, ["max"])),
-              h ? a("", !0) : (i(), s(w(_), { key: y }))
+              y ? a("", !0) : (n(), r(S(f), { key: v }))
             ]),
             _: 1
           })
         ], 4),
-        D(e.$slots, "footer", {}, void 0, !0)
+        U(e.$slots, "footer", {}, void 0, !0)
       ], 4);
     };
   }
 });
 export {
-  re as default
+  te as default
 };

package/es/components/app-layout/AppBreadcrumb.vue.mjs

@@ -1,7 +1,7 @@
 import o from "./AppBreadcrumb.vue2.mjs";
 /* empty css                    */
 import r from "../../_virtual/_plugin-vue_export-helper.mjs";
-const a = /* @__PURE__ */ r(o, [["__scopeId", "data-v-2f677890"]]);
+const a = /* @__PURE__ */ r(o, [["__scopeId", "data-v-9bbe0b05"]]);
 export {
   a as default
 };