@mxmweb/xviewer 1.4.10 → 1.4.11

package/lib_enter.d.ts

@@ -26,6 +26,22 @@ declare type AppFn = {
     /** 主表 loading 控制（通用暴露，业务层网络请求可用） */
     startTableLoading?: (timeoutMs?: number, minDurationMs?: number) => void;
     finishTableLoading?: () => void;
+    /**
+     * 主动拉取 XViewer 当前实例快照（建议用于“上层同步状态”）
+     *
+     * 设计目的：
+     * - 避免把 toolbar / pagination / viewer 的所有变化都作为事件向外广播（事件风暴）
+     * - 由业务层在需要时主动拉取当前状态，降低内存与渲染压力
+     *
+     * 返回内容覆盖：
+     * - toolbar：模糊搜索值、选中项等（核心层可直接拿到的状态）
+     * - pagination：最近一次 pagination 相关事件、loading 等（核心层汇总）
+     * - viewer：当前激活节点、视图模型、状态等
+     * - data：当前展示数据快照（已包含 fuzzy filter 的结果）
+     *
+     * 2026-03-30：新增，用于解决上层同步与事件风暴的矛盾。
+     */
+    getXviewerInstance?: () => XviewerInstanceSnapshot;
 };
 
 declare interface AppStatusManager {
@@ -83,6 +99,8 @@ declare type DynamicDashView = {
     styles?: Styles;
     status?: AppStatusManager;
     CustomComponents?: CustomComponents;
+    /** 内容区内边距覆盖（由 DynamicDashDataCore 消费，不转发到 DOM） */
+    contentPadding?: string;
     [key: string]: any;
 };
 
@@ -227,6 +245,38 @@ declare interface ViewType {
     listItems?: ListItem[];
 }
 
+export declare type XviewerInstanceSnapshot = {
+    ts: number;
+    activeId: string;
+    model: any;
+    activeNode: any | null;
+    status?: any;
+    toolbar: {
+        fuzzyValue: string;
+        selectedIds: string[];
+    };
+    pagination: {
+        /** 最近一次 pagination:* 事件（用于上层同步分页器状态/请求参数） */
+        lastEvent?: {
+            name: string;
+            data: any;
+        };
+        tableLoading?: boolean;
+    };
+    data: {
+        /** 当前内容区数据（已包含 fuzzy filter） */
+        currentData: any[];
+        /** 原始 innerData（不含 fuzzy filter） */
+        rawInnerData: any[];
+    };
+    config: {
+        label?: any;
+        views?: any;
+        defaultActiveId?: any;
+        styles?: any;
+    };
+};
+
 export declare const Xviwer: default_2.ForwardRefExoticComponent<Omit<DynamicDashView, "ref"> & default_2.RefAttributes<DynamicDashDataCoreRef>>;
 
 export { }

package/package.json

@@ -5,7 +5,7 @@
   "style": "assets/style.css",
   "types": "lib_enter.d.ts",
   "private": false,
-  "version": "1.4.10",
+  "version": "1.4.11",
   "author": "hanfeng_Zhang",
   "type": "module",
   "peerDependencies": {