@done-coding/admin-core 0.27.0 → 0.28.0

package/es/bridge/index.mjs

@@ -1,4 +1,4 @@
-import { computed } from "vue";
+import { computed, shallowRef, ref } from "vue";
 import { createStorageWithNamespace } from "./storage.mjs";
 import { createUseState } from "./state.mjs";
 import { createGenerateRouteMetaRawTree } from "./route.mjs";
@@ -35,7 +35,7 @@ function createCoreBridge(options) {
     ...options.APP_LAYOUT_ASIDE_CONFIG
   };
   const gapConfig = {
-    size: 0,
+    size: 8,
     ...options.APP_LAYOUT_GAP_CONFIG
   };
   const configHook = createBridgeConfigHook({
@@ -95,6 +95,8 @@ function createCoreBridge(options) {
   let logoutApiFn;
   let getUserInfoApiFn;
   let refreshTokenApiFn;
+  const aiFillTriggerRef = shallowRef(void 0);
+  const aiFillRequireDescriptionRef = ref(false);
   const msg = (name) => `bridge: ${name} 未注册`;
   const pluginHost = createBridgePluginHost();
   const bridgeInstance = {
@@ -107,6 +109,9 @@ function createCoreBridge(options) {
       if (options2.logoutApi) logoutApiFn = options2.logoutApi;
       if (options2.getUserInfoApi) getUserInfoApiFn = options2.getUserInfoApi;
       if (options2.refreshTokenApi) refreshTokenApiFn = options2.refreshTokenApi;
+      if (options2.aiFillTrigger) aiFillTriggerRef.value = options2.aiFillTrigger;
+      if (options2.aiFillRequireDescription !== void 0)
+        aiFillRequireDescriptionRef.value = options2.aiFillRequireDescription;
     },
     // 已注册返回 undefined 是合法业务态不 throw
     // v3 终锁 Δ8b：零参 facade（BR-1 ③ 终裁——core 对 UserInfo 不透明 + 拦截器无 info 源）
@@ -290,7 +295,10 @@ function createCoreBridge(options) {
       if (!refreshTokenApiFn)
         return Promise.reject(new Error(msg("refreshTokenApi")));
       return refreshTokenApiFn(refreshToken);
-    }
+    },
+    // AI 填充触发组件槽位（gf9z3w）：只读透出，消费方（FormMain）自渲染
+    aiFillTrigger: aiFillTriggerRef,
+    aiFillRequireDescription: aiFillRequireDescriptionRef
   };
   return bridgeInstance;
 }

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

@@ -1,7 +1,7 @@
 import _sfc_main from "./AppBody.vue2.mjs";
 /* empty css              */
 import _export_sfc from "../../_virtual/_plugin-vue_export-helper.mjs";
-const AppBody = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-746de972"]]);
+const AppBody = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-ca48e9a0"]]);
 export {
   AppBody as default
 };

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

@@ -1,4 +1,4 @@
-import { defineComponent, useCssVars, inject, ref, computed, provide, readonly, watch, resolveComponent, openBlock, createElementBlock, normalizeStyle, createElementVNode, createBlock, unref, withCtx, createVNode, createCommentVNode, KeepAlive, resolveDynamicComponent, renderSlot } from "vue";
+import { defineComponent, useCssVars, inject, ref, computed, provide, readonly, onMounted, watch, resolveComponent, openBlock, createElementBlock, normalizeStyle, createElementVNode, createBlock, unref, withCtx, createVNode, createCommentVNode, KeepAlive, resolveDynamicComponent, renderSlot } from "vue";
 import { ElAffix } from "element-plus";
 import AppBreadcrumb from "./AppBreadcrumb.vue.mjs";
 import { isKeepAliveRoute, keepAliveRouteKey } from "./keep-alive.mjs";
@@ -12,7 +12,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
   },
   setup(__props) {
     useCssVars((_ctx) => ({
-      "v03873635": contentViewHeight.value
+      "ece8e1ac": contentViewHeight.value
     }));
     const appStore = inject(APP_LAYOUT_APP_STORE_KEY);
     const bridge = inject(APP_LAYOUT_BRIDGE_KEY);
@@ -29,6 +29,13 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
     const bodyShimPadding = computed(() => {
       return appStore.bodyShimPadding;
     });
+    onMounted(() => {
+      if (bodyShimPadding.value) {
+        console.warn(
+          `[dc-layout] APP_LAYOUT_BODY_CONFIG.shimPadding（当前 ${bodyShimPadding.value}）已废弃且**不再影响任何渲染**。内容四周留白改由间距阶梯的外圈档（gap × 2）给出 —— 要调留白请改 APP_LAYOUT_GAP_CONFIG.size，一个旋钮按比例缩放「外圈 / 呼吸 / 模块 / 分段」四档。本字段将在下一个版本移除。`
+        );
+      }
+    });
     const bodyShimStyle = computed(() => {
       return appStore.bodyShimStyle;
     });
@@ -42,8 +49,10 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
       left: appStore.bodyStyle.paddingLeft,
       right: appStore.bodyStyle.paddingRight,
       bottom: `calc(100vh - ${appStore.bodyStyle.paddingTop} - ${bodyShimStyle.value.minHeight})`,
-      // app-body-shim 内边距：供 AppPage 各插槽 shim 朝 chrome 侧留呼吸
-      shimPadding: bodyShimPadding.value
+      // @deprecated huhyx7 起恒 0：shim 不再铺 padding，插槽也不需要复刻它的呼吸
+      // （插槽本就贴在 .app-body 的 padding 盒边缘，外圈档已给过呼吸）。
+      // 字段保留一个版本供下游过渡，[MUST NOT] 再拿它算任何几何。
+      shimPadding: 0
     }));
     provide(BODY_CONTENT_VIEWPORT_RECT, contentViewportRect);
     provide(
@@ -51,7 +60,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
       computed(() => appStore.contentViewportInset)
     );
     const contentViewHeight = computed(
-      () => `calc(${bodyShimStyle.value.minHeight} - ${showBreadcrumb.value && affixIsShow.value ? affixHeight.value : 0}px - ${bodyShimPadding.value * 2}px)`
+      () => `calc(${bodyShimStyle.value.minHeight} - ${showBreadcrumb.value && affixIsShow.value ? affixHeight.value : 0}px)`
     );
     const onAffixShow = (value) => {
       affixIsShow.value = value;

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

@@ -1,7 +1,7 @@
 import _sfc_main from "./AppHeader.vue2.mjs";
 /* empty css                */
 import _export_sfc from "../../_virtual/_plugin-vue_export-helper.mjs";
-const AppHeader = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-d887bc4c"]]);
+const AppHeader = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-9ff1c70b"]]);
 export {
   AppHeader as default
 };

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

@@ -3,6 +3,7 @@ import { useRouter } from "vue-router";
 import { ElIcon } from "element-plus";
 import BadgeMark from "../display/BadgeMark.vue.mjs";
 import { APP_LAYOUT_APP_STORE_KEY, APP_LAYOUT_BRIDGE_KEY } from "../../inject/key.mjs";
+import { domScrollIntoViewport } from "../../utils/dom.mjs";
 const _hoisted_1 = { class: "app-header-shim" };
 const _hoisted_2 = ["name", "onClick"];
 const _hoisted_3 = { class: "app-header-right" };
@@ -17,7 +18,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
   },
   setup(__props) {
     useCssVars((_ctx) => ({
-      "v7733782f": themeColors.value.primaryColor
+      "v0b60c1aa": themeColors.value.primaryColor
     }));
     const props = __props;
     const appStore = inject(APP_LAYOUT_APP_STORE_KEY);
@@ -47,10 +48,11 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
       (n) => {
         if (n) {
           nextTick(() => {
-            var _a, _b;
-            (_b = (_a = document.querySelector(`.${moduleBoxCls}`)) == null ? void 0 : _a.querySelector(`[name="${n}"]`)) == null ? void 0 : _b.scrollIntoView({
-              behavior: "smooth"
-            });
+            var _a;
+            domScrollIntoViewport(
+              (_a = document.querySelector(`.${moduleBoxCls}`)) == null ? void 0 : _a.querySelector(`[name="${n}"]`),
+              { behavior: "smooth" }
+            );
           });
         }
       },

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

@@ -1,7 +1,7 @@
 import _sfc_main from "./AppLayout.vue2.mjs";
 /* empty css                */
 import _export_sfc from "../../_virtual/_plugin-vue_export-helper.mjs";
-const AppLayout = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-b68520cd"]]);
+const AppLayout = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-140fec15"]]);
 export {
   AppLayout as default
 };

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

@@ -130,7 +130,8 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
       left: "0",
       right: "0",
       height: `calc(${props.appStore.headerStyle.top} + ${props.appStore.headerStyle.height})`,
-      background: props.bridge.themeColors.value.bodyColor,
+      background: props.bridge.APP_LAYOUT_BODY_CONFIG.background ?? "var(--el-bg-color-page, #f2f3f5)",
+      backgroundAttachment: "fixed",
       zIndex: 1,
       pointerEvents: "none"
     }));

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

