@flyfish-group/file-viewer3 1.0.21 → 1.0.22

package/dist/src/App.vue.d.ts

@@ -0,0 +1,3 @@
+declare const __VLS_export: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/src/compare/CompareApp.vue.d.ts

@@ -0,0 +1,3 @@
+declare const __VLS_export: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

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

@@ -0,0 +1,3 @@
+declare const __VLS_export: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/src/components/utils.d.ts

@@ -1,4 +1,4 @@
-import { FileViewerOptions } from '../package/common/type';
+import { FileViewerOptions } from '../../package/common/type';
 type ListenCallback = (file?: File, url?: string, options?: FileViewerOptions) => void;
 export declare function listenForFile(callback: ListenCallback): void;
 export {};

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

@@ -41,6 +41,13 @@ export interface FileViewerWatermarkOptions {
     color?: string;
     fontFamily?: string;
 }
+/**
+ * 预览器内置操作栏位置。
+ *
+ * `auto` 是默认策略: PDF 这类有独立阅读工具栏的格式会自动悬浮到右下角，
+ * 其他格式继续使用顶部操作栏；也可以显式传 `top` 或 `bottom-right`。
+ */
+export type FileViewerToolbarPosition = 'auto' | 'top' | 'bottom-right';
 /**
  * 预览器内置操作栏配置。
  */
