@flyfish-group/file-viewer3 1.0.16 → 1.0.18

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

@@ -0,0 +1,27 @@
+import { FileRenderExportAdapter } from './type';
+/**
+ * 这些格式只有专属适配器准备好后才展示打印。
+ *
+ * 它们的在线预览常依赖分页引擎、虚拟渲染或 Worker 生命周期，直接克隆
+ * DOM 很容易只得到当前页或当前视口。
+ */
+export declare const ADAPTER_PRINT_REQUIRED_EXTENSIONS: string[];
+/**
+ * 这些格式的预览结果是完整 DOM / SVG / Canvas 截图，解除滚动容器裁切后
+ * 可以稳定进入浏览器打印流程。
+ */
+export declare const DOM_PRINTABLE_EXTENSIONS: string[];
+/**
+ * 这些格式默认不展示打印按钮，避免导出半截内容。
+ *
+ * - 表格链路使用虚拟滚动，只渲染局部窗口；
+ * - 压缩包/邮件包含嵌套预览，顶层不是单一可打印文档；
+ * - EPUB 使用 iframe/连续分页；
+ * - 3D、音视频是交互媒体。
+ */
+export declare const NON_PRINTABLE_EXTENSIONS: string[];
+export declare const normalizeFileExtension: (extension: string) => string;
+export declare const needsDedicatedPrintAdapter: (extension: string) => boolean;
+export declare const isDomPrintableExtension: (extension: string) => boolean;
+export declare const isKnownNonPrintableExtension: (extension: string) => boolean;
+export declare const resolvePrintAvailability: (extension: string, adapter: FileRenderExportAdapter | null, renderedReady: boolean) => boolean;

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

@@ -78,6 +78,23 @@ export interface FileViewerArchiveOptions {
      */
     maxEntryPreviewSize?: number;
 }
