@silurus/ooxml 0.74.4 → 0.74.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -29,7 +29,7 @@ interface MathRenderer {
29
29
  mathMLToSvg(mathml: string): Promise<MathSvg>;
30
30
  }
31
31
  //#endregion
32
- //#region dist/.types-work/find-match-BE0QHHzK.d.ts
32
+ //#region dist/.types-work/find-highlight-B8ft6Y0g.d.ts
33
33
  //#region packages/core/src/types/math.d.ts
34
34
  type MathStyle = 'roman' | 'italic' | 'bold' | 'boldItalic';
35
35
  interface MathRun {
@@ -1329,7 +1329,22 @@ interface FindMatch<Loc = unknown> {
1329
1329
  location: Loc;
1330
1330
  }
1331
1331
  //#endregion
1332
- //#region dist/.types-work/docx-Cc2gf7b0.d.ts
1332
+ //#region packages/core/src/search/find-highlight.d.ts
1333
+ /**
1334
+ * CSS colours used by in-document search overlays.
1335
+ *
1336
+ * The values are applied as the overlay backgrounds verbatim. Use an alpha
1337
+ * colour (`rgba(...)`, 8-digit hex, or `color-mix(...)`) when the rendered text
1338
+ * should remain visible through the highlight.
1339
+ */
1340
+ interface FindHighlightColors {
1341
+ /** Background for every match except the active one. */
1342
+ match?: string;
1343
+ /** Background for the match selected by findNext/findPrev. */
1344
+ active?: string;
1345
+ }
1346
+ //#endregion
1347
+ //#region dist/.types-work/docx-BatSd3II.d.ts
1333
1348
  //#region packages/docx/src/types.d.ts
1334
1349
  interface DocxDocumentModel {
1335
1350
  section: SectionProps;
@@ -3072,6 +3087,8 @@ interface DocxViewerOptions extends RenderPageOptions, LoadOptions {
3072
3087
  * browser's native text selection works on document content.
3073
3088
  */
3074
3089
  enableTextSelection?: boolean;
3090
+ /** CSS backgrounds for ordinary and active in-document search matches. */
3091
+ findHighlightColors?: FindHighlightColors;
3075
3092
  /** Called when a page finishes rendering. */
3076
3093
  onPageChange?: (index: number, total: number) => void;
3077
3094
  /** IX9 zoom contract ({@link ZoomableViewer}) — the clamp range for
@@ -3366,6 +3383,8 @@ interface DocxScrollViewerOptions extends Omit<RenderPageOptions, 'onTextRun'>,
3366
3383
  * shipped back beside the page bitmap, so the overlay is populated identically
3367
3384
  * to main mode (no more empty overlay / one-time warning). */
3368
3385
  enableTextSelection?: boolean;
3386
+ /** CSS backgrounds for ordinary and active in-document search matches. */
3387
+ findHighlightColors?: FindHighlightColors;
3369
3388
  /** Minimum zoom scale (px-per-pt multiplier floor). Default 0.1. */
3370
3389
  zoomMin?: number;
3371
3390
  /** Maximum zoom scale. Default 4. */
@@ -3962,12 +3981,8 @@ interface DocxHighlightMatch {
3962
3981
  slices: MatchRunSlice[];
3963
3982
  active: boolean;
3964
3983
  }
3965
- interface DocxHighlightColors {
3966
- /** Fill for non-active matches. */
3967
- match?: string;
3968
- /** Fill for the active match. */
3969
- active?: string;
3970
- }
3984
+ /** Format-specific compatibility alias for the shared colour contract. */
3985
+ type DocxHighlightColors = FindHighlightColors;
3971
3986
  /**
3972
3987
  * Populate a highlight overlay layer with one box per matched run-slice.
3973
3988
  *
@@ -3989,4 +4004,4 @@ interface DocxHighlightColors {
3989
4004
  */
3990
4005
  declare function buildDocxHighlightLayer(layer: HTMLDivElement, runs: DocxTextRunInfo[], matches: DocxHighlightMatch[], cssWidth: number, cssHeight: number, measureForFont: (font: string) => (s: string) => number, colors?: DocxHighlightColors): void;
3991
4006
  //#endregion
3992
- 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 };
4007
+ 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 };
@@ -29,7 +29,7 @@ interface MathRenderer {
29
29
  mathMLToSvg(mathml: string): Promise<MathSvg>;
30
30
  }
31
31
  //#endregion
32
- //#region dist/.types-work/find-match-BE0QHHzK.d.ts
32
+ //#region dist/.types-work/find-highlight-B8ft6Y0g.d.ts
33
33
  //#region packages/core/src/types/math.d.ts
34
34
  type MathStyle = 'roman' | 'italic' | 'bold' | 'boldItalic';
35
35
  interface MathRun {
@@ -1329,7 +1329,22 @@ interface FindMatch<Loc = unknown> {
1329
1329
  location: Loc;
1330
1330
  }
1331
1331
  //#endregion
1332
- //#region dist/.types-work/docx-Cc2gf7b0.d.ts
1332
+ //#region packages/core/src/search/find-highlight.d.ts
1333
+ /**
1334
+ * CSS colours used by in-document search overlays.
1335
+ *
1336
+ * The values are applied as the overlay backgrounds verbatim. Use an alpha
1337
+ * colour (`rgba(...)`, 8-digit hex, or `color-mix(...)`) when the rendered text
1338
+ * should remain visible through the highlight.
1339
+ */
1340
+ interface FindHighlightColors {
1341
+ /** Background for every match except the active one. */
1342
+ match?: string;
1343
+ /** Background for the match selected by findNext/findPrev. */
1344
+ active?: string;
1345
+ }
1346
+ //#endregion
1347
+ //#region dist/.types-work/docx-BatSd3II.d.ts
1333
1348
  //#region packages/docx/src/types.d.ts
1334
1349
  interface DocxDocumentModel {
1335
1350
  section: SectionProps;
@@ -3072,6 +3087,8 @@ interface DocxViewerOptions extends RenderPageOptions, LoadOptions$2 {
3072
3087
  * browser's native text selection works on document content.
3073
3088
  */
3074
3089
  enableTextSelection?: boolean;
3090
+ /** CSS backgrounds for ordinary and active in-document search matches. */
3091
+ findHighlightColors?: FindHighlightColors;
3075
3092
  /** Called when a page finishes rendering. */
3076
3093
  onPageChange?: (index: number, total: number) => void;
3077
3094
  /** IX9 zoom contract ({@link ZoomableViewer}) — the clamp range for
@@ -3366,6 +3383,8 @@ interface DocxScrollViewerOptions extends Omit<RenderPageOptions, 'onTextRun'>,
3366
3383
  * shipped back beside the page bitmap, so the overlay is populated identically
3367
3384
  * to main mode (no more empty overlay / one-time warning). */
3368
3385
  enableTextSelection?: boolean;
3386
+ /** CSS backgrounds for ordinary and active in-document search matches. */
3387
+ findHighlightColors?: FindHighlightColors;
3369
3388
  /** Minimum zoom scale (px-per-pt multiplier floor). Default 0.1. */
3370
3389
  zoomMin?: number;
3371
3390
  /** Maximum zoom scale. Default 4. */
@@ -3962,12 +3981,8 @@ interface DocxHighlightMatch {
3962
3981
  slices: MatchRunSlice[];
3963
3982
  active: boolean;
3964
3983
  }
3965
- interface DocxHighlightColors {
3966
- /** Fill for non-active matches. */
3967
- match?: string;
3968
- /** Fill for the active match. */
3969
- active?: string;
3970
- }
3984
+ /** Format-specific compatibility alias for the shared colour contract. */
3985
+ type DocxHighlightColors = FindHighlightColors;
3971
3986
  /**
3972
3987
  * Populate a highlight overlay layer with one box per matched run-slice.
3973
3988
  *
@@ -3989,10 +4004,10 @@ interface DocxHighlightColors {
3989
4004
  */
3990
4005
  declare function buildDocxHighlightLayer(layer: HTMLDivElement, runs: DocxTextRunInfo[], matches: DocxHighlightMatch[], cssWidth: number, cssHeight: number, measureForFont: (font: string) => (s: string) => number, colors?: DocxHighlightColors): void;
3991
4006
  declare namespace docx_d_exports {
3992
- 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 };
4007
+ 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 };
3993
4008
  }
3994
4009
  //#endregion
3995
- //#region dist/.types-work/common-5TjSrjhP.d.ts
4010
+ //#region dist/.types-work/common-Bva7_XCn.d.ts
3996
4011
  //#region packages/core/src/types/common.d.ts
3997
4012
  type PathCmd$1 = {
3998
4013
  cmd: 'moveTo';
@@ -4464,7 +4479,7 @@ interface RenderOptions {
4464
4479
  skipMediaControls?: boolean;
4465
4480
  }
4466
4481
  //#endregion
4467
- //#region dist/.types-work/pptx-ChHwV9HX.d.ts
4482
+ //#region dist/.types-work/pptx-lmtZXJAj.d.ts
4468
4483
  //#region packages/pptx/src/types.d.ts
4469
4484
  /**
4470
4485
  * Picture bullet — ECMA-376 §21.1.2.4.2 `<a:buBlip><a:blip r:embed>`. The
@@ -5141,6 +5156,11 @@ interface RenderSlideOptions {
5141
5156
  skipMediaControls?: boolean;
5142
5157
  /** Translucent overlay drawn over the finished slide (hidden-slide dimming). */
5143
5158
  dim?: DimOptions;
5159
+ /**
5160
+ * Called for asynchronous embedded-media fetch, decode, and playback
5161
+ * failures created by {@link PptxPresentation.presentSlide}.
5162
+ */
5163
+ onError?: (error: Error) => void;
5144
5164
  }
5145
5165
  /**
5146
5166
  * Headless PPTX rendering engine.
@@ -5336,7 +5356,7 @@ type HiddenSlideMode = 'show' | 'skip' | 'dim';
5336
5356
  interface PptxViewerOptions extends RenderOptions, LoadOptions$1 {
5337
5357
  /** Called when a slide finishes rendering */
5338
5358
  onSlideChange?: (index: number, total: number) => void;
5339
- /** Called on parse or render errors */
5359
+ /** Called on parse, render, or embedded-media playback errors. */
5340
5360
  onError?: (err: Error) => void;
5341
5361
  /** IX9 zoom contract ({@link ZoomableViewer}) — the clamp range for
5342
5362
  * {@link PptxViewer.setScale} / `zoomIn` / `zoomOut` / `fitWidth` / `fitPage`,
@@ -5362,6 +5382,8 @@ interface PptxViewerOptions extends RenderOptions, LoadOptions$1 {
5362
5382
  * browser's native text selection works on slide content.
5363
5383
  */
5364
5384
  enableTextSelection?: boolean;
5385
+ /** CSS backgrounds for ordinary and active in-document search matches. */
5386
+ findHighlightColors?: FindHighlightColors;
5365
5387
  /**
5366
5388
  * How hidden slides (`<p:sld show="0">`, §19.3.1.38) are presented:
5367
5389
  * - `'show'` (default): drawn like any other slide.
@@ -5694,6 +5716,8 @@ interface PptxScrollViewerOptions extends Omit<RenderSlideOptions, 'onTextRun'>,
5694
5716
  * shipped back beside the slide bitmap, so the overlay is populated identically
5695
5717
  * to main mode (no more empty overlay / one-time warning). */
5696
5718
  enableTextSelection?: boolean;
5719
+ /** CSS backgrounds for ordinary and active in-document search matches. */
5720
+ findHighlightColors?: FindHighlightColors;
5697
5721
  /**
5698
5722
  * Enable interactive audio/video playback. When true, mounted slides render
5699
5723
  * through {@link PptxPresentation.presentSlide} only while they are inside the
@@ -5767,9 +5791,10 @@ interface PptxScrollViewerOptions extends Omit<RenderSlideOptions, 'onTextRun'>,
5767
5791
  /** Error callback. When set, `load()` invokes it and resolves (otherwise the
5768
5792
  * error is rethrown — shared viewer error contract). It ALSO fires for async
5769
5793
  * per-slot render failures (both main `renderSlide` and worker
5770
- * `renderSlideToBitmap` rejections); a failed slide is left blank rather than
5771
- * crashing the loop. Without an `onError`, render failures are logged via
5772
- * `console.error` so they are never fully silent. */
5794
+ * `renderSlideToBitmap` rejections) and embedded-media fetch/decode/playback
5795
+ * failures. A failed slide is left blank rather than crashing the loop.
5796
+ * Without an `onError`, failures are logged via `console.error` so they are
5797
+ * never fully silent. */
5773
5798
  onError?: (err: Error) => void;
5774
5799
  /**
5775
5800
  * IX1 (design decision — NOT user-confirmed, integrator may veto). Fires on a
@@ -6335,10 +6360,8 @@ interface PptxHighlightMatch {
6335
6360
  slices: MatchRunSlice[];
6336
6361
  active: boolean;
6337
6362
  }
6338
- interface PptxHighlightColors {
6339
- match?: string;
6340
- active?: string;
6341
- }
6363
+ /** Format-specific compatibility alias for the shared colour contract. */
6364
+ type PptxHighlightColors = FindHighlightColors;
6342
6365
  /**
6343
6366
  * Populate a highlight overlay layer with a box per matched run-slice, grouped
6344
6367
  * by shape frame (with the shape's rotation) so each box lands on the drawn
@@ -6359,10 +6382,10 @@ interface PptxHighlightColors {
6359
6382
  */
6360
6383
  declare function buildPptxHighlightLayer(layer: HTMLDivElement, runs: PptxTextRunInfo[], matches: PptxHighlightMatch[], cssWidth: number, cssHeight: number, measureForFont: (font: string) => (s: string) => number, colors?: PptxHighlightColors): void;
6361
6384
  declare namespace pptx_d_exports {
6362
- 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 };
6385
+ 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 };
6363
6386
  }