@@ -1,7 +1,7 @@
 import _sfc_main from "./AppPage.vue2.mjs";
 /* empty css              */
 import _export_sfc from "../../_virtual/_plugin-vue_export-helper.mjs";
-const AppPage = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-3ef165a7"]]);
+const AppPage = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-d875cc1d"]]);
 export {
   AppPage as default
 };

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

@@ -4,8 +4,10 @@ import _sfc_main$1 from "../modal/ModalShelf.vue.mjs";
 import _sfc_main$2 from "../display/WatchSize.vue.mjs";
 import { computeAppPageReducedViewportHeight, computeAppPageReducedViewportWidth, computeAppPageContentInset, computeAppPageSlotStyles, computeAppPageSlotShimStyles } from "./app-page-geometry.mjs";
 import { useAppPageContentBox } from "./use-content-box.mjs";
-import { BODY_CONTENT_VIEWPORT_RECT, SCOPE_VIEWPORT_MAX_HEIGHT, BODY_CONTENT_VIEWPORT_HEIGHT, BODY_CONTENT_VIEWPORT_INSET, APP_PAGE_CONTENT_INSET } from "../../inject/key.mjs";
+import { APP_PAGE_LIST_LAYOUT_RECOMMENDED } from "./app-page-recommended.mjs";
+import { BODY_CONTENT_VIEWPORT_RECT, APP_LAYOUT_BRIDGE_KEY, SCOPE_VIEWPORT_MAX_HEIGHT, BODY_CONTENT_VIEWPORT_HEIGHT, BODY_CONTENT_VIEWPORT_INSET, APP_PAGE_CONTENT_INSET } from "../../inject/key.mjs";
 import { useActivated } from "../../hooks/activated.mjs";
