@silurus/ooxml 0.61.0 → 0.63.0

package/dist/types/docx.d.ts

@@ -769,6 +769,9 @@ export declare interface NumberingInfo {
     text: string;
     indentLeft: number;
     tab: number;
+    /** ECMA-376 §17.9.28 `<w:suff>` — "tab" (default) | "space" | "nothing".
+     *  Where body text starts after the marker on the first line. */
+    suff: string;
 }
 
 export declare interface ParaBorderEdge {

package/dist/types/index.d.ts

@@ -312,6 +312,19 @@ declare interface ChartData {
     catAxisTitle?: string | null;
     /** Value axis title (c:valAx/c:title). */
     valAxisTitle?: string | null;
+    /** `<c:catAx><c:title>` run-prop font size (hpt), from the parser's
+     *  catAxisTitleSize. Distinct from `catAxisFontSizeHpt` (tick labels). */
+    catAxisTitleSize?: number | null;
+    /** `<c:catAx><c:title>` run-prop bold flag. */
+    catAxisTitleBold?: boolean | null;
+    /** `<c:catAx><c:title>` run-prop color (hex without '#'). */
+    catAxisTitleColor?: string | null;
+    /** `<c:valAx><c:title>` run-prop font size (hpt). */
+    valAxisTitleSize?: number | null;
+    /** `<c:valAx><c:title>` run-prop bold flag. */
+    valAxisTitleBold?: boolean | null;
+    /** `<c:valAx><c:title>` run-prop color (hex without '#'). */
+    valAxisTitleColor?: string | null;
     /** True when <c:legend> is present. Absence means the legend is hidden. */
     showLegend?: boolean;
     /** `<c:legendPos val>` — "r"|"l"|"t"|"b"|"tr". null/undefined = default ("r"). */
@@ -384,6 +397,12 @@ declare interface ChartData {
     catAxisLineWidthEmu?: number;
     valAxisLineColor?: string;
     valAxisLineWidthEmu?: number;
+    /** Explicit chart border color (hex without '#') from
+     *  `<c:chartSpace><c:spPr><a:ln><a:solidFill><a:srgbClr>`. Only set when the
+     *  XML explicitly declares a paintable line (no default border). */
+    chartBorderColor?: string | null;
+    /** `<c:chartSpace><c:spPr><a:ln@w>` border width in EMU. */
+    chartBorderWidthEmu?: number | null;
     /** `<c:catAx | valAx><c:majorTickMark val>` / `<c:minorTickMark val>` —
      *  one of `none`/`out`/`in`/`cross` (ECMA-376 §21.2.2.49). */
     catAxisMajorTickMark?: string;
@@ -510,6 +529,38 @@ declare interface ChartElement {
     scatterStyle?: string | null;
     /** `<c:radarChart><c:radarStyle val>` (ECMA-376 §21.2.3.10). */
     radarStyle?: string | null;
+    /** `<c:catAx><c:title>` plain text (ECMA-376 §21.2.2.6). For scatter the
+     * bottom `<c:valAx>` (axPos b/t) feeds this. null = no title. */
+    catAxisTitle?: string | null;
+    /** `<c:valAx><c:title>` plain text. For scatter the left `<c:valAx>`
+     * (axPos l/r) feeds this. null = no title. */
+    valAxisTitle?: string | null;
+    /** `<c:catAx><c:title>` run-prop font size (hpt). Distinct from
+     * `catAxisFontSizeHpt` (tick labels). null = renderer default. */
+    catAxisTitleSize?: number | null;
+    /** `<c:catAx><c:title>` run-prop bold flag. null = not bold. */
+    catAxisTitleBold?: boolean | null;
+    /** `<c:catAx><c:title>` run-prop color (hex without '#'). null = default. */
+    catAxisTitleColor?: string | null;
+    /** `<c:valAx><c:title>` run-prop font size (hpt). null = renderer default. */
+    valAxisTitleSize?: number | null;
+    /** `<c:valAx><c:title>` run-prop bold flag. null = not bold. */
+    valAxisTitleBold?: boolean | null;
+    /** `<c:valAx><c:title>` run-prop color (hex without '#'). null = default. */
+    valAxisTitleColor?: string | null;
+    /** `<c:title>...defRPr@b` chart title bold flag. null = not bold. */
+    titleFontBold?: boolean | null;
+    /** `<c:catAx><c:txPr>...defRPr@b` X-axis tick-label bold flag. null = not bold. */
+    catAxisFontBold?: boolean | null;
+    /** `<c:valAx><c:txPr>...defRPr@b` Y-axis tick-label bold flag. null = not bold. */
+    valAxisFontBold?: boolean | null;
+    /** Explicit chart border color (hex without '#') from
+     * `<c:chartSpace><c:spPr><a:ln><a:solidFill><a:srgbClr>`. Only set when the
+     * XML explicitly declares a paintable line; null otherwise (no default border). */
+    chartBorderColor?: string | null;
+    /** `<c:chartSpace><c:spPr><a:ln@w>` border width in EMU. null = 1px hairline
+     * when a color is present. */
+    chartBorderWidthEmu?: number | null;
 }
 
 declare interface ChartErrBars {
@@ -644,6 +695,27 @@ declare interface ChartModel {
     catAxisFontBold?: boolean | null;
     /** `<c:valAx><c:txPr>...defRPr@b>` Y-axis tick label bold flag. */
     valAxisFontBold?: boolean | null;
+    /** `<c:catAx><c:title>` run-prop font size (hpt). Distinct from
+     *  `catAxisFontSizeHpt` (tick labels). null = renderer default. */
+    catAxisTitleFontSizeHpt?: number | null;
+    /** `<c:catAx><c:title>` run-prop bold flag. null = not bold. */
+    catAxisTitleFontBold?: boolean | null;
+    /** `<c:catAx><c:title>` run-prop color (hex without '#'). null = default. */
+    catAxisTitleFontColor?: string | null;
+    /** `<c:valAx><c:title>` run-prop font size (hpt). null = renderer default. */
+    valAxisTitleFontSizeHpt?: number | null;
+    /** `<c:valAx><c:title>` run-prop bold flag. null = not bold. */
+    valAxisTitleFontBold?: boolean | null;
+    /** `<c:valAx><c:title>` run-prop color (hex without '#'). null = default. */
+    valAxisTitleFontColor?: string | null;
+    /** Explicit chart border color (hex without '#') from
+     *  `<c:chartSpace><c:spPr><a:ln><a:solidFill><a:srgbClr>`. Only set when the
+     *  XML explicitly declares a paintable line; null otherwise (no default
+     *  border is drawn). */
+    chartBorderColor?: string | null;
+    /** `<c:chartSpace><c:spPr><a:ln@w>` border width in EMU. null = 1px hairline
+     *  when a color is present. */
+    chartBorderWidthEmu?: number | null;
     /**
      * `<c:catAx><c:crosses val>` (`autoZero` | `min` | `max`). Drives the Y
      * coordinate where the X axis is drawn. Default `autoZero` puts the X
@@ -1896,6 +1968,9 @@ declare interface NumberingInfo {
     text: string;
     indentLeft: number;
     tab: number;
+    /** ECMA-376 §17.9.28 `<w:suff>` — "tab" (default) | "space" | "nothing".
+     *  Where body text starts after the marker on the first line. */
+    suff: string;
 }
 
 declare interface NumFmt {
@@ -1943,6 +2018,23 @@ declare interface Paragraph {
     runs: TextRun[];
 }
 
+/**
+ * PPTX paragraph. Extends the shared core `Paragraph` with the PPTX-only
+ * `eaLnBrk` flag that the pptx parser emits but the shared core model does not
+ * carry (docx/xlsx paragraphs don't surface it). Mirrors the Rust
+ * `Paragraph` struct's `ea_ln_brk` field 1:1.
+ */
+declare interface Paragraph_2 extends Paragraph {
+    /**
+     * `<a:pPr eaLnBrk>` (ECMA-376 §21.1.2.2.7, xsd:boolean, default true). When
+     * true, East Asian text may break at character boundaries (kinsoku rules);
+     * when false, an East Asian word must not be split mid-character. The parser
+     * resolves the paragraph → body/list-style → layout/master cascade and always
+     * emits an effective boolean.
+     */
+    eaLnBrk: boolean;
+}
+
 declare interface ParagraphBorders {
     top: ParaBorderEdge | null;
     bottom: ParaBorderEdge | null;
@@ -2075,6 +2167,16 @@ declare interface PictureElement {
     flipV: boolean;
     /** Data URL, e.g. "data:image/png;base64,..." */
     dataUrl: string;
+    /**
+     * Microsoft 2016 SVG extension (`<a:blip><a:extLst><a:ext
+     * uri="{96DAC541-7B7A-43D3-8B79-37D633B846F1}"><asvg:svgBlip r:embed>`). When
+     * PowerPoint embeds an SVG image, `dataUrl` above is only the PNG fallback it
+     * rasterizes for compatibility; this is the original vector image as a
+     * `data:image/svg+xml;base64,…` URL. The renderer prefers this and falls back
+     * to `dataUrl` if the SVG fails to decode. Omitted when the picture has no
+     * svgBlip extension (the common case).
+     */
+    svgDataUrl?: string;
     /**
      * Border line from `<p:pic><p:spPr><a:ln>` (ECMA-376 §20.1.2.2.24). A
      * `p:pic`'s spPr is `CT_ShapeProperties` (§19.3.1.37), so a picture carries
@@ -2192,7 +2294,7 @@ export declare namespace pptx {
         SpaceLine,
         TabStop,
         TextBody,
-        Paragraph,
+        Paragraph_2 as Paragraph,
         TextRun,
         TextRunData,
         LineBreak,
@@ -3259,6 +3361,12 @@ declare interface TextBody extends TextBody_2 {
      * omitted from JSON when false. Only meaningful when `numCol > 1`.
      */
     rtlCol?: boolean;
+    /**
+     * Narrow the inherited `paragraphs` to the PPTX `Paragraph` so consumers see
+     * the PPTX-only `eaLnBrk` flag. PPTX `Paragraph extends CoreParagraph`, so
+     * this is a covariant refinement of `CoreTextBody.paragraphs`.
+     */
+    paragraphs: Paragraph_2[];
 }
 
 declare interface TextBody_2 {
@@ -3361,6 +3469,13 @@ declare interface TextRunData {
      * present; absent means CJK falls back to fontFamily.
      */
     fontFamilyEa?: string;
+    /**
+     * Symbol font family from rPr > a:sym (ECMA-376 §21.1.2.3.10), resolved
+     * through the theme. PowerPoint stores symbol-font glyphs as Private-Use
+     * codepoints U+F020–U+F0FF; the renderer uses this font to resolve them.
+     * Absent means no symbol font was declared.
+     */
+    fontFamilySym?: string;
     /** Baseline shift in thousandths of a point. Positive = superscript, negative = subscript. */
     baseline?: number;
     /**

package/dist/types/pptx.d.ts

@@ -181,6 +181,38 @@ export declare interface ChartElement {
     scatterStyle?: string | null;
     /** `<c:radarChart><c:radarStyle val>` (ECMA-376 §21.2.3.10). */
     radarStyle?: string | null;
+    /** `<c:catAx><c:title>` plain text (ECMA-376 §21.2.2.6). For scatter the
+     * bottom `<c:valAx>` (axPos b/t) feeds this. null = no title. */
+    catAxisTitle?: string | null;
+    /** `<c:valAx><c:title>` plain text. For scatter the left `<c:valAx>`
+     * (axPos l/r) feeds this. null = no title. */
+    valAxisTitle?: string | null;
+    /** `<c:catAx><c:title>` run-prop font size (hpt). Distinct from
+     * `catAxisFontSizeHpt` (tick labels). null = renderer default. */
+    catAxisTitleSize?: number | null;
+    /** `<c:catAx><c:title>` run-prop bold flag. null = not bold. */
+    catAxisTitleBold?: boolean | null;
+    /** `<c:catAx><c:title>` run-prop color (hex without '#'). null = default. */
+    catAxisTitleColor?: string | null;
+    /** `<c:valAx><c:title>` run-prop font size (hpt). null = renderer default. */
+    valAxisTitleSize?: number | null;
+    /** `<c:valAx><c:title>` run-prop bold flag. null = not bold. */
+    valAxisTitleBold?: boolean | null;
+    /** `<c:valAx><c:title>` run-prop color (hex without '#'). null = default. */
+    valAxisTitleColor?: string | null;
+    /** `<c:title>...defRPr@b` chart title bold flag. null = not bold. */
+    titleFontBold?: boolean | null;
+    /** `<c:catAx><c:txPr>...defRPr@b` X-axis tick-label bold flag. null = not bold. */
+    catAxisFontBold?: boolean | null;
+    /** `<c:valAx><c:txPr>...defRPr@b` Y-axis tick-label bold flag. null = not bold. */
+    valAxisFontBold?: boolean | null;
+    /** Explicit chart border color (hex without '#') from
+     * `<c:chartSpace><c:spPr><a:ln><a:solidFill><a:srgbClr>`. Only set when the
+     * XML explicitly declares a paintable line; null otherwise (no default border). */
+    chartBorderColor?: string | null;
+    /** `<c:chartSpace><c:spPr><a:ln@w>` border width in EMU. null = 1px hairline
+     * when a color is present. */
+    chartBorderWidthEmu?: number | null;
 }
 
 declare interface ChartErrBars {
@@ -315,6 +347,27 @@ export declare interface ChartModel {
     catAxisFontBold?: boolean | null;
     /** `<c:valAx><c:txPr>...defRPr@b>` Y-axis tick label bold flag. */
     valAxisFontBold?: boolean | null;
+    /** `<c:catAx><c:title>` run-prop font size (hpt). Distinct from
+     *  `catAxisFontSizeHpt` (tick labels). null = renderer default. */
+    catAxisTitleFontSizeHpt?: number | null;
+    /** `<c:catAx><c:title>` run-prop bold flag. null = not bold. */
+    catAxisTitleFontBold?: boolean | null;
+    /** `<c:catAx><c:title>` run-prop color (hex without '#'). null = default. */
+    catAxisTitleFontColor?: string | null;
+    /** `<c:valAx><c:title>` run-prop font size (hpt). null = renderer default. */
+    valAxisTitleFontSizeHpt?: number | null;
+    /** `<c:valAx><c:title>` run-prop bold flag. null = not bold. */
+    valAxisTitleFontBold?: boolean | null;
+    /** `<c:valAx><c:title>` run-prop color (hex without '#'). null = default. */
+    valAxisTitleFontColor?: string | null;
+    /** Explicit chart border color (hex without '#') from
+     *  `<c:chartSpace><c:spPr><a:ln><a:solidFill><a:srgbClr>`. Only set when the
+     *  XML explicitly declares a paintable line; null otherwise (no default
+     *  border is drawn). */
+    chartBorderColor?: string | null;
+    /** `<c:chartSpace><c:spPr><a:ln@w>` border width in EMU. null = 1px hairline
+     *  when a color is present. */
+    chartBorderWidthEmu?: number | null;
     /**
      * `<c:catAx><c:crosses val>` (`autoZero` | `min` | `max`). Drives the Y
      * coordinate where the X axis is drawn. Default `autoZero` puts the X
@@ -810,7 +863,24 @@ export declare interface NoFill {
     fillType: 'none';
 }
 
-export declare interface Paragraph {
+/**
+ * PPTX paragraph. Extends the shared core `Paragraph` with the PPTX-only
+ * `eaLnBrk` flag that the pptx parser emits but the shared core model does not
+ * carry (docx/xlsx paragraphs don't surface it). Mirrors the Rust
+ * `Paragraph` struct's `ea_ln_brk` field 1:1.
+ */
+export declare interface Paragraph extends Paragraph_2 {
+    /**
+     * `<a:pPr eaLnBrk>` (ECMA-376 §21.1.2.2.7, xsd:boolean, default true). When
+     * true, East Asian text may break at character boundaries (kinsoku rules);
+     * when false, an East Asian word must not be split mid-character. The parser
+     * resolves the paragraph → body/list-style → layout/master cascade and always
+     * emits an effective boolean.
+     */
+    eaLnBrk: boolean;
+}
+
+declare interface Paragraph_2 {
     /** Alignment: "l" | "ctr" | "r" | "just" */
     alignment: string;
     /** Left margin in EMU */
@@ -892,6 +962,16 @@ export declare interface PictureElement {
     flipV: boolean;
     /** Data URL, e.g. "data:image/png;base64,..." */
     dataUrl: string;
+    /**
+     * Microsoft 2016 SVG extension (`<a:blip><a:extLst><a:ext
+     * uri="{96DAC541-7B7A-43D3-8B79-37D633B846F1}"><asvg:svgBlip r:embed>`). When
+     * PowerPoint embeds an SVG image, `dataUrl` above is only the PNG fallback it
+     * rasterizes for compatibility; this is the original vector image as a
+     * `data:image/svg+xml;base64,…` URL. The renderer prefers this and falls back
+     * to `dataUrl` if the SVG fails to decode. Omitted when the picture has no
+     * svgBlip extension (the common case).
+     */
+    svgDataUrl?: string;
     /**
      * Border line from `<p:pic><p:spPr><a:ln>` (ECMA-376 §20.1.2.2.24). A
      * `p:pic`'s spPr is `CT_ShapeProperties` (§19.3.1.37), so a picture carries
@@ -1514,12 +1594,18 @@ export declare interface TextBody extends TextBody_2 {
      * omitted from JSON when false. Only meaningful when `numCol > 1`.
      */
     rtlCol?: boolean;
+    /**
+     * Narrow the inherited `paragraphs` to the PPTX `Paragraph` so consumers see
+     * the PPTX-only `eaLnBrk` flag. PPTX `Paragraph extends CoreParagraph`, so
+     * this is a covariant refinement of `CoreTextBody.paragraphs`.
+     */
+    paragraphs: Paragraph[];
 }
 
 declare interface TextBody_2 {
     /** Vertical anchor: "t" | "ctr" | "b" */
     verticalAnchor: string;
-    paragraphs: Paragraph[];
+    paragraphs: Paragraph_2[];
     /** Default pt size from lstStyle (overrides renderer default when present) */
     defaultFontSize: number | null;
     /** Inherited bold from layout/master defRPr (null = not set, use false as final default) */
@@ -1616,6 +1702,13 @@ export declare interface TextRunData {
      * present; absent means CJK falls back to fontFamily.
      */
     fontFamilyEa?: string;
+    /**
+     * Symbol font family from rPr > a:sym (ECMA-376 §21.1.2.3.10), resolved
+     * through the theme. PowerPoint stores symbol-font glyphs as Private-Use
+     * codepoints U+F020–U+F0FF; the renderer uses this font to resolve them.
+     * Absent means no symbol font was declared.
+     */
+    fontFamilySym?: string;
     /** Baseline shift in thousandths of a point. Positive = superscript, negative = subscript. */
     baseline?: number;
     /**

package/dist/types/xlsx.d.ts

@@ -230,6 +230,19 @@ export declare interface ChartData {
     catAxisTitle?: string | null;
     /** Value axis title (c:valAx/c:title). */
     valAxisTitle?: string | null;
+    /** `<c:catAx><c:title>` run-prop font size (hpt), from the parser's
+     *  catAxisTitleSize. Distinct from `catAxisFontSizeHpt` (tick labels). */
+    catAxisTitleSize?: number | null;
+    /** `<c:catAx><c:title>` run-prop bold flag. */
+    catAxisTitleBold?: boolean | null;
+    /** `<c:catAx><c:title>` run-prop color (hex without '#'). */
+    catAxisTitleColor?: string | null;
+    /** `<c:valAx><c:title>` run-prop font size (hpt). */
+    valAxisTitleSize?: number | null;
+    /** `<c:valAx><c:title>` run-prop bold flag. */
+    valAxisTitleBold?: boolean | null;
+    /** `<c:valAx><c:title>` run-prop color (hex without '#'). */
+    valAxisTitleColor?: string | null;
     /** True when <c:legend> is present. Absence means the legend is hidden. */
     showLegend?: boolean;
     /** `<c:legendPos val>` — "r"|"l"|"t"|"b"|"tr". null/undefined = default ("r"). */
@@ -302,6 +315,12 @@ export declare interface ChartData {
     catAxisLineWidthEmu?: number;
     valAxisLineColor?: string;
     valAxisLineWidthEmu?: number;
+    /** Explicit chart border color (hex without '#') from
+     *  `<c:chartSpace><c:spPr><a:ln><a:solidFill><a:srgbClr>`. Only set when the
+     *  XML explicitly declares a paintable line (no default border). */
+    chartBorderColor?: string | null;
+    /** `<c:chartSpace><c:spPr><a:ln@w>` border width in EMU. */
+    chartBorderWidthEmu?: number | null;
     /** `<c:catAx | valAx><c:majorTickMark val>` / `<c:minorTickMark val>` —
      *  one of `none`/`out`/`in`/`cross` (ECMA-376 §21.2.2.49). */
     catAxisMajorTickMark?: string;