@done-coding/admin-core 0.31.0 → 0.31.1-alpha.0

package/types/components/app-layout/use-app-page-title-field.d.ts

@@ -0,0 +1,49 @@
+import { AppPageTitleField } from './types';
+/**
+ * `AppPage` 认领句柄的内部面（消费方**够不着**）。
+ *
+ * 🔴 键走 `Symbol.for(包名 + 键名)`（规则 8 同法）：dev 下 `@done-coding/admin-core`
+ * 走 dist、core 内部相对路径走源码，是**两个 module instance** ——
+ * 裸 `Symbol()` 会造出两个互不相等的符号，`AppPage` 就认领不到消费方建的句柄，
+ * 表现为「标题永远不变」且不报错。
+ */
+export declare const APP_PAGE_TITLE_FIELD_CLAIM: unique symbol;
+/** 句柄的内部认领面（仅 `AppPage` 使用，[MUST NOT] 写进对外类型） */
+export interface AppPageTitleFieldClaim {
+    /** 认领：装上写回口（`AppPage` 的 title model setter） */
+    claimWrite: (write: (title: string | undefined) => void) => void;
+    /** 认领：把 navbar 标题位元素喂进句柄（供消费方 Teleport） */
+    claimBox: (el: HTMLElement | undefined) => void;
+    /** 认领后是否已具备写回能力 */
+    isClaimed: () => boolean;
+}
+/** 带内部认领面的句柄（`AppPage` 内部断言用） */
+export type AppPageTitleFieldInternal = AppPageTitleField & {
+    [APP_PAGE_TITLE_FIELD_CLAIM]?: AppPageTitleFieldClaim;
+};
+/**
+ * 页面标题回写的**能力令牌**（`vq3mzn`）。
+ *
+ * ```vue
+ * const titleField = useAppPageTitleField();
+ * <AppPage v-model:title="title" show-nav-bar :title-field="titleField">
+ *   <ViewLayout :title-field="titleField" />
+ * </AppPage>
+ * ```
+ *
+ * 🔴 **令牌性 = 不给就够不着**：同一个句柄同时传给页面与子件，两边才接得上。
+ * [MUST NOT] 退回 provide/inject 全局通道 —— 那等于「页面里任何后代都能改标题」，
+ * 正是本设计要挡的。
+ *
+ * 🔴 **单句柄，[MUST NOT] 拆成 `secret` + `remoter` 两个**：接线点由 3 降到 2，
+ * 同名同值传两处，令牌性不丢，但不会传串、也不用分「给页面的那半 / 给子件的那半」。
+ *
+ * 🔴 **[MUST NOT] 加「子件必须是 AppPage 直系子元素」这类 DOM 校验**：本仓已两次付过代价
+ * （`useContextDefaults` 读直系父 DOM，消费方在插槽里包一层 `<div>` 就断链且静默）。
+ * 令牌管的是「谁能改」，DOM 层数管的是另一件事**且管不准** ——
+ * 包一层 div 的人并没有越权，他只是写了个 div。
+ *
+ * ⚠️ 未被任何 `AppPage` 认领时 `changeTitle` 走 **dev 期点名 warn**，
+ * [MUST NOT] 改成静默 no-op：「标题没变」这种失败形态本仓已连修四个。
+ */
+export declare const useAppPageTitleField: () => AppPageTitleField;

package/types/components/data-view/DataListViewItem.vue.d.ts

