@silurus/ooxml 0.74.3 → 0.74.5

package/dist/types/docx.d.ts

@@ -29,7 +29,7 @@ interface MathRenderer {
     mathMLToSvg(mathml: string): Promise<MathSvg>;
 }
 //#endregion
-//#region dist/.types-work/find-match-BE0QHHzK.d.ts
+//#region dist/.types-work/find-highlight-B8ft6Y0g.d.ts
 //#region packages/core/src/types/math.d.ts
 type MathStyle = 'roman' | 'italic' | 'bold' | 'boldItalic';
 interface MathRun {
@@ -1329,7 +1329,22 @@ interface FindMatch<Loc = unknown> {
     location: Loc;
 }
 //#endregion
-//#region dist/.types-work/docx-Cyc_gyvZ.d.ts
+//#region packages/core/src/search/find-highlight.d.ts
+/**
+ * CSS colours used by in-document search overlays.
+ *
+ * The values are applied as the overlay backgrounds verbatim. Use an alpha
+ * colour (`rgba(...)`, 8-digit hex, or `color-mix(...)`) when the rendered text
+ * should remain visible through the highlight.
+ */
+interface FindHighlightColors {
+    /** Background for every match except the active one. */
+    match?: string;
+    /** Background for the match selected by findNext/findPrev. */
+    active?: string;
+}
+//#endregion
+//#region dist/.types-work/docx-BatSd3II.d.ts
 //#region packages/docx/src/types.d.ts
 interface DocxDocumentModel {
     section: SectionProps;
@@ -3072,6 +3087,8 @@ interface DocxViewerOptions extends RenderPageOptions, LoadOptions {
      * browser's native text selection works on document content.
      */
     enableTextSelection?: boolean;
+    /** CSS backgrounds for ordinary and active in-document search matches. */
+    findHighlightColors?: FindHighlightColors;
     /** Called when a page finishes rendering. */
     onPageChange?: (index: number, total: number) => void;
     /** IX9 zoom contract ({@link ZoomableViewer}) — the clamp range for
@@ -3366,12 +3383,21 @@ interface DocxScrollViewerOptions extends Omit<RenderPageOptions, 'onTextRun'>,
      *  shipped back beside the page bitmap, so the overlay is populated identically
      *  to main mode (no more empty overlay / one-time warning). */
     enableTextSelection?: boolean;
+    /** CSS backgrounds for ordinary and active in-document search matches. */
+    findHighlightColors?: FindHighlightColors;
     /** Minimum zoom scale (px-per-pt multiplier floor). Default 0.1. */
     zoomMin?: number;
     /** Maximum zoom scale. Default 4. */
     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 +3436,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 +3584,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 +3876,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
@@ -3938,12 +3981,8 @@ interface DocxHighlightMatch {
     slices: MatchRunSlice[];
     active: boolean;
 }
-interface DocxHighlightColors {
-    /** Fill for non-active matches. */
-    match?: string;
-    /** Fill for the active match. */
-    active?: string;
-}
+/** Format-specific compatibility alias for the shared colour contract. */
+type DocxHighlightColors = FindHighlightColors;
 /**
  * Populate a highlight overlay layer with one box per matched run-slice.
  *
@@ -3965,4 +4004,4 @@ interface DocxHighlightColors {
  */
 declare function buildDocxHighlightLayer(layer: HTMLDivElement, runs: DocxTextRunInfo[], matches: DocxHighlightMatch[], cssWidth: number, cssHeight: number, measureForFont: (font: string) => (s: string) => number, colors?: DocxHighlightColors): void;
 //#endregion
-export { type AnchorHostMetrics, type AutoResizeOptions, type BodyElement, type BorderSpec, type CellBorders, type CellElement, type ChartRun, type ColSpec, type ColumnsSpec, type DocComment, type DocNote, type DocParagraph, type DocRevision, type DocRun, type DocSettings, type DocTable, type DocTableCell, type DocTableRow, DocxDocument, type DocxDocumentModel, type DocxHighlightColors, type DocxHighlightMatch, type DocxMatchLocation, type DocxRunBorder, DocxScrollViewer, type DocxScrollViewerOptions, type DocxTextRun, type DocxTextRunInfo, DocxViewer, type DocxViewerOptions, type EmbeddedFontRef, type FieldRun, type FindMatch, type FindMatchesOptions, type FramePr, type GradientStop, type HeaderFooter, type HeadersFooters, type HyperlinkTarget, type ImageRun, type LineEnd, type LineNumbering, type LineSpacing, type LoadOptions, type NoteRef, type NumberingInfo, OoxmlError, type OoxmlErrorCode, type PTabRun, type PageBorderEdge, type PageBorders, type PageNumType, type ParaBorderEdge, type ParagraphBorders, type PathCmd, type RenderPageOptions, type RenderPageToBitmapOptions, type RubyAnnotation, type RunRevision, type SectionGeom, type SectionProps, type ShapeRun, type ShapeText, type ShapeTextRun, type TabStop, type TableBorders, type TblpPr, type TextPath, type WireRenderPageOptions, autoResize, buildDocxHighlightLayer, buildDocxTextLayer, noteText, openExternalHyperlink };
+export { type AnchorHostMetrics, type AutoResizeOptions, type BodyElement, type BorderSpec, type CellBorders, type CellElement, type ChartRun, type ColSpec, type ColumnsSpec, type DocComment, type DocNote, type DocParagraph, type DocRevision, type DocRun, type DocSettings, type DocTable, type DocTableCell, type DocTableRow, DocxDocument, type DocxDocumentModel, type DocxHighlightColors, type DocxHighlightMatch, type DocxMatchLocation, type DocxRunBorder, DocxScrollViewer, type DocxScrollViewerOptions, type DocxTextRun, type DocxTextRunInfo, DocxViewer, type DocxViewerOptions, type EmbeddedFontRef, type FieldRun, type FindHighlightColors, type FindMatch, type FindMatchesOptions, type FramePr, type GradientStop, type HeaderFooter, type HeadersFooters, type HyperlinkTarget, type ImageRun, type LineEnd, type LineNumbering, type LineSpacing, type LoadOptions, type NoteRef, type NumberingInfo, OoxmlError, type OoxmlErrorCode, type PTabRun, type PageBorderEdge, type PageBorders, type PageNumType, type ParaBorderEdge, type ParagraphBorders, type PathCmd, type RenderPageOptions, type RenderPageToBitmapOptions, type RubyAnnotation, type RunRevision, type SectionGeom, type SectionProps, type ShapeRun, type ShapeText, type ShapeTextRun, type TabStop, type TableBorders, type TblpPr, type TextPath, type WireRenderPageOptions, autoResize, buildDocxHighlightLayer, buildDocxTextLayer, noteText, openExternalHyperlink };

package/dist/types/index.d.ts

@@ -29,7 +29,7 @@ interface MathRenderer {
     mathMLToSvg(mathml: string): Promise<MathSvg>;
 }
 //#endregion
-//#region dist/.types-work/find-match-BE0QHHzK.d.ts
+//#region dist/.types-work/find-highlight-B8ft6Y0g.d.ts
 //#region packages/core/src/types/math.d.ts
 type MathStyle = 'roman' | 'italic' | 'bold' | 'boldItalic';
 interface MathRun {
@@ -1329,7 +1329,22 @@ interface FindMatch<Loc = unknown> {
     location: Loc;
 }
 //#endregion
-//#region dist/.types-work/docx-Cyc_gyvZ.d.ts
+//#region packages/core/src/search/find-highlight.d.ts
+/**
+ * CSS colours used by in-document search overlays.
+ *
+ * The values are applied as the overlay backgrounds verbatim. Use an alpha
+ * colour (`rgba(...)`, 8-digit hex, or `color-mix(...)`) when the rendered text
+ * should remain visible through the highlight.
+ */
+interface FindHighlightColors {
+    /** Background for every match except the active one. */
+    match?: string;
+    /** Background for the match selected by findNext/findPrev. */
+    active?: string;
+}
+//#endregion
+//#region dist/.types-work/docx-BatSd3II.d.ts
 //#region packages/docx/src/types.d.ts
 interface DocxDocumentModel {
     section: SectionProps;
@@ -3072,6 +3087,8 @@ interface DocxViewerOptions extends RenderPageOptions, LoadOptions$2 {
      * browser's native text selection works on document content.
      */
     enableTextSelection?: boolean;
+    /** CSS backgrounds for ordinary and active in-document search matches. */
+    findHighlightColors?: FindHighlightColors;
     /** Called when a page finishes rendering. */
     onPageChange?: (index: number, total: number) => void;
     /** IX9 zoom contract ({@link ZoomableViewer}) — the clamp range for
@@ -3366,12 +3383,21 @@ interface DocxScrollViewerOptions extends Omit<RenderPageOptions, 'onTextRun'>,
      *  shipped back beside the page bitmap, so the overlay is populated identically
      *  to main mode (no more empty overlay / one-time warning). */
     enableTextSelection?: boolean;
+    /** CSS backgrounds for ordinary and active in-document search matches. */
+    findHighlightColors?: FindHighlightColors;
     /** Minimum zoom scale (px-per-pt multiplier floor). Default 0.1. */
     zoomMin?: number;
     /** Maximum zoom scale. Default 4. */
     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 +3436,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 +3584,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 +3876,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
@@ -3938,12 +3981,8 @@ interface DocxHighlightMatch {
     slices: MatchRunSlice[];
     active: boolean;
 }
-interface DocxHighlightColors {
-    /** Fill for non-active matches. */
-    match?: string;
-    /** Fill for the active match. */
-    active?: string;
-}
+/** Format-specific compatibility alias for the shared colour contract. */
+type DocxHighlightColors = FindHighlightColors;
 /**
  * Populate a highlight overlay layer with one box per matched run-slice.
  *
@@ -3965,10 +4004,10 @@ interface DocxHighlightColors {
  */
 declare function buildDocxHighlightLayer(layer: HTMLDivElement, runs: DocxTextRunInfo[], matches: DocxHighlightMatch[], cssWidth: number, cssHeight: number, measureForFont: (font: string) => (s: string) => number, colors?: DocxHighlightColors): void;
 declare namespace docx_d_exports {
-    export { AnchorHostMetrics, AutoResizeOptions, BodyElement, BorderSpec, CellBorders, CellElement, ChartRun, ColSpec, ColumnsSpec, DocComment, DocNote, DocParagraph, DocRevision, DocRun, DocSettings, DocTable, DocTableCell, DocTableRow, DocxDocument, DocxDocumentModel, DocxHighlightColors, DocxHighlightMatch, DocxMatchLocation, DocxRunBorder, DocxScrollViewer, DocxScrollViewerOptions, DocxTextRun, DocxTextRunInfo, DocxViewer, DocxViewerOptions, EmbeddedFontRef, FieldRun, FindMatch, FindMatchesOptions, FramePr, GradientStop$1 as GradientStop, HeaderFooter, HeadersFooters, HyperlinkTarget, ImageRun, LineEnd, LineNumbering, LineSpacing, LoadOptions$2 as LoadOptions, NoteRef, NumberingInfo, OoxmlError, OoxmlErrorCode, PTabRun, PageBorderEdge, PageBorders, PageNumType, ParaBorderEdge, ParagraphBorders, PathCmd$2 as PathCmd, RenderPageOptions, RenderPageToBitmapOptions, RubyAnnotation, RunRevision, SectionGeom, SectionProps, ShapeRun, ShapeText$1 as ShapeText, ShapeTextRun$1 as ShapeTextRun, TabStop$1 as TabStop, TableBorders, TblpPr, TextPath, WireRenderPageOptions, autoResize, buildDocxHighlightLayer, buildDocxTextLayer, noteText, openExternalHyperlink };
+    export { AnchorHostMetrics, AutoResizeOptions, BodyElement, BorderSpec, CellBorders, CellElement, ChartRun, ColSpec, ColumnsSpec, DocComment, DocNote, DocParagraph, DocRevision, DocRun, DocSettings, DocTable, DocTableCell, DocTableRow, DocxDocument, DocxDocumentModel, DocxHighlightColors, DocxHighlightMatch, DocxMatchLocation, DocxRunBorder, DocxScrollViewer, DocxScrollViewerOptions, DocxTextRun, DocxTextRunInfo, DocxViewer, DocxViewerOptions, EmbeddedFontRef, FieldRun, FindHighlightColors, FindMatch, FindMatchesOptions, FramePr, GradientStop$1 as GradientStop, HeaderFooter, HeadersFooters, HyperlinkTarget, ImageRun, LineEnd, LineNumbering, LineSpacing, LoadOptions$2 as LoadOptions, NoteRef, NumberingInfo, OoxmlError, OoxmlErrorCode, PTabRun, PageBorderEdge, PageBorders, PageNumType, ParaBorderEdge, ParagraphBorders, PathCmd$2 as PathCmd, RenderPageOptions, RenderPageToBitmapOptions, RubyAnnotation, RunRevision, SectionGeom, SectionProps, ShapeRun, ShapeText$1 as ShapeText, ShapeTextRun$1 as ShapeTextRun, TabStop$1 as TabStop, TableBorders, TblpPr, TextPath, WireRenderPageOptions, autoResize, buildDocxHighlightLayer, buildDocxTextLayer, noteText, openExternalHyperlink };
 }
 //#endregion
-//#region dist/.types-work/common-5TjSrjhP.d.ts
+//#region dist/.types-work/common-Bva7_XCn.d.ts
 //#region packages/core/src/types/common.d.ts
 type PathCmd$1 = {
     cmd: 'moveTo';
@@ -4440,7 +4479,7 @@ interface RenderOptions {
     skipMediaControls?: boolean;
 }
 //#endregion
-//#region dist/.types-work/pptx-CJgt70hV.d.ts
+//#region dist/.types-work/pptx-lmtZXJAj.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
@@ -5117,6 +5156,11 @@ interface RenderSlideOptions {
     skipMediaControls?: boolean;
     /** Translucent overlay drawn over the finished slide (hidden-slide dimming). */
     dim?: DimOptions;
+    /**
+     * Called for asynchronous embedded-media fetch, decode, and playback
+     * failures created by {@link PptxPresentation.presentSlide}.
+     */
+    onError?: (error: Error) => void;
 }
 /**
  * Headless PPTX rendering engine.
@@ -5312,7 +5356,7 @@ type HiddenSlideMode = 'show' | 'skip' | 'dim';
 interface PptxViewerOptions extends RenderOptions, LoadOptions$1 {
     /** Called when a slide finishes rendering */
     onSlideChange?: (index: number, total: number) => void;
-    /** Called on parse or render errors */
+    /** Called on parse, render, or embedded-media playback errors. */
     onError?: (err: Error) => void;
     /** IX9 zoom contract ({@link ZoomableViewer}) — the clamp range for
      *  {@link PptxViewer.setScale} / `zoomIn` / `zoomOut` / `fitWidth` / `fitPage`,
@@ -5338,6 +5382,8 @@ interface PptxViewerOptions extends RenderOptions, LoadOptions$1 {
      * browser's native text selection works on slide content.
      */
     enableTextSelection?: boolean;
+    /** CSS backgrounds for ordinary and active in-document search matches. */
+    findHighlightColors?: FindHighlightColors;
     /**
      * How hidden slides (`<p:sld show="0">`, §19.3.1.38) are presented:
      * - `'show'` (default): drawn like any other slide.
@@ -5670,6 +5716,22 @@ 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;
+    /** CSS backgrounds for ordinary and active in-document search matches. */
+    findHighlightColors?: FindHighlightColors;
+    /**
+     * 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 +5739,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,15 +5784,17 @@ 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
      *  per-slot render failures (both main `renderSlide` and worker
-     *  `renderSlideToBitmap` rejections); a failed slide is left blank rather than
-     *  crashing the loop. Without an `onError`, render failures are logged via
-     *  `console.error` so they are never fully silent. */
+     *  `renderSlideToBitmap` rejections) and embedded-media fetch/decode/playback
+     *  failures. A failed slide is left blank rather than crashing the loop.
+     *  Without an `onError`, failures are logged via `console.error` so they are
+     *  never fully silent. */
     onError?: (err: Error) => void;
     /**
      * IX1 (design decision — NOT user-confirmed, integrator may veto). Fires on a
@@ -5868,6 +5939,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 +5987,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 +6007,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 +6056,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 +6212,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 +6240,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
@@ -6247,10 +6360,8 @@ interface PptxHighlightMatch {
     slices: MatchRunSlice[];
     active: boolean;
 }
-interface PptxHighlightColors {
-    match?: string;
-    active?: string;
-}
+/** Format-specific compatibility alias for the shared colour contract. */
+type PptxHighlightColors = FindHighlightColors;
 /**
  * Populate a highlight overlay layer with a box per matched run-slice, grouped
  * by shape frame (with the shape's rotation) so each box lands on the drawn
@@ -6271,10 +6382,10 @@ interface PptxHighlightColors {
  */
 declare function buildPptxHighlightLayer(layer: HTMLDivElement, runs: PptxTextRunInfo[], matches: PptxHighlightMatch[], cssWidth: number, cssHeight: number, measureForFont: (font: string) => (s: string) => number, colors?: PptxHighlightColors): void;
 declare namespace pptx_d_exports {
-    export { AutoResizeOptions, Bevel3d, BlipBullet, Bullet, Camera3d, ChartElement, ChartModel, ChartSeries, DimOptions, Fill, FillRect, FindMatch, FindMatchesOptions, Glow, GradientFill, GradientStop, HiddenSlideMode, HyperlinkTarget, ImageFill, LightRig, LineBreak, LoadOptions$1 as LoadOptions, MediaElement, NoFill, OoxmlError, OoxmlErrorCode, Paragraph, PathCmd$1 as PathCmd, PictureElement, PptxComment, PptxHighlightColors, PptxHighlightMatch, PptxMatchLocation, PptxPresentation, PptxScrollViewer, PptxScrollViewerOptions, PptxTextRunInfo, PptxViewer, PptxViewerOptions, Presentation, PresentationHandle, Reflection, RenderOptions, RenderSlideOptions, RenderSlideToBitmapOptions, Rot3d, Scene3d, Shadow, ShapeElement, Slide, SlideElement, SoftEdge, SolidFill, Sp3d, SpaceLine, Stroke, TabStop, TableCell, TableElement, TableRow, TextBody, TextRect, TextRun, TextRunCallback, TextRunData, TileInfo, autoResize, buildPptxHighlightLayer, buildPptxTextLayer, openExternalHyperlink, renderSlide };
+    export { AutoResizeOptions, Bevel3d, BlipBullet, Bullet, Camera3d, ChartElement, ChartModel, ChartSeries, DimOptions, Fill, FillRect, FindHighlightColors, FindMatch, FindMatchesOptions, Glow, GradientFill, GradientStop, HiddenSlideMode, HyperlinkTarget, ImageFill, LightRig, LineBreak, LoadOptions$1 as LoadOptions, MediaElement, NoFill, OoxmlError, OoxmlErrorCode, Paragraph, PathCmd$1 as PathCmd, PictureElement, PptxComment, PptxHighlightColors, PptxHighlightMatch, PptxMatchLocation, PptxPresentation, PptxScrollViewer, PptxScrollViewerOptions, PptxTextRunInfo, PptxViewer, PptxViewerOptions, Presentation, PresentationHandle, Reflection, RenderOptions, RenderSlideOptions, RenderSlideToBitmapOptions, Rot3d, Scene3d, Shadow, ShapeElement, Slide, SlideElement, SoftEdge, SolidFill, Sp3d, SpaceLine, Stroke, TabStop, TableCell, TableElement, TableRow, TextBody, TextRect, TextRun, TextRunCallback, TextRunData, TileInfo, autoResize, buildPptxHighlightLayer, buildPptxTextLayer, openExternalHyperlink, renderSlide };
 }
 //#endregion
-//#region dist/.types-work/xlsx-1vWbvQcb.d.ts
+//#region dist/.types-work/xlsx-DAB_laks.d.ts
 //#region packages/xlsx/src/types.d.ts
 interface Workbook {
     sheets: SheetMeta[];
@@ -7662,6 +7773,8 @@ interface XlsxViewerOptions extends LoadOptions$3 {
      * via {@link XlsxViewer.setSelectionColor}.
      */
     selectionColor?: string;
+    /** CSS backgrounds for ordinary and active in-document search matches. */
+    findHighlightColors?: FindHighlightColors;
     /**
      * `'main'` (default): parse in a worker, render on the main thread. `'worker'`:
      * parse AND render entirely inside the worker and paint the returned
@@ -8304,7 +8417,7 @@ declare class XlsxViewer implements ZoomableViewer {
  */
 declare function resolveSharedStrings(ws: Worksheet, sharedStrings: SharedString[]): Worksheet;
 declare namespace xlsx_d_exports {
-    export { AutoResizeOptions, Border, BorderEdge, Cell, CellAddress, CellFill, CellFont, CellRange, CellValue, CellXf, CfIcon, CfRule, CfStop, CfValue, ChartAnchor, ChartDataLabelOverride, ChartDataPointOverride, ChartErrBars, ChartManualLayout, ChartModel, ChartSeries, ChartSeriesDataLabels, ConditionalFormat, DataLabelOverride, DataPointOverride, DataValidation, DefinedName, Duotone, Dxf, ErrBars, FindMatch, FindMatchesOptions, GradientFillSpec, HiddenSheetMode, Hyperlink, HyperlinkTarget, ImageAnchor, LegendManualLayout, LoadOptions, ManualLayout, MergeCell, NumFmt, OoxmlError, OoxmlErrorCode, OutlinePr, ParsedWorkbook, PathCmd, PathInfo, PhoneticAlignment, PhoneticProperties, PhoneticRun, PhoneticType, PivotCacheSource, PivotDataField, PivotDiagnostic, PivotLocation, PivotMetadataStatus, PivotPageField, PivotPartialReason, PivotTableMetadata, RenderViewportOptions, ResolvedList, Row, Run, RunFont, SelectionMode, SeriesDataLabels, ShapeAnchor, ShapeGeom, ShapeInfo, ShapeParagraph, ShapeText, ShapeTextRun, SharedString, SheetMeta, SheetVisibility, SlicerAnchor, SlicerElementStyle, SlicerItem, SlicerStyle, Sparkline, SparklineGroup, Styles, TableColumnInfo, TableInfo, ViewportRange, WireRenderViewportOptions, WireSizeOverrides, Workbook, Worksheet, XlsxChartSeries, XlsxComment, XlsxMatchLocation, XlsxTextRunInfo, XlsxViewer, XlsxViewerOptions, XlsxWorkbook, autoResize, openExternalHyperlink, resolveSharedStrings };
+    export { AutoResizeOptions, Border, BorderEdge, Cell, CellAddress, CellFill, CellFont, CellRange, CellValue, CellXf, CfIcon, CfRule, CfStop, CfValue, ChartAnchor, ChartDataLabelOverride, ChartDataPointOverride, ChartErrBars, ChartManualLayout, ChartModel, ChartSeries, ChartSeriesDataLabels, ConditionalFormat, DataLabelOverride, DataPointOverride, DataValidation, DefinedName, Duotone, Dxf, ErrBars, FindHighlightColors, FindMatch, FindMatchesOptions, GradientFillSpec, HiddenSheetMode, Hyperlink, HyperlinkTarget, ImageAnchor, LegendManualLayout, LoadOptions, ManualLayout, MergeCell, NumFmt, OoxmlError, OoxmlErrorCode, OutlinePr, ParsedWorkbook, PathCmd, PathInfo, PhoneticAlignment, PhoneticProperties, PhoneticRun, PhoneticType, PivotCacheSource, PivotDataField, PivotDiagnostic, PivotLocation, PivotMetadataStatus, PivotPageField, PivotPartialReason, PivotTableMetadata, RenderViewportOptions, ResolvedList, Row, Run, RunFont, SelectionMode, SeriesDataLabels, ShapeAnchor, ShapeGeom, ShapeInfo, ShapeParagraph, ShapeText, ShapeTextRun, SharedString, SheetMeta, SheetVisibility, SlicerAnchor, SlicerElementStyle, SlicerItem, SlicerStyle, Sparkline, SparklineGroup, Styles, TableColumnInfo, TableInfo, ViewportRange, WireRenderViewportOptions, WireSizeOverrides, Workbook, Worksheet, XlsxChartSeries, XlsxComment, XlsxMatchLocation, XlsxTextRunInfo, XlsxViewer, XlsxViewerOptions, XlsxWorkbook, autoResize, openExternalHyperlink, resolveSharedStrings };
 }
 //#endregion
 export { docx_d_exports as docx, pptx_d_exports as pptx, xlsx_d_exports as xlsx };