@done-coding/admin-core 0.1.4 → 0.2.1-alpha.0

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

@@ -0,0 +1,36 @@
+import { Component } from 'vue';
+import { ModalLevel } from './modal-shelf-types';
+
+declare function __VLS_template(): {
+    default?(_: {}): any;
+};
+declare const __VLS_component: import('vue').DefineComponent<globalThis.ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
+    level: ModalLevel;
+}>>, {
+    items: Ref<import('./modal-shelf-types').ShelfItem[]>;
+    level: ModalLevel;
+    evoke: (nsKey: string, component: Component | (() => Promise<Component>), options: {
+        payload: Record<string, unknown>;
+        sameKeyStrategy?: import('./modal-shelf-types').ModalSameKeyStrategy;
+    }) => import('./modal-shelf-types').EvokeHandle;
+    remove: (nsKey: string | string[]) => void;
+    close: (item: import('./modal-shelf-types').ShelfItem) => void;
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<globalThis.ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
+    level: ModalLevel;
+}>>> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, ReturnType<typeof __VLS_template>>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

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

@@ -1,7 +1,11 @@
 import { Plugin } from 'vue';
 import { default as ConfirmModal } from './ConfirmModal.vue';
 import { default as DetailModal } from './DetailModal.vue';
+import { default as ModalShelf } from './ModalShelf.vue';
+import { default as ModalPorter } from './ModalPorter.vue';
 
 export * from './types';
-export { ConfirmModal, DetailModal };
+export * from './modal-shelf-types';
+export { ConfirmModal, DetailModal, ModalShelf, ModalPorter };
+/** 弹窗子模块批量注册插件 */
 export declare const modalInstall: Plugin;

package/types/components/modal/modal-shelf-core.d.ts

@@ -0,0 +1,10 @@
+import { Ref } from 'vue';
+import { ModalLevel, ShelfController, ShelfItem } from './modal-shelf-types';
+
+/** ShelfController 内部扩展：额外暴露渲染用活跃实例列表 */
+export interface ShelfControllerInternal extends ShelfController {
+    /** 渲染用：当前活跃实例列表（多例数组） */
+    items: Ref<ShelfItem[]>;
+}
+/** 创建一个架子逻辑控制器（纯逻辑，无 DOM 依赖，可单测） */
+export declare function createShelfController(level: ModalLevel): ShelfControllerInternal;

package/types/components/modal/modal-shelf-hierarchy.d.ts

@@ -0,0 +1,7 @@
+import { ModalLevel } from './modal-shelf-types';
+
+/**
+ * 层级合法性：app 必最顶层；page 祖先仅允许 app；custom 可嵌套任何（含 custom 套 custom）。
+ * 非法仅开发期 console.error，不抛、不静默。
+ */
+export declare function assertLevelHierarchy(level: ModalLevel, ancestorLevels: ModalLevel[]): void;

package/types/components/modal/modal-shelf-types.d.ts