@@ -15,6 +15,13 @@ type __VLS_Props = {
     masonry?: boolean;
     /** 瀑布流跨度（`grid-row-end: span N`）；未测到时不写，退 CSS 兜底跨度 */
     spanRows?: number;
+    /**
+     * **不成网格时的纵向间距**（px → `margin-bottom`），由 DataListView 下发。
+     * 🔴 只在「不成网格 **且** 非末项」时有值：成网格的间距归容器的 grid `gap`
+     * （叠上去就是双份）；末项的 `margin-bottom` 会与父盒底边折叠、**穿透出去**
+     * —— 既不计入 `clientHeight` 又推开后邻（`ViewLayout` 栽过同一条）。
+     */
+    flowGap?: number;
 };
 declare function __VLS_template(): {
     attrs: Partial<{}>;

package/types/components/data-view/types.d.ts

@@ -77,6 +77,10 @@ export interface DataListViewProps<T extends Record<string, any>, F extends Reco
      * item 间距（px）。缺省取间距阶梯的**模块档**（`gap.size × 密度 × 1`，默认 8）——
      * grid 的 gap 是**卡与卡之间**，正是模块档的定义值。
      * [MUST NOT] 在消费侧写死像素补偿（改 gap 基数 / 换密度档时会脱钩）。
+     *
+     * 🔴 **与 {@link gridColumns} 正交**（zc6ptn）：不成网格时同样有间距 ——
+     * 那条路径走每项的 `margin-bottom`（末项不下发），值与成网格时**同一个**。
+     * 要贴合传 `0`。
      */
     gap?: number;
     /**
@@ -181,10 +185,22 @@ export interface InfiniteListViewProps<T extends Record<string, any> = Record<st
      * **项自己已经成卡**（面与面不叠，p4wrtn）。为真时容器**只撤面色、不撤呼吸与圆角** ——
      * 呼吸计入高度账（与可用高扣减同源），撤了会连带改 refine 的 reserve。
      *
-     * 🔴 判据 [MUST NOT] 收窄成「`card === true`」：`InfiniteListView` 没有 `card`
-     * （卡由消费方自画），那样写会整条漏掉它。
+     * 缺省**跟随 {@link card}**（v0.32.0，j8pwer）。
+     * ⚠️ 此前缺省恒 `false`，理由是「本组件没有内置卡壳、core 无从判断」——
+     * 卡壳补上之后那个理由消失了；不跟着改就会出现「有卡壳 + 容器仍铺面」的面套面。
      */
     itemCard?: boolean;
+    /**
+     * **内置卡壳**（默认 `true`，j8pwer）：面 + 圆角 + 1px 边框 + 内呼吸，全走 token，
+     * 落在每项外层的 `.infinite-list-view__row` 上。
+     *
+     * 🔴 取值与另两条卡片路径（`DataListView` / `DataGridView`）**同源**
+     * （共享 `card-shell.less` + 同一个 `cardPad`），[MUST NOT] 另写一套。
+     *
+     * ⚠️ **可见变更**：自画卡片视觉的消费方会多出一层边框 ⇒ 传 `false` 关掉，
+     * [MUST NOT] 在自己的卡上再画一层边框叠上去。
+     */
+    card?: boolean;
     /** 传入时容器限高滚动（内部 overflowY: auto）；数字 = px，字符串 = CSS 长度（如 "100vh"） */
     maxHeight?: number | string;
     /** opt-in 触摸下拉刷新（默认关） */
@@ -209,7 +225,14 @@ export interface InfiniteListViewProps<T extends Record<string, any> = Record<st
     estimateSizeAt?: (index: number) => number;
     /** 多列时的列间距（px，默认 0）；纵向间距走 {@link itemGap} */
     laneGap?: number;
-    /** 同列相邻项的纵向间距（px，默认 0）——透传 virtual-core 的 `gap` */
+    /**
+     * 同列相邻项的**纵向间距**（px）——透传 virtual-core 的 `gap`。
+     *
+     * 缺省取间距阶梯的**模块档**（`APP_LAYOUT_GAP_CONFIG.size × 密度 × 1`，默认 8），
+     * 与 `DataListView` 的 `gap` 同一个解析口（`useDataViewGap`）：
+     * **间距是列表的固有属性，不是某个形态的附属品**（zc6ptn）⇒ 缺省 [MUST NOT] 是 0。
+     * 要贴合显式传 `0`。
+     */
     itemGap?: number;
 }
 /** InfiniteListView 实例 */

package/types/components/data-view/use-grid-layout.d.ts

@@ -1,5 +1,35 @@
 import { ComputedRef, CSSProperties } from 'vue';
 import { DataViewGridColumns } from './types';
