Fix: separate vertical alignment enums for ITableCellOptions and ISectionPropertiesOptions (#3079)

* fix: separate vertical alignment enums for table and section properties

- Introduced `VerticalAlignTable` for table-cell vertical alignment with valid values: `top`, `center`, and `bottom`.
- Added `VerticalAlignSection` for section properties, extending `VerticalAlignTable` with an additional value `both`.
- Marked the original `VerticalAlign` as deprecated for backward compatibility, directing users to the new enums.
- Updated type definitions for better clarity on valid vertical alignments.

* refactor: update vertical alignment imports and types for section and table properties

- Renamed `VerticalAlign` to `VerticalAlignSection` in section properties and `VerticalAlignTable` in table-cell properties for clarity.
- Updated type definitions to reflect the new enum names, ensuring better organization and understanding of vertical alignment options.
- Adjusted related test cases to utilize the new imports and types.

* refactor: update demos to use new enums for table and section properties for vertical alignment

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];
 }> {