/** 附件字段里的 fileItem（见 components/Jnpf/upload/src/props.ts），此处只声明本功能用到的部分 */
export interface OfficeDocumentFile {
  fileExtension?: string;
  fileId: string;
  fileSize?: number | string;
  name: string;
  url?: string;
  [key: string]: any;
}

export interface OpenOfficeDocumentConfig {
  /** 附件对象，必填。fileId 定位文件、name 做标题并决定 documentType */
  file: OfficeDocumentFile;
  /** 业务归属记录 id */
  bizDataId?: string;
  /** 业务归属模块，用于后端权限判定与审计留痕 */
  bizModule?: string;
  /** ONLYOFFICE 插件业务场景；为空时后端强制只读 */
  bizScene?: string;
  /** 文件存储类型；DMS 预览固定为 dms，普通附件省略 */
  fileType?: string;
  /** DMS READ 裁决成功后签发的短期预览票据 */
  dmsAccessTicket?: string;
  /** 期望模式，默认 edit。最终以后端返回的 editorConfig.mode 为准 */
  mode?: 'edit' | 'view';
  onClose?: () => void;
  /**
   * 编辑期间文档有过改动、且弹窗已关闭时触发。
   *
   * ⚠️ 它**不**代表后端已经把新版文档写回附件：DS 是在所有人退出后才异步回调后端保存的，
   * 前端无从得知那一步何时完成。需要展示新的 fileSize 等元信息时，业务侧应在此回调里
   * 自行重拉附件（必要时延迟重试），不要假设回调触发的瞬间文件已经是新的。
   */
  onSave?: (result: { file: OfficeDocumentFile; modified: boolean }) => void;
  /** 弹窗标题，默认取 file.name */
  title?: string;
}

export interface NormalizedOfficeDocumentConfig extends OpenOfficeDocumentConfig {
  mode: 'edit' | 'view';
  title: string;
}