+import { gapScaleValue } from "../../utils/gap-scale.mjs";
 import { SlotRegion } from "../../config/slot-region.mjs";
 const _hoisted_1 = ["data-dc-slot"];
 const _hoisted_2 = ["data-dc-slot"];
@@ -24,10 +26,10 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
     nextViewportMaxHeight: { default: `var(--app-viewport-max-height)` },
     background: {},
     gap: { default: 8 },
-    topBg: {},
-    bottomBg: {},
-    leftBg: {},
-    rightBg: {},
+    topBg: { default: "var(--el-bg-color)" },
+    bottomBg: { default: "var(--el-bg-color)" },
+    leftBg: { default: "var(--el-bg-color)" },
+    rightBg: { default: "var(--el-bg-color)" },
     topObserveResize: { type: Boolean, default: false },
     bottomObserveResize: { type: Boolean, default: false },
     leftObserveResize: { type: Boolean, default: false },
@@ -37,13 +39,13 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
   },
   setup(__props) {
     useCssVars((_ctx) => ({
-      "v6b53f4c2": pageCssVars.value.top,
-      "v1c770cbe": pageCssVars.value.bottom,
-      "ff323606": pageCssVars.value.left,
-      "e667c834": pageCssVars.value.right,
-      "e5daf0e0": pageCssVars.value.width,
-      "v09211ec6": pageCssVars.value.height,
-      "v0bd4b228": props.nextViewportMaxHeight
+      "b28df728": pageCssVars.value.top,
+      "d4142898": pageCssVars.value.bottom,
+      "v3063bfd0": pageCssVars.value.left,
+      "v472ac91a": pageCssVars.value.right,
+      "v469df1c6": pageCssVars.value.width,
+      "c0be3aa0": pageCssVars.value.height,
+      "v52d7da39": props.nextViewportMaxHeight
     }));
     const props = __props;
     const style = computed(() => {
@@ -55,13 +57,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
       };
     });
     const slots = useSlots();
