@file-viewer/pptx 2.1.17 → 2.1.18

package/dist/index.d.ts

@@ -1,4 +1,4 @@
 export { PptxViewer } from './viewer';
 export { createPptxWorker } from './worker';
 export { RECOMMENDED_ZIP_LIMITS, createDefaultPptxOptions, resolvePptxEngineOptions, } from './options';
-export type { NativePptxEngineOptions, PptxFitMode, PptxListOptions, PptxSlideSize, PptxViewerOptions, PptxWorkerFactoryOptions, PptxWorkerMessage, PptxZipLimits, } from './types';
+export type { NativePptxEngineOptions, PptxDiagnosticError, PptxDiagnosticErrorCode, PptxFitMode, PptxListOptions, PptxSlideSize, PptxViewerOptions, PptxWorkerFactoryOptions, PptxWorkerMessage, PptxZipLimits, } from './types';

package/dist/styles.d.ts

@@ -1,2 +1,2 @@
 export declare const pptxViewerCss = "\n.flyfish-pptx-scale-box{position:relative;box-sizing:border-box;max-width:100%;margin:0 auto;min-width:0}\n.flyfish-pptx-content{position:absolute;top:0;left:0;box-sizing:border-box;max-width:none;min-width:0;transform-origin:top left;will-change:transform}\n.flyfish-pptx-content[data-render-state=\"loading\"]{opacity:.82}\n.flyfish-pptx-slide-slot{display:flow-root;box-sizing:border-box;width:100%;min-width:0}\n.flyfish-pptx-content .slide{background:#fff;box-shadow:0 18px 36px rgba(18,35,52,.12)}\n.flyfish-pptx-thumbnail{display:block;box-sizing:border-box;width:min(960px,100%);height:auto;margin:0 auto 28px;border-radius:12px;background:#fff;box-shadow:0 18px 36px rgba(18,35,52,.14)}\n\n.slide{position:relative;border:0;border-radius:0;overflow:hidden;margin-bottom:50px;margin-left:auto;margin-right:auto;z-index:100}\n.slide div.block{position:absolute;top:0;left:0;width:100%;line-height:1}\n.slide div.content{display:flex;flex-direction:column}\n.slide div.diagram-content{display:flex;flex-direction:column}\n.slide div.content-rtl{display:flex;flex-direction:column;direction:rtl}\n.slide .pregraph-rtl{direction:rtl}\n.slide .pregraph-ltr{direction:ltr}\n.slide .pregraph-inherit{direction:inherit}\n.slide .slide-prgrph{width:100%}\n.slide .line-break-br::before{content:\"\\A\";white-space:pre}\n.slide div.v-up{justify-content:flex-start}\n.slide div.v-mid{justify-content:center}\n.slide div.v-down{justify-content:flex-end}\n.slide div.h-left{justify-content:flex-start;align-items:flex-start;text-align:left}\n.slide div.h-left-rtl{justify-content:flex-end;align-items:flex-end;text-align:left}\n.slide div.h-mid{justify-content:center;align-items:center;text-align:center}\n.slide div.h-right{justify-content:flex-end;align-items:flex-end;text-align:right}\n.slide div.h-right-rtl{justify-content:flex-start;align-items:flex-start;text-align:right}\n.slide div.h-just,.slide div.h-dist{text-align:justify}\n.slide div.up-left{justify-content:flex-start;align-items:flex-start;text-align:left}\n.slide div.up-center{justify-content:flex-start;align-items:center}\n.slide div.up-right{justify-content:flex-start;align-items:flex-end}\n.slide div.center-left{justify-content:center;align-items:flex-start;text-align:left}\n.slide div.center-center{justify-content:center;align-items:center}\n.slide div.center-right{justify-content:center;align-items:flex-end}\n.slide div.down-left{justify-content:flex-end;align-items:flex-start;text-align:left}\n.slide div.down-center{justify-content:flex-end;align-items:center}\n.slide div.down-right{justify-content:flex-end;align-items:flex-end}\n.slide li.slide{margin:10px 0;font-size:18px}\n.slide table{position:absolute}\n.slide svg.drawing{position:absolute;overflow:visible}\n\n.flyfish-pptx-content > .slide:last-of-type{margin-bottom:0}\n.flyfish-pptx-slide-slot:last-of-type > .slide{margin-bottom:0}\n";
-export declare const ensurePptxViewerStyles: (documentRef: Document) => void;
+export declare const ensurePptxViewerStyles: (documentRef: Document, root?: Document | ShadowRoot) => void;

package/dist/styles.js

@@ -43,12 +43,19 @@ ${legacyPptxCss}
 .flyfish-pptx-slide-slot:last-of-type > .slide{margin-bottom:0}
 `;
 const PPTX_STYLE_ID = 'flyfish-pptx-native-style';
-export const ensurePptxViewerStyles = (documentRef) => {
-    if (documentRef.getElementById(PPTX_STYLE_ID)) {
+export const ensurePptxViewerStyles = (documentRef, root = documentRef) => {
+    if (root instanceof Document && root.getElementById(PPTX_STYLE_ID)) {
+        return;
+    }
+    if (!(root instanceof Document) && root.querySelector(`#${PPTX_STYLE_ID}`)) {
         return;
     }
     const style = documentRef.createElement('style');
     style.id = PPTX_STYLE_ID;
     style.textContent = pptxViewerCss;
