@silurus/ooxml 0.56.0 → 0.58.0

package/dist/types/xlsx.d.ts

@@ -131,12 +131,12 @@ export declare interface CellXf {
     readingOrder?: number;
 }
 
-declare interface CfIcon {
+export declare interface CfIcon {
     iconSet: string;
     iconId: number;
 }
 
-declare type CfRule = {
+export declare type CfRule = {
     type: 'cellIs';
     operator: string;
     formulas: string[];
@@ -169,6 +169,8 @@ declare type CfRule = {
 } | {
     type: 'aboveAverage';
     aboveAverage: boolean;
+    equalAverage?: boolean;
+    stdDev?: number;
     dxfId: number | null;
     priority: number;
 } | {
@@ -184,18 +186,18 @@ declare type CfRule = {
     priority: number;
 };
 
-declare interface CfStop {
+export declare interface CfStop {
     kind: string;
     value: string | null;
     color: string;
 }
 
-declare interface CfValue {
+export declare interface CfValue {
     kind: string;
     value: string | null;
 }
 
-declare interface ChartAnchor {
+export declare interface ChartAnchor {
     fromCol: number;
     fromColOff: number;
     fromRow: number;
@@ -212,7 +214,7 @@ declare interface ChartAnchor {
  * which the renderer combines into a canonical `ChartModel.chartType` (e.g.
  * `clusteredBarH`, `stackedBarPct`) at render time.
  */
-declare interface ChartData {
+export declare interface ChartData {
     /** Primary chart type: "bar"|"line"|"area"|"pie"|"doughnut"|"radar"|"scatter" */
     chartType: string;
     /** "col" (vertical bars) | "row" (horizontal bars) */
@@ -321,12 +323,12 @@ declare interface ChartData {
     plotAreaManualLayout?: ManualLayout;
 }
 
-declare interface ConditionalFormat {
+export declare interface ConditionalFormat {
     sqref: CellRange_2[];
     rules: CfRule[];
 }
 
-declare interface DataLabelOverride {
+export declare interface DataLabelOverride {
     idx: number;
     text: string;
     /** "l"|"r"|"t"|"b"|"ctr"|"outEnd"|"bestFit" or undefined → inherit. */
@@ -336,7 +338,7 @@ declare interface DataLabelOverride {
     fontBold?: boolean;
 }
 
-declare interface DataPointOverride {
+export declare interface DataPointOverride {
     idx: number;
     color?: string;
     markerSymbol?: string;
@@ -345,12 +347,34 @@ declare interface DataPointOverride {
     markerLine?: string;
 }
 
-declare interface DefinedName {
+/** One `<dataValidation>` rule (ECMA-376 §18.3.1.33). `type` is the constraint
+ *  class (`list` | `whole` | `decimal` | `date` | `time` | `textLength` |
+ *  `custom`); `operator` qualifies it (`between` | `notBetween` | `equal` | …).
+ *  `formula1` / `formula2` are the operands (for `list`, `formula1` is the
+ *  comma-separated literal list or a range/named reference). 1:1 with the Rust
+ *  `DataValidation` (serde camelCase). */
+export declare interface DataValidation {
+    /** Affected cell ranges, verbatim from `@sqref` (space-separated A1 refs). */
+    sqref: string;
+    /** Constraint class. Absent means the spec default (`none`, no constraint). */
+    validationType?: string;
+    operator?: string;
+    formula1?: string;
+    formula2?: string;
+    /** `@allowBlank` — empty input is permitted. */
+    allowBlank?: boolean;
+    promptTitle?: string;
+    prompt?: string;
+    errorTitle?: string;
+    errorMessage?: string;
+}
+
+export declare interface DefinedName {
     name: string;
     formula: string;
 }
 
-declare interface Dxf {
+export declare interface Dxf {
     font: CellFont | null;
     fill: CellFill | null;
     border: Border | null;
@@ -361,7 +385,7 @@ declare interface Dxf {
     numFmt?: NumFmt | null;
 }
 
-declare interface ErrBars {
+export declare interface ErrBars {
     /** "x" | "y". */
     dir: string;
     /** "plus" | "minus" | "both". */
@@ -375,7 +399,7 @@ declare interface ErrBars {
     dash?: string;
 }
 
-declare interface GradientFillSpec {
+export declare interface GradientFillSpec {
     /** "linear" (default) or "path". */
     gradientType: string;
     /** Rotation in degrees for linear gradients (0 = left→right). */
@@ -391,7 +415,7 @@ declare interface GradientFillSpec {
     }[];
 }
 
-declare interface Hyperlink {
+export declare interface Hyperlink {
     col: number;
     row: number;
     url: string | null;
@@ -401,7 +425,7 @@ declare interface Hyperlink {
  * Image anchored to a rectangle of cells (EMU offsets within the anchor cells).
  * 914400 EMU = 1 inch, 9525 EMU = 1 px @ 96 DPI.
  */
-declare interface ImageAnchor {
+export declare interface ImageAnchor {
     fromCol: number;
     fromColOff: number;
     fromRow: number;
@@ -423,7 +447,7 @@ declare interface ImageAnchor {
     dataUrl: string;
 }
 
-declare interface LegendManualLayout {
+export declare interface LegendManualLayout {
     xMode: string;
     yMode: string;
     x: number;
@@ -476,7 +500,7 @@ declare interface LoadOptions_2 {
     math?: MathRenderer;
 }
 
-declare interface ManualLayout {
+export declare interface ManualLayout {
     xMode: string;
     yMode: string;
     layoutTarget?: string;
@@ -637,7 +661,7 @@ export declare interface ParsedWorkbook {
     sharedStrings: SharedString[];
 }
 
-declare type PathCmd = {
+export declare type PathCmd = {
     op: 'moveTo';
     x: number;
     y: number;
@@ -672,7 +696,7 @@ declare type PathCmd = {
     op: 'close';
 };
 
-declare interface PathInfo {
+export declare interface PathInfo {
     w: number;
     h: number;
     commands: PathCmd[];
@@ -710,18 +734,32 @@ export declare interface RenderViewportOptions {
     } | null;
 }
 
+/**
+ * Resolved allowed-value set for a list validation. Either concrete display
+ * `values` (inline list or expanded range), or — when the operand is a defined
+ * name / complex formula we cannot expand — the raw `formula` text so the panel
+ * can disclose it instead of showing nothing.
+ */
+export declare type ResolvedList = {
+    kind: 'values';
+    values: string[];
+} | {
+    kind: 'formula';
+    formula: string;
+};
+
 export declare interface Row {
     index: number;
     height: number | null;
     cells: Cell[];
 }
 
-declare interface Run {
+export declare interface Run {
     text: string;
     font?: RunFont;
 }
 
-declare interface RunFont {
+export declare interface RunFont {
     bold: boolean;
     italic: boolean;
     underline: boolean;
@@ -745,7 +783,7 @@ declare interface RunFont {
 declare type SelectionMode_2 = 'cells' | 'rows' | 'cols' | 'all';
 export { SelectionMode_2 as SelectionMode }
 
-declare interface SeriesDataLabels {
+export declare interface SeriesDataLabels {
     showVal: boolean;
     showCatName: boolean;
     showSerName: boolean;
@@ -757,7 +795,7 @@ declare interface SeriesDataLabels {
     fontSizeHpt?: number;
 }
 
-declare interface ShapeAnchor {
+export declare interface ShapeAnchor {
     fromCol: number;
     fromColOff: number;
     fromRow: number;
@@ -778,9 +816,14 @@ declare interface ShapeAnchor {
     shapes: ShapeInfo[];
 }
 
-declare type ShapeGeom = {
+export declare type ShapeGeom = {
     type: 'preset';
     name: string;
+    /** Adjust handles from `<a:avLst><a:gd>` in `adj1..adj8` order
+     *  (ECMA-376 §19.5.31.3 / §20.1.9.5). `null` entries mean "use the
+     *  preset's declared default". Omitted entirely when the shape has no
+     *  `<a:avLst>`. Consumed by the shared `renderPresetShape` engine. */
+    adj?: (number | null)[];
 } | {
     type: 'custom';
     paths: PathInfo[];
@@ -793,7 +836,7 @@ declare type ShapeGeom = {
     dataUrl: string;
 };
 
-declare interface ShapeInfo {
+export declare interface ShapeInfo {
     /** Normalized [0,1] position/size relative to the anchor rect. */
     x: number;
     y: number;
@@ -811,7 +854,7 @@ declare interface ShapeInfo {
     text?: ShapeText;
 }
 
-declare interface ShapeParagraph {
+export declare interface ShapeParagraph {
     /** `<a:pPr@algn>` — `l` (default) | `ctr` | `r` | `just` | `dist`. */
     align: string;
     /** `<a:pPr@rtl>` — whether the paragraph reads right-to-left
@@ -820,7 +863,7 @@ declare interface ShapeParagraph {
     runs: ShapeTextRun[];
 }
 
-declare interface ShapeText {
+export declare interface ShapeText {
     /** `<a:bodyPr@anchor>` — vertical alignment of the text block within the
      *  shape rect. `t` (top, default), `ctr` (middle), `b` (bottom). */
     anchor: string;
@@ -833,7 +876,7 @@ declare interface ShapeText {
  *  (matches the pptx `TextRun` shape): styled text, a soft line break, or an
  *  OMML equation. Excel stores "Insert > Equation" as OMML inside the shared
  *  DrawingML `<xdr:txBody>` grammar (ECMA-376 §22.1), like PowerPoint. */
-declare type ShapeTextRun = {
+export declare type ShapeTextRun = {
     type: 'text';
     text: string;
     bold: boolean;
@@ -856,7 +899,7 @@ declare type ShapeTextRun = {
     color?: string;
 };
 
-declare interface SharedString {
+export declare interface SharedString {
     text: string;
     runs?: Run[];
 }
@@ -871,7 +914,7 @@ export declare interface SheetMeta {
     tabColor?: string | null;
 }
 
-declare interface SlicerAnchor {
+export declare interface SlicerAnchor {
     fromCol: number;
     fromColOff: number;
     fromRow: number;
@@ -884,12 +927,12 @@ declare interface SlicerAnchor {
     items: SlicerItem[];
 }
 
-declare interface SlicerItem {
+export declare interface SlicerItem {
     name: string;
     selected: boolean;
 }
 
-declare interface Sparkline {
+export declare interface Sparkline {
     /** 1-based row of the destination cell (`<xm:sqref>`). */
     row: number;
     /** 1-based column of the destination cell. */
@@ -899,7 +942,7 @@ declare interface Sparkline {
     values: (number | null)[];
 }
 
-declare interface SparklineGroup {
+export declare interface SparklineGroup {
     /** `line` (default) | `column` | `stem` (win-loss). */
     kind: 'line' | 'column' | 'stem';
     markers: boolean;
@@ -942,7 +985,7 @@ export declare interface Styles {
 
 /** Per-column DXF references inside a `<table>` element
  *  (ECMA-376 §18.5.1.3 `tableColumn`). */
-declare interface TableColumnInfo {
+export declare interface TableColumnInfo {
     /** `<tableColumn dataDxfId>` — applied to data cells in this column. */
     dataDxfId?: number;
     /** `<tableColumn headerRowDxfId>` — applied to the header cell of this column. */
@@ -951,7 +994,7 @@ declare interface TableColumnInfo {
     totalsRowDxfId?: number;
 }
 
-declare interface TableInfo {
+export declare interface TableInfo {
     range: CellRange_2;
     styleName: string;
     headerRowCount: number;
@@ -963,13 +1006,29 @@ declare interface TableInfo {
     /** Accent color resolved by the parser from the built-in style name against
      *  the file's theme accents (e.g. `TableStyleLight18` → accent3). */
     accentColor: string;
+    /** `true` when `styleName` is defined in the file's `<tableStyles>` block,
+     *  i.e. a *custom* style (ECMA-376 §18.5.1.2). The renderer draws such tables
+     *  strictly from their declared element dxfs and must NOT apply the accent
+     *  approximation (banding / synthesized rules / header) reserved for built-in
+     *  style names whose definitions are absent from the file. */
+    isCustom?: boolean;
     /** Dxf index for the `wholeTable` element of a custom `<tableStyle>`
-     *  (ECMA-376 §18.8.40). When set, its border/fill apply to every cell of
+     *  (ECMA-376 §18.8.83). When set, its border/fill apply to every cell of
      *  the table as a base layer. Undefined for built-in style names. */
     wholeTableDxf?: number;
     /** Dxf index for the `headerRow` element of a custom `<tableStyle>` —
      *  provides header background, font color/weight, and vertical separators. */
     headerRowDxf?: number;
+    /** Dxf index for the `totalRow` element (ECMA-376 §18.18.93). */
+    totalRowDxf?: number;
+    /** Dxf index for the `firstColumn` element. */
+    firstColumnDxf?: number;
+    /** Dxf index for the `lastColumn` element. */
+    lastColumnDxf?: number;
+    /** Dxf index for `firstRowStripe` (band1 horizontal) — odd banded-row stripe. */
+    band1HorizontalDxf?: number;
+    /** Dxf index for `secondRowStripe` (band2 horizontal) — even banded-row stripe. */
+    band2HorizontalDxf?: number;
     /** Per-column DXF references (ECMA-376 §18.5.1.3 `tableColumn`). Index by
      *  `cellCol - range.left`. The renderer can use these to apply column-level
      *  overlays for named-style tables; for files where Excel pre-bakes the
@@ -1025,6 +1084,17 @@ export declare interface Worksheet {
     /** A1-style cell refs of commented cells (ECMA-376 §18.7.3). Rendered as a
      *  small red triangle in each cell's top-right corner. */
     commentRefs?: string[];
+    /** Full-fidelity comment bodies (cell ref + author + plain text) for every
+     *  `<comment>` in `xl/commentsN.xml` (ECMA-376 §18.7). Parallel to
+     *  {@link commentRefs} (one entry per ref). Consume this to read the note
+     *  text; the renderer uses {@link commentRefs} for the red indicator and the
+     *  viewer surfaces these bodies in an Excel-style hover popup. */
+    comments?: XlsxComment[];
+    /** Data-validation rules on this sheet (ECMA-376 §18.3.1.32–33). Exposed for
+     *  tooling. The viewer draws a list-dropdown arrow on the active cell when the
+     *  selection intersects a `list`-type rule's `sqref` (display only — opening
+     *  the list / picking a value is out of scope for a viewer). */
+    dataValidations?: DataValidation[];
     /** Defined names in scope for this sheet (ECMA-376 §18.2.5). Used by
      *  conditional-formatting `expression` rules that call named ranges
      *  (e.g. `task_start`, `today`). */
@@ -1054,7 +1124,7 @@ export declare interface Worksheet {
  * XLSX parser's raw chart series (includes XLSX-only `seriesType` for mixed
  * charts). Adapted to `ChartSeries` from @silurus/ooxml-core before rendering.
  */
-declare interface XlsxChartSeries {
+export declare interface XlsxChartSeries {
     name: string;
     /** Chart sub-type for this series (allows mixed charts). */
     seriesType: string;
@@ -1097,6 +1167,24 @@ declare interface XlsxChartSeries {
     errBars?: ErrBars[];
 }
 
+/** One cell comment. Sourced from the classic notes file `xl/commentsN.xml`
+ *  (ECMA-376 §18.7) when present, otherwise from the Office-365 threaded
+ *  comments part `xl/threadedComments/` (MS-XLSX schema
+ *  `…/spreadsheetml/2018/threadedcomments`, `personId` resolved via
+ *  `xl/persons/`). `text` is the joined plain text — every `<r><t>` run for
+ *  classic notes, every reply in the thread (newline-joined) for threaded
+ *  comments; rich-text formatting is dropped. 1:1 with the Rust `XlsxComment`
+ *  (serde camelCase). */
+export declare interface XlsxComment {
+    /** A1-style cell reference (`@ref` on the comment element). */
+    cellRef: string;
+    /** Resolved author name — the `<authors>` entry (classic) or the `<person>`
+     *  `displayName` (threaded). Absent when unresolved. */
+    author?: string;
+    /** Concatenated plain text of every run / threaded reply. */
+    text: string;
+}
+
 /** Emitted once per cell that has text, with the cell's canvas-pixel bounds. */
 export declare interface XlsxTextRunInfo {
     text: string;
@@ -1132,6 +1220,17 @@ export declare class XlsxViewer {
     private currentWorksheet;
     private opts;
     private resizeObserver;
+    /**
+     * Start-anchored horizontal scroll position (the {@link effectiveScrollLeft}
+     * value last produced by a real user scroll or a programmatic reset), kept
+     * as the source of truth across container size changes. The native
+     * `scrollLeft` cannot serve that role for RTL sheets (ECMA-376 §18.3.1.87):
+     * it is the *inverse* of the start-anchored offset, and the browser clamps
+     * any assignment to 0 while the host is unlaid-out (`display:none` mount —
+     * e.g. a host revealed only after `load()` resolves), which would otherwise
+     * strand the view at the sheet's far end once the host gains its real size.
+     */
+    private effectiveH;
     private anchorCell;
     private activeCell;
     private selectionMode;
@@ -1139,6 +1238,32 @@ export declare class XlsxViewer {
     private selectionOverlay;
     private keydownHandler;
     private pendingTap;
+    /** DOM overlay element that shows the hovered cell's comment. Lives in
+     *  canvasArea above the scrollHost; `pointer-events:none` so it never blocks
+     *  cell interaction. */
+    private commentPopup;
+    /** `"row:col"` → comment for the current sheet, rebuilt on every showSheet. */
+    private commentMap;
+    /** `"row:col"` of the cell whose popup is currently shown (or pending), so a
+     *  pointermove within the same cell doesn't restart the show timer. */
+    private commentPopupKey;
+    /** Pending show timer (see {@link COMMENT_POPUP_DELAY_MS}). */
+    private commentPopupTimer;
+    /** DOM overlay listing a list-validated cell's allowed values. Lives in
+     *  canvasArea above the scrollHost; unlike the comment popup this is a click
+     *  target (`pointer-events:auto`). Read-only: hovering an item highlights it
+     *  but selecting does NOT change the cell. */
+    private validationPanel;
+    /** `"row:col"` of the cell whose panel is currently open, or null. Lets a
+     *  re-click on the same arrow toggle the panel closed. */
+    private validationPanelKey;
+    /** Screen rect (canvasArea CSS px) of the dropdown arrow button last drawn by
+     *  {@link maybeDrawValidationDropdown}, so pointerdown can hit-test it. Null
+     *  when no arrow is currently visible. */
+    private validationArrowRect;
+    /** Document-level pointerdown listener that closes the panel on an outside
+     *  click; installed only while the panel is open. */
+    private validationOutsideHandler;
     constructor(container: HTMLElement, opts?: XlsxViewerOptions);
     /**
      * Load an XLSX from URL or ArrayBuffer and render the first sheet.
@@ -1185,6 +1310,11 @@ export declare class XlsxViewer {
     /** Park the scrollbar at the sheet's natural start: scrollLeft=0 for LTR,
      *  the right end for RTL (so col A shows first). */
     private resetHorizontalScroll;
+    /** Re-derive the native scrollLeft from the tracked start-anchored
+     *  position after the scroll host's size changes. Only RTL needs this:
+     *  for LTR the native scrollLeft *is* start-anchored and the browser
+     *  already clamps it sensibly on resize. */
+    private reanchorHorizontalScroll;
     /** 0-based index of the currently displayed sheet. */
     get sheetIndex(): number;
     /** Total number of sheets in the loaded workbook. */
@@ -1208,6 +1338,14 @@ export declare class XlsxViewer {
     private getCellRect;
     /** Returns the current selection, including mode. */
     get selection(): CellRange | null;
+    /**
+     * Programmatically select a single cell by A1 reference (e.g. `"B2"`), as if
+     * the user had clicked it: updates the active/anchor cell, redraws the
+     * selection overlay (including any list-validation dropdown arrow), and fires
+     * `onSelectionChange`. A no-op for malformed refs. Closes any open validation
+     * panel, matching the click path.
+     */
+    select(ref: string): void;
     /**
      * Returns what the header area contains at the given client coordinates.
      * Returns null when the point is in the cell grid (not a header).
@@ -1216,6 +1354,49 @@ export declare class XlsxViewer {
     /** Copy the selected cell range as tab-separated text to the clipboard. */
     private copySelection;
     private updateSelectionOverlay;
+    /** Draw the Excel list-validation dropdown button just outside the
+     *  bottom-right corner of the *active* cell when that cell is covered by a
+     *  `list` data-validation rule. Anchored to the single active cell (not the
+     *  whole range) to mirror Excel, which attaches the button to the active
+     *  cell of the selection. */
+    private maybeDrawValidationDropdown;
+    /** Toggle the dropdown panel for the active cell's list validation. Called
+     *  from pointerdown when the arrow rect is hit. Re-clicking the same arrow
+     *  closes it. */
+    private toggleValidationPanel;
+    /** Resolve the allowed values for `formula1` (relative to the current sheet)
+     *  and render them in the panel anchored below the active cell. Async because
+     *  cross-sheet range references may need a lazily-parsed worksheet. */
+    private openValidationPanel;
+    /** Build the panel's children. Uses textContent throughout (no HTML injection
+     *  from cell values). Items highlight on hover but are NOT selectable —
+     *  this is a read-only viewer, so clicking a value must not change the cell. */
+    private renderValidationPanel;
+    /** Position the (already-populated, visible-or-becoming-visible) panel below
+     *  the dropdown arrow / active cell using the pure geometry calculator. */
+    private positionValidationPanel;
+    /** Install a document-level pointerdown listener that closes the panel on a
+     *  click outside it (and outside the arrow, which toggles via its own path).
+     *  Removed by {@link hideValidationPanel}. */
+    private installValidationOutsideHandler;
+    /** Hide the panel and detach its outside-click listener. Called on re-click,
+     *  outside click, Esc, scroll, selection change, sheet switch and destroy. */
+    private hideValidationPanel;
+    /** Build the `"row:col"` → comment index for the given sheet. Parses each
+     *  `XlsxComment.cellRef` with the shared {@link parseA1}; later refs win on a
+     *  collision (Excel allows at most one note per cell, so this is moot in
+     *  practice). */
+    private buildCommentMap;
+    /** Show the popup for the comment on `cell` after the hover dwell, anchored to
+     *  the cell's current on-screen rect. No-op when the cell carries no comment.
+     *  Re-hovering the same cell does not restart the timer. */
+    private scheduleCommentPopup;
+    /** Immediately render the popup for `comment` anchored to `cell` (used by the
+     *  hover-dwell timer and by touch selection, which has no hover). */
+    private renderCommentPopup;
+    /** Hide the popup and cancel any pending show. Called on cell-out, scroll,
+     *  sheet switch and destroy. */
+    private hideCommentPopup;
     private applyPointerSelection;
     private setupSelectionEvents;
     private buildTabs;
@@ -1258,7 +1439,15 @@ export declare interface XlsxViewerOptions {
     zoomMin?: number;
     zoomMax?: number;
     onReady?: (sheetNames: string[]) => void;
-    onSheetChange?: (index: number, name: string) => void;
+    /**
+     * Called when the active sheet changes, with the new sheet's zero-based
+     * `index` and the `total` number of sheets in the workbook. This mirrors the
+     * docx `onPageChange` and pptx `onSlideChange` contracts so all three viewers
+     * share one callback shape. To get the sheet *name*, look it up by index from
+     * `viewer.sheetNames[index]` (or the `sheetNames` array delivered to
+     * `onReady`).
+     */
+    onSheetChange?: (index: number, total: number) => void;
     onError?: (err: Error) => void;
     /** Called when the selected cell range changes. null means no selection. */
     onSelectionChange?: (selection: CellRange | null) => void;
@@ -1309,6 +1498,22 @@ export declare class XlsxWorkbook {
      *  `null` for sheets that declare no tab color. */
     get tabColors(): (string | null)[];
     getWorksheet(sheetIndex: number): Promise<Worksheet>;
+    /**
+     * Resolve a `list`-type data-validation `formula1` (ECMA-376 §18.3.1.32) into
+     * the set of allowed values to display, evaluated relative to `sheetIndex`
+     * (the sheet that owns the validation, used to resolve unqualified ranges):
+     *
+     * - Inline quoted list `"A,B,C"`        → the literal values.
+     * - Range ref `$B$2:$B$5`               → each non-empty cell's *display
+     *   string* (the same formatted text the grid shows, via {@link formatCellValue}),
+     *   walked row-major. `Sheet2!$A$1:$A$9` resolves against the named sheet
+     *   (lazily parsed via {@link getWorksheet}, hence async).
+     * - Named range / complex formula       → `{ kind: 'formula' }` carrying the
+     *   raw text so the caller can disclose it rather than blanking it.
+     *
+     * Read-only: this only reads cell values for display; it never writes.
+     */
+    resolveValidationList(sheetIndex: number, formula1: string | undefined): Promise<ResolvedList>;
     renderViewport(target: HTMLCanvasElement | OffscreenCanvas, sheetIndex: number, viewport: ViewportRange, opts?: RenderViewportOptions): Promise<void>;
     destroy(): void;
 }