@silurus/ooxml 0.54.0 → 0.56.0

package/dist/types/xlsx.d.ts

@@ -464,6 +464,16 @@ declare interface LoadOptions_2 {
      * untrusted input. Zero / negative values fall back to the default.
      */
     maxZipEntryBytes?: number;
+    /**
+     * Opt-in OMML equation engine (MathJax + STIX Two Math, ~3 MB). Inject it
+     * **once** here and every render of this document / presentation / workbook
+     * uses it — the same dependency-injection contract across all three formats
+     * and their viewers. Import it from the separate `@silurus/ooxml/math` entry
+     * (`import { math } from '@silurus/ooxml/math'`). Omit it and equations are
+     * skipped and the engine tree-shakes away entirely (no network, no bundle
+     * cost).
+     */
+    math?: MathRenderer;
 }
 
 declare interface ManualLayout {
@@ -682,11 +692,6 @@ export declare interface RenderViewportOptions {
     cellScale?: number;
     /** Pre-loaded Image elements keyed by their dataUrl (for ImageAnchor rendering). */
     loadedImages?: Map<string, HTMLImageElement>;
-    /** Opt-in OMML equation engine. Import it from the separate `@silurus/ooxml/math`
-     *  entry and pass it in (`import { math } from '@silurus/ooxml/math'`). When
-     *  omitted, equations in shapes are skipped and the ~3 MB engine never enters
-     *  the bundle. Same DI contract as docx/pptx. */
-    math?: MathRenderer;
     /** Called once per cell that contains text, with canvas-pixel position and cell address. */
     onTextRun?: (info: XlsxTextRunInfo) => void;
     /** Highlighted row range for selected row headers (1-indexed inclusive).
@@ -809,6 +814,9 @@ declare interface ShapeInfo {
 declare interface ShapeParagraph {
     /** `<a:pPr@algn>` — `l` (default) | `ctr` | `r` | `just` | `dist`. */
     align: string;
+    /** `<a:pPr@rtl>` — whether the paragraph reads right-to-left
+     *  (ECMA-376 §21.1.2.2.7). Omitted (undefined) when false. */
+    rtl?: boolean;
     runs: ShapeTextRun[];
 }
 
@@ -1004,6 +1012,10 @@ export declare interface Worksheet {
      *  `<sheetView showGridLines>`). Mirrors the Excel "View → Gridlines"
      *  checkbox. Defaults to true. */
     showGridlines?: boolean;
+    /** Whether the sheet grid is laid out right-to-left, mirroring the entire
+     *  grid so column A sits on the right (ECMA-376 §18.3.1.87
+     *  `<sheetView rightToLeft>`). Defaults to false. */
+    rightToLeft?: boolean;
     /** Sheet tab color (ECMA-376 §18.3.1.79). */
     tabColor?: string | null;
     /** AutoFilter header range (ECMA-376 §18.3.1.2). */
@@ -1139,6 +1151,40 @@ export declare class XlsxViewer {
     /** The loaded workbook, or throws if {@link load} has not completed. */
     private get workbook();
     showSheet(index: number): Promise<void>;
+    /** True when the current sheet's grid is laid out right-to-left. */
+    private get isRtl();
+    /** Maximum horizontal scroll offset the native scroll host allows (≥ 0). */
+    private get maxScrollLeft();
+    /**
+     * The logical horizontal scroll position used to find the start-of-sheet
+     * (col A) edge, in *scaled* CSS pixels — the same unit as
+     * `scrollHost.scrollLeft`. The renderer always lays the grid out LTR and then
+     * mirrors it (ECMA-376 §18.3.1.87), so the viewer must hand it a position
+     * where 0 = the START of the sheet (col A) and increasing values reveal later
+     * columns.
+     *
+     * For LTR that is exactly the native `scrollLeft`. For RTL the sheet starts at
+     * the RIGHT, so the native scrollbar runs the opposite way: thumb fully right
+     * (`scrollLeft = maxScrollLeft`) is the start, thumb left is the far columns.
+     * Inverting here makes wheel/trackpad follow the finger and aligns the
+     * thumb↔page mapping with Excel, without depending on browser-specific RTL
+     * `scrollLeft` sign conventions.
+     */
+    private get effectiveScrollLeft();
+    /**
+     * Map between the logical-LTR x used by all the cell-geometry math and the
+     * on-screen (canvasArea CSS-pixel) x, applying the RTL mirror (ECMA-376
+     * §18.3.1.87) via the same {@link rtlMirrorX} the renderer uses. For LTR this
+     * is the identity. The mirror is an involution, so this one method serves
+     * both cell→px (overlay draw, `w` = cell width) and px→cell (pointer
+     * hit-testing, `w` = 0 for a point) — guaranteeing the overlay sits exactly
+     * where the cell is drawn and a click resolves to that same cell at every
+     * scroll offset. `canvasArea.clientWidth` equals the renderer's `canvasW`.
+     */
+    private screenX;
+    /** 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;
     /** 0-based index of the currently displayed sheet. */
     get sheetIndex(): number;
     /** Total number of sheets in the loaded workbook. */
@@ -1249,6 +1295,10 @@ export declare class XlsxWorkbook {
     private imageCache;
     private rawData;
     private maxZipEntryBytes;
+    /** Opt-in OMML equation engine, injected once at {@link load}. Every
+     *  `renderViewport` call reuses it — equations in shapes render when present,
+     *  and are skipped (engine tree-shaken) when omitted. */
+    private math;
     private constructor();
     /** Parse an XLSX from a URL or ArrayBuffer. */
     static load(source: string | ArrayBuffer, opts?: LoadOptions): Promise<XlsxWorkbook>;