@done-coding/admin-core 0.9.0 → 0.9.1-alpha.0

package/types/components/panel/nest-panel-form.d.ts

@@ -0,0 +1,38 @@
+import { ColProps } from 'element-plus';
+import { PanelItemConfig, PanelScopeBase } from './types';
+import { FormItemConfigList } from '../form';
+export interface NestPanelFormOptions {
+    /** 父 item key */
+    key: string;
+    /** 父 item label */
+    label?: string;
+    /** 子 FormMain 配置列表（吃嵌套子对象） */
+    list: FormItemConfigList;
+    /** 父 item 栅格布局 */
+    layout?: Partial<ColProps>;
+    /** 子表单行间距 */
+    rowGutter?: number;
+    /** 提交按钮文案 */
+    submitText?: string;
+    /** 取消按钮文案 */
+    cancelText?: string;
+    /** 是否可编辑，缺省 true */
+    editable?: boolean | ((scope: PanelScopeBase) => boolean);
+    /** 单字段提交：校验通过后回流草稿到父数据（panel 既有 submitFn 语义） */
+    submitFn: PanelItemConfig["submitFn"];
+    /** 只读态展示渲染；缺省走 PanelItem 默认（纯文本 data[key]） */
+    render?: PanelItemConfig["render"];
+    /** 是否叠本层嵌套布局 rebase（P3，缺省 true；false = 逆向逃生口，子层 layout 原样直透） */
+    rebase?: boolean;
+}
+/**
+ * 生成「父 panel item 编辑态内嵌子 FormMain」的 PanelItemConfig（C3 配套 helper）
+ * ----
+ * 走 editorRender（优先级高于 editorConfig，panel/types.ts L65-77）挂 PanelItemNestForm：
+ * - 编辑态：PanelEditSwitch 进编辑时深克隆草稿（scope.data），子 FormMain 绑草稿嵌套对象
+ *   in-place 编辑（不穿透真实 data，ADR-5 panel 分支）；
+ * - 提交：组件内 validateChild 通过 → 本 helper wire 的 submit（`submitFn(草稿) → closeEdit`）回流；
+ * - 取消：closeEdit 关编辑态，草稿丢弃，下次进编辑重新克隆。
+ * editorConfig 与 editorRender 互斥——C3 用 editorRender，同一 item [MUST NOT] 再配 editorConfig。
+ */
+export declare function nestPanelForm(options: NestPanelFormOptions): PanelItemConfig;

package/types/components/panel/nest-panel-item.d.ts

@@ -0,0 +1,28 @@
+import { ColProps, CardProps } from 'element-plus';
+import { PanelItemConfig, PanelItemConfigList } from './types';
+export interface NestPanelItemOptions {
+    /** 父 item key */
+    key: string;
+    /** 父 item label */
+    label?: string;
+    /** 子 PanelMain 配置列表（吃嵌套子对象） */
+    list: PanelItemConfigList;
+    /** 父 item 栅格布局 */
+    layout?: Partial<ColProps>;
+    /** 子 PanelMain 子项是否包 Card */
+    itemCard?: boolean | Partial<CardProps & {
+        lastMarginBottom?: string;
+    }>;
+    /** 子 PanelMain 行间距 */
+    rowGutter?: number;
+    /** 是否叠本层嵌套布局 rebase（P3，缺省 true；false = 逆向逃生口，子层 layout 原样直透） */
+    rebase?: boolean;
+}
+/**
+ * 生成「父 panel item 内嵌子 PanelMain」的 PanelItemConfig（C2 配套 helper）
+ * ----
+ * 降低业务方手写 h(PanelItemNestPanel) 噪音：传 key/label/子 list 即得一个满足
+ * PanelItemConfig 的纯展示配置项，render 出口挂 PanelItemNestPanel（嵌套对象只读展示）。
+ * 值贯通：render scope.value（= data[key] 嵌套对象）作子 PanelMain.data。
+ */
+export declare function nestPanelItem(options: NestPanelItemOptions): PanelItemConfig;

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

@@ -63,6 +63,8 @@ export interface PanelMainProps<PO extends Record<string, any> = Record<string,
     /** 行水平间距 */
     rowGutter?: number;
     layout?: Partial<ColProps>;
