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

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

@@ -1,11 +1,36 @@
 import { DatePickerShortcut, FormItemConfig, FormItemConfigList, ExtractFormStringifyFromObject, FormItemConfigSwiftOptions } from './types';
 import { ColProps } from 'element-plus';
+/**
+ * 嵌套布局 rebase 的栅格档集（P3）。
+ * ---
+ * FormMain/PanelMain 配置化 `span` 约定用 24 的约数 {6,8,12,24}（admin 常用档）；
+ * 子层 rebase（×scale）后 ceil 到这组档，避免非约数（18/16/7）致行铺不满 ragged。
+ */
+export declare const NEST_LAYOUT_TIERS: readonly [6, 8, 12, 24];
+/**
+ * 把数值 ceil 到档集中 ≥ value 的最近一档（偏宽取向）。
+ * ---
+ * - value ≤ 下限 → 取下限；value ≥ 上限 → 封顶上限。
+ * - 落档间 → 抬到上一档（如 16 → 24，非更近的 12），合「容器窄字段更宽」意图。
+ */
+export declare const ceilToTier: (value: number, tiers?: readonly number[]) => number;
+/**
+ * 从 layout 解析父 item 实际分配的代表 span（P3 rebase 算因子用）。
+ * ---
+ * span 优先；无 span 时取 lg→md→sm→xl→xs 首个数值断点代表；都无 → 24（本层不缩）。
+ */
+export declare const resolveLayoutSpan: (layout?: Partial<ColProps>) => number;
 /**
  * 将 layout 解析为各屏幕尺寸的显式值：
  * - 配置 span: xxx 时，xs/sm/md/lg/xl 默认全部视为 xxx
  * - 单独设置某个尺寸则该尺寸覆盖 span 推导值
+ * ---
+ * **P3 嵌套 rebase**：可选第 2 参 `scale`（嵌套累乘因子，缺省 1）。
+ * - `scale === 1` → 现状行为不变（非档值原样透传，[MUST NOT] ceil，向后兼容关键）。
+ * - `scale !== 1` → span 及各断点数值 `× scale` 后经 `ceilToTier` 取整到档集，
+ *   维持子层字段绝对宽与顶级一致（容器变窄 → span 变大）。
  */
