@done-coding/admin-core 0.18.0 → 0.19.0

package/README.md

@@ -1 +1,77 @@
-内部维护，暂无公开文档。
+# @done-coding/admin-core
+
+面向多形态应用的**配置化前端框架核心**：表单 / 列表 / 表格 / 弹窗 / 面板 / 布局组件族 + hooks + bridge 接线中枢。既能搭后台管理台，也能搭面向终端用户的应用（AI 应用台、创作/对话类产品）。
+
+核心范式：**配置驱动**——组件消费配置对象（`FormItemConfig` / `TableColumnProps` / `PanelItemConfig`…）而非散装 props/插槽；**万物皆表单、万物皆 Nest 递归组合**（嵌套子表单/子面板不手写 HTML）。
+
+> 完整可运行示例见 `apps/reference`（范式项目）：路由与目录逐字同构（`/list-page/guide` ↔ `pages/list-page/guide/`），每个组件族都有最佳实践（guide）/ 完整功能（showcase）页面。
+
+## 安装
+
+```bash
+pnpm add @done-coding/admin-core
+```
+
+**样式必须显式引入**（SFC scoped CSS 被抽取到独立 `style.css`，漏引会导致 scoped 选择器失效、布局塌陷）：
+
+```ts
+import "@done-coding/admin-core/style.css";
+```
+
+peer 依赖需消费方自装：`vue` / `vue-router` / `pinia` / `pinia-plugin-persistedstate` / `element-plus` / `@element-plus/icons-vue` / `lodash` / `@done-coding/request-axios`
+
+## 快速开始（三件套）
+
+```ts
+// ① 实例化 bridge（接线中枢：认证 / 布局 / 主题 / 路由派生）
+// 参考 apps/reference/src/config/bridge.ts
+const appCoreBridge = createCoreBridge({ ... });
+
+// ② 组装 AppLayout（全局布局根，provide 全部契约）
+// 参考 apps/reference/src/App.vue
+<AppLayout :bridge="appCoreBridge" :app-store="appStore" :user-store="userStore">
+  <template #brand>...</template>
+  <template #userEntry>...</template>
+  <template #aside>...</template>
+</AppLayout>
+
+// ③ 页面用组件族（范式：AppPage 容器 + ListPage/FormMain/PanelMain 三主件）
+// 参考 apps/reference/src/pages/list-page/guide/
+<AppPage>
+  <ListPage :list="searchFormList" :columns="columns" row-key="id" :api="listApi" />
+</AppPage>
+```
+
+## 组件族索引
+
+| 族 | 组件 | 文档 |
+| --- | --- | --- |
+| form 表单族 | FormMain / FormSearch / FormSubmitBtn / FormSubmitPanel / FormItemNestForm / FormItemNestFormList / FormSelect / FormRadioGroup / FormTree / FormVerifyImage / FormVerifyCode | [README](./src/components/form/README.md) 等 |
+| list-page 列表族 | ListPage（FormSearch + TableMain 组合页） | [README](./src/components/list-page/README.md) |
+| table 表格族 | TableMain | [README](./src/components/table/README.md) |
+| modal 弹窗族 | ModalConfirm / ModalForm / ModalDetail / ModalShelf / ModalPorter | [README](./src/components/modal/README.md) 等 |
+| panel 面板族 | PanelMain / PanelItem / PanelEditSwitch / PanelItemNestPanel / PanelItemNestForm | [README](./src/components/panel/README.md) |
+| display 展示族 | TabsMain / ActionBtn / ActionBtnGroup / ActionConfirm / WatchSize / HeightProvider / BooleanTag | [README](./src/components/display/README.md) 等 |
+| app-layout 布局族 | AppLayout / AppPage / AppBody / AppHeader / AppSidebar / AppAside / AppBreadcrumb / AppFooter / AppTheme / AppCollapseToggle | 族引导见 [components/README](./src/components/README.md) |
+| menu 菜单族 | MenuTree / MenuItemSub | 同上 |
+| slot-layout 插槽布局族 | SlotLayoutTemplate / SlotLayoutFlowAside | 同上 |
+| data-view 数据视图族 | DataListView / DataListViewItem（TableMain 内部件，customView 模式） | 同上 |
+| misc 杂项族 | AutoRefresh / AutoRefreshGroup / SelectModule / TriggerAutoRefresh | 同上 |
+
+## 模块索引
+
+| 模块 | 说明 | 文档 |
+| --- | --- | --- |
+| bridge | `createCoreBridge` 接线中枢：auth / 布局 / 主题 / 路由派生 + 响应式配置视图 | [README](./src/bridge/README.md) |
+| hooks | useActivated / useFeelSize / useBreakpoint / useCustomBreakpoint / useObserveSize / useChannelViewportHeight / useCoreThemeApply / useCoreViewportApply / useMenusDataDispatch / useTimeout | [README](./src/hooks/README.md) |
+| store | createAppStore / createUserStore / router-permission pinia 工厂 | 见 reference `src/store/` 实例化 |
+| inject | 跨包 Symbol 契约（SCOPE_VIEWPORT_MAX_HEIGHT / CORE_BRIDGE_KEY / FORM_NEST_REGISTRY_KEY 等） | 见各组件文档「高度链」相关段落 |
+| config | APP_API_LIST_MODEL_KEY_CONFIG（列表接口模型）/ ROUTE_MODULE_LEVEL / TabsMainReplaceQueryKey | — |
+| types / utils / router | 路由元类型 / 通用工具（time/id/dom/router/export/theme-scale）/ withGroupRedirect | — |
+
+## 文档约定
+
+- 组件文档命名 `README-<PascalName>.md`，位于组件族目录内；`src/**/README*.md` 随 npm 包发布
+- 每个组件文档结构：定位 → 快速上手（最佳实践）→ API（props/emits/slots/expose）→ 反模式/注意 → 关联
+- 完整可运行范式页见 `apps/reference`：`<族>/guide`（最佳实践）、`<族>/showcase`（完整功能）、其余功能语义名
+- API 以 `packages/core/src/**/types.ts` 与组件源码为真相源；文档与其冲突时以源码为准

