@done-coding/admin-core 0.22.1 → 0.22.2

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-2d4bb608"]]);
+const AppPage = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-2359c6df"]]);
 export {
   AppPage as default
 };

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

@@ -1,10 +1,16 @@
-import { defineComponent, useCssVars, computed, useSlots, ref, shallowRef, inject, provide, readonly, openBlock, createElementBlock, normalizeStyle, createElementVNode, createVNode, unref, withCtx, renderSlot, createBlock, createCommentVNode } from "vue";
+import { defineComponent, useCssVars, computed, useSlots, ref, shallowRef, inject, provide, readonly, openBlock, createElementBlock, normalizeStyle, createElementVNode, unref, createVNode, withCtx, renderSlot, createBlock, createCommentVNode } from "vue";
 import _debounce from "lodash/debounce";
 import _sfc_main$1 from "../modal/ModalShelf.vue.mjs";
 import _sfc_main$2 from "../display/WatchSize.vue.mjs";
 import { computeAppPageReducedViewportHeight, computeAppPageContentInset, computeAppPageReducedViewportWidth, computeAppPageSlotStyles, computeAppPageSlotShimStyles } from "./app-page-geometry.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 { useActivated } from "../../hooks/activated.mjs";
+import { SlotRegion } from "../../config/slot-region.mjs";
+const _hoisted_1 = ["data-dc-slot"];
+const _hoisted_2 = ["data-dc-slot"];
+const _hoisted_3 = ["data-dc-slot"];
+const _hoisted_4 = ["data-dc-slot"];
+const _hoisted_5 = ["data-dc-slot"];
 const cssVar = "--app-viewport-max-height";
 const _sfc_main = /* @__PURE__ */ defineComponent({
   ...{
@@ -28,13 +34,13 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
   },
   setup(__props) {
     useCssVars((_ctx) => ({
-      "v68a1d5b5": pageCssVars.value.top,
-      "v0a30a9cb": pageCssVars.value.bottom,
-      "a8d5d0b2": pageCssVars.value.left,
-      "v71378308": pageCssVars.value.right,
-      "v70aaabb4": pageCssVars.value.width,
-      "v13dba0c7": pageCssVars.value.height,
-      "v746c0602": props.nextViewportMaxHeight
+      "v55181597": pageCssVars.value.top,
+      "v5f04c6a9": pageCssVars.value.bottom,
+      "v4de6d405": pageCssVars.value.left,
+      "v6f4a0dde": pageCssVars.value.right,
+      "v6f907988": pageCssVars.value.width,
+      "v68afbda5": pageCssVars.value.height,
+      "v2e2782e4": props.nextViewportMaxHeight
     }));
     const props = __props;
     const style = computed(() => {
@@ -215,7 +221,8 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
       }, [
         createElementVNode("div", {
           class: "app-page-shim",
-          style: normalizeStyle(shimStyle.value)
+          style: normalizeStyle(shimStyle.value),
+          "data-dc-slot": unref(SlotRegion).AppPage_Default
         }, [
           createVNode(unref(_sfc_main$1), { level: "page" }, {
             default: withCtx(() => [
@@ -223,7 +230,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
             ]),
             _: 3
           })
-        ], 4),
+        ], 12, _hoisted_1),
         hasTop.value ? (openBlock(), createBlock(unref(_sfc_main$2), {
           key: 0,
           mode: "height",
@@ -235,10 +242,11 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
           default: withCtx(() => [
             createElementVNode("div", {
               class: "app-page-slot-shim",
-              style: normalizeStyle(shimStyles.value.top)
+              style: normalizeStyle(shimStyles.value.top),
+              "data-dc-slot": unref(SlotRegion).AppPage_Top
             }, [
               renderSlot(_ctx.$slots, "top", {}, void 0, true)
-            ], 4)
+            ], 12, _hoisted_2)
           ]),
           _: 3
         }, 8, ["observe-resize", "style"])) : createCommentVNode("", true),
@@ -253,10 +261,11 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
           default: withCtx(() => [
             createElementVNode("div", {
               class: "app-page-slot-shim",
-              style: normalizeStyle(shimStyles.value.bottom)
+              style: normalizeStyle(shimStyles.value.bottom),
+              "data-dc-slot": unref(SlotRegion).AppPage_Bottom
             }, [
               renderSlot(_ctx.$slots, "bottom", {}, void 0, true)
-            ], 4)
+            ], 12, _hoisted_3)
           ]),
           _: 3
         }, 8, ["observe-resize", "style"])) : createCommentVNode("", true),
@@ -271,10 +280,11 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
           default: withCtx(() => [
             createElementVNode("div", {
               class: "app-page-slot-shim",
-              style: normalizeStyle(shimStyles.value.left)
+              style: normalizeStyle(shimStyles.value.left),
+              "data-dc-slot": unref(SlotRegion).AppPage_Left
             }, [
               renderSlot(_ctx.$slots, "left", { listLayoutRecommended }, void 0, true)
-            ], 4)
+            ], 12, _hoisted_4)
           ]),
           _: 3
         }, 8, ["observe-resize", "style"])) : createCommentVNode("", true),
@@ -289,10 +299,11 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
           default: withCtx(() => [
             createElementVNode("div", {
               class: "app-page-slot-shim",
-              style: normalizeStyle(shimStyles.value.right)
+              style: normalizeStyle(shimStyles.value.right),
+              "data-dc-slot": unref(SlotRegion).AppPage_Right
             }, [
               renderSlot(_ctx.$slots, "right", { listLayoutRecommended }, void 0, true)
-            ], 4)
+            ], 12, _hoisted_5)
           ]),
           _: 3
         }, 8, ["observe-resize", "style"])) : createCommentVNode("", true)

package/es/components/display/TabsMain.vue.mjs

@@ -1,12 +1,14 @@
-import { defineComponent, inject, toRefs, useModel, useSlots, ref, computed, h, provide, watch, unref, openBlock, createBlock, createSlots, renderList, withCtx, renderSlot, normalizeProps, guardReactiveProps, resolveDynamicComponent, mergeProps, KeepAlive, createCommentVNode, createVNode, createElementVNode, mergeModels } from "vue";
+import { defineComponent, inject, toRefs, useModel, useSlots, ref, computed, h, provide, watch, unref, openBlock, createBlock, mergeProps, createSlots, renderList, withCtx, renderSlot, normalizeProps, guardReactiveProps, resolveDynamicComponent, KeepAlive, createCommentVNode, createVNode, createElementVNode, mergeModels } from "vue";
 import { useRoute, useRouter } from "vue-router";
 import _sfc_main$1 from "./TabsRefineFlow.vue.mjs";
 import _sfc_main$2 from "./TabsNaturalFlow.vue.mjs";
 import TabsHeader from "./TabsHeader.vue.mjs";
 import TabsTile from "./TabsTile.vue.mjs";
 import { watchTabToQuery, getTabQuery } from "./use-tabs-query-sync.mjs";
+import { useContextDefaults } from "../../hooks/use-context-defaults.mjs";
 import { TABS_MAIN_VISUAL_LEVEL } from "../../inject/key.mjs";
 import { useActivated } from "../../hooks/activated.mjs";
