@silurus/ooxml 0.42.0 → 0.44.0

package/dist/types/docx.d.ts

@@ -124,7 +124,12 @@ export declare type DocRun = {
     type: 'field';
 } & FieldRun | {
     type: 'shape';
-} & ShapeRun;
+} & ShapeRun | {
+    type: 'math';
+    nodes: MathNode[];
+    display: boolean;
+    fontSize: number;
+};
 
 declare interface DocTable {
     colWidths: number[];
@@ -134,6 +139,8 @@ declare interface DocTable {
     cellMarginBottom: number;
     cellMarginLeft: number;
     cellMarginRight: number;
+    /** table horizontal alignment on the page: 'left' | 'center' | 'right'. */
+    jc: string;
 }
 
 declare interface DocTableCell {
@@ -379,6 +386,109 @@ declare interface LoadOptions_2 {
     useGoogleFonts?: boolean;
 }
 
+/** Accent (`m:acc`), e.g. hat, bar, vector arrow over the base. */
+declare interface MathAccent {
+    kind: 'accent';
+    char: string;
+    base: MathNode[];
+}
+
+/** Matrix (`m:m`) or aligned equation array (`m:eqArr`). rows → cells → nodes. */
+declare interface MathArray {
+    kind: 'array';
+    rows: MathNode[][][];
+    /** 'eq' = alternating right/left (eqArr); 'center' = matrix; 'left'. */
+    align: 'eq' | 'center' | 'left';
+}
+
+/** Over/under bar (`m:bar`). */
+declare interface MathBar {
+    kind: 'bar';
+    pos: 'top' | 'bot';
+    base: MathNode[];
+}
+
+declare interface MathDelimiter {
+    kind: 'delimiter';
+    /** opening char (default '('). */
+    begChar: string;
+    /** closing char (default ')'). */
+    endChar: string;
+    /** separated groups (e.g. for cases / multiple args). */
+    items: MathNode[][];
+}
+
+declare interface MathFraction {
+    kind: 'fraction';
+    num: MathNode[];
+    den: MathNode[];
+    /** false = no rule (e.g. binomial); defaults to true. */
+    bar?: boolean;
+}
+
+declare interface MathFunc {
+    kind: 'func';
+    name: MathNode[];
+    arg: MathNode[];
+}
+
+declare interface MathGroup {
+    kind: 'group';
+    items: MathNode[];
+}
+
+/** Group character (`m:groupChr`), e.g. under/over brace. */
+declare interface MathGroupChr {
+    kind: 'groupChr';
+    char: string;
+    pos: 'top' | 'bot';
+    base: MathNode[];
+}
+
+/** Lower/upper limit (`m:limLow` / `m:limUpp`), e.g. lim under n→∞. */
+declare interface MathLimit {
+    kind: 'limit';
+    base: MathNode[];
+    lower?: MathNode[];
+    upper?: MathNode[];
+}
+
+declare interface MathNary {
+    kind: 'nary';
+    /** operator char, e.g. '∑', '∫', '∏'. */
+    op: string;
+    /** limit location (`m:limLoc`): 'subSup' = beside the op, 'undOvr' = above/below.
+     *  Empty/omitted = default by operator class (integrals → subSup, others → undOvr). */
+    limLoc?: string;
+    sub?: MathNode[];
+    sup?: MathNode[];
+    body: MathNode[];
+}
+
+declare type MathNode = MathRun | MathFraction | MathScript | MathNary | MathDelimiter | MathRadical | MathLimit | MathArray | MathGroupChr | MathBar | MathAccent | MathFunc | MathGroup;
+
+declare interface MathRadical {
+    kind: 'radical';
+    /** optional index (e.g. cube root); empty/omitted = square root. */
+    index?: MathNode[];
+    radicand: MathNode[];
+}
+
+declare interface MathRun {
+    kind: 'run';
+    text: string;
+    style: MathStyle;
+}
+
+declare interface MathScript {
+    kind: 'sup' | 'sub' | 'subSup';
+    base: MathNode[];
+    sup?: MathNode[];
+    sub?: MathNode[];
+}
+
+declare type MathStyle = 'roman' | 'italic' | 'bold' | 'boldItalic';
+
 declare interface NumberingInfo {
     numId: number;
     level: number;

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". */
@@ -693,7 +705,12 @@ declare type DocRun = {
     type: 'field';
 } & FieldRun | {
     type: 'shape';
-} & ShapeRun;
+} & ShapeRun | {
+    type: 'math';
+    nodes: MathNode[];
+    display: boolean;
+    fontSize: number;
+};
 
 declare interface DocTable {
     colWidths: number[];
@@ -703,6 +720,8 @@ declare interface DocTable {
     cellMarginBottom: number;
     cellMarginLeft: number;
     cellMarginRight: number;
+    /** table horizontal alignment on the page: 'left' | 'center' | 'right'. */
+    jc: string;
 }
 
 declare interface DocTableCell {
@@ -1138,6 +1157,109 @@ declare interface ManualLayout {
     h?: number;
 }
 
+/** Accent (`m:acc`), e.g. hat, bar, vector arrow over the base. */
+declare interface MathAccent {
+    kind: 'accent';
+    char: string;
+    base: MathNode[];
+}
+
+/** Matrix (`m:m`) or aligned equation array (`m:eqArr`). rows → cells → nodes. */
+declare interface MathArray {
+    kind: 'array';
+    rows: MathNode[][][];
+    /** 'eq' = alternating right/left (eqArr); 'center' = matrix; 'left'. */
+    align: 'eq' | 'center' | 'left';
+}
+
+/** Over/under bar (`m:bar`). */
+declare interface MathBar {
+    kind: 'bar';
+    pos: 'top' | 'bot';
+    base: MathNode[];
+}
+
+declare interface MathDelimiter {
+    kind: 'delimiter';
+    /** opening char (default '('). */
+    begChar: string;
+    /** closing char (default ')'). */
+    endChar: string;
+    /** separated groups (e.g. for cases / multiple args). */
+    items: MathNode[][];
+}
+
+declare interface MathFraction {
+    kind: 'fraction';
+    num: MathNode[];
+    den: MathNode[];
+    /** false = no rule (e.g. binomial); defaults to true. */
+    bar?: boolean;
+}
+
+declare interface MathFunc {
+    kind: 'func';
+    name: MathNode[];
+    arg: MathNode[];
+}
+
+declare interface MathGroup {
+    kind: 'group';
+    items: MathNode[];
+}
+
+/** Group character (`m:groupChr`), e.g. under/over brace. */
+declare interface MathGroupChr {
+    kind: 'groupChr';
+    char: string;
+    pos: 'top' | 'bot';
+    base: MathNode[];
+}
+
+/** Lower/upper limit (`m:limLow` / `m:limUpp`), e.g. lim under n→∞. */
+declare interface MathLimit {
+    kind: 'limit';
+    base: MathNode[];
+    lower?: MathNode[];
+    upper?: MathNode[];
+}
+
+declare interface MathNary {
+    kind: 'nary';
+    /** operator char, e.g. '∑', '∫', '∏'. */
+    op: string;
+    /** limit location (`m:limLoc`): 'subSup' = beside the op, 'undOvr' = above/below.
+     *  Empty/omitted = default by operator class (integrals → subSup, others → undOvr). */
+    limLoc?: string;
+    sub?: MathNode[];
+    sup?: MathNode[];
+    body: MathNode[];
+}
+
+declare type MathNode = MathRun | MathFraction | MathScript | MathNary | MathDelimiter | MathRadical | MathLimit | MathArray | MathGroupChr | MathBar | MathAccent | MathFunc | MathGroup;
+
+declare interface MathRadical {
+    kind: 'radical';
+    /** optional index (e.g. cube root); empty/omitted = square root. */
+    index?: MathNode[];
+    radicand: MathNode[];
+}
+
+declare interface MathRun {
+    kind: 'run';
+    text: string;
+    style: MathStyle;
+}
+
+declare interface MathScript {
+    kind: 'sup' | 'sub' | 'subSup';
+    base: MathNode[];
+    sup?: MathNode[];
+    sub?: MathNode[];
+}
+
+declare type MathStyle = 'roman' | 'italic' | 'bold' | 'boldItalic';
+
 declare interface MediaElement {
     type: 'media';
     x: number;
@@ -1986,6 +2108,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 {
@@ -2568,7 +2694,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;
@@ -2611,6 +2742,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;
@@ -2621,6 +2764,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;
@@ -2654,6 +2805,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". */

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 {
@@ -952,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;
@@ -995,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;
@@ -1005,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;
@@ -1038,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;