@silurus/ooxml 0.40.0 → 0.42.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

@@ -496,6 +496,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 +668,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 +713,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 +1825,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 = {
@@ -2200,6 +2222,17 @@ declare interface TextBody {
     vert: string;
     /** Auto-fit: "sp" = shape grows to fit text, "norm" = font shrinks, "none" = no fit */
     autoFit: string;
+    /**
+     * `<a:normAutofit fontScale>` (ECMA-376 §21.1.2.1.3) — PowerPoint's stored,
+     * pre-computed font-shrink ratio for `autoFit === "norm"`, as a fraction
+     * (e.g. 0.625 for `fontScale="62500"`). Null/absent when PowerPoint stored no
+     * scale; the renderer then re-derives one. Applying the stored value matches
+     * PowerPoint exactly instead of guessing from our own text metrics.
+     */
+    fontScale?: number | null;
+    /** `<a:normAutofit lnSpcReduction>` — stored line-spacing reduction fraction
+     *  (e.g. 0.20 for `lnSpcReduction="20000"`). Null/absent when not stored. */
+    lnSpcReduction?: number | null;
     /**
      * `<a:bodyPr numCol>` (ECMA-376 §20.1.10.34) — number of text columns inside
      * the shape. Defaults to 1; values > 1 cause the renderer to flow paragraphs
@@ -2217,6 +2250,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 {
@@ -2488,6 +2529,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). */

package/dist/types/pptx.d.ts

@@ -191,6 +191,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 +742,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 {
@@ -847,6 +859,17 @@ export declare interface TextBody {
     vert: string;
     /** Auto-fit: "sp" = shape grows to fit text, "norm" = font shrinks, "none" = no fit */
     autoFit: string;
+    /**
+     * `<a:normAutofit fontScale>` (ECMA-376 §21.1.2.1.3) — PowerPoint's stored,
+     * pre-computed font-shrink ratio for `autoFit === "norm"`, as a fraction
+     * (e.g. 0.625 for `fontScale="62500"`). Null/absent when PowerPoint stored no
+     * scale; the renderer then re-derives one. Applying the stored value matches
+     * PowerPoint exactly instead of guessing from our own text metrics.
+     */
+    fontScale?: number | null;
+    /** `<a:normAutofit lnSpcReduction>` — stored line-spacing reduction fraction
+     *  (e.g. 0.20 for `lnSpcReduction="20000"`). Null/absent when not stored. */
+    lnSpcReduction?: number | null;
     /**
      * `<a:bodyPr numCol>` (ECMA-376 §20.1.10.34) — number of text columns inside
      * the shape. Defaults to 1; values > 1 cause the renderer to flow paragraphs
@@ -864,6 +887,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

@@ -913,6 +913,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). */