@@ -0,0 +1,74 @@
+import { Component } from 'vue';
+
+/** 架子层级 */
+export type ModalLevel = "app" | "page" | "custom";
+/** 同 key 再 evoke 策略：recreate=关旧重建(默认)；update=已开则整体替换 props 不 remount */
+export type ModalSameKeyStrategy = "recreate" | "update";
+/**
+ * 业务侧 declare merge 扩展此接口声明每个弹窗的业务 props 契约。
+ * 例：declare module "@done-coding/admin-core" {
+ *   interface ModalShelfMap { detail: { id: string; onConfirm?: (r: unknown) => void } }
+ * }
+ */
+export interface ModalShelfMap {
+}
+/** 架子注入给弹窗组件的契约（业务 payload 经单 payload 对象传入） */
+export interface ModalInjectedProps<P = Record<string, unknown>> {
+    /** v-model:show 受控可见性 */
+    show: boolean;
+    /** 优雅关闭（隐藏→等动画→移除），=== EvokeHandle.close */
+    closeFn: () => void;
+    /** 立即移除（无动画） */
+    removeFn: () => void;
+    /** 业务 payload（ModalShelfMap[key]） */
+    payload: P;
+}
+/** evoke 返回的命令式句柄；只绑稳定 nsKey，调用时现查当前实例（不闭包 id） */
+export interface EvokeHandle {
+    /** 优雅关闭该 nsKey 当前实例；无则 no-op */
+    close: () => void;
+    /** 对该 nsKey 当前实例受控增量合并 payload（不 remount）；无则 no-op */
+    update: (partialPayload: Record<string, unknown>) => void;
+}
+/** 注册项（扁平，无 options 包裹，无 isSingle——v1 仅多例） */
+export interface RegisterEntry<K extends keyof ModalShelfMap = keyof ModalShelfMap> {
+    /** 弹窗逻辑 key */
+    key: K;
+    /** 组件或懒工厂（() => import()） */
+    component: Component | (() => Promise<Component>);
+    /** 目标架子：app/page 名称代指，或直接持 ShelfInstance */
+    shelf: "app" | "page" | ShelfInstance;
+    /** 同 key 再 evoke 策略，缺省 "recreate" */
+    sameKeyStrategy?: ModalSameKeyStrategy;
+}
+/** 架子内部一条活跃实例 */
+export interface ShelfItem {
+    /** 架子内部自增唯一 id，用作渲染 :key */
+    id: number;
+    /** porter 命名空间后的注册键 p{porterUid}:{key} */
+    nsKey: string;
+    /** 组件或懒工厂 */
+    component: Component | (() => Promise<Component>);
+    /** 业务 payload */
+    payload: Record<string, unknown>;
+    /** v-model:show */
+    show: boolean;
+    /** close 排定的关闭动画定时器句柄；remove 立即移除前 [MUST] clearTimeout 它 */
+    timer?: ReturnType<typeof setTimeout>;
+}
+/** ModalShelf 实例 expose === 它 provide 的 controller */
+export interface ShelfController {
+    /** 本架子层级 */
+    level: ModalLevel;
+    /** 唤起一条；同 nsKey 先 remove(立即) 旧再新建 */
+    evoke: (nsKey: string, component: Component | (() => Promise<Component>), options: {
+        payload: Record<string, unknown>;
+        sameKeyStrategy?: ModalSameKeyStrategy;
+    }) => EvokeHandle;
+    /** 立即移除（不等动画），支持单个或批量 */
+    remove: (nsKey: string | string[]) => void;
+    /** 优雅关闭某条（触发隐藏 → 动画结束 → 移除） */
+    close: (item: ShelfItem) => void;
+}
+/** ModalShelf 实例引用类型别名（用于 RegisterEntry.shelf 直接持实例定位 custom 架子） */
+export type ShelfInstance = ShelfController;

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

