@done-coding/admin-core 0.2.0 → 0.3.0

package/es/components/modal/ModalPorter.vue.mjs

@@ -0,0 +1,52 @@
+import { defineComponent as S, getCurrentInstance as h, inject as c, renderSlot as v } from "vue";
+import { getModalShelfInjectionKey as u } from "../../inject/key.mjs";
+import { useActivatedEvent as y } from "../../hooks/activated.mjs";
+const k = /* @__PURE__ */ S({
+  __name: "ModalPorter",
+  props: {
+    modalList: {}
+  },
+  setup(i, { expose: p }) {
+    var s;
+    const o = i, f = ((s = h()) == null ? void 0 : s.uid) ?? Math.floor(Math.random() * 1e9), d = {
+      app: c(u("app"), null),
+      page: c(u("page"), null)
+    };
+    function a(e) {
+      return `p${f}:${e}`;
+    }
+    function l(e) {
+      if (e === "app" || e === "page") {
+        const t = d[e];
+        return t || (console.error(`[ModalPorter] 未找到 level="${e}" 的 ModalShelf`), null);
+      }
+      return e;
+    }
+    function m(e, t) {
+      const r = o.modalList.find((g) => g.key === e);
+      if (!r)
+        return console.error(`[ModalPorter] 未配置的弹窗 key: ${String(e)}`), null;
+      const n = l(r.shelf);
+      return n ? n.evoke(a(String(e)), r.component, {
+        payload: t,
+        sameKeyStrategy: r.sameKeyStrategy
+      }) : null;
+    }
+    return y(
+      () => {
+      },
+      () => {
+        const e = /* @__PURE__ */ new Map();
+        o.modalList.forEach((t) => {
+          const r = l(t.shelf);
+          if (!r) return;
+          const n = e.get(r) ?? [];
+          n.push(a(String(t.key))), e.set(r, n);
+        }), e.forEach((t, r) => r.remove(t));
+      }
+    ), p({ evoke: m }), (e, t) => v(e.$slots, "default");
+  }
+});
+export {
+  k as default
+};

package/es/components/modal/ModalPorter.vue2.mjs

@@ -0,0 +1,4 @@
+import f from "./ModalPorter.vue.mjs";
+export {
+  f as default
+};

package/es/components/modal/ModalShelf.vue.mjs

@@ -0,0 +1,38 @@
+import { defineComponent as h, provide as v, onMounted as y, inject as a, openBlock as s, createElementBlock as c, Fragment as u, renderSlot as w, renderList as C, unref as l, createBlock as F, resolveDynamicComponent as _, defineAsyncComponent as k } from "vue";
+import { createShelfController as S } from "./modal-shelf-core.mjs";
+import { assertLevelHierarchy as g } from "./modal-shelf-hierarchy.mjs";
+import { getModalShelfInjectionKey as p } from "../../inject/key.mjs";
+const E = /* @__PURE__ */ h({
+  __name: "ModalShelf",
+  props: {
+    level: {}
+  },
+  setup(f, { expose: m }) {
+    const r = f.level, n = S(r);
+    m(n), v(p(r), n);
+    function d(o) {
+      return typeof o == "function" ? k(o) : o;
+    }
+    return y(() => {
+      const o = [];
+      ["app", "page", "custom"].forEach((e) => {
+        e !== r && a(p(e), null) && o.push(e);
+      });
+      const t = a(p(r), null);
+      t && t !== n && o.push(r), g(r, o);
+    }), (o, t) => (s(), c(u, null, [
+      w(o.$slots, "default"),
+      (s(!0), c(u, null, C(l(n).items.value, (e) => (s(), F(_(d(e.component)), {
+        key: e.id,
+        show: e.show,
+        payload: e.payload,
+        closeFn: () => l(n).close(e),
+        removeFn: () => l(n).remove(e.nsKey),
+        "onUpdate:show": (i) => !i && l(n).close(e)
+      }, null, 40, ["show", "payload", "closeFn", "removeFn", "onUpdate:show"]))), 128))
+    ], 64));
+  }
+});
+export {
+  E as default
+};

package/es/components/modal/ModalShelf.vue2.mjs

@@ -0,0 +1,4 @@
+import f from "./ModalShelf.vue.mjs";
+export {
+  f as default
+};

package/es/components/modal/index.mjs

