build(deps-dev): bump execa from 9.5.2 to 9.6.0

Bumps [execa](https://github.com/sindresorhus/execa) from 9.5.2 to 9.6.0.
- [Release notes](https://github.com/sindresorhus/execa/releases)
- [Commits](https://github.com/sindresorhus/execa/compare/v9.5.2...v9.6.0)

---
updated-dependencies:
- dependency-name: execa
  dependency-version: 9.6.0
  dependency-type: direct:development
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>

demo/31-tables.ts

@@ -1,7 +1,7 @@
 // Example of how you would create a table and add data to it
 
 import * as fs from "fs";
-import { Document, HeadingLevel, Packer, Paragraph, Table, TableCell, TableRow, VerticalAlign, TextDirection } from "docx";
+import { Document, HeadingLevel, Packer, Paragraph, Table, TableCell, TableRow, VerticalAlignTable, TextDirection } from "docx";
 
 const doc = new Document({
     sections: [
@@ -13,11 +13,11 @@ const doc = new Document({
                             children: [
                                 new TableCell({
                                     children: [new Paragraph({}), new Paragraph({})],
-                                    verticalAlign: VerticalAlign.CENTER,
+                                    verticalAlign: VerticalAlignTable.CENTER,
                                 }),
                                 new TableCell({
                                     children: [new Paragraph({}), new Paragraph({})],
-                                    verticalAlign: VerticalAlign.CENTER,
+                                    verticalAlign: VerticalAlignTable.CENTER,
                                 }),
                                 new TableCell({
                                     children: [new Paragraph({ text: "bottom to top" }), new Paragraph({})],
@@ -45,7 +45,7 @@ const doc = new Document({
                                             text: "This text should be in the middle of the cell",
                                         }),
                                     ],
-                                    verticalAlign: VerticalAlign.CENTER,
+                                    verticalAlign: VerticalAlignTable.CENTER,
                                 }),
                                 new TableCell({
                                     children: [
@@ -53,7 +53,7 @@ const doc = new Document({
                                             text: "Text above should be vertical from bottom to top",
                                         }),
                                     ],
-                                    verticalAlign: VerticalAlign.CENTER,
+                                    verticalAlign: VerticalAlignTable.CENTER,
                                 }),
                                 new TableCell({
                                     children: [
@@ -61,7 +61,7 @@ const doc = new Document({
                                             text: "Text above should be vertical from top to bottom",
                                         }),
                                     ],
-                                    verticalAlign: VerticalAlign.CENTER,
+                                    verticalAlign: VerticalAlignTable.CENTER,
                                 }),
                             ],
                         }),

demo/48-vertical-align.ts

@@ -1,13 +1,13 @@
 // Example of making content of section vertically aligned
 
 import * as fs from "fs";
-import { Document, Packer, Paragraph, VerticalAlign, TextRun, Tab } from "docx";
+import { Document, Packer, Paragraph, VerticalAlignSection, TextRun, Tab } from "docx";
 
 const doc = new Document({
     sections: [
         {
             properties: {
-                verticalAlign: VerticalAlign.CENTER,
+                verticalAlign: VerticalAlignSection.CENTER,
             },
             children: [
                 new Paragraph({

demo/49-table-borders.ts

@@ -12,7 +12,7 @@ import {
     TableCell,
     TableRow,
     TextDirection,
-    VerticalAlign,
+    VerticalAlignTable,
 } from "docx";
 
 const table = new Table({
@@ -102,11 +102,11 @@ const noBorderTable = new Table({
             children: [
                 new TableCell({
                     children: [new Paragraph({}), new Paragraph({})],
-                    verticalAlign: VerticalAlign.CENTER,
+                    verticalAlign: VerticalAlignTable.CENTER,
                 }),
                 new TableCell({
                     children: [new Paragraph({}), new Paragraph({})],
-                    verticalAlign: VerticalAlign.CENTER,
+                    verticalAlign: VerticalAlignTable.CENTER,
                 }),
                 new TableCell({
                     children: [new Paragraph({ text: "bottom to top" }), new Paragraph({})],
@@ -134,7 +134,7 @@ const noBorderTable = new Table({
                             text: "This text should be in the middle of the cell",
                         }),
                     ],
-                    verticalAlign: VerticalAlign.CENTER,
+                    verticalAlign: VerticalAlignTable.CENTER,
                 }),
                 new TableCell({
                     children: [
@@ -142,7 +142,7 @@ const noBorderTable = new Table({
                             text: "Text above should be vertical from bottom to top",
                         }),
                     ],
-                    verticalAlign: VerticalAlign.CENTER,
+                    verticalAlign: VerticalAlignTable.CENTER,
                 }),
                 new TableCell({
                     children: [
@@ -150,7 +150,7 @@ const noBorderTable = new Table({
                             text: "Text above should be vertical from top to bottom",
                         }),
                     ],
-                    verticalAlign: VerticalAlign.CENTER,
+                    verticalAlign: VerticalAlignTable.CENTER,
                 }),
             ],
         }),

demo/50-readme-demo.ts

@@ -1,7 +1,7 @@
 // The demo on the README.md
 
 import * as fs from "fs";
-import { Document, HeadingLevel, ImageRun, Packer, Paragraph, Table, TableCell, TableRow, VerticalAlign } from "docx";
+import { Document, HeadingLevel, ImageRun, Packer, Paragraph, Table, TableCell, TableRow, VerticalAlignTable } from "docx";
 
 const table = new Table({
     rows: [
@@ -13,6 +13,7 @@ const table = new Table({
                             children: [
                                 new ImageRun({
                                     data: fs.readFileSync("./demo/images/image1.jpeg"),
+                                    type: "jpg",
                                     transformation: {
                                         width: 100,
                                         height: 100,
@@ -21,7 +22,7 @@ const table = new Table({
                             ],
                         }),
                     ],
-                    verticalAlign: VerticalAlign.CENTER,
+                    verticalAlign: VerticalAlignTable.CENTER,
                 }),
                 new TableCell({
                     children: [
@@ -30,7 +31,7 @@ const table = new Table({
                             heading: HeadingLevel.HEADING_1,
                         }),
                     ],
-                    verticalAlign: VerticalAlign.CENTER,
+                    verticalAlign: VerticalAlignTable.CENTER,
                 }),
             ],
         }),
@@ -50,6 +51,7 @@ const table = new Table({
                             children: [
                                 new ImageRun({
                                     data: fs.readFileSync("./demo/images/image1.jpeg"),
+                                    type: "jpg",
                                     transformation: {
                                         width: 100,
                                         height: 100,
@@ -77,6 +79,7 @@ const doc = new Document({
                     children: [
                         new ImageRun({
                             data: fs.readFileSync("./demo/images/pizza.gif"),
+                            type: "gif",
                             transformation: {
                                 width: 100,
                                 height: 100,

demo/79-table-from-data-source.ts

@@ -9,7 +9,7 @@ import {
     Table,
     TableCell,
     TableRow,
-    VerticalAlign,
+    VerticalAlignTable,
     TextDirection,
     TextRun,
     WidthType,
@@ -101,17 +101,17 @@ const generateRows = (prices: StockPrice[]): TableRow[] =>
                 children: [
                     new TableCell({
                         children: [new Paragraph(date.toString())],
-                        verticalAlign: VerticalAlign.CENTER,
+                        verticalAlign: VerticalAlignTable.CENTER,
                         textDirection: TextDirection.LEFT_TO_RIGHT_TOP_TO_BOTTOM,
                     }),
                     new TableCell({
                         children: [new Paragraph(ticker)],
-                        verticalAlign: VerticalAlign.CENTER,
+                        verticalAlign: VerticalAlignTable.CENTER,
                         textDirection: TextDirection.LEFT_TO_RIGHT_TOP_TO_BOTTOM,
                     }),
                     new TableCell({
                         children: [new Paragraph(price.toString())],
-                        verticalAlign: VerticalAlign.CENTER,
+                        verticalAlign: VerticalAlignTable.CENTER,
                         textDirection: TextDirection.TOP_TO_BOTTOM_RIGHT_TO_LEFT,
                     }),
                 ],
@@ -143,7 +143,7 @@ const doc = new Document({
                                             ],
                                         }),
                                     ],
-                                    verticalAlign: VerticalAlign.CENTER,
+                                    verticalAlign: VerticalAlignTable.CENTER,
                                     textDirection: TextDirection.LEFT_TO_RIGHT_TOP_TO_BOTTOM,
                                 }),
                                 new TableCell({
@@ -159,7 +159,7 @@ const doc = new Document({
                                             ],
                                         }),
                                     ],
-                                    verticalAlign: VerticalAlign.CENTER,
+                                    verticalAlign: VerticalAlignTable.CENTER,
                                     textDirection: TextDirection.LEFT_TO_RIGHT_TOP_TO_BOTTOM,
                                 }),
                                 new TableCell({
@@ -175,7 +175,7 @@ const doc = new Document({
                                             ],
                                         }),
                                     ],
-                                    verticalAlign: VerticalAlign.CENTER,
+                                    verticalAlign: VerticalAlignTable.CENTER,
                                     textDirection: TextDirection.TOP_TO_BOTTOM_RIGHT_TO_LEFT,
                                 }),
                             ],

demo/85-template-document.ts

@@ -13,7 +13,7 @@ import {
     TableRow,
     TextDirection,
     TextRun,
-    VerticalAlign,
+    VerticalAlignTable,
 } from "docx";
 
 patchDocument({
@@ -105,11 +105,11 @@ patchDocument({
                             children: [
                                 new TableCell({
                                     children: [new Paragraph({}), new Paragraph({})],
-                                    verticalAlign: VerticalAlign.CENTER,
+                                    verticalAlign: VerticalAlignTable.CENTER,
                                 }),
                                 new TableCell({
                                     children: [new Paragraph({}), new Paragraph({})],
-                                    verticalAlign: VerticalAlign.CENTER,
+                                    verticalAlign: VerticalAlignTable.CENTER,
                                 }),
                                 new TableCell({
                                     children: [new Paragraph({ text: "bottom to top" }), new Paragraph({})],
@@ -137,7 +137,7 @@ patchDocument({
                                             text: "This text should be in the middle of the cell",
                                         }),
                                     ],
-                                    verticalAlign: VerticalAlign.CENTER,
+                                    verticalAlign: VerticalAlignTable.CENTER,
                                 }),
                                 new TableCell({
                                     children: [
@@ -145,7 +145,7 @@ patchDocument({
                                             text: "Text above should be vertical from bottom to top",
                                         }),
                                     ],
-                                    verticalAlign: VerticalAlign.CENTER,
+                                    verticalAlign: VerticalAlignTable.CENTER,
                                 }),
                                 new TableCell({
                                     children: [
@@ -153,7 +153,7 @@ patchDocument({
                                             text: "Text above should be vertical from top to bottom",
                                         }),
                                     ],
-                                    verticalAlign: VerticalAlign.CENTER,
+                                    verticalAlign: VerticalAlignTable.CENTER,
                                 }),
                             ],
                         }),

demo/96-template-document.ts

@@ -13,7 +13,7 @@ import {
     TableRow,
     TextDirection,
     TextRun,
-    VerticalAlign,
+    VerticalAlignTable,
 } from "docx";
 
 patchDocument({
@@ -105,11 +105,11 @@ patchDocument({
                             children: [
                                 new TableCell({
                                     children: [new Paragraph({}), new Paragraph({})],
-                                    verticalAlign: VerticalAlign.CENTER,
+                                    verticalAlign: VerticalAlignTable.CENTER,
                                 }),
                                 new TableCell({
                                     children: [new Paragraph({}), new Paragraph({})],
-                                    verticalAlign: VerticalAlign.CENTER,
+                                    verticalAlign: VerticalAlignTable.CENTER,
                                 }),
                                 new TableCell({
                                     children: [new Paragraph({ text: "bottom to top" }), new Paragraph({})],
@@ -137,7 +137,7 @@ patchDocument({
                                             text: "This text should be in the middle of the cell",
                                         }),
                                     ],
-                                    verticalAlign: VerticalAlign.CENTER,
+                                    verticalAlign: VerticalAlignTable.CENTER,
                                 }),
                                 new TableCell({
                                     children: [
@@ -145,7 +145,7 @@ patchDocument({
                                             text: "Text above should be vertical from bottom to top",
                                         }),
                                     ],
-                                    verticalAlign: VerticalAlign.CENTER,
+                                    verticalAlign: VerticalAlignTable.CENTER,
                                 }),
                                 new TableCell({
                                     children: [
@@ -153,7 +153,7 @@ patchDocument({
                                             text: "Text above should be vertical from top to bottom",
                                         }),
                                     ],
-                                    verticalAlign: VerticalAlign.CENTER,
+                                    verticalAlign: VerticalAlignTable.CENTER,
                                 }),
                             ],
                         }),

docs/usage/tables.md

@@ -159,7 +159,7 @@ const tableRow = new TableRow({
 | children      | `Array<Paragraph or Table>`         | Required. You can nest tables by adding a table into a cell |
 | shading       | `IShadingAttributesProperties`      | Optional                                                    |
 | margins       | `ITableCellMarginOptions`           | Optional                                                    |
-| verticalAlign | `VerticalAlign`                     | Optional                                                    |
+| verticalAlign | `VerticalAlignTable`                | Optional                                                    |
 | columnSpan    | `number`                            | Optional                                                    |
 | rowSpan       | `number`                            | Optional                                                    |
 | borders       | `BorderOptions`                     | Optional                                                    |
@@ -266,7 +266,7 @@ Sets the vertical alignment of the contents of the cell
 ```ts
 const cell = new TableCell({
     ...,
-    verticalAlign: VerticalAlign,
+    verticalAlign: VerticalAlignTable,
 });
 ```
 
@@ -282,7 +282,7 @@ For example, to center align a cell:
 
 ```ts
 const cell = new TableCell({
-    verticalAlign: VerticalAlign.CENTER,
+    verticalAlign: VerticalAlignTable.CENTER,
 });
 ```
 

package.json

@@ -1,6 +1,6 @@
 {
     "name": "docx",
-    "version": "9.4.1",
+    "version": "9.5.0",
     "description": "Easily generate .docx files with JS/TS with a nice declarative API. Works for Node and on the Browser.",
     "type": "module",
     "main": "dist/index.umd.cjs",
@@ -81,7 +81,7 @@
         "@typescript-eslint/parser": "^8.8.1",
         "@vitest/coverage-v8": "^3.0.8",
         "@vitest/ui": "^3.0.8",
-        "cspell": "^8.2.3",
+        "cspell": "^9.0.0",
         "docsify-cli": "^4.3.0",
         "eslint": "^9.13.0",
         "eslint-import-resolver-typescript": "^4.3.2",
@@ -90,7 +90,7 @@
         "eslint-plugin-jsdoc": "^50.3.1",
         "eslint-plugin-no-null": "^1.0.2",
         "eslint-plugin-prefer-arrow": "^1.2.3",
-        "eslint-plugin-unicorn": "^58.0.0",
+        "eslint-plugin-unicorn": "^59.0.0",
         "execa": "^9.4.0",
         "glob": "^11.0.0",
         "inquirer": "^12.0.0",

src/file/document/body/section-properties/section-properties.spec.ts

@@ -6,7 +6,7 @@ import { FooterWrapper } from "@file/footer-wrapper";
 import { HeaderWrapper } from "@file/header-wrapper";
 import { Media } from "@file/media";
 import { NumberFormat } from "@file/shared/number-format";
-import { VerticalAlign } from "@file/vertical-align";
+import { VerticalAlignSection } from "@file/vertical-align";
 import { convertInchesToTwip } from "@util/convenience-functions";
 
 import { PageOrientation } from "./properties";
@@ -75,7 +75,7 @@ describe("SectionProperties", () => {
                     even: new FooterWrapper(media, 200),
                 },
                 titlePage: true,
-                verticalAlign: VerticalAlign.TOP,
+                verticalAlign: VerticalAlignSection.TOP,
             });
 
             const tree = new Formatter().format(properties);

src/file/document/body/section-properties/section-properties.ts

@@ -2,7 +2,7 @@
 
 import { FooterWrapper } from "@file/footer-wrapper";
 import { HeaderWrapper } from "@file/header-wrapper";
-import { VerticalAlign, VerticalAlignElement } from "@file/vertical-align";
+import { SectionVerticalAlign, VerticalAlignElement } from "@file/vertical-align";
 import { OnOffElement, XmlComponent } from "@file/xml-components";
 
 import { Columns, IColumnsAttributes } from "./properties/columns";
@@ -35,7 +35,7 @@ export type ISectionPropertiesOptions = {
     readonly footerWrapperGroup?: IHeaderFooterGroup<FooterWrapper>;
     readonly lineNumbers?: ILineNumberAttributes;
     readonly titlePage?: boolean;
-    readonly verticalAlign?: (typeof VerticalAlign)[keyof typeof VerticalAlign];
+    readonly verticalAlign?: SectionVerticalAlign;
     readonly column?: IColumnsAttributes;
     readonly type?: (typeof SectionType)[keyof typeof SectionType];
 };

src/file/drawing/doc-properties/doc-properties.ts

@@ -19,8 +19,8 @@ import { createHyperlinkClick } from "./doc-properties-children";
 
 export type DocPropertiesOptions = {
     readonly name: string;
-    readonly description: string;
+    readonly description?: string;
-    readonly title: string;
+    readonly title?: string;
 };
 
 export class DocProperties extends XmlComponent {
@@ -29,26 +29,32 @@ export class DocProperties extends XmlComponent {
     public constructor({ name, description, title }: DocPropertiesOptions = { name: "", description: "", title: "" }) {
         super("wp:docPr");
 
-        this.root.push(
+        const attributes: Record<string, { readonly key: string; readonly value: string | number }> = {
-            new NextAttributeComponent({
+            id: {
-                id: {
+                key: "id",
-                    key: "id",
+                value: this.docPropertiesUniqueNumericId(),
-                    value: this.docPropertiesUniqueNumericId(),
+            },
-                },
+            name: {
-                name: {
+                key: "name",
-                    key: "name",
+                value: name,
-                    value: name,
+            },
-                },
+        };
-                description: {
+
-                    key: "descr",
+        if (description !== null && description !== undefined) {
-                    value: description,
+            attributes.description = {
-                },
+                key: "descr",
-                title: {
+                value: description,
-                    key: "title",
+            };
-                    value: title,
+        }
-                },
+
-            }),
+        if (title !== null && title !== undefined) {
-        );
+            attributes.title = {
+                key: "title",
+                value: title,
+            };
+        }
+
+        this.root.push(new NextAttributeComponent(attributes));
     }
 
     public prepForXml(context: IContext): IXmlableObject | undefined {
@@ -59,7 +65,6 @@ export class DocProperties extends XmlComponent {
             }
 
             this.root.push(createHyperlinkClick(element.linkId, true));
-
             break;
         }
 

src/file/table/table-cell/table-cell-properties.spec.ts

@@ -2,7 +2,7 @@ import { describe, expect, it } from "vitest";
 
 import { Formatter } from "@export/formatter";
 import { BorderStyle } from "@file/border";
-import { VerticalAlign } from "@file/vertical-align";
+import { VerticalAlignTable } from "@file/vertical-align";
 
 import { WidthType } from "../table-width";
 import { VerticalMergeType } from "./table-cell-components";
@@ -32,7 +32,7 @@ describe("TableCellProperties", () => {
         });
 
         it("sets vertical align", () => {
-            const properties = new TableCellProperties({ verticalAlign: VerticalAlign.BOTTOM });
+            const properties = new TableCellProperties({ verticalAlign: VerticalAlignTable.BOTTOM });
             const tree = new Formatter().format(properties);
             expect(tree).to.deep.equal({ "w:tcPr": [{ "w:vAlign": { _attr: { "w:val": "bottom" } } }] });
         });

src/file/table/table-cell/table-cell-properties.ts

@@ -1,4 +1,4 @@
-import { VerticalAlign, VerticalAlignElement } from "@file/vertical-align";
+import { TableVerticalAlign, VerticalAlignElement } from "@file/vertical-align";
 import { IgnoreIfEmptyXmlComponent } from "@file/xml-components";
 
 import { IShadingAttributesProperties, Shading } from "../../shading";
@@ -17,7 +17,7 @@ import {
 export type ITableCellPropertiesOptions = {
     readonly shading?: IShadingAttributesProperties;
     readonly margins?: ITableCellMarginOptions;
-    readonly verticalAlign?: (typeof VerticalAlign)[keyof typeof VerticalAlign];
+    readonly verticalAlign?: TableVerticalAlign;
     readonly textDirection?: (typeof TextDirection)[keyof typeof TextDirection];
     readonly verticalMerge?: (typeof VerticalMergeType)[keyof typeof VerticalMergeType];
     readonly width?: ITableWidthProperties;

src/file/table/table-cell/table-cell.spec.ts

@@ -3,7 +3,7 @@ import { describe, expect, it } from "vitest";
 import { Formatter } from "@export/formatter";
 import { BorderStyle } from "@file/border";
 import { ShadingType } from "@file/shading";
-import { VerticalAlign } from "@file/vertical-align";
+import { VerticalAlignTable } from "@file/vertical-align";
 
 import { WidthType } from "../table-width";
 import { TableCell } from "./table-cell";
@@ -286,7 +286,7 @@ describe("TableCell", () => {
         it("should create with vertical align", () => {
             const cell = new TableCell({
                 children: [],
-                verticalAlign: VerticalAlign.CENTER,
+                verticalAlign: VerticalAlignTable.CENTER,
             });
 
             const tree = new Formatter().format(cell);

src/file/vertical-align/vertical-align.ts

@@ -6,17 +6,43 @@ import { XmlAttributeComponent, XmlComponent } from "@file/xml-components";
 
 // <xsd:simpleType name="ST_VerticalJc">
 // <xsd:restriction base="xsd:string">
+//   <xsd:enumeration value="both"/>
 //   <xsd:enumeration value="top"/>
 //   <xsd:enumeration value="center"/>
 //   <xsd:enumeration value="bottom"/>
 // </xsd:restriction>
 // </xsd:simpleType>
-export const VerticalAlign = {
+
-    BOTTOM: "bottom",
+/**
-    CENTER: "center",
+ * Enumeration for table-cell vertical alignment. Only `top`, `center`, `bottom`
+ * are valid according to ECMA-376 (§17.18.87 ST_VerticalJc within <w:tcPr>).
+ */
+export const VerticalAlignTable = {
     TOP: "top",
+    CENTER: "center",
+    BOTTOM: "bottom",
 } as const;
 
+/**
+ * Enumeration for section (<w:sectPr>) vertical alignment. Adds `both` on top of
+ * the table-cell set (§17.18.87 ST_VerticalJc within <w:sectPr>).
+ */
+export const VerticalAlignSection = {
+    ...VerticalAlignTable,
+    BOTH: "both",
+} as const;
+
+/**
+ * @deprecated Use {@link VerticalAlignTable} for table cells or
+ * {@link VerticalAlignSection} for section properties. This alias remains for
+ * backward-compatibility and will be removed in the next major release.
+ */
+export const VerticalAlign = VerticalAlignSection;
+
+export type TableVerticalAlign = (typeof VerticalAlignTable)[keyof typeof VerticalAlignTable];
+
+export type SectionVerticalAlign = (typeof VerticalAlignSection)[keyof typeof VerticalAlignSection];
+
 export class VerticalAlignAttributes extends XmlAttributeComponent<{
     readonly verticalAlign?: (typeof VerticalAlign)[keyof typeof VerticalAlign];
 }> {