-    const listLayoutRecommended = {
-      customView: true,
-      tableMainProps: {
-        pageLayout: "prev, pager, next",
-        paginationBackground: false
-      }
-    };
+    const listLayoutRecommended = APP_PAGE_LIST_LAYOUT_RECOMMENDED;
     const hasTop = computed(() => !!slots.top);
     const hasBottom = computed(() => !!slots.bottom);
     const hasLeft = computed(() => !!slots.left);
@@ -121,10 +117,13 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
       const r = injectedRect == null ? void 0 : injectedRect.value;
       return r ? { top: r.top, left: r.left, right: r.right, bottom: r.bottom } : fallbackRect.value;
     });
-    const shimPadding = computed(() => {
-      var _a;
-      return ((_a = injectedRect == null ? void 0 : injectedRect.value) == null ? void 0 : _a.shimPadding) ?? 0;
-    });
+    const layoutBridge = inject(APP_LAYOUT_BRIDGE_KEY, void 0);
+    const gapBase = computed(
+      () => props.gap ?? (layoutBridge == null ? void 0 : layoutBridge.APP_LAYOUT_GAP_CONFIG.size) ?? 8
+    );
+    const outerGap = computed(
+      () => gapScaleValue(gapBase.value, "outer", layoutBridge == null ? void 0 : layoutBridge.themeDensity.value)
+    );
     const slotSizes = computed(() => ({
       topH: topH.value,
       bottomH: bottomH.value,
@@ -136,7 +135,11 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
       () => computeAppPageReducedViewportHeight(
         (parentScope == null ? void 0 : parentScope.viewportMaxHeight.value) ?? 0,
         slotSizes.value,
-        shimPadding.value
+        // 🔴 [MUST] outerGap，[MUST NOT] shimPadding —— 后者 huhyx7 起恒 0
+        // （AppBody 写死 `shimPadding: 0`），传它等于「让位不含 gap」，可用高多算
+        // 一个外圈档 × 槽数 → refine 内容压槽。同文件 width 一路传的就是 outerGap，
+        // 此处是漏改（形参名早已是 outerGap）。
+        outerGap.value
       )
     );
     provide(BODY_CONTENT_VIEWPORT_HEIGHT, reducedViewportHeight);
@@ -168,7 +171,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
       () => computeAppPageReducedViewportWidth(
         pageBoxWidth.value,
         slotSizes.value,
-        shimPadding.value
+        outerGap.value
       )
     );
     const { contentGutter } = useAppPageContentBox({
@@ -208,10 +211,10 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
       };
     });
     const slotStyles = computed(
-      () => computeAppPageSlotStyles(rectInset.value, topH.value, bottomH.value)
+      () => computeAppPageSlotStyles(rectInset.value, slotSizes.value, outerGap.value)
     );
     const shimStyles = computed(() => {
-      const base = computeAppPageSlotShimStyles(shimPadding.value, props.gap);
+      const base = computeAppPageSlotShimStyles();
       return {
         top: { ...base.top, background: props.topBg },
         bottom: { ...base.bottom, background: props.bottomBg },
@@ -220,10 +223,10 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
       };
     });
     const shimStyle = computed(() => {
-      const sp = shimPadding.value;
+      const o = outerGap.value;
       const g = contentGutter.value;
-      const inset = (v) => `${Math.max(0, v ? v - sp : 0)}px`;
-      const insetX = (v) => `${Math.max(0, v ? v - sp : 0) + g}px`;
+      const inset = (v) => `${v ? v + o : 0}px`;
+      const insetX = (v) => `${(v ? v + o : 0) + g}px`;
       return {
         paddingTop: inset(topH.value),
         paddingBottom: inset(bottomH.value),
@@ -302,7 +305,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
               style: normalizeStyle(shimStyles.value.left),
               "data-dc-slot": unref(SlotRegion).AppPage_Left
             }, [
-              renderSlot(_ctx.$slots, "left", { listLayoutRecommended }, void 0, true)
+              renderSlot(_ctx.$slots, "left", { listLayoutRecommended: unref(listLayoutRecommended) }, void 0, true)
             ], 12, _hoisted_4)
           ]),
           _: 3