+/**
+ * PDF 预览配置。
+ */
+export interface FileViewerPdfOptions {
+    /**
+     * 是否启用左侧页面/目录导航窗格。设为 `false` 时会同时隐藏侧栏和切换按钮。
+     */
+    navigation?: boolean;
+    /**
+     * 导航窗格初始是否展开。未设置时默认展开，`navigation: false` 时会被忽略。
+     */
+    defaultNavigationVisible?: boolean;
+    /**
+     * 初始页面旋转角度。会按 90 度归一化到 0 / 90 / 180 / 270。
+     */
+    rotation?: number;
+}
 export type FileViewerSourceType = 'file' | 'url' | 'empty';
 export type FileViewerLifecyclePhase = 'load-start' | 'load-complete' | 'unload-start' | 'unload-complete';
 export interface FileViewerLifecycleContext {
@@ -100,6 +117,18 @@ export interface FileViewerLifecycleHooks {
     onUnloadComplete?: (context: FileViewerLifecycleContext) => void | Promise<void>;
 }
 export type FileViewerOperationType = 'download' | 'print' | 'export-html';
+/**
+ * 当前文档对内置操作的真实可用性。
+ *
+ * `toolbar` 只表达宿主想不想展示某个按钮；这里表达当前文件类型和渲染器
+ * 是否真的能稳定完成该操作。尤其是打印，虚拟表格、播放器、3D 画布、
+ * EPUB iframe 等链路无法保证完整分页输出时会主动关闭。
+ */
+export interface FileViewerOperationAvailability {
+    download: boolean;
+    print: boolean;
+    exportHtml: boolean;
+}
 export interface FileViewerOperationContext extends Omit<FileViewerLifecycleContext, 'phase'> {
     operation: FileViewerOperationType;
     label: string;
@@ -112,6 +141,7 @@ export interface FileViewerOptions {
     watermark?: boolean | FileViewerWatermarkOptions;
     toolbar?: boolean | FileViewerToolbarOptions;
     archive?: FileViewerArchiveOptions;
+    pdf?: FileViewerPdfOptions;
     /**
      * 文档加载/卸载生命周期钩子。直接使用 Vue 组件时可以传函数；
      * iframe 集成时同名事件会通过 `postMessage` 向宿主发送。
@@ -140,6 +170,21 @@ export interface FileRenderExportOptions {
  * 渲染器专属导出适配器。
  */
 export interface FileRenderExportAdapter {
+    /**
+     * 当前渲染器是否允许打印。未设置时由文件类型能力矩阵兜底判断。
+     */
+    print?: boolean;
+    /**
+     * 当前渲染器是否允许导出渲染后的 HTML。
+     */
+    exportHtml?: boolean;
+    /**
+     * 是否把当前页面的全局 style/link 一并带进导出窗口。
+     *
+     * 专属分页适配器通常会自行输出必要样式，应关闭该项，避免宿主应用的
+     * `height: 100vh`、`overflow: hidden` 等布局样式干扰浏览器分页打印。
+     */
+    includeDocumentStyles?: boolean;
     beforeSnapshot?: () => Promise<void> | void;
     toHtml?: (options: FileRenderExportOptions) => Promise<string> | string;
 }

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

@@ -1,4 +1,4 @@
-import { FileRef, FileViewerLifecycleContext, FileViewerOptions, FileViewerOperationContext } from '../../common/type';
+import { FileRef, FileViewerLifecycleContext, FileViewerOperationAvailability, FileViewerOptions, FileViewerOperationContext } from '../../common/type';
 type __VLS_Props = {
     /**
      * 本地二进制输入。优先级高于 `url`。
@@ -21,13 +21,23 @@ type __VLS_Props = {
      */
     options?: FileViewerOptions;
 };
-declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {
+    downloadOriginalFile: () => Promise<void>;
+    printRenderedHtml: () => Promise<void>;
+    exportRenderedHtml: () => Promise<void>;
+    getOperationAvailability: () => {
+        download: boolean;
+        print: boolean;
+        exportHtml: boolean;
+    };
+}, {}, {}, {}, 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;
+    "operation-availability-change": (availability: FileViewerOperationAvailability) => any;
 }, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
     "onLoad-start"?: ((context: FileViewerLifecycleContext) => any) | undefined;
     "onLoad-complete"?: ((context: FileViewerLifecycleContext) => any) | undefined;
@@ -35,6 +45,7 @@ declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {}, {}, {
     "onUnload-complete"?: ((context: FileViewerLifecycleContext) => any) | undefined;
     "onOperation-before"?: ((context: FileViewerOperationContext) => any) | undefined;
     "onOperation-cancel"?: ((context: FileViewerOperationContext) => any) | undefined;
+    "onOperation-availability-change"?: ((availability: FileViewerOperationAvailability) => 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, FileViewerBeforeOperation, FileViewerLifecycleContext, FileViewerLifecycleHooks, FileViewerLifecyclePhase, FileViewerOperationContext, FileViewerOperationType, FileViewerOptions, FileViewerSourceType, FileViewerToolbarOptions, FileViewerWatermarkOptions } from './common/type';
+export type { FileRef, FileRenderExportAdapter, FileRenderExportMode, FileRenderExportOptions, FileViewerArchiveOptions, FileViewerBeforeOperation, FileViewerLifecycleContext, FileViewerLifecycleHooks, FileViewerLifecyclePhase, FileViewerOperationAvailability, FileViewerOperationContext, FileViewerOperationType, FileViewerOptions, FileViewerSourceType, FileViewerToolbarOptions, FileViewerWatermarkOptions } from './common/type';

package/dist/src/package/vendors/pdf/PdfView.vue.d.ts

@@ -1,7 +1,8 @@
-import { FileRenderExportAdapter } from '../../common/type';
+import { FileRenderExportAdapter, FileViewerPdfOptions } from '../../common/type';
 type __VLS_Props = {
     data: ArrayBuffer;
     exportAdapter?: (adapter: FileRenderExportAdapter | null) => void;
+    options?: FileViewerPdfOptions;
 };
 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 _default: typeof __VLS_export;

package/dist/src/package/vendors/xlsx/XlsxTable.view.d.ts

@@ -1,6 +1,8 @@
 import { Column, ConfigType } from 'e-virt-table';
 import { SheetModel } from './worker/type';
 import { CellStyleCache, SheetDefaults, VirtualSheetState } from './XlsxTable.state';
+export declare const INDEX_COLUMN_WIDTH = 68;
+export declare const HEADER_HEIGHT = 34;
 interface TableConfigOptions {
     hostHeight: number;
     sheetDefaults: SheetDefaults;

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

@@ -1,5 +1,6 @@
 import { App } from 'vue';
+import { FileRenderContext } from '../../common/type';
 /**
  * 渲染excel
  */
-export default function render(buffer: ArrayBuffer, target: HTMLDivElement): Promise<App>;
+export default function render(buffer: ArrayBuffer, target: HTMLDivElement, _type?: string, context?: FileRenderContext): Promise<App>;

package/dist/src/package/vendors/xlsx/worker/sheetjs/SheetJsModel.d.ts

@@ -52,6 +52,10 @@ export default class SheetJsModel implements SheetModel {
     private get endRow();
     private get denseRows();
     private getCellAt;
+    private getAxisOffset;
+    private getMarkerLeft;
+    private getMarkerTop;
+    private getImages;
     private getAllMerge;
     private getData;
     private getCell;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flyfish-group/file-viewer3",
-  "version": "1.0.16",
+  "version": "1.0.18",
   "private": false,
   "type": "module",
   "packageManager": "pnpm@11.0.9",
@@ -27,14 +27,19 @@
     "url": "https://github.com/flyfish-dev/file-viewer/issues"
   },
   "scripts": {
+    "patch:msdoc": "node scripts/patch-msdoc-viewer.mjs",
+    "predev": "node scripts/patch-msdoc-viewer.mjs",
     "dev": "vite",
+    "prebuild": "node scripts/patch-msdoc-viewer.mjs",
     "build": "run-p type-check build-only",
+    "prebuild-lib": "node scripts/patch-msdoc-viewer.mjs",
     "build-lib": "run-p type-check build-lib-only",
     "preview": "vite preview",
     "docs:dev": "vitepress dev docs",
     "docs:build": "vitepress build docs",
     "docs:preview": "vitepress preview docs",
     "test:build": "vue-tsc --noEmit && vite build",
+    "prebuild-only": "node scripts/patch-msdoc-viewer.mjs",
     "build-only": "vite build",
     "type-check": "vue-tsc --noEmit",
     "type-check:adapters": "pnpm --filter @flyfish-group/file-viewer-web type-check && pnpm --filter @flyfish-group/file-viewer-react type-check",
@@ -48,8 +53,10 @@
     "release:adapters:pack": "pnpm build:adapters && mkdir -p .release/adapters && pnpm -C packages/web pack --pack-destination ../../.release/adapters && pnpm -C packages/react pack --pack-destination ../../.release/adapters",
     "release:adapters:publish": "pnpm build:adapters && pnpm -C packages/web publish --access public && pnpm -C packages/react publish --access public",
     "obfuscate": "node scripts/obfuscate-dist.mjs",
+    "prebuild-lib-only": "node scripts/patch-msdoc-viewer.mjs",
     "release:pack": "pnpm type-check && pnpm build-lib-only && pnpm obfuscate && npm pack",
     "release:public": "node scripts/sync-public-artifacts.mjs",
+    "pretest": "node scripts/patch-msdoc-viewer.mjs",
     "test": "vitest",
     "test:coverage": "vitest run --coverage"
   },