6364
6387
  //#endregion
6365
- //#region dist/.types-work/xlsx-1vWbvQcb.d.ts
6388
+ //#region dist/.types-work/xlsx-DAB_laks.d.ts
6366
6389
  //#region packages/xlsx/src/types.d.ts
6367
6390
  interface Workbook {
6368
6391
  sheets: SheetMeta[];
@@ -7750,6 +7773,8 @@ interface XlsxViewerOptions extends LoadOptions$3 {
7750
7773
  * via {@link XlsxViewer.setSelectionColor}.
7751
7774
  */
7752
7775
  selectionColor?: string;
7776
+ /** CSS backgrounds for ordinary and active in-document search matches. */
7777
+ findHighlightColors?: FindHighlightColors;
7753
7778
  /**
7754
7779
  * `'main'` (default): parse in a worker, render on the main thread. `'worker'`:
7755
7780
  * parse AND render entirely inside the worker and paint the returned
@@ -8392,7 +8417,7 @@ declare class XlsxViewer implements ZoomableViewer {
8392
8417
  */
8393
8418
  declare function resolveSharedStrings(ws: Worksheet, sharedStrings: SharedString[]): Worksheet;
8394
8419
  declare namespace xlsx_d_exports {
8395
- 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 };
8420
+ 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 };
8396
8421
  }
