@silurus/ooxml 0.76.2 → 0.77.1

package/dist/types/pptx.d.ts

@@ -10,7 +10,7 @@ interface MathRenderer {
   mathMLToSvg(mathml: string): Promise<MathSvg>;
 }
 //#endregion
-//#region dist/.types-work/hyperlink-BnJnsq2_.d.ts
+//#region dist/.types-work/hyperlink-JmvHU-7y.d.ts
 type MathStyle = 'roman' | 'italic' | 'bold' | 'boldItalic';
 interface MathRun {
   kind: 'run';
@@ -135,6 +135,12 @@ type PathCmd = {
   y2: number;
   x: number;
   y: number;
+} | {
+  cmd: 'quadBezTo';
+  x1: number;
+  y1: number;
+  x: number;
+  y: number;
 } | {
   cmd: 'arcTo';
   wr: number;
@@ -161,6 +167,12 @@ interface GradientFill {
   stops: GradientStop[];
   angle: number;
   gradType: string;
+  scaled?: boolean;
+  path?: 'shape' | 'circle' | 'rect' | string;
+  fillToRect?: FillRect;
+  tileRect?: FillRect;
+  flip?: 'none' | 'x' | 'y' | 'xy' | string;
+  rotWithShape?: boolean;
 }
 interface PatternFill {
   fillType: 'pattern';
@@ -197,6 +209,12 @@ interface Shadow {
   blur: number;
   dist: number;
   dir: number;
+  sx?: number;
+  sy?: number;
+  kx?: number;
+  ky?: number;
+  algn?: 'tl' | 't' | 'tr' | 'l' | 'ctr' | 'r' | 'bl' | 'b' | 'br';
+  rotWithShape?: boolean;
 }
 interface Glow {
   color: string;
@@ -231,7 +249,14 @@ interface Stroke {
     fillType: 'none';
   }>;
   dashStyle?: string;
-  lineCap?: CanvasLineCap;
+  customDash?: ReadonlyArray<{
+    dash: number;
+    space: number;
+  }>;
+  lineCap?: 'butt' | 'round' | 'square';
+  lineJoin?: 'round' | 'bevel' | 'miter';
+  miterLimit?: number;
+  alignment?: 'ctr' | 'in';
   headEnd?: ArrowEnd;
   tailEnd?: ArrowEnd;
   cmpd?: string;
@@ -277,6 +302,9 @@ type Bullet$1 = {
   numType: string;
   startAt: number | null;
   color: string | null;
+  sizePct?: number | null;
+  sizePts?: number;
+  fontFamily?: string | null;
 };
 interface TabStop {
   pos: number;
@@ -331,6 +359,7 @@ interface TextRunData {
   hyperlink?: string;
   hyperlinkAction?: string;
   shadow?: Shadow;
+  reflection?: Reflection;
   outline?: TextOutline;
   highlight?: string;
 }
@@ -602,9 +631,14 @@ interface LegendManualLayout {
   w: number;
   h: number;
 }
+interface ChartRect {
+  x: number;
+  y: number;
+  w: number;
+  h: number;
+}
 type OoxmlErrorCode = 'encrypted' | 'invalid-password' | 'unsupported-encryption' | 'legacy-binary-format' | 'not-ooxml';
 type OoxmlErrorStage = 'container' | 'decompression' | 'parsing' | 'serialization' | 'layout' | 'rendering' | 'worker';
-type OoxmlErrorSource = 'container' | 'zip-part' | 'parser' | 'serializer' | 'layout' | 'renderer' | 'worker';
 declare class OoxmlError extends Error {
   readonly code: OoxmlErrorCode;
   constructor(code: OoxmlErrorCode, message: string);
@@ -705,7 +739,15 @@ type HyperlinkTarget = {
 };
 declare function openExternalHyperlink(url: string, allowed?: readonly string[], win?: Pick<Window, 'open'> | undefined): boolean;
 //#endregion
-//#region dist/.types-work/find-highlight-DkZhNxUb.d.ts
+//#region dist/.types-work/find-highlight-DcNlrW8O.d.ts
+interface TextSelectionContextOptions {
+  readonly maxTextCharacters?: number;
+  readonly maxRunLocators?: number;
+}
+interface ViewerContextMenuEvent<TContext> {
+  readonly originalEvent: MouseEvent;
+  getContext(): Promise<TContext | null>;
+}
 interface AutoResizeOptions {
   pauseWhenHidden?: boolean;
 }
@@ -736,7 +778,7 @@ interface FindHighlightColors {
   active?: string;
 }
 //#endregion
-//#region dist/.types-work/pptx-CDgwsXLm.d.ts
+//#region dist/.types-work/pptx-DjMlRXaq.d.ts
 interface BlipBullet {
   type: 'blip';
   imagePath: string;
@@ -773,11 +815,16 @@ interface Slide {
   partName?: string;
   background: Fill | null;
   elements: SlideElement[];
+  elementSources?: SlideElementSource[];
   notes?: string;
   comments?: PptxComment[];
   hidden?: boolean;
   parseError?: string;
 }
+type SlideElementOrigin = 'master' | 'layout' | 'slide';
+interface SlideElementSource {
+  origin: SlideElementOrigin;
+}
 interface DimOptions {
   color: string;
   opacity: number;
@@ -875,6 +922,7 @@ interface Sp3d {
   extrusionH?: number;
   contourW?: number;
   contourClr?: string;
+  extrusionClr?: string;
   prstMaterial: string;
   bevelT?: Bevel3d;
   bevelB?: Bevel3d;
@@ -957,6 +1005,8 @@ interface PictureElement {
   sp3d?: Sp3d;
 }
 interface PptxTextRunInfo {
+  elementIndex?: number;
+  origin?: SlideElementOrigin;
   shapeId?: string;
   text: string;
   inShapeX: number;
@@ -987,6 +1037,68 @@ interface PresentationHandle {
   pause(mediaPath?: string): void;
   destroy(): void;
 }
+interface PptxSelectionRunLocator {
+  readonly slideIndex: number;
+  readonly runIndex: number;
+  readonly shapeId?: string;
+  readonly elementIndex?: number;
+  readonly origin?: SlideElementOrigin;
+}
+interface PptxTextSelectionContext {
+  readonly format: 'pptx';
+  readonly kind: 'text';
+  readonly text: string;
+  readonly slideIndexes: readonly number[];
+  readonly shapeIds: readonly string[];
+  readonly runs: readonly PptxSelectionRunLocator[];
+  readonly truncated: boolean;
+  readonly truncationReasons: readonly ('text' | 'runs')[];
+  readonly textCharacters: number;
+  readonly maxTextCharacters: number;
+  readonly maxRunLocators: number;
+}
+declare function readPptxTextSelectionContext(root: HTMLElement, selection: Selection | null, options?: TextSelectionContextOptions): PptxTextSelectionContext | null;
+type PptxSelectionContextOptions = TextSelectionContextOptions;
+interface PptxSlidePoint {
+  readonly x: number;
+  readonly y: number;
+}
+interface PptxElementContextOptions {
+  readonly tolerance?: number;
+  readonly maxTextCharacters?: number;
+}
+interface PptxElementContext {
+  readonly format: 'pptx';
+  readonly kind: 'element';
+  readonly slideIndex: number;
+  readonly elementIndex: number;
+  readonly origin: SlideElementOrigin | 'unknown';
+  readonly elementType: SlideElement['type'];
+  readonly point: PptxSlidePoint;
+  readonly bounds: Readonly<{
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    rotation: number;
+    flipH: boolean;
+    flipV: boolean;
+  }>;
+  readonly shapeId?: string;
+  readonly name?: string;
+  readonly geometry?: string;
+  readonly text?: string;
+  readonly mimeType?: string;
+  readonly mediaKind?: 'audio' | 'video';
+  readonly rowCount?: number;
+  readonly columnCount?: number;
+  readonly seriesCount?: number;
+  readonly truncated: boolean;
+  readonly truncationReasons: readonly ('text')[];
+  readonly textCharacters: number;
+  readonly maxTextCharacters: number;
+}
+type PptxSelectionContext = PptxTextSelectionContext | PptxElementContext;
 type LoadOptions = LoadOptions$1 & {
   mode?: 'main' | 'worker';
 };
@@ -1002,6 +1114,8 @@ interface RenderSlideOptions {
   onTextRun?: TextRunCallback;
   skipMediaControls?: boolean;
   dim?: DimOptions;
+}
+interface PresentSlideOptions extends Omit<RenderSlideOptions, 'skipMediaControls'> {
   onError?: (error: Error) => void;
 }
 declare class PptxPresentation {
@@ -1037,16 +1151,17 @@ declare class PptxPresentation {
   renderSlide(canvas: HTMLCanvasElement | OffscreenCanvas, slideIndex: number, opts?: RenderSlideOptions): Promise<void>;
   renderSlideToBitmap(slideIndex: number, opts?: RenderSlideToBitmapOptions): Promise<ImageBitmap>;
   collectSlideRuns(slideIndex: number, width?: number): Promise<PptxTextRunInfo[]>;
+  getElementContextAt(slideIndex: number, point: PptxSlidePoint, options?: PptxElementContextOptions): Promise<PptxElementContext | null>;
   getMedia(mediaPath: string): Promise<Blob>;
   private _findMimeTypeForPath;
   getImage(imagePath: string, mimeType: string): Promise<Blob>;
   getResourceMetrics(): Promise<OoxmlResourceMetrics>;
   toMarkdown(): Promise<string>;
-  presentSlide(canvas: HTMLCanvasElement, slideIndex: number, opts?: RenderSlideOptions): Promise<PresentationHandle>;
+  presentSlide(canvas: HTMLCanvasElement, slideIndex: number, opts?: PresentSlideOptions): Promise<PresentationHandle>;
   destroy(): void;
 }
 type HiddenSlideMode = 'show' | 'skip' | 'dim';
-interface PptxViewerOptions extends RenderOptions, LoadOptions {
+interface PptxViewerOptions extends Pick<RenderOptions, 'width' | 'dpr'>, LoadOptions {
   onSlideChange?: (index: number, total: number) => void;
   onError?: (err: Error) => void;
   zoomMin?: number;
@@ -1054,6 +1169,10 @@ interface PptxViewerOptions extends RenderOptions, LoadOptions {
   onScaleChange?: (scale: number) => void;
   enableMediaPlayback?: boolean;
   enableTextSelection?: boolean;
+  enableElementSelection?: boolean;
+  elementHitTolerance?: number;
+  onSelectionContextChange?: (context: PptxSelectionContext | null) => void;
+  onContextMenu?: (event: ViewerContextMenuEvent<PptxSelectionContext>) => void;
   findHighlightColors?: FindHighlightColors;
   hiddenSlideMode?: HiddenSlideMode;
   hiddenSlideDim?: Partial<DimOptions>;
@@ -1067,6 +1186,7 @@ declare class PptxViewer implements ZoomableViewer {
   private _scale;
   private textLayer;
   private highlightLayer;
+  private elementLayer;
   private _find;
   private _measureCtx;
   private readonly presentationOwner;
@@ -1081,6 +1201,13 @@ declare class PptxViewer implements ZoomableViewer {
   private readonly renderDispatcher;
   private readonly errorRouter;
   private destroyed;
+  private selectionChangeListener;
+  private selectionContextKey;
+  private elementClickListener;
+  private contextMenuListener;
+  private elementContext;
+  private elementHitGeneration;
+  private readonly elementHitTolerance;
   static fromPresentation(canvas: HTMLCanvasElement, presentation: PptxPresentation, opts?: Omit<PptxViewerOptions, keyof LoadOptions>): Omit<PptxViewer, 'load'>;
   constructor(canvas: HTMLCanvasElement, opts?: PptxViewerOptions);
   load(source: string | ArrayBuffer): Promise<void>;
@@ -1124,9 +1251,17 @@ declare class PptxViewer implements ZoomableViewer {
   private _resolveInternalSlideIndex;
   private _reportRenderError;
   getResourceMetrics(): Promise<OoxmlResourceMetrics>;
+  getSelectionContext(options?: PptxSelectionContextOptions): PptxSelectionContext | null;
+  private _emitSelectionContextChange;
+  private _setElementContext;
+  private _invalidateElementSelection;
+  private _redrawElementOutline;
+  private _onElementClick;
+  private _onContextMenu;
+  private _resolveContextAt;
   destroy(): void;
 }
-interface PptxScrollViewerOptions extends Omit<RenderSlideOptions, 'onTextRun'>, LoadOptions {
+interface PptxScrollViewerOptions extends Pick<RenderSlideOptions, 'width' | 'dpr'>, LoadOptions {
   width?: number;
   gap?: number;
   paddingTop?: number;
@@ -1135,6 +1270,10 @@ interface PptxScrollViewerOptions extends Omit<RenderSlideOptions, 'onTextRun'>,
   paddingRight?: number;
   overscan?: number;
   enableTextSelection?: boolean;
+  enableElementSelection?: boolean;
+  elementHitTolerance?: number;
+  onSelectionContextChange?: (context: PptxSelectionContext | null) => void;
+  onContextMenu?: (event: ViewerContextMenuEvent<PptxSelectionContext>) => void;
   findHighlightColors?: FindHighlightColors;
   enableMediaPlayback?: boolean;
   mediaOverscan?: number;
@@ -1169,6 +1308,13 @@ declare class PptxScrollViewer implements ZoomableViewer {
   private _lastRange;
   private _lastTopIndex;
   private _scrollListener;
+  private _selectionChangeListener;
+  private _selectionContextKey;
+  private _elementClickListener;
+  private _contextMenuListener;
+  private _elementContext;
+  private _elementHitGeneration;
+  private readonly _elementHitTolerance;
   private _destroyed;
   private readonly _slideInFlight;
   private _renderEpoch;
@@ -1191,6 +1337,7 @@ declare class PptxScrollViewer implements ZoomableViewer {
   private _fitWidthPx;
   private _baseScale;
   relayout(): void;
+  private _relayout;
   private _recomputeHeights;
   private _gap;
   private _overscan;
@@ -1247,9 +1394,18 @@ declare class PptxScrollViewer implements ZoomableViewer {
   private _onResize;
   get topVisibleSlide(): number;
   getResourceMetrics(): Promise<OoxmlResourceMetrics>;
+  getSelectionContext(options?: PptxSelectionContextOptions): PptxSelectionContext | null;
+  private _emitSelectionContextChange;
+  private _setElementContext;
+  private _invalidateElementSelection;
+  private _redrawElementOutlines;
+  private _redrawElementOutlineForSlot;
+  private _onElementClick;
+  private _onContextMenu;
+  private _resolveContextAt;
   destroy(): void;
 }
-declare function buildPptxTextLayer(layer: HTMLDivElement, runs: PptxTextRunInfo[], cssWidth: number, cssHeight: number, onHyperlinkClick?: (target: HyperlinkTarget) => void): void;
+declare function buildPptxTextLayer(layer: HTMLDivElement, runs: PptxTextRunInfo[], cssWidth: number, cssHeight: number, onHyperlinkClick?: (target: HyperlinkTarget) => void, slideIndex?: number): void;
 interface PptxHighlightMatch {
   slices: MatchRunSlice[];
   active: boolean;
@@ -1257,4 +1413,4 @@ interface PptxHighlightMatch {
 type PptxHighlightColors = FindHighlightColors;
 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 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, OoxmlDecodedImageLimitError, type OoxmlDecodedImageLimitMetric, OoxmlError, type OoxmlErrorCode, type OoxmlErrorSource, type OoxmlErrorStage, type OoxmlFormat, type OoxmlResourceLimit, OoxmlResourceLimitError, type OoxmlResourceLimitErrorDetails, type OoxmlResourceLimits, type OoxmlResourceMetric, type OoxmlResourceMetrics, type OoxmlResourceMetricsCheckpoint, type OoxmlResourceName, type OoxmlResourcePolicySnapshot, type OoxmlResourceUsageSnapshot, type OoxmlResourceViolation, 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, isOoxmlDecodedImageLimitError, openExternalHyperlink, renderSlide };
+export { type ArrowEnd, type AutoResizeOptions, type Bevel3d, type BlipBullet, type Bullet, type Camera3d, type ChartDataLabelOverride, type ChartDataPointOverride, type ChartElement, type ChartErrBars, type ChartLabelBox, type ChartManualLayout, type ChartModel, type ChartRect, type ChartSeries, type ChartSeriesDataLabels, type ChartTrendline, type ChartType, type ChartexBoxSeries, type ChartexBoxWhisker, type ChartexSunburst, type ChartexSunburstRow, type DimOptions, type Duotone, type EquationRun, type Fill, type FillRect, type FindHighlightColors, type FindMatch, type FindMatchesOptions, type Glow, type GradientFill, type GradientStop, type HiddenSlideMode, type HyperlinkTarget, type ImageFill, type LegendManualLayout, type LightRig, type LineBreak, type LoadOptions, type MatchRunSlice, type MathAccent, type MathArray, type MathBar, type MathBorderBox, type MathBox, type MathDelimiter, type MathFraction, type MathFunc, type MathGroup, type MathGroupChr, type MathLimit, type MathNary, type MathNode, type MathPhant, type MathRadical, type MathRenderer, type MathRun, type MathSPre, type MathScript, type MathStyle, type MathSvg, type MediaElement, type NoFill, OoxmlDecodedImageLimitError, type OoxmlDecodedImageLimitMetric, OoxmlError, type OoxmlErrorCode, type OoxmlErrorStage, type OoxmlFormat, type OoxmlResourceLimit, OoxmlResourceLimitError, type OoxmlResourceLimitErrorDetails, type OoxmlResourceLimits, type OoxmlResourceMetric, type OoxmlResourceMetrics, type OoxmlResourceMetricsCheckpoint, type OoxmlResourceName, type OoxmlResourcePolicySnapshot, type OoxmlResourceUsageSnapshot, type OoxmlResourceViolation, type Paragraph, type PathCmd, type PatternFill, type PictureElement, type PptxComment, type PptxElementContext, type PptxElementContextOptions, type PptxHighlightColors, type PptxHighlightMatch, type PptxMatchLocation, PptxPresentation, PptxScrollViewer, type PptxScrollViewerOptions, type PptxSelectionContext, type PptxSelectionContextOptions, type PptxSelectionRunLocator, type PptxSlidePoint, type PptxTextRunInfo, type PptxTextSelectionContext, PptxViewer, type PptxViewerOptions, type PresentSlideOptions, type Presentation, type PresentationHandle, type Reflection, type RenderOptions, type RenderSlideOptions, type RenderSlideToBitmapOptions, type Rot3d, type Scene3d, type SecondaryValueAxis, type Shadow, type ShapeElement, type Slide, type SlideElement, type SlideElementOrigin, type SlideElementSource, type SlideRenderOptions, type SoftEdge, type SolidFill, type Sp3d, type SpaceLine, type Stroke, type TabStop, type TableCell, type TableElement, type TableRow, type TextBody, type TextOutline, type TextRect, type TextRun, type TextRunCallback, type TextRunData, type TextSelectionContextOptions, type TileInfo, type ViewerContextMenuEvent, type ZoomableViewer, autoResize, buildPptxHighlightLayer, buildPptxTextLayer, isOoxmlDecodedImageLimitError, openExternalHyperlink, readPptxTextSelectionContext, renderSlide };