-    (documentRef.head || documentRef.documentElement).appendChild(style);
+    if (root instanceof Document) {
+        (root.head || root.documentElement).appendChild(style);
+        return;
+    }
+    root.appendChild(style);
 };

package/dist/types.d.ts

@@ -34,7 +34,17 @@ export interface PptxSlideSize {
     height?: number;
     [key: string]: unknown;
 }
+export type PptxDiagnosticErrorCode = 'PPTX_FILE_EMPTY' | 'PPTX_FILE_TOO_LARGE' | 'PPTX_INVALID_ZIP' | 'PPTX_MISSING_CONTENT_TYPES' | 'PPTX_MISSING_PRESENTATION' | 'PPTX_NO_SLIDES' | 'PPTX_MISSING_SLIDE' | 'PPTX_SLIDE_RENDER_FAILED' | 'PPTX_WORKER_FAILED' | 'PPTX_PARSE_FAILED' | (string & {});
+export interface PptxDiagnosticError {
+    name: 'PptxDiagnosticError';
+    code: PptxDiagnosticErrorCode;
+    stage?: string;
+    message: string;
+    detail?: string;
+    hint?: string;
+}
 export interface PptxViewerOptions extends PptxWorkerFactoryOptions {
+    styleRoot?: ShadowRoot;
     fitMode?: PptxFitMode;
     zoomPercent?: number;
     zipLimits?: PptxZipLimits;

package/dist/viewer.js

@@ -9,13 +9,39 @@ const toPercent = (value) => {
     const numeric = typeof value === 'number' && Number.isFinite(value) ? value : 100;
     return clamp(numeric, 25, 300);
 };
+const stringifyErrorDetail = (error) => {
+    if (error === undefined || error === null) {
+        return '';
+    }
+    if (typeof error === 'string') {
+        return error;
+    }
+    if (error instanceof Error && error.message) {
+        return error.message;
+    }
+    try {
+        const serialized = JSON.stringify(error);
+        return serialized && serialized !== '{}' ? serialized : String(error);
+    }
+    catch {
+        return String(error);
+    }
+};
+const createPptxDiagnosticError = (code, stage, message, detailOrError, hint) => ({
+    name: 'PptxDiagnosticError',
+    code,
+    stage,
+    message,
+    detail: stringifyErrorDetail(detailOrError),
+    hint,
+});
 const ensureZipWithinLimits = (buffer, options) => {
     const limits = {
         ...RECOMMENDED_ZIP_LIMITS,
         ...options.zipLimits,
     };
     if (limits.maxFileBytes && buffer.byteLength > limits.maxFileBytes) {
-        throw new Error(`PPTX file is too large to preview safely (${buffer.byteLength} bytes).`);
+        throw createPptxDiagnosticError('PPTX_FILE_TOO_LARGE', 'preflight', 'PPTX 文件超过浏览器安全预览体积限制。', `${buffer.byteLength} bytes > ${limits.maxFileBytes} bytes`, '请压缩图片、拆分演示文稿，或在业务侧提高 zipLimits.maxFileBytes 后再预览。');
     }
 };
 const appendHtml = (container, html) => {
@@ -81,7 +107,7 @@ export class PptxViewer {
     }
     async open() {
         ensureZipWithinLimits(this.buffer, this.options);
-        ensurePptxViewerStyles(this.target.ownerDocument || document);
+        ensurePptxViewerStyles(this.target.ownerDocument || document, this.options.styleRoot);
         this.target.replaceChildren(this.scaleBox);
         this.attachResizeObserver();
         this.attachSlideWindowListeners();
@@ -117,15 +143,25 @@ export class PptxViewer {
         this.slideRecords = [];
         this.content.replaceChildren();
         this.content.dataset.renderState = 'loading';
-        this.worker = createPptxWorker(this.options);
+        try {
+            this.worker = createPptxWorker(this.options);
+        }
+        catch (error) {
+            throw createPptxDiagnosticError('PPTX_WORKER_FAILED', 'start-worker', 'PPTX Worker 启动失败。', error, '请检查 presentation.workerUrl、Worker 文件是否 200 返回、MIME/CSP/跨域策略是否允许加载。');
+        }
         this.worker.addEventListener('message', event => this.processMessage(event.data));
-        this.worker.addEventListener('error', event => this.fail(event.error || event.message));
-        this.worker.postMessage({
-            type: 'processPPTX',
-            data: this.buffer,
-            IE11: false,
-            options: resolvePptxEngineOptions(this.options.engineOptions),
-        });
+        this.worker.addEventListener('error', event => this.fail(createPptxDiagnosticError('PPTX_WORKER_FAILED', 'worker-runtime', 'PPTX Worker 运行失败。', event.error || event.message, '请检查 Worker 脚本是否完整、浏览器控制台是否有 CSP/MIME/跨域或语法错误。')));
+        try {
+            this.worker.postMessage({
+                type: 'processPPTX',
+                data: this.buffer,
+                IE11: false,
+                options: resolvePptxEngineOptions(this.options.engineOptions),
+            });
+        }
+        catch (error) {
+            throw createPptxDiagnosticError('PPTX_WORKER_FAILED', 'post-worker-message', 'PPTX 数据发送到 Worker 失败。', error, '请确认浏览器支持 Worker 消息传递，并避免传入已被释放或不可克隆的数据。');
+        }
     }
     processMessage(message) {
         var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;