@@ -0,0 +1,31 @@
+import { PanelEditSwitchProps } from './types';
+
+declare function __VLS_template(): {
+    default?(_: {}): any;
+    editor?(_: {
+        data: Record<string, any>;
+    }): any;
+};
+declare const __VLS_component: import('vue').DefineComponent<globalThis.ExtractPropTypes<__VLS_TypePropsToRuntimeProps<PanelEditSwitchProps<Record<string, any>>>>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "update:editing": (value: boolean) => void;
+    submitFinish: (success: boolean, data: Record<string, any>) => void;
+}, string, import('vue').PublicProps, Readonly<globalThis.ExtractPropTypes<__VLS_TypePropsToRuntimeProps<PanelEditSwitchProps<Record<string, any>>>>> & Readonly<{
+    "onUpdate:editing"?: ((value: boolean) => any) | undefined;
+    onSubmitFinish?: ((success: boolean, data: Record<string, any>) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, ReturnType<typeof __VLS_template>>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

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

@@ -0,0 +1,21 @@
+import { PanelItemProps } from './types';
+
+declare const _default: import('vue').DefineComponent<globalThis.ExtractPropTypes<__VLS_TypePropsToRuntimeProps<PanelItemProps<Record<string, any>>>>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "update:editing": (value: boolean) => void;
+    submitFinish: (success: boolean, data: Record<string, any>) => void;
+    refresh: () => void;
+}, string, import('vue').PublicProps, Readonly<globalThis.ExtractPropTypes<__VLS_TypePropsToRuntimeProps<PanelItemProps<Record<string, any>>>>> & Readonly<{
+    onRefresh?: (() => any) | undefined;
+    "onUpdate:editing"?: ((value: boolean) => any) | undefined;
+    onSubmitFinish?: ((success: boolean, data: Record<string, any>) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};

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

@@ -0,0 +1,17 @@
+import { PanelMainProps } from './types';
+
+declare const _default: <T extends Record<string, any>>(__VLS_props: Awaited<typeof __VLS_setup>["props"], __VLS_ctx?: __VLS_Prettify<Pick<Awaited<typeof __VLS_setup>, "attrs" | "emit" | "slots">>, __VLS_expose?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+    props: __VLS_Prettify<__VLS_OmitKeepDiscriminatedUnion<(Partial<{}> & Omit<{
+        readonly onRefresh?: ((data: T) => any) | undefined;
+    } & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps, never>) & PanelMainProps<T>, keyof import('vue').VNodeProps | keyof import('vue').AllowedComponentProps>> & {} & (import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps);
+    expose(exposed: import('vue').ShallowUnwrapRef<{}>): void;
+    attrs: any;
+    slots: ReturnType<() => {}>;
+    emit: (e: "refresh", data: T) => void;
+}>) => import('vue').VNode & {
+    __ctx?: Awaited<typeof __VLS_setup>;
+};
+export default _default;
+type __VLS_Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};

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

@@ -0,0 +1,9 @@
+import { Plugin } from 'vue';
+import { default as PanelMain } from './PanelMain.vue';
+import { default as PanelItem } from './PanelItem.vue';
+import { default as PanelEditSwitch } from './PanelEditSwitch.vue';
+
+export * from './types';
+export { PanelMain, PanelItem, PanelEditSwitch };
+/** Panel 组件族一键注册插件（app.use(panelInstall)） */
+export declare const panelInstall: Plugin;

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

@@ -0,0 +1,62 @@
+import { VNode } from 'vue';
+import { ColProps } from 'element-plus';
+
+/** Panel 只读渲染作用域（render 用） */
+export interface PanelScope<T extends Record<string, any> = Record<string, any>> {
+    /** 原始数据（只读消费，[MUST NOT] 在 render 内修改） */
+    data: T;
+    /** data[config.key] */
+    value: any;
+    config: PanelItemConfig<T>;
+    /** 请求 PanelMain 向父层触发 refresh（preview 组件绕开 PanelEditSwitch 刷新用） */
+    refresh?: () => void;
+}
+/** Panel 编辑器作用域（editorRender 用，data = 深克隆副本） */
+export interface PanelEditorScope<T extends Record<string, any> = Record<string, any>> {
+    /** PanelEditSwitch 内部深克隆副本（编辑器直接改它） */
+    data: T;
+    /** data[config.key]（克隆体上的值） */
+    value: any;
+    config: PanelItemConfig<T>;
+}
+/** Panel 配置项 */
+export interface PanelItemConfig<T extends Record<string, any> = Record<string, any>> {
+    /** 数据键 */
+    key: string;
+    /** 标签，非必填 */
+    label?: string;
+    /** 栅格布局，复用 resolveFormLayout 语义；缺省继承 PanelMain.layout */
+    layout?: Partial<ColProps>;
+    /** 顺序，缺省按数组序 */
+    order?: number;
+    /** 隐藏 */
+    hide?: boolean | ((scope: PanelScope<T>) => boolean);
+    /** 只读渲染；缺省=纯文本 data[key] */
+    render?: string | Record<string, any> | ((scope: PanelScope<T>) => VNode);
+    /** 是否可就地编辑 */
+    editable?: boolean | ((scope: PanelScope<T>) => boolean);
+    /** 编辑器渲染；仅 editable 时需要 */
+    editorRender?: string | Record<string, any> | ((scope: PanelEditorScope<T>) => VNode);
+    /** 单字段提交；仅 editable 时需要。draft = 深克隆副本 */
+    submitFn?: (draft: T) => Promise<unknown>;
+}
+/** Panel 配置项列表 */
+export type PanelItemConfigList<T extends Record<string, any> = Record<string, any>> = PanelItemConfig<T>[];
+/** PanelMain props */
+export interface PanelMainProps<T extends Record<string, any> = Record<string, any>> {
+    data: T;
+    layout?: Partial<ColProps>;
+    list: PanelItemConfigList<T>;
+}
+/** PanelItem props */
+export interface PanelItemProps<T extends Record<string, any> = Record<string, any>> {
+    data: T;
+    config: PanelItemConfig<T>;
+    editing: boolean;
+}
+/** PanelEditSwitch props */
+export interface PanelEditSwitchProps<T extends Record<string, any> = Record<string, any>> {
+    data: T;
+    editing: boolean;
+    submitFn?: (draft: T) => Promise<unknown>;
+}

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