8397
8422
  //#endregion
8398
8423
  export { docx_d_exports as docx, pptx_d_exports as pptx, xlsx_d_exports as xlsx };
@@ -29,7 +29,7 @@ interface MathRenderer {
29
29
  mathMLToSvg(mathml: string): Promise<MathSvg>;
30
30
  }
31
31
  //#endregion
32
- //#region dist/.types-work/find-match-BE0QHHzK.d.ts
32
+ //#region dist/.types-work/find-highlight-B8ft6Y0g.d.ts
33
33
  //#region packages/core/src/types/math.d.ts
34
34
  type MathStyle = 'roman' | 'italic' | 'bold' | 'boldItalic';
35
35
  interface MathRun {
@@ -1329,7 +1329,22 @@ interface FindMatch<Loc = unknown> {
1329
1329
  location: Loc;
1330
1330
  }
1331
1331
  //#endregion
1332
- //#region dist/.types-work/common-5TjSrjhP.d.ts
1332
+ //#region packages/core/src/search/find-highlight.d.ts
1333
+ /**
1334
+ * CSS colours used by in-document search overlays.
1335
+ *
1336
+ * The values are applied as the overlay backgrounds verbatim. Use an alpha
1337
+ * colour (`rgba(...)`, 8-digit hex, or `color-mix(...)`) when the rendered text
1338
+ * should remain visible through the highlight.
1339
+ */
1340
+ interface FindHighlightColors {
1341
+ /** Background for every match except the active one. */
1342
+ match?: string;
1343
+ /** Background for the match selected by findNext/findPrev. */
1344
+ active?: string;
1345
+ }
1346
+ //#endregion
1347
+ //#region dist/.types-work/common-Bva7_XCn.d.ts
1333
1348
  //#region packages/core/src/types/common.d.ts
1334
1349
  type PathCmd = {
1335
1350
  cmd: 'moveTo';
@@ -1801,7 +1816,7 @@ interface RenderOptions {
1801
1816
  skipMediaControls?: boolean;
1802
1817
  }
1803
1818
  //#endregion
1804
- //#region dist/.types-work/pptx-ChHwV9HX.d.ts
1819
+ //#region dist/.types-work/pptx-lmtZXJAj.d.ts
1805
1820
  //#region packages/pptx/src/types.d.ts
1806
1821
  /**
1807
1822
  * Picture bullet — ECMA-376 §21.1.2.4.2 `<a:buBlip><a:blip r:embed>`. The
@@ -2478,6 +2493,11 @@ interface RenderSlideOptions {
2478
2493
  skipMediaControls?: boolean;
2479
2494
  /** Translucent overlay drawn over the finished slide (hidden-slide dimming). */
2480
2495
  dim?: DimOptions;
2496
+ /**
2497
+ * Called for asynchronous embedded-media fetch, decode, and playback
2498
+ * failures created by {@link PptxPresentation.presentSlide}.
2499
+ */
2500
+ onError?: (error: Error) => void;
2481
2501
  }
2482
2502
  /**
2483
2503
  * Headless PPTX rendering engine.
@@ -2673,7 +2693,7 @@ type HiddenSlideMode = 'show' | 'skip' | 'dim';
2673
2693
  interface PptxViewerOptions extends RenderOptions, LoadOptions {
2674
2694
  /** Called when a slide finishes rendering */
2675
2695
  onSlideChange?: (index: number, total: number) => void;
2676
- /** Called on parse or render errors */
2696
+ /** Called on parse, render, or embedded-media playback errors. */
2677
2697
  onError?: (err: Error) => void;
2678
2698
  /** IX9 zoom contract ({@link ZoomableViewer}) — the clamp range for
2679
2699
  * {@link PptxViewer.setScale} / `zoomIn` / `zoomOut` / `fitWidth` / `fitPage`,
@@ -2699,6 +2719,8 @@ interface PptxViewerOptions extends RenderOptions, LoadOptions {
2699
2719
  * browser's native text selection works on slide content.
2700
2720
  */
2701
2721
  enableTextSelection?: boolean;
2722
+ /** CSS backgrounds for ordinary and active in-document search matches. */
2723
+ findHighlightColors?: FindHighlightColors;
2702
2724
  /**
2703
2725
  * How hidden slides (`<p:sld show="0">`, §19.3.1.38) are presented:
2704
2726
  * - `'show'` (default): drawn like any other slide.
@@ -3031,6 +3053,8 @@ interface PptxScrollViewerOptions extends Omit<RenderSlideOptions, 'onTextRun'>,
3031
3053
  * shipped back beside the slide bitmap, so the overlay is populated identically
3032
3054
  * to main mode (no more empty overlay / one-time warning). */
3033
3055
  enableTextSelection?: boolean;
3056
+ /** CSS backgrounds for ordinary and active in-document search matches. */
3057
+ findHighlightColors?: FindHighlightColors;
3034
3058
  /**
3035
3059
  * Enable interactive audio/video playback. When true, mounted slides render
3036
3060
  * through {@link PptxPresentation.presentSlide} only while they are inside the
@@ -3104,9 +3128,10 @@ interface PptxScrollViewerOptions extends Omit<RenderSlideOptions, 'onTextRun'>,
3104
3128
  /** Error callback. When set, `load()` invokes it and resolves (otherwise the
3105
3129
  * error is rethrown — shared viewer error contract). It ALSO fires for async
3106
3130
  * per-slot render failures (both main `renderSlide` and worker
3107
- * `renderSlideToBitmap` rejections); a failed slide is left blank rather than
3108
- * crashing the loop. Without an `onError`, render failures are logged via
3109
- * `console.error` so they are never fully silent. */
3131
+ * `renderSlideToBitmap` rejections) and embedded-media fetch/decode/playback
3132
+ * failures. A failed slide is left blank rather than crashing the loop.
3133
+ * Without an `onError`, failures are logged via `console.error` so they are
3134
+ * never fully silent. */
3110
3135
  onError?: (err: Error) => void;
