@file-viewer/core 2.3.0 → 3.0.0

package/dist/features/printMask.js

@@ -1,4 +1,16 @@
 const clampPercent = (value) => Math.max(0, Math.min(100, value));
+const normalizeMaskColor = (value) => {
+    if (typeof value !== 'string') {
+        return '#000000';
+    }
+    const color = value.trim();
+    if (/^#(?:[0-9a-f]{3}|[0-9a-f]{4}|[0-9a-f]{6}|[0-9a-f]{8})$/i.test(color) ||
+        /^[a-z]{1,32}$/i.test(color) ||
+        /^(?:rgb|rgba|hsl|hsla)\([0-9.,%+\- /]+\)$/i.test(color)) {
+        return color;
+    }
+    return '#000000';
+};
 export const normalizeFileViewerPrintMaskRegion = (region) => {
     if (!region) {
         return null;
@@ -77,7 +89,7 @@ export const normalizeFileViewerPrintMaskOptions = (mask) => {
     return {
         ...(regions.length ? { regions } : {}),
         ...(stamps.length ? { stamps } : {}),
-        color: mask.color || '#000000',
+        color: normalizeMaskColor(mask.color),
     };
 };
 const escapeHtmlAttribute = (value) => value
@@ -108,6 +120,97 @@ export const FILE_VIEWER_PRINT_MASK_STYLE = `
   .viewer-export-print-stamp{position:absolute;display:block;object-fit:contain;transform-origin:center center;print-color-adjust:exact;-webkit-print-color-adjust:exact;}
   [data-viewer-print-page-index]{position:relative!important;isolation:isolate;}
 `;
+const isAsciiWhitespace = (value) => (value === ' ' || value === '\t' || value === '\n' || value === '\r' || value === '\f');
+const isAsciiLetter = (value) => {
+    const code = value.charCodeAt(0);
+    return (code >= 65 && code <= 90) || (code >= 97 && code <= 122);
+};
+const findOpeningTagEnd = (html, start) => {
+    let quote = '';
+    for (let index = start + 1; index < html.length; index += 1) {
+        const char = html[index];
+        if (quote) {
+            if (char === quote) {
+                quote = '';
+            }
+            continue;
+        }
+        if (char === '"' || char === "'") {
+            quote = char;
+        }
+        else if (char === '>') {
+            return index;
+        }
+    }
+    return -1;
+};
+const parseNonNegativeInteger = (value) => {
+    if (!value) {
+        return null;
+    }
+    for (let index = 0; index < value.length; index += 1) {
+        const code = value.charCodeAt(index);
+        if (code < 48 || code > 57) {
+            return null;
+        }
+    }
+    const parsed = Number(value);
+    return Number.isSafeInteger(parsed) ? parsed : null;
+};
+const readPrintPageIndex = (html, start, end) => {
+    let cursor = start + 1;
+    while (cursor < end && !isAsciiWhitespace(html[cursor]) && html[cursor] !== '/' && html[cursor] !== '>') {
+        cursor += 1;
+    }
+    while (cursor < end) {
+        while (cursor < end && isAsciiWhitespace(html[cursor])) {
+            cursor += 1;
+        }
+        if (cursor >= end || html[cursor] === '/' || html[cursor] === '>') {
+            return null;
+        }
+        const nameStart = cursor;
+        while (cursor < end &&
+            !isAsciiWhitespace(html[cursor]) &&
+            html[cursor] !== '=' &&
+            html[cursor] !== '/' &&
+            html[cursor] !== '>') {
+            cursor += 1;
+        }
+        const name = html.slice(nameStart, cursor).toLowerCase();
+        while (cursor < end && isAsciiWhitespace(html[cursor])) {
+            cursor += 1;
+        }
+        if (html[cursor] !== '=') {
+            continue;
+        }
+        cursor += 1;
+        while (cursor < end && isAsciiWhitespace(html[cursor])) {
+            cursor += 1;
+        }
+        const quote = html[cursor];
+        if (quote !== '"' && quote !== "'") {
+            while (cursor < end && !isAsciiWhitespace(html[cursor]) && html[cursor] !== '>') {
+                cursor += 1;
+            }
+            continue;
+        }
+        cursor += 1;
+        const valueStart = cursor;
+        while (cursor < end && html[cursor] !== quote) {
+            cursor += 1;
+        }
+        if (cursor >= end) {
+            return null;
+        }
+        const value = html.slice(valueStart, cursor);
+        cursor += 1;
+        if (name === 'data-viewer-print-page-index') {
+            return parseNonNegativeInteger(value);
+        }
+    }
+    return null;
+};
 export const applyFileViewerPagePrintMasksToHtml = (contentHtml, mask) => {
     var _a, _b;
     const normalized = normalizeFileViewerPrintMaskOptions(mask);
@@ -135,16 +238,38 @@ export const applyFileViewerPagePrintMasksToHtml = (contentHtml, mask) => {
     if (!regionsByPage.size && !stampsByPage.size) {
         return contentHtml;
     }
-    return contentHtml.replace(/(<[A-Za-z][^>]*\sdata-viewer-print-page-index=(['"])(\d+)\2[^>]*>)/g, (match, openingTag, _quote, rawPageIndex) => {
-        const pageRegions = regionsByPage.get(Number(rawPageIndex));
-        const pageStamps = stampsByPage.get(Number(rawPageIndex));
-        if (!(pageRegions === null || pageRegions === void 0 ? void 0 : pageRegions.length) && !(pageStamps === null || pageStamps === void 0 ? void 0 : pageStamps.length)) {
-            return match;
-        }
-        return `${openingTag}${buildFileViewerPrintMaskOverlayHtml({
-            regions: pageRegions || [],
-            stamps: pageStamps || [],
-            color: normalized.color,
-        }, true)}`;
-    });
+    const chunks = [];
+    let copiedThrough = 0;
+    let cursor = 0;
+    while (cursor < contentHtml.length) {
+        const start = contentHtml.indexOf('<', cursor);
+        if (start < 0) {
+            break;
+        }
+        if (!isAsciiLetter(contentHtml[start + 1] || '')) {
+            cursor = start + 1;
+            continue;
+        }
+        const end = findOpeningTagEnd(contentHtml, start);
+        if (end < 0) {
+            break;
+        }
+        const pageIndex = readPrintPageIndex(contentHtml, start, end);
+        const pageRegions = pageIndex === null ? undefined : regionsByPage.get(pageIndex);
+        const pageStamps = pageIndex === null ? undefined : stampsByPage.get(pageIndex);
+        if ((pageRegions === null || pageRegions === void 0 ? void 0 : pageRegions.length) || (pageStamps === null || pageStamps === void 0 ? void 0 : pageStamps.length)) {
+            chunks.push(contentHtml.slice(copiedThrough, end + 1), buildFileViewerPrintMaskOverlayHtml({
+                regions: pageRegions || [],
+                stamps: pageStamps || [],
+                color: normalized.color,
+            }, true));
+            copiedThrough = end + 1;
+        }
+        cursor = end + 1;
+    }
+    if (!chunks.length) {
+        return contentHtml;
+    }
+    chunks.push(contentHtml.slice(copiedThrough));
+    return chunks.join('');
 };

package/dist/index.d.ts

@@ -15,8 +15,9 @@ export type { ApplyInitialFileViewerFitOptions, CreateFileViewerFitControllerOpt
 export { cloneFileViewerViewState, createFileViewerViewStateChange, createFileViewerViewStateChangeEmitter, createFileViewerViewStateController, createFileViewerViewStateControllerActionHandlers, registerFileViewerGenericViewStateProvider, } from './features/document/viewState';
 export type { CreateFileViewerViewStateControllerOptions, FileViewerGenericViewStateProviderRegistration, FileViewerViewStateController, FileViewerViewStateControllerActionHandlers, RegisterFileViewerGenericViewStateProviderOptions, } from './features/document/viewState';
 export { DEFAULT_FILE_VIEWER_ANCHOR_EXCLUDE_SELECTOR, DEFAULT_FILE_VIEWER_ANCHOR_SELECTOR, DEFAULT_FILE_VIEWER_SCROLL_CONTAINER_CANDIDATE_SELECTOR, DEFAULT_FILE_VIEWER_SCROLL_CONTAINER_SELECTOR, DEFAULT_FILE_VIEWER_SCROLLABLE_OVERFLOW_VALUES, collectFileViewerDocumentAnchors, findFileViewerAnchorForElement, findFileViewerSearchProvider, findFileViewerViewStateProvider, findFileViewerZoomProvider, getCurrentFileViewerDocumentAnchor, getFileViewerScrollableRange, isFileViewerScrollableElement, registerFileViewerSearchProvider, registerFileViewerViewStateProvider, registerFileViewerZoomProvider, resolveFileViewerScrollContainer, scrollToFileViewerDocumentAnchor, unregisterFileViewerSearchProvider, unregisterFileViewerViewStateProvider, unregisterFileViewerZoomProvider, } from './features/document/dom';
-export { buildFileViewerRenderedHtmlDocument, buildExportHtmlDocument, collectDocumentStyles, prepareFileViewerRenderedContentForSnapshot, inlineFileViewerBlobUrlsInHtml, replaceFileViewerCanvasWithImages, resolveFileViewerPrintStyle, triggerFileViewerBlobDownload, triggerFileViewerUrlDownload, waitForFileViewerImages, waitForFileViewerNextPaint, waitForFileViewerPrintWindowReady, } from './output/export';
+export { prepareFileViewerRenderedContentForSnapshot, inlineFileViewerBlobUrlsInHtml, replaceFileViewerCanvasWithImages, resolveFileViewerPrintStyle, triggerFileViewerBlobDownload, triggerFileViewerUrlDownload, waitForFileViewerImages, waitForFileViewerNextPaint, waitForFileViewerPrintWindowReady, } from './output/export';
 export { applyPrintPageSize, buildPrintPageStyle, formatCssPixels, getElementPrintPageSize, } from './output/printLayout';
+export { assertFileViewerMermaidSourceHasNoExternalResources, sanitizeFileViewerSvgCss, sanitizeFileViewerSvgResources, } from './security/svgResources';
 export type { ApplyPrintPageSizeOptions, BuildPrintPageStyleOptions, PrintPageSize, } from './output/printLayout';
 export { DEFAULT_FILE_VIEWER_DOWNLOAD_FILENAME, DEFAULT_FILE_VIEWER_EXPORT_FILENAME, DEFAULT_FILE_VIEWER_PREVIEW_TITLE, FILE_VIEWER_OPERATION_ACTION_ERROR_PREFIXES, createFileViewerOperationActionHandlers, createFileViewerOriginalSourceState, createFileViewerOriginalSourceStateFromNormalizedSource, createFileViewerPublicOperationActionHandlers, executeFileViewerDownloadOperation, executeFileViewerExportHtmlOperation, executeFileViewerPrintOperation, hasFileViewerOriginalSource, resolveFileViewerDisplayFilename, resolveFileViewerOperationActionErrorMessage, resolveFileViewerOperationFilename, resolveFileViewerOriginalFilename, } from './viewer/operations';
 export { FILE_VIEWER_BUILTIN_MESSAGES, FILE_VIEWER_DEFAULT_LOCALE, FILE_VIEWER_FALLBACK_LOCALE, FILE_VIEWER_SUPPORTED_LOCALES, createFileViewerTranslator, formatFileViewerMessage, normalizeFileViewerLocale, resolveFileViewerLocale, translateFileViewerMessage, } from './i18n/messages';
@@ -88,6 +89,6 @@ export type { FileViewerSearchProviderHost, ResolveFileViewerScrollContainerOpti
 export type { CreateFileViewerDomSearchControllerOptions, FileViewerInternalSearchMatch, } from './features/document/search';
 export type { CreateFileViewerZoomControllerOptions, FileViewerZoomOperation, } from './features/document/zoom';
 export type { CreateViewerOptions } from './viewer/createViewer';
-export type { BuildExportHtmlDocumentOptions, BuildFileViewerRenderedHtmlDocumentOptions, } from './output/export';
+export type { BuildExportHtmlDocumentOptions, BuildFileViewerRenderedHtmlDocumentOptions, } from './exportDocument';
 export type { CreateFileViewerWorkerControllerOptions, FileViewerWorkerContext, FileViewerWorkerController, FileViewerWorkerErrorHook, FileViewerWorkerEventHandler, FileViewerWorkerFactory, FileViewerWorkerMessageHook, WorkerProvider, WorkerRef, } from './platform/worker';
 export type { FileViewerAiOptions, FileViewerArchiveEntryActionContext, FileViewerArchiveEntryActionPolicy, FileViewerArchiveEntryActionsOptions, FileViewerArchivePasswordRequestContext, FileViewerArchivePasswordRequestReason, FileViewerArchiveOptions, FileViewerApplyViewStateOptions, FileViewerBeforeOperation, FileViewerCadDwfLineWeightMode, FileViewerCadOptions, FileViewerCadRenderer, FileViewerModelLinearUnit, FileViewerModelOptions, FileViewerComponentEmits, FileViewerComponentEventMap, FileViewerComponentProps, FileViewerDocumentAnchor, FileViewerDocumentChunk, FileViewerDownloadOptions, FileViewerDocxOptions, FileViewerDrawingOptions, FileViewerEvent, FileViewerEventHandler, FileViewerEventType, FileViewerExportHtmlOptions, FileViewerFileRef, FileViewerFitMode, FileViewerFitOptions, FileViewerFitRequest, FileViewerFitResize, FileViewerFitResult, FileViewerFormatStatus, FileViewerFormatSupportLevel, FileViewerGeoBasemapOptions, FileViewerGeoBasemapPreset, FileViewerGeoOptions, FileViewerTiandituMapStyle, FileRenderContext, FileRenderExportAdapter, FileRenderThumbnailAdapter, FileRenderExportMode, FileRenderExportOptions, FileRenderHandler, FileRenderHandlerComposite, FileViewerBuiltinRendererPreset, FileViewerInstance, FileViewerLoadOptions, FileViewerLifecycleContext, FileViewerLifecycleHooks, FileViewerLifecyclePhase, FileViewerI18nOptions, FileViewerIworkEmbeddedPreviewMode, FileViewerIworkOptions, FileViewerHangulOptions, FileViewerDiagnostic, FileViewerLocale, FileViewerMessageKey, FileViewerMessageParams, FileViewerMessageResolver, FileViewerMessages, FileViewerNavigationState, FileViewerOperationAvailability, FileViewerOperationContext, FileViewerOperationType, FileViewerOptions, FileViewerPdfBoundingBox, FileViewerPdfBoundingBoxOrigin, FileViewerPdfBoundingBoxUnit, FileViewerPdfOptions, FileViewerPresentationOptions, FileViewerPrintOptions, FileViewerPrintMaskOptions, FileViewerPrintMaskRegion, FileViewerPrintStamp, FileViewerPublicApi, FileViewerRenderedInstance, FileViewerRendererMode, FileViewerRendererPluginAssetKind, FileViewerRendererPluginAssetManifest, FileViewerRendererPluginAssetEntry, FileViewerRenderStateKind, FileViewerRenderPurpose, FileViewerRendererCategory, FileViewerRendererHandlerRegistration, FileViewerRendererInstallContext, FileViewerRendererPlugin, FileViewerRendererPluginInput, FileViewerRendererPresetInput, FileViewerRendererPresetName, FileViewerRendererPreset, FileViewerSearchMatch, FileViewerSearchOptions, FileViewerSearchProvider, FileViewerSearchState, FileViewerSource, FileViewerSourceKind, FileViewerThumbnailCaptureOptions, FileViewerThumbnailFit, FileViewerThumbnailFormat, FileViewerSpreadsheetOptions, FileViewerStateDescriptor, FileViewerStateTheme, FileViewerStyleIsolation, FileViewerTextOptions, FileViewerResolvedThemeMode, FileViewerThemeMode, FileViewerToolbarActionMap, FileViewerToolbarItem, FileViewerToolbarOptions, FileViewerToolbarPosition, FileViewerResolvedToolbarItem, FileViewerUiDensity, FileViewerUiOptions, FileViewerTypstOptions, FileViewerViewScrollState, FileViewerViewState, FileViewerViewStateChange, FileViewerViewStateChangeAction, FileViewerViewStateChangeSource, FileViewerViewStateProvider, FileViewerWatermarkOptions, FileViewerWordPerfectOptions, FileViewerZoomProvider, FileViewerZoomState, NormalizedFileViewerSource, RendererCapability, RendererDefinition, RendererPlugin, RendererLoadContext, RendererLoader, RendererRegistry, RendererSession, RenderSurface, ViewerCapabilityState, ViewerLifecycleContext, ViewerOperationContext, } from './contracts/types';

package/dist/index.js

@@ -8,8 +8,9 @@ export { applyFileViewerZoomState, clearFileViewerZoomControllerProvider, create
 export { FILE_VIEWER_FIT_MODES, FILE_VIEWER_FIT_RESIZE_MODES, createFileViewerFitController, hasFileViewerExplicitInitialViewState, isFileViewerFitMode, isFileViewerFitResize, normalizeFileViewerFitOptions, resolveFileViewerFitScale, } from './features/document/fit.js';
 export { cloneFileViewerViewState, createFileViewerViewStateChange, createFileViewerViewStateChangeEmitter, createFileViewerViewStateController, createFileViewerViewStateControllerActionHandlers, registerFileViewerGenericViewStateProvider, } from './features/document/viewState.js';
 export { DEFAULT_FILE_VIEWER_ANCHOR_EXCLUDE_SELECTOR, DEFAULT_FILE_VIEWER_ANCHOR_SELECTOR, DEFAULT_FILE_VIEWER_SCROLL_CONTAINER_CANDIDATE_SELECTOR, DEFAULT_FILE_VIEWER_SCROLL_CONTAINER_SELECTOR, DEFAULT_FILE_VIEWER_SCROLLABLE_OVERFLOW_VALUES, collectFileViewerDocumentAnchors, findFileViewerAnchorForElement, findFileViewerSearchProvider, findFileViewerViewStateProvider, findFileViewerZoomProvider, getCurrentFileViewerDocumentAnchor, getFileViewerScrollableRange, isFileViewerScrollableElement, registerFileViewerSearchProvider, registerFileViewerViewStateProvider, registerFileViewerZoomProvider, resolveFileViewerScrollContainer, scrollToFileViewerDocumentAnchor, unregisterFileViewerSearchProvider, unregisterFileViewerViewStateProvider, unregisterFileViewerZoomProvider, } from './features/document/dom/index.js';
-export { buildFileViewerRenderedHtmlDocument, buildExportHtmlDocument, collectDocumentStyles, prepareFileViewerRenderedContentForSnapshot, inlineFileViewerBlobUrlsInHtml, replaceFileViewerCanvasWithImages, resolveFileViewerPrintStyle, triggerFileViewerBlobDownload, triggerFileViewerUrlDownload, waitForFileViewerImages, waitForFileViewerNextPaint, waitForFileViewerPrintWindowReady, } from './output/export.js';
+export { prepareFileViewerRenderedContentForSnapshot, inlineFileViewerBlobUrlsInHtml, replaceFileViewerCanvasWithImages, resolveFileViewerPrintStyle, triggerFileViewerBlobDownload, triggerFileViewerUrlDownload, waitForFileViewerImages, waitForFileViewerNextPaint, waitForFileViewerPrintWindowReady, } from './output/export.js';
 export { applyPrintPageSize, buildPrintPageStyle, formatCssPixels, getElementPrintPageSize, } from './output/printLayout.js';
+export { assertFileViewerMermaidSourceHasNoExternalResources, sanitizeFileViewerSvgCss, sanitizeFileViewerSvgResources, } from './security/svgResources.js';
 export { DEFAULT_FILE_VIEWER_DOWNLOAD_FILENAME, DEFAULT_FILE_VIEWER_EXPORT_FILENAME, DEFAULT_FILE_VIEWER_PREVIEW_TITLE, FILE_VIEWER_OPERATION_ACTION_ERROR_PREFIXES, createFileViewerOperationActionHandlers, createFileViewerOriginalSourceState, createFileViewerOriginalSourceStateFromNormalizedSource, createFileViewerPublicOperationActionHandlers, executeFileViewerDownloadOperation, executeFileViewerExportHtmlOperation, executeFileViewerPrintOperation, hasFileViewerOriginalSource, resolveFileViewerDisplayFilename, resolveFileViewerOperationActionErrorMessage, resolveFileViewerOperationFilename, resolveFileViewerOriginalFilename, } from './viewer/operations.js';
 export { FILE_VIEWER_BUILTIN_MESSAGES, FILE_VIEWER_DEFAULT_LOCALE, FILE_VIEWER_FALLBACK_LOCALE, FILE_VIEWER_SUPPORTED_LOCALES, createFileViewerTranslator, formatFileViewerMessage, normalizeFileViewerLocale, resolveFileViewerLocale, translateFileViewerMessage, } from './i18n/messages.js';
 export { clearFileViewerAutoRendererPresets, collectFileViewerRendererPlugins, createRendererRegistry, findFileViewerAutoRendererPreset, getFileViewerAutoRendererPresetVersion, hasFileViewerRendererPresetName, installFileViewerRendererPlugins, listFileViewerAutoRendererPresetEntries, listFileViewerAutoRendererPresets, registerFileViewerAutoRendererPreset, resolveFileViewerRendererPresetInputs, unregisterFileViewerAutoRendererPreset, } from './registry/registry.js';

package/dist/output/export.d.ts

@@ -1,33 +1,12 @@
-import type { FileRenderExportAdapter, FileRenderExportMode, FileRenderExportOptions, FileViewerPrintMaskOptions } from '../contracts/types';
-export interface BuildExportHtmlDocumentOptions {
-    contentHtml: string;
-    includeDocumentStyles?: boolean;
-    printStyle?: string;
-    title: string;
-    watermarkInlineStyle?: string;
-    mask?: FileViewerPrintMaskOptions | null;
-}
-export declare const collectDocumentStyles: () => string;
-export declare const buildExportHtmlDocument: ({ contentHtml, includeDocumentStyles, printStyle, title, watermarkInlineStyle, mask, }: BuildExportHtmlDocumentOptions) => string;
-export interface BuildFileViewerRenderedHtmlDocumentOptions {
-    source: HTMLElement;
-    mode?: FileRenderExportMode;
-    title: string;
-    adapter?: FileRenderExportAdapter | null;
-    watermarkInlineStyle?: string;
-    mask?: FileViewerPrintMaskOptions | null;
-}
+import type { FileRenderExportAdapter, FileRenderExportOptions } from '../contracts/types';
+/** Lightweight export helpers that remain on the normal viewer path. */
 export declare const triggerFileViewerBlobDownload: (blob: Blob, name: string) => void;
 export declare const triggerFileViewerUrlDownload: (url: string, name: string) => void;
 export declare const replaceFileViewerCanvasWithImages: (source: HTMLElement, clone: HTMLElement) => void;
 export declare const waitForFileViewerNextPaint: (targetWindow?: Partial<Pick<Window, "requestAnimationFrame" | "setTimeout">>) => Promise<void>;
 export declare const waitForFileViewerImages: (root: ParentNode | null | undefined) => Promise<void>;
-/**
- * Rewrite ephemeral `blob:` URLs into portable `data:` URLs so exported / printed
- * HTML keeps images after leaving the live viewer document (GitHub #90).
- */
+/** Rewrite ephemeral blob URLs into portable data URLs for export and print. */
 export declare const inlineFileViewerBlobUrlsInHtml: (html: string) => Promise<string>;
 export declare const waitForFileViewerPrintWindowReady: (printWindow: Window) => Promise<void>;
 export declare const resolveFileViewerPrintStyle: (adapter: FileRenderExportAdapter | null, options: FileRenderExportOptions) => Promise<string>;
 export declare const prepareFileViewerRenderedContentForSnapshot: (source: HTMLElement, adapter?: FileRenderExportAdapter | null) => Promise<void>;
-export declare const buildFileViewerRenderedHtmlDocument: ({ source, mode, title, adapter, watermarkInlineStyle, mask, }: BuildFileViewerRenderedHtmlDocumentOptions) => Promise<string>;