@silurus/ooxml 0.67.0 → 0.68.0

package/dist/types/index.d.ts

@@ -4387,6 +4387,7 @@ declare class XlsxViewer {
     private selectionOverlay;
     private keydownHandler;
     private pendingTap;
+    private resizeDrag;
     /** 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. */
@@ -4500,6 +4501,33 @@ declare class XlsxViewer {
      * Returns null when the point is in the cell grid (not a header).
      */
     private getHeaderHit;
+    /**
+     * If the pointer sits on a column/row-header border (within {@link
+     * RESIZE_GRAB_PX}), return the resize target: which index to resize and the
+     * fixed LTR edge it grows from (in canvasArea CSS px). Excel resizes the band
+     * whose *trailing* border you grab — the column to the left of a vertical
+     * border, the row above a horizontal one — so both that band and its
+     * neighbour-to-the-far-side are checked. Geometry comes straight from {@link
+     * getCellRect}, so the grab line always coincides with the drawn border at any
+     * scroll offset / zoom / RTL. Returns null off the header borders.
+     */
+    private getResizeTarget;
+    /**
+     * Apply a live resize drag: size the band from its fixed origin edge to the
+     * current pointer, clamp to {@link RESIZE_MIN_PX}, and write the result back
+     * into the in-memory worksheet model in its native unit (Excel column widths /
+     * points). This is a *view-only* mutation — the file is never written. The
+     * memoized axis cache for this sheet is invalidated so every geometry read
+     * (spacer, hit-test, overlay, renderer) sees the new size on the next frame.
+     */
+    private applyResize;
+    /**
+     * Change the cell-selection highlight color at runtime (see {@link
+     * XlsxViewerOptions.selectionColor}). The border takes the color as-is and the
+     * fill becomes a translucent shade of it; the current selection repaints
+     * immediately.
+     */
+    setSelectionColor(color: string): void;
     /** Copy the selected cell range as tab-separated text to the clipboard. */
     private copySelection;
     private updateSelectionOverlay;
@@ -4576,9 +4604,15 @@ declare class XlsxViewer {
     destroy(): void;
 }
 
-declare interface XlsxViewerOptions {
+declare interface XlsxViewerOptions extends LoadOptions_2 {
     /** Scale factor for cell/header dimensions (default 1). 0.5 = half size. */
     cellScale?: number;
+    /**
+     * Enable drag-to-resize of column widths / row heights by dragging header
+     * borders. Resizing only changes the on-screen view — it never modifies the
+     * loaded file. Default: true.
+     */
+    resizable?: boolean;
     /** Show the Excel-style zoom slider at the right end of the sheet-tab bar.
      *  Default `true`. Set `false` to hide it (e.g. when the host supplies its
      *  own zoom control). */
@@ -4601,27 +4635,15 @@ declare interface XlsxViewerOptions {
     /** Called when the selected cell range changes. null means no selection. */
     onSelectionChange?: (selection: CellRange_2 | null) => void;
     /**
-     * Opt in to Google-Fonts-hosted, metric-compatible substitutes for the
-     * Office default fonts (Carlito for Calibri, Caladea for Cambria) so
-     * column layouts match Excel on systems without Office installed.
-     * Default `false`. See `XlsxWorkbook.LoadOptions.useGoogleFonts` for the
-     * privacy implications.
+     * Color of the cell-selection highlight. A single CSS color drives both the
+     * selection rectangle's border (drawn in this color) and its fill (the same
+     * color made translucent — see {@link selectionOverlayStyle}), so callers pick
+     * one accent color instead of a separate border + background. Any CSS color
+     * string works (`#1a73e8`, `rgb(...)`, `tomato`, …). Default `#1a73e8`
+     * (Google blue), matching the historical look. Can also be changed at runtime
+     * via {@link XlsxViewer.setSelectionColor}.
      */
-    useGoogleFonts?: boolean;
-    /**
-     * Override the per-entry ZIP decompression cap (bytes) used by the
-     * zip-bomb guard in the Rust parser. Defaults to 512 MiB. Zero / negative
-     * values fall back to the default.
-     */
-    maxZipEntryBytes?: number;
-    /**
-     * Opt-in OMML equation engine for rendering math in shapes/text boxes.
-     * Import it from the separate `@silurus/ooxml/math` entry and pass it in
-     * (`import { math } from '@silurus/ooxml/math'`). When omitted, equations are
-     * skipped and the ~3 MB engine never enters the bundle (tree-shaken). Same
-     * dependency-injection contract as the docx/pptx viewers.
-     */
-    math?: MathRenderer;
+    selectionColor?: string;
     /**
      * `'main'` (default): parse in a worker, render on the main thread. `'worker'`:
      * parse AND render entirely inside the worker and paint the returned

package/dist/types/xlsx.d.ts

@@ -1329,6 +1329,7 @@ export declare class XlsxViewer {
     private selectionOverlay;
     private keydownHandler;
     private pendingTap;
+    private resizeDrag;
     /** 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. */
@@ -1442,6 +1443,33 @@ export declare class XlsxViewer {
      * Returns null when the point is in the cell grid (not a header).
      */
     private getHeaderHit;
+    /**
+     * If the pointer sits on a column/row-header border (within {@link
+     * RESIZE_GRAB_PX}), return the resize target: which index to resize and the
+     * fixed LTR edge it grows from (in canvasArea CSS px). Excel resizes the band
+     * whose *trailing* border you grab — the column to the left of a vertical
+     * border, the row above a horizontal one — so both that band and its
+     * neighbour-to-the-far-side are checked. Geometry comes straight from {@link
+     * getCellRect}, so the grab line always coincides with the drawn border at any
+     * scroll offset / zoom / RTL. Returns null off the header borders.
+     */
+    private getResizeTarget;
+    /**
+     * Apply a live resize drag: size the band from its fixed origin edge to the
+     * current pointer, clamp to {@link RESIZE_MIN_PX}, and write the result back
+     * into the in-memory worksheet model in its native unit (Excel column widths /
+     * points). This is a *view-only* mutation — the file is never written. The
+     * memoized axis cache for this sheet is invalidated so every geometry read
+     * (spacer, hit-test, overlay, renderer) sees the new size on the next frame.
+     */
+    private applyResize;
+    /**
+     * Change the cell-selection highlight color at runtime (see {@link
+     * XlsxViewerOptions.selectionColor}). The border takes the color as-is and the
+     * fill becomes a translucent shade of it; the current selection repaints
+     * immediately.
+     */
+    setSelectionColor(color: string): void;
     /** Copy the selected cell range as tab-separated text to the clipboard. */
     private copySelection;
     private updateSelectionOverlay;
@@ -1518,9 +1546,15 @@ export declare class XlsxViewer {
     destroy(): void;
 }
 
-export declare interface XlsxViewerOptions {
+export declare interface XlsxViewerOptions extends LoadOptions_2 {
     /** Scale factor for cell/header dimensions (default 1). 0.5 = half size. */
     cellScale?: number;
+    /**
+     * Enable drag-to-resize of column widths / row heights by dragging header
+     * borders. Resizing only changes the on-screen view — it never modifies the
+     * loaded file. Default: true.
+     */
+    resizable?: boolean;
     /** Show the Excel-style zoom slider at the right end of the sheet-tab bar.
      *  Default `true`. Set `false` to hide it (e.g. when the host supplies its
      *  own zoom control). */
@@ -1543,27 +1577,15 @@ export declare interface XlsxViewerOptions {
     /** Called when the selected cell range changes. null means no selection. */
     onSelectionChange?: (selection: CellRange | null) => void;
     /**
-     * Opt in to Google-Fonts-hosted, metric-compatible substitutes for the
-     * Office default fonts (Carlito for Calibri, Caladea for Cambria) so
-     * column layouts match Excel on systems without Office installed.
-     * Default `false`. See `XlsxWorkbook.LoadOptions.useGoogleFonts` for the
-     * privacy implications.
+     * Color of the cell-selection highlight. A single CSS color drives both the
+     * selection rectangle's border (drawn in this color) and its fill (the same
+     * color made translucent — see {@link selectionOverlayStyle}), so callers pick
+     * one accent color instead of a separate border + background. Any CSS color
+     * string works (`#1a73e8`, `rgb(...)`, `tomato`, …). Default `#1a73e8`
+     * (Google blue), matching the historical look. Can also be changed at runtime
+     * via {@link XlsxViewer.setSelectionColor}.
      */
-    useGoogleFonts?: boolean;
-    /**
-     * Override the per-entry ZIP decompression cap (bytes) used by the
-     * zip-bomb guard in the Rust parser. Defaults to 512 MiB. Zero / negative
-     * values fall back to the default.
-     */
-    maxZipEntryBytes?: number;
-    /**
-     * Opt-in OMML equation engine for rendering math in shapes/text boxes.
-     * Import it from the separate `@silurus/ooxml/math` entry and pass it in
-     * (`import { math } from '@silurus/ooxml/math'`). When omitted, equations are
-     * skipped and the ~3 MB engine never enters the bundle (tree-shaken). Same
-     * dependency-injection contract as the docx/pptx viewers.
-     */
-    math?: MathRenderer;
+    selectionColor?: string;
     /**
      * `'main'` (default): parse in a worker, render on the main thread. `'worker'`:
      * parse AND render entirely inside the worker and paint the returned