@file-viewer/react 2.1.22 → 2.1.24

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.en.md CHANGED
@@ -319,7 +319,8 @@ View-state sync is designed for projection systems, remote-control displays, sid
319
319
  | --- | --- |
320
320
  | `load` / `update` / `reload` / `destroy` | Imperatively load, update, reload, and destroy the viewer. |
321
321
  | `downloadOriginalFile()` | Downloads the original file while respecting toolbar and `beforeOperation` checks. |
322
- | `printRenderedHtml()` | Prints the complete rendered document using the best available per-format print adapter. |
322
+ | `printRenderedHtml(options?)` | Prints the complete rendered document using the best available per-format print adapter. Enabled watermarks are included; pass `mask` for cover regions. |
323
+ | `printWithMask(options?)` | Opens the black-cover mask designer, then prints. The designer is async-loaded inside core and works out of the box with component packages. |
323
324
  | `exportRenderedHtml()` | Exports rendered HTML for archiving, audit, or offline review. |
324
325
  | `zoomIn()` / `zoomOut()` / `resetZoom()` | Uses the active renderer zoom provider instead of outer CSS transforms that can break coordinates. |
325
326
  | `searchDocument()` / `nextSearchResult()` / `previousSearchResult()` | Runs document-level search and navigates highlighted matches. |
