@flyfish-group/file-viewer3 1.0.15 → 1.0.16

package/dist/src/package/common/type.d.ts

@@ -48,6 +48,13 @@ export interface FileViewerToolbarOptions {
     download?: boolean;
     print?: boolean;
     exportHtml?: boolean;
+    /**
+     * 内置操作按钮执行前的统一前置钩子。返回 `false` 时会取消本次操作。
+     */
+    beforeOperation?: FileViewerBeforeOperation;
+    beforeDownload?: FileViewerBeforeOperation;
+    beforePrint?: FileViewerBeforeOperation;
+    beforeExportHtml?: FileViewerBeforeOperation;
 }
 /**
  * 压缩包预览配置。
@@ -71,6 +78,33 @@ export interface FileViewerArchiveOptions {
      */
     maxEntryPreviewSize?: number;
 }
+export type FileViewerSourceType = 'file' | 'url' | 'empty';
+export type FileViewerLifecyclePhase = 'load-start' | 'load-complete' | 'unload-start' | 'unload-complete';
+export interface FileViewerLifecycleContext {
+    phase: FileViewerLifecyclePhase;
+    type: string;
+    filename: string;
+    source: FileViewerSourceType;
+    url?: string;
+    file?: File;
+    size?: number;
+    version: number;
+    timestamp: number;
+    duration?: number;
+    reason?: 'replace' | 'reset' | 'component-unmount';
+}
+export interface FileViewerLifecycleHooks {
+    onLoadStart?: (context: FileViewerLifecycleContext) => void | Promise<void>;
+    onLoadComplete?: (context: FileViewerLifecycleContext) => void | Promise<void>;
+    onUnloadStart?: (context: FileViewerLifecycleContext) => void | Promise<void>;
+    onUnloadComplete?: (context: FileViewerLifecycleContext) => void | Promise<void>;
+}
+export type FileViewerOperationType = 'download' | 'print' | 'export-html';
+export interface FileViewerOperationContext extends Omit<FileViewerLifecycleContext, 'phase'> {
+    operation: FileViewerOperationType;
+    label: string;
+}
+export type FileViewerBeforeOperation = (context: FileViewerOperationContext) => boolean | void | Promise<boolean | void>;
 /**
  * 预览器通用配置。
  */
@@ -78,6 +112,15 @@ export interface FileViewerOptions {
     watermark?: boolean | FileViewerWatermarkOptions;
     toolbar?: boolean | FileViewerToolbarOptions;
     archive?: FileViewerArchiveOptions;
+    /**
+     * 文档加载/卸载生命周期钩子。直接使用 Vue 组件时可以传函数；
+     * iframe 集成时同名事件会通过 `postMessage` 向宿主发送。
+     */
+    hooks?: FileViewerLifecycleHooks;
+    /**
+     * 内置操作按钮执行前的全局前置钩子。返回 `false` 时会取消本次操作。
+     */
+    beforeOperation?: FileViewerBeforeOperation;
 }
 /**
  * 导出/打印模式。

package/dist/src/package/components/FileViewer/FileViewer.vue.d.ts

@@ -1,4 +1,4 @@
-import { FileRef, FileViewerOptions } from '../../common/type';
+import { FileRef, FileViewerLifecycleContext, FileViewerOptions, FileViewerOperationContext } from '../../common/type';
 type __VLS_Props = {
     /**
      * 本地二进制输入。优先级高于 `url`。
@@ -21,6 +21,20 @@ type __VLS_Props = {
      */
     options?: FileViewerOptions;
 };
-declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    "load-start": (context: FileViewerLifecycleContext) => any;
+    "load-complete": (context: FileViewerLifecycleContext) => any;
+    "unload-start": (context: FileViewerLifecycleContext) => any;
+    "unload-complete": (context: FileViewerLifecycleContext) => any;
+    "operation-before": (context: FileViewerOperationContext) => any;
+    "operation-cancel": (context: FileViewerOperationContext) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onLoad-start"?: ((context: FileViewerLifecycleContext) => any) | undefined;
+    "onLoad-complete"?: ((context: FileViewerLifecycleContext) => any) | undefined;
+    "onUnload-start"?: ((context: FileViewerLifecycleContext) => any) | undefined;
+    "onUnload-complete"?: ((context: FileViewerLifecycleContext) => any) | undefined;
+    "onOperation-before"?: ((context: FileViewerOperationContext) => any) | undefined;
+    "onOperation-cancel"?: ((context: FileViewerOperationContext) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/src/package/index.d.ts

@@ -19,4 +19,4 @@ declare class Installer implements FileViewerInstaller {
 declare const _default: Installer;
 export default _default;
 export { FileViewer };
-export type { FileRef, FileViewerArchiveOptions, FileViewerOptions, FileViewerToolbarOptions, FileViewerWatermarkOptions } from './common/type';
+export type { FileRef, FileViewerArchiveOptions, FileViewerBeforeOperation, FileViewerLifecycleContext, FileViewerLifecycleHooks, FileViewerLifecyclePhase, FileViewerOperationContext, FileViewerOperationType, FileViewerOptions, FileViewerSourceType, FileViewerToolbarOptions, FileViewerWatermarkOptions } from './common/type';

package/dist/src/package/vendors/word/doc.d.ts

@@ -1,5 +1,5 @@
-import { AppWrapper } from '../../common/type';
+import { AppWrapper, FileRenderContext } from '../../common/type';
 /**
  * 渲染 doc 文件
  */
-export default function render(buffer: ArrayBuffer, target: HTMLDivElement): Promise<AppWrapper>;
+export default function render(buffer: ArrayBuffer, target: HTMLDivElement, context?: FileRenderContext): Promise<AppWrapper>;

package/dist/src/package/vendors/word/docx.d.ts

@@ -1,5 +1,5 @@
-import { AppWrapper } from '../../common/type';
+import { AppWrapper, FileRenderContext } from '../../common/type';
 /**
  * 渲染docx文件
  */
-export default function (buffer: ArrayBuffer, target: HTMLDivElement): Promise<AppWrapper>;
+export default function (buffer: ArrayBuffer, target: HTMLDivElement, context?: FileRenderContext): Promise<AppWrapper>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flyfish-group/file-viewer3",
-  "version": "1.0.15",
+  "version": "1.0.16",
   "private": false,
   "type": "module",
   "packageManager": "pnpm@11.0.9",