+/** {@link useDataViewGap} 返回 */
+export interface UseDataViewGapReturn {
+    /** 生效间距（px）：显式 `gap` > 间距阶梯**模块档** */
+    gapValue: ComputedRef<number>;
+    /**
+     * 内置卡壳的内呼吸（px）= 间距阶梯的**呼吸档**（×1.5，默认 12）。
+     * 🔴 [MUST NOT] 改读 `--dc-core-content-gap` —— 那是 huhyx7 明令废掉的第二来源，
+     * 与 gap 各随不同轴变动，最松密度档会出现「卡内 20 ≥ 外圈 20 > 卡间 8」的乱序。
+     * 与 `hooks/use-surface.ts` 同档同源（数据区自持面的内呼吸也是这一档）。
+     */
+    cardPad: ComputedRef<number>;
+}
+/**
+ * item 间距解析 —— **本族三条路径唯一的口**（zc6ptn）。
+ *
+ * 🔴 **存在的理由 = 让「同源同值」成为构造保证**：`DataListView`（成网格走 grid `gap`、
+ * 不成网格走项的 `margin-bottom`）、`InfiniteListView`（`itemGap` 透传虚拟器）、
+ * 瀑布流装箱（跨度里的 gap 分量）三处用的必须是**同一个数**。各写一份
+ * `gap ?? gapScaleValue(...)` 看着一样，但改口径时必漏一处 ⇒ 抽成函数。
+ *
+ * 缺省取**模块档**（×1，默认 8）而非历史写死的 12：`gap` 是**卡与卡之间**，
+ * 正是模块档的定义；12 是**呼吸档**（卡片内边距）的值，属档位用错。
+ * 归位后同时接上 density 缩放（compact/cozy/comfortable ×0.75/×1/×1.5）。
+ *
+ * ⚠️ [MUST NOT] 为拿这个值去调 {@link useDataViewGridLayout} —— 那会白挂一份
+ * `useBreakpoint`（matchMedia 监听），只为一个永不求值的 `gridTemplateColumns`。
+ *
+ * @param gap 惰性 getter：显式间距（px）；`undefined` = 取模块档
+ */
+export declare const useDataViewGap: (gap: () => number | undefined) => UseDataViewGapReturn;
 /** {@link useDataViewGridLayout} 入参（全部惰性 getter，保持响应式） */
 export interface UseDataViewGridLayoutOptions {
     /** 列数配置；`undefined` = 不成网格 */
@@ -15,12 +45,7 @@ export interface UseDataViewGridLayoutReturn {
     gridTemplateColumns: ComputedRef<string | undefined>;
     /** 网格容器样式；不成网格时 `undefined`（调用方原样透给 `:style`） */
     gridStyle: ComputedRef<CSSProperties | undefined>;
-    /**
-     * 内置卡壳的内呼吸（px）= 间距阶梯的**呼吸档**（×1.5，默认 12）。
-     * 🔴 [MUST NOT] 改读 `--dc-core-content-gap` —— 那是 huhyx7 明令废掉的第二来源，
-     * 与 gap 各随不同轴变动，最松密度档会出现「卡内 20 ≥ 外圈 20 > 卡间 8」的乱序。
-     * 与 `hooks/use-surface.ts` 同档同源（数据区自持面的内呼吸也是这一档）。
-     */
+    /** 内置卡壳的内呼吸（px）= 间距阶梯的**呼吸档**；转发自 {@link UseDataViewGapReturn.cardPad} */
     cardPad: ComputedRef<number>;
 }
 /**

package/types/components/form/types.d.ts

@@ -81,8 +81,14 @@ SV extends PK extends keyof SO ? SO[PK] : PV = PK extends keyof SO ? SO[PK] : PV
     /** 表单项label */
     label: string;
     /**
-     * 隐藏 label 且不占位（label-wrap 整体 display:none，表单元素顶满整行）。
-     * 仅当 label 有值时生效——无 label 时 element-plus 会给 content 加 margin-left 留白，需改用 labelWidth:0。
+     * 隐藏 label 且不占位（label 整体 `display:none`，表单元素顶满整行）。
+     *
+     * ⚠️ 仅当 label 有值时生效——无 label 时 element-plus 会给 content 加 margin-left 留白，
+     * 需改用 `labelWidth: 0`。
+     *
+     * 🔴 **v0.32.0 起对「裸 `FormMain`」（未给 `labelWidth`）同样生效**：此前实现只藏
+     * `.el-form-item__label-wrap`，而那层 wrap **EP 只在 `label-width: auto` 时才渲染**
+     * ⇒ 裸用时类挂上了、规则匹配不到任何元素，**静默失效**（ncl4rj）。
      */
     labelHide?: boolean;
     /** 提示信息 */

package/types/components/list-layout/ListLayout.vue.d.ts

@@ -21,6 +21,7 @@ declare const _default: <T extends Record<string, any>, PO extends Record<string
         activeData?: T | undefined;
     } & Partial<Pick<import('../form').FormSearchProps<PO, SO, {}>, "staticQuery">> & {
         title?: string;
+        titleField?: import('../app-layout').AppPageTitleField;
         formSearchProps?: Partial<Omit<import('../form').FormSearchProps<PO, SO, {}>, "staticQuery" | "compact" | "list">> | undefined;
     } & Pick<import('../table').TableMainProps<T, import('../form').ExcludeNeverProperties<import('../form').ExtractFormStringifyRawFromObject<PO, SO>> & SQ, ListLayoutInnerInjectInfo<PO, F>>, import('./types').TableMainRequiredKey> & Partial<Pick<import('../table').TableMainProps<T, import('../form').ExcludeNeverProperties<import('../form').ExtractFormStringifyRawFromObject<PO, SO>> & SQ, ListLayoutInnerInjectInfo<PO, F>>, import('./types').TableMainOptionsKey>> & {
         tableMainProps?: Partial<Omit<import('../table').TableMainProps<T, import('../form').ExcludeNeverProperties<import('../form').ExtractFormStringifyRawFromObject<PO, SO>> & SQ, ListLayoutInnerInjectInfo<PO, F>>, import('./types').TableMainOptionsKey | import('./types').TableMainRewriteKey>> | undefined;
@@ -52,7 +53,17 @@ declare const _default: <T extends Record<string, any>, PO extends Record<string
     attrs: any;
     slots: Readonly<{
         /** 头部插槽（无 scope） */
-        header?: () => VNode[];
+        /**
+         * 标题行（插槽 > `title` > 不渲染）。
+         * **scope 带 `title`**（v0.32.0 补，与 `ViewLayout` 对齐）——插槽接管后仍拿得到原标题，
+         * 「加个徽标 / 副标题」这类小改不必把 `title` 再从外面透一遍。
+         *
+         * ⚠️ 它是**内容区的标题行**，不是页面 chrome。要页面级 navbar（返回 / ⋮ / tabbar）
+         * [MUST] 走 `AppPage` 的 `showNavBar` —— **同名不同物**，[MUST NOT] 拿本槽拼。
+         */
+        header?: (scope: {
+            title?: string;
+        }) => VNode[];
         /** 操作区插槽（无 scope） */
         operation?: () => VNode[];
         /** 自定义视图项插槽 */
@@ -62,7 +73,17 @@ declare const _default: <T extends Record<string, any>, PO extends Record<string
         triggerSearch: (() => void) | undefined;
     }) => VNode[]) | undefined; }> & {
         /** 头部插槽（无 scope） */
-        header?: () => VNode[];
+        /**
+         * 标题行（插槽 > `title` > 不渲染）。
+         * **scope 带 `title`**（v0.32.0 补，与 `ViewLayout` 对齐）——插槽接管后仍拿得到原标题，
+         * 「加个徽标 / 副标题」这类小改不必把 `title` 再从外面透一遍。
+         *
+         * ⚠️ 它是**内容区的标题行**，不是页面 chrome。要页面级 navbar（返回 / ⋮ / tabbar）
+         * [MUST] 走 `AppPage` 的 `showNavBar` —— **同名不同物**，[MUST NOT] 拿本槽拼。
+         */
+        header?: (scope: {
+            title?: string;
+        }) => VNode[];
         /** 操作区插槽（无 scope） */
         operation?: () => VNode[];
         /** 自定义视图项插槽 */

package/types/components/list-layout/types.d.ts

@@ -1,6 +1,7 @@
 import { ExtractFormStringifyFromObject, ExtractFormStringifyFromList, FormItemConfigList, FormSearchInstance, FormSearchProps, FormSearchSearchType } from '../form';
 import { TableApiParams, TableApiResult, TableMainInstance, TableMainProps } from '../table';
 import { SlotLayoutFlowAsideProps } from '../slot-layout';
+import { AppPageTitleField } from '../app-layout';
 import { DataGridViewProps, GridColumnsConfig, InfiniteListViewConfig } from '../data-view';
 export type FormSearchOptionsKey = "staticQuery";
 export type FormSearchRewriteKey = "list";
@@ -28,6 +29,12 @@ F extends Record<string, any>> = Partial<Pick<FormSearchProps<PO, SO, {}>, FormS
      * 常见场景传 `title` 即可。与 `ViewLayout.title` 同口径 —— 列表页与详情页头部结构对齐。
      */
     title?: string;
+    /**
+     * 页面标题回写的**能力令牌**（`useAppPageTitleField()` 的产物，v0.32.0）。
+     * 传了即把本组件的 {@link title} 推给页面级 navbar（与 `ViewLayout` 同口径）。
+     * ⚠️ 同一个句柄**只该给一个**子件：一页一个 navbar、一个标题，给两个就是后写的赢。
+     */
+    titleField?: AppPageTitleField;
     formSearchProps?: Partial<Omit<FormSearchProps<PO, SO, {}>, FormSearchOptionsKey | FormSearchRewriteKey | "compact">>;
 } & Pick<TableMainProps<T, ExtractFormStringifyFromObject<PO, SO> & SQ, ListLayoutInnerInjectInfo<PO, F>>, TableMainRequiredKey> & Partial<Pick<TableMainProps<T, ExtractFormStringifyFromObject<PO, SO> & SQ, ListLayoutInnerInjectInfo<PO, F>>, TableMainOptionsKey>> & {
     tableMainProps?: Partial<Omit<TableMainProps<T, ExtractFormStringifyFromObject<PO, SO> & SQ, ListLayoutInnerInjectInfo<PO, F>>, TableMainOptionsKey | TableMainOptionsKey | TableMainRewriteKey>>;

package/types/components/view-layout/ViewLayout.vue.d.ts

@@ -18,6 +18,8 @@ declare const _default: <P extends Record<string, any> = Record<string, any>, R
         header?: (scope: {
             data: R | undefined;
             loading: boolean;
+            /** 原 `title` prop 值（v0.32.0 补）——插槽接管后仍拿得到，不必再从外面透一遍 */
+            title?: string;
         }) => VNode[];
         /**
          * 底部区插槽；不传即完全不渲染（[MUST NOT] 留空盒占 reserve）。
@@ -34,14 +36,6 @@ declare const _default: <P extends Record<string, any> = Record<string, any>, R
             loading: boolean;
             fetchSeq: number;
         }) => VNode[];
-        /**
-         * `appBar` 形态右侧「更多」位的内容（默认 `MoreFilled` ⋮）。**仅 `appBar` 开启时渲染**。
-         *
-         * ⚠️ 点击绑在**外层 `span`** 上 ⇒ 本槽内容 [MUST] 按「哑内容」设计（图标 / 文字）。
-         * 塞进带点击的组件（如 `ActionBtn`）时其事件会冒泡到外层、与 `onMore` / 菜单**双触发**；
-         * 要自己接管点击就别传回调，或在槽内 `@click.stop`。
-         */
-        more?: () => VNode[];
     }> & {
         default: (scope: ViewLayoutScope<R>) => VNode[];
         /**
@@ -52,6 +46,8 @@ declare const _default: <P extends Record<string, any> = Record<string, any>, R
         header?: (scope: {
             data: R | undefined;
             loading: boolean;
+            /** 原 `title` prop 值（v0.32.0 补）——插槽接管后仍拿得到，不必再从外面透一遍 */
+            title?: string;
         }) => VNode[];
         /**
          * 底部区插槽；不传即完全不渲染（[MUST NOT] 留空盒占 reserve）。
@@ -68,14 +64,6 @@ declare const _default: <P extends Record<string, any> = Record<string, any>, R
             loading: boolean;
             fetchSeq: number;
         }) => VNode[];
-        /**
-         * `appBar` 形态右侧「更多」位的内容（默认 `MoreFilled` ⋮）。**仅 `appBar` 开启时渲染**。
-         *
-         * ⚠️ 点击绑在**外层 `span`** 上 ⇒ 本槽内容 [MUST] 按「哑内容」设计（图标 / 文字）。
-         * 塞进带点击的组件（如 `ActionBtn`）时其事件会冒泡到外层、与 `onMore` / 菜单**双触发**；
-         * 要自己接管点击就别传回调，或在槽内 `@click.stop`。
-         */
-        more?: () => VNode[];
     };
     emit: (evt: "update:isAutoRefresh", value: boolean) => void;
 }>) => import('vue').VNode & {

package/types/components/view-layout/ViewLayoutToolbar.vue.d.ts

@@ -1,4 +1,4 @@
-import { AppPageListDetailNavigationContext, ViewLayoutButtonConfig, ViewLayoutButtonContext, ViewLayoutMoreOption } from './types';
+import { AppPageListDetailNavigationContext, ViewLayoutButtonConfig, ViewLayoutButtonContext } from './types';
 type __VLS_Props = {
     /** v-show 判据（父算好传入：有工具条内容或有标题） */
     visible: boolean;
@@ -20,19 +20,13 @@ type __VLS_Props = {
     showRefresh: boolean;
     /** 横向内边距（左右同值，gap 阶梯派生，父算好传入；[MUST NOT] 在本组件重算） */
     padXPx: string;
-    /** 移动端 app bar 形态（四项 gate 的总闸） */
-    appBar?: boolean;
-    back?: () => void;
-    moreOptions?: ViewLayoutMoreOption[];
-    onMoreSelect?: (item: ViewLayoutMoreOption) => void;
-    onMore?: () => void;
+    /** 同组元素之间的间隔 px 串（呼吸档，父算好传入 —— 真相源在父，[MUST NOT] 在此重算） */
+    groupGapPx: string;
 };
 declare function __VLS_template(): {
     attrs: Partial<{}>;
     slots: {
         header?(_: {}): any;
-        more?(_: {}): any;
-        more?(_: {}): any;
     };
     refs: {};
     rootEl: HTMLDivElement;

package/types/components/view-layout/types.d.ts

@@ -1,5 +1,6 @@
 import { Ref } from 'vue';
 import { ActionBtnConfigItem } from '../display';
+import { AppPageTitleField } from '../app-layout';
 /**
  * 列表 / 详情同页范式的导航上下文（`APP_PAGE_LIST_DETAIL_CONTEXT` 的值形状）。
  * 在此重声明一份**结构等价**的类型，是为了让 view-layout 族不反向 import inject 桶
@@ -61,15 +62,6 @@ export type ViewLayoutButtonConfig = ActionBtnConfigItem<ViewLayoutButtonContext
 /**
  * ViewLayout 展示布局 props
  */
-/**
- * `appBar` 形态下右侧「更多」菜单的一项（规则 9：桶内符号带 `ViewLayout` 命名空间前缀）。
- */
-export interface ViewLayoutMoreOption {
-    /** 菜单项展示文案 */
-    label: string;
-    /** 菜单项值（业务据它分发；回调入参是**整条配置**而非本值） */
-    value: string | number;
-}
 export interface ViewLayoutProps<P = Record<string, any>, R = any> {
     /** 数据拉取函数：params 来自 props.params（未传则收 undefined），每次拉取（激活 / 手动刷新 / 自动刷新）传入 */
     api: (params?: P) => Promise<R>;
@@ -132,50 +124,19 @@ export interface ViewLayoutProps<P = Record<string, any>, R = any> {
     /** 右侧额外按钮（置于 AutoRefreshGroup 之前） */
     rightExtraButtons?: ViewLayoutButtonConfig[];
     /**
-     * **移动端 app bar 形态**（默认关，opt-in）。
+     * 页面标题回写的**能力令牌**（`useAppPageTitleField()` 的产物，v0.32.0）。
      *
-     * 开启后 toolbar 变成移动端 header 的样子：去掉左缘 3px 主色条 · 下边缘加投影 ·
-     * `min-height: 44px`，并**解锁** {@link back} 与右侧「更多」位。
+     * 传了即把**本组件正在渲染的标题**（{@link title}）推给页面级 navbar
+     * ⇒ 「详情页头部」与「页面 navbar」不必各维护一份标题。
      *
-     * 🔴 **四项能力全部由本开关 gate**（甲方 2026-09-19：「左侧的 back、右侧的三个点、
-     * chrome 最小高度 44、无圆角，**都是通过 props 开启移动端模式才有的**」）——
-     * 不开启时传了 `back` / `moreOptions` 也**不渲染**，高度不加 44 下限。
-     * [MUST NOT] 实现成「传了就生效」：那在默认形态下只是多出一个按钮、不报错，
-     * 是最容易漏掉又最难发现的一类偏差。
+     * 🔴 它的价值在**够不着内层组件**的场合：`AppPageListDetailLayout` 里的 `ViewLayout`
+     * 是门面内部的，消费方只能经 `viewLayoutProps` 传进来。
      *
-     * 🔴 **只由消费方显式开启，[MUST NOT] 自动检测**（甲方：「是**开启**，不是检测是移动端」）。
-     * [MUST NOT] 用 `matchMedia` / UA / 视口宽 / 容器断点自动切 —— 同一套 core 服务多形态应用，
-     * 「窄就是移动端」不成立（分栏详情 / 侧栏 / 弹窗里都窄），自动切会让消费方在完全
-     * 没配置的情况下突然换一套 chrome。
+     * ⚠️ **标题要从拉到的 `data` 里派生**时 [MUST NOT] 指望本 prop（它转发的是 `title`）——
+     * 那种场合直接在插槽里用 scope 的 `data` 自己调 `titleField.changeTitle(...)`，
+     * 令牌本就在消费方手里。
      *
-     * ⚠️ 命名避开 `header`：本组件**已有 `#header` 插槽**（标题槽），
-     * 叫 `headerMode` 会让「header 模式」与「#header 槽」在文档与代码里天天打架。
-     */
-    appBar?: boolean;
-    /**
-     * 返回回调；给了才渲染左侧返回箭头，**且仅 `appBar` 开启时**。
-     *
-     * 箭头的点击热区靠外层 padding 撑到 ≥44×44（移动端触控下限），
-     * [MUST NOT] 只放大图标本身 —— 那只是看着大、点不准。
-     */
-    back?: () => void;
-    /**
-     * `appBar` 右侧「更多」菜单项；配了（非空）即点击开 `ElDropdown` 菜单。
-     * **仅 `appBar` 开启时生效**。
-     */
-    moreOptions?: ViewLayoutMoreOption[];
-    /**
-     * 选中「更多」菜单项。**入参恒是整条 item 配置**（不是 `value`）。
-     *
-     * 仅在**配了** {@link moreOptions} 时可能触发；没配菜单时走 {@link onMore}。
-     * 🔴 两个回调**各自单义、由配置互斥**，[MUST NOT] 合并成「一个回调 + 可选参数」——
-     * 消费方**静态就知道**自己配没配菜单，可选参数会强迫他处理一个在他那份配置里
-     * 根本不可能发生的分支，而文档只能靠脚注补救。需要脚注解释的签名通常是该拆了。
-     */
-    onMoreSelect?: (item: ViewLayoutMoreOption) => void;
-    /**
-     * **没配** {@link moreOptions} 时，点击「更多」位**直接触发**（不出菜单）。
-     * 仅 `appBar` 开启时生效；与 {@link onMoreSelect} 由配置互斥。
+     * ⚠️ 同一个句柄**只该给一个**子件：一页一个 navbar、一个标题，给两个就是后写的赢。
      */
-    onMore?: () => void;
+    titleField?: AppPageTitleField;
 }

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

@@ -35,7 +35,23 @@ export declare enum SlotRegion {
      * 否则暗色下 overlay `#1d1e1f` 上盖 `#141414` 会出现「弹窗里凹下去一块」
      * （亮色两者都是 `#fff`，**看不出来** —— [MUST NOT] 只用亮色截图验收）。
      */
-    ModalConfirm_Body = 7
+    ModalConfirm_Body = 7,
+    /**
+     * ModalConfirm **抽屉形态**的正文区（drawer 的默认插槽直系父）。
+     *
+     * 🔴 **与 {@link ModalConfirm_Body} 是两个档，不是一个档的两种写法**：
+     * 抽屉正文自 v0.32.0 起取**底色**（k2vnfp）⇒ 它**不再是一块面**
+     * ⇒ 后代 [MUST] 自持面（与 modal 正文那档**正好相反**）。
+     *
+     * ⚠️ 上面那条标记的语义一直是「**你脚下是一块面**」。抽屉正文改成底之后它就不再是
+     * 那个意思了 —— 所以是**换一个标**，[MUST NOT] 把那个标的含义反过来
+     * （反过来会把 modal 形态一起改掉，而 modal 正文仍是面、那儿的自动关面是对的）。
+     *
+     * ⚠️ 它同时还被「**refine 默认开**」那一路消费（`ViewLayout` / `TabsMain`）——
+     * 抽屉与弹窗**两档都 provide 有界可用高** ⇒ 那一路 [MUST] 把两个档都列上，
+     * 漏一个就是「抽屉里的 ViewLayout 掉回自然流」。
+     */
+    ModalConfirm_DrawerBody = 8
 }
 /**
  * 读 DOM 槽位数字值并守卫：数字读回是字符串，[MUST] 经本函数 `Number()` 强转 + 枚举值校验；

package/types/injectInfo.json.d.ts

@@ -1,6 +1,6 @@
 declare const _default: {
   "name": "@done-coding/admin-core",
-  "version": "0.31.0",
+  "version": "0.31.1-alpha.0",
   "description": "内部前端库"
 };