@silurus/ooxml 0.66.3 → 0.68.0

package/dist/types/docx.d.ts

@@ -46,11 +46,20 @@ export declare type BodyElement = {
 *  "continuous" (same page), "nextPage" (default; page break), "oddPage" /
 *  "evenPage" (page break + parity padding). The paginator switches its active
 *  newspaper-column geometry per section at each marker — fixing the regression
-*  where every section inherited the body-level section's columns. */
+*  where every section inherited the body-level section's columns.
+*
+*  `headers`/`footers` carry the ENDING section's resolved (§17.10.1-inherited)
+*  header/footer set, and `titlePage` its own `<w:titlePg>` flag, so the renderer
+*  can pick the active section's header/footer per page (mirroring how `columns`
+*  drives per-section column geometry). The body-level (final) section's sets
+*  live on {@link DocxDocumentModel.section}/`.headers`/`.footers` instead. */
 | {
     type: 'sectionBreak';
     kind: 'continuous' | 'nextPage' | 'oddPage' | 'evenPage' | string;
     columns?: ColumnsSpec | null;
+    headers?: HeadersFooters;
+    footers?: HeadersFooters;
+    titlePage?: boolean;
 };
 
 export declare interface BorderSpec {
@@ -1242,6 +1251,12 @@ export declare interface ShapeText {
      *  paragraphs. */
     runs?: ShapeTextRun[];
     alignment: string;
+    /** ECMA-376 §17.3.1.33 `<w:spacing w:before>` of this text-box paragraph, in
+     *  pt — reserved ABOVE the paragraph inside the box. Absent/0 ⇒ no offset. */
+    spaceBefore?: number;
+    /** 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;
     /** 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

@@ -91,11 +91,20 @@ declare type BodyElement = {
 *  "continuous" (same page), "nextPage" (default; page break), "oddPage" /
 *  "evenPage" (page break + parity padding). The paginator switches its active
 *  newspaper-column geometry per section at each marker — fixing the regression
-*  where every section inherited the body-level section's columns. */
+*  where every section inherited the body-level section's columns.
+*
+*  `headers`/`footers` carry the ENDING section's resolved (§17.10.1-inherited)
+*  header/footer set, and `titlePage` its own `<w:titlePg>` flag, so the renderer
+*  can pick the active section's header/footer per page (mirroring how `columns`
+*  drives per-section column geometry). The body-level (final) section's sets
+*  live on {@link DocxDocumentModel.section}/`.headers`/`.footers` instead. */
 | {
     type: 'sectionBreak';
     kind: 'continuous' | 'nextPage' | 'oddPage' | 'evenPage' | string;
     columns?: ColumnsSpec | null;
+    headers?: HeadersFooters;
+    footers?: HeadersFooters;
+    titlePage?: boolean;
 };
 
 declare interface Border {
@@ -1779,6 +1788,18 @@ declare interface ImageAnchor {
      *  svgBlip extension. Its MIME is always `image/svg+xml` and is owned by the
      *  SVG decoder. */
     svgImagePath?: string;
+    /** ECMA-376 §20.1.8.55 `<a:srcRect>` source-image crop. Each edge inset is a
+     *  fraction `0..1` of the source bitmap, measured inward, so the visible
+     *  source region is `[l, t, 1-r, 1-b]`. Absent (the common case) ⇒ the whole
+     *  blip fills the anchor rect; when present, the renderer draws only the
+     *  cropped sub-rectangle (raster only — a metafile is rasterized to the
+     *  display box, so its crop can't be honored faithfully and is skipped). */
+    srcRect?: {
+        l: number;
+        t: number;
+        r: number;
+        b: number;
+    };
 }
 
 /**
@@ -2539,14 +2560,16 @@ declare interface PictureElement {
      */
     prstAdjust?: number[];
     /**
-     * ECMA-376 a:srcRect — source image crop as fractions (0..1) of the source
-     * width/height. Omitted when the image is not cropped.
+     * ECMA-376 §20.1.8.55 a:srcRect — source image crop as fractions (0..1) of the
+     * source width/height, measured inward from each edge. Omitted when the image
+     * is not cropped; when present the parser emits all four edges (absent edges
+     * default to 0), so the renderer reads them without a fallback.
      */
     srcRect?: {
-        l?: number;
-        t?: number;
-        r?: number;
-        b?: number;
+        l: number;
+        t: number;
+        r: number;
+        b: number;
     };
     /** a:blip > a:alphaModFix@amt as 0..1. Undefined = fully opaque. */
     alpha?: number;
@@ -3332,6 +3355,16 @@ declare type ShapeGeom = {
      *  when the picture carries no svgBlip extension. Its MIME is always
      *  `image/svg+xml` and is owned by the SVG decoder. */
     svgImagePath?: string;
+    /** ECMA-376 §20.1.8.55 `<a:srcRect>` source-image crop on the leaf pic
+     *  (fractions `0..1` inward from each edge; visible region `[l, t, 1-r,
+     *  1-b]`). Absent ⇒ the whole blip fills the leaf rect. Honored identically
+     *  to the top-level {@link ImageAnchor.srcRect} (raster only). */
+    srcRect?: {
+        l: number;
+        t: number;
+        r: number;
+        b: number;
+    };
 };
 
 declare interface ShapeInfo {
@@ -3472,6 +3505,12 @@ declare interface ShapeText_2 {
      *  paragraphs. */
     runs?: ShapeTextRun_2[];
     alignment: string;
+    /** ECMA-376 §17.3.1.33 `<w:spacing w:before>` of this text-box paragraph, in
+     *  pt — reserved ABOVE the paragraph inside the box. Absent/0 ⇒ no offset. */
+    spaceBefore?: number;
+    /** 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;
     /** 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. */
@@ -4348,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. */
@@ -4461,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;
@@ -4537,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). */
@@ -4562,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/pptx.d.ts

@@ -1077,14 +1077,16 @@ export declare interface PictureElement {
      */
     prstAdjust?: number[];
     /**
-     * ECMA-376 a:srcRect — source image crop as fractions (0..1) of the source
-     * width/height. Omitted when the image is not cropped.
+     * ECMA-376 §20.1.8.55 a:srcRect — source image crop as fractions (0..1) of the
+     * source width/height, measured inward from each edge. Omitted when the image
+     * is not cropped; when present the parser emits all four edges (absent edges
+     * default to 0), so the renderer reads them without a fallback.
      */
     srcRect?: {
-        l?: number;
-        t?: number;
-        r?: number;
-        b?: number;
+        l: number;
+        t: number;
+        r: number;
+        b: number;
     };
     /** a:blip > a:alphaModFix@amt as 0..1. Undefined = fully opaque. */
     alpha?: number;

package/dist/types/xlsx.d.ts

@@ -476,6 +476,18 @@ export declare interface ImageAnchor {
      *  svgBlip extension. Its MIME is always `image/svg+xml` and is owned by the
      *  SVG decoder. */
     svgImagePath?: string;
+    /** ECMA-376 §20.1.8.55 `<a:srcRect>` source-image crop. Each edge inset is a
+     *  fraction `0..1` of the source bitmap, measured inward, so the visible
+     *  source region is `[l, t, 1-r, 1-b]`. Absent (the common case) ⇒ the whole
+     *  blip fills the anchor rect; when present, the renderer draws only the
+     *  cropped sub-rectangle (raster only — a metafile is rasterized to the
+     *  display box, so its crop can't be honored faithfully and is skipped). */
+    srcRect?: {
+        l: number;
+        t: number;
+        r: number;
+        b: number;
+    };
 }
 
 export declare interface LegendManualLayout {
@@ -892,6 +904,16 @@ export declare type ShapeGeom = {
      *  when the picture carries no svgBlip extension. Its MIME is always
      *  `image/svg+xml` and is owned by the SVG decoder. */
     svgImagePath?: string;
+    /** ECMA-376 §20.1.8.55 `<a:srcRect>` source-image crop on the leaf pic
+     *  (fractions `0..1` inward from each edge; visible region `[l, t, 1-r,
+     *  1-b]`). Absent ⇒ the whole blip fills the leaf rect. Honored identically
+     *  to the top-level {@link ImageAnchor.srcRect} (raster only). */
+    srcRect?: {
+        l: number;
+        t: number;
+        r: number;
+        b: number;
+    };
 };
 
 export declare interface ShapeInfo {
@@ -1307,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. */
@@ -1420,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;
@@ -1496,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). */
@@ -1521,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