@silurus/ooxml 0.67.0 → 0.69.0

package/dist/types/docx.d.ts

@@ -237,6 +237,10 @@ export declare interface DocSettings {
      *  justification (ST_Jc math: left|right|center|centerGroup). `undefined`
      *  ⇒ the renderer uses the spec default `centerGroup`. */
     mathDefJc?: string;
+    /** §17.15.1.25 `w:defaultTabStop@w:val` — interval (points) between automatic
+     *  tab stops generated after all custom stops. `undefined` ⇒ the renderer
+     *  uses the spec default of 720 twips (36pt). */
+    defaultTabStop?: number;
 }
 
 export declare interface DocTable {
@@ -1257,6 +1261,18 @@ export declare interface ShapeText {
     /** ECMA-376 §17.3.1.33 `<w:spacing w:after>` of this text-box paragraph, in
      *  pt — reserved BELOW the paragraph. Absent/0 ⇒ no offset. */
     spaceAfter?: number;
+    /** ECMA-376 §17.3.1.12 `<w:ind w:left/@start>` — paragraph left indent (pt).
+     *  Absent/0 ⇒ flush to the box's inner left edge. */
+    indentLeft?: number;
+    /** ECMA-376 §17.3.1.12 `<w:ind w:right/@end>` — paragraph right indent (pt).
+     *  Absent/0 ⇒ flush to the box's inner right edge. */
+    indentRight?: number;
+    /** `<w:ind>` first-line indent (pt, SIGNED: `w:firstLine` positive,
+     *  `w:hanging` negative). A negative value hangs the first line further LEFT
+     *  than the continuation lines (the body renderer honors the sign too — Word
+     *  applies a signed hanging first-line list-independently). Absent/0 ⇒ the
+     *  first line aligns with the continuation lines. */
+    indentFirst?: number;
     /** Zip path of an inline image inside this text-box paragraph
      *  (`<w:drawing><wp:inline><a:blip r:embed>`), e.g. `word/media/image1.emf`.
      *  Absent for a text-only paragraph. */

package/dist/types/index.d.ts

@@ -1184,6 +1184,10 @@ declare interface DocSettings {
      *  justification (ST_Jc math: left|right|center|centerGroup). `undefined`
      *  ⇒ the renderer uses the spec default `centerGroup`. */
     mathDefJc?: string;
+    /** §17.15.1.25 `w:defaultTabStop@w:val` — interval (points) between automatic
+     *  tab stops generated after all custom stops. `undefined` ⇒ the renderer
+     *  uses the spec default of 720 twips (36pt). */
+    defaultTabStop?: number;
 }
 
 declare interface DocTable {
@@ -3391,6 +3395,16 @@ declare interface ShapeParagraph {
     /** `<a:pPr@rtl>` — whether the paragraph reads right-to-left
      *  (ECMA-376 §21.1.2.2.7). Omitted (undefined) when false. */
     rtl?: boolean;
+    /** `<a:pPr@marL>` — left margin in EMU (ECMA-376 §21.1.2.2.7,
+     *  `CT_TextParagraphProperties`). Direct attribute only — xlsx text boxes
+     *  have no lstStyle/level cascade. Omitted (undefined) when unset. */
+    marL?: number;
+    /** `<a:pPr@marR>` — right margin in EMU (ECMA-376 §21.1.2.2.7).
+     *  Omitted (undefined) when unset. */
+    marR?: number;
+    /** `<a:pPr@indent>` — first-line indent in EMU (negative = hanging),
+     *  ECMA-376 §21.1.2.2.7. Omitted (undefined) when unset. */
+    indent?: number;
     runs: ShapeTextRun[];
 }
 
@@ -3511,6 +3525,18 @@ declare interface ShapeText_2 {
     /** ECMA-376 §17.3.1.33 `<w:spacing w:after>` of this text-box paragraph, in
      *  pt — reserved BELOW the paragraph. Absent/0 ⇒ no offset. */
     spaceAfter?: number;
+    /** ECMA-376 §17.3.1.12 `<w:ind w:left/@start>` — paragraph left indent (pt).
+     *  Absent/0 ⇒ flush to the box's inner left edge. */
+    indentLeft?: number;
+    /** ECMA-376 §17.3.1.12 `<w:ind w:right/@end>` — paragraph right indent (pt).
+     *  Absent/0 ⇒ flush to the box's inner right edge. */
+    indentRight?: number;
+    /** `<w:ind>` first-line indent (pt, SIGNED: `w:firstLine` positive,
+     *  `w:hanging` negative). A negative value hangs the first line further LEFT
+     *  than the continuation lines (the body renderer honors the sign too — Word
+     *  applies a signed hanging first-line list-independently). Absent/0 ⇒ the
+     *  first line aligns with the continuation lines. */
+    indentFirst?: number;
     /** Zip path of an inline image inside this text-box paragraph
      *  (`<w:drawing><wp:inline><a:blip r:embed>`), e.g. `word/media/image1.emf`.
      *  Absent for a text-only paragraph. */
@@ -4387,6 +4413,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 +4527,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 +4630,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 +4661,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.
-     */
-    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.
+     * 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}.
      */
-    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

@@ -940,6 +940,16 @@ export declare interface ShapeParagraph {
     /** `<a:pPr@rtl>` — whether the paragraph reads right-to-left
      *  (ECMA-376 §21.1.2.2.7). Omitted (undefined) when false. */
     rtl?: boolean;
+    /** `<a:pPr@marL>` — left margin in EMU (ECMA-376 §21.1.2.2.7,
+     *  `CT_TextParagraphProperties`). Direct attribute only — xlsx text boxes
+     *  have no lstStyle/level cascade. Omitted (undefined) when unset. */
+    marL?: number;
+    /** `<a:pPr@marR>` — right margin in EMU (ECMA-376 §21.1.2.2.7).
+     *  Omitted (undefined) when unset. */
+    marR?: number;
+    /** `<a:pPr@indent>` — first-line indent in EMU (negative = hanging),
+     *  ECMA-376 §21.1.2.2.7. Omitted (undefined) when unset. */
+    indent?: number;
     runs: ShapeTextRun[];
 }
 
@@ -1329,6 +1339,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 +1453,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 +1556,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 +1587,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.
-     */
-    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.
+     * 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}.
      */
-    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