@arcships/pptx-core 0.5.1 → 0.5.3

package/README.md

@@ -2,14 +2,16 @@
 
 ## 当前状态
 
-本包提供 PPTX 静态预览、播放模型、文档会话、播放控制器、页面切换和受控媒体，从 `0.3.0` 起公开发布。实现范围和验收结果见 [实现设计](../../docs/pptx-playback-implementation-design.md) 与 [正式播放验收记录](../../docs/pptx-playback-acceptance-results.md)。
+本包提供 PPTX、PPTM、PPSX、PPSM、POTX、POTM 的纵向列表/单页静态预览、播放模型、文档会话、播放控制器、页面切换和受控媒体。宏内容不会执行。实现范围和验收结果见 [实现设计](../../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.3
 ```
 
 浏览器能力从 `@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

@@ -22,8 +22,20 @@ interface PptxPreviewSessionOptions {
     limits?: PptxPreviewLimits;
     fitMode?: "contain" | "none";
     zoomPercent?: number;
+    /** Explicit scroll owner used by list virtualization and Surface zoom anchoring. */
+    scrollContainer?: HTMLElement;
     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 {