package/es/_virtual/_plugin-vue_export-helper.mjs

@@ -1,9 +1,10 @@
-const s = (t, e) => {
-  const o = t.__vccOpts || t;
-  for (const [r, c] of e)
-    o[r] = c;
-  return o;
+const _export_sfc = (sfc, props) => {
+  const target = sfc.__vccOpts || sfc;
+  for (const [key, val] of props) {
+    target[key] = val;
+  }
+  return target;
 };
 export {
-  s as default
+  _export_sfc as default
 };

package/es/bridge/config-hook.mjs

@@ -1,43 +1,55 @@
-import { reactive as e, readonly as _ } from "vue";
-function U(A) {
-  const F = e(A.APP_BASE_INFO), r = e(A.APP_LAYOUT_HEADER_CONFIG), o = e(A.APP_LAYOUT_FOOTER_CONFIG), O = e(A.APP_LAYOUT_SIDEBAR_CONFIG), P = e(A.APP_LAYOUT_ASIDE_CONFIG), a = e(A.APP_LAYOUT_BREADCRUMB_CONFIG), t = e(A.APP_LAYOUT_BODY_CONFIG), c = e(A.APP_LAYOUT_VIEWPORT_CONFIG), I = e(A.APP_LAYOUT_GAP_CONFIG), T = e(A.APP_THEME_CONFIG), G = {
-    APP_BASE_INFO: F,
-    APP_LAYOUT_HEADER_CONFIG: r,
-    APP_LAYOUT_FOOTER_CONFIG: o,
-    APP_LAYOUT_SIDEBAR_CONFIG: O,
-    APP_LAYOUT_ASIDE_CONFIG: P,
-    APP_LAYOUT_BREADCRUMB_CONFIG: a,
-    APP_LAYOUT_BODY_CONFIG: t,
-    APP_LAYOUT_VIEWPORT_CONFIG: c,
-    APP_LAYOUT_GAP_CONFIG: I,
-    APP_THEME_CONFIG: T
-  }, s = e({
-    header: r,
-    footer: o,
-    sidebar: O,
-    aside: P,
-    breadcrumb: a,
-    body: t,
-    viewport: c,
-    gap: I
+import { reactive, readonly } from "vue";
+function createBridgeConfigHook(init) {
+  const reactiveBaseInfo = reactive(init.APP_BASE_INFO);
+  const reactiveHeader = reactive(init.APP_LAYOUT_HEADER_CONFIG);
+  const reactiveFooter = reactive(init.APP_LAYOUT_FOOTER_CONFIG);
+  const reactiveSidebar = reactive(init.APP_LAYOUT_SIDEBAR_CONFIG);
+  const reactiveAside = reactive(init.APP_LAYOUT_ASIDE_CONFIG);
+  const reactiveBreadcrumb = reactive(init.APP_LAYOUT_BREADCRUMB_CONFIG);
+  const reactiveBody = reactive(init.APP_LAYOUT_BODY_CONFIG);
+  const reactiveViewport = reactive(init.APP_LAYOUT_VIEWPORT_CONFIG);
+  const reactiveGap = reactive(init.APP_LAYOUT_GAP_CONFIG);
+  const reactiveTheme = reactive(init.APP_THEME_CONFIG);
+  const reactiveMap = {
+    APP_BASE_INFO: reactiveBaseInfo,
+    APP_LAYOUT_HEADER_CONFIG: reactiveHeader,
+    APP_LAYOUT_FOOTER_CONFIG: reactiveFooter,
+    APP_LAYOUT_SIDEBAR_CONFIG: reactiveSidebar,
+    APP_LAYOUT_ASIDE_CONFIG: reactiveAside,
+    APP_LAYOUT_BREADCRUMB_CONFIG: reactiveBreadcrumb,
+    APP_LAYOUT_BODY_CONFIG: reactiveBody,
+    APP_LAYOUT_VIEWPORT_CONFIG: reactiveViewport,
+    APP_LAYOUT_GAP_CONFIG: reactiveGap,
+    APP_THEME_CONFIG: reactiveTheme
+  };
+  const layoutAggregate = reactive({
+    header: reactiveHeader,
+    footer: reactiveFooter,
+    sidebar: reactiveSidebar,
+    aside: reactiveAside,
+    breadcrumb: reactiveBreadcrumb,
+    body: reactiveBody,
+    viewport: reactiveViewport,
+    gap: reactiveGap
   });
+  const update = (key, partial) => {
+    Object.assign(reactiveMap[key], partial);
+  };
   return {
-    update: (C, E) => {
-      Object.assign(G[C], E);
-    },
-    roBaseInfo: _(F),
-    roHeader: _(r),
-    roFooter: _(o),
-    roSidebar: _(O),
-    roAside: _(P),
-    roBreadcrumb: _(a),
-    roBody: _(t),
-    roViewport: _(c),
-    roGap: _(I),
-    roTheme: _(T),
-    roLayout: _(s)
+    update,
+    roBaseInfo: readonly(reactiveBaseInfo),
+    roHeader: readonly(reactiveHeader),
+    roFooter: readonly(reactiveFooter),
+    roSidebar: readonly(reactiveSidebar),
+    roAside: readonly(reactiveAside),
+    roBreadcrumb: readonly(reactiveBreadcrumb),
+    roBody: readonly(reactiveBody),
+    roViewport: readonly(reactiveViewport),
+    roGap: readonly(reactiveGap),
+    roTheme: readonly(reactiveTheme),
+    roLayout: readonly(layoutAggregate)
   };
 }
 export {
-  U as createBridgeConfigHook
+  createBridgeConfigHook
 };

package/es/bridge/index.mjs

@@ -1,36 +1,50 @@
-import { computed as L } from "vue";
-import { createStorageWithNamespace as l } from "./storage.mjs";
-import { createUseState as Y } from "./state.mjs";
-import { createGenerateRouteMetaRawTree as B } from "./route.mjs";
-import { createBridgeConfigHook as D } from "./config-hook.mjs";
-import { createBridgePluginHost as k } from "./plugin.mjs";
-import { createBridgeThemeHook as S } from "./theme/index.mjs";
-import { createBridgeLayoutHook as H } from "./layout.mjs";
-import { CORE_BRIDGE_KEY as w } from "../inject/key.mjs";
-function x(e) {
-  const C = e.APP_CACHE_CONFIG.namespace;
-  let P;
-  C === "" ? (console.error(
-    "[bridge] APP_CACHE_CONFIG.namespace 为空，已兜底为 'DC_CORE'"
-  ), P = "DC_CORE") : P = C, Object.freeze(e);
-  const O = l(P), h = e.routes, m = e.getUserInfoInitFn, N = e.userInfoAccess, d = Y(P), U = B(
-    e.APP_ROUTER_META_DEFAULT_CONFIG
-  ), f = {
+import { computed } from "vue";
+import { createStorageWithNamespace } from "./storage.mjs";
+import { createUseState } from "./state.mjs";
+import { createGenerateRouteMetaRawTree } from "./route.mjs";
+import { createBridgeConfigHook } from "./config-hook.mjs";
+import { createBridgePluginHost } from "./plugin.mjs";
+import { createBridgeThemeHook } from "./theme/index.mjs";
+import { createBridgeLayoutHook } from "./layout.mjs";
+import { CORE_BRIDGE_KEY } from "../inject/key.mjs";
+function createCoreBridge(options) {
+  const rawNs = options.APP_CACHE_CONFIG.namespace;
+  let effectiveNs;
+  if (rawNs === "") {
+    console.error(
+      "[bridge] APP_CACHE_CONFIG.namespace 为空，已兜底为 'DC_CORE'"
+    );
+    effectiveNs = "DC_CORE";
+  } else {
+    effectiveNs = rawNs;
+  }
+  Object.freeze(options);
+  const storage = createStorageWithNamespace(effectiveNs);
+  const routes = options.routes;
+  const getUserInfoInitFn_ = options.getUserInfoInitFn;
+  const userInfoAccess = options.userInfoAccess;
+  const useStateInstance = createUseState(effectiveNs);
+  const genRouteMetaRawTreeInstance = createGenerateRouteMetaRawTree(
+    options.APP_ROUTER_META_DEFAULT_CONFIG
+  );
+  const asideConfig = {
     // 核内默认宽 0：默认 shell 渲染 AppAside 但不可见、经典 1:1 无右间隙；app/preset 加宽启用。
     width: 0,
-    ...e.APP_LAYOUT_ASIDE_CONFIG
-  }, u = {
+    ...options.APP_LAYOUT_ASIDE_CONFIG
+  };
+  const gapConfig = {
     size: 0,
-    ...e.APP_LAYOUT_GAP_CONFIG
-  }, t = D({
-    APP_BASE_INFO: e.APP_BASE_INFO,
-    APP_THEME_CONFIG: e.APP_THEME_CONFIG,
-    APP_LAYOUT_HEADER_CONFIG: e.APP_LAYOUT_HEADER_CONFIG,
-    APP_LAYOUT_FOOTER_CONFIG: e.APP_LAYOUT_FOOTER_CONFIG,
-    APP_LAYOUT_SIDEBAR_CONFIG: e.APP_LAYOUT_SIDEBAR_CONFIG,
-    APP_LAYOUT_ASIDE_CONFIG: f,
-    APP_LAYOUT_BREADCRUMB_CONFIG: e.APP_LAYOUT_BREADCRUMB_CONFIG,
-    APP_LAYOUT_BODY_CONFIG: e.APP_LAYOUT_BODY_CONFIG,
+    ...options.APP_LAYOUT_GAP_CONFIG
+  };
+  const configHook = createBridgeConfigHook({
+    APP_BASE_INFO: options.APP_BASE_INFO,
+    APP_THEME_CONFIG: options.APP_THEME_CONFIG,
+    APP_LAYOUT_HEADER_CONFIG: options.APP_LAYOUT_HEADER_CONFIG,
+    APP_LAYOUT_FOOTER_CONFIG: options.APP_LAYOUT_FOOTER_CONFIG,
+    APP_LAYOUT_SIDEBAR_CONFIG: options.APP_LAYOUT_SIDEBAR_CONFIG,
+    APP_LAYOUT_ASIDE_CONFIG: asideConfig,
+    APP_LAYOUT_BREADCRUMB_CONFIG: options.APP_LAYOUT_BREADCRUMB_CONFIG,
+    APP_LAYOUT_BODY_CONFIG: options.APP_LAYOUT_BODY_CONFIG,
     // viewport 边框：app 可整体不传 / 传部分字段，与核内默认四边 0 浅合并补全
     // （config-hook reactive 入参 [MUST] 全字段非 undefined，故此处合并而非透传）。
     APP_LAYOUT_VIEWPORT_CONFIG: {
@@ -38,70 +52,90 @@ function x(e) {
       paddingRight: 0,
       paddingBottom: 0,
       paddingLeft: 0,
-      ...e.APP_LAYOUT_VIEWPORT_CONFIG
+      ...options.APP_LAYOUT_VIEWPORT_CONFIG
     },
-    APP_LAYOUT_GAP_CONFIG: u
-  }), _ = S({
-    initConfig: e.APP_THEME_CONFIG,
-    update: t.update,
+    APP_LAYOUT_GAP_CONFIG: gapConfig
+  });
+  const themeHook = createBridgeThemeHook({
+    initConfig: options.APP_THEME_CONFIG,
+    update: configHook.update,
     // 布局基线快照（preset 切换基线复位 + 叠加用）。六组布局 config init 值浅快照——
     // viewport 取已合并核内默认四边 0 的完整值（与 configHook 入参口径一致）。
     layoutBaseline: {
-      header: { ...e.APP_LAYOUT_HEADER_CONFIG },
-      footer: { ...e.APP_LAYOUT_FOOTER_CONFIG },
-      sidebar: { ...e.APP_LAYOUT_SIDEBAR_CONFIG },
-      aside: { ...f },
-      breadcrumb: { ...e.APP_LAYOUT_BREADCRUMB_CONFIG },
-      body: { ...e.APP_LAYOUT_BODY_CONFIG },
+      header: { ...options.APP_LAYOUT_HEADER_CONFIG },
+      footer: { ...options.APP_LAYOUT_FOOTER_CONFIG },
+      sidebar: { ...options.APP_LAYOUT_SIDEBAR_CONFIG },
+      aside: { ...asideConfig },
+      breadcrumb: { ...options.APP_LAYOUT_BREADCRUMB_CONFIG },
+      body: { ...options.APP_LAYOUT_BODY_CONFIG },
       viewport: {
         paddingTop: 0,
         paddingRight: 0,
         paddingBottom: 0,
         paddingLeft: 0,
-        ...e.APP_LAYOUT_VIEWPORT_CONFIG
+        ...options.APP_LAYOUT_VIEWPORT_CONFIG
       },
-      gap: { ...u }
+      gap: { ...gapConfig }
     },
-    storage: O,
-    defaultMode: e.defaultThemeMode
-  }), G = H({ storage: O }), R = L(
-    () => _.themeIsDark.value ? t.roTheme.dark : t.roTheme.light
+    storage,
+    defaultMode: options.defaultThemeMode
+  });
+  const layoutHook = createBridgeLayoutHook({ storage });
+  const themeColors = computed(
+    () => themeHook.themeIsDark.value ? configHook.roTheme.dark : configHook.roTheme.light
   );
-  let o, T, n, I, i, a, E, F;
-  const A = (r) => `bridge: ${r} 未注册`, c = k(), g = {
-    register(r) {
-      r.getToken && (o = r.getToken), r.goToLogin && (T = r.goToLogin), r.refreshToken && (n = r.refreshToken), r.refreshAuth && (I = r.refreshAuth), r.loginApi && (i = r.loginApi), r.logoutApi && (a = r.logoutApi), r.getUserInfoApi && (E = r.getUserInfoApi), r.refreshTokenApi && (F = r.refreshTokenApi);
+  let tokenFn;
+  let loginFn;
+  let refreshTokenFn;
+  let refreshAuthFn;
+  let loginApiFn;
+  let logoutApiFn;
+  let getUserInfoApiFn;
+  let refreshTokenApiFn;
+  const msg = (name) => `bridge: ${name} 未注册`;
+  const pluginHost = createBridgePluginHost();
+  const bridgeInstance = {
+    register(options2) {
+      if (options2.getToken) tokenFn = options2.getToken;
+      if (options2.goToLogin) loginFn = options2.goToLogin;
+      if (options2.refreshToken) refreshTokenFn = options2.refreshToken;
+      if (options2.refreshAuth) refreshAuthFn = options2.refreshAuth;
+      if (options2.loginApi) loginApiFn = options2.loginApi;
+      if (options2.logoutApi) logoutApiFn = options2.logoutApi;
+      if (options2.getUserInfoApi) getUserInfoApiFn = options2.getUserInfoApi;
+      if (options2.refreshTokenApi) refreshTokenApiFn = options2.refreshTokenApi;
     },
     // 已注册返回 undefined 是合法业务态不 throw
     // v3 终锁 Δ8b：零参 facade（BR-1 ③ 终裁——core 对 UserInfo 不透明 + 拦截器无 info 源）
     getToken() {
-      if (!o) throw new Error(A("getToken"));
-      return o();
+      if (!tokenFn) throw new Error(msg("getToken"));
+      return tokenFn();
     },
     goToLogin() {
-      if (!T) throw new Error(A("goToLogin"));
-      T();
+      if (!loginFn) throw new Error(msg("goToLogin"));
+      loginFn();
     },
     // 异步对：未注册才返回 rejected Promise（既有降级语义保留）。
     refreshToken() {
-      return n ? n().then(() => {
-      }) : Promise.reject(new Error(A("refreshToken")));
+      if (!refreshTokenFn)
+        return Promise.reject(new Error(msg("refreshToken")));
+      return refreshTokenFn().then(() => void 0);
     },
     refreshAuth() {
-      return I ? I().then(() => {
-      }) : Promise.reject(new Error(A("refreshAuth")));
+      if (!refreshAuthFn) return Promise.reject(new Error(msg("refreshAuth")));
+      return refreshAuthFn().then(() => void 0);
     },
     getStorage() {
-      return O;
+      return storage;
     },
     getRoutes() {
-      return h;
+      return routes;
     },
     getUserInfoInitFn() {
-      return m;
+      return getUserInfoInitFn_;
     },
-    useState: d,
-    generateRouteMetaRawTree: U,
+    useState: useStateInstance,
+    generateRouteMetaRawTree: genRouteMetaRawTreeInstance,
     // ============ #2.5 期 12 readonly 属性值挂载（per ADR-1 sibling pattern 复用 useState / generateRouteMetaRawTree） ============
     // 插件系统一期：本期 7 字段（BASE_INFO / 5 布局子 / THEME）+ APP_LAYOUT_CONFIG
     // 改挂 configHook 的 readonly(reactive()) 响应式只读视图——经 bridge.update 跟随。
@@ -112,25 +146,25 @@ function x(e) {
      * 更新后本属性自动跟随。[SHOULD] 在 `computed` / 响应式上下文中读取，[MUST NOT]
      * 解构或一次性快照取值（`const x = bridge.APP_BASE_INFO.foo` ⚠️ 快照定格，update 后不变）。
      */
-    APP_BASE_INFO: t.roBaseInfo,
+    APP_BASE_INFO: configHook.roBaseInfo,
     /** 应用环境信息（per #2.5 期 REQ-1） */
-    APP_ENV_INFO: e.APP_ENV_INFO,
+    APP_ENV_INFO: options.APP_ENV_INFO,
     /** 应用缓存配置（per #2.5 期 REQ-1） */
-    APP_CACHE_CONFIG: e.APP_CACHE_CONFIG,
+    APP_CACHE_CONFIG: options.APP_CACHE_CONFIG,
     /**
      * 应用布局-header 配置（**响应式只读视图**，插件系统一期改）。
      *
      * `readonly(reactive(...))` 包裹——`bridge.update("APP_LAYOUT_HEADER_CONFIG", partial)`
      * 后自动跟随。[SHOULD] 响应式上下文 / `computed` 读取，[MUST NOT] 解构/快照（⚠️ 定格）。
      */
-    APP_LAYOUT_HEADER_CONFIG: t.roHeader,
+    APP_LAYOUT_HEADER_CONFIG: configHook.roHeader,
     /**
      * 应用布局-footer 配置（**响应式只读视图**，插件系统一期改）。
      *
      * `readonly(reactive(...))`——`bridge.update("APP_LAYOUT_FOOTER_CONFIG", partial)`
      * 后跟随。[SHOULD] 响应式上下文读取，[MUST NOT] 解构/快照（⚠️ 定格）。
      */
-    APP_LAYOUT_FOOTER_CONFIG: t.roFooter,
+    APP_LAYOUT_FOOTER_CONFIG: configHook.roFooter,
     /**
      * 应用布局-sidebar 配置（**响应式只读视图**，插件系统一期改）。
      *
@@ -138,28 +172,28 @@ function x(e) {
      * 后跟随（一级浅合并，传 `{width}` 保留 `collapseWidth`）。[SHOULD] 响应式上下文
      * 读取，[MUST NOT] 解构/快照（⚠️ 定格）。
      */
-    APP_LAYOUT_SIDEBAR_CONFIG: t.roSidebar,
+    APP_LAYOUT_SIDEBAR_CONFIG: configHook.roSidebar,
     /**
      * 应用布局-aside 右侧补充区配置（**响应式只读视图**，P1' additive）。
      *
      * `readonly(reactive(...))`——`bridge.update("APP_LAYOUT_ASIDE_CONFIG", partial)` 后跟随。
      * 仅自定义 shell 渲染右侧区时消费；经典布局不读。[MUST NOT] 解构/快照（⚠️ 定格）。
      */
-    APP_LAYOUT_ASIDE_CONFIG: t.roAside,
+    APP_LAYOUT_ASIDE_CONFIG: configHook.roAside,
     /**
      * 应用布局-面包屑配置（**响应式只读视图**，插件系统一期改）。
      *
      * `readonly(reactive(...))`——`bridge.update("APP_LAYOUT_BREADCRUMB_CONFIG", partial)`
      * 后跟随。[SHOULD] 响应式上下文读取，[MUST NOT] 解构/快照（⚠️ 定格）。
      */
-    APP_LAYOUT_BREADCRUMB_CONFIG: t.roBreadcrumb,
+    APP_LAYOUT_BREADCRUMB_CONFIG: configHook.roBreadcrumb,
     /**
      * 应用布局-页面主体配置（**响应式只读视图**，插件系统一期改）。
      *
      * `readonly(reactive(...))`——`bridge.update("APP_LAYOUT_BODY_CONFIG", partial)`
      * 后跟随。[SHOULD] 响应式上下文读取，[MUST NOT] 解构/快照（⚠️ 定格）。
      */
-    APP_LAYOUT_BODY_CONFIG: t.roBody,
+    APP_LAYOUT_BODY_CONFIG: configHook.roBody,
     /**
      * 应用布局-视口边框配置（**响应式只读视图**）。
      *
@@ -167,7 +201,7 @@ function x(e) {
      * 后跟随（一级浅合并，传 `{paddingTop}` 保留其余三边）。store/app 经此派生 viewport
      * padding 给 Header/Sidebar fixed 锚点 + AppBody calc。[MUST NOT] 解构/快照（⚠️ 定格）。
      */
-    APP_LAYOUT_VIEWPORT_CONFIG: t.roViewport,
+    APP_LAYOUT_VIEWPORT_CONFIG: configHook.roViewport,
     /**
      * 应用布局-模块间距配置（**响应式只读视图**，内缝 gap）。
      *
@@ -175,7 +209,7 @@ function x(e) {
      * 后跟随。store/app 经此派生 gapTop/Left/Right/Bottom 叠加进几何 calc。
      * [MUST NOT] 解构/快照（⚠️ 定格）。
      */
-    APP_LAYOUT_GAP_CONFIG: t.roGap,
+    APP_LAYOUT_GAP_CONFIG: configHook.roGap,
     /**
      * 应用布局聚合配置（**响应式只读视图**，插件系统一期改）。
      *
@@ -183,13 +217,13 @@ function x(e) {
      * `readonly(reactive({header, footer, sidebar, breadcrumb, body}))`——不再是
      * `Object.freeze` 静态聚合。[SHOULD] 响应式上下文读取，[MUST NOT] 解构/快照（⚠️ 定格）。
      */
-    APP_LAYOUT_CONFIG: t.roLayout,
+    APP_LAYOUT_CONFIG: configHook.roLayout,
     /** 应用路由元信息默认配置（per #2.5 期 REQ-1） */
-    APP_ROUTER_META_DEFAULT_CONFIG: e.APP_ROUTER_META_DEFAULT_CONFIG,
+    APP_ROUTER_META_DEFAULT_CONFIG: options.APP_ROUTER_META_DEFAULT_CONFIG,
     /** 应用路由配置（per #2.5 期 REQ-1） */
-    APP_ROUTER_CONFIG: e.APP_ROUTER_CONFIG,
+    APP_ROUTER_CONFIG: options.APP_ROUTER_CONFIG,
     /** 应用路由路径配置（per #7.3 期 readonly 挂载） */
-    APP_ROUTER_PATHS_CONFIG: e.APP_ROUTER_PATHS_CONFIG,
+    APP_ROUTER_PATHS_CONFIG: options.APP_ROUTER_PATHS_CONFIG,
     /**
      * 应用主题配置（**响应式只读视图**，插件系统一期改）。
      *
@@ -197,58 +231,67 @@ function x(e) {
      * 一级浅合并整体替换 `light`、保留 `dark`，后自动跟随。[SHOULD] 响应式上下文读取，
      * [MUST NOT] 解构/快照（⚠️ 定格）。
      */
-    APP_THEME_CONFIG: t.roTheme,
+    APP_THEME_CONFIG: configHook.roTheme,
     /** 主题模块（架构反转：风格切换真相源在 bridge；插件经 theme.add 注册风格） */
-    theme: _.theme,
+    theme: themeHook.theme,
     /** 当前风格名（响应式只读真相源） */
-    themeStyle: _.themeStyle,
+    themeStyle: themeHook.themeStyle,
     /** 明暗模式三态真相源（亮/暗/跟随系统） */
-    themeMode: _.themeMode,
+    themeMode: themeHook.themeMode,
     /** 是否暗色（响应式只读派生；appStore / 挂值 composable 读此） */
-    themeIsDark: _.themeIsDark,
+    themeIsDark: themeHook.themeIsDark,
     /** 当前 preset 的 layout 运行时维度（AppLayout 直读 shell + 分流意图） */
-    themeLayout: _.themeLayout,
+    themeLayout: themeHook.themeLayout,
     /** 当前密度档 / 动效档（节奏真相源；useCoreThemeApply 消费，明暗无关） */
-    themeDensity: _.themeDensity,
-    themeMotion: _.themeMotion,
+    themeDensity: themeHook.themeDensity,
+    themeMotion: themeHook.themeMotion,
     /** 当前生效 JS 主题色（输出 B；MenuTree/布局直读、appStore.theme 转发） */
-    themeColors: R,
+    themeColors,
     /** 是否显示内置风格切换下拉（AppTheme ElSelect）；init 静态值，缺省 true（亮暗恒显） */
-    showThemeStyleSwitcher: e.showThemeStyleSwitcher ?? !0,
+    showThemeStyleSwitcher: options.showThemeStyleSwitcher ?? true,
     /** 布局折叠模块（折叠真相源在 bridge；appStore 转发，AppSidebar / AppAside 驱动） */
-    layout: G.layout,
+    layout: layoutHook.layout,
     /** 用户信息字段访问器集（第一宪法：业务注入 get/set 读写 token/refreshToken/permission） */
-    userInfoAccess: N,
+    userInfoAccess,
     // 插件系统一期：update（REQ-1）+ install（REQ-9）挂载。
     // install 箭头函数闭包引用 bridgeInstance（[MUST NOT] 用 this——strict
     // noImplicitThis）；provide 整 bridge 自身；零单例（[MUST NOT] globalThis/模块级缓存）。
-    update: t.update,
-    use: (r, s) => c.use({
-      bridge: g,
-      update: t.update,
-      plugin: r,
-      options: s
+    update: configHook.update,
+    use: (plugin, options2) => pluginHost.use({
+      bridge: bridgeInstance,
+      update: configHook.update,
+      plugin,
+      options: options2
     }),
-    install: (r) => (r.provide(w, g), r),
+    install: (app) => {
+      app.provide(CORE_BRIDGE_KEY, bridgeInstance);
+      return app;
+    },
     // 异步对：未注册返回 rejected 原生 Error（#4a-2 per-method 降级）
-    loginApi(r) {
-      return i ? i(r) : Promise.reject(new Error(A("loginApi")));
+    loginApi(params) {
+      if (!loginApiFn) return Promise.reject(new Error(msg("loginApi")));
+      return loginApiFn(params);
     },
     logoutApi() {
-      return a ? a() : Promise.reject(new Error(A("logoutApi")));
+      if (!logoutApiFn) return Promise.reject(new Error(msg("logoutApi")));
+      return logoutApiFn();
     },
     getUserInfoApi() {
-      return E ? E() : Promise.reject(new Error(A("getUserInfoApi")));
+      if (!getUserInfoApiFn)
+        return Promise.reject(new Error(msg("getUserInfoApi")));
+      return getUserInfoApiFn();
     },
-    refreshTokenApi(r) {
-      return F ? F(r) : Promise.reject(new Error(A("refreshTokenApi")));
+    refreshTokenApi(refreshToken) {
+      if (!refreshTokenApiFn)
+        return Promise.reject(new Error(msg("refreshTokenApi")));
+      return refreshTokenApiFn(refreshToken);
     }
   };
-  return g;
+  return bridgeInstance;
 }
 export {
-  x as createCoreBridge,
-  B as createGenerateRouteMetaRawTree,
-  l as createStorageWithNamespace,
-  Y as createUseState
+  createCoreBridge,
+  createGenerateRouteMetaRawTree,
+  createStorageWithNamespace,
+  createUseState
 };