@@ -48,6 +55,11 @@ export interface FileViewerToolbarOptions {
     download?: boolean;
     print?: boolean;
     exportHtml?: boolean;
+    /**
+     * 操作栏位置。`bottom-right` 会以胶囊按钮组悬浮在预览区右下角，
+     * 适合 PDF 等自身已经有顶部导航栏的格式。
+     */
+    position?: FileViewerToolbarPosition;
     /**
      * 内置操作按钮执行前的统一前置钩子。返回 `false` 时会取消本次操作。
      */
@@ -121,6 +133,14 @@ export interface FileViewerTypstOptions {
      */
     compilerWasmUrl?: string;
 }
+/**
+ * 预览器主题模式。
+ *
+ * `system` 是默认值，会继续跟随浏览器 `prefers-color-scheme`；
+ * 浅色业务系统即使运行在深色操作系统中，也可以显式传 `light`
+ * 锁定预览区、工具栏和支持主题切换的渲染器为浅色。
+ */
+export type FileViewerThemeMode = 'light' | 'dark' | 'system';
 export type FileViewerSourceType = 'file' | 'url' | 'empty';
 export type FileViewerLifecyclePhase = 'load-start' | 'load-complete' | 'unload-start' | 'unload-complete';
 export interface FileViewerLifecycleContext {
@@ -164,6 +184,12 @@ export type FileViewerBeforeOperation = (context: FileViewerOperationContext) =>
  * 预览器通用配置。
  */
 export interface FileViewerOptions {
+    /**
+     * 预览器主题。默认 `system`，即跟随浏览器 `prefers-color-scheme`。
+     * 业务系统已有固定浅色/深色 UI 时，建议显式传 `light` 或 `dark`，
+     * 避免部分渲染器在系统深色模式下自动切换后和宿主视觉不一致。
+     */
+    theme?: FileViewerThemeMode;
     watermark?: boolean | FileViewerWatermarkOptions;
     toolbar?: boolean | FileViewerToolbarOptions;
     archive?: FileViewerArchiveOptions;

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

@@ -1,4 +1,4 @@
-import { FileRef, FileViewerLifecycleContext, FileViewerOperationAvailability, FileViewerOptions, FileViewerOperationContext } from '../../common/type';
+import { FileRef, FileViewerLifecycleContext, FileViewerOperationAvailability, FileViewerOptions, FileViewerOperationContext } from '../../../../package/common/type';
 type __VLS_Props = {
     /**
      * 本地二进制输入。优先级高于 `url`。

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

@@ -1,5 +1,5 @@
 import { ComputedRef, Ref, ShallowRef } from 'vue';
-import { FileRenderExportAdapter, FileViewerOperationAvailability, FileViewerOperationType } from '../../common/type';
+import { FileRenderExportAdapter, FileViewerOperationAvailability, FileViewerOperationType } from '../../../../package/common/type';
 interface UseViewerExportOptions {
     activeExportAdapter: ShallowRef<FileRenderExportAdapter | null>;
     currentBuffer: Ref<ArrayBuffer | null>;

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

@@ -1,3 +1,3 @@
-import { FileRenderContext } from '../../common/type';
+import { FileRenderContext } from '../../../../package/common/type';
 export declare function getExtend(name: string): string;
-export declare function render(buffer: ArrayBuffer, type: string, target: HTMLDivElement, context?: FileRenderContext): Promise<import('../../common/type').Rendered | undefined>;
+export declare function render(buffer: ArrayBuffer, type: string, target: HTMLDivElement, context?: FileRenderContext): Promise<import('../../../../package/common/type').Rendered | undefined>;

package/dist/src/package/vendors/archive/ArchiveViewer.vue.d.ts

@@ -1,4 +1,4 @@
-import { FileViewerArchiveOptions } from '../../common/type';
+import { FileViewerArchiveOptions } from '../../../../package/common/type';
 type __VLS_Props = {
     data: ArrayBuffer;
     filename: string;

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

@@ -1,3 +1,3 @@
-import { FileRenderContext } from '../../common/type';
+import { FileRenderContext } from '../../../../package/common/type';
 export { ARCHIVE_EXTENSIONS } from './shared';
 export default function renderArchive(buffer: ArrayBuffer, target: HTMLDivElement, context?: FileRenderContext): Promise<import('vue').App<Element>>;

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

@@ -1,2 +1,2 @@
-import { FileRenderContext } from '../../common/type';
+import { FileRenderContext } from '../../../../package/common/type';
 export default function renderEda(buffer: ArrayBuffer, target: HTMLDivElement, type?: string, context?: FileRenderContext): Promise<import('vue').App<Element>>;

package/dist/src/package/vendors/email/EmailViewer.vue.d.ts

@@ -1,4 +1,4 @@
-import { FileViewerOptions } from '../../common/type';
+import { FileViewerOptions } from '../../../../package/common/type';
 type __VLS_Props = {
     data: ArrayBuffer;
     type: 'eml' | 'msg';

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

@@ -1,2 +1,2 @@
-import { FileRenderContext } from '../../common/type';
+import { FileRenderContext } from '../../../../package/common/type';
 export default function renderEmail(buffer: ArrayBuffer, target: HTMLDivElement, type?: string, context?: FileRenderContext): Promise<import('vue').App<Element>>;

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

@@ -1,3 +1,3 @@
-import { FileRenderContext } from '../../common/type';
+import { FileRenderContext } from '../../../../package/common/type';
 export { MODEL_EXTENSIONS } from './shared';
 export default function renderModel(buffer: ArrayBuffer, target: HTMLDivElement, type?: string, context?: FileRenderContext): Promise<import('vue').App<Element>>;

package/dist/src/package/vendors/nestedRender.d.ts

@@ -1,4 +1,4 @@
-import { FileRenderContext, Rendered } from '../common/type';
+import { FileRenderContext, Rendered } from '../../../package/common/type';
 /**
  * 压缩包内文件和邮件附件的嵌套预览入口。
  *

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

@@ -1,4 +1,4 @@
-import { FileRenderExportAdapter, FileViewerPdfOptions } from '../../common/type';
+import { FileRenderExportAdapter, FileViewerPdfOptions } from '../../../../package/common/type';
 type __VLS_Props = {
     data?: ArrayBuffer;
     url?: string;

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

@@ -1,2 +1,2 @@
-import { FileRenderContext } from '../../common/type';
+import { FileRenderContext } from '../../../../package/common/type';
 export default function renderPdf(buffer: ArrayBuffer, target: HTMLDivElement, context?: FileRenderContext): Promise<import('vue').App<Element>>;

package/dist/src/package/vendors/renders.d.ts

@@ -1,3 +1,3 @@
-import { FileHandler } from '../common/type';
+import { FileHandler } from '../../../package/common/type';
 declare const renders: Map<string, FileHandler>;
 export default renders;

package/dist/src/package/vendors/typst/TypstViewer.vue.d.ts

@@ -1,4 +1,4 @@
-import { FileRenderExportAdapter } from '../../common/type';
+import { FileRenderExportAdapter } from '../../../../package/common/type';
 declare global {
     interface Window {
         __FLYFISH_TYPST_COMPILER_WASM_URL__?: string;

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

@@ -1,4 +1,4 @@
-import { FileRenderContext } from '../../common/type';
+import { FileRenderContext } from '../../../../package/common/type';
 /**
  * Render Typst source documents through the browser WASM compiler/renderer stack.
  *

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

@@ -1,4 +1,4 @@
-import { AppWrapper, FileRenderContext } from '../../common/type';
+import { AppWrapper, FileRenderContext } from '../../../../package/common/type';
 /**
  * 渲染 doc 文件
  */

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

@@ -1,4 +1,4 @@
-import { AppWrapper, FileRenderContext } from '../../common/type';
+import { AppWrapper, FileRenderContext } from '../../../../package/common/type';
 /**
  * 渲染docx文件
  */

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

@@ -1,5 +1,5 @@
 import { App } from 'vue';
-import { FileRenderContext } from '../../common/type';
+import { FileRenderContext } from '../../../../package/common/type';
 /**
  * 渲染excel
  */

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

@@ -1,8 +1,3 @@
 export declare function cellKey(row: number, col: number): string;
 export declare function flatten(routes: Array<any>): Array<any>;
 export declare function toStyleString(style: any): string;
-export declare const darkMode: {
-    value: import('vue').Ref<null, null>;
-} | {
-    value: import('vue').Ref<boolean, boolean>;
-};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flyfish-group/file-viewer3",
-  "version": "1.0.21",
+  "version": "1.0.22",
   "private": false,
   "type": "module",
   "packageManager": "pnpm@11.0.9",
@@ -48,7 +48,9 @@
     "build-lib-only": "vite build --mode lib && node scripts/fix-lib-css.mjs && node scripts/fix-lib-workers.mjs",
     "build:viewer-assets": "pnpm build-only && node scripts/sync-viewer-assets.mjs",
     "build:adapters": "pnpm build:viewer-assets && pnpm --filter @flyfish-group/file-viewer-web build && pnpm --filter @flyfish-group/file-viewer-react build",
-    "deploy:cloudflare": "pnpm build-only && node scripts/deploy-cloudflare-pages.mjs",
+    "verify:demo-output": "node scripts/verify-demo-output.mjs",
+    "deploy:cloudflare": "pnpm build-only && pnpm verify:demo-output && node scripts/deploy-cloudflare-pages.mjs",
+    "docs:deploy:cloudflare": "pnpm docs:build && CLOUDFLARE_PAGES_PROJECT=flyfish-file-viewer-docs CLOUDFLARE_PAGES_OUTPUT_DIR=docs/.vitepress/dist CLOUDFLARE_PAGES_BRANCH=v3 node scripts/deploy-cloudflare-pages.mjs",
     "dev:adapters": "pnpm --filter @flyfish-group/file-viewer-demo dev",
     "build:adapter-demo": "pnpm --filter @flyfish-group/file-viewer-demo build",
     "docker:build": "node scripts/docker-buildx.mjs --load",
@@ -86,7 +88,7 @@
     "@myriaddreamin/typst-ts-renderer": "0.7.0",
     "@myriaddreamin/typst-ts-web-compiler": "0.7.0",
     "@myriaddreamin/typst.ts": "0.7.0",
-    "axios": "^1.16.1",
+    "axios": "^1.17.0",
     "billboard.js": "^3.18.0",
     "buffer": "^6.0.3",
     "cfb": "^1.2.2",
@@ -100,51 +102,51 @@
     "jquery": "^4.0.0",
     "jszip": "^3.10.1",
     "libarchive.js": "^2.0.2",
-    "marked": "^18.0.3",
+    "marked": "^18.0.5",
     "msdoc-viewer": "^0.2.0",
     "ofd-xml-parser": "^0.0.6",
     "pako": "^2.1.0",
-    "pdfjs-dist": "^5.7.284",
+    "pdfjs-dist": "^6.0.227",
     "postal-mime": "^2.7.4",
     "qs": "^6.15.2",
-    "react": "^19.2.6",
-    "react-dom": "^19.2.6",
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7",
     "roughjs": "^4.6.6",
     "styled-exceljs": "0.21.1",
     "three": "^0.184.0",
     "tinycolor2": "^1.6.0",
     "v-viewer": "^3.0.23",
     "viewerjs": "^1.11.7",
-    "vue": "^3.5.34"
+    "vue": "^3.5.35"
   },
   "devDependencies": {
     "@rushstack/eslint-patch": "^1.16.1",
     "@types/d3": "^7.4.3",
-    "@types/jquery": "^4.0.0",
-    "@types/node": "^25.8.0",
+    "@types/jquery": "^4.0.1",
+    "@types/node": "^25.9.2",
     "@types/pako": "^2.0.4",
     "@types/qs": "^6.15.1",
-    "@types/react": "^19.2.14",
+    "@types/react": "^19.2.17",
     "@types/react-dom": "^19.2.3",
     "@types/tinycolor2": "^1.4.6",
     "@vitejs/plugin-vue": "^6.0.7",
     "@vitejs/plugin-vue-jsx": "^5.1.5",
     "@vue/eslint-config-prettier": "^10.2.0",
-    "@vue/eslint-config-typescript": "^14.7.0",
+    "@vue/eslint-config-typescript": "^14.8.0",
     "@vue/tsconfig": "^0.9.1",
-    "eslint": "^10.4.0",
-    "eslint-plugin-vue": "^10.9.1",
-    "javascript-obfuscator": "^5.4.2",
+    "eslint": "^10.4.1",
+    "eslint-plugin-vue": "^10.9.2",
+    "javascript-obfuscator": "^5.4.3",
     "npm-run-all": "^4.1.5",
     "prettier": "^3.8.3",
-    "sass": "^1.99.0",
+    "sass": "^1.100.0",
     "ts-node": "^10.9.2",
     "typescript": "^6.0.3",
-    "vite": "^8.0.13",
-    "vite-plugin-dts": "^5.0.0",
+    "vite": "^8.0.16",
+    "vite-plugin-dts": "^5.0.2",
     "vitepress": "^1.6.4",
-    "vitest": "^4.1.6",
-    "vue-tsc": "^3.2.9"
+    "vitest": "^4.1.8",
+    "vue-tsc": "^3.3.4"
   },
   "files": [
     "dist",