+import { SlotRegion } from "../../config/slot-region.mjs";
 const _sfc_main = /* @__PURE__ */ defineComponent({
   __name: "TabsMain",
   props: /* @__PURE__ */ mergeModels({
@@ -16,14 +18,15 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
     channel: {},
     parentChannel: {},
     padding: {},
-    refine: { type: Boolean, default: false },
+    refine: { type: Boolean, default: void 0 },
     refineReduceHeight: { default: 0 },
     variant: {},
     queryKey: {},
     tile: { type: Boolean },
     navPosition: {},
     navMode: {},
-    navOffset: {}
+    navOffset: {},
+    showNav: { type: Boolean, default: void 0 }
   }, {
     "modelValue": {},
     "modelModifiers": {}
@@ -31,6 +34,12 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
   emits: ["update:modelValue"],
   setup(__props) {
     const props = __props;
+    const { ctxRefine } = useContextDefaults({
+      getProps: () => props,
+      defaults: {
+        refine: ({ parentInfo, props: rawProps }) => rawProps.refine ?? (parentInfo === SlotRegion.AppPage_Default ? true : void 0)
+      }
+    });
     const parentVisualLevel = inject(TABS_MAIN_VISUAL_LEVEL, 0);
     const selfVisualLevel = parentVisualLevel + 1;
     const {
@@ -39,14 +48,14 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
       channel,
       parentChannel,
       padding,
-      refine,
       refineReduceHeight,
       variant,
       tabs,
       tile,
       navPosition,
       navMode,
-      navOffset
+      navOffset,
+      showNav
     } = toRefs(props);
     const model = useModel(__props, "modelValue");
     const route = useRoute();
@@ -68,10 +77,10 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
     const slots = useSlots();
     const contentViewportHeight = ref(void 0);
     const wrapperComponent = computed(
-      () => refine.value ? _sfc_main$1 : _sfc_main$2
+      () => ctxRefine.value ? _sfc_main$1 : _sfc_main$2
     );
     const wrapperProps = computed(
-      () => refine.value ? {
+      () => ctxRefine.value ? {
         viewportHeight: viewportHeight.value,
         minHeight: minHeight.value,
         channel: channel.value,
@@ -80,6 +89,9 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
         refineReduceHeight: refineReduceHeight.value
       } : {}
     );
+    const tileShowNavBind = computed(
+      () => showNav.value !== void 0 ? { showNav: showNav.value } : {}
+    );
     const tabByKey = (key) => props.tabs.find((tab) => tab.key === key);
     const onViewportHeightChange = (value) => {
       contentViewportHeight.value = value;
@@ -117,20 +129,20 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
       { immediate: true }
     );
     return (_ctx, _cache) => {
-      return unref(tile) ? (openBlock(), createBlock(TabsTile, {
+      return unref(tile) ? (openBlock(), createBlock(TabsTile, mergeProps({
         key: 0,
         modelValue: model.value,
         "onUpdate:modelValue": _cache[0] || (_cache[0] = ($event) => model.value = $event),
         class: "dc-tabs-main",
         tabs: unref(tabs),
-        refine: unref(refine),
+        refine: unref(ctxRefine),
         "viewport-height": unref(viewportHeight),
         "min-height": unref(minHeight),
         "parent-channel": unref(parentChannel),
         "nav-position": unref(navPosition),
         "nav-mode": unref(navMode),
         "nav-offset": unref(navOffset)
-      }, createSlots({ _: 2 }, [
+      }, tileShowNavBind.value), createSlots({ _: 2 }, [
         renderList(unref(tabs), (tab) => {
           return {
             name: tab.key,
@@ -147,7 +159,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
             ])
           };
         })
-      ]), 1032, ["modelValue", "tabs", "refine", "viewport-height", "min-height", "parent-channel", "nav-position", "nav-mode", "nav-offset"])) : (openBlock(), createBlock(resolveDynamicComponent(wrapperComponent.value), mergeProps({
+      ]), 1040, ["modelValue", "tabs", "refine", "viewport-height", "min-height", "parent-channel", "nav-position", "nav-mode", "nav-offset"])) : (openBlock(), createBlock(resolveDynamicComponent(wrapperComponent.value), mergeProps({
         key: 1,
         class: "dc-tabs-main"
       }, wrapperProps.value, { onViewportHeightChange }), {

package/es/components/display/TabsNaturalFlow.vue.mjs

@@ -1,5 +1,7 @@
-import { defineComponent, onMounted, openBlock, createElementBlock, renderSlot } from "vue";
+import { defineComponent, onMounted, openBlock, createElementBlock, renderSlot, createElementVNode, unref } from "vue";
+import { SlotRegion } from "../../config/slot-region.mjs";
 const _hoisted_1 = { class: "tabs-natural-flow" };
+const _hoisted_2 = ["data-dc-slot"];
 const _sfc_main = /* @__PURE__ */ defineComponent({
   __name: "TabsNaturalFlow",
   emits: ["viewportHeightChange"],
@@ -11,7 +13,12 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
     return (_ctx, _cache) => {
       return openBlock(), createElementBlock("div", _hoisted_1, [
         renderSlot(_ctx.$slots, "header"),
-        renderSlot(_ctx.$slots, "default")
+        createElementVNode("div", {
+          class: "tabs-natural-flow__content",
+          "data-dc-slot": unref(SlotRegion).TabsMain_Item
+        }, [
+          renderSlot(_ctx.$slots, "default")
+        ], 8, _hoisted_2)
       ]);
     };
   }

package/es/components/display/TabsRefineFlow.vue.mjs

@@ -1,8 +1,10 @@
-import { defineComponent, ref, computed, provide, watch, openBlock, createElementBlock, createVNode, createSlots, withCtx, createElementVNode, normalizeStyle, renderSlot } from "vue";
+import { defineComponent, ref, computed, provide, watch, openBlock, createElementBlock, createVNode, createSlots, withCtx, createElementVNode, unref, normalizeStyle, renderSlot } from "vue";
 import _sfc_main$1 from "./HeightProvider.vue.mjs";
 import { useChannelViewportHeight } from "../../hooks/use-channel-viewport-height.mjs";
 import { SCOPE_VIEWPORT_MAX_HEIGHT } from "../../inject/key.mjs";
+import { SlotRegion } from "../../config/slot-region.mjs";
 const _hoisted_1 = { class: "tabs-refine-flow" };
+const _hoisted_2 = ["data-dc-slot"];
 const _sfc_main = /* @__PURE__ */ defineComponent({
   __name: "TabsRefineFlow",
   props: {
@@ -53,10 +55,11 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
         }, createSlots({
           default: withCtx(() => [
             createElementVNode("div", {
-              style: normalizeStyle(paddingWrapStyle.value)
+              style: normalizeStyle(paddingWrapStyle.value),
+              "data-dc-slot": unref(SlotRegion).TabsMain_Item
             }, [
               renderSlot(_ctx.$slots, "default")
-            ], 4)
+            ], 12, _hoisted_2)
           ]),
           _: 2
         }, [

package/es/components/display/TabsTile.vue.mjs

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

package/es/components/display/TabsTile.vue2.mjs

@@ -5,8 +5,9 @@ import { getId } from "../../utils/id.mjs";
 import { APP_PAGE_CONTENT_INSET } from "../../inject/key.mjs";
 import { useChannelViewportHeight } from "../../hooks/use-channel-viewport-height.mjs";
 import { useActivated } from "../../hooks/activated.mjs";
+import { SlotRegion } from "../../config/slot-region.mjs";
 import { domClosestScrollableAncestor } from "../../utils/dom.mjs";
-const _hoisted_1 = ["id", "data-tab-key"];
+const _hoisted_1 = ["id", "data-tab-key", "data-dc-slot"];
 const _sfc_main = /* @__PURE__ */ defineComponent({
   __name: "TabsTile",
   props: /* @__PURE__ */ mergeModels({
@@ -17,7 +18,8 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
     parentChannel: {},
     navPosition: { default: "bottom-right" },
     navMode: { default: "auto" },
-    navOffset: { default: 12 }
+    navOffset: { default: 12 },
+    showNav: { type: Boolean, default: void 0 }
   }, {
     "modelValue": {},
     "modelModifiers": {}
@@ -69,6 +71,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
       () => props.navMode === "auto" ? props.refine ? "absolute" : "sticky" : props.navMode
     );
     const rootClass = computed(() => `dc-tabs-tile--nav-${navModeResolved.value}`);
+    const navVisible = computed(() => props.showNav ?? props.refine);
     const navStyle = computed(() => {
       const offset = `${props.navOffset}px`;
       const isTop = props.navPosition.startsWith("top");
@@ -178,7 +181,8 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
               id: paneId(index),
               key: tab.key,
               class: "dc-tabs-tile__item",
-              "data-tab-key": tab.key
+              "data-tab-key": tab.key,
+              "data-dc-slot": unref(SlotRegion).TabsMain_Item
             }, [
               createVNode(_sfc_main$1, {
                 tag: unref(ElCard),
@@ -205,7 +209,8 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
             ], 8, _hoisted_1);
           }), 128))
         ], 4),
-        createElementVNode("div", {
+        navVisible.value ? (openBlock(), createElementBlock("div", {
+          key: 0,
           class: "dc-tabs-tile__nav",
           style: normalizeStyle(navStyle.value),
           onClick: _cache[0] || (_cache[0] = withModifiers(() => {
@@ -230,7 +235,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
             ]),
             _: 1
           }, 8, ["container", "offset"])
-        ], 4)
+        ], 4)) : createCommentVNode("", true)
       ], 2);
     };
   }

package/es/components/list-layout/ListLayout.vue.mjs

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

package/es/components/list-layout/ListLayout.vue2.mjs

@@ -3,6 +3,7 @@ import { vLoading } from "element-plus";
 import FormActiveFilter from "../form/FormActiveFilter.vue.mjs";
 import FormSearch from "../form/FormSearch.vue.mjs";
 import { generateFormData, stringifyFormData } from "../form/utils.mjs";
+import { useContextDefaults } from "../../hooks/use-context-defaults.mjs";
 import { useListLayoutSticky } from "./use-list-layout-sticky.mjs";
 import { useActiveFilter } from "./use-active-filter.mjs";
 import _sfc_main$1 from "../display/WatchSize.vue.mjs";
@@ -11,6 +12,7 @@ import SlotLayoutFlowAside from "../slot-layout/SlotLayoutFlowAside.vue.mjs";
 import _pick from "lodash/pick";
 import _cloneDeep from "lodash/cloneDeep";
 import { useChannelViewportHeight } from "../../hooks/use-channel-viewport-height.mjs";
+import { SlotRegion } from "../../config/slot-region.mjs";
 const _sfc_main = /* @__PURE__ */ defineComponent({
   __name: "ListLayout",
   props: /* @__PURE__ */ mergeModels({
@@ -52,14 +54,20 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
   emits: /* @__PURE__ */ mergeModels(["dataChange", "pageInfoChange"], ["update:isAutoRefresh", "update:refreshInterval", "update:customView"]),
   setup(__props, { expose: __expose, emit: __emit }) {
     useCssVars((_ctx) => ({
-      "v3483351c": minHeight.value,
-      "v5ccbcb06": unref(searchStickyTop),
-      "e69ab810": unref(toolbarStickyTop),
-      "v5631fb30": unref(pagerStickyBottom)
+      "bbc8b4b6": minHeight.value,
+      "v2ce52870": unref(searchStickyTop),
+      "ca6d5736": unref(toolbarStickyTop),
+      "v0af15863": unref(pagerStickyBottom)
     }));
     const props = __props;
     const listLayoutEmits = __emit;
     const slots = useSlots();
+    const { ctxTableMainProps } = useContextDefaults({
+      getProps: () => props,
+      defaults: {
+        tableMainProps: ({ parentInfo, props: rawProps }) => rawProps.tableMainProps ?? (parentInfo === SlotRegion.AppPage_Left || parentInfo === SlotRegion.AppPage_Right ? { pageLayout: "prev, pager, next", paginationBackground: false } : void 0)
+      }
+    });
     const hasHeader = computed(() => !!slots.header);
     const hasOperation = computed(() => !!slots.operation);
     const isAutoRefresh = useModel(__props, "isAutoRefresh");
@@ -371,7 +379,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
             toolbar: __props.toolbar,
             showSwitchView: __props.showSwitchView,
             "initial-search": __props.initialSearch
-          }, __props.tableMainProps, {
+          }, unref(ctxTableMainProps), {
             refine: false,
             injectInfo: injectInfoAdjust.value,
             onLoadingChange,

package/es/components/view-layout/ViewLayout.vue.mjs

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

package/es/components/view-layout/ViewLayout.vue2.mjs

@@ -1,10 +1,12 @@
-import { defineComponent, shallowRef, ref, computed, provide, watch, openBlock, createElementBlock, createBlock, unref, withCtx, createElementVNode, normalizeStyle, renderSlot, withDirectives, createVNode, vShow, Fragment } from "vue";
+import { defineComponent, shallowRef, ref, computed, provide, watch, openBlock, createElementBlock, unref, createBlock, withCtx, createElementVNode, normalizeStyle, renderSlot, withDirectives, createVNode, vShow, Fragment } from "vue";
 import AutoRefreshGroup from "../misc/AutoRefreshGroup.vue.mjs";
 import _sfc_main$1 from "../display/HeightProvider.vue.mjs";
 import _sfc_main$2 from "../display/ActionBtnGroup.vue.mjs";
+import { useContextDefaults } from "../../hooks/use-context-defaults.mjs";
 import { useChannelViewportHeight } from "../../hooks/use-channel-viewport-height.mjs";
 import { useActivated } from "../../hooks/activated.mjs";
 import { SCOPE_VIEWPORT_MAX_HEIGHT } from "../../inject/key.mjs";
+import { SlotRegion } from "../../config/slot-region.mjs";
 const _hoisted_1 = { class: "dc-view-layout view-layout" };
 const _hoisted_2 = { class: "view-layout-toolbar" };
 const _hoisted_3 = { class: "view-layout-toolbar__left" };
@@ -18,7 +20,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
   props: {
     api: {},
     params: {},
-    refine: { type: Boolean, default: false },
+    refine: { type: Boolean, default: void 0 },
     viewportHeight: {},
     channel: {},
     parentChannel: {},
@@ -30,6 +32,12 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
   },
   setup(__props) {
     const props = __props;
+    const { ctxRefine } = useContextDefaults({
+      getProps: () => props,
+      defaults: {
+        refine: ({ parentInfo, props: rawProps }) => rawProps.refine ?? (parentInfo === SlotRegion.AppPage_Default || parentInfo === SlotRegion.TabsMain_Item ? true : void 0)
+      }
+    });
     const { viewportHeightFinal, nearestScope } = useChannelViewportHeight(props);
     const data = shallowRef(void 0);
     const loading = ref(false);
@@ -63,13 +71,13 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
     const onChildViewportHeightChange = (value) => {
       childViewportHeightChange.value = value;
     };
-    if (props.refine) {
-      provide(SCOPE_VIEWPORT_MAX_HEIGHT, {
-        scope: props.channel,
-        viewportMaxHeight: computed(() => childViewportHeightChange.value),
-        parent: nearestScope
-      });
-    }
+    provide(SCOPE_VIEWPORT_MAX_HEIGHT, {
+      scope: props.channel,
+      viewportMaxHeight: computed(
+        () => ctxRefine.value ? childViewportHeightChange.value : (nearestScope == null ? void 0 : nearestScope.viewportMaxHeight.value) ?? 0
+      ),
+      parent: nearestScope
+    });
     watch(
       // eslint-disable-next-line vue/no-setup-props-destructure
       () => props.channel,
@@ -77,7 +85,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
     );
     return (_ctx, _cache) => {
       return openBlock(), createElementBlock("div", _hoisted_1, [
-        __props.refine ? (openBlock(), createBlock(unref(_sfc_main$1), {
+        unref(ctxRefine) ? (openBlock(), createBlock(unref(_sfc_main$1), {
           key: 0,
           viewportHeight: heightProviderViewportHeight.value,
           minHeight: __props.minHeight,

package/es/config/slot-region.mjs

@@ -0,0 +1,21 @@
+const DC_SLOT_ATTR = "data-dc-slot";
+var SlotRegion = /* @__PURE__ */ ((SlotRegion2) => {
+  SlotRegion2[SlotRegion2["AppPage_Default"] = 1] = "AppPage_Default";
+  SlotRegion2[SlotRegion2["AppPage_Top"] = 2] = "AppPage_Top";
+  SlotRegion2[SlotRegion2["AppPage_Right"] = 3] = "AppPage_Right";
+  SlotRegion2[SlotRegion2["AppPage_Bottom"] = 4] = "AppPage_Bottom";
+  SlotRegion2[SlotRegion2["AppPage_Left"] = 5] = "AppPage_Left";
+  SlotRegion2[SlotRegion2["TabsMain_Item"] = 6] = "TabsMain_Item";
+  return SlotRegion2;
+})(SlotRegion || {});
+const parseSlotRegion = (raw) => {
+  if (raw === null || raw === void 0 || raw === "") return void 0;
+  const num = Number(raw);
+  if (!Number.isInteger(num)) return void 0;
+  return num in SlotRegion ? num : void 0;
+};
+export {
+  DC_SLOT_ATTR,
+  SlotRegion,
+  parseSlotRegion
+};

package/es/hooks/use-context-defaults.mjs

@@ -0,0 +1,44 @@
+import { getCurrentInstance, shallowRef, computed } from "vue";
+import { useActivated } from "./activated.mjs";
+import { DC_SLOT_ATTR, parseSlotRegion } from "../config/slot-region.mjs";
+const useContextDefaults = (options) => {
+  var _a, _b;
+  const instance = getCurrentInstance();
+  const region = shallowRef(void 0);
+  useActivated((info) => {
+    var _a2, _b2;
+    if (info.isActivated && region.value === void 0) {
+      const el = (_a2 = instance == null ? void 0 : instance.proxy) == null ? void 0 : _a2.$el;
+      const raw = (_b2 = el == null ? void 0 : el.parentElement) == null ? void 0 : _b2.getAttribute(DC_SLOT_ATTR);
+      region.value = parseSlotRegion(raw);
+    }
+  });
+  try {
+    const defs = (_b = (_a = instance == null ? void 0 : instance.vnode) == null ? void 0 : _a.type) == null ? void 0 : _b.props;
+    if (defs) {
+      for (const key of Object.keys(options.defaults)) {
+        const def = defs[key];
+        if (def && "default" in def && def.default !== void 0) {
+          console.warn(
+            `[useContextDefaults] prop "${key}" 在 withDefaults 设了内建默认（${String(
+              def.default
+            )}）——会短路 \`props.xx ?? 上下文默认\` 合并，上下文默认静默失效。[MUST] 上下文默认 prop 的 withDefaults 只填 undefined。详见 spec 2026-08-14 useContextDefaults。`
+          );
+        }
+      }
+    }
+  } catch {
+  }
+  const result = {};
+  for (const key of Object.keys(options.defaults)) {
+    const resolver = options.defaults[key];
+    const ctxKey = `ctx${key.charAt(0).toUpperCase()}${key.slice(1)}`;
+    result[ctxKey] = computed(
+      () => resolver({ props: options.getProps(), parentInfo: region.value })
+    );
+  }
+  return result;
+};
+export {
+  useContextDefaults
+};

package/es/index.mjs

@@ -44,6 +44,7 @@ import { default as default41 } from "./components/misc/AutoRefresh.vue.mjs";
 import { default as default42 } from "./components/misc/AutoRefreshGroup.vue.mjs";
 import { CORE_VIEWPORT_DECOR_ZINDEX_ABOVE, CORE_VIEWPORT_DECOR_ZINDEX_BELOW } from "./components/app-layout/viewport.mjs";
 import { default as default43, default as default44 } from "./components/modal/ModalConfirm.vue.mjs";
+import { DC_SLOT_ATTR, SlotRegion, parseSlotRegion } from "./config/slot-region.mjs";
 import { EXPORT_MAX_LIMIT, OPERATE_COLUMN_PROP, exportCSV, pickExportColumns } from "./utils/export.mjs";
 import { FORM_CONFIG_SELECT_ALL_VALUE, getConfirmPasswordRule, passwordRule, setFormComponentType } from "./helpers/form.mjs";
 import { FORM_ITEM_CHANGE_LOADING, NEST_LAYOUT_TIERS, ceilToTier, generateFormData, getBlurSubmit, getChangeSubmit, getDatePickerShortcuts, getEnterSubmit, getPlaceholder, getVModelSugar, parseFormData, resolveFormLayout, resolveLayoutSpan, setInputComponent, setSelectComponent, stringifyFormData, swiftFormItemConfig } from "./components/form/utils.mjs";
@@ -138,6 +139,7 @@ export {
   CORE_VIEWPORT_DECOR_ZINDEX_ABOVE,
   CORE_VIEWPORT_DECOR_ZINDEX_BELOW,
   default43 as ConfirmModal,
+  DC_SLOT_ATTR,
   default5 as DetailModal,
   EXPORT_MAX_LIMIT,
   FORM_CONFIG_SELECT_ALL_VALUE,
@@ -194,6 +196,7 @@ export {
   default26 as ShadowClone,
   default66 as SlotLayoutFlowAside,
   default27 as SlotLayoutTemplate,
+  SlotRegion,
   TABLE_COLUMN_KEY_OPERATE,
   TABLE_COLUMN_KEY_SELECTION,
   TABS_MAIN_VISUAL_LEVEL,
@@ -245,6 +248,7 @@ export {
   nestPanelForm,
   nestPanelItem,
   parseFormData,
+  parseSlotRegion,
   passwordRule,
   pickExportColumns,
   resolveBreakpointByWidth,

package/es/style.css

@@ -321,23 +321,23 @@
   color: var(--dc-core-primary-color);
   font-weight: 600;
 }
-.dc-tabs-tile--nav-absolute[data-v-efffefb9],
-.dc-tabs-tile--nav-fixed[data-v-efffefb9] {
+.dc-tabs-tile--nav-absolute[data-v-d9f0f521],
+.dc-tabs-tile--nav-fixed[data-v-d9f0f521] {
   position: relative;
 }
-.dc-tabs-tile--nav-sticky[data-v-efffefb9] {
+.dc-tabs-tile--nav-sticky[data-v-d9f0f521] {
   display: flex;
   flex-direction: column;
 }
-.dc-tabs-tile__scroll[data-v-efffefb9] {
+.dc-tabs-tile__scroll[data-v-d9f0f521] {
   display: flex;
   flex-direction: column;
   gap: 12px;
 }
-.dc-tabs-tile__card[data-v-efffefb9] {
+.dc-tabs-tile__card[data-v-d9f0f521] {
   width: 100%;
 }
-.dc-tabs-tile__nav[data-v-efffefb9] {
+.dc-tabs-tile__nav[data-v-d9f0f521] {
   z-index: 2;
   max-height: 60%;
   overflow: auto;
@@ -602,18 +602,18 @@
 .app-layout_noLogin[data-v-b45bcdfd] .app-footer {
   transition: none !important;
 }
-.app-page[data-v-2d4bb608] {
-  --dc-page-content-viewport-top: var(--v68a1d5b5);
-  --dc-page-content-viewport-bottom: var(--v0a30a9cb);
-  --dc-page-content-viewport-left: var(--a8d5d0b2);
-  --dc-page-content-viewport-right: var(--v71378308);
-  --dc-page-content-viewport-width: var(--v70aaabb4);
-  --dc-page-content-viewport-height: var(--v13dba0c7);
+.app-page[data-v-2359c6df] {
+  --dc-page-content-viewport-top: var(--v55181597);
+  --dc-page-content-viewport-bottom: var(--v5f04c6a9);
+  --dc-page-content-viewport-left: var(--v4de6d405);
+  --dc-page-content-viewport-right: var(--v6f4a0dde);
+  --dc-page-content-viewport-width: var(--v6f907988);
+  --dc-page-content-viewport-height: var(--v68afbda5);
 }
-.app-page-shim[data-v-2d4bb608] {
-  --app-viewport-max-height: var(--v746c0602);
+.app-page-shim[data-v-2359c6df] {
+  --app-viewport-max-height: var(--v2e2782e4);
 }
-.app-page-slot-shim[data-v-2d4bb608] {
+.app-page-slot-shim[data-v-2359c6df] {
   box-sizing: border-box;
   width: 100%;
   height: 100%;
@@ -1122,40 +1122,40 @@ to {
 .dc-slot-layout-flow-aside-main[data-v-5c6ef74b] {
   width: var(--v7e1d11ca);
 }
-.list-layout[data-v-8527d1df] {
-  min-height: var(--v3483351c);
+.list-layout[data-v-ce5a651b] {
+  min-height: var(--bbc8b4b6);
 }
-.list-layout-header[data-v-8527d1df] {
+.list-layout-header[data-v-ce5a651b] {
   margin-bottom: 10px;
 }
-.list-layout-operation[data-v-8527d1df] {
+.list-layout-operation[data-v-ce5a651b] {
   margin-bottom: 10px;
 }
-.list-layout_search-sticky[data-v-8527d1df] .form-search {
+.list-layout_search-sticky[data-v-ce5a651b] .form-search {
   position: sticky;
-  top: var(--v5ccbcb06);
+  top: var(--v2ce52870);
   z-index: 10;
   background: var(--dc-core-surface, var(--el-bg-color));
   box-shadow: 0 1px 0 0 var(--dc-core-border-color, var(--el-border-color-lighter));
 }
-.list-layout_toolbar-sticky[data-v-8527d1df] .dc-table-main__toolbar {
+.list-layout_toolbar-sticky[data-v-ce5a651b] .dc-table-main__toolbar {
   position: sticky;
-  top: var(--e69ab810);
+  top: var(--ca6d5736);
   z-index: 9;
   padding-top: 10px;
   background: var(--dc-core-surface, var(--el-bg-color));
   box-shadow: 0 1px 0 0 var(--dc-core-border-color, var(--el-border-color-lighter));
 }
-.list-layout_pager-sticky[data-v-8527d1df] .dc-table-main__pagination {
+.list-layout_pager-sticky[data-v-ce5a651b] .dc-table-main__pagination {
   position: sticky;
-  bottom: var(--v5631fb30);
+  bottom: var(--v0af15863);
   z-index: 9;
   margin-top: 0;
   padding-top: 10px;
   background: var(--dc-core-surface, var(--el-bg-color));
   box-shadow: 0 -1px 0 0 var(--dc-core-border-color, var(--el-border-color-lighter));
 }
-.list-layout[data-v-8527d1df] .el-loading-mask {
+.list-layout[data-v-ce5a651b] .el-loading-mask {
   left: -10px;
   top: -10px;
   right: -10px;
@@ -1167,24 +1167,24 @@ to {
   gap: 8px;
   margin-top: 8px;
 }
-.view-layout[data-v-3c537d41] {
+.view-layout[data-v-f0ed342f] {
   display: flex;
   flex-direction: column;
   gap: 8px;
 }
-.view-layout-toolbar[data-v-3c537d41] {
+.view-layout-toolbar[data-v-f0ed342f] {
   display: flex;
   justify-content: space-between;
   align-items: center;
   padding-bottom: 8px;
   gap: 20px;
 }
-.view-layout-toolbar__left[data-v-3c537d41],
-.view-layout-toolbar__right[data-v-3c537d41] {
+.view-layout-toolbar__left[data-v-f0ed342f],
+.view-layout-toolbar__right[data-v-f0ed342f] {
   display: flex;
   align-items: center;
   gap: 10px;
 }
-.view-layout-content[data-v-3c537d41] {
+.view-layout-content[data-v-f0ed342f] {
   overflow: auto;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@done-coding/admin-core",
-  "version": "0.22.1",
+  "version": "0.22.2",
   "description": "内部前端库",
   "private": false,
   "main": "es/index.mjs",
@@ -80,5 +80,5 @@
     "node": ">=18.0.0",
     "pnpm": ">=9.0.0"
   },
-  "gitHead": "4f36d70046a0dd917906a086dfeae956e1f72489"
+  "gitHead": "e23d3f11214fc43bc0a6e1149ebe56e014a89d8e"
 }

package/src/components/app-layout/docs/README-AppPage.md

@@ -67,6 +67,8 @@
 
 **性质**：固定内置推荐值（写死、非运行时开关、不做响应式探测），仅经 `#left`/`#right` 插槽 scoped 带出。面向「列表放进 left/right 窄栏」的展示形态推荐；消费者拿到后直接 `v-bind` 展开进 ListLayout，可按需 spread 覆盖（`v-bind="{ ...listLayoutRecommended, customView: false }"`）。
 
+> ⚠️ **`tableMainProps` 部分已自动**：`#left` / `#right` 内直接放 `ListLayout` 时，分页窄栏化（`pageLayout` / `paginationBackground`）已由 `ListLayout` 的 `useContextDefaults` 直系父上下文默认自动提供，无需再经本推荐配置传 `tableMainProps`；仍需要 `customView: true`（卡片形态）才显式 `v-bind="listLayoutRecommended"`（或只取 `customView`）。
+
 **形状**（与 ListLayout props 平铺对齐）：
 
 | 字段 | 类型 | 固定值 | 语义 |

package/src/components/display/docs/README-TabsMain.md

@@ -44,6 +44,17 @@ const tabs = [
 - **variant：默认按 level 推导（1-4 级依次 card / indicator / indicator-compact / plain）即够用**，仅特殊视觉需求显式覆盖。
 - **完整能力演示**（基础 + queryKey + 嵌套链 + 平铺各态）：`apps/reference/src/pages/display/tabs/showcase/`、`pages/display/tabs/nested-channel/`、`pages/display/tabs/tile/`——能力展示，非推荐默认。
 
+## 上下文默认值（直系父上下文）
+
+置于特定父容器槽位时，`TabsMain` 的 `refine` 自动获得上下文默认值（`useContextDefaults` 解析直系父 DOM 的 `data-dc-slot`），消费方零传参；显式传 `refine` 仍优先。
+
+| 场景 | prop | 自动默认 |
+| --- | --- | --- |
+| AppPage `#default` | `refine` | `true`（精细流） |
+| 其他容器 / 独立使用 | `refine` | 不处理（undefined ≡ false，自然流） |
+
+> ⚠️ 需上下文动态默认的 prop 不写 `withDefaults` 默认（详见 spec：`docs/specs/2026-08-14-080509-moderate-usecontextdefaults直系父上下文默认/spec.md`）。
+
 ## API
 > ⚠️ API 以 types.ts 与组件源码为真相源；与文档冲突时以源码为准。
 
@@ -57,7 +68,7 @@ const tabs = [
 | `channel` | `string?` | — | 作为父时的 scope 标识。⚠️ 与 parentChannel 均 [MUST NOT] 响应式变更（setup 期快照）；且仅 refine=true 路径生效 |
 | `parentChannel` | `string?` | — | 作为子时定向消费的祖先 scope 标识（沿对象链 parent 找匹配） |
 | `padding` | `TabsMainPadding`（= [top,right,bottom,left] px） | `[10,10,0,10]` | 默认插槽容器内置 padding（withDefaults 实证）；top+bottom 同步从 slot scope / channel viewportHeight 扣减 |
-| `refine` | `boolean?` | `false` | false=自然流（TabsNaturalFlow，不包 HeightProvider，scope viewportHeight 为 undefined）；true=精细流（TabsRefineFlow，HeightProvider 精确扣 header reserve + padding） |
+| `refine` | `boolean?` | 上下文默认 | false=自然流（TabsNaturalFlow，不包 HeightProvider，scope viewportHeight 为 undefined）；true=精细流（TabsRefineFlow，HeightProvider 精确扣 header reserve + padding）。默认由 `useContextDefaults` 按直系父解析：AppPage `#default` 内 `true`，否则 `false`；显式传值优先 |
 | `refineReduceHeight` | `number?` | `0` | 从 viewportHeightFinal 预扣的高度（refine=false 时同样生效） |
 | `variant` | `TabsHeaderVariant?` | 按 level 推导 | "card"\|"indicator"\|"indicator-compact"\|"plain"；level 1-4 默认依次 card/indicator/indicator-compact/plain。字号始终跟 level（inject TABS_MAIN_VISUAL_LEVEL +1 每层） |
 | `queryKey` | `string?` | 不传=不同步 | 激活 tab ↔ 路由 query 双向同步的 key：切 tab → router.replace `?{queryKey}={key}`（不压栈）；激活/刷新/前进后退读 query 反向恢复；无 vue-router 环境静默失效 |

package/src/components/list-layout/docs/README-ListLayout.md

@@ -60,6 +60,18 @@ const { listPageConfig } = useSpaceConfig({
 - **高度链 prop（`refine` / `viewportHeight` / `parentChannel`）：默认 ListLayout 内部已接管**（refine 默认 true）——常规无需干预，仅特殊高度场景覆写。
 - **完整能力演示**（toolbar 全形态 + 粘性三件套 + keepAlive 组合）：`apps/reference/src/pages/list-layout/guide/`（最佳实践）、`pages/list-layout/sticky/`（粘性）、`pages/list-layout/module-demo/`（keepAlive 模块组合）——能力展示，非推荐默认。
 
+## 上下文默认值（直系父上下文）
+
+置于特定父容器槽位时，`ListLayout` 自动获得上下文默认值（`useContextDefaults` 解析直系父 DOM 的 `data-dc-slot`），消费方零传参；显式传 prop 仍优先。
+
+| 场景 | prop | 自动默认 |
+| --- | --- | --- |
+| AppPage `#left` / `#right` 窄栏 | `tableMainProps` | 分页窄栏化：`{ pageLayout: "prev, pager, next", paginationBackground: false }` |
+| 其他容器 / 独立使用 | `tableMainProps` | 不处理（透传 TableMain 默认分页） |
+
+> ⚠️ 需上下文动态默认的 prop 不写 `withDefaults` 默认（详见 spec：`docs/specs/2026-08-14-080509-moderate-usecontextdefaults直系父上下文默认/spec.md`）。
+> `ListLayout.refine` 默认恒 `true`（withDefaults），不参与上下文解析。
+
 ## API
 > ⚠️ API 以 types.ts 与组件源码为真相源；与文档冲突时以源码为准。
 
@@ -81,7 +93,7 @@ const { listPageConfig } = useSpaceConfig({
 | `rowKey` | `Extract<keyof T, string> \| ((row:T)=>string)`（必填） | — | 行键 |
 | `api` | `(params: TableApiParams<ExtractFormStringifyFromObject<PO,SO> & SQ>) => Promise<TableApiResult<T>>`（必填） | — | 列表取数 |
 | `refine` / `refineReduceHeight` / `viewportHeight` / `parentChannel` / `toolbar` / `showSwitchView` | 同 TableMain | refine `true`、refineReduceHeight `0` | 常用配置提升为直属扁平 prop（内部自行消化视口高度链；TableMain 恒收 `:refine="false"`，高度计算由 ListLayout 接管） |
-| `tableMainProps` | `Partial<Omit<TableMainProps, 上述 6 键 \| "api" \| "query" \| "injectInfo">>` | 未设 | TableMain 透传袋 |
+| `tableMainProps` | `Partial<Omit<TableMainProps, 上述 6 键 \| "api" \| "query" \| "injectInfo">>` | 未设（上下文默认） | TableMain 透传袋；⚠️ 置于 AppPage `#left` / `#right` 窄栏时分页自动窄栏化（默认补 `{ pageLayout: "prev, pager, next", paginationBackground: false }`，经 `useContextDefaults` 直系父上下文解析，见下）；显式传 `tableMainProps` 仍优先 |
 
 **直属行为 props**
 

package/src/components/view-layout/docs/README-ViewLayout.md

@@ -1,6 +1,6 @@
 # ViewLayout（展示布局）
 
-> 展示空间布局壳：`props.api` 数据拉取（内部 `useActivated` 激活拉取）+ toolbar 对齐 `TableToolbar`（左/右 `ActionBtnGroup` extra 按钮 + 右侧 `AutoRefreshGroup` 自动刷新 / 手动刷新）+ 默认插槽自由内容 + 精细流高度链（refine 默认开）。
+> 展示空间布局壳：`props.api` 数据拉取（内部 `useActivated` 激活拉取）+ toolbar 对齐 `TableToolbar`（左/右 `ActionBtnGroup` extra 按钮 + 右侧 `AutoRefreshGroup` 自动刷新 / 手动刷新）+ 默认插槽自由内容 + 精细流高度链（refine 上下文默认：AppPage#default / TabsMain 页签内容内开）。
 > 范式页：`apps/reference/src/pages/view-layout/guide/`
 
 ## 定位
@@ -29,12 +29,12 @@
 - 激活即拉取：首访 mounted / KeepAlive 重新激活自动拉取，失活不拉（数据保留）
 - 右上角 AutoRefreshGroup 自动接管刷新按钮 / 自动刷新开关（`showAutoRefresh` / `showRefresh` 控制显隐）
 - toolbar 对齐 `TableToolbar` 结构：`leftExtraButtons` / `rightExtraButtons`（`ActionBtnGroup` 配置，`default-size="small"`）左右分栏；不含表格特有能力（导出 / 批量下载 / 视图切换）
-- **refine 默认开**：内容区可用高 = 视口高 − toolbar 高（`scope.viewportHeight` + 容器 max-height 双出口）——超高内滚
+- **refine 上下文默认**：置于 AppPage `#default` / TabsMain 页签内容内默认开（精细流）——内容区可用高 = 视口高 − toolbar 高（`scope.viewportHeight` + 容器 max-height 双出口）——超高内滚；其余容器 / 独立使用回落自然流（按自身尺寸）
 
 ## 能力边界 / 按需使用
 
 - **默认即够用**：`api` + 默认插槽即得完整展示布局——refine 精细流 + 自动刷新开关/刷新按钮默认开。
-- **refine（精细流）：默认 `true` 即够用。** 仅当展示内容无需视口高度预算（按自身尺寸渲染即可）才关 `refine`——关闭后 scope viewportHeight 为 undefined。
+- **refine（精细流）：上下文默认。** 置于 AppPage `#default` / TabsMain 页签内容内默认 `true`（精细流）；其他容器 / 独立使用默认 `false`（自然流，scope viewportHeight 为 undefined）。需精细流而上下文未命中时显式补 `refine`；展示内容无需视口高度预算（按自身尺寸渲染即可）时显式关。显式传 `refine` 恒优先。
 - `viewportHeight` / `channel` / `parentChannel`：默认不用。仅当 ViewLayout 需要参与可用高 scope 链（显式视口高 / 作为父提供 scope / 作为子定向消费祖先 scope）才配；⚠️ 每级 [MUST] 显式 `refine`、channel 名 [MUST NOT] 响应式变更。
 - `params`：仅当 api 需要拉取参数时传；⚠️ **响应式变化不自动重拉**（需要时调 `scope.refresh()`）。
 - `showAutoRefresh` / `showRefresh`：仅当不需要自动刷新或手动刷新时关。
@@ -42,6 +42,18 @@
 - **插槽内容自由编排**：纯展示 [MUST NOT] 套 PanelMain 作页级根（已废弃场景）；需要结构化字段面板时在插槽内用 PanelMain，自由内容直接写。
 - **完整能力演示**：`apps/reference/src/pages/view-layout/guide/`——能力展示，非推荐默认。
 
+## 上下文默认值（直系父上下文）
+
+置于特定父容器槽位时，`ViewLayout` 的 `refine` 自动获得上下文默认值（`useContextDefaults` 解析直系父 DOM 的 `data-dc-slot`），消费方零传参；显式传 `refine` 仍优先。
+
+| 场景 | prop | 自动默认 |
+| --- | --- | --- |
+| AppPage `#default` | `refine` | `true`（精细流） |
+| TabsMain 页签内容内 | `refine` | `true`（精细流） |
+| 其他容器 / 独立使用 | `refine` | 不处理（undefined ≡ false，自然流） |
+
+> ⚠️ 需上下文动态默认的 prop 不写 `withDefaults` 默认（详见 spec：`docs/specs/2026-08-14-080509-moderate-usecontextdefaults直系父上下文默认/spec.md`）。
+
 ## API
 > ⚠️ API 以 types.ts 与组件源码为真相源；与文档冲突时以源码为准。
 
@@ -51,7 +63,7 @@
 | --- | --- | --- | --- |
 | `api` | `(params?: P) => Promise<R>`（必填） | — | 数据拉取函数；每次拉取（激活 / 手动刷新 / 自动刷新）传入 props.params（未传收 undefined） |
 | `params` | `P?` | — | 拉取参数；响应式变化不自动重拉（调 `scope.refresh()`） |
-| `refine` | `boolean?` | `true` | 精细流：包 HeightProvider 精确扣 toolbar reserve（WatchSize 量高），内容区可用高 + scope viewportHeight；false=自然流 |
+| `refine` | `boolean?` | 上下文默认 | 精细流：包 HeightProvider 精确扣 toolbar reserve（WatchSize 量高），内容区可用高 + scope viewportHeight；false=自然流。默认由 `useContextDefaults` 按直系父解析：AppPage `#default` / TabsMain 页签内容内 `true`，否则 `false`；显式传值优先 |
 | `viewportHeight` | `number?` | — | 显式视口高，优先级最高；未传降级 inject SCOPE_VIEWPORT_MAX_HEIGHT scope 链 |
 | `channel` | `string?` | — | 作为父时的 scope 标识。⚠️ 与 parentChannel 均 [MUST NOT] 响应式变更（setup 期快照）；且仅 refine=true 路径生效 |
 | `parentChannel` | `string?` | — | 作为子时定向消费的祖先 scope 标识（沿对象链 parent 找匹配） |

package/types/components/display/TabsMain.vue.d.ts

@@ -34,6 +34,7 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_PublicProps,
     minHeight: number;
     refineReduceHeight: number;
     refine: boolean;
+    showNav: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
 export default _default;

package/types/components/display/TabsTile.vue.d.ts

@@ -16,6 +16,12 @@ type __VLS_Props = {
     navMode?: TabsMainTileNavMode;
     /** 角落 nav 距角像素 */
     navOffset?: number;
+    /**
+     * 角落 nav 显隐默认,默认 undefined(= **动态默认**:`refine` 显示 / 自然流隐藏,避免自然流
+     * sticky 占文档流);显式传 true/false 覆盖。⚠️ Boolean prop 缺席强转 false 会短路 `?? refine`,
+     * 故 withDefaults 填 undefined 使缺席 ≡ undefined(navVisible 才生效)。
+     */
+    showNav?: boolean;
 };
 type __VLS_PublicProps = {
     modelValue?: string;
@@ -238,6 +244,7 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_PublicProps,
     navPosition: TabsMainTileNavPosition;
     navMode: TabsMainTileNavMode;
     navOffset: number;
+    showNav: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
     scrollRootRef: HTMLDivElement;
     anchorRef: ({

package/types/components/display/types.d.ts

@@ -220,6 +220,11 @@ export interface TabsMainProps {
      * 平铺模式角落 nav 距角像素,默认 `12`。仅 `tile=true` 生效。
      */
     navOffset?: number;
+    /**
+     * 平铺模式角落 nav 显隐默认,默认 `undefined`(= **动态默认**:`refine=true` 显示 / 自然流隐藏,避免
+     * 自然流 sticky 占文档流)。显式传 `true`/`false` 覆盖动态默认。仅 `tile=true` 生效。
+     */
+    showNav?: boolean;
 }
 /** BooleanTag 标签色彩类型（派生 ElTag type，不重定义） */
 export type BooleanTagType = NonNullable<TagProps["type"]>;

package/types/config/index.d.ts

@@ -1,2 +1,3 @@
 export * from './list-model';
 export * from './route';
+export * from './slot-region';

package/types/config/slot-region.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 直系父上下文槽位标识（useContextDefaults 消费）。
+ *
+ * 宿主（AppPage / TabsMain）在槽内容**直系父包裹元素**上挂 `DC_SLOT_ATTR`，
+ * 消费 hook（useContextDefaults）读 `$el.parentElement` 命中 → 按 prop 解析上下文默认。
+ * 详见 spec：`docs/specs/2026-08-14-080509-moderate-usecontextdefaults直系父上下文默认/spec.md`
+ */
+/** 槽位 attr key（唯一共享来源，宿主 / 消费方 / hook 同源 import）。 */
+export declare const DC_SLOT_ATTR = "data-dc-slot";
+/**
+ * 槽位区域数字枚举（宿主前缀命名）。
+ *
+ * 值用数字：运行期 DOM 只见数字、看不出槽位语义（防"有心人"扫 DOM 一眼识别）；
+ * ⚠️ 注意这只是防扫一眼，**不是安全边界**——core 在公网 npm，枚举映射在包产物里可还原
+ * （L2/LiveView 才是秘方保护正解）。
+ */
+export declare enum SlotRegion {
+    /** AppPage 默认槽（页面主体，ModalShelf 透明包裹后 `.app-page-shim` 为直系父） */
+    AppPage_Default = 1,
+    /** AppPage top 槽（通栏悬浮区） */
+    AppPage_Top = 2,
+    /** AppPage right 槽（侧向悬浮区） */
+    AppPage_Right = 3,
+    /** AppPage bottom 槽（通栏悬浮区） */
+    AppPage_Bottom = 4,
+    /** AppPage left 槽（侧向悬浮区） */
+    AppPage_Left = 5,
+    /** TabsMain 页签内容（tab item） */
+    TabsMain_Item = 6
+}
+/**
+ * 读 DOM 槽位数字值并守卫：数字读回是字符串，[MUST] 经本函数 `Number()` 强转 + 枚举值校验；
+ * 缺失 / 非法 → `undefined`（未命中 region = 不处理，由消费 hook 决定原样透传）。
+ */
+export declare const parseSlotRegion: (raw: string | null | undefined) => SlotRegion | undefined;

package/types/hooks/use-context-defaults.d.ts

@@ -0,0 +1,39 @@
+import { ComputedRef } from 'vue';
+import { SlotRegion } from '../config';
+/** useContextDefaults resolver 上下文（resolver 内自带"显式 > 上下文 > 内建"合并）。 */
+export interface UseContextDefaultsResolverCtx<P extends Record<string, any>> {
+    /** 直系父解析到的槽位区域（未命中 = undefined） */
+    parentInfo: SlotRegion | undefined;
+    /** props 原始值（未含上下文默认，含显式传值） */
+    props: P;
+}
+/**
+ * 直系父上下文默认值解析 hook（core 内部组合函数，**[MUST NOT] 出桶导出**——hooks 桶 index 注释锁面，规则 22；
+ * 使用者可枚举：ListLayout / ViewLayout / TabsMain）。
+ *
+ * 核心一句话：core 组件在特定父容器（槽位）中自动获得上下文默认值（如 ListLayout 放 AppPage#left/right
+ * 窄栏 → 分页配置自动窄栏化；ViewLayout/TabsMain refine 在 AppPage#default / TabsMain item → 默认 true），
+ * 消费方零传参；显式传 prop 仍优先。详见 spec：`docs/specs/2026-08-14-080509-moderate-usecontextdefaults直系父上下文默认/spec.md`
+ *
+ * 导出面 = `defaults` 声明过的键（动态名 `ctx${首字母大写}`，每个为 ComputedRef 最终值）：
+ * `defaults: { refine }` → 返回 `{ ctxRefine: ComputedRef<...> }`；组件 `const { ctxRefine } = useContextDefaults(...)`。
+ * **[MUST NOT] 导出 defaults 之外的 props 键（不替代 props）**——组件其余 prop 照常 `props.xx`。
+ *
+ * 机制：
+ * - 直系父 DOM（`$el.parentElement`）上的 `DC_SLOT_ATTR`（数字）→ `parseSlotRegion` 守卫 → resolver 拿 `parentInfo`。
+ * - 对 `defaults` 每个键产独立 computed：`resolver({ props: getProps(), parentInfo: region })`；未命中 region
+ *   也跑 resolver——resolver 返回 `props.xx`（≡ 透传，零差异）。
+ * - resolver 自带合并：`props.xx ?? (parentInfo===X ? 上下文默认 : undefined)`（`??` 只在 undefined 走上下文 = 显式优先）。
+ * - region 结构静态（槽位不随生命周期变），挂载 / 激活后解析一次并缓存。
+ *
+ * 使用注意（规范注释，[MUST] 遵守）：
+ * - 需上下文动态默认的 prop **[MUST NOT] 写 withDefaults 内建默认**（Boolean prop 缺席被 Vue 强转 false 会
+ *   短路 `??`，withDefaults 填 `undefined` 使缺席 ≡ undefined、合法；填内建 true/false 违规 → hook 首次调用
+ *   发 console.warn 防呆提示——次要流程，不阻塞）。详见本文件底部 warn 逻辑。
+ * - 模板 / 脚本一律用解构出的 `ctxXx`（模板 ComputedRef 自动解包），[MUST NOT] 用 `props.xx`（原始未解析值）。
+ * - resolver 内 `??` 与 `?:` 混用 [MUST] 加括号（`??` 优先级高于 `?:`，裸写会解析错）。
+ */
+export declare const useContextDefaults: <P extends Record<string, any>, D extends Record<string, (ctx: UseContextDefaultsResolverCtx<P>) => unknown>>(options: {
+    getProps: () => P;
+    defaults: D;
+}) => { [K in keyof D as `ctx${Capitalize<K & string>}`]: ComputedRef<D[K] extends (ctx: UseContextDefaultsResolverCtx<P>) => infer R ? R : unknown>; };

package/types/injectInfo.json.d.ts

@@ -1,6 +1,6 @@
 declare const _default: {
   "name": "@done-coding/admin-core",
-  "version": "0.22.1",
+  "version": "0.22.2",
   "description": "内部前端库"
 };