@file-viewer/core 2.1.30 → 2.2.1

package/dist/renderers/image.js

@@ -19,15 +19,15 @@ const imageMimeMap = {
     webp: 'image/webp',
 };
 const imageStyle = `
-.image-viewer{position:relative;width:100%;height:100%;overflow:auto;background:#eef1f4;box-sizing:border-box}
+.image-viewer{position:relative;width:100%;height:100%;overflow:auto;background:var(--file-viewer-render-surface-background,#eef1f4);box-sizing:border-box}
 .image-stage{min-width:100%;min-height:100%;display:flex;align-items:center;justify-content:center;padding:24px;box-sizing:border-box}
 .image-stage img{display:block;width:auto;max-width:none;margin:0 auto;border:0;box-shadow:0 18px 48px rgba(15,23,42,.16);background:#fff;cursor:zoom-in}
 .image-lightbox{position:fixed;inset:0;z-index:2147483000;display:flex;align-items:center;justify-content:center;padding:40px;background:rgba(15,23,42,.88);box-sizing:border-box}
 .image-lightbox[hidden]{display:none}
 .image-lightbox img{display:block;max-width:100%;max-height:100%;object-fit:contain;background:#fff;box-shadow:0 30px 80px rgba(0,0,0,.4);cursor:zoom-out}
 .image-lightbox button{position:absolute;top:20px;right:20px;width:40px;height:40px;border:0;border-radius:999px;background:rgba(255,255,255,.92);color:#172033;font-size:24px;line-height:40px;cursor:pointer;box-shadow:0 12px 28px rgba(0,0,0,.18)}
-[data-viewer-theme='dark'] .image-viewer{background:#101820}
-@media (prefers-color-scheme:dark){[data-viewer-theme='system'] .image-viewer{background:#101820}}
+[data-viewer-theme='dark'] .image-viewer{background:var(--file-viewer-render-surface-background,#101820)}
+@media (prefers-color-scheme:dark){[data-viewer-theme='system'] .image-viewer{background:var(--file-viewer-render-surface-background,#101820)}}
 @media (max-width:767px){.image-stage{padding:12px}.image-lightbox{padding:16px}.image-lightbox button{top:12px;right:12px}}
 `;
 const createStyle = (documentRef) => {

package/dist/renderers/index.d.ts

@@ -33,9 +33,22 @@ export declare const coreLiteRendererDefinitions: ({
         readonly zoom: "provider";
         readonly search: true;
     };
+} | {
+    readonly id: "office-presentation-binary";
+    readonly label: "PowerPoint 97–2003";
+    readonly category: "office";
+    readonly extensions: readonly ["ppt"];
+    readonly async: true;
+    readonly capabilities: {
+        readonly download: true;
+        readonly print: "adapter";
+        readonly exportHtml: "adapter";
+        readonly zoom: "provider";
+        readonly search: false;
+    };
 } | {
     readonly id: "office-presentation";
-    readonly label: "PowerPoint";
+    readonly label: "PowerPoint OpenXML";
     readonly category: "office";
     readonly extensions: readonly ["pptx", "pptm", "potx", "potm", "ppsx", "ppsm"];
     readonly async: true;
@@ -63,7 +76,7 @@ export declare const coreLiteRendererDefinitions: ({
     readonly id: "spreadsheet-openxml";
     readonly label: "Spreadsheet";
     readonly category: "office";
-    readonly extensions: readonly ["xlsx", "xltx", "xlsm", "xlsb", "xls", "xlt", "xltm", "csv", "ods", "fods", "numbers"];
+    readonly extensions: readonly ["xlsx", "xltx", "xlsm", "xlsb", "xls", "xlt", "xltm", "csv", "tsv", "ods", "fods", "numbers"];
     readonly async: true;
     readonly capabilities: {
         readonly download: true;

package/dist/rendering/handler.d.ts

@@ -162,6 +162,14 @@ export interface CreateFileViewerRenderSurfaceActionHandlersInput<Session extend
     onRefreshViewStateProvider?: () => void;
 }
 export declare const DEFAULT_FILE_VIEWER_RENDER_TARGET_CLASS = "file-render";
+export declare const FILE_VIEWER_RENDER_SURFACE_BACKGROUND_PROPERTY = "--file-viewer-render-surface-background";
+export declare const normalizeFileViewerRenderSurfaceBackground: (value: unknown) => string | null;
+/**
+ * Keeps the public UI option and the renderer-facing CSS custom property in
+ * sync. Custom properties inherit through Shadow DOM, so setting this on the
+ * render host covers both scoped and shadow-isolated renderer targets.
+ */
+export declare const syncFileViewerRenderSurfaceBackground: (target: HTMLElement | null | undefined, options?: Pick<FileViewerOptions, "ui"> | null) => string | null;
 export declare const isFileViewerShadowRoot: (value: unknown) => value is ShadowRoot;
 export declare const getFileViewerShadowRootForNode: (node: Node | null | undefined) => ShadowRoot | null;
 export declare const normalizeFileViewerStyleIsolation: (isolation?: FileViewerStyleIsolation) => FileViewerStyleIsolation;

package/dist/rendering/handler.js

@@ -13,8 +13,35 @@ import { findFileViewerViewStateProvider } from '../features/document/dom/index.
 import { registerFileViewerGenericViewStateProvider } from '../features/document/viewState.js';
 export const FILE_VIEWER_RENDER_SESSION_DISPOSE_ERROR_MESSAGE = '预览内容卸载失败';
 export const DEFAULT_FILE_VIEWER_RENDER_TARGET_CLASS = 'file-render';
+export const FILE_VIEWER_RENDER_SURFACE_BACKGROUND_PROPERTY = '--file-viewer-render-surface-background';
 const FILE_VIEWER_RENDER_HOST_CLASS = 'file-render-host';
 const FILE_VIEWER_SHADOW_RENDER_TARGET_CLASS = 'file-render-shadow-target';
+export const normalizeFileViewerRenderSurfaceBackground = (value) => {
+    if (typeof value !== 'string') {
+        return null;
+    }
+    const normalized = value.trim();
+    return normalized && normalized.toLowerCase() !== 'auto' ? normalized : null;
+};
+/**
+ * Keeps the public UI option and the renderer-facing CSS custom property in
+ * sync. Custom properties inherit through Shadow DOM, so setting this on the
+ * render host covers both scoped and shadow-isolated renderer targets.
+ */
+export const syncFileViewerRenderSurfaceBackground = (target, options) => {
+    var _a;
+    if (!target) {
+        return null;
+    }
+    const background = normalizeFileViewerRenderSurfaceBackground((_a = options === null || options === void 0 ? void 0 : options.ui) === null || _a === void 0 ? void 0 : _a.surfaceBackground);
+    if (background) {
+        target.style.setProperty(FILE_VIEWER_RENDER_SURFACE_BACKGROUND_PROPERTY, background);
+    }
+    else {
+        target.style.removeProperty(FILE_VIEWER_RENDER_SURFACE_BACKGROUND_PROPERTY);
+    }
+    return background;
+};
 export const isFileViewerShadowRoot = (value) => {
     if (!value || typeof value !== 'object') {
         return false;

package/dist/viewer/createViewer.js

@@ -14,7 +14,7 @@ import { openFileViewerPrintMaskDesignerAsync } from '../features/printMaskLoade
 import { applyFileViewerZoomAvailability, createUnsupportedAvailability, getRendererAvailability, } from '../registry/capabilities.js';
 import { buildFileViewerLifecycleContextFromNormalizedSource, buildFileViewerOperationContext, runFileViewerBeforeOperation, runFileViewerLifecycleHook, } from '../lifecycle/operations.js';
 import { collectFileViewerRendererPlugins, createRendererRegistry, getFileViewerAutoRendererPresetVersion, hasFileViewerRendererPresetName, installFileViewerRendererPlugins, listFileViewerAutoRendererPresets, resolveFileViewerRendererPresetInputs, } from '../registry/registry.js';
-import { createFileRenderHandlerLoader, applyFileViewerRenderSurfaceState, createFileViewerRenderSurfaceState, createFileViewerRenderSurface, removeFileViewerRenderTarget, } from '../rendering/handler.js';
+import { createFileRenderHandlerLoader, applyFileViewerRenderSurfaceState, createFileViewerRenderSurfaceState, createFileViewerRenderSurface, removeFileViewerRenderTarget, syncFileViewerRenderSurfaceBackground, } from '../rendering/handler.js';
 import { createFileViewerCoreRendererRegistry } from '../renderers/index.js';
 import { createFileViewerRequestScope } from '../source/loading.js';
 import { normalizeSource } from '../source/index.js';
@@ -222,6 +222,7 @@ export const createViewer = (container, createOptions = {}) => {
             target.style.height = '100%';
             surface.container.style.height = '100%';
         }
+        syncFileViewerRenderSurfaceBackground(target, options);
         currentRenderTarget = target;
         return surface;
     };
@@ -482,7 +483,7 @@ export const createViewer = (container, createOptions = {}) => {
             const renderer = registry.getByExtension(normalized.extension);
             const startedAt = Date.now();
             await emitLifecycle(options, createOptions.onEvent, 'load-start', normalized, version, startedAt);
-            const surface = createRenderTarget((renderer === null || renderer === void 0 ? void 0 : renderer.id) !== 'office-presentation');
+            const surface = createRenderTarget((renderer === null || renderer === void 0 ? void 0 : renderer.id) !== 'office-presentation' && (renderer === null || renderer === void 0 ? void 0 : renderer.id) !== 'office-presentation-binary');
             const target = surface.container;
             const targetHost = surface.host || target;
             currentDocumentRoot = target;
@@ -561,6 +562,7 @@ export const createViewer = (container, createOptions = {}) => {
                 ...options,
                 ...nextOptions,
             };
+            syncFileViewerRenderSurfaceBackground(currentRenderTarget, options);
             syncWatermarkOverlay();
             if ('fit' in nextOptions && nextOptions.fit !== previousFit) {
                 fitController.resetAutoFit();

package/dist/viewer/loading.js

@@ -42,6 +42,13 @@ export const FILE_VIEWER_LOADING_THEME_MAP = {
         label: '表格数据',
         hint: '正在准备行列数据和基础样式。'
     },
+    tsv: {
+        accent: '#21a366',
+        soft: 'rgba(33, 163, 102, 0.12)',
+        badge: 'X',
+        label: '表格数据',
+        hint: '正在准备行列数据和基础样式。'
+    },
     ppt: {
         accent: '#f28b27',
         soft: 'rgba(242, 139, 39, 0.12)',
@@ -364,6 +371,7 @@ const FILE_VIEWER_LOADING_COPY_KEYS = {
     xls: { label: 'loading.sheet.label', hint: 'loading.sheet.hint' },
     xlsx: { label: 'loading.sheet.label', hint: 'loading.sheet.hint' },
     csv: { label: 'loading.csv.label', hint: 'loading.csv.hint' },
+    tsv: { label: 'loading.csv.label', hint: 'loading.csv.hint' },
     ppt: { label: 'loading.presentation.label', hint: 'loading.presentation.hint' },
     pptx: { label: 'loading.presentation.label', hint: 'loading.presentation.hint' },
     pdf: { label: 'loading.pdf.label', hint: 'loading.pdf.hint' },

package/dist/viewer/operations.js

@@ -93,15 +93,31 @@ export const executeFileViewerDownloadOperation = async ({ source, filename, bef
         source,
         fallback: DEFAULT_FILE_VIEWER_DOWNLOAD_FILENAME,
     });
-    if (source.buffer) {
+    // PDF.js transfers ArrayBuffer-backed data to its worker. After a successful
+    // render the original buffer can therefore be detached (byteLength === 0),
+    // while the File or URL retained by the viewer is still the complete source.
+    // Preserve the existing buffer-first contract for non-empty buffers, but do
+    // not turn a detached buffer into a zero-byte download.
+    if (source.buffer &&
+        (source.buffer.byteLength > 0 || (!source.file && !source.url))) {
         triggerFileViewerBlobDownload(new Blob([source.buffer], { type: source.mimeType || ((_a = source.file) === null || _a === void 0 ? void 0 : _a.type) || 'application/octet-stream' }), resolvedFilename);
         return true;
     }
+    if (source.file && (source.file.size > 0 || !source.url)) {
+        triggerFileViewerBlobDownload(source.file, resolvedFilename);
+        return true;
+    }
+    if (source.url) {
+        triggerFileViewerUrlDownload(source.url, resolvedFilename);
+        return true;
+    }
+    // Empty local files are valid sources. These final fallbacks preserve their
+    // intentional zero-byte downloads when no complete File or URL is available.
     if (source.file) {
         triggerFileViewerBlobDownload(source.file, resolvedFilename);
         return true;
     }
-    triggerFileViewerUrlDownload(source.url, resolvedFilename);
+    triggerFileViewerBlobDownload(new Blob([source.buffer], { type: source.mimeType || 'application/octet-stream' }), resolvedFilename);
     return true;
 };
 export const executeFileViewerExportHtmlOperation = async ({ download = true, filename, beforeOperation, i18n, ...input }) => {

package/dist/viewer/state.js

@@ -26,6 +26,7 @@ const extensionLabel = (extension) => {
 const rendererPackageById = {
     'office-word-openxml': '@file-viewer/renderer-word',
     'office-word-binary': '@file-viewer/renderer-word',
+    'office-presentation-binary': '@file-viewer/renderer-presentation',
     'office-presentation': '@file-viewer/renderer-presentation',
     'open-document': '@file-viewer/renderer-word',
     'spreadsheet-openxml': '@file-viewer/renderer-spreadsheet',
@@ -52,6 +53,7 @@ const rendererPackageById = {
 const officeRendererIds = new Set([
     'office-word-openxml',
     'office-word-binary',
+    'office-presentation-binary',
     'office-presentation',
     'open-document',
     'spreadsheet-openxml',
@@ -218,6 +220,14 @@ const resolveKnownFileViewerErrorMessage = (message, i18n) => {
     const key = FILE_VIEWER_KNOWN_ERROR_MESSAGE_KEYS[message.trim()];
     return key ? translateFileViewerMessage(i18n, key) : message;
 };
+const readFileViewerErrorProperty = (error, key) => {
+    try {
+        return error[key];
+    }
+    catch {
+        return undefined;
+    }
+};
 export const normalizeFileViewerErrorMessage = (error, i18n) => {
     if (error instanceof Error) {
         return resolveKnownFileViewerErrorMessage(error.message, i18n);
@@ -228,7 +238,20 @@ export const normalizeFileViewerErrorMessage = (error, i18n) => {
     if (error === undefined || error === null) {
         return translateFileViewerMessage(i18n, 'error.unknown');
     }
-    return String(error);
+    if (typeof error === 'object') {
+        const message = readFileViewerErrorProperty(error, 'message');
+        if (typeof message === 'string' && message.trim()) {
+            return resolveKnownFileViewerErrorMessage(message, i18n);
+        }
+        const reason = readFileViewerErrorProperty(error, 'reason');
+        if (reason !== undefined && reason !== error) {
+            return normalizeFileViewerErrorMessage(reason, i18n);
+        }
+    }
+    const fallback = String(error);
+    return fallback === '[object Object]'
+        ? translateFileViewerMessage(i18n, 'error.unknown')
+        : fallback;
 };
 export const formatFileViewerErrorMessage = (prefix, error, i18n) => {
     const detail = normalizeFileViewerErrorMessage(error, i18n);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@file-viewer/core",
-  "version": "2.1.30",
+  "version": "2.2.1",
   "private": false,
   "type": "module",
   "description": "Framework-neutral modular TypeScript core for Flyfish File Viewer renderer orchestration, lifecycle APIs, search, zoom, print, and export",