@silurus/ooxml 0.41.0 → 0.43.0

package/dist/types/docx.d.ts

@@ -99,6 +99,9 @@ export declare interface DocParagraph {
     styleId?: string | null;
     /** Default font size (pt) inherited from style + direct pPr/rPr. Falls back to 10pt. */
     defaultFontSize?: number;
+    /** Default font family resolved from the style chain. Used to size empty
+     *  paragraphs (no runs) with the intended font's line metrics. */
+    defaultFontFamily?: string | null;
 }
 
 export declare interface DocRevision {
@@ -141,6 +144,13 @@ declare interface DocTableCell {
     background: string | null;
     vAlign: 'top' | 'center' | 'bottom';
     widthPt: number | null;
+    /** Per-cell margins (pt) from `<w:tcPr><w:tcMar>` (ECMA-376 §17.4.42). Each
+     *  edge overrides the table-level `cellMargin*` default when set; null/absent
+     *  = inherit the table default. */
+    marginTop?: number | null;
+    marginBottom?: number | null;
+    marginLeft?: number | null;
+    marginRight?: number | null;
 }
 
 declare interface DocTableRow {

package/dist/types/index.d.ts

@@ -421,6 +421,18 @@ declare interface ChartElement {
     catAxisFontSizeHpt: number | null;
     /** `<c:valAx><c:txPr>` font size (hpt). null = proportional default. */
     valAxisFontSizeHpt: number | null;
+    /** `<c:catAx><c:txPr>…<a:solidFill>` tick-label color (hex without '#'). */
+    catAxisFontColor?: string | null;
+    /** `<c:valAx><c:txPr>…<a:solidFill>` tick-label color (hex without '#'). */
+    valAxisFontColor?: string | null;
+    /** `<c:catAx><c:spPr><a:ln><a:solidFill>` axis-line color (hex without '#'). */
+    catAxisLineColor?: string | null;
+    /** `<c:catAx><c:spPr><a:ln w>` axis-line width in EMU. */
+    catAxisLineWidthEmu?: number | null;
+    /** `<c:valAx><c:spPr><a:ln><a:solidFill>` axis-line color (hex without '#'). */
+    valAxisLineColor?: string | null;
+    /** `<c:valAx><c:spPr><a:ln w>` axis-line width in EMU. */
+    valAxisLineWidthEmu?: number | null;
     /** `<c:dLbls><c:txPr>` font size (hpt) for data-point value labels. */
     dataLabelFontSizeHpt: number | null;
     /** `<c:legend><c:legendPos val>` — "r" (default) | "l" | "t" | "b" | "tr". */
@@ -496,6 +508,14 @@ declare interface ChartSeries {
      * fall back to the chart-level `dataLabelFontColor`.
      */
     dataLabelColors?: (string | null)[] | null;
+    /**
+     * Series-level data-label text colour (`<c:ser><c:dLbls><c:txPr>…solidFill`,
+     * ECMA-376 §21.2.2.216). Hex without '#'. Stacked-bar charts colour each
+     * segment's label independently (e.g. white on the dark segment, black on
+     * the light one), which a single chart-level `dataLabelFontColor` can't
+     * express. Takes precedence over `dataLabelFontColor`; null = no override.
+     */
+    labelColor?: string | null;
     /**
      * Mixed chart: per-series chart type override. Currently only "line" (XLSX)
      * is honoured; other values are treated as the chart's primary type.
@@ -660,6 +680,9 @@ declare interface DocParagraph {
     styleId?: string | null;
     /** Default font size (pt) inherited from style + direct pPr/rPr. Falls back to 10pt. */
     defaultFontSize?: number;
+    /** Default font family resolved from the style chain. Used to size empty
+     *  paragraphs (no runs) with the intended font's line metrics. */
+    defaultFontFamily?: string | null;
 }
 
 declare interface DocRevision {
@@ -702,6 +725,13 @@ declare interface DocTableCell {
     background: string | null;
     vAlign: 'top' | 'center' | 'bottom';
     widthPt: number | null;
+    /** Per-cell margins (pt) from `<w:tcPr><w:tcMar>` (ECMA-376 §17.4.42). Each
+     *  edge overrides the table-level `cellMargin*` default when set; null/absent
+     *  = inherit the table default. */
+    marginTop?: number | null;
+    marginBottom?: number | null;
+    marginLeft?: number | null;
+    marginRight?: number | null;
 }
 
 declare interface DocTableRow {
@@ -1807,6 +1837,10 @@ declare interface ShapeElement {
     softEdge?: SoftEdge;
     /** Mirrored reflection — ECMA-376 §20.1.8.27. */
     reflection?: Reflection;
+    /** Explicit text frame from a SmartArt drawing's `<dsp:txXfrm>` (absolute EMU,
+     *  same space as x/y/width/height). When present the renderer lays text out in
+     *  this rectangle instead of the preset/ellipse-derived text rectangle. */
+    textRect?: TextRect;
 }
 
 declare type ShapeFill = {
@@ -1964,6 +1998,10 @@ declare interface SheetMeta {
     name: string;
     sheetId: number;
     rId: string;
+    /** Sheet tab color (`<sheetPr><tabColor>`, ECMA-376 §18.3.1.93) resolved to
+     *  `#RRGGBB`. Surfaced at workbook-list time so tabs can be painted up front.
+     *  Absent when the sheet declares no tab color. */
+    tabColor?: string | null;
 }
 
 declare interface SlicerAnchor {
@@ -2228,6 +2266,14 @@ declare interface TextOutline {
     color?: string;
 }
 
+/** Absolute text-frame rectangle in EMU (from SmartArt `<dsp:txXfrm>`). */
+declare interface TextRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+
 declare type TextRun = TextRunData | LineBreak;
 
 declare interface TextRun_2 {
@@ -2499,6 +2545,10 @@ declare interface XlsxChartSeries {
     /** `<c:val>/<c:numRef>/<c:formatCode>` — Excel number format for series
      *  values (ECMA-376 §21.2.2.37). */
     valFormatCode?: string | null;
+    /** `<c:ser><c:dLbls><c:txPr>…solidFill` — per-series data-label text color
+     *  (ECMA-376 §21.2.2.216). Takes precedence over the chart-level color so
+     *  each series can color its labels independently. */
+    labelColor?: string | null;
     /** `<c:ser><c:order>` — stacking/legend display order (§21.2.2.28). */
     order?: number;
     /** `<c:marker><c:symbol val>` — point marker shape (ECMA-376 §21.2.2.32). */
@@ -2534,7 +2584,12 @@ declare class XlsxViewer {
     private tabStrip;
     private navPrev;
     private navNext;
+    private navGroup;
     private tabs;
+    /** Per-tab colors parallel to `tabs`, from `<sheetPr><tabColor>`. */
+    private tabColors;
+    private zoomSlider;
+    private zoomLabel;
     private currentSheet;
     private currentWorksheet;
     private opts;
@@ -2577,6 +2632,18 @@ declare class XlsxViewer {
     private updateNavButtons;
     private updateTabActive;
     private tabStyle;
+    /** Excel-style zoom control pinned to the right end of the tab bar:
+     *  `−  [────slider────]  +  100%`. Live-updates the cell scale on input. */
+    private buildZoomControl;
+    /** Map a slider position [0,100] to a scale factor. 50 → 1.0 (100%), with a
+     *  separate linear segment on each side so the center is always 100%. */
+    private zoomPosToScale;
+    /** Inverse of {@link zoomPosToScale}: scale factor → slider position [0,100]. */
+    private zoomScaleToPos;
+    /** Set the cell/header scale and re-lay-out the current sheet. Clamped to the
+     *  zoom bounds; keeps the slider thumb, percentage label and the row-header-
+     *  aligned tab-nav width in sync. */
+    setScale(scale: number): void;
     private updateSpacerSize;
     private renderCurrentSheet;
     private computeHeaderHighlight;
@@ -2587,6 +2654,14 @@ declare class XlsxViewer {
 declare interface XlsxViewerOptions {
     /** Scale factor for cell/header dimensions (default 1). 0.5 = half size. */
     cellScale?: number;
+    /** 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). */
+    showZoomSlider?: boolean;
+    /** Lower/upper bounds for the zoom slider as scale factors. Default 0.1–4
+     *  (10%–400%, matching Excel's zoom range). */
+    zoomMin?: number;
+    zoomMax?: number;
     onReady?: (sheetNames: string[]) => void;
     onSheetChange?: (index: number, name: string) => void;
     onError?: (err: Error) => void;
@@ -2620,6 +2695,9 @@ declare class XlsxWorkbook {
     load(source: string | ArrayBuffer, opts?: LoadOptions_3): Promise<void>;
     get sheetNames(): string[];
     get sheetCount(): number;
+    /** Per-sheet tab colors (`#RRGGBB`) parallel to {@link sheetNames}.
+     *  `null` for sheets that declare no tab color. */
+    get tabColors(): (string | null)[];
     getWorksheet(sheetIndex: number): Promise<Worksheet>;
     renderViewport(target: HTMLCanvasElement | OffscreenCanvas, sheetIndex: number, viewport: ViewportRange, opts?: RenderViewportOptions): Promise<void>;
     destroy(): void;

package/dist/types/pptx.d.ts

@@ -116,6 +116,18 @@ declare interface ChartElement {
     catAxisFontSizeHpt: number | null;
     /** `<c:valAx><c:txPr>` font size (hpt). null = proportional default. */
     valAxisFontSizeHpt: number | null;
+    /** `<c:catAx><c:txPr>…<a:solidFill>` tick-label color (hex without '#'). */
+    catAxisFontColor?: string | null;
+    /** `<c:valAx><c:txPr>…<a:solidFill>` tick-label color (hex without '#'). */
+    valAxisFontColor?: string | null;
+    /** `<c:catAx><c:spPr><a:ln><a:solidFill>` axis-line color (hex without '#'). */
+    catAxisLineColor?: string | null;
+    /** `<c:catAx><c:spPr><a:ln w>` axis-line width in EMU. */
+    catAxisLineWidthEmu?: number | null;
+    /** `<c:valAx><c:spPr><a:ln><a:solidFill>` axis-line color (hex without '#'). */
+    valAxisLineColor?: string | null;
+    /** `<c:valAx><c:spPr><a:ln w>` axis-line width in EMU. */
+    valAxisLineWidthEmu?: number | null;
     /** `<c:dLbls><c:txPr>` font size (hpt) for data-point value labels. */
     dataLabelFontSizeHpt: number | null;
     /** `<c:legend><c:legendPos val>` — "r" (default) | "l" | "t" | "b" | "tr". */
@@ -191,6 +203,14 @@ declare interface ChartSeries {
      * fall back to the chart-level `dataLabelFontColor`.
      */
     dataLabelColors?: (string | null)[] | null;
+    /**
+     * Series-level data-label text colour (`<c:ser><c:dLbls><c:txPr>…solidFill`,
+     * ECMA-376 §21.2.2.216). Hex without '#'. Stacked-bar charts colour each
+     * segment's label independently (e.g. white on the dark segment, black on
+     * the light one), which a single chart-level `dataLabelFontColor` can't
+     * express. Takes precedence over `dataLabelFontColor`; null = no override.
+     */
+    labelColor?: string | null;
     /**
      * Mixed chart: per-series chart type override. Currently only "line" (XLSX)
      * is honoured; other values are treated as the chart's primary type.
@@ -734,6 +754,10 @@ export declare interface ShapeElement {
     softEdge?: SoftEdge;
     /** Mirrored reflection — ECMA-376 §20.1.8.27. */
     reflection?: Reflection;
+    /** Explicit text frame from a SmartArt drawing's `<dsp:txXfrm>` (absolute EMU,
+     *  same space as x/y/width/height). When present the renderer lays text out in
+     *  this rectangle instead of the preset/ellipse-derived text rectangle. */
+    textRect?: TextRect;
 }
 
 export declare interface Slide {
@@ -875,6 +899,14 @@ declare interface TextOutline {
     color?: string;
 }
 
+/** Absolute text-frame rectangle in EMU (from SmartArt `<dsp:txXfrm>`). */
+declare interface TextRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+
 export declare type TextRun = TextRunData | LineBreak;
 
 export declare type TextRunCallback = (run: TextRunInfo) => void;

package/dist/types/xlsx.d.ts

@@ -703,6 +703,10 @@ export declare interface SheetMeta {
     name: string;
     sheetId: number;
     rId: string;
+    /** Sheet tab color (`<sheetPr><tabColor>`, ECMA-376 §18.3.1.93) resolved to
+     *  `#RRGGBB`. Surfaced at workbook-list time so tabs can be painted up front.
+     *  Absent when the sheet declares no tab color. */
+    tabColor?: string | null;
 }
 
 declare interface SlicerAnchor {
@@ -913,6 +917,10 @@ declare interface XlsxChartSeries {
     /** `<c:val>/<c:numRef>/<c:formatCode>` — Excel number format for series
      *  values (ECMA-376 §21.2.2.37). */
     valFormatCode?: string | null;
+    /** `<c:ser><c:dLbls><c:txPr>…solidFill` — per-series data-label text color
+     *  (ECMA-376 §21.2.2.216). Takes precedence over the chart-level color so
+     *  each series can color its labels independently. */
+    labelColor?: string | null;
     /** `<c:ser><c:order>` — stacking/legend display order (§21.2.2.28). */
     order?: number;
     /** `<c:marker><c:symbol val>` — point marker shape (ECMA-376 §21.2.2.32). */
@@ -948,7 +956,12 @@ export declare class XlsxViewer {
     private tabStrip;
     private navPrev;
     private navNext;
+    private navGroup;
     private tabs;
+    /** Per-tab colors parallel to `tabs`, from `<sheetPr><tabColor>`. */
+    private tabColors;
+    private zoomSlider;
+    private zoomLabel;
     private currentSheet;
     private currentWorksheet;
     private opts;
@@ -991,6 +1004,18 @@ export declare class XlsxViewer {
     private updateNavButtons;
     private updateTabActive;
     private tabStyle;
+    /** Excel-style zoom control pinned to the right end of the tab bar:
+     *  `−  [────slider────]  +  100%`. Live-updates the cell scale on input. */
+    private buildZoomControl;
+    /** Map a slider position [0,100] to a scale factor. 50 → 1.0 (100%), with a
+     *  separate linear segment on each side so the center is always 100%. */
+    private zoomPosToScale;
+    /** Inverse of {@link zoomPosToScale}: scale factor → slider position [0,100]. */
+    private zoomScaleToPos;
+    /** Set the cell/header scale and re-lay-out the current sheet. Clamped to the
+     *  zoom bounds; keeps the slider thumb, percentage label and the row-header-
+     *  aligned tab-nav width in sync. */
+    setScale(scale: number): void;
     private updateSpacerSize;
     private renderCurrentSheet;
     private computeHeaderHighlight;
@@ -1001,6 +1026,14 @@ export declare class XlsxViewer {
 export declare interface XlsxViewerOptions {
     /** Scale factor for cell/header dimensions (default 1). 0.5 = half size. */
     cellScale?: number;
+    /** 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). */
+    showZoomSlider?: boolean;
+    /** Lower/upper bounds for the zoom slider as scale factors. Default 0.1–4
+     *  (10%–400%, matching Excel's zoom range). */
+    zoomMin?: number;
+    zoomMax?: number;
     onReady?: (sheetNames: string[]) => void;
     onSheetChange?: (index: number, name: string) => void;
     onError?: (err: Error) => void;
@@ -1034,6 +1067,9 @@ export declare class XlsxWorkbook {
     load(source: string | ArrayBuffer, opts?: LoadOptions): Promise<void>;
     get sheetNames(): string[];
     get sheetCount(): number;
+    /** Per-sheet tab colors (`#RRGGBB`) parallel to {@link sheetNames}.
+     *  `null` for sheets that declare no tab color. */
+    get tabColors(): (string | null)[];
     getWorksheet(sheetIndex: number): Promise<Worksheet>;
     renderViewport(target: HTMLCanvasElement | OffscreenCanvas, sheetIndex: number, viewport: ViewportRange, opts?: RenderViewportOptions): Promise<void>;
     destroy(): void;