@silurus/ooxml 0.76.2 → 0.77.1

package/dist/types/index.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$2 = {
   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$1[];
   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$1 {
   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/docx-BOSu_OHa.d.ts
+//#region dist/.types-work/docx-BEg7kh7t.d.ts
 interface DocxDocumentModel {
   section: SectionProps;
   body: BodyElement[];
@@ -1048,6 +1090,12 @@ type PathCmd$1 = {
   y2: number;
   x: number;
   y: number;
+} | {
+  cmd: 'quadBezTo';
+  x1: number;
+  y1: number;
+  x: number;
+  y: number;
 } | {
   cmd: 'arcTo';
   wr: number;
@@ -1089,11 +1137,20 @@ interface ShapeRun {
   subpaths: PathCmd$1[][];
   presetGeometry?: string | null;
   adjValues?: Array<number | null>;
-  fill: ShapeFill | null;
+  fill: ShapeFill$1 | null;
   stroke: string | null;
   strokeWidth?: number;
+  strokeFill?: ShapeStrokeFill | null;
   strokeDash?: string | null;
-  strokeCap?: CanvasLineCap | null;
+  strokeCustomDash?: Array<{
+    dash: number;
+    space: number;
+  }>;
+  strokeCap?: 'butt' | 'round' | 'square' | null;
+  strokeJoin?: 'round' | 'bevel' | 'miter' | null;
+  strokeMiterLimit?: number | null;
+  strokeAlignment?: 'ctr' | 'in' | null;
+  strokeCompound?: string | null;
   headEnd?: LineEnd | null;
   tailEnd?: LineEnd | null;
   rotation?: number;
@@ -1166,7 +1223,7 @@ interface ShapeText$1 {
   imageWidthPt?: number;
   imageHeightPt?: number;
 }
-type ShapeFill = {
+type ShapeFill$1 = {
   fillType: 'solid';
   color: string;
 } | {
@@ -1174,6 +1231,17 @@ type ShapeFill = {
   stops: GradientStop[];
   angle: number;
   gradType: string;
+  scaled?: boolean;
+  path?: string;
+  fillToRect?: FillRect;
+  tileRect?: FillRect;
+  flip?: string;
+  rotWithShape?: boolean;
+} | {
+  fillType: 'pattern';
+  fg: string;
+  bg: string;
+  preset: string;
 } | {
   fillType: 'image';
   imagePath: string;
@@ -1190,6 +1258,23 @@ type ShapeFill = {
   alpha?: number;
   duotone?: Duotone$1;
 };
+type ShapeStrokeFill = {
+  fillType: 'gradient';
+  stops: GradientStop[];
+  angle: number;
+  gradType: string;
+  scaled?: boolean;
+  path?: string;
+  fillToRect?: FillRect;
+  tileRect?: FillRect;
+  flip?: string;
+  rotWithShape?: boolean;
+} | {
+  fillType: 'pattern';
+  fg: string;
+  bg: string;
+  preset: string;
+};
 interface GradientStop {
   position: number;
   color: string;
@@ -1388,24 +1473,12 @@ interface CellBorders {
   insideH: BorderSpec | null;
   insideV: BorderSpec | null;
 }
-interface RenderPageOptions {
-  width?: number;
-  dpr?: number;
-  defaultTextColor?: string;
-  onTextRun?: (run: {
-    text: string;
-    x: number;
-    y: number;
-    w: number;
-    h: number;
-    fontSize: number;
-    font: string;
-    transform?: string;
-  }) => void;
-  showTrackChanges?: boolean;
-  currentDate?: Date | number;
-}
 interface DocxTextRunInfo {
+  source?: Readonly<{
+    story: 'body' | 'header' | 'footer' | 'footnote' | 'endnote' | 'textbox';
+    storyInstance: string;
+    path: readonly number[];
+  }>;
   paragraphId?: string;
   text: string;
   x: number;
@@ -1419,12 +1492,74 @@ interface DocxTextRunInfo {
   hyperlink?: HyperlinkTarget;
   eastAsianVert?: boolean;
 }
-type WireRenderPageOptions = Omit<RenderPageOptions, 'onTextRun'>;
+interface RenderPageOptions {
+  width?: number;
+  dpr?: number;
+  defaultTextColor?: string;
+  onTextRun?: (run: DocxTextRunInfo) => void;
+  currentDate?: Date | number;
+}
+type DocxSelectionContextOptions = TextSelectionContextOptions;
+interface DocxSelectionSourceLocator {
+  readonly story: 'body' | 'header' | 'footer' | 'footnote' | 'endnote' | 'textbox';
+  readonly storyInstance: string;
+  readonly path: readonly number[];
+}
+interface DocxSelectionRunLocator {
+  readonly pageIndex: number;
+  readonly runIndex: number;
+  readonly paragraphId?: string;
+  readonly source?: DocxSelectionSourceLocator;
+}
+interface DocxTextSelectionContext {
+  readonly format: 'docx';
+  readonly kind: 'text';
+  readonly text: string;
+  readonly pageIndexes: readonly number[];
+  readonly paragraphIds: readonly string[];
+  readonly runs: readonly DocxSelectionRunLocator[];
+  readonly truncated: boolean;
+  readonly truncationReasons: readonly ('text' | 'runs')[];
+  readonly textCharacters: number;
+  readonly maxTextCharacters: number;
+  readonly maxRunLocators: number;
+}
+interface DocxPagePoint {
+  readonly xPt: number;
+  readonly yPt: number;
+}
+interface DocxElementContext {
+  readonly format: 'docx';
+  readonly kind: 'element';
+  readonly pageIndex: number;
+  readonly elementIndex: number;
+  readonly elementType: 'chart' | 'image' | 'shape';
+  readonly point: DocxPagePoint;
+  readonly bounds: Readonly<DocxPagePoint & {
+    widthPt: number;
+    heightPt: number;
+  }>;
+  readonly source: DocxSelectionSourceLocator;
+  readonly text?: string;
+  readonly mimeType?: string;
+  readonly seriesCount?: number;
+  readonly truncated: boolean;
+  readonly truncationReasons: readonly ('text')[];
+  readonly textCharacters: number;
+  readonly maxTextCharacters: number;
+}
+type DocxSelectionContext = DocxTextSelectionContext | DocxElementContext;
+declare function readDocxTextSelectionContext(root: HTMLElement, selection: Selection | null, options?: DocxSelectionContextOptions): DocxTextSelectionContext | null;
+interface DocxElementContextOptions {
+  readonly maxTextCharacters?: number;
+  readonly currentDate?: Date | number;
+}
 interface LoadOptions$2 extends LoadOptions$3 {
   math?: MathRenderer;
   mode?: 'main' | 'worker';
 }
-type RenderPageToBitmapOptions = WireRenderPageOptions & {
+type CollectPageRunsOptions = Pick<RenderPageOptions, 'width' | 'currentDate'>;
+type RenderPageToBitmapOptions = Omit<RenderPageOptions, 'onTextRun'> & {
   onTextRun?: (run: DocxTextRunInfo) => void;
 };
 declare class DocxDocument {
@@ -1465,14 +1600,18 @@ declare class DocxDocument {
   };
   renderPage(target: HTMLCanvasElement | OffscreenCanvas, pageIndex: number, opts?: RenderPageOptions): Promise<void>;
   renderPageToBitmap(pageIndex: number, opts?: RenderPageToBitmapOptions): Promise<ImageBitmap>;
-  collectPageRuns(pageIndex: number, opts?: WireRenderPageOptions): Promise<DocxTextRunInfo[]>;
+  collectPageRuns(pageIndex: number, opts?: CollectPageRunsOptions): Promise<DocxTextRunInfo[]>;
+  getElementContextAt(pageIndex: number, point: DocxPagePoint, opts?: DocxElementContextOptions): Promise<DocxElementContext | null>;
 }
 interface DocxMatchLocation {
   page: number;
 }
-interface DocxViewerOptions extends RenderPageOptions, LoadOptions$2 {
+interface DocxViewerOptions extends Omit<RenderPageOptions, 'onTextRun'>, LoadOptions$2 {
   container?: HTMLElement;
   enableTextSelection?: boolean;
+  enableElementSelection?: boolean;
+  onSelectionContextChange?: (context: DocxSelectionContext | null) => void;
+  onContextMenu?: (event: ViewerContextMenuEvent<DocxSelectionContext>) => void;
   findHighlightColors?: FindHighlightColors;
   onPageChange?: (index: number, total: number) => void;
   zoomMin?: number;
@@ -1494,6 +1633,7 @@ declare class DocxViewer implements ZoomableViewer {
   private readonly _canvasMount;
   private _textLayer;
   private _highlightLayer;
+  private _elementLayer;
   private _find;
   private _measureCtx;
   private _opts;
@@ -1501,6 +1641,12 @@ declare class DocxViewer implements ZoomableViewer {
   private readonly _renderDispatcher;
   private readonly _errorRouter;
   private _destroyed;
+  private _selectionChangeListener;
+  private _selectionContextKey;
+  private _elementContext;
+  private _elementHitGeneration;
+  private _elementClickListener;
+  private _contextMenuListener;
   static fromDocument(canvas: HTMLCanvasElement, document: DocxDocument, opts?: Omit<DocxViewerOptions, keyof LoadOptions$2>): Omit<DocxViewer, 'load'>;
   constructor(canvas: HTMLCanvasElement, opts?: DocxViewerOptions);
   load(source: string | ArrayBuffer): Promise<void>;
@@ -1529,6 +1675,14 @@ declare class DocxViewer implements ZoomableViewer {
   private _activateMatch;
   private _redrawHighlights;
   getResourceMetrics(): Promise<OoxmlResourceMetrics>;
+  getSelectionContext(options?: DocxSelectionContextOptions): DocxSelectionContext | null;
+  private _emitSelectionContextChange;
+  private _setElementContext;
+  private _invalidateElementContext;
+  private _redrawElementOutline;
+  private _onElementClick;
+  private _onContextMenu;
+  private _resolveContextAt;
   destroy(): void;
   private _render;
   private _reportRenderError;
@@ -1549,6 +1703,9 @@ interface DocxScrollViewerOptions extends Omit<RenderPageOptions, 'onTextRun'>,
   paddingRight?: number;
   overscan?: number;
   enableTextSelection?: boolean;
+  enableElementSelection?: boolean;
+  onSelectionContextChange?: (context: DocxSelectionContext | null) => void;
+  onContextMenu?: (event: ViewerContextMenuEvent<DocxSelectionContext>) => void;
   findHighlightColors?: FindHighlightColors;
   zoomMin?: number;
   zoomMax?: number;
@@ -1581,6 +1738,12 @@ declare class DocxScrollViewer implements ZoomableViewer {
   private _lastRange;
   private _lastTopIndex;
   private _scrollListener;
+  private _selectionChangeListener;
+  private _selectionContextKey;
+  private _elementClickListener;
+  private _contextMenuListener;
+  private _elementContext;
+  private _elementHitGeneration;
   private _destroyed;
   private _measureCtx;
   private readonly _bitmapInFlight;
@@ -1603,6 +1766,7 @@ declare class DocxScrollViewer implements ZoomableViewer {
   private _fitWidthPx;
   private _baseScale;
   relayout(): void;
+  private _relayout;
   private _recomputeHeights;
   private _gap;
   private _overscan;
@@ -1652,9 +1816,18 @@ declare class DocxScrollViewer implements ZoomableViewer {
   private _onResize;
   get topVisiblePage(): number;
   getResourceMetrics(): Promise<OoxmlResourceMetrics>;
+  getSelectionContext(options?: DocxSelectionContextOptions): DocxSelectionContext | null;
+  private _emitSelectionContextChange;
+  private _setElementContext;
+  private _invalidateElementContext;
+  private _redrawElementOutlines;
+  private _redrawElementOutlineForSlot;
+  private _onElementClick;
+  private _onContextMenu;
+  private _resolveContextAt;
   destroy(): void;
 }
-declare function buildDocxTextLayer(layer: HTMLDivElement, runs: DocxTextRunInfo[], cssWidth: number, cssHeight: number, onHyperlinkClick?: (target: HyperlinkTarget) => void, measureForFont?: (font: string) => (s: string) => number): void;
+declare function buildDocxTextLayer(layer: HTMLDivElement, runs: DocxTextRunInfo[], cssWidth: number, cssHeight: number, onHyperlinkClick?: (target: HyperlinkTarget) => void, measureForFont?: (font: string) => (s: string) => number, pageIndex?: number): void;
 interface DocxHighlightMatch {
   slices: MatchRunSlice[];
   active: boolean;
@@ -1662,10 +1835,10 @@ interface DocxHighlightMatch {
 type DocxHighlightColors = FindHighlightColors;
 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, FindHighlightColors, FindMatch, FindMatchesOptions, FramePr, GradientStop, HeaderFooter, HeadersFooters, HyperlinkTarget, ImageRun, LineEnd, LineNumbering, LineSpacing, LoadOptions$2 as LoadOptions, NoteRef, NumberingInfo, OoxmlDecodedImageLimitError, OoxmlDecodedImageLimitMetric, OoxmlError, OoxmlErrorCode, OoxmlErrorSource, OoxmlErrorStage, OoxmlFormat, OoxmlResourceLimit, OoxmlResourceLimitError, OoxmlResourceLimitErrorDetails, OoxmlResourceLimits, OoxmlResourceMetric, OoxmlResourceMetrics, OoxmlResourceMetricsCheckpoint, OoxmlResourceName, OoxmlResourcePolicySnapshot, OoxmlResourceUsageSnapshot, OoxmlResourceViolation, PTabRun, PageBorderEdge, PageBorders, PageNumType, ParaBorderEdge, ParagraphBorders, PathCmd$1 as PathCmd, RenderPageOptions, RenderPageToBitmapOptions, RubyAnnotation, RunRevision, SectionGeom, SectionProps, ShapeRun, ShapeText$1 as ShapeText, ShapeTextRun$1 as ShapeTextRun, TabStop, TableBorders, TblpPr, TextPath, WireRenderPageOptions, autoResize, buildDocxHighlightLayer, buildDocxTextLayer, isOoxmlDecodedImageLimitError, noteText, openExternalHyperlink };
+  export { AnchorHostMetrics, AutoResizeOptions, BodyElement, BorderSpec, CellBorders, CellElement, ChartDataLabelOverride, ChartDataPointOverride, ChartErrBars, ChartLabelBox, ChartManualLayout, ChartModel, ChartRect, ChartRun, ChartSeries, ChartSeriesDataLabels, ChartTrendline, ChartType, ChartexBoxSeries, ChartexBoxWhisker, ChartexSunburst, ChartexSunburstRow, ColSpec, CollectPageRunsOptions, ColumnsSpec, DocComment, DocNote, DocParagraph, DocRevision, DocRun, DocSettings, DocTable, DocTableCell, DocTableRow, DocxDocument, DocxDocumentModel, DocxElementContext, DocxElementContextOptions, DocxHighlightColors, DocxHighlightMatch, DocxMatchLocation, DocxPagePoint, DocxRunBorder, DocxScrollViewer, DocxScrollViewerOptions, DocxSelectionContext, DocxSelectionContextOptions, DocxSelectionRunLocator, DocxSelectionSourceLocator, DocxTextRun, DocxTextRunInfo, DocxTextSelectionContext, DocxViewer, DocxViewerOptions, Duotone$1 as Duotone, EmbeddedFontRef, FieldRun, FillRect, FindHighlightColors, FindMatch, FindMatchesOptions, FramePr, GradientStop, HeaderFooter, HeadersFooters, HyperlinkTarget, ImageRun, LegendManualLayout, LineEnd, LineNumbering, LineSpacing, LoadOptions$2 as LoadOptions, MatchRunSlice, MathAccent, MathArray, MathBar, MathBorderBox, MathBox, MathDelimiter, MathFraction, MathFunc, MathGroup, MathGroupChr, MathLimit, MathNary, MathNode, MathPhant, MathRadical, MathRenderer, MathRun, MathSPre, MathScript, MathStyle, MathSvg, NoteRef, NumberingInfo, OoxmlDecodedImageLimitError, OoxmlDecodedImageLimitMetric, OoxmlError, OoxmlErrorCode, OoxmlErrorStage, OoxmlFormat, OoxmlResourceLimit, OoxmlResourceLimitError, OoxmlResourceLimitErrorDetails, OoxmlResourceLimits, OoxmlResourceMetric, OoxmlResourceMetrics, OoxmlResourceMetricsCheckpoint, OoxmlResourceName, OoxmlResourcePolicySnapshot, OoxmlResourceUsageSnapshot, OoxmlResourceViolation, PTabRun, PageBorderEdge, PageBorders, PageNumType, ParaBorderEdge, ParagraphBorders, PathCmd$1 as PathCmd, RenderPageOptions, RenderPageToBitmapOptions, RubyAnnotation, RunRevision, SecondaryValueAxis, SectionGeom, SectionProps, ShapeFill$1 as ShapeFill, ShapeRun, ShapeStrokeFill, ShapeText$1 as ShapeText, ShapeTextRun$1 as ShapeTextRun, TabStop, TableBorders, TblpPr, TextPath, TextSelectionContextOptions, TileInfo, ViewerContextMenuEvent, ZoomableViewer, autoResize, buildDocxHighlightLayer, buildDocxTextLayer, isOoxmlDecodedImageLimitError, noteText, openExternalHyperlink, readDocxTextSelectionContext };
 }
 //#endregion
-//#region dist/.types-work/pptx-CDgwsXLm.d.ts
+//#region dist/.types-work/pptx-DjMlRXaq.d.ts
 interface BlipBullet {
   type: 'blip';
   imagePath: string;
@@ -1702,11 +1875,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;
@@ -1804,6 +1982,7 @@ interface Sp3d {
   extrusionH?: number;
   contourW?: number;
   contourClr?: string;
+  extrusionClr?: string;
   prstMaterial: string;
   bevelT?: Bevel3d;
   bevelB?: Bevel3d;
@@ -1886,6 +2065,8 @@ interface PictureElement {
   sp3d?: Sp3d;
 }
 interface PptxTextRunInfo {
+  elementIndex?: number;
+  origin?: SlideElementOrigin;
   shapeId?: string;
   text: string;
   inShapeX: number;
@@ -1916,6 +2097,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$1 = LoadOptions$3 & {
   mode?: 'main' | 'worker';
 };
@@ -1931,6 +2174,8 @@ interface RenderSlideOptions {
   onTextRun?: TextRunCallback;
   skipMediaControls?: boolean;
   dim?: DimOptions;
+}
+interface PresentSlideOptions extends Omit<RenderSlideOptions, 'skipMediaControls'> {
   onError?: (error: Error) => void;
 }
 declare class PptxPresentation {
@@ -1966,16 +2211,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$1 {
+interface PptxViewerOptions extends Pick<RenderOptions, 'width' | 'dpr'>, LoadOptions$1 {
   onSlideChange?: (index: number, total: number) => void;
   onError?: (err: Error) => void;
   zoomMin?: number;
@@ -1983,6 +2229,10 @@ interface PptxViewerOptions extends RenderOptions, LoadOptions$1 {
   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>;
@@ -1996,6 +2246,7 @@ declare class PptxViewer implements ZoomableViewer {
   private _scale;
   private textLayer;
   private highlightLayer;
+  private elementLayer;
   private _find;
   private _measureCtx;
   private readonly presentationOwner;
@@ -2010,6 +2261,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$1>): Omit<PptxViewer, 'load'>;
   constructor(canvas: HTMLCanvasElement, opts?: PptxViewerOptions);
   load(source: string | ArrayBuffer): Promise<void>;
@@ -2053,9 +2311,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$1 {
+interface PptxScrollViewerOptions extends Pick<RenderSlideOptions, 'width' | 'dpr'>, LoadOptions$1 {
   width?: number;
   gap?: number;
   paddingTop?: number;
@@ -2064,6 +2330,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;
@@ -2098,6 +2368,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;
@@ -2120,6 +2397,7 @@ declare class PptxScrollViewer implements ZoomableViewer {
   private _fitWidthPx;
   private _baseScale;
   relayout(): void;
+  private _relayout;
   private _recomputeHeights;
   private _gap;
   private _overscan;
@@ -2176,9 +2454,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;
@@ -2186,10 +2473,15 @@ 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;
 declare namespace pptx_d_exports {
-  export { AutoResizeOptions, Bevel3d, BlipBullet, Bullet, Camera3d, ChartElement, ChartModel, ChartSeries, DimOptions, Fill, FillRect, FindHighlightColors, FindMatch, FindMatchesOptions, Glow, GradientFill, GradientStop$1 as GradientStop, HiddenSlideMode, HyperlinkTarget, ImageFill, LightRig, LineBreak, LoadOptions$1 as LoadOptions, MediaElement, NoFill, OoxmlDecodedImageLimitError, OoxmlDecodedImageLimitMetric, OoxmlError, OoxmlErrorCode, OoxmlErrorSource, OoxmlErrorStage, OoxmlFormat, OoxmlResourceLimit, OoxmlResourceLimitError, OoxmlResourceLimitErrorDetails, OoxmlResourceLimits, OoxmlResourceMetric, OoxmlResourceMetrics, OoxmlResourceMetricsCheckpoint, OoxmlResourceName, OoxmlResourcePolicySnapshot, OoxmlResourceUsageSnapshot, OoxmlResourceViolation, Paragraph, PathCmd$2 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$1 as TabStop, TableCell, TableElement, TableRow, TextBody, TextRect, TextRun, TextRunCallback, TextRunData, TileInfo, autoResize, buildPptxHighlightLayer, buildPptxTextLayer, isOoxmlDecodedImageLimitError, openExternalHyperlink, renderSlide };
+  export { ArrowEnd, AutoResizeOptions, Bevel3d, BlipBullet, Bullet, Camera3d, ChartDataLabelOverride, ChartDataPointOverride, ChartElement, ChartErrBars, ChartLabelBox, ChartManualLayout, ChartModel, ChartRect, ChartSeries, ChartSeriesDataLabels, ChartTrendline, ChartType, ChartexBoxSeries, ChartexBoxWhisker, ChartexSunburst, ChartexSunburstRow, DimOptions, Duotone$1 as Duotone, EquationRun, Fill, FillRect, FindHighlightColors, FindMatch, FindMatchesOptions, Glow, GradientFill, GradientStop$1 as GradientStop, HiddenSlideMode, HyperlinkTarget, ImageFill, LegendManualLayout, LightRig, LineBreak, LoadOptions$1 as LoadOptions, MatchRunSlice, MathAccent, MathArray, MathBar, MathBorderBox, MathBox, MathDelimiter, MathFraction, MathFunc, MathGroup, MathGroupChr, MathLimit, MathNary, MathNode, MathPhant, MathRadical, MathRenderer, MathRun, MathSPre, MathScript, MathStyle, MathSvg, MediaElement, NoFill, OoxmlDecodedImageLimitError, OoxmlDecodedImageLimitMetric, OoxmlError, OoxmlErrorCode, OoxmlErrorStage, OoxmlFormat, OoxmlResourceLimit, OoxmlResourceLimitError, OoxmlResourceLimitErrorDetails, OoxmlResourceLimits, OoxmlResourceMetric, OoxmlResourceMetrics, OoxmlResourceMetricsCheckpoint, OoxmlResourceName, OoxmlResourcePolicySnapshot, OoxmlResourceUsageSnapshot, OoxmlResourceViolation, Paragraph, PathCmd$2 as PathCmd, PatternFill, PictureElement, PptxComment, PptxElementContext, PptxElementContextOptions, PptxHighlightColors, PptxHighlightMatch, PptxMatchLocation, PptxPresentation, PptxScrollViewer, PptxScrollViewerOptions, PptxSelectionContext, PptxSelectionContextOptions, PptxSelectionRunLocator, PptxSlidePoint, PptxTextRunInfo, PptxTextSelectionContext, PptxViewer, PptxViewerOptions, PresentSlideOptions, Presentation, PresentationHandle, Reflection, RenderOptions, RenderSlideOptions, RenderSlideToBitmapOptions, Rot3d, Scene3d, SecondaryValueAxis, Shadow, ShapeElement, Slide, SlideElement, SlideElementOrigin, SlideElementSource, SlideRenderOptions, SoftEdge, SolidFill, Sp3d, SpaceLine, Stroke, TabStop$1 as TabStop, TableCell, TableElement, TableRow, TextBody, TextOutline, TextRect, TextRun, TextRunCallback, TextRunData, TextSelectionContextOptions, TileInfo, ViewerContextMenuEvent, ZoomableViewer, autoResize, buildPptxHighlightLayer, buildPptxTextLayer, isOoxmlDecodedImageLimitError, openExternalHyperlink, readPptxTextSelectionContext, renderSlide };
 }
 //#endregion
-//#region dist/.types-work/xlsx-DrRsBH8s.d.ts
+//#region dist/.types-work/xlsx-3u8ip-lC.d.ts
+type ShapeFill = Exclude<Fill, {
+  fillType: 'image';
+} | {
+  fillType: 'none';
+}>;
 interface Workbook {
   sheets: SheetMeta[];
   date1904?: boolean;
@@ -2231,7 +2523,7 @@ interface Worksheet {
   rightToLeft?: boolean;
   outlinePr?: OutlinePr;
   tabColor?: string | null;
-  autoFilter?: CellRange$1 | null;
+  autoFilter?: WorksheetCellRange | null;
   hyperlinks?: Hyperlink[];
   commentRefs?: string[];
   comments?: XlsxComment[];
@@ -2262,7 +2554,7 @@ interface PivotTableMetadata {
   status: PivotMetadataStatus;
   extensionUris?: string[];
 }
-interface PivotLocation extends CellRange$1 {
+interface PivotLocation extends WorksheetCellRange {
   firstHeaderRow: number;
   firstDataRow: number;
   firstDataCol: number;
@@ -2405,7 +2697,7 @@ interface SlicerElementStyle {
   borderColor?: string;
 }
 interface TableInfo {
-  range: CellRange$1;
+  range: WorksheetCellRange;
   styleName: string;
   headerRowCount: number;
   totalsRowCount: number;
@@ -2450,12 +2742,6 @@ interface DataValidation {
   errorTitle?: string;
   errorMessage?: string;
 }
-type XlsxChartSeries = ChartSeries;
-type SeriesDataLabels = ChartSeriesDataLabels;
-type DataLabelOverride = ChartDataLabelOverride;
-type DataPointOverride = ChartDataPointOverride;
-type ErrBars = ChartErrBars;
-type ManualLayout = ChartManualLayout;
 interface ChartAnchor {
   fromCol: number;
   fromColOff: number;
@@ -2490,8 +2776,26 @@ interface ShapeInfo {
   flipH?: boolean;
   flipV?: boolean;
   fillColor?: string;
+  fill?: ShapeFill;
   strokeColor?: string;
   strokeWidth: number;
+  strokeFill?: Exclude<Fill, {
+    fillType: 'image';
+  } | {
+    fillType: 'none';
+  }>;
+  strokeDashStyle?: string;
+  strokeCustomDash?: Array<{
+    dash: number;
+    space: number;
+  }>;
+  strokeLineCap?: 'butt' | 'round' | 'square';
+  strokeLineJoin?: 'round' | 'bevel' | 'miter';
+  strokeMiterLimit?: number;
+  strokeAlignment?: 'ctr' | 'in';
+  strokeCmpd?: string;
+  strokeHeadEnd?: ArrowEnd;
+  strokeTailEnd?: ArrowEnd;
   geom: ShapeGeom;
   text?: ShapeText;
 }
@@ -2620,7 +2924,7 @@ interface ImageAnchor {
   alpha?: number;
   duotone?: Duotone;
 }
-interface CellRange$1 {
+interface WorksheetCellRange {
   top: number;
   left: number;
   bottom: number;
@@ -2634,7 +2938,7 @@ interface Hyperlink {
   display?: string | null;
 }
 interface ConditionalFormat {
-  sqref: CellRange$1[];
+  sqref: WorksheetCellRange[];
   rules: CfRule[];
 }
 type CfRule = {
@@ -2869,7 +3173,7 @@ interface XlsxTextRunInfo {
   row: number;
   col: number;
 }
-interface RenderViewportOptions {
+interface XlsxRenderViewportOptions {
   width?: number;
   height?: number;
   dpr?: number;
@@ -2880,8 +3184,6 @@ interface RenderViewportOptions {
   freezeRows?: number;
   freezeCols?: number;
   cellScale?: number;
-  loadedImages?: Map<string, CanvasImageSource | null>;
-  fetchImage?: (path: string, mimeType: string) => Promise<Blob>;
   onTextRun?: (info: XlsxTextRunInfo) => void;
   selectedRowRange?: {
     start: number;
@@ -2901,12 +3203,9 @@ type ResolvedList = {
   kind: 'formula';
   formula: string;
 };
-interface WireSizeOverrides {
-  rows?: Record<number, number | null>;
-  cols?: Record<number, number | null>;
-}
-type WireRenderViewportOptions = Omit<RenderViewportOptions, 'onTextRun' | 'loadedImages' | 'fetchImage'> & {
-  sizeOverrides?: WireSizeOverrides;
+type RenderViewportToBitmapOptions = Omit<XlsxRenderViewportOptions, 'onTextRun'> & {
+  width: number;
+  height: number;
 };
 interface LoadOptions extends LoadOptions$3 {
   mode?: 'main' | 'worker';
@@ -2955,16 +3254,97 @@ declare class XlsxWorkbook {
   toMarkdown(): Promise<string>;
   resolveValidationList(sheetIndex: number, formula1: string | undefined): Promise<ResolvedList>;
   cellText(ws: Worksheet, cell: Cell): string;
-  renderViewport(target: HTMLCanvasElement | OffscreenCanvas, sheetIndex: number, viewport: ViewportRange, opts?: RenderViewportOptions): Promise<void>;
-  renderViewportToBitmap(sheetIndex: number, viewport: ViewportRange, opts: WireRenderViewportOptions & {
-    width: number;
-    height: number;
-  }): Promise<ImageBitmap>;
+  renderViewport(target: HTMLCanvasElement | OffscreenCanvas, sheetIndex: number, viewport: ViewportRange, opts?: XlsxRenderViewportOptions): Promise<void>;
+  renderViewportToBitmap(sheetIndex: number, viewport: ViewportRange, opts: RenderViewportToBitmapOptions): Promise<ImageBitmap>;
   private withWorksheetArchiveOperation;
   destroy(): void;
   private assertResourceHealthy;
 }
 type CanvasViewerRenderMode = 'main' | 'worker';
+interface CellAddress {
+  row: number;
+  col: number;
+}
+type XlsxSelectionArea = Readonly<{
+  kind: 'cells';
+  top: number;
+  left: number;
+  bottom: number;
+  right: number;
+}> | Readonly<{
+  kind: 'rows';
+  firstRow: number;
+  lastRow: number;
+}> | Readonly<{
+  kind: 'columns';
+  firstColumn: number;
+  lastColumn: number;
+}> | Readonly<{
+  kind: 'sheet';
+}>;
+interface XlsxSelectionState {
+  readonly areas: readonly XlsxSelectionArea[];
+  readonly activeAreaIndex: number;
+  readonly activeCell: CellAddress;
+  readonly extensionAnchor: CellAddress;
+}
+type XlsxSelectionInput = string | XlsxSelectionState | null;
+interface XlsxSelectionContextOptions {
+  readonly maxCells?: number;
+  readonly maxTextCharacters?: number;
+}
+interface XlsxSelectionContextCell {
+  readonly address: CellAddress;
+  readonly displayText: string;
+  readonly valueType: 'empty' | 'text' | 'number' | 'bool' | 'error' | 'shared';
+  readonly value: string | number | boolean | null;
+  readonly formula?: string;
+}
+interface XlsxRangeSelectionContext {
+  readonly format: 'xlsx';
+  readonly kind: 'range';
+  readonly sheetIndex: number;
+  readonly sheetName: string;
+  readonly selection: XlsxSelectionState;
+  readonly coordinateCountUpperBound: number;
+  readonly cells: readonly XlsxSelectionContextCell[];
+  readonly truncated: boolean;
+  readonly truncationReasons: readonly ('cells' | 'text')[];
+  readonly maxCells: number;
+  readonly textCharacters: number;
+  readonly maxTextCharacters: number;
+}
+interface XlsxElementAnchorMarker {
+  readonly row: number;
+  readonly col: number;
+  readonly offsetX: number;
+  readonly offsetY: number;
+}
+interface XlsxElementContext {
+  readonly format: 'xlsx';
+  readonly kind: 'element';
+  readonly sheetIndex: number;
+  readonly sheetName: string;
+  readonly elementType: 'chart' | 'image' | 'shape';
+  readonly elementIndex: number;
+  readonly shapeIndex?: number;
+  readonly anchor: Readonly<{
+    from: XlsxElementAnchorMarker;
+    to: XlsxElementAnchorMarker;
+  }>;
+  readonly text?: string;
+  readonly mimeType?: string;
+  readonly seriesCount?: number;
+  readonly shapeCount?: number;
+  readonly truncated: boolean;
+  readonly truncationReasons: readonly ('text')[];
+  readonly textCharacters: number;
+  readonly maxTextCharacters: number;
+}
+type XlsxSelectionContext = XlsxRangeSelectionContext | XlsxElementContext;
+declare const MAX_SELECTION_AREAS = 128;
+declare const MAX_SELECTION_CONTEXT_CELLS = 10000;
+declare const MAX_SELECTION_CONTEXT_TEXT_CHARACTERS: number;
 interface XlsxMatchLocation {
   sheet: number;
   sheetName: string;
@@ -2973,7 +3353,7 @@ interface XlsxMatchLocation {
   col: number;
 }
 type HiddenSheetMode = 'show' | 'skip' | 'dim';
-interface XlsxSheetViewerOptions extends LoadOptions$3 {
+interface XlsxSheetViewerOptions extends LoadOptions {
   cellScale?: number;
   resizable?: boolean;
   showScrollbars?: boolean;
@@ -2983,12 +3363,14 @@ interface XlsxSheetViewerOptions extends LoadOptions$3 {
   onReady?: (sheetNames: string[]) => void;
   onSheetChange?: (index: number, total: number) => void;
   onError?: (err: Error) => void;
-  onSelectionChange?: (selection: CellRange | null) => void;
+  onSelectionStateChange?: (selection: XlsxSelectionState | null) => void;
+  onSelectionContextChange?: (context: XlsxSelectionContext | null) => void;
+  onContextMenu?: (event: ViewerContextMenuEvent<XlsxSelectionContext>) => void;
+  enableElementSelection?: boolean;
   onHyperlinkClick?: (target: HyperlinkTarget) => void;
   enableHyperlinks?: boolean;
   selectionColor?: string;
   findHighlightColors?: FindHighlightColors;
-  mode?: 'main' | 'worker';
   hiddenSheetMode?: HiddenSheetMode;
   onViewportChange?: (offset: XlsxViewportOffset) => void;
 }
@@ -3002,16 +3384,22 @@ interface XlsxViewportOffset {
 interface XlsxScrollToCellOptions {
   readonly align?: 'nearest' | 'start' | 'center' | 'end';
 }
-interface CellAddress {
-  row: number;
-  col: number;
-}
-type SelectionMode = 'cells' | 'rows' | 'cols' | 'all';
-interface CellRange {
-  anchor: CellAddress;
-  active: CellAddress;
-  mode: SelectionMode;
-}
+type XlsxCopyResult = Readonly<{
+  status: 'copied';
+  cellCount: number;
+  utf16CodeUnits: number;
+}> | Readonly<{
+  status: 'empty-selection';
+}> | Readonly<{
+  status: 'unsupported-multiple-areas';
+}> | Readonly<{
+  status: 'too-large';
+  limit: 'cells' | 'text';
+}> | Readonly<{
+  status: 'clipboard-unavailable';
+}> | Readonly<{
+  status: 'clipboard-denied';
+}>;
 type XlsxViewerMount = {
   readonly kind: 'composite';
 } | {
@@ -3071,22 +3459,30 @@ declare class XlsxViewerEngine implements ZoomableViewer {
   private resizeObserver;
   private _lastViewportNotification;
   private get anchorCell();
-  private set anchorCell(value);
   private get activeCell();
-  private set activeCell(value);
   private get selectionMode();
-  private set selectionMode(value);
   private get isSelecting();
   private get selectionPointerId();
   private beginSelectionDrag;
   private _pendingZoomAnchor;
   private readonly selectionController;
+  private lastNotifiedSelectionState;
+  private emittingSelectionChange;
+  private pendingSelectionChange;
+  private selectionNotificationScheduled;
+  private selectionNotificationCount;
+  private selectionContextNotificationFrame;
+  private selectionContextNotificationMicrotask;
+  private readonly selectionContextRows;
+  private readonly selectionContextCells;
+  private elementContext;
   private selectionOverlay;
   private findOverlay;
   private _find;
   private keydownHandler;
   private pendingTap;
   private pendingClick;
+  private pendingElementClick;
   private resizeDrag;
   private selectionAutoScrollPointer;
   private selectionAutoScrollFrame;
@@ -3111,7 +3507,7 @@ declare class XlsxViewerEngine implements ZoomableViewer {
   private get workbook();
   private get wb();
   private set wb(value);
-  showSheet(index: number): Promise<void>;
+  private showSheet;
   private isCurrentSheetRequest;
   private buildOutline;
   private layoutGutters;
@@ -3154,9 +3550,18 @@ declare class XlsxViewerEngine implements ZoomableViewer {
   private _stepSheet;
   private _initialSheet;
   getCellAt(clientX: number, clientY: number): CellAddress | null;
+  private elementContextViewport;
+  private elementContextAt;
   private getCellRect;
-  get selection(): CellRange | null;
-  select(ref: string): void;
+  get selectionState(): XlsxSelectionState | null;
+  setSelection(input: XlsxSelectionInput): void;
+  getSelectionContext(options?: XlsxSelectionContextOptions): XlsxSelectionContext | null;
+  private commitSelection;
+  private setElementContext;
+  private scheduleSelectionContextNotification;
+  private emitSelectionChange;
+  private scheduleSelectionNotification;
+  private finishSelectionNotificationChain;
   private getHeaderHit;
   private getResizeTarget;
   private applyResize;
@@ -3164,8 +3569,9 @@ declare class XlsxViewerEngine implements ZoomableViewer {
   setHiddenSheetMode(mode: HiddenSheetMode): Promise<void>;
   get hiddenSheetMode(): HiddenSheetMode;
   get visibleSheetCount(): number;
-  private copySelection;
+  copySelection(): Promise<XlsxCopyResult>;
   private updateSelectionOverlay;
+  private drawElementContextOverlay;
   private maybeDrawValidationDropdown;
   private updateFindOverlay;
   findText(query: string, opts?: FindMatchesOptions): Promise<FindMatch<XlsxMatchLocation>[]>;
@@ -3196,6 +3602,8 @@ declare class XlsxViewerEngine implements ZoomableViewer {
   private trackSelectionAutoScroll;
   private runSelectionAutoScroll;
   private stopSelectionAutoScroll;
+  private contextMenuTargetIsSelected;
+  private resolveContextMenuContext;
   private setupSelectionEvents;
   private buildTabs;
   private makeNavButton;
@@ -3230,7 +3638,7 @@ declare class XlsxViewerEngine implements ZoomableViewer {
   private destroyedError;
 }
 declare class XlsxViewer extends XlsxViewerEngine {
-  static fromWorkbook(container: HTMLElement, workbook: XlsxWorkbook, opts?: Omit<XlsxViewerOptions, keyof LoadOptions$3>): Omit<XlsxViewer, 'load'>;
+  static fromWorkbook(container: HTMLElement, workbook: XlsxWorkbook, opts?: Omit<XlsxViewerOptions, keyof LoadOptions>): Omit<XlsxViewer, 'load'>;
   constructor(container: HTMLElement, opts?: XlsxViewerOptions);
 }
 declare class XlsxSheetViewer implements ZoomableViewer {
@@ -3240,7 +3648,7 @@ declare class XlsxSheetViewer implements ZoomableViewer {
   private destroyed;
   private snapshot;
   private lastMetrics;
-  static fromWorkbook(canvasElement: HTMLCanvasElement, workbook: XlsxWorkbook, options?: Omit<XlsxSheetViewerOptions, keyof LoadOptions$3>): Omit<XlsxSheetViewer, 'load'>;
+  static fromWorkbook(canvasElement: HTMLCanvasElement, workbook: XlsxWorkbook, options?: Omit<XlsxSheetViewerOptions, keyof LoadOptions>): Omit<XlsxSheetViewer, 'load'>;
   constructor(canvasElement: HTMLCanvasElement, options?: XlsxSheetViewerOptions);
   load(source: string | ArrayBuffer): Promise<void>;
   get sheetIndex(): number;
@@ -3260,8 +3668,10 @@ declare class XlsxSheetViewer implements ZoomableViewer {
   fitWidth(): void;
   fitPage(): void;
   getCellAt(clientX: number, clientY: number): CellAddress | null;
-  get selection(): CellRange | null;
-  select(ref: string): void;
+  get selectionState(): XlsxSelectionState | null;
+  setSelection(selection: XlsxSelectionInput): void;
+  getSelectionContext(options?: XlsxSelectionContextOptions): XlsxSelectionContext | null;
+  copySelection(): Promise<XlsxCopyResult>;
   setSelectionColor(color: string): void;
   setHiddenSheetMode(mode: HiddenSheetMode): Promise<void>;
   get hiddenSheetMode(): HiddenSheetMode;
@@ -3278,7 +3688,7 @@ declare class XlsxSheetViewer 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, FindHighlightColors, FindMatch, FindMatchesOptions, GradientFillSpec, HiddenSheetMode, Hyperlink, HyperlinkTarget, ImageAnchor, LegendManualLayout, LoadOptions, ManualLayout, MergeCell, NumFmt, OoxmlDecodedImageLimitError, OoxmlDecodedImageLimitMetric, OoxmlError, OoxmlErrorCode, OoxmlErrorSource, OoxmlErrorStage, OoxmlFormat, OoxmlResourceLimit, OoxmlResourceLimitError, OoxmlResourceLimitErrorDetails, OoxmlResourceLimits, OoxmlResourceMetric, OoxmlResourceMetrics, OoxmlResourceMetricsCheckpoint, OoxmlResourceName, OoxmlResourcePolicySnapshot, OoxmlResourceUsageSnapshot, OoxmlResourceViolation, 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, XlsxScrollToCellOptions, XlsxSheetViewer, XlsxSheetViewerOptions, XlsxTextRunInfo, XlsxViewer, XlsxViewerOptions, XlsxViewportOffset, XlsxWorkbook, autoResize, isOoxmlDecodedImageLimitError, openExternalHyperlink, resolveSharedStrings };
+  export { ArrowEnd, AutoResizeOptions, Border, BorderEdge, Cell, CellAddress, CellFill, CellFont, CellValue, CellXf, CfIcon, CfRule, CfStop, CfValue, ChartAnchor, ChartDataLabelOverride, ChartDataPointOverride, ChartErrBars, ChartLabelBox, ChartManualLayout, ChartModel, ChartRect, ChartSeries, ChartSeriesDataLabels, ChartTrendline, ChartType, ChartexBoxSeries, ChartexBoxWhisker, ChartexSunburst, ChartexSunburstRow, ConditionalFormat, DataValidation, DefinedName, Duotone, Dxf, FillRect, FindHighlightColors, FindMatch, FindMatchesOptions, GradientFill, GradientFillSpec, GradientStop$1 as GradientStop, HiddenSheetMode, Hyperlink, HyperlinkTarget, ImageAnchor, LegendManualLayout, LoadOptions, MAX_SELECTION_AREAS, MAX_SELECTION_CONTEXT_CELLS, MAX_SELECTION_CONTEXT_TEXT_CHARACTERS, MathAccent, MathArray, MathBar, MathBorderBox, MathBox, MathDelimiter, MathFraction, MathFunc, MathGroup, MathGroupChr, MathLimit, MathNary, MathNode, MathPhant, MathRadical, MathRenderer, MathRun, MathSPre, MathScript, MathStyle, MathSvg, MergeCell, NumFmt, OoxmlDecodedImageLimitError, OoxmlDecodedImageLimitMetric, OoxmlError, OoxmlErrorCode, OoxmlErrorStage, OoxmlFormat, OoxmlResourceLimit, OoxmlResourceLimitError, OoxmlResourceLimitErrorDetails, OoxmlResourceLimits, OoxmlResourceMetric, OoxmlResourceMetrics, OoxmlResourceMetricsCheckpoint, OoxmlResourceName, OoxmlResourcePolicySnapshot, OoxmlResourceUsageSnapshot, OoxmlResourceViolation, OutlinePr, ParsedWorkbook, PathCmd, PathInfo, PatternFill, PhoneticAlignment, PhoneticProperties, PhoneticRun, PhoneticType, PivotCacheSource, PivotDataField, PivotDiagnostic, PivotLocation, PivotMetadataStatus, PivotPageField, PivotPartialReason, PivotTableMetadata, RenderViewportToBitmapOptions, ResolvedList, Row, Run, RunFont, SecondaryValueAxis, ShapeAnchor, ShapeFill, ShapeGeom, ShapeInfo, ShapeParagraph, ShapeText, ShapeTextRun, SharedString, SheetMeta, SheetVisibility, SlicerAnchor, SlicerElementStyle, SlicerItem, SlicerStyle, SolidFill, SpaceLine, Sparkline, SparklineGroup, Styles, TableColumnInfo, TableInfo, ViewerContextMenuEvent, ViewportRange, Workbook, Worksheet, WorksheetCellRange, XlsxComment, XlsxCopyResult, XlsxElementAnchorMarker, XlsxElementContext, XlsxMatchLocation, XlsxRangeSelectionContext, XlsxRenderViewportOptions, XlsxScrollToCellOptions, XlsxSelectionArea, XlsxSelectionContext, XlsxSelectionContextCell, XlsxSelectionContextOptions, XlsxSelectionInput, XlsxSelectionState, XlsxSheetViewer, XlsxSheetViewerOptions, XlsxTextRunInfo, XlsxViewer, XlsxViewerOptions, XlsxViewportOffset, XlsxWorkbook, ZoomableViewer, autoResize, isOoxmlDecodedImageLimitError, openExternalHyperlink, resolveSharedStrings };
 }
 //#endregion
 export { docx_d_exports as docx, pptx_d_exports as pptx, xlsx_d_exports as xlsx };