@silurus/ooxml 0.74.3 → 0.74.4

package/dist/types/docx.d.ts

@@ -1329,7 +1329,7 @@ interface FindMatch<Loc = unknown> {
     location: Loc;
 }
 //#endregion
-//#region dist/.types-work/docx-Cyc_gyvZ.d.ts
+//#region dist/.types-work/docx-Cc2gf7b0.d.ts
 //#region packages/docx/src/types.d.ts
 interface DocxDocumentModel {
     section: SectionProps;
@@ -3372,6 +3372,13 @@ interface DocxScrollViewerOptions extends Omit<RenderPageOptions, 'onTextRun'>,
     zoomMax?: number;
     /** Enable `Ctrl`/`Cmd`+wheel zoom. Default true. */
     enableZoom?: boolean;
+    /**
+     * Re-fit the document to the container width when the container is resized.
+     * Default true. Set false to preserve the current absolute scale, including
+     * an explicit pre-load `setScale(1)`, independently of the viewport width.
+     * Explicit `fitWidth()` and `fitPage()` calls remain available.
+     */
+    refitOnResize?: boolean;
     /**
      * CSS `background` shorthand for the scroll surface (the "desk") visible
      * behind and between pages — the gray a PDF reader paints around the sheet.
@@ -3410,8 +3417,9 @@ interface DocxScrollViewerOptions extends Omit<RenderPageOptions, 'onTextRun'>,
     /** IX9 — fires whenever the zoom factor actually changes (`1` = 100% = a page
      *  at its natural pt→px size): from {@link DocxScrollViewer.setScale},
      *  `zoomIn`/`zoomOut`, `fitWidth`/`fitPage`, a Ctrl/⌘+wheel gesture, or a
-     *  container-resize re-fit. Named `onScaleChange` to match the single-canvas
-     *  viewers so all five share one notification shape. */
+     *  container-resize re-fit (when `refitOnResize` is enabled). Named
+     *  `onScaleChange` to match the single-canvas viewers so all five share one
+     *  notification shape. */
     onScaleChange?: (scale: number) => void;
     /** IX1 (design decision — NOT user-confirmed, integrator may veto). Called when
      *  a hyperlink run is clicked. When omitted, the default is: external → open in a
@@ -3557,6 +3565,8 @@ declare class DocxScrollViewer implements ZoomableViewer {
      *  `_settleSlot`) so a recycled/re-mounted slot and a settle-swapped spare all
      *  carry it. */
     private readonly _pageShadow;
+    private readonly _find;
+    private _findActive;
     constructor(container: HTMLElement, opts?: DocxScrollViewerOptions);
     /**
      * Load a DOCX from URL or ArrayBuffer and render the first window.
@@ -3847,6 +3857,20 @@ declare class DocxScrollViewer implements ZoomableViewer {
     scrollToPage(index: number, opts?: {
         behavior?: 'auto' | 'smooth';
     }): void;
+    /** Search the complete document, including pages outside the virtualized
+     * mounted window. Matching is case-insensitive by default. */
+    findText(query: string, opts?: FindMatchesOptions): Promise<FindMatch<DocxMatchLocation>[]>;
+    /** Activate and reveal the next match, wrapping at the end. */
+    findNext(): Promise<FindMatch<DocxMatchLocation> | null>;
+    /** Activate and reveal the previous match, wrapping at the beginning. */
+    findPrev(): Promise<FindMatch<DocxMatchLocation> | null>;
+    /** Clear the current query and every mounted highlight. */
+    clearFind(): void;
+    private _activateMatch;
+    private _collectPageRuns;
+    private _redrawHighlights;
+    private _refreshFindRuns;
+    private _redrawSlotHighlights;
     /**
      * Re-fit the base scale on a container resize while PRESERVING the current zoom
      * multiplier (design §11), then re-anchor + re-render. A `ResizeObserver` fires

package/dist/types/index.d.ts

@@ -1329,7 +1329,7 @@ interface FindMatch<Loc = unknown> {
     location: Loc;
 }
 //#endregion
-//#region dist/.types-work/docx-Cyc_gyvZ.d.ts
+//#region dist/.types-work/docx-Cc2gf7b0.d.ts
 //#region packages/docx/src/types.d.ts
 interface DocxDocumentModel {
     section: SectionProps;
@@ -3372,6 +3372,13 @@ interface DocxScrollViewerOptions extends Omit<RenderPageOptions, 'onTextRun'>,
     zoomMax?: number;
     /** Enable `Ctrl`/`Cmd`+wheel zoom. Default true. */
     enableZoom?: boolean;
+    /**
+     * Re-fit the document to the container width when the container is resized.
+     * Default true. Set false to preserve the current absolute scale, including
+     * an explicit pre-load `setScale(1)`, independently of the viewport width.
+     * Explicit `fitWidth()` and `fitPage()` calls remain available.
+     */
+    refitOnResize?: boolean;
     /**
      * CSS `background` shorthand for the scroll surface (the "desk") visible
      * behind and between pages — the gray a PDF reader paints around the sheet.
@@ -3410,8 +3417,9 @@ interface DocxScrollViewerOptions extends Omit<RenderPageOptions, 'onTextRun'>,
     /** IX9 — fires whenever the zoom factor actually changes (`1` = 100% = a page
      *  at its natural pt→px size): from {@link DocxScrollViewer.setScale},
      *  `zoomIn`/`zoomOut`, `fitWidth`/`fitPage`, a Ctrl/⌘+wheel gesture, or a
-     *  container-resize re-fit. Named `onScaleChange` to match the single-canvas
-     *  viewers so all five share one notification shape. */
+     *  container-resize re-fit (when `refitOnResize` is enabled). Named
+     *  `onScaleChange` to match the single-canvas viewers so all five share one
+     *  notification shape. */
     onScaleChange?: (scale: number) => void;
     /** IX1 (design decision — NOT user-confirmed, integrator may veto). Called when
      *  a hyperlink run is clicked. When omitted, the default is: external → open in a
@@ -3557,6 +3565,8 @@ declare class DocxScrollViewer implements ZoomableViewer {
      *  `_settleSlot`) so a recycled/re-mounted slot and a settle-swapped spare all
      *  carry it. */
     private readonly _pageShadow;
+    private readonly _find;
+    private _findActive;
     constructor(container: HTMLElement, opts?: DocxScrollViewerOptions);
     /**
      * Load a DOCX from URL or ArrayBuffer and render the first window.
@@ -3847,6 +3857,20 @@ declare class DocxScrollViewer implements ZoomableViewer {
     scrollToPage(index: number, opts?: {
         behavior?: 'auto' | 'smooth';
     }): void;
+    /** Search the complete document, including pages outside the virtualized
+     * mounted window. Matching is case-insensitive by default. */
+    findText(query: string, opts?: FindMatchesOptions): Promise<FindMatch<DocxMatchLocation>[]>;
+    /** Activate and reveal the next match, wrapping at the end. */
+    findNext(): Promise<FindMatch<DocxMatchLocation> | null>;
+    /** Activate and reveal the previous match, wrapping at the beginning. */
+    findPrev(): Promise<FindMatch<DocxMatchLocation> | null>;
+    /** Clear the current query and every mounted highlight. */
+    clearFind(): void;
+    private _activateMatch;
+    private _collectPageRuns;
+    private _redrawHighlights;
+    private _refreshFindRuns;
+    private _redrawSlotHighlights;
     /**
      * Re-fit the base scale on a container resize while PRESERVING the current zoom
      * multiplier (design §11), then re-anchor + re-render. A `ResizeObserver` fires
@@ -4440,7 +4464,7 @@ interface RenderOptions {
     skipMediaControls?: boolean;
 }
 //#endregion
-//#region dist/.types-work/pptx-CJgt70hV.d.ts
+//#region dist/.types-work/pptx-ChHwV9HX.d.ts
 //#region packages/pptx/src/types.d.ts
 /**
  * Picture bullet — ECMA-376 §21.1.2.4.2 `<a:buBlip><a:blip r:embed>`. The
@@ -5670,6 +5694,20 @@ interface PptxScrollViewerOptions extends Omit<RenderSlideOptions, 'onTextRun'>,
      *  shipped back beside the slide bitmap, so the overlay is populated identically
      *  to main mode (no more empty overlay / one-time warning). */
     enableTextSelection?: boolean;
+    /**
+     * Enable interactive audio/video playback. When true, mounted slides render
+     * through {@link PptxPresentation.presentSlide} only while they are inside the
+     * real viewport plus {@link mediaOverscan}. Other mounted slides retain static
+     * canvases and selectable text without allocating media blobs or RAF loops.
+     * Default false.
+     */
+    enableMediaPlayback?: boolean;
+    /**
+     * Slides beyond the real viewport that may keep interactive media handles.
+     * Independent from {@link overscan}, so an integration may mount every text
+     * overlay for browser-native Find while media resources stay bounded. Default 1.
+     */
+    mediaOverscan?: number;
     /** Minimum zoom scale — a DIMENSIONLESS multiplier over the 96-dpi natural
      *  slide size (10% = 0.1), matching `DocxScrollViewer`. Default 0.1. */
     zoomMin?: number;
@@ -5677,6 +5715,13 @@ interface PptxScrollViewerOptions extends Omit<RenderSlideOptions, 'onTextRun'>,
     zoomMax?: number;
     /** Enable `Ctrl`/`Cmd`+wheel zoom. Default true. */
     enableZoom?: boolean;
+    /**
+     * Re-fit the presentation to the container width when the container is
+     * resized. Default true. Set false to preserve the current absolute scale,
+     * including an explicit pre-load `setScale(1)`, independently of the viewport
+     * width. Explicit `fitWidth()` and `fitPage()` calls remain available.
+     */
+    refitOnResize?: boolean;
     /**
      * CSS `background` shorthand for the scroll surface (the "desk") visible
      * behind and between slides — the gray a presentation viewer paints around the
@@ -5715,8 +5760,9 @@ interface PptxScrollViewerOptions extends Omit<RenderSlideOptions, 'onTextRun'>,
     /** IX9 — fires whenever the zoom factor actually changes (`1` = 100% = a slide
      *  at its natural EMU→px size): from {@link PptxScrollViewer.setScale},
      *  `zoomIn`/`zoomOut`, `fitWidth`/`fitPage`, a Ctrl/⌘+wheel gesture, or a
-     *  container-resize re-fit. Named `onScaleChange` to match the single-canvas
-     *  viewers so all five share one notification shape. */
+     *  container-resize re-fit (when `refitOnResize` is enabled). Named
+     *  `onScaleChange` to match the single-canvas viewers so all five share one
+     *  notification shape. */
     onScaleChange?: (scale: number) => void;
     /** Error callback. When set, `load()` invokes it and resolves (otherwise the
      *  error is rethrown — shared viewer error contract). It ALSO fires for async
@@ -5868,6 +5914,9 @@ declare class PptxScrollViewer implements ZoomableViewer {
      *  `_settleSlot`) so a recycled/re-mounted slot and a settle-swapped spare all
      *  carry it. */
     private readonly _pageShadow;
+    private readonly _find;
+    private _findActive;
+    private _findMeasureCtx;
     constructor(container: HTMLElement, opts?: PptxScrollViewerOptions);
     /**
      * Load a PPTX from URL or ArrayBuffer and render the first window.
@@ -5913,6 +5962,8 @@ declare class PptxScrollViewer implements ZoomableViewer {
     private _recomputeHeights;
     private _gap;
     private _overscan;
+    /** Media lifecycle window, deliberately independent from text/canvas overscan. */
+    private _mediaOverscan;
     /** Desk padding fed to `computeVisibleRange`: `paddingTop`/`paddingBottom`,
      *  each defaulting to `gap` (uniform rhythm). Resolved here (not stored) to
      *  mirror `_gap()`/`_overscan()`, and consumed at EVERY `computeVisibleRange`
@@ -5931,6 +5982,8 @@ declare class PptxScrollViewer implements ZoomableViewer {
      *  `[0, n-1]`; a `y` below the first slide (inside the leading pad) yields 0. */
     private _slideIndexAtOffset;
     private _range;
+    private _mediaRange;
+    private _rangeContains;
     private _syncSpacer;
     /** Horizontal scroll extent: the (uniform deck-wide) slide width plus both
      *  gutters. A spacer NARROWER than the container never creates a scrollbar
@@ -5978,6 +6031,20 @@ declare class PptxScrollViewer implements ZoomableViewer {
      * can pass for an old-epoch resolution). We gate them on the captured epoch.
      */
     private _renderSlot;
+    /**
+     * Render one mounted slot through the stateful media presentation API.
+     *
+     * This path intentionally bypasses bitmaprenderer even for worker-backed
+     * presentations: presentSlide() renders the base off-thread and composites
+     * interactive video on a main-thread 2D canvas. The slot generation closes the
+     * same-index recycle/reload hole that a viewer-wide render epoch cannot detect.
+     */
+    private _renderInteractiveSlot;
+    /**
+     * Reconcile stateful media handles against the small media lifecycle range,
+     * independently from the (potentially whole-deck) mounted text range.
+     */
+    private _syncMediaPlayback;
     /** Route an async render failure to `onError`, or `console.error` when none is
      *  set (so failures are never fully silent), and never after teardown. */
     private _reportRenderError;
@@ -6120,6 +6187,12 @@ declare class PptxScrollViewer implements ZoomableViewer {
      * stretched preview until the instant of the swap — blank-free.
      */
     private _settleSlot;
+    /**
+     * Settle an interactive slide onto a spare 2D canvas, then atomically swap it
+     * in and destroy the handle tied to the retired canvas. Pending handles from a
+     * superseded zoom/recycle are destroyed as soon as they resolve.
+     */
+    private _settleInteractiveSlot;
     /**
      * Scroll so slide `index`'s top edge sits at the viewport top. Clamps `index` to
      * `[0, slideCount-1]` (the pager convention) and the resulting scrollTop to
@@ -6142,6 +6215,21 @@ declare class PptxScrollViewer implements ZoomableViewer {
     scrollToSlide(index: number, opts?: {
         behavior?: 'auto' | 'smooth';
     }): void;
+    /** Search the complete presentation, including slides outside the
+     * virtualized mounted window. Matching is case-insensitive by default. */
+    findText(query: string, opts?: FindMatchesOptions): Promise<FindMatch<PptxMatchLocation>[]>;
+    /** Activate and reveal the next match, wrapping at the end. */
+    findNext(): Promise<FindMatch<PptxMatchLocation> | null>;
+    /** Activate and reveal the previous match, wrapping at the beginning. */
+    findPrev(): Promise<FindMatch<PptxMatchLocation> | null>;
+    /** Clear the current query and every mounted highlight. */
+    clearFind(): void;
+    private _activateMatch;
+    private _collectSlideRuns;
+    private _redrawHighlights;
+    private _refreshFindRuns;
+    private _redrawSlotHighlights;
+    private _measureForFind;
     /**
      * IX1 hyperlink click dispatch (mirrors {@link PptxViewer._onHyperlinkClick}).
      * When the integrator supplies `opts.onHyperlinkClick` it OWNS the click (no

package/dist/types/pptx.d.ts

@@ -1801,7 +1801,7 @@ interface RenderOptions {
     skipMediaControls?: boolean;
 }
 //#endregion
-//#region dist/.types-work/pptx-CJgt70hV.d.ts
+//#region dist/.types-work/pptx-ChHwV9HX.d.ts
 //#region packages/pptx/src/types.d.ts
 /**
  * Picture bullet — ECMA-376 §21.1.2.4.2 `<a:buBlip><a:blip r:embed>`. The
@@ -3031,6 +3031,20 @@ interface PptxScrollViewerOptions extends Omit<RenderSlideOptions, 'onTextRun'>,
      *  shipped back beside the slide bitmap, so the overlay is populated identically
      *  to main mode (no more empty overlay / one-time warning). */
     enableTextSelection?: boolean;
+    /**
+     * Enable interactive audio/video playback. When true, mounted slides render
+     * through {@link PptxPresentation.presentSlide} only while they are inside the
+     * real viewport plus {@link mediaOverscan}. Other mounted slides retain static
+     * canvases and selectable text without allocating media blobs or RAF loops.
+     * Default false.
+     */
+    enableMediaPlayback?: boolean;
+    /**
+     * Slides beyond the real viewport that may keep interactive media handles.
+     * Independent from {@link overscan}, so an integration may mount every text
+     * overlay for browser-native Find while media resources stay bounded. Default 1.
+     */
+    mediaOverscan?: number;
     /** Minimum zoom scale — a DIMENSIONLESS multiplier over the 96-dpi natural
      *  slide size (10% = 0.1), matching `DocxScrollViewer`. Default 0.1. */
     zoomMin?: number;
@@ -3038,6 +3052,13 @@ interface PptxScrollViewerOptions extends Omit<RenderSlideOptions, 'onTextRun'>,
     zoomMax?: number;
     /** Enable `Ctrl`/`Cmd`+wheel zoom. Default true. */
     enableZoom?: boolean;
+    /**
+     * Re-fit the presentation to the container width when the container is
+     * resized. Default true. Set false to preserve the current absolute scale,
+     * including an explicit pre-load `setScale(1)`, independently of the viewport
+     * width. Explicit `fitWidth()` and `fitPage()` calls remain available.
+     */
+    refitOnResize?: boolean;
     /**
      * CSS `background` shorthand for the scroll surface (the "desk") visible
      * behind and between slides — the gray a presentation viewer paints around the
@@ -3076,8 +3097,9 @@ interface PptxScrollViewerOptions extends Omit<RenderSlideOptions, 'onTextRun'>,
     /** IX9 — fires whenever the zoom factor actually changes (`1` = 100% = a slide
      *  at its natural EMU→px size): from {@link PptxScrollViewer.setScale},
      *  `zoomIn`/`zoomOut`, `fitWidth`/`fitPage`, a Ctrl/⌘+wheel gesture, or a
-     *  container-resize re-fit. Named `onScaleChange` to match the single-canvas
-     *  viewers so all five share one notification shape. */
+     *  container-resize re-fit (when `refitOnResize` is enabled). Named
+     *  `onScaleChange` to match the single-canvas viewers so all five share one
+     *  notification shape. */
     onScaleChange?: (scale: number) => void;
     /** Error callback. When set, `load()` invokes it and resolves (otherwise the
      *  error is rethrown — shared viewer error contract). It ALSO fires for async
@@ -3229,6 +3251,9 @@ declare class PptxScrollViewer implements ZoomableViewer {
      *  `_settleSlot`) so a recycled/re-mounted slot and a settle-swapped spare all
      *  carry it. */
     private readonly _pageShadow;
+    private readonly _find;
+    private _findActive;
+    private _findMeasureCtx;
     constructor(container: HTMLElement, opts?: PptxScrollViewerOptions);
     /**
      * Load a PPTX from URL or ArrayBuffer and render the first window.
@@ -3274,6 +3299,8 @@ declare class PptxScrollViewer implements ZoomableViewer {
     private _recomputeHeights;
     private _gap;
     private _overscan;
+    /** Media lifecycle window, deliberately independent from text/canvas overscan. */
+    private _mediaOverscan;
     /** Desk padding fed to `computeVisibleRange`: `paddingTop`/`paddingBottom`,
      *  each defaulting to `gap` (uniform rhythm). Resolved here (not stored) to
      *  mirror `_gap()`/`_overscan()`, and consumed at EVERY `computeVisibleRange`
@@ -3292,6 +3319,8 @@ declare class PptxScrollViewer implements ZoomableViewer {
      *  `[0, n-1]`; a `y` below the first slide (inside the leading pad) yields 0. */
     private _slideIndexAtOffset;
     private _range;
+    private _mediaRange;
+    private _rangeContains;
     private _syncSpacer;
     /** Horizontal scroll extent: the (uniform deck-wide) slide width plus both
      *  gutters. A spacer NARROWER than the container never creates a scrollbar
@@ -3339,6 +3368,20 @@ declare class PptxScrollViewer implements ZoomableViewer {
      * can pass for an old-epoch resolution). We gate them on the captured epoch.
      */
     private _renderSlot;
+    /**
+     * Render one mounted slot through the stateful media presentation API.
+     *
+     * This path intentionally bypasses bitmaprenderer even for worker-backed
+     * presentations: presentSlide() renders the base off-thread and composites
+     * interactive video on a main-thread 2D canvas. The slot generation closes the
+     * same-index recycle/reload hole that a viewer-wide render epoch cannot detect.
+     */
+    private _renderInteractiveSlot;
+    /**
+     * Reconcile stateful media handles against the small media lifecycle range,
+     * independently from the (potentially whole-deck) mounted text range.
+     */
+    private _syncMediaPlayback;
     /** Route an async render failure to `onError`, or `console.error` when none is
      *  set (so failures are never fully silent), and never after teardown. */
     private _reportRenderError;
@@ -3481,6 +3524,12 @@ declare class PptxScrollViewer implements ZoomableViewer {
      * stretched preview until the instant of the swap — blank-free.
      */
     private _settleSlot;
+    /**
+     * Settle an interactive slide onto a spare 2D canvas, then atomically swap it
+     * in and destroy the handle tied to the retired canvas. Pending handles from a
+     * superseded zoom/recycle are destroyed as soon as they resolve.
+     */
+    private _settleInteractiveSlot;
     /**
      * Scroll so slide `index`'s top edge sits at the viewport top. Clamps `index` to
      * `[0, slideCount-1]` (the pager convention) and the resulting scrollTop to
@@ -3503,6 +3552,21 @@ declare class PptxScrollViewer implements ZoomableViewer {
     scrollToSlide(index: number, opts?: {
         behavior?: 'auto' | 'smooth';
     }): void;
+    /** Search the complete presentation, including slides outside the
+     * virtualized mounted window. Matching is case-insensitive by default. */
+    findText(query: string, opts?: FindMatchesOptions): Promise<FindMatch<PptxMatchLocation>[]>;
+    /** Activate and reveal the next match, wrapping at the end. */
+    findNext(): Promise<FindMatch<PptxMatchLocation> | null>;
+    /** Activate and reveal the previous match, wrapping at the beginning. */
+    findPrev(): Promise<FindMatch<PptxMatchLocation> | null>;
+    /** Clear the current query and every mounted highlight. */
+    clearFind(): void;
+    private _activateMatch;
+    private _collectSlideRuns;
+    private _redrawHighlights;
+    private _refreshFindRuns;
+    private _redrawSlotHighlights;
+    private _measureForFind;
     /**
      * IX1 hyperlink click dispatch (mirrors {@link PptxViewer._onHyperlinkClick}).
      * When the integrator supplies `opts.onHyperlinkClick` it OWNS the click (no

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@silurus/ooxml",
-  "version": "0.74.3",
+  "version": "0.74.4",
   "description": "Browser-based OOXML viewer (docx/xlsx/pptx) — Rust/WASM parser + Canvas renderer",
   "license": "MIT",
   "author": "Yuki Yokotani <silurus.dev@gmail.com>",