@silurus/ooxml 0.11.0 → 0.12.0

package/dist/types/index.d.ts

@@ -252,6 +252,36 @@ declare interface ChartData {
     catAxisFontSizeHpt?: number | null;
     /** Value axis tick-label font size in hpt. */
     valAxisFontSizeHpt?: number | null;
+    /** Outer chartSpace background (ECMA-376 §21.2.2.5 `<c:spPr>`). Hex without
+     *  '#' for a solid fill, undefined for `<a:noFill/>` or an absent spPr.
+     *  Combine with `hasChartSpPr` to distinguish explicit-transparent from
+     *  default-opaque-white. */
+    chartBg?: string | null;
+    /** True when the parser saw a `<c:chartSpace><c:spPr>` element. Lets the
+     *  adapter tell "spec said noFill → transparent" from "no spPr → default". */
+    hasChartSpPr?: boolean;
+    /** `<c:legend><c:manualLayout>` fractions of chart space (§21.2.2.31). */
+    legendManualLayout?: LegendManualLayout | null;
+    /** `<c:catAx><c:delete val="1"/>` — hide the category axis (§21.2.2.40). */
+    catAxisHidden?: boolean;
+    /** `<c:valAx><c:delete val="1"/>` — hide the value axis (§21.2.2.40). */
+    valAxisHidden?: boolean;
+    /** `<c:valAx><c:numFmt@formatCode>` — number format for value-axis tick
+     *  labels (ECMA-376 §21.2.2.21). */
+    valAxisFormatCode?: string | null;
+    /** `<c:barChart><c:gapWidth>` — space between category groups as a percent
+     *  of bar width (§21.2.2.13). */
+    barGapWidth?: number | null;
+    /** `<c:barChart><c:overlap>` — signed percent overlap between bars in a
+     *  cluster (§21.2.2.25). Negative = gap. */
+    barOverlap?: number | null;
+    /** `<c:dLbls><c:dLblPos>` — data label position (§21.2.2.16). */
+    dataLabelPosition?: string | null;
+    /** Hex (no `#`) for data label text color, resolved from `<c:dLbls><c:txPr>`. */
+    dataLabelFontColor?: string | null;
+    /** `<c:dLbls><c:numFmt@formatCode>` — chart-level override for data label
+     *  number format (§21.2.2.35). */
+    dataLabelFormatCode?: string | null;
 }
 
 /**
@@ -329,6 +359,12 @@ declare interface ChartSeries {
      * that don't parse markers (e.g. pptx today) keep their existing behavior.
      */
     showMarker?: boolean | null;