@@ -1,17 +1,23 @@
-import n from "./ConfirmModal.vue.mjs";
-import l from "./DetailModal.vue.mjs";
-const m = {
-  ConfirmModal: n,
-  DetailModal: l
-}, r = {
+import l from "./ConfirmModal.vue.mjs";
+import r from "./DetailModal.vue.mjs";
+import m from "./ModalShelf.vue.mjs";
+import n from "./ModalPorter.vue.mjs";
+const e = {
+  ConfirmModal: l,
+  DetailModal: r,
+  ModalShelf: m,
+  ModalPorter: n
+}, d = {
   install(o) {
-    Object.entries(m).forEach(([t, a]) => {
-      o.component(t, a);
+    Object.entries(e).forEach(([a, t]) => {
+      o.component(a, t);
     });
   }
 };
 export {
-  n as ConfirmModal,
-  l as DetailModal,
-  r as modalInstall
+  l as ConfirmModal,
+  r as DetailModal,
+  n as ModalPorter,
+  m as ModalShelf,
+  d as modalInstall
 };

package/es/components/modal/modal-shelf-core.mjs

@@ -0,0 +1,52 @@
+import { ref as h } from "vue";
+const x = 300;
+function g(s) {
+  let l = 0;
+  const r = h([]);
+  function d(e) {
+    return r.value.findIndex((t) => t.nsKey === e);
+  }
+  function u(e) {
+    e.timer !== void 0 && (clearTimeout(e.timer), e.timer = void 0);
+  }
+  function a(e) {
+    (Array.isArray(e) ? e : [e]).forEach((i) => {
+      const n = d(i);
+      n > -1 && (u(r.value[n]), r.value.splice(n, 1));
+    });
+  }
+  function c(e) {
+    const t = r.value.find((i) => i.id === e.id);
+    t && t.timer === void 0 && (t.show = !1, t.timer = setTimeout(() => {
+      const i = r.value.findIndex((n) => n.id === e.id);
+      i > -1 && r.value.splice(i, 1);
+    }, x));
+  }
+  function f(e) {
+    return {
+      close: () => {
+        const t = r.value.find((i) => i.nsKey === e);
+        t && c(t);
+      },
+      update: (t) => {
+        const i = r.value.find((n) => n.nsKey === e);
+        i && (i.payload = { ...i.payload, ...t });
+      }
+    };
+  }
+  function v(e, t, i) {
+    const { payload: n, sameKeyStrategy: m = "recreate" } = i;
+    if (m === "update") {
+      const o = r.value.find((y) => y.nsKey === e);
+      if (o)
+        return u(o), o.show = !0, o.payload = n, f(e);
+    }
+    a(e);
+    const p = { id: ++l, nsKey: e, component: t, payload: n, show: !0 };
+    return r.value.push(p), f(e);
+  }
+  return { level: s, items: r, evoke: v, remove: a, close: c };
+}
+export {
+  g as createShelfController
+};

package/es/components/modal/modal-shelf-hierarchy.mjs

@@ -0,0 +1,21 @@
+function l(o, e) {
+  if (o === "app" && e.length > 0) {
+    console.error(
+      `[ModalShelf] level="app" 必须最顶层，但其上存在: ${e.join(
+        ", "
+      )}`
+    );
+    return;
+  }
+  if (o === "page") {
+    const r = e.filter((a) => a === "page" || a === "custom");
+    r.length > 0 && console.error(
+      `[ModalShelf] level="page" 之上不得套 page/custom，发现: ${r.join(
+        ", "
+      )}`
+    );
+  }
+}
+export {
+  l as assertLevelHierarchy
+};

package/es/components/panel/PanelEditSwitch.vue.mjs

@@ -0,0 +1,7 @@
+import t from "./PanelEditSwitch.vue2.mjs";
+/* empty css                      */
+import o from "../../_virtual/_plugin-vue_export-helper.mjs";
+const i = /* @__PURE__ */ o(t, [["__scopeId", "data-v-ea2a07d5"]]);
+export {
+  i as default
+};

package/es/components/panel/PanelEditSwitch.vue2.mjs

@@ -0,0 +1,93 @@
+import { ElButton as E } from "element-plus/es";
+import "element-plus/es/components/base/style/css";
+import "element-plus/es/components/button/style/css";
+import { defineComponent as h, ref as d, watch as B, openBlock as u, createElementBlock as f, unref as m, createBlock as C, withCtx as c, createTextVNode as p, createCommentVNode as S, renderSlot as v, Fragment as N, createElementVNode as P, createVNode as g } from "vue";
+import V from "lodash/cloneDeep";
+const $ = { class: "panel-edit-switch-actions" }, j = /* @__PURE__ */ h({
+  name: "PanelEditSwitch",
+  __name: "PanelEditSwitch",
+  props: {
+    data: {},
+    editing: { type: Boolean },
+    submitFn: { type: Function }
+  },
+  emits: ["update:editing", "submitFinish"],
+  setup(a, { emit: b }) {
+    const o = a, i = b, s = d(!1), l = d(!1), n = d({});
+    B(
+      () => o.editing,
+      (t, e) => {
+        t && !e && (n.value = V(o.data));
+      },
+      { immediate: !0 }
+    );
+    const y = () => {
+      i("update:editing", !0);
+    }, k = () => {
+      i("update:editing", !1);
+    }, w = async () => {
+      if (!o.submitFn) {
+        console.error("[PanelEditSwitch] editable 项缺少 submitFn，无法提交");
+        return;
+      }
+      l.value = !0;
+      try {
+        await o.submitFn(n.value), i("submitFinish", !0, n.value), i("update:editing", !1);
+      } catch (t) {
+        console.error("[PanelEditSwitch] submitFn 失败", t), i("submitFinish", !1, n.value);
+      } finally {
+        l.value = !1;
+      }
+    };
+    return (t, e) => {
+      const r = E;
+      return u(), f("div", {
+        class: "panel-edit-switch",
+        onMouseenter: e[0] || (e[0] = (F) => s.value = !0),
+        onMouseleave: e[1] || (e[1] = (F) => s.value = !1)
+      }, [
+        !a.editing && m(s) ? (u(), C(r, {
+          key: 0,
+          class: "panel-edit-switch-edit-btn",
+          type: "primary",
+          link: "",
+          size: "small",
+          onClick: y
+        }, {
+          default: c(() => [...e[2] || (e[2] = [
+            p("编辑", -1)
+          ])]),
+          _: 1
+        })) : S("", !0),
+        a.editing ? (u(), f(N, { key: 2 }, [
+          v(t.$slots, "editor", { data: m(n) }, void 0, !0),
+          P("div", $, [
+            g(r, {
+              size: "small",
+              onClick: k
+            }, {
+              default: c(() => [...e[3] || (e[3] = [
+                p("取消", -1)
+              ])]),
+              _: 1
+            }),
+            g(r, {
+              type: "primary",
+              size: "small",
+              loading: m(l),
+              onClick: w
+            }, {
+              default: c(() => [...e[4] || (e[4] = [
+                p("提交", -1)
+              ])]),
+              _: 1
+            }, 8, ["loading"])
+          ])
+        ], 64)) : v(t.$slots, "default", { key: 1 }, void 0, !0)
+      ], 32);
+    };
+  }
+});
+export {
+  j as default
+};

package/es/components/panel/PanelItem.vue.mjs

@@ -0,0 +1,54 @@
+import { defineComponent as P, computed as c, unref as r, openBlock as n, createElementBlock as f, Fragment as w, toDisplayString as k, createBlock as l, resolveDynamicComponent as u, normalizeProps as g, mergeProps as m, withCtx as h } from "vue";
+import S from "./PanelEditSwitch.vue.mjs";
+const x = { key: 0 }, C = { key: 0 }, E = { key: 0 }, I = /* @__PURE__ */ P({
+  name: "PanelItem",
+  __name: "PanelItem",
+  props: {
+    data: {},
+    config: {},
+    editing: { type: Boolean }
+  },
+  emits: ["update:editing", "submitFinish", "refresh"],
+  setup(e, { emit: b }) {
+    const t = e, o = b, a = c(() => ({
+      data: t.data,
+      value: t.data[t.config.key],
+      config: t.config,
+      refresh: () => o("refresh")
+    })), p = c(() => {
+      const { editable: i } = t.config;
+      return typeof i == "function" ? !!i(a.value) : !!i;
+    }), v = c(() => String(a.value.value ?? "")), y = c(() => ({
+      data: a.value.data,
+      value: a.value.value,
+      config: a.value.config,
+      refresh: () => o("refresh"),
+      onRefresh: () => o("refresh")
+    })), B = (i) => ({
+      data: i,
+      value: i[t.config.key],
+      config: t.config
+    });
+    return (i, s) => r(p) ? (n(), l(S, {
+      key: 1,
+      data: e.data,
+      editing: e.editing,
+      "submit-fn": e.config.submitFn,
+      "onUpdate:editing": s[0] || (s[0] = (d) => o("update:editing", d)),
+      onSubmitFinish: s[1] || (s[1] = (d, F) => o("submitFinish", d, F))
+    }, {
+      editor: h(({ data: d }) => [
+        e.config.editorRender === void 0 ? (n(), f("span", E)) : (n(), l(u(e.config.editorRender), g(m({ key: 1 }, B(d))), null, 16))
+      ]),
+      default: h(() => [
+        e.config.render === void 0 ? (n(), f("span", C, k(r(v)), 1)) : (n(), l(u(e.config.render), g(m({ key: 1 }, r(y))), null, 16))
+      ]),
+      _: 1
+    }, 8, ["data", "editing", "submit-fn"])) : (n(), f(w, { key: 0 }, [
+      e.config.render === void 0 ? (n(), f("span", x, k(r(v)), 1)) : (n(), l(u(e.config.render), g(m({ key: 1 }, r(y))), null, 16))
+    ], 64));
+  }
+});
+export {
+  I as default
+};

package/es/components/panel/PanelItem.vue2.mjs

@@ -0,0 +1,4 @@
+import f from "./PanelItem.vue.mjs";
+export {
+  f as default
+};

package/es/components/panel/PanelMain.vue.mjs

@@ -0,0 +1,80 @@
+import { ElRow as x, ElCol as R } from "element-plus/es";
+import "element-plus/es/components/base/style/css";
+import "element-plus/es/components/row/style/css";
+import "element-plus/es/components/col/style/css";
+import { defineComponent as L, ref as B, computed as F, watch as M, openBlock as s, createBlock as f, withCtx as l, createElementBlock as P, Fragment as b, renderList as D, unref as u, withDirectives as S, mergeProps as U, createVNode as j, vShow as H } from "vue";
+import N from "./PanelItem.vue.mjs";
+import { resolveFormLayout as m } from "../form/utils.mjs";
+const I = /* @__PURE__ */ L({
+  name: "PanelMain",
+  __name: "PanelMain",
+  props: {
+    data: {},
+    layout: { default: () => ({ span: 24 }) },
+    list: {}
+  },
+  emits: ["refresh"],
+  setup(c, { emit: p }) {
+    const n = c, d = p, g = (e) => e, h = (e) => e, a = B({}), y = F(
+      () => n.list.map((e, t) => ({ config: e, index: t })).sort((e, t) => {
+        const o = e.config.order ?? e.index, i = t.config.order ?? t.index;
+        return o - i;
+      })
+    ), _ = (e) => {
+      const { hide: t } = e;
+      if (typeof t == "function") {
+        const o = {
+          data: n.data,
+          value: n.data[e.key],
+          config: e
+        };
+        return !!t(o);
+      }
+      return !!t;
+    }, k = (e) => ({
+      ...m(n.layout),
+      ...m(e)
+    }), v = (e, t) => {
+      a.value = {}, t && (a.value[e] = t);
+    }, E = (e, t) => {
+      e && d("refresh", t);
+    }, w = () => d("refresh", n.data);
+    return M(
+      () => n.list,
+      (e) => {
+        const t = e.map((o) => o.key);
+        Object.keys(a.value).forEach((o) => {
+          t.includes(o) || delete a.value[o];
+        });
+      },
+      { immediate: !0 }
+    ), (e, t) => {
+      const o = R, i = x;
+      return s(), f(i, null, {
+        default: l(() => [
+          (s(!0), P(b, null, D(u(y), (r) => S((s(), f(o, U({
+            key: r.config.key
+          }, { ref_for: !0 }, k(r.config.layout)), {
+            default: l(() => [
+              j(N, {
+                data: g(c.data),
+                config: h(r.config),
+                editing: u(a)[r.config.key] ?? !1,
+                "onUpdate:editing": (C) => v(r.config.key, C),
+                onSubmitFinish: E,
+                onRefresh: w
+              }, null, 8, ["data", "config", "editing", "onUpdate:editing"])
+            ]),
+            _: 2
+          }, 1040)), [
+            [H, !_(r.config)]
+          ])), 128))
+        ]),
+        _: 1
+      });
+    };
+  }
+});
+export {
+  I as default
+};

package/es/components/panel/PanelMain.vue2.mjs

@@ -0,0 +1,4 @@
+import f from "./PanelMain.vue.mjs";
+export {
+  f as default
+};

package/es/components/panel/index.mjs

@@ -0,0 +1,20 @@
+import e from "./PanelMain.vue.mjs";
+import o from "./PanelItem.vue.mjs";
+import m from "./PanelEditSwitch.vue.mjs";
+const i = {
+  PanelMain: e,
+  PanelItem: o,
+  PanelEditSwitch: m
+}, r = {
+  install(n) {
+    Object.entries(i).forEach(([t, a]) => {
+      n.component(t, a);
+    });
+  }
+};
+export {
+  m as PanelEditSwitch,
+  o as PanelItem,
+  e as PanelMain,
+  r as panelInstall
+};

package/es/index.mjs

@@ -5,128 +5,141 @@ 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 { createAdminBridge as g } from "./bridge/index.mjs";
-import { default as _ } from "./components/misc/ActionBtn.vue.mjs";
+import { panelInstall as l } from "./components/panel/index.mjs";
+import { createAdminBridge as A } from "./bridge/index.mjs";
+import { default as C } from "./components/misc/ActionBtn.vue.mjs";
 import { default as T } from "./components/misc/ActionButton.vue.mjs";
-import { default as F } from "./components/misc/ActionButtonDanger.vue.mjs";
+import { default as L } from "./components/misc/ActionButtonDanger.vue.mjs";
 import { default as R } from "./components/misc/ActionButtonWarn.vue.mjs";
-import { default as O } from "./components/modal/DetailModal.vue.mjs";
-import { default as D } from "./components/form/FormMain.vue.mjs";
-import { default as h } from "./components/form/FormRadioGroup.vue.mjs";
-import { default as b } from "./components/form/FormSelect.vue.mjs";
-import { default as v } from "./components/form/FormTree.vue.mjs";
-import { default as H } from "./components/form/FormVerifyCode.vue.mjs";
-import { default as V } from "./components/display/HeightProvider.vue.mjs";
-import { default as W } from "./components/menu/MenuItemSub.vue.mjs";
-import { default as k } from "./components/menu/MenuTree.vue.mjs";
-import { default as X } from "./components/misc/TriggerAutoImport.vue.mjs";
-import { default as Q } from "./components/display/WatchSize.vue.mjs";
-import { APP_API_LIST_MODEL_KEY_CONFIG as q } from "./config/list-model.mjs";
-import { default as Z } from "./components/misc/ActionConfirm.vue.mjs";
-import { default as ee } from "./components/misc/AutoRefresh.vue.mjs";
-import { BODY_CONTENT_VIEWPORT_HEIGHT as oe, FULLSCREEN_HEIGHT_CHANNEL as re } from "./inject/key.mjs";
-import { default as me } from "./components/modal/ConfirmModal.vue.mjs";
-import { EXPORT_MAX_LIMIT as se, OPERATE_COLUMN_PROP as le, exportCSV as ue, pickExportColumns as ie } from "./utils/export.mjs";
-import { FORM_CONFIG_SELECT_ALL_VALUE as ne, getConfirmPasswordRule as xe, passwordRule as de, setFormComponentType as ce } from "./helpers/form.mjs";
-import { FORM_ITEM_CHANGE_LOADING as Ie, generateFormData as ge, getBlurSubmit as Ae, getChangeSubmit as _e, getDatePickerShortcuts as Ce, getEnterSubmit as Te, getPlaceholder as Me, getVModelSugar as Fe, parseFormData as Le, resolveFormLayout as Re, setInputComponent as Se, setSelectComponent as Oe, stringifyFormData as Pe, swiftFormItemConfig as De } from "./components/form/utils.mjs";
-import { default as he } from "./components/form/FormSearch.vue.mjs";
-import { default as be } from "./components/form/FormVerifyImage.vue.mjs";
-import { default as ve } from "./components/list-page/ListPage.vue.mjs";
-import { ROUTE_MODULE_LEVEL as He, TabsMainReplaceQueryKey as Ue } from "./config/route.mjs";
-import { default as we } from "./components/table/TableMain.vue.mjs";
-import { default as Ke } from "./components/display/TabsMain.vue.mjs";
-import { countAll as ze, createListApi as Xe, fetchListAll as Ye } from "./helpers/list-helper.mjs";
-import { createGenerateRouteMetaRawTree as je } from "./helpers/route.mjs";
-import { createStorageWithNamespace as Je } from "./helpers/storage.mjs";
-import { createUseState as $e } from "./helpers/state.mjs";
-import { createUserStore as tt } from "./store/user.mjs";
-import { flatRouteMetaResolveRaw as rt, getRoutePermissionKey as at } from "./utils/router.mjs";
-import { getId as ft } from "./utils/id.mjs";
-import { timeCountDown as lt } from "./utils/time.mjs";
-import { useActivated as it, useActivatedEvent as pt, useActivatedExec as nt } from "./hooks/activated.mjs";
-import { useFeelSize as dt } from "./hooks/feel-size.mjs";
-import { useMenusDataDispatch as Et } from "./hooks/menus-dispatch.mjs";
-import { useTimeout as gt } from "./hooks/timeout.mjs";
-const c = {
+import { default as h } from "./components/modal/DetailModal.vue.mjs";
+import { default as N } from "./components/form/FormMain.vue.mjs";
+import { default as b } from "./components/form/FormRadioGroup.vue.mjs";
+import { default as v } from "./components/form/FormSelect.vue.mjs";
+import { default as B } from "./components/form/FormTree.vue.mjs";
+import { default as U } from "./components/form/FormVerifyCode.vue.mjs";
+import { default as K } from "./components/display/HeightProvider.vue.mjs";
+import { default as k } from "./components/menu/MenuItemSub.vue.mjs";
+import { default as X } from "./components/menu/MenuTree.vue.mjs";
+import { default as j } from "./components/modal/ModalPorter.vue.mjs";
+import { default as q } from "./components/modal/ModalShelf.vue.mjs";
+import { default as Z } from "./components/panel/PanelItem.vue.mjs";
+import { default as ee } from "./components/panel/PanelMain.vue.mjs";
+import { default as oe } from "./components/misc/TriggerAutoImport.vue.mjs";
+import { default as ae } from "./components/display/WatchSize.vue.mjs";
+import { APP_API_LIST_MODEL_KEY_CONFIG as fe } from "./config/list-model.mjs";
+import { default as le } from "./components/misc/ActionConfirm.vue.mjs";
+import { default as ie } from "./components/misc/AutoRefresh.vue.mjs";
+import { BODY_CONTENT_VIEWPORT_HEIGHT as pe, FULLSCREEN_HEIGHT_CHANNEL as xe, getModalShelfInjectionKey as de } from "./inject/key.mjs";
+import { default as Ie } from "./components/modal/ConfirmModal.vue.mjs";
+import { EXPORT_MAX_LIMIT as ge, OPERATE_COLUMN_PROP as Me, exportCSV as Ae, pickExportColumns as _e } from "./utils/export.mjs";
+import { FORM_CONFIG_SELECT_ALL_VALUE as Se, getConfirmPasswordRule as Te, passwordRule as Fe, setFormComponentType as Le } from "./helpers/form.mjs";
+import { FORM_ITEM_CHANGE_LOADING as Re, generateFormData as Oe, getBlurSubmit as he, getChangeSubmit as De, getDatePickerShortcuts as Ne, getEnterSubmit as ye, getPlaceholder as be, getVModelSugar as Ge, parseFormData as ve, resolveFormLayout as we, setInputComponent as Be, setSelectComponent as He, stringifyFormData as Ue, swiftFormItemConfig as Ve } from "./components/form/utils.mjs";
+import { default as We } from "./components/form/FormSearch.vue.mjs";
+import { default as ze } from "./components/form/FormVerifyImage.vue.mjs";
+import { default as Ye } from "./components/list-page/ListPage.vue.mjs";
+import { default as Qe } from "./components/panel/PanelEditSwitch.vue.mjs";
+import { ROUTE_MODULE_LEVEL as Je, TabsMainReplaceQueryKey as Ze } from "./config/route.mjs";
+import { default as et } from "./components/table/TableMain.vue.mjs";
+import { default as ot } from "./components/display/TabsMain.vue.mjs";
+import { countAll as at, createListApi as mt, fetchListAll as ft } from "./helpers/list-helper.mjs";
+import { createGenerateRouteMetaRawTree as lt } from "./helpers/route.mjs";
+import { createStorageWithNamespace as it } from "./helpers/storage.mjs";
+import { createUseState as pt } from "./helpers/state.mjs";
+import { createUserStore as dt } from "./store/user.mjs";
+import { flatRouteMetaResolveRaw as It, getRoutePermissionKey as Et } from "./utils/router.mjs";
+import { getId as Mt } from "./utils/id.mjs";
+import { timeCountDown as _t } from "./utils/time.mjs";
+import { useActivated as St, useActivatedEvent as Tt, useActivatedExec as Ft } from "./hooks/activated.mjs";
+import { useFeelSize as Pt } from "./hooks/feel-size.mjs";
+import { useMenusDataDispatch as Ot } from "./hooks/menus-dispatch.mjs";
+import { useTimeout as Dt } from "./hooks/timeout.mjs";
+const E = {
   install(e) {
-    e.use(t), e.use(o), e.use(r), e.use(a), e.use(m), e.use(f), e.use(s);
+    e.use(t), e.use(o), e.use(r), e.use(a), e.use(m), e.use(f), e.use(s), e.use(l);
   }
 };
 export {
-  q as APP_API_LIST_MODEL_KEY_CONFIG,
-  _ as ActionBtn,
+  fe as APP_API_LIST_MODEL_KEY_CONFIG,
+  C as ActionBtn,
   T as ActionButton,
-  F as ActionButtonDanger,
+  L as ActionButtonDanger,
   R as ActionButtonWarn,
-  Z as ActionConfirm,
-  ee as AutoRefresh,
-  oe as BODY_CONTENT_VIEWPORT_HEIGHT,
-  me as ConfirmModal,
-  O as DetailModal,
-  se as EXPORT_MAX_LIMIT,
-  ne as FORM_CONFIG_SELECT_ALL_VALUE,
-  Ie as FORM_ITEM_CHANGE_LOADING,
-  re as FULLSCREEN_HEIGHT_CHANNEL,
-  D as FormMain,
-  h as FormRadioGroup,
-  he as FormSearch,
-  b as FormSelect,
-  v as FormTree,
-  H as FormVerifyCode,
-  be as FormVerifyImage,
-  V as HeightProvider,
-  ve as ListPage,
-  W as MenuItemSub,
-  k as MenuTree,
-  le as OPERATE_COLUMN_PROP,
-  He as ROUTE_MODULE_LEVEL,
-  we as TableMain,
-  Ke as TabsMain,
-  Ue as TabsMainReplaceQueryKey,
-  X as TriggerAutoImport,
-  Q as WatchSize,
-  ze as countAll,
-  g as createAdminBridge,
-  je as createGenerateRouteMetaRawTree,
-  Xe as createListApi,
-  Je as createStorageWithNamespace,
-  $e as createUseState,
-  tt as createUserStore,
+  le as ActionConfirm,
+  ie as AutoRefresh,
+  pe as BODY_CONTENT_VIEWPORT_HEIGHT,
+  Ie as ConfirmModal,
+  h as DetailModal,
+  ge as EXPORT_MAX_LIMIT,
+  Se as FORM_CONFIG_SELECT_ALL_VALUE,
+  Re as FORM_ITEM_CHANGE_LOADING,
+  xe as FULLSCREEN_HEIGHT_CHANNEL,
+  N as FormMain,
+  b as FormRadioGroup,
+  We as FormSearch,
+  v as FormSelect,
+  B as FormTree,
+  U as FormVerifyCode,
+  ze as FormVerifyImage,
+  K as HeightProvider,
+  Ye as ListPage,
+  k as MenuItemSub,
+  X as MenuTree,
+  j as ModalPorter,
+  q as ModalShelf,
+  Me as OPERATE_COLUMN_PROP,
+  Qe as PanelEditSwitch,
+  Z as PanelItem,
+  ee as PanelMain,
+  Je as ROUTE_MODULE_LEVEL,
+  et as TableMain,
+  ot as TabsMain,
+  Ze as TabsMainReplaceQueryKey,
+  oe as TriggerAutoImport,
+  ae as WatchSize,
+  at as countAll,
+  A as createAdminBridge,
+  lt as createGenerateRouteMetaRawTree,
+  mt as createListApi,
+  it as createStorageWithNamespace,
+  pt as createUseState,
+  dt as createUserStore,
   r as displayInstall,
-  ue as exportCSV,
-  Ye as fetchListAll,
-  rt as flatRouteMetaResolveRaw,
+  Ae as exportCSV,
+  ft as fetchListAll,
+  It as flatRouteMetaResolveRaw,
   t as formInstall,
-  ge as generateFormData,
-  Ae as getBlurSubmit,
-  _e as getChangeSubmit,
-  xe as getConfirmPasswordRule,
-  Ce as getDatePickerShortcuts,
-  Te as getEnterSubmit,
-  ft as getId,
-  Me as getPlaceholder,
-  at as getRoutePermissionKey,
-  Fe as getVModelSugar,
-  c as installComponents,
+  Oe as generateFormData,
+  he as getBlurSubmit,
+  De as getChangeSubmit,
+  Te as getConfirmPasswordRule,
+  Ne as getDatePickerShortcuts,
+  ye as getEnterSubmit,
+  Mt as getId,
+  de as getModalShelfInjectionKey,
+  be as getPlaceholder,
+  Et as getRoutePermissionKey,
+  Ge as getVModelSugar,
+  E as installComponents,
   s as listPageInstall,
   o as menuInstall,
   a as miscInstall,
   m as modalInstall,
-  Le as parseFormData,
-  de as passwordRule,
-  ie as pickExportColumns,
-  Re as resolveFormLayout,
-  ce as setFormComponentType,
-  Se as setInputComponent,
-  Oe as setSelectComponent,
-  Pe as stringifyFormData,
-  De as swiftFormItemConfig,
+  l as panelInstall,
+  ve as parseFormData,
+  Fe as passwordRule,
+  _e as pickExportColumns,
+  we as resolveFormLayout,
+  Le as setFormComponentType,
+  Be as setInputComponent,
+  He as setSelectComponent,
+  Ue as stringifyFormData,
+  Ve as swiftFormItemConfig,
   f as tableInstall,
-  lt as timeCountDown,
-  it as useActivated,
-  pt as useActivatedEvent,
-  nt as useActivatedExec,
-  dt as useFeelSize,
-  Et as useMenusDataDispatch,
-  gt as useTimeout
+  _t as timeCountDown,
+  St as useActivated,
+  Tt as useActivatedEvent,
+  Ft as useActivatedExec,
+  Pt as useFeelSize,
+  Ot as useMenusDataDispatch,
+  Dt as useTimeout
 };

package/es/inject/key.mjs

@@ -1,9 +1,13 @@
-const E = Symbol.for(
+const o = Symbol.for(
   "BODY_CONTENT_VIEWPORT_HEIGHT"
-), H = Symbol.for(
+), _ = Symbol.for(
   "FULLSCREEN_HEIGHT_CHANNEL"
 );
+function H(E) {
+  return Symbol.for(`MODAL_SHELF_${E}`);
+}
 export {
-  E as BODY_CONTENT_VIEWPORT_HEIGHT,
-  H as FULLSCREEN_HEIGHT_CHANNEL
+  o as BODY_CONTENT_VIEWPORT_HEIGHT,
+  _ as FULLSCREEN_HEIGHT_CHANNEL,
+  H as getModalShelfInjectionKey
 };

package/es/style.css

@@ -1 +1 @@
-.form-item-tip[data-v-0dd66b41]{text-align:left;line-height:1.5;font-size:12px}.form-item-label-hide[data-v-0dd66b41] .el-form-item__label-wrap{display:none}.form-search_show[data-v-8896356d]{margin-bottom:10px}.form-search .btn-box[data-v-8896356d]{padding-left:20px}.form-search[data-v-8896356d] .el-col{padding-left:14px}.form-verify-image[data-v-a4baf877] .el-input__suffix-inner *{margin:0}.form-verify-image-suffix[data-v-a4baf877]{position:absolute;height:100%;border-radius:var(--el-input-border-radius, var(--el-border-radius-base));top:50%;transform:translateY(-50%);overflow:hidden;cursor:pointer}.form-verify-image-suffix-main[data-v-a4baf877]{position:absolute;left:0;top:0;width:100%;height:100%;background-color:#f4f4f4}.tabs-main-bar[data-v-c9b7515f]{position:relative;display:flex;align-items:center}.tabs-main-bar-item[data-v-c9b7515f]{padding:8px 16px;border:none;background:transparent;font-size:14px;color:var(--el-text-color-regular);cursor:pointer}.tabs-main-bar-item_active[data-v-c9b7515f]{color:var(--el-color-primary)}.tabs-main-bar-indicator[data-v-c9b7515f]{position:absolute;bottom:0;left:0;height:2px;background:var(--el-color-primary);transition:transform .2s,width .2s}.auto-refresh[data-v-9d78ca06]{display:flex;align-items:center;gap:8px}.auto-refresh-label[data-v-9d78ca06]{font-size:13px;color:var(--el-text-color-regular)}.auto-refresh-interval[data-v-9d78ca06]{width:80px}.action-confirm__title[data-v-1003e4cb]{font-weight:600;margin-bottom:6px}.action-confirm__content[data-v-1003e4cb]{margin-bottom:12px;color:var(--el-text-color-regular)}.action-confirm__actions[data-v-1003e4cb]{display:flex;justify-content:flex-end;gap:8px}.confirm-dialog .content[data-v-2f0c870e]{overflow-x:hidden;overflow-y:auto;max-height:calc(100vh - 200px)}.confirm-dialog .btn[data-v-2f0c870e]{width:150px;height:40px;border-radius:4px}.confirm-dialog .main[data-v-2f0c870e]{position:relative;text-align:center}.confirm-dialog .main .close-box[data-v-2f0c870e]{position:absolute;top:0;right:0;cursor:pointer;z-index:2}.confirm-dialog .main .shim[data-v-2f0c870e]{position:relative;z-index:1}.confirm-dialog .main .shim .title[data-v-2f0c870e]{font-size:18px;font-weight:500}.confirm-dialog .main .shim .content[data-v-2f0c870e]{font-size:16px;margin-top:15px}.confirm-dialog .main .shim .footer[data-v-2f0c870e]{display:flex;justify-content:center;align-items:center;padding-top:5px}.confirm-dialog .main .shim .footer>.btn[data-v-2f0c870e]:not(:last-child){margin-right:30px}.confirm-dialog .main .shim .footer[reverse=true][data-v-2f0c870e]{flex-direction:row-reverse}.confirm-dialog .main .shim .footer[reverse=true]>.btn[data-v-2f0c870e]:not(:last-child){margin-right:0;margin-left:30px}.confirm-dialog .el-dialog__header,.confirm-dialog .el-dialog__body{padding:0;background-color:transparent}.table-toolbar[data-v-90cd7b54]{display:flex;justify-content:space-between;align-items:center;padding-bottom:8px;gap:20px}.table-toolbar-left[data-v-90cd7b54],.table-toolbar-right[data-v-90cd7b54]{display:flex;align-items:center;gap:10px}.table-toolbar-icon--rotating[data-v-90cd7b54]{animation:table-toolbar-rotating-90cd7b54 1s linear infinite}@keyframes table-toolbar-rotating-90cd7b54{0%{transform:rotate(0)}to{transform:rotate(360deg)}}.data-list-view[data-v-4c7d7547]{width:100%}.table-main-table[data-v-d70ba841]{--el-table-header-bg-color: var(--e731a8f2)}.table-main-pagination[data-v-d70ba841]{margin-top:10px;display:flex;justify-content:flex-end}.list-page[data-v-e22c3b7c]{min-height:var(--v09e0228a)}.list-page-header[data-v-e22c3b7c],.list-page-operation[data-v-e22c3b7c]{margin-bottom:10px}.list-page[data-v-e22c3b7c] .el-loading-mask{left:-10px;top:-10px;right:-10px;bottom:-10px}
+.form-item-tip[data-v-0dd66b41]{text-align:left;line-height:1.5;font-size:12px}.form-item-label-hide[data-v-0dd66b41] .el-form-item__label-wrap{display:none}.form-search_show[data-v-8896356d]{margin-bottom:10px}.form-search .btn-box[data-v-8896356d]{padding-left:20px}.form-search[data-v-8896356d] .el-col{padding-left:14px}.form-verify-image[data-v-a4baf877] .el-input__suffix-inner *{margin:0}.form-verify-image-suffix[data-v-a4baf877]{position:absolute;height:100%;border-radius:var(--el-input-border-radius, var(--el-border-radius-base));top:50%;transform:translateY(-50%);overflow:hidden;cursor:pointer}.form-verify-image-suffix-main[data-v-a4baf877]{position:absolute;left:0;top:0;width:100%;height:100%;background-color:#f4f4f4}.tabs-main-bar[data-v-c9b7515f]{position:relative;display:flex;align-items:center}.tabs-main-bar-item[data-v-c9b7515f]{padding:8px 16px;border:none;background:transparent;font-size:14px;color:var(--el-text-color-regular);cursor:pointer}.tabs-main-bar-item_active[data-v-c9b7515f]{color:var(--el-color-primary)}.tabs-main-bar-indicator[data-v-c9b7515f]{position:absolute;bottom:0;left:0;height:2px;background:var(--el-color-primary);transition:transform .2s,width .2s}.auto-refresh[data-v-9d78ca06]{display:flex;align-items:center;gap:8px}.auto-refresh-label[data-v-9d78ca06]{font-size:13px;color:var(--el-text-color-regular)}.auto-refresh-interval[data-v-9d78ca06]{width:80px}.action-confirm__title[data-v-1003e4cb]{font-weight:600;margin-bottom:6px}.action-confirm__content[data-v-1003e4cb]{margin-bottom:12px;color:var(--el-text-color-regular)}.action-confirm__actions[data-v-1003e4cb]{display:flex;justify-content:flex-end;gap:8px}.confirm-dialog .content[data-v-2f0c870e]{overflow-x:hidden;overflow-y:auto;max-height:calc(100vh - 200px)}.confirm-dialog .btn[data-v-2f0c870e]{width:150px;height:40px;border-radius:4px}.confirm-dialog .main[data-v-2f0c870e]{position:relative;text-align:center}.confirm-dialog .main .close-box[data-v-2f0c870e]{position:absolute;top:0;right:0;cursor:pointer;z-index:2}.confirm-dialog .main .shim[data-v-2f0c870e]{position:relative;z-index:1}.confirm-dialog .main .shim .title[data-v-2f0c870e]{font-size:18px;font-weight:500}.confirm-dialog .main .shim .content[data-v-2f0c870e]{font-size:16px;margin-top:15px}.confirm-dialog .main .shim .footer[data-v-2f0c870e]{display:flex;justify-content:center;align-items:center;padding-top:5px}.confirm-dialog .main .shim .footer>.btn[data-v-2f0c870e]:not(:last-child){margin-right:30px}.confirm-dialog .main .shim .footer[reverse=true][data-v-2f0c870e]{flex-direction:row-reverse}.confirm-dialog .main .shim .footer[reverse=true]>.btn[data-v-2f0c870e]:not(:last-child){margin-right:0;margin-left:30px}.confirm-dialog .el-dialog__header,.confirm-dialog .el-dialog__body{padding:0;background-color:transparent}.table-toolbar[data-v-90cd7b54]{display:flex;justify-content:space-between;align-items:center;padding-bottom:8px;gap:20px}.table-toolbar-left[data-v-90cd7b54],.table-toolbar-right[data-v-90cd7b54]{display:flex;align-items:center;gap:10px}.table-toolbar-icon--rotating[data-v-90cd7b54]{animation:table-toolbar-rotating-90cd7b54 1s linear infinite}@keyframes table-toolbar-rotating-90cd7b54{0%{transform:rotate(0)}to{transform:rotate(360deg)}}.data-list-view[data-v-4c7d7547]{width:100%}.table-main-table[data-v-d70ba841]{--el-table-header-bg-color: var(--e731a8f2)}.table-main-pagination[data-v-d70ba841]{margin-top:10px;display:flex;justify-content:flex-end}.list-page[data-v-e22c3b7c]{min-height:var(--v09e0228a)}.list-page-header[data-v-e22c3b7c],.list-page-operation[data-v-e22c3b7c]{margin-bottom:10px}.list-page[data-v-e22c3b7c] .el-loading-mask{left:-10px;top:-10px;right:-10px;bottom:-10px}.panel-edit-switch[data-v-ea2a07d5]{position:relative}.panel-edit-switch-edit-btn[data-v-ea2a07d5]{position:absolute;top:0;right:0;z-index:1}.panel-edit-switch-actions[data-v-ea2a07d5]{display:flex;justify-content:flex-end;gap:8px;margin-top:8px}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@done-coding/admin-core",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "后台管理核心",
   "private": false,
   "main": "lib/index.cjs",
@@ -77,5 +77,5 @@
     "node": ">=18.0.0",
     "pnpm": ">=9.0.0"
   },
-  "gitHead": "f4a73c50566857dfab79b6dc2ab3c8421d5ea100"
+  "gitHead": "57917c0c51b696e75b0ebe1f701be13ca512364a"
 }

package/types/components/misc/ActionConfirm.vue.d.ts

@@ -12,8 +12,8 @@ declare const __VLS_component: import('vue').DefineComponent<globalThis.ExtractP
     confirmText: string;
     cancelText: string;
 }>>> & Readonly<{}>, {
-    confirmText: string;
     cancelText: string;
+    confirmText: string;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
 declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, ReturnType<typeof __VLS_template>>;
 export default _default;

package/types/components/modal/ConfirmModal.vue.d.ts

@@ -72,12 +72,12 @@ declare const __VLS_component: import('vue').DefineComponent<globalThis.ExtractP
 }>>> & Readonly<{
     "onUpdate:show"?: ((value: boolean) => any) | undefined;
 }>, {
-    width: number | string;
-    reverse: boolean;
     showClose: boolean;
-    confirmText: string | (() => VNode);
     cancelText: string | (() => VNode);
+    confirmText: string | (() => VNode);
     hiddenCancel: boolean;
+    width: number | string;
+    reverse: boolean;
     closeOnPressEscape: boolean;
     closeOnClickModal: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;

package/types/components/modal/ModalPorter.vue.d.ts

@@ -0,0 +1,29 @@
+import { EvokeHandle, ModalShelfMap, RegisterEntry } from './modal-shelf-types';
+
+declare function evoke<K extends keyof ModalShelfMap>(key: K, payload: ModalShelfMap[K]): EvokeHandle | null;
+declare function __VLS_template(): {
+    default?(_: {}): any;
+};
+declare const __VLS_component: import('vue').DefineComponent<globalThis.ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
+    modalList: RegisterEntry[];
+}>>, {
+    evoke: typeof evoke;
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<globalThis.ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
+    modalList: RegisterEntry[];
+}>>> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, ReturnType<typeof __VLS_template>>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/types/components/modal/ModalShelf.vue.d.ts

@@ -0,0 +1,36 @@
+import { Component } from 'vue';
+import { ModalLevel } from './modal-shelf-types';
+
+declare function __VLS_template(): {
+    default?(_: {}): any;
+};
+declare const __VLS_component: import('vue').DefineComponent<globalThis.ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
+    level: ModalLevel;
+}>>, {
+    items: Ref<import('./modal-shelf-types').ShelfItem[]>;
+    level: ModalLevel;
+    evoke: (nsKey: string, component: Component | (() => Promise<Component>), options: {
+        payload: Record<string, unknown>;
+        sameKeyStrategy?: import('./modal-shelf-types').ModalSameKeyStrategy;
+    }) => import('./modal-shelf-types').EvokeHandle;
+    remove: (nsKey: string | string[]) => void;
+    close: (item: import('./modal-shelf-types').ShelfItem) => void;
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<globalThis.ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
+    level: ModalLevel;
+}>>> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, ReturnType<typeof __VLS_template>>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/types/components/modal/index.d.ts

@@ -1,7 +1,11 @@
 import { Plugin } from 'vue';
 import { default as ConfirmModal } from './ConfirmModal.vue';
 import { default as DetailModal } from './DetailModal.vue';
+import { default as ModalShelf } from './ModalShelf.vue';
+import { default as ModalPorter } from './ModalPorter.vue';
 
 export * from './types';
-export { ConfirmModal, DetailModal };
+export * from './modal-shelf-types';
+export { ConfirmModal, DetailModal, ModalShelf, ModalPorter };
+/** 弹窗子模块批量注册插件 */
 export declare const modalInstall: Plugin;

package/types/components/modal/modal-shelf-core.d.ts

@@ -0,0 +1,10 @@
+import { Ref } from 'vue';
+import { ModalLevel, ShelfController, ShelfItem } from './modal-shelf-types';
+
+/** ShelfController 内部扩展：额外暴露渲染用活跃实例列表 */
+export interface ShelfControllerInternal extends ShelfController {
+    /** 渲染用：当前活跃实例列表（多例数组） */
+    items: Ref<ShelfItem[]>;
+}
+/** 创建一个架子逻辑控制器（纯逻辑，无 DOM 依赖，可单测） */
+export declare function createShelfController(level: ModalLevel): ShelfControllerInternal;

package/types/components/modal/modal-shelf-hierarchy.d.ts

@@ -0,0 +1,7 @@
+import { ModalLevel } from './modal-shelf-types';
+
+/**
+ * 层级合法性：app 必最顶层；page 祖先仅允许 app；custom 可嵌套任何（含 custom 套 custom）。
+ * 非法仅开发期 console.error，不抛、不静默。
+ */
+export declare function assertLevelHierarchy(level: ModalLevel, ancestorLevels: ModalLevel[]): void;

package/types/components/modal/modal-shelf-types.d.ts

@@ -0,0 +1,74 @@
+import { Component } from 'vue';
+
+/** 架子层级 */
+export type ModalLevel = "app" | "page" | "custom";
+/** 同 key 再 evoke 策略：recreate=关旧重建(默认)；update=已开则整体替换 props 不 remount */
+export type ModalSameKeyStrategy = "recreate" | "update";
+/**
+ * 业务侧 declare merge 扩展此接口声明每个弹窗的业务 props 契约。
+ * 例：declare module "@done-coding/admin-core" {
+ *   interface ModalShelfMap { detail: { id: string; onConfirm?: (r: unknown) => void } }
+ * }
+ */
+export interface ModalShelfMap {
+}
+/** 架子注入给弹窗组件的契约（业务 payload 经单 payload 对象传入） */
+export interface ModalInjectedProps<P = Record<string, unknown>> {
+    /** v-model:show 受控可见性 */
+    show: boolean;
+    /** 优雅关闭（隐藏→等动画→移除），=== EvokeHandle.close */
+    closeFn: () => void;
+    /** 立即移除（无动画） */
+    removeFn: () => void;
+    /** 业务 payload（ModalShelfMap[key]） */
+    payload: P;
+}
+/** evoke 返回的命令式句柄；只绑稳定 nsKey，调用时现查当前实例（不闭包 id） */
+export interface EvokeHandle {
+    /** 优雅关闭该 nsKey 当前实例；无则 no-op */
+    close: () => void;
+    /** 对该 nsKey 当前实例受控增量合并 payload（不 remount）；无则 no-op */
+    update: (partialPayload: Record<string, unknown>) => void;
+}
+/** 注册项（扁平，无 options 包裹，无 isSingle——v1 仅多例） */
+export interface RegisterEntry<K extends keyof ModalShelfMap = keyof ModalShelfMap> {
+    /** 弹窗逻辑 key */
+    key: K;
+    /** 组件或懒工厂（() => import()） */
+    component: Component | (() => Promise<Component>);
+    /** 目标架子：app/page 名称代指，或直接持 ShelfInstance */
+    shelf: "app" | "page" | ShelfInstance;
+    /** 同 key 再 evoke 策略，缺省 "recreate" */
+    sameKeyStrategy?: ModalSameKeyStrategy;
+}
+/** 架子内部一条活跃实例 */
+export interface ShelfItem {
+    /** 架子内部自增唯一 id，用作渲染 :key */
+    id: number;
+    /** porter 命名空间后的注册键 p{porterUid}:{key} */
+    nsKey: string;
+    /** 组件或懒工厂 */
+    component: Component | (() => Promise<Component>);
+    /** 业务 payload */
+    payload: Record<string, unknown>;
+    /** v-model:show */
+    show: boolean;
+    /** close 排定的关闭动画定时器句柄；remove 立即移除前 [MUST] clearTimeout 它 */
+    timer?: ReturnType<typeof setTimeout>;
+}
+/** ModalShelf 实例 expose === 它 provide 的 controller */
+export interface ShelfController {
+    /** 本架子层级 */
+    level: ModalLevel;
+    /** 唤起一条；同 nsKey 先 remove(立即) 旧再新建 */
+    evoke: (nsKey: string, component: Component | (() => Promise<Component>), options: {
+        payload: Record<string, unknown>;
+        sameKeyStrategy?: ModalSameKeyStrategy;
+    }) => EvokeHandle;
+    /** 立即移除（不等动画），支持单个或批量 */
+    remove: (nsKey: string | string[]) => void;
+    /** 优雅关闭某条（触发隐藏 → 动画结束 → 移除） */
+    close: (item: ShelfItem) => void;
+}
+/** ModalShelf 实例引用类型别名（用于 RegisterEntry.shelf 直接持实例定位 custom 架子） */
+export type ShelfInstance = ShelfController;

package/types/components/panel/PanelEditSwitch.vue.d.ts

@@ -0,0 +1,31 @@
+import { PanelEditSwitchProps } from './types';
+
+declare function __VLS_template(): {
+    default?(_: {}): any;
+    editor?(_: {
+        data: Record<string, any>;
+    }): any;
+};
+declare const __VLS_component: import('vue').DefineComponent<globalThis.ExtractPropTypes<__VLS_TypePropsToRuntimeProps<PanelEditSwitchProps<Record<string, any>>>>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "update:editing": (value: boolean) => void;
+    submitFinish: (success: boolean, data: Record<string, any>) => void;
+}, string, import('vue').PublicProps, Readonly<globalThis.ExtractPropTypes<__VLS_TypePropsToRuntimeProps<PanelEditSwitchProps<Record<string, any>>>>> & Readonly<{
+    "onUpdate:editing"?: ((value: boolean) => any) | undefined;
+    onSubmitFinish?: ((success: boolean, data: Record<string, any>) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, ReturnType<typeof __VLS_template>>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/types/components/panel/PanelItem.vue.d.ts

@@ -0,0 +1,21 @@
+import { PanelItemProps } from './types';
+
+declare const _default: import('vue').DefineComponent<globalThis.ExtractPropTypes<__VLS_TypePropsToRuntimeProps<PanelItemProps<Record<string, any>>>>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "update:editing": (value: boolean) => void;
+    submitFinish: (success: boolean, data: Record<string, any>) => void;
+    refresh: () => void;
+}, string, import('vue').PublicProps, Readonly<globalThis.ExtractPropTypes<__VLS_TypePropsToRuntimeProps<PanelItemProps<Record<string, any>>>>> & Readonly<{
+    onRefresh?: (() => any) | undefined;
+    "onUpdate:editing"?: ((value: boolean) => any) | undefined;
+    onSubmitFinish?: ((success: boolean, data: Record<string, any>) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};

package/types/components/panel/PanelMain.vue.d.ts

@@ -0,0 +1,17 @@
+import { PanelMainProps } from './types';
+
+declare const _default: <T extends Record<string, any>>(__VLS_props: Awaited<typeof __VLS_setup>["props"], __VLS_ctx?: __VLS_Prettify<Pick<Awaited<typeof __VLS_setup>, "attrs" | "emit" | "slots">>, __VLS_expose?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+    props: __VLS_Prettify<__VLS_OmitKeepDiscriminatedUnion<(Partial<{}> & Omit<{
+        readonly onRefresh?: ((data: T) => any) | undefined;
+    } & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps, never>) & PanelMainProps<T>, keyof import('vue').VNodeProps | keyof import('vue').AllowedComponentProps>> & {} & (import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps);
+    expose(exposed: import('vue').ShallowUnwrapRef<{}>): void;
+    attrs: any;
+    slots: ReturnType<() => {}>;
+    emit: (e: "refresh", data: T) => void;
+}>) => import('vue').VNode & {
+    __ctx?: Awaited<typeof __VLS_setup>;
+};
+export default _default;
+type __VLS_Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};

package/types/components/panel/index.d.ts

@@ -0,0 +1,9 @@
+import { Plugin } from 'vue';
+import { default as PanelMain } from './PanelMain.vue';
+import { default as PanelItem } from './PanelItem.vue';
+import { default as PanelEditSwitch } from './PanelEditSwitch.vue';
+
+export * from './types';
+export { PanelMain, PanelItem, PanelEditSwitch };
+/** Panel 组件族一键注册插件（app.use(panelInstall)） */
+export declare const panelInstall: Plugin;

package/types/components/panel/types.d.ts

@@ -0,0 +1,62 @@
+import { VNode } from 'vue';
+import { ColProps } from 'element-plus';
+
+/** Panel 只读渲染作用域（render 用） */
+export interface PanelScope<T extends Record<string, any> = Record<string, any>> {
+    /** 原始数据（只读消费，[MUST NOT] 在 render 内修改） */
+    data: T;
+    /** data[config.key] */
+    value: any;
+    config: PanelItemConfig<T>;
+    /** 请求 PanelMain 向父层触发 refresh（preview 组件绕开 PanelEditSwitch 刷新用） */
+    refresh?: () => void;
+}
+/** Panel 编辑器作用域（editorRender 用，data = 深克隆副本） */
+export interface PanelEditorScope<T extends Record<string, any> = Record<string, any>> {
+    /** PanelEditSwitch 内部深克隆副本（编辑器直接改它） */
+    data: T;
+    /** data[config.key]（克隆体上的值） */
+    value: any;
+    config: PanelItemConfig<T>;
+}
+/** Panel 配置项 */
+export interface PanelItemConfig<T extends Record<string, any> = Record<string, any>> {
+    /** 数据键 */
+    key: string;
+    /** 标签，非必填 */
+    label?: string;
+    /** 栅格布局，复用 resolveFormLayout 语义；缺省继承 PanelMain.layout */
+    layout?: Partial<ColProps>;
+    /** 顺序，缺省按数组序 */
+    order?: number;
+    /** 隐藏 */
+    hide?: boolean | ((scope: PanelScope<T>) => boolean);
+    /** 只读渲染；缺省=纯文本 data[key] */
+    render?: string | Record<string, any> | ((scope: PanelScope<T>) => VNode);
+    /** 是否可就地编辑 */
+    editable?: boolean | ((scope: PanelScope<T>) => boolean);
+    /** 编辑器渲染；仅 editable 时需要 */
+    editorRender?: string | Record<string, any> | ((scope: PanelEditorScope<T>) => VNode);
+    /** 单字段提交；仅 editable 时需要。draft = 深克隆副本 */
+    submitFn?: (draft: T) => Promise<unknown>;
+}
+/** Panel 配置项列表 */
+export type PanelItemConfigList<T extends Record<string, any> = Record<string, any>> = PanelItemConfig<T>[];
+/** PanelMain props */
+export interface PanelMainProps<T extends Record<string, any> = Record<string, any>> {
+    data: T;
+    layout?: Partial<ColProps>;
+    list: PanelItemConfigList<T>;
+}
+/** PanelItem props */
+export interface PanelItemProps<T extends Record<string, any> = Record<string, any>> {
+    data: T;
+    config: PanelItemConfig<T>;
+    editing: boolean;
+}
+/** PanelEditSwitch props */
+export interface PanelEditSwitchProps<T extends Record<string, any> = Record<string, any>> {
+    data: T;
+    editing: boolean;
+    submitFn?: (draft: T) => Promise<unknown>;
+}

package/types/components/table/TableToolbar.vue.d.ts

@@ -2,14 +2,14 @@ import { ExportType, TableExportContext, TableMainInstance } from './types';
 
 declare const _default: import('vue').DefineComponent<globalThis.ExtractPropTypes<{
     isAutoRefresh: import('vue').PropType<boolean>;
-    pageSize: {
-        type: globalThis.PropType<number>;
-        required: true;
-    };
     loading: {
         type: globalThis.PropType<boolean>;
         required: true;
     };
+    pageSize: {
+        type: globalThis.PropType<number>;
+        required: true;
+    };
     showRefresh: {
         type: globalThis.PropType<boolean>;
         default: boolean;
@@ -52,14 +52,14 @@ declare const _default: import('vue').DefineComponent<globalThis.ExtractPropType
     };
 }>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<globalThis.ExtractPropTypes<{
     isAutoRefresh: import('vue').PropType<boolean>;
-    pageSize: {
-        type: globalThis.PropType<number>;
-        required: true;
-    };
     loading: {
         type: globalThis.PropType<boolean>;
         required: true;
     };
+    pageSize: {
+        type: globalThis.PropType<number>;
+        required: true;
+    };
     showRefresh: {
         type: globalThis.PropType<boolean>;
         default: boolean;

package/types/index.d.ts

@@ -6,6 +6,7 @@ import { miscInstall } from './components/misc';
 import { modalInstall } from './components/modal';
 import { tableInstall } from './components/table';
 import { listPageInstall } from './components/list-page';
+import { panelInstall } from './components/panel';
 
 export * from './components/form';
 export * from './components/menu';
@@ -14,6 +15,7 @@ export * from './components/misc';
 export * from './components/modal';
 export * from './components/table';
 export * from './components/list-page';
+export * from './components/panel';
 export * from './utils';
 export * from './hooks';
 export * from './types';
@@ -22,5 +24,5 @@ export * from './inject';
 export * from './helpers';
 export * from './bridge';
 export * from './store';
-export { formInstall, menuInstall, displayInstall, miscInstall, modalInstall, tableInstall, listPageInstall, };
+export { formInstall, menuInstall, displayInstall, miscInstall, modalInstall, tableInstall, listPageInstall, panelInstall, };
 export declare const installComponents: Plugin;

package/types/inject/key.d.ts

@@ -1,3 +1,6 @@
+import { InjectionKey } from 'vue';
+import { ModalLevel, ShelfController } from '../components/modal';
+
 /**
  * body 视口高度
  * ---
@@ -20,3 +23,8 @@ export declare const BODY_CONTENT_VIEWPORT_HEIGHT: unique symbol;
  * 导致 provide/inject 失配 → 预算链断裂）。
  */
 export declare const FULLSCREEN_HEIGHT_CHANNEL: unique symbol;
+/**
+ * 弹窗架子 inject key 工厂——按 level 参数化。
+ * Symbol.for 全局注册表保证跨包/跨 chunk/跨 ESM 实例唯一（同 BODY_CONTENT_VIEWPORT_HEIGHT）。
+ */
+export declare function getModalShelfInjectionKey(level: ModalLevel): InjectionKey<ShelfController>;