3111
3136
  /**
3112
3137
  * IX1 (design decision — NOT user-confirmed, integrator may veto). Fires on a
@@ -3672,10 +3697,8 @@ interface PptxHighlightMatch {
3672
3697
  slices: MatchRunSlice[];
3673
3698
  active: boolean;
3674
3699
  }
3675
- interface PptxHighlightColors {
3676
- match?: string;
3677
- active?: string;
3678
- }
3700
+ /** Format-specific compatibility alias for the shared colour contract. */
3701
+ type PptxHighlightColors = FindHighlightColors;
3679
3702
  /**
3680
3703
  * Populate a highlight overlay layer with a box per matched run-slice, grouped
3681
3704
  * by shape frame (with the shape's rotation) so each box lands on the drawn
@@ -3696,4 +3719,4 @@ interface PptxHighlightColors {
3696
3719
  */
3697
3720
  declare function buildPptxHighlightLayer(layer: HTMLDivElement, runs: PptxTextRunInfo[], matches: PptxHighlightMatch[], cssWidth: number, cssHeight: number, measureForFont: (font: string) => (s: string) => number, colors?: PptxHighlightColors): void;
3698
3721
  //#endregion
3699
- 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 };
3722
+ 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 };
@@ -29,7 +29,7 @@ interface MathRenderer {
29
29
  mathMLToSvg(mathml: string): Promise<MathSvg>;
30
30
  }
