@silurus/ooxml 0.66.2 → 0.67.0

package/dist/types/docx.d.ts

@@ -46,11 +46,20 @@ export declare type BodyElement = {
 *  "continuous" (same page), "nextPage" (default; page break), "oddPage" /
 *  "evenPage" (page break + parity padding). The paginator switches its active
 *  newspaper-column geometry per section at each marker — fixing the regression
-*  where every section inherited the body-level section's columns. */
+*  where every section inherited the body-level section's columns.
+*
+*  `headers`/`footers` carry the ENDING section's resolved (§17.10.1-inherited)
+*  header/footer set, and `titlePage` its own `<w:titlePg>` flag, so the renderer
+*  can pick the active section's header/footer per page (mirroring how `columns`
+*  drives per-section column geometry). The body-level (final) section's sets
+*  live on {@link DocxDocumentModel.section}/`.headers`/`.footers` instead. */
 | {
     type: 'sectionBreak';
     kind: 'continuous' | 'nextPage' | 'oddPage' | 'evenPage' | string;
     columns?: ColumnsSpec | null;
+    headers?: HeadersFooters;
+    footers?: HeadersFooters;
+    titlePage?: boolean;
 };
 
 export declare interface BorderSpec {
@@ -1242,6 +1251,12 @@ export declare interface ShapeText {
      *  paragraphs. */
     runs?: ShapeTextRun[];
     alignment: string;
+    /** ECMA-376 §17.3.1.33 `<w:spacing w:before>` of this text-box paragraph, in
+     *  pt — reserved ABOVE the paragraph inside the box. Absent/0 ⇒ no offset. */
+    spaceBefore?: number;
+    /** ECMA-376 §17.3.1.33 `<w:spacing w:after>` of this text-box paragraph, in
+     *  pt — reserved BELOW the paragraph. Absent/0 ⇒ no offset. */
+    spaceAfter?: number;
     /** Zip path of an inline image inside this text-box paragraph
      *  (`<w:drawing><wp:inline><a:blip r:embed>`), e.g. `word/media/image1.emf`.
      *  Absent for a text-only paragraph. */

package/dist/types/index.d.ts

@@ -91,11 +91,20 @@ declare type BodyElement = {
 *  "continuous" (same page), "nextPage" (default; page break), "oddPage" /
 *  "evenPage" (page break + parity padding). The paginator switches its active
 *  newspaper-column geometry per section at each marker — fixing the regression
-*  where every section inherited the body-level section's columns. */
+*  where every section inherited the body-level section's columns.
+*
+*  `headers`/`footers` carry the ENDING section's resolved (§17.10.1-inherited)
+*  header/footer set, and `titlePage` its own `<w:titlePg>` flag, so the renderer
+*  can pick the active section's header/footer per page (mirroring how `columns`
+*  drives per-section column geometry). The body-level (final) section's sets
+*  live on {@link DocxDocumentModel.section}/`.headers`/`.footers` instead. */
 | {
     type: 'sectionBreak';
     kind: 'continuous' | 'nextPage' | 'oddPage' | 'evenPage' | string;
     columns?: ColumnsSpec | null;
+    headers?: HeadersFooters;
+    footers?: HeadersFooters;
+    titlePage?: boolean;
 };
 
 declare interface Border {
@@ -1779,6 +1788,18 @@ declare interface ImageAnchor {
      *  svgBlip extension. Its MIME is always `image/svg+xml` and is owned by the
      *  SVG decoder. */
     svgImagePath?: string;
+    /** ECMA-376 §20.1.8.55 `<a:srcRect>` source-image crop. Each edge inset is a
+     *  fraction `0..1` of the source bitmap, measured inward, so the visible
+     *  source region is `[l, t, 1-r, 1-b]`. Absent (the common case) ⇒ the whole
+     *  blip fills the anchor rect; when present, the renderer draws only the
+     *  cropped sub-rectangle (raster only — a metafile is rasterized to the
+     *  display box, so its crop can't be honored faithfully and is skipped). */
+    srcRect?: {
+        l: number;
+        t: number;
+        r: number;
+        b: number;
+    };
 }
 
 /**
@@ -2539,14 +2560,16 @@ declare interface PictureElement {
      */
     prstAdjust?: number[];
     /**
-     * ECMA-376 a:srcRect — source image crop as fractions (0..1) of the source
-     * width/height. Omitted when the image is not cropped.
+     * ECMA-376 §20.1.8.55 a:srcRect — source image crop as fractions (0..1) of the
+     * source width/height, measured inward from each edge. Omitted when the image
+     * is not cropped; when present the parser emits all four edges (absent edges
+     * default to 0), so the renderer reads them without a fallback.
      */
     srcRect?: {
-        l?: number;
-        t?: number;
-        r?: number;
-        b?: number;
+        l: number;
+        t: number;
+        r: number;
+        b: number;
     };
     /** a:blip > a:alphaModFix@amt as 0..1. Undefined = fully opaque. */
     alpha?: number;
@@ -3332,6 +3355,16 @@ declare type ShapeGeom = {
      *  when the picture carries no svgBlip extension. Its MIME is always
      *  `image/svg+xml` and is owned by the SVG decoder. */
     svgImagePath?: string;
+    /** ECMA-376 §20.1.8.55 `<a:srcRect>` source-image crop on the leaf pic
+     *  (fractions `0..1` inward from each edge; visible region `[l, t, 1-r,
+     *  1-b]`). Absent ⇒ the whole blip fills the leaf rect. Honored identically
+     *  to the top-level {@link ImageAnchor.srcRect} (raster only). */
+    srcRect?: {
+        l: number;
+        t: number;
+        r: number;
+        b: number;
+    };
 };
 
 declare interface ShapeInfo {
@@ -3472,6 +3505,12 @@ declare interface ShapeText_2 {
      *  paragraphs. */
     runs?: ShapeTextRun_2[];
     alignment: string;
+    /** ECMA-376 §17.3.1.33 `<w:spacing w:before>` of this text-box paragraph, in
+     *  pt — reserved ABOVE the paragraph inside the box. Absent/0 ⇒ no offset. */
+    spaceBefore?: number;
+    /** ECMA-376 §17.3.1.33 `<w:spacing w:after>` of this text-box paragraph, in
+     *  pt — reserved BELOW the paragraph. Absent/0 ⇒ no offset. */
+    spaceAfter?: number;
     /** Zip path of an inline image inside this text-box paragraph
      *  (`<w:drawing><wp:inline><a:blip r:embed>`), e.g. `word/media/image1.emf`.
      *  Absent for a text-only paragraph. */

package/dist/types/pptx.d.ts

@@ -1077,14 +1077,16 @@ export declare interface PictureElement {
      */
     prstAdjust?: number[];
     /**
-     * ECMA-376 a:srcRect — source image crop as fractions (0..1) of the source
-     * width/height. Omitted when the image is not cropped.
+     * ECMA-376 §20.1.8.55 a:srcRect — source image crop as fractions (0..1) of the
+     * source width/height, measured inward from each edge. Omitted when the image
+     * is not cropped; when present the parser emits all four edges (absent edges
+     * default to 0), so the renderer reads them without a fallback.
      */
     srcRect?: {
-        l?: number;
-        t?: number;
-        r?: number;
-        b?: number;
+        l: number;
+        t: number;
+        r: number;
+        b: number;
     };
     /** a:blip > a:alphaModFix@amt as 0..1. Undefined = fully opaque. */
     alpha?: number;

package/dist/types/xlsx.d.ts

@@ -476,6 +476,18 @@ export declare interface ImageAnchor {
      *  svgBlip extension. Its MIME is always `image/svg+xml` and is owned by the
      *  SVG decoder. */
     svgImagePath?: string;
+    /** ECMA-376 §20.1.8.55 `<a:srcRect>` source-image crop. Each edge inset is a
+     *  fraction `0..1` of the source bitmap, measured inward, so the visible
+     *  source region is `[l, t, 1-r, 1-b]`. Absent (the common case) ⇒ the whole
+     *  blip fills the anchor rect; when present, the renderer draws only the
+     *  cropped sub-rectangle (raster only — a metafile is rasterized to the
+     *  display box, so its crop can't be honored faithfully and is skipped). */
+    srcRect?: {
+        l: number;
+        t: number;
+        r: number;
+        b: number;
+    };
 }
 
 export declare interface LegendManualLayout {
@@ -892,6 +904,16 @@ export declare type ShapeGeom = {
      *  when the picture carries no svgBlip extension. Its MIME is always
      *  `image/svg+xml` and is owned by the SVG decoder. */
     svgImagePath?: string;
+    /** ECMA-376 §20.1.8.55 `<a:srcRect>` source-image crop on the leaf pic
+     *  (fractions `0..1` inward from each edge; visible region `[l, t, 1-r,
+     *  1-b]`). Absent ⇒ the whole blip fills the leaf rect. Honored identically
+     *  to the top-level {@link ImageAnchor.srcRect} (raster only). */
+    srcRect?: {
+        l: number;
+        t: number;
+        r: number;
+        b: number;
+    };
 };
 
 export declare interface ShapeInfo {