@done-coding/admin-core 0.21.0 → 0.22.0

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

@@ -1,8 +1,11 @@
 import { Component } from 'vue';
-import { ModalLevel } from './modal-shelf-types';
+import { GlobalModalRemote, ModalLevel } from './modal-shelf-types';
 type __VLS_Props = {
     level: ModalLevel;
 };
+type __VLS_PublicProps = {
+    "remote"?: GlobalModalRemote;
+} & __VLS_Props;
 declare function __VLS_template(): {
     attrs: Partial<{}>;
     slots: {
@@ -12,7 +15,7 @@ declare function __VLS_template(): {
     rootEl: any;
 };
 type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
-declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {
+declare const __VLS_component: import('vue').DefineComponent<__VLS_PublicProps, {
     items: import('vue').Ref<import('./modal-shelf-types').ShelfItem[]>;
     level: ModalLevel;
     evoke: (nsKey: string, component: Component | (() => Promise<Component>), options: {
@@ -21,7 +24,13 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {
     }) => 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<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+    registerConfig: (entries: import('./modal-shelf-types').ShelfConfigEntry[]) => void;
+    unregisterConfig: (keys: string[]) => void;
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "update:remote": (value: GlobalModalRemote) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    "onUpdate:remote"?: ((value: GlobalModalRemote) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
 export default _default;
 type __VLS_WithTemplateSlots<T, S> = T & {

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

@@ -0,0 +1,40 @@
+/**
+ * ModalVideoPreview —— 视频预览弹窗·lightbox 形态（ElDialog 直配黑底 + 原生
+ * <video controls>）。封面兜底：coverUrl 传则作 poster；不传则 src 自动追加
+ * `#t=0.01`（Media Fragments 首帧渲染）配合 preload="metadata" 只拉元数据不拉全片。
+ * 注册形态（ModalShelf/Porter）：payload/closeFn/removeFn 显式声明（不泄漏进
+ * $attrs 落 video DOM），业务值双输入源：`url`/`coverUrl` = props ?? payload。
+ * 详见 docs/README-ModalVideoPreview.md。
+ */
+type __VLS_Props = {
+    /** 视频地址（<video src>）；注册形态下可改经 payload.url 承载 */
+    url: string;
+    /** 封面图地址（<video poster>）；空 → src 追加 #t=0.01 + preload="metadata" 首帧兜底 */
+    coverUrl?: string;
+    /** 打开即自动播放（业界 lightbox 行为，默认开）；关闭即暂停（固定行为） */
+    autoPlay?: boolean;
+    /** 注册形态注入（ModalShelf/Porter 渲染只传 payload；原语用法无需传） */
+    payload?: {
+        url?: string;
+        coverUrl?: string;
+    };
+    /** 注册形态注入的关闭出口（本组件不消费，仅声明避免泄漏进 $attrs） */
+    closeFn?: () => void;
+    /** 注册形态注入的移除出口（同上） */
+    removeFn?: () => void;
+    /** 关闭回调（ElDialog @close 触发） */
+    onClose?: (status?: boolean) => void;
+};
+type __VLS_PublicProps = {
+    "show": boolean;
+} & __VLS_Props;
+declare const _default: import('vue').DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "update:show": (value: boolean) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    "onUpdate:show"?: ((value: boolean) => any) | undefined;
+}>, {
+    autoPlay: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
+    videoEl: HTMLVideoElement;
+}, any>;
+export default _default;

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

@@ -0,0 +1,43 @@
+/**
+ * VideoPreviewTrigger —— 视频预览触发原语（默认插槽 = 封面/占位 + 播放图标，
+ * 吐 `open` 供自定义内容复用；核心唤起逻辑内置）。与 ImagePreviewTrigger 对等成对
+ * （视频无 el 原生预览，弹窗是唯一路径——决策链保留；图片触发端点击直达原生预览，
+ * 无决策链）。无封面零请求是硬行为（占位方案零请求零副作用，不预加载不拉 metadata）；
+ * $attrs 只落封面层（coverUrl 路径）——弹窗端视频属性（autoplay/muted 等）
+ * 在 ModalVideoPreview 上配，[MUST NOT] 经本组件透传。
+ * 详见 docs/README-VideoPreviewTrigger.md。
+ */
+type __VLS_Props = {
+    /** 视频地址（点击唤起预览弹窗的视频） */
+    url: string;
+    /** 封面图地址；空 → 深色占位 + 播放图标（零请求）；有 → ElImage 封面（原生懒加载）+ 图标叠加 */
+    coverUrl?: string;
+    /** 封面图懒加载（仅 coverUrl 有值时生效） */
+    lazy?: boolean;
+    /** 是否可点击唤起预览（false = 纯展示封面/占位） */
+    preview?: boolean;
+};
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        default?(_: {
+            open: () => void;
+        }): any;
+        placeholder?(_: {}): any;
+        error?(_: {}): any;
+    };
+    refs: {};
+    rootEl: any;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    lazy: boolean;
+    preview: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

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

@@ -3,9 +3,14 @@ import { default as ModalForm } from './ModalForm.vue';
 import { default as ModalDetail } from './ModalDetail.vue';
 import { default as ModalShelf } from './ModalShelf.vue';
 import { default as ModalPorter } from './ModalPorter.vue';
+import { default as ModalImagePreview } from './ModalImagePreview.vue';
+import { default as ModalVideoPreview } from './ModalVideoPreview.vue';
+import { default as ImagePreviewTrigger } from './ImagePreviewTrigger.vue';
+import { default as VideoPreviewTrigger } from './VideoPreviewTrigger.vue';
 export * from './types';
 export * from './modal-shelf-types';
-export { ModalConfirm, ModalForm, ModalDetail, ModalShelf, ModalPorter, 
+export * from './modal-global-keys';
+export { ModalConfirm, ModalForm, ModalDetail, ModalShelf, ModalPorter, ModalImagePreview, ModalVideoPreview, ImagePreviewTrigger, VideoPreviewTrigger, 
 /** @deprecated 改用 `ModalConfirm`（modal 族统一前缀） */
 ModalConfirm as ConfirmModal, 
 /** @deprecated 改用 `ModalForm`（modal 族统一前缀） */

package/types/components/modal/modal-global-keys.d.ts

@@ -0,0 +1,25 @@
+import { InjectionKey, Ref } from 'vue';
+import { GlobalModalRemote } from './modal-shelf-types';
+/**
+ * 全局图片预览弹窗预置 key（core 预置，见 README-ModalImagePreview / README-AppLayout）。
+ * ---
+ * 三重身份：remote 遥控器对象上的键（`remote[APP_GLOBAL_IMAGE_PREVIEW_KEY]`）、
+ * `modalKey` 清单条目（触发端 `modalKey.includes()` 显式判断）、`ModalShelfMap`
+ * 计算属性名（evoke payload 全链类型化）。
+ * AppLayout `enableGlobalImagePreview` 开启后以 `ModalImagePreview` 按此 key 注册；
+ * 触发端 `ImagePreviewTrigger` 经遥控器按此 key 唤起。
+ */
+export declare const APP_GLOBAL_IMAGE_PREVIEW_KEY: "appGlobalImagePreview";
+/** 全局视频预览弹窗预置 key（同上；AppLayout `enableGlobalVideoPreview` 注册） */
+export declare const APP_GLOBAL_VIDEO_PREVIEW_KEY: "appGlobalVideoPreview";
+/**
+ * 全局弹窗遥控器注入 key（core 导出，见 README-AppLayout「全局弹窗遥控器」）。
+ * ---
+ * App 根（App.vue）把持有同一 `globalModalRemote` 对象经本 key provide（与既有
+ * 业务侧 key 并存——core 不 provide、消费方自持自传）；触发组件（ImagePreviewTrigger /
+ * VideoPreviewTrigger）inject 后按 `modalKey` 判断全局 key 是否已注册，命中即遥控唤起。
+ * ---
+ * 值 = 包名 + 键名（injectInfo.name），`Symbol.for` 全局注册表保证跨包 / 跨 chunk /
+ * 跨 ESM 实例唯一（同 `@/inject/key.ts` 各 key 构造，规则 8）。[MUST NOT] 焊 version。
+ */
+export declare const GLOBAL_MODAL_REMOTE_KEY: InjectionKey<Ref<GlobalModalRemote>>;

package/types/components/modal/modal-global-symbol.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 全局弹窗专用 Porter 标识（core 内部私有，[MUST NOT] 经 modal/index.ts 导出）。
+ *
+ * 只有持有本 Symbol 的调用方（= AppLayout 内部专用 ModalPorter）才能启用
+ * `globalOnly` 模式推送 app 级弹窗配置——外部拿不到 Symbol 即无法伪造专用模式。
+ * AppLayout 经相对路径 import（内部私有符号不走桶出口，规则 7 粒度约束针对对外面）。
+ */
+export declare const APP_GLOBAL_MODAL_PORTER_SYMBOL: unique symbol;

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

@@ -1,9 +1,17 @@
 import { Ref } from 'vue';
-import { ModalLevel, ShelfController, ShelfItem } from './modal-shelf-types';
+import { GlobalModalRemote, ModalLevel, ShelfController, ShelfItem } from './modal-shelf-types';
 /** ShelfController 内部扩展：额外暴露渲染用活跃实例列表 */
 export interface ShelfControllerInternal extends ShelfController {
     /** 渲染用：当前活跃实例列表（多例数组） */
     items: Ref<ShelfItem[]>;
 }
-/** 创建一个架子逻辑控制器（纯逻辑，无 DOM 依赖，可单测） */
-export declare function createShelfController(level: ModalLevel): ShelfControllerInternal;
+/**
+ * 创建一个架子逻辑控制器（纯逻辑，无 DOM 依赖，可单测）。
+ *
+ * `remoteRef` 可选——仅 app 级架子传入（v-model:remote 的 model ref）：收到
+ * `registerConfig` 推送的全局弹窗配置后，把 key → {evoke, close, update} 句柄
+ * 挂进遥控器对象（整体替换 model 值触发响应式 + 链式 v-model 传播）；配置移除
+ * （`unregisterConfig`）时同步移除对应 key + 清掉该 key 活跃实例。page/custom
+ * 架子不传 remoteRef——registerConfig 只存配置不挂遥控器。
+ */
+export declare function createShelfController(level: ModalLevel, remoteRef?: Ref<GlobalModalRemote>): ShelfControllerInternal;

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

@@ -1,4 +1,5 @@
 import { Component } from 'vue';
+import { APP_GLOBAL_IMAGE_PREVIEW_KEY, APP_GLOBAL_VIDEO_PREVIEW_KEY } from './modal-global-keys';
 /** 架子层级 */
 export type ModalLevel = "app" | "page" | "custom";
 /** 同 key 再 evoke 策略：recreate=关旧重建(默认)；update=已开则整体替换 props 不 remount */
@@ -8,8 +9,18 @@ export type ModalSameKeyStrategy = "recreate" | "update";
  * 例：declare module "@done-coding/admin-core" {
  *   interface ModalShelfMap { detail: { id: string; onConfirm?: (r: unknown) => void } }
  * }
+ *
+ * core 预置全局预览弹窗 key 常量（APP_GLOBAL_*_PREVIEW_KEY，as const 计算属性名）
+ * 直接内建——触发端经遥控器 evoke 的 payload 全链类型化（src/url/coverUrl）。
  */
 export interface ModalShelfMap {
+    [APP_GLOBAL_IMAGE_PREVIEW_KEY]: {
+        src: string;
+    };
+    [APP_GLOBAL_VIDEO_PREVIEW_KEY]: {
+        url: string;
+        coverUrl?: string;
+    };
 }
 /** 架子注入给弹窗组件的契约（业务 payload 经单 payload 对象传入） */
 export interface ModalInjectedProps<P = Record<string, unknown>> {
@@ -68,6 +79,45 @@ export interface ShelfController {
     remove: (nsKey: string | string[]) => void;
     /** 优雅关闭某条（触发隐藏 → 动画结束 → 移除） */
     close: (item: ShelfItem) => void;
+    /** 配置注册面（全局遥控器链路专用：专用 ModalPorter 推送 app 级弹窗配置） */
+    registerConfig: (entries: ShelfConfigEntry[]) => void;
+    /** 配置移除（同步清理遥控器对应 key + 该 key 活跃实例） */
+    unregisterConfig: (keys: string[]) => void;
 }
 /** ModalShelf 实例引用类型别名（用于 RegisterEntry.shelf 直接持实例定位 custom 架子） */
 export type ShelfInstance = ShelfController;
+/**
+ * 单个全局弹窗的遥控控制面（remote[key]）。
+ *
+ * - `evoke`：唤起（不带 key——key 即 remote 对象上的键；重复 evoke 行为由配置期
+ *   `sameKeyStrategy` 决定：recreate 关旧重建 / update 整体替换 props 不 remount）
+ * - `close`：关闭当前实例（**关键能力**：全局弹窗不能只靠用户点击关闭——可能无
+ *   关闭按钮 / 需外部编排，应用根经此按 key 遥控关闭）
+ * - `update`：受控增量合并 payload（不 remount）
+ */
+export interface GlobalModalControl {
+    evoke: (payload?: Record<string, unknown>) => void;
+    close: () => void;
+    update: (payload: Record<string, unknown>) => void;
+}
+/**
+ * 全局弹窗遥控器对象（AppLayout `v-model:globalModalRemote` / 架子 `v-model:remote`）。
+ * ---
+ * 按业务 key 寻址句柄三件套（evoke / close / update）；**`modalKey` = 已注册全局弹窗
+ * key 清单**（架子 `registerConfig` / `unregisterConfig` 同步维护，与句柄同生命周期）——
+ * 触发端等调用方以 `modalKey.includes(key)` 显式判断「该 key 是否已注册」，
+ * `evoke` 无返回值，未注册直接调会 TypeError。
+ */
+export type GlobalModalRemote = Record<string, GlobalModalControl> & {
+    /** 已注册全局弹窗 key 清单（架子 registerConfig/unregisterConfig 同步维护） */
+    modalKey: string[];
+};
+/** 架子内部配置注册面（专用 ModalPorter 推送 app 级弹窗配置；全局遥控器挂载源） */
+export interface ShelfConfigEntry {
+    /** 业务弹窗 key（remote 对象键） */
+    key: string;
+    /** 组件或懒工厂 */
+    component: Component | (() => Promise<Component>);
+    /** 同 key 再 evoke 策略，缺省 "recreate" */
+    sameKeyStrategy?: ModalSameKeyStrategy;
+}

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

@@ -0,0 +1,11 @@
+type __VLS_Props = {
+    /** 加载中（优先展示「加载中...」） */
+    loading?: boolean;
+    /** api 是否至少被调用过一次（false = 欢迎触发查询；true = 暂无数据） */
+    hasRequested?: boolean;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    loading: boolean;
+    hasRequested: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+export default _default;

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

@@ -193,6 +193,12 @@ SQ extends Record<string, any>,
 F extends Record<string, any>> {
     /** 展示分页器 */
     showPager?: boolean;
+    /**
+     * 挂载后是否立即触发初始化查询（默认 true 查）。
+     * - false：挂载不自动拉数——空态「欢迎触发查询」（hasRequested 自判）、
+     *   KeepAlive 激活不自动刷新，用户手动查询后恢复。
+     */
+    initialSearch?: boolean;
     /** 是否显示切换视图按钮，默认 false */
     showSwitchView?: boolean;
     /** 是否显示 toolbar（顶层开关，默认 true，优先级高于 toolbar.leftFeatures / rightFeatures） */
@@ -205,6 +211,11 @@ F extends Record<string, any>> {
     pageSizeInit?: number;
     pageSizeOptions?: number[];
     pageLayout?: string;
+    /**
+     * 分页器页码是否带背景框（透传 ElPagination `background`，默认 true = 现形态）。
+     * false = EP 默认无框纯数字链接形态（最简；窄栏 / 精简场景用）。
+     */
+    paginationBackground?: boolean;
     rowKey: Extract<keyof T, string> | ((row: T) => string);
     /** 请求api */
     api: (params: TableApiParams<SQ>) => Promise<TableApiResult<T>>;

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

@@ -19,7 +19,7 @@ export interface ViewLayoutProps<P = Record<string, any>, R = any> {
     api: (params?: P) => Promise<R>;
     /** 拉取参数；响应式变化不自动重拉（需要时调 scope.refresh()） */
     params?: P;
-    /** 精细流：默认 true——包 HeightProvider 精确扣 toolbar reserve，内容区可用高（slot scope viewportHeight + 容器 max-height）；false=自然流（无高度预算，内容按自身尺寸） */
+    /** 精细流：默认 false（自然流：无高度预算，内容按自身尺寸）；true=包 HeightProvider 精确扣 toolbar reserve，内容区可用高（slot scope viewportHeight + 容器 max-height） */
     refine?: boolean;
     /** 显式视口高，优先级最高；未传降级 inject SCOPE_VIEWPORT_MAX_HEIGHT scope 链 */
     viewportHeight?: number;

package/types/injectInfo.json.d.ts

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

package/types/store/app.d.ts

@@ -136,7 +136,7 @@ export declare function createAppStore<UserInfo = unknown, LoginParams = unknown
     changeAsideCollapseStatus: (status: boolean) => void;
     changeSidebarHasMenusStatus: (status: boolean) => void;
     changeIsDarkTheme: (status: boolean) => void;
-}, "name" | "bodyStyle" | "theme" | "showHeader" | "keepAlive" | "bodyShimPadding" | "isDarkTheme" | "showFooter" | "showSidebar" | "showAside" | "showBreadcrumb" | "headerStyle" | "footerStyle" | "sidebarStyle" | "asideStyle" | "contentViewportInset" | "bodyShimStyle" | "viewportPadding" | "sidebarIsCollapse" | "asideIsCollapse">, Pick<{
+}, "name" | "theme" | "showHeader" | "keepAlive" | "bodyShimPadding" | "isDarkTheme" | "showFooter" | "showSidebar" | "showAside" | "showBreadcrumb" | "headerStyle" | "footerStyle" | "sidebarStyle" | "asideStyle" | "bodyStyle" | "contentViewportInset" | "bodyShimStyle" | "viewportPadding" | "sidebarIsCollapse" | "asideIsCollapse">, Pick<{
     name: import('vue').ComputedRef<string>;
     isDarkTheme: import('vue').ComputedRef<boolean>;
     theme: import('vue').ComputedRef<{