@file-viewer/web 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
@@ -361,7 +361,8 @@ View-state sync is designed for projection systems, remote-control displays, sid
361
361
  | --- | --- |
362
362
  | `load` / `update` / `reload` / `destroy` | Imperatively load, update, reload, and destroy the viewer. |
363
363
  | `downloadOriginalFile()` | Downloads the original file while respecting toolbar and `beforeOperation` checks. |
364
- | `printRenderedHtml()` | Prints the complete rendered document using the best available per-format print adapter. |
364
+ | `printRenderedHtml(options?)` | Prints the complete rendered document using the best available per-format print adapter. Enabled watermarks are included; pass `mask` for cover regions. |
365
+ | `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. |
365
366
  | `exportRenderedHtml()` | Exports rendered HTML for archiving, audit, or offline review. |
366
367
  | `zoomIn()` / `zoomOut()` / `resetZoom()` | Uses the active renderer zoom provider instead of outer CSS transforms that can break coordinates. |
367
368
  | `searchDocument()` / `nextSearchResult()` / `previousSearchResult()` | Runs document-level search and navigates highlighted matches. |
package/README.md CHANGED
@@ -361,7 +361,8 @@ const options = {
361
361
  | --- | --- |
362
362
  | `load` / `update` / `reload` / `destroy` | 命令式控制文档加载、参数更新、重新加载和销毁。 |
363
363
  | `downloadOriginalFile()` | 下载原始文件,遵循 toolbar 与 `beforeOperation` 权限校验。 |
364
- | `printRenderedHtml()` | 打印当前完整渲染内容,优先使用各格式的高保真打印适配器。 |
364
+ | `printRenderedHtml(options?)` | 打印当前完整渲染内容,优先使用各格式的高保真打印适配器;开启水印时会一并输出,也可传入 `mask` 遮盖区域。 |
365
+ | `printWithMask(options?)` | 打开掩膜设计器拖拽黑色遮盖块,确认后打印;设计器由 core 异步加载,组件开箱即用。 |
365
366
  | `exportRenderedHtml()` | 导出当前渲染后的 HTML,用于归档、审计和离线查看。 |
366
367
  | `zoomIn()` / `zoomOut()` / `resetZoom()` | 调用当前格式自己的缩放 provider,避免外层 CSS 缩放导致坐标偏移。 |
367
368
  | `searchDocument()` / `nextSearchResult()` / `previousSearchResult()` | 打开文档级搜索并在命中之间导航,保持高亮状态。 |
@@ -1,4 +1,4 @@
1
- import { type FileViewerAiOptions, type FileViewerApplyViewStateOptions, 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 FileViewerPresentationOptions, type FileViewerSpreadsheetOptions, type FileViewerPublicApi, type FileViewerSearchOptions, type FileViewerSearchState, type FileViewerThemeMode, type FileViewerToolbarOptions, type FileViewerToolbarPosition, type FileViewerTypstOptions, type FileViewerUiDensity, type FileViewerUiOptions, type FileViewerViewState, type FileViewerWatermarkOptions, type FileViewerZoomState, type RendererRegistry } from '@file-viewer/core';
1
+ import { type FileViewerAiOptions, type FileViewerApplyViewStateOptions, 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 FileViewerPresentationOptions, type FileViewerSpreadsheetOptions, type FileViewerPublicApi, type FileViewerSearchOptions, type FileViewerSearchState, type FileViewerThemeMode, type FileViewerToolbarOptions, type FileViewerToolbarPosition, type FileViewerTypstOptions, type FileViewerUiDensity, type FileViewerUiOptions, type FileViewerViewState, type FileViewerWatermarkOptions, type FileViewerPrintOptions, 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;
@@ -79,7 +79,8 @@ export interface ViewerController {
79
79
  destroy(): void;
80
80
  getApi(): FileViewerPublicApi | FileViewerInstance | null;
81
81
  downloadOriginalFile(): Promise<void>;
82
- printRenderedHtml(): Promise<void>;
82
+ printRenderedHtml(options?: FileViewerPrintOptions): Promise<void>;
83
+ printWithMask(options?: FileViewerPrintOptions): Promise<void>;
83
84
  exportRenderedHtml(): Promise<void>;
84
85
  zoomIn(): Promise<FileViewerZoomState | null>;
85
86
  zoomOut(): Promise<FileViewerZoomState | null>;
@@ -110,7 +111,8 @@ export interface ViewerControllerHandle {
110
111
  getController(): ViewerController | null;
111
112
  getApi(): FileViewerPublicApi | FileViewerInstance | null;
112
113
  downloadOriginalFile(): Promise<void>;
113
- printRenderedHtml(): Promise<void>;
114
+ printRenderedHtml(options?: FileViewerPrintOptions): Promise<void>;
115
+ printWithMask(options?: FileViewerPrintOptions): Promise<void>;
114
116
  exportRenderedHtml(): Promise<void>;
115
117
  zoomIn(): Promise<FileViewerZoomState | null>;
116
118
  zoomOut(): Promise<FileViewerZoomState | null>;
@@ -1,5 +1,5 @@
1
1
  import { appendFileViewerStyle, applyFileViewerZoomAvailability, createViewer, isFileViewerShadowRoot, normalizeFileViewerUiDensity, normalizeFileViewerStyleIsolation, } from '@file-viewer/core';
2
- import { DEFAULT_FILE_VIEWER_SOURCE_FILENAME, createFileViewerTranslator, getExtension, hasVisibleFileViewerToolbarActions, isFileViewerZoomButtonDisabled, normalizeFileViewerToolbar, normalizeFilename, readFileViewerBuffer, resolveFileViewerSourceFilename, resolveFileViewerToolbarOrder, resolveFileViewerToolbarPosition, resolveVisibleFileViewerToolbar, wrapFileViewerFileRef, } from '@file-viewer/core';
2
+ import { DEFAULT_FILE_VIEWER_SOURCE_FILENAME, createFileViewerTranslator, getExtension, normalizeFileViewerSourceUrl, hasVisibleFileViewerToolbarActions, isFileViewerZoomButtonDisabled, normalizeFileViewerToolbar, normalizeFilename, readFileViewerBuffer, resolveFileViewerSourceFilename, resolveFileViewerToolbarOrder, resolveFileViewerToolbarPosition, resolveVisibleFileViewerToolbar, 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;
@@ -215,12 +220,12 @@ const DEFAULT_TOOLBAR_ZOOM_STATE = {
215
220
  canReset: false,
216
221
  };
217
222
  const WEB_VIEWER_STYLE = `