+    /** P3 嵌套 rebase 累乘因子（缺省 1 = 顶级行为不变，向后兼容）。由联结薄壳算出后传子 PanelMain */
+    layoutScale?: number;
     list: PanelItemConfigList<PO, SO>;
     /** item是否包括Card */
     itemCard?: boolean | Partial<CardProps & {

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

@@ -1,15 +1,15 @@
 import { TableMainProps, TableMainInstance, ElTableColumnProps, TablePageInfo } from './types';
 declare const _default: <T extends Record<string, any>, SQ extends Record<string, any>, F extends Record<string, any>>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_expose?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
     props: __VLS_PrettifyLocal<Pick<Partial<{}> & Omit<{
-        readonly onLoadingChange?: ((value: boolean) => any) | undefined;
         readonly "onUpdate:isAutoRefresh"?: ((value: boolean) => any) | undefined;
+        readonly onLoadingChange?: ((value: boolean) => any) | undefined;
         readonly "onUpdate:refreshInterval"?: ((value: number) => any) | undefined;
         readonly "onUpdate:customView"?: ((value: boolean) => any) | undefined;
         readonly onPageChange?: ((value: number) => any) | undefined;
         readonly onPageSizeChange?: ((value: number) => any) | undefined;
         readonly onDataChange?: ((data: T[]) => any) | undefined;
         readonly onPageInfoChange?: ((info: TablePageInfo) => any) | undefined;
-    } & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps, never>, "onLoadingChange" | "onUpdate:isAutoRefresh" | "onUpdate:refreshInterval" | "onUpdate:customView" | "onPageChange" | "onPageSizeChange" | "onDataChange" | "onPageInfoChange"> & ({
+    } & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps, never>, "onUpdate:isAutoRefresh" | "onLoadingChange" | "onUpdate:refreshInterval" | "onUpdate:customView" | "onPageChange" | "onPageSizeChange" | "onDataChange" | "onPageInfoChange"> & ({
         isAutoRefresh?: boolean;
         refreshInterval?: number;
         customView?: boolean;

package/types/inject/key.d.ts

@@ -1,7 +1,8 @@
-import { InjectionKey } from 'vue';
+import { InjectionKey, Ref } from 'vue';
 import { AdminBridge } from '../bridge';
 import { ModalLevel, ShelfController } from '../components/modal';
 import { AppLayoutAppStoreSlice, AppLayoutUserStoreSlice, AppLayoutBridgeSlice } from '../components/app-layout';
+import { NestFormExposeMap } from '../components/form';
 /**
  * body 视口高度
  * ---
@@ -70,3 +71,29 @@ export declare const APP_LAYOUT_BRIDGE_KEY: InjectionKey<AppLayoutBridgeSlice>;
  * Symbol.for 保证跨包/跨 chunk/跨 ESM 实例唯一（同 APP_LAYOUT_BRIDGE_KEY，规则 8）。
  */
 export declare const ADMIN_BRIDGE_KEY: InjectionKey<AdminBridge>;
+/**
+ * 嵌套子 FormMain exposeMap inject key（配置化嵌套联结组件 Nest 三件套挂载）。
+ * ---
+ * 每个 FormMain `provide` 一份本 key 的空 exposeMap（shallowReactive，按 item key 索引），
+ * 供其后代联结组件（FormItemNestForm）`inject` 到**最近祖先** FormMain 的 map 并把子
+ * FormMain 的级联 expose 写入（key = 自身 item key）；FormMain 的 validate/clearValidate/
+ * resetFields 遍历自身 map 级联子表单。
+ * ---
+ * provide/inject 链天然实现「只挂最近祖先」（inject 向上解析至最近 provide）。
+ * 注册由联结组件显式触发（非裸嵌套 FormMain 自动注册）→ 旧用法零回归（additive）。
+ * ---
+ * Symbol.for 保证跨包/跨 chunk/跨 ESM 实例唯一（规则 8，同上）。
+ */
+export declare const FORM_NEST_REGISTRY_KEY: InjectionKey<NestFormExposeMap>;
+/**
+ * 嵌套布局 rebase 累乘因子 inject key（P3 嵌套布局 rebase 挂载）。
+ * ---
+ * 每个 FormMain / PanelMain `provide` 自身 `layoutScale`（缺省 1）的响应式只读引用；
+ * 其后代联结组件（FormItemNestForm / FormItemNestFormList / PanelItemNestPanel /
+ * PanelItemNestForm）`inject` 到**最近祖先**的 scale，叠本层因子
+ * `childScale = parentScale × (24 / parentItemSpan)` 后作 `layoutScale` 传子 Form/PanelMain。
+ * ---
+ * 顶级 FormMain/PanelMain 未嵌套时 provide 1 → 子层缺省行为不变（向后兼容）。
+ * Symbol.for 保证跨包/跨 chunk/跨 ESM 实例唯一（规则 8，同上）。
+ */
+export declare const NEST_LAYOUT_SCALE_KEY: InjectionKey<Readonly<Ref<number>>>;