-export declare const resolveFormLayout: (layout?: Partial<ColProps>) => Partial<ColProps>;
+export declare const resolveFormLayout: (layout?: Partial<ColProps>, scale?: number) => Partial<ColProps>;
 /**
  * 生成 ElDatePicker 原生 `shortcuts` 的默认时间段快捷值：今日、昨日、近7日。
  * 直接用于 `<ElDatePicker :shortcuts="getDatePickerShortcuts()">`——

package/types/components/menu/MenuTree.vue.d.ts

@@ -10,7 +10,7 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {
     open: (index: string) => void | undefined;
     close: (index: string) => void | undefined;
 }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
-    elMenu: import('vue').CreateComponentPublicInstanceWithMixins<Readonly<globalThis.ExtractPropTypes<{
+    elMenu: import('vue').CreateComponentPublicInstanceWithMixins<Readonly<import('vue').ExtractPropTypes<{
         readonly mode: import('element-plus/es/utils/index.mjs').EpPropFinalized<StringConstructor, "horizontal" | "vertical", unknown, "vertical", boolean>;
         readonly defaultActive: import('element-plus/es/utils/index.mjs').EpPropFinalized<StringConstructor, unknown, unknown, "", boolean>;
         readonly defaultOpeneds: import('element-plus/es/utils/index.mjs').EpPropFinalized<(new (...args: any[]) => string[]) | (() => string[]) | (((new (...args: any[]) => string[]) | (() => string[])) | null)[], unknown, unknown, () => [], boolean>;
@@ -25,11 +25,11 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {
         readonly collapseTransition: import('element-plus/es/utils/index.mjs').EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
         readonly ellipsis: import('element-plus/es/utils/index.mjs').EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
         readonly popperOffset: import('element-plus/es/utils/index.mjs').EpPropFinalized<NumberConstructor, unknown, unknown, 6, boolean>;
-        readonly ellipsisIcon: import('element-plus/es/utils/index.mjs').EpPropFinalized<(new (...args: any[]) => (string | Component) & {}) | (() => string | Component) | (((new (...args: any[]) => (string | Component) & {}) | (() => string | Component)) | null)[], unknown, unknown, () => import('vue').DefineComponent<{}, void, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>, boolean>;
+        readonly ellipsisIcon: import('element-plus/es/utils/index.mjs').EpPropFinalized<(new (...args: any[]) => (string | import('vue').Component) & {}) | (() => string | import('vue').Component) | (((new (...args: any[]) => (string | import('vue').Component) & {}) | (() => string | import('vue').Component)) | null)[], unknown, unknown, () => import('vue').DefineComponent<{}, void, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>, boolean>;
         readonly popperEffect: import('element-plus/es/utils/index.mjs').EpPropFinalized<(new (...args: any[]) => string) | (() => import('element-plus').PopperEffect) | (((new (...args: any[]) => string) | (() => import('element-plus').PopperEffect)) | null)[], unknown, unknown, "dark", boolean>;
         readonly popperClass: StringConstructor;
         readonly popperStyle: {
-            readonly type: globalThis.PropType<import('element-plus/es/utils/index.mjs').EpPropMergeType<(new (...args: any[]) => string | import('vue').CSSProperties) | (() => string | import('vue').CSSProperties) | (((new (...args: any[]) => string | import('vue').CSSProperties) | (() => string | import('vue').CSSProperties)) | null)[], unknown, unknown>>;
+            readonly type: import('vue').PropType<import('element-plus/es/utils/index.mjs').EpPropMergeType<(new (...args: any[]) => string | import('vue').CSSProperties) | (() => string | import('vue').CSSProperties) | (((new (...args: any[]) => string | import('vue').CSSProperties) | (() => string | import('vue').CSSProperties)) | null)[], unknown, unknown>>;
             readonly required: false;
             readonly validator: ((val: unknown) => boolean) | undefined;
             __epPropKey: true;
@@ -41,7 +41,7 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {
         onClose?: ((index: string, indexPath: string[]) => any) | undefined;
         onSelect?: ((index: string, indexPath: string[], item: import('element-plus').MenuItemClicked, routerResult?: Promise<void | import('vue-router').NavigationFailure> | undefined) => any) | undefined;
         onOpen?: ((index: string, indexPath: string[]) => any) | undefined;
-    }>, () => VNode<import('vue').RendererNode, import('vue').RendererElement, {
+    }>, () => import('vue').VNode<import('vue').RendererNode, import('vue').RendererElement, {
         [key: string]: any;
     }>, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
         close: (index: string, indexPath: string[]) => boolean;
@@ -59,7 +59,7 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {
         readonly menuTrigger: import('element-plus/es/utils/index.mjs').EpPropMergeType<StringConstructor, "click" | "hover", unknown>;
         readonly collapseTransition: import('element-plus/es/utils/index.mjs').EpPropMergeType<BooleanConstructor, unknown, unknown>;
         readonly popperOffset: number;
-        readonly ellipsisIcon: import('element-plus/es/utils/index.mjs').EpPropMergeType<(new (...args: any[]) => (string | Component) & {}) | (() => string | Component) | (((new (...args: any[]) => (string | Component) & {}) | (() => string | Component)) | null)[], unknown, unknown>;
+        readonly ellipsisIcon: import('element-plus/es/utils/index.mjs').EpPropMergeType<(new (...args: any[]) => (string | import('vue').Component) & {}) | (() => string | import('vue').Component) | (((new (...args: any[]) => (string | import('vue').Component) & {}) | (() => string | import('vue').Component)) | null)[], unknown, unknown>;
         readonly popperEffect: import('element-plus/es/utils/index.mjs').EpPropMergeType<(new (...args: any[]) => string) | (() => import('element-plus').PopperEffect) | (((new (...args: any[]) => string) | (() => import('element-plus').PopperEffect)) | null)[], unknown, unknown>;
         readonly uniqueOpened: boolean;
         readonly router: boolean;
@@ -71,7 +71,7 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {
         C: {};
         M: {};
         Defaults: {};
-    }, Readonly<globalThis.ExtractPropTypes<{
+    }, Readonly<import('vue').ExtractPropTypes<{
         readonly mode: import('element-plus/es/utils/index.mjs').EpPropFinalized<StringConstructor, "horizontal" | "vertical", unknown, "vertical", boolean>;
         readonly defaultActive: import('element-plus/es/utils/index.mjs').EpPropFinalized<StringConstructor, unknown, unknown, "", boolean>;
         readonly defaultOpeneds: import('element-plus/es/utils/index.mjs').EpPropFinalized<(new (...args: any[]) => string[]) | (() => string[]) | (((new (...args: any[]) => string[]) | (() => string[])) | null)[], unknown, unknown, () => [], boolean>;
@@ -86,11 +86,11 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {
         readonly collapseTransition: import('element-plus/es/utils/index.mjs').EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
         readonly ellipsis: import('element-plus/es/utils/index.mjs').EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
         readonly popperOffset: import('element-plus/es/utils/index.mjs').EpPropFinalized<NumberConstructor, unknown, unknown, 6, boolean>;
-        readonly ellipsisIcon: import('element-plus/es/utils/index.mjs').EpPropFinalized<(new (...args: any[]) => (string | Component) & {}) | (() => string | Component) | (((new (...args: any[]) => (string | Component) & {}) | (() => string | Component)) | null)[], unknown, unknown, () => import('vue').DefineComponent<{}, void, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>, boolean>;
+        readonly ellipsisIcon: import('element-plus/es/utils/index.mjs').EpPropFinalized<(new (...args: any[]) => (string | import('vue').Component) & {}) | (() => string | import('vue').Component) | (((new (...args: any[]) => (string | import('vue').Component) & {}) | (() => string | import('vue').Component)) | null)[], unknown, unknown, () => import('vue').DefineComponent<{}, void, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>, boolean>;
         readonly popperEffect: import('element-plus/es/utils/index.mjs').EpPropFinalized<(new (...args: any[]) => string) | (() => import('element-plus').PopperEffect) | (((new (...args: any[]) => string) | (() => import('element-plus').PopperEffect)) | null)[], unknown, unknown, "dark", boolean>;
         readonly popperClass: StringConstructor;
         readonly popperStyle: {
-            readonly type: globalThis.PropType<import('element-plus/es/utils/index.mjs').EpPropMergeType<(new (...args: any[]) => string | import('vue').CSSProperties) | (() => string | import('vue').CSSProperties) | (((new (...args: any[]) => string | import('vue').CSSProperties) | (() => string | import('vue').CSSProperties)) | null)[], unknown, unknown>>;
+            readonly type: import('vue').PropType<import('element-plus/es/utils/index.mjs').EpPropMergeType<(new (...args: any[]) => string | import('vue').CSSProperties) | (() => string | import('vue').CSSProperties) | (((new (...args: any[]) => string | import('vue').CSSProperties) | (() => string | import('vue').CSSProperties)) | null)[], unknown, unknown>>;
             readonly required: false;
             readonly validator: ((val: unknown) => boolean) | undefined;
             __epPropKey: true;
@@ -102,7 +102,7 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {
         onClose?: ((index: string, indexPath: string[]) => any) | undefined;
         onSelect?: ((index: string, indexPath: string[], item: import('element-plus').MenuItemClicked, routerResult?: Promise<void | import('vue-router').NavigationFailure> | undefined) => any) | undefined;
         onOpen?: ((index: string, indexPath: string[]) => any) | undefined;
-    }>, () => VNode<import('vue').RendererNode, import('vue').RendererElement, {
+    }>, () => import('vue').VNode<import('vue').RendererNode, import('vue').RendererElement, {
         [key: string]: any;
     }>, {}, {}, {}, {
         readonly collapse: boolean;
@@ -116,7 +116,7 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {
         readonly menuTrigger: import('element-plus/es/utils/index.mjs').EpPropMergeType<StringConstructor, "click" | "hover", unknown>;
         readonly collapseTransition: import('element-plus/es/utils/index.mjs').EpPropMergeType<BooleanConstructor, unknown, unknown>;
         readonly popperOffset: number;
-        readonly ellipsisIcon: import('element-plus/es/utils/index.mjs').EpPropMergeType<(new (...args: any[]) => (string | Component) & {}) | (() => string | Component) | (((new (...args: any[]) => (string | Component) & {}) | (() => string | Component)) | null)[], unknown, unknown>;
+        readonly ellipsisIcon: import('element-plus/es/utils/index.mjs').EpPropMergeType<(new (...args: any[]) => (string | import('vue').Component) & {}) | (() => string | import('vue').Component) | (((new (...args: any[]) => (string | import('vue').Component) & {}) | (() => string | import('vue').Component)) | null)[], unknown, unknown>;
         readonly popperEffect: import('element-plus/es/utils/index.mjs').EpPropMergeType<(new (...args: any[]) => string) | (() => import('element-plus').PopperEffect) | (((new (...args: any[]) => string) | (() => import('element-plus').PopperEffect)) | null)[], unknown, unknown>;
         readonly uniqueOpened: boolean;
         readonly router: boolean;

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

@@ -13,7 +13,7 @@ declare function __VLS_template(): {
 };
 type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
 declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {
-    items: Ref<import('./modal-shelf-types').ShelfItem[]>;
+    items: import('vue').Ref<import('./modal-shelf-types').ShelfItem[]>;
     level: ModalLevel;
     evoke: (nsKey: string, component: Component | (() => Promise<Component>), options: {
         payload: Record<string, unknown>;

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

@@ -0,0 +1,35 @@
+import { ColProps } from 'element-plus';
+import { FormItemConfigList } from '../form';
+type __VLS_Props = {
+    /** 子 FormMain 数据（= 父 item 草稿的嵌套对象，子 in-place 改草稿） */
+    data: Record<string, any>;
+    /** 子表单配置列表 */
+    list: FormItemConfigList;
+    layout?: Partial<ColProps>;
+    rowGutter?: number;
+    submitText?: string;
+    cancelText?: string;
+    /** 校验通过后的业务提交（helper 内 wire submitFn(草稿) → closeEdit）；返回 Promise 自动 loading */
+    submit?: () => Promise<unknown> | unknown;
+    /** 取消编辑（helper 内 wire closeEdit） */
+    cancel?: () => void;
+    /** 父 item 代表 span（P3 rebase 算因子用；helper 经 resolveLayoutSpan(layout) 传入） */
+    parentSpan?: number;
+    /** 是否叠本层嵌套布局 rebase（缺省 true；false = 逆向逃生口，layout 原样直透） */
+    rebase?: boolean;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    submitText: string;
+    cancelText: string;
+    rebase: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
+    childRef: {
+        validate: () => Promise<void>;
+        resetFields: () => void;
+        clearValidate: (key?: string) => void;
+        generate: () => Record<string, any>;
+        parse: (stringifyData: import('../form').ExcludeNeverProperties<import('../form').ExtractFormStringifyRawFromObject<Record<string, any>, Record<string, any>>>) => Record<string, any>;
+        stringify: () => import('../form').ExcludeNeverProperties<import('../form').ExtractFormStringifyRawFromObject<Record<string, any>, Record<string, any>>>;
+    } | null;
+}, any>;
+export default _default;

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