218
- :host{display:block;width:100%;height:100%;min-width:0;min-height:0;contain:content;--file-viewer-bg:transparent;--file-viewer-text:#172033;--file-viewer-muted:#607282;--file-viewer-font:14px/1.45 system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif;--file-viewer-border:rgba(20,35,53,.08);--file-viewer-toolbar-bg:rgba(255,255,255,.92);--file-viewer-toolbar-border:rgba(20,35,53,.06);--file-viewer-toolbar-shadow:0 18px 44px rgba(15,23,42,.16);--file-viewer-toolbar-radius:999px;--file-viewer-toolbar-gap:6px;--file-viewer-toolbar-min-height:45px;--file-viewer-toolbar-padding:6px 10px;--file-viewer-toolbar-floating-min-height:42px;--file-viewer-toolbar-floating-padding:6px;--file-viewer-toolbar-floating-offset:16px;--file-viewer-group-bg:rgba(20,35,53,.035);--file-viewer-group-border:rgba(20,35,53,.08);--file-viewer-group-gap:2px;--file-viewer-group-padding:2px;--file-viewer-button-color:#40546a;--file-viewer-button-hover-bg:rgba(33,163,102,.1);--file-viewer-button-hover-color:#16774c;--file-viewer-button-disabled-color:#aab5c0;--file-viewer-button-radius:8px;--file-viewer-button-min-width:42px;--file-viewer-button-height:30px;--file-viewer-button-padding:0 10px;--file-viewer-icon-button-size:30px;--file-viewer-zoom-meter-min-width:48px;--file-viewer-zoom-meter-padding:0 8px;--file-viewer-floating-button-min-width:48px;--file-viewer-floating-button-height:32px;--file-viewer-floating-icon-button-size:32px;--file-viewer-floating-zoom-meter-min-width:54px;--file-viewer-search-input-height:30px;--file-viewer-search-input-padding:0 10px;--file-viewer-search-button-min-width:32px;--file-viewer-search-button-padding:0 8px;--file-viewer-search-count-min-width:42px;--file-viewer-floating-search-input-height:32px;--file-viewer-focus-ring:rgba(31,157,103,.22);--file-viewer-z-toolbar:20;--file-viewer-z-floating-toolbar:30}
219
- :host([theme='dark']){--file-viewer-toolbar-bg:rgba(15,23,42,.9);--file-viewer-toolbar-border:rgba(148,163,184,.18);--file-viewer-button-color:#d7dee8;--file-viewer-input-bg:rgba(15,23,42,.78);--file-viewer-input-color:#f8fafc;--file-viewer-muted:#cbd5e1}
223
+ :host{display:block;width:100%;height:100%;min-width:0;min-height:0;contain:content;--file-viewer-bg:transparent;--file-viewer-content-bg:transparent;--file-viewer-text:#172033;--file-viewer-muted:#607282;--file-viewer-font:14px/1.45 system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif;--file-viewer-border:rgba(20,35,53,.08);--file-viewer-toolbar-bg:rgba(255,255,255,.92);--file-viewer-toolbar-border:rgba(20,35,53,.06);--file-viewer-toolbar-shadow:0 18px 44px rgba(15,23,42,.16);--file-viewer-toolbar-radius:999px;--file-viewer-toolbar-gap:6px;--file-viewer-toolbar-min-height:45px;--file-viewer-toolbar-padding:6px 10px;--file-viewer-toolbar-floating-min-height:42px;--file-viewer-toolbar-floating-padding:6px;--file-viewer-toolbar-floating-offset:16px;--file-viewer-group-bg:rgba(20,35,53,.035);--file-viewer-group-border:rgba(20,35,53,.08);--file-viewer-group-gap:2px;--file-viewer-group-padding:2px;--file-viewer-button-color:#40546a;--file-viewer-button-hover-bg:rgba(33,163,102,.1);--file-viewer-button-hover-color:#16774c;--file-viewer-button-disabled-color:#aab5c0;--file-viewer-button-radius:8px;--file-viewer-button-min-width:42px;--file-viewer-button-height:30px;--file-viewer-button-padding:0 10px;--file-viewer-icon-button-size:30px;--file-viewer-zoom-meter-min-width:48px;--file-viewer-zoom-meter-padding:0 8px;--file-viewer-floating-button-min-width:48px;--file-viewer-floating-button-height:32px;--file-viewer-floating-icon-button-size:32px;--file-viewer-floating-zoom-meter-min-width:54px;--file-viewer-search-input-height:30px;--file-viewer-search-input-padding:0 10px;--file-viewer-search-button-min-width:32px;--file-viewer-search-button-padding:0 8px;--file-viewer-search-count-min-width:42px;--file-viewer-floating-search-input-height:32px;--file-viewer-focus-ring:rgba(31,157,103,.22);--file-viewer-z-toolbar:20;--file-viewer-z-floating-toolbar:30}
224
+ :host([theme='dark']){--file-viewer-bg:#0f1720;--file-viewer-content-bg:#111b24;--file-viewer-text:#e5eef8;--file-viewer-muted:#cbd5e1;--file-viewer-border:rgba(148,163,184,.18);--file-viewer-toolbar-bg:rgba(15,23,42,.9);--file-viewer-toolbar-border:rgba(148,163,184,.18);--file-viewer-group-bg:rgba(148,163,184,.1);--file-viewer-group-border:rgba(148,163,184,.16);--file-viewer-button-color:#d7dee8;--file-viewer-button-hover-bg:rgba(45,212,191,.14);--file-viewer-button-hover-color:#5eead4;--file-viewer-button-disabled-color:#64748b;--file-viewer-input-bg:rgba(15,23,42,.78);--file-viewer-input-color:#f8fafc}
220
225
  *,*::before,*::after{box-sizing:border-box}
221
226
  .file-viewer-web-shell{position:relative;width:100%;height:100%;min-height:0;display:flex;flex-direction:column;overflow:hidden;background:var(--file-viewer-bg);color:var(--file-viewer-text);font:var(--file-viewer-font);letter-spacing:0;box-sizing:border-box;contain:content}
222
227
  .file-viewer-web-shell[data-viewer-density="compact"]{--file-viewer-toolbar-gap:3px;--file-viewer-toolbar-min-height:34px;--file-viewer-toolbar-padding:3px 5px;--file-viewer-toolbar-floating-min-height:32px;--file-viewer-toolbar-floating-padding:3px;--file-viewer-toolbar-floating-offset:10px;--file-viewer-group-gap:2px;--file-viewer-group-padding:2px;--file-viewer-button-radius:6px;--file-viewer-button-min-width:34px;--file-viewer-button-height:26px;--file-viewer-button-padding:0 6px;--file-viewer-icon-button-size:26px;--file-viewer-zoom-meter-min-width:42px;--file-viewer-zoom-meter-padding:0 5px;--file-viewer-floating-button-min-width:38px;--file-viewer-floating-button-height:28px;--file-viewer-floating-icon-button-size:28px;--file-viewer-floating-zoom-meter-min-width:46px;--file-viewer-search-input-height:26px;--file-viewer-search-input-padding:0 8px;--file-viewer-search-button-min-width:28px;--file-viewer-search-button-padding:0 6px;--file-viewer-search-count-min-width:36px;--file-viewer-floating-search-input-height:28px}
223
- .file-viewer-web-content{position:relative;flex:1 1 auto;min-height:0;min-width:0;overflow:auto;overscroll-behavior:contain}
228
+ .file-viewer-web-content{position:relative;flex:1 1 auto;min-height:0;min-width:0;overflow:auto;overscroll-behavior:contain;background:var(--file-viewer-content-bg)}
224
229
  .file-viewer-web-toolbar{flex:0 0 auto;min-height:var(--file-viewer-toolbar-min-height);display:inline-flex;align-items:center;justify-content:flex-end;gap:var(--file-viewer-toolbar-gap);padding:var(--file-viewer-toolbar-padding);border-bottom:1px solid var(--file-viewer-toolbar-border);background:var(--file-viewer-toolbar-bg);box-sizing:border-box;z-index:var(--file-viewer-z-toolbar)}
225
230
  .file-viewer-web-toolbar[hidden]{display:none!important}
226
231
  .file-viewer-web-toolbar[data-toolbar-position="top-center"]{justify-content:center}
@@ -232,6 +237,14 @@ const WEB_VIEWER_STYLE = `
232
237
  .file-viewer-web-toolbar .file-viewer-web-icon-button{width:var(--file-viewer-icon-button-size);min-width:var(--file-viewer-icon-button-size);padding:0;display:inline-flex;align-items:center;justify-content:center}
233
238
  .file-viewer-web-toolbar .file-viewer-web-zoom-meter{min-width:var(--file-viewer-zoom-meter-min-width);height:var(--file-viewer-button-height);padding:var(--file-viewer-zoom-meter-padding);display:inline-flex;align-items:center;justify-content:center;box-sizing:border-box;color:var(--file-viewer-button-color)}
234
239
  .file-viewer-web-toolbar .file-viewer-web-zoom-meter--readonly{font-size:12px;font-weight:800;line-height:1;white-space:nowrap}
240
+ .file-viewer-web-print-menu{position:relative;display:inline-flex}
241
+ .file-viewer-web-print-menu > button{min-width:var(--file-viewer-button-min-width);height:var(--file-viewer-button-height);padding:var(--file-viewer-button-padding);border:0;border-radius:var(--file-viewer-button-radius);background:transparent;color:var(--file-viewer-button-color);font:inherit;font-size:12px;font-weight:800;line-height:1;letter-spacing:0;white-space:nowrap;cursor:pointer}
242
+ .file-viewer-web-print-menu > button:hover:not(:disabled){background:var(--file-viewer-button-hover-bg);color:var(--file-viewer-button-hover-color)}
243
+ .file-viewer-web-print-menu > button:disabled{color:var(--file-viewer-button-disabled-color);cursor:not-allowed}
244
+ .file-viewer-web-print-menu-panel{position:absolute;top:calc(100% + 4px);right:0;z-index:40;min-width:118px;padding:4px;border:1px solid var(--file-viewer-group-border);border-radius:10px;background:var(--file-viewer-toolbar-bg);box-shadow:var(--file-viewer-toolbar-shadow);display:none;flex-direction:column;gap:2px}
245
+ .file-viewer-web-print-menu[data-open="true"] .file-viewer-web-print-menu-panel{display:flex}
246
+ .file-viewer-web-print-menu-panel button{width:100%;min-width:0;justify-content:flex-start;text-align:left;border-radius:8px}
247
+ .file-viewer-web-toolbar[data-toolbar-position="bottom-right"] .file-viewer-web-print-menu-panel{top:auto;bottom:calc(100% + 6px);z-index:50}
235
248
  .file-viewer-web-search{gap:4px}
236
249
  .file-viewer-web-search input{width:clamp(128px,18vw,220px);height:var(--file-viewer-search-input-height);box-sizing:border-box;border:0;border-radius:var(--file-viewer-toolbar-radius);padding:var(--file-viewer-search-input-padding);background:var(--file-viewer-input-bg);color:var(--file-viewer-input-color);font:inherit;font-size:12px;line-height:var(--file-viewer-search-input-height);letter-spacing:0;outline:0}
237
250
  .file-viewer-web-search input:focus{box-shadow:0 0 0 2px var(--file-viewer-focus-ring)}
@@ -242,9 +255,9 @@ const WEB_VIEWER_STYLE = `
242
255
  .file-viewer-web-toolbar[data-toolbar-position="bottom-right"] .file-viewer-web-zoom-meter{min-width:var(--file-viewer-floating-zoom-meter-min-width);height:var(--file-viewer-floating-button-height)}
243
256
  .file-viewer-web-toolbar[data-toolbar-position="bottom-right"] .file-viewer-web-search button{min-width:var(--file-viewer-search-button-min-width);height:var(--file-viewer-floating-search-input-height)}
244
257
  .file-viewer-web-toolbar[data-toolbar-position="bottom-right"] .file-viewer-web-search input{height:var(--file-viewer-floating-search-input-height);line-height:var(--file-viewer-floating-search-input-height);width:clamp(120px,18vw,190px)}
245
- .file-viewer-web-shell[data-viewer-theme='dark']{--file-viewer-toolbar-bg:rgba(15,23,42,.9);--file-viewer-toolbar-border:rgba(148,163,184,.18);--file-viewer-button-color:#d7dee8;--file-viewer-input-bg:rgba(15,23,42,.78);--file-viewer-input-color:#f8fafc;--file-viewer-muted:#cbd5e1}
246
- @media (prefers-color-scheme:dark){.file-viewer-web-shell[data-viewer-theme='system']{--file-viewer-toolbar-bg:rgba(15,23,42,.9);--file-viewer-toolbar-border:rgba(148,163,184,.18);--file-viewer-button-color:#d7dee8;--file-viewer-input-bg:rgba(15,23,42,.78);--file-viewer-input-color:#f8fafc;--file-viewer-muted:#cbd5e1}}
247
- @media (max-width:640px){.file-viewer-web-toolbar{max-width:100%;overflow-x:auto}.file-viewer-web-toolbar[data-toolbar-position="bottom-right"]{max-width:calc(100% - 32px)}.file-viewer-web-search input{width:120px}}
258
+ .file-viewer-web-shell[data-viewer-theme='dark']{color-scheme:dark;--file-viewer-bg:#0f1720;--file-viewer-content-bg:#111b24;--file-viewer-text:#e5eef8;--file-viewer-muted:#cbd5e1;--file-viewer-border:rgba(148,163,184,.18);--file-viewer-toolbar-bg:rgba(15,23,42,.9);--file-viewer-toolbar-border:rgba(148,163,184,.18);--file-viewer-group-bg:rgba(148,163,184,.1);--file-viewer-group-border:rgba(148,163,184,.16);--file-viewer-button-color:#d7dee8;--file-viewer-button-hover-bg:rgba(45,212,191,.14);--file-viewer-button-hover-color:#5eead4;--file-viewer-button-disabled-color:#64748b;--file-viewer-input-bg:rgba(15,23,42,.78);--file-viewer-input-color:#f8fafc}
259
+ @media (prefers-color-scheme:dark){.file-viewer-web-shell[data-viewer-theme='system']{color-scheme:dark;--file-viewer-bg:#0f1720;--file-viewer-content-bg:#111b24;--file-viewer-text:#e5eef8;--file-viewer-muted:#cbd5e1;--file-viewer-border:rgba(148,163,184,.18);--file-viewer-toolbar-bg:rgba(15,23,42,.9);--file-viewer-toolbar-border:rgba(148,163,184,.18);--file-viewer-group-bg:rgba(148,163,184,.1);--file-viewer-group-border:rgba(148,163,184,.16);--file-viewer-button-color:#d7dee8;--file-viewer-button-hover-bg:rgba(45,212,191,.14);--file-viewer-button-hover-color:#5eead4;--file-viewer-button-disabled-color:#64748b;--file-viewer-input-bg:rgba(15,23,42,.78);--file-viewer-input-color:#f8fafc}}
260
+ @media (max-width:640px){.file-viewer-web-toolbar{max-width:100%;overflow-x:auto;overflow-y:visible}.file-viewer-web-toolbar[data-toolbar-position="bottom-right"]{max-width:calc(100% - 32px);overflow:visible}.file-viewer-web-toolbar[data-toolbar-position="bottom-right"] .file-viewer-web-print-menu-panel{left:50%;right:auto;transform:translateX(-50%);min-width:min(148px,calc(100vw - 32px))}.file-viewer-web-search input{width:120px}}
248
261
  `;
249
262
  const addPart = (element, ...parts) => {
250
263
  const partList = element.part;
@@ -495,24 +508,30 @@ export const mountViewer = (container, initialOptions = {}, coreOptions = {}) =>
495
508
  else {
496
509
  group.appendChild(createReadonlyMeter(documentRef, zoomState.label, 'file-viewer-web-zoom-meter'));
497
510
  }
498
- if (availability.zoomIn) {
499
- const button = createButton(documentRef, '+', 'file-viewer-web-icon-button', () => controller === null || controller === void 0 ? void 0 : controller.zoomIn());
500
- button.title = t('toolbar.zoomIn');
501
- button.setAttribute('aria-label', t('toolbar.zoomIn'));
511
+ if (availability.zoomReset) {
512
+ // Placed before the zoom-in button (not after) so that toggling this
513
+ // button's visibility never shifts the zoom-in button's position: the
514
+ // toolbar group is right-aligned, and both icon buttons share the same
515
+ // width, so inserting "1:1" after "+" would make it land exactly on
516
+ // top of the previous "+" position, turning a repeated zoom-in click
517
+ // into an accidental reset (see GitHub issue #88).
518
+ const button = createButton(documentRef, '1:1', 'file-viewer-web-icon-button', () => controller === null || controller === void 0 ? void 0 : controller.resetZoom());
519
+ button.title = t('toolbar.zoomReset');
520
+ button.setAttribute('aria-label', t('toolbar.zoomReset'));
502
521
  button.disabled = isFileViewerZoomButtonDisabled({
503
- action: 'canZoomIn',
522
+ action: 'canReset',
504
523
  availability,
505
524
  toolbarDisabled,
506
525
  zoomState,
507
526
  });
508
527
  group.appendChild(button);
509
528
  }
510
- if (availability.zoomReset) {
511
- const button = createButton(documentRef, '1:1', 'file-viewer-web-icon-button', () => controller === null || controller === void 0 ? void 0 : controller.resetZoom());
512
- button.title = t('toolbar.zoomReset');
513
- button.setAttribute('aria-label', t('toolbar.zoomReset'));
529
+ if (availability.zoomIn) {
530
+ const button = createButton(documentRef, '+', 'file-viewer-web-icon-button', () => controller === null || controller === void 0 ? void 0 : controller.zoomIn());
531
+ button.title = t('toolbar.zoomIn');
532
+ button.setAttribute('aria-label', t('toolbar.zoomIn'));
514
533
  button.disabled = isFileViewerZoomButtonDisabled({
515
- action: 'canReset',
534
+ action: 'canZoomIn',
516
535
  availability,
517
536
  toolbarDisabled,
518
537
  zoomState,
@@ -543,7 +562,48 @@ export const mountViewer = (container, initialOptions = {}, coreOptions = {}) =>
543
562
  appendToolbarButton(visibleToolbar.download, t('toolbar.download'), t('toolbar.downloadTitle'), () => controller === null || controller === void 0 ? void 0 : controller.downloadOriginalFile());
544
563
  }
545
564
  else if (item === 'print') {
546
- appendToolbarButton(visibleToolbar.print, t('toolbar.print'), t('toolbar.printTitle'), () => controller === null || controller === void 0 ? void 0 : controller.printRenderedHtml());
565
+ if (!visibleToolbar.print) {
566
+ return;
567
+ }
568
+ const menu = documentRef.createElement('div');
569
+ menu.className = 'file-viewer-web-print-menu';
570
+ addPart(menu, 'toolbar-group');
571
+ const trigger = createButton(documentRef, t('toolbar.print'), '', () => {
572
+ menu.dataset.open = menu.dataset.open === 'true' ? 'false' : 'true';
573
+ });
574
+ trigger.title = t('toolbar.printTitle');
575
+ trigger.setAttribute('aria-label', t('toolbar.printTitle'));
576
+ trigger.setAttribute('aria-haspopup', 'menu');
577
+ trigger.disabled = toolbarDisabled;
578
+ const panel = documentRef.createElement('div');
579
+ panel.className = 'file-viewer-web-print-menu-panel';
580
+ panel.setAttribute('role', 'menu');
581
+ const closeMenu = () => {
582
+ menu.dataset.open = 'false';
583
+ };
584
+ const directButton = createButton(documentRef, t('toolbar.printDirect'), '', async () => {
585
+ closeMenu();
586
+ await (controller === null || controller === void 0 ? void 0 : controller.printRenderedHtml());
587
+ });
588
+ directButton.title = t('toolbar.printTitle');
589
+ directButton.setAttribute('role', 'menuitem');
590
+ directButton.disabled = toolbarDisabled;
591
+ const maskButton = createButton(documentRef, t('toolbar.printMask'), '', async () => {
592
+ closeMenu();
593
+ await (controller === null || controller === void 0 ? void 0 : controller.printWithMask());
594
+ });
595
+ maskButton.title = t('toolbar.printMaskTitle');
596
+ maskButton.setAttribute('role', 'menuitem');
597
+ maskButton.disabled = toolbarDisabled;
598
+ panel.append(directButton, maskButton);
599
+ menu.append(trigger, panel);
600
+ menu.addEventListener('focusout', event => {
601
+ const next = event.relatedTarget;
602
+ if (!next || !menu.contains(next)) {
603
+ closeMenu();
604
+ }
605
+ });
606
+ toolbarEl.appendChild(menu);
547
607
  }
548
608
  else if (item === 'exportHtml') {
549
609
  appendToolbarButton(visibleToolbar.exportHtml, t('toolbar.exportHtml'), t('toolbar.exportHtmlTitle'), () => controller === null || controller === void 0 ? void 0 : controller.exportRenderedHtml());
@@ -704,8 +764,11 @@ export const mountViewer = (container, initialOptions = {}, coreOptions = {}) =>
704
764
  downloadOriginalFile() {
705
765
  return callApi(instance, api => api.download(), undefined);
706
766
  },
707
- printRenderedHtml() {
708
- return callApi(instance, api => api.print(), undefined);
767
+ printRenderedHtml(options) {
768
+ return callApi(instance, api => api.print(options), undefined);
769
+ },
770
+ printWithMask(options) {
771
+ return callApi(instance, api => api.printWithMask(options), undefined);
709
772
  },
710
773
  exportRenderedHtml() {
711
774
  return callApi(instance, api => api.exportHtml({ download: true }).then(() => undefined), undefined);
package/dist/element.d.ts CHANGED
@@ -1,4 +1,5 @@
1
1
  import { type FileRef, type ViewerController, type ViewerControllerHandle, type ViewerCoreOptions, type ViewerEvent, type ViewerFitMode, type ViewerFitOptions, type ViewerMountOptions, type ViewerOptions, type ViewerState, type ViewerStateListener, type ViewerUiDensity } from './controller.js';
2
+ import type { FileViewerPrintOptions } from '@file-viewer/core';
2
3
  export declare const FILE_VIEWER_ELEMENT_TAG = "flyfish-file-viewer";
3
4
  export type FileViewerElementEventName = 'viewer-ready' | 'viewer-event' | 'viewer-state-change' | 'viewer-error';
4
5
  export interface FileViewerElementReadyDetail {
@@ -64,7 +65,8 @@ export declare class FileViewerElement extends ElementBase implements ViewerCont
64
65
  getController(): ViewerController | null;
65
66
  getApi(): ReturnType<ViewerControllerHandle['getApi']>;
66
67
  downloadOriginalFile(): Promise<void>;
67
- printRenderedHtml(): Promise<void>;
68
+ printRenderedHtml(options?: FileViewerPrintOptions): Promise<void>;
69
+ printWithMask(options?: FileViewerPrintOptions): Promise<void>;
68
70
  exportRenderedHtml(): Promise<void>;
69
71
  zoomIn(): ReturnType<ViewerControllerHandle['zoomIn']>;
70
72
  zoomOut(): ReturnType<ViewerControllerHandle['zoomOut']>;
package/dist/element.js CHANGED
@@ -287,9 +287,13 @@ export class FileViewerElement extends ElementBase {
287
287
  var _a, _b;
288
288
  return (_b = (_a = this.controller) === null || _a === void 0 ? void 0 : _a.downloadOriginalFile()) !== null && _b !== void 0 ? _b : Promise.resolve();
289
289
  }
290
- printRenderedHtml() {
290
+ printRenderedHtml(options) {
291
291
  var _a, _b;
292
- return (_b = (_a = this.controller) === null || _a === void 0 ? void 0 : _a.printRenderedHtml()) !== null && _b !== void 0 ? _b : Promise.resolve();
292
+ return (_b = (_a = this.controller) === null || _a === void 0 ? void 0 : _a.printRenderedHtml(options)) !== null && _b !== void 0 ? _b : Promise.resolve();
293
+ }
294
+ printWithMask(options) {
295
+ var _a, _b;
296
+ return (_b = (_a = this.controller) === null || _a === void 0 ? void 0 : _a.printWithMask(options)) !== null && _b !== void 0 ? _b : Promise.resolve();
293
297
  }
294
298
  exportRenderedHtml() {
295
299
  var _a, _b;