@@ -321,7 +324,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
               style: normalizeStyle(shimStyles.value.right),
               "data-dc-slot": unref(SlotRegion).AppPage_Right
             }, [
-              renderSlot(_ctx.$slots, "right", { listLayoutRecommended }, void 0, true)
+              renderSlot(_ctx.$slots, "right", { listLayoutRecommended: unref(listLayoutRecommended) }, void 0, true)
             ], 12, _hoisted_5)
           ]),
           _: 3

package/es/components/app-layout/app-page-geometry.mjs

@@ -1,16 +1,16 @@
-function appPageSlotInset(v, shimPadding) {
-  return v ? Math.max(0, v - shimPadding) : 0;
+function appPageSlotInset(v, outerGap) {
+  return v ? v + outerGap : 0;
 }
-function computeAppPageReducedViewportHeight(bodyViewportHeight, slotSizes, shimPadding) {
+function computeAppPageReducedViewportHeight(bodyViewportHeight, slotSizes, outerGap) {
   return Math.max(
     0,
-    bodyViewportHeight - appPageSlotInset(slotSizes.topH, shimPadding) - appPageSlotInset(slotSizes.bottomH, shimPadding)
+    bodyViewportHeight - appPageSlotInset(slotSizes.topH, outerGap) - appPageSlotInset(slotSizes.bottomH, outerGap)
   );
 }
-function computeAppPageReducedViewportWidth(pageBoxWidth, slotSizes, shimPadding) {
+function computeAppPageReducedViewportWidth(pageBoxWidth, slotSizes, outerGap) {
   return Math.max(
     0,
-    pageBoxWidth - appPageSlotInset(slotSizes.leftW, shimPadding) - appPageSlotInset(slotSizes.rightW, shimPadding)
+    pageBoxWidth - appPageSlotInset(slotSizes.leftW, outerGap) - appPageSlotInset(slotSizes.rightW, outerGap)
   );
 }
 function computeAppPageContentInset(appInset, slotSizes, gap) {
@@ -23,10 +23,14 @@ function computeAppPageContentInset(appInset, slotSizes, gap) {
   };
 }
 const APP_PAGE_SLOT_Z_INDEX = 1;
-function computeAppPageSlotStyles(rect, topH, bottomH) {
+function computeAppPageSlotStyles(rect, slotSizes, outerGap) {
   const z = APP_PAGE_SLOT_Z_INDEX;
-  const midTop = `calc(${rect.top} + ${topH}px)`;
-  const midBottom = `calc(${rect.bottom} + ${bottomH}px)`;
+  const { topH, bottomH } = slotSizes;
+  const midTop = `calc(${rect.top} + ${appPageSlotInset(topH, outerGap)}px)`;
+  const midBottom = `calc(${rect.bottom} + ${appPageSlotInset(
+    bottomH,
+    outerGap
+  )}px)`;
   return {
     top: {
       position: "fixed",
@@ -58,13 +62,9 @@ function computeAppPageSlotStyles(rect, topH, bottomH) {
     }
   };
 }
-function computeAppPageSlotShimStyles(sp, gap) {
-  return {
-    top: { padding: `${sp}px ${sp}px ${gap}px ${sp}px` },
-    bottom: { padding: `${gap}px ${sp}px ${sp}px ${sp}px` },
-    left: { padding: `0 ${gap}px 0 ${sp}px` },
-    right: { padding: `0 ${sp}px 0 ${gap}px` }
-  };
+function computeAppPageSlotShimStyles() {
+  const none = { padding: "0" };
+  return { top: none, bottom: none, left: none, right: none };
 }
 export {
   APP_PAGE_SLOT_Z_INDEX,

package/es/components/app-layout/app-page-recommended.mjs

@@ -0,0 +1,10 @@
+const APP_PAGE_LIST_LAYOUT_RECOMMENDED = {
+  customView: true,
+  tableMainProps: {
+    pageLayout: "prev, pager, next",
+    paginationBackground: false
+  }
+};
+export {
+  APP_PAGE_LIST_LAYOUT_RECOMMENDED
+};

package/es/components/data-view/DataGridView.vue.mjs

@@ -1,7 +1,7 @@
 import _sfc_main from "./DataGridView.vue2.mjs";
 /* empty css                   */
 import _export_sfc from "../../_virtual/_plugin-vue_export-helper.mjs";
-const DataGridView = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-16f88920"]]);
+const DataGridView = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-90c0ccf6"]]);
 export {
   DataGridView as default
 };

package/es/components/data-view/DataGridView.vue2.mjs

@@ -1,8 +1,9 @@
-import { defineComponent, useModel, shallowRef, ref, computed, onMounted, onActivated, watch, openBlock, createElementBlock, createBlock, unref, withCtx, createVNode, mergeProps, createCommentVNode, createElementVNode, toDisplayString, createTextVNode, normalizeStyle, Fragment, renderList, normalizeClass, renderSlot, resolveDynamicComponent, mergeModels } from "vue";
+import { defineComponent, useCssVars, unref, useModel, shallowRef, ref, computed, onMounted, onActivated, watch, openBlock, createElementBlock, normalizeClass, createBlock, withCtx, createVNode, mergeProps, createCommentVNode, createElementVNode, toDisplayString, createTextVNode, normalizeStyle, Fragment, renderList, renderSlot, resolveDynamicComponent, mergeModels } from "vue";
 import { ElButton } from "element-plus";
 import TableToolbar from "../table/TableToolbar.vue.mjs";
 import _sfc_main$2 from "../table/TableEmpty.vue.mjs";
 import TableSkeleton from "../table/TableSkeleton.vue.mjs";
+import { useSurface } from "../../hooks/use-surface.mjs";
 import _sfc_main$1 from "../display/WatchSize.vue.mjs";
 import _cloneDeep from "lodash/cloneDeep";
 import _set from "lodash/set";
@@ -15,12 +16,11 @@ import { useBreakpoint } from "../../hooks/use-breakpoint.mjs";
 import { pickExportColumns } from "../../utils/export.mjs";
 import { useChannelViewportHeight } from "../../hooks/use-channel-viewport-height.mjs";
 import { APP_API_LIST_MODEL_KEY_CONFIG } from "../../config/list-model.mjs";
-const _hoisted_1 = { class: "dc-data-grid-view data-grid-view" };
-const _hoisted_2 = ["onClick"];
-const _hoisted_3 = { class: "data-grid-view__card" };
-const _hoisted_4 = { class: "data-grid-view__field-label" };
-const _hoisted_5 = { class: "data-grid-view__field-value" };
-const _hoisted_6 = {
+const _hoisted_1 = ["onClick"];
+const _hoisted_2 = { class: "data-grid-view__card" };
+const _hoisted_3 = { class: "data-grid-view__field-label" };
+const _hoisted_4 = { class: "data-grid-view__field-value" };
+const _hoisted_5 = {
   key: 0,
   class: "data-grid-view__empty-error"
 };
@@ -33,6 +33,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
     query: {},
     pageSizeInit: { default: 20 },
     gridColumns: { default: 4 },
+    surface: { type: Boolean, default: void 0 },
     maxHeight: { default: "100vh" },
     refine: { type: Boolean, default: true },
     refineReduceHeight: { default: 0 },
@@ -59,6 +60,9 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
   }),
   emits: /* @__PURE__ */ mergeModels(["pageChange", "pageSizeChange", "dataChange", "selectionChange", "loadingChange", "pageInfoChange"], ["update:isAutoRefresh", "update:refreshInterval", "update:activeId", "update:activeData"]),
   setup(__props, { expose: __expose, emit: __emit }) {
+    useCssVars((_ctx) => ({
+      "c829655a": unref(surfacePadCss)
+    }));
     const props = __props;
     const emits = __emit;
     const isAutoRefresh = useModel(__props, "isAutoRefresh");
@@ -305,22 +309,28 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
       toolbarHeight.value = h;
     };
     const { viewportHeightFinal } = useChannelViewportHeight(props);
+    const { surfaceActive, surfacePad, surfacePadCss } = useSurface(() => props);
     const toolbarHeightAdjust = computed(
       () => props.showToolbar ? toolbarHeight.value : 0
     );
     const rawAvailableHeight = computed(() => {
+      const pad = surfacePad.value * 2;
       if (typeof props.maxHeight === "number") {
-        return props.maxHeight - toolbarHeightAdjust.value;
+        return props.maxHeight - pad - toolbarHeightAdjust.value;
       }
       if (props.refine) {
-        return viewportHeightFinal.value - toolbarHeightAdjust.value - props.refineReduceHeight;
+        return viewportHeightFinal.value - pad - toolbarHeightAdjust.value - props.refineReduceHeight;
       }
       return props.maxHeight;
     });
+    const hasHeightSource = computed(
+      () => props.maxHeight !== void 0 || viewportHeightFinal.value > 0
+    );
     const tableMaxHeight = computed(() => {
       const raw = rawAvailableHeight.value;
       if (raw === void 0) return void 0;
-      return typeof raw === "number" ? Math.max(raw, props.dataViewMaxHeightMinValue) : raw;
+      if (typeof raw !== "number") return raw;
+      return hasHeightSource.value ? Math.max(raw, 0) : Math.max(raw, props.dataViewMaxHeightMinValue);
     });
     const skeletonMaxHeight = computed(
       () => typeof tableMaxHeight.value === "number" ? tableMaxHeight.value : void 0
@@ -361,7 +371,9 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
       emits("loadingChange", n);
     });
     return (_ctx, _cache) => {
-      return openBlock(), createElementBlock("div", _hoisted_1, [
+      return openBlock(), createElementBlock("div", {
+        class: normalizeClass(["dc-data-grid-view data-grid-view", { "data-grid-view_surface": unref(surfaceActive) }])
+      }, [
         __props.showToolbar ? (openBlock(), createBlock(unref(_sfc_main$1), {
           key: 0,
           class: "dc-data-grid-view__toolbar",
@@ -416,14 +428,14 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
                   onClick: ($event) => unref(setActive)(row)
                 }, [
                   renderSlot(_ctx.$slots, "custom-view-item", mergeProps({ ref_for: true }, assertItemScope(row, index * gridColumnsFinal.value + colIndex)), () => [
-                    createElementVNode("div", _hoisted_3, [
+                    createElementVNode("div", _hoisted_2, [
                       (openBlock(true), createElementBlock(Fragment, null, renderList(__props.columns, (column) => {
                         return openBlock(), createElementBlock("div", {
                           key: column.prop ?? column.type,
                           class: "data-grid-view__field"
                         }, [
-                          createElementVNode("span", _hoisted_4, toDisplayString(column.label ?? column.prop) + ":", 1),
-                          createElementVNode("span", _hoisted_5, [
+                          createElementVNode("span", _hoisted_3, toDisplayString(column.label ?? column.prop) + ":", 1),
+                          createElementVNode("span", _hoisted_4, [
                             (openBlock(), createBlock(resolveDynamicComponent(unref(fieldComponentMap)[fieldKeyOf(column)]), {
                               row,
                               index: index * gridColumnsFinal.value + colIndex,
@@ -435,12 +447,12 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
                       }), 128))
                     ])
                   ], true)
-                ], 10, _hoisted_2);
+                ], 10, _hoisted_1);
               }), 128))
             ], 4)
           ]),
           empty: withCtx(() => [
-            error.value && !store.value.length ? (openBlock(), createElementBlock("div", _hoisted_6, [
+            error.value && !store.value.length ? (openBlock(), createElementBlock("div", _hoisted_5, [
               createElementVNode("span", null, toDisplayString(errorText.value), 1),
               createVNode(unref(ElButton), {
                 size: "small",
@@ -459,7 +471,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
           ]),
           _: 3
         }, 16, ["data", "loading", "loading-more", "error", "finished", "max-height"]))
-      ]);
+      ], 2);
     };
   }
 });

package/es/components/data-view/DataListView.vue.mjs

@@ -1,7 +1,7 @@
 import _sfc_main from "./DataListView.vue2.mjs";
 /* empty css                   */
 import _export_sfc from "../../_virtual/_plugin-vue_export-helper.mjs";
-const DataListView = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-467a86a8"]]);
+const DataListView = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-0d316a42"]]);
 export {
   DataListView as default
 };

package/es/components/data-view/DataListView.vue2.mjs

@@ -4,6 +4,7 @@ import DataListViewItem from "./DataListViewItem.vue.mjs";
 import { createDataListViewInstance } from "./utils.mjs";
 import { useDataViewFieldMap } from "./use-data-view-field-map.mjs";
 import { useActiveRecord, activeRecordValueOf } from "../../hooks/use-active-record.mjs";
+import { useActiveScroll } from "./use-active-scroll.mjs";
 const _hoisted_1 = {
   key: 1,
   class: "data-list-view-empty"
@@ -11,6 +12,7 @@ const _hoisted_1 = {
 const _sfc_main = /* @__PURE__ */ defineComponent({
   __name: "DataListView",
   props: /* @__PURE__ */ mergeModels({
+    activeScroll: { type: Boolean, default: true },
     data: {},
     rowKey: {},
     columns: {},
@@ -45,6 +47,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
     });
     const activeId = useModel(__props, "activeId");
     const activeData = useModel(__props, "activeData");
+    const listRoot = ref();
     const { isActive, setActive } = useActiveRecord({
       data: () => props.data,
       // 出口值保原始类型（数字 id 出数字）；比对由 hook 内部 String 归一，与渲染用的 keyOf 不冲突
@@ -53,6 +56,11 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
       activeData,
       name: "DataListView"
     });
+    useActiveScroll({
+      enabled: () => props.activeScroll,
+      activeId,
+      container: () => listRoot.value
+    });
     const selectedKeys = ref(/* @__PURE__ */ new Set());
     const selectAll = computed(() => selectedKeys.value.size === props.data.length);
     const isSelected = (row) => props.selectable && selectedKeys.value.has(keyOf(row));
@@ -98,6 +106,8 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
     );
     return (_ctx, _cache) => {
       return openBlock(), createElementBlock("div", {
+        ref_key: "listRoot",
+        ref: listRoot,
         class: "data-list-view",
         style: normalizeStyle(containerStyle.value)
       }, [

package/es/components/data-view/InfiniteListView.vue.mjs

@@ -1,7 +1,7 @@
 import _sfc_main from "./InfiniteListView.vue2.mjs";
 /* empty css                       */
 import _export_sfc from "../../_virtual/_plugin-vue_export-helper.mjs";
-const InfiniteListView = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-e597453f"]]);
+const InfiniteListView = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-6539caa4"]]);
 export {
   InfiniteListView as default
 };

package/es/components/data-view/InfiniteListView.vue2.mjs

@@ -1,6 +1,7 @@
-import { defineComponent, ref, computed, watch, nextTick, openBlock, createElementBlock, unref, normalizeStyle, createElementVNode, toDisplayString, createCommentVNode, Fragment, renderList, renderSlot, createVNode } from "vue";
+import { defineComponent, useCssVars, unref, ref, computed, watch, nextTick, openBlock, createElementBlock, normalizeStyle, normalizeClass, createElementVNode, toDisplayString, createCommentVNode, Fragment, renderList, renderSlot, createVNode } from "vue";
 import { ElEmpty } from "element-plus";
 import { useVirtualizer } from "@tanstack/vue-virtual";
+import { useSurface } from "../../hooks/use-surface.mjs";
 import { usePullRefresh } from "./use-pull-refresh.mjs";
 import { useActivated } from "../../hooks/activated.mjs";
 const _hoisted_1 = ["data-index"];
@@ -29,15 +30,20 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
     errorText: { default: "加载失败，点击重试" },
     estimateSize: { default: 200 },
     overscan: { default: 5 },
+    surface: { type: Boolean, default: void 0 },
     maxHeight: { default: void 0 },
     pullRefresh: { type: Boolean, default: false }
   },
   emits: ["loadMore", "retry", "refresh"],
   setup(__props, { expose: __expose, emit: __emit }) {
+    useCssVars((_ctx) => ({
+      "v0d4fd951": unref(surfacePadCss)
+    }));
     const props = __props;
     const emits = __emit;
     const scrollContainer = ref();
     const sentinel = ref();
+    const { surfaceActive, surfacePadCss } = useSurface(() => props);
     const containerStyle = computed(
       () => props.maxHeight ? {
         maxHeight: typeof props.maxHeight === "number" ? `${props.maxHeight}px` : props.maxHeight,
@@ -125,7 +131,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
       return openBlock(), createElementBlock("div", {
         ref_key: "scrollContainer",
         ref: scrollContainer,
-        class: "dc-infinite-list-view infinite-list-view",
+        class: normalizeClass(["dc-infinite-list-view infinite-list-view", { "infinite-list-view_surface": unref(surfaceActive) }]),
         style: normalizeStyle(containerStyle.value),
         onTouchstartPassive: _cache[0] || (_cache[0] = //@ts-ignore
         (...args) => unref(onTouchStart) && unref(onTouchStart)(...args)),
@@ -196,7 +202,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
             createVNode(unref(ElEmpty))
           ], true)
         ]))
-      ], 36);
+      ], 38);
     };
   }
 });