@@ -0,0 +1,22 @@
+import { PanelItemConfigList } from './types';
+import { ColProps, CardProps } from 'element-plus';
+type __VLS_Props = {
+    /** 子 PanelMain 数据（= 父 item value，嵌套对象） */
+    data: Record<string, any>;
+    /** 子 PanelMain 配置列表 */
+    list: PanelItemConfigList;
+    /** 子项是否包 Card，缺省继承 PanelMain 默认 */
+    itemCard?: boolean | Partial<CardProps & {
+        lastMarginBottom?: string;
+    }>;
+    layout?: Partial<ColProps>;
+    rowGutter?: number;
+    /** 父 item 代表 span（P3 rebase 算因子用；helper 经 resolveLayoutSpan(layout) 传入） */
+    parentSpan?: number;
+    /** 是否叠本层嵌套布局 rebase（缺省 true；false = 逆向逃生口，layout 原样直透） */
+    rebase?: boolean;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    rebase: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+export default _default;

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

@@ -1,5 +1,9 @@
 import { default as PanelMain } from './PanelMain.vue';
 import { default as PanelItem } from './PanelItem.vue';
 import { default as PanelEditSwitch } from './PanelEditSwitch.vue';
+import { default as PanelItemNestPanel } from './PanelItemNestPanel.vue';
+import { default as PanelItemNestForm } from './PanelItemNestForm.vue';
 export * from './types';
-export { PanelMain, PanelItem, PanelEditSwitch };
+export * from './nest-panel-item';
+export * from './nest-panel-form';
+export { PanelMain, PanelItem, PanelEditSwitch, PanelItemNestPanel, PanelItemNestForm, };

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;
@@ -29,7 +29,7 @@ declare const _default: <T extends Record<string, any>, SQ extends Record<string
         exposeInfo: TableMainInstance;
     }) => any>> & {
         'custom-view-item'?(_: {
-            fieldComponentMap: Record<string, Component>;
+            fieldComponentMap: Record<string, import('vue').Component>;
             row: T;
             index: number;
             selected: boolean;

package/types/hooks/activated.d.ts

@@ -5,8 +5,8 @@ export interface ActivatedInfo {
 }
 /** 是否激活 */
 export declare const useActivated: (watchFn?: (info: ActivatedInfo) => void) => {
-    isActivated: globalThis.ComputedRef<boolean>;
-    activatedInfo: globalThis.ComputedRef<{
+    isActivated: import('vue').ComputedRef<boolean>;
+    activatedInfo: import('vue').ComputedRef<{
         readonly isActivated: boolean;
         readonly triggerType: "mounted" | "activated" | "deactivated" | "unmounted";
     }>;

package/types/hooks/feel-size.d.ts

@@ -3,7 +3,7 @@ export declare const useFeelSize: () => {
     unwatchDom: () => void;
     watchDom: (dom: HTMLElement) => void;
     /** 元素尺寸信息只读属性 */
-    sizeInfo: globalThis.ComputedRef<{
+    sizeInfo: import('vue').ComputedRef<{
         width: number;
         height: number;
     } | undefined>;

package/types/hooks/index.d.ts

@@ -4,3 +4,5 @@ export * from './feel-size';
 export * from './menus-dispatch';
 export * from './timeout';
 export * from './use-channel-viewport-height';
+export * from './use-admin-theme-apply';
+export * from './use-admin-viewport-apply';

package/types/hooks/menus-dispatch.d.ts

@@ -8,8 +8,8 @@ export declare const useMenusDataDispatch: ({ getMenus, getMenuFlatList, getExtr
     /** 判断是否提取1级路由模块到HEADER */
     getExtractLevel1ToHeader: () => boolean;
 }) => {
-    sidebarMenus: globalThis.ComputedRef<RouteMetaResolveRaw[]>;
-    headerMenus: globalThis.ComputedRef<{
+    sidebarMenus: import('vue').ComputedRef<RouteMetaResolveRaw[]>;
+    headerMenus: import('vue').ComputedRef<{
         children: never[];
         path: string;
         title: string;
@@ -26,7 +26,7 @@ export declare const useMenusDataDispatch: ({ getMenus, getMenuFlatList, getExtr
         permissionEditShow: boolean;
         needLogin: boolean;
     }[]>;
-    activeMenu: globalThis.ComputedRef<RouteMetaResolveRaw | undefined>;
-    activeModuleMenu: globalThis.ComputedRef<RouteMetaResolveRaw | undefined>;
-    needRedirectToFirstChildMenu: globalThis.ComputedRef<RouteMetaResolveRaw | undefined>;
+    activeMenu: import('vue').ComputedRef<RouteMetaResolveRaw | undefined>;
+    activeModuleMenu: import('vue').ComputedRef<RouteMetaResolveRaw | undefined>;
+    needRedirectToFirstChildMenu: import('vue').ComputedRef<RouteMetaResolveRaw | undefined>;
 };

package/types/hooks/use-admin-theme-apply.d.ts

@@ -0,0 +1,17 @@
+import { DeepReadonly } from 'vue';
+import { AppThemeConfig } from '../bridge';
+/** `useAdminThemeApply` 入参。 */
+export interface UseAdminThemeApplyOptions {
+    /** 当前风格 config 响应式获取器（= `bridge.APP_THEME_CONFIG`，含 light/dark） */
+    getThemeConfig: () => AppThemeConfig | DeepReadonly<AppThemeConfig>;
+    /** 是否暗色响应式获取器（= `bridge.themeIsDark.value`） */
+    getThemeIsDark: () => boolean;
+    /** 注入 document（测试 / SSR）；缺省 `globalThis.document`，不存在时静默跳过 */
+    document?: Document;
+}
+/**
+ * 启动 core 主题挂值——watch 风格 config 重写 `<style>`、watch 暗色 toggle `<html>.dark`。
+ *
+ * 在组件 setup（`AppLayout`）内调用以随组件作用域自动停 watch。返回 void。
+ */
+export declare function useAdminThemeApply(options: UseAdminThemeApplyOptions): void;

package/types/hooks/use-admin-viewport-apply.d.ts

@@ -0,0 +1,15 @@
+import { DeepReadonly } from 'vue';
+import { AppLayoutViewportConfig } from '../bridge';
+/** `useAdminViewportApply` 入参。 */
+export interface UseAdminViewportApplyOptions {
+    /** viewport 边框配置响应式获取器（= `bridge.APP_LAYOUT_VIEWPORT_CONFIG`） */
+    getViewportConfig: () => AppLayoutViewportConfig | DeepReadonly<AppLayoutViewportConfig>;
+    /** 注入 document（测试 / SSR）；缺省 `globalThis.document`，不存在时静默跳过 */
+    document?: Document;
+}
+/**
+ * 启动 viewport CSS var 挂值——watch viewport config 重写 `<style>`。
+ *
+ * 在组件 setup（`AppLayout`）内调用以随组件作用域自动停 watch。返回 void。
+ */
+export declare function useAdminViewportApply(options: UseAdminViewportApplyOptions): void;

package/types/hooks/use-breakpoint.d.ts

@@ -1,4 +1,4 @@
 export type Breakpoint = "xs" | "sm" | "md" | "lg" | "xl";
 export declare const useBreakpoint: () => {
-    activeBreakpoint: Readonly<globalThis.Ref<Breakpoint, Breakpoint>>;
+    activeBreakpoint: Readonly<import('vue').Ref<Breakpoint, Breakpoint>>;
 };

package/types/inject/key.d.ts

@@ -1,6 +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 视口高度
  * ---
@@ -52,3 +54,46 @@ export declare const APP_LAYOUT_USER_STORE_KEY: InjectionKey<AppLayoutUserStoreS
  * Symbol.for 保证跨包同一性（同 APP_LAYOUT_APP_STORE_KEY / APP_LAYOUT_USER_STORE_KEY）。
  */
 export declare const APP_LAYOUT_BRIDGE_KEY: InjectionKey<AppLayoutBridgeSlice>;
+/**
+ * 整 admin bridge app 级注入 key（#插件系统一期挂载）。
+ * ---
+ * `bridge.install(app)`（即 `app.use(bridge)`）经 `app.provide(ADMIN_BRIDGE_KEY, bridge)`
+ * 把**整个 bridge 实例**注入应用级 provide 链；任意后代组件经 `inject(ADMIN_BRIDGE_KEY)`
+ * 取整 bridge（含 7 响应式只读配置视图 + `update` + 全部 auth/api/派生方法）。
+ * ---
+ * **opt-in**：仅当 app 显式 `app.use(bridge)` 时注入；未 use 则 `inject(ADMIN_BRIDGE_KEY)`
+ * 返回 `undefined`（不报错）。
+ * ---
+ * **区别于 `APP_LAYOUT_BRIDGE_KEY`**：后者是 AppLayout 族**组件级**窄切片（`AppLayoutBridgeSlice`
+ * Pick 子集，由 AppLayout 从 `props.adminBridge` 接收后 provide，供 layout 子组件 inject），
+ * 两 KEY 各管各、并存——本 KEY 注入的是 app 级**整 bridge**，非 layout 窄切片。
+ * ---
+ * 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>>>;