@arcships/pptx-core 0.5.0 → 0.5.2

package/README.md

@@ -2,14 +2,16 @@
 
 ## 当前状态
 
-本包提供 PPTX 静态预览、播放模型、文档会话、播放控制器、页面切换和受控媒体，从 `0.3.0` 起公开发布。实现范围和验收结果见 [实现设计](../../docs/pptx-playback-implementation-design.md) 与 [正式播放验收记录](../../docs/pptx-playback-acceptance-results.md)。
+本包提供 PPTX 纵向列表/单页静态预览、播放模型、文档会话、播放控制器、页面切换和受控媒体，从 `0.3.0` 起公开发布。实现范围和验收结果见 [实现设计](../../docs/pptx-playback-implementation-design.md) 与 [正式播放验收记录](../../docs/pptx-playback-acceptance-results.md)。
 
 ```bash
-pnpm add @arcships/pptx-core@0.4.0
+pnpm add @arcships/pptx-core@0.5.2
 ```
 
 浏览器能力从 `@arcships/pptx-core/browser` 导入。补丁后的渲染器代码已经包含在浏览器入口中，使用方不需要安装或配置 `@aiden0z/pptx-renderer`；其普通运行依赖由 npm 自动安装。
 
+`createPptxPreviewSession()` 默认使用 `renderMode: "list"`，纵向连续渲染全部幻灯片并按可视区域挂载。`createPptxDocumentSession()` 默认使用 `renderMode: "slide"`，供动画播放控制器使用。两者都可以通过会话选项显式指定 `renderMode`；`listOptions` 控制窗口化、初始挂载页数和预渲染范围。
+
 ## 入口边界
 
 - `src/index.ts`、`src/types.ts`：平台无关的公开类型、错误和默认限制；

package/dist/browser.d.ts

@@ -24,6 +24,16 @@ interface PptxPreviewSessionOptions {
     zoomPercent?: number;
     lazyMedia?: boolean;
     lazySlides?: boolean;
+    /** Static previews use a vertical page list; presentation playback uses one slide. */
+    renderMode?: "list" | "slide";
+    listOptions?: {
+        windowed?: boolean;
+        batchSize?: number;
+        initialSlides?: number;
+        overscanViewport?: number;
+        showSlideLabels?: boolean;
+    };
+    onSlideChange?: (index: number) => void;
 }
 type PptxApproximationPolicy = "off" | "safe";
 interface PptxDocumentSessionOptions extends PptxPreviewSessionOptions {

package/dist/browser.js

@@ -15454,6 +15454,9 @@ function createPptxDocumentSession(container, options = {}) {
     lazyMedia: options.lazyMedia ?? true,
     lazySlides: options.lazySlides ?? true,
     pdfjs: false,
+    onSlideChange(index) {
+      options.onSlideChange?.(index);
+    },
     onSlideRendered(index, element) {
       const slide = viewer.presentationData?.slides[index];
       if (slide) applyPptxObjectMarkers(element, slide.slidePath);
@@ -15553,7 +15556,20 @@ function createPptxDocumentSession(container, options = {}) {
           Math.max(presentation.slides.length - 1, 0)
         );
         viewer.load(presentation);
-        await viewer.renderSlide(initialSlide);
+        if ((options.renderMode ?? "slide") === "list") {
+          await viewer.renderList({
+            windowed: options.listOptions?.windowed ?? true,
+            batchSize: options.listOptions?.batchSize,
+            initialSlides: options.listOptions?.initialSlides,
+            overscanViewport: options.listOptions?.overscanViewport,
+            showSlideLabels: options.listOptions?.showSlideLabels
+          });
+          if (initialSlide > 0) {
+            await viewer.goToSlide(initialSlide, { behavior: "instant", block: "start" });
+          }
+        } else {
+          await viewer.renderSlide(initialSlide);
+        }
         task.assertCurrent();
         currentArchive = files;
         currentPlaybackDocument = playbackDocument;
@@ -15660,7 +15676,10 @@ function createPptxDocumentSession(container, options = {}) {
   return session;
 }
 function createPptxPreviewSession(container, options = {}) {
-  return createPptxDocumentSession(container, options);
+  return createPptxDocumentSession(container, {
+    ...options,
+    renderMode: options.renderMode ?? "list"
+  });
 }
 export {
   createPptxDocumentSession,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcships/pptx-core",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "license": "Apache-2.0",
   "description": "PPTX preview and playback model with browser document sessions and animation controls",
   "keywords": ["pptx", "powerpoint", "presentation", "viewer", "playback", "animation"],