@@ -2,14 +2,14 @@ import { ExportType, TableExportContext, TableMainInstance } from './types';
 
 declare const _default: import('vue').DefineComponent<globalThis.ExtractPropTypes<{
     isAutoRefresh: import('vue').PropType<boolean>;
-    pageSize: {
-        type: globalThis.PropType<number>;
-        required: true;
-    };
     loading: {
         type: globalThis.PropType<boolean>;
         required: true;
     };
+    pageSize: {
+        type: globalThis.PropType<number>;
+        required: true;
+    };
     showRefresh: {
         type: globalThis.PropType<boolean>;
         default: boolean;
@@ -52,14 +52,14 @@ declare const _default: import('vue').DefineComponent<globalThis.ExtractPropType
     };
 }>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<globalThis.ExtractPropTypes<{
     isAutoRefresh: import('vue').PropType<boolean>;
-    pageSize: {
-        type: globalThis.PropType<number>;
-        required: true;
-    };
     loading: {
         type: globalThis.PropType<boolean>;
         required: true;
     };
+    pageSize: {
+        type: globalThis.PropType<number>;
+        required: true;
+    };
     showRefresh: {
         type: globalThis.PropType<boolean>;
         default: boolean;

package/types/index.d.ts

@@ -6,6 +6,7 @@ import { miscInstall } from './components/misc';
 import { modalInstall } from './components/modal';
 import { tableInstall } from './components/table';
 import { listPageInstall } from './components/list-page';
+import { panelInstall } from './components/panel';
 
 export * from './components/form';
 export * from './components/menu';
@@ -14,6 +15,7 @@ export * from './components/misc';
 export * from './components/modal';
 export * from './components/table';
 export * from './components/list-page';
+export * from './components/panel';
 export * from './utils';
 export * from './hooks';
 export * from './types';
@@ -22,5 +24,5 @@ export * from './inject';
 export * from './helpers';
 export * from './bridge';
 export * from './store';
-export { formInstall, menuInstall, displayInstall, miscInstall, modalInstall, tableInstall, listPageInstall, };
+export { formInstall, menuInstall, displayInstall, miscInstall, modalInstall, tableInstall, listPageInstall, panelInstall, };
 export declare const installComponents: Plugin;

package/types/inject/key.d.ts

@@ -1,3 +1,6 @@
+import { InjectionKey } from 'vue';
+import { ModalLevel, ShelfController } from '../components/modal';
+
 /**
  * body 视口高度
  * ---
@@ -20,3 +23,8 @@ export declare const BODY_CONTENT_VIEWPORT_HEIGHT: unique symbol;
  * 导致 provide/inject 失配 → 预算链断裂）。
  */
 export declare const FULLSCREEN_HEIGHT_CHANNEL: unique symbol;
+/**
+ * 弹窗架子 inject key 工厂——按 level 参数化。
+ * Symbol.for 全局注册表保证跨包/跨 chunk/跨 ESM 实例唯一（同 BODY_CONTENT_VIEWPORT_HEIGHT）。
+ */
+export declare function getModalShelfInjectionKey(level: ModalLevel): InjectionKey<ShelfController>;