@mxmweb/xviewer 1.3.2 → 1.4.1

package/lib_enter.d.ts

@@ -23,6 +23,9 @@ declare type AppFn = {
     addSubTable: (parentId: string) => void;
     deleteSubTable: (parentId: string) => void;
     removeSubTableRow: (id: string, tableId: string) => void;
+    /** 主表 loading 控制（通用暴露，业务层网络请求可用） */
+    startTableLoading?: (timeoutMs?: number, minDurationMs?: number) => void;
+    finishTableLoading?: () => void;
 };
 
 declare interface AppStatusManager {
@@ -56,7 +59,7 @@ export declare interface CustomComponents {
     EmptyData?: default_2.ComponentType<any>;
 }
 
-declare type DataSource = TableDataItem[] | CardDataItem[] | FormDataItem[] | default_2.ReactElement | undefined;
+declare type DataSource = TableDataItem[] | CardDataItem[] | FormDataItem[] | ListItem[] | default_2.ReactElement | undefined;
 
 declare interface DynamicDashDataCoreRef {
     appFn: AppFn;
@@ -88,6 +91,60 @@ declare interface FormDataItem {
     [key: string]: any;
 }
 
+declare type HeaderItem = HeaderItemCustomized;
+
+declare type HeaderItemBase = {
+    key: string;
+    /** header 位置，默认 left；left/right 分别占据两侧容器 */
+    position?: 'left' | 'right';
+};
+
+declare type HeaderItemCustomized = HeaderItemBase & {
+    type: 'customized';
+    /**
+     * 自定义组件：
+     * - React 组件类型
+     * - JSX 元素
+     * - 字符串 key（通过 styles.customizeComponents 注册表解析）
+     */
+    component: default_2.ComponentType<any> | default_2.ReactElement | string;
+    /**
+     * 组件 props：
+     * - 对象：静态 props
+     * - 函数：根据上下文动态计算 props（如 viewId / appFn）
+     */
+    componentProps?: Record<string, any> | ((ctx: {
+        viewId: string;
+        appFn: AppFn;
+    }) => Record<string, any>);
+};
+
+declare interface ListItem {
+    id: string;
+    type: 'text' | 'image' | 'customized' | string;
+    content?: string;
+    title?: string;
+    description?: string;
+    imageUrl?: string;
+    imageAlt?: string;
+    actions?: Array<{
+        key: string;
+        label: string;
+        icon?: default_2.ReactNode;
+        disabled?: boolean;
+        [key: string]: any;
+    }>;
+    selectable?: boolean;
+    draggable?: boolean;
+    size?: 'sm' | 'md' | 'lg';
+    spacing?: 'tight' | 'normal' | 'loose';
+    className?: string;
+    style?: default_2.CSSProperties;
+    component?: default_2.ReactElement | default_2.ComponentType<any>;
+    componentProps?: Record<string, any>;
+    [key: string]: any;
+}
+
 declare interface TableDataItem {
     id: string;
     [key: string]: any;
@@ -107,6 +164,8 @@ declare type ToolbarItem = {
         onAction: (action: string, data: any) => void;
         [key: string]: any;
     }>;
+    /** customized 组件的额外 props（如 role 等）*/
+    componentProps?: Record<string, any>;
     searchKeys?: (string | string[])[];
     btnType?: 'primary' | 'default' | 'error' | 'text';
     disabled?: boolean;
@@ -123,7 +182,7 @@ declare interface ViewType {
     label: string;
     icon?: default_2.ReactNode;
     id: string;
-    type?: 'table' | 'form' | 'card' | 'customized' | 'timeline' | 'column' | string;
+    type?: 'table' | 'form' | 'card' | 'customized' | 'timeline' | 'column' | 'list' | string;
     columns?: Array<{
         title: string;
         id: string;
@@ -139,6 +198,15 @@ declare interface ViewType {
     formConfig?: any;
     formWidth?: string;
     toolbar?: ToolbarItem[];
+    /** 视图头部：渲染在 toolbar 下方、内容区域上方（仅 table/card/form 等叶子节点生效） */
+    header?: HeaderItem[];
+    /**
+     * 视图头部高度规格（用于高度计算，固定像素）：
+     * - 'sm'：小高度，一行紧凑面包屑
+     * - 'md'：默认高度
+     * - 'lg'：较高，可容纳两行内容
+     */
+    headerSize?: 'sm' | 'md' | 'lg';
     allowMultiSelect?: boolean;
     size?: 'sm' | 'md';
     total?: number;
@@ -148,6 +216,14 @@ declare interface ViewType {
     paginationLocale?: 'zh' | 'en' | 'ja';
     /** 分页文案覆盖（可选） */
     paginationMessages?: Record<string, string>;
+    /** 表格空数据提示文案（表头下展示，参考 antd Table） */
+    emptyText?: string;
+    /** 表格空数据提示组件（自定义 React 节点或组件，组件可接收 { description?: string }） */
+    emptyComponent?: default_2.ReactNode | default_2.ComponentType<{
+        description?: string;
+    }>;
+    listLayout?: 'vertical' | 'horizontal';
+    listItems?: ListItem[];
 }
 
 export declare const Xviwer: default_2.ForwardRefExoticComponent<Omit<DynamicDashView, "ref"> & default_2.RefAttributes<DynamicDashDataCoreRef>>;

package/package.json

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