package/README.md CHANGED
@@ -319,7 +319,8 @@ const options = {
319
319
  | --- | --- |
320
320
  | `load` / `update` / `reload` / `destroy` | 命令式控制文档加载、参数更新、重新加载和销毁。 |
321
321
  | `downloadOriginalFile()` | 下载原始文件,遵循 toolbar 与 `beforeOperation` 权限校验。 |
322
- | `printRenderedHtml()` | 打印当前完整渲染内容,优先使用各格式的高保真打印适配器。 |
322
+ | `printRenderedHtml(options?)` | 打印当前完整渲染内容,优先使用各格式的高保真打印适配器;开启水印时会一并输出,也可传入 `mask` 遮盖区域。 |
323
+ | `printWithMask(options?)` | 打开掩膜设计器拖拽黑色遮盖块,确认后打印;设计器由 core 异步加载,组件开箱即用。 |
323
324
  | `exportRenderedHtml()` | 导出当前渲染后的 HTML,用于归档、审计和离线查看。 |
324
325
  | `zoomIn()` / `zoomOut()` / `resetZoom()` | 调用当前格式自己的缩放 provider,避免外层 CSS 缩放导致坐标偏移。 |
325
326
  | `searchDocument()` / `nextSearchResult()` / `previousSearchResult()` | 打开文档级搜索并在命中之间导航,保持高亮状态。 |
@@ -1,4 +1,4 @@
1
- import { type FileViewerAiOptions, type FileViewerArchiveOptions, type FileViewerCadOptions, type FileViewerDocxOptions, type FileViewerDocumentAnchor, type FileViewerDocumentChunk, type FileViewerEvent, type FileViewerEventHandler, type FileViewerEventType, type FileViewerFileRef, type FileViewerFitMode, type FileViewerFitOptions, type FileViewerFitResult, type FileViewerInstance, type FileViewerLifecycleContext, type FileViewerOperationAvailability, type FileViewerOperationContext, type FileViewerOptions, type FileViewerPdfOptions, type FileViewerSpreadsheetOptions, type FileViewerPublicApi, type FileViewerSearchOptions, type FileViewerSearchState, type FileViewerThemeMode, type FileViewerToolbarOptions, type FileViewerToolbarPosition, type FileViewerTypstOptions, type FileViewerWatermarkOptions, type FileViewerZoomState, type RendererRegistry } from '@file-viewer/core';
1
+ import { type FileViewerAiOptions, type FileViewerArchiveOptions, type FileViewerCadOptions, type FileViewerDocxOptions, type FileViewerDocumentAnchor, type FileViewerDocumentChunk, type FileViewerEvent, type FileViewerEventHandler, type FileViewerEventType, type FileViewerFileRef, type FileViewerFitMode, type FileViewerFitOptions, type FileViewerFitResult, type FileViewerInstance, type FileViewerLifecycleContext, type FileViewerOperationAvailability, type FileViewerOperationContext, type FileViewerOptions, type FileViewerPdfOptions, type FileViewerPrintOptions, type FileViewerSpreadsheetOptions, type FileViewerPublicApi, type FileViewerSearchOptions, type FileViewerSearchState, type FileViewerThemeMode, type FileViewerToolbarOptions, type FileViewerToolbarPosition, type FileViewerTypstOptions, type FileViewerWatermarkOptions, type FileViewerZoomState, type RendererRegistry } from '@file-viewer/core';
2
2
  export type FileRef = FileViewerFileRef;
3
3
  export type ViewerWatermarkOptions = FileViewerWatermarkOptions;
4
4
  export type ViewerToolbarPosition = FileViewerToolbarPosition;
@@ -73,7 +73,8 @@ export interface ViewerController {
73
73
  destroy(): void;
74
74
  getApi(): FileViewerPublicApi | FileViewerInstance | null;
75
75
  downloadOriginalFile(): Promise<void>;
76
- printRenderedHtml(): Promise<void>;
76
+ printRenderedHtml(options?: FileViewerPrintOptions): Promise<void>;
77
+ printWithMask(options?: FileViewerPrintOptions): Promise<void>;
77
78
  exportRenderedHtml(): Promise<void>;
78
79
  zoomIn(): Promise<FileViewerZoomState | null>;
79
80
  zoomOut(): Promise<FileViewerZoomState | null>;
@@ -102,7 +103,8 @@ export interface ViewerControllerHandle {
102
103
  getController(): ViewerController | null;
103
104
  getApi(): FileViewerPublicApi | FileViewerInstance | null;
104
105
  downloadOriginalFile(): Promise<void>;
105
- printRenderedHtml(): Promise<void>;
106
+ printRenderedHtml(options?: FileViewerPrintOptions): Promise<void>;
107
+ printWithMask(options?: FileViewerPrintOptions): Promise<void>;
106
108
  exportRenderedHtml(): Promise<void>;
107
109
  zoomIn(): Promise<FileViewerZoomState | null>;
108
110
  zoomOut(): Promise<FileViewerZoomState | null>;
@@ -1,5 +1,5 @@
1
1
  import { createViewer } from '@file-viewer/core';
2
- import { DEFAULT_FILE_VIEWER_SOURCE_FILENAME, getExtension, normalizeFilename, readFileViewerBuffer, resolveFileViewerSourceFilename, wrapFileViewerFileRef, } from '@file-viewer/core';
2
+ import { DEFAULT_FILE_VIEWER_SOURCE_FILENAME, getExtension, normalizeFileViewerSourceUrl, normalizeFilename, readFileViewerBuffer, resolveFileViewerSourceFilename, wrapFileViewerFileRef, } from '@file-viewer/core';
3
3
  const isBrowser = () => typeof window !== 'undefined' && typeof document !== 'undefined';
4
4
  const hasSource = (options = {}) => {
5
5
  return !!(options.url || options.file || options.buffer);
@@ -18,7 +18,8 @@ const defaultFetchFile = async ({ url, signal }) => {
18
18
  if (!canUseFetch()) {
19
19
  throw new Error('fetch is not available in the current environment.');
20
20
  }
21
- const response = await fetch(url, { signal });
21
+ const requestUrl = normalizeFileViewerSourceUrl(url) || url;
22
+ const response = await fetch(requestUrl, { signal });
22
23
  if (!response.ok) {
23
24
  throw new Error(`Failed to fetch file: ${response.status} ${response.statusText}`);
24
25
  }
@@ -104,9 +105,13 @@ export const createViewerControllerHandle = (getController, dispose) => ({
104
105
  var _a, _b;
105
106
  return (_b = (_a = getController()) === null || _a === void 0 ? void 0 : _a.downloadOriginalFile()) !== null && _b !== void 0 ? _b : Promise.resolve();
106
107
  },
107
- printRenderedHtml() {
108
+ printRenderedHtml(options) {
108
109
  var _a, _b;
109
- return (_b = (_a = getController()) === null || _a === void 0 ? void 0 : _a.printRenderedHtml()) !== null && _b !== void 0 ? _b : Promise.resolve();
110
+ return (_b = (_a = getController()) === null || _a === void 0 ? void 0 : _a.printRenderedHtml(options)) !== null && _b !== void 0 ? _b : Promise.resolve();
111
+ },
112
+ printWithMask(options) {
113
+ var _a, _b;
114
+ return (_b = (_a = getController()) === null || _a === void 0 ? void 0 : _a.printWithMask(options)) !== null && _b !== void 0 ? _b : Promise.resolve();
110
115
  },
111
116
  exportRenderedHtml() {
112
117
  var _a, _b;
@@ -361,8 +366,11 @@ export const mountViewer = (container, initialOptions = {}, coreOptions = {}) =>
361
366
  downloadOriginalFile() {
362
367
  return callApi(instance, api => api.download(), undefined);
363
368
  },
364
- printRenderedHtml() {
365
- return callApi(instance, api => api.print(), undefined);
369
+ printRenderedHtml(options) {
370
+ return callApi(instance, api => api.print(options), undefined);
371
+ },
372
+ printWithMask(options) {
373
+ return callApi(instance, api => api.printWithMask(options), undefined);
366
374
  },
367
375
  exportRenderedHtml() {
368
376
  return callApi(instance, api => api.exportHtml({ download: true }).then(() => undefined), undefined);
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@file-viewer/react",
3
- "version": "2.1.22",
3
+ "version": "2.1.24",
4
4
  "private": false,
5
5
  "type": "module",
6
6
  "description": "Standard React component package for Flyfish File Viewer",
@@ -55,7 +55,7 @@
55
55
  "react": ">=17 <20"
56
56
  },
57
57
  "dependencies": {
58
- "@file-viewer/core": "^2.1.22"
58
+ "@file-viewer/core": "2.1.24"
59
59
  },
60
60
  "devDependencies": {
61
61
  "@types/react": "^19.2.17",