@silurus/ooxml 0.74.3 → 0.74.5

package/dist/types/pptx.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/common-5TjSrjhP.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/common-Bva7_XCn.d.ts
 //#region packages/core/src/types/common.d.ts
 type PathCmd = {
     cmd: 'moveTo';
@@ -1801,7 +1816,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
@@ -2478,6 +2493,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.
@@ -2673,7 +2693,7 @@ type HiddenSlideMode = 'show' | 'skip' | 'dim';
 interface PptxViewerOptions extends RenderOptions, LoadOptions {
     /** 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`,
@@ -2699,6 +2719,8 @@ interface PptxViewerOptions extends RenderOptions, LoadOptions {
      * 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.
@@ -3031,6 +3053,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;
@@ -3038,6 +3076,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,15 +3121,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
@@ -3229,6 +3276,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 +3324,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 +3344,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 +3393,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 +3549,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 +3577,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
@@ -3608,10 +3697,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
@@ -3632,4 +3719,4 @@ interface PptxHighlightColors {
  */
 declare function buildPptxHighlightLayer(layer: HTMLDivElement, runs: PptxTextRunInfo[], matches: PptxHighlightMatch[], cssWidth: number, cssHeight: number, measureForFont: (font: string) => (s: string) => number, colors?: PptxHighlightColors): void;
 //#endregion
-export { type AutoResizeOptions, type Bevel3d, type BlipBullet, type Bullet, type Camera3d, type ChartElement, type ChartModel, type ChartSeries, type DimOptions, type Fill, type FillRect, type FindMatch, type FindMatchesOptions, type Glow, type GradientFill, type GradientStop, type HiddenSlideMode, type HyperlinkTarget, type ImageFill, type LightRig, type LineBreak, type LoadOptions, type MediaElement, type NoFill, OoxmlError, type OoxmlErrorCode, type Paragraph, type PathCmd, type PictureElement, type PptxComment, type PptxHighlightColors, type PptxHighlightMatch, type PptxMatchLocation, PptxPresentation, PptxScrollViewer, type PptxScrollViewerOptions, type PptxTextRunInfo, PptxViewer, type PptxViewerOptions, type Presentation, type PresentationHandle, type Reflection, type RenderOptions, type RenderSlideOptions, type RenderSlideToBitmapOptions, type Rot3d, type Scene3d, type Shadow, type ShapeElement, type Slide, type SlideElement, type SoftEdge, type SolidFill, type Sp3d, type SpaceLine, type Stroke, type TabStop, type TableCell, type TableElement, type TableRow, type TextBody, type TextRect, type TextRun, type TextRunCallback, type TextRunData, type TileInfo, autoResize, buildPptxHighlightLayer, buildPptxTextLayer, openExternalHyperlink, renderSlide };
+export { type AutoResizeOptions, type Bevel3d, type BlipBullet, type Bullet, type Camera3d, type ChartElement, type ChartModel, type ChartSeries, type DimOptions, type Fill, type FillRect, type FindHighlightColors, type FindMatch, type FindMatchesOptions, type Glow, type GradientFill, type GradientStop, type HiddenSlideMode, type HyperlinkTarget, type ImageFill, type LightRig, type LineBreak, type LoadOptions, type MediaElement, type NoFill, OoxmlError, type OoxmlErrorCode, type Paragraph, type PathCmd, type PictureElement, type PptxComment, type PptxHighlightColors, type PptxHighlightMatch, type PptxMatchLocation, PptxPresentation, PptxScrollViewer, type PptxScrollViewerOptions, type PptxTextRunInfo, PptxViewer, type PptxViewerOptions, type Presentation, type PresentationHandle, type Reflection, type RenderOptions, type RenderSlideOptions, type RenderSlideToBitmapOptions, type Rot3d, type Scene3d, type Shadow, type ShapeElement, type Slide, type SlideElement, type SoftEdge, type SolidFill, type Sp3d, type SpaceLine, type Stroke, type TabStop, type TableCell, type TableElement, type TableRow, type TextBody, type TextRect, type TextRun, type TextRunCallback, type TextRunData, type TileInfo, autoResize, buildPptxHighlightLayer, buildPptxTextLayer, openExternalHyperlink, renderSlide };

package/dist/types/xlsx.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 {
@@ -1297,7 +1297,22 @@ interface FindMatch<Loc = unknown> {
     location: Loc;
 }
 //#endregion
-//#region dist/.types-work/common-5TjSrjhP.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/common-Bva7_XCn.d.ts
 type SpaceLine = {
     type: 'pct';
     val: number;
@@ -1306,7 +1321,7 @@ type SpaceLine = {
     val: number;
 };
 //#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[];
@@ -2694,6 +2709,8 @@ interface XlsxViewerOptions extends LoadOptions$1 {
      * 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
@@ -3336,4 +3353,4 @@ declare class XlsxViewer implements ZoomableViewer {
  */
 declare function resolveSharedStrings(ws: Worksheet, sharedStrings: SharedString[]): Worksheet;
 //#endregion
-export { type AutoResizeOptions, type Border, type BorderEdge, type Cell, type CellAddress, type CellFill, type CellFont, type CellRange, type CellValue, type CellXf, type CfIcon, type CfRule, type CfStop, type CfValue, type ChartAnchor, type ChartDataLabelOverride, type ChartDataPointOverride, type ChartErrBars, type ChartManualLayout, type ChartModel, type ChartSeries, type ChartSeriesDataLabels, type ConditionalFormat, type DataLabelOverride, type DataPointOverride, type DataValidation, type DefinedName, type Duotone, type Dxf, type ErrBars, type FindMatch, type FindMatchesOptions, type GradientFillSpec, type HiddenSheetMode, type Hyperlink, type HyperlinkTarget, type ImageAnchor, type LegendManualLayout, type LoadOptions, type ManualLayout, type MergeCell, type NumFmt, OoxmlError, type OoxmlErrorCode, type OutlinePr, type ParsedWorkbook, type PathCmd, type PathInfo, type PhoneticAlignment, type PhoneticProperties, type PhoneticRun, type PhoneticType, type PivotCacheSource, type PivotDataField, type PivotDiagnostic, type PivotLocation, type PivotMetadataStatus, type PivotPageField, type PivotPartialReason, type PivotTableMetadata, type RenderViewportOptions, type ResolvedList, type Row, type Run, type RunFont, type SelectionMode, type SeriesDataLabels, type ShapeAnchor, type ShapeGeom, type ShapeInfo, type ShapeParagraph, type ShapeText, type ShapeTextRun, type SharedString, type SheetMeta, type SheetVisibility, type SlicerAnchor, type SlicerElementStyle, type SlicerItem, type SlicerStyle, type Sparkline, type SparklineGroup, type Styles, type TableColumnInfo, type TableInfo, type ViewportRange, type WireRenderViewportOptions, type WireSizeOverrides, type Workbook, type Worksheet, type XlsxChartSeries, type XlsxComment, type XlsxMatchLocation, type XlsxTextRunInfo, XlsxViewer, type XlsxViewerOptions, XlsxWorkbook, autoResize, openExternalHyperlink, resolveSharedStrings };
+export { type AutoResizeOptions, type Border, type BorderEdge, type Cell, type CellAddress, type CellFill, type CellFont, type CellRange, type CellValue, type CellXf, type CfIcon, type CfRule, type CfStop, type CfValue, type ChartAnchor, type ChartDataLabelOverride, type ChartDataPointOverride, type ChartErrBars, type ChartManualLayout, type ChartModel, type ChartSeries, type ChartSeriesDataLabels, type ConditionalFormat, type DataLabelOverride, type DataPointOverride, type DataValidation, type DefinedName, type Duotone, type Dxf, type ErrBars, type FindHighlightColors, type FindMatch, type FindMatchesOptions, type GradientFillSpec, type HiddenSheetMode, type Hyperlink, type HyperlinkTarget, type ImageAnchor, type LegendManualLayout, type LoadOptions, type ManualLayout, type MergeCell, type NumFmt, OoxmlError, type OoxmlErrorCode, type OutlinePr, type ParsedWorkbook, type PathCmd, type PathInfo, type PhoneticAlignment, type PhoneticProperties, type PhoneticRun, type PhoneticType, type PivotCacheSource, type PivotDataField, type PivotDiagnostic, type PivotLocation, type PivotMetadataStatus, type PivotPageField, type PivotPartialReason, type PivotTableMetadata, type RenderViewportOptions, type ResolvedList, type Row, type Run, type RunFont, type SelectionMode, type SeriesDataLabels, type ShapeAnchor, type ShapeGeom, type ShapeInfo, type ShapeParagraph, type ShapeText, type ShapeTextRun, type SharedString, type SheetMeta, type SheetVisibility, type SlicerAnchor, type SlicerElementStyle, type SlicerItem, type SlicerStyle, type Sparkline, type SparklineGroup, type Styles, type TableColumnInfo, type TableInfo, type ViewportRange, type WireRenderViewportOptions, type WireSizeOverrides, type Workbook, type Worksheet, type XlsxChartSeries, type XlsxComment, type XlsxMatchLocation, type XlsxTextRunInfo, XlsxViewer, type XlsxViewerOptions, XlsxWorkbook, autoResize, openExternalHyperlink, resolveSharedStrings };