+    /**
+     * Excel number-format code for this series' values (ECMA-376 §21.2.2.37,
+     * `<c:val>/<c:numRef>/<c:formatCode>`). Used to format data labels when the
+     * chart-level `<c:dLbls><c:numFmt>` is not set. null = no series-level code.
+     */
+    valFormatCode?: string | null;
 }
 
 declare interface ConditionalFormat {
@@ -476,6 +512,11 @@ declare interface Dxf {
     font: Font | null;
     fill: Fill_2 | null;
     border: Border | null;
+    /** Number format override from the dxf (ECMA-376 §18.8.17). When a
+     *  conditional-formatting rule matches, this numFmt replaces the cell's own
+     *  style numFmt for rendering — e.g. switching a calendar cell from `d` to
+     *  `m"月"d"日"` on the first day of each month. */
+    numFmt?: NumFmt | null;
 }
 
 declare interface FieldRun {
@@ -632,6 +673,15 @@ declare interface ImageRun {
     wrapSide?: string;
 }
 
+declare interface LegendManualLayout {
+    xMode: string;
+    yMode: string;
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+
 declare interface LineBreak {
     type: 'break';
 }
@@ -778,6 +828,41 @@ declare type PathCmd = {
 };
 
 declare type PathCmd_2 = {
+    op: 'moveTo';
+    x: number;
+    y: number;
+} | {
+    op: 'lineTo';
+    x: number;
+    y: number;
+} | {
+    op: 'cubicBezTo';
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+    x3: number;
+    y3: number;
+} | {
+    op: 'quadBezTo';
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+}
+/** ECMA-376 §20.1.9.3. stAng/swAng in 60000ths of a degree. wr/hr in
+*  the path's own coordinate units. Pen position is the arc start. */
+| {
+    op: 'arcTo';
+    wr: number;
+    hr: number;
+    stAng: number;
+    swAng: number;
+} | {
+    op: 'close';
+};
+
+declare type PathCmd_3 = {
     cmd: 'moveTo';
     x: number;
     y: number;
@@ -803,6 +888,12 @@ declare type PathCmd_2 = {
     cmd: 'close';
 };
 
+declare interface PathInfo {
+    w: number;
+    h: number;
+    commands: PathCmd_2[];
+}
+
 declare interface PictureElement {
     type: 'picture';
     x: number;
@@ -1093,6 +1184,18 @@ declare interface Shadow {
     dir: number;
 }
 
+declare interface ShapeAnchor {
+    fromCol: number;
+    fromColOff: number;
+    fromRow: number;
+    fromRowOff: number;
+    toCol: number;
+    toColOff: number;
+    toRow: number;
+    toRowOff: number;
+    shapes: ShapeInfo[];
+}
+
 declare interface ShapeElement {
     type: 'shape';
     x: number;
@@ -1142,6 +1245,36 @@ declare type ShapeFill = {
     gradType: string;
 };
 
+declare type ShapeGeom = {
+    type: 'preset';
+    name: string;
+} | {
+    type: 'custom';
+    paths: PathInfo[];
+}
+/** Bitmap picture leaf inside a `<xdr:grpSp>`. `dataUrl` is a pre-encoded
+*  `data:<mime>;base64,…` produced by the Rust parser from the drawing's
+*  relationship target. */
+| {
+    type: 'image';
+    dataUrl: string;
+};
+
+declare interface ShapeInfo {
+    /** Normalized [0,1] position/size relative to the anchor rect. */
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    /** Rotation in degrees, clockwise. */
+    rot: number;
+    fillColor?: string;
+    strokeColor?: string;
+    /** Stroke width in EMU. 0 = no stroke. */
+    strokeWidth: number;
+    geom: ShapeGeom;
+}
+
 declare interface ShapeRun {
     widthPt: number;
     heightPt: number;
@@ -1156,7 +1289,7 @@ declare interface ShapeRun {
     /** Document-order index within a group; lower values render first. */
     zOrder: number;
     /** Normalized [0,1] custom-geometry sub-paths */
-    subpaths: PathCmd_2[][];
+    subpaths: PathCmd_3[][];
     fill: ShapeFill | null;
     stroke: string | null;
     strokeWidth?: number;
@@ -1175,6 +1308,24 @@ declare interface SheetMeta {
     rId: string;
 }
 
+declare interface SlicerAnchor {
+    fromCol: number;
+    fromColOff: number;
+    fromRow: number;
+    fromRowOff: number;
+    toCol: number;
+    toColOff: number;
+    toRow: number;
+    toRowOff: number;
+    caption: string;
+    items: SlicerItem[];
+}
+
+declare interface SlicerItem {
+    name: string;
+    selected: boolean;
+}
+
 declare interface Slide {
     index: number;
     /** 1-based slide number (index + 1); used to render slidenum fields */
@@ -1390,6 +1541,10 @@ declare interface Worksheet {
     conditionalFormats: ConditionalFormat[];
     images: ImageAnchor[];
     charts: ChartAnchor[];
+    /** Grouped shapes from `<xdr:grpSp>` inside twoCellAnchors
+     *  (ECMA-376 §20.5.2.17). Each anchor holds leaf shapes pre-flattened
+     *  with normalized [0,1] geometry relative to the anchor rect. */
+    shapeGroups?: ShapeAnchor[];
     /** Whether to display zero values (ECMA-376 §18.3.1.94). Defaults to true. */
     showZeros?: boolean;
     /** Whether to draw default grid lines (ECMA-376 §18.3.1.83
@@ -1412,6 +1567,10 @@ declare interface Worksheet {
     /** Excel Tables on this sheet (ECMA-376 §18.5). The renderer overlays a
      *  built-in style (bold header, banded rows) on the given ranges. */
     tables?: TableInfo[];
+    /** Pivot / table slicers (Office 2010+ extension). Each anchor carries a
+     *  caption and the saved item list (with selection flags) so the renderer
+     *  can draw a static button bank without the live pivot engine. */
+    slicers?: SlicerAnchor[];
 }
 
 export declare namespace xlsx {
@@ -1456,6 +1615,11 @@ declare interface XlsxChartSeries {
     /** Marker visibility resolved from `<c:marker>`/chart-level default
      *  (ECMA-376 §21.2.2.32). */
     showMarker?: boolean;
+    /** `<c:val>/<c:numRef>/<c:formatCode>` — Excel number format for series
+     *  values (ECMA-376 §21.2.2.37). */
+    valFormatCode?: string | null;
+    /** `<c:ser><c:order>` — stacking/legend display order (§21.2.2.28). */
+    order?: number;
 }
 
 declare class XlsxViewer {

package/dist/types/pptx.d.ts

@@ -123,6 +123,12 @@ declare interface ChartSeries {
      * that don't parse markers (e.g. pptx today) keep their existing behavior.
      */
     showMarker?: boolean | null;
+    /**
+     * Excel number-format code for this series' values (ECMA-376 §21.2.2.37,
+     * `<c:val>/<c:numRef>/<c:formatCode>`). Used to format data labels when the
+     * chart-level `<c:dLbls><c:numFmt>` is not set. null = no series-level code.
+     */
+    valFormatCode?: string | null;
 }
 
 export declare type Fill = SolidFill | NoFill | GradientFill;

package/dist/types/xlsx.d.ts

@@ -206,6 +206,36 @@ declare interface ChartData {
     catAxisFontSizeHpt?: number | null;
     /** Value axis tick-label font size in hpt. */
     valAxisFontSizeHpt?: number | null;
+    /** Outer chartSpace background (ECMA-376 §21.2.2.5 `<c:spPr>`). Hex without
+     *  '#' for a solid fill, undefined for `<a:noFill/>` or an absent spPr.
+     *  Combine with `hasChartSpPr` to distinguish explicit-transparent from
+     *  default-opaque-white. */
+    chartBg?: string | null;
+    /** True when the parser saw a `<c:chartSpace><c:spPr>` element. Lets the
+     *  adapter tell "spec said noFill → transparent" from "no spPr → default". */
+    hasChartSpPr?: boolean;
+    /** `<c:legend><c:manualLayout>` fractions of chart space (§21.2.2.31). */
+    legendManualLayout?: LegendManualLayout | null;
+    /** `<c:catAx><c:delete val="1"/>` — hide the category axis (§21.2.2.40). */
+    catAxisHidden?: boolean;
+    /** `<c:valAx><c:delete val="1"/>` — hide the value axis (§21.2.2.40). */
+    valAxisHidden?: boolean;
+    /** `<c:valAx><c:numFmt@formatCode>` — number format for value-axis tick
+     *  labels (ECMA-376 §21.2.2.21). */
+    valAxisFormatCode?: string | null;
+    /** `<c:barChart><c:gapWidth>` — space between category groups as a percent
+     *  of bar width (§21.2.2.13). */
+    barGapWidth?: number | null;
+    /** `<c:barChart><c:overlap>` — signed percent overlap between bars in a
+     *  cluster (§21.2.2.25). Negative = gap. */
+    barOverlap?: number | null;
+    /** `<c:dLbls><c:dLblPos>` — data label position (§21.2.2.16). */
+    dataLabelPosition?: string | null;
+    /** Hex (no `#`) for data label text color, resolved from `<c:dLbls><c:txPr>`. */
+    dataLabelFontColor?: string | null;
+    /** `<c:dLbls><c:numFmt@formatCode>` — chart-level override for data label
+     *  number format (§21.2.2.35). */
+    dataLabelFormatCode?: string | null;
 }
 
 declare interface ConditionalFormat {
@@ -222,6 +252,11 @@ declare interface Dxf {
     font: Font | null;
     fill: Fill | null;
     border: Border | null;
+    /** Number format override from the dxf (ECMA-376 §18.8.17). When a
+     *  conditional-formatting rule matches, this numFmt replaces the cell's own
+     *  style numFmt for rendering — e.g. switching a calendar cell from `d` to
+     *  `m"月"d"日"` on the first day of each month. */
+    numFmt?: NumFmt | null;
 }
 
 export declare interface Fill {
@@ -281,6 +316,15 @@ declare interface ImageAnchor {
     dataUrl: string;
 }
 
+declare interface LegendManualLayout {
+    xMode: string;
+    yMode: string;
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+
 export declare interface MergeCell {
     top: number;
     left: number;
@@ -299,6 +343,47 @@ export declare interface ParsedWorkbook {
     sharedStrings: SharedString[];
 }
 
+declare type PathCmd = {
+    op: 'moveTo';
+    x: number;
+    y: number;
+} | {
+    op: 'lineTo';
+    x: number;
+    y: number;
+} | {
+    op: 'cubicBezTo';
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+    x3: number;
+    y3: number;
+} | {
+    op: 'quadBezTo';
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+}
+/** ECMA-376 §20.1.9.3. stAng/swAng in 60000ths of a degree. wr/hr in
+*  the path's own coordinate units. Pen position is the arc start. */
+| {
+    op: 'arcTo';
+    wr: number;
+    hr: number;
+    stAng: number;
+    swAng: number;
+} | {
+    op: 'close';
+};
+
+declare interface PathInfo {
+    w: number;
+    h: number;
+    commands: PathCmd[];
+}
+
 export declare interface RenderViewportOptions {
     width?: number;
     height?: number;
@@ -336,6 +421,48 @@ declare interface RunFont {
     name?: string | null;
 }
 
+declare interface ShapeAnchor {
+    fromCol: number;
+    fromColOff: number;
+    fromRow: number;
+    fromRowOff: number;
+    toCol: number;
+    toColOff: number;
+    toRow: number;
+    toRowOff: number;
+    shapes: ShapeInfo[];
+}
+
+declare type ShapeGeom = {
+    type: 'preset';
+    name: string;
+} | {
+    type: 'custom';
+    paths: PathInfo[];
+}
+/** Bitmap picture leaf inside a `<xdr:grpSp>`. `dataUrl` is a pre-encoded
+*  `data:<mime>;base64,…` produced by the Rust parser from the drawing's
+*  relationship target. */
+| {
+    type: 'image';
+    dataUrl: string;
+};
+
+declare interface ShapeInfo {
+    /** Normalized [0,1] position/size relative to the anchor rect. */
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    /** Rotation in degrees, clockwise. */
+    rot: number;
+    fillColor?: string;
+    strokeColor?: string;
+    /** Stroke width in EMU. 0 = no stroke. */
+    strokeWidth: number;
+    geom: ShapeGeom;
+}
+
 declare interface SharedString {
     text: string;
     runs?: Run[];
@@ -347,6 +474,24 @@ export declare interface SheetMeta {
     rId: string;
 }
 
+declare interface SlicerAnchor {
+    fromCol: number;
+    fromColOff: number;
+    fromRow: number;
+    fromRowOff: number;
+    toCol: number;
+    toColOff: number;
+    toRow: number;
+    toRowOff: number;
+    caption: string;
+    items: SlicerItem[];
+}
+
+declare interface SlicerItem {
+    name: string;
+    selected: boolean;
+}
+
 export declare interface Styles {
     fonts: Font[];
     fills: Fill[];
@@ -401,6 +546,10 @@ export declare interface Worksheet {
     conditionalFormats: ConditionalFormat[];
     images: ImageAnchor[];
     charts: ChartAnchor[];
+    /** Grouped shapes from `<xdr:grpSp>` inside twoCellAnchors
+     *  (ECMA-376 §20.5.2.17). Each anchor holds leaf shapes pre-flattened
+     *  with normalized [0,1] geometry relative to the anchor rect. */
+    shapeGroups?: ShapeAnchor[];
     /** Whether to display zero values (ECMA-376 §18.3.1.94). Defaults to true. */
     showZeros?: boolean;
     /** Whether to draw default grid lines (ECMA-376 §18.3.1.83
@@ -423,6 +572,10 @@ export declare interface Worksheet {
     /** Excel Tables on this sheet (ECMA-376 §18.5). The renderer overlays a
      *  built-in style (bold header, banded rows) on the given ranges. */
     tables?: TableInfo[];
+    /** Pivot / table slicers (Office 2010+ extension). Each anchor carries a
+     *  caption and the saved item list (with selection flags) so the renderer
+     *  can draw a static button bank without the live pivot engine. */
+    slicers?: SlicerAnchor[];
 }
 
 /**
@@ -440,6 +593,11 @@ declare interface XlsxChartSeries {
     /** Marker visibility resolved from `<c:marker>`/chart-level default
      *  (ECMA-376 §21.2.2.32). */
     showMarker?: boolean;
+    /** `<c:val>/<c:numRef>/<c:formatCode>` — Excel number format for series
+     *  values (ECMA-376 §21.2.2.37). */
+    valFormatCode?: string | null;
+    /** `<c:ser><c:order>` — stacking/legend display order (§21.2.2.28). */
+    order?: number;
 }
 
 export declare class XlsxViewer {