31
31
  //#endregion
32
- //#region dist/.types-work/find-match-BE0QHHzK.d.ts
32
+ //#region dist/.types-work/find-highlight-B8ft6Y0g.d.ts
33
33
  //#region packages/core/src/types/math.d.ts
34
34
  type MathStyle = 'roman' | 'italic' | 'bold' | 'boldItalic';
35
35
  interface MathRun {
@@ -1297,7 +1297,22 @@ interface FindMatch<Loc = unknown> {
1297
1297
  location: Loc;
1298
1298
  }
1299
1299
  //#endregion
1300
- //#region dist/.types-work/common-5TjSrjhP.d.ts
1300
+ //#region packages/core/src/search/find-highlight.d.ts
1301
+ /**
1302
+ * CSS colours used by in-document search overlays.
1303
+ *
1304
+ * The values are applied as the overlay backgrounds verbatim. Use an alpha
1305
+ * colour (`rgba(...)`, 8-digit hex, or `color-mix(...)`) when the rendered text
1306
+ * should remain visible through the highlight.
1307
+ */
1308
+ interface FindHighlightColors {
1309
+ /** Background for every match except the active one. */
1310
+ match?: string;
1311
+ /** Background for the match selected by findNext/findPrev. */
1312
+ active?: string;
1313
+ }
1314
+ //#endregion
1315
+ //#region dist/.types-work/common-Bva7_XCn.d.ts
1301
1316
  type SpaceLine = {
1302
1317
  type: 'pct';
1303
1318
  val: number;
@@ -1306,7 +1321,7 @@ type SpaceLine = {
1306
1321
  val: number;
1307
1322
  };
1308
1323
  //#endregion
1309
- //#region dist/.types-work/xlsx-1vWbvQcb.d.ts
1324
+ //#region dist/.types-work/xlsx-DAB_laks.d.ts
1310
1325
  //#region packages/xlsx/src/types.d.ts
1311
1326
  interface Workbook {
1312
1327
  sheets: SheetMeta[];
@@ -2694,6 +2709,8 @@ interface XlsxViewerOptions extends LoadOptions$1 {
2694
2709
  * via {@link XlsxViewer.setSelectionColor}.
2695
2710
  */
2696
2711
  selectionColor?: string;
2712
+ /** CSS backgrounds for ordinary and active in-document search matches. */
2713
+ findHighlightColors?: FindHighlightColors;
2697
2714
  /**
2698
2715
  * `'main'` (default): parse in a worker, render on the main thread. `'worker'`:
2699
2716
  * parse AND render entirely inside the worker and paint the returned
@@ -3336,4 +3353,4 @@ declare class XlsxViewer implements ZoomableViewer {
3336
3353
  */
3337
3354
  declare function resolveSharedStrings(ws: Worksheet, sharedStrings: SharedString[]): Worksheet;
3338
3355
  //#endregion
3339
- 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 };
3356
+ 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 };